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Daniel Roth, Rick Anderson ve Shaun Luttin tarafından hazırlanmıştır 

ASP.NET Core, modern, bulut tabanlı, internet bağlantılı uygulamalar oluşturmaya yönelik platformlar arası, 
yüksek performanslı, açık kaynak bir çerçevedir. ASP.NET Core ile şunları yapabilirsiniz: 

• Web uygulamaları ve hizmetleri, loT uygulamaları ve mobil arka uçlar oluşturun. 

• VVİndovvs, macOS ve Linux üzerinde tercih ettiğiniz geliştirme araçlarını kullanın. 

• Buluta veya şirket içine dağıtın. 

• .NET Core veya .NET Framevvork üzerinde çalıştırın. 

Neden ASP.NET Core kullanılmalı? 

Milyonlarca geliştirici, web uygulamaları oluşturmak için ASP.NET 4.x kullandı (ve kullanmaya devam ediyor). 

AS P.N ET Core, AS P.N ET 4.x sürümünün daha yalın, daha modüler bir çerçeve elde edilmesini sağlayan mimari 
değişikliklerle yeniden tasarlanmış halidir. 

AS P.N ET Core aşağıdaki avantajları sağlar: 

• Web Ul ve Web API 1 Leri oluşturmak için birleştirilmiş bir hikaye. 

• , Test edilebilirlik için tasarlanmıştır. 

• Razor Pages , kodlama sayfasına odaklanmış senaryolara daha kolay ve daha üretken olmasını sağlar. 

• Blazor , tarayıcıda JavaScript C# 'in yanı sıra kullanmanıza olanak sağlar.Sunucu tarafı ve istemci tarafı 
uygulama mantığını tüm ,N ET ile yazılmış şekilde paylaşabilirsiniz. 

• VVİndovvs, macOS ve Linux 'ta geliştirme ve çalıştırma özelliği. 

• Açık kaynak ve topluluk odaklı. 

• Modern, istemci tarafı çerçeveleri ve geliştirme iş akışlarının tümleştirilmesi. 

• GRPCkullanarak uzak yordam ÇAĞRıSı (RPC) hizmetlerini barındırmak için destek. 

• Buluta hazırlanma, ortam tabanlı bir yapılandırma sistemi. 

• Yerleşik bağımlılık ekleme. 

• Basit, yüksek performanslıve modüler bir http istek işlem hattı. 

• Aşağıdakiler üzerinde barındırma özelliği: 
o Kestrel 

o ISS 

o HTTP, sys 
o NGINX 
o Apache 
o Docker 

• Yan yana sürüm oluşturma. 

• Modern VVeb geliştirmeyi kolaylaştıran araç. 

ASP.NET Core MVC kullanarak web API'leri ve web kullanıcı arabirimi 
oluşturma 

ASP.NET Core MVC, web API'leri ve web uygulamaları oluşturmaya yönelik özellikler sağlar: 




• Model-Görünüm-Denetleyici (MVC) deseni, web API'lerinin ve web uygulamalarının sınanabilir olmasını 
sağlamanıza yardımcı olur. 

• Razor Pages, web kullanıcı arabirimi oluşturmayı daha kolay ve üretken bir hale getiren, sayfa tabanlı bir 
programlama modelidir. 

• Razor işaretlemesi, Razor Sayfaları ve MVC görünümleri için üretken bir söz dizimi sağlar. 

• Etiket Yardımcıları, Razor dosyalarında HTML öğelerinin oluşturulmasına ve işlenmesine sunucu tarafı kodun 
katılmasını etkinleştir. 

• Birden çok veri biçimi ve içerik anlaşması için sunulan yerleşik destek, web API'lerinizin tarayıcılar ve mobil 
cihazlar dahil olmak üzere birçok çeşit istemciye ulaşmasına imkan tanır. 

• Model bağlama, HTTP isteklerinden alınan verileri otomatik olarak eylem metodu parametreleriyle eşleştirir. 

• Model doğrulama, otomatik olarak istemci ve sunucu tarafı doğrulama gerçekleştirir. 

İstemci tarafı geliştirme 

AS P.N ET Core, aralarında Razor Components, Angular, React ve Bootstrap'in bulunduğu popüler istemci tarafı 
çerçeve ve kitaplıklarla sorunsuz bir şekilde tümleştirilir. Daha fazla bilgi için Razor Components ve İstemci tarafı 
geliştirme altındaki ilgili konulara bakın. 

.NET Framevvork'ü hedefleyen ASP.NET Core 

ASP.NET Core 2.x, .NET Core'u veya .NET Framework'ü hedefleyebilir..NET Framework'ü hedefleyen ASP.NET 
Core uygulamaları platformlar arası çalışmaz; bunlar yalnızca Windows üzerinde çalışır. Genel olarak, ASP.NET 
Core 2.x .N ET Standard kitaplıklarından oluşturulmuştur. ,N ET Standard 2.0 ile yazılmış uygulamalar .N ET 
Standard 2.0'ın desteklendiği her yerde çalıştırılır. 

ASP.NET Core 2.x, .NET Standard 2.0 ile uyumlu .NET Framework sürümlerinde desteklenir: 

• .NET Framevvork 4.7.1 ve üzeri önemle tavsiye edilir. 

• .NET Framevvork4.6.1 ve üzeri. 

ASP.NET Core 3.0 ve üzeri yalnızca .NET Core'da çalışır.Bu değişiklik hakkında daha fazla bilgi için bkz. 

ASP.NET Core 3.0'daki değişikliklere ilk bakış. 

.N ET Core hedeflemesinin çeşitli avantajları vardır ve bu avantajlar her yeni sürümle birlikte artmaktadır. .N ET 
Framevvork'e göre .NET Core'un bazı avantajları şunlardır: 

• Platformlar arası. macOS, Linux ve Windows üzerinde çalışır. 

• Geliştirilmiş performans 

• Yan yana sürüm oluşturma 

• Yeni API'ler 

• Açık kaynak 

.NET Framevvork ile .NET Core arasındaki API açığını kapatmak için çok çalışıyoruz. VVİndovvs Uyumluluk Paketi, 
.NET Core'da yalnızca VVİndovvs'a yönelik binlerce API'yi kullanıma sunmaktadır. Bu API'ler .NET Core 1.x'te 
sağlanmamıştı. 

Önerilen öğrenme yolu 

AS P.N ET Core uygulamaları geliştirmeye başlamak için şu öğreticileri ve makaleleri takip etmenizi öneririz: 

1. Geliştirmek veya yönetmek istediğiniz uygulama türüne yönelik bir öğreticiyi takip edin: 



SENARYO 


UYGULAMA TURU 


EĞİTMEN 


Web uygulaması 

Yeni proje geliştirmek için 

Razor Sayfalan kullanmaya başlama 

Web uygulaması 

MVC uygulaması yönetmek için 

MVC ile çalışmaya başlama 

Web API 


Web API'si oluşturma* 

Gerçek zamanlı uygulama 


SignalR ile çalışmaya başlama 

Temel veri erişiminin nasıl yapıldığını 

gösteren bir öğreticiyi takip edin: 


SENARYO 

EĞİTMEN 


Yeni proje geliştirmek için 

Entity Framevvork Core ile Razor Pages 

MVC uygulaması yönetmek için 

Entity Framevvork Core ile MVC 


3. Tüm uygulama türleri için geçerli olan ASP.NET Core özelliklerine yönelik genel bakışı okuyun: 

• Temeller 

4. ilgilendiğiniz diğer konular için içindekiler Tablosu'na göz atın. 

Tarayıcıda tamamını takip ettiğiniz ve yerel IDE yüklemesi gerektirmeyen * yeni bir web API'si öğreticisi var. Kod 
Azure Cloud Shell'de çalışır, curl ise test için kullanılır. 

Örnek indirme 

Çoğu makale ve öğretici örnek koda bağlantılar içerir. 

1. AS P.N ET depo zip dosyasını indirin. 

2. Docs-master.zip dosyasının sıkıştırmasını açın. 

3. Örnek dizinde gezinmek için örnek bağlantıdaki URL'yi kullanın. 

Örnek kodda ön işlemci yönergeleri 

Örnek uygulamalar birden çok senaryoyu göstermek amacıyla aynı koda ait farklı bölümleri seçmeli olarak 
derleyip çalıştırmak için #define ve #if-#eise/#eiif-#endif C# deyimlerini kullanır. Bu yaklaşımdan yararlanan 
örneklerde C# dosyalarının üst kısmındaki #define deyimini, çalıştırmak istediğiniz senaryoyla ilişkili olan 
simgeye ayarlayın. Bazı örnekler senaryoyu çalıştırmak için birden çok dosyanın üst kısmındaki simgenin 
ayarlanmasını gerektirebilir. 

Örneğin, aşağıdaki simge listesi #define dört senaryonun kullanılabilir olduğunu gösterir (her simge için bir 
senaryo). Geçerli örnek yapılandırması TemplateCode senaryosunu çalıştırır: 

#define TemplateCode // or LogFromMain or ExpandDefault or FilterlnCode 

Örneği ExpandDefauit senaryosunu çalıştıracak şekilde değiştirmek için ExpandDefauit simgesini tanımlayın ve 
kalan simgeleri açıklama satırı yapılmış şekilde bırakın: 

#define ExpandDefault // TemplateCode or LogFromMain or FilterlnCode 

Kod bölümlerini seçmeli olarak derlemek üzere C# ön işlemci yönergelerini kullanma hakkında daha fazla bilgi 
için bkz. #define (C# Başvurusu) ve #if (C# Başvurusu). 










Örnek kodda bölgeler 

Bazı örnek uygulamalar, #region ve #endregion C# deyimleri içine yerleştirilmiş kod bölümleri içerir. Belge 
derleme sistemi bu bölgeleri işlenmiş belge konularının içine ekler. 

Bölge adları çoğunlukla şu sözcüğü içerir: "snippet." Aşağıdaki örnekte snippet_FiiterinCode adlı bir bölge 
gösterilir: 

#region snippet_FilterInCode 
WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.ConfigureLogging(logging => 

logging.AddFilter("System", LogLevel.Debug) 

.AddFilter<DebugLoggerProvider>("Microsoft ", LogLevel.Trace)) 

.Build(); 

#endregion 


Önündeki C# kod parçacığına, konunun markdown dosyasında aşağıdaki satırla başvurulur: 



açıklanan örnek senaryoları çalıştırmayı planlıyorsanız, bu deyimlerin anasındaki kodu değiştirmeyin. Başka 
senaryolarla denemeler yaparken kodu rahatça değiştirebilirsiniz. 

Daha fazla bilgi için bkz. AS P.N ET belgelerine katkıda bulunma: Kod parçacıkları. 

Sonraki adımlar 

Daha fazla bilgi için aşağıdaki kaynaklara bakın: 

• ASP.NET Core kullanmaya başlayın 

• Visual Studio ile Azure'a bir AS P.N ET Core uygulaması yayımlama 

• ASP.NET Core temelleri 

• Haftalık ASP.NET topluluğu toplantısında, takımın ilerleme durumu ve planları ele alınır. Yeni bloglara ve 
üçüncü taraf yazılıma yer verilir. 







ASPNET 4. x ve ASRNET Core arasında seçim yapın 
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AS P.N ET Core, AS P.N ET 4. x ' in bir tasarlayadır. Bu makalede aralarındaki farklar listelenir. 

ASP.NET Core 

AS P.N ET Core, Windows, macOS veya Linux 'ta modern, bulut tabanlı Web uygulamaları oluşturmaya yönelik açık 
kaynaklı, platformlar arası bir çerçevedir. 

ASP.NET Core aşağıdaki avantajları sağlar: 

• Web Ul ve Web API 'Leri oluşturmak için birleştirilmiş bir hikaye. 

• , Test edilebilirlik için tasarlanmıştır. 

• Razor Pages , kodlama sayfasına odaklanmış senaryolara daha kolay ve daha üretken olmasını sağlar. 

• Blazor , tarayıcıda JavaScript C# 'in yanı sıra kullanmanıza olanak sağlar.Sunucu tarafı ve istemci tarafı 
uygulama mantığını tüm .NET ile yazılmış şekilde paylaşabilirsiniz. 

• Windows, macOS ve Linux 'ta geliştirme ve çalıştırma özelliği. 

• Açık kaynak ve topluluk odaklı. 

• Modern, istemci tarafı çerçeveleri ve geliştirme iş akışlarının tümleştirilmesi. 

• GRPCkullanarak uzak yordam ÇAĞRıSı (RPC) hizmetlerini barındırmak için destek. 

• Buluta hazırlanma, ortam tabanlı bir yapılandırma sistemi. 

• Yerleşik bağımlılık ekleme. 

• Basit, yüksek performanslıve modüler bir http istek işlem hattı. 

• Aşağıdakiler üzerinde barındırma özelliği: 
o Kestrel 

o ISS 

o HTTP.sys 
o NGINX 
o Apache 
o Docker 

• Yan yana sürüm oluşturma. 

• Modern Web geliştirmeyi kolaylaştıran araç. 


ASP.NET 4.x 

AS P.N ET 4. x, VVİndovvs 'ta kurumsal düzeyde, sunucu tabanlı Web uygulamaları oluşturmak için gereken 
hizmetleri sağlayan, yetişkinlere yönelik bir çerçevedir. 

Çerçeve seçimi 

Aşağıdaki tabloda AS P.N ET Core AS P.N ET 4. x ile karşılaştırılır. 

ASP.NET CORE ASP.NET 4. X 

VVİndovvs, macOS veya Linux için derleme VVİndovvs için derleme 




ASP.NET CORE 


ASP.NET 4.X 


Razor Pages , bir Web kullanıcı arabirimini ASP.NET Core 2. x 
olarak oluşturmak için önerilen yaklaşımdır. Ayrıca bkz. MVC, 
Web APlve SignalR. 

Web Forms, SignalR MVC, Web API, Web kancalarıveya Web 
sayfalan kullanın 

Makine başına birden çok sürüm 

Makine başına bir sürüm 

C# Veya kullanarak Visual Studio, Mac için Visual Studioveya 
Visual Studio Code geliştirinF# 

, Vb veya kullanarak C# Visual Studio ile geliştirmeF# 

ASP.NET 4. x 'ten daha yüksek performans 

iyi performans 

.NET Core çalışma zamanı kullan 

.NET Framevvork çalışma zamanını kullan 


.N ET Framevvork üzerinde ASP.NET Core 2. x desteği hakkında bilgi için bkz. ASP.NET Core .NET Framevvork 
Hedefleme . 

ASP.NET Core senaryolar 

• Siteleriniz 

• GetVersionEx 

• Gerçek zamanlı 

• Azure 'a ASP.NET Core uygulaması dağıtma 

ASP.NET 4. x senaryoları 

• Siteleriniz 

• GetVersionEx 

• Gerçek zamanlı 

• Azure 'da bir AS P.N ET 4. x Web uygulaması oluşturma 

Ek kaynaklar 

• ASP.NET 'e giriş 

• ASP.NET Core giriş 

• ASP.NET Core uygulamalarını Azure App Service dağıtma 


Öğretici: ASRNET Core kullanmaya başlayın 
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Bu öğreticide, bir AS P.N ET Core Web uygulaması oluşturmak ve çalıştırmak için .N ET Core komut satırı arabirimi 
’nin nasıl kullanılacağı gösterilmektedir. 

Şunları yapmayı öğreneceksiniz: 

• Bir Web uygulaması projesi oluşturun. 

• Geliştirme sertifikasına güvenin. 

• Uygulamayı çalıştırın. 

• Razor sayfasını düzenleyin. 

Sonunda, yerel makinenizde çalışan bir çalışan Web uygulamanız olacaktır. 



Önkoşullar 

.NET Core 3,0 SDK veya üzeri 

Web uygulaması projesi oluşturma 

Bir komut kabuğu açın ve şu komutu girin: 

dotnet new webapp -o aspnetcoreapp 

Önceki komut: 

• Yeni bir Web uygulaması oluşturur. 

• -o aspnetcoreapp parametresi, uygulama için kaynak dosyalarla aspnetcoreapp adlı bir dizin oluşturur. 

Geliştirme sertifikasına güven 

HTTPS geliştirme sertifikasına güvenin: 


• Windows 

• macOS 









• Linux 


dotnet dev-certs https --trust 


Yukarıdaki komutta aşağıdaki iletişim kutusu görüntülenir: 


Security Warning 



You are about to install a certificate from a certification 
authority (CA) daiming to represent 


localhost 


Windows cannotvalidate thatthe certificate is actuallyfrom 
"localhost". You should confirm its origin by contacting 
"localhost". The follovving number will assist you in this 
process: 

Thumbprint (shal): 35AAFB1F 70EC5F89 C7180FBD 61AFE491 
94580874 


VYarning: 

If you install this root certificate, Windows will automatically 
trust any certificate issued by this CA. Installing a certificate 
with an unconfirmed thumbprint is a security risk. If you dick 
"Yes" you acknowledge this risk. 

Do you want to install this certificate? 



Geliştirme sertifikasına güvenmeyi kabul ediyorsanız Evet ' i seçin. 

Daha fazla bilgi için bkz . asp.N ET Core https geliştirme sertifikasına güven 

Uygulamayı çalıştırma 

Aşağıdaki komutları çalıştırın: 

cd aspnetcoreapp 
dotnet watch nun 


Komut kabuğu, uygulamanın başlatıldığını gösteriyorsa, https://localhost:5001 gidin. 

Razor sayfasını düzenleme 

Pages/lndex. cshtml dosyasını açın ve sayfayı aşağıdaki vurgulanmış işaretlerle değiştirin ve kaydedin: 

@page 

@model IndexModel 

@{ 

ViewData["Title"] = "Home page"; 

} 

<div class="text-center"> 

<hl class="display-4">Welcome</hl> 

<p>Helİ 0 j world! The time on the server is @DateTime.Now</p> 

</div> 


https://localhost:5001 gidin, sayfayı yenileyin ve değişikliklerin görüntülendiğini doğrulayın. 


Sonraki adımlar 













Bu öğreticide, şunların nasıl yapıldığını öğrendiniz: 

• Bir Web uygulaması projesi oluşturun. 

• Geliştirme sertifikasına güvenin. 

• Projeyi çalıştırın. 

• Değişiklik yapın. 

ASP.NET Core hakkında daha fazla bilgi edinmek için bkz. giriş bölümünde önerilen öğrenme yolu: 

ASP.NET Core'a Giriş 


ASPNET Core 3,1 1 deki yenilikler 
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Bu makalede, AS P.N ET Core 3,1 ' deki en önemli değişiklikler ilgili belgelerin bağlantılarıyla vurgulanır. 

Razor bileşenleri için kısmi sınıf desteği 

Razor bileşenleri artık kısmi sınıflar olarak oluşturulmuştur. Bir Razor bileşeni kodu, tek bir dosyada bileşen için 
tüm kodu tanımlamak yerine kısmi bir sınıf olarak tanımlanmış bir arka plan kod dosyası kullanılarak yazılabilir. 
Daha fazla bilgi için bkz. kısmi sınıf desteği. 

Bileşen etiketi yardımcısını Blazor ve parametreleri en üst düzey 
bileşenlere geçir 

ASP.NET Core 3,0 ile Blazor, bileşenler HTML Yardımcısı ( Htmi.RenderComponentAsync ) kullanılarak sayfalar ve 
görünümler halinde işlenmiştir. AS P.N ET Core 3,1 ' de, yeni bileşen etiketi Yardımcısı ile bir sayfadan veya 
görünümden bir bileşeni işleme: 

<component type="typeof(Counter)" render-mode="ServerPrerendered" /> 

HTML Yardımcısı ASP.NET Core 3,1 1 de desteklenmeye devam eder, ancak bileşen etiketi Yardımcısı önerilir. 

Blazor Server uygulamaları artık ilk işleme sırasında parametreleri en üst düzey bileşenlere geçirebilir. Daha önce, 
parametreleri yalnızca RenderMode. staticolan en üst düzey bileşene geçirebilirsiniz. Bu sürümle birlikte, hem 
RenderMode. Server hem de Rendermodel. Serverprerenimli desteklenir. Belirtilen parametre değerleri JSON 
olarak serileştirilir ve başlangıç yanıtına dahil edilir. 

Örneğin, PreRender bir artış miktarı olan counter bileşen ( incrementAmount ): 

ccomponent type="typeof(Counter)" render-mode="ServerPrerendered" 
param-IncrementAmount="10" /> 

Daha fazla bilgi için bkz. bileşenleri Razor Pages ve MVC uygulamalarıyla tümleştirme. 

HTTP, sys dosyasındaki paylaşılan sıralar için destek 

Http. sys , anonim istek kuyrukları oluşturmayı destekler. ASP.NET Core 3,1 ' de, var olan bir HTTP, sys istek 
kuyruğunu oluşturma veya ekleme yeteneğine ekledik. Var olan adlandırılmış bir HTTP, sys istek kuyruğunu 
oluşturma veya iliştirme, sıranın sahibi olan HTTP, sys denetleyici işleminin dinleyici işleminden bağımsız olduğu 
senaryolara olanak sağlar. Bu bağımsızlık, var olan bağlantıları ve dinleyici işlemi yeniden başlatmalar arasında 
sıraya alınmış istekleri korumayı mümkün kılar: 











public static IHostBuilden CreateHostBuilder(string[] angs) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

// ... 

webBuilden.UseHttpSys(options => 

{ 

options.RequestQueueName = "MyExistingQueue"; 

options.RequestQueueMode = RequestQueueMode.CneateOrAttach; 

}); 


SameSite tanımlama bilgilerine yönelik son değişiklikler 

SameSite tanımlama bilgilerinin davranışı yaklaşan tarayıcı değişikliklerini yansıtacak şekilde değiştirilmiştir. Bu, 
AzureAd, Openıdconnect veya VVsFederation gibi kimlik doğrulama senaryolarını etkileyebilir. Daha fazla bilgi için 
bkz.ASP.NET Core 1 de SameSite tanımlama bilgileriyle çalışma. 

Blazor uygulamalardaki olaylara yönelik varsayılan eylemleri engelleyin 

Bir olayın varsayılan eylemini engellemek için @on{EVENT}:preventDefauit Directive özniteliğini kullanın. Aşağıdaki 
örnekte, metin kutusunda anahtarın karakterini görüntülemenin varsayılan eylemi engellenir: 

<input value="@_count" @onkeypress="KeyHandler" (Şonkeypress:preventDefault /> 

Daha fazla bilgi için bkz. varsayılan eylemleri engelleme. 

Blazor uygulamalarında olay yaymayı durdur 

Olay yaymayı durdurmak için @on{EVENT}:stopPropagation Directive özniteliğini kullanın. Aşağıdaki örnekte, onay 
kutusunun seçilmesi alt <div> üst <div> yayılmadan alt öğe için tıklama olaylarını önler: 

cinput @bind="_stopPropagation" type="checkbox" /> 

<div @onclick="OnSelectParentDiv"> 

<div @onclick="OnSelectChildDiv" @onclick:stopPropagation="_stopPropagation"> 

</div> 

</div> 

@code { 

private bool _stopPropagation = false; 

} 

Daha fazla bilgi için bkz. olay yaymayı durdurma. 

Blazor uygulama geliştirme sırasında ayrıntılı hatalar 

Geliştirme sırasında Blazor bir uygulama düzgün bir şekilde çalışmadığı zaman, uygulamanın ayrıntılı hata 
bilgilerinin alınması sorunu gidermeye ve sorunun giderilmesine yardımcı olur. Bir hata oluştuğunda, Blazor 
uygulamalar ekranın alt kısmında altın bir çubuk görüntüler: 

• Geliştirme sırasında altın çubuk, özel durumu görebileceğiniz tarayıcı konsoluna yönlendirir. 

• Üretimde, altın çubuk kullanıcıya bir hata oluştuğunu bildirir ve tarayıcıyı yenilemeyi önerir. 


Daha fazla bilgi için bkz. geliştirme sırasında ayrıntılı hatalar. 










ASPNET Core 3,0 1 deki yenilikler 
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Bu makalede, AS P.N ET Core 3,0 ' deki en önemli değişiklikler ilgili belgelerin bağlantılarıyla vurgulanır. 

Blazor 

Blazor, .NET ile etkileşimli istemci tarafı Web Kullanıcı arabirimi oluşturmak için ASP.NET Core yeni bir çerçevedir: 

• JavaScript yerine zengin etkileşimli Uıusing C# oluşturma. 

• .NET 1 te yazılmış sunucu tarafı ve istemci tarafı uygulama mantığını paylaşabilirsiniz. 

• Mobil tarayıcılar dahil olmak üzere geniş tarayıcı desteği için Kullanıcı arabirimini HTML ve CSS olarak işleme. 
Blazor Framevvork desteklenen senaryolar: 

• Yeniden kullanılabilir kullanıcı arabirimi bileşenleri (Razor bileşenleri) 

• İstemci tarafı yönlendirme 

• Bileşen düzenleri 

• Bağımlılık ekleme desteği 

• Formlar ve doğrulama 

• Razor sınıf kitaplıkları ile bileşen kitaplıkları derleme 

• JavaScript ile birlikte çalışma 

Daha fazla bilgi için bkz. ASP.NET Core Blazor giriş. 

Blazor Sunucusu 

Blazor, Kullanıcı arabirimi güncelleştirmelerinin uygulanma, bileşen işleme mantığını ayırır.Blazor Server, bir 
ASP.NET Core uygulamasındaki sunucuda Razor bileşenlerini barındırmak için destek sağlar. Kullanıcı Arabirimi 
güncelleştirmeleri SignalR bir bağlantı üzerinden işlenir. Blazor Server ASP.NET Core 3,0 1 de desteklenir. 

Blazor VVebAssembly (Önizleme) 

Blazor uygulamalar, bir VVebAssembly tabanlı .N ET çalışma zamanı kullanarak doğrudan tarayıcıda da çalıştırılabilir. 
Blazor VVebAssembly Önizleme aşamasmdadir ve ASP.NET Core 3,0 ' de desteklenmez. Blazor VVebAssembly 
ASP.NET Core gelecek bir sürümünde desteklenecektir. 

Razor bileşenleri 

Blazor uygulamalar bileşenlerinden oluşturulmuştur. Bileşenler, bir sayfa, iletişim kutusu veya form gibi kullanıcı 
arabirimi (Ul) için kendi içinde yer alan öbeklerdir. Bileşenler, Kullanıcı arabirimi işleme mantığını ve istemci tarafı 
olay işleyicilerini tanımlayan normal .NET sınıflarıdır. JavaScript olmadan zengin etkileşimli Web uygulamaları 
oluşturabilirsiniz. 

Blazor bileşenleri genellikle HTML ve C#doğal bir Blend Razor söz dizimi kullanılarakyazılır.Razor bileşenleri, her 
ikisi de Razor kullanan Razor Pages ve MVC görünümlerine benzerdir. Bir istek-yanıt modelini temel alan 
sayfaların ve görünümlerin aksine, bileşenler Kullanıcı arabirimi oluşturmayı işlemek için kullanılır. 

gRPC 

GRPC: 

• Popüler, yüksek performanslı bir RPC (uzak yordam çağrısı) çerçevesidir. 






• , API geliştirmeye yönelik olarak yapılan bir sözleşmenin ilk yaklaşımını sağlar. 

• , Gibi modern teknolojiler kullanır: 
o Taşıma için HTTP/2. 

o Arabirim açıklaması dili olarak protokol arabellekleri. 
o İkili serileştirme biçimi. 

• Şöyle özellikler sağlar: 

o Kimlik Doğrulama 
o Çift yönlü akış ve akış denetimi, 
o İptal ve zaman aşımları. 

ASP.NET Core 3,0 ' deki gRPC işlevselliği şunları içerir: 

• GRPC. AspNetCore, GRPC hizmetlerini barındırmak için bir ASP.NET Core çerçevesini -. gRPC on ASP.NET 
Core, günlüğe kaydetme, bağımlılık ekleme (dı), kimlik doğrulama ve yetkilendirme gibi standart AS P.N ET Core 
özelliklerle tümleştirilir. 

• GRPC .net. Client-.NET Core İçin bir GRPC istemcisini tanıdık Httpciient üzerinde oluşturur. 

• GRPC .net. ClientFactory- GRPC istemci tümleştirmesi HttpClientFactory . 

Daha fazla bilgi için bkz. ,N ET Core 'da gRPC 'ye giriş. 

SignalR 

Bkz. geçiş yönergeleri için SignalR kodu güncelleştirme . SignalR artık JSON iletilerini serileştirmek/seri 
durumdan çıkarmak için System.Text.ison kullanır. Newtonsoft.zison tabanlı serileştiriciyi geri yükleme yönergeleri 
için Nevvtonsoft. JSON anahtarına geçin . 

SignalRiçin JavaScript ve .NET İstemcilerinde, otomatik yeniden bağlanma için destek eklenmiştir. Varsayılan 
olarak, istemci hemen yeniden bağlanmaya çalışır ve gerekirse 2,10 ve 30 saniye sonra yeniden dener, istemci 
başarıyla yeniden bağlanırsa, yeni bir bağlantı KİMLİĞİ alır. Otomatik yeniden bağlanma kabul etme: 

const connection = new SignalR.HubConnectionBuilder() 

,withUrl("/chatHub") 

.withAutomaticReconnect() 

,build(); 

Yeniden bağlantı aralıkları bir dizi milisaniyelik tabanlı süre geçirerek belirtilebilir: 

.withAutomaticReconnect([0, 3000, 5000, 10000, 15000, 30000]) 

//.withAutomaticReconnect([0, 2000, 10000, 30000]) The default intervals. 

Yeniden bağlantı aralıklarının tam denetimi için özel bir uygulama geçirilebilir. 

Son yeniden bağlanma aralığından sonra yeniden bağlantı başarısız olursa: 

• istemci, bağlantının çevrimdışı olduğunu varsayar. 

• istemci yeniden bağlanmayı denemeyi durduruyor. 

Yeniden bağlanma denemeleri sırasında, kullanıcıya yeniden bağlantı denenmekte olduğunu bildirmek için 
uygulama kullanıcı arabirimini güncelleştirin. 

Bağlantı kesildiğinde Ul geri bildirimi sağlamak için SignalR istemci API 'SI aşağıdaki olay işleyicilerini içerecek 
şekilde genişletilir: 






• onreconnecting : geliştiricilere Kullanıcı arabirimini devre dışı bırakma veya kullanıcıların uygulamanın 

çevrimdışı olduğunu bilmesini sağlayan bir fırsat sağlar. 

• onreconnected : bağlantı kurulduktan sonra geliştiricilere Kullanıcı arabirimini güncelleştirme fırsatı verir. 

Aşağıdaki kod, bağlanmaya çalışırken kullanıcı arabirimini güncelleştirmek için onreconnecting kullanır: 

connection.onreconnecting((error) => { 

const status = 'Connection lost due to error "${error}". Reconnecting.'; 
document.getElementById("messageInput").disabled = true; 
document.getElementById("sendButton").disabled = true; 
document.getElementById("connectionStatus").innerText = status; 

}); 

Aşağıdaki kod, bağlantıda Kullanıcı arabirimini güncelleştirmek için onreconnected kullanır: 

connection.onreconnected((connectionId) => { 

const status = 'Connection reestablished. Connected.'; 
document.getElementById("messageInput").disabled = false; 
document.getElementById("sendButton").disabled = false; 
document.getElementById("connectionStatus").innerText = status; 

}); 


SignalR 3,0 ve üzeri, bir hub yöntemi yetkilendirme gerektirdiğinde, yetkilendirme işleyicilerine özel bir kaynak 
sağlar. Kaynak bir HubinvocationContext örneğidir. HubinvocationContext şunları içerir: 

• HubCallerContext 

• Çağrılan hub yönteminin adı. 

• Hub yöntemi için bağımsız değişkenler. 

Azure Active Directory aracılığıyla birden çok kuruluşun oturum açmasına izin veren bir sohbet odası 
uygulamasının aşağıdaki örneğini göz önünde bulundurun. Microsoft hesabı herkes sohbet için oturum açabilir, 
ancak yalnızca sahip olunan kuruluşun üyeleri kullanıcıları veya kullanıcıların sohbet geçmişlerini görüntüleyebilir. 
Uygulama belirli kullanıcılardan belirli işlevleri kısıtlayabilir. 











public class DomainRestrictedRequirement : 

Author'izationHandler<DomainRestr'ictedRequirement, HubInvocationContext>, 
IAuthorizationRequirement 

{ 

protected override Task HandleRequirementAsync(AuthorizationHandlerContext context, 
DomainRestrictedRequirement requirement, 

HubInvocationContext resource) 

{ 

if (context.User?.Identity?.Name == null) 

{ 

return Task.CompletedTask; 

} 

if (IsUserAllowedToDoThis(resource. HubMethodName, context.User. Identity.Name)) 

{ 

context.Succeed(requirement); 

} 

return Task.CompletedTask; 

} 

private bool IsUserAllowedToDoThis(string hubMethodName, string currentUsername) 

{ 

if (hubMethodName.Equals("banUser", StringComparison.OrdinalIgnoreCase)) 

{ 

return currentUsername. EqualsCbob42@jabbr.net", StringComparison.OrdinalIgnoreCase); 

} 

return currentUsername.EndsWith("@jabbr.net", StringComparison.OrdinalIgnoreCase)); 

} 

} 


Yukarıdaki kodda, DomainRestrictedRequirement Özel bir IAuthorizationRequirement işlevi görür. 
HubinvocationContext kaynak parametresi geçirildiğinden iç mantık şunları yapabilir: 

• Hub ’ın çağrıldığı bağlamı inceleyin. 

• Kullanıcının bireysel hub yöntemlerini yürütmesine izin verirken kararlar alın. 

Tek tek hub yöntemleri, çalışma zamanında kodun denetlediği ilkenin adıyla işaretlenebilir, istemciler tek tek hub 
yöntemlerini çağırmayı denediğinden DomainRestrictedRequirement işleyicisi çalışır ve yöntemlere erişimi denetler. 
DomainRestrictedRequirement erişimi denetim altına göre: 

• Tüm oturum açmış kullanıcılar sendMessage yöntemini çağırabilir. 

• Yalnızca bir @jabbr.net e-posta adresiyle oturum açan kullanıcılar, kullanıcıların geçmişlerini görüntüleyebilir. 

• Yalnızca bob42@jabbr.net sohbet odasından kullanıcıları ban edebilir. 










[Authorize] 

public class ChatHub : Hub 
{ 

public void SendMessage(string message) 

{ 

} 

[Authorize("DomainRestricted")] 
public void BanUser(string username) 

{ 

} 

[Authorize("DomainRestricted")] 

public void ViewUserHistory(string username) 

{ 

} 

} 

DomainRestricted ilkesi oluşturmak şunları içerebilir: 

• Startup.es' de, yeni ilkeyi ekleme. 

• Özel DomainRestrictedRequirement gereksinimini parametre olarak sağlayın. 

• Yetkilendirme ara yazılımı ile DomainRestricted kaydetme. 

Services 

.AddAuthorization(options => 

{ 

options.AddPolicyC'DomainRestricted", policy => 

{ 

policy.Requirements.Add(new DomainRestrictedRequirement()); 

}); 

}); 

SignalR hub 'ları uç nokta yönlendirmekullanır. SignalR Hub bağlantısı daha önce açık olarak yapıldı: 

app.UseSignalR(routes => 

{ 

routes.MapHub<ChatHub>("hubs/ehat"); 

}); 

Önceki sürümde, geliştiriciler, Razor sayfaları ve hub 'ları çeşitli yerlerde bağlamak için gereklidir.Açık bağlantı, 
neredeyse aynı bir dizi yönlendirme segmentine neden olur: 

app.UseSignalR(routes => 

{ 

routes.MapHub<ChatHub>("hubs/ehat"); 

}); 

app.UseRouting(routes => 

{ 

routes.MapRazorPages(); 

}); 


SignalR 3,0 hub 'ları, uç nokta yönlendirme aracılığıyla yönlendirilebilir. Uç nokta yönlendirme ile, genellikle tüm 
yönlendirme useRouting yapılandırılabilir: 








app.UseRouting(routes => 

{ 

routes.MapRazorPages(); 
routes.MapHub<ChatHub>("hubs/chat"); 

}); 

ASP.NET Core 3,0 SignalR eklendi: 

İstemciden sunucuya akış, istemci-sunucu akışı ile, sunucu tarafı yöntemleri bir iAsyncEnumerabie<T> veya 
channeiReader<T> örnekleri alabilir. Aşağıdaki C# örnekte, Hub daki uploadstream yöntemi istemcisinden dizelerin 
akışını alacaktır: 

public async Task UploadStream(IAsyncEnumerable<string> stream) 

{ 

await foreach (var item in stream) 

{ 

// process content 

} 

} 

.NET istemci uygulamaları, yukarıdaki uploadstream hub yönteminin stream bağımsız değişkeni olarak bir 
IAsyncEnumerable<T> veya ChannelReader<T> Örneğini geçirebilir. 

for döngüsü tamamlandıktan ve yerel işlev çıktıktan sonra, akış tamamlama gönderilir: 

async IAsyncEnumerable<string> clientStreamData() 

{ 

for (var i = 0; i < 5; i++) 

{ 

var data = await FetchSomeData(); 
yield return data; 

} 

} 

await connection.SendAsync("Uploadstream ", clientStreamData()); 

JavaScript istemci uygulamaları yukarıdaki uploadstream hub yönteminin stream bağımsız değişkeni için SignalR 
Subject (veya bir Rxjs konusu) kullanır. 

let subject = new SignalR.Subject(); 

await connection.send("StartStream", "MyAsciiArtStream", subject); 

JavaScript kodu, yakalandıkları ve sunucuya gönderilmeye hazırlanıyor gibi dizeleri işlemek için subject.next 
yöntemini kullanabilir. 

subject.next("example"); 
subject.complete(); 

Önceki iki kod parçacığı gibi kodu kullanarak gerçek zamanlı akış deneyimleri oluşturulabilir. 

Yeni JSON serileştirmesi 

ASP.NET Core 3,0 artık JSON serileştirme için varsayılan olarak System.Text.Json kullanır: 

• JSON 'yi zaman uyumsuz olarak okur ve yazar. 

• UTF-8 metni için iyileştirilmiştir. 















• Genellikle Newtonsoft.:Json kıyasla daha yüksek performans. 

ASP.NET Core 3,0 1 ye Json.N ET eklemek için bkz. Newtonsoft. JSON tabanlı JSON biçimi desteği ekleme. 


Yeni Razor yönergeleri 

Aşağıdaki listede yeni Razor yönergeleri yer almaktadır: 


@attribute 

- 

@attribute 

yönergesinin verilen özniteliği oluşturulan sayfanın veya görünümün sınıfına uygular. 

Örneğin: @attribute [Authorize] . 

@implements 

- 

@impiements yönergesi oluşturulan sınıf için bir arabirim uygular. Örneğin: 

@implements 

IDisposable . 



Identityserver4, Web API 1 Leri ve maça 'Ları için kimlik doğrulama ve 
yetkilendirmeyi destekler 

ASP.NET Core 3,0, Web API yetkilendirmesi desteğini kullanarak tek sayfalı uygulamalarda (Spaon) kimlik 
doğrulaması sunmaktadır. Kullanıcıların kimliğini doğrulamak ve depolamak için ASP.NET Core kimliği, açık 
KİMLİK Connect 'i uygulamak için ıdentityserver4 ile birleştirilir. 

Identityserver4, ASP.NET Core 3,0 için bir OpenlD Connect ve OAuth 2,0 çerçevesidir.Aşağıdaki güvenlik 
özelliklerini sunar: 

• Hizmet olarak kimlik doğrulaması (AaaS) 

• Birden çok uygulama türü üzerinde çoklu oturum açma/kapatma (SSO) 

• API 'Ler için erişim denetimi 

• Federasyon ağ geçidi 

Daha fazla bilgi için bkz. ıdentityserver4 belgeleri veya kimlik doğrulaması ve kimlik doğrulama ve yetkilendirme. 

Sertifika ve Kerberos kimlik doğrulaması 

Sertifika kimlik doğrulaması şunları gerektirir: 

• Sunucu, sertifikaları kabul edecek şekilde yapılandırılıyor. 

• Kimlik doğrulama ara yazılımı startup.configure 1 ye ekleniyor. 

• Sertifika kimlik doğrulama hizmeti startup.configureServices 1 de ekleniyor. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddAuthentication( 

CertificateAuthenticationDefaults.AuthenticationScheme) 

.AddCertificate(); 

// Other service configuration removed. 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

app.UseAuthentication(); 

// Other app configuration removed. 

} 

Sertifika kimlik doğrulaması seçenekleri şunları yapabilme: 

• Otomatik olarak imzalanan sertifikaları kabul edin. 

• Sertifika iptali olup olmadığını denetleyin. 









• Profili oluşturulan sertifikanın, içinde doğru kullanım bayrakları olduğunu denetleyin. 

Varsayılan bir Kullanıcı sorumlusu, sertifika özelliklerinden oluşturulur. Kullanıcı sorumlusu, sorumlunun takıma 
veya değiştirilmesine izin veren bir olay içerir. Daha fazla bilgi için bkz. ASP.NET Core sertifika kimlik 
doğrulamasını yapılandırma. 

Windows kimlik doğrulaması , Linux ve MacOS üzerine genişletildi. Önceki sürümlerde, VVİndovvs kimlik 
doğrulaması 11S ve httpsysile sınırlandırıldı. ASP.N ET Core 3,0 ' de Kestrel , VVİndovvs etki alanına katılmış konaklar 
için VVİndovvs, Linux ve MacOS üzerinde Negotiate, Kerberosve NTLMkullanma olanağına sahiptir. Bu kimlik 
doğrulama düzenlerinin Kestrel desteği Microsoft. AspNetCore. Authentication. Negotiate NuGet paketi tarafından 
sağlanır. Diğer kimlik doğrulama hizmetlerinde olduğu gibi, kimlik doğrulama uygulaması genelinde yapılandırın 
ve ardından hizmeti yapılandırın: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddAuthentication(NegotiateDefaults.AuthenticationScheme) 

.AddNegotiate(); 

// Other service configuration removed. 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

app.UseAuthentication(); 

// Other app configuration removed. 

} 

Ana bilgisayar gereksinimleri: 

• VVİndovvs Konakları, uygulamayı barındıran Kullanıcı hesabına eklenmiş hizmet sorumlusu adlarına (SPN) sahip 
olmalıdır. 

• Linuxve macOS makineleri etki alanına katılmalıdır, 
o VVeb işlemi için SPN oluşturulması gerekir. 

o Ana makinede keytab dosyalarının oluşturulup yapılandırılması gerekir. 

Daha fazla bilgi için bkz. ASP.NET Core VVİndovvs kimlik doğrulamasını yapılandırma. 

Şablon değişiklikleri 

Web Ul şablonları (Razor Pages, denetleyici ve görünümlerle MVC) şu şekilde kaldırılmıştır: 

• Tanımlama bilgisi onayı Kullanıcı arabirimi artık dahil değildir. ASP.NET Core 3,0 şablon tarafından oluşturulan 
bir uygulamada tanımlama bilgisi onay özelliğini etkinleştirmek için, bkz. ASP.NET Core Genel Veri Koruma 
Yönetmeliği (GDPR) desteği. 

• Betiklerin ve ilgili statik varlıkların artık CDNs kullanmak yerine yerel dosyalar olarak başvuruluyor. Daha fazla 
bilgi için, bkz. betiklerin ve ilgili statik varlıkların artık geçerli ortama göre CDNs kullanmak yerine yerel 
dosyalar olarak başvuruluyor (ASPNET/AspNetCore. Docs #14350). 

Angular şablonu, angular 8 ' i kullanacak şekilde güncelleştirildi. 

Razor sınıf kitaplığı (RCL) şablonu varsayılan olarak Razor bileşen geliştirmeyi varsayılan olarak belirler.Visual 
Studio 'da yeni bir şablon seçeneği, sayfalar ve görünümler için şablon desteği sağlar. Bir komut kabuğunda 
şablondan RCL oluştururken --support-pages-and-views seçeneğini ( 
dotnet new razorclasslib --support-pages-and-views ) geçirin. 


Genel Konak 

ASP.NET Core 3,0 şablonları .NET genel ana bilgisayarkullanır. Önceki sürümler VVebHostBuilderkullanıldı. .NET 






Core genel ana bilgisayarı 'nı (HostBuilder) kullanarak, Web 'e özgü olmayan diğer sunucu senaryolarıyla 
ASP.NET Core uygulamaları daha iyi tümleştirme sağlar. Daha fazla bilgi için bkz. Hostbuilder VVebHostBuilder'ın 
yerini alır. 

Konak yapılandırması 

ASP.NET Core 3,0 ' nin yayınlanmasından önce, aspnetcore_ önekli ortam değişkenleri Web konağının ana 
bilgisayar yapılandırması için yüklendi. 3,0 ' de AddEnvironmentVariables , CreateDefaultBuilder ile konak 
yapılandırması için dotnet_ ön eki eklenmiş ortam değişkenlerini yüklemek için kullanılır. 

Başlangıç Oluşturucu Ekleme değişiklikleri 

Genel ana bilgisayar yalnızca startup Oluşturucu ekleme için aşağıdaki türleri destekler: 

• IHostEnvironment 

• IWebHostEnvironment 

• IConfiguration 

Tüm hizmetler yine de startup.configure metoduna bağımsız değişken olarak eklenebilir. Daha fazla bilgi için bkz. 

genel ana bilgisayar başlangıç Oluşturucu Ekleme (ASPNET/duyurular #353). 

Kestrel 

• Kestrel yapılandırması, genel konağa geçiş için güncelleştirildi. 3,0 ' de Kestrel, configurewebHostDefauits 
tarafından belirtilen Web ana bilgisayar Oluşturucu üzerinde yapılandırılır. 

• Bağlantı bağdaştırıcıları, Kestrel adresinden kaldırılmıştır ve bağlantı ara yazılımı ile değiştirilmiştir ve bu, 

AS P.N ET Core işlem hattındaki HTTP ara hattına benzer ancak alt düzey bağlantılar için kullanılır. 

• Kestrel aktarım katmanı connections.Abstractions bir ortak arabirim olarak kullanıma sunuldu. 

• Sondaki üstbilgiler yeni bir koleksiyona taşınarak üstbilgiler ve tanıtımları arasındaki belirsizlik çözüldü. 

• HttpRequest.Body.Read gibi zaman uyumlu GÇ API 'Leri, uygulama kilitlenmelerine neden olan yaygın bir iş 
parçacığı kaynağıdır. 3,0 1 de, AiiowSynchronousio varsayılan olarak devre dışıdır. 

Daha fazla bilgi için bkz. ASP.NET Core 2,2 ' den 3,0 ' e geçiş yapın. 

Varsayılan olarak etkin HTTP/2 

HTTP/2, HTTPS uç noktaları için Kestrel içinde varsayılan olarak etkindir. IIS veya HTTP, sys için HTTP/2 desteği, 
işletim sistemi tarafından desteklendikleri zaman etkindir. 

İstek üzerine EventCounters 

Microsoft.AspNetcore.Hosting barındırma EventSource, gelen isteklerle ilgili aşağıdaki yeni EventCounter türlerini 
yayar: 

• requests-per-second 

• total-requests 

• current-requests 

• failed-requests 

Uç nokta yönlendirme 

Çerçeveler 'in (örneğin, MVC) ara yazılım ile iyi çalışmasına izin veren uç nokta yönlendirme geliştirildi: 

• Ara yazılım ve uç noktaların sırası, startup. configure istek işleme ardışık düzeninde yapılandırılabilir. 

• Uç noktalar ve ara yazılımlar, sistem durumu denetimleri gibi diğer ASP.NET Core tabanlı teknolojilerle birlikte. 












• Uç noktalar, hem yazılım hem de MVC 'de CORS veya yetkilendirme gibi bir ilke uygulayabilir. 

• Filtreler ve öznitelikler, denetleyicilerde yöntemler üzerine yerleştirilebilir. 

Daha fazla bilgi için bkz. AS P.N ET Core yönlendirme. 

Sistem durumu denetimleri 

Sistem durumu denetimleri, genel ana bilgisayar ile Endpoint Routing kullanır, startup.configure , uç nokta URL 
'SI veya göreli yol ile Endpoint Builder üzerinde MapHealthChecks çağırın: 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapHealthChecks("/health"); 

}); 

Durum denetimleri uç noktaları şunları yapabilir: 

• İzin verilen bir veya daha fazla Konakları/bağlantı noktasını belirtin. 

• Yetkilendirme gerektir. 

• CORS gerektir. 

Daha fazla bilgi için aşağıdaki makalelere bakın: 

• ASP.NET Core 2,2 ' den 3,0 ' e geçiş yapın 

• ASP.NET Core durum denetimleri 

HttpContext üzerindeki kanallar 

Artık istek gövdesini okumak ve System.10.Pipelines API 'sini kullanarak yanıt gövdesini yazmak mümkündür. 
Bağlamayı içeren HttpRequest.BodyReader özellik, istek gövdesini okumak için kullanılabilecek bir PipeReader 
sağlar. Bağlamayı içeren HttpResponse.Bodywriter özellik, yanıt gövdesini yazmak için kullanılabilecek bir 
HttpRequest.BodyReader , HttpRequest.Body akışının analogidir. HttpResponse. Bodyl/Jriter , 
akışının analogidir. 

11S 'de geliştirilmiş hata raporlama 

11S 'de AS P.N ET Core uygulamalar barındırırken başlatma hataları artık daha zengin Tanılama verileri oluşturuyor. 
Bu hatalar, geçerli her yerde yığın izlemelerle Windows olay günlüğü 'ne bildirilir.Ayrıca, tüm uyarılar, hatalar ve 
işlenmemiş özel durumlar VVİndovvs olay günlüğü 'ne kaydedilir. 

Çalışan hizmeti ve çalışan SDK 'Sı 

.N ET Core 3,0 yeni çalışan hizmeti uygulama şablonunu tanıtır. Bu şablon, .N ET Core 'da uzun süre çalışan 
hizmetler yazmak için bir başlangıç noktası sağlar. 

Daha fazla bilgi için bkz. 

• VVİndovvs Hizmetleri olarak .NET Core çalışanları 

• ASP.NET Core içinde barındırılan hizmetlerle arka plan görevleri 

• VVİndovvs hizmetinde konak ASP.NET Core 

İletilen üstbilgiler ara yazılımı geliştirmeleri 

Önceki ASP.NET Core sürümlerinde, UseHsts ve UseHttpsRedirection çağırmak, bir Azure Linux 'a veya 11S 
dışında herhangi bir ters proxy 'nin arkasına dağıtıldığında sorunlu bir sorun oluştu. Önceki sürümlere yönelik 


PıpeVVrıter sağlar. 
HttpResponse.Body 









düzeltmeler, Linux ve IIS olmayan ters proxy 'lerin düzenini iletmebölümünde belgelenmiştir. 

BusenaryoASP.NET Core 3,0 1 de düzeltilmiştir. aspnetcore_forwardedheaders_enabled ortam değişkeni true 
olarak ayarlandığında, ana bilgisayar İletilen üstbilgiler ara yazılımını sağlar. aspnetcore_forwardedheaders_enabled , 
kapsayıcı görüntülerimizde true olarak ayarlanır. 

Performans geliştirmeleri 

ASP.NET Core 3,0, bellek kullanımını azaltan ve üretilen işi geliştiren birçok geliştirme içerir: 

• Kapsamlı hizmetler için yerleşik bağımlılık ekleme kapsayıcısını kullanırken bellek kullanımında azaltma. 

• Ara yazılım senaryoları ve yönlendirme dahil olmak üzere çerçeve genelinde ayırmalarda azaltma. 

• VVebSocket bağlantıları için bellek kullanımında azaltma. 

• HTTPS bağlantıları için bellek azaltma ve verimlilik geliştirmeleri. 

• Yeni iyileştirilmiş ve tamamen zaman uyumsuz JSON serileştiricisi. 

• Form ayrıştırılırken bellek kullanımı ve üretilen iş iyileştirmeleri azaltılması. 

ASP.NET Core 3,0 yalnızca .NET Core 3,0 üzerinde çalışır 

ASP.NET Core 3,0 itibariyle, .NET Framevvork artık desteklenen bir hedef çerçeve değildir. .NET Framevvork 
hedefleyen projeler .N ET Core 2,1 LTS sürümünükullanarak tam olarak desteklenen bir biçimde devam edebilir. 
ASP.NET Core 2.1. x ile ilgili paketlerin çoğu, .NET Core 2,1 için üç yıllık LTS döneminin ötesinde süresiz olarak 
desteklenecektir. 

Geçiş bilgileri için bkz. kodunuzu .NET Core 'a .NET Framevvork. 

ASP.NET Core paylaşılan çerçevesini kullanma 

Microsoft. AspNetCore. app metapackageiçinde bulunan ASP.NET Core 3,0 paylaşılan çerçevesi artık proje 
dosyasında açık bir <PackageReference /> öğesi gerektirmez. Paylaşılan çerçeveye proje dosyasında 
Microsoft. net. sdk.web SDK kullanılırken otomatik olarak başvurulur: 

<Project Sdk="Microsoft.NET.Sdk.Web"> 


ASP.NET Core paylaşılan çerçevesinden kaldırılan derlemeler 

ASP.NET Core 3,0 paylaşılan çerçevesinden çıkarılan en önemli derlemeler şunlardır: 

• Nevvtonsoft. JSON (JSON.net). ASP.NET Core 3,0 ' ye Json.NET eklemek için bkz. Nevvtonsoft. JSON tabanlı 
JSON biçimi desteği ekleme. ASP.NET Core 3,0, JSON okuma ve yazma için System.Text.nson tanıtır. Daha 
fazla bilgi için bu belgede yem JSON serileştirmesi bölümüne bakın. 

• Entity Framevvork Core 

Paylaşılan çerçeveden kaldırılan derlemelerin tamamen listesi için bkz . Microsoft. AspNetCore. App 3,0 ' den 
kaldırılan derlemeler. Bu değişiklik için mösyön hakkında daha fazla bilgi için bkz. 3,0 'de Microsoft. AspNetCore. 
app 'e yönelik son değişiklikler ve ASP.NET Core 3,0 1 de gelen değişikliklere ilk bakış. 
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Bu makalede, AS P.N ET Core 2,2 ' deki en önemli değişiklikler, ilgili belgelerin bağlantılarıyla vurgulanır. 

Openapı Çözümleyicileri & kuralları 

Openapı (eski adıyla Svvagger), REST API 'Leri açıklamak için dilden bağımsız bir belirtimdir. Openapı ekosistemi, 
belirtimi kullanarak istemci kodu bulma, test etme ve oluşturmaya imkan tanıyan araçlara sahiptir. AS P.N ET Core 
MVC 'de Openapı belgelerini oluşturma ve görselleştirmeye yönelik destek, Nsvvag ve svvashbuckle. aspnetcoregibi 
topluluk odaklı projeler aracılığıyla sağlanır. AS P.N ET Core 2,2, Openapı belgelerini oluşturmak için geliştirilmiş 
araç ve çalışma zamanı deneyimleri sağlar. 

Daha fazla bilgi için aşağıdaki kaynaklara bakın: 

• Web API Çözümleyicileri kullanma 

• Web API'SI kurallarını kullanma 

• ASP.NET Core 2.2.0-preview1 'i: Openapı Çözümleyicileri & kuralları 

Sorun ayrıntıları desteği 

ASP.NET Core 2,1, HTTP yanıtıyla bir hatanın ayrıntılarını taşıyan RFC 7807 belirtimine göre ProblemDetails 
tanıtılmıştır. 2,2 1 de ProblemDetails , ApiControiierAttribute öznitelikli denetleyicilerde istemci hata kodları için 
standart yanıttır, istemci hata durum kodu (4xx) döndüren bir iActionResuit , artık bir ProblemDetails gövdesi 
döndürüyor. Sonuç Ayrıca, istek günlüklerini kullanarak hatayı ilişkilendirmek için kullanılabilecek bir bağıntı 
KİMLİĞİ içerir, istemci hataları için ProducesResponseType varsayılan olarak yanıt türü olarak ProblemDetails 
kullanın. Bu, NSvvag veya svvashbuckle. AspNetCore kullanılarak oluşturulan OpenAPI/Svvagger çıktısında 
belgelenmiştir. 

Uç nokta yönlendirme 

AS P.N ET Core 2,2, isteklerin gelişmiş şekilde gönderilirken yeni bir uç nokta yönlendirme sistemi kullanır. 
Değişiklikler yeni bağlantı oluşturma API 'SI üyelerini ve yol parametresi dönüştürücüler içerir. 

Daha fazla bilgi için aşağıdaki kaynaklara bakın: 

• 2,2 içinde Endpoint Routing 

• Yol parametresi dönüştürücüler (bkz. yönlendirme bölümü) 

• IRouter ve uç nokta tabanlı yönlendirme arasındaki farklar 

Sistem durumu denetimleri 

Yeni bir sistem durumu denetimleri hizmeti, Kubernetes gibi sistem durumu denetimleri gerektiren ortamlarda 
ASP.NET Core kullanmayı kolaylaştırır. Sistem durumu denetimleri, ara yazılım ve bir iHealthCheck soyutlama ve 
hizmet tanımlayan bir kitaplık kümesi içerir. 

Sistem durum denetimleri bir kapsayıcı Orchestrator veya yük dengeleyici tarafından, sistemin isteklere normal 
olarak yanıt verip vermediğini hızlı bir şekilde tespit etmek için kullanılır. Bir kapsayıcı Orchestrator, sıralı bir 
dağıtımı kaldırarak veya kapsayıcıyı yeniden başlatarak başarısız olan bir sistem durumu denetimine yanıt verebilir. 
Yük dengeleyici, trafiği hizmetin başarısız olan örneğinden dışarıda yönlendirerek bir sistem durumu denetimine 
yanıt verebilir. 










Sistem durumu denetimleri, bir uygulama tarafından, izleme sistemleri tarafından kullanılan bir HTTP uç noktası 
olarak sunulur. Sistem durumu denetimleri, çeşitli gerçek zamanlı izleme senaryoları ve izleme sistemleri için 
yapılandırılabilir. Sistem durumu denetimleri hizmeti, Beatpulse projesiyletümleştirilir. Bu, düzinelerce popüler 
sistemler ve Bağımlılıklar için denetim eklemenizi kolaylaştırır. 

Daha fazla bilgi için bkz. ASP.NET Core durum denetimleri. 

Kestrel içinde HTTP/2 

ASP.NET Core 2,2, HTTP/2 desteği ekliyor. 

HTTP/2, HTTP protokolünün önemli bir düzeltmesidir. HTTP/2 1 nin önemli özellikleri şunlardır: 

• Üst bilgi sıkıştırma desteği. 

• Tek bir bağlantı üzerinden tamamen çoğullanmış akışlar. 

Http/2, HTTP 'nin semantiğini (örneğin, HTTP üst bilgileri ve yöntemleri) korur, ancak istemci ve sunucu arasında 
verilerin nasıl çerçeveli ve gönderilir olduğunu HTTP/1. x ' den önemli bir değişiklik olur. 

Çerçeveleme içindeki bu değişikliğin bir sonucu olarak, sunucuların ve istemcilerin kullanılan protokol sürümünü 
anlaşması gerekir. Uygulama katmanı protokol anlaşması (ALPN), sunucunun ve istemcisinin TLS el sıkışmasının 
bir parçası olarak kullanılan protokol sürümünü anlaşmasına izin veren bir TLS uzantısıdır. Sunucu ve protokoldeki 
istemci arasında bir önceki bilgi sahibi olmak mümkün olsa da, tüm büyük tarayıcılarda bir HTTP/2 bağlantısı 
kurmak için tek yol olarak tüm büyük tarayıcılar desteklenir. 

Daha fazla bilgi için bkz. http/2 desteği. 

Kestrel yapılandırması 

AS P.N ET Core önceki sürümlerinde, Kestrel seçenekleri useKestrel çağırarak yapılandırılır. 2,2 ' de, Kestrel 
seçenekleri konak Oluşturucu üzerinde configureKestrel çağırarak yapılandırılır. Bu değişiklik, işlem içi barındırma 
için ıserver kayıtları sırasıyla bir sorunu çözer. Daha fazla bilgi için aşağıdaki kaynaklara bakın: 

• Useııs çakışmasını azaltma 

• ConfigureKestrel ile Kestrel Server seçeneklerini yapılandırma 

11S işlem içi barındırma 

ASP.NET Core önceki sürümlerinde MS, ters proxy işlevi görür.2,2 ' de ASP.NET Core modülü CoreCLR 'yi 
önyükleyebilir ve 11S çalışan işleminin {W3wp. exe) içinde bir uygulamayı barındırabilir. işlem içi barındırma, 11S ile 
çalışırken performans ve tanılama kazançları sağlar. 

Daha fazla bilgi için bkz. 11S için işlem içi barındırma. 

SignalR Java istemcisi 

ASP.NET Core 2,2 SignalR için bir Java İstemcisi sunar. Bu istemci, Android uygulamaları dahil olmak üzere Java 
kodundan bir ASP.NET Core SignalR sunucusuna bağlanmayı destekler. 

Daha fazla bilgi için bkz. ASP.NET Core SignalR Java istemcisi. 

CORS geliştirmeleri 

ASP.NET Core önceki sürümlerinde, CORS ara yazılımı origin yapılandırılan değerlere bakılmaksızın Accept , 
Accept-Language , Content-Language ve corsPolicy.Headers üst bilgilerinin gönderilmesini sağlar. 2,2 ' de, bir CORS 
ara yazılım ilkesi eşleşmesi yalnızca Access-controi-Request-Headers ' de gönderilen üstbilgiler withHeaders 









belirtilen üstbilgileriyle tam olarak eşleşiyorsa mümkündür. 

Daha fazla bilgi için bkz. CORS ara yazılımı. 

Yanıt sıkıştırma 

AS P.N ET Core 2,2, yanıtları Brotli sıkıştırma biçim iylesı kıştırabilir. 

Daha fazla bilgi için bkz. Yanıt sıkıştırma ara yazılımı Brotli sıkıştırmayı destekler. 

Proje şablonları 

AS P.N ET Core Web projesi şablonları, önyükleme 4 ve angular 6' ya güncelleştirildi. Yeni görünüm görsel açıdan 
basittir ve uygulamanın önemli yapılarını görmeyi kolaylaştırır. 


I Home page - RazorPagesMovie x + 

- □ X 

<r -> C A https://localhost:5001 

0 i 

RazorPagesMovie Home Privacy 


Welcome 

Learn about building Web apps with ASP.NET Coıe. 


© 2018 - RazorPagesMovie - Privacy 



Doğrulama performansı 

MVC 'nin doğrulama sistemi genişletilebilir ve esnek olacak şekilde tasarlanmıştır, bu sayede, belirli bir modele 
yönelik doğrulayıcıların hangi istek tabanlı olarak uygulanacağını belirlemenizi sağlar. Bu, karmaşık doğrulama 
sağlayıcıları yazmak için idealdir. Ancak, en yaygın durumda bir uygulama yalnızca yerleşik Doğrulayıcıları kullanır 
ve bu fazladan esneklik gerektirmez. Yerleşik doğrulayıcılar, [gerekli] ve [StringLength] gibi veri açıklamalarını içerir 
ve IValidatableObject . 

ASP.NET Core 2,2 1 de, MVC, belirli bir model grafiğinin doğrulama gerektirmediğini belirlerse kısa devre 
doğrulaması yapabilir. Doğrulama sonuçları, hiçbir doğrulayıcıya sahip olmayan modelleri doğrularken önemli 
geliştirmelere karşı atlanıyor. Bu, çok sayıda Doğrulayıcıları olmayan temel elemanlar koleksiyonları ( byte[] , 
string[] , Dictionary<string, string> ) veya karmaşık nesne grafikleri gibi nesneleri içerir. 

HTTP İstemci performansı 

ASP.NET Core 2,2 1 de, bağlantı havuzu kilitleme çakışması azaltılarak socketsHttpHandler performansı 
geliştirilmiştir. Bazı mikro hizmet mimarileri gibi birçok giden HTTP isteğini yapan uygulamalar için üretilen iş 
geliştirildi. Yük altında Httpciient işleme, Linux üzerinde %60 1 e kadar ve Windows üzerinde %20 oranında 
artırılabilir. 


Daha fazla bilgi için Bu geliştirmeyi yapan çekme isteğinebakın. 









Ek bilgiler 

Değişikliklerin tamamı listesi için AS P.N ET Core 2,2 sürüm notlarınabakın. 
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Bu makalede, AS P.N ET Core 2,1 ' deki en önemli değişiklikler, ilgili belgelerin bağlantılarıyla vurgulanır. 

SignalR 

SignalR ASP.NET Core 2,1 için yeniden yazıldı. AS P.N ET Core SignalR bir dizi geliştirme içerir: 

• Basitleştirilmiş bir genişleme modeli. 

• JQuery bağımlılığı olmayan yeni bir JavaScript istemcisi. 

• MessagePack tabanlı yeni bir Compact binary protokolü. 

• Özel protokoller için destek. 

• Yeni bir akış yanıt modeli. 

• Çıplak VVebSockets tabanlı istemciler için destek. 

Daha fazla bilgi için bkz. ASP.NET Core SignalR. 

Razor sınıf kitaplıkları 

ASP.NET Core 2,1, bir kitaplıkta Razor tabanlı kullanıcı arabirimini oluşturmayı ve eklemeyi kolaylaştırır ve birden 
fazla proje arasında paylaşabilir. Yeni Razor SDK 'Sı, bir NuGet paketine paketlenebilecek bir sınıf kitaplığı 
projesinde Razor dosyaları oluşturulmasına izin verebilir. Kitaplıklardaki görünümler ve sayfalar otomatik olarak 
keşfedilir ve uygulama tarafından geçersiz kılınabilir. Razor derlemesini yapıyla tümleştirerek: 

• Uygulama başlatma süresi önemli ölçüde daha hızlıdır. 

• Çalışma zamanında Razor görünümlerinin ve sayfalarının hızlı güncelleştirmeleri, yinelemeli bir geliştirme iş 
akışının bir parçası olarak hala kullanılabilir. 

Daha fazla bilgi için bkz. Razor Sınıf Kitaplığı projesini kullanarak yeniden kullanılabilir kullanıcı arabirimi 
oluşturma. 

Identity Ul kitaplığı & Yapı iskelesi 

ASP.NET Core 2,1, Razor sınıf kitapl ığıolarak AS P.N ET Core kimliği sağlar. Kimlik içeren uygulamalar, kimlik Razor 
sınıf kitaplığı 'nda (RCL) bulunan kaynak kodu seçmeli olarak eklemek için yeni Identity desteği 'ı uygulayabilir. 
Kodu değiştirebilmeniz ve davranışı değiştirebilmek için kaynak kodu oluşturmak isteyebilirsiniz. Örneğin, kayıt 
sırasında kullanılan kodu oluşturmak için desteği 1 ı söyleyebilirsiniz. Oluşturulan kod, RCL kimliği içindeki aynı 
koddan önceliklidir. 

Kimlik doğrulaması içermeyen uygulamalar , RCL kimlik paketini eklemek için Identity desteği T uygulayabilir. 
Oluşturulacak kimlik kodunu seçme seçeneğiniz vardır. 

Daha fazla bilgi için AS P.N ET Core projelerinde yapı İskelesi kimliği' ne bakın. 


HTTPS 


Güvenlik ve gizlilikle ilgili daha fazla odaklanarak Web Apps için HTTPS ’nin etkinleştirilmesi önemlidir. HTTPS 
zorlaması Web üzerinde giderek daha sıkı hale geliyor. HTTPS kullanmayan siteler güvensiz olarak değerlendirilir. 
Tarayıcılar (Bermıum, Mozilla), Web özelliklerinin güvenli bir içerikten kullanılması gerektiğini zorlamaya başlıyor. 
GDPR , Kullanıcı gizliliğini korumak için https kullanılmasını gerektirir.Üretimde HTTPS kullanılması kritiktir, ancak 





geliştirme sırasında HTTPS kullanılması, dağıtımdaki sorunları önlemeye yardımcı olabilir (örneğin, güvenli 
olmayan bağlantılar). ASP.NET Core 2,1, geliştirme sırasında HTTPS kullanmayı ve üretimde HTTPS 'yi 
yapılandırmayı kolaylaştıran bir dizi geliştirme içerir. Daha fazla bilgi için bkz. https 'Yi zorlama. 

Varsayılan olarak açık 

Güvenli Web sitesi geliştirmeyi kolaylaştırmak için, HTTPS artık varsayılan olarak etkinleştirilmiştir. 2,1 1 den 
başlayarak, yerel bir geliştirme sertifikası mevcut olduğunda, Kestrel https://iocaihost : 500 ı dinler. Geliştirme 
sertifikası oluşturuldu: 

• ilk kez .NET Core SDK ilk çalıştırma deneyiminin bir parçası olarak SDK 'Yı ilk kez kullandığınızda. 

• Yeni dev-certs aracını kullanarak el ile. 

Sertifikaya güvenmek için dotnet dev-certs https --trust çalıştırın. 

HTTPS yönlendirmesi ve zorlaması 

Web uygulamalarının genellikle hem HTTP hem de HTTPS üzerinde dinlemesi gerekir, ancak tüm HTTP trafiğini 
HTTPS 'ye yeniden yönlendirir. 2,1 ' de, yapılandırma veya bağlı sunucu bağlantı noktalarının varlığına göre daha 
fazla yeniden yönlendirilen özelleştirilmiş HTTPS yeniden yönlendirme ara yazılımı sunulmuştur. 

HTTPS kullanımı, http katı aktarım güvenliği Protokolü (HSTS)kullanılarak daha fazla zorlanabilir. HSTS, 
tarayıcıların siteye her zaman HTTPS aracılığıyla erişmesini söyler. ASP.NET Core 2,1, maksimum yaş, alt etki 
alanları ve HSTS önyükleme listesi seçeneklerini destekleyen HSTS ara yazılımı ekler. 

Üretim için yapılandırma 

Üretimde HTTPS 'nin açıkça yapılandırılması gerekir.2,1 ' de, Kestrel için HTTPS yapılandırmasına yönelik 
varsayılan yapılandırma şeması eklenmiştir. Uygulamalar aşağıdakileri kullanacak şekilde yapılandırılabilir: 

• URL 'Ler dahil olmak üzere birden fazla uç nokta. Daha fazla bilgi için bkz. Kestrel Web Server Implementation 
Endpoint Configuration. 

• Diskteki bir dosyadan veya bir sertifika deposundan HTTPS için kullanılacak sertifika. 


GDPR 

ASP.NET Core, bazı ab genel veri koruma yönetmeliği (GDPR) gereksinimlerini karşılamaya yardımcı olmak İçin 
API 'ler ve şablonlar sağlar. Daha fazla bilgi için bkz. GDPR Support in ASP.NET Core. Örnek bir uygulama ,' nin 
nasıl kullanılacağını gösterir ve ASP.NET Core 2,1 ŞABLONLARINA eklenen GDPR uzantı noktalarının ve API 
'lerin çoğunu test etmenizi sağlar. 

Tümleştirme testleri 

Test oluşturma ve yürütmeyi kolaylaştıran yeni bir paket tanıtılmıştır. Microsoft. AspNetCore. Mvc. Testing paketi 
aşağıdaki görevleri gerçekleştirir: 

• Bağımlılık dosyasını ( *. Deps ) test projesinin bin klasörüne kopyalar. 

• Testler yürütüldüğünde statik dosya ve sayfa/görünümlerin bulunması için, içerik kökünü test edilen 
uygulamanın proje köküne ayarlar. 

• TestServerile sınanan uygulamayı daha kolay hale getirmek İçin vvebapplicationfactory sınıfını sağlar. 

Aşağıdaki test, dizin sayfasının başarılı durum kodu ve doğru Content-Type üst bilgisi ile yüklenip yüklenduğunu 
denetlemek için xUnit kullanır: 






public class BasicTests 

: IClassFixture<WebApplicationFactory<RazorPagesProject.Startup>> 

{ 

private readonly HttpClient _client; 

public BasicTests(WebApplicationFactory<RazorPagesProject.Startup> factory) 
{ 

_client = factory.CreateClientO; 

} 

[Fact] 

public async Task GetHomePage() 

{ 

// Act 

var response = await _client.GetAsync("/"); 

// Assert 

response.EnsureSuccessStatusCode(); // Status Code 200-299 
Assert.Equal("text/html; charset=utf-8 ", 

response. Content .Headers.ContentType.ToStringO); 

} 

} 


Daha fazla bilgi için bkz. tümleştirme testleri konusu. 

[ApiController], ActionResultcT > 

ASP.NET Core 2,1, temiz ve açıklayıcı Web API 'Leri oluşturmayı kolaylaştıran yeni programlama kuralları ekliyor. 
ActionResuit<T > , bir uygulamanın yanıt türünü ya da başka bir eylem sonucunu (lactionresult gibi) döndürmesini 
sağlamak için eklenen yeni bir türdür, yine de yanıt türünü gösterir. [ApiController] özniteliği, Web API 'sine özgü 
kuralları ve davranışları kabul etmenin yolu olarak da eklenmiştir. 

Daha fazla bilgi için bkz. ASP.NET Core Web API 'Leri oluşturma. 

Ihttpclientfactory 

ASP.NET Core 2,1, uygulamalarda HttpClient örneklerinin daha kolay yapılandırılacağını ve kullanılmasını 
kolaylaştıran yeni bir iHttpciientFactory hizmeti içerir. HttpClient , giden HTTP istekleri için birlikte bağlanabilen 
işleyicileri temsilci seçme kavramına zaten sahiptir. Fabrika: 

• Adlandırılmış istemci başına HttpClient örneklerinin kaydını daha sezgisel hale getirir. 

• Yeniden deneme, devre kesiciler vb. için, Polly ilkelerinin kullanılmasına izin veren bir Polly işleyici uygular. 

Daha fazla bilgi için bkz. http İsteklerini başlatma. 

Kestrel aktarma yapılandırması 

ASP.NET Core 2,1 sürümü ile Kestrel 'in varsayılan taşıması artık libuv ' d i temel değildir ancak bunun yerine 
yönetilen yuvaları temel alır. Daha fazla bilgi için bkz. Kestrel Web sunucusu uygulama: aktarım yapılandırması. 

Genel konak Oluşturucu 

Genel ana bilgisayar Oluşturucu ( HostBuiider ) sunulmuştur.Bu Oluşturucu, HTTP isteklerini (mesajlaşma, arka 
plan görevleri vb.) işlemeyecek uygulamalar için kullanılabilir. 

Daha fazla bilgi için bkz. .NET genel ana bilgisayar. 


Güncelleştirilmiş SPA şablonları 









Redux ile ilgili angular, tepki verme ve tepki verme için tek sayfalı uygulama şablonları, her bir çerçeve için Standart 
proje yapılarını ve derleme sistemlerini kullanacak şekilde güncelleştirilir. 

Angular şablonu angular CLı 'y 1 temel alır ve yanıt verme şablonları Create-tepki-App ' i temel alır. 

Daha fazla bilgi için bkz. 

• Angular proje şablonunu ASP.NET Core ile kullanma 

• ASP.NET Core ile tepki verme proje şablonunu kullanın 

• ASP.NET Core ile React-ile-Redux proje şablonu kullanın 

Razor varlıkları için arama Razor Pages 

2,1 Razor Pages ' de, listelenen sırayla aşağıdaki dizinlerde Razor varlıklarını (örneğin, düzenler ve parals) arayın: 

1. Geçerli sayfalar klasörü. 

2. /Pages/Shared/ 

3. /Vievvs/Shared/ 

Bir alanda Razor Pages 

Artık Razor Pages alanıdesteklemektedir. Bir alan örneği görmek için, bireysel kullanıcı hesaplarıyla yeni bir Razor 
Pages Web uygulaması oluşturun. Bireysel kullanıcı hesaplarıyla bir Razor Pages Web uygulaması 
/A reas/ldentity/Pages\çer\r. 

MVC uyumluluk sürümü 

SetCompatibilityVersion yöntemi, bir uygulamanın, ASP.NET Core MVC 2,1 veya sonraki sürümlerde ortaya çıkan 
olası davranış değişikliklerinin kabul etmesine veya devre dışı olmasına izin verir. 

Daha fazla bilgi için bkz. ASP.NET Core MVC için uyumluluk sürümü. 

2,0 1 den 2,1 1 e geçiş 

Bkz. ASP.NET Core 2,0 1 den 2,1 1 e geçiş. 

Ek bilgiler 

Değişikliklerin tamamı listesi için ASP.NET Core 2,1 sürüm notlarınabakın. 


ASPNET Core 2,0 1 deki yenilikler 
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Bu makalede, AS P.N ET Core 2,0 ' deki en önemli değişiklikler, ilgili belgelerin bağlantılarıyla vurgulanır. 

Razor Pages 

Razor Pages, kod odaklı senaryoları daha kolay ve daha üretken hale getiren ASP.NET Core MVC 'nin yeni bir 
özelliğidir. 

Daha fazla bilgi için bkz. giriş ve öğretici: 

• Razor Pages'e giriş 

• Razor Sayfaları kullanmaya başlama 

ASP.NET Core metapackage 

Yeni bir ASP.NET Core metapackage, ASP.NET Core ve Entity Framework Core ekipleri tarafından oluşturulan ve 
desteklenen tüm paketleri dahili ve üçüncü taraf bağımlılıklarıyla birlikte içerir. Artık pakete göre bireysel AS P.N ET 
Core özelliklerini seçmeniz gerekmez. Tüm Özellikler Microsoft. AspNetCore. Ali paketine dahildir. Varsayılan 
Şablonlar bu paketi kullanır. 

Daha fazla bilgi için bkz. Microsoft. AspNetCore. Ali metapackage for ASP.NET Core 2,0. 

Çalışma zamanı deposu 

Microsoft.AspNetCore .ah metapackage kullanan uygulamalar, yeni .NET Core çalışma zamanı deposundan 
otomatik olarak yararlanır. Mağaza ASP.NET Core 2,0 uygulamalarını çalıştırmak için gereken tüm çalışma zamanı 
varlıklarını içerir. Microsoft. AspNetCore. ah metapackage kullandığınızda, başvurulan AS P.N ET CoreNuGet 
paketlerinden hiçbir varlık hedef sistemde zaten bulunduğundan uygulamayla birlikte dağıtılır. Çalışma zamanı 
deposundaki varlıklar Ayrıca uygulama başlatma süresini geliştirmek için önceden derlenmiş. 

Daha fazla bilgi için bkz. çalışma zamanı deposu 

.NET Standard 2,0 

AS P.N ET Core 2,0 paketleri .N ET Standard 2,0 1 dir. Paketlere diğer .N ET Standard 2,0 kitaplıkları tarafından 
başvurulabilir ve .NET Core 2,0 ve .NET Framevvork4.6.1 dahil olmak üzere .NET Standard 2,0 uyumlu .NET 
uygulamalarında çalıştırılabilir. 

Microsoft.AspNetCore .ah metapackage, .NET Core 2,0 çalışma zamanı deposuyla kullanılması amaçlanan için 
yalnızca .NET Core 2,0 1 i hedefler. 

Yapılandırma güncelleştirmesi 

ASP.NET Core 2,0 1 de hizmetler kapsayıcısına varsayılan olarak bir ıconfiguration örneği eklenir. Hizmetler 
kapsayıcısında ıconfiguration , uygulamaların kapsayıcıdan yapılandırma değerlerini almasına daha kolay hale 
getirir. 

Planlı belgelerin durumu hakkında daha fazla bilgi için bkz. GitHub sorunu. 









Günlük güncelleştirme 

ASP.NET Core 2,0 ' de günlüğe kaydetme, varsayılan olarak bağımlılık ekleme (dı) sistemine dahil edilir. 
Sağlayıcılar ekler ve Startup.es dosyası yerine program.es dosyasında filtrelemeyi yapılandırırsınız. Ve varsayılan 
iLoggerFactory , çapraz sağlayıcı filtreleme ve belirli sağlayıcı filtreleme için tek bir esnek yaklaşım kullanmanıza 
imkan tanıyan bir şekilde filtrelemeyi destekler. 

Daha fazla bilgi için bkz. günlüğe giriş. 

Kimlik doğrulama güncelleştirmesi 

Yeni bir kimlik doğrulama modeli, Dİ kullanarak bir uygulama için kimlik doğrulamasını yapılandırmayı 
kolaylaştırır. 

Azure AD B2Ckullanarak Web uygulamaları ve Web API 'lerinin kimlik doğrulamasını yapılandırmak için yeni 
şablonlar kullanılabilir. 

Planlı belgelerin durumu hakkında daha fazla bilgi için bkz. GitHub sorunu. 

Kimlik güncelleştirmesi 

ASP.NET Core 2,0 ' deki kimliği kullanarak güvenli Web API 'Leri oluşturmayı kolaylaştırdık. Microsoft kimlik 
doğrulama kitaplığı 'nı (msal)kullanarak Web API 'lerinize erişmek için erişim belirteçleri edinebilirsiniz. 

2,0 sürümündeki kimlik doğrulama değişiklikleriyle ilgili daha fazla bilgi için aşağıdaki kaynaklara bakın: 

• ASP.NET Core hesap onaylama ve parola kurtarma 

• ASP.NET Core 'de Authenticator uygulamaları için QR kodu oluşturmayı etkinleştirme 

• Kimlik doğrulaması ve kimliği 2,0 ASP.NET Core geçirin 

SPA şablonları 

Angular, Aurelia, altını gizleme.js, tepki, js ve Redux ile tepki.js için tek sayfalı uygulama (SPA) proje şablonları 
mevcuttur. Angular şablonu angular 4 ' e güncelleştirildi. Angular ve tepki verme şablonları varsayılan olarak 
kullanılabilir; diğer şablonları alma hakkında daha fazla bilgi için bkz. Yeni BİR Spa projesi oluşturma. ASP.NET 
Core 'de S PA oluşturma hakkında daha fazla bilgi için bkz. AS P.N ET Core içinde tek sayfalı uygulamalar 
oluşturmak için JavaScript hizmetlerini kullanın. 

Kestrel geliştirmeleri 

Kestrel Web sunucusu, Internet 'e yönelik bir sunucu olarak daha uygun hale getirmek için yeni özelliklere sahiptir. 
KestreiserverOptions sınıfının yeni Limits özelliğine bir dizi sunucu kısıtlaması yapılandırma seçeneği eklenir. 
Aşağıdakiler için sınır ekleyin: 

• istemci bağlantıları üst sınırı 

• En büyük istek gövdesi boyutu 

• En az istek gövdesi veri hızı 

Daha fazla bilgi için bkz. Kestrel Web Server Implementation For ASP.NET Core. 


VVebListener, HTTP, sys olarak yeniden adlandırıldı 



Daha fazla bilgi için ASP.NET Core 'de http. sys Web sunucusu uygulamasınabakın. 






Gelişmiş HTTP üst bilgisi desteği 


FilestreamResuit veya FiieContentResuit iletmek için MVC kullanırken, artık gönderdiğiniz içerik üzerinde bir 
ETag veya bir LastModified tarihi ayarlama seçeneğiniz vardır. Bu değerleri, döndürülen içerikte aşağıdakine 
benzer kodla ayarlayabilirsiniz: 



Bir uygulama ziyaretçisi bir Aralık İsteği üstbilgisiyle içerik isterse, ASP.NET Core isteği tanır ve üstbilgiyi işler, 
istenen içerik kısmen teslim edilebiliyorsa, AS P.N ET Core uygun şekilde atlar ve yalnızca istenen bayt kümesini 
döndürür. Bu özelliği uyarlamak veya işlemek için yöntemlerinize özel işleyiciler yazmanız gerekmez; sizin için 
otomatik olarak işlenir. 

Barındırma başlatma ve Application Insights 

Barındırma ortamları artık uygulamanın başlatılması sırasında ek paket bağımlılıklarını ekleyebilir ve uygulama 
başlatma sırasında kodu yürütebilir. Bu özellik, belirli ortamların, uygulamanın daha önce haberdar olması 
gerekmeden bu ortama özgü olan "hafif" özelliklere olanak tanımak için kullanılabilir. 

ASP.NET Core 2,0 1 de, bu özellik, Visual Studio 'da hata ayıklarken Application Insights tanılamayı otomatik olarak 
etkinleştirmek için kullanılır ve Azure Uygulama Hizmetleri 'nde çalışırken (uygulamasına geçtikten sonra). Sonuç 
olarak, proje şablonları artık varsayılan olarak Application Insights paketleri ve kodu eklemez. 

Planlı belgelerin durumu hakkında daha fazla bilgi için bkz. GitHub sorunu. 

Anti-forgery belirteçlerinin otomatik kullanımı 

ASP.NET Core, varsayılan olarak her zaman HTML kodsuz içeriğe yardımcı olur, ancak yeni sürüme, siteler arası 
istek sahteciliği (XSRF) saldırılarını önlemeye yardımcı olmak için ek bir adım alınmıştır. ASP.NET Core artık 
varsayılan olarak korsanlığa karşı koruma belirteçleri yayıp bunları, ek yapılandırma olmadan bu eylemleri ve 
sayfaları form SON RASı olarak doğrular. 

Daha fazla bilgi için bkz. siteler arası İstek forgery (XSRF/CSRF) saldırılarını önleme. 

Otomatik ön derleme 

Razor görünümü ön derlemesi varsayılan olarak yayımlama sırasında etkinleştirilir ve yayımlama çıkış boyutunu ve 
uygulama başlatma süresini azaltır. 

Daha fazla bilgi için AS P.N ET Core Razor görünümü derleme ve ön derleme' a bakın. 

7,1 için C# Razor desteği 

Razor görüntüleme altyapısı, yeni Roslyn derleyicisi ile çalışacak şekilde güncelleştirilmiştir. Bu, varsayılan İfadeler 
C#, gösterilen tanımlama grubu adları ve genel türler İle kalıp eşleme gibi 7,1 özellikleri için destek içerir. 
Projenizde 7,1 C# kullanmak için, proje dosyanıza aşağıdaki özelliği ekleyin ve çözümü yeniden yükleyin: 

<LangVersion>latest</LangVersion> 


C# 7,1 özelliklerinin durumu hakkında daha fazla bilgi için bkz. Roslyn GitHub deposu. 









2,0 için diğer belge güncelleştirmeleri 

• ASP.NET Core uygulama dağıtımı için Visual Studio yayımlama profilleri 

• Anahtar Yönetimi 

• Facebook kimlik doğrulamasını yapılandırma 

• Tvvitter kimlik doğrulamasını yapılandırma 

• Google kimlik doğrulamasını yapılandırma 

• Microsoft hesabı kimlik doğrulamasını yapılandırma 

Geçiş Kılavuzu 

ASP.NET Core 1. x uygulamalarının ASP.NET Core 2,0 ' e nasıl geçirileceğiyle ilgili yönergeler için aşağıdaki 
kaynaklara bakın: 

• ASP.NET Core 1. x öğesinden ASP.NET Core 2,0 'e geçirin 

• Kimlik doğrulaması ve kimliği 2,0 ASP.NET Core geçirin 

Ek Bilgiler 

Değişikliklerin tamamı listesi için ASP.NET Core 2,0 sürüm notlarınabakın. 

ASP.NET Core geliştirme ekibinin ilerleme ve planlarıyla bağlantı kurmak için, ASP.net Community' ye ayarlayın. 


ASPNET Core 1.1 yenilikler 

13.06.2019 • 2 minutes to read ı Edit Online 


ASP.NET Core 1.1 aşağıdaki yeni özellikler içerir: 

• URL Yeniden Yazma Ara Yazılımı 

• Yanıtları Önbelleğe Alma Ara Yazılımı 

• Görünüm bileşenleri olarak etiket Yardımcıları 

• MVC filtre olarak ara yazılımı 

• Tanımlama bilgisi tabanlı TempData sağlayıcısı 

• Azure App Service oturum açma sağlayıcısı 

• Azure Key Vault yapılandırma sağlayıcısı 

• Azure ve Redis depolama veri koruma anahtar deposu 

• VVebListener Windows Server'de 

• VVebSockets desteği 

Arasındaki sürümleri 1.0 ve ASP.NET Core 1.1 seçme 

ASP.NET Core 1.1,1.0 daha fazla özelliği vardır.Genel olarak, en son sürümünü kullanmanızı öneririz. 

Ek Bilgiler 

• AS P.N ET Core 1.1.0 sürüm notları 

• ASP.NET Core geliştirme takımın ilerleme durumu ve planları ile bağlanmak için etkinliğindeki ASP.NET 
topluluğu toplantısında. 





Öğretici: ASPNET Core ile Razor Pages Web 
uygulaması oluşturma 
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Bu öğretici dizisinde Razor Pages Web uygulaması oluşturma temelleri açıklanmaktadır. 

Denetleyiciler ve görünümler hakkında bilgi sahibi olan geliştiricilere daha gelişmiş bir giriş için bkz. tanıtım Razor 
Pages. 

Bu seri aşağıdaki öğreticileri içerir: 

1. Razor Sayfaları web uygulaması oluşturma 

2. Razor Pages uygulamasına model ekleme 

3. Yapı iskelesi (oluşturma) Razor sayfaları 

4. Bir veritabanıyla çalışma 

5. Razor sayfalarını güncelleştirme 

6. Arama ekleme 

7. Yeni alan ekleme 

8. Doğrulama ekleme 


Son olarak, bir film veritabanını görüntüleyebilen ve yönetebileceğini bir uygulamanıza sahip olacaksınız. 


| - lndex-Movie X + 

C A https://localhost:5001/Movies?SearchString=ghost ğ : 


RpMovİe Home Privacy 


lndex 


Create New 

Title: 


ghost 


Filter 


Title 

Release Date 

Genre 

Price 


Ghostbusters 

3/13/1984 

Comedy 

8.99 

Edit | Details | Delete 

Ghostbusters 2 

2/23/1986 

Comedy 

9.99 

Edit | Details | Delete 
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Öğretici: ASRNET Core Razor Pages ile çalışmaya 
başlama 
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Tarafından Rick Anderson 

Bu, bir serinin ASP.NET Core Razor Pages Web uygulaması oluşturma hakkında temel bilgileri öğretir. 

Denetleyiciler ve görünümler hakkında bilgi sahibi olan geliştiricilere daha gelişmiş bir giriş için bkz. tanıtım Razor 
Pages. 

Serinin sonunda, bir film veritabanını yöneten bir uygulamanız olacaktır. 

Örnek kodu görüntüle veya indir (indirme). 

Örnek kodu görüntüle veya indir (indirme). 

Bu öğreticide şunları yaptınız: 

• Razor Pages bir Web uygulaması oluşturun. 

• Uygulamayı çalıştırın. 

• Proje dosyalarını inceleyin. 

Bu öğreticinin sonunda, daha sonraki öğreticilerde oluşturacağınız çalışan bir Razor Pages Web uygulamasına 
sahipsiniz. 
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VVelcome 

Learn about building Web apps with ASP.NET Core. 
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Prerequisites 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• ASP.net ve Web geliştirme iş yüküyle Visual Studio 2019 16,4 veya üzeri 

• .NET Core 3,1 SDK veya üzeri 






Razor Pages Web uygulaması oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Visual Studio'dan dosya menüsünde yeni > proje. 

• Yeni bir AS P.N ET Core Web uygulaması oluşturun ve İleri 1 yiseçin. Yeni AS P.N ET Core Web uygulaması 


Create a new project 

Recent project templates 

O ASP.NET Core Web Application c* 

SI Class library (.NET Standard) c# 


Search for project templates P - Language » Platform * Project type - 


P 


Console App (.NET Core) 

A project for creating a command-line application that can njn on .NET Core on 
Windows, Linux and MacOS. 


C# Lınux macOS Windows Console 




ASP.NET Core Web Application 

Project templates for creating ASP.NET Core applicatıons for Wındows, Lınux and 
macOS using .NET Core or .NET Framevvork. Create Razor Pages, MVC, Web API, and 
Single Page (SPA) Applications. 


C# VVmdovvs Unux macOS Web 


a 


WPF App (.NET Core) 

Windows Presentation Foundation Client application 

C* Wındows Desktop 


Sİ 

<f> 


Class Library (.NET Standard) 

A project for creating a class library that targets .NET Standard. 

C# Android iOS Linux macOS Windows Library 

Azure Functions 

A template to create an Azure Function project. 

C* Azure Cloud 


Mobile App (Xamarin.Forms) 

□•=] 


Next 


• Projeyi RazorPagesMovieolarak adlandırın. Kodu kopyaladığınızda ve yapıştırdığınızda ad alanlarının 
eşleşmesi için Project RazorPagesMovie olarak adı vermek önemlidir. Yeni AS P.N ET Core Web uygulaması 




Configure your new project 

ASP.NET Core Web Application C* Linux macOS Windows Cloud Service Web 


Project name 


[RazorPagesMovie| 


Location 


C:\repos 


- 


Solution name O 


0 


Place solution and project in the same directory 


Back 


Create 


• Açılan Web uygulamasındaki ASP.N ET Core 3,1 1 i seçin ve ardından Oluştur 1 u seçin. 


X 


Create a new ASP.NET Core Web Application 


.NET Core 


- ASP.NET Core 3.0 



An empty project template for creating an ASP.NET Core application. This template does not have any 
content in it. 



A project template for creating an ASP.NET Core application with an example Controller for a RESTful HTTP 
service. This template can also be used for ASP.NET Core MVC Vievvs and Controllers. 

- y—^ Worker Service 

An empty project template for creating a worker service. 


Web Application 

A project template for creating an ASP.NET Core application with example ASP.NET Core Razor Pages 
content. 


Web Application (Model-View*Controller) 


A project template for creating an ASP.NET Core application with example ASP.NET Core MVC Views and 
Controllers. This template can also be used for RESTful HTTP Services. 


_- nRPr ^prvirp 


Get additional project templates 


Authentication 

No Authentication 

Change 


Advanced 

17) Configure for HTTPS 
j Enable Docker Support 
(Requires Docker Desktop) 

Linux 


Author: Microsoft 

Source: SDK 3.0.100-preview7-012801 


Back Create 


Aşağıdaki Başlatıcı proje oluşturulur: 


















Solution Explorer 

- ? X 

â Si - b * t; 9 i> [5' 


Search Solution Explorer (Ctr1+;) 


>31 Solution RazorPagesMovie' (1 project) 

^ RazorPagesMovie 

Qı Connected Services 


t> .V Dependencies 


P fi Properties 


P @ wwwroot 


a O Pages 


P İl Shared 


0 _Viewlfnports.cshtml 


0 _ViewStart.cshtml 


P 0 Error.cshtml 


P @ lndex.cshtml 


P 0 Privacy.cshtml 


P ol appsettingsjson 


P c* Program.es 


P c* Startup.es 



Uygulamayı çalıştırma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 


• Hata ayıklayıcı olmadan çalıştırmak için CTRL + F5 tuşlarına basın. 
Visual Studio aşağıdaki iletişim kutusunu görüntüler: 


Microsoft Visual Studio 


X 



This project is confıgured to use SSL To avoid SSL vvarnıngs in the browser you 
can choose to trust the self-sıgned certıfıcate that IIS Express has generated. 


Would you like to trust the IIS Express SSL certificate? 


ffl Don't ask me again 

Yes No 


IIS Express SSL sertifikasına güveniyorsanız Evet ' i seçin. 
Aşağıdaki iletişim kutusu görüntülenir: 









Security VVarning 


You are about to install a certificate from a certification 
authority (CA) daiming to represent 

localhost 

Windows cannotvalidatethat the certif icate is actuallyfrom 
'localhost'. You should confirm its origin by contacting 
'localhost'. Thefollovving numberwill assistyou inthis 
process: 

Thumbprint (shal): 35AAFB1F 70EC5F89 C7180FBD 61AFE491 
94580874 

Warning: 

If you install this root certif icate, Windows will automatically 
trust any certificate issued by this CA. Installing a certificate 
with an unconfirmed thumbprint is a security risk. If you dick 
'Yes' you acknowledge this risk. 

Do you want to install this certificate? 


Yes 



Geliştirme sertifikasına güvenmeyi kabul ediyorsanız Evet 1 i seçin. 

Visual Studio 11S Express başlar ve uygulamayı çalıştırır. Adres çubuğunda localhost :port# ve exampie.com 
gibi bir şey görüntülenir. Bunun nedeni, localhost yerel bilgisayar için Standart ana bilgisayar adıdır. 

Localhost yalnızca yerel bilgisayardan Web isteklerine hizmet verir. Visual Studio bir Web projesi 
oluşturduğunda, Web sunucusu için rastgele bir bağlantı noktası kullanılır. 

Proje dosyalarını inceleyin 

Aşağıda, daha sonraki öğreticilerde birlikte çalışacağımız ana proje klasörlerine ve dosyalarına genel bir bakış 
sunulmaktadır. 

Sayfalar klasörü 

Razor sayfaları ve destekleyici dosyalar içerir. Her Razor sayfası bir dosya çiftidir: 

• Razor söz dizimi kullanarak C# kodla HTML işaretlemesi içeren bir. cshtml dosyası. 

• Sayfa olaylarını işleyen kodu içeren C# bir. cshtml.cs dosyası. 

Destekleyici dosyalar bir alt çizgiyle başlayan adlara sahiptir.Örneğin, _Layout. cshtml dosyası tüm sayfalarda ortak 
kullanıcı arabirimi öğelerini yapılandırır. Bu dosya sayfanın en üstündeki gezinti menüsünü ve sayfanın alt 
kısmındaki telif hakkı bildirimini ayarlar. Daha fazla bilgi için bkz. ASP.NET Core düzen. 

Wwwroot klasörü 

HTML dosyaları, JavaScript dosyaları ve CSS dosyaları gibi statik dosyaları içerir.Daha fazla bilgi için bkz. ASP.NET 
Core statik dosyalar. 

appSettings. JSON 

Bağlantı dizeleri gibi yapılandırma verilerini içerir. Daha fazla bilgi için bkz. AS P.N ET Core yapılandırma. 

Program.es 

Programın giriş noktasını içerir.Daha fazla bilgi için bkz. .NET genel ana bilgisayar. 

Startup.es 

Uygulama davranışını yapılandıran kodu içerir.Daha fazla bilgi için bkz. ASP.NET Core 'de uygulama başlatma. 

Sonraki adımlar 

Serideki bir sonraki öğreticiye ilerleyin: 
















MODEL 

EKLEME 


Bu, bir serinin ilk öğreticisidir. Seriler , bir ASP.NET Core Razor pages Web uygulaması oluşturma hakkında temel 
bilgileri öğretir. 

Denetleyiciler ve görünümler hakkında bilgi sahibi olan geliştiricilere daha gelişmiş bir giriş için bkz. tanıtım Razor 
Pages. 

Serinin sonunda, bir film veritabanını yöneten bir uygulamanız olacaktır. 

Örnek kodu görüntüle veya indir (indirme). 

Örnek kodu görüntüle veya indir (indirme). 

Bu öğreticide şunları yaptınız: 

• Razor Pages bir Web uygulaması oluşturun. 

• Uygulamayı çalıştırın. 

• Proje dosyalarını inceleyin. 

Bu öğreticinin sonunda, daha sonraki öğreticilerde oluşturacağınız çalışan bir Razor Pages Web uygulamasına 
sahipsiniz. 


I Home page - RazorPagesMovie x + 
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RazorPagesMovie Home Privacy 


VVelcome 


Learn about building Web apps with ASP.NET Core. 


© 2018 - RazorPagesMovie - Privacy 

■w 


Prerequisites 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Visual Studio 2019 ile ASP.NET ve web geliştirme iş yükü 

• .NET core SDK 2.2 veya üzeri 





VVARNING 

Visual Studio 2017 kullanıyorsanız bkz dotnet/SDK'sı sorun #3124 Visual Studio ile çalışmayan .NET Core SDK sürümleri 
hakkında bilgi için. 


Razor Pages Web uygulaması oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Visual Studio'dan dosya menüsünde yeni > proje. 

• Yeni bir AS P.N ET Core Web uygulaması oluşturun ve İleri 1 yiseçin. 


Create a new project 

Recent project templates 

O ASP.NET Core Web Application c# 

89 Class Library (.NET Standard) c# 


Search for project templates P - Language * Platform » Project type - 


P 


Console App (.NET Core) 

A project for creating a command-line application that can njn on .NET Core on 
Windows, Linux and MacOS. 


C# Lınux macOS Windows Console 


0 


ASP.NET Core Web Application 

Project templates for creating ASP.NET Core applications for Wındows, Ünux and 
macOS using .NET Core or .NET Framework. Create Razor Pages, MVC, Web API, and 
Single Page (SPA) Applications. 


C# VVmdovvs Unux macOS Web 


a 


WPF App (.NET Core) 

Windows Presentation Foundation Client application 
C* Wındows Desktop 


8H 

<f> 


Class Library (.NET Standard) 

A project for creating a class library that targets .NET Standard. 

C# Android iOS Lirvux macOS Windows Library 

Azure Functions 

A template to create an Azure Function project. 

C# Azure Cloud 


Mobile App (Xamarin.Forms) 

□î=J 


Next 


• Projeyi RazorPagesMovieolarak adlandırın. Kodu kopyaladığınızda ve yapıştırdığınızda ad alanlarının 
eşleşmesi için Project RazorPagesMovie olarak adı vermek önemlidir. 






Configure your new project 

ASP.NET Core Web Application C* Linux macOS Windows Cloud Service Web 


Project name 


[RazorPagesMoviej 


Location 


C:\repos 


- 


Solution name O 


0 


Place solution and project in the same directory 


Back 


Create 


• Açılan Web uygulamasındaki ASP.NET Core 2,2 1 i seçin ve ardından Oluştur 1 u seçin. 


Create a new ASP.NET Core Web Application 


.NET Core 


- ASP.NET Core 2.2 



An empty project template for creating an ASP.NET Core applıcatıon. This template does not have any 
content in it 



A project template for creating an ASP.NET Core application with an example Controller for a RESTful HTTP 
service. This template can also be used for ASP.NET Core MVC Views and Controllers. 


Web Application 

A project template for creating an ASP.NET Core application with example ASP.NET Core Razor Pages 
content 


Web Application (Model-Vİevv-Controller) 


A project template for creating an ASP.NET Core application with example ASP.NET Core MVC Views and 
Controllers. This template can also be used for RESTful HTTP Services. 


qL@ Razor Class Library 

©II 

A project template for creating a Razor class library. 


^ Annıılar 

Get additional project templates 


Authentication 

No Authentication 

Change 


Advanced 

VI Configure for HTTPS 
1 Enable Docker Support 
(Reguires Docker Desktop) 


Author: Microsoft 
Source: SDK 2.2.104 


Back Create 


Aşağıdaki Başlatıcı proje oluşturulur: 
















Solution Explorer 

- ? X 

â Si - b * t; 9 i> [5' 


Search Solution Explorer (Ctr1+;) 


>31 Solution RazorPagesMovie' (1 project) 

^ RazorPagesMovie 

Qı Connected Services 


t> .V Dependencies 


P fi Properties 


P @ wwwroot 


a O Pages 


P İl Shared 


0 _Viewlfnports.cshtml 


0 _ViewStart.cshtml 


P 0 Error.cshtml 


P @ lndex.cshtml 


P 0 Privacy.cshtml 


P ol appsettingsjson 


P c* Program.es 


P c* Startup.es 



Uygulamayı çalıştırma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 


• Hata ayıklayıcı olmadan çalıştırmak için CTRL + F5 tuşlarına basın. 
Visual Studio aşağıdaki iletişim kutusunu görüntüler: 


Microsoft Visual Studio 


X 



This project is confıgured to use SSL To avoid SSL vvarnıngs in the browser you 
can choose to trust the self-sıgned certıfıcate that IIS Express has generated. 


Would you like to trust the IIS Express SSL certificate? 


ffl Don't ask me again 

Yes No 


IIS Express SSL sertifikasına güveniyorsanız Evet ' i seçin. 
Aşağıdaki iletişim kutusu görüntülenir: 









Security VVarning 


You are about to install a certificate from a certification 
A authority (CA) daiming to represent 

localhost 

Windows cannotvalidatethat the certif icate is actuallyfrom 
'localhost'. You should confirm its origin by contacting 
'localhost'. Thefollovving numberwill assistyou inthis 
process: 

Thumbprint (shal): 35AAFB1F 70EC5F89 C7180FBD 61AFE491 
94580874 

VVarning: 

If you install this root certif icate, Windows will automatically 
trust any certificate issued by this CA. Installing a certificate 
with an unconfirmed thumbprint is a security risk. If you dick 
'Yes' you acknovvledge this risk. 

Do you want to install this certificate? 


Yes 


No 


Geliştirme sertifikasına güvenmeyi kabul ediyorsanız Evet ' i seçin. 

Visual Studio 1 1S Express başlar ve uygulamayı çalıştırır. Adres çubuğu exampie.com gibi değil 
localhost:port# gösterir. Bunun nedeni, localhost yerel bilgisayar için Standart ana bilgisayar adıdır. 
Localhost yalnızca yerel bilgisayardan Web isteklerine hizmet verir. Visual Studio bir web projesi 
oluşturduğunda, vveb sunucusu için rastgele bir bağlantı noktası kullanılır. 

Uygulamanın giriş sayfasında, izlemeye izin vermek için kabul et ' i seçin. 

Bu uygulama kişisel bilgileri izlemez, ancak proje şablonu, Avrupa Birliği 'nin genel veri koruma yönetmeliğ 
(GDPR)ile uyumlu olması için ihtiyaç duymanız durumunda izin özelliğini içerir. 



- □ 

X 
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Use this space to summarize your privacy and cookie use policy. Learn More. 

Accept 


Welcome 



Learn about building Web apps vvith ASP.NET Core. 



© 2018 - RazorPagesMovie - Privacy 




Aşağıdaki görüntüde, izlemeye onay verdikten sonra uygulama gösterilmektedir: 
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Welcome 


Learn about building Web apps with ASP.NET Core. 


© 2018 - RazorPagesMovie - Privacy 



Proje dosyalarını inceleyin 

Aşağıda, daha sonraki öğreticilerde birlikte çalışacağımız ana proje klasörlerine ve dosyalarına genel bir bakış 
sunulmaktadır. 

Sayfalar klasörü 

Razor sayfaları ve destekleyici dosyalar içerir. Her Razor sayfası bir dosya çiftidir: 

• Razor söz dizimi kullanarak C# kodla HTM L işaretlemesi içeren bir. cshtml dosyası. 

• Sayfa olaylarını işleyen kodu içeren C# bir. cshtml.cs dosyası. 

Destekleyici dosyalar bir alt çizgiyle başlayan adlara sahiptir.Örneğin, _Layout. cshtml dosyası tüm sayfalarda ortak 
kullanıcı arabirimi öğelerini yapılandırır. Bu dosya sayfanın en üstündeki gezinti menüsünü ve sayfanın alt 
kısmındaki telif hakkı bildirimini ayarlar. Daha fazla bilgi için bkz. ASP.NET Core düzen. 

Wwwroot klasörü 

HTML dosyaları, JavaScript dosyaları ve CSS dosyaları gibi statik dosyaları içerir. Daha fazla bilgi için bkz. ASP.N ET 
Core statik dosyalar. 

appSettings. JSON 

Bağlantı dizeleri gibi yapılandırma verilerini içerir. Daha fazla bilgi için bkz. ASP.NET Core yapılandırma. 

Program.es 

Programın giriş noktasını içerir.Daha fazla bilgi için bkz. .NET genel ana bilgisayar. 

Startup.es 

Tanımlama bilgilerinin onayını gerektirip gerektirmediğini belirten uygulama davranışını yapılandıran kodu içerir. 
Daha fazla bilgi için bkz. ASP.NET Core 'de uygulama başlatma. 

Ek kaynaklar 

• Bu öğreticinin YouTube sürümü 

Sonraki adımlar 

Serideki bir sonraki öğreticiye ilerleyin: 




MODEL 

EKLEME 



Bir ASRNET Core Razor sayfaları uygulama için model 
ekleme 

10.12.2019 • 40 minutes to read • Edit Online 


Tarafından Rick Anderson 

Bu bölümde, platformlar arası bir SQLİte veritabanındafilm yönetimi için sınıflar eklenir. Bir ASP.NET Core 
şablondan oluşturulan uygulamalar bir SQLİte veritabanı kullanır. Uygulamanın model sınıfları, veritabanıyla 
çalışmak için Entity Framevvork Core (EF Core) (SQLite EF Core veritabanı sağlayıcısı) ile kullanılır. EF Core, veri 
erişimini kolaylaştıran bir nesne ilişkisel eşleme (ORM) çerçevesidir. 

EF Core üzerinde herhangi bir bağımlılığı olmadığından model sınıfları ("düz eski CLR nesnelerden") POCO 
sınıfları olarak bilinir. Bunlar, veritabanında depolanan verilerin özelliklerini tanımlayın. 

Örnek kodu görüntüle veya indir (indirme). 

Örnek kodu görüntüle veya indir (indirme). 

Bir veri modeli ekleme 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Sağ RazorPagesMovie Proje > Ekle > yeni klasör. Klasör adı modelleri. 

Sağ tıklayın modelleri klasör. Seçin ekleme > sınıfı. Sınıf adı film. 

Aşağıdaki özellikleri Movie sınıfına ekleyin: 

using System; 

using System.ComponentModel.DataAnnotations; 

namespace RazorPagesMovie.Models 
{ 

public class Movie 
{ 

public int ID { get; set; } 
public string Title { get; set; } 

[DataType(DataType.Date)] 
public DateTime ReleaseDate { get; set; } 
public string Genre { get; set; } 
public decimal Price { get; set; } 

} 

} 

Movie sınıfı şunları içerir: 

• id alanı birincil anahtar için veritabanı gerektirir. 

• [DataType(DataType.Date)] : DataType özniteliği verilerin türünü belirtir (Tarih). Bu öznitelikle: 

o Kullanıcının Tarih alanına saat bilgilerini girmesi gerekli değildir, 
o Zaman bilgisi değil yalnızca tarih görüntülenir. 







Veri açıklamaları sonraki bir öğreticide ele alınmıştır. 
Derleme hata doğrulamak için projeyi derleyin. 


Film modeli iskelesini 

Bu bölümde, film modeli iskele kurulmuş. Diğer bir deyişle, yapı iskelesi aracı sayfalan için oluşturma, okuma, 
güncelleştirme ve silme (CRUD) işlemlerine yönelik film modeli oluşturur. 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Oluşturma bir sayfalar L/filmler klasörü: 

• Yeni > klasör eklemek > Sayfalar klasörüne sağ tıklayın. 

• Klasör adı filmler 


Sayfalar/filmler klasörüne sağ 





Solution Explorer ^ X 

(ît nS - T © - flf " 

Search Solution Explorer (Ctrl+; P - 

Solution 'RazorPagesMovie2.2‘ (1 
* v“ RazorPagesMovie 

Connected Services 
Dependencies 

> Properties 

> s@ wwwroot 

> a ■ Models 
^ sİ Pages 


®"1 View in Browser (Google Chrome) 
y Task Runner Explorer 
Configure External Tools... 

Brovvse With... 


Movies 


Ctrl+Shift+W 


n 

Razor Page... 



Controller... 


*□ 

New Item... 

Ctrl+Shift+A 

+ a 

Existing Item... 

Shift+Alt+A 


New Scaffolded Item... 


* 

New Folder 



Container Orchestrator Support 



Docker Support 


& 

Client-Side Library... 



Class... 



& 

I? 

X 

o 

c* 


Ad d 

► 

Scope to This 


New Solution Explorer View 


View History... 

Exclude From Project 

Cut 

Ctrl+X 

Copy 

Ctrl+C 

Delete 

Del 

Rename 


Öpen Folder in File Explorer 

Properties 

Alt+Enter 


Yapı İskelesi Ekle iletişim kutusunda Razor Pages Entity Framevvork (crud) > Ekle' yi seçin. 











Tamamlamak ekleme Razor sayfaları (CRUD) Entity Framevvork kullanarak iletişim: 

• İçinde Model sınıfı seçin, açılan menü film (RazorPagesMovie.Models). 

• Veri bağlamı sınıfı satırında + (artı) işaretini seçin ve oluşturulan adı RazorPagesMovie 1 dan değiştirin. 
Modeller. RazorPagesMovieContext to RazorPagesMovie. Veri. RazorPagesMovieContext. Bu değişiklik gerekli 
değildir. Doğru ad alanıyla veritabanı bağlamı sınıfını oluşturur. 

• Add (Ekle) seçeneğini belirleyin. 


Add Razor Pages using Entity Framevvork (CRUD) 

Generates Razor Pages using Entity Framevvork for; Create, Delete, Details, Edit and üst operations for 
the selected model. 


X 


Model class: 

Data context class: 


Movie (RazorPagesMovie.Models) 


RazorPaaesMovie.[iEımRazorPaQesMovieContext 


Options: 

I I Create as a partial view 
0 Reference script libraries 
0 Use a layout page: 


(Leave empty if it is set in a Razor _viewstart file) 


Add 


Cancel 


Appsettings.jsorı dosya yerel bir veritabanına bağlanmak için kullanılan bağlantı dizesi ile güncelleştirilir. 

Oluşturulan dosyalar 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

iskele işlem oluşturur ve aşağıdaki dosyaları güncelleştirir: 














































• S ay fa/f Um ler: oluşturma, silme, Ayrıntılar, düzenleme ve dizin. 

• Data/RazorPagesMovieContext.cs 

Güncelleştirme tarihi 

• Startup.es 

Oluşturulan ve güncelleştirilen dosyalar, sonraki bölümde açıklanmıştır. 


İlk geçiş 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Bu bölümde, Paket Yöneticisi Konsolu (PMC'yi) için kullanılır: 

• Bir başlangıç geçiş ekleyin. 

• Veritabanı, ilk geçiş ile güncelleştirin. 


Araçlar menüsünde NuGet Paket Yöneticisi > Paket Yöneticisi konsolu 1 nu seçin. 


File 


MvcMovie - Microsoft Visual Studio 

Edit View Project Build Debug 

Team Tools 

E Extensions and Updates... 

T g Connectto Database... 


T “ Connectto Server... 


Add SQL Server... 


SQL Server 

► 

Web Code Analysis 

► 

D Code Snippets Manager... 

Ctrl+K, Ctrl+B 

Choose Toolbox Items... 

NuGet Package Manager 

► 


WCF Service Configuration Editör 
External Tools... 

Impoıt and Export Settings... 
Customize... 

Options... 


Test Analyze Window Help 
PU - ► IIS Express - - 



PMC'de aşağıdaki komutları girin: 

Add-Migration InitialCreate 
Update-Database 

Yukarıdaki komutlar şu uyarıyı oluşturur:Movie ' varlık türündeki 1 Price ' ondalık sütunu için tür belirtilmedi. Bu, 
varsayılan duyarlık ve ölçeğe uygun olmadıkları takdirde değerlerin sessizce kesilmesine neden olur. 1 
Hasccolumntype () 1 kullanarak tüm değerleri barındırabilecek SQL Server sütun türünü açık olarak belirtin." 

Bu uyarıyı yoksayabilirsiniz, daha sonraki bir öğreticide düzeltilecektir. 

Geçişler komutu, ilk veritabanı şemasını oluşturmak için kod üretir.Şema, DbContext belirtilen modeli temel alır. 
InitialCreate Bağımsız değişkeni, geçişlerin adlandırmak için kullanılır. Herhangi bir ad kullanılabilir, ancak bir adı 
seçili kural gereği, geçiş açıklar. 

update komutu uygulanmamış geçişlerde up yöntemini çalıştırır. Bu durumda update , veritabanını oluşturan 
geçiş/<zaman damgası > _lnitialCreate. cs dosyasında up yöntemini çalıştırır. 







• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Bağımlılık ekleme ile kayıtlı bağlamını İnceleme 

ASP.NET Core ile oluşturulmuş bağımlılık ekleme. Hizmetler (örneğin, EF Core DB bağlamı), uygulama başlatma 
sırasında bağımlılık ekleme ile kaydedilir. Bu hizmetler (örneğin, Razor sayfaları) gerektiren bileşenler bu hizmetler 
Oluşturucu parametresi üzerinden sağlanır. Bir DB bağlamı örneği alır Oluşturucu kodu öğreticinin ilerleyen 
bölümlerinde gösterilmektedir. 

Yapı iskelesi aracı otomatik olarak oluşturulmuş bir veritabanı bağlamını ve bağımlılık ekleme kapsayıcısını ile 
kayıtlı. 

inceleme startup.configureServices yöntemi. Vurgulanan satırı iskele kurucu tarafından eklendi: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRazorPages(); 

Services.AddDbContext<RazorPagesMovieContext>(options => 

options.UseSqlServer(Configuration.GetConnectionString("RazorPagesMovieContext"))); 

} 

RazorPagesMovieContext EF Core işlevleri (oluşturma, okuma, güncelleştirme, silme, vb.) için koordinatları Movie 
modeli. Veri bağlamı ( RazorPagesMovieContext ) türetilir Microsoft.EntityFrameworkCore.DbContext. Veri bağlamı, 
hangi varlıkları veri modelinde yer alan belirtir. 

using Microsoft.EntityFrameworkCore; 

namespace RazorPagesMovie.Models 
{ 

public class RazorPagesMovieContext : DbContext 
{ 

public RazorPagesMovieContext (DbContextOptions<RazorPagesMovieContext> options) 

: base(options) 

{ 

} 

public DbSet<RazorPagesMovie.Models.Movie> Movie { get; setj } 

} 

} 

Önceki kod, varlık kümesi için bir Dbset<filmi > özelliği oluşturur. Entity Framework terminolojisinde, bir varlık 
kümesini genellikle bir veritabanı tablosuna karşılık gelir. Bir varlık tablosunda bir satıra karşılık gelir. 

Bağlantı dizesi adı için bağlam üzerinde bir yöntemi çağırarak geçirilen bir DbContextOptions nesne. Yerel 
geliştirme için AS P.N ET Core yapılandırma sistemi bağlantı dizesinden okur appsettings.json dosya. 

Uygulamayı test etme 

• Uygulamayı çalıştırın ve ekleme /Movies tarayıcıda URL'sine ( http://iocaihost:port/movies ). 

Hatası alırsanız: 

SqlException: Cannot öpen database "RazorPagesMovieContext-GUID" requested by the login. The login failed. 
Login failed for user ’User-name’. 


Eksik geçişler adım. 







• Test Oluştur bağlantı. 



Sonraki öğreticiye yapı iskelesi tarafından oluşturulan dosyaları açıklar. 

Ek kaynaklar 


ÖNCEKİ: ■ SON RAKI: RAZOR SAYFALARI İÇİN İSKELE 

BAŞLAMA ■ KURULMUŞ 


Bu bölümde, platformlar arası bir SQLİte veritabanındafilm yönetimi için sınıflar eklenir. Bir ASP.NET Core 
şablondan oluşturulan uygulamalar bir SQLİte veritabanı kullanır. Uygulamanın model sınıfları, veritabanıyla 
çalışmak için Entity Framework Core (EF Core) (SQLİte EF Core veritabanı sağlayıcısı) ile kullanılır. EF Core, veri 
erişimini kolaylaştıran bir nesne ilişkisel eşleme (ORM) çerçevesidir. 

EF Core üzerinde herhangi bir bağımlılığı olmadığından model sınıfları ("düz eski CLR nesnelerden") POCO 
sınıfları olarak bilinir. Bunlar, veritabanında depolanan verilerin özelliklerini tanımlayın. 








Örnek kodu görüntüle veya indir (indirme). 
Örnek kodu görüntüle veya indir (indirme). 


Bir veri modeli ekleme 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Sağ RazorPagesMovie Proje > Ekle > yeni klasör. Klasör adı modelleri. 

Sağ tıklayın modelleri klasör. Seçin ekleme > sınıfı. Sınıf adı film. 

Aşağıdaki özellikleri Movie sınıfına ekleyin: 

using System; 

using System.ComponentModel.DataAnnotations; 

namespace RazorPagesMovie.Models 
{ 

public class Movie 
{ 

public int ID { get; set; } 
public string Title { get; set; } 

[DataType(DataType.Date)] 
public DateTime ReleaseDate { get; set; } 
public string Genre { get; set; } 
public decimal Price { get; set; } 

} 

} 

Movie sınıfı şunları içerir: 

• id alanı birincil anahtar için veritabanı gerektirir. 

• [DataType(DataType.Date)] : DataType özniteliği verilerin türünü belirtir (Tarih). Bu öznitelikle: 

o Kullanıcının Tarih alanına saat bilgilerini girmesi gerekli değildir, 
o Zaman bilgisi değil yalnızca tarih görüntülenir. 

Veri açıklamaları sonraki bir öğreticide ele alınmıştır. 

Derleme hata doğrulamak için projeyi derleyin. 

Film modeli iskelesini 

Bu bölümde, film modeli iskele kurulmuş. Diğer bir deyişle, yapı iskelesi aracı sayfaları için oluşturma, okuma, 
güncelleştirme ve silme (CRUD) işlemlerine yönelik film modeli oluşturur. 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Oluşturma bir sayfalar L/filmler klasörü: 

• Yeni > klasör eklemek > Sayfalar klasörüne sağ tıklayın. 

• Klasör adı filmler 






Sayfalar/filmler klasörüne sağ tıklayın > > yeni yapı İskelesi öğesi ekleyin . 
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View in Browser (Google Chrome) 
Task Runner Explorer 
Configure External Tools... 

Brovvse With... 


Movies 


Ctrl+Shift+W 


Razor Page 
Controller. 


*□ 

+ û 


New Item... 

Ctrl+Shift+A 

Existing Item... 

Shift+Alt+A 

New Scaffolded Item... 


New Folder 


Container Orchestrator Support 


Docker Support 


Client-Side Library... 


9 


Class... 



Add 

► 


Scope to This 


[f 

New Solution Explorer View 


© 

View History... 



Exclude From Project 


X 

Cut 

Ctrl+X 

& 

Copy 

Ctrl+C 

X 

Delete 

Del 

o 

Rename 


C* 

Öpen Folder in File Explorer 


P 

Properties 

Alt+Enter 


Yapı İskelesi Ekle iletişim kutusunda Razor Pages Entity Framevvork (crud) > Ekle' yi seçin. 


Add Scaffold X 

* Installed 

Razor Pages using Entity Framevvork 
(CRUD) 

by Microsoft 
vl .0.0.0 

Generates Razor Pages using Entity 
Framevvork for; Create, Delete, Details, Edit 
and List operations forthe given model. 

İd: Microsoft.AspNet.Scaffolding.Mvc.Mode 
IBasedCrudRazorPageScaffolder 


Common 

API 

t MVC 

Razor Pages 

İd entity 
Layout 


Razor Page 
@1 Razor Page using Entity Framevvork 




Razor Pages using Entity Framevvork (CRUD) 


Click hereto go online and find more scaffolding 

extensions. 


Add 

Cancel 



Tamamlamak ekleme Razor sayfaları (CRUD) Entity Framevvork kullanarak iletişim: 























• içinde Model sınıfı seçin, açılan menü film (RazorPagesMovie.Models). 

• içinde veri bağlamı sınıfının satır, select + (artı) oturum açın ve oluşturulan adı kabul 
RazorPagesMovie.Models.RazorPagesMovieContext. 

• Add (Ekle) seçeneğini belirleyin. 


Add Razor Pages using Entity Framework (CRUD) 


X 


Generates Razor Pages using Entity Framevvorkfor; Create, Delete, Details, Edit and List operationsforthe 
selected model. 

Model class: 

Data contect class: 

Options: 

Create as a partial view 
R1 Reference script libraries 
[71 Use a layout page: 

ı ı n 

(Leave empty if it is set in a Razor _viewstart file) 


Movie (RazorPagesMovie.Models) 


RazorPagesMovie.Models.RazorPagesMovieContext 


Add 


Cancel 


Appsettings.jsorı dosya yerel bir veritabanına bağlanmak için kullanılan bağlantı dizesi ile güncelleştirilir. 
İskele işlem oluşturur ve aşağıdaki dosyaları güncelleştirir: 

Oluşturulan dosyalar 

• Sayfa/filmler: oluşturma, silme, Ayrıntılar, düzenleme ve dizin. 

• Data/RazorPagesMovieContext.cs 

Dosya güncelleştirildi 

• Startup.es 

Oluşturulan ve güncelleştirilen dosyalar, sonraki bölümde açıklanmıştır. 

İlk geçiş 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Bu bölümde, Paket Yöneticisi Konsolu (PMC'yi) için kullanılır: 

• Bir başlangıç geçiş ekleyin. 

• Veritabanı, ilk geçiş ile güncelleştirin. 

Araçlar menüsünde NuGet Paket Yöneticisi > Paket Yöneticisi konsolu 1 nu seçin. 
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MvcMovie - Microsoft Visual Studio 


Edit View Project Build Debug 

Team Tools 

E 

Extensions and Updates... 


T e 

Connect to Database... 



Connect to Server... 



Add SQL Server... 



SQL Server 

► 


Web Code Analysis 

► 

n 

Code Snippets Manager... 

Ctrl-* *- K, Ctrl+B 


Choose Toolbox Items... 



NuGet Package Manager 

► 


WCF Service Configuration Editör 
External Tools... 

Import and Export Settings... 
Customize... 

Options... 


Analyze Window Help 
- ► IIS Express * 6 * 



PMC'de aşağıdaki komutları girin: 

Add-Migration Initial 
Update-Database 

Add-Migration Komut, ilk veritabanı şeması oluşturmak için kod oluşturur.Şema, DbContext belirtilen modele 
dayalıdır ( RazorPagesMovleContext.es dosyasında), initiaicreate bağımsız değişkeni, geçişi adlandırmak için 
kullanılır. Herhangi bir ad kullanılabilir, ancak kurala göre geçiş tanımlayan bir ad kullanılır.Daha fazla bilgi için bkz. 
Öğretici: EF Core ile geçiş özelliğini kullanma-ASP.NET MVC. 

update-Database Komutu çalıştırmaları up yönteminde geçişleri/<zaman damgası > _lnitialCreate.cs dosya, up 
Yöntemi veritabanı oluşturur. 


NOTE 

Yukarıdaki komutlar şu uyarıyı oluşturur:" ' Movie ' varlık türündeki ' Price ' ondalık sütunu için tür belirtilmedi. Bu, 
varsayılan duyarlık ve ölçeğe uygun olmadıkları takdirde değerlerin sessizce kesilmesine neden olur. ' Hasccolumntype 0 ' 
kullanarak tüm değerleri barındırabilecek SQL Server sütun türünü açık olarak belirtin. " Bu uyarıyı yoksayabilirsiniz, daha 
sonraki bir öğreticide düzeltilecektir. 


• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Bağımlılık ekleme ile kayıtlı bağlamını İnceleme 

ASP.NET Core ile oluşturulmuş bağımlılık ekleme. Hizmetler (örneğin, EF Core DB bağlamı), uygulama başlatma 
sırasında bağımlılık ekleme ile kaydedilir. Bu hizmetler (örneğin, Razor sayfaları) gerektiren bileşenler bu hizmetler 
Oluşturucu parametresi üzerinden sağlanır. Bir DB bağlamı örneği alır Oluşturucu kodu öğreticinin ilerleyen 
bölümlerinde gösterilmektedir. 

Yapı iskelesi aracı otomatik olarak oluşturulmuş bir veritabanı bağlamını ve bağımlılık ekleme kapsayıcısını ile 
kayıtlı. 

inceleme startup.configureServices yöntemi. Vurgulanan satırı iskele kurucu tarafından eklendi: 






// This method gets called by the runtime. 

// Use this method to add Services to the Container, 
public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

// This lambda determines whether user consent for non-essential cookies is 
// needed for a given request. 
options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.Nonej 

}); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

Services.AddDbContext<RazorPagesMovieContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("RazorPagesMovieContext"))); 

} 

RazorPagesMovieContext EF Core işlevleri (oluşturma, okuma, güncelleştirme, silme, vb.) için koordinatları Movie 
modeli. Veri bağlamı ( RazorPagesMovieContext ) türetilir Microsoft.EntityFrameworkCore.DbContext. Veri bağlamı, 
hangi varlıkları veri modelinde yer alan belirtir. 

using Microsoft.EntityFrameworkCore; 

namespace RazorPagesMovie.Models 

{ 

public class RazorPagesMovieContext : DbContext 

{ 

public RazorPagesMovieContext (DbContextOptions<RazorPagesMovieContext> options) 

: base(options) 

{ 

} 

public DbSet<RazorPagesMovie.Models.Movie> Movie { get; setj } 

} 

} 

Önceki kod, varlık kümesi için bir Dbset<filmi > özelliği oluşturur. Entity Framework terminolojisinde, bir varlık 
kümesini genellikle bir veritabanı tablosuna karşılık gelir. Bir varlık tablosunda bir satıra karşılık gelir. 

Bağlantı dizesi adı için bağlam üzerinde bir yöntemi çağırarak geçirilen bir DbContextOptions nesne. Yerel 
geliştirme için AS P.N ET Core yapılandırma sistemi bağlantı dizesinden okur appsettings.jsorı dosya. 

Uygulamayı test etme 

• Uygulamayı çalıştırın ve ekleme /Movies tarayıcıda URL'sine ( http://iocaihost:port/movies ). 

Hatası alırsanız: 


SqlException: Cannot öpen database "RazorPagesMovieContext-GUID" requested by the login. The login failed. 
Login failed for user ’User-name'. 


Eksik geçişler adım. 


• Test Oluştur bağlantı. 






I Create - RazorPagesMovie 


C A https://localhost:5001/Movies/Create ğ : 

RazorPagesMovie 


Create 

Movie 

Title 

The Good. the bad, and the ugly 

ReleaseDate 

11/30/2018 

Genre 

VVestern 

Price 

1.19 


Create 


Back to List 

© 2019 - RazorPagesMovie - Privacy 

w 

NOTE 

Ondalık virgül kullanımı girmeniz mümkün olmayabilir Price alan. Desteklemek için jQuery doğrulama virgül İngilizce 
olmayan yerel bir ondalık noktasının ve ABD İngilizce olmayan tarih biçimleri, uygulamayı Eğer gerekir. 
Genelleştirme hakkında yönergeler için bkz. bu GitHub sorunu. 


• Test Düzenle, ayrıntıları, ve Sil bağlantıları. 

Sonraki öğreticiye yapı iskelesi tarafından oluşturulan dosyalan açıklar. 

Ek kaynaklar 
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ASPNET Core Razor Pages scafkatlama 

23.11.2019 * 25 minutes to read ı Edit Online 


Tarafından RickAnderson 

Bu öğreticide, önceki öğreticidescafkatlama tarafından oluşturulan Razor Pages incelenir. 

Örnek kodu görüntüle veya indir (indirme). 

Örnek kodu görüntüle veya indir (indirme). 

Oluşturma, silme, Ayrıntılar ve düzenleme sayfaları 

Pages/filmler/lndex. cshtml. cs sayfa modelini inceleyin: 

// Unused usings removed. 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using Microsoft.EntityFrameworkCore; 

using RazorPagesMovie.Models; 

using System.Collections.Generic; 

using System.Threading.Tasks; 

namespace RazorPagesMovie.Pages.Movies 

{ 

public class IndexModel : PageModel 

{ 

private readonly RazorPagesMovie.Data.RazorPagesMovieContext _context; 

public IndexModel(RazorPagesMovie.Data.RazorPagesMovieContext context) 

{ 

_context = context; 

} 

public IList<Movie> Movie { get;set; } 

public async Task OnGetAsync() 

{ 

Movie = await _context.Movie.ToListAsync(); 

} 

} 

} 

RazorPages PageModel türetilir. Kurala göre PageModel türetilmiş sınıf <PageName>Modei olarak adlandırılır. 
Oluşturucu, RazorPagesMovieContext sayfaya eklemek için bağımlılık ekleme işlemini kullanır. Tüm yapı iskelesi 
sayfaları bu düzene uyar. Entity Framevvork zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. zaman 
uyumsuz kod . 

Sayfa için bir istek yapıldığında onGetAsync yöntemi, Razor sayfasına bir film listesi döndürür. onGetAsync veya 
onGet , sayfanın durumunu başlatmak için çağırılır. Bu durumda, OnGetAsync film listesini alır ve görüntüler. 

onGet void döndürdüğünde veya OnGetAsync" Task döndürürse, hiçbir dönüş açıklaması kullanılmaz. Dönüş türü 
iActionResuit veya Task<iActionResuit> olduğunda, return ifadesinin sağlanması gerekir. Örneğin, 
Pages/filmler/Create. cshtml. cs onPostAsync yöntemi: 














public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_context.Movie.Add(Movie); 
await _context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 

} 

Pages/filmler/lndex. cshtml Razor sayfasını inceleyin: 



@page 

@model RazorPagesMovie.Pages.Movies.IndexModel 

@{ 

ViewData["Title"] = "Index"; 

} 

<hl>Index</hl> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

ctable class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model = > model.Movie[0].Title) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movie[0].ReleaseDate) 
</th> 

<th> 

@Html.DisplayNameFor(model = > model.Movie[0].Genre) 

</th> 

<th> 

@Html.DisplayNameFor(model = > model.Movie[0].Price) 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model.Movie) { 

<tr> 

<td> 

@Html.DisplayFor(modelItem => İtem.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.ReleaseDate) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Genre) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Price) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID">Details</a> | 

<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 


Razor, HTM L 'den C# ya da Razor 'e özgü biçimlendirmeye geçiş yapabilir. Bir § sembol sonrasında Razor 
ayrılmış bir anahtar sözcükolduğunda, bu,' a geçiş yapar C#. 

@page yönergesi 

@page Razor yönergesi, dosyayı bir MVC eylemi yapar, bu da istekleri işleyebileceği anlamına gelir. @page 
sayfadaki ilk Razor yönergesi olmalıdır. @page , Razor 'e özgü biçimlendirmeye geçme örneğidir. Daha fazla bilgi 
için bkz. Razor söz dizimi. 


Aşağıdaki HTML Yardımcısı 'nda kullanılan lambda ifadesini inceleyin: 






@Html.DisplayNameFor(model => model.Movie[0].Title) 

DisplayNameFor HTML Yardımcısı, görünen adı belirlemede lambda ifadesinde başvurulan Title özelliğini inceler. 
Lambda ifadesi değerlendirilmek yerine incelenir. Bu, model, model.Movie veya model.Movie[0] nuiı veya boş 
olduğunda herhangi bir erişim ihlali olmadığı anlamına gelir. Lambda ifadesi değerlendirildiğinde (örneğin, 
@Htmi.DispiayFor(modeiıtem => item.Title) ), modelin özellik değerleri değerlendirilir. 

@model yönergesi 

@page 

@model RazorPagesMovie.Pages.Movies.IndexModel 

@modei yönergesi, Razor sayfasına geçirilen modelin türünü belirtir. Yukarıdaki örnekte @modei satırı, PageModei 
türetilmiş sınıfı Razor sayfası için kullanılabilir hale getirir. Model, @Htmi.DisplayNameFor ve sayfadaki HTML 
yardımcılarını @Htmi.DispiayFor kullanılır. 

Düzen sayfası 

Menü bağlantılarını (RazorPagesMovie, Homeve Gizlilik) seçin. Her sayfada aynı menü düzeni gösterilir.Menü 
düzeni sayfa/paylaşılan/_Layout. cshtml dosyasında uygulanır. Pages/Shared/_Layout. cshtml dosyasını açın. 

Düzen ŞABLONLARI, HTML kapsayıcı düzeninin şu şekilde olmasını sağlar: 

• Tek bir yerde belirtildi. 

• Sitede birden çok sayfada uygulandı. 

@RenderBody() satırını bulun. RenderBody , tüm sayfaya özgü görünümlerin, Düzen sayfasında kaydırılan bir yer 
tutucudur. Örneğin, Gizlilik bağlantısını seçin ve Sayfalar/gizlilik, cshtml görünümü RenderBody yöntemi içinde 
işlenir. 

VievvData ve Layout 

Pages/filmler/lndex. cshtml dosyasından aşağıdaki biçimlendirmeyi göz önünde bulundurun: 

@page 

@model RazorPagesMovie.Pages.Movies.IndexModel 
@{ 

ViewData["Title"] = "Index"; 

} 

Önceki vurgulanan biçimlendirme, Razor geçişi örneği olan bir örnektir C#. { ve } karakterler bir C# kod 
bloğunu kapsar. 

PageModei temel sınıfı, verileri bir görünüme geçirmek için kullanılabilen bir viewData Dictionary özelliği içerir. 
Nesneler, anahtar/değer düzeniyle viewData sözlüğüne eklenir. Yukarıdaki örnekte, "Title" özelliği viewData 
sözlüğüne eklenir. 

"Title" özelliği sayfa/paylaşılan/_Layout. cshtml dosyasında kullanılır. Aşağıdaki biçimlendirme_Loyouf. cshtml 
dosyasının ilk birkaç satırını gösterir. 

























açıklamaları istemciye gönderilmez. 

Düzeni güncelleştirme 

Pages/Shared/_Layout. cshtml dosyasındaki 
şekilde değiştirin. 

<IDOCTYPE html> 

<html lang="en"> 

<head> 

<meta charset="utf-8" /> 

<meta name="viewport" content="width=device-width 3 initial-scale=1.0" /> 
<title>@ViewData["Title"] - Movie</title> 


<titie> öğesini RazorPagesMovieyerine filmi görüntüleyecek 


Sayfa/paylaşılan/_Layout. cshtml dosyasında aşağıdaki tutturucu öğeyi bulun. 

<a class="navbar-brand" asp-area="" asp-page="/Index">RazorPagesMovie</a> 

Önceki öğeyi aşağıdaki biçimlendirmeyle değiştirin: 

<a class="navbar-brand" asp-page="/Movies/Index">RpMovie</a> 

Önceki tutturucu öğesi bir etiket yardımcıdır. Bu durumda, bağlantı etiketi yardımcısınınolması gerekir. 
asp-page="/Movies/index" Tag Helper özniteliği ve değeri, /Movies/index Razor sayfasına bir bağlantı oluşturur, 
asp-area öznitelik değeri boş olduğundan, alan bağlantıda kullanılmaz. Daha fazla bilgi için bkz. alanlara bakın. 

Değişikliklerinizi kaydedin ve Rpmovie bağlantısına tıklayarak uygulamayı test edin. Herhangi bir sorununuz varsa 
GitHub ’daki _Layout. cshtml dosyasına bakın. 

Diğer bağlantıları test edin (giriş, rpmovie, oluşturma, düzenlemeve silme). Her sayfada, tarayıcı sekmesinde 
görebileceğiniz başlık ayarlanır. Bir sayfada yer işareti eklediğinizde başlık, yer işareti için kullanılır. 


NOTE 

Ondalık virgül kullanımı girmeniz mümkün olmayabilir Price alan. Ondalık bir nokta ve ABD İngilizcesi olmayan tarih 
biçimleri için virgül (",") kullanan İngilizce olmayan yerel ayarlarda jOuery doğrulamasını desteklemek için, uygulamanızı 
globalize için adımlar uygulamanız gerekir. Ondalık virgülden ekleme hakkında yönergeler için bkz. GitHub sorunu 4076 


Layout özelliği Pages/_ViewStart. cshtml dosyasında ayarlanır: 

Layout = "_Layout"; 

} 


Yukarıdaki biçimlendirme düzen dosyasını Sayfalar klasörü altındaki tüm Razor dosyaları için 











Sayfalar/paylaşdan/_Layout. cshtml olarak ayarlar. Daha fazla bilgi için bkz. Düzen . 


Sayfa oluştur modeli 

Pages/fdmler/Create. cshtml. cs sayfa modelini inceleyin: 


using Microsoft.AspNetCore.Mvc; 
using Microsoft .AspNetCore.Mvc. RazorPages; 
using RazorPagesMovie.Models; 
using System; 

using System.Threading.Tasks; 

namespace RazorPagesMovie.Pages.Movies 

{ 

public class CreateModel : PageModel 

{ 

private readonly RazorPagesMovie.Data.RazorPagesMovieContext _context; 

public CreateModel(RazorPagesMovie.Data.RazorPagesMovieContext context) 

{ 

_context = context; 

} 

public IActionResult OnGet() 

{ 

return Page(); 

} 

[BindProperty] 

public Movie Movie { get; set; } 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_cont ext. Movie. Add( Movie); 
await _context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 

} 

} 


onGet yöntemi, sayfa için gereken tüm durumları başlatır. Oluşturma sayfasında başlatılacak durum yok, bu 
nedenle Page döndürülür. Öğreticide daha sonra, OnGet başlatma durumuna bir örnek gösterilir. Page yöntemi 
Create. cshtml sayfasını işleyen bir PageResuit nesnesi oluşturur. 

Movie özelliği, model bağlamayıkabul etmek için [BindProperty] özniteliğini kullanır. Oluşturma formu form 
değerlerini gönderirse, ASP.NET Core çalışma zamanı, postalanan değerleri Movie modeline bağlar. 

onPostAsync yöntemi, sayfa form verileri gönderdiğinde çalıştırılır: 











public async Task<IActionResult> OnPostAsync() 

{ 

if (ÎModelState.IsValid) 

{ 

return Page(); 

} 

_context.Movie.Add(Movie); 
await _context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 

Herhangi bir model hatası varsa, form, gönderilen tüm form verileriyle birlikte yeniden görüntülenir. Form 
gönderilmeden önce çoğu model hatası istemci tarafında yakalanabilir. Bir model hatasına bir örnek, Date alanı için 
bir tarihe dönüştürülemeyen bir değer gönderme, istemci tarafı doğrulama ve model doğrulaması Öğreticinin 
ilerleyen kısımlarında ele alınmıştır. 

Model hatası yoksa, veriler kaydedilir ve tarayıcı dizin sayfasına yönlendirilir. 

Razor Oluştur sayfası 

Pages/filmler/Create. cshtml Razor sayfa dosyasını inceleyin: 




@page 

@model RazorPagesMovie.Pages.Movies.CreateModel 

@{ 

ViewData["Title"] = "Create"; 

} 

<hl>Create</hl> 

<h4>Movie</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form m8thod="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<div class="form-group"> 

<label asp-for="Movie.Title" class="control-label"x/label> 

<input asp-for="Movie.Title" class="form-control" /> 

<span asp-validation-for="Movie.Title" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Movie.ReleaseDate" class="control-label"x/label> 
cinput asp-for="Movie.ReleaseDate" class="form-control" /> 

<span asp-validation-fon="Movie.ReleaseDate" class="text-danger"x/span> 
</div> 

<div class="form-group"> 

dabel asp-for="Movie.Genre" class="control-label"x/label> 

<input asp-fon="Movie.Genne" class="form-control" /> 

<span asp-validation-fon="Movie.Genre" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Movie.Pnice" class="control-label"x/label> 

<input asp-fon="Movie.Pnice" class="form-control" /> 

<span asp-validation-for="Movie. Pnlce" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<input type="submit" value="Create" class="btn btn-primary" /> 

</div> 

</form> 

</div> 

</div> 

<div> 

<a asp-page="Index">Back to List</a> 

</div> 

@section Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 


• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Visual Studio, etiket yardımcıları için kullanılan farklı kalın yazı tipiyle aşağıdaki etiketleri görüntüler: 

• <form method="post"> 

• <div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

• dabel asp-for="Movie.Title" class="control-label"x/label> 

• dnput asp-for="Movie.Title" class="form-control" /> 

• <span asp-validation-for="Movie.Title" class="text-danger"x/span> 
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Create.cshtml -o X 

IŞpage 

@model RazorPagesMovie.Pages.Movi.es .CreateModel 


@{ 


ViewData["Title"] = "Create"; 


100 % 


<hl>Create</hl> 

Ch4>Movie</h4> 

<hr /> 

<div class=' , row"> 

<div class="col-md-4”> 

<form method="post"> 

<div asp-validation-summary= "ModelOnly" class="text-danger"x/div> 

<div class="form-group"> 

<label asp-for="Movie.Title" class="control-label"x/label> 

<input asp-for="Movie.Title" class="form-control M /> 

<span asp-validation-for="Movie.Title" class="text-danger"x/span> 
</div> 

<div class=”form-group"> 

<label asp-for="Movie.ReleaseDate" class="control-label M x/label> 
<input asp-for="Movie.ReleaseDate" class="form-control" /> 

<span asp-validation-for="Movie.ReleaseDate" class="text-danger">< 
</div> 

<div class="form-group"> 

<label asp-for="Movie.Genre" class=''control-label M x/label> 

<input asp-for="Movie.Genre“ class="form-control" /> 

<span asp-validation-for="Movie.Genre" class="text-danger"x/span> 
</div> 

i 


O No issues found 


<form method="post"> öğesi bir form etiketi yardımcıdır. Form etiketi Yardımcısı, bir antiforgery belirteciniotomatik 
olarak içerir. 

Yapı iskelesi altyapısı, modeldeki her alan için (KİMLİK hariç), aşağıdakine benzer Razor biçimlendirmesi oluşturur: 

<div asp-validation-summary= "ModelOnly" class="text-danger"x/div> 

<div class="form-group"> 

clabel asp-for="Movie.Title" class="contnol-label"x/label> 

<input asp-for="Movie.Title" class="form-control" /> 

<span asp-validation-fon="Movie.Title" class="text-danger"x/span> 

</div> 

Doğrulama etiketi yardımcıları ( <div asp-vaiidation-summany ve <span asp-vaiidation-for ) doğrulama hatalarını 
görüntüler. Doğrulama, bu serinin ilerleyen kısımlarında daha ayrıntılı bir şekilde ele alınmıştır. 

Etiket etiketi Yardımcısı ( 

başlığını ve for özniteliğini oluşturur. 

Giriş etiketi Yardımcısı ( cinput asp-for="Movie.ntie" ciass="form-controi"> ), dataaçıklamaların özniteliklerini 
kullanır ve istemci tarafında jQuery doğrulaması için gerekli HTML özniteliklerini üretir. 

<form method="post"> gibi etiket yardımcıları hakkında daha fazla bilgi için bkz. ASP.NET Core etiket yardımcıları. 

Ek kaynaklar 


clabel asp-for="Movie.Title" class="control-label"x/label> ), Title Özelliği için etiket 
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VERITABAN I 



















Tarafından Rick Anderson 


Bu öğreticide, önceki öğreticidescafkatlama tarafından oluşturulan Razor Pages incelenir. 

Görüntüleme veya indirme örnek. 

Oluşturma, silme, Ayrıntılar ve düzenleme sayfaları 

Pages/filmler/lndex. cshtml. cs sayfa modelini inceleyin: 

using System; 

using System.Collections.Generic; 

using System.Linq; 

using System.Thneading.Tasks; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using Microsoft.EntityFrameworkCore; 

using RazorPagesMovie.Models; 

namespace RazorPagesMovie.Pages.Movies 

{ 

public class IndexModel : PageModel 

{ 

private readonly RazorPagesMovie.Models.RazorPagesMovieContext _context; 

public IndexModel(RazorPagesMovie.Models.RazorPagesMovieContext context) 

{ 

_context = context; 

} 

public IList<Movie> Movie { get;set; } 

public async Task OnGetAsync() 

{ 

Movie = await _context.Movie.ToListAsync(); 

} 

} 

} 

RazorPages PageModel türetilir. Kurala göre PageModel türetilmiş sınıf <PageName>Modei olarak adlandırılır. 
Oluşturucu, RazorPagesMovieContext sayfaya eklemek için bağımlılık ekleme işlemini kullanır. Tüm yapı iskelesi 
sayfaları bu düzene uyar. Entity Framevvork zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. zaman 
uyumsuz kod . 

Sayfa için bir istek yapıldığında onGetAsync yöntemi, Razor sayfasına bir film listesi döndürür. onGetAsync veya 
onGet bir Razor sayfasında, sayfanın durumunu başlatmak için çağrılır. Bu durumda, OnGetAsync film listesini alır 
ve görüntüler. 

OnGet void döndürdüğünde veya OnGetAsync" Task döndürürse, hiçbir dönüş yöntemi kullanılmaz. Dönüş türü 
iActionResuit veya Task<iActionResuit> olduğunda, return ifadesinin sağlanması gerekir. Örneğin, 
Pages/filmler/Create. cshtml. cs onPostAsync yöntemi: 












public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_context.Movie.Add(Movie); 
await _context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 

Pages/filmler/lndex. cshtml Razor sayfasını inceleyin: 



@page 

@model RazorPagesMovie.Pages.Movies.IndexModel 

@{ 

ViewData["Title"] = "Index"; 

} 

<hl>Index</hl> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

ctable class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model = > model.Movie[0].Title) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movie[0].ReleaseDate) 
</th> 

<th> 

@Html.DisplayNameFor(model = > model.Movie[0].Genre) 

</th> 

<th> 

@Html.DisplayNameFor(model = > model.Movie[0].Price) 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model.Movie) { 

<tr> 

<td> 

@Html.DisplayFor(modelItem => İtem.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.ReleaseDate) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Genre) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Price) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID">Details</a> | 

<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 


Razor, HTM L 'den C# ya da Razor 'e özgü biçimlendirmeye geçiş yapabilir. Bir § sembol sonrasında Razor 
ayrılmış bir anahtar sözcükolduğunda, bu,' a geçiş yapar C#. 

@page Razor yönergesi, dosyayı bir MVC eylemine dönüştürür, bu da istekleri işleyebileceği anlamına gelir. @page 
sayfadaki ilk Razor yönergesi olmalıdır. @page , Razor 'e özgü biçimlendirmeye geçme örneğidir. Daha fazla bilgi 
için bkz. Razor söz dizimi . 


Aşağıdaki HTML Yardımcısı 'nda kullanılan lambda ifadesini inceleyin: 






@Html.DisplayNameFor(model => model.Movie[0].Title) 

DisplayNameFor HTML Yardımcısı, görünen adı belirlemede lambda ifadesinde başvurulan Title özelliğini inceler. 
Lambda ifadesi değerlendirilmek yerine incelenir. Bu, model, model.Movie veya model.Movie[0] nuiı veya boş 
olduğunda herhangi bir erişim ihlali olmadığı anlamına gelir. Lambda ifadesi değerlendirildiğinde (örneğin, 
@Htmi.DispiayFor(modeiıtem => item.Title) ), modelin özellik değerleri değerlendirilir. 

@model yönergesi 

@page 

@model RazorPagesMovie.Pages.Movies.IndexModel 

@modei yönergesi, Razor sayfasına geçirilen modelin türünü belirtir. Yukarıdaki örnekte @modei satırı, PageModei 
türetilmiş sınıfı Razor sayfası için kullanılabilir hale getirir. Model, @Htmi.DisplayNameFor ve sayfadaki HTML 
yardımcılarını @Htmi.DispiayFor kullanılır. 

Düzen sayfası 

Menü bağlantılarını (RazorPagesMovie, Homeve Gizlilik) seçin. Her sayfada aynı menü düzeni gösterilir.Menü 
düzeni sayfa/paylaşdan/_Layout. cshtml dosyasında uygulanır. Pages/Shared/_Layout. cshtmi dosyasını açın. 

Düzen şablonları, sitenizin HTML kapsayıcı yerleşimini tek bir yerde belirtmenize ve sonra sitenizdeki birden çok 
sayfaya uygulamanıza olanak tanır. @RenderBody() satırını bulun. RenderBody , oluşturduğunuz tüm sayfaya özgü 
görünümlerin, Düzen sayfasında kaydLrdarı bir yer tutucudur. Örneğin, Gizlilik bağlantısını seçerseniz, 
Sayfa/Gizlilik, cshtml görünümü RenderBody yöntemi içinde işlenir. 

VievvData ve Layout 

Pages/fdmler/lndex. cshtml dosyasından aşağıdaki kodu göz önünde bulundurun: 

@page 

@model RazorPagesMovie.Pages.Movies.IndexModel 
@{ 

ViewData["Title"] = "Index"; 

} 

Önceki vurgulanan kod, Razor geçişi örneği olan bir örnektir C#. { ve } karakterler bir C# kod bloğunu kapsar. 

PageModei temel sınıfında, bir görünüme geçirmek istediğiniz verileri eklemek için kullanılabilecek bir viewData 
Dictionary özelliği vardır. Bir anahtar/değer düzeniyle viewData sözlüğüne nesne eklersiniz. Yukarıdaki örnekte, 
"title" özelliği viewData sözlüğüne eklenir. 

"Title" özelliği sayfa/paylaşdan/_Layout. cshtml dosyasında kullanılır. Aşağıdaki biçimlendirme_Loyouf. cshtml 
dosyasının ilk birkaç satırını gösterir. 

<!DOCTYPE html> 

<html> 

<head> 

<meta charset="utf-8" /> 

<meta name="viewport" content="width=device-width, initial-scale=1.0" /> 

<title>@ViewData["Title"] - RazorPagesMovie</title> 

@*Markup removed for brevity.*@ 

Satır @*Markup removed for brevity.*@ , düzen dosyanızda görünmeyen bir Razor açıklamadır.HTML yorumlarının ( 
<!-- --> ) aksine, Razor açıklamaları istemciye gönderilmez. 

























Düzeni güncelleştirme 

Pages/Shared/_Layout. cshtml dosyasındaki <titie> öğesini RazorPagesMovieyerine filmi görüntüleyecek 
şekilde değiştirin. 

<!DOCTYPE html> 

<html> 

<head> 

<meta charset="utf-8" /> 

<meta name="viewport" content="width=device-width, initial-scale=1.0" /> 

<title>@ViewData["Title"] - Movie</title> 

Sayfa/paylaşdan/_Layout. cshtml dosyasında aşağıdaki tutturucu öğeyi bulun. 

<a class="navbar-brand" asp-area="" asp-page="/Index">RazorPagesMovie</a> 

Önceki öğeyi aşağıdaki biçimlendirme ile değiştirin. 

<a class="navbar-brand" asp-page="/Movies/Index">RpMovie</a> 

Önceki tutturucu öğesi bir etiket yardımcıdır. Bu durumda, bağlantı etiketi yardımcısınınolması gerekir. 
asp-page="/Movies/index" Tag Helper özniteliği ve değeri, /Movies/index Razor sayfasına bir bağlantı oluşturur, 
asp-area öznitelik değeri boş olduğundan, alan bağlantıda kullanılmaz. Daha fazla bilgi için bkz. alanlara bakın. 

Değişikliklerinizi kaydedin ve Rpmovie bağlantısına tıklayarak uygulamayı test edin. Herhangi bir sorununuz varsa 
GitHub 'daki _Layout. cshtml dosyasına bakın. 

Diğer bağlantıları test edin (giriş, rpmovie, oluşturma, düzenlemeve silme). Her sayfada, tarayıcı sekmesinde 
görebileceğiniz başlık ayarlanır. Bir sayfada yer işareti eklediğinizde başlık, yer işareti için kullanılır. 


NOTE 

Ondalık virgül kullanımı girmeniz mümkün olmayabilir Price alan. Ondalık bir nokta ve ABD İngilizcesi olmayan tarih 
biçimleri için virgül (",") kullanan İngilizce olmayan yerel ayarlarda jOuery doğrulamasını desteklemek için, uygulamanızı 
globalize için adımlar uygulamanız gerekir. Bu GitHub, ondalık virgülden ekleme hakkında yönergeler için 4076 sorun . 


Layout özelliği Pages/_ViewStart. cshtml dosyasında ayarlanır: 

@{ 

Layout = "_Layout"; 

} 

Yukarıdaki biçimlendirme düzen dosyasını Sayfalar klasörü altındaki tüm Razor dosyaları için 
Sayfalar/paylaşdan/_Layout. cshtml olarak ayarlar. Daha fazla bilgi için bkz. Düzen . 

Sayfa oluştur modeli 

Pages/filmler/Create. cshtml. cs sayfa modelini inceleyin: 








// Unused usings removed. 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using RazorPagesMovie.Models; 

using System; 

using System.Threading.Tasks; 

namespace RazorPagesMovie.Pages.Movies 

{ 

public class CreateModel : PageModel 

{ 

private readonly RazorPagesMovie.Models.RazorPagesMovieContext _context; 

public CreateModel(RazorPagesMovie.Models.RazorPagesMovieContext context) 

{ 

_context = context; 

} 

public IActionResult OnGet() 

{ 

return Page(); 

} 

[BindProperty] 

public Movie Movie { get; set; } 

public async Task<IActionResult> OnPostAsync() 

{ 

if (ÎModelState.IsValid) 

{ 

return Page(); 

} 

_cont ext. Movie. Add( Movie); 
await _context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 

} 

} 


onGet yöntemi, sayfa için gereken tüm durumları başlatır. Oluşturma sayfasında başlatılacak durum yok, bu 
nedenle Page döndürülür. Öğreticide daha sonra OnGet yöntemi başlatma durumunu görürsünüz. Page yöntemi 
Create. cshtml sayfasını işleyen bir PageResuit nesnesi oluşturur. 

Movie özelliği, model bağlamayıkabul etmek için [BindProperty] özniteliğini kullanır. Oluşturma formu form 
değerlerini gönderirse, ASP.NET Core çalışma zamanı, postalanan değerleri Movie modeline bağlar. 

onPostAsync yöntemi, sayfa form verileri gönderdiğinde çalıştırılır: 

public async Task<IActionResult> OnPostAsync() 

{ 

if (ÎModelState.IsValid) 

{ 

return Page(); 

} 

_context.Movie.Add(Movie); 
await _context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 










Herhangi bir model hatası varsa, form, gönderilen tüm form verileriyle birlikte yeniden görüntülenir. Form 
gönderilmeden önce çoğu model hatası istemci tarafında yakalanabilir. Bir model hatasına bir örnek, Date alanı için 
bir tarihe dönüştürülemeyen bir değer gönderme, istemci tarafı doğrulama ve model doğrulaması Öğreticinin 
ilerleyen kısımlarında ele alınmıştır. 

Model hatası yoksa, veriler kaydedilir ve tarayıcı dizin sayfasına yönlendirilir. 

Razor Oluştur sayfası 

Pages/filmler/Create. cshtml Razor sayfa dosyasını inceleyin: 

@page 

@model RazorPagesMovie.Pages.Movies.CreateModel 

@{ 

ViewData["Title"] = "Create"; 

} 

<hl>Create</hl> 

<h4>Movie</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<div class="form-group"> 

<label asp-for="Movie.Title" class="control-label"x/label> 

<input asp-for="Movie.Title" class="form-control" /> 

<span asp-validation-for="Movie.Title" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Movie.ReleaseDate" class="control-label"x/label> 

<input asp-for="Movie.ReleaseDate" class="form-control" /> 

<span asp-validation-for="Movie.ReleaseDate" class="text-danger'"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Movie.Gerine" class="control-label"x/label> 

<input asp-for="Movie.Genre" class="form-contnol" /> 

<span asp-validation-fon="Movie.Genre" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Movie.Price" class="contnol-label"x/label> 

<input asp-for="Movie.Price" class="form-control" /> 

<span asp-validation-fon="Movie.Price" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<input type="submit" value="Create" class="btn btn-primary" /> 

</div> 

</form> 

</div> 

</div> 

<div> 

<a asp-page="Index">Back to List</a> 

</div> 

@section Scripts { 

@{await Html.RenderPantialAsync("_ValldationScriptsPartial");} 

} 


• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 




Visual Studio, etiket yardımcıları için kullanılan farklı kalın yazı tipiyle <form method="post"> etiketini görüntüler: 


Create.cshtml.es 
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_ Create.cshtml -P X | 

@page 

@model RazorPagesMovie. Pages_Movie. Create' : del 




ViewData["Title"] = "Cr-eate"; 


<h2>Create</h2> 

<h4 >Movie</h4> 

<hr /> 

B<div class="row"> 

S <div class=”col-md-4”> 

B <forn method="post"> 


B 


B 


The form element represents a collection of form-associated elements, some of which can represent editable 
values that can be submitted to a server for processing. 

Learn more (Fi) 


Microsoft.AspNetCore.Mvc.TagHelpers.FormTagHelper 
Microsoft.AspNetCore.Razor.TagHelpers. ’agHelpe implementation targeting <form> elements. 


<span asp-validation-for="Movie.ReleaseDate" class="text-danger" 
</div> 

<div class="for-m-group"> 

<label asp-for="Movie.Genre" class="control-label”x/label> 
Cinput asp-for="Movie.Genre" class="form-control” /> 

<span asp-validation-for="Movie.Genre" class="text-danger"x/spa 
</div> 

<div class="form-group”> 

Clabel asp-for="Hovie.Price" class=’’control-label”X/label> 
Cinput asp-for="Movie.Price" class=’’form-control" /> 

<span asp-validation-for="Movie.Price" class="text-danger"x/spa 
</div> 

<div class="form-group"> 

<input type=”submit" value="Create" class=”btn btn-default” /> 
</div> 

</form> 

</div> 

Rick Anderson, 4days ago I 1 author, lehange I lworkitem i ► 


B 


B 


<form method="post”> öğesi bir form etiketi yardımcıdır. Form etiketi Yardımcısı, bir antiforgery belirteciniotomatik 
olarak içerir. 

Yapı iskelesi altyapısı, modeldeki her alan için (KİMLİK hariç), aşağıdakine benzer Razor biçimlendirmesi oluşturur: 


<div asp-validation-summar'y="ModelOnly" class="text-danger"x/div> 

<div class="form-group"> 

elabel asp-for="Movie.Title" class="control-label"x/label> 
cinput asp-for="Movie.Title" class="form-control" /> 

<span asp-validation-for="Movie.Title" class="text-danger"x/span> 

</div> 

Doğrulama etiketi yardımcıları ( <div asp-vaiidation-summary ve <span asp-vaiidation-for ) doğrulama hatalarını 
görüntüler. Doğrulama, bu serinin ilerleyen kısımlarında daha ayrıntılı bir şekilde ele alınmıştır. 

Etiket etiketi Yardımcısı ( <label asp-for="Movie.Tltle" class="control-label"x/label> ), Title Özelliği için etiket 
başlığını ve for özniteliğini oluşturur. 

Giriş etiketi Yardımcısı ( cinput asp-for="Movie.Title" ciass="form-controi"> ), dataaçı kla ma la r ı n özniteliklerini 
kullanır ve istemci tarafında jQuery doğrulaması için gerekli HTML özniteliklerini üretir. 

Ek kaynaklar 


• Bu öğreticinin YouTube sürümü 
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Veritabanı ve ASPNET Core çalışma 

23.11.2019 * 20 minutes to read ı Edit Online 


Tarafından Rick Anderson ve ALİ Audette 
Örnek kodu görüntüle veya indir (indirme). 

Örnek kodu görüntüle veya indir (indirme). 

RazorPagesMovieContext nesnesi veritabanına bağlanma ve Movie nesneleri veritabanı kayıtlarına eşleme görevini 
işler. Veritabanı bağlamı, Sfortup.csiçindeki configureServices yönteminde bağımlılık ekleme kapsayıcısına 
kaydedilir: 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRazorPages(); 

Services.AddDbContext<RazorPagesMovieContext>(options => 

options.UseSqlServer(Configuration.GetConnectionString("RazorPagesMovieContext"))); 

} 

ASP.NET Core yapılandırma sistemi Connectionstring okur. Yerel geliştirme için, appSettings. JSON dosyasından 
bağlantı dizesini alır. 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

Veritabanı ( Database={Database name} ) için ad değeri, oluşturulan kodunuz için farklı olacaktır. Ad değeri rastgele. 

{ 

"Logging": { 

"LogLevel": { 

"Default": "Information", 

"Microsoft": "Warning", 

"Microsoft.Hosting.Lifetime": "Information" 

} 

b 

"AllowedHosts": 

"ConnectionStrings": { 

"RazorPagesMovieContext": "Server=(localdb)\\mssqllocaldbjDatabase=RazorPagesMovieContext- 
bc;Trusted_Connection=True;MultipleActiveResultSets=true" 

} 

} 


Uygulama bir test veya üretim sunucusuna dağıtıldığında, bağlantı dizesini gerçek bir veritabanı sunucusuna 
ayarlamak için bir ortam değişkeni kullanılabilir. Daha fazla bilgi için bkz. yapılandırma . 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 


SQL Server Express LocalDB 











LocalDB, program geliştirmeye yönelik SQL Server Express veritabanı altyapısının hafif bir sürümüdür. LocalDB, 
isteğe bağlı olarak başlar ve karmaşık yapılandırma olduğundan kullanıcı modunda çalışır. Varsayılan olarak, 
LocalDB veritabanı c:\ıisers\<user>\ dizininde *.mdf dosyaları oluşturur. 

• Görünüm menüsünden SQL Server Nesne Gezgini (ssox) öğesini açın. 


Tools Test 
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RazorPagesMovie - Microsoft Visual Studio 
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Movie tabloya sağ tıklayıp Görünüm Tasarımcısı' nı seçin: 
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id yanındaki anahtar simgesine göz önünde edin. Varsayılan olarak, EF birincil anahtar için id adlı bir özellik 
oluşturur. 

• Movie tabloya sağ tıklayın ve verileri görüntüle 1 yi seçin: 



Veritabanının çekirdeğini oluşturma 


Modeller klasöründe aşağıdaki kodla seedData adlı yeni bir sınıf oluşturun: 

























using Microsoft.EntityFrameworkCore; 

using Microsoft.Extensions.DependencyInjection; 

using RazorPagesMovie.Data; 

using System; 

using System.Linq; 

namespace RazorPagesMovie.Models 

{ 

public static class SeedData 

{ 

public static void Initialize(IServiceProvider serviceProvider) 

{ 

using (var context = new RazorPagesMovieContext( 
serviceProvider.GetRequiredService< 

DbContextOptions<RazorPagesMovieContext>>())) 

{ 

// Look for any movies. 
if (context.Movie.Any()) 

{ 

return; // DB has been seeded 

} 

context.Movie.AddRange( 
new Movie 
{ 

Title = "When Harry Met Sally", 

ReleaseDate = DateTime.Parse("1989-2-12"), 

Genre = "Romantic Comedy", 

Price = 7.99M 

}, 

new Movie 

{ 

Title = "Ghostbusters ", 

ReleaseDate = DateTime.Parse("1984-3-13"), 

Genre = "Comedy", 

Price = 8.99M 

}, 

new Movie 

{ 

Title = "Ghostbusters 2", 

ReleaseDate = DateTime.Parse("1986-2-23"), 

Genre = "Comedy", 

Price = 9.99M 

}, 

new Movie 

{ 

Title = "Rio Bravo", 

ReleaseDate = DateTime.Parse("1959-4-15"), 

Genre = "Western", 

Price = 3.99M 

} 

); 

context.SaveChanges(); 

} 

} 

} 

} 


VERITABANıNDA herhangi bir film varsa, tohum başlatıcısı döner ve hiçbir film eklenmez. 



if (context.Movie.Any()) 

{ 

return; // DB has been seeded. 

} 


Tohum başlatıcısı ekleme 

içinde Program.es, değişiklik Main yöntemi aşağıdakileri yapmak için: 

• Bir DB bağlamı örneği bağımlılık ekleme kapsayıcısını alın. 

• Temel yöntemi çağırın ve bu yönteme geçerek bağlamı geçer. 

• Çekirdek yöntemi tamamlandığında bağlamı atın. 

Aşağıdaki kod güncelleştirilmiş gösterir Program.es dosya. 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.Extensions.DependencyInjection; 

using Microsoft.Extensions.Hosting; 

using Microsoft.Extensions.Logging; 

using RazorPagesMovie.Models; 

using System; 

namespace RazorPagesMovie 

{ 

public elass Program 

{ 

public static void Main(string[] args) 

{ 

var hoşt = CreateHostBuilder(args).Build(); 

using (var scope = hoşt.Services.CreateScope()) 

{ 

var Services = scope.ServiceProvider; 

try 

{ 

SeedData.Initialize(services); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<ILogger<Program>>(); 
logger.LogError(ex, "An error occurred seeding the DB."); 

} 

} 

host.Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 

} 

} 

update-Database çalıştırılmayan aşağıdaki özel durum oluşur: 


SqlException: Cannot öpen database 

"RazorPagesMovieContext-" requested by the login. The login failed. 

Login failed for user 'user name'. 





Uygulamayı test etme 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

• VERITABANıNDAKI tüm kayıtları silin. Bunu, tarayıcıda veya Ssox 'ten silme bağlantılarıyla yapabilirsiniz 

• Çekirdek yöntemin çalışması için uygulamayı başlamaya zorlayın ( startup sınıfında yöntemleri çağırın). 
Başlatmayı zorlamak için 11S Express durdurulup yeniden başlatılması gerekir. Bunu aşağıdaki 
yaklaşımlardan biriyle yapabilirsiniz: 

o Bildirim alanında 11S Express sistem tepsisi simgesine sağ tıklayın ve Çıkış veya siteyi durdur' a 
dokunun: 


ÜS Express 



View Sites 

RazorPagesMovie ► 



Show Ali Applications 



Exit 
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o VS hata ayıklama modunda çal işti rıyorsanız, hata ayıklama modunda çalıştırmak için F5 tuşuna 
basın. 

o İle hata ayıklama modunda çalıştı rıyorsanız, hata ayıklayıcıyı durdurun ve F5 tuşuna basın. 
Sonraki öğreticide, verilerin sunumu gelişmeyecektir. 

Ek kaynaklar 


ÖNCEKİ: YAPI İSKELESİ RAZOR I 

İLERİ: SAYFALARI 

P A (5 E S f 
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Örnek kodu görüntüle veya indir (indirme). 

Örnek kodu görüntüle veya indir (indirme). 

RazorPagesMovieContext nesnesi veritabanına bağlanma ve Movie nesneleri veritabanı kayıtlarına eşleme görevin 
işler. Veritabanı bağlamı, Sfortup.csiçindeki configureServices yönteminde bağımlılık ekleme kapsayıcısına 
kaydedilir: 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 























// This method gets called by the runtime. 

// Use this method to add Services to the Container, 
public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

// This lambda determines whether ııser consent for non-essential cookies is 
// needed for a given request. 
options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.Nonej 

}); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

Services.AddDbContext<RazorPagesMovieContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("RazorPagesMovieContext"))); 

} 

Conf igu reServices ' de kullanılan yöntemler hakkında daha fazla bilgi için bkz.: 

• cookiePolicyOptions için ASP.NET Core ab genel veri koruma yönetmeliği (GDPR) desteği. 

• SetCompatibilityVersion 

ASP.NET Core yapılandırma sistemi Connectionstring okur. Yerel geliştirme için, appSett'ıngs. JSON dosyasından 
bağlantı dizesini alır. 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 


Veritabanı ( Database={Database name} ) için ad değeri, oluşturulan kodunuz için farklı olacaktır. Ad değeri rastgele. 

{ 

"Logging": { 

"LogLevel": { 

"Default": "Uarning" 

} 

b 

"AllowedHosts": "*", 

"ConnectionStrings": { 

"RazorPagesMovieContext": "Server=(localdb)\\mssqllocaldbjDatabase=RazorPagesMovieContext- 
1234;Trusted_Connection=True;MultipleActiveResultSets=true" 

} 

} 


Uygulama bir test veya üretim sunucusuna dağıtıldığında, bağlantı dizesini gerçek bir veritabanı sunucusuna 
ayarlamak için bir ortam değişkeni kullanılabilir. Daha fazla bilgi için bkz. yapılandırma . 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

SQL Server Express LocalDB 

LocalDB, program geliştirmeye yönelik SQL Server Express veritabanı altyapısının hafif bir sürümüdür. LocalDB, 
isteğe bağlı olarak başlar ve karmaşık yapılandırma olduğundan kullanıcı modunda çalışır. Varsayılan olarak, 
LocalDB veritabanı c:/users/<user/> dizininde *.mdf dosyaları oluşturur. 








Görünüm menüsünden SQL Server Nesne Gezgini (ssox) öğesini açın. 
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Tools Test 



Movie tabloya sağ tıklayıp Görünüm Tasarımcısı' nı seçin: 
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id yanındaki anahtar simgesine göz önünde edin. Varsayılan olarak, EF birincil anahtar için id adlı bir özellik 
oluşturur. 

• Movie tabloya sağ tıklayın ve verileri görüntüle 1 yi seçin: 



Veritabanının çekirdeğini oluşturma 


Modeller klasöründe aşağıdaki kodla seedData adlı yeni bir sınıf oluşturun: 

























using Microsoft.EntityFrameworkCore; 
using Microsoft.Extensions.DependencyInjection; 
using System; 
using System.Linq; 

namespace RazorPagesMovie.Models 

{ 

public static class SeedData 

{ 

public static void Initialize(IServiceProvider serviceProvider) 

{ 

using (var context = new RazorPagesMovieContext( 
serviceProvider.GetRequiredService< 

DbContextOptions<RazorPagesMovieContext>>())) 

{ 

// Look for any movies. 
if (context.Movie.Any()) 

{ 

return; // DB has been seeded 

} 

context.Movie.AddRange( 
new Movie 
{ 

Title = "When Harry Met Sally", 

ReleaseDate = DateTime.Parse("1989-2-12"), 

Genre = "Romantic Comedy", 

Price = 7.99M 

b 

new Movie 

{ 

Title = "Ghostbusters ", 

ReleaseDate = DateTime.Parse("1984-3-13"), 

Genre = "Comedy", 

Price = 8.99M 

b 

new Movie 

{ 

Title = "Ghostbusters 2", 

ReleaseDate = DateTime.Parse("1986-2-23"), 

Genre = "Comedy", 

Price = 9.99M 

b 

new Movie 

{ 

Title = "Rio Bravo", 

ReleaseDate = DateTime.Parse("1959-4-15"), 

Genre = "Western", 

Price = 3.99M 

} 

)J 

context.SaveChanges(); 

} 

} 

} 

} 


VERITABANıNDA herhangi bir film varsa, tohum başlatıcısı döner ve hiçbir film eklenmez. 



if (context.Movie.Any()) 

{ 

return; // DB has been seeded. 

} 


Tohum başlatıcısı ekleme 

içinde Program.es, değişiklik Main yöntemi aşağıdakileri yapmak için: 

• Bir DB bağlamı örneği bağımlılık ekleme kapsayıcısını alın. 

• Temel yöntemi çağırın ve bu yönteme geçerek bağlamı geçer. 

• Çekirdek yöntemi tamamlandığında bağlamı atın. 


Aşağıdaki kod güncelleştirilmiş gösterir Program.es dosya. 


using Microsoft.AspNetCore; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.Extensions.DependencyInjection; 

using Microsoft.Extensions.Logging; 

using RazorPagesMovie.Models; 

using System; 

using Microsoft.EntityFrameworkCore; 

namespace RazorPagesMovie 

{ 

public elass Program 

{ 

public static void Main(string[] args) 

{ 

var hoşt = CreateWebHostBuilder(args).Build(); 

using (var scope = hoşt.Services.CreateScope()) 

{ 

var Services = scope.ServiceProvider; 


try 

{ 

var context=services. 

GetRequiredService<RazorPagesMovieContext>(); 
context.Database.Migrate(); 

SeedData.Initialize(Services); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<ILogger<Program>>(); 
logger.LogError(ex, "An error occurred seeding the DB."); 

} 


host.Run(); 


} 


} 


public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 
WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>(); 


Bir üretim uygulaması Database.Migrate çağırmaz. Update-Database çalıştırılmadığından aşağıdaki özel durumu 
engellemek için yukarıdaki koda eklenir: 


SqlException: oturum açma tarafından istenen "RazorPagesMovieContext-21" veritabanı açılamıyor.Oturum 
açılamadı. 1 Kullanıcı adı ' kullanıcısı için oturum açma başarısız. 






Uygulamayı test etme 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• VERITABANıNDAKI tüm kayıtları silin. Bunu, tarayıcıda veya Ssox 'ten silme bağlantılarıyla yapabilirsiniz 

• Çekirdek yöntemin çalışması için uygulamayı başlamaya zorlayın ( startup sınıfında yöntemleri çağırın). 
Başlatmayı zorlamak için 11S Express durdurulup yeniden başlatılması gerekir. Bunu aşağıdaki 
yaklaşımlardan biriyle yapabilirsiniz: 

o Bildirim alanında 11S Express sistem tepsisi simgesine sağ tıklayın ve Çıkış veya siteyi durdur' a 
dokunun: 


ES Express ı 
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o VS hata ayıklama modunda çal işti rıyorsanız, hata ayıklama modunda çalıştırmak için F5 tuşuna 
basın. 

o İle hata ayıklama modunda çalıştı rıyorsanız, hata ayıklayıcıyı durdurun ve F5 tuşuna basın. 

Uygulama, sağlanan verileri gösterir: 

— □ X 

| lndex - Movie x + 

C i https://local hoşt: 5001/Movies 0 : 

RpMovİe Home Privacy 

lndex 

Create New 


Title 

ReleaseDate 

Gen re 

Price 


When Harry Met Sally 

2/12/1989 

Romantic Comedy 

7.99 

Edit | Details | Delete 

Ghostbusters 

3/13/1984 

Comedy 

8.99 

Edit | Details | Delete 

Ghostbusters 2 

2/23/1986 

Comedy 

9.99 

Edit | Details | Delete 

Rio Bravo 

4/15/1959 

VVestern 

3.99 

Edit | Details | Delete 

The Good, the bad, and the ugly 

12/1/2018 

VVestern 

1.19 

Edit | Details | Delete 


© 2019 - RazorPagesMovie - Privacy 


Sonraki öğretici, verilerin sunumunu temizler. 















Ek kaynaklar 

• Bu öğreticinin YouTube sürümü 
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ASPNET Core uygulamasında oluşturulan sayfalan 
güncelleştirme 

23.11.2019 • 14 minutes to read ı Edit Online 


Tarafından Rick Anderson 

Yapı iskelesi film uygulamasının iyi bir başlangıcı vardır ancak sunum ideal değildir. ReleaseDate Yayın tarihi (iki 
sözcük) olmalıdır. 
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| lndex - Movie x + 
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Oluşturulan kodu Güncelleştir 


Modeller/film, cs dosyasını açın ve aşağıdaki kodda gösterilen vurgulanmış satırları ekleyin: 






using System; 

using System.ComponentModel.DataAnnotations; 
using System.ComponentModel.DataAnnotations.Schema; 

namespace RazorPagesMovie.Models 

{ 

public class Movie 

{ 

public int ID { get; set; } 
public string Title { get; set; } 

[Display(Name = "Release Date")] 

[DataType(DataType.Date) ] 

public DateTime ReleaseDate { get; set; } 

public stning Genne { get; set; } 

[Column(TypeName = "decimal(18, 2)")] 
public decimal Price { get; set; } 

} 

} 

[Coiumn(TypeName = "decimai(i8j 2 )")] veri ek açıklaması, Entity Framevvork Core veritabanında Price para 
birimine doğru şekilde eşlemesine olanak sağlar. Daha fazla bilgi için bkz. veri türleri. 

Veri açıklamaları sonraki öğreticide ele alınmıştır. Display özniteliği bir alanın adı için (Bu durumda "ReleaseDate" 
yerine "Yayın tarihi") görüntüleneceğini belirtir. DataType özniteliği verilerin türünü belirtir (Tarih), bu nedenle 
alanda depolanan zaman bilgileri gösterilmez. 

Hedef URL 'yi görmek için sayfalara/filmlere gidin ve bir düzenleme bağlantısının üzerine gelin. 
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Düzenle, Ayrıntılarve Sil bağlantıları, Sayfalar/filmler/lnclex. cshtml dosyasındaki tutturucu etiketi Yardımcısı 
tarafından oluşturulur. 













@foreach (var item in Model.Movie) { 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.ReleaseDate) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Genre) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Price) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID">Details</a> | 

<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 


Etiket Yardımcıları, Razor dosyalarında HTML öğelerinin oluşturulmasına ve işlenmesine sunucu tarafı kodun 
katılmasını etkinleştir. Yukarıdaki kodda AnchorTagHelper , Razor sayfasından (yol göreli), asp-page ve yol kimliği ( 
asp-route-id ) HTML href öznitelik değerini dinamik olarak oluşturur. Daha fazla bilgi için bkz. Sayfalar İçin URL 
oluşturma . 

Oluşturulan biçimlendirmeyi incelemek için sık kullandığınız tarayıcıdan Görünüm kaynağım kullanın. 
Oluşturulan HTML 'nin bir bölümü aşağıda gösterilmiştir: 

<td> 

<a href="/Movies/Edit?id=l">Edit</a> | 

<a href="/Movies/Details?id=l">Details</a> | 

<a href="/Movies/Delete?id=l">Delete</a> 

</td> 

Dinamik olarak oluşturulan bağlantılar, film KİMLİĞİNİ bir sorgu dizesiyle (örneğin, 
https://localhost:5001/Movies/Details?id=l'' ?id=l ) iletir. 

Rota şablonu Ekle 

"{id: int}" yol şablonunu kullanmak için Düzenle, Ayrıntılar ve Sil Razor Pages güncelleştirin. Bu sayfaların her biri 
için Page yönergesini @page "{id:int}""@page değiştirin. Uygulamayı çalıştırın ve kaynağı görüntüleyin. 
Oluşturulan HTML, URL 'nin yol bölümüne KİMLİĞİ ekler: 

<td> 

<a href="/Movies/Edit/l">Edit</a> | 

<a href="/Movies/Details/l">Details</a> | 

<a href="/Movies/Delete/l">Delete</a> 

</td> 

Tamsayıyı içermeyen " {id: int}" yol şablonuna sahip sayfaya yönelik bir İstek, HTTP 404 (bulunamadı) hatası 
döndürüyor. Örneğin, http://iocaihost:5000/Movies/Detaiis bir 404 hatası döndürür. KİMLİĞİ isteğe bağlı yapmak 
için ? yol kısıtlamasına ekleyin: 

@page "{id:int?}" 













@page "{id: int?}" davranışını test etmek için: 


• Pages/flimier/details. cshtml içindeki page yönergesini @page "{id:int?}" olarak ayarlayın. 

• pubüc async Task<iActionResuit> 0nGetAsync(int? id) ( sayfalarda/filmlerde/details. cshtml. cs) bir kesme 
noktası ayarlayın. 

• https://test-cors.org sayfasına gidin. 

@page "{id : int}" yönergesi ile, kesme noktası hiçbir şekilde vurılmaz. Yönlendirme Altyapısı HTTP 404 döndürür. 
@page "{idıint?}" kullanarak onGetAsync yöntemi NotFound (HTTP 404) döndürür. 

Eşzamanlılık özel durum işlemeyi gözden geçirme 

Pages/filmler/Edit. cshtml. cs dosyasındaki onPostAsync yöntemini gözden geçirin: 

pubüc async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_context.Attach(Movie).State = EntityState.Modified; 

try 

{ 

await _context.SaveChangesAsync(); 

} 

catch (DbUpdateConcurrencyException) 

{ 

if (!MovieExists(Movie.ID)) 

{ 

return NotFound(); 

} 

else 

{ 

throw; 

} 

} 

return RedirectToPage("./Index"); 

} 

private bool MovieExists(int id) 

{ 

return _context.Movie.Any(e => e.ID == id); 

} 

Önceki kod, bir istemci filmi sildiği ve diğer istemci filmle değişiklik yaptığı zaman eşzamanlılık özel durumlarını 
algılar. 

catch bloğunu test etmek için: 

• catch (DbupdateConcurrencyException) kesme noktası ayarlama 

• Film için Düzenle 1 yi seçin, değişiklikler yapın, ancak Kaydet' i girmeyin. 

• Başka bir tarayıcı penceresinde, aynı filmin Sil bağlantısını seçin ve ardından filmi silin. 

• Önceki tarayıcı penceresinde filmdeki değişiklikleri gönderin. 

Üretim kodu eşzamanlılık çakışmalarını algılamak isteyebilir.Daha fazla bilgi için bkz. eşzamanlılık çakışmalarını 
işleme . 

Gönderme ve bağlama incelemesi 

Pages/filmler/Edit cshtml. cs dosyasını inceleyin: 










public class EditModel : PageModel 

{ 

private readonly RazorPagesMovie.Data.RazorPagesMovieContext _context; 

public EditModel(RazorPagesMovie.Data.RazorPagesMovieContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Movie Movie { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Movie = await _context.Movie.FirstOrDefaultAsync(m => m.ID == id); 

if (Movie == null) 

{ 

return NotFound(); 

} 

return Page(); 


public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_context.Attach(Movie).State = EntityState.Modified; 

try 

{ 

await _context.SaveChangesAsync(); 

} 

catch (DbUpdateConcurrencyException) 

{ 

if (!MovieExists(Movie.ID)) 

{ 

return NotFound(); 

} 

else 

{ 

throw; 

} 

} 

return RedirectToPage("./Index"); 

} 

private bool MovieExists(int id) 

{ 

return _context.Movie.Any(e => e.ID == id); 

} 

Filmler/düzenleme sayfasına HTTP GET isteği yapıldığında (örneğin, http://iocaihost:5000/Movies/Edit/2 ): 

• onGetAsync yöntemi, filmi veritabanından getirir ve Page yöntemini döndürür. 

• Page yöntemi, Pag es/film ler/Edit. cshtml Razor sayfasını \ş\er.Pages/filmler/Edit. cshtml dosyası, film modelinin 





sayfada kullanılabilir olmasını sağlayan model yönergesini ( @modei RazorPagesMovie.Pages.Movies.EditModei ) 
içerir. 

• Düzenleme formu filmdeki değerlerle birlikte görüntülenir. 

Filmler/Düzenle sayfası gönderildiğinde: 

• Sayfadaki form değerleri Movie özelliğine bağlıdır. [BindProperty] özniteliği model bağlamayımümkün. 

[BindProperty] 

public Movie Movie { get; set; } 

• Model durumunda hatalar varsa (örneğin, ReleaseDate bir tarihe dönüştürülemiyorsa), form gönderilen 
değerlerle yeniden görüntülenir. 

• Model hatası yoksa, film kaydedilir. 

Razor sayfalarında Dizin, oluşturma ve silme gibi HTTP GET yöntemleri benzer bir düzende yer alır. Razor Oluştur 
sayfasındaki HTTP POST onPostAsync yöntemi, Razor düzenleme sayfasındaki onPostAsync yöntemine benzer bir 
düzen izler. 

Ek kaynaklar 


ÖNCEKİ: BİR V E R İT A B A N IY L A 
ÇALIŞM A 


I 


İLERİ: ARAMA 
EKLE 


Yapı iskelesi film uygulamasının iyi bir başlangıcı vardır ancak sunum ideal değildir. ReleaseDate Yayın tarihi (iki 
sözcük) olmalıdır. 
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Oluşturulan kodu Güncelleştir 












M o delle r/film. cs dosyasını açın ve aşağıdaki kodda gösterilen vurgulanmış satırları ekleyin: 
using System; 

using System.ComponentModel.DataAnnotations; 
using System.ComponentModel.DataAnnotations.Schema; 

namespace RazorPagesMovie.Models 
{ 

public class Movie 
{ 

public int ID { get; set; } 
public stning Title { get; set; } 

[Display(Name = "Release Date")] 

[DataType(DataType.Date) ] 

public DateTime ReleaseDate { get; set; } 

public stning Genne { get; set; } 

[Column(TypeName = "decimal(18, 2)")] 
public decimal Price { get; set; } 

} 

} 

[Coiumn(TypeName = "decimai(i8j 2 )")] veri ek açıklaması, Entity Framevvork Core veritabanında Price para 
birimine doğru şekilde eşlemesine olanak sağlar. Daha fazla bilgi için bkz. veri türleri. 

Veri açıklamaları sonraki öğreticide ele alınmıştır. Display özniteliği bir alanın adı için (Bu durumda "ReleaseDate" 
yerine "Yayın tarihi") görüntüleneceğini belirtir. DataType özniteliği verilerin türünü belirtir (Tarih), bu nedenle 
alanda depolanan zaman bilgileri gösterilmez. 


Hedef URL 'yi görmek için sayfalara/filmlere gidin ve bir düzenleme bağlantısının üzerine gelin. 
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Düzenle, Ayrıntılarve Sil bağlantıları, Sayfalar/filmler/lndex. cshtml dosyasındaki tutturucu etiketi Yardımcısı 
tarafından oluşturulur. 
















@foreach (var item in Model.Movie) { 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.ReleaseDate) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Genre) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Price) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID">Details</a> | 

<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 


Etiket Yardımcıları, Razor dosyalarında HTML öğelerinin oluşturulmasına ve işlenmesine sunucu tarafı kodun 
katılmasını etkinleştir. Yukarıdaki kodda AnchorTagHelper , Razor sayfasından (yol göreli), asp-page ve yol kimliği ( 
asp-route-id ) HTML href öznitelik değerini dinamik olarak oluşturur. Daha fazla bilgi için bkz. Sayfalar İçin URL 
oluşturma . 

Oluşturulan biçimlendirmeyi incelemek için sık kullandığınız tarayıcıdan Görünüm kaynağım kullanın. 
Oluşturulan HTML 'nin bir bölümü aşağıda gösterilmiştir: 

<td> 

<a href="/Movies/Edit?id=l">Edit</a> | 

<a href="/Movies/Details?id=l">Details</a> | 

<a href="/Movies/Delete?id=l">Delete</a> 

</td> 

Dinamik olarak oluşturulan bağlantılar, film KİMLİĞİNİ bir sorgu dizesiyle (örneğin, 
https://localhost:5001/Movies/Details?id=l'' ?id=l ) iletir. 

"{id: int}" yol şablonunu kullanmak için Düzenle, Ayrıntılar ve Sil Razor Pages güncelleştirin. Bu sayfaların her biri 
için Page yönergesini @page "{id:int}""@page değiştirin. Uygulamayı çalıştırın ve kaynağı görüntüleyin. 
Oluşturulan HTML, URL 'nin yol bölümüne KİMLİĞİ ekler: 

<td> 

<a href="/Movies/Edit/l">Edit</a> | 

<a href="/Movies/Details/l">Details</a> | 

<a href="/Movies/Delete/l">Delete</a> 

</td> 

Tamsayıyı içermeyen " {id: int}" yol şablonuna sahip sayfaya yönelik bir İstek, HTTP 404 (bulunamadı) hatası 
döndürüyor. Örneğin, http://iocaihost:5000/Movies/Detaiis bir 404 hatası döndürür. KİMLİĞİ isteğe bağlı yapmak 
için ? yol kısıtlamasına ekleyin: 

@page "{id:int?}" 


@page "{id:int?}" davranışını test etmek için: 












• Pages/filmler/details. cshtml içindeki page yönergesini @page "{id:int?}" olarak ayarlayın. 

• pubüc async Task<iActionResuit> 0nGetAsync(int? id) ( sayfalarda/filmlerde/details. cshtml. cs) bir kesme 
noktası ayarlayın. 

• https://test-cors.org sayfasına gidin. 

@page "{id:int}" yönergesi ile, kesme noktası hiçbir şekilde vurılmaz. Yönlendirme Altyapısı HTTP 404 döndürür. 
@page "{idıint?}" kullanarak onGetAsync yöntemi NotFound (HTTP 404) döndürür. 

Eşzamanlılık özel durum işlemeyi gözden geçirme 

Pages/filmler/Edit. cshtml. cs dosyasındaki onPostAsync yöntemini gözden geçirin: 


pubüc async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_context.Attach(Movie).State = EntityState.Modified; 

try 

{ 

await _context.SaveChangesAsync(); 

} 

catch (DbUpdateConcurrencyException) 

{ 

if (!MovieExists(Movie.ID)) 

{ 

return NotFound(); 

} 

else 

{ 

throw; 

} 

} 

return RedirectToPage("./Index"); 

} 

private bool MovieExists(int id) 

{ 

return _context.Movie.Any(e => e.ID == id); 

} 

Önceki kod, bir istemci filmi sildiği ve diğer istemci filmle değişiklik yaptığı zaman eşzamanlılık özel durumlarını 
algılar. 

catch bloğunu test etmek için: 

• catch (DbupdateConcurrencyException) kesme noktası ayarlama 

• Film için Düzenle ' yi seçin, değişiklikler yapın, ancak Kaydet' i girmeyin. 

• Başka bir tarayıcı penceresinde, aynı filmin Sil bağlantısını seçin ve ardından filmi silin. 

• Önceki tarayıcı penceresinde filmdeki değişiklikleri gönderin. 

Üretim kodu eşzamanlılık çakışmalarını algılamak isteyebilir.Daha fazla bilgi için bkz. eşzamanlılık çakışmalarını 
işleme . 

Gönderme ve bağlama incelemesi 

Pages/film ler/Ed it. cshtml. cs dosyasını inceleyin: 









public class EditModel : PageModel 

{ 

private readonly RazorPagesMovieContext _context; 

public EditModel(RazorPagesMovieContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Movie Movie { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Movie = await _context.Movie.SingleOrDefaultAsync(m => m.ID == id); 

if (Movie == null) 

{ 

return NotFound(); 

} 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_context.Attach(Movie).State = EntityState.Modified; 

try 

{ 

await _context.SaveChangesAsync(); 

} 

catch (DbUpdateConcurrencyException) 

{ 

if (!_context.Movie.Any(e => e.ID == Movie.ID)) 

{ 

return NotFound(); 

} 

else 

{ 

throw; 

} 

} 

return RedirectToPage("./Index"); 

} 

} 

Filmler/düzenleme sayfasına HTTP GET isteği yapıldığında (örneğin, http://iocaihost:5000/Movies/Edit/2 ): 

• onGetAsync yöntemi, filmi veritabanından getirir ve Page yöntemini döndürür. 

• Page yöntemi, Pag es/film ler/Edit. cshtml Razor sayfasını \ş\er.Pages/filmler/Edit. cshtml dosyası, film modelinin 
sayfada kullanılabilir olmasını sağlayan model yönergesini ( @modei RazorPagesMovie.Pages.Movies.EditModel ) 
içerir. 

• Düzenleme formu filmdeki değerlerle birlikte görüntülenir. 





Filmler/Düzenle sayfası gönderildiğinde: 


• Sayfadaki form değerleri Movie özelliğine bağlıdır. [BindProperty] özniteliği model bağlamayımümkün. 

[BindProperty] 

public Movie Movie { get; set; } 

• Model durumunda hatalar varsa (örneğin, ReleaseDate bir tarihe dönüştürülemiyorsa), form gönderilen 
değerlerle birlikte görüntülenir. 

• Model hatası yoksa, film kaydedilir. 

Razor sayfalarında Dizin, oluşturma ve silme gibi HTTP GET yöntemleri benzer bir düzende yer alır. Razor Oluştur 
sayfasındaki HTTP POST onPostAsync yöntemi, Razor düzenleme sayfasındaki onPostAsync yöntemine benzer bir 
düzen izler. 

Arama sonraki öğreticiye eklenir. 

Ek kaynaklar 

• Bu öğreticinin YouTube sürümü 


ÖNCEKİ: BİR V E R İT A B A N IY L A 
ÇALIŞM A 


I 


İLERİ: ARAMA 
EKLE 











ASPNET Core Razor Pages arama Ekle 

6.12.2019 • 14 minutes to read ı Edit Online 


Tarafından RickAnderson 

Örnek kodu görüntüle veya indir (indirme). 

Örnek kodu görüntüle veya indir (indirme). 

Aşağıdaki bölümlerde, film tarzya veya ada göre arama eklenir. 

Aşağıdaki Vurgulanan özellikleri sayfalara/filmlere/lndex. cshtml. csöğesine ekleyin: 

public class IndexModel : PageModel 

{ 

private readonly RazorPagesMovie.Data.RazorPagesMovieContext _context; 

public IndexModel(RazorPagesMovie.Data.RazorPagesMovieContext context) 

{ 

_context = context; 

} 

public IList<Movie> Movie { get; set; } 

[BindProperty(SupportsGet = true)] 
public string SearchString { get; set; } 

// Requires using Microsoft.AspNetCore.Mvc.Rendering; 
public SelectList Genres { get; set; } 

[BindProperty(SupportsGet = true)] 
public string MovieGenre { get; set; } 

• SearchString : kullanıcıların arama metin kutusuna girebileceği metni içerir. SearchString [BindProperty] 

özniteliği vardır. [BindProperty] form değerlerini ve Sorgu dizelerini özelliğiyle aynı ada bağlar.GET isteklerinde 
bağlama için (SupportsGet = true) gereklidir. 


: tarzlar listesini içerir. 

Genres 

, kullanıcının listeden bir tarz seçmesine izin verir. 

SelectList 


using Microsoft.AspNetCore.Mvc.Rendering; gerektiriyor 

• MovieGenre : kullanıcının seçtiği belirli tarzı içerir (örneğin, "Batı"). 

• Genres ve MovieGenre daha sonra bu öğreticide kullanılır. 


WARNING 

Güvenlik nedenleriyle, get istek verilerini sayfa modeli özelliklerine bağlamayı tercih etmeniz gerekir. Özelliklerle 
eşleştirmadan önce Kullanıcı girişini doğrulayın, get bağlamaya dönüştürmek, sorgu dizesine veya rota değerlerine dayanan 
senaryoları adreslemekte yararlıdır. 

get isteklerindeki bir özelliği bağlamak için, [BindProperty] özniteliğinin SupportsGet özelliğini true olarak ayarlayın: 
[BindProperty(SupportsGet = true)] 

Daha fazla bilgi için bkz. ASP.NET Core topluluk alışması: Get tartışmasına bağlama (YouTube). 


Dizin sayfasının onGetAsync yöntemini aşağıdaki kodla güncelleştirin: 














public async Task OnGetAsync() 

{ 

var movies = from m in _context.Movie 
select m; 

if (!string.IsNullOrEmpty(SearchString)) 

{ 

movies = movies.Where(s => s.Title.Contains(SearchString)); 

} 

Movie = await movies.Tol_istAsync(); 

} 

onGetAsync yönteminin ilk satırı, filmleri seçmek için bir LINQ sorgusu oluşturur: 

// using System.Linq; 
var movies = from m in _context.Movie 
select m; 


Sorgu yalnızca bu noktada tanımlanmış, veritabanında çalıştırılmadı. 


searchstring özelliği null veya boş değilse, filmler sorgusu arama dizesinde filtrelenecek şekilde değiştirilir: 

if (!string.IsNullOrEmpty(SearchString)) 

{ 

movies = movies.Where(s => s.Title.Contains(SearchString)); 

} 


s => s.Titie.contains() kodu bir lambda ifadesidir. Lambdalar, Yöntem tabanlı LINQ sorgularında, VVhere 
yöntemi veya contains (önceki kodda kullanılan) gibi standart sorgu işleci yöntemlerine bağımsız değişkenler 
olarak kullanılır. LINQ sorguları tanımlandıklarında veya bir Yöntem (örneğin, where , contains veya orderBy ) 
çağırarak değiştirildiklerinde yürütülmez. Bunun yerine sorgu yürütmesi ertelenir. Diğer bir deyişle, bir ifadenin 
değerlendirmesi, gerçekleştirilmiş değeri yinelenene veya ToListAsync yöntemi çağrılana kadar gecikir. Daha fazla 
bilgi için bkz. sorgu yürütme . 
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Aşağıdaki yol şablonu dizin sayfasına eklendiyse, arama dizesi bir URL segmenti olarak geçirilebilir (örneğin, 
https://localhost:5001/Movies/Ghost ). 


@page "{searchString?}" 


Önceki yol kısıtlaması, başlığın sorgu dizesi değeri yerine rota verileri (bir URL segmenti) olarak aranmasına olanak 
tanır. "{searchString?}" ? , bu isteğe bağlı bir yol parametresi anlamına gelir. 
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ASP.NET Core çalışma zamanı, SearchString özelliğinin değerini sorgu dizesinden ( ?searchstring=Ghost ) veya 












rota verilerinden ( https://iocaihost:500i/Movies/Ghost ) ayarlamak için model bağlamayı kullanır. Model bağlama 
büyük/küçük harfe duyarlı değildir. 

Ancak, kullanıcıların bir filmi aramak için URL 'Yİ değiştirmesini beklemeniz gerekmez. Bu adımda, filmleri 
filtrelemek için Kullanıcı arabirimi eklenir, "{searchstring?}" yol kısıtlaması eklediyseniz, kaldırın. 

Pages/filmler/lndex. cshtml dosyasını açın ve aşağıdaki kodda vurgulanan <form> işaretlemesini ekleyin: 


@page 

@model RazorPagesMovie.Pages.Movies.IndexModel 

@{ 

ViewData["Title"] = "Index"; 

} 

<hl>Index</hl> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<form> 

<P> 

Title: <input type="text" asp-for="SearchString" /> 
<input type="submit" value="Filter" /> 

</p> 

</form> 

<table class="table"> 

@*Markup removed for brevity.*@ 


HTML <form> etiketi aşağıdaki Etiket Yardımcılarıkullanır: 

• Form etiketi Yardımcısı. Form gönderildiğinde, filtre dizesi, sorgu dizesi aracılığıyla Sayfalar/filmler/Dizin 
sayfasına gönderilir. 

• Giriş Etiketi Yardımcısı 


Değişiklikleri kaydedin ve filtreyi test edin. 
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Tarza göre ara 


onGetAsync yöntemini aşağıdaki kodla güncelleştirin: 



// Use LINQ to get üst of genres. 

IQueryable<string> genreQuery = fnom m in _context.Movie 

orderby m.Genre 
select m.Genre; 












Tarzın selectList , farklı tarzlar yansıtmayarak oluşturulur. 


Genres = new SelectList(await genreQuery.Distinct().Tol_istAsync()); 


Türe göre, Razor sayfasına arama ekleme 

lndex. cshtml 'yi aşağıdaki şekilde güncelleştirin: 

@page 

@model RazorPagesMovie.Pages.Movies.IndexModel 

@{ 

ViewData["Title"] = "Index"; 

} 

<hl>Index</hl> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<form> 

<P> 

<select asp-for="MovieGenre" asp-items="Model.Genres"> 
<option value="">All</option> 

</select> 

Title: <input type="text" asp-for="SearchStning" /> 
<input type="submit" value="Filter" /> 

</p> 

</form> 

<table class="table"> 

@*Markııp removed for brevity.*@ 


Türe göre, film başlığına göre ve her ikisine birden arayarak uygulamayı test edin. 

Ek kaynaklar 

• Bu öğreticinin YouTube sürümü 


ÖNCEKİ: SAYFALARI ■ İ L E RI: Y E N I B IR A L A N 

GÜNCELLEŞTİRME H EKLEME 


Örnek kodu görüntüle veya indir (indirme). 

Örnek kodu görüntüle veya indir (indirme). 

Aşağıdaki bölümlerde, film tarzya veya ada göre arama eklenir. 


Aşağıdaki Vurgulanan özellikleri sayfalara/filmlere/lndex. cshtml. csöğesine ekleyin: 








public class IndexModel : PageModel 

{ 

private readonly RazorPagesMovie.Models.RazorPagesMovieContext _context; 

public IndexModel(RazorPagesMovie.Models.RazorPagesMovieContext context) 

{ 

_context = context; 

} 

public IList<Movie> Movie { get; set; } 

[BindProperty(SupportsGet = true)] 
public string SearchString { get; set; } 

// Requires using Microsoft.AspNetCore.Mvc.Rendering; 
public SelectList Genres { get; set; } 

[BindProperty(SupportsGet = true)] 
public string MovieGenre { get; set; } 

• SearchString : kullanıcıların arama metin kutusuna girebileceği metni içerir. SearchString [BindProperty] 

özniteliği vardır. [BindProperty] form değerlerini ve Sorgu dizelerini özelliğiyle aynı ada bağlar.GET isteklerinde 
bağlama için (SupportsGet = true) gereklidir. 


: tarzlar listesini içerir. 

Genres 

, kullanıcının listeden bir tarz seçmesine izin verir. 

SelectList 


using Microsoft.AspNetCore.Mvc.Rendering; gerektiriyor 

• MovieGenre : kullanıcının seçtiği belirli tarzı içerir (örneğin, "Batı"). 

• Genres ve MovieGenre daha sonra bu öğreticide kullanılır. 


VVARNING 

Güvenlik nedenleriyle, get istek verilerini sayfa modeli özelliklerine bağlamayı tercih etmeniz gerekir. Özelliklerle 
eşleştirmadan önce Kullanıcı girişini doğrulayın, get bağlamaya dönüştürmek, sorgu dizesine veya rota değerlerine dayanan 
senaryoları adreslemekte yararlıdır. 

get isteklerindeki bir özelliği bağlamak için, [BindProperty] özniteliğinin SupportsGet özelliğini true olarak ayarlayın: 
[BindProperty(SupportsGet = true)] 

Daha fazla bilgi için bkz. ASP.NET Core topluluk alışması: Get tartışmasına bağlama (YouTube). 


Dizin sayfasının onGetAsync yöntemini aşağıdaki kodla güncelleştirin: 


public async Task OnGetAsync() 

{ 

var movies = from m in _context.Movie 
select m; 

if (!string.IsNullOrEmpty(SearchString)) 

{ 

movies = movies.Where(s => s.Title.Contains(SearchString)); 

} 

Movie = await movies.ToListAsync(); 

} 

OnGetAsync yönteminin ilk satırı, filmleri seçmek için bir LINQ sorgusu oluşturur: 

// using System.Linq; 
var movies = from m in _context.Movie 
select m; 













Sorgu yalnızca bu noktada tanımlanmış, veritabanında çalıştırılmadı. 


searchstring özelliği null veya boş değilse, filmler sorgusu arama dizesinde filtrelenecek şekilde değiştirilir: 


if (! string.IsNullOrEmpty(SearchString)) 

{ 

movies = movies.Where(s => s.Title.Contains(SearchString)); 

} 


s => s.Titie.contains() kodu bir lambda ifadesidir. Lambdalar, Yöntem tabanlı LINQ sorgularında, VVhere 
yöntemi veya contains (önceki kodda kullanılan) gibi standart sorgu işleci yöntemlerine bağımsız değişkenler 
olarak kullanılır. LINQ sorguları tanımlandıklarında veya bir Yöntem (örneğin, where , contains veya orderBy ) 
çağırarak değiştirildiklerinde yürütülmez. Bunun yerine sorgu yürütmesi ertelenir. Diğer bir deyişle, bir ifadenin 
değerlendirmesi, gerçekleştirilmiş değeri yinelenene veya ToListAsync yöntemi çağrılana kadar gecikir. Daha fazla 
bilgi için bkz. sorgu yürütme . 


Note: Contains yöntemi C# kodda değil, veritabanında çalıştırılır.Sorgudaki büyük/küçük harf duyarlılığı 
veritabanına ve harmanlamaya bağlıdır. SQL Server, SQL İle benzer, büyük/küçük harfe duyarsız contains eşlenir. 
SQLİte ' da, varsayılan harmanlama ile büyük/küçük harfe duyarlıdır. 

Filmler sayfasına gidin ve URL 'ye ?searchstring=Ghost gibi bir sorgu dizesi ekleyin (örneğin, 
https://iocaihost:500i/Movies?searchstring=Ghost ). Filtrelenmiş filmler görüntülenir. 



Aşağıdaki yol şablonu dizin sayfasına eklendiyse, arama dizesi bir URL segmenti olarak geçirilebilir (örneğin, 
https://localhost:5001/Movies/Ghost ). 

@page "{searchstring?}" 

Önceki yol kısıtlaması, başlığın sorgu dizesi değeri yerine rota verileri (bir URL segmenti) olarak aranmasına olanak 
tanır, "{searchstring?}" ? , bu isteğe bağlı bir yol parametresi anlamına gelir. 
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ASP.NET Core çalışma zamanı, searchstring özelliğinin değerini sorgu dizesinden ( ?searchstring=Ghost ) veya 
rota verilerinden ( https://iocaihost:500i/Movies/Ghost ) ayarlamak için model bağlamayı kullanır. Model bağlama 
büyük/küçük harfe duyarlı değildir. 

Ancak, kullanıcıların bir filmi aramak için URL 'Yİ değiştirmesini beklemeniz gerekmez. Bu adımda, filmleri 
filtrelemek için Kullanıcı arabirimi eklenir, "{searchstring?}" yol kısıtlaması eklediyseniz, kaldırın. 

Pages/filmler/lndex. cshtml dosyasını açın ve aşağıdaki kodda vurgulanan <form> işaretlemesini ekleyin: 

@page 

@model RazorPagesMovie.Pages.Movies.IndexModel 

@{ 

ViewData["Title"] = "Index"; 

} 

<hl>Index</hl> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<form> 

<P> 

Title: <input type="text" asp-for="SearchString" /> 

<input type="submit" value="Filter" /> 

</p> 

</form> 

<table class="table"> 

@*Markup removed for brevity.*@ 

HTML <form> etiketi aşağıdaki Etiket Yardımcılarıkullanır: 

• Form etiketi Yardımcısı. Form gönderildiğinde, filtre dizesi, sorgu dizesi aracılığıyla Sayfa la r/film ler/D izin 
sayfasına gönderilir. 










• Giriş Etiketi Yardımcısı 


Değişiklikleri kaydedin ve filtreyi test edin. 
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Tarza göre ara 

onGetAsync yöntemini aşağıdaki kodla güncelleştirin: 

public async Task OnGetAsync() 

{ 

// Use LINQ to get üst of genres. 

IQueryable<string> genreQuery = from m in _context.Movie 

orderby m.Genre 
select m.Genre; 

var movies = from m in _context.Movie 
select m; 

if (!string.IsNullOrEmpty(SearchString)) 

{ 

movies = movies.Where(s => s.Title.Contains(SearchString)); 

} 

if (!string.IsNullOrEmpty(MovieGenre)) 

{ 

movies = movies.Where(x => x.Genre == MovieGenre); 

} 

Genres = new SelectList(await genreQuery.Distinct().ToListAsync()); 
Movie = await movies.ToListAsync(); 


Aşağıdaki kod, veritabanından tüm tarzları alan bir LINQ sorgusudur. 










// Use LINQ to get üst of genres. 

IQueryable<string> genreQuery = from m in _context.Movie 

orderby m.Genre 
select m.Genre; 

Tarzın selectList , farklı tarzlar yansıtmayarak oluşturulur. 

Genres = new SelectList(await genreQuery.Distinct().ToListAsync()); 


Türe göre, Razor sayfasına arama ekleme 

lndex. cshtml 'yi aşağıdaki şekilde güncelleştirin: 

@page 

@model RazorPagesMovie.Pages.Movies.IndexModel 

@{ 

ViewData["Title"] = "Index"; 

} 

<hl>Index</hl> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<form> 

<P> 

<select asp-for="MovieGenre" asp-items="Model.Genres"> 

<option value="">All</option> 

</select> 

Title: <input type="text" asp-for="SearchString" /> 

<input type="submit" value="Filter" /> 

</p> 

</form> 

<table class="table"> 

@*Markup removed for brevity.*@ 

Türe göre, film başlığına göre ve her ikisine birden arayarak uygulamayı test edin. Önceki kod, Select etiketi 
yardımcısını ve seçenek etiketi yardımcısını kullanır. 

Ek kaynaklar 

• Bu öğreticinin YouTube sürümü 


ÖNCEKİ: SAYFALARI 




İLERİ: YENİ BİR ALAN 


GÜNCELLEŞTİRİN/! E 


EKLEME 









ASPNET Core Razor sayfasına yeni bir alan ekleyin 

23.11.2019 • 17 minutes to readz. Edit Online 


Tarafından RickAnderson 

Örnek kodu görüntüle veya indir (indirme). 

Örnek kodu görüntüle veya indir (indirme). 

Bu bölümde Entity Framevvork için Code First Migrations kullanılır: 

• Modele yeni bir alan ekleyin. 

• Yeni alan şeması değişikliğini veritabanına geçirin. 

Bir veritabanını otomatik olarak oluşturmak için EF Code First kullanırken Code First: 

• Veritabanı şemasının oluşturulduğu model sınıflarıyla eşitlenmiş olup olmadığını izlemek için veritabanına bir 
_EFMİgrationsHistory tablosu ekler. 

• Model sınıfları DB ile eşitlenmiyorsa, EF bir özel durum oluşturur. 

Şema/modelin eşitlemede otomatik olarak doğrulanması, tutarsız veritabanı/kod sorunlarını bulmayı kolaylaştırır. 

Film modeline bir derecelendirme özelliği ekleme 

Modeller/film. cs dosyasını açın ve bir Rating özelliği ekleyin: 

public class Movie 
{ 

public int ID { get; set; } 
public string Title { get; set; } 

[Display(Name = "Release Date")] 

[DataType(DataType.Date) ] 

public DateTime ReleaseDate { get; set; } 

public string Genre { get; set; } 

[Column(TypeName = "decimal(18j 2)")] 
public decimal Price { get; set; } 
public string Rating { get; set; } 

} 


Uygulamayı derleyin. 

Sayfaları/filmleri/dizini. cshtml'yl düzenleyin ve bir Rating alanı ekleyin: 

@page 

@model RazorPagesMovie.Pages.Movies.IndexModel 


ViewData["Title"] = "Index"; 

} 

<hl>Index</hl> 

<P> 

<a asp-page="Create">Create New</a> 


</p> 








<fonm> 

<P> 


<select asp-for="MovieGenre" asp-items="Model.Genres"> 
coption value="">All</option> 

</select> 

Title: <input type="text" asp-for="SearchString" /> 

<input type="submit" value="Filter" /> 

</p> 

</form> 

<table class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model => model.Movie[0].Title) 

</th> 

<th> 

@Html.DisplayNameFor(model = > model.Movie[0].ReleaseDate) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movie[0].Genre) 

</th> 

<th> 

@Html.DisplayNameFon(model => model.Movie[0].Price) 

</th> 

<th> 

@Html.DisplayNameFon(model => model.Movie[0].Rating) 

</th> 

<thx/th> 

</tn> 

</thead> 

<tbody> 

@foneach (var item in Model.Movie) 

{ 

<tr> 

<td> 

@Fltml.DisplayFor(modelItem => item.Title) 

</td> 

<td> 

@Fltml.DisplayFor(modelItem => item.ReleaseDate) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Genre) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Price) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Rating) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID">Details</a> | 

<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 


Aşağıdaki sayfaları güncelleştirin: 

• Silme ve Ayrıntılar sayfalarına Rating alanını ekleyin. 

• Create. cshtml dosyasını bir Rating alanla güncelleştirin. 

• Düzenleme sayfasına Rating alanını ekleyin. 





VERITABANı yeni alanı içerecek şekilde güncelleştirilene kadar uygulama çalışmaz. Veritabanını güncelleştirmeden 
uygulamayı çalıştırmak bir sqiException oluşturur: 

SqlException: Invalid column name ’Rating'. 

sqiException özel durumu, güncelleştirilmiş film modeli sınıfının, veritabanının film tablosunun şemasından farklı 
olmasından kaynaklanır. (Veritabanı tablosunda Rating sütunu yoktur.) 

Hatayı çözmek için birkaç yaklaşım vardır: 

1. Yeni model sınıfı şemasını kullanarak veritabanını otomatik olarak bırakıp yeniden oluşturmaya Entity 
Framevvork. Bu yaklaşım, geliştirme döngüsünün başlarında daha erken bir yoldur; modeli ve veritabanı 
şemasını birlikte hızla gelişmenize olanak tanır. Dovvnsıde, veritabanında var olan verileri kaybetmeniz. Bu 
yaklaşımı bir üretim veritabanında kullanmayın! DB 'yi şema değişikliklerinde bırakıp bir başlatıcı kullanarak 
veritabanının test verileriyle otomatik olarak çekirdeğini oluşturmak, genellikle bir uygulama geliştirmeye 
yönelik üretken bir yoldur. 

2. Mevcut veritabanının şemasını model sınıflarıyla eşleşecek şekilde açıkça değiştirin. Bu yaklaşımın avantajı, 
verilerinizi tutmanızı kullanmaktır. Bu değişikliği el ile ya da bir veritabanı değişiklik betiği oluşturarak 
yapabilirsiniz. 

3. Veritabanı şemasını güncelleştirmek için Code First Migrations kullanın. 

Bu öğretici için Code First Migrations kullanın. 

seedData sınıfını yeni sütun için bir değer sağlayacak şekilde güncelleştirin. Aşağıda örnek bir değişiklik 
gösterilmektedir, ancak her bir new Movie bloğu için bu değişikliği yapmak isteyeceksiniz. 

context.Movie.AddRange( 
new Movie 
{ 

Title = "When Harry Met Sally", 

ReleaseDate = DateTime.Parse("1989-2-12"), 

Genre = "Romantic Comedy", 

Price = 7.99M, 

Rating = "R" 

Tamamlanan SeedData.es dosyasınabakın. 

Çözümü oluşturun. 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

Derecelendirme alanı için bir geçiş ekleyin 

Araçlar menüsünde NuGet Paket Yöneticisi > Paket Yöneticisi konsolu 1 nu seçin. PMC'de aşağıdaki komutları 
girin: 

Add-Mignation Rating 
Update-Database 

Add-Mignation komutu, çerçeveye şunları belirtir: 

• Movie modelini Movie DB şemasıyla karşılaştırın. 

• DB şemasını yeni modele geçirmek için kod oluşturun. 

"Derecelendirme" adı rastgele olur ve geçiş dosyasını adlandırmak için kullanılır.Geçiş dosyası için anlamlı bir ad 











kullanılması yararlı olur. 

update-Database komutu, çerçeveye şema değişikliklerini uygulamaya ve var olan verileri korumanıza bildirir. 

VERITABANıNDAKI tüm kayıtları silerseniz, başlatıcı DB 'yi temel alır ve Rating alanını içerir. Bunu, tarayıcıda veya 
SQL Server Nesne Gezgini (ssox) silme bağlantılarıyla yapabilirsiniz. 

Başka bir seçenek de veritabanını silmek ve geçişleri kullanarak veritabanını yeniden oluşturmaktır.SSOX 'te 
veritabanını silmek için: 

• SSOX'te veritabanını seçin. 

• Veritabanına sağ tıklayın ve Sil' i seçin. 

• Mevcut bağlantıları kapat' a bakın. 

• Seçin Tamam. 

• PMC'de veritabanını güncelleştirin: 

Update-Database 

Uygulamayı çalıştırın ve bir Rating alanı ile film oluşturabileceğiniz/düzenleyebileceğiniz/görüntüleydiğinizi 
doğrulayın. Veritabanı birlikte olmazsa, seedData.initialize yönteminde bir kesme noktası ayarlayın. 

Ek kaynaklar 

• Bu öğreticinin YouTube sürümü 


ÖNCEKİ: 

ekleme 

SONRAKİ: DOĞRULAMA 

ARAM A 


EKLEM E 


Örnek kodu görüntüle veya indir (indirme). 

Örnek kodu görüntüle veya indir (indirme). 

Bu bölümde Entity Framevvork için Code First Migrations kullanılır: 

• Modele yeni bir alan ekleyin. 

• Yeni alan şeması değişikliğini veritabanına geçirin. 

Bir veritabanını otomatik olarak oluşturmak için EF Code First kullanırken Code First: 

• Veritabanı şemasının oluşturulduğu model sınıflarıyla uyumlu olup olmadığını izlemek için veritabanına bir tablo 
ekler. 

• Model sınıfları DB ile eşitlenmiyorsa, EF bir özel durum oluşturur. 

Şema/modelin eşitlemede otomatik olarak doğrulanması, tutarsız veritabanı/kod sorunlarını bulmayı kolaylaştırır. 

Film modeline bir derecelendirme özelliği ekleme 

M o d e ile r/film. cs dosyasını açın ve bir Rating özelliği ekleyin: 











public class Movie 

{ 

public int ID { get; set; } 
public stning Title { get; set; } 

[Display(Name = "Release Date")] 
[DataType(DataType.Date)] 
public DateTime ReleaseDate { get; set; } 
public stning Genre { get; set; } 

[Column(TypeName = "decimal(18, 2)")] 
public decimal Pnice { get; set; } 
public stning Rating { get; set; } 


Uygulamayı derleyin. 

Sayfaları/filmleri/dizini. cshtml'yl düzenleyin ve bir Rating alanı ekleyin: 

@page 

@model RazorPagesMovie.Pages.Movies.IndexModel 

@{ 

ViewData["Title"] = "Index"; 

} 

<hl>Index</hl> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<form> 

<P> 

<select asp-fon="MovieGenne" asp-items="Model.Gennes"> 

<option value="">All</option> 

</select> 

Title: <input type="text" asp-fon="SeanchStning" /> 

<input type="submit" value="Filten" /> 

</p> 

</form> 

<table class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFon(model => model.Movie[0].Title) 

</th> 

<th> 

@Html.DisplayNameFon(model => model.Movie[0].ReleaseDate) 
</th> 

<th> 

@Html.DisplayNameFon(model => model.Movie[0].Genne) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movie[0].Pnice) 

</th> 

<th> 

@Html.DisplayNameFon(model => model.Movie[0].Rating) 

</th> 

<thx/th> 

</tn> 

</thead> 

<tbody> 

@foneach (van item in Model.Movie) 




{ 

<trxtd> 

@Html.DisplayFor(modelItem => item.Title) 

</td> 

<td> 

@Html.DisplayFon(modelItem => item.ReleaseDate) 

</td> 

<td> 

@Fltml.DisplayFon(modelItem => item.Genre) 

</td> 

<td> 

@Fltml.DisplayFor(modelItem => item.Price) 

</td> 

<td> 

@Html.DisplayFon(modelItem => item.Rating) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-page="./Details" asp-noute-id="@item.ID">Details</a> | 

<a asp-page="./Delete" asp-noute-id="@item.ID">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 


Aşağıdaki sayfaları güncelleştirin: 

• Silme ve Ayrıntılar sayfalarına Rating alanını ekleyin. 

• Create. cshtml dosyasını bir Rating alanla güncelleştirin. 

• Düzenleme sayfasına Rating alanını ekleyin. 

VERITABANı yeni alanı içerecek şekilde güncelleştirilene kadar uygulama çalışmaz. Şimdi çalıştırırsanız, uygulama 
bir sqiException oluşturur: 

SqlException: Invalid column name 'Rating'. 


Bu hata, güncelleştirilmiş film modeli sınıfının, veritabanının film tablosunun şemasından farklı olmasından 

kaynaklanır. (Veritabanı tablosunda Rating sütunu yoktur.) 

Hatayı çözmek için birkaç yaklaşım vardır: 

1. Yeni model sınıfı şemasını kullanarak veritabanını otomatik olarak bırakıp yeniden oluşturmaya Entity 
Framevvork. Bu yaklaşım, geliştirme döngüsünün başlarında daha erken bir yoldur; modeli ve veritabanı 
şemasını birlikte hızla gelişmenize olanak tanır. Dovvnsıde, veritabanında var olan verileri kaybetmeniz. Bu 
yaklaşımı bir üretim veritabanında kullanmayın! DB 'yi şema değişikliklerinde bırakıp bir başlatıcı kullanarak 
veritabanının test verileriyle otomatik olarak çekirdeğini oluşturmak, genellikle bir uygulama geliştirmeye 
yönelik üretken bir yoldur. 

2. Mevcut veritabanının şemasını model sınıflarıyla eşleşecek şekilde açıkça değiştirin. Bu yaklaşımın avantajı, 
verilerinizi tutmanızı kullanmaktır. Bu değişikliği el ile ya da bir veritabanı değişiklik betiği oluşturarak 
yapabilirsiniz. 

3. Veritabanı şemasını güncelleştirmek için Code First Migrations kullanın. 

Bu öğretici için Code First Migrations kullanın. 

seedData sınıfını yeni sütun için bir değer sağlayacak şekilde güncelleştirin. Aşağıda örnek bir değişiklik 

gösterilmektedir, ancak her bir new Movie bloğu için bu değişikliği yapmak isteyeceksiniz. 











context.Movie.AddRange( 
new Movie 
{ 

Title = "When Harry Met Sally", 

ReleaseDate = DateTime.Parse("1989-2-12"), 

Gerine = "Romantic Comedy", 

Pnice = 7.99M, 

Rating = "R" 

}, 

Tamamlanan SeedData.es dosyasmabakın. 

Çözümü oluşturun. 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

Derecelendirme alanı için bir geçiş ekleyin 

Araçlar menüsünde NuGet Paket Yöneticisi > Paket Yöneticisi konsolu 1 nu seçin. PMC'de aşağıdaki komutları 
girin: 

Add-Migration Rating 
Update-Database 

Add-Migration komutu, çerçeveye şunları belirtir: 

• Movie modelini Movie DB şemasıyla karşılaştırın. 

• DB şemasını yeni modele geçirmek için kod oluşturun. 

"Derecelendirme" adı rastgele olur ve geçiş dosyasını adlandırmak için kullanılır.Geçiş dosyası için anlamlı bir ad 
kullanılması yararlı olur. 

update-Database komutu, çerçeveye şema değişikliklerini veritabanına uygulamasını söyler. 

VERITABANıNDAKI tüm kayıtları silerseniz, başlatıcı DB 'yi temel alır ve Rating alanını içerir. Bunu, tarayıcıda veya 
SQL Server Nesne Gezgini (ssox) silme bağlantılarıyla yapabilirsiniz. 

Başka bir seçenek de veritabanını silmek ve geçişleri kullanarak veritabanını yeniden oluşturmaktır. S S OX 'te 
veritabanını silmek için: 

• SSOX'te veritabanını seçin. 

• Veritabanına sağ tıklayın ve Sil' i seçin. 

• Mevcut bağlantıları kapat' a bakın. 

• Seçin Tamam. 

• PMC'de veritabanını güncelleştirin: 

Update-Database 

Uygulamayı çalıştırın ve bir Rating alanı ile film oluşturabileceğiniz/düzenleyebileceğiniz/görüntüleydiğinizi 
doğrulayın. Veritabanı birlikte olmazsa, seedData.initialize yönteminde bir kesme noktası ayarlayın. 


Ek kaynaklar 










• Bu öğreticinin YouTube sürümü 
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ASPNET Core Razor sayfasına doğrulama ekleme 

15.10.2019 • 15 minutes to read ı Edit Online 


Rick Anderson tarafından 

Bu bölümde, Movie modeline doğrulama mantığı eklenir. Doğrulama kuralları, bir Kullanıcı bir filmi 
oluşturduğunda veya düzenleişinizde zorlanır. 

Doğrulama 

Yazılım geliştirmeye yönelik temel bir temel kuru ("Don't Repeon Yourself") olarak adlandırılır. Razor Pages, 
işlevselliği bir kez belirtildiğinde geliştirme ve uygulama genelinde yansıtılmıştır. Kuru şu şekilde yardımcı olabilir: 

• Uygulamadaki kod miktarını azaltın. 

• Kodu daha az hata haline getirin ve test ve bakım yapmayı kolaylaştırın. 

Razor Pages ve Entity Framevvork tarafından sunulan doğrulama desteği, Kuru ilkesine iyi bir örnektir. Doğrulama 
kuralları tek bir yerde (model sınıfında) bildirimli olarak belirtilir ve kurallar uygulamada her yerde zorlanır. 

Film modeline doğrulama kuralları ekleme 

Dataaçıklamalarda ad alanı, bir sınıfa veya özelliğe bildirimli olarak uygulanan bir yerleşik doğrulama öznitelikleri 
kümesi sağlar. Veri açıklamaları, biçimlendirme ile yardım eden ve herhangi bir doğrulama sağlamayan DataType 
gibi biçimlendirme öznitelikleri de içerir. 

@No_t-0 sınıfını, yerleşik Required , stringLength , ReguiarExpression ve Range doğrulama özniteliklerinden 

faydalanmak için güncelleştirin. 

public class Movie 

{ 

public int ID { get; set; } 

[StringLength(60j MinimumLength = 3)] 

[Required] 

public string Title { get; set; } 

[Display(Name = "Release Date")] 

[DataType(DataType.Date) ] 

public DateTime ReleaseDate { get; set; } 

[Range(l, 100)] 

[DataType(DataType.Currency) ] 

[Column(TypeName = "decimal(18j 2)")] 
public decimal Price { get; set; } 

[RegularExpression(@" A [A-Z]+[a-zA-Z \s-]*$")] 

[Required] 

[StringLength(30)] 

public string Genre { get; set; } 

[RegularExpression(@" A [A-Z]+[a-zA-Z0-9""'\s-]*$")] 

[StringLength(5)] 

[Required] 

public string Rating { get; set; } 

} 









Doğrulama öznitelikleri, uygulanan model özellikleri üzerinde zorlamak istediğiniz davranışı belirtir: 

• @No__t-0 ve MinimumLength öznitelikleri bir özelliğin bir değere sahip olması gerektiğini belirtir; Ancak 
hiçbir şey, kullanıcının bu doğrulamayı karşılamak için boşluk girmesini engeller. 

• @No__t-0 özniteliği, hangi karakterlerin girişi yapabileceğini sınırlamak için kullanılır.Yukarıdaki kodda, 

"tarz": 

o Yalnızca harfler kullanılmalıdır. 

o ilk harfin büyük harfle olması gerekir.Boşluk, sayı ve özel karakterlere izin verilmez. 

• @No__t-0 "derecelendirmesi": 

o İlk karakterin büyük harf olmasını gerektirir. 

o Sonraki boşlukların içindeki özel karakter ve sayılara izin verir."PG-13" bir derecelendirme için geçerlidir, 
ancak bir "tarz" için başarısız olur. 

• @No__t-0 özniteliği, bir değeri belirtilen bir Aralık içinde kısıtlar. 

• @No__t-0 özniteliği, bir dize özelliğinin en büyük uzunluğunu ve isteğe bağlı olarak en düşük uzunluğunu 
ayarlamanıza olanak sağlar. 

• Değer türleri (örneğin decimai , int , float , DateTime ), doğal olarak gereklidir ve [Required] özniteliğine 
gerek kalmaz. 

Doğrulama kurallarının otomatik olarak uygulanmasını ASP.NET Core uygulamanızın daha sağlam olmasına 
yardımcı olur. Ayrıca, bir şeyi doğrulamayı unutmanızı ve veritabanına yanlışlıkla veri vermemesini de sağlar. 

Razor Pages 'de doğrulama hatası Kullanıcı arabirimi 

Uygulamayı çalıştırın ve sayfalar/Filmler 1 e gidin. 

Yeni oluştur bağlantısını seçin. Formu, bazı geçersiz değerlerle doldurun. JQuery istemci tarafı doğrulaması hatayı 
algıladığında, bir hata iletisi görüntüler. 






| Create - Movie 


C A https://localhost:5001/Movies/Create O. @ i 

RpMovie Home Privacy 

Create 

Movie 


Title 

a 

The field Title must be a string with a 
minimum length of 3 and a maximum 
length of 60. 

Release Date 

00/01/0001 x : ▼ 

The Release Date field is requıred. 

Genre 

a 

The field Genre must match the regular 
eıtpression A [A-Z)+la-zA-Z"'\s-)*$'. 


Price 

Dog 

The field Price must be a number. 

Rating 

z 

The field Rating must match the regular 
expres$ion' A [A-Zl* |a-zA-Z0-9"\s-]‘$'. 


Oeate 
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NOTE 

Ondalık alanlara ondalık virgüller giremeyebilirsiniz. Ondalık bir nokta ve ABD İngilizcesi olmayan tarih biçimleri için virgül 
kullanan İngilizce olmayan yerel ayarlarda jOuery doğrulamasını desteklemek için, uygulamanızı globalize için adımlar 
uygulamanız gerekir. Ondalık virgülden ekleme hakkında yönergeler için bkz. GitHub sorunu 4076 . 


Formun geçersiz bir değer içeren her alanda otomatik olarak bir doğrulama hata iletisi nasıl oluşturulduğuna dikkat 
edin. Hatalar hem istemci tarafında (JavaScript ve jQuery kullanılarak) hem de sunucu tarafında (bir Kullanıcı 
JavaScript devre dışı bırakıldığında) zorlanır. 

Önemli bir avantaj, oluşturma veya düzenleme sayfalarında hiçbir kod değişikliği gerekli değildir. Veri ek 
açıklamaları modele uygulandıktan sonra, doğrulama kullanıcı arabirimi etkinleştirilmiştir. Bu öğreticide oluşturulan 
Razor Pages otomatik olarak doğrulama kurallarını ( Movie Model sınıfının özelliklerinde doğrulama özniteliklerini 
kullanarak) otomatik olarak alır. Düzenleme sayfasını kullanarak doğrulama testi, aynı doğrulama uygulanır. 

Form verileri, istemci tarafı doğrulama hatası kalmayana kadar sunucuya nakledilmez. Form verilerinin aşağıdaki 
yaklaşımlardan bir veya daha fazlası tarafından nakledilmediğinden emin olun: 

• @No__t-0 yöntemine bir kesme noktası koyun. Formu gönder ( Oluştur veya Kaydet 1 i seçin). Kesme noktası 
hiçbir şekilde isabet ettirilmez. 


• Fiddler aracınıkullanın. 










• Ağ trafiğini izlemek için tarayıcı Geliştirici Araçları 1 nı kullanın. 

Sunucu tarafı doğrulaması 

Tarayıcıda JavaScript devre dışı bırakıldığında, formun hatalarla gönderilmesi sunucuya gönderilir, 
isteğe bağlı, test sunucusu-tarafı doğrulaması: 

• Tarayıcıda JavaScript ’ı devre dışı bırakın. Tarayıcının geliştirici araçlarını kullanarak JavaScript 'ı devre dışı 
bırakabilirsiniz. Tarayıcıda JavaScript 'ı devre dışı bırakadıysanız başka bir tarayıcı deneyin. 

• Oluşturma veya düzenleme sayfasının onPostAsync yönteminde bir kesme noktası ayarlayın. 

• Geçersiz verilerle form gönderme. 

• Model durumunun geçersiz olduğunu doğrulayın: 

if (IModelState.IsValid) 

{ 

return Page(); 

} 


Aşağıdaki kod, öğreticide daha önce Create. cshtml sayfa scafkatın bir bölümünü gösterir. İlk formu görüntülemek 
ve bir hata durumunda formu yeniden görüntülemek için sayfa oluşturma ve düzenleme sayfaları tarafından 
kullanılır. 


<form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<div class="form-group"> 

<label asp-for="Movie.Title" class="control-label"x/label> 

<input asp-for="Movie.Title" class="form-control" /> 

<span asp-validation-for="Movie.Title" class="text-danger"x/span> 
</div> 


Giriş etiketi Yardımcısı , dataaçıklamaların özniteliklerini kullanır ve istemci tarafında jQuery doğrulaması için 
gerekli HTML özniteliklerini üretir. Doğrulama etiketi Yardımcısı doğrulama hatalarını görüntüler. Daha fazla bilgi 
için bkz. doğrulama . 

Oluşturma ve düzenleme sayfalarında hiçbir doğrulama kuralı yoktur. Doğrulama kuralları ve hata dizeleri yalnızca 
Movie sınıfında belirtilmiştir. Bu doğrulama kuralları, Movie modelini düzenleyebilen Razor Pages otomatik olarak 
uygulanır. 

Doğrulama mantığının değişmesi gerektiğinde, yalnızca modelde yapılır. Doğrulama, uygulamanın tamamında 
tutarlı bir şekilde uygulanır (doğrulama mantığı tek bir yerde tanımlanır). Tek bir yerde doğrulama, kodun temiz 
kalmasına yardımcı olur ve bakım ve güncelleştirme işlemlerini kolaylaştırır. 

DataType özniteliklerini kullanma 

@No__t-0 sınıfını inceleyin. @No__t-0 ad alanı, yerleşik doğrulama öznitelikleri kümesine ek olarak biçimlendirme 











@No__t-0 öznitelikleri yalnızca görünüm altyapısının verileri biçimlendirmek için ipuçları sağlar (ve URL için <a> 
href ="maiito:EmailAddress.com" > gibi öznitelikleri sağlar). Verilerin biçimini doğrulamak için 
özniteliğini kullanın. @No__t-0 özniteliği, veritabanı iç türünden daha belirgin bir veri türü 
belirtmek için kullanılır. DataType öznitelikleri doğrulama öznitelikleri değildir. Örnek uygulamada, yalnızca tarih ve 
saat olmadan görüntülenir. 

@No__t-0 numaralandırması, tarih, saat, PhoneNumber, para birimi, Emaadresi ve daha fazlası gibi birçok veri türü 
sağlar. @No__t-0 özniteliği Ayrıca uygulamanın türe özgü özellikleri otomatik olarak sağlamasını da sağlayabilir. 
Örneğin, DataType.EmailAddress için mailto: bağlantısı oluşturulabilir. HTML5 'i destekleyen tarayıcılarda 
DataType.Date için bir tarih seçici sağlanmış olabilir. @No__t-0 öznitelikleri HTML 5 tarayıcıların kullandığı HTML 5 
data- (veri Dash) özniteliklerini yayar.@No__t-0 öznitelikleri herhangi bir doğrulama sağlamaz. 

DataType.Date , görüntülenen tarihin biçimini belirtmiyor. Varsayılan olarak, veri alanı, sunucunun cuitureinfo 1 a 
göre varsayılan biçimlere göre görüntülenir. 

@No__t-0 veri ek açıklaması gereklidir, bu nedenle Entity Framework Core veritabanındaki para birimine Price ' i 
doğru şekilde eşleyebilir. Daha fazla bilgi için bkz. veri türleri. 

@No__t-0 özniteliği, açıkça tarih biçimini belirtmek için kullanılır: 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 
public DateTime ReleaseDate { get; set; } 

@No__t-0 ayarı, değer düzenlenmek üzere görüntülendiğinde biçimlendirmenin uygulanacağını belirtir. Bazı alanlar 
için bu davranışı istemiyor olabilirsiniz. Örneğin, para birimi değerlerinde, büyük olasılıkla düzenleme kullanıcı 
arabirimindeki para birimi sembolünü istemezsiniz. 

@No__t-0 özniteliği kendisi tarafından kullanılabilir, ancak genellikle DataType özniteliğini kullanmak iyi bir fikir 
olabilir. @No__t-0 özniteliği, verilerin semantiğini bir ekranda nasıl işleneceğini değil ve DisplayFormat ile elde 
olmadığınız avantajları sağlar: 

• Tarayıcı HTML5 özelliklerini etkinleştirebilir (örneğin, bir Takvim denetimini, yerel ayara uygun para birimi 
sembolünü, e-posta bağlantılarını vb. göstermek için) 

• Varsayılan olarak tarayıcı, verileri yerel ayarınızı temel alarak doğru biçimi kullanarak işleyebilir. 

• @No__t-0 özniteliği, ASP.NET Core çerçevesinin verileri işlemek için doğru alan şablonunu seçmesini 
sağlayabilir. Kendisi tarafından kullanılıyorsa DisplayFormat , dize şablonunu kullanır. 

Note:jöuery doğrulaması Range özniteliğiyle ve DateTime ile çalışmaz. Örneğin, aşağıdaki kod, tarih belirtilen 
aralıkta olduğunda bile her zaman bir istemci tarafı doğrulama hatası görüntüler: 

[Range(typeof(DateTime), "1/1/1966", "1/1/2020")] 

Modellerinizde sabit tarihleri derlemek genellikle iyi bir uygulamadır, bu nedenle Range özniteliği ve DateTime 
kullanılması önerilmez. 


ve e-posta için <a 
RegularExpression 


Aşağıdaki kod, öznitelikleri tek bir satırda birleştirmeyi gösterir: 



















public class Movie 

{ 

public int ID { get; set; } 

[StringLength(60, MinimumLength = 3)] 
public string Title { get; set; } 

[Display(Name = "Release Date"), DataType(DataType.Date)] 
public DateTime ReleaseDate { get; set; } 

[RegularExpression(@" A [A-Z]+[a-zA-Z \s-]*$"), Required, StringLength(30)] 

public stning Genne { get; set; } 

[Range(l, 100), DataType(DataType.Currency)] 

[Column(TypeName = "decimal(18, 2)")] 
public decimal Price { get; set; } 

[RegularExpression(@" A [A-Z]+[a-zA-Z0-9""'\s-]*$"), StringLength(5)] 
public stning Rating { get; set; } 


Razor Pages kullanmaya başlayın ve EF Core gelişmiş EF Core işlemlerini Razor Pages gösterir. 

Geçişleri Uygula 

Sınıfa uygulanan Dataek açıklamaları şemayı değiştirir.Örneğin, Title alanına uygulanan veri ek açıklamaları: 

[StringLength(60, MinimumLength = 3)] 

[Required] 

public string Title { get; set; } 


• Karakterleri 60 olarak sınırlandırır. 

• @No__t-0 değerine izin vermez. 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 
@No__t-0 tablosu şu anda aşağıdaki şemaya sahiptir: 


CREATE TABLE [dbo] 

.[Movie] ( 



[ID] 

INT 

IDENTITY (1, 1) NOT 

NULL, 

[Title] 

NVARCHAR (MAX) 

NULL, 


[ReleaseDate] 

DATETIME2 (7) 

NOT NULL, 


[Genre] 

NVARCHAR (MAX) 

NULL, 


[Price] 

DECİMAL (18, 2) 

NOT NULL, 


[Rating] 

NVARCHAR (MAX) 

NULL, 


CONSTRAINT [PK_Movie] PRIMARY 

); 

KEY CLUSTERED ([ID] 

ASC) 


Önceki şema değişiklikleri, EF 'in özel durum oluşturmasına neden olmaz. Ancak, şemanın modelle tutarlı olması 
için bir geçiş oluşturun. 


Araçlar menüsünde NuGet Paket Yöneticisi > Paket Yöneticisi konsolu 1 nu seçin. PMC 'de aşağıdaki komutları 
girin: 


Add-Migration New_DataAnnotations 
Update-Database 

yöntemlerini çalıştırır. @No__t-0 yöntemini inceleyin: 


Update-Database 

New_DataAnnotations 

sınıfının 

Up 







public partisi class New_DataAnnotations : Migration 

{ 

protected override void Up(MigrationBuilder migrationBuilder) 

{ 

migrationBuilder.AlterColumn<string>( 
name: "Title", 
table: "Movie", 
maxLength: 60, 
nullable: false, 
oldClrType: typeof(stning), 
oldNullable: true); 

migrationBuilden.AlterColumn<stning>( 
name: "Rating", 
table: "Movie", 
maxLength: 5, 
nullable: false, 
oldClrType: typeof(string), 
oldNullable: true); 

migrationBuilder.AlterColumn<string>( 
name: "Genre", 
table: "Movie", 
maxLength: 30, 
nullable: false, 
oldClrType: typeof(string), 
oldNullable: true); 

} 


Güncelleştirilmiş Movie tablosu aşağıdaki şemaya sahiptir: 


CREATE TABLE [dbo] 

.[Movie] ( 




[ID] 

INT 

IDENTITY (1, 1) NOT 

NULL, 

[Title] 

NVARCHAR (60) 

NOT 

NULL, 


[ReleaseDate] 

DATETIME2 (7) 

NOT 

NULL, 


[Genre] 

NVARCHAR (30) 

NOT 

NULL, 


[Price] 

DECIMAL (18, 2) 

NOT 

NULL, 


[Rating] 

NVARCHAR (5) 

NOT 

NULL, 


CONSTRAINT [PK_Movie] PRIMARY 

); 

KEY 

CLUSTERED ([ID] 

ASC) 


Azure'a Yayımlama 

Azure 'a dağıtma hakkında bilgi için bkz. öğretici: Azure 'DA SQL veritabanı ile ASP.NET Core uygulama oluşturma. 

Razor Pages için bu giriş tamamlanırken teşekkürler. Razor Pages kullanmaya başlayın ve Bu öğreticiye en uygun 
harika bir izleme EF Core. 

Ek kaynaklar 

• ASP.NET Core formlardaki etiket yardımcıları 

• ASP.NET Core Genelleştirme ve yerelleştirme 

• ASP.NET Core etiket yardımcıları 

• ASP.NET core'da Yazar etiket Yardımcıları 

• Bu öğreticinin YouTube sürümü 


ÖNCEKİ: YENİ BİR ALAN 


EKLEME 








ASPNET Core MVC ile bir web uygulaması oluşturma 

10.05.2019 • 2 minutes to read ı Edit Online 


Bu öğretici, ASP.NET Core MVC denetleyicileri ve görünümleri ile web geliştirme öğretir. ASP.NET Core web 
geliştirmeye yeni başladıysanız göz önünde bulundurun Razor sayfaları sürümü bu öğreticinin bir daha kolay bir 
başlangıç noktası sağlar. 

Öğretici serisinin aşağıdakileri içerir: 

1. Kullanmaya başlama 

2. Denetleyici ekleme 

3. Görünüm ekleme 

4. Model ekleme 

5. SQL Server LocalDB ile çalışma 

6. Denetleyici metotları ve görünümleri 

7. Arama ekleme 

8. Yeni alan ekleme 

9. Doğrulama ekleme 

10. Details ve Delete metotlarını inceleme 







ASPNET Core MVC ile çalışmaya başlama 

7.11.2019 * 20 minutes to read ı Edit Online 


Rick Anderson tarafından 

Bu öğretici, ASP.NET Core MVC denetleyicileri ve görünümleri ile web geliştirme öğretir. ASP.NET Core vveb 
geliştirmeye yeni başladıysanız göz önünde bulundurun Razor sayfaları sürümü bu öğreticinin bir daha kolay bir 
başlangıç noktası sağlar. 

Bu öğretici, ASP.NET Core MVC vveb uygulaması oluşturma hakkında temel bilgileri öğretir. 

Uygulama, bir film başlıkları veritabanını yönetir.Aşağıdakilerin nasıl yapıldığını öğreneceksiniz: 

• Bir Web uygulaması oluşturun. 

• Bir modeli ekleyin ve yapı iskelesi yapın. 

• Bir veritabanıyla çalışın. 

• Arama ve doğrulama ekleyin. 

Sonunda, film verilerini yönetebilen ve görüntüleyebilen bir uygulamanız vardır. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini). 

Prerequisites 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• ASP.net ve Web geliştirme iş yüküyle Visual Studio 2019 

• .NET Core 3,0 SDK veya üzeri 

Web uygulaması oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Visual Studio 'da Yeni proje oluştur' u seçin. 

• ASP.NET Core Web uygulaması ' nı seçin ve ardından İleri' yi seçin. 






Search for project templates fi - 


Language 


Platform - 


Project type 


Create a new project 

Recent project templates 

O ASP.NET Core Web Application c# 

01 Class Library (.NET Standard) c# 



Console App (.NET Core) 

A project for creating a command-line application that can run on .NET Core on 
Windows, Linux and MacOS. 


C# Lınux macOS Windows Console 



ASP.NET Core Web Application 

Project templates for creating ASP.NET Core applicatıons for Wındows, Linux and 
macOS usıng .NET Core or .NET Framework. Create Razor Pages, MVC, Web API, and 
Sıngle Page (SPA) Applications. 


C* Windows Linux macOS Web 



WPF App (.NET Core) 

Windows Presentation Foundation Client application 
C* Wındows Desktop 


m 

<f> 


Class Library (.NET Standard) 

A project for creating a class library that targets .NET Standard. 

C* Android iOS Linux macOS Windows Library 

Azure Functions 

A template to create an Azure Function project. 

C* Azure Cloud 


Mobile App (Xamarin.Forms) 

□îll 


Next 


Projeyi Mvcfilmi olarak adlandırın ve Oluştur 1 u seçin. Kodu kopyaladığınızda, ad alanının eşleşmesi için, 
projeyi Mvcfilmi olarak adlandırmak önemlidir. 


Configure your new project 

ASP.NET Core Web Application c# wîndows unux macos web 

Project name 
MvcMovie 

Location 

j C:\Usefs\nck\source\repos 
Solutıon name o 

R1 Place solution and projea in the same directory 


Back 


Create 


Web uygulaması (Model-View-Controller) öğesini seçin ve ardından Oluştur 1 u seçin. 











X 


Create a new ASP.NET Core web application 


.NET Core 


ASP.NET Core 3.0 


^ Empty 

An empty project template for creating an ASP.NET Core application. This template does not have any content in it 


F>1 


A project template for creating an ASP.NET Core application with an cxample Controller for a RESTful HTTP service. 
This template can also be used for ASP.NET Core MVC Views and Controllers. 


Web Application 

A project template for creating an ASP.NET Core application with example ASP.NET Razor Pages content. 


Web Application (Model-View-Controller) 

A project template for creating an ASP.NET Core application with example ASP.NET Core MVC Vievvs and 
Controllers. This template can also be used for RESTful HTTP Services. 


|^[ Angular 

A project template for creating an ASP.NET Core application with Angular 


React.js 


Authentication 

No Authentication 

Change 


Advanced 

0 Configure for HÎTPS 
□ Enable Docker Support 
(Reguires Docker Desktop) 


Author: Microsoft 
Source: .NET Core 3.0.0 


Get additional project templates 


Back 


Create 


Visual Studio, az önce oluşturduğunuz MVC projesi için varsayılan şablonu kullandı. Şimdi bir proje adı girip birkaç 
seçenek belirleyerek, çalışan bir uygulamanız var. Bu, temel bir başlatıcı projem. 

Uygulamayı çalıştırma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 


Uygulamayı hata ayıklamasız modda çalıştırmak için CTRL-F5 ' i seçin. 
Visual Studio aşağıdaki iletişim kutusunu görüntüler: 


Microsoft Visual Studio 


X 


O 


This project ıs confıgured to use SSL To avoıd SSL wamıngs ın the browser you 
can choose to trust the self-signed certifıcate that IIS Express has generated. 

Would you lıke to trust the IIS Express SSL certificate? 

Leam More 

H Don't ask me agaın 


Yes 


No 


IIS Express SSL sertifikasına güveniyorsanız Evet 1 i seçin. 
Aşağıdaki iletişim kutusu görüntülenir: 



































Security VVarning 



You are about to install a certificate from a certification 
authority (CA) daiming to represent 


localhost 


Windows cannotvalidate thatthe certif icate is actuallyfrom 
'localhost'. You should confirm its origin by contacting 
'localhost'. The follovving number will assist you in this 
process: 

Thumbprint (shal): 35AAFB1F70EC5F89 C7180FBD 61AFE491 
94580874 


Warning: 

If you install this root certif icate, Windows will automatically 
trust any certif icate issued by this CA. Installing a certificate 
with an unconfirmed thumbprint is a security risk. If you dick 
'Yes' you acknowledge this risk. 

Do you want to install this certificate? 



Geliştirme sertifikasına güvenmeyi kabul ediyorsanız Evet 1 i seçin. 

• Visual Studio 11S Express başlar ve uygulamayı çalıştırır. Adres çubuğunda localhost :port# ve exampie.com 
gibi bir şey gösterilmediğine dikkat edin. Bunun nedeni, localhost yerel bilgisayarınız için Standart ana 
bilgisayar adıdır. Visual Studio bir Web projesi oluşturduğunda, Web sunucusu için rastgele bir bağlantı 
noktası kullanılır. 


• Uygulamayı CTRL + F5 (hata ayıklama modu) ile başlatmak, kod değişiklikleri yapmanıza, dosyayı 
kaydetmenize, tarayıcıyı yenilemanıza ve kod değişikliklerini görmenize olanak tanır. Birçok geliştirici, 
uygulamayı hızlı bir şekilde başlatmak ve değişiklikleri görüntülemek için hata ayıklama olmayan modu 
kullanmayı tercih eder. 


Hata ayıklama menü öğesinden uygulamayı hata ayıklama veya hata ayıklama olmayan modda 
başlatabilirsiniz: 


MvcMovie - Microsoft Visual Studio 

File Edit View Project Build Debug 


Windows 

► 

► 

Start Debugging 

F5 

> 

Start Without Debugging 

Ctrl* F5 

m 

Performance Profiler... 

Alt+ F2 

e® 

Attach to Process... 

Ctrl+Alt+P 


Other Debug Targets 

► 


Profiler 

► 

+ 

• 

Step Into 

Fil 

Ol 

• 

Step Över 

F10 


Toggle Breakpoint 

F9 


New Breakpoint 

► 


Delete Ali Breakpoints 

Ctri+Shrft+F9 

O 

Options... 


p 

MvcMovie Properties... 



ff JDuick Launch (Ctrl+Q) P _ □ X 

Team Tools Test Analyze Rick Anderson (ASP.NET) * ^ 


- ► IIS Express * Çj - 



• IIS Express düğmesini seçerek uygulamada hata ayıklaması yapabilirsiniz 






















*4 MvcMovie - Microsoft Visual Studio 


File Edit View Project Build Debug Team Tools Architecture 



Aşağıdaki görüntüde uygulama gösterilmektedir: 


| Home Page - MvcMovie X + 

C A https://localhost:5001 O. ğ : 

MvcMovie Home Privacy 

VVelcome 

Learn about building Web apps with ASP.NET Core. 


© 2019 - MvcMovie - Privacy 


• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Visual Studio Yardım 

• Hata ayıklamayı öğrenin C# kullanarak Visual Studio code 

• Visual Studio IDE'yi giriş 

Bu öğreticinin bir sonraki bölümünde, MVC hakkında bilgi edinirsiniz ve kod yazmaya başlayabilirsiniz. 


N E X T 


Bu öğretici, ASP.NET Core MVC denetleyicileri ve görünümleri ile vveb geliştirme öğretir. ASP.NET Core vveb 
geliştirmeye yeni başladıysanız göz önünde bulundurun Razor sayfaları sürümü bu öğreticinin bir daha kolay bir 
başlangıç noktası sağlar. 

Bu öğretici, ASP.NET Core MVC vveb uygulaması oluşturma hakkında temel bilgileri öğretir. 

Uygulama, bir film başlıkları veritabanını yönetir.Aşağıdakilerin nasıl yapıldığını öğreneceksiniz: 







• Bir Web uygulaması oluşturun. 

• Bir modeli ekleyin ve yapı iskelesi yapın. 

• Bir veritabanıyla çalışın. 

• Arama ve doğrulama ekleyin. 

Sonunda, film verilerini yönetebilen ve görüntüleyebilen bir uygulamanız vardır. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini). 

Prerequisites 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Visual Studio 2019 ile ASP.NET ve web geliştirme iş yükü 

• .NET core SDK 2.2 veya üzeri 


VVARNING 

Visual Studio 2017 kullanıyorsanız bkz dotnet/SDK'sı sorun #3124 Visual Studio ile çalışmayan .NET Core SDK sürümleri 
hakkında bilgi için. 


Web uygulaması oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Visual Studio 'da Yeni proje oluştur' u seçin. 

• ASP.NET Core Web uygulaması ' nı seçin ve ardından İleri' yi seçin. 




Search for project templates fi - 


Language 


Platform - 


Project type 


Create a new project 

Recent project templates 

O ASP.NET Core Web Application c# 

01 Class Library (.NET Standard) c# 



Console App (.NET Core) 

A project for creating a command-line application that can run on .NET Core on 
Windows, Linux and MacOS. 


C# Lınux macOS Windows Console 



ASP.NET Core Web Application 

Project templates for creating ASP.NET Core applicatıons for Wındows, Linux and 
macOS usıng .NET Core or .NET Framework. Create Razor Pages, MVC, Web API, and 
Sıngle Page (SPA) Applications. 


C* Windows Linux macOS Web 



WPF App (.NET Core) 

Windows Presentation Foundation Client application 
C* Wındows Desktop 


m 

<f> 


Class Library (.NET Standard) 

A project for creating a class library that targets .NET Standard. 

C* Android iOS Linux macOS Windows Library 

Azure Functions 

A template to create an Azure Function project. 

C* Azure Cloud 


Mobile App (Xamarin.Forms) 

□îll 


Next 


Projeyi Mvcfilmi olarak adlandırın ve Oluştur 1 u seçin. Kodu kopyaladığınızda, ad alanının eşleşmesi için, 
projeyi Mvcfilmi olarak adlandırmak önemlidir. 


Configure your new project 

ASP.NET Core Web Application c# wîndows unux macos web 

Project name 
MvcMovie 

Location 

j C:\Usefs\nck\source\repos 
Solutıon name o 

R1 Place solution and projea in the same directory 


Back 


Create 


Web uygulaması (Model-View-Controller) öğesini seçin ve ardından Oluştur 1 u seçin. 











Create a new ASP.NET Core Web Application 


.NET Core 


- ASP.NET Core 2.2 


sn 


Empty 


An empty project template for creating an ASP.NET Core application. This template does not have any 
content in it. 



A project template for creating an ASP.NET Core application with an example Controller for a RESTful HTTP 
service. This template can also be used forASP.NET Core MVC Vievvs and Controllers. 




Web Application 

A project template for creating an ASP.NET Core application with example ASP.NET Core Razor Pages 
content. 


[^^1 Web Application (Model-View-Controller) 

A project template for creating an ASP.NET Core application with example ASP.NET Core MVC Vievvs and 
Controllers. This template can also be used for RESTful HTTP Services. 


j Razor Class Library 

A project template for creating a Razor class library. 


^ Annıılar 

Get additional project templates 


Authentication 

No Authentication 

Change 


Advanced 

R1 Configure for HTTPS 
| Enable Docker Support 
(Reguires Docker Desktop) 


Author: Microsoft 
Source: SDK 2.2.104 


Back 


Create 


Visual Studio, az önce oluşturduğunuz MVC projesi için varsayılan şablonu kullandı. Şimdi bir proje adı girip birkaç 
seçenek belirleyerek, çalışan bir uygulamanız var. Bu, temel bir başlatıcı projem ve başlamak için iyi bir yerdir. 

Uygulamayı çalıştırma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 


Uygulamayı hata ayıklamasız modda çalıştırmak için CTRL-F5 ' i seçin. 
Visual Studio aşağıdaki iletişim kutusunu görüntüler: 


Microsoft Visual Studio 


X 


O 


This project ıs confıgured to use SSL To avoıd SSL wamıngs in the browser you 
can choose to trust the self-signed certifıcate that IIS Express has generated. 

Would you lıke to trust the IIS Express SSL certificate? 

Leam More 

H Don't ask me agaın 


Yes 


No 


IIS Express SSL sertifikasına güveniyorsanız Evet 1 i seçin. 
Aşağıdaki iletişim kutusu görüntülenir: 






















Security VVarning 



You are about to install a certificate from a certification 
authority (CA) daiming to represent 


localhost 


Windows cannotvalidate thatthe certif icate is actuallyfrom 
'localhost'. You should confirm its origin by contacting 
'localhost'. The follovving number will assist you in this 
process: 

Thumbprint (shal): 35AAFB1F70EC5F89 C7180FBD 61AFE491 
94580874 


Warning: 

If you install this root certif icate, Windows will automatically 
trust any certif icate issued by this CA. Installing a certificate 
with an unconfirmed thumbprint is a security risk. If you dick 
'Yes' you acknowledge this risk. 

Do you want to install this certificate? 



Geliştirme sertifikasına güvenmeyi kabul ediyorsanız Evet 1 i seçin. 

• Visual Studio 11S Express başlar ve uygulamayı çalıştırır. Adres çubuğunda localhost :port# ve exampie.com 
gibi bir şey gösterilmediğine dikkat edin. Bunun nedeni, localhost yerel bilgisayarınız için Standart ana 
bilgisayar adıdır. Visual Studio bir Web projesi oluşturduğunda, Web sunucusu için rastgele bir bağlantı 
noktası kullanılır. 


• Uygulamayı CTRL + F5 (hata ayıklama modu) ile başlatmak, kod değişiklikleri yapmanıza, dosyayı 
kaydetmenize, tarayıcıyı yenilemanıza ve kod değişikliklerini görmenize olanak tanır. Birçok geliştirici, 
uygulamayı hızlı bir şekilde başlatmak ve değişiklikleri görüntülemek için hata ayıklama olmayan modu 
kullanmayı tercih eder. 


Hata ayıklama menü öğesinden uygulamayı hata ayıklama veya hata ayıklama olmayan modda 
başlatabilirsiniz: 


MvcMovie - Microsoft Visual Studio 

File Edit View Project Build Debug 


Windows 

► 

► 

Start Debugging 

F5 

> 

Start Without Debugging 

Ctrl* F5 

m 

Performance Profiler... 

Alt+ F2 

e® 

Attach to Process... 

Ctrl+Alt+P 


Other Debug Targets 

► 


Profiler 

► 

+ 

• 

Step Into 

Fil 

Ol 

• 

Step Över 

F10 


Toggle Breakpoint 

F9 


New Breakpoint 

► 


Delete Ali Breakpoints 

Ctri+Shrft+F9 

O 

Options... 


p 

MvcMovie Properties... 



ff JDuick Launch (Ctrl+Q) P _ □ X 

Team Tools Test Analyze Rick Anderson (ASP.NET) * ^ 


- ► IIS Express * Çj - 



• IIS Express düğmesini seçerek uygulamada hata ayıklaması yapabilirsiniz 






















*4 MvcMovie - Microsoft Visual Studio 


File Edit View Project Build Debug Team Tools Architecture 



izlemeye izin vermek için kabul et 1 i seçin. Bu uygulama kişisel bilgileri izlemez. Şablon tarafından 
oluşturulan kod, genel veri koruma yönetmeliği (GDPR)buluşmanıza yardımcı olan varlıkları içerir. 

| Home Page - MvcMovie X + 

<- C A https://localhost:5001 
MvcMovie Home Privacy 

Use this space to summarize your privacy and cookie use policy. Learn More. Accept 

Welcome 

Learn about building Web apps with ASP.NET Core. 


© 2019 - MvcMovie - Privacy 


□ X 

e s 


Aşağıdaki görüntüde izlemeyi kabul ettikten sonra uygulama gösterilmektedir: 






| Home Page - MvcMovie X + 

C A https://local hoşt:5001 
MvcMovie Home Privacy 

VVelcome 

Learn about building Web apps with ASP.NET Core 


© 2019 - MvcMovie - Privacy 


□ X 

O. 0 : 


• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Visual Studio Yardım 

• Hata ayıklamayı öğrenin C# kullanarak Visual Studio code 

• Visual Studio IDE'yi giriş 

Bu öğreticinin bir sonraki bölümünde, MVC hakkında bilgi edinirsiniz ve kod yazmaya başlayabilirsiniz. 


N E X T 





ASPNET Core MVC uygulamasına denetleyici ekleme 

7.08.2019 * 21 minutes to read » Edit Online 


Tarafından RickAnderson 

Model-Vievv-Controller (MVC) mimari modeli, bir uygulamayı üç ana bileşene ayırır: Model, VIEW ve Controller. 
MVC deseninin daha kararlı ve geleneksel tek parçalı uygulamalardan güncelleştirilmesi daha kolay olan 
uygulamalar oluşturmanıza yardımcı olur. MVC tabanlı uygulamalar şunları içerir: 

• Aodels: Uygulamanın verilerini temsil eden sınıflar. Model sınıfları, bu veriler için iş kurallarını zorlamak 
üzere doğrulama mantığını kullanır. Genellikle, model nesneleri bir veritabanında model durumunu alır ve 
saklar. Bu öğreticide, bir Movie model bir veritabanından film verileri alır, bunu görünüme sağlar veya 
güncelleştirir. Güncelleştirilmiş veriler bir veritabanına yazılır. 

• Vıevvs: Görünümler, uygulamanın kullanıcı arabirimini (Ul) görüntüleyen bileşenlerdir.Genellikle, bu 
kullanıcı arabirimi model verilerini görüntüler. 

• Controlleyiciler: Tarayıcı isteklerini işleyen sınıflar. Model verileri alır ve yanıt döndüren çağrı görünümü 
şablonları. MVC uygulamasında, görünüm yalnızca bilgileri görüntüler; denetleyici, Kullanıcı girişini ve 
etkileşimini işler ve yanıtlar. Örneğin, denetleyici rota verilerini ve sorgu dizesi değerlerini işler ve bu 
değerleri modele geçirir. Model bu değerleri veritabanını sorgulamak için kullanabilir.Örneğin, 

https://iocaihost: 5001 /Home/Privacy Home (denetleyici) ve Privacy (ana denetleyicide çağrılacak eylem 
yöntemi) verilerinin yolunu içerir. https://iocaihost:500i/Movies/Edit/5 filmi film denetleyicisi kullanarak, İD 
= 5 olan filmi düzenleme isteği. Rota verileri öğreticide daha sonra açıklanmaktadır. 

MVC deseninin uygulamanın farklı yönlerini (Giriş mantığı, iş mantığı ve Kullanıcı arabirimi mantığı) ayıran 
uygulamalar oluşturmanıza yardımcı olur, bu öğeler arasında gevşek bir bağ sağlanır. Bu model, her bir mantık 
türünün uygulamada nerede bulunması gerektiğini belirtir. Kullanıcı arabirimi mantığı görünüme aittir.Giriş 
mantığı denetleyiciye aittir. İş mantığı modele aittir. Bu ayrım, bir uygulama oluşturduğunuzda karmaşıklığın 
yönetilmesine yardımcı olur, çünkü uygulamanın bir tek tarafında, başka bir kodu etkilemeden bir kez çalışmanıza 
olanak sağlar. Örneğin, iş mantığı koduna bağlı kalmadan görünüm kodu üzerinde çalışabilirsiniz. 

Bu kavramları, bu öğretici serisinde ele alınmaktadır ve bir film uygulaması oluşturmak için nasıl kullanacağınızı 
gösterir. MVC projesi denetleyiciler ve Görünümlehçn klasörler içerir. 

Denetleyici ekleme 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 


• Çözüm Gezgini, denetleyiciler öğesine sağ tıklayın > > denetleyicisi 















Solution Explorer Ç X 

'©• .? © “ 

Search Solution Explorer (Ctrl*;) P * 

>31 Solution MvcMovıe' (1 project) 
a MvcMovie 

a> Connected Services 
t> .V Dependencies 
> Properties 
P s® wwwroot 



53 View in Browser (Google Chrome) 
) Task Runner Explorer 
Configure External Tools._ 

Browse With... 


Ctrt+Shıft+W 


@1 

Controller... 



Add 


ü 

New Item... 

Ctrl*Shift+A 


Scope to This 



Existing Item... 

Shift+Alt*A 

S 

Nevv Solution Explorer View 



New Scaffolded Item... 


© 

View History... 


* _ 

New Folder 



Exclude From Project 



Container Orchestrator Support 


X, 

Cut 

Ctri+X 

ür 

Docker Support 


[5 

Copy 

Ctri+C 

& 

Client-Side Library... 


X 

Delete 

Del 


Class_ 


□ 

Rename 




Öpen Folder in File Explorer 
Properties 


Alt+Enter 


• Yapı İskelesi Ekle iletişim kutusunda, MVC denetleyicisi-boş seçeneğini belirleyin 



• Boş MVC denetleyicisi Ekle iletişim kutusunda, Merhaba vvorldcontroller yazın ve Ekle 1 yi seçin. 
Controllers/HelloVVorlcIControUer. cs içeriğini aşağıdakiler ile değiştirin: 















using Microsoft.AspNetCore.Mvc; 
using System. Text.Encodings.Web; 


namespace MvcMovie.Controllers 

{ 

pubüc class HelloWorldController : Controller 

{ 

// 

// GET: /HelloWorld/ 


pubüc string Index() 

{ 

return "This is my default action..."; 

} 


// 

// GET: /HelloWorld/Welcome/ 


pubüc string Welcome() 

{ 

return "This is the Welcome action method.. 

} 

} 

} 

• i 


Bir pubüc denetleyicideki her yöntem bir HTTP uç noktası olarak çağrılabilir. Yukarıdaki örnekte her iki yöntem de 
bir dize döndürür. Her yöntemden önceki açıklamalara göz önüne alın. 


HTTP uç noktası, https://iocaihost:500i/Heiioworid gibi Web uygulamasındaki bir hedeflenebilir URL 'sidir ve 
https kullanılan protokolü, Web sunucusunun ağ konumunu (TCP bağlantı noktası dahil): îocaihost :500ı ve hedef 
URI Heiioi/Jorid 'yi birleştirir. 

ilk açıklama bu, temel URL 'ye eklenerek /Heüoworid/ çağrılan bir http get yöntemi olduğunu belirtir, ikinci 
açıklama URL 'ye eklenerek /Heüoworid/weicome/ çağrılan bir http get yöntemini belirtir. Öğreticide daha sonra, 
verileri güncelleştiren Yöntemler oluşturmak http post için scafkatlama altyapısı kullanılır. 

Uygulamayı hata ayıklama modunda çalıştırın ve adres çubuğundaki yola "HelloVVorld" ekleyin. index Yöntemi bir 
dize döndürür. 


| https://localhost:5001/helloWorl X + 

C A https://localhost:5001/helloWorld O. ğ : 

This is my default action... 













MVC, gelen URL 'ye bağlı olarak denetleyici sınıflarını (ve içindeki eylem yöntemlerini) çağırır.MVC tarafından 
kullanılan varsayılan URL yönlendirme mantığı , çağrılacak kodu belirlemek için şöyle bir biçim kullanır: 


/[Controller]/[ActionName]/[Parameters] 


Yönlendirme biçimi configure Startup.es dosyasındaki yönteminde ayarlanır. 


app.UseEndpoints(endpoints => 

{ 

endpoints.MapControllerRoute( 
name: "default", 

pattern: "{controller=Home}/{action=Index}/{id ?}"); 


Uygulamaya gözatıp hiçbir URL kesimini sağlamadığınızda, varsayılan olarak "giriş" denetleyicisi ve yukarıda 
vurgulanan şablon satırında belirtilen "Dizin" yöntemi varsayılan olarak belirtilir. 


ilk URL segmenti, çalıştırılacak denetleyici sınıfını belirler.Bu localhost:{PORT}/Heiioworid nedenle 
HelloVVorldController sınıfıyla eşlenir.URL segmentinin ikinci bölümü, sınıfındaki Action metodunu belirler.Bu 
localhost:{PORT}/Heiioworid/index nedenle, HeliouoridControiler sınıfın index yönteminin çalışmasına neden 
olur. Yalnızca göz atmanızı localhost:{PORT}/Heiioworid index ve yönteme varsayılan olarak çağrıldığına dikkat 
edin. Bunun nedeni index , açıkça bir yöntem adı belirtilmemişse bir denetleyicide çağrılacak varsayılan yöntemdir. 
URL segmentinin ( id ) üçüncü bölümü rota verileri içindir. Rota verileri öğreticide daha sonra açıklanmaktadır. 


konumuna gözatın https://localhost:{PORT}/Heiioworid/weicome . Yöntemi çalışır ve dizeyi 


This is the l/Jelcome action method... 

döndürür. 

Welcome 

Bu URL için denetleyici 

HelloUorld 

, ve 

Welcome 


yöntemidir. URL 'nin bir [Parameters] bölümünü henüz kullanmadınız. 


| https://localhost:5001/helloWorl X + 

C i https://localhost:5001/helloWorld/welcome O. ğ : 

This is the Helcome action method... 


URL 'den denetleyiciye bazı parametre bilgilerini geçirmek için kodu değiştirin. Örneğin: 
/Heiioworid/weicome?name=Rick&numtimes=4 . weicome Yöntemi aşağıdaki kodda gösterildiği gibi iki parametre 
içerecek şekilde değiştirin. 


















// GET: /HelloWorld/Welcome/ 

// Requires using System. Text.Encodings.Web; 
public string Welcome(string name, int numTimes = 1) 

{ 

return HtmlEncoder.Default. Encode($"Hello {name}., NumTimes is: {numTimes}"); 

} 

Yukarıdaki kod: 

• Parametresi için C# hiçbir değer geçirilmemişse, numTimes parametrenin varsayılan olarak 1 ' e ait olduğunu 
belirtmek için isteğe bağlı parametre özelliğini kullanır. 

• Uygulamayı HtmlEncoder.Default.Encode kötü amaçlı girişten korumak için kullanır (yani JavaScript). 

• İçinde $"Heiio {name}, NumTimes is: {numTimes}" enterpolasyonlu dizeler kullanır. 

Uygulamayı çalıştırın ve şu konuma gidin: 

https://localhost:{P0RT}/HelloWorld/Welcome?name=Rick&numtimes=4 

(Bağlantı {port} noktası numaranız ile değiştirin.) URL'de ve name numtimes için farklı değerler deneyebilirsiniz. 
MVC model bağlama sistemi, adlandırılmış parametreleri adres çubuğundaki sorgu dizesinden yöntemdeki 
parametrelere otomatik olarak eşler. Daha fazla bilgi için bkz. model bağlama . 

- □ X 

| https://localhost:5001/helloWo' X + 

4- C A https://localhost:5001/helloWorld/welcome?name=Rick&numtimes=4 O, ğ • 

Hello Rick, NumTimes is: 4 


Yukarıdaki görüntüde, Parameters URL segmenti () kullanılmaz name ,ve numTimes parametreleri sorgu 
dizeleriolarak geçirilir. Yukarıdaki URL 'deki (soru işareti) bir ayırıcı ve sorgu dizeleri izler. ? & Karakter Sorgu 
dizelerini ayırır. 

lAieicome Yöntemini aşağıdaki kodla değiştirin: 

public string Welcome(string name, int ID = 1) 

{ 

return HtmlEncoder.Default.Encode($"Hello {name}, ID: {ID}"); 

} 

Uygulamayı çalıştırın ve aşağıdaki URL 'Yİ girin: https://localhost:{P0RT}/HelloWorld/Welcome/3?name=Rick 

Bu kez, üçüncü URL segmenti rota parametresiyle id eşleşti. Yöntemi, MapControiierRoute yöntemindeki URL 
şablonuyla id eşleşen bir parametre içerir. weicome Sondaki ? (içinde id?) id parametresinin isteğe bağlı 
olduğunu gösterir. 




















app.UseEndpoints(endpoints => 

{ 

endpoints.MapControllerRoute( 
name: "default", 

pattenn: "{contnoller=Home}/{action=Index}/{id?}"); 


Bu örneklerde, denetleyici MVC 'nin "VC" bölümünü (yani, VIEW ve C) çalışır. Denetleyici HTML 'i doğrudan 
döndürüyor. Genellikle, bu, kod ve bakım için çok daha fazla hale geldiği için denetleyicilerin doğrudan HTML 
döndürmesini istemezsiniz. Bunun yerine, genellikle HTML yanıtı oluşturmak için ayrı bir Razor görünümü şablon 
dosyası kullanırsınız. Bunu bir sonraki öğreticide yapabilirsiniz. 


ÖNCEKİ 


İleri 


Model-Vievv-Controller (MVC) mimari modeli, bir uygulamayı üç ana bileşene ayırır: Model, VIEW ve Controller. 

MVC deseninin daha kararlı ve geleneksel tek parçalı uygulamalardan güncelleştirilmesi daha kolay olan 

uygulamalar oluşturmanıza yardımcı olur. MVC tabanlı uygulamalar şunları içerir: 

• Aodels: Uygulamanın verilerini temsil eden sınıflar. Model sınıfları, bu veriler için iş kurallarını zorlamak 
üzere doğrulama mantığını kullanır. Genellikle, model nesneleri bir veritabanında model durumunu alır ve 
saklar. Bu öğreticide, bir Movie model bir veritabanından film verileri alır, bunu görünüme sağlar veya 
güncelleştirir. Güncelleştirilmiş veriler bir veritabanına yazılır. 

• Vıevvs: Görünümler, uygulamanın kullanıcı arabirimini (Ul) görüntüleyen bileşenlerdir.Genellikle, bu 
kullanıcı arabirimi model verilerini görüntüler. 

• Controlleyiciler: Tarayıcı isteklerini işleyen sınıflar. Model verileri alır ve yanıt döndüren çağrı görünümü 
şablonları. MVC uygulamasında, görünüm yalnızca bilgileri görüntüler; denetleyici, Kullanıcı girişini ve 
etkileşimini işler ve yanıtlar. Örneğin, denetleyici rota verilerini ve sorgu dizesi değerlerini işler ve bu 
değerleri modele geçirir. Model bu değerleri veritabanını sorgulamak için kullanabilir.Örneğin, 



= 5 olan filmi düzenleme isteği. Rota verileri öğreticide daha sonra açıklanmaktadır. 

MVC deseninin uygulamanın farklı yönlerini (Giriş mantığı, iş mantığı ve Kullanıcı arabirimi mantığı) ayıran 
uygulamalar oluşturmanıza yardımcı olur, bu öğeler arasında gevşek bir bağ sağlanır. Bu model, her bir mantık 
türünün uygulamada nerede bulunması gerektiğini belirtir. Kullanıcı arabirimi mantığı görünüme aittir.Giriş 
mantığı denetleyiciye aittir, iş mantığı modele aittir. Bu ayrım, bir uygulama oluşturduğunuzda karmaşıklığın 
yönetilmesine yardımcı olur, çünkü uygulamanın bir tek tarafında, başka bir kodu etkilemeden bir kez çalışmanıza 
olanak sağlar. Örneğin, iş mantığı koduna bağlı kalmadan görünüm kodu üzerinde çalışabilirsiniz. 

Bu kavramları, bu öğretici serisinde ele alınmaktadır ve bir film uygulaması oluşturmak için nasıl kullanacağınızı 
gösterir. MVC projesi denetleyiciler ve Görünümleriç in klasörler içerir. 

Denetleyici ekleme 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 


• Çözüm Gezgini, denetleyiciler öğesine sağ tıklayın > > denetleyicisi 
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• Yapı İskelesi Ekle iletişim kutusunda, MVC denetleyicisi-boş seçeneğini belirleyin 



• Boş MVC denetleyicisi Ekle iletişim kutusunda, Merhaba vvorldcontroller yazın ve Ekle 1 yi seçin. 
Controllers/HelloVVorlcIControUer. cs içeriğini aşağıdakiler ile değiştirin: 















using Microsoft.AspNetCore.Mvc; 
using System. Text.Encodings.Web; 


namespace MvcMovie.Controllers 

{ 

pubüc class HelloWorldController : Controller 

{ 

// 

// GET: /HelloWorld/ 


pubüc string Index() 

{ 

return "This is my default action..."; 

} 


// 

// GET: /HelloWorld/Welcome/ 


pubüc string Welcome() 

{ 

return "This is the Welcome action method.. 

} 

} 

} 

• i 


Bir pubüc denetleyicideki her yöntem bir HTTP uç noktası olarak çağrılabilir. Yukarıdaki örnekte her iki yöntem de 
bir dize döndürür. Her yöntemden önceki açıklamalara göz önüne alın. 


HTTP uç noktası, https://iocaihost:500i/Heiioworid gibi Web uygulamasındaki bir hedeflenebilir URL 'sidir ve 
https kullanılan protokolü, Web sunucusunun ağ konumunu (TCP bağlantı noktası dahil): îocaihost :500ı ve hedef 
URI Heiioi/Jorid 'yi birleştirir. 

ilk açıklama bu, temel URL 'ye eklenerek /Heüoworid/ çağrılan bir http get yöntemi olduğunu belirtir, ikinci 
açıklama URL 'ye eklenerek /Heüoworid/weicome/ çağrılan bir http get yöntemini belirtir. Öğreticide daha sonra, 
verileri güncelleştiren Yöntemler oluşturmak http post için scafkatlama altyapısı kullanılır. 

Uygulamayı hata ayıklama modunda çalıştırın ve adres çubuğundaki yola "HelloVVorld" ekleyin. index Yöntemi bir 
dize döndürür. 


| https://localhost:5001/helloWorl X + 

C A https://localhost:5001/helloWorld O. ğ : 

This is my default action... 













MVC, gelen URL 'ye bağlı olarak denetleyici sınıflarını (ve içindeki eylem yöntemlerini) çağırır.MVC tarafından 
kullanılan varsayılan URL yönlendirme mantığı , çağrılacak kodu belirlemek için şöyle bir biçim kullanır: 

/[Controller]/[ActionName]/[Parameters] 

Yönlendirme biçimi configure Startup.es dosyasındaki yönteminde ayarlanır. 

app.UseMvc(routes => 

{ 

routes.MapRoute( 

name: "default"., 

template: "{controller=Home}/{action=Index}/{id?}"); 

}); 

Uygulamaya gözatıp hiçbir URL kesimini sağlamadığınızda, varsayılan olarak "giriş" denetleyicisi ve yukarıda 
vurgulanan şablon satırında belirtilen "Dizin" yöntemi varsayılan olarak belirtilir. 

ilk URL segmenti, çalıştırılacak denetleyici sınıfını belirler.Bu localhost:{PORT}/Heiioworid nedenle, 

HeiioworidController sınıfıyla eşlenir. URL segmentinin ikinci bölümü, sınıfındaki Action metodunu belirler.Bu 
localhost:{PORT}/Heiioworid/index nedenle, HeliouoridControiler sınıfın index yönteminin çalışmasına neden 
olur. Yalnızca göz atmanızı localhost:{PORT}/Heiioworid index ve yönteme varsayılan olarak çağrıldığına dikkat 
edin. Bunun nedeni index , açıkça bir yöntem adı belirtilmemişse bir denetleyicide çağrılacak varsayılan yöntemdir. 
URL segmentinin ( id ) üçüncü bölümü rota verileri içindir. Rota verileri öğreticide daha sonra açıklanmaktadır. 

konumuna gözatın https://localhost:{PORT}/Heiioworid/weicome . Yöntemi çalışır ve dizeyi 


This is the l/Jelcome action method... 

döndürür. 

Welcome 

Bu URL için denetleyici 

HelloUorld 

, ve 

Welcome 

yöntemidir. URL 'nin bir 

[Parameters] 

bölümünü henüz kullanmadınız. 






URL 'den denetleyiciye bazı parametre bilgilerini geçirmek için kodu değiştirin. Örneğin: 
/Heiioworid/weicome?name=Rick&numtimes=4 . weicome Yöntemi aşağıdaki kodda gösterildiği gibi iki parametre 
içerecek şekilde değiştirin. 














// GET: /HelloWorld/Welcome/ 

// Requires using System. Text.Encodings.Web; 
public string Welcome(string name, int numTimes = 1) 

{ 

return HtmlEncoder.Default. Encode($"Hello {name}., NumTimes is: {numTimes}"); 

} 

Yukarıdaki kod: 

• Parametresi için C# hiçbir değer geçirilmemişse, numTimes parametrenin varsayılan olarak 1 ' e ait olduğunu 
belirtmek için isteğe bağlı parametre özelliğini kullanır. 

• Uygulamayı HtmlEncoder.Default.Encode kötü amaçlı girişten korumak için kullanır (yani JavaScript). 

• İçinde $"Heiio {name}, NumTimes is: {numTimes}" enterpolasyonlu dizeler kullanır. 

Uygulamayı çalıştırın ve şu konuma gidin: 

https://localhost:{P0RT}/HelloWorld/Welcome?name=Rick&numtimes=4 

(Bağlantı {port} noktası numaranız ile değiştirin.) URL'de ve name numtimes için farklı değerler deneyebilirsiniz. 
MVC model bağlama sistemi, adlandırılmış parametreleri adres çubuğundaki sorgu dizesinden yöntemdeki 
parametrelere otomatik olarak eşler. Daha fazla bilgi için bkz. model bağlama . 

- □ X 

| https://localhost:5001/helloWo' X + 

4- C A https://localhost:5001/helloWorld/welcome?name=Rick&numtimes=4 O, ğ • 

Hello Rick, NumTimes is: 4 


Yukarıdaki görüntüde, Parameters URL segmenti () kullanılmaz name ,ve numTimes parametreleri sorgu 
dizeleriolarak geçirilir. Yukarıdaki URL 'deki (soru işareti) bir ayırıcı ve sorgu dizeleri izler. ? & Karakter Sorgu 
dizelerini ayırır. 

lAieicome Yöntemini aşağıdaki kodla değiştirin: 

public string Welcome(string name, int ID = 1) 

{ 

return HtmlEncoder.Default.Encode($"Hello {name}, ID: {ID}"); 

} 

Uygulamayı çalıştırın ve aşağıdaki URL 'Yİ girin: https://localhost:{P0RT}/HelloWorld/Welcome/3?name=Rick 

Bu kez, üçüncü URL segmenti rota parametresiyle id eşleşti. Yöntemi, MapRoute yöntemindeki URL şablonuyla 
id eşleşen bir parametre içerir, ueicome Sondaki ? (içinde id? ) id parametresinin isteğe bağlı olduğunu 
gösterir. 

















app.UseMvc(routes => 

{ 

routes.MapRoute( 

name: "default", 

template: "{controller=Home}/{action=Index}/{id?}"); 

}); 


Bu örneklerde, denetleyici MVC 'nin "VC" bölümünü (yani, görünüm ve denetleyici çalışır) yapıyor. Denetleyici 
HTML 'i doğrudan döndürüyor. Genellikle, bu, kod ve bakım için çok daha fazla hale geldiği için denetleyicilerin 
doğrudan HTML döndürmesini istemezsiniz. Bunun yerine, genellikle HTML yanıtı oluşturmaya yardımcı olması 
için ayrı bir Razor görünümü şablon dosyası kullanırsınız. Bunu bir sonraki öğreticide yapabilirsiniz. 


ÖNCEKİ 


İleri 





ASPNET Core MVC uygulamasına görünüm ekleme 

23.11.2019 * 26 minutes to read ı Edit Online 


Tarafından RickAnderson 

Bu bölümde, bir istemciye HTML yanıtları oluşturma işlemini düzgün bir şekilde kapsüllemek için 
HeiioworidController sınıfını Razor görünümü dosyalarını kullanacak şekilde değiştirirsiniz. 

Razor kullanarak bir görünüm şablonu dosyası oluşturursunuz. Razor tabanlı görünüm şablonlarının . cshtml dosya 
uzantısı vardır. Bu kişiler ile C#HTML çıktısı oluşturmanın zarif bir yolunu sağlarlar. 

Şu anda index yöntemi, denetleyici sınıfında sabit kodlanmış bir ileti içeren bir dize döndürür. 

HeiioworidController sınıfında, index yöntemini aşağıdaki kodla değiştirin: 

public IActionResult Index() 

{ 

return View(); 

} 

Yukarıdaki kod denetleyicinin View yöntemini çağırır. HTML yanıtı oluşturmak için bir görünüm şablonu kullanır. 
Yukarıdaki index yöntemi gibi denetleyici Yöntemleri ( eylem yöntemleriolarak da bilinir), genellikle, string gibi 
bir tür değil, genellikle bir IActionResult (veya ActionResulttüretilen bir sınıf) döndürür. 

Görünüm ekleme 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Görünümler klasörüne sağ tıklayın ve ardından Yeni > klasör ekleyin ve HelloVVorld klasörünü adlandırın. 

• Görünümler/HelloWorld klasörüne sağ tıklayın ve ardından > yeni öğe ekleyin. 

• Yeni öğe Ekle-Mvcfilmi iletişim kutusunda 

o Sağ üst köşedeki arama kutusuna Görünüm girin 
o Razor görünümü seçin 
o lndex. cshtml adlı ad kutusu değerini saklayın. 


o Ekle 'yi seçin 
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Views/HeUoWorld/lndex. cshtml Razor görünüm dosyasının içeriğini aşağıdakiler ile değiştirin: 

@{ 

ViewData["Title"] = "Index"; 

} 

<h2>Index</h2> 

<p>Hello from our View Template!</p> 

https://test-cors.org sayfasına gidin. HeiioworidControiier index yöntemi çok bitmedi; Bu, yönteminin tarayıcıya 
yanıt işlemek için bir görünüm şablonu dosyası kullanması gerektiğini belirten return view(); ifadesini çalıştırdı. 

Bir görünüm şablonu dosya adı belirtilmediğinden, MVC varsayılan görünüm dosyasını kullanmaya göre varsayılan 
olarak ayarlanmış. Varsayılan görünüm dosyası yöntemiyle aynı ada sahiptir ( index ), bu nedenle 
/views/HelloWorld/lndex.cshtml kullanılır. Aşağıdaki görüntüde "görünüm Şablonumuzdan Merhaba!" dizesi 
gösterilmektedir görünümde sabit kodlanmış. 

| lndex - MvcMovie X + 

C A https://localhost:5001/helloWorld 
MvcMovie Home Privacy 

lndex 

Hello from our Vievv Template! 

© 2019 - MvcMovie - Privacy 


□ X 

O. Ö : 























Görünümleri ve düzen sayfalarını değiştirme 

Menü bağlantılarını (Mvcmovie, Homeve Gizlilik) seçin. Her sayfada aynı menü düzeni gösterilir. Menü düzeni 
Görünüımler/Shared/_Layout. cshtml dosyasında uygulanır. Görünümler/paylaşılan/_Layout. cshtml dosyasını açın. 

Düzen şablonları, sitenizin HTML kapsayıcı yerleşimini tek bir yerde belirtmenize ve sonra sitenizdeki birden çok 
sayfaya uygulamanıza olanak tanır. @RenderBody() satırını bulun. RenderBody , oluşturduğunuz tüm görünüme özgü 
sayfaların, Düzen sayfasında kaydırılan bir yer tutucudur. Örneğin, Gizlilik bağlantısını seçerseniz, 
Görünümler/Home/privacy. cshtml görünümü RenderBody yöntemi içinde işlenir. 

Düzen dosyasındaki başlık, altbilgi ve menü bağlantısını değiştirme 

Görünümler/paylaşılan/_Layout. cshtml dosyasının içeriğini aşağıdaki biçimlendirme ile değiştirin. Değişiklikler 
vurgulanır: 








<!DOCTYPE html> 

<html lang="en"> 

<head> 

<meta charset="utf-8" /> 

<meta name="viewport" content="width=device-width., initial-scale=1.0" /> 

<title>@ViewData["Title"] - Movie App</title> 

<link rel="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.css" /> 

<link rel="stylesheet" href="~/css/site.css" /> 

</head> 

<body> 

<header> 

<nav class="navbar navbar-expand-sm navbar-toggleable-sm navbar-light bg-white border-bottom box-shadow 

mb-3"> 

<div class="container"> 

<a class="navbar-brand" asp-controller="Movies" asp-action="Index">Movie App</a> 

<button class="navbar-toggler" type="button" data-toggle="collapse" data-tanget=".navbar- 
collapse" aria-contnols="navbarSupportedContent" 

aria-expanded="false" aria-label="Toggle navigation"> 

<span class="navbar-toggler-icon"x/span> 

</button> 

<div class="navbar-collapse collapse d-sm-inline-flex flex-sm-row-reverse"> 

<ul class="navbar-nav flex-grow-l"> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-anea="" asp-controller="Home" asp- 

action="Index">Home</a> 

</li> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-anea="" asp-controllen="Home" asp- 

action="Privacy">Privacy</a> 

</li> 

</ul> 

</div> 

</div> 

</nav> 

</headen> 

<div class="container"> 

<main role="main" class="pb-3"> 

@RenderBody() 

</main> 

</div> 

<footer class="bonder-top footen text-muted"> 

<div class="container"> 

Scopy; 2019 - Movie App - <a asp-area="" asp-controller="Home" asp-action="Privacy">Privacy</a> 
</div> 

</footen> 

<script snc="~/lib/jquery/dist/jquer'y. js"x/script> 

<script snc="~/lib/bootstrap/dist/js/bootstrap.bundle.js"x/script> 

<script snc="~/js/site.js" asp-append-version="true"x/scnipt> 

@RenderSection("Scripts"j required: false) 

</body> 

</html> 


Yukarıdaki biçimlendirme aşağıdaki değişiklikleri yaptı: 

• MvcMovie Movie App İÇİ n 3 OİUŞUITI. 

• Tutturucu öğe 

<a class="navbar-brand" asp-controller="Movies" asp-action="Index">Movie App</a>''<a class="navbar-brand" 
asp-area="" asp-controller="Home" asp-action="Index">MvcMovie</a> 


Yukarıdaki biçimlendirmede, bu uygulama alankullandığından asp-area="" tutturucu etiketi Yardımcısı özniteliği ve 
öznitelik değeri atlandı. 

Not: Movies denetleyicisi uygulanmadı. Bu noktada, Movie App bağlantısı işlevsel değildir. 








Değişikliklerinizi kaydedin ve Gizlilik bağlantısını seçin. Tarayıcı sekmesindeki başlığın Gizlilik ilkesi yerine bir film 
uygulaması (Gizlilik ilkesi değil) nasıl görüntülediğini fark edin -MVC filmi: 


| Privacy Policy - Movie App x + 

C A https://localhost:5001/Home/Privacy O, ğ : 


Movie App Home Privacy 

Privacy Policy 

Use this page to detail your site's privacy policy. 


© 2019 - Movie App - Privacy 


Giriş bağlantısını seçin ve başlık ve bağlantı metninin film uygulamasmıda görüntülediğine dikkat edin. Düzen 
şablonunda değişikliği bir kez yapabildik ve sitedeki tüm sayfalar yeni bağlantı metnini ve yeni başlığı 
yansıtmaktadır. 

Views/_ViewStart. cshtml dosyasını inceleyin: 

@{ 

Layout = "_Layout"; 

} 

Views/_ViewStart. cshtml dosyası her bir görünüm için views/Shared/_Layout. cshtml dosyasını getirir. Layout 
özelliği, farklı bir düzen görünümü ayarlamak veya nuiı olarak ayarlamak için kullanılabilir; Bu nedenle hiçbir 
düzen dosyası kullanılmayacak. 

Views/HelloWorld/lndex. cshtml görünüm dosyasının başlığını ve <h 2 > öğesini değiştirin: 

@{ 

ViewData["Title"] = "Movie List"; 

} 

<h2>My Movie List</h2> 

<p>Hello from our View Template!</p> 

Başlık ve <h2> öğesi biraz farklıdır, bu sayede kodun hangi bitini görüntülemesini görebilirsiniz. 

yukarıdaki koddaki viewData["Title"] = "Movie List";, viewData sözlüğün Title özelliğini "film listesi" olarak 
ayarlar. Title özelliği, Düzen sayfasındaki <titie> HTML öğesinde kullanılır: 

<title>@ViewData["Title" ] - Movie App</title> 

Değişikliği kaydedin ve https://iocaihost:{PORT}/Heiioworid gidin. Tarayıcı başlığı, birincil başlık ve ikincil 
başlıkların değiştirildiğini unutmayın. (Tarayıcıda değişiklik görmüyorsanız, önbelleğe alınmış içeriği görüntülüyor 
olabilirsiniz. Sunucudan gelen yanıtı zorlamak için tarayıcınızda CTRL + F5 tuşlarına basın.) Tarayıcı başlığı, lndex. 


















cshtml görünüm şablonunda belirlediğimiz viewData["Titie"] ve düzen dosyasına eklenen ek "-film uygulaması" 
ile oluşturulur. 

Index. cshtml görünüm şablonundaki içerik views/Shared/_Layout. cshtml görünüm şablonuyla birleştirilir. 
Tarayıcıya tek bir HTM L yanıtı gönderilir. Düzen şablonları, bir uygulamadaki tüm sayfalara uygulanan değişiklikler 
yapmayı kolaylaştırır. Daha fazla bilgi için bkz. Düzen. 

| Movie List - Movie App X + 
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My Movie List 

Hello from our View Template! 


© 2019 - Movie App - Privacy 
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"Data" (Bu durumda "Görünümümüzden Merhaba!") çok az. ileti) sabit kodludur, ancak. MVC uygulamasında bir 
"V" (görünüm) var ve bir "C" (denetleyici) var, ancak henüz "M" (model) yok. 

Denetleyiciden görünüme veri geçirme 

Gelen URL isteğine yanıt olarak denetleyici eylemleri çağrılır.Bir denetleyici sınıfı, gelen tarayıcı isteklerini işleyen 
kodun yazıldığı yerdir. Denetleyici verileri bir veri kaynağından alır ve tarayıcıya ne tür bir yanıt gönderileceğini 
belirler. Görünüm şablonları bir denetleyiciden, tarayıcıya HTM L yanıtı oluşturmak ve biçimlendirmek için 
kullanılabilir. 

Bir görünüm şablonunun yanıt işlemesi için gereken verileri sağlamaktan denetleyiciler sorumludur. En iyi yöntem: 
Görünüm şablonları iş mantığı gerçekleştirmemelidir veya doğrudan bir veritabanıyla etkileşime girmemelidir. 
Bunun yerine, bir görünüm şablonu yalnızca denetleyici tarafından sunulan verilerle birlikte çalışmalıdır. Bu 
"kaygıları ayrımı", kodun temiz, test edilebilir ve sürdürülebilir kalmasına yardımcı olur. 

Şuanda, HeiioworidControiier sınıfındaki weicome yöntemi bir name ve id parametresi alır ve sonra değerleri 
doğrudan tarayıcıya çıkarır. Denetleyicinin bu yanıtı bir dize olarak işlemesini sağlamak yerine, denetleyiciyi bir 
görünüm şablonu kullanacak şekilde değiştirin. Görünüm şablonu dinamik bir yanıt üretir, bu, yanıtı oluşturmak için 
denetleyiciden görünüme uygun veri bitlerinin geçirilmesi gereken anlamına gelir. Bu, denetleyicinin görünüm 
şablonu tarafından daha sonra erişebileceği bir viewData sözlüğünde bulunan dinamik verileri (parametreler) 
yerleştirerek bunu yapın. 

HelloWorldController.cs' de, viewData sözlüğüne bir Message ve NumTimes değeri eklemek için ueicome yöntemini 
değiştirin. viewData sözlüğü dinamik bir nesnedir, yani herhangi bir tür kullanılabilir; viewData nesnenin içine bir 
öğe yerleştirene kadar tanımlanmış özellikleri yok. MVC modeli bağlama sistemi , adlandırılmış parametreleri ( 
name ve numTimes ), adres çubuğundaki sorgu dizesinden yöntemdeki parametrelere otomatik olarak eşler.Tüm 































HelloWorldController.cs dosyası şuna benzer: 


using Microsoft.AspNetCore.Mvc; 
using System. Text.Encodings.Web; 

namespace MvcMovie.Controllers 
{ 

public class HelloWorldController : Controller 
{ 

public IActionResult Index() 

{ 

return View(); 

} 

public IActionResult Welcome(string name, int numTimes = 1) 
{ 

ViewData["Message"] = "Hello " + name; 
ViewData["NumTimes"] = numTimes; 

return View(); 

} 

} 

} 


viewData Dictionary nesnesi görünüme geçirilecek verileri içerir. 

Görünümler/HeUoWorld/Welcome. cshtmladU bir hoş geldiniz görünüm şablonu oluşturun. 

Welcome. cshtml görünüm şablonunda "Hello" NumTimes görüntüleyen bir döngü oluşturacaksınız. 
Views/HelloWorld/Welcome. cshtml içeriğini aşağıdakiler ile değiştirin: 


@{ 

ViewData["Title"] = "Welcome"; 

} 

<h2>Welcome</h2> 

<ul> 

@for (int i = 0; i < (int)ViewData["NumTimes"]; i++) 
{ 

<li>@ViewData["Message"]</li> 

} 

</ul> 


Değişikliklerinizi kaydedin ve aşağıdaki URL 'y e gidin: 


https: //localhost: {P0RT}/HelloWorld/Welcome?name=Ricl<&numtimes=4 


Veriler URL 'den alınır ve MVC model Bağlayıcısı kullanılarak denetleyiciye geçirilir. Denetleyici, verileri bir 
viewData sözlüğüne paketler ve bu nesneyi görünüme geçirir. Daha sonra Görünüm, verileri tarayıcıda HTM L 
olarak işler. 
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Yukarıdaki örnekte viewData sözlüğü denetleyiciden bir görünüme veri geçirmek için kullanılmıştır. Öğreticide 
daha sonra bir görünüm modeli, bir denetleyicideki verileri bir görünüme geçirmek için kullanılır. Veri geçirme 
yaklaşımına yönelik görünüm modeli, viewData sözlük yaklaşımına göre genel olarak çok tercih edilir. Daha fazla 
bilgi için bkz. VievvBag, ViewData veya TempData kullanma . 

Sonraki öğreticide, bir film veritabanı oluşturulur. 


ÖNCEKİ ■ İLERİ 


Bu bölümde, bir istemciye HTML yanıtları oluşturma işlemini düzgün bir şekilde kapsüllemek için 
HeiioworidController sınıfını Razor görünümü dosyalarını kullanacak şekilde değiştirirsiniz. 

Razor kullanarak bir görünüm şablonu dosyası oluşturursunuz. Razor tabanlı görünüm şablonlarının . cshtml dosya 
uzantısı vardır. Bu kişiler ile C#HTML çıktısı oluşturmanın zarif bir yolunu sağlarlar. 

Şu anda index yöntemi, denetleyici sınıfında sabit kodlanmış bir ileti içeren bir dize döndürür. 

HeiioworidController sınıfında, index yöntemini aşağıdaki kodla değiştirin: 

public IActionResult Index() 

{ 

return View(); 

} 

Yukarıdaki kod denetleyicinin View yöntemini çağırır. HTML yanıtı oluşturmak için bir görünüm şablonu kullanır. 
Yukarıdaki index yöntemi gibi denetleyici Yöntemleri ( eylem yöntemleriolarak da bilinir), genellikle, string gibi 
bir tür değil, genellikle bir IActionResult (veya ActionResulttüretilen bir sınıf) döndürür. 

Görünüm ekleme 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Görünümler klasörüne sağ tıklayın ve ardından Yeni > klasör ekleyin ve HelloVVorld klasörünü adlandırın. 
























• Görünümler/HelloWorld klasörüne sağ tıklayın ve ardından > yeni öğe ekleyin. 


• Yeni öğe Ekle-Mvcfilmi iletişim kutusunda 

o Sağ üst köşedeki arama kutusuna Görünüm girin 
o Razor görünümü seçin 
o lndex. cshtml adlı ad kutusu değerini saklayın, 
o Ekle 'yi seçin 



Views/HelloWorld/lndex. cshtml Razor görünüm dosyasının içeriğini aşağıdakiler ile değiştirin: 

@{ 

ViewData["Title"] = "Index"; 

} 

<h2>Index</h2> 

<p>Hello from our View Template!</p> 

https://test-cors.org sayfasına gidin. HeiioworidControiier index yöntemi çok bitmedi; Bu, yönteminin tarayıcıya 
yanıt işlemek için bir görünüm şablonu dosyası kullanması gerektiğini belirten return view(); ifadesini çalıştırdı. 

Bir görünüm şablonu dosya adı belirtilmediğinden, MVC varsayılan görünüm dosyasını kullanmaya göre varsayılan 
olarak ayarlanmış. Varsayılan görünüm dosyası yöntemiyle aynı ada sahiptir ( index ), bu nedenle 
/views/HelloWorld/lndex.cshtml kullanılır. Aşağıdaki görüntüde "görünüm Şablonumuzdan Merhaba!" dizesi 
gösterilmektedir görünümde sabit kodlanmış. 
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Görünümleri ve düzen sayfalarını değiştirme 

Menü bağlantılarını (Mvcmovie, Homeve Gizlilik) seçin. Her sayfada aynı menü düzeni gösterilir. Menü düzeni 
Görünüımler/Shared/_Layout. cshtml dosyasında uygulanır. Görünümler/paylaşılan/_Layout. cshtml dosyasını açın. 

Düzen şablonları, sitenizin HTML kapsayıcı yerleşimini tek bir yerde belirtmenize ve sonra sitenizdeki birden çok 
sayfaya uygulamanıza olanak tanır. @RenderBody() satırını bulun. RenderBody , oluşturduğunuz tüm görünüme özgü 
sayfaların, Düzen sayfasında kaydırılan bir yer tutucudur. Örneğin, Gizlilik bağlantısını seçerseniz, 
Görünümler/Home/privacy. cshtml görünümü RenderBody yöntemi içinde işlenir. 

Düzen dosyasındaki başlık, altbilgi ve menü bağlantısını değiştirme 

• Başlık ve altbilgi öğelerinde MvcMovie Movie App olarak değiştirin. 

• Tutturucu Öğe <a class="navbar-brand" asp-area="" asp-controller="Home" asp-action="Index">MvcMovie</a> 

<a class="navbar-brand" asp-controller="Movies" asp-action="Index">Movie App</a> olarak değiştirin. 


Aşağıdaki biçimlendirme vurgulanan değişiklikleri göstermektedir: 

<!DOCTYPE html> 

<html> 

<head> 

<meta charset="utf-8" /> 

<meta name="viewport" content="width=device-width, initial-scale=1.0" /> 

<title>@ViewData["Title"] - Movie App</title> 

<environment include="Development"> 

clink rel="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.css" /> 

</environment> 

<environment exclude="Development"> 

<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter- 
bootstrap/4.1.3/css/bootstrap.min.css" 

asp-fallback-href="~/lib/bootstrap/dist/css/bootstrap.min.css" 

asp-fallback-test-class="sr-only" asp-fallback-test-property="position" asp-fallback-test- 
value="absolute" 

crossorigin="anonymous" 

integrity="sha256-eSilq2PG617g7ibl7yAaWMcrr5GrtohYChqibrV7PBE="/> 

</environment> 

clink rel="stylesheet" href="~/css/site.css" /> 

</head> 

<body> 

<header> 













<nav class="navbar navbar-expand-sm navbar-toggleable-sm navbar-light bg-white border-bottom box-shadow 

mb-3"> 

<div class="container"> 

<a class="navbar-brand" asp-controller="Movies" asp-action="Index">Movie App</a> 
cbutton class="navbar-toggler" type="button" data-toggle="collapse" data-target=".navbar- 
collapse" aria-controls="navbarSupportedContent" 

aria-expanded="false" aria-label="Toggle navigation"> 

<span class="navbar-toggler-icon"x/span> 

</button> 

<div class="navbar-collapse collapse d-sm-inline-flex flex-sm-row-reverse"> 

<ul class="navbar-nav flex-grow-l"> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-area="" asp-controller="Home" asp- 

action="Index">Home</a> 

</li> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-area="" asp-controller="Home" asp- 

action="Privacy">Privacy</a> 

</li> 

</ul> 

</div> 

</div> 

</nav> 

</header> 

<div class="container"> 

<partial name="_CookieConsentPantial" /> 

<main role="main" class="pb-3"> 

@RenderBody() 

</main> 

</div> 

<footer class="border-top footen text-muted"> 

<div class="container"> 

Scopy; 2019 - Movie App - <a asp-area="" asp-controller="Home" asp-actlon="Privacy">Privacy</a> 
</div> 

</footen> 

<environment include="Development"> 

<script src="~/lib/jquery/dist/jquery. js"x/script> 

<script snc="~/lib/bootstrap/dist/js/bootstrap. bundle. js"x/scnipt> 

</environment> 

<environment exclude="Development"> 

<script snc=" https://cdnjs.cloudflane.eom/ajax/llbs/jquery/3.3.l/jquery.mln. js" 
asp-fallback-src="~/lib/jquery/dist/jquery.min.js" 
asp-fallback-test="window.jQuery" 
crossorigin="anonymous" 

integrity="sha256-FgpCb/K3QlLNfOu91ta32o/NMZxltwRo8QtmkMRdAu8="> 

</script> 

<script src=" https://cdnjs.cloudflare.eom/ajax/llbs/twltter-bootstrap/4.l.3/js/bootstrap.bundle.min.js" 
asp-fallback-src="~/lib/bootstrap/dist/js/bootstrap.bundle.min.js" 
asp-fallback-test="window.jQuery && window.jQuery.fn && window.jQuery.fn.modal" 
crossorigin="anonymous" 

integrity="sha256-E/V4cWE4qvAe05M0hjtGtqDzPndR01LBk811/PR7CA4="> 

</script> 

</environment> 

<script src="~/js/site.js" asp-append-version="true"x/script> 

@RenderSection("Scripts"j required: false) 

</body> 

</html> 

Yukarıdaki biçimlendirmede, bu uygulama alankullandığından asp-area tutturucu etiketi yardımcı özniteliği 
atlandı. 

Not: Movies denetleyicisi uygulanmadı. Bu noktada, Movie App bağlantısı işlevsel değildir. 


Değişikliklerinizi kaydedin ve Gizlilik bağlantısını seçin. Tarayıcı sekmesindeki başlığın Gizlilik ilkesi yerine bir film 





uygulaması (Gizlilik ilkesi değil) nasıl görüntülediğini fark edin -MVC filmi: 
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© 2019 - Movie App - Privacy 


Giriş bağlantısını seçin ve başlık ve bağlantı metninin film uygulamasmıda görüntülediğine dikkat edin. Düzen 
şablonunda değişikliği bir kez yapabildik ve sitedeki tüm sayfalar yeni bağlantı metnini ve yeni başlığı 
yansıtmaktadır. 

Views/_ViewStart. cshtml dosyasını inceleyin: 

@{ 

Layout = "_Layout"; 

} 

Views/_ViewStart. cshtml dosyası her bir görünüm için v'ıews/Shared/_Layout. cshtml dosyasını getirir. Layout 
özelliği, farklı bir düzen görünümü ayarlamak veya nuiı olarak ayarlamak için kullanılabilir; Bu nedenle hiçbir 
düzen dosyası kullanılmayacak. 

Views/HelloWorld/lndex. cshtml görünüm dosyasının başlığını ve <h2> öğesini değiştirin: 

@{ 

ViewData["Title"] = "Movie List"; 

} 

<h2>My Movie List</h2> 

<p>Hello from our View Template!</p> 

Başlık ve <h2> öğesi biraz farklıdır, bu sayede kodun hangi bitini görüntülemesini görebilirsiniz. 

yukarıdaki koddaki viewData["Titie"] = "Movie List";, viewData sözlüğün Title özelliğini "film listesi" olarak 
ayarlar. Title özelliği, Düzen sayfasındaki <titie> HTML öğesinde kullanılır: 

<title>@ViewData["Title"] - Movie App</title> 

Değişikliği kaydedin ve https://iocaihost:{PORT}/Heiioworid gidin. Tarayıcı başlığı, birincil başlık ve ikincil 
başlıkların değiştirildiğini unutmayın. (Tarayıcıda değişiklik görmüyorsanız, önbelleğe alınmış içeriği görüntülüyor 
olabilirsiniz. Sunucudan gelen yanıtı zorlamak için tarayıcınızda CTRL + F 5 tuşlarına basın.) Tarayıcı başlığı, lndex. 
cshtml görünüm şablonunda belirlediğimiz viewData["Titie"] ve düzen dosyasına eklenen ek "-film uygulaması" 





















ile oluşturulur. 


Ayrıca, lndex. cshtml görünüm şablonundaki içeriğin Görünümler/paylaşdan/_Layout. cshtml görünüm şablonuyla 
nasıl birleştirildiğini ve tarayıcıya tek bir HTM L yanıtı gönderildiğini de unutmayın. Düzen şablonları, 
uygulamanızdaki tüm sayfalara uygulanan değişiklikler yapmayı gerçekten kolaylaştırır. Daha fazla bilgi için bkz. 
Düzen. 



"Data" (Bu durumda "Görünümümüzden Merhaba!") çok az. ileti) sabit kodludur, ancak. MVC uygulamasında bir 
"V" (görünüm) var ve bir "C" (denetleyici) var, ancak henüz "M" (model) yok. 

Denetleyiciden görünüme veri geçirme 

Gelen URL isteğine yanıt olarak denetleyici eylemleri çağrılır.Bir denetleyici sınıfı, gelen tarayıcı isteklerini işleyen 
kodun yazıldığı yerdir. Denetleyici verileri bir veri kaynağından alır ve tarayıcıya ne tür bir yanıt gönderileceğini 
belirler. Görünüm şablonları bir denetleyiciden, tarayıcıya HTM L yanıtı oluşturmak ve biçimlendirmek için 
kullanılabilir. 

Bir görünüm şablonunun yanıt işlemesi için gereken verileri sağlamaktan denetleyiciler sorumludur.En iyi yöntem: 
Görünüm şablonları iş mantığı gerçekleştirmemelidir veya doğrudan bir veritabanıyla etkileşime girmemelidir. 
Bunun yerine, bir görünüm şablonu yalnızca denetleyici tarafından sunulan verilerle birlikte çalışmalıdır. Bu 
"kaygıları ayrımı", kodun temiz, test edilebilir ve sürdürülebilir kalmasına yardımcı olur. 

Şuanda, HeiioworidControiier sınıfındaki weicome yöntemi bir name ve id parametresi alır ve sonra değerleri 
doğrudan tarayıcıya çıkarır. Denetleyicinin bu yanıtı bir dize olarak işlemesini sağlamak yerine, denetleyiciyi bir 
görünüm şablonu kullanacak şekilde değiştirin. Görünüm şablonu dinamik bir yanıt üretir, bu, yanıtı oluşturmak için 
denetleyiciden görünüme uygun veri bitlerinin geçirilmesi gereken anlamına gelir. Bu, denetleyicinin görünüm 
şablonu tarafından daha sonra erişebileceği bir viewData sözlüğünde bulunan dinamik verileri (parametreler) 
yerleştirerek bunu yapın. 

HelloWorldController.cs' de, viewData sözlüğüne bir Message ve NumTimes değeri eklemek için ueicome yöntemini 
değiştirin. viewData sözlüğü dinamik bir nesnedir, yani herhangi bir tür kullanılabilir; viewData nesnenin içine bir 
öğe yerleştirene kadar tanımlanmış özellikleri yok. MVC modeli bağlama sistemi , adlandırılmış parametreleri ( 
name ve numTimes ), adres çubuğundaki sorgu dizesinden yöntemdeki parametrelere otomatik olarak eşler.Tüm 






























HelloWorldController.cs dosyası şuna benzer: 


using Microsoft.AspNetCore.Mvc; 
using System. Text.Encodings.Web; 

namespace MvcMovie.Controllers 
{ 

public class HelloWorldController : Controller 
{ 

public IActionResult Index() 

{ 

return View(); 

} 

public IActionResult Welcome(string name, int numTimes = 1) 
{ 

ViewData["Message"] = "Hello " + name; 
ViewData["NumTimes"] = numTimes; 

return View(); 

} 

} 

} 


viewData Dictionary nesnesi görünüme geçirilecek verileri içerir. 

Görünümler/HeUoWorld/Welcome. cshtmladU bir hoş geldiniz görünüm şablonu oluşturun. 

Welcome. cshtml görünüm şablonunda "Hello" NumTimes görüntüleyen bir döngü oluşturacaksınız. 
Views/HelloWorld/Welcome. cshtml içeriğini aşağıdakiler ile değiştirin: 


@{ 

ViewData["Title"] = "Welcome"; 

} 

<h2>Welcome</h2> 

<ul> 

@for (int i = 0; i < (int)ViewData["NumTimes"]; i++) 
{ 

<li>@ViewData["Message"]</li> 

} 

</ul> 


Değişikliklerinizi kaydedin ve aşağıdaki URL 'y e gidin: 


https: //localhost: {P0RT}/HelloWorld/Welcome?name=Ricl<&numtimes=4 


Veriler URL 'den alınır ve MVC model Bağlayıcısı kullanılarak denetleyiciye geçirilir. Denetleyici, verileri bir 
viewData sözlüğüne paketler ve bu nesneyi görünüme geçirir. Daha sonra Görünüm, verileri tarayıcıda HTM L 
olarak işler. 
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Yukarıdaki örnekte viewData sözlüğü denetleyiciden bir görünüme veri geçirmek için kullanılmıştır. Öğreticide 
daha sonra bir görünüm modeli, bir denetleyicideki verileri bir görünüme geçirmek için kullanılır. Veri geçirme 
yaklaşımına yönelik görünüm modeli, viewData sözlük yaklaşımına göre genel olarak çok tercih edilir. Daha fazla 
bilgi için bkz. VievvBag, ViewData veya TempData kullanma . 

Sonraki öğreticide, bir film veritabanı oluşturulur. 


ÖNCEKİ ■ İLERİ 













ASPNET Core MVC uygulamasına model ekleme 

23.11.2019 * 43 minutes to read ı Edit Online 


Rick Anderson ve Tom Dykstra tarafından 

Bu bölümde, bir veritabanında film yönetmeye yönelik sınıflar eklersiniz. Bu sınıflar,dVC uygulamasının "dodel" 
parçası olacaktır. 

Bu sınıfları bir veritabanıyla çalışmak için Entity Framevvork Core (EF Core) ile birlikte kullanırsınız. EF Core, 
yazmanız gereken veri erişim kodunu kolaylaştıran bir nesne ilişkisel eşleme (ORM) çerçevesidir. 

Oluşturduğunuz model sınıfları, EF Core hiçbir bağımlılığı olmadığından, POCO sınıfları olarak bilinir ( PLain O). 
Yalnızca veritabanında depolanacak verilerin özelliklerini tanımlar. 

Bu öğreticide, önce model sınıflarını yazdığınızda EF Core veritabanını oluşturur.Burada kapsanmayan alternatif bir 
yaklaşım var olan bir veritabanından model sınıfları oluşturmaktır. Bu yaklaşım hakkında daha fazla bilgi için bkz. 

ASP.NET Core-var olan veritabanı. 

Veri modeli sınıfı ekleme 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

> sınıf eklemek > modeller klasörüne sağ tıklayın. Dosyayı Mov/e.csolarak adlandırın. 

Movie.cs dosyasını aşağıdaki kodla güncelleştirin: 

using System; 

using System.ComponentModel.DataAnnotations; 

namespace MvcMovie.Models 
{ 

public class Movie 
{ 

public int Id { get; set; } 
public stning Title { get; set; } 

[DataType(DataType.Date)] 
public DateTime ReleaseDate { get; set; } 
public stning Genre { get; set; } 
public decimal Price { get; set; } 

} 

} 

Movie sınıfı, birincil anahtar için veritabanı için gerekli olan bir id alanı içerir. 

ReleaseDate veri türü özniteliği verilerin türünü belirtir ( Date ). Bu öznitelikle: 

• Kullanıcının Tarih alanına saat bilgilerini girmesi gerekli değildir. 

• Zaman bilgisi değil yalnızca tarih görüntülenir. 

Veri açıklamaları sonraki bir öğreticide ele alınmıştır. 


NuGet paketleri Ekle 









• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 


Araçlar menüsünde NuGet Paket Yöneticisi > Paket Yöneticisi konsolu (PMC) öğesini seçin. 
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PMC 'de şu komutu çalıştırın: 

Install-Package Microsoft.EntityFrameworkCore.SqlServer 

Yukarıdaki komut, EF Core SQL Server sağlayıcısını ekler.Sağlayıcı paketi, EF Core paketini bir bağımlılık olarak 
yüklüyor. Ek paketler, öğreticinin sonraki bölümlerinde bulunan yapı iskelesi adımında otomatik olarak yüklenir. 

Veritabanı bağlamı sınıfı oluşturma 

Movie modeli için EF Core işlevselliği (oluşturma, okuma, güncelleştirme, silme) koordine etmek için bir veritabanı 
bağlamı sınıfı gerekir. Veritabanı bağlamı Microsoft. EntityFramevvorkCore. DbContext öğesinden türetilir ve veri 
modeline dahil edilecek varlıkları belirtir. 

Bir veri klasörü oluşturun. 

Aşağıdaki kodla bir Data/MvcMovieContext. cs dosyası ekleyin: 

using Microsoft.EntityFrameworkCore; 
using MvcMovie.Models; 

namespace MvcMovie.Data 
{ 

public class MvcMovieContext : DbContext 
{ 

public MvcMovieContext (DbContextOptions<MvcMovieContext> options) 

: base(options) 

{ 

} 

public DbSet<Movie> Movie { get; set; } 

} 

} 

Önceki kod, varlık kümesi için bir Dbset<filmi > özelliği oluşturur. Entity Framework terminolojisinde, bir varlık 
kümesini genellikle bir veritabanı tablosuna karşılık gelir. Bir varlık tablosunda bir satıra karşılık gelir. 







Veritabanı bağlamı Kaydet 

ASP.NET Core, bağımlılık ekleme (dı)ile oluşturulmuştur. Hizmetlerin (EF Core DB bağlamı gibi) uygulama 
başlatma sırasında Dİ ile kayıtlı olması gerekir. Bu hizmetler (örneğin, Razor sayfaları) gerektiren bileşenler bu 
hizmetler Oluşturucu parametresi üzerinden sağlanır. Bir DB bağlamı örneği alır Oluşturucu kodu öğreticinin 
ilerleyen bölümlerinde gösterilmektedir. Bu bölümde, veritabanı bağlamını dı kapsayıcısına kaydedersiniz. 

Aşağıdaki using deyimlerini Startup.csüst kısmına ekleyin: 

using MvcMovie.Data; 

using Microsoft.EntityFrameworkCore; 

Aşağıdaki Vurgulanan kodu startup.configureServices ekleyin: 


• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 


public void ConfigureServices(IServiceCollection Services) 
{ 

Services.AddControllersWithViews(); 


} 


Services.AddDbContext<MvcMovieContext>(options => 

options.UseSqlServer(Configuration.GetConnectionString("MvcMovieContext"))); 


Bağlantı dizesi adı için bağlam üzerinde bir yöntemi çağırarak geçirilen bir DbContextOptions nesne. Yerel 
geliştirme için AS P.N ET Core yapılandırma sistemi bağlantı dizesinden okur appsettings.json dosya. 

Veritabanı bağlantı dizesi Ekle 

AppSettings. JSON dosyasına bir bağlantı dizesi ekleyin: 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 


{ 

"Logging": { 

"LogLevel": { 

"Default": "Information ", 

"Microsoft": "l/Jarning", 

"Microsoft.Hosting.Lifetime": "Information" 

} 

b 

"AllowedHosts": "*", 

"ConnectionStrings": { 

"MvcMovieContext": "Server=(localdb)\\mssqllocaldb;Database=MvcMovieContext- 
l;Trusted_Connection=True;MultipleActiveResultSets=true" 

} 


Projeyi derleyici hatalarına yönelik bir denetim olarak derleyin. 

Yapı iskelesi film sayfalan 

Film modeli için oluşturma, okuma, güncelleştirme ve silme (CRUD) sayfaları üretmek için scafkatlama aracını 
kullanın. 







• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 


Çözüm Gezgini, denetleyiciler klasörüne sağ tıklayıp yeni > yapı iskelesi > öğesi ekleyin. 
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Yapı Ekle iletişim kutusunda, Entity Framevvork > Ekle ' yi kullanarak views ile MVC denetleyicisi ' ni seçin. 



Denetleyici Ekle iletişim kutusunu doldurun: 

• Model sınıfı: Film (mvcmovie. modeller) 

• Veri bağlamı sınıfı: mvcmoviecontext (mvcmovie. Data) 
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Controller name: MoviesController 


Cancel 


• Görünümler: Her seçeneğin varsayılan kısmını işaretli tut 

• Denetleyici adı: Varsayılan MoviesController tut 

• Ekle 'yi seçin 

Visual Studio şunları oluşturur: 

• Bir filmler denetleyicisi ( denetleyiciler/MoviesController. cs) 

• Razor oluşturma, silme, ayrıntılar, düzenleme ve dizin sayfaları için dosyalan görüntüleme 
( Görünümler/filmler/*. cshtml) 

Bu dosyaların otomatik olarak oluşturulması, Yapı is k e le s /ol ar ak bilinir. 

Veritabanı mevcut olmadığından, scafkatmış sayfalan henüz kullanamazsınız. Uygulamayı çalıştırır ve film 
uygulaması bağlantısına tıklarsanız, bir veritabanı açılamıyor veya böyle bir tablo yok: film hata iletisi. 

İlk geçiş 

Veritabanını oluşturmak için EF Core geçişleri özelliğini kullanın. Geçişler, veri modelinizle eşleşecek bir veritabanı 
oluşturmanıza ve güncelleştirmenize olanak sağlayan bir araç kümesidir. 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

Araçlar menüsünde NuGet Paket Yöneticisi > Paket Yöneticisi konsolu (PMC) öğesini seçin. 

PMC'de aşağıdaki komutları girin: 

Add-Migration InitialCreate 
Update-Database 

• Add-Migration InitialCreate : bir geçişler/{tim estamp) _lnitialCreate. cs geçiş dosyası oluşturuyor. 

InitialCreate bağımsız değişkeni geçiş adıdır. Herhangi bir ad kullanılabilir, ancak kurala göre, geçişi 

açıklayan bir ad seçilidir. Bu ilk geçiş olduğundan, oluşturulan sınıf veritabanı şemasını oluşturmak için kod 
içerir. Veritabanı şeması, MvcMovieContext sınıfında belirtilen modeli temel alır. 
































• update-Database : veritabanını, önceki komutun oluşturulduğu en son geçişe güncelleştirir. Bu komut, 
veritabanını oluşturan geçişler/{Time-damga} JnıtialCreate. cs dosyasında up yöntemini çalıştırır. 

Database Update komutu aşağıdaki uyarıyı üretir: 

' Movie ' varlık türündeki' Price ' ondalık sütunu için tür belirtilmedi. Bu, varsayılan duyarlık ve ölçeğe 
uygun olmadıkları takdirde değerlerin sessizce kesilmesine neden olur.' Hasccolumntype () 1 kullanarak 
tüm değerleri barındırabilecek SQL Server sütun türünü açıkça belirtin. 


Bu uyarıyı yoksayabilirsiniz, daha sonraki bir öğreticide düzeltilecektir. 

EF Core için PMC araçları hakkında daha fazla bilgi için bkz. Visual Studio 'da EF Core araçları başvurusu-PMC. 

Initialcreate sınıfı 

Geçişleri/ftimestamp}_lnitialCreate. cs geçiş dosyasını inceleyin: 

public partial class Initial : Migration 

{ 

protected override void Up(MigrationBuilder migrationBuilder) 

{ 

migrationBuilder.CreateTable( 
name: "Movie", 
columns: table => new 
{ 

Id = table.Column<int>(nullable: false) 

.Annotation("SqlServer:ValueGenerationStrategy", 

SqlServerValueGenerationStrategy.IdentityColumn), 

Title = table.Column<string>(nullable: true), 

ReleaseDate = table.Column<DateTime>(nullable: false), 

Genre = table.Column<string>(nullable: true), 

Price = table.Column<decimal>(nullable: false) 

}, 

constraints: table => 

{ 

table.PrimaryKey("PK_Movie", x => x.Id); 

}); 

} 

protected override void Down(MigrationBuilder migrationBuilder) 

{ 

migrationBuilder.DropTable( 
name: "Movie"); 

} 

} 

up yöntemi, film tablosunu oluşturur ve id birincil anahtar olarak yapılandırır. Down yöntemi, up geçişi 
tarafından yapılan şema değişikliklerini geri alır. 

Uygulamayı test etme 

• Uygulamayı çalıştırın ve film uygulaması bağlantısına tıklayın. 

Aşağıdakilerden birine benzer bir özel durum alırsanız: 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 


SqlException: Cannot öpen database "MvcMovieContext-l" requested by the login. The login failed. 








Muhtemelen geçişler adımınıkaçırdınız. 

• Oluştur sayfasını test edin. Veri girin ve gönderebilirsiniz. 


NOTE 

Ondalık virgül kullanımı girmeniz mümkün olmayabilir Price alan. Desteklemek için jQuery doğrulama virgül İngilizce 
olmayan yerel bir ondalık noktasının ve ABD İngilizce olmayan tarih biçimleri, uygulamayı Eğer gerekir. 
Genelleştirme hakkında yönergeler için bkz. bu GitHub sorunu. 


• Düzenleme, Ayrıntılarve silme sayfalarını test edin. 

Denetleyiciye bağımlılık ekleme 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

Controllers/MoviesController. cs dosyasını açın ve oluşturucuyu inceleyin: 

public class MoviesController : Controller 
{ 

private readonly MvcMovieContext _context; 

public MoviesController(MvcMovieContext context) 

{ 

_context = context; 

} 

Oluşturucu, veritabanı bağlamını ( MvcMovieContext ) denetleyiciye eklemek için bağımlılık ekleme işlemini kullanır. 
Her bir veritabanı bağlamı kullanılan CRUD denetleyici yöntemleri. 

Türü kesin belirlenmiş modeller ve @model anahtar sözcüğü 

Bu öğreticide daha önce, bir denetleyicinin viewData sözlüğünü kullanarak bir görünüme nasıl veri veya nesne 
geçirekullanabileceğinizi gördünüz. viewData sözlüğü bir görünüme bilgi geçirmek için uygun, geç bağlanan bir yol 
sağlayan dinamik bir nesnedir. 

MVC Ayrıca, kesin olarak belirlenmiş model nesnelerini bir görünüme geçirmeye olanak tanır. Bu kesin türü 
belirtilmiş yaklaşım derleme zamanı kodu denetimini sunar. Yapı iskelesi mekanizması, MoviesController sınıfı ve 
görünümleriyle bu yaklaşımı (türü kesin belirlenmiş bir modeli geçirerek) kullandı. 

Controllers/MoviesController. cs dosyasında oluşturulan Details yöntemini inceleyin: 














// GET: Movies/Details/5 

public async Task<IActionResult> Details(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var movie = await _context.Movie 

.FirstOrDefaultAsync(m => m.Id == id); 
if (movie == null) 

{ 

return NotFound(); 

} 

return View(movie); 

} 

id parametresi genellikle rota verileri olarak geçirilir. Örneğin https://iocaihost:500i/movies/detaiis/ı kümeler 

• movies denetleyicisine denetleyici (ilk URL segmenti). 

• details eylemi (ikinci URL segmenti). 

• Kimliği 1 1 e (son URL segmenti). 

Aşağıdaki gibi bir sorgu dizesiyle id de geçirebilirsiniz: 


https://localhost:5001/movies/details?id=l 


KİMLİK değeri sağlanmazsa id parametresi null yapılabilir birtür ( int? ) olarak tanımlanır. 

Bir lambda ifadesi , rota verileriyle veya sorgu dizesi değeriyle eşleşen film varlıklarını seçmek üzere 
FirstOrDefaultAsync ' A geçirilir. 

var movie = await _context.Movie 

.FirstOrDefaultAsync(m => m.Id == id); 

Bir film bulunursa, Movie modelinin bir örneği Details görünümüne geçirilir: 

return View(movie); 


Görünümler/f'dmler/ayrmtdar. cshtml dosyasının içeriğini inceleyin: 










@model MvcMovie.Models.Movie 

@{ 

ViewData["Title"] = "Details"; 

} 

<hl>Details</hl> 

<div> 

<h4>Movie</h4> 

<hr /> 

<dl class="row"> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Title) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Title) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model = > model.ReleaseDate) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.ReleaseDate) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Genre) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Genre) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model = > model.Price) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Price) 

</dd> 

</dl> 

</div> 

<div> 

<a asp-action="Edit" asp-route-id="@Model.Id">Edit</a> | 

<a asp-action="Index">Back to List</a> 

</div> 

Görünüm dosyasının en üstündeki @modei ifade, görünümün beklediği nesne türünü belirtir. Film denetleyicisi 
oluşturulduğunda, aşağıdaki @modei deyimleri eklenmiştir: 

@model MvcMovie.Models.Movie 

Bu @modei yönergesi, denetleyicinin görünüme geçirildiği filme erişimine izin verir. Model nesne kesin olarak 
belirlenmiş. Örneğin, details. cshtml görünümünde, kod her bir film alanını DisplayNameFor DisplayFor ve HTML 
yardımcılarını türü kesin belirlenmiş Model nesnesiyle geçirir, create ve Edit yöntemleri ve görünümleri bir 
Movie model nesnesi de iletir. 

Dizin, cshtml görünümünü ve film denetleyicisindeki index yöntemini inceleyin. List, view yöntemini 
çağırdığında kodun bir nesne nasıl oluşturduğunu fark edin. Kod, index eylem yönteminden bu Movies listesini 
görünüme geçirir: 























// GET: Movies 

public async Task<IActionResult> Index() 

{ 

return View(await _context.Movie.ToListAsync()); 

} 


Film denetleyicisi oluşturulduğunda, yapı iskelesi lndex. cshtml dosyasının en üstüne aşağıdaki 
içeriyordu: 

@model 

ifadesini 

@model IEnumerable<MvcMovie.Models.Movie> 


@modei yönergesi, kesin olarak belirlenmiş bir Model nesnesi kullanarak, denetleyicinin görünüme geçirildiği film 
listesine erişmenizi sağlar. Örneğin, lndex. cshtml görünümünde, kod kesin türü belirtilmiş Model nesnesi üzerinde 
foreach bir ifadesiyle filmlerle döngü yapılır: 









@model IEnumerable<MvcMovie.Models.Movie> 

@{ 

ViewData["Title"] = "Index"; 

} 

<hl>Index</hl> 

<P> 

<a asp-action="Create">Create New</a> 

</p> 

<table class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model = > model.Title) 

</th> 

<th> 

@Html.DisplayNameFor(model = > model.ReleaseDate) 

</th> 

<th> 

@Html.DisplayNameFor(model = > model.Genre) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Prlce) 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

(Şforeach (var item in Model) { 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.ReleaseDate) 

</td> 

<td> 

@Fltml.DisplayFor(modelItem => item.Genre) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Price) 

</td> 

<td> 

<a asp-action="Edit" asp-route-id="@item.Id">Edit</a> | 

<a asp-action="Details" asp-route-id="@item.Id">Details</a> | 

<a asp-action="Delete" asp-route-id="@item.Id">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 


Model nesne kesin olarak yazıldığı için (bir iEnumerabie<Movie> nesnesi olarak), döngüdeki her öğe Movie olarak 
yazılır. Diğer avantajların yanı sıra, kodu derleme zaman denetimini alacağınız anlamına gelir. 

Ek kaynaklar 

• Etiket Yardımcıları 

• Genelleştirme ve yerelleştirme 










ÖNCE BİR GORUNUM 
EKLEME 
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Veri modeli sınıfı ekleme 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

> sınıf eklemek > modeller klasörüne sağ tıklayın. Sınıf adı film. 

Aşağıdaki özellikleri Movie sınıfı: 

using System; 

using System.ComponentModel.DataAnnotations; 

namespace MvcMovie.Models 
{ 

public class Movie 
{ 

public int Id { get; set; } 
public string Title { get; set; } 

[DataType(DataType.Date)] 
public DateTime ReleaseDate { get; set; } 
public string Genre { get; set; } 
public decimal Price { get; set; } 

} 

} 

Movie Sınıfı içerir: 

• id Alanı ve veritabanı için birincil anahtarı gereklidir. 

• [DataType(DataType.Date) ] : DataType özniteliği veri türünü belirtir ( Date ). Bu öznitelik ile: 

o Kullanıcının tarih alanı saat bilgilerini girmek için gerekli değildir, 
o Yalnızca tarih görüntülenen, olmayan zaman bilgilerdir. 

DataAnnotations bir sonraki öğreticide ele alınmaktadır. 

Film modeli iskelesini 

Bu bölümde, film modeli iskele kurulmuş. Diğer bir deyişle, yapı iskelesi aracı sayfaları için oluşturma, okuma, 
güncelleştirme ve silme (CRUD) işlemlerine yönelik film modeli oluşturur. 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Çözüm Gezgini, denetleyiciler klasörüne sağ tıklayıp yeni > yapı iskelesi > öğesi ekleyin. 
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Yapı Ekle iletişim kutusunda, Entity Framevvork > Ekle ' yi kullanarak views ile MVC denetleyicisi ' ni seçin. 



Denetleyici Ekle iletişim kutusunu doldurun: 

• Model sınıfı: Film (mvcmovie. modeller) 

• Veri bağlamı sınıfı: + simgesini seçin ve varsayılan Mvcmovie. modeller. MvcMovieContext öğesini 
ekleyin 
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New data contexttype: 
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Controller name: 

MoviesController 








Add 


Cancel 



• Görünümler: Her seçeneğin varsayılan kısmını işaretli tut 

• Denetleyici adı: Varsayılan MoviesCorıtroller tut 

• Ekle 'yi seçin 

Add Controller 

Model class: Movie (MvcMovie.Models) 

Data context class: MvcMovie.Models.MvcMovieContext 

Views: 

k/| Generate views 

171 Reference script libraries 

171 Use a layout page: 


(Leave empty if it is set in a Razor_viewstartfile) 


Controller name: 


MoviesController 


Add 


X 


:0 




Cancel 


Visual Studio şunları oluşturur: 

• Entity Framevvork Core veritabanı bağlam sınıfı ( Data/MvcMovieContext. cs ) 

• Bir filmler denetleyicisi ( denetleyiciler/MoviesController. cs) 

• Razor oluşturma, silme, ayrıntılar, düzenleme ve dizin sayfaları için dosyaları görüntüleme 
( Görünümler/filmler/*. cshtml) 

Veritabanı bağlamı ve CRUD (oluşturma, okuma, güncelleştirme ve silme) eylem yöntemlerinin ve görünümlerin 
otomatik olarak oluşturulması, Yapı is k e le s (ol ar ak bilinir. 

Uygulamayı çalıştırır ve MVC filmi bağlantısına tıklarsanız aşağıdakine benzer bir hata alırsınız: 


• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 























































An unhandled exception occurred while Processing the request. 

SqlException: Cannot öpen database "MvcMovieContext-<GUID removed>" requested by the login. The login failed. 
Login failed for user ’Rick'. 

System.Data.SqlClient.SqlInternalConnectionTds..ctor(DbConnectionPoolIdentity identity, SqlConnectionString 

Veritabanını oluşturmanız ve bunu yapmak için EF Core geçişleri özelliğini kullanmanız gerekir. Geçişler veri 
modelinize uyan bir veritabanı oluşturmanıza ve veri modeliniz değiştiğinde veritabanı şemasını güncelleştirmenize 
olanak tanır. 


İlk geçiş 

Bu bölümde, aşağıdaki görevler tamamlanır: 

• Bir başlangıç geçiş ekleyin. 

• Veritabanı, ilk geçiş ile güncelleştirin. 


• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 


1. Araçlar menüsünde NuGet Paket Yöneticisi > Paket Yöneticisi konsolu (PMC) öğesini seçin. 


MvcMovie - Microsoft Visual Studio 
File Edit View Project Build Debug 
( E Extensions and Updates... 

T y Connectto Database... 

T 5j Connectto Server... 

Add SQL Server... 


Team Tools 


WCF Service Configuration Editör 
External Tools... 

Import and Export Settings... 
Customize... 

Options... 


Analyze Window 
- ► US Express 


SQL Server 

► 

Web Code Analysis 

► 

Code Snippets Manager... 

Ctrl+K, Ctrl+B 

Choose Toolbox Items... 

NuGet Package Manager 

► 



2. PMC'de aşağıdaki komutları girin: 

Add-Migration Initial 
Update-Database 

Add-Mignation Komut, ilk veritabanı şeması oluşturmak için kod oluşturur. 

Veritabanı şeması, MvcMovieContext sınıfında belirtilen modeli temel alır. ınitial bağımsız değişkeni geçiş 
adıdır. Herhangi bir ad kullanılabilir, ancak kurala göre, geçişi açıklayan bir ad kullanılır.Daha fazla bilgi için 
bkz. Öğretici: EF Core ile geçiş özelliğini kullanma-ASP.NET MVC. 

update-Database Komutu çalıştırmaları up yöntemi geçişleri/{zaman damgası} _lnitialCreate.cs dosyasını 
veritabanı oluşturur. 







Bağımlılık ekleme ile kayıtlı bağlamını İnceleme 

ASP.NET Core, bağımlılık ekleme (dı)ile oluşturulmuştur. Hizmetler (EF Core DB bağlamı gibi) uygulama başlatma 
sırasında dı ile kaydedilir. Bu hizmetler (örneğin, Razor sayfaları) gerektiren bileşenler bu hizmetler Oluşturucu 
parametresi üzerinden sağlanır. Bir DB bağlamı örneği alır Oluşturucu kodu öğreticinin ilerleyen bölümlerinde 
gösterilmektedir. 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

Scafkatlama aracı otomatik olarak bir DB bağlamı oluşturup dı kapsayıcısına kaydetti. 

Aşağıdaki startup.configureServices yöntemini inceleyin. Vurgulanan satırı iskele kurucu tarafından eklendi: 

public void ConfigureServices(ISer'viceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

// This lambda determines whether user consent for non-essential cookies 
// is needed for a given request. 
options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

Services.AddDbContext<MvcMovieContext>(options => 

options.UseSqlServer(Configuration.GetConnectionString("MvcMovieContext"))); 

} 

MvcMovieContext EF Core işlevleri (oluşturma, okuma, güncelleştirme, silme, vb.) için koordinatları Movie modeli. 
Veri bağlamı ( MvcMovieContext ) türetilir Microsoft.EntityFrameworkCore.DbContext. Veri bağlamı, veri modeline 
hangi varlıkların ekleneceğini belirtir: 

// Unused usings removed. 

using Microsoft. EntityFrameworkCore; 

using MvcMovie.Models; // Enables public DbSet<Movie> Movie 

namespace MvcMovie.Data 
{ 

public class MvcMovieContext : DbContext 
{ 

public MvcMovieContext (DbContextOptions<MvcMovieContext> options) 

: base(options) 

{ 

} 

public DbSet<Movie> Movie { get; set; } 

} 

} 

Önceki kod, varlık kümesi için bir Dbset<filmi > özelliği oluşturur. Entity Framevvork terminolojisinde, bir varlık 
kümesini genellikle bir veritabanı tablosuna karşılık gelir. Bir varlık tablosunda bir satıra karşılık gelir. 

Bağlantı dizesi adı için bağlam üzerinde bir yöntemi çağırarak geçirilen bir DbContextOptions nesne. Yerel 
geliştirme için AS P.N ET Core yapılandırma sistemi bağlantı dizesinden okur appsettings.json dosya. 

Uygulamayı test etme 

• Uygulamayı çalıştırın ve ekleme /Movies tarayıcıda URL'sine ( http://iocaihost:port/movies ). 







Aşağıdakine benzer bir veritabanı özel durumu alırsanız: 


SqlException: Cannot öpen database "MvcMovieContext-GLIID" requested by the login. The login failed. 
Login failed for user ’User-name’. 


Eksik geçişler adım. 

• Test Oluştur bağlantı. Veri girin ve gönderebilirsiniz. 

NOTE 

Ondalık virgül kullanımı girmeniz mümkün olmayabilir Price alan. Desteklemek için jQuery doğrulama virgül İngilizce 
olmayan yerel bir ondalık noktasının ve ABD İngilizce olmayan tarih biçimleri, uygulamayı Eğer gerekir. 
Genelleştirme hakkında yönergeler için bkz. bu GitHub sorunu. 


• Test Düzenle, ayrıntıları, ve Sil bağlantıları, 
stantup sınıfını inceleyin: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

// This lambda determines whether user consent for non-essential cookies 
// is needed for a given request. 
options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 


Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

Services.AddDbContext<MvcMovieContext>(options => 

options.UseSqlServer(Configuration.GetConnectionString("MvcMovieContext"))); 

} 

Önceki vurgulanan kod, bağımlılık ekleme kapsayıcısına eklenen film veritabanı bağlamını gösterir: 

• Services.AddDbContext<MvcMovieContext>(options => kullanılacak veritabanını ve bağlantı dizesini belirtir. 

• => lambda operatörü 

Controllers/MoviesControUer. cs dosyasını açın ve oluşturucuyu inceleyin: 

public class MoviesController : Controller 

{ 

private readonly MvcMovieContext _context; 

public MoviesController(MvcMovieContext context) 

{ 

_context = context; 

} 

Oluşturucu, veritabanı bağlamını ( MvcMovieContext ) denetleyiciye eklemek için bağımlılık ekleme işlemini kullanır. 
Her bir veritabanı bağlamı kullanılan CRUD denetleyici yöntemleri. 

Türü kesin belirlenmiş modeller ve @model anahtar sözcüğü 

Bu öğreticide daha önce, bir denetleyicinin viewData sözlüğünü kullanarak bir görünüme nasıl veri veya nesne 









geçirekullanabileceğinizi gördünüz. viewData sözlüğü bir görünüme bilgi geçirmek için uygun, geç bağlanan bir yol 
sağlayan dinamik bir nesnedir. 

MVC Ayrıca, kesin olarak belirlenmiş model nesnelerini bir görünüme geçirmeye olanak tanır. Bu kesin türü 
belirtilmiş yaklaşım, kodunuzun daha iyi derleme zaman denetimini sunar. Yapı iskelesi mekanizması, yöntem ve 
görünümleri oluştururken MoviesControiler sınıfı ve görünümleriyle bu yaklaşımı (türü kesin belirlenmiş bir model 
geçirme) kullanır. 

Controllers/MoviesController. cs dosyasında oluşturulan Details yöntemini inceleyin: 

// GET: Movies/Details/5 

public async Task<IActionResult> Details(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var movie = await _context.Movie 

.FirstOrDefaultAsync(m => m.Id == id); 
if (movie == null) 

{ 

return NotFound(); 

} 

return View(movie); 

} 

id parametresi genellikle rota verileri olarak geçirilir. Örneğin https://iocaihost:500i/movies/detaiis/ı kümeler: 

• movies denetleyicisine denetleyici (ilk URL segmenti). 

• details eylemi (ikinci URL segmenti). 

• Kimliği 1 ' e (son URL segmenti). 

Aşağıdaki gibi bir sorgu dizesiyle id de geçirebilirsiniz: 
https://localhost:5001/movies/details?id=l 

KİMLİK değeri sağlanmazsa id parametresi null yapılabilir birtür ( int? ) olarak tanımlanır. 

Bir lambda ifadesi , rota verileriyle veya sorgu dizesi değeriyle eşleşen film varlıklarını seçmek üzere 
FirstOrDefaultAsync 1 A geçirilir. 

var movie = await _context.Movie 

.FirstOrDefaultAsync(m => m.Id == id); 

Bir film bulunursa, Movie modelinin bir örneği Details görünümüne geçirilir: 

return View(movie); 


Görünümler/f'dmler/ayrmtdar. cshtml dosyasının içeriğini inceleyin: 

















@model MvcMovie.Models.Movie 

@{ 

ViewData["Title"] = "Details"; 

} 

<hl>Details</hl> 

<div> 

<h4>Movie</h4> 

<hr /> 

<dl class="row"> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Title) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Title) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model = > model.ReleaseDate) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.ReleaseDate) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Genre) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Genre) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model = > model.Price) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Price) 

</dd> 

</dl> 

</div> 

<div> 

<a asp-action="Edit" asp-route-id="@Model.Id">Edit</a> | 

<a asp-action="Index">Back to List</a> 

</div> 

Görünüm dosyasının üst kısmına bir @modei ifadesini ekleyerek, görünümün beklediği nesne türünü 
belirtebilirsiniz. Film denetleyicisini oluştururken, Ayrıntılar, cshtml dosyasının en üstüne aşağıdaki @modei 
deyimleri otomatik olarak eklenmiştir: 

@model MvcMovie.Models.Movie 

Bu @modei yönergesi, kesin olarak belirlenmiş bir Model nesnesi kullanarak denetleyicinin görünüme geçirildiği 
filme erişmenizi sağlar. Örneğin, details. cshtml görünümünde, kod her bir film alanını oisplayNameFor DisplayFor 
ve HTML yardımcılarını türü kesin belirlenmiş Model nesnesiyle geçirir, cneate ve Edit yöntemleri ve 
görünümleri bir Movie model nesnesi de iletir. 

Dizin, cshtml görünümünü ve film denetleyicisindeki index yöntemini inceleyin. List, view yöntemini 
çağırdığında kodun bir nesne nasıl oluşturduğunu fark edin. Kod, index eylem yönteminden bu Movies listesini 
görünüme geçirir: 
























// GET: Movies 

public async Task<IActionResult> Index() 

{ 

return View(await _context.Movie.ToListAsync()); 

} 


Film denetleyicisini oluştururken, yapı iskelesi lndex. cshtml dosyasının en üstüne aşağıdaki 

otomatik olarak dahil edin: 

(Şmodel 

ifadesini 

@model IEnumerable<MvcMovie.Models.Movie> 


@modei yönergesi, kesin olarak belirlenmiş bir Model nesnesi kullanarak, denetleyicinin görünüme geçirildiği film 
listesine erişmenizi sağlar. Örneğin, lndex. cshtml görünümünde, kod kesin türü belirtilmiş Model nesnesi üzerinde 
foreach bir ifadesiyle filmlerle döngü yapılır: 









@model IEnumerable<MvcMovie.Models.Movie> 

@{ 

ViewData["Title"] = "Index"; 

} 

<hl>Index</hl> 

<P> 

<a asp-action="Create">Create New</a> 

</p> 

<table class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model = > model.Title) 

</th> 

<th> 

@Html.DisplayNameFor(model = > model.ReleaseDate) 

</th> 

<th> 

@Html.DisplayNameFor(model = > model.Genre) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Prlce) 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

(Şforeach (var item in Model) { 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.ReleaseDate) 

</td> 

<td> 

@Fltml.DisplayFor(modelItem => item.Genre) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Price) 

</td> 

<td> 

<a asp-action="Edit" asp-route-id="@item.Id">Edit</a> | 

<a asp-action="Details" asp-route-id="@item.Id">Details</a> | 

<a asp-action="Delete" asp-route-id="@item.Id">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 


Model nesne kesin olarak yazıldığı için (bir iEnumerabie<Movie> nesnesi olarak), döngüdeki her öğe Movie olarak 
yazılır. Diğer avantajların yanı sıra, kodun derleme zaman denetimini alacağınız anlamına gelir: 

Ek kaynaklar 

• Etiket Yardımcıları 

• Genelleştirme ve yerelleştirme 
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ASPNET Core 'de SQL ile çalışma 

23.11.2019 • 14 minutes to read ı Edit Online 


Tarafından RickAnderson 

MvcMovieContext nesnesi veritabanına bağlanma ve Movie nesneleri veritabanı kayıtlarına eşleme görevini işler. 
Veritabanı bağlamı, Startup.es dosyasındaki configureServices yönteminde bağımlılık ekleme kapsayıcısına 
kaydedilir: 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 


public void ConfigureServices(IServiceCollection Services) 
{ 

Services.AddControllersWithViews(); 


} 


Services.AddDbContext<MvcMovieContext>(options => 

options.UseSqlServer(Configuration.GetConnectionString("MvcMovieContext"))); 


ASP.NET Core yapılandırma sistemi Connectionstring okur. Yerel geliştirme için, appSettings. JSON dosyasından 
bağlantı dizesini alır: 


"ConnectionStrings": { 

"MvcMovieContext": "Server=(localdb)\\mssqllocaldb;Database=MvcMovieContext- 
2;Trusted_Connection=TruejMultipleActiveResultSets=true" 

} 


Uygulama bir test veya üretim sunucusuna dağıtıldığında, bağlantı dizesini bir üretim SQL Server ayarlamak için 
bir ortam değişkeni kullanılabilir. Daha fazla bilgi için bkz. yapılandırma . 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 


SQL Server Express LocalDB 

LocalDB, program geliştirmeye yönelik SQL Server Express veritabanı altyapısının hafif bir sürümüdür. LocalDB, 
isteğe bağlı olarak başlar ve karmaşık yapılandırma olduğundan kullanıcı modunda çalışır. Varsayılan olarak, 
LocalDB veritabanı C:/Users/{User} dizininde, mdfdosyaları oluşturur. 


• Görünüm menüsünden SQL Server Nesne Gezgini (ssox) öğesini açın. 
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Movie tablo > görünüm tasarımcısına sağ tıklayın 


SQL Server Object Explorer * f X 

6 + i 


a gi SQL Server 

a Ş (localdb)\MSSQLLocalDB (SQL ! 
^ a Databases 

> H System Databases 
a |j§j MvcMovieContext-20613 
a Q Tables 

> 0 System Tables 

l> K External Tables 

0 H5 dbo._EFMİgratior 


> [===1 dbo.Movie 
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Data Comparison... 



Script As 
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View Code 
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View Designer 



View Permissions 
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View Data 


X 

Delete 

Del 
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Rename 
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dbo.Movie [Design] -o x| 

♦ Update Script File: dbo.Movie.sql 

Name Data Type 


İD 

Gen re 
Price 

ReleaseDate 

Title 


int 

nvarchar(MAX) 

decimal(18,2) 

datetime2f7) 

nvarchar(MAX) 


Allow Nulls 

□ 

0 

□ 

□ 

0 

□ 


Keys (1) 

PKJVtovie (Primary Key, Clustered: I 

Check Constraints (0) 
lndexes O) 

Foreign Keys (0) 

Triggers (0) 


CJ Design 

1 

2 

3 

4 

5 

e 

7 

8 
9 

100 % 


ti 


a T-SQL 


CREATE TABLE [dbo].[Movie] ( 

[ID] INT IDENTITY (1, 1) NOT NULL, 

[Genre] NVARCHAR (MAX) NULL, 

[Price] DECIHAL (18, 2) NOT NULL, 

[ReleaseDate] DATETIME2 (7) NOT NULL, 

[Title] NVARCHAR (MAX) NULL, 

CONSTRAINT [PK_Movie] PRİMARY KEY CLUSTERED ([ID] ASC) 

); 


• i 


mas 


Connection Ready 

(localdb)\MSSQLLocalDB 

REDMOND\riande 

aspnet5-MvcMovie-8f261... 


id yanındaki anahtar simgesine göz önünde edin. Varsayılan olarak, EF birincil anahtar id adlı bir özellik 
oluşturacak. 

• Movie tabloya sağ tıklayarak verileri görüntüleyin > 


SQL Server Object Explorer ’ f X 

6 *İ % 

4 yi SQL Server 

4 E (localdb)\MSSQLLocalDB (SQL! 
4 a Databases 

> ti System Databases 
4 ti MvcMovieContext-20613 
4 û Tables 

t> ■ System Tables 

t> M External Tables 

> 3B dbo._EFMİgratior 


P liiil dbo.Movie 























^ MvcMovie- Microsoft V... ^ & CMckLaunch (Ctrl+O) fi _ n x 

File Edit View Project Build Debug Team SQL Tools rick » ^ 

Architecture Test Analyze Window Help 

ÜP ► IIS Express - _ |*| [#j _ 


dbo.Movie [Data] -o X 


c 

►- 

t? 

► MaxRows: 1000 

- 

u n 



İD 

Genre 

Price 

ReleaseDate 

Title 

► 

1 

Comedy 

1.99 

11/18/201512:0... 

When Harry Me... 


2 

Comedy 

2.99 

1/11/201612:00... 

Ghost Busters IV 


3 

Comedy 

3.99 

12/11/201512:0... 

Ghost Busters 7 

• 

NULL 

NULL 

NULL 

NULL 

NULL 


Error List Output Find Resufts 1 

3 Rows | Celi is Read Only 


Veritabanının çekirdeğini oluşturma 

Modeller klasöründe seedData adlı yeni bir sınıf oluşturun. Oluşturulan kodu aşağıdaki kodla değiştirin: 







using Microsoft.EntityFrameworkCore; 

using Microsoft.Extensions.DependencyInjection; 

using MvcMovie.Data; 

using System; 

using System.Linq; 

namespace MvcMovie.Models 

{ 

public static class SeedData 

{ 

public static void Initialize(IServiceProvider serviceProvider) 

{ 

using (var context = new MvcMovieContext( 
serviceProvider.GetRequiredService< 

DbContextOptions<MvcMovieContext>>())) 

{ 

// Look for any movies. 
if (context.Movie.Any()) 

{ 

return; // DB has been seeded 

} 

context.Movie.AddRange( 
new Movie 
{ 

Title = "When Harry Met Sally", 

ReleaseDate = DateTime.Parse("1989-2-12"), 

Genre = "Romantic Comedy", 

Price = 7.99M 

}, 

new Movie 

{ 

Title = "Ghostbusters ", 

ReleaseDate = DateTime.Parse("1984-3-13"), 

Genre = "Comedy", 

Price = 8.99M 

}, 

new Movie 

{ 

Title = "Ghostbusters 2", 

ReleaseDate = DateTime.Parse("1986-2-23"), 

Genre = "Comedy", 

Price = 9.99M 

}, 

new Movie 

{ 

Title = "Rio Bravo", 

ReleaseDate = DateTime.Parse("1959-4-15"), 

Genre = "Western", 

Price = 3.99M 

} 

); 

context.SaveChanges(); 

} 

} 

} 

} 


VERITABANıNDA herhangi bir film varsa, tohum başlatıcısı döner ve hiçbir film eklenmez. 



if (context.Movie.Any()) 

{ 

return; // DB has been seeded. 

} 


Tohum başlatıcısı ekleme 

Program.es içeriğini aşağıdaki kodla değiştirin: 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.Extensions.Dependencylnjection; 

using Microsoft.Extensions.Hosting; 

using Microsoft.Extensions.Logging; 

using MvcMovie.Data; 

using MvcMovie.Models; 

using System; 

namespace MvcMovie 
{ 

public elass Program 
{ 

public static void Main(string[] args) 

{ 

var hoşt = CreateHostBuilder(args).Build(); 

using (var scope = hoşt.Services.CreateScope()) 

{ 

var Services = scope.ServiceProvider; 

try 

{ 

SeedData.Initialize(Services); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<ILogger<Program>>(); 
logger.LogError(ex, "An error occurred seeding the DB."); 

} 

} 

host.Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 

} 

} 


Uygulamayı test etme 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

• VERITABANıNDAKI tüm kayıtları silin. Bunu, tarayıcıda veya SSOX 'ten silme bağlantılarıyla yapabilirsiniz. 

• Çekirdek yöntemin çalışması için uygulamayı başlamaya zorlayın ( startup sınıfında yöntemleri çağırın). 
Başlatmayı zorlamak için 11S Express durdurulup yeniden başlatılması gerekir. Bunu aşağıdaki 
yaklaşımlardan biriyle yapabilirsiniz: 




o Bildirim alanında 11S Express sistem tepsisi simgesine sağ tıklayın ve Çıkış veya siteyi durdur ' a 
dokunun 
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Browse Applications 

http://localhost1234/ 
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Show Ali Applications 

Exit 

Stop Site 
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□ 



o VS hata ayıklama modunda çalıştı rıyorsanız, hata ayıklama modunda çalıştırmak için F5 'e basın 
o VS hata ayıklama modunda çalıştı rıyorsanız, hata ayıklayıcıyı durdurun ve F5 tuşuna basın. 

Uygulama, sağlanan verileri gösterir. 


| lndex - Movie App X + 

4- -> 0 A https://localhost:5001/Movies O. ğ : 
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Gen re 
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Ghostbusters 
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8.99 
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Edit | Details | Delete 
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MvcMovieContext nesnesi veritabanına bağlanma ve Movie nesneleri veritabanı kayıtlarına eşleme görevini işler. 
Veritabanı bağlamı, Startup.es dosyasındaki configureServices yönteminde bağımlılık ekleme kapsayıcısına 
kaydedilir: 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

// This lambda determines whether user consent for non-essential cookies 
// is needed for a given request. 
options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

Services.AddDbContext<MvcMovieContext>(options => 

options.UseSqlServer(Configuration.GetConnectionString("MvcMovieContext"))); 

} 

ASP.NET Core yapılandırma sistemi Connectionstring okur. Yerel geliştirme için, appSett'ıngs. JSON dosyasından 
bağlantı dizesini alır: 

"ConnectionStrings": { 

"MvcMovieContext": "Server=(localdb)\\mssqllocaldb;Database=MvcMovieContext- 
2;Trusted_Connection=True;MultipleActiveResultSets=true" 

} 


Uygulamayı bir test veya üretim sunucusuna dağıtırken, bağlantı dizesini gerçek bir SQL Server ayarlamak için bir 
ortam değişkeni veya başka bir yaklaşım kullanabilirsiniz. Daha fazla bilgi için bkz. yapılandırma . 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

SQL Server Express LocalDB 

LocalDB, program geliştirmeye yönelik SQL Server Express veritabanı altyapısının hafif bir sürümüdür. LocalDB, 
isteğe bağlı olarak başlar ve karmaşık yapılandırma olduğundan kullanıcı modunda çalışır. Varsayılan olarak, 
LocalDB veritabanı C:/Users/{User} dizininde. mdf dosyaları oluşturur. 

• Görünüm menüsünden SQL Server Nesne Gezgini (ssox) öğesini açın. 
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♦ Update Script File: dbo.Movie.sql 
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a T-SQL 


CREATE TABLE [dbo].[Movie] ( 

[ID] INT IDENTITY (1, 1) NOT NULL, 

[Genre] NVARCHAR (MAX) NULL, 

[Price] DECIHAL (18, 2) NOT NULL, 

[ReleaseDate] DATETIME2 (7) NOT NULL, 

[Title] NVARCHAR (MAX) NULL, 

CONSTRAINT [PK_Movie] PRİMARY KEY CLUSTERED ([ID] ASC) 

); 
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id yanındaki anahtar simgesine göz önünde edin. Varsayılan olarak, EF birincil anahtar id adlı bir özellik 
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Veritabanının çekirdeğini oluşturma 

Modeller klasöründe seedData adlı yeni bir sınıf oluşturun. Oluşturulan kodu aşağıdaki kodla değiştirin: 







using Microsoft.EntityFrameworkCore; 
using Microsoft.Extensions.DependencyInjection; 
using System; 
using System.Linq; 

namespace MvcMovie.Models 

{ 

public static class SeedData 

{ 

public static void Initialize(IServiceProvider serviceProvider) 

{ 

using (var context = new MvcMovieContext( 
serviceProvider.GetRequiredService< 

DbContextOptions<MvcMovieContext>>())) 

{ 

// Look for any movies. 
if (context.Movie.Any()) 

{ 

return; // DB has been seeded 

} 

context.Movie.AddRange( 
new Movie 
{ 

Title = "When Harry Met Sally", 

ReleaseDate = DateTime.Parse("1989-2-12"), 

Genre = "Romantic Comedy", 

Price = 7.99M 

b 

new Movie 

{ 

Title = "Ghostbusters ", 

ReleaseDate = DateTime.Parse("1984-3-13"), 

Genre = "Comedy", 

Price = 8.99M 

b 

new Movie 

{ 

Title = "Ghostbusters 2", 

ReleaseDate = DateTime.Parse("1986-2-23"), 

Genre = "Comedy", 

Price = 9.99M 

b 

new Movie 

{ 

Title = "Rio Bravo", 

ReleaseDate = DateTime.Parse("1959-4-15"), 

Genre = "Western", 

Price = 3.99M 

} 

)J 

context.SaveChanges(); 

} 

} 

} 

} 


VERITABANıNDA herhangi bir film varsa, tohum başlatıcısı döner ve hiçbir film eklenmez. 



if (context.Movie.Any()) 

{ 

return; // DB has been seeded. 

} 


Tohum başlatıcısı ekleme 

Program.es içeriğini aşağıdaki kodla değiştirin: 


using Microsoft.AspNetCore; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.Extensions.Dependencylnjection; 

using Microsoft.Extensions.Logging; 

using System; 

using Microsoft.EntityFrameworkCore; 
using MvcMovie.Models; 
using MvcMovie; 

namespace MvcMovie 
{ 

public elass Program 
{ 

public static void Main(string[] args) 

{ 

var hoşt = CreateWebHostBuilder(args).Build(); 

using (var scope = hoşt.Services.CreateScope()) 
{ 

var Services = scope.ServiceProvider; 


try 

{ 

var context = Services.GetRequiredService<MvcMovieContext>(); 
context.Database.Migrate(); 

SeedData.Initialize(Services); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<ILogger<Program>>(); 
logger.LogError(ex J "An error occurred seeding the DB."); 

} 


host.Run(); 

} 


} 


} 


public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 
1/JebHost .CreateDefaultBuilder(args) 

.UseStartup<Startup>(); 


Uygulamayı test etme 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

• VERITABANıNDAKI tüm kayıtları silin. Bunu, tarayıcıda veya SSOX 'ten silme bağlantılarıyla yapabilirsiniz. 

• Çekirdek yöntemin çalışması için uygulamayı başlamaya zorlayın ( startup sınıfında yöntemleri çağırın). 
Başlatmayı zorlamak için 11S Express durdurulup yeniden başlatılması gerekir. Bunu aşağıdaki 
yaklaşımlardan biriyle yapabilirsiniz: 




o Bildirim alanında 11S Express sistem tepsisi simgesine sağ tıklayın ve Çıkış veya siteyi durdur ' a 
dokunun 
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o VS hata ayıklama modunda çalıştı rıyorsanız, hata ayıklama modunda çalıştırmak için F5 'e basın 
o VS hata ayıklama modunda çalıştı rıyorsanız, hata ayıklayıcıyı durdurun ve F5 tuşuna basın. 

Uygulama, sağlanan verileri gösterir. 
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Film uygulaması için iyi bir başlangıç sahibiz ancak sunu Örneğin, ideal olarak, değildir ReleaseDate iki kelimeye 
olmalıdır. 
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Açık Models/Movie.cs dosya ve aşağıda vurgulanan satırları ekleyin: 








using System; 

using System.ComponentModel.DataAnnotations; 
using System.ComponentModel.DataAnnotations.Schema; 

namespace MvcMovie.Models 

{ 

public class Movie 

{ 

public int Id { get; set; } 
public stning Title { get; set; } 

[Display(Name = "Release Date")] 
[DataType(DataType.Date) ] 
public DateTime ReleaseDate { get; set; } 
public stning Genre { get; set; } 

[Column(TypeName = "decimal(18, 2)")] 
public decimal Pnice { get; set; } 

} 

} 


Biz karşılarız DataAnnotations sonraki öğreticide. Görüntüleme öznitelik adı (Bu durumda "ReleaseDate" yerine 
"yayın tarihi") bir alan için görüntülenecek öğeleri belirtir. DataType öznitelik alanında depolanan saat bilgilerini 
görüntülenmediğini şekilde (tarih), veri türünü belirtir. 


[Coiumn(TypeName = "decimaitıs, 2)")] Veri ek açıklama, Entity Framework Core doğru şekilde eşleyebilirsiniz 
biçimde gereklidir Price veritabanında para birimi. Daha fazla bilgi için veri türleri. 

Gözat Movies denetleyicisi ve fare işaretçisini tutun bir Düzenle hedef URL'ye görmek için bağlantıyı. 


| lndex - Movie App X + 

□ X 

C A https://localhost:5001/Movies 

0. â İ 
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Düzenle, ayrıntıları, ve Sil bağlantıları Core MVC yer işareti etiketi Yardımcısı tarafından üretilen 
V ie w s/M o vi es/l n d ex. csh tm / d o s y a. 














<a asp-action="Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-action="Details" asp-route-id="@item.ID">Details</a> | 
<a asp-action="Delete" asp-route-id="@item.ID">Delete</a> 
</td> 

</tr> 


Etiket Yardımcıları, Razor dosyalarında HTML öğelerinin oluşturulmasına ve işlenmesine sunucu tarafı kodun 
katılmasını etkinleştir. Yukarıdaki kodda AnchorTagHelper dinamik olarak HTML oluşturan href denetleyici eylem 
yöntemi ve rota kimliğinden öznitelik değeri. Kullandığınız kaynağı görüntüle sık kullandığınız tarayıcıyı ya da 
kullanım oluşturulan biçimlendirme incelemek için geliştirici araçları. Oluşturulan HTML değerinin bir bölümü 
aşağıda gösterilmiştir: 

<td> 

<a href="/Movies/Edit/4"> Edit </a> | 

<a href="/Movies/Details/4"> Details </a> | 

<a href="/Movies/Delete/4"> Delete </a> 

</td> 


Biçim için geri çağırma yönlendirme kümesinde Startup.es dosyası: 


app.llseMvc(routes => 

{ 

routes.MapRoute( 

name: "default", 

template: "{controller=Home}/{action=Index}/{id?}")t 

}); 


ASP.NET Core çevirir https://iocaihost:500i/Movies/Edit/4 bir istek halinde Edit eylem yöntemi Movies 
denetleyicisi parametresiyle id 4. (Denetleyici olarak da bilinen eylem yöntemleri yöntemlerdir.) 


Etiket Yardımcıları AS P.N ET Core en popüler yeni özellikler biridir. Daha fazla bilgi için ek kaynaklar. 


Açık Movies denetleyicisi ve iki inceleyin Edit eylem yöntemleri. Aşağıdaki kodda gösterildiği http get Edit film 
getirir ve tarafından oluşturulan düzenleme formu dolduran yöntemi Edit.cshtml Razor dosya. 


// GET: Movies/Edit/5 

public async Task<IActionResult> Edit(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var movie = await _context.Movie.FindAsync(id); 
if (movie == null) 

{ 

return NotFound(); 

} 

return View(movie); 


Aşağıdaki kodda gösterildiği http post Edit gönderilen film değerleri işleyen yöntemi: 














// POST: Movies/Edit/5 

// To protect from overposting attacks, please enable the specific properties you want to bind to, for 
// more details see http://go.microsoft.com/fwlink/?LinkId=317598. 

[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Edit(int id, [Bind("IDjTitle,ReleaseDate,GenrejPrice")] Movie movie) 

{ 

if (id != movie.ID) 

{ 

return NotFound(); 

} 

if (ModelState.IsValid) 

{ 

try 

{ 

_context.Update(movie); 

await _context.SaveChangesAsync(); 

} 

catch (DbUpdateConcurrencyException) 

{ 

if (!MovieExists(movie.ID)) 

{ 

return NotFound(); 

} 

else 

{ 

throw; 

} 

} 

return RedirectToAction("Index"); 

} 

return View(movie); 

} 


// GET: Movies/Edit/5 

public async Task<IActionResult> Edit(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var movie = await _context.Movie.SingleOrDefaultAsync(m => m.ID == id); 
if (movie == null) 

{ 

return NotFound(); 

} 

return View(movie); 

} 


Aşağıdaki kodda gösterildiği http post Edit gönderilen film değerleri işleyen yöntemi: 




// POST: Movies/Edit/5 

// To protect from overposting attacks, please enable the specific properties you want to bind to, for 
// more details see http://go.microsoft.com/fwlink/?LinkId=317598. 

[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Edit(int id, [Bind("ID,Title,ReleaseDate,Genre,Price")] Movie movie) 

{ 

if (id != movie.ID) 

{ 

return NotFound(); 

} 

if (ModelState.IsValid) 

{ 

try 

{ 

_context.Update(movie); 

await _context.SaveChangesAsync(); 

} 

catch (DbUpdateConcurrencyException) 

{ 

if (!MovieExists(movie.ID)) 

{ 

return IMotFound(); 

} 

else 

{ 

throw; 

} 

} 

return RedirectToAction("Index"); 

} 

return View(movie); 

} 

[Bind] Özniteliktir karşı korumak için bir yol aşırı yayınlayarak. Özellikler yalnızca içermelidir [Bind] değiştirmek 
istediğiniz özniteliği. Daha fazla bilgi için denetleyicinizin atlayarak nakil korumak. Viewmodel'lar atlayarak önlemek 
için alternatif bir yaklaşım sağlar. 

ikinci fark Edit eylem yöntemine öncesinde [HttpPost] özniteliği. 





[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Edit(int id, [BindC'IDjTitlejReleaseDatejGenrejPrice")] Movie movie) 

{ 

if (id != movie.ID) 

{ 

return NotFound(); 

} 

if (ModelState.IsValid) 

{ 

try 

{ 

_context.Update(movie); 

await _context.SaveChangesAsync(); 

} 

catch (DbUpdateConcurrencyException) 

{ 

if (!MovieExists(movie.ID)) 

{ 

return NotFound(); 

} 

else 

{ 

throw; 

} 

} 

return RedirectToAction(nameof(Index)); 

} 

return View(movie); 

} 






// POST: Movies/Edit/5 

// To protect from overposting attacks, please enable the specific properties you want to bind to, for 
// more details see http://go.microsoft.com/fwlink/?LinkId=317598. 

[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Edit(int id, [Bind("ID,Title,ReleaseDate,Genre,Price")] Movie movie) 

{ 

if (id != movie.ID) 

{ 

return NotFound(); 

} 

if (ModelState.IsValid) 

{ 

try 

{ 

_context.Update(movie); 

await _context.SaveChangesAsync(); 

} 

catch (DbUpdateConcurrencyException) 

{ 

if (!MovieExists(movie.ID)) 

{ 

return IMotFound(); 

} 

else 

{ 

throw; 

} 

} 

return RedirectToAction("Index"); 

} 

return View(movie); 

} 

HttpPost Özniteliği belirtir bu Edit yöntemi çağrılacak ya buzca için post istekleri. Geçerli olabilir [HttpGet] ilk 
özniteliği Düzenle yöntemi, ancak gerekli değildir çünkü [HttpGet] varsayılandır. 

ValidateAntiForgeryToken Özniteliktir için kullanılan istek sahteciliğini önleme ve düzenleme görünümü dosyasında 
oluşturulan bir sahteciliğe karşı koruma belirteci ile eşleştirilmiş ( Viev/s/Movıes/Edit.cshtml ). Sahteciliğe karşı 
koruma belirteci ile düzenleme görünüm dosyası oluşturur Form etiketi Yardımcısı. 

<form asp-action="Edit"> 

Form etiketi Yardımcısı eşleşmelidir gizli bir sahteciliğe karşı koruma belirteci oluşturan 

[ValidateAntiForgeryToken] oluşturulan sahteciliğe karşı koruma belirtecine Edit denetleyici filmler yöntemi. 

Daha fazla bilgi için istek sahteciliğinden koruma. 

HttpGet Edit Yöntemi alır film id parametresini arar Entity Framevvork kullanarak filmi FindAsync yöntemi ve 
düzenleme görünümü seçili film döndürür. Bir filmi bulunamazsa NotFound (HTTP 404) döndürülür. 

















// GET: Movies/Edit/5 

public async Task<IActionResult> Edit(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var movie = await _context.Movie.FindAsync(id); 
if (movie == null) 

{ 

return NotFound(); 

} 

return View(movie); 

} 

Yapı iskelesi sistem düzenleme görünümü oluşturduğunuzda, onu incelenirken Movie sınıfı ve işlemek için 
oluşturulan kodu <iabei> ve <input> sınıfın her bir özellik için öğeleri. Aşağıdaki örnek, Visual Studio yapı iskelesi 
sistem tarafından oluşturulan düzenleme görünümünü gösterir: 







@model MvcMovie.Models.Movie 

@{ 

ViewData["Title"] = "Edit"; 

} 

<hl>Edit</hl> 

ch4>Moviec/h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

cform asp-action="Edit"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 
cinput type="hidden" asp-fon="Id" /> 

<div class="form-group"> 

<label asp-for="Title" class="control-label"x/label> 

<input asp-for="Title" class="form-control" /> 

<span asp-validation-fon="Title" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="ReleaseDate" class="control-label"x/label> 

<input asp-for="ReleaseDate" class="form-contnol" /> 

<span asp-validation-for="ReleaseDate" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Genre" class="control-label"x/label> 

cinput asp-for="Genre" class="form-control" /> 

cspan asp-validation-for="Genre" class="text-danger"x/span> 

</div> 

cdiv class="form-group"> 

clabel asp-for="Price" class="control-label"x/label> 
cinput asp-fon="Price" class="form-contnol" /> 
cspan asp-validation-fon="Price" class="text-dangen">c/span> 
c/div> 

cdiv class="form-group"> 

cinput type="submit" value="Save" class="btn btn-primary" /> 
c/div> 
c/form> 
c/div> 
c/div> 

cdiv> 

ca asp-action="Index">Back to Listc/a> 
c/div> 

@section Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 

Şablonu Görüntüle nasıl olduğunu fark bir @modei MvcMovie.Models.Movie deyimini dosyanın üst. 

@modei MvcMovie.Models.Movie Görünüm model görünüm şablonu türünde olmasını bekliyor belirtir Movie . 

İskele kurulan kodu birkaç etiketi Yardımcısı yöntemleri HTML biçimlendirmeyi kolaylaştırmak için kullanır. Etiket 
etiketi Yardımcısı ("Title", "ReleaseDate", "Tarzı" veya "Price") alanın adını görüntüler. Giriş etiketi Yardımcısı bir 
HTML işleyen cinput> öğesi. Doğrulama etiketi Yardımcısı bu özellikle ilişkili herhangi bir doğrulama iletisi 
görüntüler. 

Uygulamayı çalıştırmak ve gidin /Movies URL'si. ' A tıklayın bir Düzenle bağlantı. Tarayıcıda, sayfa için kaynağı 
görüntüleyin, için oluşturulan HTML cform> öğesi aşağıda gösterilmektedir. 











cform action="/Movies/Edit/7" method="post"> 

<div class="form-horizontal"> 
ch4>Moviec/h4> 

<hr /> 

<div class="text-danger" /> 

cinput type="hidden" data-val="true" data-val-required="The ID field is required." id="ID" name="ID" 
value="7" /> 

<div class="form-group"> 

<label class="control-label col-md-2" for="Genre" /> 

<div class="col-md-10"> 

<input class="fontı-contnol" type="text" id="Genre" name="Genre" value="Western" /> 

<span class="text-danger field-validation-valid" data-valmsg-for="Genre" data-valmsg- 
replace="true"x/span> 

</div> 

</div> 

<div class="form-group"> 

<label class="control-label col-md-2" for="Price" /> 

<div class="col-md-10"> 

<input class="form-contnol" type="text" data-val="true" data-val-number="The field Price must 
be a number." data-val-required="The Price field is required." id="Price" name="Price" value="3.99" /> 

<span class="text-danger field-validation-valid" data-valmsg-for="Price" data-valmsg- 
replace="true"x/span> 

</div> 

</div> 

<!-- Markup removed for brevity --> 

<div class="form-group"> 

<div class="col-md-offset-2 col-md-10"> 

cinput type="submit" value="Save" class="btn btn-default" /> 

</div> 

</div> 

</div> 

cinput name="_RequestVerificationToken" type="hidden" 

value="CfD18Inyxgp63fRFqUePGvuI5jGZslolulL7X91elgy7NCHSduCRx9jDQClrV9pOTTmqUyXnlBXhmrjcUVDlyDUMm7- 

MF_9rK8aAZdRdl0ri7FmKVkRe_2v5LIHGKFcTjPrWPYnc9AdSbomki0SaTEg7RU" /> 

c/form> 

cinput> Öğeler içinde bir html cform> öğesi olan action özniteliğinin ayarlanmış gönderinin yayımlanacağı 
/Movies/Edit/id URL'si. Form verileri sunucuya yayımlanacak olduğunda save düğmesine tıklandığında. Son 
satırı kapatmadan önce c/form> öğenin gizli gösterir XSRF tarafından oluşturulan belirteç Form etiketi Yardımcısı. 

POST isteğini işleme 

Aşağıdaki liste gösterildiği [HttpPost] sürümünü Edit eylem yöntemi. 








[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Edit(int id, [BindC'IDjTitlejReleaseDatejGenrejPrice")] Movie movie) 

{ 

if (id != movie.ID) 

{ 

return NotFound(); 

} 

if (ModelState.IsValid) 

{ 

try 

{ 

_context.Update(movie); 

await _context.SaveChangesAsync(); 

} 

catch (DbUpdateConcurrencyException) 

{ 

if (!MovieExists(movie.ID)) 

{ 

return NotFound(); 

} 

else 

{ 

throw; 

} 

} 

return RedirectToAction(nameof(Index)); 

} 

return View(movie); 

} 






// POST: Movies/Edit/5 

// To protect from overposting attacks, please enable the specific properties you want to bind to, for 

// more details see http://go.microsoft.com/fwlink/?LinkId=317598. 

[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Edit(int id, [Bind("ID,Title,ReleaseDate,Genre,Price")] Movie movie) 

{ 

if (id != movie.ID) 

{ 

return NotFound(); 

} 

if (ModelState.IsValid) 

{ 

try 

{ 

_context.Update(movie); 

await _context.SaveChangesAsync(); 

} 

catch (DbUpdateConcurrencyException) 

{ 

if (!MovieExists(movie.ID)) 

{ 

return IMotFound(); 

} 

else 

{ 

throw; 

} 

} 

return RedirectToAction("Index"); 

} 

return View(movie); 

} 

[ValidateAntiForgeryToken] Özniteliği gizli doğrular XSRF içinde sahteciliğe karşı koruma belirteci Oluşturucu 
tarafından oluşturulan belirteç Form etiketi Yardımcısı 

Model bağlama sistem gönderilen form değerlerini alır ve oluşturan bir Movie olarak geçirilen nesne movie 
parametresi. ModelState.isVaüd Yöntemi doğrular (düzenleme veya güncelleştirme) değiştirileceğini biçiminde 
gönderilen veriler kullanılabilir bir Movie nesne. Veriler geçerliyse kaydedilir.Güncelleştirilmiş (düzenlenen) film 
verileri çağırarak veritabanına kaydedilir SaveChangesAsync veritabanı bağlamının yöntemi. Verileri kaydettikten 
sonra kodu kullanıcı için yönlendiren index eylem yöntemi MoviesControiler yaptığınız değişiklikleri içeren film 
koleksiyonu görüntüleyen sınıfı. 

Form, sunucuya gönderilen önce istemci tarafı doğrulama alanlarda tüm doğrulama kurallarını denetler. Herhangi 
bir doğrulama hatası varsa, bir hata iletisi görüntülenir ve form gönderilen değil. JavaScript devre dışı bırakılırsa, 
istemci tarafı doğrulama olmaz ancak sunucu, geçerli olmayan gönderilen değerlerden algılar ve form değerleri, 
hata iletileri ile yeniden. Öğreticinin ilerleyen bölümlerinde inceleyeceğiz Model doğrulama daha ayrıntılı bir 
şekilde. Doğrulama etiketi Yardımcısı içinde Vievvs/Movies/Edit.cshtml görünüm şablonu uygun hata iletilerini 
görüntüleme üstlenir. 
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Tüm HttpGet film denetleyici yöntemleri benzer bir desen uygulayın. Bir film nesnesi aldıkları (veya durumunda 
nesnelerin listesini index ) ve ' % s'nesne (modeli) görünümüne geçirin, create Boş film nesneye yöntemi geçirir 
Create görünümü. Bu nedenle, oluşturmak, düzenlemek, silmek veya aksi halde verileri değiştiren tüm yöntemler 
yapmak [HttpPost] yöntemi aşırı yüklemesi. Verileri değiştirme bir httpget bir güvenlik riski yöntemidir. Verileri 
değiştirme bir http get yöntemi de ihlal HTTP en iyi yöntemler ve mimari REST desen, GET istekleri, 
uygulamanızın durumunu değiştirmemeniz belirtir. Diğer bir deyişle, bir GET işlemi gerçekleştirilirken yan etkileri 
olan ve verilerinizi kalıcı değiştirmez güvenli bir işlem olmalıdır. 
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• Genelleştirme ve yerelleştirme 

• Etiket Yardımcıları giriş 

• Yazma etiketi Yardımcıları 

• istek Sahteciliğinden Koruma 

• Denetleyicinizden korumak aşırı gönderme 
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ASPNET Core MVC uygulamasına arama ekleme 
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Tarafından RickAnderson 

Bu bölümde, film metoduna tarz veya ada göre arama index özelliği ekleyebilirsiniz. 

Controllers/MoviesController. cs içinde bulunan yöntemiaşağıdakikodlagüncelleştirin: index 

public async Task<IActionResult> Index(string searchString) 

{ 

var movies = from m in _context.Movie 
select m; 

if (!String.IsNullOrEmpty(searchString)) 

{ 

movies = movies.Where(s => s.Title.Contains(searchString)); 

} 

return View(await movies.Tol_istAsync()); 

} 

index Eylem yönteminin ilk satırı, filmleri seçmek için bir LINQ sorgusu oluşturur: 

var movies = from m in _context.Movie 
select m; 

Sorgu yalnızca bu noktada tanımlanmış, veritabanında çalıştırılmadı. 

searchString Parametresi bir dize içeriyorsa, filmler sorgusu arama dizesinin değerine göre filtrelenecek şekilde 
değiştirilir: 

if (!String.IsNullOrEmpty(searchString)) 

{ 

movies = movies.Where(s => s.Title.Contains(searchString)); 

} 

Yukarıdaki kod bir lambda ifadesidir, s => s.Titie.contains() Lambdalar, Yöntem tabanlı LINQ sorgularında 
VVHERE yöntemi veya contains (Yukarıdaki kodda kullanılan) gibi standart sorgu işleci yöntemlerine bağımsız 
değişkenler olarak kullanılır. LINQ sorguları tanımlandıklarında veya where , contains ya orderBy da gibi bir 
yöntem çağırarak değiştirildiklerinde yürütülmez. Bunun yerine sorgu yürütmesi ertelenir. Diğer bir deyişle, bir 
ifadenin değerlendirmesi, gerçekleştirilmiş değeri gerçekten yineleneceği veya ToListAsync Yöntem çağrılana kadar 
geciktirilen anlamına gelir. Ertelenmiş sorgu yürütme hakkında daha fazla bilgi için bkz. sorgu yürütme. 

Not: Contains yöntemi yukarıda gösterilen c# kodunda değil, veritabanında çalıştırılır. Sorgudaki büyük/küçük harf 
duyarlılığı veritabanına ve harmanlamaya bağlıdır. SQL Server üzerinde SQL gibieşlemeler içerir , büyük/küçük 
harfe duyarsız olur. SQLİte ' da, varsayılan harmanlama ile büyük/küçük harfe duyarlıdır. 

/Movies/index sayfasına gidin. URL 'ye gibi ?searchstring=Ghost bir sorgu dizesi ekleyin. Filtrelenmiş filmler 
görüntülenir. 
















{ 

routes.MapRoute( 

name: "default", 

template: "{controller=Home}/{action=Index}/{id?}"); 

}); 

Parametresini id ve searchstring değişikliğin tümoluşumlarınıolarakdeğiştirin. id 
Önceki index Yöntem: 


public async Task<IActionResult> Index(stning searchstring) 

{ 

var movies = from m in _context.Movie 
select m; 

if (!String.IsNullOrEmpty(searchString)) 

{ 

movies = movies.Where(s => s.Title.Contains(searchString)); 

} 

return View(await movies.ToListAsync()); 

} 


Parametresi ile index 


id güncelleştirilmiş Yöntem: 
















public async Task<IActionResult> Index(string id) 

{ 

var movies = from m in _context.Movie 
select m; 

if (!String.IsNullOrEmpty(id)) 

{ 

movies = movies.Where(s => s.Title.Contains(id)); 

} 

return View(await movies.Tol_istAsync()); 

} 


Artık arama başlığını sorgu dizesi değeri yerine rota verileri (bir URL segmenti) olarak geçirebilirsiniz. 
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Ancak, kullanıcıların bir filmi her arayışınızda URL 'Yİ değiştirmesini beklemeniz gerekmez. Böylece, filmlerin 
filtrelemesine yardımcı olmak için UI öğeleri ekleyeceğiz. Yol ile bağlantılı id parametrenin nasıl geçirileceğini test 
index etmek için yönteminin imzasını değiştirdiyseniz, adlı searchstring bir parametre alması için geri değiştirin: 

public async Task<IActionResult> Index(stning searchstring) 

{ 

var movies = from m in _context.Movie 
select m; 

if (!String.IsNullOrEmpty(searchString)) 

{ 

movies = movies.Where(s => s.Title.Contains(searchString)); 

} 

return View(await movies.Tol_istAsync()); 

} 


Views/filmler/lndex. cshtml dosyasını açın ve aşağıda vurgulanan <form> biçimlendirmeyi ekleyin: 






ViewData["Title"] = "Index"; 

} 

<h2>Index</h2> 

<P> 

<a asp-action="Create">Create New</a> 

</p> 

<form asp-controller="Movies" asp-action="Index"> 

<P> 

Title: cinput type="text" name="SearchString"> 
<input type="submit" value="Filter" /> 

</p> 

</form> 

<table class="table"> 

<thead> 


HTML <form> etiketi, form etiketi yardımcısınıkullanır, bu nedenle formu gönderdiğinizde, filtre dizesi film 
denetleyicisinin index eylemine gönderilir. Değişikliklerinizi kaydedin ve sonra filtreyi test edin. 
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Bekleneceğiniz gibi [HttpPost] index metodun aşırı yüklemesi yoktur. Bunun için gerekli değildir, çünkü yöntem 
uygulamanın durumunu değiştirmediğinden verileri filtrelememeniz yeterlidir. 

Aşağıdaki [HttpPost] index yöntemi ekleyebilirsiniz. 

[HttpPost] 

public string Index(string searchString, bool notUsed) 

{ 

return "From [HttpPost]Index: filter on " + searchString; 

} 

















notused Parametresi, index yöntemi için bir aşırı yükleme oluşturmak için kullanılır. Öğreticide daha sonra 
konuşacağız. 

Bu yöntemi eklerseniz, Invoker [HttpPost] index yöntemi yöntemiyle eşleşir [HttpPost] index ve yöntemi 
aşağıdaki görüntüde gösterildiği gibi çalışır. 

. - □ X 
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From [HttpPost]Index: filter on ghost 


Ancak, bu [HttpPost] index yöntemin bu sürümünü eklemeseniz bile, tümünün nasıl uygulandığını gösteren bir 
sınırlama vardır. Belirli bir arama için yer işareti koymak istediğinizi veya aynı film filtrelenmiş listesini görmek için 
onlara tıklabilecekleri bir bağlantı göndermek istediğinizi düşünün. HTTP POST isteğinin URL 'SI GET isteğinin 
URL 'siyle (localhost: {PORT}/filmler/dizin) aynı olduğunu fark edin; URL 'de arama bilgisi yok. Arama dizesi 
bilgileri sunucuya form alanı değeriolarak gönderilir. Tarayıcı geliştirici araçları veya harika Fiddler 
aracımnolduğunu doğrulayabilirsiniz. Aşağıdaki görüntüde Chrome tarayıcı geliştirici araçları gösterilmektedir: 
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View: !- ■*» □ Preserve log □ Disable cache U Offline Nothrottling 
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XHR JS CSS Img Media Font Doc WS Manifest Other 


Name 


x Headers Previevv Response Cookies Timing 


O 


Moves 


jquery.js 

/lib/jquery/dist 

bootstrap.js 

/lib/bootstrap/dist/js 

site.js?v=EWaMeWsJBYWmL2g.. 

/is 


4 reguests i 3.9 KB transferred Fi.. 


▼ General 

Request URL: http://localhost:5000/Movies 
Request Method: POST 
Status Code: # 200 OK 


-Kemote Address: [::1]:5S3S- 

Referrer Policy: no-referrer-wtıen-downgrade 

▼ Response Headers view source 

Cacbe-Control: no-cache 
Content-Type: text/html; charset=utf-8 
Date: Mon, 10 Apr 2017 00:10:32 GMT 
Pragma: no-cache 
Server: Kestrel 
Transfer-Encoding: chunked 

▼ Request Headers view source 

Accept: text/html,application/xhtml+xml J application/xml; 

q=0.9,image/webp,«/*;q=0.8 

Accept-Encoding: g:ip, deflate, br 

Accept-Language: en-USjen;q=0.8 

Cache-Control: max-age=0 

Connection: keep-alive 

Content-Length: 201 

Content-Type: application/x-www-form-urlencoded 

Cookie: . AspNetCore. Antiforgery.txPTUN878m8=CfD18B98MxllF 

L5pAq2aeCj59HP3vvTrLPKlkrIeXslFchnazvAijLRXzWQjTw-tsE3DQr 

8bQg-xCdy7DbpfcQ-Hi2HAx0inlR838CvFU6oyWz7VIKmiKjUuXI371 

S-YZR0pBdNaP0rnTxZX91RHy_jX_zIig; .AspNetCore.Antiforger 

y.Mkgl_D_R5qY=CfD18B98HxUFL5pAq2aeCj59HP2tNs0B01ewBFztib 

CoKKfe2wxo9rL6Z-9YP41jarbKy]_I5aQvz9BMWGfPpwwbH711w4I8qg 

C-CkWyxAsFxWKQyP0HYsYab98gk-z_M4jHl_Hw9ODBZ3uBVSB0fzF4 

tM8 

Hoşt: localhost: 5000 

Origin: http://localhost:5000 

Referer: http: //localhost: 5000/Movies 

Upgrade-lnsecure-Requests: 1 

User-Agent: Mozilla/5.0 (Windows NT 10.0; W0W64) AppleWeb 
Kit/537.36 (KHTML, like Gecko) Chrome/57.0.2987.133 Safa 
ri/537.36 


▼ Form Data view source view URL encoded 

SearchString: Ghost 

_RequestVerificationToken: CfD38B98MxUFL5pAq2aeCj59HPlg2HX 

ND176MabW7uuk2OAGreBb3y0NufBTHAjxmlCjRFe-2sF50PVla72IyfC 
A9Pao3muZ0f4jtjDNDlXEagdlk_g67wBX12qOKI7DLD98OGjNjBB_-5r 
vRhluQCroPRw 


Arama parametresini ve XSRF belirtecini istek gövdesinde görebilirsiniz. Bu şekilde, önceki öğreticide bahsedildiği 
gibi, form etiketi Yardımcısı, bir XSRF Anti-forgery belirteci oluşturur. Verileri değiştiriyoruz, bu nedenle 
denetleyiciyi denetleyici yönteminde doğrulamamız gerekmiyor. 

Arama parametresi, URL değil, istek gövdesinde olduğundan, bu arama bilgilerini, yer işareti veya başkalarıyla 
paylaşmak için yakalayamazsınız, isteğin, http get Görünümler/filmler/lndex. cshtml dosyasında bulunması 
gerektiğini belirterek bunu düzeltemedi. 















































@model IEnumerablecMvcMovie.Models.Movie> 


@{ 

ViewData["Title"] = "Index"; 

} 

<hl>Index</hl> 

<P> 

<a asp-action="Create">Create New</a> 

</p> 

<form asp-controllen="Movies" asp-action="Index" method="get"> 
<P> 

Title: <input type="text" name="SearchString"> 

<input type="submit" value="Filter" /> 

</p> 

</form> 

<table class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model = > model.Title) 


Artık bir arama gönderdiğinizde, URL arama sorgu dizesini içerir. HttpGet index Bir HttpPost index yönteminiz 
olsa da, arama eylem yöntemine de gidecektir. 
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Aşağıdaki biçimlendirme form etiketine olan değişikliği gösterir: 


<form asp-controller="Movies" asp-action="Index" method="get"> 


Türe göre arama Ekle 



















Aşağıdaki MovieGenreviewModei sınıfının modelleri klasörü: 


using Microsoft.AspNetCore.Mvc. Rendering; 
using System.Collections.Generic; 

namespace MvcMovie.Models 

{ 

public class MovieGenreViewModel 

{ 

public List<Movie> Movies { get; set; } 
public SelectList Genres { get; set; } 
public string MovieGenre { get; set; } 
public string SearchString { get; set; } 

} 

} 


Film tarzı görünüm modeli şunları içerir: 

• Bir film listesi. 

• Tarzlar listesini içeren bir SelectList . Bu, kullanıcının listeden bir tarz seçmesine olanak sağlar. 

• MovieGenre , seçilen tarzı içeren. 

• SearchString , kullanıcılar arama metin kutusuna girdiğiniz metni içerir. 
index içindeki MoviesControiier.es yöntemini aşağıdaki kodla değiştirin: 

// GET: Movies 

public async Task<IActionResult> Index(string movieGenre, string SearchString) 

{ 

// Use LINQ to get üst of genres. 

IQueryable<string> genreQuery = from m in _context.Movie 

orderby m.Genre 
select m.Genre; 

var movies = from m in _context.Movie 
select m; 

if (!string.IsNullOrEmpty(searchString)) 

{ 

movies = movies.Where(s => s.Title.Contains(searchString)); 

} 

if (!string.IsNullOrEmpty(movieGenre)) 

{ 

movies = movies.Where(x => x.Genre == movieGenre); 

} 

var movieGenreVM = new MovieGenreViewModel 

{ 

Genres = new SelectList(await genreQuery.Distinct() .ToListAsync()), 

Movies = await movies.ToListAsync() 

}; 

return View(movieGenreVM); 

} 

Aşağıdaki kod, veritabanından tüm linq tarzları alan bir sorgudur. 

// Use LINQ to get üst of genres. 

IQueryable<string> genreQuery = from m in _context.Movie 

orderby m.Genre 
select m.Genre; 








selectList Tarzlar ayrı tarzlar yansıtıyor (Select listenizin yinelenen tarzlar olmasını istemiyorum). 


Kullanıcı öğeyi aradığında arama değeri arama kutusuna tutulur. 

Tarzı, dizin görünümüne göre ara ekleme 

Şu index.cshtmi şekilde görünümlerde/filmlerde bulunan güncelleştirme: 





@model MvcMovie.Models.MovieGenreViewModel 

@{ 

ViewData["Title"] = "Index"; 

} 

<hl>Index</hl> 

<P> 

<a asp-action="Create">Create New</a> 

</p> 

<form asp-controller="Movies" asp-action="Index" method="get"> 

<P> 

<select asp-for="MovieGenre" asp-items="Model.Genres"> 
coption value="">All</option> 

</select> 

Title: <input type="text" asp-for="SearchString" /> 

<input type="submit" value="Filter" /> 

</p> 

</form> 

<table class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model => model.Movies[0].Title) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movies[0].ReleaseDate) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movies[0].Genre) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movies[0].Price) 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model.Movies) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.ReleaseDate) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Genre) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Price) 

</td> 

<td> 

<a asp-action="Edit" asp-route-id="@item.Id">Edit</a> | 

<a asp-action="Details" asp-route-id="@item.Id">Details</a> | 
<a asp-action="Delete" asp-route-id="@item.Id">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 



Aşağıdaki HTML Yardımcısı 'nda kullanılan lambda ifadesini inceleyin: 


@Html.Displayf\lameFor(model => model.Movies[0].Title) 

Yukarıdaki kodda, DisplayNameFor HTML Yardımcısı, görünen adı belirlemede Lambda Title ifadesinde 
başvurulan özelliği inceler. Lambda model ifadesi değerlendirilmek yerine incelenebileceğinden,, model.Movies 
veya model.Movies[0] nuiı boş olduğunda bir erişim ihlali almazsınız. Lambda ifadesi değerlendirildiğinde 
(örneğin, @Htmi.DispiayFor(modeiıtem => item.Title) ), modelin özellik değerleri değerlendirilir. 


Türe göre, film başlığına göre ve her ikisine birden arayarak uygulamayı test edin: 
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ASPNET Core MVC uygulamasına yeni bir alan 
ekleme 

23.11.2019 * 8 minutes to read ı Edit Online 


Tarafından Rick Anderson 

Bu bölümde Entity Framevvork için Code First Migrations kullanılır: 

• Modele yeni bir alan ekleyin. 

• Yeni alanı veritabanına geçirin. 

EF Code First otomatik olarak bir veritabanı oluşturmak için kullanıldığında, Code First: 

• Veritabanının şemasını izlemek için veritabanına tablo ekler. 

• Veritabanının oluşturulduğu model sınıflarıyla eşitlenmiş olduğunu doğrular. Bunlar eşitlenmiş değilse EF bir 
özel durum oluşturur. Bu, tutarsız veritabanı/kod sorunlarını bulmayı kolaylaştırır. 

Film modeline bir derecelendirme özelliği ekleyin 

Modeller/film. cs' ye bir Rating özelliği ekleyin: 

public class Movie 
{ 

public int Id { get; set; } 
public string Title { get; set; } 

[Display(Name = "Release Date")] 

[DataType(DataType.Date) ] 

public DateTime ReleaseDate { get; set; } 

public string Genre { get; set; } 

[Column(TypeName = "decimal(18j 2)")] 
public decimal Price { get; set; } 
public string Rating { get; set; } 

} 

Uygulama oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Ctrl + Shift+B 

Movie sınıfına yeni bir alan eklediyseniz, bu yeni özellik dahil edilecek şekilde bağlama beyaz listesini 
güncelleştirmeniz gerekir. MoviesController.es' de, Rating özelliği dahil etmek için hem create hem de Edit 
eylem yöntemlerinin [Bind] özniteliğini güncelleştirin: 

[Bind("Id,Title,ReleaseDate,Genre,Price,Rating")] 

Yeni Rating özelliğini tarayıcı görünümünde görüntülemek, oluşturmak ve düzenlemek için görünüm şablonlarını 
güncelleştirin. 














/Views/movies/!ndex.cshtml dosyasını düzenleyin ve bir Rating alanı ekleyin: 


<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model => model.Movies[0].Title) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movies[0].ReleaseDate) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movies[0].Genre) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movies[0].Price) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movies[0].Rating) 

</th> 

<thx/th> 

</tn> 

</thead> 

<tbody> 

@foreach (var item in Model.Movies) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.ReleaseDate) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Genre) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Price) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Rating) 

</td> 

<td> 

<a asp-action="Edit" asp-route-id="@item.Id">Edit</a> | 

Bir Rating alanla /vievvs/movies/Create.cshtml güncelleştirin. 

• Visual Studio/Mac için Visual Studio 

• Visual Studio Code 

Önceki "form grubunu kopyalayabilir/yapıştırabilir" ve IntelliSense 'in alanları güncelleştirmenize yardımcı 
olmasına izin verebilirsiniz. IntelliSense, Etiket Yardımcılarıile birlikte çalışmaktadır. 





</div> 

<div class="form-group"> 

<label asp-for="Title" class=”col-md-2 control-label”x/label> 
<div class="col-md-10"> 

<input asp-for="Title" class=”form-control” /> 

<span asp-validation-for="Title" class="text-danger'' /> 
</div> 

</div> 

<div class="form-group"> 


<label asp-for=''R|" class="col-md-2 control-label"x/label> 


<div class=”col- 

© GetHashCode 


<input asp-f 


ı-control“ /> 

<span asp-va 


:lass="text-danger” /> 

</div> 

İD 


</div> 

^ Price 


<div class="form-gro 

>> rw 


<div class=”col- 

f* ReleaseDate 

’> 

<input type= 

Title 

•" class="btn btn-default" /> 

</div> 


</div> 

0 ToString 

▼ 



</div> 

</forn> 


Kalan şablonları güncelleştirin. 

seedData sınıfını yeni sütun için bir değer sağlayacak şekilde güncelleştirin. Aşağıda örnek bir değişiklik 
gösterilmektedir, ancak her bir new Movie için bu değişikliği yapmak isteyeceksiniz. 

new Movie 
{ 

Title = "When Harry Met Sally", 

ReleaseDate = DateTime.Parse("1989-l-ll"), 

Genre = "Romantic Comedy", 

Rating = "R", 

Price = 7.99M 

b 

VERITABANı yeni alanı içerecek şekilde güncelleştirilene kadar uygulama çalışmaz. Şimdi çalıştırıldığında, aşağıdaki 
SqlException atı lir: 

SqlException: Invalid column name ’Rating'. 

Bu hata, güncelleştirilmiş film modeli sınıfı varolan veritabanının film tablosunun şemasından farklı olduğu için 
oluşur. (Veritabanı tablosunda Rating sütunu yoktur.) 

Hatayı çözmek için birkaç yaklaşım vardır: 

1. Entity Framevvork yeni model sınıfı şemasına göre otomatik olarak veritabanını bırakıp yeniden oluşturmayı 
sağlayabilirsiniz. Bu yaklaşım, bir test veritabanı üzerinde etkin geliştirme yaparken geliştirme döngüsünün 
başlarında çok daha kolay, modeli ve veritabanı şemasını birlikte hızla gelişmenize olanak tanır. Bunun 
yanında, bu yaklaşımı bir üretim veritabanında kullanmak istemezsiniz, ancak bu, veritabanında var olan 
verileri kaybetmeniz olur. Bir veritabanının test verileriyle otomatik olarak çekirdeği oluşturmak için bir 
başlatıcı kullanılması, genellikle bir uygulama geliştirmenin üretken bir yoludur. Bu, erken geliştirme ve 
SQLİte kullanılırken iyi bir yaklaşımdır. 

2. Mevcut veritabanının şemasını model sınıflarıyla eşleşecek şekilde açıkça değiştirin. Bu yaklaşımın avantajı, 
verilerinizi tutmanızı kullanmaktır. Bu değişikliği el ile ya da bir veritabanı değişiklik betiği oluşturarak 
yapabilirsiniz. 

3. Veritabanı şemasını güncelleştirmek için Code First Migrations kullanın. 

Bu öğretici için Code First Migrations kullanılır. 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 
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PMC'de aşağıdaki komutları girin: 

Add-Migration Rating 
Update-Database 

Add-Mignation komutu, geçiş çerçevesinin geçerli Movie modelini geçerli Movie DB şemasıyla incelemesini ve 
VERITABANıNı yeni modele geçirmek için gerekli kodu oluşturmasını söyler. 

"Derecelendirme" adı rastgele olur ve geçiş dosyasını adlandırmak için kullanılır.Geçiş dosyası için anlamlı bir ad 
kullanılması yararlı olur. 

VERITABANıNDAKI tüm kayıtlar silinirse, Initialize yöntemi VERITABANıNı temel alır ve Rating alanını içerir. 

Uygulamayı çalıştırın ve bir Rating alanı ile film oluşturabileceğiniz/düzenleyebileceğiniz/görüntüleydiğinizi 
doğrulayın. Edit , Details ve Delete görünüm şablonlarına Rating alanı eklemeniz gerekir. 
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ASPNET Core MVC uygulamasına doğrulama ekleme 

23.11.2019 • 15 minutes to read ı Edit Online 


Tarafından RickAnderson 
Bu bölümde: 

• Doğrulama mantığı Movie modeline eklenir. 

• Bir Kullanıcı bir filmi oluşturduğunda veya düzenleişinizde doğrulama kurallarının uygulanmasını 
sağlayabilirsiniz. 

İşleri güncel tutma 

MVC 'nin tasarımdan biri (" kendini tekrarlama"). ASP.NET Core MVC, işlevselliği veya davranışı yalnızca bir kez 
belirtmenizi ve bir uygulamada her yerde yansıtıldığını önerir. Bu, yazmanız gereken kod miktarını azaltır ve daha az 
hata yazmanızı, daha kolay test yapmayı ve bakımını daha kolay hale getirir. 

MVC ve Entity Framevvork Core Code First tarafından sunulan doğrulama desteği, işlem içindeki kuru ilkeye uygun 
bir örnektir. Doğrulama kurallarını tek bir yerde (model sınıfında) bildirimli olarak belirtebilir ve kurallar 
uygulamada her yerde zorlanır. 

Film modeline doğrulama kuralları ekleme 

Dataaçıklamalarda ad alanı, bir sınıfa veya özelliğe bildirimli olarak uygulanan bir yerleşik doğrulama öznitelikleri 
kümesi sağlar. Dataaçıklamalarda, biçimlendirme ile ilgili Yardım DataType ve herhangi bir doğrulama sağlamayan 
gibi biçimlendirme öznitelikleri de bulunur. 

Yerleşik Required ,, ReguiarExpression vedoğrulama özniteliklerinden yararlanmak için sınıfıgüncelleştirin. Movie 
StringLength Range 








public class Movie 

{ 

public int Id { get; set; } 

[StringLength(60j MinimumLength = 3)] 

[Required] 

public stning Title { get; set; } 

[Display(Name = "Release Date")] 

[DataType(DataType.Date) ] 

public DateTime ReleaseDate { get; set; } 

[Range(lj 100)] 

[DataType(DataType.Currency)] 

[Column(TypeName = "decimal(18, 2)")] 
public decimal Price { get; set; } 

[RegularExpression(@" A [A-Z]+[a-zA-Z.\s-]*$")] 

[Required] 

[StningLength(30)] 

public stning Genne { get; set; } 

[RegularExpression(@" A [A-Z]+[a-zA-Z0-9""'\s-]*$")] 
[StringLength(5)] 

[Requined] 

public stning Rating { get; set; } 


Doğrulama öznitelikleri, uygulanan model özellikleri üzerinde zorlamak istediğiniz davranışı belirtir: 

• Required Ve MinimumLength öznitelikleri bir özelliğin bir değere sahip olması gerektiğini belirtir; ancak hiçbir 
şey, bir kullanıcının bu doğrulamayı karşılamak için boşluk girmesini engeller. 

• ReguiarExpression Öznitelik, hangi karakterlerin girişi yapabileceğini sınırlamak için kullanılır. Yukarıdaki 
kodda, "tarz": 

o Yalnızca harfler kullanılmalıdır. 

o İlk harfin büyük harfle olması gerekir. Boşluk, sayı ve özel karakterlere izin verilmez. 

• ReguiarExpression "Derecelendirme": 

o ilk karakterin büyük harf olmasını gerektirir. 

o Sonraki boşlukların içindeki özel karakter ve sayılara izin verir."PG-13" bir derecelendirme için geçerlidir, 
ancak bir "tarz" için başarısız olur. 

• Range Özniteliği bir değeri belirtilen bir Aralık içinde kısıtlar. 

• stringLength Özniteliği, bir dize özelliğinin en büyük uzunluğunu ve isteğe bağlı olarak en düşük 
uzunluğunu ayarlamanıza olanak sağlar. 

• Değer türleri (örneğin, decimal, int, float DateTime ), doğal olarak gereklidir ve [Required] özniteliğe 
gerek kalmaz. 

Doğrulama kurallarının otomatik olarak uygulanmasını ASP.NET Core uygulamanızın daha sağlam olmasına 
yardımcı olur. Ayrıca, bir şeyi doğrulamayı unutmanızı ve veritabanına yanlışlıkla veri vermemesini de sağlar. 

Doğrulama hatası Kullanıcı arabirimi 

Uygulamayı çalıştırın ve filmler denetleyicisine gidin. 

Yeni bir film eklemek için Yeni oluştur bağlantısına dokunun. Formu, bazı geçersiz değerlerle doldurun. JQuery 
istemci tarafı doğrulaması hatayı algıladıktan hemen sonra bir hata iletisi görüntüler. 
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NOTE 

Ondalık alanlara ondalık virgüller giremeyebilirsiniz. Ondalık bir nokta ve ABD İngilizcesi olmayan tarih biçimleri için virgül 
kullanan İngilizce olmayan yerel ayarlarda jOuery doğrulamasını desteklemek için, uygulamanızı globalize için adımlar 
uygulamanız gerekir. Ondalık virgülden ekleme hakkında yönergeler için bkz. GitHub sorunu 4076 . 











Formun, geçersiz bir değer içeren her bir alanda uygun bir doğrulama hata iletisini nasıl otomatik olarak 
oluşturduğuna dikkat edin. Hatalar hem istemci tarafında (JavaScript ve jQuery kullanılarak) hem de sunucu 
tarafında (kullanıcının JavaScript devre dışı bırakılmış olması durumunda) zorlanır. 

Önemli bir avantaj, bu doğrulama kullanıcı arabirimini etkinleştirmek için MoviesControiler sınıfında veya Create. 
cshtml görünümündeki tek bir kod satırını değiştirmeniz gerekmez. Bu öğreticide daha önce oluşturduğunuz 
denetleyici ve görünümler, Movie model sınıfının özelliklerinde doğrulama özniteliklerini kullanarak belirttiğiniz 
doğrulama kurallarını otomatik olarak çekti. Edit Action yöntemini kullanarak test doğrulaması ve aynı doğrulama 
uygulanır. 

Form verileri, istemci tarafı doğrulama hatası kalmayana kadar sunucuya gönderilmez. Bunu, Fiddler aracını veya 
Fi 2 geliştirici araçlarınıkullanarak http Post yöntemine bir kesme noktası koyarak doğrulayabilirsiniz. 

Doğrulamanın çalışması 

Doğrulama Kullanıcı arabiriminin denetleyici veya görünümlerde kodda herhangi bir güncelleştirme yapmadan 
nasıl oluşturulduğunu merak edebilirsiniz. Aşağıdaki kod iki create yöntemini gösterir. 

// GET: Movies/Create 
public IActionResult Create() 

{ 

return View(); 

} 

// POST: Movies/Create 
[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Create( 

[Bind("ID,Title,ReleaseDate,Genre,Price, Rating")] Movie movie) 

{ 

if (ModelState.IsValid) 

{ 

_context.Add(movie); 

await _context.SaveChangesAsync(); 

return RedirectToAction("Index"); 

} 

return View(movie); 

} 

ilk (HTTP GET) create Action yöntemi ilk oluşturma formunu görüntüler.ikinci ( [HttpPost] ) sürüm, form 
gönderisini işler, ikinci create yöntemi ( [HttpPost] sürümü), filmin herhangi bir doğrulama hatası olup 
olmadığını denetlemek için ModelState.IsValid çağırır. Bu yöntemi çağırmak, nesnesine uygulanmış olan tüm 
doğrulama özniteliklerini değerlendirir. Nesnede doğrulama hataları varsa create yöntemi formu yeniden 
görüntüler. Hata yoksa, yöntemi yeni filmi veritabanına kaydeder. Film örneğimizde, istemci tarafında algılanan 
doğrulama hataları olduğunda form sunucuya nakledilmez; istemci tarafı doğrulama hataları olduğunda ikinci 
create yöntemi hiçbir zaman çağrılmaz. Tarayıcınızda JavaScript 'i devre dışı bırakırsanız, istemci doğrulaması 
devre dışıdır ve herhangi bir doğrulama hatasını tespit ModelState. isvalid HTTPPOST create yöntemini test 
edebilirsiniz. 

[HttpPost] create yönteminde bir kesme noktası ayarlayabilir ve yöntemin hiçbir zaman çağrılmadığını 
doğrulayabilirsiniz, doğrulama hataları algılandığında istemci tarafı doğrulaması form verilerini göndermez. 
Tarayıcınızda JavaScript 'i devre dışı bırakır, ardından formu hatalarla gönderirseniz, kesme noktası isabet eder. 
JavaScript olmadan tam doğrulama almaya devam edersiniz. 

Aşağıdaki görüntüde, FireFox tarayıcısında JavaScript 'İn nasıl devre dışı bırakılacağı gösterilmektedir. 


















Options 

O ö 



p» â a § 


General Tabî Content | Applications Privacy Security Sync Advanced 


[V] Block pop-up windows 

[3 Load images automatically 

Exceptions... 

Exceptions... 

[ [V] Enable JavaScript | 

Advanced... 


Fonts & Colors 

Defaultfont: Times New Roman Size: 16 

Advanced... 


Çolors... 


languages 

Choose your preferred language for displaying pages 


Choose... 


OK 


Cancel 


Help 


Aşağıdaki görüntüde, Chrome tarayıcısında JavaScript 'in nasıl devre dışı bırakılacağı gösterilmektedir. 

x 

Content settings 

* 

Cookies 

• Allow local data to be set (recommended) 

Keep local data only ııntil I quit my brovvser 
Block sites from setting any data 

Block third-party cookies and site data 

Manage exceptions... Ali cookies and site data... 

Images 

• Show ali images (recommended) 

Do not show any images 

Manage exceptions... 

JavaScript 

__*AllowallsıtestorunJavaScript(recomnıen d ed) 

Do not allow any siteto run JavaScript 
Manage exceptions... 

Handlers 

V 

Done 


JavaScript 'i devre dışı bıraktıktan sonra, geçersiz veri gönderin ve hata ayıklayıcıda adım adım ilerleyin. 





























































// POST: Movies/Create 
// To protect from overposting attacks, please enable t| 
// more details see http://go.microsoft.coni/fwlink/7Li 

[HttpPost] 

[ValidateAntiForgeryToken] 

O references 

public async Task<IAc(. .. ’i|.t > CreateffBindC'ID^Titl 

{ 


fT^TÎ 


if (ModelState.IsValid) 

{ 

_context . Add( movie ) ; 

await _context . SaveChangesAsync() ; 

return RedirectToAction("Index"); 

} 

return View(movie); 


Create. cshtml görünüm şablonunun bölümü aşağıdaki biçimlendirmede gösterilmiştir: 


<h4>Movie</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form asp-action="Create"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 
<div class="form-group"> 

<label asp-for="Title" class="control-label"x/label> 

<input asp-for="Title" class="form-control" /> 

<span asp-validation-for="Title" class="text-danger"x/span> 
</div> 

@*Markup removed for brevity.*@ 


Yukarıdaki biçimlendirme eylem yöntemleri tarafından ilk formu görüntülemek ve bir hata durumunda onu 
yeniden görüntülemek için kullanılır. 

Giriş etiketi Yardımcısı , dataaçıklamaların özniteliklerini kullanır ve istemci tarafında jQuery doğrulaması için 
gerekli HTML özniteliklerini üretir. Doğrulama etiketi Yardımcısı doğrulama hatalarını görüntüler. Daha fazla bilgi 
için bkz. doğrulama . 

Bu yaklaşım ne kadar iyi bir şeydir, denetleyicinin ne de create görünüm şablonunun zorlanmakta olan gerçek 
doğrulama kuralları ya da görüntülenen belirli hata iletileri hakkında herhangi bir şeyi biliyor olması önemlidir. 
Doğrulama kuralları ve hata dizeleri yalnızca Movie sınıfında belirtilmiştir. Aynı doğrulama kuralları Edit 
görünümüne ve modelinizi düzenleyebilecek oluşturabileceğiniz diğer tüm görünümler şablonlarına otomatik 
olarak uygulanır. 

Doğrulama mantığını değiştirmeniz gerektiğinde, modele doğrulama öznitelikleri ekleyerek tam olarak bir yerde 
bunu yapabilirsiniz (Bu örnekte, Movie sınıfı). Kuralların nasıl zorlandığından, uygulamanın farklı bölümlerinin 
tutarsız olması konusunda endişelenmeniz gerekmez; tüm doğrulama mantığı tek bir yerde tanımlanır ve her yerde 
kullanılır. Bu, kodun temiz kalmasını sağlar ve bakımını ve gelişmesini kolaylaştırır.Ayrıca, KURULAMA ilkesini tam 
olarak sunabileceksiniz anlamına gelir. 

DataType özniteliklerini kullanma 

Movie.cs dosyasını açın ve Movie sınıfını inceleyin. System.componentModei.DataAnnotations ad alanı, yerleşik 
doğrulama öznitelikleri kümesine ek olarak biçimlendirme öznitelikleri sağlar. Yayın tarihine ve fiyat alanlarına 
DataType bir numaralandırma değeri zaten uyguladık. Aşağıdaki kod, uygun DataType özniteliğiyle ReleaseDate 

















ve Pnice özelliklerini gösterir. 


[Display(Name = 

"Release Date")] 

[DataType(DataType.Date)] 

public DateTime 

ReleaseDate { get; set; } 

[Range(l, 100)] 


[DataType(DataType.Currency)] 

public decimal 

Price { get; set; } 


DataType öznitelikleri yalnızca görünüm altyapısının verileri biçimlendirmek için ipuçları sağlar (ve URL 'ler için 


gibi öğeleri/öznitelikleri ve e-posta için 

<a href="mailto:EmailAddress.com"> 

sağlar. 

RegularExpression 


özniteliğini kullanarak verilerin biçimini doğrulayabilirsiniz. DataType özniteliği, veritabanı iç türünden daha özel bir 
veri türü belirtmek için kullanılır, bunlar doğrulama öznitelikleri değildir. Bu durumda, zamanı değil yalnızca tarihi 
izlemek istiyoruz. DataType numaralandırması, tarih, saat, PhoneNumber, para birimi, Emaadresi ve daha fazlası 
gibi birçok veri türü sağlar. DataType özniteliği Ayrıca uygulamanın türe özgü özellikleri otomatik olarak 
sağlamasını da sağlayabilir. Örneğin, DataType. EmailAddress için mailto: bir bağlantı oluşturulabilir ve HTML5'i 
destekleyen tarayıcılarda DataType.Date için bir tarih seçici sağlaneklenebilir. DataType öznitelikleri HTML 5 
tarayıcıların anlayabilmesi için HTML 5 data- (bir veri Dash) öznitelikleri yayar. DataType öznitelikleri herhangi bir 
doğrulama sağlamaz. 

DataType.Date görüntülenen tarihin biçimini belirtmiyor. Varsayılan olarak, veri alanı, sunucunun cuitureinfo göre 
varsayılan biçimlere göre görüntülenir. 

DisplayFormat özniteliği, açıkça tarih biçimini belirtmek için kullanılır: 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 
public DateTime ReleaseDate { get; set; } 

ApplyFormatlnEditMode ayarı, bir metin kutusunda değer görüntülenmek üzere görüntülendiğinde 
biçimlendirmenin de uygulanacağını belirtir. (Örneğin, para birimi değerleri için, büyük olasılıkla, metin kutusundaki 
para birimi sembolünü, bazı alanlar için istemiyor olabilirsiniz.) 

DisplayFormat özniteliğini kendisi kullanabilirsiniz, ancak bu genellikle DataType özniteliğini kullanmak iyi bir fikir 
olabilir. DataType özniteliği, bir ekranda nasıl işlenirim aksine verilerin semantiğini sunar ve DisplayFormat ile elde 
olmadığınız aşağıdaki avantajları sağlar: 

• Tarayıcı HTML5 özelliklerini etkinleştirebilir (örneğin, bir Takvim denetimini, yerel ayara uygun para birimi 
sembolünü, e-posta bağlantılarını vb. göstermek için) 

• Varsayılan olarak tarayıcı, verileri yerel ayarınızı temel alarak doğru biçimi kullanarak işleyebilir. 

• DataType özniteliği, verileri işlemek için doğru alan şablonunu seçmek üzere MVC 'yi etkinleştirebilir 
(kendisi tarafından kullanılırsa, dize şablonunu kullanıyorsa DisplayFormat ). 


NOTE 

jQuery doğrulaması, Range özniteliğiyle ve DateTime birlikte çalışmaz. Örneğin, aşağıdaki kod, tarih belirtilen aralıkta 
olduğunda bile her zaman bir istemci tarafı doğrulama hatası görüntüler: 

[Range(typeof(DateTime), "1/1/1966", "1/1/2020")] 


DateTime'' Range özniteliğini kullanmak için jöuery Tarih doğrulamasını devre dışı bırakmanız gerekir. 
Modellerinizde sabit tarihleri derlemek genellikle iyi bir uygulamadır, bu nedenle Range özniteliği ve DateTime 
kullanılması önerilmez. 
























Aşağıdaki kod, öznitelikleri tek bir satırda birleştirmeyi gösterir: 


public class Movie 

{ 

public int Id { get; set; } 

[StringLength(60j MinimumLength = 3)] 
public string Title { get; set; } 

[Display(Name = "Release Date"), DataType(DataType.Date)] 
public DateTime ReleaseDate { get; set; } 

[RegularExpression(@" A [A-Z]+[a-zA-Z \s -]*$"), Required, StringLength(30)] 

public stning Genre { get; set; } 

[Range(l, 100), DataType(DataType.Currency)] 

[Column(TypeName = "decimal(18, 2)")] 
public decimal Pnice { get; set; } 

[RegularExpression(@" A [A-Z]+[a-zA-Z0-9""'\s-]*$"), StringLength(5)] 
public stning Rating { get; set; } 

} 


Serinin bir sonraki bölümünde, uygulamayı gözden geçiririz ve otomatik olarak oluşturulan Details ve Delete 
yöntemlerinde bazı geliştirmeler yaparsınız. 

Ek kaynaklar 

• Formlarla Çalışma 

• Genelleştirme ve yerelleştirme 

• Etiket yardımcılarına giriş 

• Yazar etiketi yardımcıları 


ÖNCEKİ 


İLERİ 








ASPNET Core uygulamasının Ayrıntılar ve silme 
yöntemlerini inceleyin 

4.12.2019 • 4 minutes to read ı Edit Online 


Tarafından Rick Anderson 

Film denetleyicisini açın ve Details yöntemi inceleyin: 

// GET: Movies/Details/5 

public async Task<IActionResult> Details(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var movie = await _context.Movie 

.FirstOrDefaultAsync(m => m.Id == id); 
if (movie == null) 

{ 

return NotFound(); 

} 

return View(movie); 

} 


Bu eylem yöntemini oluşturan MVC yapı iskelesi altyapısı, yöntemi çağıran bir HTTP isteğini gösteren bir açıklama 
ekler. Bu durumda, üç URL segmentine sahip bir GET isteği, Movies denetleyicisi, Details yöntemi ve bir id 
değeri. Bu kesimleri geri çağır Sfortup.csiçinde tanımlanmıştır. 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapControllerRoute( 
name: "default"., 

pattern: "{controller=Home}/{action=Index}/{id?}"); 

}); 

EF, FirstorDefaultAsync yöntemini kullanarak verileri aramanızı kolaylaştırır. Yöntemi içinde yerleşik olarak 
bulunan önemli bir güvenlik özelliği, kodun, onunla herhangi bir şey yapmayı denemeden önce arama yönteminin 
bir filmi buldığını doğrulamasından kaynaklanmaktadır. Örneğin, bir korsan 
http://iocaihost:{PORT}/Movies/Detaiis/ı bağlantıları tarafından oluşturulan URL 'yi 

http: //localhost:{P0RT}/Movies/Detaiis/i2345 (veya gerçek bir filmi temsil eden başka bir değer) gibi bir şeye 
değiştirerek siteye hata verebilir. Null bir filmi denetmediyseniz, uygulama bir özel durum oluşturur. 


Delete ve DeieteConfirmed yöntemlerini inceleyin. 













// GET: Movies/Delete/5 

public async Task<IActionResult> Delete(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var movie = await _context.Movie 

.FirstOrDefaultAsync(m => m.Id == id); 
if (movie == null) 

{ 

return NotFound(); 

} 

return View(movie); 

} 

// POST: Movies/Delete/5 
[HttpPost., ActionName("Delete")] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> DeleteConfirmed(int id) 

{ 

var movie = await _context.Movie.FindAsync(id); 

_context.Movie.Remove(movie); 
await _context.SaveChangesAsync(); 
return RedirectToAction(nameof(Index)); 

} 

http get Delete yöntemi belirtilen filmi silmediğini unutmayın. Bu, silme işlemini gönderebileceğiniz (HttpPost) 
filmin bir görünümünü döndürür. Bir GET isteğine yanıt olarak silme işlemi gerçekleştirme (veya bu konuyla ilgili 
olarak, düzenleme işlemi gerçekleştirme, oluşturma işlemi yapma veya verileri değiştiren başka bir işlem) bir 
güvenlik deliği açılır. 

Verileri silen [HttpPost] yöntemi, HTTP POST yöntemine benzersiz bir imza veya ad vermek için DeleteConfirmed 
olarak adlandırılır, iki yöntem imzası aşağıda gösterilmiştir: 

// GET: Movies/Delete/5 

public async Task<IActionResult> Delete(int? id) 

{ 


// POST: Movies/Delete/5 
[HttpPost , ActionName("Delete")] 
[ValidateAntiForgeryToken] 

public async Task<IActionResult> DeleteConfirmed(int id) 
{ 


Ortak dil çalışma zamanı (CLR), aşırı yüklenmiş yöntemlerin benzersiz bir parametre imzasına sahip olmasını 
gerektirir (aynı yöntem adı ancak farklı parametre listesi). Bununla birlikte, her ikisi de aynı parametre imzasına 
sahip olmak üzere iki Delete yöntemi (GET için bir tane ve diğeri) gerekir.(Her ikisi de parametre olarak tek bir 
tamsayıyı kabul etmelidir.) 

Bu sorunun iki yaklaşımı vardır, biri yöntemlere farklı adlar vermektir.Bu, önceki örnekte bulunan yapı iskelesi 
mekanizmasına göre yapılır. Ancak, bu küçük bir sorun ortaya çıkarır: ASP.NET bir URL 1 nin segmentlerini ada göre 
eylem yöntemlerine eşler ve bir yöntemi yeniden adlandırırsanız, yönlendirme normalde bu yöntemi bulamaz. 
Çözüm, örnekte gördüğünüz şeydir. Bu, DeleteConfirmed yöntemine ActionName("Deiete") özniteliğini eklemektir. 
Bu öznitelik, yönlendirme sistemi için eşleme gerçekleştirerek, bir POST isteği için/Delete/içeren bir URL 'nin 
DeleteConfirmed yöntemi bulacaktır. 










Özdeş adlara ve imzalara sahip yöntemler için bir diğer yaygın çalışma yapay, POST yönteminin imzasını bir ek 
(kullanılmamış) parametre içerecek şekilde değiştirecek. Bu, notused parametresini eklediğimiz sırada önceki bir 
gönderimiz tarafından yaptığımız şeydir. [HttpPost] Delete yöntemi için burada aynı şeyi yapabilirsiniz: 


// POST: Movies/Delete/6 
[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Delete(int id, bool notUsed) 


Azure'a Yayımlama 

Azure 'a dağıtma hakkında bilgi için bkz. öğretici: Azure App Service .NET Core ve SQL veritabanı Web uygulaması 
oluşturma. 


ÖNCEKİ 






İlk Blazor uygulamanızı oluşturma 

9.12.2019 • 12 minutes to read ı Edit Online 


Daniel Roth ve Luke Latham tarafından 


IMPORTANT 

Önizlemede Blazor VVeelsembly 

Blazor sunucusu ASP.NET Core 3,0 ' de desteklenir. Blazor VVebAssembly ASP.NET Core 3,1 için önizlemededir. 


Bu öğreticide bir Blazor uygulamasının nasıl oluşturulacağı ve değiştirileceği gösterilmektedir. 

Bu öğreticide bir Blazor projesi oluşturmak için ASP.NET Core Blazor kullanmaya başlama makalesindeki 
yönergeleri izleyin. Projeyi ToDoListolarak adlandırın. 

Derleme bileşenleri 

1. Sayfalar klasöründe uygulamanın üç sayfasının her birine gidin: giriş, sayaç ve veri getirme. Bu sayfalar, 
Razor bileşen dosyaları dizini. Razor, Counter. Razorve fetchdata. Rozortarafından uygulanır. 

2. Sayaç sayfasında, bir sayfa yenilemesi olmadan sayacı artırmak için bana tıklama düğmesini seçin. Bir Web 
sayfasında normal olarak bir sayacı artırma, JavaScript yazmayı gerektirir. Blazor, bunun yerine yazabilirsiniz 
C#. 

3. Counter. Razor dosyasındaki counter bileşeninin uygulamasını inceleyin. 

Pages/Counter. Razor: 

@page "/counter" 

<hl>Counter</hl> 

<p>Current count: @currentCount</p> 

cbutton class="btn btn-primary" @onclick="IncrementCount">Click me</button> 

@code { 

private int currentCount = 0; 

private void IncrementCount() 

{ 

currentCount++; 

} 

} 

Counter bileşenin kullanıcı arabirimi HTML kullanılarak tanımlanır. Dinamik işleme mantığı (örneğin, 
döngüler, koşullar, ifadeler) C# Razoradlı gömülü bir sözdizimi kullanılarak eklenir. HTML biçimlendirme ve 
C# işleme mantığı, derleme zamanında bir bileşen sınıfına dönüştürülür. Oluşturulan .NET sınıfının adı dosya 
adıyla eşleşir. 

Bileşen sınıfının üyeleri bir @code bloğunda tanımlanmıştır. @code bloğunda, bileşen durumu (özellikler, 
alanlar) ve yöntemler olay işleme için veya diğer bileşen mantığını tanımlamak için belirtilir. Bu Üyeler daha 
sonra bileşenin işleme mantığının bir parçası olarak ve olayları işlemek için kullanılır. 











Bana tıklama düğmesi seçildiğinde: 


• counter bileşenin kayıtlı onciick işleyicisine ( incrementcount yöntemi) denir. 

• counter bileşeni, işleme ağacını yeniden oluşturur. 

• Yeni işleme ağacı öncekiyle karşılaştırılır. 

• Yalnızca Belge Nesne Modeli (DOM) üzerinde yapılan değişiklikler uygulanır.Görünen sayı 
güncelleştirildi. 

4. Sayıyı bir C# yerine iki ile artırmak için counter bileşenin mantığını değiştirin. 

@page "/counter" 

<hl>Counter</hl> 

<p>Current count: @currentCount</p> 

<button class="btn btn-primary" @onclick="IncrementCount">Click me</button> 

@code { 

private int currentCount = 0; 

private void IncrementCount() 

{ 

currentCount += 2; 

} 

} 

5. Değişiklikleri görmek için uygulamayı yeniden derleyin ve çalıştırın. Ben tıklama düğmesini seçin. Sayaç iki 
olarak artar. 


Bileşenleri kullanma 

Bir bileşeni, bir HTML söz dizimini kullanarak başka bir bileşene ekleyin. 

1. index bileşenine bir <counter /> öğesi ekleyerek uygulamanın index bileşenine counter bileşenini 
ekleyin ( lndex. Razor). 

Bu deneyim için Blazor VVebAssembly kullanıyorsanız, index bileşeni tarafından surveyPrompt bir bileşen 
kullanılır. <surveyPrompt> öğesini bir <counter /> öğesiyle değiştirin. Bu deneyim için bir Blazor sunucusu 
uygulaması kullanıyorsanız, index bileşenine <counter /> öğesini ekleyin: 

Pages/lndex. Razor: 


@page "/" 

<hl>Hello, world!</hl> 

Welcome to your new app. 

<Counter /> 

2. Uygulamayı yeniden derleyin ve çalıştırın. index bileşeni kendi sayacıdır. 


Bileşen parametreleri 

Bileşenler de parametrelere sahip olabilir. Bileşen parametreleri, bileşen sınıfında [Parameter] özniteliğiyle ortak 
özellikler kullanılarak tanımlanır. Biçimlendirme içindeki bir bileşenin bağımsız değişkenlerini belirtmek için 
öznitelikleri kullanın. 




















1. Bileşenin @code C# kodunu güncelleştirin: 


• [Parameter] özniteliğiyle ortak bir incrementAmount özelliği ekleyin. 

• currenteount değerini artırdığınızda incrementAmount kullanmak için incrementcount yöntemini 
değiştirin. 

Pages/Counter. Razor: 

@page "/counter" 

<hl>Counter</hl> 

<p>Current count: @currentCount</p> 

<button class="btn btn-primary" @onclick="IncrementCount">Click me</button> 

@code { 

private int currentCount = 0; 

[Parameter] 

public int İncrementAmount { get; set; } = 1; 

private void IncrementCount() 

{ 

currentCount += İncrementAmount; 

} 

} 

1. Özniteliği kullanarak index bileşeninin <counter> öğesinde bir incrementAmount parametresi belirtin. 
Sayacı on olarak artırmak için değeri ayarlayın. 

Pages/lndex. Razor: 

@page "/" 

<hl>Hello, world!</hl> 
lAİelcome to your new app. 

<Counter IncrementAmount="10" /> 

2. index bileşenini yeniden yükleyin. Beni tıklama düğmesi seçildiğinde sayaç on bir kez artar, counter 
bileşenindeki sayaç bir artış ile devam eder. 


Bileşenlere yönlendir 

Counter. Razor dosyasının en üstündeki @page yönergesi, counter bileşeninin bir yönlendirme uç noktası 
olduğunu belirtir, counter bileşeni /counter gönderilen istekleri işler. @page yönergesi olmadan, bileşen 
yönlendirilmiş istekleri işlemez, ancak bileşen diğer bileşenler tarafından hala kullanılabilir. 


Bağımlılık ekleme 

Blazor sunucusu deneyimi 

Blazor sunucu uygulamasıyla çalışıyorsanız, WeatherForecastService hizmeti bir tek Startup.ConfigureServices 
olarak kaydedilir. Uygulamanın tamamında bağımlılık ekleme (dı)yoluyla hizmetin bir örneği mevcuttur: 


















public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRazorPages(); 

Services.AddServerSideBlazor(); 

Services.AddSingleton<WeatherForecastService>(); 

} 

@inject yönergesi, ueatherForecastservice hizmetinin örneğini FetchData bileşenine eklemek için kullanılır. 
Pages/FetchData. Razor. 

@page "/fetchdata" 

@using ToDoList.Data 

(Şinject 1/JeatherForecastService ForecastService 

FetchData bileşeni, weatherForecast nesnelerinin bir dizisini almak için, ForecastService olarak eklenen hizmeti 
kullanır: 


@code { 

private WeatherForecast[ ] forecasts; 


protected override async Task OnInitializedAsync() 

{ 

forecasts = await ForecastService.GetForecastAsync(DateTime.Now); 

} 


Blazor VVeelsembly deneyimi 

Blazor WebAssembly uygulamasıyla çalışıyorsanız, Wwwroot/Sample-Data klasöründeki Hava durumu. JSON 
dosyasından Hava durumu tahmin verileri almak için Httpciient eklenir. 

Pages/FetchData. Razor: 

(Şinject HttpClient Http 


protected override async Task OnInitializedAsync() 

{ 

forecasts = 

await Http.GetisonAsync<WeatherForecast[]>("sample-data/weather.json"); 

} 


@foreach döngüsü, her tahmin örneğini Hava durumu verileri tablosunda bir satır olarak işlemek için kullanılır: 








ctable class="table"> 

<thead> 

<tr> 

<th>Date</th> 

<th>Temp. (C)</th> 

<th>Temp. (F)</th> 

<th>Summary</th> 

</tr> 

</thead> 

<tbody> 

@foreach (var forecast in forecasts) 

{ 

<tr> 

<td>@forecast.Date.ToShortDateString()</td> 
<td>@forecast.TemperatureCc/td> 
<td>@forecast.TemperatureF</td> 
<td>@forecast.Summary</td> 

</tr> 

} 

</tbody> 

</table> 


Yapılacaklar listesi oluşturma 

Uygulamaya basit bir yapılacaklar listesi uygulayan yeni bir bileşen ekleyin. 

1. Uygulamalar klasörüne Todo. Razor adlı boş bir dosya ekleyin: 

2. Bileşen için ilk biçimlendirmeyi belirtin: 

@page "/todo" 

<hl>Todo</hl> 

3. Gezinti çubuğuna Todo bileşenini ekleyin. 

NavMenu bileşeni ( Shared/NavMenu. Razor) uygulamanın düzeninde kullanılır. Düzenler, uygulamadaki 
içeriğin çoğaltılmasını önlemenize olanak sağlayan bileşenlerdir. 

Aşağıdaki liste öğesi işaretlemesini paylaşdan/NavMenu. Razor dosyasında var olan liste öğelerinin altına 
ekleyerek Todo bileşeni için bir <NavLink> öğesi ekleyin: 

<li class="nav-item px-3"> 

<Navl_ink class="nav-link" href="todo"> 

<span class="oi oi-list-rich" aria-hidden="true"x/span> Todo 
</NavLink> 

</li> 

4. Uygulamayı yeniden derleyin ve çalıştırın. Todo bileşeni bağlantısının çalıştığından emin olmak için yeni 
Todo sayfasını ziyaret edin. 

5. Bir Todo öğesini temsil eden bir sınıfı tutmak için projenin köküne bir Todoltem.es dosyası ekleyin. Todoitem 
sınıfı için C# aşağıdaki kodu kullanın: 










public class Todoltem 

{ 

public string Title { get; set; } 
public bool IsDone { get; set; } 

} 

6. Todo bileşenine geri dönün (Pages/Todo. Razor): 

• @code bloğundaki Todo öğeleri için bir alan ekleyin. Todo bileşeni, Todo listesinin durumunu korumak 
için bu alanı kullanır. 

• Her Todo öğesini bir liste öğesi ( <ii> ) olarak işlemek için sıralanmamış liste işaretlemesi ve bir foreach 
döngüsü ekleyin. 

@page "/todo" 

<hl>Todo</hl> 

<ul> 

(Şforeach (var todo in todos) 

{ 

<li>@todo.Title</li> 

} 

</ul> 

@code { 

private IList<TodoItem> todos = new List<TodoItem>(); 

} 

7. Uygulama, listeye Todo öğeleri eklemek için Kullanıcı arabirimi öğeleri gerektirir.Sıralanmamış listenin ( 

<ui>.. .</ui> ) altına bir metin girişi ( <input> ) ve bir düğme ( <button> ) ekleyin: 

@page "/todo" 

<hl>Todo</hl> 

<ul> 

(Şforeach (var todo in todos) 

{ 

<li>@todo.Title</li> 

} 

</ul> 

<input placeholder="Something todo" /> 

<button>Add todo</button> 

@code { 

private IList<TodoItem> todos = new List<TodoItem>(); 

} 

8. Uygulamayı yeniden derleyin ve çalıştırın. Todo Ekle düğmesi seçildiğinde, bir olay işleyicisi düğmeye 
kablolu olmadığı için hiçbir şey olmaz. 

9. Todo bileşenine bir AddTodo yöntemi ekleyin ve @onciick özniteliğini kullanarak düğme seçimleri için 
kaydedin. Düğme seçildiğinde C# AddTodo yöntemi çağrılır: 












cinput placeholder="Something todo" /> 
<button @onclick="AddTodo">Add todo</button> 


@code { 

private IList<TodoItem> todos = new ListcTodoItem>(); 

private void AddTodo() 

{ 

// Todo: Add the todo 

} 

} 

10. Yeni Todo öğesinin başlığını almak için, @code bloğunun üst kısmına bir newTodo dize alanı ekleyin ve 
<input> öğesindeki bind özniteliğini kullanarak metin girişinin değerine bağlayın: 

private IList<TodoItem> todos = new ListcTodoItem>(); 
private string newTodo; 


cinput placeholder="Something todo" @bind="newTodo" /> 

11. AddTodo yöntemini, belirtilen başlığa sahip Todoitem listeye eklemek için güncelleştirin. newTodo boş bir 
dizeye ayarlayarak metin girişinin değerini temizleyin: 


@page "/todo" 

<hl>Todo</hl> 

<ul> 

(Sforeach (var todo in todos) 

{ 

cli>@todo.Titlec/li> 

} 

</ul> 

cinput placeholder="Something todo" @bind="newTodo" /> 
cbutton @onclick="AddTodo">Add todoc/button> 

@code { 

private IListcTodoItem> todos = new ListcTodoItem>(); 
private string newTodo; 

private void AddTodo() 

{ 

if (!string.IsNullOrWhiteSpace(newTodo)) 

{ 

todos.Add(new Todoitem { Title = newTodo }); 
newTodo = string.Empty; 

} 

} 


12. Uygulamayı yeniden derleyin ve çalıştırın. Yeni kodu test etmek için Todo listesine bazı Todo öğeleri ekleyin 

13. Her Todo öğesi için başlık metni düzenlenebilir hale getirilebilir ve bir onay kutusu kullanıcının tamamlanm 
öğeleri izlemesine yardımcı olabilir. Her Todo öğesi için bir onay kutusu girişi ekleyin ve değerini isDone 
özelliğine bağlayın. @todo.Title , @todo.Title bağlantılı cinput> bir öğe olarak değiştirin: 













<ul> 

@foreach (var todo in todos) 

{ 

<li> 

<input type="checkbox" @bind="todo.IsDone" /> 

<input @bind="todo.Title" /> 

</li> 

} 

</ul> 

14. Bu değerlerin bağlandığını doğrulamak için <hi> üst bilgisini, tamamlanmamış olan Todo öğelerinin 
sayısının sayısını gösterecek şekilde güncelleştirin ( isDone faise ). 

<hl>Todo (@todos.Count(todo => Itodo.IsDone))</hl> 

15. Tamamlanan Todo bileşeni (Sayfalar/Todo. Razor): 


@page "/todo" 

<hl>Todo (@todos.Count(todo => Itodo.IsDone))</hl> 

<ul> 

(Şforeach (var todo in todos) 

{ 

<li> 

<input type="checkbox" @bind="todo.IsDone" /> 
<input @bind="todo.Title" /> 

</li> 

} 

</ul> 

<input placeholder="Something todo" @bind="newTodo" /> 
<button @onclick="AddTodo">Add todo</button> 

@code { 

private IList<TodoItem> todos = new List<TodoItem >(); 
private string newTodo; 

private void AddTodo() 

{ 

if (!string.IsNullOrWhiteSpace(newTodo)) 

{ 

todos.Add(new Todoltem { Title = newTodo }); 
newTodo = string.Empty; 

} 

} 


16. Uygulamayı yeniden derleyin ve çalıştırın. Yeni kodu test etmek için Todo öğeleri ekleyin. 


ASP.NET Core Razor bileşenleri oluşturma ve kullanma 







Öğretici: ASRNET Core bir Web API 'SI oluşturma 

10.12.2019 • 47 minutes to read ı Edit Online 


Tarafından Rick Anderson ve Mike VVasson 

Bu öğretici, bir web API ASP.NET Core ile oluşturmaya ilişkin temel bilgileri öğretir. 

Bu öğreticide şunların nasıl yapıladığını öğreneceksiniz: 

• Bir Web API projesi oluşturun. 

• Bir model sınıfı ve bir veritabanı bağlamı ekleyin. 

• CRUD yöntemleriyle bir denetleyiciyi dolandırın. 

• Yönlendirmeyi, URL yollarını ve dönüş değerlerini yapılandırın. 

• Web API'si Postman ile çağırın. 

Sonunda, bir veritabanında depolanan "yapılacaklar" öğelerini yönetebilmek için bir Web API 'SI vardır. 

Genel bakış 

Bu öğretici yandaki API oluşturur: 


API 

AÇIKLAMA 

İSTEK GÖVDESİ 

YANIT GÖVDESİ 

/Api/Todoltems al 

Tüm yapılacak iş öğeleri al 

Yok. 

Yapılacaklar öğelerinin bir 
dizisi 

/Api/Todoltems/{id} al 

Bir öğeyi Kimliğine göre Al 

Yok. 

Yapılacak iş öğesi 

POST/api/Todoltems 

Yeni Öğe Ekle 

Yapılacak iş öğesi 

Yapılacak iş öğesi 

/Api/Todoltems/{id} koy 

Mevcut öğeyi güncelleştirin 

Yapılacak iş öğesi 

Yok. 

/Api/Todoltems/{id) SİL 

Öğeyi Sil 

Yok. 

Yok. 


Aşağıdaki diyagramda, bu uygulamanın tasarımını gösterir. 























Prerequisites 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• ASP.net ve Web geliştirme iş yüküyle Visual Studio 2019 16,4 veya üzeri 

• .NET Core 3,1 SDK veya üzeri 


Birvveb projesi oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Dosya menüsünden Yeni > Proje' yi seçin. 

• ASP.N ET Core Web uygulaması şablonunu seçin ve İleri' ye tıklayın. 

• Projeyi TodoApi olarak adlandırın ve Oluştur' a tıklayın. 

• Yeni bir ASP.NET Core Web uygulaması oluştur iletişim kutusunda, .net Core ve ASP.NET Core 3,1 ' un 

seçili olduğunu doğrulayın. API şablonunu seçin ve Oluştur' a tıklayın. 


X 


Create a new ASP.NET Core Web Application 


.NET Core 

* 

ASP.NET Core 3.0 

• 



^ Empty 

An empty project template tor creating an ASP.NET Core application. This template does not have any 
content in it 



A project template for creating an ASP.NET Core application with an example Controller tor a RESTful HTTP 
service. This template can also be used for ASP.NET Core MVC Views and Controllers. 


VVorker Service 

An empty project template for creating a vvorker service. 


Web Application 


A project template for creating an ASP.NET Core application with example ASP.NET Core Razor Pages 
content 




Web Application (Model-Vievv-Controller) 

A project template for creating an ASP.NET Core application with example ASP.NET Core MVC Vievvs and 
Controllers. This template can also be used for RESTful HTTP Services. 


--- nRPr Ç*»ruirp 

Get additional project templates 


Authentication 

No Authentication 

Change 


Advanced 

[71 Configure for HTTPS 
I Enable Docker Support 
(Reguires Docker Desktop) 


Author: Microsoft 

Source: SDK 3.0.100-preview7-012801 


Back Create 


API'yi test etme 

Proje şablonu oluşturur bir weatherForecast API. Çağrı Get uygulamayı test etmek için bir tarayıcıdan yöntemi. 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Uygulamayı çalıştırmak için CTRL + F5 tuşlarına basın. Visual Studio bir tarayıcı ile başlatarak 
https ://iocaihost:<port>/weatherForecast burada <port> bir rastgele seçilen bağlantı noktası numarasıdır. 





















11S Express sertifika güven varsa soran bir iletişim kutusu alırsanız seçin Evet, içinde Güvenlik Uyarısı ardından, 
görüntülenen iletişim seçin Evet. 

Aşağıdakine benzer bir JSON döndürülür: 


[ 

{ 

"date": "2019-07-16119:04:05.7257911-06:00", 
"temperatureC": 52, 

"temperatureF": 125, 

"summary": "Mild" 

b 

{ 

"date": "2019-07-17T19:04:05.7258461-06:00", 
"temperatureC": 36, 

"temperatureF": 96, 

"summary": "Warm" 

b 

{ 

"date": "2019-07-18T19:04:05.7258467-06:00", 
"temperatureC": 39, 

"temperatureF": 102, 

"summary": "Cool" 

b 

{ 

"date": "2019-07-19T19:04:05.7258471-06:00", 
"temperatureC": 10, 

"temperatureF": 49, 

"summary": "Bracing" 

b 

{ 

"date": "2019-07-20T19:04:05.7258474-06:00", 
"temperatureC": -1, 

"temperatureF": 31, 

"summary": "Chilly" 

} 


Bir model sınıfı ekleme 

A modeli uygulamayı yöneten verilerini temsil eden sınıflar kümesidir. Tek bir modeldir bu uygulama için 
sınıfı. 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• içinde Çözüm Gezgini, projeye sağ tıklayın. Seçin ekleme > yeni klasör. Klasör adı modelleri. 

• Sağ modelleri klasörü ve select Ekle > sınıfı. Sınıf adı Todoıtem seçip Ekle. 

• Şablon kodunu aşağıdaki kodla değiştirin: 


Todoltem 





namespace TodoApi.Models 

{ 

public class Todoltem 

{ 

public long Id { get; set; } 
public stning Name { get; set; } 
public bool IsComplete { get; set; } 

} 

} 

id Özelliği işlevlerinin bir ilişkisel veritabanında benzersiz anahtar. 

Model sınıfları herhangi bir projede gidip ancak modelleri klasörü, kural olarak kullanılır. 

Veritabanı bağlamı Ekle 

Veritabanı bağlamı koordine eden bir veri modeli için Entity Framevvork işlevsellik ana sınıftır. Bu sınıf türetme 
tarafından oluşturulan Microsoft.EntityFrameworkCore.DbContext Simfl. 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

Microsoft. EntityFramevvorkCore. SqlServer ekleyin 

• Araçlar menüsünde nuget Paket Yöneticisi > çözüm İçin NuGet Paketlerini Yönet 1 i seçin. 

• Araştır sekmesini seçin ve arama kutusuna Microsoft. Entityframevvorkcore. SqlServer yazın. 

• Sol bölmedeki Microsoft. EntityFramevvorkCore. SqlServer öğesini seçin. 

• Sağ bölmedeki Proje onay kutusunu seçin ve ardından Install' ı seçin. 

• Microsoft.EntityFrameworkCore.inMemory NuGet paketini eklemek için yukarıdaki yönergeleri kullanın. 


NuGet • Solution 

Brovvse 


TodoContextcs Todoltem.es TodoApi 


Installed Updates Consolidate 


Manage Packages for Solution 




Microsoft.EntityFrameworkCore.SqlServer İ by Microsoft. 3 v30 ° 
Microsoft SQL Server database provıder for Entity Framework Core. 



Microsoft.EntityFramevvorkCore 5 by Microsoft 52.3M dovvnlc v30 ° 
Entity Framework Core is a lightvveight and extensible version of the 
popular Entity Framevvork data access technology. 



Microsoft.EntityFramevvorkCore.Relational 5 by Microsoft, 5 v30 ° 
Shared Entity Framevvork Core components for relatîonal database 
providers. 



Microsoft.EntityFramevvorkCore.Analyzers 5 by Microsoft, 3 v30 ° 
CSharp Analyzers for Entity framevvork Core. 



Microsoft.EntityFramevvorkCore.Design O by Microsoft, 34.11 v30 ° 
Shared design-time components for Entity Framevvork Core tools. 


Package source: nuget.org - 0 


| Microsoft.EntityFrame% nugetorg 




Versions - O 



[7] Project 

Version 


]✓! TodoApi 



Installed: 

not installed 



Version: 




latest stable 3.0.0 

Install 

1 





Microsoft.EntityFramevvorkCore.Tools O by Microsoft, 28.8M 
Entity Framevvork Core Tools for the NuGet Package Manager Console in 
Visual Studio. 


V3.0.0 


Each package is licensed to you by its ovvner. NuGet is not responsible for, nor does it 
grant any licenses to, third-party packages. 


(V) Options 


Description 

Microsoft SQL Server database provider for Entity 
Framevvork Core. 

Version: 3.0.0 


□ 


Do not show this again 


Author(s): Microsoft 




















TodoContext veritabanı bağlamını ekleme 

• Sağ modelleri klasörü ve select Ekle > sınıfı. Sınıf adı TodoContext tıklatıp Ekle. 

• Aşağıdaki kodu girin: 

using Microsoft.EntityFrameworkCore; 

namespace TodoApi.Models 
{ 

public class TodoContext : DbContext 
{ 

public TodoContext(DbContextOptions<TodoContext> options) 

: base(options) 

{ 

} 

public DbSet<TodoItem> Todoltems { get; setj } 

} 

} 


Veritabanı bağlamı Kaydet 

ASP.NET Core DB bağlamı gibi hizmetler ile kaydedilmelidir bağımlılık ekleme (dı) kapsayıcı. Kapsayıcı hizmeti 
denetleyicilerine sağlar. 

Güncelleştirme Startup.es aşağıdaki vurgulanmış kodu: 



// Unused usings removed 

using Microsoft.AspNetCore.Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.Extensions.Configuration; 

using Microsoft.Extensions.DependencyInjection; 

using Microsoft.Extensions.Hosting; 

using Microsoft.EntityFrameworkCore; 

using TodoApi.Models; 

namespace TodoApi 

{ 

public class Startup 

{ 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<TodoContext>(opt => 
opt.UseInMemoryDatabase("TodoList")); 

Services.AddControllers(); 

} 

public void Configure(IApplicationBuilder app., IklebHostEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

app.UseHttpsRedirection(); 

app.UseRouting(); 

app.UseAuthorization(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapControllers(); 

}); 

} 

} 

} 


Yukarıdaki kod: 

• Kullanılmayan kaldırır using bildirimleri. 

• Veritabanı bağlamı Dİ kapsayıcıya ekler. 

• Veritabanı bağlamı bir bellek içi veritabanına kullanacağını belirtir. 

Denetleyiciyi bir denetleyiciye katlama 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

• Sağ denetleyicileri klasör. 

• > yeni yapı İskelesi öğesi Ekle ' yi seçin. 


• Entity Framevvork kullanarak ve eylemler İçeren API denetleyicisi 1 ni seçin ve ardından Ekle' yi seçin. 




• API denetleyiciyi eylemler İle Ekle ' de Entity Framevvork iletişim kutusunu kullanarak: 

o Model sınıfında Todoltem (TodoApi. modeller) öğesini seçin, 
o Veri bağlamı sınıfında TodoContext (TodoApi. modeller) öğesini seçin, 
o Add (Ekle) seçeneğini belirleyin. 

Oluşturulan kod: 

• Bir API denetleyicisi sınıfı yöntemleri olmadan tanımlar. 

• Sınıfı [ApiControiler] özniteliğiyle işaretler. Bu öznitelik, denetleyicinin web API'si isteklerine yanıt verdiğini 
gösterir. Öznitel iğin izin aldığı belirli davranışlar hakkında daha fazla bilgi için bkz. ASP.NET Core ile Web API 
’Leri oluşturma. 

• Veritabanı bağlamı eklemesine Dİ kullanır ( TodoContext ) içine denetleyici. Her bir veritabanı bağlamı kullanılan 
CRUD denetleyici yöntemleri. 

PostTodoltem Create metodunu inceleyin 

PostTodoitem ' deki return ifadesini, NameOf işlecini kullanacak şekilde değiştirin: 

// POST: api/Todoltems 
[HttpPost] 

public async Task<ActionResult<TodoItem>> PostTodoItem(TodoItem todoltem) 

{ 

_context.TodoItems.Add(todoltem); 
await _context.SaveChangesAsync(); 

//return CreatedAtAction("GetTodoItem"j new { id = todoltem.Id }, todoltem); 
return CreatedAtAction(nameof(GetTodoltem ), new { id = todoltem.Id }, todoltem); 

} 

Yukarıdaki kod, [HttpPost] öznitel iğiyle gösterildiği gibi bir http post yöntemidir. Yöntemi, HTTP isteği 
gövdesinden Yapılacaklar öğenin değerini alır. 

CreatedAtAction Yöntemi: 

• Başarılı olursa bir HTTP 201 durum kodu döndürür. HTTP 201 sunucuda yeni bir kaynak oluşturan bir HTTP 
POST yöntemi için standart yanıttır. 

• Yanıta bir konum üst bilgisi ekler. Location üstbilgisi, yeni oluşturulan Yapılacaklar öğesinin URI 'sini belirtir. 
Daha fazla bilgi için 10.2.2 201 oluşturuldu. 

• Location üst bilgisinin URI 'sini oluşturmak için GetTodoltem eyleme başvurur. C# nameof anahtar sözcüğü, 
CreatedAtAction çağrısında eylem adının sabit kodlanmasını önlemek için kullanılır. 

Postman yükleme 

Bu öğreticide Postman web API'si test etmek için kullanılır. 

• Yükleme Postman 

• Web uygulaması başlatın. 

• Postman'i başlatın. 

• Devre dışı SSL sertifika doğrulama 

• Dosya > ayarları ' ndan (genel sekmesinden) SSL sertifikası doğrulamasınıdevre dışı bırakın. 

VVARNING 

Test denetleyicisi sonra SSL sertifika doğrulamasını yeniden etkinleştirin. 










Postman ile test PostTodoltem 

• Yeni bir istek oluşturun. 

• HTTP yöntemini post olarak ayarlayın. 

• Seçin gövdesi sekmesi. 

• Seçin ham radyo düğmesi. 

• Tür kümesine JSON (application/json). 

• istek gövdesinde bir yapılacak iş öğesi için JSON girin: 

{ 

"name":"walk dog", 

"isComplete":true 

} 


• Gönder i seçin. 


O Postman 

- 

□ 

X 

File Edit Vievv Help 







o 

New ▼ 



post Create 
► Create 


cet https://localhost:500l/apl/Todolı • + 


No Environment 


POST ▼ https://localhost:5001/api/Todoltems 

Params Auth Headers (9) Body • Pre-req. Tests Cookies Code G5J(0) 

• none # form-data • x-www-form-urlencoded # raw • binary 
JSON (application/json) ▼ Beautify 

5 

2 "nam«":"walk dog*'j 

"isComplete" :true 

4 W 


Status 201 Created Time 178ms Size: 247 B 


* O O 

Examples (0) ▼ 

Save ▼ 

Dovvnload 


Body Cookies Headers (5) 


est Results 


Date — Tue, 16 Jul 2019 23 19 08 GMT 
Content-Type — applıcatıon/json; ctıarset=utf-8 
Server-. Kestrel 
Transfer-Encoding — chunked 


Location — https //localhosl 5001/api/Todollems/1 



m q s 

■O* Bootcamp 

Build 

Browse 

a & © 


Konum üst bilgisi URI test 

• Seçin üstbilgileri sekmesinde yanıt bölmesi. 

• Kopyalama konumu üst bilgi değeri: 



















O Postman 

- 
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X 

File Edit View Help 





post Create 

► Create 


git https://1ocalhost:5001/apl/Todolı • + 


• none • form-data • x-www-form-urlencoded • raw # binary 
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• Yöntemini GET öğesine Ayarla. 

• URI 'yi yapıştırın (Örneğin, https://localhost:5001/api/TodoItems/l ). 

• Gönder i seçin. 


GET yöntemlerini inceleyin 

iki GET uç noktası bu yöntemleri uygulayın: 

• GET /api/Todoltems 

• GET /api/TodoItems/{id} 

Tarayıcıdan veya Postman 'dan iki uç noktayı çağırarak uygulamayı test edin. Örneğin: 

• https://localhost:5001 /api/Todoltems 

• https://localhost:5001/api/Todoltems/1 

Aşağıdakine benzer bir yanıt, GetTodoitems çağrısı tarafından üretilir: 

[ 

{ 

"id": 1 , 

"name": "Iteml", 

"İsComplete": false 

} 

] 

Postman ile test al 

• Yeni bir istek oluşturun. 

• HTTP yöntemi kümesine alma. 

• istek U R L 1 Sİ kümesine https://localhost:<port>/api/TodoItems .Örneğin: https://localhost:5001/api/TodoItems . 

• Ayarlama iki bölme görünümü postman'deki. 

• Gönder i seçin. 


Bu uygulama, bellek içi bir veritabanını kullanır. Uygulama durdurulup başlatılırsa, önceki G ET isteği herhangi bir 





















veri döndürmez. Hiçbir veri döndürülmezse, verileri uygulamaya gönderin . 

URL Yönlendirme ve yolları 

[HttpGet] Özniteliği bir HTTP GET isteğine yanıt vermeden bir yöntemi gösterir. Her yöntem için URL yolu şu 
şekilde oluşturulur: 

• Denetleyicinin şablonu dizesi ile başlayıp Route özniteliği: 

[Route("api/[controller]")] 

[ApiController] 

public class TodoltemsController : ControllerBase 
{ 

private readonly TodoContext _context; 

public TodoItemsController(TodoContext context) 

{ 

_context = context; 

} 

• Değiştirin [controiler] denetleyicinin adı ile kural tarafından olduğu "Controller" soneki eksi denetleyici 
sınıfı adı. Bu örnek için denetleyici sınıfı adı todoıtemsdenetleyicisidir, bu nedenle denetleyicinin adı 
"todoıtems" olur. AS P.N ET Core yönlendirme büyük/küçük harfe duyarlıdır. 

• [HttpGet] özniteliğinin bir yol şablonu varsa (örneğin, [HttpGet("products")] ), yola ekleyin. Bu örnek, bir 
şablon kullanmaz. Daha fazla bilgi için özniteliği Http [eylem] özniteliği ile yönlendirme. 

Aşağıdaki GetTodoitem yöntemi "{id}" yapılacak iş öğesi benzersiz tanımlayıcısı için bir yer tutucu değişkendir. 
GetTodoitem çağrıldığında, URL 'deki "{id}" değeri id parametresindeki yöntemine sağlanır. 

// GET: api/TodoItems/5 
[HttpGet("{id}") ] 

public async Task<ActionResult<TodoItem>> GetTodoItem(long id) 

{ 

var todoltem = await _context.Todoltems.FindAsync(id); 

if (todoltem == null) 

{ 

return NotFound(); 

} 

return todoltem; 

} 


Döndürülen değerler 

Dönüş türünü GetTodoitems ve GetTodoitem yöntemler actionresult öğesini <T > türü. AS P.N ET Core, nesneyi 
otomatik olarak serileştiren JSON ve yanıt iletisinin gövdesine JSON yazar.Yanıt kodu 200 bu dönüş türü için 
olduğu varsayılırsa işlenmeyen özel durumlar vardır, işlenmeyen özel durumları 5xx hatalarla karşılaşırsanız çevrilir. 

ActionResuit dönüş türleri, geniş HTTP durum kodları temsil edebilir.Örneğin, GetTodoitem iki farklı durum 
değerleri döndürebilir: 

• Öğe istenen kimliği eşleşirse, yöntem bir 404 döndürür NotFound hata kodu. 

• Aksi takdirde yöntem bir JSON yanıt gövdesine 200 döndürür.Döndüren item sonuçları bir HTTP 200 yanıtı. 


PutTodoltem yöntemi 


















PutTodoitem yöntemini inceleyin: 


// PUT: api/Todoltems/S 
[HttpPut("{id}") ] 

public async Task<IActionResult> PutTodoItem(long id, Todoltem todoltem) 

{ 

if (id != todoltem.Id) 

{ 

return BadRequest(); 

} 

_context.Entry(todoltem).State = EntityState.Modifiedj 

try 

{ 

await _context.SaveChangesAsync(); 

} 

catch (DbUpdateConcurrencyException) 

{ 

if (!TodoItemExists(id)) 

{ 

return NotFound(); 

} 

else 

{ 

throw; 

} 

} 

return NoContent(); 

} 

PutTodoitem benzer PostTodoitem , HTTP PUT kullanır.Yanıt 204 (içerik yok). HTTP belirtimine göre bir PUT isteği 
tüm güncelleştirilmiş varlık yalnızca değişiklikler değil göndermek istemci gerektirir. Kısmi güncelleştirmeleri 
desteklemek için kullanma HTTP PATCH. 

PutTodoitem çağırırken bir hata alırsanız, veritabanında bir öğe olduğundan emin olmak için get çağırın. 

Test PutTodoitem yöntemi 

Bu örnek, uygulama her başlatıldığında başlatılmış olması gereken bellek içi bir veritabanını kullanır. Bir PUT çağrısı 
yapmadan önce veritabanında bir öğe olmalıdır. PUT çağrısı yapmadan önce veritabanında bir öğe olduğundan 
emin olmak için GET çağrısı yapın. 

İD = 1 olan Yapılacaklar öğesini güncelleştirin ve adını "Feed balık" olarak ayarlayın: 

{ 

"ID" : 1 , 

"name":"feed fish", 

"isComplete":true 

} 


Aşağıdaki görüntüde, Postman güncelleştirme gösterilmektedir: 
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DeleteTodoltem yöntemi 

DeieteTodoitem yöntemini inceleyin: 

// DELETE: api/TodoItems/5 
[ElttpDelete( "{id}") ] 

public async Task<ActionResult<TodoItem>> DeleteTodoItem(long id) 

{ 

var todoltem = await _context.Todoltems.FindAsync(id); 
if (todoltem == null) 

{ 

return NotFound(); 

} 

_context.Todoltems.Remove(todoltem); 
await _context.SaveChangesAsync(); 

return todoltem; 

} 

DeleteTodoltem Yanıt 204 (içerik yok). 

Test DeleteTodoltem yöntemi 

Postman bir yapılacak iş öğesini silmek için kullanın: 

• Yöntem kümesine delete . 

• Silinecek nesnenin URI 'sini ayarlayın (örneğin https://iocaihost:500i/api/Todoitems/ı ). 

• Gönder i seçin. 

JavaScript ile Web API 'sini çağırma 

Bkz. öğretici: JavaScript ile ASP.N ET Core Web API 'Si çağırma. 

Bu öğreticide şunların nasıl yapıladığını öğreneceksiniz: 



















• Bir Web API projesi oluşturun. 

• Bir model sınıfı ve bir veritabanı bağlamı ekleyin. 

• Bir denetleyici ekleyeceksiniz. 

• CRUD yöntemleri ekleyin. 

• Yönlendirmeyi Yapılandırma ve URL yolu. 

• Dönüş değerleri belirtin. 

• Web API'si Postman ile çağırın. 

• JavaScript ile Web API 'sini çağırın. 

Sonunda, web API'si "Yapılacaklar" öğelerini ilişkisel bir veritabanında depolanan yönetebileceği sahip. 

Genel bakış 

Bu öğretici yandaki API oluşturur: 


API 

AÇIKLAMA 

İSTEK GÖVDESİ 

YANIT GÖVDESİ 

/Api/Todoltems al 

Tüm yapılacak iş öğeleri al 

Yok. 

Yapılacaklar öğelerinin bir 
dizisi 

/Api/Todoltems/{id} al 

Bir öğeyi Kimliğine göre Al 

Yok. 

Yapılacak iş öğesi 

POST/api/Todoltems 

Yeni Öğe Ekle 

Yapılacak iş öğesi 

Yapılacak iş öğesi 

/Api/Todoltems/{id) koy 

Mevcut öğeyi güncelleştirin 

Yapılacak iş öğesi 

Yok. 

/Api/Todoltems/{id} SİL 

Öğeyi Sil 

Yok. 

Yok. 


Aşağıdaki diyagramda, bu uygulamanın tasarımını gösterir. 



Prerequisites 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Visual Studio 2019 ile ASP.NET ve web geliştirme iş yükü 

• NET core SDK 2.2 veya üzeri 

















VVARNING 

Visual Studio 2017 kullanıyorsanız bkz dotnet/SDK'sı sorun #3124 Visual Studio ile çalışmayan .NET Core SDK sürümleri 
hakkında bilgi için. 


Birvveb projesi oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 


• Dosya menüsünden Yeni > Proje' yi seçin. 

• ASP.N ET Core Web uygulaması şablonunu seçin ve İleri' ye tıklayın. 

• Projeyi TodoApi olarak adlandırın ve Oluştur' a tıklayın. 

• Yeni bir ASP.NET Core Web uygulaması oluştur iletişim kutusunda, .net Core ve ASP.NET Core 2,2 ' un 

seçili olduğunu doğrulayın. API şablonunu seçin ve Oluştur' a tıklayın. Docker desteğini etkinleştir' i 
seçmeyin . 
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Web Application 

A project template for creating an ASP.Nl I Core application with example ASP.NLI Core Razor Pages content. 
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API'yi test etme 

Proje şablonu oluşturur bir values API. Çağrı Get uygulamayı test etmek için bir tarayıcıdan yöntemi. 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Uygulamayı çalıştırmak için CTRL + F5 tuşlarına basın. Visual Studio bir tarayıcı ile başlatarak 
https://iocaihost:<port>/api/values burada <port> bir rastgele seçilen bağlantı noktası numarasıdır. 

IIS Express sertifika güven varsa soran bir iletişim kutusu alırsanız seçin Evet, içinde Güvenlik Uyarısı ardından, 































görüntülenen iletişim seçin Evet. 
Aşağıdaki JSON döndürülür: 

["valuel","value2" ] 


Bir model sınıfı ekleme 

A modeli uygulamayı yöneten verilerini temsil eden sınıflar kümesidir. Tek bir modeldir bu uygulama için Todoitem 
sınıfı. 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• içinde Çözüm Gezgini, projeye sağ tıklayın. Seçin ekleme > yeni klasör. Klasör adı modelleri. 

• Sağ modelleri klasörü ve select Ekle > sınıfı. Sınıf adı Todoitem seçip Ekle. 

• Şablon kodunu aşağıdaki kodla değiştirin: 

namespace TodoApi.Models 
{ 

public class Todoitem 
{ 

public long Id { get; set; } 
public string Name { get; set; } 
public bool IsComplete { get; set; } 

} 

} 

id Özelliği işlevlerinin bir ilişkisel veritabanında benzersiz anahtar. 

Model sınıfları herhangi bir projede gidip ancak modelleri klasörü, kural olarak kullanılır. 

Veritabanı bağlamı Ekle 

Veritabanı bağlamı koordine eden bir veri modeli için Entity Framevvork işlevsellik ana sınıftır. Bu sınıf türetme 
tarafından oluşturulan Microsoft.EntityFrameworkCore.DbContext Simfl. 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

• Sağ modelleri klasörü ve select Ekle > sınıfı. Sınıf adı TodoContext tıklatıp Ekle. 


• Şablon kodunu aşağıdaki kodla değiştirin: 






using Microsoft.EntityFrameworkCore; 

namespace TodoApi.Models 
{ 

public class TodoContext : DbContext 
{ 

public TodoContext(DbContextOptions<TodoContext> options) 
: base(options) 

{ 

} 

public DbSet<TodoItem> Todoltems { get; set; } 

} 

} 


Veritabanı bağlamı Kaydet 

ASP.NET Core DB bağlamı gibi hizmetler ile kaydedilmelidir bağımlılık ekleme (dı) kapsayıcı. Kapsayıcı hizmeti 
denetleyicilerine sağlar. 

Güncelleştirme Startup.es aşağıdaki vurgulanmış kodu: 



// Unused usings removed 

using Microsoft.AspNetCore.Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.EntityFrameworkCore; 

using Microsoft.Extensions.Configuration; 

using Microsoft.Extensions.Dependencylnjection; 

using TodoApi.Models; 

namespace TodoApi 

{ 

public class Startup 

{ 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

// This method gets called by the runtime. Use this method to add Services to the 
//Container. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<TodoContext>(opt => 
opt.UseInMemoryDatabase("TodoList")); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

} 

// This method gets called by the runtime. Use this method to configure the HTTP 
//request pipeline. 

public void Configure(IApplicationBuilder app., IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

// The default HSTS value is 30 days. You may want to change this for 
// production scenarios, see https://aka.ms/aspnetcore-hsts. 
app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseMvc(); 

} 

} 

} 


Yukarıdaki kod: 

• Kullanılmayan kaldırır using bildirimleri. 

• Veritabanı bağlamı Dİ kapsayıcıya ekler. 

• Veritabanı bağlamı bir bellek içi veritabanına kullanacağını belirtir. 

Denetleyici ekleme 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

• Sağ denetleyicileri klasör. 


• > Yeni öğe Ekle 1 yi seçin. 







• içinde Yeni Öğe Ekle iletişim kutusunda API denetleyici sınıfı şablonu. 

• Sınıf adı TodoControllerseçp Ekle. 
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• Şablon kodunu aşağıdaki kodla değiştirin: 

using Microsoft.AspNetCore.Mvc; 
using Microsoft.EntityFrameworkCore; 
using System.Collections.Generic; 
using System.Linq; 
using System.Threading.Tasks; 
using TodoApi.Models; 

namespace TodoApi.Controllers 

{ 

[Route("api/[controller]") ] 

[ApiController] 

public class TodoController : ControllerBase 

{ 

private readonly TodoContext _context; 

public TodoController(TodoContext context) 

{ 

_context = context; 

if (_context.TodoItems.Count() == 0) 

{ 

// Create a new Todoltem if collection is empty, 

// which means you can't delete ali Todoltems. 
_context.TodoItems.Add(new Todoltem { Name = "Iteml" }); 
_context.SaveChanges(); 

} 

} 

} 

} 


Yukarıdaki kod: 
















• Bir API denetleyicisi sınıfı yöntemleri olmadan tanımlar. 

• Sınıfı [ApiControiler] özniteliğiyle işaretler. Bu öznitelik, denetleyicinin web API'si isteklerine yanıt verdiğini 
gösterir. Özniteliğin izin aldığı belirli davranışlar hakkında daha fazla bilgi için bkz. ASP.NET Core ile Web API 
'Leri oluşturma. 

• Veritabanı bağlamı eklemesine Dİ kullanır ( TodoContext ) içine denetleyici. Her bir veritabanı bağlamı kullanılan 
CRUD denetleyici yöntemleri. 

• Adlı bir öğe ekler ıtemi veritabanı boşsa veritabanı. Her çalıştığında bu kod oluşturucusunun içinde yeni bir 
HTTP isteği olduğundan. Tüm öğeleri silerseniz, oluşturucu oluşturur ıtemi API yöntemi çağrıldığında tekrar 
başlattığınızda. Bu nedenle, gerçekten işe yaradı silme işlemi işe yaramadı gibi görünebilir. 

Get yöntemleri ekleyin 

Yapılacak iş öğeleri alır bir API sağlamak için aşağıdaki yöntemi ekleyin. TodoControiler sınıfı: 

// GET: api/Todo 
[HttpGet] 

public async Task<ActionResult<IEnumerable<TodoItem>>> GetTodoItems() 

{ 

return await _context.TodoItems.Tol_istAsync(); 

} 

// GET: api/Todo/5 
[HttpGet("{id}") ] 

public async Task<ActionResult<TodoItem>> GetTodoItem(long id) 

{ 

var todoltem = await _context.Todoltems.FindAsync(id); 

if (todoltem == null) 

{ 

return NotFound(); 

} 

return todoltem; 

} 

iki GET uç noktası bu yöntemleri uygulayın: 

• GET /api/todo 

• GET /api/todo/{id} 

Hala çalışıyorsa uygulamayı durdurun. Ardından, en son değişiklikleri dahil etmek için yeniden çalıştırın. 

Bir tarayıcıdan iki uç nokta çağırarak uygulamayı test edin. Örneğin: 

• https://localhost:<port>/api/todo 

• https://localhost:<port>/api/todo/l 

Şu HTTP yanıtı çağrısı tarafından üretilen GetTodoitems : 


{ 

"id": 1 , 

"name": "Iteml", 
"isComplete": false 

} 

] 










URL Yönlendirme ve yolları 

[HttpGet] Özniteliği bir HTTP GET isteğine yanıt vermeden bir yöntemi gösterir. Her yöntem için URL yolu şu 
şekilde oluşturulur: 

• Denetleyicinin şablonu dizesi ile başlayıp Route özniteliği: 

namespace TodoApi.Controllers 
{ 

[Route("api/[controller]")] 

[ApiController] 

public class TodoController : ControllerBase 
{ 

private readonly TodoContext _context; 

• Değiştirin [controiler] denetleyicinin adı ile kural tarafından olduğu "Controller" soneki eksi denetleyici 
sınıfı adı. Bu örnek, denetleyici sınıfı adı olan TodoDenetleyici adı "todo" Bu nedenle denetleyicisi.ASP.NET 
Core yönlendirme büyük/küçük harfe duyarlıdır. 

• [HttpGet] özniteliğinin bir yol şablonu varsa (örneğin, [HttpGet("products")] ), yola ekleyin. Bu örnek, bir 
şablon kullanmaz. Daha fazla bilgi için özniteliği Http [eylem] özniteliği ile yönlendirme. 

Aşağıdaki GetTodoitem yöntemi "{id}" yapılacak iş öğesi benzersiz tanımlayıcısı için bir yer tutucu değişkendir. 
Zaman GetTodoitem çağrılır, değerini "{id}" yöntemine URL'de sağlanan kendi id parametresi. 

// GET: api/Todo/5 
[HttpGet("{id}") ] 

public async Task<ActionResult<TodoItem>> GetTodoItem(long id) 

{ 

var todoltem = await _context.Todoltems.FindAsync(id); 

if (todoltem == null) 

{ 

return NotFound(); 

} 

return todoltem; 

} 


Döndürülen değerler 

Dönüş türünü GetTodoitems ve GetTodoitem yöntemler actionresult öğesini<T > türü. AS P.N ET Core, nesneyi 
otomatik olarak serileştiren JSON ve yanıt iletisinin gövdesine JSON yazar.Yanıt kodu 200 bu dönüş türü için 
olduğu varsayılırsa işlenmeyen özel durumlar vardır. İşlenmeyen özel durumları 5xx hatalarla karşılaşırsanız çevrilir. 

ActionResuit dönüş türleri, geniş HTTP durum kodları temsil edebilir.Örneğin, GetTodoitem iki farklı durum 
değerleri döndürebilir: 

• Öğe istenen kimliği eşleşirse, yöntem bir 404 döndürür NotFound hata kodu. 

• Aksi takdirde yöntem bir JSON yanıt gövdesine 200 döndürür. Döndüren item sonuçları bir HTTP 200 yanıtı. 

Test GetTodoitems yöntemi 

Bu öğreticide Postman web API'si test etmek için kullanılır. 


• Postman'yi yükleme. 

• Web uygulaması başlatın. 




















• Postman'i başlatın. 

• SSL sertifikası doğrulamasınıdevre dışı bırakın. 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 


• Dosya > ayarları 1 ndan (genel sekmesinden) SSL sertifikası doğrulamasınıdevre dışı bırakın. 


VVARNING 

Test denetleyicisi sonra SSL sertifika doğrulamasını yeniden etkinleştirin. 


• Yeni bir istek oluşturun. 

o HTTP yöntemi kümesine alma. 

o istek U RL'sİ kümesine https://localhost:<port>/api/todo .Örneğin: https://localhost:5001/api/todo . 

• Ayarlama iki bölme görünümü postman'deki. 

• Gönder i seçin. 
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Create yöntemi ekleme 

Aşağıdaki PostTodoitem yöntemini Controllers/TodoController. csiçine ekleyin: 

// POST: api/Todo 
[HttpPost] 

public async Task<ActionResult<TodoItem>> PostTodoItem(TodoItem item) 

{ 

_context.Todoltems.Add(item); 
await _context.SaveChangesAsync(); 

return CreatedAtAction(nameof(GetTodoltem ), new { id = item.Id }, item); 

} 























Yukarıdaki kod, [HttpPost] özniteliğiyle gösterildiği gibi bir http post yöntemidir. Yöntemi, HTTP isteği 
gövdesinden Yapılacaklar öğenin değerini alır. 

CreatedAtAction Yöntemi: 

• Başarılı olursa bir HTTP 201 durum kodu döndürür. HTTP 201 sunucuda yeni bir kaynak oluşturan bir HTTP 
POST yöntemi için standart yanıttır. 

• Yanıta bir Location üst bilgisi ekler. Location üstbilgisi, yeni oluşturulan Yapılacaklar öğesinin U Rl 'sini 
belirtir. Daha fazla bilgi için 10.2.2 201 oluşturuldu. 

• Location üst bilgisinin URI 'sini oluşturmak için GetTodoitem eyleme başvurur. C# nameof anahtar sözcüğü, 
CreatedAtAction çağrısında eylem adının sabit kodlanmasını önlemek için kullanılır. 

// GET: api/Todo/5 
[HttpGet("{id}") ] 

public async Task<ActionResult<TodoItem>> GetTodoItem(long id) 

{ 

var todoltem = await _context.Todoltems.FindAsync(id); 

if (todoltem == null) 

{ 

return NotFound(); 

} 

return todoltem; 

} 


Test PostTodoltem yöntemi 

• Projeyi oluşturun. 

• Postman HTTP yöntemi kümesine post . 

• Seçin gövdesi sekmesi. 

• Seçin ham radyo düğmesi. 

• Tür kümesine JSON (application/json). 

• istek gövdesinde bir yapılacak iş öğesi için JSON girin: 

{ 

"name":"walk dog", 

"isComplete":true 

} 


• Gönder i seçin. 
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Bir 405 yöntemine İzin verilmiyor hatası alırsanız, PostTodoitem yöntemi eklendikten sonra projenin 
derlenmesinin sonucu büyük olasılıkla oluşur. 

Konum üst bilgisi URI test 

• Seçin üstbilgileri sekmesinde yanıt bölmesi. 

• Kopyalama konumu üst bilgi değeri: 
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• Yöntemini GET öğesine Ayarla. 

• URI 'yi yapıştirın (örneğin, https://iocaihost:500i/api/Todo/2 ). 

• Gönder i seçin. 


PutTodoltem yöntemi ekleme 
































Aşağıdaki PutTodoitem yöntemi: 


// PUT: api/Todo/5 
[HttpPut("{id}") ] 

public async Task<IActionResult> PutTodoItem(long id, Todoltem item) 

{ 

if (id != item.Id) 

{ 

return BadRequest(); 

} 

_context.Entry(item).State = EntityState.Modified; 
await _context.SaveChangesAsync(); 

return NoContent(); 

} 

PutTodoitem benzer PostTodoitem , HTTP PUT kullanır.Yanıt 204 (içerik yok). HTTP belirtimine göre bir PUT isteği 
tüm güncelleştirilmiş varlık yalnızca değişiklikler değil göndermek istemci gerektirir. Kısmi güncelleştirmeleri 
desteklemek için kullanma HTTP PATCH. 

PutTodoitem çağırırken bir hata alırsanız, veritabanında bir öğe olduğundan emin olmak için get çağırın. 

Test PutTodoitem yöntemi 

Bu örnek, uygulama her başlatıldığında başlatılmış olması gereken bellek içi bir veritabanını kullanır. Bir PUT çağrısı 
yapmadan önce veritabanında bir öğe olmalıdır. PUT çağrısı yapmadan önce veritabanında bir öğe olduğundan 
emin olmak için GET çağrısı yapın. 

Kimliğine sahip bir yapılacak iş öğesi güncelleştirme = 1 ve "balık akış için" adını girin: 

{ 

"ID" : 1 , 

"name":"feed fish", 

"isComplete":true 

} 


Aşağıdaki görüntüde, Postman güncelleştirme gösterilmektedir: 
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DeleteTodoltem yöntemi ekleme 

Aşağıdaki DeleteTodoltem yöntemi: 

// DELETE: api/Todo/5 
[HttpDelete("{id}")] 

public async Task<IActionResult> DeleteTodoItem(long id) 

{ 

var todoltem = await _context.Todoltems.FindAsync(id); 

if (todoltem == null) 

{ 

return NotFound(); 

} 

_context.Todoltems.Remove(todoltem); 
await _context.SaveChangesAsync(); 

return NoContent(); 

} 

DeleteTodoltem Yanıt 204 (içerik yok). 

Test DeleteTodoltem yöntemi 

Postman bir yapılacak iş öğesini silmek için kullanın: 

• Yöntem kümesine delete . 

• Silinecek nesnenin URI 'sini ayarlayın (örneğin https://iocaihost:50eı/api/todo/ı ). 

• Gönder i seçin. 

Örnek uygulama, tüm öğeleri silmenizi sağlar.Ancak, son öğe silindiğinde, API 'nin bir sonraki çağrılışında model 
sınıfı Oluşturucu tarafından yeni bir tane oluşturulur. 

JavaScript ile Web API 'sini çağırma 

Bu bölümde, Web API 'sini çağırmak için JavaScript kullanan bir HTML sayfası eklenir.jöuery isteği başlatır. 
JavaScript, sayfayı Web API 'sinin yanıtından alınan ayrıntılarla güncelleştirir. 

Uygulamayı statik dosyalara sunacak şekilde yapılandırın ve aşağıdaki vurgulanmış kodla Startup.es 
güncelleştirerek varsayılan dosya eşlemesini etkinleştirin : 

public void Configure(IApplicationBuilder app., IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app. UseDeveloperExceptionPage(); 

} 

else 

{ 

// The default HSTS value is 30 days. You may want to change this for 
// produetion scenarios, see https://aka.ms/aspnetcore-hsts. 
app.UseHsts(); 

} 

app.UseDefaultFileş(); 
app.UseStaticFiles(); 
app.UseHttpsRedirection(); 
app.UseMvc(); 

} 






Oluşturma bir wwwroot proje dizininde klasör. 


Adlı bir HTML dosyası ekleyin index.html için wwwroot dizin. Dosyanın içeriğini aşağıdaki biçimlendirme ile 
değiştirin: 

<!DOCTYPE html> 

<html> 

<head> 

<meta charset="UTF-8"> 

<title>To-do CRUD</title> 

<style> 

input [type=' submit' ], buttorn [aria-label] { 
cursor: pointer; 

} 

#spoiler { 

display: none; 

} 

table { 

font-family: Arial, sans-serif; 
border: lpx solid; 
border-collapse: collapse; 

} 

th { 

background-color: #0066CC; 
color: white; 

} 

td { 

border: lpx solid; 
padding: 5px; 

} 

</style> 

</head> 

<body> 

<hl>To-do CRUD</hl> 

<hB>Add</hS> 

<form action="javascript:void(0);" method="POST" onsubmit="addItem()"> 

<input type="text" id="add-name" placeholder="New to-do"> 

<input type="submit" value="Add"> 

</form> 

<div id="spoiler"> 

<hB>Edit</h3> 

<form class="my-form"> 

cinput type=''hidden" id="edit-id"> 

<input type="checkbox" id="edit-isComplete"> 

<input type="text" id="edit-name"> 

<input type="submit" value="Save"> 

<a onclick="closeInput()" aria-label="Close">&#10006j</a> 

</form> 

</div> 

<p id="counter"x/p> 

<table> 

<tr> 

<th>Is Complete</th> 

<th>Name</th> 

<thx/th> 

<thx/th> 

</tr> 

<tbody id="todos"x/tbody> 

</table> 


<scrıpt snc='Tıttps://coae.]query.com/]query-i.i.l.mın.]s" 

integrity="sha256-FgpCb/KJQlLNfOu91ta32o/NMZxltwRo8QtmkMRdAu8=" 

crossorigin="anonymous"x/script> 

<script src="site. js"x/script> 

</body> 

</html> 


Adlı bir JavaScript dosyası ekleyin site.js için wwwroot dizin. Dosyanın içeriğini aşağıdaki kodla değiştirin: 

const uri = "api/todo"; 
let todos = null; 
function getCount(data) { 
const el = $("#counter"); 
let name = "to-do"; 
if (data) { 

if (data > 1) { 
name = "to-dos"; 

} 

el.text(data + " " + name); 

} else { 

el.text("No " + name); 

} 


$(document).ready(function() { 
getData(); 

}); 

function getData() { 

$.ajax({ 

type: "GET", 
url: urij 
cache: false, 
success: function(data) { 
const tBody = $("#todos"); 

$(tBody).empty(); 

getCount(data.length); 

$.each(data, function(key, item) { 
const tr = $("<trx/tr>") 

.append( 

$("<tdx/td>"). append( 

$("<input/>", { 
type: "checkbox", 
disabled: true, 
checked: item.isComplete 

}) 

) 

) 

. append($("<tdx/td>"). text(item. name)) 

.append( 

$("<tdx/td>"). append( 

$("<button>Edit</button>").on("click", function() { 
edititem(item.id); 

}) 

) 

) 

.append( 

$("<tdx/td>"). append( 

$("<button>Delete</button>"),on("click", function() { 
deleteltem(item.id); 

}) 

) 

); 


■er.appena ı o^rtsoay;; 

}); 

todos = data; 

} 

}); 

} 

funetion addltem() { 
const item = { 

name: $("#add-name").val(), 
isComplete: false 

}; 


$.ajax({ 

type: "POST", 

accepts: "application/json", 
url: uri, 

contentType: "application/json", 
data: 3S0N.stringify(item), 

error: function(jqXHR, textStatus, errorThrown) { 
alert("Something went wrong!"); 

L 

success: function(result) { 
getData(); 

$("#add-name").val(""); 

} 

}); 


funetion deleteltem(id) { 
$.ajax({ 

unl: uri + "/" + id, 
type: "DELETE", 
success: function(result) { 
getData(); 

} 

}); 


funetion editltem(id) { 

$.each(todos, function(key, item) { 
if (item.id === id) { 

$("#edit-name").val(item.name); 

$("#edit-id").val(item.id); 

$("#edit-isComplete")[0].checked = item.İsComplete 

} 

}); 

$("#spoiler").css({ display: "block" }); 

} 

$(".my-form").on("submit", function() { 
const item = { 

name: $("#edit-name").val(), 

isComplete: $("#edit-isComplete").is(":checked"), 
id: $("#edit-id").val() 

}; 


$.ajax({ 

url: uri + "/" + $("#edit-id").val(), 
type: "PUT", 

accepts: "application/json", 
contentType: "application/json", 
data: TSON.stringify(item), 
success: function(result) { 
getData(); 


} 


closeInput(); 
return false; 

}); 

function closeInput() { 

$("#spoiler").css({ display: "none" }); 

} 


AS P.N ET Core proje başlatma ayarlarında bir değişiklik HTM L sayfasını yerel olarak test etmek için gerekli: 

• Açık Properties\launchSettings.json. 

• Kaldırma launchuri , açmak için uygulamayı zorlamak için özellik index.html —projenin varsayılan dosya. 

Bu örnek, Web API 'sinin tüm CRUD yöntemlerini çağırır.API çağrıları açıklamaları aşağıda verilmiştir. 

Yapılacaklar öğelerinin bir listesini alın 

jQuery, bir to-do öğesi dizisini temsil eden JSON döndüren Web API ‘sine bir HTTP GET isteği gönderir, success 
istek başarılı olursa geri çağırma işlevi çağrılır. Geri çağırma içinde DOM Yapılacaklar bilgilerle güncelleştirilir. 





$(document).ready(function() { 
getData(); 

}); 

function getData() { 

$.ajax({ 

type: "GET", 
url: urij 
cache: false, 
success: function(data) { 
const tBody = $("#todos"); 

$(tBody). emptyO; 

getCount(data.length); 

$.each(data, function(key, item) { 
const tn = $("<trx/tr>") 

.append( 

$("<tdx/td>"). append( 

$("<input/>", { 
type: "checkbox", 
disabled: true, 
checked: item.isComplete 

}) 

) 

) 

. append($("<tdx/td>"). text(item. name)) 

.append( 

$("<tdx/td>"). append( 

$("<button>Edit</button>"),on("click"j function() { 
edititem(item.id); 

}) 

) 

) 

.append( 

$("<tdx/td>"). append( 

$("<button>Delete</button>"),on("click", function() { 
deleteltem(item.id); 

}) 

) 

); 

tn.appendTo(tBody); 

}); 

todos = data; 

} 

}); 

} 


Yapılacak İş Öğesi Ekle 

jQuery, istek gövdesinde Yapılacaklar öğesiyle bir HTTP POST isteği gönderir, accepts Ve contentType 
seçeneklerini ayarlamak appücation/json gönderilen ve alınan medya türü belirtmek için. Yapılacak iş öğesi 
kullanarak JSON'a dönüştürülür JSON.stringify. API'yi bir başarılı durum kodu döndürdüğünde getData işlevi 
HTML tablosu güncelleştirmek için çağrılır. 








function addltem() { 
const item = { 

name: $("#add-name").val(), 
isComplete: false 

}; 

$.ajax({ 

type: "POST", 

accepts: "application/json", 
unl: uni, 

contentType: "application/json", 
data: TSON.stningify(item), 

error: function(jqXHR, textStatus, errorThrown) { 
alert("Something went wrong!"); 

}, 

success: function(result) { 
getData()j 

$("#add-name").val(""); 

} 

}); 


Yapılacak iş öğesini güncelleştirme 

Yapılacak iş öğesi güncelleştirilirken bir eklemeye benzerdir, url Öğenin benzersiz tanıtıcısı eklemek için 
değişiklikleri ve type olduğu put . 

$.ajax({ 

unl: uri + "/" + $("#edit-id").val(), 
type: "PUT", 

accepts: "application/json", 
contentType: "application/json", 
data: DSON.stringify(item), 
success: function(nesult) { 
getData(); 

} 

}); 


Yapılacak iş öğesi silme 

Yapılacak iş öğesi silme gerçekleştirilir ayarlayarak type AJAX çağrısı hedefi üzerinde delete ve öğenin benzersiz 
tanıtıcısı URL'yi belirterek. 

$.ajax({ 

unl: uni + "/" + id, 
type: "DELETE", 
success: function(nesult) { 
getData(); 

} 

}); 


Web API 'sine kimlik doğrulama desteği ekleme 

ASP.NET Core kimlik, ASP.NET Core Web uygulamalarına Kullanıcı arabirimi (Ul) oturum açma işlevselliği ekler. 
Web API 'Leri ve maça 'ları güvenli hale getirmek için aşağıdakilerden birini kullanın: 

• Azure Active Directory 

• Azure Active Directory B2C (Azure AD B2C)] 

• Identityserver4 









Identityserver4, ASP.NET Core 3,0 için bir OpenlD Connect ve OAuth 2,0 çerçevesidir.Identityserver4 aşağıdaki 
güvenlik özelliklerini sunar: 

• Hizmet olarak kimlik doğrulaması (AaaS) 

• Birden çok uygulama türü üzerinde çoklu oturum açma/kapatma (SSO) 

• API 'Ler için erişim denetimi 

• Federasyon ağ geçidi 

Daha fazla bilgi için bkz. ıdentityserver4 to VVelcome. 

Ek kaynaklar 

Görüntülemek veya Bu öğretici için örnek kodu indirdikten. Bkz: nasıl indirileceğini. 

Daha fazla bilgi için aşağıdaki kaynaklara bakın: 

• ASP.NET Core ile Web API 'Leri oluşturma 

• ASP.NET Core Web API Yardım sayfaları ile Svvagger / Openapı 

• ASP.NET Core - Öğreticisi 1.8'de Entity Framevvork Core ile Razor sayfaları 

• ASP.NET Core denetleyici eylemlerine yönlendirme 

• ASP.NET Core Web API 'sindeki denetleyici eylemi dönüş türleri 

• ASP.NET Core uygulamalarını Azure App Service dağıtma 

• ASP.NET Core barındırma ve dağıtma 

• Bu öğreticinin YouTube sürümü 



MongoDB ile ASPNET Core ile web API'si oluşturma 

6.12.2019 • 33 minutes to read ı Edit Online 


Tarafından Pratik Khandelvval ve Scott Addie 

Bu öğreticide web API'si temel oluşturma, okuma, güncelleştirme ve silme (CRUD) işlemleri gerçekleştiren 
oluşturur bir MongoDB NoSQL veritabanı. 

Bu öğreticide şunların nasıl yapıladığını öğreneceksiniz: 

• MongoDB yapılandırın 

• MongoDB veritabanı oluşturma 

• MongoDB koleksiyonu ve şema tanımlayın 

• Bir vveb API'sini MongoDB CRUD işlemleri gerçekleştirme 

• JSON serileştirmesini özelleştirme 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Prerequisites 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• .NET Core SDK 3.0 veya üzeri 

• ASP.net ve Web geliştirme iş yüküyle Visual Studio 2019 

• MongoDB 

MongoDB yapılandırın 

Windows kullanıyorsanız MongoDB, varsayılan olarak mongodb\C:\Program Fileş 'a yüklenir. \Program 
Files\MongoDB\Server\ <Version_Number >\ Path ) ortam değişkenine ekleyin. Bu değişiklik yerden MongoDB 
erişim sağlar, geliştirme makinenizde. 

Mongo kabuğunu veritabanı oluşturma, koleksiyonları yapın ve belgeleri depolamak için aşağıdaki adımları 
kullanın. Mongo Kabuğu komutları hakkında daha fazla bilgi için bkz. mongo kabuğunu çalışma. 

1. Geliştirme makinenizde verilerin depolanması için bir dizin seçin. Örneğin, C: Windows üzerinde\BooksData 
. Yoksa dizini oluşturun. Mongo kabuğunu yeni dizinleri oluşturmaz. 

2. Bir komut kabuğunu açın. Varsayılan bağlantı noktası 27017 mongodb'ye bağlanmak için aşağıdaki komutu 
çalıştırın. Değiştirmeyi unutmayın <data_directory_path> önceki adımda seçtiğiniz dizini. 

mongod --dbpath <data_directory_path> 

3. Başka bir komut kabuğu örneği açın. Aşağıdaki komutu çalıştırarak varsayılan test veritabanı'na bağlanma: 

mongo 


4. Bir komut kabuğu'nda aşağıdaki komutu çalıştırın: 







use BookstoreDb 


Adlı bir veritabanı zaten mevcut olmayan halinde BookstoreDb oluşturulur. Veritabanı mevcut değilse, 
bağlantı işlemleri için açılır. 

5. Oluşturma bir Books koleksiyon aşağıdaki komutu kullanarak: 

db.createCollection('Books') 


Aşağıdaki sonucu görüntülenir: 

{ "ok" : 1 } 

6. için bir şema tanımlayabilir Books toplama ve ekleme iki belge aşağıdaki komutu kullanarak: 

db.Books.insertMany([{'Name':'Design Patterns','Price':54.93,'Category':'Computers','Author':’Ralph 
lohnson'}, {'Name':'Clean Code', ' Price':43.15,'Category':'Computers','Author':'Robert C. Martin'}]) 


Aşağıdaki sonucu görüntülenir: 


{ 

"acknowledged" : true, 

"insertedlds" : [ 

ObjectId("5bfd996f7b8e48dcl5ff215d"), 
ObjectId("5bfd996f7b8e48dcl5ff215e") 

] 


NOTE 

Bu makalede gösterilen KİMLİK, bu örneği çalıştırdığınızda kimliklerle eşleşmeyecektir. 


7. Aşağıdaki komutu kullanarak veritabanında belgelerini görüntüleyin: 

db.Books.find({}).pretty() 


Aşağıdaki sonucu görüntülenir: 


{ 

"_id" : ObjectId("5bfd996f7b8e48dcl5ff215d"), 
"Name" : "Design Patterns", 

"Price" : 54.93, 

"Category" : "Computers", 

"Author" : "Ralph lohnson" 

} 

{ 

"_id" : ObjectId("5bfd996f7b8e48dcl5ff215e"), 
"Name" : "Clean Code", 

"Price" : 43.15, 

"Category" : "Computers", 

"Author" : "Robert C. Martin" 

} 










Şema girmiş ekler _id türünün özelliği objectid her belge için. 


Veritabanı hazırdır.ASP.N ET Core web API'si oluşturmaya başlayabilirsiniz. 

ASP.NET Core web API projesi oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

1. Dosya > Yeni > projesi' ne gidin. 

2. ASP.N ET Core Web uygulaması proje türünü seçin ve İleri' yi seçin. 

3. Projeyi Booksapıolarak adlandırın ve Oluştur' u seçin. 

4. .NET Core hedef çerçevesini ve 3,0 ASP.NET Coreseçin. API proje şablonunu seçin ve Oluştur' u seçin. 

5. MongoDB için .NET sürücüsünün en son kararlı sürümünü öğrenmek üzere NuGet galerisini ziyaret edin: 
MongoDB. Driver . içinde Paket Yöneticisi Konsolu penceresinde proje kök dizinine gidin. MongoDB için 
.NET sürücüsünü yüklemek için aşağıdaki komutu çalıştırın: 

Install-Package MongoDB.Driver -Version {VERSION} 


Varlık modeli ekleme 

1. Ekleme bir modelleri proje kök dizini. 

2. Ekleme bir Book sınıfının modelleri aşağıdaki kod ile dizin: 

using MongoDB.Bson; 

using MongoDB.Bson.Serialization.Attributes; 

namespace BooksApi.Models 
{ 

public class Book 
{ 

[Bsonld] 

[BsonRepresentation(BsonType.Objectld) ] 
public string Id { get; set; } 

[BsonElement("Name") ] 

public string BookName { get; set; } 

public decimal Price { get; set; } 

public string Category { get; set; } 

public string Author { get; set; } 

} 

} 

Önceki sınıfta id özelliği: 

• Ortak dil çalışma zamanı (CLR) nesnesini MongoDB koleksiyonuna eşlemek için gereklidir. 

• , Bu özelliği belgenin birincil anahtarı olarak belirlemek için [Bsonid] ile açıklama eklenir. 

• , Parametreyi Objectl D yapısı yerine tür string olarak geçirmeyi sağlayan 

[BsonRepresentation(BsonType.Objectld)] ile açıklama eklenir. Mongo, string dönüştürmeyi Objectld 

















olarak işler. 

BookName özelliğine [BsonElement] özniteliğiyle açıklama eklenir. Özniteliğin Name değeri, MongoDB 
koleksiyonundaki özellik adını temsil eder. 

Yapılandırma modeli ekleme 

1. Aşağıdaki veritabanı yapılandırma değerlerini appSettings. JSONöğeslne ekleyin: 

{ 

"BookstoreDatabaseSettings": { 

"BooksCollectionName": "Books", 

"ConnectionString": "mongodb://localhost:27017", 

"DatabaseName": "BookstoreDb" 

h 

"Logging": { 

"IncludeScopes": false, 

"Debug": { 

"LogLevel": { 

"Default": "l/Jarning" 

} 

}, 

"Console": { 

"LogLevel": { 

"Default": "l/Jarning" 

} 

} 

} 

} 


2. Modeller dizinine aşağıdaki kodla bir BookstoreDatabaseSettings.es dosyası ekleyin: 

namespace BooksApi.Models 

{ 

public elass BookstoreDatabaseSettings : IBookstoreDatabaseSettings 

{ 

public string BooksCollectionName { get; set; } 
public string ConnectionString { get; set; } 
public string DatabaseName { get; set; } 

} 

public interface IBookstoreDatabaseSettings 

{ 

string BooksCollectionName { get; set; } 
string ConnectionString { get; set; } 
string DatabaseName { get; set; } 

} 

} 

Yukarıdaki BookstoreDatabaseSettings Simfl, appSettings. JSON dosyasının BookstoreDatabaseSettings 
özellik değerlerini depolamak için kullanılır. JSON ve C# Özellik adları, eşleme sürecini kolaylaştırmak için 
aynı şekilde adlandırılır. 

3. Aşağıdaki Vurgulanan kodu startup.configureServices ekleyin: 









public void ConfigureServices(IServiceCollection Services) 

{ 

// requires using Microsoft.Extensions.Options 
Services.Configure<BookstoreDatabaseSettings>( 

Configuration.GetSection(nameof(BookstoreDatabaseSettings))); 

Services.AddSingleton<IBookstoreDatabaseSettings>(sp => 

sp.GetRequiredService<IOptions<BookstoreDatabaseSettings>>().Value); 

Services.AddControllers(); 

} 

Yukarıdaki kodda: 

• AppSettings. JSON dosyasının BookstoreDatabaseSettings bölüm bağlandığı yapılandırma örneği, 
bağımlılık ekleme (dı) kapsayıcısına kaydedilir. Örneğin, bir BookstoreDatabaseSettings nesnesinin 

ConnectionString Özelliği appSettings. JSO A/İÇİndeki BookstoreDatabaseSettingsrConnectionString Özelliği 
ile doldurulur. 

• iBookstoreDatabaseSettings arabirimi, tek bir hizmet ömrüile dı 'y e kaydedilir. Eklerken, arabirim örneği 
bir BookstoreDatabaseSettings nesnesine çözümlenir. 

4. BookstoreDatabaseSettings ve iBookstoreDatabaseSettings başvurularını çözümlemek için aşağıdaki kodu en 
üst kismına ekleyin : 

using BooksApi.Models; 


CRUD işlemleri hizmeti ekleme 

1. Ekleme bir Hizmetleri proje kök dizini. 


2. Ekleme bir BookService sınıfının Hizmetleri aşağıdaki kod ile dizin: 













using BooksApi.Models; 
using MongoDB.Driver; 
using System.Collections.Generic; 
using System.Linq; 

namespace BooksApi.Services 

{ 

public class BookService 

{ 

private readonly IMongoCollection<Book> _books; 

public BookService(IBookstoreDatabaseSettings settings) 

{ 

var Client = new MongoClient(settings.ConnectionString); 
var database = Client.GetDatabase(settings.DatabaseName); 

_books = database.GetCollection<Book>(settings.BooksCollectionName); 

} 

public List<Book> Get() => 

_books.Find(book => true).ToList(); 

public Book Get(string id) => 

_books.Find<Book>(book => book.Id == id).FirstOrDefault(); 

public Book Create(Book book) 

{ 

_books.InsertOne(book); 
return book; 

} 

public void Update(string id, Book bookln) => 

_books.ReplaceOne(book => book.Id == id, bookln); 

public void Remove(Book bookln) => 

_books.DeleteOne(book => book.Id == bookln.Id); 

public void Remove(string id) => 

_books.DeleteOne(book => book.Id == id); 

} 

} 

Yukarıdaki kodda, Oluşturucu ekleme yoluyla dı 'den bir iBookstoreDatabaseSettings örneği alınır. Bu teknik, 
yapılandırma modeli ekleme bölümüne eklenen appSettings. JSON yapılandırma değerlerine erişim sağlar. 

3. Aşağıdaki Vurgulanan kodu startup.configureServices ekleyin: 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<BookstoreDatabaseSettings>( 

Configuration.GetSection(nameof(BookstoreDatabaseSettings))); 

Services.AddSingleton<IBookstoreDatabaseSettings>(sp => 

sp.GetRequiredService<IOptions<BookstoreDatabaseSettings>>().Value); 

Services.AddSingleton<BookService>(); 

Services.AddControllers(); 

} 


Önceki kodda, BookService sınıfı, tüketen sınıflarda Oluşturucu ekleme işlemini desteklemek için Dİ ile 
kaydedilir. BookService, Mongociient doğrudan bağımlılığı sağladığından, tek hizmet ömrü en uygundur. 
Resmi Mongo istemci yeniden kullanım yönergeleritemelinde Mongociient , tek bir hizmet ömrü ile birlikte 








kaydedilmelidir. 


4. BookService başvurusunu çözümlemek için aşağıdaki kodu Startup.es 'un en üstüne ekleyin: 

using BooksApi.Services; 

BookService Sınıfını kullanan aşağıdaki MongoDB.Driver veritabanında CRUD işlemleri gerçekleştirmek için üyeleri: 

• Mongoclient-, veritabanı işlemlerini gerçekleştirmek için sunucu örneğini okur. Bu sınıfın oluşturucusu, 
MongoDB bağlantı dizesini sağlanır: 

public BookService(IBookstoreDatabaseSettings settings) 

{ 

var Client = new MongoClient(settings.ConnectionString); 
var database = Client.GetDatabase(settings.DatabaseName); 

_books = database.GetCollection<Book>(settings.BooksCollectionName); 

} 

• Imongodatabase- işlemleri gerçekleştirmek İçin Mongo veritabanını temsil eder. Bu öğretici, belirli bir 
koleksiyondaki verilere erişim kazanmak için arabirimindeki genel GetCollectioncTDocument > (koleksiyon) 
yöntemini kullanır. Bu yöntem çağrıldıktan sonra, koleksiyonda CRUD işlemleri gerçekleştirin, içinde 

GetCollection<TDocument>(collection) yöntem çağrısı: 

o colleetion Koleksiyon adını temsil eder. 

o TDocument Bir koleksiyonda depolanan CLR nesne türünü temsil eder. 

Getcoiiection<TDocument>(colleetion) , koleksiyonu temsil eden bir Mongocollection nesnesi döndürür. Bu 
öğreticide, aşağıdaki yöntemlerden koleksiyonunda çağrılır: 

• Deleteone -, belirtilen arama ölçütleriyle eşleşen tek bir belgeyi siler. 

• <TDocument > bul koleksiyonda belirtilen arama ölçütleriyle eşleşen tüm belgeleri döndürür. 

• Insertone -, belirtilen nesneyi koleksiyondaki yeni bir belge olarak ekler. 

• Replaceone belirtilen arama ölçütleriyle eşleşen tek belgeyi, belirtilen nesneyle değiştirir. 

Denetleyici ekleme 

Ekleme bir BooksControiler sınıfının denetleyicileri aşağıdaki kod ile dizin: 

using BooksApi.Models; 
using BooksApi.Services; 
using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 

namespace BooksApi.Controllers 
{ 

[Route("api/[controller]")] 

[ApiController] 

public elass BooksControiler : ControllerBase 
{ 

private readonly BookService _bookService; 

public BooksController(BookService bookService) 

{ 

_bookService = bookService; 

} 

[HttpGet] 

public ActionResult<List<Book>> Get() => 









_bookService.Get(); 

[HttpGet("{id:length(24)}"j Name = "GetBook")] 
public ActionResult<Book> Get(string id) 

{ 

var book = _bookService.Get(id); 

if (book == null) 

{ 

return NotFound(); 

} 

return book; 

} 

[HttpPost] 

public ActionResult<Book> Create(Book book) 

{ 

_bookService.Create(book); 

return CreatedAtRoute("GetBook"j new { id = book.Id.ToString() }, book); 

} 

[HttpPut("{id:length(24)}")] 

public IActionResult Update(string id, Book bookln) 

{ 

var book = _bookService.Get(id); 

if (book == null) 

{ 

return NotFound(); 

} 

_bookService.Update(idj bookln); 
return NoContent(); 

} 

[HttpDelete("{id:length(24)}")] 
public IActionResult Delete(string id) 

{ 

var book = _bookService.Get(id); 

if (book == null) 

{ 

return NotFound(); 

} 

_bookService.Remove(book.Id); 
return NoContent(); 

} 

} 

} 

Önceki web API denetleyicisi: 

• Kullanan BookService CRUD işlemleri gerçekleştirmek için sınıf. 

• GET, POST, PUT ve DELETE HTTP isteklerini desteklemek için eylem yöntemleri içerir. 

• Bir HTTP 201 yanıtı döndürmek için create eylemi yönteminde CreatedAtRoute çağırır. Durum kodu 201, 
sunucuda yeni bir kaynak oluşturan HTTP POST yöntemi için standart yanıttır. CreatedAtRoute Ayrıca yanıta bir 

Location üst bilgisi ekler. Location üstbilgisi yeni oluşturulan kitabın URI 'sini belirtir. 


Web API 'sini test etme 







1. Uygulamayı derleyin ve çalıştırın. 


2. Denetleyicinin parametresiz Get eylem yöntemini sınamak için http://iocaihost:<port>/api/books gidin. 
Aşağıdaki JSON yanıtı gösterilir: 

[ 

{ 

"id":"5bfd996f7b8e48dcl5ff215d", 

"bookName":"Design Patterns", 

"price":54.93, 

"category":"Computers", 

"author":"Ralph Johnson" 

}, 

{ 

"id":"5bfd996f7b8e48dcl5ff215e", 

"bookName":"Clean Code", 

"price":43.15, 

"category":"Computers", 

"author":"Robert C. Martin" 

} 

] 

3. Denetleyicinin aşırı yüklenmiş Get eylem yöntemini sınamak için 

http://localhost:<port>/api/books/{id here} gidin. Aşağıdaki JSON yanıtı gösterilir: 

{ 

"id":"{ID}", 

"bookName":"Clean Code", 

"price":43.15, 

"category":"Computers", 

"author":"Robert C. Martin" 


JSON serileştirme seçeneklerini yapılandırma 

Web API 'Sini test etme bölümünde döndürülen JSON yanıtları hakkında iki ayrıntı vardır: 

• ' Varsayılan ortası büyük/küçük harf özelliği, CLR nesnesinin özellik adlarının Pascal büyük küçük harfleriyle 
eşleşecek şekilde değiştirilmelidir. 

• bookName özelliği Name olarak döndürülmelidir. 

Önceki gereksinimleri karşılamak için aşağıdaki değişiklikleri yapın: 

1. JSON.NET, ASP.NET paylaşılan çerçevesinden kaldırılmıştır. Microsoft. AspNetCore. Mvc. 
NevvtonsoftJsonöğesine bir paket başvurusu ekleyin. 

2. startup.configureservices 1 de, aşağıdaki vurgulanmış kodu AddMvc yöntemi çağrısına zincirle: 










public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<BookstoreDatabaseSettings>( 

Configuration.GetSection(nameof(BookstoreDatabaseSettings))); 

Services.AddSingleton<IBookstoreDatabaseSettings>(sp => 

sp.GetRequiredService<IOptions<BookstoreDatabaseSettings>>().Value); 

Services.AddSingleton<BookService>(); 

Services.AddControllers() 

.AddNewtonsoftison(options => options.UseMemberCasingO); 

} 

Önceki değişiklik ile, Web API 'sinin seri hale getirilmiş JSON yanıtındaki Özellik adları CLR nesne türündeki 
ilgili özellik adlarıyla eşleşir. Örneğin, Book sınıfının Author özelliği Author olarak serileştirir. 

3. Modeller/Book. cs' de, BookName özelliğine aşağıdaki [DsonProperty] özniteliğiyle açıklama ekleyin: 

[BsonElement("Name")] 

[IsonProperty("Name")] 

public string BookName { get; set; } 

[isonProperty] özniteliğinin değeri Name , Web API 'sinin serileştirilmiş JSON yanıtında özellik adını temsil 
eder. 

4. [JsonProperty] öznitelik başvurusunu çözümlemek için modeller/Book. cs ' nin en üstüne aşağıdaki kodu 
ekleyin: 

using Newtonsoft.Hson; 

5. Web API 'Sini test etme bölümünde tanımlanan adımları yineleyin. JSON Özellik adlarındaki farka dikkat 
edin. 

Bu öğreticide vveb API'si temel oluşturma, okuma, güncelleştirme ve silme (CRUD) işlemleri gerçekleştiren 
oluşturur bir MongoDB NoSQL veritabanı. 

Bu öğreticide şunların nasıl yapıladığını öğreneceksiniz: 

• MongoDB yapılandırın 

• MongoDB veritabanı oluşturma 

• MongoDB koleksiyonu ve şema tanımlayın 

• Bir vveb API'sini MongoDB CRUD işlemleri gerçekleştirme 

• JSON serileştirmesini özelleştirme 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Prerequisites 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• .N ET Core SDK 2,2 

• ASP.net ve Web geliştirme iş yüküyle Visual Studio 2019 

• MongoDB 











MongoDB yapılandırın 

Windows kullanıyorsanız MongoDB, varsayılan olarak mongodb\C:\Program Fileş 'a yüklenir. \Program 
Files\MongoDB\Server\ <Version_Number >\ Path ) ortam değişkenine ekleyin. Bu değişiklik yerden MongoDB 
erişim sağlar, geliştirme makinenizde. 

Mongo kabuğunu veritabanı oluşturma, koleksiyonları yapın ve belgeleri depolamak için aşağıdaki adımları 
kullanın. Mongo Kabuğu komutları hakkında daha fazla bilgi için bkz. mongo kabuğunu çalışma. 

1. Geliştirme makinenizde verilerin depolanması için bir dizin seçin. Örneğin, C: Windows üzerinde\BooksData 
. Yoksa dizini oluşturun. Mongo kabuğunu yeni dizinleri oluşturmaz. 

2. Bir komut kabuğunu açın. Varsayılan bağlantı noktası 27017 mongodb'ye bağlanmak için aşağıdaki komutu 
çalıştırın. Değiştirmeyi unutmayın <data_directory_path> önceki adımda seçtiğiniz dizini. 

mongod --dbpath <data_directory_path> 

3. Başka bir komut kabuğu örneği açın. Aşağıdaki komutu çalıştırarak varsayılan test veritabanı 1 na bağlanma: 

mongo 

4. Bir komut kabuğu'nda aşağıdaki komutu çalıştırın: 

use BookstoreDb 

Adlı bir veritabanı zaten mevcut olmayan halinde BookstoreDb oluşturulur. Veritabanı mevcut değilse, 
bağlantı işlemleri için açılır. 

5. Oluşturma bir Books koleksiyon aşağıdaki komutu kullanarak: 

db.createCollection('Books') 

Aşağıdaki sonucu görüntülenir: 

{ "ok" : ı } 

6. İçin bir şema tanımlayabilir Books toplama ve ekleme iki belge aşağıdaki komutu kullanarak: 

db.Books.insertMany([{'Name':'Design Patterns' , 'Price':54.93 , 'Category':'Computers ', 'Author':'Ralph 
Johnson'}, {'Name':'Clean Code’, 'Price’:43.15,'Category':'Computers','Author':'Robert C. Martin'}]) 


Aşağıdaki sonucu görüntülenir: 

{ 

"acknowledged" : true, 

"insertedlds" : [ 

ObjectId("5bfd996f7b8e48dcl5ff215d"), 
ObjectId("5bfd996f7b8e48dcl5ff215e") 

] 

} 












NOTE 

Bu makalede gösterilen KİMLİK, bu örneği çalıştırdığınızda kimliklerle eşleşmeyecektir. 


7. Aşağıdaki komutu kullanarak veritabanında belgelerini görüntüleyin: 
db.Books.find({}).pretty() 

Aşağıdaki sonucu görüntülenir: 

{ 

"_id" : ObjectId("5bfd996f7b8e48dcl5ff215d"), 

"Name" : "Design Patterns", 

"Price" : 54.93, 

"Category" : "Computers", 

"Author" : "Ralph Dohnson" 

} 

{ 

"_id" : ObjectId("5bfd996f7b8e48dcl5ff215e"), 

"Name" : "Clean Code", 

"Price" : 43.15, 

"Category" : "Computers", 

"Author" : "Robert C. Martin" 

} 

Şema girmiş ekler _id türünün özelliği objectid her belge için. 

Veritabanı hazırdır.ASP.N ET Core web API'si oluşturmaya başlayabilirsiniz. 

ASP.NET Core web API projesi oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

1. Dosya > Yeni > projesi' ne gidin. 

2. ASP.N ET Core Web uygulaması proje türünü seçin ve İleri' yi seçin. 

3. Projeyi Booksapıo larak adlandırın ve Oluştur' u seçin. 

4. .NET Core hedef çerçevesini ve 2,2 ASP.N ET Coreseçin. API proje şablonunu seçin ve Oluştur' u seçin. 

5. MongoDB için .NET sürücüsünün en son kararlı sürümünü öğrenmek üzere NuGet galerisini ziyaret edin: 
MongoDB. Driver. içinde Paket Yöneticisi Konsolu penceresinde proje kök dizinine gidin. MongoDB için 
.NET sürücüsünü yüklemek için aşağıdaki komutu çalıştırın: 

Install-Package MongoDB.Driver -Version {VERSION} 


Varlık modeli ekleme 

1. Ekleme bir modelleri proje kök dizini. 


2. Ekleme bir Book sınıfının modelleri aşağıdaki kod ile dizin: 











using MongoDB.Bson; 

using MongoDB.Bson.Serialization.Attributes; 

namespace BooksApi.Models 

{ 

public class Book 

{ 

[Bsonld] 

[BsonRepresentation(BsonType.Objectld)] 
public string Id { get; set; } 

[BsonElement("Name") ] 

public string BookName { get; set; } 

public decimal Price { get; set; } 

public string Category { get; set; } 

public string Author { get; set; } 

} 

} 

Önceki sınıfta id özelliği: 

• Ortak dil çalışma zamanı (CLR) nesnesini MongoDB koleksiyonuna eşlemek için gereklidir. 

• , Bu özelliği belgenin birincil anahtarı olarak belirlemek için [Bsonid] ile açıklama eklenir. 

• , Parametreyi Objectl D yapısı yerine tür string olarak geçirmeyi sağlayan 

[BsonRepresentation(BsonType.Objectld)] ile açıklama eklenir. Mongo, string dönüştürmeyi Objectld 
olarak işler. 

BookName özelliğine [BsonElement] özniteliğiyle açıklama eklenir. Özniteliğin Name değeri, MongoDB 
koleksiyonundaki özellik adını temsil eder. 

Yapılandırma modeli ekleme 

1. Aşağıdaki veritabanı yapılandırma değerlerini appSettlngs. VSOA/öğesine ekleyin: 

{ 

"BookstoreDatabaseSettings": { 

"BooksCollectionName": "Books", 

"ConnectionString": "mongodb://localhost:27017", 

"DatabaseName": "BookstoreDb" 

}, 

"Logging": { 

"IncludeScopes": false, 

"Debug": { 

"LogLevel": { 

"Default": "Warning" 

} 

b 

"Console": { 

"LogLevel": { 

"Default": "Warning" 

} 

} 

} 

} 


2. Modeller dizinine aşağıdaki kodla bir BookstoreDatabaseSettlngs.es dosyası ekleyin: 














namespace BooksApi.Models 

{ 

public class BookstoreDatabaseSettings : IBookstoreDatabaseSettings 

{ 

public string BooksCollectionIMame { get; set; } 
public string ConnectionString { get; set; } 
public stning DatabaseName { get; set; } 

} 

public interface IBookstoreDatabaseSettings 

{ 

string BooksCollectionName { get; set; } 
string ConnectionString { get; set; } 
string DatabaseName { get; set; } 

} 

} 

Yukarıdaki BookstoreDatabaseSettings Simfl, appSettings. JSON dosyasının BookstoreDatabaseSettings 
özellik değerlerini depolamak için kullanılır. JSON ve C# Özellik adları, eşleme sürecini kolaylaştırmak için 
aynı şekilde adlandırılır. 


3. Aşağıdaki Vurgulanan kodu startup.configureServices ekleyin: 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<BookstoreDatabaseSettings>( 

Configuration.GetSection(nameof(BookstoreDatabaseSettings))); 

Services.AddSingleton<IBookstoreDatabaseSettings>(sp => 

sp.GetRequiredService<IOptions<BookstoreDatabaseSettings>>().Value); 


} 


Services. AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


Yukarıdaki kodda: 

• AppSettings. JSON dosyasının BookstoreDatabaseSettings bölüm bağlandığı yapılandırma örneği, 
bağımlılık ekleme (dı) kapsayıcısına kaydedilir. Örneğin, bir BookstoreDatabaseSettings nesnesinin 

ConnectionString Özelliği appSettings. VSO/VİÇİndeki BookstoreDatabaseSettingsrConnectionString Özelliği 
ile doldurulur. 

• IBookstoreDatabaseSettings arabirimi, tek bir hizmet ömrüile dı 'ye kaydedilir. Eklerken, arabirim örneği 
bir BookstoreDatabaseSettings nesnesine çözümlenir. 

4. BookstoreDatabaseSettings ve IBookstoreDatabaseSettings başvurularım çözümlemek için aşağıdaki kodu en 
üst kLsmına ekieyin : 

using BooksApi.Models; 


CRUD işlemleri hizmeti ekleme 

1. Ekleme bir Hizmetleri proje kök dizini. 


2. Ekleme bir BookService sınıfının Hizmetleri aşağıdaki kod ile dizin: 
















using BooksApi.Models; 
using MongoDB.Driver; 
using System.Collections.Generic; 
using System.Linq; 

namespace BooksApi.Services 

{ 

public class BookService 

{ 

private readonly IMongoCollection<Book> _books; 

public BookService(IBookstoreDatabaseSettings settings) 

{ 

var Client = new MongoClient(settings.ConnectionString); 
var database = Client.GetDatabase(settings.DatabaseName); 

_books = database.GetCollection<Book>(settings.BooksCollectionName); 

} 

public List<Book> Get() => 

_books.Find(book => true).ToList(); 

public Book Get(string id) => 

_books.Find<Book>(book => book.Id == id).FirstOrDefault(); 

public Book Create(Book book) 

{ 

_books.InsertOne(book); 
return book; 

} 

public void Update(string id, Book bookln) => 

_books.ReplaceOne(book => book.Id == id, bookln); 

public void Remove(Book bookln) => 

_books.DeleteOne(book => book.Id == bookln.Id); 

public void Remove(string id) => 

_books.DeleteOne(book => book.Id == id); 

} 

} 

Yukarıdaki kodda, Oluşturucu ekleme yoluyla dı 'den bir iBookstoreDatabaseSettings örneği alınır. Bu teknik, 
yapılandırma modeli ekleme bölümüne eklenen appSettings. JSON yapılandırma değerlerine erişim sağlar. 


3. Aşağıdaki Vurgulanan kodu startup.configureServices ekleyin: 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<BookstoreDatabaseSettings>( 

Configuration.GetSection(nameof(BookstoreDatabaseSettings))); 

Services.AddSingleton<IBookstoreDatabaseSettings>(sp => 

sp.GetRequiredService<IOptions<BookstoreDatabaseSettings>>().Value); 

Services.AddSingleton<BookService>(); 


} 


Services. AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


Önceki kodda, BookService sınıfı, tüketen sınıflarda Oluşturucu ekleme işlemini desteklemek için Dİ ile 
kaydedilir. BookService, Mongociient doğrudan bağımlılığı sağladığından, tek hizmet ömrü en uygundur. 








Resmi Mongo istemci yeniden kullanım yönergeleritemelinde Mongociient , tek bir hizmet ömrü ile birlikte 
kaydedilmelidir. 

4. BookService başvurusunu çözümlemek için aşağıdaki kodu Startup.es 'un en üstüne ekleyin: 

using BooksApi.Services; 

BookService Sınıfını kullanan aşağıdaki MongoDB.Driver veritabanında CRUD işlemleri gerçekleştirmek için üyeleri 

• Mongociient-, veritabanı işlemlerini gerçekleştirmek için sunucu örneğini okur.Bu sınıfın oluşturucusu, 
MongoDB bağlantı dizesini sağlanır: 

public BookService(IBookstoreDatabaseSettings settings) 

{ 

var Client = new MongoClient(settings.ConnectionString); 
var database = Client.GetDatabase(settings.DatabaseName); 

_books = database.GetCollection<Book>(settings.BooksCollectionName); 

} 

• Imongodatabase- işlemleri gerçekleştirmek İçin Mongo veritabanını temsil eder. Bu öğretici, belirli bir 
koleksiyondaki verilere erişim kazanmak için arabirimindeki genel GetCollectioncTDocument > (koleksiyon) 
yöntemini kullanır. Bu yöntem çağrıldıktan sonra, koleksiyonda CRUD işlemleri gerçekleştirin, içinde 

GetCollection<TDocument>(collection) yöntem çağrısı: 

o colleetion Koleksiyon adını temsil eder. 

o TDocument Bir koleksiyonda depolanan CLR nesne türünü temsil eder. 

Getcoiiection<TDocument>(colleetion) , koleksiyonu temsil eden bir Mongocollection nesnesi döndürür. Bu 
öğreticide, aşağıdaki yöntemlerden koleksiyonunda çağrılır: 

• Deleteone -, belirtilen arama ölçütleriyle eşleşen tek bir belgeyi siler. 

• <TDocument > bul -, koleksiyonda belirtilen arama ölçütleriyle eşleşen tüm belgeleri döndürür. 

• Insertone -, belirtilen nesneyi koleksiyondaki yeni bir belge olarak ekler. 

• Replaceone -, belirtilen arama ölçütleriyle eşleşen tek belgeyi, belirtilen nesneyle değiştirir. 

Denetleyici ekleme 

Ekleme bir BooksControiler sınıfının denetleyicileri aşağıdaki kod ile dizin: 

using BooksApi.Models; 
using BooksApi.Services; 
using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 

namespace BooksApi.Controllers 
{ 

[Route("api/[controller]")] 

[ApiController] 

public elass BooksControiler : ControllerBase 
{ 

private readonly BookService _bookService; 

public BooksController(BookService bookService) 

{ 

_bookService = bookService; 


} 








Lt-rcrpüerj 

public ActionResult<List<Book>> Get() => 

_bookService.Get(); 

[HttpGet("{id:length(24)}"j Name = "GetBook")] 
public ActionResult<Book> Get(string id) 

{ 

var book = _bookService.Get(id); 

if (book == null) 

{ 

return NotFound(); 

} 

return book; 

} 

[HttpPost] 

public ActionResult<Book> Create(Bool< book) 

{ 

_bookService.Create(book); 

return CreatedAtRouteC'GetBook", new { id = book.Id.ToStringO }, book); 

} 

[HttpPut("{id:length(24)}")] 

public IActionResult Update(string id, Book bookln) 

{ 

var book = _bookService.Get(id); 

if (book == null) 

{ 

return NotFound(); 

} 

_bookService.Update(id, bookln); 
return NoContent(); 

} 

[FlttpDelete("{id: length(24)}") ] 
public IActionResult Delete(string id) 

{ 

var book = _bookService.Get(id); 

if (book == null) 

{ 

return NotFound(); 

} 

_bookService.Remove(book.Id); 
return NoContent(); 

} 

} 

} 


Önceki web API denetleyicisi: 

• Kullanan BookService CRUD işlemleri gerçekleştirmek için sınıf. 

• GET, POST, PUT ve DELETE HTTP isteklerini desteklemek için eylem yöntemleri içerir. 

• Bir HTTP 201 yanıtı döndürmek için create eylemi yönteminde CreatedAtRoute çağırır. Durum kodu 201, 
sunucuda yeni bir kaynak oluşturan HTTP POST yöntemi için standart yanıttır. CreatedAtRoute Ayrıca yanıta bir 

Location üst bilgisi ekler. Location üstbilgisi yeni oluşturulan kitabın U RI 'sini belirtir. 







Web API 'sini test etme 

1. Uygulamayı derleyin ve çalıştırın. 


2. Denetleyicinin parametresiz Get eylem yöntemini sınamak için http://iocaihost:<port>/api/books gidin. 
Aşağıdaki JSON yanıtı gösterilir: 

[ 

{ 

"id":"5bfd996f7b8e48dcl5ff215d", 

"bookName":"Design Patterns", 

"price":54.93, 

"category":"Computers", 

"author":"Ralph lohnson" 

}, 

{ 

"id":"5bfd996f7b8e48dcl5ff215e", 

"bookName":"Clean Code", 

"price":43.15, 

"category":"Computers", 

"author":"Robert C. Martin" 

} 

] 

3. Denetleyicinin aşırı yüklenmiş Get eylem yöntemini sınamak için 

http://localhost:<port>/api/books/{id here} gidin. Aşağıdaki JSON yanıtı gösterilir: 

{ 

"id":"{ID}", 

"bookName":"Clean Code", 

"price":43.15, 

"category":"Computers", 

"author":"Robert C. Martin" 


JSON serileştirme seçeneklerini yapılandırma 

Web API 'Sini test etme bölümünde döndürülen JSON yanıtları hakkında iki ayrıntı vardır: 

• ' Varsayılan ortası büyük/küçük harf özelliği, CLR nesnesinin özellik adlarının Pascal büyük küçük harfleriyle 
eşleşecek şekilde değiştirilmelidir. 

• bookName özelliği Name olarak döndürülmelidir. 

Önceki gereksinimleri karşılamak için aşağıdaki değişiklikleri yapın: 

1. startup.configureServices ' de, aşağıdaki vurgulanmış kodu AddMvc yöntemi çağrısına zincirle: 










public void Configur'eSer'vices(IServiceCollection Services) 

{ 

Services.Configure<BookstoreDatabaseSettings>( 

Configuration.GetSection(nameof(BookstoreDatabaseSettings))); 

Services.AddSingleton<IBookstoreDatabaseSettings>(sp => 

sp.GetRequiredService<IOptions<BookstoreDatabaseSettings>>().Value); 

Services.AddSingleton<BookService>(); 

Services. AddMvc() 

.AddDsonOptions(options => options.UseMemberCasingO) 
.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

} 

Önceki değişiklik ile, Web API 'sinin seri hale getirilmiş JSON yanıtındaki Özellik adları CLR nesne türündeki 
ilgili özellik adlarıyla eşleşir. Örneğin, Book sınıfının Author özelliği Author olarak serileştirir. 

2. Modeller/Book. cs' de, BookName özelliğine aşağıdaki [DsonProperty] özniteliğiyle açıklama ekleyin: 

[BsonElement("Name")] 

[DsonProperty("Name")] 

public string BookName { get; set; } 

özniteliğinin değeri Name , Web API 'sinin serileştirilmiş JSON yanıtında özellik adını temsil 


[IsonProperty] 

eder. 


3. psonProperty] öznitelik başvurusunu çözümlemek için modeller/Book. cs ' nin en üstüne aşağıdaki kodu 
ekleyin: 

using Newtonsoft.Ison; 

4. Web API 'Sini test etme bölümünde tanımlanan adımları yineleyin. JSON Özellik adlarındaki farka dikkat 
edin. 

Web API 'sine kimlik doğrulama desteği ekleme 

ASP.NET Core kimlik, ASP.NET Core Web uygulamalarına Kullanıcı arabirimi (Ul) oturum açma işlevselliği ekler. 
Web API 'Leri ve maça 'ları güvenli hale getirmek için aşağıdakilerden birini kullanın: 

• Azure Active Directory 

• Azure Active Directory B2C (Azure AD B2C)] 

• Identityserver4 

Identityserver4, ASP.NET Core 3,0 için bir OpenlD Connect ve OAuth 2,0 çerçevesidir.Identityserver4 aşağıdaki 
güvenlik özelliklerini sunar: 

• Hizmet olarak kimlik doğrulaması (AaaS) 

• Birden çok uygulama türü üzerinde çoklu oturum açma/kapatma (SSO) 

• API 'Ler için erişim denetimi 

• Federasyon ağ geçidi 

Daha fazla bilgi için bkz. ıdentityserver4 to VVelcome. 


Sonraki adımlar 













ASP.NET Core web API'leri oluşturmaya daha fazla bilgi için aşağıdaki kaynaklara bakın: 


• Bu makalenin YouTube sürümü 

• ASP.NET Core ile Web API 'Leri oluşturma 

• ASP.NET Core Web API 'sindeki denetleyici eylemi dönüş türleri 


Öğretici: JavaScript ile ASPNET Core Web API 'SI 
çağırma 

3.12.2019 • 7 minutes to read ı Edit Online 


Rick Anderson tarafından 

Bu öğreticide, Fetch APIkullanılarak JavaScript ile ASP.NET Core Web API 'sinin nasıl çağrılacağını 
gösterilmektedir. 

ASP.NET Core 2,2 için, JavaScript ile Web API 'Sini çağırma2,2 sürümüne bakın. 

Prerequisites 

• Tüm öğreticiyi: Web API 'Si oluşturma 

• CSS, HTML ve JavaScript ile benzerlik 

JavaScript ile Web API 'sini çağırma 

Bu bölümde, Yapılacaklar öğeleri oluşturmak ve yönetmek için form içeren bir HTML sayfası ekleyeceksiniz. Olay 
işleyicileri sayfadaki öğelere iliştirilir. Olay işleyicileri, Web API 'sinin eylem yöntemlerine HTTP istekleri sonucu 
vermez. Fetch API 'sinin fetch işlevi her HTTP isteğini başlatır. 

fetch işlevi, bir Response nesnesi olarak temsil edilen bir HTTP yanıtı içeren bir Promise nesnesi döndürür. 
Ortak bir model, Response nesnesinde json işlevini çağırarak JSON yanıt gövdesini ayıklamaya yönelik bir 
modeldir. JavaScript, sayfayı Web API 'sinin yanıtından alınan ayrıntılarla güncelleştirir. 

En basit fetch çağrısı, yolu temsil eden tek bir parametreyi kabul eder, init nesnesi olarak bilinen ikinci bir 
parametre isteğe bağlıdır, init HTTP isteğini yapılandırmak için kullanılır. 

1. Uygulamayı statik dosyaları sunacak ve varsayılan dosya eşlemesini etkinleştirecekşekilde yapılandırın. 
Aşağıdaki vurgulanan kod Startup.es configune yönteminde gereklidir: 

public void Configure(IApplicationBuilder app, IUebHostEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

app.UseDefault Fileş Q; 
app.UseStaticFiles(); 

app.UseHttpsRedirection(); 

app.UseRouting(); 

app.UseAuthorization(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapControllers (); 

}); 

} 













2. Proje kökünde bir Wwwroot klasörü oluşturun. 


3. Wwwroot klasörü içinde bir js klasörü oluşturun. 

4. Wwwroot klasörüne index. HTML adlı bir HTM L dosyası ekleyin. index. html içeriğini aşağıdaki 
biçimlendirme ile değiştirin: 

<IDOCTYPE html> 

<html> 

<head> 

cmeta charset="UTF-8"> 

<title>To-do CRUD</title> 

<link rel="stylesheet" href="css/site.css" /> 

</head> 

<body> 

<hl>To-do CRUD</hl> 

<h3>Add</h3> 

<form action="javascript:void(0);" method="POST" onsubmit="addItem()"> 

<input type="text" id="add-name" placeholder="New to-do"> 

<input type="submit" value="Add"> 

</form> 

<div id="editForm"> 

<h3>Edit</h3> 

<form action="javascript:void(0);" onsubmit="updateItem()"> 

<input type="hidden" id="edit-id"> 

<input type="checkbox" id="edit-isComplete"> 

<input type="text" id="edit-name"> 
cinput type="submit" value="Save"> 

<a onclick="closeInput()" aria-label="Close">&#10006;</a> 

</form> 

</div> 

<p id="counter"x/p> 

<table> 

<tr> 

<th>Is Complete?</th> 

<th>Name</th> 

<thx/th> 

<thx/th> 

</tr> 

<tbody id="todos"x/tbody> 

</table> 

<script src="js/site.js" asp-append-version="true"x/script> 

<script type="text/javascript"> 
g8tltems(); 

</script> 

</body> 

</html> 


5. Wwwroot/js klasörüne site, js adlı bir JavaScript dosyası ekleyin. Site.js içeriğini aşağıdaki kodla değiştirin: 

const uri = 'api/Todoltems’; 
let todos = []; 

function getltems() { 
fetch(uri) 

.then(response => response.json()) 

.then(data => _displayltems(data)) 

.catch(error => console.error('Unable to get items.'j error)); 

} 

function addltem() { 
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const item = { 

isComplete: false, 

name: addNameTextbox.value.trim() 

b 


fetch(uri, { 
method: 'POST', 
headens: { 

'Accept': ’application/json', 

'Content-Type': 'application/json' 

b 

body: TSON.stringify(item) 

}) 

,then(response = > response.json()) 

,then(() => { 
getltems(); 

addNameTextbox.value = 

}) 

.catch(error => console.error('Unable to add item.', error)); 


function deleteltem(id) { 
fetch('${uri}/${id}', { 

method: ’DELETE' 

}) 

,then(() = > getltems()) 

.catch(error => console.error('Unable to delete item.', error)); 

} 

function displayEditForm(id) { 

const item = todos.find(item => item.id === id); 

document.getElementById('edit-name').value = item.name; 
document,getElementById('edit-id').value = item.id; 
document.getElementById('edit-isComplete').checked = item.İsComplete; 
document.getElementById(’editForm').style.display = 'block'; 

} 

function updateltem() { 

const itemld = document.getElementById('edit-id').value; 
const item = { 

id: parselnt(itemld, 10), 

isComplete: document.getElementById('edit-isComplete').checked, 
name: document.getElementById('edit-name').value.trim() 

b 


fetch('${uri}/${itemld}', { 
method: ’PUT’, 
headers: { 

'Accept': 'application/json', 

'Content-Type': 'application/json' 

b 

body: ISON.stringify(item) 

}) 

,then(() => getltems()) 

.catch(error => console.error('Unable to update item.', error)); 

closeInput(); 

return false; 

} 

function closeInput() { 

document.getElementById('editForm').style.display = 'none'; 

} 


function _displayCount(itemCount) { 


const name = (.ıtemcount === ı; i to-do' : to-dos'; 


document,getElementById('counten').innenText = '${itemCount} ${name}'; 

} 

function _displayltems(data) { 

const tBody = document.getElementById('todos'); 
tBody.innerHTML = ''; 

_displayCount(data.length); 

const button = document.createElement('button'); 
data.forEach(item => { 

let isCompleteCheckbox = document.createElement('input'); 
isCompleteCheckbox.type = 'checkbox'; 
isCompleteCheckbox.disabled = true; 
isCompleteCheckbox.checked = item.isComplete; 

let editButton = button.cloneNode(false); 
editButton.innerText = 'Edit’; 

editButton.setAttribute('onclick’, 'displayEditForm(${item.id})'); 

let deleteButton = button.cloneNode(false); 
deleteButton.innerText = ’Delete’; 

deleteButton.setAttribute('onclick ', ' deleteltem(${item.id})'); 

let tr = tBody.insertRow(); 

let tdl = tr.insertCell(0); 
tdl.appendChild(isCompleteCheckbox); 

let td2 = tr.insertCell(l); 

let textNode = document.createîextNode(item.name); 
td2.appendChild(textNode); 

let td3 = tr.insertCell(2); 
td3.appendChild(editButton); 

let td4 = tr.insertCell(3); 
td4.appendChild(deleteButton); 

}); 

todos = data; 

} 


HTML sayfasını yerel olarak test etmek için ASP.NET Core projesinin başlatma ayarlarındaki bir değişikliğin 
yapılması gerekebilir: 

1. Properties\launchSettings.JSON'\ açın. 

2. Uygulamayı, projenin varsayılan dosyası— Dizin, html' de açmaya zorlamak için launchuri özelliğini kaldırın. 
Bu örnek, Web API 'sinin tüm CRUD yöntemlerini çağırır.Web API isteklerinin açıklamaları aşağıda verilmiştir. 

Yapılacaklar öğelerinin bir listesini alın 

Aşağıdaki kodda, API/todcutems yoluna BİR http get isteği gönderilir: 

fetch(uri) 

,then(response => response.json()) 

,then(data => _displayltems(data)) 

.catch(error => console.error('Unable to get items.'j error)); 

Web API'SI başarılı bir durum kodu döndürdüğünde _dispiayitems işlevi çağrılır. _dispiayitems tarafından 
kabul edilen dizi parametresindeki her Yapılacaklar öğesi, Düzenle ve Sil düğmeleriyle bir tabloya eklenir. Web 






API isteği başarısız olursa, tarayıcının konsoluna bir hata kaydedilir. 

Yapılacaklar öğesi ekleme 

Aşağıdaki kodda: 

• item değişken, yapılacaklar öğesinin nesne sabit gösterimini oluşturmak için bildirilmiştir. 

• Aşağıdaki seçeneklerle bir getirme isteği yapılandırılır: 
o method —HTTP eyleminin SONRASı fiilini belirtir. 

o body—, istek gövdesinin JSON temsilini belirtir. JSON, item 1 de depolanan nesne sabit değeri JSON. 
stringbelirt işlevine geçirilerek oluşturulur. 

o headers— Accept ve Content-Type HTTP istek üst bilgilerini belirtir. Her iki üst bilgi de 
appücation/json olarak ayarlanır ve sırasıyla, alınan ve gönderilen medya türünü belirtir. 

• API/todcutems yoluna BİR http post isteği gönderilir. 


function addltem() { 

const addNameTextbox = document.getElementById('add-name'); 

const item = { 

isComplete: false, 

name: addNameTextbox.value.trim() 

}; 

fetch(uri, { 
method: 'POST', 
headers: { 

'Accept': 'appücation/json', 

'Content-Type' : 'appücation/json' 

}, 

body: 3S0N.stringify(item) 

}) 

,then(response => response.json()) 

•then(() => { 
getltems(); 

addNameTextbox.value = 

}) 

.catch(error => console.error('Unable to add item.', error)); 

} 

Web API 'SI başarılı bir durum kodu döndürdüğünde, getıtems işlevi HTML tablosunu güncelleştirmek için 
çağrılır. Web API isteği başarısız olursa, tarayıcının konsoluna bir hata kaydedilir. 

Yapılacaklar öğesini güncelleştirme 

Bir yapılacaklar öğesinin güncelleştirilmesi bir tane eklemeye benzer; Ancak, iki önemli fark vardır: 

• Yol, güncelleştirilecek öğenin benzersiz tanımlayıcısı ile sone düzeltildi. Örneğin, api/todoıtems/1. 

• HTTP eylemi fiili, method seçeneği tarafından belirtilen şekilde konur. 

fetch('${uri}/${itemld}', { 
method: 'PUT', 
headers: { 

'Accept': 'appücation/json', 

'Content-Type' : 'appücation/json' 

}, 

body: DSON.stringify(item) 

}) 

,then(() => getltems()) 

,catch(error => console.error('Unable to update item.', error)); 


Bir yapılacaklar öğesini silme 











Bir yapılacaklar öğesini silmek için, isteğin method seçeneğini delete olarak ayarlayın ve URL'de öğenin 
benzersiz tanımlayıcısını belirtin. 

fetch(~ ${uri}/${id }', { 
method: 'DELETE' 

}) 

.then(() => getltems()) 

.catch(error => console.error(’Unable to delete item.', error)); 


Web API 'SI yardım sayfaları oluşturmayı öğrenmek için bir sonraki öğreticiye ilerleyin: 
Svvashbuckle ve ASP.NET Core kullanmaya başlayın 





ASPNET Core ile yerel mobil uygulamalar için arka uç 
hizmetleri oluşturma 

6.12.2019 • 12 minutes to read ı Edit Online 


Steve Smith tarafından 

Mobil uygulamalar ASP.NET Core arka uç hizmetleriyle iletişim kurabilir.İOS simülatörleri ve Android 
öykünücülerinden yerel Web hizmetlerini bağlama yönergeleri için bkz. İOS simülatörleri ve Android 
Öykünücülerinden yerel Web hizmetlerine bağlanma. 

Örnek arka uç hizmetleri kodunu görüntüle veya indir 

Örnek yerel mobil uygulama 

Bu öğreticide, yerel mobil uygulamaları desteklemek üzere AS P.N ET Core MVC kullanarak arka uç hizmetleri 
oluşturma gösterilmektedir. Android, İOS, VVİndovvs Evrensel ve Windows Phone cihazları için ayrı yerel istemciler 
içeren, Xamarin Forms ToDoRest uygulamasını yerel istemcisi olarak kullanır. Yerel uygulamayı oluşturmak (ve 
gerekli ücretsiz Xamarin araçlarını yüklemek) ve Xamarin örnek çözümünü indirmek için bağlantılı öğreticiyi 
izleyebilirsiniz. Xamarin örneği, bu makalenin ASP.NET Core uygulamasının yerini aldığı bir ASP.NET Web API 2 
Services projesi içerir (istemci tarafından gerekli olmayan değişiklikler olmadan). 
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Özellikler 

ToDoRest uygulaması, yapılacaklar öğelerini listelemeyi, eklemeyi, silmeyi ve güncellemeyi destekler. Her öğe bir 
KİMLİĞE, bir ada, notlara ve henüz gerçekleştirilip yapılmadığını gösteren bir özelliğe sahiptir. 

Öğelerin ana görünümü yukarıda gösterildiği gibi, her öğenin adını listeler ve bir onay işaretiyle gerçekleştirilip 
yapılmadığını gösterir. 

+ simgesine dokunarak öğe Ekle iletişim kutusu açılır: 
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Save 

Delete 

Cancel 

Speak 




Ana liste ekranındaki bir öğeye dokunduğunuzda, öğenin adı, notları ve bitti ayarlarının değiştirilebilmesi veya 
öğenin silinebileceği bir düzenleme iletişim kutusu açılır. 











Bu örnek varsayılan olarak, salt okuma işlemlerine izin veren developer.xamarin.com adresinde barındırılan arka uç 
hizmetlerini kullanacak şekilde yapılandırılmıştır. Bilgisayarınızı bilgisayarınızda çalışan bir sonraki bölümde 
oluşturulan AS P.N ET Core uygulamasına karşı test etmek için uygulamanın Resturi sabitini güncelleştirmeniz 
gerekir. îodorest projesine gidin ve Constants.es dosyasını açın. Resturi , makinenizin İP adresini (localhost veya 
127.0.0.1 değil) içeren bir URL ile değiştirin, bu adres, makineden değil cihaz öykünücüsünde kullanılıyor. Bağlantı 
noktası numarasını da (5000) dahil edin. Hizmetlerinizin bir cihazla birlikte çalıştığını test etmek için, bu bağlantı 
noktasına erişimi engelleyen etkin bir güvenlik duvarı olmadığından emin olun. 

// URL of REST service (Xamarin ReadOnly Service) 

//public static string RestUrl = "http://developer.xamarin.com:8081/api/todoitems{0}"; 

// use your machine's IP address 

public static string RestUrl = "http://192.168.1.207:5000/api/todoitems/{0}"j 


ASP.NET Core projesi oluşturma 

Visual Studio 'da yeni bir ASP.NET Core Web uygulaması oluşturun. Web API şablonunu ve kimlik doğrulaması 
yok ' ı seçin. Projeyi ToDoApio\arak adlandırın. 













New ASP.NET CoreVVeb Application (.NET Core) - WebApplication6 ? X 

A projecttemplatefor creating an ASP.NET Core 
application with an example Controllerfor a RESTful 
HTTP service. This template can also be used for 
ASP.NET MVC Views and Controllers. 

Learn more 


Change Authentication 
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Uygulama, 5000 numaralı bağlantı noktasına yapılan tüm isteklere yanıt vermelidir. Bunu başarmak için program.es 
'i . useuris("http: //*: 5060" ) ekleyin: 

var hoşt = new WebHostBuilder() 

.UseKestrel() 

.UseUrls("http://*:5000") 

.UseContentRoot(Directory.GetCurrentDirectory()) 

,UseIISIntegration() 

.UseStartup<Startup>() 

.Build(); 


NOTE 

Varsayılan olarak yerel olmayan istekleri yok sayan IIS Express arkasında değil, uygulamayı doğrudan çalıştırdığınızdan emin 
olun. Bir komut isteminden DotNet Run komutunu çalıştırın veya Visual Studio araç çubuğunda hata ayıklama hedefi açılır 
listesinden uygulama adı profilini seçin. 


Yapılacaklar öğelerini temsil etmek için bir model sınıfı ekleyin. Gerekli alanları [Reguired] özniteliğiyle işaretleyin: 































using System.ComponentModel.DataAnnotations; 

namespace ToDoApi.Models 

{ 

public class ToDoltem 

{ 

[Required] 

public string ID { get; set; } 

[Required] 

public string Name { get; set; } 

[Required] 

public stning Notes { get; set; } 
public bool Done { get; set; } 

} 

} 

API yöntemleri, verilerle çalışmak için bir yol gerektirir.Özgün Xamarin örneğinde kullanılan uoDoRepositony 
arabirimini kullanın: 


using System.Collections.Generic; 
using ToDoApi.Models; 


namespace ToDoApi.Interfaces 

{ 


public interface IToDoRepositony 

{ 

bool DoesItemExist(string id); 
IEnumerable<ToDoItem> Ali { get; } 
ToDoltem Find(string id); 
void Insent(ToDoItem item); 
void Update(ToDoItem item); 
void Delete(string id); 

} 


Bu örnek için, uygulama yalnızca özel bir öğe koleksiyonu kullanır: 

using System.Collections.Generic; 
using System.Linq; 
using ToDoApi.Interfaces; 
using ToDoApi.Models; 

namespace ToDoApi.Services 

{ 

public class ToDoRepository : IToDoRepository 

{ 

private List<ToDoItem> _toDoList; 

public ToDoRepository() 

{ 

InitializeData(); 

} 

public IEnumerable<ToDoItem> Ali 

{ 

get { return _toDoList; } 

} 

public bool DoesItemExist(string id) 

{ 

return _toDoList.Any(item => item.ID == id); 





} 


public ToDoltem Find(string id) 

{ 

return _toDoList.FirstOrDefault(item => item.ID 

} 

public void Insert(ToDoItem item) 

{ 

_toDoList.Add(item); 

} 

public void Update(ToDoItem item) 

{ 

var todoltem = this.Find(item.ID); 
var index = _toDoList.IndexOf(todoltem); 
_toDoList.RemoveAt(index); 
_toDoList.Insert(index, item); 

} 

public void Delete(string id) 

{ 

_toDoList.Remove(this.Find(id)); 

} 

private void InitializeData() 

{ 

_toDoList = new List<ToDoItem>(); 

var todolteml = new ToDoltem 

{ 

ID = "6bb8a868-dbal-4fla-93b7-24ebce87e243" 
Name = "Learn app development", 

Notes = "Attend Xamarin University", 

Done = true 

}; 

var todoItem2 = new ToDoltem 

{ 

ID = "b94afb54-alcb-4313-8af3-b7511551b33b" 
Name = "Develop apps", 

Notes = "Use Xamarin Studio/Visual Studio", 
Done = false 

}; 

var todoItem3 = new ToDoltem 

{ 

ID = " ecfa6f80-3671-4911-aabe-63cc442clecf" 
Name = "Publish apps", 

Notes = "Ali app Stores", 

Done = false, 

}; 


_toDoList.Add(todolteml); 
_toDoList.Add(todoItem2); 
_toDoList.Add(todoItem3); 

} 

} 

} 


Startup.cs'de uygulamayı yapılandırın: 


public void ConfigureServicesflServiceCollection Services) 

{ 

// Add framework Services. 

Services. AddMvc(); 

Services.AddSingleton<IToDoRepository,ToDoRepository>(); 

} 

Bu noktada, ToDoltemsControlleroluşturmak için hazırsınız demektir. 


TIP 

ASP.NET Core MVC ve Visual Studio ile İlk Web API 'Nizi derlemebölümünde Web API 'leri oluşturma hakkında daha fazla bilgi 
edinin. 


Denetleyici oluşturma 

Projeye yeni bir denetleyici ekleyin, ToDoltemsCorıtroller. Microsoft. AspNetCore. Mvc. Controller öğesinden 
devralması gerekir. Denetleyicinin api/todoitems başlayan yollara yapılan istekleri işleyeceğini göstermek için bir 
Route özniteliği ekleyin. Yoldaki [controller] belirteci denetleyicinin adıyla ( controller sonekini atlayarak) 
değiştirilmiştir ve özellikle genel yollar için yararlıdır. Yönlendirmehakkında daha fazla bilgi edinin. 

Denetleyici bir iToDoRepository işlevini gerektirir; denetleyicinin Oluşturucusu aracılığıyla bu türde bir örnek 
isteyin. Çalışma zamanında bu örnek, çerçevenin bağımlılık eklemedesteği kullanılarak sağlanacaktır. 

using System; 

using Microsoft.AspNetCore.Http; 
using Microsoft.AspNetCore.Mvc; 
using ToDoApi.Interfaces; 
using ToDoApi.Models; 

namespace ToDoApi.Controllers 
{ 

[Route("api/[controller]")] 

public class ToDoltemsController : Controller 
{ 

private readonly IToDoRepository _toDoRepository; 

public ToDoItemsController(IToDoRepository toDoRepository) 

{ 

_toDoRepository = toDoRepository; 

} 

Bu API, veri kaynağında CRUD (oluşturma, okuma, güncelleştirme, silme) işlemleri gerçekleştirmek için dört farklı 
HTTP fiillerini destekler. Bunların en basit yolu, bir HTTP GET isteğine karşılık gelen okuma işlemidir. 

Öğeleri okuma 

Öğelerin bir listesini istemek List metoduna yönelik GET isteğiyle yapılır. List yönteminde [HttpGet] özniteliği, 
bu eylemin yalnızca GET isteklerini işleyeceği anlamına gelir. Bu eylemin yolu, denetleyicide belirtilen yoldur. Yolun 
bir parçası olarak eylem adını kullanmanız gerekmez. Her bir eylemin benzersiz ve belirsiz bir yol içerdiğinden emin 
olmanız yeterlidir. Yönlendirme öznitelikleri, belirli yolları oluşturmak için hem denetleyiciye hem de Yöntem 
düzeylerine uygulanabilir. 














[HttpGet] 

public IActionResult List() 

{ 

return Ok(_toDoRepository.Ali); 

} 

List yöntemi, JSON olarak serileştirilmiş bir 200 Tamam yanıt kodu ve tüm ToDo öğelerini döndürür. 


Yeni API yönteminizi, Postmangibi çeşitli araçlar kullanarak test edebilirsiniz: 
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"Attend Xamarin University", 
true 


’b94afb54-alcb-4313-8af3-b7511551b33b”, 
"Develop apps", 

' : ”Use Xamarin Studio/Visual Studio”, 
false 
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Öğe oluşturma 

Kurala göre, yeni veri öğeleri oluşturmak HTTP POST fiili ile eşleştirilir, create yöntemine uygulanan bir 
[HttpPost] özniteliği vardır ve bir ToDoitem örneği kabul eder, iten bağımsız değişkeni POST gövdesinde 
geçirildiğinden, bu parametre [FromBody] özniteliğini belirtir. 

Yöntemi içinde, öğe geçerliliği için denetlenir ve veri deposunda daha önce bulunur ve herhangi bir sorun oluşursa, 
depo kullanılarak eklenir. Modeistate.isValid , model doğrulamasıgerçekleştirir ve Kullanıcı girişini kabul eden her 
API yönteminde yapılmalıdır. 

















[HttpPost] 

public IActionResult Create([FromBody] ToDoltem item) 

{ 

try 

{ 

if (item == null || IModelState.IsValid) 

{ 

return BadRequest(ErrorCode.TodoItemNameAndNotesRequired.ToString()); 

} 

bool itemExists = _toDoRepository.DoesItemExist(item.ID); 
if (itemExists) 

{ 

return StatusCode(StatusCodes.Status409Conflictj ErrorCode.TodoItemIDInUse.ToString()); 

} 

_toDoRepository.Insert(item); 

} 

catch (Exception) 

{ 

return BadRequest(ErrorCode.CouldNotCreateItem.ToString()); 

} 

return Ok(item); 


Örnek, mobil istemciye geçirilen hata kodlarını içeren bir Enum kullanır: 

public enum ErrorCode 

{ 

TodoItemNameAndNotesRequiredj 

TodoltemIDİnUse, 

RecordNotFoundj 

CouldNotCreateltem, 

CouldNotUpdateltemj 

CouldNotDeleteltem 

} 

isteğin gövdesinde JSON biçiminde yeni nesne sağlayan POST fiilini kullanarak yeni öğe ekleme işlemini test edin. 
Ayrıca, appücation/json'' Content-type belirten bir istek üst bilgisi de eklemeniz gerekir. 
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Yöntemi, yanıtta yeni oluşturulan öğeyi döndürür. 

Öğeler güncelleştiriliyor 

Kayıtları değiştirme HTTP PUT istekleri kullanılarak yapılır. Bu değişiklik dışında Edit yöntemi neredeyse create 
ile aynıdır. Kayıt bulunmazsa Edit eyleminin bir NotFound (404) yanıtı dönebileceğini unutmayın. 


[HttpPut] 

public IActionResult Edit([FromBody] ToDoltem item) 

{ 

try 

{ 

if (item == null || IModelState.IsValid) 

{ 

return BadRequest(ErrorCode.TodoItemNameAndNotesRequired.ToString()); 

} 

var existingltem = _toDoRepository.Find(item.ID); 
if (existingltem == null) 

{ 

return NotFound(ErrorCode.RecordNotFound.ToString()); 

} 

_toDoRepository.Update(item); 

} 

catch (Exception) 

{ 

return BadRequest(ErrorCode.CouldNotUpdateItem.ToString()); 

} 

return NoContent(); 




















Postman ile test etmek için fiili' i koymak için değiştirin, isteğin gövdesinde güncelleştirilmiş nesne verilerini 
belirtin. 
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Bu yöntem, başarılı olduğunda, önceden var olan API ile tutarlılık için NoContent (204) yanıtı döndürür. 

Öğeleri silme 

Kayıtları silme işlemi, hizmete SİLME istekleri yapılarak ve silinecek öğenin KİMLİĞİ geçirilerek gerçekleştirilir. 
Güncelleştirmelerde olduğu gibi, mevcut olmayan öğelere yönelik istekler NotFound yanıtlarını alacaktır. Aksi 
takdirde, başarılı bir istek NoContent (204) yanıtı alır. 

















[HttpDelete("{id}") ] 

public IActionResult Delete(string id) 

{ 

try 

{ 

var item = _toDoRepository.Find(id)j 
if (item == null) 

{ 

return NotFound(ErrorCode.RecordNotFound.ToString()); 

} 

_toDoRepository.Delete(id); 

} 

catch (Exception) 

{ 

return BadRequest(ErrorCode.CouldNotDeleteItem.ToString()); 

} 

return NoContent(); 


Silme işlevinin test edilirken, isteğin gövdesinde hiçbir şey gerekmediği unutulmamalıdır. 
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Ortak VVebAPI kuralları 

Uygulamanız için arka uç hizmetlerini geliştirirken, çapraz kesme sorunlarını işlemeye yönelik tutarlı bir kural veya 
ilke kümesiyle birlikte çalışmak isteyeceksiniz. Örneğin, yukarıda gösterilen hizmette, bulunamayan belirli kayıtlara 
yönelik istekler BadRequest bir yanıt yerine NotFound yanıtı aldı. Benzer şekilde, bu hizmete uygulanan ve model 
bağlantılı türlerde geçen komutlar Modeistate.isvalid her zaman denetlenir ve geçersiz model türleri için bir 















BadRequest döndürülür. 


API 'leriniz için ortak bir ilke tanımladıktan sonra, genellikle bunu bir filtredekapsülleyebilirsiniz. ASP.NET Core 
MVC uygulamalarında ortak API ilkelerini kapsüllemekhakkında daha fazla bilgi edinin. 

Ek kaynaklar 

• Kimlik Doğrulaması ve Yetkilendirme 




Öğretici: ASRNET Core SignalR ile çalışmaya başlama 
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Bu öğreticide SignalRkullanarak gerçek zamanlı bir uygulama oluşturmanın temelleri öğretilir. Aşağıdakileri nasıl 
yapacağınızı öğrenirsiniz: 

• Web projesi oluşturun. 

• SignalR istemci kitaplığı ekleyin. 

• SignalR hub'ı oluşturun. 

• Projeyi SignalRkullanacak şekilde yapılandırın. 

• Herhangi bir istemciden tüm bağlı istemcilere ileti gönderen kodu ekleyin. 

Sonunda, çalışan bir sohbet uygulamanız olacaktır: 


İ£ SignalRChat X + 

— n x 

| SignalRChat X + 

4r C i localhost:44378 & © : 

4- C A localhost:44378 © : 

SignalRChat 

SignalRChat 

User Hanna 

User Spencer 

Message ni everyone! 

Message Got your message Hanna. 

Send Message 

Send Message 

• Hanna says Hi everyone! 

• Spencer says Got your 
message Hanna. 

• Hanna says Hi everyone! 

• Spencer says Got your 
message Hanna. 
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Önkoşullar 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• ASP.net ve Web geliştirme iş yüküyle Visual Studio 2019 

• .NET Core 3,0 SDK veya üzeri 

Web uygulaması projesi oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Menüden dosya > yeni proje 1 yi seçin. 

• Yeni proje oluştur iletişim kutusunda ASP.N ET Core Web uygulaması 1 nı seçin ve ardından İleri' yi 


seçin. 













• Yeni projenizi yapılandırın iletişim kutusunda, proje signalrchatad\ru adlandırın ve ardından Oluştur 1 u 
seçin. 

• Yeni bir ASP.N ET Core Web uygulaması oluştur iletişim kutusunda .net Core ve ASP.N ET Core 3,0' i 

seçin. 

• Razor Pages kullanan bir proje oluşturmak için Web uygulaması ' nı seçin ve ardından Oluştur 1 u seçin. 
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Create a new ASP.NET Core web application 


.NET Core 


ASP.NET Core 3.0 


^ Empty 

An empty project template for creating an ASP.NET Core application. This template does not have any content in it. 




A project template for creating an ASP.NET Core application vvitlı an example Controller for a RESTful HTTP service. 
This template can also be used for ASP.NET Core MVC Views and Controllers. 


Web Application 

A project template for creating an ASP.NET Core application with example ASP.NET Razor Pages content. 


Web Application (Model-Vievv-Controller) 


A project template for creating an ASP.NET Core application vvith example ASP.NET Core MVC Vievvs and 
Controllers. This template can also be used for RFSTful HTTP Services. 
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A project template for creating an ASP.NEI Core application vvith Angular 
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Author: Microsoft 
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SignalR istemci kitaplığı ekleme 

SignalR sunucusu kitaplığı, ASP.N ET Core 3,0 paylaşılan çerçevesine dahildir.JavaScript istemci kitaplığı projeye 
otomatik olarak dahil değildir. Bu öğreticide, istemci kitaplığını unpkg' den almak İçin kitaplık Yöneticisi 'Ni (Libman) 
kullanacaksınız, unpkg, Node.js Paket Yöneticisi NPM 'de bulunan her şeyi teslim edebilen bir içerik teslim ağı 
(CDN)). 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Çözüm Gezgini, projeye sağ tıklayın ve > İstemci tarafı kitaplığı Ekle ' yi seçin. 

• İstemci tarafı kitaplığı Ekle İletişim kutusunda sağlayıcı için unpkgseçeneğini belirleyin. 

• Kitaplıkları @microsoft/signalr@latest girin. 

• Belirli dosyaları seç' i seçin, dağ/Browser klasörünü genişletin ve SignalR. js ve SignalR. min.js' yi seçin. 

• Hedef konumu Wwwroot/js/SignalR/ olarak ayarlayın ve yüklemeyiseçin. 























Add Client-Side Library 


X 


Provider: 


Library: 


unpkg 


@microsoft/signalr@latest 


O Inciude ali library fileş 
(•) Choose specific fileş: 


a ■ Fileş: 
a ^ dist 


a [ W] brovvser 

|[Vİ £T signalrjs 


B _ - 

3 signalr.js.map 

|g U signalr.min.jsl 


Target Location: 


wwwroot/js/signalr 


Install 


Cancel 


LibMan, bir Wwwroot/js/SignalR klasörü oluşturur ve seçilen dosyaları buna kopyalar. 

SignalR hub ’ı oluşturma 

Hub , istemci-sunucu iletişimini işleyen yüksek düzeyli bir işlem hattı görevi gören bir sınıftır. 

• SignalRChat proje klasöründe bir hub klasörü oluşturun. 

• Hub 'lar klasöründe, aşağıdaki kodla bir ChatHub.es dosyası oluşturun: 

using Microsoft.AspNetCore.SignalR; 
using System.Threading.Tasks; 

namespace SignalRChat.Hubs 
{ 

public elass ChatHub : Hub 
{ 

public async Task SendMessage(string user, string message) 

{ 

await Clients.All.SendAsync("ReceiveMessage", user, message); 

} 

} 


ChatHub sınıfı SignalR Hub sınıfından devralır. Hub sınıfı bağlantıları, grupları ve mesajlaşmayı yönetir. 

sendMessage yöntemi, tüm istemcilere ileti göndermek için bağlı bir istemci tarafından çağrılabilir. Yöntemi 
çağıran JavaScript istemci kodu Öğreticinin ilerleyen kısımlarında gösterilmektedir. SignalR kod, en fazla 
ölçeklenebilirlik sağlamak için zaman uyumsuzdur. 

SignalR Yapılandır 

SignalR sunucusu, SignalRSİgnalR istekleri geçirilecek şekilde yapılandırılmalıdır. 


• Aşağıdaki Vurgulanan kodu Startup.es dosyasına ekleyin. 











































using System; 

using System.Collections.Generic; 

using System.Linq; 

using System.Thneading.Tasks; 

using Microsoft.AspNetCore.Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.HttpsPolicy; 

using Microsoft.Extensions.Configuration; 

using Microsoft.Extensions.DependencyInjection; 

using Microsoft.Extensions.Hosting; 

using SignalRChat.Hubs; 

namespace SignalRChat 

{ 

public class Startup 

{ 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

// This method gets called by the runtime. Use this method to add Services to the Container, 
public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRazorPages(); 

Services. AddSignalR(); 

} 

// This method gets called by the runtime. Use this method to configure the HTTP request 
pipeline. 

public void Configure(IApplicationBuilder app, IWebHostEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

// The default HSTS value is 30 days. You may want to change this for production 
scenarios, see https://aka.ms/aspnetcore-hsts. 
app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 

app.UseRouting(); 

app.UseAuthorization(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapRazorPages(); 
endpoints.MapHub<ChatHub>("/chatHub"); 

}); 

} 

} 

} 


Bu değişiklikler, ASP.N ET Core bağımlılığı ekleme ve yönlendirme sistemlerine SignalR ekler. 


SignalR istemci kodu ekle 



• Pages\ındex.cshtml içindeki içeriği şu kodla değiştirin: 


@page 

<div class="container"> 

<div class="row">&nbsp;</div> 

<div class="row"> 

<div class="col-2">User</div> 

<div class="col-4"xinput type="text" id="userlnput" /></div> 
</div> 

<div class="row"> 

<div class="col-2">Message</div> 

<div class="col-4"xinput type="text" id="messagelnput" /x/div> 
</div> 

<div class="row">&nbsp;</div> 

<div class="row"> 

<div class="col-6"> 

<input type="button" id="sendButton" value="Send Message" /> 
</div> 

</div> 

</div> 

<div class="row"> 

<div class="col-12"> 

<hr /> 

</div> 

</div> 

<div class="row"> 

<div class="col-6"> 

<ul id="messagesList"x/ul> 

</div> 

</div> 

<script src="~/js/signalr/dist/browser/signalr. js"x/script> 

<script src="~/js/chat.js"x/script> 


Yukarıdaki kod: 

o Ad ve ileti metni ve Gönder düğmesi için metin kutuları oluşturur. 

o SignalR hub'ından alınan iletileri görüntülemek için id="messagesList" içeren bir liste oluşturur, 
o Bir sonraki adımda oluşturduğunuz SignalR ve sohbet, js uygulama koduna yönelik betik başvurularını 
içerir. 

• Wwwroot/js klasöründe, aşağıdaki kodla bir chat.js dosyası oluşturun: 




"use strict"; 

var connection = new signalR.HubConnectionBuilder().withUrl("/chatHub").build(); 

//Disable send button until connection is established 
document.getElementById("sendButton").disabled = true; 

connection.on("ReceiveMessage"j function (user, message) { 

var msg = message.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"); 
var encodedMsg = user + " says " + msg; 
var li = document.createElement("li"); 
li.textContent = encodedMsg; 

document.getElementByld("messagesList"). appendChild(li); 


connection.start(),then(function () { 

document.getElementById("sendButton").disabled = false; 

}).catch(function (err) { 

return console.error(err.toString()); 

}); 

document.getElementById("sendButton").addEventListener("click", function (event) { 
var user = document.getElementById("userInput").value; 
var message = document.getElementById("messageInput").value; 
connection.invoke("SendMessage", user, message).catch(function (err) { 
return console.error(err.toString()); 

}); 

event.preventDefault(); 


Yukarıdaki kod: 

o Bir bağlantı oluşturur ve başlatır. 

o , Hub 'a ileti gönderen bir işleyiciye Gönder düğmesine ekler. 

o , Hub 'dan iletileri alan ve bunları listeye ekleyen bir işleyici olan bağlantı nesnesine ekler. 

Uygulamayı çalıştırma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Uygulamayı hata ayıklamadan çalıştırmak için CTRL + F5 tuşlarına basın. 

• Adres çubuğundan URL 'yi kopyalayın, başka bir tarayıcı örneği veya sekme açın ve adres çubuğuna URL 'Yİ 
yapıştırın. 

• Tarayıcı' yı seçin, bir ad ve ileti girin ve İleti gönder düğmesini seçin. 

Ad ve ileti anında her iki sayfada da görüntülenir. 
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TIP 


• Uygulama işe yaramazsa, tarayıcı geliştirici araçlarınızı (Fi 2) açın ve konsola gidin. HTML ve JavaScript kodunuzla ilgili 
hatalarla karşılaşabilirsiniz. Örneğin, SignalR.js ' yi yönlendirenden farklı bir klasöre yerleştirdiğinizi varsayalım. Bu 
durumda, bu dosyaya başvuru çalışmaz ve konsolunda 404 hatası görürsünüz. 


^ DevTools - localhost:44378/ 


□ X 

[* (51 Elements Console Sources Netvvork Performance 

Memory Application 

Security Audits 0 2 • 

[0 0 top »O Filter 

Default levels ▼ 

$ 

O Failed to load resource: the server responded with a status of 

404 () 

Sİgnalr^jül 

O Uncaught Referencefcrror: signalR is not defined 
at chat.js:3 


chat.js:3 

> 


• Chrome 'da hata ERR_SPDY_INADEQUATE_TRANSPORT_SECURITY alırsanız, geliştirme sertifikanızı güncelleştirmek için 
şu komutları çalıştırın: 


dotnet 

dev-certs 

https 

--clean 

dotnet 

dev-certs 

https 

--trust 


Bu öğreticide SignalRkullanarak gerçek zamanlı bir uygulama oluşturmanın temelleri öğretilir.Aşağıdakileri nasıl 
yapacağınızı öğrenirsiniz: 

• Web projesi oluşturun. 

• SignalR istemci kitaplığı ekleyin. 

• SignalR hub'ı oluşturun. 

• Projeyi SignalRkullanacak şekilde yapılandırın. 

• Herhangi bir istemciden tüm bağlı istemcilere ileti gönderen kodu ekleyin. 

Sonunda, çalışan bir sohbet uygulamasına sahipsiniz: 
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• Joe says Hi everyone! • Joe says Hi everyone! 

• Nancy says Got your message. Joe • Nancy says Got your message, Joe 


© 2018 - SignalRChat 


© 2018 - SignalRChat 


Önkoşullar 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Visual Studio 2017 sürüm 15,9 veya üzeri ile ASP.N ET ve web geliştirme iş yükü. Kullanabileceğiniz Visual 
Studio 2019, ancak bazı proje oluşturma adımlarını öğreticide gösterilen öğesinden farklı. 

• .NET core SDK 2.2 veya üzeri 


VVARNING 

Visual Studio 2017 kullanıyorsanız bkz dotnet/SDK'sı sorun #3124 Visual Studio ile çalışmayan .NET Core SDK sürümleri 
hakkında bilgi için. 


Birvveb projesi oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Menüden dosya > yeni proje 1 yi seçin. 

• Yeni proje iletişim kutusunda, yüklü > Visual C# > Web > ASP.NET Core Web uygulaması' nı seçin. 
Projeyi Signalrchatolarak adlandırın. 



























New Project 


X 
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^ Installed 
a Visual C# 

Windows Classic Desktop 

Web I 

Previous Versions 
.NET Core 
.NET Standard 
Cloud 
Test 
WCF 

t Visual Basic 
l> Visual F# 

SQL Server 
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l> TypeScript 
l> Other Project Types 


Şort by: Default 


Search (Ctrl+E 


fi - 


ASP.NET Core Web Application 


ASP.NET Web Application (.NET Framework) 


Visual C# 


Visual C# 


Type: Visual C# 

Project templates for creating ASP.NET 
Core applications for Windows. Linux and 
macOS using .NET Core or .NET 
Framevvork. Create Razor Pages, MVC. 
Web API. and Single Page (SPA) 
Applications. 


Not finding what you are looking for? 


Öpen Visual Studio Installer 


Name: 

| SignalRChatj 

-1 

Location: 

| C:\Users\Rachel\source\repos 


Solution: 

| Create new solution 

Z3 

Solution name: 

SignalRCHat 



Browse... 


0 Create directory for solution 
0 Add to Source Control 


I OK I 


Cancel 


• Razor Pages kullanan bir proje oluşturmak için Web uygulaması' nı seçin. 

• .NET Core'un hedef çerçevesini seçin, ASP.N ET Core 2,2' i seçin ve Tamam 1 ı tıklatın. 



SignalR istemci kitaplığı ekleme 

SignalR sunucusu kitaplığı, Microsoft.AspNetcore.App metapackage 'e dahildir. JavaScript istemci kitaplığı projeye 
otomatik olarak dahil değildir. Bu öğreticide, istemci kitaplığını unpkg 'den almak İçin kitaplık Yöneticisi 1 Ni (Libman) 
kullanacaksınız, unpkg, Node.js Paket Yöneticisi NPM 'de bulunan her şeyi teslim edebilen bir içerik teslim ağı 


















































(CDN)). 


• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Çözüm Gezgini, projeye sağ tıklayın ve > İstemci tarafı kitaplığı Ekle ' yi seçin. 

• İstemci tarafı kitaplığı Ekle İletişim kutusunda sağlayıcı için unpkgseçeneğini belirleyin. 

• Kitaplıkıcın @microsoft/signair@3 girin ve Önizleme olmayan en son sürümü seçin. 


Add Client-Side Library 

Providen 


X 


unpkg v 


Library: 

O Include ali library fileş 
(S) Choose specific fileş: 


©aspnet/signalr©l[ | 


□ I Fileş: 


©aspnet/signalr© 1.0.0 

©aspnet/signalr@1.0.2 

1 

ıreview1-35029 

| ©aspnet/signalr@1.0.3 | 

©aspnet/signalr©1.1.0-p 


Target Location: wwwroot/lib/signalr/ 


Install 


Cancel 


Belirli dosyaları seç' i seçin, dağ/Browser klasörünü genişletin ve SignalR.js ve SignalR. mirı.js' yi seçin. 
Hedef konumu Wwwroot/lib/SignaIR/ olarak ayarlayın ve yüklemeyiseçin. 


Add Client-Side Library 


X 


Providen 


unpkg 


Library: ©aspnet/signalr© 1.0.3 

O Include ali library fileş 
(§) Choose specific fileş: 


a [S] w Fileş: 
a [■) » dist 

brovvser 

|[V] J signalr.js | 

|_| U signalr.js.map 

I1V U signalr.min.js | 

] Q signalr.min.js.map 


‘Ti 


Target Location: 


wwwro ot/l i b/si g n a I r/ 


Install 


Cancel 


LibMan, bir Wwwroot/LIB/SignalR klasörü oluşturur ve seçilen dosyaları buna kopyalar. 























































SignalR hub 'ı oluşturma 

Hub , istemci-sunucu iletişimini işleyen yüksek düzeyli bir işlem hattı görevi gören bir sınıftır. 

• SignalRChat proje klasöründe bir hub klasörü oluşturun. 

• Hub 'lar klasöründe, aşağıdaki kodla bir ChatHub.es dosyası oluşturun: 

using Microsoft.AspNetCore.SignalR; 
using System.Threading.Tasks; 

namespace SignalRChat.Hubs 
{ 

public elass ChatHub : Hub 
{ 

public async Task SendMessage(string user, string message) 

{ 

await Clients.All.SendAsync("ReceiveMessage"j üşer, message); 

} 

} 


ChatHub sınıfı SignalR Hub sınıfından devralır. Hub sınıfı bağlantıları, grupları ve mesajlaşmayı yönetir. 

sendMessage yöntemi, tüm istemcilere ileti göndermek için bağlı bir istemci tarafından çağrılabilir. Yöntem 
çağıran JavaScript istemci kodu Öğreticinin ilerleyen kısımlarında gösterilmektedir. SignalR kod, en fazla 
ölçeklenebilirlik sağlamak için zaman uyumsuzdur. 

SignalR Yapılandır 

SignalR sunucusu, SignalRSİgnalR istekleri geçirilecek şekilde yapılandırılmalıdır. 

• Aşağıdaki Vurgulanan kodu Startup.es dosyasına ekleyin. 







using Microsoft.AspNetCore.Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.Extensions .Configuration; 

using Microsoft.Extensions.DependencyInjection; 

using SignalRChat.Hubs; 

namespace SignalRChat 

{ 

public class Startup 

{ 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

// This method gets called by the runtime. Use this method to add Services to the Container, 
public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

// This lambda determines whether user consent for non-essential cookies is needed for 

given request. 

options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 


Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_l); 

Services .AddSignaİR(); 

} 

// This method gets called by the runtime. Use this method to configure the EITTP request 
pipeline. 

public void Configure(IApplicationBuilder app, IElostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 
app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 
app.UseCookiePolicy(); 
app.UseSignalR(routes => 

{ 

routes.MapHub<ChatHub>("/chatHub"); 

}); 

app.UseMvc(); 

} 

} 

} 


Bu değişiklikler, ASP.N ET Core bağımlılık ekleme sistemine ve ara yazılım ardışık düzenine SignalR ekler. 


SignalR istemci kodu ekle 



• Pages\ındex.cshtml içindeki içeriği şu kodla değiştirin: 


@page 

<div class="container"> 

<div class="row">&nbsp;</div> 

<div class="row"> 

<div class="col-6">&nbsp;</div> 

<div class="col-6"> 

User.<input type="text" id="userlnput" /> 

<br /> 

Message...cinput type="text" id="messagelnput" /> 

<input type="button" id="sendButton" value="Send Message" /> 
</div> 

</div> 

<div class="row"> 

<div class="col-12"> 

<hr /> 

</div> 

</div> 

<div class="row"> 

<div class="col-6">&nbsp;</div> 

<div class="col-6"> 

<ul id="messagesList"x/ul> 

</div> 

</div> 

</div> 

<script src="~/lib/signalr/dist/browser/signalr.js"x/script> 

<script src="~/js/chat.js"x/script> 


Yukarıdaki kod: 

o Ad ve ileti metni ve Gönder düğmesi için metin kutuları oluşturur. 

o SignalR hub'ından alınan iletileri görüntülemek için id="messagesList" içeren bir liste oluşturur, 
o Bir sonraki adımda oluşturduğunuz SignalR ve sohbet, js uygulama koduna yönelik betik başvurularını 
içerir. 

• Wwwroot/js klasöründe, aşağıdaki kodla bir chat.js dosyası oluşturun: 





"use strict"; 

var connection = new signalR.HubConnectionBuilder().withUrl("/chatHub").build(); 

//Disable send button until connection is established 
document.getElementById("sendButton").disabled = true; 

connection.on("ReceiveMessage"j function (user, message) { 

var msg = message.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"); 
var encodedMsg = user + " says " + msg; 
var li = document.createElement("li"); 
li.textContent = encodedMsg; 

document.getElementByld("messagesList"). appendChild(li); 


connection.start().then(function(){ 

document.getElementById("sendButton").disabled = false; 

}).catch(function (err) { 

return console.error(err.toString()); 

}); 

document.getElementById("sendButton").addEventListener("click", function (event) { 
var user = document.getElementById("userInput").value; 
var message = document.getElementById("messageInput").value; 
connection.invoke("SendMessage", user, message).catch(function (err) { 
return console.error(err.toString()); 

}); 

event.preventDefault(); 


Yukarıdaki kod: 

o Bir bağlantı oluşturur ve başlatır. 

o , Hub 'a ileti gönderen bir işleyiciye Gönder düğmesine ekler. 

o , Hub 'dan iletileri alan ve bunları listeye ekleyen bir işleyici olan bağlantı nesnesine ekler. 

Uygulamayı çalıştırma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Uygulamayı hata ayıklamadan çalıştırmak için CTRL + F5 tuşlarına basın. 

• Adres çubuğundan URL 'yi kopyalayın, başka bir tarayıcı örneği veya sekme açın ve adres çubuğuna URL 'Yİ 
yapıştırın. 

• Tarayıcı' yı seçin, bir ad ve ileti girin ve İleti gönder düğmesini seçin. 

Ad ve ileti anında her iki sayfada da görüntülenir. 



1 

e 

□ X 

| - SignalRChat X 

<- e 

A Secure https://loc... 

: 

SignalRChat 

— 


User.. 

Joe 


Message... 

Hi everyone! 

Send Message 
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TIP 

Uygulama işe yaramazsa, tarayıcı geliştirici araçlarınızı (Fi 2) açın ve konsola gidin. HTML ve JavaScript kodunuzla ilgili hatalarla 
karşılaşabilirsiniz. Örneğin, SignalR.js ' yi yönlendirenden farklı bir klasöre yerleştirdiğinizi varsayalım. Bu durumda, bu dosyaya 
başvuru çalışmaz ve konsolunda 404 hatası görürsünüz. 



Ek kaynaklar 


• Bu öğreticinin YouTube sürümü 




















































TypeScript ve VVebPack ile ASPNET Core SignalR 
kullanma 

26.11.2019 * 34 minutes to read ı Edit Online 


, Sebastien Sougnez ve Scott Ade tarafından 

VVebPack , geliştiricilerin bir VVeb uygulamasının istemci tarafı kaynaklarını paketleyip oluşturmalarına olanak 
sağlar. Bu öğretici, istemcisinin TypeScript'te yazıldığı bir ASP.NET Core SignalR VVeb uygulamasında VVebPack 'in 
kullanımını gösterir. 

Bu öğreticide şunların nasıl yapıldığını öğreneceksiniz: 

• Bir başlatıcı ASP.NET Core SignalR uygulama için yapı iskelesi 

• SignalR TypeScript istemcisini yapılandırma 

• VVebPack kullanarak derleme işlem hattı yapılandırma 

• SignalR sunucusunu yapılandırma 

• istemci ve sunucu arasındaki iletişimi etkinleştir 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Önkoşullar 

• Visual Studio 

• Visual Studio Code 

• ASP.net ve VVeb geliştirme iş yüküyle Visual Studio 2019 

• .NET Core SDK 3,0 veya üzeri 

• NPM ile Node.js 

ASP.NET Core VVeb uygulaması oluşturma 

• Visual Studio 

• Visual Studio Code 

Visual Studio 'Yu, Path ortam değişkeninde NPM için arama yapmak üzere yapılandırın. Varsayılan olarak, Visual 
Studio yükleme dizininde bulunan NPM sürümünü kullanır. Visual Studio 'da şu yönergeleri izleyin: 

1. VVeb Paket Yönetimi > dış web araçları > > > Araçlar ve Seçenekler ' e gidin. 

2. Listeden $ (yol) girişini seçin. Girdiyi listedeki ikinci konuma taşımak için yukarı oka tıklayın. 





Options 


? X 


Search Options (Ctrl+E) fi 

a Projects and Solutions * 

General 
.NET Core 
> ASP.NET Core 
Build and Run 
Locations 
Performance 
VB Defaults 

a Web Package Management 


External Web Tools 


Package Restore 
Web Projects 

> Source Control 

> Work Items 

> Text Editör 
t> Debugging 

> IntelliTrace 


Locations of external tools: 


0000 


0 .\node_modulesV.bin 



0 S(VSINSTALLDIR)\Web\External 

0S(DevEnvDir)\CommonExtensions\Microsoft\TeamFoundation\Team Explorer\Git\ 
0S(DevEnvDir)\CommonExtensions\Microsoft\TeamEoundation\Team Explorer\Git\ 



Reset to Defaults 


The paths listed above will be searched vvhen Visual Studio uses 3rd-party tools such as 
Grunt, Gulp, Bower, or npm. 


OK 


Cancel 


Visual Studio yapılandırması tamamlandı. Projeyi oluşturma zamanı. 

1. Dosya > Yeni > projesi menü seçeneğini kullanın veASP.NET Core Web uygulaması şablonunu seçin. 

2. Projeyi Signalrwebpacko\arak adlandırın ve Oluştur' u seçin. 

3. Hedef çerçeve açılır listesinden .NET Core ' u seçin ve çerçeve Seçicisi açılır listesinden ASP.NET Core 3,0 ' ı 
seçin. Boş şablonu seçin ve Oluştur' u seçin. 

VVebPack ve TypeScript yapılandırma 

Aşağıdaki adımlar, TypeScript 'in JavaScript 'e dönüştürülmesini ve istemci tarafı kaynaklarını paketlemeyi 
yapılandırır. 


1. Bir Package. JSON dosyası oluşturmak için proje kökünde aşağıdaki komutu yürütün: 



"name": "SignalRI/JebPack ", 

"version": "1.0.0", 

"private": true, 

"description": 

"main": "index.js", 

"scripts": { 

"test": "echo Y'Error: no test specified\" && exit 1" 

}, 

"keywords": [], 

"author": 

"license": "ISC" 

} 

private özelliğinin true olarak ayarlanması, sonraki adımda paket yükleme uyarılarını önler. 
3. Gerekli NPM paketlerini yükler.Proje kökünden aşağıdaki komutu yürütün: 































npm install -D -E clean-webpack-plugin@1.0.1 css-loader@2.1.0 html-webpack-plugin@4.0.0-beta.5 mini-css- 
extract-plugin@0.5.0 ts-loader@5.3.3 typescript@3.3.3 webpack@4.29.3 webpack-cli@3.2.3 

Aklınızda bazı komut ayrıntıları: 

• Sürüm numarası, her paket adı için @ işaretini izler. NPM bu özel paket sürümlerini yüklüyor. 

• -e seçeneği, NPM 'nin semantik sürüm aralığı işleçlerini Package. TSOA/öğesine yazmanın varsayılan 
davranışını devre dışı bırakır. Örneğin, "webpack": " A 4.29.3" yerine "webpack": "4.29.3" kullanılır. Bu 
seçenek, daha yeni paket sürümlerine istenmeden yükseltme yapılmasını engeller. 

Daha ayrıntılı bilgi için resmi NPM-Install docs bölümüne bakın. 

4. Package. JSON dosyasının scripts özelliğini aşağıdaki kod parçacığıyla değiştirin: 

"scripts": { 

"build": "webpack --mode=development --watch", 

"release": "webpack --mode=production ", 

"publish": "npm run release && dotnet publish -c Release" 

b 

Betiklerin bazı açıklamaları: 

• build : istemci tarafı kaynaklarınızı geliştirme modunda paketler ve dosya değişikliklerini izler. Dosya 
izleyici, bir proje dosyası her değiştiğinde paketin yeniden oluşturulmasına neden olur, mode seçeneği, 
Tree gerçekleşmesi ve minbirleşme gibi üretim iyileştirmeleri devre dışı bırakır. Yalnızca geliştirmede 

build kullanın. 

• release : istemci tarafı kaynaklarınızı üretim modunda Paketlayın. 

• publish : release betiği, istemci tarafı kaynaklarını üretim modunda paketleyip çalıştırır. Uygulamayı 
yayımlamak için .NET Core CU Publish komutunu çağırır. 

5. Aşağıdaki içeriğe sahip proje kökünde VVebPack. config.jsaâU bir dosya oluşturun: 










const path = require("path"); 

const HtmlI/JebpackPlugin = require("html-webpack-plugin"b 
const CleanWebpackPlugin = require("clean-webpack-plugin"b 
const MiniCssExtractPlugin = require("mini-css-extract-plugin"); 

modüle.exports = { 

entry: "./snc/index.ts", 
output: { 

path: path.resolve(_dirname, "wwwroot"b 

filename: "[name].[chunkhash]. js", 
publicPath: "/" 

b 

resolve: { 

extensions: [".js", ".ts"] 

b 

modüle: { 
rules: [ 

{ 

test: /\.ts$/, 
use: "ts-loader" 

b 

{ 

test: /\.css$/, 

use: [MiniCssExtractPlugin.loader, "css-loaden"] 

} 

] 

b 

plugins: [ 

new CleanWebpackPlugin(["wwwroot /*"]), 
new HtmlWebpackPlugin({ 

template: "./src/index.html" 

}), 

new MiniCssExtractPlugin({ 

filename: "css/[name].[chunkhash].css" 

}) 

] 

}J 


Yukarıdaki dosya Web paketi derlemesini yapılandırır.Aklınızda bazı yapılandırma ayrıntıları: 

• output özelliği, dağ 'ın varsayılan değerini geçersiz kılar. Paket, Wwwroot dizininde yayınlanı 

• resolve.extensions dizisi, SignalR istemci JavaScript 'ı içeri aktarmak için .js içerir. 

6. Proje kökünde yeni bir src dizini oluşturun. Amaç, projenin istemci tarafı varlıklarını depolardır. 

7. Aşağıdaki içerikle src/index.html oluşturun. 

<IDOCTYPE html> 

<html> 

<head> 

<meta charset="utf-8" /> 

<title>ASP.NET Core SignalR</title> 

</head> 

<body> 

<div id="divMessages" class="messages"> 

</div> 

<div class="input-zone"> 

<label id="lblMessage" for="tbMessage">Message:</label> 
cinput id="tbMessage" class="input-zone-lnput" type="text" /> 
cbutton id="btnSend">Send</button> 

</div> 

</body> 

</html> 




Önceki HTML, giriş sayfasının ortak işaretlemesini tanımlar. 

8. Yeni bir src/CSS dizini oluşturun. Amacı, projenin . css dosyalarını depolamadır. 

9. Aşağıdaki içerikle src/CSS/Mairı. css oluşturun: 

*, *::before, *::after { 
box-sizing: border-box; 

} 

html, body { 
margin: 0 ; 
padding: 0 ; 

} 

.input-zone { 

align-items: çenter; 
display: flex; 
flex-direction: row; 
margin: 10px; 

} 

.input-zone-input { 
flex: 1 ; 

margin-right: 10px; 

} 

.message-author { 

font-weight: bold; 

} 

.messages { 

border: lpx solid # 000 ; 
margin: 10px; 
max-height: S00px; 
min-height: S00px; 
overflow-y: auto; 
padding: 5px; 

} 

Önceki Mairı. css dosyası uygulamayı stiller. 

10. Şu içerikle src/tsconfig. JSON oluşturun: 

{ 

"compilerOptions": { 

"target": "es5" 

} 

} 


Yukarıdaki kod, TypeScript derleyicisini ECMAScript 5 uyumlu JavaScript üretecek şekilde yapılandırır. 


11. Aşağıdaki içeriğe sahip src/index. TS oluşturun: 




import "./css/main.css"; 

const divMessages: HTMLDivElement = document.querySelector("#divMessages"); 
const tbMessage: HTMLInputElement = document.querySelector("#tbMessage"); 
const btnSend: HTMLButtonElement = document.querySelector("#btnSend"); 
const username = new DateQ .getTime(); 

tbMessage.addEventListener("keyup" J (e: KeyboardEvent) => { 
if (e.keyCode === 13) { 
send(); 

} 

}); 

btnSend.addEventListener("click ", send); 

function send() { 

} 

Önceki TypeScript, DOM öğelerine başvurulan alır ve iki olay işleyicisini ekler: 


keyup 

: Bu olay Kullanıcı metin kutusuna 

tbMessage olarak tanımlanan bir şeyi yazdığında ateşlenir. 

send 


işlevi, Kullanıcı ENTER tuşuna bastığında çağrılır. 

• cück : Kullanıcı Gönder düğmesine tıkladığında bu olay ateşlenir, send işlevi çağırılır. 

ASP.NET Core uygulamasını yapılandırma 

1. stantup.configune yönteminde, Usedefaultfiles ve usestaticfilesöğesine çağrılar ekleyin. 

app.UseRouting(); 
app.UseDefaultFileş(); 
app.UseStatic Fileş 


Yukarıdaki kod, kullanıcının tam URL 'sini veya Web uygulamasının kök URL 'sini girmeksizin Dizin, html 
dosyasını bulmasını ve sunmasını sağlar. 

2. startup.configure yönteminin sonunda, bir /hub yolunu chatHub hub'ına eşleyin. Merhaba Dünya 
görüntülenen kodu değiştirin / Aşağıdaki satırla: 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapHub<ChatHub>("/hub"); 

}); 

3. startup.configureServices yönteminde Addsignalröğesini çağırın. SignalR hizmetlerini projenize ekler. 

Services.AddSignalR(); 


4. Proje kökünde hub olarak adlandırılan yeni bir dizin oluşturun. Amacı, bir sonraki adımda oluşturulan 
SignalR hub 'ını deposağlamaktır. 

5. Aşağıdaki kodla hub hub 'ları/ChatHub. cs oluşturun: 










using Microsoft.AspNetCore.SignalR; 
using System.Threading.Tasks; 

namespace SignalRWebPack.Hubs 
{ 

public class ChatHub : Hub 
{ 

} 

} 


6. ChatHub başvurusunu çözümlemek için, Startup.es dosyasının en üstüne aşağıdaki kodu ekleyin: 

using SignalRWebPack.Hubs; 


İstemci ve sunucu iletişimini etkinleştir 

Uygulama Şu anda ileti göndermek için basit bir form görüntülüyor.Bunu yapmayı denediğinizde hiçbir şey olmaz. 
Sunucu belirli bir yolu dinliyor, ancak gönderilen iletilerle hiçbir şey yapmıyor. 

1. Proje kökünde aşağıdaki komutu yürütün: 

npm install @microsoft/signalr 

Yukarıdaki komut, istemcinin sunucuya ileti göndermesini sağlayan SignalR TypeScript istemcisiniyüklüyor. 

2. Vurgulanan kodu src/index. TS dosyasına ekleyin: 





import "./css/main.css"; 

import * as signalR from "@microsoft/signalr"; 

const divMessages: HTMLDivElement = document.querySelector("#divMessages"); 
const tbMessage: HTMLInputElement = document.querySelector("#tbMessage"); 
const btnSend: HTMLButtonElement = document.querySelector("#btnSend"); 
const usenname = new Date().getTime(); 

const connection = new signalR.HubConnectionBuilden() 

,withUrl("/hub") 

,build(); 

connection.on("messageReceived", (username: string, message: stning) => { 
let m = document.createElement("div"); 

m.innerHTML = 

' <div ela ss="message-aut hor ">${usenname}</di vxdiv>${message}</div>'; 
divMessages.appendChild(m); 

divMessages.scrollTop = divMessages.scrollHeight; 

}); 

connection.start().catch(err => document.write(err)); 

tbMessage.addEventListener("keyup"j (e: KeyboardEvent) => { 
if (e.keyCode === 13) { 
send(); 

} 

}); 

btnSend.addEventListener("click", send); 

funetion send() { 

} 

Yukarıdaki kod, sunucudan ileti almayı destekler. HubConnectionBuiider sınıfı, sunucu bağlantısını 
yapılandırmak için yeni bir Oluşturucu oluşturur. withuri işlevi hub URL 'sini yapılandırır. 

SignalR, istemci ile sunucu arasında ileti alışverişi yapılmasını mümkün. Her ileti belirli bir ada sahiptir. 
Örneğin, ileti bölgesindeki yeni iletiyi görüntülemekten sorumlu mantığı çalıştıran messageRecelved adına 
sahip iletilere sahip olabilirsiniz. Belirli bir iletiyi dinlemek on işlevi aracılığıyla yapılabilir. Herhangi bir 
sayıda ileti adını dinleyebilmeniz gerekir. Ayrıca, yazarın adı ve alınan iletinin içeriği gibi parametreleri iletiye 
geçirmek da mümkündür, istemci bir ileti aldıktan sonra yazarın adı ve innerHTML özniteliğinde ileti içeriğiyle 
yeni bir div öğesi oluşturulur. Bu, iletileri görüntüleyen ana div öğesine eklenir. 

3. Artık istemci bir ileti aldığına göre, ileti gönderecek şekilde yapılandırın. Vurgulanan kodu src/index. TS 
dosyasına ekleyin: 









import "./css/main.css"; 

import * as signalR fnom "@aspnet/signalr"; 


const divMessages: HTMLDivElement = document.querySelector("#divMessages"); 
const tbMessage: HTMLInputElement = document.querySelector("#tbMessage"); 
const btnSend: HTMLButtonElement = document.querySelector("#btnSend"); 
const usenname = new Date().getTime(); 

const connection = new signalR.HubConnectionBuilden() 

.withllrl("/hub") 

.build(); 

connection.on("messageReceived", (usenname: string, message: stning) => { 
let messageContainen = document.createElement("div"); 

messageContainer.innerHTML = 

' <div ela ss="message-aut hor ">${ usenname }</divxdiv>${message}</div>'; 

divMessages.appendChiİd(messageContainer); 
divMessages.scrollTop = divMessages.scrollHeight; 

}); 

connection.start().catch(err => document.wnite(enr)); 

tbMessage.addEventl_istener("keyup", (e: KeyboandEvent) => { 
if (e.keyCode === 13) { 
send(); 

} 

}); 

btnSend.addEventListener("click ", send); 


funetion send() { 

connection.send("newMessage", username^ tbMessage.value) 
,then(() => tbMessage.value = 


} 


VVebSockets bağlantısı aracılığıyla bir ileti gönderildiğinde send yönteminin çağrılması gerekir. Yöntemin 
parametresi ileti adıdır, ileti verileri diğer parametreleri geçersiz kılar. Bu örnekte, newMessage sunucusuna 
gönderildiği gibi bir ileti gönderilir, ileti, bir metin kutusundan Kullanıcı adından ve Kullanıcı girişinden 
oluşur. Gönderme işlemi çalışırsa metin kutusu değeri temizlenir. 

4. Vurgulanan yöntemi chatHub sınıfına ekleyin: 

using Microsoft.AspNetCore.SignalR; 
using System.Threading.Tasks; 

namespace SignalRI/JebPack.Hubs 

{ 

public elass ChatHub : Hub 

{ 

public async Task NewMessage(long username, string message) 

{ 

await Clients.All.SendAsyncC'messageReceived", username, message); 

} 

} 

} 


Yukarıdaki kod, sunucu onları aldıktan sonra tüm bağlı kullanıcılara ileti almış iletileri yayınlar.Tüm iletileri 
almak için genel bir on yöntemi olması gereksizdir, ileti adından sonra adlandırılmış bir yöntem. 

Bu örnekte, TypeScript istemcisi newMessage olarak tanımlanan bir ileti gönderir. C# NewMessage yöntemi, 
istemci tarafından gönderilen verileri bekler. İstemcilerdeki sendadsync yöntemine bir çağrı yapılır. Alınan 









iletiler, hub 'a bağlı tüm istemcilere gönderilir. 


Uygulamayı test etme 

Uygulamanın aşağıdaki adımlarla çalıştığından emin olun. 

• Visual Studio 

• Visual Studio Code 

1. Web paketini yayın modunda çalıştırın. Paket Yöneticisi konsol penceresini kullanarak, proje kökünde 
aşağıdaki komutu yürütün. Proje kökünde değilseniz, komutu girmeden önce cd signaiRUebPack girin. 

npm run release 

Bu komut, uygulamayı çalıştırırken alınacağı istemci-tarafı varlıkları verir. Varlıkları yerleştirilir wwwroot 
klasör. 

Web, aşağıdaki görevleri tamamlandı: 

• içeriğini temizleneceği wwwroof dizin. 

• JavaScript için TypeScript dönüştürülen—olarak da bilinen bir işlem transpilation. 

• Dosya boyutunu küçültmek için oluşturulan JavaScript karıştırılmış—olarak da bilinen bir işlem küçültme. 

• işlenen JavaScript, CSS ve HTML dosyalarından kopyalanan src için wwwroot dizin. 

• Aşağıdaki öğeleri içine eklenen wwwrootAndex.html dosyası: 

o A <iink> başvuran etiketi wwwroot/maln.< karma>.css dosya. Bu etiket kapatılmadan hemen 
önce yerleştirilir </head> etiketi. 

o A <script> küçültülmüş başvuran etiketi wwwroot/mairı.< karma>.js dosya. Bu etiket 
kapatılmadan hemen önce yerleştirilir </body> etiketi. 

2. Hata ayıklayıcıyı eklemeden uygulamayı bir tarayıcıda başlatmak **için hata ayıklama > ** Başlat 1 ı seçin. 
Wwwroot/index.html dosyası http://iocaihost:<port_number> olarak sunulur. 

Derleme hataları alırsanız, çözümü kapatıp yeniden açmayı deneyin. 

3. Başka bir tarayıcı örneği (herhangi bir tarayıcı) açın. URL 'Yİ adres çubuğuna yapıştırın. 

4. Tarayıcı seçin, ileti metin kutusuna bir şey yazın ve Gönder düğmesine tıklayın. Benzersiz Kullanıcı adı ve 
ileti anında her iki sayfada da görüntülenir. 












ASP.NET Core S X + 

O (T) localhost 55183/ 


X 


1530222080931 
Hello \vorld! 


Message: 


H ASP.NET Core S X + 

O © localhost: 5 5183/ 


X 


1530222080931 

Hello \vorld! 



Send 


Message: 



Send 


• Visual Studio 

• Visual Studio Code 


• ASP.net ve Web geliştirme iş yüküyle Visual Studio 2019 

• .NET Core SDK 2,2 veya üzeri 

• NPM ile Node.js 


ASP.NET Core Web uygulaması oluşturma 

• Visual Studio 

• Visual Studio Code 

Visual Studio 'Yu, Patlı ortam değişkeninde NPM için arama yapmak üzere yapılandırın. Varsayılan olarak, Visual 
Studio yükleme dizininde bulunan NPM sürümünü kullanır. Visual Studio 'da şu yönergeleri izleyin: 

1. Web Paket Yönetimi > dış web araçları > > > Araçlar ve Seçenekler 1 e gidin. 

2. Listeden $ (yol) girişini seçin. Girdiyi listedeki ikinci konuma taşımak için yukarı oka tıklayın. 










































Options 


? X 


Search Options (Ctrl+E) fi 

a Projects and Solutions * 

General 
.NET Core 
> ASP.NET Core 
Build and Run 
Locations 
Performance 
VB Defaults 

a Web Package Management 


External Web Tools 


Package Restore 
Web Projects 

> Source Control 

> Work Items 

> Text Editör 
t> Debugging 

> IntelliTrace 


Locations of external tools: 


0000 


0 .\node_modulesV.bin 



0 S(VSINSTALLDIR)\Web\External 

0S(DevEnvDir)\CommonExtensions\Microsoft\TeamFoundation\Team Explorer\Git\ 
0S(DevEnvDir)\CommonExtensions\Microsoft\TeamEoundation\Team Explorer\Git\ 



Reset to Defaults 


The paths listed above will be searched vvhen Visual Studio uses 3rd-party tools such as 
Grunt, Gulp, Bower, or npm. 


OK 


Cancel 


Visual Studio yapılandırması tamamlandı. Projeyi oluşturma zamanı. 

1. Dosya > Yeni > projesi menü seçeneğini kullanın veASP.NET Core Web uygulaması şablonunu seçin. 

2. Projeyi Signalrwebpacko\arak adlandırın ve Oluştur' u seçin. 

3. Hedef çerçeve açılır listesinden .NET Core ' u seçin ve çerçeve Seçicisi açılır listesinden ASP.NET Core 2,2 ' ı 
seçin. Boş şablonu seçin ve Oluştur' u seçin. 

VVebPack ve TypeScript yapılandırma 

Aşağıdaki adımlar, TypeScript 'in JavaScript 'e dönüştürülmesini ve istemci tarafı kaynaklarını paketlemeyi 
yapılandırır. 


1. Bir Package. JSON dosyası oluşturmak için proje kökünde aşağıdaki komutu yürütün: 



"name": "SignalRI/JebPack ", 

"version": "1.0.0", 

"private": true, 

"description": 

"main": "index.js", 

"scripts": { 

"test": "echo Y'Error: no test specified\" && exit 1" 

}, 

"keywords": [], 

"author": 

"license": "ISC" 

} 

private özelliğinin true olarak ayarlanması, sonraki adımda paket yükleme uyarılarını önler. 
3. Gerekli NPM paketlerini yükler.Proje kökünden aşağıdaki komutu yürütün: 































npm install -D -E clean-webpack-plugin@1.0.1 css-loader@2.1.0 html-webpack-plugin@4.0.0-beta.5 mini-css- 
extract-plugin@0.5.0 ts-loader@5.3.3 typescript@3.3.3 webpack@4.29.3 webpack-cli@3.2.3 

Aklınızda bazı komut ayrıntıları: 

• Sürüm numarası, her paket adı için @ işaretini izler. NPM bu özel paket sürümlerini yüklüyor. 

• -e seçeneği, NPM 'nin semantik sürüm aralığı işleçlerini Package. TSOA/öğesine yazmanın varsayılan 
davranışını devre dışı bırakır. Örneğin, "webpack": " A 4.29.3" yerine "webpack": "4.29.3" kullanılır. Bu 
seçenek, daha yeni paket sürümlerine istenmeden yükseltme yapılmasını engeller. 

Daha ayrıntılı bilgi için resmi NPM-Install docs bölümüne bakın. 

4. Package. JSON dosyasının scripts özelliğini aşağıdaki kod parçacığıyla değiştirin: 

"scripts": { 

"build": "webpack --mode=development --watch", 

"release": "webpack --mode=production ", 

"publish": "npm run release && dotnet publish -c Release" 

b 

Betiklerin bazı açıklamaları: 

• build : istemci tarafı kaynaklarınızı geliştirme modunda paketler ve dosya değişikliklerini izler. Dosya 
izleyici, bir proje dosyası her değiştiğinde paketin yeniden oluşturulmasına neden olur, mode seçeneği, 
Tree gerçekleşmesi ve minbirleşme gibi üretim iyileştirmeleri devre dışı bırakır. Yalnızca geliştirmede 

build kullanın. 

• release : istemci tarafı kaynaklarınızı üretim modunda Paketlayın. 

• publish : release betiği, istemci tarafı kaynaklarını üretim modunda paketleyip çalıştırır. Uygulamayı 
yayımlamak için .NET Core CU Publish komutunu çağırır. 

5. Aşağıdaki içeriğe sahip proje kökünde VVebPack. config.jsaâU bir dosya oluşturun: 










const path = require("path"); 

const HtmlI/JebpackPlugin = require("html-webpack-plugin"b 
const CleanWebpackPlugin = require("clean-webpack-plugin"b 
const MiniCssExtractPlugin = require("mini-css-extract-plugin"); 

modüle.exports = { 

entry: "./snc/index.ts", 
output: { 

path: path.resolve(_dirname, "wwwroot"b 

filename: "[name].[chunkhash]. js", 
publicPath: "/" 

b 

resolve: { 

extensions: [".js", ".ts"] 

b 

modüle: { 
rules: [ 

{ 

test: /\.ts$/, 
use: "ts-loader" 

b 

{ 

test: /\.css$/, 

use: [MiniCssExtractPlugin.loader, "css-loaden"] 

} 

] 

b 

plugins: [ 

new CleanWebpackPlugin(["wwwroot /*"]), 
new HtmlWebpackPlugin({ 

template: "./src/index.html" 

}), 

new MiniCssExtractPlugin({ 

filename: "css/[name].[chunkhash].css" 

}) 

] 

}J 


Yukarıdaki dosya Web paketi derlemesini yapılandırır.Aklınızda bazı yapılandırma ayrıntıları: 

• output özelliği, dağ 'ın varsayılan değerini geçersiz kılar. Paket, Wwwroot dizininde yayınlanı 

• resolve.extensions dizisi, SignalR istemci JavaScript 'ı içeri aktarmak için .js içerir. 

6. Proje kökünde yeni bir src dizini oluşturun. Amaç, projenin istemci tarafı varlıklarını depolardır. 

7. Aşağıdaki içerikle src/index.html oluşturun. 

<IDOCTYPE html> 

<html> 

<head> 

<meta charset="utf-8" /> 

<title>ASP.NET Core SignalR</title> 

</head> 

<body> 

<div id="divMessages" class="messages"> 

</div> 

<div class="input-zone"> 

<label id="lblMessage" for="tbMessage">Message:</label> 
cinput id="tbMessage" class="input-zone-lnput" type="text" /> 
cbutton id="btnSend">Send</button> 

</div> 

</body> 

</html> 




Önceki HTML, giriş sayfasının ortak işaretlemesini tanımlar. 

8. Yeni bir src/CSS dizini oluşturun. Amacı, projenin . css dosyalarını depolamadır. 

9. Aşağıdaki içerikle src/CSS/Mairı. css oluşturun: 

*, *::before, *::after { 
box-sizing: border-box; 

} 

html, body { 
margin: 0 ; 
padding: 0 ; 

} 

.input-zone { 

align-items: çenter; 
display: flex; 
flex-direction: row; 
margin: 10px; 

} 

.input-zone-input { 
flex: 1 ; 

margin-right: 10px; 

} 

.message-author { 

font-weight: bold; 

} 

.messages { 

border: lpx solid # 000 ; 
margin: 10px; 
max-height: S00px; 
min-height: S00px; 
overflow-y: auto; 
padding: 5px; 

} 

Önceki Mairı. css dosyası uygulamayı stiller. 

10. Şu içerikle src/tsconfig. JSON oluşturun: 

{ 

"compilerOptions": { 

"target": "es5" 

} 

} 


Yukarıdaki kod, TypeScript derleyicisini ECMAScript 5 uyumlu JavaScript üretecek şekilde yapılandırır. 


11. Aşağıdaki içeriğe sahip src/index. TS oluşturun: 




import "./css/main.css"; 

const divMessages: HTMLDivElement = document.querySelector("#divMessages"); 
const tbMessage: HTMLInputElement = document.querySelector("#tbMessage"); 
const btnSend: HTMLButtonElement = document.querySelector("#btnSend"); 
const username = new Date().getTime(); 

tbMessage.addEventListener("keyup" J (e: KeyboardEvent) => { 
if (e.keyCode === 13) { 
send(); 

} 

}); 

btnSend.addEventListener("click ", send); 

function send() { 

} 

Önceki TypeScript, DOM öğelerine başvurulan alır ve iki olay işleyicisini ekler: 


keyup 

: Bu olay Kullanıcı metin kutusuna 

tbMessage olarak tanımlanan bir şeyi yazdığında ateşlenir. 

send 


işlevi, Kullanıcı ENTER tuşuna bastığında çağrılır. 

• cück : Kullanıcı Gönder düğmesine tıkladığında bu olay ateşlenir, send işlevi çağırılır. 

ASP.NET Core uygulamasını yapılandırma 

1. stantup. conf igune yönteminde belirtilen kod Merhaba Dünya! görüntülüyor. app.Run yöntemi çağrısını, 
Usedefaultfiles ve usestaticfilesçağrı larıyla değiştirin. 

app.UseDefaultFileş(); 
app.UseStatic Fileş 


Yukarıdaki kod, kullanıcının tam URL 'sini veya Web uygulamasının kök URL 'sini girmeksizin Dizin, html 
dosyasını bulmasını ve sunmasını sağlar. 

2. startup.configureServices yönteminde Addsignalr öğesini çağırın. SignalR hizmetlerini projenize ekler. 

Services.AddSignalR(); 

3. Q\r/hub yolunu chatHub hub ’ına eşleyin, startup.configure yönteminin sonuna aşağıdaki satırları ekleyin: 

app.UseSignalR(options => 

{ 

options.MapHub<ChatHub>("/hub"); 

}); 

4. Proje kökünde /ruöolarak adlandırılan yeni bir dizin oluşturun. Amacı, bir sonraki adımda oluşturulan 
SignalR hub 'ını deposağlamaktır. 

5. Aşağıdaki kodla hub hub 'ları/ChatHub. cs oluşturun: 













using Microsoft.AspNetCore.SignalR; 
using System.Threading.Tasks; 

namespace SignalRWebPack.Hubs 
{ 

public class ChatHub : Hub 
{ 

} 

} 


6. ChatHub başvurusunu çözümlemek için, Startup.es dosyasının en üstüne aşağıdaki kodu ekleyin: 

using SignalRWebPack.Hubs; 


İstemci ve sunucu iletişimini etkinleştir 

Uygulama Şu anda ileti göndermek için basit bir form görüntülüyor.Bunu yapmayı denediğinizde hiçbir şey olmaz. 
Sunucu belirli bir yolu dinliyor, ancak gönderilen iletilerle hiçbir şey yapmıyor. 

1. Proje kökünde aşağıdaki komutu yürütün: 

npm install @microsoft/signalr 

Yukarıdaki komut, istemcinin sunucuya ileti göndermesini sağlayan SignalR TypeScript istemcisiniyüklüyor. 

2. Vurgulanan kodu src/index. TS dosyasına ekleyin: 





import "./css/main.css"; 

import * as signalR from "@aspnet/signalr"; 

const divMessages: HTMLDivElement = document.querySelector("#divMessages"); 
const tbMessage: HTMLInputElement = document.querySelector("#tbMessage"); 
const btnSend: HTMLButtonElement = document.querySelector("#btnSend"); 
const usenname = new Date().getTime(); 

const connection = new signalR.HubConnectionBuilden() 

,withUrl("/hub") 

,build(); 

connection.on("messageReceived", (username: string, message: stning) => { 
let m = document.createElement("div"); 

m.innerHTML = 

' <div ela ss="message-aut hor ">${usenname}</di vxdiv>${message}</div>'; 
divMessages.appendChild(m); 

divMessages.scrollTop = divMessages.scrollHeight; 

}); 

connection.start().catch(err => document.write(err)); 

tbMessage.addEventListener("keyup"j (e: KeyboardEvent) => { 
if (e.keyCode === 13) { 
send(); 

} 

}); 

btnSend.addEventListener("click", send); 

funetion send() { 

} 

Yukarıdaki kod, sunucudan ileti almayı destekler. HubConnectionBuiider sınıfı, sunucu bağlantısını 
yapılandırmak için yeni bir Oluşturucu oluşturur. withuri işlevi hub URL 'sini yapılandırır. 

SignalR, istemci ile sunucu arasında ileti alışverişi yapılmasını mümkün. Her ileti belirli bir ada sahiptir. 
Örneğin, ileti bölgesindeki yeni iletiyi görüntülemekten sorumlu mantığı çalıştıran messageRecelved adına 
sahip iletilere sahip olabilirsiniz. Belirli bir iletiyi dinlemek on işlevi aracılığıyla yapılabilir. Herhangi bir 
sayıda ileti adını dinleyebilmeniz gerekir. Ayrıca, yazarın adı ve alınan iletinin içeriği gibi parametreleri iletiye 
geçirmek da mümkündür, istemci bir ileti aldıktan sonra yazarın adı ve innerHTML özniteliğinde ileti içeriğiyle 
yeni bir div öğesi oluşturulur. Bu, iletileri görüntüleyen ana div öğesine eklenir. 

3. Artık istemci bir ileti aldığına göre, ileti gönderecek şekilde yapılandırın. Vurgulanan kodu src/index. TS 
dosyasına ekleyin: 









import "./css/main.css"; 

import * as signalR fnom "@aspnet/signalr"; 


const divMessages: HTMLDivElement = document.querySelector("#divMessages"); 
const tbMessage: HTMLInputElement = document.querySelector("#tbMessage"); 
const btnSend: HTMLButtonElement = document.querySelector("#btnSend"); 
const usenname = new Date().getTime(); 

const connection = new signalR.HubConnectionBuilden() 

.withllrl("/hub") 

.build(); 

connection.on("messageReceived", (usenname: string, message: stning) => { 
let messageContainen = document.createElement("div"); 

messageContainer.innerHTML = 

' <div ela ss="message-aut hor ">${ usenname }</divxdiv>${message}</div>'; 

divMessages.appendChiİd(messageContainer); 
divMessages.scrollTop = divMessages.scrollHeight; 

}); 

connection.start().catch(err => document.wnite(enr)); 

tbMessage.addEventl_istener("keyup", (e: KeyboandEvent) => { 
if (e.keyCode === 13) { 
send(); 

} 

}); 

btnSend.addEventListener("click ", send); 


funetion send() { 

connection.send("newMessage", username^ tbMessage.value) 
,then(() => tbMessage.value = 


} 


VVebSockets bağlantısı aracılığıyla bir ileti gönderildiğinde send yönteminin çağrılması gerekir. Yöntemin 
parametresi ileti adıdır, ileti verileri diğer parametreleri geçersiz kılar. Bu örnekte, newMessage sunucusuna 
gönderildiği gibi bir ileti gönderilir, ileti, bir metin kutusundan Kullanıcı adından ve Kullanıcı girişinden 
oluşur. Gönderme işlemi çalışırsa metin kutusu değeri temizlenir. 

4. Vurgulanan yöntemi chatHub sınıfına ekleyin: 

using Microsoft.AspNetCore.SignalR; 
using System.Threading.Tasks; 

namespace SignalRI/JebPack.Hubs 

{ 

public elass ChatHub : Hub 

{ 

public async Task NewMessage(long username, string message) 

{ 

await Clients.All.SendAsyncC'messageReceived", username, message); 

} 

} 

} 


Yukarıdaki kod, sunucu onları aldıktan sonra tüm bağlı kullanıcılara ileti almış iletileri yayınlar.Tüm iletileri 
almak için genel bir on yöntemi olması gereksizdir, ileti adından sonra adlandırılmış bir yöntem. 

Bu örnekte, TypeScript istemcisi newMessage olarak tanımlanan bir ileti gönderir. C# NewMessage yöntemi, 
istemci tarafından gönderilen verileri bekler. İstemcilerdeki sendadsync yöntemine bir çağrı yapılır. Alınan 









iletiler, hub 'a bağlı tüm istemcilere gönderilir. 


Uygulamayı test etme 

Uygulamanın aşağıdaki adımlarla çalıştığından emin olun. 

• Visual Studio 

• Visual Studio Code 

1. Web paketini yayın modunda çalıştırın. Paket Yöneticisi konsol penceresini kullanarak, proje kökünde 
aşağıdaki komutu yürütün. Proje kökünde değilseniz, komutu girmeden önce cd signaiRUebPack girin. 

npm run release 


Bu komut, uygulamayı çalıştırırken alınacağı istemci-tarafı varlıkları verir. Varlıkları yerleştirilir wwwroot 
klasör. 


Web, aşağıdaki görevleri tamamlandı: 


• içeriğini temizleneceği wwwroof dizin. 

• JavaScript için TypeScript dönüştürülen—olarak da bilinen bir işlem transpilation. 

• Dosya boyutunu küçültmek için oluşturulan JavaScript karıştırılmış—olarak da bilinen bir işlem küçültme. 

• işlenen JavaScript, CSS ve HTML dosyalarından kopyalanan src için wwwroot dizin. 

• Aşağıdaki öğeleri içine eklenen wwwrootAndex.html dosyası: 

o A <iink> başvuran etiketi wwwroot/maln.< karma>.css dosya. Bu etiket kapatılmadan hemen 
önce yerleştirilir </head> etiketi. 

o A <script> küçültülmüş başvuran etiketi wwwroot/main.< karma>.js dosya. Bu etiket 
kapatılmadan hemen önce yerleştirilir </body> etiketi. 

2. Hata ayıklayıcıyı eklemeden uygulamayı bir tarayıcıda başlatmak **için hata ayıklama > ** Başlat 1 ı seçin. 
Wwwroot/index.html dosyası http://iocaihost:<port_number> olarak sunulur. 


3. Başka bir tarayıcı örneği (herhangi bir tarayıcı) açın. URL 'Yİ adres çubuğuna yapıştırın. 

4. Tarayıcı seçin, ileti metin kutusuna bir şey yazın ve Gönder düğmesine tıklayın. Benzersiz Kullanıcı adı ve 
ileti anında her iki sayfada da görüntülenir. 


ASP.NET Core 5 X 
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O localhost:55183/ 
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O localhost:55183/ 


Send 
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Ek kaynaklar 

• ASP.NET Core SignalR JavaScript istemcisi 

• ASP.NET Core SignalR hub ’ları kullanma 


Öğretici: ASRNET Core bir gRPC istemcisi ve 
sunucusu oluşturma 

6.12.2019 • 15 minutes to read ı Edit Online 


John Luo tarafından 

Bu öğreticide, bir .NET Core GRPC istemcisinin ve bir ASP.NET Core GRPC sunucusunun nasıl oluşturulacağı 
gösterilmektedir. 

Sonda, gRPC Greeter hizmeti ile iletişim kuran bir gRPC istemcisine sahip olacaksınız. 

Örnek kodu görüntüleyin veya indirin (nasıl indirilir). 

Bu öğreticide şunları yaptınız: 

• GRPC sunucusu oluşturun. 

• GRPC istemcisi oluşturun. 

• GRPC istemci hizmetini gRPC Greeter hizmeti ile test edin. 

Prerequisites 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• ASP.net ve Web geliştirme iş yüküyle Visual Studio 2019 

• NET Core 3,0 SDK veya üzeri 

GRPC hizmeti oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Visual Studio 'Yu başlatın ve Yeni proje oluştur 1 u seçin. Alternatif olarak, Visual Studio Dosya 
menüsünden Yeni > projesi 1 ni seçin. 

• Yeni proje oluştur İletişim kutusunda GRPC hizmeti 1 ni seçin ve İleri' yi seçin: 


Create a new project 

Recent project templates 


<"”* gRPC Service C# 

51 Blank Solution 


ffiEB x - 


Ali Languages ▼ Ali Platforms - Ali Project lypes 

gRPC gRPC Service 

A project template for creating a gRPC ASP.NET Core service using .NET Core. 

C# Linux macOS Windows Cloud Service Web 


• Projeyi Grpcgreeterolarak adlandırın. Kodu kopyalayıp yapıştırdığınızda ad alanlarının eşleşmesi için, proje 
Grpcgreeter adında bir ad vermek önemlidir. 






• Seçin oluşturma. 


• Yeni bir gRPC hizmeti oluştur iletişim kutusunda: 

o GRPC hizmeti şablonu seçilidir, 
o Seçin oluşturma. 

Hizmeti çalıştırma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 


• Hata ayıklayıcı olmadan çalıştırmak için CTRL + F5 tuşlarına basın. 
Visual Studio aşağıdaki iletişim kutusunu görüntüler: 


Microsoft Visual Studio 


X 


O Thıs project ıs confıgured to use SSL To avoid SSL vvamıngs ın the browser you 
can choose to trust the self-sıgned certıficate that IIS Express has generated. 


Would you like to trust the IIS Express SSL certificate? 

LeâüLMfilfi 


İVİ Don't ask me again 


Yes 


No 


IIS Express SSL sertifikasına güveniyorsanız Evet ' i seçin. 
Aşağıdaki iletişim kutusu görüntülenir: 


Security VVarning 



You are about to install a certificate from a certification 
authority (CA) daiming to represent 


localhost 


Windows cannot validate that the certificate is actually from 
'localhost'. You should confirm its origin by contacting 
localhost'. The following number will assist you in this 
process: 

Thumbprint (shal): 35MFB1F 70EC5F89 C7180FBD 61AFE491 
94580874 


VVarning: 

If you install this root certificate, VVindovvs will automatically 
trust any certificate issued by this CA. Installing a certificate 
with an unconfirmed thumbprint is a security risk. If you dick 
'Yes' you acknovvledge this risk. 

Do you want to install this certificate? 


Yes 



Geliştirme sertifikasına güvenmeyi kabul ediyorsanız Evet 1 i seçin. 

Visual Studio IIS Express başlar ve uygulamayı çalıştırır. Adres çubuğunda localhost:port# ve exampie.com 
gibi bir şey görüntülenir. Bunun nedeni, localhost yerel bilgisayar için Standart ana bilgisayar adıdır. 
Localhost yalnızca yerel bilgisayardan Web isteklerine hizmet verir. Visual Studio bir Web projesi 
oluşturduğunda, Web sunucusu için rastgele bir bağlantı noktası kullanılır. 

Günlükler, https://iocaihost: 500 i üzerinde dinleme hizmetini gösterir. 



















info: Microsoft.Hoşting.Lifetime[0] 

Now listening on: https://localhost:5001 
info: Microsoft.Hoşting.Lifetime[0] 

Application started. Press Ctrl+C to shut down. 
info: Microsoft.Hoşting.Lifetime[0] 

Hosting environment: Development 


NOTE 

GRPC şablonu, Aktarım Katmanı Güvenliği (TLS)kullanmak üzere yapılandırılmıştır. gRPC istemcilerinin, sunucuyu çağırmak için 
HTTPS kullanması gerekir. 

macOS, TLS ile ASP.NET Core gRPC 'yi desteklemez. MacOS 'ta gRPC hizmetlerini başarıyla çalıştırmak için ek yapılandırma 
gerekir. Daha fazla bilgi için bkz. macOS üzerinde gRPC uygulaması ASP.NET Core başlatılamıyor. 


Proje dosyalarını inceleyin 

Grpcgreeter proje dosyalan: 

• Greet. proto -prototips/Greet. proto dosyası Greeter GRPC'Yi tanımlar ve GRPC sunucu varlıklarını 
oluşturmak için kullanılır. Daha fazla bilgi için bkz. gRPC 'ye giriş. 

• Hizmetler klasörü: Greeter hizmetinin uygulamasını içerir. 

• appSettings.jsorı Kestrel tarafından kullanılan protokol gibi yapılandırma verilerini içerir. Daha fazla bilgi için 
bkz.ASP.NET Core yapılandırma. 

• Program.es-, GRPC hizmetinin giriş noktasını içerir.Daha fazla bilgi için bkz. .NET genel ana bilgisayar. 

• Startup.es - uygulama davranışını yapılandıran kodu içerir. Daha fazla bilgi için bkz. uygulama başlatma. 

Bir .NET konsol uygulamasında gRPC istemcisini oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Visual Studio 'nun ikinci bir örneğini açın ve Yeni proje oluştur' u seçin. 

• Yeni proje oluştur İletişim kutusunda konsol uygulaması (.NET Core) öğesini seçin ve İleri' yi seçin. 

• Ad metin kutusuna Grpcgreeterclient girin ve Oluştur' u seçin. 

Gerekli paketleri Ekle 

GRPC istemci projesi aşağıdaki paketleri gerektirir: 

• .N ET Core istemcisini içeren GRPC .net. Client. 

• için C#prototipsiz İleti API 'Leri içeren Google. protoarabellek. 

• Prototipleme dosyaları için araç desteğini C# İçeren GRPC. Tools. Araç, çalışma zamanında gerekli değildir, bu 
nedenle bağımlılık PrivateAssets="AH" olarak işaretlenir. 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Paket Yöneticisi Konsolu (PMC) veya NuGet Paketlerini Yönet' i kullanarak paketleri yükler. 

Paket yüklemek için PMC seçeneği 

• Visual Studio da araçlar > NuGet Paket Yöneticisi > Paket Yöneticisi konsolu ' nu seçin. 

• Paket Yöneticisi konsol penceresinde, Grpcgreeterclient. esproj dosyalarını içeren klasöre Dizin 






değiştirmek için cd GrpcGreeterciient çalıştırın. 

• Aşağıdaki komutları çalıştırın: 

Install-Package Grpc.Net.Client 
Install-Package Google.Protobuf 
Install-Package Grpc.Tools 

Paket yüklemek için NuGet Paketlerini Yönet seçeneği 

• NuGet paketlerini yönetmek > Çözüm Gezgini ' de projeye sağ tıklayın 

• Gözat sekmesini seçin. 

• Arama kutusuna GRPC .net. Client girin. 

• Araştır sekmesinden GRPC .net. Client paketini seçin ve ardından Install' ı seçin. 

• Google.Protobuf ve Grpc.Tools için yineleyin. 

Greet. proto Ekle 

• GRPC istemci projesinde bir Prototips klasörü oluşturun. 

• Protos\bUgisem. proto dosyasını GRPC Greeter hizmetinden GRPC istemci projesine kopyalayın. 

• Grpcgreeterclient. csproj proje dosyasını düzenleyin: 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Projeye sağ tıklayın ve Proje dosyasını Düzenle 1 yi seçin. 

• Greet. proto dosyasına başvuran <Protobuf> öğesi olan bir öğe grubu ekleyin: 

<ItemGroup> 

<Protobuf Include="Protos\greet.proto" GrpcServices="Client" /> 

</ItemGroup> 

Greeter istemcisini oluşturma 

GrpcGreeter ad alanındaki türleri oluşturmak için projeyi derleyin. GrpcGreeter türleri yapı işlemi tarafından 
otomatik olarak oluşturulur. 

GRPC Client program.es dosyasını aşağıdaki kodla güncelleştirin: 










using System; 

using System.Net.Http; 

using System.Thneading.Tasks; 

using GnpcGneeter; 

using Grpc.Net.Client; 


namespace GrpcGreeterClient 

{ 

class Program 

{ 

static async Task Main(string[] args) 

{ 

// The port number(5001) must match the port of the gRPC server. 
var channel = GrpcChannel.ForAddress("https://localhost:5001"); 
var Client = new Greeter.GreeterClient(channel); 
var reply = await Client.SayHelloAsync( 

new HelloRequest { Name = "GreeterClient" }); 
Console.WriteLine("Greeting: " + reply.Message); 

Console.WriteLine("Press any key to exit..."); 

Console.ReadKey(); 

} 

} 


Program.es , GRPC istemcisinin giriş noktasını ve mantığını içerir. 

Greeter istemcisi şu şekilde oluşturulur: 

• GRPC hizmetine bağlantı oluşturma bilgilerini içeren bir GrpcChannel örnekleniyor. 

• Greeter istemcisini oluşturmak için GrpcChannel kullanma: 


static async Task Main(string[] args) 

{ 

// The port number(5001) must match the port of the gRPC server. 
var channel = GrpcChannel.ForAddress("https://localhost:5001"); 
var Client = new Greeter.GreeterClient(channel); 
var reply = await Client.SayHelloAsync( 

new HelloRequest { Name = "GreeterClient" }); 
Console.WriteLine("Greeting: " + reply.Message); 

Console.WriteLine("Press any key to exit..."); 

Console.ReadKey(); 


Greeter istemcisi zaman uyumsuz sayHello yöntemini çağırır. sayHello çağrısının sonucu görüntülenir: 

static async Task Main(string[] args) 

{ 

// The port number(5001) must match the port of the gRPC server. 
var channel = GrpcChannel.ForAddress("https://localhost:5001"); 
var Client = new Greeter.GreeterClient(channel); 
var reply = await Client.SayHelloAsync( 

new HelloRequest { Name = "GreeterClient" }); 

Console.WriteLine("Greeting: " + reply.Message); 

Console.WriteLine("Press any key to exit..."); 

Console.ReadKey(); 


GRPC istemcisini gRPC Greeter hizmeti ile test etme 


• Visual Studio 












• Visual Studio Code 

• Mac için Visual Studio 


Greeter hizmetinde, hata ayıklayıcı olmadan sunucuyu başlatmak için 

Ctrl+F5 

1 a basın 

GrpcGreeterClient 

projede, hata ayıklayıcı olmadan istemcisini başlatmak için 

Ctrl+F5 


istemci, adı Greeterclierıto\an bir iletiyle hizmete bir tebrik gönderir. Hizmet, "Hello GreeterCIİent" iletisini yanıt 
olarak gönderir. Komut isteminde "Hello GreeterCIİent" yanıtı görüntülenir: 

Greeting: Hello GreeterCIİent 
Press any key to exit... 


GRPC hizmeti, komut istemine yazılan günlüklerde başarılı çağrının ayrıntılarını kaydeder: 

info: Microsoft.Hosting.Lifetime[0] 

Now listening on: https://localhost:5001 
info: Microsoft.Hosting.Lifetime[0] 

Application started. Press Ctrl+C to shut down. 
info: Microsoft.Hosting.Lifetime[0] 

Hosting environment: Development 
info: Microsoft.Hosting.Lifetime[0] 

Content root path: C: \GH\aspnet\docs\4\Docs\aspnetcore\tutorials\grpc\grpc-start\sample\GrpcGreeter 
info: Microsoft.AspNetCore.Hosting.Diagnostics[1] 

Request starting HTTP/2 POST https://localhost:5001/Greet.Greeter/SayHello application/grpc 
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[0] 

Executing endpoint 'gRPC - /Greet.Greeter/SayHello' 
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[l] 

Executed endpoint 'gRPC - /Greet.Greeter/SayHello' 
info: Microsoft.AspNetCore.Hosting.Diagnostics[2] 

Request finished in 78.32260000000001ms 200 application/grpc 


NOTE 

Bu makaledeki kod, gRPC hizmetini güvenli hale getirmek için ASP.NET Core HTTPS geliştirme sertifikası gerektirir. İstemci 
The remote certificate is invalid according to the validation procedure. ileti ile başarısız olursa, geliştirme 
sertifikası güvenilir değildir Bu sorunu gidermeye yönelik yönergeler için bkz. Windows ve macOS 'ta ASP.NET Core https 
geliştirme sertifikasına güvenin. 


gRPC Azure App Service desteklenmiyor 


VVARNING 

ASP.NET Core gRPC Azure App SERVİCE veya IIS 'de Şu anda desteklenmiyor. Http. sys ' nin HTTP/2 uygulamasına 
uygulanması, gRPC 'nin bağımlı olduğu HTTP yanıtı sondaki üst bilgileri desteklemez. Daha fazla bilgi için bu GitHub sorunu. 


Sonraki adımlar 

• .N ET Core 'da gRPC 'y e giriş 

• C# içeren gRPC hizmetleri 

• GRPC hizmetlerini C Core 'dan ASP.NET Core geçirme 








ASPNET Core - Öğreticisi 1. 8'de Entity Framevvork 
Core ile Razor sayfaları 

23.1 1.2019 * 53 minutes to read ı Edit Online 


Tarafından Tom Dykstra ve Rick Anderson 

Bu, bir ASP.NET Core Razor Pages uygulamasında ENTİTY Framework (EF) çekirdeğini nasıl kullanacağınızı 
gösteren bir öğretici serisinin ilkisidir. Öğreticiler, kurgusal bir Contoso Üniversitesi için bir Web sitesi oluşturur. 
Site, öğrenci giriş, kurs oluşturma ve eğitmen atamaları gibi işlevleri içerir. 

indirme veya tamamlanmış uygulamayı görüntüleyin. Yükleme yönergeleri. 

Önkoşullar 

• Razor Pages yeni başladıysanız, bu duruma başlamadan önce Razor Pages öğretici serisini kullanmaya başlayın. 

• Visual Studio 

• Visual Studio Code 

• ASP.net ve Web geliştirme iş yüküyle Visual Studio 2019 

• NET Core 3,0 SDK veya üzeri 

Veritabanı altyapıları 

Visual Studio yönergeleri, yalnızca VVİndovvs üzerinde çalışan bir SQL Server Express sürümü olan SQL Server 
LocalDB'yi kullanır. 

Visual Studio Code yönergeler, platformlar arası bir veritabanı altyapısı olan SQLİtekullanır. 

SQLİte kullanmayı seçerseniz, SQLİte İçin DB tarayıcısıgibi bir SQLİte veritabanını yönetmek ve görüntülemek için 
üçüncü taraf bir araç indirip yükleyin. 

Sorun giderme 

Giderebileceğiniz bir sorunla karşılaşırsanız, kodunuzu Tamamlanan projeylekarşılaştırın. Yardım almanın iyi bir 
yolu, ASP.NET Core etiketi veya EF Core etiketikullanilarakStackOverflow.com 'e bir soru göndererek. 

Örnek uygulama 

Aşağıdaki öğreticilerde oluşturulan bir uygulamayı bir temel university web sitesidir. Kullanıcılar görüntüleyebilir ve 
Öğrenci, kurs ve Eğitmen bilgileri güncelleştirin. Öğreticide oluşturulan ekranlar birkaçını aşağıda verilmiştir. 




Contoso University 


lndex 


Create New 

Find by name: 


Search 


Back to full List 


Last Name First Name Enrollment Date 

Alexander Carson 2016-09-01 Edit | Details | Delete 

Alonso Meredith 2018-09-01 Edit | Details | Delete 

Anand Arturo 2019-09-01 Edit | Details | Delete 


Previous I Next 


© 2019 - Contoso University - Privacy 


Contoso University 

Edit 

Student 

Last Name 
Alexander 

First Name 
Carson 

Enrollment Date 
09/01/2016 


Save 


Bu sitenin kullanıcı arabirimi stili yerleşik proje şablonlarına dayalıdır.Öğreticinin odağı, Kullanıcı arabirimini nasıl 
özelleştireceğinizi değil EF Core kullanma konusunda yer alır. 

Tamamlanan projenin kaynak kodunu almak için sayfanın üst kısmındaki bağlantıyı izleyin. Cu30 klasörü, 
öğreticinin AS P.N ET Core 3,0 sürümü için kod içerir. 1 -7 öğreticileri için kodun durumunu yansıtan dosyalar 
cu30snapshots klasöründe bulunabilir. 

• Visual Studio 

• Visual Studio Code 


Tamamlanmış projeyi indirdikten sonra uygulamayı çalıştırmak için: 












• Üç dosyayı ve ad içinde SÇLİte içeren bir klasörü silin. 

• Projeyi oluşturun. 

• Paket Yöneticisi konsolu 'nda (PMC) aşağıdaki komutu çalıştırın: 

Update-Database 

• Veritabanını temel alarak projeyi çalıştırın. 

Web uygulaması projesi oluşturma 

• Visual Studio 

• Visual Studio Code 

• Visual Studio'dan dosya menüsünde yeni > proje. 

• Seçin ASP.NET Core Web uygulaması. 

• Projeyi adlandırın ContosoUniversity. Büyük harfler de dahil olmak üzere bu tam adı kullanmak önemlidir, bu 
nedenle kod kopyalanıp yapıştırılırken ad alanları eşleşir. 

• Açılan menüden .N ET Core ve 3,0 ASP.N ET Core seçin ve ardından Web uygulaması 1 nı seçin. 

Site stili Ayarla 

Sayfa/paylaşdan/_Layout. cshtml'y\ güncelleştirerek site üst bilgisini, alt bilgisini ve menüsünü ayarlayın: 

• "Contoso Üniversitesi" için "ContosoUniversity" her örneğini değiştirin. Üç örnekleri vardır. 

• Giriş ve Gizlilik menü girişlerini silin ve hakkında, öğrenciler, Kurslar, eğitmenlerve Departmanlariçin 

girişler ekleyin. 


Değişiklikler vurgulanır. 




<!DOCTYPE html> 

<html lang="en"> 

<head> 

<meta charset="utf-8" /> 

<meta name="viewport" content="width=device-width., initial-scale=1.0" /> 

<title>@ViewData["Title"] - Contoso University</title> 

<link rel="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.css" /> 

<link rel="stylesheet" href="~/css/site.css" /> 

</head> 

<body> 

<header> 

<nav class="navbar navbar-expand-sm navbar-toggleable-sm navbar-light bg-white border-bottom box-shadow 

mb-3"> 

<div class="container"> 

<a class="navbar-brand" asp-area="" asp-page="/Index">Contoso University</a> 

<button class="navbar-toggler" type="button" data-toggle="collapse" data-target=".navbar- 
collapse" aria-controls="navbarSupportedContent" 

aria-expanded="false" aria-label="Toggle navigation"> 

<span class="navbar-toggler-icon"x/span> 

</button> 

<div class="navbar-collapse collapse d-sm-inline-flex flex-sm-row-reverse"> 

<ul class="navbar-nav flex-grow-l"> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-anea="" asp-page="/About">About</a> 

</li> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-area="" asp-page="/Students/Index">Students</a> 
</li> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-area="" asp-page="/Courses/Index">Courses</a> 
</li> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-anea="" asp- 
page="/Instnuctors/Index">Instructons</a> 

</li> 

di class="nav-item"> 

<a class="nav-link text-dark" asp-anea="" asp- 
page="/Departments/Index"»Departments</a> 

</li> 

</ul> 

</div> 

</div> 

</nav> 

</header> 

<div class="container"> 

<main role="main" class="pb-3"> 

@RenderBody() 

</main> 

</div> 

<footer class="border-top footer text-muted"> 

<div class="container"> 

&copy; 2019 - Contoso University - <a asp-area="" asp-page="/Privacy">Privacy</a> 

</div> 

</footer> 

<script src="~/lib/jquery/dist/jquery. js"x/script> 

<script src="~/lib/bootstrap/dist/js/bootstrap. bundle. js"x/script> 

<script src="~/js/site.js" asp-append-version="true"x/script> 

@RenderSection("Scripts"j required: false) 

</body> 

</html> 


Pages/lndex. cshfm/dosyasmda, AS P.N ET Core hakkındaki metni bu uygulamayla ilgili metinle değiştirmek için 
dosyanın içeriğini aşağıdaki kodla değiştirin: 



@page 

@model IndexModel 

@{ 

ViewData["Title"] = "Home page"; 

} 

<div class="row mb-auto"> 

<div class="col-md-4"> 

<div class="row no-gutters border mb-4"> 

<div class="col p-4 mb-4 "> 

<p class="card-text"> 

Contoso University is a sample application that 
demonstrates how to use Entity Framework Core in an 
ASP.NET Core Razor Pages web app. 

</p> 

</div> 

</div> 

</div> 

<div class="col-md-4"> 

<div class="row no-gutters border mb-4"> 

<div class="col p-4 d-flex flex-column position-static"> 

<p class="card-text mb-auto"> 

You can build the application by following the steps in a series of tutorials. 

</p> 

<P> 

<a href="https://docs.microsoft.com/aspnet/core/data/ef-rp/intro" class="stretched- 
link">See the tutorial</a> 

</p> 

</div> 

</div> 

</div> 

<div class="col-md-4"> 

<div class="row no-gutters border mb-4"> 

<div class="col p-4 d-flex flex-column"> 

<p class="card-text mb-auto"> 

You can download the completed project from GitHub. 

</p> 

<P> 

<a href="https://github.com/aspnet/AspNetCore.Docs/tree/master/aspnetcore/data/ef- 
rp/intro/samples" class="stretched-link">See project source code</a> 

</p> 

</div> 

</div> 

</div> 

</div> 


Giriş sayfasının göründüğünü doğrulamak için uygulamayı çalıştırın. 

Veri modeli 

Aşağıdaki bölümler bir veri modeli oluşturur: 


Course 

o - d 

1 

Enrollment 

0 - c 

* 1 

Student 

Properties 

Vî CourselD 

A Title 

A Credits 

Properties 
< 1 % EnrolImentlD 

A CourselD 

A StudentlD 

A Grade 

Properties 
yî İD 

A LastName 

A FirstMidName 

A EnrolImentDate 

Navigation Properties 
& Enrollments 

Navigation Properties 

Navigation Properties 


Course 
y3 Student 


V^l Enrollments 

























Bir öğrenci herhangi bir sayıda kursa kaydolabilir ve bir kurs, kayıtlı sayıda öğrenciye sahip olabilir. 


Öğrenci varlık 


Student 


Properties 
V? İD 

A LastName 
A FirstMidName 
A EnrolImentDate 
Navigation Properties 
{3 Enrollments 


• Proje klasöründe bir modeller klasörü oluşturun. 

• Aşağıdaki kodla modeller/öğrenci, cs oluşturun: 

using System; 

using System.Collections.Generic; 

namespace ContosoUniversity.Models 
{ 

public class Student 
{ 

public int ID { get; set; } 
public string LastName { get; set; } 
public string FirstMidName { get; set; } 
public DateTime EnrolImentDate { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 

id özelliği, bu sınıfa karşılık gelen veritabanı tablosunun birincil anahtar sütunu olur. Varsayılan olarak EF Core adlı 
bir özellik yorumlar id veya ciassnameiD birincil anahtar olarak. Bu nedenle, student sınıfı birincil anahtarı için 
otomatik olarak tanınan ad studentiD . 

Enrollments Özelliği bir gezinti özelliği. Gezinti özellikleri, bu varlıkla ilgili diğer varlıkları tutar. Bu durumda, bir 
student varlığının Enrollments özelliği söz konusu öğrenci ile ilgili Enroiiment varlıkların tümünü barındırır. 
Örneğin, veritabanındaki bir öğrenci satırında iki ilişkili kayıt satırı varsa, Enrollments gezinti özelliği bu iki kayıt 
varlığını içerir. 

Veritabanında, bir kayıt satırı, Studentitıd sütunu öğrencinin İD değerini içeriyorsa bir öğrenci satırıyla ilgilidir. 
Örneğin, bir öğrenci satırının İD = 1 olduğunu varsayalım, ilgili kayıt satırları Studentitıd = 1 olacaktır.Studentitıd, 
kayıt tablosundaki bir yabancı anahtardır. 

Birden çok ilgili kayıt varlığı olabileceğinden Enrollments özelliği ıcoiiection<Enroiiment> olarak tanımlanır. 
List<Enroiiment> veya HashSet<Enroiiment> gibi başka koleksiyon türleri de kullanabilirsiniz. Zaman 
ıcoiiection<Enroiiment> olduğu EF Core kullanıldığında, oluşturur bir HashSet<Enroiiment> varsayılan olarak 
koleksiyon. 


Kayıt varlık 


















Enrollment 


Properties 
yî EnrolImentlD 
A* CourselD 
A* StudentlD 
A Grade 

Navigation Properties 
P Course 
y3 Student 


Aşağıdaki kodla modeller/kayıt. cs oluşturun: 

namespace ContosoUniversity.Models 
{ 

public enum Grade 
{ 

A, Bj C, D, F 

} 

public class Enrollment 
{ 

public int EnrolImentlD { get; set; } 
public int CourselD { get; set; } 
public int StudentlD { get; set; } 
public Grade? Grade { get; set; } 

public Course Course { get; set; } 
public Student Student { get; set; } 

} 

} 

EnrolImentlD özelliği birincil anahtardır; Bu varlık, id yerine ciassnameiD modelini kullanır. Bir üretim veri modeli 
için bir model seçin ve bunu tutarlı bir şekilde kullanın. Bu öğretici her ikisinin de yalnızca bir iş olduğunu 
göstermek için kullanır, ciassname olmadan id kullanmak, bazı veri modeli değişikliklerinin uygulanmasını 
kolaylaştırır. 


Grade Özelliği bir enum. Grade türü bildiriminden sonraki soru işareti, Grade özelliğinin null yapılabilirolduğunu 
gösterir. Null olan bir sınıf sıfır bir sınıfa göre farklılık gösterir—null, henüz bir sınıf bilinmediğini veya henüz 
atanmadığını belirtir. 


StudentlD 

Özelliği olduğundan yabancı anahtar ve karşılık gelen gezinme özelliğini 

Student 

. Bir 

Enrollment 


varlıktır biriyle ilişkili student tek bir özellik içerecek şekilde varlık student varlık. 


CourselD Özelliği olduğundan yabancı anahtar ve karşılık gelen gezinme özelliğini course . Bir Enrollment varlıktır 
biriyle ilişkili course varlık. 


EF Core adlandırılmışsa, bu özellik bir yabancı anahtar olarak yorumlar 

cnavigation property namexprimary key property name> . Örneğin, Student varlığın birincil anahtarı ID 
olduğundan, student gezinti özelliği için StudentlD yabancı anahtardır. Yabancı anahtar özellikleri de adı 
<primary key property name> . Örneğin, CourselD beri Course varlığın birincil anahtarı CourselD . 


Kurs varlık 
































Course 



using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations.Schema; 


namespace Contosouniversity.Models 
{ 

public class Course 
{ 

[DatabaseGenerated(DatabaseGeneratedOption.None)] 
public int CourselD { get; set; } 
public string Title { get; set; } 
public int Credits { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 

Enrollments Özelliktir bir gezinme özelliği. A course varlık dilediğiniz sayıda ilgili olabileceğini Enroiiment 
varlıklar. 

DatabaseGenerated özniteliği, uygulamanın veritabanını oluşturmak yerine birincil anahtarı belirtmesini sağlar. 
Derleyici hatası olmadığını doğrulamak için projeyi derleyin. 

Yapı iskelesi öğrenci sayfaları 

Bu bölümde, oluşturmak için ASP.NET Core scafkatlama aracını kullanırsınız: 

• EF Core bağlamı sınıfı. Bağlam, belirli bir veri modeli için Entity Framevvork işlevselliği koordine eden ana 
sınıftır. Microsoft. EntityFrameworkCore.DbContext sınıfından türetilir. 

• student varlık için oluşturma, okuma, güncelleştirmeye silme (CRUD) işlemlerini işleyen Razor sayfaları. 

• Visual Studio 

• Visual Studio Code 

• Sayfalar klasöründe bir öğrenciler klasörü oluşturun. 

• Çözüm Gezgini, Sayfalar/öğrenciler klasörüne sağ tıklayın ve > yeni yapı iskelesi öğesi Ekle 1 yi seçin. 

• içinde İskele Ekle iletişim kutusunda Entity Framevvork (CRU D) kullanarak Razor sayfaları > ekleme. 

• Entity Framevvork kullanarak Razor Pages Ekle (CRU D) iletişim kutusunda: 

o İçinde Model sınıfı açılan listesinde, select Öğrenci (ContosoUniversity.Models) . 
o Veri bağlamı sınıfı satırında + (artı) işaretini seçin. 

o Contosouniversity. modeller. Contosoüniversıtycontext olan veri bağlamı adını Contosouniversity. Data. 

SchoolContexto\arak değiştirin, 
o Add (Ekle) seçeneğini belirleyin. 

Aşağıdaki paketler otomatik olarak yüklenir: 


Microsoft.VisualStudio.Web.CodeGeneration.Design 













Microsoft.EntityF rameworkCore.SqlServer 

Microsoft.Extensions.Logging.Debug 


Microsoft.EntityF rameworkCore.Tools 



Önceki adımla ilgili bir sorununuz varsa, projeyi derleyin ve yapı iskelesi adımını yeniden deneyin. 

Yapı iskelesi işlemi: 

• Sayfalar/öğrenciler klasöründe Razor sayfaları oluşturur: 
o . Cshtml ve Create.cshtml.es oluşturma 

o De/efe. cshtml ve delete.cshtml.es 
o Details. cshtml ve details.cshtml.es 
o . Cshtml ve Edit.cshtml.es Düzenle 
o lrıdex. cshtml ve lndex.cshtml.cs 

• Data/SchoolContext. csoluşturur. 

• Sfortup.csiçinde bağımlılık eklenmesine bağlam ekler. 

• AppSettings. JSONöğesme bir veritabanı bağlantı dizesi ekler. 

Veritabanı bağlantı dizesi 

• Visual Studio 

• Visual Studio Code 

Bağlantı dizesini belirtir SQL Server LocalDB. 

{ 

"Logging": { 

"LogLevel": { 

"Default": "Information", 

"Microsoft": "Warning", 

"Microsoft.Hosting.Lifetime": "Information" 

} 

}, 

"AllowedHosts": "*", 

"ConnectionStrings": { 

"SchoolContext": "Server= 

(localdb)\\mssqllocaldb;Database=SchoolContext;Trusted_Connection=True;MultipleActiveResultSets=true" 

} 

} 

LocalDB, SQL Server Express veritabanı Motoru'nu hafif bir sürümüdür ve uygulama geliştirme, üretim kullanımı 
için tasarlanmıştır. Varsayılan olarak, LocalDB c:/üsers/<user> dizininde. mdf dosyaları oluşturur. 

Veritabanı bağlam sınıfını Güncelleştir 

Belirli bir veri modeli için EF Core işlevselliğini koordine eden ana sınıf veritabanı bağlamı sınıfıdır. Bağlam 
Microsoft. EntityFramevvorkCore. DbContextöğesinden türetilir. Bağlam, veri modeline hangi varlıkların 
ekleneceğini belirtir. Bu projede adlı sınıfı schooicontext . 


Güncelleştirme SchoolContext.cs aşağıdaki kod ile: 





using Microsoft.EntityFrameworkCore; 
using ContosoUniversity.Models; 

namespace ContosoUniversity.Data 
{ 

public class SchoolContext : DbContext 
{ 

public SchoolContext (DbContextOptions<SchoolContext> options) 

: base(options) 

{ 

} 

public DbSet<Student> Students { get; set; } 
public DbSet<Enrollment> Enrollments { get; set; } 
public DbSet<Course> Courses { get; set; } 

protected override void OnModelCreating(ModelBuilder modelBuilder) 
{ 

modelBuilder.Entity<Course>().ToTable("Course"); 
modelBuilder.Entity<Enrollment>().ToTable("Enrollment"); 
modelBuilder.Entity<Student>().ToTable("Student"); 

} 

} 

} 


Vurgulanan kod oluşturur bir olan DB<TEntity > her varlık kümesi özelliği. EF Core terminolojisinde: 

• Bir varlık kümesi, genellikle bir veritabanı tablosuna karşılık gelir. 

• Bir varlık tablosunda bir satıra karşılık gelir. 

Bir varlık kümesi birden çok varlık içerdiğinden, DBSet özellikleri çoğul adlar olmalıdır.Scafkatlama aracı bir 
student DBSet oluşturduğundan, bu adım bunu plural students olarak değiştirir. 

Razor Pages kodun yeni DBSet adıyla eşleşmesini sağlamak için, tüm _context.student projesi genelinde 
_context.students için genel bir değişiklik yapın. 8 oluşum vardır. 

Derleyici hatası olmadığını doğrulamak için projeyi derleyin. 


Startup.es 

ASP.NET Core ile oluşturulmuş bağımlılık ekleme. Hizmetler (EF Core veritabanı bağlamı gibi) uygulama başlatma 
sırasında bağımlılık ekleme ile kaydedilir. Bu hizmetler (örneğin, Razor sayfaları) gerektiren bileşenler bu hizmetler 
Oluşturucu parametresi üzerinden sağlanır. Bir veritabanı bağlamı örneğini alan Oluşturucu kodu öğreticide daha 
sonra gösterilmiştir. 

Scafkatlama Aracı, bağlam sınıfını bağımlılık ekleme kapsayıcısına otomatik olarak kaydetti. 

• Visual Studio 

• Visual Studio Code 


• configureServices , vurgulanan satırlar scaffolder tarafından eklenmiştir: 


public void ConfigureServices(IServiceCollection Services) 
{ 

Services.AddRazorPages(); 


} 


Services.AddDbContext<SchoolContext>(options => 

options.UseSqlServer(Configuration.GetConnectionString("SchoolContext"))); 







Bağlantı dizesi adı için bağlam üzerinde bir yöntemi çağırarak geçirilen bir DbContextOptions nesne. Yerel 
geliştirme için AS P.N ET Core yapılandırma sistemi bağlantı dizesinden okur appsettings.json dosya. 

Veritabanını oluşturma 

Mevcut değilse veritabanını oluşturmak için program.es güncelleştirin: 

using ContosoUniversity.Data; 

ıısing Microsoft.Extensions.DependencyInjection; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.Extensions.Hosting; 

using Microsoft.Extensions.Logging; 

using System; 

namespace ContosoUniversity 

{ 

public elass Program 

{ 

public static void Main(string[] args) 

{ 

var hoşt = CreateHostBuilder(args).Build(); 

CreateDbIfNotExists(host); 
host.Run(); 

} 

private static void CreateDbIfNotExists(IHost hoşt) 

{ 

using (var scope = hoşt.Services.CreateScope()) 

{ 

var Services = scope.ServiceProvider; 

try 

{ 

var context = Services.GetRequiredService<SchoolContext>(); 
context.Database.EnsureCreated(); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<ILogger<Program>>(); 
logger.LogError(ex J "An error occurred creating the DB."); 

} 

} 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 

} 

} 


Bağlam için bir veritabanı varsa, Ensuyeniden oluşturma yöntemi hiçbir eylemde bulunmaz. Veritabanı yoksa, 
veritabanını ve şemayı oluşturur. EnsureCreated , veri modeli değişikliklerini işlemek için aşağıdaki iş akışına izin 
vermez: 

• Veritabanını silin. Mevcut veriler kaybolur. 

• Veri modelini değiştirin. Örneğin, bir EmaiiAddress alanı ekleyin. 

• Uygulamayı çalıştırın. 

• EnsureCreated yeni şemaya sahip bir veritabanı oluşturur. 






Bu iş akışı, verileri korumanıza gerek olmadığı sürece, şema hızlı bir şekilde gelişen zaman geliştirme aşamasında 
iyi bir şekilde gerçekleştirilir. Veritabanına girilen verilerin korunması gerektiğinde bu durum farklıdır. Bu durumda, 
geçişleri kullanın. 

Öğretici serisinde daha sonra, EnsureCreated tarafından oluşturulan veritabanını silin ve bunun yerine geçişleri 
kullanın. EnsureCreated tarafından oluşturulan bir veritabanı, geçişler kullanılarak güncelleştirilemiyor. 

Uygulamayı test etme 

• Uygulamayı çalıştırın. 

• Seçin Öğrenciler bağlantısını ve ardından Yeni Oluştur. 

• Ayrıntılar, düzenleme, test edin ve bağlantılarını silin. 

Veritabanının çekirdeğini oluşturma 

EnsureCreated yöntemi boş bir veritabanı oluşturur. Bu bölüm, veritabanını test verileriyle dolduran kodu ekler. 
Aşağıdaki kodla veri/Dbmizer. cs oluşturun: 


using ContosoUniversity.Data; 
using ContosoUniversity.Models; 
using System; 
using System.Linq; 

namespace ContosoUniversity.Data 

{ 

public static class Dblnitializer 

{ 

public static void Initialize(SchoolContext context) 

{ 

context.Database.EnsureCreated(); 

// Look for any students. 
if (context.Students.Any()) 

{ 

return; // DB has been seeded 

} 

var students = new Student[] 

{ 

new Student{FirstMidName="Carson",LastName="Alexander",EnrollmentDate=DateTime.Parse("2019-09- 

01 ")}, 

new Student{FirstMidName="Meredith",LastName="Alonso",EnrollmentDate=DateTime.Parse("2017-09- 

01 ")}, 

new Student{FirstMidName="Arturo",LastName="Anand",EnrollmentDate=DateTime.Parse("2018-09- 

01 ")}, 

new Student{FirstMidName="Gytis",LastName="Barzdukas",EnrollmentDate=DateTime.Parse("2017-09- 

01 ")}, 

new Student{FirstMidName="Yan",LastName="Li",EnrollmentDate=DateTime.Parse("2017-09-01")}, 
new Student{FirstMidName="Peggy",LastName="lustice",EnrollmentDate=DateTime.Parse("2016-09- 

01 ")}, 

new Student{FirstMidName="Laura",LastName="Norman",EnrollmentDate=DateTime.Parse("2018-09- 

01 ")}, 

new Student{FirstMidName="Nino", LastName="01ivetto", EnrollmentDate=DateTime. Parse( "2019-09- 

01 ")} 

}; 

foreach (Student s in students) 

{ 

context.Students.Add(s); 

} 

context.SaveChanges(); 

var courses = new Course[] 

{ 


new Course{CourseID=1050,Title="Chemistry",Credits=3}, 





new Course{CourseID=4022,Title="Microeconomics" ) Credits=3} J 
new Course{CourseID=4041,Title="l v lacroeconomics",Credits=3} J 
new Course{CourseID=1045,Title="Calculus",Credits=4}, 
new Course{CourseID=3141,Title="Trigonometry",Credits=4}., 
new Course{CourseID=2021,Title="Composition",Credits=3}, 
new Course{CourseID=2042,Title="Literatüre",Credits=4} 

}; 

foreach (Course c in courses) 

{ 

context.Courses.Add(c); 

} 

context.SaveChanges(); 

var enrollments = new Enrollment[] 

{ 

new Enrollment{StudentID=l J CourseID=1050,Grade=Grade.A}, 
new Enrollment{StudentID=l J CourseID=4022,Grade=Grade.C} ) 
new Enrollment{StudentID=l,CourseID=4041 J Grade=Grade.B} J 
new Enrollment{StudentID=2,CourseID=1045 J Grade=Grade.B} J 
new Enrollment{StudentID=2,CourseID=3141jGrade=Grade.F}, 
new Enrollment{StudentID=2 J CourseID=2021,Grade=Grade.F}, 
new Enrollment{StudentID=3 J CourseID=1050} ) 
new Enrollment{StudentID=4,CourseID=1050}, 
new Enrollment{StudentID=4,CourseID=4022jGrade=Grade.F}, 
new Enrollment{StudentID=5 J CourseID=4041,Grade=Grade.C} ) 
new Enrollment{StudentID=6 J CourseID=1045} ) 
new Enrollment{StudentID=7,CourseID=3141 J Grade=Grade.A} J 

}; 

foreach (Enrollment e in enrollments) 

{ 

context.Enrollments.Add (e); 

} 

context.SaveChanges(); 

} 

} 

} 

Kod, veritabanında herhangi bir öğrenci olup olmadığını denetler. Öğrenci yoksa, veritabanına test verileri ekler. 
Performansı iyileştirmek için List<T> koleksiyonları yerine diziler halinde test verileri oluşturur. 

• Program.es' de EnsureCreated çağrısını Dbinitializer.initialize çağrısıyla değiştirin: 

// context.Database.EnsureCreated(); 

Dblnitializer.Initialize(context); 


• Visual Studio 

• Visual Studio Code 

Çalışıyorsa uygulamayı durdurun ve Paket Yöneticisi konsolunda (PMC) aşağıdaki komutu çalıştırın: 

Drop-Database 

• Uygulamayı yeniden başlatın. 

• Sağlanan verileri görmek için öğrenciler sayfasını seçin. 

Veritabanını görüntüleme 

• Visual Studio 

• Visual Studio Code 







• Açık SQL Server Nesne Gezgini (SSOX) öğesinden görünümü Visual Studio'daki menü. 

• SSOX te, (LocalDB) \MSSQLLocalDB > veritabanları > SchoolContext-{GUID} öğesini seçin. Veritabanı 
adı, daha önce belirttiğiniz bağlam adından ve bir tire ve bir GUID ile oluşturulur. 

• Genişletin tabloları düğümü. 

• Sağ Öğrenci tablosu ve'ı tıklatın görünüm verilerini oluşturulan sütunları ve tabloya eklenen satırları 
görebilirsiniz. 

• student modelinin student tablo şemasına nasıl eşlendiğini görmek için öğrenci tablosuna sağ tıklayın ve 

kodu görüntüle ' ye tıklayın. 

Zaman uyumsuz kod 

Zaman uyumsuz programlama, ASP.NET Core ve EF Core için varsayılan moddur. 

Sınırlı sayıda iş parçacığı kullanılabilir bir web sunucusuna sahip ve yüksek yük durumlarda tüm kullanılabilir iş 
parçacıklarının kullanımda olabilir. Bu durum oluştuğunda, sunucunun iş parçacıklarının serbest bırakılana kadar 
yeni istekleri işleyemiyor. G/ç tamamlanması bekleniyor çünkü bunlar herhangi bir iş gerçekten yapmamanız 
sırasında eş zamanlı kod ile birçok iş parçacığı bağlanması, işlemi tamamlamak, g/ç için beklerken zaman uyumsuz 
kod ile diğer istekleri işlemek için kullanılacak sunucuyu için kendi iş parçacığı serbest bırakılır. Sonuç olarak, zaman 
uyumsuz kod sunucu kaynaklarının daha verimli kullanılmasını sağlar ve sunucu gecikmeksizin daha fazla trafiği 
işleyebilir. 

Zaman uyumsuz kod, çalışma zamanında az miktarda bir ek yükü sunar. Düşük trafiğe durumlar, performans 
düşüşüne yüksek trafik durumlar için göz ardı edilebilir, çalışırken, olası performans geliştirmesi önemli. 

Aşağıdaki kodda, zaman uyumsuz anahtar sözcüğü, Task<T> dönüş değeri, await anahtar sözcüğü ve 
ToListAsync yöntemi zaman uyumsuz yürütülen kod olun. 

public async Task OnGetAsync() 

{ 

Students = await _context.Students.ToListAsync(); 

} 

• async Anahtar sözcüğü, derleyiciye bildirir: 

o Yöntem gövdesini bölümleri için geri çağırmaları oluşturur, 
o Döndürülen görev nesnesini oluşturun. 

• Task<T > dönüş türü devam eden çalışmayı temsil eder. 

• await Anahtar sözcüğü, derleyicinin yöntemin iki parçalara bölmek neden olur. İlk bölüm ile zaman uyumsuz 
olarak başlatıldığında işlemi sonlandırır. ikinci bölümü, işlemi tamamlandıktan sonra çağrılan bir geri çağırma 
yöntemi yerleştirilir. 

• ToListAsync zaman uyumsuz sürümüdür ToList genişletme yöntemi. 

EF Core kullanan zaman uyumsuz kodu yazarken dikkat edilmesi gereken bazı noktalar şunlardır: 

• Yalnızca sorguları veya komutlarının veritabanına gönderilmesine neden olan deyimler zaman uyumsuz olarak 


yürütülür. Bu ToListAsync , SingleOrDefaultAsync 

, FirstOrDefaultAsync ve SaveChangesAsync içerir. Yalnızca 

değiştirmek deyimleri içermeyen bir ıçueryabie , 

gibi 

var students = context.Students.Where(s => s.LastName == "Davolio") . 


• EF Core bağlam iş parçacığı güvenli olmayan: paralel birden çok işlem yapmak yeniden denemeyin. 

• Zaman uyumsuz kodun performans avantajlarından yararlanmak için, veritabanına sorgu gönderen EF Core 
yöntemleri çağırıyorsa kitaplık paketlerinin (örneğin, sayfalama için) zaman uyumsuz olarak kullanılacağını 
doğrulayın. 

. N ET'te zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. zaman uyumsuz genel bakış ve zaman 
















uyumsuz programlama ile async ve await. 


Sonraki adımlar 


SON RAKI 
ÖĞRETİCİ 


Contoso University örnek vveb uygulamasını, Entity Framework (EF) çekirdek kullanarak bir ASP.NET Core Razor 
sayfalar uygulamasının nasıl oluşturulacağını gösterir. 

Örnek uygulama, kurgusal Contoso üniversite için bir web sitesidir.Öğrenci giriş, kurs oluşturma ve Eğitmen 
atamaları gibi işlevleri içerir. Contoso University örnek uygulamasının nasıl oluşturulacağını açıklayan öğreticileri 
serisinin ilk sayfadır. 

indirme veya tamamlanmış uygulamayı görüntüleyin. Yükleme yönergeleri. 

Önkoşullar 

• Visual Studio 

• Visual Studio Code 

Visual Studio 2019 aşağıdaki iş yükleri ile: 

• ASP.N ET ve vveb geliştirme 

• .NET core platformlar arası geliştirme 

.NET core 2.1 SDK veya üzeri 

Konusunda Razor sayfaları. Yeni programcılar tamamlamanız gereken Razor sayfaları kullanmaya başlama Bu seriyi 
başlatmadan önce. 

Sorun giderme 

Bir sorunla karşılaşırsanız, çözümleyemiyor çalıştırırsanız, genel olarak çözüm kodunuzda karşılaştırarak 
bulabilirsiniz projeyi. Soru göndererek Yardım almak için en iyi yolu olan StackOverflow.com için ASP.NET Core 
veya EF Core. 

Contoso University vveb uygulaması 

Aşağıdaki öğreticilerde oluşturulan bir uygulamayı bir temel university web sitesidir. 

Kullanıcılar görüntüleyebilir ve Öğrenci, kurs ve Eğitmen bilgileri güncelleştirin. Öğreticide oluşturulan ekranlar 
birkaçını aşağıda verilmiştir. 
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açıktır. 


ContosoUniversity Razor sayfaları web uygulaması oluşturma 

• Visual Studio 

• Visual Studio Code 

• Visual Studio'dan dosya menüsünde yeni > proje. 

• Yeni bir ASP.NET Core Web uygulaması oluşturun. Projeyi adlandırın ContosoUniversity. Projeyi adlandırın 
önemlidir ContosoUniversity kod kopyalanıp/yapıştırılmış ad alanları eşleştirmek için. 

• Seçin ASP.NET Core 2.1 açılır ve ardından Web uygulaması. 

Önceki adımlarda görüntüleri için bkz: Razor web uygulaması oluşturma. Uygulamayı çalıştırın. 

Site stili Ayarla 

Birkaç değişiklik site menü, Düzen ve giriş sayfası ayarlayın. Güncelleştirme Pages/Shared/_Layout.cshtmi 
aşağıdaki değişikliklerle birlikte: 

• "Contoso Üniversitesi" için "ContosoUniversity" her örneğini değiştirin. Üç örnekleri vardır. 

• Menü girdileri eklemek Öğrenciler, kursları, Eğitmenler, ve Departmanlarve silme başvurun menüsü 
girişi. 

Değişiklikler vurgulanır.(Tüm biçimlendirme değii görüntülenir.) 


<!DOCTYPE html> 

<html> 

<head> 

<meta charset="utf- 8 " /> 

<meta name="viewport" content="width=device-width., initial-scale= 1 . 0 " /> 

<title>@ViewData["Title"] : Contoso University</title> 

<environment include="Development"> 

<link r 8 İ="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.css" /> 

<link rel="stylesheet" href="~/css/site.css" /> 

</environment> 

<environment exclude="Development"> 

<link r 8 İ="stylesheet" href=" https://ajax.aspnetcdn.eom/ajax/bootstrap/ 3 . 3 . 7 /css/bootstrap.min.css" 
asp-fallback-hr0f="~/lib/bootstrap/dist/css/bootstrap.min.ess" 

asp-fallback-t0st-class=”sr-only" asp-fallback-test-property="position" asp-fallback-test- 
valu0="absolut0" /> 

<link r0İ="styİ0sh00t" hr0f="~/css/sit0.min.css" asp-app0nd-v0rsion="tru0" /> 

</0nvironmant> 

</hoad> 

<body> 

<nav class="navbar navbar-invorsa navbar-fix0d-top"> 

<div class="contain0r"> 

<div class="navbar-h0ad0r"> 

<button typ0="button" class="navbar-toggİ0" data-toggİ0="collaps0" data-targ0t=".navbar- 

collaps0"> 

<span class="sr-only">Toggİ0 navigation</span> 

<span class="icon-bar"x/span> 

<span class="icon-bar"x/span> 

<span class="icon-bar"x/span> 

</button> 

<a asp-pag0="/lnd0x" class="navbar-brand">Contoso Univ0rsity</a> 

</div> 

<div class="navbar-collaps0 collaps0"> 

<ul class="nav navbar-nav"> 

<lixa asp-pag0="/Ind0x">Hom0</ax/li> 

<lixa asp-pag0="/About">About</ax/li> 

<lixa asp-pag0="/Stud0nts/Ind0x">Stud0nts</ax/li> 

<lixa asp-pag0="/Cours0s/Ind0x">Cours0s</ax/li> 

<lixa asp-pag0="/lnstructors/lnd0x">lnstructors</ax/li> 

<lixa asp-pag0="/Departments/Ind0x">D0partm0nts</ax/li> 

</ul> 

</div> 

</div> 

</nav> 

<partial name="_CookieConsentPartial" /> 

<div class="container body-content"> 

@RenderBody() 

<hr /> 

<footer> 

<p>&copy; 2018 : Contoso University</p> 

</footer> 

</div> 

@*Remaining markup not shown for brevity.*@ 


içinde sayfalar/dizin.cshtml, dosyanın içeriğini ASP.NET ve MVC hakkında metnin bu uygulama hakkında metinle 
değiştirmek için aşağıdaki kodla değiştirin: 



@page 

@model IndexModel 

@{ 

ViewData["Title"] = "Home page"; 

} 

<div class="jumbotron"> 

<hl>Contoso University</hl> 

</div> 

<div class="row"> 

<div class="col-md- 4 "> 

<h 2 >Welcome to Contoso University</h 2 > 

<P> 

Contoso University is a sample application that 
demonstnates how to use Entity Framework Cone in an 
ASP.NET Core Razor Pages web app. 

</p> 

</div> 

<div class="col-md- 4 "> 

<h 2 >Build it from scratch</h 2 > 

<p>You can build the application by following the steps in a senies of tutonials.</p> 

<P> 

<a class="btn btn-defaıılt" 

href="https://docs.microsoft.com/aspnet/core/data/ef-rp/intro"> 

See the tutorial &raquo; 

</a> 

</p> 

</div> 

<div class="col-md- 4 "> 

<h 2 >Download İt</h 2 > 

<p>You can download the completed project fnom GitHub.</p> 

<P> 

<a class="btn btn-default" 

href="https://github.com/aspnet/AspNetCore.Docs/tree/master/aspnetcore/data/ef- 
rp/intro/samples/"> 

See project source code &raquo; 

</a> 

</p> 

</div> 

</div> 


Veri modeli oluşturma 

Varlık sınıflarının Contoso University uygulama oluşturun. Aşağıdaki üç varlıklarla başlayın: 


Couıse 


Enrollment 


Student 

Properties 
yî CourselD 

A Title 

A Credits 

Properties 

Properties 

0- 

1 

ı/İ EnrolImentlD 

A CourselD 

A StudentlD 

A Grade 

0-0 

* 1 

yî İD 

A LastName 

A FirstMidName 

A EnrolImentDate 

Navigation Properties 
{S Enrollments 

Navigation Properties 

Navigation Properties 


y3 Course 

Student 


y3 Enrollments 





Bir-çok ilişkisi arasında student ve Enroiiment varlıklar. Bir-çok ilişkisi arasında course ve Enroiiment varlıklar. 
Bir öğrenci herhangi bir sayıda kursları kaydedebilirsiniz. Bir kurs herhangi bir sayıda Öğrenciler içinde kayıtlı 
olabilir. 

Aşağıdaki bölümlerde, bu varlıkların her biri için bir sınıf oluşturulur. 

Öğrenci varlık 























Student 


Properties 
yi İD 

A LastName 
A FirstMidName 
A EnrolImentDate 
Navigation Properties 
P Enrollments 


Oluşturma bir modelleri klasör, içinde modelleri klasöründe adlı bir sınıf dosyası oluşturma Student.es aşağıdaki 
kod ile: 


using System; 

using System.Collections.Generic; 

namespace ContosoUniversity.Models 
{ 

public elass Student 
{ 

public int ID { get; set; } 
public stning LastName { get; set; } 
public string FirstMidName { get; set; } 
public DateTime EnrolImentDate { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 


id Özelliği bu sınıfa karşılık gelen veritabanı (DB) tablosunun birincil anahtar sütunu duruma gelir.Varsayılan 
olarak EF Core adlı bir özellik yorumlar id veya ciassnameiD birincil anahtar olarak, içinde ciassnameiD , 


elassname sınıf adıdır. Alternatif birincil anahtarı otomatik olarak kabul edilen studentiD önceki örnekte. 


Enrollments Özelliği bir gezinti özelliği. Gezinti özellikleri bu varlıkla ilgili diğer varlıkları bağlayın. Bu durumda, 
Enrollments özelliği bir student entity tüm tutan Enroiiment olarak ilişkili varlıkları Student . Örneğin, bir 
öğrenci satır DB'de iki kayıt satırları ilgili olan Enrollments gezinti özelliği içerir, bu iki Enroiiment varlıklar, ilgili 
Enroiiment satırdır bu öğrencinin birincil anahtar değerini içeren bir satır studentiD sütun. Örneğin, Öğrenci 


kimlikli varsayalım = 1 olan iki satır 

Enrollment 

tablo. 

Enrollment 

Tablosunda var olan iki satır 

StudentiD 


studentiD içinde bir yabancı anahtar Enroiiment içinde Öğrenci belirten tablo student tablo. 

Bir gezinme özelliği birden çok varlık tutarsanız gezinme özelliğini bir liste türü gibi olmalıdır ıcoiiection<T> . 
ıcoiiection<T> belirtilebilir, ya da bir tür gibi List<T> veya HashSet<T> . Zaman ıcoiiection<T> olduğu EF Core 
kullanıldığında, oluşturur bir HashSet<T> varsayılan olarak koleksiyon. Birden çok varlık tutun Gezinti özellikleri 
çoktan çoğa ve bire çok ilişkileri gelir. 


Kayıt varlık 


Enrollment 


Properties 
yî EnrolImentlD 
A CourselD 
A StudentiD 
A Grade 

Navigation Properties 
Course 
P Student 


İçinde modelleri klasör oluşturma Enrollment.es aşağıdaki kod ile: 


































namespace Contosollniversity .Models 
{ 

public enum Grade 
{ 

A, Bj C, D, F 

} 

public class Enrollment 
{ 

public int EnrollmentlD { get; set; } 
public int CourselD { get; set; } 
public int StudentlD { get; set; } 
public Grade? Grade { get; set; } 

public Course Course { get; set; } 
public Student Student { get; set; } 

} 

} 

EnrollmentlD Birincil anahtar özelliğidir. Bu varlığı kullanan ciassnameiD yerine desen id gibi student varlık. 
Genellikle geliştiriciler bir düzen seçin ve veri modelini kullanın. Bir sonraki öğreticide, classname Kimliğini 
kullanarak, veri modelinde aktarma uygulamak daha kolay hale getirmek için gösterilir. 

Grade Özelliği bir enum . Sonra soru işareti Grade türü bildirimi gösterir Grade özelliği boş değer atanabilir. Boş 
bir sınıf bir sıfır sınıf farklı—null anlamına gelir bir sınıf bilinen değil veya henüz atanmamış. 


studentiD Özelliği olduğundan yabancı anahtar ve karşılık gelen gezinme özelliğini student .Bir Enrollment 
varlıktır biriyle ilişkili student tek bir özellik içerecek şekilde varlık student varlık, student Varlık farklıdır 
student.Enroiiments içeren birden çok gezinti özelliği Enrollment varlıklar. 


CourselD Özelliği olduğundan yabancı anahtar ve karşılık gelen gezinme özelliğini course . Bir Enrollment varlıktır 
biriyle ilişkili course varlık. 


EF Core adlandırılmışsa, bu özellik bir yabancı anahtar olarak yorumlar 

cnavigation property namexprimary key property name> . Örneğin, StudentlD için Student gezinti Özelliği bu yana 
student varlığın birincil anahtarı id . Yabancı anahtar özellikleri de adı <primary key property name> .Örneğin, 
CourselD beri course varlığın birincil anahtarı CourselD . 


Kurs varlık 


Course 


Properties 
y? CourselD 
A Title 
A Credits 

Navigation Properties 
y3 Enrollments 


İçinde modelleri klasör oluşturma Course.cs aşağıdaki kod ile: 































using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 
{ 

public class Course 
{ 

[DatabaseGenerated(DatabaseGeneratedOption.None)] 
public int CourselD { get; set; } 
public string Title { get; set; } 
public int Credits { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 

Enrollments Özelliktir bir gezinme özelliği. A course varlık dilediğiniz sayıda ilgili olabileceğini Enroiiment 
varlıklar. 

DatabaseGenerated DB sahip, oluşturmak, yerine özniteliği birincil anahtarı belirtmek için uygulamayı sağlar. 

İskele Öğrenci modeli 

Bu bölümde, Öğrenci modeli iskele kurulmuş. Diğer bir deyişle, yapı iskelesi aracı sayfaları için oluşturma, okuma, 
güncelleştirme ve silme (CRUD) işlemlerine yönelik Öğrenci modeli oluşturur. 

• Projeyi oluşturun. 

• Oluşturma sayfalart/Öğrenciler klasör. 

• Visual Studio 

• Visual Studio Code 

• içinde Çözüm Gezgini, sağ tıklayın sayfaları/Öğrenciler klasör > Ekle > yeni iskele kurulmuş öğe. 

• içinde İskele Ekle iletişim kutusunda Entity Framevvork (CRU D) kullanarak Razor sayfaları > ekleme. 

Tamamlamak ekleme Razor sayfaları (CRUD) Entity Framevvork kullanarak iletişim: 

• içinde Model sınıfı açılan listesinde, select Öğrenci (ContosoUniversity.Models). 

• içinde veri bağlamı sınıfının satır, select + (artı) oturum açın ve oluşturulan bir adla değiştirin 

ContosoUniversity.Models.SchoolContext. 

• içinde veri bağlamı sınıfının açılan listesinde, select ContosoUniversity.Models.SchoolContext 

• Add (Ekle) seçeneğini belirleyin. 





Add Razor Pages using Entity Framevvork (CRUD) 


X 


Generates Razor Pages using Entity Framevvork for; Create, Delete, Details, Edit and List operations forthe 
selected model. 


Model elass: 

Student (ContosoUniversity.Models) 

V 




Data context elass: 

ContosoUniversity.Models.SchoolContext 

□ E] 


Options 

J Create as a partial view 
[71 Reference script libraries 
[7] Use a layout page: 


(Leave empty if it is set in a Razor _viewstart file) 


Add Cancel 


Bkz: film modeli iskelesini önceki adımı ile ilgili bir sorun varsa, 
iskele işlem oluşturulur ve aşağıdaki dosya değişti: 

Oluşturulan dosyalar 

• Sayfa/Öğrenciler oluşturma, silme, Ayrıntılar, düzenleme, dizin. 

• Data/SchoolContext.cs 

Dosya güncelleştirmeleri 

• Startup.es : Bu dosyada yapılan değişiklikler sonraki bölümde ayrıntılı. 

• appSettings.JSON : yerel bir veritabanına bağlanmak için kullanılan bağlantı dizesi eklenir. 

Bağımlılık ekleme ile kayıtlı bağlamını İnceleme 

ASP.NET Core ile oluşturulmuş bağımlılık ekleme. Hizmetler (örneğin, EF Core DB bağlamı), uygulama başlatma 
sırasında bağımlılık ekleme ile kaydedilir. Bu hizmetler (örneğin, Razor sayfaları) gerektiren bileşenler bu hizmetler 
Oluşturucu parametresi üzerinden sağlanır. Bir db bağlamı örneği alır Oluşturucu kodu öğreticinin ilerleyen 
bölümlerinde gösterilmektedir. 

Yapı iskelesi aracı otomatik olarak oluşturulmuş bir veritabanı bağlamını ve bağımlılık ekleme kapsayıcısını ile 
kayıtlı. 

inceleme configureServices yönteminde Startup.es. Vurgulanan satırı iskele kurucu tarafından eklendi: 















public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

// This lambda determines whether user consent for 
//non -essential cookies is needed for a given request. 
options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_l); 

Services.AddDbContext<SchoolContext>(options => 

options.UseSqlServer(Configuration.GetConnectionString("SchoolContext"))); 

} 


Bağlantı dizesi adı için bağlam üzerinde bir yöntemi çağırarak geçirilen bir DbContextOptions nesne. Yerel 
geliştirme için AS P.N ET Core yapılandırma sistemi bağlantı dizesinden okur appsettings.json dosya. 

Ana güncelleştir 

İçinde Program.es, değişiklik Main yöntemi aşağıdakileri yapmak için: 

• Bir DB bağlamı örneği bağımlılık ekleme kapsayıcısını alın. 

• Çağrı EnsureCreated. 

• Bağlam dispose olduğunda EnsureCreated yöntemi tamamlar. 

Aşağıdaki kod güncelleştirilmiş gösterir Program.es dosya. 




using ContosoUniversity.Models; 
using Microsoft.AspNetCore; 
using Microsoft.AspNetCore.Hosting; 
using Microsoft.Extensions.Dependencylnjection; 
using Microsoft.Extensions.Logging; 
using System; 

namespace ContosoUniversity 

{ 

public class Program 

{ 

public static void Main(string[] args) 

{ 

var hoşt = CreateWebHostBuilder(args).Build(); 

using (var scope = hoşt.Services.CreateScope()) 

{ 

var Services = scope.ServiceProvider; 


// SchoolContext 


// CreateScope 


try 

{ 

var context = Services.GetRequiredService<SchoolContext>(); 
context.Database.EnsureCreated(); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<ILogger<Program>>(); 
logger.LogError(ex, "An error occurred creating the DB."); 

} 


host.Run(); 

} 


} 


public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 
1 /JebHost .CreateDefaultBuilder(args) 

.UseStartup<Startup>(); 


} 


EnsureCreated Veritabanı bağlamının var olmasını sağlar. Varsa, hiçbir işlem yapılmaz. Yoksa, veritabanı ve tüm 
şema oluşturulur. EnsureCreated veritabanı oluşturmaya geçişleri kullanmaz, ile oluşturulmuş bir veritabanı 
EnsureCreated daha sonra geçişleri kullanılarak güncelleştirilemez. 


EnsureCreated Aşağıdaki iş akışı sağlayan uygulama Başlat menüsünde çağrılır: 


• DB silin. 

• DB şema değiştirme (örneğin, bir EmailAddress alan). 

• Uygulamayı çalıştırın. 



kullanılır. 


Uygulamayı test etme 

Uygulamayı çalıştırın ve tanımlama bilgisi ilkesini kabul edin. Bu uygulama, kişisel bilgileri tutmak değil. Tanımlama 
bilgisi ilkesi hakkında bilgi edinebilirsiniz AB genel veri koruma yönetmeliği (GDPR) Destek. 

• Seçin Öğrenciler bağlantısını ve ardından Yeni Oluştur. 

• Ayrıntılar, düzenleme, test edin ve bağlantılarını silin. 









SchoolContext DB bağlamını İnceleme 

Verilen veri modeli için EF Core işlevselliği koordine eden ana DB bağlamı sınıfının sınıftır. Veri bağlamı türetilir 
Microsoft.EntityFrameworkCore.DbContext. Veri bağlamı, hangi varlıkları veri modelinde yer alan belirtir. Bu 
projede adlı sınıfı schooicontext . 

Güncelleştirme SchoolContext.cs aşağıdaki kod ile: 

using Microsoft.EntityFrameworkCore; 

namespace ContosoUniversity.Models 
{ 

public class SchoolContext : DbContext 
{ 

public SchoolContext(DbContextOptions<SchoolContext> options) 

: base(options) 

{ 

} 

public DbSet<Student> Student { get; set; } 
public DbSet<Enrollment> Enrollment { get; set; } 
public DbSet<Course> Course { get; set; } 

} 

} 

Vurgulanan kod oluşturur bir olan DB<TEntity > her varlık kümesi özelliği. EF Core terminolojisinde: 


• Bir varlık kümesini genellikle DB tabloya karşılık gelir. 

• Bir varlık tablosunda bir satıra karşılık gelir. 



SQL Server Express LocalDB 

Bağlantı dizesini belirtir SQL Server LocalDB. LocalDB, SQL Server Express veritabanı Motoru'nu hafif bir 
sürümüdür ve uygulama geliştirme, üretim kullanımı için tasarlanmıştır. LocalDB, isteğe bağlı olarak başlar ve 
karmaşık yapılandırma olduğundan kullanıcı modunda çalışır. Varsayılan olarak LocalDB oluşturur .mdf DB 
dosyaları C:/Users/<user> dizin. 

Bir veritabanı test verileri ile başlatmak için kod ekleyin 

EF Core boş bir veritabanı oluşturur. Bu bölümde, bir initialize yöntemi test verileriyle doldurma işlemine yazılır, 
içinde veri klasöründe adlı yeni bir sınıf dosyası oluşturma Dblnitializer.es ve aşağıdaki kodu ekleyin: 

using ContosoUniversity.Models; 
using System; 
using System.Linq; 

namespace ContosoUniversity.Models 
{ 

public static class Dblnitializer 
{ 

public static void Initialize(SchoolContext context) 

{ 

context.Database.EnsureCreated(); 

// Look for any students. 
if (context.Student.Any()) 















I 

return; // DB has been seeded 

> 

var students = new Student[] 

{ 

new Student{FirstMidName="Carson",LastName="Alexander",EnrollmentDate=DateTime.Parse("2005-09- 

01 ")}, 

new Student{FirstMidName="Meredith",LastName="Alonso",EnrollmentDate=DateTime.Parse("2002-09-01")} 
new Student{FirstMidName="Arturo",LastName="Anand",EnrollmentDate=DateTime.Parse("2003-09-01")}, 
new Student{FirstMidName="Gytis",LastName="Barzdukas",EnrollmentDate=DateTime.Parse("2002-09-01")} 
new Student{FirstMidName="Yan",LastName="Li",EnrollmentDate=DateTime.Parse("2002-09-01")}, 
new Student{FirstMidName="Peggy",LastName="lustice",EnrollmentDate=DateTime.Parse("2001-09-01")}, 
new Student{FirstMidName="Laura",LastName="Norman",EnrollmentDate=DateTime.Parse("2003-09-01")}, 
new Student{FirstMidName="Nino", Lastl\lame="01ivetto", EnrollmentDate=DateTime. Parse( "2005-09-01")} 

}; 

foreach (Student s in students) 

{ 

context.Student.Add(s); 

} 

context.SaveChanges(); 

var courses = new Course[] 

{ 

new Course{CourseID=1050,Title="Chemistry",Credits=3}, 
new Course{CourseID=4022,Title="Microeconomics",Credits=3}, 
new Course{CourseID=4041,Title="Macroeconomics",Credits=3}, 
new Course{CourseID=1045,Title="Calculus",Credits=4}, 
new Course{CourseID=3141,Title="Trigonometry",Credits=4}, 
new Course{CourseID=2021,Title="Composition",Credits=3}, 
new Course{CourseID=2042,Title="Literature",Credits=4} 

}; 

foreach (Course c in courses) 

{ 

context.Course.Add(c); 

} 

context.SaveChanges(); 

var enrollments = new Enrollment[] 

{ 

new Enrollment{StudentID=l,CourseID=1050,Grade=Grade.A}, 
new Enrollment{StudentID=l,CourseID=4022,Grade=Grade.C}, 
new Enrollment{StudentID=l,CourseID=4041,Grade=Grade.B}, 
new Enrollment{StudentID=2,CourseID=1045,Grade=Grade.B}, 
new Enrollment{StudentID=2,CourseID=3141,Grade=Grade.F}, 
new Enrollment{StudentID=2,CourseID=2021,Grade=Grade.F}, 
new Enrollment{StudentID=3,CourseID=1050}, 
new Enrollment{StudentID=4,CourseID=1050}, 
new Enrollment{StudentID=4,CourseID=4022,Grade=Grade.F}, 
new Enrollment{StudentID=5,CourseID=4041,Grade=Grade.C}, 
new Enrollment{StudentID=6,CourseID=1045}, 
new Enrollment{StudentID=7,CourseID=3141,Grade=Grade.A}, 

}; 

foreach (Enrollment e in enrollments) 

{ 

context.Enrollment.Add(e); 

} 

context.SaveChanges(); 

} 

} 

} 

Note: Yukarıdaki kod Data yerine ad alanı ( 

scaffolder tarafından oluşturulan kodla tutarlıdır. Daha fazla bilgi için bkz. GitHub yapı iskelesi sorunu. 

Kod DB'de tüm Öğrenciler olup olmadığını denetler. DB'de Öğrenci varsa, bir veritabanı test verileri ile başlatılır. 
Diziye test verileri yükler yerine List<T> performansını iyileştirmek için koleksiyonları. 


namespace ContosoLIniversity .Models 

) için 

Models 

kullanır. 

Models 







EnsureCreated Yöntemi DB bağlamı için bir veritabanı otomatik olarak oluşturur.Veritabanı varsa, EnsureCreated 
DB değiştirmeden döndürür. 


içinde Program.es, değişiklik Main çağrılacak yöntem initialize : 


public elass Program 
{ 

public static void Main(string[] args) 

{ 

var hoşt = CreateWebHostBuilder(args).Build(); 

using (var scope = hoşt.Services.CreateScope()) 

{ 

var Services = scope.ServiceProvider; 

try 

{ 

var context = Services.GetRequiredService<SchoolContext>(); 

// using ContosoUniversity.Data; 

Dblnitializer.initialize(context); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<ILogger<Program>>(); 
logger.LogError(ex, "An error occurred creating the DB."); 

} 

} 

host.Run(); 

} 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 
WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>(); 

} 


• Visual Studio 

• Visual Studio Code 

Çalışıyorsa uygulamayı durdurun ve Paket Yöneticisi konsolunda (PMC) aşağıdaki komutu çalıştırın: 

Drop-Database 


DB görüntüleyin 

Veritabanı adı, daha önce belirttiğiniz bağlam adından ve bir tire ve bir GUID ile oluşturulur. Bu nedenle, veritabanı 
adı "SchoolContext-{GUID}" olacaktır. GUID her kullanıcı için farklı olacaktır.Açık SQL Server Nesne Gezgini 
(SSOX) öğesinden görünümü Visual Studio'daki menü. SSOX 'te, (LocalDB) \MSSQLLocalDB > veritabanları 
> SchoolContext-{GU İD} 1 a tıklayın. 

Genişletin tabloları düğümü. 

Sağ Öğrenci tablosu ve'ı tıklatın görünüm verilerini oluşturulan sütunları ve tabloya eklenen satırları 
görebilirsiniz. 

Zaman uyumsuz kod 

Zaman uyumsuz programlama, ASP.NET Core ve EF Core için varsayılan moddur. 


Sınırlı sayıda iş parçacığı kullanılabilir bir web sunucusuna sahip ve yüksek yük durumlarda tüm kullanılabilir iş 








parçacıklarının kullanımda olabilir. Bu durum oluştuğunda, sunucunun iş parçacıklarının serbest bırakılana kadar 
yeni istekleri işleyemiyor. G/ç tamamlanması bekleniyor çünkü bunlar herhangi bir iş gerçekten yapmamanız 
sırasında eş zamanlı kod ile birçok iş parçacığı bağlanması, işlemi tamamlamak, g/ç için beklerken zaman uyumsuz 
kod ile diğer istekleri işlemek için kullanılacak sunucuyu için kendi iş parçacığı serbest bırakılır. Sonuç olarak, 
sunucu kaynaklarının daha etkin kullanılması zaman uyumsuz kod sağlar ve sunucu gecikmeler olmadan daha fazla 
trafik işlemek için etkinleştirilir. 

Zaman uyumsuz kod, çalışma zamanında az miktarda bir ek yükü sunar. Düşük trafiğe durumlar, performans 
düşüşüne yüksek trafik durumlar için göz ardı edilebilir, çalışırken, olası performans geliştirmesi önemli. 

Aşağıdaki kodda, zaman uyumsuz anahtar sözcüğü, Task<T> dönüş değeri, await anahtar sözcüğü ve 
ToListAsync yöntemi zaman uyumsuz yürütülen kod olun. 

public async Task OnGetAsync() 

{ 

Student = await _context.Student.ToListAsync(); 

} 

• async Anahtar sözcüğü, derleyiciye bildirir: 

o Yöntem gövdesini bölümleri için geri çağırmaları oluşturur. 

o Otomatik olarak oluşturmasını görev döndürülen nesne. Daha fazla bilgi için görev dönüş türü. 

• Örtük dönüş türü Task devam eden çalışmayı temsil eder. 

• await Anahtar sözcüğü, derleyicinin yöntemin iki parçalara bölmek neden olur. İlk bölüm ile zaman 
uyumsuz olarak başlatıldığında işlemi sonlandırır. ikinci bölümü, işlemi tamamlandıktan sonra çağrılan bir 
geri çağırma yöntemi yerleştirilir. 

• ToListAsync zaman uyumsuz sürümüdür ToList genişletme yöntemi. 

EF Core kullanan zaman uyumsuz kodu yazarken dikkat edilmesi gereken bazı noktalar şunlardır: 

• Sorguları veya Veritabanına gönderilecek komutları neden deyimleri zaman uyumsuz olarak yürütülür, içeren, 

ToListAsync , SingleOnDefaultAsync , FinstOnDefaultAsync , ve SaveChangesAsync . Yalnızca değiştirmek deyimleri 
içermeyen bir IQueryable , g İ bi var students = context.Students.Where(s => s.LastName == "Davolio") . 

• EF Core bağlam iş parçacığı güvenli olmayan: paralel birden çok işlem yapmak yeniden denemeyin. 

• Zaman uyumsuz kodun performans avantajlarından yararlanmak için bunlar için bir veritabanı sorguları 
göndermek EF Core yöntemleri çağırırsanız kitaplığı paketlerinin (disk belleği sunamıyoruz gibi) zaman 
uyumsuz kullandığını doğrulayın. 

. N ET'te zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. zaman uyumsuz genel bakış ve zaman 
uyumsuz programlama ile async ve await. 

Sonraki öğreticide, temel CRUD (oluşturma, okuma, güncelleştirme ve silme) işlemleri incelenir. 

Ek kaynaklar 

• Bu öğreticinin YouTube sürümü 
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ASPNET Core-CRUD-2 1 de EF Core ile Razor Pages 

20.08.2019 • 34 minutes to read ı Edit Online 


, Tom Dykstra, Jon P Smithve Rick Anderson 

Contoso Üniversitesi web uygulaması, EF Core ve Visual Studio kullanarak Razor Pages Web uygulamaları 
oluşturmayı gösterir. Öğretici serisi hakkında daha fazla bilgi için ilk öğreticiyebakın. 

Çözemediğiniz sorunlarla karşılaşırsanız, Tamamlanmış uygulamayı indirin ve öğreticiyi izleyerek bu kodu 
oluşturduğunuz şekilde karşılaştırın. 

Bu öğreticide, scafkatan CRUD (oluşturma, okuma, güncelleştirme, silme) kodu incelenir ve özelleştirilir. 

Depo yok 

Bazı geliştiriciler, Kullanıcı arabirimi (Razor Pages) ve veri erişim katmanı arasında bir soyutlama katmanı 
oluşturmak için bir hizmet katmanı veya depo deseninin kullanılmasını sağlar. Bu öğretici bunu yapmaz. 
Karmaşıklığı en aza indirmek ve öğreticiyi EF Core odaklanmasını sağlamak için EF Core kodu doğrudan sayfa 
modeli sınıflarına eklenir. 

Ayrıntılar sayfasını Güncelleştir 

Öğrenciler sayfaları için yapı iskelesi kodu kayıt verilerini içermez. Bu bölümde, ayrıntılar sayfasına kayıtları 
eklersiniz. 

Kayıtları oku 

Sayfada öğrenciye ait kayıt verilerini göstermek için, onu okumanız gerekir. Pages/öğrenciler/details. cshtml. cs 
içindeki scafkatlama kodu, kayıt verileri olmadan yalnızca öğrenci verilerini okur: 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Student = await _context.Students.FirstOrDefaultAsync(m => m.ID == id); 

if (Student == null) 

{ 

return NotFound(); 

} 

return Page(); 

} 

onGetAsync Yöntemi, seçili öğrenci için kayıt verilerini okumak üzere aşağıdaki kodla değiştirin. Değişiklikler 
vurgulanır. 




public async Task<IActionResult> OnGetAsync(int? id) 
{ 

if (id == null) 

{ 

return NotFound(); 

} 

Student = await _context.Students 
.Include(s => s.Enrollments) 

.Thenlnclude(e => e.Course) 

.AsNoTracking() 

.FirstOrDefaultAsync(m => m.ID == id); 

if (Student == null) 

{ 

return NotFound(); 

} 

return Page(); 

} 


Inciude ve thenmclude yöntemleri, içeriğin student.Enrollments gezinti özelliğini yüklemesine ve her 
Enroiiment.course kaydın gezinti özelliği içine olmasına neden olur. Bu yöntemler, okuma ilgili verileri öğreticisinde 
ayrıntılı olarak incelendi. 

Asnotracking yöntemi, döndürülen varlıkların geçerli bağlamda güncelleştirilmediği senaryolarda performansı 
geliştirir. AsNoîracking Bu öğreticinin ilerleyen kısımlarında ele alınmıştır. 

Kayıtları görüntüle 

Sayfalar/öğrenciler/details. cshtml içindeki kodu aşağıdaki kodla değiştirin ve kayıtlar listesini görüntüleyin. 
Değişiklikler vurgulanır. 








@page 

@model ContosoUniversity.Pages.Students.DetailsModel 

@{ 

ViewData["Title"] = "Details"; 

} 

<hl>Details</hl> 

<div> 

<h4>Student</h4> 

<hr /> 

<dl class="row"> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Student.LastName) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Student.LastName) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Student.FirstMidName) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Student.FirstMidName) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Student.EnrollmentDate) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model = > model.Student.EnrollmentDate) 

</dd> 

<dt class="col-sm-2"> 

@Fltml.DlsplayNameFor(model => model.Student. Enrollments) 

</dt> 

<dd class="col-sm-10"> 
ctable class="table"> 

<tr> 

<th>Course Title</th> 

<th>Grade</th> 

</tr> 

@foreach (var item in Model.Student.Enrollments) 

{ 

<tr> 

<td> 

@Fltml.DisplayFor(modelItem => item.Course.Title) 

</td> 

<td> 

@Fltml.DisplayFor(modelItem => item.Grade) 

</td> 

</tr> 

} 

</table> 

</dd> 

</dl> 

</div> 

<div> 

<a asp-page="./Edit" asp-route-id="@Model.Student.ID">Edit</a> | 

<a asp-page="./Index">Back to List</a> 

</div> 

Yukarıdaki kod, Enrollments Gezinti özelliğindeki varlıklar aracılığıyla döngü başlatır. Her kayıt için kurs başlığını ve 
sınıfı görüntüler. Kurs başlığı, kayıt varlığının course gezinti özelliğinde depolanan kurs varlığından alınır. 

Uygulamayı çalıştırın, öğrenciler sekmesini seçin ve bir öğrenci için Ayrıntılar bağlantısına tıklayın. Seçili öğrenci 
için Kurslar ve notlar listesi görüntülenir. 





Bir varlığı okuma yolları 

Oluşturulan kod, bir varlığı okumak için Firstordefaultasync kullanır. Bu yöntem, hiçbir şey bulunamazsa null 
değerini döndürür; Aksi takdirde, sorgu filtresi ölçütlerine uyan bulunan ilk satırı döndürür. FirstorDefaultAsync 
genellikle aşağıdaki alternatiflere göre daha iyi bir seçimdir: 

• Singleordefaultasync -sorgu filtresini karşılayan birden fazla varlık varsa bir özel durum oluşturur.Sorgu 
tarafından birden fazla satır döndürülüp döndürülmeyeceğini anlamak için birden çok satır getirmeyi 

singleOrDefaultAsync dener. Sorgu yalnızca bir varlık döndürebiliyorsanız ve benzersiz bir anahtarda arama 
yaptığında bu ek çalışma gereksizdir. 

• Findadsync -birincil ANAHTARLA (PK) bir varlık bulur.PK 'ye sahip bir varlık bağlam tarafından izleniyorsa, 
veritabanına bir istek olmadan döndürülür. Bu yöntem tek bir varlık aramak için en iyi duruma getirilmiştir, ancak 
ile inciude FindAsync çağrılamaz. Bu nedenle, ilgili veriler gerekliyse, FirstonDefaultAsync daha iyi bir seçimdir. 

Veri yönlendirme ve sorgu dizesi karşılaştırması 

Ayrıntılar sayfasının https://iocaihost:<port>/students/Detaiis?id=ı URL 'si. Varlığın birincil anahtar değeri, sorgu 
dizesinde bulunur. Bazı geliştiriciler anahtar değerini rota verilerinde geçirmeye tercih eder: 
https://iocaihost:<port>/students/Details/ı . Daha fazla bilgi için bkz. oluşturulan kodu güncelleştirme. 

Oluştur sayfasını Güncelleştir 

Oluşturma sayfası için yapı onPostAsync iskelesi kodu, aşırı nakmeaçıktır. Pages/öğrenciler/Create. cshtml. cs 
içindeki yöntemiaşağıdakikodladeğiştirin. OnPostAsync 

public async Task<IActionResult> OnPostAsync() 

{ 

var emptyStudent = new Student(); 

if (await TryUpdateModelAsync<Student>( 
emptyStudent , 

"student"., // Prefix for form value. 

s => s.FirstMidName, s => s.LastName, s => s.EnrollmentDate)) 

{ 

_context.Students.Add(emptyStudent); 
await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

return Page(); 

} 

TryU pdate M odel Async 

Yukarıdaki kod bir öğrenci nesnesi oluşturur ve ardından, öğrenci nesnesinin özelliklerini güncelleştirmek için, 
postalanan form alanlarını kullanır. Tryupdatemodelasync yöntemi: 

• Pagemodellçindeki pagecontext özelliğinden gönderilen form değerlerini kullanır. 

• Yalnızca listelenen ( s => s.FirstMidName, s => s.LastName, s => s.EnrollmentDate ) özellikleri güncelleştirir. 

• "Öğrenci" ön ekine sahip form alanlarını arar.Örneğin: student.FirstMidName . Büyük/küçük harfe duyarlı 
değildir. 

• , Dizelerdeki form değerlerini student modeldeki türlere dönüştürmek için model bağlama sistemini kullanır. 
Örneğin, EnrollmentDate DateTime 'a dönüştürülmesi gerekir. 

Uygulamayı çalıştırın ve oluştur sayfasını test etmek için bir öğrenci varlığı oluşturun. 

Fazla nakil 

Deftere TryupdateModei nakledilen değerler içeren alanları güncelleştirmek için kullanmak, aşırı nakletmeyi önlediği 
















için en iyi güvenlik yöntemidir. Örneğin, öğrenci varlığının bu Web sayfasının güncelleştirmesi veya secret 
eklemesi gereken bir özelliği içerdiğini varsayalım: 


public class Student 

{ 

public int ID { get; set; } 
public string LastName { get; set; } 
public string FirstMidName { get; set; } 
public DateTime EnrollmentDate { get; set; } 
public string Secret { get; set; } 

} 


Uygulama, oluşturma veya güncelleştirme Razor sayfasında secret bir alana sahip olmasa da, bir korsan secret 
değeri aşırı nakme ile ayarlayabilir. Bir korsan, Fiddler gibi bir araç kullanabilir veya bir secret form değeri 
göndermek için bazı JavaScript yazabilir. Özgün kod, bir öğrenci örneği oluştururken model cildin kullandığı 
alanları sınırlamaz. 


secret Form alanı için belirtilen korsanın hangi değeri veritabanında güncelleştirildiği. Aşağıdaki görüntüde, alanı 
("overpost" değeri ile secret ), postalanan form değerlerine ekleyen Fiddler aracı gösterilmektedir. 


(2) Statistics & Inspectors f AutoResponder ^ Composer Q Fllters 0 Log — Timeline 


Usethls pageto compose a Request. You can done a priorrequestby dragglng and dropping a sesslonfromthe 1 
Web Sessions list. 
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POST 

V 

http://localhost: 1236/Student/Create 

V 

HTTP/1.1 

V 


ReguestHeaders 

[ Upload file... ] 

Help... 


Hoşt: localhost: 1236 

User-Agent: Mozilla/5.0 (Windows MI 6.2; W0W64; rv:22.0) Gecko/2CU00101Firefox/22.0 

Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/'‘;q=0.8 

Accept-language: en-US,en;q=0.5 

Accept-Encoding: gzip, deflate 

Referer: http://localhost: 1236/Student/Create 

Cookie: RequestVerificationToken =-OqMEtdNIwFGDdjHUS_-XDoOSCqS 1515g7ASzrFKwQPjpxRT2hN_tm6pDZbS0HVVTGMr 

Connection: keep-alive 

Content-Type: applica6on/x-www-fbrm-urlencoded 
Content-Length: 227 


< > 


RequestBody 

slâLastName=Smith&FirstMidName=Joe&EnrollmentDate=7%2F31%2F2013+4%3A58%3A234PRfeSecret=OverPost 


"Overpost" değeri eklenen satırın secret özelliğine başarıyla eklendi. Bu durum, Uygulama Tasarımcısı hiçbir 
şekilde secret özelliği oluştur sayfasıyla ayarlamaya yönelik değildir. 

Modeli görüntüle 

Model görüntüleme, fazla nakletmeyi önlemenin alternatif bir yolunu sağlar. 

Uygulama modeli genellikle etki alanı modeli olarak adlandırılır. Etki alanı modeli genellikle veritabanında ilgili 
varlık için gereken tüm özellikleri içerir. Görünüm modeli yalnızca için kullanılan Kullanıcı arabirimi için gereken 
özellikleri içerir (örneğin, oluşturma sayfası). 

Görünüm modeline ek olarak, bazı uygulamalar Razor Pages sayfa modeli sınıfı ve tarayıcı arasında veri geçirmek 
için bir bağlama modeli veya giriş modeli kullanır. 

Aşağıdaki student görünüm modelini göz önünde bulundurun: 




































using System; 

namespace ContosoUniversity.Models 

{ 

public class StudentVM 

{ 

public int ID { get; set; } 
public string LastName { get; set; } 
public stning FirstMidName { get; set; } 
public DateTime EnrollmentDate { get; set; } 

} 


Aşağıdaki kod, yeni bir StudentVM öğrenci oluşturmak için görünüm modelini kullanır: 

[BindProperty] 

public StudentVM StudentVM { get; set; } 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var entry = _context.Add(new Student()); 
entry.CurrentValues.SetValues(StudentVM); 
await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 


SetValues yöntemi, başka bir PropertyValues nesnesinden değerleri okuyarak bu nesnenin değerlerini ayarlar. 
Setvalues Özellik adı eşleştirme kullanır.Görünüm modeli türünün model türüyle ilgili olması gerekmez, yalnızca 
eşleşen özellikleri olması gerekir. 

Kullanılması StudentVM için StudentVM Create . cshtml kullanılması gerekir, student 

Güncelleştirme düzenleme sayfası 

Sayfalar/öğrenciler/Edit. cshtml. cs' de, onGetAsync ve onPostAsync yöntemlerini aşağıdaki kodla değiştirin. 












public async Task<IActionResult> OnGetAsync(int? id) 
{ 

if (id == null) 

{ 

return NotFound(); 

} 

Student = await _context.Students.FindAsync(id); 

if (Student == null) 

{ 

return NotFound(); 

} 

return Page(); 


public async Task<IActionResult> OnPostAsync(int id) 

{ 

var studentToUpdate = await _context.Students.FindAsync(id); 

if (studentToUpdate == null) 

{ 

return NotFound(); 

} 

if (await TryUpdateModelAsync<Student>( 
studentToUpdate, 

"student", 

s => s.FirstMidName, s => s.LastName, s => s.EnrollmentDate)) 

{ 

await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

return Page(); 

} 


Kod değişiklikleri, birkaç özel durum dışında oluşturma sayfasına benzerdir: 

• FirstorDefaultAsync , F indadsyncile değiştirilmiştir. İlgili verileri dahil etmeniz gerekmiyorsa, FindAsync daha 
etkilidir. 

• onPostAsync bir id parametreye sahiptir. 

• Geçerli öğrenci boş bir öğrenci oluşturmak yerine veritabanından getirilir. 


Uygulamayı çalıştırın ve bir öğrenci oluşturup düzenleyerek test edin. 


Varlık durumları 

Veritabanı bağlamı, bellekteki varlıkların veritabanında karşılık gelen satırlarıyla eşitlenmiş olup olmadığını izler. Bu 
izleme bilgileri, Savechangesasync çağrıldığında ne olacağını belirler. Örneğin, yeni bir varlık Addadsync yöntemine 
geçirildiğinde, bu varlığın durumu eklendiolarak ayarlanır. saveChangesAsync Çağrıldığında, veritabanı bağlamı bir 
SQL INSERT komutu yayınlar. 

Bir varlık aşağıdaki durumlardanbirinde olabilir: 

• Added : Varlık veritabanında henüz yok. Savechanges Yöntemi bir INSERT ifadesini yayınlar. 

• unchanged : Bu varlıkla birlikte hiçbir değişiklik kaydedilmesi gerekmiyor. Bir varlık veritabanından okurken 
bu durumu içerir. 

• Modified : Varlığın özellik değerlerinin bazıları veya tümü değiştirildi. Savechanges Yöntemi bir Update 
ifadesini yayınlar. 













• Deleted : Varlık silinmek üzere işaretlendi. Savechanges Yöntemi bir DELETE ifadesini yayınlar. 

• Detached : Varlık, veritabanı bağlamı tarafından izlenmiyor. 

Bir masaüstü uygulamasında durum değişiklikleri genellikle otomatik olarak ayarlanır. Bir varlık okundu, 
değişiklikler yapılır ve varlık durumu otomatik olarak olarak değiştirilir Modified .Çağıran Savechanges yalnızca 
değiştirilen özellikleri güncelleştiren bir SQL Update bildirisi oluşturur. 

Bir Web uygulamasında, DbContext bir varlığı okur ve bir sayfa işlendikten sonra verileri görüntüler. Bir sayfanın 
onPostAsync yöntemi çağrıldığında, yeni bir Web isteği oluşturulur ve yeni bir örneğine DbContext sahiptir. 
Okuyarak bu yeni bağlamdaki varlığı, masaüstü işlemesini benzetir. 

Silme sayfası 

Bu bölümde, çağrısı Savechanges başarısız olduğunda özel bir hata iletisi uygulayacağınızı görürsünüz. 

Pages/öğrenciler/delete. cshtml. cs dosyasındaki kodu aşağıdaki kodla değiştirin. Değişiklikler vurgulanır ( using 
deyimler temizliği dışında). 

using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.EntityFrameworkCore; 
using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Students 

{ 

public class DeleteModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public DeleteModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Student Student { get; set; } 
public string ErrorMessage { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id, bool? saveChangesError = false) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Student = await _context.Students 
.AsNoTracking() 

.FirstOrDefaultAsync(m => m.ID == id); 

if (Student == null) 

{ 

return NotFound(); 

} 

if (saveChangesError.GetValueOrDefault()) 

{ 

ErrorMessage = "Delete failed. Try again"; 

} 

return Page(); 

} 


...Ut - - 
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{ 

if (id == null) 

{ 

return NotFound(); 

} 

var student = await _context.Students.FindAsync(id); 

if (student == null) 

{ 

return NotFound(); 

} 


} 


} 


} 


try 

{ 


_context.Students.Remove(student); 
await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

catch (DbUpdateException /* ex */) 

{ 

//Log the error (uncomment ex variable name and write a log.) 
return RedirectToAction("./Delete", 

new { id, saveChangesError = true }); 


} 


Yukarıdaki kod, isteğe bağlı parametresini saveChangesError OnGetAsync Yöntem imzasına ekler. saveChangesError 
öğrenci nesnesini silme hatasından sonra yöntemin çağrılıp çağrılmadığını gösterir. Geçici ağ sorunları nedeniyle 
silme işlemi başarısız olabilir. Geçici ağ hataları, veritabanı bulutta olduğunda daha olasıdır.Sil sayfası OnGetAsync 
kullanıcı arabiriminden çağrıldığında parametrefalse'tur. saveChangesError Tarafından çağrıldığında ( silme 
saveChangesError İşlemi başarısız olduğundan), parametresi true olur. OnGetAsync OnPostAsync 


Yöntemi seçili varlığı alır, ardından varlığın durumunu olarak Deleted ayarlamak için Remove yöntemini çağırır. 
OnPostAsync Savechanges Çağrıldığında, bir SQL DELETE komutu oluşturulur. Remove Başarısız olursa: 


• Veritabanı özel durumu yakalandı. 

• Sayfaları OnGetAsync S il yöntemi ile saveChangesError=true çağırılır. 


Razor silme sayfasına bir hata iletisi ekleyin ( Sayfalar/öğrenciler/delete. cshtml ): 












@page 

@model ContosoUniversity.Pages.Students.DeleteModel 

@{ 

ViewData["Title"] = "Delete"; 

} 

<hl>Delete</hl> 

<p class="text-danger">@Model.ErrorMessage</p> 

<hB>Are you sure you want to delete this?</h3> 

<div> 

<h4>Student</h4> 

<hr /> 

<dl class="row"> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Student.LastName) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Student.LastName) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Student.FirstMidName) 
</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Student.FirstMidName) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Student.EnrollmentDate) 
</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model = > model.Student.EnrollmentDate) 
</dd> 

</dl> 

<form method="post"> 

<input type="hidden" asp-for="Student.ID" /> 

<input type="submit" value="Delete" class="btn btn-danger" /> | 
<a asp-page="./Index">Back to List</a> 

</form> 

</div> 


Uygulamayı çalıştırın ve Sil sayfasını test etmek için bir öğrenci silin. 

Sonraki adımlar 


ÖNCEKİ ■ SONRAKİ 

ÖĞRETİCİ ■ ÖĞRETİCİ 


Bu öğreticide, scafkatan CRUD (oluşturma, okuma, güncelleştirme, silme) kodu incelenir ve özelleştirilir. 

Karmaşıklığı en aza indirmek ve bu öğreticilerin EF Core odaklanmasını sağlamak için, EF Core kod sayfa 
modellerinde kullanılır. Bazı geliştiriciler, Kullanıcı arabirimi (Razor Pages) ve veri erişim katmanı arasında bir 
soyutlama katmanı oluşturmak için bir hizmet katmanını veya depo modelini kullanır. 

Bu öğreticide, öğrenciler klasöründeki oluşturma, düzenleme, silme ve Ayrıntılar Razor Pages incelenir. 

Scafkatlanmış kod, sayfa oluşturma, düzenleme ve silme için aşağıdaki kalıbı kullanır: 

• HTTP G ET yöntemiyle onGetAsync istenen verileri alın ve görüntüleyin. 







• HTTP POST yöntemiyle onPostAsync verilerde yapılan değişiklikleri kaydedin. 

Dizin ve ayrıntı sayfaları, HTTP GET yöntemiyle istenen verileri alır ve görüntüler onGetAsync 

SingleOrDefaultAsync ile FirstOrDefaultAsync 

Oluşturulan kod, genellikle Singleordefaultasyncüzerinden tercih edilen firstordefaultasynckullanır. 
FirstOrDefaultAsync , bir varlık getirenden SingleOrDefaultAsync daha verimlidir: 

• Kodun sorgudan döndürülen birden fazla varlık olmadığını doğrulaması gerekmiyorsa. 

• SingleOrDefaultAsync daha fazla veri getirir ve gereksiz işler. 

• SingleOrDefaultAsync Filtre bölümüne uyan birden fazla varlık varsa bir özel durum oluşturur. 

• FirstOrDefaultAsync Filtre bölümüne uyan birden fazla varlık varsa oluşturmaz. 

Findadsync 

Yapı iskelesi kodunun büyük bir kısmında, yerine Findadsync kullanılabilir FirstOrDefaultAsync . 

FindAsync : 

• Birincil anahtarla (PK) bir varlık bulur. PK 'ye sahip bir varlık bağlam tarafından izleniyorsa, VERITABANıNA bir 
istek olmadan döndürülür. 

• Basittir ve kısadır. 

• Tek bir varlığı aramak için iyileştirilmiştir. 

• Bazı durumlarda performans avantajlarına sahip olabilir, ancak tipik Web uygulamaları için nadiren meydana 
gelir. 

• , Maleasyncyerine dolaylı olarak firstasync kullanır. 

Ancak inciude başka varlıklar FindAsync istiyorsanız artık uygun değildir. Bu, uygulamanız ilerledikçe bir sorguyu 
iptal FindAsync etmeniz ve bir sorguya taşımanız gerekebileceği anlamına gelir. 

Ayrıntılar sayfasını özelleştirme 


Pages/students Sayfaya gidin. Düzenle, Ayrıntılarve Sil bağlantıları, Sayfalar/öğrenciler/lnclex. cshtml 
dosyasındaki tutturucu etiketi Yardımcısı tarafından oluşturulur. 


<td> 



<a 

asp-page=" 

./Edit" asp-route-id="@item.ID">Edit</a> | 

<a 

asp-page=" 

./Details" asp-route-id="@item.ID">Details</a> | 

<a 

asp-page=" 

./Delete" asp-route-id="@item.ID">Delete</a> 

</td> 




Uygulamayı çalıştırın ve bir Ayrıntılar bağlantısı seçin. URL, formundadır 

http://iocaihost:5000/students/Detaiis?id=2 .Öğrenci KİMLİĞİ bir sorgu dizesi ( ?id =2 ) kullanılarak geçirilir. 

"{idrint}" Yol şablonunu kullanmak için düzenleme, Ayrıntılar ve silme Razor Pages güncelleştirin. Bu sayfaların 
her biri için Page yönergesini ' den @page 'e @page "{id:int}" değiştirin. 

Bir tamsayı yol değeri içermeyen "{id: Int}" yol şablonuna sahip sayfaya yönelik bir İstek, HTTP 404 (bulunamadı) 
hatası döndürüyor. Örneğin, http://iocaihost:5000/students/Detaiis 404 hatası döndürür. Kimliği isteğe bağlı 
yapmak için yol kısıtlamasına ? ekleyin: 

@page "{id:int?}" 

Uygulamayı çalıştırın, Ayrıntılar bağlantısına tıklayın ve URL 'nin KİMLİĞİ yönlendirme verileri ( 

















http://iocaihost:5000/students/Detaiis/2 ) olarak geçirdiğini doğrulayın. 

1 I genel @page olarak değiştirmeyin, bunu yaparak giriş bağlantılarını keser ve sayfa oluşturabilirsiniz. 

@page "{id:int}" 

İlgili verileri ekleme 

Öğrenciler dizin sayfasının yapı iskelesi kodu Enroiiments özelliği içermez. Bu bölümde, Enroiiments koleksiyonun 
içeriği ayrıntılar sayfasında görüntülenir. 

Pages/ öğrenciler/details. cshtml. FirstorDefaultAsync CS yöntemi, tek student bir varlığı almak için yöntemini 
kullanır. onGetAsync Aşağıdaki vurgulanmış kodu ekleyin: 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Student = await _context.Student 

.Include(s => s.Enrollments) 

.Thenlnclude(e => e.Counse) 

.AsNoTracking() 

.FirstOrDefaultAsync(m => m.ID == id); 

if (Student == null) 

{ 

return NotFound(); 

} 

return Page(); 

} 

Include ve thenınciude yöntemleri, içeriğin student.Enrollments gezinti özelliğini yüklemesine ve her 
Enroiiment.course kaydın gezinti özelliği içine olmasına neden olur. Bu yöntemler, okuma ile ilgili veri öğreticisinde 
ayrıntılı olarak incelenmelidir. 

Asnotracking yöntemi, döndürülen varlıkların geçerli bağlamda güncelleştirilmediği durumlarda, senaryolarda 
performansı geliştirir. AsNoTracking Bu öğreticinin ilerleyen kısımlarında ele alınmıştır. 

Ayrıntılar sayfasında ilgili kayıtları görüntüleme 

Sayfalan/öğrencileri/ayrmtdarı. cshtml'yl açın. Kayıtlar listesini göstermek için aşağıdaki vurgulanmış kodu ekleyin: 













@page "{id:int}" 

@model ContosoUniversity.Pages.Students.DetailsModel 

@{ 

ViewData["Title"] = "Details"; 

} 

<h2>Details</h2> 

<div> 

<h4>Student</h4> 

<hr /> 

<dl class="dl-horizontal"> 

<dt> 

@Html.DisplayNameFon(model => model.Student.LastName) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Student.LastName) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Student.FirstMidName) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Student.FirstMidName) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Student.EnrollmentDate) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Student.EnrollmentDate) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Student.Enrollments) 

</dt> 

<dd> 

ctable class="table"> 

<tr> 

<th>Course Title</th> 

<th>Grade</th> 

</tr> 

@foreach (var item in Model.Student.Enrollments) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Course.Title) 
</td> 

<td> 

@Fltml.DisplayFor(modelItem => item.Grade) 

</td> 

</tr> 

} 

</table> 

</dd> 

</dl> 

</div> 

<div> 

<a asp-page="./Edit" asp-route-id="@Model.Student.ID">Edit</a> | 

<a asp-page="./Index">Back to List</a> 

</div> 


Kod yapıştırıldıktan sonra kod girintisi yanlışsa, düzeltmek için CTRL-K-D 1 a basın. 

Yukarıdaki kod, Enrollments Gezinti özelliğindeki varlıklar aracılığıyla döngü başlatır. Her kayıt için kurs başlığını ve 
sınıfı görüntüler. Kurs başlığı, kayıt varlığının course gezinti özelliğinde depolanan kurs varlığından alınır. 

Uygulamayı çalıştırın, öğrenciler sekmesini seçin ve bir öğrenci için Ayrıntılar bağlantısına tıklayın. Seçili öğrenci 





için Kurslar ve notlar listesi görüntülenir. 


Oluştur sayfasını Güncelleştir 

Pages/öğrenciler/Create. cshtml. cs dosyasındaki yöntemiaşağıdakikodlagüncelleştirin: onPostAsync 


public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var emptyStudent = new Student(); 

if (await TryllpdateModelAsync<Student>( 
emptyStudent, 

"student", // Prefix for form value. 

s => s.FirstMidName, s => s.LastName, s => s.EnrollmentDate)) 

{ 

_context.Student.Add(emptyStudent); 
await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

return null; 

} 


Tryll pdate M odel Async 

Tryupdatemodelasync kodunu inceleyin: 

var emptyStudent = new Student(); 

if (await TryUpdateModelAsync<Student>( 
emptyStudent , 

"student", // Prefix for form value. 

s => s.FirstMidName, s => s.LastName, s => s.EnrollmentDate)) 

{ 

TryupdateModeiAsync<student> Önceki kodda, pagemodeliçindeki pagecontext özelliğinden emptyStudent 
gönderilen form değerlerini kullanarak nesneyi güncelleştirmeye çalışır. TryupdateModelAsync yalnızca listelenen ( 
s => s. FirstMidName, s => s.LastName, s => s. EnrollmentDate ) Özellikleri güncelleştirir. 

Yukarıdaki örnekte: 

• ikinci bağımsız değişken ( "student", // Prefix ), ön ek değerleri aramak için kullanılır. Büyük/küçük harfe 
duyarlı değildir. 

• Postalanan form değerleri model student bağlamakullanılarak modeldeki türlere dönüştürülür. 

Fazla nakil 

Deftere TryupdateModei nakledilen değerler içeren alanları güncelleştirmek için kullanmak, aşırı nakletmeyi önlediği 
için en iyi güvenlik yöntemidir. Örneğin, öğrenci varlığının bu Web sayfasının güncelleştirmesi veya secnet 
eklemesi gereken bir özelliği içerdiğini varsayalım: 









public class Student 

{ 

public int ID { get; set; } 
public string LastName { get; set; } 
public string FirstMidName { get; set; } 
public DateTime EnrollmentDate { get; set; } 
public string Secret { get; set; } 

} 

Uygulama, oluşturma/güncelleştirme Razor sayfasında secret bir alana sahip olmasa da, bir korsan secret 
değeri aşırı nakme ile ayarlayabilir. Bir korsan, Fiddler gibi bir araç kullanabilir veya bir secret form değeri 
göndermek için bazı JavaScript yazabilir. Özgün kod, bir öğrenci örneği oluştururken model cildin kullandığı 
alanları sınırlamaz. 

secret Form alanı için belirtilen korsanın hangi değeri veritabanında güncelleştirildiği. Aşağıdaki görüntüde, alanı 
("overpost" değeri ile secret ), postalanan form değerlerine ekleyen Fiddler aracı gösterilmektedir. 


(2) Statistics $ Inspectors f AutoResponder ^ Composer Q Filters 0 log — Timeline 


Usethls pageto composea Request. Youcan done a priorrequestby dragglng and dropping a sessionfromthe 1 
Web Sessions list. 
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POST 

V 

http://localhost: 1236/Student/Create 


HTTP/1.1 

V 


ReguestHeaders 

[ Upload file... ] 

Help... 


Hoşt: localhost: 1236 

User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64; rv:22.0) Gecko/20100101Firefox/22.0 

Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/'‘;q=0.8 

Accept-language: en-US,en;q=0.5 

Accept-Encodirıg: gzip, deflate 

Referer: http : //localhost: 1236/Student/Create 

Cookie : RequestVerificationToken =-OqMEtdNIwFGDdjHUS_-XDoOSCqS 1515g7ASzrFKwQPjpxRT2hN_tm6pDZbS0HVVTGMr 

Connection: keep-alive 

Content-Type: applica6on/x-www-fbrm-urlencoded 
Content-Length: 227 


< > 


RequestBody 




sl&LastName=Smith&FirstMidName=Joe&EnrollmentDate=7%2F31%2F2013+4%3A58%3A23 


iecret=OverPost 


"Overpost" değeri eklenen satırın secret özelliğine başarıyla eklendi. Uygulama Tasarımcısı hiçbir şekilde hiçbir 
secret özelliği oluştur sayfasıyla ayarlamaya yönelik değildir. 

Modeli görüntüle 

Bir görünüm modeli, genellikle uygulama tarafından kullanılan modelde bulunan özelliklerin bir alt kümesini içerir. 
Uygulama modeli genellikle etki alanı modeli olarak adlandırılır.Etki alanı modeli genellikle VERITABANıNDAKI 
karşılık gelen varlık için gereken tüm özellikleri içerir. Görünüm modeli yalnızca Ul katmanı için gereken özellikleri 
içerir (örneğin, Oluştur sayfası). Görünüm modeline ek olarak, bazı uygulamalar Razor Pages sayfa modeli sınıfı ve 
tarayıcı arasında veri geçirmek için bir bağlama modeli veya giriş modeli kullanır. Aşağıdaki student görünüm 
modelini göz önünde bulundurun: 






































using System; 


namespace Contosollniversity .Models 
{ 

public class StudentVM 
{ 

public int ID { get; set; } 
public stning LastName { get; set; } 
public stning FirstMidName { get; set; } 
public DateTime EnrollmentDate { get; set; } 

} 


} 


Model görüntüleme, fazla nakletmeyi önlemenin alternatif bir yolunu sağlar.Görünüm modeli yalnızca 
görüntüleme (görüntüleme) veya güncelleştirme özelliklerini içerir. 

Aşağıdaki kod, yeni bir StudentVM öğrenci oluşturmak için görünüm modelini kullanır: 

[BindProperty] 

public StudentVM StudentVM { get; set; } 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var entry = _context.Add(new Student()); 
entry.CurrentValues.SetValues(StudentVM); 
await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 


SetValues yöntemi, başka bir PropertyValues nesnesinden değerleri okuyarak bu nesnenin değerlerini ayarlar. 
Setvalues Özellik adı eşleştirme kullanır.Görünüm modeli türünün model türüyle ilgili olması gerekmez, yalnızca 
eşleşen özellikleri olması gerekir. 

Kullanmak StudentVM için createvm gerekir, cshtml , yerine kullanılmak StudentVM üzere güncelleştirilir, student 
Razor Pages, PageModei türetilmiş sınıf görünüm modelidir. 


Güncelleştirme düzenleme sayfası 


Düzenleme sayfasının sayfa modelini güncelleştirin. Büyük değişiklikler vurgulanır: 












public class EditModel : PageModel 

{ 

private readonly SchoolContext _context; 

public EditModel(SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Student Student { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Student = await _context.Student.FindAsync(id); 

if (Student == null) 

{ 

return NotFound(); 

} 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int? id) 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var studentîoUpdate = await _context.Student.FindAsync(id); 

if (await TryUpdateModelAsync<Student>( 
studentîoUpdate, 

"student", 

s => s.FirstMidName, s => s.LastName, s => s.EnrollmentDate)) 

{ 

await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

return Page(); 

} 

} 


Kod değişiklikleri, birkaç özel durum dışında oluşturma sayfasına benzerdir: 

• onPostAsync isteğe bağlı id bir parametreye sahiptir. 

• Geçerli öğrenci boş bir öğrenci oluşturmak yerine DB 'den getirilir. 

• FirstorDefaultAsync , Findadsyncile değiştirilmiştir. FindAsync birincil anahtardan bir varlık seçerken iyi bir 
seçimdir. Daha fazla bilgi için bkz. Findadsync . 

Düzenleme ve oluşturma sayfalarını test etme 

Birkaç öğrenci varlığı oluşturun ve düzenleyin. 

Varlık durumları 

DB bağlamı, bellekteki varlıkların VERITABANıNDA karşılık gelen satırlarıyla eşitlenmiş olup olmadığını izler. 









VERITABANı bağlamı eşitleme bilgileri, Savechangesasync çağrıldığında ne olacağını belirler. Örneğin, yeni bir 
varlık Addadsync yöntemine geçirildiğinde, bu varlığın durumu eklendiolarak ayarlanır. saveChangesAsync 
Çağrıldığında, DB bağlamı bir SQL INSERT komutu yayınlar. 

Bir varlık aşağıdaki durumlardanbirinde olabilir: 

• Added : Varlık, VERITABANıNDA henüz yok. Savechanges Yöntemi bir INSERT ifadesini yayınlar. 

• unchanged : Bu varlıkla birlikte hiçbir değişiklik kaydedilmesi gerekmiyor.Bir varlık, DB 'den okurken bu 
duruma sahip olur. 

• Modified : Varlığın özellik değerlerinin bazıları veya tümü değiştirildi. Savechanges Yöntemi bir Update 
ifadesini yayınlar. 

• Deleted : Varlık silinmek üzere işaretlendi. Savechanges Yöntemi bir DELETE ifadesini yayınlar. 

• Detached : Varlık DB bağlamı tarafından izlenmiyor. 

Bir masaüstü uygulamasında durum değişiklikleri genellikle otomatik olarak ayarlanır. Bir varlık okundu, 
değişiklikler yapılır ve varlık durumu otomatik olarak olarak değiştirilecek Modified .Çağıran Savechanges yalnızca 
değiştirilen özellikleri güncelleştiren bir SQL Update bildirisi oluşturur. 

Bir Web uygulamasında, DbContext bir varlığı okur ve bir sayfa işlendikten sonra verileri görüntüler. Bir sayfanın 
onPostAsync yöntemi çağrıldığında, yeni bir Web isteği oluşturulur ve yeni bir örneğine DbContext sahiptir. Yeni 
bağlamdaki varlığı yeniden okumak masaüstü işlemesini benzetir. 

Silme sayfası 

Bu bölümde, çağrı Savechanges başarısız olduğunda özel bir hata iletisi uygulamak için kod eklenir. Olası hata 
iletilerini içeren bir dize ekleyin: 

public class DeleteModel : PageModel 
{ 

private readonly SchoolContext _context; 

public DeleteModel(SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Student Student { get; set; } 
public string ErrorMessage { get; set; } 


onGetAsync Yöntemini aşağıdaki kodla değiştirin: 















public async Task<IActionResult> OnGetAsync(int? id, bool? saveChangesError = false) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Student = await _context.Student 
.AsNoTracking() 

.FirstOrDefaultAsync(m => m.ID == id); 

if (Student == null) 

{ 

return NotFound(); 

} 

if (saveChangesError.GetValueOrDefault()) 

{ 

ErrorMessage = "Delete failed. Try again"; 

} 

return Page(); 

} 

Önceki kod isteğe bağlı parametresini saveChangesError içerir. saveChangesError öğrenci nesnesini silme hatasından 
sonra yöntemin çağrılıp çağrılmadığını gösterir. Geçici ağ sorunları nedeniyle silme işlemi başarısız olabilir.Geçici 
ağ hataları, bulutta daha olasıdır. saveChangesError , silme sayfası onGetAsync kullanıcı arabiriminden çağrıldığında 
false 'tur. Tarafından çağrıldığında ( silme saveChangesError işlemi başarısız olduğundan), parametresi true olur. 
OnGetAsync OnPostAsync 


Sayfaları sil OnPostAsync yöntemi 

OnPostAsync Öğesini aşağıdaki kodla değiştirin: 


public async Task<IActionResult> OnPostAsync(int? İd) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var student = await _context.Student 
.AsNoTracking() 

.FirstOrDefaultAsync(m => m.ID == id); 

if (student == null) 

{ 

return IMotFound(); 

} 


} 


try 

{ 


_context.Student.Remove(student); 
await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

catch (DbUpdateException /* ex */) 

{ 

//Log the error (uncomment ex variable name and write a log.) 
return RedirectToAction("./Delete", 

new { id, saveChangesError = true }); 


} 








Önceki kod seçili varlığı alır, ardından varlığın durumunu olarak Deleted ayarlamak için Remove yöntemini çağırır. 
Savechanges Çağrıldığında, bir SQL DELETE komutu oluşturulur. Remove Başarısız olursa: 

• DB özel durumu yakalandı. 

• Sayfaları OnGetAsync Sil yöntemi ile saveChangesError=true çağırılır. 

Razor Sil sayfasını Güncelleştir 

Aşağıdaki Vurgulanan hata iletisini Razor Sil sayfasına ekleyin. 

@page "{idıint}" 

@model ContosoUniversity.Pages.Students.DeleteModel 
@{ 

ViewData["Title"] = "Delete"; 

} 

<h2>Delete</h2> 

<p class="text-danger">@Model.ErrorMessage</p> 

<h3>Are you sure you want to delete this?</h3> 

<div> 

Test silme. 

Sık karşılaşılan hatalar 

Öğrenciler/dizin veya diğer bağlantılar çalışmaz: 

Razor sayfasının doğru @page yönergeyi içerdiğini doğrulayın. Örneğin, öğrenciler/Dizin Razor sayfası bir yol 
şablonu içermemelidir: 

@page "{id:int}" 

Her Razor sayfası @page yönergesini içermelidir. 

Ek kaynaklar 

• Bu öğreticinin YouTube sürümü 
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ASPNET Core sıralama, filtrelerine, sayfalama-3/8 1 de 
EF Core Razor Pages 

20.08.2019 • 44 minutes to read ı Edit Online 


By Tom Dykstra, Rick Andersonve Jon P Smith 

Contoso Üniversitesi web uygulaması, EF Core ve Visual Studio kullanarak Razor Pages Web uygulamaları 
oluşturmayı gösterir. Öğretici serisi hakkında daha fazla bilgi için ilk öğreticiyebakın. 

Çözemediğiniz sorunlarla karşılaşırsanız, Tamamlanmış uygulamayı indirin ve öğreticiyi izleyerek bu kodu 
oluşturduğunuz şekilde karşılaştırın. 

Bu öğretici, öğrenciler sayfalarına sıralama, filtreleme ve sayfalama işlevselliği ekler. 

Aşağıdaki çizimde tamamlanmış bir sayfa gösterilmektedir. Sütun başlıkları sütunu sıralamak için tıklatılabilir 
bağlantılardır. Artan ve azalan sıralama düzeni arasında geçiş yapmak için bir sütun başlığına tekrar tekrar tıklayın 
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Sıralama Ekle 


Pages/öğrenciter/lndex. cshtml. cs içindeki kodu, sıralama eklemek için aşağıdaki kodla değiştirin. 










using ContosoUniversity.Data; 
using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.EntityFrameworkCore; 
using System; 

using System.Collections.Generic; 

using System.Linq; 

using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Students 

{ 

public class IndexModel : PageModel 

{ 

private readonly SchoolContext _context; 

public IndexModel(SchoolContext context) 

{ 

_context = context; 

} 

public string NameSort { get; set; } 
public string DateSort { get; set; } 
public string CurrentFilter { get; set; } 
public string CurrentSort { get; set; } 

public IList<Student> Students { get; set; } 

public async Task OnGetAsync(string sortOrder) 

{ 

NameSort = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 

DateSort = sortOrder == "Date" ? "date_desc" : "Date"; 

IQueryable<Student> studentsIQ = from s in _context.Students 

select s; 

switch (sortOrder) 

{ 

case "name_desc": 

studentsIQ = studentsIQ.OrderByDescending(s => s.LastName); 
break; 

case "Date": 

studentsIQ = studentsIQ.OrderBy(s => s.EnrollmentDate); 
break; 

case "date_desc": 

studentsIQ = studentsIQ.OrderByDescending(s => s.EnrollmentDate); 
break; 
default: 

studentsIQ = studentsIQ.OrderBy(s => s.LastName); 
break; 

} 

Students = await studentsIQ.AsNoTracking().ToListAsync(); 

} 

} 

} 


Yukarıdaki kod: 

• Sıralama parametrelerini içeren özellikleri ekler. 

• student Özelliğin adını olarak students değiştirir. 

• onGetAsync Yöntemindeki kodu değiştirir. 

Yöntemi, URL 'deki sortOrder sorgu dizesinden bir parametre alır. OnGetAsync URL (sorgu dizesi dahil), tutturucu 
etiketi Yardımcısıtarafından oluşturulur. 





sortorder Parametre "ad" ya da "Tarih" dır. Parametre sortorder , isteğe bağlı olarak azalan sıra belirtmek için 
"_DESC" tarafından izlenir. Varsayılan sıralama düzeni artan. 

Öğrenciler bağlantısından Dizin sayfası istendiğinde sorgu dizesi yoktur.Öğrenciler, son ada göre artan sırada 
görüntülenir. Son ada göre artan sıralama, switch deyimindeki varsayılan (gelen durumdur). Kullanıcı bir sütun 
başlığı bağlantısına tıkladığında, sorgu dizesi değerinde uygun sortorder değer sağlanır. 

NameSort ve DateSort Razor sayfası tarafından sütun başlığı köprülerini uygun sorgu dizesi değerleriyle 
yapılandırmak için kullanılır: 

NameSort = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 

DateSort = sortorder == "Date" ? "date_desc" : "Date"; 

Kod, C# koşullu işleci kullanıyor ?:. ?: işleci üçlü bir işleçtir (üç işlenen alır), ilk satır, null veya boş sortorder 
olduğunu belirtir, NameSort "name_desc“ olarak ayarlanır. Null veya boş değilseboşbirdizeolarak NameSort ayarlanır, 
sortorder 

Bu iki deyim, sayfanın sütun başlığı köprülerini şu şekilde ayarlamanızı sağlar: 


GEÇERLİ SIRALAMA DÜZENİ 

SON AD KÖPRÜSÜ 

TARİH KÖPRÜSÜ 

Artan son ad 

descending 

ascending 

Azalan son ad 

ascending 

ascending 

Artan Tarih 

ascending 

descending 

Azalan Tarih 

ascending 

ascending 


Yöntemi, sıralama yapılacak sütunu belirtmek için LINQ to Entities kullanır. Kod, Svvitch ifadesinden 
iQueryabie<student> önce bir başlatır ve Svvitch ifadesinde onu değiştirir: 

IQueryable<Student> studentsIQ = from s in _context.Students 

select s; 

switch (sortorder) 

{ 

case "name_desc": 

studentsIQ = studentsIQ.OrderByDescending(s => s.LastName); 
break; 

case "Date": 

studentsIQ = studentsIQ.OrderBy(s => s.EnrollmentDate); 
break; 

case "date_desc": 

studentsIQ = studentsIQ.OrderByDescending(s => s.EnrollmentDate); 
break; 
default: 

studentsIQ = studentsIQ.OrderBy(s => s.LastName); 
break; 

} 

Students = await studentsIQ.AsNoîracking() .ToListAsync(); 

Bir ıçueryable oluşturulduğunda veya değiştirildiğinde, veritabanına hiçbir sorgu gönderilmez. ıçiueryabie Nesne 
bir koleksiyona dönüştürülene kadar sorgu yürütülmez. ıçueryable , gibi bir yöntemi ToListAsync çağırarak bir 
koleksiyona dönüştürülür. Bu nedenle, ıçueryable kod, aşağıdaki deyime kadar yürütülemeyen tek bir sorgu ile 
sonuçlanır: 























Students = await studentsIQ.AsNoTracking().ToListAsync(); 

onGetAsync çok sayıda sıralanabilir sütunla ayrıntı alabilir. Bu işlevi kodun alternatif bir yolu hakkında daha fazla 
bilgi için, bu öğretici serisinin MVC sürümünde kodu basitleştirmek için dinamik LINQ kullanma konusuna bakın. 

Öğrenci dizini sayfasına sütun başlığı köprüleri ekleme 

Öğrenciler/lndex. cs/ıfm/içindeki kodu aşağıdaki kodla değiştirin. Değişiklikler vurgulanır. 

@page 

@model ContosoUniversity.Pages.Students.IndexModel 

@{ 

ViewData["Title"] = "Students"; 

} 

<h2>Students</h2> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

ctable class="table"> 

<thead> 

<tr> 

<th> 

<a asp-page="./Index" asp-route-sortOrder="@Model.NameSort"> 

@Html.DisplayNameFor(model => model.Students[0].LastName) 

</a> 

</th> 

<th> 

@Html.DisplayNameFon(model => model.Students[0].FirstMidName) 

</th> 

<th> 

<a asp-page="./Index" asp-route-sortOrder="@Model.DateSort"> 

@Html.DisplayNameFor(model => model.Students[0].EnrollmentDate) 

</a> 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model.Students) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.LastName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.FirstMidName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.EnrollmentDate) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID">Details</a> | 

<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 


Yukarıdaki kod: 



• LastName Ve EnroiimentDate sütun başlıklarına köprüler ekler. 

• , Ve NameSort DateSort içindeki bilgileri kullanarak geçerli sıralama düzeni değerleriyle köprüler ayarlar. 

• Sayfa başlığını dizinden öğrencilerle değiştirir. 

• Üzerinde yapılan değişiklikler Model.student . Model.students 

Sıralamanın çalıştığını doğrulamak için: 

• Uygulamayı çalıştırın ve öğrenciler sekmesini seçin. 

• Sütun başlıklarına tıklayın. 

Filtre ekleme 

Öğrenciler dizin sayfasına filtre eklemek için: 

• Razor sayfasına bir metin kutusu ve bir Gönder düğmesi eklenir. Metin kutusu, ad veya soyadı üzerinde bir 
arama dizesi sağlar. 

• Sayfa modeli metin kutusu değerini kullanacak şekilde güncelleştirilir. 

OnGetAsync yöntemini güncelleştirme 

Öğrenciler/lndex. cshtml. cs dosyasındaki kodu, filtreleme eklemek için aşağıdaki kodla değiştirin: 







using ContosoUniversity.Data; 
using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.EntityFrameworkCore; 
using System; 

using System.Collections.Generic; 

using System.Linq; 

using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Students 

{ 

public class IndexModel : PageModel 

{ 

private readonly SchoolContext _context; 

public IndexModel(SchoolContext context) 

{ 

_context = context; 

} 

public string NameSort { get; set; } 
public string DateSort { get; set; } 
public string CurrentFilter { get; set; } 
public string CurrentSort { get; set; } 

public IList<Student> Students { get; set; } 

public async Task OnGetAsync(string sortOrder, string searchString) 

{ 

NameSort = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 
DateSort = sortOrder == "Date" ? "date_desc" : "Date"; 


CurrentFilter = searchString; 


IQueryable<Student> studentsIQ = from s in _context.Students 

select s; 

if (!String.IsNullOrEmpty(searchString)) 

{ 


} 


studentsIQ = studentsIQ.Where(s => s.LastName.Contains(searchString) 
| s.FirstMidName.Contains(searchString)); 


switch (sortOrder) 

{ 

case "name_desc": 

studentsIQ = studentsIQ.OrderByDescending(s => s.LastName); 
break; 

case "Date": 

studentsIQ = studentsIQ.OrderBy(s => s.EnrollmentDate); 
break; 

case "date_desc": 

studentsIQ = studentsIQ.OrderByDescending(s => s.EnrollmentDate); 
break; 
default: 

studentsIQ = studentsIQ.OrderBy(s => s.LastName); 
break; 


} 


} 


Students = await studentsIQ.AsNoTracking().ToListAsync(); 

} 


Yukarıdaki kod: 


• Yöntemine parametresini ekler ve parametre değerini CurrentFilter özelliğine kaydeder. searchString 





onGetAsync Arama dizesi değeri bir sonraki bölüme eklenen bir metin kutusundan alınır. 

• LINQ deyimi a where yan tümcesine ekler. where Yan tümce yalnızca adı veya soyadı arama dizesini içeren 
öğrencileri seçer. LINQ deyimleri yalnızca aranacak bir değer varsa yürütülür. 

IQueryable vs. lEnumerable 

Kod, where yöntemi bir ıçueryable nesne üzerinde çağırır ve filtre sunucuda işlenir. Bazı senaryolarda, uygulama 
bir bellek içi koleksiyonda bir genişletme where yöntemi olarak yöntemi çağırıyor olabilir. Örneğin, EF Core DbSet 
'den _context .students bir lEnumerable koleksiyonu döndüren bir depo yöntemine yapılan değişiklikleri varsayın. 
Sonuç normalde aynı olur, ancak bazı durumlarda farklı olabilir. 

Örneğin, uygulamasının contains .NET Framevvork uygulanması varsayılan olarak büyük/küçük harfe duyarlı bir 
karşılaştırma gerçekleştirir. SÖL Server, contains büyük/küçük harf duyarlılığı SQL Server örneğinin harmanlama 
ayarına göre belirlenir. SÖL Server varsayılan olarak büyük/küçük harfe duyarlı değildir. SQLite, büyük/küçük harfe 
duyarlı olur. Toupper testi açık büyük/küçük harfe duyarsız hale getirmek için çağrılabilir: 

Where(s => s.LastName.ToUpper() .Contains(searchString.ToUpper())' 

Yukarıdaki kod, where yöntemin bir veya bir lEnumerable SÖLİte üzerinde çağrılması durumunda bile filtrenin 
büyük/küçük harf duyarsız olmasını güvence altına alır. 

contains Bir lEnumerable koleksiyon üzerinde çağrıldığında ,N ET Core uygulamasını kullanır, contains Bir 
ıçueryable nesne üzerinde çağrıldığında, veritabanı uygulamasını kullanır. 

contains Bir ıçueryable üzerinde çağırmak, genellikle performans nedenleriyle tercih edilir, ile ıçueryable , 
filtreleme veritabanı sunucusu tarafından yapılır. Önce bir lEnumerable oluşturulduysa, tüm satırların veritabanı 
sunucusundan döndürülmesi gerekir. 

Çağırmak Toupper için bir performans cezası vardır. Toupper Kod, TSÖL SELECT ifadesinin VVHERE yan tümcesine 
bir işlev ekler. Eklenen işlev, iyileştiricinin bir dizin kullanmasını önler.SÖL, büyük/küçük harfe duyarsız olarak 
yüklendiği için, gerekli olmadığında Toupper çağrının önüne geçmek en iyisidir. 

Daha fazla bilgi için bkz. SOLite sağlayıcı ile büyük/küçük harfe duyarsız sorgu kullanma. 

Razor sayfasını güncelleştirme 

Sayfalar/öğrenciler/lndex. cshtml içindeki kodu, bir arama düğmesi ve assıralanan Chrome oluşturmak için 
değiştirin. 


























@page 

@model ContosoUniversity.Pages.Students.IndexModel 

@{ 

ViewData["Title"] = "Students"; 

} 

<h2>Students</h2> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<form asp-page="./Index" method="get"> 

<div class="form-actions no-color"> 

<P> 

Find by name: 

cinput type="text" name="SearchString" value="@Model.CurrentFilter" /> 
cinput type="submit" value="Search" class="btn btn-primary" /> | 

<a asp-page="./Index">Back to full List</a> 

</p> 

</div> 

</form> 

ctable class="table"> 

<thead> 

<tr> 

<th> 

<a asp-page="./Index" asp-route-sortOrder="@Model.NameSort"> 
@Html.DisplayNameFor(model => model.Students[0].LastName) 

</a> 

</th> 

<th> 

@Html.DisplayNameFor(model = > model.Students[0].FirstMidName) 

</th> 

<th> 

<a asp-page="./Index" asp-route-sortOrden="@Model.DateSort"> 

@Html.DisplayNameFor(model => model.Students[0].EnrollmentDate) 

</a> 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model.Students) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.LastName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.FirstMidName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.EnrollmentDate) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID">Details</a> | 

<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 



Yukarıdaki kod, arama metin <form> kutusu ve düğme eklemek için etiket yardımcısını kullanır. Varsayılan olarak, 
<form> etiket Yardımcısı form verilerini bir gönderiyle gönderir. POST ile parametreler, URL 'de değil HTTP ileti 
gövdesine geçirilir. HTTP GET kullanıldığında, form verileri URL 'ye sorgu dizeleri olarak geçirilir.Verilerin sorgu 
dizelerine geçirilmesi, kullanıcıların URL 'Yİ yer işaretine eklemesini sağlar. W3C yönergeleri , eylem bir 
güncelleştirme ile SONUÇLANMAZSA, Get 'in kullanılması önerilir. 

Uygulamayı test edin: 

• Öğrenciler sekmesini seçin ve bir arama dizesi girin. SQLİte kullanıyorsanız, filtre yalnızca daha önce 
gösterilen isteğe bağlı ToUpper kodu uyguladıysanız, büyük/küçük harfe duyarlıdır. 

• Ara' yı seçin. 

URL 'nin arama dizesini içerdiğine dikkat edin. Örneğin: 
https://localhost:<port>/Students?SearchString=an 

Sayfa yer işaretiyle, yer işareti sayfanın URL'sini ve searchstring sorgu dizesini içerir. method="get" Etiketi,sorgu 
form dizesinin oluşturulmasına neden oldu. 

Şu anda, bir sütun başlığı sıralama bağlantısı seçildiğinde, arama kutusundaki filtre değeri kaybedilir. Kayıp filtre 
değeri bir sonraki bölümde düzeltilir. 

Sayfalama Ekle 

Bu bölümde, sayfalama desteği PaginatedList için bir sınıf oluşturulur. Sınıfı, tablodaki tüm Take satırları almak 
yerine, sunucudaki verileri filtrelemek için ve deyimlerini kullanır sı<ip . PaginatedList Aşağıdaki çizimde 
sayfalama düğmeleri gösterilmektedir. 
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Sayfalı liste sınıfını oluşturma 

Proje klasöründe aşağıdaki kodla oluşturun PaginatedList.es : 


















using System; 

using System.Collections.Generic; 
using System.Linq; 
using System.Thneading.Tasks; 
using Microsoft.EntityFrameworkCore; 

namespace ContosoUniversity 

{ 

public class PaginatedList<T> : List<T> 

{ 

public int Pagelndex { get; private set; } 
public int TotalPages { get; private set; } 

public PaginatedList(List<T> items, int count, int pagelndex, int pageSize) 

{ 

Pagelndex = pagelndex; 

TotalPages = (int)Math.Ceiling(count / (double)pageSize); 
this.AddRange(items); 

} 

public bool HasPreviousPage 

{ 

get 

{ 

return (Pagelndex > 1); 

} 

} 

public bool HasNextPage 

{ 

get 

{ 

return (Pagelndex < TotalPages); 

} 

} 

public static async Task<PaginatedList<T>> CreateAsync( 

IQueryable<T> source, int pagelndex, int pageSize) 

{ 

var count = await source.CountAsync(); 
var items = await source.Skip( 

(pagelndex - 1) * pageSize) 

.Take(pageSize).ToListAsync(); 

return new PaginatedList<T>(itemSj count, pagelndex, pageSize); 

} 

} 

} 


Yukarıdaki koddaki 

skip 

Take 

ıçueryabie yöntemi sayfa boyutunu ve sayfa numarasını alır ve ' a uygun ve 

deyimlerini uygular. 

CreateAsync 

ToListAsync 

Üzerindeçağrıldığında,yalnızcaistenensayfayı ıçueryable içeren bir 

liste döndürür. Özellikler 

HasPreviousPage 

ve 

HasNextPage 

önceki ve sonraki sayfalama düğmelerini 


etkinleştirmek veya devre dışı bırakmak için kullanılır. 

Yöntemi oluşturmak için kullanılır. PaginatedList<T> createAsync Oluşturucu PaginatedList<T> nesneyi 
oluşturamıyor; oluşturucular zaman uyumsuz kod çalıştıramıyor. 

PageModel sınıfına sayfalama ekleme 

Öğrenciler/lndex. cshtml. cs ' deki kodu, sayfalama eklemek için değiştirin. 

using ContosoUniversity.Data; 
using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.EntityFrameworkCore; 









using System; 

using System.Collections.Generic; 

using System.Linq; 

using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Students 

{ 

public class IndexModel : PageModel 

{ 

private readonly SchoolContext _context; 

public IndexModel(SchoolContext context) 

{ 

_context = context; 

} 

public stning NameSort { get; set; } 
public stning DateSort { get; set; } 
public stning CunnentFilten { get; set; } 
public stning CunnentSont { get; set; } 

public PaginatedList<Student> Students { get; set; } 

public async Task OnGetAsync(stning sontOnden, 

stning CunnentFilten, stning seanchStning, int? pagelndex) 

{ 

CunnentSont = sontOnden; 

NameSont = Stning.IsNullOnEmpty(sontOnden) ? "name_desc" : 

DateSont = sontOnden == "Date" ? "date_desc" : "Date"; 
if (seanchStning != null) 

{ 

pagelndex = 1; 

} 

else 

{ 

seanchStning = CunnentFilten; 

} 

CunnentFilten = seanchStning; 

IQuenyable<Student> studentsIQ = fnom s in _context.Students 

select s; 

if (!Stning.IsNullOnEmpty(seanchStning)) 

{ 

studentsIQ = studentsIQ.Whene(s => s.LastName.Contains(seanchStning) 
| s.FinstMidName.Contains(seanchStning)); 

} 

switch (sontOnden) 

{ 

case "name_desc": 

studentsIQ = studentsIQ.OndenByDescending(s => s.LastName); 
bneak; 

case "Date": 

studentsIQ = studentsIQ.OndenBy(s => s.EnnollmentDate); 
bneak; 

case "date_desc": 

studentsIQ = studentsIQ.OndenByDescending(s => s.EnnollmentDate) 
bneak; 
default: 

studentsIQ = studentsIQ.OndenBy(s => s.LastName); 
bneak; 

} 

int pageSize = 3; 

Students = await PaginatedList<Student>.CneateAsync( 

studentsIQ.AsNoTnacking(), pagelndex ?? 1, pageSize); 


} 


Yukarıdaki kod: 


Students 

Özelliğinin türünü 

PaginatedList<student> olarak değiştirir. 

IList<Student> 


• Sayfa dizinini, geçerli sortorder currentFilter ve onGetAsync öğesini Yöntem imzasına ekler. 

• Sıralama düzenini CurrentSort özelliğine kaydeder. 

• Yeni bir arama dizesi olduğunda sayfa dizinini 1 olarak sıfırlar. 

• Öğrenci varlıklarını almak için sınıfınıkullanır PaginatedList 

Şu durumlarda OnGetAsync alan tüm parametreler null: 

• Sayfa öğrenciler bağlantısından çağrılır. 

• Kullanıcı bir sayfalama veya sıralama bağlantısına tıklamadı. 

Bir sayfalama bağlantısına tıklandığında, sayfa dizin değişkeni görüntülenecek sayfa numarasını içerir. 

CurrentSort Özelliği, geçerli sıralama düzeni ile Razor sayfasını sağlar. Disk belleği sırasında sıralama düzenini 
korumak için geçerli sıralama düzeni, sayfalama bağlantılarına eklenmelidir. 

CurrentFilter Özelliği, Razor sayfasını geçerli filtre dizesiyle birlikte sağlar. CurrentFilter Değer: 

• Disk belleği sırasında filtre ayarlarını korumak için disk belleği bağlantılarına eklenmelidir. 

• Sayfa yeniden görüntülendiğinde metin kutusuna geri yüklenmelidir. 

Sayfalama sırasında arama dizesi değiştirilirse sayfa 1 1 e sıfırlanır. Yeni filtre farklı verilerin görüntülenmesini 
sağladığından sayfanın 1 olarak sıfırlanması. Bir arama değeri girildiğinde ve Gönder seçildiğinde: 

• Arama dizesi değiştirildi. 

• searchstring Parametre null değil. 

Yöntemi PaginatedList.createAsync , öğrenci sorgusunu, sayfalama destekleyen bir koleksiyon türündeki tek bir 
öğrenci sayfasına dönüştürür. Bu tek öğrenci sayfası Razor sayfasına geçirilir. 

Çağrıdan PaginatedList.CreateAsync sonraki pageindex iki soru işareti, null birleşim işlecinitemsil eder. Null 
birleşim işleci, null yapılabilir bir tür için varsayılan değeri tanımlar, ifade (pageindex ?? i) , bir değer pageindex 
içeriyorsa değerini döndürür anlamına gelir. pageindex Değer yoksa 1 döndürün. 

Razor sayfasına sayfalama bağlantıları ekleme 

Öğrenciler/lndex. cshtml içindeki kodu aşağıdaki kodla değiştirin. Değişiklikler vurgulanır: 

@page 

@model ContosoUniversity.Pages.Students.IndexModel 


@{ 

ViewData["Title"] = "Students"; 

} 

<h2>Students</h2> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<fonm asp-page="./Index" method="get"> 

<div class="form-actions no-color"> 

<P> 

Find by name: 

cinput type="text" name="SearchString" value="@Model.CurrentFilter" /> 
cinput type="submit" value="Search" class="btn btn-primary" /> | 


a<;n-nacrp=" . /TnHpY ,, ^Rark' ir» -Fiili I 




















</p> 

</div> 

</form> 

ctable class="table"> 

<thead> 

<tr> 

<th> 

<a asp-page="./Index" asp-route-sortOrder="@Model.NameSort" 
asp-route-currentFilter="@Model.CurrentFilter"> 
@Fltml.DisplayNameFor(model => model.Students[0].LastName) 

</a> 

</th> 

<th> 

@Fltml.DisplayNameFor(model = > model.Students[0]. FirstMidName) 

</th> 

<th> 

<a asp-page="./Index" asp-route-sortOrder="@Model.DateSort" 
asp-route-currentFilter="@Model.CurrentFilter"> 
@Html.DisplayNameFor(model => model.Students[0].EnrollmentDate) 

</a> 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model.Students) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.LastName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.FirstMidName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.EnrollmentDate) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID">Details</a> | 

<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 

var prevDisabled = IModel.Students.HasPreviousPage ? "disabled" : 
var nextDisabled = IModel.Students.HasNextPage ? "disabled" : 

} 

<a asp-page="./Index" 

asp-route-sortOrder="@Model.CurrentSort" 
asp-route-pageIndex="@(Model.Students.Pagelndex - 1)" 
asp-route-currentFilter="@Model.CurrentFilter" 
class="btn btn-primary @prevDisabled"> 

Previous 

</a> 

<a asp-page="./Index" 

asp-route-sortOrder="@Model.CurrentSort" 
asp-route-pageIndex="@(Model.Students.Pagelndex + 1)" 
asp-route-currentFilter="@Model.CurrentFilter" 
class="btn btn-primary @nextDisabled"> 

Next 


</a> 


Sütun üst bilgisi bağlantıları, geçerli arama dizesini onGetAsync yönteme geçirmek için sorgu dizesini kullanır: 


<a asp-page="./Index" asp-route-sortOrder="@Model.NameSort" 
asp-route-currentFilter="@Model.Curr8ntFilter"> 
@Html.DisplayNameFor(model = > model.Students[0].LastName) 

</a> 


Sayfalama düğmeleri etiket yardımcıları tarafından görüntülenir: 


<a asp-page="./Index" 

asp-route-sortOrder="@Model.CurrentSort" 
asp-route-pageIndex="@(l' / lodel.Students.PageIndex - 1)" 
asp-route-currentFilter="@Model.CurrentFilter" 
class="btn btn-primary @prevDisabled"> 

Previous 

</a> 

<a asp-page="./Index" 

asp-route-sortOrder="@Model.Cur'rentSort" 
asp-noute-pageIndex="@(Model.Students.PageIndex + 1)" 
asp-noute-cur'rentFilter="@Model.CunrentFilter" 
class="btn btn-primany @nextDisabled"> 

Next 

</a> 


Uygulamayı çalıştırın ve öğrenciler sayfasına gidin. 

• Sayfalama 1 nin çalıştığından emin olmak için, farklı sıralama emirlerindeki disk belleği bağlantılarına tıklayın. 

• Disk belleğinin sıralama ve filtreleme ile düzgün çalıştığını doğrulamak için bir arama dizesi girin ve sayfalama 
yapmayı deneyin. 
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Gruplandırma Ekle 








Bu bölüm, her kayıt tarihi için kaç öğrenciye kaydolduğunu görüntüleyen bir hakkında sayfası oluşturur. 
Güncelleştirme gruplamayı kullanır ve aşağıdaki adımları içerir: 

• Hakkında sayfasında kullanılan veriler için bir görünüm modeli oluşturun. 

• Görünüm modelini kullanmak için hakkında sayfasını güncelleştirin. 

Görünüm modeli oluşturma 

Modeller/SchoolViev/Models klasörü oluşturun. 

Aşağıdaki kodla SchoolVievvModels/kayıtlarmı Mentdategroup. cs oluşturun: 

using System; 

using System.ComponentModel.DataAnnotations; 

namespace ContosoUniversity.Models.SchoolViewModels 

{ 

public class EnrollmentDateGroup 

{ 

[DataType(DataType.Date)] 

public DateTime? EnrollmentDate { get; set; } 
public int StudentCount { get; set; } 

} 

} 


Razor sayfasını oluşturma 

Aşağıdaki kodla bir Pages/about. cshtml dosyası oluşturun: 

@page 

@model ContosoUniversity.Pages.AboutModel 

@{ 

ViewData["Title"] = "Student Body Statistics"; 

} 

<h2>Student Body Statistics</h2> 

<table> 

<tr> 

<th> 

Enrollment Date 
</th> 

<th> 

Students 

</th> 

</tr> 

(Şforeach (var item in Model.Students) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.EnrollmentDate) 
</td> 

<td> 

@item.StudentCount 
</td> 

</tr> 

} 

</table> 


Sayfa modelini oluşturma 

Aşağıdaki kodla bir Pages/about cshtml. cs dosyası oluşturun: 







using ContosoLIniversity.Models.SchoolViewModels; 

using ContosoLIniversity .Data; 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using Microsoft.EntityFrameworkCore; 

using System.Collections.Generic; 

using System.Linq; 

using System.Threading.Tasks; 

using ContosoLIniversity.Models; 

namespace ContosoLIniversity. Pages 

{ 

public class AboutModel : PageModel 

{ 

private readonly SchoolContext _context; 

public AboutModel(SchoolContext context) 

{ 

_context = context; 

} 

public IList<EnrollmentDateGroup> Students { get; set; } 

public async Task OnGetAsync() 

{ 

IQueryable<EnrollmentDateGroup> data = 
from student in _context.Students 

group student by student.EnrollmentDate into dateGroup 
select new EnrollmentDateGroupO 
{ 

EnrollmentDate = dateGroup.Key, 

StudentCount = dateGroup.Count() 

}; 

Students = await data.AsNoTrackingO.ToListAsync(); 

} 

} 

} 


LINQ beyanı, öğrenci varlıklarını kayıt tarihine göre gruplandırır, her bir gruptaki varlıkların sayısını hesaplar ve 
sonuçları bir EnroiimentDateGroup görünüm modeli nesneleri koleksiyonunda depolar. 

Uygulamayı çalıştırın ve hakkında sayfasına gidin. Her kayıt tarihi için öğrenci sayısı bir tabloda görüntülenir. 

Contoso University 

Student Body Statistics 

Enrollment Date Students 

9/1/2016 1 

9/1/2017 3 

9/1/2018 2 

9/1/2019 2 

© 2019 - Contoso University - Privacy 







Sonraki adımlar 

Sonraki öğreticide, uygulama, veri modelini güncelleştirmek için geçişleri kullanır. 



Bu öğreticide sıralama, filtreleme, gruplama ve sayfalama işlevleri eklenmiştir. 


Aşağıdaki çizimde tamamlanmış bir sayfa gösterilmektedir. Sütun başlıkları sütunu sıralamak için tıklatılabilir 
bağlantılardır. Sütun başlığına tıklanması, artan ve azalan sıralama düzeni arasında sürekli olarak geçiş yapar. 
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Çözemediğiniz sorunlarla karşılaşırsanız, Tamamlanmış uygulamayıindirin. 


Dizin sayfasına sıralama Ekle 

Sıralama parametrelerini içerecek şekilde öğrenciler/lndex. cshtml. cs PageModei öğesine dizeler ekleyin: 

public class IndexModel : PageModei 
{ 

private readonly SchoolContext _context; 

public IndexModel(SchoolContext context) 

{ 

_context = context; 

} 

public string NameSort { get; set; } 
public string DateSort { get; set; } 
public string CurrentFilter { get; set; } 
public string CurrentSort { get; set; } 

Öğrenciler/lndex. cshtml. cs onGetAsync ' i aşağıdaki kodla güncelleştirin: 














public async Task OnGetAsync(string sortorder) 

{ 

NameSort = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 

DateSort = sortorder == "Date" ? "date_desc" : "Date"; 

IQueryable<Student> studentIQ = fnom s in _context.Student 

select s; 

switch (sortOnder) 

{ 

case "name_desc": 

studentIQ = studentIQ.OrderByDescending(s => s.LastName); 
break; 

case "Date": 

studentIQ = studentIQ.OrderBy(s => s.EnrollmentDate); 
break; 

case "date_desc": 

studentIQ = studentIQ.OrderByDescending(s => s.EnrollmentDate); 
break; 
default: 

studentIQ = studentIQ.OrderBy(s => s.LastName); 
break; 

} 

Student = await studentIQ.AsNoTracking().ToListAsync(); 

} 

Yukarıdaki kod, URL 'deki sortorder sorgu dizesinden bir parametre alır. URL (sorgu dizesi dahil), tutturucu etiketi 
Yardımcısı tarafından oluşturulur 

sortorder Parametre "ad" ya da "Tarih" dır. Parametre sortorder , isteğe bağlı olarak azalan sıra belirtmek için 
"_DESC" tarafından izlenir. Varsayılan sıralama düzeni artan. 

Öğrenciler bağlantısından Dizin sayfası istendiğinde sorgu dizesi yoktur.Öğrenciler, son ada göre artan sırada 
görüntülenir. Son ada göre artan sıralama, switch deyimindeki varsayılan (gelen durumdur). Kullanıcı bir sütun 
başlığı bağlantısına tıkladığında, sorgu dizesi değerinde uygun sortOnder değer sağlanır. 

NameSort ve DateSort Razor sayfası tarafından sütun başlığı köprülerini uygun sorgu dizesi değerleriyle 
yapılandırmak için kullanılır: 










public async Task OnGetAsync(string sortOrder) 

{ 

NameSort = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 

DateSort = sortOrder == "Date" ? "date_desc" : "Date"; 

IQueryable<Student> studentIQ = from s in _context.Student 

select s; 

switch (sortOnder) 

{ 

case "name_desc": 

studentIQ = studentIQ.OrderByDescending(s => s.LastName); 
break; 

case "Date": 

studentIQ = studentIQ.OrderBy(s => s.EnrollmentDate); 
break; 

case "date_desc": 

studentIQ = studentIQ.OrderByDescending(s => s.EnrollmentDate); 
break; 
default: 

studentIQ = studentIQ.OrderBy(s => s.LastName); 
break; 

} 

Student = await studentIQ.AsNoTracking().ToListAsync(); 

} 


Aşağıdaki kod, C# koşullu ?: işleciniiçerir: 


NameSort = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 
DateSort = sortOrder == "Date" ? "date_desc" : "Date"; 


ilk satır, null veya boş sortOrder olduğunu belirtir, NameSort 
değilseboşbirdizeolarak NameSort ayarlanır. sortOrder 


"name_desc" olarak ayarlanır. Null veya boş 


, ?: operatör Üçlü işleç olarak da bilinir. 


Bu iki deyim, sayfanın sütun başlığı köprülerini şu şekilde ayarlamanızı sağlar: 


GEÇERLİ SIRALAMA DÜZENİ 

SON AD KÖPRÜSÜ 

TARİH KÖPRÜSÜ 

Artan son ad 

descending 

ascending 

Azalan son ad 

ascending 

ascending 

Artan Tarih 

ascending 

descending 

Azalan Tarih 

ascending 

ascending 


Yöntemi, sıralama yapılacak sütunu belirtmek için LINQ to Entities kullanır. Kod, Svvitch ifadesinden 
iQueryabie<student> önce bir başlatır ve Svvitch ifadesinde onu değiştirir: 










public async Task OnGetAsync(string sortOnder) 

{ 

NameSort = Stning.IsNullOrEmpty(sortOrder) ? "name_desc" : 

DateSort = sontOrder == "Date" ? "date_desc" : "Date"; 

IQueryable<Student> studentIQ = fnom s in _context.Student 

select s; 

switch (sortOnder) 

{ 

case "name_desc": 

studentIQ = studentIQ.OrderByDescending(s => s.LastName); 
break; 

case "Date": 

studentIQ = studentIQ.OrderBy(s => s.EnrollmentDate); 
break; 

case "date_desc": 

studentIQ = studentIQ.OrderByDescending(s => s.EnrollmentDate); 
break; 
default: 

studentIQ = studentIQ.OrderBy(s => s.LastName); 
break; 

} 

Student = await studentIQ.AsNoTracking().ToListAsync(); 

} 

Bir iQueryabie oluşturulduğunda veya değiştirildiğinde, veritabanına hiçbir sorgu gönderilmez. iQueryabie Nesne 
bir koleksiyona dönüştürülene kadar sorgu yürütülmez. iQueryabie , gibi bir yöntemi ToListAsync çağırarak bir 
koleksiyona dönüştürülür. Bu nedenle, ıçueryabie kod, aşağıdaki deyime kadar yürütülemeyen tek bir sorgu ile 
sonuçlanır: 

Student = await studentIQ.AsNoTracking().ToListAsync(); 


onGetAsync çok sayıda sıralanabilir sütunla ayrıntı alabilir. 

Öğrenci dizini sayfasına sütun başlığı köprüleri ekleme 

Öğrenciler/lndex. cs/ıfm/içindeki kodu aşağıdaki vurgulanmış kodla değiştirin: 











@page 

@model ContosoUniversity.Pages.Students.IndexModel 

@{ 

ViewData["Title"] = "Index"; 

} 

<h2>Index</h2> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

ctable class="table"> 

<thead> 

<tr> 

<th> 

<a asp-page=" ./Index" asp-route-sortOrder="@Model.NameSort"> 
@Html.DisplayNameFor(model => model.Student[0].LastName) 

</a> 

</th> 

<th> 

@Html.DisplayNameFor(model = > model.Student[0].FirstMidName) 

</th> 

<th> 

<a asp-page="./Index" asp-route-sortOrder="@Model.DateSort"> 

@Html.DisplayNameFor(model => model.Student[0].EnrollmentDate) 

</a> 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model.Student) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.LastName) 

</td> 

<td> 

@Fltml.DisplayFor(modelItem => item. FirstMidName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.EnrollmentDate) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID">Details</a> | 
<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 


Yukarıdaki kod: 

• LastName Ve EnroiimentDate sütun başlıklarına köprüler ekler. 

• , Ve NameSort DateSort içindeki bilgileri kullanarak geçerli sıralama düzeni değerleriyle köprüler ayarlar. 
Sıralamanın çalıştığını doğrulamak için: 

• Uygulamayı çalıştırın ve öğrenciler sekmesini seçin. 

• Son ad 1 a tıklayın. 

• Kayıt tarihi 1 ne tıklayın. 






Kodu daha iyi anlamak için: 


• Öğrenciler/lndex. cshtml. csdosyasında, üzerinde switch (sortorder) bir kesme noktası ayarlayın. 

• NameSort Ve DateSort için bir izleme ekleyin. 

• Öğrenciler/lndex. cshtml'de, üzerinde @Html.DispiayNameFor(modei => model.student[0] .LastName) bir kesme 
noktası ayarlayın. 

Hata ayıklayıcıda adım adım. 


Öğrenciler dizin sayfasına bir arama kutusu ekleyin 

Öğrenciler dizin sayfasına filtre eklemek için: 


• Razor sayfasına bir metin kutusu ve bir Gönder düğmesi eklenir. Metin kutusu, ad veya soyadı üzerinde bir 
arama dizesi sağlar. 

• Sayfa modeli metin kutusu değerini kullanacak şekilde güncelleştirilir. 


Dizin yöntemine filtreleme işlevi ekleme 

Öğrenciler/lndex. cshtml. cs onGetAsync ' i aşağıdaki kodla güncelleştirin: 


public async Task OnGetAsync(string sortorder, string searchString) 

{ 

NameSort = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 
DateSort = sortOrder == "Date" ? "date_desc" : "Date"; 
CurrentFilter = searchString; 


IQueryable<Student> studentIQ = from s in _context.Student 

select s; 

if (!String.IsNullOrEmpty(searchString)) 

{ 


} 


studentIQ = studentIQ.Where(s => s. LastName.Contains(searchString) 
| s.FirstMidName.Contains(searchString)); 


switch (sortorder) 

{ 

case "name_desc": 

studentIQ = studentIQ.OrderByDescending(s => s.LastName); 
break; 

case "Date": 

studentIQ = studentIQ.OrderBy(s => s.EnrollmentDate); 
break; 

case "date_desc": 

studentIQ = studentIQ.OrderByDescending(s => s.EnrollmentDate); 
break; 
default: 

studentIQ = studentIQ.OrderBy(s => s.LastName); 
break; 


Student = await studentIQ.AsNoTracking().ToListAsync(); 

} 


Yukarıdaki kod: 

• OnGetAsync Yöntemine searchString parametresini ekler. Arama dizesi değeri bir sonraki bölüme eklenen bir 
metin kutusundan alınır. 

• LINQ deyimi bir where yan tümcesine eklendi. where Yan tümce yalnızca adı veya soyadı arama dizesini içeren 
öğrencileri seçer. LINQ deyimleri yalnızca aranacak bir değer varsa yürütülür. 

Not: Yukarıdaki kod, where metodu bir ıçueryabie nesne üzerinde çağırır ve filtre sunucuda işlenir. Bazı 














senaryolarda, uygulama bir bellek içi koleksiyonda bir genişletme where yöntemi olarak yöntemi çağırıyor olabilir. 
Örneğin, EF Core DbSet 'den _context.students bir iEnumerabie koleksiyonu döndüren bir depo yöntemine 
yapılan değişiklikleri varsayın. Sonuç normalde aynı olur, ancak bazı durumlarda farklı olabilir. 

Örneğin, uygulamasının contains .NET Framework uygulanması varsayılan olarak büyük/küçük harfe duyarlı bir 
karşılaştırma gerçekleştirir. SÖL Server, contains büyük/küçük harf duyarlılığı SQL Server örneğinin harmanlama 
ayarına göre belirlenir. SÖL Server varsayılan olarak büyük/küçük harfe duyarlı değildir. Toupper testi açık 
büyük/küçük harfe duyarsız hale getirmek için çağrılabilir: 

Where(s => s.LastName.ToUpper().Contains(searchString.ToUpper()) 

Yukarıdaki kod, kodun kullanım iEnumerabie için değişiklik yaptığı durumlarda sonuçların büyük/küçük harf 
duyarsız olmasını sağlar, contains Bir iEnumerabie koleksiyon üzerinde çağrıldığında .NET Core uygulamasını 
kullanır, contains Bir ıçueryabie nesne üzerinde çağrıldığında, veritabanı uygulamasını kullanır. iEnumerabie Bir 
depodan döndürmek önemli bir performans cezasına sahip olabilir: 

1. Tüm satırlar DB sunucusundan döndürülür. 

2. Filtre, uygulamadaki tüm döndürülen satırlara uygulanır. 

Çağırmak Toupper için bir performans cezası vardır. Toupper Kod, TSÖL SELECT ifadesinin WHERE yan tümcesine 
bir işlev ekler. Eklenen işlev, iyileştiricinin bir dizin kullanmasını önler.SÖL, büyük/küçük harfe duyarsız olarak 
yüklendiği için, gerekli olmadığında Toupper çağrının önüne geçmek en iyisidir. 

Öğrenci dizin sayfasına bir arama kutusu ekleyin 

Sayfalar/öğrenciler/lndex. cshtml' de, bir arama düğmesi ve asi grafik Chrome oluşturmak için aşağıdaki 
vurgulanmış kodu ekleyin. 

@page 

@model ContosoUniversity.Pages.Students.IndexModel 
@{ 

ViewData["Title"] = "Index"; 

} 

<h2>Index</h2> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<form asp-page="./Index" method="get"> 

<div class="form-actions no-color"> 

<P> 

Find by name: 

cinput type="text" name="SearchString" value="@Model.CurrentFilter" /> 

<input type="submit" value="Search" class="btn btn-default" /> | 

<a asp-page="./Index">Back to full List</a> 

</p> 

</div> 

</form> 

<table class="table"> 

Yukarıdaki kod, arama metin <form> kutusu ve düğme eklemek için etiket yardımcısını kullanır. Varsayılan olarak, 
<form> etiket Yardımcısı form verilerini bir gönderiyle gönderir. POST ile parametreler, URL 'de değil HTTP ileti 
gövdesine geçirilir. HTTP GET kullanıldığında, form verileri URL 'ye sorgu dizeleri olarak geçirilir.Verilerin sorgu 
dizelerine geçirilmesi, kullanıcıların URL 'Yİ yer işaretine eklemesini sağlar. W3C yönergeleri , eylem bir 
güncelleştirme ile SONUÇLANMAZSA, Get 'in kullanılması önerilir. 


Uygulamayı test edin: 





















• Öğrenciler sekmesini seçin ve bir arama dizesi girin. 

• Ara' yı seçin. 


URL ’nin arama dizesini içerdiğine dikkat edin. 

http://localhost:5000/Students?SearchString=an 

Sayfa yer işaretiyle, yer işareti sayfanın URL'sini ve searchstring sorgu dizesini içerir. method="get" Etiketi,sorgu 
form dizesinin oluşturulmasına neden oldu. 

Şu anda, bir sütun başlığı sıralama bağlantısı seçildiğinde, arama kutusundaki filtre değeri kaybedilir. Kayıp filtre 
değeri bir sonraki bölümde düzeltilir. 

Öğrenciler dizin sayfasına sayfalama işlevselliği ekleme 

Bu bölümde, sayfalama desteği PaginatedList için bir sınıf oluşturulur. Sınıfı, tablodaki tüm Take satırları almak 
yerine, sunucudaki verileri filtrelemek için ve deyimlerini kullanır skip . PaginatedList Aşağıdaki çizimde 
sayfalama düğmeleri gösterilmektedir. 


E3 lndex - Contoso Univer; X 

+ 



X 

□ 

1 


localhost 58 

☆ 

=- 

Contoso University 




— 

lndex 

Create New 






Find by name: 


Search 

| Back to Full List 

Last Name 

First Name 

Enrollment Date 



Alexander 

Carson 

9/1/2005 12:00:00 AM 

Edit | 

| Details | Delete 

Alonso 

Meredith 

9/1/2002 12:00:00 AM 

Edit | 

| Details | Delete 

Anand 

Arturo 

9/1/2003 12:00:00 AM 

Edit | 

| Details | Delete 

Previous 

Next 












Proje klasöründe aşağıdaki kodla oluşturun PaginatedList.es : 











using System; 

using System.Collections.Generic; 
using System.Linq; 
using System.Thneading.Tasks; 
using Microsoft.EntityFrameworkCore; 

namespace ContosoUniversity 

{ 

public class PaginatedList<T> : List<T> 

{ 

public int Pagelndex { get; private set; } 
public int TotalPages { get; private set; } 

public PaginatedList(List<T> items, int count, int pagelndex, int pageSize) 

{ 

Pagelndex = pagelndex; 

TotalPages = (int)Math.Ceiling(count / (double)pageSize); 
this.AddRange(items); 

} 

public bool HasPreviousPage 

{ 

get 

{ 

return (Pagelndex > 1); 

} 

} 

public bool HasNextPage 

{ 

get 

{ 

return (Pagelndex < TotalPages); 

} 

} 

public static async Task<PaginatedList<T>> CreateAsync( 

IQueryable<T> source, int pagelndex, int pageSize) 

{ 

var count = await source.CountAsync(); 
var items = await source.Skip( 

(pagelndex - 1) * pageSize) 

.Take(pageSize).ToListAsync(); 

return new PaginatedList<T>(itemSj count, pagelndex, pageSize); 

} 

} 

} 


Yukarıdaki koddaki 

skip 

Take 

ıçueryabie yöntemi sayfa boyutunu ve sayfa numarasını alır ve ' a uygun ve 

deyimlerini uygular. 

CreateAsync 

ToListAsync 

Üzerindeçağrıldığında,yalnızcaistenensayfayı ıçueryable içeren bir 

liste döndürür. Özellikler 

HasPreviousPage 

ve 

HasNextPage 

önceki ve sonraki sayfalama düğmelerini 


etkinleştirmek veya devre dışı bırakmak için kullanılır. 

Yöntemi oluşturmak için kullanılır. PaginatedList<T> CreateAsync Bir Oluşturucu PaginatedList<T> nesneyi 
oluşturamaz, oluşturucular zaman uyumsuz kod çalıştıramıyorum. 

Dizin yöntemine sayfalama işlevselliği ekleme 

Öğrenciler/lndex. cshtml. csdosyasında, türünü student ile PaginatedList<student> arasında iList<student> 
güncelleştirin: 












public PaginatedList<Student> Student { get; set; } 

Öğrenciler/lndex. cshtml. cs 

OnGetAsync 

' i aşağıdaki kodla güncelleştirin: 


public async Task OnGetAsync(string sortOrder, 

string currentFilter, string searchString, int? pagelndex) 

{ 

CurrentSort = sortOrder; 

NameSort = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 

DateSort = sortOrder == "Date" ? "date_desc" : "Date"; 
if (searchString != null) 

{ 

pagelndex = 1; 

} 

else 

{ 

searchString = currentFilter; 

} 

CurrentFilter = searchString; 

IQueryable<Student> studentIQ = from s in _context.Student 

select s; 

if (!String.IsNullOrEmpty(searchString)) 

{ 

studentIQ = studentIQ.Where(s => s.LastName.Contains(searchString) 

| s.FirstMidName.Contains(searchString)); 

} 

switch (sortOrder) 

{ 

case "name_desc": 

studentIQ = studentIQ.OrderByDescending(s => s.LastName); 
break; 

case "Date": 

studentIQ = studentIQ.OrderBy(s => s.EnrollmentDate); 
break; 

case "date_desc": 

studentIQ = studentIQ.OrderByDescending(s => s.EnrollmentDate); 
break; 
default: 

studentIQ = studentIQ.OrderBy(s => s.LastName); 
break; 

} 

int pageSize = 3; 

Student = await PaginatedList<Student>.CreateAsync( 

studentIQ.AsNoTracking(), pagelndex ?? 1, pageSize); 


Yukarıdaki kod, sayfa dizinini, geçerli sortOrder currentFilter ve öğesini Yöntem imzasına ekler. 


public async Task OnGetAsync(string sortOrder, 

string currentFilter, string searchString, int? pagelndex) 


Şu durumlarda tüm parametreler null: 

• Sayfa öğrenciler bağlantısından çağrılır. 

• Kullanıcı bir sayfalama veya sıralama bağlantısına tıklamadı. 

Bir sayfalama bağlantısına tıklandığında, sayfa dizin değişkeni görüntülenecek sayfa numarasını içerir. 

Currentsort geçerli sıralama düzeninde Razor sayfası sağlar. Disk belleği sırasında sıralama düzenini korumak için 











geçerli sıralama düzeni, sayfalama bağlantılarına eklenmelidir. 

CurrentFilter geçerli filtre dizesiyle Razor sayfasını sağlar. CurrentFilter Değer: 

• Disk belleği sırasında filtre ayarlarını korumak için disk belleği bağlantılarına eklenmelidir. 

• Sayfa yeniden görüntülendiğinde metin kutusuna geri yüklenmelidir. 

Sayfalama sırasında arama dizesi değiştirilirse sayfa 1 1 e sıfırlanır. Yeni filtre farklı verilerin görüntülenmesini 
sağladığından sayfanın 1 olarak sıfırlanması. Bir arama değeri girildiğinde ve Gönder seçildiğinde: 

• Arama dizesi değiştirildi. 

• searchstring Parametre null değil. 

if (searchstring != null) 

{ 

pagelndex = 1; 

} 

else 

{ 

searchstring = currentFilter; 

} 

Yöntemi PaginatedList.createAsync , öğrenci sorgusunu, sayfalama destekleyen bir koleksiyon türündeki tek bir 
öğrenci sayfasına dönüştürür. Bu tek öğrenci sayfası Razor sayfasına geçirilir. 

Student = await PaginatedList<Student>.CreateAsync( 

studentlÇ.AsNoTrackingO, pagelndex ?? 1 , pageSize); 

içindeki PaginatedList.createAsync iki soru işareti, null birleşim işlecinitemsil eder. Null birleşim işleci, null 
yapılabilir bir tür için varsayılan değeri tanımlar, ifade (pageindex ?? i) , bir değer pageindex içeriyorsa değerini 
döndürür anlamına gelir. pageindex Değer yoksa 1 döndürün. 

Öğrenci Razor sayfasına sayfalama bağlantıları ekleme 

Öğrenciler/lndex. cshtml'de biçimlendirmeyi güncelleştirin. Değişiklikler vurgulanır: 

@page 

@model ContosoUnlversity.Pages.Students.IndexModel 
@{ 

ViewData["Title"] = "Index"; 

} 

<h2>Index</h2> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<fonm asp-page="./Index" method="get"> 

<div class="form-actions no-color"> 

<P> 

Find by name: cinput type="text" name="SearchStrlng" value="@Model.CurrentFilter" /> 

<input type="submit" value="Search" class="btn btn-default" /> | 

<a asp-page="./Index">Back to full List</a> 

</p> 

</div> 

</form> 


<table class="table"> 












<thead> 

<tr> 

<th> 

<a asp-page="./Index" asp-route-sortOrder="@Model.NameSort" 
asp-route-currentFilter="@Model.CurrentFilter"> 
@Html.DisplayNameFor(model => model.Student[0].LastName) 

</a> 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Student[0].FirstMidName) 

</th> 

<th> 

<a asp-page="./Index" asp-route-sortOrder="@Model.DateSort" 
asp-route-currentFilter="@Model.CurrentFilter"> 
@Html.DisplayNameFor(model => model.Student[0].EnrollmentDate) 

</a> 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model.Student) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.LastName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.FirstMidName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.EnrollmentDate) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID">Details</a> | 
<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 

var prevDisabled = IModel.Student.HasPreviousPage ? "disabled" : 
var nextDisabled = IModel.Student.HasNextPage ? "disabled" : 

} 

<a asp-page="./Index" 

asp-route-sortOrder="@Model.CurrentSort" 
asp-route-pageIndex="@(Model.Student.Pagelndex - 1)" 
asp-route-currentFilter="@Model.CurrentFilter" 
class="btn btn-default @prevDisabled"> 

Previous 

</a> 

<a asp-page="./Index" 

asp-route-sortOrder="@Model.CurrentSort" 
asp-route-pageIndex="@(Model.Student.Pagelndex + 1)" 
asp-route-currentFilter="@Model.CurrentFilter" 
class="btn btn-default @nextDisabled"> 

Next 

</a> 


Sütun üst bilgisi bağlantıları, kullanıcının filtre sonuçları içinde sıralama yapabilmesi için geçerli arama dizesini 
onGetAsync yöntemine geçirmek üzere sorgu dizesini kullanır: 



<a asp-page="./Index" asp-route-sortOrder="@Model.NameSort" 
asp-route-currentFilter="@Model.CurrentFilter"> 
@Html.DisplayNameFor(model => model.Student[0].LastName) 

</a> 


Sayfalama düğmeleri etiket yardımcıları tarafından görüntülenir: 


<a asp-page="./Index" 

asp-route-sortOrder="@Model.CurrentSort" 
asp-route-pageIndex="@(Model.Student.PageIndex - 1)" 
asp-route-currentFilter="@Model.CurrentFilter" 
class="btn btn-default @prevDisabled"> 

Previous 

</a> 

<a asp-page="./Index" 

asp-route-sortOrder="@Model.CurrentSort" 
asp-route-pageIndex="@(Model.Student.PageIndex + 1)" 
asp-route-currentFilter="@Model.CurrentFilter" 
class="btn btn-default @nextDisabled"> 

Next 

</a> 


Uygulamayı çalıştırın ve öğrenciler sayfasına gidin. 

• Sayfalama 1 nin çalıştığından emin olmak için, farklı sıralama emirlerindeki disk belleği bağlantılarına tıklayın. 

• Disk belleğinin sıralama ve filtreleme ile düzgün çalıştığını doğrulamak için bir arama dizesi girin ve sayfalama 
yapmayı deneyin. 



Kodu daha iyi anlamak için: 


Öğrenciler/lndex. cshtml. csdosyasında, üzerinde switch (sortorder) bir kesme noktası ayarlayın. 

, NameSort , Ve DateSort CurrentSort için birizlemeekleyin. Model.Student.PageIndex 

Öğrenciler/lndex. cshtml'de, üzerinde @Htmi.DispiayNaneFor(modei => model.student[0] .LastName) bir kesme 
noktası ayarlayın. 
















Hata ayıklayıcıda adım adım. 


Öğrenci istatistiklerini göstermek için hakkında sayfasını güncelleştirin 

Bu adımda, Sayfalar/about. cshtml, her bir kayıt tarihi için kaç öğrenciye kaydolduğunu görüntüleyecek şekilde 
güncelleştirilir. Güncelleştirme gruplamayı kullanır ve aşağıdaki adımları içerir: 

• Hakkında sayfasında kullanılan veriler için bir görünüm modeli oluşturun. 

• Görünüm modelini kullanmak için hakkında sayfasını güncelleştirin. 

Görünüm modeli oluşturma 

Modeller klasöründe bir SchoolViewModels klasörü oluşturun. 

SchoolViev/Models klasöründe aşağıdaki kodla bir EnrollmentDateGroup.es ekleyin: 

using System; 

using System.ComponentModel.DataAnnotations; 

namespace ContosoUniversity.Models.SchoolViewModels 
{ 

public elass EnrollmentDateGroup 
{ 

[DataType(DataType.Date) ] 

public DateTime? EnnollmentDate { get; set; } 
public int StudentCount { get; set; } 

} 

} 

Hakkında sayfa modelini Güncelleştir 

ASP.NET Core 2,2 ' deki Web şablonları hakkında sayfasını içermez. ASP.NET Core 2,2 kullanıyorsanız, Razor 
hakkında sayfasını oluşturun. 

Pages/about. cshtml. es dosyasını aşağıdaki kodla güncelleştirin: 





using ContosoUniversity.Models.SchoolViewModels; 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using Microsoft.EntityFrameworkCore; 

using System.Collections.Generic; 

using System.Linq; 

using System.Threading.Tasks; 

using ContosoUniversity.Models; 

namespace ContosoUniversity.Pages 

{ 

public class AboutModel : PageModel 

{ 

private readonly SchoolContext _context; 

public AboutModel(SchoolContext context) 

{ 

_context = context; 

} 

public IList<EnrollmentDateGroup> Student { get; set; } 

public async Task OnGetAsync() 

{ 

IQueryable<EnrollmentDateGroup> data = 
from student in _context.Student 

group student by student.EnrollmentDate into dateGroup 
select new EnrollmentDateGroup() 

{ 

EnrollmentDate = dateGroup.Key, 

StudentCount = dateGroup.Count() 

}; 

Student = await data.AsNoTrackingO.ToListAsync(); 

} 

} 

} 


LINQ beyanı, öğrenci varlıklarını kayıt tarihine göre gruplandırır, her bir gruptaki varlıkların sayısını hesaplar ve 
sonuçları bir EnroiimentDateGroup görünüm modeli nesneleri koleksiyonunda depolar. 

Razor hakkında sayfasında değişiklik yapma 

Pages/about. cshtml dosyasındaki kodu aşağıdaki kodla değiştirin: 





@page 

@model Contosollniversity. Pages. AboutModel 


ViewData["Title"] = "Student Body Statistics"; 

} 

<h2>Student Body Statistics</h2> 

<table> 

<tr> 

<th> 

Enrollment Date 
</th> 

<th> 

Students 

</th> 

</tr> 

@foreach (var item in Model.Student) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.EnrollmentDate) 
</td> 

<td> 

(Şitem.StudentCount 

</td> 

</tr> 

} 

</table> 


Uygulamayı çalıştırın ve hakkında sayfasına gidin. Her kayıt tarihi için öğrenci sayısı bir tabloda görüntülen 
Çözemediğiniz sorunlarla karşılaşırsanız, Bu aşama için tamamlanmış uygulamayıindirin. 


E3 Student Body Statîsti» X 

+ - □ 

X 

<- o | 

localhost ^ 

... 

Contoso University 
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Student Body Statistics 


Enrollment DateStudents 

9/1/2001 1 

9/1/2002 3 

9/1/2003 2 

9/1/2005 1 

9/2/2005 1 


Ek kaynaklar 

• 2.x kaynağı AS P.N ET Core hata ayıklaması 

• Bu öğreticinin YouTube sürümü 

Sonraki öğreticide, uygulama, veri modelini güncelleştirmek için geçişleri kullanır. 
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, Tom Dykstra, Jon P Smithve Rick Anderson 

Contoso Üniversitesi web uygulaması, EF Core ve Visual Studio kullanarak Razor Pages Web uygulamaları 
oluşturmayı gösterir. Öğretici serisi hakkında daha fazla bilgi için ilk öğreticiyebakın. 

Çözemediğiniz sorunlarla karşılaşırsanız, Tamamlanmış uygulamayı indirin ve öğreticiyi izleyerek bu kodu 
oluşturduğunuz şekilde karşılaştırın. 

Bu öğreticide, veri modeli değişikliklerini yönetmek için EF Core geçişleri özelliği tanıtılmıştır. 

Yeni bir uygulama geliştirildiğinde, veri modeli sıklıkla değişir. Modelin her değiştirilişinde, model veritabanıyla 
eşitlenmemiş olur. Bu öğretici serisi, mevcut değilse veritabanını oluşturmak için Entity Framevvork yapılandırılarak 
başlatılır. Veri modelinin her değiştirilişinde veritabanını bırakmalısınız. Uygulamanın bir sonraki çalıştırışında, 
EnsureCreated çağrısı yeni veri modeliyle eşleşecek şekilde veritabanını yeniden oluşturur. Dbinitializer sınıfı, 
yeni veritabanını temel alarak çalışır. 

Veritabanını veri modeliyle eşitlenmiş halde tutmaya yönelik bu yaklaşım, uygulamayı üretime dağıtana kadar iyi 
çalışır. Uygulama üretimde çalıştığında genellikle saklanması gereken verileri depolar. Uygulama her değişiklik 
yapıldığında (yeni sütun ekleme gibi) bir test veritabanıyla başlayamaz. EF Core geçişleri özelliği, yeni bir veritabanı 
oluşturmak yerine EF Core veritabanı şemasını güncelleştirmesine olanak sağlayarak bu sorunu çözer. 

Veri modeli değiştiğinde veritabanını bırakıp yeniden oluşturmak yerine, geçişler şemayı güncelleştirir ve var olan 
verileri korur. 


NOTE 

SQLite sınırlamaları 

Bu öğretici, mümkün olduğunda Entity Framevvork Cor e geçişleri özelliğini kullanır. Geçişler, veritabanı şemasını veri 
modelindeki değişikliklerle eşleşecek şekilde güncelleştirir. Bununla birlikte, geçişler yalnızca veritabanı altyapısının desteklediği 
değişiklik türlerini ve SQLİte 'un şema değiştirme özellikleri sınırlıdır. Örneğin, bir sütun ekleme desteklenir, ancak bir sütunu 
kaldırmak desteklenmez. Bir sütunu kaldırmak için bir geçiş oluşturulduysa, ef migrations add komut başarılı olur 
ef database update ancak komut başarısız olur. 

SQLİte sınırlamalarına yönelik geçici çözüm, tablodaki bir şeyler değiştiğinde tablo yeniden oluşturmak için geçiş kodunu el ile 
yazmak için kullanılır. Kod, up bir geçiş için ve Down yöntemlerine gidip şunları içerir: 

• Yeni bir tablo oluşturuluyor. 

• Eski tablodaki veriler yeni tabloya kopyalanıyor. 

• Eski tablo bırakılıyor. 

• Yeni tablo yeniden adlandırılıyor. 

Bu türün veritabanına özgü kodu yazma, Bu öğreticinin kapsamı dışındadır. Bunun yerine, bu öğretici bir geçiş uygulama 
girişimi başarısız olduğunda veritabanını bırakır ve yeniden oluşturur. Daha fazla bilgi için aşağıdaki kaynaklara bakın: 

• SQLİte EF Core veritabanı sağlayıcısı sınırlamaları 

• Geçiş kodunu özelleştirme 

• Veri dengeli dağıtımı 

• SQLİte ALTER TABLE ifadesi 






Veritabanını bırak 


• Visual Studio 

• Visual Studio Code 

Veritabanını silmek için SQL Server Nesne Gezgini (ssox) kullanın veya Paket Yöneticisi konsolunda (PMC) 
komutu çalıştırın: 

Drop-Database 


İlk geçiş oluşturma 

• Visual Studio 

• Visual Studio Code 

PMC 'de şu komutları çalıştırın: 

Add-Migration InitialCreate 
Update-Database 


Yukarı ve aşağı Yöntemler 

EF Core migrations add komut, veritabanını oluşturmak için kodu oluşturdu. Bu geçiş kodu geçişleri<zaman 
damgasmda _lnitialCreate. cs dosyasmda > . InitialCreate sınıfının up yöntemi, veri modeli varlık kümelerine 
karşılık gelen veritabanı tablolarını oluşturur. Down yöntemi, aşağıdaki örnekte gösterildiği gibi onları siler: 

using System; 

using Microsoft.EntityFrameworkCore.Metadata; 
using Microsoft.EntityFrameworkCore.Migrations; 

namespace ContosoUniversity.Migrations 

{ 

public partial class InitialCreate : Migration 

{ 

protected override void Up(MigrationBuilder migrationBuilder) 

{ 

migrationBuilder.CreateTable( 
name: "Course", 
columns: table => new 
{ 

CourselD = table.Column<int>(nullable: false), 

Title = table.Column<string>(nullable: true), 

Credits = table.Column<int>(nullable: false) 

}, 

constraints: table => 

{ 

table.PrimaryKey("PK_Course", x => x.CourselD); 

}); 

migrationBuilder.CreateTable( 
name: "Student", 
columns: table => new 
{ 

ID = table.Column<int>(nullable: false) 

.Annotation("SqlServer:ValueGenerationStrategy", 

SqlServerValueGenerationStrategy.IdentityColumn ), 

LastName = table.Column<string>(nullable: true), 

FirstMidName = table.Column<string>(nullable: true), 

EnrollmentDate = table.Column<DateTime>(nullable: false) 
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constraints: table => 

{ 

table.PrimaryKey("PK_Student", x => x.ID); 

}); 

migrationBuilder.CreateTable( 
name: "Enrollment", 
columns: table => new 
{ 

EnrollmentlD = table.Column<int>(nullable: false) 

.Annotation("SqlServer:ValueGenerationStrategy", 
SqlSenverValueGenerationStrategy.IdentityColumn), 

CounselD = table.Column<int>(nullable: false), 

StudentlD = table.Column<int>(nullable: false), 

Grade = table.Column<int>(nullable: true) 

constraints: table => 

{ 

table.PrimaryKey("PK_Enrollment", x => x.EnrollmentlD); 
table.ForeignKey( 

name: "FK_Enrollment_Course_CourseID", 
column: x => x.CourseID, 
principalTable: "Course", 
principalColumn: "CourselD", 
onDelete: ReferentialAction.Cascade); 
table.ForeignKey( 

name: "FK_Enrollment_Student_StudentID", 
column: x => x.StudentlD, 
principalTable: "Student", 
principalColumn: "ID", 
onDelete: ReferentialAction.Cascade); 

}); 

migrationBuilder.Createlndex( 

name: "IX_Enrollment_CourseID", 
table: "Enrollment", 
column: "CourselD"); 

migrationBuilder.Createlndex( 

name: "IX_Enrollment_StudentID", 
table: "Enrollment", 
column: "StudentlD"); 

} 

protected override void Down(MigrationBuilder migrationBuilder) 

{ 

migrationBuilder.DropTable( 
name: "Enrollment"); 

migrationBuilder.DropTable( 
name: "Course"); 


} 


} 


} 


migrationBuilder.DropTable( 
name: "Student"); 


Önceki kod ilk geçişe yöneliktir. Kod: 


• migrations add initiaicreate komutu tarafından oluşturuldu. 

• database update komutu tarafından yürütülür. 

• Veritabanı bağlamı sınıfı tarafından belirtilen veri modeli için bir veritabanı oluşturur. 


Dosya adı için geçiş adı parametresi (örnekteki "initiaicreate") kullanılır.Geçiş adı herhangi bir geçerli dosya adı 



olabilir. Geçiş sırasında nelerin yapıldığını özetleyen bir sözcük veya tümcecik seçmek en iyisidir.Örneğin, bir 
departman tablosu ekleyen bir geçişe "AddDepartmentTable" adı verilir. 

Geçişler geçmiş tablosu 

• Veritabanını incelemek için SSOX veya SQLİte aracınızı kullanın. 

• _EFMigrationsHistory tablo ekleme hakkında dikkat edin. _ EFMigrationsHistory tablo, hangi geçişlerin 

veritabanına uygulandığını izler. 

• _EFMigrationsHistory tablosundaki verileri görüntüleyin, ilk geçiş için bir satır gösterir. 

Veri modeli anlık görüntüsü 

Geçişler, geçiş/SchoolContextModelSnapshot. csiçindeki geçerli veri modelinin anlık görüntüsünü oluşturur. Bir 
geçiş eklediğinizde, EF geçerli veri modelini Snapshot dosyası ile karşılaştırarak nelerin değiştirildiğini belirler. 

Anlık görüntü dosyası veri modelinin durumunu izlediğinden, <timestamp>_<migrationname>.cs dosyasını silerek bir 
geçişi silemezsiniz. En son geçişi geri yüklemek için migrations remove komutunu kullanmanız gerekir. Bu komut, 
geçişi siler ve anlık görüntünün doğru şekilde sıfırlanmasını sağlar. Daha fazla bilgi için bkz. DotNet EF geçişleri 
kaldır. 

Yeniden oluşturulmasını kaldır 

Bu öğretici serisi EnsureCreated kullanılarak başlatıldı. EnsureCreated geçişler geçmişi tablosu oluşturmaz ve 
geçişle birlikte kullanılamaz. Bu, veritabanının düşürülme ve sıklıkla yeniden oluşturulduğu test veya hızlı prototip 
oluşturma için tasarlanmıştır. 

Bu noktadan sonra öğreticiler, geçişleri kullanacaktır. 

Data/Dbınınitializer. csdosyasında aşağıdaki satırı açıklama olarak inceleyin: 

context.Database.EnsureCreated(); 

Uygulamayı çalıştırın ve veritabanının çalıştığını doğrulayın. 

Üretimde geçişleri uygulama 

Uygulama başlangıcında, üretim uygulamalarının Database. Migrate olarak çağırmalarını öneririz, sunucu 
grubuna dağıtılan bir uygulamadan Migrate çağrılmamalıdır. Uygulama birden çok sunucu örneğine 
ölçekleniyorsa, veritabanı şeması güncelleştirmelerinin birden çok sunucudan oluşmaması veya okuma/yazma 
erişimiyle çakışmamasını sağlamak zordur. 

Veritabanı geçişi, dağıtımın bir parçası olarak ve denetimli bir şekilde yapılmalıdır. Üretim veritabanı geçiş 
yaklaşımları şunları içerir: 

• SQL betikleri oluşturmak ve dağıtımda SQL betikleri kullanmak için geçişleri kullanma. 

• Denetlenen bir ortamdan dotnet ef database update çalıştırılıyor. 

Sorun giderme 

Uygulama SQL Server LocalDB kullanıyorsa ve aşağıdaki özel durumu görüntülüyorsa: 

SqlException: Cannot öpen database "ContosoUniversity" requested by the login. 

The login failed. 

Login failed for user 'user name'. 














Çözüm, bir komut isteminde dotnet ef database update çalıştırmak olabilir. 


Ek kaynaklar 

• Clı EF Core. 

• Paket Yöneticisi Konsolu (Visual Studio) 

Sonraki adımlar 

Sonraki öğreticide, veri modeli, varlık özellikleri ve yeni varlıklar eklenerek oluşturulur. 


ÖNCEKİ ■ SONRAKİ 

ÖĞRETİCİ ■ ÖĞRETİCİ 


Bu öğreticide, veri modeli değişikliklerini yönetmek için EF Core geçişleri özelliği kullanılır. 

Çözemediğiniz sorunlarla karşılaşırsanız, Tamamlanmış uygulamayıindirin. 

Yeni bir uygulama geliştirildiğinde, veri modeli sıklıkla değişir. Modelin her değiştirilişinde, model veritabanıyla 
eşitlenmemiş olur. Bu öğretici, mevcut değilse veritabanını oluşturmak için Entity Framevvork yapılandırılarak 
başlatılır. Veri modelinin her değiştirilişinde: 

• DB bırakılır. 

• EF, modelle eşleşen yeni bir tane oluşturur. 

• Uygulama, DB 'yi test verileriyle birlikte oluşturur. 

Bu yaklaşım, VERITABANıNı veri modeliyle eşitlenmiş halde tutmak, uygulamayı üretime dağıtana kadar iyi çalışı 
Uygulama üretimde çalıştığında genellikle saklanması gereken verileri depolar. Uygulama her değişiklik 
yapıldığında (yeni sütun ekleme gibi) bir test DB ile başlayamaz. EF Core geçişleri özelliği, yeni bir VERITABANı 
oluşturmak yerine EF Core DB şemasını güncelleştirmesine olanak sağlayarak bu sorunu çözer. 

Veri modeli değiştiğinde VERITABANıNı bırakıp yeniden oluşturmak yerine, geçişler şemayı güncelleştirir ve 
mevcut verileri korur. 

Veritabanını bırak 

SQL Server Nesne Gezgini (ssox) veya database drop komutunu kullanın: 

• Visual Studio 

• Visual Studio Code 

Paket Yöneticisi konsolunda (PMC), aşağıdaki komutu çalıştırın: 

Drop-Database 

Yardım bilgileri almak için PMC'ten Get-Help about_EntityFramewori<core çalıştırın. 

İlk geçiş oluşturma ve VERITABANıNı güncelleştirme 

Projeyi derleyin ve ilk geçişi oluşturun. 

• Visual Studio 

• Visual Studio Code 









Add-Migration InitialCreate 
Update-Database 


Yukarı ve aşağı yöntemlerini inceleyin 

EF Core migrations add komutu VERITABANıNı oluşturmak için kodu oluşturdu. Bu geçiş kodu geçişleri<zaman 
damgasında JnitialCreate. cs dosyasında > . ınitialcreate sınıfının up yöntemi, veri modeli varlık kümelerine 
karşılık gelen VERITABANı tablolarını oluşturur. Down yöntemi, aşağıdaki örnekte gösterildiği gibi onları siler: 

public partial class InitialCreate : Migration 
{ 

protected override void Up(MigrationBuilder migrationBuilder) 

{ 

migrationBuilder.CreateTable( 
name: "Course"j 
columns: table => new 
{ 

CourselD = table.Column<int>(nullable: false), 

Title = table.Column<string>(nullable: true), 

Credits = table.Column<int>(nullable: false) 

}, 

constraints: table = > 

{ 

table.PrimaryKey("PK_Course"j x => x.CourselD); 

}); 

migrationBuilder.CreateTable( 

protected override void Down(MigrationBuilder migrationBuilder) 

{ 

migrationBuilder.DropTable( 
name: "Enrollment"); 

migrationBuilder.DropTable( 
name: "Course"); 

migrationBuilder.DropTable( 
name: "Student"); 

} 

} 

Geçişler, bir geçiş için veri modeli değişikliklerini uygulamak üzere up yöntemini çağırır. Güncelleştirmeyi geri 
almak için bir komut girdiğinizde, geçişler Down yöntemini çağırır. 

Önceki kod ilk geçişe yöneliktir. Bu kod, migrations add InitialCreate komutu çalıştırıldığında oluşturulmuştur. 
Dosya adı için geçiş adı parametresi (örnekteki "ınitialcreate") kullanılır.Geçiş adı herhangi bir geçerli dosya adı 
olabilir. Geçiş sırasında nelerin yapıldığını özetleyen bir sözcük veya tümcecik seçmek en iyisidir.Örneğin, bir 
departman tablosu ekleyen bir geçişe "AddDepartmentTable" adı verilir. 

ilk geçiş oluşturulur ve VERITABANı varsa: 

• DB oluşturma kodu oluşturulur. 

• DB, veri modeliyle zaten eşleştiğinden, DB oluşturma kodunun çalıştırılması gerekmiyor. DB oluşturma kodu 
çalıştırılsa, VERITABANı veri modeliyle zaten eşleştiğinden hiçbir değişiklik yapmaz. 

Uygulama yeni bir ortama dağıtıldığında, DB oluşturmak için DB oluşturma kodunun çalıştırılması gerekir. 

Daha önce VERITABANı bırakılmıştı ve mevcut olmadığından geçişler yeni DB 'yi oluşturur. 

Veri modeli anlık görüntüsü 

Geçişler geçişlerde/SchoolContextModelSnapshot. cs' de geçerli veritabanı şemasının anlık görüntüsünü oluşturur. 
Bir geçiş eklediğinizde EF, veri modeli Snapshot dosyası ile karşılaştırılarak nelerin değiştirildiğini belirler. 













Bir geçişi silmek için aşağıdaki komutu kullanın: 

• Visual Studio 

• Visual Studio Code 

Geçişi Kaldır 

Geçişleri Kaldır komutu geçişi siler ve anlık görüntünün doğru şekilde sıfırlanmasını sağlar. 

Uygulamayı kaldırın ve uygulamayı test edin 

Erken geliştirme için EnsureCreated kullanıldı. Bu öğreticide geçişler kullanılır. EnsureCreated aşağıdaki 
sınırlamalara sahiptir: 

• Geçişleri atlar ve DB ve şema oluşturur. 

• Geçişler tablosu oluşturmaz. 

• Geçişleri e kullanılamaz. 

• , DB ’nin bıraktığı ve sıklıkla yeniden oluşturulduğu test veya hızlı prototipleme için tasarlanmıştır. 



Veritabanını inceleyin 

DB 'yi denetlemek için SQL Server Nesne Gezgini kullanın. _ EFMigrationsHistory tablo ekleme hakkında dikkat 

edin. _ EFMigrationsHistory tablo, hangi geçişlerin VERITABANıNA uygulandığını izler. _ EFMigrationsHistory 

tablosundaki verileri görüntüleyin, ilk geçiş için bir satır gösterir. Önceki CLı çıkış örneğinde yer alan son oturum, bu 
satırı oluşturan INSERT ifadesini gösterir. 

Uygulamayı çalıştırın ve her şeyin çalıştığını doğrulayın. 

Üretimde geçişleri uygulama 

Uygulama başlangıcında, üretim uygulamalarının Database. Migrate çağrısını yapmanızı öneririz, sunucu 
grubundaki bir uygulamadan Migrate çağrılmamalıdır. Örneğin, uygulama bulutu genişleme ile dağıtılmışsa 
(uygulamanın birden çok örneği çalışır). 

Veritabanı geçişi, dağıtımın bir parçası olarak ve denetimli bir şekilde yapılmalıdır. Üretim veritabanı geçiş 
yaklaşımları şunları içerir: 

• SÖL betikleri oluşturmak ve dağıtımda SOL betikleri kullanmak için geçişleri kullanma. 

• Denetlenen bir ortamdan dotnet ef database update çalıştırılıyor. 

EF Core, herhangi bir geçişin çalıştırılması gerektiğini görmek için _ MigrationsHistory tablosunu kullanır. DB 

güncel değilse, hiçbir geçiş çalıştırılmaz. 

Sorun giderme 

Tamamlanmış uygulamayıindirin. 

Uygulama aşağıdaki özel durumu oluşturur: 










SqlException: Cannot öpen database "ContosoUniversity" requested by the login. 
The login failed. 

Login failed for user ’user name’. 


Çözüm: 


dotnet ef database update 


Çalıştır 


Ek kaynaklar 

• Bu öğreticinin YouTube sürümü 

• .NETCoreCLI. 

• Paket Yöneticisi Konsolu (Visual Studio) 
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ASRNET Core veri modelinde EF Core ile Razor 
Pages-5/8 

23.11.2019 * 86 minutes to read ı Edit Online 


Tarafından Tom Dykstra ve Rick Anderson 

Contoso Üniversitesi web uygulaması, EF Core ve Visual Studio kullanarak Razor Pages Web uygulamaları 
oluşturmayı gösterir. Öğretici serisi hakkında daha fazla bilgi için ilk öğreticiyebakın. 

Çözemediğiniz sorunlarla karşılaşırsanız, Tamamlanmış uygulamayı indirin ve öğreticiyi izleyerek bu kodu 
oluşturduğunuz şekilde karşılaştırın. 

Önceki öğreticiler, üç varlıktan oluşan temel bir veri modeliyle çalışmıştır.Bu öğreticide: 

• Daha fazla varlık ve ilişki eklenmiştir. 

• Veri modeli biçimlendirme, doğrulama ve veritabanı eşleme kuralları belirtilerek özelleştirilir. 
Tamamlanan veri modeli aşağıdaki çizimde gösterilmiştir: 
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Öğrenci varlık 


Student 


Properties 
V? İD 

f* LastName 
A FirstMidName 
A" EnrolImentDate 
Navigation Properties 
{3 Enrollments 


Modeller/öğrenci, cs dosyasındaki kodu aşağıdaki kodla değiştirin: 

using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Student 

{ 

public int ID { get; set; } 

[Required] 

[StringLength(50)] 

[Display(Name = "Last Name")] 
public stning LastName { get; set; } 

[Required] 

[StringLength(50, ErrorMessage = "First name cannot be longer than 50 characters.")] 
[Column("FirstName")] 

[Display(Name = "First Name")] 

public string FirstMidName { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 

[Display(Name = "Enrollment Date")] 

public DateTime EnrolImentDate { get; set; } 

[Display(Name = "Full Name")] 
public string FullName 
{ 

get 

{ 

return LastName + ", " + FirstMidName; 

} 

} 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 

Yukarıdaki kod, bir FullName özelliği ekler ve var olan özelliklere aşağıdaki öznitelikleri ekler: 


• [DataType] 

• [DisplayFormat] 

• [StringLength] 

• [Column] 

• [Required] 

• [Display] 


FullName hesaplanmış özelliği 

FullName , diğer iki özelliği birleştirerek oluşturulmuş bir değer döndüren hesaplanmış bir özelliktir. FullName 












ayarlanamaz, bu nedenle yalnızca bir get erişimcisi vardır. Veritabanında FuliName sütunu oluşturulmaz. 


DataType özniteliği 

[DataType(DataType.Date)] 

Öğrenci kayıt tarihleri için, tüm sayfalar şu anda tarihle birlikte tarih ile görüntülenir, ancak yalnızca tarihin ilgili 
olması gerekir. Veri ek açıklaması özniteliklerini kullanarak, verileri gösteren her sayfada görüntü biçimini giderecek 
bir kod değişikliği yapabilirsiniz. 

DataType özniteliği, veritabanı iç türünden daha belirgin bir veri türünü belirtir. Bu durumda, tarih ve saat değil 
yalnızca tarih görüntülenmelidir. Veri türü numaralandırması , tarih, saat, PhoneNumber, para birimi, emaadresi vb. 
gibi birçok veri türü sağlar. DataType özniteliği Ayrıca uygulamanın türe özgü özellikleri otomatik olarak 
sağlamasını da sağlayabilir. Örneğin: 

• mailto: bağlantısı DataType.EmailAddress için otomatik olarak oluşturulur. 

• Tarih Seçici çoğu tarayıcıda DataType.Date için sağlanır. 

DataType özniteliği HTML 5 data- (bir veri Dash) öznitelikleri yayar. DataType öznitelikleri doğrulama sağlamaz. 

DisplayFormat özniteliği 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd }", ApplyFormatlnEditMode = true)] 


DataType.Date görüntülenen tarihin biçimini belirtmiyor. Varsayılan olarak, Tarih alanı sunucunun 
Culturelnfoöğesine göre varsayılan biçimlere göre görüntülenir. 


DisplayFormat özniteliği, açıkça tarih biçimini belirtmek için kullanılır. ApplyFormatlnEditMode ayarı, 
biçimlendirmenin düzenleme kullanıcı arabirimine de uygulanacağını belirtir. Bazı alanlar ApplyFormatlnEditMode 
kullanmamalıdır. Örneğin, para birimi simgesi genellikle bir düzenleme metin kutusunda gösterilmemelidir. 


DisplayFormat özniteliği kendisi tarafından kullanılabilir. DataType özniteliğini DisplayFormat özniteliğiyle 
kullanmak genellikle iyi bir fikirdir. DataType özniteliği, verilerin semantiğini bir ekranda nasıl işleneceğini tersine 
alır. DataType özniteliği, DisplayFormat kullanılamayan aşağıdaki avantajları sağlar: 


• Tarayıcı HTML5 özelliklerini etkinleştirebilir.Örneğin, bir Takvim denetimini, yerel ayara uygun para birimi 
sembolünü, e-posta bağlantılarını ve istemci tarafı giriş doğrulamasını gösterin. 

• Varsayılan olarak tarayıcı, verileri yerel ayara göre doğru biçimi kullanarak işler. 


Daha fazla bilgi için bkz. giriş > etiketi Yardımcısı belgeleri< . 

StringLength özniteliği 

[StringLength(50j ErrorMessage = "First name cannot be longer than 50 characters.")] 

Veri doğrulama kuralları ve doğrulama hatası iletileri özniteliklerle belirtilebilir. StringLength özniteliği, bir veri 
alanında izin verilen en düşük ve en fazla karakter uzunluğunu belirtir. Gösterilen kod, adları 50 karakterden fazla 
olmayacak şekilde sınırlar. En küçük dize uzunluğunu ayarlayan bir örnek daha sonragösterilmiştir. 

özniteliği de istemci tarafı ve sunucu tarafı doğrulaması sağlar. En küçük değerin veritabanı şeması 
r etkisi yoktur. 

StringLength özniteliği, kullanıcının bir ad için boşluk girmesini engellemez. Cevap içerisinde RegularExpression 
özniteliği, girişe kısıtlamalar uygulamak için kullanılabilir. Örneğin, aşağıdaki kod ilk karakterin büyük küçük harf 
olmasını ve geri kalan karakterlerin alfabetik olmasını gerektirir: 


StringLength 
üzerinde hiçbi 



















[RegularExpression(@" A [A-Z]+[a-zA-Z.\s-]*$")] 


• Visual Studio 

• Visual Studio Code 


SQL Server Nesne Gezgini (ssox) içinde öğrenci tablosuna çift tıklayarak öğrenci tablosu tasarımcısını açın. 



Önceki görüntüde student tablo şeması gösterilmektedir. Ad alanlarında tür nvarchar(MAX) vardır. Bu öğreticide 
daha sonra bir geçiş oluşturulup uygulandığında, ad alanları dize uzunluğu özniteliklerinin bir sonucu olarak 
nvarchar(50) olur. 

Column özniteliği 

[Column("FirstName")] 

public string FirstMidName { get; set; } 

Öznitelikler sınıfların ve özelliklerin veritabanına nasıl eşlenildiğini denetleyebilir, student modelinde, column 
özniteliği, FirstMidName özelliğinin adını veritabanında "FirstName" olarak eşlemek için kullanılır. 

Veritabanı oluşturulduğunda, model üzerindeki özellik adları sütun adları için kullanılır ( column özniteliği 
kullanıldığı durumlar dışında), student modeli ilk ad alanı için FirstMidName kullanır, çünkü alan de bir orta ad 
içerebilir. 

[Column] özniteliğiyle, veri modelindeki student.FirstMidName student tablonun FirstName sütunuyla eşlenir, 
column özniteliğinin eklenmesi modeli schooicontext yedekleyen şekilde değiştirir. schooicontext yedekleyen 
model artık veritabanıyla eşleşmez. Bu tutarsızlık, daha sonra bu öğreticide bir geçiş eklenerek çözümlenir. 

Gerekli öznitelik 

[Required] 

Required özniteliği, ad özellikleri gereken alanları sağlar. Değer türleri gibi null yapılamayan türler için Required 
özniteliği gerekmez (örneğin, DateTime , int ve double ). Null olmayan türler otomatik olarak gerekli alanlar olarak 
değerlendirilir. 

MinimumLength zorlanmak için Required özniteliği MinimumLength ile birlikte kullanılmalıdır. 






























[Display(Name = "Last Name")] 

[Required] 

[StningLength(50j MinimumLength=2)] 
public string LastName { get; set; } 

MinimumLength ve Required , doğrulamanın doğrulanmasını yerine getirmek için boşluk kullanılmasına izin verir. 
Dize üzerinde tam denetim için ReguiarExpression özniteliğini kullanın. 

Display özniteliği 

[Display(Name = "Last Name")] 

Display özniteliği, metin kutularının açıklamalı altyazısının "ad", "soyadı", "tam ad" ve "kayıttarihi" olması 
gerektiğini belirtir. Varsayılan açıklamalı altyazıların sözcükleri bölen bir boşluk yoktu, örneğin "LastName". 

Geçiş oluşturma 

Uygulamayı çalıştırın ve öğrenciler sayfasına gidin. Bir özel durum oluşturulur. [Column] özniteliği, EF 'in 
FirstName adlı bir sütun bulmasını beklemesine neden olur, ancak veritabanındaki sütun adı hala FirstMidName . 

• Visual Studio 

• Visual Studio Code 

Hata iletisi aşağıdaki örneğe benzer: 

SqlException: Invalid column name 'FirstName'. 


• PMC 'de yeni bir geçiş oluşturmak ve veritabanını güncelleştirmek için aşağıdaki komutları girin: 

Add-Migration ColumnFirstName 
Update-Database 


Bu komutlardan ilki aşağıdaki uyarı iletisini oluşturur: 


An operation was scaffolded that may result in the loss of data. 
Please review the migration for accuracy. 


Ad alanları artık 50 karakterle sınırlı olduğundan uyarı oluşturulur. Veritabanındaki bir ad 50 karakterden 
fazlasına sahipse, son karakter 51 1 i kaybedersiniz. 

• Öğrenci tablosunu SSOX içinde açın: 









0^ ContosoUniversity 

□ 


_ n x 

♦ 

Update Script File: 

dbo.Students.sql 

—— 


Name 

Data Type 

Allovv Nulls 

a Keys (1) 


«o id 

EnrollmentDate 

int 

datetime2(7) 

□ 

□ 

PK_Students (Primary Key, Clı 

Check Constraints (0) 
lndexes (9) 

Foreign Keys (0) 


FirstName 

nvarchar(50) 

0 


LastName 

nvarchar(50) 

0 

Triggers (0) 


d Design ti a T-SQL ___ IH □ E] 

1 CREATE TABLE [dbo].[Students] ( |£ 

2 [ID] INT IDENTITY (1, 1) NOT NULL, * 

3 [EnrollmentDate] DATETIME2 (7) NOT NULL, 

4 [FirstName] NVARCHAR (50) NULL, 

5 [LastName] NVARCHAR (50) NULL, — 

CONSTRAINT [PK_Students] PRIMARY KEY CLUSTERED ([ID] ASC) 

7 ); 

8 

100% - i ► 


Geçiş uygulanmadan önce ad sütunları nvarchar (max)türünde idi. Ad sütunları artık nvarchar(50) . Sütun 
adı, FirstMidName FirstName olarak değiştirildi. 

• Uygulamayı çalıştırın ve öğrenciler sayfasına gidin. 

• Saatin giriş veya tarih ile birlikte görüntülenmediğine dikkat edin. 

• Yeni oluştur 1 u seçin ve 50 karakterden daha uzun bir ad girmeyi deneyin. 


NOTE 

Aşağıdaki bölümlerde, uygulamanın bazı aşamalardan oluşturulması derleyici hataları oluşturur. Yönergeler uygulamanın ne 
zaman derbir olduğunu belirtir. 


Eğitmen varlığı 
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Aşağıdaki kodla modeller/eğitmen, cs oluşturun: 




















using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Instructor 

{ 

public int ID { get; set; } 

[Required] 

[Display(Name = "Last Name")] 

[StringLength(50)] 

public stning LastName { get; set; } 

[Required] 

[Column("FinstName")] 

[Display(Name = "First Name")] 

[StringLength(50)] 

public string FirstMidName { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 

[Display(Name = "Flire Date")] 
public DateTime HireDate { get; set; } 

[Display(Name = "Full Name")] 
public string FullName 
{ 

get { return LastName + ", " + FirstMidName; } 

} 

public ICollection<CourseAssignment> CourseAssignments { get; set; } 
public OfficeAssignment OfficeAssignment { get; set; } 

} 

} 

Birden çok öznitelik tek bir satırda olabilir. HireDate öznitelikleri aşağıdaki gibi yazılabilir: 

[DataType(DataType.Date),Display(Name = "Hire Date"),DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", 
ApplyFormatlnEditMode = true)] 


Gezinti özellikleri 

CourseAssignments ve OfficeAssignment Özellikleri gezinti Özellikleridir. 

Bir eğitmen herhangi bir sayıda kurs öğretebilir, bu nedenle CourseAssignments bir koleksiyon olarak tanımlanır. 


public ICollection<CourseAssignment> CourseAssignments { get; set; } 

Bir eğitmenin en fazla bir ofisi olabilir, bu nedenle 
Office atanmamışsa OfficeAssignment null olur. 

OfficeAssignment 

özelliği tek bir 

OfficeAssignment 

varlık içerir. 

public OfficeAssignment OfficeAssignment { get 

; set; } 





OfficeAssignment varlığı 













OffkeAssıgn... 



using System.ComponentModel.DataAnnotations; 
using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 
{ 

public class OfficeAssignment 
{ 

[Key] 

public int InstnuctonlD { get; set; } 
[StningLength(50)] 

[Display(Name = "Office Location")] 
public stning Location { get; set; } 

public Instnuctor Instructor { get; set; } 

} 

} 


Anahtar özniteliği 

Özellik adı Classnameıd veya İD dışında bir şey olduğunda, bir özelliği birincil anahtar (PK) olarak tanımlamak için 
[Key] özniteliği kullanılır. 

instructon ve OfficeAssignment varlıkları arasında bire sıfır veya arasında bir ilişki vardır. Office ataması, atandığı 
eğitmenle ilişkili olarak yalnızca vardır. OfficeAssignment PK Ayrıca, ınstructor varlığa ait yabancı anahtarıdır (FK). 


İnstructoriD 

İD veya Classnameıd adlandırma kuralını izlemediği için, 

İnstructoriD 

OfficeAssignment 


PK olarak otomatik olarak tanıyamaz. Bu nedenle, Key özniteliği, instructoriD PK olarak tanımlamak için 
kullanılır: 

[Key] 

public int İnstructoriD { get; set; } 

Varsayılan olarak, EF Core, sütun tanımlayıcı bir ilişki için olduğundan, anahtarı veritabanı olmayan bir şekilde 
değerlendirir. 

Eğitmen gezintisi özelliği 

Instructor.OfficeAssignment gezinti özelliği null olabilir çünkü belirli bir eğitmen için bir OfficeAssignment satırı 
olmayabilir. Bir eğitmenin Office ataması olmayabilir. 

OfficeAssignment.Instructor gezinti özelliği her zaman bir eğitmen varlığına sahip olur çünkü yabancı anahtar 
instructoriD türü int , null olamayan bir değer türüdür. Bir Office ataması, bir eğitmen olmadan bulunamaz. 

Instructor bir varlık ilişkili bir OfficeAssignment varlığına sahip olduğunda, her varlığın gezinti özelliğinde diğer 
birine bir başvurusu vardır. 


Kurs varlığı 
























Coıırse 



using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Course 

{ 

[DatabaseGenerated(DatabaseGeneratedOption.None)] 

[Display(Name = "Number")] 
public int CourselD { get; set; } 

[Stringl_ength(50, MinimumLength = 3)] 
public string Title { get; set; } 

[Range(0j S)] 

public int Credits { get; set; } 

public int DepartmentlD { get; set; } 

public Department Department { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

public ICollection<CourseAssignment> CourseAssignments { get; set; } 

} 

} 

Course varlığın bir yabancı anahtar (FK) özelliği DepartmentlD vardır. DepartmentlD ilgili Department varlığına 
işaret eder, course varlığın bir Department gezinti özelliği vardır. 

EF Core, modelin ilgili bir varlık için gezinti özelliği olduğunda bir veri modeli için yabancı anahtar özelliği 
gerektirmez. EF Core, gerektiği yerde otomatik olarak veritabanında FKs 'ler oluşturur. EF Core otomatik olarak 
oluşturulan FKs 'ler için gölge Özellikler oluşturur. Ancak, doğrudan veri modelinde FK dahil edilmesi, 
güncelleştirmelerin daha basit ve daha verimli olmasını sağlayabilir. Örneğin, FK özelliğinin DepartmentlD dahil 
olmadıği bir model düşünün. Bir kurs varlığı düzenlemek üzere getirilirken: 

• Department özelliği açıkça yüklenmediyse null olur. 

• Kurs varlığını güncelleştirmek için öncelikle Department varlığın getirilmesi gerekir. 

FK özelliği DepartmentlD veri modeline dahil edildiğinde, güncelleştirmeden önce Department varlığını getirmeye 
gerek yoktur. 

DatabaseGenerated özniteliği 

[DatabaseGenerated(DatabaseGeneratedOption.None) ] özniteliği, PK 'nin veritabanı tarafından oluşturulması yerine 
uygulama tarafından sağlandığını belirtir. 


















[DatabaseGenerated(DatabaseGeneratedOption.None)] 
[Display(Name = "Number")] 
public int CourselD { get; set; } 


Varsayılan olarak, EF Core PK değerlerinin veritabanı tarafından oluşturulduğunu varsayar. Veritabanı tarafından 
oluşturulan genellikle en iyi yaklaşım vardır, course varlıklar için Kullanıcı PK 'yi belirtir. Örneğin, matematik 
departmanı için 1000 serisi, İngilizce departmanı için 2000 serisi gibi bir kurs numarası. 

DatabaseGenerated özniteliği varsayılan değerler oluşturmak için de kullanılabilir. Örneğin, veritabanı bir satırın 
oluşturulduğu veya güncelleştirildiği tarihi kaydetmek için otomatik olarak bir tarih alanı oluşturabilir. Daha fazla 
bilgi için bkz. üretilen Özellikler. 

Yabancı anahtar ve gezinti özellikleri 

course varlığındaki yabancı anahtar (FK) özellikleri ve gezinti özellikleri aşağıdaki ilişkileri yansıtır: 

Bir kurs bir departmana atanır, bu nedenle bir DepartmentiD FKve Department gezinti özelliği vardır. 

public int DepartmentiD { get; set; } 
public Department Department { get; set; } 

Bir kurs, kayıtlı sayıda öğrenciye sahip olabilir, bu nedenle Enroiiments gezinti özelliği bir koleksiyondur: 

public ICollection<Enrollment> Enrollments { get; set; } 

Bir kurs birden fazla eğitmen tarafından tada olabilir, bu nedenle courseAssignments gezinti özelliği bir 
koleksiyondur: 

public ICollection<CourseAssignment> CourseAssignments { get; set; } 

courseAssignment daha sonraaçıklanmaktadır. 

Departman varlığı 


Department 


Properties 
yf DepartmentiD 
A Name 
A Budget 
A StartDate 
A InstructorlD 
Navigation Properties 
y3 Administrator 
y3 Courses 


Aşağıdaki kodla modeller/departman, cs oluşturun: 

















using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Department 

{ 

public int DepartmentlD { get; set; } 

[StringLength(50j MinimumLength = 3)] 
public string Name { get; set; } 

[DataType(DataType.Currency)] 

[Column(TypeName = "money")] 
public decimal Budget { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd }", ApplyFormatlnEditMode = true)] 

[Display(Name = "Start Date")] 

public DateTime StartDate { get; set; } 

public int? InstructorlD { get; set; } 

public Instructor Administrator { get; set; } 
public ICollection<Course> Courses { get; set; } 

} 

} 


Column özniteliği 

Daha önce column özniteliği sütun adı eşlemesini değiştirmek için kullanılmıştır. Department varlığın kodunda, SQL 
veri türü eşlemesini değiştirmek için column özniteliği kullanılır. Budget sütunu, veritabanında SQL Server para 
türü kullanılarak tanımlanır: 

[Column(TypeName="money")] 
public decimal Budget { get; set; } 

Sütun eşlemesi genellikle gerekli değildir.EF Core, özelliğin CLR türüne göre uygun SQL Server veri türünü seçer. 
CLR decimal türü bir SQL Server decimal türüne eşlenir. Budget para birimi için ve para veri türü para birimi için 
daha uygundur. 

Yabancı anahtar ve gezinti özellikleri 

FK ve gezinti özellikleri aşağıdaki ilişkileri yansıtır: 

• Bir departman yönetici olabilir veya olmayabilir. 

• Yönetici her zaman bir eğitmendir.Bu nedenle InstructorlD özelliği, ınstructor varlığa FK olarak eklenir. 
Gezinti özelliği Administrator olarak adlandırılır ancak bir ınstructor varlığı tutar: 

public int? InstructorlD { get; set; } 
public Instructor Administrator { get; set; } 

Önceki koddaki soru işareti (?) özelliği null yapılabilir olduğunu belirtiyor. 

Bir departmanın birçok kursu olabilir, bu nedenle bir kurs gezintisi özelliği vardır: 















public ICollection<Course> Courses { get; set; } 


Kural gereği EF Core, null yapılamayan ve çok-çok ilişkiler için basamaklı silme imkanı sağlar. Bu varsayılan 
davranış, dairesel basamaklı silme kurallarına neden olabilir. Bir geçiş eklendiğinde dairesel basamaklı silme 
kuralları bir özel duruma neden olur. 

Örneğin, Department.instructoriD özelliği null yapılamayan olarak tanımlanmışsa EF Core bir basamaklı silme 
kuralı yapılandırır. Bu durumda, yönetici olarak atanan eğitmen silindiğinde departman silinir. Bu senaryoda 
kısıtlama kuralı daha anlamlı hale getirir. Aşağıdaki Fluent API bir kısıtlama kuralı ayarlar ve art arda silmeyi devre 
dışı bırakır. 

modelBuilder.Entity<Department>() 

.HasOne(d => d.Administrator) 

.WithMany() 

.OnDelete(DeleteBehavior.Restrict) 


Kayıt varlık 

Kayıt kaydı, tek bir öğrenci tarafından gerçekleştirilen bir kurs içindir. 


Enrollment 



using System.ComponentModel.DataAnnotations; 
using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 
{ 

public enum Gnade 
{ 

A, B, C, Dj F 

} 

public class Enrollment 
{ 

public int EnrollmentlD { get; set; } 
public int CourselD { get; set; } 
public int StudentlD { get; set; } 
[DisplayFormat(NullDisplayText = "No grade")] 
public Grade? Grade { get; set; } 

public Course Course { get; set; } 
public Student Student { get; set; } 

} 

} 


Yabancı anahtar ve gezinti özellikleri 

FK özellikleri ve gezinti özellikleri aşağıdaki ilişkileri yansıtır: 











Kayıt kaydı tek bir kursa yöneliktir, bu nedenle bir courseiD FK özelliği ve course gezinti özelliği vardır: 


public int CourseiD { get; set; } 
public Course Course { get; set; } 


Kayıt kaydı bir öğrenci içindir, bu nedenle bir studentiD FK özelliği ve student gezinti özelliği vardır: 

public int StudentiD { get; set; } 
public Student Student { get; set; } 


Çoktan çoğa İlişkiler 

student ve Course varlıkları arasında çok-çok ilişkisi vardır. Enroiiment varlık, veritabanında Yük ile çoktan çoğa 
bir JOIN tablosu olarak çalışır. "Yükle", Enroiiment tablosunun birleştirilmiş tablolar (Bu durumda, PK ve Grade ) 
gibi ek verileri içerdiği anlamına gelir. 


Aşağıdaki çizimde bu ilişkilerin bir varlık diyagramında nasıl göründüğünü gösterilmektedir.(Bu diyagram EF 6. x 
için EF güç araçları kullanılarak oluşturulmuştur. Diyagram oluşturmak öğreticinin bir parçası değildir.) 


Student 


Properties 
yî İD 

A lastName 
A* FirstMidName 
A* EnrolImentDate 
Navigation Properties 
& Enrollments 


’ 


Enrollmerıt ^ 


Course 

Properties 


Properties 

yî EnrolImentlD 

A* CourseiD 

A 1 StudentiD 

A Grade 

_-/V 

yî CourseiD 

A Title 

A Credits 

A DepartmentlD 

* 1 

Navigation Properties 


Navigation Properties 

y3 Course 
y3 Student 


y3 Department 
y3 Enrollments 
yü CourseAssignments 




Her ilişki ucu ve bir yıldız işareti (*) 1 diğer sırasında bir-çok ilişkisi belirten bulunur. 

Enroiiment tablo, sınıf bilgilerini içermiyorsa, yalnızca iki FKs ( CourseiD ve studentiD ) içermesi gerekir.Yük 
olmadan çoktan çoğa bir JOIN tablosu bazen saf JOIN tablosu (PJT) olarak adlandırılır. 

instructor ve Course varlıkların, saf bir JOIN tablosu kullanılarak çoktan çoğa bir ilişkisi vardır. 

Note: EF 6. x, çoktan çoğa ilişkiler için örtük birleştirmeyi destekler, ancak EF Core değildir.Daha fazla bilgi için EF 

Core 2,0 1 de çoktan çoğa ilişkilerbölümüne bakın. 


Courseatama varlığı 



































Co u rse Assig nmen t 



{ 

public class CourseAssignment 
{ 

public int InstructorlD { get; set; } 
public int CourselD { get; set; } 
public Instnuctor Instructor { get; set; } 
public Course Counse { get; set; } 

} 


Eğitmenden çok-çok ilişkisi için bir JOIN tablosu gerekir ve bu ekleme tablosu için varlık kurs atamasıdır. 


Instructor 


Properties 
yî İD 

A LastName 
A* FirstMidName 
A* HireDate 
Navigation Properties 
y3 CourseAssiqnments 
y3 OfficeAssignment 

; 1 

_ * _ 


CourseAssignment 


Properties 
A CourselD 
A" InstructorlD 
Navigation Properties 
Course 
y3 Instructor 


Course 


Properties 

< „ 

1 yi CourselD 

A Title 
A Credits 
A DepartmentlD 
Navigation Properties 
y51 Department 
y3 Enrollments 
yll CourseAssignments 


EntityNameiEntityName 2 bir JOIN varlığı adı yaygın olarak vardır.Örneğin, bu model kullanılarak eğitmen-kurslar 
JOIN tablosu Courseinstructor . Ancak, ilişkiyi açıklayan bir ad kullanmanızı öneririz. 

Veri modelleri basit ve büyümeye başlar. Yük (PJTs) olmayan ekleme tabloları genellikle yükü içerecek şekilde 
gelişmektedir. Açıklayıcı bir varlık adıyla başlayarak, ekleme tablosu değiştiğinde adın değiştirilmesi gerekmez, ideal 
olarak, JOIN varlığının iş etki alanında kendi doğal (muhtemelen tek bir kelime) adına sahip olması gerekir. 
Örneğin, kitaplar ve müşteriler, derecelendirmeler adlı bir JOIN varlığıyla bağlantı kurulabilir.Eğitmenin kursa çok- 
çok ilişkisi için Courseinstructor'' CourseAssignment tercih edilir. 

























Bileşik anahtar 


CourseAssignment 

( InstructorlD 

ve 

CourselD 

) içindeki iki FKs, 

CourseAssignment 

tablosunun her satırını benzersiz 

olarak tanımlar. 

CourseAssignment 

adanmış bir PK gerektirmez. 

InstructorlD 

ve 

CourselD 

özellikleri bileşik bir PK 


olarak çalışır. EF Core bileşik PKs 'leri belirtmenin tek yolu FluentAPI' dir. Sonraki bölümde, bileşik PK 'nin nasıl 
yapılandırılacağı gösterilmektedir. 

Bileşik anahtar şunları sağlar: 

• Tek bir kurs için birden çok satıra izin verilir. 

• Birden çok satıra bir eğitmen için izin verilir. 

• Aynı eğitmen ve kurs için birden çok satıra izin verilmez. 

Enroiiment JOIN varlığı kendi PK 'yi tanımlar, bu nedenle bu sıralamanın yinelemeleri mümkündür.Bu tür 
yinelemeleri engellemek için: 

• FK alanlara benzersiz bir dizin ekleyin veya 

• CourseAssignment benzer bir birincil bileşik anahtarla Enroiiment yapılandırın. Daha fazla bilgi için bkz. dizinler. 


Veritabanı bağlamını güncelleştirme 


Data/SchoolContext. cs öğesini şu kodla güncelleştirin: 


using ContosoUniversity.Models; 
using Microsoft.EntityFrameworkCore; 

namespace ContosoUniversity.Data 

{ 

public class SchoolContext : DbContext 

{ 

public SchoolContext(DbContextOptions<SchoolContext> options) : base(options) 

{ 

} 

public DbSet<Course> Courses { get; set; } 

public DbSet<Enrollment> Enrollments { get; set; } 

public DbSet<Student> Students { get; set; } 

public DbSet<Department> Departments { get; set; } 

public DbSet<Instructor> Instructors { get; set; } 

public DbSet<OfficeAssignment> OfficeAssignments { get; set; } 

public DbSet<CourseAssignment> CourseAssignments { get; set; } 

protected override void OnModelCreating(ModelBuilder modelBuilder) 

{ 

modelBuilder.Entity<Course>().ToTable("Course"); 
modelBuilder.Entity<Enrollment>().ToTable("Enrollment"); 
modelBuilder.Entity<Student>().ToTable("Student"); 
modelBuilder.Entity<Department>().ToTable("Department"); 
modelBuilder.Entity<Instructor>().ToTable("Instructor"); 
modelBuilder.Entity<OfficeAssignment>().ToTable("OfficeAssignment"); 
modelBuilder.Entity<CourseAssignment>().ToTable("CourseAssignment"); 


} 


} 


} 


modelBuilder.Entity<CourseAssignment>() 

.HasKey(c => new { c.CourselD., c.InstructorlD }); 


Yukarıdaki kod, yeni varlıkları ekler ve CourseAssignment varlığın bileşik PK öğesini yapılandırır. 


Tutarlı API 'nin özniteliklere alternatif 












Önceki koddaki onModeicreating yöntemi EF Core davranışını yapılandırmak için FluentAPI kullanır. Genellikle tek 
bir bildirimde bir dizi yöntem çağrısı olan dize olarak kullanıldığından, API "akıcı" olarak adlandırılır. Aşağıdaki kod 
FluentAPI bir örneğidir: 

protected override void OnModelCreating(ModelBuilder modelBuilder) 

{ 

modelBuilder.Entity<Blog>() 

.Property(b => b.Url) 

.IsRequired(); 

} 

Bu öğreticide, Fluent API yalnızca özniteliklerle yapılamadığını veritabanı eşlemesi için kullanılır.Ancak Fluent API, 
özniteliklerle yapılabilecek biçimlendirme, doğrulama ve eşleme kurallarının çoğunu belirtebilir. 

MinimumLength gibi bazı öznitelikler FluentAPI uygulanamaz. MinimumLength şemayı değiştirmez, yalnızca bir 
minimum uzunluk doğrulama kuralı uygular. 

Bazı geliştiriciler, varlık sınıflarının "temiz" olmasını sağlamak için Fluent API özel olarak kullanmayı tercih eder. 
Öznitelikler ve Fluent API karışık olabilir. Yalnızca Fluent API (bileşik bir PK belirterek) yapılabilecek bazı 
konfigürasyonlar vardır. Yalnızca özniteliklerle ( MinimumLength ) yapılabilecek bazı konfigürasyonlar vardır.Fluent 
API veya özniteliklerini kullanmak için önerilen uygulama: 

• Bu iki yaklaşımdan birini seçin. 

• Seçilen yaklaşımı mümkün olduğunca düzenli olarak kullanın. 

Bu öğreticide kullanılan özniteliklerin bazıları için kullanılır: 

• Yalnızca doğrulama (örneğin, MinimumLength ). 

• Yalnızca yapılandırma EF Core (örneğin, HasKey ). 

• Doğrulama ve EF Core yapılandırma (örneğin, [stringLength(5@)] ). 

Öznitelikler ile Fluent API hakkında daha fazla bilgi için bkz. yapılandırma yöntemleri. 

Varlık diyagramı 

Aşağıdaki çizimde, tamamlanmış okul modeli için EF Povver Tools 'un oluştura diyagramı gösterilmektedir. 
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Önceki diyagramda şunları gösterir: 
• Birkaç bire çok ilişki satırı (*1). 


• 

Instructor 

ve 

OfficeAssignment 

varlıkları arasında bire sıfır veya-bir ilişki çizgisi (1 ila 0.. 1) 

• 

Instructor 

ve 

Department 

varlıkları arasında sıfır veya-bire çok ilişki çizgisi (0.. 1 -*). 


Veritabanının çekirdeğini oluşturma 

Data/Dbınizer. csdosyasındaki kodu güncelleştirin: 


using System; 
using System.Linq; 

using Microsoft.EntityFrameworkCore; 

using Microsoft.Extensions.Dependencylnjection; 

using ContosoUniversity.Models; 

namespace ContosoUniversity.Data 

{ 

public static class Dblnitializer 

{ 

public static void Initialize(SchoolContext context) 

{ 

//context.Database.EnsureCreated(); 








































// Look for any students. 
if (context.Students.Any()) 

{ 

return; // DB has been seeded 

} 


var students = new Student[] 

{ 

new Student { FirstMidName = "Carson", LastName 
EnrollmentDate = DateTime.Parse("2016-09-01") 
new Student { FirstMidName = "Meredith", LastName 
EnrollmentDate = DateTime.Parse("2018-09-01") 
new Student { FirstMidName = "Arturo", LastName 
EnrollmentDate = DateTime.Parse("2019-09-01") 
new Student { FirstMidName = "Gytis", LastName 
EnrollmentDate = DateTime.Parse("2018-09-01") 
new Student { FirstMidName = "Yan", LastName 

EnrollmentDate = DateTime.Parse("2018-09-01") 
new Student { FirstMidName = "Peggy", LastName 
EnrollmentDate = DateTime.Parse("2017-09-01") 
new Student { FirstMidName = "Laura", LastName 
EnrollmentDate = DateTime.Parse("2019-09-01") 
new Student { FirstMidName = "Nino", LastName 
EnrollmentDate = DateTime.Parse("2011-09-01") 

}; 

foreach (Student s in students) 

{ 

context.Students.Add(s); 

} 

context.SaveChanges(); 


= "Alexander", 

L 

= "Alonso", 

h 

= "Anand", 

}, 

= "Barzdukas", 

h 

= "Lİ", 

}, 

= "Dustice", 

h 

= "Norman", 

L 

= "Olivetto", 

} 


var instructors = new Instructor[] 

{ 

new Instructor { FirstMidName = "Kim", LastName = "Abercrombie", 
HireDate = DateTime.Parse("1995-03-ll") }, 
new Instructor { FirstMidName = "Fadi", LastName = "Fakhouri", 
HireDate = DateTime.Parse("2002-07-06") }, 
new Instructor { FirstMidName = "Roger", LastName = "Harui", 
HireDate = DateTime.Parse("1998-07-01") }, 
new Instructor { FirstMidName = "Candace", LastName = "Kapoor", 
HireDate = DateTime.Parse("2001-01-15") }, 
new Instructor { FirstMidName = "Roger", LastName = "Zheng", 
HireDate = DateTime.Parse("2004-02-12") } 


}; 


foreach (Instructor i in instructors) 

{ 

context.instructors.Add(i); 

} 

context.SaveChanges(); 


var departments = new Department[] 

{ 

new Department { Name = "English", Budget = 350000, 
StartDate = DateTime.Parse("2007-09-01"), 
InstructorlD = instructors.Single( i => i.LastName 
new Department { Name = "Mathematics", Budget = 100000, 
StartDate = DateTime.Parse("2007-09-01"), 
InstructorlD = instructors.Single( i => i.LastName 
new Department { Name = "Engineering", Budget = 350000, 
StartDate = DateTime.Parse("2007-09-01"), 
InstructorlD = instructors.Single( i => i.LastName 
new Department { Name = "Economics", Budget = 100000, 
StartDate = DateTime.Parse("2007-09-01"), 
InstructorlD = instructors.Single( i => i.LastName 

}; 


"Abercrombie").ID }, 


"Fakhouri").ID }, 


"Harui").ID }, 


"Kapoor").ID } 


foreach (Department d in departments) 


{ 

context.Departments.Add(d); 

} 

context.SaveChanges(); 

var courses = new Course[] 

{ 

new Course {CourselD = 1050, Title = "Chemistry", Credits = 3, 

DepartmentlD = departments.Single( s => s.Name == "Englneering").DepartmentlD 

}, 

new Course {CourselD = 4022, Title = "Microeconomics", Credits = 3, 

DepartmentlD = departments.Single( s => s.Name == "Economics").DepartmentlD 

}, 

new Course {CourselD = 4041, Title = "Macroeconomics", Credits = 3, 

DepartmentlD = departments.Single( s => s.Name == "Economics").DepartmentlD 

}, 

new Course {CourselD = 1045, Title = "Calculus", Credits = 4, 

DepartmentlD = departments.Single( s => s.Name == "Mathematics").DepartmentlD 

}, 

new Course {CourselD = 3141, Title = "Trigonometry", Credits = 4, 

DepartmentlD = departments.Single( s => s.Name == "Mathematics").DepartmentlD 

}, 

new Course {CourselD = 2021, Title = "Composition", Credits = 3, 

DepartmentlD = departments.Single( s => s.Name == "English").DepartmentlD 

}, 

new Course {CourselD = 2042, Title = "Literatüre", Credits = 4, 

DepartmentlD = departments.Single( s => s.Name == "English").DepartmentlD 

}, 

}; 

foreach (Course c in courses) 

{ 

context.Courses.Add(c); 

} 

context.SaveChanges(); 

var officeAssignments = new OfficeAssignment[] 

{ 

new OfficeAssignment { 

InstructorlD = instructors.Single( i => i.LastName == "Fakhouri").ID, 

Location = "Smith 17" }, 
new OfficeAssignment { 

InstructorlD = instructors.Single( i => İ.LastName == "Harui").ID, 

Location = "Gowan 27" }, 
new OfficeAssignment { 

InstructorlD = instructors.Single( i => İ.LastName == "Kapoor").ID, 

Location = "Thompson 304" }, 

}; 

foreach (OfficeAssignment o in officeAssignments) 

{ 

context.OfficeAssignments.Add(o); 

} 

context.SaveChanges(); 


var courselnstructors = new CourseAssignment[] 

{ 


new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 
}, 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 
}, 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 


== "Chemistry" ).CourselD, 
i.LastName == "Kapoor").ID 


== "Chemistry" ).CourselD, 
i.LastName == "Harui”).ID 


== "Microeconomics" ).CourselD, 
i.LastName == "Zheng").ID 


1 




new CounseAssignment { 

CounselD = courses.Single(c => c.Title 
InstructorlD = instnuctons.Single(i => 

L 

new CounseAssignment { 

CounselD = counses.Single(c => c.Title 
InstnuctonlD = instnuctons.Single(i => 

L 

new CounseAssignment { 

CounselD = counses.Single(c => c.Title 
InstnuctonlD = instnuctons.Single(i => 

b 

new CounseAssignment { 

CounselD = counses.Single(c => c.Title 
InstnuctonlD = instnuctons.Single(i => 

b 

new CounseAssignment { 

CounselD = counses.Single(c => c.Title 
InstnuctonlD = instnuctons.Single(i => 

b 


== "Macnoeconomics" ).CounselD, 
i.LastName == "Zheng").ID 


== "Calculus" ).CounselD, 
i.LastName == "Fakhouni").ID 


== "Tnigonometny" ).CounselD., 
i.LastName == "Hanui").ID 


== "Composition" ).CounselD, 
i.LastName == "Abencnombie").ID 


== "Litenatune" ).CounselD, 
i.LastName == "Abencnombie").ID 


foneach (CounseAssignment ci in counselnstnuctons) 

{ 

context.CounseAssignments.Add(ci); 

} 

context.SaveChanges(); 


van ennollments = new Ennollment[] 

{ 

new Ennollment { 

StudentlD = students.Single(s => s.LastName == "Alexanden").ID, 
CounselD = counses.Single(c => c.Title == "Chemistny" ).CounselD, 

Gnade = Gnade.A 

b 

new Ennollment { 

StudentlD = students.Single(s => s.LastName == "Alexanden").ID, 
CounselD = counses.Single(c => c.Title == "Micnoeconomics" ).CounselD, 
Gnade = Gnade.C 

b 

new Ennollment { 

StudentlD = students.Single(s => s.LastName == "Alexanden").ID, 
CounselD = counses.Single(c => c.Title == "Macnoeconomics" ).CounselD, 
Gnade = Gnade.B 

b 

new Ennollment { 

StudentlD = students.Single(s => s.LastName == "Alonso").ID, 
CounselD = counses.Single(c => c.Title == "Calculus" ).CounselD, 

Gnade = Gnade.B 

b 

new Ennollment { 

StudentlD = students.Single(s => s.LastName == "Alonso").ID, 
CounselD = counses.Single(c => c.Title == "Tnigonometny" ).CounselD, 
Gnade = Gnade.B 

b 

new Ennollment { 

StudentlD = students.Single(s => s.LastName == "Alonso").ID, 

CounselD = counses.Single(c => c.Title == "Composition" ).CounselD, 
Gnade = Gnade.B 

b 

new Ennollment { 

StudentlD = students.Single(s => s.LastName == "Anand").ID, 

CounselD = counses.Single(c => c.Title == "Chemistny" ).CounselD 

b 

new Ennollment { 

StudentlD = students.Single(s => s.LastName == "Anand").ID, 

CounselD = counses.Single(c => c.Title == "Micnoeconomics").CounselD, 
Gnade = Gnade.B 


new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Barzdukas").ID, 
CourselD = courses.Single(c => c.Title == "Chemistry").CourselD, 
Grade = Grade.B 

b 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Li").ID, 

CourselD = courses.Single(c => c.Title == "Composition").CourselD, 
Grade = Grade.B 

b 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Tustice").ID, 
CourselD = courses.Single(c => c.Title == "Literatüre").CourselD, 
Grade = Grade.B 
} 

}; 


foreach (Enrollment e in enrollments) 

{ 

var enrollmentlnDataBase = context.Enrollments.Where( 
s => 

s.Student.ID == e.StudentlD && 

s.Course.CourselD == e.CourselD).SingleOrDefault(); 
if (enrollmentlnDataBase == null) 

{ 

context.Enrollments.Add (e); 

} 

} 

context.SaveChanges(); 

} 

} 

} 

Yukarıdaki kod, yeni varlıklar için tohum verileri sağlar. Bu kodun çoğu yeni varlık nesneleri oluşturur ve örnek 
verileri yükler. Örnek veriler test için kullanılır.Çoktan çoğa ekleme tablolarının nasıl çalıştırılabilir olduğunu 
gösteren örnekler için Enrollments ve CourseAssignments bakın. 

Geçiş Ekle 

Projeyi oluşturun. 

• Visual Studio 

• Visual Studio Code 

PMC 'de aşağıdaki komutu çalıştırın. 

Add-Migration ComplexDataModel 


Yukarıdaki komut, olası veri kaybı hakkında bir uyarı görüntüler. 

An operation was scaffolded that may result in the loss of data. 

Please review the migration for accuracy. 

To undo this action, use 'ef migrations remove' 

database update komutu çalıştınIdıysanız aşağıdaki hata oluşturulur: 

The ALTER TABLE statement conflicted with the FOREIGN KEY constraint 
"FK_dbo.Course_dbo.Department_DepartmentID". The conflict occurred in 
database "ContosoUniversity", table "dbo.Department", column 'DepartmentlD'. 





Sonraki bölümde, bu hatayla ilgili ne yapılacağını görürsünüz. 


Geçişi uygulayın veya bırakıp yeniden oluşturun 

Artık var olan bir veritabanınız olduğuna göre, değişikliklere nasıl uygulanacağını düşünmeniz gerekir. Bu öğreticide 
iki alternatif gösterilmektedir: 

• Veritabanını bırakıp yeniden oluşturun. SQLİte kullanıyorsanız bu bölümü seçin. 

• Geçişi mevcut veritabanına uygulayın. Bu bölümdeki yönergeler yalnızca SQL Server için geçerlidir, SQLite için 
değildir. 

Her iki seçenek de SQL Server için geçerlidir.Apply-Migration yöntemi daha karmaşıktır ve zaman alabilir. Bu, 
gerçek dünyada üretim ortamları için tercih edilen yaklaşımdır. 

Veritabanını bırakıp yeniden oluşturun 

SQL Server kullanıyorsanız ve aşağıdaki bölümde uygulanacak geçiş yaklaşımını yapmak istiyorsanız Bu bölümü 
atlayın . 

Yeni bir veritabanı oluşturmak için EF Core zorlamak için veritabanını bırakıp güncelleştirin: 

• Visual Studio 

• Visual Studio Code 

• Paket Yöneticisi konsolunda (PMC), aşağıdaki komutu çalıştırın: 

Drop-Database 

• Geçişler klasörünü silin, ardından aşağıdaki komutu çalıştırın: 

Add-Migration InitialCreate 
Update-Database 

Uygulamayı çalıştırın. Uygulamayı çalıştırmak Dbinitializer.initialize yöntemini çalıştırır. 

Dbinitializer.initialize yeni veritabanını doldurur. 

• Visual Studio 

• Visual Studio Code 

Veritabanını SSOX içinde açın: 

• Daha önce SSOX açıIdıysa Yenile düğmesine tıklayın. 

• Genişletin tabloları düğümü. Oluşturulan tablolar görüntülenir. 
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• Courseatama tablosunu inceleyin: 

o Courseatama tablosuna sağ tıklayın ve verileri görüntüle 1 yi seçin, 
o Courseatama tablosunun veri içerdiğini doğrulayın. 
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Geçişi Uygula 

Bu bölüm isteğe bağlıdır. Bu adımlar yalnızca SQL Server LocalDB için çalışır ve yalnızca önceki bırakma ve 
veritabanını yeniden oluştur bölümünü atladıktan sonra. 

Geçişler mevcut verilerle çalıştırıldığında, mevcut verilerin karşılanmadığı FK kısıtlamalar olabilir. Üretim verileriyle, 
mevcut verilerin geçirilmesi için adımların alınması gerekir. Bu bölüm, FK kısıtlama ihlallerinin düzeltilmesiyle bir 
örnek sağlar. Bu kod değişikliklerini yedekleme olmadan yapmayın. Önceki bırakmayı tamamlayıp veritabanını 
yeniden oluşturduktan sonra Bu kod değişikliklerini yapmayın. 

{Timestamp}_ComplexDataModel. cs dosyası aşağıdaki kodu içerir: 

migrationBuilder.AddColumn<int>( 
name: "DepantmentlD ", 
table: "Counse", 
type: "int", 
nullable: false, 
defaultValue: 0); 


Yukarıdaki kod counse tabloya null atanamaz DepartmentiD FK ekler.Önceki öğreticideki veritabanı counse 















satırları içerir, böylece tablo geçişler tarafından güncelleştirilemez. 
compiexDataModei geçişinin mevcut verilerle çalışmasını sağlamak için: 

• Yeni sütuna ( DepartmentiD ) varsayılan değer vermek için kodu değiştirin. 

• Varsayılan departman olarak davranacak "Temp" adlı sahte bir departman oluşturun. 

Yabancı anahtar kısıtlamalarını çözme 

compiexDataModei geçiş sınıfında up yöntemini güncelleştirin: 

• {Timestamp}_ComplexDataModel. cs dosyasını açın. 

• DepartmentiD sütununu course tablosuna ekleyen kod satırını açıklama satırı yapın. 

migrationBuilder.AlterColumn<string>( 
name: "Title", 
table: "Course", 
maxLength: 50, 
nullable: true, 
oldClrType: typeof(string), 
oldNullable: true); 

//migrationBuilder.AddColumn<int>( 

// name: "DepartmentiD", 

// table: "Course", 

// nullable: false, 

// defaultValue: 0); 

Aşağıdaki vurgulanmış kodu ekleyin. Yeni kod .createTabie( name: "Department" bloğundan sonra geçer: 

migrationBuilder.CreateTable( 
name: "Department", 
columns: table => new 
{ 

DepartmentiD = table.Column<int>(type: "int", nullable: false) 

.Annotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn), 
Budget = table.Column<decimal>(type: "money", nullable: false), 

InstructorlD = table.Column<int>(type: "int", nullable: true). 

Name = table.Column<string>(type: "nvarchar(50)", maxLength: 50, nullable: true), 

StartDate = table.Column<DateTime>(type: "datetime2", nullable: false) 

b 

constraints: table => 

{ 

table.PrimaryKey("PK_Department", x => x.DepartmentiD); 
table.ForeignKey( 

name: "FK_Department_Instructor_InstructorID", 
column: x => x.InstructorlD, 
principalTable: "Instructor", 
principalColumn: "ID", 
onDelete: ReferentialAction.Restrict); 

}); 

migrationBuilder.Sql("INSERT INTO dbo.Department (Name, Budget, StartDate) VALUES ('Temp', 0.00, GETDATE())"); 
// Default value for FK points to department created above, with 
// defaultValue changed to 1 in following AddColumn statement. 

migrationBuilder.AddColumn<int>( 
name: "DepartmentiD", 
table: "Course", 
nullable: false, 
defaultValue: 1); 


Önceki değişikliklerle, compiexDataModei.up yöntemi çalıştıktan sonra mevcut course satırları "Temp" departmanı 
ile ilişkilendirilir. 











Burada gösterilen durumu işlemenin yolu, bu öğretici için basitleştirilmiştir. Bir üretim uygulaması şöyle olacaktır: 

• Yeni Department satırlarına Department satırları ve ilgili Course satırlarını eklemek için kod veya komut 
dosyaları ekleyin. 

• "Geçici" Departmanı veya course.DepartmentiD için varsayılan değeri kullanmayın. 

• Visual Studio 

• Visual Studio Code 

• Paket Yöneticisi konsolunda (PMC), aşağıdaki komutu çalıştırın: 

Update-Database 

Dbinitializer. initialize yöntemi yalnızca boş bir veritabanıyla çalışacak şekilde tasarlandığından, öğrenci ve kurs 
tablolarındaki tüm satırları silmek için SSOX kullanın. (Cascade silme, kayıt tablosundan işlem gerçekleştirir.) 

Uygulamayı çalıştırın. Uygulamayı çalıştırmak Dbinitializer.initialize yöntemini çalıştırır. 

Dbinitializer.initialize yeni veritabanını doldurur. 

Sonraki adımlar 

Sonraki iki öğretici ilgili verilerin nasıl okunacağını ve güncelleştirilmesini gösterir. 


ÖNCEKİ ■ SONRAKİ 

ÖĞRETİCİ ■ ÖĞRETİCİ 


Önceki öğreticiler, üç varlıktan oluşan temel bir veri modeliyle çalışmıştır.Bu öğreticide: 

• Daha fazla varlık ve ilişki eklenmiştir. 

• Veri modeli biçimlendirme, doğrulama ve veritabanı eşleme kuralları belirtilerek özelleştirilir. 
Tamamlanan veri modeli için varlık sınıfları aşağıdaki çizimde gösterilmiştir: 
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Çözemediğiniz sorunlarla karşılaşırsanız, Tamamlanmış uygulamayıindirin. 

Veri modelini özniteliklerle özelleştirme 

Bu bölümde, veri modeli öznitelikler kullanılarak özelleştirilir. 

DataType özniteliği 

Öğrenci sayfaları Şu anda kayıt tarihinin saatini görüntüler.Genellikle, tarih alanları saati değil yalnızca tarihi 
gösterir. 

Modelleri/öğrenci, cs 'yi aşağıdaki vurgulanmış kodla güncelleştirin: 







































using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

namespace ContosoUniversity.Models 
{ 

public class Student 
{ 

public int ID { get; set; } 

public stning LastName { get; set; } 

public stning FirstMidName { get; set; } 

[DataType(DataType.Date) ] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}"j ApplyFormatlnEditMode = true)] 
public DateTime EnrollmentDate { get; set; } 

public ICollection<Ennollment> Ennollments { get; set; } 

} 

} 

DataType özniteliği, veritabanı iç türünden daha belirgin bir veri türünü belirtir. Bu durumda, tarih ve saat değil 
yalnızca tarih görüntülenmelidir. Veri türü numaralandırması , tarih, saat, PhoneNumber, para birimi, emaadresi vb. 
gibi birçok veri türü sağlar. DataType özniteliği Ayrıca uygulamanın türe özgü özellikleri otomatik olarak 
sağlamasını da sağlayabilir. Örneğin: 


• mailto: bağlantısı DataType. EmailAddness için otomatik olarak oluşturulur. 

• Tarih Seçici çoğu tarayıcıda DataType.Date için sağlanır. 


DataType 

özniteliği HTML 5 tarayıcıların kullandığı HTML 5 

data- 

(bir veri Dash) özniteliklerini yayar. 

DataType 


öznitelikleri doğrulama sağlamaz. 

DataType.Date görüntülenen tarihin biçimini belirtmiyor. Varsayılan olarak, Tarih alanı sunucunun 
Culturelnfoöğesine göre varsayılan biçimlere göre görüntülenir. 

DisplayFormat özniteliği, açıkça tarih biçimini belirtmek için kullanılır: 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 

ApplyFormatlnEditMode ayarı, biçimlendirmenin düzenleme kullanıcı arabirimine de uygulanacağını belirtir. Bazı 
alanlar ApplyFormatlnEditMode kullanmamalıdır. Örneğin, para birimi simgesi genellikle bir düzenleme metin 
kutusunda gösterilmemelidir. 

DisplayFormat özniteliği kendisi tarafından kullanılabilir. DataType özniteliğini DisplayFormat özniteliğiyle 
kullanmak genellikle iyi bir fikirdir. DataType özniteliği, verilerin semantiğini bir ekranda nasıl işleneceğini tersine 
alır. DataType özniteliği, DisplayFormat kullanılamayan aşağıdaki avantajları sağlar: 

• Tarayıcı HTML5 özelliklerini etkinleştirebilir.Örneğin, bir Takvim denetimini, yerel ayara uygun para birimi 
sembolünü, e-posta bağlantılarını, istemci tarafı giriş doğrulamasını vb. göster 

• Varsayılan olarak tarayıcı, verileri yerel ayara göre doğru biçimi kullanarak işler. 

Daha fazla bilgi için bkz. giriş > etiketi Yardımcısı belgeleri < . 

Uygulamayı çalıştırın. Öğrenciler dizin sayfasına gidin. Süreler artık görüntülenmiyor, student modelini kullanan 
her görünüm, tarihi zaman içinde görüntüler. 
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StringLength özniteliği 

Veri doğrulama kuralları ve doğrulama hatası iletileri özniteliklerle belirtilebilir. StringLength özniteliği, bir veri 
alanında izin verilen en düşük ve en fazla karakter uzunluğunu belirtir. StringLength özniteliği de istemci tarafı ve 
sunucu tarafı doğrulaması sağlar. En küçük değerin veritabanı şeması üzerinde hiçbir etkisi yoktur. 

student modelini aşağıdaki kodla güncelleştirin: 

using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

namespace ContosoUniversity.Models 

{ 

public class Student 

{ 

public int ID { get; set; } 

[StringLength(50)] 

public string LastName { get; set; } 

[StringLength(50j ErrorMessage = "First name cannot be longer than 50 characters.")] 
public string FirstMidName { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}"j ApplyFormatlnEditMode = true)] 
public DateTime EnrollmentDate { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 

Yukarıdaki kod, adları 50 karakterden fazla olmayacak şekilde sınırlandırır. StringLength özniteliği, kullanıcının bir 
ad için boşluk girmesini engellemez. Cevap içerisinde RegularExpression özniteliği, girişe kısıtlamalar uygulamak 
için kullanılır. Örneğin, aşağıdaki kod ilk karakterin büyük küçük harf olmasını ve geri kalan karakterlerin alfabetik 
olmasını gerektirir: 

[RegularExpression(@" A [A-Z]+[a-zA-Z.\s-]*$") ] 














Uygulamayı çalıştırın: 


• Öğrenciler sayfasına gidin. 

• Yeni oluştur' u seçin ve 50 karakterden daha uzun bir ad girin. 

• Oluştur' u seçin, istemci tarafı doğrulama bir hata iletisi gösterir. 

E3 Create - Contoso Unive X + — □ X 
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Contoso University 


Create 

Student 

LastName 

Davolio very long last name longer than ı 
The field LastName must be a string with a maximum length of 50. 

FirstMIdName 

Nancy very long first name longer than 5 
First name cannot be longer than 50 characters. 

EnrolImentDate 

2/15/2017 

Create 



SQL Server Nesne Gezgini (ssox) içinde öğrenci tablosuna çift tıklayarak öğrenci tablosu tasarımcısını açın. 



Önceki görüntüde student tablo şeması gösterilmektedir. VERITABANı üzerinde geçişler çalıştırılmadığından, ad 
alanlarının türü nvanchar(MAX) vardır. Bu öğreticide daha sonra geçişler çalıştırıldığında, ad alanları nvarchan(50) 
olur. 


Column özniteliği 

























Öznitelikler sınıfların ve özelliklerin veritabanına nasıl eşlenildiğini denetleyebilir. Bu bölümde, column özniteliği, 
FirstMidName özelliğinin adını VERITABANıNDA "FirstName" olarak eşlemek için kullanılır. 

DB oluşturulduğunda, model üzerindeki özellik adları sütun adları için kullanılır ( column özniteliği kullanıldığı 
durumlar dışında). 

student modeli ilk ad alanı için FirstMidName kullanır, çünkü alan de bir orta ad içerebilir. 

Student.es dosyasını aşağıdaki vurgulanmış kodla güncelleştirin: 

using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public elass Student 

{ 

public int ID { get; set; } 

[StringLength(50)] 

public string LastName { get; set; } 

[Stringl_ength(50, ErrorMessage = "First name cannot be longer than 50 characters.")] 

[Column("FirstName")] 

public string FirstMidName { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 
public DateTime EnrollmentDate { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 

Yukarıdaki değişiklik ile uygulamadaki student.FirstMidName , student tablosunun FirstName sütunuyla eşlenir. 

column özniteliğinin eklenmesi modeli schooicontext yedekleyen şekilde değiştirir. schooicontext yedekleyen 
model artık veritabanıyla eşleşmez. Geçiş uygulamadan önce uygulama çalışıyorsa aşağıdaki özel durum 
oluşturulur: 

SqlException: Invalid column name 'FirstName'. 


DB 'yi güncelleştirmek için: 

• Projeyi oluşturun. 

• Proje klasöründe bir komut penceresi açın. Yeni bir geçiş oluşturmak ve DB 'yi güncelleştirmek için aşağıdaki 
komutları girin: 

• Visual Studio 

• Visual Studio Code 


Add-Migration ColumnFirstName 
Update-Database 


migrations add ColumnFirstName komutu aşağıdaki uyarı iletisini üretir: 


An operation was scaffolded that may result in the loss of data. 
Please review the migration for accuracy. 














Ad alanları artık 50 karakterle sınırlı olduğundan uyarı oluşturulur. VERITABANıNDAKI bir ad 50 karakterden 
fazlasına sahipse, son karakter 51 ' i kaybedersiniz. 

• Uygulamayı test edin. 

Öğrenci tablosunu SSOX içinde açın: 


ContosoUniversity 

□ 


□ X 

■W 

♦ 

Update Script File: 

dbo.Students.sql 

—— 


Name 

Data Type 

Allow Nulls 

a Keys (1) 


ırO id 

EnrolImentDate 

int 

datetime2(7) 

□ 

□ 

PK_Students (Primary Key, CIl 

Check Constraints (0) 
lndexes (0) 

Foreign Keys (0) 


FirstName 

nvarchar(50) 

0 


LastName 

nvarchar(50) 

0 

Triggers (0) 


Q Design fi g t .sq L __ IH B ® 

1 CREATE TABLE [dbo].[Students] ( [4 

2 [ID] INT IDENTITY (1, 1) NOT NULL, ▲ 

[EnrolImentDate] DATETIME2 (7) NOT NULL, 

4 [FirstName] NVARCHAR (50) NULL, 

5 [LastName] NVARCHAR (50) NULL, — 

CONSTRAINT [PK_Students] PRIMARY KEY CLUSTERED ([ID] ASC) 

7 ); 

8 

100 % • i ► 


Geçiş uygulanmadan önce ad sütunları nvarchar (max)türünde idi. Ad sütunları artık nvarchar(50) . Sütun adı, 
FirstMidName FirstName olarak değiştirildi. 


NOTE 

Aşağıdaki bölümde, uygulamanın bazı aşamalardan oluşturulması derleyici hataları oluşturur. Yönergeler uygulamanın ne 
zaman derbir olduğunu belirtir. 


Öğrenci varlık güncelleştirmesi 


Student 


Properties 
<ft İD 

y LastName 
y FirstMidName 
y EnrolImentDate 
Navigation Properties 
V^l Enrollments 


Modelleri/öğrenci, cs 'yi aşağıdaki kodla güncelleştirin: 
















using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Student 

{ 

public int ID { get; set; } 

[Required] 

[StningLength(50)] 

[Display(Name = "Last Name")] 
public string LastName { get; set; } 

[Required] 

[StningLength(50j ErrorMessage = "First name cannot be longer than 50 characters.")] 
[Column("FirstName")] 

[Display(Name = "First Name")] 

public string FirstMidName { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd }", ApplyFormatlnEditMode = true)] 

[Display(Name = "Enrollment Date")] 

public DateTime EnrollmentDate { get; set; } 

[Display(Name = "Full Name")] 
public string FullName 
{ 

get 

{ 

return LastName + ", " + FirstMidName; 

} 

} 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 


Gerekli öznitelik 

Required özniteliği, ad özellikleri gereken alanları sağlar. Değer türleri ( DateTime , int , double , vb.) gibi null 
yapılamayan türler için Required özniteliği gerekli değildir. Null olmayan türler otomatik olarak gerekli alanlar 
olarak değerlendirilir. 


Required özniteliği stringLength özniteliğinde minimum length parametresiyle değiştirilebilir: 


[Display(Name = "Last Name")] 
[StringLength(50j MinimumLength=l)] 
public string LastName { get; set; } 


Display özniteliği 

Display özniteliği, metin kutularının açıklamalı altyazısının "ad", "soyadı", "tam ad" ve "kayıttarihi" olması 
gerektiğini belirtir. Varsayılan açıklamalı altyazıların sözcükleri bölen bir boşluk yoktu, örneğin "LastName". 

FullName hesaplanmış özelliği 

FullName , diğer iki özelliği birleştirerek oluşturulmuş bir değer döndüren hesaplanmış bir özelliktir. FullName 
ayarlanamaz, yalnızca bir get erişimcisi vardır. Veritabanında FullName sütunu oluşturulmaz. 


Eğitmen varlığı oluşturma 











Instructor 


Properties 
v î İD 

f* LastName 
f* FirstMidName 
f* HireDate 
Navigation Properties 
y3 CourseAssignments 
P OfficeAssignmerıt 


Aşağıdaki kodla modeller/eğitmen, cs oluşturun: 

using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Instructor 

{ 

public int ID { get; set; } 

[Required] 

[Display(Name = "Last Name")] 

[StringLength(50)] 

public string LastName { get; set; } 

[Required] 

[Column("FirstName")] 

[Display(Name = "First Name")] 

[StringLength(50)] 

public string FirstMidName { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 

[Display(Name = "Hire Date")] 

public DateTime HireDate { get; set; } 

[Display(Name = "Full Name")] 
public string FullName 
{ 

get { return LastName + ", " + FirstMidName; } 

} 

public ICollection<CourseAssignment> CourseAssignments { get; set; } 
public OfficeAssignment OfficeAssignment { get; set; } 

} 

} 

Birden çok öznitelik tek bir satırda olabilir. HireDate öznitelikleri aşağıdaki gibi yazılabilir: 


[DataType(DataType.Date),Display(Name = "Hire Date"),DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", 
ApplyFormatlnEditMode = true)] 


Courseatamalar ve OfficeAssignment gezinti özellikleri 

CourseAssignments ve OfficeAssignment Özellikleri gezinti Özellikleridir. 


Bir eğitmen herhangi bir sayıda kurs öğretebilir, bu nedenle CourseAssignments bir koleksiyon olarak tanımlanır. 













public ICollection<CourseAssignment> CourseAssignments { get; set; } 

Bir gezinti özelliği birden çok varlık tutuyorsa: 

• Girişlerin eklenebileceği, silinebileceği ve güncelleştirilebileceği bir liste türü olmalıdır. 

Gezinti özelliği türleri şunları içerir: 

• ICollection<T> 

• List<T > 

• HashSet<T> 

ıcoiiection<T> belirtilirse EF Core varsayılan olarak bir HashSet<T> koleksiyonu oluşturur. 
courseAssignment varlığı, çoktan çoğa ilişkilerin bölümünde açıklanmaktadır. 

Contoso Üniversitesi iş kuralları, bir eğitmenin en fazla bir ofisiniz olabilir. officeAssignment özelliği tek bir 
OfficeAssignment varlığı barındırır. Office atanmamışsa OfficeAssignment null olur. 

public OfficeAssignment OfficeAssignment { get; set; } 


OfficeAssignment varlığını oluşturma 


OfflceAssıgn... 



using System.ComponentModel.DataAnnotations; 
using System.ComponentModel .DataAnnotations .Schema; 

namespace ContosoUniversity.Models 
{ 

public class OfficeAssignment 
{ 

[Key] 

public int InstructorlD { get; set; } 
[StningLength(50)] 

[Display(Name = "Office Location")] 
public stning Location { get; set; } 

public Instnuctor Instructor { get; set; } 

} 

} 


Anahtar özniteliği 

Özellik adı Classnameıd veya İD dışında bir şey olduğunda, bir özelliği birincil anahtar (PK) olarak tanımlamak için 
[Key] özniteliği kullanılır. 

instructon ve officeAssignment varlıkları arasında bire sıfır veya arasında bir ilişki vardır. Office ataması, atandığı 
eğitmenle ilişkili olarak yalnızca vardır. OfficeAssignment PK Ayrıca, ınstructor varlığa ait yabancı anahtarıdır (FK) 

















EF Core, şu nedenle instructoriD otomatik olarak officeAssignment PK olarak tanıyamaz: 

• instructoriD , İD veya Classnameıd adlandırma kuralını takip etmez. 

Bu nedenle, Key özniteliği, instructoriD PK olarak tanımlamak için kullanılır: 

[Key] 

public int İnstructoriD { get; set; } 

Varsayılan olarak, EF Core, sütun tanımlayıcı bir ilişki için olduğundan, anahtarı veritabanı olmayan bir şekilde 
değerlendirir. 

Eğitmen gezintisi özelliği 

instructor varlık için OfficeAssignment gezinti özelliği null yapılabilir, çünkü: 

• Başvuru türleri (örneğin, sınıflar Nullable). 

• Bir eğitmenin Office ataması olmayabilir. 


OfficeAssignment 

varlık null atanamaz 

instructor 

bir gezinti özelliğine sahiptir çünkü 

• 

İnstructoriD 

null değer atanamaz. 




• Bir Office ataması, bir eğitmen olmadan bulunamaz. 

instructor bir varlık ilişkili bir OfficeAssignment varlığına sahip olduğunda, her varlığın gezinti özelliğinde diğer 
birine bir başvurusu vardır. 

[Required] özniteliği instructor gezinti özelliğine uygulanabilir: 

[Required] 

public instructor instructor { get; set; } 

Yukarıdaki kod, ilgili bir eğitmen olması gerektiğini belirtir. instructoriD yabancı anahtar (aynı zamanda PK) null 
değer atanamaz olduğundan, yukarıdaki kod gereksizdir. 

değiştirme 


Kurs varlığını 


Coıırse 


Properties 
y? CourselD 
f» Title 
A* Credits 
A DepartmentlD 
Navîgation Properties 
Department 
Y^ Enrollments 
Y§] CourseAssignments 


Modellerl/kursu. cs aşağıdaki kodla güncelleştirin: 






















using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Course 

{ 

[DatabaseGenerated(DatabaseGeneratedOption.None)] 

[Display(Name = "Number")] 
public int CourselD { get; set; } 

[Stringl_ength(50, MinimumLength = 3)] 
public stning Title { get; set; } 

[Range(0j 5)] 

public int Credits { get; set; } 

public int DepantmentlD { get; set; } 

public Department Department { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

public ICollection<CourseAssignment> CourseAssignments { get; set; } 

} 

} 

Course varlığın bir yabancı anahtar (FK) özelliği DepartmentiD vardır. DepartmentiD ilgili Department varlığına 
işaret eder, course varlığın bir Department gezinti özelliği vardır. 

EF Core, modelin ilgili bir varlık için gezinti özelliği olduğunda bir veri modeli için FK özelliği gerektirmez. 

EF Core, gerektiği yerde otomatik olarak veritabanında FKs 'ler oluşturur. EF Core otomatik olarak oluşturulan FKs 
'ler için gölge Özellikler oluşturur. FK 'in veri modelinde olması, güncelleştirmeleri daha basit ve daha verimli hale 
getirir. Örneğin, FK özelliğinin DepartmentiD dahil olmadığı bir model düşünün. Bir kurs varlığı düzenlemek üzere 
getirilirken: 

• Department varlığı açık bir şekilde yüklenmediyse null olur. 

• Kurs varlığını güncelleştirmek için öncelikle Department varlığın getirilmesi gerekir. 

FK özelliği DepartmentiD veri modeline dahil edildiğinde, güncelleştirmeden önce Department varlığını getirmeye 
gerek yoktur. 

DatabaseGenerated özniteliği 

[DatabaseGenerated(DatabaseGeneratedOption.None)] özniteliği, PK 'nin veritabanı tarafından oluşturulması yerine 
uygulama tarafından sağlandığını belirtir. 

[DatabaseGenerated(DatabaseGeneratedOption.None)] 

[Display(Name = "Number")] 
public int CourselD { get; set; } 


Varsayılan olarak, EF Core PK değerlerinin DB tarafından oluşturulduğunu varsayar. VERITABANı tarafından 
oluşturulan PK değerleri genellikle en iyi yaklaşımdır, course varlıklar için Kullanıcı PK 'yi belirtir. Örneğin, 
matematik departmanı için 1000 serisi, İngilizce departmanı için 2000 serisi gibi bir kurs numarası. 

DatabaseGenerated özniteliği varsayılan değerler oluşturmak için de kullanılabilir. Örneğin, VERITABANı bir satırın 
oluşturulduğu veya güncelleştirildiği tarihi kaydetmek için otomatik olarak bir tarih alanı oluşturabilir. Daha fazla 
bilgi için bkz. üretilen Özellikler. 


Yabancı anahtar ve gezinti özellikleri 
















Course varlığındaki yabancı anahtar (FK) özellikleri ve gezinti özellikleri aşağıdaki ilişkileri yansıtır: 

Bir kurs bir departmana atanır, bu nedenle bir DepartmentiD FKve Department gezinti özelliği vardır. 

public int DepartmentiD { get; set; } 
public Department Department { get; set; } 

Bir kurs, kayıtlı sayıda öğrenciye sahip olabilir, bu nedenle Enroiiments gezinti özelliği bir koleksiyondur 

public ICollection<Enrollment> Enrollments { get; set; } 

Bir kurs birden fazla eğitmen tarafından tada olabilir, bu nedenle courseAssignments gezinti özelliği bir 
koleksiyondur: 

public ICollection<CourseAssignment> CourseAssignments { get; set; } 

courseAssignment daha sonraaçıklanmaktadır. 

Departman varlığı oluşturma 


Department 


Properties 
y? DepartmentiD 
A* Name 
f* Budget 
A" StartDate 
A* InstructorlD 
Navigation Properties 
y3 Administrator 
y3 Courses 


Aşağıdaki kodla modeller/departman, cs oluşturun: 














using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Department 

{ 

public int DepartmentlD { get; set; } 

[StringLength(50j MinimumLength = 3)] 
public string Name { get; set; } 

[DataType(DataType.Currency)] 

[Column(TypeName = "money")] 
public decimal Budget { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd }", ApplyFormatlnEditMode = true)] 

[Display(Name = "Start Date")] 

public DateTime StartDate { get; set; } 

public int? InstructorlD { get; set; } 

public Instructor Administrator { get; set; } 
public ICollection<Course> Courses { get; set; } 

} 

} 


Column özniteliği 

Daha önce column özniteliği sütun adı eşlemesini değiştirmek için kullanılmıştır. Department varlığın kodunda, SQL 
veri türü eşlemesini değiştirmek için column özniteliği kullanılır. Budget sütunu, VERITABANıNDA SQL Server 
para türü kullanılarak tanımlanır: 

[Column(TypeName="money")] 
public decimal Budget { get; set; } 

Sütun eşlemesi genellikle gerekli değildir.EF Core genellikle özelliğin CLR türüne göre uygun SQL Server veri 
türünü seçer. CLR decimal türü bir SQL Server decimal türüne eşlenir. Budget para birimi için ve para veri türü 
para birimi için daha uygundur. 

Yabancı anahtar ve gezinti özellikleri 

FK ve gezinti özellikleri aşağıdaki ilişkileri yansıtır: 

• Bir departman yönetici olabilir veya olmayabilir. 

• Yönetici her zaman bir eğitmendir.Bu nedenle InstructorlD özelliği, ınstructor varlığa FK olarak eklenir. 
Gezinti özelliği Administrator olarak adlandırılır ancak bir ınstructor varlığı tutar: 

public int? InstructorlD { get; set; } 
public Instructor Administrator { get; set; } 

Önceki koddaki soru işareti (?) özelliği null yapılabilir olduğunu belirtiyor. 

Bir departmanın birçok kursu olabilir, bu nedenle bir kurs gezintisi özelliği vardır: 















public ICollection<Course> Courses { get; set; } 


Note: kurala göre EF Core, null yapılamayan ve çoktan çoğa ilişkiler için art arda silme imkanı sağlar. Basamaklı 
silme, dairesel basamaklı silme kurallarına neden olabilir. Döngüsel basamaklı silme kuralları, bir geçiş eklendiğinde 
özel duruma neden olur. 

Örneğin, Department.instructoriD özelliği null yapılamayan olarak tanımlanmışsa: 

• EF Core, eğitmen silindiğinde departmanı silmek için bir basamakla silme kuralı yapılandırır. 

• Eğitmen silindiğinde departmanı silmek amaçlanan davranış değildir. 

• Aşağıdaki Fluent API Cascade yerine bir kısıtlama kuralı ayarlar. 

modelBuilder.Entity<Department>() 

.HasOne(d => d.Administrator) 

.WithMany() 

.OnDelete(DeleteBehavior.Restrict) 


Yukarıdaki kod, departman-eğitmen ilişkisindeki basamaklı silmeyi devre dışı bırakır. 

Kayıt varlığını güncelleştirme 

Kayıt kaydı, tek bir öğrenci tarafından gerçekleştirilen bir kurs içindir. 


Enrollment 


Properties 
y? EnrolImentlD 
f* CourselD 
A StudentlD 
f* Grade 

Navigation Properties 
Course 
Student 


Modelleri/kaydi. cs 'yi aşağıdaki kodla güncelleştirin: 











using System.ComponentModel.DataAnnotations; 
using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 
{ 

public enum Grade 
{ 

A, B, C, Dj F 

} 

public class Enrollment 
{ 

public int EnrollmentlD { get; set; } 
public int CourselD { get; set; } 
public int StudentlD { get; set; } 
[DisplayFormat(NullDisplayText = "No grade")] 
public Grade? Grade { get; set; } 

public Course Course { get; set; } 
public Student Student { get; set; } 

} 

} 


Yabancı anahtar ve gezinti özellikleri 

FK özellikleri ve gezinti özellikleri aşağıdaki ilişkileri yansıtır: 

Kayıt kaydı tek bir kursa yöneliktir, bu nedenle bir CourselD FK özelliği ve course gezinti özelliği vardır: 

public int CourselD { get; set; } 
public Course Course { get; set; } 

Kayıt kaydı bir öğrenci içindir, bu nedenle bir StudentlD FK özelliği ve student gezinti özelliği vardır: 

public int StudentlD { get; set; } 
public Student Student { get; set; } 


Çoktan çoğa İlişkiler 

student ve Course varlıkları arasında çok-çok ilişkisi vardır. Enroiiment varlık, veritabanında Yük ile çoktan çoğa 
bir JOIN tablosu olarak çalışır. "Yükle", Enroiiment tablosunun birleştirilmiş tablolar (Bu durumda, PK ve Grade ) 
gibi ek verileri içerdiği anlamına gelir. 

Aşağıdaki çizimde bu ilişkilerin bir varlık diyagramında nasıl göründüğünü gösterilmektedir.(Bu diyagram EF 6. x 
için EF güç araçları kullanılarak oluşturulmuştur. Diyagram oluşturmak öğreticinin bir parçası değildir.) 














Student 


Properties 
yî İD 

A LastName 
A FirstMidName 
A EnrolImentDate 
Navigation Properties 
y'H Enrollments 

- 1 - 


* 


Enrollment ^ 


Course 

Properties 


Properties 

yî EnrolImentlD 

A CourseiD 

A StudentiD 

A Grade 

fS A 

yî CourseiD 

A Title 

A Credits 

A DepartmentlD 

* 1 

Navigation Properties 


Navigation Properties 

y3 Course 
y3 Student 


y3 Department 
y3 Enrollments 
yîl CourseAssignments 




Her ilişki ucu ve bir yıldız işareti (*) 1 diğer sırasında bir-çok ilişkisi belirten bulunur. 

Enroiiment tablo, sınıf bilgilerini içermiyorsa, yalnızca iki FKs ( CourseiD ve studentiD ) içermesi gerekir.Yük 
olmadan çoktan çoğa bir JOIN tablosu bazen saf JOIN tablosu (PJT) olarak adlandırılır. 

instructor ve course varlıkların, saf bir JOIN tablosu kullanılarak çoktan çoğa bir ilişkisi vardır. 

Note: EF 6. x, çoktan çoğa ilişkiler için örtük birleştirmeyi destekler, ancak EF Core değildir.Daha fazla bilgi için EF 

Core 2,0 1 de çoktan çoğa ilişkilerbölümüne bakın. 

Courseatama varlığı 


Co u rse Assig nmen t 


Properties 
A CourseiD 
A InstructorlD 
Navigation Properties 
y3 Course 
y3 İnstructor 


Aşağıdaki kodla modeller/Courseatama. cs oluşturun: 


























using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class CourseAssignment 

{ 

public int InstructorlD { get; set; } 
public int CourselD { get; set; } 
public Instnuctor Instructor { get; set; } 
public Course Counse { get; set; } 

} 

} 


Eğitmenden kurslar 


Instructor 


Properties 
yî İD 

b LastName 
b FirstMidName 
b HireDate 
Navigation Properties 
y3 CourseAssiqnments 
y3 OfficeAssignment 

i 


CourseAssignment 


Properties 
b CourselD 
b InstructorlD 
Navigation Properties 
y3 Course 
y3 Instructor 



Course 

> _ 

Properties 

/ V 

* 1 

yî CourselD 
b Title 
b Credits 
b DepartmentlD 


Navigation Properties 
y3 Department 
y3 Enrollments 
yll CourseAssignments 


Eğitmenin kurslardan çok-çok ilişkisi: 

• Bir varlık kümesiyle temsil etmelidir bir JOIN tablosu gerektirir. 

• , Saf bir JOIN tablosu (yük içermeyen tablo). 

EntityNameiEntityName 2 bir JOIN varlığı adı yaygın olarak vardır.Örneğin, bu model kullanılarak eğitmen-kurslar 
JOIN tablosu Courseinstructor . Ancak, ilişkiyi açıklayan bir ad kullanmanızı öneririz. 

Veri modelleri basit ve büyümeye başlar. Yük yükü dahil olmak üzere genellikle yük-yük birleştirmeleri (PJTs) 
gelişmektedir. Açıklayıcı bir varlık adıyla başlayarak, ekleme tablosu değiştiğinde adın değiştirilmesi gerekmez, ideal 
olarak, JOIN varlığının iş etki alanında kendi doğal (muhtemelen tek bir kelime) adına sahip olması gerekir. 
Örneğin, kitaplar ve müşteriler, derecelendirmeler adlı bir JOIN varlığıyla bağlantı kurulabilir.Eğitmenin kursa çok- 
çok ilişkisi için Courseinstructor'' CourseAssignment tercih edilir. 


Bileşik anahtar 






















FKs null değer atanamaz. CourseAssignment ( InstructorlD ve CourselD ) içindeki iki F Ks, CourseAssignment 
tablosunun her satırını benzersiz olarak tanımlar. CourseAssignment adanmış bir PK gerektirmez. InstructorlD ve 
CourselD özellikleri bileşik bir PK olarak çalışır. EF Core bileşik PKs 'leri belirtmenin tek yolu FluentAPI' dir. 
Sonraki bölümde, bileşik PK 'nin nasıl yapılandırılacağı gösterilmektedir. 

Bileşik anahtar şunları sağlar: 

• Tek bir kurs için birden çok satıra izin verilir. 

• Birden çok satıra bir eğitmen için izin verilir. 

• Aynı eğitmen ve kurs için birden çok satıra izin verilmez. 

Enrollment JOIN varlığı kendi PK 'yi tanımlar, bu nedenle bu sıralamanın yinelemeleri mümkündür.Bu tür 
yinelemeleri engellemek için: 

• FK alanlara benzersiz bir dizin ekleyin veya 

• CourseAssignment benzer bir birincil bileşik anahtarla Enroiiment yapılandırın. Daha fazla bilgi için bkz. dizinler. 


DB bağlamını güncelleştirme 


Data/SchoolContext. cs' ye aşağıdaki vurgulanmış kodu ekleyin: 


using ContosoUniversity.Models; 
using Microsoft.EntityFrameworkCore; 


namespace ContosoUniversity.Models 

{ 

public class SchoolContext : DbContext 

{ 

public SchoolContext(DbContextOptions<SchoolContext> options) : base(options) 

{ 

} 

public DbSet<Course> Courses { get; set; } 

public DbSet<Enrollment> Enrollment { get; set; } 

public DbSet<Student> Student { get; set; } 

public DbSet<Department> Departments { get; set; } 

public DbSet<Instructor> Instructors { get; set; } 

public DbSet<OfficeAssignment> OfficeAssignments { get; set; } 

public DbSet<CourseAssignment> CourseAssignments { get; set; } 

protected override void OnModelCreating(ModelBuilder modelBuilder) 

{ 

modelBuilder.Entity<Course>().ToTable("Course"); 
modelBuilder. Entity<Enrollment>().ToTable( "Enrollment"); 
modelBuilder.Entity<Student>().ToTable("Student"); 
modelBuilder.Entity<Department>().ToTable("Department"); 
modelBuilder.Entity<Instructor>().ToTable("Instructor"); 
modelBuilder.Entity<OfficeAssignment>().ToTable("OfficeAssignment"); 
modelBuilder.Entity<CourseAssignment>().ToTable("CourseAssignment"); 


} 


} 


} 


modelBuilder.Entity<CourseAssignment>() 

.HasKey(c => new { c.CourselD, c.InstructorlD }); 


Yukarıdaki kod, yeni varlıkları ekler ve CourseAssignment varlığın bileşik PK öğesini yapılandırır. 


Tutarlı API 'nin özniteliklere alternatif 


Önceki koddaki onModeicreating yöntemi EF Core davranışını yapılandırmak için FluentAPI kullanır. Genellikle tek 














bir bildirimde bir dizi yöntem çağrısı olan dize olarak kullanıldığından, API "akıcı" olarak adlandırılır. Aşağıdaki kod 
FluentAPI bir örneğidir: 

protected override void OnModelCreating(ModelBuilder modelBuilder') 

{ 

modelBuilder.Entity<Blog>() 

.Property(b => b.Url) 

.IsRequired(); 

} 

Bu öğreticide, Fluent API yalnızca özniteliklerle yapılamadığını DB eşlemesi için kullanılır.Ancak Fluent API, 
özniteliklerle yapılabilecek biçimlendirme, doğrulama ve eşleme kurallarının çoğunu belirtebilir. 

MinimumLength gibi bazı öznitelikler FluentAPI uygulanamaz. MinimumLength şemayı değiştirmez, yalnızca bir 
minimum uzunluk doğrulama kuralı uygular. 

Bazı geliştiriciler, varlık sınıflarının "temiz" olmasını sağlamak için Fluent API özel olarak kullanmayı tercih eder. 
Öznitelikler ve Fluent API karışık olabilir. Yalnızca Fluent API (bileşik bir PK belirterek) yapılabilecek bazı 
konfigürasyonlar vardır. Yalnızca özniteliklerle ( MinimumLength ) yapılabilecek bazı konfigürasyonlar vardır.Fluent 
API veya özniteliklerini kullanmak için önerilen uygulama: 

• Bu iki yaklaşımdan birini seçin. 

• Seçilen yaklaşımı mümkün olduğunca düzenli olarak kullanın. 

Bu öğreticide kullanılan özniteliklerin bazıları için kullanılır: 

• Yalnızca doğrulama (örneğin, MinimumLength ). 

• Yalnızca yapılandırma EF Core (örneğin, HasKey ). 

• Doğrulama ve EF Core yapılandırma (örneğin, [stringLength( 50 )] ). 

Öznitelikler ile Fluent API hakkında daha fazla bilgi için bkz. yapılandırma yöntemleri. 

İlişkileri gösteren varlık diyagramı 

Aşağıdaki çizimde, tamamlanmış okul modeli için EF Povver Tools 'un oluştura diyagramı gösterilmektedir. 
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Önceki diyagramda şunları gösterir: 
• Birkaç bire çok ilişki satırı (*1). 


• 

Instructor 

ve 

OfficeAssignment 

varlıkları arasında bire sıfır veya-bir ilişki çizgisi (1 ila 0.. 1) 

• 

Instructor 

ve 

Department varlıkları arasında sıfır veya-bire çok ilişki çizgisi (0.. 1 -*). 


VERITABANıNı test verileriyle çekirdek olarak 

Data/Dbınizer. csdosyasındaki kodu güncelleştirin: 


using System; 
using System. Linq; 

using Microsoft.EntityFrameworkCore; 

using Microsoft.Extensions.Dependencylnjection; 

using ContosoUniversity.Models; 

namespace ContosoUniversity.Data 

{ 

public static class Dblnitializer 

{ 

public static void Initialize(SchoolContext context) 

{ 

//context.Database.EnsureCreated(); 








































// Look for any students. 
if (context.Student.Any()) 

{ 

return; // DB has been seeded 

} 


var students = new Student[] 

{ 

new Student { FirstMidName = "Carson", LastName 
EnrollmentDate = DateTime.Parse("2010-09-01") 
new Student { FirstMidName = "Meredith", LastName 
EnrollmentDate = DateTime.Parse("2012-09-01") 
new Student { FirstMidName = "Arturo", LastName 
EnrollmentDate = DateTime.Parse("2013-09-01") 
new Student { FirstMidName = "Gytis", LastName 
EnrollmentDate = DateTime.Parse("2012-09-01") 
new Student { FirstMidName = "Yan", LastName 

EnrollmentDate = DateTime.Parse("2012-09-01") 
new Student { FirstMidName = "Peggy", LastName 
EnrollmentDate = DateTime.Parse("2011-09-01") 
new Student { FirstMidName = "Laura", LastName 
EnrollmentDate = DateTime.Parse("2013-09-01") 
new Student { FirstMidName = "Nino", LastName 
EnrollmentDate = DateTime.Parse("2005-09-01") 

}; 

foreach (Student s in students) 

{ 

context.Student.Add(s); 

} 

context.SaveChanges(); 


= "Alexander", 

L 

= "Alonso", 

h 

= "Anand", 

}, 

= "Barzdukas", 

h 

= "Lİ", 

}, 

= "Dustice", 

h 

= "Norman", 

L 

= "Olivetto", 

} 


var instructors = new Instructor[] 

{ 

new Instructor { FirstMidName = "Kim", LastName = "Abercrombie", 
HireDate = DateTime.Parse("1995-03-ll") }, 
new Instructor { FirstMidName = "Fadi", LastName = "Fakhouri", 
HireDate = DateTime.Parse("2002-07-06") }, 
new Instructor { FirstMidName = "Roger", LastName = "Harui", 
HireDate = DateTime.Parse("1998-07-01") }, 
new Instructor { FirstMidName = "Candace", LastName = "Kapoor", 
HireDate = DateTime.Parse("2001-01-15") }, 
new Instructor { FirstMidName = "Roger", LastName = "Zheng", 
HireDate = DateTime.Parse("2004-02-12") } 


}; 


foreach (Instructor i in instructors) 

{ 

context.instructors.Add(i); 

} 

context.SaveChanges(); 


var departments = new Department[] 

{ 

new Department { Name = "English", Budget = 350000, 
StartDate = DateTime.Parse("2007-09-01"), 
InstructorlD = instructors.Single( i => i.LastName 
new Department { Name = "Mathematics", Budget = 100000, 
StartDate = DateTime.Parse("2007-09-01"), 
InstructorlD = instructors.Single( i => i.LastName 
new Department { Name = "Engineering", Budget = 350000, 
StartDate = DateTime.Parse("2007-09-01"), 
InstructorlD = instructors.Single( i => i.LastName 
new Department { Name = "Economics", Budget = 100000, 
StartDate = DateTime.Parse("2007-09-01"), 
InstructorlD = instructors.Single( i => i.LastName 

}; 


"Abercrombie").ID }, 


"Fakhouri").ID }, 


"Harui").ID }, 


"Kapoor").ID } 


foreach (Department d in departments) 


{ 

context.Departments.Add(d); 

} 

context.SaveChanges(); 

var courses = new Course[] 

{ 

new Course {CourselD = 1050, Title = "Chemistry", Credits = 3, 

DepartmentlD = departments.Single( s => s.Name == "Englneering").DepartmentlD 

}, 

new Course {CourselD = 4022, Title = "Microeconomics", Credits = 3, 

DepartmentlD = departments.Single( s => s.Name == "Economics").DepartmentlD 

}, 

new Course {CourselD = 4041, Title = "Macroeconomics", Credits = 3, 

DepartmentlD = departments.Single( s => s.Name == "Economics").DepartmentlD 

}, 

new Course {CourselD = 1045, Title = "Calculus", Credits = 4, 

DepartmentlD = departments.Single( s => s.Name == "Mathematics").DepartmentlD 

}, 

new Course {CourselD = 3141, Title = "Trigonometry", Credits = 4, 

DepartmentlD = departments.Single( s => s.Name == "Mathematics").DepartmentlD 

}, 

new Course {CourselD = 2021, Title = "Composition", Credits = 3, 

DepartmentlD = departments.Single( s => s.Name == "English").DepartmentlD 

}, 

new Course {CourselD = 2042, Title = "Literatüre", Credits = 4, 

DepartmentlD = departments.Single( s => s.Name == "English").DepartmentlD 

}, 

}; 

foreach (Course c in courses) 

{ 

context.Courses.Add(c); 

} 

context.SaveChanges(); 

var officeAssignments = new OfficeAssignment[] 

{ 

new OfficeAssignment { 

InstructorlD = instructors.Single( i => i.LastName == "Fakhouri").ID, 

Location = "Smith 17" }, 
new OfficeAssignment { 

InstructorlD = instructors.Single( i => İ.LastName == "Harui").ID, 

Location = "Gowan 27" }, 
new OfficeAssignment { 

InstructorlD = instructors.Single( i => İ.LastName == "Kapoor").ID, 

Location = "Thompson 304" }, 

}; 

foreach (OfficeAssignment o in officeAssignments) 

{ 

context.OfficeAssignments.Add(o); 

} 

context.SaveChanges(); 


var courselnstructors = new CourseAssignment[] 

{ 


new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 
}, 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 
}, 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 


== "Chemistry" ).CourselD, 
i.LastName == "Kapoor").ID 


== "Chemistry" ).CourselD, 
i.LastName == "Harui”).ID 


== "Microeconomics" ).CourselD, 
i.LastName == "Zheng").ID 


1 




new CounseAssignment { 

CounselD = courses.Single(c => c.Title 
InstructorlD = instnuctons.Single(i => 

L 

new CounseAssignment { 

CounselD = counses.Single(c => c.Title 
InstnuctonlD = instnuctons.Single(i => 

L 

new CounseAssignment { 

CounselD = counses.Single(c => c.Title 
InstnuctonlD = instnuctons.Single(i => 

b 

new CounseAssignment { 

CounselD = counses.Single(c => c.Title 
InstnuctonlD = instnuctons.Single(i => 

b 

new CounseAssignment { 

CounselD = counses.Single(c => c.Title 
InstnuctonlD = instnuctons.Single(i => 

b 


== "Macnoeconomics" ).CounselD, 
i.LastName == "Zheng").ID 


== "Calculus" ).CounselD, 
i.LastName == "Fakhouni").ID 


== "Tnigonometny" ).CounselD., 
i.LastName == "Hanui").ID 


== "Composition" ).CounselD, 
i.LastName == "Abencnombie").ID 


== "Litenatune" ).CounselD, 
i.LastName == "Abencnombie").ID 


foneach (CounseAssignment ci in counselnstnuctons) 

{ 

context.CounseAssignments.Add(ci); 

} 

context.SaveChanges(); 


van ennollments = new Ennollment[] 

{ 

new Ennollment { 

StudentlD = students.Single(s => s.LastName == "Alexanden").ID, 
CounselD = counses.Single(c => c.Title == "Chemistny" ).CounselD, 

Gnade = Gnade.A 

b 

new Ennollment { 

StudentlD = students.Single(s => s.LastName == "Alexanden").ID, 
CounselD = counses.Single(c => c.Title == "Micnoeconomics" ).CounselD, 
Gnade = Gnade.C 

b 

new Ennollment { 

StudentlD = students.Single(s => s.LastName == "Alexanden").ID, 
CounselD = counses.Single(c => c.Title == "Macnoeconomics" ).CounselD, 
Gnade = Gnade.B 

b 

new Ennollment { 

StudentlD = students.Single(s => s.LastName == "Alonso").ID, 
CounselD = counses.Single(c => c.Title == "Calculus" ).CounselD, 

Gnade = Gnade.B 

b 

new Ennollment { 

StudentlD = students.Single(s => s.LastName == "Alonso").ID, 
CounselD = counses.Single(c => c.Title == "Tnigonometny" ).CounselD, 
Gnade = Gnade.B 

b 

new Ennollment { 

StudentlD = students.Single(s => s.LastName == "Alonso").ID, 

CounselD = counses.Single(c => c.Title == "Composition" ).CounselD, 
Gnade = Gnade.B 

b 

new Ennollment { 

StudentlD = students.Single(s => s.LastName == "Anand").ID, 

CounselD = counses.Single(c => c.Title == "Chemistny" ).CounselD 

b 

new Ennollment { 

StudentlD = students.Single(s => s.LastName == "Anand").ID, 

CounselD = counses.Single(c => c.Title == "Micnoeconomics").CounselD, 
Gnade = Gnade.B 


new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Barzdukas").ID, 
CourselD = courses.Single(c => c.Title == "Chemistry").CourselD, 
Grade = Grade.B 

b 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Li").ID, 

CourselD = courses.Single(c => c.Title == "Composition").CourselD, 
Grade = Grade.B 

b 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Tustice").ID, 
CourselD = courses.Single(c => c.Title == "Literatüre").CourselD, 
Grade = Grade.B 
} 

}; 


foreach (Enrollment e in enrollments) 

{ 

var enrollmentlnDataBase = context.Enrollment.Where( 
s => 

s.Student.ID == e.StudentlD && 

s.Course.CourselD == e.CourselD).SingleOrDefault(); 
if (enrollmentlnDataBase == null) 

{ 

context.Enrollment.Add(e); 

} 

} 

context.SaveChanges(); 

} 

} 

} 

Yukarıdaki kod, yeni varlıklar için tohum verileri sağlar. Bu kodun çoğu yeni varlık nesneleri oluşturur ve örnek 
verileri yükler. Örnek veriler test için kullanılır.Çoktan çoğa ekleme tablolarının nasıl çalıştırılabilir olduğunu 
gösteren örnekler için Enrollments ve CourseAssignments bakın. 

Geçiş Ekle 

Projeyi oluşturun. 

• Visual Studio 

• Visual Studio Code 


Add-Migration ComplexDataModel 


Yukarıdaki komut, olası veri kaybı hakkında bir uyarı görüntüler. 

An operation was scaffolded that may result in the loss of data. 

Please review the migration for accuracy. 

Done. To undo this action, use 'ef migrations remove' 

database update komutu çal işti r ı İd ıysa n ız aşağıdaki hata oluşturulur: 

The ALTER TABLE statement conflicted with the FOREIGN KEY constraint 
"FK_dbo.Course_dbo.Department_DepartmentID". The conflict occurred in 
database "ContosoUniversity", table "dbo.Department", column 'DepartmentlD'. 





Geçişi Uygula 

Artık var olan bir veritabanınız olduğuna göre, bundan sonraki değişikliklere nasıl uygulanacağını düşünmeniz 
gerekir. Bu öğreticide iki yaklaşım gösterilmektedir: 

• Veritabanını bırakıp yeniden oluşturun 

• Geçişi mevcut veritabanına uygulayın. Bu yöntem daha karmaşıktır ve zaman alabilir. Bu, gerçek dünyada üretim 
ortamları için tercih edilen yaklaşımdır. Note: Bu, öğreticinin isteğe bağlı bir bölümüdür. Bırakma ve yeniden 
oluşturma adımlarını gerçekleştirebilir ve bu bölümü atlayabilirsiniz. Bu bölümdeki adımları izlemek isterseniz, 
bırakma ve yeniden oluşturma adımlarını yapmayın. 

Veritabanını bırakıp yeniden oluşturun 

Güncelleştirilmiş Dbinitializer kod, yeni varlıklar için tohum verileri ekler. Yeni bir VERITABANı oluşturmak için 
EF Core zorlamak için DB 'yi bırakıp güncelleştirin: 

• Visual Studio 

• Visual Studio Code 

Paket Yöneticisi konsolunda (PMC), aşağıdaki komutu çalıştırın: 

Drop-Database 

Update-Database 

Yardım bilgileri almak için PMC'ten Get-Help about_EntityFrameworkCore çalıştırın. 

Uygulamayı çalıştırın. Uygulamayı çalıştırmak Dbinitializer.initialize yöntemini çalıştırır. 
Dbinitializer.initialize yeni DB 'yi doldurur. 

VERITABANıNı SSOX içinde açın: 

• Daha önce SSOX açıIdıysa Yenile düğmesine tıklayın. 

• Genişletin tabloları düğümü. Oluşturulan tablolar görüntülenir. 
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Courseatama tablosunu inceleyin: 

• Courseatama tablosuna sağ tıklayın ve verileri görüntüle' yi seçin. 

• Courseatama tablosunun veri içerdiğini doğrulayın. 
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Geçişi mevcut veritabanına Uygula 

Bu bölüm isteğe bağlıdır. Bu adımlar yalnızca önceki bırakma ve veritabanını yeniden oluşturma bölümünü 
atladıysanız çalışır. 

Geçişler mevcut verilerle çalıştırıldığında, mevcut verilerin karşılanmadığı FK kısıtlamalar olabilir. Üretim verileriyle, 
mevcut verilerin geçirilmesi için adımların alınması gerekir. Bu bölüm, FK kısıtlama ihlallerinin düzeltilmesiyle bir 
örnek sağlar. Bu kod değişikliklerini yedekleme olmadan yapmayın. Önceki bölümü tamamlayıp veritabanını 
güncelleştirdiyseniz, bu kod değişikliklerini yapmayın. 

{Timestamp}_ComplexDataModel. cs dosyası aşağıdaki kodu içerir: 

migrationBuilder.AddColumn<int>( 
name: "DepantmentlD ", 
table: "Course", 
type: "int", 
nullable: false, 
defaultValue: 0); 

Yukarıdaki kod counse tabloya null atanamaz DepartmentiD FK ekler.Önceki öğreticideki VERITABANı course 
satırları içerir, böylece tablo geçişler tarafından güncelleştirilemez. 

compiexDataModei geçişinin mevcut verilerle çalışmasını sağlamak için: 

• Yeni sütuna ( DepartmentiD ) varsayılan değer vermek için kodu değiştirin. 

• Varsayılan departman olarak davranacak "Temp" adlı sahte bir departman oluşturun. 

Yabancı anahtar kısıtlamalarını çözme 

compiexDataModei sınıfları up yöntemini güncelleştirin: 


• {Timestamp}_ComplexDataModel. cs dosyasını açın. 

• DepartmentiD sütununu Course tablosuna ekleyen kod satırını açıklama satırı yapın. 





























migrationBuilder.AlterColumn<string>( 
name: "Title", 
table: "Course", 
maxLength: 50, 
nullable: tnue, 
oldClrType: typeof(string), 
oldNullable: true); 

//migrationBuilder.AddColumn<int>( 

// name: "DepartmentlD", 

// table: "Counse", 

// nullable: false, 

// defaultValue: 0); 

Aşağıdaki vurgulanmış kodu ekleyin. Yeni kod .cneateTabie( name: "Department" bloğundan sonra geçer: 

migrationBuilder.CreateTable( 
name: "Department", 
columns: table => new 
{ 

DepartmentlD = table.Column<int>(type: "int", nullable: false) 

.Annotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn), 
Budget = table.Column<decimal>(type: "money", nullable: false), 

InstructorlD = table.Column<int>(type: "int", nullable: true). 

Name = table.Column<string>(type: "nvarchar(50)", maxLength: 50, nullable: true), 

StartDate = table.Column<DateTime>(type: "datetime2", nullable: false) 

}, 

constraints: table => 

{ 

table.PrimaryKey("PK_Department", x => x.DepartmentlD); 
table.ForeignKey( 

name: "FK_Department_Instructor_InstructorID", 
column: x => x.InstructorlD, 
principalTable: "Instructor", 
principalColumn: "ID", 
onDelete: ReferentialAction.Restrict); 

}); 

migrationBuilder.Sql("INSERT INTO dbo.Department (Name, Budget, StartDate) VALUES ('Temp', 0.00, GETDATE())"); 
// Default value for FK points to department created above, with 
// defaultValue changed to 1 in following AddColumn statement. 

migrationBuilder.AddColumn<int>( 
name: "DepartmentlD", 
table: "Course", 
nullable: false, 
defaultValue: 1); 

Önceki değişikliklerle, compiexDataModei up yöntemi çalıştıktan sonra mevcut course satırları "geçici" 
departmanıyla ilişkilendirilir. 

Bir üretim uygulaması şöyle olacaktır: 

• Yeni Department satırlarına Department satırları ve ilgili course satırlarını eklemek için kod veya komut 
dosyaları ekleyin. 

• "Geçici" Departmanı veya course.DepartmentlD için varsayılan değeri kullanmayın. 

Sonraki öğreticide ilgili veriler ele alınmaktadır. 

Ek kaynaklar 

• Bu öğreticinin YouTube sürümü (Bölüm 1) 











• Bu öğreticinin YouTube sürümü (Bölüm 2) 


ÖNCEKİ 


İLERİ 






ASRNET Core EF Core ile Razor Pages-llgili verileri 
oku-6/8 

23.11.2019 * 42 minutes to read ı Edit Online 


, Tom Dykstra, Jon P Smithve Rick Anderson 

Contoso Üniversitesi web uygulaması, EF Core ve Visual Studio kullanarak Razor Pages Web uygulamaları 
oluşturmayı gösterir. Öğretici serisi hakkında daha fazla bilgi için ilk öğreticiyebakın. 

Çözemediğiniz sorunlarla karşılaşırsanız, Tamamlanmış uygulamayı indirin ve öğreticiyi izleyerek bu kodu 
oluşturduğunuz şekilde karşılaştırın. 

Bu öğreticide, ilgili verilerin nasıl okunacağı ve görüntüleneceği gösterilmektedir, ilgili veriler, EF Core gezinti 
özelliklerine yüklediği veri. 

Aşağıdaki çizimler, Bu öğreticinin tamamlanan sayfalarını göstermektedir: 

ContOSO University About Students Courses Instıuctors Departments 

Courses 

Create New 


Number 

Title 

Credits 

Department 


1045 

Calculus 

4 

Mathematics 

Edit | Details | Delete 

1050 

Chemistry 

3 

Engineeıing 

Edit | Details | Delete 

2021 

Composition 

3 

English 

Edit | Details | Delete 





ContOSO University About Students Courses Instructors Departments 

Instructors 

Create New 


Last Name 

First 

Name 

Hire 

Date 

Office 

Courses 


Abercrombie 

Kim 

1995- 

03-11 


2021 

Composition 

2042 Literatüre 

| Select | Edit | 
ils | Delete 

Fakhouri 

Fadi 

2002- 

07-06 

Smith 17 

1045 Calculus 

Select | Edit | 
Details | Delete 


Courses Taught by Selected Instructor 



Number 

Title 

Department 


2021 

Composition 

English 

Select 

2042 

Literatüre 

English 

Students Enrolled in Selected Course 


Name 



Grade 

Alonso, Meredith 


B 

Li, Yan 



B 


Eager, açık ve yavaş yükleme 

EF Core bir varlığın gezinti özelliklerine ilgili verileri yükleyebilmenin birkaç yolu vardır: 


• Eager yükleniyor. Ekip yükleme, bir varlık türü için bir sorgu aynı zamanda ilgili varlıkları de yüklediğinde 
oluşur. Bir varlık okunmadığınızda ilgili veriler alınır. Bu, genellikle gereken tüm verileri alan tek bir JOIN 
sorgusuna neden olur. EF Core, bazı Eager yükleme türleri için birden çok sorgu yayımlayacak. Birden çok 
sorgu verme, çok büyük paketlerini tek sorgusundan daha verimli olabilir, inciude ve Theninciude 
yöntemleriyle Eager yüklemesi belirtildi. 


var departments = _context.Departments.Include(d => d.Courses); 
foreach (Department d in departments), 

foreach(course c in d.courses) Query: ali Department entities 

t 1 and related Course entities 

courseList.Add(d.Name + c.Title); 

} 





} 


Bir koleksiyon gezintisi eklendiğinde Eager yüklemesi birden çok sorgu gönderir: 
o Ana sorgu için bir sorgu 

o Yükleme ağacındaki her koleksiyon "Edge" için bir sorgu. 

• Sorguları Load ile ayırın: veriler ayrı sorgularda alınabilir ve EF Core "düzeltmeler" 1 i "düzeltir". 








"Düzeltmeler", EF Core gezinti özelliklerini otomatik olarak dolduran anlamına gelir. Load ile ayrı sorgular, 
ek yükleme Eager 'dan daha da benzer. 


var departments = _context.Departments; 
foreach (Department d in departments)— 
{ 



Query: ali Department rows 



•*C 


LOjjdO; 


_context.Courses.Where(c => c.DepartmentlD == d.DepartmentlD).Lojd(); 
foreach (Course c in d.Courses) 

{ 

courseList.Add(d.Name + c.Title); 

} 


ûuery: Course rows related to Department d 



Note: EF Core, daha önce bağlam örneğine yüklenmiş olan diğer varlıklar için gezinti özelliklerini otomatik 
olarak düzeltir. Bir gezinti özelliği için veriler açıkça dahil edilmese bile, ilgili varlıkların bazıları veya tümü 
daha önce yüklenmişse Özellik yine de doldurulabilir. 


• Açık yükleme. Varlık ilk kez okunmadıysa ilgili veriler alınmadı. Gerektiğinde ilgili verileri almak için kodun 
yazılması gerekir. Ayrı sorgularla açık yükleme, veritabanına birden çok sorgu gönderilmesine neden olur. 
Açık yükleme ile kod, yüklenecek gezinti özelliklerini belirtir. Açık yükleme yapmak için Load yöntemini 
kullanın. Örneğin: 


var departments = _context.Departments; 
foreach (Department d in departments) 

{ 


Ûuery: ali Department rows 


_context.Entry(d).Collection(p => p.Courses).Load(); 
foreach (Course c in d.Courses) Vv 


courseList.Add(d.Name + c.Title) 


Ûuery 


: Course rows related to Department 



• Yavaş yükleme. Sürüm 2,1 ' de EF Core geç yükleme eklendi. Varlık ilk kez okunmadıysa ilgili veriler 

alınmadı. Gezinti özelliğine ilk kez erişildiğinde, bu gezinti özelliği için gereken veriler otomatik olarak alınır. 
Bir gezinti özelliğine ilk kez erişildiğinde bir sorgu veritabanına gönderilir. 


Kurs sayfaları oluşturma 

course varlığı, ilgili Department varlığını içeren bir gezinti özelliği içerir. 

















Department 


Properties 
yî DepartmentlD 
A Name 
A Budget 
A StartDate 
A InstructorlD 
Navigation Properties 
Administrator 
y'S Courses 





Course 


Properties 
y? CourselD 
A Title 
A Credits 
A DepartmentlD 
Navigation Properties 
y'S Department 
y3 Enrollments 
yİ] CourseAssignments 


Bir kurs için atanan departmanın adını göstermek için: 

• ilgili Department varlığını Course.Department gezinti özelliğine yükleyin. 

• Department varlığın Name özelliğinden adı alın. 

Yapı iskelesi kurs sayfaları 

• Visual Studio 

• Visual Studio Code 

• Aşağıdaki özel durumlarla birlikte Yapı Fkatlama öğrenci sayfalarındaki yönergeleri izleyin: 

o Bir Sayfalar/kurslar klasörü oluşturun, 
o Model sınıfı için course kullanın. 

o Yeni bir tane oluşturmak yerine var olan bağlam sınıfını kullanın. 

• Pages/kurslar/lndex. cshtml. cs dosyasını açın ve onGetAsync metodunu inceleyin. Yapı iskelesi altyapısı, 

Department gezinti özelliği için bir yükleme belirtti, inciude yöntemi Eager yüklemeyi belirtir. 

• Uygulamayı çalıştırın ve Kurslar bağlantısını seçin. Departman sütunu, yararlı olmayan DepartmentlD 
görüntüler. 

Departmanın adını görüntüleme 

Pages/kurslar/lndex. cshtml. cs dosyasını aşağıdaki kodla güncelleştirin: 




















using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.EntityFrameworkCore; 
using System.Collections.Generic; 
using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Courses 

{ 

public class IndexModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public IndexModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

public IList<Course> Courses { get; setj } 

public async Task OnGetAsync() 

{ 

Courses = await _context.Courses 
.Include(c => c.Department) 

.AsMoTracking() 

.ToListAsync(); 

} 

} 

} 

Yukarıdaki kod course özelliğini courses olarak değiştirir ve AsNoTracking ekler. AsNoîracking , döndürülen 
varlıklar izlenmediğinden performansı geliştirir. Varlıkların geçerli bağlamda güncelleştirilmediği için izlenmesi 
gerekmez. 

Pages/kurslar/!ndex. cshtml 'yi aşağıdaki kodla güncelleştirin. 







@page 

@model ContosoUniversity.Pages.Courses.IndexModel 

@{ 

ViewData["Title"] = "Courses"; 

} 

<hl>Courses</hl> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

ctable class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model = > model.Courses[0].CourselD) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Courses[0].Tltle) 

</th> 

<th> 

@Html.DisplayNameFor(model = > model.Courses[0].Credits) 

</th> 

<th> 

@Html.DisplayNameFor(model = > model.Courses[0].Department) 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model.Courses) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.CourselD) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Credits) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Department.Name) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.CourseID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.CourseID">Details</a> | 

<a asp-page="./Delete" asp-route-id="@item.CourseID">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 


Yapı iskelesi kodunda aşağıdaki değişiklikler yapılmıştır: 

• Course Özellik adı courses olarak değiştirildi. 

• CourselD özellik değerini gösteren bir sayı sütunu eklendi. Birincil anahtarlar, genellikle son kullanıcılara 
anlamlı olduklarından, varsayılan olarak yapı iskelesi göstermemektedir. Ancak, bu durumda birincil anahtar 
anlamlı olur. 


• Departman adını göstermek için Departman sütunu değiştirildi. Kod, Department gezinti özelliğine 







yüklenen Department varlığının Name özelliğini görüntüler: 


@Html.DisplayFor(modelItem => item.Department.Name) 


Uygulamayı çalıştırın ve bölüm adlarıyla listeyi görmek için Kurslar sekmesini seçin. 


ContOSO University About Students Courses Instıuctors Departments 

Courses 

Create New 


Number 

Title 

Credits 

Department 


1045 

Calculus 

4 

Mathematics 

Edit | Details | Delete 

1050 

Chemistry 

3 

Engineering 

Edit | Details | Delete 

2021 

Composition 

3 

English 

Edit | Details | Delete 


Select ile ilgili verileri yükleme 

onGetAsync yöntemi, inciude yöntemiyle ilgili verileri yükler, select yöntemi, yalnızca gerekli ilgili verileri 
yükleyen bir alternatiftir. Tek öğeler için, Department.Name gibi bir SQL İç BİRLEŞİMİ kullanır.Koleksiyonlar için, 
başka bir veritabanı erişimi kullanır, ancak koleksiyonlar üzerinde inciude işleci olur. 


Aşağıdaki kod select yöntemiyle ilgili verileri yükler: 

public IList<CourseViewModel> CourseVM { get; set; } 

public async Task OnGetAsync() 

{ 

CourseVM = await _context.Courses 

.Select(p => new CourseViewModel 
{ 

CourselD = p.CourselD, 

Title = p.Title, 

Credlts = p.Credits, 

DepartmentName = p.Department.Name 
}).ToListAsync(); 

} 


CourseViewModel : 


public class CourseViewModel 
{ 

public int CourselD { get; set; } 
public string Title { get; set; } 
public int Credits { get; set; } 
public string DepartmentName { get; set; } 

} 


Tüm örnek için bkz. ındexselect. cshtml ve lndexSelect.cshtml.cs . 

Eğitmen sayfaları oluşturma 












Bu bölüm, eğitmen sayfalarını derler ve ilgili Kurslar ve kayıtları eğitmenler dizin sayfasına ekler. 


ContOSO University About Students Courses Instructors Departments 

Instructors 

Create New 


Last Name 

First 

Name 

Hire 

Date 

Office 

Courses 


Abercrombie 

Kim 

1995- 

03-11 


2021 

Composition 

2042 Literatüre 

| Select | Edit | 

Is | Delete 

Fakhouri 

Fadi 

2002- 

07-06 

Smith 17 

1045 Calculus 

Select | Edit | 
Details | Delete 


Courses Taught by Selected Instructor 



Number 

Title 

Department 


2021 

Composition 

English 

Select 

2042 

Literatüre 

English 

Students Enrolled in Selected Course 


Name 



Grade 

Alonso, Meredith 


B 

Li, Yan 



B 


Bu sayfa aşağıdaki yollarla ilgili verileri okur ve görüntüler: 

• Eğitmenler listesi officeAssignment varlığındaki ilgili verileri (önceki görüntüde Office) görüntüler. Instructor 
ve OfficeAssignment varlıkları bire sıfır veya-bir ilişkidir. OfficeAssignment varlıkları için Eager yüklemesi 
kullanılır. Eager yüklemesi, ilgili verilerin görüntülenmesi gerektiğinde genellikle daha etkilidir. Bu durumda, 
Eğitmenler için Office atamaları görüntülenir. 

• Kullanıcı bir eğitmen seçtiğinde ilgili course varlıkları görüntülenir. ınstructor ve course varlıkları çoktan 
çoğa bir ilişkidir. Eager yüklemesi, course varlıkları ve ilgili Department varlıkları için kullanılır. Bu durumda, 
yalnızca seçili eğitmen için kurslar gerektiğinden ayrı sorgular daha verimli olabilir. Bu örnek, gezinti 
özelliklerinde olan varlıklarda gezinti özellikleri için Eager yükleme ’nin nasıl kullanılacağını gösterir. 


• Kullanıcı bir kurs seçtiğinde 

Enrollments 

varlığındaki ilgili veriler görüntülenir. Önceki görüntüde öğrenci adı ve 

sınıf görüntülenir. 

Course 

ve 

Enrollment 

varlıkları bire çok ilişkidir. 


Görünüm modeli oluşturma 

Eğitmenler sayfasında, üç farklı tablodan alınan veriler gösterilir. Üç tabloyu temsil eden üç özellik içeren bir 
görünüm modeli gerekir. 

Aşağıdaki kodla SchoolViewModels/mcpctormdexdata. cs oluşturun: 












using System; 

using System.Collections.Generic; 

using System.Linq; 

using System.Thneading.Tasks; 


namespace ContosoUniversity.Models.SchoolViewModels 
{ 

public class InstructorIndexData 
{ 

public IEnumenable<Instnuctor> Instnuctors { get; set; } 
public IEnumerable<Course> Courses { get; set; } 
public IEnumerable<Enrollment> Ennollments { get; set; } 

} 


Yapı iskelesi eğitmeni sayfaları 

• Visual Studio 

• Visual Studio Code 

• Öğrenci sayfalarını aşağıdaki özel durumlarla birlikte Scaffold içindeki yönergeleri izleyin: 

o Bir sayfa/eğitmenler klasörü oluşturun, 
o Model sınıfı için instructor kullanın. 

o Yeni bir tane oluşturmak yerine var olan bağlam sınıfını kullanın. 

Yapı iskelesi sayfasının güncelleştirmeden önce nasıl göründüğünü görmek için, uygulamayı çalıştırın ve eğitmenler 
sayfasına gidin. 

Pages/eğitmenler/lndex. cshtml. cs dosyasını aşağıdaki kodla güncelleştirin: 





using ContosoUniversity.Models; 

using ContosoUniversity.Models.SchoolViewModels; // Add VM 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using Microsoft.EntityFrameworkCore; 

using System.Linq; 

using System.Threading.Tasks; 

namespace Contosollniversity. Pages. Instructors 

{ 

public class IndexModel : PageModel 

{ 

private readonly Contosollniversity.Data.SchoolContext _context; 

public IndexModel(Contosollniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

public InstructorIndexData InstructorData { get; set; } 
public int InstructorlD { get; set; } 
public int CourselD { get; set; } 

public async Task OnGetAsync(int? id, int? courselD) 

{ 

InstructorData = new InstructorIndexData(); 

InstructorData.Instructors = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Department) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Enrollments) 

.Thenlnclude(i => i.Student) 

.AsNoTracking() 

.OrderBy(i => i.LastName) 

.ToListAsync(); 

if (id != null) 

{ 

InstructorlD = id.Value; 

Instructor instructor = InstructorData.Instructors 
.Where(i => i.ID == id.Value).Single(); 

InstructorData.Courses = instructor.CourseAssignments.Select(s => s.Course); 

} 

if (courselD != null) 

{ 

CourselD = courselD.Value; 

var selectedCourse = InstructorData.Courses 

.Where(x => x.CourselD == courselD).Single(); 

InstructorData.Enrollments = selectedCourse.Enrollments; 

} 

} 

} 

} 

onGetAsync yöntemi, seçilen eğitmenin KİMLİĞİ için isteğe bağlı rota verilerini kabul eder. 


Pages/eğitmenler/lndex. cshtml. cs dosyasındaki sorguyu inceleyin: 


InstructorData.Instructors = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i = > i.Course) 

.Thenlnclude(i = > i.Department) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Enrollments) 
.Thenlnclude(i => i.Student) 

.AsNoTracking() 

.OrderBy(i => i.LastName) 

.Tol_istAsync(); 


Kod, aşağıdaki gezinti özellikleri için Eager yüklemeyi belirtir: 


• Instructor.OfficeAssignment 

• Instructor.CourseAssignments 
o CourseAssignments.Course 

o Course.Department 
o Course.Enrollments 
o Enrollment.Student 

courseAssignments ve Course için inciude ve Theninciude yöntemlerinin yinelendiğine dikkat edin. Bu yineleme, 
course varlığının iki gezinti özelliği için Eager yüklemesi belirtmek için gereklidir. 

Aşağıdaki kod, bir eğitmen seçildiğinde ( id != nuiı ) yürütülür. 

if (id != null) 

{ 

InstructorlD = id.Value; 

Instructor instructor = InstructorData.Instructors 
.Where(i => i.ID == id.Value).Single(); 

InstructorData.Courses = instructor.CourseAssignments.Select(s => s.Course); 

} 

Seçilen eğitmen, görünüm modelindeki eğitmenler listesinden alınır.Görünüm modelinin courses özelliği, bu 
eğitmenin CourseAssignments gezinti özelliğinden course varlıklarla birlikte yüklenir. 

where yöntemi bir koleksiyon döndürür. Ancak bu durumda filtre tek bir varlık seçer. Bu nedenle, koleksiyonu tek 
bir instructor varlığına dönüştürmek için Single yöntemi çağırılır, instructor varlığı CourseAssignments 
özelliğine erişim sağlar. CourseAssignments ilgili course varlıklarına erişim sağlar. 
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Koleksiyonda yalnızca bir öğe olduğunda single yöntemi bir koleksiyonda kullanılır. Koleksiyon boşsa veya birden 
fazla öğe varsa single yöntemi bir özel durum oluşturur. Bir alternatif, koleksiyon boşsa varsayılan bir değer (Bu 
durumda null) döndüren singleOrDefault . 

Aşağıdaki kod, bir kurs seçildiğinde görünüm modelinin Enroiiments özelliğini doldurur: 

if (courselD != null) 

{ 

CourselD = courselD.Value; 

var selectedCourse = InstructorData.Courses 

.Where(x => x.CourselD == courselD).Single(); 

InstructorData.Enrollments = selectedCourse.Enrollments; 

} 


Eğitmenler Dizin sayfasını Güncelleştir 

Pages/eğitmenler/lndex. cshtml dosyasını aşağıdaki kodla güncelleştirin. 

@page "{idıint?}" 

@model ContosoUnlversity.Pages.Instructors.IndexModel 

@{ 

ViewData["Title"] = "Instructors"; 

} 

<h2>Instructors</h2> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<table class="table"> 

<thead> 

<tr> 

<th>Last Name</th> 

<th>First Name</th> 






















<th>Hire Date</th> 

<th>Office</th> 

<th>Courses</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

Şforeach (var item in Model.InstructorData.Instructors) 

{ 

string selectedRow = ""; 
if (item.ID == Model.InstructorlD) 

{ 

selectedRow = "table-success"; 

} 

<tr class="@selectedRow"> 

<td> 

ŞHtml.DisplayFor(modelItem => item.LastName) 

</td> 

<td> 

ŞHtml.DisplayFor(modelItem => item.FirstMidName) 

</td> 

<td> 

ŞHtml.DisplayFor(modelItem => item.HireDate) 

</td> 

<td> 

Şif (item.OfficeAssignment != null) 

{ 

Şitem.OfficeAssignment.Location 

} 

</td> 

<td> 

foreach (var course in item.CourseAssignments) 

{ 

Şcourse.Course.CourselD Ş: Şcourse.Course.Title <br /> 

} 

} 

</td> 

<td> 

<a asp-page="./Index" asp-route-id="Şitem.ID">Select</a> | 

<a asp-page="./Edit" asp-route-id="Şitem.ID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID">Details</a> | 

<a asp-page="./Delete" asp-route-id="Şitem.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 

Şif (Model.InstructorData.Courses != null) 

{ 

<h3>Courses Taught by Selected Instructor</h3> 
ctable class="table"> 

<tr> 

<thx/th> 

<th>Number</th> 

<th>Title</th> 

<th>Department</th> 

</tr> 

Şforeach (var item in Model.InstructorData.Courses) 

{ 

string selectedRow = ""; 

if (item.CourselD == Model.CourselD) 

{ 

selectedRow = "table-success"; 

} 

<tr class="@selectedRow"> 

<td> 


<a asp-page="./Index" asp-route-courseID="@item.CourseID">Select</a> 
</td> 

<td> 

(Şitem.CourselD 

</td> 

<td> 

Şitem.Title 

</td> 

<td> 

@item.Department.Name 
</td> 

</tr> 

} 

</table> 


Şif (Model.InstructorData.Enrollments ! = null) 

{ 

<h3> 

Students Enrolled in Selected Course 
</h3> 

<table class="table"> 

<tr> 

<th>Name</th> 

<th>Grade</th> 

</tr> 

Şforeach (var item in Model.InstructorData.Enrollments) 

{ 

<tr> 

<td> 

Şitem.Student.FullName 
</td> 

<td> 

@Html.DisplayFor(modelItem => item.Grade) 
</td> 

</tr> 

} 

</table> 

} 


Yukarıdaki kod aşağıdaki değişiklikleri yapar: 

• Güncelleştirmeleri page gelen yönerge @page için @page "{id:int?}" . "{id:int?}" bir rota şablonudur. Yol 
şablonu, verileri yönlendirmek için URL 'deki tamsayı Sorgu dizelerini değiştirir. Örneğin, yalnızca @page 
yönergesine sahip bir eğitmenin Select bağlantısına tıkladığınızda aşağıdakiler gibi bir URL üretilir: 


https://localhost:5001/Instructors?id=2 

Sayfa yönergesi @page "{id:int?}" olduğunda URL şu şekilde olur: 
https://localhost:5001/Instructors/2 

• Yalnızca item.officeAssignment null olmaması durumunda ıtem.officeAssignment.Location görüntüleyen bir 
Office sütunu ekler. Bu bire sıfır veya-bir ilişki olduğundan ilgili bir OfficeAssignment varlığı bulunmayabilir. 

@if (İtem.officeAssignment != null) 

{ 

@item.OfficeAssignment.Location 

} 

• Her bir eğitmen tarafından taders kurslarını görüntüleyen bir Kurslar sütunu ekler. Bu Razor sözdizimi 
hakkında daha fazla bilgi için bkz. açık hat geçişi. 












• Seçilen eğitmenin ve kursun tr öğesine dinamik olarak ciass="success" ekleyen kodu ekler. Bu, bir 
önyükleme sınıfı kullanarak seçili satır için bir arka plan rengi ayarlar. 

string selectedRow = 
if (item.CourselD == Model.CourselD) 

{ 

selectedRow = "success"; 

} 

<tr class="(5)selectedRow"> 


Selectetiketli yeni bir köprü ekler. Bu bağlantı, seçilen eğitmenin KİMLİĞİNİ 
bir arka plan rengi ayarlar. 

Index 

yöntemine gönderir ve 

<a asp-action="Index" asp-route-id="@item.ID">Select</a> | 


• Seçili eğitmen için bir kurs tablosu ekler. 

• Seçili kurs için bir öğrenci kayıtları tablosu ekler. 

Uygulamayı çalıştırın ve eğitmenler sekmesini seçin. Sayfada ilgili officeAssignment varlığındaki Location 
(Office) görüntülenir. OfficeAssignment null ise boş bir tablo hücresi görüntülenir. 

Bir eğitmenin Seç bağlantısına tıklayın. Bu eğitmenin atandığı satır stili değişiklikleri ve kurslar görüntülenir. 
Kayıtlı öğrenciler ve bunların onların listesini görmek için bir kurs seçin. 










ContOSO University About Students Courses Instructors Departments 

Instructors 

Create New 


Last Name 

First 

Name 

Hire 

Date 

Office 

Courses 


Abercrombie 

Kim 

1995- 

03-11 


2021 

Composition 

2042 Literatüre 

| Select | Edit | 
ils | Delete 

Fakhouri 

Fadi 

2002- 

07-06 

Smith 17 

1045 Calculus 

Select | Edit | 
Details | Delete 


Courses Taught by Selected Instructor 



Number 

Title 

Department 


2021 

Composition 

English 

Select 

2042 

Literatüre 

English 

Students Enrolled in Selected Course 


Name 



Grade 

Alonso, Meredith 


B 

Li, Yan 



B 


Tek kullanımı 


single yöntemi, where yöntemini ayrı çağırmak yerine where koşulunu geçirebilir: 







public async Task OnGetAsync(int? id, int? courselD) 

{ 

InstructorData = new InstructorIndexData(); 

InstructorData.Instructors = await _context.Instructors 
.Include(i = > i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i = > i.Department) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i = > i.Course) 

.Thenlnclude(i => i.Enrollments) 

.Thenlnclude(i => i.Student) 

.AsNoTracking() 

.OrderBy(i => i.LastName) 

.ToListAsync(); 

if (id != null) 

{ 

InstructorlD = id.Value; 

Instructor instructor = InstructorData.Instructors.Single( 
i => i.ID == id.Value); 

InstructorData.Courses = instructor.CourseAssignments.Select( 
s => s.Course); 

} 

if (courselD != null) 

{ 

CourselD = courselD.Value; 

InstructorData.Enrollments = InstructorData.Courses.Single( 
x => x.CourselD == courselD).Enrollments; 

} 

} 

VVhere koşulunun kişisel tercihle ilgili olduğu single kullanımı. where yöntemi kullanılarak herhangi bir avantaj 
sağlamaz. 

Açık yükleme 

Geçerli kod Enrollments ve students için Eager yüklemeyi belirtir: 

InstructorData.Instructors = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Department) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Enrollments) 

.Thenlnclude(i => i.Student) 

.AsNoTracking() 

.OrderBy(i => i.LastName) 

.ToListAsync(); 


Kullanıcıların bir kursa kayıtları nadiren görmek istediğini varsayalım. Bu durumda, bir iyileştirme yalnızca 
isteniyorsa kayıt verilerini yüklemek olacaktır. Bu bölümde onGetAsync , Enrollments ve students açık yüklemesini 
kullanacak şekilde güncelleştirilir. 

Pages/eğitmenler/lndex. cshtml. cs dosyasını aşağıdaki kodla güncelleştirin. 









using ContosoUniversity.Models; 

using ContosoUniversity.Models.SchoolViewModels; // Add VM 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using Microsoft.EntityFrameworkCore; 

using System.Linq; 

using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Instructors 

{ 

public class IndexModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public IndexModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

public InstructorIndexData InstructorData { get; set; } 
public int InstructorlD { get; set; } 
public int CourselD { get; set; } 

public async Task OnGetAsync(int? id, int? courselD) 

{ 

InstructorData = new InstructorIndexData(); 

InstructorData.Instructors = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Department) 

//.Include(i = > İ.CourseAssignments) 

// .Thenlnclude(i => i.Course) 

// .Thenlnclude(i => i.Enrollments) 

// .Thenlnclude(i => i.Student) 

//.AsNoTracking() 

.OrderBy(i => i.LastName) 

.ToListAsync(); 

if (id != null) 

{ 

InstructorlD = id.Value; 

Instructor instructor = InstructorData.Instructors 
.Where(i => i.ID == id.Value).Single(); 

InstructorData.Courses = instructor.CourseAssignments.Select(s => s.Course); 

} 

if (courselD != null) 

{ 

CourselD = courselD.Value; 

var selectedCourse = InstructorData.Courses 

.Where(x => x.CourselD == courselD).Single(); 
await _context.Entry(selectedCourse).Collection(x => x.Enrollments).LoadAsync(); 
foreach (Enrollment enrollment in selectedCourse.Enrollments) 

{ 

await _context.Entry(enrollment).Reference(x => x.Student).LoadAsync(); 

} 

InstructorData.Enrollments = selectedCourse.Enrollments; 

} 

} 

} 

} 


Yukarıdaki kod, kayıt ve öğrenci verileri için Thenmclude Yöntem çağrılarını bırakır. Bir kurs seçilirse, açık yükleme 
kodu alır: 


• Seçili kurs için Enrollment varlıkları. 




• Her bir Enroiiment için student varlıkları. 


Yukarıdaki kod yorumlarının .AsNoTrackingO dikkat edin. Gezinti özellikleri yalnızca izlenen varlıklar için açık bir 
şekilde yüklenebilir. 

Uygulamayı test edin. Bir kullanıcının perspektifinden, uygulama önceki sürümle aynı şekilde davranır. 

Sonraki adımlar 

Sonraki öğreticide ilgili verileri güncelleştirme gösterilmektedir. 


ÖNCEKİ ■ SONRAKİ 

ÖĞRETİCİ ■ ÖĞRETİCİ 


Bu öğreticide ilgili veriler okundu ve görüntülenir, ilgili veriler, EF Core gezinti özelliklerine yüklediği veri. 

Olamaz çözmenize, sorunlarla karşılaşırsanız, indirin veya tamamlanmış uygulamayı görüntüleyin. Yükleme 
yönergeleri. 

Aşağıdaki çizimler, Bu öğreticinin tamamlanan sayfalarını göstermektedir: 


H Courses - Contoso Univ X + 


□ X 

^ £3 localhost:58 

☆ 

=- 

■••••■ 

Contoso University 


— 


Courses 


Create New 


Number 

Title 

Credits 

Department 


1045 

Calculus 

4 

Mathematics 

Edit | Details | Delete 

1050 

Chemistry 

3 

Engineering 

Edit | Details | Delete 

2021 

Composition 

3 

English 

Edit | Details | Delete 

















□ 

X 

Instructors - Contoso L X 



<r ^ O 

© locaIhost: 1234/1 nstructors/3?courselD=1050&action=OnGetAsync 


Contoso University 

— 

- 


Instructors 


Create New 



First 

Hire 




Last Name 

Name 

Date 

Office 

Courses 


Abercrombie 

Kim 

1995-03- 


2021 Composition 

Select | Edit | Details | 



11 


2042 Literatüre 

Delete 

Fakhouri 

Fadi 

2002-07- 

Smith 17 

1045 Calculus 

Select | Edit | Details | 



06 



Delete 

Harui 

Roger 

1998-07- 

Gowan 27 

1050 Chemistry 

1 1 1 Edit I Details I 



01 


3141 Trigonometry 


Kapoor 

Candace 

2001-01- 

Thompson 

1050 Chemistry 

Select | Edit | Details | 



15 

304 


Delete 

Zheng 

Roger 

2004-02- 


4022 

Select | Edit | Details | 



12 


Microeconomics 

Delete 


4041 

Macroeconomics 


Courses Taught by Selected Instructor 




Number 

Title 

Department 

Select 


1050 

Chemistry 

Engineering 

Select 


3141 

Trigonometry 

Mathematics 


Students Enrolled in Selected Course 


Name 

Grade 

Alexander, Carson 

A 

Anand, Arturo 

No grade 

Barzdukas, Gytis 

B 
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İlgili verilerin Eager, açık ve geç yüklemesi 

EF Core bir varlığın gezinti özelliklerine ilgili verileri yükleyebilmenin birkaç yolu vardır: 

• Eager yükleniyor. Ekip yükleme, bir varlık türü için bir sorgu aynı zamanda ilgili varlıkları de yüklediğinde 
oluşur. Varlık okunmadığınızda ilgili veriler alınır.Bu, genellikle gereken tüm verileri alan tek bir JOIN 
sorgusuna neden olur. EF Core, bazı Eager yükleme türleri için birden çok sorgu yayımlayacak. Birden çok 
sorgu verilmesi, EF6 içindeki bazı sorgular için tek bir sorgunun bulunduğu durumda daha verimli olabilir. 

















inciııde ve Theninciude yöntemleriyle Eager yüklemesi belirtildi. 


var departments = _context.Departments.Include(d => d.courses); 
foreach (Department d in departments), 

foreach(course c in d.courses) Query: ali Department entities 


{ 


courseList.Add(d.Name + c.Title); 




and related Course entities 



} 


Bir koleksiyon gezintisi eklendiğinde Eager yüklemesi birden çok sorgu gönderir: 


o Ana sorgu için bir sorgu 

o Yükleme ağacındaki her koleksiyon "Edge" için bir sorgu. 

• Sorguları Load ile ayırın: veriler ayrı sorgularda alınabilir ve EF Core "düzeltmeler" 1 i "düzeltir". 

"düzeltmeler", EF Core gezinti özelliklerini otomatik olarak dolduran anlamına gelir. Load ile ayrı sorgular, ek 
yükleme Eager 'dan daha da benzer. 


var departments = _context.Departments; 
foreach (Department d in departments)- 
{ 


r~ 


Query: ali Department rows 


D 


-c 




_context.Courses.Where(c => c.DepartmentlD == d.DepartmentlD).Lojd(); 
foreach (Course c in d.Courses) 

{ 

courseList.Add(d.Name + c.Title); 

} 


ûuery: Course rows related to Department d 


J 


Note: EF Core, daha önce bağlam örneğine yüklenmiş olan diğer varlıklar için gezinti özelliklerini otomatik 
olarak düzeltir. Bir gezinti özelliği için veriler açıkça dahil edilmese bile, ilgili varlıkların bazıları veya tümü 
daha önce yüklenmişse Özellik yine de doldurulabilir. 


• Açık yükleme. Varlık ilk kez okunmadıysa ilgili veriler alınmadı. Gerektiğinde ilgili verileri almak için kodun 
yazılması gerekir. Ayrı sorgularla açık yükleme, VERITABANıNA birden çok sorgu gönderilmesine neden 
olur. Açık yükleme ile kod, yüklenecek gezinti özelliklerini belirtir. Açık yükleme yapmak için Load yöntemini 
kullanın. Örneğin: 


var departments = _context.Departments; 
foreach (Department d in departments) 

{ 


Query: ali Department rows 


J 


_context.Entry(d)-Collection(p => p.Courses).Load(); 
foreach (Course c in d.courses) ^ 

{ | ûuery: Course rows related to Department 

courseList.Add(d.Name + c.Title); 

} 



• Yavaş yükleme. Sürüm 2,1 1 de EF Core geç yükleme eklendi. Varlık ilk kez okunmadıysa ilgili veriler 
alınmadı. Gezinti özelliğine ilk kez erişildiğinde, bu gezinti özelliği için gereken veriler otomatik olarak alınır. 
Bir gezinti özelliğine ilk kez erişildiğinde bir sorgu VERITABANıNA gönderilir. 

• Select işleci yalnızca gerekli ilgili verileri yükler. 


Bölüm adını görüntüleyen bir kurs sayfası oluşturma 

Kurs varlığı, Department varlığını içeren bir gezinti özelliği içerir. Department varlığı, kursun atandığı departmanı 
içerir. 

Bir kurs listesinde atanan departmanın adını göstermek için: 


• 

Department 

varlığındaki 

Name 

özelliğini alın. 

• 

Department 

varlık 

Course.Department 

gezinti özelliğinden gel 

























Department 


Properties 
yî DepartmentlD 
A Name 
A Budget 
A StartDate 
A InstructorlD 
Navigation Properties 
y3 Administrator 
y'S Courses 





Course 


Properties 
Y? CourselD 
A Title 
A Credits 
A DepartmentlD 
Navigation Properties 
Y^ Department 
y3 Enrollments 
Yİ! CourseAssignments 


Kurs modelini temklesi 

• Visual Studio 

• Visual Studio Code 

Bölümündeki yönergeleri Öğrenci modeli iskelesini ve course model sınıfı için. 

Önceki komut iskelesini kurar course modeli. Projeyi Visual Studio'da açın. 

Pages/kurslar/lndex. cshtml. cs dosyasını açın ve onGetAsync metodunu inceleyin. Yapı iskelesi altyapısı, 
Department gezinti özelliği için bir yükleme belirtti, inciude yöntemi Eager yüklemeyi belirtir. 

Uygulamayı çalıştırın ve Kurslar bağlantısını seçin. Departman sütunu, yararlı olmayan DepartmentlD görüntüler. 

OnGetAsync yöntemini aşağıdaki kodla güncelleştirin: 

public async Task OnGetAsync() 

{ 

Course = await _context.Courses 
.Include(c => c.Department) 

.AsNoTracking() 

.ToListAsync(); 

} 

Yukarıdaki kod AsNoTracking ekler. AsNoTracking , döndürülen varlıklar izlenmediğinden performansı geliştirir. 
Geçerli bağlamda güncelleştirilmemiş oldukları için varlıklar izlenmiyor. 

Pages/kurslar/lndex. cshtml 'yi aşağıdaki vurgulanmış işaretlerle güncelleştirin: 





















@page 

@model ContosoUniversity.Pages.Courses.IndexModel 

@{ 

ViewData["Title"] = "Courses"; 

} 

<h2>Courses</h2> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

ctable class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model => model.Course[0].CourselD) 

</th> 

<th> 

@Html.DisplayNameFor(model = > model.Course[0].Title) 

</th> 

<th> 

@Html.DisplayNameFor(model = > model.Course[0].Credlts) 

</th> 

<th> 

@Html.DisplayNameFor(model = > model.Course[0].Department) 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

(Şforeach (var item in Model.Course) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.CourselD) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Credits) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Department.Name) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.CourseID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.CourseID">Details</a> | 
<a asp-page="./Delete" asp-route-id="@item.CourseID">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 


Yapı iskelesi kodunda aşağıdaki değişiklikler yapılmıştır: 

• Başlık dizinden kurslar olarak değiştirildi. 

• CourselD özellik değerini gösteren bir sayı sütunu eklendi. Birincil anahtarlar, genellikle son kullanıcılara 
anlamlı olduklarından, varsayılan olarak yapı iskelesi göstermemektedir. Ancak, bu durumda birincil anahtar 
anlamlı olur. 

• Departman adını göstermek için Departman sütunu değiştirildi. Kod, Department gezinti özelliğine 
yüklenen Department varlığının Name özelliğini görüntüler: 







@Html.DisplayFor(modelItem => item.Department.Name) 


Uygulamayı çalıştırın ve bölüm adlarıyla listeyi görmek için Kurslar sekmesini seçin. 


H Courses - Contoso Univ X + 


□ X 

^ localhost:58 

☆ 


Contoso University 


— 


Courses 


Create New 


Number 

Title 

Credits 

Department 


1045 

Calculus 

4 

Mathematics Edit | 

| Details | Delete 

1050 

Chemistry 

3 

Engineenng Edit | 

| Details | Delete 

2021 

Composition 

3 

English Edit | Details | Delete 


ı i 





Select ile ilgili verileri yükleme 

onGetAsync yöntemi inciude yöntemiyle ilgili verileri yükler: 

public async Task OnGetAsync() 

{ 

Course = await _context.Courses 
.Include(c => c.Department) 

.AsNoTracking() 

.Tol_istAsync(); 

} 

Select işleci yalnızca gerekli ilgili verileri yükler. Tek öğeler için, Department.Name gibi bir SQL İç BİRLEŞİMİ 
kullanır. Koleksiyonlar için, başka bir veritabanı erişimi kullanır, ancak koleksiyonlar üzerinde inciude işleci olu 

Aşağıdaki kod select yöntemiyle ilgili verileri yükler: 

public IList<CourseViewModel> CourseVM { get; set; } 

public async Task OnGetAsync() 

{ 

CourseVM = await _context.Courses 

.Select(p => new CourseViewModel 
{ 

CourselD = p.CourselD, 

Title = p.Title., 

Credits = p.Credits, 

DepartmentName = p.Department.Name 
}).ToListAsync(); 


CourseViewModel : 













public class CourseViewModel 
{ 

public int CourselD { get; set; } 
public string Title { get; set; } 
public int Credits { get; set; } 
public stning DepartmentName { get; set; } 

} 


Tüm örnek için bkz. ındexselect. cshtml ve lndexSelect.cshtml.cs . 

Kurslar ve kayıtları gösteren bir eğitmenler sayfası oluşturun 

Bu bölümde, Eğitmenler sayfası oluşturulur. 





□ 

X 

Instructors - Contoso L X 



<r ^ O 
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Contoso University 

— 

- 


Instructors 


Create New 



First 

Hire 




Last Name 

Name 

Date 

Office 

Courses 


Abercrombie 

Kim 

1995-03- 


2021 Composition 

Select | Edit | Details | 



11 


2042 Literatüre 

Delete 

Fakhouri 

Fadi 

2002-07- 

Smith 17 

1045 Calculus 

Select | Edit | Details | 



06 



Delete 

Harui 

Roger 

1998-07- 

Gowan 27 

1050 Chemistry 

1 1 1 Edit I Details I 



01 


3141 Trigonometry 


Kapoor 

Candace 

2001-01- 

Thompson 

1050 Chemistry 

Select | Edit | Details | 



15 

304 


Delete 

Zheng 

Roger 

2004-02- 


4022 

Select | Edit | Details | 



12 


Microeconomics 

Delete 


4041 

Macroeconomics 


Courses Taught by Selected Instructor 



Number 

Title 

Department 

Select 

1050 

Chemistry 

Engineering 

Select 

3141 

Trigonometry 

Mathematics 


Students Enrolled in Selected Course 


Name 

Grade 

Alexander, Carson 

A 

Anand, Arturo 

No grade 

Barzdukas, Gytis 

B 
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Bu sayfa aşağıdaki yollarla ilgili verileri okur ve görüntüler: 

• Eğitmenler listesi officeAssignment varlığındaki ilgili verileri (önceki görüntüde Office) görüntüler, 
ve OfficeAssignment varlıkları bire sıfır veya-bir ilişkidir. OfficeAssignment varlıkları için Eager yükl 
kullanılır. Eager yüklemesi, ilgili verilerin görüntülenmesi gerektiğinde genellikle daha etkilidir. Bu durumda, 
Eğitmenler için Office atamaları görüntülenir. 

• Kullanıcı bir eğitmen (önceki görüntüde Haruı) seçtiğinde ilgili course varlıkları görüntülenir. ınstructor ve 

course varlıkları çoktan çoğa bir ilişkidir. Eager yüklemesi, course varlıkları ve ilgili Department varlıkları için 


Instructor 

emesi 


























kullanılır. Bu durumda, yalnızca seçili eğitmen için kurslar gerektiğinden ayrı sorgular daha verimli olabilir.Bu 
örnek, gezinti özelliklerinde olan varlıklarda gezinti özellikleri için Eager yükleme 'nin nasıl kullanılacağını 
gösterir. 


• Kullanıcı bir kurs seçtiğinde (önceki görüntüde kimsiz deneme), 

Enrollments 

varlığındaki ilgili veriler 

görüntülenir. Önceki görüntüde öğrenci adı ve sınıf görüntülenir. 

Course 

ve 

Enrollment 

varlıkları bire çok 


ilişkidir. 

Eğitmen dizini görünümü için bir görünüm modeli oluşturun 

Eğitmenler sayfasında, üç farklı tablodan alınan veriler gösterilir. Üç tabloyu temsil eden üç varlığı içeren bir 
görünüm modeli oluşturulur. 

SchoolVievvModels klasöründe, aşağıdaki kodla lnstructorlndexData.cs oluşturun: 

using System; 

using System.Collections.Generic; 

using System.Linq; 

using System.Threading.Tasks; 

namespace ContosoUniversity.Models.SchoolViewModels 
{ 

public class InstructorIndexData 
{ 

public IEnumerable<Instructor> Instructors { get; set; } 
public IEnumerable<Course> Courses { get; set; } 
public IEnumerable<Enrollment> Enrollments { get; set; } 

} 

} 

Eğitmen modelini scafkatlama 

• Visual Studio 

• Visual Studio Code 

Bölümündeki yönergeleri Öğrenci modeli iskelesini ve instructor model sınıfı için. 

Önceki komut iskelesini kurar instructor modeli. Uygulamayı çalıştırın ve eğitmenler sayfasına gidin. 
Pages/eğitmenler/lndex. cshtml. cs öğesini şu kodla değiştirin: 










using ContosoUniversity.Models; 

using ContosoUniversity.Models.SchoolViewModels; // Add VM 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using Microsoft.EntityFrameworkCore; 

using System.Linq; 

using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Instructors 

{ 

public class IndexModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public IndexModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

public InstructorIndexData Instructor { get; set; } 
public int InstructorlD { get; set; } 

public async Task OnGetAsync(int? id) 

{ 

Instructor = new InstructorIndexData(); 

Instructor.Instructors = await _context.Instructors 
.Include(i = > i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.AsNoTracking() 

.OrderBy(i = > i.LastName) 

.ToListAsync(); 

if (id != null) 

{ 

InstructorlD = id.Value; 

} 

} 

} 

} 


onGetAsync yöntemi, seçilen eğitmenin KİMLİĞİ için isteğe bağlı rota verilerini kabul eder. 
Pages/eğitmenler/lndex. cshtml. cs dosyasındaki sorguyu inceleyin: 

Instructor.Instructors = await _context.Instructors 
.Include(i => İ.OfficeAssignment) 

.Include(i => İ.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.AsNoTracking() 

.OrderBy(i => i.LastName) 

.ToListAsync(); 


Sorgunun iki içerme vardır: 

• officeAssignment : eğitmenler görünümündegörüntülenir. 

• courseAssignments : kurslar taöğretme. 

Eğitmenler Dizin sayfasını Güncelleştir 

Sayfaları/eğitmenler/lndex. cshtml 'yi şu biçimlendirmeyle güncelleştirin: 








Şpage "{id:int?}" 

Şmodel ContosoUniversity.Pages.Instructors.IndexModel 

@{ 

ViewData["Title"] = "Instructors"; 

} 

<h2>Instructors</h2> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

ctable class="table"> 

<thead> 

<tr> 

<th>Last Name</th> 

<th>First Name</th> 

<th>Hire Date</th> 

<th>Office</th> 

<th>Courses</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

Şforeach (var item in Model.Instructor.Instructors) 

{ 

string selectedRow = 

if (item.ID == Model.InstructorlD) 

{ 

selectedRow = "success"; 

} 

<tr class="@selectedRow"> 

<td> 

@Html.DisplayFor(modelItem => item.LastName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.FirstMidName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.HireDate) 

</td> 

<td> 

Şif (item.OfficeAssignment != null) 

{ 

Şitem.OfficeAssignment.Location 

} 

</td> 

<td> 

foreach (var course in item.CourseAssignments) 

{ 

Şcourse.Course.CourselD Şcourse.Course.Title <br /> 

} 

} 

</td> 

<td> 

<a asp-page="./Index" asp-route-id="@item.ID">Select</a> | 

<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID">Details</a> | 

<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 



Önceki biçimlendirme, aşağıdaki değişiklikleri yapar: 


• Güncelleştirmeleri page gelen yönerge @page için @page "{id:int?}" . "{id:int?}" bir rota şablonudur. Yol 
şablonu, verileri yönlendirmek için URL 'deki tamsayı Sorgu dizelerini değiştirir. Örneğin, yalnızca @page 
yönergesine sahip bir eğitmenin Select bağlantısına tıkladığınızda aşağıdakiler gibi bir URL üretilir: 

http://localhost:1234/Instructons?id=2 

Sayfa yönergesi @page "{id:int?}" olduğunda, önceki URL şu şekilde olur: 
http://localhost:1234/Instructons/2 

• Sayfa başlığı eğitmenler' dir. 

• Yalnızca item.officeAssignment null olmaması durumunda ıtem.officeAssignment.Location görüntüleyen bir 
Office sütunu eklendi. Bu bire sıfır veya-bir ilişki olduğundan ilgili bir OfficeAssignment varlığı 
bulunmayabilir. 

@if (İtem.officeAssignment != null) 

{ 

@item.OfficeAssignment.Location 

} 

• Her bir eğitmen tarafından taders kurslarını görüntüleyen bir Kurslar sütunu eklendi. Bu Razor sözdizimi 
hakkında daha fazla bilgi için bkz. açık hat geçişi . 

• Seçilen eğitmenin tr öğesine dinamik olarak ciass="success" ekleyen kod eklendi. Bu, bir önyükleme sınıfı 
kullanarak seçili satır için bir arka plan rengi ayarlar. 

string selectedRow = 
if (item.CourselD == Model.CourselD) 

{ 

selectedRow = "success"; 

} 

<tr class="@selectedRow"> 


Selectetiketli yeni bir köprü eklendi. Bu bağlantı, seçilen eğitmenin KİMLİĞİNİ 
ve bir arka plan rengi ayarlar. 

Index 

yöntemine gönderir 

<a asp-action="Index" asp-route-id="@item.ID">Select</a> | 


Uygulamayı çalıştırın ve eğitmenler sekmesini seçin. Sayfada ilgili OfficeAssignment varlığındaki Location 
(Office) görüntülenir. Eğer OfficeAssignment' null ise boş bir tablo hücresi görüntülenir. 

Seç bağlantısına tıklayın. Satır stili değişir. 

Seçili eğitmen 'e göre kurslar ekleyin 

Pages/eğitmenler/lndex. cshtml. cs dosyasındaki onGetAsync yöntemini aşağıdaki kodla güncelleştirin: 



















public async Task OnGetAsync(int? id, int? courselD) 

{ 

Instructor = new InstructorIndexData(); 
instructor.Instructors = await _context.Instructors 
.Include(i = > i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Department) 

.AsNoTracking() 

.OrderBy(i => i.LastName) 

.ToListAsync(); 

if (id != null) 

{ 

InstructorlD = id.Value; 

Instructor instructor = instructor.Instructors.Where( 
i => i.ID == id.Value).Single(); 
instructor.Courses = instructor.CourseAssignments.Select(s => 


if (courselD != null) 

{ 

CourselD = courselD.Value; 

instructor.Enrollments = instructor.Courses.Where( 

x => x.CourselD == courselD).Single().Enrollments; 

} 

} 


s.Course) 


public int CourselD { get; set; } Ekle 


public class IndexModel : PageModel 

{ 

private readonly Contosollniversity.Data.SchoolContext _context; 

public IndexModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

public InstructorIndexData instructor { get; set; } 
public int InstructorlD { get; set; } 
public int CourselD { get; set; } 

public async Task OnGetAsync(int? id, int? courselD) 

{ 

Instructor = new InstructorIndexData(); 

Instructor.Instructors = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i = > i.Course) 

.Thenlnclude(i => i.Department) 

.AsNoTracking() 

.OrderBy(i = > i.LastName) 

.ToListAsync(); 

if (id != null) 

{ 

InstructorlD = id.Value; 

Instructor instructor = instructor.Instructors.Where( 
i => i.ID == id.Value).Single(); 

instructor.Courses = instructor.CourseAssignments.Select(s => s.Course); 

} 

if (courselD != null) 

{ 

CourselD = courselD.Value; 

instructor.Enrollments = instructor.Courses.Where( 

x => x.CourselD == courselD).Single().Enrollments; 

} 

} 


Güncelleştirilmiş sorguyu inceleyin: 

Instructor.Instructors = await _context.Instructors 
.Include(i => İ.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Department) 

.AsNoTracking() 

.OrderBy(i => i.LastName) 

.ToListAsync(); 

Yukarıdaki sorgu Department varlıklarını ekler. 

Aşağıdaki kod, bir eğitmen seçildiğinde ( id != null ) yürütülür.Seçilen eğitmen, görünüm modelindeki eğitmenler 
listesinden alınır. Görünüm modelinin courses özelliği, bu eğitmenin courseAssignments gezinti özelliğinden 


Course varlıklarla birlikte yüklenir. 











if (id != null) 

{ 

InstructorlD = id.Value; 

Instructor instructor = instructor.Instructors.Where( 
i => i.ID == id.Value).Single(); 

Instructor.Courses = instructor.CourseAssignments.Select(s => s.Course); 

} 


Where 

yöntemi bir koleksiyon döndürür. Önceki 

Where 

yönteminde yalnızca tek bir ınstructor varlığı döndürülür. 

Single 

yöntemi, koleksiyonu tek bir Instructor 

varlığına dönüştürür. Instructor varlığı CourseAssignments 

özelliğine erişim sağlar. courseAssignments ilgili 

Course 

varlıklarına erişim sağlar. 
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Koleksiyonda yalnızca bir öğe olduğunda single yöntemi bir koleksiyonda kullanılır. Koleksiyon boşsa veya birden 
fazla öğe varsa single yöntemi bir özel durum oluşturur. Bir alternatif, koleksiyon boşsa varsayılan bir değer (Bu 
durumda null) döndüren singleOrDefault . Boş bir koleksiyonda singleOrDefault kullanma: 

• Bir özel durumla sonuçlanır (null başvuru üzerinde courses özelliği bulmaya çalışırken). 

• Özel durum iletisi sorunun nedenini daha az gösterir. 

Aşağıdaki kod, bir kurs seçildiğinde görünüm modelinin Enroiiments özelliğini doldurur: 

if (courselD != null) 

{ 

CounselD = courselD.Value; 

Instructor.Ennollments = Instructor.Courses.Where( 

x => x.CourselD == courselD).Single().Enrollments; 

} 

Pages/eğitmenler/tndex. cshtml Razor sayfasının sonuna aşağıdaki biçimlendirmeyi ekleyin: 
































<a asp-page="./Delete" asp-route-id="Şitem.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 

Şif (Model.Instructor.Courses != null) 

{ 

<h3>Courses Taught by Selected Instructor</h3> 

<table class="table"> 

<tr> 

<thx/th> 

<th>Number</th> 

<th>Title</th> 

<th>Department</th> 

</tr> 

Şforeach (var item in Model.Instructor.Courses) 

{ 

string selectedRow = ""; 
if (item.CourselD == Model.CourselD) 

{ 

selectedRow = "success"; 

} 

<tr class="ŞselectedRow"> 

<td> 

<a asp-page="./Index" asp-route-courseID="@item.CourselD">Select</a> 
</td> 

<td> 

Şitem.CourselD 
</td> 

<td> 

Şitem.Title 
</td> 

<td> 

Şitem.Department.Name 
</td> 

</tr> 

} 

</table> 

} 


Yukarıdaki biçimlendirme, bir eğitmen seçildiğinde bir eğitmenin ilgili kursların bir listesini görüntüler. 
Uygulamayı test edin. Eğitmenler sayfasında bir seçme bağlantısına tıklayın. 

Öğrenci verilerini göster 

Bu bölümde, uygulama seçili bir kurs için öğrenci verilerini gösterecek şekilde güncelleştirilir. 

Pages/eğitmenler/lndex. cshtml. cs içindeki onGetAsync yönteminde bulunan sorguyu aşağıdaki kodla 
güncelleştirin: 




Instructor.Instructors = await _context.Instructors 
.Include(i = > i.OfficeAssignment) 

.Include(i = > i.CourseAssignments) 
.Thenlnclude(i = > i.Course) 

.Thenlnclude(i => i.Department) 
.Include(i => i.CourseAssignments) 
.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Enrollments) 
.Thenlnclude(i => i.Student) 

.AsNoTracking() 

.OrderBy(i => i.LastName) 

.ToListAsync(); 


Güncelleştirme sayfaları/eğltmenler/lndex. cshtml. Aşağıdaki biçimlendirmeyi dosyanın sonuna ekleyin: 


@if (Model.Instructor.Enrollments != null) 

{ 

<h3> 

Students Enrolled in Selected Course 
</h3> 

ctable class="table"> 

<tr> 

<th>Name</th> 

<th>Grade</th> 

</tr> 

@foreach (var item in Model.Instructor.Enrollments) 

{ 

<tr> 

<td> 

@item.Student.FullName 
</td> 

<td> 

@Html.DisplayFor(modelItem => item.Grade) 
</td> 

</tr> 

} 

</table> 


Yukarıdaki biçimlendirme, seçili kursa kayıtlı öğrencilerin bir listesini görüntüler. 

Sayfayı yenileyin ve bir eğitmen seçin. Kayıtlı öğrenciler ve bunların onların listesini görmek için bir kurs seçin. 
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single yöntemi, where yöntemini ayrı çağırmak yerine where koşulunu geçirebilir: 


















public async Task OnGetAsync(int? id, int? courselD) 

{ 

Instructor = new InstructorIndexData(); 

instructor.Instructors = await _context.Instructors 
.Include(i = > i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i = > i.Department) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i = > i.Course) 

.Thenlnclude(i => i.Enrollments) 

.Thenlnclude(i => i.Student) 

.AsNoTracking() 

.OrderBy(i => i.LastName) 

.ToListAsync(); 

if (id != null) 

{ 

InstructorlD = id.Value; 

Instructor instructor = Instructor.Instructors.Single( 
i => i.ID == id.Value); 

instructor.Courses = instructor.CourseAssignments.Select( 
s => s.Course); 

} 

if (courselD != null) 

{ 

CourselD = courselD.Value; 

instructor.Enrollments = instructor.Courses.Single( 
x => x.CourselD == courselD).Enrollments; 

} 

} 

Yukarıdaki single yaklaşım, where kullanmaktan faydalanır. Bazı geliştiriciler single yaklaşım stilini tercih eder. 

Açık yükleme 

Geçerli kod Enrollments ve students için Eager yüklemeyi belirtir: 

Instructor.Instructors = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Department) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Enrollments) 

.Thenlnclude(i => i.Student) 

.AsNoTracking() 

.OrderBy(i => i.LastName) 

.ToListAsync(); 


Kullanıcıların bir kursa kayıtları nadiren görmek istediğini varsayalım. Bu durumda, bir iyileştirme yalnızca 
isteniyorsa kayıt verilerini yüklemek olacaktır. Bu bölümde onGetAsync , Enrollments ve students açık yüklemesini 
kullanacak şekilde güncelleştirilir. 


OnGetAsync aşağıdaki kodla güncelleştirin: 










public async Task OnGetAsync(int? id, int? courselD) 

{ 

Instructor = new InstructorIndexData(); 
instructor.Instructors = await _context.Instructors 
.Include(i = > i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 
.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Department) 
//.Include(i = > i.CourseAssignments) 

// .Thenlnclude(i => i.Course) 

// .Thenlnclude(i => i.Enrollments) 

// .Thenlnclude(i = > i.Student) 

// .AsNoTracking() 

.OrderBy(i = > i.LastName) 

.ToListAsync(); 


if (id != null) 

{ 

InstructorlD = id.Value; 

Instructor instructor = Instructor.Instructors.Where( 
i => i.ID == id.Value).Single(); 

instructor.Courses = instructor.CourseAssignments.Select(s => s.Course); 


if (courselD != null) 

{ 

CourselD = courselD.Value; 

var selectedCourse = instructor.Courses.Where(x => x.CourselD == courselD).Single(); 
await _context. Entry(selectedCourse).Collection(x => x.Enrollments).LoadAsync(); 
foreach (Enrollment enrollment in selectedCourse.Enrollments) 

{ 

await _context.Entry(enrollment).Reference(x => x.Student).LoadAsync(); 

} 

instructor.Enrollments = selectedCourse.Enrollments; 

} 


Yukarıdaki kod, kayıt ve öğrenci verileri için Thenmclude Yöntem çağrılarını bırakır. Bir kurs seçilirse vurgulanan kod 
şunu alır: 

• Seçili kurs için Enrollment varlıkları. 

• Her bir Enrollment için student varlıkları. 

Yukarıdaki kod açıklamalarının .AsNoTrackingO dikkat edin. Gezinti özellikleri yalnızca izlenen varlıklar için açık bir 
şekilde yüklenebilir. 

Uygulamayı test edin. Bir kullanıcının perspektifinden, uygulama önceki sürümle aynı şekilde davranır. 

Sonraki öğreticide ilgili verileri güncelleştirme gösterilmektedir. 

Ek kaynaklar 

• Bu öğreticinin YouTube sürümü (parti) 

• Bu öğreticinin YouTube sürümü (part2) 


ÖNCEKİ 


İLERİ 










ASRNET Core ile EF Core Razor Pages-llgili verileri 
güncelleştirme-7/8 

20.08.2019 • 43 minutes to read ı Edit Online 


, Tom Dykstrave Rick Anderson 

Contoso Üniversitesi web uygulaması, EF Core ve Visual Studio kullanarak Razor Pages Web uygulamaları 
oluşturmayı gösterir. Öğretici serisi hakkında daha fazla bilgi için ilk öğreticiyebakın. 

Çözemediğiniz sorunlarla karşılaşırsanız, Tamamlanmış uygulamayı indirin ve öğreticiyi izleyerek bu kodu 
oluşturduğunuz şekilde karşılaştırın. 

Bu öğreticide ilgili verileri güncelleştirme gösterilmektedir. Aşağıdaki çizimler tamamlanan sayfalardan bazılarını 
göstermektedir. 
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Kurs oluşturma ve düzenleme sayfalarını güncelleştirme 

Kurs oluşturma ve düzenleme sayfaları için yapı iskelesi kodu, departman KİMLİĞİ (tamsayı) gösteren bir 
departman açılan listesi içerir. Açılan listede bölüm adı gösterilmeli, bu nedenle her iki sayfanın da bir departman 
adları listesi olması gerekir. Bu listeyi sağlamak için, oluşturma ve düzenleme sayfaları için bir temel sınıf kullanın. 

Kurs oluşturma ve düzenleme için bir temel sınıf oluşturun 

Aşağıdaki kodla bir Pages/kurslar/DepartmentNamePageModel. cs dosyası oluşturun: 




using ContosoUniversity.Data; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.AspNetCore.Mvc. Rendering; 
using Microsoft.EntityFrameworkCore; 
using System.Linq; 

namespace ContosoUniversity.Pages.Courses 

{ 

public class DepartmentNamePageModel : PageModel 

{ 

public SelectList DepartmentNameSL { get; set; } 

public void PopulateDepartmentsDropDownList(SchoolContext _contextj 
object selectedDepartment = null) 

{ 

var departmentsQuery = from d in _context.Departments 
orderby d.Name // Şort by name, 
select d; 


} 


} 


} 


DepartmentNameSL = new SelectList(departmentsQuery.AsNoTracking(), 
"DepartmentlD ", "Name"., selectedDepartment); 


Yukarıdaki kod, bölüm adlarının listesini içeren bir SelectList oluşturur. Belirtilmişse, bu departman SelectList 
Öğesinde seçilir. selectedDepartment 


Oluşturma ve düzenleme sayfa modeli sınıfları öğesinden DepartmentNamePageModel türetilir. 


Kursu güncelleştirme sayfa modeli oluşturma 

Bir kurs bir departmana atanır. Oluşturma ve düzenleme sayfaları için temel sınıf, departmanı seçmek için 


SelectList 

bir sağlar. Yabancı anahtar (FK) özelliğini kullanan 

SelectList 

açılan liste. 

Course.DepartmentlD 


Core, course.DepartmentlD Department gezinti özelliğini yüklemek için FK kullanır. 










Contoso University 
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Title 

Credits 


Department 


-- Select Department -- 
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-- Select Department — 


Economics 
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Mathematics 


Sayfaları/kurslan/oluşturma. cshtml. cs dosyasını şu kodla güncelleştirin: 











using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc; 
using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Courses 

{ 

public class CreateModel : DepartmentNamePageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public CreateModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

public IActionResult OnGet() 

{ 

PopulateDepartmentsDropDownList(_context); 
return Page(); 

} 

[BindProperty] 

public Course Course { get; set; } 

public async Task<IActionResult> OnPostAsync() 

{ 

var emptyCourse = new Course(); 

if (await TryUpdateModelAsync<Course>( 
emptyCourse, 

"course", // Prefix for form value. 

s => s.CourselD, s => s.DepartmentlD, s => s.Title, s => s.Credits)) 

{ 

_context.Courses.Add(emptyCourse); 
await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

// Select DepartmentlD if TryUpdateModelAsync fails. 
PopulateDepartmentsDropDownl_ist(_context, emptyCourse.DepartmentlD); 
return Page(); 

} 

} 

} 


Yukarıdaki kod: 

• Türetiliyor DepartmentNamePageModel . 

• TryUpdateModelAsync Aşırı nakletmeyıengellemek için kullanır. 

• Kaldırır viewData["DepartmentlD"] . DepartmentNameSL temel sınıftan türü kesin belirlenmiş bir modeldir ve Razor 
sayfası tarafından kullanılır. Kesin olarak belirlenmiş modeller, kesin olarak yazılan zayıf bir şekilde tercih edilir. 
Daha fazla bilgi için bkz. zayıf yazılmış veriler (VievvData ve VievvBag). 

Kursu güncelleştirme Razor oluşturma sayfası 

Sayfalan/kursian/Create. cshtml 'yi aşağıdaki kodla güncelleştirin: 






@page 

@model ContosoUniversity.Pages.Courses.CreateModel 

@{ 

ViewData["Title"] = "Create Course"; 

} 

<h2>Create</h2> 

<h4>Course</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<fonm method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<div class="form-group"> 

dabel asp-for="Course.CourseID" class="contnol-label"x/label> 

<input asp-for'="Counse.CourseID" class="form-control" /> 

<span asp-validation-for="Course.CourselD" class="text-danger"x/span> 
</div> 

<div class="form-group"> 

<label asp-for="Course.Title" class="contnol-label"x/label> 

<input asp-for'="Counse.Title" class="form-control" /> 

<span asp-validation-for="Course.Title" class="text-danger"x/span> 
</div> 

<div class="form-group"> 

<label asp-for="Course.Credits" class="control-label"x/label> 

<input asp-for="Course.Credits" class="form-control" /> 

<span asp-validation-for="Course.Credits" class="text-danger"x/span> 
</div> 

<div class="form-group"> 

<label asp-fon="Counse.Department" class="contnol-label"x/label> 
<select asp-for="Counse.DepartmentID" class="form-control" 
asp-items="@Model.DepartmentNameSL"> 

<option value="">-- Select Department --</option> 

</select> 

<span asp-validation-for="Course.DepartmentID" class="text-danger" /> 
</div> 

<div class="form-group"> 

<input type="submit" value="Create" class="btn btn-primary" /> 

</div> 

</form> 

</div> 

</div> 

<div> 

<a asp-page="Index">Back to List</a> 

</div> 

@section Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 


Yukarıdaki kod aşağıdaki değişiklikleri yapar: 

• DepartmentlD etiketini departmanadönüştürür. 

• "ViewBag.DepartmentlD" ile DepartmentNameSL değiştirir (taban sınıfından). 

• "Departmanı Seç" seçeneğini ekler. Bu değişiklik, ilk departman yerine henüz bir departman seçilmedikçe açılan 
kutuda "departmanı Seç" i işler. 

• Departman seçili olmadığında bir doğrulama iletisi ekler. 

Razor sayfası seçme etiketi yardımcısınıkullanır: 




<div class="form-group"> 

<label asp-for="Course.Department" class="control-label"x/label> 
<select asp-for="Course.DepartmentID" class="form-control" 
asp-items="@Model.DepartmentNameSL"> 

<option value="">-- Select Department --</option> 

</select> 

<span asp-validation-for="Course.DepartmentID" class="text-danger" /> 
</div> 


Oluştur sayfasını test edin. Oluştur sayfası departman KİMLİĞİ yerine departman adını görüntüler. 

Kurs düzenleme sayfası modelini güncelleştirme 

Pages/kurslar/Edit. cshtml. cs dosyasını aşağıdaki kodla güncelleştirin: 

using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc; 
using Microsoft.EntityFrameworkCore; 
using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Courses 

{ 

public class EditModel : DepartmentNamePageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public EditModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Course Course { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Course = await _context.Courses 

.Include(c => c.Department).FirstOrDefaultAsync(m => m.CourselD == id); 

if (Course == null) 

{ 

return NotFound(); 

} 

// Select current DepartmentID. 

PopulateDepartmentsDropDownList(_context , Course.DepartmentID); 
return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var courseToUpdate = await _context.Courses.FindAsync(id); 

if (courseToUpdate == null) 

{ 


return NotFound(); 






i 


if (await TryUpdateModelAsync<Course>( 
courseToUpdate, 

"course", // Prefix for form value. 

c => c.Credits, c => c.DepartmentlD, c => c.Title)) 

{ 

await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

// Select DepartmentlD if TryllpdateModelAsync fails. 

PopulateDepartmentsDropDownList(_context , courseToUpdate.DepartmentlD); 
return Page(); 

} 

} 

} 

Değişiklikler, oluşturma sayfası modelinde yapılanlarla benzerdir. Yukarıdaki kodda, 
PopuiateDepartmentsDropDownList bu departmanı açılan listede seçen departman kimliği' nde geçiril 

Kurs düzenleme Razor sayfasını güncelleştirme 

Pages/kurslar/Edit. cshtml dosyasını aşağıdaki kodla güncelleştirin: 



@page 

@model ContosoUniversity.Pages.Courses.EditModel 

@{ 

ViewData["Title"] = "Edit"; 

} 

<h2>Edit</h2> 

<h4>Course</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form m8thod="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<input type="hidden" asp-for="Course.CourseID" /> 

<div class="form-group"> 

<label asp-for="Course.CourseID" class="contnol-label"x/label> 
<div>@Html.DisplayFor(model => model.Course.CourseID)</div> 

</div> 

<div class="form-group"> 

<label asp-for="Course.Title" class="control-label"x/label> 

<input asp-for="Course.Title" class="form-control" /> 

<span asp-validation-for="Course.Title" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Course.Credits" class="control-label"x/label> 
cinput asp-for="Course.Credits" class="form-control" /> 

<span asp-validation-for="Course.Credits" class="text-danger"x/span> 
</div> 

<div class="form-group"> 

clabel asp-for="Course.Department" class="control-label"x/label> 

<select asp-for="Course.DepartmentID" class="form-control" 
asp-items="@Model.Departmentl\lameSL"x/select> 

<span asp-validation-for="Course.DepartmentID" class="text-danger"x/span> 
</div> 

<div class="form-group"> 

<input type="submit" value="Save" class="btn btn-primary" /> 

</div> 

</form> 

</div> 

</div> 

<div> 

<a asp-page="./Index">Back to List</a> 

</div> 

@section Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 


Yukarıdaki kod aşağıdaki değişiklikleri yapar: 

• Kurs KİMLİĞİNİ görüntüler.Genellikle bir varlığın birincil anahtarı (PK) gösterilmez. PKs 'ler genellikle 
kullanıcılara daha az anlamlı olur. Bu durumda, PK kurs numarasıdır. 

• Bölüm açılan başlığını DepartmentlD 1 dan departmanadönüştürür. 

• "ViewBag.DepartmentlD" ile DepartmentNameSL değiştirir (taban sınıfından). 


Sayfa, kurs numarası için gizli bir -cinput type="hidden"> 

alan () içerir. 

<label> 

Etiket 

asp-for="Course.CourseID" 

Yardımcısı ekleme, gizli alan gereksinimini ortadan kaldırmaz. 

cinput 

: type="hidden"> 

Kullanıcı Kaydet' e 


tıkladığında, gönderilen veriler için kurs numarasının dahil olması gerekir. 


Kurs ayrıntılarını güncelleştirme ve sayfaları silme 








Anotracking , izleme gerekli olmadığında performansı iyileştirebilir. 

Kurs sayfası modellerini güncelleştirme 

Sayfa/kurslar/delete. cshtml. cs öğesini aşağıdaki kodla AsNoTracking güncelleştirin: 

using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.EntityFrameworkCore; 
using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Courses 

{ 

public class DeleteModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public DeleteModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Course Course { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Course = await _context.Courses 
.AsNoTracking() 

.Include(c => c.Department) 

.FirstOrDefaultAsync(m => m.CourselD == id); 

if (Course == null) 

{ 

return NotFound(); 

} 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Course = await _context.Courses.FindAsync(id); 

if (Course != null) 

{ 

_context.Courses.Remove(Course); 
await _context.SaveChangesAsync(); 

} 

return RedirectToPage("./Index"); 

} 

} 

} 


Sayfalar/kurslar/details. cshtml. cs dosyasında aynı değişikliği yapın: 




using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.EntityFrameworkCore; 
using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Courses 

{ 

public class DetailsModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public DetailsModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

public Course Course { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Course = await _context.Courses 
.AsNoTracking() 

.Include(c => c.Department) 

.FirstOrDefaultAsync(m => m.CourselD == id); 

if (Course == null) 

{ 

return NotFound(); 

} 

return Page(); 

} 

} 

} 


Kurs Razor sayfalarını güncelleştirme 

Pages/kurslar/delete. cshtml dosyasını aşağıdaki kodla güncelleştirin: 






@page 

@model ContosoUniversity.Pages.Courses.DeleteModel 

@{ 

ViewData["Title"] = "Delete"; 

} 

<h2>Delete</h2> 

<h3>Are you sure you want to delete this?</h3> 

<div> 

<h4>Course</h4> 

<hr /> 

<dl class="row"> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Course.CourselD) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Course.CourselD) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Course.Tltle) 

</dt> 

<dd class="col-sm-10"> 

@Fltml.DisplayFor(model => model.Course.Tltle) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Course.Credits) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Course.Credits) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Course.Department) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Course.Department.Name) 
</dd> 

</dl> 

<form method="post"> 

<input type="hidden" asp-for="Course.CourseID" /> 

<input type="submit" value="Delete" class="btn btn-danger" /> | 
<a asp-page="./Index">Back to List</a> 

</form> 

</div> 


Ayrıntılar sayfasında aynı değişiklikleri yapın. 



@page 

@model ContosoUniversity.Pages.Courses.DetailsModel 

@{ 

ViewData["Title"] = "Details"; 

} 

<h2>Details</h2> 

<div> 

<h4>Course</h4> 

<hr /> 

<dl class="now"> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Course.CourselD) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Course.CourselD) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayMameFor(model => model.Course.Tltle) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Course.Tltle) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Course.Credits) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Course.Credits) 

</dd> 

<dt class="col-sm-2"> 

@Fltml.DisplayNameFor(model => model.Course.Department) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Course.Department.Name) 

</dd> 

</dl> 

</div> 

<div> 

<a asp-page="./Edit" asp-route-id="@Model.Course.CourseID">Edit</a> | 
<a asp-page="./Index">Back to List</a> 

</div> 


Kurs sayfalarını test etme 

Oluşturma, düzenleme, ayrıntıları ve silme sayfalarını test edin. 

Eğitmen oluşturma ve düzenleme sayfalarını güncelleştirme 

Eğitmenler, istediğiniz sayıda kurs öğretebilir. Aşağıdaki görüntüde, bir dizi kurs onay kutusu ile eğitmen düzenleme 
sayfası gösterilmektedir. 



Contoso University 


Edit 

Instructor 

Last Name 
Fakhouri 

First Name 
Fadi 

Fİ i re Date 
07/06/2002 

Office Location 
Smith 17 

^ 1045Calculus D 1050 Chemistry O 2021 Composition 

S 2042 Literatüre B 3141 B 4022 

Trigonometry Microeconomics 

Q 4041 

Macroeconomics 


Save 


Onay kutulan, bir eğitmenin atandığı kurslara değişiklikler sağlar. Veritabanındaki her kurs için bir onay kutusu 
görüntülenir. Eğitmenin atandığı kurslar seçilidir. Kullanıcı kurs atamalarını değiştirmek için onay kutularını seçebilir 
veya temizleyebilir. Kurs sayısı çok büyükse, farklı bir kullanıcı arabirimi daha iyi çalışabilir. Ancak burada gösterilen 
çoktan çoğa ilişkiyi yönetme yöntemi değişmez, ilişki oluşturmak veya silmek için bir JOIN varlığını işlersiniz. 

Atanan kurslar verileri için bir sınıf oluşturma 

Aşağıdaki kodla SchoolVievvModels/AssignedCourseData. cs oluşturun: 

namespace ContosoUniversity.Models.SchoolViewModels 

{ 

public class AssignedCourseData 

{ 

public int CourselD { get; set; } 
public string Title { get; set; } 
public bool Assigned { get; set; } 

} 

} 

Sınıfı AssignedCourseData , bir eğitmene atanan kurslar için onay kutularını oluşturmak üzere verileri içerir. 

Bir eğitmen sayfa modeli temel sınıfı oluşturma 

Pages/eğitmenler/Komutctorcoursespagemodel. cs temel sınıfını oluşturun: 

using ContosoUniversity.Data; 

using ContosoUniversity.Models; 

using ContosoUniversity.Models.SchoolViewModels; 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using System.Collections.Generic; 

using System.Linq; 






namespace ContosoUniversity.Pages.Instructors 

{ 

public class InstructorCoursesPageModel : PageModel 

{ 

public List<AssignedCourseData> AssignedCourseDataList; 

public void PopulateAssignedCourseData(SchoolContext context, 

Instructor instructor) 

{ 

var allCourses = context.Courses; 

var instructorCourses = new HashSet<int>( 

instructor.CourseAssignments.Select(c => c.CourselD)); 
AssignedCourseDataList = new List<AssignedCourseData>(); 
foreach (var course in allCourses) 

{ 

AssignedCourseDataList.Add(new AssignedCourseData 

{ 

CourselD = course.CourselD, 

Title = course.Title, 

Assigned = İnstructorCourses.Contains(course.CourselD) 

}); 

} 


public void UpdateInstructorCourses(SchoolContext context, 
string[] selectedCourses, instructor instructorToüpdate) 

{ 

if (selectedCourses == null) 

{ 

instructorToüpdate.CourseAssignments = new List<CourseAssignment>(); 
return; 

} 

var selectedCoursesHS = new HashSet<string>(selectedCourses); 
var instructorCourses = new HashSet<int> 

(İnstructorToüpdate.CourseAssignments.Select(c => c.Course.CourselD)); 
foreach (var course in context.Courses) 

{ 

if (selectedCoursesHS.Contains(course.CourseID.ToString())) 

{ 

if (!instructorCourses.Contains(course.CourselD)) 

{ 

instructorToüpdate.CourseAssignments.Add( 
new CourseAssignment 
{ 

InstructorlD = instructorToüpdate.İD, 

CourselD = course.CourselD 

}); 

} 

} 

else 

{ 

if (instructorCourses.Contains(course.CourselD)) 

{ 

CourseAssignment courseToRemove 
= instructorToüpdate 
.CourseAssignments 

•SingleOrDefault(i => i.CourselD == course.CourselD); 
context.Remove(courseToRemove); 

} 


, instructorCoursesPageModei Düzenleme ve oluşturma sayfa modelleri için kullanacağınız temel sınıftır. 
PopulateAssignedCourseData'' course doldurmak AssignedCourseDataList için tüm varlıkları okur. Her kurs için kod, 
başlığı ve eğitmenin courseiD kursa atanıp atanmadığını belirler. Bir diyez kümesi etkili aramalar için kullanılır. 

Razor sayfasında bir kurs varlıkları koleksiyonu olmadığından, model Bağlayıcısı CourseAssignments gezinti 
özelliğini otomatik olarak güncelleştiremez. CourseAssignments Gezinti özelliğini güncelleştirmek için model cildi 
kullanmak yerine, bunu yeni updateinstructorCourses yöntemde yapmanız gerekir. Bu nedenle, CourseAssignments 
özelliği model bağlamadan hariç bırakmanız gerekir. Bu, beyaz liste aşırı yüklemesini kullandığınız ve 
TryupdateModei CourseAssignments içerme listesinde olmadığı için çağıran kodda herhangi bir değişiklik 
yapılmasını gerektirmez. 

Hiçbir onay kutusu seçili değilse, içindeki updateinstructorCourses kod CourseAssignments gezinti özelliğini boş bir 
koleksiyonla başlatır ve döndürür: 

if (selectedCourses == null) 

{ 

instructorîoUpdate.CourseAssignments = new List<CourseAssignment>(); 
return; 

} 

Kod daha sonra, veritabanındaki tüm kurslardan geçer ve bu her kursu, sayfada seçili olanlar ile ilgili olarak, 
eğitmene atanmış olanlara karşı denetler. Etkili aramaları kolaylaştırmak için, ikinci iki koleksiyon HashSet 
nesnelerde depolanır. 

Kurs onay kutusu seçilmişse ancak kurs, instructor.CourseAssignments gezinti özelliğinde değilse kurs, Gezinti 
özelliğindeki koleksiyona eklenir. 

if (selectedCoursesHS.Contains(course.CourseiD.ToStringO)) 

{ 

if (!instructorCourses.Contains(course.CourseiD)) 

{ 

instructorToUpdate.CourseAssignments.Add( 
new CourseAssignment 
{ 

InstructorlD = İnstructorîoUpdate.ID, 

CourseiD = course.CourseiD 

}); 

} 

} 

Kurs onay kutusu seçili değilse, ancak kurs instructor.courseAssignments gezinti özelliği ise, kurs, gezinti 
özelliğinden kaldırılır. 

else 

{ 

if (instructorCourses.Contains(course.CourseiD)) 

{ 

CourseAssignment courseToRemove 
= instructorîoUpdate 
.CourseAssignments 

•SingleOrDefault(i => i.CourseiD == course.CourseiD); 
context.Remove(courseToRemove); 

} 

} 

Office konumunu işle 

Düzenleme sayfasının işlemesi gereken başka bir ilişki ise, eğitmen varlığının officeAssignment varlığa sahip 



















olduğu bire sıfır veya-bir ilişkidir. Eğitmen düzenleme kodu aşağıdaki senaryoları işlemelidir: 

• Kullanıcı Office atamasını temizlediğinde officeAssignment varlığı silin. 

• Kullanıcı bir Office ataması girerse ve boşsa, yeni OfficeAssignment bir varlık oluşturun. 

• Kullanıcı Office atamasını değiştirirse OfficeAssignment varlığı güncelleştirin. 

Eğitmen düzenleme sayfası modelini güncelleştirme 

Pages/eğitmenler/Edit. cshtml. cs dosyasını aşağıdaki kodla güncelleştirin: 

using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc; 
using Microsoft.EntityFrameworkCore; 
using System; 

using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Instructors 

{ 

public class EditModel : InstructorCoursesPageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public EditModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Instructor Instructor { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Instructor = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments).Thenlnclude(i => i.Course) 

.AsNoTracking() 

.FirstOrDefaultAsync(m => m.ID == id); 

if (Instructor == null) 

{ 

return NotFound(); 

} 

PopulateAssignedCourseData(_contextj Instructor); 
return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int? id, string[] selectedCourses) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var instructorToUpdate = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i = > i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.FirstOrDefaultAsync(s => s.ID == id); 

if (İnstructorToUpdate == null) 

{ 

return NotFound(); 





} 


if (await TryUpdateModelAsync<Instructor>( 
instructorTolIpdate, 

"Instructor ", 

i => i.FirstMidName, i => i. LastName., 
i => i.HireDate, i => i.OfficeAssignment)) 

{ 

if (String.IsNullOrWhiteSpace( 

instructorToUpdate.OfficeAssignment?.Location)) 

{ 

instructorToUpdate.OfficeAssignment = null; 

} 

UpdateInstructorCourses(_context , selectedCourses, İnstructorToUpdate); 
await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

UpdateInstructorCourses(_context , selectedCourses, İnstructorToUpdate); 
PopulateAssignedCourseData(_context, İnstructorToUpdate); 
return PageQ; 

} 

} 

} 

Yukarıdaki kod: 

• officeAssignment , Instructor ,Ve courseAssignment.course gezinme özellikleri için Eager yükleme kullanarak 
geçerli varlığı veritabanından alır. courseAssignment 

• Alınan Instructor varlığı model Ciltçideki değerlerle güncelleştirir. TryUpdateModei fazla nakletmeyiönler. 

• O'i ce konumu boşsa, null olarak ayarlar Instructor.OfficeAssignment .Null Instructor.OfficeAssignment 
olduğunda, OfficeAssignment tablodaki ilgili satır silinir. 

• Görüntüleme modeli onGetAsync sınıfını kullanarak onay kutuları PopulateAssignedCourseData için bilgi 
sağlamak üzere ' de çağırır. AssignedCourseData 


• Onay updateinstructorCourses kutularından onPostAsync düzenlenmekte olan eğitmen varlığına bilgi 
uygulamak için 1 de çağırır. 



verilerini geri yükler. 

Eğitmen düzenleme Razor sayfasını güncelleştirme 

Pages/eğitmenler/Edit. cshtml dosyasını aşağıdaki kodla güncelleştirin: 

@page 

@model ContosoUniversity.Pages.Instructors.EditModel 

@{ 

ViewData["Title"] = "Edit"; 

} 

<h2>Edit</h2> 

<h4>Instructor</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 
cinput type="hidden" asp-for="Instructor.ID" /> 

<div class="form-group"> 

<label asp-for="Instructor. LastName" class="control-label"x/label> 
cinput asp-for="Instructor.LastName" class="form-control" /> 
cspan asp-validation-for="Instructor. LastName" class="text-danger"x/span> 
</div> 

cdiv class="form-group"> 
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<input asp-for="Instructor.FirstMidName" class="form-control" /> 

<span asp-validation-for="Instructor.FirstMidName" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Instructor.HireDate" class="control-label"x/label> 

<input asp-for="Instructor.HireDate" class="form-control" /> 

<span asp-validation-for="Instructor.FlireDate" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Instructor.OfficeAssignment. Location" class="control-label"x/label> 

<input asp-for="Instructor.OfficeAssignment.Location" class="form-control" /> 

<span asp-validation-for="Instructor.OfficeAssignment.Location" class="text-danger" /> 

</div> 

<div class="form-group"> 

<div class="table"> 

<table> 

<tr> 

int cnt = 0; 

foreach (var course in Model.AssignedCourseDataList) 

{ 

if (cnt++ % 3 == 0) 

{ 

</trxtr> 

} 

<td> 

cinput type="checkbox" 

name="selectedCourses" 
value="@course.CourseiD" 

@(Html.Raw(course.Assigned ? "checked=\"checked\"" : "")) /> 
(Şcourse.CourseiD (Şcourse.Title 

</td> 

} 

@:</tr> 

} 

</table> 

</div> 

</div> 

<div class="form-group"> 

cinput type="submit" value="Save" class="btn btn-primary" /> 

</div> 

</form> 

</div> 

</div> 

<div> 

<a asp-page="./Index">Back to List</a> 

</div> 

@section Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 

Yukarıdaki kod, üç sütun içeren bir HTML tablosu oluşturur. Her sütunda, kurs numarasını ve başlığını içeren bir 
CheckBox ve bir açıklamalı alt yazı vardır. Onay kutularının hepsi aynı ada ("Selectedkurslar") sahiptir. Aynı adı 
kullanmak model cildi bir grup olarak kabul etmek üzere bilgilendirir. Her onay kutusunun değer özniteliği olarak 
courseiD ayarlanır. Sayfa gönderildiğinde, model Ciltçi yalnızca seçili onay kutularının courseiD değerlerinden 
oluşan bir dizi geçirir. 

Onay kutuları başlangıçta işlendiğinde, eğitmen 'e atanan kurslar seçilir. 

Not: Eğitim kursu verilerini düzenlemek için buradaki yaklaşım, sınırlı sayıda kurs olduğunda iyi bir şekilde 
gerçekleştirilir. Çok daha büyük olan koleksiyonlar için, farklı bir kullanıcı arabirimi ve farklı bir güncelleştirme 
yöntemi daha erişilebilir ve verimli olacaktır. 




Uygulamayı çalıştırın ve güncelleştirilmiş eğitmenler düzenleme sayfasını test edin. Bazı kurs atamalarını değiştirin. 
Değişiklikler Dizin sayfasında yansıtılır. 

Eğitmen oluştur sayfasını güncelleştirme 

, Düzenleme sayfasına benzer kodla, bir sayfa modeli ve Razor sayfası oluşturma adlı eğitmeni güncelleştirin: 



using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Instructors 

{ 

public class CreateModel : InstructorCoursesPageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public CreateModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

public IActionResult OnGet() 

{ 

var instructor = new Instructor(); 

instructor.CourseAssignments = new List<CourseAssignment>(); 

// Provides an empty collection for the foreach loop 
// foreach (var course in Model.AssignedCourseDataList) 

// in the Create Razor page. 

PopulateAssignedCourseData(_context, instructor); 
return Page(); 

} 

[BindProperty] 

public instructor instructor { get; set; } 

public async Task<IActionResult> OnPostAsync(string[] selectedCourses) 

{ 

var newInstructor = new Instructor(); 
if (selectedCourses != null) 

{ 

newInstructor.CourseAssignments = new List<CourseAssignment>(); 
foreach (var course in selectedCourses) 

{ 

var courseToAdd = new CourseAssignment 

{ 

CourselD = int.Parse(course) 

}; 

newInstructor.CourseAssignments.Add(courseToAdd); 

} 

} 

if (await TryUpdateModelAsync<Instructor>( 
newInstructor, 

"instructor ", 

i => i. FirstMidName, i => i.LastName., 
i => i.HireDate, i => i.OfficeAssignment)) 

{ 

_context.Instructors.Add(newInstructor); 
await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

PopulateAssignedCourseData(_context 3 newInstructor); 
return Page(); 

} 

} 

} 


@page 

@model ContosoUniversity.Pages.Instructors.CreateModel 






@{ 

ViewData["Title"] = "Create"; 

} 

<h2>Create</h2> 

<h4>Instructor</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<div class="form-group"> 

clabel asp-for="Instructor. LastName" class="control-label"x/label> 

<input asp-for="Instructor.LastName" class="form-control" /> 

<span asp-validation-for="Instructor. LastName" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Instructor. FirstMidName" class="control-label"x/label> 

<input asp-for="Instructor.FirstMidName" class="form-control" /> 

<span asp-validation-for="Instructor. FirstMidName" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Instructor. HireDate" class="control-label"x/label> 

<input asp-for="Instructor.HireDate" class="form-control" /> 

<span asp-validation-for="Instructor.HireDate" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Instructor.OfficeAssignment.Location" class="control-label"x/label> 

<input asp-for="Instructor.OfficeAssignment.Location" class="form-control" /> 

<span asp-validation-for="Instructor.OfficeAssignment.Location" class="text-danger" /> 
</div> 

<div class="form-group"> 

<div class="table"> 

<table> 

<tr> 

int cnt = 0 ; 

foreach (var course in Model.AssignedCourseDataList) 

{ 

if (cnt++ % 3 == 0) 

{ 

</trxtr> 

} 

<td> 

cinput type="checkbox" 

name="selectedCourses" 

value="@course.CourseID" 

@(Html.Raw(course.Assigned ? "checked=\"checked\"" : "")) /> 
(Şcourse.CourselD @course.Title 

@:</td> 

} 

</tr> 

} 

</table> 

</div> 

</div> 

<div class="form-group"> 

<input type="submit" value="Create" class="btn btn-primary" /> 

</div> 

</form> 

</div> 

</div> 

<div> 

<a asp-page="Index">Back to List</a> 

</div> 


(Şsection Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 


Eğitmen oluşturma sayfasını test edin. 

Eğitmen silme sayfasını Güncelleştir 


Sayfaları/eğitmenler/delete. cshtml. cs dosyasını şu kodla güncelleştirin 


using ContosoUniversity.Models; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using Microsoft.EntityFrameworkCore; 

using System.Linq; 

using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Instructors 

{ 

public class DeleteModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public DeleteModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Instructor Instructor { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Instructor = await _context.Instructors.FirstOrDefaultAsync(m => m.ID == id); 

if (Instructor == null) 

{ 

return NotFound(); 

} 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Instructor instructor = await _context.Instructors 
.Include(i => i.CourseAssignments) 

•SingleAsync(i => i.ID == id); 

if (instructor == null) 

{ 

return RedirectToPage("./Index"); 

} 

var departments = await _context.Departments 
.Where(d => d.InstructorlD == id) 

.ToListAsync(); 

departments.ForEach(d => d.InstructorlD = null); 

_context.Instructors.Remove(instructor); 

await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

} 

} 



Yukarıdaki kod aşağıdaki değişiklikleri yapar: 


• courseAssignments Gezinti özelliği için Eager yüklemesi kullanır. courseAssignments eğitmen silindiğinde, 
dahil edilmiş veya silinmemelidir. Bunları okumaktan kaçınmak için, veritabanında basamaklı silme 'yı 
yapılandırın. 

• Silinecek eğitmen herhangi bir departmanların Yöneticisi olarak atanırsa, bu departmanlardan eğitmen 
atamasını kaldırır. 

Uygulamayı çalıştırın ve silme sayfasını test edin. 

Sonraki adımlar 


ÖNCEKİ ■ SONRAKİ 

ÖĞRETİCİ ■ ÖĞRETİCİ 


Bu öğreticide ilgili verilerin güncelleştirilmesi gösterilmektedir.Olamaz çözmenize, sorunlarla karşılaşırsanız, indirin 
veya tamamlanmış uygulamayı görüntüleyin. Yükleme yönergeleri. 

Aşağıdaki çizimler tamamlanan sayfalardan bazılarını göstermektedir. 


H Edit-Coı X + 

□ X 

localhost:53 

EL ☆ 

Contoso University 

— 

Edit 


Course 


Number 


1000 


Tîtle 


Algebra 2| 

X 

Credits 

5 

Department 

Mathematics 

N/ 


Save 

















H Edit - Contoso Universit X 

+ 

□ X 

<- -> O 

localhost ^ 

=- 

Contoso University 


— 


Edit 


Instructor 

Last Name 

Abercrombie 

First Name 

Kim 

Hire Date 

3/11/1995 

Office Location 

44/3P 

□ 1000 Algebra 2 □ 1045 Calculus □ 1050 Chemistry 

02021 Composition 0 2042 Literatüre 03141 Trigonometry 

□ 4022 MicroeconomicsD 4041 Macroeconomics 

Save 



Kurs oluşturma ve düzenleme sayfalarını inceleyin ve test edin. Yeni bir kurs oluşturun. Departman, adı değil, 
birincil anahtarı (bir tamsayı) tarafından seçilir. Yeni kursu düzenleyin. Sınamayı bitirdiğinizde yeni kursu silin. 

Ortak kod paylaşmak için bir temel sınıf oluşturun 

Kurslar/oluştur ve kurslar/Düzenle sayfaları, her birinin departman adları listesine ihtiyacı vardır. Oluşturma ve 
düzenleme sayfaları için Pages/kurslar/DepartmentNamePageModel. cshtml. cs temel sınıfını oluşturun: 













using ContosoUniversity.Data; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.AspNetCore.Mvc. Rendering; 
using Microsoft.EntityFrameworkCore; 
using System.Linq; 

namespace ContosoUniversity.Pages.Courses 

{ 

public class DepartmentNamePageModel : PageModel 

{ 

public SelectList DepartmentNameSL { get; set; } 

public void PopulateDepartmentsDropDownList(SchoolContext _contextj 
object selectedDepartment = null) 

{ 

var departmentsQuery = from d in _context.Departments 
orderby d.Name // Şort by name, 
select d; 


} 



DepartmentNameSL = new SelectList(departmentsQuery.AsNoTracking(), 
"DepartmentlD ", "Name"., selectedDepartment); 


Yukarıdaki kod, bölüm adlarının listesini içeren bir SelectList oluşturur. Belirtilmişse, bu departman SelectList 
Öğesinde seçilir. selectedDepartment 


Oluşturma ve düzenleme sayfa modeli sınıfları öğesinden DepartmentNamePageModel türetilir. 


Kurslar sayfalarını özelleştirme 

Yeni bir kurs varlığı oluşturulduğunda, mevcut bir departmanla bir ilişkisi olmalıdır. Bir kurs oluştururken bir 
departman eklemek için, oluşturma ve düzenleme için temel sınıf, departmanı seçmeye yönelik bir açılan liste içerir. 


Counse.DepartmentlD 

yabancı anahtar (FK) özelliğini ayarlar.EF Core, 

Course.DepartmentlD 

Department 


gezinti özelliğini yüklemek için FK kullanır. 
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Oluşturma sayfası modelini aşağıdaki kodla güncelleştirin: 





















using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc; 
using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Courses 

{ 

public class CreateModel : DepartmentNamePageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public CreateModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

public IActionResult OnGet() 

{ 

PopulateDepartmentsDropDownList(_context); 
return Page(); 

} 

[BindProperty] 

public Course Course { get; set; } 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var emptyCourse = new Course(); 

if (await TryUpdateModelAsync<Course>( 
emptyCourse, 

"course", // Prefix for form value. 

s => s.CourselD, s => s.DepartmentlD, s => s.Title, s => s.Credits)) 

{ 

_context.Courses.Add(emptyCourse); 
await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

// Select DepartmentlD if TryUpdateModelAsync fails. 
PopulateDepartmentsDropDownList(_context, emptyCourse.DepartmentlD); 
return Page(); 

} 

} 

} 


Yukarıdaki kod: 

• Türetiliyor DepartmentNamePageModel . 

• TryUpdateModelAsync Aşırı nakletmeyıengellemek için kullanır. 

• ViewData["DepartmentlD"] ile DepartmentNameSL değiştirir (taban sınıfından). 

viewData["DepartmentlD" ] , türü kesin belirlenmiş DepartmentNameSL olan ile değiştirilmiştir. Kesin olarak belirlenmiş 
modeller, kesin olarak yazılan zayıf bir şekilde tercih edilir. Daha fazla bilgi için bkz. zayıf yazılmış veriler (VievvData 
ve VievvBag). 

Kurslar oluşturma sayfasını güncelleştirme 

Sayfaları/kursiart/Create. cshtml 'yi aşağıdaki kodla güncelleştirin: 








@page 

@model Contosollniversity.Pages.Courses.CreateModel 

@{ 

ViewData["Title"] = "Create Course"; 

} 

<h2>Create</h2> 

<h4>Course</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<div class="form-group"> 

<label asp-for="Course.CourseID" class="control-label"x/label> 

<input asp-for="Course.CourseID" class="form-control" /> 

<span asp-validation-for="Course.CourselD" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Course.Title" class="control-label"x/label> 

<input asp-for="Course.Title" class="form-control" /> 

<span asp-validation-for="Course.Title" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Course.Credits" class="contnol-label"x/label> 

<input asp-for="Course.Credits" class="form-control" /> 

<span asp-validation-fon="Course.Credits" class="text-dangen"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Counse.Department" class="contnol-label"x/label> 

<select asp-for="Course.DepantmentID" class="form-contnol" 
asp-items="@Model.DepantmentNameSL"> 
coption value="">-- Select Department --</option> 

</select> 

<span asp-validation-for="Course.DepartmentID" class="text-dangen" /> 

</div> 

<div class="form-group"> 

<input type="submit" value="Create" class="btn btn-default" /> 

</div> 

</form> 

</div> 

</div> 

<div> 

<a asp-page="Index">Back to List</a> 

</div> 

@section Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 

Önceki biçimlendirme, aşağıdaki değişiklikleri yapar: 

• DepartmentlD etiketini departmanadönüştürür. 

• "ViewBag.DepartmentlD" ile DepartmentNameSL değiştirir (taban sınıfından). 

• "Departmanı Seç" seçeneğini ekler. Bu değişiklik, ilk departman yerine "departmanı Seç" i işler. 

• Departman seçili olmadığında bir doğrulama iletisi ekler. 


Razor sayfası seçme etiketi yardımcısınıkullanır: 




<div class="form-group"> 

<label asp-for="Course.Department" class="control-label"x/label> 

<select asp-for="Course.DepartmentID" class="form-control" 
asp-items="@Model.DepartmentNameSL"> 

<option value="">-- Select Department --</option> 

</select> 

<span asp-validation-for="Course.DepartmentID" class="text-danger" /> 

</div> 

Oluştur sayfasını test edin. Oluştur sayfası departman KİMLİĞİ yerine departman adını görüntüler. 

Kurslar düzenleme sayfasını güncelleştirin. 

Pages/kurslar/Edit. cshtml. cs dosyasındaki kodu aşağıdaki kodla değiştirin: 



using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc; 
using Microsoft.EntityFrameworkCore; 
using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Courses 

{ 

public class EditModel : DepartmentNamePageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public EditModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Course Course { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Course = await _context.Courses 

.Include(c => c.Department).FirstOrDefaultAsync(m => m.CourselD == id); 

if (Course == null) 

{ 

return NotFound(); 

} 

// Select current DepartmentID. 

PopulateDepartmentsDropDownList(_context,Course.DepartmentlD); 
return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int? id) 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var courseToUpdate = await _context.Courses.FindAsync(id); 

if (await TryUpdateModelAsync<Course>( 
courseToUpdate, 

"course", // Prefix for form value. 

c => c.Credits, c => c.DepartmentlD, c => c.Title)) 

{ 

await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

// Select DepartmentlD if TryUpdateModelAsync fails. 

PopulateDepartmentsDropDownList(_context, courseToUpdate.DepartmentlD); 
return Page(); 

} 

} 

} 


Değişiklikler, oluşturma sayfası modelinde yapılanlarla benzerdir. Yukarıdaki kodda 

PopuiateDepartmentsDropDownList , açılan listede belirtilen departmanı belirleyen departman kimliği 1 nde geçirilir. 







Pages/kurslar/Edit. cshtml 'yi şu biçimlendirmeyle güncelleştirin: 


@page 

@model ContosoUniversity.Pages.Courses.EditModel 

@{ 

ViewData["Title"] = "Edit"; 

} 

<h2>Edit</h2> 

<h4>Course</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<input type="hidden" asp-for="Course.CourseID" /> 

<div class="form-group"> 

<label asp-for="Course.CourseID" class="control-label"x/label> 
<div>@Html.DisplayFor(model => model.Course.CourseID)</div> 

</div> 

<div class="form-group"> 

<label asp-for="Course.Title" class="control-label"x/label> 

<input asp-for="Course.Title" class="form-control" /> 

<span asp-validation-for="Course.Tltle" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Course.Credits" class="control-label"x/label> 

<input asp-for="Course.Credits" class="form-control" /> 

<span asp-validation-for="Course.Credits" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Course.Department" class="control-label"x/label> 

<select asp-for="Course.DepartmentlD" class="form-control" 
asp-items="@Model .Departmentl\lameSL"x/select> 

<span asp-validatlon-for="Course.DepartmentID" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<input type="submit" value="Save" class="btn btn-default" /> 

</div> 

</form> 

</div> 

</div> 

<div> 

<a asp-page="./Index">Back to List</a> 

</div> 

@section Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 

Önceki biçimlendirme, aşağıdaki değişiklikleri yapar: 

• Kurs KİMLİĞİNİ görüntüler.Genellikle bir varlığın birincil anahtarı (PK) gösterilmez. PKs 'ler genellikle 
kullanıcılara daha az anlamlı olur. Bu durumda, PK kurs numarasıdır. 

• DepartmentlD etiketini departmanadönüştürür. 

• "ViewBag.DepartmentlD" ile DepartmentNameSL değiştirir (taban sınıfından). 


Sayfa, kurs numarası için gizli bir <input type="hidden"> 

alan () içerir. 

<label> 

Etiket 

asp-for="Course.CourseID" 

Yardımcısı ekleme, gizli alan gereksinimini ortadan kaldırmaz. 

cinput type="hidden"> 

Kullanıcı Kaydet' e 


tıkladığında, gönderilen veriler için kurs numarasının dahil olması gerekir. 









Güncelleştirilmiş kodu test edin. Kurs oluşturun, düzenleyin ve silin. 


Ayrıntılara AsNoTracking ekleme ve sayfa modellerini silme 

Anotracking , izleme gerekli olmadığında performansı iyileştirebilir. Sil AsNoTracking ve Ayrıntılar sayfa modeline 
ekleyin. Aşağıdaki kod, güncelleştirilmiş silme sayfası modelini göstermektedir: 

public class DeleteModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public DeleteModel(Contosollniversity .Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Course Course { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Course = await _context.Courses 
.AsNoTracking() 

.Include(c => c.Department) 

.FirstOrDefaultAsync(m => m.CourselD == id); 

if (Course == null) 

{ 

return NotFound(); 

} 

return Page(); 


public async Task<IActionResult> OnPostAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Course = await _context.Courses 
.AsNoTracking() 

.FirstOrDefaultAsync(m => m.CourselD == id); 

if (Course != null) 

{ 

_context.Courses.Remove(Course); 
await _context.SaveChangesAsync(); 

} 

return RedirectToPage("./Index"); 

} 

} 


Pages/kurslar/details. cshtml. cs dosyasındaki yöntemigüncelleştirin: onGetAsync 





public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Course = await _context.Courses 
.AsNoTracking() 

.Include(c => c.Department) 

.FirstOrDefaultAsync(m => m.CourselD == id); 

if (Course == null) 

{ 

return NotFound(); 

} 

return Page(); 


Silme ve Ayrıntılar sayfalarını değiştirme 

Razor Sil sayfasını aşağıdaki biçimlendirmeyle güncelleştirin: 



@page 

@model ContosoUniversity.Pages.Courses.DeleteModel 

@{ 

ViewData["Title"] = "Delete"; 

} 

<h2>Delete</h2> 

<h3>Are you sure you want to delete this?</h3> 

<div> 

<h4>Course</h4> 

<hr /> 

<dl class="dl-horizontal"> 

<dt> 

@Html.DisplayNameFor(model => model.Course.CourselD) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Course.CourselD) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Course.Tltle) 

</dt> 

<dd> 

@Html.DisplayFor(model = > model.Course.Tltle) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Course.Credits) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Course.Credits) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Course.Department) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Course.Department.DepartmentlD) 
</dd> 

</dl> 

<form method="post"> 

<input type="hidden" asp-for="Course.CourseID" /> 

<input type="submit" value="Delete" class="btn btn-default" /> | 

<a asp-page="./Index">Back to List</a> 

</form> 

</div> 


Ayrıntılar sayfasında aynı değişiklikleri yapın. 

Kurs sayfalarını test etme 

Test oluşturma, düzenleme, Ayrıntılar ve silme. 

Eğitmen sayfalarını güncelleştirme 

Aşağıdaki bölümlerde, eğitmen sayfaları günceldir. 

Office konumu Ekle 

Bir eğitmen kaydını düzenlediğinizde, eğitmenin Office atamasını güncelleştirmek isteyebilirsiniz, instructor 
Varlığın officeAssignment varlıkla bire sıfır veya-bir ilişkisi vardır. Eğitmen kodu şu şekilde olmalıdır: 

• Kullanıcı Office atamasını temizlediğinde OfficeAssignment varlığı silin. 

• Kullanıcı bir Office ataması girerse ve boşsa, yeni OfficeAssignment bir varlık oluşturun. 







• Kullanıcı Office atamasını değiştirirse officeAssignment varlığı güncelleştirin. 
Eğitmenler düzenleme sayfası modelini aşağıdaki kodla güncelleştirin: 

public class EditModel : PageModel 

{ 

private readonly Contosollniversity.Data.SchoolContext _context; 

public EditModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Instructor Instructor { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Instructor = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.AsNoTracking() 

.FirstOrDefaultAsync(m => m.ID == id); 

if (Instructor == null) 

{ 

return NotFound(); 

} 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int? id) 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var instructorToUpdate = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.FirstOrDefaultAsync(s => s.ID == id); 

if (await TryUpdateModelAsync<Instructor>( 

İnstructorToUpdate, 

"Instructor", 

i => i.FirstMidName, i => i.LastName, 
i => i.HireDate, i = > i.OfficeAssignment)) 

{ 

if (String.IsNullOrWhiteSpace( 

İnstructorToUpdate.OfficeAssignment?.Location)) 

{ 

İnstructorToUpdate.OfficeAssignment = null; 

} 

await _context.SaveChangesAsync(); 

} 

return RedirectToPage("./Index"); 

} 

} 


Yukarıdaki kod: 




• Gezinti officeAssignment özelliği için instructor Eager yüklemesini kullanarak geçerli varlığı veritabanından 
alır. 

• Alınan instructor varlığı model Ciltçideki değerlerle güncelleştirir. TryUpdateModei fazla nakletmeyiönler. 

• Office konumu boşsa, null olarak ayarlar instructor.OfficeAssignment . Null instructor.OfficeAssignment 
olduğunda, OfficeAssignment tablodaki ilgili satır silinir. 

Eğitmen düzenleme sayfasını güncelleştirme 

Sayfaları/eğitmenler/Edit. cshtml dosyasını Office konumuyla güncelleştirin: 

@page 

@model ContosoUniversity.Pages.Instructors.EditModel 

@{ 

ViewData["Title"] = "Edit"; 

} 

<h2>Edit</h2> 

<h4>Instructor</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<input type="hidden" asp-for="Instructor.ID" /> 

<div class="form-group"> 

dabel asp-for="Instructor. LastName" class="control-label"x/label> 

<input asp-for="Instructor.LastName" class="form-control" /> 

<span asp-validation-for="instructor. LastName" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="instructor. FirstMidName" class="control-label"x/label> 

<input asp-for="Instructor.FirstMidName" class="form-control" /> 

<span asp-validation-for="instructor.FirstMidName" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="instructor.HireDate" class="control-label"x/label> 

<input asp-for="Instructor.HireDate" class="form-control" /> 

<span a sp-validation-for=" instructor .HireDate" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="instructor.OfficeAssignment. Location" class="control-label"x/label> 

<input asp-for="Instructor.OfficeAssignment.Location" class="form-control" /> 

<span asp-validation-for="Instructor.OfficeAssignment.Location" class="text-danger" /> 
</div> 

<div class="form-group"> 

<input type="submit" value="Save" class="btn btn-default" /> 

</div> 

</form> 

</div> 

</div> 

<div> 

<a asp-page="./Index">Back to List</a> 

</div> 

(Şsection Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 


Bir eğitmenler ofis konumunu değiştirebildiğinizi doğrulayın. 

Eğitmen düzenleme sayfasına kurs atamaları ekleme 

Eğitmenler, istediğiniz sayıda kurs öğretebilir. Bu bölümde kurs atamalarını değiştirme olanağını eklersiniz. 
Aşağıdaki görüntüde güncelleştirilmiş eğitmen düzenleme sayfası gösterilmektedir: 








H Edit - Contoso Universit X + 

□ X 

^ localhost:58 

DP ☆ | =- 

Contoso University 

— 

Edit 


Instructor 


Last Name 


Abercrombie 


First Name 


Kim 


Hire Date 


3/11/1995 


Office Location 


44/3P 


□ 1000 Algebra 2 □ 1045 Calculus 

01050 Chemistry 

0 2021 Composition 0 2042 Literatüre 

03141 Trigonometry 

O 4022 MicroeconomicsD 4041 Macroeconomics 

Save 



çoktan çoğa ilişkisine sahiptir, ilişki eklemek ve kaldırmak için, courseAssignments JOIN 
ık ekleyin ve kaldırın. 

Onay kutuları, bir eğitmenin atandığı kurslara değişiklikler sağlar. Veritabanındaki her kurs için bir onay kutusu 
görüntülenir. Eğitmenin atandığı kurslar denetlenir. Kullanıcı kurs atamalarını değiştirmek için onay kutularını 
seçebilir veya temizleyebilir. Kurs sayısı çok fazlaysa: 


Course ve Instructor 
varlık kümesinden varl 


• Kursları göstermek için büyük olasılıkla farklı bir kullanıcı arabirimi kullanıyorsunuz. 

• ilişki oluşturmak veya silmek için bir JOIN varlığını düzenleme yöntemi değişmez. 

Eğitmen sayfaları oluşturma ve düzenleme desteğini desteklemek için sınıflar ekleme 

Aşağıdaki kodla SchoolVievvModels/AssignedCourseData. cs oluşturun: 

namespace ContosoUniversity.Models.SchoolViewModels 
{ 

public class AssignedCourseData 
{ 

public int CourselD { get; set; } 
public string Title { get; set; } 
public bool Assigned { get; set; } 

} 

} 

Sınıfı AssignedCourseData , bir eğitmen tarafından atanan kurslar için onay kutularını oluşturacak verileri içerir. 
Pages/eğitmenler/Komutctorcoursespagemodel. cshtml. cs temel sınıfını oluşturun: 
















using ContosoUniversity.Data; 

using ContosoUniversity.Models; 

using ContosoUniversity.Models.SchoolViewModels; 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using System.Collections.Generic; 

using System.Linq; 

namespace ContosoUniversity.Pages.Instructors 

{ 

public class InstructorCoursesPageModel : PageModel 

{ 


public List<AssignedCourseData> AssignedCourseDataList; 

public void PopulateAssignedCourseData(SchoolContext context, 

Instructor instructor) 

{ 

var allCourses = context.Courses; 

var instructorCourses = new HashSet<int>( 

instructor.CourseAssignments.Select(c => c.CourselD)); 
AssignedCourseDataList = new List<AssignedCourseData>(); 
foreach (var course in allCourses) 

{ 

AssignedCourseDataList.Add(new AssignedCourseData 

{ 

CourselD = course.CourselD, 

Title = course.Title, 

Assigned = İnstructorCourses.Contains(course.CourselD) 

}); 

} 

} 

public void UpdateInstructorCourses(SchoolContext context, 
stringf] selectedCourses, instructor instructorToUpdate) 

{ 

if (selectedCourses == null) 

{ 

İnstructorToUpdate.CourseAssignments = new List<CourseAssignment>(); 
return; 

} 

var selectedCoursesHS = new HashSet<string>(selectedCourses); 
var instructorCourses = new HashSet<int> 

(instructorToUpdate.CourseAssignments.Select(c => c.Course.CourselD)) 
foreach (var course in context.Courses) 

{ 

if (selectedCoursesHS.Contains(course.CourseID.ToString())) 

{ 

if (!instructorCourses.Contains(course.CourselD)) 

{ 

İnstructorToUpdate.CourseAssignments.Add( 
new CourseAssignment 
{ 

InstructorlD = İnstructorToUpdate.İD, 

CourselD = course.CourselD 

}); 

} 

} 

else 

{ 

if (instructorCourses.Contains(course.CourselD)) 

{ 

CourseAssignment courseToRemove 
= İnstructorToUpdate 
.CourseAssignments 

•SingleOrDefault(i => i.CourselD == course.CourselD); 
context.Remove(courseToRemove); 


} 


, instructorCoursesPageModei Düzenleme ve oluşturma sayfa modelleri için kullanacağınız temel sınıftır. 

doldurmak AssignedCourseDataList için tüm varlıkları okur. Her kurs için kod, 
atanıp atanmadığını belirler. Bir diyez kümesi , verimli aramalar oluşturmak için 


Eğitmenler sayfa modelini Düzenle 

Eğitmen düzenleme sayfası modelini aşağıdaki kodla güncelleştirin: 


PopulateAssignedCourseData'' Counse 
başlığı ve eğitmenin courseiD kursa 
kullanılır. 





public class EditModel : InstructorCoursesPageModel 

{ 

private readonly Contosollniversity.Data.SchoolContext _context; 

public EditModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Instructor Instructor { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Instructor = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments).Thenlnclude(i => i.Course) 
.AsNoTracking() 

.FirstOrDefaultAsync(m => m.ID == id); 

if (Instructor == null) 

{ 

return NotFound(); 

} 

PopulateAssignedCourseData(_context, Instructor); 
return Page(); 


public async Task<IActionResult> OnPostAsync(int? id, string[] selectedCourses) 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var instructorToUpdate = await _context.Instructors 
.Include(i = > i.OfficeAssignment) 

.Include(i = > i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.FirstOrDefaultAsync(s => s.ID == id); 

if (await TryUpdateModelAsync<Instructor>( 

İnstructorToUpdate, 

"Instructor", 

i => i.FirstMidName, i => i.LastName, 
i => i.HireDate, i => i.OfficeAssignment)) 

{ 

if (String.IsNullOrWhiteSpace( 

İnstructorToUpdate.OfficeAssignment?.Location)) 

{ 

İnstructorToUpdate.OfficeAssignment = null; 

} 

UpdateInstructorCourses(_context, selectedCourses, İnstructorToUpdate); 
await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

UpdateInstructorCourses(_context, selectedCourses, İnstructorToUpdate); 
PopulateAssignedCourseData(_context, İnstructorToUpdate); 
return Page(); 

} 

} 



Yukarıdaki kod, Office atama değişikliklerini işler. 


Eğitmen Razor görünümünü güncelleştirin: 

@page 

@model ContosoUniversity.Pages.Instructors.EditModel 

@{ 

ViewData["Title"] = "Edit"; 

} 

<h2>Edit</h2> 

<h4>Instructor</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<input type="hidden" asp-for="Instructor.ID" /> 

<div class="form-group"> 

<label asp-for="Instructor. LastName" class="control-label"x/label> 

<input asp-for="Instructor.LastName" class="form-control" /> 

<span asp-validation-for="Instructor. LastName" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Instructor. FirstMidName" class="control-label"x/label> 

<input asp-for="Instructor.FirstMidName" class="form-control" /> 

<span asp-validation-for="Instructor. FirstMidName" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Instructor.HireDate" class="control-label"x/label> 

<input asp-for="Instructor.HireDate" class="form-control" /> 

<span asp-validation-for="Instructor.HireDate" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Instructor.OfficeAssignment.Location" class="control-label"x/label> 

<input asp-for="Instructor.OfficeAssignment.Location" class="form-control" /> 

<span asp-validation-for="Instructor.OfficeAssignment.Location" class="text-danger" /> 
</div> 

<div class="form-group"> 

<div class="col-md-offset-2 col-md-10"> 

<table> 

<tr> 

int cnt = 0 ; 

foreach (var course in Model.AssignedCourseDataList) 

{ 

if (cnt++ % 3 == 0) 

{ 

</trxtr> 

} 

<td> 

cinput type="checkbox" 

name="selectedCourses" 

value="@course.CourseID" 

@(Html.Raw(course.Assigned ? "checked=\"checked\"" : "")) /> 
@course.CourseID @course.Title 

</td> 

} 

</tr> 

} 

</table> 

</div> 

</div> 

<div class="form-group"> 

<input type="submit" value="Save" class="btn btn-default" /> 

</div> 

</form> 

</div> 



</div> 


<div> 

<a asp-page="./Index">Back to List</a> 

</div> 

@section Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 


NOTE 

Kodu Visual Studio 'Ya yapıştırdığınızda, satır sonları kodu kesen bir şekilde değiştirilir. Otomatik biçimlendirmeyi geri almak 
için CTRL + Z bir kez tuşuna basın. CTRL + Z, burada gördüğünüz gibi görünmeleri için satır sonlarını düzeltir. Girintide 
kusursuz @:</tr><tr> olması gerekmez, ancak @:<td> @:</td>„ve @:</tr> çizgilerinin her biri gösterildiği gibi tek bir 

satırda olması gerekir. Yeni kod bloğu seçiliyken, yeni kodu mevcut kodla hizalamak için üç kez Tab tuşuna basın. Bu bağlantı 
ilebu hatanın durumunu oylayın veya gözden geçirin. 


Yukarıdaki kod, üç sütun içeren bir HTML tablosu oluşturur. Her sütunda bir onay kutusu ve kurs numarasını ve 
başlığını içeren bir açıklamalı altyazı vardır. Onay kutularının hepsi aynı ada ("Selectedkurslar") sahiptir.Aynı adı 
kullanmak model cildi bir grup olarak kabul etmek üzere bilgilendirir. Her onay kutusunun değer özniteliği olarak 
courseiD ayarlanır. Sayfa gönderildiğinde, model Ciltçi yalnızca seçili onay kutularının courseiD değerlerinden 
oluşan bir dizi geçirir. 

Onay kutuları başlangıçta işlendiğinde, eğitmenin atandığı kursların denetlenen öznitelikleri vardır. 

Uygulamayı çalıştırın ve güncelleştirilmiş eğitmenler düzenleme sayfasını test edin. Bazı kurs atamalarını değiştirin. 
Değişiklikler Dizin sayfasında yansıtılır. 

Not: Eğitim kursu verilerini düzenlemek için buradaki yaklaşım, sınırlı sayıda kurs olduğunda iyi bir şekilde 
gerçekleştirilir. Çok daha büyük olan koleksiyonlar için, farklı bir kullanıcı arabirimi ve farklı bir güncelleştirme 
yöntemi daha erişilebilir ve verimli olacaktır. 

Eğitmenler oluştur sayfasını güncelleştirme 

Aşağıdaki kodla, eğitmen sayfa modeli oluştur sayfasını güncelleştirin: 

using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Instructors 

{ 

public class CreateModel : InstructorCoursesPageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public CreateModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

public IActionResult OnGet() 

{ 

var instructor = new Instructor(); 

instructor.CourseAssignments = new List<CourseAssignment>(); 

// Provides an empty collection for the foreach loop 
// foreach (var course in Model.AssignedCourseDataList) 

// in the Create Razor page. 

PoDulateAssignedCourseDataf context, instructorl: 






} 


return Page(); 


[BindProperty] 

public Instructor Instructor { get; setj } 

public async Task<IActionResult> OnPostAsync(string[] selectedCourses) 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var newInstructor = new Instructor(); 
if (selectedCourses != null) 

{ 

newInstructor.CourseAssignments = new List<CourseAssignment>(); 
foreach (var course in selectedCourses) 

{ 

var courseToAdd = new CourseAssignment 

{ 

CourselD = int.Parse(course) 

}J 

newInstructor.CourseAssignments.Add(courseToAdd); 

} 

} 

if (await TryllpdateModelAsync<Instructor>( 
newInstructor, 

"Instructor ", 

i => i.FirstMidName, i => i. LastName., 
i => i.HireDate, i => i.OfficeAssignment)) 

{ 

_context.Instructors.Add(newlnstructor); 
await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

PopulateAssignedCourseData(_context, newlnstructor); 
return Page(); 

} 

} 

} 

Yukarıdaki kod, Pages/eğitmenler/Edit. cshtml. cs koduna benzerdir. 

Eğitmen oluşturma Razor sayfasını aşağıdaki biçimlendirmeyle güncelleştirin: 

@page 

@model ContosoUniversity.Pages.Instructors.CreateModel 

@{ 

ViewData["Title"] = "Create"; 

} 

<h2>Create</h2> 

<h4>Instructor</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<div class="form-group"> 

<label asp-for="Instructor. LastName" class="control-label"x/label> 

<input asp-for="Instructor.LastName" class="form-control" /> 

<span asp-validation-for="Instructor. LastName" class="text-danger"x/span> 
</div> 


<div class="form-group"> 

<label asp-for="Instructor. FirstMidName" class="control-label"x/label> 

<input asp-for="Instructor.FinstMidName" class="form-contnol" /> 

<span asp-validation-for="Instructon.FinstMidName" class="text-dangen"x/span> 

</div> 

<div class="fonm-gnoup"> 

<label asp-fon="Instnucton.HineDate" class="contnol-label"x/label> 

<input asp-fon="Instnucton.HineDate" class="fonm-contnol" /> 

<span asp-validation-fon="Instnucton.HineDate" class="text-dangen"x/span> 

</div> 

<div class="fonm-gnoup"> 

<label asp-fon="Instnucton.OfficeAssignment.Location" class="contnol-label"x/label> 

<input asp-fon="Instnucton.OfficeAssignment.Location" class="fonm-contnol" /> 

<span asp-validation-fon="Instnucton.OfficeAssignment.Location" class="text-dangen" /> 
</div> 

<div class="fonm-gnoup"> 

<div class="col-md-offset-2 col-md-10"> 

<table> 

<tn> 

int cnt = 0j 

foneach (van counse in Model.AssignedCounseDataList) 

{ 

if (cnt++ % 3 == 0) 

{ 

</tnxtn> 

} 

<td> 

cinput type="checkbox" 

name="selectedCounses" 

value="@counse.CounseID" 

@(Html.Raw(counse.Assigned ? "checked=\"checked\"" : "")) /> 
(Şcourse.CourselD (Şcourse.Title 

</td> 

} 

</tn> 

} 

</table> 

</div> 

</div> 

<div class="fonm-gnoup"> 

<input type="submit" value="Cneate" class="btn btn-default" /> 

</div> 

</fonm> 

</div> 

</div> 

<div> 

<a asp-page="Index">Back to List</a> 

</div> 

@section Scnipts { 

@{await Html.RendenPantialAsync("_ValidationScniptsPantial");} 

} 


Eğitmen oluşturma sayfasını test edin. 

Silme sayfası 


Delete sayfa modeli aşağıdaki kodla güncelleştirin: 


using ContosoUniversity.Models; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using Microsoft.EntityFrameworkCore; 

using System.Linq; 

using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Instructors 

{ 

public class DeleteModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public DeleteModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Instructor Instructor { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Instructor = await _context.Instructors.SingleAsync(m => m.ID == id); 

if (Instructor == null) 

{ 

return NotFound(); 

} 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int id) 

{ 

Instructor instructor = await _context.Instructors 
.Include(i => i.CourseAssignments) 

•SingleAsync(i => i.ID == id); 

var departments = await _context.Departments 
.Where(d => d.InstructorlD == id) 

.ToListAsync(); 

departments.ForEach(d => d.InstructorlD = null); 

_context.Instructors.Remove(instructor); 

await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

} 

} 


Yukarıdaki kod aşağıdaki değişiklikleri yapar: 

• courseAssignments Gezinti özelliği için Eager yüklemesi kullanır. courseAssignments eğitmen silindiğinde, 
dahil edilmiş veya silinmemelidir. Bunları okumaktan kaçınmak için, veritabanında basamaklı silme 'yı 
yapılandırın. 

• Silinecek eğitmen herhangi bir departmanların Yöneticisi olarak atanırsa, bu departmanlardan eğitmen 
atamasını kaldırır. 




Ek kaynaklar 

• Bu öğreticinin YouTube sürümü (Bölüm 1) 

• Bu öğreticinin YouTube sürümü (Bölüm 2) 


ÖNCEKİ 

İleri 

ASP.NET CORE'DA - EŞZAMANLILIK - 8 8 EF ÇEKİRDEKLİ RAZOR 



SAYFALARI 






ASPNET core'da - eşzamanlılık - 8 8 EF çekirdekli 
Razor sayfaları 

23.11.2019 • 51 minutes to read ı Edit Online 


Tarafından Rick Anderson, Tom Dykstra, ve Jon P Smith 

Contoso Üniversitesi web uygulaması, EF Core ve Visual Studio kullanarak Razor Pages Web uygulamaları 
oluşturmayı gösterir. Öğretici serisi hakkında daha fazla bilgi için ilk öğreticiyebakın. 

Çözemediğiniz sorunlarla karşılaşırsanız, Tamamlanmış uygulamayı indirin ve öğreticiyi izleyerek bu kodu 
oluşturduğunuz şekilde karşılaştırın. 

Bu öğreticide, birden çok kullanıcı aynı anda (aynı anda) bir varlık güncelleştirdiğinizde çakışmalarına 
gösterilmektedir. 

Eşzamanlılık çakışmaları 

Bir eşzamanlılık çakışması ortaya olduğunda: 

• Bir kullanıcı bir varlığın düzenleme sayfasına götürür. 

• İlk kullanıcının değişikliği veritabanına yazılmadan önce, başka bir kullanıcı aynı varlığı güncelleştirir. 

Eşzamanlılık algılama etkinleştirilmemişse, veritabanını güncelleştirme son olarak diğer kullanıcının değişikliklerinin 
üzerine yazılır. Bu risk kabul edilebilir ise, eşzamanlılık için programlama maliyeti avantaja aykırı bir ücret verebilir. 

Kötümser eşzamanlılık (kilitleme) 

Eşzamanlılık çakışmalarını önlemenin bir yolu veritabanı kilitlerini kullanmaktır. Bu, Kötümser eşzamanlılık olarak 
adlandırılır. Uygulama, güncelleştirmeyi amaçladığı bir veritabanı satırını okumadan önce bir kilit ister. Bir satır, 
güncelleştirme erişimi için kilitlendiğinde, ilk kilit yayımlanıncaya kadar başka hiçbir kullanıcının satırı kilitlemesine 
izin verilmez. 

Kilitleri yönetmek dezavantajlara sahiptir. Program, karmaşık olabilir ve Kullanıcı sayısı arttıkça performans 
sorunlarına neden olabilir. Entity Framevvork Core, BT için yerleşik destek sağlamaz ve bu öğretici Bu öğreticinin 
nasıl uygulanacağını göstermez. 

İyimser eşzamanlılık 

İyimser eşzamanlılık eşzamanlılık çakışmalarını olmasını sağlar ve tepki verdiğini uygun olduğunda bunlar yapın. 
Örneğin, Jane departmanı Düzen sayfasını ziyaret ve İngilizce departmanı için bütçe 350,000.00 $0,00 değiştirir. 
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RovvVersion 114 
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Jane tıkladığında önce Kaydet, John aynı sayfayı ziyaret eder ve alanın başlangıç tarihi 1/9/2013 1/9/2007'deki 
değiştirir. 
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Gamze önce Kaydet 1 i tıklatır ve değişiklik etkin duruma geçer çünkü tarayıcı Dizin sayfasını bütçe miktarı olarak 
sıfır ile görüntülüyor. 

John tıkladığında Kaydet yine de bir bütçe $350,000.00 birini gösteren bir Düzenle sayfasında. Sonraki durum 
eşzamanlılık çakışmalarını nasıl işleydiğinize göre belirlenir: 

• Bir kullanıcının hangi özelliği değiştirdiği ve yalnızca ilgili sütunları veritabanında güncelleştirdiğinden 
haberdar olabilirsiniz. 

Bu senaryoda, veri kaybolacak. Farklı özellikler iki kullanıcı tarafından güncelleştirildi. Biri İngilizce, 
departman gözatar sonraki açışınızda Gamze'nin hem Çan'ın değişiklikleri görürler. Bu güncelleştirme 
yöntemini, veri kaybına neden olabilecek çakışmaları sayısını azaltabilirsiniz. Bu yaklaşım bazı dezavantajlara 
sahiptir: 

o Aynı özelliğe rakip bir değişiklik yaptıysanız, veri kaybını önlemek olamaz. 

o Genellikle bir web uygulaması pratik değildir.Tüm getirilen ve yeni değerleri izlemek için önemli durum 
koruma gerektiriyor. Büyük miktarlarda durumu bakımını yapma, uygulama performansını etkileyebilir, 
o Bir varlıkta eşzamanlılık algılama ile karşılaştırıldığında app karmaşıklığı artırabilirsiniz. 

• Gamze'nin değişikliğinin üzerine Çan'ın değişiklik sağlayabilirsiniz. 

Sonraki biri İngilizce departmanı gözatar, 1/9/2013 görürler ve getirilen $350,000.00 değeri. Bu yaklaşım 
olarak adlandırılan bir istemci WINS veya VVINS'te son senaryo, (istemciden gelen tüm değerler veri 
deposunda yer alacak şekilde önceliklidir.) Eşzamanlılık işleme için herhangi bir kodlama yapmazsanız, 

İstemci WINS otomatik olarak gerçekleşir. 

• John 'un değişikliğini veritabanında güncelleştirilmesini engelleyebilirsiniz. Genellikle, bir uygulamayı 
atadığınız: 

o Bir hata iletisi görüntüler, 
o Verilerin geçerli durumunu gösterir, 
o Değişiklikleri uygulamak verin. 

Bu adlı bir Store WINS senaryo. (Veri deposu değerleri, istemci tarafından gönderilen değerlere göre 
önceliklidir.) Bu öğreticide mağaza WINS senaryosunu uygulamanız gerekir. Bu yöntem, hiçbir değişiklik 
uyarı bir kullanıcı kılınmamasını sağlar. 

EF Core çakışma algılama 

EF Core, çakışmalar algıladığında DbConcurrencyException özel durum oluşturur. Çakışma algılamayı etkinleştirmek 
için veri modeli yapılandırılmalıdır. Çakışma algılamayı etkinleştirme seçenekleri şunlardır: 

• EF Core, Update ve DELETE komutlarının VVFIERE yan tümcesinde eşzamanlılık belirteçleri olarak 
yapılandırılan sütunların özgün değerlerini içerecek şekilde yapılandırın. 

Savechanges çağrıldığında WF1ERE yan tümcesi ConcurrencyCheck özniteliğiyle açıklama eklenmiş herhangi 
bir özelliğin özgün değerlerini arar. Update deyimleri, satır ilk okunduğundan bu yana eşzamanlılık belirteci 
özelliklerinden herhangi biri değiştiyse güncelleştirilecek bir satır bulmayacaktır. EF Core eşzamanlılık 
çakışması olarak yorumlar. Birçok sütunu olan veritabanı tablolarında bu yaklaşım çok büyük VVHERE yan 
tümceleriyle sonuçlanabilir ve büyük miktarlarda durum gerektirebilir. Bu nedenle bu yaklaşım genellikle 
önerilmez ve bu öğreticide kullanılan yöntem değildir. 

• Veritabanı tablosunda, bir satırın ne zaman değiştirildiğini belirlemede kullanılabilecek bir izleme sütunu 
ekleyin. 

SQL Server veritabanında, izleme sütununun veri türü rowversion . rowversion değeri, satır her 
güncelleştirildiği zaman artılan sıralı bir sayıdır. Bir Update veya delete komutunda VVHERE yan tümcesi, 
izleme sütununun (orijinal satır sürüm numarası) orijinal değerini içerir. Güncel leşti rilmekte olan satır başka 








bir kullanıcı tarafından değiştirilmişse, rowversion sütunundaki değer özgün değerden farklıdır. Bu durumda, 
Update veya DELETE deyimi VVHERE yan tümcesi nedeniyle güncelleştirilecek satırı bulamıyor. Bir Update 
veya delete komutundan hiçbir satır etkilenmeden EF Core eşzamanlılık özel durumu oluşturur. 

İzleme özelliği Ekle 

içinde Models/Department.cs, RovvVersion adlı izleme özelliği ekleyin: 

using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Department 

{ 

public int DepartmentlD { get; set; } 

[StringLength(50j MinimumLength = 3)] 
public string Name { get; set; } 

[DataType(DataType.Currency)] 

[Column(TypeName = "money")] 
public decimal Budget { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 

[Display(Name = "Start Date")] 
public DateTime StartDate { get; set; } 

public int? InstructorlD { get; set; } 

[Timestamp] 

public byte[] RowVersion { get; set; } 

public Instructor Administrator { get; set; } 
public ICollection<Course> Courses { get; set; } 

} 

} 


Timestamp özniteliği sütunu eşzamanlılık izleme sütunu olarak tanımlar. Fluent API, izleme özelliğini belirtmenin 
alternatif bir yoludur: 

modelBuilder.Entity<Department>() 

.Property<byte[]>("RowVersion") 

.IsRowVersion(); 


• Visual Studio 

• Visual Studio Code 

Bir SQL Server veritabanı için, bayt dizisi olarak tanımlanan bir varlık özelliğindeki [Timestamp] özniteliği: 

• Sütunun VVHERE yan tümceleri DELETE ve UPDATE 'e dahil edilmesini sağlar. 

• Veritabanındaki sütun türünü rovvversionolarak ayarlar. 

Veritabanı, satır her güncelleştirildiği zaman artılan sıralı bir satır sürüm numarası oluşturur. Bir update veya 
Delete komutunda, where yan tümcesi getirilen satır sürümü değerini içerir. Güncel leşti rilmekte olan satır 
getirilmesinden sonra değiştiyse: 

• Geçerli satır sürümü değeri getirilen değerle eşleşmiyor. 










• where yan tümcesi getirilen satır sürümü değerini aradığı için update veya Delete komutları bir satır bulamaz. 

• A DbUpdateConcurrencyException oluşturulur. 

Aşağıdaki kod, T-SQL bölüm adını güncelleştirildiğinde EF Core tarafından oluşturulan bir bölümü 
gösterilmektedir: 

SET NOCOUNT ON; 

UPDATE [Department] SET [Name] = @p0 

IaIHERE [DepartmentlD] = @pl AND [RowVersion] = @p2; 

SELECT [RowVersion] 

FROM [Department] 

IaIHERE @@R0IaIC 0UNT = 1 AND [DepartmentlD] = @pl; 

Önceki kodun gösterdiği vurgulanmış where yan tümcesi içeren Rowversion . Veritabanı Rowversion Rowversion 
parametresine eşit değilse ( @p 2 ), hiçbir satır güncellenmez. 

Aşağıdaki vurgulanmış kodu tam olarak bir satır güncellenmedi doğrular T-SQL gösterir: 

SET NOCOUNT ON; 

UPDATE [Department] SET [Name] = @p0 

IaIHERE [DepartmentlD] = @pl AND [RowVersion] = @p2; 

SELECT [RowVersion] 

FROM [Department] 

IaIHERE @@R0IaIC 0UNT = 1 AND [DepartmentlD] = @pl; 


@@ROWCOUNT son deyiminden etkilenen satır sayısını döndürür. Hiçbir satır güncellenmemişse, EF Core bir 
DbUpdateConcurrencyException oluşturur. 

Veritabanını güncelleştirme 

Rowversion özelliği eklendiğinde geçiş gerektiren veri modeli değişir. 

Projeyi oluşturun. 

• Visual Studio 

• Visual Studio Code 

• PMC'de şu komutu çalıştırın: 

Add-Migration RowVersion 


Bu komut: 

• Geçişleri/fzamarı damgasd_RowVersion. cs geçiş dosyasını oluşturur. 

• Güncelleştirmeleri Migrations/SchoolContextModelSnapshot.cs dosya. Bu güncelleştirme aşağıdaki 
vurgulanmış kodu ekler BuiidModei yöntemi: 















modelBuilder.Entity("ContosoUniversity .Models.Department", b => 

{ 

b.Property<int>("DepartmentID") 

. ValueGeneratedOnAdd() 

.HasAnnotation("SqlServer:ValueGenerationStrategy ", 
SqlServerValueGenerationStrategy.IdentityColumn); 

b.Property<decimal>("Budget") 

.HasColumnType("money"); 

b.Property<int?>("InstructorID"); 

b.Property<string>("Name") 

.HasMaxLength(50); 

b.Property<byte[]>("RowVersion") 

.IsConcurrencyToken() 

.ValueGeneratedOnAddOrUpdate(); 

b.Property<DateTime>("StartDate"); 

b.HasKey("DepartmentID"); 

b.HasIndex("InstructorID"); 

b.ToTable("Department"); 

}); 


• Visual Studio 

• Visual Studio Code 

• PMC'de şu komutu çalıştırın: 


Update-Database 


Yapı iskelesi departmanı sayfaları 

• Visual Studio 

• Visual Studio Code 

• Aşağıdaki özel durumlarla birlikte Yapı Fkatlama öğrenci sayfalarındaki yönergeleri izleyin: 

• Sayfalar/departmanlar klasörü oluşturun. 

• Model sınıfı için Department kullanın. 

o Yeni bir tane oluşturmak yerine var olan bağlam sınıfını kullanın. 

Projeyi oluşturun. 

Dizin sayfasını Güncelleştir 

Scafkatlama aracı Dizin sayfası için bir Rowversion sütunu oluşturdu, ancak bu alan bir üretim uygulamasında 
gösterilmemelidir. Bu öğreticide, eşzamanlılık işlemenin nasıl çalıştığını göstermeye yardımcı olmak için Rowversion 
son baytı görüntülenir. Son baytın kendi kendine benzersiz olması garanti edilmez. 

Pages\Departmerıts\lndex.cshtml sayfasını güncelleştir: 


• Dizin bölümlerine değiştirin. 







• Yalnızca bayt dizisinin son baytını göstermek için Rowversion içeren kodu değiştirin. 

• FirstMidName tam adı ile değiştirin. 

Aşağıdaki kod, güncelleştirilmiş sayfayı gösterir: 

@page 

@model Contosollniversity.Pages.Departments.IndexModel 

@{ 

ViewData["Title"] = "Departments"; 

} 

<h2>Departments</h2> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<table class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model => model.Department[0].Name) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Department[0].Budget) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Department[0].StartDate) 

</th> 

<th> 

@Fltml.DisplayNameFor(model => model.Department[0].Administrator) 

</th> 

<th> 

RowVersion 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

(Şforeach (var item in Model.Department) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Name) 

</td> 

<td> 

@Fltml.DisplayFor(modelItem => item.Budget) 

</td> 

<td> 

@Fltml.DisplayFor(modelItem => item.StartDate) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Administrator.FullName) 

</td> 

<td> 

@item.RowVersion[7] 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.DepartmentID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.DepartmentID">Details</a> | 
<a asp-page="./Delete" asp-route-id="@item.DepartmentID">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 




Düzenleme sayfa modeli güncelleştirme 

Aşağıdaki kodla Pages\Departments\Edit.cshtml.cs güncelleştirin: 

using ContosoUniversity.Data; 

using ContosoUniversity.Models; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using Microsoft.AspNetCore.Mvc.Rendering; 

using Microsoft.EntityFrameworkCore; 

using System.Linq; 

using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Departments 

{ 

public class EditModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public EditModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Department Department { get; set; } 

// Replace ViewData["InstructorID"] 

public SelectList InstructorNameSL { get; set; } 

public async Task<IActionResult> OnGetAsync(int id) 

{ 

Department = await _context.Departments 

.Include(d => d.Administrator) // eager loading 
.AsNoTracking() // tracking not required 

.FirstOrDefaultAsync(m => m.DepartmentlD == id); 

if (Department == null) 

{ 

return NotFound(); 

} 

// Use strongly typed data rather than ViewData. 

InstructorNameSL = new SelectList(_context.Instructors, 

"ID"j "FirstMidName"); 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int id) 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var departmentToUpdate = await _context.Departments 
.Include(i => i.Administrator) 

.FirstOrDefaultAsync(m => m.DepartmentlD == id); 

if (departmentToUpdate == null) 

{ 

return HandleDeletedDepartment(); 

} 

_context.Entry(departmentToUpdate) 

.Property("RowVersion").OriginalValue = Department.RowVersion 


it (await TryUpdateModelAsync<Department>( 
departmentToUpdate, 

"Department", 

s => s.Name, s => s.StartDate, s => s.Budget, s => s.InstructorlD)) 

{ 

try 

{ 

await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

catch (DbUpdateConcurrencyException ex) 

{ 

var exceptionEntry = ex.Entries.Single(); 
var clientValues = (Department)exceptionEntry.Entity; 
var databaseEntry = exceptionEntry.GetDatabaseValues(); 
if (databaseEntry == null) 

{ 

ModelState.AddModelError(string.Empty, "Unable to save. " + 
"The department was deleted by another user."); 
return Page(); 

} 

var dbValues = (Department)databaseEntry.ToObject(); 
await setDbErrorMessage(dbValues, clientValues, _context); 

// Save the current RowVersion so next postback 
// matches unless an new concurrency issue happens. 

Department.RowVersion = (byte[])dbValues.RowVersion; 

// Clear the model error for the next postback. 

ModelState.Remove("Department.RowVersion"); 

} 

} 

InstructorNameSL = new SelectList(_context.Instructors, 

"ID", "FullName", departmentToUpdate.InstructorlD); 

return Page(); 


private IActionResult HandleDeletedDepartment() 

{ 

var deletedDepartment = new Department(); 

// ModelState contains the posted data because of the deletion error 
// and will overide the Department instance values when displaying Page(). 

ModelState.AddModelError(string.Empty, 

"Unable to save. The department was deleted by another user."); 

InstructorNameSL = new SelectList(_context.Instructors, "ID", "FullName", Department.InstructorlD); 
return Page(); 

} 

private async Task setDbErrorMessage(Department dbValues, 

Department clientValues, SchoolContext context) 

{ 

if (dbValues.Name != clientValues.Name) 

{ 

ModelState.AddModelError("Department.Name", 

$"Current value: {dbValues.Name}"); 

} 

if (dbValues.Budget != clientValues.Budget) 

{ 

ModelState.AddModelError("Department.Budget", 

$"Current value: {dbValues.Budget:c}"); 

} 

if (dbValues.StartDate != clientValues.StartDate) 

{ 

ModelState.AddModelError("Department.StartDate", 

$"Current value: {dbValues.StartDate:d}"); 

} 


if (dbValues.InstructorlD != clientValues.InstructorlD) 

{ 

Instructor dblnstructor = await _context.Instructors 
.FindAsync(dbValues.InstructorlD); 

ModelState.AddModelError("Department.InstructorlD ", 

$"Current value: {dblnstructor?.FullName}"); 

} 

ModelState.AddModelError(string.Empty, 

"The record you attempted to edit " 

+ "was modified by another user after you. The " 

+ "edit operation was canceled and the current values in the database " 

+ "have been displayed. If you stili want to edit this record, click " 

+ "the Save button again."); 

} 

} 

} 

OriginalValue , onGet yönteminde alındığı sırada varlıktaki rowVersion değeriyle güncelleştirilir. EF Core özgün 
içeren bir WHERE yan tümcesi ile SQL güncelleştirme komut oluşturur Rowversion değeri. Hiçbir satır 
güncelleştirme komutu tarafından etkileniyorsanız (hiçbir satır özgün sahip Rowversion değer), 
DbUpdateConcurrencyException Özel durumu oluşturulur. 

public async Task<IActionResult> OnPostAsync(int id) 

{ 

if (ÎModelState.IsValid) 

{ 

return Page(); 

} 

var departmentToUpdate = await _context.Departments 
.Include(i => i.Administrator) 

.FirstOrDefaultAsync(m => m.DepartmentlD == id); 

if (departmentToUpdate == null) 

{ 

return HandleDeletedDepartment(); 

} 

_context.Entry(departmentToUpdate) 

.Property("RowVersion").OriginalValue = Department.RowVersion; 


Vurgulanan kodda: 

• Department.RowVersion değeri, ilk olarak düzenleme sayfasına yönelik GET isteğine getirilen varlıkta yer alır. 
Değer, düzenlenecek varlığı görüntüleyen Razor sayfasındaki gizli bir alan tarafından onPost yöntemine 
sağlanır. Gizli alan değeri model cildi tarafından Department.Rowversion 1 a kopyalanır. 

• OriginalValue VVHERE yan tümcesinde kullanılacak EF Core. Vurgulanan kod satırı çalıştırılmadan önce, 
FirstorDefaultAsync Bu yöntemde çağrıldığında, düzenleme sayfasında görüntülendiklerden farklı olabilen 
OriginalValue veritabanında bulunan değeri vardır. 

• Vurgulanan kod, EF Core SQL UPDATE ifadesinin VVHERE yan tümcesindeki görüntülenen Department 
varlığındaki özgün Rowversion değerini kullandığından emin olur. 

Bir eşzamanlılık hatası oluştuğunda, aşağıdaki vurgulanmış kod istemci değerlerini (Bu yönteme gönderilen 

değerler) ve veritabanı değerlerini alır. 











if (await TryllpdateModelAsync<Department>( 
departmentTolIpdate, 

"Department", 

s => s.Name, s => s.StartDate, s = > s.Budget, s => s.InstructorlD)) 

{ 

try 

{ 

await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

catch (DbUpdateConcurrencyException ex) 

{ 

var exceptionEntry = ex.Entries.Single(); 
var clientValues = (Department)exceptionEntry.Entity; 
var databaseEntry = exceptionEntry.GetDatabaseValues(); 
if (databaseEntry == null) 

{ 

ModelState.AddModelError(string.Empty, "Unable to save. " + 
"The department was deleted by another user."); 
return Page(); 

} 

var dbValues = (Department)databaseEntry.ToObject(); 
await setDbErrorMessage(dbValues, clientValues, _context); 

// Save the current RowVersion so next postback 
// matches unless an new concurrency issue happens. 

Department.RowVersion = (byte[])dbValues.RowVersionj 
// Clear the model error for the next postback. 

ModelState.Remove("Department.RowVersion"); 


Aşağıdaki kod, onPostAsync gönderilen değerden farklı veritabanı değerleri olan her bir sütun için özel bir hata 
iletisi ekler: 






private async Task setDbErrorMessage(Department dbValues, 

Department clientValues, SchoolContext context) 

{ 

if (dbValues.Name ! = clientValues.Name) 

{ 

ModelState.AddModelError("Department.Name", 

$"Current value: {dbValues.Name}"); 

} 

if (dbValues.Budget != clientValues.Budget) 

{ 

ModelState.AddModelError("Department.Budget", 

$"Current value: {dbValues.Budget:c}"); 

} 

if (dbValues.StartDate != clientValues.StartDate) 

{ 

ModelState.AddModelError("Department.StartDate", 

$"Current value: {dbValues.StartDate:d}"); 

} 

if (dbValues.InstructorlD != clientValues.InstructorlD) 

{ 

Instructor dblnstructor = await _context.Instructors 
.FindAsync(dbValues.InstructorlD); 

ModelState.AddModelError("Department.InstructorlD", 

$"Current value: {dblnstructor?.FullName}"); 

} 

ModelState.AddModelError(string.Empty, 

"The record you attempted to edit " 

+ "was modified by another user after you. The " 

+ "edit operation was canceled and the current values in the database " 

+ "have been displayed. If you stili want to edit this record, click " 

+ "the Save button again."); 

} 

Aşağıdaki vurgulanan kod, Rowversion değerini veritabanından alınan yeni değer olarak ayarlar. Kullanıcının bir 
sonraki tıklayışında Kaydet, düzenleme sayfası son görüntülenmesini yakalandı beri gerçekleşen eşzamanlılık 
hataları. 




if (await TryUpdateModelAsync<Department>( 
departmentTolIpdate, 

"Department", 

s => s.Name, s => s.StartDate, s = > s.Budget, s => s.InstructorlD)) 

{ 

try 

{ 

await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

catch (DbUpdateConcurrencyException ex) 

{ 

var exceptionEntry = ex.Entries.Single(); 
var clientValues = (Department)exceptionEntry.Entity; 
var databaseEntry = exceptionEntry.GetDatabaseValues(); 
if (databaseEntry == null) 

{ 

ModelState.AddModelError(string.Empty, "Unable to save. " + 
"The department was deleted by another user."); 
return Page(); 

} 

var dbValues = (Department)databaseEntry.ToObject(); 
await setDbErrorMessage(dbValues, clientValues, _context); 

// Save the current RowVersion so next postback 
// matches unless an new concurrency issue happens. 

Department.RowVersion = (byte[])dbValues.RowVersionj 
// Clear the model error for the next postback. 

ModelState.Remove("Department.RowVersion"); 


Modeistate.Remove Deyimi, çünkü gereklidir ModelState eski olan Rowversion değeri. Razor Sayfası'nda 
ModelState değerinin ikisi de mevcut olduğunda alan üzerinde model özellik değerlerini öncelik kazanır. 


Razor sayfasını güncelleştirme 

SayfalarL/departmanları/Düzenle. cshtml 'yi aşağıdaki kodla güncelleştirin: 








@page "{id:int}" 

@model ContosoUniversity.Pages.Departments.EditModel 

@{ 

ViewData["Title"] = "Edit"; 

} 

<h2>Edit</h2> 

<h4>Department</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<input type="hidden" asp-for="Department.DepartmentID" /> 

<input type="hidden" asp-for="Department.RowVersion" /> 

<div class="form-group"> 

<label>RowVersion</label> 

@Model.Department.RowVersion[7] 

</div> 

<div class="form-group"> 

<label asp-for="Department. Name" class="control-label"x/label> 

<input asp-for="Department.Name" class="form-control" /> 

<span asp-validation-for="Department .Name" class="text-danger"x/span> 
</div> 

<div class="form-group"> 

<label asp-for="Department.Budget" class="control-label"x/label> 

<input asp-for="Department.Budget" class="form-control" /> 

<span asp-validation-for="Department. Budget" class="text-danger"x/span> 
</div> 

<div class="form-group"> 

<label asp-for="Department .StartDate" class="control-label"x/label> 
<input asp-for="Department.StartDate" class="form-control" /> 

<span asp-validation-for="Department.StartDate" class="text-danger"> 
</span> 

</div> 

<div class="form-group"> 

<label class="control-label">Instructor</label> 

<select asp-for="Department.InstructorlD" class="form-control" 
asp-items="@Model. InstructorNameSL"x/select> 

<span asp-validation-for="Department.InstructorlD" class="text-danger"> 
</span> 

</div> 

<div class="form-group"> 

<input type="submit" value="Save" class="btn btn-primary" /> 

</div> 

</form> 

</div> 

</div> 

<div> 

<a asp-page="./Index">Back to List</a> 

</div> 

(Şsection Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 


Yukarıdaki kod: 

• Güncelleştirmeleri page gelen yönerge @page için @page "{id:int}" . 

• Gizli satır sürümü ekler. Rowversion POST geri değere bağlar, böylece eklenmesi gerekir. 

• Son baytı görüntüler Rowversion hata ayıklama amacıyla. 

• Değiştirir viewData türü kesin belirlenmiş ile instructorNameSL . 

Eşzamanlılık çakışmalarını düzenleme sayfası ile test 

iki tarayıcılar örneklerinde düzenleme İngilizce departmanı açın: 













• Uygulamayı çalıştırın ve bölümleri seçin. 

• Sağ Düzenle seçin ve İngilizce departmanı için köprü yeni sekmede aç. 

• Birinci sekmede tıklayın Düzenle İngilizce departmanı için köprü. 

Aynı bilgilerin iki tarayıcı sekmeleri görüntüleyin. 

1 A tıklayın ve ilk tarayıcı sekmesine adını değiştirmek Kaydet. 

Contoso University 

Edit 

Department 

RovvVersion 201 

Name 

Languages 

Budget 

350000.00 

Start Date 
09/01/2013 

Instructor 

Kim * 


Save 


Tarayıcı değiştirilen değer ve güncelleştirilmiş rovvVersion göstergesi ile dizin sayfası gösterilir.Güncelleştirilmiş 
rovvVersion göstergesi, Not, ikinci geri göndermenin diğer sekmesinde görüntülenir. 

ikinci bir tarayıcı sekmesinde farklı bir alana değiştirin. 











Contoso University 

Edit 

Department 

RovvVersion 201 

Name 

English 

Budget 

500000| 

Start Date 
09/01/2013 

Instructor 

Kim 


Save 


Kaydet'e tıklayın. Veritabanı değerleriyle eşleşmeyen tüm alanlar için hata iletileri görürsünüz: 

Contoso University 

Edit 

Department 

• The record you attempted to edit was modified by another user 
after you. The edit operation was canceled and the current values 
in the database have been displayed. If you stili want to edit this 
record, click the Save button again. 

RovvVersion 229 

Name 

English 

Current value: Languages 
Budget 
500000 

Current value: $350,000.00 
Start Date 
09/01/2013 


















Ad alanı değiştirmek bu tarayıcı penceresini düşünmediğiniz. Kopyalama ve geçerli değerin (dil) adı alanına 
yapıştırın. Sekme genişletme, istemci tarafı doğrulaması hata iletisini kaldırır. 

Tıklayın Kaydet yeniden, ikinci tarayıcı sekmesinde girdiğiniz değer kaydedilir. Dizin sayfasında kaydedilen değerler 
görürsünüz. 

Silme sayfası 

Sayfaları/departmanları/delete. cshtml. cs öğesini aşağıdaki kodla güncelleştirin: 

using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.EntityFrameworkCore; 
using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Departments 

{ 

public class DeleteModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public DeleteModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Department Department { get; set; } 
public string ConcurrencyErrorMessage { get; set; } 

public async Task<IActionResult> OnGetAsync(int id, bool? concurrencyError) 

{ 

Department = await _context.Departments 
.Include(d => d.Administrator) 

.AsNoTracking() 

.FirstOrDefaultAsync(m => m.DepartmentlD == id); 

if (Department == null) 

{ 

return NotFound(); 

} 

if (concurrencyError.GetValueOrDefault()) 

{ 

ConcurrencyErrorMessage = "The record you attempted to delete " 

+ "was modified by another user after you selected delete. " 

+ "The delete operation was canceled and the current values in the " 

+ "database have been displayed. If you stili want to delete this " 

+ "record, click the Delete button again."; 

} 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int id) 

{ 

try 

{ 

if (await _context.Departments.AnyAsync( 
m => m.DepartmentlD == id)) 

{ 

// Department.rowVersion value is from when the entity 
// was fetched. If it doesn't match the DB, a 
// DbUpdateConcurrencyException exception is thrown. 

_context.Departments.Remove(Department); 
await _context.SaveChangesAsync(); 


} 


} 


} 

return RedirectToPage("./Index"); 

} 

catch (DbUpdateConcurrencyException) 

{ 

return RedirectToPage("./Delete", 

new { concurrencyError = true, id = id }); 

} 

} 


Varlık getirildi sonra değiştiğinde silme sayfası eşzamanlılık çakışmalarını algılar. Department.RowVersion Varlık 
getirildi satır sürümü andır. EF Core SQL DELETE komutu oluşturduğunda, WHERE yan tümcesi ile içerdiği 
Rowversion . Sıfır satır SQL DELETE komutu sonuçları etkileniyorsa: 

• SQL DELETE komutundaki Rowversion veritabanındaki Rowversion eşleşmiyor. 

• DbUpdateConcurrencyException özel durum oluşturulur. 

• OnGetAsync çağrılır concurrencyError . 


Razor Sil sayfasını Güncelleştir 

Güncelleştirme Pages/Departments/Delete.cshtml aşağıdaki kod ile: 







@page "{id:int}" 

@model ContosoUniversity.Pages.Departments.DeleteModel 

@{ 

ViewData["Title"] = "Delete"; 

} 

<h2>Delete</h2> 

<p class="text-danger">@l' / lodel.ConcurrencyErrorMessage</p> 

<hB>Are you sure you want to delete this?</h3> 

<div> 

<h4>Department</h4> 

<hr /> 

<dl class="dl-horizontal"> 

<dt> 

@Html.DisplayNameFor(model => model.Department.Name) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Department.Name) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Department.Budget) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Department.Budget) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Department.StartDate) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Department.StartDate) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Department.RowVersion) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Department.RowVersion[7]) 

</dd> 

<dt> 

@Html.DlsplayNameFor(model => model.Department.Administrator) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Department.Administrator.FullName) 
</dd> 

</dl> 

<form method="post"> 

<input type="hidden" asp-for="Department.DepartmentID" /> 

<input type="hidden" asp-for="Department.RowVersion" /> 

<div class="form-actions no-color"> 

<input type="submit" value="Delete" class="btn btn-danger" /> | 

<a asp-page="./Index">Back to List</a> 

</div> 

</form> 

</div> 


Yukarıdaki kod aşağıdaki değişiklikleri yapar: 

• Güncelleştirmeleri page gelen yönerge @page için @page "{id:int}" . 

• Bir hata iletisi ekler. 

• FullName FirstMidName değiştirir yönetici alan. 

• Değişiklikleri Rowversion son bayt görüntülenecek. 







• Gizli satır sürümü ekler. Rowversion eklenmesi gerekir, çünkü postgit ekleme geri eklemesi değeri bağlar. 

Eşzamanlılık çakışmalarını test et 

Test bölümü oluşturun. 

iki tarayıcılar örneklerinde DELETE test departmanı açın: 

• Uygulamayı çalıştırın ve bölümleri seçin. 

• Sağ Sil seçin ve test departmanı için köprü yeni sekmede aç. 

• Tıklayın Düzenle köprü test bölümü için. 

Aynı bilgilerin iki tarayıcı sekmeleri görüntüleyin, 
ilk tarayıcı sekmesine bütçede değiştirip'ı Kaydet. 

Tarayıcı değiştirilen değer ve güncelleştirilmiş rovvVersion göstergesi ile dizin sayfası gösterilir.Güncelleştirilmiş 
rovvVersion göstergesi, Not, ikinci geri göndermenin diğer sekmesinde görüntülenir. 

ikinci sekmeden test departmanını silin. Veritabanında geçerli değerlerle birlikte bir eşzamanlılık hatası 
görüntülenir. Tıklayarak Sil sürece varlığını siler Rowversion updated.department silinmiş olmuştur. 

Ek kaynaklar 

• EF Core eşzamanlılık belirteçleri 

• EF Core eşzamanlılık işleme 

• 2. x kaynağı AS P.N ET Core hata ayıklaması 

Sonraki adımlar 

Bu, serideki son öğreticidir. Bu öğretici serisinin MVC sürümündeek konular ele alınmıştır. 


ÖNCEKİ 

ÖĞRETİCİ 


Bu öğreticide, birden çok kullanıcı aynı anda (aynı anda) bir varlık güncelleştirdiğinizde çakışmalarına 
gösterilmektedir. Olamaz çözmenize, sorunlarla karşılaşırsanız, indirin veya tamamlanmış uygulamayı görüntüleyin. 
Yükleme yönergeleri. 

Eşzamanlılık çakışmaları 

Bir eşzamanlılık çakışması ortaya olduğunda: 

• Bir kullanıcı bir varlığın düzenleme sayfasına götürür. 

• ilk kullanıcının değişiklik DB'ye yazılmadan önce başka bir kullanıcı aynı varlık güncelleştirir. 

Eşzamanlılık algılama etkin değil, eş zamanlı güncelleştirmeler olduğunda: 

• Son güncelleştirme WINS. Diğer bir deyişle, son güncelleştirme değerleri Veritabanına kaydedilir. 

• Geçerli güncelleştirme ilk kaybolur. 

İyimser eşzamanlılık 

İyimser eşzamanlılık eşzamanlılık çakışmalarını olmasını sağlar ve tepki verdiğini uygun olduğunda bunlar yapın. 
Örneğin, Jane departmanı Düzen sayfasını ziyaret ve İngilizce departmanı için bütçe 350,000.00 $0,00 değiştirir. 







Contoso University 


Edit 

Department 

Budget 

i I ° x 

Administrator 

Abercrombie, Kim ^ j 

Name 

English 

Start Date 

9 / 1/2007 

Save 

Jane tıkladığında önce Kaydet, John aynı sayfayı ziyaret eder ve alanın başlangıç tarihi 1/9/2013 1/9/2007'deki 
değiştirir. 

















Jane tıkladığında Kaydet ilk ve her tarayıcı dizin sayfası görüntülendiğinde değiştirme görür. 


B Departments - Contoso X 

+ 


- □ X 

^ Iocalhost53 

GQ ☆ | 

- m ö - 

Contoso University 



— 


Departments 

Create New 





Name Budget 

Administrator 

Start Date 



English $0.00 

Abercrombie, Kim 

2007-09-01 

Edit | Details | Delete 




John tıkladığında Kaydet yine de bir bütçe $350,000.00 birini gösteren bir Düzenle sayfasında. Sonraki işlemin ne 
eşzamanlılık çakışmalarını nasıl ele tarafından belirlenir. 

iyimser eşzamanlılık aşağıdaki seçenekleri içerir: 

• Bir kullanıcı değiştirmiş hangi özelliğinin kaydını ve yalnızca ilgili sütunları DB'de güncelleştirin. 

Bu senaryoda, veri kaybolacak. Farklı özellikler iki kullanıcı tarafından güncelleştirildi. Biri İngilizce, 
departman gözatar sonraki açışınızda Gamze'nin hem Çan'ın değişiklikleri görürler. Bu güncelleştirme 
yöntemini, veri kaybına neden olabilecek çakışmaları sayısını azaltabilirsiniz. Bu yaklaşım: 

o Aynı özelliğe rakip bir değişiklik yaptıysanız, veri kaybını önlemek olamaz. 



















o Genellikle bir web uygulaması pratik değildir.Tüm getirilen ve yeni değerleri izlemek için önemli durum 
koruma gerektiriyor. Büyük miktarlarda durumu bakımını yapma, uygulama performansını etkileyebilir, 
o Bir varlıkta eşzamanlılık algılama ile karşılaştırıldığında app karmaşıklığı artırabilirsiniz. 

• Gamze'nin değişikliğinin üzerine Çan'ın değişiklik sağlayabilirsiniz. 

Sonraki biri İngilizce departmanı gözatar, 1/9/2013 görürler ve getirilen $350,000.00 değeri. Bu yaklaşım 
olarak adlandırılan bir istemci WINS veya VVINS'te son senaryo, (istemciden gelen tüm değerler veri 
deposunda yer alacak şekilde önceliklidir.) Eşzamanlılık işleme için herhangi bir kodlama yapmazsanız, 

İstemci WINS otomatik olarak gerçekleşir. 

• Çan'ın değişiklik DB'de güncelleştirilmesini engelleyebilir.Genellikle, bir uygulamayı atadığınız: 

o Bir hata iletisi görüntüler, 
o Verilerin geçerli durumunu gösterir, 
o Değişiklikleri uygulamak verin. 

Bu adlı bir Store WINS senaryo. (Veri deposu değerleri, istemci tarafından gönderilen değerlere göre 
önceliklidir.) Bu öğreticide mağaza WINS senaryosunu uygulamanız gerekir. Bu yöntem, hiçbir değişiklik 
uyarı bir kullanıcı kılınmamasını sağlar. 

Eşzamanlılığı işleme 

Ne zaman bir özellik olarak yapılandırıldığında bir eşzamanlılık belirteci: 

• EF Core getirildi sonra'nın özellik değiştirilmedi doğrular.Onay gerçekleşir, SaveChanges veya 
SaveChangesAsync çağrılır. 

• Özelliği, getirildikten sonra değiştirilmişse, bir DbllpdateConcurrencyException oluşturulur. 

DB ve veri modeli oluşturma destekleyecek şekilde yapılandırılması gerekir DbupdateConcurrencyException . 

Bir özellik eşzamanlılık çakışmaları algılama 

Eşzamanlılık çakışmaları ile özellik düzeyinde algılanamıyor ConcurrencyCheck özniteliği. Öznitelik, birden çok 
modelin özellikleri için uygulanabilir. Daha fazla bilgi için veri ek açıklamaları-ConcurrencyCheck. 

[ConcurrencyCheck] Özniteliği, bu öğreticide kullanılmaz. 

Bir satırda eşzamanlılık çakışmaları algılama 

Eşzamanlılık çakışmalarını algılamak için bir rovvversion sütun izleme modele eklenir. rowversion : 

• SOL Server özeldir. Diğer veritabanlarının benzer bir özellik sağlamayabilir. 

• Veritabanından getirildikten sonra'nın bir varlık değiştirilmediğinden belirlemek için kullanılır. 

Bir sıralı bir veritabanı oluşturur rowversion her zaman satır artan sayısı güncelleştirilir, içinde bir update veya 
Delete komutu where yan tümcesi içeren getirilen değeri nowversion . Güncelleştirilen satır değiştiyse: 

• rowversion getirilen değeri ile eşleşmiyor. 

• update Veya Delete olduğundan, komut satır Bul yok where yan tümcesi içeren getirilen rowversion . 

• A DbUpdateConcurrencyException oluşturulur. 

EF Core tarafından hiçbir satır güncelleştirildiğinde içinde bir update veya Delete komutu, bir eşzamanlılık özel 
durumu oluşturulur. 

Departman varlığa izleme özelliği ekleme 

içinde Modeis/Department.cs, RovvVersion adlı izleme özelliği ekleyin: 

















using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Department 

{ 

public int DepartmentlD { get; set; } 

[StringLength(50j MinimumLength = 3)] 
public string Name { get; set; } 

[DataType(DataType.Currency) ] 

[Column(TypeName = "money")] 
public decimal Budget { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 

[Display(Name = "Start Date")] 
public DateTime StartDate { get; set; } 

public int? InstructorlD { get; set; } 

[Timestamp] 

public byte[] RowVersion { get; set; } 

public Instructor Administrator { get; set; } 
public ICollection<Course> Courses { get; set; } 

} 

} 

Zaman damgası özniteliği, bu sütunda yer belirtir where yan tümcesi update ve Delete komutları. Adlandırılan 
öznitelik Timestamp bir SQL SQL Server'ın önceki sürümlerinde kullanılan çünkü timestamp veri türü SQL önce 
rowversion türü değiştirildi. 

Fluent API'si izleme özelliği de belirtebilirsiniz: 

modelBuilder.Entity<Department>() 

.Property<byte[]>("RowVersion") 

.IsRowVersion(); 


Aşağıdaki kod, T-SQL bölüm adını güncelleştirildiğinde EF Core tarafından oluşturulan bir bölümü 
gösterilmektedir: 


SET NOCOUNT ON; 

UPDATE [Department] SET [Name] = @p0 

IaIHERE [DepartmentlD] = @pl AND [RowVersion] = @p2; 

SELECT [RowVersion] 

FROM [Department] 

IaIHERE @@ROWCOUNT = 1 AND [DepartmentlD] = @pl; 

Önceki kodun gösterdiği vurgulanmış where yan tümcesi içeren Rowversion . Varsa DB Rowversion eşit değildir 
Rowversion parametre ( @p2 ), satır güncelleştirilir. 


Aşağıdaki vurgulanmış kodu tam olarak bir satır güncellenmedi doğrular T-SQL gösterir: 















SET NOCOUNT ON; 

UPDATE [Department] SET [Name] = @p0 

IaIHERE [DepartmentlD] = @pl AND [RowVersion] = @p2; 

SELECT [RowVersion] 

FROM [Department] 

IaIHERE @@ROWCOUNT = 1 AND [DepartmentlD] = @pl; 

@@ROWCOUNT son deyiminden etkilenen satır sayısını döndürür. Hayır, satır güncelleştirilir, EF Core oluşturur 
bir DbUpdateConcurrencyException . 

T-SQL EF Core oluşturur Visual Studio çıktı penceresinde görebilirsiniz. 

DB update 

Ekleme Rowversion geçiş gerektiren DB modeli özelliğini değiştirir. 

Projeyi oluşturun. Bir komut penceresinde aşağıdakileri girin: 

dotnet ef migrations add RowVersion 
dotnet ef database update 

Yukarıdaki komutlar: 

• Ekler geçişleri/{zaman stamp}_RowVersion.cs geçiş dosyası. 

• Güncelleştirmeleri Migrations/SchoolContextModelSnapshot.cs dosya. Bu güncelleştirme aşağıdaki 
vurgulanmış kodu ekler BuiidModei yöntemi: 

• DB güncelleştirilemedi geçişlerini çalıştırır. 

İskele Departmanlar modeli 

• Visual Studio 

• Visual Studio Code 

Bölümündeki yönergeleri Öğrenci modeli iskelesini ve Department model sınıfı için. 

Önceki komut iskelesini kurar Department modeli. Projeyi Visual Studio'da açın. 

Projeyi oluşturun. 

Departmanlar dizin sayfası 

Oluşturulan yapı iskelesi altyapısı bir Rowversion sütunu için dizin sayfasını, ancak bu alanı olmamalıdır 
görüntülenecek. Bu öğreticide, son baytı Rowversion eşzamanlılık anlamanıza yardımcı olması için görüntülenir. 

Son bayta kalan benzersiz olması garanti yoktur.Gerçek bir uygulamada görüntüleyemiyordu Rowversion veya son 
baytı RowVersion . 

Dizin Sayfası güncelleştirin: 

• Dizin bölümlerine değiştirin. 

• Biçimlendirme içeren değiştirin Rowversion son baytı ile Rowversion . 

• FirstMidName tam adı ile değiştirin. 

Güncelleştirilen sayfaya aşağıdaki işaretlemeyi gösterir: 















@page 

@model ContosoUniversity.Pages.Departments.IndexModel 

@{ 

ViewData["Title"] = "Departments"; 

} 

<h2>Departments</h2> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<table class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model => model.Department[0].Name) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Department[0].Budget) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Department[0].StartDate) 

</th> 

<th> 

@Html.DisplayNameFor(model = > model.Department[0].Administrator) 

</th> 

<th> 

RowVersion 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

(Sforeach (var item in Model.Department) { 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Name) 

</td> 

<td> 

@Fltml.DisplayFor(modelItem => item.Budget) 

</td> 

<td> 

@Fltml.DisplayFor(modelItem => item.StartDate) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Administrator.FullName) 

</td> 

<td> 

@item.RowVersion[7] 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.DepartmentID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.DepartmentID">Details</a> | 
<a asp-page="./Delete" asp-route-id="@item.DepartmentID">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 


Düzenleme sayfa modeli güncelleştirme 

Aşağıdaki kodla Pages\Departments\Edit.cshtml.cs güncelleştirin: 

using ContosoUniversity.Data; 




using ContosoUniversity.Modeis; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using Microsoft.AspNetCore.Mvc. Rendering; 

using Microsoft.EntityFrameworkCore; 

using System.Linq; 

using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Departments 

{ 

public class EditModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public EditModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Department Department { get; set; } 

// Replace ViewData["InstructorID"] 

public SelectList InstructorNameSL { get; set; } 

public async Task<IActionResult> OnGetAsync(int id) 

{ 

Department = await _context.Departments 

.Include(d => d.Administrator) // eager loading 
.AsNoTracking() // tracking not required 

.FirstOrDefaultAsync(m => m.DepartmentlD == id); 

if (Department == null) 

{ 

return NotFound(); 

} 

// Use strongly typed data rather than ViewData. 

InstructorNameSL = new SelectList(_context.Instructors, 

"ID"j "FirstMidName"); 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int id) 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var departmentToUpdate = await _context.Departments 
.Include(i = > i.Administrator) 

.FirstOrDefaultAsync(m => m.DepartmentlD == id); 

// null means Department was deleted by another user. 
if (departmentToUpdate == null) 

{ 

return HandleDeletedDepartment(); 

} 

// Update the RowVersion to the value when this entity was 
// fetched. If the entity has been updated after it was 
// fetchedj RowVersion won’t match the DB RowVersion and 
// a DbUpdateConcurrencyException is thrown. 

// A second postback will make them match., unless a new 
// concurrency issue happens. 

_context.Entry(departmentToUpdate) 

.Property("RowVersion").OriginalValue = Department.RowVersion 


if (await TryUpdateModelAsync<Department>( 
departmentToUpdate, 

"Department", 

s => s.Name, s => s.StartDate, s => s.Budget, s => s.InstructorlD)) 

{ 

try 

{ 

await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

catch (DbUpdateConcurrencyException ex) 

{ 

var exceptionEntry = ex.Entries.Single(); 
var clientValues = (Department)exceptionEntry.Entity; 
var databaseEntry = exceptionEntry.GetDatabaseValues(); 
if (databaseEntry == null) 

{ 

ModelState.AddModelError(string.Empty, "Unable to save. " + 
"The department was deleted by another user."); 
return Page(); 

} 

var dbValues = (Department)databaseEntry.ToObject(); 
await setDbErrorMessage(dbValues, clientValues, _context); 

// Save the current RowVersion so next postback 
// matches unless an new concurrency issue happens. 

Department.RowVersion = (byte[])dbValues.RowVersion; 

// Must clear the model error for the next postback. 

ModelState.Remove("Department.RowVersion"); 

} 

} 

InstructorNameSL = new SelectList(_context.Instructors, 

"ID", "FullName", departmentToUpdate.InstructorlD); 

return Page(); 


private IActionResult HandleDeletedDepartment() 

{ 

var deletedDepartment = new Department(); 

// ModelState contains the posted data because of the deletion error and will overide the 
Department instance values when displaying Page(). 

ModelState.AddModelError(string.Empty, 

"Unable to save. The department was deleted by another user."); 

InstructorNameSL = new SelectList(_context.Instructors, "ID", "FullName", Department.InstructorlD); 
return Page(); 

} 

private async Task setDbErrorMessage(Department dbValues, 

Department clientValues, SchoolContext context) 

{ 

if (dbValues.Name != clientValues.Name) 

{ 

ModelState.AddModelError("Department.Name", 

$"Current value: {dbValues.Name}"); 

} 

if (dbValues.Budget != clientValues.Budget) 

{ 

ModelState.AddModelError("Department.Budget", 

$"Current value: {dbValues.Budget:c}"); 

} 

if (dbValues.StartDate != clientValues.StartDate) 

{ 

ModelState.AddModelError("Department.StartDate", 

$"Current value: {dbValues.StartDate:d}"); 


if (dbValues.InstructorlD != clientValues.InstructorlD) 

{ 

Instructor dblnstructor = await _context.Instructors 
.FindAsync(dbValues.InstructorlD); 

ModelState.AddModelError("Department.InstructorlD", 

$"Current value: {dblnstructor?.FullName}"); 

} 

ModelState.AddModelError(string.Empty, 

"The record you attempted to edit " 

+ "was modified by another user after you. The " 

+ "edit operation was canceled and the current values in the database " 

+ "have been displayed. If you stili want to edit this record, click " 

+ "the Save button again."); 

} 

} 

} 

Bir eşzamanlılık algılanması OriginalValue güncelleştirilmesi rowVersion alınan varlık değeri. EF Core özgün içeren 
bir VVHERE yan tümcesi ile SQL güncelleştirme komut oluşturur Rowversion değeri. Hiçbir satır güncelleştirme 
komutu tarafından etkileniyorsanız (hiçbir satır özgün sahip Rowversion değer), DbupdateConcurrencyException özel 
durumu oluşturulur. 

public async Task<IActionResult> OnPostAsync(int id) 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var departmentToUpdate = await _context.Departments 
.Include(i => i.Administrator) 

.FirstOrDefaultAsync(m => m.DepartmentlD == id); 

// null means Department was deleted by another user. 
if (departmentToUpdate == null) 

{ 

return HandleDeletedDepartment(); 

} 

// Update the RowVersion to the value when this entity was 
// fetched. If the entity has been updated after it was 
// fetched, RowVersion won't match the DB RowVersion and 
// a DbUpdateConcurrencyException is thrown. 

// A second postback will make them match, unless a new 
// concurrency issue happens. 

_context.Entry(departmentToUpdate) 

.Property("RowVersion").OriginalValue = Department.RowVersion; 

Önceki kodda, Department.Rowversion varlık getirildi değeri olur. OriginalValue DB değer olduğunda 
FirstorDefaultAsync bu yöntemi çağrıldı. 


Aşağıdaki kod, istemci değerler (Bu yönteme gönderilen değerler) ve DB değerleri alır: 










try 

{ 

await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

catch (DbllpdateConcurrencyException ex) 

{ 

var exceptionEntry = ex.Entries.Single(); 
var clientValues = (Department)exceptionEntry.Entity; 
var databaseEntry = exceptionEntry.GetDatabaseValues(); 
if (databaseEntry == null) 

{ 

ModelState.AddModelError(string.Empty, "Unable to save. " + 

"The department was deleted by another user."); 
return Page(); 

} 

var dbValues = (Department)databaseEntry.ToObject(); 
await setDbErrorMessage(dbValues, clientValues, _context); 

// Save the current RowVersion so next postback 
// matches unless an new concurrency issue happens. 

Department.RowVersion = (byte[])dbValues.RowVersion; 

// Must clear the model error for the next postback. 

ModelState.Remove("Department.RowVersion"); 

} 

Aşağıdaki kod, onPostAsync gönderilen değerden farklı olan DB değerleri olan her bir sütun için özel bir hata iletisi 
ekler: 


private async Task setDbErrorMessage(Department dbValues., 

Department clientValues, SchoolContext context) 

{ 

if (dbValues.Name != clientValues.Name) 

{ 

ModelState.AddModelError("Department.Name", 

$"Current value: {dbValues.Name}"); 

} 

if (dbValues.Budget != clientValues.Budget) 

{ 

ModelState.AddModelError("Department.Budget", 

$"Current value: {dbValues.Budget:c}"); 

} 

if (dbValues.StartDate != clientValues.StartDate) 

{ 

ModelState.AddModelError("Department.StartDate", 

$"Current value: {dbValues.StartDate:d}"); 

} 

if (dbValues.InstructorlD != clientValues.InstructorlD) 

{ 

Instructor dblnstructor = await _context.Instructors 
.FindAsync(dbValues.InstructorlD); 

ModelState.AddModelError("Department.InstructorlD", 

$"Current value: {dblnstructor?.FullName}"); 

} 

ModelState.AddModelError(string.Empty, 

"The record you attempted to edit " 

+ "was modified by another user after you. The " 

+ "edit operation was canceled and the current values in the database " 
+ "have been displayed. If you stili want to edit this record, click " 

+ "the Save button again."); 




Aşağıdaki vurgulanmış kodu kümeleri Rowversion değerden yeni değere Veritabanından alınır. Kullanıcının bir 
sonraki tıklayışında Kaydet, düzenleme sayfası son görüntülenmesini yakalandı beri gerçekleşen eşzamanlılık 
hataları. 


try 

{ 

await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

catch (DbUpdateConcurrencyException ex) 

{ 

var exceptionEntry = ex.Entries.Single(); 
var clientValues = (Department)exceptionEntry.Entity; 
var databaseEntry = exceptionEntry.GetDatabaseValues(); 
if (databaseEntry == null) 

{ 

ModelState.AddModelError(string.Emptyj "Unable to save. " + 

"The department was deleted by another user."); 
return Page(); 

} 

var dbValues = (Department)databaseEntry.ToObject(); 
await setDbErrorMessage(dbValues^ clientValueSj _context); 

// Save the current RowVersion so next postback 
// matches unless an new concurrency issue happens. 

Department.RowVersion = (byte[])dbValues.RowVersion; 

// Must clear the model error for the next postback. 

ModelState.Remove("Department.RowVersion"); 

} 

ModelState.Remove Deyimi, çünkü gereklidir ModelState eski olan Rowversion değeri. Razor Sayfası'nda 
ModelState değerinin ikisi de mevcut olduğunda alan üzerinde model özellik değerlerini öncelik kazanır. 

Güncelleştirme düzenleme sayfası 

Güncelleştirme Pages/Departments/Edit.cshtml aşağıdaki işaretlemeyle: 






@page "{id:int}" 

@model ContosoUniversity.Pages.Departments.EditModel 

@{ 

ViewData["Title"] = "Edit"; 

} 

<h2>Edit</h2> 

<h4>Department</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<input type="hidden" asp-for="Department.DepartmentID" /> 

<input type="hidden" asp-for="Department.RowVersion" /> 

<div class="form-group"> 

<label>RowVersion</label> 

@Model.Department.RowVersion[7] 

</div> 

<div class="form-group"> 

<label asp-for="Department. Name" class="control-label"x/label> 

<input asp-for="Department.Name" class="form-control" /> 

<span asp-validation-for="Department .Name" class="text-danger"x/span> 
</div> 

<div class="form-group"> 

<label asp-for="Department.Budget" class="control-label"x/label> 

<input asp-for="Department.Budget" class="form-control" /> 

<span asp-validation-for="Department. Budget" class="text-danger"x/span> 
</div> 

<div class="form-group"> 

<label asp-for="Department .StartDate" class="control-label"x/label> 
<input asp-for="Department.StartDate" class="form-control" /> 

<span asp-validation-for="Department.StartDate" class="text-danger"> 
</span> 

</div> 

<div class="form-group"> 

<label class="control-label">Instructor</label> 

<select asp-for="Department.InstructorlD" class="form-control" 
asp-items="@Model. InstructorNameSL"x/select> 

<span asp-validation-for="Department.InstructorlD" class="text-danger"> 
</span> 

</div> 

<div class="form-group"> 

<input type="submit" value="Save" class="btn btn-default" /> 

</div> 

</form> 

</div> 

</div> 

<div> 

<a asp-page="./Index">Back to List</a> 

</div> 

(Şsection Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 


Önceki işaretlemesi: 

• Güncelleştirmeleri page gelen yönerge @page için @page "{id:int}" . 

• Gizli satır sürümü ekler. Rowversion POST geri değere bağlar, böylece eklenmesi gerekir. 

• Son baytı görüntüler Rowversion hata ayıklama amacıyla. 

• Değiştirir viewData türü kesin belirlenmiş ile instructorNameSL . 


Eşzamanlılık çakışmalarını düzenleme sayfası ile test 

iki tarayıcılar örneklerinde düzenleme İngilizce departmanı açın: 













• Uygulamayı çalıştırın ve bölümleri seçin. 

• Sağ Düzenle seçin ve İngilizce departmanı için köprü yeni sekmede aç. 

• Birinci sekmede tıklayın Düzenle İngilizce departmanı için köprü. 

Aynı bilgilerin iki tarayıcı sekmeleri görüntüleyin. 

1 A tıklayın ve ilk tarayıcı sekmesine adını değiştirmek Kaydet. 
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Department 

RovvVersion 209 
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Budget 
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Instructor 

Kim ▼ 

Save 
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© 2017 - Contoso University 

Tarayıcı değiştirilen değer ve güncelleştirilmiş rovvVersion göstergesi ile dizin sayfası gösterilir.Güncelleştirilmiş 
rovvVersion göstergesi, Not, ikinci geri göndermenin diğer sekmesinde görüntülenir. 

ikinci bir tarayıcı sekmesinde farklı bir alana değiştirin. 
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© 2017 - Contoso University 


Kaydet'e tıklayın. DB değerleri eşleşmeyen tüm alanlar için hata iletileri görürsünüz: 
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Departmer X / | Edit-Contc X 


O (D localhost:1234/Departments/Edit/1 


Contoso University 


Edit 

Department 

• The record you attempted to edit was modified by another 
user after you. The edit operation was canceled and the 
current values in the database have been displayed. If you stili 
want to edit this record, click the Save button again. 

RovvVersion 21 

Name 

English 

Current value: Languages 

Budget 

5000000 

Current value: $350,000 00 

Start Date 

09/01/2007 

Instructor 

Abercrombie, Kim * 

Save 

Back to List 

© 2017 - Contoso University 


Ad alanı değiştirmek bu tarayıcı penceresini düşünmediğiniz. Kopyalama ve geçerli değerin (dil) adı alanına 
yapıştırın. Sekme genişletme, istemci tarafı doğrulaması hata iletisini kaldırır. 
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• The record you attempted to edit was modified by another 
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RovvVersion 21 

Name 

Languages 

Budget 

5000000 

Start Date 

09/01/2007 

Instructor 

Abercrombie, Kim » 

Save 

Back to List 

© 2017 - Contoso University 


Tıklayın Kaydet yeniden, ikinci tarayıcı sekmesinde girdiğiniz değer kaydedilir. Dizin sayfasında kaydedilen değerler 
görürsünüz. 

Silme sayfası 

Delete sayfa modeli aşağıdaki kodla güncelleştirin: 

using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.EntityFrameworkCore; 
using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Departments 
{ 

public class DeleteModel : PageModel 
{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 




















public DeleteModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Department Department { get; set; } 
public string ConcurrencyErrorMessage { get; set; } 

public async Task<IActionResult> OnGetAsync(int id, bool? concurrencyError) 

{ 

Department = await _context.Departments 
.Include(d => d.Administrator) 

.AsNoTracking() 

.FirstOrDefaultAsync(m => m.DepartmentlD == id); 

if (Department == null) 

{ 

return NotFound(); 

} 

if (concurrencyError.GetValueOrDefault()) 

{ 

ConcurrencyErrorMessage = "The record you attempted to delete " 

+ "was modified by another user after you selected delete. " 

+ "The delete operation was canceled and the current values in the " 

+ "database have been displayed. If you stili want to delete this " 

+ "record, click the Delete button again."; 

} 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int id) 

{ 

try 

{ 

if (await _context.Departments.AnyAsync( 
m => m.DepartmentlD == id)) 

{ 

// Department.rowVersion value is from when the entity 
// was fetched. If it doesn't match the DB, a 
// DbUpdateConcurrencyException exception is thrown. 

_context.Departments.Remove(Department); 
await _context.SaveChangesAsync(); 

} 

return RedirectToPage("./Index"); 

} 

catch (DbUpdateConcurrencyException) 

{ 

return RedirectToPage("./Delete", 

new { concurrencyError = true, id = id }); 

} 

} 

} 

} 

Varlık getirildi sonra değiştiğinde silme sayfası eşzamanlılık çakışmalarını algılar. Department.Rowversion Varlık 
getirildi satır sürümü andır. EF Core SQL DELETE komutu oluşturduğunda, WHERE yan tümcesi ile içerdiği 
Rowversion . Sıfır satır SQL DELETE komutu sonuçları etkileniyorsa: 

• Rowversion SQL DELETE komutu eşleşmiyor Rowversion DB'de. 

• DbUpdateConcurrencyException özel durum oluşturulur. 

• OnGetAsync çağrılır concurrencyError . 


Silme sayfası 







Güncelleştirme Pages/Departments/Delete.cshtml aşağıdaki kod ile: 


@page "{id:int}" 

@model ContosoUniversity.Pages.Departments.DeleteModel 

@{ 

ViewData["Title"] = "Delete"; 

} 

<h2>Delete</h2> 

<p class="text-danger">@Model.ConcurrencyErrorMessage</p> 

<hB>Are you sure you want to delete this?</h3> 

<div> 

<h4>Department</h4> 

<hr /> 

<dl class="dl-horizontal"> 

<dt> 

@Html.DisplayNameFor(model => model.Department.Name) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Department.Name) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Department.Budget) 

</dt> 

<dd> 

@Html.DisplayFor(model = > model.Department.Budget) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Department.StartDate) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Department.StartDate) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Department.RowVersion) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Department.RowVersion[7]) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Department.Administrator) 

</dt> 

<dd> 

@Html.DlsplayFor(model => model.Department.Administrator.FullName) 
</dd> 

</dl> 

<form method="post"> 

<input type="hidden" asp-for="Department.DepartmentID" /> 

<input type="hidden" asp-for="Department.RowVersion" /> 

<div class="form-actions no-color"> 

cinput type="submit" value="Delete" class="btn btn-default" /> | 

<a asp-page="./Index">Back to List</a> 

</div> 

</form> 

</div> 


Yukarıdaki kod aşağıdaki değişiklikleri yapar: 

• Güncelleştirmeleri page gelen yönerge @page için @page "{id:int}" . 

• Bir hata iletisi ekler. 

• FullName FirstMidName değiştirir yönetici alan. 





• Değişiklikleri Rowversion son bayt görüntülenecek. 

• Gizli satır sürümü ekler. Rowversion POST geri değere bağlar, böylece eklenmesi gerekir. 

Eşzamanlılık çakışmalarını silme sayfası ile test 

Test bölümü oluşturun. 

iki tarayıcılar örneklerinde DELETE test departmanı açın: 

• Uygulamayı çalıştırın ve bölümleri seçin. 

• Sağ Sil seçin ve test departmanı için köprü yeni sekmede aç. 

• Tıklayın Düzenle köprü test bölümü için. 

Aynı bilgilerin iki tarayıcı sekmeleri görüntüleyin, 
ilk tarayıcı sekmesine bütçede değiştirip'ı Kaydet. 

Tarayıcı değiştirilen değer ve güncelleştirilmiş rovvVersion göstergesi ile dizin sayfası gösterilir.Güncelleştirilmiş 
rovvVersion göstergesi, Not, ikinci geri göndermenin diğer sekmesinde görüntülenir. 

ikinci sekmeden test departmanını silin. Bir eşzamanlılık hatası, VERITABANıNDAKI geçerli değerlerle birlikte 
görüntülenir. Tıklayarak Sil sürece varlığını siler Rowversion updated.department silinmiş olmuştur. 

Bkz: devralma nasıl bir veri modeli devralır. 

Ek kaynaklar 

• EF Core eşzamanlılık belirteçleri 

• EF Core eşzamanlılık işleme 

• Bu öğreticinin YouTube sürümü (eşzamanlılık çakışmalarını İşleme) 

• Bu öğreticinin YouTube sürümü (Bölüm 2) 

• Bu öğreticinin YouTube sürümü (Bölüm 3) 


ÖNCEKİ 






EF Core öğreticisi serisi ile MVC ASPNET Core 

13.11.2019 *2 minutes to read ı Edjt Online 


Bu öğretici 3,0 AS P.N ET Core güncelleştirilmedi. Razor Pages sürümü güncelleştirildi. Bunun ne zaman 
güncelleştirilemeyebilir hakkında bilgi edinmek için Bu GitHub sorununabakın. 

Bu öğretici, ASP.NET Core MVC ve denetleyiciler ve görünümlerle Entity Framevvork Core öğretir. Razor Pages , 
AS P.N ET Core 2,0 1 de tanıtılan alternatif bir programlama modelidir. Yeni geliştirme için, denetleyiciler ve 
görünümlerle MVC üzerinde Razor Pages önerilir. Bu öğreticinin Razor Pages bir sürümü bulunmaktadır. Her 
öğreticide diğer malzemeler ele alınmaktadır: 

Bu MVC öğreticisine bazı şeyler Razor Pages öğreticiye sahip değildir: 

• Veri modelinde devralma uygulama 

• Ham SQL sorguları gerçekleştirme 

• Kodu basitleştirmek için dinamik LINQ kullanma 

Razor Pages öğreticide şunları gerçekleştirmeyen şeyler: 

• ilgili verileri yüklemek için Select metodunu kullanın 

• ASP.NET Core 3,0 için kullanılabilen bir sürüm 

1. Kullanmaya başlama 

2. işlem Oluşturma, Okuma, Güncelleştirme ve Silme 

3. Sıralama, filtreleme, disk belleği ve gruplandırma 

4. Geçişler 

5. Karmaşık veri modeli oluşturma 

6. ilgili verileri okuma 

7. ilgili verileri güncelleştirme 

8. Eşzamanlılık çakışmalarını işleme 

9. Devralma 

10. Gelişmiş konular 






Öğretici: bir ASPNET MVC web uygulamasında EF 
Core kullanmaya başlama 

23.11.2019 * 34 minutes to read ı Edit Online 


Bu öğretici 3,0 AS P.N ET Core güncelleştirilmedi. Razor Pages sürümü güncelleştirildi. Bunun ne zaman 
güncelleştirilemeyebilir hakkında bilgi edinmek için Bu GitHub sorununabakın. 

Bu öğretici, ASP.NET Core MVC ve denetleyiciler ve görünümlerle Entity Framevvork Core öğretir. Razor Pages , 
AS P.N ET Core 2,0 1 de tanıtılan alternatif bir programlama modelidir. Yeni geliştirme için, denetleyiciler ve 
görünümlerle MVC üzerinde Razor Pages önerilir. Bu öğreticinin Razor Pages bir sürümü bulunmaktadır. Her 
öğreticide diğer malzemeler ele alınmaktadır: 

Bu MVC öğreticisine bazı şeyler Razor Pages öğreticiye sahip değildir: 

• Veri modelinde devralma uygulama 

• Ham SQL sorguları gerçekleştirme 

• Kodu basitleştirmek için dinamik LINQ kullanma 

Razor Pages öğreticide şunları gerçekleştirmeyen şeyler: 

• ilgili verileri yüklemek için Select metodunu kullanın 

• ASP.NET Core 3,0 için kullanılabilen bir sürüm 

Contoso Üniversitesi örnek Web uygulaması, Entity Framevvork (EF) Core 2,2 ve Visual Studio 2017 veya 2019 
kullanarak ASP.NET Core 2,2 MVC vveb uygulamalarının nasıl oluşturulacağını gösterir. 

Örnek uygulama, kurgusal bir Contoso Üniversitesi için bir Web sitesidir.Öğrenci giriş, kurs oluşturma ve Eğitmen 
atamaları gibi işlevleri içerir. Bu, Contoso Üniversitesi örnek uygulamasının sıfırdan nasıl oluşturulacağını açıklayan 
bir öğretici serisinin ilkisidir. 

Bu öğreticide şunları yaptınız: 

• ASP.NET Core MVC vveb uygulaması oluşturma 

• Site stili Ayarla 

• EF Core NuGet paketleri hakkında bilgi edinin 

• Veri modeli oluşturma 

• Veritabanı bağlamını oluşturma 

• Bağımlılık ekleme için bağlamı kaydetme 

• Test verileriyle veritabanını başlatma 

• Denetleyici ve görünüm oluşturma 

• Veritabanını görüntüleme 

Önkoşullar 

• .NET Core SDK 2,2 

• Aşağıdaki iş yükleriyle Visual Studio 2019: 

o ASP.net ve Web geliştirme iş yükü 
o .N ET Core platformlar arası geliştirme iş yükü 






Sorun giderme 

Bir sorunla karşılaşırsanız, çözümleyemiyor çalıştırırsanız, genel olarak çözüm kodunuzda karşılaştırarak 
bulabilirsiniz projeyi. Yaygın hataların bir listesi ve bunların nasıl çözüleceği için, serideki son öğreticinin sorun 
giderme bölümünebakın. ihtiyacınız olanları bulamazsanız, ASP.NET Core veya EF Coreiçin bir soru 
gönderebilirsiniz. 


TIP 

Bu, her biri daha önceki öğreticilerde gerçekleştirilen bir dizi 10 öğreticisidir. Her başarılı öğreticinin tamamlanmasından sonra 
projenin bir kopyasını kaydetmeyi göz önünde bulundurun. Daha sonra sorunlarla karşılaşırsanız, tüm serinin başlangıcına 
dönmek yerine önceki öğreticiden baştan başlayabilirsiniz. 


Contoso Üniversitesi web uygulaması 

Bu öğreticilerde oluşturacağınız uygulama basit bir üniversite web sitesidir. 

Kullanıcılar görüntüleyebilir ve Öğrenci, kurs ve Eğitmen bilgileri güncelleştirin. Oluşturacağınız ekranların bazıları 
aşağıda verilmiştir. 
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Contoso University 


Edit 

Student 

EnrolImentDate 

2005-O9-O1T00:00:00.000 

FirstMidName 

Carson 

LastName 

Alexander 

Save 



Web uygulaması oluşturma 

• Visual Studio'yu açın. 

• Dosya menüsünden Yeni > proje' yi seçin. 

• Sol bölmeden, Visual C# > Web > yüklü' i seçin. 

• ASP.NET Core Web uygulaması proje şablonunu seçin. 

• Ad olarak Contosouniversity yazın ve Tamam' a tıklayın. 



• Yeni ASP.NET Core Web uygulaması iletişim kutusunun görünmesini bekleyin. 

• .NET Core, ASP.NET Core 2,2 ve Web uygulaması (Model-View-Controller) şablonu ' nu seçin. 




























• Kimlik doğrulamanın kimlik doğrulaması yokolarak ayarlandığından emin olun. 

• Tamam 'ı seçin 


New ASP.NET Core Web Application - ContosoUniversity 
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Get additional proiect templates 

ö Enable Docker Support (Reauires Docker for Windows1 


A project template for creating an ASP.NET Core 
application with example ASP.NET Core MVC Vievvs 
and Controllers. This template can also be used for 
RESTful HTTP Services. 

Learn more 


Authon Microsoft 

Source: SDK 2.2.100 


Authentication: No Authentication 


Change Authentication 


OS: Windows 


0 Configure for HTTPS 


OK 


Cancel 


Site stili Ayarla 

Birkaç basit değişiklik, site menüsünü, düzeni ve giriş sayfasını ayarlar. 

Görüınümler/paylaşılan/_Layout. cshtml dosyasını açın ve aşağıdaki değişiklikleri yapın: 

• "Contoso Üniversitesi" için "ContosoUniversity" her örneğini değiştirin. Üç örnekleri vardır. 

• Hakkında, öğrenciler, Kurslar, eğitmenlerve Departmanlariçin menü girişleri ekleyin ve Gizlilik menü 
girişini silin. 

Değişiklikler vurgulanır. 

<IDOCTYPE html> 

<html> 

<head> 

<meta charset="utf-8" /> 

<meta name="viewport" content="width=device-width, initial-scale=1.0" /> 

<title>@ViewData["Title"] - Contoso University</title> 

cenvironment include="Development"> 

elinle rel="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.css" /> 

</environment> 

cenvironment exclude="Development"> 

<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter- 
bootstrap/4.1.3/css/bootstrap.min.css" 

asp-fallback-href="~/lib/bootstrap/dist/css/bootstrap.min.css" 

asp-fallback-test-class="sr-only" asp-fallback-test-property="position" asp-fallback-test- 
value="absolute" 

crossorigin="anonymous" 

integrity="sha256-eSilq2PG607g7ibl7yAaWMcrr5GrtohYChqibrV7PBE="/> 

</environment> 

<link rel="stylesheet" href="~/css/site.css" /> 








































</head> 

<body> 

<header> 

<nav class="navbar navbar-expand-sm navbar-toggleable-sm navbar-light bg-white border-bottom box-shadow 


mb-3"> 


<div class="container"> 

<a class="navbar-brand" asp-area="" asp-controller="Home" asp-action="Index">Contoso 

University</a> 

<button class="navbar-toggler'" type="button" data-toggle="collapse" data-target=".navbar- 
collapse" aria-contnols="navbarSupportedContent" 

aria-expanded="false" aria-label="Toggle navigation"> 

<span class="navbar-toggler-icon"x/span> 

</button> 

<div class="navbar-collapse collapse d-sm-inline-flex flex-sm-row-reverse"> 

<ul class="navbar-nav flex-grow-l"> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-area="" asp-controllen="Home" asp- 

action="Index">Home</a> 

</li> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-anea="" asp-controllen="Home" asp- 

action="About">About</a> 

</li> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-anea="" asp-controllen="Students" asp- 

action="Index">Students</a> 

</li> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-anea="" asp-controller="Courses" asp- 

action="Index">Courses</a> 

</li> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-anea="" asp-controllen="Instructors" asp- 
action="Index">Instnuctors</a> 

</li> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-anea="" asp-controllen="Departments" asp- 
action="Index">Depantments</a> 

</li> 

</ul> 

</div> 

</div> 

</nav> 

</headen> 

<div class="container"> 

<pantial name="_CookieConsentPantial" /> 
cmain role="main" class="pb-3"> 

@RenderBody() 

</main> 

</div> 


<footer class="border-top footer text-muted"> 

<div class="container"> 

&copy; 2019 - Contoso University - <a asp-area="" asp-controller="Home" asp- 
action="Pnivacy">Privacy</a> 

</div> 

</footen> 


<environment include="Development"> 

<script snc="~/lib/jquery/dist/jquery. js"x/script> 

<script snc="~/lib/bootstrap/dist/js/bootstrap.bundle.js"x/script> 
</environment> 

<environment exclude="Development"> 

<script sr'c="https://cdnjs.cloudflare.com/ajax/llbs/jquer'y/3.3.1/jquery.min.js" 
asp-fallback-src="~/lib/jquery/dlst/jquery.min.js" 
asp-fallback-test="window.jQuery" 
crossorigin="anonymous" 

integrity="sha256-FgpCb/K3QlLNfOu91ta32o/NMZxltwRo8QtmkMRdAu8="> 

</script> 


<script src=" https://cdnjs.cloudflane.eom/ajax/libs/twitter-bootstrap/4.l.3/js/bootstnap.bundle.min.js" 
asp-fallback-src="~/lib/bootstrap/dist/js/bootstrap.bundle.min.js" 
asp-fallback-test="window.jQuery && window.jQuery.fn && window.jQuery.fn.modal" 
crossorigin="anonymous" 

integrity="sha256-E/V4cWE4qvAe05M0hjtGtqDzPndR01LBk81]/PR7CA4="> 

</script> 

</environment> 

<script src="~/js/site,js" asp-append-vension="true"x/script> 

@RenderSection("Scripts", required: false) 

</body> 

</html> 


Görünümter/Home/lndex. cshtml'de, ASP.net ve MVC hakkındaki metni bu uygulamayla ilgili metinle değiştirmek 
için dosyanın içeriğini aşağıdaki kodla değiştirin: 

@{ 

ViewData["Title"] = "Home Page"; 

} 

<div class="jumbotron"> 

<hl>Contoso University</hl> 

</div> 

<div class="row"> 

<div class="col-md-4"> 

<h2>Welcome to Contoso University</h2> 

<P> 

Contoso University is a sample application that 
demonstnates how to use Entity Framework Core in an 
ASP.NET Core MVC web application. 

</p> 

</div> 

<div class="col-md-4"> 

<h2>Build it from scratch</h2> 

<p>You can build the application by following the steps in a series of tutorials.</p> 

<pxa class="btn btn-default" href="https://docs.asp.net/en/latest/data/ef-mvc/intro.html">See the 
tutorial &raquo; </ax/p> 

</div> 

<div class="col-md-4"> 

<h2>Download İt</h2> 

<p>You can download the completed project from GitHub.</p> 

<pxa class="btn btn-default" 

href="https://github.com/aspnet/AspNetCore.Docs/tree/master/aspnetcore/data/ef-mvc/intro/samples/cu-final">See 
project source code &raquo;</ax/p> 

</div> 

</div> 


Projeyi çalıştırmak için CTRL + F5 tuşlarına basın veya menüden hata ayıklama > Başlat 1 ı seçin. Bu öğreticilerde 
oluşturacağınız sayfaların sekmelerini içeren giriş sayfasını görürsünüz. 
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Contoso University 

VVelcome to Contoso University 

Contoso University is a sample application that demonstrates how to use Entity Framework Core 1.0 in an ASP.NET 
Core MVC 1.0 web application. 

Build it from scratch 

You can build the application by follovving the steps in a series of tutonals. 

See the tutonal» 

Dovvnload it 

You can dovvnload the completed project from GitHub. 

See project source code » 

© 2016 - Contoso University 


NuGet paketleri EF Core hakkında 

Bir projeye EF Core destek eklemek için hedeflemek istediğiniz veritabanı sağlayıcısını yükleyebilirsiniz. Bu öğretici 
SQL Server kullanır ve sağlayıcı paketi Microsoft. EntityFramevvorkCore. SqlServer' dır. Bu paket Microsoft. 
AspNetCore. app metapackageiçinde bulunur, bu nedenle pakete başvurmanız gerekmez. 

EF SQL Server paketi ve bağımlılıkları ( Microsoft.EntityFrameworkCore ve 

Microsoft.EntityFrameworkCore.Reiationai ) EF için çalışma zamanı desteği sağlar. Geçiş öğreticisinde daha sonra bir 
araç paketi ekleyeceksiniz. 

Entity Framevvork Core için kullanılabilen diğer veritabanı sağlayıcıları hakkında daha fazla bilgi için bkz. veritabanı 
sağlayıcıları. 

Veri modeli oluşturma 

Daha sonra Contoso Üniversitesi uygulaması için varlık sınıfları oluşturacaksınız. Aşağıdaki üç varlıkla 
başlayacaksınız. 
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y3 Course 
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student ve Enrollment varlıkları arasında bire çok ilişki vardır ve course ile Enrollment varlıkları arasında bire 
çok bir ilişki vardır. Diğer bir deyişle, bir öğrenci herhangi bir sayıda kursa kaydedilebilir ve bir kurs, kayıtlı sayıda 
öğrenciye sahip olabilir. 

Aşağıdaki bölümlerde, bu varlıkların her biri için bir sınıf oluşturacaksınız. 

Öğrenci varlık 


Student 


Properties 
y? İD 

A LastName 
A FirstMidName 
A EnrolImentDate 
Navigation Properties 
y3 Enrollments 


Modeller klasöründe, Student.es adlı bir sınıf dosyası oluşturun ve şablon kodunu aşağıdaki kodla değiştirin, 
using System; 

using System.Collections.Genenic; 

namespace ContosoUniversity.Models 
{ 

public elass Student 
{ 

public int ID { get; set; } 
public stning LastName { get; set; } 
public stning FirstMidName { get; set; } 
public DateTime EnrolImentDate { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 

id özelliği, bu sınıfa karşılık gelen veritabanı tablosunun birincil anahtar sütunu olacak. Varsayılan olarak, Entity 
Framevvork id veya ciassnameiD adında bir özelliği birincil anahtar olarak yorumlar. 


Enrollments Özelliği bir gezinti özelliği. Gezinti özellikleri, bu varlıkla ilgili diğer varlıkları tutar. Bu durumda, bir 
student entity Enrollments özelliği, bu student varlıkla ilgili Enrollment varlıkların tümünü tutacaktır. Diğer bir 
deyişle, veritabanında verilen bir öğrenci satırı, iki ilişkili kayıt satırına (bu öğrencinin birincil anahtar değerini kendi 
StudentlD yabancı anahtar sütununda içeren satırlar) sahipse, student varlığın Enrollments gezinti özelliği bu iki 
Enrollment varlığını içerir. 


Bir gezinti özelliği birden çok varlığı tutabileceiyorsa (çok-çok veya bire çok ilişkilerde olduğu gibi), türü 
ıcoiiection<T> gibi girişlerin eklenebileceği, silinebileceği ve güncelleştirilemeyebilir bir liste olmalıdır. 
ıcoiiection<T> veya List<T > veya HashSet<T> gibi bir tür belirtebilirsiniz. ıcoiiection<T> belirtirseniz, EF 
varsayılan olarak bir HashSet<T> koleksiyonu oluşturur. 







































Kayıt varlık 



{ 

public enum Grade 
{ 


A, Bj C, D, F 

} 

public class Enrollment 
{ 

public int EnrollmentlD { get; set; } 
public int CourselD { get; set; } 
public int StudentlD { get; set; } 
public Grade? Grade { get; set; } 

public Course Course { get; set; } 
public Student Student { get; set; } 

} 

} 

EnrollmentlD özelliği birincil anahtar olacaktır; Bu varlık, student varlığında gördüğünüz gibi kendisini id yerine 
ciassnameiD modelini kullanır. Normalde tek bir model seçip veri modeliniz genelinde kullanabilirsiniz. Burada, 
değişim, her iki stili de kullanabileceğinizi gösterir. Daha sonraki bir öğreticide, İD 'yi ClassName olmadan 
kullanarak, veri modelinde devralma uygulamayı daha kolay hale getirir. 

Grade Özelliği bir enum . Sonra soru işareti Grade türü bildirimi gösterir Grade özelliği boş değer atanabilir. Boş 
bir sınıf bir sıfır sınıf farklı—null anlamına gelir bir sınıf bilinen değil veya henüz atanmamış. 


StudentlD Özelliği olduğundan yabancı anahtar ve karşılık gelen gezinme özelliğini student. Enrollment bir varlık 
bir student varlığıyla ilişkilendirilir, bu nedenle özellik yalnızca tek bir student varlığı tutabilir (daha önce 
gördüğünüz student.Enroiiments gezinti özelliğinden farklı olarak, birden çok Enrollment varlığı tutabilir). 


CourselD Özelliği olduğundan yabancı anahtar ve karşılık gelen gezinme özelliğini course . Bir Enrollment varlıktır 
biriyle ilişkili course varlık. 


Entity Framevvork, <navigation property namexprimary key property name> adında bir özelliği yabancı anahtar 
özelliği olarak Yorumlar (örneğin, student varlığının birincil anahtarı id olduğundan student gezinti özelliği için 


StudentlD 

). Yabancı anahtar özelliklerine de yalnızca 

cprimary key property name> 

(örneğin 

CourselD , 

Course 


varlığının birincil anahtarı CourselD olduğundan) adlandırılmış olabilir. 


Kurs varlık 






























Course 



using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations.Schema; 


namespace ContosoUniversity.Models 
{ 

public class Course 
{ 

[DatabaseGenerated(DatabaseGeneratedOption.None)] 
public int CourselD { get; set; } 
public string Title { get; set; } 
public int Credits { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 

Enrollments Özelliktir bir gezinme özelliği. A course varlık dilediğiniz sayıda ilgili olabileceğini Enroiiment 
varlıklar. 

Bu serinin sonraki bir öğreticide DatabaseGenerated özniteliği hakkında daha fazla bilgi edineceksiniz. Temel olarak 
bu öznitelik, veritabanının oluşturması yerine kursa ait birincil anahtarı girmenize olanak sağlar. 

Veritabanı bağlamını oluşturma 

Belirli bir veri modeli için Entity Framevvork işlevselliğini koordine eden ana sınıf veritabanı bağlamı sınıfıdır. Bu 
sınıfı, Microsoft.EntityFrameworkCore.DbContext sınıfından türeterek oluşturursunuz. Kodunuzda, veri modeline 
hangi varlıkların ekleneceğini belirtirsiniz. Ayrıca, belirli Entity Framevvork davranışlarını özelleştirebilirsiniz. Bu 
projede adlı sınıfı schooicontext . 

Proje klasöründe, venadlı bir klasör oluşturun. 

Veri klasöründe, SchoolContext.csad\\ yeni bir sınıf dosyası oluşturun ve şablon kodunu şu kodla değiştirin: 

using ContosoUniversity.Models; 
using Microsoft.EntityFrameworkCore; 

namespace ContosoUniversity.Data 
{ 

public class SchoolContext : DbContext 
{ 

public SchoolContext(DbContextOptions<SchoolContext> options) : base(options) 

{ 

} 

public DbSet<Course> Courses { get; set; } 
public DbSet<Enrollment> Enrollments { get; set; } 
public DbSet<Student> Students { get; set; } 

} 

} 













Bu kod, her varlık kümesi için bir DbSet özelliği oluşturur. Entity Framework terimlerinde, genellikle bir varlık 
kümesi bir veritabanı tablosuna karşılık gelir ve bir varlık tablodaki bir satıra karşılık gelir. 



bunları örtülü olarak içerebilir. 

Veritabanı oluşturulduğunda EF, DbSet Özellik adlarıyla aynı adlara sahip tablolar oluşturur. Koleksiyonlar için 
özellik adları genellikle plural (öğrenci yerine öğrenciler), ancak geliştiriciler tablo adlarının plurulululmasını kabul 
etmez. Bu öğreticiler için DbContext içinde tekil tablo adları belirterek varsayılan davranışı geçersiz kılarsınız. Bunu 
yapmak için, son DbSet özelliğinden sonra aşağıdaki vurgulanmış kodu ekleyin. 

using ContosoUniversity.Models; 
using Microsoft.EntityFrameworkCore; 

namespace ContosoUniversity.Data 
{ 

public class SchoolContext : DbContext 
{ 

public SchoolContext(DbContextOptions<SchoolContext> options) : base(options) 

{ 

} 

public DbSet<Course> Courses { get; set; } 
public DbSet<Enrollment> Enrollments { get; set; } 
public DbSet<Student> Students { get; set; } 

protected override void OnModelCreating(ModelBuilder modelBuilder) 

{ 

modelBuilder.Entity<Course>().ToTable("Course"); 
modelBuilder.Entity<Enrollment>().ToTable("Enrollment"); 
modelBuilder.Entity<Student>().ToTable("Student"); 

} 

} 

} 


SchoolContext kaydetme 

ASP.NET Core, varsayılan olarak bağımlılık ekleme işlemini uygular. Hizmetler (EF veritabanı bağlamı gibi) 
uygulama başlatma sırasında bağımlılık ekleme ile kaydedilir. Bu hizmetleri gerektiren bileşenler (MVC 
denetleyicileri gibi) bu hizmetleri Oluşturucu parametreleri aracılığıyla sağlamaktadır. Bu öğreticide daha sonra bir 
bağlam örneği alan denetleyici Oluşturucu kodunu görürsünüz. 

schooicontext bir hizmet olarak kaydetmek için Startup.csaç\r\ ve vurgulanan satırları configureServices 
yöntemine ekleyin. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 

Services.AddDbContext<SchoolContext>(options => 

options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection"))); 

Services. AddMvc(); 

} 













Bağlantı dizesinin adı, DbContextoptionsBuiider nesnesi üzerinde bir yöntem çağırarak bağlama geçirilir. Yerel 
geliştirme için AS P.N ET Core yapılandırma sistemi bağlantı dizesinden okur appsettings.json dosya. 

ContosoUniversity.Data ve Microsoft.EntityFrameworkCore ad alanları için using deyimleri ekleyin ve ardından 
projeyi derleyin. 

using ContosoUniversity.Data; 
using Microsoft.EntityFrameworkCore; 
using Microsoft.AspNetCore.Http; 

AppSettings. JSON dosyasını açın ve aşağıdaki örnekte gösterildiği gibi bir bağlantı dizesi ekleyin. 

{ 

"ConnectionStrings": { 

"DefaultConnection": "Server= 

(localdb)\\mssqllocaldb;Database=ContosoUniversityl;Trusted_Connection=True;MultipleActiveResultSets=true" 

b 

"Logging": { 

"IncludeScopes": false, 

"LogLevel": { 

"Default": "Warning" 

} 

} 

} 

SQL Server Express LocalDB 

Bağlantı dizesi bir SQL Server LocalDB veritabanı belirtir. LocalDB, SQL Server Express veritabanı altyapısının hafif 
bir sürümüdür ve üretim kullanımı için değil uygulama geliştirmeye yöneliktir. LocalDB, isteğe bağlı olarak başlar ve 
karmaşık yapılandırma olduğundan kullanıcı modunda çalışır. Varsayılan olarak, LocalDB c:/users/<user> 
dizininde, mdf veritabanı dosyaları oluşturur. 

Test verileriyle VERITABANıNı başlatma 

Entity Framevvork, sizin için boş bir veritabanı oluşturacaktır. Bu bölümde, test verileriyle doldurmak için veritabanı 
oluşturulduktan sonra çağrılan bir yöntem yazarsınız. 

Burada, veritabanını otomatik olarak oluşturmak için EnsureCreated yöntemini kullanacaksınız. Sonraki bir 
öğreticide , veritabanını bırakıp yeniden oluşturmak yerine veritabanı şemasını değiştirmek için Code First 
Migrations kullanarak model değişikliklerini nasıl işleyeceğinizi göreceksiniz. 

Veri klasöründe, Dblnitializer.es adlı yeni bir sınıf dosyası oluşturun ve şablon kodunu, gerektiğinde bir 
veritabanının oluşturulmasına neden olan aşağıdaki kodla değiştirin ve test verilerini yeni veritabanına yükler. 

using ContosoUniversity.Models; 
using System; 
using System.Linq; 

namespace ContosoUniversity.Data 
{ 

public static elass Dblnitializer 
{ 

public static void Initialize(SchoolContext context) 

{ 

context.Database.EnsureCreated(); 

// Look for any students. 
if (context.Students.Any()) 

{ 

return; // DB has been seeded 










} 


var students = new Student[] 

{ 

new Student{FirstMidName="Carson", LastName="Alexander", EnrollmentDate=DateTime.Parse("2005-09- 

01 ")}, 

new Student{FirstMidName="Meredith",LastName="Alonso",EnrollmentDate=DateTime.Parse("2002-09-01")} 
new Student{FirstMidName="Arturo", LastName="Anand",EnrollmentDate=DateTime.Parse("2003-09-01")}, 
new Student{FirstMidName="Gytis",LastName="Barzdukas",EnrollmentDate=DateTime.Parse("2002-09-01")} 
new Student{FirstMidName="Yan",LastName="Li",EnrollmentDate=DateTime.Parse("2002-09-01")}, 
new Student{FirstMidName="Peggy",LastName="lustice",EnrollmentDate=DateTime.Parse("2001-09-01")}, 
new Student{FirstMidName="Laura",LastName="Norman",EnrollmentDate=DateTime.Parse("2003-09-01")}, 
new Student{FirstMidName="Nino",Lastl\lame="01ivetto",EnrollmentDate=DateTime.Parse("2005-09-01")} 

}; 

foreach (Student s in students) 

{ 

context.Students.Add(s); 

} 

context.SaveChanges(); 

var courses = new Course[] 

{ 

new Course{CourseID=1050,Title="Chemistry",Credits=3}, 
new Course{CourseID=4022,Title="Microeconomics",Credits=3}, 
new Course{CourseID=4041,Title="Macroeconomics",Credits=3}, 
new Course{CourseID=1045,Title="Calculus",Credits=4}, 
new Course{CourseID=3141,Title="Trigonometry",Credits=4}, 
new Course{CourseID=2021,Title="Composition",Credits=3}, 
new Course{CourseID=2042,Title="Literature",Credits=4} 

}; 

foreach (Course c in courses) 

{ 

context.Courses.Add(c); 

} 

context.SaveChanges(); 

var enrollments = new Enrollment[] 

{ 

new Enrollment{StudentID=l,CourseID=1050,Grade=Grade.A}, 
new Enrollment{StudentID=l,CourseID=4022,Grade=Grade.C}, 
new Enrollment{StudentID=l,CourseID=4041,Grade=Grade.B}, 
new Enrollment{StudentID=2,CourseID=1045,Grade=Grade.B}, 
new Enrollment{StudentID=2,CourseID=3141,Grade=Grade.F}, 
new Enrollment{StudentID=2,CourseID=2021,Grade=Grade.F}, 
new Enrollment{StudentID=3,CourseID=1050}, 
new Enrollment{StudentID=4,CourseID=1050}, 
new Enrollment{StudentID=4,CourseID=4022,Grade=Grade.F}, 
new Enrollment{StudentID=5,CourseID=4041,Grade=Grade.C}, 
new Enrollment{StudentID=6,CourseID=1045}, 
new Enrollment{StudentID=7,CourseID=3141,Grade=Grade.A}, 

}; 

foreach (Enrollment e in enrollments) 

{ 

context.Enrollments.Add (e); 

} 

context.SaveChanges(); 

} 

} 

} 

Kod, veritabanında herhangi bir öğrenci olup olmadığını denetler ve yoksa, veritabanının yeni olduğunu ve test 
verileriyle hazırlanması gerektiğini varsayar. Diziye test verileri yükler yerine List<T> performansını iyileştirmek 
için koleksiyonları. 

Program.es' de, uygulama başlangıcında aşağıdakini yapmak için Main yöntemini değiştirin: 


• Bağımlılık ekleme kapsayıcısından bir veritabanı bağlamı örneği alın. 




• Temel yöntemi çağırın ve bu yönteme geçerek bağlamı geçer. 

• Çekirdek yöntemi tamamlandığında bağlamı atın. 

public static void Main(string[] args) 

{ 

var hoşt = CreateWebHostBuilder(args).Build(); 

using (var scope = hoşt.Services.CreateScope()) 

{ 

var Services = scope.ServiceProvider; 
try 
{ 

var context = Services.GetRequiredService<SchoolContext>(); 

Dblnitializer.Initialize(context); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<ILogger<Program>>(); 
logger.LogError(ex, "An error occurred while seeding the database."); 

} 

} 

host.Run(); 

} 

using deyimleri ekle: 

using Microsoft.Extensions.DependencyInjection; 
using ContosoUniversity.Data; 

Daha eski öğreticilerde, Sfortup.csiçinde configure yönteminde benzer bir kod görebilirsiniz. Yalnızca istek ardışık 
düzenini ayarlamak için configure yöntemini kullanmanızı öneririz. Uygulama başlangıç kodu Main yöntemine 
aittir. 

Uygulamayı ilk kez çalıştırdığınızda veritabanı oluşturulur ve test verileriyle birlikte gösterilir. Veri modelinizi her 
değiştirdiğinizde, veritabanını silebilir, çekirdek yönteminizi güncelleştirebilir ve yeni bir veritabanıyla aynı şekilde 
bir baştan başlatabilirsiniz. Sonraki öğreticilerde, veri modeli değiştiğinde ve yeniden oluşturmadan veritabanını 
nasıl değiştireceğiniz hakkında bilgi edineceksiniz. 

Denetleyici ve görünüm oluşturma 

Daha sonra, verileri sorgulamak ve kaydetmek için EF 'i kullanacak bir MVC denetleyicisi ve görünümleri eklemek 
üzere Visual Studio 'da scafkatlama altyapısını kullanacaksınız. 

CRUD eylem yöntemlerinin ve görünümlerinin otomatik olarak oluşturulması, yapı iskelesi olarak bilinir.Yapı 
iskelesi, yapı oluşturma işleminden farklı olarak, kendi gereksinimlerinize uyacak şekilde değiştirebileceğiniz bir 
başlangıç noktası ve genellikle oluşturulan kodu değiştirmezsiniz. Oluşturulan kodu özelleştirmeniz gerektiğinde, 
kısmi sınıfları kullanırsınız veya işlemler değiştiğinde kodu yeniden oluşturmanız gerekir. 

• Çözüm Gezgini ' de denetleyiciler klasörüne sağ tıklayın ve > yeni iskele öğe Ekle' yi seçin. 

• Yapı İskelesi Ekle iletişim kutusunda: 

o Entity Framevvork kullanarak, görünümlerle MVC denetleyicisi ' niseçin. 

o Ekle'ye tıklayın. Görünümler İle MVC denetleyicisi ekleme, Entity Framevvork kullanma 

iletişim kutusu görüntülenir. 







Add MVC Controller with vievvs, using Entity Framework X 


Model elass: 


Student (ContosoUniversity.Models) 

V 




Data context elass: 


SchoolContext (ContosoUniversity.Data) 

-11 + 





Views: 

■s\ Generate views 
0 Reference script libraries 
0 Use a layout page: 


(Leave empty if it is set in a Razor _viewstart file) 


Controller name: 


Studentscontroller 





Add 


Cancel 


o Model sınıfı 1 nda öğrenci' yi seçin, 
o Veri bağlamı sınıfında SchoolContextöğesini seçin, 
o Varsayılan Studentscontroller adını olarak kabul edin, 
o Ekle'ye tıklayın. 

Ekle' ye tıkladığınızda, Visual Studio yapı iskelesi altyapısı, denetleyicisiyle birlikte çalışan bir 
StudentsController.es dosyası ve bir dizi görünüm (. cshtml dosyası) oluşturur. 

(Yapı iskelesi altyapısı, daha önce Bu öğreticide yaptığınız gibi, daha önce el ile oluşturmazsanız, sizin için veritabanı 
bağlamını de oluşturabilir. Veri bağlam sınıfınınsağ tarafındaki artı İşaretine tıklayarak Denetleyici Ekle 
kutusunda yeni bir bağlam sınıfı belirtebilirsiniz. Daha sonra Visual Studio, DbContext sınıfınızın yanı sıra 
denetleyiciyi ve görünümleri de oluşturacaktır.) 

Denetleyicinin bir schooicontext Oluşturucu parametresi olarak aldığını fark edeceksiniz. 

namespace ContosoUniversity.Controllers 
{ 

public elass Studentscontroller : Controller 
{ 

private readonly SchoolContext _contextj 

public StudentsController(SchoolContext context) 

{ 

_context = context; 

} 

ASP.NET Core bağımlılığı ekleme, denetleyiciye schooicontext bir örneği geçirmekten yararlanır. Bunu Startup.es 
dosyasında daha önce yapılandırdınız. 

Denetleyici, veritabanındaki tüm öğrencileri görüntüleyen bir index Action yöntemi içerir. Yöntemi, veritabanı 
bağlamı örneğinin students özelliğini okuyarak öğrenciler varlık kümesinden öğrencilerin bir listesini alır: 















































public async Task<IActionResult> Index() 

{ 

return View(await _context.Students.ToListAsync()); 

} 


Öğreticide daha sonra bu kodda zaman uyumsuz programlama öğeleri hakkında bilgi edineceksiniz. 
Views/öğrenciler/!ndex. cshtml görünümü bu listeyi bir tabloda görüntüler: 

@model IEnumerablecContosoUniversity.Models.Student> 

@{ 

ViewData["Title"] = "Index"; 

} 

<h2>Index</h2> 

<P> 

<a asp-action="Create">Create New</a> 

</p> 

<table class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model => model.LastName) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.FirstMidName) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.EnrollmentDate) 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

(Şforeach (var item in Model) { 

<tr> 

<td> 

@Html.DisplayFor(modelItem => İtem.LastName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.FirstMidName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.EnrollmentDate) 

</td> 

<td> 

<a asp-action="Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-action="Details" asp-route-id="@item.ID">Details</a> | 

<a asp-action="Delete" asp-route-id="@item.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 


Projeyi çalıştırmak için CTRL + F5 tuşlarına basın veya menüden hata ayıklama > Başlat 1 ı seçin. 

Dbinitializer. initialize yönteminin eklendiği test verilerini görmek için öğrenciler sekmesine tıklayın. Tarayıcı 
pencerenizin ne kadar dar olduğuna bağlı olarak, sayfanın üst kısmında students Tab bağlantısını görürsünüz veya 
bağlantıyı görmek için sağ üst köşedeki gezinti simgesine tıklamanız gerekir. 
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Veritabanını görüntüleme 

Uygulamayı başlattığınızda, Dbinitializer.initialize yöntemi EnsureCreated çağırır. EF, bir veritabanı olmadığını 
ve bu nedenle bir tane oluşturduğunu gördük, initialize yöntemi kodunun geri kalanı veritabanını verilerle 
doldurmuş. Visual Studio 'da veritabanını görüntülemek için SQL Server Nesne Gezgini (ssox) kullanabilirsiniz. 

Tarayıcıyı kapatın. 

SSOX penceresi henüz açık değilse, Visual Studio 'daki Görünüm menüsünden bunu seçin. 

SSOX 'te (LocalDB) \MSSQLLocalDB > veritabanları' na tıklayın ve ardından appSettings. JSON dosyanızdaki 
bağlantı dizesinde bulunan veritabanı adı için girişe tıklayın. 

Veritabanınızdaki tabloları görmek için Tablolar düğümünü genişletin. 












SQL Server Object Explorer 

6 | *i te 

* a* SQL Server 

a Ş (localdb)\MSSQLLocalDB (SQL S 
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> ti) System Tables 
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> B dbo.Course 

> B dbo.EnrolIment 
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Oluşturulan sütunları ve tabloya eklenmiş satırları görmek için öğrenci tablosuna sağ tıklayın ve verileri 
görüntüle 1 ye tıklayın. 


* ContosoUniversity 


n 


dbo.Students [Data] -s X | 

C/ | ▼ | | MaxRows: 1000 - | £T £T 

İD EnrolImentDate FirstMidName LastName 

► |Q 9/1/200512:00:... Carson Alexander 

12 9/1/200212:00:... Meredith Alonso 

9/1/2003 12:00:... Arturo Anand 


9/1/200212:00:... Gytis Barzdukas 



. Mc/fve. /dfveritabanı dosyaları, C:\Users\<YourUserName > klasöründedir. 

Uygulama başlatma sırasında çalışan Başlatıcı yönteminde EnsureCreated çağırırken, artık student sınıfında bir 
değişiklik yapabilir, veritabanını silebilir, uygulamayı yeniden çalıştırabilirsiniz ve veritabanı, değişikliklerinizi 
eşleştirmek için otomatik olarak yeniden oluşturulur. Örneğin, student sınıfına bir EmailAddress özelliği eklerseniz, 
yeniden oluşturulan tabloda yeni bir EmailAddress sütunu görürsünüz. 

Kurallar 

Entity Framevvork, kuralların kullanımı veya Entity Framework varsayımlarıyla ilgili olarak en az bir veritabanı 
oluşturabilmesini sağlamak için yazmanız gereken kod miktarı. 

• DbSet özelliklerinin adları tablo adı olarak kullanılır. DbSet özelliği tarafından başvurulmayan varlıklar için, 
varlık sınıfı adları tablo adı olarak kullanılır. 

• Varlık özelliği adları, sütun adları için kullanılır. 

• İD veya Classnameıd olarak adlandırılan varlık özellikleri, birincil anahtar özellikleri olarak tanınır. 

• Bir özellik, bir yabancı anahtar özelliği olarak yorumlanır <gezlnti özelliği adi ><birincil anahtar özellik adı > 
(örneğin, studentiD , birincil anahtarı student olduğundan student gezinti özelliği için id ). Yabancı 
anahtar özellikleri, <birincil anahtar özellik adı > olarak da adlandırılabilir (örneğin, Enroiiment varlığının 
birincil anahtarı EnrollmentlD olduğundan EnrollmentlD ). 

Geleneksel davranış geçersiz kılınabilir.Örneğin, bu öğreticide daha önce gördüğünüz gibi tablo adlarını açıkça 
belirtebilirsiniz. Ayrıca, bu serinin sonraki bir öğreticide göreceğiniz gibi, sütun adlarını ayarlayabilir ve herhangi bir 
özelliği birincil anahtar veya yabancı anahtar olarak ayarlayabilirsiniz. 


Zaman uyumsuz kod 























Zaman uyumsuz programlama, ASP.NET Core ve EF Core için varsayılan moddur. 

Sınırlı sayıda iş parçacığı kullanılabilir bir vveb sunucusuna sahip ve yüksek yük durumlarda tüm kullanılabilir iş 
parçacıklarının kullanımda olabilir. Bu durum oluştuğunda, sunucunun iş parçacıklarının serbest bırakılana kadar 
yeni istekleri işleyemiyor. G/ç tamamlanması bekleniyor çünkü bunlar herhangi bir iş gerçekten yapmamanız 
sırasında eş zamanlı kod ile birçok iş parçacığı bağlanması, işlemi tamamlamak, g/ç için beklerken zaman uyumsuz 
kod ile diğer istekleri işlemek için kullanılacak sunucuyu için kendi iş parçacığı serbest bırakılır. Sonuç olarak, 
sunucu kaynaklarının daha etkin kullanılması zaman uyumsuz kod sağlar ve sunucu gecikmeler olmadan daha fazla 
trafik işlemek için etkinleştirilir. 


Zaman uyumsuz kod, çalışma zamanında az miktarda yük getirir, ancak düşük trafik durumlarında performans artışı 
göz ardı edilebilir, ancak yüksek trafik durumları için olası performans iyileştirmesi oldukça önemlidir. 

Aşağıdaki kodda async anahtar sözcüğü, Task<T> dönüş değeri, await anahtar sözcüğü ve ToListAsync metodu 
kodu zaman uyumsuz olarak yürütür. 

public async Task<IActionResult> Index() 

{ 

return View(await _context.Students.ToListAsync()); 

} 

• async anahtar sözcüğü, derleyiciye Yöntem gövdesinin parçaları için geri çağrılar oluşturmasını ve 
döndürülen Task<iActionResuit> nesnesini otomatik olarak oluşturmasını söyler. 

• Task<iActionResuit> dönüş türü, iActionResuit türünde bir sonuçla devam eden işi temsil eder. 

• await Anahtar sözcüğü, derleyicinin yöntemin iki parçalara bölmek neden olur. İlk bölüm ile zaman 
uyumsuz olarak başlatıldığında işlemi sonlandırır. ikinci bölümü, işlemi tamamlandıktan sonra çağrılan bir 
geri çağırma yöntemi yerleştirilir. 

• ToListAsync zaman uyumsuz sürümüdür ToList genişletme yöntemi. 

Entity Framevvork kullanan zaman uyumsuz kod yazarken dikkat edilmesi gereken bazı şeyler: 


Yalnızca sorguları veya komutlarının veritabanına gönderilmesine neden olan deyimler zaman uyumsuz 
olarak yürütülür. Bu, örneğin, ToListAsync , singleOrDefaultAsync ve saveChangesAsync içerir. Örneğin, 
var students = context.Students.Where(s => s.LastName == "Davolio") gibi yalnızca bir IÇueryable değiştiren 
deyimler dahil değildir. 


• EF bağlamı iş parçacığı açısından güvenli değildir: paralel olarak birden çok işlem yapmayı denemeyin. 
Herhangi bir zaman uyumsuz EF yöntemini çağırdığınızda her zaman await anahtar sözcüğünü kullanın. 

• Zaman uyumsuz kodun performans avantajlarından yararlanmak isterseniz, kullanmakta olduğunuz tüm 
kitaplık paketlerinin (örneğin, sayfalama için), sorguların veritabanına gönderilmesine neden olan herhangi 
bir Entity Framevvork yöntemini çağırıyorsa, zaman uyumsuz olarak da kullanılmasını sağlayın. 


.N ET ' te zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. Async Overvievv. 


Kodu alın 

Tamamlanmış uygulamayı indirin veya görüntüleyin. 


Sonraki adımlar 

Bu öğreticide şunları yaptınız: 


• ASP.NET Core MVC vveb uygulaması oluşturuldu 


















• Site stili Ayarla 

• EF Core NuGet paketleri hakkında bilgi edinildi 

• Veri modeli oluşturuldu 

• Veritabanı bağlamı oluşturuldu 

• SchoolContext kaydedildi 

• Test verileriyle VERITABANı başlatıldı 

• Denetleyici ve görünümler oluşturuldu 

• Veritabanı görüntüleniyor 

Aşağıdaki öğreticide, temel CRUD (oluşturma, okuma, güncelleştirme, silme) işlemlerini nasıl gerçekleştireceğinizi 
öğreneceksiniz. 

Temel CRUD (oluşturma, okuma, güncelleştirme, silme) işlemlerini nasıl gerçekleştireceğinizi öğrenmek için sonraki 
öğreticiye ilerleyin. 

Temel CRUD işlevlerini uygulama 



Öğretici: EF Core ile CRUD İşlevselliği uygulama- 
ASPNET MVC 

11.10.2019 • 32 minutes to read^ Edit Online 


Önceki öğreticide, Entity Framevvork ve LocalDB SQL Server kullanarak verileri depolayan ve görüntüleyen bir 
MVC uygulaması oluşturdunuz. Bu öğreticide, bu CRUD (oluşturma, okuma, güncelleştirme, silme) kodunu 
inceleyerek, MVC yapı iskelesi denetleyiciler ve görünümlerde sizin için otomatik olarak oluşturulur. 


NOTE 

Denetleyiciniz ve veri erişim katmanı arasında bir soyutlama katmanı oluşturmak için depo deseninin uygulanması yaygın bir 
uygulamadır. Bu öğreticileri basit tutmak ve Entity Framevvork kendisini nasıl kullanacağınızı öğretmeniz için, depoları 
kullanmaz. EF olan depolar hakkında daha fazla bilgi için Bu serideki son öğreticiyebakın. 


Bu öğreticide şunları yaptınız: 

• Ayrıntılar sayfasını özelleştirme 

• Oluştur sayfasını Güncelleştir 

• Düzenleme sayfasını Güncelleştir 

• Silme sayfasını Güncelleştir 

• Veritabanı bağlantılarını kapat 

Önkoşullar 

• EF Core ve ASP.NET Core MVC ile çalışmaya başlama 

Ayrıntılar sayfasını özelleştirme 

Bu özellik bir koleksiyon içerdiğinden, öğrenciler dizin sayfasına yönelik scafkatlanmış kod Enroiiments özelliğini 
bıraktı. Ayrıntılar sayfasında, koleksiyonun İÇERİĞİNİ bir HTML tablosunda görüntüleyeceksiniz. 

Controllers/StudentsController. csdosyasında, Ayrıntılar görünümü için eylem yöntemi tek bir student varlığı 
almak için singieOrDefauitAsync yöntemini kullanır. @No__t-0 çağıran kodu ekleyin. Aşağıdaki Vurgulanan kodda 
gösterildiği gibi, Theninciude ve AsNoTracking yöntemleri. 










public async Task<IActionResult> Details(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var student = await _context.Students 
.Include(s => s.Enrollments) 

.Thenlnclude(e => e.Course) 

.AsNoTracking() 

. FirstOrDefaııltAsync(m => m.ID == id); 

if (student == null) 

{ 

return NotFound(); 

} 

return View(student); 

} 

@No__t-0ve Theninciude yöntemleri, bağlamın student.Enrollments gezinti özelliğini yüklemesine ve her kayıt 
için Enroiiment.course gezinti özelliğine neden olur, ilgili verileri oku öğreticisinde bu yöntemler hakkında daha 
fazla bilgi edineceksiniz. 

@No__t-0 yöntemi, döndürülen varlıkların geçerli bağlamın ömrü içinde güncellenmeyeceği senaryolarda 
performansı geliştirir. Bu öğreticinin sonunda AsNoTracking hakkında daha fazla bilgi edineceksiniz. 

Veri yönlendirme 

@No__t-0 yöntemine geçirilen anahtar değeri Rota verilerindenge\\r. Rota verileri, model cildin URL ’nin bir 
kesiminde bulduğu veriler olur. Örneğin, varsayılan yol denetleyiciyi, eylemi ve kimlik segmentlerini belirtir: 

app.UseMvc(routes => 

{ 

routes.MapRoute( 

name: "default", 

template: "{controller=Home}/{action=Index}/{id?}"); 

}); 

Aşağıdaki URL 'de, varsayılan yol eğitmeni denetleyici olarak eşler, eylem olarak dizin ve kimlik olarak 1; Bunlar 
rota veri değerleridir. 

http://localhost:1230/Instructor/Index/l?courseID=2021 

URL 'nin son bölümü ("? CourselD = 2021") bir sorgu dizesi değeridir.Model Ciltçi Ayrıca KİMLİK değerini bir 
sorgu dizesi değeri olarak geçirdiğinizde index yöntemine id parametresine geçicektir: 

http://localhost:1230/Instructor/Index?id=l&CourseID=2021 

Dizin sayfasında, bağ URL 'Leri Razor görünümündeki Tag Helper deyimleri tarafından oluşturulur.Aşağıdaki 
Razor kodunda, id parametresi varsayılan yol ile eşleşir, bu nedenle yol verilerine id eklenir. 

<a asp-action="Edit" asp-route-id="@item.ID">Edit</a> 


Bu, item.iD 6 olduğunda aşağıdaki HTML 'yi oluşturur: 















<a href="/Students/Edit/6">Edit</a> 


Aşağıdaki Razor kodunda, studentiD varsayılan rotadaki bir parametreyle eşleşmez, bu nedenle bir sorgu dizesi 
olarak eklenir. 


<a asp-action="Edit" asp-route-studentID="@item.ID">Edit</a> 


Bu, item.iD 6 olduğunda aşağıdaki HTML 'y i oluşturur: 


<a href="/Students/Edit?studentID=6">Edit</a> 


Etiket Yardımcıları hakkında daha fazla bilgi için bkz. AS P.N ET Core etiket yardımcıları. 

Ayrıntılar görünümüne kayıtları ekleyin 

Görünümleri/öğrencileri/details. cshfm/dosyasını açın. Her alan, aşağıdaki örnekte gösterildiği gibi DisplayNameFor 
ve DisplayFor yardımcıları kullanılarak görüntülenir: 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.LastName) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.LastName) 

</dd> 

Son alandan sonra ve kapanış </di> etiketinden hemen önce, kayıt listesini göstermek için aşağıdaki kodu ekleyin 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model = > model.Enrollments) 

</dt> 

<dd class="col-sm-10"> 

<table class="table"> 

<tr> 

<th>Course Title</th> 

<th>Grade</th> 

</tr> 

@foreach (var item İn Model.Enrollments) 

{ 

<tr> 

<td> 

@Html.DlsplayFor(modelItem => İtem.Course.Title) 

</td> 

<td> 

@Html.DlsplayFor(modelItem => İtem.Grade) 

</td> 

</tr> 

} 

</table> 

</dd> 


Kodu yapıştırdıktan sonra kod girintileme yanlış ise, düzeltmek için CTRL-K-D tuşlarına basın. 

Bu kod Enrollments Gezinti özelliğindeki varlıklar aracılığıyla döngü başlatır. Her kayıt için kurs başlığını ve sınıfı 
görüntüler. Kurs başlığı, kayıt varlığının course gezinti özelliğinde depolanan kurs varlığından alınır. 

Uygulamayı çalıştırın, öğrenciler sekmesini seçin ve bir öğrenci için Ayrıntılar bağlantısına tıklayın. Seçili öğrenci 
için Kurslar ve notlar listesini görürsünüz: 
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Student 


LastName Alexander 
FirstMidName Carson 
EnrolImentDate 9/1/2005 12:00:00 AM 


Enrollments 

Course Title 

Grade 


Chemistry 

A 


Microeconomics 

C 


Macroeconomics 


Oluştur sayfasını Güncelleştir 

StudentsController.es' de, birtry-catch bloğu ekleyerek ve Bind özniteliğinden kimliği kaldırarak httppost create 
yöntemini değiştirin. 

[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Create( 

[Bind("EnrolImentDate,FirstMidName,LastName")] Student student) 

{ 

try 

{ 

if (ModelState.IsValid) 

{ 

_context.Add(student); 

await _context.SaveChangesAsync(); 

return RedirectToAction(nameof(Index)); 

} 

} 

catch (DbUpdateException /* ex */) 

{ 

//Log the error (uncomment ex variable name and write a log. 

ModelState.AddModelError("", "Unable to save changes. " + 

"Try again, and if the problem persists " + 

"see your system administrator."); 

} 

return View(student); 

} 


Bu kod, AS P.N ET Core MVC model Ciltçi tarafından oluşturulan öğrenci varlığını öğrenciler varlık kümesine ekler 
ve değişiklikleri veritabanına kaydeder. (Model Ciltçi, bir form tarafından gönderilen verilerle çalışmanıza daha 
kolay hale getiren AS P.N ET Core MVC işlevselliğine başvurur; bir model Bağlayıcısı, postalanan form değerlerini 
CLR türlerine dönüştürür ve parametreleri parametreler 1 de eylem yöntemine geçirir. Bu durumda model Ciltçi, 
form koleksiyonundaki özellik değerlerini kullanarak sizin için bir öğrenci varlığı oluşturur.) 

"Satır eklendiğinde SQL Server otomatik olarak ayarlanacak birincil anahtar değeri olduğundan, Bind 













özniteliğinden id 


yı kaldırmış olursunuz. Kullanıcı girişi, KİMLİK değerini ayarladı. 


@No__t-0 özniteliği dışında, try-catch bloğu, scafkatlanmış kodda yapmış olduğunuz tek değişikdir. Değişiklikler 
kaydedilirken DbupdateException 1 dan türetilen bir özel durum yakalanmışsa, genel bir hata iletisi görüntülenir. 
DbupdateException özel durumlar bazen bir programlama hatası yerine uygulamanın harici bir şeydir, bu nedenle, 
kullanıcının yeniden denemek tavsiye edilir. Bu örnekte uygulanmamış olsa da, bir üretim kalitesi uygulaması özel 
durumu günlüğe kaydeder. Daha fazla bilgi için bkz. İzleme ve telemetri bölümünde Öngörüler İçin günlük 
(Azure İle gerçek bulut uygulamaları oluşturma). 

@No__t-0 özniteliği, siteler arası istek sahteciliği (CS RF) saldırılarını önlemeye yardımcı olur. Belirteç, 
Formtaghelper tarafından otomatik olarak görünüme eklenir ve form kullanıcı tarafından gönderildiğinde dahil 
edilir. Belirteç validateAntiForgeryToken özniteliği tarafından onaylanır. CSRF hakkında daha fazla bilgi için bkz. 
İstek önleyicigüvenlik. 


Fazla nakil hakkında güvenlik notunda 

İskele eklenen kodun create yöntemine dahil olduğu Bind özniteliği, oluşturma senaryolarında çok fazla 
gönderim için bir yoldur. Örneğin, öğrenci varlığının bu Web sayfasının ayarlamak istemediğiniz bir secret özelliği 
içerdiğini varsayalım. 


public class Student 

{ 

public int ID { get; set; } 
public string LastName { get; set; } 
public stning FirstMidName { get; set; } 
public DateTime EnrollmentDate { get; set; } 
public stning Secnet { get; set; } 

} 


Web sayfasında secnet alanı olmasa bile, bir korsan Fiddler gibi bir araç kullanabilir veya bir secnet form değeri 
göndermek için bazı JavaScript 'ler yazabilir. @No__t-0 özniteliği olmadan model cildin bir öğrenci örneği 
oluşturduğunda kullandığı alanları sınırlayarak model Ciltçi, bu secret form değerini seçer ve öğrenci varlık 
örneğini oluşturmak için onu kullanır. Daha sonra, secret form alanı için belirtilen korsanın hangi değeri 
veritabanınızda güncelleştirilemeyebilir. Aşağıdaki görüntüde, secret alanı ("OverPost" değeri ile), postalanan form 
değerlerine eklenirken Fiddler aracı gösterilmektedir. 
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ReguestHeaders 

[ Upload file... ] 

Help... 


Hoşt: localhost: 1236 

User-Agent: Mozılla/5.0 (Windows NT 6.2; W0W64; rv;22.0) Gecko/20100101 Firefox/22.0 

Accept: text/html,application/xhtml+xnnl,application/xml;q=0.9,*/*;q=0.8 

Accept-Language: en-US,en;q=0.5 

Accept-Encoding: gzip, deflate 

Referer: http://localhost: 1236/Student/Create 

Cookie:_RequestVerificatjonToken=-OqMEtdNIwFGDdjHUS_-XDoOSCqS1515g7ASzrFKiA'QPjpxRT2hN_tm6pDZbSOHVVTGMr 

Connectıon: keep-alive 

Content-Type: applicaton/x-www-fbrm-urlencoded 
Content-Length: 227 


< > 


RequestBody 

smastName=Smith8FirstMidName=Joe&EnrollmentDate=7%2F31%2F2013-Ht%3A58%3A234PPfeSecret=OverPost 


Daha sonra "OverPost" değeri, eklenen satırın secnet özelliğine başarıyla eklenir, ancak hiçbir şekilde Web 







































sayfasının bu özelliği ayarlayabilmesini amaçlayamazsınız. 

Önce veritabanından varlığı okuyup daha sonra açıkça izin verilen bir Özellikler listesine geçirerek TryUpdateModei 1 
ı çağırarak düzenleme senaryolarında fazla nakletmeyi engelleyebilirsiniz. Bu, bu öğreticilerde kullanılan yöntemidir. 

Birçok geliştirici tarafından tercih edilen aşırı nakletmeyi önlemenin alternatif bir yolu, model bağlamasıyla varlık 
sınıfları yerine görüntüleme modellerini kullanmaktır. Yalnızca görünüm modelinde güncelleştirmek istediğiniz 
özellikleri ekleyin. MVC model Bağlayıcısı tamamlandıktan sonra, görünüm modeli özelliklerini, isteğe bağlı olarak, 
Automaber gibi bir araç kullanarak varlık örneğine kopyalayın. Varlık örneğindeki _context.Entry ' ı kullanarak 
durumunu unchanged olarak ayarlayın ve ardından Görünüm modelinde bulunan her bir varlık özelliğinde 
Property("PropertyName").isModified ' yi true olarak ayarlayın. Bu yöntem hem düzenleme hem de oluşturma 
senaryolarında çalışmaktadır. 

Oluştur sayfasını test etme 

Views/öğrenciler/Create. cshtml içindeki kod, her alan için label , input ve span (doğrulama iletileri için) etiket 
yardımcıları kullanır. 

Uygulamayı çalıştırın, öğrenciler sekmesini seçin ve Yeni oluştur 1 a tıklayın. 

Ad ve tarih girin. Tarayıcınız bunu yapmanızı sağlar, geçersiz bir tarih girmeyi deneyin.(Bazı tarayıcılar bir tarih 
seçici kullanmanıza zorlar.) Hata iletisini görmek için Oluştur 1 a tıklayın. 



Bu, varsayılan olarak aldığınız sunucu tarafı doğrulamadır; sonraki bir öğreticide, istemci tarafı doğrulama için kod 
oluşturacak özniteliklerin nasıl ekleneceğini görürsünüz. Aşağıdaki Vurgulanan kodda, create yönteminde model 
doğrulama denetimi gösterilmektedir. 























[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Create( 

[Bind("EnrollmentDate,FirstMidName,LastName")] Student student) 

{ 

try 

{ 

if (ModelState.IsValid) 

{ 

_context.Add(student); 

await _context.SaveChangesAsync(); 

return RedirectToAction(nameof(Index)); 

} 

} 

catch (DbUpdateException /* ex */) 

{ 

//Log the enror (uncomment ex variable name and wnite a log. 
ModelState.AddModelErron(""j "Unable to save changes. " + 
"Try again, and if the problem persists " + 

"see your system administrator."); 

} 

return View(student); 


Tarihi geçerli bir değer olarak değiştirin ve yeni öğrencinin Dizin sayfasında göründüğünü görmek için Oluştur 1 a 
tıklayın. 


Düzenleme sayfasını Güncelleştir 

StudentController.es' de, httpget Edit yöntemi ( HttpPost özniteliği olmayan), Details yönteminde gördüğünüz 
gibi seçili öğrenci varlığını almak için singleOrDefaultAsync yöntemini kullanır. Bu yöntemi değiştirmeniz gerekmez. 

Önerilen HttpPost düzenleme kodu: okuma ve güncelleştirme 

HttpPost düzenleme eylemi yöntemini aşağıdaki kodla değiştirin. 









[HttpPost, ActionName("Edit")] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> EditPost(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var studentToUpdate = await _context.Students.FirstOrDefaultAsync(s => s.ID == id); 
if (await TryllpdateModelAsync<Student>( 
studentToUpdate, 

i 

s => s.FirstMidName, s => s.LastName, s => s.EnrollmentDate)) 

{ 

try 

{ 

await _context.SaveChangesAsync(); 
return RedirectToAction(nameof(Index)); 

} 

catch (DbUpdateException /* ex */) 

{ 

//Log the error (uncomment ex variable name and write a log.) 

ModelState.AddModelError("", "Unable to save changes. " + 

"Try again, and if the problem persists, " + 

"see your system administrator."); 

} 

} 

return View(studentToUpdate); 

} 

Bu değişiklikler, aşırı nakletmeyi engellemek için en iyi güvenlik uygulamasını uygular.Desteği bir Bind özniteliği 
üretti ve model Ciltçi tarafından oluşturulan varlığı bir Modified bayrağıyla ekledi. Bu kod pek çok senaryo için 
önerilmez çünkü Bind özniteliği inciude parametresinde listelenmeyen alanlarda önceden var olan verileri 
temizler. 

Yeni kod, mevcut varlığı okur ve alınan varlıktaki alanları, postalanan form verilerinde Kullanıcı girişine 
göregüncelleştirmek için TnyupdateModei çağırır. Entity Framevvork otomatik değişiklik izleme, form girişi tarafından 
değiştirilen alanlarda Modified bayrağını ayarlar. @No__t-0 yöntemi çağrıldığında, Entity Framevvork veritabanı 
satırını güncelleştirmek için SQL deyimleri oluşturur. Eşzamanlılık çakışmaları yok sayılır ve yalnızca Kullanıcı 
tarafından güncellenen tablo sütunları veritabanında güncelleştirilir. (Sonraki bir öğretici eşzamanlılık 
çakışmalarının nasıl işleneceğini gösterir.) 

Fazla nakletmeyi önleyen en iyi yöntem olarak, düzenleme sayfası tarafından güncelleştirilemek istediğiniz alanlar 
TryupdateModei parametrelerinde beyaz listeye alınır. (Parametre listesindeki alanlar listesinden önceki boş dize, 
form alanları adlarıyla kullanılacak bir ön ek içindir.) Şu anda koruduğunuz ek alan yok, ancak model cildin 
bağlamasını istediğiniz alanları listelemek, gelecekte veri modeline alanlar eklerseniz, bunları buraya açıkça 
eklemeene kadar otomatik olarak korunur. 

Bu değişikliklerin sonucu olarak, FlttpPost Edit yönteminin yöntem imzası, HttpGet Edit yöntemiyle aynıdır; Bu 
nedenle, EditPost metodunu yeniden adlandırdınız. 

Alternatif HttpPost düzenleme kodu: oluşturma ve iliştirme 

Önerilen HttpPost düzenleme kodu yalnızca değiştirilen sütunların güncelleştirilmesini sağlar ve model bağlama 
dahil etmek istemediğiniz özelliklerde verileri korur. Ancak, ilk okuma yaklaşımı, fazladan bir veritabanı okuması 
gerektirir ve eşzamanlılık çakışmalarını işlemek için daha karmaşık kod oluşmasına neden olabilir. Diğer bir seçenek 
de model cildi tarafından oluşturulan bir varlığı EF bağlamına eklemektir ve değiştirildi olarak işaretler. (Projenizi bu 
kodla güncelleştirmeyin, yalnızca isteğe bağlı bir yaklaşımı göstermek için gösterilir.) 













public async Task<IActionResult> Edit(int id, [Bind("ID,EnrollmentDate,FirstMidName,LastName")] Student 
student) 

{ 

if (id != student.ID) 

{ 

return NotFound(); 

} 

if (ModelState.IsValid) 

{ 

tny 

{ 

_context.Update(student); 

await _context.SaveChangesAsync(); 

return RedirectToAction(nameof(Index)); 

} 

catch (DbüpdateException /* ex */) 

{ 

//Log the error (uncomment ex variable name and write a log.) 

ModelState.AddModelError("", "Unable to save changes. " + 

"Try again, and if the problem persists, " + 

"see your system administrator."); 

} 

} 

return View(student); 

} 

Web sayfası kullanıcı arabirimi varlıktaki tüm alanları içerdiğinde ve bunlardan herhangi birini güncelleştirebilmeniz 
durumunda bu yaklaşımı kullanabilirsiniz. 

Scafkatlanmış kod, oluşturma ve iliştirme yaklaşımını kullanır, ancak yalnızca DbupdateConcurrencyException özel 
durumlarını yakalar ve 404 hata kodları döndürür. Gösterilen örnek herhangi bir veritabanı güncelleştirme özel 
durumunu yakalar ve bir hata iletisi görüntüler. 

Varlık durumları 

Veritabanı bağlamı, bellekteki varlıkların veritabanında karşılık gelen satırlarıyla eşitlenmiş olup olmadığını izler ve 
bu bilgiler Savechanges yöntemini çağırdığınızda ne olacağını belirler. Örneğin, Add yöntemine yeni bir varlık 
geçirdiğinizde, bu varlığın durumu Added olarak ayarlanır. Sonra, Savechanges yöntemini çağırdığınızda veritabanı 
bağlamı bir SQL INSERT komutu yayınlar. 

Bir varlık aşağıdaki durumlardan birinde olabilir: 

• Added . Varlık veritabanında henüz yok. @No__t-0 yöntemi bir INSERT ifadesini yayınlar. 

• unchanged . @No__t-0 yöntemiyle bu varlıkla hiçbir şeyin yapılması gerekmez. Veritabanından bir varlık 
okuduğunuzda, varlık bu durumla başlar. 

• Modified . Varlığın özellik değerlerinin bazıları veya tümü değiştirildi. @No__t-0 yöntemi bir UPDATE 
ifadesini yayınlar. 

• Deleted . Varlık silinmek üzere işaretlendi. @No__t-0 yöntemi bir DELETE ifadesini yayınlar. 

• Detached . Varlık, veritabanı bağlamı tarafından izlenmiyor. 

Bir masaüstü uygulamasında durum değişiklikleri genellikle otomatik olarak ayarlanır. Bir varlığı okur ve bazı özellik 
değerlerinde değişiklik yaparsınız. Bu, varlık durumunun otomatik olarak Modified olarak değiştirilmesine neden 
olur. @No__t-0 1 ı çağırdığınızda, Entity Framevvork yalnızca değiştirdiğiniz gerçek özellikleri güncelleştiren bir SQL 
UPDATE bildirisi oluşturur. 

Bir Web uygulamasında, ilk olarak bir varlığı okuyan DbContext ve bir sayfa işlendikten sonra düzenlenecek 
verilerini görüntüler. HttpPost Edit eylem yöntemi çağrıldığında yeni bir Web isteği yapılır ve DbContext 1 in yeni 
bir örneğine sahip olursunuz. Varlığı bu yeni bağlamda yeniden okuduğunuzda masaüstü işleme benzetimi yapılır. 















Ancak, fazladan okuma işlemi yapmak istemiyorsanız, model Ciltçi tarafından oluşturulan varlık nesnesini 
kullanmanız gerekir. Bunu yapmanın en kolay yolu, daha önce gösterilen diğer HttpPost düzenleme kodunda 
yapıldığı gibi varlık durumunun değiştirilme olarak ayarlanmanız olur. Sonra, Savechanges ' ı çağırdığınızda, bağlam 
hangi özelliklerden hangilerinin değiştirildiğini bilen bir yolu olmadığından, Entity Framework veritabanı satırının 
tüm sütunlarını günceller. 

ilk okuma yaklaşımına engel olmak istiyorsanız, ancak SQL UPDATE bildiriminin yalnızca kullanıcının gerçekten 
değiştirdiği alanları güncelleştirmesini istiyorsanız, kod daha karmaşıktır. HttpPost Edit yöntemi çağrıldığında 
kullanılabilir olmaları için özgün değerleri bir şekilde (örneğin, gizli alanları kullanarak) kaydetmeniz gerekir. 
Ardından özgün değerleri kullanarak bir öğrenci varlığı oluşturabilir, Attach yöntemini varlığın orijinal sürümüyle 
çağırabilir, varlığın değerlerini yeni değerlerle güncelleştirebilir ve ardından Savechanges ' i çağırabilirsiniz. 

Düzenleme sayfasını test etme 

Uygulamayı çalıştırın, öğrenciler sekmesini seçin ve köprü Düzenle 1 ye tıklayın. 



Contoso University 


Edit 

Student 

LastName 

Alexander 

FirstMidName 

Carson 

EnrolImentDate 

2005-09-01100:00:00.000 

Save 


Bazı verileri değiştirin ve Kaydet' e tıklayın. Dizin sayfası açılır ve değiştirilen verileri görürsünüz. 

Silme sayfasını Güncelleştir 

StudentController.es' de, httpget Delete yöntemi için şablon kodu, Ayrıntılar ve düzenleme yöntemlerinde 
gördüğünüz gibi seçili öğrenci varlığını almak için singieOrDefauitAsync yöntemini kullanır. Ancak, Savechanges 'a 
yapılan çağrı başarısız olduğunda özel bir hata iletisi uygulamak için, bu yönteme ve buna karşılık gelen görünüme 
bazı işlevler eklersiniz. 

Güncelleştirme ve oluşturma işlemleri için gördüğünüz gibi silme işlemleri için iki eylem yöntemi gerekir.GET 
isteğine yanıt olarak çağrılan yöntem, kullanıcıya silme işlemini onaylama veya iptal etme şansı veren bir görünüm 
görüntüler. Kullanıcı onu onayladığında, bir POST isteği oluşturulur. Bu durumda, HttpPost Delete yöntemi çağrılır 
ve bu yöntem aslında silme işlemini gerçekleştirir. 

Veritabanı güncelleştirilirken oluşabilecek hataları işlemek için HttpPost Delete yöntemine bir try-catch bloğu 
ekleyeceksiniz. Bir hata oluşursa, HttpPost Delete yöntemi bir hata oluştuğunu gösteren bir parametre geçirerek 

























HttpGet Delete yöntemini çağırır. HttpGet Delete yöntemi daha sonra hata iletisiyle birlikte onay sayfasını yeniden 
görüntüler ve kullanıcıya iptal etmek veya yeniden denemek için bir fırsat verir. 

HttpGet Delete eylem yöntemini aşağıdaki kodla değiştirin, bu hata raporlamayı yönetir. 

public async Task<IActionResult> Delete(int? id, bool? saveChangesError = false) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var student = await _context.Students 
.AsNoTracking() 

.FirstOrDefaultAsync(m => m.ID == id); 
if (student == null) 

{ 

return NotFound(); 

} 

if (saveChangesError.GetValueOrDefault()) 

{ 

ViewData["ErrorMessage"] = 

"Delete failed. Try again, and if the problem persists " + 

"see your system administrator. 

} 

return View(student); 

} 


Bu kod, bir yöntemin değişiklikleri kaydetme hatasından sonra döndürülüp çağrılmadığını belirten isteğe bağlı bir 
parametresini kabul eder. HttpGet Delete yöntemi önceki bir hata olmadan çağrıldığında bu parametre false 'tur. 
Bir veritabanı güncelleştirme hatasına yanıt olarak HttpPost Delete yöntemi tarafından çağrıldığında, parametresi 
true olur ve görünüme bir hata mesajı geçirilir. 

HttpPost silme için ilk okuma yaklaşımı 

HttpPost Delete eylem yöntemini ( DeleteConfirmed adlı), gerçek silme işlemini gerçekleştiren ve tüm veritabanı 
güncelleştirme hatalarını yakalayan aşağıdaki kodla değiştirin. 

[HttpPostj ActionName("Delete")] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> DeleteConfirmed(int id) 

{ 

var student = await _context.Students.FindAsync(id); 
if (student == null) 

{ 

return RedirectToAction(nameof(Index)); 

} 

try 

{ 

_context.Students.Remove(student); 
await _context.SaveChangesAsync(); 
return RedirectToAction(nameof(Index)); 

} 

catch (DbUpdateException /* ex */) 

{ 

//Log the error (uncomment ex variable name and write a log.) 

return RedirectToAction(nameof(Delete ), new { id = id, saveChangesError = true }); 

} 

} 











Bu kod seçili varlığı alır, ardından varlığın durumunu Deleted olarak ayarlamak için Remove yöntemini çağırır. 
@No__t-0 çağrıldığında, bir SQL DELETE komutu oluşturulur. 

HttpPost silme için Oluştur ve Ekle yaklaşımı 

Yüksek hacimli bir uygulamadaki performansı artırmak bir önceliktir, yalnızca birincil anahtar değerini kullanarak 
bir öğrenci varlığı oluşturarak ve ardından varlık durumunu Deleted olarak ayarlayarak gereksiz bir SQL 
sorgusundan kaçınabilirsiniz. Bu, Entity Framevvork varlığı silmek için ihtiyaç duymaktadır.(Bu kodu projenize 
yerleştirmeyin; bir alternatif göstermek de yeterlidir.) 

[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> DeleteConfirmed(int id) 

{ 

try 

{ 

Student studentToDelete = new Student() { ID = id }; 

_context.Entry(studentToDelete).State = EntityState.Deletedj 
await _context.SaveChangesAsync(); 
return RedirectToAction(nameof(Index)); 

} 

catch (DbUpdateException /* ex */) 

{ 

//Log the error (uncomment ex variable name and write a log.) 

return RedirectToAction(nameof(Delete), new { id = id, saveChangesError = true }); 

} 

} 


Varlığın de silinmesi gereken ilgili veriler varsa, veritabanında Cascade silmenin yapılandırıldığından emin olun. 
Varlık silme yaklaşımıyla EF, silinecek ilgili varlıkların olduğunu fark etmeyebilir. 

Silme görünümünü Güncelleştir 

Görünümler/öğrenci/delete. cshtml' de, aşağıdaki örnekte gösterildiği gibi, H2 başlığı ve H3 başlığı arasına bir hata 
iletisi ekleyin: 

<h2>Delete</h2> 

<p class="text-danger">@ViewData["ErrorMessage"]</p> 

<h3>Are you sure you want to delete this?</h3> 


Uygulamayı çalıştırın, öğrenciler sekmesini seçin ve bir Delete köprüsüne tıklayın: 









Sil'e tıklayın. Dizin sayfası, silinen öğrenci olmadan görüntülenir.(Eşzamanlılık öğreticisinde işlem içinde kodu 
işleme hatası hakkında bir örnek görürsünüz.) 

Veritabanı bağlantılarını kapat 

Bir veritabanı bağlantısının tuttuğu kaynakları boşaltmak için bağlam örneği, bununla işiniz bittiğinde en kısa 
sürede atılmalıdır. AS P.N ET Core yerleşik bağımlılık ekleme , sizin için bu görevi gerçekleştirir. 

Startup.es, DbContext S 1 N 1 F 1 N 1 ASP.NET Core dı kapsayıcısında sağlamak İçin adddbcontext genişletme yöntemini 
çağırın. Bu yöntem, hizmet ömrünü varsayılan olarak scoped olarak ayarlar, scoped , Web isteği yaşam süresi ile 
saatle çakışan bağlam nesnesi ömrünü gösterir ve Web isteğinin sonunda Dispose yöntemi otomatik olarak 
çağrılır. 

İşlemleri işle 

Entity Framevvork, varsayılan olarak işlemleri örtülü olarak uygular. Birden çok satır veya tabloda değişiklik 
yaptığınız ve sonra Savechanges 1 ı çağıran senaryolarda, Entity Framework otomatik olarak tüm değişikliklerinizin 
başarılı olduğundan veya tümünün başarısız olduğundan emin olur. Önce bazı değişiklikler yapıldıktan sonra bir 
hata oluşursa, bu değişiklikler otomatik olarak geri alınır. Daha fazla denetime ihtiyacınız olan senaryolar için— 
örneğin, işlem içinde Entity Framevvork dışında yapılan işlemleri eklemek istiyorsanız, bkz. işlemler. 

İzleme sorguları yok 

Bir veritabanı bağlamı tablo satırları aldığında ve bunları temsil eden varlık nesneleri oluşturduğunda, varsayılan 
olarak, bellekteki varlıkların veritabanında bulunan verilerle eşitlenmiş olup olmadığını izler. Bellekteki veriler 
önbellek olarak davranır ve bir varlığı güncelleştirdiğinizde kullanılır. Bağlam örnekleri genellikle kısa süreli 
olduğundan (her istek için yeni bir tane oluşturulup bırakıldığı) ve bir varlığı okuyan bağlam genellikle bu varlık 
yeniden kullanılmadan önce atıldığından, bu önbelleğe alma işlemi bir Web uygulamasında genellikle gereksizdir. 

@No__t-0 yöntemini çağırarak bellekte varlık nesnelerinin izlenmesini devre dışı bırakabilirsiniz. Bunu yapmak 
isteyebileceğiniz tipik senaryolar şunlardır: 













• Bağlam ömrü boyunca herhangi bir varlığı güncelleştirmeniz gerekmez ve ayrı sorgular tarafından alınan 
varlıklarla birlikte gezinti özelliklerini otomatik olarak yüklemekiçin EF 'e ihtiyacınız yoktur. Bu koşullar 
genellikle denetleyicinin FlttpGet eylem yöntemlerinde karşılanır. 

• Büyük miktarda veri alan bir sorgu çalıştırıyorsunuz ve döndürülen verilerin yalnızca küçük bir kısmı 
güncelleştiriliyor. Büyük sorgu için izlemeyi devre dışı bırakmak ve daha sonra güncellenmesi gereken birkaç 
varlık için bir sorgu çalıştırmak daha verimli olabilir. 

• Bir varlığı güncelleştirmek için eklemek istiyorsunuz, ancak daha önce farklı bir amaç için aynı varlığı elde 
edersiniz. Varlık veritabanı bağlamı tarafından zaten izlenmekte olduğundan, değiştirmek istediğiniz varlığı 
iliştiremiyoruz. Bu durumu işlemenin bir yolu, önceki sorgudaki AsNoTracking öğesini çağırmanız olur. 

Daha fazla bilgi için bkz. izleme vs. 

Kodu edinin 

Tamamlanmış uygulamayı indirin veya görüntüleyin. 

Sonraki adımlar 

Bu öğreticide şunları yaptınız: 

• Ayrıntılar sayfası özelleştirildi 

• Oluşturma sayfası güncelleştirildi 

• Düzenleme sayfası güncelleştirildi 

• Silme sayfası güncelleştirildi 

• Kapalı veritabanı bağlantıları 

Sıralama, filtreleme ve sayfalama ekleyerek Dizin sayfasının işlevselliğini genişletmeyi öğrenmek için sonraki 

öğreticiye ilerleyin. 

Sonraki: sıralama, filtreleme ve sayfalama 



Öğretici: EF Core sıralama, filtreleme ve sayfalama- 
ASPNET MVC ekleme 

23.11.2019 * 21 minutes to read ı Edit Online 


Önceki öğreticide, öğrenci varlıkları için temel CRUD işlemleri için bir dizi Web sayfası uyguladık. Bu öğreticide, 
öğrenciler dizin sayfasına sıralama, filtreleme ve sayfalama işlevselliği ekleyeceksiniz. Ayrıca basit gruplandırma 
yapan bir sayfa oluşturacaksınız. 

Aşağıdaki çizimde, işiniz bittiğinde sayfanın nasıl görüneceği gösterilmektedir.Sütun başlıkları, kullanıcının sütuna 
göre sıralamak için tıkladığı bağlantılardır. Sütun başlığına tıklanması artan ve azalan sıralama düzeni arasında 
sürekli olarak geçiş yapar. 


H lrıdex - Contoso Univer; X + 

(J) localhost:5313/Student 


Contoso University 


lndex 

Create New 

Find by name: 


X 


☆ “ 


Search | Back to Full List 


Last Name 

First Name 

Enrollment Date 


Alexander 

Carson 

9/1/2005 12:00:00 AM 

Edit | Details | Delete 

Alonso 

Meredith 

9/1/2002 12:00:00 AM 

Edit | Details | Delete 

Anand 

Arturo 

9/1/2003 12:00:00 AM 

Edit | Details | Delete 

Previous 

Next 
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Bu öğreticide şunları yaptınız: 

• Sütun sıralama bağlantıları Ekle 

• Arama kutusu ekleme 

• Öğrenciler dizinine sayfalama ekleme 

• Dizin yöntemine sayfalama ekleme 

• Sayfalama bağlantıları Ekle 

• Hakkında bir sayfa oluşturun 

Önkoşullar 

• CRUD İşlevlerini uygulama 

Sütun sıralama bağlantıları Ekle 

Öğrenci dizini sayfasına sıralama eklemek için, öğrenciler denetleyicisinin index yöntemini değiştirecek ve öğrenci 












dizini görünümüne kod ekleyeceksiniz. 


Dizin yöntemine sıralama İşlevi ekleme 

StudentsController.es' de index yöntemini aşağıdaki kodla değiştirin: 

public async Task<IActionResult> Index(string sortOrder) 

{ 

ViewData["NameSortParm"] = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 

ViewData["DateSortParm"] = sortOrder == "Date" ? "date_desc" : "Date"; 
var students = from s in _context.Students 
select s; 

switch (sortOrder) 

{ 

case "name_desc": 

students = students.OrderByDescending(s => s.LastName); 
break; 

case "Date": 

students = students.OrderBy(s => s.EnrollmentDate); 
break; 

case "date_desc": 

students = students.OrderByDescending(s => s.EnrollmentDate); 
break; 
default: 

students = students.OrderBy(s => s.LastName); 
break; 

} 

return View(await students.AsNoTracking().ToListAsync()); 

} 

Bu kod, URL 'deki sorgu dizesinden bir sortOrder parametresi alır. Sorgu dizesi değeri, ASP.NET Core MVC 
tarafından eylem yöntemine bir parametre olarak sağlanır. Parametresi, "Name" veya "Date" adlı bir dize, isteğe 
bağlı olarak bir alt çizgi ve azalan sıralama belirtmek için "dese" dizesi olacaktır. Varsayılan sıralama düzeni artan. 

Dizin sayfası ilk kez istendiğinde sorgu dizesi yoktur.Öğrenciler, son ada göre artan sırada görüntülenir, bu, switch 
deyimindeki karşı bir durum tarafından kurulduğu varsayılan değer olan addır. Kullanıcı bir sütun başlığı köprüsüne 
tıkladığında, sorgu dizesinde uygun sortOrder değeri sağlanır. 

iki viewData öğesi (Namesortpara ve Datesortpard), sütun başlığı köprülerini uygun sorgu dizesi değerleriyle 
yapılandırmak için görünüm tarafından kullanılır. 










public async Task<IActionResult> Index(string sortOrder) 

{ 

ViewData["NameSortParm"] = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 

ViewData["DateSortParm"] = sortOrder == "Date" ? "date_desc" : "Date"; 
var students = from s in _context.Students 
select s; 

switch (sortOrder) 

{ 

case "name_desc": 

students = students.OrderByDescending(s => s.LastName); 
break; 

case "Date": 

students = students.OrderBy(s => s.EnrollmentOate); 
break; 

case "date_desc": 

students = students.OrderByDescending(s => s.EnrollmentDate); 
break; 
default: 

students = students.OrderBy(s => s.LastName); 
break; 

} 

return View(await students.AsNoTracking().ToListAsync()); 

} 

Bunlar Üçlü ifadelerdir.ilki sortOrder parametresi null veya boş ise, Namesortparı 'nin "name_desc" olarak 
ayarlanması gerektiğini belirtir; Aksi takdirde, boş bir dizeye ayarlanmalıdır. Bu iki deyim, görünümün sütun başlığı 
köprülerini şu şekilde ayarlamaya olanak tanır: 


GEÇERLİ SIRALAMA DÜZENİ 

SON AD KÖPRÜSÜ 

TARİH KÖPRÜSÜ 

Artan son ad 

descending 

ascending 

Azalan son ad 

ascending 

ascending 

Artan Tarih 

ascending 

descending 

Azalan Tarih 

ascending 

ascending 


Yöntemi, sıralama yapılacak sütunu belirtmek için LINQ to Entities kullanır. Kod, Svvitch ifadesinden önce bir 
ıçueryabie değişkeni oluşturur, Svvitch ifadesinde değiştirir ve switch deyimden sonra ToListAsync yöntemini 
çağırır. ıçueryabie değişkenleri oluşturup değiştirirken veritabanına hiçbir sorgu gönderilmez. Sorgu, ToListAsync 
gibi bir yöntemi çağırarak ıçueryabie nesnesini bir koleksiyona dönüştürene kadar yürütülmez. Bu nedenle, bu 
kod return view ifadeye kadar Yürütülmeyen tek bir sorgu ile sonuçlanır. 

Bu kod çok sayıda sütunla ayrıntı alabilir. Bu serideki son öğretici , bir dize değişkeninde orderBy sütununun adını 
geçirmenize olanak sağlayan kodun nasıl yazılacağını gösterir. 

Öğrenci dizini görünümüne sütun başlığı köprüleri ekleme 

Görüınüımler/öğrenciler/lndex. cs/ıfm/içindeki kodu, sütun başlığı köprüleri eklemek için aşağıdaki kodla değiştirin. 
Değiştirilen çizgiler vurgulanır. 















@model IEnumerablecContosoUniversity.Models.Student> 

@{ 

ViewData["Title"] = "Index"; 

} 

<h2>Index</h2> 

<P> 

<a asp-action="Create">Create New</a> 

</p> 

ctable class="table"> 

<thead> 

<tr> 

<th> 

<a asp-action="Index" asp-route- 

sortOrder="@ViewData["NameSortParm"]">@Html.DisplayNameFor(model => model.LastName)</a> 

</th> 

<th> 

@Html.DisplayNameFor(model => model.FirstMidName) 

</th> 

<th> 

<a asp-action="Index" asp-route- 

sortOrder="@ViewData["DateSortParm"]">@Html.DisplayNameFor(model => model.EnrollmentDate)</a> 
</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

(Şforeach (var item in Model) { 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item. LastName) 

</td> 

<td> 

@Fltml.DisplayFor(modelItem => item.FirstMidName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.EnrollmentDate) 

</td> 

<td> 

<a asp-action="Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-action="Details" asp-route-id="@item.ID">Details</a> | 

<a asp-action="Delete" asp-route-id="@item.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 


Bu kod, uygun sorgu dizesi değerleriyle köprüler ayarlamak için viewData özelliklerindeki bilgileri kullanır. 

Uygulamayı çalıştırın, öğrenciler sekmesini seçin ve sıralamanın çalıştığını doğrulamak İçin son ad ve kayıt tarihi 
sütun başlıklarına tıklayın. 
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Arama kutusu ekleme 

Öğrenciler dizin sayfasına filtre eklemek için, görünüme bir metin kutusu ve Gönder düğmesi ekleyeceksiniz ve 
index yönteminde ilgili değişiklikleri yapmanız gerekir. Metin kutusu, ilk adı ve soyadı alanlarını aramak için bir 
dize girmenizi sağlar. 

Dizin yöntemine filtreleme işlevi ekleme 

StudentsController.es' de index yöntemini aşağıdaki kodla değiştirin (değişiklikler vurgulanır). 


public async Task<IActionResult> Index(string sortOrder, string searchString) 

{ 

ViewData["NameSortParm"] = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 
ViewData["DateSortParm"] = sortOrder == "Date" ? "date_desc" : "Date"; 
ViewData["CurrentFilter"] = searchString; 

var students = from s in _context.Students 
select s; 

if (!String.IsNullOrEmpty(searchString)) 

{ 

students = students.Where(s => s.LastName.Contains(searchString) 

| s.FirstMidName.Contains(searchString)); 

} 

switch (sortOrder) 

{ 

case "name_desc": 

students = students.OrderByDescending(s => s.LastName); 
break; 

case "Date": 

students = students.OrderBy(s => s.EnrollmentDate); 
break; 

case "date_desc": 

students = students.OrderByDescending(s => s.EnrollmentDate); 
break; 
default: 

students = students.OrderBy(s => s.LastName); 
break; 

} 

return View(await students.AsNoTracking().ToListAsync()); 

} 










index yöntemine bir searchstring parametresi eklediniz. Arama dizesi değeri, dizin görünümüne ekleyeceğiniz bir 
metin kutusundan alınır. Ayrıca, yalnızca adı veya soyadı arama dizesini içeren öğrencileri seçen bir vvhere yan 
tümcesine LINQ deyimi de eklediniz. VVHERE yan tümcesini ekleyen deyimi, yalnızca aranacak bir değer varsa 
yürütülür. 


NOTE 

Burada where yöntemi bir ıçueryable nesnesi üzerinde arıyorsanız ve filtrenin sunucuda işlenmesi gerekir. Bazı 
senaryolarda, bellek içi bir koleksiyonda where yöntemini genişletme yöntemi olarak çağırma olabilirsiniz. (Örneğin, 

_context. students başvurusunu, bir Dbset EF yerine bir iEnumerable koleksiyonu döndüren bir depo yöntemine 
başvurduğu gibi) değiştirdiğinizi varsayın.) Sonuç normalde aynı olur, ancak bazı durumlarda farklı olabilir. 

Örneğin, contains yönteminin .NET Framevvork uygulanması, varsayılan olarak büyük/küçük harfe duyarlı bir karşılaştırma 
gerçekleştirir, ancak SQL Server' de SQL Server örneğinin harmanlama ayarı tarafından belirlenir. Bu ayar varsayılan olarak 
büyük/küçük harfe duyarsız olur. Testi açıkça büyük/küçük harfe duyarsız hale getirmek için ToUpper yöntemini 
çağırabilirsiniz: burada (s => s. LastName. ToUpper 0. Contains (searchString. ToUpper 0) . Bu, kodu daha sonra bir 
ıçueryable nesnesi yerine iEnumerable koleksiyonu döndüren bir depoyu kullanacak şekilde değiştirirseniz sonuçların aynı 
kalmasını sağlar. (Bir iEnumerable koleksiyonunda contains yöntemini çağırdığınızda .NET Framevvork uygulamasını 
alırsınız; bunu bir ıçueryable nesnesi üzerinde çağırdığınızda, veritabanı sağlayıcısı uygulamasını alırsınız.) Ancak, bu çözüm 
için bir performans cezası vardır. ToUpper kodu, TSQL SELECT ifadesinin VVHERE yan tümcesine bir işlev koyar. Bu, 
iyileştiricinin bir dizin kullanmasını engelleyecek. SQL 'in çoğu büyük küçük harfe duyarsız olarak yüklendiği için, büyük/küçük 
harfe duyarlı bir veri deposuna geçiş yapılıncaya kadar ToUpper koddan kaçınmak en iyisidir. 


Öğrenci dizini görünümüne arama kutusu ekleme 

Görünümler/öğrenci/lndex. cshtml'de, bir başlık, metin kutusu ve bir arama düğmesi oluşturmak için, açılan tablo 
etiketinden hemen önce vurgulanan kodu ekleyin. 

<p> 

<a asp-action="Create">Create New</a> 

</p> 

<form asp-action="Index" method="get"> 

<div class="form-actions no-color"> 

<P> 

Find by name: cinput type="text" name="SearchString" value="@ViewData["currentFilter"]" /> 

<input type="submit" value="Search" class="btn btn-default" /> | 

<a asp-action="Index">Back to Full List</a> 

</p> 

</div> 

</form> 

ctable class="table"> 

Bu kod, arama metin kutusu ve düğmesini eklemek için <form> Tag yardımcısını kullanır. Varsayılan olarak, <form> 
etiketi Yardımcısı, form verilerini bir GÖN DERİYLE gönderir, yani Parametreler, URL 'de sorgu dizeleri olarak değil, 
HTTP ileti gövdesinde geçirilir. HTTP GET belirttiğinizde, form verileri URL 'ye sorgu dizeleri olarak geçirilir ve bu 
da kullanıcıların URL 'yeyer işareti eklemesini sağlar. W3C yönergeleri, eylem bir güncelleştirme ile sonuçlanmazsa 
Al ' ın kullanılması önerilir. 

Uygulamayı çalıştırın, öğrenciler sekmesini seçin, bir arama dizesi girin ve filtreleme ’nin çalıştığını doğrulamak 
için ara ' ya tıklayın. 
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URL ‘nin arama dizesini içerdiğine dikkat edin. 


http://localhost:5813/Students?SearchString=an 

Bu sayfaya yer işareti eklerseniz, yer işaretini kullandığınızda filtrelenmiş listeyi alırsınız, form etiketine 
method="get" eklemek, sorgu dizesinin oluşturulmasına neden olur. 

Bu aşamada, bir sütun başlığı sıralama bağlantısını tıklatırsanız, arama kutusuna girdiğiniz filtre değerini 
kaybedersiniz. Sonraki bölümde bunu çözeceksiniz. 


Öğrenciler dizinine sayfalama ekleme 

Öğrenciler dizin sayfasına sayfalama eklemek için, skip ve Take deyimlerini kullanan bir PaginatedList sınıfı 
tablodaki verileri her zaman almak yerine, sunucuda filtrelemek için oluşturacaksınız. Daha sonra index 
yönteminde ek değişiklikler yapar ve index görünümüne sayfalama düğmeleri eklersiniz. Aşağıdaki çizimde 
sayfalama düğmeleri gösterilmektedir. 












Proje klasöründe PaginatedList.es oluşturun ve ardından şablon kodunu aşağıdaki kodla değiştirin. 












using System; 

using System.Collections.Generic; 
using System.Linq; 
using System.Threading.Tasks; 
using Microsoft.EntityFrameworkCore; 

namespace ContosoUniversity 

{ 

public class PaginatedList<T> : List<T> 

{ 

public int Pagelndex { get; private set; } 
public int TotalPages { get; private set; } 

public PaginatedList(List<T> items, int count, int pagelndex, int pageSize) 

{ 

Pagelndex = pagelndex; 

TotalPages = (int)Math.Ceiling(count / (double)pageSize); 
this.AddRange(items); 

} 

public bool HasPreviousPage 

{ 

get 

{ 

return (Pagelndex > 1); 

} 

} 

public bool HasNextPage 

{ 

get 

{ 

return (Pagelndex < TotalPages); 

} 

} 

public static async Task<PaginatedList<T>> CreateAsync(IQueryable<T> source, int pagelndex, int 
pageSize) 

{ 

var count = await source.CountAsync(); 

var items = await source.Skip((pageIndex - 1) * pageSize).Take(pageSize).ToListAsync(); 
return new PaginatedList<T>(items, count, pagelndex, pageSize); 

} 

} 

} 

Bu koddaki createAsync yöntemi sayfa boyutunu ve sayfa numarasını alır ve uygun skip ve Take deyimlerini 


IQueryable uygular. 

IQueryable'' 

ToListAsync 

çağrıldığında, yalnızca istenen sayfayı içeren bir liste döndürür. 

HasPreviousPage 

ve 

HasNextPage 

özellikleri, önceki ve sonraki sayfalama düğmelerini etkinleştirmek veya devre 


dışı bırakmak için kullanılabilir. 

Oluşturucular zaman uyumsuz kod çalıştıramadığından PaginatedList<T> nesnesini oluşturmak için bir Oluşturucu 
yerine bir CreateAsync yöntemi kullanılır. 

Dizin yöntemine sayfalama ekleme 

StudentsController.es' de index yöntemini aşağıdaki kodla değiştirin. 









public async Task<IActionResult> Index( 
string sortOrder, 
string currentFilter, 
string searchString, 
int? pageNumber) 

{ 

ViewData["CurrentSort"] = sortOrder; 

ViewData["NameSortParm"] = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 

ViewData["DateSortParm"] = sortOrder == "Date" ? "date_desc" : "Date"; 

if (searchString != null) 

{ 

pageNumber = 1; 

} 

else 

{ 

searchString = currentFilter; 

} 

ViewData["CurrentFilter"] = searchString; 

var students = from s in _context.Students 
select s; 

if (!String.IsNullOrEmpty(searchString)) 

{ 

students = students.Where(s => s.LastName.Contains(searchString) 

| s.FirstMidName.Contains(searchString)); 

} 

switch (sortOrder) 

{ 

case "name_desc": 

students = students.OrderByDescending(s => s.LastName); 
break; 

case "Date": 

students = students.OrderBy(s => s.EnrollmentDate); 
break; 

case "date_desc": 

students = students.OrderByDescending(s => s.EnrollmentDate); 
break; 
default: 

students = students.OrderBy(s => s.LastName); 
break; 

} 

int pageSize = 3; 

return View(await PaginatedList<Student>.CreateAsync(students.AsNoTracking(), pageNumber ?? 1, pageSize)); 


Bu kod, bir sayfa numarası parametresi, geçerli bir sıralama düzeni parametresi ve Yöntem imzasına geçerli bir filtre 
parametresi ekler. 

public async Task<IActionResult> Index( 
string sortOrder, 
string currentFilter, 
string searchString, 
int? pageNumber) 


Sayfa ilk kez görüntülenirken veya Kullanıcı bir sayfalama veya sıralama bağlantısına tıklamamışsa, tüm 
parametreler null olur. Bir sayfalama bağlantısına tıklandıysanız, sayfa değişkeni görüntülenecek sayfa numarasını 
içerir. 

CurrentSort adlı viewData öğesi, sayfalama bağlantılarına dahil edilmesi gerektiğinden, bu sıralama düzeni geçerli 
sıralama düzeni ile birlikte sağlar. 





CurrentFilter adlı viewData öğesi, geçerli filtre dizesiyle görünüm sağlar. Bu değer, disk belleği sırasında filtre 
ayarlarını korumak için disk belleği bağlantılarına dahil olmalıdır ve sayfa yeniden görüntülenirken metin kutusuna 
geri yüklenmesi gerekir. 

Arama dizesi sayfalama sırasında değiştirilmişse, yeni filtre farklı verilerin görüntülenmesini sağladığından sayfanın 
1 olarak sıfırlanması gerekir. Metin kutusuna bir değer girildiğinde ve Gönder düğmesine basıldığında arama dizesi 
değişir. Bu durumda searchstring parametresi null değildir. 

if (searchstring != null) 

{ 

pageNumber = 1 ; 

} 

else 

{ 

searchstring = CurrentFilter; 

} 

index yönteminin sonunda, PaginatedList.createAsync yöntemi öğrenci sorgusunu, sayfalama destekleyen bir 
koleksiyon türünde tek bir öğrenciye dönüştürür. Bu tek bir öğrenci sayfası daha sonra görünüme geçirilir. 

return View(await PaginatedList<Student>.CreateAsync(students.AsNoTracking(), pageNumber ?? 1 , pageSize)); 

PaginatedList.createAsync yöntemi bir sayfa numarası alır, iki soru işareti, null birleşim işlecini temsil eder.Null 
birleşim işleci, Nullable bir tür için varsayılan değeri tanımlar; (pageNumber ?? i) ifadesi bir değere sahipse 
pageNumber değerini döndürür veya pageNumber null ise 1 döndürür. 

Sayfalama bağlantıları Ekle 

Görüınümler/öğrenciler/lndex. cshtml'de, mevcut kodu aşağıdaki kodla değiştirin. Değişiklikler vurgulanır. 

@model PaginatedListcContosolIniversity.Models.Student> 

@{ 

ViewData["Title"] = "Index"; 

} 

<h2>Index</h2> 

<P> 

<a asp-action="Create">Create New</a> 

</p> 

<form asp-action="Index" method="get"> 

<div class="form-actions no-color"> 

<P> 

Find by name: <input type="text" name="SearchString" value="@ViewData["CurrentFilter"]" /> 

<input type="submit" value="Search" class="btn btn-default" /> | 

<a asp-action="Index">Back to Full List</a> 

</p> 

</div> 

</form> 

ctable class="table"> 

<thead> 

<tr> 

<th> 

<a asp-action="Index" asp-route-sortOrder="@ViewData["NameSortParm"]" asp-route- 
currentFilter="@ViewData["CurrentFilter"]">Last Name</a> 

</th> 

<th> 

Cınet Mama 












</th> 

<th> 


<a asp-action="Index" asp-route-sortOrder="@ViewData["DateSortParm"]" asp-route- 
currentFilter="@ViewData["CurrentFilter"]">Enrollment Date</a> 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

(Şforeach (var item in Model) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.LastName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.FirstMidName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.EnrollmentDate) 

</td> 

<td> 

<a asp-action="Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-action="Details" asp-route-id="@item.ID">Details</a> | 

<a asp-action="Delete" asp-route-id="@item.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 


var prevDisabled = !Model.HasPreviousPage ? "disabled" : 
var nextDisabled = !Model.HasNextPage ? "disabled" : 

} 

<a asp-action="Index" 

asp-route-sortOrder="@ViewData["CurrentSort"]" 
asp-route-pageNumber="@(Model.PageIndex - 1)" 
asp-route-currentFilter="@ViewData["CurrentFilter"]" 
class="btn btn-default @prevDisabled"> 

Previous 

</a> 

<a asp-action="Index" 

asp-route-sortOrder="@ViewData["CurrentSort"]" 
asp-route-pageNumber="@(Model.PageIndex + 1)" 
asp-route-currentFilter="@ViewData["CurrentFilter"]" 
class="btn btn-default @nextDisabled"> 

Next 

</a> 


Sayfanın üst kısmındaki @modei ifade, görünümün artık List<T> nesnesi yerine PaginatedList<T> bir nesne 
aldığından emin olarak belirtir. 

Sütun üst bilgisi bağlantıları, kullanıcının filtre sonuçları içinde sıralama yapabilmesi için geçerli arama dizesini 
denetleyiciye geçirmek için sorgu dizesini kullanır: 


<a asp-action="Index" asp-route-sortOrder="@ViewData["DateSortParm"]" asp-route-currentFilter 
="@ViewData["CurrentFilter"]">Enrollment Date</a> 


Sayfalama düğmeleri etiket yardımcıları tarafından görüntülenir: 







<a asp-action="Index" 

asp-r'oute-sortOrden="@Vİ 0 wData["CurrentSort"]" 
asp-route-pageNumber="@(Model.Pagelndex - 1)" 
asp-route-cunrentFilter="@ViewData["CunrentFilter"]" 
class="btn btn-default @prevDisabled"> 

Previous 

</a> 

Uygulamayı çalıştırın ve öğrenciler sayfasına gidin. 



Disk belleğinin çalıştığından emin olmak için farklı sıralama emirlerindeki disk belleği bağlantılarına tıklayın. Daha 
sonra bir arama dizesi girin ve sayfalama ve filtreleme ile doğru şekilde çalıştığını doğrulamak için sayfalama işlem 
yeniden deneyin. 

Hakkında bir sayfa oluşturun 

Contoso Üniversitesi web sitesinin hakkında sayfasında, her bir kayıt tarihi için kaç öğrenciye kaydolduğunu 
görüntüleyeceksiniz. Bu, gruplar üzerinde gruplandırma ve basit hesaplamalar gerektirir. Bunu gerçekleştirmek için 
aşağıdakileri yapmanız gerekir: 

• Görünüme geçirmeniz gereken veriler için bir görünüm modeli sınıfı oluşturun. 

• Giriş denetleyicisinde hakkında yöntemini oluşturun. 

• Hakkında görünümünü oluşturun. 

Görünüm modeli oluşturma 

Modeller klasöründe bir SchoolViewModels klasörü oluşturun. 

Yeni klasörde, EnrollmentDateGroup.es bir sınıf dosyası ekleyin ve şablon kodunu şu kodla değiştirin: 














using System; 

using System.ComponentModel.DataAnnotations; 

namespace ContosoUniversity.Models.SchoolViewModels 

{ 

public class EnrollmentDateGroup 

{ 

[DataType(DataType.Date) ] 

public DateTime? EnrollmentDate { get; set; } 
public int StudentCount { get; set; } 

} 

} 


Ana denetleyiciyi değiştirme 

HomeController.es' de, aşağıdaki using deyimlerini dosyanın en üstüne ekleyin: 

using Microsoft.EntityFrameworkCore; 
using ContosoUniversity.Data; 

using ContosoUniversity.Models.SchoolViewModels; 


Sınıf için açma küme ayracından hemen sonra veritabanı bağlamı için bir sınıf değişkeni ekleyin ve ASP.NET Core 
Dİ 'den bağlamın bir örneğini alın: 

public class HomeController : Controller 

{ 

private readonly SchoolContext _context; 

public HomeController(SchoolContext context) 

{ 

_context = context; 

} 

Aşağıdaki kodla bir About yöntemi ekleyin: 

public async Task<ActionResult> About() 

{ 

IQueryable<EnrollmentDateGroup> data = 
from student in _context.Students 

group student by student.EnrollmentDate into dateGroup 
select new EnrollmentDateGroup() 

{ 

EnrollmentDate = dateGroup.Key, 

StudentCount = dateGroup.Count() 

}; 

return View(await data.AsNoTracking().ToListAsync()); 

} 


LINQ deyimleri, öğrenci varlıklarını kayıt tarihine göre gruplandırır, her bir gruptaki varlıkların sayısını hesaplar ve 
sonuçları bir EnroiimentDateGroup Vievv model nesneleri koleksiyonunda depolar. 

Hakkında görünüm oluştur 

Aşağıdaki kodla bir Görünümler/Home/about. cshtml dosyası ekleyin: 








@model IEnumerablecContosoUniversity.Models.SchoolViewModels.EnrollmentDateGroup> 
@{ 

ViewData["Title"] = "Student Body Statistics"; 

} 

<h2>Student Body Statistics</h2> 

<table> 

<tr> 

<th> 

Enrollment Date 
</th> 

<th> 

Students 

</th> 

</tn> 

(Şforeach (var item in Model) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.EnrollmentDate) 

</td> 

<td> 

(Şitem.StudentCount 

</td> 

</tr> 

} 

</table> 


Uygulamayı çalıştırın ve hakkında sayfasına gidin. Her kayıt tarihi için öğrenci sayısı bir tabloda görüntülenir. 

Kodu alın 

Tamamlanmış uygulamayı indirin veya görüntüleyin. 

Sonraki adımlar 

Bu öğreticide şunları yaptınız: 

• Sütun sıralama bağlantıları eklendi 

• Arama kutusu eklendi 

• Öğrenciler dizinine sayfalama eklendi 

• Dizin oluşturma yöntemine sayfalama eklendi 

• Sayfalama bağlantıları eklendi 

• Hakkında bir sayfa oluşturuldu 

Geçiş kullanarak veri modeli değişikliklerini nasıl işleyebileceğinizi öğrenmek için sonraki öğreticiye ilerleyin. 
Sonraki: veri modeli değişikliklerini İşle 



Öğretici: EF Core ile geçiş özelliğini kullanma-ASPNET 
MVC 
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Bu öğreticide, veri modeli değişikliklerini yönetmek için EF Core geçişleri özelliğini kullanmaya başlayabilirsiniz. 
Sonraki öğreticilerde, veri modelini değiştirirken daha fazla geçiş ekleyeceksiniz. 

Bu öğreticide şunları yaptınız: 

• Geçişler hakkında bilgi edinin 

• Bağlantı dizesini değiştirme 

• ilk geçiş oluşturma 

• Yukarı ve aşağı yöntemleri inceleyin 

• Veri modeli anlık görüntüsü hakkında bilgi edinin 

• Geçişi Uygula 

Önkoşullar 

• Sıralama, filtreleme ve sayfalama 

Geçişler hakkında 

Yeni bir uygulama geliştirirken, veri modeliniz sıklıkla değişir ve model her değiştiğinde veritabanıyla eşitlenmemiş 
olur. Mevcut değilse veritabanını oluşturmak için Entity Framework yapılandırarak bu öğreticileri başlatmış 
olursunuz. Veri modelini her değiştirdiğinizde (varlık sınıfları ekleyin, kaldırın veya değiştirin ya da DbContext 
sınıfınızı değiştirin); veritabanını silebilir ve EF, modelle eşleşen yeni bir tane oluşturur ve test verileriyle birlikte olur. 

Veritabanını veri modeliyle eşitlenmiş halde tutma yöntemi, uygulamayı üretime dağıtana kadar iyi çalışır. 

Uygulama üretimde çalışırken, genellikle tutmak istediğiniz verileri saklar ve yeni sütun ekleme gibi her değişiklik 
yaptığınızda her şeyi kaybetmek istemezsiniz. EF Core geçişleri özelliği, yeni bir veritabanı oluşturmak yerine EF 'in 
veritabanı şemasını güncelleştirmesine olanak sağlayarak bu sorunu çözer. 

Geçişlerle çalışmak için Paket Yöneticisi konsolu 'nu (PMC) veya komut satırı ARABİRİMİNİ (CLI) 
kullanabilirsiniz. Bu öğreticiler CLı komutlarının nasıl kullanılacağını göstermektedir.PMC hakkındaki bilgiler Bu 

öğreticinin sonunda. 

Bağlantı dizesini değiştirme 

AppSettings. JSON dosyasında, bağlantı dizesindeki veritabanının adını ContosoUniversity2 veya kullandığınız 
bilgisayarda kullanmadığınız başka bir ad olarak değiştirin. 

{ 

"ConnectionStrings": { 

"DefaultConnection": "Server= 

(localdb)\\mssqllocaldb;Database=ContosoUniversity2jTrusted_Connection=True;MultipleActiveResııltSets=tr'iıe" 

}, 

Bu değişiklik projeyi ilk geçişin yeni bir veritabanı oluşturacak şekilde ayarlar. Bu, geçişleri kullanmaya başlamak için 
gerekli değildir, ancak daha sonra iyi bir fikir olduğunu göreceksiniz. 





NOTE 

Veritabanı adını değiştirmeye alternatif olarak, veritabanını silebilirsiniz. SQL Server Nesne Gezgini (ssox) veya 
database drop CLI komutunu kullanın: 

dotnet ef database drop 

Aşağıdaki bölümde CLı komutlarının nasıl çalıştırılacağı açıklanmaktadır. 


İlk geçiş oluşturma 

Değişikliklerinizi kaydedin ve projeyi derleyin. Sonra bir komut penceresi açın ve proje klasörüne gidin. Bunu 
yapmanın hızlı bir yolu aşağıda verilmiştir: 


• Çözüm Gezgini' de projeye sağ tıklayın ve bağlam menüsünden klasörü dosya Gezgini 'nde aç 1 ı seçin. 
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Komut penceresine aşağıdaki komutu girin: 


dotnet ef migrations add InitialCreate 


Komut penceresinde aşağıdakine benzer bir çıktı görürsünüz: 



































info: Microsoft.EntityFrameworkCore.Infrastructure[10403] 

Entity Framework Core 2.2.0-rtm-35687 initialized 'SchoolContext' using provider 
'Microsoft.EntityFrameworkCore.SqlServer' with options: None 
Done. To undo this action., use 'ef migrations remove' 



Bir hata iletisi görürseniz "dosyaya erişilemiyor... ContosoUniversity. dil başka bir işlem tarafından kullanıldığı için .", 
Windows sistem tepsisinde MS Express simgesini bulun ve sağ tıklayın, sonra da contosouniversity > siteyi 
durdur' a tıklayın. 

Yukarı ve aşağı yöntemleri inceleyin 

migrations add komutunu çalıştırdığınızda EF, veritabanını sıfırdan oluşturacak kodu oluşturdu. Bu kod, 
_lnitialCreate. cs ><zaman damgasıad\\ dosyada geçişler klasöründedir. initiaicreate sınıfının up yöntemi, veri 
modeli varlık kümelerine karşılık gelen veritabanı tablolarını oluşturur ve aşağıdaki örnekte gösterildiği gibi Down 
yöntemi onları siler. 

public partial class InitialCreate : Migration 
{ 

protected override void Up(MigrationBuilder migrationBuilder) 

{ 

migrationBuilder.CreateTable( 
name: "Course", 
columns: table => new 
{ 

CourselD = table.Column<int>(nullable: false), 

Credits = table.Column<int>(nullable: false), 

Title = table.Column<string>(nullable: true) 

}, 

constraints: table => 

{ 

table.PrimaryKey("PK_Course"j x => x.CourselD); 

}); 

// Additional code not shown 

} 

protected override void Down(MigrationBuilder migrationBuilder) 

{ 

migrationBuilder.DropTable( 
name: "Enrollment"); 

// Additional code not shown 

} 

} 

Geçişler, bir geçiş için veri modeli değişikliklerini uygulamak üzere up yöntemini çağırır. Güncelleştirmeyi geri 
almak için bir komut girdiğinizde, geçişler Down yöntemini çağırır. 

Bu kod, migrations add initiaicreate komutunu girdiğinizde oluşturulan ilk geçişe yöneliktir. Geçiş adı 
parametresi (örnekteki "initiaicreate") dosya adı için kullanılır ve istediğiniz her şey olabilir. Geçiş sırasında nelerin 
yapıldığını özetleyen bir sözcük veya tümcecik seçmek en iyisidir. Örneğin, "AddDepartmentTable" adlı bir geçişe 
daha sonra ad yazabilirsiniz. 

Veritabanı zaten mevcut olduğunda ilk geçişi oluşturduysanız veritabanı oluşturma kodu oluşturulur, ancak 













veritabanı veri modeliyle zaten eşleştiğinden çalıştırması gerekmez. Uygulamayı, veritabanının mevcut olmadığı 
başka bir ortama dağıttığınızda, bu kod veritabanınızı oluşturmak için çalışır, bu nedenle ilk önce test etmek iyi bir 
fikirdir. Bu nedenle, bağlantı dizesinde veritabanının adını daha önce değiştirmiş olursunuz, böylece geçişler sıfırdan 
yeni bir tane oluşturabilir. 

Veri modeli anlık görüntüsü 

Geçişler, geçiş/SchoolContextModelSnapshot. csiçinde geçerli veritabanı şemasının bir anlık görüntüsünü oluşturur. 
Bir geçiş eklediğinizde EF, veri modeli Snapshot dosyası ile karşılaştırılarak nelerin değiştirildiğini belirler. 

Bir geçişi silerken DotNet EF geçişleri kaldır komutunu kullanın, dotnet ef migrations remove geçişi siler ve anlık 
görüntünün doğru şekilde sıfırlanmasını sağlar. 

Anlık görüntü dosyasının nasıl kullanıldığı hakkında daha fazla bilgi için bkz. Takım ortamlarında EF Core geçişleri . 

Geçişi Uygula 

Komut penceresinde, veritabanı ve tabloları oluşturmak için aşağıdaki komutu girin. 

dotnet ef database update 

Komutun çıktısı, veritabanının ayarlandığı SQL komutlarının günlüklerini görmeniz dışında migrations add 
komutuna benzerdir. Günlüklerin çoğu aşağıdaki örnek çıktıda atlanır.Günlük iletilerinde bu ayrıntı düzeyini 
görmemeyi tercih ediyorsanız, appSettings 'de günlük düzeyini değiştirebilirsiniz. Development. JSON dosyası. 
Daha fazla bilgi için bkz. ,N ET Core ve AS P.N ET Core oturum açma. 

info: Microsoft.EntityFrameworkCore.Infrastructure[10403] 

Entity Framework Core 2.2.0-rtm-35687 initialized 'SchoolContext' using provider 
'Microsoft.EntityFrameworkCore.SqlServer' with options: None 
info: Microsoft.EntityFrameworkCore.Database.Command[20101] 

Execııted DbCommand (274ms) [Parameters=[], CommandType='Text', CommandTimeout='60'] 

CREATE DATABASE [ContosoUniversity2]; 
info: Microsoft.EntityFrameworkCore.Database.Command[20101] 

Executed DbCommand (60ms) [Parameters =[], CommandType='Text ', CommandTimeout='60'] 

IF SERVERPROPERTY('EngineEdition') o 5 
BEGIN 

ALTER DATABASE [ContosoUniversity2] SET READ_COMMITTED_SNAPSHOT ON; 

END; 

info: Microsoft.EntityFrameworkCore.Database.Command[20101] 

Execııted DbCommand (15ms) [Parameters =[], CommandType='Text ', CommandTimeout='30'] 

CREATE TABLE [_EFMİgrationsHistory] ( 

[Migrationld] nvarchar(150) NOT NULL, 

[ProductVersion] nvarchar(32) NOT NULL, 

CONSTRAINT [PK_EFMİgrationsHistory] PRIMARY KEY ([Migrationld]) 

); 

clogs omitted for brevity> 

info: Microsoft.EntityFrameworkCore.Database.Command[20101] 

Executed DbCommand (3ms) [Parameters=[], CommandType='Text', CommandTimeout='30'] 

INSERT INTO [_EFMİgrationsHistory] ([Migrationld ], [ProductVersion]) 

VALUES (N'20190327172701_InitialCreate ', N'2.2,0-rtm-35687'); 

Done. 

ilk öğreticide yaptığınız gibi veritabanını incelemek için SQL Server Nesne Gezgini kullanın. Hangi geçişlerin 
veritabanına uygulandığını izleyen bir __EFMİgrationsHistory tablosunun eklenmesini fark edeceksiniz. Bu 
tablodaki verileri görüntüleyin ve ilk geçiş için bir satır görürsünüz. (Önceki CLı çıkış örneğinde son oturum, bu 
satırı oluşturan INSERT ifadesini gösterir.) 








Her şeyin daha önce olduğu gibi çalıştığını doğrulamak için uygulamayı çalıştırın. 
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CLı ve PMC karşılaştırması 

Geçişleri yönetmek için EF araçları, .NET Core CLI komutlardan veya Visual Studio Paket Yöneticisi konsolu 
(PMC) penceresindeki PovverShell cmdlet Herinde bulunabilir. Bu öğreticide, CLı 'nın nasıl kullanılacağı 
gösterilmektedir, ancak isterseniz PMC 'yi kullanabilirsiniz. 

PMC komutlarına yönelik EF komutları Microsoft. EntityFramevvorkCore. Tools paketidir. Bu paket Microsoft. 
AspNetCore. app metapackageiçinde bulunur, bu nedenle uygulamanızın Microsoft.AspNetcore.App için bir paket 
başvurusu varsa bir paket başvurusu eklemeniz gerekmez. 

Önemli: Bu,. csproj dosyasını düzenleyerek CLI için yüklediğiniz paket ile aynı değildir.Bu adın adı, Tools.DotNet 
biten CLı paketi adından farklı olarak Tools biter. 

CLı komutları hakkında daha fazla bilgi için bkz. .NET Core CLI. 

PMC komutları hakkında daha fazla bilgi için bkz. Paket Yöneticisi Konsolu (Visual Studio). 

Kodu alın 

Tamamlanmış uygulamayı indirin veya görüntüleyin. 

Sonraki adım 

Bu öğreticide şunları yaptınız: 

• Geçişler hakkında öğrenildi 

• NuGet geçiş paketleri hakkında bilgi edinildi 

• Bağlantı dizesi değiştirildi 

• ilk geçiş oluşturuldu 

• Yukarı ve aşağı yöntemleri inceleme 

• Veri modeli anlık görüntüsü hakkında bilgi edinildi 













• Geçiş uygulandı 

Veri modelini genişletme hakkında daha gelişmiş konulara bakmak için sonraki öğreticiye ilerleyin. Ek geçişler 
oluşturma ve uygulama gibi. 

Ek geçişler oluşturma ve uygulama 


Öğretici: EF Core ile karmaşık veri modeli oluşturma- 
ASPNET MVC 

25.11.2019 * 46 minutes to read ı Edit Online 


Önceki öğreticilerde, üç varlıktan oluşan basit bir veri modeliyle çalıştık. Bu öğreticide, daha fazla varlık ve ilişki 
ekleyeceksiniz ve biçimlendirme, doğrulama ve veritabanı eşleme kurallarını belirterek veri modelini 
özelleştireceksiniz. 

işiniz bittiğinde, varlık sınıfları aşağıdaki çizimde gösterilen tamamlanmış veri modelini oluşturacak: 
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Bu öğreticide şunları yaptınız: 

• Veri modelini özelleştirme 

• Öğrenci varlığında değişiklik yap 

• Eğitmen varlığı oluşturma 

• OfficeAssignment varlığı oluştur 

• Kurs varlığını değiştirme 











































• Departman varlığı oluştur 

• Kayıt varlığını değiştirme 

• Veritabanı bağlamını güncelleştirme 

• Test verileriyle çekirdek veritabanı 

• Geçiş Ekle 

• Bağlantı dizesini değiştirme 

• Veritabanını güncelleştirme 

Önkoşullar 

• EF Core geçişleri kullanma 

Veri modelini özelleştirme 

Bu bölümde, biçimlendirme, doğrulama ve veritabanı eşleme kurallarını belirten öznitelikleri kullanarak veri 
modelini nasıl özelleştireceğinizi göreceksiniz. Ardından, aşağıdaki bölümlerde, zaten oluşturduğunuz sınıflara 
öznitelikler ekleyerek ve modeldeki kalan varlık türleri için yeni sınıflar oluşturarak tüm okul veri modelini 
oluşturacaksınız. 

DataType özniteliği 

Öğrenci kayıt tarihleri için tüm Web sayfaları Şu anda tarihle birlikte görüntülenir, ancak bu alan için tüm önemli bir 
tarih olması gerekir. Veri ek açıklaması özniteliklerini kullanarak, verileri gösteren her görünümde görüntü biçimini 
giderecek bir kod değişikliği yapabilirsiniz. Bunun nasıl yapılacağını gösteren bir örnek görmek için, student 
sınıfındaki EnroiimentDate özelliğine bir öznitelik ekleyeceksiniz. 

Modeller/öğrenci. cs' de, System.componentModei.DataAnnotations ad alanı için using bir ifade ekleyin ve aşağıdaki 
örnekte gösterildiği gibi EnroiimentDate özelliğine DataType ve DisplayFormat özniteliklerini ekleyin: 

using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

namespace ContosoUniversity.Models 
{ 

public class Student 
{ 

public int ID { get; set; } 

public stning LastName { get; set; } 

public stning FirstMidName { get; set; } 

[DataType(DataType.Date) ] 

[DisplayFormat(DataFormatString = "{Öıyyyy-MM-dd}", ApplyFormatlnEditMode = true)] 
public DateTime EnrollmentDate { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 

DataType özniteliği, veritabanı iç türünden daha özel bir veri türü belirtmek için kullanılır. Bu durumda, tarihi ve 
saati değil yalnızca tarihi izlemek istiyoruz. DataType numaralandırması, tarih, saat, PhoneNumber, para birimi, 
Emaadresi ve daha fazlası gibi birçok veri türü sağlar. DataType özniteliği Ayrıca uygulamanın türe özgü özellikleri 
otomatik olarak sağlamasını da sağlayabilir. Örneğin, DataType.EmailAddress için maiıto: bir bağlantı 
oluşturulabilir ve HTML5 'i destekleyen tarayıcılarda DataType.Date için bir tarih seçici sağlaneklenebilir. DataType 
özniteliği HTML 5 tarayıcıların anlayabilmesi için HTML 5 data- (bir veri Dash) öznitelikleri yayar. DataType 
öznitelikleri herhangi bir doğrulama sağlamaz. 

DataType.Date görüntülenen tarihin biçimini belirtmiyor. Varsayılan olarak, veri alanı sunucunun Culturelnfo 


















öğesine göre varsayılan biçimlere göre görüntülenir. 

DisplayFormat özniteliği, açıkça tarih biçimini belirtmek için kullanılır: 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 

AppiyFormatinEditMode ayarı, bir metin kutusunda değer görüntülenmek üzere görüntülendiğinde 
biçimlendirmenin de uygulanacağını belirtir. (Bazı alanlar için bunu istemiyor olabilirsiniz; örneğin, para birimi 
değerleri için metin kutusundaki para birimi sembolünü düzenlemenin değiştirilmesini istemeyebilirsiniz.) 

DisplayFormat öznitel iğini kendisi kullanabilirsiniz, ancak DataType özniteliğini de kullanmak genellikle iyi bir 
fikirdir. DataType özniteliği, verilerin semantiğini bir ekranda nasıl işleneceğini değil, DisplayFormat ile elde 
olmadığınız avantajları sağlar: 

• Tarayıcı HTML5 özelliklerini etkinleştirebilir (örneğin, bir Takvim denetimini, yerel ayara uygun para birimi 
sembolünü, e-posta bağlantılarını, bazı istemci tarafı giriş doğrulamasını vb. göstermek için). 

• Varsayılan olarak tarayıcı, verileri yerel ayarınızı temel alarak doğru biçimi kullanarak işleyebilir. 

Daha fazla bilgi için bkz. giriş > etiketi Yardımcısı belgeleri< . 

Uygulamayı çalıştırın, öğrenciler dizin sayfasına gidin ve kayıt tarihleri için saatlerin artık gösterilmediğine dikkat 
edin. Aynı değer öğrenci modelini kullanan herhangi bir görünüm için de geçerli olacaktır. 
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StringLength özniteliği 

Ayrıca, öznitelikleri kullanarak veri doğrulama kuralları ve doğrulama hata iletileri de belirtebilirsiniz. StringLength 
özniteliği, veritabanında en fazla uzunluğu ayarlar ve AS P.N ET Core MVC için istemci tarafı ve sunucu tarafı 
doğrulaması sağlar. Bu öznitelikte en küçük dize uzunluğunu da belirtebilirsiniz, ancak en küçük değerin veritabanı 
şemasında hiçbir etkisi yoktur. 

Kullanıcıların bir ad için 50 ' den fazla karakter girmemesini istediğinizi varsayalım. Bu kısıtlamayı eklemek için, 
aşağıdaki örnekte gösterildiği gibi, LastName ve FirstMidName özelliklerine StringLength öznitelikleri ekleyin: 




















using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

namespace ContosoUniversity.Models 

{ 

public class Student 

{ 

public int ID { get; set; } 

[StringLength(50)] 

public stning LastName { get; set; } 

[StringLength(50)] 

public stning FirstMidName { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}"j ApplyFormatlnEditMode = true)] 
public DateTime EnnollmentDate { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 

stringLength özniteliği bir kullanıcının ad için boşluk girmesini engellemez. Girişe kısıtlama uygulamak için 
ReguiarExpression özniteliğini kullanabilirsiniz. Örneğin, aşağıdaki kod ilk karakterin büyük küçük harf olmasını ve 
geri kalan karakterlerin alfabetik olmasını gerektirir: 

[RegularExpression(@" A [A-Z]+[a-zA-Z.\s-]*$") ] 

MaxLength özniteliği, stringLength özniteliğe benzer ancak istemci tarafı doğrulaması sağlamayan işlevselliği 
sağlar. 

Veritabanı modeli, veritabanı şemasında değişiklik yapılmasını gerektiren bir şekilde değiştirildi. Uygulama kullanıcı 
arabirimini kullanarak, veritabanına eklemiş olduğunuz herhangi bir veriyi kaybetmeden Şemayı güncelleştirmek 
için geçişleri kullanacaksınız. 

Değişikliklerinizi kaydedin ve projeyi derleyin. Ardından proje klasöründe komut penceresini açın ve aşağıdaki 
komutları girin: 

dotnet ef migrations add MaxLengthOnNames 

dotnet ef database update 

migrations add komutu, bu değişiklik, iki sütun için en fazla uzunluğu daha kısa hale yaptığından, veri kaybının 
gerçekleşebileceğini uyarır. Geçişler _MaxLengthOnNames. cs ><zaman damgasıadU bir dosya oluşturur. Bu dosya, 
veritabanını geçerli veri modeliyle eşleşecek şekilde güncelleştirecek up yönteminde kod içerir, database update 
komutu bu kodu çalıştırdı. 

Geçiş dosyası adının ön eki olan zaman damgası, geçişleri sıralamak için Entity Framework tarafından kullanılır. 
Update-database komutunu çalıştırmadan önce birden çok geçiş oluşturabilirsiniz ve sonra tüm geçişler 
oluşturuldukları sırada uygulanır. 

Uygulamayı çalıştırın, öğrenciler sekmesini seçin, Yeni oluştur 1 a tıklayın ve 50 karakterden daha uzun bir ad 
girmeyi deneyin. Uygulamanın bunu yapmasını önleyebilmelidir. 

Column özniteliği 

Ayrıca, sınıflarınızın ve özelliklerinin veritabanına nasıl eşlenildiğini denetlemek için özniteliklerini de 
kullanabilirsiniz. Alan aynı zamanda bir orta ad içerebileceğinden, ilk ad alanı için FirstMidName adı kullandığınızı 






varsayalım. Ancak veritabanına karşı geçici sorgular yazmayacak olan kullanıcılar bu ada alışkın olduğundan, 
veritabanı sütununun FirstName adlandırılmış olmasını isteyebilirsiniz. Bu eşlemeyi yapmak için, column 
özniteliğini kullanabilirsiniz. 

column özniteliği, veritabanı oluşturulduğunda, FirstMidName özelliğine eşlenen student tablosunun sütununun 
FirstName adlandırılacağını belirtir. Diğer bir deyişle, kodunuz student.FirstMidName başvurduğunda, veriler 
student tablosunun FirstName sütununda gönderilir veya güncelleştirilir. Sütun adları belirtmezseniz, bunlar 
Özellik adı ile aynı ada verilir. 

Student.es dosyasında, System.ComponentModel.DataAnnotations.sehema için using bir ifade ekleyin ve sütun adı 
özniteliğini aşağıdaki vurgulanmış kodda gösterildiği gibi FirstMidName özelliğine ekleyin: 

using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public elass Student 

{ 

public int ID { get; set; } 

[StringLength(50)] 

public string LastName { get; set; } 

[StringLength(50)] 

[Column("FirstName")] 

public string FirstMidName { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 
public DateTime EnrollmentDate { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 

Column özniteliği ekleme modeli, schooicontext yedekleyen, bu nedenle veritabanıyla eşleşmez. 

Değişikliklerinizi kaydedin ve projeyi derleyin. Ardından proje klasöründe komut penceresini açın ve başka bir geçiş 
oluşturmak için aşağıdaki komutları girin: 

dotnet ef migrations add ColumnFirstName 

dotnet ef database update 


SQL Server Nesne Gezgini, öğrenci tablosuna çift tıklayarak öğrenci tablosu tasarımcısını açın. 
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CREATE TABLE [dbo].[Students] 

[ID] INT IDENTITY (1, 1) NOT NULL, 

[EnrollmentDate] DATETIME2 (7) NOT NULL, 

[FirstName] NVARCHAR (50) NULL, 

[LastName] NVARCHAR (50) NULL, 

CONSTRAINT [PK_Students] PRIHARY KEY CLUSTERED ([ID] ASC) 

); 


ilk iki geçişi uygulamadan önce ad sütunları nvarchar (MAX) türünde. Artık nvarchar (50) ve sütun adı 
FirstMidName iken FirstName olarak değiştirilmiştir. 


NOTE 

Aşağıdaki bölümlerde tüm varlık sınıflarını oluşturmayı bitirmeden önce derlemeyi denerseniz Derleyici hataları alabilirsiniz. 


Öğrenci varlığındaki değişiklikler 


Student 


Properties 
y? İD 

A LastName 
A FirstMidName 
A EnrollmentDate 
Navigation Properties 
y3 Enrollments 


Modeller/öğrenci, cs' de, daha önce eklediğiniz kodu aşağıdaki kodla değiştirin. Değişiklikler vurgulanır. 













using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Student 

{ 

public int ID { get; set; } 

[Required] 

[StningLength(50)] 

[Display(Name = "Last Name")] 
public string LastName { get; set; } 

[Required] 

[StningLength(50)] 

[Column("FirstName")] 

[Display(Name = "First Name")] 

public string FirstMidName { get; set; } 

[DataType(DataType.Date) ] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd }", ApplyFormatlnEditMode = true)] 

[Display(Name = "Enrollment Date")] 

public DateTime EnrollmentDate { get; set; } 

[Display(Name = "Full Name")] 
public string FullName 
{ 

get 

{ 

return LastName + ", " + FirstMidName; 

} 

} 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 


Gerekli öznitelik 

Required özniteliği, ad özellikleri gereken alanları sağlar. Değer türleri (DateTime, int, Double, float, vb.) gibi null 
yapılamayan türler için Required özniteliği gerekli değildir. Null olmayan türler otomatik olarak gerekli alanlar 
olarak değerlendirilir. 


MinimumLength zorlanmak için Required özniteliği MinimumLength ile birlikte kullanılmalıdır. 


[Display(Name = "Last Name")] 
[Required] 

[StringLength(50, MinimumLength=2)] 
public string LastName { get; set; } 


Display özniteliği 

Display özniteliği, metin kutularının açıklamalı alt yazısının her örnekteki Özellik adı yerine "İlk ad", "soyadı", "tam 
ad" ve "kayıt tarihi" olması gerektiğini belirtir (kelimeleri bir boşluk yoktur). 

FullName hesaplanmış özelliği 

FullName , diğer iki özelliği birleştirerek oluşturulmuş bir değer döndüren hesaplanmış bir özelliktir. Bu nedenle, 
yalnızca bir get erişimcisine sahiptir ve veritabanında FullName sütunu oluşturulmaz. 


Eğitmen varlığı oluşturma 










Instructor 


Properties 
v î İD 

f* LastName 
f* FirstMidName 
f* HireDate 
Navigation Properties 
y3 CourseAssignments 
P OfficeAssignmerıt 


Şablon kodunu aşağıdaki kodla değiştirerek modeller/eğitmen. csoluşturun: 

using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Instructor 

{ 

public int ID { get; set; } 

[Required] 

[Display(Name = "Last Name")] 

[StringLength(50)] 

public string LastName { get; set; } 

[Required] 

[Column("FirstName")] 

[Display(Name = "First Name")] 

[StringLength(50)] 

public string FirstMidName { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 

[Display(Name = "Hire Date")] 
public DateTime HireDate { get; set; } 

[Display(Name = "Full Name")] 
public string FullName 
{ 

get { return LastName + ", " + FirstMidName; } 

} 

public ICollection<CourseAssignment> CourseAssignments { get; set; } 
public OfficeAssignment OfficeAssignment { get; set; } 

} 

} 

Öğrenci ve eğitmen varlıklarında birçok özellik aynı olduğuna dikkat edin. Devralma öğreticisini bu serinin ilerleyen 
kısımlarında uyguladığınızda , artıklığı ortadan kaldırmak için bu kodu yeniden düzenlemelisiniz. 

Birden çok özniteliği tek bir satıra koyabilirsiniz, bu nedenle HireDate özniteliklerini aşağıdaki gibi yazabilirsiniz: 

[DataType(DataType.Date),Display(Name = "Hire Date"),DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}”, 
ApplyFormatlnEditMode = true)] 


Courseatamalar ve OfficeAssignment gezinti özellikleri 


CourseAssignments ve OfficeAssignment özellikleri gezinti özellikleridir. 












Bir eğitmen herhangi bir sayıda kurs öğretebilir, bu nedenle courseAssignments bir koleksiyon olarak tanımlanır. 

public ICollection<CourseAssignment> CourseAssignments { get; set; } 

Bir gezinti özelliği birden çok varlık tukiyorsa, türü girişlerin eklenebileceği, silinebileceği ve güncelleştirilemeyebilir 
bir liste olmalıdır. ıcoiiection<T> veya List<T> veya HashSet<T> gibi bir tür belirtebilirsiniz. ıcoiiection<T> 
belirtirseniz, EF varsayılan olarak bir HashSet<T> koleksiyonu oluşturur. 

Bunların courseAssignment varlıkların nedenleri, çoktan çoğa ilişkiler hakkında bölümünde aşağıda açıklanmıştır. 

Contoso Üniversitesi iş kuralları, bir eğitmenin yalnızca en fazla bir ofise sahip olabileceğini, bu nedenle 
OfficeAssignment özelliği tek bir OfficeAssignment varlığı (Office atanmamışsa null olabilir) bulundurmasıdır. 

public OfficeAssignment OfficeAssignment { get; set; } 


OfficeAssignment varlığı oluştur 


OfficeAssign... 



using System.ComponentModel.DataAnnotations; 
using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 
{ 

public class OfficeAssignment 
{ 

[Key] 

public int InstructorlD { get; set; } 
[StningLength(50)] 

[Display(Name = "Office Location")] 
public stning Location { get; set; } 

public Instnuctor Instructon { get; set; } 

} 

} 


Anahtar özniteliği 

Eğitmen ve OfficeAssignment varlıkları arasında bire sıfır veya-bir ilişki vardır. Office ataması, atandığı eğitmenle 
ilişkili olarak yalnızca kendi birincil anahtarı da eğitmen varlığına ait yabancı anahtarıdır. Ancak Entity Framevvork, 
adı İD veya Classnameıd adlandırma kuralını izlemediği için bu varlığın birincil anahtarı olarak Komutctorıd 'yi 
otomatik olarak tanıyamaz. Bu nedenle, Key özniteliği onu anahtar olarak tanımlamak için kullanılır: 

[Key] 

public int InstructorlD { get; set; } 

Varlık kendi birincil anahtarına sahip olsa da, özelliği Classnameıd veya İD dışında bir şekilde adlandırmak 
istiyorsanız Key özniteliğini de kullanabilirsiniz. 



















Varsayılan olarak, tam olarak, sütun tanımlayıcı bir ilişki için olduğundan EF, anahtarı veritabanı olmayan bir şekilde 
değerlendirir. 

Eğitmen gezintisi özelliği 

Eğitmen varlığı, null yapılabilir bir officeAssignment gezinti özelliğine sahiptir (bir eğitmenin bir Office ataması 
olmayabilir) ve OfficeAssignment varlığı null atanamaz instructor bir gezinti özelliğine sahiptir (bir Office ataması 
bir eğitmen olmadan mevcut olamaz— instructoriD null değer atanamaz). Bir eğitmen varlığı ilgili bir 
OfficeAssignment varlığına sahip olduğunda, her varlığın gezinti özelliğinde diğer birine bir başvurusu olur. 

ilgili bir eğitmen olması gerektiğini belirtmek için, eğitmen gezinti özelliğine bir [Required] özniteliği koyabilirsiniz, 
ancak bunu yapmak zorunda kalmazsınız çünkü bu, instructoriD yabancı anahtar (aynı zamanda bu tablodaki 
anahtar) null atanamaz. 


Kurs varlığını değiştirme 



using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Course 

{ 

[DatabaseGenerated(DatabaseGeneratedOption.None)] 

[Display(Name = "Number")] 
public int CourselD { get; set; } 

[StringLength(50j MinimumLength = 3)] 
public string Title { get; set; } 

[Range(0, 5)] 

public int Credits { get; set; } 

public int DepartmentlD { get; set; } 

public Department Department { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

public ICollection<CourseAssignment> CourseAssignments { get; set; } 

} 

} 

Kurs varlığının, ilgili departman varlığına işaret eden ve Department bir gezinti özelliği olan DepartmentlD yabancı 
anahtar özelliği vardır. 

Entity Framevvork, ilgili varlık için bir gezinti özelliği olduğunda, veri modelinize yabancı anahtar özelliği eklemenizi 
gerektirmez. EF, gerektiğinde otomatik olarak yabancı anahtarlar oluşturur ve bunlar için gölge Özellikler oluşturur. 















Ancak veri modelinde yabancı anahtar olması, güncelleştirmeleri daha basit ve daha verimli hale getirir. Örneğin, 
düzenlemek üzere bir kurs varlığı aldığınızda, bunu yüklemezseniz departman varlığı null olur, bu nedenle kurs 
varlığını güncelleştirdiğinizde öncelikle departman varlığını almanız gerekir. Yabancı anahtar özelliği DepartmentiD 
veri modeline dahil edildiğinde, güncelleştirmeden önce bölüm varlığını almanız gerekmez. 

DatabaseGenerated özniteliği 

CourseiD özelliğindeki None parametresine sahip DatabaseGenerated özniteliği, birincil anahtar değerlerinin 
veritabanı tarafından oluşturulması yerine Kullanıcı tarafından sağlandığını belirtir. 

[DatabaseGenerated(DatabaseGeneratedOption.None)] 

[Display(Name = "Number")] 
public int CourseiD { get; set; } 

Varsayılan olarak, Entity Framevvork birincil anahtar değerlerinin veritabanı tarafından oluşturulduğunu varsayar. 
Bu, Çoğu senaryoda istediğiniz şeydir. Ancak, kurs varlıkları için bir departman için 1000 serisi, başka bir 
departman için 2000 serisi vb. gibi kullanıcı tarafından belirtilen bir kurs numarası kullanırsınız. 

DatabaseGenerated özniteliği, bir satırın oluşturulduğu veya güncelleştirildiği tarihi kaydetmek için kullanılan 
veritabanı sütunları durumunda olduğu gibi varsayılan değerleri oluşturmak için de kullanılabilir. Daha fazla bilgi 
için bkz. üretilen Özellikler. 

Yabancı anahtar ve gezinti özellikleri 

Kurs varlığındaki yabancı anahtar özellikleri ve gezinti özellikleri aşağıdaki ilişkileri yansıtır: 

Bir kurs bir departmana atanır, bu nedenle yukarıda bahsedilen nedenlerle DepartmentiD yabancı anahtar ve 
Department gezinti özelliği vardır. 

public int DepartmentiD { get; set; } 
public Department Department { get; set; } 

Bir kurs, kayıtlı sayıda öğrenciye sahip olabilir, bu nedenle Enroiiments gezinti özelliği bir koleksiyondur: 

public ICollection<Enrollment> Enrollments { get; set; } 

Bir kurs birden fazla eğitmen tarafından tada olabilir, bu nedenle courseAssignments gezinti özelliği bir koleksiyon 
olur ( courseAssignment türü daha sonraaçıklanmıştır): 

public ICollection<CourseAssignment> CourseAssignments { get; set; } 


Departman varlığı oluştur 


Department 


Properties 
V? DepartmentiD 
A> Name 
Budget 
A" StartDate 
A* InstructorlD 
Navigation Properties 
Administrator 
yîl Courses 


Aşağıdaki kodla modeller/departman, cs oluşturun: 


















using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Department 

{ 

public int DepartmentlD { get; set; } 

[StringLength(50j MinimumLength = 3)] 
public string Name { get; set; } 

[DataType(DataType.Currency)] 

[Column(TypeName = "money")] 
public decimal Budget { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd }", ApplyFormatlnEditMode = true)] 

[Display(Name = "Start Date")] 

public DateTime StartDate { get; set; } 

public int? InstructorlD { get; set; } 

public Instructor Administrator { get; set; } 
public ICollection<Course> Courses { get; set; } 

} 

} 


Column özniteliği 

Daha önce, sütun adı eşlemesini değiştirmek için column özniteliğini kullandınız. Bölüm varlığının kodunda, 
sütunun veritabanındaki SQL Server para türü kullanılarak tanımlanması için SQL veri türü eşlemesini değiştirmek 
üzere column özniteliği kullanılır: 

[Column(TypeName="money")] 
public decimal Budget { get; set; } 

Entity Framevvork, özellik için tanımladığınız CLR türüne göre uygun SQL Server veri türünü seçtiği için sütun 
eşlemesi genellikle gerekli değildir. CLR decimal türü bir SQL Server decimal türüne eşlenir. Ancak bu durumda, 
sütunun para birimi tutarlarını tutuını ve para veri türü bunun için daha uygun olduğunu bilirsiniz. 

Yabancı anahtar ve gezinti özellikleri 

Yabancı anahtar ve gezinti özellikleri aşağıdaki ilişkileri yansıtır: 

Bir departman yönetici olabilir veya olmayabilir ve yönetici her zaman bir eğitmendir. Bu nedenle InstructorlD 
özelliği, eğitmen varlığına yabancı anahtar olarak dahil edilir ve özelliği null yapılabilir olarak işaretlemek için int 
tür atamadan sonra bir soru işareti eklenir. Gezinti özelliği Administrator olarak adlandırılır ancak bir eğitmen 
varlığı tutar: 

public int? InstructorlD { get; set; } 
public Instructor Administrator { get; set; } 


Bir departmanın birçok kursu olabilir, bu nedenle bir kurs gezintisi özelliği vardır: 

public ICollection<Course> Courses { get; set; } 











NOTE 

Kurala göre Entity Framevvork, null olamayan yabancı anahtarlar ve çoktan çoğa ilişkiler için art arda silme imkanı sağlar. Bu, bir 
geçiş eklemeye çalıştığınızda bir özel duruma neden olacak dairesel basamaklı silme kurallarına neden olabilir. Örneğin, 
Department. Komutctorıd özelliğini null yapılabilir olarak tanımlamadıysanız, bu, bir basamak silme kuralını, eğitmeni 
sildiğinizde, ne yapmak istediğinize ilişkin olmayan bir şeyi silmek için yapılandırır, iş kurallarınız instructoriD özelliğini null 
atanamaz olarak gerektiriyorsa, ilişkide basamaklı silmeyi devre dışı bırakmak için aşağıdaki Fluent API ifadesini kullanmanız 
gerekir: 

modelBuilder.Entity<Department> () 

.HasOne(d => d.Administrator) 

.WithMany() 

.OnDelete(DeleteBehavior.Restrict) 


Kayıt varlığını değiştirme 


Enrollment 



using System.ComponentModel.DataAnnotations; 
using System. ComponentModel. DataAnnotations. Schema; 

namespace ContosoUniversity.Models 

{ 

public enum Grade 

{ 

A, B, C, D, F 

} 

public class Enrollment 

{ 

public int EnrollmentlD { get; set; } 
public int CourselD { get; set; } 
public int StudentlD { get; set; } 
[DisplayFormat(NullDisplayText = "No grade")] 
public Grade? Grade { get; set; } 

public Course Course { get; set; } 
public Student Student { get; set; } 

} 

} 


Yabancı anahtar ve gezinti özellikleri 

Yabancı anahtar özellikleri ve gezinti özellikleri aşağıdaki ilişkileri yansıtır: 


Kayıt kaydı tek bir kurs için olduğundan CourselD yabancı anahtar özelliği ve course gezinti özelliği vardır: 












public int CourselD { get; set; } 
public Course Course { get; set; } 


Kayıt kaydı tek bir öğrenci içindir, bu nedenle studentiD yabancı anahtar özelliği ve student gezinti özelliği vardır 

public int StudentiD { get; set; } 
public Student Student { get; set; } 


Çoktan çoğa ilişkiler 

Öğrenci ve kurs varlıkları arasında çok-çok ilişkisi vardır ve kayıt varlığı, veritabanında Yük içeren çoktan çoğa bir 
JOIN tablosu gibi çalışır. “Yük ile", kayıt tablosunun birleştirilmiş tablolar için yabancı anahtarlar (Bu durumda bir 
birincil anahtar ve bir sınıf özelliği) yanında ek veriler içerdiği anlamına gelir. 

Aşağıdaki çizimde bu ilişkilerin bir varlık diyagramında nasıl göründüğünü gösterilmektedir.(Bu diyagram EF 6. x 
için Entity Framevvork güç araçları kullanılarak oluşturulmuştur; diyagramı oluşturmak öğreticinin bir parçası 
değildir, burada yalnızca bir çizim olarak kullanılmaktadır.) 
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Her ilişki ucu ve bir yıldız işareti (*) 1 diğer sırasında bir-çok ilişkisi belirten bulunur. 

Kayıt tablosu, sınıf bilgilerini içermiyorsa, yalnızca iki yabancı anahtar olan CourselD ve Studentitıd 'yi içermelidir. 
Bu durumda, veritabanına yük (veya saf bir JOIN tablosu) olmadan çok-çok arasında bir JOIN tablosu olacaktır. 
Eğitmen ve kurs varlıklarının bu tür çok-çok ilişkisi vardır ve bir sonraki adımınız, yük olmadan bir JOIN tablosu 
olarak çalışacak bir varlık sınıfı oluşturmaktır. 

(EF 6. x, çoktan çoğa ilişkiler için örtük birleştirmeyi destekler, ancak EF Core. Daha fazla bilgi için, EF Core GitHub 
deposundaki tartışmayabakın.) 


Courseatama varlığı 






















Co u rse Assig nmen t 



using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 
{ 

public class CourseAssignment 
{ 

public int InstructorlD { get; set; } 
public int CourselD { get; set; } 
public Instructor Instructor { get; set; } 
public Course Counse { get; set; } 

} 

} 


Varlık adlarını Birleştir 

Eğitim—çok ilişkisi için veritabanında bir JOIN tablosu gereklidir ve bir varlık kümesi tarafından temsil edilir.Bu 
örnekte Courseinstructor'' Entityi\iameiEntityName 2 bir JOIN varlığının adı yaygın olarak kullanılır.Ancak, ilişkiyi 
açıklayan bir ad seçmenizi öneririz. Veri modelleri, daha sonra yükleri daha sonra almak için, yük olmayan 
birleşimler olmadan basit ve büyümeye başlar. Açıklayıcı bir varlık adıyla başladıysanız, daha sonra adı 
değiştirmeniz gerekmez, ideal olarak, JOIN varlığının iş etki alanında kendi doğal (muhtemelen tek bir kelime) 
adına sahip olması gerekir. Örneğin, kitaplar ve müşteriler derecelendirmeler aracılığıyla bağlanabilir. Bu ilişki için 
CourseAssignment Courseinstructor daha iyi bir seçenektir. 


Bileşik anahtar 

Yabancı anahtarlar null değer atanmadığından ve tablodaki her satırı benzersiz bir şekilde tanımladığından, ayrı bir 
birincil anahtar gerekmez. KomutctorLd ve CourselD özellikleri bir bileşik birincil anahtar olarak çalışır. EF için 
bileşik birincil anahtarları tanımlamanın tek yolu FluentAPI kullanmaktır (öznitelikleri kullanılarak 
gerçekleştirilemez). Bir sonraki bölümde bileşik birincil anahtarı nasıl yapılandıracağınızı göreceksiniz. 

Bileşik anahtar, tek bir kurs için birden çok satır ve bir eğitmen için birden fazla satır, aynı eğitmen ve kurs için 
birden çok satıra sahip olmanızı sağlar. Enroiiment JOIN varlığı kendi birincil anahtarını tanımlar, bu nedenle bu 
sıralamanın yinelemeleri mümkündür. Bu tür yinelemeleri engellemek için yabancı anahtar alanlarına benzersiz bir 
dizin ekleyebilir veya CourseAssignment benzer bir birincil bileşik anahtarla Enroiiment yapılandırabilirsiniz. Daha 
fazla bilgi için bkz. dizinler. 

Veritabanı bağlamını güncelleştirme 

Data/SchoolContext. cs dosyasına aşağıdaki vurgulanmış kodu ekleyin: 









using ContosoUniversity.Models; 
using Microsoft.EntityFrameworkCore; 

namespace ContosoUniversity.Data 

{ 

public class SchoolContext : DbContext 

{ 

public SchoolContext(DbContextOptions<SchoolContext> options) : base(options) 

{ 

} 


public DbSet<Course> Courses { get; set; } 

public DbSet<Enrollment> Enrollments { get; set; } 

public DbSet<Student> Students { get; set; } 

public DbSet<Department> Departments { get; set; } 

public DbSet<Instructor> Instructors { get; set; } 

public DbSet<OfficeAssignment> OfficeAssignments { get; set; } 

public DbSet<CourseAssignment> CourseAssignments { get; set; } 

protected override void OnModelCreating(ModelBuilder modelBuilder) 

{ 

modelBuilder.Entity<Course>().ToTable("Course"); 
modelBuilder.Entity<Enrollment>().ToTable("Enrollment"); 
modelBuilder.Entity<Student>().ToTable("Student"); 
modelBuilder.Entity<Department>().ToTable("Department"); 
modelBuilder.Entity<Instructor>().ToTable("Instructor"); 
modelBuilder.Entity<OfficeAssignment>().ToTable("OfficeAssignment"); 
modelBuilder.Entity<CourseAssignment>().ToTable("CourseAssignment"); 


} 


} 


modelBuilder.Entity<CourseAssignment>() 

.HasKey(c => new { c.CourselDj c.InstructorlD }); 


} 


Bu kod yeni varlıkları ekler ve Courseatama varlığının bileşik birincil anahtarını yapılandırır. 

Fluent API alternatifi hakkında 

DbContext sınıfının onModeicreating yöntemindeki kod, EF davranışını yapılandırmak için Fluent API kullanır. Bu 
örnekte, EF Core belgelerindenfarklı olarak, bir dizi yöntemi çağıran tek bir bildirimde dize tarafından 
KULLANıLDıĞıNDAN, API "floent" olarak adlandırılır: 


protected override void OnModelCreating(ModelBuilder modelBuilder) 

{ 

modelBuilder.Entity<Blog>() 

.Property(b => b.Url) 

.IsRequired(); 

} 


Bu öğreticide, yalnızca öznitelikleri ile yapaamıyoruz veritabanı eşlemesi için Fluent API kullanıyorsunuz. Ancak, 
özniteliklerini kullanarak yapabileceğiniz biçimlendirme, doğrulama ve eşleme kurallarının çoğunu belirtmek için 
Fluent API de kullanabilirsiniz. MinimumLength gibi bazı öznitelikler Fluent API uygulanamaz. Daha önce belirtildiği 
gibi, MinimumLength şemayı değiştirmez, yalnızca bir istemci ve sunucu tarafı doğrulama kuralı uygular. 

Bazı geliştiriciler, varlık sınıflarının "temiz" olmasını sağlamak için Fluent API özel olarak kullanmayı tercih eder, 
isterseniz öznitelikleri ve Fluent API karıştırabilir ve yalnızca Fluent API kullanılarak gerçekleştirilebilecek bazı 
özelleştirmeler de vardır ancak genel olarak önerilen uygulama, bu iki yaklaşımdan birini seçmek ve bunları 
mümkün olduğunca tutarlı bir şekilde kullanmaktır. Her ikisini de kullanırsanız, bir çakışma olduğunda, akıcı API 
‘nin öznitelikleri geçersiz kıldığını unutmayın. 








Öznitelikler ile Fluent API hakkında daha fazla bilgi için bkz. yapılandırma yöntemleri. 


İlişkileri gösteren varlık diyagramı 

Aşağıdaki çizimde, Entity Framevvork Povver Tools 'un tamamlanmış okul modeli için kullandığı diyagram 
gösterilmektedir. 
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Bire çok ilişki çizgilerinin yanı sıra (1 1 den *), eğitmen ve OfficeAssignment varlıkları arasında (1 ila 0.. 1) ve 
eğitmen ve departman varlıkları arasında sıfır veya-bire çok ilişki satırı (0.. 1 ile *) arasında bir tek-sıfır veya-bir ilişki 
satırını görebilirsiniz. 

Test verileriyle çekirdek veritabanı 

Veri/Dbırıınitializer. cs dosyasındaki kodu, oluşturduğunuz yeni varlıklar için çekirdek verileri sağlamak üzere 
aşağıdaki kodla değiştirin. 

using System; 
using System.Linq; 

using Microsoft.EntityFrameworkCore; 

using Microsoft.Extensions.DependencyInjection; 

using ContosoUniversity.Models; 


namespace ContosoUniversity.Data 









































public static class Dblnitializer 

{ 

public static void Initialize(SchoolContext context) 

{ 

//context.Database.EnsureCreated(); 


// Look for any students. 
if (context.Students.Any()) 

{ 

return; // DB has been seeded 

} 

var students = new Studentf] 

{ 

new Student { FirstMidName = "Carson", LastName 
EnrollmentDate = DateTime.Parse("2010-09-01") 
new Student { FirstMidName = "Meredith", LastName 
EnrollmentDate = DateTime.Parse("2012-09-01") 
new Student { FirstMidName = "Arturo", LastName 
EnrollmentDate = DateTime.Parse("2013-09-01") 
new Student { FirstMidName = "Gytis", LastName 
EnrollmentDate = DateTime.Parse("2012-09-01") 
new Student { FirstMidName = "Yan", LastName 

EnrollmentDate = DateTime.Parse("2012-09-01") 
new Student { FirstMidName = "Peggy", LastName 
EnrollmentDate = DateTime.Parse("2011-09-01") 
new Student { FirstMidName = "Laura", LastName 
EnrollmentDate = DateTime.Parse("2013-09-01") 
new Student { FirstMidName = "Nino", LastName 
EnrollmentDate = DateTime.Parse("2005-09-01") 

}; 

foreach (Student s in students) 

{ 

context.Students.Add(s); 

} 

context.SaveChanges(); 


= "Alexander", 

L 

= "Alonso", 

}, 

= "Anand", 

h 

= "Barzdukas", 

L 

= "Lİ", 

h 

= "lustice", 

}, 

= "Norman", 

h 

= "Olivetto", 

} 


var instructors = new Instructor[] 

{ 

new Instructor { FirstMidName = "Kim", LastName = "Abercrombie", 
HireDate = DateTime.Parse("1995-03-ll") }, 
new Instructor { FirstMidName = "Fadi", LastName = "Fakhouri", 
HireDate = DateTime.Parse("2002-07-06") }, 
new Instructor { FirstMidName = "Roger", LastName = "Harui", 
HireDate = DateTime.Parse("1998-07-01") }, 
new Instructor { FirstMidName = "Candace", LastName = "Kapoor", 
HireDate = DateTime.Parse("2001-01-15") }, 
new Instructor { FirstMidName = "Roger", LastName = "Zheng", 
HireDate = DateTime.Parse("2004-02-12") } 


}; 


foreach (Instructor i in instructors) 

{ 

context.instructors.Add(i); 

} 

context.SaveChanges(); 


var departments = new Department[] 

{ 

new Department { Name = "English", Budget = 350000, 

StartDate = DateTime.Parse("2007-09-01"), 

InstructorlD = instructors.Single( i => i.LastName == "Abercrombie").ID }, 
new Department { Name = "Mathematics", Budget = 100000, 

StartDate = DateTime.Parse("2007-09-01"), 

InstructorlD = instructors.Single( i => i.LastName == "Fakhouri").ID }, 
new Department { Name = "Engineering", Budget = 350000, 
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InstructorlD = instructors.Single( i => i.LastName 
new Department { Name = "Economics", Budget = 100000, 
StartDate = DateTime.Parse("2007-09-01"), 
InstructorlD = instructors.Single( i => i.LastName 

b 


"Harui").ID }, 


"Kapoor").ID } 


foreach (Department d in departments) 

{ 

context.Departments.Add(d); 

} 

context.SaveChanges(); 

var courses = new Course[] 

{ 

new Course {CourselD = 1050, Title = "Chemistry", Credits = 3, 

DepartmentlD = departments.Single( s => s.Name == "Engineering").DepartmentlD 

b 

new Course {CourselD = 4022, Title = "Microeconomics", Credits = 3, 

DepartmentlD = departments.Single( s => s.Name == "Economics").DepartmentlD 

b 

new Course {CourselD = 4041, Title = "Macroeconomics", Credits = 3, 

DepartmentlD = departments.Single( s => s.Name == "Economics").DepartmentlD 

b 

new Course {CourselD = 1045, Title = "Calculus", Credits = 4, 

DepartmentlD = departments.Single( s => s.Name == "Mathematics").DepartmentlD 

b 

new Course {CourselD = 3141, Title = "Trigonometry", Credits = 4, 

DepartmentlD = departments.Single( s => s.Name == "Mathematics").DepartmentlD 

b 

new Course {CourselD = 2021, Title = "Composition", Credits = 3, 

DepartmentlD = departments.Single( s => s.Name == "English").DepartmentlD 

b 

new Course {CourselD = 2042, Title = "Literatüre", Credits = 4, 

DepartmentlD = departments.Single( s => s.Name == "English").DepartmentlD 

b 

b 

foreach (Course c in courses) 

{ 

context.Courses.Add(c); 

} 

context.SaveChanges(); 

var officeAssignments = new OfficeAssignment[] 

{ 

new OfficeAssignment { 

InstructorlD = instructors.Single( i => İ.LastName == "Fakhouri").ID, 

Location = "Smith 17" }, 
new OfficeAssignment { 

InstructorlD = instructors.Single( i => İ.LastName == "Harui").ID, 

Location = "Gowan 27" }, 
new OfficeAssignment { 

InstructorlD = instructors.Single( i => İ.LastName == "Kapoor").ID, 

Location = "Thompson 304" }, 

b 

foreach (OfficeAssignment o in officeAssignments) 

{ 

context .OfficeAssignments .Add (o); 

} 

context.SaveChanges(); 

var courselnstructors = new CourseAssignment[] 

{ 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title == "Chemistry" ).CourselD, 

InstructorlD = instructors.Single(i => i.LastName == "Kapoor").ID 

b 
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}; 
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CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 
}, 

new CourseAssignment { 

CounselD = courses.Single(c => c.Title 
InstructonlD = instructors.Single(i => 
}, 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructons.Single(i => 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 
}, 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 
}, 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 
}, 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 


== "Chemistry" ).CourselD, 
i.LastName == "Harui").ID 

== "Microeconomics" ).CourselD., 
i.LastName == "Zheng").ID 

== "Macroeconomics" ).CourselD, 
i.LastName == "Zheng").ID 

== "Calculus" ).CourselD, 
i.LastName == "Fakhouri").ID 


== "Trigonometry" ).CourselD, 
i.LastName == "Harui").ID 

== "Composition" ).CourselD, 
i.LastName == "Abercrombie").ID 


== "Literatüre" ).CourselD, 
i.LastName == "Abercrombie").ID 


foreach (CourseAssignment ci in courselnstructors) 

{ 

context.CourseAssignments.Add(ci); 

} 

context.SaveChanges(); 


var enrollments = new Enrollment[] 

{ 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Alexander").ID, 
CourselD = courses.Single(c => c.Title == "Chemistry" ).CourselD, 

Grade = Grade.A 

}, 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Alexander").ID, 
CourselD = courses.Single(c => c.Title == "Microeconomics" ).CourselD, 
Grade = Grade.C 

L 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Alexander").ID, 
CourselD = courses.Single(c => c.Title == "Macroeconomics" ).CourselD, 
Grade = Grade.B 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Alonso").ID, 
CourselD = courses.Single(c => c.Title == "Calculus" ).CourselD, 

Grade = Grade.B 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Alonso").ID, 
CourselD = courses.Single(c => c.Title == "Trigonometry" ).CourselD, 
Grade = Grade.B 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Alonso").ID, 

CourselD = courses.Single(c => c.Title == "Composition" ).CourselD, 
Grade = Grade.B 
}, 

new Enrollment { 


StudentlD = students.Single(s => s.LastName == "Anand").IDj 
CourselD = courses.Single(c => c.Title == "Chemistry" ).CourseID 
}, 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Anand").IDj 
CounselD = counses.Single(c => c.Title == "Microeconomics").CourselDj 
Gnade = Grade.B 
}, 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Barzdukas").IDj 
CounselD = counses.Single(c => c.Title == "Chemistry").CourselDj 
Grade = Grade.B 
}, 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Li").IDj 
CourselD = courses.Single(c => c.Title == "Composition").CourselDj 
Grade = Grade.B 

b 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Tustice").IDj 
CourselD = courses.Single(c => c.Title == "Literatüre").CourselDj 
Grade = Grade.B 
} 

}J 

foreach (Enrollment e in enrollments) 

{ 

var enrollmentlnDataBase = context.Enrollments.Where( 
s => 

s.Student.ID == e.StudentlD && 

s.Course.CourselD == e.CourselD).SingleOrDefault(); 
if (enrollmentlnDataBase == null) 

{ 

context.Enrollments.Add (e); 

} 

} 

context.SaveChanges(); 

} 

} 

} 

ilk öğreticide gördüğünüz gibi, bu kodun çoğu yalnızca yeni varlık nesneleri oluşturur ve test için gereken şekilde, 
örnek verileri özelliklere yükler. Çoktan çoğa ilişkilerin nasıl işlendiği hakkında dikkat edin: kod, Enrollments 
varlıklar oluşturup courseAssignment varlık kümelerine katmak yoluyla ilişkiler oluşturur. 

Geçiş Ekle 


Değişikliklerinizi kaydedin ve projeyi derleyin. Ardından proje klasöründe komut penceresini açın ve 
migrations add komutunu girin (henüz Update-database komutunu yapmayın): 



An operation was scaffolded that may result in the loss of data. Please review the migration for accuracy. 
Done. To undo this actionj use 'ef migrations remove' 


database update komutunu bu noktada çalıştırmayı denediyseniz (henüz yapmayın), şu hatayı alırsınız: 

ALTER TABLE ifadesi, "FK_dbo yabancı anahtar kısıtlaması ile çakışıyor. Course_dbo. 

Department_DepartmentlD ". "ContosoUniversity" veritabanında, "dbo" tablosunda çakışma oluştu. Bölüm ", 





sütun 1 DepartmentlD 


Bazı durumlarda, mevcut verilerle geçişleri yürüttüğünüzde, yabancı anahtar kısıtlamalarını karşılamak için saplama 
verilerini veritabanına eklemeniz gerekir, up yönteminde oluşturulan kod, kurs tablosuna null yapılamayan bir 
DepartmentlD yabancı anahtarı ekler. Kurs tablosunda kod çalıştırıldığında zaten satırlar varsa, SQL Server null 
olmayan sütuna hangi değerin yerleştirileceğini bilmediği için Addcolumn işlemi başarısız olur. Bu öğreticide, geçişi 
yeni bir veritabanında çalıştıracaksınız, ancak bir üretim uygulamasında geçiş, mevcut verileri işleyeceğinizden, bu 
sayede bunun nasıl yapılacağını gösteren bir örnek gösterilmektedir. 

Bu geçişi mevcut verilerle birlikte çalışarak, yeni sütuna varsayılan bir değer vermek için kodu değiştirmeniz ve 
varsayılan departman görevi gören "Temp" adlı bir saplama departmanı oluşturmanız gerekir. Sonuç olarak, 
mevcut kurs satırları up yöntemi çalıştıktan sonra "geçici" departmanla ilgili olacaktır. 

• {Timestamp}_ComplexDataModel. cs dosyasını açın. 

• DepartmentlD sütununu kurs tablosuna ekleyen kod satırını açıklama satırı yapın. 

migrationBuilder.AlterColumn<string>( 
name: "Title", 
table: "Course", 
maxl_ength: 50, 
nullable: true, 
oldClrType: typeof(stning), 
oldNullable: true); 

//migrationBuilder.AddColumn<int>( 

// name: "DepartmentlD", 

// table: "Course", 

// nullable: false, 

// defaultValue: 0); 


• Departman tablosunu oluşturan koddan sonra aşağıdaki vurgulanmış kodu ekleyin: 







migrationBuilder.CreateTable( 
name: "Department", 
columns: table => new 
{ 

DepartmentlD = table.Column<int>(nullable: false) 

.Annotation("SqlServer:ValueGenerationStrategy", 

SqlServerValueGenerationStrategy.IdentityColumn), 

Budget = table.Column<decimal>(type: "money", nullable: false), 

InstructorlD = table.Column<int>(nullable: true). 

Name = table.Column<string>(maxl_ength: 50, nullable: true), 

StartDate = table.Column<DateTime>(nullable: false) 

L 

constraints: table => 

{ 

table.PrimaryKey("PK_Department", x => x.DepartmentlD); 
table.ForeignKey( 

name: "FK_Department_Instructor_InstructorID", 
column: x => x.InstructorlD, 
principalTable: "Instructor", 
principalColumn: "ID", 
onDelete: ReferentialAction.Restrict); 

}); 

migrationBuilder.Sql("INSERT INTO dbo.Department (Name, Budget, StartDate) VALUES ('Temp', 0.00, 
GETDATE())"); 

// Default value for FK points to department created above, with 
// defaultValue changed to 1 in following AddColumn statement. 

migrationBuilder.AddColumn<int>( 
name: "DepartmentlD", 
table: "Course", 
nullable: false, 
defaultValue: 1); 


Bir üretim uygulamasında, departman satırları eklemek ve kurs satırlarını yeni departman satırlarıyla 
ilişkilendirmek için kod veya komut dosyaları yazın. Bundan sonra "geçici" Departmanı veya kurs. Departmentl D 
sütununda Varsayılan değer gerekmez. 

Değişikliklerinizi kaydedin ve projeyi derleyin. 

Bağlantı dizesini değiştirme 

Artık, yeni varlıkların temel verilerini boş bir veritabanına ekleyen Dbinitializer sınıfında yeni kodunuz var. EF 'in 
yeni boş bir veritabanı oluşturmasını sağlamak için appSettings. JSON içindeki bağlantı dizesinde veritabanının 
adını ContosoUniversity3 veya kullandığınız bilgisayarda kullanmadığınız başka bir adla değiştirin. 

{ 

"ConnectionStrings": { 

"DefaultConnection": "Server= 

(localdb)\\mssqllocaldb;Database=Contosollniversity3;Trusted_Connection=True;MultipleActiveResultSets=true" 

L 


Değişiklerinizi appSettings. JSON' da kaydedin. 





NOTE 

Veritabanı adını değiştirmeye alternatif olarak, veritabanını silebilirsiniz. SQL Server Nesne Gezgini (ssox) veya 
database drop CLI komutunu kullanın: 

dotnet ef database drop 


Veritabanını güncelleştirme 

Veritabanı adını değiştirdikten veya veritabanını sildikten sonra, geçişleri yürütmek için komut penceresinde 
database update komutunu çalıştırın. 

dotnet ef database update 

Dbinitializer.initialize yönteminin çalışmasına ve yeni veritabanını doldurmasına neden olmak için uygulamayı 
çalıştırın. 

Veritabanını daha önce yaptığınız gibi SSOX içinde açın ve tabloların tümünün oluşturulduğunu görmek için Tables 
düğümünü genişletin. (Yine de bir daha önceki zamanda SSOX açıksa Yenile düğmesine tıklayın.) 

SQL Server Object bcplorer ~ □ X 

6 | + l *s 

a gî SQL Server 

a Şj (localdb)\MSSQLLocalDB(SQL Server 13.0. 
a a )atabases 

> ^ System Databases 

a y aspnet-ContosoUniversity20160816 
a O Tables 

> M System Tables 

> M External Tables 

> B dbo._EFMİgrationsHistory 

> B dbo.Course 

> B dbo.CourseAssignment 

> B dbo.Department 

> B dbo.EnrolIment 

> B dbo.lnstructors 

> B dbo.OfficeAssignment 

> B dbo.Student 



Veritabanını gösteren Başlatıcı kodunu tetiklemek için uygulamayı çalıştırın. 

Courseatama tablosuna sağ tıklayın ve verileri görüntüle 1 yi seçerek veri içerdiğinden emin olun. 


























Kodu alın 

Tamamlanmış uygulamayı indirin veya görüntüleyin. 

Sonraki adımlar 

Bu öğreticide şunları yaptınız: 

• Veri modeli özelleştirildi 

• Öğrenci varlığında değişiklikler yapıldı 

• Eğitmen varlığı oluşturuldu 

• OfficeAssignment varlığı oluşturuldu 

• Değiştirilen kurs varlığı 

• Departman varlığı oluşturuldu 

• Değiştirilen kayıt varlığı 

• Veritabanı bağlamı güncelleştirildi 

• Test verileriyle birlikte sağlanan veritabanı 

• Geçiş eklendi 

• Bağlantı dizesi değiştirildi 

• Veritabanı güncelleştirildi 

ilgili verilere erişme hakkında daha fazla bilgi edinmek için sonraki öğreticiye ilerleyin. 
Sonraki: ilgili verilere erişin 


Öğretici: EF Core ile ilgili verileri okuma-ASRNET 
MVC 

23.11.2019 * 22 minutes to read ı Edit Online 


Önceki öğreticide, okul veri modelini tamamladınız. Bu öğreticide ilgili verileri okur ve görüntüleriz. Bu, Entity 
Framevvork, gezinti özelliklerine yüklediği veriler. 

Aşağıdaki çizimlerde, birlikte çalışacağımız sayfalar gösterilmektedir. 


E3 Courses - Contoso Univ X + 


□ X 

^ localhost:58 

☆ 

=- m 

■••••■ 

Contoso University 


— 


Courses 


Create New 


Number 

Title 

Credits 

Department 


1045 

Calculus 

4 

Mathematics 

Edit | Details | Delete 

1050 

Chemistry 

3 

Engineering 

Edit | Details | Delete 

2021 

Composition 

3 

English 

Edit | Details | Delete 











B Instructors - Contoso Uı X 


- □ X 

—• Ç_) localhost:5813/lnstaıctors/lndex/1? 

☆ 

- m & - 

Contoso University 


_ j 


Instructors 


Create New 



First 

Hire 




Last Name 

Name 

Date 

Office 

Courses 


Abercrombie 

Kim 

1995- 


2021 Composition 

Select | Edit | 



03-11 


2042 Literatüre 

Details | Delete 

Fakhouri 

Fadi 

2002- 

Smith 17 

1045 Calculus 

Select | Edit | 



07-06 



Details | Delete 

Harui 

Roger 

1998- 

Gowan 27 

1050 Chemistry 

Select | Edit | 



07-01 


3141 Trigonometry 

Details | Delete 



Courses Taught by Selected Instructor 



Number 

Title 

Department 

Select 

2021 

Composition 

English 

Select 

2042 

Literatüre 

English 


Students Enrolled in Selected Course 


Name 

Grade 

Alonso, Meredith 

B 

Li, Yan 

B 



/* / 



Bu öğreticide şunları yaptınız: 

• ilgili verileri yüklemeyi öğrenin 

• Kurslar sayfası oluşturma 

• Eğitmenler sayfası oluşturma 

• Açık yükleme hakkında bilgi edinin 

Önkoşullar 

• Karmaşık veri modeli oluşturma 

İlgili verileri yüklemeyi öğrenin 

Entity Framevvork gibi nesne İlişkisel eşleme (ORM) yazılımının bir varlığın gezinti özelliklerine ilgili verileri 
yükleyebilmesinin birkaç yolu vardır: 

• Eager yükleniyor. Varlık okurken ilgili veriler onunla birlikte alınır. Bu, genellikle gereken tüm verileri alan tek 












bir JOIN sorgusuna neden olur, inciude ve Theninciude yöntemlerini kullanarak Entity Framevvork Core 1 
de bir Eager yüklemesi belirlersiniz. 


var departments = _context.Departments.Irıclude(d => d.courses); 
foreach (Department d in departments) 

foreach(course c in d.courses) Query: ali Department entities 


{ 


courseList.Add(d.Name + c.Title); 


le)j 


and related Course entities 


J 


Bazı verileri ayrı sorgularda alabilir ve "düzeltmeler" i "düzeltir" seçeneğini kullanabilirsiniz. Diğer bir deyişle, 
EF, daha önce alınan varlıkların gezinti özelliklerine ait oldukları ayrı alınan varlıkları otomatik olarak ekler, 
ilgili verileri alan sorgu için, ToList veya single gibi bir liste veya nesne döndüren bir yöntem yerine Load 
yöntemini kullanabilirsiniz. 


var departments = _context.Departments; 
foreach (Department d in departments) 

{ 


c 


Ouery ali Department rows 

X 


_context.Courses.Where(c => c.DepartmentlD == d.DepartmentlD).Load(); 
foreach (Course c in d.Courses) 

{ 

courseList.Add(d.Name + c.Title); 

} 


Query: Course rows related to Department d 


J 


• Açık yükleme. Varlık ilk kez okunmadıysa ilgili veriler alınmadı. Gerekirse ilgili verileri alan kodu yazarsınız. 
Ayrı sorgularla yükleme durumunda olduğu gibi, açıkça yükleme, veritabanına gönderilen birden çok sorgu 
ile sonuçlanır. Fark, açık yükleme ile kod, yüklenecek gezinti özelliklerini belirtir. Entity Framevvork Core 1,1 1 
de, açık yükleme yapmak için Load yöntemini kullanabilirsiniz. Örneğin: 


var departments = _context.Departments; 
foreach (Department d in departments) 

{ 


Ûuery: ali Department rows 


_context.Entry(d)-Collection(p => p.Courses).Load(); 
foreach (Course c in d.courses) ^ 

t | ûuery: Course rows related to Department 

courseList.Add(d.Name + c.Title); 

} 



• Yavaş yükleme. Varlık ilk kez okunmadıysa ilgili veriler alınmadı. Ancak, bir gezinti özelliğine ilk kez erişmeye 
çalıştığınızda, bu gezinti özelliği için gereken veriler otomatik olarak alınır. Bir gezinti özelliğinden ilk kez veri 
almaya çalıştığınızda veritabanına bir sorgu gönderilir. Entity Framevvork Core 1,0, yavaş yüklemeyi 
desteklemez. 

Performans değerlendirmeleri 

Alınan her varlık için ilgili verilerin gerekli olduğunu biliyorsanız, tek bir sorgu genellikle en iyi performansı sunar, 
çünkü veritabanına gönderilen tek bir sorgu genellikle alınan her varlık için ayrı sorgulardan daha etkilidir. Örneğin, 
her departmanın on ile ilgili kurs olduğunu varsayalım. Tüm ilgili verilerin bir şekilde yüklenmesi, tek bir (JOIN) 
sorgusuna ve veritabanına yönelik tek gidiş dönüş oluşmasına neden olur. Her bölüme yönelik kurslar için ayrı bir 
sorgu, veritabanı üzerinde on bir gidiş dönüş oluşmasına neden olur. Gecikme süresi yüksek olduğunda 
veritabanına yönelik ek gidiş dönüşler özellikle performansa neden olur. 

Öte yandan, bazı senaryolarda ayrı sorgular daha etkilidir. Tek bir sorgudaki ilgili verilerin tümünü yükleme, SOL 
Server verimli bir şekilde bir birleştirmenin oluşturulmasına neden olabilir ve bu da etkili bir şekilde işleyemez. Ya 
da bir varlığın gezinti özelliklerine yalnızca işlemekte olduğunuz varlıkların kümesinin bir alt kümesi için erişmeniz 
gerekiyorsa, her şeyin en baştan yüklenmesi gerekenden fazla veri alacağından ayrı sorgular daha iyi çalışabilir. 
Performans önemliyse, en iyi seçimi yapmak için her iki şekilde de performansı test etmek en iyisidir. 


Kurslar sayfası oluşturma 


Kurs varlığı, kursun atandığı departmanın departman varlığını içeren bir gezinti özelliği içerir. Bir kurs listesinde 





















atanan departmanın adını göstermek için, course.Department Gezinti özelliğindeki departman varlığındaki Name 
özelliğini almanız gerekir. 


Aşağıdaki çizimde gösterildiği gibi, daha önce öğrenciler denetleyicisi için yaptığınız Entity Framework desteği' ı 
kullanarak, MVC denetleyicisi için, görünümler ile aynı seçenekleri kullanarak kurs varlık türü için 


coursescontroller adlı bir denetleyici oluşturun: 

Add Controller 



X 

Model elass: 

Course (ContosoUniversity.Models) 

_ 

Data context elass: 

SchoolContext (ContosoUniversity.Data) 

[+] 


Views: 

171 Generate views 

171 Reference script libraries 

171 Use a layout page: 


(Leave empty if it is set in a Razor_viewstart file) 


Controller name: 


CoursesController 




Add 


Cancel 


CoursesController.es 'i açın ve index metodunu inceleyin. Otomatik yapı iskelesi, Department gezinti özelliği için 
inelude yöntemi kullanılarak bir Eager yüklemesi belirtti. 

index yöntemini, kurs varlıklarını döndüren iQueryabie için daha uygun bir ad kullanan aşağıdaki kodla değiştirin 
( schoolContext yerine courses ): 

public async Task<IActionResıılt> Index() 

{ 

var courses = _context.Courses 
.Include(c => c.Department) 

.AsNoTracking(); 

return View(await courses.ToLlstAsync()); 


Views/kurstar/lndex. cshtml dosyasını açın ve şablon kodunu aşağıdaki kodla değiştirin. Değişiklikler vurgulanır: 












































@model IEnumerablecContosoUniversity.Models. Course> 

@{ 

ViewData["Title"] = "Courses"; 

} 

<h2>Courses</h2> 

<P> 

<a asp-action="Create">Create New</a> 

</p> 

ctable class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model => model.CourselD) 

</th> 

<th> 

@Html.DisplayNameFor(model = > model.Title) 

</th> 

<th> 

@Html.DisplayNameFor(model = > model.Cnedlts) 

</th> 

<th> 

@Html.DisplayNameFor(model = > model.Department) 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

(Şforeach (var item in Model) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.CourselD) 

</td> 

<td> 

@Html.DisplayFor(modelItem => İtem.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Credits) 

</td> 

<td> 

@Fltml.DisplayFor(modelItem => item.Department.Name) 

</td> 

<td> 

<a asp-action="Edit" asp-route-id="@item.CourseID">Edit</a> | 

<a asp-action="Details" asp-route-id="@item.CourseID">Details</a> | 
<a asp-action="Delete" asp-route-id="@item.CourseID">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 


Yapı iskelesi kodunda aşağıdaki değişiklikleri yaptınız: 

• Başlık dizinden kurslar olarak değiştirildi. 

• courseiD özellik değerini gösteren bir sayı sütunu eklendi. Birincil anahtarlar, genellikle son kullanıcılara 
anlamlı olduklarından, varsayılan olarak yapı iskelesi göstermemektedir. Ancak, bu durumda birincil anahtar 
anlamlı olur ve göstermek istersiniz. 

• Departman adını göstermek için Departman sütunu değiştirildi. Kod, Department gezinti özelliğine 
yüklenen departman varlığının Name özelliğini görüntüler: 









@Html.DisplayFor(modelItem => item.Department.Name) 


Uygulamayı çalıştırın ve bölüm adlarıyla listeyi görmek için Kurslar sekmesini seçin. 


E3 Courses - Contoso Univ X + 


□ X 

^ localhost:58 

☆ 

rn^m 

Contoso University 


— 


Courses 


Create New 


Number 

Tîtle 

Credits 

Department 


1045 

Calculus 

4 

Mathematics 

Edit | Details | Delete 

1050 

Chemistry 

3 

Engineering 

Edit | Details | Delete 

2021 

Composition 

3 

English 

Edit | Details | Delete 


ı lt „ 


J^+01 ■■■** 



Eğitmenler sayfası oluşturma 

Bu bölümde, Eğitmenler sayfasını görüntülemek için eğitmen varlığı için bir denetleyici ve görünüm 
oluşturacaksınız: 










B Instructors - Contoso Uı X 


- □ X 

—• Ç_) localhost:5813/lnstnıctors/lndex/1? 

☆ 

- m & - 

Contoso üniversity 


_ j 


Instructors 


Create New 



First 

Hire 




Last Name 

Name 

Date 

Office 

Courses 


Abercrombie 

Kim 

1995- 


2021 Composition 

Select | Edit | 



03-11 


2042 Literatüre 

Details | Delete 

Fakhouri 

Fadi 

2002- 

Smith 17 

1045 Calculus 

Select | Edit | 



07-06 



Details | Delete 

Harui 

Roger 

1998- 

Govvan 27 

1050 Chemistry 

Select | Edit | 



07-01 


3141 Trigonometry 

Details | Delete 



Courses Taught by Selected Instructor 



Number 

Title 

Department 

Select 

2021 

Composition 

English 

Select 

2042 

Literatüre 

English 

Students Enrolled in Selected Course 


Name 



Grade 

Alonso, Meredittı 



B 

Li, Yan 


__ 

B 


Bu sayfa aşağıdaki yollarla ilgili verileri okur ve görüntüler: 

• Eğitmenler listesi, OfficeAssignment varlığındaki ilgili verileri görüntüler. Eğitmen ve OfficeAssignment 
varlıkları bire sıfır veya-bir ilişkidir. OfficeAssignment varlıkları için Eager yükleme kullanacaksınız. Daha 
önce açıklandığı gibi, birincil tablonun alınan tüm satırları için ilgili verilere ihtiyacınız olduğunda Eager 
yüklemesi genellikle daha etkilidir. Bu durumda, tüm görüntülenen Eğitmenler için Office atamalarını 
göstermek istersiniz. 

• Kullanıcı bir eğitmen seçtiğinde ilgili kurs varlıkları görüntülenir. Eğitmen ve kurs varlıkları çoktan çoğa bir 
ilişkidir. Kurs varlıkları ve ilgili departman varlıkları için Eager yükleme kullanacaksınız. Bu durumda, yalnızca 
seçili eğitmen için kurslar gerektiğinden ayrı sorgular daha verimli olabilir. Ancak, bu örnek, gezinti özellikleri 
1 nde olan varlıkların içindeki gezinti özellikleri için Eager yükleme 'nin nasıl kullanılacağını gösterir. 

• Kullanıcı bir kurs seçtiğinde, kayıt varlığı kümesindeki ilgili veriler görüntülenir. Kurs ve kayıt varlıkları bire 
çok ilişkisinde. Kayıt varlıkları ve ilgili öğrenci varlıkları için ayrı sorgular kullanacaksınız. 

Eğitmen dizini görünümü için bir görünüm modeli oluşturun 

Eğitmenler sayfasında, üç farklı tablodan alınan veriler gösterilir. Bu nedenle, her biri tablolardan birine ait verileri 









tutan üç özellik içeren bir görünüm modeli oluşturacaksınız. 

SchoolViev/Models klasöründe lnstructorlndexData.cs oluşturun ve mevcut kodu şu kodla değiştirin: 


using System; 

using System.Collections.Generic; 

using System.Linq; 

using System.Thneading.Tasks; 

namespace ContosoUniversity.Models.SchoolViewModels 

{ 

public class InstructorIndexData 

{ 

public IEnumerable<Instructor> Instnuctons { get; set; } 
public IEnumenable<Course> Courses { get; set; } 
public IEnumerable<Enrollment> Ennollments { get; set; } 

} 

} 


Eğitmen denetleyicisi ve görünümleri oluşturma 

Aşağıdaki çizimde gösterildiği gibi EF okuma/yazma eylemleri ile bir eğitmenler denetleyicisi oluşturun: 


Add Controller 


Model class: 


| Instructor (ContosoLIniversity.Models) | 

1 ~ v 1 

| SchoolContext (ContosoUniversity.Data) | 

1 -1 

E 


Vievvs: 

|3 Generate views 

171 Reference script libraries 

171 Use a layout page: 


□ 


(Leave empty if it is set in a Razor_viewstart file) 


Controller name: 


InstructorsController 


Add 


Cancel 


lnstructorsController.es açın ve VievvModel ad alanı için bir using ifadesini ekleyin: 


using ContosoUniversity.Models.SchoolViewModels; 


ilişkili verilerin yüklenmesini ve görünüm modeline koymak için Dizin yöntemini aşağıdaki kodla değiştirin. 








































public async Task<IActionResult> Index(int? id, int? courselD) 

{ 

var viewModel = new InstructorIndexData(); 
viewModel.Instructors = await _context.Instructors 
.Include(i = > i.OfficeAssignment) 

.Include(i = > i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Enrollments) 

.Thenlnclude(i => i.Student) 

.Include(i = > İ.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Department) 

.AsNoTracking() 

.OrderBy(i => i.LastName) 

.Tol_istAsync(); 

if (id != null) 

{ 

ViewData["InstructorID"] = id.Value; 

Instructor instructor = viewModel.Instructors.Where( 
i => i.ID == id.Value).Single(); 

viewModel.Courses = instructor.CourseAssignments.Select(s => s.Course); 

} 

if (courselD != null) 

{ 

ViewData["CourselD"] = courselD.Value; 
viewModel.Enrollments = viewModel.Courses.Where( 

x => x.CourselD == courselD).Single().Enrollments; 

} 

return View(viewModel); 

} 

Yöntemi, seçilen eğitmenin ve seçili kursun KİMLİK değerlerini sağlayan isteğe bağlı yol verilerini ( id ) ve bir sorgu 
dizesi parametresini ( courselD ) kabul eder. Parametreler, sayfadaki Köprü seçme ile sağlanır. 

Kod, görünüm modelinin bir örneğini oluşturarak ve bu örneğe eğitmen listesine yerleştirilerek başlar. Kod, 



Görünüm her zaman OfficeAssignment varlığını gerektirdiğinden, bunu aynı sorguda getirmek daha etkilidir. Web 
sayfasında bir eğitmen seçildiğinde kurs varlıkları gereklidir, bu yüzden tek bir sorgu birden çok sorgudan daha 
iyidir, bu nedenle yalnızca sayfa, hiçbir zaman tarafından seçilen bir kurs ile daha sık görüntüleniyorsa. 


Course 

iki özelliği gerektiğinden, kod 

CourseAssignments 

yinelenir ve 

Course . 

Thenlnclude 

çağrılarının ilk dizesi 

CourseAssignment.Course , 

Course.Enrollments ve 

Enrollment.Student . 

alır. 

















viewModel.Instructors = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i = > i.Course) 

.Thenlnclude(i = > i.Enrollments) 

.Thenlnclude(i = > i.Student) 

.Include(i => i.CounseAssignments) 

.Thenlnclude(i => i.Counse) 

.Thenlnclude(i = > i.Depantment) 

.AsNoTnacking() 

.OndenBy(i => i.LastName) 

.ToListAsync(); 

Kodun bu noktasında, başka bir Theninciude , gerekli student gezinti özellikleri için olacaktır. Ancak inciude 
çağrılması instnucton özellikleriyle çalışmaya başlar, bu kez, bu kez counse.Ennoliments yerine counse.Depantment 
belirterek zinciri yeniden gitmeniz gerekir. 

viewModel.Instnuctons = await _context.Instnuctons 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CounseAssignments) 

.Thenlnclude(i = > i.Counse) 

.Thenlnclude(i = > i.Ennollments) 

.Thenlnclude(i = > i.Student) 

.Include(i => i.CounseAssignments) 

.Thenlnclude(i => i.Counse) 

.Thenlnclude(i = > i.Depantment) 

.AsNoTnacking() 

.OndenBy(i => i.LastName) 

.ToListAsync(); 


Aşağıdaki kod, bir eğitmen seçildiğinde yürütülür.Seçilen eğitmen, görünüm modelindeki eğitmenler listesinden 
alınır. Görünüm modelinin counses özelliği daha sonra bu eğitmenin counseAssignments gezinti özelliğinden kurs 
varlıklarıyla yüklenir. 

if (id != null) 

{ 

ViewData["InstnuctonID"] = id.Value; 

instnucton instnucton = viewModel.Instnuctons.Whene( 
i => i.ID == id.Value).Single(); 

viewModel.Counses = instnucton.CounseAssignments.Select(s => s.Course); 

} 

whene yöntemi bir koleksiyon döndürür, ancak bu yönteme geçirilen kriterler yalnızca tek bir eğitmen varlığının 
döndürüldüğünden sonuçlanır, single yöntemi, koleksiyonu tek bir eğitmen varlığına dönüştürür, bu da o varlığın 
CounseAssignments Özelliğine erişmenizi sağlar. CounseAssignments Özelliği, yalnızca ilgili Counse varlıklarını 
istediğiniz counseAssignment varlıkları içerir. 

Koleksiyonun yalnızca bir öğesi olacağını bildiğiniz durumlarda single yöntemini bir koleksiyonda kullanırsınız. 
Tek yöntem, koleksiyon boş veya birden fazla öğe varsa bir özel durum oluşturur. Bir alternatif, koleksiyon boşsa 
varsayılan bir değer (Bu durumda null) döndüren singleOnDefault . Bununla birlikte, bu durumda yine de bir özel 
durumla sonuçlanacaktır (null başvuru üzerinde courses özelliği bulmaya çalışırken) ve özel durum iletisi sorunun 
nedenini daha az gösterir, single yöntemini çağırdığınızda, ayrıca where yöntemini ayrı çağırmak yerine VVHERE 
koşulunu da geçirebilirsiniz: 

•Single(i => i.ID == id.Value) 


Onun yerine: 























.Where(i => i.ID == id.Value).Single() 


Ardından, bir kurs seçilmişse, seçilen kurs, görünüm modelindeki kurslar listesinden alınır. Ardından, görünüm 
modelinin Enroiiments özelliği, bu kursun Enroiiments gezinti özelliğinden kayıt varlıklarıyla yüklenir. 


if (courselD != null) 

{ 

ViewData["CourseID"] = courselD.Value; 
viewModel.Enrollments = viewModel.Courses.Where( 

x => x.CourselD == courselD).Single().Enrollments; 

} 


Eğitmen dizini görünümünü değiştirme 

Views/eğitmenier/!ndex. cshfm/içinde, şablon kodunu aşağıdaki kodla değiştirin. Değişiklikler vurgulanır. 








@model ContosoUniversity. Models. SchoolViewModels. InstructonIndexData 

@{ 

ViewData["Title"] = "Instructors"; 

} 

<h2>Instructors</h2> 

<P> 

<a asp-action="Create">Create New</a> 

</p> 

<table class="table"> 

<thead> 

<tr> 

<th>Last Name</th> 

<th>First Name</th> 

<th>Hire Date</th> 

<th>Office</th> 

<th>Courses</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

Şforeach (var item in Model.Instructors) 

{ 

string selectedRow = 

if (item.ID == (int?)ViewData["InstructorID"]) 

{ 

selectedRow = "success"; 

} 

<tr class="@selectedRow"> 

<td> 

@Html.DisplayFor(modelItem => item.LastName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item. FirstMidName) 

</td> 

<td> 

@Fltml.DisplayFor(modelItem => item.HireDate) 

</td> 

<td> 

Şif (item.OfficeAssignment != null) 

{ 

Şitem.OfficeAssignment.Location 

} 

</td> 

<td> 

foreach (var course in item.CourseAssignments) 

{ 

Şcourse.Course.CourselD Şcourse.Course.Title <br /> 

} 

} 

</td> 

<td> 

<a asp-action="Index" asp-route-id="@item.ID">Select</a> | 

<a asp-action="Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-action="Details" asp-route-id="@item.ID">Details</a> | 

<a asp-action="Delete" asp-route-id="@item.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 


Varolan koda aşağıdaki değişiklikleri yaptınız: 



• Model sınıfı instructorindexData olarak değiştirildi. 


• Sayfa başlığı dizinden eğitmenlerolarak değiştirildi. 

• Yalnızca item.officeAssignment null olmaması durumunda item.officeAssignment.Location görüntüleyen bir 
Office sütunu eklendi. (Bu bire sıfır veya-bir ilişki olduğundan ilgili bir OfficeAssignment varlığı 
bulunmayabilir.) 

@if (İtem.officeAssignment != null) 

{ 

(Sitem.OfficeAssignment.Location 

} 

• Her bir eğitmen tarafından taders kurslarını görüntüleyen bir Kurslar sütunu eklendi. Daha fazla bilgi için 
Razor söz dizimi makalesinin Açık çizgi geçişi bölümüne bakın. 

• Seçilen eğitmenin tr öğesine dinamik olarak ciass="success" ekleyen kod eklendi. Bu, bir önyükleme sınıfı 
kullanarak seçili satır için bir arka plan rengi ayarlar. 

string selectedRow = 

if (item.ID == (int?)ViewData["InstructorID"]) 

{ 

selectedRow = "success"; 

} 

<tr class="@selectedRow"> 

• Her satırdaki diğer bağlantılardan hemen önce Seç etiketli yeni bir köprü eklendiğinde, SEÇİLEN eğitmenin 
kimliğinin index yöntemine gönderilmesine neden olur. 

<a asp-action="Index" asp-route-id="@item.ID">Select</a> | 


Uygulamayı çalıştırın ve eğitmenler sekmesini seçin. Sayfa ilgili OfficeAssignment varlıklarının Location özelliğin 
ve ilişkili OfficeAssignment varlığı olmadığında boş bir tablo hücresini görüntüler. 
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Views/eğitmenler/lndex. cshtml dosyasında, Kapanış tablosu öğesinden sonra (dosyanın sonunda) aşağıdaki kodu 
ekleyin. Bu kod, bir eğitmen seçildiğinde bir eğitmenin ilgili kursların bir listesini görüntüler. 

















Şif (Model.Courses != null) 

{ 

<h3>Courses Taught by Selected Instructor</h3> 
ctable class="table"> 

<tr> 

<thx/th> 

<th>Number</th> 

<th>Title</th> 

<th>Department</th> 

</tr> 

Şforeach (var item in Model.Courses) 

{ 

string selectedRow = 

if (item.CourselD == (int?)ViewData["CourselD"]) 

{ 

selectedRow = "success"; 

} 

<tr class="ŞselectedRow"> 

<td> 

ŞHtml.Actionl_ink("Select", "Index", new { courselD = item.CourselD }) 

</td> 

<td> 

Şitem.CourselD 
</td> 

<td> 

Şitem.Title 
</td> 

<td> 

Şitem.Department.Name 
</td> 

</tr> 

} 

</table> 

} 

Bu kod, kurs listesini görüntülemek için görünüm modelinin courses özelliğini okur. Ayrıca, seçilen kursun 
KİMLİĞİNİ index Action yöntemine gönderen bir seçme Köprüsü de sağlar. 

Sayfayı yenileyin ve bir eğitmen seçin. Artık Seçili eğitmenin atandığı kursları görüntüleyen bir kılavuz görürsünüz 
ve her kurs için atanan departmanın adını görürsünüz. 
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Yeni eklediğiniz kod bloğundan sonra aşağıdaki kodu ekleyin. Bu, kurs seçildiğinde bir kursa kaydedilen 
öğrencilerin listesini görüntüler. 

@if (Model.Enrollments != null) 

{ 

<hS> 

Students Enrolled in Selected Course 
</h3> 

<table class="table"> 

<tr> 

<th>Name</th> 

<th>Gnade</th> 

</tr> 

@foreach (var item in Model.Enrollments) 

{ 

<tr> 

<td> 

@item.Student.FullName 
</td> 

<td> 

@Html.DisplayFor(modelItem => item.Grade) 

</td> 

</tr> 

} 

</table> 

} 


Bu kod, kursa kayıtlı öğrencilerin listesini görüntülemek için görünüm modelinin kayıtları özelliğini okur. 

Sayfayı yeniden yenileyip bir eğitmen seçin. Ardından, kayıtlı öğrenciler ve bunların onların listesini görmek için bir 
kurs seçin. 
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Açık yükleme hakkında 

lnstructorsController.es' de eğitmenler listesini aldığınızda, courseAssignments gezinti özelliği için bir Eager 
yüklemesi belirttiniz. 

Kullanıcılardan yalnızca, seçili bir eğitmenin ve kursla kayıtlarını yalnızca nadiren görmek istediğini varsayalım. Bu 
durumda, kayıt verilerini yalnızca istenirse yüklemek isteyebilirsiniz. Açık yüklemenin nasıl yapılacağını gösteren bir 
örnek görmek için index yöntemini aşağıdaki kodla değiştirin, bu da kayıtları için Eager yüklemesini kaldırır ve bu 
özelliği açıkça yükler. Kod değişiklikleri vurgulanır. 









public async Task<IActionResult> Index(int? id, int? courselD) 

{ 

var viewModel = new InstructorIndexData(); 
viein/Model.Instructors = await _context.Instructors 
.Include(i = > i.OfficeAssignment) 

.Include(i = > i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Department) 

.OrderBy(i => i.LastName) 

.ToListAsync(); 

if (id != null) 

{ 

ViewData["InstructorID"] = id.Value; 

Instructor instructor = viewModel.Instructors.Where( 
i => i.ID == id.Value).Single(); 

viewModel.Courses = instructor.CourseAssignments.Select(s => s.Course); 


if (courselD != null) 

{ 

ViewData["CourselD"] = courselD.Value; 

var selectedCourse = viewModel.Courses.Where(x => x.CourselD == courselD).Single(); 
await _context. Entry(selectedCourse) .Collection(x => x. Enrollments). LoadAsync(); 
foreach (Enrollment enrollment in selectedCourse.Enrollments) 

{ 

await _context.Entry(enrollment).Reference(x => x.Student).LoadAsync(); 

} 

viewModel.Enrollments = selectedCourse.Enrollments; 

} 

return View(viewModel); 


Yeni kod, eğitmen varlıklarını alan koddan kayıt verileri için Thenmclude Yöntem çağrılarını bırakır. Ayrıca 
AsNoTracking bırakır. Bir eğitmen ve kurs seçilirse, vurgulanan kod seçili kurs için kayıt varlıklarını ve her kayıt için 
öğrenci varlıklarını alır. 

Uygulamayı çalıştırın, şimdi eğitmenler dizin sayfasına gidin ve sayfada görüntülendikleriyle ilgili hiçbir fark 
görmezsiniz; ancak verilerin nasıl alındığını değiştirmiş olursunuz. 

Kodu alın 

Tamamlanmış uygulamayı indirin veya görüntüleyin. 

Sonraki adımlar 

Bu öğreticide şunları yaptınız: 

• ilgili verileri yükleme hakkında öğrenilen 

• Bir kurslar sayfası oluşturuldu 

• Bir eğitmenler sayfası oluşturuldu 

• Açık yükleme hakkında bilgi edinildi 

ilgili verileri güncelleştirme hakkında bilgi edinmek için sonraki öğreticiye ilerleyin. 

İlgili verileri güncelleştirme 




Öğretici: ilgili verileri güncelleştirme-ASRNET MVC EF 
Core 

11.10.2019 • 27 minutes to readı Edit Online 


Önceki öğreticide ilgili verileri görüntülediyseniz; Bu öğreticide, yabancı anahtar alanlarını ve gezinti özelliklerini 
güncelleştirerek ilgili verileri güncelleştireceksiniz. 

Aşağıdaki çizimlerde, üzerinde çalıştığınız sayfaların bazıları gösterilmektedir. 
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Bu öğreticide şunları yaptınız: 

• Kurslar sayfalarını özelleştirme 

• Eğitmenler düzenleme sayfası ekle 

• Düzenleme sayfasına kurslar ekleyin 

• Güncelleştirme silme sayfası 

• Sayfa oluşturmak için Office konumu ve kurslar ekleme 

Önkoşullar 

• ilgili verileri okuma 

Kurslar sayfalarını özelleştirme 

Yeni bir kurs varlığı oluşturulduğunda, mevcut bir departmanla bir ilişkisi olmalıdır. Bunu kolaylaştırmak için, yapı 
iskelesi kodu denetleyici yöntemlerini içerir ve departmanı seçmeye yönelik bir açılan liste içeren görünümler 
oluşturup düzenleyebilir. Açılır liste course.DepartmentiD yabancı anahtar özelliğini ayarlar ve ilgili departman 
varlığıyla Department gezinti özelliğini yüklemek için tüm Entity Framevvork ihtiyacı vardır.Scafkatmış kodu 
kullanacaksınız, ancak hata işleme eklemek ve açılan listeyi sıralamak için biraz değişiklik yapacaksınız. 

CoursesController.es' de, dört oluşturma ve düzenleme yöntemini silin ve bunları şu kodla değiştirin: 















public IActionResult Create() 

{ 

PopulateDepartmentsDropDownList(); 
return View(); 



{ 

if (id == null) 

{ 


return NotFound(); 

} 

var course = await _context.Courses 
.AsNoTracking() 

.FirstOrDefaultAsync(m => m.CourselD == id); 
if (course == null) 

{ 

return NotFound(); 

} 

PopulateDepartmentsDropDownList(course.DepartmentID); 
return View(course); 



[HttpPostj ActionName("Edit")] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> EditPost(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var courseToUpdate = await _context.Courses 

.FirstOrDefaultAsync(c => c.CourselD == id); 

if (await TryUpdateModelAsync<Course>(courseToUpdate, 

i 

c => c.Credits, c => c.DepartmentlD, c => c.Title)) 

{ 

try 

{ 

await _context.SaveChangesAsync(); 

} 

catch (DbUpdateException /* ex */) 

{ 

//Log the error (uncomment ex variable name and write a log.) 
ModelState.AddModelErrorC"’, "Unable to save changes. " + 

"Try again, and if the problem persists, " + 

"see your system administrator."); 

} 

return RedirectToAction(nameof(Index)); 

} 

PopulateDepartmentsDropDownList(courseToUpdate.DepartmentlD); 
return View(courseToUpdate); 

} 


@No__t-0 HttpPost yönteminden sonra, açılan liste için departman bilgisini yükleyen yeni bir yöntem oluşturun. 

private void PopulateDepartmentsDropDownList(object selectedDepartment = null) 

{ 

var departmentsQuery = from d in _context.Departments 
orderby d.Name 
select d; 

ViewBag.DepartmentlD = new SelectList(departmentsQuery.AsNoTracking(), "DepartmentlD", "Name", 
selectedDepartment); 

} 

@No__t-0 yöntemi, ada göre sıralanmış tüm bölümlerin bir listesini alır, açılan liste için bir selectList koleksiyonu 
oluşturur ve koleksiyonu viewBag 1 deki görünüme geçirir. Yöntemi, çağıran kodun, açılan liste işlendiğinde 
seçilecek öğeyi belirtmesini sağlayan isteğe bağlı selectedDepartment parametresini kabul eder. Görünüm, 
"DepartmentlD" adını <seiect> etiketi yardımcısından geçireceğini ve yardımcı sonra, "DepartmentlD" adlı bir 
SelectList için viewBag nesnesine baktığınızın bilmesini sağlar. 

HttpGet Create yöntemi, bölüm henüz kurulmadığı için, yeni bir kurs için seçili öğeyi ayarlamadan 
PopulateDepartmentsDropDownList yöntemini çağırır: 

public IActionResult Create() 

{ 

PopulateDepartmentsDropDownList(); 
return View(); 

} 


HttpGet Edit yöntemi, düzenlenen kursa zaten atanmış departmanın KIMLIğINE bağlı olarak seçili öğeyi ayarlar: 













public async Task<IActionResult> Edit(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var course = await _context.Courses 
.AsNoTracking() 

.FirstOrDefaultAsync(m => m.CourselD == id); 
if (course == null) 

{ 

return NotFound(); 

} 

PopulateDepartmentsDropDownList(course.DepartmentID); 
return View(course); 

} 

Hem Create hem de Edit için HttpPost yöntemleri, bir hatadan sonra sayfayı yeniden görüntülerken seçili öğeyi 
ayarlayan kodu da içerir. Bu, sayfa hata iletisini göstermek için yeniden görüntülendiğinde, seçilen departmanın 
seçili kalır olduğunu sağlar. 

Ekleyemiyorum. Ayrıntı ve silme yöntemlerine AsNoTracking 

Kurs ayrıntılarının ve sayfa silmenin performansını iyileştirmek için, Detaiis ve HttpGet Delete yöntemlerine 
AsNoTracking çağrıları ekleyin. 

public async Task<IActionResult> Details(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var course = await _context.Courses 
.Include(c => c.Department) 

.AsNoTracking() 

.FirstOrDefaultAsync(m => m.CourselD == id); 
if (course == null) 

{ 

return NotFound(); 

} 

return View(course); 

} 







public async Task<IActionResult> Delete(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var course = await _context.Courses 
.Include(c => c.Department) 

.AsNoTracking() 

.FirstOrDefaultAsync(m => m.CourselD == id); 
if (course == null) 

{ 

return NotFound(); 

} 

return View(course); 

} 


Kurs görünümlerini değiştirme 

Görünümler/kurslar/oluşturma, cshtml'de, Departman açılan listesine bir "Departman Seç" seçeneği ekleyin, 
DepartmentlD etiketini bölümolarak değiştirin ve bir doğrulama iletisi ekleyin. 

<div class="form-group"> 

clabel asp-for="Department" class="control-label"x/label> 

<select asp-for="DepartmentID" class="form-control" asp-items="ViewBag.DepartmentID"> 

<option value="">-- Select Department --</option> 

</select> 

<span asp-validation-for="DepartmentID" class="text-danger" /> 


Görünümler/kurslar/Düzenle. cshtml'de, Create. cshtm l\ç.\nde yaptığınız departman alanı için aynı değişikliği yapın. 

Ayrıca, Görünümler/kurslar/Düzenle. cshtml'de başlık alanından önce bir kurs numarası alanı ekleyin. Kurs 
numarası birincil anahtar olduğundan, görüntülenir, ancak değiştirilemez. 

<div class="form-group"> 

clabel asp-for="CourseID" class="control-label"x/label> 

<div>@Html.DisplayFor(model => model.CourseID)</div> 

</div> 

Düzenleme görünümündeki kurs numarası için gizli bir alan ( cinput type="hidden"> ) zaten var.@No__t-0 etiketi 
Yardımcısı eklemek, Kullanıcı düzenleme sayfasında Kaydet ' i tıklattığında, kurs numarasının gönderilen verilere 
dahil edilmesini neden olmadığı için gizli alanın gereksinimini ortadan kaldırmaz. 

Görünümler/kurslar/delete. cshtml'de, üst kısımdaki bir kurs numarası alanı ekleyin ve bölüm kimliğini bölüm adı 
olarak değiştirin. 










@model ContosoUniversity.Models.Course 

@{ 

ViewData["Title"] = "Delete"; 

} 

<h2>Delete</h2> 

<hB>Are you sure you want to delete this?</h3> 

<div> 

<h4>Course</h4> 

<hr /> 

<dl class="row"> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.CourselD) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.CourselD) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Title) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Title) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Credits) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Credits) 

</dd> 

<dt class="col-sm-2"> 

@Fltml.DisplayNameFor(model => model.Department) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Department.Name) 

</dd> 

</dl> 

<form asp-action="Delete"> 

<div class="form-actions no-color"> 

cinput type="submit" value="Delete" class="btn btn-default" /> | 
<a asp-action="Index">Back to List</a> 

</div> 

</form> 

</div> 


Görünümler/kurslar/ayrmtdar. cshtml'de, delete. cshtmi\ç\r\ yaptığınız aynı değişikliği yapın. 

Kurs sayfalarını test etme 

Uygulamayı çalıştırın, Kurslar sekmesini seçin, Yeni oluştur 1 a tıklayın ve yeni bir kurs için veri girin: 








Oluştur'a tıklayın. Kurslar Dizin sayfası, listeye eklenen yeni kursla birlikte görüntülenir. Dizin sayfası listesindeki 
departman adı, ilişkinin doğru şekilde oluşturulduğunu gösteren gezinti özelliğinden gelir. 


Kurslar Dizin sayfasında bir kursa Düzenle 1 ye tıklayın. 
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Sayfadaki verileri değiştirin ve Kaydet' e tıklayın. Kurslar Dizin sayfası, güncelleştirilmiş kurs verileriyle birlikte 
görüntülenir. 

Eğitmenler düzenleme sayfası ekle 

Bir eğitmen kaydını düzenlediğinizde, eğitmenin Office atamasını güncelleştirebilmek istersiniz. Eğitmen varlığı, 
OfficeAssignment varlığıyla bire sıfır veya-arasında bir ilişkiye sahiptir; bu, kodunuzun aşağıdaki durumları işlemesi 
gerektiği anlamına gelir: 

• Kullanıcı Office atamasını temizlediğinde ve başlangıçta bir değere sahipse, OfficeAssignment varlığını silin. 

• Kullanıcı bir Office atama değeri girerse ve başlangıçta boşsa, yeni bir OfficeAssignment varlığı oluşturun. 

• Kullanıcı bir Office atamasının değerini değiştirirse, var olan bir OfficeAssignment varlığındaki değeri 
değiştirin. 

Eğitmenler denetleyicisini güncelleştirme 

lnstructorsController.es' de, httpget Edit yöntemindeki kodu değiştirerek eğitmen varlığının OfficeAssignment 
gezinti özelliğini yükler ve AsNoTracking 1 i çağırır: 
















public async Task<IActionResult> Edit(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var instructor = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.AsNoTracking() 

.FirstOrDefaultAsync(m => m.ID == id); 
if (instructor == null) 

{ 

return NotFound(); 

} 

return View(instructor); 


Office atama güncelleştirmelerini işlemek için HttpPost Edit yöntemini aşağıdaki kodla değiştirin: 


[HttpPost, ActionName("Edit")] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> EditPost(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var instructorToUpdate = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.FirstOrDefaultAsync(s => s.ID == id); 

if (await TryllpdateModelAsync<Instructor>( 

İnstructorToUpdate, 

i 

i => i.FirstMidName, i => i.LastName, i => i.HireDate, i => İ.OfficeAssignment)) 

{ 

if (St ring. IsNullOrWhiteSpace( İnstructorToUpdate. Of ficeAssignment?.Location)) 

{ 

İnstructorToUpdate.OfficeAssignment = null; 

} 

try 

{ 

await _context.SaveChangesAsync(); 

} 

catch (DbUpdateException /* ex */) 

{ 

//Log the error (uncomment ex variable name and write a log.) 
ModelState.AddModelError("", "Unable to save changes. " + 

"Try again, and if the problem persists, " + 

"see your system administrator."); 

} 

return RedirectToAction(nameof(Index)); 

} 

return View(instructorToUpdate); 


Kod şunları yapar: 

• İmza artık HttpGet Edit yöntemiyle aynı olduğundan ( ActionName özniteliği /Edit/ URL'sinin hala 
kullanıldığını belirten), yöntem adını EditPost olarak değiştirir. 

• @No__t-0 gezinti özelliği için Eager yükleme kullanarak geçerli eğitmen varlığını veritabanından alır. Bu, 









HttpGet Edit yönteminde yaptığınız şeydir. 

• Alınan eğitmen varlığını model Ciltçideki değerlerle güncelleştirir.@No__t-0 aşırı yüklemesi, dahil etmek 
istediğiniz özellikleri beyaz listelemenize olanak sağlar. Bu, ikinci öğreticideaçıklandığı gibi, daha fazla 
nakletmeyi önler. 

if (await TryUpdateModelAsync<Instructor>( 
instructorToUpdate, 

3 

i => i.FirstMidName, i => i.LastName, i => i.HireDate, i => i.OfficeAssignment)) 


• Office konumu boşsa, OfficeAssignment tablosundaki ilgili satırın silinebilmesi için eğitmen. 
OfficeAssignment özelliğini null olarak ayarlar. 

if (String. IsNullOrWhiteSpace(instructorToUpdate.OfficeAssignment?. Location)) 

{ 

instructorToUpdate.OfficeAssignment = null; 

} 


• Değişiklikleri veritabanına kaydeder. 

Eğitmen düzenleme görünümünü güncelleştirme 

Görünümler/eğltmenler/Edit. cshtml' de, Kaydet düğmesinin sonundaki Office konumunu düzenlemek için yeni bir 
alan ekleyin: 

<div class="form-group"> 

dabel asp-for= "OfficeAssignment. Location" class="control-label"x/label> 
cinput asp-for="OfficeAssignment.Location" class="form-control" /> 

<span asp-validation-fon="OfficeAssignment.Location" class="text-danger" /> 

</div> 


Uygulamayı çalıştırın, eğitmenler sekmesini seçin ve ardından bir eğitmende Düzenle 1 ye tıklayın. Office 
konumunu değiştirin ve Kaydet' e tıklayın. 
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Düzenleme sayfasına kurslar ekleyin 

Eğitmenler, istediğiniz sayıda kurs öğretebilir. Artık, aşağıdaki ekran görüntüsünde gösterildiği gibi, bir grup onay 
kutusu kullanarak kurs atamalarını değiştirme özelliğini ekleyerek eğitmen düzenleme sayfasını geliştirirsiniz: 















Contoso University 


Edit 

Instructor 

Last Name 

Abercrombie 

First Name 

Kim 
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3/11/1995 

Office Location 

44/3P 
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Save 



Kurs ve eğitmen varlıkları arasındaki ilişki çoktan çoğa olur, ilişki eklemek ve kaldırmak için, kurs ekleme ve kurs, 
katılımcı varlık kümesine ekleme ve kaldırma. 

Bir eğitmenin hangi kurslara atandığını değiştirmenize olanak sağlayan kullanıcı arabirimi bir grup onay kutusu 
olur. Veritabanındaki her kurs için bir onay kutusu görüntülenir ve eğitmenin Şu anda atanmış olduğu yer seçilid 
Kullanıcı kurs atamalarını değiştirmek için onay kutularını seçebilir veya temizleyebilir. Kurs sayısı çok fazlaysa, 
büyük olasılıkla görünümde verileri göstermek için farklı bir yöntem kullanmak isteyeceksiniz, ancak ilişkiler 
oluşturmak veya silmek için bir JOIN varlığını işlemek için aynı yöntemi kullanmanız gerekir. 

Eğitmenler denetleyicisini güncelleştirme 

Onay kutuları listesinin görünümüne veri sağlamak için bir görünüm modeli sınıfı kullanacaksınız. 
SchoolViewModels klasöründe AssignedCourseData.es oluşturun ve mevcut kodu şu kodla değiştirin: 















using System; 

using System.Collections.Generic; 

using System.Linq; 

using System.Thneading.Tasks; 

namespace ContosoUniversity.Models.SchoolViewModels 

{ 

public class AssignedCourseData 

{ 

public int CourselD { get; set; } 
public stning Title { get; set; } 
public bool Assigned { get; set; } 

} 

} 

lnstructorsController.es' de, httpget Edit yöntemini aşağıdaki kodla değiştirin. Değişiklikler vurgulanır. 

public async Task<IActionResult> Edit(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var instructor = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments).Thenlnclude(i => i.Course) 

.AsNoTracking() 

.FirstOrDefaultAsync(m => m.ID == id); 
if (instructor == null) 

{ 

return NotFound(); 

} 

PopulateAssignedCourseData(instructor); 
return View(instructor); 

} 

private void PopulateAssignedCourseData(Instructor instructor) 

{ 

var allCourses = _context.Courses; 

var instructorCourses = new HashSet<int>(instructor.CourseAssignments.Select(c => c.CourselD)); 
var viewModel = new List<AssignedCourseData>(); 
foreach (var course in allCourses) 

{ 

viewModel.Add(new AssignedCourseData 

{ 

CourselD = course.CourselD, 

Title = course.Title, 

Assigned = İnstructorCourses.Contains(course.CourselD) 

}); 

} 

ViewData["Courses"] = viewModel; 

} 

Kod, Courses gezinti özelliği için Eager yüklemesi ekler ve AssignedCourseData View model sınıfını kullanarak onay 
kutusu dizisine bilgi sağlamak için yeni PopulateAssignedCourseData yöntemini çağırır. 

@No__t-0 yöntemindeki kod, görünüm modeli sınıfını kullanarak bir kurs listesi yüklemek için tüm kurs varlıklarını 
okur. Kod, her kurs için, kursun courses gezinti özelliğinde mevcut olup olmadığını denetler. Eğitmenin bir kurs 
atanıp atanmadığını denetlerken etkili arama oluşturmak için, eğitmene atanan kurslar HashSet koleksiyonuna 
konur. @No__t-0 özelliği, eğitmenin atandığı kurslar için true olarak ayarlanır.Görünüm, hangi onay kutularının 
seçili olarak gösterileceğini belirlemede bu özelliği kullanır. Son olarak, liste viewData ' daki görünüme geçirilir. 














Sonra, Kullanıcı Kaydet 1 i tıklattığında yürütülen kodu ekleyin. @No__t-0 yöntemini aşağıdaki kodla değiştirin ve 
eğitmen varlığının courses gezinti özelliğini güncelleştiren yeni bir yöntem ekleyin. 


[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Edit(int? id, string[] selectedCourses) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var instructorToUpdate = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.FirstOrDefaultAsync(m => m.ID == id); 

if (await TryUpdateModelAsync<Instructor>( 

İnstructorToUpdate, 

i 

i => i.FirstMidName, i => i.LastName, i => i.HireOate, i => i.OfficeAssignment)) 

{ 

if (St ring. IsNullOrWhiteSpace( İnstructorToUpdate. OfficeAssignment?.Location)) 

{ 

İnstructorToUpdate.OfficeAssignment = null; 

} 

UpdateInstructorCourses(selectedCourses, İnstructorToUpdate); 
try 
{ 

await _context.SaveChangesAsync(); 

} 

catch (DbUpdateException /* ex */) 

{ 

//Log the error (uncomment ex variable name and write a log.) 
ModelState.AddModelErrorC", "Unable to save changes. " + 

"Try again, and if the problem persists, " + 

"see your system administrator."); 

} 

return RedirectToAction(nameof(Index)); 

} 

UpdateInstructorCourses(selectedCourses, İnstructorToUpdate); 
PopulateAssignedCourseData(İnstructorToUpdate); 
return View(instructorToUpdate); 





private void UpdateInstructorCourses(string[] selectedCourses, Instructor instructorTolIpdate) 

{ 

if (selectedCourses == null) 

{ 

İnstructorTolIpdate.CourseAssignments = new List<CourseAssignment>(); 
return; 

} 

var selectedCoursesHS = new HashSet<string>(selectedCourses); 
var instructorCourses = new HashSet<int> 

(instructorTollpdate.CourseAssignments.Select(c => c.Course.CourselD)); 
foreach (var course in _context.Courses) 

{ 

if (selectedCoursesHS.Contains(course.CourseID.ToString())) 

{ 

if (!instructorCourses.Contains(course.CourselD)) 

{ 

İnstructorTolIpdate.CourseAssignments.Add(new CourseAssignment { InstructorlD = 
İnstructorTolIpdate. ID, CourselD = course.CourselD }); 

} 

} 

else 

{ 

if (instructorCourses.Contains(course.CourselD)) 

{ 

CourseAssignment courseToRemove = İnstructorTolIpdate.CourseAssignments.FirstOrDefault(i => 
i.CourselD == course.CourselD); 

_context.Remove(courseToRemove); 

} 

} 

} 

} 

Yöntem imzası artık HttpGet Edit yönteminden farklıdır, bu nedenle Yöntem adı EditPost 'den Edit 1 ye geri 
değişir. 

Görünüm bir kurs varlıkları koleksiyonuna sahip olmadığından, model Bağlayıcısı CourseAssignments gezinti 
özelliğini otomatik olarak güncelleştiremez. @No__t-0 gezinti özelliğini güncelleştirmek için model cildi kullanmak 
yerine, bunu yeni updateinstructorCourses yönteminde yapmanız gerekir. Bu nedenle, CourseAssignments özelliğini 
model bağlamadan hariç bırakmanız gerekir. Bu, TryUpdateModei ' i çağıran kodda herhangi bir değişiklik 
yapılmasını gerektirmez ve bu nedenle, beyaz liste aşırı yüklemesini kullandığınızdan ve CourseAssignments ekleme 
listesinde yer almayız. 

Hiçbir onay kutusu seçilmediyse, updateinstructorCourses ' daki kod, CourseAssignments gezinti özelliğini boş bir 
koleksiyonla başlatır ve döndürür: 














private void UpdateInstr'uctorCourses(str'ing[] selectedCourses, Instructor instructorToUpdate) 

{ 

if (selectedCourses == null) 

{ 

instructorToUpdate.CourseAssignments = new List<CourseAssignment>(); 
return; 

} 

var selectedCoursesHS = new HashSet<string>(selectedCourses); 
var instructorCourses = new HashSet<int> 

(instructorToUpdate.CourseAssignments.Select(c => c.Course.CourselD)); 
foreach (var course in _context.Courses) 

{ 

if (selectedCoursesHS.Contains(course.CourseID.ToString())) 

{ 

if (!instructorCourses.Contains(course.CourselD)) 

{ 

instructorToUpdate.CourseAssignments.Add(new CourseAssignment { InstructorlD = 
instructorToUpdate.ID, CourselD = course.CourselD }); 

} 

} 

else 

{ 

if (instructorCourses.Contains(course.CourselD)) 

{ 

CourseAssignment courseToRemove = instructorToUpdate.CourseAssignments.FirstOrDefault(i => 
i.CourselD == course.CourselD); 

_context.Remove(courseToRemove); 

} 

} 

} 

} 


Kod daha sonra, veritabanındaki tüm kurslardan geçer ve bu her kursu, görünümde seçili olanlar ile ilgili olarak 
eğitmenin atandığı her bir kursa karşı denetler. Etkili aramaları kolaylaştırmak için, ikinci iki koleksiyon HashSet 
nesnelerinde depolanır. 

Kurs onay kutusu seçilmişse ancak kurs Instructor.courseAssignments gezinti özelliğinde değilse kurs, Gezinti 
özelliğindeki koleksiyona eklenir. 








private void UpdateInstr'uctorCourses(str'ing[] selectedCourses, Instructor instructorToUpdate) 

{ 

if (selectedCourses == null) 

{ 

instructorToUpdate.CourseAssignments = new List<CourseAssignment>(); 
return; 

} 

var selectedCoursesHS = new HashSet<string>(selectedCourses); 
var instructorCourses = new HashSet<int> 

(instructorToUpdate.CourseAssignments.Select(c => c.Course.CourselD)); 
foreach (var course in _context.Courses) 

{ 

if (selectedCoursesHS.Contains(course.CourseID.ToString())) 

{ 

if (!instructorCourses.Contains(course.CourselD)) 

{ 

instructorToUpdate.CourseAssignments.Add(new CourseAssignment { InstructorlD = 
instructorToUpdate.ID, CourselD = course.CourselD }); 

} 

} 

else 

{ 

if (instructorCourses.Contains(course.CourselD)) 

{ 

CourseAssignment courseToRemove = instructorToUpdate.CourseAssignments.FirstOrDefault(i => 
i.CourselD == course.CourselD); 

_context.Remove(courseToRemove); 

} 

} 

} 

} 


Kurs onay kutusu seçilmemişse, ancak kurs Instructor.courseAssignments gezinti özelliği ise, kurs, gezinti 
özelliğinden kaldırılır. 







private void UpdateInstr'uctorCourses(str'ing[] selectedCourses, Instructor instructorToUpdate) 

{ 

if (selectedCourses == null) 

{ 

instructorToUpdate.CourseAssignments = new List<CourseAssignment>(); 
return; 

} 

var selectedCoursesHS = new HashSet<string>(selectedCourses); 
var instructorCourses = new HashSet<int> 

(instructorToUpdate.CourseAssignments.Select(c => c.Course.CourselD)); 
foreach (var course in _context.Courses) 

{ 

if (selectedCoursesHS.Contains(course.CourseID.ToString())) 

{ 

if (!instructorCourses.Contains(course.CourselD)) 

{ 

instructorToUpdate.CourseAssignments.Add(new CourseAssignment { InstructorlD = 
instructorToUpdate.ID, CourselD = course.CourselD }); 

} 

} 

else 

{ 

if (instructorCourses.Contains(course.CourselD)) 

{ 

CourseAssignment courseToRemove = instructorToUpdate.CourseAssignments.FirstOrDefault(i => 
i.CourselD == course.CourselD); 

_context.Remove(courseToRemove); 

} 

} 

} 

} 


Eğitmen görünümlerini güncelleştirme 

Görünümler/eğitmenler/Edit. cs/ıfm/lçinde, Office alanı için div öğelerinden hemen sonra ve Kaydet için div 
öğesinden önce aşağıdaki kodu ekleyerek bir dizi onay kutusu içeren bir Kurslar alanı ekleyin Bu. 


NOTE 

Kodu Visual Studio 'Ya yapıştırdığınızda, satır sonları kodu kesen bir şekilde değiştirilebilir. Kod yapıştırdıktan sonra farklı 
görünüyorsa, otomatik biçimlendirmeyi geri almak için CTRL + Z bir kez tuşuna basın. Bu işlem satır sonlarını, burada 
gördüğünüz gibi görünmeleri için düzeltir. Girintide kusursuz olması gerekmez, ancak @</trxtr> , @:<td>, @:</td> ve 
@:</tr> çizgilerinin her biri gösterildiği gibi tek bir satırda olması gerekir, aksi halde bir çalışma zamanı hatası alırsınız. Yeni 
kod bloğu seçiliyken, yeni kodu mevcut kodla hizalamak için üç kez Tab tuşuna basın. Bu sorun Visual Studio 2019 ' de 
düzeltilmiştir. 








<div class="form-group"> 

<div class="col-md-offset-2 col-md-10"> 

<table> 

<tr> 

@{ 

int cnt = 0 ; 

ListcContosoUniversity.Models.SchoolViewModels.AssignedCourseData> courses = 

ViewBag.Courses; 

foreach (var course in courses) 

{ 

if (cnt++ % 3 == 0) 

{ 

</trxtr> 

} 

<td> 

<input type="checkbox" 

name="selectedCourses" 
value="@course.CourseiD" 

@(Html.Raw(course.Assigned ? "checked=\"checked\"" : "")) /> 
@course.CourseiD (Şcourse.Title 

</td> 

} 

</tr> 

} 

</table> 

</div> 

</div> 


Bu kod, üç sütun içeren bir HTM L tablosu oluşturur. Her sütunda, bir onay kutusu ve ardından kurs numarası ve 
başlığından oluşan bir açıklamalı altyazı bulunur. Onay kutularının hepsi aynı ada ("Selectedkurslar") sahiptir, bu da 
model cilde bir grup olarak değerlendirilme bildirir. Her onay kutusunun değer özniteliği courseiD değerine 
ayarlanır. Sayfa gönderildiğinde, model Ciltçi yalnızca seçili onay kutuları için CourseiD değerlerinden oluşan 
denetleyiciye bir dizi geçirir. 

Onay kutuları başlangıçta işlendiğinde, eğitmenin atandığı kurslara yönelik olanlar, işaretlenmiş özniteliklere 
sahiptir ve bunları seçer (denetlenen görüntüler). 

Uygulamayı çalıştırın, eğitmenler sekmesini seçin ve ardından düzenleme sayfasını görmek İçin bir eğitmende 
Düzenle 1 ye tıklayın. 
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Bazı kurs atamalarını değiştirin ve Kaydet' e tıklayın. Yaptığınız değişiklikler Dizin sayfasında yansıtılır. 


NOTE 

Eğitim kursu verilerini düzenlemek için buradaki yaklaşım, sınırlı sayıda kurs olduğunda iyi bir şekilde gerçekleştirilir. Çok daha 
büyük olan koleksiyonlar için, farklı bir kullanıcı arabirimi ve farklı bir güncelleştirme yöntemi gerekir. 


Güncelleştirme silme sayfası 

lnstructorsController.es' de DeleteConfirmed yöntemini silin ve yerine aşağıdaki kodu ekleyin. 














[HttpPost , ActionName("Delete")] 
[ValidateAntiForgeryToken] 

public async Task<IActionResult> DeleteConfirmed(int id) 

{ 

Instructon instnuctor = await _context.Instructors 
.Include(i => i.CourseAssignments) 

•SingleAsync(i => i.ID == id); 

var departments = await _context.Departments 
.Where(d = > d.InstructorlD == id) 

.ToListAsync(); 

departments.ForEach(d => d.InstructorlD = null); 

_context.Instructors.Remove(instructor); 

await _context.SaveChangesAsync(); 
return RedirectToAction(nameof(Index)); 


Bu kod aşağıdaki değişiklikleri yapar: 

• @No__t-0 gezinti özelliği için Eager yüklemesi yapar. Bunu eklemeniz gerekir, ilgili courseAssignment 
varlıkları hakkında bilgi sahibi olmaz ve onları silmez. Bunları okumaktan kaçınmak için, veritabanında art 
arda silme yapılandırabilirsiniz. 

• Silinecek eğitmen herhangi bir departmanların Yöneticisi olarak atanırsa, bu departmanlardan eğitmen 
atamasını kaldırır. 

Sayfa oluşturmak için Office konumu ve kurslar ekleme 

lnstructorsController.es' de, HttpGet ve httppost create yöntemlerini silin ve ardından aşağıdaki kodu kendi yerine 

ekleyin: 





public IActionResult Create() 

{ 

var instructor = new Instructor(); 

instructor.CourseAssignments = new List<CourseAssignment>(); 
PopulateAssignedCourseData(instructor); 
return View(); 

} 


// POST: Instructors/Create 


[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Create([Bind("FirstMidNamejHireDate,LastName,OfficeAssignment")] instructor 
instructor, string[] selectedCourses) 

{ 

if (selectedCourses != null) 

{ 

instructor.CourseAssignments = new List<CourseAssignment>(); 
foreach (var course in selectedCourses) 

{ 

var courseToAdd = new CourseAssignment { InstructorlD = instructor.İD, CourselD = int.Parse(course) 

}; 

instructor.CourseAssignments.Add(courseToAdd); 

} 

} 

if (ModelState.IsValid) 

{ 


_context.Add(instructor); 

await _context.SaveChangesAsync(); 

return RedirectToAction(nameof(Index)); 


} 

PopulateAssignedCourseData(instructor); 
return View(instructor); 


} 


Bu kod, başlangıçta hiçbir kurs seçilmemiş olması dışında Edit yöntemleri için gördüğünüz gibi benzerdir. 

@No__t, ancak görünümde foreach döngüsü için boş bir koleksiyon sağlamak üzere, HttpGet-0 yöntemi 
PopulateAssignedCourseDat a yöntemini çağırır. Aksi takdirde görünüm kodu bir null başvuru özel durumu oluşturur. 


HttpPost Create yöntemi, seçili her kursu doğrulama hatalarını kontrol etmeden önce courseAssignments gezinti 
özelliğine ekler ve yeni eğitmeni veritabanına ekler. Model hataları olduğunda (örneğin, Kullanıcı geçersiz bir tarih 
anahtarlanır) ve sayfa bir hata iletisiyle yeniden görüntülenirken, yapılan kurs seçimleri otomatik olarak geri 
yüklenir. 


@No__t-0 gezinti özelliğine kurslar ekleyebilmesinin, özelliği boş bir koleksiyon olarak başlatmak için sahip olmanız 
gerektiğini unutmayın: 

instructor.CourseAssignments = new List<CourseAssignment>(); 


Bunu denetleyici kodunda yapmanın bir alternatifi olarak, aşağıdaki örnekte gösterildiği gibi, özellik alıcısının, 
koleksiyonu otomatik olarak oluşturmak üzere değiştirerek, bunu eğitmen modelinde yapabilirsiniz: 









private ICollection<CourseAssignment> _courseAssignments; 
public ICollection<CourseAssignment> CourseAssignments 
{ 

get 

{ 

return _courseAssignments ?? (_courseAssignments = new List<CourseAssignment>()); 

} 

set 

{ 

_courseAssignments = value; 

} 


@No__t-0 özelliğini bu şekilde değiştirirseniz, denetleyicideki açık özellik başlatma kodunu kaldırabilirsiniz. 

Görünümler/eğitmen/oluşturma, cshtml'de, gönder düğmesinden önce kurslar için bir Office konum metin kutusu 
ve onay kutuları ekleyin. Düzenleme sayfasında olduğu gibi, dosyayı yapıştırdığınızda Visual Studio kodu yeniden 
biçimlendirdiğinden biçimlendirmeyi onarın. 

<div class="form-group"> 

dabel asp-for="OfficeAssignment. Location" class="control-label"x/label> 
cinput asp-for="OfficeAssignment.Location" class="form-control" /> 

<span asp-validation-for="OfficeAssignment.Location" class="text-danger" /> 

</div> 

<div class="form-group"> 

<div class="col-md-offset-2 col-md-10"> 

<table> 

<tr> 

@{ 

int cnt = 0; 

ListcContosolIniversity. Models. SchoolViewModels. AssignedCourseData> courses = 

ViewBag.Courses; 

foreach (van course in courses) 

{ 

if (cnt++ % 3 == 0) 

{ 

</trxtr> 

} 

<td> 

<input type="checkbox" 

name="selectedCourses" 
value="@course.CourselD" 

@(Html.Raw(course.Assigned ? "checked=\"checked\"" : "")) /> 

@course.CourselD @course.Title 

</td> 

} 

</tr> 

} 

</table> 

</div> 

</div> 


Uygulamayı çalıştırıp bir eğitmen oluşturarak test edin. 

İşlemleri işleme 

CRU D öğreticisi ndeaçıklandığı gibi Entity Framework, işlemleri örtük olarak uygular. Daha fazla denetime 
ihtiyacınız olan senaryolar için—örneğin, işlem içinde Entity Framework dışında yapılan işlemleri eklemek 
istiyorsanız, bkz. işlemler. 




Kodu edinin 

Tamamlanmış uygulamayı indirin veya görüntüleyin. 


Sonraki adımlar 

Bu öğreticide şunları yaptınız: 

• Özelleştirilmiş Kurslar sayfaları 

• Eklenen eğitmenler düzenleme sayfası 

• Düzenleme sayfasına kurslar eklendi 

• Silme sayfası güncelleştirildi 

• Sayfa oluşturmak için Office konumu ve kurslar eklendi 

Eşzamanlılık çakışmalarını nasıl işleyeceğinizi öğrenmek için sonraki öğreticiye ilerleyin. 
Eşzamanlılık çakışmalarını işle 



Önceki öğreticilerde, verileri güncelleştirme hakkında daha fazla öğrendiniz. Bu öğreticide, birden çok kullanıcı aynı 
anda aynı varlık güncelleştirdiğinizde çakışmalarına gösterilmektedir. 

Departman varlığıyla çalışan ve eşzamanlılık hatalarını işleyecek Web sayfaları oluşturacaksınız. Aşağıdaki çizimler, 
bir eşzamanlılık çakışması oluşursa görüntülenen bazı iletiler dahil olmak üzere, düzenleme ve silme sayfalarını 
gösterir. 

B Departmen X B Edit - Cont X + — □ X 

^ Ç_) locaihost 5813/Departr "jUf 



Edit 


Department 

• The record you attempted to edit was modifîed by another user 
after you got the oıiginal value. The edit operation was canceled 
and the current values in the database have been displayed. If 
you stili want to edit this record, click the Save button again. 
Othervvise click the Back to List hyperlink. 

Name 

English 

Budget 

200000.00 

Current value: $50,000.00 

Start Date 

9/1/2007 

InstructoriD 

Abercrombie, Kim v 


Save 
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Contoso University 
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Delete 


The record you attempted to delete was modified by another user atter 
you got the original values. The delete operation was canceled and the 
cunrent values İn the database have been displayed If you stili want to 
delete this record, click the Delete button again. Otherwise click the 
Back to List hyperlink. 

Are you sure you want to delete this? 

Department 


Name 

English 
Budget 
$200,000.00 
Start Date 
2017-02-16 
Admlnlstrator 
Abercrombie, Kim 


Delete | Back to List 



Bu öğreticide şunları yaptınız: 

• Eşzamanlılık çakışmaları hakkında bilgi edinin 

• izleme özelliği Ekle 

• Departmanlar denetleyicisi ve görünümleri oluşturma 

• Dizin görünümünü Güncelleştir 

• Düzenleme yöntemlerini Güncelleştir 

• Güncelleştirme düzenleme görünümü 

• Eşzamanlılık çakışmalarını test et 

• Silme sayfası 

• Güncelleştirme ayrıntıları ve görünüm oluşturma 

Önkoşullar 

• ilgili verileri güncelleştirme 

Eşzamanlılık çakışmaları 

Bir Kullanıcı bir varlığın verilerini düzenlemek için bir varlık verileri görüntülediğinde bir eşzamanlılık çakışması 
oluşur ve sonra, ilk kullanıcının değişikliği veritabanına yazılmadan önce diğer Kullanıcı aynı varlığın verilerini 
günceller. Bu tür çakışmaların algılanmasını etkinleştirmezseniz, veritabanını güncelleştirme son olarak diğer 
kullanıcının değişikliklerinin üzerine yazar. Birçok uygulamada, bu risk kabul edilebilir: birkaç Kullanıcı veya birkaç 
güncelleştirme varsa veya bazı değişikliklerin üzerine yazılırsa gerçekten önemli değilse, eşzamanlılık için 
programlama maliyeti avantajdan yararlanabilir. Bu durumda, uygulamayı eşzamanlılık çakışmalarını işleyecek 
şekilde yapılandırmanız gerekmez. 












Kötümser eşzamanlılık (kilitleme) 

Uygulamanızın eşzamanlılık senaryolarında yanlışlıkla veri kaybını önlemesi gerekiyorsa, bunu yapmanın bir yolu 
veritabanı kilitlerini kullanmaktır. Bu, Kötümser eşzamanlılık olarak adlandırılır.Örneğin, bir veritabanından bir satırı 
okuyabilmeniz için, salt okunurdur veya güncelleştirme erişimi için bir kilit isteyin. Bir satırı güncelleştirme erişimi 
için kilitlerseniz, başka hiçbir kullanıcının satırı değiştirme sürecinde olan verilerin bir kopyasını alması için salt 
okunurdur veya güncelleştirme erişimi için bu satırı kilitlemesine izin verilmez. Bir satırı salt okuma erişimi için 
kilitlerseniz, diğerleri dosyayı salt okuma erişimi için de kilitleyip güncelleştirme için de kilitleyebilirler. 

Kilitleri yönetmek dezavantajlara sahiptir.Program, karmaşık olabilir.Önemli veritabanı yönetim kaynakları 
gerektirir ve bir uygulamanın kullanıcı sayısı arttıkça performans sorunlarına neden olabilir. Bu nedenlerden dolayı, 
tüm veritabanı yönetim sistemleri Kötümser eşzamanlılık 'yi desteklemez. Entity Framevvork Core, BT için yerleşik 
destek sağlamaz ve bu öğretici bunu nasıl uygulayacağınızı göstermez. 

İyimser Eşzamanlılık 

Kötümser eşzamanlılık yerine iyimser eşzamanlılık yapılır, iyimser eşzamanlılık, eşzamanlılık çakışmalarının 
gerçekleşmesine ve sonra uygun şekilde yeniden davranmasını sağlar. Örneğin, Gamze departman düzenleme 
sayfasını ziyaret ettiğinde, İngilizce departmanı $350.000,00 olan bütçe tutarını $0,00 olarak değiştirir. 



Contoso University 


Edit 

Department 

Budget 

0 x 

Adminîstrator 

Abercrombie, Kim v 

Name 

English 

Start Date 

9/1/2007 


Save 



Jane tıkladığında önce Kaydet, John aynı sayfayı ziyaret eder ve alanın başlangıç tarihi 1/9/2013 1/9/2007'deki 
değiştirir. 
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Edit 

Department 

Budget 

350000.00 

Administrator 

Abercrombie, Kim 

Name 

English 


X 


Start Date 

9/1/2013 


Save 
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Gamze önce Kaydet 1 i tıklatır ve tarayıcı dizin sayfasına döndüğünde değişikliği görür. 
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Name Budget 

Administrator 

Start Date 


English $0.00 

Abercrombie, Kim 

2007-09-01 

Edit | Details | Delete 
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Ardından John, hala $350.000,00 bütçesini gösteren bir düzenleme sayfasında Kaydet ' e tıklamakta. Sonraki 
işlemin ne eşzamanlılık çakışmalarını nasıl ele tarafından belirlenir. 

Bazı seçenekler şunlardır: 

• Bir kullanıcının hangi özelliği değiştirdiği ve yalnızca ilgili sütunları veritabanında güncelleştirdiğinden 
haberdar olabilirsiniz. 

Örnek senaryoda, iki kullanıcı tarafından farklı özellikler güncelleştirildiğinden hiçbir veri kaybolmaz. 

İngilizce bölüme bir dahaki sefer ilk kez gözattığında, hem gamze 'nin hem de John 'un değişikliklerini görür; 
başlangıç tarihi 9/1/2013 ve sıfır dolar bir bütçe olur. Bu güncelleştirme yöntemi, veri kaybına neden 
olabilecek çakışmaların sayısını azaltabilir, ancak bir varlığın aynı özelliğinde rekabet değişiklikleri yapılırsa 



















veri kaybını önleyebilir. Entity Framevvork bu şekilde çalışıp çalışmadığını, güncelleştirme kodunuzu nasıl 
uygulayadığınıza bağlıdır. Genellikle bir Web uygulamasında pratik değildir, çünkü bir varlığın tüm özgün 
özellik değerlerini ve yeni değerleri izlemek için büyük miktarlarda durum tutmanızı gerektirebilir. Büyük 
miktarlarda durum bulundurma, uygulama performansını etkileyebilir çünkü sunucu kaynakları gerektirir ya 
da Web sayfasının kendisine (örneğin, gizli alanlarda) veya bir tanımlama bilgisinde yer almalıdır. 

• Gamze'nin değişikliğinin üzerine Çan'ın değişiklik sağlayabilirsiniz. 

İngilizce bölüme bir dahaki sefer gözattığında, 9/1/2013 ve geri yüklenen $350.000,00 değerini görür.Bu, 
İstemci WINS veya son WINS senaryosu olarak adlandırılır, (istemciden gelen tüm değerler veri deposunda 
yer alacak şekilde önceliklidir.) Bu bölümün giriş bölümünde belirtildiği gibi, eşzamanlılık işleme için 
herhangi bir kodlama yapmazsanız, bu otomatik olarak gerçekleşir. 

• John 'un değişikliğini veritabanında güncelleştirilmesini engelleyebilirsiniz. 

Genellikle bir hata iletisi görüntüler, verilerin geçerli durumunu gösterir ve yine de bunu yapmak istiyorsa, 
yaptığı değişiklikleri yeniden uygular. Bu adlı bir Store WINS senaryo. (Veri deposu değerleri, istemci 
tarafından gönderilen değerlere göre önceliklidir.) Bu öğreticide mağaza WINS senaryosunu 
uygulayacaksınız. Bu yöntem, bir kullanıcının neler olduğunu bildirmeden önce hiçbir değişikliğin üzerine 
yazılmamasını sağlar. 

Eşzamanlılık çakışmalarını algılama 

Entity Framevvork oluşturduğu DbConcurrencyException özel durumları işleyerek çakışmaları çözebilirsiniz. Bu özel 
durumların ne zaman throvv hakkında bilgi edinmek için Entity Framevvork çakışmaları algılayabilmelidir. Bu 
nedenle, veritabanını ve veri modelini uygun şekilde yapılandırmanız gerekir. Çakışma algılamayı etkinleştirmeye 
yönelik bazı seçenekler şunlardır: 

• Veritabanı tablosunda, bir satırın ne zaman değiştirildiğini belirlemede kullanılabilecek bir izleme sütunu 
ekleyin. Daha sonra Entity Framevvork SQL Update veya delete komutlarının VVHERE yan tümcesinde bu 
sütunu içerecek şekilde yapılandırabilirsiniz. 

izleme sütununun veri türü genellikle rowversion . rowversion değeri, satır her güncelleştirildiği zaman 
artılan sıralı bir sayıdır. Bir Update veya delete komutunda VVHERE yan tümcesi, izleme sütununun (orijinal 
satır sürümü) orijinal değerini içerir. Güncelleştirilmekte olan satır başka bir kullanıcı tarafından 
değiştirilmişse, rowversion sütunundaki değer özgün değerden farklıdır, bu nedenle Update veya DELETE 
deyimi VVHERE yan tümcesi nedeniyle güncelleştirilecek satırı bulamaz. Entity Framevvork, Update veya 
delete komutuyla hiçbir satır güncelleştirilmediğini bulduğunda (yani, etkilenen satır sayısı sıfır olduğunda), 
bunu bir eşzamanlılık çakışması olarak yorumlar. 

• Entity Framevvork, Update ve DELETE komutlarının VVHERE yan tümcesindeki tablodaki her sütunun özgün 
değerlerini içerecek şekilde yapılandırın. 

ilk seçenekte olduğu gibi, satırdaki herhangi bir şey satırın ilk okuduğundan beri değiştiyse VVHERE yan 
tümcesi güncelleştirilecek bir satır döndürmez, bu da Entity Framevvork eşzamanlılık çakışması olarak 
yorumlar. Birçok sütunu olan veritabanı tablolarında, bu yaklaşım çok büyük VVHERE yan tümceleriyle 
sonuçlanabilir ve büyük miktarlarda durum bulundurmasını gerektirebilir. Daha önce belirtildiği gibi, büyük 
miktarlarda durumu korumak uygulama performansını etkileyebilir. Bu nedenle bu yaklaşım genellikle 
önerilmez ve bu öğreticide kullanılan yöntem değildir. 

Bu yaklaşımı eşzamanlılık 'e uygulamak istiyorsanız, Concurrencycheck özniteliğini bunlara ekleyerek 
eşzamanlılık izlemek istediğiniz varlıktaki tüm birincil anahtar olmayan Özellikleri işaretlemeniz gerekir. Bu 
değişiklik Entity Framevvork, tüm sütunları Update ve DELETE deyimlerinin SQL VVHERE yan tümcesinde 
içermesini sağlar. 

Bu öğreticinin geri kalanında, departman varlığına bir rowversion izleme özelliği ekleyecek, bir denetleyici ve 
görünümler oluşturacak ve her şeyin doğru şekilde çalıştığını doğrulamak için test edeceksiniz. 











İzleme özelliği Ekle 

içinde Models/Department.cs, RovvVersion adlı izleme özelliği ekleyin: 

using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Department 

{ 

public int DepartmentlD { get; set; } 

[StringLength(50j MinimumLength = 3)] 
public string Name { get; set; } 

[DataType(DataType.Currency) ] 

[Column(TypeName = "money")] 
public decimal Budget { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 

[Display(Name = "Start Date")] 
public DateTime StartDate { get; set; } 

public int? InstructorlD { get; set; } 

[Timestamp] 

public byte[] RowVersion { get; set; } 

public Instructor Administrator { get; set; } 
public ICollection<Course> Courses { get; set; } 

} 

} 

Timestamp özniteliği, bu sütunun veritabanına gönderilen WHERE yan tümcesine ve DELETE komutlarına dahil 
edileceğini belirtir. Önceki SQL Server sürümleri, SQL rowversion değiştirilmeden önce bir SQL timestamp veri 
türü kullandığından özniteliğe Timestamp denir. rowversion için .NET türü bir bayt dizisidir. 

Fluent API kullanmayı tercih ediyorsanız, aşağıdaki örnekte gösterildiği gibi izleme özelliğini belirtmek için 
isConcurrencyToken yöntemini ( Data/SchoolContext. cs) kullanabilirsiniz: 

modelBuilder.Entity<Department>() 

.Property(p => p.RowVersion).IsConcurrencyToken(); 


Bir özellik ekleyerek, veritabanı modelini değiştirdiğiniz için başka bir geçiş yapmanız gerekir. 
Değişikliklerinizi kaydedin ve projeyi derleyin ve ardından komut penceresine aşağıdaki komutları girin: 

dotnet ef migrations add RowVersion 

dotnet ef database update 


Departmanlar denetleyicisi ve görünümleri oluşturma 


Daha önce öğrenciler, Kurslar ve Eğitmenler için yaptığınız gibi bir departman denetleyicisini ve görünümlerini 









derden katlayın. 


Add Controller 

Model class: 

Data context class: 

Vieuvs: 

12 Generate views 
2 Reference script libraries 
2 Use a layout page: 


Department (ContosoUniversity.Models) 


SchoolContext (ContosoUniversity.Data) 

V 

E 




(Leave empty if it is set in a Razor_viewstart file) 


Controller name: 


DepartmentsController 


Add 


Cancel 


DepartmentsController.es dosyasında, "FirstMidName" sözcüğünün dört yinelemesini "FulIName" olarak değiştirin, 
böylece Departman Yöneticisi açılan listeleri yalnızca soyadı yerine eğitmenin tam adını içerecektir. 


ViewData["InstructorID"] = new SelectList(_context.Instructors, "ID", "FulIName"., department.InstructorlD); 


Dizin görünümünü Güncelleştir 

Yapı iskelesi altyapısı dizin görünümünde bir ROVVVERSION sütunu oluşturdu, ancak bu alan gösterilmemelidir. 
Views/departmanlar/lndex. cshtml içindeki kodu aşağıdaki kodla değiştirin. 


































@model IEnumerablecContosoUniversity.Models.Department> 

@{ 

ViewData["Title"] = "Departments"; 

} 

<h2>Departments</h2> 

<P> 

<a asp-action="Create">Create New</a> 

</p> 

ctable class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model = > model.Name) 

</th> 

<th> 

@Html.DisplayNameFor(model = > model.Budget) 

</th> 

<th> 

@Html.DisplayNameFor(model = > model.StartDate) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Admlnistrator) 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

(Şforeach (var item in Model) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Name) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Budget) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.StartDate) 

</td> 

<td> 

@Fltml.DisplayFor(modelItem => item.Administrator.FullName) 

</td> 

<td> 

<a asp-action="Edit" asp-route-id="@item.DepartmentID">Edit</a> | 

<a asp-action="Details" asp-route-id="@item.DepartmentID">Details</a> | 
<a asp-action="Delete" asp-route-id="@item.DepartmentID">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 


Bu, başlığı "departmanlar" olarak değiştirir, RovvVersion sütununu siler ve yöneticinin adı yerine tam adı gösterir. 

Düzenleme yöntemlerini Güncelleştir 

Hem HttpGet Edit yönteminde hem de Details yönteminde AsNoTracking ekleyin. HttpGet Edit yönteminde, 
yönetici için Eager yüklemesi ekleyin. 








var department = await _context.Departments 
.Include(i => i.Administrator) 

.AsNoTracking() 

.FirstOrDefaultAsync(m => m.DepartmentlD == id); 

HttpPost Edit yöntemi için mevcut kodu şu kodla değiştirin: 

[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Edit(int? id, byte[] rowVersion) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var departmentToUpdate = await _context.Departments.Include(i => i.Administrator).FirstOrDefaultAsync(m 
m.DepartmentlD == id); 

if (departmentToUpdate == null) 

{ 

Department deletedDepartment = new Department(); 
await TryUpdateModelAsync(deletedDepartment); 

ModelState.AddModelError(string.Empty, 

"Unable to save changes. The department was deleted by another user."); 

ViewData["InstructorID"] = new SelectList(_context.Instructors, "ID", "FullName", 
deletedDepartment.InstructorlD); 

return View(deletedDepartment); 

} 

_context.Entry(departmentToUpdate).Property("RowVersion").OriginalValue = rowVersion; 

if (await TryUpdateModelAsync<Department>( 
departmentToUpdate, 

i 

s => s.Name, s => s.StartDate, s => s.Budget, s => s.InstructorlD)) 

{ 

try 

{ 

await _context.SaveChangesAsync(); 
return RedirectToAction(nameof(Index)); 

} 

catch (DbUpdateConcurrencyException ex) 

{ 

var exceptionEntry = ex.Entries.Single(); 
var clientValues = (Department)exceptionEntry.Entity; 
var databaseEntry = exceptionEntry.GetDatabaseValues(); 
if (databaseEntry == null) 

{ 

ModelState.AddModelError(string.Empty, 

"Unable to save changes. The department was deleted by another user."); 

} 

else 

{ 

var databaseValues = (Department)databaseEntry.ToObject(); 

if (databaseValues.Name != clientValues.Name) 

{ 

ModelState.AddModelError("Name", $"Current value: {databaseValues.Name}"); 

} 

if (databaseValues.Budget != clientValues.Budget) 

{ 

ModelState.AddModelError("Budget", $"Current value: {databaseValues.Budget:c}"); 

} 

if (databaseValues.StartDate != clientValues.StartDate) 

{ 




ModelState.AddModelError("StartDate", $"Current value: {databaseValues.StartDateıd}"); 

} 

if (databaseValues.InstructorlD != clientValues.InstructorlD) 

{ 

Instructor databaselnstructor = await _context.Instructors.FirstOrDefaultAsync(i => i.ID == 
databaseValues.InstructorlD); 

ModelState.AddModelError("InstructorlD", $"Current value: {databaselnstructor?.FullName}"); 

} 

ModelState.AddModelError(string.Empty, "The record you attempted to edlt " 

+ "was modified by another user after you got the origlnal value. The " 

+ "edit operation was canceled and the current values İn the database " 

+ "have been displayed. If you stili want to edit this record, click " 

+ "the Save button again. Otherwise click the Back to List hyperlink."); 
departmentToUpdate.RowVersion = (byte[])databaseValues.RowVersion; 

ModelState.Remove("RowVersion"); 

} 

} 

} 

ViewData["InstructorID"] = new SelectList(_context.Instructors, "ID", "FullName", 
departmentToUpdate.InstructorlD); 
return View(departmentToUpdate); 

} 

Kod, güncellenen departmanı okumaya çalışırken başlar. FirstorDefaultAsync yöntemi null döndürürse, departman 
başka bir kullanıcı tarafından silindi. Bu durumda, kod, düzenleme sayfasının bir hata iletisiyle yeniden 
görüntülenebilmesi için bir departman varlığı oluşturmak üzere postalanan form değerlerini kullanır. Alternatif 
olarak, departman alanlarını yeniden görüntülemeden yalnızca bir hata iletisi görüntülediğinizde, departman 
varlığını yeniden oluşturmanız gerekmez. 

Görünüm özgün Rowversion değerini gizli bir alana depolar ve bu yöntem, rowversion parametresindeki bu değeri 
alır. Savechanges çağırmadan önce, bu özgün Rowversion özellik değerini varlık için Originalvalues koleksiyonuna 
koymanız gerekir. 

_context.Entry(departmentToUpdate).Property("RowVersion").OriginalValue = rowVersion; 

Entity Framevvork bir SQL UPDATE komutu oluşturduğunda, bu komut özgün Rowversion değerine sahip bir satırı 
aramak için bir VVHERE yan tümcesi içerecektir. GÜNCELLEŞTİRME komutundan hiçbir satır etkilenmiyorsa 
(özgün Rowversion değerine sahip satır yoksa) Entity Framevvork bir DbUpdateConcurrencyException özel durumu 
oluşturur. 

Bu özel durum için catch bloğundaki kod, özel durum nesnesindeki Entries özelliğinden güncelleştirilmiş 
değerlere sahip etkilenen departman varlığını alır. 

var exceptionEntry = ex.Entries.Single(); 

Entries koleksiyonu yalnızca bir EntityEntry nesnesine sahip olur. Kullanıcı tarafından girilen yeni değerleri ve 
geçerli veritabanı değerlerini almak için bu nesneyi kullanabilirsiniz. 

var clientValues = (Department)exceptionEntry.Entity; 
var databaseEntry = exceptionEntry.GetDatabaseValues(); 


Kod, kullanıcının düzenleme sayfasına girdikten farklı veritabanı değerleri olan her bir sütun için özel bir hata iletisi 
ekler (yalnızca bir alan, kısaltma için burada gösterilir). 
















var databaseValues = (Department)databaseEntry.ToObject(); 

if (databaseValues.Name != clientValues.Name) 

{ 

ModelState.AddModelError("Name", $"Current value: {databaseValues.Name}"); 

Son olarak kod, departmentToupdate Rowversion değerini veritabanından alınan yeni değere ayarlar. Bu yeni 
Rowversion değeri, düzenleme sayfası yeniden görüntülenirken gizli alanda saklanır ve Kullanıcı Kaydet' i 
tıkladığında, düzenleme sayfasının yeniden görüntülenmesinden bu yana yalnızca gerçekleşen eşzamanlılık hataları 
yakalanacaktır. 



Modeistate değeri, her ikisi de varsa Model özelliği değerlerinin üzerine gelir. 

Güncelleştirme düzenleme görünümü 

Görünümler/departmanlar/Düzenle. cshtml'de aşağıdaki değişiklikleri yapın: 

• Rowversion özellik değerini kaydetmek için, DepartmentiD özelliğinin gizli alanından hemen sonra bir gizli 
alan ekleyin. 

• Açılan listeye "Yönetici Seç" seçeneği ekleyin. 











@model Contosollniversity .Models.Department 

@{ 

ViewData["Title"] = "Edit"; 

} 

<h2>Edit</h2> 

ch4>Departmentc/h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form asp-action="Edit"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<input type="hidden" asp-for="DepartmentID" /> 
cinput type="hidden" asp-for="RowVersion" /> 

<div class="form-group"> 

<label asp-for="Nam 0 " class="control-label"x/label> 

<input asp-for="Name" class="form-control" /> 

<span asp-validation-fon="Name" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Budget" class="control-label"x/label> 

<input asp-for="Budget" class="form-control" /> 

<span asp-validation-for="Budget" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="StartDate" class="control-label"x/label> 

cinput asp-fon="StantDate" class="form-contnol" /> 

cspan asp-validation-for="StartDate" class="text-danger"x/span> 

</div> 

cdiv class="form-group"> 

clabel asp-fon="InstructorID" class="control-label"x/label> 

cselect asp-for="InstnuctorID" class="form-control" asp-items="ViewBag.InstructonID"> 
coption value="">-- Select Administrator --</option> 

</select> 

cspan asp-validation-for="InstructorID" class="text-danger"x/span> 
c/div> 

cdiv class="form-group"> 

cinput type="submit" value="Save" class="btn btn-default" /> 
c/div> 
c/form> 
c/div> 
c/div> 

cdiv> 

ca asp-action="Index">Back to Listc/a> 
c/div> 

@section Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 


Eşzamanlılık çakışmalarını test et 

Uygulamayı çalıştırın ve departmanlar dizini sayfasına gidin. İngilizce departman için düzenleme köprüsüne sağ 
tıklayın ve Yeni sekmesinde aç' ı seçin ve ardından İngilizce bölümünün düzenleme Köprüsü ' ne tıklayın, iki 
tarayıcı sekmesi artık aynı bilgileri görüntüler. 

ilk tarayıcı sekmesinde bir alanı değiştirin ve Kaydet 1 e tıklayın. 



Q Edit-Cont. X 

H Edit - Contoso 

+ 

□ X 

<- -> O 


localhost:58l3/Departr ■jîf 

... 

Contoso University 


— 


Edit 


Department 

Name 

English 

Budget 

50000.00| 

Start Date 

9/1/2007 

InstructorlD 

Abercrombie, Kim v 


Save 



Tarayıcı, değiştirilen değeri olan dizin sayfasını gösterir, 
ikinci tarayıcı sekmesinden bir alanı değiştirin. 















E3 Departments - 

E3 Edit-Cont X 

+ 

□ X 

<- -> ü 


localhost ^ 

... 

Contoso University 


— 


Edit 


Department 

Name 

English 

Budget 

200000.00| 

Start Date 

9/1/2007 

InstructorlD 

Abercrombie, Kim v 

Save 

# ıg T^ j f 


Kaydet'e tıklayın. Bir hata iletisi görürsünüz: 
















H Departmen X H Edit - Cont X + — □ X 

^ O localhost : 313/Departr -fa 


Contoso University 


Edit 

Department 

• The record you attempted to edit was modified by another user 
afler you got the original value. The edit operation was canceled 
and the current values in the database have been displayed. If 
you stili want to edit this record, click the Save button again. 
Otherwise click the Back to List hyperlink. 

Name 

English 

Budget 

200000.00 

Current value: $50,000.00 

Start Date 

9/1/2007 

InstructorlD 



Tıklayın Kaydet yeniden, ikinci tarayıcı sekmesinde girdiğiniz değer kaydedilir. Dizin sayfası göründüğünde 
kaydedilen değerleri görürsünüz. 

Silme sayfası 

Silme sayfası için Entity Framevvork, başka birinin departmanı benzer bir şekilde düzenlemesinden kaynaklanan 
eşzamanlılık çakışmalarını algılar. HttpGet Delete yöntemi onay görünümünü görüntülediğinde, görünüm, gizli bir 
alanda özgün Rowversion değerini içerir. Bu değer daha sonra Kullanıcı silmeyi onayladığında çağrılan HttpPost 
Delete yöntemi için kullanılabilir. Entity Framevvork, SQL DELETE komutunu oluşturduğunda, özgün Rowversion 
değerine sahip bir WHERE yan tümcesi içerir. Komut, sıfır satır etkilenirse (satır silme onayı sayfası 
görüntülendikten sonra değiştirildiğinde), bir eşzamanlılık özel durumu oluşturulur ve onay sayfasını bir hata 
iletisiyle yeniden görüntülemek için HttpGet Delete yöntemi bir hata bayrağı true olarak çağırılır. Satır başka bir 
kullanıcı tarafından silindiğinden, bu durumda herhangi bir hata iletisi görüntülenmediğinden sıfır satırların 
etkilenmesi de mümkündür. 

Departmanlar denetleyicisindeki silme yöntemlerini güncelleştirme 

DepartmentsController.es' de, httpget Delete yöntemini aşağıdaki kodla değiştirin: 


















public async Task<IActionResult> Delete(int? id, bool? concurrencyError) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var department = await _context.Departments 
.Include(d => d.Administrator) 

.AsNoTracking() 

.FirstOrDefaultAsync(m => m.DepartmentlD == id); 
if (department == null) 

{ 

if (concurrencyError.GetValueOrDefault()) 

{ 

return RedirectToAction(nameof(Index)); 

} 

return NotFound(); 


if (concurrencyError.GetValueOrDefault()) 

{ 

ViewData["ConcurrencyErrorMessage"] = "The record you attempted to delete " 
+ "was modified by another user after you got the original values. " 

+ "The delete operation was canceled and the current values in the " 

+ "database have been displayed. If you stili want to delete this " 

+ "record, click the Delete button again. Otherwise " 

+ "click the Back to List hyperlink."; 

} 

return View(department); 


Yöntemi, sayfanın bir eşzamanlılık hatasından sonra yeniden görüntülenip görüntülenmeyeceğini belirten isteğe 
bağlı bir parametresini kabul eder. Bu bayrak true ise ve belirtilen departman artık mevcut değilse, başka bir 
kullanıcı tarafından silindi. Bu durumda, kod dizin sayfasına yeniden yönlendirir. Bu bayrak true ise ve departman 
varsa, başka bir kullanıcı tarafından değiştirilmiştir. Bu durumda, kod viewData kullanarak görünüme bir hata mesajı 
gönderir. 

HttpPost Delete yöntemindeki ( DeleteConfirmed adlı) kodu şu kodla değiştirin: 

[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Delete(Department department) 

{ 

try 

{ 

if (await _context.Departments.AnyAsync(m => m.DepartmentlD == department.DepartmentlD)) 

{ 

_context.Departments.Remove(department); 
await _context.SaveChangesAsync(); 

} 

return RedirectToAction(nameof(Index)); 

} 

catch (DbUpdateConcurrencyException /* ex */) 

{ 

//Log the error (uncomment ex variable name and write a log.) 

return RedirectToAction(nameof(Delete), new { concurrencyError = true, id = department.DepartmentlD }); 

} 

} 

Az önce değiştirdiğiniz scafkatlanmış kodda, bu yöntem yalnızca bir kayıt KİMLİĞİ kabul etti: 






public async Task<IActionResult> DeleteConfirmed(int id) 

Bu parametreyi model Ciltçi tarafından oluşturulan bir departman varlığı örneğine değiştirdiniz. Bu, kayıt 
anahtarına ek olarak ROVVVERSION özellik değerine EF erişimi verir. 

public async Task<IActionResult> Delete(Department department) 

Ayrıca DeleteConfirmed eylem yöntemi adını Delete olarak değiştirdiniz. Yapı iskelesi kodu, HttpPost yöntemine 
benzersiz bir imza vermek için DeleteConfirmed adı kullandı. (CLR aşırı yüklenmiş yöntemlerin farklı yöntem 
parametrelerine sahip olmasını gerektirir.) imzalar benzersiz olduğuna göre, MVC kuralını seçebilir ve HttpPost ve 
HttpGet silme yöntemleri için aynı adı kullanabilirsiniz. 

Departman zaten silinirse, AnyAsync yöntemi false döndürür ve uygulama yalnızca dizin yöntemine geri döner. 

Bir eşzamanlılık hatası yakalanmışsa, kod silme onayı sayfasını yeniden görüntüler ve bir eşzamanlılık hata mesajı 
görüntülemesi gerektiğini belirten bir bayrak sağlar. 

Silme görünümünü Güncelleştir 

Vievvs/departmanlar/delete. cshtml\qr\de, scafkatkli kodunu, DepartmentlD ve rovvversion özellikleri için bir hata 
iletisi alanı ve gizli alanları ekleyen aşağıdaki kodla değiştirin. Değişiklikler vurgulanır. 








@model ContosoUniversity.Models.Department 

@{ 

ViewData["Title"] = "Delete"; 

} 

<h2>Delete</h2> 

<p class="text-danger">@ViewData["ConcurrencyErrorMessage"]</p> 

<hB>Are you sure you want to delete this?</h3> 

<div> 

<h4>Department</h4> 

<hr /> 

<dl class="row"> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Name) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model = > model.Name) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Budget) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Budget) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.StartDate) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model = > model.StartDate) 

</dd> 

<dt class="col-sm-2"> 

@Html.DlsplayNameFor(model => model.Administrator) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Administrator.FullName) 

</dd> 

</dl> 

<form asp-action="Delete"> 

<input type="hidden" asp-for="DepartmentID" /> 
cinput type="hidden" asp-for="RowVersion" /> 

<div class="form-actions no-color"> 

<input type="submit" value="Delete" class="btn btn-default" /> | 
<a asp-action="Index">Back to List</a> 

</div> 

</form> 

</div> 


Bu, aşağıdaki değişiklikleri yapar: 

• h 2 ve h3 başlıkları arasında bir hata iletisi ekler. 

• FullName FirstMidName değiştirir yönetici alan. 

• RovvVersion alanını kaldırır. 

• Rowversion özelliği için gizli bir alan ekler. 

Uygulamayı çalıştırın ve departmanlar dizini sayfasına gidin. İngilizce departman için Sil köprüsünü sağ tıklayın ve 
Yeni sekmede aç' ı seçin ve ardından ilk sekmede İngilizce departman için düzenleme Köprüsü 1 ne tıklayın. 

ilk pencerede, değerlerden birini değiştirin ve Kaydet' e tıklayın: 







E3 Edit - Contı X E3 Delete - Conta: | + — 

^ localhost 5313/Departr ■jJj’ 


□ X 



Edit 


Department 

Name 

English 

Budget 

200000.00 

Start Date 

2/16/2017 _ 

instructorlD 

Abercrombie, Kim v 


Save 




ikinci sekmede Sil' e tıklayın. Eşzamanlılık hata iletisini görürsünüz ve departman değerleri şu anda veritabanında 
olan ile yenilenir. 














E3 Departments - 

E3 Delete - Co X 

+ 

□ X 

<- -> O 


localhost 5 "fa 

... 

Contoso University 


— 


Delete 


The record you attempted to delete was modified by another user atter 
you got the original values. The delete operation was canceled and the 
cunrent values İn the database have been displayed If you stili want to 
delete this record, click the Delete button again. Otherwise click the 
Back to List hyperlink. 

Are you sure you want to delete this? 

Department 


Name 

English 
Budget 
$200,000.00 
Start Date 
2017-02-16 
Admlnlstrator 
Abercrombie, Kim 


Delete | Back to List 



Yeniden Sil ' e tıklarsanız, departmanın silindiğini gösteren dizin sayfasına yönlendirilirsiniz. 

Güncelleştirme ayrıntıları ve görünüm oluşturma 

isteğe bağlı olarak ayrıntılarda bulunan kodu temizleyebilir ve görünümler oluşturabilirsiniz. 

RovvVersion sütununu silmek ve yöneticinin tam adını göstermek için vlev/s/departmanlar/detaıls. cshtml içindeki 
kodu değiştirin. 








@model Contosollniversity .Models.Department 

@{ 

ViewData["Title"] = "Details"; 

} 

<h2>Details</h2> 

<div> 

<h4>Department</h4> 

<hr /> 

<dl class="row"> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Name) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Name) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Budget) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Budget) 

</dd> 

<dt class="col-sm-2"> 

@Html.DlsplayNameFon(model => model.StartDate) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFon(model => model.StartDate) 

</dd> 

<dt class="col-sm-2"> 

@Fltml.DisplayNameFor(model => model.Administrator) 

</dt> 

<dd class="col-sm-10"> 

@Html.DlsplayFor(model => model.Administrator.FullName) 
</dd> 

</dl> 

</div> 

<div> 

<a asp-action="Edit" asp-route-id="@Model.DepartmentID">Edlt</a> | 
<a asp-action="Index">Back to List</a> 

</div> 


Açılan listeye bir SELECT seçeneği eklemek için views/departmanlar/Create. cshtml içindeki kodu değiştirin. 



@model Contosollniversity .Models.Department 

@{ 

ViewData["Title"] = "Create"; 

} 

<h2>Cneate</h2> 

<h4>Department</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form asp-action="Cneate"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<div class="form-group"> 

<label asp-fon="Name" class="control-label"x/label> 

<input asp-for="Name" class="form-control" /> 

<span asp-validation-for="Name" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-fon="Budget" class="contnol-label"x/label> 

<input asp-for="Budget" class="form-control" /> 

<span asp-validation-for="Budget" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="StartDate" class="control-label"x/label> 

<input asp-for="StartDate" class="form-control" /> 

<span asp-validation-fon="StartDate" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="InstructorID" class="contnol-label"x/label> 

<select asp-for="InstnuctorID" class="form-control" asp-items="ViewBag.InstructorID"> 
<option value="">-- Select Administnaton --</option> 

</select> 

</div> 

<div class="form-group"> 

<input type="submit" value="Create" class="btn btn-default" /> 

</div> 

</form> 

</div> 

</div> 

<div> 

<a asp-action="Index">Back to List</a> 

</div> 

@section Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 


Kodu alın 

Tamamlanmış uygulamayı indirin veya görüntüleyin. 

Ek kaynaklar 

EF Core eşzamanlılık işleme hakkında daha fazla bilgi için bkz. eşzamanlılık çakışmaları. 

Sonraki adımlar 

Bu öğreticide şunları yaptınız: 

• Eşzamanlılık çakışmaları hakkında öğrenildi 






• izleme özelliği eklendi 

• Oluşturulan departmanlar denetleyicisi ve görünümleri 

• Güncelleştirilmiş dizin görünümü 

• Güncelleştirilmiş düzenleme yöntemleri 

• Güncelleştirilmiş düzenleme görünümü 

• Test edilen eşzamanlılık çakışmaları 

• Silme sayfası güncelleştirildi 

• Güncelleştirilmiş Ayrıntılar ve görünüm oluşturma 

Eğitmen ve öğrenci varlıkları için tablo başına devralma devralmayı nasıl uygulayacağınızı öğrenmek için sonraki 
öğreticiye ilerleyin. 

Sonraki: tablo-hiyerarşi devralmayı Uygula 





Öğretici: EF Core devralma-ASPNET MVC uygulama 

11.10.2019 • 12 minutes to read^. Edit Online 


Önceki öğreticide eşzamanlılık özel durumlarını ele alırsınız. Bu öğretici, veri modelinde devralmayı nasıl 
uygulayacağınızı gösterir. 

Nesne odaklı programlamada, kod yeniden kullanımını kolaylaştırmak için devralmayı kullanabilirsiniz. Bu 
öğreticide, instructor ve student sınıflarını, hem Eğitmenler hem de öğrenciler için ortak olan LastName gibi 
özellikleri içeren Person taban sınıfından türetireceğiz olacak şekilde değiştireceksiniz. Herhangi bir Web sayfası 
eklemez veya değiştirmezsiniz, ancak koddan bazılarını değiştireceksiniz ve bu değişiklikler otomatik olarak 
veritabanına yansıtılacaktır. 

Bu öğreticide şunları yaptınız: 

• Devralmayı veritabanına eşle 

• Kişi sınıfını oluşturma 

• Eğitmeni ve öğrenci 'yi güncelleştirme 

• Modele kişi ekleme 

• Geçişleri oluşturma ve güncelleştirme 

• Uygulamayı test etme 


Önkoşullar 

• Eşzamanlılık işle 


Devralmayı veritabanına eşle 


Okul veri modelindeki instructor ve 

Student 

Class 

^ Properties 

Yf EnrolImentDate: DateTime? 

Enrollments: ICollection <Enrollment> 
FirstMidName : string 
2? FulIName : string 
^f_LastName_j_strinc^^_ 

25* ID :int 

\ _ ^ 


sınıflarının özdeş birkaç özelliği vardır: 

instructor 

Class 

® Properties 

^J__Courses_UCollection<Cou rseAssiqn ment > 
FirstMidName : string 
f_FullNamej_strin^_ 

^^^HİreDate: DateTime? 

|3*LastNameu^trint^ 

OfficeAssignment: OfficeAssignment 


Student 


@No__t-0 ve student varlıkları tarafından paylaşılan özellikler için gereksiz kodu ortadan kaldırmak istediğinizi 
varsayalım. Ya da adın bir eğitmenden veya bir öğrenciye ait olup olmadığına bakılmaksızın adları 
biçimlendirmeden bir hizmet yazmak isteyebilirsiniz. Yalnızca bu paylaşılan özellikleri içeren bir Person taban sınıfı 
oluşturabilirsiniz, ardından aşağıdaki çizimde gösterildiği gibi, instructor ve student sınıflarının bu temel sınıftan 
devralmasını sağlayabilirsiniz: 
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Abstract Class 




S Properties 

]âP FirstMidName: string 
^ FulIName: string 
LastName: string 
# ID: int 


Bu devralma yapısının veritabanında temsil edilebilmesi için birkaç yol vardır.Tek bir tabloda hem öğrenciler hem 
de eğitmenler hakkında bilgi içeren bir kişi tablonuz olabilir. Bazı sütunlar yalnızca Eğitmenler (HireDate), bazıları 
yalnızca öğrencilerle (kayıttarihi), bazıları ise (soyadı, adı) için geçerlidir. Genellikle, her bir satırın temsil ettiği türü 
belirtmek için bir Ayrıştırıcı sütunu vardır. Örneğin, ayrıştırıcı sütununda, Eğitmenler için "eğitmen" ve öğrenciler 
için "öğrenci" bulunabilir. 



Both 

Instructors only 
Students only 


Tek bir veritabanı tablosundan bir varlık devralma yapısı oluşturmanın bu düzeni, hiyerarşi başına tablo (TPH) 
devralma olarak adlandırılır. 

Alternatif olarak, veritabanının devralma yapısına benzer bir şekilde görünmesini sağlayabilirsiniz. Örneğin, kişi 
tablosunda yalnızca ad alanları olabilir ve Tarih alanlarıyla ayrı eğitmen ve öğrenci tabloları vardır. 


Person 

<? ID 

LastName 

FirstName 





Instructor 


Student 

f ID 

HireDate 

? ID 

EnrolImentDate 



Her varlık sınıfı için bir veritabanı tablosu yapmanın bu düzeni, tür başına tablo (TPT) devralma olarak adlandırılır. 
Başka bir seçenek de Özet olmayan tüm türleri tek tek tablolarla eşlemenize olanak sağlar. Devralınan özellikler de 








































dahil olmak üzere bir sınıfın tüm özellikleri karşılık gelen tablonun sütunlarına eşlenir. Bu düzene, tablo başına 
somut sınıf (TPC) devralma adı verilir. Daha önce gösterildiği gibi, kişi, öğrenci ve eğitmen sınıfları için TPC 
devralmayı uyguladıysanız, öğrenci ve eğitmen tabloları, devralındıktan sonra, devralma uygulandıktan sonra farklı 
şekilde görünür. 

TPC ve TPH devralma desenleri genellikle TPT devralma desenlerinden daha iyi performans sağlar, çünkü TPT 
desenleri karmaşık JOIN sorgularına yol açabilir. 

Bu öğreticide, TPH devralmanın nasıl uygulanacağı gösterilmektedir.TPH Entity Framework Core desteklediği tek 
devralma modelidir. @No__t-0 sınıfı oluşturmak, Person 1 ten türetmek için instructor ve student sınıflarını 
değiştirin, yeni sınıfı DbContext 1 e ekleyin ve bir geçiş oluşturun. 


TIP 

Aşağıdaki değişiklikleri yapmadan önce projenin bir kopyasını kaydetmeyi göz önünde bulundurun. Daha sonra sorunlarla 
karşılaşırsanız ve baştan başlamak gerekirse, bu öğretici için yapılan adımları tersine çevirme veya tüm serinin başlangıcına geri 
dönme yerine kaydedilen projeden başlamak daha kolay olacaktır. 


Kişi sınıfını oluşturma 

Modeller klasöründe Person.cs oluşturun ve şablon kodunu şu kodla değiştirin: 

using System.ComponentModel.DataAnnotations; 
using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public abstract class Person 

{ 

public int ID { get; set; } 

[Required] 

[StringLength(50)] 

[Display(Name = "Last Name")] 
public string LastName { get; set; } 

[Required] 

[StringLength(50, ErrorMessage = "First name cannot be longer than 50 characters.")] 
[Column("FirstName")] 

[Display(Name = "First Name")] 

public string FirstMidName { get; set; } 

[Display(Name = "Full Name")] 
public string FullName 
{ 

get 

{ 

return LastName + ", " + FirstMidName; 

} 

} 

} 

} 


Eğitmeni ve öğrenci 'yi güncelleştirme 

lnstructor.cs' de, kişi sınıfından eğitmen sınıfını türetirsiniz ve anahtar ve ad alanlarını kaldırın. Kod aşağıdaki örneğe 
benzer şekilde görünür: 











using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Instnuctor : Person 

{ 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd }", ApplyFormatlnEditMode = true)] 

[Display(Name = "Flire Date")] 

public DateTime HireDate { get; set; } 

public ICollection<CourseAssignment> CourseAssignments { get; set; } 
public OfficeAssignment OfficeAssignment { get; set; } 

} 

} 


Student.es' de aynı değişiklikleri yapın. 

using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Student : Person 

{ 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 

[Display(Name = "Enrollment Date")] 

public DateTime EnrollmentDate { get; set; } 


public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 


Modele kişi ekleme 

Kişi varlık türünü SchoolContext.csöğes\r\e ekleyin. Yeni satırlar vurgulanır. 





using ContosoUniversity.Models; 
using Microsoft.EntityFrameworkCore; 

namespace ContosoUniversity.Data 

{ 

public class SchoolContext : DbContext 

{ 

public SchoolContext(DbContextOptions<SchoolContext> options) : base(options) 

{ 

} 


public DbSet<Course> Courses { get; set; } 

public DbSet<Enrollment> Enrollments { get; set; } 

public DbSet<Student> Students { get; set; } 

public DbSet<Department> Departments { get; set; } 

public DbSet<Instructor> Instructors { get; set; } 

public DbSet<OfficeAssignment> OfficeAssignments { get; set; } 

public DbSet<CourseAssignment> CourseAssignments { get; set; } 

public DbSet<Person> People { get; set; } 

protected override void OnModelCreating(ModelBuilder modelBuilder) 

{ 

modelBuilder.Entity<Course>().ToTable("Course"); 
modelBuilder.Entity<Enrollment>().ToTable("Enrollment"); 
modelBuilder.Entity<Student>().ToTable("Student"); 
modelBuilder.Entity<Department>().ToTable("Department"); 
modelBuilder.Entity<Instructor>().ToTable("Instructor"); 
modelBuilder.Entity<OfficeAssignment>().ToTable("OfficeAssignment"); 
modelBuilder.Entity<CourseAssignment>().ToTable("CourseAssignment"); 
modelBuilder.Entity<Person>().ToTable("Person"); 


} 


} 


} 


modelBuilder.Entity<CourseAssignment>() 

.HasKey(c => new { c.CourselDj c.InstructorlD }); 


Bu, Entity Framevvork hiyerarşinin devralma devralınmasını yapılandırmak için gereklidir.Gördüğünüz gibi, 
veritabanı güncelleştirdiği sırada öğrenci ve eğitmen tablolarının yerine bir kişi tablosu olacaktır. 

Geçişleri oluşturma ve güncelleştirme 

Değişikliklerinizi kaydedin ve projeyi derleyin. Ardından proje klasöründe komut penceresini açın ve aşağıdaki 
komutu girin: 

dotnet ef migrations add Inheritance 


@No__t-0 komutunu henüz çalıştırmayın. Bu komut, eğitmen tablosunu bırakacak ve öğrenci tablosunu kişi olarak 
yeniden adlandırdığı için kayıp veri oluşmasına neden olur. Varolan verileri korumak için özel kod sağlamanız 
gerekir. 

Geçişleri/<timestamp > _Devralma. cs ' i açın ve up yöntemini aşağıdaki kodla değiştirin: 





pnotected override void Up(MigrationBuilder migrationBuilder) 

{ 

migrationBuilder.DropForeignKey( 

name: "FK_Enrollment_Student_StudentID", 
table: "Enrollment"); 

migrationBuilder.DropIndex(name: "IX_Enrollment_StudentID", table: "Enrollment"); 

migrationBuilder.RenameTable(name: "Instructor", newName: "Person"); 

migrationBuilder.AddColumn<DateTime>(name: "EnrollmentDate", table: "Person", nullable: true); 

migrationBuilder.AddColumn<string>(name: "Discriminator", table: "Person", nullable: false, maxLength: 128 
defaultValue: "Instructor"); 

migrationBuilder.AlterColumn<DateTime>(name: "FlireDate", table: "Person", nullable: true); 

migrationBuilder.AddColumn<int>(name: "Oldld", table: "Person", nullable: true); 

// Copy existing Student data into new Person table. 

migrationBuilder.Sql("INSERT INTO dbo.Person (LastName, FirstName, HireDate, EnrollmentDate, Discriminator 
Oldld) SELECT LastName, FirstName, null AS HireDate, EnrollmentDate, 'Student' AS Discriminator, ID AS Oldld 
FROM dbo.Student"); 

// Fix up existing relationships to match new PK's. 

migrationBuilder.Sql("UPDATE dbo. Enrollment SET Studentld = (SELECT ID FROM dbo.Person IaIHERE Oldld = 
Enrollment.Studentld AND Discriminator = 'Student')"); 

// Remove temporary key 

migrationBuilder.DropColumn(name: "OldlD", table: "Person"); 

migrationBuilder.DropTable( 
name: "Student"); 

migrationBuilder.CreateIndex( 

name: "IX_Enrollment_StudentID", 
table: "Enrollment", 
column: "StudentlD"); 

migrationBuilder.AddForeignKey( 

name: "FK_Enrollment_Person_StudentID", 

table: "Enrollment", 

column: "StudentlD", 

principalTable: "Person", 

principalColumn: "ID", 

onDelete: ReferentialAction.Cascade); 


Bu kod aşağıdaki veritabanı güncelleştirme görevlerini gerçekleştirir: 

• Yabancı anahtar kısıtlamalarını ve öğrenci tablosuna işaret eden dizinleri kaldırır. 

• Eğitmen tablosunu kişi olarak yeniden adlandırır ve öğrenci verilerini depolamak için gerekli değişiklikleri 
yapar: 

• Öğrenciler için Nullable kayıt tarihi ekler. 

• Bir satırın bir öğrenci mi yoksa bir eğitmen mi olduğunu göstermek için ayrıştırıcı sütunu ekler. 

• Öğrenci satırlarında işe alma tarihleri olmadığından, HireDate null yapılabilir hale gelir. 

• Öğrencilere işaret eden yabancı anahtarları güncelleştirmek için kullanılacak geçici bir alan ekler.Öğrencileri 
kişi tablosuna kopyaladığınızda, yeni birincil anahtar değerleri alırlar. 

• Öğrenci tablosundaki verileri kişi tablosuna kopyalar. Bu, öğrencilerden yeni birincil anahtar değerleri 
atanmasını sağlar. 

• Öğrencilere işaret eden yabancı anahtar değerlerini düzeltir. 


• Yabancı anahtar kısıtlamalarını ve dizinleri yeniden oluşturur, şimdi bunları kişi tablosuna işaret eder. 



(Birincil anahtar türü olarak tamsayı yerine GUID kullandıysanız, öğrenci birincil anahtar değerlerinin değiştirilmesi 
gerekmez ve bu adımların bazıları atlanamaz.) 

@No__t-0 komutunu çalıştırın: 

dotnet ef database update 

(Bir üretim sisteminde, önceki veritabanı sürümüne geri dönmek için bunu kullanmanız durumunda Down 
yönteminde ilgili değişiklikleri yaparsınız. Bu öğreticide Down yöntemini kullanmayacağız.) 


NOTE 

Varolan verileri içeren bir veritabanında şema değişiklikleri yaparken başka hatalar almak mümkündür. Çözemiyoruz geçiş 
hataları alırsanız, bağlantı dizesindeki veritabanı adını değiştirebilir veya veritabanını silebilirsiniz. Yeni bir veritabanı ile 
geçirilecek veri yoktur ve Update-Database komutunun hatasız tamamlanabilmesi daha olasıdır. Veritabanını silmek için, SSOX 
kullanın veya database drop CLı komutunu çalıştırın. 


Uygulamayı test etme 

Uygulamayı çalıştırın ve çeşitli sayfaları deneyin. Her şey, daha önce olduğu gibi çalışmaktadır. 

SQL Server Nesne Gezgini, veri bağlantıları/SchoolContext ve ardından Tablolar 1 ı genişletin ve öğrenci ve 
eğitmen tablolarının bir kişi tablosu ile değiştirildiğini görürsünüz. Kişi tablosu tasarımcısını açın ve öğrencinin ve 
eğitmen tablolarında kullanılan tüm sütunları olduğunu görürsünüz. 
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Kişi tablosuna sağ tıklayın ve ardından tablo verilerini göster 1 e tıklayarak ayrıştırıcı sütununu görüntüleyin. 
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Kodu edinin 

Tamamlanmış uygulamayı indirin veya görüntüleyin. 

Ek kaynaklar 

Entity Framevvork Core devralma hakkında daha fazla bilgi için bkz. Devralma. 

Sonraki adımlar 

Bu öğreticide şunları yaptınız: 

• Veritabanına devralma eşlenmiş 

• Kişi sınıfı oluşturuldu 

• Güncelleştirilmiş eğitmen ve öğrenci 

• Modele kişi eklendi 

• Geçişleri oluşturma ve güncelleştirme 

• Uygulama test edildi 

Çeşitli görece gelişmiş Entity Framevvork senaryolarını nasıl işleyeceğinizi öğrenmek için sonraki öğreticiye 
ilerleyin. 


İleri: gelişmiş konular 

















Öğretici: Gelişmiş senaryolar hakkında bilgi edinin-EF 
Core ASRNET MVC 

11.10.2019 • 22 minutes to readı Edit Online 


Önceki öğreticide, tablo başına devralma devralmayı uyguladık. Bu öğreticide, Entity Framevvork Core kullanan 
ASP.NET Core Web uygulamaları geliştirme hakkında temel bilgileri aşdığınızda dikkat etmeniz yararlı olan birkaç 
konu sunulmaktadır. 

Bu öğreticide şunları yaptınız: 

• Ham SQL sorguları gerçekleştirme 

• Varlıkları döndürmek için bir sorgu çağırın 

• Başka türler döndürmek için bir sorgu çağırın 

• Güncelleştirme sorgusu çağırma 

• SQL sorgularını inceleyin 

• Soyutlama katmanı oluşturma 

• Otomatik değişiklik algılama hakkında bilgi edinin 

• EF Core kaynak kodu ve geliştirme planları hakkında bilgi edinin 

• Kodu basitleştirmek için dinamik LINQ kullanmayı öğrenin 

Önkoşullar 

• Devralmayı Uygula 

Ham SQL sorguları gerçekleştirme 

Entity Framevvork kullanmanın avantajlarından biri, kodunuzun veri depolarken belirli bir yönteme çok 
benzemesidir. Bunu sizin için SQL sorguları ve komutları oluşturarak yapar, bu da sizi kendiniz yazmak zorunda 
kalmaktan kurtarır. Ancak el ile oluşturduğunuz belirli SQL sorgularını çalıştırmanız gerektiğinde olağanüstü 
senaryolar vardır. Bu senaryolar için Entity Framevvork Code First API 'SI, SQL komutlarını doğrudan veritabanına 
geçirmenize olanak sağlayan yöntemleri içerir. EF Core 1,0 ' de aşağıdaki seçenekleriniz vardır: 

• Varlık türleri döndüren sorgular için DbSet.FromSqi yöntemini kullanın. Döndürülen nesneler DbSet nesnesi 
tarafından beklenen türde olmalıdır ve izlemeyikapatmadığınız takdirde veritabanı bağlamı tarafından 
otomatik olarak izlenir. 

• Sorgu olmayan komutlar için Database.ExecuteSqlCommand kullanın. 

Varlık olmayan türleri döndüren bir sorgu çalıştırmanız gerekiyorsa, EF tarafından sunulan veritabanı bağlantısıyla 
ADO.N ET kullanabilirsiniz. Döndürülen veriler, varlık türlerini almak için bu yöntemi kullanıyor olsanız bile 
veritabanı bağlamı tarafından izlenmez. 

Her zaman doğru olduğu gibi, bir Web uygulamasında SQL komutları yürüttüğünüzde, sitenizi SQL ekleme 
saldırılarına karşı korumak için önlemler almalısınız. Bunu yapmanın bir yolu, bir Web sayfası tarafından gönderilen 
dizelerin SQL komutları olarak yorumlanamadığından emin olmak için parametreli sorgular kullanmaktır. Bu 
öğreticide Kullanıcı girişini bir sorguyla tümleştirdiğinizde parametreli sorgular kullanacaksınız. 

Varlıkları döndürmek için bir sorgu çağırın 

@No__t-0 sınıfı, TEntity türünde bir varlık döndüren bir sorgu yürütmek için kullanabileceğiniz bir yöntem sağlar. 









Bunun nasıl çalıştığını görmek için, Bölüm denetleyicisinin Details yönteminde kodu değiştirirsiniz. 


DepartmentsController.es' de, Details yönteminde, aşağıdaki vurgulanmış kodda gösterildiği gibi bir departmanı 
alan kodu FromSqi yöntem çağrısıyla değiştirin: 

public async Task<IActionResult> Details(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

string query = "SELECT * FROM Department IaIHERE DepartmentlD = {0}"; 
var department = await _context.Departments 
.FromSql(query, id) 

.Include(d => d.Administrator) 

.AsNoTracking() 

.FirstOrDefaultAsync(); 

if (department == null) 

{ 

return NotFound(); 

} 

return View(department); 

} 


Yeni kodun doğru şekilde çalıştığını doğrulamak için Departmanlar sekmesini seçin ve sonra departmanlardan 
birine ilişkin ayrıntıları izleyin. 
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Budget 

$ 200 . 000.00 

Name 

English 

Administrator 

Abercrombie, Kim 

Start Date 

2016 - 12-31 




1 ^ 




Başka türler döndürmek için bir sorgu çağırın 

Daha önce, yaklaşık bir kayıt tarihi için öğrenci sayısını gösteren hakkında sayfasında bir öğrenci istatistikleri 
Kılavuzu oluşturdunuz. Öğrenciler varlık kümesindeki ( _context.students ) verileri aldınız ve LINQ 'ı, sonuçları bir 
EnroiimentDateGroup görünüm modeli nesneleri listesine eklemek için kullandınız. LINQ kullanmak yerine SQL 'in 
kendisini yazmak istediğinizi varsayalım. Bunu yapmak için, varlık nesnelerinden başka bir şey döndüren bir SQL 
sorgusu çalıştırmanız gerekir. EF Core 1,0 1 de, bunu yapmanın bir yolu ADO.NET kodunu yazıp EF 'ten veritabanı 
bağlantısı almanızı sağlar. 















HomeController.es' de About yöntemini aşağıdaki kodla değiştirin: 


public async Task<ActionResult> About() 

{ 

List<EnrollmentDateGroup> groups = new List<EnrollmentDateGroup>(); 
var conn = _context.Database.GetDbConnection(); 
try 
{ 

await conn.OpenAsync(); 

using (var command = conn.CreateCommand()) 

{ 

string qııery = "SELECT EnrollmentDate, COUNT(*) AS StudentCount " 

+ "FROM Person " 

+ "WHERE Discriminator = 'Student' " 

+ "GROUP BY EnrollmentDate"; 
command.CommandText = query; 

DbDataReader reader = await command.ExecuteReaderAsync(); 

if (reader.HasRows) 

{ 

while (await reader.ReadAsync()) 

{ 

var row = new EnrollmentDateGroup { EnrollmentDate = reader.GetDateTime(0), StudentCount 
reader.Getlnt32(l) }; 

groups.Add(row); 

} 

} 

reader.Dispose(); 

} 

} 

finally 

{ 

conn.Close(); 

} 

return View(groups); 


Using deyimleri ekleme: 

using System.Data.Common; 


Uygulamayı çalıştırın ve hakkında sayfasına gidin. Daha önce yaptığımız verileri görüntüler. 
localhost:5313/ 


Contoso University 


Student Body Statistics 

Enrollment DateStudents 


9 / 1/2005 1 

9 / 1/2010 1 

9 / 1/2011 1 



Güncelleştirme sorgusu çağırma 

Contoso Üniversitesi yöneticilerinin veritabanında, her kurs için kredi sayısını değiştirme gibi genel değişiklikleri 
gerçekleştirmesini istediğini varsayalım. Üniversitenin çok sayıda kursu varsa, bunların tümünü varlıklar olarak 
almak ve tek tek değiştirmek verimsiz olur. Bu bölümde, kullanıcının tüm kurslar için kredi sayısını değiştirecek bir 








faktör belirtmesini sağlayan bir Web sayfası uygulayacaksınız ve bir SQL UPDATE ifadesini yürüterek değişikliği 
yaparsınız. Web sayfası aşağıdaki çizimde gösterildiği gibi görünür: 


E3 UpdateCourseCredits - X + 


□ X 


o 

^^B 

■ ••••■ 

Ilı 

Contoso University 


— 

Update Course Credits 



Enter a number to multiply every course's credits by: 
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CoursesController.es' de, HttpGet ve HttpPost için UpdateCourseCredits yöntemleri ekleyin: 

public IActionResult UpdateCourseCredits() 

{ 

return View(); 

} 


[HttpPost] 

public async Task<IActionResult> UpdateCourseCredits(int? multiplier) 

{ 

if (multiplier != null) 

{ 

ViewData["RowsAffected''] = 

await _context.Database.ExecuteSqlCommandAsync( 

"UPDATE Course SET Credits = Credits * {0}", 
parameters: multiplier); 

} 

return View(); 

} 

Denetleyici bir HttpGet isteğini işlediğinde, viewData["RowsAffected"] 1 a hiçbir şey döndürülmez ve görünüm, 
önceki çizimde gösterildiği gibi boş bir metin kutusu ve bir Gönder düğmesi görüntüler. 

Update düğmesine tıklandığında, HttpPost yöntemi çağırılır ve Multiplier metin kutusuna girilen değer vardır. Kod 
daha sonra, bu güncelleştirmeleri güncelleştiren SQL 'i yürütür ve etkilenen satırların sayısını viewData ' da 
görünümüne döndürür. Görünüm bir RowsAffected değeri aldığında, güncelleştirilmiş satır sayısını görüntüler. 

Çözüm Gezgini, Görünümler/kurslar klasörüne sağ tıklayın ve ardından > yeni öğe Ekle 1 ye tıklayın. 

Yeni öğe Ekle iletişim kutusunda sol bölmede yüklü ASP.NET Core ' a tıklayın, Razor görünümü' ne tıklayın ve 
yeni görünüm UpdateCourseCredits. cs/rfm/olarak adlandırın. 

Views/kurslar/UpdateCourseCredits. estrfm/içinde, şablon kodunu şu kodla değiştirin: 





















@{ 

ViewBag.Title = "UpdateCourseCredits"; 

} 

<h2>Update Course Credits</h2> 

Şif (ViewData["RowsAffected"] == null) 

{ 

<form asp-action="UpdateCourseCredits"> 

<div class="form-actions no-color"> 

<P> 

Enter a number to multiply every course's credits by: ŞHtml.TextBox("multiplier") 

</p> 

<P> 

<input type="submit" value="Update" class="btn btn-default" /> 

</p> 

</div> 

</form> 

} 

Şif (ViewData["RowsAffected"] != null) 

{ 

<P> 

Number of rows updated: ŞViewData["RowsAffected"] 

</p> 

} 

<div> 

ŞHtml.ActionLink("Back to List", "Index") 

</div> 


@No__t-0 yöntemini, Kurslar sekmesini seçerek çalıştırın, sonra tarayıcının adres çubuğundaki URL 'nin sonuna 
"/UpdateCourseCredits" ekleyin (örneğin: http://iocaihost:58i3/courses/updateCourseCredits ). Metin kutusuna bir 
sayı girin: 
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Update Course Credits 

Enter a number to multiply every course's credits by: 
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Güncel leşti re tıklayın. Etkilenen satır sayısını görürsünüz: 


B UpdateCourseCredits - X + 
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Contoso University 
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Update Course Credits 


Number of rows updated: 7 

























Düzeltilen kredi sayısına sahip kurslar listesini görmek için listeye geri ' ye tıklayın. 

Üretim kodunun güncelleştirmelerin her zaman geçerli verilerle sonuçlandığına emin olun. Burada gösterilen 
kod, 5 1 ten fazla sayı ile sonuçlanacak kredilerin sayısını çarpamaz. (@No__t-0 özelliği bir 
özniteliğine sahiptir.) Güncelleştirme sorgusu çalışır, ancak geçersiz veriler sistemin diğer 
bölümlerinde, kredi sayısının 5 veya daha az olduğunu varsayacak beklenmedik sonuçlara neden olabilir. 

Ham SQL sorguları hakkında daha fazla bilgi için bkz. Ham SQL sorguları. 

SQL sorgularını inceleyin 

Bazen veritabanına gönderilen gerçek SQL sorgularını görmeniz yararlı olabilir.ASP.NET Core için yerleşik günlük 
işlevselliği, sorgular ve güncelleştirmeler için SQL içeren günlükleri yazmak üzere EF Core tarafından otomatik 
olarak kullanılır. Bu bölümde, SQL günlüğe kaydetme işleminin bazı örneklerini görürsünüz. 

StudentsController.es ' i açın Details yöntemi if (student == nuii) ifadesinde bir kesme noktası ayarlayın. 

Uygulamayı hata ayıklama modunda çalıştırın ve bir öğrenci için ayrıntılar sayfasına gidin. 

Hata ayıklama çıkışını gösteren Çıkış penceresine gidin ve sorguyu görürsünüz: 

Microsoft.EntityFrameworkCore.Database.Command:Information: Executed DbCommand (56ms) [Parameters= 

[@_id_0='?']j CommandType='Text’, CommandTimeout='30'] 

SELECT T0P(2) [s].[ID], [s].[Discriminator], [s].[FirstName], [s].[LastName], [s].[EnrollmentDate] 

FROM [Person] AS [s] 

IaIHERE ([s]. [Discriminator] = N'Student') AND ([s].[ID] = @_id_0) 

ORDER BY [s].[ID] 

Microsoft.EntityFrameworkCore.Database.Command:Information: Executed DbCommand (122ms) [Parameters= 

[@_id_0='?']j CommandType='Text’, CommandTimeout='30'] 

SELECT [s.Enrollments].[EnrollmentlD], [s.Enrollments].[CourselD], [s.Enrollments].[Grade], [s.Enrollments]. 
[StudentlD], [e.Course].[CourselD], [e.Course].[Credits], [e.Course].[DepartmentlD], [e.Course].[Title] 

FROM [Enrollment] AS [s.Enrollments] 

INNER 30IN [Course] AS [e.Course] ON [s.Enrollments].[CourselD] = [e.Course].[CourselD] 

INNER JOIN ( 

SELECT TOP(l) [s0].[ID] 

FROM [Person] AS [s0] 

IaIHERE ([s0]. [Discriminator] = N'Student') AND ([s0].[ID] = @_id_0) 

ORDER BY [S0].[ID] 

) AS [t] ON [s.Enrollments].[StudentlD] = [t].[ID] 

ORDER BY [t].[ID] 

Size beklenmedik bir şekilde bir sorun olduğunu fark edeceksiniz: SQL, kişi tablosundan 2 ' ye kadar satır ( top( 2 ) ) 
seçer. @No__t-0 yöntemi sunucuda 1 satıra çözümlenmiyor, işte şunları yapın: 

• Sorgu birden çok satır döndürürse, yöntemi null döndürür. 

• Sorgunun birden çok satır döndürüp döndürmeyeceğini anlamak için EF 'in en az 2 değerini döndürüp 
döndürmediğini denetlemesi gerekir. 

Ç 1 kış penceresinde günlüğe kaydetme çıktısını almak için hata ayıklama modunu kullanmanız ve bir kesme 
noktasında durdurmanız gerekmediğini unutmayın. Bu, çıkışa bakmak istediğiniz noktada günlüğe kaydetmeyi 
durdurmak için kullanışlı bir yoldur. Bunu yapmazsanız, günlüğe kaydetme devam eder ve ilgilendiğiniz parçaları 
bulmak için geri kaydırmanız gerekir. 

Soyutlama katmanı oluşturma 

Birçok geliştirici, Entity Framevvork ile çalışan kodun etrafında bir sarmalayıcı olarak depo ve iş birimi düzenlerini 
uygulamak için kod yazar. Bu desenler, veri erişim katmanı ve bir uygulamanın iş mantığı katmanı arasında bir 
soyutlama katmanı oluşturmak için tasarlanmıştır. Bu desenleri uygulamak, uygulamanızın veri deposundaki 
değişikliklerden yalıtılmış hale getirmenize yardımcı olabilir ve otomatik birim testi veya test odaklı geliştirmeyi 


basitleştirilmiş 
[Range(0, 5)] 








(TDD) kolaylaştırabilir. Ancak, bu desenleri uygulamak için ek kod yazmak, birkaç nedenden dolayı EF kullanan 
uygulamalar için her zaman en iyi seçimdir: 

• EF bağlam sınıfının kendisi, veri deposuna özgü koddan kodunuzun kendisini uygular. 

• EF bağlam sınıfı, EF kullanarak yaptığınız veritabanı güncelleştirmeleri için bir iş birimi sınıfı işlevi görebilir. 

• EF, depo kodu yazmadan TDD uygulamaya yönelik özellikler içerir. 

Deponun ve iş düzeni birimlerinin nasıl uygulanacağı hakkında bilgi için, Bu öğretici serisinin Entity Framevvork 5 
sürümünebakın. 

Entity Framevvork Core, test için kullanılabilecek bir bellek içi veritabanı sağlayıcısı uygular. Daha fazla bilgi için bkz. 

InMemory lletestetme. 

Otomatik değişiklik algılama 

Entity Framevvork bir varlığın geçerli değerlerini özgün değerlerle karşılaştırarak bir varlığın nasıl değiştiğini (ve bu 
nedenle veritabanına gönderilmesi gereken güncelleştirmeleri) belirler. Özgün değerler, varlık sorgulandığında veya 
eklendiğinde saklanır. Otomatik değişiklik algılamaya neden olan yöntemlerin bazıları şunlardır: 

• DbContext. SaveChanges 

• DbContext. Entry 

• ChangeTracker. Entries 

Çok sayıda varlığı izliyorsanız ve bu yöntemlerden birini bir döngüde birçok kez çağırırsanız, 

ChangeTracker.AutoDetectchangesEnabled özelliğini kullanarak otomatik değişikliği algılamayı geçici olarak kapatarak 
önemli performans iyileştirmeleri alabilirsiniz. Örnek: 

_context.ChangeTracker.AutoDetectchangesEnabled = false; 


EF Core kaynak kodu ve geliştirme planları 

Entity Framevvork Core kaynağı https://github.com/aspnet/EntityFrameworkCore' dir. EF Core deposu gecelik 
derlemeler, sorun izleme, özellik özellikleri, tasarım toplantısı notları ve ileride geliştirmeye yönelik yol 
haritasınıiçerir. Hataları dosyalayabilirsiniz veya bulabilir ve katkıda bulunabilirsiniz. 

Kaynak kodu açık olsa da Entity Framework Core, Microsoft ürünü olarak tam olarak desteklenmektedir. Microsoft 
Entity Framework ekibi, her bir yayının kalitesini sağlamak için, hangi katkıların kabul edildiğini denetler ve tüm kod 
değişikliklerini sınar. 

Mevcut veritabanından ters mühendislik 

Mevcut bir veritabanından varlık sınıfları dahil bir veri modeline ters mühendislik uygulamak için Scaffold- 
DbContext komutunu kullanın. Bkz. Başlangıç öğreticisi. 

Kodu basitleştirmek için dinamik LINQ kullanma 

Bu serideki üçüncü öğreticide , switch ifadesinde sabit kodlama sütun adları aracılığıyla LINQ kodunun nasıl 
yazılacağı gösterilmektedir. Arasından seçim yapabileceğiniz iki sütun varsa, bu sorunsuz bir şekilde yapılır, ancak 
çok sayıda sütununuzla karşılaşırsanız, kod ayrıntılı alabilir. Bu sorunu çözmek için, özelliğin adını dize olarak 
belirtmek üzere EF.Property yöntemini kullanabilirsiniz. Bu yaklaşımı denemek için, studentscontroiler 'deki 
index yöntemini aşağıdaki kodla değiştirin. 






public async Task<IActionResult> Index( 
string sortOrder, 
string currentFilter, 
stning searchString, 
int? pageNumber) 

{ 

ViewData["CurrentSort"] = sortOrder; 

ViewData["NameSortParm"] = 

String.IsNullOrEmpty(sortOrder) ? "LastName_desc" : 
Vİ8wData["DateSontPanm"] = 

sontOnden == "EnnollmentDate" ? "EnnollmentDate_desc" : "EnnollmentDate"; 

if (seanchStning != null) 

{ 

pageNumber = 1; 

} 

else 

{ 

seanchStning = currentFilter; 

} 

ViewData["CunnentFilten"] = searchString; 

van students = fnom s in _context.Students 
select s; 


if (! Stning. Isl\lullOnEmpty(seanchStning)) 

{ 


students = students.Where(s => s.LastName.Contains(seanchStning) 

| s.FinstMidName.Contains(seanchStning)); 


} 

if (stning.IsNullOnEmpty(sontOnden)) 

{ 


sontOnden = "LastName"; 

} 


bool descending = false; 
if (sontOnden.EndsWith("_desc")) 

{ 

sontOnden = sontOnden.Substning(0j sontOnden.Length - 5); 
descending = tnue; 

} 


if (descending) 

{ 

students = students.OndenByDescending(e => EF.Pnopenty<object>(ej sontOnden)); 

} 

else 

{ 

students = students.OndenBy(e => EF.Pnopenty<object>(ej sontOnden)); 

} 


int pageSize = 3; 

netunn View(await PaginatedList<Student>.CneateAsync(students.AsNoTnackingO, 
pageNumben ?? 1 , pageSize)); 


Bilgilendirme 

Tom Dykstra ve Rick Anderson (Tvvitter @RickAndMSFT) bu öğreticiyi yazdı. ROWA Miller, Diego Vega ve kod 
incelemeleri ile Entity Framevvork ekip yardımlı diğer üyeleri ve öğreticiler için kod yazarken oluşan sorunları 
ayıkladık. John Parente ve Paul Goldman, 2,2 ASP.NET Core öğreticisini güncelleştirmeye çalıştı. 



Sık karşılaşılan hataları giderme 

Başka bir işlem tarafından kullanılan Contosollniversity. dil 

Hata iletisi: 

Açılamıyor Bin\debug\netcoreapp1.0\contosoijniversity.dll ' yazma için—' başka bir işlem tarafından 
kullanıldığından, işlem ..\Bin\debug\netcoreapp1 .O\contosoijniversi.dll ' dosyasına erişemiyor. 

Çözümden 

IIS Express sitesini durdurun. Windows sistemi tepsisine 11S Express bulun ve simgesine sağ tıklayın, Contoso 
Üniversitesi sitesini seçin ve ardından siteyi durdur 1 a tıklayın. 

Yukarı ve aşağı metotlarda kod olmadan geçiş yapı iskelesi 

Olası neden: 

EF CLı komutları, kod dosyalarını otomatik olarak kapatmaz ve kaydetmez. @No__t-0 komutunu çalıştırdığınızda 
hiçbir değişiklik yaptıysanız, EF değişiklikleri bulamaz. 

Çözümden 

@No__t-0 komutunu çalıştırın, kod değişikliklerinizi kaydedin ve migrations add komutunu yeniden çalıştırın. 

Veritabanı güncelleştirmesi çalıştırılırken hatalar oluştu 

Varolan verileri içeren bir veritabanında şema değişiklikleri yaparken başka hatalar almak mümkündür. 
Çözümleyemez geçiş hataları alırsanız, bağlantı dizesindeki veritabanı adını değiştirebilir veya veritabanını 
silebilirsiniz. Yeni bir veritabanı ile geçirilecek veri yoktur ve Update-Database komutunun hatasız 
tamamlanabilmesi çok daha yüksektir. 

En basit yaklaşım, appSettings. VSOA/içindeki veritabanını yeniden adlandırmanın bir veritabanıdır. @No__t-0 ' ı bir 
sonraki sefer çalıştırdığınızda yeni bir veritabanı oluşturulur. 

SSOX 'te bir veritabanını silmek için veritabanına sağ tıklayın, Sil' e tıklayın ve ardından veritabanını sil İletişim 
kutusunda varolan bağlantıları kapat ' ı seçin ve Tamam' a tıklayın. 

CLı kullanarak bir veritabanını silmek için database drop CLı komutunu çalıştırın: 

dotnet ef database drop 

SQL Server örneği bulunurken hata oluştu 

Hata İletisi: 

SQL Server ile bağlantı kurulmaya çalışılırken ağ ile ilişkili veya örneğe özgü bir hata oluştu. Sunucu 
bulunamadı veya erişilebilir değildi. Örnek adının doğru olduğundan ve SQL Server uzak bağlantılara izin 
verecek şekilde yapılandırıldığından emin olun, (sağlayıcı: SQL ağ arabirimleri, hata: 26-belirtilen sunucu/örnek 
bulunurken hata oluştu) 

Çözümden 

Bağlantı dizesini denetleyin. Veritabanı dosyasını el ile şildiyseniz, oluşturma dizesindeki veritabanının adını yeni bir 
veritabanı ile başlatılacak şekilde değiştirin. 

Kodu edinin 

Tamamlanmış uygulamayı indirin veya görüntüleyin. 





Ek kaynaklar 

EF Core hakkında daha fazla bilgi için Entity Framevvork Core belgelerinebakın. Bir kitap da kullanılabilir: Entity 
Framevvork Core eylem. 

Bir Web uygulamasını dağıtma hakkında daha fazla bilgi için bkz. ASP.NET Core barındırma ve dağıtma. 

Kimlik doğrulama ve yetkilendirme gibi ASP.N ET Core MVC ile ilgili diğer konular hakkında daha fazla bilgi için 
bkz.ASP.NET Core'a Giriş. 

Sonraki adımlar 

Bu öğreticide şunları yaptınız: 

• Ham SQL sorguları gerçekleştiriliyor 

• Varlıkları döndürmek için sorgu çağrıldı 

• Diğer türleri döndürmek için sorgu çağrıldı 

• Bir güncelleştirme sorgusu çağrıldı 

• incelenen SQL sorguları 

• Soyutlama katmanı oluşturma 

• Otomatik değişiklik algılama hakkında bilgi edinildi 

• EF Core kaynak kodu ve geliştirme planları hakkında bilgi edinildi 

• Kodu basitleştirmek için dinamik LINQ kullanımı öğrenildi 

Bu, ASP.NET Core MVC uygulamasında Entity Framework Core kullanımı hakkında bu öğretici serisini tamamlar. 
Bu seri yeni bir veritabanıyla çalıştı; bir alternatif, mevcut bir veritabanından bir modele tersine mühendislik 
kullanmaktır. 

Öğretici: MVC ile EF Core, var olan veritabanı 


ASPNET Core temelleri 
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Bu makale, ASP.NET Core uygulamaları geliştirmeyi anlamak için önemli konulara genel bakış sağlar. 


Başlangıç sınıfı 

startup sınıfı şu konumda: 

• Uygulamanın gerektirdiği hizmetler yapılandırıldı. 

• İstek işleme işlem hattı tanımlandı. 


Hizmetler, uygulama tarafından kullanılan bileşenlerdir. Örneğin, bir günlük bileşeni bir hizmettir. Hizmetleri 
yapılandırmak (veya kaydettirmek) için kod startup.configureServices yöntemine eklenir. 


istek işleme işlem hattı, bir dizi Ara yazılım bileşeni olarak oluşur. Örneğin, bir ara yazılım statik dosyalar için 
istekleri işleyebilir veya HTTP isteklerini HTTPS 'ye yeniden yönlendirebilir. Her bir ara yazılım bir HttpContext 
zaman uyumsuz işlemler gerçekleştirir ve sonra işlem hattında sonraki ara yazılımı çağırır ya da isteği sonlandırır. 
istek işleme işlem hattını yapılandırma kodu startup.configure yöntemine eklenir. 


Örnek bir startup sınıfı aşağıda verilmiştir: 


public class Startup 
{ 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services. AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


} 


Services.AddDbContext<MovieContext>(options => 

options.UseSqlServer(Configuration.GetConnectionString("MovieDb"))); 


public void Configure(IApplicationBuilder app) 
{ 

app.UseHttpsRedirection(); 

app.UseStaticFiles(); 

app.UseMvc(); 

} 


Daha fazla bilgi için bkz. ASP.NET Core 'de uygulama başlatma. 


Bağımlılık ekleme (hizmetler) 

ASP.NET Core, yapılandırılmış hizmetlerin bir uygulamanın sınıfları tarafından kullanılabilmesini sağlayan yerleşik 
bir bağımlılık ekleme (dı) çerçevesine sahiptir. Bir sınıftaki hizmetin bir örneğini almanın bir yolu, gerekli türde bir 
parametreye sahip bir Oluşturucu oluşturmaktır. Parametresi hizmet türü veya arabirim olabilir. Dı sistemi, çalışma 
zamanında hizmeti sağlar. 

işte bir Entity Framevvork Core bağlam nesnesi almak için Dİ kullanan bir sınıf. Vurgulanan çizgi bir Oluşturucu 
Ekleme örneğidir: 










public class IndexModel : PageModel 
{ 

private readonly RazorPagesMovieContext _context; 

public IndexModel(RazorPagesMovieContext context) 
{ 

_context = context; 

} 

// ... 

public async Task OnGetAsync() 

{ 

var movies = from m in _context.Movies 
select m; 

Movies = await movies.ToListAsync(); 

} 

} 


Dı yerleşik olarak kullanılıyorsa, isterseniz Control (IOC) kapsayıcısının bir üçüncü taraf Inversion öğesini 
eklemenize olanak sağlamak üzere tasarlanmıştır. 

Daha fazla bilgi için bkz. ASP.NET Core bağımlılık ekleme. 


Ara yazılım 

istek işleme işlem hattı, bir dizi ara yazılım bileşeni olarak oluşur. Her bileşen bir HttpContext zaman uyumsuz 
işlemler gerçekleştirir ve sonra işlem hattında sonraki ara yazılımı çağırır ya da isteği sonlandırır. 

Kurala göre, startup.configure yönteminde use... uzantısı yöntemini çağırarak işlem hattına bir ara yazılım 
bileşeni eklenir. Örneğin, statik dosyaların işlenmesini etkinleştirmek için usestaticFiles çağırın. 


Aşağıdaki örnekteki vurgulanan kod, istek işleme işlem hattını yapılandırır: 


public class Startup 
{ 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services. AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


} 


Services.AddDbContext<MovieContext>(options => 

options.UseSqlServer(Configuration.GetConnectionString("MovieDb"))); 


public void Configure(IApplicationBuilder app) 
{ 

app.UseHttpsRedirection(); 

app.UseStaticFiles(); 

app.UseMvc(); 

} 


AS P.N ET Core, zengin bir yerleşik ara yazılım kümesi içerir ve özel ara yazılım yazabilirsiniz. 


Daha fazla bilgi için bkz. ASP.NET Core ara yazılımı. 


Ana bilgisayar 

ASP.NET Core bir uygulama, başlangıçta bir konak oluşturur. Ana bilgisayar, uygulamanın tüm kaynaklarını 
kapsülleyen bir nesnedir, örneğin: 


• Bir HTTP sunucusu uygulama 








• Ara yazılım bileşenleri 

• Günlüğe Kaydetme 

• İÇERİK 

• Yapılandırma 


Uygulamanın tüm birbirine bağlı kaynaklarını tek bir nesnede dahil etmek için başlıca neden, yaşam süresi 
yönetimi: uygulama başlatma ve düzgün kapanma üzerinde denetim. 

iki konak mevcuttur: genel ana bilgisayar ve Web ana bilgisayarı. Genel ana bilgisayar önerilir ve Web konağı 
yalnızca geriye dönük uyumluluk için kullanılabilir. 


Bir konak oluşturma kodu Program.Main : 



seçeneklerle bir konak yapılandırır: 

• Web sunucusu olarak Kestrel kullanın ve MS tümleştirmesini etkinleştirin. 

• AppSettings. JSON, appSettings 'ten yapılandırma yükleyin . {Ortam adi}. JSON, ortam değişkenleri, komut 
satırı bağımsız değişkenleri ve diğer yapılandırma kaynakları. 

• Günlüğe kaydetme çıkışını konsola ve hata ayıklama sağlayıcılarına gönderin. 


Daha fazla bilgi için bkz. .NET genel ana bilgisayar. 

iki konak mevcuttur: Web Konağı ve genel ana bilgisayar. ASP.NET Core 2. x içinde, genel konak yalnızca Web dışı 
senaryolar içindir. 

Bir konak oluşturma kodu Program.Main : 


public class Program 
{ 

public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build().Run(); 

} 


} 


public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 
WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>(); 


createDefaultBuiider yöntemi, aşağıdaki gibi yaygın olarak kullanılan seçeneklere sahip bir konak yapılandırır: 

• Web sunucusu olarak Kestrei kullanın ve MS tümleştirmesini etkinleştirin. 

• AppSettings. JSON, appSettings 'ten yapılandırma yükleyin . {Ortam adi}. JSON, ortam değişkenleri, komut 



satırı bağımsız değişkenleri ve diğer yapılandırma kaynakları. 

• Günlüğe kaydetme çıkışını konsola ve hata ayıklama sağlayıcılarına gönderin. 

Daha fazla bilgi için bkz. AS P.N ET Core Web ana bilgisayarı. 

Web dışı senaryolar 

Genel ana bilgisayar, diğer uygulama türlerinin günlüğe kaydetme, bağımlılık ekleme (dı), yapılandırma ve 
uygulama ömür yönetimi gibi çapraz kesme çerçevesi uzantıları kullanmasına izin verir. Daha fazla bilgi için bkz. 
.NET genel ana bilgisayar ve ASP.NET Core içinde barındırılan hizmetlerle arka plan görevleri. 

Sunucular 

Bir ASP.NET Core uygulaması HTTP isteklerini dinlemek için HTTP sunucu uygulamasını kullanır.Sunucu, bir 
HttpContext oluşan istek özellikleri kümesi olarak uygulamaya istekleri ister. 

• VVİndovvs 

• macOS 

• 'Un 

ASP.NET Core aşağıdaki sunucu uygulamalarını sağlar: 

• Kestrel , platformlar arası bir Web sunucusudur. Kestrel, genellikle 1 1S kul lanı larak ters bir ara sunucu 
yapılandırmasında çalıştırılır. ASP.NET Core 2,0 veya üzeri sürümlerde, Kestrel doğrudan Internet 'e açık olan 
bir genel kullanıma yönelik uç sunucu olarak çalıştırılabilir. 

• IIS HTTP sunucusu , 11S kullanan bir VVİndovvs sunucusudur.Bu sunucu ile, ASP.NET Core uygulaması ve MS 
aynı işlemde çalışır. 

• Http. sys , 11S ile kullanılmayan bir VVİndovvs sunucusudur. 

• VVİndovvs 

• macOS 

• 'Un 

ASP.NET Core aşağıdaki sunucu uygulamalarını sağlar: 

• Kestrel , platformlar arası bir Web sunucusudur. Kestrel, genellikle 1 1S kul lanı larak ters bir ara sunucu 
yapılandırmasında çalıştırılır. ASP.NET Core 2,0 veya üzeri sürümlerde, Kestrel doğrudan Internet 'e açık olan 
bir genel kullanıma yönelik uç sunucu olarak çalıştırılabilir. 

• Http. sys , IIS ile kullanılmayan bir VVİndovvs sunucusudur. 

Daha fazla bilgi için bkz. AS P.N ET Core Web sunucusu uygulamaları. 

Yapılandırma 

AS P.N ET Core, ayarları sıralı bir yapılandırma sağlayıcıları kümesinden ad-değer çiftleri olarak alan bir 
yapılandırma çerçevesi sağlar.. JSON dosyaları,. xml dosyaları, ortam değişkenleri ve komut satırı bağımsız 
değişkenleri gibi çeşitli kaynaklar için yerleşik yapılandırma sağlayıcıları vardır. Ayrıca, özel yapılandırma 
sağlayıcıları da yazabilirsiniz. 

Örneğin, yapılandırmanın appSettings. JSON ve ortam değişkenlerinden geldiğini belirtebilirsiniz. Ardından, 
ConnectionString değeri istendiğinde, Framevvork ilk olarak appSettings. JSON dosyasına bakar. Değer aynı 
zamanda bir ortam değişkeninde bulunursa, ortam değişkeninin değeri öncelikli olur. 

Parolalar gibi gizli yapılandırma verilerini yönetmek için ASP.NET Core bir gizli dizi Yöneticisi aracısağlar. Üretim 
gizli dizileri için Azure Key Vaultönerilir. 

Daha fazla bilgi için bkz. ASP.NET Core yapılandırma. 



Seçenekler 

Mümkün olduğunda yapılandırma değerlerini depolamak ve almak için Seçenekler deseninin ASP.NET Core. 
Seçenekler stili, ilişkili ayarların gruplarını temsil etmek için sınıfları kullanır. 

Örneğin, aşağıdaki kod VVebSockets seçeneklerini ayarlar: 

var options = new WebSocketOptions 
{ 

KeepAlivelnterval = TimeSpan.FromSeconds(120), 

ReceiveBufferSize = 4096 

}; 

app.UseWebSockets(options); 

Daha fazla bilgi için bkz. ASP.NET Core için seçenek kalıbı. 


Ly 

Geliştirme, hazırlıkve üretimg\b\ yürütme ortamları, ASP.NET Core birinci sınıf kavramlardır. 
aspnetcore_environment ortam değişkenini ayarlayarak bir uygulamanın üzerinde çalıştığı ortamı belirtebilirsiniz. 
ASP.NET Core, uygulamanın başlangıcında bu ortam değişkenini okur ve değeri bir iHostingEnvironment 
uygulamasında depolar. Ortam nesnesi, uygulama tarafından her yerde Dİ aracılığıyla kullanılabilir. 

startup sınıfından aşağıdaki örnek kod, uygulamayı yalnızca geliştirmede çalıştırıldığında ayrıntılı hata bilgilerini 
sunacak şekilde yapılandırır: 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 
app.UseHsts(); 

} 

app.UseHttpsRedirection(); 

app.UseStaticFiles(); 

app.UseMvc(); 

} 

Daha fazla bilgi için bkz. ASP.NET Core çoklu ortamları kullanma. 

Günlüğe Kaydetme 

ASP.NET Core, çeşitli yerleşik ve üçüncü taraf günlük sağlayıcılarıyla birlikte çalışarak bir günlüğe kaydetme API 
'sini destekler. Kullanılabilir sağlayıcılar şunları içerir: 

• Konsolu 

• Hata ayıklama 

• Windows üzerinde olay İzleme 

• Windows olay günlüğü 

• TraceSource 

• Azure App Service 

• Azure Application Insights 







Dı ve çağrı günlüğü yöntemlerinden ILogger nesne alarak uygulamanın kodundaki her yerden günlükleri yazın. 

Oluşturucu Ekleme ve günlük yöntemi çağrılarını vurgulanmış bir iLogger nesnesi kullanan örnek kod aşağıda 
verilmiştir. 

public class TodoController : ControllerBase 
{ 

private readonly ILogger _logger; 

public TodoController(ILogger<TodoController> logger) 

{ 

_logger = logger; 

} 

[HttpGet("{id }", Name = "GetTodo")] 

public ActionResult<TodoItem> GetById(string id) 

{ 

_logger. LogInformation(LoggingEvents .Getltem, "Getting item {Id}" 3 id); 

// Item lookup code removed. 
if (item == null) 

{ 

_logger.LogWarning(LoggingEvents.GetltemNotFoundj "GetById({Id}) NOT FOUND", id); 
return NotFound(); 

} 

return item; 

} 

} 

ILogger arabirimi, günlük sağlayıcısına istediğiniz sayıda alanı geçirmenize olanak sağlar. Alanlar genellikle bir 
ileti dizesi oluşturmak için kullanılır, ancak sağlayıcı bunları bir veri deposuna ayrı alanlar olarak da gönderebilir. Bu 
özellik, günlük sağlayıcılarının yapılandırılmış günlük olarak da bilinen anlam günlüğüuygulamasına olanak tanır. 

Daha fazla bilgi için bkz. .N ET Core ve AS P.N ET Core oturum açma. 

Yönlendirme 

Yol, bir işleyiciye EŞLENMİŞ bir URL örüncidir.işleyici genellikle bir Razor sayfası, MVC denetleyicisindeki bir 
eylem yöntemi veya bir ara yazılım olur. ASP.NET Core yönlendirme, uygulamanız tarafından kullanılan URL 'Ler 
üzerinde denetim sağlar. 

Daha fazla bilgi için bkz. AS P.N ET Core yönlendirme. 

Hata işleme 

AS P.N ET Core, hataları işlemeye yönelik yerleşik özellikler içerir, örneğin: 

• Geliştirici özel durum sayfası 

• Özel hata sayfaları 

• Statik durum kodu sayfaları 

• Başlatma özel durum işleme 

Daha fazla bilgi için bkz. ASP.NET Core hataları işleme. 

HTTP isteğinde bulunma 

iHttpciientFactory bir uygulama Httpciient örnekleri oluşturmak için kullanılabilir. Fabrika: 

• , Mantıksal Httpciient örneklerinin adlandırılması ve yapılandırılması için merkezi bir konum sağlar. Örneğin, 
GitHub istemcisi kayıtU ve GitHub 'a erişebilecek şekilde yapılandırılabilir. Varsayılan istemci, diğer amaçlar için 







kaydedilebilir. 

• , Bir giden istek ara yazılım işlem hattı oluşturmak için birden çok temsilci seçme işleyicisinin kaydını ve 
zincirlemeyi destekler. Bu düzen, AS P.N ET Core gelen ara yazılım ardışık düzenine benzer. Bu model, önbelleğe 
alma, hata işleme, serileştirme ve günlüğe kaydetme dahil olmak üzere HTTP istekleri etrafında çapraz kesme 
sorunlarını yönetmek için bir mekanizma sağlar. 

• Geçici hata işleme için popüler bir üçüncü taraf kitaplığı olan Po//yile tümleşir. 

• Httpciient yaşam sürelerini el ile yönetirken gerçekleşen yaygın DNS sorunlarından kaçınmak için temel 
HttpciientMessageHandier örneklerinin biriktirmesini ve ömrünü yönetir. 

• Fabrika tarafından oluşturulan istemcilerle gönderilen tüm istekler için yapılandırılabilir bir günlük deneyimi ( 

iLogger aracılığıyla) ekler. 

Daha fazla bilgi için bkz. ASP.NET Core 'de ıhttpclientfactory kullanarak HTTP istekleri yapın. 

İçerik kökü 

içerik kökü, için temel yoldur: 

• Uygulamayı barındıran yürütülebilir dosya (. exe). 

• Uygulamayı oluşturan derlenmiş derlemeler (. dil). 

• Uygulama tarafından kullanılan kod olmayan içerik dosyaları, örneğin: 
o Razor dosyaları (. cshtml,. Razor) 

o Yapılandırma dosyaları (. JSON,. xml) 
o Veri dosyaları (. db) 

• Web kökü, genellikle yayınlanan Wwwroot klasörü. 

Geliştirme sırasında: 

• içerik kökü, projenin kök dizinini varsayılan olarak belirler. 

• Projenin kök dizini şunu oluşturmak için kullanılır: 

o Uygulamanın, projenin kök dizinindeki kod olmayan içerik dosyalarının yolu, 
o Web kökü, genellikle projenin kök dizinindeki Wwwroot klasörü. 

Konak oluşturulurkenalternatif bir içerik kök yolu belirtilebilir. Daha fazla bilgi için bkz. N ET genel ana bilgisayar. 

Konak oluşturulurkenalternatif bir içerik kök yolu belirtilebilir. Daha fazla bilgi için bkz. AS P.N ET Core Web ana 
bilgisayarı. 


Web kökü 


Web kökü, genel, kod olmayan statik kaynak dosyalarının temel yoludur, örneğin: 

• Stil sayfaları (. css) 

• JavaScript ( .js) 

• Görüntüler (. png, .jpg) 

Statik dosyalar yalnızca Web kök dizininden (ve alt dizinlerde) varsayılan olarak sunulur. 

Web kök yolu varsayılan olarak {Content root}/Wwwrooto\arak belirlenir, ancak konak oluşturulurkenfarklı bir 
Web kökü belirtilebilir. Daha fazla bilgi için bkz. .NET genel ana bilgisayar. 

Web kök yolu varsayılan olarak {Content roofJ/Wı/mroofolarak belirlenir, ancak konak oluşturulurkenfarklı bir 
Web kökü belirtilebilir. Daha fazla bilgi için bkz. Web root. 

Proje dosyasındaki <içerik > proje öğesi ile Wwwroot 'da dosya yayımlamayı önleyin. Aşağıdaki örnek, 
Wwwroot/yerel dizin ve alt dizinlerde içerik yayımlamayı engeller: 






<ItemGroup> 

cContent Update= ,, wwwroot\local\**\*.*" CopyToPublishDirectory="Never" /> 

</ItemGroup> 

Razor (. cshtml) dosyalarında, tilde işareti ( -/ ) Web köküne işaret eder. ~/ başlayan bir yol, sanal yo/olarak 
adlandırılır. 

Daha fazla bilgi için bkz. ASP.NET Core statik dosyalar. 
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startup sınıfı Hizmetleri ve uygulamanın istek ardışık düzenini yapılandırır. 

Başlangıç sınıfı 

ASP.NET Core uygulamalar, kuralına göre startup adlı bir startup sınıfını kullanır, startup sınıfı: 

• isteğe bağlı olarak, uygulamanın h/zmef/enn/yapılandırmak için bir ConfigureServices yöntemi içerir. 
Hizmet, uygulama işlevselliği sağlayan yeniden kullanılabilir bir bileşendir.Hizmetler ConfigureServices 
kaydedilir ve bağımlılık ekleme (dı) veya ApplicationServicesaracılığıyla uygulama genelinde tüketilebilir. 

• Uygulamanın istek işleme ardışık düzenini oluşturmak için bir Configure yöntemi içerir. 

ConfigureServices ve Configure uygulama başlatıldığında AS P.N ET Core çalışma zamanı tarafından 
çağrılır: 

public class Startup 
{ 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRazorPages(); 

} 

public void Configure(IApplicationBuilder app, IWebHostEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 

app.UseRouting(); 

app.UseAuthorization(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapRazorPages(); 

}); 

} 

} 












Yukarıdaki örnek Razor Pagesiçindir; MVC sürümü benzerdir. 


public class Startup 

{ 

// Use this method to add Services to the Container, 
public void ConfigureServices(IServiceCollection Services) 
{ 

} 

// Use this method to configure the HTTP request pipetine, 
public void Configure(IApplicationBuilder app) 

{ 

} 

} 


startup sınıfı, uygulamanın ana bilgisayarı yapılandırıldığında belirtilir, startup sınıfı genellikle konak 
Oluşturucu 'da Webhostbuilderextensions. UseStartup<tstartup > yöntemi çağırarak belirtilir: 


public class Program 

{ 

public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build() .Run(); 

} 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 
WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup >(); 

} 


public class Program 

{ 

public static void Main(string[] args) 

{ 

CreateHostBuilder(args).Build().Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 

} 

Ana bilgisayar startup sınıfı Oluşturucusu tarafından kullanılabilen hizmetleri sağlar. Uygulama 
configureServices aracılığıyla ek hizmetler ekler. Hem konak hem de uygulama hizmetleri configure ve 
uygulama genelinde kullanılabilir. 


Genel ana bilgisayar (IHostBuilder) kullanılırken startup oluşturucusuna yalnızca aşağıdaki hizmet türleri 
eklenebilir: 


• IVVebHostEnvironment 

• IHostEnvironment 

• IConfiguration 







public class Startup 
{ 

private readonly IWebHostEnvironment _env; 

public Startup(IConfiguration configuration, IWebHostEnvironment env) 

{ 

Configuration = configuration; 

_env = env; 

> 

public IConfiguration Configuration { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

if (_env.IsDevelopment()) 

{ 

} 

else 

{ 

} 

} 

} 

configure yöntemi çağrılana kadar çoğu hizmet kullanılamaz. 

Ana bilgisayar startup sınıfı Oluşturucusu tarafından kullanılabilen hizmetleri sağlar. Uygulama 
configureServices aracılığıyla ek hizmetler ekler. Hem konak hem de uygulama hizmetleri configure ve 
uygulama genelinde kullanılabilir. 

startup sınıfa bağımlılık ekleme ’nin yaygın bir kullanımı, şu ekleme işlemini kullanmaktır: 

• Hizmetleri ortama göre yapılandırmak için IHostingEnvironment. 

• yapılandırmayı okumak için IConfiguration. 

• startup.ConfigureServices bir günlükçü oluşturmak için ILoggerFactory. 






public class Startup 
{ 

private readonly IHostingEnvironment _env; 
private readonly IConfiguration _config; 
private readonly ILoggerFactory _loggerFactory; 

public Startup(IHostingEnvironment env, IConfiguration config, 

ILoggerFactory loggerFactory) 

{ 

_env = env; 

_config = config; 

_loggerFactory = loggerFactory; 

} 

public void ConfigureServices(IServiceCollection Services) 

{ 

var logger = _loggerFactory.CreateLogger<Startup>(); 

if (_env.IsDevelopment()) 

{ 

// Development service configuration 

logger.LogInformation("Development environment"); 

} 

else 

{ 

// Non-development service configuration 

logger.LogInformation("Environment: {EnvironmentName}", _env.EnvironmentName); 

} 

// Configuration is available during startup. 

// Examples: 

// _config["key"] 

// _config["subsection:suboptionl"] 

} 

} 

configure yöntemi çağrılana kadar çoğu hizmet kullanılamaz. 

Çoklu başlangıç 

Uygulama farklı ortamlarda ayrı startup sınıfları tanımladığında (örneğin, startupDevelopment ), çalışma 
zamanında uygun startup sınıfı seçilidir. Geçerli ortamla eşleşen ad sonekine sahip olan sınıf 
önceliklendirilir. Uygulama geliştirme ortamında çalıştırıcıysanız ve hem bir startup sınıfını hem de bir 
startupDevelopment sınıfını içeriyorsa startupDevelopment sınıfı kullanılır. Daha fazla bilgi için bkz. birden çok 
ortam kullanma. 

Konak hakkında daha fazla bilgi için konağa bakın. Başlatma sırasında hataları işleme hakkında daha fazla 
bilgi için bkz. Başlangıç özel durum işleme. 

ConfigureServices yöntemi 

ConfigureServices yöntemi: 

• isteğe bağlı. 

• Uygulamanın hizmetlerini yapılandırmak için configure yönteminden önce ana bilgisayar tarafından 
çağırılır. 

• Yapılandırma seçeneklerinin kurala göre ayarlandığı yer. 

Konak startup Yöntemler çağrılmadan önce bazı hizmetleri yapılandırabilir.Daha fazla bilgi için bkz. ana 

bilgisayar. 










Önemli kurulum gerektiren özellikler için IServiceCollection Add{Service} uzantı yöntemleri vardır. Örneğin, 
DbContext ekleyin , defaultıdentity ekleyin, entityframevvorkmağazalarını ekleyin veRazorPages 

ekleyin: 

public class Startup 

{ 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 

Services.AddDefaultIdentity<IdentityUser>( 

options => options.SignIn.RequireConfirmedAccount = true) 

.AddEntityFrameworkStores<ApplicationDbContext>(); 

Services.AddRazorPages(); 

} 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 

Services.AddDefaultIdentity<IdentityUser>() 

.AddDefaultUI(UIFramework.Bootstrap4) 

.AddEntityFrameworkStores<ApplicationDbContext>(); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

// Add application Services. 

Services.AddTransientcIEmailSender, AuthMessageSender>(); 

Services.AddTransientcISmsSender, AuthMessageSender>(); 

} 

Hizmet kapsayıcısına hizmetleri eklemek, uygulama içinde ve configure yönteminde kullanılabilir hale 
getirir. Hizmetler, bağımlılık ekleme veya ApplicationServicesüzerinden çözümlenir. 

Setcompatibiütyversion hakkında daha fazla bilgi için bkz. Setcompatibilityversion . 

Configure yöntemi 

Configure yöntemi, uygulamanın HTTP isteklerine nasıl yanıt verdiğini belirtmek için kullanılır, istek ardışık 
düzeni, bir lApplicationBuilder örneğine Ara yazılım bileşenleri eklenerek yapılandırılır. iAppiicationBuiider 
configure yöntemi tarafından kullanılabilir, ancak hizmet kapsayıcısında kayıtlı değildir. Barındırma bir 
lApplicationBuilder oluşturur ve doğrudan configure geçirir. 

AS P.N ET Core şablonlar işlem hattını desteğiyle birlikte yapılandırır: 

• Geliştirici özel durum sayfası 

• Özel durum işleyicisi 

• HTTP katı taşıma güvenliği (HSTS) 







• HTTPS yönlendirmesi 

• Statik dosyalar 

• ASP.NET Core MVC ve Razor Pages 

• Genel Veri Koruma Yönetmeliği (GDPR) 


public class Startup 

{ 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRazorPages(); 

} 

public void Configure(IApplicationBuilder app, IWebHostEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 

app.UseRouting(); 

app.UseAuthorization(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapRazorPages(); 

})J 

} 

} 

Yukarıdaki örnek Razor Pagesiçindir; MVC sürümü benzerdir. 



public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error")t 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 
app.UseCookiePollcy(); 

app.UseMvc(); 

} 

Her use uzantısı yöntemi, istek ardışık düzenine bir veya daha fazla ara yazılım bileşeni ekler. Örneğin, 
UseStaticFiles, ara yazılımı statik dosyalarısunacak şekilde yapılandırır. 

İstek ardışık düzeninde bulunan her bir ara yazılım bileşeni, uygun olduğunda, zincirdeki bir sonraki bileşeni 
çağırmaktan veya zincirde kısa bir süre sonra sağlanmasından sorumludur. 

ıwebHostEnvinonment , iLoggerFactory veya configureServices tanımlı herhangi bir şey gibi ek hizmetler 
configure yöntemi imzasında belirtilebilir. Bu hizmetler varsa eklenir. 

IHostingEnvironment ve iLoggerFactory gibi ek hizmetler veya ConfigureServices tanımlı herhangi bir şey 
configure yöntemi imzasında belirtilebilir. Bu hizmetler varsa eklenir. 

iAppiicationBuiider kullanımı ve ara yazılım işleme sırası hakkında daha fazla bilgi için bkz. ASP.NET Core 
ara yazılımı. 

Hizmetleri başlatmadan yapılandırma 

startup sınıf kullanmadan Hizmetleri ve istek işleme işlem hattını yapılandırmak için, ConfigureServices 
çağırın ve konak Oluşturucu üzerinde configure kullanışlı yöntemler kullanın. ConfigureServices birden 
çok çağrısı birbirine eklenir. Birden çok configure yöntemi varsa, son configure çağrısı kullanılır. 














public class Program 

{ 

public static void Main(string[] args) 

{ 

CreateHostBuilder(args).Build().Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureAppConfiguration((hostingContextj config) => 

{ 

}) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.ConfigureServices(Services => 

{ 

Services. AddCont rollerstdit hviews(); 

}) 

.Configure(app => 

{ 

var loggerFactory = app.ApplicationServices 
.GetRequiredService<ILoggerFactory>(); 
var logger = loggerFactory.CreateLogger<Program>(); 

var env = app.ApplicationServices.GetRequiredService<IWebHostEnvironment>(); 
var config = app.ApplicationServices.GetRequiredService<IConfiguration>(); 

logger.LogInformation("Logged in Configure"); 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Home/Error"); 
app.UseHsts(); 

} 

var configValue = config["MyConfigKey "]; 

}); 

}); 

}); 

} 



public class Program 
{ 

public static IHostingEnvironment HostingEnvironment { get; set; } 
public static IConfiguration Configuration { get; set; } 

public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build().Run(); 

} 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.ConfigureAppConfiguration((hostingContextj config) => 

{ 

}) 

.ConfigureServices(services => 

{ 

}) 

.Configure(app => 

{ 

var loggerFactory = app.ApplicationServices 
.GetRequiredService<ILoggerFactory>(); 
var logger = loggerFactory.CreateLogger<Program>(); 

var env = app.ApplicationServices.GetRequiredService<IHostingEnvironment>(); 
var config = app.ApplicationServices.GetRequiredService<IConfiguration>(); 

logger.LogInformation("Logged in Configure"); 

if (env.IsDevelopment()) 

{ 

} 

else 

{ 

} 

var configValue = config["subsection:suboptionl"]; 


}); 


Başlangıç filtreleriyle başlatmayı Genişlet 

I StartupF i Iterku İlanın: 

• Ara yazılımı, bir uygulamanın başlangıcında veya sonunda use{Middieware} açık bir çağrı olmadan Ara 
yazılım ardışık düzeni yapılandırma. ıstartupFilter , ASP.NET Core tarafından, uygulama yazarının 
varsayılan ara yazılımı açıkça kaydetmesini sağlamak zorunda kalmadan, işlem hattının başlangıcına 
varsayılanlar eklemek için kullanılır. ıstartupFilter , uygulama yazarı adına farklı bir bileşen çağrısının 

Use{Middleware} izin verir. 

• Configure yöntemlerinin bir işlem hattı oluşturmak için. Itartupfilter. configure , bir ara yazılımı 
kitaplıklar tarafından eklenen bir veya daha sonra çalışacak şekilde ayarlayabilir. 

ıstartupFilter , Action<iAppiicationBuiider> alan ve döndüren Configureuygular. IApplicationBuilder, bir 

uygulamanın istek işlem hattını yapılandırmak için bir sınıfı tanımlar. Daha fazla bilgi için bkz. 

I Appl ication B uilder ile bir ara yazılım işlem hattı oluşturma. 

Her ıstartupFilter , istek ardışık düzeninde bir veya daha fazla middlevvares ekleyebilir. Filtreler, hizmet 

kapsayıcısına eklendikleri sırada çağrılır. Filtreler bir sonraki filtreye denetimi geçirmeden önce veya sonra 







bir ara yazılım ekleyebilir, böylece uygulama işlem hattının başına veya sonuna eklenir. 


Aşağıdaki örnek, ıstartupFilter bir ara yazılımı nasıl kaydedeceğinizi gösterir. RequestsetoptionsMiddieware 
ara yazılım bir sorgu dizesi parametresinden bir seçenek değeri ayarlar: 

public class RequestSetOptionsMiddleware 

{ 

private readonly RequestDelegate _next; 

public RequestSetOptionsMiddleware( RequestDelegate next ) 

{ 

_next = next; 

} 

// Test with https://localhost:5001/Privacy/?option=Hello 
public async Task Invoke(HttpContext httpContext) 

{ 

var option = httpContext.Request.Query["option"]j 

if (Istring.IsNullOrWhiteSpace(option)) 

{ 

httpContext.Items["option"] = WebUtility.HtmlEncode(option); 

} 

await _next(httpContext); 

} 

} 

RequestSetOptionsMiddleware RequestSetOptionsStartupFilter sınıfında yapılandırılır: 

public class RequestSetOptionsStartupFilter : IstartupFilter 

{ 

public Action<IApplicationBuilder> Configure(Action<IApplicationBuilder> next) 

{ 

return builder => 

{ 

builder.UseMiddleware<RequestSetOptionsMiddleware>(); 
next(builder); 

}; 

} 

} 




public class RequestSetOptionsMiddleware 

{ 

private readonly RequestDelegate _next; 
private IOptions<AppOptions> _injectedOptions; 

public RequestSetOptionsMiddleware( 

RequestDelegate next, IOptions<AppOptions> injectedOptions) 

{ 

_next = next; 

_injectedOptions = injectedOptions; 

} 

public async Task Invoke(HttpContext httpContext) 

{ 

Console. Writel_ine( "RequestSetOptionsMiddleware.Invoke"); 

var option = httpContext.Request.Query["option"]; 

if (!string.IsNullOrWhiteSpace(option)) 

{ 

_injectedOptions.Value.Option = WebUtility.HtmlEncode(option); 

} 

await _next(httpContext); 

} 

} 

RequestSetOptionsMiddleware RequestSetOptionsStartupFilter sınıfında yapılandırılır: 

public class RequestSetOptionsStartupFilter : IStartupFilter 

{ 

public Action<IApplicationBuilder> Configure(Action<IApplicationBuilder> next) 

{ 

return builder => 

{ 

builder.UseMiddleware<RequestSetOptionsMiddleware>(); 
next(builder); 

}; 

} 

} 

IStartupFilter , ConfigureServiceshizmet kapsayıcısına kaydedilir. 


public class Program 
{ 

public static void Main(string[] args) 

{ 

CreateHostBuilder(args).Build().Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 
Hoşt.CreateDefaultBuilder(args) 

.ConfigureAppConfiguration((hostingContext i config) => 

{ 

}) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}) 

.ConfigureServices(services => 

{ 

Services.AddTransient<IStartupFilter, 

RequestSetOptionsStartupFilter>(); 

}); 

} 


WebHost.CreateDefaultBuilder(args) 

.ConfigureServices(services = > 

{ 

Services.AddTransient<IStartupFilter, 

RequestSetOptionsStartupFilter>(); 

}) 

.UseStartup<Startup>() 

.Build(); 

option için bir sorgu dizesi parametresi sağlandığında, ASP.NET Core ara yazılımı yanıtı oluşturmadan 
önce, ara yazılım değer atamasını işler. 

Ara yazılım yürütme sırası ıstartupFilter kayıt sırasıyla ayarlanır: 

• Birden çok ıstartupFilter uygulaması aynı nesnelerle etkileşime geçebilir. Sıralama önemliyse, 
kendi ıstartupFilter hizmet kayıtlarını, middlevvares çalıştırmaları sırasıyla eşleşecek şekilde 
sıralayın. 

• Kitaplıklar, ıstartupFilter kayıtlı olan diğer uygulama ara yazılımı ile önce veya sonra çalışan bir 
veya daha fazla ıstartupFilter uygulaması olan ara yazılım ekleyebilir. Bir ıstartupFilter ara 
yazılım bir kitaplık ıstartupFilter tarafından eklenmeden önce çağırmak için: 

o Kitaplık hizmet kapsayıcısına eklenmeden önce hizmet kaydını konumlandırın, 
o Daha sonra çağırmak için, kitaplık eklendikten sonra hizmet kaydını konumlandırın. 

Başlangıçta bir dış derlemeden yapılandırma Ekle 

IHostingStartup bir uygulama, uygulamanın startup sınıfının dışında bir dış derlemeden başlangıçta bir 
uygulamaya iyileştirmeler eklenmesine izin verir. Daha fazla bilgi için bkz. ASP.NET Core barındırma 
başlangıç derlemeleri kullanma. 

Ek kaynaklar 

• Ana bilgisayar 

• ASP.NET Core çoklu ortamları kullanma 










• ASP.NET Core ara yazılımı 

• .N ET Core ve AS P.N ET Core oturum açma 

• ASP.NET Core yapılandırma 


ASPNET Core bağımlılık 
ekleme 

24.11.2019 • 29 minutes to read ı Edit Online 


Steve Smith, Scott Adeve Luke Latham tarafından 

ASP.NET Core, sınıflar ve bunların bağımlılıkları arasında 
denetimin INVERSION (loC) elde etmek için bir teknik olan 
bağımlılık ekleme (dı) yazılım tasarım modelini destekler. 

MVC denetleyicileri içindeki bağımlılık eklenmesine özgü daha 
fazla bilgi için bkz. ASP.NET core'da denetleyicilere bağımlılık 
ekleme. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Bağımlılık eklenmesine genel bakış 

Bağımlılık, başka bir nesnenin gerektirdiği herhangi bir 
nesnedir. Aşağıdaki MyDependency sınıfını bir uygulamadaki 
diğer sınıfların bağlı olduğu bir uriteMessage yöntemiyle 
inceleyin: 

public class MyDependency 
{ 

public MyDependency() 

{ 

} 

public Task WriteMessage(string message) 

{ 

Console.WriteLine( 

$"MyOependency.UriteMessage called. Message: 

{message}"); 

return Task.FromResult(0); 

} 

} 

uriteMessage yöntemini bir sınıf için kullanılabilir hale 
getirmek için MyDependency sınıfının bir örneği oluşturulabilir. 
MyDependency sınıfı, indexModei sınıfının bir bağımlılığı olur: 

public class IndexModel : PageModel 
{ 

MyDependency _dependency = new MyDependency(); 

public async Task OnGetAsync() 

{ 

await _dependency.WriteMessage( 

"IndexModel.OnGetAsync created this message."); 

} 

} 







Sınıf oluşturur ve doğrudan MyDependency örneğine bağlıdır. 

Kod bağımlılıkları (önceki örnekte olduğu gibi) sorunlu olur ve 

aşağıdaki nedenlerden dolayı kaçınılması gerekir: 

• MyDependency farklı bir uygulamayla değiştirmek için, sınıfın 
değiştirilmesi gerekir. 

• MyDependency bağımlılıklar içeriyorsa, sınıfı tarafından 
yapılandırılması gerekir. MyDependency bağlı olarak, birden 
çok sınıfa sahip büyük bir projede yapılandırma kodu 
uygulama genelinde dağılmış hale gelir. 

• Bu uygulamanın birim testi zordur. Uygulama, bu yaklaşımla 
mümkün olmayan bir sahte veya saplama MyDependency 
sınıfı kullanmalıdır. 

Bağımlılık ekleme bu sorunları şu şekilde giderir: 

• Bağımlılık uygulamasını soyutlamak için bir arabirim veya 
temel sınıf kullanımı. 

• Bir hizmet kapsayıcısına bağımlılığın kaydı. ASP.NET Core 
yerleşik bir hizmet kapsayıcısı sağlar IServiceProvider. 
Hizmetler, uygulamanın startup.configureServices 
yöntemine kaydedilir. 

• Hizmetin kullanıldığı sınıf oluşturucusuna ekleme . Çerçeve, 
bağımlılığın bir örneğini oluşturma ve artık gerekli 
olmadığında bu uygulamayı atma sorumluluğunu alır. 

Örnek uygulamada, iMyDependency arabirimi hizmetin 

uygulamaya sağladığı bir yöntemi tanımlar: 

public interface IMyDependency 
{ 

Task WriteMessage(string message); 

} 


public interface IMyDependency 
{ 

Task WriteMessage(string message); 

} 

Bu arabirim somut bir tür tarafından uygulanır, MyDependency : 










public class MyDependency : IMyDependency 

{ 

private readonly ILogger<MyDependency> _logger; 

public MyDependency(ILogger<MyDependency> logger) 

{ 

_logger = logger; 

} 

public Task WriteMessage(string message) 

{ 

_logger.LogInformation( 

"MyDependency .l/JriteMessage called. Message: 

{MESSAGE}", 

message); 

return Task.FromResult(0); 

} 

} 


public class MyDependency : IMyDependency 

{ 

private readonly ILogger<MyDependency> _logger; 

public MyDependency(ILogger<MyOependency> logger) 

{ 

_logger = logger; 

} 

public Task WriteMessage(string message) 

{ 

_logger.LogInformation( 

"MyDependency.WriteMessage called. Message: 

{Message}", 

message); 

return Task.FromResult(0); 

} 

} 

MyDependency kurucusunda bir ILogger<TCategoryName> 
ister. Bağımlılık ekleme işlemini zincirleme bir biçimde 
kullanmak olağan dışı değildir. Her istenen bağımlılık, kendi 
bağımlılıklarını ister. Kapsayıcı grafikteki bağımlılıkları çözer ve 
tamamen çözümlenen hizmeti döndürür. Çözümlenmesi 
gereken, genellikle bağımlılık ağacı, bağımlılık grafiğiveya 
nesne grafiğ /olarak adlandırılan toplu bağımlılıklar kümesi. 

IMyDependency ve ILogger<TCategoryName> , hizmet 
kapsayıcısında kayıtlı olmalıdır. IMyDependency 
Startup.ConfigureServices kaydedilir. ILogger<TCategoryName> , 
günlük soyut öğeler altyapısı tarafından kaydedilir, bu nedenle, 
Framevvork tarafından varsayılan olarak kaydedilen Framevvork 
tarafından sağlanmış bir hizmettir. 

Kapsayıcı, (genel) açık türlerdenyararlanarak 
iLogger<TCategoryName> çözer, her (genel) oluşturulan 
türükaydetme ihtiyacını ortadan kaldırır: 








Services. AddSingleton(typeof (II_ogger<T>), 
typeof(Logger<T>)); 

Örnek uygulamada iMyDependency hizmeti somut tür 
MyDependency kaydedilir. Kayıt, hizmet ömrünü tek bir isteğin 
kullanım ömrüne göre kapsamlar. Hizmet yaşam süreleri bu 
konunun ilerleyen kısımlarında açıklanmıştır. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRazorPages(); 

Services.AddScoped<IMyDependency, MyDependency>(); 
Services.AddTransientcIOperationTransientj Operation>(); 
Services.AddScopedcIOperationScopedj Operation>(); 
Services.AddSingletoncIOperationSingletonj Operation>(); 
Services.AddSingleton<IOperationSingletonInstance>(new 
Operation(Guid.Empty)); 

// OperationService depends on each of the other 
Operation types. 

Services.AddTransientcOperationService, 

OperationService» Q; 

} 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersi 
on.Version_2_2); 

Services.AddScoped<IMyDependency, MyDependency>(); 
Services.AddTransient<IOperationTransient, Operation>(); 
Services.AddScoped<IOperationScopedj Operation>(); 
Services.AddSingletoncIOperationSingletonj Operation>(); 
Services.AddSingleton<IOperationSingletonInstance>(new 
Operation(Guid.Empty)); 

// OperationService depends on each of the other 
Operation types. 

Services.AddTransient<OperationService, 
OperationService>(); 

} 


NOTE 

Her Services. Add{SERViCE_NAME) uzantısı yöntemi Hizmetleri 
ekler (ve potansiyel olarak yapılandırır). Örneğin 
Services. AddMvc() , Razor Pages ve MVC 'nin gerektirdiği 
Hizmetleri ekler. Uygulamaların bu kuralı izlemesini öneririz. Hizmet 
kaydı gruplarını kapsüllemek için uzantı yöntemlerini Microsoft. 
Extensions. Dependencyınjection ad alanına yerleştirin. 


Hizmetin Oluşturucusu string gibi yerleşik bir 
türgerektiriyorsa, tür yapılandırma veya Seçenekler 
düzeniyleeklenebilir: 








public class MyDependency : IMyDependency 

{ 

public MyDependency(IConfiguration config) 

{ 

var myStringValue = config["MyStringKey"]; 
// Use myStringValue 

} 


} 

Hizmetin bir örneği, hizmetin kullanıldığı ve özel bir alana 
atandığı bir sınıfın Oluşturucusu aracılığıyla istenir. Alanı, 
sınıfına gereken şekilde hizmete erişmek için kullanılır. 

Örnek uygulamada, IMyDependency örneği istenir ve hizmetin 
uriteMessage yöntemini çağırmak için kullanılır: 

public class IndexModel : PageModel 

{ 

private readonly IMyDependency _myDependency; 

public IndexModel( 

IMyDependency myDependency, 

OperationService OperationService, 
IOperationTransient transientOperation, 
IOperationScoped ScopedOperation, 
IOperationSingleton singletonOperation, 
IOperationSingletonlnstance 
singletonlnstanceOperation) 

{ 

_myDependency = myDependency; 

OperationService = OperationService; 
TransientOperation = transientOperation; 
ScopedOperation = ScopedOperation; 
SingletonOperation = singletonOperation; 
SingletonlnstanceOperation = 
singletonlnstanceOperation; 

} 

public OperationService OperationService { get; } 
public IOperationTransient TransientOperation { get; } 
public IOperationScoped ScopedOperation { get; } 
public IOperationSingleton SingletonOperation { get; } 
public IOperationSingletonlnstance 
SingletonlnstanceOperation { get; } 

public async Task OnGetAsync() 

{ 

await _myDependency.WriteMessage( 

"IndexModel.OnGetAsync created this message.") 

} 




public class IndexModel : PageModel 

{ 

private readonly IMyDependency _myDependency; 

public IndexModel( 

IMyDependency rnyDependency, 

OperationService OperationService, 
IOpenationTransient transientOperation, 
IOpenationScoped ScopedOperation, 
IOpenationSingleton SingletonOperation, 
IOpenationSingletonlnstance 
singletonlnstanceOperation) 

{ 

_myDependency = myDependency; 

OperationService = OperationService; 
TransientOperation = transientOperation; 
ScopedOperation = ScopedOperation; 
SingletonOperation = singletonOperationj 
SingletonlnstanceOperation = 
singletonlnstanceOperation; 

} 

public OperationService OperationService { get; } 
public IOperationTransient TransientOperation { get; } 
public IOperationScoped ScopedOperation { get; } 
public IOperationSingleton SingletonOperation { get; } 
public IOperationSingletonlnstance 
SingletonlnstanceOperation { get; } 

public async Task OnGetAsync() 

{ 

await _myDependency.WriteMessage( 

"IndexModel.OnGetAsync created this message."); 

} 

} 


Başlangıca eklenen hizmetler 

Genel ana bilgisayar (IHostBuilder) kullanılırken startup 
oluşturucusuna yalnızca aşağıdaki hizmet türleri eklenebilir: 

• IklebHostEnvironment 

• IHostEnvironment 

• IConfiguration 

Hizmetler startup.configure eklenebilir: 

public void Configure(IApplicationBuilder app, 
IOptions<MyOptions> options) 

{ 

} 

Daha fazla bilgi için bkz. ASP.NET Core 'de uygulama 
başlatma. 

Framevvork tarafından sunulan hizmetler 

startup.configureServices yöntemi, uygulamanın kullandığı 
hizmetlerin (Entity Framevvork Core ve ASP.NET Core MVC 








gibi platform özellikleri de dahil) tanımlanmasından 
sorumludur. Başlangıçta, configureServices için belirtilen 
iserviceCollection konağın nasıl yapılandırıldığınabağlı olarak 
Framework tarafından tanımlanan hizmetlere sahiptir. Çerçeve 
tarafından kaydedilmiş yüzlerce hizmete sahip olmak ASP.NET 
Core şablona dayalı bir uygulama için sık görülen bir 
durumdur. Aşağıdaki tabloda çerçeve kayıtlı hizmetlerden 
oluşan küçük bir örnek listelenmiştir. 


HİZMET TÜRÜ 

ÖMÜR 

Microsoft.AspNetCore.Hosting.B 

uilder.lApplicationBuilderFactory 

Geçici 

IHostApplicationLifetime 

Adet 

IWebHostEnvir'onment 

Adet 

Microsoft.AspNetCore.Hosting.IS 

tartup 

Adet 

Microsoft.AspNetCore.Hosting.IS 

tartupFilter 

Geçici 

Microsoft.AspNetCore.Hosting.se 

rver.lServer 

Adet 

Microsoft.AspNetCore.Http.lHttp 

ContextFactory 

Geçici 

Microsoft.Extensions.Logging.ILo 

gger<TCategoryName> 

Adet 

Microsoft.Extensions.Logging.ILo 

ggerFactory 

Adet 

Microsoft.Extensions.ObjectPool. 

ObjectPoolProvider 

Adet 

Microsoft.Extensions.Options.ICo 

nfigureOptions<TOptions> 

Geçici 

Microsoft.Extensions.Options.IOp 

tions<TOptions> 

Adet 

System.Diagnostics.DiagnosticSo 

urce 

Adet 

System.Diagnostics.DiagnosticLis 

tener 

Adet 






HİZMET TÜRÜ 

ÖMÜR 

Microsoft.AspNetCore.Hosting.B 

uilder.lApplicationBuilderFactory 

Geçici 

Microsoft.AspNetCore.Hosting.IA 

pplicationLifetime 

Adet 

Microsoft.AspNetCore.Hosting.IH 

ostingEnvironment 

Adet 

Microsoft.AspNetCore.Hosting.IS 

tartup 

Adet 

Microsoft.AspNetCore.Hosting.IS 

tartupFilter 

Geçici 

Microsoft.AspNetCore.Flosting.Se 

rver.lServer 

Adet 

Microsoft.AspNetCore.FIttp.lFittp 

ContextFactory 

Geçici 

Microsoft.Extensions.Logging.ILo 

gger<TCategoryName> 

Adet 

Microsoft.Extensions.Logging.ILo 

ggerFactory 

Adet 

Microsoft.Extensions.ObjectPool. 

ObjectPoolProvider 

Adet 

Microsoft.Extensions.Options.ICo 

nfigureOptions<TOptions> 

Geçici 

Microsoft.Extensions.Options.IOp 

tions<TOptions> 

Adet 

System.Diagnostics.DiagnosticSo 

urce 

Adet 


System.Diagnostics.DiagnosticLis Adet 

tener 


Uzantı yöntemleriyle ek hizmetleri 
kaydetme 

Bir hizmet koleksiyonu genişletme yöntemi (ve gerekirse 
bağımlı hizmetleri) kaydetmek için kullanılabilir olduğunda, bu 
hizmet için gereken tüm hizmetleri kaydetmek üzere tek bir 
Add{SERViCE_NAME} uzantısı yöntemi kullanmaktır. Aşağıdaki 
kod, Adddbcontext<tcontext > ve AddldentityCoreuzantı 
yöntemlerini kullanarak kapsayıcıya ek hizmetler eklemenin bir 
örneğidir. 



public void ConfiguneServices(IServiceCollection Services) 

{ 

Services.AddDbContext<ApplicationDbContext>(options => 

options.UseSqlServer(Configuration.GetConnectionString("Defa 
ultConnection"))); 

Services.AddIdentity<ApplicationUser, IdentityRole>() 

.AddEntityFrameworkStores<ApplicationDbContext>() 

.AddDefaultTokenProviders(); 

} 

Daha fazla bilgi için API belgelerindeki ServiceCoilection 
sınıfına bakın. 

Hizmet yaşam süreleri 

Kayıtlı her hizmet için uygun bir yaşam süresi seçin. ASP.NET 
Core hizmetler aşağıdaki yaşam süreleri ile yapılandırılabilir: 

Geçici 

Geçici ömür Hizmetleri (AddTransient), hizmet kapsayıcısından 
her istenilişinde oluşturulur. Bu ömür, hafif ve durumsuz 
hizmetler için en iyi şekilde kullanılır. 

Yayıl 

Kapsamlı ömür Hizmetleri (AddScoped), istemci isteği başına 
bir kez oluşturulur (bağlantı). 


VVARNING 

Bir ara yazılım içinde kapsamlı bir hizmet kullanırken, hizmeti 
invoke veya invokeAsync yöntemine ekleyin. Oluşturucu 
ekleme yoluyla ekleme, hizmeti tek bir gibi davranmaya zoryor. 
Daha fazla bilgi için bkz. Özel ASP.NET Core ara yazılımı yaz. 


Adet 

Tek yaşam süresi Hizmetleri (AddSingleton), ilk istendiğinde 
oluşturulur (veya startup.configureservices çalıştırıldığında ve 
hizmet kaydıyla bir örnek belirtildiğinde). Her sonraki istek aynı 
örneği kullanır. Uygulama tek davranış gerektiriyorsa, hizmet 
kapsayıcısının hizmetin ömrünü yönetmesine izin verilmesi 
önerilir. Tekil tasarım modelini uygulamayın ve nesnenin 
sınıfındaki ömrünü yönetmek için Kullanıcı kodu sağlayın. 


VVARNING 

Kapsamlı bir hizmetin tek bir bilgisayardan çözümlenmesi 
tehlikelidir. Bu, sonraki istekleri işlerken hizmetin yanlış duruma 
gelmesine neden olabilir. 









Hizmet kayıt yöntemleri 

Hizmet kayıt uzantısı yöntemleri, belirli senaryolarda yararlı 
olan aşırı yüklemeler sunar. 


YÖNTEM 


OTOMATİK BİRDEN ÇOK GEÇİŞ 

OBJECT UYGULAMALA BAĞIMSIZ 

ELDEN R DEĞİŞKENLERİ 


Add{LiFETiME} Evet Evet Hayır 

<{SERVICE}, 

{IMPLEMENTATION}> 

O 

Örnek: 

Services.AddSingletoncIMyDep, 

MyDep>(); 


Add{LIFETIME} Evet Evet Evet 

<{SERVICE}>(sp => 

new 

{IMPLEMENTATION}) 

Örnekler: 

Services.AddSingleton<IMyDep> 

(sp => new MyDepO); 

Services.AddSingleton<IMyDep> 

(sp => new MyDep("A 
string!")); 


Add{LiFETiME} Evet Hayır Hayır 

<{IMPLEMENTATION}> 

O 

Örnek: 

Services.AddSingleton<MyDep> 

O; 


Addsingleton<{SEN^yüF}> Evet Evet 

(new {IMPLEMENTATION}) 

Örnekler: 

Services.AddSingleton<IMyDep> 

(new MyDepO); 

Services.AddSingleton<IMyDep> 

(new MyDep("A string!")); 


Addsingleton(newHayır Hayır Evet 

{IMPLEMENTATION}) 

Örnekler: 

Services.AddSingleton(new 
MyDep()); 

Services.AddSingleton(new 
MyDep("A string!")); 


Tür çıkarma hakkında daha fazla bilgi için Hizmetler 'İn aktiften 
çıkarılması bölümüne bakın. Birden çok uygulama için yaygın 
bir senaryo, test için bir sahte işlem türüdür. 

T ryAdd{ lif etime} Yöntemler, zaten kayıtlı bir uygulama yoksa 
hizmeti kaydeder. 

Aşağıdaki örnekte, ilk satır IMyDependency için MyDependency 
kaydettirir. IMyDependency zaten kayıtlı bir uygulamaya sahip 
olduğundan ikinci satır etkisizdir: 












Services.AddSingletoncIMyDependency, MyDependency>(); 

// The following üne has no effect: 

Services.TryAddSingletoncIMyDependency, DifferentDependency> 

O; 

Daha fazla bilgi için bkz. 

• TryAdd 

• TryAddTransient 

• TryAddScoped 

• TryAddSingleton 

TryAddEnumerable (ServiceDescriptor) yöntemleri yalnızca 
aynı türde bir uygulama yoksa hizmeti kaydeder. Birden çok 
hizmet iEnumerabie<{SERvıCE}> ile çözümlenir. Hizmetleri 
kaydederken, geliştirici yalnızca aynı türden biri zaten 
eklenmediyse bir örnek eklemek istemektedir. Genellikle, bu 
yöntem, kapsayıcıda bir örneğin iki kopyasını kaydetmemek 
için kitaplık yazarları tarafından kullanılır. 

Aşağıdaki örnekte, ilk satır IMyDepl için MyDep kaydettirir, ikinci 
satır, IMyDep2 için MyDep kaydeder. IMyDepl MyDep kayıtlı bir 
uygulamasına zaten sahip olduğundan, üçüncü satırın etkisi 
yoktur: 

public interface IMyDepl {} 
public interface IMyDep2 {} 

public class MyDep : IMyDepl, IMyDep2 {} 

Services.TryAddEnumerable(ServiceDescriptor.SingletoncIMyDep 

1 , MyDep>()); 

Services.TryAddEnumerable(ServiceDescriptor.SingletoncIMyDep 

2 , MyDep>()); 

// Two registrations of MyDep for IMyDepl is avoided by the 
following line: 

Services.TryAddEnumerable(ServiceDescriptor.SingletoncIMyDep 
1 , MyDep>()); 

Oluşturucu Ekleme davranışı 

Hizmetler, iki mekanizma tarafından çözülebilir: 

• IServiceProvider 

• ActivatorUtilities -, bağımlılık ekleme kapsayıcısına hizmet 
kaydı olmadan nesne oluşturulmasına İzin verir. 
ActivatorUtilities etiket yardımcıları, MVC denetleyicileri 

ve model ciltler gibi kullanıcı tarafından ilgili soyutlamalar 
ile kullanılır. 

Oluşturucular bağımlılık ekleme tarafından sağlanmayan 
bağımsız değişkenleri kabul edebilir, ancak bağımsız 
değişkenlerin varsayılan değerleri ataması gerekir. 

Hizmetler IServiceProvider veya ActivatorUtilities 
tarafından çözümlendiğinde, Oluşturucu Ekleme ortak bir 
Oluşturucu gerektirir. 









Hizmetler Activatorutilities tarafından çözümlendiğinde, 
Oluşturucu ekleme yalnızca bir adet geçerli oluşturucunun var 
olmasını gerektirir. Oluşturucu aşırı yüklemeleri desteklenir, 
ancak bağımsız değişkenleri bağımlılık ekleme tarafından 
yerine yalnızca bir aşırı yükleme bulunabilir. 

Entity Framevvork bağlamları 

Entity Framework bağlamlar genellikle, Web uygulaması 
veritabanı işlemleri normalde istemci isteği kapsamında 
olduğundan kapsamlı ömür kullanılarak hizmet kapsayıcısına 
eklenir. Veritabanı bağlamı kaydedilirken bir 
Adddbcontext<tcontext > aşırı yüklemesi tarafından bir yaşam 
süresi belirtilmemişse varsayılan yaşam süresi kapsamındadır. 
Belirli bir yaşam süresinin Hizmetleri, hizmetten daha kısa bir 
yaşam süresine sahip bir veritabanı bağlamı kullanmamalıdır. 

Ömür ve kayıt seçenekleri 

Ömür ve kayıt seçenekleri arasındaki farkı göstermek için, 
görevleri benzersiz bir tanımlayıcıya sahip bir işlem olarak 
temsil eden aşağıdaki arayüzleri göz önünde bulundurun 
Operationid . Bir işlem hizmetinin yaşam süresinin aşağıdaki 
arabirimler için nasıl yapılandırıldığına bağlı olarak kapsayıcı, 
bir sınıf tarafından istendiğinde aynı ya da farklı bir hizmet 
örneği sağlar: 

public interface IOperation 
{ 

Guid Operationid { getj } 

} 

public interface IOperationTransient : IOperation 
{ 

} 

public interface IOperationScoped : IOperation 
{ 

} 

public interface IOperationSingleton : IOperation 
{ 

} 

public interface IOperationSingletonlnstance : IOperation 
{ 

} 




public interface IOperation 

{ 

Guid Operationld { get; } 

} 

public interface IOperationTransient : IOperation 

{ 

} 

public interface IOperationScoped : IOperation 

{ 

} 

public interface IOperationSingleton : IOperation 

{ 

} 

public interface IOperationSingletonlnstance : IOperation 

{ 

} 

Arabirimler Operation sınıfında uygulanır. Operation 
Oluşturucusu bir GUİD sağlanmamışsa bir GUİD oluşturur: 

public class Operation : IOperationTransient, 
IOperationScoped, 

IOperationSingleton, 

IOperationSingletonlnstance 

{ 

public Operation() : this(Guid.NewGuid()) 

{ 

} 

public Operation(Guid id) 

{ 

Operationld = id; 

} 

public Guid Operationld { get; private set; } 

} 


public class Operation : IOperationTransient, 
IOperationScoped, 

IOperationSingleton, 

IOperationSingletonlnstance 

{ 

public Operation() : this(Guid.NewGuid()) 

{ 

} 

public Operation(Guid id) 

{ 

Operationld = id; 

} 

public Guid Operationld { get; private set; } 

} 

Diğer Operation türlerinin her birine bağlı olan bir 

kaydedilir. Bağımlılık ekleme yoluyla 
istendiğinde, her bir hizmetin yeni bir 


OperationService 

OperationService 








örneğini ya da bağımlı hizmetin kullanım ömrü temelinde 
mevcut bir örneği alır. 

• Kapsayıcıda istendiğinde geçici hizmetler oluşturulduğunda, 

IOperationTransient hizmetinin Operationld 
OperationService''Operationld farklıdır. OperationService , 
IOperationTransient sınıfının yeni bir örneğini alır. Yeni 
örnek farklı bir Operationld verir. 

• istemci isteği başına kapsamlı hizmetler oluşturulduğunda, 

ıoperationScoped hizmetinin Operationld istemci isteği 
içindeki OperationService ile aynıdır, istemci istekleri 
arasında her iki hizmet de farklı bir Operationld değeri 
paylaşır. 

• Tek ve tek örnekli hizmetler bir kez oluşturulduğunda ve 
tüm istemci isteklerinde ve tüm hizmetlerde kullanıldığında, 

Operationld tüm hizmet istekleri arasında sabittir. 

public class OperationService 

{ 

public OperationService( 

IOperationTransient transientOperation, 
IOperationScoped scopedOperation, 
IOperationSingleton singletonOperation, 
IOperationSingletonlnstance instanceOperation) 

{ 

TransientOperation = transientOperation; 
ScopedOperation = scopedOperation; 
SingletonOperation = singletonOperation; 
SingletonlnstanceOperation = İnstanceOperation; 

} 

public IOperationTransient TransientOperation { get; } 
public ıoperationScoped ScopedOperation { get; } 
public IOperationSingleton SingletonOperation { get; } 
public IOperationSingletonlnstance 
SingletonlnstanceOperation { get; } 

} 


public class OperationService 

{ 

public OperationService( 

IOperationTransient transientOperation, 
ıoperationScoped scopedOperation, 
IOperationSingleton singletonOperation, 
IOperationSingletonlnstance instanceOperation) 

{ 

TransientOperation = transientOperation; 
ScopedOperation = scopedOperation; 
SingletonOperation = singletonOperation; 
SingletonlnstanceOperation = İnstanceOperation; 

} 

public IOperationTransient TransientOperation { get; } 
public ıoperationScoped ScopedOperation { get; } 
public IOperationSingleton SingletonOperation { get; } 
public IOperationSingletonlnstance 
SingletonlnstanceOperation { get; } 

} 


startup.configureServices , her tür kapsayıcıya, adlandırılmış 










ömrüne göre eklenir: 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRazorPages(); 

Services.AddScoped<IMyOependency, MyDependency>(); 

Services.AddTransientcIOperationTransient, Operation>(); 

Services.AddScoped<IOperationScopedj Operation>(); 

Services.AddSingleton<IOperationSingleton, Operation>(); 

Services.AddSingleton<IOperationSingletonInstance>(new 
Operation(Guid.Empty)); 

// OperationService depends on each of the other 
Operation types. 

Services.AddTransient<OperationService, 
OperationService>(); 

} 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersi 
on.Version_2_2); 

Services.AddScoped<IMyDependencyj MyDependency>(); 

Services.AddTransient<IOperationTransient J Operation>(); 

Services.AddScoped<IOperationScopedj Operation>(); 

Services.AddSingletoncIOperationSingletonj Operation>(); 

Services.AddSingleton<IOperationSingletonInstance>(new 
Operation(Guid.Empty)); 

// OperationService depends on each of the other 
Operation types. 

Services.AddTransient<OperationService, 

OperationService»(); 

} 

IOperationSingletonlnstance hizmeti, bilinen bir Guid.Empty 
KİMLİĞİYLE belirli bir örnek kullanıyor.Bu tür kullanımda 
olduğunda (GUİD 'sinin tümü sıfırlardan tamamen) Bu bir şey 
vardır. 

Örnek uygulama, bireysel istekler içindeki ve içindeki nesne 
yaşam sürelerini gösterir. Örnek uygulamanın indexModei her 
tür IOperation türü ve OperationService ister. Daha sonra 
sayfa, tüm sayfa modeli sınıfının ve hizmetin Operationid 
değerlerini özellik atamaları aracılığıyla görüntüler: 









public class IndexModel : PageModel 

{ 

private readonly IMyDependency _myDependency; 

public IndexModel( 

IMyDependency myDependency, 

OperationService OperationService, 
IOpenationTransient transientOperation, 
IOpenationScoped ScopedOperation, 
IOpenationSingleton SingletonOperation, 
IOpenationSingletonlnstance 
singletonlnstanceOperation) 

{ 

_myDependency = myDependency; 

OperationService = OperationService; 
TransientOperation = transientOperationj 
ScopedOperation = scopedOperation; 
SingletonOperation = singletonOperationj 
SingletonlnstanceOperation = 
singletonlnstanceOperation; 

} 

public OperationService OperationService { get; } 
public IOperationTransient TransientOperation { get; } 
public IOperationScoped ScopedOperation { get; } 
public IOperationSingleton SingletonOperation { get; } 
public IOperationSingletonlnstance 
SingletonlnstanceOperation { get; } 

public async Task OnGetAsync() 

{ 

await _myDependency.WriteMessage( 

"IndexModel.OnGetAsync created this message.") 

} 



public class IndexModel : PageModel 

{ 

private readonly IMyDependency _myDependency; 

public IndexModel( 

IMyDependency myDependency, 

OperationService OperationService, 
IOpenationTransient transientOperation, 
IOpenationScoped ScopedOperation, 
IOpenationSingleton SingletonOperation, 
IOpenationSingletonlnstance 
singletonlnstanceOperation) 

{ 

_myDependency = myDependency; 

OperationService = OperationService; 
TransientOperation = transientOperation; 
ScopedOperation = ScopedOperation; 
SingletonOperation = singletonOperationj 
SingletonlnstanceOperation = 
singletonlnstanceOperation; 

} 

public OperationService OperationService { get; } 
public IOperationTransient TransientOperation { get; } 
public IOperationScoped ScopedOperation { get; } 
public IOperationSingleton SingletonOperation { get; } 
public IOperationSingletonlnstance 
SingletonlnstanceOperation { get; } 

public async Task OnGetAsync() 

{ 

await _myDependency.WriteMessage( 

"IndexModel.OnGetAsync created this message."); 

} 

} 


Aşağıdaki iki çıktıda iki isteğin sonuçları gösterilmektedir: 

İlk istek: 

Denetleyici işlemleri: 

Geçici: d233e165-f417-469B-a866-1 cfl935d2518 
Kapsam: 5d997e2d-55f5-4a64-8388-51c4e3a1ad19 
Tek: 01271 bel -9e31 -48e7-8f7c-7261 b040ded9 
Örnek: 00000000-0000-0000-0000-000000000000 

OperationService işlemler: 

Geçici: c6b049eb-1318-4E31 -90f1 -eb2dd849ff64 
Kapsam: 5d997e2d-55f5-4a64-8388-51c4e3a1ad19 
Tek: 01271 bel -9e31 -48e7-8f7c-7261 b040ded9 
Örnek: 00000000-0000-0000-0000-000000000000 

İkinci istek: 

Denetleyici işlemleri: 

Geçici: b63bd538-0a37-4FF1-90ba-081 c5138dda0 
Kapsam: 31e820c5-4834-4d22-83fc-a60118acb9f4 
Tek: 01271 bel -9e31 -48e7-8f7c-7261 b040ded9 
Örnek: 00000000-0000-0000-0000-000000000000 




OperationService işlemler: 


Geçici: c4cbacb8-36a2-436d-81 c8-8c1 b78808aaf 
Kapsam: 31e820c5-4834-4d22-83fc-a60118acb9f4 
Tek: 01271 bel -9e31 -48e7-8f7c-7261 b040ded9 
Örnek: 00000000-0000-0000-0000-000000000000 

Operationid değerlerinden hangisinin bir istek içinde ve 
istekler arasında değiştiğini gözlemleyin: 

• Geçici nesneler her zaman farklıdır. Hem birinci hem de 
ikinci istemci isteklerinin geçici Operationid değeri hem 
OperationService işlemleri hem de istemci istekleri için 

farklıdır. Her hizmet isteğine ve istemci isteğine yeni bir 
örnek sağlanır. 

• Kapsamlı nesneler istemci isteği içinde aynıdır ancak istemci 
istekleri arasında farklıdır. 

• Tek nesneler her nesne için aynıdır ve 
Startup.ConfigureServices bir Operation Örneğinin 

sağlanmadığına bakılmaksızın her istek vardır. 

Ana bilgisayardan Hizmetleri çağır 

Uygulamanın kapsamındaki bir kapsamlı hizmeti çözümlemek 
için ıvicescopefactory. CreateScope ile bir IServiceScope 
oluşturun. Bu yaklaşım, başlatma görevlerini çalıştırmak üzere 
başlangıçta kapsamlı bir hizmete erişmek için yararlıdır. 
Aşağıdaki Örnek, Program.Main' 'MyScopedService için nasıl 
bağlam alınacağını gösterir: 









using System; 

using System.Threading.Tasks; 

using Microsoft.Extensions.Dependencylnjection; 

using Microsoft.AspNetCore.Hoşting; 

using Microsoft.Extensions.Hoşting; 

public class Program 

{ 

public static async Task Main(string[] args) 

{ 

var hoşt = CreateHostBuilder(args).Build(); 

using (var serviceScope = 
host.Services.CreateScope()) 

{ 

var Services = serviceScope.ServiceProvider; 


try 

{ 

var serviceContext = 

Services.GetRequiredService<MyScopedService>(); 

// Use the context here 

} 

catch (Exception ex) 

{ 

var logger = 

Services.GetRequiredService<ILogger<Program>>(); 

logger.LogError(eXj "An error occurred."); 

} 

} 

await host.RunAsync(); 

} 

public static IHostBuilder CreateHostBuilder(string[] 
args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 



using System; 

using System.Threading.Tasks; 

using Microsoft.AspNetCore; 

using Microsoft.AspNetCore.Hoşting; 

using Microsoft.Extensions.Dependencylnjection; 

using Microsoft.Extensions.Logging; 

public class Program 
{ 

public static async Task Main(string[] args) 

{ 

var hoşt = CreateWebHostBuilder(args).Build(); 

using (var serviceScope = 
hoşt.Services.CreateScope()) 

{ 

var Services = serviceScope.ServiceProvider; 


try 

{ 

var serviceContext = 

Services.GetRequiredService<MyScopedService>(); 

// Use the context here 

} 

catch (Exception ex) 

{ 

var logger = 

Services.GetRequiredService<ILogger<Program>>(); 

logger.LogError(eXj "An error occurred."); 

} 


await host.RunAsync(); 


public static INebHostBuilder 
CreateWebHostBuilder(string[] args) => 

UebHost.CreateDefaultBuilder(args) 
.UseStartup<Startup>(); 


} 


Kapsam doğrulaması 

Uygulama geliştirme ortamında çalışırken, varsayılan hizmet 
sağlayıcısı şunları doğrulamak için denetimler gerçekleştirir: 

• Kapsamlı hizmetler doğrudan veya dolaylı olarak kök hizmet 
sağlayıcısından çözümlenmez. 

• Kapsamlı hizmetler doğrudan veya dolaylı olarak Singleton 
'a eklenmiş değildir. 

BuildServiceProvider çağrıldığında kök hizmet sağlayıcısı 
oluşturulur. Kök hizmet sağlayıcısının ömrü, sağlayıcının 
uygulamayla başladığı ve uygulama kapandığında bırakıldığı 
uygulama/sunucunun yaşam süresine karşılık gelir. 

Kapsamlı hizmetler kendilerini oluşturan kapsayıcı tarafından 
atılmış. Kök kapsayıcıda kapsamlı bir hizmet oluşturulduysa, 
hizmetin ömrü etkin şekilde tek başına yükseltilir çünkü 
yalnızca uygulama/sunucu kapatıldığında kök kapsayıcı 
tarafından atılmış olur. Hizmet kapsamlarını doğrulamak 



BuiidServiceProvider çağrıldığında bu durumları yakalar. 


Daha fazla bilgi için bkz. ASP.NET Core Web ana bilgisayarı. 

İstek Hizmetleri 

HttpContext bir ASP.NET Core isteği içinde kullanılabilen 
hizmetler, HttpContext. RequestServices koleksiyonu 
aracılığıyla sunulur. 

istek Hizmetleri, uygulamanın bir parçası olarak yapılandırılan 
ve istenen hizmetleri temsil eder. Nesneler bağımlılıklar 
belirttiğinizde, bunlar AppiicationServices değil 
Requestservices bulunan türler tarafından karşılanır. 

Genellikle, uygulamanın bu özellikleri doğrudan 
kullanmamalıdır. Bunun yerine, sınıfların Sınıf oluşturucuları 
aracılığıyla gerektirdiği türleri isteyin ve çerçevenin 
bağımlılıkları eklemesine izin verin. Bu, test etmek daha kolay 
olan sınıfları oluşturur. 


NOTE 

Requestservices koleksiyonuna erişmek için Oluşturucu 
parametreleri olarak bağımlılıklar istemeyi tercih edin. 


Bağımlılık ekleme için tasarım hizmetleri 

En iyi uygulamalar şunlardır: 

• Bağımlılıklarını almak için bağımlılık ekleme 'yi kullanmak 
üzere Hizmetleri tasarlayın. 

• Durum bilgisi olan statik sınıflar ve Üyeler kullanmaktan 
kaçının. Genel durum oluşturulmasını önlemek yerine, tek 
tek Hizmetleri kullanmak için uygulamaları tasarlayın. 

• Hizmetler içindeki bağımlı sınıfların doğrudan 
örneklenmesini önleyin. Doğrudan örnekleme kodu belirli 
bir uygulamaya bağar. 

• Uygulama sınıflarını küçük, iyi bir şekilde ve kolayca test 
edin. 

Bir sınıfta çok fazla sayıda bağımlılık varsa, bu genellikle sınıfta 
çok fazla sorumluluk olduğu ve tek sorumluluk ilkesini 
(SRP)ihlal eden bir imzadır. Bazı sorumlulukları yeni bir sınıfa 
taşıyarak sınıfı yeniden düzenleme girişimi. Razor Pages sayfa 
modeli sınıfları ve MVC denetleyici sınıflarının Ul kaygılarıyla 
odaklanıp ilgilenmeyeceğini aklınızda bulundurun, iş kuralları 
ve veri erişimi uygulama ayrıntıları, bu ayrı kaygılarauygun 
sınıflarda tutulmalıdır. 

Hizmetlerin elden çıkarılması 

Kapsayıcı, oluşturduğu IDİsposable türleri için Dispose çağırır. 
Kapsayıcıda Kullanıcı kodu tarafından bir örnek eklenirse, 
otomatik olarak atılamaz. 







// Services that implement IDisposable: 
public class Servicel : IDisposable {} 
public class Service2 : IDisposable {} 
public class Service3 : IDisposable {} 

public interface ISomeService {} 

public class SomeServicelmplementation : ISomeService, 
IDisposable {} 

public void ConfigureServices(IServiceCollection Services) 

{ 

// The Container creates the following instances and 
disposes them automatically: 

Services.AddScoped<Servicel>(); 

Services.AddSingleton<Service2>(); 

Services.AddSingleton<ISomeService>(sp => new 
SomeServicelmplementation()); 

// The Container doesn't create the following instances, 
so it doesn't dispose of 

// the instances automatically: 

Services.AddSingleton<Service3>(new Service3()); 

Services.AddSingleton(new Service3()); 

} 


Varsayılan hizmet kapsayıcısı değiştirme 

Yerleşik hizmet kapsayıcısı, çerçeve ihtiyaçlarına ve çoğu 
tüketici uygulamasına hizmet vermek için tasarlanmıştır. 

Yerleşik kapsayıcının desteklemediği belirli bir özelliğe 
ihtiyacınız yoksa, yerleşik kapsayıcının kullanılması önerilir, 
örneğin: 

• Özellik ekleme 

• Ada göre ekleme 

• Alt kapsayıcılar 

• Özel ömür yönetimi 

• yavaş başlatma için Func<T> desteği 

Aşağıdaki 3. taraf kapsayıcıları ASP.NET Core uygulamalarla 
kullanılabilir: 

• Autofac 

• Drıioc 

• Yetkisiz kullanım 

• Açık Inject 

• E 

• Stakıbox 

• Unity 

İş parçacığı güvenliği 

iş parçacığı güvenli Singleton Hizmetleri oluşturun. Tek bir 
hizmetin geçici bir hizmete bağımlılığı varsa, geçici hizmet aynı 
zamanda tek tek tarafından nasıl kullanıldığına bağlı olarak iş 
parçacığı güvenliği de gerektirebilir. 

Tek bir hizmetin fabrika yöntemi (örneğin, 





AddSingletoncTService > (ısevicecollection, 
Func<IServiceProvider, TService >), iş parçacığı açısından 
güvenli olması gerekmez. Bir tür ( static ) Oluşturucusu gibi, 
tek bir iş parçacığı tarafından bir kez çağrılması garanti edilir. 

Öneriler 

• async/await ve Task tabanlı hizmet çözümlemesi 
desteklenmez. C#zaman uyumsuz oluşturucuları 
desteklemez; Bu nedenle, önerilen model hizmeti zaman 
uyumlu olarak çözümledikten sonra zaman uyumsuz 
yöntemler kullanmaktır. 

• Veri ve yapılandırmayı doğrudan hizmet kapsayıcısında 
saklamaktan kaçının. Örneğin, bir kullanıcının alışveriş 
sepeti genellikle hizmet kapsayıcısına eklenmemelidir. 
Yapılandırma, Seçenekler modelinikullanmalıdır. Benzer 
şekilde, yalnızca başka bir nesneye erişime izin vermek 
için mevcut olan "veri sahibi" nesnelerinden kaçının. Dİ 
aracılığıyla gerçek öğe istemek daha iyidir. 

• Hizmetlere statik erişimi önleyin (örneğin, başka bir 
yerde kullanmak üzere, statik olarak yazılan 

lApplicationBuilder. ApplicationServices ). 

• Hizmet bulucu deseninin kullanmaktan kaçının. Örneğin, 
yerine şunu kullandığınızda bir hizmet örneği elde etmek 
için GetService çağırmayın: 

Olmayan 

public class MyClass() 

{ 

public void MyMethod() 

{ 

var optionsMonitor = 

_services.GetService<IOptionsMonitor<MyOptions>>(); 
var option = 

optionsMonitor.CurrentValue.Optionj 

} 

} 


Doğru: 





public class MyClass 
{ 

private readonly IOptionsMonitor<MyOptions> 
_optionsMonitor; 

public MyClass(IOptionsMonitor<MyOptions> 
optionsMonitor) 

{ 

_optionsMonitor = optionsMonitor; 

} 

public void MyMethod() 

{ 

var option = 

_optionsMonitor.CurrentValue.Option; 

} 

} 

• Önlemek için başka bir hizmet bulucu çeşitlemesi, 
çalışma zamanında bağımlılıkları çözümleyen bir ekleme. 

Bu uygulamalardan her ikisi de Denetim stratejilerini 
geçersiz kılar . 

• HttpContext statik erişimden kaçının (örneğin, 
ıhttpcontextaccessor. HttpContexl). 

Tüm öneri kümeleri gibi, bir öneriyi yok saymayı yok saymış 
durumlarla karşılaşabilirsiniz. Özel durumlar genellikle 
Framework içindeki özel durumlar—nadir olarak kullanılır. 

Dı, statik/genel nesne erişim desenlerinin bir alternatifidir. 
Statik nesne erişimi ile karıştırırsanız, dı 'nin avantajlarını fark 
edemeyebilirsiniz. 

Ek kaynaklar 

• ASP.NET core'da görünümlere bağımlılık ekleme 

• ASP.NET core'da denetleyicilere bağımlılık ekleme 

• ASP.NET core'da gereksinim işleyicilerine bağımlılık ekleme 

• ASP.NET Core Blazor bağımlılığı ekleme 

• ASP.NET Core'de uygulama başlatma 

• ASP.NET Core 'de fabrika tabanlı ara yazılım etkinleştirmesi 

• Bağımlılık ekleme (MSDN) ile ASP.NET Core temizleme 
kodu yazma 

• Açık bağımlılıklar İlkesi 

• Denetim kapsayıcıları ve bağımlılık ekleme deseninin 
Inversion 'ı (Marvvler) 

• ASP.NET Core Dİ 'de birden çok arabirime sahip bir hizmeti 
kaydetme 
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Ara yazılım, istekleri ve yanıtları işlemek için bir uygulama ardışık düzenine çevrilmiş yazılımdır. Her 
bileşen: 

• isteğin işlem hattında sonraki bileşene geçirilip geçemeyeceğini seçer. 

• işlem hattındaki sonraki bileşenden önce ve sonra iş gerçekleştirebilir. 

istek işlem hattını oluşturmak için istek temsilcileri kullanılır, istek temsilcileri her HTTP isteğini işler. 

istek temsilcileri Run, Mapve Use uzantı yöntemleri kullanılarak yapılandırılır. Tek bir istek temsilcisi, bir 
anonim Yöntem (çevrimiçi ara yazılım olarak adlandırılır) olarak satır içinde belirtilebilir veya yeniden 
kullanılabilir bir sınıfta tanımlanabilir. Bu yeniden kullanılabilir sınıflar ve satır içi anonim yöntemler,Ara 
yazdım bileşenlerlolarak da adlandırılan ara yazılımlar, istek ardışık düzeninde bulunan her bir ara 
yazılım bileşeni, işlem hattındaki bir sonraki bileşeni çağırmaktan veya işlem hattının kısa süreli olarak 
sağlanmasından sorumludur. Bir ara yazılım kısa devre dışı bırakıldığında, bu, diğer ara yazılımların 
isteği işlemesini önlediği için Terminal ara yazılımı olarak adlandırılır. 

ASP.NET Core ara yazılıma HTTP işleyicileri ve modülleri geçirme, ASP.NET Core ve ASP.NET 4. x 
içindeki istek işlem hatları arasındaki farkı açıklar ve ek ara yazılım örnekleri sağlar. 

lApplicationBuilder ile bir ara yazılım işlem hattı oluşturma 

ASP.NET Core isteği ardışık düzeni, bir dizi istekten oluşur ve bunlardan sonra çağırılır. Aşağıdaki 
diyagramda kavram gösterilmektedir. Yürütmenin iş parçacığı siyah okları izler. 



Her temsilci bir sonraki temsilciden önce ve sonra işlemleri gerçekleştirebilir.Özel durum işleme 
temsilcileri işlem hattında erken çağrılmalıdır, bu sayede işlem hattının sonraki aşamalarında oluşan 
özel durumları yakalayabilirler. 

Mümkün olan en basit ASP.NET Core uygulaması, tüm istekleri işleyen tek bir istek temsilcisi kurar. Bu 
durum gerçek bir istek işlem hattı içermez. Bunun yerine, her HTTP isteğine yanıt olarak tek bir anonim 





işlev çağırılır. 


public class Startup 

{ 

public void Configure(IApplicationBuilder app) 

{ 

app.Run(async context => 

{ 

await context.Response.WriteAsync("Hello., World!")j 

}); 

} 

} 

ilk Run temsilci, işlem hattını sonlandırır. 

Birden çok istek temsilciyi Useile birlikte zinciri. next parametresi, ardışık düzendeki bir sonraki 
temsilciyi temsil eder. Ardışık düzen, sonraki parametreyi çağirarak işlem hattı için kısa devre dışı 
bırakabilirsiniz. Aşağıdaki örnekte gösterildiği gibi genellikle sonraki temsilciden önce ve sonra 
eylemler gerçekleştirebilirsiniz: 

public class Startup 

{ 

public void Configure(IApplicationBuilder app) 

{ 

app.Use(async (context, next) => 

{ 

// Do work that doesn't write to the Response. 
await next.Invoke(); 

// Do logging or other work that doesn't write to the Response. 

}); 

app.Run(async context => 

{ 

await context.Response.WriteAsync("Hello from 2nd delegate."); 

}); 

} 

} 

Bir temsilci bir sonraki temsilciye bir istek iletmezse, istek ardLŞLk düzenini, kısa devre olarak 
gerçekleştirmektir. Gereksiz çalışmayı önlediği için kısa devre, genellikle tercih edilir.Örneğin, statik 
dosya ara yazılımı, bir statik dosya için bir isteği işleyerek ve işlem hattının geri kalanını 
gerçekleştirerek bir Terminal ara yazılımı görevi görebilir. Daha fazla işlemeyi sonlandıran ara yazılım, 
next.invoke deyimlerinden sonra kodu işlerken işlem hattına eklenen ara yazılımlar. Ancak, zaten 
gönderilmiş bir yanıta yazma girişimi hakkında aşağıdaki uyarıya bakın. 


VVARNING 

istemciye yanıt gönderildikten sonra next. invoke çağırmayın. Yanıt başladıktan sonra HttpResponse 
değişiklikler özel durum oluşturur. Örneğin, üstbilgileri ayarlama ve durum kodu gibi değişiklikler özel durum 
oluşturur. next çağrıldıktan sonra yanıt gövdesine yazma: 

• Protokol ihlaline neden olabilir. Örneğin, belirtilen content-Length daha fazla yazma. 

• Gövde biçimi bozulabilir.Örneğin, bir CSS dosyasına bir HTML altbilgisi yazma. 

HasStarted, üstbilgilerin gönderilip gönderilmediğini veya gövdenin yazıldığını göstermek için faydalı bir ipucu. 


Ara yazılım sırası 








Ara yazılım bileşenlerinin startup.configure yöntemi içinde eklendiği sıra, ara yazılım bileşenlerinin 
isteklerde çağrıldığı sırayı ve yanıtın ters sırasını tanımlar. Sıra, güvenlik, performans ve işlevsellik 
açısından önemlidir. 

Aşağıdaki startup.configure yöntemi, güvenlikle ilgili ara yazılım bileşenlerini önerilen sırayla ekler 

public void Configure(IApplicationBuilder app, IWebHostEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 
app.UseDatabaseErrorPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 

// app.UseCookiePolicyO; 

app.UseRoutingO; 

// app.UseRequestLocalization(); 

// app.UseCors(); 

app.UseAuthentication(); 
app.UseAuthorization(); 

// app.UseSession(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapRazorPages(); 
endpoints.MapControllerRoute( 
name: "default", 

pattern: "{controller=Home}/{action=Index}/{id?}"); 

}); 

} 

Önceki kodda: 

• Bireysel kullanıcılar hesaplarıyla yeni bir Web uygulaması oluştururken eklenmemiş olan ara 
yazılım, yorum yapılır. 

• Her ara yazılımın bu tam sıra, ancak birçok do olması gerekmez. Örneğin, useCors , 
useAuthentication ve useAuthorization gösterilen sırayla gelmelidir. 

Aşağıdaki startup.configure yöntemi, genel uygulama senaryoları için ara yazılım bileşenleri ekler: 

1. Özel durum/hata işleme 

• Uygulama geliştirme ortamında çalıştığında: 

o Geliştirici özel durum sayfası ara yazılımı (UseDeveloperExceptionPage) uygulama 
çalışma zamanı hatalarını raporlar. 

o Veritabanı hata sayfası ara yazılımı veritabanı çalışma zamanı hatalarını raporlar. 

• Uygulama, üretim ortamında çalıştığında: 

o Özel durum Işleyici ara yazılımı (UseExceptionHandler) aşağıdaki middlewares 
oluşturulan özel durumları yakalar. 

o HTTP katı aktarım güvenliği Protokolü (HSTS) ara yazılımı (UseHsts) 
Strict-Transport-Security Üstbilgisini ekler. 

2. HTTPS yeniden yönlendirme ara yazılımı (UseHttpsRedirection) HTTP isteklerini HTTPS 'y e 










yönlendirir. 

3. Statik dosya ara yazılımı (UseStaticFiles) statik dosyaları ve kısa devre dışı istek işlemeyi döndürür. 

4. Tanımlama bilgisi İlkesi ara yazılımı (UseCookiePolicy) uygulamayı AB Genel Veri Koruma 
Yönetmeliği (GDPR) düzenlemelerine uyar. 

5. istekleri yönlendirmek için ara yazılım ( useRouting ). 

6. Kimlik doğrulama ara yazılımı (UseAuthentication), güvenli kaynaklara erişim izni vermeden önce 
kullanıcının kimliğini doğrulamaya çalışır. 

7. Yetkilendirme ara yazılımı ( useAuthorization ), bir kullanıcıya güvenli kaynaklara erişim yetkisi verir. 

8. Oturum ara yazılımı (UseSession) oturum durumunu oluşturur ve korur. Uygulama oturum 
durumunu kullanıyorsa, tanımlama bilgisi İlkesi ara yazılımı ve MVC ara yazılımı öncesinde oturum 
ara yazılımını çağırın. 

9. istek ardışık düzenine Razor Pages uç noktaları eklemek için uç nokta yönlendirme ara yazılımı ( 
MapRazorPages''UseEndpoints ). 

public void Configure(IApplicationBuilder app, IUebHostEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 
app.UseDatabaseErrorPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 
app.UseCookiePolicy(); 
app.UseRouting(); 
app.UseAuthentication(); 
app. UseAuthorization O; 
app.UseSession(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapRazorPages(); 

}); 

} 

Yukarıdaki örnek kodda, her bir ara yazılım uzantısı yöntemi Microsoft.AspNetCore.Builder ad alanı 
aracılığıyla lApplicationBuilder gösterilir. 

UseExceptionHandler, işlem hattına eklenen ilk ara yazılım bileşenidir. Bu nedenle, özel durum Işleyicisi 
ara yazılımı sonraki çağrılarında oluşan tüm özel durumları yakalar. 

Statik dosya ara yazılımı, geri kalan bileşenlere geçmeden istekleri ve kısa devre dışı bırakabilirsiniz, bu 
sayede işlem hattının başlarında çağrılır. Statik dosya ara yazılımı yetkilendirme denetimleri 
sağlamaz. H/n/n/rootaltındakiler de dahil olmak üzere statik dosya ara yazılımı tarafından sunulan tüm 
dosyalar herkese açık bir şekilde sunulur. Statik dosyaların güvenliğini sağlamaya yönelik bir yaklaşım 
için bkz.ASP.NET Core statik dosyalar. 

istek statik dosya ara yazılımı tarafından işlenmemişse, kimlik doğrulaması yapan kimlik doğrulama ara 
yazılım (UseAuthentication) üzerinden geçirilir. Kimlik doğrulaması kısa devre dışı kimliği 
doğrulanmamış istekler değildir. Kimlik doğrulama ara yazılımı isteklerin kimliğini doğrulayabilse de, 
yetkilendirme (ve reddetme) yalnızca MVC, belirli bir Razor sayfası veya MVC denetleyicisi ve eylemi 
seçerse oluşur. 





Aşağıdaki örnek, yanıt sıkıştırma ara yazılımı ile önce statik dosya isteklerinin statik dosya ara yazılımı 
tarafından işlendiği bir ara yazılım sırasını gösterir. Statik dosyalar bu ara yazılım sırasıyla sıkıştırılmaz. 
Razor Pages yanıtları sıkıştırılabilirler. 

public void Configure(IApplicationBuilder app) 

{ 

// Static fileş aren't compressed by Static File Middleware. 
app.UseStaticFiles(); 

app.UseResponseCompression(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapRazorPages(); 

}); 

} 


public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 
app.UseDatabaseErrorPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Home/Erron"); 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 
app.UseCookiePolicy(); 

// app.UseRequestLocalization(); 

// app.UseCors(); 

app.UseAuthentication(); 

// app.UseSession(); 

app.UseMvc(routes => 

{ 

routes.MapRoute( 

name: "default", 

template: "{controller=Home}/{action=Index}/{id?}"); 

}); 

} 

Önceki kodda: 

• Bireysel kullanıcılar hesaplarıyla yeni bir Web uygulaması oluştururken eklenmemiş olan ara 
yazılım, yorum yapılır. 

• Her ara yazılımın bu tam sıra, ancak birçok do olması gerekmez. Örneğin, useCors ve 
useAuthentication gösterilen sırada olmalıdır. 

Aşağıdaki stantup.configune yöntemi, genel uygulama senaryoları için ara yazılım bileşenleri ekler: 

1. Özel durum/hata işleme 

• Uygulama geliştirme ortamında çalıştığında: 

o Geliştirici özel durum sayfası ara yazılımı (UseDeveloperExceptionPage) uygulama 
çalışma zamanı hatalarını raporlar. 






o Veritabanı hata sayfası ara yazılımı ( 

Microsoft.AspNetCore.Builder.DatabaseErrorPageExtensions.UseDatabaseErrorPage ) 
veritabanı çalışma zamanı hatalarını raporlar. 

• Uygulama, üretim ortamında çalıştığında: 

o Özel durum Işleyici ara yazılımı (UseExceptionHandler) aşağıdaki middlewares 
oluşturulan özel durumları yakalar. 

o HTTP katı aktarım güvenliği Protokolü (HSTS) ara yazılımı (UseHsts) 
Strict-Transport-Security Üstbilgisini ekler. 

2. HTTPS yeniden yönlendirme ara yazılımı (UseHttpsRedirection) HTTP isteklerini HTTPS 'y e 
yönlendirir. 

3. Statik dosya ara yazılımı (UseStaticFiles) statik dosyaları ve kısa devre dışı istek işlemeyi döndürür. 

4. Tanımlama bilgisi İlkesi ara yazılımı (UseCookiePolicy) uygulamayı AB Genel Veri Koruma 
Yönetmeliği (GDPR) düzenlemelerine uyar. 

5. Kimlik doğrulama ara yazılımı (UseAuthentication), güvenli kaynaklara erişim izni vermeden önce 
kullanıcının kimliğini doğrulamaya çalışır. 

6. Oturum ara yazılımı (UseSession) oturum durumunu oluşturur ve korur. Uygulama oturum 
durumunu kullanıyorsa, tanımlama bilgisi İlkesi ara yazılımı ve MVC ara yazılımı öncesinde oturum 
ara yazılımını çağırın. 

7. MVC (UseMvc) istek ardışık düzenine MVC eklemek için. 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 
app.UseDatabaseErrorPage(); 

} 

else 

{ 

app.UseExceptlonHandler("/Err'or"); 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 
app.UseCookiePolicy(); 
app.UseAuthentication(); 
app.UseSession(); 
app.UseMvc(); 

} 

Yukarıdaki örnek kodda, her bir ara yazılım uzantısı yöntemi Microsoft.AspNetCore.Builder ad alanı 
aracılığıyla lApplicationBuilder gösterilir. 

UseExceptionHandler, işlem hattına eklenen ilk ara yazılım bileşenidir. Bu nedenle, özel durum Işleyicisi 
ara yazılımı sonraki çağrılarında oluşan tüm özel durumları yakalar. 

Statik dosya ara yazılımı, geri kalan bileşenlere geçmeden istekleri ve kısa devre dışı bırakabilirsiniz, bu 
sayede işlem hattının başlarında çağrılır. Statik dosya ara yazılımı yetkilendirme denetimleri 
sağlamaz, l/l/rvrvroofaltındakiler de dahil olmak üzere statik dosya ara yazılımı tarafından sunulan tüm 
dosyalar herkese açık bir şekilde sunulur. Statik dosyaların güvenliğini sağlamaya yönelik bir yaklaşım 
için bkz.ASP.NET Core statik dosyalar. 

istek statik dosya ara yazılımı tarafından işlenmemişse, kimlik doğrulaması yapan kimlik doğrulama ara 
yazılım (UseAuthentication) üzerinden geçirilir. Kimlik doğrulaması kısa devre dışı kimliği 
doğrulanmamış istekler değildir. Kimlik doğrulama ara yazılımı isteklerin kimliğini doğrulayabilse de, 




yetkilendirme (ve reddetme) yalnızca MVC, belirli bir Razor sayfası veya MVC denetleyicisi ve eylemi 
seçerse oluşur. 

Aşağıdaki örnek, yanıt sıkıştırma ara yazılımı ile önce statik dosya isteklerinin statik dosya ara yazılımı 
tarafından işlendiği bir ara yazılım sırasını gösterir. Statik dosyalar bu ara yazılım sırasıyla sıkıştırılmaz. 
UseMvcVVİthDefaultRoute MVC yanıtları sıkıştırılabilirler. 

public void Configure(IApplicationBuilder app) 

{ 

// Static fileş aren't compressed by Static File Middleware. 
app.UseStaticFiles(); 

app.UseResponseCompression(); 

app.UseMvcWithDefaultRoute(); 

} 


Kullanın, çalıştırın ve eşleyin 

Use, Runve Mapkullanarak HTTP işlem hattını yapılandırın, use yöntemi, işlem hattı kısa devre dışı 
olabilir (yani, bir next isteği temsilcisi çağırmazsa). Run bir kuraldır ve bazı ara yazılım bileşenleri, 
işlem hattının sonunda çalışan Run[Middieware] Yöntemler sunabilir. 

Map uzantıları, işlem hattının dallanması için bir kural olarak kullanılır. Map , istek ardışık düzenini, 
verilen istek yolunun eşleşenleri temelinde dallandırır, istek yolu verilen yol ile başlıyorsa, dal yürütülür. 

public class Startup 
{ 

private static void HandleMapTestl(IApplicationBuilder app) 

{ 

app.Run(async context => 

{ 

await context.Response.WriteAsync("Map Test 1"); 

}); 

} 

private static void HandleMapTest2(IApplicationBuilder app) 

{ 

app.Run(async context => 

{ 

await context.Response.WriteAsync("Map Test 2"); 

}); 

} 

public void Configure(IApplicationBuilder app) 

{ 

app.MapC’/mapl", HandleMapTestl); 

app.Map("/map2", HandleMapTest2); 

app.Run(async context => 

{ 

await context.Response.WriteAsync("Hello from non-Map delegate. <p>"); 

}); 

} 

} 

Aşağıdaki tabloda, önceki kodu kullanarak http://iocaihost:i 234 gelen istekler ve yanıtlar 
gösterilmektedir. 









İSTEK 


YANIT 


localhost: 1234 Eşleme olmayan temsilciden Merhaba, 

localhost: 1234/Mapl Eşleme testi 1 

localhost: 1234/MAP2 Eşleme testi 2 

localhost: 1234/map3 Eşleme olmayan temsilciden Merhaba. 

Map kullanıldığında, eşleşen yol kesimleri HttpRequest.Path kaldırılır ve her istek için 
HttpRequest.PathBase eklenir. 

MapVVhen, belirtilen koşulun sonucuna göre istek ardışık düzenini dallandırır. Func<HttpContext J booi> 
türündeki herhangi bir koşul, istekleri işlem hattının yeni bir dalına eşlemek için kullanılabilir. Aşağıdaki 
örnekte, bir sorgu dizesi değişkeninin varlığını algılamak için bir koşul kullanılır branch : 

public class Startup 

{ 

private static void HandleBranch(IApplicationBuilder app) 

{ 

app.Run(async context => 

{ 

var branchVer = context.Request.Query["branch"]; 

await context.Response.WriteAsync($"Branch used = {branchVer}"); 

}); 

} 

public void Configure(IApplicationBuilder app) 

{ 

app.MapWhen(context => context.Request.Query.ContainsKey("branch "), 

HandleBranch); 

app.Run(async context => 

{ 

await context.Response.WriteAsync("Hello from non-Map delegate. <p>"); 

}); 

} 

} 

Aşağıdaki tabloda, önceki kodu kullanarak http://localhost: 1234 gelen istekler ve yanıtlar 
gösterilmektedir. 

İSTEK YANIT 


localhost: 1234 Eşleme olmayan temsilciden Merhaba, 

localhost: 1234/7 dalı = ana Kullanılan dal = ana 

Map iç içe geçirmeyi destekler, örneğin: 







app.MapC'/levell", levellApp => { 

levellApp.Map("/level2a ", level2AApp => { 
// "/levell/level2a" Processing 

}); 

levellApp.Map("/level2b"^ level2BApp => { 
// "/levell/level2b" Processing 

}); 

}); 

Map aynı anda birden çok kesimde eşleşir: 


public class Startup 

{ 

private static void HandleMultiSeg(IApplicationBuilder app) 

{ 

app.Run(async context => 

{ 

await context.Response.WriteAsync("Map multiple segments."); 

}); 

} 

public void Configure(IApplicationBuilder app) 

{ 

app.Map("/mapl/segl ", HandleMultiSeg); 

app.Run(async context => 

{ 

await context.Response.WriteAsync("Hello from non-Map delegate."); 

}); 

} 

} 


Yerleşik ara yazılım 

AS P.N ET Core aşağıdaki ara yazılım bileşenleriyle birlikte gönderilir. Order sütunu, istek işleme ardışık 
düzeninde ara yazılım yerleştirme ve ara yazılımın istek işlemeyi sonlandırabilecekleri koşullar 
bölümünde notlar sağlar. Bir ara yazılım, istek işlem hattının ne kadar kısa süreli olduğunu ve daha fazla 
aşağı akış ara yazılımı bir isteği işlemesini engelliyorsa, bu, Terminal ara yazılımlolarak adlandırılır. Kısa 
devre oluşturma hakkında daha fazla bilgi için, lApplicationBuilder ile bir ara yazılım işlem hattı 
oluşturma bölümüne bakın. 


ARA YAZILIM 

AÇIKLAMA 

SİPARİŞ verme 

Kimlik doğrulaması 

Kimlik doğrulama desteği sağlar. 

HttpContext. User Önce. OAuth 
geri çağırmaları için Terminal. 

Tanımlama bilgisi İlkesi 

Kişisel bilgileri depolamak için 
kullanıcılardan onay izler ve 
secure ve SameSite gibi 
tanımlama bilgisi alanları için en 
düşük standartları uygular. 

Tanımlama bilgilerini veren ara 
yazılım öncesi. Örnekler: 
Authentication, Session, MVC 
(TempData). 

CORS 

Çıkış noktaları arası kaynak 
paylaşımını yapılandırır. 

CORS kullanan bileşenlerden önce. 




ARA YAZILIM 


AÇIKLAMA 


SİPARİŞ VERME 


Tanılama 

Geliştirici özel durum sayfası, özel 
durum işleme, durum kodu sayfaları 
ve yeni uygulamalar için varsayılan 
Web sayfası sağlayan çeşitli ayrı 
middlevvares. 

Hata oluşturan bileşenlerden önce. 
Özel durumlar için Terminal veya 
yeni uygulamalar için varsayılan 

Web sayfasına hizmet sunma. 

iletilen üstbilgiler 

Proxy üst bilgilerini geçerli istek 
üzerine iletir. 

Güncelleştirilmiş alanları kullanan 
bileşenlerden önce. Örnekler: 
Scheme, Hoşt, istemci İP, yöntem. 

Sistem durumu denetimi 

ASP.NET Core uygulamasının sistem 
durumunu ve bağımlılıklarını 
denetler (örneğin, veritabanı 
kullanılabilirliğini denetleme). 

Bir istek bir sistem durumu 
denetimi uç noktasıyla eşleşiyorsa 
Terminal. 

HTTP yöntemini geçersiz kılma 

Gelen POST isteğinin yöntemi 
geçersiz kılmasına izin verir. 

Güncelleştirilmiş yöntemini kullanan 
bileşenlerden önce. 

HTTPS yönlendirmesi 

Tüm HTTP isteklerini HTTPS 'ye 
yeniden yönlendirin. 

URL 'Yİ kullanan bileşenlerden önce. 

HTTP katı taşıma güvenliği (HSTS) 

Özel bir yanıt üst bilgisi ekleyen 
güvenlik geliştirme ara yazılımı. 

Yanıtlar gönderilmeden önce ve 
istekleri değiştiren bileşenler. 
Örnekler: İletilen üstbilgiler, URL 
yeniden yazma. 

MVC 

MVC/Razor Pages ile istekleri işler. 

Bir istek bir rota ile eşleşiyorsa 
Terminal. 

OWıN 

OVVIN tabanlı uygulamalar, 
sunucular ve ara yazılım ile birlikte 
çalışma. 

OVVıN ara yazılımı isteği tam olarak 
işliyorsa Terminal. 

Yanıtları Önbelleğe Alma 

Yanıtları önbelleğe almak için destek 
sağlar. 

Önbelleğe alma gerektiren 
bileşenlerden önce. 

Yanıt sıkıştırması 

Yanıtları sıkıştırmak için destek 
sağlar. 

Sıkıştırma gerektiren bileşenlerden 
önce. 

Yerelleştirme iste 

Yerelleştirme desteği sağlar. 

Yerelleştirmenin önemli 
bileşenlerinden önce. 

Uç nokta yönlendirme 

istek yollarını tanımlar ve kısıtlar. 

Eşleşen yolların terminali. 

Oturum 

Kullanıcı oturumlarını yönetmek için 
destek sağlar. 

Oturum gerektiren bileşenlerden 
önce. 

Statik dosyalar 

Statik dosyaları ve dizin taramayı 
sunma desteği sağlar. 

Bir istek bir dosyayla eşleşiyorsa 
Terminal. 

URL yeniden yazma 

URL 'Leri yeniden yazma ve istekleri 
yeniden yönlendirme desteği sağlar. 

URL 'Yİ kullanan bileşenlerden önce. 

VVebSockets 

VVebSockets protokolünü 
etkinleştirilir. 

VVebSocket isteklerini kabul etmek 
için gereken bileşenlerden önce. 


ARA YAZILIM 


AÇIKLAMA 


SİPARİŞ VERME 


Ek kaynaklar 

• Özel ASP.NET Core ara yazılımı yaz 

• ASP.NET Core ara yazılıma HTTP işleyicileri ve modülleri geçirme 

• ASP.NET Core'de uygulama başlatma 

• ASP.NET core'da istek özellikleri 

• ASP.NET Core'de fabrika tabanlı ara yazılım etkinleştirmesi 

• ASP.NET Core bir üçüncü taraf kapsayıcısı ile ara yazılım etkinleştirme 


.NET genel ana bilgisayar 
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Bu makalede .NET Core genel ana bilgisayarı (HostBuilder) tanıtılmakta ve nasıl kullanılacağına ilişkin 
yönergeler sunulmaktadır. 

Ana bilgisayar nedir? 

Ana bilgisayar, bir uygulamanın kaynaklarını kapsülleyen bir nesnedir, örneğin: 

• Bağımlılık ekleme (dı) 

• Günlüğe Kaydetme 

• Yapılandırma 

• iHostedService uygulamalar 

Bir konak başlatıldığında, Dİ kapsayıcısında bulduğu IHostedService her bir uygulamada 
iHostedService.startAsync çağırır. Bir Web uygulamasında, IHostedService uygulamalarından biri, http 
sunucu uygulamasıBaşlatan bir Web hizmetidir. 

Uygulamanın tüm birbirine bağlı kaynaklarını tek bir nesnede dahil etmek için başlıca neden, yaşam süresi 
yönetimi: uygulama başlatma ve düzgün kapanma üzerinde denetim. 

3,0 1 den önceki ASP.NET Core sürümlerinde, Web ana BİLGİSAYARI http iş yükleri için kullanılır. Web ana 
bilgisayarı artık Web uygulamaları için önerilmez ve yalnızca geriye dönük uyumluluk için kullanılabilir 
durumda kalır. 

Konak ayarlama 

Konak genellikle Program sınıfındaki kodla yapılandırılır, oluşturulur ve çalıştırılır. Main yöntemi: 

• Bir Oluşturucu nesnesi oluşturmak ve yapılandırmak için bir createHostBuiider yöntemi çağırır. 

• Oluşturucu nesnesinde Buiid ve Run yöntemleri çağırır. 

İşte, tek bir IHostedService uygulama olarak dı kapsayıcısına eklenen HTTP olmayan bir iş yükü için 
program.es kodu. 

public elass Program 
{ 

public static void Main(string[] args) 

{ 

CreateHostBuilder(args).Build().Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureServices((hostContext, Services) => 

{ 

Services.AddHostedService<Worker>(); 

}); 

} 


Bir HTTP iş yükü için Main yöntemi aynıdır ancak CreateHostBuiider 


ConfigureWebHostDefaults çağırır: 
















public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 

Uygulama Entity Framevvork Core kullanıyorsa createHostBuiider yönteminin adını veya imzasını 
değiştirmeyin. Entity Framevvork Core araçları , uygulamayı çalıştırmadan Konağı yapılandıran bir 
CreateHostBuiider yöntemi bulmayı bekler. Daha fazla bilgi için bkz. Tasarım zamanı DbContext 
oluşturma. 

Varsayılan Oluşturucu ayarları 

CreateDefaultBuilder yöntemi: 

• içerik kökünü GetCurrentDirectorytarafından döndürülen yola ayarlar. 

• Ana bilgisayar yapılandırmasını şuradan yükler: 
o "DOTNET_" önekli ortam değişkenleri. 

o Komut satırı bağımsız değişkenleri. 

• Uygulama yapılandırmasını şuradan yükler: 
o appSettings. JSON. 

o appSettings. {Environment}. JSON. 

o Uygulama Development ortamda çalıştığında gizli dizi Yöneticisi. 
o Ortam değişkenleri, 
o Komut satırı bağımsız değişkenleri. 

• Aşağıdaki günlük sağlayıcılarını ekler: 
o Konsolu 

o Hata ayıklama 
o EventSource 

o Olay günlüğü (yalnızca Windows üzerinde çalışırken) 

• Ortam geliştirme sırasında kapsam doğrulaması ve bağımlılık doğrulaması etkinleştirilir. 

ConfigureWebHostDefaults yöntemi: 

• "ASPNETCORE_" önekli ortam değişkenlerinden ana bilgisayar yapılandırmasını yükler. 

• Kestrel sunucusunu Web sunucusu olarak ayarlar ve uygulamanın barındırma yapılandırma 
sağlayıcılarını kullanarak yapılandırır. Kestrel sunucusunun varsayılan seçenekleri için bkz. AS P.N ET 

Core Web sunucusu uygulamasını Kestrel. 

• Ana bilgisayar filtreleme ara yazılımıekler. 

• ASPNETCORE_FORWARDEDHEADERS_ENABLED = true ise İletilen üstbilgiler ara yazılımı ekler. 

• MS tümleştirmesini etkinleştirilir. I IS varsayılan seçenekleri için bkz. 1 1S ile VVİndovvs üzerinde AS P.N ET 
Core barındırma. 

Bu makalenin ilerleyen kısımlarında Web Apps bölümlerine yönelik tüm uygulama türleri ve ayarlarının 
ayarlan, varsayılan Oluşturucu ayarlarının nasıl geçersiz kılınacağını göstermektedir. 

Framevvork tarafından sunulan hizmetler 

Kayıtlı hizmetler otomatik olarak şunları içerir: 


Ihostapplicationlifetime 








• Ihostlifetime 

• Ihostenvironment/ıvvebhostenvironment 

Framevvork tarafından sunulan hizmetler hakkında daha fazla bilgi için bkz. ASP.NET Core bağımlılık 
ekleme. 

Ihostapplicationlifetime 

Başlatma sonrası ve düzgün kapanma görevlerini işlemek için IHostApplicationLifetime (eski adıyla 
iAppiicationLifetime ) hizmeti herhangi bir sınıfa ekleyin. Arabirimdeki üç özellik, uygulama başlatma ve 
uygulama durdurma olay işleyicisi yöntemlerini kaydetmek için kullanılan iptal belirteçleridir. Arabirim 
Ayrıca bir stopAppiication yöntemi içerir. 

Aşağıdaki örnek, iHostAppiicationLifetime olaylarını kaydeden bir iHostedService uygulamasıdır: 

internal class LifetimeEventsHostedService : IHostedService 

{ 

private readonly ILogger _logger; 

private readonly IHostApplicationLifetime _appLifetime; 

public LifetimeEventsHostedService( 

ILogger<LifetimeEventsHostedService> logger, 

IHostApplicationLifetime appLifetime) 

{ 

_logger = logger; 

_appLifetime = appLifetime; 

} 

public Task StartAsync(CancellationToken cancellationToken) 

{ 

_appLifetime.ApplicationStarted.Register(OnStarted); 

_appLifetime.ApplicationStopping.Register(OnStopping); 

_appLifetime.ApplicationStopped.Register(OnStopped); 

return Task.CompletedTask; 

} 

public Task StopAsync(CancellationToken cancellationToken) 

{ 

return Task.CompletedTask; 

} 

private void OnStarted() 

{ 

_logger.LogInformation("OnStarted has been called."); 

// Perform post-startup activities here 

} 

private void OnStoppingO 

{ 

_logger.LogInformation("OnStopping has been called."); 

// Perform on-stopping activities here 

} 

private void OnStopped() 

{ 

_logger.LogInformation("OnStopped has been called."); 

// Perform post-stopped activities here 

} 

} 







Ihostlifetime 


IHostLifetime uygulama, ana bilgisayar başladığında ve durdurulduğunda kontrol eder. Kaydedilen son 
uygulama kullanılır. 

Microsoft. Extensions.Hosting.Internal.Consolel_ifetime varsayılan IHostLifetime uygulamasıdır. 
ConsoleLifetime : 

• CTRL + C/SIGINT veya SIGDÖNEM için dinler ve StopApplication, başlatma işlemini başlatmak için 
çağırır. 

• RunAsync ve VVaitforshutdovvnasyncgibi uzantıları kaldırır. 

Ihostenvironment 

IHostEnvironment hizmetini bir sınıfa ekleyin ve aşağıdakiler hakkında bilgi alın: 

• ApplicationName 

• EnvironmentName 

• Contentrootyolu 

Web uygulamaları, iHostEnvironment devralan ve WebRootPathekleyen ıwebHostEnvironment arabirimini 
uygular. 

Konak yapılandırması 

Konak yapılandırması, IHostEnvironment uygulamasının özellikleri için kullanılır. 

Konak yapılandırması, ConfigureAppConfigurationiçinde Hostbuildercontext. Configuration içinden 
kullanılabilir. ConfigureAppConfiguration sonra, HostBuilderContext.Configuration uygulama 
yapılandırması ile değiştirilmiştir. 

Konak yapılandırması eklemek için iHostBuiider ConfigureHostConfiguration çağırın. 
configureHostconfiguration , eklenebilir sonuçlarla birden çok kez çağrılabilir. Ana bilgisayar, belirli bir 
anahtardaki bir değeri en son belirleyen seçeneği kullanır. 

Ön ek dotnet_ ve komut satırı bağımsız değişkenlerine sahip ortam değişkeni sağlayıcısı, 
CreateDefaultBuilder tarafından eklenir. Web Apps için aspnetcore_ ön ekine sahip ortam değişkeni 
sağlayıcısı eklenir. Ortam değişkenleri okurken ön ek kaldırılır.Örneğin, aspnetcore_environment için 
ortam değişkeni değeri environment anahtar için ana bilgisayar yapılandırma değeri haline gelir. 

Aşağıdaki örnek ana bilgisayar yapılandırması oluşturur: 

// using Microsoft.Extensions.Configuration; 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureHostConfiguration(configHost => 

{ 

configHost.SetBasePath(Directory.GetCurrentDirectory ()); 
configHost.AddJsonFile("hostsettings.json", optional: true); 
configHost.AddEnvironmentVariables(prefix: "PREFIX_"); 
configHost.AddCommandLine(args); 

})J 


Uygulama yapılandırması 


Uygulama yapılandırması, iHostBuiider ConfigureAppConfiguration çağırarak oluşturulur. 














configureAppConfiguration , eklenebilir sonuçlarla birden çok kez çağrılabilir. Uygulama, belirli bir 
anahtardaki bir değeri en son belirleyen seçeneği kullanır. 

ConfigureAppConfiguration tarafından oluşturulan yapılandırma, sonraki işlemler ve Dİ hizmeti olarak, 
Hostbuildercontext. Configuration konumunda kullanılabilir. Konak yapılandırması, uygulama 
yapılandırmasına de eklenir. 

Daha fazla bilgi için ASP.NET Core yapılandırmakonusuna bakın. 

Tüm uygulama türleri için ayarlar 

Bu bölüm, hem HTTP hem de HTTP olmayan iş yükleri için uygulanan konak ayarlarını listeler.Varsayılan 
olarak, bu ayarları yapılandırmak için kullanılan ortam değişkenlerinin bir dotnet_ veya aspnetcore_ 
öneki olabilir. 

ApplicationName 

Ihostenvironment. ApplicationName özelliği konak oluşturma sırasında konak yapılandırmasından 
ayarlanır. 

Anahtar: ApplicationName 
Tür: dize 

Varsayılan: uygulamanın giriş noktasını içeren derlemenin adı. Ortam değişkeni: 

<PREFIX_> APPLİCATİONNAME 

Bu değeri ayarlamak için ortam değişkenini kullanın. 

Contentrootyolu 

Ihostenvironment. ContentRootPath özelliği, konağın içerik dosyalarını aramaya başladığı yeri belirler. Yol 
yoksa, ana bilgisayar başlatılamaz. 

Anahtar: contentroot 
Tür: dize 

Varsayılan: uygulama derlemesinin bulunduğu klasör. 

Ortam değişkeni: <prefix_>contentroot 

Bu değeri ayarlamak için, ortam değişkenini kullanın veya iHostBuiider"UseContentRoot çağırın: 

Hoşt.CreateDefaultBuilder(args) 

.UseContentRoot("c: \\content-root" ) 

II... 

Daha fazla bilgi için bkz. 

• Temel bilgiler: İçerik kökü 

• VVebRoot 

environmentName 

Ihostenvironment. EnvironmentName özelliği herhangi bir değere ayarlanabilir. Çerçeve tanımlı değerler 
Development , staging ve Production içerir. Değerler büyük/küçük harfe duyarlı değildir. 

Anahtar: ortam 
Tür: dize 

Varsayılan: üretim 

Ortam değişkeni: <prefix_>environment 

Bu değeri ayarlamak için, ortam değişkenini kullanın veya iHostBuiider"UseEnvironment çağırın: 













Hoşt.CreateDefaultBuilder(args) 

.UseEnvironment("Development") 

//... 

ShutdovvnTimeout 

Hostoptions. shutdowntimeout StopAsynciçin zaman aşımını ayarlar. Varsayılan değer beş saniyedir. 
Zaman aşımı süresi boyunca ana bilgisayar: 

• Ihostapplicationlifetime. Applicationdurduruluyortetikler. 

• Üzerinde durmayacak hizmetler için barındırılan Hizmetleri durdurma ve hataları günlüğe kaydetme 
girişimleri. 

Tüm barındırılan hizmetler durmadan önce zaman aşımı süresi dolarsa, uygulama kapandığında kalan 
etkin hizmetler durdurulur. Hizmetler, işlemeyi tamamlamadıklarında bile durur. Hizmetlerin durdurulması 
için ek süre gerekiyorsa, zaman aşımını artırın. 

Anahtar: shutdovvntimeoutseconds 
Tür: in t 

Varsayılan: 5 saniye ortam değişkeni: <prefix_>shutdowntimeoutseconds 

Bu değeri ayarlamak için, ortam değişkenini kullanın veya Hostoptions yapılandırın. Aşağıdaki örnek, 
zaman aşımını 20 saniye olarak ayarlar: 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureServices((hostContext, Services) => 

{ 

Services.Configure<HostOptions>(option => 

{ 

option.ShutdownTimeout = System.TimeSpan.FromSeconds(20); 

}); 

}); 


Web Apps ayarları 

Bazı konak ayarları yalnızca HTTP iş yükleri için geçerlidir. Varsayılan olarak, bu ayarları yapılandırmak için 
kullanılan ortam değişkenlerinin bir dotnet_ veya aspnetcore_ öneki olabilir. 

ıwebHostBuiider genişletme yöntemleri bu ayarlar için kullanılabilir. Uzantı yöntemlerinin nasıl 
çağrılacağını gösteren kod örnekleri, aşağıdaki örnekte olduğu gibi webBuiider bir ıwebHostBuiider 
örneği olduğunu varsayar: 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.CaptureStartupErrors(true); 
webBuilder.UseStartup<Startup>(); 

}); 

CaptureStartupErrors 

faise , başlangıç sırasında hata durumunda çıkış sırasında hatalar oluştu, true , ana bilgisayar başlangıç 
sırasında özel durumları yakalar ve sunucuyu başlatmaya çalışır. 

Anahtar: capturestartuperrors 
Tür: bool ( true veya ı ) 












Varsayılan: uygulama 11S arkasındaki Kestrel ile çalıştırılmadığı müddetçe faise varsayılan olarak true . 
Ortam değişkeni: <prefix_>capturestartuperrors 

Bu değeri ayarlamak için yapılandırma veya çağrı capturestartupErrors kullanın: 

webBuilder.CaptureStartupErrors(true); 

DetailedErrors 

Etkinleştirildiğinde veya ortam Development olduğunda, uygulama ayrıntılı hataları yakalar. 

Anahtar: detailederrors 
Tür: bool ( true veya ı ) 

Varsayılan: faise 

Ortam değişkeni: <prefix_>_detailederrors 

Bu değeri ayarlamak için yapılandırma veya çağrı useSetting kullanın: 

webBuilder.UseSetting(WebHostDefaults.DetailedErrorsKey., "true"); 

HostingStartupAssemblies 

Başlangıçta yüklenecek başlangıç derlemelerinin barındırılması için noktalı virgülle ayrılmış bir dize. 
Yapılandırma değeri boş bir dize olarak varsayılan olsa da, barındırma başlangıç derlemeleri her zaman 
uygulamanın derlemesini içerir. Barındırma başlangıç derlemeleri sağlandığında, uygulama başlangıç 
sırasında ortak hizmetlerini oluşturduğunda yükleme için uygulamanın derlemesine eklenir. 

Anahtar: hostingStartupAssemblies 
Tür: dize 

Varsayılan: boş dize 

Ortam değişkeni: <prefix_>_hostingstartupassemblies 

Bu değeri ayarlamak için yapılandırma veya çağrı UseSetting kullanın: 

webBuilder .UseSetting (WebHostDefau İt s .Hoşt ingSt art upAssembliesKey, "assemblyl;assembly2"); 

HostingStartupExcludeAssemblies 

Başlangıçta dışlamak üzere başlangıç derlemelerinin barındırılması için noktalı virgülle ayrılmış bir dize. 

Anahtar: hostingstartupexcludeassemblies 
Tür: dize 

Varsayılan: boş dize 

Ortam değişkeni: <prefix_>_hostingstartupexcludeassemblies 
Bu değeri ayarlamak için yapılandırma veya çağrı UseSetting kullanın: 

webBuilder.UseSetting(WebHostDefauİts.HoştingStartupExcludeAssembliesKeyj "assemblyl;assembly2"); 

HTTPS_Port 

HTTPS yeniden yönlendirme bağlantı noktası. Https zorlamabölümünde kullanılır. 

Anahtar: https_port 
Tür: dize 

Varsayılan: varsayılan değer ayarlı değildir. 

















Ortam değişkeni: <prefix_>https_port 

Bu değeri ayarlamak için yapılandırma veya çağrı useSetting kullanın: 

webBuilder.UseSetting("https_port ", "8080"); 

Tercih Hostingurl 'Leri 

Konağın ıserver uygulamayla yapılandıranlar yerine ıwebHostBuiider ile yapılandırılan URL'lerde 
dinleme yapıp kullanmayacağını belirtir. 

Anahtar: preferhostingurl 'leri 
Tür: bool ( true veya ı ) 

Varsayılan: true 

Ortam değişkeni: <prefix_>_preferhostingurls 

Bu değeri ayarlamak için, ortam değişkenini kullanın veya PreferHostingUris çağırın: 

webBuilder.PreferHostingUrls(false); 

Koruyucu Thostınstartup 

Uygulamanın derlemesi tarafından yapılandırılan başlatma derlemelerinin barındırılması dahil olmak 
üzere, barındırma başlangıç derlemelerinin otomatik yüklenmesini engeller. Daha fazla bilgi için bkz. 
ASP.NET Core barındırma başlangıç derlemeleri kullanma. 

Anahtar: koruyucu thostingstartup 
Tür: bool ( true veya ı ) 

Varsayılan: false 

Ortam değişkeni: <prefix_>_preventhostingstartup 

Bu değeri ayarlamak için, ortam değişkenini kullanın veya UseSetting çağırın: 

webBuilder.UseSetting(WebHostDefaults.PreventHostingStartupKey, "true"); 

StartupAssembly 

startup sınıfını aramak için bütünleştirilmiş kod. 

Anahtar: startupassembly 
Tür: dize 

Varsayılan: uygulamanın derlemesi 
Ortam değişkeni: <prefix_>startupassembly 

Bu değeri ayarlamak için, ortam değişkenini kullanın veya Usestartup çağırın. Usestartup , bir derleme adı 
( string ) veya bir tür ( TStartup ) alabilir. Birden çok Usestartup yöntemi çağrılırsa, son bir öncelik alır. 

webBuilder.UseStartup("StartupAssemblyName"); 

webBuilder.UseStartup<Startup>(); 

URL'ler 

Sunucu istekleri için dinlemesi gereken bağlantı noktaları ve protokollerle, noktalı virgülle ayrılmış İP 
adresleri listesi veya ana bilgisayar adresleri. Örneğin, http://iocaihost:i23 . Sunucunun belirtilen 





















bağlantı noktasını ve Protokolü (örneğin, http://* :500e ) kullanarak herhangi bir İP adresi veya ana 
bilgisayar için istekleri dinlemesi gerektiğini belirtmek için "*" kullanın. Protokol ( http:// veya https:// ) 
her URL 'y e dahil olmalıdır. Desteklenen biçimler sunucular arasında farklılık gösterir. 

Anahtar: URL 'ler 
Tür: dize 

Varsayılan: http://localhost :5000 ve https://localhost :5001 

Ortam değişkeni: <prefix_>urls 

Bu değeri ayarlamak için, ortam değişkenini kullanın veya useuris çağırın: 

webBullder.Useürls("http://*:5000;http://localhost:5001;https://hoştname:5002"); 

Kestrel kendi uç nokta yapılandırması API 'sine sahiptir.Daha fazla bilgi için bkz. ASP.NET Core Web 
sunucusu uygulamasını Kestrel. 

VVebRoot 

Uygulamanın statik varlıklarının göreli yolu. 

Anahtar: VVebroot 
Tür: dize 

Varsayılan: varsayılan wwwroot . {Content root}/Wwwroot yolu var olmalıdır. Yol yoksa, Hayır-op dosya 
sağlayıcısı kullanılır. 

Ortam değişkeni: <prefix_>webroot 

Bu değeri ayarlamak için, ortam değişkenini kullanın veya usewebRoot çağırın: 

webBuilder.UseWebRoot("public"); 

Daha fazla bilgi için bkz. 

• Temel bilgiler: Web kökü 

• Contentrootyolu 

Konak ömrünü yönetme 

Uygulamayı başlatmak ve durdurmak için oluşturulan IHost uygulamasındaki Yöntemleri çağırın. Bu 
yöntemler, hizmet kapsayıcısında kayıtlı olan tüm IHostedService uygulamalarını etkiler. 

Çalıştır 

Run uygulamayı çalıştırır ve konak kapanana kadar çağıran iş parçacığını engeller. 

RunAsync 

RunAsync uygulamayı çalıştırır ve iptal belirteci veya kapanışı tetiklendiğinde tamamlayan bir Task 
döndürür. 

RunConsoleAsync 

RunConsoleAsync, konsol desteği sağlar, Konağı oluşturur ve başlatır ve CTRL + C/SIGINT ya da 
SIGDÖNEM 'in kapatılmasını bekler. 

Başlangıç 

Start Konağı zaman uyumlu olarak başlatır. 

StartAsync 

StartAsync, Konağı başlatır ve iptal belirteci veya kapanışı tetiklendiğinde tamamlanmış bir Task döndürür. 







VVaitForStartAsync, startAsync başlangıcında çağrılır ve bu, devam etmeden önce tamamlanana kadar 
bekler. Bu, bir dış olay tarafından sinyallene kadar başlatmayı geciktirmek için kullanılabilir. 

StopAsync 

StopAsync, belirtilen zaman aşımı süresi içinde Konağı durdurmaya çalışır. 

VVaitforkapatması 

VVaitForShutdovvn, CTRL + C/SIGINT veya SIGTERM gibi ıhostlifetime tarafından kapanmadan, çağıran 
iş parçacığını engeller. 

WaitForShutdownAsync 

VVaitForShutdovvnAsync, verilen belirteç aracılığıyla kapalı tetiklendiğinde ve StopAsyncçağıran bir Task 
döndürür. 

Dış denetim 

Ana bilgisayar ömrünün doğrudan denetimi dışarıdan çağrılabilen yöntemler kullanılarak sağlanabilir: 

public class Program 
{ 

private IHost _host; 

public Program() 

{ 

_host = new HostBuilder() 

.Build(); 

} 

public async Task StartAsync() 

{ 

_host.StartAsync(); 

} 

public async Task StopAsync() 

{ 

using (_host) 

{ 

await _host.StopAsync(TimeSpan.FromSeconds(5)); 

} 

} 

} 

ASP.NET Core uygulamalar bir konağı yapılandırıp başlatır.Ana bilgisayar, uygulama başlatma ve ömür 
yönetiminden sorumludur. 

Bu makalede, FITTP isteklerini işlemeyin uygulamalar için kullanılan ASP.NET Core genel ana bilgisayar 
(HostBuiider) ele alınmaktadır. 

Genel konağın amacı, daha geniş bir konak senaryolarını etkinleştirmek üzere Web ana bilgisayar API 
'sinden HTTP işlem hattını ayırmak için kullanılır. Yapılandırma, bağımlılık ekleme (dı) ve günlüğe 
kaydetme gibi çapraz kesme özelliğinden genel ana bilgisayar avantajı temel alınarak mesajlaşma, arka 
plan görevleri ve diğer HTTP olmayan iş yükleri. 

Genel ana bilgisayar ASP.NET Core 2,1 1 de yenidir ve Web barındırma senaryolarında uygun değildir. 
Web barındırma senaryolarında Web konağınıkullanın. Genel ana bilgisayar gelecek bir sürümdeki Web 
konağını değiştirecek ve hem HTTP hem de HTTP olmayan senaryolarda birincil ana bilgisayar API 'SI 
olarak görev yapacak. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Örnek uygulamayı Visual Studio Code' de çalıştırırken, dış veya tümleşik bir Term/na/kullanın. Örneği bir 



internaiconsoie çalıştırmayın. 


Konsolu Visual Studio Code ayarlamak için: 

1. . Vscode/Launch. JSON dosyasını açın. 

2. .NET Core başlatma (konsol) yapılandırmasında konsol girişini bulun. Değeri externaiTerminai ya 
da integratedTerminai olarak ayarlayın. 

Giriş 

Genel ana bilgisayar kitaplığı Microsoft.Extensions.Hosting ad alanında kullanılabilir ve Microsoft. 
Extensions. Hosting paketi tarafından sağlanır. Microsoft.Extensions.Hosting paketi Microsoft. 
AspNetCore. app metapackage 'e dahildir (ASP.NET Core 2,1 veya üzeri). 

IHostedService, kod yürütmeye yönelik giriş noktasıdır. Her bir IHostedService uygulama, 
ConfigureServices 'de hizmet kaydısırasında yürütülür. StartAsync, konak başlatıldığında her 
IHostedService çağrılır ve konak düzgün şekilde kapandığında StopAsync ters kayıt sırasında çağrılır. 

Konak ayarlama 

IHostBuilder, kitaplıkların ve uygulamaların Konağı başlatmak, derlemek ve çalıştırmak için kullandığı ana 
bileşendir: 

public static async Task Main(string[] args) 

{ 

var hoşt = new HostBuilder() 

.Build(); 

await host.RunAsync(); 

} 

Seçenekler 

HostOptions IHostseçeneklerini yapılandırın. 

Kapatılma zaman aşımı 

ShutdovvnTimeout, StopAsynczaman aşımını ayarlar. Varsayılan değer beş saniyedir. 

Program.Main ' deki aşağıdaki seçenek yapılandırması, varsayılan beş saniyelik kapatılma zaman aşımını 
20 saniyeye yükseltir: 

var hoşt = new HostBuilder() 

.ConfigureServices((hostContext, Services) => 

{ 

Services.Configure<HostOptions>(option => 

{ 

option.ShutdownTimeout = System.TimeSpan.FromSeconds(20); 

}); 

}) 

.Build(); 


Varsayılan hizmetler 

Aşağıdaki hizmetler konak başlatma sırasında kaydedilir: 
• Ortam (IHostingEnvironment) 








• HostBuilderContext 

• Yapılandırma (IConfiguration) 

• lApplicationLİfetime ( Microsoft. Extensions.Hosting.Internal.ApplicationLifetime ) 

• IHostLifetime ( Microsoft. Extensions.Hosting.Internal.Consolel_ifetime ) 

• IHost 

• Seçenekler (AddOptions) 

• Günlüğe kaydetme (AddLogging) 

Konak yapılandırması 

Ana bilgisayar yapılandırması şu şekilde oluşturulur: 

• içerik kökünü ve ortamıayarlamak için IHostBuilder uzantı yöntemleri çağrılıyor. 

• ConfigureHostConfigurationiçindeki yapılandırma sağlayıcılarından yapılandırma okunuyor. 

Uzantı yöntemleri 
Uygulama anahtarı (ad) 

Ihostingenvironment. ApplicationName özelliği konak oluşturma sırasında konak yapılandırmasından 
ayarlanır. Değeri açıkça ayarlamak için, Hostdefaults. ApplicationKeykullanın: 

Anahtar: ApplicationName 
Tür: dize 

Varsayılan: uygulamanın giriş noktasını içeren derlemenin adı. 

Şunu kullanarak ayarla: HostBuilderContext.HostingEnvironment.ApplicationName 
Ortam değişkeni: <prefix_>applicationname ( <prefix_> isteğe bağlı ve Kullanıcı tanımlı) 

İçerik kökü 

Bu ayar, konağın içerik dosyalarını aramaya başladığı yeri belirler. 

Anahtar: contentroot 
Tür: dize 

Varsayılan: uygulama derlemesinin bulunduğu klasörü varsayılan olarak belirler. 


Şunu kullanarak ayarla: 

UseContentRoot 



Ortam değişkeni: 

<PREFIX_>CONTENTROOT 

( <PREFIX_> 

isteğe bağlı ve Kullanıcı tanımlı) 


Yol yoksa, ana bilgisayar başlatılamaz. 

var hoşt = new HostBuilder() 

.UseContentRoot("c:\\<content-root>") 

Daha fazla bilgi için bkz. temel bilgiler: içerik kökü. 

Ortam 

Uygulamanın ortamınıayarlar. 

Anahtar: ortam 
Tür: dize 

Varsayılan: üretim 


Şunu kullanarak ayarla: 

UseEnvironment 



Ortam değişkeni: 

<PREFIX_>ENVIRONMENT 

( <PREFIX_> 

isteğe bağlı ve Kullanıcı tanımlı) 


Ortam herhangi bir değere ayarlanabilir.Çerçeve tanımlı değerler Development , staging ve Production 
içerir. Değerler büyük/küçük harfe duyarlı değildir. 











var hoşt = new HostBuilder() 

.UseEnvironment(EnvironmentName.Development) 

ConfigureHostConfiguration 

ConfigureHostConfiguration, ana bilgisayar için bir IConfiguration oluşturmak üzere bir 
IConfigurationBuilder kullanır. Konak yapılandırması, uygulamanın derleme sürecinde kullanılmak üzere 
IHostingEnvironment başlatmak için kullanılır. 

ConfigureHostConfiguration, eklenebilir sonuçlarla birden çok kez çağrılabilir. Ana bilgisayar, belirli bir 
anahtardaki bir değeri en son belirleyen seçeneği kullanır. 

Varsayılan olarak hiçbir sağlayıcı dahil değildir. Uygulamanın ConfigureHostConfigurationgereken her 
türlü yapılandırma sağlayıcısını açıkça belirtmeniz gerekir, örneğin: 

• Dosya yapılandırması (örneğin, HostSettings. JSON dosyasından). 

• Ortam değişkeni yapılandırması. 

• Komut satırı bağımsız değişken yapılandırması. 

• Diğer tüm gerekli yapılandırma sağlayıcıları. 

Konağın dosya yapılandırması, uygulamanın temel yolu setBasePath ve ardından dosya yapılandırma 
sağlayıcılarındanbirine yapılan bir çağrı tarafından belirtilerek etkinleştirilir. Örnek uygulama bir JSON 
dosyası, HostSettings. VSOA/kullamr ve dosyanın konak yapılandırma ayarlarını kullanmak için 

AddJsonFile çağırır. 

Konağın ortam değişkeni yapılandırmasını eklemek için konak oluşturucu üzerinde 

AddEnvironmentVariables çağırın. AddEnvironmentvariables , Kullanıcı tanımlı isteğe bağlı bir ön eki kabul 
eder. Örnek uygulama prefix_ önekini kullanır. Ortam değişkenleri okurken ön ek kaldırılır.Örnek 
uygulamanın ana bilgisayarı yapılandırıldığında, prefix_environment için ortam değişkeni değeri 
environment anahtar için ana bilgisayar yapılandırma değeri olur. 

Visual Studio kullanırken veya dotnet run bir uygulama çalıştırırken geliştirme sırasında, 

Öze ilikle r/launchsetting s. JSON dosyasında ortam değişkenleri ayarlanabilir. Visual Studio Code, 
geliştirme sırasında . vscode/Launch. JSON dosyasında ortam değişkenleri ayarlanabilir. Daha fazla bilgi 
için bkz. ASP.NET Core çoklu ortamları kullanma. 

Komut satırı yapılandırması , AddCommandLineçağırarak eklenir. Komut satırı yapılandırması, önceki 
yapılandırma sağlayıcıları tarafından belirtilen yapılandırmayı geçersiz kılmak için komut satırı bağımsız 
değişkenlerine izin vermek üzere en son eklenir. 

HostSettings. JSON: 

{ 

"environment": "Development" 

} 

Ek yapılandırma ApplicationName ve contentroot anahtarlarıyla birlikte etkinleştirilebilir. 
ConfigureHostConfigurationkullanarak HostBuiider yapılandırma örneği: 











var hoşt = new HostBuilder() 

.ConfigureHostConfiguration(configHost => 

{ 

configHost.SetBasePath(Directory.GetCurrentDirectory()); 
configHost.Add3sonFile("hostsettings.json", optional: true); 
configHost.AddEnvironmentVariables(prefix: "PREFIX_"); 
configHost.AddCommand Line(a rgs); 

}) 


ConfigureAppConfiguration 

Uygulama yapılandırması, IHostBuilder uygulamasındaki ConfigureAppConfiguration çağırarak 
oluşturulur. ConfigureAppConfiguration, uygulama için bir IConfiguration oluşturmak üzere bir 
IConfigurationBuilder kullanır. ConfigureAppConfiguration, eklenebilir sonuçlarla birden çok kez 
çağrılabilir. Uygulama, belirli bir anahtardaki bir değeri en son belirleyen seçeneği kullanır. 
ConfigureAppConfiguration tarafından oluşturulan yapılandırma, sonraki işlemler ve Servicesiçin 
Hostbuildercontext. Configuration ' da kullanılabilir. 

Uygulama yapılandırması, Configurehostconfigurationtarafından belirtilen konak yapılandırmasını 
otomatik olarak alır. 

ConfigureAppConfigurationkullanarak örnek uygulama yapılandırması: 

var hoşt = new HostBuilder() 

.ConfigureAppConfiguration((hostContext, configApp) => 

{ 

configApp.SetBasePath(Directory.GetCurrentDirectory()); 
configApp.AddlsonFile("appsettings.json", optional: true); 
configApp.AddlsonFile( 

$"appsettings.{hostContext.HoştingEnvironment.EnvironmentName}.json", 
optional: true); 

configApp.AddEnvironmentVariables(prefix: "PREFIX_"); 
configApp.AddCommandLine(args); 

}) 


appSettings. JSON: 


"Logging": { 

"LogLevel": { 

"Default": "Warning" 

} 

b 

"AllowedHosts": 


appSettings. Development. JSON: 

{ 

"Logging": { 

"LogLevel": { 

"Default": "Debug", 
"System": "Information", 
"Microsoft": "Information" 

} 

} 

} 






appSettings. Productiorı. JSON: 


{ 

"Logging": { 

"LogLevel": { 

"Default": "Error"., 
"System": "Information ", 
"Microsoft": "Information" 

} 

} 

} 


Ayar dosyalarını çıkış dizinine taşımak için, ayarlar dosyalarını proje dosyasında MSBuild proje öğeleri 
olarak belirtin. Örnek uygulama, JSON uygulama ayarları dosyalarını ve HostSettings. JSON dosyasını şu 
<content> öğesiyle taşıdıkça: 

<ItemGroup> 

<Content Include="**\*.json" Exclude="bin\**\*;obj\**\*" 

CopyToOutputDirectory="PreserveNewest" /> 

</ItemGroup> 


NOTE 

AddJsonFile ve AddEnvironmentVariables gibi yapılandırma uzantısı yöntemleri, Microsoft. Extensions. 
Configuration. JSON ve Microsoft. Extensions. Configuration. EnvironmentVariablesgibi ek NuGet paketleri 
gerektirir. Uygulama Microsoft. AspNetCore. app metapackage'i kullanmadığı takdirde, bu paketlerin temel 
Microsoft. Extensions. Configuration paketine ek olarak projeye eklenmesi gerekir. Daha fazla bilgi için bkz. ASP.NET 
Core yapılandırma. 


ConfigureServices 

ConfigureServices, uygulamanın bağımlılık ekleme kapsayıcısına hizmet ekler. ConfigureServices, 
eklenebilir sonuçlarla birden çok kez çağrılabilir. 

Barındırılan hizmet, IHostedService arabirimini uygulayan bir arka plan görevi mantığı içeren bir sınıftır. 
Daha fazla bilgi için bkz. AS P.N ET Core içinde barındırılan hizmetlerle arka plan görevleri. 

Örnek uygulama , yaşam süresi olayları, LifetimeEventsHostedService ve zaman aşımına uğramış bir arka 
plan görevi olan TimedHostedService uygulamaya bir hizmet eklemek için AddHostedService uzantısı 
yöntemini kullanır: 

var hoşt = new HostBuilder() 

.ConfigureServices((hostContext, Services) => 

{ 

if (hostContext.HostingEnvironment.IsDevelopment()) 

{ 

// Development service configuration 

} 

else 

{ 

// Non-development service configuration 

} 

Services.AddHostedService<LifetimeEventsHostedService>(); 

Services.AddHostedService<TimedHostedService>(); 

}) 








ConfigureLogging 

ConfigureLogging, belirtilen ILoggingBuilderyapılandırmak için bir temsilci ekler. ConfigureLogging, 
eklenebilir sonuçlarla birden çok kez çağrılabilir. 

var hoşt = new HostBuilder() 

.ConfigureLogging((hostContext, configLogging) => 

{ 

configLogging.AddConsole(); 
configLogging.AddDebug(); 

}) 


UseConsoleLifetime 

UseConsoleLifetime, CTRL + C/SIGINT veya SIGTERIM dinler ve StopApplication çağırarak, bu işlemi 
başlatmak için çağırır. RunAsyncve Waitforshutdownasyncgibi uzantıları kaldırır. UseConsoleLifetime 
Microsoft. Extensions .Hoşt ing. internai .consoleLif et ime varsayılan ömür uygulamasıyla önceden 
kaydedilir. Kaydedilen son yaşam süresi kullanılır. 

var hoşt = new HostBuilder() 

.UseConsoleLifetime() 


Kapsayıcı yapılandırması 

Diğer kapsayıcıları takmayı desteklemek için, ana bilgisayar bir 

IServiceProviderFactory<TContainerBuilder>kabul edebilir. Fabrika sağlamak, dı kapsayıcı kaydının bir 
parçası değildir, ancak bunun yerine somut dı kapsayıcısını oluşturmak için kullanılan bir konak iç sidir. 
Useserviceproviderfactory (ıvıceproviderfactory<TContainerBuilder>) , uygulamanın hizmet sağlayıcısını 
oluşturmak için kullanılan varsayılan fabrikası geçersiz kılar. 

Özel kapsayıcı yapılandırması ConfigureContainer yöntemi tarafından yönetilir. ConfigureContainer, 
temel ana bilgisayar API 'sinin üstünde kapsayıcıyı yapılandırmak için kesin olarak belirlenmiş bir deneyim 
sağlar. ConfigureContainer, eklenebilir sonuçlarla birden çok kez çağrılabilir. 

Uygulama için bir hizmet kapsayıcısı oluşturun: 

namespace GenericHostSample 
{ 

internal class ServiceContainer 
{ 

} 

} 


Hizmet kapsayıcısı fabrikası sağlama: 





using System; 

using Microsoft. Extensions .Dependencylnjection; 

namespace GenericHostSample 

{ 

internal class ServiceContainerFactory : 

IServiceProviderFactory<ServiceContainer> 

{ 

public ServiceContainer CreateBuilder( 
IServiceCollection Services) 

{ 

return new ServiceContainer(); 

} 

public IServiceProvider CreateServiceProvider( 
ServiceContainer containerBuilder) 

{ 

throw new NotImplementedException(); 

} 

} 

} 


Fabrika 'yi kullanın ve uygulama için özel hizmet kapsayıcısını yapılandırın: 

var hoşt = new HostBuilder() 

.UseServiceProviderFactory<ServiceContainer>(new ServiceContainerFactory()) 
.ConfigureContainer<ServiceContainer>((hostContext, Container) => 

{ 

}) 


Genişletilebilirlik 

Konak genişletilebilirliği IHostBuilderuzantı yöntemleriyle gerçekleştirilir. Aşağıdaki örnek, bir genişletme 
yönteminin ASP.NET Core içinde barındırılan hizmetlerle arka plan görevlerigösterilen 
Timedhostedservice örneği ile bir IHostBuilder uygulamasını nasıl genişlettiğini gösterir. 

var hoşt = new HostBuilder() 

.UseHostedService<TimedHostedService>() 

.Build(); 

await host.StartAsync(); 

Uygulama, t geçirilen barındırılan hizmeti kaydetmek için useHostedService uzantısı yöntemini 
oluşturur: 

using System; 

using Microsoft. Extensions .Dependencylnjection; 
using Microsoft. Extensions .Hosting; 

public static class Extensions 

{ 

public static IHostBuilder UseHostedService<T>(this IHostBuilder hostBuilder) 
where T : class, IHostedService, IOisposable 

{ 

return hostBuilder.ConfigureServices(services => 

Services.AddHostedService<T>()); 

} 

} 





Konağı yönetme 

IHost uygulaması, hizmet kapsayıcısında kayıtlı IHostedService uygulamalarını başlatma ve durdurma 
sorumluluğundadır. 

Çalıştır 

Run uygulamayı çalıştırır ve konak kapanana kadar çağıran iş parçacığını engeller: 

public class Program 
{ 

public void Main(string[] args) 

{ 

var hoşt = new HostBuilder() 

.Build(); 

host.Run(); 

} 

} 


RunAsync 

RunAsync uygulamayı çalıştırır ve iptal belirteci veya kapanışı tetiklendiğinde tamamlayan bir Task 
döndürür: 

public class Program 
{ 

public static async Task Main(string[] args) 

{ 

var hoşt = new HostBuilder() 

.Build(); 

await host.RunAsync(); 

} 

} 


RunConsoleAsync 

RunConsoleAsync, konsol desteği sağlar, Konağı oluşturur ve başlatır ve CTRL + C/SIGINT ya da 
SIGDÖNEM 'in kapatılmasını bekler. 

public class Program 
{ 

public static async Task Main(string[] args) 

{ 

var hostBuilder = new HostBuilder(); 
await hostBuilder.RunConsoleAsync(); 

} 

} 


Başlangıç ve StopAsync 

Start Konağı zaman uyumlu olarak başlatır. 


StopAsync, belirtilen zaman aşımı süresi içinde Konağı durdurmaya çalışır. 





public class Program 

{ 

public static async Task Main(string[] args) 

{ 

var hoşt = new HostBuilder() 

.Build(); 

using (hoşt) 

{ 

host.Start(); 

await hoşt.StopAsync(TimeSpan.FromSeconds(5)); 

} 

} 

} 


StartAsync ve StopAsync 

StartAsync uygulamayı başlatır. 

StopAsync uygulamayı sonlandırır. 

public class Program 

{ 

public static async Task Main(string[] args) 

{ 

var hoşt = new HostBuilder() 

.Build(); 

using (hoşt) 

{ 

await host.StartAsync(); 
await host.StopAsync(); 

} 

} 

} 


Waitforkapatması 

VVaitForShutdovvn, Microsoft.Extensions.Hosting.Internal.ConsoleLifetime (CTRL + C/SIGINT veya 
SIGTERIM dinler) gibi IHostLifetimearacılığıyla tetiklenir WaitForShutdown StopAsyncçağırır. 

public class Program 

{ 

public void Main(string[] args) 

{ 

var hoşt = new HostBuilder() 

.Build(); 

using (hoşt) 

{ 

host.Start(); 

hoşt.WaitForShutdown(); 

} 

} 

} 


WaitForShutdownAsync 

VVaitForShutdovvnAsync, verilen belirteç aracılığıyla kapalı tetiklendiğinde ve StopAsyncçağıran bir Task 
döndürür. 






public class Program 
{ 

public static async Task Main(string[] args) 
{ 

var hoşt = new HostBuilder() 

.Build(); 

using (hoşt) 

{ 

await host.StartAsync(); 

await hoşt.WaitForShutdownAsync(); 

} 

} 

} 


Dış denetim 

Ana bilgisayarın dış denetimine, dışarıdan çağrılabilen yöntemler kullanılarak ulaşılabilecek: 

public class Program 
{ 

private IHost _host; 

public Program() 

{ 

_host = new HostBuilder() 

.Build(); 

} 

public async Task StartAsync() 

{ 

_host.StartAsync(); 

} 

public async Task StopAsync() 

{ 

using (_host) 

{ 

await _host.StopAsync(TimeSpan.FromSeconds(5)); 

} 

} 

} 

VVaitForStartAsync, StartAsyncbaşlangıcında çağrılır ve bu, devam etmeden önce tamamlanana kadar 
bekler. Bu, bir dış olay tarafından sinyallene kadar başlatmayı geciktirmek için kullanılabilir. 

Ihostingenvironment arabirimi 

IHostingEnvironment, uygulamanın barındırma ortamı hakkında bilgi sağlar. Özelliklerini ve uzantı 
yöntemlerini kullanmak için IHostingEnvironment almak üzere Oluşturucu Ekleme kullanın: 




public elass MyClass 

{ 

private readonly IHostingEnvironment _env; 

public MyClass(IHostingEnvironment env) 

{ 

_env = env; 

> 


public void DoSomething() 

{ 

var environmentName = _env.EnvironmentName; 

} 

} 


Daha fazla bilgi için bkz. ASP.N ET Core çoklu ortamları kullanma. 

lapplicationlifetime arabirimi 

lApplicationLifetime, düzgün kapanma istekleri dahil olmak üzere başlatma sonrası ve kapanma 
etkinliklerine izin verir. Arabirimdeki üç özellik, başlangıç ve kapalı olayları tanımlayan Action yöntemlerini 
kaydetmek için kullanılan iptal belirteçleridir. 

İPTAL BELİRTECİ 

TETIKLENDIĞI ZAMAN... 

ApplicationStarted 

Konak tam olarak başlatıldı. 

ApplicationStopped 

Ana bilgisayar düzgün kapanma işlemini tamamlıyor.Tüm 
isteklerin işlenmesi gerekir. Bu olay tamamlanana kadar 
kapalı bloklar. 


ApplicationStopping Ana bilgisayar düzgün bir şekilde kapanma 

gerçekleştiriyor, istekler hala işliyor olabilir. Bu olay 
tamamlanana kadar kapalı bloklar. 


Constructor-lApplicationLifetime hizmetini herhangi bir sınıfa ekleyin. Örnek uygulama , olayları 
kaydetmek için bir LifetimeEventsHostedService sınıfına (bir IHostedService uygulaması) Oluşturucu 
ekleme işlemini kullanır. 


LifetimeEventsHostedService.es : 



internal class LifetimeEventsHostedService : IHostedService 

{ 

private readonly ILogger _logger; 

private readonly IApplicationLifetime _appLifetime; 

public LifetimeEventsHostedService( 

ILogger<LifetimeEventsHostedService> logger, 
IApplicationLifetime appLifetime) 

{ 

_logger = logger; 

_appLifetime = appLifetime; 

} 

public Task StartAsync(CancellationToken cancellationToken) 

{ 

_appLifetime.ApplicationStarted.Register(OnStarted); 
_appLifetime.ApplicationStopping.Register(OnStopping); 
_appLifetime.ApplicationStopped.Register(OnStopped); 

return Task.CompletedTask; 

} 

public Task StopAsync(CancellationToken cancellationToken) 

{ 

return Task.CompletedTask; 

} 

private void OnStarted() 

{ 

_logger.LogInformation("OnStarted has been called."); 

// Perform post-startup activities here 

} 

private void OnStoppingO 

{ 

_logger.LogInformation("OnStopping has been called."); 
// Perform on-stopping activities here 

} 

private void OnStopped() 

{ 

_logger.LogInformation("OnStopped has been called."); 

// Perform post-stopped activities here 

} 

} 


StopApplication, uygulamanın sonlandırılmasını ister. Aşağıdaki sınıf, sınıfın shutdown yöntemi 
çağrıldığında bir uygulamayı düzgün bir şekilde kapatmak için StopApplication kullanır: 




public class MyClass 

{ 

private readonly IApplicationLifetime _appLifetime; 

public MyClass(IApplicationLifetime appLifetime) 

{ 

_appLifetime = appLifetime; 

} 

public void Shutdown() 

{ 

_appLifetime.StopApplication(); 

} 


Ek kaynaklar 

• ASP.NET Core içinde barındırılan hizmetlerle arka plan görevleri 



ASPNET Core Web ana bilgisayarı 
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ASP.NET Core uygulamalar bir Konoğiyapılandırıp başlatır. Uygulama başlatma ve ömür yönetimi için konak 
sorumludur. Ana bilgisayar, en azından bir sunucu ve bir istek işleme işlem hattı yapılandırır.Konak, günlüğe 
kaydetme, bağımlılık ekleme ve yapılandırma de ayarlayabilir. 

Bu makalede, yalnızca geriye dönük uyumluluk için kullanılabilen Web ana bilgisayarı ele alınmaktadır. Genel 
ana bilgisayar tüm uygulama türleri için önerilir. 

Bu makale, Web uygulamalarını barındırmak için olan Web konağını ele alır. Diğer uygulama türleri için genel 
Konağıkullanın. 


Konak ayarlama 


Ivvebhostbuilder'ın bir örneğini kullanarak bir konak oluşturun. Bu genellikle uygulamanın giriş noktasında 
Main yöntemi olarak gerçekleştirilir. 


Proje şablonlarında, Main program.es' de bulunur. Tipik bir uygulama, bir konak ayarlamaya başlamak için 

Createdefaultbuilder çağırır: 


public elass Program 
{ 

public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build().Run(); 

} 


} 


public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 
WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>(); 


createDefaultBuiider çağıran kod, Oluşturucu nesnesinde Run çağıran Main koddan ayıran 
createwebHostBuiider adlı bir yöntemde bulunur. Entity Framevvork Core araçlarınıkullanıyorsanız bu ayrım 
gereklidir. Araçlar, uygulamayı çalıştırmadan ana bilgisayarı yapılandırmak için tasarım zamanında 
çağırabilecekleri bir createwebHostBuiider yöntemi bulmayı bekler. Diğer bir seçenek de 
!DesignTimeDbContextFactory uygulamaktır. Daha fazla bilgi için bkz. Tasarım zamanı DbContext oluşturma. 


CreateDefaultBuiider aşağıdaki görevleri gerçekleştirir: 


• Kestrel sunucusunu, uygulamanın barındırma yapılandırma sağlayıcılarını kullanarak Web sunucusu olarak 
yapılandırır. Kestrel sunucusunun varsayılan seçenekleri için bkz. ASP.NET Core Web sunucusu 
uygulamasını Kestrel. 

• içerik kökünü Directory. GetCurrentDirectorytarafından döndürülen yola ayarlar. 

• Ana bilgisayar yapılandırmasını şuradan yükler: 

o aspnetcore_ ön eki olan ortam değişkenleri (örneğin, aspnetcore_environment ). 
o Komut satırı bağımsız değişkenleri. 

• Aşağıdaki sırayla uygulama yapılandırmasını yükler: 
o appSettings. JSON. 

o appSettings. {Environment}. JSON. 














o Uygulama, giriş derlemesini kullanarak Deveiopment ortamda çalıştırıldığında gizli Yöneticisi . 
o Ortam değişkenleri, 
o Komut satırı bağımsız değişkenleri. 

• Konsol ve hata ayıklama çıkışı için günlüğe kaydetmeyi yapılandırır. Günlüğe kaydetme, bir appSettings. 
JSON veya appSettings 'in günlük yapılandırma bölümünde belirtilen günlük filtreleme kurallarını içerir. { 
Environmerıt}. JSON dosyası. 

• ASP.NET Core MODÜLÜYLEIIS 'nin arkasında çalışırken, CreateDefaultBuiider , uygulamanın temel 
adresini ve bağlantı noktasını yapılandıran 11S tümleştirmesinimümkün bir şekilde yapılandırır. IIS 
tümleştirmesi, uygulamayı başlatma hatalarını yakalamayade yapılandırır. IIS varsayılan seçenekleri için bkz. 
IIS ile VVİndovvs üzerinde ASP.NET Core barındırma. 

• Uygulamanın ortamı geliştirme ise, Serviceprovideroptions. ValidateScopes öğesini true olarak ayarlar. 
Daha fazla bilgi için bkz. kapsam doğrulaması. 

CreateDefaultBuiider tarafından tanımlanan yapılandırma, Configureappconfiguration, configureloggingve 
ıvvebhostbuilder'ın diğer yöntemleri ve genişletme yöntemleri tarafından geçersiz kılınabilir ve genişletilebilir. 
Birkaç örnek aşağıda verilmiştir: 

• Configureappconfiguration , uygulama için ek ıconfiguration belirtmek için kullanılır. Aşağıdaki 

configureAppConfiguration çağrısı, appSettings. xml dosyasına uygulama yapılandırmasını dahil etmek 
için bir temsilci ekler. configureAppConfiguration birden çok kez çağrılabilir. Bu yapılandırmanın ana 
bilgisayar için (örneğin, sunucu URL 'Leri veya ortam) uygulanmadığını unutmayın. Konak yapılandırma 
değerleri bölümüne bakın. 

WebHost.CreateDefaultBuilder(args) 

.ConfigureAppConfiguration((hostingContext, config) => 

{ 

config.AddXmlFile("appsettings.xml", optional: true, reloadOnChange: true); 

}) 

• Aşağıdaki configureLogging çağrısı, en düşük günlük düzeyi (Setminimumlevel) değerini LogLevel. 
VVarningolarak yapılandırmak için bir temsilci ekler. Bu ayar appSettings 'teki ayarları geçersiz kılar. 
Deveiopment. JSON ( LogLevel.Debug ) ve appSettings. Production. JSON ( LogLevel. Error ) 

CreateDefaultBuiider tarafından yapılandırıldı. ConfigureLogging birden çok kez çağrılabilir. 

WebHost.CreateDefaultBuilder(args) 

.ConfigureLogging(logging => 

{ 

logging. SetMinimumLevel( LogLevel .lAİarning); 

}) 

• Aşağıdaki configureKestrel çağrısı varsayılan limitleri geçersiz kılar. MaxRequestBodySize , Kestrel 

CreateDefaultBuiider tarafından yapılandırıldığında oluşturulan 30.000.000 bayttan oluşur: 

WebHost.CreateDefaultBuilder(args) 

.ConfigureKestrel((context, options) => 

{ 

options.Limits.MaxRequestBodySize = 20000000; 

}); 

• Aşağıdaki UseKestrel çağrısı, varsayılan limitleri geçersiz kılar. MaxRequestBodySize , Kestrel 

CreateDefaultBuiider tarafından yapılandırıldığında oluşturulan 30.000.000 bayttan oluşur: 














WebHost.CreateDefaultBuilder(args) 

.UseKestr8İ(options => 

{ 

options.Limits.MaxRequestBodySize = 20000000; 

}); 

içerik kökü , konağın MVC görünüm dosyaları gibi içerik dosyalarını arayacağı yeri belirler. Uygulama, projenin 
kök klasöründen başlatıldığında, projenin kök klasörü içerik kökü olarak kullanılır. Bu, Visual Studio 'da ve 
DotNet yeni şablonlardakullanılan varsayılandır. 


Uygulama yapılandırması hakkında daha fazla bilgi için bkz. ASP.NET Core yapılandırma. 



birden çok çağrı önceki ayarların yerini alır. 

Ana bilgisayar yapılandırma değerleri 

Webhostbuilder , ana bilgisayar yapılandırma değerlerini ayarlamak için aşağıdaki yaklaşımları kullanır: 

• ASPNETCORE_{configurationKey} biçimindeki ortam değişkenlerini içeren konak Oluşturucu yapılandırması. 
Örneğin: aspnetcore_environment 

• Usecontentroot ve useconfiguration gibi uzantılar ( geçersiz kılma yapılandırması bölümüne bakın). 

• Usesetting ve ilişkili anahtar. useSetting ile bir değer ayarlarken, değer türünden bağımsız olarak bir dize 
olarak ayarlanır. 

Konak, bir değeri en son ayarlayan seçeneği kullanır. Daha fazla bilgi için, sonraki bölümde yapılandırmayı 
geçersiz kılma bölümüne bakın. 

Uygulama anahtarı (ad) 

ıwebHostEnvironment.AppiicationName özelliği, konak oluşturma sırasında Usestartup veya Configure 
çağrıldığında otomatik olarak ayarlanır. Değer, uygulamanın giriş noktasını içeren derlemenin adına ayarlanır. 
Değeri açıkça ayarlamak için VVebhostdefaults. ApplicationKeykullanın: 

Konak oluşturma sırasında Usestartup veya Configure çağrıldığında, ıhostingenvironment. AppiicationName 
özelliği otomatik olarak ayarlanır. Değer, uygulamanın giriş noktasını içeren derlemenin adına ayarlanır. Değeri 
açıkça ayarlamak için VVebhostdefaults. ApplicationKeykullanın: 

Anahtar: AppiicationName 
Tür: dize 

Varsayılan: uygulamanın giriş noktasını içeren derlemenin adı. 

Şunu kullanarak ayarla: usesetting 
Ortam değişkeni: aspnetcore_applicationname 

WebHost.CreateDefaultBuilder(args) 

.UseSetting(UebHostDefaults.ApplicationKey, "CustomApplicationName") 















Yakalama başlatma hataları 

Bu ayar, başlatma hatalarının yakalanmasını denetler. 

Anahtar: capturestartuperrors 
Tür: bool ( true veya ı) 

Varsayılan: uygulama MS arkasındaki Kestrel ile çalıştırılmadığı müddetçe faise varsayılan olarak true . 
Şunu kullanarak ayarla: capturestartupErrors 
Ortam değişkeni: aspnetcore_capturestartuperrors 

faise , başlangıç sırasında hata durumunda çıkış sırasında hatalar oluştu, true , ana bilgisayar başlangıç 
sırasında özel durumları yakalar ve sunucuyu başlatmaya çalışır. 

WebHost.CreateDefaultBuilder(args) 

.CaptureStartupErrors(true) 

İçerik kökü 

Bu ayar AS P.N ET Core içerik dosyalarını aramaya başladığı yeri belirler. 

Anahtar: contentroot 
Tür: dize 

Varsayılan: uygulama derlemesinin bulunduğu klasörü varsayılan olarak belirler. 

Şunu kullanarak ayarla: useContentRoot 
Ortam değişkeni: aspnetcore_contentroot 

İçerik kökü, Web kökününtemel yolu olarak da kullanılır, içerik kök yolu yoksa, ana bilgisayar başlatılamaz. 

WebHost.CreateDefaultBuilder(args) 

. UseContentRoot("c:\\<content-root>") 

Daha fazla bilgi için bkz.: 

• Temel bilgiler: İçerik kökü 

• Web kökü 

Ayrıntılı hatalar 

Ayrıntılı hataların yakalanıp yakalanmayacağını belirler. 

Anahtar: detailederrors 
Tür: bool ( true veya ı) 

Varsayılan: faise 

Şunu kullanarak ayarla: useSetting 
Ortam değişkeni: aspnetcore_detailederrors 

Etkinleştirildiğinde (veya ortam Development olarak ayarlandığında), uygulama ayrıntılı özel durumları yakalar. 

WebHost.CreateDefaultBuilder(args) 

.UseSetting(WebHostDefaults.DetailedErrorsKeyj "true") 

Ortam 

Uygulamanın ortamını ayarlar. 

Anahtar: ortam 
Tür: dize 

Varsayılan: üretim 













Şunu kullanarak ayarla: useEnvironment 
Ortam değişkeni: aspnetcore_environment 

Ortam herhangi bir değere ayarlanabilir. Çerçeve tanımlı değerler Development , staging ve Production içerir. 
Değerler büyük/küçük harfe duyarlı değildir.Varsayılan olarak, ortam aspnetcore_environment ortam 
değişkeninden okunurdur. Visual Studiokullanılırken, launchsettings. JSON dosyasında ortam değişkenleri 
ayarlanabilir. Daha fazla bilgi için bkz. ASP.N ET Core çoklu ortamları kullanma. 

UebHost.CreateDefaultBuilder(args) 

. UseEnvironment (Environment Name. Development) 

Başlangıç derlemelerini barındırma 

Uygulamanın barındırma başlangıç derlemelerini ayarlar. 

Anahtar: hostingStartupAssemblies 
Tür: dize 

Varsayılan: boş dize 

Şunu kullanarak ayarla: useSetting 

Ortam değişkeni: aspnetcore_hostingstartupassemblies 

Başlangıçta yüklenecek başlangıç derlemelerinin barındırılması için noktalı virgülle ayrılmış bir dize. 

Yapılandırma değeri boş bir dize olarak varsayılan olsa da, barındırma başlangıç derlemeleri her zaman 
uygulamanın derlemesini içerir. Barındırma başlangıç derlemeleri sağlandığında, uygulama başlangıç sırasında 
ortak hizmetlerini oluşturduğunda yükleme için uygulamanın derlemesine eklenir. 

UebHost.CreateDefaultBuilder(args) 

.UseSetting(UebHostDefaults.HostingStartupAssembliesKey, "assemblylj assembly2") 

HTTPS bağlantı noktası 

HTTPS yeniden yönlendirme bağlantı noktasını ayarlayın. Https zorlamabölümünde kullanılır. 

Anahtar: https_port türü: dize varsayılan: varsayılan değer ayarlı değildir. Şunu kullanarak ayarla: 
useSetting ortam değişkeni: aspnetcore_https_port 

UebHost.CreateDefaultBuilder(args) 

.UseSetting("https_pont ", "8080") 

Barındırma başlatma derlemeleri dışlama 

Başlangıçta dışlamak üzere başlangıç derlemelerinin barındırılması için noktalı virgülle ayrılmış bir dize. 

Anahtar: hostingstartupexcludeassemblies 
Tür: dize 

Varsayılan: boş dize 

Şunu kullanarak ayarla: useSetting 

Ortam değişkeni: aspnetcore_hostingstartupexcludeassemblies 

UebHost.CreateDefaultBuilder(args) 

.UseSetting(UebHostDefaults.HoştingStartupExcludeAssembliesKey, "assemblyl;assembly2") 

Barındırma URL 'Lerini tercih et 

Konağın ıserver uygulamayla yapılandıranlar yerine uebHostBuiider ile yapılandırılan URL'lerde dinleme 















yapıp kullanmayacağını belirtir. 

Anahtar: preferhostingurl ‘leri 
Tür: booi ( true veya ı) 

Varsayılan: true 

Şunu kullanarak ayarla: PreferHostinguris 
Ortam değişkeni: aspnetcore_preferhostingurls 

UebHost.CreateDefaultBuilder(args) 

.PreferHostingUrls(false) 

Barındırma başlangıcını engelle 

Uygulamanın derlemesi tarafından yapılandırılan başlatma derlemelerinin barındırılması dahil olmak üzere, 
barındırma başlangıç derlemelerinin otomatik yüklenmesini engeller. Daha fazla bilgi için bkz. ASP.NET Core 
barındırma başlangıç derlemeleri kullanma. 

Anahtar: koruyucu thostingstartup 
Tür: bool ( true veya ı) 

Varsayılan: false 

Şunu kullanarak ayarla: useSetting 

Ortam değişkeni: aspnetcore_preventhostingstartup 

WebHost.CreateDefaultBuilder(args) 

.UseSetting(WebHostDefaults.PreventHostingStartupKey., "true") 

Sunucu URL 'Leri 

Sunucunun istekler için dinlemesi gereken bağlantı noktaları ve protokoller içeren İP adreslerini veya ana 
bilgisayar adreslerini gösterir. 

Anahtar: URL 1er 
Tür: dize 

Varsayılan: http://localhost:5000 
Şunu kullanarak ayarla: useuris 
Ortam değişkeni: aspnetcore_urls 

Noktalı virgülle ayrılmış olarak ayarlayın (;) sunucunun yanıtlaması gereken URL ön eklerinin listesi. Örneğin: 
http://iocaihost:i23 Sunucunun belirtilen bağlantı noktasını ve Protokolü (örneğin, http://* : 500 e ) 
kullanarak herhangi bir İP adresi veya ana bilgisayar için istekleri dinlemesi gerektiğini belirtmek için "*" 
kullanın. Protokol ( http:// veya https:// ) her URL 'y e dahil olmalıdır.Desteklenen biçimler sunucular 
arasında farklılık gösterir. 

WebHost.CreateDefaultBuilder(args) 

.UseUrls("http://*:5000;http://localhost:5001jhttps://hoştname:5002") 

Kestrel kendi uç nokta yapılandırması API 'sine sahiptir.Daha fazla bilgi için bkz. ASP.NET Core Web sunucusu 
uygulamasını Kestrel. 

Kapatılma zaman aşımı 

Web konağının kapanması için beklenecek süreyi belirtir. 

Anahtar: shutdovvntimeoutseconds 
Tür: in t 
Varsayılan: 5 












Şunu kullanarak ayarla: useShutdownTimeout 
Ortam değişkeni: aspnetcore_shutdowntimeoutseconds 

Anahtar, UseSetting (örneğin, .UseSettingCl/JebHostDefaults.ShutdovmTirrıeoutKey, "10") ) bir int kabul etse de, 
useshutdovvntimeout genişletme yöntemi bir TimeSpanalır. 

Zaman aşımı süresi boyunca barındırma: 

• lapplicationlifetime. Applicationdurduruluyoröğesini tetikler. 

• Üzerinde durmayacak hizmetlerin hatalarını günlüğe kaydetmek için barındırılan hizmetleri durdurmaya 
çalışır. 

Tüm barındırılan hizmetler durmadan önce zaman aşımı süresi dolarsa, uygulama kapandığında kalan etkin 
hizmetler durdurulur. Hizmetler, işlemeyi tamamlamadıklarında bile durur.Hizmetlerin durdurulması için ek 
süre gerekiyorsa, zaman aşımını artırın. 

UebHost.CreateDefaultBuilder(args) 

.UseShutdownTimeout(TimeSpan.FromSeconds(10)) 

Başlangıç derlemesi 

startup sınıfı için arama yapılacak derlemeyi belirler. 

Anahtar: startupassembly 
Tür: dize 

Varsayılan: uygulamanın derlemesi 

Şunu kullanarak ayarla: usestartup 

Ortam değişkeni: aspnetcore_startupassembly 

Ada ( string ) veya türe ( TStartup ) göre derlemeye başvurulabilir. Birden çok usestartup yöntemi çağrılırsa, 
son bir öncelik alır. 

WebHost.CreateDefaultBuilder(args) 

.UseStartupC'StartupAssemblyName") 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<TStartup>() 

Web kökü 

Uygulamanın statik varlıklarının göreli yolunu ayarlar. 

Anahtar: VVebroot 
Tür: dize 

Varsayılan: varsayılan wwwroot . {Content root}/Wwwroot yolu var olmalıdır. Yol yoksa, Hayır-op dosya 
sağlayıcısı kullanılır. 

Şunu kullanarak ayarla: usewebRoot 
Ortam değişkeni: aspnetcore_webroot 

UebHost.CreateDefaultBuilder(args) 

.UseWebRoot("public") 

Daha fazla bilgi için bkz.: 


• Temel bilgiler: Web kökü 













• içerik kökü 


Geçersiz kılma yapılandırması 

Web konağını yapılandırmak için yapılandırma kullanın. Aşağıdaki örnekte, konak yapılandırması isteğe bağlı 
olarak bir HostSettings. JSON dosyasında belirtilir. HostSettings. JSON dosyasından yüklenen herhangi bir 
yapılandırma komut satırı bağımsız değişkenleri tarafından geçersiz kılınabilir. Oluşturulan yapılandırma ( 
config ), Konağı Useconfigurationile yapılandırmak için kullanılır. ıwebHostBuiider yapılandırması uygulamanın 
yapılandırmasına eklenir, ancak — configureAppConfiguration ıwebHostBuiider yapılandırmasını etkilemez. 

HostSettings. JSON config ile useuris tarafından belirtilen yapılandırmayı geçersiz kılma, komut satırı 
bağımsız değişkeni yapılandırma saniyesi: 

public class Program 

{ 

public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build().Run(); 

} 

public static II/debHostBuilder CreateWebHostBuilder(string[] args) 

{ 

var config = new ConfigurationBuilder() 

.SetBasePath(Directory.GetCurrentDirectory()) 

.AddJsonFile("hostsettings.json", optional: true) 

.AddCommandLine(args) 

.Build(); 

return WebHost.CreateDefaultBuilder(args) 

.UseUrls("http://*:5000") 

. UseConfiguration(config) 

.Configure(app => 

{ 

app.Run(context => 

context.Response.WriteAsync("HellOj World!")); 

}); 

} 

} 

HostSettings. JSON: 

{ 

urls: "http://*:5005" 

} 


NOTE 

Useconfiguration uzantı yöntemi şu anda Getsection tarafından döndürülen bir yapılandırma bölümünü ayrıştırma 
Özelliğine sahip değil (örneğin, .UseConfiguration(Configuration.GetSection("section")) . Getsection yöntemi, 
yapılandırma anahtarlarını istenen bölüme süzer ancak bölüm adını anahtarlar üzerinde bırakır (örneğin, section: urls , 
section: environment ). Useconfiguration yöntemi, anahtarların webHostBuilder anahtarlarla eşleşmesini bekler 
(örneğin, urls , environment ). Anahtarlarda bölüm adının varlığı, bölümün değerlerinin konak yapılandırmasını engeller. 
Bu soruna önümüzdeki sürümlerden birinde çözüm getirilecektir. Daha fazla bilgi ve geçici çözüm için bkz . yapılandırma 
bölümünü VVebHostBuilder 'A geçirme. Useconfiguration tam anahtarları kullanır. 

useconfiguration , anahtarları yalnızca belirtilen ıconfiguration ana bilgisayar Oluşturucu yapılandırmasına kopyalar. 
Bu nedenle, JSON, İNİ ve XML ayarları dosyaları için reloadonchange: true ayarlamanın hiçbir etkisi yoktur. 








Belirli bir URL 'de çalıştırılacak Konağı belirtmek için, DotNet çalıştırmasıyürütürken istenen değer bir komut 
isteminden geçirilebilir. Komut satırı bağımsız değişkeni, HostSettings. JSON dosyasından urls değerini 
geçersiz kılar ve sunucu 8080 numaralı bağlantı noktasını dinler: 

dotnet run --urls "http://*:8080" 


Konağı yönetme 

Çalıştırma 

Run yöntemi, Web uygulamasını başlatır ve konak kapanana kadar çağıran iş parçacığını engeller: 

host.Run(); 


Start 

start yöntemini çağırarak Konağı engellenmeyen bir şekilde çalıştırın: 

using (hoşt) 

{ 

host.Start(); 

Console.ReadLine(); 

} 

start yöntemine bir URL listesi geçirilirse, belirtilen URL 'Leri dinler: 

var urls = new List<string>() 

{ 

"http://*:5000"j 

''http://localhost:5001" 

}; 

var hoşt = new WebHostBuilder() 

•UseKestrel() 

.UseStartup<Startup>() 

.Start(urls.ToArrayO); 

using (hoşt) 

{ 

Console.Readl_ine(); 

} 

Uygulama, statik bir kolaylık yöntemi kullanarak createDefaultBuiider önceden yapılandırılmış varsayılan 
değerlerini kullanarak yeni bir konak başlatabilir ve başlatabilir. Bu yöntemler, konsol çıktısı olmadan sunucuyu 
başlatır ve VVaitforkapatmadan bir kesme (CTRL-C/sigint veya sigterim) bekler: 

Başlat (RequestDelegate uygulaması) 

RequestDeiegate ile başlayın: 

using (var hoşt = WebHost.Start(app => app.Response.WriteAsync("HellOj World!"))) 

{ 

Console.WriteLine("Use Ctrl-C to shutdown the hoşt..."); 
hoşt.WaitForShutdown(); 

} 






"Merhaba Dünya!" yanıtını almak için http://iocaihost:5000 tarayıcıda bir istek yapın kesme (CTRL-C/SIGINT 
veya SIGTERM) verilene kadar blok waitForShutdown .Uygulama consoie.writei_ine iletisini görüntüler ve bir 
tuş basışını, çıkış için bekler. 


Başlangıç (dize URL 'si, ReguestDelegate uygulaması) 



aynı sonucu üretir. 

Başlat (eylemcıroutebuilder > routeBuilder) 

Yönlendirme ara yazılımını kullanmak için bir iRouteBuiider örneği (Microsoft. AspNetCore. Routing) kullanın: 

using (var hoşt = WebHost.Start(router = > router 
.MapGet("hello/{name}", (req, res, data) => 

res.WriteAsync($"Hello, {data.Values["name"]}!")) 

.MapGet("buenosdias/{name}", (req, res, data) => 

res.WriteAsync($"Buenos dias, {data. Values["name"]}! ")) 

.MapGet("throw/{message?}", (req, res, data) => 

throw new Exception((string)data.Values["message"] ?? "Uh oh!")) 

.MapGet("{greeting}/{name}", (req, res, data) => 

res.WriteAsync($"{data.Values["greeting"]}, {data.Valuesf"name"]}!")) 

.MapGet("", (req, res, data) => res.WriteAsync("Hello, WorldI")))) 

{ 

Console.WriteLine("Use Ctrl-C to shutdown the hoşt..."); 
hoşt.WaitForShutdown(); 

} 


Aşağıdaki tarayıcı isteklerini örnekle birlikte kullanın: 

İSTEK YANIT 


http://localhost:5000/hello/Martin 


Merhaba, martın! 


http://localhost:5000/buenosdias/Catrina 


Buenos dias, Catrina! 


http://localhost:5000/throw/ooops! 


"Ooops!" dizesiyle bir özel durum oluşturur 


http://localhost:5000/throw 


"Uh oh!" dizesiyle bir özel durum oluşturur 


http://localhost:5000/Sante/Kevin 


Sante, Kevin! 


http://localhost:5000 


Merhaba Dünya! 


kesme (CTRL-C/SIGINT veya SIGTERM) verilene kadar blok waitForShutdown .Uygulama consoie.writeLine 
iletisini görüntüler ve bir tuş basışını, çıkış için bekler. 

Başlangıç (dize URL 'si, eylemcıroutebuilder > routeBuilder) 


















Bir URL ve iRouteBuiider örneği kullanın: 


using (var hoşt = WebHost.Start("http://localhost: 8080 ", router => router 
.MapGet("hello/{nam 8 }", (req, res, data) => 

res.WriteAsync($"Hello, {data.Valuesf"name"]}! ")) 

.MapGet("buenosdias/{name}", (req, res, data) => 

res.WriteAsync($"Buenos dias, {data.Values["name"]}!")) 

.MapGet("throw/{message?}", (req, res, data) => 

throw new Exception((string)data.Values["message"] ?? "Uh oh!")) 

.MapGet("{greeting}/{name}", (req, res, data) => 

res.WriteAsync($"{data.Values["greeting"]}, {data.Valuesf"name"]}!")) 

.MapGet("", (req, res, data) => res.WriteAsync("Hello, World!")))) 

{ 

Console.Writel_ine("Use Ctrl-C to shut down the hoşt..."); 
host.WaitForShutdown(); 

} 

Uygulamanın http://iocaihost:8080 yanıt vermesi dışında, Başlangıç (eylemcıroutebuilder > 
routebuilder) ile aynı sonucu üretir. 

StartVVith (Action<lApplicationBuilder > App) 

iAppiicationBuiider yapılandırmak için bir temsilci sağlayın: 

using (var hoşt = WebHost.StartWith(app => 
app.Use(next => 

{ 

return async context => 

{ 

await context.Response.WriteAsync("Hello World!"); 

}; 

}))) 

{ 

Console.WriteLine("Use Ctrl-C to shut down the hoşt..."); 
hoşt.WaitForShutdown(); 

} 

"Merhaba Dünya!" yanıtını almak için http://iocaihost 15000 tarayıcıda bir istek yapın kesme (CTRL-C/SIGINT 
veya SIGTERM) verilene kadar blok waitForShutdown .Uygulama consoie.writei_ine iletisini görüntüler ve bir 
tuş basışını, çıkış için bekler. 

StartVVith (dize URL 'si, ActioncIApplicationBuilder > App) 

iAppücationBuiider yapılandırmak için bir URL ve temsilci sağlayın: 

using (var hoşt = WebHost.StartWith("http://localhost: 8080 ", app => 
app.Use(next => 

{ 

return async context => 

{ 

await context.Response.WriteAsync("Hello World!"); 

}; 

}))) 

{ 

Console.WriteLine("Use Ctrl-C to shut down the hoşt..."); 
host.WaitForShutdown(); 

} 

Uygulamanın http://iocaihost:808@ yanıt vermesi dışında, StartVVith ile aynı sonucu üretir 
(Action<IApplicationBuilder > App). 









lwebhostenvironment arabirimi 


ıwebHostEnvironment arabirimi, uygulamanın Web barındırma ortamı hakkında bilgi sağlar. Özelliklerini ve 
uzantı yöntemlerini kullanmak için ıwebHostEnvironment almak üzere Oluşturucu Ekleme kullanın: 

public class CustomFileReader 

{ 

private readonly II/JebHostEnvironment _env; 

public CustomFileReader(IWebHostEnvironment env) 

{ 

_env = env; 

> 

public string ReadFile(string filePath) 

{ 

var fileProvider = _env.WebRootFileProvider; 

// Process the file here 

} 

} 

Uygulamayı ortama göre başlangıçta yapılandırmak için kural tabanlı bir yaklaşım kullanılabilir. Alternatif 
olarak, configureServices kullanım için startup oluşturucusuna ıwebHostEnvironment ekleyin: 

public class Startup 

{ 

public Startup(IWebHostEnvironment env) 

{ 

HostingEnvironment = env; 

} 

public IWebHostEnvironment HostingEnvironment { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

if (HostingEnvironment. IsDevelopment ()) 

{ 

// Development configuration 

} 

else 

{ 

// Staging/Production configuration 

} 

var contentRootPath = HostingEnvironment.ContentRootPath; 

} 

} 


NOTE 

IsDevelopment uzantısı yöntemine ek olarak, IWebHostEnvironment IsStaging , IsProduction ve 
i s Environment( string environmentName) yöntemleri sunar. Daha fazla bilgi için bkz. ASP.NET Core çoklu ortamları 
kullanma. 


ıwebHostEnvironment hizmeti ayrıca işlem ardışık düzenini ayarlamak için doğrudan Configure yöntemine 
eklenebilir: 











public void Configure(IApplicationBuilder app, IklebHostEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

// In Development, use the Developer Exception Page 
app.UseDeveloperExceptionPage(); 

} 

else 

{ 

// In Staging/Production, route exceptions to /error 
app.UseExceptionHandler("/error"); 

} 

var contentRootPath = env.ContentRootPath; 

} 

ıwebHostEnvironment , özel Ara yazılımoluştururken invoke yöntemine eklenebilir: 

public async Task Invoke(HttpContext context, IWebHostEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

// Configure middleware for Development 

} 

else 

{ 

// Configure middleware for Staging/Production 

} 

var contentRootPath = env.ContentRootPath; 

} 


Ihostingenvironment arabirimi 

Ihostingenvironment arabirimi , uygulamanın Web barındırma ortamı hakkında bilgi sağlar. Özelliklerini ve 
uzantı yöntemlerini kullanmak için iHostingEnvironment almak üzere Oluşturucu Ekleme kullanın: 

public class CustomFileReader 

{ 

private readonly IHostingEnvironment _env; 

public CustomFileReader(IHostingEnvironment env) 

{ 

_env = env; 

> 

public string ReadFile(string filePath) 

{ 

var fileProvider = _env.WebRootFileProvider; 

// Process the file here 

} 

} 

Uygulamayı ortama göre başlangıçta yapılandırmak için kural tabanlı bir yaklaşım kullanılabilir. Alternatif 
olarak, configureServices kullanım için startup oluşturucusuna iHostingEnvironment ekleyin: 






public class Startup 

{ 

public Startup(IHostingEnvironment env) 

{ 

HostingEnvironment = env; 

} 

public IHostingEnvironment HostingEnvironment { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

if (HostingEnvironment. IsDevelopment()) 

{ 

// Development configuration 

} 

else 

{ 

// Staging/Production configuration 

} 

var contentRootPath = HostingEnvironment.ContentRootPath; 

} 

} 


NOTE 

IsDevelopment uzantısı yöntemine ek olarak, IHostingEnvironment IsStaging , IsProduction ve 
isEnvironment(string environmentName) yöntemleri sunar. Daha fazla bilgi için bkz. ASP.NET Core çoklu ortamları 
kullanma. 


IHostingEnvironment hizmeti ayrıca işlem ardışık düzenini ayarlamak için doğrudan configure yöntemine 
eklenebilir: 


public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

// In Development, use the Developer Exception Page 
app.UseDeveloperExceptionPage(); 

} 

else 

{ 

// In Staging/Production, route exceptions to /error 
app.UseExceptionHandler("/error"); 

} 

var contentRootPath = env.ContentRootPath; 

} 


IHostingEnvironment , özel Ara yazılımoluştururken invoke yöntemine eklenebilir: 







public async Task Invoke(HttpContext contextj IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

// Configure middleware for Development 

} 

else 

{ 

// Configure middleware for Staging/Production 

} 

var contentRootPath = env.ContentRootPath; 

} 


Ihostapplicationlifetime arabirimi 

iHostAppiicationLifetime , başlatma sonrası ve kapalı etkinlikler için izin verir. Arabirimdeki üç özellik, başlangıç 
ve kapalı olayları tanımlayan Action yöntemlerini kaydetmek için kullanılan iptal belirteçleridir. 

İPTAL BELİRTECİ TETIKLENDIĞI ZAMAN... 


ApplicationStarted 


Konak tam olarak başlatıldı. 


Applicationstopped Ana bilgisayar düzgün kapanma işlemini tamamlıyor.Tüm 

isteklerin işlenmesi gerekir. Bu olay tamamlanana kadar 
kapalı bloklar. 


ApplicationStopping 


Ana bilgisayar düzgün bir şekilde kapanma gerçekleştiriyor, 
istekler hala işliyor olabilir. Bu olay tamamlanana kadar kapalı 
bloklar. 








public class Startup 

{ 

public void Configure(IApplicationBuilder app, IHostApplicationLifetime appLifetime) 

{ 

appLifetime.ApplicationStarted.Register(OnStarted); 
appLifetime. ApplicationStopping. Register(OnStopping); 
appLifetime.ApplicationStopped.Register(OnStopped); 

Console.CancelKeyPress += (senden, eventAngs) => 

{ 

appLifetime.StopApplication(); 

// Don’t terminate the process immediately, wait fon the Main thnead to exit gnacefully. 
eventAngs.Cancel = true; 

}; 

} 

pnivate void OnStanted() 

{ 

// Penfonm post-stantup activities hene 

} 

pnivate void OnStoppingO 

{ 

// Penfonm on-stopping activities hene 

} 

pnivate void OnStopped() 

{ 

// Penfonm post-stopped activities hene 

} 


stopAppücation , uygulamanın sonlandırılmasını ister. Aşağıdaki sınıf, sınıfın shutdown yöntemi çağrıldığında 
bir uygulamayı düzgün bir şekilde kapatmak için stopAppücation kullanır: 

public class MyClass 

{ 

private readonly IHostApplicationLifetime _appLifetime; 

public MyClass(IHostApplicationLifetime appLifetime) 

{ 

_appLifetime = appLifetime; 

} 

public void Shutdown() 

{ 

_appLifetime.StopApplication(); 

} 


lapplicationlifetime arabirimi 

lapplicationlifetime , başlatma sonrası ve kapalı etkinlikler için izin verir. Arabirimdeki üç özellik, başlangıç ve 
kapalı olayları tanımlayan Action yöntemlerini kaydetmek için kullanılan iptal belirteçleridir. 

İPTAL BELİRTECİ TETIKLENDIĞI ZAMAN... 

ApplicationStarted Konak tam olarak başlatıldı. 






İPTAL BELİRTECİ 


TETIKLENDIGI ZAMAN... 


Applicationdurdurulan Ana bilgisayar düzgün kapanma işlemini tamamlıyor.Tüm 

isteklerin işlenmesi gerekir. Bu olay tamamlanana kadar 
kapalı bloklar. 


Applicationdurduruluyor Ana bilgisayar düzgün bir şekilde kapanma gerçekleştiriyor. 

istekler hala işliyor olabilir. Bu olay tamamlanana kadar kapalı 
bloklar. 


public class Startup 

{ 

public void Configure(IApplicationBuilder app, IApplicationLifetime appLifetime) 

{ 

appLifetime.ApplicationStarted.Register(OnStarted); 
appLifetime. ApplicationStopping. Register(OnStopping); 
appLifetime.ApplicationStopped.Register(OnStopped); 

Console.CancelKeyPress += (sender, eventArgs) => 

{ 

appLifetime.StopApplication(); 

// Don’t terminate the process immediately, wait for the Main thread to exit gracefully. 
eventArgs.Cancel = true; 

}; 

} 

private void OnStarted() 

{ 

// Perform post-startup activities here 

} 

private void OnStoppingO 

{ 

// Perform on-stopping activities here 

} 

private void OnStopped() 

{ 

// Perform post-stopped activities here 

} 

} 

StopApplication , uygulamanın sonlandırılmasım ister. Aşağıdaki sınıf, sınıfın shutdown yöntemi çağrıldığında 
bir uygulamayı düzgün bir şekilde kapatmak için StopApplication kullanır: 

public class MyClass 

{ 

private readonly IApplicationLifetime _appLifetime; 

public MyClass(IApplicationLifetime appLifetime) 

{ 

_appLifetime = appLifetime; 

} 

public void Shutdown() 

{ 

_appLifetime.StopApplication(); 

} 


Kapsam doğrulaması 






Createdefaultbuilder , uygulamanın ortamı geliştirmede true İçin serviceprovideroptions. validatescopes 
öğesini ayarlar. 

Validatescopes true olarak ayarlandığında, varsayılan hizmet sağlayıcı aşağıdakileri doğrulamak için 
denetimler gerçekleştirir: 

• Kapsamlı hizmetler doğrudan veya dolaylı olarak kök hizmet sağlayıcısından çözümlenmez. 

• Kapsamlı hizmetler doğrudan veya dolaylı olarak Singleton 'a eklenmiş değildir. 

Buildserviceprovider çağrıldığında kök hizmet sağlayıcısı oluşturulur. Kök hizmet sağlayıcısının ömrü, 
sağlayıcının uygulamayla başladığı ve uygulama kapandığında bırakıldığı uygulama/sunucunun yaşam süresine 
karşılık gelir. 

Kapsamlı hizmetler kendilerini oluşturan kapsayıcı tarafından atılmış. Kök kapsayıcıda kapsamlı bir hizmet 
oluşturulduysa, hizmetin ömrü etkin şekilde tek başına yükseltilir çünkü yalnızca uygulama/sunucu 
kapatıldığında kök kapsayıcı tarafından atılmış olur. Hizmet kapsamlarını doğrulamak Buildserviceprovider 
çağrıldığında bu durumları yakalar. 

Üretim ortamında da dahil olmak üzere kapsamları her zaman doğrulamak için, ana bilgisayar Oluşturucu 'da 

Serviceprovideroptions 'ı usedefaultserviceprovider ile yapılandırın: 

WebHost.CreateDefaultBuilder(args) 

,UseDefaultServiceProvider((context., options) => { 
options.Validatescopes = true; 

}) 


Ek kaynaklar 

• 11S ile Windows üzerinde ASP.NET Core barındırma 

• NGINX ile Linux üzerinde ana bilgisayar ASP.NET Core 

• Apache ile Linux üzerinde ASP.NET Core barındırma 

• Windows hizmetinde konak ASP.NET Core 






ASRNET Core Web sunucusu uygulamaları 
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Tom Dykstra, Steve Smith, Stephen halterve Chris 'e göre 

ASP.NET Core bir uygulama, işlem içi HTTP sunucu uygulamasıyla çalışır.Sunucu uygulaması, HTTP isteklerini 
dinler ve bir HttpContextoluşan istek özellikleri kümesi olarak bunları uygulamaya sunar. 

Kestrel 

Kestrel, AS P.N ET Core projesi şablonları tarafından belirtilen varsayılan Web sunucusudur. 

Kestrel kullanın: 

• Kendi başına bir uç sunucu olarak, Internet dahil olmak üzere istekleri doğrudan bir ağdan işleme. 

Internet 

HTTP 

◄- 



ASP.NET Core application 
Kestrel HttpContert Application code 

* 0 *-* 


• Internet Information Services (IIS), NGINXveya Apachegibi bir ters ara sunucu ile. Ters proxy sunucusu, 
Internet 'ten gelen HTTP isteklerini alır ve Kestrel 'e iletir. 


Internet 

/>s, HTTP r 

Reverse proxy server: 

IIS, Nginx, Apache HTTP 

ASP.NET Core application 
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Ters ara sunucu—sahip veya olmayan—barındırma yapılandırması desteklenir. 

Kestrel yapılandırma kılavuzu ve Kestrel 'in bir ters proxy yapılandırmasında ne zaman kullanılacağı hakkında 
bilgi için bkz. AS P.N ET Core Web sunucusu uygulamasını Kestrel. 

• VVİndovvs 

• macOS 

• 'Un 

ASP.NET Core aşağıdakiler ile birlikte gelir: 

• Kestrel sunucusu varsayılan, platformlar arası http sunucu uygulamasıdır. 

• IIS HTTP sunucusu, IIS için bir işlem içi sunucusudur . 

• Http. sys sunucusu , http. sys çekirdek sürücüsünü ve http sunucusu API'sini temel alan bir yalnızca VVİndovvs 
HTTP sunucusudur. 

IIS veya IIS Expresskullanırken, uygulama şu şekilde çalışır: 

• IIS çalışan işlemiyle aynı işlemde ( işlem içi barındırma modeli) IIS HTTP sunucusu ile. İşlem içi önerilen 
yapılandırmadır. 

• Bir işlemde, IIS çalışan işleminden ( işlem dışı barındırma modeli) Kestrel sunucusuylaayırın. 

ASP.NET Core modülü , IIS ile İşlem ıçı IIS HTTP sunucusu ya da Kestrel arasında yerel IIS isteklerini işleyen 
yerel bir IIS modülüdür. Daha fazla bilgi için bkz. ASP.NET Core Modülü. 















Barındırma modelleri 


ASP.N ET Core bir uygulama, işlem içi barındırma kullanarak IIS çalışan işlemiyle aynı işlemde çalışır, işlem içi 
barındırma, istek dışı barındırmak için gelişmiş performans sağlar çünkü istekler, giden ağ trafiği ile aynı 
makineye geri döndürülen bir ağ arabirimidir. IIS, VVİndovvs İşlem etkinleştirme hizmeti (vvas)ile işlem 
yönetimini işler. 

işlem dışı barındırma kullanma, ASP.N ET Core uygulamalar IIS çalışan işleminden ayrı bir işlemde çalışır ve 
modül işlem yönetimini işler. Modül, ilk istek ulaştığında ASP.NET Core uygulama için işlemi başlatır ve 
kapanırsa veya kilitlenirse uygulamayı yeniden başlatır. Bu aslında, VVİndovvs İşlem etkinleştirme hizmeti 
(vvas)tarafından yönetilen işlem içi uygulamalarla birlikte görülen davranışdır. 

Daha fazla bilgi ve yapılandırma kılavuzu için aşağıdaki konulara bakın: 

• IIS ile VVİndovvs üzerinde ASP.NET Core barındırma 

• ASP.NET Core Modülü 

• VVİndovvs 

• macOS 

• 'Un 

ASP.NET Core aşağıdakiler ile birlikte gelir: 

• Kestrel sunucusu , platformlar arası varsayılan HTTP sunucusudur. 

• Http. sys sunucusu , http. sys çekirdek sürücüsünü ve http sunucusu API'sini temel alan bir yalnızca VVİndovvs 
HTTP sunucusudur. 

IIS veya IIS Expresskullanırken, uygulama IIS çalışan işleminden (işlem dişi) Kestrel sunucusuile ayrı bir işlemde 
çalışır. 

ASP.NET Core uygulamalar IIS çalışan işleminden ayrı bir işlemde çalıştığından, modül işlem yönetimini işler. 
Modül, ilk istek ulaştığında AS P.N ET Core uygulama için işlemi başlatır ve kapanırsa veya kilitlenirse 
uygulamayı yeniden başlatır. Bu aslında, VVİndovvs İşlem etkinleştirme hizmeti (vvas)tarafından yönetilen işlem içi 
uygulamalarla birlikte görülen davranışdır. 

Aşağıdaki diyagramda IIS, ASP.NET Core modülü ve işlem dışı barındırılan bir uygulama arasındaki ilişki 
gösterilmektedir: 



IIS 

ASP.NET Core application 

İnternet 

(w3wp.exe) 

(dotnet.exe) 

/X* HTTP 

ASP.NET Core Modüle 
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V. + 

0 

~ 0 * * 0 


http://contoso.com 

http V/loca Ihost 1234 


istekler VVeb 'den çekirdek modu HTTP, sys sürücüsüne ulaşır.Sürücü, istekleri Web sitesinin yapılandırılmış 
bağlantı noktasında IIS 'ye yönlendirir, genellikle 80 (HTTP) veya 443 (HTTPS). Modül, 80 veya 443 numaralı 
bağlantı noktası olmayan uygulama için rastgele bir bağlantı noktasında istekleri Kestrel 'e iletir. 

Modül, başlangıç sırasında bir ortam değişkeni aracılığıyla bağlantı noktasını belirtir ve IIS tümleştirme ara 
yazılımı sunucuyu http://iocaihost:{port} dinlemek üzere yapılandırır. Ek denetimler gerçekleştirilir ve 
modülünden kaynaklanmayan istekler reddedilir. Modül HTTPS iletmeyi desteklemez, bu nedenle istekler 
HTTPS üzerinden IIS tarafından alınsa bile HTTP üzerinden iletilir. 

Kestrel, isteği modülden başlattıktan sonra, istek ASP.NET Core ara yazılım ardışık düzenine gönderilir. Ara 
yazılım ardışık düzeni isteği işler ve uygulamanın mantığına bir HttpContext örneği olarak geçirir. IIS 
tümleştirmesi tarafından eklenen ara yazılım, isteği Kestrel iletmek için düzen, uzak İP ve pathbase 'i hesaba göre 
güncelleştirir. Uygulamanın yanıtı IIS 'e geri geçirilir ve bu, isteği başlatan HTTP istemcisine geri gönderilir. 











11S ve ASP.NET Core modülü yapılandırma kılavuzu için aşağıdaki konulara bakın: 

• MS ile VVİndovvs üzerinde ASP.NET Core barındırma 

• ASP.NET Core Modülü 

Kestrel ile NGINX 

Linux üzerinde NGINX 'i Kestrel için ters proxy sunucusu olarak kullanma hakkında daha fazla bilgi için bkz. 
NGINX ile Linux üzerinde ana bilgisayar ASP.NET Core. 

Kestrel ile Apache 

Linux üzerinde Apache 'yi Kestrel için ters proxy sunucusu olarak kullanma hakkında daha fazla bilgi için bkz. 
Apache ile Linux üzerinde ASP.N ET Core barındırma. 

HTTP.sys 

ASP.NET Core uygulamalar VVİndovvs üzerinde çalışıyorsa, HTTP.sys, Kestrel için bir alternatiftir. Kestrel 
genellikle en iyi performans için önerilir. HTTP, sys, uygulamanın Internet 'e açık olduğu senaryolarda ve gerekli 
yetenekler HTTP, sys tarafından desteklenir, ancak Kestrel değildir. Daha fazla bilgi için bkz. ASP.NET Core 'de 
HTTP, sys Web sunucusu uygulama. 
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HTTP, sys, yalnızca bir iç ağa açık olan uygulamalar için de kullanılabilir. 

ASP.NET Core application 
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HTTP, sys yapılandırma kılavuzu için bkz. ASP.NET Core 'de HTTP, sys Web sunucusu uygulama. 

ASP.NET Core Server altyapısı 

startup.configure yönteminde kullanılabilen lApplicationBuilder IFeatureCollectiontürü ServerFeatures 
özelliğini kullanıma sunar. Kestrel ve HTTP, sys, her biri IServerAddressesFeaturetek bir özelliği kullanıma sunar, 
ancak farklı sunucu uygulamaları ek işlevsellik sergilede gösterebilir. 

ıserverAddressesFeature , sunucu uygulamasının çalışma zamanında hangi bağlantı noktasını bağladığına ilişkin 
bilgi edinmek için kullanılabilir. 

Özel sunucular 

Yerleşik sunucular uygulamanın gereksinimlerini karşılamıyorsa, özel bir sunucu uygulaması oluşturulabilir. .Net 
İçin açık Web arabirimi (OWıN) Kılavuzu , novvintabanlı IServer uygulamasının nasıl yazılacağını gösterir. 

Yalnızca uygulamanın kullandığı Özellik arabirimleri uygulama gerektirir, ancak en az bir IHttpRequestFeature ve 
IHttpResponseFeature desteklenmelidir. 

Sunucu başlatma 

Tümleşik geliştirme ortamı (IDE) veya düzenleyici uygulamayı başlattığında sunucu başlatılır: 

• Visual Studio - başlatma profilleri, uygulamayı ve sunucuyu MS Express/ASP.NET Core modülü veya 
konsolu ile başlatmak için kullanılabilir. 

• Visual Studio Code - uygulama ve sunucu, CoreCLR hata ayıklayıcısını etkinleştiren Omnisharptarafından 













başlatılır. 

• Mac için Visual Studio - uygulama ve sunucu mono geçici modda hata ayıklayıcıtarafından başlatılır. 

Uygulamanın, projenin klasöründeki bir komut isteminden başlatılması sırasında DotNet Run uygulamayı ve 
sunucuyu (yalnızca Kestrel ve http. sys) başlatır. Yapılandırma, Debug (varsayılan) veya Release olarak ayarlanan 
-c|--configuration seçeneği tarafından belirtilir. 

Laurıchsettings. JSON dosyası, dotnet run İle veya Visual Studio gibi araç halinde yerleşik bir hata ayıklayıcı ile 
bir uygulama başlatırken yapılandırma sağlar. Başlatma profilleri bir Laurıchsettings. JSON dosyasında varsa, 
dotnet run komutuyla --launch-profile {profile name} seçeneğini kullanın veya Visual Studio 'da profili seçin. 
Daha fazla bilgi için bkz. DotNet Run ve .NET Core Distribution paketleme. 

HTTP/2 desteği 

Http/2 aşağıdaki dağıtım senaryolarında ASP.NET Core desteklenir: 

• Kestrel 

o işletim sistemi 

o Windows Server 2016/Windows 10 veya üzerit 

o OpenSSL 1.0.2 veya üzerini içeren Linux (örneğin, Ubuntu 16,04 veya üzeri) 
o HTTP/2, gelecek sürümlerde macOS 'ta desteklenecektir, 
o Hedef Framevvork: .N ET Core 2,2 veya üzeri 

• HTTP.sys 

o VVİndovvs Server 2016/Windows 10 veya üzeri 
o Hedef Framevvork: HTTP, sys dağıtımları için geçerli değildir. 

• US (işlem içi) 

o VVİndovvs Server 2016/Windows 10 veya üzeri; US 10 veya üzeri 
o Hedef Framevvork: .N ET Core 2,2 veya üzeri 

• US (işlem dışı) 

o VVİndovvs Server 2016/Windows 10 veya üzeri; US 10 veya üzeri 

o Herkese açık uç sunucu bağlantıları HTTP/2 kullanır, ancak Kestrel ile ters proxy bağlantısı HTTP/1.1 
kullanır. 

o Hedef Framevvork: US işlem dışı dağıtımlar için geçerli değildir. 

tKestrel VVİndovvs Server 2012 R2 ve VVİndovvs 8.1 üzerinde HTTP/2 için sınırlı destek içerir. Bu işletim 
sistemlerinde kullanılabilir olan desteklenen TLS şifre paketlerinin listesi sınırlı olduğundan destek sınırlıdır. TLS 
bağlantılarının güvenliğini sağlamak için Eliptik Eğri dijital İmza algoritması (ECDSA) kullanılarak oluşturulan bir 
sertifika gerekli olabilir. 

• HTTP.sys 

o VVİndovvs Server 2016/Windows 10 veya üzeri 
o Hedef Framevvork: HTTP, sys dağıtımları için geçerli değildir. 

• US (işlem dışı) 

o VVİndovvs Server 2016/Windows 10 veya üzeri; US 10 veya üzeri 

o Herkese açık uç sunucu bağlantıları HTTP/2 kullanır, ancak Kestrel ile ters proxy bağlantısı HTTP/1.1 
kullanır. 

o Hedef Framevvork: US işlem dışı dağıtımlar için geçerli değildir. 

Bir HTTP/2 bağlantısı, uygulama katmanı protokol anlaşması (ALPN) ve TLS 1,2 veya üstünü kullanmalıdır. 

Daha fazla bilgi için, sunucu dağıtım senaryolarınıza ait konulara bakın. 








Ek kaynaklar 

• AS P.N ET Core Web sunucusu uygulamasını Kestrel 

• ASP.NET Core Modülü 

• IIS ile VVİndovvs üzerinde ASP.NET Core barındırma 

• ASP.NET Core uygulamalarını Azure App Service dağıtma 

• NGINX ile Linux üzerinde ana bilgisayar ASP.NET Core 

• Apache ile Linux üzerinde ASP.NET Core barındırma 

• ASP.NET Core 'de HTTP, sys Web sunucusu uygulama 


ASRNET Core yapılandırma 
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Luke Latham tarafından 

ASP.NET Core içindeki uygulama yapılandırması , yapılandirma 
sağlayıcdarıtarafından belirlenen anahtar-değer çiftlerini temel alır. Yapılandırma 
sağlayıcıları yapılandırma verilerini çeşitli yapılandırma kaynaklarından anahtar-değer 
çiftlerine okur: 

• Azure Key Vault 

• Azure Uygulama yapılandırması 

• Komut satırı bağımsız değişkenleri 

• Özel sağlayıcılar (yüklü veya oluşturulmuş) 

• Dizin dosyaları 

• Ortam değişkenleri 

• Bellek içi .N ET nesneleri 

• Ayarlar dosyaları 

Ortak yapılandırma sağlayıcısı senaryoları için yapılandırma paketleri (Microsoft. 
Extensions. Configuration), Framework tarafından örtük olarak dahil edilir. 

Ortak yapılandırma sağlayıcısı senaryoları için yapılandırma paketleri (Microsoft. 
Extensions. Configuration), Microsoft. Aspnetcore. app metapackageiçinde bulunur. 

Örnek uygulamada ve aşağıdaki kod örnekleri Microsoft.Extensions.Configuration ad 
alanını kullanır: 

using Microsoft.Extensions.Configuration; 

Seçenekler stili, bu konuda açıklanan yapılandırma kavramlarının bir uzantısıdır. 
Seçenekler, ilgili ayarların gruplarını temsil etmek için sınıfları kullanır. Daha fazla bilgi 
için bkz. ASP.NET Core için seçenek kalıbı. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Uygulama yapılandırmasına karşı konak 

Uygulama yapılandırıldıktan ve başlatılmadan önce, bir konak yapılandırılır ve 
başlatılır. Ana bilgisayar, uygulama başlatma ve ömür yönetiminden sorumludur.Hem 
uygulama hem de ana bilgisayar, bu konuda açıklanan yapılandırma sağlayıcıları 
kullanılarak yapılandırılır. Ana bilgisayar yapılandırma anahtar-değer çiftleri, 
uygulamanın yapılandırmasına de dahildir. Konak oluşturulduğunda yapılandırma 
sağlayıcılarının nasıl kullanıldığı ve yapılandırma kaynaklarının konak 
yapılandırmasını nasıl etkilediği hakkında daha fazla bilgi için bkz. ASP.NET Core 
temelleri. 

Varsayılan yapılandırma 

ASP.NET Core DotNet yeni şablonlara dayalı Web Apps, bir konak oluştururken 





CreateDefaultBuilder çağırır. createDefauitBuiider , uygulama için aşağıdaki sırayla 
varsayılan yapılandırmayı sağlar: 

Genel ana bilgisayarkullanan uygulamalar için aşağıdakiler geçerlidir. Web 
konağınıkullanırken varsayılan yapılandırmayla ilgili ayrıntılar için, bu konunun 
ASP.NET Core 2,2 sürümünebakın. 

• Ana bilgisayar yapılandırması şuradan sağlanır: 

o Ortam değişkenleri, ortam değişkenleri yapılandırma sağlayıcısıkullanılarak 
dotnet_ (örneğin, dotnet_environment ) ön ekine sahiptir. Yapılandırma 
anahtar-değer çiftleri yüklendiğinde önek ( dotnet_ ) çıkarılır. 

o Komut satırı yapılandırma sağlayıcısınıkullanan komut satırı bağımsız 
değişkenleri. 

• Web ana bilgisayar varsayılan yapılandırması oluşturuldu ( 

Configurel/JebHostDefaults ): 

o Kestrel, Web sunucusu olarak kullanılır ve uygulamanın yapılandırma 
sağlayıcıları kullanılarak yapılandırılır. 

o Konak filtreleme ara yazılımı ekleyin. 

o aspnetcore_forwardedheaders_enabled ortam değişkeni true olarak 
ayarlandıysa, İletilen üstbilgiler ara yazılımı ekleyin. 

o IIS tümleştirmesini etkinleştirin. 

• Uygulama yapılandırması şuradan sağlanır: 

o dosya yapılandırma sağlayıcısınıkullanarak appSettings. JSON . 

o appSettings. Dosya yapılandırma sağlayıcısıkullanılarak {Environment}. 
JSON. 

o Uygulama, giriş derlemesini kullanarak Development ortamda 
çalıştırıldığında gizli Yöneticisi . 

o Ortam değişkenleri yapılandırma sağlayıcısınıkullanarak ortam değişkenleri. 

o Komut satırı yapılandırma sağlayıcısınıkullanan komut satırı bağımsız 
değişkenleri. 

ASP.NET Core DotNet yeni şablonlara dayalı Web Apps, bir konak oluştururken 
CreateDefaultBuilder çağırır. CreateDefaultBuilder , uygulama için aşağıdaki sırayla 
varsayılan yapılandırmayı sağlar: 

Web ana bilgisayarıkullanan uygulamalar için aşağıdakiler geçerlidir. Genel ana 
bilgisayarıkullanırken varsayılan yapılandırmayla ilgili ayrıntılar için, Bu konunun en 
son sürümünebakın. 

• Ana bilgisayar yapılandırması şuradan sağlanır: 

o Ortam değişkenleri, ortam değişkenleri yapılandırma sağlayıcısıkullanılarak 
aspnetcore_ (örneğin, aspnetcore_environment ) ön ekine sahiptir. 
Yapılandırma anahtar-değer çiftleri yüklendiğinde önek ( aspnetcore_ ) 
çıkarılır. 

o Komut satırı yapılandırma sağlayıcısınıkullanan komut satırı bağımsız 
değişkenleri. 

• Uygulama yapılandırması şuradan sağlanır: 

o dosya yapılandırma sağlayıcısınıkullanarak appSettings. JSON . 

o appSettings. Dosya yapılandırma sağlayıcısıkullanılarak {Environment}. 
JSON. 

o Uygulama, giriş derlemesini kullanarak Development ortamda 












çalıştırıldığında gizli Yöneticisi . 

o Ortam değişkenleri yapılandırma sağlayıcısını kullanarak ortam değişkenleri, 
o Komut satırı yapılandırma sağlayıcısınıkullanan komut satırı bağımsız 
değişkenleri. 

Güvenlik 

Hassas yapılandırma verilerini güvenli hale getirmek için aşağıdaki uygulamaları 
benimseyin: 

• Yapılandırma sağlayıcısı kodunda veya düz metin yapılandırma dosyalarında 
parolaları veya diğer hassas verileri hiçbir şekilde depolamayin. 

• Geliştirme veya test ortamlarında üretim gizli dizileri kullanmayın. 

• Yanlışlıkla bir kaynak kodu deposuna uygulanamazlar için proje dışındaki gizli 
dizileri belirtin. 

Daha fazla bilgi için aşağıdaki konulara bakın: 

• ASP.NET Coreçoklu ortamları kullanma 

• ASP.NET Core sürümünde geliştirme sırasında uygulama gizli dizileri güvenli 
depolama hassas verileri depolamak için ortam değişkenlerini kullanma 
hakkında öneriler İçerir. Gizli dizi Yöneticisi, Kullanıcı gizli dizilerini yerel sistemdeki 
bir JSON dosyasında depolamak için dosya yapılandırma sağlayıcısını kullanır. 
Dosya yapılandırma sağlayıcısı, bu konunun ilerleyen kısımlarında açıklanmıştır. 

Azure Key Vault ASP.NET Core uygulamalar için uygulama gizli dizilerini güvenli bir 
şekilde depolar. Daha fazla bilgi için bkz. AS P.N ET Core Azure Key Vault yapılandırma 
sağlayıcısı. 

Hiyerarşik yapılandırma verileri 

Yapılandırma API 'SI, hiyerarşik verileri yapılandırma anahtarlarında bir sınırlayıcı 
kullanımıyla birlikte düzleştirerek hiyerarşik yapılandırma verilerini muhafaza ediyor. 

Aşağıdaki JSON dosyasında, iki bölümün yapılandırılmış hiyerarşisinde dört anahtar 
mevcuttur: 

{ 

"section0": { 

"key0": "value", 

"keyl": "value" 

}, 

"sectionl": { 

"key0": "value", 

"keyl": "value" 

} 

} 

Dosya yapılandırmaya okunduğu zaman, yapılandırma kaynağının özgün hiyerarşik 
veri yapısını sürdürmek için benzersiz anahtarlar oluşturulur. Bölüm ve anahtarlar, 
özgün yapıyı sürdürmek için iki nokta üst üste ( : ) kullanımıyla düzleştirilir: 

• sectionO:keyO 

• sectionO: KEY1 

• sectionl :keyO 

• Sectionl: KEY1 




GetSection ve GetChildren yöntemleri, yapılandırma verilerinde bir bölümün 
bölümlerini ve alt öğelerini yalıtmak için kullanılabilir. Bu yöntemler daha sonra 
GetSection, GetChildren ve Existsiçinde açıklanmıştır. 

Kurallar 

Kaynaklar ve sağlayıcılar 

Uygulama başlangıcında yapılandırma kaynakları, yapılandırma sağlayıcılarının 
belirtilme sırasına göre okundu. 

Değişiklik algılamayı uygulayan yapılandırma sağlayıcılarının, temel alınan bir ayar 
değiştirildiğinde yapılandırmayı yeniden yükleme yeteneği vardır. Örneğin, dosya 
yapılandırma sağlayıcısı (Bu konunun ilerleyen kısımlarında açıklanmıştır) ve Azure 
Key Vault yapılandırma sağlayıcısı değişiklik algılamayı uygular. 

IConfiguration, uygulamanın bağımlılık ekleme (dı) kapsayıcısında kullanılabilir. 
IConfiguration, sınıfın yapılandırmasını elde etmek için bir Razor Pages PageModel 
eklenebilir: 

public class IndexModel : PageModel 
{ 

private readonly IConfiguration _config; 

public IndexModel(IConfiguration config) 

{ 

_config = configj 

} 

// The _config local variable is used to obtain configuration 
// throughout the class. 

} 

Yapılandırma sağlayıcıları, ana bilgisayar tarafından ayarlandıklarında 
kullanılamadığından, Dİ 'yi kullanamaz. 

Belirlenmesine 

Yapılandırma anahtarları aşağıdaki kuralları benimseyin: 

• Anahtarlar büyük/küçük harfe duyarlıdır.Örneğin, Connectionstring ve 

connectionstring denk anahtarlar olarak değerlendirilir. 

• Aynı anahtar için bir değer aynı veya farklı yapılandırma sağlayıcıları tarafından 
ayarlandıysa, anahtardaki en son değer kullanılan değerdir. 

• Hiyerarşik anahtarlar 

o Yapılandırma API 'SI içinde, tüm platformlarda bir iki nokta ayırıcı ( : ) 
kullanılır. 

o Ortam değişkenlerinde, tüm platformlarda bir iki nokta ayırıcı çalışmayabilir. 

Çift alt çizgi (_) tüm platformlar tarafından desteklenir ve otomatik olarak 

iki nokta olarak dönüştürülür. 

o Azure Key Vault hiyerarşik anahtarlar ayırıcı olarak -- (iki tire) kullanır. 

Gizli dizileri uygulamanın yapılandırmasına yüklendiğinde tirelerin yerini iki 
nokta ile değiştirmek için kod sağlamanız gerekir. 

• ConfigurationBinder, yapılandırma anahtarlarındaki dizi dizinlerini kullanan 
nesnelere dizileri bağlamayı destekler. Dizi bağlama, diziyi bir sınıfa bağlama 
bölümünde açıklanmıştır. 






Değerler 

Yapılandırma değerleri aşağıdaki kuralları benimseyin: 

• Değerler dizelerdir. 

• Null değerler yapılandırmada saklanamaz veya nesnelere bağlanabilir. 

sağlayıcılarla 

Aşağıdaki tabloda ASP.NET Core uygulamalar için kullanılabilen yapılandırma 
sağlayıcıları gösterilmektedir. 


SAĞLAYICI 

... YAPILANDIRMA SAĞLAR 

Azure Key Vault yapılandırma sağlayıcısı 
(güvenlik konuları) 

Azure Key Vault 

Azure uygulama yapılandırma sağlayıcısı 
(Azure belgeleri) 

Azure Uygulama yapılandırması 

Komut satırı yapılandırma sağlayıcısı 

Komut satırı parametreleri 

Özel yapılandırma sağlayıcısı 

Özel kaynak 

Ortam değişkenleri yapılandırma sağlayıcısı 

Ortam değişkenleri 

Dosya yapılandırma sağlayıcısı 

Dosyalar (ıNı, JSON, XML) 

Dosya başına anahtar yapılandırma sağlayıcısı 

Dizin dosyaları 

Bellek yapılandırma sağlayıcısı 

Bellek içi Koleksiyonlar 

Kullanıcı gizli dizileri (gizli yönetici) (güvenlik 
konuları) 

Kullanıcı profili dizinindeki dosya 


Yapılandırma kaynakları, başlangıçta yapılandırma sağlayıcılarının belirtilme sırasına 
göre okundu. Bu konuda açıklanan yapılandırma sağlayıcıları, kodunuzun onları 
düzenleyebilir sırada değil alfabetik sırayla açıklanmıştır. Kodunuzda yapılandırma 
sağlayıcılarını, temeldeki yapılandırma kaynakları için önceliklerinize uyacak şekilde 
sıralayın. 

Yapılandırma sağlayıcılarının tipik bir sırası şunlardır: 

1. Dosyalar ( appSettings. JSON, appSettings. {Env'ıronment}. JSON, {Environment} 
uygulamanın geçerli barındırma ortamıdır. 

2. Azure Key Vault 

3. Kullanıcı gizli dizileri (gizli yönetici) (yalnızca geliştirme ortamı) 

4. Ortam değişkenleri 

5. Komut satırı bağımsız değişkenleri 

Ortak bir uygulama, komut satırı bağımsız değişkenlerinin diğer sağlayıcılar 
tarafından ayarlanan yapılandırmayı geçersiz kılmasını sağlamak üzere komut satırı 
yapılandırma sağlayıcısını bir sağlayıcı serisinde en son konumlandırmaktır. 

Önceki sağlayıcı dizisi, createDefaultBuiider ile yeni bir konak Oluşturucu 
başlattığınızda kullanılır. Daha fazla bilgi için varsayılan yapılandırma bölümüne bakın. 




Konak oluşturucuyu ConfigureHostConfiguration ile 
yapılandırma 

Konak oluşturucuyu yapılandırmak için ConfigureHostConfiguration çağırın ve 
yapılandırmayı sağlayın. ConfigureHostConfiguration , derleme sürecinde daha sonra 
kullanmak üzere IHostEnvironment başlatmak için kullanılır. 
ConfigureHostConfiguration , eklenebilir sonuçlarla birden çok kez çağrılabilir. 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureHostConfiguration(config => 

{ 

var dict = new Dictionary<string, string> 

{ 

{"MemoryCollectionKeyl", "valuel"}, 

{"MemoryCollectionKey2", "value2"} 

}; 

config.AddlnMemoryCollection(dict); 

}) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 


Konak oluşturucuyu UseConfiguration ile 
yapılandırma 

Konak oluşturucuyu yapılandırmak için, yapılandırma ile konak Oluşturucu üzerinde 

UseConfiguration çağırın. 

public static IklebHostBuilder CreateWebHostBuilder(string[] args) 

{ 

var dict = new Dictionarycstring, string> 

{ 

{"MemoryCollectionKeyl", "valuel"}, 

{"MemoryCollectionKey2", "value2"} 

}; 


var config = new ConfigurationBuilder() 

.AddlnMemoryCollection(dict) 

.Build(); 

return 1/JebHost .CreateDefaultBuilder(args) 
.UseConfiguration(config) 
.UseStartup<Startup>(); 

} 


ConfigureAppConfiguration 

createDefaultBuiider tarafından otomatik olarak eklenenlere ek olarak, uygulamanın 

belirlemek için konak oluştururken 
çağırın: 


yapılandırma sağlayıcılarını 

ConfigureAppConfiguration 





public class Program 

{ 

public static Dictionary<string, string> arrayDict = 
new Dictionary<string, string> 

{ 

{"array:entries:0", "value0"}, 

{"array:entries:l", "valuel"}, 

{"array:entries:2", "value2"}, 

{"array:entries:4", "value4"}, 

{"array:entries:5", "value5"} 

}; 


public static void Main(string[] args) 

{ 

CreateHostBuilder(args).Build().Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureAppConfiguration((hostingContext, config) => 

{ 

config.AddInMemoryCollection(arrayDict); 
config.AddısonFile( 

"json_array.json", optional: false, reloadOnChange: false) 
config.AddısonFile( 

"starship.json", optional: false, reloadOnChange: false); 
config.AddXmlFile( 

"tvshow.xml", optional: false, reloadOnChange: false); 
config.AddEFConfiguration( 

options => options.UseInMemoryDatabase("InMemoryDb")); 
config.AddCommandLine(args); 

}) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 



public class Program 

{ 

public static Dictionary<string, string> arrayDict = 
new Dictionary<string, string> 

{ 

{"array:entries:0", "value0"}, 

{"array:entries:l", "valuel"}, 

{"array:entries:2", "value2"}, 

{"array:entries:4", "value4"}, 

{"array:entries:5", "value5"} 

}; 

public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build().Run(); 

} 

public static IklebHostBuilder CreateWebHostBuilder(string[] args) => 
WebHost.CreateDefaultBuilder(args) 

.ConfigureAppConfiguration((hostingContext, config) => 

{ 

config.AddInMemoryCollection(arrayDict); 
config.AddısonFile( 

"json_array.json", optional: false 3 reloadOnChange: false); 
config.AddısonFile( 

"starship.json"j optional: false, reloadOnChange: false); 
config.AddXmlFile( 

"tvshow.xml", optional: false, reloadOnChange: false); 
config.AddEFConfiguration( 

options => options.UseInMemoryOatabase("InMemoryDb")); 
config.AddCommandLine(args); 

}) 

.UseStartup<Startup>(); 


Önceki yapılandırmayı komut satırı bağımsız değişkenleriyle geçersiz kıl 

Komut satırı bağımsız değişkenleriyle geçersiz kılınabilen uygulama yapılandırması 
sağlamak için AddCommandLine son 1 u çağırın: 

.ConfigureAppConfiguration((hostingContext, config) => 

{ 

// Cali other providers here 
config.AddCommandLine(args); 

}) 


CreateDefaultBuilder tarafından eklenen sağlayıcıları kaldır 

createDefaultBuiider tarafından eklenen sağlayıcıları kaldırmak için, önce 
ılisteationbuilder. Sources üzerinde clear öğesini çağırın: 

.ConfigureAppConfiguration((hostingContext, config) => 

{ 

config.Sources.Clear(); 

// Add providers here 

}) 


Uygulama başlatma sırasında yapılandırmayı kullan 

configureAppConfiguration içinde uygulamaya sağlanan yapılandırma, uygulamanın 
başlangıcında startup.configureServices dahil olmak üzere kullanılabilir. Daha fazla 
bilgi için başlatma sırasında erişim yapılandırması bölümüne bakın. 









Komut satırı yapılandırma sağlayıcısı 

CommandLineConfigurationProvider, çalışma zamanında komut satırı bağımsız 
değişkeni anahtar-değer çiftinden yapılandırma yükler. 


Komut satırı yapılandırmasını etkinleştirmek için, AddCommandLine uzantısı yöntemi 
bir ConfigurationBuilder örneğinde çağrılır. 

AddCommandLine, CreateDefaultBuilder(string []) çağrıldığında Otomatik olarak 
çağrılır. Daha fazla bilgi için varsayılan yapılandırma bölümüne bakın. 

CreateDefaultBuilder de yüklenir: 

• AppSettings. JSON ve appSettings 'ten isteğe bağlı yapılandırma . {Environment}. 
JSON dosyaları. 

• Geliştirme ortamında Kullanıcı gizli dizileri (gizli yönetici) . 

• Ortam değişkenleri. 


CreateDefaultBuilder , komut satırı yapılandırma sağlayıcısını en son ekler. Diğer 
sağlayıcılar tarafından ayarlanan çalışma zamanında geçersiz kılma yapılandırmasında 
komut satırı bağımsız değişkenleri geçirildi. 

ana bilgisayar oluşturulduğunda davranır. Bu nedenle, 
tarafından etkinleştirilen komut satırı yapılandırması konağın 
nasıl yapılandırıldığını etkileyebilir. 


CreateDefaultBuilder 

CreateDefaultBuilder 


ASP.NET Core şablonlarına dayalı uygulamalar için, AddCommandLine 
CreateDefaultBuilder tarafından zaten çağırılır. Ek yapılandırma sağlayıcıları eklemek 
ve bu sağlayıcılardan yapılandırmayı komut satırı bağımsız değişkenleriyle geçersiz 


kılmak için, 

ConfigureAppConfiguration 

AddCommandLine 

son ' u çağırın. 


.ConfigureAppConfiguration((hostingContextj config) => 
{ 

// Cali other providers here 
config.AddCommandLine(args); 


Örnek 


Örnek uygulama, AddCommandLine bir çağrı içeren konağı oluşturmak için 
CreateDefaultBuilder statik kolaylık yönteminden yararlanır. 

1. Projenin dizininde bir komut istemi açın. 

2. dotnet run komutuna bir komut satırı bağımsız değişkeni sağlayın, 
dotnet run CommandLineKey=CommandLineValue . 

3. Uygulama çalıştıktan sonra, http://iocaihost:5000 konumundaki uygulamaya bir 
tarayıcı açın. 

4. Çıktının dotnet run için belirtilen yapılandırma komut satırı bağımsız değişkeni 
için anahtar-değer çiftini içerdiğini gözlemleyin. 

Arguments 

Değer bir eşittir işareti ( = ) izlemelidir veya değer bir boşluk izleyen anahtarın bir ön 
eki ( -- veya / ) olmalıdır.Eşittir işareti kullanılırsa değer gerekli değildir (örneğin, 
CommandLineKey= ). 













ANAHTAR ON EKİ 


ÖRNEK 


Ön ek yok 


CommandLineKeyl=valuel 


İki kısa çizgi ( -- ) 


--CommandLineKey2=value2 , 
--Commandl_ineKey2 value2 


Eğik çizgi ( / ) 


/CommandLineKey3=value3 , 
/Commandl_ineKey3 value3 


Aynı komut içinde, bir boşluk kullanan anahtar-değer çiftleri ile bir eşittir işareti 
kullanan komut satırı bağımsız değişkeni anahtar-değer çiftlerini karıştırmayın. 

Örnek komutlar: 

dotnet run Commandl_ineKeyl=valuel --CommandLineKey2=value2 /Commandl_ineKey3=value3 
dotnet run --CommandLineKeyl valuel /Commandl_ineKey2 value2 
dotnet run CommandLineKeyl= Commandl_ineKey2=value2 

Eşleme Değiştir 

Anahtar eşlemeleri anahtar adı değiştirme mantığına izin verir. Yapılandırmayı bir 
ConfigurationBuilder ile el ile oluşturduğunuzda, AddCommandLine yöntemine 
anahtar değiştirme sözlüğü sağlayabilirsiniz. 

Anahtar eşlemeleri sözlüğü kullanıldığında, sözlük bir komut satırı bağımsız değişkeni 
tarafından sunulan anahtarla eşleşen bir anahtar için denetlenir. Komut satırı anahtarı 
sözlükte bulunursa, sözlük değeri (anahtar değiştirme), anahtar-değer çiftini 
uygulamanın yapılandırmasına ayarlamak için geri geçirilir. Tek tire ( - ) ön eki olan 
herhangi bir komut satırı anahtarı için bir anahtar eşlemesi gereklidir. 

Anahtar eşlemeleri sözlük anahtarı kuralları: 

• Anahtarlar tireyle ( - ) veya çift tireyle başlamalıdır ( -- ). 

• Anahtar eşlemeleri sözlüğü yinelenen anahtarlar içermemelidir. 

Anahtar eşlemeleri sözlüğü oluşturun. Aşağıdaki örnekte, iki anahtar eşlemesi 
oluşturulur: 

public static readonly Dictionarycstring, string> _switchMappings = 
new Dictionary<stringj string> 

{ 

{ "-CLKeyl", "CommandLineKeyl" }, 

{ "-CLKey2", "CommandLineKey2" } 

}; 

Konak oluşturulduğunda, anahtar eşlemeleri sözlüğüne AddCommandLine çağırın: 

.ConfigureAppConfiguration((hostingContext, config) => 

{ 

config.AddCommandLine(args, _switchMappings); 

}) 

Anahtar eşlemeleri kullanan uygulamalar için createDefaultBuiider çağrısı bağımsız 
değişkenleri iletmemelidir. CreateDefaultBuiider yönteminin AddCommandLine çağrısı, 














eşlenmiş anahtarlar içermez ve anahtar eşleme sözlüğünü CreateDefaultBuiider 'e 
iletmenin bir yolu yoktur. Çözüm CreateDefaultBuiider bağımsız değişkenleri 
geçirmektir, ancak configurationBulider yönteminin AddCommandLine yönteminin hem 
bağımsız değişkenleri hem de anahtar eşleme sözlüğünü işlemesini sağlamak için. 

Anahtar eşlemeleri sözlüğü oluşturulduktan sonra, aşağıdaki tabloda gösterilen 
verileri içerir. 

ANAHTAR DEĞER 


-CLKeyl 


CommandLineKeyl 


-CLKey2 


Commandl_ineKey2 


Uygulama başlatılırken anahtar eşlenmiş anahtarlar kullanılıyorsa, yapılandırma 
sözlük tarafından sağlanan anahtardaki yapılandırma değerini alır: 

dotnet run -CLKeyl=valuel -CLKey2=value2 

Önceki komutu çalıştırdıktan sonra, yapılandırma aşağıdaki tabloda gösterilen 
değerleri içerir. 

ANAHTAR DEĞER 


CommandLineKeyl 


valuel 


CommandLineKey2 


value2 


Ortam değişkenleri yapılandırma sağlayıcısı 

EnvironmentVariablesConfigurationProvider, çalışma zamanında anahtar-değer 
çiftlerinde bulunan yapılandırmayı yükler. 

Ortam değişkenleri yapılandırmasını etkinleştirmek için, ConfigurationBuilder bir 
örneği üzerinde AddEnvironmentVariables uzantısı metodunu çağırın. 

Ortam değişkenlerinde hiyerarşik anahtarlarla çalışırken, bir iki nokta ayırıcı ( : ) tüm 

platformlarda çalışmayabilir (örneğin, Bash). Çift alt çizgi (_) tüm platformlar 

tarafından desteklenir ve otomatik olarak iki nokta ile değiştirilmiştir. 

Azure App Service , Azure portalında ortam değişkenleri yapılandırma sağlayıcısını 
kullanarak uygulama yapılandırmasını geçersiz kılabileceğiniz ortam değişkenlerini 
ayarlamanıza izin verir. Daha fazla bilgi için bkz. Azure uygulamaları: Azure portalını 
kullanarak uygulama yapılandırmasını geçersiz kılma. 

AddEnvironmentVariables , genel ana bilgisayarla yeni bir konak Oluşturucu 
başlatıldığında ve CreateDefaultBuiider çağrıldığında, ana bilgisayar yapılandırması 
için dotnet_ ön eki eklenmiş ortam değişkenlerini yüklemek için kullanılır. Daha fazla 
bilgi için varsayılan yapılandırma bölümüne bakın. 

AddEnvironmentVariables , Web ana bilgisayarıyla yeni bir ana bilgisayar Oluşturucu 
başlatıldığında ve CreateDefaultBuiider çağrıldığında, ana bilgisayar yapılandırması 
için aspnetcore_ ön eki eklenmiş ortam değişkenlerini yüklemek için kullanılır. Daha 
fazla bilgi için varsayılan yapılandırma bölümüne bakın. 






















CreateDefaultBuilder de yüklenir: 


• Önek olmadan AddEnvironmentvariables çağırarak, ön eki edilmemiş ortam 
değişkenlerinden uygulama yapılandırması. 

• AppSettings. JSON ve appSettings 'ten isteğe bağlı yapılandırma . {Environment}. 
JSON dosyaları. 

• Geliştirme ortamında Kullanıcı gizli dizileri (gizli yönetici). 

• Komut satırı bağımsız değişkenleri. 

Ortam değişkenleri yapılandırma sağlayıcısı, Kullanıcı gizli dizileri ve appSettings 
dosyalarından yapılandırma kurulduktan sonra çağrılır. Bu konumda sağlayıcıyı 
çağırmak, çalışma zamanında ortam değişkenlerinin Kullanıcı parolaları ve 
appSettings dosyaları tarafından ayarlanan yapılandırmayı geçersiz kılmak için 
okumasına izin verir. 


Ek ortam değişkenlerinden uygulama yapılandırması sağlamanız gerekiyorsa, 



Örnek 


Örnek uygulama, AddEnvironmentvariables bir çağrı içeren konağı oluşturmak için 
CreateDefaultBuilder statik kolaylık yönteminden yararlanır. 

1 . Örnek uygulamayı çalıştırın. http://iocaihost 15000 konumundaki uygulamaya bir 
tarayıcı açın. 

2 . Çıktının environment ortam değişkeni için anahtar-değer çiftini içerdiğini 
gözlemleyin. Değer, uygulamanın çalıştığı ortamı yansıtır, genellikle yerel olarak 
çalışırken Development . 

Uygulama kısaltması tarafından oluşturulan ortam değişkenlerinin listesini tutmak 
için, uygulama ortam değişkenlerini filtreler. Örnek uygulamanın Pages/lndex. cshtml. 
cs dosyasına bakın. 


Uygulama için kullanılabilir tüm ortam değişkenlerini göstermek istiyorsanız, 
Pages/lndex. cshtml. cs ' deki FilteredConfiguration aşağıdaki gibi değiştirin: 

FilteredConfiguration = _config.AsEnumerable(); 


Ön Ekler 

Uygulama yapılandırmasına yüklenen ortam değişkenleri, AddEnvironmentvariables 
yöntemine bir ön ek sağladığınız zaman filtrelenir. Örneğin, önek custom_ ortam 
değişkenlerini filtrelemek için, yapılandırma sağlayıcısına öneki sağlayın: 














var config = new ConfigurationBuilder() 

.AddEnvironmentVariables("CUSTOM_") 

.Build(); 

Yapılandırma anahtar-değer çiftleri oluşturulduğunda ön ek çıkarılır. 

Konak Oluşturucu oluşturulduğunda, ana bilgisayar yapılandırması ortam 
değişkenleri tarafından sağlanır. Bu ortam değişkenleri için kullanılan önek hakkında 
daha fazla bilgi için varsayılan yapılandırma bölümüne bakın. 

Bağlantı dizesi önekleri 

Yapılandırma API 'SI, uygulama ortamı için Azure bağlantı dizelerini yapılandırma ile 
ilgili dört bağlantı dizesi ortam değişkeni için özel işlem kuralları içerir. 
AddEnvironmentVariables için bir önek sağlanmazsa, tabloda gösterilen öneklere sahip 
ortam değişkenleri uygulamaya yüklenir. 

BAĞLANTI DİZESİ ÖNEKİ SAĞLAYICI 


CUSTOMCONNSTR_ 

Özel sağlayıcı 

MYSQLCONNSTR_ 

MySQL 

SQLAZURECONNSTR_ 

Azure SQL veritabanı 

SQLCONNSTR_ 

SQL Server 


Bir ortam değişkeni keşfedildiğinde ve tabloda gösterilen dört önekle yapılandırmaya 
yüklendiğinde: 

• Yapılandırma anahtarı, ortam değişkeni öneki kaldırılarak ve bir yapılandırma 
anahtarı bölümü ( Connectionstrings ) eklenerek oluşturulur. 

• Veritabanı bağlantı sağlayıcısını temsil eden yeni bir yapılandırma anahtar-değer 
çifti oluşturulur ( customcoi\instr_ hariç, belirtilen sağlayıcı olmayan). 

DÖNÜŞTÜRÜLEN SAĞLAYICI YAPILANDIRMA 

ORTAM DEĞİŞKENİ ANAHTARI YAPILANDIRMA ANAHTARI GİRİŞİ 

customconnstr_<key> Connectionstrings:< key> Yapılandırma girişi 

oluşturulmamış. 


MYSQLCONNSTR_<KEY> 


Connectionstrings:<KEY> 


Anahtar: 

Connectionstrings: 
<KEY> ProviderName 


Değer: 

MySql.Data.MySqlClient 


SQLAZURECONNSTR_<KEY> 


Connectionstrings:<KEY> 


Anahtar: 

Connectionstrings: 
<KEY> ProviderName 


Değer: 

System.Data.SqlClient 



















SAĞLAYICI YAPILANDIRMA 
GİRİŞİ 


DÖNÜŞTÜRÜLEN 

ORTAM DEĞİŞKENİ ANAHTARI YAPILANDIRMA ANAHTARI 


SQLCONNSTR_<KEY> ConnectionStrings:<KEY> Anahtar: 

ConnectionStrings: 
<KEY>_ProviderName 

Değer: 

System.Data.SqlClient 


Dosya yapılandırma sağlayıcısı 

FileConfigurationProvider, dosya sisteminden yapılandırma yüklemeye yönelik temel 
sınıftır. Aşağıdaki yapılandırma sağlayıcıları belirli dosya türlerine ayrılmıştır: 

• INı yapılandırma sağlayıcısı 

• JSON yapılandırma sağlayıcısı 

• XML yapılandırma sağlayıcısı 

INı yapılandırma sağlayıcısı 

IniConfigurationProvider, çalışma zamanında ıNı dosyası anahtar-değer çiftlerinden 
yapılandırmayı yükler. 

İNİ dosya yapılandırmasını etkinleştirmek için bir ConfigurationBuilder örneğinde 
AddlniFile uzantısı metodunu çağırın. 

iki nokta üst üste, ıNı dosya yapılandırmasındaki bir bölüm sınırlayıcısı olarak 
kullanılabilir. 

Aşırı yüklemeler belirtmeye izin ver: 

• Dosyanın isteğe bağlı olup olmadığı. 

• Dosya değişirse yapılandırmanın yeniden yüklenip yüklenmediğini belirtir. 

• Dosyaya erişmek için kullanılan IFİleProvider. 

Uygulamanın yapılandırmasını belirtmek için konak oluştururken 
ConfigureAppConfiguration çağırın: 

.ConfigureAppConfiguration((hostingContext, config) => 

{ 

config.AddlniFile( 

"config.ini", optional: true, reloadOnChange: true); 

}) 


Bir ıNı yapılandırma dosyasına genel bir örnek: 






[section0] 

key0=value 

keyl=value 

[sectionl] 

subsection:key=value 

[section2:subsection0] 

key=value 

[section2:subsectionl] 

key=value 

Önceki yapılandırma dosyası value aşağıdaki anahtarları yükler: 

• sectionO:keyO 

• sectionO: KEY1 

• Sectionl: alt bölüm: anahtar 

• section2: subsectionO: anahtar 

• section2: subsectionl: anahtar 

JSON yapılandırma sağlayıcısı 

JsonConfigurationProvider, çalışma zamanı sırasında JSON dosya anahtar-değer 
çiftlerinden yapılandırmayı yükler. 

JSON dosya yapılandırmasını etkinleştirmek için, ConfigurationBuilder bir örneği 
üzerinde AddJsonFile uzantısı metodunu çağırın. 

Aşırı yüklemeler belirtmeye izin ver: 

• Dosyanın isteğe bağlı olup olmadığı. 

• Dosya değişirse yapılandırmanın yeniden yüklenip yüklenmediğini belirtir. 

• Dosyaya erişmek için kullanılan IFileProvider. 

createDefaultBuiider ile yeni bir ana bilgisayar Oluşturucu başlattığınızda 
AddusonFiie otomatik olarak iki kez çağrılır. Yöntemi, yapılandırmayı şuradan 
yüklemek için çağrılır: 

• appSettings.json - bu dosya ilk kez okundu. Dosyanın ortam sürümü, appSettings. 
JSON dosyası tarafından belirtilen değerleri geçersiz kılabilir. 

• appSettings. {Environment}. JSON - dosyanın ortam sürümü 

ıhostingenvironment. EnvironmentNametemel alınarak yüklenir. 

Daha fazla bilgi için varsayılan yapılandırma bölümüne bakın. 

CreateDefaultBuiider de yüklenir: 

• Ortam değişkenleri. 

• Geliştirme ortamında Kullanıcı gizli dizileri (gizli yönetici) . 

• Komut satırı bağımsız değişkenleri. 

JSON yapılandırma sağlayıcısı önce oluşturulur.Bu nedenle, Kullanıcı gizli dizileri, 
ortam değişkenleri ve komut satırı bağımsız değişkenleri, appSettings dosyaları 
tarafından ayarlanan yapılandırmayı geçersiz kılar. 

Ana bilgisayarı derlerken, appSettings. JSON ve appSettings dışındaki dosyalar için 
uygulamanın yapılandırmasını belirtecek configureAppConfiguration çağrısı yapın . { 






Environment}. JSON: 


.ConfigureAppConfiguration((hostingContext, config) => 

{ 

config.AddJsonFile( 

"config.json", optional: true, reloadOnChange: true); 

}) 

Örnek 

Örnek uygulama, AddisonFiie iki çağrı içeren konağı oluşturmak için 
createDefaultBuiider statik kolaylık yönteminden yararlanır. Yapılandırma 
appSettings. JSON ve appSettings 'ten yüklendi. {Environment}. JSON. 

1. Örnek uygulamayı çalıştırın. http://iocaihost : 500 e konumundaki uygulamaya bir 
tarayıcı açın. 

2. Çıktının, ortama bağlı olarak tabloda gösterilen yapılandırma için anahtar-değer 
çiftleri içerdiğini gözlemleyin. Günlüğe kaydetme yapılandırma anahtarları 
hiyerarşik ayırıcı olarak iki nokta ( : ) kullanır. 


ANAHTAR 

GELİŞTİRME değeri 

ÜRETİM DEĞERİ 

Günlüğe kaydetme: 

Bilgiler 

Bilgiler 

LogLevel: System 



Günlüğe kaydetme: 

Bilgiler 

Bilgiler 

LogLevel: Microsoft 



Günlüğe kaydetme: 

Hata ayıklama 

Hata 

LogLevel: default 



Allovvedkonakları 

k 

k 


XML yapılandırma sağlayıcısı 

XmlConfigurationProvider, çalışma zamanında XML dosya anahtar-değer çiftinden 
yapılandırma yükler. 

XML dosya yapılandırmasını etkinleştirmek için, ConfigurationBuilder bir örneği 
üzerinde AddXmlFile uzantısı metodunu çağırın. 

Aşırı yüklemeler belirtmeye izin ver: 

• Dosyanın isteğe bağlı olup olmadığı. 

• Dosya değişirse yapılandırmanın yeniden yüklenip yüklenmediğini belirtir. 

• Dosyaya erişmek için kullanılan IFileProvider. 

Yapılandırma anahtar-değer çiftleri oluşturulduğunda yapılandırma dosyasının kök 
düğümü yok sayılır. Dosyada bir belge türü tanımı (DTD) veya ad alanı belirtmeyin. 

Uygulamanın yapılandırmasını belirtmek için konak oluştururken 
ConfigureAppConfiguration çağırın: 







.ConfigureAppConfiguration((hostingContext, config) => 

{ 

config.AddXmlFile( 

"config.xml"j optional: true, neloadOnChange: true); 

}) 


XML yapılandırma dosyaları, yinelenen bölümler için farklı öğe adları kullanabilir: 

<?xml version="1.0" encoding="UTF-8"?> 

<configuration> 

<section0> 

<key0>value</key0> 

<keyl>value</keyl> 

</section0> 

<sectionl> 

<key0>value</key0> 

<keyl>value</keyl> 

</sectionl> 

</configuration> 

Önceki yapılandırma dosyası value aşağıdaki anahtarları yükler: 

• sectionO:keyO 

• sectionO: KEY1 

• sectionl :keyO 

• Sectionl: KEY1 

Aynı öğe adını kullanan tekrarlanan öğeler, name özniteliği öğeleri ayırt etmek için 
kullanılırsa çalışır: 

<?xml version="1.0" encoding="UTF-8"?> 

<configuration> 

csection name="section0"> 

<key name="key0">value</key> 

<key name="keyl">value</key> 

</section> 

csection name="sectionl"> 

<key name="key0">value</key> 

<key name="keyl">value</key> 

</section> 

</configuration> 

Önceki yapılandırma dosyası value aşağıdaki anahtarları yükler: 

• Bölüm: sectionO: Key: KeyO 

• Bölüm: sectionO: Key: KEY1 

• Bölüm: Sectionl: Key: KeyO 

• Bölüm: Sectionl: Key: KEY1 

Öznitelikler, değerler sağlamak için kullanılabilir: 








<?xml version="1.0" encoding="UTF-8"?> 

<configuration> 

<key attribute="value" /> 

<section> 

<key attribute="value" /> 

</section> 

</configuration> 

Önceki yapılandırma dosyası value aşağıdaki anahtarları yükler: 

• anahtar: öznitelik 

• Section: Key: özniteliği 

Dosya başına anahtar yapılandırma sağlayıcısı 

KeyPerFileConfigurationProvider, dizin dosyalarını yapılandırma anahtar-değer çiftleri 
olarak kullanır. Anahtar, dosya adıdır. Değer, dosyanın içeriğini içerir. Dosya başına 
anahtar yapılandırma sağlayıcısı Docker barındırma senaryolarında kullanılır. 

Dosya başına anahtar yapılandırması ’nı etkinleştirmek için, ConfigurationBuilder bir 
örneği üzerinde AddKeyPerFile uzantısı metodunu çağırın. Dosyaların directoryPath 
mutlak bir yol olmalıdır. 

Aşırı yüklemeler belirtmeye izin ver: 

• Kaynağı yapılandıran bir Action<KeyPerFileConfigurationSource> temsilcisi. 

• Dizinin isteğe bağlı olup olmadığını ve dizinin yolunu belirtir. 

Çift alt çizgi (_), dosya adlarında bir yapılandırma anahtarı sınırlayıcısı olarak 

kullanılır. Örneğin, Logging_LogLevel_System dosya adi Logging:Logl_evel:System 

yapılandırma anahtarını üretir. 

Uygulamanın yapılandırmasını belirtmek için konak oluştururken 
ConfigureAppConfiguration çağırın: 

.ConfigureAppConfiguration((hostingContext, config) => 

{ 

var path = Path.Combine( 

Directory.GetCurrentDirectory (), "path/to/files"); 
config.AddKeyPerFile(directoryPath: path, optional: true); 

}) 


Bellek yapılandırma sağlayıcısı 

MemoryConfigurationProvider, yapılandırma anahtar-değer çiftleri olarak bellek içi 
koleksiyon kullanır. 

Bellek içi koleksiyon yapılandırmasını etkinleştirmek için, ConfigurationBuilder bir 
örneği üzerinde AddlnMemoryCollection uzantısı metodunu çağırın. 

Yapılandırma sağlayıcısı bir iEnumerabie<KeyvaiuePair<string,string>> başlatılabilir. 

Uygulamanın yapılandırmasını belirtmek için Konağı derlerken 
ConfigureAppConfiguration çağrısı yapın. 

Aşağıdaki örnekte bir yapılandırma sözlüğü oluşturulur: 











public static readonly Dictionary<stringj string> _dict = 
new Dictionary<stringj string> 

{ 

{"MemoryCollectionKeyl ", "valuel"}, 

{"MemoryCollectionKey2 ", "value2"} 

}; 

Sözlük, yapılandırmayı sağlamak için bir AddinMemoryCoiiection çağrısıyla kullanılır: 

.ConfigureAppConfiguration((hostingContext, config) => 

{ 

config.AddInMemoryCollection(_dict); 

}) 


GetValue 

Configurationciltçi. GetValue <T > , belirli bir anahtarla yapılandırmadan tek bir değer 
ayıklar ve belirtilen koleksiyon olmayan türe dönüştürür. Aşırı yükleme varsayılan bir 
değeri kabul eder. 

Aşağıdaki örnek: 

• Anahtar NumberKey , yapılandırmadan dize değerini ayıklar. Yapılandırma 
anahtarlarında NumberKey bulunmazsa, varsayılan 99 değeri kullanılır. 

• Değeri bir int olarak türler. 

• Değeri, sayfanın kullanımı için NumberConfig özelliği içinde depolar. 


public class IndexModel : PageModel 
{ 

public IndexModel(IConfiguration config) 

{ 

_config = config; 

} 

public int NumberConfig { get; private set; } 

public void OnGet() 

{ 

NumberConfig = _config.GetValue<int>("NumberKey", 99); 

} 


GetSection, GetChildren ve Exists 

izleyen örnekler için aşağıdaki JSON dosyasını göz önünde bulundurun, iki bölüm 
arasında dört anahtar bulunur ve bunlardan biri alt bölümleri çifti içerir: 











{ 

"section0": { 

"key0": "value", 

"keyl": "value" 

}, 

"sectionl": { 

"key0": "value", 

"keyl": "value" 

}, 

"section2": { 

"subsection0" : { 

"key0": "value", 

"keyl": "value" 

}, 

"subsectionl" : { 

"key0": "value", 

"keyl": "value" 

} 

} 

} 

Dosya yapılandırmaya okunduğu zaman yapılandırma değerlerini tutmak için 
aşağıdaki benzersiz hiyerarşik anahtarlar oluşturulur: 

• sectionO:keyO 

• sectionO: KEY1 

• sectionl :keyO 

• Sectionl: KEY1 

• section2:subsection0:key0 

• section2: subsectionO: KEY1 

• section2:subsection1 :keyO 

• section2: subsectionl: KEY1 

GetSection 

Iconation. GetSection , belirtilen alt bölüm anahtarıyla bir yapılandırma alt bölümü 
ayıklar. 

sectionl yalnızca anahtar-değer çiftlerini içeren bir IConfigurationSection 
döndürmek için GetSection çağırın ve bölüm adını sağlayın: 

var configSection = _config.GetSection("sectionl"); 

configSection bir değer, yalnızca bir anahtar ve yol yoktur. 

Benzer şekilde, section2:subsection@ anahtarlar için değerleri almak için, GetSection 
çağırın ve Bölüm yolunu sağlayın: 

var configSection = _config.GetSection("section2:subsection0"); 

GetSection hiçbir şekilde nuiı döndürmez. Eşleşen bir bölüm bulunamazsa boş bir 
IConfigurationSection döndürülür. 

GetSection eşleşen bir bölüm döndürdüğünde Value doldurulmuyor. Bölüm mevcut 
olduğunda bir Key ve Path döndürülür. 


GetChildren 











section 2 üzerinde Iconation. GetChildren çağrısı, şunları içeren bir 
IEnumerable<IConfigurationSection> edinir: 

• subsection0 

• subsectionl 

var configSection = _config.GetSection("section2"); 
var children = configSection.GetChildren(); 


Bulunur 

Bir yapılandırma bölümünün mevcut olup olmadığını anlamak için 

Configurationextensions. Exists kullanın: 

var sectionExists = _config.GetSection("section2:subsection2")•Exists(); 

Örnek veriler verildiğinde, yapılandırma verilerinde bir section 2 :subsection 2 bölümü 
olmadığından sectionExists faise . 

Bir sınıfa bağlama 

Yapılandırma, Seçenekler moc/e/z'n/kullanarak ilgili ayarların gruplarını temsil eden 
sınıflara bağlanabilir. Daha fazla bilgi için bkz. ASP.NET Core için seçenek kalıbı. 

Yapılandırma değerleri dizeler olarak döndürülür, ancak Bind çağrısı poco nesnelerinin 
oluşturulmasını mümkün yapar. 

Örnek uygulama bir starship modeli içerir (modeller/Başlangıçgönder. cs): 

public class Starship 
{ 

public string Name { get; set; } 
public string Registry { get; set; } 
public string Class { get; set; } 
public decimal Length { get; set; } 
public bool Commissioned { get; set; } 

} 


public class Starship 
{ 

public string Name { get; set; } 
public string Registry { get; set; } 
public string Class { get; set; } 
public decimal Length { get; set; } 
public bool Commissioned { get; set; } 

} 

Starsevk. JSON dosyasının starship bölümü, örnek uygulama yapılandırmayı 
yüklemek İçin JSON yapılandırma sağlayıcısını kullandığında yapılandırmayı 
oluşturur: 











{ 

"starship": { 

"name": "USS Enterprise", 

"registry": "NCC-1701", 

"class": "Constitution", 

"length": 304.8, 

"commissioned": false 

b 

"trademark": "Paramount Pictures Corp. http://www.paramount.com" 

} 


{ 

"starship": { 

"name": "USS Enterprise", 
"registry": "NCC-1701", 
"class": "Constitution", 
"length": 304.8, 
"commissioned": false 

b 


"trademark": "Paramount Pictures Corp. 

} 

http://www.paramount.com" 

Aşağıdaki yapılandırma anahtar-değer çiftleri oluşturulur: 

ANAHTAR 

DEĞER 

starsevk: ad 

USS kurumsal 

starsevk: kayıt defteri 

NCC-1701 

starsevk: sınıfı 

Anaytion 

başlangıçgönder: Uzunluk 

304,8 

starsevkiyat: Commissioned 

False 

dır 

Paramount resimleri Corp. 

https://www.paramount.com 


Örnek uygulama, starship anahtarıyla Getsection çağırır, starship anahtar-değer 
çiftleri yalıtılmıştır. Bind yöntemi, starship sınıfının bir örneğinde geçen alt bölümde 
çağrılır. Örnek değerlerini bağladıktan sonra örnek, işleme için bir özelliğe atanır: 

var starship = new Starship(); 

_config.GetSection("starship").Bind(starship); 

Starship = starship; 


var starship = new Starship(); 

_config. Getsection ("starship"). Bind (starship); 
Starship = starship; 


Bir nesne grafiğine bağlama 


Bind, tüm POCO nesne grafiğini bağlama yeteneğine sahiptir. 











Örnek, nesne grafı Metadata ve Actors sınıfları (modeller/TvShov/. cs) içeren bir 
TvShow modeli içerir: 

public class TvShow 

{ 

public Metadata Metadata { get; set; } 
public Actors Actors { get; set; } 
public string Legal { get; set; } 

} 

public class Metadata 

{ 

public string Series { get; set; } 
public string Title { get; set; } 
public DateTime AirDate { get; set; } 
public int Episodes { get; set; } 

} 

public class Actors 

{ 

public string Names { get; set; } 

} 


public class TvShow 

{ 

public Metadata Metadata { get; set; } 
public Actors Actors { get; set; } 
public string Legal { get; set; } 

} 

public class Metadata 

{ 

public string Series { get; set; } 
public string Title { get; set; } 
public DateTime AirDate { get; set; } 
public int Episodes { get; set; } 

} 

public class Actors 

{ 

public string Names { get; set; } 

} 

Örnek uygulama, yapılandırma verilerini içeren bir tvshovv. xml dosyasına sahiptir: 

<?xml version="1.0" encoding="UTF-8"?> 

<configuration> 

<tvshow> 

<metadata> 

<series>Dr. Who</series> 

<title>The Sun Makers</title> 

<airdate>ll/26/1977</airdate> 

<episodes>4</episodes> 

</metadata> 

<actors> 

<names>Tom Baker, Louise lameson, Tohn Leeson</names> 

</actors> 

<legal>(c)1977 BBC https://www.bbc.co.uk/programmes/b006q2x0</legal> 
</tvshow> 

</configuration> 







<?xml version="1.0" encoding="UTF-8"?> 

<configuration> 

<tvshow> 

<metadata> 

<series>Dr. Who</series> 

<title>The Sun Makers</title> 

<airdate>ll/26/1977</airdate> 

<episodes>4</episodes> 

</metadata> 

<actors> 

<names>Tom Baker, Louise Dameson, 9ohn Leeson</names> 

</actors> 

<legal>(c)1977 BBC https://www.bbc .co.uk/programmes/b006q2x0</legal> 
</tvshow> 

</configuration> 

Yapılandırma, Bind yöntemi ile TvShow nesne grafiğinin tamamına bağlanır. 
Bağlantılı örnek, işleme için bir özelliğe atandı: 

var tvShow = new TvShow(); 

_config.GetSection("tvshow").Bind(tvShow); 

TvShow = tvShow; 

Configurationciltçi. Get <T > bağlar ve belirtilen türü döndürür. Get<T> , Bind 
kullanmaktan daha uygundur. Aşağıdaki kod, ilişkili örneğin işleme için kullanılan 
özelliğe doğrudan atanmasını sağlayan önceki örnekle Get<T> nasıl kullanacağınızı 
gösterir: 

TvShow = _config.GetSection("tvshow").Get<TvShow>(); 


TvShow = _config.GetSection("tvshow").Get<TvShow>(); 


Bir diziyi sınıfa bağlama 

Örnek uygulama, bu bölümde açıklanan kavramları gösterir. 

Bind, yapılandırma anahtarlarındaki dizi dizinlerini kullanan nesnelere dizileri 
bağlamayı destekler. Sayısal anahtar segmentini ( : 0 : , :i: ,... :{n}: ) sunan 
herhangi bir dizi biçimi, bir POCO sınıf dizisine dizi bağlama özelliğine sahiptir. 


NOTE 

Bağlama, kural tarafından sağlanır. Dizi bağlamayı uygulamak için özel yapılandırma 
sağlayıcıları gerekli değildir. 


Bellek içi dizi işleme 

Aşağıdaki tabloda gösterilen yapılandırma anahtarlarını ve değerlerini göz önünde 
bulundurun. 

ANAHTAR DEĞER 


dizi: girdiler: 0 


valueO 












ANAHTAR 


DEĞER 


dizi: girdiler: 1 

valuel 

dizi: girdiler: 2 

value2 

dizi: girdiler: 4 

value4 

dizi: girdiler: 5 

value5 

Bu anahtarlar ve değerler, bellek yapılandırma 
uygulamaya yüklenir: 

sağlayıcısı kullanılarak örnek 


public class Program 

{ 

public static Dictionarycstring, string> arrayDict = 
new Dictionarycstring, string> 

{ 

{"arrayrentries:0", "value0"}, 

{"array:entries:l", "valuel"}, 

{"array:entries:2", "value2"}, 

{"array:entries:4", "value4"}, 

{"array:entries:5", "value5"} 

}; 

public static void Main(string[] args) 

{ 

CreateHostBuilder(args).Build().Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureAppConfiguration((hostingContext, config) => 

{ 

config.AddInMemoryCollection(arrayDict); 
config.AddısonFile( 

"json_array.json", optional: false, reloadOnChange: false); 
config.AddısonFile( 

"starship.json", optional: false, reloadOnChange: false); 
config.AddXmlFile( 

"tvshow.xml", optional: false, reloadOnChange: false); 
config.AddEFConfiguration( 

options => options.UseInMemoryDatabase("InMemoryDb")); 
config.AddCommandLine(args); 

}) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 

} 



public class Program 

{ 

public static Dictionary<string, string> arrayDict = 
new Dictionary<string, string> 

{ 

{"array:entries:0", "value0"}, 

{"array:entries:1", "valuel"}, 

{"array:entries:2", "value2"}, 

{"array:entries:4", "value4"}, 

{"array:entries:5", "value5"} 

}; 

public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build().Run(); 

} 

public static IklebHostBuilder CreateWebHostBuilder(string[] args) => 
WebHost.CreateDefaultBuilder(args) 

.ConfigureAppConfiguration((hostingContext, config) => 

{ 

config.AddInMemoryCollection(arrayDict); 
config.AddısonFile( 

"json_array.json", optional: false 3 reloadOnChange: false); 
config.AddısonFile( 

"starship.json"j optional: false, reloadOnChange: false); 
config.AddXmlFile( 

"tvshow.xml", optional: false, reloadOnChange: false); 
config.AddEFConfiguration( 

options => options.UseInMemoryOatabase("InMemoryDb")); 
config.AddCommandLine(args); 

}) 

.UseStartup<Startup>(); 


Dizi, Dizin #3 için bir değer atlar. Yapılandırma Bağlayıcısı, null değerleri bağlama veya 
bağlantılı nesnelerde null girişler oluşturma yeteneğine sahip değildir. Bu, bu diziyi bir 
nesneye bağlamanın sonucu gösterildiği sırada bir süre açık hale gelir. 

Örnek uygulamada, bir POCO sınıfı, bağlantılı yapılandırma verilerini tutmak için 
kullanılabilir: 


public class ArrayExample 

{ 

public stringf] Entries { get; set; } 

} 


public class ArrayExample 

{ 

public string[] Entries { get; set; } 

} 

Yapılandırma verileri nesnesine bağlanır: 

var arrayExample = new ArrayExample(); 

_config.GetSection("array").Bind(arrayExample); 

Configurationciltçi. Get <T > sözdizimi de kullanılabilir ve bu da daha küçük kod elde 
edilebilir: 





ArrayExample = _config.GetSection("array").Get<AnrayExample>(); 


ArrayExample = _config.GetSection("array").Get<AnrayExample>(); 


ArrayExampie bir örneği olan bağlantılı nesne, yapılandırmadan dizi verilerini alır. 


ARRAYEXAMPLE.ENTRIES DİZİNİ 


ARRAYEXAMPLE.ENTRIES değeri 


valueO 


valuel 


value2 


value4 


value5 


ilişkili nesnedeki Dizin #3, array:4 yapılandırma anahtarı ve vaiue4 değeri için 
yapılandırma verilerini tutar. Bir diziyi içeren yapılandırma verileri bağlandığında, 
yapılandırma anahtarlarındaki dizi dizinleri yalnızca nesne oluşturulurken 
yapılandırma verilerini yinelemek için kullanılır. Yapılandırma verilerinde null değer 
korunmaz ve bir yapılandırma anahtarlarındaki bir dizi bir veya daha fazla dizini 
atlamazsanız, bağlantılı nesnede NULL değerli bir giriş oluşturulmaz. 

Yapılandırmada doğru anahtar-değer çiftini üreten herhangi bir yapılandırma 
sağlayıcısı tarafından ArrayExampie örneğine bağlamadan önce dizin #3 için eksik 
yapılandırma öğesi sağlanabilir. Örnek, eksik anahtar-değer çiftine sahip ek bir JSON 
yapılandırma sağlayıcısı içeriyorsa, ArrayExampie.Entries tam yapılandırma dizisiyle 
eşleşir: 

missing_value. JSON: 


"arrayrentries:3": "value3" 


ConfigureAppConfiguration 


config.AddJsonFile( 

"missing_value.json' 

optional: false, reloadOnChange: false); 


Tabloda gösterilen anahtar-değer çifti, yapılandırmaya yüklendi. 


ANAHTAR 


DEĞER 


dizi: girdiler: 3 


value3 


ArrayExampie sınıf örneği, JSON yapılandırma sağlayıcısı Dizin #3 1 ün girdisini 
içeriyorsa, ArrayExampie.Entries dizisi değeri içerir. 








ARRAYEXAMPLE.ENTRIES DİZİNİ ARRAYEXAMPLE.ENTRIES değeri 


0 

valueO 

1 . 

valuel 

2 

value2 

3 

value3 

4 

value4 

5 

value5 


JSON dizi işleme 

JSON dosyası bir dizi içeriyorsa, sıfır tabanlı bölüm diziniyle dizi öğeleri için 
yapılandırma anahtarları oluşturulur. Aşağıdaki yapılandırma dosyasında, subsection 
bir dizidir: 


{ 

"json_array": { 
"key": "valueA", 
"subsection": [ 
"valueB", 
"valueC", 
"valueD" 

] 

} 

} 


{ 

"json_array": { 
"key": "valueA", 
"subsection": [ 
"valueB", 
"valueC", 
"valueD" 

] 

} 

} 


JSON yapılandırma sağlayıcısı, yapılandırma verilerini aşağıdaki anahtar-değer 
çiftlerine okur: 

ANAHTAR DEĞER 


json_array: anahtar 

değer EA 

json_array: alt bölüm: 0 

valueB 

json_array: alt bölüm: 1 

değer EC 

json_array: alt bölüm: 2 

Değerler 


Örnek uygulamada, yapılandırma anahtar-değer çiftlerini bağlamak için aşağıdaki 






POCO sınıfı kullanılabilir: 


public class ]sonArrayExample 
{ 

public string Key { get; set; } 
public stringf] Subsection { get; set; } 

} 


public class lsonArrayExample 
{ 

public string Key { get; set; } 
public string[] Subsection { get; set; } 

} 

Bağlamadan sonra, isonArrayExampie.Key valueA değerini tutar. Alt bölüm değerleri, 
Subsection POCO dizisi özelliğinde depolanır. 

DSONARRAYEXAMPLE.SUBSECTİON DİZİNİ D SONARRAYEXAMP L E.SUBSECTİON değeri 


0 


valueB 


1. değer EC 

2 Değerler 


Özel yapılandırma sağlayıcısı 

Örnek uygulama, Entity Framevvork (EF)kullanarak bir veritabanından yapılandırma 
anahtar-değer çiftlerini okuyan temel bir yapılandırma sağlayıcısı oluşturmayı gösterir. 

Sağlayıcı aşağıdaki özelliklere sahiptir: 

• EF bellek içi veritabanı, tanıtım amacıyla kullanılır. Bağlantı dizesi gerektiren bir 
veritabanını kullanmak için, başka bir yapılandırma sağlayıcısından bağlantı 
dizesini sağlamak üzere ikincil configurationBulider uygulayın. 

• Sağlayıcı bir veritabanı tablosunu başlangıçta yapılandırmaya okur.Sağlayıcı, her 
anahtar temelinde veritabanını sorgulayamaz. 

• Değişiklik değişikliği uygulanmadı, bu nedenle uygulama başladıktan sonra 
veritabanının güncelleştirilmesi uygulamanın yapılandırması üzerinde hiçbir etkiye 
sahip değildir. 

Yapılandırma değerlerini veritabanında depolamak için bir EFConfigurationvalue 
varlığı tanımlayın. 

Modeller/EFConfigurationValue. cs: 

public class EFConfigurationvalue 
{ 

public string Id { get; set; } 
public string Value { get; set; } 

} 

Yapılandırılan değerleri depolamak ve erişmek için bir EFConfigurationContext 
ekleyin. 









Efconfigurationprovider/EFConfigurationContext. cs: 


public class EFConfigurationContext : DbContext 
{ 

public EFConfigurationContext(DbContextOptions options) : base(options) 

{ 

} 

public DbSet<EFConfigurationValue> Values { get; set; } 

} 

IConfigurationSourceuygulayan bir sınıf oluşturun. 
Efconfiguratlonprovider/EFConfigurationSource. cs: 

public class EFConfigurationSource : IConfigurationSource 
{ 

private readonly Action<DbContextOptionsBuilder> _optionsAction; 

public EFConfigurationSource(Action<DbContextOptionsBuilder> optionsAction) 

{ 

_optionsAction = optionsAction; 

} 

public IConfigurationProvider Build(IConfigurationBuilder builder) 

{ 

return new EFConfigurationProvider(_optionsAction); 

} 

} 

ConfigurationProviderdevralan özel yapılandırma sağlayıcısını oluşturun. 
Yapılandırma sağlayıcısı boş olduğunda veritabanını başlatır. Yapılandırma anahtarları 
büyük/küçük harfe duyarsızolduğundan, veritabanını başlatmak için kullanılan sözlük, 
büyük/küçük harf duyarsız karşılaştırıcı (StringComparer. OrdinallgnoreCase) ile 
oluşturulur. 

Efconfigurationprovider/efconfigurationprovider. cs: 



public class EFConfigurationProvider : ConfigurationProvider 

{ 

public EFConfigurationProvider(Action<DbContextOptionsBuilder> optionsAction) 

{ 

OptionsAction = optionsAction; 

} 

Action<DbContextOptionsBuilder> OptionsAction { get; } 

// Load config data from EF DB. 
public override void Load() 

{ 

var builder = new DbContextOptionsBuilder<EFConfigurationContext>(); 
OptionsAction(builder); 

using (var dbContext = new EFConfigurationContext(builder.Options)) 

{ 

dbContext.Database.EnsureCreated(); 

Data = !dbContext.Values.Any() 

? CreateAndSaveDefaultValues(dbContext) 

: dbContext.Values.ToDictionary(c => c.Id, c => c.Value); 

} 

} 

private static IDictionary<string, string> CreateAndSaveDefaultValues( 
EFConfigurationContext dbContext) 

{ 

// Quotes (c)2005 Universal Pictures: Serenity 
// https://www.uphe.com/movies/serenity 
var configValues = 

new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase) 

{ 

{ "quotel", "I aim to misbehave." }, 

{ "quote2"j "I swallowed a bug." }, 

{ "quote3", "You can't stop the signal, Mal." } 

}J 

dbContext.Values.AddRange(configValues 

.Select(kvp => new EFConfigurationValue 

{ 

Id = kvp.Key, 

Value = kvp.Value 

}) 

.ToArrayO); 

dbContext.SaveChanges(); 
return configValues; 

} 

} 

AddEFConfiguration uzantısı yöntemi, yapılandırma kaynağının bir 
configurationBuiider eklenmesine izin verir. 


UzantLlar/EntityFrameworkExtensions. cs: 


public static class EntityFrameworkExtensions 

{ 

public static IConfigurationBuilder AddEFConfiguration( 
this IConfigurationBuilder builder, 

Action<DbContextOptionsBuilder> optionsAction) 

{ 

return builder.Add(new EFConfigurationSource(optionsAction)); 

} 

} 

Aşağıdaki kod, program .csiçinde özel EFConfigurationProvider nasıl kullanacağınızı 
gösterir: 

public class Program 

{ 

public static Dictionarycstring, string> arrayDict = 
new Dictionary<string, string> 

{ 

{"array:entries:0", "value0"}, 

{"array:entries:l", "valuel"}, 

{"array:entries:2", "value2"}, 

{"array:entries:4", "value4"}, 

{"array:entries:5", "value5"} 

}; 

public static void Main(string[] args) 

{ 

CreateHostBuilder(args).Build().Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureAppConfiguration((hostingContext, config) => 

{ 

config.AddInMemoryCollection(arrayDict); 
config.AddısonFile( 

"js°n_array.json", optional: false 3 reloadOnChange: false); 
config.AddısonFile( 

"starship.json ", optional: false, reloadOnChange: false); 
config.AddXmlFile( 

"tvshow.xml", optional: false, reloadOnChange: false); 
config.AddEFConfiguration( 

options => options.UseInMemoryDatabase("InMemoryDb")); 
config.AddCommandLine(args); 

}) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 

} 


Modeller/EFConfigurationValue. cs: 

public class EFConfigurationValue 

{ 

public string Id { get; set; } 
public string Value { get; set; } 

} 


Yapılandırılan değerleri depolamak ve erişmek için bir EFConfigurationContext 
ekleyin. 







Efconfigurationprovider/EFConfigurationContext. cs: 


public class EFConfigurationContext : DbContext 

{ 

public EFConfigurationContext(DbContextOptions options) : base(options) 

{ 

} 

public DbSet<EFConfigurationValue> Values { get; set; } 

} 

IConfigurationSourceuygulayan bir sınıf oluşturun. 
Efconfigurationprovider/EFConfigurationSource. cs: 

public class EFConfigurationSource : IConfigurationSource 

{ 

private readonly Action<DbContextOptionsBuilder> _optionsAction; 

public EFConfigurationSource(Action<DbContextOptionsBuilder> optionsAction) 

{ 

_optionsAction = optionsAction; 

} 

public IConfigurationProvider Build(IConfigurationBuilder builder) 

{ 

return new EFConfigurationProvider(_optionsAction); 

} 

} 

ConfigurationProvideıdevralan özel yapılandırma sağlayıcısını oluşturun. 
Yapılandırma sağlayıcısı boş olduğunda veritabanını başlatır. 

Efconflgurationprovider/efconfigurationprovider. cs: 



public class EFConfigurationProvider : ConfigurationProvider 

{ 

public EFConfigurationProvider(Action<DbContextOptionsBuilder> optionsAction) 

{ 

OptionsAction = optionsAction; 

} 

Action<DbContextOptionsBuilder> OptionsAction { get; } 

// Load config data from EF DB. 
public override void Load() 

{ 

var builder = new DbContextOptionsBuilder<EFConfigurationContext>(); 
OptionsAction(builder); 

using (var dbContext = new EFConfigurationContext(builder.Options)) 

{ 

dbContext.Database.EnsureCreated(); 

Data = !dbContext.Values.Any() 

? CreateAndSaveDefaultValues(dbContext) 

: dbContext.Values.ToDictionary(c => c.Id, c => c.Value); 

} 

} 

private static IDictionary<string, string> CreateAndSaveDefaultValues( 
EFConfigurationContext dbContext) 

{ 

// Quotes (c)2005 Universal Pictures: Serenity 
// https://www.uphe.com/movies/serenity 
var configValues = 

new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase) 

{ 

{ "quotel", "I aim to misbehave." }, 

{ "quote2"j "I swallowed a bug." }, 

{ "quote3", "You can't stop the signal, Mal." } 

}J 

dbContext.Values.AddRange(configValues 

.Select(kvp => new EFConfigurationValue 

{ 

Id = kvp.Key, 

Value = kvp.Value 

}) 

.ToArrayO); 

dbContext.SaveChanges(); 
return configValues; 

} 

} 

AddEFConfiguration uzantısı yöntemi, yapılandırma kaynağının bir 
configurationBuiider eklenmesine izin verir. 


UzantLlar/EntityFrameworkExtensions. cs: 


public static class EntityFrameworkExtensions 

{ 

public static IConfigurationBuilder AddEFConfiguration( 
this IConfigurationBuilder builder, 

Action<DbContextOptionsBuilder> optionsAction) 

{ 

return builder.Add(new EFConfigurationSource(optionsAction)); 

} 

} 

Aşağıdaki kod, program .csiçinde özel EFConfigurationProvider nasıl kullanacağınızı 
gösterir: 

public class Program 

{ 

public static Dictionarycstring, string> arrayDict = 
new Dictionary<string, string> 

{ 

{"array:entries:0", "value0"}, 

{"array:entries:l", "valuel"}, 

{"array:entries:2", "value2"}, 

{"array:entries:4", "value4"}, 

{"array:entries:5", "value5"} 

}; 

public static void Main(string[] args) 

{ 

Createl/JebHost Builder (args).Build().Run(); 

} 

public static IUebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.ConfigureAppConfiguration((hostingContext, config) => 

{ 

config.AddInMemoryCollection(arrayDict); 
config.AddısonFile( 

"js°n_array.json ", optional: false 3 reloadOnChange: false); 
config.AddısonFile( 

"starship.json ", optional: false, reloadOnChange: false); 
config.AddXmlFile( 

"tvshow.xml", optional: false, reloadOnChange: false); 
config.AddEFConfiguration( 

options => options.UseInMemoryDatabase("InMemoryDb")); 
config.AddCommandLine(args); 

}) 

.UseStartup<Startup>(); 


Başlangıç sırasında yapılandırmaya erişim 

startup.configureServices yapılandırma değerlerine erişmek için startup 
oluşturucusuna ıconfiguration ekleyin, startup.configure yapılandırmaya erişmek 
için ıconfiguration doğrudan yönteme ekleyin ya da oluşturucuyu kullanarak örneği 
kullanın: 









public class Startup 

{ 

private readonly IConfiguration _config; 

public Startup(IConfiguration config) 

{ 

_config = configj 

} 

public void ConfigureServices(IServiceCollection Services) 

{ 

var value = _config["key"]; 

} 

public void Configure(IApplicationBuilder app, IConfiguration config) 

{ 

var value = config["key "]; 

} 


Başlangıç kolaylığı yöntemlerini kullanarak yapılandırmaya erişme örneği için bkz. 

uygulama başlatma: kullanışlı yöntemler. 

Razor Pages sayfasında veya MVC görünümünde 
erişim yapılandırması 

Razor Pages sayfasındaki veya MVC görünümündeki yapılandırma ayarlarına erişmek 
için, Microsoft. Extensions. Configuration ad alanı için bir using yönergesi ( C# 
başvuru: using yönergesi) ekleyin ve sayfa ya da görünüme IConfiguration ekleyin. 

Razor Pages sayfasında: 

@page 

@model IndexModel 

@using Microsoft.Extensions.Configuration 
@inject IConfiguration Configuration 

<!DOCTYPE html> 
chtml lang="en"> 

<head> 

<title>Index Page</title> 

</head> 

<body> 

<hl>Access configuration in a Razor Pages page</hl> 

<p>Configuration value for 'key': @Configuration["key"]</p> 

</body> 

</html> 


MVC görünümünde: 






@using Microsoft.Extensions.Configuration 
@inject IConfiguration Configuration 

<!DOCTYPE html> 

<html lang="en"> 

<head> 

<title>Index View</title> 

</head> 

<body> 

<hl>Access configuration in an MVC view</hl> 
<p>Configuration value for 'key': @Configuration["key"]</p> 
</body> 

</html> 


Bir dış derlemeden yapılandırma Ekle 

IHostingStartup bir uygulama, uygulamanın startup sınıfının dışında bir dış 
derlemeden başlangıçta bir uygulamaya iyileştirmeler eklenmesine izin verir. Daha 
fazla bilgi için bkz. ASP.NET Core barındırma başlangıç derlemeleri kullanma. 

Ek kaynaklar 

• ASP.NET Core için seçenek kalıbı 




ASRNET Core için seçenek kalıbı 

6.12.2019 • 55 minutes to read ı Edit Online 


Tarafından Luke Latham 

Seçenekler stili, ilişkili ayarların gruplarını temsil etmek için sınıfları kullanır. Yapılandırma ayarları senaryo 
tarafından ayrı sınıflara ayrılmışsa, uygulama iki önemli yazılım mühendisliği ilkelerine uyar: 

• Yapılandırma ayarlarına bağlı olan arabirim ayırma ilkesi (ISS) veya kapsülleme - senaryoları (sınıflar) 
yalnızca kullandıkları yapılandırma ayarlarına bağlıdır. 

• Uygulamanın farklı parçaları için - ayarlarının ayrılması, birbirine bağımlı değildir veya birbirlerine 
aktarılmaz. 

Seçenekler Ayrıca yapılandırma verilerini doğrulamaya yönelik bir mekanizma sağlar. Daha fazla bilgi için 

Seçenekler doğrulama bölümüne bakın. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Paket 

Microsoft. Extensions. Options. ConfigurationExtensions paketine ASP.NET Core uygulamalarında örtük 
olarak başvurulur. 

Seçenekler arabirimleri 

IOptionsMonitor<TOptions>, TOptions örnekleri için seçenekleri almak ve seçenek bildirimlerini yönetmek 
için kullanılır. IOptionsMonitor<TOptions> aşağıdaki senaryoları destekler: 

• Değişiklik bildirimleri 

• Adlandırılmış seçenekler 

• Yeniden yüklenebilir yapılandırma 

• Seçmeli seçenekler geçersiz kılma (IOptionsMonitorCache<TOptions>) 

Yapılandırma sonrası senaryolar, tüm IConfigureOptions<TOptions> yapılandırma oluştuktan sonra 
seçenekleri ayarlamanıza veya değiştirmenize olanak sağlar. 

IOptionsFactory<TOptions> yeni seçenek örnekleri oluşturmaktan sorumludur. Tek bir Create yöntemi vardır. 
Varsayılan uygulama tüm kayıtlı IConfigureOptions<TOptions> ve IPostConfigureOptions<TOptions> alır ve 
önce tüm yapılandırmaların, ardından yapılandırma sonrası sonrasında çalıştırılır. 

IConfigureNamedOptions<TOptions> ve IConfigureOptions<TOptions> arasında ayrım yapar ve yalnızca 
uygun arabirimi çağırır. 

IOptionsMonitorCache<TOptions>, IOptionsMonitor<TOptions> tarafından TOptions örnekleri önbelleğe 
almak için kullanılır. IOptionsMonitorCache<TOptions>, değer yeniden hesaplanabilmesi için izleyici içindeki 
seçenek örneklerini geçersiz kılar (TryRemove). Değerler, TryAddile el ile tanıtılamaz. Clear yöntemi, tüm 
adlandırılmış örneklerin isteğe bağlı olarak yeniden oluşturulması gerektiğinde kullanılır. 

IOptionsSnapshot<TOptions>, her istekte seçeneklerin yeniden hesaplanması gereken senaryolarda 
faydalıdır. Daha fazla bilgi için bkz. loptionssnapshot ile yapılandırma verilerini yeniden yükleme bölümü. 

IOptions<TOptions>, seçenekleri desteklemek için kullanılabilir. Ancak, IOptions<TOptions> önceki 
IOptionsMonitor<TOptions>senaryolarını desteklemez. Zaten IOptions<TOptions> arabirimini kullanan 





mevcut çerçeveler ve kitaplıklarda IOptions<TOptions> kullanmaya devam edebilir ve 
IOptionsMonitor<TOptions>tarafından sağlanmış senaryolara gerek kalmaz. 

Genel Seçenekler yapılandırması 

Genel Seçenekler yapılandırması örnek uygulamada #1 olarak gösterilmiştir. 

Bir seçenek sınıfı ortak parametresiz bir Oluşturucu ile soyut olmamalıdır. Aşağıdaki MyOptions sınıfında, 
Optioni ve 0 ption 2 iki özelliği vardır. Varsayılan değerleri ayarlama isteğe bağlıdır, ancak aşağıdaki örnekteki 
sınıf oluşturucusu Optioni varsayılan değerini ayarlar. 0ption2 , özelliği doğrudan başlatarak varsayılan değer 
kümesine sahiptir ( modeller/MyOptions. cs): 

public class MyOptions 

{ 

public MyOptions() 

{ 

// Set default value. 

Optioni = "valuel_from_ctor"; 

} 

public string Optioni { get; set; } 
public int 0ption2 { get; set; } = 5; 

} 

MyOptions sınıfı, Configure ve yapılandırmayla bağlantılı olarak hizmet kapsayıcısına eklenir: 

// Example #1: General configuration 

// Register the Configuration instance which MyOptions binds against. 

Services.ConfigurecMyOptions>(Configuration); 


Aşağıdaki sayfa modeli, ayarlara erişmek için IOptionsMonitor<TOptions> ile Oluşturucu bağımlılığı ekleme 
işlemini kullanır ( Sayfalar/lndex. cshtml. cs): 

private readonly MyOptions _options; 


public IndexModel( 

IOptionsMonitor<MyOptions> optionsAccessor, 

IOptionsMonitor<MyOptionsWithDelegateConfig> optionsAccessorl/JithDelegateConfig, 
IOptionsMonitor<MySubOptions> subOptionsAccessor, 

IOptionsSnapshot<MyOptions> snapshotOptionsAccessor, 

IOptionsSnapshot<MyOptions> namedOptionsAccessor) 

{ 

_options = optionsAccessor.CurrentValue; 

_optionsWithDelegateConfig = optionsAccessorWithDelegateConfig.CurrentValue; 
_subOptions = subOptionsAccessor.CurrentValue; 

_snapshotOptions = snapshotOptionsAccessor.Value; 

_named_options_l = namedOptionsAccessor.Get("named_options_l"); 

_named_options_2 = namedOptionsAccessor.Get("named_options_2"); 

} 


// Example #1: Simple options 
var optioni = _options.Optioni; 
var option2 = _options.0ption2; 

SimpleOptions = $"optionl = {optioni}, option2 = {option2}"; 


Örneğin appSettings. JSON dosyası optioni ve option 2 değerlerini belirtir: 









{ 




"optionl": "valuel_fnom_json", 

"option2": -1, 

"subsection": { 


"suboptionl": 

"subvaluel_from_json ", 


"suboption2": 

b 

"Logging": { 
"LogLevel": { 

200 


"Default": 

"Information", 


"Microsoft" 

: "lAİarning", 


"Microsoft. 

} 

b 

Hosting.Lifetime": "Information" 

} 

"AllowedHosts": 

M * M 


Uygulama çalıştırıldığında, sayfa modelinin onGet yöntemi, seçenek sınıfı değerlerini gösteren bir dize 
döndürür: 


optionl = valuel_from_json, option2 = -1 


NOTE 

Bir ayarlar dosyasından seçenek yapılandırması ’nı yüklemek için özel bir ConfigurationBuilder kullanırken, temel yolun 
doğru şekilde ayarlandığını onaylayın: 

var configBuilder = new ConfigurationBuilder() 

.SetBasePath(Directory.GetCurrentDirectory()) 

.AddlsonFile("appsettings.json", optional: true); 
var config = configBuilden.Build(); 

Services.Configure<MyOptions>(config); 

Ayarlar dosyasından CreateDefaultBuilderaracılığıyla seçenek yapılandırması yüklenirken taban yolunu açıkça ayarlama 
gerekli değildir. 


Bir temsilciyle basit seçenekleri yapılandırma 

Basit seçeneklerin bir temsilciyle yapılandırılması, örnek uygulamada #2 örnek olarak gösterilmiştir. 

Seçenek değerlerini ayarlamak için bir temsilci kullanın. Örnek uygulama MyOptionsuithDeiegateConfig sınıfını 
kullanır ( modeller/MyOptionsWithDelegateConfig. cs ): 

public class MyOptionsl/dithDelegateConfig 

{ 

public MyOptionsWithDelegateConfig() 

{ 

// Set default value. 

Optionl = "valuel_from_ctor"; 

} 

public string Optionl { get; set; } 
public int 0ption2 { get; set; } = 5; 

} 


Aşağıdaki kodda, hizmet kapsayıcısına ikinci bir IConfigureOptions<TOptions> hizmeti eklenir. 
MyOptionsWithDeiegateConfig ile bağlamayı yapılandırmak için bir temsilci kullanır: 









// Example #2: Options bound and configured by a delegate 
Services.Configure<MyOptionsWithDelegateConfig>(myOptions => 
{ 

myOptions.Optionl = "valuel_configured_by_delegate"; 
my0ptions.0ption2 = 500; 

}); 


lndex.cshtml.cs\ 


private readonly MyOptionsl/dithDelegateConfig _optionsWithDelegateConfig; 


public IndexModel( 

IOptionsMonitor<MyOptions> optionsAccessor, 

IOptionsMonitor<MyOptionsWithDelegateConfig> optionsAccessorl/\lithDelegateConfig, 
IOptionsMonitor<MySubOptions> subOptionsAccessor, 

IOptionsSnapshot<MyOptions> snapshotOptionsAccessor, 

IOptionsSnapshot<MyOptions> namedOptionsAccessor) 

{ 

_options = optionsAccessor.CurrentValue; 

_optionsWithDelegateConfig = optionsAccessorWithDelegateConfig.CurrentValue; 
_subOptions = subOptionsAccessor.CurrentValue; 

_snapshotOptions = snapshotOptionsAccessor.Value; 

_named_options_l = namedOptionsAccessor.Get("named_options_l"); 

_named_options_2 = namedOptionsAccessor.Get("named_options_2"); 

} 


// Example #2: Options configured by delegate 

var delegate_config_optionl = _optionsWithDelegateConfig.Optioni; 
var delegate_config_option2 = _optionsWithDelegateConfig.0ption2; 
SimpleOptionsl/JithDelegateConfig = 

$"delegate_optionl = {delegate_config_optionl}, " + 
$"delegate_option2 = {delegate_config_option2}"; 


Birden çok yapılandırma sağlayıcısı ekleyebilirsiniz. Yapılandırma sağlayıcıları NuGet paketlerinde 
kullanılabilir ve kayıtlı oldukları sırayla uygulanır. Daha fazla bilgi için bkz. ASP.NET Core yapılandırma. 

Her Configure çağrısı, hizmet kapsayıcısına bir IConfigureOptions<TOptions> hizmeti ekler. Yukarıdaki 
örnekte, Optioni ve Option 2 değerlerinin ikisi de appSett'mgs. 7SOA/içinde belirtilmiştir, ancak Optioni ve 
0 ption 2 değerleri yapılandırılan temsilci tarafından geçersiz kılınır. 

Birden fazla yapılandırma hizmeti etkinleştirildiğinde, son yapılandırma kaynağı WINS ' i ve yapılandırma 
değerini ayarlar. Uygulama çalıştırıldığında, sayfa modelinin onGet yöntemi, seçenek sınıfı değerlerini 
gösteren bir dize döndürür: 

delegate_optionl = valuel_configured_by_delegate, delegate_option2 = 500 


Alt seçenekler yapılandırması 

Alt seçenekler yapılandırması örnek uygulamada #3 örnek olarak gösterilmiştir. 

Uygulamalar, uygulamadaki belirli senaryo gruplarına (sınıflar) ait seçenek sınıfları oluşturmamalıdır. 
Uygulamanın yapılandırma değerleri gerektiren bölümlerinin yalnızca kullandıkları yapılandırma değerlerine 
erişimi olmalıdır. 

Seçenekleri yapılandırmaya bağlama sırasında, seçenek türündeki her bir özellik property[ :sub-property: ] 









formun bir yapılandırma anahtarına bağlanır. Örneğin, MyOptions.Optioni özelliği appSettings. VSOA/içindeki 
optioni özelliğinden okunan anahtar Optioni bağımlıdır. 

Aşağıdaki kodda, hizmet kapsayıcısına üçüncü bir IConfigureOptions<TOptions> hizmeti eklenir. 
MySubOptions appSettings. JSON dosyasının subsection bölümüne bağlar: 


// Example #3: Suboptions 

// Bind options using a sub-section of the appsettings.json file. 
services.Configure<MySubOptions>(Configuration.GetSection("subsection")); 


Getsection yöntemi Microsoft.Extensions.Configuration ad alanını gerektirir. 

Örneğin appSettings. JSON dosyası, suboptioni ve suboption 2 için anahtarlar içeren bir subsection üyesini 
tanımlar: 


{ 




"optioni": "valuel_from_json", 

"option2": -1, 

"subsection": { 


"suboptioni": 

"subvaluel_from_json", 


"suboption2": 

}, 

"Logging": { 
"LogLevel": { 

200 


"Default": 

"Information", 


"Microsoft" 

: "lAİarning", 


"Microsoft. 

} 

}, 

Hosting.Lifetime": "Information" 

} 

"AllowedHosts": 

M * M 


MySubOptions sınıfı, Seçenekler değerlerini tutmak için özellikleri, Suboptioni ve Sub0ption2 tanımlar 
(. modeller/Myalt seçenekler, cs ): 


public class MySubOptions 

{ 

public MySubOptions() 

{ 

// Set default values. 

SubOptionl = "valuel_from_ctor"; 
Sub0ption2 = 5 ; 

} 

public string SubOptionl { get; set; } 
public int Sub0ption2 { get; set; } 


Sayfa modelinin onGet yöntemi, Seçenekler değerleriyle ( Pages/lndex. cshtml. cs) bir dize döndürür: 

private readonly MySubOptions _subOptions; 
















public IndexModel( 

IOptionsMonitor<MyOptions> optionsAccessor, 

IOptionsMonitor<MyOptionsWithDelegateConfig> optionsAccessorWithDelegateConfig, 
IOptionsMonitor<MySubOptions> subOptionsAccessor, 

IOptionsSnapshot<MyOptions> snapshotOptionsAccessor, 

IOptionsSnapshot<MyOptions> namedOptionsAccessor) 

{ 

_options = optionsAccessor.CurrentValue; 

_optionsWithDelegateConfig = optionsAccessorWithDelegateConfig.CurrentValue; 
_subOptions = subOptionsAccessor.CurrentValue; 

_snapshotOptions = snapshotOptionsAccessor.Value; 

_named_options_l = namedOptionsAccessor.Get("named_options_l"); 

_named_options_2 = namedOptionsAccessor.Get("named_options_2"); 

} 


// Example #3: Suboptions 

var subOptionl = _subOptions.SubOptionl; 

var sub0ption2 = _sub0ptions.Sub0ption2; 

SubOptions = $"subOptionl = {subOptionl}, sub0ption2 = {sub0ption2}"; 

Uygulama çalıştırıldığında onGet yöntemi, alt sınıf değerlerini gösteren bir dize döndürür: 

subOptionl = subvaluel_from_json, subOption2 = 200 


Seçeneklere ekleme 

Seçenekler ekleme, örnek uygulamada #4 olarak gösterilmiştir. 

IOptionsMonitor<TOptions> içine ekle: 

• @inject Razor yönergesi ile Razor sayfası veya MVC görünümü. 

• Bir sayfa veya görünüm modeli. 

Örnek uygulamadan alınan aşağıdaki örnek, bir sayfa modeline IOptionsMonitor<TOptions> 
( Sayfalar/lndex. cshtml. cs): 

private readonly MyOptions _options; 


public IndexModel( 

IOptionsMonitor<MyOptions> optionsAccessor, 

IOptionsMonitor<MyOptionsWithDelegateConfig> optionsAccessorWithDelegateConfig, 
IOptionsMonitor<MySubOptions> subOptionsAccessor, 

IOptionsSnapshot<MyOptions> snapshotOptionsAccessor, 

IOptionsSnapshot<MyOptions> namedOptionsAccessor) 

{ 

_options = optionsAccessor.CurrentValue; 

_optionsWithDelegateConfig = optionsAccessorWithDelegateConfig.CurrentValue; 
_subOptions = subOptionsAccessor.CurrentValue; 

_snapshotOptions = snapshotOptionsAccessor.Value; 

_named_options_l = namedOptionsAccessor.Get("named_options_l"); 

_named_options_2 = namedOptionsAccessor.Get("named_options_2"); 

} 


// Example #4: Bind options directly to the page 
MyOptions = _options; 








Örnek uygulama, @inject yönergeyle i0ptionsMonitor<My0ptions> nasıl ekleneceğini gösterir: 
@page 

@model IndexModel 

@using Microsoft.Extensions.Options 

@inject IOptionsMonitor<MyOptions> OptionsAccessor 

@{ 

ViewData["Title"] = "Options Sample"; 

} 

<hl>@ViewData["fitle"]</hl> 


Uygulama çalıştırıldığında, seçenek değerleri işlenen sayfada gösterilir: 


Example #4: Model and injected options 

Options provided by the model 

Options provided by the model: @Model.Myoptions.optionl and @Model.My0ptions.0ption2 
Optionl: valuel fromjson 

Option2: -1 

Options injected into the page 

Options injected into the page: @inject IOptions<MyOptions> OptionsAccessor Wİth (SOptionsAccessor.Value.Optionl and 
@OptionsAccessor.Value.Option2 

Optionl: valuel fromjson 

Option2: -1 


loptionssnapshot ile yapılandırma verilerini yeniden yükleme 

Yapılandırma verilerini IOptionsSnapshot<TOptions> ile yeniden yükleme örnek uygulamada örnek #5 
gösterilmiştir. 

IOptionsSnapshot<TOptions>kullanarak, erişilen ve isteğin ömrü boyunca önbelleğe alınan istekler her istek 
için bir kez hesaplanır. 

lOptionsMonitor ve ıoptionsSnapshot arasındaki fark şudur: 

• lOptionsMonitor , geçerli seçenek değerlerini her zaman alan, özellikle de tek bağımlılıklarda yararlı olan 

bir tek hizmettir. 

• ıoptionsSnapshot kapsamlı bir hizmettir ve ıoptionsSnapshot<T> nesnesinin oluşturulduğu sırada 
seçeneklerin anlık görüntüsünü sağlar. Seçenekler anlık görüntüleri geçici ve kapsamlı bağımlılıklarla 
kullanılmak üzere tasarlanmıştır. 

Aşağıdaki örnek, appSettings. JSON değişikliklerinden sonra yeni bir IOptionsSnapshot<TOptions> nasıl 
oluşturulduğunu gösterir ( Pages/lndex. cshtml. cs). Sunucu için birden çok istek, dosya değiştirilene ve 
yapılandırma yeniden yükleninceye kadar appSettings. JSON dosyası tarafından belirtilen sabit değerler 
döndürüyor. 

private readonly MyOptions _snapshotOptionsj 













public IndexModel( 

IOptionsMonitor<MyOptions> optionsAccessor, 

IOptionsMonitor<MyOptionsWithDelegateConfig> optionsAccessorWithDelegateConfig, 
IOptionsMonitor<MySubOptions> subOptionsAccessor, 

IOptionsSnapshot<MyOptions> snapshotOptionsAccessor, 

IOptionsSnapshot<MyOptions> namedOptionsAccessor) 

{ 

_options = optionsAccessor.CurrentValue; 

_optionsWithDelegateConfig = optionsAccessorl/JithDelegateConfig.CurrentValue; 
_subOptions = subOptionsAccessor.CurrentValue; 

_snapshotOptions = snapshotOptionsAccessor.Value; 

_named_options_l = namedOptionsAccessor.Get("named_options_l"); 

_named_options_2 = namedOptionsAccessor.Get("named_options_2"); 

} 



gösterilmektedir: 



AppSettings. JSON dosyasını kaydedin. Seçenekler değerlerinin güncelleştirildiğini görmek için tarayıcıyı 
yenileyin: 


snapshot optionl = valuel_from_json UPDATED, snapshot option2 = 200 


IController Enamedooptıons ile adlandırılmış seçenekler desteği 

IConfigurel\lamedOptions<TOptions> ile adlandırılmış seçenekler, örnek uygulamada 6 #örnek olarak 
gösterilmiştir. 

AdlandırdmLş seçenekler desteği, uygulamanın adlandırılmış seçenek yapılandırmalarının ayırt etmesine izin 
verir. Örnek uygulamada, adlandırılmış Seçenekler OptionsServiceCollectionExtensions. configureile 
bildirilmiştir ve bu, <TOptions > ' i çağırır. Uzantı yöntemini Yapılandır: 

// Example #6: Named options (named_options_l) 

// Register the ConfigurationBuilder instance which MyOptions binds against. 

// Specify that the options loaded fnom configuration are named 
// "named_options_l". 

Services.Configune<MyOptions>("named_options_l"j Configuration); 

// Example #6: Named options (named_options_2) 

// Specify that the options loaded from the MyOptions class are named 
// "named_options_2". 

// Use a delegate to configure option values. 

Services.Configure<My0ptions>("named_options_2"j myOptions => 

{ 

myOptions.Optionl = "named_options_2_valuel_from_action"; 

}); 











Örnek uygulama, Get ( Pages/lndex. cshtml. cs) adlı adlandırılmış seçeneklere erişir: 


private readonly MyOptions _named_options_l; 
private readonly MyOptions _named_options_2; 


public IndexModel( 

IOptionsMonitor<MyOptions> optionsAccessor, 

IOptionsMonitor<MyOptionsWithDelegateConfig> optionsAccessorl/JithDelegateConfig, 
IOptionsMonitor<MySubOptions> subOptionsAccessor, 

IOptionsSnapshot<MyOptions> snapshotOptionsAccessor, 

IOptionsSnapshot<MyOptions> namedOptionsAccessor) 

{ 

_options = optionsAccessor.CurrentValue; 

_optionsWithDelegateConfig = optionsAccessorWithDelegateConfig.CurrentValue; 
_subOptions = subOptionsAccessor.CurrentValue; 

_snapshotOptions = snapshotOptionsAccessor.Value; 

_named_options_l = namedOptionsAccessor.Get("named_options_l"); 

_named_options_2 = namedOptionsAccessor.Get("named_options_2"); 

} 


// Example #6: Named options 
var named_options_l = 

$"named_options_l: optionl = {_named_options_l.Optionl}, " + 

$"option2 = {_named_options_1.0ption2}"; 
var named_options_2 = 

$"named_options_2: optionl = {_named_options_2.Optionl}, " + 

$"option2 = {_named_options_2.0ption2}"j 
NamedOptions = $"{named_options_l} {named_options_2}"; 

Örnek uygulama çalıştırıldığında, adlandırılmış seçenekler döndürülür: 

named_options_l: optionl = valuel_from_json, option2 = -1 
named_options_2: optionl = named_options_2_valuel_from_action, option2 = 5 

named_options_ı değerler, appSettings. JSON dosyasından yüklenen yapılandırmadan sağlanır. 
named_options _2 değerleri tarafından sağlanır: 

• Optionl İçin ConfigureServices named_options_2 temsilcisi. 

• MyOptions sınıfı tarafından sağlanmış Option2 için varsayılan değer. 

Tüm seçenekleri ConfigureAlI yöntemiyle yapılandırma 

Tüm seçenek örneklerini ConfigureAlI yöntemiyle yapılandırın. Aşağıdaki kod, ortak bir değere sahip tüm 
yapılandırma örnekleri için Optionl yapılandırır, startup.ConfigureServices yöntemine el ile aşağıdaki kodu 
ekleyin: 

Services.ConfigureAll<MyOptions>(myOptions => 

{ 

myOptions.Optionl = "ConfigureAlI replacement value"; 

})J 


Kodu ekledikten sonra örnek uygulamayı çalıştırmak aşağıdaki sonucu verir: 

named_options_l: optionl = ConfigureAlI replacement value, option2 = -1 
named_options_2: optionl = ConfigureAlI replacement value, option2 = 5 









NOTE 

Tüm seçenekler adlandırılmış örneklerdir. Mevcut IConfigureOptions<TOptions> örnekleri, 
string. Empty'' Options. DefaultName örneğini hedefleyecek şekilde değerlendirilir. 

IConfigureNamedOptions<TOptions> Ayrıca IConfigureOptions<TOptions> uygular. IOptionsFactory<TOptions> 
varsayılan uygulamasının her birini uygun şekilde kullanma mantığı vardır, null adlandırılmış seçenek, belirli bir 
adlandırılmış örnek yerine tüm adlandırılmış örnekleri hedeflemek için kullanılır (ConfigureAlI ve PostConfigureAlI bu 
kuralı kullanın). 


Seçenekno Oluşturucu API 'SI 

OptionsBuilder<TOptions>, TOptions örnekleri yapılandırmak için kullanılır. optionsBuiiden .sonraki 
çağrıların tümünde olmak yerine ilk AddOptions<TOptions>(string optionsName) çağrısına yalnızca tek bir 
parametre olan adlandırılmış seçenekleri oluşturmayı kolaylaştırır. Seçenekler doğrulaması ve hizmet 
bağımlılıklarını kabul eden configureOptions aşırı yüklemeler yalnızca optionsBuiider ile kullanılabilir. 

// Options.DefaultName = "" is used. 

Services.AddOptions<MyOptions>().Configure(o => o.Property = "default"); 

Services.AddOptions<MyOptions>("optionalName") 

.Configure(o => o.Property = "named"); 


Ayarları yapılandırmak için dı hizmetlerini kullanma 

Seçenekleri iki şekilde yapılandırırken, bağımlılık ekleme işleminden diğer hizmetlere erişebilirsiniz: 

• <TOptions > 1 nin Options Builder'da yapılandırılması için bir yapılandırma temsilcisi geçirin. <bir 
TOptions > seçenek Oluşturucusu , seçenekleri yapılandırmak için en fazla beş hizmeti kullanmanıza 
olanak sağlayan, yapılandırma yüklerini sağlar: 

Services.AddOptions<MyOptions>("optionalName") 

.ConfigurecServicelj Service2j Service3, Service4, Service5>( 

(o, sj s2, s3, s4, s5) => 

o.Property = DoSomethingWith(s, s2, s3, s4, s5)); 


• IConfigureOptions<TOptions> veya IConfigureNamedOptions<TOptions> uygulayan ve türü bir 
hizmet olarak kaydeden kendi türünü oluşturun. 

Bir hizmetin oluşturulması daha karmaşık olduğundan, yapılandırmakiçin bir yapılandırma temsilcisinin 
geçirilmesini öneririz. Kendi türünü oluşturmak, Yapılandır'ı kullandığınızda çerçevenin sizin için yaptığı işe 
eşdeğerdir. Yapılandırma çağrısı, belirtilen genel hizmet türlerini kabul eden bir oluşturucuya sahip olan geçici 
genel IConfigureNamedOptions<TOptions> kaydeder. 

Seçenekler doğrulaması 

Seçenekler doğrulaması seçenekler yapılandırıldığında seçenekleri doğrulamanızı sağlar. Seçenekler 
geçerliyse true döndüren ve geçerli değillerse faise bir doğrulama yöntemiyle validate çağırın: 











// Registration 

Services.AddOptions<MyOptions>("optionalOptionsName") 

.Configure(o => { }) // Configure the options 
.Validate(o => YourValidationShouldReturnTruelfValid(o ), 

"custom error"); 

// Consumption 

var monitor = Services.BuildServiceProvider() 

.GetService<IOptionsMonitor<MyOptions>>(); 

try 

{ 

var options = monitor.Get("optionalOptionsName"); 

} 

catch (OptionsValidationException e) 

{ 

// e.OptionsName returns "optionalOptionsName" 

// e.OptionsType returns typeof(MyOptions) 

// e.Failures returns a list of errors, which would contain 
// "custom error" 

} 

Önceki örnekte, adlandırılmış seçenekler örneği optionalOptionsName olarak ayarlanır. Varsayılan Seçenekler 
Örneği Options.DefaultName . 

Seçenekler örneği oluşturulduğunda doğrulama çalıştırılır. Seçenek Örneğinizde, ilk kez erişildiğinde 
doğrulamanın başarılı olması garanti edilir. 


IMPORTANT 

Seçenekler, Seçenekler başlangıçta yapılandırıldıktan ve doğrulandıktan sonra seçeneklerindeki değişikliklere karşı 
koruma yapmaz. 


vaüdate yöntemi bir Func<TOptions, booi> kabul eder. Doğrulamayı tamamen özelleştirmek için, şunları 
sağlayan ıvaiidateOptions<TOptions> uygulayın: 

• Birden çok seçenek türünün doğrulanması: 

class ValidateTwo : IValidateOptions<Optionl>, IValidation0ptions<0ption2> 

• Başka bir seçenek türüne bağlı olan doğrulama: 

public DependsOnAnotherOptionValidator(IOptionsMonitor<AnotherOption> options) 

ivalidateOptions şunları doğrular: 

• Belirli bir adlandırılmış seçenekler örneği. 

• name nuiı tüm seçenekler. 

Arabirimin uygulanınızdan bir vaüdateOptionsResuit döndürün: 

public interface IValidateOptions<TOptions> where TOptions : class 

{ 

VaüdateOptionsResuit Validate(string name, TOptions options); 

} 

Veri ek açıklaması tabanlı doğrulama, 0 ptionsBuiider<T 0 ptions> ValidateDataAnnotations yöntemi çağırarak 
Microsoft. Extensions. Options. DataAnnotation paketinden kullanılabilir. 

Microsoft.Extensions.Options.DataAnnotations ASP.NET Core uygulamalarda örtülü olarak başvurulur. 

















using System.ComponentModel.DataAnnotations; 
using Microsoft. Extensions .Dependencylnjection; 

private class AnnotatedOptions 

{ 

[Required] 

public string Required { get; set; } 

[StringLength(5, ErrorMessage = "Too long.")] 
public string StringLength { get; set; } 

[Range(-5, 5 , ErrorMessage = "Out of range.")] 
public int IntRange { get; set; } 


[Fact] 

public void CanValidateDataAnnotations() 

{ 

var Services = new ServiceCollection(); 

Services.AddOptions<AnnotatedOptions>() 

.Configure(o => 

{ 

o.StringLength = "111111"; 
o.IntRange = 10; 
o.Custom = "nowhere"; 

}) 

.ValidateDataAnnotations(); 

var sp = Services.BuildServiceProvider(); 

var error = Assert.Throws<OptionsValidationException>(() => 

sp.GetRequiredService<IOptionsMonitor<AnnotatedOptions>>().CurrentValue); 
ValidateFailure<AnnotatedOptions>(error, Options.DefaultName, 1, 
"DataAnnotation validation failed for members Required " + 

"with the error 'The Required field is required.'.", 

"DataAnnotation validation failed for members StringLength " + 

"with the error 'Too long.'.", 

"DataAnnotation validation failed for members IntRange " + 

"with the error 'Out of range.'."); 


Eager doğrulaması (başlangıçta hızlı başarısız), gelecek bir sürüm için dikkate alınmaz. 

Yapılandırma sonrası seçenekler 

Yapılandırma sonrası IPostConfigureOptions<TOptions>ayarlayın. Tüm IConfigureOptions<TOptions> 
yapılandırma oluştuktan sonra yapılandırma sonrası çalıştırmalar: 

Services.PostConfigure<MyOptions>(myOptions => 

{ 

myOptions.Optionl = "post_configured_optionl_value"; 

}); 


PostConfigure, adlandırılmış seçenekleri yapılandırmak için kullanılabilir: 

Services.PostConfigure<MyOptions>("named_options_l", myOptions => 

{ 

myOptions.Optionl = "post_configured_optionl_value"; 

}); 


Tüm yapılandırma örneklerini yapılandırmak için PostConfigureAlI kullanın: 





Services.PostConfigureAll<MyOptions>(myOptions => 

{ 

myOptions.Optionl = "post_configured_optionl_value "; 

}); 


Başlangıç sırasında seçeneklere erişme 

IOptions<TOptions> ve IOptionsMonitor<TOptions> startup.configure kullanılabilir, çünkü Hizmetleri 
configure Yöntemi yürütülmeden önce oluşturulmuştur. 

public void Configure(IApplicationBuilder app, 

IOptionsMonitor<MyOptions> optionsAccessor) 

{ 

var optionl = optionsAccessor.CurrentValue.Optionl; 

} 

startup .configureServices IOptions<TOptions> veya IOptionsMonitor<TOptions> kullanmayın. Hizmet 
kayıtlarının sıralaması nedeniyle tutarsız bir seçenek durumu var olabilir. 

Seçenekler stili, ilişkili ayarların gruplarını temsil etmek için sınıfları kullanır. Yapılandırma ayarları senaryo 
tarafından ayrı sınıflara ayrılmışsa, uygulama iki önemli yazılım mühendisliği ilkelerine uyar: 

• Yapılandırma ayarlarına bağlı olan arabirim ayırma ilkesi (ISS) veya kapsülleme - senaryoları (sınıflar) 
yalnızca kullandıkları yapılandırma ayarlarına bağlıdır. 

• Uygulamanın farklı parçaları için - ayarlarının ayrılması, birbirine bağımlı değildir veya birbirlerine 
aktarılmaz. 

Seçenekler Ayrıca yapılandırma verilerini doğrulamaya yönelik bir mekanizma sağlar. Daha fazla bilgi için 

Seçenekler doğrulama bölümüne bakın. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Prerequisites 

Microsoft. AspNetCore. app metapackage 'e başvurun veya Microsoft. Extensions. Options. 
configurationextensions paketine bir paket başvurusu ekleyin. 

Seçenekler arabirimleri 

IOptionsMonitor<TOptions>, TOptions örnekleri için seçenekleri almak ve seçenek bildirimlerini yönetmek 
için kullanılır. IOptionsMonitor<TOptions> aşağıdaki senaryoları destekler: 

• Değişiklik bildirimleri 

• Adlandırılmış seçenekler 

• Yeniden yüklenebilir yapılandırma 

• Seçmeli seçenekler geçersiz kılma (IOptionsMonitorCache<TOptions>) 

Yapılandırma sonrası senaryolar, tüm IConfigureOptions<TOptions> yapılandırma oluştuktan sonra 
seçenekleri ayarlamanıza veya değiştirmenize olanak sağlar. 

IOptionsFactory<TOptions> yeni seçenek örnekleri oluşturmaktan sorumludur. Tek bir Create yöntemi vardır. 
Varsayılan uygulama tüm kayıtlı IConfigureOptions<TOptions> ve IPostConfigureOptions<TOptions> alır ve 
önce tüm yapılandırmaların, ardından yapılandırma sonrası sonrasında çalıştırılır. 

IConfigureNamedOptions<TOptions> ve IConfigureOptions<TOptions> arasında ayrım yapar ve yalnızca 
uygun arabirimi çağırır. 






IOptionsMonitorCache<TOptions>, IOptionsMonitor<TOptions> tarafından TOptions örnekleri önbelleğe 
almak için kullanılır. IOptionsMonitorCache<TOptions>, değer yeniden hesaplanabilmesi için izleyici içindeki 
seçenek örneklerini geçersiz kılar (TryRemove). Değerler, TryAddile el ile tanıtılamaz. Clear yöntemi, tüm 
adlandırılmış örneklerin isteğe bağlı olarak yeniden oluşturulması gerektiğinde kullanılır. 

IOptionsSnapshot<TOptions>, her istekte seçeneklerin yeniden hesaplanması gereken senaryolarda 
faydalıdır. Daha fazla bilgi için bkz. loptionssnapshot ile yapılandırma verilerini yeniden yükleme bölümü. 

IOptions<TOptions>, seçenekleri desteklemek için kullanılabilir. Ancak, IOptions<TOptions> önceki 
IOptionsMonitor<TOptions>senaryolarını desteklemez. Zaten IOptions<TOptions> arabirimini kullanan 
mevcut çerçeveler ve kitaplıklarda IOptions<TOptions> kullanmaya devam edebilir ve 
IOptionsMonitor<TOptions>tarafından sağlanmış senaryolara gerek kalmaz. 

Genel Seçenekler yapılandırması 

Genel Seçenekler yapılandırması örnek uygulamada #1 olarak gösterilmiştir. 

Bir seçenek sınıfı ortak parametresiz bir Oluşturucu ile soyut olmamalıdır. Aşağıdaki MyOptions sınıfında, 
Optioni ve 0 ption 2 iki özelliği vardır. Varsayılan değerleri ayarlama isteğe bağlıdır, ancak aşağıdaki örnekteki 
sınıf oluşturucusu Optioni varsayılan değerini ayarlar. 0ption2 , özelliği doğrudan başlatarak varsayılan değer 
kümesine sahiptir ( modeller/MyOptions. cs): 

public class MyOptions 
{ 

public MyOptions() 

{ 

// Set default value. 

Optioni = "valuel_from_ctor"; 

} 

public string Optioni { get; set; } 
public int 0ption2 { get; set; } = 5; 

} 

MyOptions sınıfı, Configure ve yapılandırmayla bağlantılı olarak hizmet kapsayıcısına eklenir: 

// Example #1: General configuration 

// Register the Configuration instance which MyOptions binds against. 

Services.Configure<MyOptions>(Configuration); 

Aşağıdaki sayfa modeli, ayarlara erişmek için IOptionsMonitor<TOptions> ile Oluşturucu bağımlılığı ekleme 
işlemini kullanır ( Sayfalar/lndex. cshtml. cs): 

private readonly MyOptions _options; 








public IndexModel( 

IOptionsMonitor<MyOptions> optionsAccessor, 

IOptionsMonitor<MyOptionsWithDelegateConfig> optionsAccessorWithDelegateConfig, 
IOptionsMonitor<MySubOptions> subOptionsAccessor, 

IOptionsSnapshot<MyOptions> snapshotOptionsAccessor, 

IOptionsSnapshot<MyOptions> namedOptionsAccessor) 

{ 

_options = optionsAccessor.CurrentValue; 

_optionsWithDelegateConfig = optionsAccessorWithDelegateConfig.CurrentValue; 
_subOptions = subOptionsAccessor.CurrentValue; 

_snapshotOptions = snapshotOptionsAccessor.Value; 

_named_options_l = namedOptionsAccessor.Get("named_options_l"); 

_named_options_2 = namedOptionsAccessor.Get("named_options_2"); 

} 



{ 




"optionl": "valuel_from_json ", 

"option2": - 1 , 

"subsection": { 


"suboptionl": 

"subvaluel_from_json ", 


"suboption2": 

b 

"Logging": { 
"LogLevel": { 

200 


"Default": 

} 

"lAİarning" 

} 

"AllowedHosts": 

M + M 


Uygulama çalıştırıldığında, sayfa modelinin onGet yöntemi, seçenek sınıfı değerlerini gösteren bir dize 
döndürür: 


optionl = valuel_from_jsonj option2 = -1 


NOTE 

Bir ayarlar dosyasından seçenek yapılandırması ’nı yüklemek için özel bir ConfigurationBuilder kullanırken, temel yolun 
doğru şekilde ayarlandığını onaylayın: 

var configBuilder = new ConfigurationBuilder() 

.SetBasePath(Directory.GetCurrentDirectory()) 

.AddDsonFile("appsettings.json", optional: true); 
var config = configBuilder.Build(); 

Services.Configure<MyOptions>(config ); 

Ayarlar dosyasından CreateDefaultBuilderaracılığıyla seçenek yapılandırması yüklenirken taban yolunu açıkça ayarlama 
gerekli değildir. 










Bir temsilciyle basit seçenekleri yapılandırma 

Basit seçeneklerin bir temsilciyle yapılandırılması, örnek uygulamada #2 örnek olarak gösterilmiştir. 

Seçenek değerlerini ayarlamak için bir temsilci kullanın. Örnek uygulama MyOptionswithDeiegateConfig sınıfını 
kullanır ( modeller/MyOptionsVVİthDelegcıteConfig. cs ): 

public class MyOptionsl/dithDelegateConfig 

{ 

public MyOptionsWithDelegateConfig() 

{ 

// Set default value. 

Optionl = "valuel_from_ctor"; 

} 

public string Optionl { get; set; } 
public int Option2 { get; set; } = 5; 

} 


Aşağıdaki kodda, hizmet kapsayıcısına ikinci bir IConfigureOptions<TOptions> hizmeti eklenir. 
MyOptionsWithDeiegateConfig ile bağlamayı yapılandırmak için bir temsilci kullanır: 


// Example #2: Options bound and configured by a delegate 
Services.Configure<MyOptionsWithDelegateConfig>(myOptions => 
{ 

myOptions.Optionl = "valuel_configured_by_delegate"; 
my0ptions.0ption2 = 500; 

}); 


lndex.cshtml.cs\ 


private readonly MyOptionsl/dithDelegateConfig _optionsl/dithDelegateConfig; 


public IndexModel( 

IOptionsMonitor<MyOptions> optionsAccessor, 

IOptionsMonitor<MyOptionsWithDelegateConfig> optionsAccessorl/dithDelegateConfig, 
IOptionsMonitor<MySubOptions> subOptionsAccessor, 

IOptionsSnapshot<MyOptions> snapshotOptionsAccessor, 

IOptionsSnapshot<MyOptions> namedOptionsAccessor) 

{ 

_options = optionsAccessor.CurrentValue; 

_optionsl/dithDelegateConfig = optionsAccessorl/dithDelegateConfig.CurrentValue; 
_subOptions = subOptionsAccessor.CurrentValue; 

_snapshotOptions = snapshotOptionsAccessor.Value; 

_named_options_l = namedOptionsAccessor.Get("named_options_l"); 

_named_options_2 = namedOptionsAccessor.Get("named_options_2"); 

} 


// Example #2: Options configured by delegate 

var delegate_config_optionl = _optionsWithDelegateConfig.Optionl; 
var delegate_config_option2 = _optionsWithDelegateConfig.Option2; 
SimpleOptionsWithDelegateConfig = 

$"delegate_optionl = {delegate_config_optionl}, " + 
$"delegate_option2 = {delegate_config_option2}"; 


Birden çok yapılandırma sağlayıcısı ekleyebilirsiniz. Yapılandırma sağlayıcıları NuGet paketlerinde 
kullanılabilir ve kayıtlı oldukları sırayla uygulanır. Daha fazla bilgi için bkz. ASP.NET Core yapılandırma. 






Her Configure çağrısı, hizmet kapsayıcısına bir IConfigureOptions<TOptions> hizmeti ekler. Yukarıdaki 
örnekte, Optioni ve 0 ption 2 değerlerinin ikisi de appSettings. JSONlçnde belirtilmiştir, ancak Optioni ve 
0 ption 2 değerleri yapılandırılan temsilci tarafından geçersiz kılınır. 

Birden fazla yapılandırma hizmeti etkinleştirildiğinde, son yapılandırma kaynağı WINS ' i ve yapılandırma 
değerini ayarlar. Uygulama çalıştırıldığında, sayfa modelinin onGet yöntemi, seçenek sınıfı değerlerini 
gösteren bir dize döndürür: 

delegate_optionl = valuel_configured_by_delegate, delegate_option2 = 500 


Alt seçenekler yapılandırması 

Alt seçenekler yapılandırması örnek uygulamada #3 örnek olarak gösterilmiştir. 

Uygulamalar, uygulamadaki belirli senaryo gruplarına (sınıflar) ait seçenek sınıfları oluşturmamalıdır. 
Uygulamanın yapılandırma değerleri gerektiren bölümlerinin yalnızca kullandıkları yapılandırma değerlerine 
erişimi olmalıdır. 

Seçenekleri yapılandırmaya bağlama sırasında, seçenek türündeki her bir özellik property[ :sub-pnoperty: ] 
formun bir yapılandırma anahtarına bağlanır. Örneğin, MyOptions.Optioni özelliği appSettings. USOA/içindeki 
optioni özelliğinden okunan anahtar Optioni bağımlıdır. 

Aşağıdaki kodda, hizmet kapsayıcısına üçüncü bir IConfigureOptions<TOptions> hizmeti eklenir. 
MySubOptions appSettings. JSON dosyasının subsection bölümüne bağlar: 

// Example #3: Suboptions 

// Bind options using a sub-section of the appsettings.json file. 
services.Configure<MySubOptions>(Configuration.GetSection("subsection")); 

Getsection yöntemi Microsoft.Extensions.Configuration ad alanını gerektirir. 


Örneğin appSettings. JSON dosyası, suboptioni ve suboption 2 için anahtarlar içeren bir subsection üyesini 
tanımlar: 



(. modeller/Myalt seçenekler, cs ): 















public class MySubOptions 

{ 

public MySubOptions() 

{ 

// Set default values. 

SubOptionl = "valuel_from_ctor"; 

Sub0ption2 = 5; 

} 

public string SubOptionl { get; set; } 
public int Sub0ption2 { get; set; } 

} 

Sayfa modelinin onGet yöntemi, Seçenekler değerleriyle ( Pages/lndex. cshtml. cs) bir dize döndürür: 

private neadonly MySubOptions _subOptions; 


public IndexModel( 

IOptionsMonitor<MyOptions> optionsAccessor, 

IOptionsMonitor<MyOptionsWithDelegateConfig> optionsAccessorWithDelegateConfig, 
IOptionsMonitor<MySubOptions> subOptionsAccessor, 

IOptionsSnapshot<MyOptions> snapshotOptionsAccessor, 

IOptionsSnapshot<MyOptions> namedOptionsAccessor) 

{ 

_options = optionsAccessor.CurrentValue; 

_optionsWithDelegateConfig = optionsAccessorWithDelegateConfig.CurrentValue; 
_subOptions = subOptionsAccessor.CurrentValue; 

_snapshotOptions = snapshotOptionsAccessor.Value; 

_named_options_l = namedOptionsAccessor.Get("named_options_l"); 

_named_options_2 = namedOptionsAccessor.Get("named_options_2"); 

} 


// Example #3: Suboptions 

var SubOptionl = _subOptions.SubOptionl; 

var subOption2 = _subOptions.SubOption2; 

SubOptions = $"subOptionl = {subOptionl}, subOption2 = {subOption2}"; 

Uygulama çalıştırıldığında OnGet yöntemi, alt sınıf değerlerini gösteren bir dize döndürür: 

SubOptionl = subvaluel_from_jsonj subOption2 = 200 


Seçeneklere ekleme 

Seçenekler ekleme, örnek uygulamada #4 olarak gösterilmiştir. 

IOptionsMonitor<TOptions> içine ekle: 

• @inject Razor yönergesi ile Razor sayfası veya MVC görünümü. 

• Bir sayfa veya görünüm modeli. 

Örnek uygulamadan alınan aşağıdaki örnek, bir sayfa modeline IOptionsMonitor<TOptions> 
( Sayfalar/lndex. cshtml. cs): 

private readonly MyOptions _options; 











public IndexModel( 

IOptionsMonitor<MyOptions> OptionsAccessor, 

IOptionsMonitor<MyOptionsWithDelegateConfig> optionsAccessorWithDelegateConfig, 
IOptionsMonitor<MySubOptions> subOptionsAccessor, 

IOptionsSnapshot<MyOptions> snapshotOptionsAccessor, 

IOptionsSnapshot<MyOptions> namedOptionsAccessor) 

{ 

_options = OptionsAccessor.CurrentValue; 

_optionsWithDelegateConfig = optionsAccessorl/JithDelegateConfig. CurrentValue; 
_subOptions = subOptionsAccessor.CurrentValue; 

_snapshotOptions = snapshotOptionsAccessor.Value; 

_named_options_l = namedOptionsAccessor.Get("named_options_l"); 

_named_options_2 = namedOptionsAccessor.Get("named_options_2"); 

} 


// Example #4: Bind options directly to the page 
MyOptions = _options; 

Örnek uygulama, @inject yönergeyle i0ptionsMonitor<My0ptions> nasıl ekleneceğini gösterir: 


@page 

@model IndexModel 

@using Microsoft.Extensions.Options 

@inject IOptionsMonitor<MyOptions> OptionsAccessor 

@{ 

ViewData["Title"] = "Options Sample"; 

} 

<hl>@ViewData["Title"]</hl> 


Uygulama çalıştırıldığında, seçenek değerleri işlenen sayfada gösterilir: 


Example #4: Model and injected options 

Options provided by the model 

Options provided bythe model: @Model.MyOptions.optionl and @Model.MyOptions.Option2 
Optionl: valuel fromjson 

Option2: -1 

Options injected into the page 

Options injected into the page: @inject IOptions<MyOptions> OptionsAccessor Wİth @OptionsAccessor.Value.Optionl and 
@OptionsAccessor.Value.Option2 

Optionl: valuel fromjson 

Option2: -1 


loptionssnapshot ile yapılandırma verilerini yeniden yükleme 

Yapılandırma verilerini IOptionsSnapshot<TOptions> ile yeniden yükleme örnek uygulamada örnek #5 
gösterilmiştir. 

IOptionsSnapshot<TOptions>kullanarak, erişilen ve isteğin ömrü boyunca önbelleğe alınan istekler her istek 
için bir kez hesaplanır. 


iûptionsMonitor ve ıoptionsSnapshot arasındaki fark şudur: 









• ıoptionsMonitor , geçerli seçenek değerlerini her zaman alan, özellikle de tek bağımlılıklarda yararlı olan 

bir tek hizmettir. 

• ıoptionsSnapshot kapsamlı bir hizmettir ve ıoptionsSnapshot<T> nesnesinin oluşturulduğu sırada 
seçeneklerin anlık görüntüsünü sağlar. Seçenekler anlık görüntüleri geçici ve kapsamlı bağımlılıklarla 
kullanılmak üzere tasarlanmıştır. 

Aşağıdaki örnek, appSettings. JSON değişikliklerinden sonra yeni bir IOptionsSnapshot<TOptions> nasıl 
oluşturulduğunu gösterir ( Pages/lndex. cshtml. cs). Sunucu için birden çok istek, dosya değiştirilene ve 
yapılandırma yeniden yükleninceye kadar appSettings. JSON dosyası tarafından belirtilen sabit değerler 
döndürüyor. 

private readonly MyOptions _snapshotOptionsj 


public IndexModel( 

IOptionsMonitor<MyOptions> optionsAccessor, 

IOptionsMonitor<MyOptionsWithDelegateConfig> optionsAccessorİAİithDelegateConfig, 
IOptionsMonitor<MySııbOptions> subOptionsAccessor, 

IOptionsSnapshot<MyOptions> snapshotOptionsAccessor, 

IOptionsSnapshot<MyOptions> namedOptionsAccessor) 

{ 

_options = optionsAccessor.CurrentValue; 

_optionsWithDelegateConfig = optionsAccessorWithDelegateConfig.CurrentValue; 
_subOptions = subOptionsAccessor.CurrentValue; 

_snapshotOptions = snapshotOptionsAccessor.Value; 

_named_options_l = namedOptionsAccessor.Get("named_options_l"); 

_named_options_2 = namedOptionsAccessor.Get("named_options_2"); 

} 



gösterilmektedir: 



AppSettings. JSON dosyasını kaydedin. Seçenekler değerlerinin güncelleştirildiğini görmek için tarayıcıyı 
yenileyin: 


snapshot optionl = valuel_from_json UPDATED, snapshot option2 = 200 


IController Enamedooptıons ile adlandırılmış seçenekler desteği 

IConfigurel\lamedOptions<TOptions> ile adlandırılmış seçenekler, örnek uygulamada 6 #örnek olarak 
gösterilmiştir. 

AdlandırdmLş seçenekler desteği, uygulamanın adlandırılmış seçenek yapılandırmalarının ayırt etmesine izin 
verir. Örnek uygulamada, adlandırılmış Seçenekler OptionsServiceCollectionExtensions. configureile 
bildirilmiştir ve bu, <TOptions > ' i çağırır. Uzantı yöntemini Yapılandır: 














// Example #6: Named options (named_options_l) 

// Register the ConfigurationBuilder instance which MyOptions binds against. 

// Specify that the options loaded fnom configuration are named 
// "named_options_l". 

Services.Configure<MyOptions>("named_options_l", Configuration); 

// Example #6: Named options (named_options_2) 

// Specify that the options loaded from the MyOptions class are named 
// "named_options_2". 

// Use a delegate to configure option values. 

Services.Configure<My0ptions>("named_options_2", myOptions => 

{ 

myOptions.Optionl = "named_options_2_valuel_from_action"; 

}); 

Örnek uygulama, Get ( Pages/lndex. cshtml. cs) adlı adlandırılmış seçeneklere erişir: 


private readonly MyOptions _named_options_l; 
private readonly MyOptions _named_options_2; 


public IndexModel( 

IOptionsMonitor<MyOptions> optionsAccessor, 

IOptionsMonitor<MyOptionsWithDelegateConfig> optionsAccessorl/JithDelegateConfig, 
IOptionsMonitor<MySubOptions> subOptionsAccessor, 

IOptionsSnapshot<MyOptions> snapshotOptionsAccessor, 

IOptionsSnapshot<MyOptions> namedOptionsAccessor) 

{ 

_options = optionsAccessor.CurrentValue; 

_optionsWithDelegateConfig = optionsAccessorl/JithDelegateConfig.CurrentValue; 
_subOptions = subOptionsAccessor.CurrentValue; 

_snapshotOptions = snapshotOptionsAccessor.Value; 

_named_options_l = namedOptionsAccessor.Get("named_options_l"); 

_named_options_2 = namedOptionsAccessor.Get("named_options_2"); 

} 


// Example #6: Named options 
var named_options_l = 

$"named_options_l: optionl = {_named_options_l.Optionl}, " + 

$"option2 = {_named_options_1.0ption2}"; 
var named_options_2 = 

$"named_options_2: optionl = (_named_options_2.Optionl}, " + 

$"option2 = {_named_options_2.0ption2}"; 

NamedOptions = $"{named_options_l} {named_options_2}"; 

Örnek uygulama çalıştırıldığında, adlandırılmış seçenekler döndürülür: 

named_options_l: optionl = valuel_from_json, option2 = -1 
named_options_2: optionl = named_options_2_valuel_from_action, option2 = 5 

named_options_ı değerler, appSettings. JSON dosyasından yüklenen yapılandırmadan sağlanır. 
named_options _2 değerleri tarafından sağlanır: 

• Optionl için ConfigureServices named_options_2 temsilcisi. 

• MyOptions sınıfı tarafından sağlanmış 0ption2 için varsayılan değer. 


Tüm seçenekleri ConfigureAlI yöntemiyle yapılandırma 







Tüm seçenek örneklerini ConfigureAli yöntemiyle yapılandırın. Aşağıdaki kod, ortak bir değere sahip tüm 
yapılandırma örnekleri için Optioni yapılandırır. startup.configureServices yöntemine el ile aşağıdaki kodu 
ekleyin: 

Services.ConfigureAll<MyOptions>(myOptions => 

{ 

myOptions.Optioni = "ConfigureAli replacement value"; 

})J 

Kodu ekledikten sonra örnek uygulamayı çalıştırmak aşağıdaki sonucu verir: 

named_options_l: optioni = ConfigureAli replacement value, option2 = -1 
named_options_2: optioni = ConfigureAli replacement value, option2 = 5 


NOTE 

Tüm seçenekler adlandırılmış örneklerdir. Mevcut IConfigureOptions<TOptions> örnekleri, 
string. Empty''Options.DefaultName örneğini hedefleyecek şekilde değerlendirilir. 

IConfigureNamedOptions<TOptions> Ayrıca IConfigureOptions<TOptions> uygular. IOptionsFactory<TOptions> 
varsayılan uygulamasının her birini uygun şekilde kullanma mantığı vardır, null adlandırılmış seçenek, belirli bir 
adlandırılmış örnek yerine tüm adlandırılmış örnekleri hedeflemek için kullanılır (ConfigureAli ve PostConfigureAlI bu 
kuralı kullanın). 


Seçenekno Oluşturucu API 'SI 

OptionsBuilder<TOptions>, TOptions örnekleri yapılandırmak için kullanılır. OptionsBuiider .sonraki 
çağrıların tümünde olmak yerine ilk AddOptions<TOptions>(string optionsName) çağrısına yalnızca tek bir 
parametre olan adlandırılmış seçenekleri oluşturmayı kolaylaştırır. Seçenekler doğrulaması ve hizmet 
bağımlılıklarını kabul eden configureOptions aşırı yüklemeler yalnızca OptionsBuiider ile kullanılabilir. 

// Options.DefaultName = "" is used. 

Services.AddOptions<MyOptions>().Configure(o => o.Property = "default"); 

Services.AddOptions<MyOptions>("optionalName") 

.Configure(o => o.Property = "named"); 


Ayarları yapılandırmak için dı hizmetlerini kullanma 

Seçenekleri iki şekilde yapılandırırken, bağımlılık ekleme işleminden diğer hizmetlere erişebilirsiniz: 

• <TOptions > 1 nin Options Builder'da yapılandırılması için bir yapılandırma temsilcisi geçirin. <bir 
TOptions > seçenek Oluşturucusu , seçenekleri yapılandırmak için en fazla beş hizmeti kullanmanıza 
olanak sağlayan, yapılandırma yüklerini sağlar: 

Services.AddOptions<MyOptions>("optionalName") 

•ConfigurecServicel, Service2, Service3, Service4, Service5>( 

(o, s, s2, s3, s4, s5) => 

o.Property = DoSomethingWith(s, s2, s3, s4, s5)); 


• IConfigureOptions<TOptions> veya IConfigureNamedOptions<TOptions> uygulayan ve türü bir 
hizmet olarak kaydeden kendi türünü oluşturun. 

Bir hizmetin oluşturulması daha karmaşık olduğundan, yapılandırmakiçin bir yapılandırma temsilcisinin 












geçirilmesini öneririz. Kendi türünü oluşturmak, Yapılandır'ı kullandığınızda çerçevenin sizin için yaptığı işe 
eşdeğerdir. Yapılandırma çağrısı, belirtilen genel hizmet türlerini kabul eden bir oluşturucuya sahip olan geçici 
genel IConfigureNamedOptions<TOptions> kaydeder. 

Seçenekler doğrulaması 

Seçenekler doğrulaması seçenekler yapılandırıldığında seçenekleri doğrulamanızı sağlar. Seçenekler 
geçerliyse true döndüren ve geçerli değillerse faise bir doğrulama yöntemiyle validate çağırın: 

// Registration 

Services.AddOptions<MyOptions>("optionalOptionsName") 

.Configure(o => { }) // Configure the options 
.Validate(o => YourValidationShouldReturnTruelfValid(o ), 

"custom error"); 

// Consumption 

var monitor = Services.BuildServiceProvider() 

.GetService<IOptionsMonitor<MyOptions>>(); 

try 

{ 

var options = monitor.Get("optionalOptionsName"); 

} 

catch (OptionsValidationException e) 

{ 

// e.OptionsName returns "optionalOptionsName" 

// e.OptionsType returns typeof(MyOptions) 

// e.Failures returns a list of errors, which would contain 
// "custom error" 

} 

Önceki örnekte, adlandırılmış seçenekler örneği optionalOptionsName olarak ayarlanır. Varsayılan Seçenekler 
Örneği Options.DefaultName . 

Seçenekler örneği oluşturulduğunda doğrulama çalıştırılır. Seçenek Örneğinizde, ilk kez erişildiğinde 
doğrulamanın başarılı olması garanti edilir. 


IMPORTANT 

Seçenekler, Seçenekler başlangıçta yapılandırıldıktan ve doğrulandıktan sonra seçeneklerindeki değişikliklere karşı 
koruma yapmaz. 


Validate yöntemi bir Func<TOptions, booi> kabul eder. Doğrulamayı tamamen özelleştirmek için, şunları 
sağlayan ıvaiidateOptions<TOptions> uygulayın: 

• Birden çok seçenek türünün doğrulanması: 

class ValidateTwo : IValidateOptions<Optionl>, IValidation0ptions<0ption2> 

• Başka bir seçenek türüne bağlı olan doğrulama: 

public DependsOnAnotherOptionValidator(IOptionsMonitor<AnotherOption> options) 


ivalidateOptions şunları doğrular: 

• Belirli bir adlandırılmış seçenekler örneği. 

• name nuiı tüm seçenekler. 


Arabirimin uygulanınızdan bir vaüdateOptionsResuit döndürün: 


















public interface IValidateOptions<TOptions> where TOptions : class 

{ 

ValidateOptionsResult Validate(string name, TOptions options); 

} 

Veri ek açıklaması tabanlı doğrulama, 0ptionsBuiider<T0ptions> ValidateDataAnnotations yöntemi çağırarak 
Microsoft. Extensions. Options. DataAnnotation paketinden kullanılabilir. 

Microsoft.Extensions.Options.DataAnnotations , Microsoft. AspNetCore. app metapackageiçinde bulunur. 

using Microsoft. Extensions.Dependencylnjection; 

private class AnnotatedOptions 

{ 

[Required] 

public string Required { get; set; } 

[StringLength(5, ErrorMessage = "Too long.")] 
public string StringLength { get; set; } 

[Range(-5, S, ErrorMessage = "Out of range.")] 
public int IntRange { get; set; } 

} 

[Fact] 

public void CanValidateDataAnnotations() 

{ 

var Services = new ServiceCollection(); 

Services.AddOptions<AnnotatedOptions>() 

.Configure(o => 

{ 

o.StringLength = "111111"; 
o.IntRange = 10; 
o.Custom = "nowhere"; 

}) 

.ValidateDataAnnotations(); 

var sp = Services.BuildServiceProvider(); 

var error = Assert.Throws<OptionsValidationException>(() => 

sp.GetRequiredService<IOptionsMonitor<AnnotatedOptions>>().CurrentValue); 

ValidateFailurecAnnotatedOptions>(error , Options.DefaultName, 1, 

"DataAnnotation validation failed for members Required " + 

"with the error 'The Required field is required .'.", 

"DataAnnotation validation failed for members StringLength " + 

"with the error 'Too long.'.", 

"DataAnnotation validation failed for members IntRange " + 

"with the error 'Out of range.'."); 

} 


Eager doğrulaması (başlangıçta hızlı başarısız), gelecek bir sürüm için dikkate alınmaz. 

Yapılandırma sonrası seçenekler 

Yapılandırma sonrası IPostConfigureOptions<TOptions>ayarlayın. Tüm IConfigureOptions<TOptions> 
yapılandırma oluştuktan sonra yapılandırma sonrası çalıştırmalar: 

Services.PostConfigure<MyOptions>(myOptions => 

{ 

myOptions.Optionl = "post_configured_optionl_value"; 

}); 





PostConfigure, adlandırılmış seçenekleri yapılandırmak için kullanılabilir: 


Services.PostConfigure<MyOptions>("named_options_l", myOptions => 

{ 

myOptions.Optionl = "post_configured_optionl_value"; 

}); 

Tüm yapılandırma örneklerini yapılandırmak için PostConfigureAlI kullanın: 

Services.PostConfigureAll<MyOptions>(myOptions => 

{ 

myOptions.Optionl = "post_configured_optionl_value"; 

}); 


Başlangıç sırasında seçeneklere erişme 

IOptions<TOptions> ve IOptionsMonitor<TOptions> startup.configure kullanılabilir, çünkü Hizmetleri 
configure Yöntemi yürütülmeden önce oluşturulmuştur. 

public void Configure(IApplicationBuilder app, IOptionsMonitor<MyOptions> optionsAccessor) 

{ 

var optionl = optionsAccessor.CıırrentValue.Optionl; 

} 

startup.configureServices IOptions<TOptions> veya IOptionsMonitor<TOptions> kullanmayın. Hizmet 
kayıtlarının sıralaması nedeniyle tutarsız bir seçenek durumu var olabilir. 

Seçenekler stili, ilişkili ayarların gruplarını temsil etmek için sınıfları kullanır. Yapılandırma ayarları senaryo 
tarafından ayrı sınıflara ayrılmışsa, uygulama iki önemli yazılım mühendisliği ilkelerine uyar: 

• Yapılandırma ayarlarına bağlı olan arabirim ayırma ilkesi (ISS) veya kapsülleme - senaryoları (sınıflar) 
yalnızca kullandıkları yapılandırma ayarlarına bağlıdır. 

• Uygulamanın farklı parçaları için - ayarlarının ayrılması, birbirine bağımlı değildir veya birbirlerine 
aktarılmaz. 

Seçenekler Ayrıca yapılandırma verilerini doğrulamaya yönelik bir mekanizma sağlar. Daha fazla bilgi için 

Seçenekler doğrulama bölümüne bakın. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Prerequisites 

Microsoft. AspNetCore. app metapackage 'e başvurun veya Microsoft. Extensions. Options. 
configurationextensions paketine bir paket başvurusu ekleyin. 

Seçenekler arabirimleri 

IOptionsMonitor<TOptions>, TOptions örnekleri için seçenekleri almak ve seçenek bildirimlerini yönetmek 
için kullanılır. IOptionsMonitor<TOptions> aşağıdaki senaryoları destekler: 

• Değişiklik bildirimleri 

• Adlandırılmış seçenekler 

• Yeniden yüklenebilir yapılandırma 

• Seçmeli seçenekler geçersiz kılma (IOptionsMonitorCache<TOptions>) 







Yapılandırma sonrası senaryolar, tüm IConfigureOptions<TOptions> yapılandırma oluştuktan sonra 
seçenekleri ayarlamanıza veya değiştirmenize olanak sağlar. 

IOptionsFactory<TOptions> yeni seçenek örnekleri oluşturmaktan sorumludur. Tek bir Create yöntemi vardır. 
Varsayılan uygulama tüm kayıtlı IConfigureOptions<TOptions> ve IPostConfigureOptions<TOptions> alır ve 
önce tüm yapılandırmaların, ardından yapılandırma sonrası sonrasında çalıştırılır. 

IConfigureNamedOptions<TOptions> ve IConfigureOptions<TOptions> arasında ayrım yapar ve yalnızca 
uygun arabirimi çağırır. 

IOptionsMonitorCache<TOptions>, IOptionsMonitor<TOptions> tarafından TOptions örnekleri önbelleğe 
almak için kullanılır. IOptionsMonitorCache<TOptions>, değer yeniden hesaplanabilmesi için izleyici içindeki 
seçenek örneklerini geçersiz kılar (TryRemove). Değerler, TryAddile el ile tanıtılamaz. Clear yöntemi, tüm 
adlandırılmış örneklerin isteğe bağlı olarak yeniden oluşturulması gerektiğinde kullanılır. 

IOptionsSnapshot<TOptions>, her istekte seçeneklerin yeniden hesaplanması gereken senaryolarda 
faydalıdır. Daha fazla bilgi için bkz. loptionssnapshot ile yapılandırma verilerini yeniden yükleme bölümü. 

IOptions<TOptions>, seçenekleri desteklemek için kullanılabilir. Ancak, IOptions<TOptions> önceki 
IOptionsMonitor<TOptions>senaryolarını desteklemez. Zaten IOptions<TOptions> arabirimini kullanan 
mevcut çerçeveler ve kitaplıklarda IOptions<TOptions> kullanmaya devam edebilir ve 
IOptionsMonitor<TOptions>tarafından sağlanmış senaryolara gerek kalmaz. 

Genel Seçenekler yapılandırması 

Genel Seçenekler yapılandırması örnek uygulamada #1 olarak gösterilmiştir. 

Bir seçenek sınıfı ortak parametresiz bir Oluşturucu ile soyut olmamalıdır. Aşağıdaki MyOptions sınıfında, 
Optioni ve 0ption2 iki özelliği vardır. Varsayılan değerleri ayarlama isteğe bağlıdır, ancak aşağıdaki örnekteki 
sınıf oluşturucusu Optioni varsayılan değerini ayarlar. 0ption2 , özelliği doğrudan başlatarak varsayılan değer 
kümesine sahiptir ( modeller/MyOptions. cs): 

public class MyOptions 
{ 

public MyOptions() 

{ 

// Set default value. 

Optioni = "valuel_from_ctor"; 

} 

public string Optioni { get; set; } 
public int 0ption2 { get; set; } = 5; 

} 

MyOptions sınıfı, Configure ve yapılandırmayla bağlantılı olarak hizmet kapsayıcısına eklenir: 

// Example #1: General configuration 

// Register the Configuration instance which MyOptions binds against. 

Services.ConfigurecMyOptions>(Configuration); 

Aşağıdaki sayfa modeli, ayarlara erişmek için IOptionsMonitor<TOptions> ile Oluşturucu bağımlılığı ekleme 
işlemini kullanır ( Sayfalar/lndex. cshtml. cs): 

private readonly MyOptions _options; 








public IndexModel( 

IOptionsMonitor<MyOptions> optionsAccessor, 

IOptionsMonitor<MyOptionsWithDelegateConfig> optionsAccessorWithDelegateConfig, 
IOptionsMonitor<MySubOptions> subOptionsAccessor, 

IOptionsSnapshot<MyOptions> snapshotOptionsAccessor, 

IOptionsSnapshot<MyOptions> namedOptionsAccessor) 

{ 

_options = optionsAccessor.CurrentValue; 

_optionsWithDelegateConfig = optionsAccessorWithDelegateConfig.CurrentValue; 
_subOptions = subOptionsAccessor.CurrentValue; 

_snapshotOptions = snapshotOptionsAccessor.Value; 

_named_options_l = namedOptionsAccessor.Get("named_options_l"); 

_named_options_2 = namedOptionsAccessor.Get("named_options_2"); 

} 



{ 




"optionl": "valuel_from_json ", 

"option2": -1, 

"subsection": { 


"suboptionl": 

"subvaluel_from_json ", 


"suboption2": 

b 

"Logging": { 
"LogLevel": { 

200 


"Default": 

} 

b 

"lAİarning" 

} 

"AllowedHosts": 

" * ■■ 


Uygulama çalıştırıldığında, sayfa modelinin onGet yöntemi, seçenek sınıfı değerlerini gösteren bir dize 
döndürür: 


optionl = valuel_from_jsonj option2 = -1 


NOTE 

Bir ayarlar dosyasından seçenek yapılandırması ’nı yüklemek için özel bir ConfigurationBuilder kullanırken, temel yolun 
doğru şekilde ayarlandığını onaylayın: 


var configBuilder ■ new ConfigurationBuilder() 

.SetBasePath(Directory.GetCurrentDirectory()) 

.AddDsonFile("appsettings.json", optional: true); 
var config = configBuilder.Build(); 

Services. Conf igııre<MyOptions> (conf ig); 


Ayarlar dosyasından CreateDefaultBuilderaracılığıyla seçenek yapılandırması yüklenirken taban yolunu açıkça ayarlama 
gerekli değildir. 










Bir temsilciyle basit seçenekleri yapılandırma 

Basit seçeneklerin bir temsilciyle yapılandırılması, örnek uygulamada #2 örnek olarak gösterilmiştir. 

Seçenek değerlerini ayarlamak için bir temsilci kullanın. Örnek uygulama MyOptionswithDeiegateConfig sınıfını 
kullanır ( modeller/MyOptionsVVİthDelegcıteConfig. cs ): 

public class MyOptionsl/dithDelegateConfig 

{ 

public MyOptionsWithDelegateConfig() 

{ 

// Set default value. 

Optionl = "valuel_from_ctor"; 

} 

public string Optionl { get; set; } 
public int Option2 { get; set; } = 5; 

} 


Aşağıdaki kodda, hizmet kapsayıcısına ikinci bir IConfigureOptions<TOptions> hizmeti eklenir. 
MyOptionsWithDeiegateConfig ile bağlamayı yapılandırmak için bir temsilci kullanır: 


// Example #2: Options bound and configured by a delegate 
Services.Configure<MyOptionsWithDelegateConfig>(myOptions => 
{ 

myOptions.Optionl = "valuel_configured_by_delegate"; 
my0ptions.0ption2 = 500; 

}); 


lndex.cshtml.cs\ 


private readonly MyOptionsl/dithDelegateConfig _optionsl/dithDelegateConfig; 


public IndexModel( 

IOptionsMonitor<MyOptions> optionsAccessor, 

IOptionsMonitor<MyOptionsWithDelegateConfig> optionsAccessorl/dithDelegateConfig, 
IOptionsMonitor<MySubOptions> subOptionsAccessor, 

IOptionsSnapshot<MyOptions> snapshotOptionsAccessor, 

IOptionsSnapshot<MyOptions> namedOptionsAccessor) 

{ 

_options = optionsAccessor.CurrentValue; 

_optionsl/dithDelegateConfig = optionsAccessorl/dithDelegateConfig.CurrentValue; 
_subOptions = subOptionsAccessor.CurrentValue; 

_snapshotOptions = snapshotOptionsAccessor.Value; 

_named_options_l = namedOptionsAccessor.Get("named_options_l"); 

_named_options_2 = namedOptionsAccessor.Get("named_options_2"); 

} 


// Example #2: Options configured by delegate 

var delegate_config_optionl = _optionsWithDelegateConfig.Optionl; 
var delegate_config_option2 = _optionsWithDelegateConfig.Option2; 
SimpleOptionsWithDelegateConfig = 

$"delegate_optionl = {delegate_config_optionl}, " + 
$"delegate_option2 = {delegate_config_option2}"; 


Birden çok yapılandırma sağlayıcısı ekleyebilirsiniz. Yapılandırma sağlayıcıları NuGet paketlerinde 
kullanılabilir ve kayıtlı oldukları sırayla uygulanır. Daha fazla bilgi için bkz. ASP.NET Core yapılandırma. 






Her Configure çağrısı, hizmet kapsayıcısına bir IConfigureOptions<TOptions> hizmeti ekler. Yukarıdaki 
örnekte, Optioni ve 0 ption 2 değerlerinin ikisi de appSettings. JSONlçnde belirtilmiştir, ancak Optioni ve 
0 ption 2 değerleri yapılandırılan temsilci tarafından geçersiz kılınır. 

Birden fazla yapılandırma hizmeti etkinleştirildiğinde, son yapılandırma kaynağı WINS ' i ve yapılandırma 
değerini ayarlar. Uygulama çalıştırıldığında, sayfa modelinin onGet yöntemi, seçenek sınıfı değerlerini 
gösteren bir dize döndürür: 

delegate_optionl = valuel_configured_by_delegate, delegate_option2 = 500 


Alt seçenekler yapılandırması 

Alt seçenekler yapılandırması örnek uygulamada #3 örnek olarak gösterilmiştir. 

Uygulamalar, uygulamadaki belirli senaryo gruplarına (sınıflar) ait seçenek sınıfları oluşturmamalıdır. 
Uygulamanın yapılandırma değerleri gerektiren bölümlerinin yalnızca kullandıkları yapılandırma değerlerine 
erişimi olmalıdır. 

Seçenekleri yapılandırmaya bağlama sırasında, seçenek türündeki her bir özellik property[ :sub-pnoperty: ] 
formun bir yapılandırma anahtarına bağlanır. Örneğin, MyOptions.Optioni özelliği appSettings. USOA/içindeki 
optioni özelliğinden okunan anahtar Optioni bağımlıdır. 

Aşağıdaki kodda, hizmet kapsayıcısına üçüncü bir IConfigureOptions<TOptions> hizmeti eklenir. 
MySubOptions appSettings. JSON dosyasının subsection bölümüne bağlar: 

// Example #3: Suboptions 

// Bind options using a sub-section of the appsettings.json file. 
services.Configure<MySubOptions>(Configuration.GetSection("subsection")); 

Getsection yöntemi Microsoft.Extensions.Configuration ad alanını gerektirir. 


Örneğin appSettings. JSON dosyası, suboptioni ve suboption 2 için anahtarlar içeren bir subsection üyesini 
tanımlar: 



(. modeller/Myalt seçenekler, cs ): 















public class MySubOptions 

{ 

public MySubOptions() 

{ 

// Set default values. 

SubOptionl = "valuel_from_ctor"; 

Sub0ption2 = 5; 

} 

public string SubOptionl { get; set; } 
public int Sub0ption2 { get; set; } 

} 

Sayfa modelinin onGet yöntemi, Seçenekler değerleriyle ( Pages/lndex. cshtml. cs) bir dize döndürür: 

private neadonly MySubOptions _subOptions; 


public IndexModel( 

IOptionsMonitor<MyOptions> optionsAccessor, 

IOptionsMonitor<MyOptionsWithDelegateConfig> optionsAccessorWithDelegateConfig, 
IOptionsMonitor<MySubOptions> subOptionsAccessor, 

IOptionsSnapshot<MyOptions> snapshotOptionsAccessor, 

IOptionsSnapshot<MyOptions> namedOptionsAccessor) 

{ 

_options = optionsAccessor.CurrentValue; 

_optionsWithDelegateConfig = optionsAccessorWithDelegateConfig.CurrentValue; 
_subOptions = subOptionsAccessor.CurrentValue; 

_snapshotOptions = snapshotOptionsAccessor.Value; 

_named_options_l = namedOptionsAccessor.Get("named_options_l"); 

_named_options_2 = namedOptionsAccessor.Get("named_options_2"); 

} 


// Example #3: Suboptions 

var SubOptionl = _subOptions.SubOptionl; 

var subOption2 = _subOptions.SubOption2; 

SubOptions = $"subOptionl = {subOptionl}, subOption2 = {subOption2}"; 

Uygulama çalıştırıldığında OnGet yöntemi, alt sınıf değerlerini gösteren bir dize döndürür: 

SubOptionl = subvaluel_from_jsonj subOption2 = 200 


Bir görünüm modeli veya doğrudan görünüm ekleme ile belirtilen 
seçenekler 

Bir görünüm modeli veya doğrudan görünüm ekleme ile sunulan seçenekler örnek uygulamada #4 olarak 
gösterilmiştir. 

Seçenekler, bir görünüm modelinde veya IOptionsMonitor<TOptions> ekleme tarafından doğrudan bir 
görünüme ( Pages/lndex. cshtml. cs) sağlanabilir. 

private readonly MyOptions _options; 











public IndexModel( 

IOptionsMonitor<MyOptions> OptionsAccessor, 

IOptionsMonitor<MyOptionsWithDelegateConfig> optionsAccessorWithDelegateConfig, 
IOptionsMonitor<MySubOptions> subOptionsAccessor, 

IOptionsSnapshot<MyOptions> snapshotOptionsAccessor, 

IOptionsSnapshot<MyOptions> namedOptionsAccessor) 

{ 

_options = OptionsAccessor.CurrentValue; 

_optionsWithDelegateConfig = optionsAccessorl/JithDelegateConfig. CurrentValue; 
_subOptions = subOptionsAccessor.CurrentValue; 

_snapshotOptions = snapshotOptionsAccessor.Value; 

_named_options_l = namedOptionsAccessor.Get("named_options_l"); 

_named_options_2 = namedOptionsAccessor.Get("named_options_2"); 

} 


// Example #4: Bind options directly to the page 
MyOptions = _options; 

Örnek uygulama, @inject yönergeyle i0ptionsMonitor<My0ptions> nasıl ekleneceğini gösterir: 
@page 

@model IndexModel 

@using Microsoft.Extensions.Options 

@inject IOptionsMonitor<MyOptions> OptionsAccessor 

@{ 

ViewData["Title"] = "Options Sample"; 

} 

<hl>@ViewData["Title"]</hl> 


Uygulama çalıştırıldığında, seçenek değerleri işlenen sayfada gösterilir: 


Example #4: Model and injected options 

Options provided by the model 

Options provided bythe model: @Model.MyOptions.optionl and @Model.MyOptions.Option2 
Optionl: valuel fromjson 

Option2: -1 

Options injected into the page 

Options injected into the page: @inject IOptions<MyOptions> OptionsAccessor Wİth @OptionsAccessor.Value.Optionl and 
@OptionsAccessor.Value.Option2 

Optionl: valuel fromjson 

Option2: -1 


loptionssnapshot ile yapılandırma verilerini yeniden yükleme 

Yapılandırma verilerini IOptionsSnapshot<TOptions> ile yeniden yükleme örnek uygulamada örnek #5 
gösterilmiştir. 

IOptionsSnapshot<TOptions>, minimum işleme yüküyle yeniden yükleme seçeneklerini destekler. 
Seçenekler erişildiğinde ve isteğin ömrü boyunca önbelleğe alındığında her istek için bir kez hesaplanır. 
Aşağıdaki örnek, appSettings. JSON değişikliklerinden sonra yeni bir IOptionsSnapshot<TOptions> nasıl 







oluşturulduğunu gösterir ( Pages/lndex. cshtml. cs). Sunucu için birden çok istek, dosya değiştirilene ve 
yapılandırma yeniden yükleninceye kadar appSettings. JSON dosyası tarafından belirtilen sabit değerler 
döndürüyor. 

private readonly MyOptions _snapshotOptionsj 


public IndexModel( 

IOptionsMonitorcMyOptions» optionsAccessor, 

IOptionsMonitor<MyOptionsWithDelegateConfig> optionsAccessorWithDelegateConfig, 
IOptionsMonitor<MySubOptions> subOptionsAccessor, 

IOptionsSnapshot<MyOptions> snapshotOptionsAccessor, 

IOptionsSnapshot<MyOptions> namedOptionsAccessor) 

{ 

_options = optionsAccessor.CurrentValue; 

_optionsWithDelegateConfig = optionsAccessorWithDelegateConfig.CurrentValue; 
_subOptions = subOptionsAccessor.CjrrentValue; 

_snapshotOptions = snapshotOptionsAccessor.Value; 

_nam 0 d_options_l = namedOptionsAccessor.Get("named_options_l"); 

_named_options_2 = namedOptionsAccessor.Get("named_options_2"); 

} 



gösterilmektedir: 



AppSettings. JSON dosyasını kaydedin. Seçenekler değerlerinin güncelleştirildiğini görmek için tarayıcıyı 
yenileyin: 

snapshot optionl = valuel_from_json UPDATED, snapshot option2 = 200 


IController Enamedooptıons ile adlandırılmış seçenekler desteği 

IConfigurel\lamedOptions<TOptions> ile adlandırılmış seçenekler, örnek uygulamada 6 #örnek olarak 
gösterilmiştir. 

AdlandırılmLŞ seçenekler desteği, uygulamanın adlandırılmış seçenek yapılandırmalarının ayırt etmesine izin 
verir. Örnek uygulamada, adlandırılmış Seçenekler OptionsServiceCollectionExtensions. configureile 
bildirilmiştir ve bu, <TOptions > 1 i çağırır. Uzantı yöntemini Yapılandır: 








// Example #6: Named options (named_options_l) 

// Register the ConfigurationBuilder instance which MyOptions binds against. 

// Specify that the options loaded fnom configuration are named 
// "named_options_l". 

Services.Configure<MyOptions>("named_options_l", Configuration); 

// Example #6: Named options (named_options_2) 

// Specify that the options loaded from the MyOptions class are named 
// "named_options_2". 

// Use a delegate to configure option values. 

Services.Configure<My0ptions>("named_options_2", myOptions => 

{ 

myOptions.Optionl = "named_options_2_valuel_from_action"; 

}); 

Örnek uygulama, Get ( Pages/lndex. cshtml. cs) adlı adlandırılmış seçeneklere erişir: 

private readonly MyOptions _named_options_l; 
private readonly MyOptions _named_options_2; 


public IndexModel( 

IOptionsMonitor<MyOptions> optionsAccessor, 

IOptionsMonitor<MyOptionsWithDelegateConfig> optionsAccessorl/JithDelegateConfig, 
IOptionsMonitor<MySubOptions> subOptionsAccessor, 

IOptionsSnapshot<MyOptions> snapshotOptionsAccessor, 

IOptionsSnapshot<MyOptions> namedOptionsAccessor) 

{ 

_options = optionsAccessor.CurrentValue; 

_optionsWithDelegateConfig = optionsAccessorl/JithDelegateConfig.CurrentValue; 
_subOptions = subOptionsAccessor.CurrentValue; 

_snapshotOptions = snapshotOptionsAccessor.Value; 

_named_options_l = namedOptionsAccessor.Get("named_options_l"); 

_named_options_2 = namedOptionsAccessor.Get("named_options_2"); 

} 


// Example #6: Named options 
var named_options_l = 

$"named_options_l: optionl = {_named_options_l.Optionl}, " + 

$"option2 = {_named_options_1.0ption2}"; 
var named_options_2 = 

$"named_options_2: optionl = {_named_options_2.Optionl}, " + 

$"option2 = {_named_options_2.0ption2}"; 

NamedOptions = $"{named_options_l} {named_options_2}"; 

Örnek uygulama çalıştırıldığında, adlandırılmış seçenekler döndürülür: 

named_options_l: optionl = valuel_from_json, option2 = -1 
named_options_2: optionl = named_options_2_valuel_from_action, option2 = 5 

named_options_ı değerler, appSettings. JSON dosyasından yüklenen yapılandırmadan sağlanır. 
named_options _2 değerleri tarafından sağlanır: 


• Optionl için ConfigureServices named_options_2 temsilcisi. 

• MyOptions sınıfı tarafından sağlanmış 0ption2 için varsayılan değer. 


Tüm seçenekleri ConfigureAlI yöntemiyle yapılandırma 







Tüm seçenek örneklerini ConfigureAli yöntemiyle yapılandırın. Aşağıdaki kod, ortak bir değere sahip tüm 
yapılandırma örnekleri için Optioni yapılandırır. startup.configureServices yöntemine el ile aşağıdaki kodu 
ekleyin: 

Services.ConfigureAll<MyOptions>(myOptions => 

{ 

myOptions.Optioni = "ConfigureAli replacement value"; 

})J 

Kodu ekledikten sonra örnek uygulamayı çalıştırmak aşağıdaki sonucu verir: 

named_options_l: optioni = ConfigureAli replacement value, option2 = -1 
named_options_2: optioni = ConfigureAli replacement value, option2 = 5 


NOTE 

Tüm seçenekler adlandırılmış örneklerdir. Mevcut IConfigureOptions<TOptions> örnekleri, 
string. Empty''Options.DefaultName örneğini hedefleyecek şekilde değerlendirilir. 

IConfigureNamedOptions<TOptions> Ayrıca IConfigureOptions<TOptions> uygular. IOptionsFactory<TOptions> 
varsayılan uygulamasının her birini uygun şekilde kullanma mantığı vardır, null adlandırılmış seçenek, belirli bir 
adlandırılmış örnek yerine tüm adlandırılmış örnekleri hedeflemek için kullanılır (ConfigureAli ve PostConfigureAlI bu 
kuralı kullanın). 


Seçenekno Oluşturucu API 'SI 

OptionsBuilder<TOptions>, TOptions örnekleri yapılandırmak için kullanılır. OptionsBuiider .sonraki 
çağrıların tümünde olmak yerine ilk AddOptions<TOptions>(string optionsName) çağrısına yalnızca tek bir 
parametre olan adlandırılmış seçenekleri oluşturmayı kolaylaştırır. Seçenekler doğrulaması ve hizmet 
bağımlılıklarını kabul eden configureOptions aşırı yüklemeler yalnızca OptionsBuiider ile kullanılabilir. 

// Options.DefaultName = "" is used. 

Services.AddOptions<MyOptions>().Configure(o => o.Property = "default"); 

Services.AddOptions<MyOptions>("optionalName") 

.Configure(o => o.Property = "named"); 


Ayarları yapılandırmak için dı hizmetlerini kullanma 

Seçenekleri iki şekilde yapılandırırken, bağımlılık ekleme işleminden diğer hizmetlere erişebilirsiniz: 

• <TOptions > 1 nin Options Builder'da yapılandırılması için bir yapılandırma temsilcisi geçirin. <bir 
TOptions > seçenek Oluşturucusu , seçenekleri yapılandırmak için en fazla beş hizmeti kullanmanıza 
olanak sağlayan, yapılandırma yüklerini sağlar: 

Services.AddOptions<MyOptions>("optionalName") 

•ConfigurecServicel, Service2, Service3, Service4, Service5>( 

(o, s, s2, s3, s4, s5) => 

o.Property = DoSomethingWith(s, s2, s3, s4, s5)); 


• IConfigureOptions<TOptions> veya IConfigureNamedOptions<TOptions> uygulayan ve türü bir 
hizmet olarak kaydeden kendi türünü oluşturun. 

Bir hizmetin oluşturulması daha karmaşık olduğundan, yapılandırmakiçin bir yapılandırma temsilcisinin 












geçirilmesini öneririz. Kendi türünü oluşturmak, Yapılandır'ı kullandığınızda çerçevenin sizin için yaptığı işe 
eşdeğerdir. Yapılandırma çağrısı, belirtilen genel hizmet türlerini kabul eden bir oluşturucuya sahip olan geçici 
genel IConfigureNamedOptions<TOptions> kaydeder. 

Yapılandırma sonrası seçenekler 

Yapılandırma sonrası IPostConfigureOptions<TOptions>ayarlayın. Tüm IConfigureOptions<TOptions> 
yapılandırma oluştuktan sonra yapılandırma sonrası çalıştırmalar: 

Services.PostConfigure<MyOptions>(myOptions => 

{ 

myOptions.Optionl = "post_configured_optionl_value"; 

}); 

PostConfigure, adlandırılmış seçenekleri yapılandırmak için kullanılabilir: 

Services.PostConfigure<MyOptions>("named_options_l ", myOptions => 

{ 

myOptions.Optionl = "post_configured_optionl_value"; 

}); 

Tüm yapılandırma örneklerini yapılandırmak için PostConfigureAlI kullanın: 

Services.PostConfigureAll<MyOptions>(myOptions => 

{ 

myOptions.Optionl = "post_configured_optionl_value"; 

}); 


Başlangıç sırasında seçeneklere erişme 

IOptions<TOptions> ve IOptionsMonitor<TOptions> startup.configure kullanılabilir, çünkü Hizmetleri 
configure Yöntemi yürütülmeden önce oluşturulmuştur. 


public void Configure(IApplicationBuilder app, IOptionsMonitor<MyOptions> optionsAccessor) 

{ 

var optionl = optionsAccessor.CurrentValue.Optionl; 

} 

startup.configureServices IOptions<TOptions> veya IOptionsMonitor<TOptions> kullanmayın. Hizmet 
kayıtlarının sıralaması nedeniyle tutarsız bir seçenek durumu var olabilir. 

Ek kaynaklar 


• ASP.NET Coreyapılandırma 





ASPNET Core çoklu ortamları kullanma 
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Tarafından RickAnderson 

ASP.NET Core, bir ortam değişkeni kullanarak çalışma zamanı ortamı temelinde uygulama davranışını 
yapılandırır. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Ortamlar 

ASP.NET Core, uygulama başlangıcında aspnetcore_environment ortam değişkenini okur ve değeri 
ıvvebhostenvironment. EnvironmentNameiçinde depolar. aspnetcore_environment herhangi bir değere 
ayarlanabilir, ancak Framevvork tarafından üç değer sağlanır: 

• Development 

• Staging 

• Production (varsayılan) 

public void Configure(IApplicationBuilder app., IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

if (env.IsProduction() || env.IsStagingO || env.IsEnvironment("Staging_2")) 

{ 

app.UseExceptionHandler("/Error"); 

} 

app.UseStaticFiles(); 

app.UseMvc(); 

} 

Yukarıdaki kod: 

• aspnetcore_environment Development olarak ayarlandığında, UseDeveloperExceptionPage çağırır. 

• aspnetcore_environment değeri aşağıdakilerden birini ayarladığınızda Useexceptionhandler 1 i 
çağırır: 

o Staging 
o Production 
o Staging_2 

Ortam etiketi Yardımcısı , öğesinde biçimlendirme eklemek veya dışlamak için 
IHostingEnvironment.EnvironmentName değerini kullanır: 









<environment include="Development"> 

<div>&lt;environment include="Development"&gt;</div> 
</environment> 

<environment exclude="Development"> 

<div>&lt;environment exclude="Development"&gt;</div> 
</environment> 

<environment include=" Staging, Development,Staging_2"> 

<div> 

&lt;environment include=" Staging, Development,Staging_2"&gt; 
</div> 

</environment> 


Windows ve macOS 'ta, ortam değişkenleri ve değerleri büyük/küçük harfe duyarlı değildir. Linux ortam 
değişkenleri ve değerleri varsayılan olarak büyük/küçük harfe duyarlıdır. 

Geliştirme 

Geliştirme ortamı, üretimde gösterilmemelidir özellikleri etkinleştirebilir. Örneğin, ASP.NET Core 
Şablonlar geliştirme ortamında Geliştirici özel durum sayfasını etkinleştirir. 

Yerel makine geliştirme ortamı, projenin Properties\launchSettings.JSON dosyasında ayarlanabilir. 
Laurıchsettings. JSON geçersiz kılma değerlerini sistem ortamında ayarlanan ortam değerleri. 

Aşağıdaki JSON, bir Laurıchsettings. JSON dosyasından üç profil gösterir: 

{ 

"iisSettings": { 

"windowsAuthentication": false, 

"anonymousAuthentication": true, 

"iisExpress": { 

"applicationUrl": "http://localhost:54339/", 

"sslPort": 0 

} 

}, 

"profiles": { 

"IIS Express": { 

"commandName": "IISExpress", 

"launchBrowser": true, 

"environmentVariables": { 

"ASPNETCORE_My_Environment": "1", 

"ASPNETCORE_DETAILEDERRORS": "1", 

"ASPNETCORE_ENVIRONMENT": "Staging" 

} 

"EnvironmentsSample": { 

"commandName": "Project", 

"launchBrovjser": true, 

"environmentVariables": { 

"ASPNETCORE_ENVIRONMENT": "Staging" 

"applicationUrl": "http://localhost:54340/" 

"Kestrel Staging": { 

"commandName": "Project", 

"launchBrowser": true, 

"environmentVariables": { 

"ASPNETCORE_My_Environment": "1", 

"ASPNETCORE_DETAILEDERRORS": "1", 

"ASPNETCORE_ENVIRONMENT": "Staging" 

L 

"applicationUrl": "http://localhost:51997/" 

} 

} 

} 




NOTE 

Launchsettings. JSON içindeki applicationurl özelliği sunucu URL ’lerinin bir listesini belirtebilir. Listedeki URL 
'Ler arasında noktalı virgül kullanın: 

"EnvironmentsSample": { 

"commandName": "Project", 

"launchBrowser'": true, 

"applicationllr'l": "https://localhost: 5001; http ://localhost: 5000", 

"environmentVariables": { 

"ASPNETCORE_ENVIRONMENT": "Development" 

> 

} 


Uygulama DotNet çalıştırmasıile başlatıldığında, "commandName": "Project" ilk profili kullanılır. 
commandName değeri, başlatılacak Web sunucusunu belirtir. commandName aşağıdakilerden biri olabilir: 


• IISExpress 

• IIS 

• Project (Kestrel Başlatan) 

Bir uygulama DotNet çalıştırmasıile başlatıldığında: 

• Laurıchsettings. JSON varsa okundu, launchsettings. JSON geçersiz kılma ortamı değişkenlerine 

environmentVariables ayarlan. 

• Barındırma ortamı görüntülenir. 

Aşağıdaki çıktıda, DotNet çalıştırmasıile başlatılan bir uygulama gösterilmektedir: 

PS C:\Websites\EnvironmentsSample> dotnet run 

Using launch settings from C:\Websites\EnvironmentsSample\Properties\launchSettings.json... 
Hosting environment: Staging 

Content root path: C:\Websites\EnvironmentsSample 
Now listening on: http://localhost:54340 
Application started. Press Ctrl+C to shut down. 


Visual Studio proje özellikleri hata ayıklama sekmesi, launchsettings. JSON dosyasını düzenlemek için bir 
GUI sağlar: 








EnvironmentsSample* X 


Application 

Build 

Configuration: N/A 

Build Events 


Package 

Profile 

Debug* 1 

Signing 

Launch: 

TypeScript Build 

Resources 

Application arguments: 


Working directory: 

[Vİ Launch browser: 
Environment variables: 


Web Server Settings 


Platform: N/A 


IIS Express 


IIS Express 
EnvironmentsSample 


Kestrel Staging 
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Aöso/ufe path to working directory 


Absolute orrelative URL 


Name Value 

ASPNETCORE_ENVIRONMENT Staging 
ASPNETCORE_DETAILEDERRORS 1 
ASPNETCORE_My_Environment 1 


Add URL: 


httD//localhost:54339/ 


New.. 


Brovvse 


Add 


Remove 


Proje profillerinde yapılan değişiklikler, Web sunucusu yeniden başlatılana kadar etkili olmayabilir.Kestrel, 
ortamında yapılan değişiklikleri algılayabilmesi için yeniden başlatılmalıdır. 


VVARNING 

Laurıchsettings. JSON gizli dizileri depolamamamalıdır. Gizli anahtar geliştirme için gizli dizileri depolamak için gizli 
dizi Yöneticisi aracı kullanılabilir. 


Visual Studio Codekullanırken, ortam değişkenleri. vscode/Launch. JSON dosyasında ayarlanabilir. 
Aşağıdaki örnek, Development için ortamı ayarlar: 

{ 

"version": "0.2.0", 

"configurations": [ 

{ 

"name": ".NET Core Launch (web)"j 
... additional VS Code configuration settings ... 

"env": { 

"ASPNETCORE_ENVIRONMENT": "Development" 

} 

} 

] 

} 

Uygulama dotnet run Özellikler/launchSettings. JSONlle aynı şekilde başlatılırken, projedeki bir. 
vscode/Launch. JSON dosyası okunamaz. Geliştirme sırasında Launchsettings. JSON dosyası olmayan bir 
uygulama başlatırken, ortam değişkeni veya bir komut satırı bağımsız değişkeni olan ortamı dotnet run 
komutuna ayarlayın. 

Üretim 

Üretim ortamının güvenliği, performansı ve uygulama sağlamlık düzeyini en üst düzeye çıkarmak için 

















































yapılandırılması gerekir. Geliştirmeden farklı bazı yaygın ayarlar şunlardır: 

• Önbelleği. 

• istemci tarafı kaynaklar paketlenmiş, küçültülmüş ve potansiyel olarak bir CDN 'den sunulan. 

• Tanılama hata sayfaları devre dışı. 

• Kolay hata sayfaları etkin. 

• Üretim günlüğü ve izleme etkin. Örneğin, Application Insights. 

Ortamı ayarlama 

Bir ortam değişkeni veya platform ayarıyla test için belirli bir ortam ayarlamak genellikle yararlıdır. Ortam 
ayarlanmamışsa, çoğu hata ayıklama özelliğini devre dışı bırakan Production varsayılan olarak ayarlanır. 
Ortamı ayarlama yöntemi işletim sistemine bağlıdır. 

Konak yapılandırıldığında, uygulama tarafından okunan son ortam ayarı, uygulamanın ortamını belirler. 
Uygulama çalışırken uygulamanın ortamı değiştirilemez. 

Ortam değişkeni veya platform ayarı 
Azure uygulama hizmeti 

Azure App Serviceortamında ortamı ayarlamak için aşağıdaki adımları gerçekleştirin: 

1. Uygulama Hizmetleri dikey penceresinden uygulamayı seçin. 

2. Ayarlar grubunda, uygulama ayarları dikey penceresini seçin. 

3. Uygulama ayarları alanında yeni ayar Ekle 1 yi seçin. 

4. Ad giriniçin aspnetcore_environment sağlayın. Değer giriniçin ortamı sağlayın (örneğin, staging ). 

5. Ortam ayarının, dağıtım yuvaları takas edildiğinde geçerli yuvada kalmasını istiyorsanız, yuva ayarı 
onay kutusunu işaretleyin. Daha fazla bilgi için bkz. Azure belgeleri: hangi ayarları değiştirmiş?. 

6. Dikey pencerenin en üstünde Kaydet 1 i seçin. 

Azure App Service, Azure portal bir uygulama ayarı (ortam değişkeni) eklendikten, değiştirildikten veya 
silindikten sonra uygulamayı otomatik olarak yeniden başlatır. 

VVindovvs 

Uygulama DotNet çalıştırmasıkullanılarak başlatıldığında geçerli oturumun aspnetcore_environment 
ayarlamak için aşağıdaki komutlar kullanılır: 

Komut istemi 

set ASPNETCORE_ENVIRONMENT=Development 

PovverShell 

$Env:ASPNETCORE_ENVIRONMENT = "Development" 

Bu komutlar yalnızca geçerli pencere için etkili olur. Pencere kapatıldığında, aspnetcore_environment ayarı 
varsayılan ayar veya makine değerine geri döner. 

VVindovvs 'da genel değeri ayarlamak için aşağıdaki yaklaşımlardan birini kullanın: 

• Sistem > gelişmiş sistem ayarları > denetim masası nı açın ve aspnetcore_environment 
değerini ekleyin veya düzenleyin: 
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• Bir yönetim komut istemi açın ve setx komutunu kullanın veya bir yönetim PovverShell komut 
istemi açın ve [Environment]: :SetEnvironmentVariable kullanın: 

Komut istemi 

setx ASPNETCORE_ENVIRONMENT Development /M 

/m anahtarı, ortam değişkenini sistem düzeyinde ayarlamaya yönelik olduğunu gösterir, /m 
anahtarı kullanılmazsa, ortam değişkeni Kullanıcı hesabı için ayarlanır. 

PovverShell 


[Environment]::SetEnvironmentVariable("ASPNETCORE_ENVIRONMENT ", "Development ", "Machine") 

Machine seçenek değeri, ortam değişkeninin sistem düzeyinde ayarlandığını gösterir. Seçenek 
değeri User olarak değiştirilirse, ortam değişkeni Kullanıcı hesabı için ayarlanır. 

aspnetcore_environment ortam değişkeni genel olarak ayarlandığında, değer ayarlandıktan sonra açılan 
herhangi bir komut penceresinde dotnet run için geçerli olur. 

Web. config 

aspnetcore_environment ortam değişkenini Web. config ile ayarlamak için, ASP.NET Core Modülüortom 
değişkenlerini ayarlama bölümüne bakın. 

Proje dosyası veya yayımlama profili 

WINDOWS IIS dağıtımları için: <EnvironmentName> özelliğini Publish profile (. pubxml) veya proje 
dosyasına ekleyin. Bu yaklaşım, proje yayımlandığında Web. config içinde ortamı ayarlar: 
















































<PropertyGroup> 

<EnvironmentName>Development</EnvironmentName> 

</PropertyGroup> 

IIS uygulama havuzu başına 

Yalıtılmış uygulama havuzunda çalışan bir uygulamanın aspnetcore_environment ortam değişkenini 
ayarlamak için (IIS 10,0 veya üzeri sürümlerde desteklenir), ortam değişkenlerinin 

<environmentVariables> konusunun Appcmd. exe komut bölümüne bakın. aspnetcore_environment ortam 
değişkeni bir uygulama havuzu için ayarlandığında, değeri sistem düzeyindeki bir ayarı geçersiz kılar. 


IMPORTANT 

IIS 'de bir uygulama barındırırken ve aspnetcore environment ortam değişkenini ekleyerek veya değiştirirken, yeni 
değerin uygulamalar tarafından çekilmek için aşağıdaki yaklaşımlardan birini kullanın: 

• net stop was /y ve ardından komut isteminden net start w3svc yürütün. 

• Sunucuyu yeniden başlatın. 


macOS 

MacOS için geçerli ortamın ayarlanması, uygulamayı çalıştırırken satır içinde gerçekleştirilebilir: 

ASPNETCORE_ENVIRONMENT=Development dotnet run 

Alternatif olarak, uygulamayı çalıştırmadan önce ortamı export ayarlayın: 

export ASPNETCORE_ENVIRONMENT=Development 

Makine düzeyinde ortam değişkenleri . bashrc veya . bash_profile dosyasında ayarlanır. Herhangi bir metin 
düzenleyicisini kullanarak dosyayı düzenleyin. Aşağıdaki ifadeyi ekleyin: 

export ASPNETCORE_ENVIRONMENT=Development 

Linux 

Linuxdistros için, oturum tabanlı değişken ayarları ve makine düzeyindeki ortam ayarları için bash_profile 
dosyası için bir komut isteminde export komutunu kullanın. 

Kodda ortam ayarlama 

Konağı oluştururken UseEnvironment çağırın. Bkz. NET genel ana bilgisayar. 

Ortama göre yapılandırma 

Yapılandırmayı ortama göre yüklemek için şunları yapmanızı öneririz: 

• appSettings dosyaları ( appSettings. {Env'ıronment}. JSON). Bkz.ASP.NET Core yapılandırma. 

• Ortam değişkenleri (uygulamanın barındırıldığı her bir sistemde ayarlanır). Bkz. .NET genel ana 
bilgisayar ve ASP.N ET Core sürümünde geliştirme sırasında uygulama gizli dizileri güvenli depolama. 

• Gizli dizi Yöneticisi (yalnızca geliştirme ortamında). Bkz. ASP.NET Core sürümünde geliştirme sırasında 
uygulama gizli dizileri güvenli depolama. 

Ortam tabanlı başlangıç sınıfı ve yöntemleri 

Ivvebhostenvironment T başlatmaya ekleme, configure 













IVVebHostEnvironment startup.configure ekleme. Bu yaklaşım, uygulama yalnızca, ortam başına en az 
kod farklılığı olan birkaç ortam için startup.configure ayarlamayı gerektirdiğinde yararlıdır. 

public void Configure(IApplicationBuilder app, IklebHostEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

// Development environment code 

} 

else 

{ 

// Code for ali other environments 

} 

} 


Başlangıç sınıfına ıvvebhostenvironment ekleme 

startup oluşturucusuna IVVebHostEnvironment ekleyin. Bu yaklaşım, uygulama her ortam için en az kod 
farklılığı olan birkaç ortam için startup yapılandırmayı gerektirdiğinde yararlıdır. 

Aşağıdaki örnekte: 


uygulamanın ortamına göre başlangıç yapılandırmasını 

uygulamak için kullanılır. 


public class Startup 

{ 

private readonly IWebHostEnvironment _env; 

public Startup(IWebHostEnvironment env) 

{ 

_env = env; 

> 

public void ConfigureServices(IServiceCollection Services) 

{ 

if (_env.IsDevelopment()) 

{ 

// Development environment code 

} 

else if (_env.IsStaging()) 

{ 

// Staging environment code 

} 

else 

{ 

// Code for ali other environments 

} 

} 

public void Configure(IApplicationBuilder app) 

{ 

if (_env.IsDevelopment()) 

{ 

// Development environment code 

} 

else 

{ 

// Code for ali other environments 

} 

} 

} 


• Ortam env alanında tutulur. 


_env , 

ConfigureServices 

ve 

Configure 











Başlangıç sınıfı kuralları 

ASP.NET Core bir uygulama başlatıldığında, Başlangıç sınıfı uygulamayı önyükleme. Uygulama farklı 
ortamlar için ayrı startup sınıfları tanımlayabilir (örneğin, startupDevelopment ). Uygun startup sınıfı 
çalışma zamanında seçildi. Geçerli ortamla eşleşen ad sonekine sahip olan sınıf önceliklendirilir. Eşleşen bir 
startup{EnvironmentName} sınıfı bulunamazsa, startup sınıfı kullanılır. Bu yaklaşım, uygulama başına çok 
sayıda kod farklılığı olan birkaç ortam için başlangıç yapılandırması gerektirdiğinde yararlıdır. 

Ortam tabanlı startup sınıfları uygulamak için, kullanımdaki her ortam için bir startup{EnvironmentName} 
sınıfı ve bir geri dönüş startup sınıfı oluşturun: 

// Startup class to use in the Development environment 
public class StartupDevelopment 
{ 

public void ConfigureServices(IServiceCollection Services) 

{ 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

} 

} 

// Startup class to use in the Production environment 
public class StartupProduction 
{ 

public void ConfigureServices(IServiceCollection Services) 

{ 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

} 

} 

// Fallback Startup class 

// Selected if the environment doesn't match a Startup{EnvironmentName} class 
public class Startup 
{ 

public void ConfigureServices(IServiceCollection Services) 

{ 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

} 

} 


Derleme adını kabul eden Usestartup (ıvvebhostbuilder, String) aşırı yüklemesini kullanın: 

public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build().Run(); 

} 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) 

{ 

var assemblyName = typeof(Startup).GetTypeInfo().Assembly.FullName; 

return WebHost.CreateDefaultBuilder(args) 

.UseStartup(assemblyName); 

} 











Başlangıç yöntemi kuralları 

Yapılandırma ve ConfigureServices , form configure<EnvironmentName> ve 

configure<Environment Name »Services ortama özgü sürümlerini destekler. Bu yaklaşım, uygulama başına çok 
sayıda kod farklılığı olan birkaç ortam için başlangıç yapılandırması gerektirdiğinde yararlıdır. 


public class Startup 

{ 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

StartupConfigureServices(Services); 

} 

public void ConfigureStagingServices(IServiceCollection Services) 

{ 

StartupConfigureServices(Services); 

} 

private void StartupConfigureServices(IServiceCollection Services) 

{ 

Services. AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

if (env.IsProduction() || env.IsStagingO || env.IsEnvironment("Staging_2")) 

{ 

app.UseExceptionHandler("/Error"); 

} 

app.UseStaticFiles(); 

app.UseMvc(); 

} 

public void ConfigureStaging(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (!env.IsStaging()) 

{ 

throw new Exception("Not staging."); 

} 

app.UseExceptionHandler("/Error"); 

app.UseStaticFiles(); 

app.UseMvc(); 

} 

} 


Ek kaynaklar 

• ASP.NET Core'de uygulama başlatma 

• ASP.NET Core yapılandırma 





Tarafından Rick Anderson 


ASP.NET Core, bir ortam değişkeni kullanarak çalışma zamanı ortamı temelinde uygulama davranışını 
yapılandırır. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Ortamlar 

ASP.NET Core, uygulama başlangıcında aspnetcore_environment ortam değişkenini okur ve değeri 
ıhostingenvironment. EnvironmentNameiçinde depolar. aspnetcore_environment herhangi bir değere 
ayarlanabilir, ancak Framevvork tarafından üç değer sağlanır: 

• Development 

• Staging 

• Production (varsayılan) 


public void Configure(IApplicationBuilder app., IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

if (env.IsProduction() || env.IsStagingO || env.IsEnvironment("Staging_2")) 

{ 

app.UseExceptionHandler("/Error"); 

} 

app.UseStaticFiles(); 

app.UseMvc(); 

} 

Yukarıdaki kod: 


• aspnetcore_environment Development olarak ayarlandığında, UseDeveloperExceptionPage çağırır. 

• aspnetcore_environment değeri aşağıdakilerden birini ayarladığınızda Useexceptionhandler 1 i 
çağırır: 

o Staging 
o Production 
o Staging_2 

Ortam etiketi Yardımcısı , öğesinde biçimlendirme eklemek veya dışlamak için 
IHostingEnvironment.EnvironmentName değerini kullanır: 

<environment include="Development"» 

<div»&lt;environment inelude="Development"&gtj </div> 

</environment> 

<environment exclude="Development"» 

<div»&lt;environment exclude="Development"&gtj </div> 

</environment> 

<environment include="Staging,DevelopmentjStaging_2"> 

<div> 

&lt;environment include="StagingjDevelopmentjStaging_2"&gt; 

</div> 

</environment> 







Windows ve macOS 'ta, ortam değişkenleri ve değerleri büyük/küçük harfe duyarlı değildir. Linux ortam 
değişkenleri ve değerleri varsayılan olarak büyük/küçük harfe duyarlıdır. 


Geliştirme 

Geliştirme ortamı, üretimde gösterilmemelidir özellikleri etkinleştirebilir. Örneğin, ASP.NET Core 
Şablonlar geliştirme ortamında Geliştirici özel durum sayfasını etkinleştirir. 

Yerel makine geliştirme ortamı, projenin Properties\launchSettirıgs.JSON dosyasında ayarlanabilir. 
Laurıchsettings. JSON geçersiz kılma değerlerini sistem ortamında ayarlanan ortam değerleri. 

Aşağıdaki JSON, bir Laurıchsettings. JSON dosyasından üç profil gösterir: 

{ 

"iisSettings": { 

"windowsAuthentication": false, 

"anonymousAuthentication": true, 

"iisExpress": { 

"applicationUrl": "http://localhost:54339/", 

"sslPort": 0 

} 

}, 

"profiles": { 

"IIS Express": { 

"commandName": "IISExpress", 

"launchBrotJser": true, 

"environmentVariables": { 

"ASPNETCORE_My_Environment": "1", 

"ASPNETCORE_DETAILEDERRORS": "1", 

"ASPNETCORE_ENVIRONMENT": "Staging" 

} 

}, 

"EnvironmentsSample": { 

"commandName": "Pnoject", 

"launchBrotJser": true, 

"environmentVariables": { 

"ASPNETCORE_ENVIRONMENT": "Staging" 

b 

"applicationUrl": "http://localhost:54340/" 

b 

"Kestrel Staging": { 

"commandName": "Project", 

"launchBrotJser": true, 

"environmentVariables": { 

"ASPNETCORE_My_Environment": "1", 

"ASPNETCORE_DETAILEDERRORS": "1", 

"ASPNETCORE_ENVIRONMENT": "Staging" 

b 

"applicationUrl": "http://localhost:51997/" 

} 

} 

} 



NOTE 

Launchsettings. JSON içindeki applicationurl özelliği sunucu URL ’lerinin bir listesini belirtebilir. Listedeki URL 
'Ler arasında noktalı virgül kullanın: 

"EnvironmentsSample": { 

"commandName": "Project", 

"launchBrowser'": true, 

"applicationllr'l": "https://localhost: 5001; http ://localhost: 5000", 

"environmentVariables": { 

"ASPNETCORE_ENVIRONMENT": "Development" 

> 

} 


Uygulama DotNet çalıştırmasıile başlatıldığında, "commandName": "Project" ilk profili kullanılır. 
commandName değeri, başlatılacak Web sunucusunu belirtir. commandName aşağıdakilerden biri olabilir: 


• IISExpress 

• IIS 

• Project (Kestrel Başlatan) 

Bir uygulama DotNet çalıştırmasıile başlatıldığında: 

• Laurıchsettings. JSON varsa okundu, launchsettings. JSON geçersiz kılma ortamı değişkenlerine 

environmentVariables ayarlan. 

• Barındırma ortamı görüntülenir. 

Aşağıdaki çıktıda, DotNet çalıştırmasıile başlatılan bir uygulama gösterilmektedir: 

PS C:\Websites\EnvironmentsSample> dotnet run 

Using launch settings from C:\Websites\EnvironmentsSample\Properties\launchSettings.json... 
Hosting environment: Staging 

Content root path: C:\Websites\EnvironmentsSample 
Now listening on: http://localhost:54340 
Application started. Press Ctrl+C to shut down. 


Visual Studio proje özellikleri hata ayıklama sekmesi, launchsettings. JSON dosyasını düzenlemek için bir 
GUI sağlar: 
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ASPNETCORE_ENVIRONMENT Staging 
ASPNETCORE_DETAILEDERRORS 1 
ASPNETCORE_My_Environment 1 


Add URL: 


httD//localhost:54339/ 


New.. 


Brovvse 


Add 
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Proje profillerinde yapılan değişiklikler, Web sunucusu yeniden başlatılana kadar etkili olmayabilir.Kestrel, 
ortamında yapılan değişiklikleri algılayabilmesi için yeniden başlatılmalıdır. 


VVARNING 

Laurıchsettings. JSON gizli dizileri depolamamamalıdır. Gizli anahtar geliştirme için gizli dizileri depolamak için gizli 
dizi Yöneticisi aracı kullanılabilir. 


Visual Studio Codekullanırken, ortam değişkenleri. vscode/Launch. JSON dosyasında ayarlanabilir. 
Aşağıdaki örnek, Development için ortamı ayarlar: 

{ 

"version": "0.2.0", 

"configurations": [ 

{ 

"name": ".NET Core Launch (web)"j 
... additional VS Code configuration settings ... 

"env": { 

"ASPNETCORE_ENVIRONMENT": "Development" 

} 

} 

] 

} 

Uygulama dotnet run Özellikler/launchSettings. JSONlle aynı şekilde başlatılırken, projedeki bir. 
vscode/Launch. JSON dosyası okunamaz. Geliştirme sırasında Launchsettings. JSON dosyası olmayan bir 
uygulama başlatırken, ortam değişkeni veya bir komut satırı bağımsız değişkeni olan ortamı dotnet run 
komutuna ayarlayın. 

Üretim 

Üretim ortamının güvenliği, performansı ve uygulama sağlamlık düzeyini en üst düzeye çıkarmak için 

















































yapılandırılması gerekir. Geliştirmeden farklı bazı yaygın ayarlar şunlardır: 

• Önbelleği. 

• istemci tarafı kaynaklar paketlenmiş, küçültülmüş ve potansiyel olarak bir CDN 'den sunulan. 

• Tanılama hata sayfaları devre dışı. 

• Kolay hata sayfaları etkin. 

• Üretim günlüğü ve izleme etkin. Örneğin, Application Insights. 

Ortamı ayarlama 

Bir ortam değişkeni veya platform ayarıyla test için belirli bir ortam ayarlamak genellikle yararlıdır. Ortam 
ayarlanmamışsa, çoğu hata ayıklama özelliğini devre dışı bırakan Production varsayılan olarak ayarlanır. 
Ortamı ayarlama yöntemi işletim sistemine bağlıdır. 

Konak yapılandırıldığında, uygulama tarafından okunan son ortam ayarı, uygulamanın ortamını belirler. 
Uygulama çalışırken uygulamanın ortamı değiştirilemez. 

Ortam değişkeni veya platform ayarı 
Azure uygulama hizmeti 

Azure App Serviceortamında ortamı ayarlamak için aşağıdaki adımları gerçekleştirin: 

1. Uygulama Hizmetleri dikey penceresinden uygulamayı seçin. 

2. Ayarlar grubunda, uygulama ayarları dikey penceresini seçin. 

3. Uygulama ayarları alanında yeni ayar Ekle 1 yi seçin. 

4. Ad giriniçin aspnetcore_environment sağlayın. Değer giriniçin ortamı sağlayın (örneğin, staging ). 

5. Ortam ayarının, dağıtım yuvaları takas edildiğinde geçerli yuvada kalmasını istiyorsanız, yuva ayarı 
onay kutusunu işaretleyin. Daha fazla bilgi için bkz. Azure belgeleri: hangi ayarları değiştirmiş?. 

6. Dikey pencerenin en üstünde Kaydet 1 i seçin. 

Azure App Service, Azure portal bir uygulama ayarı (ortam değişkeni) eklendikten, değiştirildikten veya 
silindikten sonra uygulamayı otomatik olarak yeniden başlatır. 

VVindovvs 

Uygulama DotNet çalıştırmasıkullanılarak başlatıldığında geçerli oturumun aspnetcore_environment 
ayarlamak için aşağıdaki komutlar kullanılır: 

Komut istemi 

set ASPNETCORE_ENVIRONMENT=Development 

PovverShell 

$Env:ASPNETCORE_ENVIRONMENT = "Development" 

Bu komutlar yalnızca geçerli pencere için etkili olur. Pencere kapatıldığında, aspnetcore_environment ayarı 
varsayılan ayar veya makine değerine geri döner. 

VVindovvs 'da genel değeri ayarlamak için aşağıdaki yaklaşımlardan birini kullanın: 

• Sistem > gelişmiş sistem ayarları > denetim masası nı açın ve aspnetcore_environment 
değerini ekleyin veya düzenleyin: 
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• Bir yönetim komut istemi açın ve setx komutunu kullanın veya bir yönetim PovverShell komut 
istemi açın ve [Environment]: :SetEnvironmentVariable kullanın: 

Komut istemi 

setx ASPNETCORE_ENVIRONMENT Development /M 

/m anahtarı, ortam değişkenini sistem düzeyinde ayarlamaya yönelik olduğunu gösterir, /m 
anahtarı kullanılmazsa, ortam değişkeni Kullanıcı hesabı için ayarlanır. 

PovverShell 


[Environment]::SetEnvironmentVariable("ASPNETCORE_ENVIRONMENT ", "Development ", "Machine") 

Machine seçenek değeri, ortam değişkeninin sistem düzeyinde ayarlandığını gösterir. Seçenek 
değeri User olarak değiştirilirse, ortam değişkeni Kullanıcı hesabı için ayarlanır. 

aspnetcore_environment ortam değişkeni genel olarak ayarlandığında, değer ayarlandıktan sonra açılan 
herhangi bir komut penceresinde dotnet run için geçerli olur. 

Web. config 

aspnetcore_environment ortam değişkenini Web. config ile ayarlamak için, ASP.NET Core Modülüortom 
değişkenlerini ayarlama bölümüne bakın. 

Proje dosyası veya yayımlama profili 

WINDOWS IIS dağıtımları için: <EnvironmentName> özelliğini Publish profile (. pubxml) veya proje 
dosyasına ekleyin. Bu yaklaşım, proje yayımlandığında Web. config içinde ortamı ayarlar: 
















































<PropertyGroup> 

<EnvironmentName>Development</EnvironmentName> 

</PropertyGroup> 

IIS uygulama havuzu başına 

Yalıtılmış uygulama havuzunda çalışan bir uygulamanın aspnetcore_environment ortam değişkenini 
ayarlamak için (IIS 10,0 veya üzeri sürümlerde desteklenir), ortam değişkenlerinin 

<environmentVariables> konusunun Appcmd. exe komut bölümüne bakın. aspnetcore_environment ortam 
değişkeni bir uygulama havuzu için ayarlandığında, değeri sistem düzeyindeki bir ayarı geçersiz kılar. 


IMPORTANT 

IIS 'de bir uygulama barındırırken ve aspnetcore environment ortam değişkenini ekleyerek veya değiştirirken, yeni 
değerin uygulamalar tarafından çekilmek için aşağıdaki yaklaşımlardan birini kullanın: 

• net stop was /y ve ardından komut isteminden net start w3svc yürütün. 

• Sunucuyu yeniden başlatın. 


macOS 

MacOS için geçerli ortamın ayarlanması, uygulamayı çalıştırırken satır içinde gerçekleştirilebilir: 

ASPNETCORE_ENVIRONMENT=Development dotnet run 

Alternatif olarak, uygulamayı çalıştırmadan önce ortamı export ayarlayın: 

export ASPNETCORE_ENVIRONMENT=Development 

Makine düzeyinde ortam değişkenleri . bashrc veya . bash_profile dosyasında ayarlanır. Herhangi bir metin 
düzenleyicisini kullanarak dosyayı düzenleyin. Aşağıdaki ifadeyi ekleyin: 

export ASPNETCORE_ENVIRONMENT=Development 

Linux 

Linuxdistros için, oturum tabanlı değişken ayarları ve makine düzeyindeki ortam ayarları için bash_profile 
dosyası için bir komut isteminde export komutunu kullanın. 

Kodda ortam ayarlama 

Konağı oluştururken UseEnvironment çağırın. Bkz. ASP.NET Core Web ana bilgisayarı. 

Ortama göre yapılandırma 

Yapılandırmayı ortama göre yüklemek için şunları yapmanızı öneririz: 

• appSettings dosyaları ( appSettings. {Env'ıronment}. JSON). Bkz.ASP.NET Core yapılandırma. 

• Ortam değişkenleri (uygulamanın barındırıldığı her bir sistemde ayarlanır). Bkz. ASP.NET Core Web 
ana bilgisayarı ve ASP.NET Core sürümünde geliştirme sırasında uygulama gizli dizileri güvenli 
depolama. 

• Gizli dizi Yöneticisi (yalnızca geliştirme ortamında). Bkz. ASP.NET Core sürümünde geliştirme sırasında 
uygulama gizli dizileri güvenli depolama. 


Ortam tabanlı başlangıç sınıfı ve yöntemleri 













Başlangıç olarak ıhostingenvironment ekleme, yapılandırma 

IHostingEnvironment startup.configure ekleme. Bu yaklaşım, uygulama yalnızca, ortam başına en az kod 
farklılığı olan birkaç ortam için startup.configure yapılandırmayı gerektirdiğinde yararlıdır. 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

// Development environment code 

} 

else 

{ 

// Code for ali other environments 

} 

} 

Başlangıç sınıfına ıhostingenvironment ekleme 

startup oluşturucusuna IHostingEnvironment ekleyin ve hizmeti startup sınıfı boyunca kullanmak üzere 
bir alana atayın. Bu yaklaşım, uygulama her ortam için en az kod farklılığı olan birkaç ortam için başlatma 
yapılandırması gerektirdiğinde faydalıdır. 

Aşağıdaki örnekte: 


uygulamanın ortamına göre başlangıç yapılandırmasını 

uygulamak için kullanılır. 


• Ortam env alanında tutulur. 


_env , 

ConfigureServices 

ve 

Configure 









public class Startup 
{ 

private readonly IHostingEnvironment _env; 

public Startup(IHostingEnvironment env) 

{ 

_env = env; 

> 

public void ConfigureServices(IServiceCollection Services) 

{ 

if (_env.IsDevelopment()) 

{ 

// Development environment code 

} 

else if (_env.IsStaging()) 

{ 

// Staging environment code 

} 

else 

{ 

// Code for ali other environments 

} 

} 

public void Configure(IApplicationBuilder app) 

{ 

if (_env.IsDevelopment()) 

{ 

// Development environment code 

} 

else 

{ 

// Code for ali other environments 

} 

} 

} 

Başlangıç sınıfı kuralları 

ASP.NET Core bir uygulama başlatıldığında, Başlangıç sınıfı uygulamayı önyükleme. Uygulama farklı 
ortamlar için ayrı startup sınıfları tanımlayabilir (örneğin, startupDevelopment ). Uygun startup sınıfı 
çalışma zamanında seçildi. Geçerli ortamla eşleşen ad sonekine sahip olan sınıf önceliklendirilir. Eşleşen bir 
startup{ Environment Name} sınıfı bulunamazsa, startup sınıfı kullanılır. Bu yaklaşım, uygulama başına çok 
sayıda kod farklılığı olan birkaç ortam için başlangıç yapılandırması gerektirdiğinde yararlıdır. 

Ortam tabanlı startup sınıfları uygulamak için, kullanımdaki her ortam için bir startup{EnvironmentName} 
sınıfı ve bir geri dönüş startup sınıfı oluşturun: 











// Startup class to use in the Development envinonment 
public class StartupDevelopment 
{ 

public void ConfigureServices(IServiceCollection Services) 

{ 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

} 

} 

// Startup class to use in the Production environment 
public class StartupProduction 
{ 

public void ConfigureServices(IServiceCollection Services) 

{ 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

} 

} 

// Fallback Startup class 

// Selected if the environment doesn't match a Startup{EnvironmentName} class 
public class Startup 
{ 

public void ConfigureServices(IServiceCollection Services) 

{ 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

} 

} 


Derleme adını kabul eden Usestartup (ıvvebhostbuilder, String) aşırı yüklemesini kullanın: 

public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build().Run(); 

} 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) 

{ 

var assemblyName = typeof(Startup).GetTypeInfo().Assembly.FullName; 

return WebHost.CreateDefaultBuilder(args) 

.Usestartup(assemblyName); 

} 


Başlangıç yöntemi kuralları 

Yapılandırma ve ConfigureServices , form configure<EnvironmentName> ve 

configure< Environment Name »Services ortama özgü sürümlerini destekler. Bu yaklaşım, uygulama başına çok 
sayıda kod farklılığı olan birkaç ortam için başlangıç yapılandırması gerektirdiğinde yararlıdır. 






public class Startup 

{ 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

StartupConfigureServices(Services); 

} 

public void ConfigureStagingServices(IServiceCollection Services) 

{ 

StartupConfigureServices(Services); 

} 

private void StartupConfigureServices(IServiceCollection Services) 

{ 

Services. AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

if (env.IsProduction() || env.IsStaging() || env.IsEnvironment("Staging_2")) 

{ 

app.UseExceptionHandler("/Error"); 

} 

app.UseStaticFiles(); 

app.UseMvc(); 


public void ConfigureStaging(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (!env.IsStaging()) 

{ 

throw new Exception("Not staging."); 

} 

app.UseExceptionHandler("/Error"); 

app.UseStaticFiles(); 

app.UseMvc(); 

} 

} 


Ek kaynaklar 

• ASP.NET Core'de uygulama başlatma 

• ASP.NET Core yapılandırma 
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.NET Core, çeşitli yerleşik ve üçüncü taraf oturum açma sağlayıcılarıyla birlikte çalışarak bir günlüğe kaydetme API 
'sini destekler. Bu makalede, yerleşik sağlayıcılarla günlüğe kaydetme API 'sinin nasıl kullanılacağı gösterilmektedir. 

Bu makalede gösterilen kod örneklerinin çoğu AS P.N ET Core uygulamalardan oluşur. Bu kod parçacıklarının 
günlüğe kaydetmeye özgü bölümleri, genel ana bilgisayarı kuManan tüm .NET Core uygulamaları için geçerlidir. 
Genel konağın Web 'de olmayan uygulamalarda kullanımı hakkında bilgi için bkz. barındırılan hizmetler. 

Genel ana bilgisayarı olmayan uygulamalar için günlük kodu, sağlayıcıların Eklenme ve günlükçülerin 
oluşturulmabiçiminde farklılık gösterir. Ana bilgisayar olmayan kod örnekleri, makalenin bu bölümlerinde 
gösterilmiştir. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Sağlayıcı Ekle 

Günlük sağlayıcısı günlükleri görüntüler veya depolar.Örneğin, konsol sağlayıcısı günlükleri konsolunda görüntüler 
ve Azure Application Insights sağlayıcısı bunları Azure Application Insights depolar. Birden çok sağlayıcı eklenerek 
Günlükler birden çok hedefe gönderilebilir. 

Genel ana bilgisayar kullanan bir uygulamaya sağlayıcı eklemek için, program.es' de sağlayıcının 
Add{provider name} uzantısı metodunu çağırın: 

public static IHostBuilder CreateHostBuilder(string[] angs) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureLogging(logging => 

{ 

logging.ClearProviders(); 
logging.AddConsole(); 

}) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 

Konak olmayan bir konsol uygulamasında, bir LoggerFactory oluştururken sağlayıcının Add{provider name} uzantısı 
metodunu çağırın: 

var loggerFactory = LoggerFactory.Create(builder => 

{ 

builder 

.AddFilter("Microsoft ", LogLevel.Warning) 

.AddFilter("System", LogLevel .l/Jarning) 

.AddFilter("LoggingConsoleApp.Program ", LogLevel.Debug) 

.AddConsole() 

.AddEventLogO; 

}); 

ILogger logger = loggerFactory.CreateLogger<Program>(); 
logger.LogInformation("Example log message"); 


LoggerFactory ve AddConsole 


Microsoft.Extensions. Logging için uslng bir ifade gerektirir. 








Varsayılan ASP.NET Core proje şablonları, aşağıdaki günlük sağlayıcılarını ekleyen CreateDefaultBuilderçağırır 


• Console 

• Hata ayıklama 

• EventSource 

• Olay günlüğü (yalnızca VVİndovvs üzerinde çalışırken) 

Varsayılan sağlayıcıları kendi seçimlerinizle değiştirebilirsiniz. ClearProvidersçağırın ve istediğiniz sağlayıcıları 
ekleyin. 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureLogging(logging => 

{ 

logging.ClearProviders(); 
logging.AddConsole(); 

}) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 

Bir sağlayıcı eklemek için sağlayıcının Add{provider name} uzantısı yöntemini program.es içinde çağırın: 

public static void Main(string[] args) 

{ 

var webHost = new WebHostBuilder() 

.UseKestrel() 

.UseContentRoot(Directory.GetCurrentDirectory()) 

.ConfigureAppConfiguration((hostingContext , config) => 

{ 

var env = hostingContext.HostingEnvironment; 

config.AddlsonFile("appsettings.json", optional: true, reloadOnChange: true) 

.AddisonFile($"appsettings.{env.EnvironmentName}.json", 
optional: true, reloadOnChange: true); 
config.AddEnvironmentVariables(); 

}) 

.ConfigureLogging((hostingContext, logging) => 

{ 

// Requires 'using Microsoft.Extensions.Logging;' 

logging. AddConfiguration(hostingContext.Configuration.GetSection("Logging")); 

logging.AddConsole(); 

logging.AddDebug(); 

logging.AddEventSourceLogger(); 

}) 

.UseStartup<Startup>() 

.Build(); 

webHost.Run(); 

} 

Yukarıdaki kod Microsoft. Extensions. Logging ve Microsoft. Extensions .Configuration başvurulan gerektirir. 
Varsayılan proje şablonu, aşağıdaki günlük sağlayıcılarını ekleyen CreateDefaultBuilderçağırır: 

• Konsolu 

• Hata ayıklama 

• EventSource (ASP.NET Core 2,2 1 den başlayarak) 







public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build().Run(); 

} 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>(); 

createDefaultBuiider kullanıyorsanız, varsayılan sağlayıcıları kendi seçimlerinizle değiştirebilirsiniz. 
ClearProvidersçağırın ve istediğiniz sağlayıcıları ekleyin. 

public static void Main(string[] args) 

{ 

var hoşt = CreateWebHostBuilder(args).Build(); 

var todoRepository = hoşt.Services.GetRequiredService<ITodoRepository>(); 
todoRepository.Add(new Core.Model.TodoItem() { Name = "Feed the dog" }); 
todoRepository.Add(new Core.Model.TodoItem() { Name = "Walk the dog" }); 

var logger = hoşt.Services.GetRequiredService<ILogger<Program>>(); 
logger.LogInformation("Seeded the database."); 

host.Run(); 

} 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 

NebHost.CreateDefaultBuiider(args) 

.UseStartup<Startup>() 

.ConfigureLogging(logging => 

{ 

logging.ClearProviders(); 
logging.AddConsole(); 

}); 


Makalenin ilerleyen kısımlarında yerleşik günlük sağlayıcıları ve üçüncü taraf günlüğü sağlayıcıları hakkında daha 
fazla bilgi edinin. 

Günlükleri oluştur 

Günlükler oluşturmak için bir ILogger<TCategoryName> nesnesi kullanın. Bir Web uygulamasında veya 
barındırılan hizmette, bağımlılık ekleme (Dİ) iLogger alın. Konak dışı konsol uygulamalarında, bir iLogger 
oluşturmak için LoggerFactory kullanın. 

Aşağıdaki ASP.NET Core örnek kategori olarak TodoApiSample.Pages.AboutModei içeren bir günlükçü oluşturur. 
Günlük kategorisi, her günlük ile ilişkili bir dizedir. Dı tarafından belirtilen iLogger<T> örneği, kategori olarak t 
tam adı olan Günlükler oluşturur. 

public class AboutModel : PageModel 

{ 

private readonly ILogger _logger; 

public AboutModel(ILogger<AboutModel> logger) 

{ 

_logger = logger; 

} 

Aşağıdaki konak olmayan konsol uygulaması örneği, kategori olarak LoggingConsoleApp.Program olan bir günlükçü 
oluşturur. 










var loggerFactory = LoggerFactory.Create(builder => 

{ 

builder 

.AddFilter("Microsoft", LogLevel.Warning) 

.AddFilter("System", LogLevel.Warning) 

.AddFilter("LoggingConsoleApp.Program", LogLevel.Debug) 
.AddConsole() 

.AddEventLogO; 

}); 

ILogger logger = loggerFactory.CreateLogger<Program>(); 
logger.LogInformation("Example log message"); 


public class AboutModel : PageModel 

{ 

private readonly ILogger _logger; 

public AboutModel(ILogger<AboutModel> logger) 

{ 

_logger = logger; 

} 

Aşağıdaki AS P.N ET Core ve konsol uygulaması örneklerinde, günlükçü, düzeyi Information olan günlükleri 
oluşturmak için kullanılır. Günlük düzeyi günlüğe kaydedilen etkinliğin önem derecesini gösterir. 

public void OnGet() 

{ 

Message = $"About page visited at {DateTime.UtcNow.ToLongTimeString()}"; 

_logger.LogInformation("Message displayed: {Message}", Message); 

} 


var loggerFactory = LoggerFactory.Create(builder => 

{ 

builder 

.AddFilter("Microsoft", LogLevel.Warning) 

.AddFilter("System", LogLevel .l/Jarning) 

.AddFilter("LoggingConsoleApp.Program", LogLevel.Debug) 
.AddConsole() 

.AddEventLogO; 

}); 

ILogger logger = loggerFactory.CreateLogger<Program>(); 
logger.LogInformation("Example log message"); 


public void OnGet() 

{ 

Message = $"About page visited at {DateTime.UtcNow.ToLongTimeString()}"; 
_logger.LogInformation("Message displayed: {Message}", Message); 

} 


Düzeyler ve Kategoriler Bu makalenin ilerleyen kısımlarında daha ayrıntılı olarak açıklanmıştır. 

Program sınıfında Günlükler oluşturma 

ASP.NET Core uygulamasının Program sınıfında Günlükler yazmak için, konak oluşturulduktan sonra bir ILogger 
örneği alın: 







public static void Main(string[] args) 

{ 

var hoşt = CreateHostBuilder(args).Build(); 

var todoRepository = hoşt.Services.GetRequiredService<ITodoRepository>(); 
todoRepository.Add(new Core.Model.TodoItem() { Name = "Feed the dog" }); 
todoRepository.Add(new Core.Model.TodoItem() { Name = "Walk the dog" }); 

var logger = hoşt.Services.GetRequiredService<ILogger<Program>>(); 
logger.LogInformation("Seeded the database."); 

IMyService myService = hoşt.Services.GetRequiredService<IMyService>(); 
myService.WriteLog("Logged from MyService."); 

host.Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 


Ana bilgisayar oluşturma sırasında günlüğe kaydetme doğrudan desteklenmez. Ancak, ayrı bir günlükçü 
kullanılabilir. Aşağıdaki örnekte, createHostBuiider oturum açmak için bir Serilog günlükçü kullanılır. AddSerilog , 
Log. Logger belirtilen statik yapılandırmayı kullanır: 




using System; 

using Microsoft.AspNetCore.Hosting; 
using Microsoft.Extensions.DependencyInjection; 
using Microsoft.Extensions.Configuration; 
using Microsoft.Extensions.Hosting; 
using Microsoft.Extensions.Logging; 

public class Program 

{ 

public static void Main(string[] args) 

{ 

CreateHostBuilder(args).Build().Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) 

{ 

var builtConfig = new ConfigurationBuilder() 

. AddlsonFile("appsettings.json") 

.AddCommandLine(args) 

.Build(); 

Log.Logger = new LoggerConfiguration() 

.WriteTo.Console() 

.WriteTo.File(builtConfig["Logging:FilePath"]) 
.CreateLogger(); 

try 

{ 

return Hoşt.CreateDefaultBuilder(args) 

,ConfigureServices((contextj Services) => 

{ 

Services.AddRazorPages(); 

}) 

,ConfigureAppConfiguration((hostingContextj config) => 

{ 

config. AddConfigu rat ion( builtConfig); 

}) 

.ConfigureLogging(logging => 

{ 

logging.AddSerilog(); 

}) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 

} 

catch (Exception ex) 

{ 

Log.Fatal(ex, "Hoşt builder error"); 
throw; 

} 

finally 

{ 

Log.CloseAndFlush(); 

} 

} 

} 


Başlangıç sınıfında Günlükler oluşturma 

BirASP.NET Core uygulamasının startup.configure yönteminde Günlükler yazmak için, yöntem imzasına bir 
iLogger parametresi ekleyin: 








public void Configure(IApplicationBuilder app, IHostEnvironment env, ILogger<Startup> logger) 

{ 

if (env.IsDevelopment()) 

{ 

logger.LogInformation("In Development environment"); 
app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 
app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 

app.UseRouting(); 

app.UseEndpoints(endpoints = > 

{ 

endpoints.MapControllers(); 
endpoints.MapRazorPages(); 

}); 

} 

startup.configureServices yönteminde Dİ kapsayıcısı kurulumu tamamlanmadan önce Günlüklerin yazılması 
desteklenmez: 

• startup oluşturucusuna günlükçü ekleme desteklenmiyor. 

• Startup.configureServices yöntemi imzasına günlükçü ekleme desteklenmiyor 

Bu kısıtlamanın nedeni, günlük kaydının dı ve yapılandırmaya göre değişir ve bu da, ara ' ya bağlıdır. Dİ kapsayıcısı 
configureServices bitene kadar ayarlanamaz. 

Web ana bilgisayarı için ayrı bir dı kapsayıcısı oluşturulduğundan, bir günlükçü startup 1 ye Oluşturucu Ekleme 
ASP.NET Core önceki sürümlerinde çalışmaktadır. Genel ana bilgisayar için yalnızca bir kapsayıcı oluşturma 
hakkında daha fazla bilgi için bkz. Son değişiklik duyurusu. 

iLogger<T> bağımlı bir hizmet yapılandırmanız gerekiyorsa, bunu Oluşturucu ekleme veya bir fabrika yöntemi 
sağlayarak de yapabilirsiniz. Fabrika yöntemi yaklaşımı yalnızca başka bir seçenek yoksa önerilir.Örneğin, bir 
özelliği kaynağından bir hizmete doldurmanız gerektiğini varsayalım: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddControllers(); 

Services.AddRazorPages(); 

Services.AddSingleton<IMyService>((Container) => 

{ 

var logger = Container.GetRequiredService<ILogger<MyService>>(); 
return new MyService() { Logger = logger }; 

}); 

Services.AddSingleton<ITodoRepository, TodoRepository>(); 

} 

Önceki vurgulanan kod, Dİ kapsayıcısının bir MyService örneği oluşturmak için ilk kez çalışan bir Func . Kayıtlı 
hizmetlerden herhangi birine bu şekilde erişebilirsiniz. 


Başlangıçta günlük oluşturma 






startup sınıfında Günlükler yazmak için, Oluşturucu imzasına bir ILogger parametresi ekleyin: 


public class Startup 

{ 

private readonly ILogger _logger; 

public Startup(IConfiguration configuration, ILogger<Startup> logger) 

{ 

Configuration = configuration; 

_logger = logger; 

} 

public IConfiguration Configuration { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services .AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

// Add our repository type 

Services.AddSingleton<ITodoRepository, TodoRepository>(); 

_logger.LogInformation("Added TodoRepository to Services"); 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

_logger.LogInformation("In Development environment"); 
app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 
app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 
app.UseCookiePolicy(); 

app.UseMvc(); 

} 

} 


Program sınıfında Günlükler oluşturma 

Program sınıfında Günlükler yazmak için, Dİ'den bir ILogger örneği alın: 





public static void Main(string[] args) 

{ 

var hoşt = CreateWebHostBuilder(args).Build(); 

var todoRepository = hoşt.Services.GetRequiredService<ITodoRepository>(); 
todoRepository.Add(new Core.Model.TodoItem() { Name = "Feed the dog" }); 
todoRepository.Add(new Core.Model.TodoItem() { Name = "Walk the dog" }); 

var logger = hoşt.Services.GetRequiredService<ILogger<Program>>(); 
logger.LogInformation("Seeded the database."); 

host.Run(); 

} 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.ConfigureLogging(logging => 

{ 

logging.ClearProviders(); 
logging.AddConsole(); 

}); 


Ana bilgisayar oluşturma sırasında günlüğe kaydetme doğrudan desteklenmez. Ancak, ayrı bir günlükçü 
kullanılabilir. Aşağıdaki örnekte, createwebHostBuiider oturum açmak için bir Serilog günlükçü kullanılır. AddSerilog 
, Log. Logger belirtilen statik yapılandırmayı kullanır: 









using System; 

using Microsoft.AspNetCore; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.Extensions.Dependencylnjection; 

using Microsoft.Extensions.Configuration; 

using Microsoft.Extensions.Logging; 

public class Program 

{ 

public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args) .Build().Run(); 

} 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) 

{ 

var builtConfig = new ConfigurationBuilder() 

. AddlsonFile("appsettings.json") 

.AddCommandLine(args) 

.Build(); 

Log.Logger = new LoggerConfiguration() 

.WriteTo.Console() 

.WriteTo.File(builtConfig["Logging:FilePath"]) 
.CreateLogger(); 

try 

{ 

return WebHost.CreateDefaultBuilder(args) 

,ConfigureServices((contextj Services) => 

{ 

Services.AddMvc(); 

}) 

,ConfigureAppConfiguration((hostingContextj config) => 

{ 

config. AddConfigu rat ion( builtConfig); 

}) 

.ConfigureLogging(logging => 

{ 

logging.AddSerilog(); 

}) 

.UseStartup<Startup>(); 

} 

catch (Exception ex) 

{ 

Log.Fatal(ex, "Hoşt builder error"); 
throw; 

} 

finally 

{ 

Log.CloseAndFlush(); 

} 

} 

} 


Zaman uyumsuz günlükçü yöntemi yok 

Günlüğe kaydetme, zaman uyumsuz kodun performans maliyetine değer olmaması kadar hızlı olmalıdır.Günlüğe 
kaydetme veri depoluizin yavaşsa, doğrudan buna yazmayın. Başlangıç olarak günlük iletilerini hızlı bir mağazaya 
yazmayı ve sonra yavaş depoya daha sonra taşımayı düşünün. Örneğin, SQL Server için günlük kaydı yapıyorsanız, 
Log Yöntemler zaman uyumlu olduğundan bunu doğrudan bir Log yönteminde yapmak istemezsiniz. Bunun 
yerine, günlük iletilerini bir bellek içi kuyruğa eşzamanlı olarak ekleyin ve bir arka plan çalışanı, SQL Server veri 
gönderme zaman uyumsuz çalışmasını sağlamak için iletileri kuyruktan çekin. Daha fazla bilgi için Bu GitHub 
sorununa bakın. 









Yapılandırma 

Günlüğe kaydetme sağlayıcısı yapılandırması bir veya daha fazla yapılandırma sağlayıcısı tarafından sağlanır: 

• Dosya biçimleri (ıNı, JSON ve XML). 

• Komut satırı bağımsız değişkenleri. 

• Ortam değişkenleri. 

• Bellek içi .NET nesneleri. 

• Şifrelenmemiş gizli dizi Yöneticisi depolaması. 

• Azure Key Vaultgibi şifreli bir kullanıcı deposu. 

• Özel sağlayıcılar (yüklü veya oluşturulmuş). 

Örneğin, günlük yapılandırma genellikle uygulama ayarları dosyalarının Logging bölümü tarafından sağlanır. 
Aşağıdaki örnek tipik bir appSettings 'in içeriğini gösterir. Developmerıt. JSON dosyası: 

{ 

"Logging": { 

"LogLevel": { 

"Default": "Debug", 

"System": "Information", 

"Microsoft": "Information" 

}, 

"Console": 

{ 

"IncludeScopes": true 

} 

} 

} 


Logging 

özelliği 

LogLevel 

ve günlük sağlayıcısı özelliklerine sahip olabilir (konsol gösterilir). 

Logging 

altındaki 

LogLevel 

özelliği, Seçili kategoriler için günlüğe kaydedilecek minimum düzeyi belirtir. Örnekte, 


System ve Microsoft kategorileri Information düzeyinde günlüğe kaydedilir ve diğerleri Debug düzeyinde 
günlüğe kaydedilir. 

Logging altındaki diğer özellikler günlük sağlayıcılarını belirtir. Örnek, konsol sağlayıcısına yöneliktir. Bir sağlayıcı, 
günlük kapsamlarınıdestekliyorsa IncludeScopes etkinleştirilip etkinleştirilmeyeceğini gösterir. Bir sağlayıcı özelliği 
(örneğin console gibi), bir LogLevel özelliği de belirtebilir, sağlayıcı altında LogLevel , bu sağlayıcının günlüğe 
kaydedilecek düzeyleri belirtir. 

Logging.{providername}.LogLevel düzeyler belirtilirse, Logging.LogLevel ayarlanan her şeyi geçersiz kılar. 

Günlüğe kaydetme API 'SI, bir uygulama çalışırken günlük düzeylerini değiştirme senaryosu içermez. Ancak, bazı 
yapılandırma sağlayıcıları yapılandırmayı yeniden yükleme yeteneğine sahiptir ve bu, günlüğe kaydetme 
yapılandırması üzerinde etkili bir şekilde gerçekleşir. Örneğin, ayar dosyalarını okumak için createDefauitBuiider 
tarafından eklenen dosya yapılandırma sağlayıcısı, varsayılan olarak günlük yapılandırmasını yeniden yükler. 
Uygulama çalışırken kodda yapılandırma değiştirilirse uygulama, uygulamanın günlük yapılandırmasını 
güncelleştirmek için IController. Reload ' i çağırabilir. 

Yapılandırma sağlayıcılarını uygulama hakkında daha fazla bilgi için bkz. ASP.NET Core yapılandırma. 

Örnek günlüğe kaydetme çıkışı 

Yukarıdaki bölümde gösterilen örnek kodla, uygulama komut satırından çalıştırıldığında Günlükler konsolunda 
görüntülenir. Konsol çıkışının bir örneği aşağıda verilmiştir: 















info: Microsoft.AspNetCore.Hosting.Diagnostics[1] 

Request starting HTTP/1.1 GET http://localhost:5000/api/todo/0 
info: Microsoft .AspNetCore. Hosting. Diagnostics [2] 

Request finished in 84.26180000000001ms 307 
info: Microsoft.AspNetCore.Hosting.Diagnostics[1] 

Request starting HTTP/2 GET https://localhost:5001/api/todo/0 
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[0] 

Executing endpoint 'TodoApiSample.Controllers.TodoController.GetByld (TodoApiSample)' 
info: Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionInvoker[3] 

Route matched with {action = "GetByld", controller = "Todo", page = Executing controller action with 

signature Microsoft.AspNetCore.Mvc.IActionResult GetByld(System.String) on controller 
TodoApiSample.Controllers.TodoController (TodoApiSample). 
info: TodoApiSample.Controllers.TodoController[1002] 

Getting item 0 

warn: TodoApiSample.Controllers.TodoController[4000] 

GetById(0) NOT FOUND 

info: Microsoft.AspNetCore.Mvc.StatusCodeResult[1] 

Executing HttpStatusCodeResult, setting HTTP status code 404 


info: Microsoft.AspNetCore.Hosting.Internal.WebHost[l] 

Request starting HTTP/1.1 GET http://localhost:5000/api/todo/0 
info: Microsoft.AspNetCore.Mvc.Internal.ControllerActionInvol<er[l] 

Executing action method TodoApi.Controllers.TodoController.GetByld (TodoApi) with arguments (0) - 
ModelState is Valid 

info: TodoApi. Cont rollers .TodoCont roller [1002] 

Getting item 0 

warn: TodoApi.Controllers.TodoController[4000] 

GetById(0) NOT FOUND 

info: Microsoft.AspNetCore.Mvc.StatusCodeResult[1] 

Executing HttpStatusCodeResult, setting HTTP status code 404 
info: Microsoft.AspNetCore.Mvc.Internal.ControllerActionInvoker[2] 

Executed action TodoApi.Controllers.TodoController.GetByld (TodoApi) in 42.9286ms 
info: Microsoft.AspNetCore.Hosting.Internal.WebHost[2] 

Request finished in 148.889ms 404 


Yukarıdaki Günlükler, http://localhost:5000/api/todo/@ konumundaki örnek uygulamaya HTTP GET isteği 
yapılarak oluşturulmuştur. 

Visual Studio 'da örnek uygulamayı çalıştırdığınızda hata ayıklama penceresinde göründükleri günlüklere yönelik 
bir örnek aşağıda verilmiştir: 

Microsoft.AspNetCore.Hosting.Diagnostics: Information: Request starting HTTP/2.0 GET 
https://localhost:44328/api/todo/0 

Microsoft.AspNetCore.Routing.EndpointMiddleware: Information: Executing endpoint 
'TodoApiSample.Controllers.TodoController.GetByld (TodoApiSample)' 

Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionlnvoker: Information: Route matched with {action = 
"GetByld", controller = "Todo", page = ""}. Executing controller action with signature 
Microsoft.AspNetCore.Mvc.IActionResult GetByld(System.String) on controller 
TodoApiSample.Controllers.TodoController (TodoApiSample). 

TodoApiSample.Controllers.TodoController: Information: Getting item 0 
TodoApiSample.Controllers.TodoController: l/Jarning: GetById(0) NOT FOUND 

Microsoft.AspNetCore.Mvc.StatusCodeResult: Information: Executing HttpStatusCodeResult, setting HTTP status 
code 404 

Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionlnvoker: Information: Executed action 
TodoApiSample.Controllers.TodoController.GetByld (TodoApiSample) in 34.167ms 
Microsoft.AspNetCore.Routing.EndpointMiddleware: Information: Executed endpoint 
'TodoApiSample.Controllers.TodoController.GetByld (TodoApiSample)' 

Microsoft.AspNetCore.Hosting.Diagnostics: Information: Request finished in 98.41300000000001ms 404 

Yukarıdaki bölümde gösterilen nogger çağrıları tarafından oluşturulan Günlükler "TodoApiSample" ile başlar. 
"Microsoft" kategorileri ile başlayan Günlükler ASP.NET Core Framevvork kodundan alimr.ASP.NET Core ve 






uygulama kodu aynı günlük API 'sini ve sağlayıcılarını kullanıyor. 


Microsoft.AspNetCore.Hosting.Internal.WebHost:Information: Request starting HTTP/1.1 GET 
http://localhost:53104/api/todo/0 

Microsoft.AspNetCore.Mvc.Internal.ControllerActionInvoker:Information: Executing action method 
TodoApi.Controllers.TodoController.GetByld (TodoApi) with arguments (0) - ModelState is Valid 
TodoApi.Controllers.TodoController:Information: Getting item 0 
TodoApi.Controllers.TodoController:Warning: GetById(0) NOT FOUND 

Microsoft.AspNetCore.Mvc.StatusCodeResult:Information: Executing HttpStatusCodeResult, setting HTTP status code 
404 

Microsoft.AspNetCore.Mvc.Internal.ControllerActionlnvoker:Information: Executed action 
TodoApi.Controllers.TodoController.GetByld (TodoApi) in 152.5657ms 

Microsoft .AspNetCore. Hosting. Internal.İAİebHost: Information: Request finished in 316.3195ms 404 

Yukarıdaki bölümde gösterilen nogger çağrıları tarafından oluşturulan Günlükler "TodoApi" ile başlar."Microsoft" 
kategorileri ile başlayan Günlükler ASP.N ET Core Framevvork kodundan alınır. ASP.NET Core ve uygulama kodu 
aynı günlük API 'sini ve sağlayıcılarını kullanıyor. 

Bu makalenin geri kalanında günlüğe kaydetme için bazı ayrıntılar ve seçenekler açıklanmaktadır. 

NuGet paketleri 

nogger ve noggerFactory arabirimleri Microsoft. Extensions. Logging. soyutlamalarve bunların varsayılan 
uygulamaları Microsoft. Extensions. Logging' dir. 

Günlük kategorisi 

Hogger bir nesne oluşturulduğunda, için bir Kategori belirtilir. Bu kategori, bu nogger örneği tarafından 
oluşturulan her günlük iletisine dahildir. Kategori herhangi bir dize olabilir, ancak kural, "TodoApi. Controllers. 
TodoController" gibi sınıf adını kullanmaktır. 

Kategori olarak t tam nitelikli tür adını kullanan bir nogger örneğini almak için nogger<T> kullanın: 

public class TodoController : Controller 

{ 

private readonly ITodoRepository _todoRepository; 
private readonly ILogger _logger; 

public TodoController(ITodoRepository todoRepository, 

ILogger<TodoController> logger) 

{ 

_todoRepository = todoRepository; 

_logger = logger; 

} 


public class TodoController : Controller 

{ 

private readonly ITodoRepository _todoRepository; 
private readonly ILogger _logger; 

public TodoController(ITodoRepository todoRepository, 
ILogger<TodoController> logger) 

{ 

_todoRepository = todoRepository; 

_logger = logger; 

} 


Kategoriyi açıkça belirtmek için iLoggerFactory.createLogger çağırın: 











public class TodoController : Controller 

{ 

private readonly ITodoRepository _todoRepository; 
private readonly ILogger _logger; 

public TodoController(ITodoRepository todoRepository, 

ILoggerFactory logger) 

{ 

_todoRepository = todoRepository; 

_logger = logger.CreateLogger("TodoApiSample.Controllers.TodoController"); 

} 


public class TodoController : Controller 

{ 

private readonly ITodoRepository _todoRepository; 
private readonly ILogger _logger; 

public TodoController(ITodoRepository todoRepository, 

ILoggerFactory logger) 

{ 

_todoRepository = todoRepository; 

_logger = logger. CreateLogger("TodoApiSample. Controllers .TodoController"); 

} 

iLogger<T> , t tam nitelikli tür adıyla CreateLogger çağırma ile eşdeğerdir. 

Günlük düzeyi 

Her günlük bir LogLevel değerini belirtir. Günlük düzeyi önem derecesini veya önemini gösterir.Örneğin, bir 
yöntem normal olarak sona erdiğinde bir Information günlüğü ve bir yöntem 404 bulunmayan bir durum kodu 
döndürdüğünde bir uarning günlüğü yazabilirsiniz. 

Aşağıdaki kod Information ve warning günlüklerini oluşturur: 

public IActionResult GetById(string id) 

{ 

_logger.LogInformation(LoggingEvents.GetItem, "Getting item {Id}", id); 
var item = _todoRepository.Find(id); 
if (item == null) 

{ 

_logger.LogWarning(LoggingEvents.GetItemNotFound, "GetById({Id}) NOT FOUNO", id); 
return NotFound(); 

} 

return new ObjectResult(item); 

} 


public IActionResult GetById(string id) 

{ 

_logger.LogInformation(LoggingEvents.GetItem, "Getting item {Id}", id); 
var item = _todoRepository.Find(id); 
if (item == null) 

{ 

_logger.LogWarning(LoggingEvents.GetItemNotFound, "GetById({Id}) NOT FOUND", id); 
return NotFound(); 

} 

return new ObjectResult(item); 

} 


Önceki kodda, ilk parametredir oturum öğesini belirten Olay No. ikinci parametre, kalan Yöntem parametreleri 








tarafından belirtilen bağımsız değişken değerleri için yer tutucuları olan bir ileti şablonudur. Yöntem parametreleri 
bu makalenin ilerleyen kısımlarında bulunan ileti şablonu bölümünde açıklanmaktadır. 

Yöntem adındaki düzeyi (örneğin, Loginformation ve Loguarning ) içeren günlük yöntemleri, ILogger için uzantı 
yöntemleridir. Bu yöntemler bir LogLevel parametresi alan Log yöntemini çağırır. Bu uzantı yöntemlerinden biri 
yerine doğrudan Log yöntemi çağırabilirsiniz, ancak söz dizimi görece karmaşıktır. Daha fazla bilgi için bkz. 

ILogger ve günlükçü uzantıları kaynak kodu. 

ASP.NET Core, en küçükten en yüksek öneme doğru sıralanan aşağıdaki günlük düzeylerini tanımlar. 

• izleme = 0 

Genellikle yalnızca hata ayıklama için değerli bilgiler için. Bu iletiler hassas uygulama verileri içerebilir, bu 
nedenle bir üretim ortamında etkinleştiriImemelidir. Varsayılan olarak devre dışıdır. 

• Hata Ayıkla = 1 

Geliştirme ve hata ayıklama konusunda yararlı olabilecek bilgiler için. Örnek: 

Entering method configure with flag set to true. en yüksek günlük hacimden dolayı yalnızca sorun 
giderirken Debug düzeyi günlüklerini etkinleştirin. 

• Bilgi = 2 

Uygulamanın genel akışını izlemek için. Bu günlüklerde genellikle uzun süreli bir değer vardır.Örnek: 

Request received for path /api/todo 

• Uyarı = 3 

Uygulama akışında anormal veya beklenmedik olaylar için. Bunlar, uygulamanın durmasına neden olmayan 
ancak araştırılması gerekebilecek hataları veya diğer koşulları içerebilir, işlenmiş özel durumlar warning 
günlük düzeyini kullanmak için yaygın bir yerdir. Örnek: FiieNotFoundException for file quotes.txt. 

• Hata = 4 

İşlenemeyen hatalar ve özel durumlar için. Bu iletiler, uygulama genelinde bir hata değil geçerli etkinlikte 
veya işlemde (geçerli HTTP isteği gibi) bir hata olduğunu gösterir. Örnek günlük iletisi: 

Cannot insert record due to duplicate key violation. 

• Kritik = 5 

Anında ilgilenilmesi gereken hatalarda. Örnekler: veri kaybı senaryoları, disk alanı yetersiz. 

Belirli bir depolama ortamında veya görüntüleme penceresinde ne kadar günlük çıkışının yazıldığını denetlemek 
için günlük düzeyini kullanın. Örneğin: 

• Üretimde: 

o Trace Information düzeylerinde günlüğe kaydetme, yüksek hacimli ayrıntılı günlük iletileri oluşturur. 
Maliyetleri denetlemek ve veri depolama sınırlarını aşmamak için, Information düzey iletileri kullanarak 
Trace yüksek hacimli, düşük maliyetli bir veri deposuna günlüğe kaydedin, 
o ifliarning Criticai düzeyler aracılığıyla günlüğe kaydetme işlemi genellikle daha az, daha küçük günlük 
iletileri üretir. Bu nedenle, maliyetler ve depolama sınırları genellikle bir sorun değildir ve bu da veri 
deposu seçiminden daha fazla esneklik elde etmez. 

• Geliştirme sırasında: 

o Konsola Criticai iletileri aracılığıyla warning . 
o Sorun giderirken Information iletileri aracılığıyla Trace ekleyin. 

Bu makalede daha sonra bulunan günlük filtreleme bölümünde, bir sağlayıcının hangi günlük düzeylerinin işlediği 
nasıl denetleneceği açıklanmaktadır. 

















AS P.N ET Core çerçeve olayları için günlükleri yazar. Bu makalede daha önce gelen günlük örnekleri Information 
düzeyin altında tutulur, dolayısıyla hiçbir Debug veya Trace düzeyi günlüğü oluşturulmaz. Aşağıda, Debug 
günlüklerini göstermek için yapılandırılmış örnek uygulama çalıştırılarak oluşturulan konsol günlüklerinin bir 
örneği verilmiştir: 


info: Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionlnvoker[3] 

Route matched with {action = "GetByld", controller = "Todo", page = Executing controller action with 

signature Microsoft.AspNetCore.Mvc.IActionResult GetByld(System.String) on controller 
TodoApiSample.Controllers.TodoController (TodoApiSample). 
dbug: Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionInvoker[l] 

Execution plan of authorization filters (in the following order): None 
dbug: Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionInvoker[l] 

Execution plan of resource filters (in the following order): 

Microsoft.AspNetCore.Mvc.ViewFeatures.Filters.SaveTempDataFilter 
dbug: Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionInvoker[l] 

Execution plan of action filters (in the following order): 

Microsoft.AspNetCore.Mvc.Filters.ControllerActionFilter (Order: -2147483648 ), 

Microsoft.AspNetCore.Mvc.ModelBinding.UnsupportedContentTypeFilter (Order: -3000) 
dbug: Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionInvoker[l] 

Execution plan of exception filters (in the following order): None 
dbug: Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionInvoker[l] 

Execution plan of result filters (in the following order): 

Microsoft.AspNetCore.Mvc.ViewFeatures.Filters.SaveTempDataFilter 
dbug: Microsoft.AspNetCore.Mvc.ModelBinding.ParameterBinder[22] 

Attempting to bind parameter 'id' of type 'System.String' ... 
dbug: Microsoft.AspNetCore.Mvc.ModelBinding.Binders.SimpleTypeModelBinder[44] 

Attempting to bind parameter 'id' of type 'System.String' using the name 'id' in request data ... 
dbug: Microsoft.AspNetCore.Mvc.ModelBinding.Binders.SimpleTypeModelBinder[45] 

Done attempting to bind parameter 'id' of type 'System.String'. 
dbug: Microsoft.AspNetCore.Mvc.ModelBinding.ParameterBinder[23] 

Done attempting to bind parameter 'id' of type 'System.String'. 
dbug: Microsoft.AspNetCore.Mvc.ModelBinding.ParameterBinder[26] 

Attempting to validate the bound parameter 'id' of type 'System.String' ... 
dbug: Microsoft.AspNetCore.Mvc.ModelBinding.ParameterBinder[27] 

Done attempting to validate the bound parameter 'id' of type 'System.String'. 
info: TodoApiSample.Controllers.TodoController[1002] 

Getting item 0 

warn: TodoApiSample.Controllers.TodoController[4000] 

GetById(0) NOT FOUND 

info: Microsoft.AspNetCore.Mvc.StatusCodeResult[1] 

Executing HttpStatusCodeResult , setting FITTP status code 404 
info: Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionInvoker[2] 

Executed action TodoApiSample.Controllers.TodoController.GetByld (TodoApiSample) in 32.690400000000004ms 
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[l] 

Executed endpoint 'TodoApiSample.Controllers.TodoController.GetByld (TodoApiSample)' 
info: Microsoft .AspNetCore. Hosting. Diagnostics [2] 

Request finished in 176.9103ms 404 





info: Microsoft.AspNetCore.Hosting.Internal.WebHost[l] 

Request starting HTTP/1.1 GET http://localhost:62555/api/todo/0 
dbug: Microsoft.AspNetCore.Routing.Tree.TreeRouterfl] 

Request successfully matched the route with name 'GetTodo' and template 'api/Todo/{id}'. 
dbug: Microsoft.AspNetCore.Mvc.Internal.ActionSelector[2] 

Action 'TodoApi.Controllers.TodoController.Update (TodoApi)' with id '089d59b6-92ec-472d-b552- 
cc61Bdfd625d' did not match the constraint 'Microsoft.AspNetCore.Mvc.Internal.HttpMethodActionConstraint' 
dbug: Microsoft.AspNetCore.Mvc.Internal.ActionSelector[2] 

Action 'TodoApi.Controllers.TodoController.Delete (TodoApi)' with id 'f3476abe-4bd9-4ad3-9261- 
3ead09607366' did not match the constraint 'Microsoft.AspNetCore.Mvc.Internal.HttpMethodActionConstraint' 
dbug: Microsoft.AspNetCore.Mvc.Internal.ControllerActionInvol<er[l] 

Executing action TodoApi.Controllers.TodoController.GetByld (TodoApi) 
info: Microsoft.AspNetCore.Mvc.Internal.ControllerActionInvoker[l] 

Executing action method TodoApi.Controllers.TodoController.GetByld (TodoApi) with arguments (0) - 
ModelState is Valid 

info: TodoApi.Controllers.TodoController[1002] 

Getting item 0 

warn: TodoApi.Controllers.TodoController[4000] 

GetById(0) NOT FOUND 

dbug: Microsoft.AspNetCore.Mvc.Internal.ControllerActionInvoker[2] 

Executed action method TodoApi.Controllers.TodoController.GetByld (TodoApi), returned result 
Microsoft.AspNetCore.Mvc.NotFoundResult. 
info: Microsoft.AspNetCore.Mvc.StatusCodeResult[1] 

Executing HttpStatusCodeResult, setting HTTP status code 404 
info: Microsoft.AspNetCore.Mvc.Internal.ControllerActionInvoker[2] 

Executed action TodoApi.Controllers.TodoController.GetByld (TodoApi) in 0.8788ms 
dbug: Microsoft.AspNetCore.Server.Kestrel[9] 

Connection id "0HL6L7NEFF2QD" completed keep alive response. 
info: Microsoft.AspNetCore.Hosting.Internal.WebHost[2] 

Request finished in 2.7286ms 404 


Günlüğe olay KİMLİĞİ 

Her günlük belirtebilirsiniz bir öğesini beiirten Olay No. Örnek uygulama bunu yerel olarak tanımlanmış bir 
LoggingEvents sınıfını kullanarak yapar: 

public IActionResult GetById(string id) 

{ 

_logger.LogInformation(LoggingEvents.GetItem, "Getting item {Id}", id); 
var item = _todoRepository.Find(id); 
if (item == null) 

{ 

_logger.LogWarning(LoggingEvents.GetltemNotFound, "GetById({Id}) NOT FOUND", id); 
return NotFound(); 

} 

return new ObjectResult(item); 

} 


public class LoggingEvents 

{ 

public const int Generateltems = 1000; 
public const int Listltems = 1001; 
public const int Getltem = 1002; 
public const int Insertltem = 1003; 
public const int Updateltem = 1004; 
public const int Deleteltem = 1005; 

public const int GetltemNotFound = 4000; 
public const int UpdateltemNotFound = 4001; 

} 




public IActionResult GetById(string id) 

{ 

_logger.LogInformation(LoggingEvents.Getltem, "Getting item {Id}", id); 
var item = _todoRepository.Find(id); 
if (item == null) 

{ 

_logger.LogWarning(LoggingEvents.GetItemNotFound, "GetById({Id}) NOT FOUND", id); 
return NotFound(); 

} 

return new ObjectResult(item); 

} 


public class LoggingEvents 

{ 

public const int Generateltems = 1000; 
public const int Listltems = 1001; 
public const int Getltem = 1002; 
public const int Insertltem = 1003; 
public const int Updateltem = 1004; 
public const int Deleteltem = 1005; 

public const int GetltemNotFound = 4000; 
public const int UpdateltemNotFound = 4001; 

} 

Olay KİMLİĞİ bir olay kümesini ilişkilendirir.Örneğin, bir sayfadaki öğelerin listesini görüntülemek için ilgili tüm 
Günlükler 1001 olabilir. 

Günlüğe kaydetme sağlayıcısı, olay KİMLİĞİNİ günlüğe kaydetme iletisindeki kimlik alanında veya hiç değil, bir 
kimlik alanında saklayabilir. Hata ayıklama sağlayıcısı olay kimliklerini göstermiyor.Konsol sağlayıcısı, etkinlik 
kimliklerini kategoriden sonra parantez içinde gösterir: 

info: TodoApi.Controllers.TodoController[1002] 

Getting item invalidid 

warn: TodoApi.Controllers.TodoController[4000] 

GetById(invalidid) NOT FOUND 


Günlük iletisi şablonu 

Her günlük bir ileti şablonunu belirtir. İleti şablonu, bağımsız değişkenlerin sağlandığı yer tutucuları içerebilir. 
Sayılar değil, yer tutucular için adları kullanın. 

public IActionResult GetById(string id) 

{ 

_logger. LogInformation(LoggingEvents.Getltem., "Getting item {Id}", id); 
var item = _todoRepository.Find(id); 
if (item == null) 

{ 

_logger.LogWarning(LoggingEvents.GetltemNotFound, "GetById({Id}) NOT FOUND", id); 
return NotFound(); 

} 

return new ObjectResult(item); 

} 





public IActionResult GetById(string id) 

{ 

_logger.LogInformation(LoggingEvents.GetItem, "Getting item {Id}", id); 
var item = _todoRepository.Find(id); 
if (item == null) 

{ 

_logger.LogWarning(LoggingEvents.GetItemNotFound, "GetById({Id}) NOT FOUND", id); 
return NotFound(); 

} 

return new ObjectResult(item); 

} 


Adlarının, değerlerinin sağlanması için hangi parametrelerin kullanılacağını belirleyen yer tutucular sırası. Aşağıdaki 
kodda, parametre adlarının ileti şablonunda sıra dışı olduğuna dikkat edin: 

string pl = "parml"; 
string p2 = "parm2"; 

_logger.LogInformation("Parameter values: {p2}, {pl}", pl, p2); 


Bu kod, sırasıyla parametre değerleriyle bir günlük iletisi oluşturur: 

Parameter values: parml, parm2 


Günlüğe kaydetme altyapısı bu şekilde çalışarak, günlük sağlayıcılarının yapılandırılmış günlüğe yazma olarak da 
bilinen anlamsal günlüğüuygulayabilmesini sağlayabilir. Bağımsız değişkenler yalnızca biçimli ileti şablonuna değil, 
günlük sistemine geçirilir. Bu bilgiler, günlük sağlayıcılarının parametre değerlerini alan olarak depolamasına olanak 
sağlar. Örneğin, günlükçü yönteminin şuna benzer şekilde göründüğünü varsayın: 

_logger.LogInformation("Getting item {Id} at {RequestTime}", id, DateTime.Now); 

Günlükleri Azure Tablo depolama alanına gönderiyorsanız, her bir Azure Tablo varlığı id ve RequestTime 
özelliklerine sahip olabilir. Bu, günlük verilerinde sorguları basitleştirir. Bir sorgu, belirli bir RequestTime aralığındaki 
tüm günlükleri, metin iletisinden zaman aşımına uğratmadan bulabilir. 

Günlüğe kaydetme özel durumları 

Günlükçü yöntemlerinin, aşağıdaki örnekte olduğu gibi bir özel durum iletmenizi sağlayan aşırı yüklemeleri vardır: 

catch (Exception ex) 

{ 

_logger.LogWarning(LoggingEvents.GetItemNotFound, ex, "GetById({Id}) NOT FOUND", id); 
return NotFound(); 

} 

return new ObjectResult(item); 


catch (Exception ex) 

{ 

_logger.LogWarning(LoggingEvents.GetItemNotFound, ex, "GetById({Id}) NOT FOUND", id); 
return NotFound(); 

} 

return new ObjectResult(item); 

Özel durum bilgileri farklı yollarla farklı sağlayıcılarda işler. Yukarıda gösterilen koddan hata ayıklama sağlayıcısı 
çıktısına bir örnek aşağıda verilmiştir. 











TodoApiSample.Controllers.TodoController: l/Jarning: GetById(55) NOT FOUND 

System.Exception: Item not found exception. 

at TodoApiSample.Controllers.TodoController.GetById(String id) in 
C: \TodoApiSample\Cont rollers\TodoController.cs:line 226 


Günlük filtreleme 

Belirli bir sağlayıcı ve kategori için en az bir günlük düzeyi veya tüm sağlayıcılar ya da tüm kategoriler için 
belirtebilirsiniz. Minimum düzeyin altındaki tüm Günlükler bu sağlayıcıya aktarılmaz, bu nedenle görüntülenmez 
veya depolanmaz. 

Tüm günlükleri gizlemek için en düşük günlük düzeyi olarak LogLevel.None belirtin. LogLevel.None tamsayı değeri 
6'dır ve LogLevel.critieal (5) daha yüksektir. 

Yapılandırmada filtre kuralları oluşturma 

Proje şablonu kodu, konsol, hata ayıklama ve EventSource (ASP.NET Core 2,2 veya üzeri) sağlayıcılar için günlük 
kaydı ayarlamak üzere createDefaultBuiider çağırır. createDefaultBulider yöntemi, Bu makalenin önceki 
kısımlarındaaçıklandığı gibi, Logging bir bölümünde yapılandırma aramak için günlüğe kaydetmeyi ayarlar. 

Yapılandırma verileri aşağıdaki örnekte olduğu gibi sağlayıcıya ve kategoriye göre en düşük günlük düzeylerini 
belirtir: 

{ 

"Logging": { 

"Debug": { 

"LogLevel": { 

"Default": "Information" 

} 

L 

"Console": { 

"IncludeScopes": false, 

"LogLevel": { 

"Microsoft.AspNetCore.Mvc.Razor.Internal": "Uarning", 

"Microsoft.AspNetCore.Mvc.Razor.Razor": "Debug", 

"Microsoft.AspNetCore.Mvc.Razor": "Error", 

"Default": "Information" 

} 

L 

"LogLevel": { 

"Default": "Debug" 

} 

} 

} 









{ 

"Logging": { 

"Debug": { 

"LogLevel": { 

"Default": "Information" 

} 

}, 

"Console": { 

"IncludeScopes": false, 

"LogLevel": { 

"Microsoft.AspNetCore.Mvc.Razor.Internal": "Warning ", 
"Microsoft.AspNetCore.Mvc.Razor.Razor": "Debug ", 
"Microsoft.AspNetCore.Mvc.Razor": "Error", 

"Default": "Information" 

} 

}, 

"LogLevel": { 

"Default": "Debug" 

} 

} 

} 


Bu JSON altı filtre kuralı oluşturur: biri hata ayıklama sağlayıcısı, konsol sağlayıcısı için dört ve diğeri tüm 
sağlayıcılar için. iLogger bir nesne oluşturulduğunda her sağlayıcı için tek bir kural seçilir. 

Koddaki filtre kuralları 

Aşağıdaki örnek, koddaki filtre kurallarının nasıl kaydedileceği gösterilmektedir: 

.ConfigureLogging(logging => 

logging.AddFilter("System ", LogLevel.Debug) 

.AddFilter<DebugLoggerProvider>("Microsoft ", LogLevel.Trace)) 


WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.ConfigureLogging(logging => 

logging.AddFilter("System ", LogLevel.Debug) 

.AddFilter<DebugLoggerProvider>("Microsoft ", LogLevel.Trace)); 

ikinci AddFilter , tür adını kullanarak hata ayıklama sağlayıcısını belirtir, ilk AddFilter bir sağlayıcı türü 
belirtmediğinden, tüm sağlayıcılar için geçerlidir. 

Filtreleme kuralları nasıl uygulanır 

Yapılandırma verileri ve önceki örneklerde gösterilen AddFilter kodu, aşağıdaki tabloda gösterilen kuralları 
oluşturur, ilk altı yapılandırma örneğinde ve son iki ise kod örneğinde gelir. 


SAYI 

SAĞLAYICI 

ŞUNUNLA BAŞLAYAN 
KATEGORİLER... 

EN DÜŞÜK GÜNLÜK DÜZEYİ 

1 . 

Hata ayıklama 

Tüm kategoriler 

Bilgisi 

2 

Konsolu 

M icrosoft.AspNetCore. M vc. R 
azor.lnternal 

Uyarı 

3 

Konsolu 

M İcrosoft.AspNetCore. Mvc. R 
azor. Razor 

Hata ayıklama 








SAYI 

SAĞLAYICI 

ŞUNUNLA BAŞLAYAN 
KATEGORİLER... 

EN DÜŞÜK GÜNLÜK DÜZEYİ 

4 

Konsolu 

M icrosoft. AspNetCore. Mvc. R 

azor 

Hata 

5 

Konsolu 

Tüm kategoriler 

Bilgisi 

6 

Tüm sağlayıcılar 

Tüm kategoriler 

Hata ayıklama 

7 

Tüm sağlayıcılar 

Sistem 

Hata ayıklama 

8 

Hata ayıklama 

Microsoft 

izleme 


Bir iLogger nesnesi oluşturulduğunda, noggerFactory nesnesi, bu günlükçü için uygulanacak her sağlayıcı için tek 
bir kural seçer. Bir iLogger örneği tarafından yazılan tüm iletiler, seçilen kurallara göre filtrelenmiştir. Her sağlayıcı 
ve kategori çifti için mümkün olan en özel kural kullanılabilir kurallardan seçilir. 

Belirli bir kategori için iLogger oluşturulduğunda, her sağlayıcı için aşağıdaki algoritma kullanılır: 

• Sağlayıcı veya diğer adıyla eşleşen tüm kuralları seçin. Hiçbir eşleşme bulunmazsa, boş bir sağlayıcıya sahip tüm 
kurallar 1 ı seçin. 

• Önceki adımın sonucunda, en uzun eşleşen kategori ön ekine sahip kurallar 1 ı seçin. Eşleşme bulunmazsa, 
kategori belirtmeyen tüm kuralları seçin. 

• Birden çok kural seçilirse, son olanı götürün. 

• Hiçbir kural seçilmezse MinimumLevel kullanın. 

Yukarıdaki kurallar listesinde, "Microsoft. AspNetCore. Mvc. Razor. RazorVievvEngine" kategorisi için bir iLogger 
nesnesi oluşturduğunuzu varsayalım: 

• Hata ayıklama sağlayıcısı, kurallar 1, 6 ve 8 için geçerlidir. Kural 8 1 i en özeldir, yani seçili olanı seçilidir. 

• Konsol sağlayıcısı için, kurallar 3,4, 5 ve 6 geçerlidir. Kural 3 en özeldir. 

Elde edilen iLogger örneği, hata ayıklama sağlayıcısına Trace düzeyi ve üzeri Günlükler gönderir. Debug düzeyi 
ve üzeri Günlükler konsol sağlayıcısına gönderilir. 

Sağlayıcı diğer adları 

Her sağlayıcı, tam nitelikli tür adı yerine yapılandırmada kullanılabilecek bir diğer ad tanımlar. Yerleşik sağlayıcılar 
için aşağıdaki diğer adları kullanın: 

• Konsolu 

• Hata ayıklama 

• EventSource 

• EventLog 

• TraceSource 

• AzureAppServicesFile 

• AzureAppServicesBIob 

• Appl ication I nsights 

Varsayılan en düşük düzey 

Yalnızca belirli bir sağlayıcı ve kategori için yapılandırma veya koddan kural uygulanmaz geçerli olan en düşük 
düzey ayar vardır. Aşağıdaki örnekte, en düşük düzeyin nasıl ayarlanacağı gösterilmektedir: 













public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureLogging(logging => logging.SetMinimumLevel(LogLevel.Uarning)) 


WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.ConfigureLogging(logging => logging.SetMinimumLevel(LogLevel.Warning)); 

En düşük düzeyi açıkça ayarlamazsanız, varsayılan değer Information , bu da Trace ve Debug günlüklerinin 
yoksayıldığı anlamına gelir. 


Filtre işlevleri 

Configuration veya Code tarafından kendisine atanmış kuralları olmayan tüm sağlayıcılar ve kategoriler için bir 
filtre işlevi çağırılır, işlevindeki kodun sağlayıcı türü, kategorisi ve günlük düzeyine erişimi vardır.Örneğin: 

.ConfigureLogging(logBuilder => 

{ 

logBuilder.AddFilter((providerj category, logLevel) => 

{ 

if (provider == "Microsoft.Extensions.Logging.Console.ConsoleLoggerProvider" && 
category == "TodoApiSample.Controllers.TodoController") 

{ 

return false; 

} 

return true; 

}); 

}) 


WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.ConfigureLogging(logBuilder => 

{ 

logBuilder.AddFilter((provider, category, logLevel) => 

{ 

if (provider == "Microsoft.Extensions.Logging.Console.ConsoleLoggerProvider" && 
category == "TodoApiSample.Controllers.TodoController") 

{ 

return false; 

} 

return true; 

}); 

}); 


Sistem kategorileri ve Düzeyler 

ASP.NET Core ve Entity Framevvork Core tarafından kullanılan bazı kategoriler şunlardır ve bunlardan beklenen 
Günlükler hakkında notlar bulunur: 


KATEGORİ 

NOTLAR 

Microsoft.AspNetCore 

Genel ASP.NET Core tanılama. 

Microsoft.AspNetCore.DataProtection 

Hangi anahtarların kabul edildiği, bulunduğu ve kullanıldığı. 

Microsoft.AspNetCore.HostFiltering 

izin verilen konaklar. 






KATEGORİ 


NOTLAR 


Microsoft.AspNetCore.Hosting 

HTTP isteklerinin tamamlanması için geçen süre ve ne zaman 
başladıkları. Hangi barındırma başlangıç derlemeleri yüklendi. 

Microsoft.AspNetCore.Mvc 

MVC ve Razor tanılama. Model bağlama, filtre yürütme, 
derlemeyi görüntüleme, eylem seçimi. 

Microsoft.AspNetCore.Routing 

Eşleşen bilgileri yönlendirin. 

Microsoft. AspNetCore. Server 

Bağlantı başlatın, durdurun ve canlı yanıtları koruyun. HTTPS 
sertifika bilgileri. 

Microsoft.AspNetCore.StaticFiles 

Sunulan dosyalar. 


Microsoft. EntityFramevvorkCore Genel Entity Framevvork Core tanılama. Veritabanı etkinliği ve 

yapılandırması, değişiklik algılama, geçişler. 


Günlük kapsamları 

Kapsam bir mantıksal işlemler kümesini gruplandırabilir. Bu gruplandırma, kümenin bir parçası olarak oluşturulan 
her günlüğe aynı verileri eklemek için kullanılabilir. Örneğin, bir işlemin işlenmesi kapsamında oluşturulan her 
günlük işlem KİMLİĞİ içerebilir. 

Kapsam, BeginScope yöntemi tarafından döndürülen ve atılana kadar bir iDisposable türüdür, using bloğunda 
günlükçü çağrılarını sarmalayarak kapsam kullanın: 

public IActionResult GetById(string id) 

{ 

Todoltem item; 

using (_logger.BeginScope("Message attached to logs created in the using block")) 

{ 

_logger. LogInformation(LoggingEvents .Getltem, "Getting item {Id}", id); 
item = _todoRepository.Find(id); 
if (item == null) 

{ 

_logger.LogWarning(LoggingEvents.GetltemNotFound, "GetById({Id}) NOT FOUND", id); 
return NotFound(); 

} 

} 

return new ObjectResult(item); 

} 


public IActionResult GetById(string id) 

{ 

Todoltem item; 

using (_logger.BeginScope("Message attached to logs created in the using block")) 

{ 

_logger.LogInformation(LoggingEvents.Getltem, "Getting item {Id}", id); 
item = _todoRepository.Find(id); 
if (item == null) 

{ 

_logger.LogWarning(LoggingEvents.GetltemNotFoundj "GetById({Id}) NOT FOUND", id); 
return NotFound(); 

} 

} 

return new ObjectResult(item); 

} 





Aşağıdaki kod konsol sağlayıcısı için kapsamları etkinleştirilir: 

Program.es : 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureLogging((hostingContext, logging) => 

{ 

logging.ClearProviders(); 

logging.AddConsole(options => options.IncludeScopes = true); 
logging.AddDebug(); 

}) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 


.ConfigureLogging((hostingContext, logging) => 

{ 

logging.AddConfiguration(hostingContext.Configunation.GetSection("Logging")); 
logging.AddConsole(options => options.IncludeScopes = true); 
logging.AddDebug(); 

}) 



info: TodoApiSample.Controllers.TodoController[1002] 

=> RequestId:0HKV9C49II9CK RequestPath:/api/todo/0 => TodoApiSample.Controllers.TodoController.GetByld 
(TodoApi) => Message attached to logs created in the using block 
Getting item 0 

warn: TodoApiSample.Controllers.TodoController[4000] 

=> RequestId:0HKV9C49II9CK RequestPath:/api/todo/0 => TodoApiSample.Controllers.TodoController.GetByld 
(TodoApi) => Message attached to logs created in the using block 
GetById(0) NOT FOUND 


Yerleşik günlük oluşturma sağlayıcıları 

ASP.NET Core aşağıdaki sağlayıcıları sevk eder: 

• Console 

• Hata ayıklama 

• EventSource 

• EventLog 

• TraceSource 

• AzureAppServicesFile 

• AzureAppServicesBIob 

• Applicationlnsights 

ASP.NET Core modülüyle stdout ve hata ayıklama günlüğü hakkında daha fazla bilgi için, bkz. Azure App Service 





ve 11S 'de ASP.N ET Core sorunlarını giderme ve ASP.N ET Core Modülü. 

Konsol sağlayıcısı 

Microsoft. Extensions. Logging. Console sağlayıcı paketi, günlük çıktısını konsola gönderir, 
logging.AddConsole(); 

Konsol günlüğü çıkışını görmek için proje klasöründe bir komut istemi açın ve aşağıdaki komutu çalıştırın: 

dotnet run 

Hata ayıklama sağlayıcısı 

Microsoft. Extensions. Logging. Debug sağlayıcı paketi, System. Diagnostics. Debug sınıfını ( Debug.writeLine 
Yöntem çağrıları) kullanarak günlük çıktısını yazar. 

Linux 'ta, bu sağlayıcı günlükleri /var/log/Messagedosyas\r\a yazar, 
logging.AddDebug(); 

Olay kaynak sağlayıcısı 

Microsoft. Extensions. Logging. EventSource sağlayıcı paketi, Microsoft-Extensions-Logging adı İle bir olay kaynağı 
platformlar arası yazar. VVİndovvs 'da, sağlayıcı ETVVkullanır. 

logging.AddEventSourceLogger(); 

Konak oluşturmak için createDefaultBuiider çağrıldığında olay kaynak sağlayıcısı otomatik olarak eklenir. 

DotNet izleme araçları 

DotNet-Trace Aracı, çalışan bir İşlemin .NET Core izlemelerinin toplanmasını sağlayan platformlar arası CLI genel 
aracıdır. Araç, bir LoggingEventSourcekullanarak Microsoft.Extensions.Logging.EventSource sağlayıcı verileri toplar. 

DotNet Trace araçları komutunu aşağıdaki komutla birlikte yüklersiniz: 

dotnet tool install --global dotnet-tnace 

Bir uygulamadan izleme toplamak için DotNet Trace araçları kullanın: 

1 . Uygulama ana bilgisayarı CreateDefaultBuiider oluşturmaz, olay kaynak sağlayıcısını uygulamanın günlük 
yapılandırmasına ekleyin. 

2. dotnet run komutuyla uygulamayı çalıştırın. 

3. .NET Core uygulamasının işlem tanımlayıcısını (PID) belirleme: 

• VVİndovvs 'ta aşağıdaki yaklaşımlardan birini kullanın: 
o Görev Yöneticisi (Ctrl + Alt + Del) 

o Tasklist komutu 
o Get-Process PovverShell komutu 

• Linux 'ta pidof komutunukullanın. 

Uygulamanın derlemesi ile aynı ada sahip olan işlem için PID 'i bulun. 

4. dotnet trace komutunu yürütün. 









Genel komut sözdizimi: 


dotnet trace collect -p {PID} 

--providers Microsoft-Extensions-Logging:{Keyword}:{Event Level} 

:FilterSpecs=\" 

{Logger Category l}:{Event Level 1}; 

{Logger Category 2}:{Event Level 2 }; 

(Logger Category N}:{Event Level N}\" 

PowerShell komut kabuğu kullanırken --providers değerini tek tırnak içine alın ( ' ): 
dotnet trace collect -p {PID} 

--providers 'Microsoft-Extensions-Logging:{Keyword}:{Event Level} 

:FilterSpecs=\" 

{Logger Category 1}:{Event Level 1}; 

{Logger Category 2}:{Event Level 2}; 

{Logger Category N}:{Event Level N}\"' 

Windows dışı platformlarda, çıkış izleme dosyasının biçimini speedscope olarak değiştirmek için 
-f speedscope seçeneğini ekleyin. 


ANAHTAR SÖZCÜĞÜ AÇIKLAMA 


1 . 

LoggingEventsource ilgili meta olayları günlüğe kaydedin. 
Olayları iLogger ) günlüğe kaydetmez. 

2 

iLogger. Log( ) çağrıldığında Message olayı açar. 


Programlı (biçimlendirilmedi) bir şekilde bilgi sağlar. 

4 

iLogger. Log( ) çağrıldığında FormatMessage olayı açar., 


Bilgilerin biçimlendirilen dize sürümünü sağlar. 

8 

iLogger. Log( ) çağrıldığında Messageison olayı açar. 


Bağımsız değişkenlerin JSON gösterimini sağlar. 

OLAY DÜZEYİ 

AÇIKLAMA 

0 

LogAlways 

1 . 

Critical 

2 

Error 

3 

Warning 

4 

Informational 


5 Verbose 


{Logger Category} ve {Event Level} için FilterSpecs girişleri ek günlük filtreleme koşullarını temsil eder. 
FilterSpecs girdileri noktalı virgülle ayırın ( ; ). 





















Windows komut kabuğu ile örnek ( --providers değeri etrafında tek tırnakyoktur): 


dotnet trace collect -p {PID} --providers Microsoft-Extensions- 
Logging:4: 2: FilterSpecs=\"Microsoft.AspNetCore.Hoşting* :4\" 

Yukarıdaki komut şunları etkinleştirir: 

• Hatalar için ( 2 ) biçimlendirilen dizeler ( 4 ) üretmek üzere olay kaynağı günlükçüsü. 

• günlüğe kaydetme Informational günlük düzeyinde ( 4 ) Microsoft.AspNetCore.Hosting . 

5. ENTER tuşuna veya CTRL + C tuşlarına basarak DotNet izleme araçlarını durdurun. 

İzleme, dotnet trace komutunun yürütüldüğü klasörde Trace. NetTrace adıyla kaydedilir. 

6. Trace 'i PerfVievvile açın. Trace. NetTrace dosyasını açın ve izleme olaylarını araştırın. 

Daha fazla bilgi için bkz. 

• Performans Analizi yardımcı programı İçin izleme (DotNet-Trace) (.NET Core belgeleri) 

• Performans Analizi yardımcı programı (DotNet-Trace) İçin izleme (DotNet/Diagnostics GitHub deposu 
belgeleri) 

• Loggingeventsource sınıfı (.NET API tarayıcısı) 

• EventLevel 

• Loggingeventsource başvuru kaynağı (3,0) - farklı bir sürüm için başvuru kaynağı elde etmek üzere, dalı 

reiease/{version} olarak değiştirin, burada {version} istenenASP.NET Core sürümüdür. 

• PerfVievv , olay kaynağı izlemelerini görüntülemek için kullanışlıdır -. 

PerfVievv 

Günlükleri toplamak ve görüntülemek için PerfVievv yardımcı programını kullanın. ETW günlüklerim 
görüntülemeye yönelik başka araçlar da mevcuttur, ancak PerfVievv, ASP.NET Core tarafından yayınlanan ETW 
olaylarıyla çalışmak için en iyi deneyimi sağlar. 

Bu sağlayıcı tarafından günlüğe kaydedilen olayları toplamak için PerfVievv 'ı yapılandırmak için, 
*Microsoft-Extensions-Logging dizeyi ek sağlayıcılar listesine ekleyin. (Dizenin başlangıcında yıldız işaretini 
kaçırmayın.) 



Windows olay günlüğü sağlayıcısı 

































Microsoft. Extensions. Logging. EventLog sağlayıcı paketi, VVİndovvs olay günlüğüne günlük çıktısı gönderir, 
logging.AddEventLog(); 

AddEventLog aşırı yüklemeler EventLogSettingsiletmenizi sağlar, nuiı veya belirtilmemişse, aşağıdaki varsayılan 
ayarlar kullanılır: 

• "uygulama" LogName - 

• SourceName — ".N ET Runtime" 

• MachineName -yerel makine 

TraceSource sağlayıcısı 

Microsoft. Extensions. Logging. TraceSource sağlayıcı paketi TraceSource kitaplıklarını ve sağlayıcıları kullanır, 
logging.AddTraceSource(sourceSwitchName); 

Addtracesource aşırı yüklemeleri , bir kaynak anahtarı ve bir izleme dinleyicisi geçirmenize olanak sağlar. 

Bu sağlayıcıyı kullanmak için, bir uygulamanın .NET Framework çalışması gerekir (.NET Coreyerine). Sağlayıcı, 
iletileri örnek uygulamada kullanılan TextWriterTraceListener gibi çeşitli dinleyicilerineyönlendirebilir. 

Azure App Service sağlayıcı 

Microsoft. Extensions. Logging. AzureAppServices sağlayıcı paketi, günlükleri bir Azure App Service uygulamasının 
dosya sistemindeki metin dosyalarına ve bir Azure depolama hesabındaki BLOB depolama alanına yazar. 

logging.AddAzureWebAppDiagnostics(); 

Sağlayıcı paketi, paylaşılan çerçeveye dahil değildir.Sağlayıcıyı kullanmak için sağlayıcı paketini projeye ekleyin. 

Sağlayıcı paketi Microsoft. AspNetCore. app metapackage'e dahil değildir. .NET Framevvork veya 
Microsoft.AspNetcore.App metapackage 'e başvuru yaparken, sağlayıcı paketini projeye ekleyin. 

Sağlayıcı ayarlarını yapılandırmak için aşağıdaki örnekte gösterildiği gibi AzureFileLoggerOptions ve 
AzureBlobLoggerOptionsku İlanın: 







public static void Main(string[] args) 

{ 

var hoşt = CreateHostBuilder(args).Build(); 

var todoRepository = hoşt.Services.GetRequiredService<ITodoRepository>(); 
todoRepository.Add(new Core.Model.TodoItem() { Name = "Feed the dog" }); 
todoRepository.Add(new Core.Model.TodoItem() { Name = "Walk the dog" }); 

var logger = hoşt.Services.GetRequiredService<ILogger<Program>>(); 
logger.LogInformation("Seeded the database."); 

host.Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureLogging(logging => logging.AddAzurel/JebAppDiagnostics()) 
.ConfigureServices(serviceCollection => serviceCollection 
.Configure<AzureFileLoggerOptions>(options => 

{ 

options.FileName = "azure-diagnostics-"; 
options.FileSizeLimit = 50 * 1024; 
options.RetainedFileCountLimit = 5; 

}).Configure<AzureBlobLoggerOptions>(options => 

{ 

options.BlobName = "log.txt"; 

}) 

) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 


Sağlayıcı ayarlarını yapılandırmak için aşağıdaki örnekte gösterildiği gibi AzureFileLoggerOptions ve 
AzureBlobLoggerOptionsku İlanın: 

public static void Main(string[] args) 

{ 

var hoşt = CreateWebHostBuilder(args).Build(); 

var todoRepository = hoşt.Services.GetRequiredService<ITodoRepository>(); 
todoRepository.Add(new Core.Model.TodoItem() { Name = "Feed the dog" }); 
todoRepository.Add(new Core.Model.TodoItem() { Name = "Walk the dog" }); 

var logger = hoşt.Services.GetRequiredService<ILogger<Program>>(); 
logger.LogInformation("Seeded the database."); 

host.Run(); 

} 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.ConfigureLogging(logging => logging.AddAzureWebAppDiagnostics()) 
.ConfigureServices(serviceCollection => serviceCollection 
.Configure<AzureFileLoggerOptions»(options => 

{ 

options.FileName = "azure-diagnostics-"; 
options. FileSizeLimit = 50 * 1024; 
options.RetainedFileCountLimit = 5; 

}).Configure<AzureBlobLoggerOptions>(options => 

{ 

options.BlobName = "log.txt"; 

})) 

.UseStartup<Startup>(); 




AddAzureVVebAppDiagnostics aşırı yüklemesi AzureAppServicesDiagnosticsSettingsgeçirmenize olanak tanır. 
Ayarlar nesnesi, günlük çıkış şablonu, blob adı ve dosya boyutu sınırı gibi varsayılan ayarları geçersiz kılabilir.(Ç/kft 
şablonu , bir iLogger yöntemi çağrısıyla sağlandığının yanı sıra tüm günlüklere uygulanan bir ileti şablonudur.) 

App Service uygulamasına dağıtırken, uygulama, Azure portal App Service sayfasının App Service Günlükler 
bölümündeki ayarları kabul eder. Aşağıdaki ayarlar güncelleştirilirken, değişiklikler uygulamanın yeniden 
başlatılmasını veya yeniden dağıtımı gerekmeden hemen etkili olur. 

• Uygulama günlüğü (dosya sistemi) 

• Uygulama günlüğü (blob) 

Günlük dosyaları için varsayılan konum D:\home\LogFiles\uygulama klasöründedir ve varsayılan dosya adı 
Diagnostics-YYYYMMDD. txf dir. Varsayılan dosya boyutu sınırı 10MB 'tır ve tutulan varsayılan en fazla dosya 
sayısı 2 1 dir. Varsayılan blob adı {app-name} {timestamp}/yyyy/mm/dd/ss/{Guid}-ApplicationLog.txt. 

Sağlayıcı yalnızca proje Azure ortamında çalıştırıldığında çalışır. Proje yerel olarak çalıştırıldığında, yerel dosyalara 
veya Bloblar için yerel geliştirme depolamasına yazmazsa—hiçbir etkisi yoktur. 

Azure günlük akışı 

Azure günlük akışı, günlük etkinliklerini gerçek zamanlı olarak görüntülemenize izin verir: 

• Uygulama sunucusu 

• Web sunucusu 

• Başarısız istek izleme 

Azure günlük akışını yapılandırmak için: 

• Uygulamanızın Portal sayfasından App Service günlükleri sayfasına gidin. 

• Uygulama günlüğünü (FileSystem) Açıkolarak ayarlayın. 

• Günlük düzeyiniseçin. Bu ayar, uygulamadaki diğer günlük sağlayıcılarını değil, yalnızca Azure günlük akışı için 
geçerlidir. 

Uygulama iletilerini görüntülemek için günlük akışı sayfasına gidin. Uygulama tarafından iLogger arabirimi 
aracılığıyla günlüğe kaydedilir. 

Azure Application Insights izleme günlüğü 

Microsoft. Extensions. Logging. Applicationlnsights sağlayıcı paketi günlükleri Azure Application Insights yazar. 
Application Insights, bir Web uygulamasını izleyen ve telemetri verilerini sorgulamak ve analiz etmek için araçlar 
sağlayan bir hizmettir. Bu sağlayıcıyı kullanıyorsanız, Application Insights araçlarını kullanarak günlüklerinizi 
sorgulayabilir ve analiz edebilirsiniz. 

Günlüğe kaydetme sağlayıcısı, ASP.N ET Core için tüm kullanılabilir telemetri sağlayan paket olan Microsoft. 
Applicationlnsights. AspNetCore'un bağımlılığı olarak eklenmiştir. Bu paketi kullanırsanız, sağlayıcı paketini 
yüklemek zorunda kalmazsınız. 

ASP.NET 4. x için olan Microsoft. Applicationlnsights. Web paketini kullanmayın—•. 

Daha fazla bilgi için aşağıdaki kaynaklara bakın: 

• Application Insights genel bakış 

• ASP.NET Core uygulamalar için Application Insights -günlük kaydı ile birlikte Application Insights telemetrinin 
tam aralığını uygulamak istiyorsanız buraya başlayın. 

• .N ET Core ILogger günlükleri İçin Applicationınsightsloggerprovider -günlük sağlayıcısını Application Insights 
telemetri olmadan uygulamak istiyorsanız buraya başlayın. 

• Günlüğe kaydetme bağdaştırıcılarını Application Insights. 

• Microsoft Learn sitede Application Insights SDK-etkileşimli öğreticisini yükleyip başlatın . 




Üçüncü taraf günlük oluşturma sağlayıcıları 

AS P.N ET Core ile birlikte çalışan üçüncü taraf günlük çerçeveleri: 

• ELMAH.İo (GitHub deposu) 

• Gelf (GitHub deposu) 

• Jsnlog (GitHub deposu) 

• KissLog.net (GitHub deposu) 

• Log4Net (GitHub deposu) 

• Loggr (GitHub deposu) 

• NLog (GitHub deposu) 

• Sentry (GitHub deposu) 

• Serilog (GitHub deposu) 

• Stackdriver (GitHub deposu) 

Bazı üçüncü taraf çerçeveler , yapılandırılmış günlük olarak da bilinen anlam günlüğe kaydetmeişlemini 
gerçekleştirebilir. 

Bir üçüncü taraf çerçevesinin kullanılması, yerleşik sağlayıcılardan birini kullanmaya benzer: 

1. Projenize bir NuGet paketi ekleyin. 

2. Günlüğe kaydetme çerçevesi tarafından sağlanmış bir iLoggerFactory Extension yöntemi çağırın. 

Daha fazla bilgi için bkz. her sağlayıcının belgeleri. Üçüncü taraf günlüğü sağlayıcıları Microsoft tarafından 
desteklenmez. 

Ek kaynaklar 

• AS P.N ET Core 'de LoggerMessage ile yüksek performanslı günlüğe kaydetme 
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Yönlendirme, istek URI 'Lerini uç noktalarla eşleştirmekten ve gelen istekleri bu uç noktalara gönderen 
sorumludur. Yollar uygulamada tanımlanır ve uygulama başlatıldığında yapılandırılır. Yol, isteğe bağlı olarak 
istekte bulunan URL 'den değerleri ayıklayabilir ve bu değerler, istek işleme için kullanılabilir. Uygulamadan 
yönlendirme bilgilerini kullanarak, yönlendirme, uç noktalarıyla eşlenen URL ’Ler de oluşturabilir. 


IMPORTANT 

Bu belge, alt düzey ASP.NET Core yönlendirmeyi içerir. ASP.NET Core MVC yönlendirme hakkında daha fazla bilgi için 
bkz. ASP.NET Core denetleyici eylemlerine yönlendirme. Razor Pages 'de yönlendirme kuralları hakkında bilgi için bkz. 
ASP.NET Core Razor Pages yol ve uygulama kuralları. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Yönlendirme temelleri 

Çoğu uygulama, URL 'Lerin okunabilir ve anlamlı olması için temel ve açıklayıcı bir yönlendirme şeması 
seçmelidir. Varsayılan geleneksel yol {controiier=Home}/{action=index}/{id?} : 

• Temel ve açıklayıcı bir yönlendirme düzenini destekler. 

• , UI tabanlı uygulamalar için kullanışlı bir başlangıç noktasıdır. 

Geliştiriciler, öznitelik yönlendirme veya adanmış geleneksel yollar kullanarak özel durumlarda (örneğin, 
blog ve e-ticaret uç noktaları) bir uygulamanın yüksek trafik bölümlerine daha fazla terse yolu ekler. 

Web API 'Leri, uygulamanın işlevselliğini HTTP fiilleri tarafından temsil edilen bir kaynak kümesi olarak 
modellemek için öznitelik yönlendirmeyi kullanmalıdır. Bu, aynı mantıksal kaynaktaki birçok işlemin 
(örneğin, GET, POST) aynı URL 'Yİ kullanacağı anlamına gelir. Öznitelik yönlendirme, bir API 'nin Genel uç 
nokta yerleşimini dikkatle tasarlamak için gereken bir denetim düzeyi sağlar. 

Razor Pages uygulamalar, bir uygulamanın Sayfalar klasöründe adlandırılmış kaynaklara hizmeti sağlamak 
için varsayılan geleneksel yönlendirmeyi kullanır. Razor Pages yönlendirme davranışını özelleştirmenizi 
sağlayan ek kurallar mevcuttur. Daha fazla bilgi için bkz. ASP.NET Core Razor Pages giriş ve ASP.NET Core 
Razor Pages yol ve uygulama kuralları. 

URL oluşturma desteği, uygulamanın, uygulamayı birbirine bağlamak için sabit kodlama URL 'Leri 
olmadan geliştirilebilmesine izin verir. Bu destek, temel bir yönlendirme yapılandırmasıyla başlayıp 
uygulamanın kaynak düzeni belirlendikten sonra yolların değiştirilmesini sağlar. 

Yönlendirme, bir uygulamadaki mantıksal uç noktaları temsil etmek için uç noktaları ( Endpoint ) kullanır. 

Bir uç nokta, istekleri işlemek için bir temsilci ve rastgele meta veri koleksiyonunu tanımlar. Meta veriler, her 
uç noktaya eklenen ilkelere ve yapılandırmaya göre çapraz kesme sorunları uygulamak için kullanılır. 

Yönlendirme sistemi aşağıdaki özelliklere sahiptir: 

• Yol şablonu sözdizimi, simgeleştirilmiş yol parametrelerine sahip yolları tanımlamak için kullanılır. 

• Geleneksel stil ve öznitelik stili uç nokta yapılandırmasına izin verilir. 







• IRouteConstraint, bir URL parametresinin belirli bir uç nokta kısıtlaması için geçerli bir değer içerip 
içermediğini belirlemekte kullanılır. 

• MVC/Razor Pages gibi uygulama modelleri, yönlendirme senaryolarının öngörülebilir bir 
uygulaması olan tüm uç noktalarını kaydeder. 

• Yönlendirme gerçekleştirme, yönlendirme kararlarını, ara yazılım ardışık düzeninde istediğiniz yere 
getirir. 

• Bir yönlendirme ara yazılımı, belirli bir istek URI 'SI için yönlendirme ara yazılımı uç noktası 
kararının sonucunu inceleyebilir. 

• Uygulamadaki tüm uç noktaları, ara yazılım ardışık düzeninde herhangi bir yerde listelemek 
mümkündür. 

• Bir uygulama, uç nokta bilgilerine göre URL 'Ler oluşturmak için (örneğin, yeniden yönlendirme 
veya bağlantılar için) yönlendirmeyi kullanabilir ve bu sayede bakım yapılmasına yardımcı olan sabit 
kodlanmış URL 'Lerden kaçınabilirsiniz. 

• URL oluşturma, rastgele genişletilebilirliği destekleyen adreslere dayalıdır: 

o Bağlantı Oluşturucu API 'SI (LinkGenerator), bağımlılık ekleme (dı) kullanılarak URL 'ler 
oluşturmak için her yerde çözülebilir. 

o Bağlantı Oluşturucu API 'sinin Dİ aracılığıyla kullanılamadığı durumlarda lUrlHelper URL 'Leri 
derlemek için yöntemler sunar. 


NOTE 

Uç nokta bağlama, MVC/Razor Pages eylemleri ve sayfalarıyla sınırlıdır. Uç nokta bağlama yeteneklerinin 
genişletmeleri, gelecek sürümlerde planlanmaktadır. 


Yönlendirme, RouterMiddlevvare sınıfı tarafından, Ara yazılım ardışık düzenine bağlıdır. ASP.NET Core 
MVC , yapılandırma kapsamında bir ara yazılım ardışık düzenine yönlendirme ekler ve MVC ve Razor 
Pages uygulamalarında yönlendirmeyi işler. Tek başına bileşen olarak yönlendirmeyi nasıl kullanacağınızı 
öğrenmek için yönlendirme ara yazılımı kullanma bölümüne bakın. 

URL eşleştirme 

URL eşleştirme, yönlendirmenin bir uç noktaya gelen isteği gönderdiği işlemdir. Bu işlem, URL yolundaki 
verileri temel alır, ancak istekteki verileri göz önünde bulundurmanız için genişletilebilir. Ayrı işleyicilere 
istek gönderme özelliği, bir uygulamanın boyutunu ve karmaşıklığını ölçeklendirmeye yönelik anahtardır. 

Bir yönlendirme ara yazılımı yürütüldüğünde, bir uç nokta ( Endpoint ) ayarlar ve değerleri HttpContextbir 
özelliğe yönlendirir. Geçerli istek için: 



Yönlendirme ara yazılımı ile çalışan ara yazılım, uç noktayı görebilir ve işlem yapabilir.Örneğin, bir 
yetkilendirme ara yazılımı, bir yetkilendirme ilkesi için bitiş noktasının meta veri koleksiyonunu 
sorgulanamıyor, istek işleme ardışık düzeninde bulunan tüm ara yazılım yürütüldükten sonra, seçilen uç 
noktanın temsilcisi çağrılır. 

Uç nokta yönlendirmesinde yönlendirme sistemi tüm gönderme kararlarından sorumludur.Ara yazılım, 
seçili uç noktaya göre ilkeler uyguladığı için, yönlendirme sisteminde güvenlik ilkelerinin dağıtımını 
etkileyebilecek veya uygulamanın uygulanmasını etkileyebilecek herhangi bir kararın olması önemlidir. 

Uç nokta temsilcisi yürütüldüğünde, Routecontext. RouteData özellikleri, bu nedenle yapılan istek işlemeye 








bağlı olarak uygun değerlere ayarlanır. 

RouteData. Values , rotada oluşturulan yol değerlerinin bir sözlüğüdür. Bu değerler genellikle URL 'Yİ 
simgeleştirerek belirlenir ve Kullanıcı girişini kabul etmek ya da uygulama içinde daha fazla kararlar almak 
için kullanılabilir. 

RouteData. DataTokens , eşleşen rotayla ilgili ek verilerin bir özellik çantadır. DataTokens, uygulamanın 
hangi yolun eşleştiğini temel alarak kararlar verebilmesi için durum verilerinin her bir rota ile 
ilişkilendirilmesini desteklemek amacıyla sağlanır. Bu değerler, geliştirici tarafından tanımlanır ve 
yönlendirme davranışını herhangi bir şekilde etkilemez. Ayrıca, RouteData. DataTokens içinde bulunan 
değerler her türlü türden olabilir. Bu, veridizeleri arasında dönüştürülebilir olmalıdır. 

RouteData. yönlendiriciler , isteği başarıyla eşleştirirken geçen yolların bir listesidir. Yollar bir diğerinin 
içinde iç içe olabilir. Routers özelliği, bir eşleşme ile sonuçlanan yolların mantıksal ağacı aracılığıyla yolu 
yansıtır. Genellikle, Routers ilk öğe yol koleksiyonudur ve URL oluşturma için kullanılmalıdır. Routers son 
öğe, eşleşen yol işleyicisidir. 

LinkGenerator ile URL oluşturma 

URL oluşturma, yönlendirmenin bir yol değerleri kümesine göre bir URL yolu oluşturabileceği işlemdir.Bu, 
uç noktalarınız ve bunlara erişen URL 'Ler arasında mantıksal bir ayrım sağlar. 

Uç nokta yönlendirme bağlantı Oluşturucu API 'sini (LinkGenerator) içerir. LinkGenerator, Dİ 'dan 
alınabilecek bir tek hizmettir. API, yürütülen bir istek bağlamı dışında kullanılabilir.MVC 'nin Etiket 
Yardımcıları, HTML Yardımcıları ve eylem sonuçlarıgibi lUrlHelperkullanan lUrlHelper ve senaryoları, 
bağlantı oluşturma yetenekleri sağlamak için bağlantı oluşturucuyu kullanır. 

Bağlantı Oluşturucu, bir Adres ve Adres şemo/onkavramıyla desteklenir. Adres şeması, bağlantı oluşturma 
için göz önünde bulundurmanız gereken uç noktaları belirlemenin bir yoludur. Örneğin, çok sayıda 
kullanıcının yol adı ve yol değerleri senaryoları, MVC/Razor Pages tarafından tanıdık bir adres düzeni 
olarak uygulanır. 

Bağlantı Oluşturucu, aşağıdaki genişletme yöntemleri aracılığıyla MVC/Razor Pages eylemlerine ve 
sayfalarına bağlanabilir: 

• GetPathByAction 

• GetUriByAction 

• GetPathByPage 

• GetUriByPage 

Bu yöntemlerin aşırı yüklemesi HttpContext içeren bağımsız değişkenleri kabul eder. Bu yöntemler 
url.Action ve url.Page işlevsel olarak eşdeğerdir ancak ek esneklik ve seçenekler sunar. 

GetPath* yöntemleri, url.Action ve url.Page , mutlak bir yol içeren bir URI oluşturmak için en çok 
benzerdir. Geturi* Yöntemler her zaman bir düzen ve konak içeren mutlak bir URI oluşturur.Bir 
HttpContext kabul eden yöntemler, yürütülmekte olan istek bağlamında bir URI oluşturur.Ortam yolu 
değerleri, URL taban yolu, şeması ve yürütülen istekten ana bilgisayar, geçersiz kılınmadıkça kullanılır. 

LinkGenerator bir adresle çağrılır. URI oluşturma iki adımda gerçekleşir: 

1. Adres, adresle eşleşen bir uç nokta listesine bağlanır. 

2. Her uç noktanın RoutePattern , sağlanan değerlerle eşleşen bir rota deseninin bulunana kadar 
değerlendirilir. Elde edilen çıktı, bağlantı oluşturucuya sağlanan diğer URI parçalarıyla birleştirilir ve 
döndürülür. 

LinkGenerator tarafından sunulan yöntemler, herhangi bir tür adresin standart bağlantı oluşturma 
özelliklerini destekler. Bağlantı oluşturucuyu kullanmanın en kolay yolu, belirli bir adres türü için işlem 
gerçekleştiren genişletme yöntemlerine yöneliktir. 
















GENİŞLETME YÖNTEMİ 


AÇIKLAMA 


GetPathByAddress Belirtilen değerleri temel alarak mutlak bir yola sahip bir 

URI oluşturur. 

GetUriByAddress Belirtilen değerleri temel alarak mutlak bir URI oluşturur. 


VVARNING 

LinkGenerator yöntemlerinin çağrılmasının aşağıdaki etkilerine dikkat edin: 

• Gelen isteklerin Hoşt üstbilgisini doğrulayan bir uygulama yapılandırmasında Geturi* uzantısı 
yöntemlerini dikkatle kullanın. Gelen isteklerin Hoşt üstbilgisi doğrulandıktan sonra, güvenilir olmayan istek 
girişi, bir görünüm/sayfada URI 'Ler halinde istemciye geri gönderilebilir. Tüm üretim uygulamalarının, Hoşt 
üst bilgisini bilinen geçerli değerlere karşı doğrulamak için kendi sunucusunu yapılandırmasını öneririz. 

• Map veya Mapwhen birlikte ara yazılım ile birlikte LinkGenerator kullanın. Map* , yürütülen isteğin temel 
yolunu değiştirir ve bu da bağlantı oluşturma çıktısını etkiler. Tüm LinkGenerator API 'Leri temel yol 
belirtmeye izin verir. Map* bağlantı oluşturmada etkilerini geri almak için her zaman boş bir temel yol belirtin. 


Önceki yönlendirme sürümlerinden uç nokta yönlendirme farkları 

AS P.N ET Core 2,2 ' den önceki yönlendirmenin uç nokta yönlendirme ve sürümleri arasında birkaç fark 
vardır: 

• Uç nokta yönlendirme sistemi, Routedevralma dahil IRoutertabanlı genişletilebilirliği desteklemez. 

• Uç nokta yönlendirme VVebApiCompatShimdesteklemez. Uyumluluk Shim 'yi kullanmaya devam 
etmek için 2,1 Uyumluluk sürümünü ( .SetCompatibilityVersion(CompatibilityVersion.Version_2_l) ) 
kullanın. 

• Uç nokta yönlendirmesinde, geleneksel yollar kullanılırken oluşturulan URI 1 lerin büyük küçük 
harfleri için farklı davranış vardır. 

Aşağıdaki varsayılan yol şablonunu göz önünde bulundurun: 

app.UseMvc(routes => 

{ 

routes.MapRoute("default", "{controller=Home}/{action=Index}/{id?}"); 

}); 

Aşağıdaki rotayı kullanarak bir eyleme bağlantı oluşturduğunuzu varsayalım: 

var link = Url.Action("ReadPost", "blog", new { id = 17, }); 

IRoutertabanlı yönlendirme ile bu kod, /biog/ReadPost/17 URI 'sini oluşturur ve bu da, belirtilen yol 
değerinin büyük küçük harflerini üretir. ASP.NET Core 2,2 veya sonraki bir sürümde uç nokta 
yönlendirme /Biog/ReadPost/17 (“blog" büyük harfli) oluşturur. Endpoint Routing, bu davranışı 
küresel olarak özelleştirmek veya URL eşleme için farklı kurallar uygulamak üzere kullanılabilecek 
IOutboundParameterTransformer arabirimini sağlar. 

Daha fazla bilgi için bkz. Parameter transformatör başvurusu bölümü. 

• Standart yollarla MVC/Razor Pages tarafından kullanılan bağlantı oluşturma, mevcut olmayan bir 
denetleyiciye/eyleme veya sayfaya bağlantı kurmaya çalışırken farklı şekilde davranır. 










Aşağıdaki varsayılan yol şablonunu göz önünde bulundurun: 


app.UseMvc(routes => 

{ 

routes.MapRoute("default", "{controller=Home}/{action=Index}/{id?}"); 

}); 

Aşağıdaki ile varsayılan şablonu kullanarak bir eyleme bağlantı oluşturduğunuzu varsayalım: 

var link = Url.Action("ReadPost ", "Blog", new { id = 17, }); 

iRouter tabanlı yönlendirme sayesinde, BlogControiler var olmasa veya bir ReadPost Action 
yöntemine sahip olmasa bile sonuç daima /Biog/ReadPost /17 . Beklenen şekilde, işlem yöntemi varsa 
ASP.NET Core 2,2 veya sonraki bir sürümde uç nokta yönlendirmesi /Biog/ReadPost/17 üretir. 
Ancak, uç nokta yönlendirme, eylem yoksa boş bir dize oluşturur. Kavramsal olarak, uç nokta 
yönlendirme, eylem mevcut değilse uç noktanın var olduğunu varsaymaz. 

Bağlantı oluşturma çevresel değeri invalidation algoritmasi , uç nokta yönlendirme ile 
kullanıldığında farklı davranır. 

Çevresel değer invalidation , şu anda yürütülmekte olan isteğin (çevresel değerler) hangi rota 
değerlerinin bağlantı oluşturma işlemlerinde kullanılabileceğini belirleyen algoritmadır. Geleneksel 
yönlendirme, farklı bir eyleme bağlanılırken ek yol değerlerini her zaman geçersiz kıldı. ASP.NET 
Core 2,2 sürümünden önce öznitelik yönlendirmesinde bu davranış yoktu. ASP.NET Core 'nin 
önceki sürümlerinde, aynı yol parametresi adlarını kullanan başka bir eyleme bağlantılar, bağlantı 
oluşturma hatalarıyla sonuçlandı. ASP.NET Core 2,2 veya sonraki sürümlerde, yönlendirme 
biçimlerinin her ikisi de başka bir eyleme bağlanırken değerleri geçersiz kılar. 

AS P.N ET Core 2,1 veya önceki sürümlerde aşağıdaki örneği göz önünde bulundurun. Başka bir 
eyleme (veya başka bir sayfaya) bağlanırken, yol değerleri istenmeyen yollarla yeniden kullanılabilir. 

/Pages/Store/Prod uct.exe: 

@page "{id}" 

@Url.Page("/Login") 

/Pages/Login.exe içinde: 

@page "{id?}" 

URI, ASP.NET Core 2,1 veya önceki sürümlerde /store/Product/ıs , @uri.Page("/Login") tarafından 
Store/lnfo sayfasında oluşturulan bağlantı /Login/ıs . 18 ' in id değeri, bağlantı hedefi 
uygulamanın tamamen farklı bir parçası olsa bile yeniden kullanılır. /Login sayfasının bağlamındaki 
id yol değeri büyük olasılıkla bir depolama ürün KİMLİĞİ değeri değil, bir kullanıcı KİMLİĞİ 
değeridir. 

ASP.NET Core 2,2 veya sonraki bir sürümü ile Endpoint Routing, sonuç /Login . Bağlantılı hedef 
farklı bir eylem veya sayfa olduğunda çevresel değerler yeniden kullanılmaz. 

Gidiş dönüşü yol parametresi sözdizimi: çift yıldız ( ** ) catch-all parametre sözdizimi kullanılırken 
eğik çizgiler kodlanmaz. 

Bağlantı oluşturma sırasında, yönlendirme sistemi, eğik çizgiler dışında bir çift yıldız ( ** ) catch-all 
parametresinde (örneğin, {**myparametername} ) yakalanan değeri kodlar. Çift yıldız yakalama, 


















ASP.NET Core 2,2 veya sonraki sürümlerde iRouter tabanlı yönlendirme ile desteklenir. 

ASP.NET Core ( {*myparametername} ) önceki sürümlerindeki tek yıldız catch-all parametre sözdizimi 
desteklenmeye devam eder ve eğik çizgi kodlandı. 


YOLU 


İLE OLUŞTURULAN BAĞLANTI 

URL.ACTION(NEW { CATEGORY = "ADMIN/PRODUCTS" >) ... 


/search/{*page} /search/admin%2Fproducts (eğik çizgi kodlanmış) 


/search/{**page} /seareh/admin/products 


Ara yazılım örneği 

Aşağıdaki örnekte, bir ara yazılım, mağaza ürünlerini listeleyen bir eylem yöntemine bağlantı oluşturmak 
için LinkGenerator API 'sini kullanır.Ekleme tarafından bir sınıfa olan ve GenerateLink çağıran bağlantı 
Oluşturucuyu kullanmak, bir uygulamadaki herhangi bir sınıfta kullanılabilir. 

using Microsoft.AspNetCore.Routing; 

public elass ProductsLinkMiddleware 
{ 

private readonly LinkGenerator _linkGenerator; 

public ProductsLinkMiddleware(RequestDelegate next, LinkGenerator linkGenerator) 

{ 

_linkGenerator = linkGenerator; 

} 

public async Task InvokeAsync(HttpContext httpContext) 

{ 

var url = _linkGenerator.GetPathByAction("ListProducts", "Store"); 
httpContext.Response.ContentType = "text/plain"; 

await httpContext.Response.WriteAsync($"Go to {url} to see our products."); 

} 

} 

Rotalar oluştur 

Çoğu uygulama, IRouteBuildertammlanan benzer uzantı yöntemlerinden birini veya MapRoute çağırarak 
yollar oluşturur. IRouteBuilder uzantısı yöntemlerinden herhangi biri bir Route örneği oluşturur ve bunu yol 
koleksiyonuna ekler. 

MapRoute yol işleyicisi parametresini kabul etmez. MapRoute, yalnızca DefaultHandlertarafından işlenen 
rotaları ekler. MVC 'de yönlendirme hakkında daha fazla bilgi için bkz. ASP.NET Core denetleyici 
eylemlerine yönlendirme. 

Aşağıdaki kod örneği, tipik bir ASP.NET Core MVC yol tanımı tarafından kullanılan MapRoute çağrısının 
bir örneğidir: 

routes.MapRoute( 

name: "default", 

template: "{controller=Home}/{action=Index}/{id?}"); 

Bu şablon bir URL yoluyla eşleşir ve yol değerlerini ayıklar.Örneğin, yol /Pnoducts/Detaiis /17 şu yol 
değerlerini üretir: { controller = Products, aetion = Details, İd = 17 } . 

Rota değerleri, URL yolunun kesimlere bölünüyor ve rota şablonundaki yol parametresi adı ile her bir 










segmenti eşleştirerek belirlenir. Yol parametreleri olarak adlandırılır. Küme ayraçları içinde parametre adı 
eklenerek tanımlanan parametreler { ... }. 

Yukarıdaki şablon, URL yolu / de eşleştirebilir ve { controiler = Home, action = index } değerler 
üretecektir. Bu, {controiler} ve {action} yol parametrelerinin varsayılan değerleri olduğu ve id Route 
parametresinin isteğe bağlı olduğu için oluşur. Eşittir işareti ( = ), yol parametresi adı parametre için 
varsayılan bir değer tanımladıktan sonra bir değer izler. Yol parametre adından sonra bir soru işareti ( ? ) 
isteğe bağlı bir parametre tanımlar. 

Yol parametreleri varsayılan değer ile her zaman rota değeri oluşturur. Karşılık gelen bir URL yol kesimi 
yoksa isteğe bağlı parametreler yol değeri oluşturmaz. Yol şablonu senaryolarının ve sözdiziminin kapsamlı 
bir açıklaması için yol şablonu başvurusu bölümüne bakın. 

Aşağıdaki örnekte, yol parametresi tanımı {id:int} id Route parametresi için bir yol kısıtlaması 
tanımlıyor: 

routes.MapRoute( 

name: "default", 

template: "{controller=Home}/{action=Index}/{id:int}"); 

Bu şablon /Products/Detaiis/17 gibi bir URL yoluyla eşleşir ancak /Pnoducts/Detaiis/Appies . Yol 
kısıtlamaları IRouteConstraint uygular ve yol değerlerini inceleyerek onları doğrular. Bu örnekte, yol değeri 
id bir tamsayıya dönüştürülebilir olmalıdır. Framework tarafından sunulan yol kısıtlamalarının açıklaması 
için bkz. route-Constraint-Reference . 

MapRoute ek aşırı yüklemeleri constraints , dataTokens ve defauits için değer kabul eder. Bu 
parametrelerin tipik kullanımı, anonim türdeki özellik adlarının yol parametre adlarıyla eşleşen anonim 
olarak yazılmış bir nesneyi geçirmektir. 

Aşağıdaki MapRoute örnekleri eşdeğer yollar oluşturur: 

routes.MapRoute( 

name: "default_route", 

template: "{controller}/{action}/{id?}", 

defauits: new { controiler = "Home", action = "Index" }); 

routes.MapRoute( 

name: "default_route", 

template: "{controller=Home}/{action=Index}/{id?}"); 


TIP 

Kısıtlamaları ve Varsayılanları tanımlamaya yönelik satır içi sözdizimi basit yollar için kullanışlı olabilir. Ancak, satır içi 
sözdizimi tarafından desteklenmeyen veri belirteçleri gibi senaryolar vardır. 


Aşağıdaki örnek birkaç ek senaryoyu göstermektedir: 

routes.MapRoute( 
name: "blog", 

template: "Blog/{**article}", 

defauits: new { controiler = "Blog", action = "ReadArticle" }); 

Önceki şablon /Blog/Aiı-About-Routing/introduction gibi bir URL yoluyla eşleşir ve 

{ controiler = Blog, action = ReadArticle, article = All-About-Routing/Introduction } değerleri ayıklar, 
controiler ve action için varsayılan yol değerleri, şablonda karşılık gelen hiçbir yol parametresi olmasa 















bile yol tarafından üretilir. Varsayılan değerler yol şablonunda belirtilebilir, articie Route parametresi, yol 
parametre adından önce bir çift yıldız işareti ( ** ) görünümüne göre catch-all olarak tanımlanır. Catch-all 
yol parametreleri, URL yolunun kalanını yakalar ve boş dizeyle de aynı olabilir. 


Aşağıdaki örnek yol kısıtlamalarını ve veri belirteçlerini ekler: 

routes.MapRoute( 

name: "us_english_products", 
template: "en-US/Products/{id}", 

defaults: new { controller = "Products", action = "Details" }, 
constraints: new { id = new IntRouteConstraint() }, 
dataTokens: new { locale = "en-US" }); 

Önceki şablon /en-us/Products/5 gibi bir URL yoluyla eşleşir ve 

ve veri belirteçleri { locale = en-us } değerleri 


{ controller = Products, action = Details, id = 5 } 
ayıklar. 
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Yol sınıfı URL 'SI oluşturma 

Route sınıfı, yol değerlerini bir kümesini rota şablonuyla birleştirerek URL oluşturmayı da gerçekleştirebilir. 
Bu, URL yolunu eşleştirmenin mantıksal bir işlemdir. 


TIP 

URL oluşturmayı daha iyi anlamak için, oluşturmak istediğiniz URL 'Yİ düşünün ve sonra bir yönlendirme şablonunun 
bu URL ile nasıl eşleşeceğini düşünün. Hangi değerler üretilemidir? Bu, URL oluşturma 'nın Route sınıfında nasıl 
çalıştığına ilişkin kaba bir eştir. 


Aşağıdaki örnek genel ASP.NET Core MVC varsayılan yolunu kullanır: 


routes.MapRoute( 

name: "default", 

template: "{controller=Home}/{action=Index}/{id?}"); 

Yol değerleri { controller = Products, action = List }, /Products/List U RL 'S I oluşturulur. Yol değerleri, 
URL yolunu biçimlendirmek için karşılık gelen yol parametrelerinin yerine kullanılır, id , isteğe bağlı bir yol 
parametresi olduğundan, id için bir değer olmadan URL başarıyla oluşturulur. 

Yol değerleri { controller = Home, action = index }, / URL 'SI oluşturulur.Belirtilen yol değerleri 
varsayılan değerlerle eşleşir ve varsayılan değerlere karşılık gelen segmentler güvenle atlanır. 















Her iki URL de aşağıdaki yol tanımıyla ( /Home/index ve / ) bir gidiş dönüş, URL oluşturmak için kullanılan 
rota değerlerini oluşturur. 


NOTE 

ASP.NET Core MVC kullanan bir uygulama doğrudan yönlendirmeye çağırmak yerine URL oluşturmak için UrlHelper 
kullanmalıdır. 


URL oluşturma hakkında daha fazla bilgi için URL oluşturma başvurusu bölümüne bakın. 

Yönlendirme ara yazılımı kullanma 

Uygulamanın proje dosyasındaki Microsoft. AspNetCore. app metapackage öğesine başvurun. 
stantup.configureServices ' de hizmet kapsayıcısına yönlendirme ekleyin: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRouting(); 

} 

Yolların startup.configure yönteminde yapılandırılması gerekir. Örnek uygulama aşağıdaki API 'Leri 
kullanır: 

• RouteBuilder 

• MapGet - yalnızca HTTP G ET istekleriyle eşleşir. 

• UseRouter 


var trackPackageRouteHandler = new RouteHandler(context => 

{ 

var routeValues = context.GetRouteData().Values; 
return context.Response.WriteAsync( 

$"Hello! Route values: {string.Toin(", ", routeValues)}"); 

}); 

var routeBuilder = new RouteBuilder(app, trackPackageRouteHandler); 

routeBuilder.MapRoute( 

"Track Package Route", 

"package/{operation:regex( A track|create$)}/{id:int}"); 

routeBuilder.MapGet("hello/{name}", context => 

{ 

var name = context.GetRouteValue("name"); 

// The route handler when HTTP GET "hello/<anything>" matches 
// To match HTTP GET "hello/<anything>/<anything>, 

// use routeBuilder.MapGet("hello/{*name}" 
return context.Response.WriteAsync($"Hi, {name}!"); 

}); 

var routes = routeBuilder.Build(); 
app.UseRouter(routes); 


Aşağıdaki tabloda verilen URI 'Ler ile ilgili yanıtlar gösterilmektedir. 


URI 


YANITIYLA 





URI 


YANITIYLA 


/package/create/3 

Herkese! Rota değerleri: [işlem, oluşturma], [kimlik, 3] 

/package/track/-3 

Herkese! Rota değerleri: [işlem, izleme], [kimlik,-3] 

/package/track/-3/ 

Herkese! Rota değerleri: [işlem, izleme], [kimlik,-3] 

/package/track/ 

istek, eşleşme olmadan üzerinden yapılır. 

GET /hello/Doe 

Merhaba, ali! 

POST /hello/Doe 

istek üzerinden geçer, yalnızca HTTP GET ile eşleşir. 

GET /hello/Doe/Smith 

istek, eşleşme olmadan üzerinden yapılır. 


Çerçeve, yollar oluşturmak için bir genişletme yöntemleri kümesi sağlar 
(RequestDelegateRouteBuilderExtensions): 

• MapDelete 

• MapGet 

• MapMiddlevvareDelete 

• MapMiddlevvareGet 

• MapMiddlevvarePost 

• MapMiddlewarePut 

• MapMiddlevvareRoute 

• MapMiddlewareVerb 

• MapPost 

• MapPut 

• MapRoute 

• MapVerb 

Map[verb] yöntemleri, yöntem adındaki HTTP fiili ile rotayı sınırlandırmak için kısıtlamaları kullanır. 
Örneğin, bkz. MapGet ve MapVerb. 

Rota şablonu başvurusu 

Küme ayraçları içindeki belirteçler ( { ... } ), yol eşleştirildiği takdirde bağlanan Rota parametrelerini 
tanımlar. Bir yol segmentinde birden fazla yol parametresi tanımlayabilirsiniz, ancak bunların bir değişmez 
değer ile ayrılması gerekir. Örneğin, {controiler} ve {action} arasında değişmez değer olmadığından 
{controiier=Home}{action=index} geçerli bir yol değil. Bu rota parametrelerinin bir adı olmalı ve ek 
öznitelikler belirtilmiş olabilir. 

Yol parametreleri dışında (örneğin, {id} ) ve yol ayırıcı / URL içindeki metinle eşleşmesi gerekir. Metin 
eşleştirme, büyük/küçük harfe duyarsızdır ve URL yolunun kodu çözülmüş gösterimine göre yapılır. 
Değişmez değer yol parametresi sınırlayıcısından ( { veya }) eşleştirmek için, karakteri ( {{ veya }} ) 
tekrarlayarak sınırlayıcıdan kaçış. 

isteğe bağlı bir dosya uzantısına sahip bir dosya adı yakalamaya deneyen URL desenlerinin ek konuları 
vardır. Örneğin, fiies/{fiiename}.{ext?} şablonu düşünün. filename ve ext değerlerinin her ikisi de 
varsa, her iki değer de doldurulur. URL'de yalnızca filename için bir değer varsa, bitiş dönemi ( . ) isteğe 
bağlı olduğundan yol eşleşir. Aşağıdaki URL 'Ler bu rota ile eşleşiyor: 


















/files/myFile. 

txt 

/files/myFile 



URI 'nin geri kalanına bağlamak için bir yol parametresinin öneki olarak bir yıldız işareti ( * ) veya çift yıldız 
işareti ( ** ) kullanabilirsiniz. Bunlara catch-all parametreleri denir. Örneğin, biog/{**siug} /blog ile 
başlayan ve ondan sonraki bir değere sahip olan siug yol değerine atanan tüm URI ile eşleşir.Catch-all 
parametreleri boş dizeyle de aynı olabilir. 

Yol ayırıcısı ( / ) karakterleri de dahil olmak üzere bir URL oluşturmak için bir yol kullanıldığında, catch-all 
parametresi uygun karakterleri çıkar. Örneğin yol foo/{*path} rota değerleriyle { path = "my/path" } 
foo/my%2Fpath üretir. Atlanan eğik çizgiye göz önünde edin. Yol ayırıcı karakterlerini geri döndürmek için 
** Route parametresi önekini kullanın. { path = "my/path" } ile yol foo/{**path} foo/my/path üretir. 

Yol parametrelerinin, parametre adından sonra varsayılan değer belirtilerek bir eşittir işareti ( = ) ile 
ayrıldıktan sonra belirlenen varsayılan değerleri olabilir. Örneğin, Home controiler için varsayılan değer 
olarak {controiier=Home} tanımlar. Parametresi için URL 'de hiçbir değer yoksa varsayılan değer kullanılır. 
Yol parametreleri, id? gibi parametre adının sonuna bir soru işareti ( ? ) eklenerek isteğe bağlı olarak 
yapılır, isteğe bağlı değerler ve varsayılan yol parametreleri arasındaki fark, varsayılan değere sahip bir yol 
parametresinin her zaman bir değer ürettiğinden—isteğe bağlı bir parametre yalnızca istek URL 'SI 
tarafından bir değer sağlandığında bir değere sahip olur. 

Rota parametrelerinin URL 'den bağlanan rota değeriyle eşleşmesi gereken kısıtlamaları olabilir.Yol 
parametre adından sonra bir iki nokta üst üste ( : ) ve kısıtlama adının eklenmesi, bir yol parametresi 
üzerinde bir satır içi kısıtlamayı belirtir. Kısıtlama bağımsız değişkenler gerektiriyorsa, kısıtlama adından 
sonra parantez ( (...) ) içine alınır. Birden çok satır içi kısıtlama, başka bir iki nokta ( : ) ve kısıtlama adı 
eklenerek belirtilebilir. 

Kısıtlama adı ve bağımsız değişkenler, URL işlemede kullanılacak bir IRouteConstraint örneği oluşturmak 
için MnlineConstraintResolver hizmetine geçirilir. Örneğin, yol şablonu biog/{articie:miniength(i0)} , 10 
bağımsız değişkeniyle bir minlength kısıtlaması belirtir. Yol kısıtlamaları ve Framevvork tarafından sunulan 
kısıtlamaların bir listesi hakkında daha fazla bilgi için, route kısıtlama başvurusu bölümüne bakın. 

Yol parametrelerinde Ayrıca, bağlantı oluştururken ve URL 'Ler ile eşleşen eylemler ve sayfalar için bir 
parametrenin değerini dönüştüren parametre dönüştürücüler bulunabilir. LIKE kısıtlamaları, yol parametre 
adından sonra iki nokta üst üste ( : ) ve transformatör adı eklenerek, parametre dönüştürücüleri bir rota 
parametresine eklenebilir. Örneğin, yol şablonu biog/{articie:siugify} bir slugify transformatörü 
belirtir. Parametre dönüştürücüler hakkında daha fazla bilgi için bkz. Parameter transformatör başvurusu 
bölümü. 

Aşağıdaki tabloda örnek yol şablonları ve bunların davranışları gösterilmektedir. 

ROTA ŞABLONU ÖRNEK EŞLEŞEN URI İSTEK URI SI... 

hello /hello Yalnızca /hello tek yol ile eşleşir. 


{Page=Home} 


{Page=Home} 


{controller}/{action}/{id?} /Products/List 


/ 

/Contact 



eylemiyle eşlenir. 






























ROTA ŞABLONU 


ÖRNEK EŞLEŞEN URI 


İSTEK URI SI... 


{controller}/{action}/{id?} 


/Products/Details/123 


Products 

denetleyicisi ve 

Details 


eylemine eşlenir (id 123 olarak 
ayarlanır). 


{controller=Home}/{action=Index}/{ic / 


Home denetleyicisi ve 

Index 



yöntemiyle eşlenir ( id 

yok sayılır). 


Bir şablon kullanmak genellikle yönlendirmeye en basit yaklaşımdır. Kısıtlamalar ve varsayılanlar, yol 
şablonu dışında da belirtilebilir. 


TIP 

Route, istekleri eşleştirme gibi yerleşik yönlendirme uygulamalarının nasıl yapıldığını görmek için günlük kaydını 
etkinleştirin. 


Ayrılmış yönlendirme adları 

Aşağıdaki anahtar sözcükler ayrılmış isimlerdir ve yol adları veya parametreler olarak kullanılamaz: 

• action 

• area 

• controller 

• handler 

• page 


Yol kısıtlama başvurusu 

Yol kısıtlamaları, gelen URL 'de bir eşleşme meydana geldiğinde ve URL yolu yol değerlerinde 
simgeleştirilir yürütülür. Rota kısıtlamaları genellikle yol şablonu aracılığıyla ilişkili rota değerini inceler ve 
değerin kabul edilebilir olup olmadığı konusunda bir Evet/Hayır kararı getirir. Bazı rota kısıtlamaları, isteğin 
yönlendirilip yönlendirilmeyeceğini göz önünde bulundurmanız için yol değeri dışındaki verileri kullanır. 
Örneğin HttpMethodRouteConstraint, HTTP fiiline bağlı olarak bir isteği kabul edebilir veya reddedebilir. 
Kısıtlamalar, yönlendirme isteklerinde ve bağlantı oluşturmada kullanılır. 


VVARNING 

Giriş doğrulamasıiçin kısıtlamaları kullanmayın. Giriş doğrulamasıiçin kısıtlamalar kullanılıyorsa, doğru bir hata 
iletisine sahip 400-Bad isteği yerine 404- olmayan bir Yanıt ile geçersiz giriş oluşur. Yol kısıtlamaları, belirli bir rota için 
girdileri doğrulamak üzere değil, benzer yolların belirsizliğini ortadan kaldırmak için kullanılır. 


Aşağıdaki tabloda örnek yol kısıtlamaları ve bunların beklenen davranışları gösterilmektedir. 

KISITLAMA ÖRNEK ÖRNEK EŞLEŞMELER NOTLAR 

int {id: int} 123456789, -123456789 Herhangi bir tamsayıyla 

eşleşir 


bool 


{active:bool} 


true , 

FALSE 


true veya false eşleşir 
(büyük/küçük harfe 
duyarsız) 






















KISITLAMA 


ÖRNEK 


ÖRNEK EŞLEŞMELER 


NOTLAR 


datetime 

{dob:datetime} 

2016-12-31 , 

Geçerli bir DateTime 



2016-12-31 7:32pm 

değeriyle eşleşir (Sabit 


kültür içinde, bkz. uyarı) 


decimal 


{price:decimal} 


49.99 , 

-1,000.01 

Geçerli bir 

decimal 


değeriyle eşleşir (Sabit 
kültür içinde, bkz. uyarı) 


double {weight:double} 


1.234 , 

-1,001.01e8 

Geçerli bir 

double 


değeriyle eşleşir (Sabit 
kültür içinde, bkz. uyarı) 


f loat 


{weight:float} 


1.234 , 

-1,001.01e8 

Geçerli bir 

f loat 


değeriyle eşleşir (Sabit 
kültür içinde, bkz. uyarı) 


guid 

{id:guid} 

CD2C1638-1638-72D5- 

Geçerli bir Guid 



1638-DEADBEEF1638 

eşleşir 


değeriyle 


{CD2C1638-1638-72D5- 

1638-DEADBEEF1638} 


long 


{ticks:long} 


123456789 , -123456789 Geçerli bir long değeriyle 

eşleşir 


minlength(value) 


{username:minlength(4)} 


Rick 


maxlength(value) 


{filename:maxlength(8)} 


Richard 


Dize en az 4 karakter 
olmalıdır 


Dize 8 karakterden uzun 
olmamalıdır 


length(length) 


{filename:length(12)} 

somefile.txt 

Dize tam olarak 12 




karakter uzunluğunda 
olmalıdır 





length(min,max) 


{filename:length(8,16)} 

somefile.txt 

Dize en az 8 ve en fazla 16 


karakter uzunluğunda 
olmalıdır 


min(value) 


{age:min(18)} 


19 


Tamsayı değeri en az 18 
olmalıdır 


max(value) 


{age:max(120)} 


91 


Tamsayı değeri 120 ' ten 
fazla olmamalıdır 


range(min,max) 


{age:range(18,120)} 


91 


Tamsayı değeri en az 18 
olmalı ancak 120 ' ten 
fazla olmamalıdır 


alpha 


{name:alpha} 


Rick 


Dize bir veya daha fazla 
alfabetik karakterden 
oluşmalıdır ( a - z , 
büyük/küçük harfe 
duyarsız) 



















































KISITLAMA 


ÖRNEK 


ÖRNEK EŞLEŞMELER 


NOTLAR 


regex(expression) 


{ssn:regex( A \\d{{3}}- 


123-45-6789 


\\d{{2}}-\\d{{4}}$)} 



Dize, normal ifadeyle 
eşleşmelidir (normal ifade 
tanımlama hakkında 
ipuçlarına bakın) 


required 


{name:required} 


Rick 


URL oluşturma sırasında 
parametre olmayan bir 
değerin mevcut olduğunu 
zorlamak için kullanılır 


Birden çok, iki nokta üst üste sınırlı kısıtlama tek bir parametreye uygulanabilir. Örneğin, aşağıdaki 
kısıtlama bir parametreyi 1 veya daha büyük bir tamsayı değeriyle kısıtlar: 

[Route("users/{id:int:min(l)}")] 
public User GetUserById(int id) { } 


VVARNING 

URL 'Yİ doğrulayan ve bir CLR türüne ( int veya DateTime ) dönüştürülen yol kısıtlamaları her zaman sabit kültürü 
kullanır Bu kısıtlamalar, URL ’nin yerelleştirilemeyen olduğunu varsayar.Framevvork tarafından sunulan yol 
kısıtlamaları, yol değerlerinde depolanan değerleri değiştirmez. URL 'den Ayrıştırılan tüm rota değerleri dizeler olarak 
depolanır. Örneğin, float kısıtlaması yol değerini bir float öğesine dönüştürmeye çalışır, ancak dönüştürülen değer 
yalnızca bir float öğesine dönüştürülebileceğini doğrulamak için kullanılır. 


Normal ifadeler 

ASP.NET Core Framevvork, normal ifade oluşturucusuna 

RegexOptions.IgnoreCase | RegexOptions.Compiled | RegexOptions.CultureInvariant ekler. Bu Üyelerin 
açıklaması için bkz. RegexOptions. 

Normal ifadeler, C# yönlendirme ve dil tarafından kullanılanlarla aynı sınırlayıcıları ve belirteçleri kullanır. 
Normal ifade belirteçlerinin atlanmalıdır. A \d{3}-\d{2}-\d{4}$ normal ifade ' i yönlendirmede kullanmak 
için, ifadede, C# kaynak \ dosyadaki \\ (çift ters eğik çizgi) karakter olarak belirtilen \ (tek ters eğik 
çizgi) karakterlere sahip olması gerekir, karakter (tam dize sabit değerlerikullanmadıkça). Yönlendirme 
parametresi sınırlayıcı karakterlerini ({ , }, [, ]) atlamak için, ifadedeki karakterleri çift ({{ , }, [[ , 
]] ). Aşağıdaki tabloda, bir normal ifade ve kaçan sürümü gösterilmektedir. 

NORMAL İFADE KAÇAN NORMAL İFADE 


A \d{3}-\d{2}-\d{4}$ 


A \\d{{3}}-\\d{{2}}-\\d{{4}}$ 


A [a-z]{2}$ 


A [[a-z]]{{2}}$ 


Yönlendirmelerde kullanılan normal ifadeler, genellikle şapka işareti ( A ) karakteriyle başlar ve dizenin 
başlangıç konumuyla eşleşir. İfadeler genellikle dolar işareti ( $ ) karakteriyle biter ve dizenin sonuyla 
eşleşir. A ve $ karakterler, normal ifadenin tüm yol parametresi değeri ile eşleştiğinden emin olun. A ve 
$ karakterleri olmadan normal ifade, dize içindeki herhangi bir alt dizeden eşleşir ve bu genellikle 
istenmeyen bir ifadedir. Aşağıdaki tabloda örnekler verilmektedir ve bunların eşleşmesinin neden 
eşleşmediği veya eşleşmemesi açıklanmaktadır. 




















İFADE 

DİZE 

EŞLEŞTİRME 

YORUM 

[a-z]{2> 

herkese 

Evet 

Alt dize eşleşmeleri 

[a-z]{2> 

123abc456 

Evet 

Alt dize eşleşmeleri 

[a-z]{2> 

MZ 

Evet 

Eşleşen ifadesi 

[a-z]{2> 

MZ 

Evet 

Büyük/küçük harfe duyarlı 
değil 

A [a-z]{2}$ 

herkese 

Hayır 

Yukarıdaki A ve $ bakın 

A [a-z]{2}$ 

123abc456 

Hayır 

Yukarıdaki A ve $ bakın 


Normal ifade sözdizimi hakkında daha fazla bilgi için bkz. .NET Framevvork normal ifadeler. 

Bir parametreyi bilinen olası değerler kümesiyle kısıtlamak için, normal bir ifade kullanın. Örneğin 


{action:regex( A (list|get|create)$)} , yalnızca 

action 

Route değeri 

üst , 

get veya 

create 


Kısıtlama sözlüğüne geçirilirse dize A (üst|get|create)$ eşdeğerdir. Bilinen kısıtlamalardan biriyle 
eşleşmeyen kısıtlama sözlüğüne (bir şablon içinde satır içi değil) geçirilen kısıtlamalar da normal ifadeler 
olarak kabul edilir. 

Özel yol kısıtlamaları 

Yerleşik yol kısıtlamalarına ek olarak, IRouteConstraint arabirimi uygulayarak özel yol kısıtlamaları 
oluşturulabilir. IRouteConstraint arabirimi, kısıtlama karşılandıysanız true döndüren Match tek bir yöntem 
içerir ve aksi takdirde faise . 

Özel bir IRouteConstraintkullanmak için, yol kısıtlama türü uygulamanın hizmet kapsayıcısında 
uygulamanın ConstraintMap kayıtlı olmalıdır. ConstraintMap, yol kısıtlama anahtarlarını bu kısıtlamaları 
doğrulayan IRouteConstraint uygulamalarla eşleyen bir sözlüktür. Bir uygulamanın ConstraintMap, bir 
hizmetin parçası olarak startup.configureservices güncelleştirilebilen olabilir. AddRouting çağrısı veya 
RouteOptions doğrudan Services.configure<RouteOptions> ile yapılandırma. Örneğin: 

Services.AddRouting(options => 

{ 

options.ConstraintMap.AddC'customName", typeof(MyCustomConstraint)); 

}); 

Kısıtlama daha sonra, kısıtlama türü kaydedilirken belirtilen ad kullanılarak yollara her zamanki şekilde 
uygulanabilir. Örneğin: 

[HttpGet("(id:customName}")] 

public ActionResult<string> Get(string id) 


Parametre transformatörü başvurusu 

Parametre dönüştürücüler: 

• Routeiçin bağlantı oluştururken yürütün. 

• Microsoft.AspNetCore.Routing.IOutboundParameterTransformer uygulayın. 

• ConstraintMapkullanılarak yapılandırılır. 





















• Parametrenin yol değerini alın ve yeni bir dize değerine dönüştürün. 

• Oluşturulan bağlantıda Dönüştürülmüş değerin kullanılmasına neden olacak. 


Örneğin, 

Url.Action(new { article = ' 

’MyTestArticle" }) 

ile 

blog\{article:slugify} 

yol düzeninde özel 

slugify 

parametresi transformatörü 

blog\my-test-article Üretir. 



Bir parametre transformatörü bir yol düzeninde kullanmak için, önce startup.configureServices 
ConstraintMap kullanarak yapılandırın: 

Services. AddRouting(options => 

{ 

// Replace the type and the name used to refer to it with your own 
// IOutboundParameterTransformer implementation 

options.ConstraintMap["slugify"] = typeof(SlugifyParameterTransformer); 

}); 

Parametre dönüştürücüler, bir uç noktanın çözümlediği URI 'yi dönüştürmek için çerçevesi tarafından 
kullanılır. Örneğin, ASP.NET Core MVC, area , controiler , action ve page eşleşecek şekilde kullanılan 
rota değerini dönüştürmek için parametre dönüştürücüler kullanır. 

routes.MapRoute( 

name: "default", 

template: "{controiler:slugify=Home}/{action:slugify=Index}/{id?}"); 

Önceki yol ile eylem SubscriptionManagementController.GetAllO , U RI /subscription-management/get-all ile 
eşleştirilir. Bir parametre transformatörü bir bağlantı oluşturmak için kullanılan rota değerlerini değiştirmez. 
Örneğin, Url.ActionC’GetAll", "SubscriptionManagement") çıkışları /subscription-management/get-all . 

ASP.NET Core, oluşturulan yollarla bir parametre dönüştürücüler kullanmak için API kuralları sağlar: 

• ASP.NET Core MVC 'n İ n Microsoft.AspNetCore.Mvc.ApplicationModels.RouteTokenTransformerConvention 
API kuralı vardır. Bu kural, uygulamadaki tüm öznitelik yollarına belirtilen bir parametre transformatörü 
uygular. Parametre transformatörü, öznitelik yol belirteçlerini değiştirildiklerinde dönüştürür. Daha fazla 
bilgi için bkz. belirteç değişimini özelleştirmek için bir parametre transformatörü kullanma. 

• Razor Pages Microsoft.AspNetCore.Mvc.ApplicationModels.PageRouteTransformerConvention API kuralına 
sahiptir. Bu kural, belirtilen bir parametre transformatörü otomatik olarak keşfedilen Razor Pages 
uygular. Parametre transformatörü Razor Pages yolların klasör ve dosya adı segmentlerini dönüştürür. 
Daha fazla bilgi için bkz. sayfa yollarını özelleştirmek için bir parametre transformatörü kullanma. 

URL oluşturma başvurusu 

Aşağıdaki örnek, yol değerlerinin bir sözlüğü ve bir RouteCollectioniçin bir yol bağlantısının nasıl 
oluşturulacağını gösterir. 



















app.Run(async (context) => 

{ 

var dictionary = new RouteValueDictionary 
{ 

{ "operation", "create" }, 

{ "id", 123} 

}; 

var vpc = new VirtualPathContext(context, null, dictionary, 

"Track Package Route"); 

var path = routes.GetVirtualPath(vpc).VirtualPath; 

context.Response.Contentîype = "text/html"; 
await context.Response.WriteAsync("Menu<hr/>"); 
await context.Response.WriteAsync( 

$"<a href=' {path} ' >Create Package 123</axbr/>"); 

}); 

Yukarıdaki örnek sonunda oluşturulan VirtualPath /package/create /123 . Sözlük, "paket yolunu İzle" 
şablonunun package/{operation}/{id}"operation ve id yol değerlerini sağlar. Ayrıntılar için, yönlendirme 
ara yazılımı kullanma bölümünde veya örnek uygulamadaörnek koda bakın. 

VirtualPathContext oluşturucusunun ikinci parametresi bir ortam c/eğer/er/koleksiyonudur. Ortam 
değerleri, bir geliştiricinin bir istek bağlamı içinde belirtmesi gereken değer sayısını sınırlandırdığından 
kullanım için uygundur. Geçerli isteğin geçerli yol değerleri, bağlantı oluşturma için çevresel değerler olarak 
kabul edilir. ASP.NET Core MVC uygulamasının HomeControiier"About eyleminde,—ortam değeri Home 
index eyleme bağlamak için denetleyici yolu değerini belirtmeniz gerekmez. 

Bir parametreyle eşleşmeyen çevresel değerler yok sayılır. Ayrıca, açıkça sağlanmış bir değer çevresel 
değeri geçersiz kıldığında çevresel değerler de yoksayılır. Eşleştirme, URL 'de soldan sağa doğru gerçekleşir. 

Açık olarak sağlanmış ancak yolun bir segmentiyle eşleşmeyen değerler sorgu dizesine eklenir.Aşağıdaki 
tabloda {controiier}/{action}/{id?} yol şablonu kullanılırken sonuç gösterilmektedir. 


ÇEVRESEL DEĞERLER 

AÇIK DEĞERLER 

SONUÇ 

denetleyici = 

"giriş" 

Action = "hakkında" 

/Home/About 

denetleyici = 

"giriş" 

denetleyici = "Order", Action = 
"hakkında" 

/Order/About 

denetleyici = 

"giriş", renk = "kırmızı" 

Action = "hakkında" 

/Home/About 

denetleyici = 

"giriş" 

Action = "hakkında", color = "Red" 

/Home/About?color=Red 


Bir rotada bir parametreye karşılık gelen bir varsayılan değer varsa ve bu değer açıkça sağlanmışsa, 
varsayılan değerle eşleşmelidir: 



bağlantı oluşturur. 


Karmaşık segmentler 

















Karmaşık segmentler (örneğin [Route("/x{token}y")] ), sabit değerli olmayan değişmez değerler ile sağdan 
sola eşleştirilirken işlenir. Karmaşık segmentlerin nasıl eşleştirileceği hakkında ayrıntılı bir açıklama için bu 
koda bakın. Kod örneği AS P.N ET Core tarafından kullanılmaz, ancak karmaşık segmentler hakkında iyi bir 
açıklama sağlar. 

Uç nokta meta verilerini yapılandırma 

Aşağıdaki bağlantılar, uç nokta meta verilerini yapılandırma hakkında bilgi sağlar: 

• Uç nokta yönlendirme ile CORS 'yi etkinleştirme 

• Özel bir [MinimumAgeAuthorize] özniteliği kullanan lauthorizationpolicyprovider örneği 

• [Yetkilendir] özniteliğiyle test kimlik doğrulaması 

• RequireAuthorization 

• [Yetkilendir] özniteliğiyle düzeni seçme 

• [Yetkilendir] özniteliği kullanılarak ilkeler uygulanıyor 

• ASP.NET Core rol tabanlı yetkilendirme 

RequireHost ile yollarla eşleşen ana bilgisayar 

RequireHost , belirtilen Konağı gerektiren rotaya bir kısıtlama uygular. RequireHost veya [Hoşt] 
parametresi şu olabilir: 

• Ana bilgisayar: www.domain.com (herhangi bir bağlantı noktasıyla www.domain.com eşleşir) 

• Joker karakterle ana bilgisayar: *. domain.com (herhangi bir bağlantı noktasında www.domain.com, 

subdomain.domain.com veya www.subdomain.domain.com eşleşir) 

• Bağlantı noktası: *:5000 (herhangi bir konakla bağlantı noktası 5000 ile eşleşir) 

• Konak ve bağlantı noktası: www. domain.com : 5000 , *. domain.com :50@0 (ana bilgisayar ve bağlantı 
noktasıyla eşleşir) 

RequireHost veya [Hoşt] kullanılarak birden çok parametre belirtilebilir. Kısıtlama, parametrelerden 
herhangi biri için geçerli olan konaklara göre eşleşir. Örneğin, [Host("domain.com" J domain.com")] 
domain.com , www.domain.com veya subdomain.domain.com eşleştirecektir. 

Aşağıdaki kod, rotada belirtilen ana bilgisayarı gerektirmek için RequireHost kullanır: 

public void Configure(IApplicationBuilder app) 

{ 

app.UseRouting(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapGet("/"j context => context.Response.WniteAsync("Hi Contoso!")) 

.RequireHost("contoso.com"); 

endpoints.MapGet("/"j context => context.Response.WriteAsync("Hi AdventureWorks!")) 

.RequireHost("adventure-works.com"); 
endpoints.MapHealthChecks("/healthz").RequireHost("*:8080"); 

}); 

} 

Aşağıdaki kod, denetleyicide belirtilen Konağı gerektirmek için [Hoşt] özniteliğini kullanır: 


















[Host("contoso.com", "adventure-works.com")] 
public class HomeController : Controller 
{ 

private readonly ILogger<HomeController> _logger; 

public HomeController(ILogger<HomeController> logger) 

{ 

_logger = logger; 

} 

public IActionResult Index() 

{ 

return View(); 

} 

[Hoşt ("example.com: 8080")] 
public IActionResult PrivacyO 
{ 

return View(); 

} 

} 

[Hoşt] özniteliği hem denetleyici hem de eylem yöntemine uygulandığında: 

• Eylem üzerindeki özniteliği kullanılır. 

• Denetleyici özniteliği yok sayılır. 

Yönlendirme, istek URI 'Lerini uç noktalarla eşleştirmekten ve gelen istekleri bu uç noktalara gönderen 
sorumludur. Yollar uygulamada tanımlanır ve uygulama başlatıldığında yapılandırılır. Yol, isteğe bağlı olarak 
istekte bulunan URL 'den değerleri ayıklayabilir ve bu değerler, istek işleme için kullanılabilir. Uygulamadan 
yönlendirme bilgilerini kullanarak, yönlendirme, uç noktalarıyla eşlenen URL 'Ler de oluşturabilir. 

ASP.NET Core 2,2 ' de en son yönlendirme senaryolarını kullanmak için startup.configureServices MVC 
Hizmetleri kaydının Uyumluluk sürümünü belirtin: 

Services. AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

EnableEndpointRouting seçeneği, yönlendirmenin, AS P.N ET Core 2,1 veya önceki bir sürümünün uç nokta 
tabanlı mantık veya IRoutertabanlı mantığını dahili olarak kullanması gerektiğini belirler. Uyumluluk 
sürümü 2,2 veya üzeri bir değere ayarlandığında, varsayılan değer true olur. Önceki yönlendirme 
mantığını kullanmak için değeri faise olarak ayarlayın: 

// Use the routing logic of ASP.NET Core 2.1 or earlier: 

Services.AddMvc(options => options.EnableEndpointRouting = faise) 
.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

IRoutertabanlı yönlendirme hakkında daha fazla bilgi için Bu konunun ASP.NET Core 2,1 sürümünebakın. 


IMPORTANT 

Bu belge, alt düzey ASP.NET Core yönlendirmeyi içerir. ASP.NET Core MVC yönlendirme hakkında daha fazla bilgi için 
bkz. ASP.NET Core denetleyici eylemlerine yönlendirme. Razor Pages 'de yönlendirme kuralları hakkında bilgi için bkz. 
ASP.NET Core Razor Pages yol ve uygulama kuralları. 


Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 








Yönlendirme temelleri 


Çoğu uygulama, URL 'Lerin okunabilir ve anlamlı olması için temel ve açıklayıcı bir yönlendirme şeması 
seçmelidir. Varsayılan geleneksel yol {controiier=Home}/{action=index}/{id?} : 

• Temel ve açıklayıcı bir yönlendirme düzenini destekler. 

• , UI tabanlı uygulamalar için kullanışlı bir başlangıç noktasıdır. 

Geliştiriciler, öznitelik yönlendirme veya adanmış geleneksel yollar kullanarak özel durumlarda (örneğin, 
blog ve e-ticaret uç noktaları) bir uygulamanın yüksek trafik bölümlerine daha fazla terse yolu ekler. 

Web API 'Leri, uygulamanın işlevselliğini HTTP fiilleri tarafından temsil edilen bir kaynak kümesi olarak 
modellemek için öznitelik yönlendirmeyi kullanmalıdır. Bu, aynı mantıksal kaynaktaki birçok işlemin 
(örneğin, GET, POST) aynı URL 'Yİ kullanacağı anlamına gelir. Öznitelik yönlendirme, bir API 'nin Genel uç 
nokta yerleşimini dikkatle tasarlamak için gereken bir denetim düzeyi sağlar. 

Razor Pages uygulamalar, bir uygulamanın Sayfalar klasöründe adlandırılmış kaynaklara hizmeti sağlamak 
için varsayılan geleneksel yönlendirmeyi kullanır. Razor Pages yönlendirme davranışını özelleştirmenizi 
sağlayan ek kurallar mevcuttur. Daha fazla bilgi için bkz. ASP.NET Core Razor Pages giriş ve ASP.NET Core 
Razor Pages yol ve uygulama kuralları. 

URL oluşturma desteği, uygulamanın, uygulamayı birbirine bağlamak için sabit kodlama URL 'Leri 
olmadan geliştirilebilmesine izin verir. Bu destek, temel bir yönlendirme yapılandırmasıyla başlayıp 
uygulamanın kaynak düzeni belirlendikten sonra yolların değiştirilmesini sağlar. 

Yönlendirme, bir uygulamadaki mantıksal uç noktaları temsil etmek için uç noktalan ( Endpoint ) kullanır. 

Bir uç nokta, istekleri işlemek için bir temsilci ve rastgele meta veri koleksiyonunu tanımlar. Meta veriler, her 
bir uç noktaya eklenen ilkelere ve yapılandırmaya bağlı olarak çapraz kesme sorunları uygulamak için 
kullanılır. 

Yönlendirme sistemi aşağıdaki özelliklere sahiptir: 

• Yol şablonu sözdizimi, simgeleştirilmiş yol parametrelerine sahip yolları tanımlamak için kullanılır. 

• Geleneksel stil ve öznitelik stili uç nokta yapılandırmasına izin verilir. 

• IRouteConstraint, bir URL parametresinin belirli bir uç nokta kısıtlaması için geçerli bir değer içerip 
içermediğini belirlemekte kullanılır. 

• MVC/Razor Pages gibi uygulama modelleri, yönlendirme senaryolarının öngörülebilir bir 
uygulaması olan tüm uç noktalarını kaydeder. 

• Yönlendirme gerçekleştirme, yönlendirme kararlarını, ara yazılım ardışık düzeninde istediğiniz yere 
getirir. 

• Bir yönlendirme ara yazılımı, belirli bir istek URI 'SI için yönlendirme ara yazılımı uç noktası 
kararının sonucunu inceleyebilir. 

• Uygulamadaki tüm uç noktaları, ara yazılım ardışık düzeninde herhangi bir yerde listelemek 
mümkündür. 

• Bir uygulama, uç nokta bilgilerine göre URL 'Ler oluşturmak için (örneğin, yeniden yönlendirme 
veya bağlantılar için) yönlendirmeyi kullanabilir ve bu sayede bakım yapılmasına yardımcı olan sabit 
kodlanmış URL 'Lerden kaçınabilirsiniz. 

• URL oluşturma, rastgele genişletilebilirliği destekleyen adreslere dayalıdır: 

o Bağlantı Oluşturucu API 'SI (LinkGenerator), bağımlılık ekleme (dı) kullanılarak URL 'ler 
oluşturmak için her yerde çözülebilir. 


o Bağlantı Oluşturucu API 'sinin Dİ aracılığıyla kullanılamadığı durumlarda lUrlHelper URL 'Leri 
derlemek için yöntemler sunar. 


NOTE 

ASP.NET Core 2,2 ' de uç nokta yönlendirme yayını ile, uç nokta bağlama MVC/Razor Pages eylemleri ve sayfaları ile 
sınırlıdır. Uç nokta bağlama yeteneklerinin genişletmeleri, gelecek sürümlerde planlanmaktadır. 


Yönlendirme, RouterMiddlevvare sınıfı tarafından, Ara yazılım ardışık düzenine bağlıdır. ASP.NET Core 
MVC , yapılandırma kapsamında bir ara yazılım ardışık düzenine yönlendirme ekler ve MVC ve Razor 
Pages uygulamalarında yönlendirmeyi işler. Tek başına bileşen olarak yönlendirmeyi nasıl kullanacağınızı 
öğrenmek için yönlendirme ara yazılımı kullanma bölümüne bakın. 

URL eşleştirme 

URL eşleştirme, yönlendirmenin bir uç noktaya gelen isteği gönderdiği işlemdir. Bu işlem, URL yolundaki 
verileri temel alır, ancak istekteki verileri göz önünde bulundurmanız için genişletilebilir. Ayrı işleyicilere 
istek gönderme özelliği, bir uygulamanın boyutunu ve karmaşıklığını ölçeklendirmeye yönelik anahtardır. 

Uç nokta yönlendirmesinde yönlendirme sistemi tüm gönderme kararlarından sorumludur.Ara yazılım, 
seçili uç noktaya göre ilkeler uyguladığı için, yönlendirme sisteminde güvenlik ilkelerinin dağıtımını 
etkileyebilecek veya uygulamanın uygulanmasını etkileyebilecek herhangi bir kararın olması önemlidir. 

Uç nokta temsilcisi yürütüldüğünde, Routecontext. RouteData özellikleri, bu nedenle yapılan istek işlemeye 
bağlı olarak uygun değerlere ayarlanır. 

RouteData. Values , rotada oluşturulanyo /değerlerinin bir sözlüğüdür. Bu değerler genellikle URL 'Yİ 
simgeleştirerek belirlenir ve Kullanıcı girişini kabul etmek ya da uygulama içinde daha fazla kararlar almak 
için kullanılabilir. 

RouteData. DataTokens , eşleşen rotayla ilgili ek verilerin bir özellik çantadır. DataTokens, uygulamanın 
hangi yolun eşleştiğini temel alarak kararlar verebilmesi için durum verilerinin her bir rota ile 
ilişkilendirilmesini desteklemek amacıyla sağlanır. Bu değerler, geliştirici tarafından tanımlanır ve 
yönlendirme davranışını herhangi bir şekilde etkilemez. Ayrıca, RouteData. DataTokens içinde bulunan 
değerler her türlü türden olabilir. Bu, veridizeleri arasında dönüştürülebilir olmalıdır. 

RouteData. yönlendiriciler , isteği başarıyla eşleştirirken geçen yolların bir listesidir. Yollar bir diğerinin 
içinde iç içe olabilir. Routers özelliği, bir eşleşme ile sonuçlanan yolların mantıksal ağacı aracılığıyla yolu 
yansıtır. Genellikle, Routers ilk öğe yol koleksiyonudur ve URL oluşturma için kullanılmalıdır. Routers son 
öğe, eşleşen yol işleyicisidir. 

LinkGenerator ile URL oluşturma 

URL oluşturma, yönlendirmenin bir yol değerleri kümesine göre bir URL yolu oluşturabileceği işlemdir.Bu, 
uç noktalarınız ve bunlara erişen URL 'Ler arasında mantıksal bir ayrım sağlar. 

Uç nokta yönlendirme bağlantı Oluşturucu API 'sini (LinkGenerator) içerir. LinkGenerator, Dİ 'dan 
alınabilecek bir tek hizmettir. API, yürütülen bir istek bağlamı dışında kullanılabilir.MVC 'nin Etiket 
Yardımcıları, HTML Yardımcıları ve eylem sonuçlarıgibi lUrlHelperkullanan lUrlHelper ve senaryoları, 
bağlantı oluşturma yetenekleri sağlamak için bağlantı oluşturucuyu kullanır. 

Bağlantı Oluşturucu, bir Adres ve Adres şemo/onkavramıyla desteklenir. Adres şeması, bağlantı oluşturma 
için göz önünde bulundurmanız gereken uç noktaları belirlemenin bir yoludur. Örneğin, çok sayıda 
kullanıcının yol adı ve yol değerleri senaryoları, MVC/Razor Pages tarafından tanıdık bir adres düzeni 
olarak uygulanır. 

Bağlantı Oluşturucu, aşağıdaki genişletme yöntemleri aracılığıyla MVC/Razor Pages eylemlerine ve 
sayfalarına bağlanabilir: 







• GetPathByAction 

• GetUriByAction 

• GetPathByPage 

• GetUriByPage 

Bu yöntemlerin aşırı yüklemesi HttpContext içeren bağımsız değişkenleri kabul eder. Bu yöntemler 
url.Action ve url.Page işlevsel olarak eşdeğerdir ancak ek esneklik ve seçenekler sunar. 

GetPath* yöntemleri, url.Action ve url.Page , mutlak bir yol içeren bir URI oluşturmak için en çok 
benzerdir. Geturi* Yöntemler her zaman bir düzen ve konak içeren mutlak bir URI oluşturur.Bir 
HttpContext kabul eden yöntemler, yürütülmekte olan istek bağlamında bir URI oluşturur.Ortam yolu 
değerleri, URL taban yolu, şeması ve yürütülen istekten ana bilgisayar, geçersiz kılınmadıkça kullanılır. 

LinkGenerator bir adresle çağrılır. URI oluşturma iki adımda gerçekleşir: 

1. Adres, adresle eşleşen bir uç nokta listesine bağlanır. 

2. Her uç noktanın RoutePattern , sağlanan değerlerle eşleşen bir rota deseninin bulunana kadar 
değerlendirilir. Elde edilen çıktı, bağlantı oluşturucuya sağlanan diğer URI parçalarıyla birleştirilir ve 
döndürülür. 

LinkGenerator tarafından sunulan yöntemler, herhangi bir tür adresin standart bağlantı oluşturma 
özelliklerini destekler. Bağlantı oluşturucuyu kullanmanın en kolay yolu, belirli bir adres türü için işlem 
gerçekleştiren genişletme yöntemlerine yöneliktir. 

GENİŞLETME YÖNTEMİ AÇIKLAMA 


GetPathByAddress 


Belirtilen değerleri temel alarak mutlak bir yola sahip bir 
URI oluşturur. 


GetUriByAddress 


Belirtilen değerleri temel alarak mutlak bir URI oluşturur. 


VVARNING 

LinkGenerator yöntemlerinin çağrılmasının aşağıdaki etkilerine dikkat edin: 

• Gelen isteklerin Hoşt üstbilgisini doğrulayan bir uygulama yapılandırmasında Geturi* uzantısı 
yöntemlerini dikkatle kullanın. Gelen isteklerin Hoşt üstbilgisi doğrulandıktan sonra, güvenilir olmayan istek 
girişi, bir görünüm/sayfada URI 'Ler halinde istemciye geri gönderilebilir. Tüm üretim uygulamalarının, Hoşt 
üst bilgisini bilinen geçerli değerlere karşı doğrulamak için kendi sunucusunu yapılandırmasını öneririz. 

• Map veya Mapwhen birlikte ara yazılım ile birlikte LinkGenerator kullanın. Map* , yürütülen isteğin temel 
yolunu değiştirir ve bu da bağlantı oluşturma çıktısını etkiler. Tüm LinkGenerator API 'Leri temel yol 
belirtmeye izin verir. Map* bağlantı oluşturmada etkilerini geri almak için her zaman boş bir temel yol belirtin. 


Yönlendirmenin önceki sürümlerinden farklılıklar 

ASP.NET Core 2,2 veya üzeri ve daha önceki yönlendirme sürümlerindeki ASP.NET Core uç nokta 
yönlendirmesi arasında birkaç fark vardır: 

• Uç nokta yönlendirme sistemi, Routedevralma dahil IRoutertabanlı genişletilebilirliği desteklemez. 

• Uç nokta yönlendirme VVebApiCompatShimdesteklemez. Uyumluluk Shim 'yi kullanmaya devam 
etmek için 2,1 Uyumluluk sürümünü ( .SetCompatibilityVersion(CompatibilityVersion.Version_2_l) ) 
kullanın. 

• Uç nokta yönlendirmesinde, geleneksel yollar kullanılırken oluşturulan URI 1 lerin büyük küçük 















harfleri için farklı davranış vardır. 


Aşağıdaki varsayılan yol şablonunu göz önünde bulundurun: 

app.UseMvc(routes => 

{ 

routes.MapRoute("default", "{controller=Home}/{action=Index}/{id?}"); 

}); 

Aşağıdaki rotayı kullanarak bir eyleme bağlantı oluşturduğunuzu varsayalım: 

var link = Url.Action("ReadPost", "blog", new { id = 17, }); 

IRoutertabanlı yönlendirme ile bu kod, /biog/ReadPost/17 URI 'sini oluşturur ve bu da, belirtilen yol 
değerinin büyük küçük harflerini üretir. ASP.NET Core 2,2 veya sonraki bir sürümde uç nokta 
yönlendirme /Biog/ReadPost /17 ("blog" büyük harfli) oluşturur. Endpoint Routing, bu davranışı 
küresel olarak özelleştirmek veya URL eşleme için farklı kurallar uygulamak üzere kullanılabilecek 
IOutboundParameterTransformer arabirimini sağlar. 

Daha fazla bilgi için bkz. Parameter transformatör başvurusu bölümü. 

• Standart yollarla MVC/Razor Pages tarafından kullanılan bağlantı oluşturma, mevcut olmayan bir 
denetleyiciye/eyleme veya sayfaya bağlantı kurmaya çalışırken farklı şekilde davranır. 

Aşağıdaki varsayılan yol şablonunu göz önünde bulundurun: 

app.UseMvc(routes => 

{ 

routes.MapRoute("default", "{controller'=Home}/{actlon=Index}/{id?}"); 

}); 

Aşağıdaki ile varsayılan şablonu kullanarak bir eyleme bağlantı oluşturduğunuzu varsayalım: 

var link = Url.Action("ReadPost", "Blog", new { id = 17, }); 

iRouter tabanlı yönlendirme sayesinde, BlogControiler var olmasa veya bir ReadPost Action 
yöntemine sahip olmasa bile sonuç daima /Biog/ReadPost/17 . Beklenen şekilde, işlem yöntemi varsa 
ASP.NET Core 2,2 veya sonraki bir sürümde uç nokta yönlendirmesi /Biog/ReadPost/i7 üretir. 
Ancak, uç nokta yönlendirme, eylem yoksa boş bir dize oluşturur. Kavramsal olarak, uç nokta 
yönlendirme, eylem mevcut değilse uç noktanın var olduğunu varsaymaz. 

• Bağlantı oluşturma çevresel değeri invalidation algoritması , uç nokta yönlendirme ile 
kullanıldığında farklı davranır. 

Çevresel değer invalidation , şu anda yürütülmekte olan isteğin (çevresel değerler) hangi rota 
değerlerinin bağlantı oluşturma işlemlerinde kullanılabileceğini belirleyen algoritmadır. Geleneksel 
yönlendirme, farklı bir eyleme bağlanılırken ek yol değerlerini her zaman geçersiz kıldı. ASP.NET 
Core 2,2 sürümünden önce öznitelik yönlendirmesinde bu davranış yoktu. AS P.N ET Core 'nin 
önceki sürümlerinde, aynı yol parametresi adlarını kullanan başka bir eyleme bağlantılar, bağlantı 
oluşturma hatalarıyla sonuçlandı. AS P.N ET Core 2,2 veya sonraki sürümlerde, yönlendirme 
biçimlerinin her ikisi de başka bir eyleme bağlanırken değerleri geçersiz kılar. 

AS P.N ET Core 2,1 veya önceki sürümlerde aşağıdaki örneği göz önünde bulundurun. Başka bir 
eyleme (veya başka bir sayfaya) bağlanırken, yol değerleri istenmeyen yollarla yeniden kullanılabilir. 














/Pages/Store/P roduct.exe: 


@page "{id}" 

@Url.Page("/Login") 

/P a ges/Lo gin.exe içinde: 

@page "{id?}" 

URI, ASP.NET Core 2,1 veya önceki sürümlerde /store/Product/ıs , @uri.Page("/Login") tarafından 
Store/lnfo sayfasında oluşturulan bağlantı /Login/ıs . 18 1 in id değeri, bağlantı hedefi 
uygulamanın tamamen farklı bir parçası olsa bile yeniden kullanılır. /Login sayfasının bağlamındaki 
id yol değeri büyük olasılıkla bir depolama ürün KİMLİĞİ değeri değil, bir kullanıcı KİMLİĞİ 
değeridir. 

ASP.NET Core 2,2 veya sonraki bir sürümü ile Endpoint Routing, sonuç /Login . Bağlantılı hedef 
farklı bir eylem veya sayfa olduğunda çevresel değerler yeniden kullanılmaz. 

• Gidiş dönüşü yol parametresi sözdizimi: çift yıldız ( ** ) catch-all parametre sözdizimi kullanılırken 
eğik çizgiler kodlanmaz. 

Bağlantı oluşturma sırasında, yönlendirme sistemi, eğik çizgiler dışında bir çift yıldız ( ** ) catch-all 
parametresinde (örneğin, {**myparametername} ) yakalanan değeri kodlar.Çift yıldız yakalama, 
ASP.NET Core 2,2 veya sonraki sürümlerde iRouter tabanlı yönlendirme ile desteklenir. 

ASP.NET Core ( {*myparametername} ) önceki sürümlerindeki tek yıldız catch-all parametre sözdizimi 
desteklenmeye devam eder ve eğik çizgi kodlandı. 


YOLU 


İLE OLUŞTURULAN BAĞLANTI 

URL.ACTION(NEW { CATEGORY = "ADMIN/PRODUCTS" }) ... 


/search/{*page} 


/search/admin%2Fproducts (eğik çizgi kodlanmış) 



/search/{**page} 


/search/admin/products 


Ara yazılım örneği 

Aşağıdaki örnekte, bir ara yazılım, mağaza ürünlerini listeleyen bir eylem yöntemine bağlantı oluşturmak 
için LinkGenerator API 'sini kullanır.Ekleme tarafından bir sınıfa olan ve GenerateLink çağıran bağlantı 
Oluşturucuyu kullanmak, bir uygulamadaki herhangi bir sınıfta kullanılabilir. 















using Microsoft.AspNetCore.Routing; 

public class ProductsLinkMiddleware 
{ 

private readonly LinkGenerator _linkGenerator; 

public ProductsLinkMiddleware(RequestDelegate next, LinkGenerator linkGenerator) 

{ 

_linkGenerator = linkGenerator; 

} 

public async Task InvokeAsync(HttpContext httpContext) 

{ 

var url = _linkGenerator.GetPathByAction("ListProducts"j "Store"); 
httpContext.Response.ContentType = "text/plain"; 

await httpContext.Response.WriteAsync($"Go to {url} to see our products."); 

} 

} 

Rotalar oluştur 

Çoğu uygulama, IRouteBuildertammlanan benzer uzantı yöntemlerinden birini veya MapRoute çağırarak 
yollar oluşturur. IRouteBuilder uzantısı yöntemlerinden herhangi biri bir Route örneği oluşturur ve bunu yol 
koleksiyonuna ekler. 

MapRoute yol işleyicisi parametresini kabul etmez. MapRoute, yalnızca DefaultHandlertarafından işlenen 
rotaları ekler. MVC 'de yönlendirme hakkında daha fazla bilgi için bkz. ASP.NET Core denetleyici 
eylemlerine yönlendirme. 

Aşağıdaki kod örneği, tipik bir ASP.NET Core MVC yol tanımı tarafından kullanılan MapRoute çağrısının 
bir örneğidir: 

routes.MapRoute( 

name: "default", 

template: "{controller=Home}/{action=Index}/{id?}"); 

Bu şablon bir URL yoluyla eşleşir ve yol değerlerini ayıklar.Örneğin, yol /Pnoducts/Detaiis/17 şu yol 
değerlerini üretir: { controller = Products, action = Details, İd = 17 } . 

Rota değerleri, URL yolunun kesimlere bölünüyor ve rota şablonundaki yol parametresi adı ile her bir 
segmenti eşleştirerek belirlenir. Yol parametreleri olarak adlandırılır. Küme ayraçları içinde parametre adı 
eklenerek tanımlanan parametreler { ... }. 

Yukarıdaki şablon, URL yolu / de eşleştirebilir ve { controller = Home, action = index } değerler 
üretecektir. Bu, {controller} ve {action} yol parametrelerinin varsayılan değerleri olduğu ve id Route 
parametresinin isteğe bağlı olduğu için oluşur. Eşittir işareti ( = ), yol parametresi adı parametre için 
varsayılan bir değer tanımladıktan sonra bir değer izler. Yol parametre adından sonra bir soru işareti ( ? ) 
isteğe bağlı bir parametre tanımlar. 

Yol parametreleri varsayılan değer ile her zaman rota değeri oluşturur. Karşılık gelen bir URL yol kesimi 
yoksa isteğe bağlı parametreler yol değeri oluşturmaz. Yol şablonu senaryolarının ve sözdiziminin kapsamlı 
bir açıklaması için yol şablonu başvurusu bölümüne bakın. 

Aşağıdaki örnekte, yol parametresi tanımı {id:int} id Route parametresi için bir yol kısıtlaması 
tanımlıyor: 








routes.MapRoute( 

name: "default", 

template: "{controller=Home}/{action=Index}/{id:int}"); 

Bu şablon /Pnoducts/Detaiis/17 gibi bir URL yoluyla eşleşir ancak /Products/Details/Appies . Yol 
kısıtlamaları IRouteConstraint uygular ve yol değerlerini inceleyerek onları doğrular. Bu örnekte, yol değeri 
id bir tamsayıya dönüştürülebilir olmalıdır. Framework tarafından sunulan yol kısıtlamalarının açıklaması 
için bkz. route-Constraint-Reference . 

MapRoute ek aşırı yüklemeleri constraints , dataTokens ve defaults için değer kabul eder. Bu 
parametrelerin tipik kullanımı, anonim türdeki özellik adlarının yol parametre adlarıyla eşleşen anonim 
olarak yazılmış bir nesneyi geçirmektir. 

Aşağıdaki MapRoute örnekleri eşdeğer yollar oluşturur: 

routes.MapRoute( 

name: "default_route", 

template: "{controller}/{action}/{id?}", 

defaults: new { controller = "Home", action = "Index" }); 


routes.MapRoute( 

name: "default_noute", 

template: "{controller=Home}/{action=Index}/{id?}"); 



routes.MapRoute( 
name: "blog", 

template: "Blog/{**article}", 

defaults: new { controller = "Blog", action = "ReadArticle" }); 

Önceki şablon /Blog/Aiı-About-Routing/introduction gibi bir URL yoluyla eşleşir ve 
{ controller = Blog, action = ReadArticle, article = All-About-Routing/Introduction } değerleri ayıklar, 
controller ve action için varsayılan yol değerleri, şablonda karşılık gelen hiçbir yol parametresi olmasa 
bile yol tarafından üretilir. Varsayılan değerler yol şablonunda belirtilebilir, article Route parametresi, yol 
parametre adından önce bir çift yıldız işareti ( ** ) görünümüne göre catch-all olarak tanımlanır. Catch-all 
yol parametreleri, URL yolunun kalanını yakalar ve boş dizeyle de aynı olabilir. 

Aşağıdaki örnek yol kısıtlamalarını ve veri belirteçlerini ekler: 

routes.MapRoute( 

name: "us_english_products", 
template: "en-US/Products/{id}", 

defaults: new { controller = "Products", action = "Details" }, 
constraints: new { id = new IntRouteConstraint() }, 
dataTokens: new { locale = "en-US" }); 


Önceki şablon 

/en-US/Products/5 

gibi bir URL yoluyla eşleşir ve 



{ controller = 

Products, action = 

= Details, id = 5 } 

ve veri belirteçleri 

{ locale = en-us } değerleri 
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{Microsoft.AspNetCore.Routing.RouteValueDictionary} 

Microsot 
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{System.OrdinalComparer} 

System.C 
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a A> Keys 

{string[1]} 

System.C 
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{object[1]} 

System.C 
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object{s 
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> 0 ResultsVievv 

Expanding the Results View will enumerate the lEnumerable 



■a A' Routers 

Count = 3 

System.C 


> 9 [0] 

{Microsoft.AspNetCore.Routing.RouteCollection} 

Microsol 


> * m 

{en-US/Products/{id}} 

Microsot 


> O [2] 

{Microsoft.AspNetCore.Mvc.Internal.MvcRouteHandler} 

Microsot 


Output Autos Watch 1 


Yol sınıfı URL 'SI oluşturma 

Route sınıfı, yol değerlerini bir kümesini rota şablonuyla birleştirerek URL oluşturmayı da gerçekleştirebilir. 
Bu, URL yolunu eşleştirmenin mantıksal bir işlemdir. 


TIP 

URL oluşturmayı daha iyi anlamak için, oluşturmak istediğiniz URL 'Yİ düşünün ve sonra bir yönlendirme şablonunun 
bu URL ile nasıl eşleşeceğini düşünün. Hangi değerler üretilemidir? Bu, URL oluşturma 'nın Route sınıfında nasıl 
çalıştığına ilişkin kaba bir eştir. 


Aşağıdaki örnek genel ASP.NET Core MVC varsayılan yolunu kullanır: 

routes.MapRoute( 

name: "default", 

template: "{controller=Home}/{action=Index}/{id?}"); 

Yol değerleri { controller = Products, action = List }, /Products/List U RL 'S I oluşturulur. Yol değerleri, 
URL yolunu biçimlendirmek için karşılık gelen yol parametrelerinin yerine kullanılır, id , isteğe bağlı bir yol 
parametresi olduğundan, id için bir değer olmadan URL başarıyla oluşturulur. 

Yol değerleri { controller = Home, action = index }, / URL 'SI oluşturulur.Belirtilen yol değerleri 
varsayılan değerlerle eşleşir ve varsayılan değerlere karşılık gelen segmentler güvenle atlanır. 

Her iki URL de aşağıdaki yol tanımıyla ( /Home/index ve / ) bir gidiş dönüş, URL oluşturmak için kullanılan 
rota değerlerini oluşturur. 


NOTE 

ASP.NET Core MVC kullanan bir uygulama doğrudan yönlendirmeye çağırmak yerine URL oluşturmak için UrlHelper 
kullanmalıdır. 


URL oluşturma hakkında daha fazla bilgi için URL oluşturma başvurusu bölümüne bakın. 

Yönlendirme ara yazılımı kullanma 


Uygulamanın proje dosyasındaki Microsoft. AspNetCore. app metapackage öğesine başvurun. 














startup.configureServices ' de hizmet kapsayıcısına yönlendirme ekleyin: 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRouting(); 

} 

Yolların startup.configure yönteminde yapılandırılması gerekir. Örnek uygulama aşağıdaki API 'Leri 
kullanır: 

• RouteBuilder 

• MapGet-yalnızca HTTP GET istekleriyle eşleşir. 

• UseRouter 


var trackPackageRouteHandler = new RouteHandler(context => 

{ 

var routeValues = context.GetRouteData().Values; 
return context.Response.WriteAsync( 

$"Hello! Route values: {string.3oin(", ", routeValues)}"); 

}); 

var routeBuilder = new RouteBuilder(app, trackPackageRouteHandler); 

routeBuilder.MapRoute( 

"Track Package Route", 

"package/{operation:regex( A track|create$)}/{id:int}"); 

routeBuilder.MapGet("hello/{name}", context => 

{ 

var name = context.GetRouteValue("name"); 

// The route handler when HTTP GET "hello/<anything>" matches 
// To match HTTP GET "hello/<anything>/<anything>, 

// use routeBuilder.MapGet("hello/{*name}" 
return context.Response.WriteAsync($"Hi, {name}!"); 

}); 

var routes = routeBuilder.Build(); 
app.UseRouter(routes); 


Aşağıdaki tabloda verilen URI 'Ler ile ilgili yanıtlar gösterilmektedir. 

URI YANITIYLA 


/package/create/3 


Herkese! Rota değerleri: [işlem, oluşturma], [kimlik, 3] 


/package/track/-3 


Herkese! Rota değerleri: [işlem, izleme], [kimlik,-3] 


/package/track/-3/ 


Herkese! Rota değerleri: [işlem, izleme], [kimlik,-3] 


/package/track/ 


istek, eşleşme olmadan üzerinden yapılır. 


GET /hello/3oe 


Merhaba, ali! 


POST /hello/Doe 


istek üzerinden geçer, yalnızca HTTP GET ile eşleşir. 


GET /hello/3oe/Snıith 


istek, eşleşme olmadan üzerinden yapılır. 











Çerçeve, yollar oluşturmak için bir genişletme yöntemleri kümesi sağlar 
(RequestDelegateRouteBuilderExtensions): 

• MapDelete 

• MapGet 

• MapMiddlevvareDelete 

• MapMiddlevvareGet 

• MapMiddlewarePost 

• MapMiddlevvarePut 

• MapMiddlewareRoute 

• MapMiddlevvareVerb 

• MapPost 

• MapPut 

• MapRoute 

• MapVerb 

Map[verb] yöntemleri, yöntem adındaki HTTP fiili ile rotayı sınırlandırmak için kısıtlamaları kullanır. 
Örneğin, bkz. MapGet ve MapVerb. 

Rota şablonu başvurusu 

Küme ayraçları içindeki belirteçler ( { ... } ), yol eşleştirildiği takdirde bağlanan Rota parametrelerini 
tanımlar. Bir yol segmentinde birden fazla yol parametresi tanımlayabilirsiniz, ancak bunların bir değişmez 
değer ile ayrılması gerekir. Örneğin, {controiler} ve {action} arasında değişmez değer olmadığından 
{controiier=Home}{action=index} geçerli bir yol değil. Bu rota parametrelerinin bir adı olmalı ve ek 
öznitelikler belirtilmiş olabilir. 

Yol parametreleri dışında (örneğin, {id} ) ve yol ayırıcı / URL içindeki metinle eşleşmesi gerekir.Metin 
eşleştirme, büyük/küçük harfe duyarsızdır ve URL yolunun kodu çözülmüş gösterimine göre yapılır. 
Değişmez değer yol parametresi sınırlayıcısından ( { veya }) eşleştirmek için, karakteri ( {{ veya }} ) 
tekrarlayarak sınırlayıcıdan kaçış. 

isteğe bağlı bir dosya uzantısına sahip bir dosya adı yakalamaya deneyen URL desenlerinin ek konuları 
vardır. Örneğin, fiies/{fiiename}.{ext?} şablonu düşünün, filename ve ext değerlerinin her ikisi de 
varsa, her iki değer de doldurulur. URL'de yalnızca filename için bir değer varsa, bitiş dönemi ( . ) isteğe 
bağlı olduğundan yol eşleşir. Aşağıdaki URL 'Ler bu rota ile eşleşiyor: 


/files/myFile. 

txt 

/files/myFile 



URI 'nin geri kalanına bağlamak için bir yol parametresinin öneki olarak bir yıldız işareti ( * ) veya çift yıldız 
işareti ( ** ) kullanabilirsiniz. Bunlara catch-all parametreleri denir. Örneğin, biog/{**siug} /blog ile 
başlayan ve ondan sonraki bir değere sahip olan siug yol değerine atanan tüm URI ile eşleşir.Catch-all 
parametreleri boş dizeyle de aynı olabilir. 

Yol ayırıcısı ( / ) karakterleri de dahil olmak üzere bir URL oluşturmak için bir yol kullanıldığında, catch-all 
parametresi uygun karakterleri çıkar. Örneğin yol foo/{*path} rota değerleriyle { path = "my/path" } 
foo/my% 2 Fpath üretir. Atlanan eğik çizgiye göz önünde edin. Yol ayırıcı karakterlerini geri döndürmek için 
** Route parametresi önekini kullanın. { path = "my/path" } ile yol foo/{**path} foo/my/path üretir. 

Yol parametrelerinin, parametre adından sonra varsayılan değer belirtilerek bir eşittir işareti ( = ) ile 
ayrıldıktan sonra belirlenen varsayılan değerleri olabilir. Örneğin, Home controiler için varsayılan değer 
olarak {controiier=Home} tanımlar. Parametresi için URL 'de hiçbir değer yoksa varsayılan değer kullanılır. 






















Yol parametreleri, id? gibi parametre adının sonuna bir soru işareti ( ? ) eklenerek isteğe bağlı olarak 
yapılır, isteğe bağlı değerler ve varsayılan yol parametreleri arasındaki fark, varsayılan değere sahip bir yol 
parametresinin her zaman bir değer ürettiğinden—isteğe bağlı bir parametre yalnızca istek URL 'SI 
tarafından bir değer sağlandığında bir değere sahip olur. 

Rota parametrelerinin URL 'den bağlanan rota değeriyle eşleşmesi gereken kısıtlamaları olabilir.Yol 
parametre adından sonra bir iki nokta üst üste ( : ) ve kısıtlama adının eklenmesi, bir yol parametresi 
üzerinde bir satır içi kısıtlamayı belirtir. Kısıtlama bağımsız değişkenler gerektiriyorsa, kısıtlama adından 
sonra parantez ( (...) ) içine alınır. Birden çok satır içi kısıtlama, başka bir iki nokta ( : ) ve kısıtlama adı 
eklenerek belirtilebilir. 

Kısıtlama adı ve bağımsız değişkenler, URL işlemede kullanılacak bir IRouteConstraint örneği oluşturmak 
için HnlineConstraintResolver hizmetine geçirilir. Örneğin, yol şablonu biog/{articie:miniength(i0)} , 10 
bağımsız değişkeniyle bir minlength kısıtlaması belirtir. Yol kısıtlamaları ve Framevvork tarafından sunulan 
kısıtlamaların bir listesi hakkında daha fazla bilgi için, route kısıtlama başvurusu bölümüne bakın. 

Yol parametrelerinde Ayrıca, bağlantı oluştururken ve URL 'Ler ile eşleşen eylemler ve sayfalar için bir 
parametrenin değerini dönüştüren parametre dönüştürücüler bulunabilir. LIKE kısıtlamaları, yol parametre 
adından sonra iki nokta üst üste ( : ) ve transformatör adı eklenerek, parametre dönüştürücüleri bir rota 
parametresine eklenebilir. Örneğin, yol şablonu biog/{articie:siugify} bir slugify transformatörü 
belirtir. Parametre dönüştürücüler hakkında daha fazla bilgi için bkz. Parameter transformatör başvurusu 
bölümü. 

Aşağıdaki tabloda örnek yol şablonları ve bunların davranışları gösterilmektedir. 

ROTA ŞABLONU ÖRNEK EŞLEŞEN URI İSTEK URI SI... 


hello 

/hello 

Yalnızca /hello tek yol ile eşleşir. 

{Page=Home} 


/ 

Home' Page eşleşir ve ayarlar. 






{Page=Home} 


/Contact 

Contact''Page 

eşleşir ve ayarlar. 


{controller}/{action}/{id?} 


/Products/List 


Products 

denetleyicisi ve 

List 


eylemiyle eşlenir. 


{controller}/{action}/{id?} 


/Products/Details/123 


Products 

denetleyicisi ve 

Details 


eylemine eşlenir (id 123 olarak 
ayarlanır). 


{controller=Home}/{action=Index}/{ic / 


Home 

denetleyicisi ve 

Index 


yöntemiyle eşlenir ( id yok sayılır). 

Bir şablon kullanmak genellikle yönlendirmeye en basit yaklaşımdır. Kısıtlamalar ve varsayılanlar, yol 
şablonu dışında da belirtilebilir. 


TIP 

Route, istekleri eşleştirme gibi yerleşik yönlendirme uygulamalarının nasıl yapıldığını görmek için günlük kaydını 
etkinleştirin. 


Ayrılmış yönlendirme adları 


Aşağıdaki anahtar sözcükler ayrılmış isimlerdir ve yol adları veya parametreler olarak kullanılamaz: 































action 

area 

controller 

handler 

page 


Yol kısıtlama başvurusu 

Yol kısıtlamaları, gelen URL 'de bir eşleşme meydana geldiğinde ve URL yolu yol değerlerinde 
simgeleştirilir yürütülür. Rota kısıtlamaları genellikle yol şablonu aracılığıyla ilişkili rota değerini inceler ve 
değerin kabul edilebilir olup olmadığı konusunda bir Evet/Hayır kararı getirir. Bazı rota kısıtlamaları, isteğin 
yönlendirilip yönlendirilmeyeceğini göz önünde bulundurmanız için yol değeri dışındaki verileri kullanır. 
Örneğin HttpMethodRouteConstraint, HTTP fiiline bağlı olarak bir isteği kabul edebilir veya reddedebilir. 
Kısıtlamalar, yönlendirme isteklerinde ve bağlantı oluşturmada kullanılır. 


W ARNING 

Giriş doğrulamasıiçin kısıtlamaları kullanmayın. Giriş doğrulamasıiçin kısıtlamalar kullanılıyorsa, doğru bir hata 
iletisine sahip 400-Bad isteği yerine 404- olmayan bir Yanıt ile geçersiz giriş oluşur. Yol kısıtlamaları, belirli bir rota için 
girdileri doğrulamak üzere değil, benzer yolların belirsizliğini ortadan kaldırmak için kullanılır. 


Aşağıdaki tabloda örnek yol kısıtlamaları ve bunların beklenen davranışları gösterilmektedir. 

KISITLAMA ÖRNEK ÖRNEK EŞLEŞMELER NOTLAR 


int 


{id:int} 


123456789 , 

-123456789 


Herhangi bir tamsayıyla 
eşleşir 


bool 


{active:bool} 


true , 

FALSE 


true veya false eşleşir 
(büyük/küçük harfe 
duyarsız) 


datetime 

{dob:datetime} 

2016-12-31 , 

Geçerli bir DateTime 



2016-12-31 7:32pm 

değeriyle eşleşir (Sabit 


kültür içinde, bkz. uyarı) 


decimal 


{price:decimal} 


49.99 , 

-1,000.01 

Geçerli bir 

decimal 


değeriyle eşleşir (Sabit 
kültür içinde, bkz. uyarı) 


double {weight:double} 


1.234, -lj 001 . 01 e 8 Geçerli bir double 

değeriyle eşleşir (Sabit 
kültür içinde, bkz. uyarı) 


f loat 


{weight:float} 


1.234 , 

-1,001.01e8 

Geçerli bir 

f loat 


değeriyle eşleşir (Sabit 
kültür içinde, bkz. uyarı) 


guid 


{id:guid} 


CD2C1638-1638-72D5- 

1638-DEADBEEF1638 


Geçerli bir Guid değeriyle 
eşleşir 


{CD2C1638-1638-72D5- 

1638-DEADBEEF1638} 


































KISITLAMA 


ÖRNEK 


ÖRNEK EŞLEŞMELER 


NOTLAR 


long 


{ticks:long} 


123456789 , 

-123456789 

Geçerli bir 

long 


eşleşir 


minlength(value) 


{username:minlength(4)} 


Rick 


maxlength(value) 


{filename:maxlength(8)} 


Richard 


Dize en az 4 karakter 
olmalıdır 


Dize 8 karakterden uzun 
olmamalıdır 


length(length) 


{filename:length(12)} 

somefile.txt 

Dize tam olarak 12 




karakter uzunluğunda 
olmalıdır 





length(minjmax) 


{filename:length(8 J 16)} 

somefile.txt 

Dize en az 8 ve en fazla 16 


karakter uzunluğunda 
olmalıdır 


min(value) 


{age:min(18)} 


19 


Tamsayı değeri en az 18 
olmalıdır 


max(value) 


{age:max(120)} 


91 


Tamsayı değeri 120 ' ten 
fazla olmamalıdır 


range(min,max) 


{age:range(18,120)} 


91 


Tamsayı değeri en az 18 
olmalı ancak 120 ' ten 
fazla olmamalıdır 


alpha 


{name:alpha} 


Rick 


Dize bir veya daha fazla 
alfabetik karakterden 
oluşmalıdır ( a - z , 
büyük/küçük harfe 
duyarsız) 


regex(expression) 


{ssn:regex( A \\d{{3}}- 


123-45-6789 


\\d{{2}}-\\d{{4}}$)} 



Dize, normal ifadeyle 
eşleşmelidir (normal ifade 
tanımlama hakkında 
ipuçlarına bakın) 


required 


{name:required} 


Rick 


URL oluşturma sırasında 
parametre olmayan bir 
değerin mevcut olduğunu 
zorlamak için kullanılır 


Birden çok, iki nokta üst üste sınırlı kısıtlama tek bir parametreye uygulanabilir. Örneğin, aşağıdaki 
kısıtlama bir parametreyi 1 veya daha büyük bir tamsayı değeriyle kısıtlar: 


[Route("users/{id:int:min(l)}")] 
public User GetUserById(int id) { } 





































VVARNING 

URL 'Yİ doğrulayan ve bir CLR türüne ( int veya DateTime ) dönüştürülen yol kısıtlamaları her zaman sabit kültürü 
kullanır. Bu kısıtlamalar, URL 'nin yerelleştirilemeyen olduğunu varsayar.Framevvork tarafından sunulan yol 
kısıtlamaları, yol değerlerinde depolanan değerleri değiştirmez. URL 'den Ayrıştırılan tüm rota değerleri dizeler olarak 
depolanır. Örneğin, float kısıtlaması yol değerini bir float öğesine dönüştürmeye çalışır, ancak dönüştürülen değer 
yalnızca bir float öğesine dönüştürülebileceğini doğrulamak için kullanılır. 


Normal ifadeler 

ASP.NET Core Framevvork, normal ifade oluşturucusuna 

RegexOptions.IgnoreCase | RegexOptions.Compiled | RegexOptions.CultureInvariant ekler. Bu Üyelerin 
açıklaması için bkz. RegexOptions. 

Normal ifadeler, C# yönlendirme ve dil tarafından kullanılanlarla aynı sınırlayıcıları ve belirteçleri kullanır. 
Normal ifade belirteçlerinin atlanmalıdır. A \d{3}-\d{2}-\d{4}$ normal ifade ' i yönlendirmede kullanmak 
için, ifadede, C# kaynak \ dosyadaki \\ (çift ters eğik çizgi) karakter olarak belirtilen \ (tek ters eğik 
çizgi) karakterlere sahip olması gerekir, karakter (tam dize sabit değerlerikullanmadıkça). Yönlendirme 
parametresi sınırlayıcı karakterlerini ({ , }, [, ]) atlamak için, ifadedeki karakterleri çift ({{ , }, [[ , 
]] ). Aşağıdaki tabloda, bir normal ifade ve kaçan sürümü gösterilmektedir. 

NORMAL İFADE KAÇAN NORMAUFADE 


A \d{3}-\d{2}-\d{4}$ A \\d{{3}}-\\d{{2}}-\\d{{4}}$ 

A [a-z]{2}$ A [[a-z] 

Yönlendirmelerde kullanılan normal ifadeler, genellikle şapka işareti ( A ) karakteriyle başlar ve dizenin 
başlangıç konumuyla eşleşir, ifadeler genellikle dolar işareti ( $ ) karakteriyle biter ve dizenin sonuyla 
eşleşir. A ve $ karakterler, normal ifadenin tüm yol parametresi değeri ile eşleştiğinden emin olun. A ve 
$ karakterleri olmadan normal ifade, dize içindeki herhangi bir alt dizeden eşleşir ve bu genellikle 
istenmeyen bir ifadedir. Aşağıdaki tabloda örnekler verilmektedir ve bunların eşleşmesinin neden 
eşleşmediği veya eşleşmemesi açıklanmaktadır. 


İFADE 

DİZE 

EŞLEŞTİRME 

YORUM 

[a-z]{2> 

herkese 

Evet 

Alt dize eşleşmeleri 

[a-z]{2> 

123abc456 

Evet 

Alt dize eşleşmeleri 

[a-z]{2> 

MZ 

Evet 

Eşleşen ifadesi 

[a-z]{2> 

MZ 

Evet 

Büyük/küçük harfe duyarlı 
değil 

A [a-z]{2}$ 

herkese 

Hayır 

Yukarıdaki A ve $ bakın 

A [a-z]{2}$ 

123abc456 

Hayır 

Yukarıdaki A ve $ bakın 


Normal ifade sözdizimi hakkında daha fazla bilgi için bkz. .NET Framevvork normal ifadeler. 

Bir parametreyi bilinen olası değerler kümesiyle kısıtlamak için, normal bir ifade kullanın. Örneğin 



















(action:regex( A (list|get|create)$)} , yalnızca 

action 

Route değeri 

üst , 

get veya 

create 


Kısıtlama sözlüğüne geçirilirse dize A (iist|get|create)$ eşdeğerdir. Bilinen kısıtlamalardan biriyle 
eşleşmeyen kısıtlama sözlüğüne (bir şablon içinde satır içi değil) geçirilen kısıtlamalar da normal ifadeler 
olarak kabul edilir. 

Özel yol kısıtlamaları 

Yerleşik yol kısıtlamalarına ek olarak, IRouteConstraint arabirimi uygulayarak özel yol kısıtlamaları 
oluşturulabilir. IRouteConstraint arabirimi, kısıtlama karşılandıysanız true döndüren Match tek bir yöntem 
içerir ve aksi takdirde faise . 

Özel bir IRouteConstraintkullanmak için, yol kısıtlama türü uygulamanın hizmet kapsayıcısında 
uygulamanın ConstraintMap kayıtlı olmalıdır. ConstraintMap, yol kısıtlama anahtarlarını bu kısıtlamaları 
doğrulayan IRouteConstraint uygulamalarla eşleyen bir sözlüktür. Bir uygulamanın ConstraintMap, bir 
hizmetin parçası olarak Startup.configureServices güncelleştirilebilen olabilir. AddRouting çağrısı veya 
RouteOptions doğrudan Services.configure<RouteOptions> ile yapılandırma. Örneğin: 

Services. AddRouting(options => 

{ 

options.ConstraintMap.AddC’customName", typeof(MyCustomConstraint)); 

}); 

Kısıtlama daha sonra, kısıtlama türü kaydedilirken belirtilen ad kullanılarak yollara her zamanki şekilde 
uygulanabilir. Örneğin: 

[HttpGet("(id:customName}")] 

public ActionResult<string> Get(string id) 


Parametre transformatörü başvurusu 

Parametre dönüştürücüler: 

• Routeiçin bağlantı oluştururken yürütün. 

• Microsoft.AspNetCore.Routing.IOutboundParameterTransformer uygulayın. 

• ConstraintMapkullanılarak yapılandırılır. 

• Parametrenin yol değerini alın ve yeni bir dize değerine dönüştürün. 

• Oluşturulan bağlantıda Dönüştürülmüş değerin kullanılmasına neden olacak. 


Örneğin, 

Url.Action(new { article = ' 

’MyTestArticle" }) 

ile 

blog\{article:slugify} 

yol düzeninde özel 

slugify 

parametresi transformatörü 

blog\my-test-article Üretir. 



Bir parametre transformatörü bir yol düzeninde kullanmak için, önce Startup.configureServices 
ConstraintMap kullanarak yapılandırın: 

Services. AddRouting(options => 

{ 

// Replace the type and the name used to refer to it with your own 
// IOutboundParameterTransformer implementation 

options.ConstraintMap["slugify"] = typeof(SlugifyParameterTransformer); 

}); 

Parametre dönüştürücüler, bir uç noktanın çözümlediği URI 'yi dönüştürmek için çerçevesi tarafından 
kullanılır. Örneğin, ASP.NET Core MVC, area , controiler , action ve page eşleşecek şekilde kullanılan 
rota değerini dönüştürmek için parametre dönüştürücüler kullanır. 



























routes.MapRoute( 

name: "default", 

template: "{controller:slugify=Home}/{action:slugify=Index}/{id?}"); 

Önceki yol ile eylem SubscriptionManagementContr'oller'.GetAll() ,URI /subscriptlon-management/get-all ile 
eşleştirilir. Bir parametre transformatörü bir bağlantı oluşturmak için kullanılan rota değerlerini değiştirmez. 
Örneğin, Url.Action("GetAll", "SubscriptionManagement") çıkışları /subscription-management/get-all . 

ASP.NET Core, oluşturulan yollarla bir parametre dönüştürücüler kullanmak için API kuralları sağlar: 

• ASP.NET Core MVC 'nİn Microsoft.AspNetCore.Mvc.ApplicationModels.RouteTokenTransformerConvention 
API kuralı vardır. Bu kural, uygulamadaki tüm öznitelik yollarına belirtilen bir parametre transformatörü 
uygular. Parametre transformatörü, öznitelik yol belirteçlerini değiştirildiklerinde dönüştürür. Daha fazla 
bilgi için bkz. belirteç değişimini özelleştirmek için bir parametre transformatörü kullanma. 

• Razor Pages Microsoft.AspNetCore.Mvc.ApplicationModels.PageRouteTransformerConvention API kuralına 
sahiptir. Bu kural, belirtilen bir parametre transformatörü otomatik olarak keşfedilen Razor Pages 
uygular. Parametre transformatörü Razor Pages yolların klasör ve dosya adı segmentlerini dönüştürür. 
Daha fazla bilgi için bkz. sayfa yollarını özelleştirmek için bir parametre transformatörü kullanma. 

URL oluşturma başvurusu 

Aşağıdaki örnek, yol değerlerinin bir sözlüğü ve bir RouteCollectioniçin bir yol bağlantısının nasıl 
oluşturulacağını gösterir. 

app.Run(async (context) => 

{ 

var dictionary = new RouteValueDictionary 
{ 

{ "operation", "create" }, 

{ "id", 123} 

}; 

var vpc = new VirtualPathContext(context, null, dictionary, 

"Track Package Route"); 

var path = routes.GetVirtualPath(vpc).VirtualPath; 

context.Response.ContentType = "text/html"; 
await context.Response.WriteAsync("Menu<hr/>"); 
await context.Response.WriteAsync( 

$"<a href=' {path} ' >Create Package 123</axbr/>"); 

}); 

Yukarıdaki örnek sonunda oluşturulan VirtualPath /package/create /123 . Sözlük, "paket yolunu İzle" 
şablonunun package/{operation}/{id}"operation ve id yol değerlerini sağlar. Ayrıntılar için, yönlendirme 
ara yazılımı kullanma bölümünde veya örnek uygulamadaörnek koda bakın. 

VirtualPathContext oluşturucusunun ikinci parametresi bir ortam değer/er/koleksiyonudur. Ortam 
değerleri, bir geliştiricinin bir istek bağlamı içinde belirtmesi gereken değer sayısını sınırlandırdığından 
kullanım için uygundur. Geçerli isteğin geçerli yol değerleri, bağlantı oluşturma için çevresel değerler olarak 
kabul edilir. ASP.NET Core MVC uygulamasının HomeControiler"About eyleminde, — ortam değeri Home 
index eyleme bağlamak için denetleyici yolu değerini belirtmeniz gerekmez. 

Bir parametreyle eşleşmeyen çevresel değerler yok sayılır. Ayrıca, açıkça sağlanmış bir değer çevresel 
değeri geçersiz kıldığında çevresel değerler de yoksayılır. Eşleştirme, URL 'de soldan sağa doğru gerçekleşir. 

Açık olarak sağlanmış ancak yolun bir segmentiyle eşleşmeyen değerler sorgu dizesine eklenir.Aşağıdaki 
tabloda {controiier}/{action}/{id?} yol şablonu kullanılırken sonuç gösterilmektedir. 



















ÇEVRESEL DEĞERLER 


AÇIK DEĞERLER 


SONUÇ 


denetleyici = 

"giriş" 

Action = "hakkında" 

/Home/About 

denetleyici = 

"giriş" 

denetleyici = "Order", Action = 
"hakkında" 

/Order/About 

denetleyici = 

"giriş", renk = "kırmızı" 

Action = "hakkında" 

/Home/About 

denetleyici = 

"giriş" 

Action = "hakkında", color = "Red" 

/Home/About?color=Red 


Bir rotada bir parametreye karşılık gelen bir varsayılan değer varsa ve bu değer açıkça sağlanmışsa, 
varsayılan değerle eşleşmelidir: 



bağlantı oluşturur. 

Karmaşık segmentler 

Karmaşık segmentler (örneğin [Route("/x{token}y")] ), sabit değerli olmayan değişmez değerler ile sağdan 
sola eşleştirilirken işlenir. Karmaşık segmentlerin nasıl eşleştirileceği hakkında ayrıntılı bir açıklama için bu 
koda bakın. Kod örneği AS P.N ET Core tarafından kullanılmaz, ancak karmaşık segmentler hakkında iyi bir 
açıklama sağlar. 

Yönlendirme, istek URI 'Lerini rota işleyicileriyle eşleştirmekten ve gelen istekleri gönderen sorumludur. 
Yollar uygulamada tanımlanır ve uygulama başlatıldığında yapılandırılır. Yol, isteğe bağlı olarak istekte 
bulunan URL 'den değerleri ayıklayabilir ve bu değerler, istek işleme için kullanılabilir. Uygulamadan 
yapılandırılan yollar kullanıldığında, yönlendirme, yol işleyicileriyle eşlenen URL 'Ler oluşturabilir. 

ASP.NET Core 2,1 ' de en son yönlendirme senaryolarını kullanmak için startup.configureServices MVC 
Hizmetleri kaydının Uyumluluk sürümünü belirtin: 

Services.AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_l); 


IMPORTANT 

Bu belge, alt düzey ASP.NET Core yönlendirmeyi içerir. ASP.NET Core MVC yönlendirme hakkında daha fazla bilgi için 
bkz. ASP.NET Core denetleyici eylemlerine yönlendirme. Razor Pages 'de yönlendirme kuralları hakkında bilgi için bkz. 
ASP.NET Core Razor Pages yol ve uygulama kuralları. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Yönlendirme temelleri 

Çoğu uygulama, URL 'Lerin okunabilir ve anlamlı olması için temel ve açıklayıcı bir yönlendirme şeması 
seçmelidir. Varsayılan geleneksel yol {controiier=Home}/{action=index}/{id?} : 

• Temel ve açıklayıcı bir yönlendirme düzenini destekler. 












• , Ul tabanlı uygulamalar için kullanışlı bir başlangıç noktasıdır. 

Geliştiriciler, öznitelik yönlendirme veya adanmış geleneksel yollar kullanarak özel durumlarda (örneğin, 
blog ve e-ticaret uç noktaları) bir uygulamanın yüksek trafik bölümlerine daha fazla terse yolu ekler. 

Web API 'Leri, uygulamanın işlevselliğini HTTP fiilleri tarafından temsil edilen bir kaynak kümesi olarak 
modellemek için öznitelik yönlendirmeyi kullanmalıdır. Bu, aynı mantıksal kaynaktaki birçok işlemin 
(örneğin, GET, POST) aynı URL 'Yİ kullanacağı anlamına gelir. Öznitelik yönlendirme, bir API 'nin Genel uç 
nokta yerleşimini dikkatle tasarlamak için gereken bir denetim düzeyi sağlar. 

Razor Pages uygulamalar, bir uygulamanın Sayfalar klasöründe adlandırılmış kaynaklara hizmeti sağlamak 
için varsayılan geleneksel yönlendirmeyi kullanır. Razor Pages yönlendirme davranışını özelleştirmenizi 
sağlayan ek kurallar mevcuttur. Daha fazla bilgi için bkz. ASP.NET Core Razor Pages giriş ve ASP.NET Core 
Razor Pages yol ve uygulama kuralları. 

URL oluşturma desteği, uygulamanın, uygulamayı birbirine bağlamak için sabit kodlama URL 'Leri 
olmadan geliştirilebilmesine izin verir. Bu destek, temel bir yönlendirme yapılandırmasıyla başlayıp 
uygulamanın kaynak düzeni belirlendikten sonra yolların değiştirilmesini sağlar. 

Yönlendirme, yolları kullanır (IRouteruygulamalar): 

• Gelen istekleri Rota işleyicilerineeş leyin. 

• Yanıtlarda kullanılan URL 'Leri oluşturun. 

Varsayılan olarak, bir uygulama tek bir yollar koleksiyonuna sahiptir. Bir istek geldiğinde koleksiyondaki 
yollar, koleksiyonda var olan sırada işlenir. Çerçeve, koleksiyondaki her bir rotada RouteAsync yöntemini 
çağırarak, gelen istek URL 'sini koleksiyondaki bir yola eşleştirmeye çalışır. Yanıt, yönlendirme bilgilerine 
göre URL (örneğin, yeniden yönlendirme veya bağlantılar için) oluşturmak için yönlendirmeyi kullanabilir 
ve bu sayede bakım yapılmasına yardımcı olan sabit kodlanmış URL 'Lerden kaçınabilirsiniz. 

Yönlendirme sistemi aşağıdaki özelliklere sahiptir: 

• Yol şablonu sözdizimi, simgeleştirilmiş yol parametrelerine sahip yolları tanımlamak için kullanılır. 

• Geleneksel stil ve öznitelik stili uç nokta yapılandırmasına izin verilir. 

• IRouteConstraint, bir URL parametresinin belirli bir uç nokta kısıtlaması için geçerli bir değer içerip 
içermediğini belirlemekte kullanılır. 

• MVC/Razor Pages gibi uygulama modelleri, yönlendirme senaryolarının öngörülebilir bir uygulaması 
olan tüm yollarını kaydeder. 

• Yanıt, yönlendirme bilgilerine göre URL (örneğin, yeniden yönlendirme veya bağlantılar için) 
oluşturmak için yönlendirmeyi kullanabilir ve bu sayede bakım yapılmasına yardımcı olan sabit 
kodlanmış URL 'Lerden kaçınabilirsiniz. 

• URL oluşturma, rastgele genişletilebilirliği destekleyen yollara dayalıdır. lUrlHelper, URL 'Leri derlemek 
için yöntemler sunar. 

Yönlendirme, RouterMiddlevvare sınıfı tarafından, Ara yazılım ardışık düzenine bağlıdır. ASP.NET Core 
MVC , yapılandırma kapsamında bir ara yazılım ardışık düzenine yönlendirme ekler ve MVC ve Razor 
Pages uygulamalarında yönlendirmeyi işler. Tek başına bileşen olarak yönlendirmeyi nasıl kullanacağınızı 
öğrenmek için yönlendirme ara yazılımı kullanma bölümüne bakın. 

URL eşleştirme 

URL eşleştirme, yönlendirmenin bir (ş/ey/cıyegelen istek gönderdiğine yönelik işlemdir. Bu işlem, URL 
yolundaki verileri temel alır, ancak istekteki verileri göz önünde bulundurmanız için genişletilebilir. Ayrı 
işleyicilere istek gönderme özelliği, bir uygulamanın boyutunu ve karmaşıklığını ölçeklendirmeye yönelik 
anahtardır. 


Gelen istekler, sırayla her bir rotada RouteAsync yöntemini çağıran RouterMiddlevvaregirer. IRouter örneği, 


Routecontext. Handler değerini null olmayan bir RequestDelegateayarlayarak isteğin işleneceğini belirler. 

Bir yol istek için bir işleyici ayarlarsa, yol işleme duraklar ve işleyici isteği işlemek için çağrılır, isteği işlemek 
için yol işleyicisi bulunmazsa, ara yazılım istek ardışık düzeninde sonraki bir ara yazılım için isteği kapatır. 

RouteAsync birincil giriş, geçerli istekle ilişkili Routecontext. HttpContext ' dir. Routecontext. Handler ve 
Routecontext. RouteData , bir yol eşleştirdikten sonra çıkış olarak ayarlanır. 

RouteAsync çağıran bir eşleşme de Routecontext. RouteData özelliklerinin özelliklerini, bu nedenle yapılan 
istek işlemeye bağlı olarak uygun değerlere ayarlar. 

RouteData. Values , rotada oluşturulan yol değerlerinin bir sözlüğüdür. Bu değerler genellikle URL 'Yİ 
simgeleştirerek belirlenir ve Kullanıcı girişini kabul etmek ya da uygulama içinde daha fazla kararlar almak 
için kullanılabilir. 

RouteData. DataTokens , eşleşen rotayla ilgili ek verilerin bir özellik çantadır. DataTokens, uygulamanın 
hangi yolun eşleştiğini temel alarak kararlar verebilmesi için durum verilerinin her bir rota ile 
ilişkilendirilmesini desteklemek amacıyla sağlanır. Bu değerler, geliştirici tarafından tanımlanır ve 
yönlendirme davranışını herhangi bir şekilde etkilemez. Ayrıca, RouteData. DataTokens içinde bulunan 
değerler her türlü türden olabilir. Bu, veridizeleri arasında dönüştürülebilir olmalıdır. 

RouteData. yönlendiriciler , isteği başarıyla eşleştirirken geçen yolların bir listesidir. Yollar bir diğerinin 
içinde iç içe olabilir. Routers özelliği, bir eşleşme ile sonuçlanan yolların mantıksal ağacı aracılığıyla yolu 
yansıtır. Genellikle, Routers ilk öğe yol koleksiyonudur ve URL oluşturma için kullanılmalıdır. Routers son 
öğe, eşleşen yol işleyicisidir. 

URL oluşturma 

URL oluşturma, yönlendirmenin bir yol değerleri kümesine göre bir URL yolu oluşturabileceği işlemdir. Bu, 
yönlendirme işleyicileri ve bunlara erişen URL 'Ler arasındaki mantıksal bir ayrım sağlar. 

URL oluşturma benzer bir yinelemeli işlem izler, ancak yol koleksiyonunun GetVirtualPath metoduna 
çağıran kullanıcı veya çerçeve kodu ile başlar. Her rotada null olmayan bir VirtualPathData döndürülene 
kadar GetVirtualPath yöntemi sırayla çağırılır. 

GetVirtualPath birincil girişleri şunlardır: 

• VirtualPathContext. HttpContext 

• VirtualPathContext. Values 

• VirtualPathContext. AmbientValues 

Rotalar öncelikle Values ve AmbientValues tarafından sunulan yol değerlerini kullanarak bir URL oluşturma 
ve hangi değerlerin dahil edileceğini belirleyin. AmbientValues, geçerli istekle eşleşmeden üretilmiş olan 
rota değerleri kümesidir. Buna karşılık Values, geçerli işlem için istenen URL 'nin nasıl oluşturulacağını 
belirten rota değerlerdir. HttpContext, bir yolun geçerli bağlamla ilişkili hizmetleri veya ek verileri alması 
durumunda sağlanır. 


TIP 

Virtualpathcontext. Values öğesini Virtualpathcontext. AmbientValuesiçin bir geçersiz kılma kümesi olarak düşünün. 
URL oluşturma, aynı rota veya yol değerlerini kullanan bağlantılar için URL 'Ler oluşturmak üzere geçerli istekten yol 
değerlerini yeniden kullanmayı dener. 


GetVirtualPath çıkışı bir VirtualPathData. VirtualPathData, RouteDataparaleldir. VirtualPathData, çıkış URL 
'SI için VirtualPath ve yol tarafından ayarlanması gereken bazı ek özellikleri içerir. 

VirtualPathData. VirtualPath özelliği, yol tarafından üretilen sanal yolu içerir. Gereksinimlerinize bağlı 
olarak, yolu daha fazla işlem yapmanız gerekebilir. Oluşturulan URL 'Yİ HTML 'de işlemek istiyorsanız, 







uygulamanın temel yolunu ekleyin. 

VirtualPathData. Router , URL 'yi başarıyla oluşturmuş olan yola bir başvurudur. 

VirtualPathData. DataTokens özellikleri, URL 'yi oluşturan rotayla ilgili ek verilerin bir sözlüğüdür.Bu, 
RouteData. Datatoken'ların paraleldir. 

Rotalar oluştur 

Yönlendirme, IRouterstandart uygulama olarak Route sınıfını sağlar. Route, RouteAsync çağrıldığında URL 
yoluyla eşleştirilecek desenleri tanımlamak için yol şablonu sözdizimini kullanır. Route, GetVirtualPath 
çağrıldığında bir URL oluşturmak için aynı yol şablonunu kullanır. 

Çoğu uygulama, IRouteBuildertammlanan benzer uzantı yöntemlerinden birini veya MapRoute çağırarak 
yollar oluşturur. IRouteBuilder uzantısı yöntemlerinden herhangi biri bir Route örneği oluşturur ve bunu yol 
koleksiyonuna ekler. 

MapRoute yol işleyicisi parametresini kabul etmez. MapRoute, yalnızca DefaultHandlertarafından işlenen 
rotaları ekler. Varsayılan işleyici bir iRouter ve işleyici isteği işleyemeyebilir. Örneğin, ASP.NET Core MVC 
genellikle yalnızca kullanılabilir bir denetleyici ve eylemle eşleşen istekleri işleyen varsayılan bir işleyici 
olarak yapılandırılır. MVC 'de yönlendirme hakkında daha fazla bilgi için bkz. ASP.NET Core denetleyici 
eylemlerine yönlendirme. 

Aşağıdaki kod örneği, tipik bir ASP.NET Core MVC yol tanımı tarafından kullanılan MapRoute çağrısının 
bir örneğidir: 

routes.MapRoute( 

name: "default", 

template: "{controller=Home}/{action=Index}/{id?}"); 

Bu şablon bir URL yoluyla eşleşir ve yol değerlerini ayıklar.Örneğin, yol /Products/Detaiis/17 şu yol 
değerlerini üretir: { controller = Products, action = Details, id = 17 } . 

Rota değerleri, URL yolunun kesimlere bölünüyor ve rota şablonundaki yol parametresi adı ile her bir 
segmenti eşleştirerek belirlenir. Yol parametreleri olarak adlandırılır. Küme ayraçları içinde parametre adı 
eklenerek tanımlanan parametreler { ... }. 

Yukarıdaki şablon, URL yolu / de eşleştirebilir ve { controller = Home, action = index } değerler 
üretecektir. Bu, {controller} ve {action} yol parametrelerinin varsayılan değerleri olduğu ve id Route 
parametresinin isteğe bağlı olduğu için oluşur. Eşittir işareti ( = ), yol parametresi adı parametre için 
varsayılan bir değer tanımladıktan sonra bir değer izler. Yol parametre adından sonra bir soru işareti ( ? ) 
isteğe bağlı bir parametre tanımlar. 

Yol parametreleri varsayılan değer ile her zaman rota değeri oluşturur. Karşılık gelen bir URL yol kesimi 
yoksa isteğe bağlı parametreler yol değeri oluşturmaz. Yol şablonu senaryolarının ve sözdiziminin kapsamlı 
bir açıklaması için yol şablonu başvurusu bölümüne bakın. 

Aşağıdaki örnekte, yol parametresi tanımı {id:int} id Route parametresi için bir yol kısıtlaması 
tanımlıyor: 

routes.MapRoute( 

name: "default", 

template: "{controller=Home}/{action=Index}/{id:int}"); 

Bu şablon /Products/Detaiis/17 gibi bir URL yoluyla eşleşir ancak /Products/Details/Appies . Yol 
kısıtlamaları IRouteConstraint uygular ve yol değerlerini inceleyerek onları doğrular. Bu örnekte, yol değeri 
id bir tamsayıya dönüştürülebilir olmalıdır. Framework tarafından sunulan yol kısıtlamalarının açıklaması 


















için bkz. route-Constraint-Reference . 


MapRoute ek aşırı yüklemeleri constraints , dataTokens ve defauits için değer kabul eder. Bu 
parametrelerin tipik kullanımı, anonim türdeki özellik adlarının yol parametre adlarıyla eşleşen anonim 
olarak yazılmış bir nesneyi geçirmektir. 

Aşağıdaki MapRoute örnekleri eşdeğer yollar oluşturur: 

routes.MapRoute( 

name: "default_noute", 

template: "{controller}/{action}/{id?}", 

defauits: new { controller = "Home", action = "Index" }); 


routes.MapRoute( 

name: "default_noute", 

template: "{controller=Home}/{action=Index}/{id?}"); 



routes.MapRoute( 
name: "blog", 

template: "Blog/{*article}", 

defauits: new { controller = "Blog", action = "ReadArticle" }); 

Önceki şablon /Blog/Aiı-About-Routing/introduction gibi bir URL yoluyla eşleşir ve 
{ controller = Blog, action = ReadArticle, article = All-About-Routing/Introduction } değerleri ayıklar, 
controller ve action için varsayılan yol değerleri, şablonda karşılık gelen hiçbir yol parametresi olmasa 
bile yol tarafından üretilir. Varsayılan değerler yol şablonunda belirtilebilir, article Route parametresi, yol 
parametre adından önce bir yıldız işareti ( * ) görünümüne göre catch-all olarak tanımlanır. Catch-all yol 
parametreleri, URL yolunun kalanını yakalar ve boş dizeyle de aynı olabilir. 

Aşağıdaki örnek yol kısıtlamalarını ve veri belirteçlerini ekler: 

routes.MapRoute( 

name: "us_english_products", 
template: "en-US/Products/{id}", 

defauits: new { controller = "Products", action = "Details" }, 
constraints: new { id = new IntRouteConstraint() }, 
dataTokens: new { locale = "en-US" }); 


Önceki şablon 

/en-US/Products/5 

gibi bir URL yoluyla eşleşir ve 



{ controller = 

Products, action = 

= Details, id = 5 } 

ve veri belirteçleri 

{ locale = en-us } değerleri 


ayıklar. 













1 Locals 


’ ?x| 

Name 

Value 

Type I 

> f* Response 

{Microsoft.AspNetCore.Http.Internal.DefaultHttpResponse} 

Microsol 

jijSgn,ı3 RouteData 

{Microsoft AspNetCore. Routing.RouteData} 

Microsc^B 

* y DataTokens 

{Microsoft.AspNetCore.Routing.RouteValueDictionary} 

Microsol 

> y Comparer 

{System. OrdinalComparer) 

System.C 

y Count 

1 

int 

a y Keys 

{string[1 ]} 

System.C 

* [0] 

"locale" » 

string 

-a y Values 

{objectp]} 

System.C 

t» [0] 

"en-US” 0, 

object {s 

> # Non-Public me 



> © Results View 

Expanding the Results View will enumerate the lEnumerable 


■a y Routers 

Count = 3 

System.C 

> # [0] 

{Microsoft.AspNetCore.Routing.RouteCollection} 

Microsol 

> <* [1] 

{en-US/Products/{id}} 

Microsol 

> # [2] 

{Microsoft.AspNetCore.Mvc.Internal.MvcRouteHandler} 

Microsol w 

Output Autos Watch 1 


Yol sınıfı URL 'SI oluşturma 

Route sınıfı, yol değerlerini bir kümesini rota şablonuyla birleştirerek URL oluşturmayı da gerçekleştirebilir. 
Bu, URL yolunu eşleştirmenin mantıksal bir işlemdir. 


TIP 

URL oluşturmayı daha iyi anlamak için, oluşturmak istediğiniz URL 'Yİ düşünün ve sonra bir yönlendirme şablonunun 
bu URL ile nasıl eşleşeceğini düşünün. Hangi değerler üretilemidir? Bu, URL oluşturma 'nın Route sınıfında nasıl 
çalıştığına ilişkin kaba bir eştir. 


Aşağıdaki örnek genel ASP.NET Core MVC varsayılan yolunu kullanır: 

routes.MapRoute( 

name: "default", 

template: "{controller=Home}/{action=Index}/{id?}"); 

Yol değerleri { controller = Products, action = List }, /Products/List U RL 'S I oluşturulur. Yol değerleri, 
URL yolunu biçimlendirmek için karşılık gelen yol parametrelerinin yerine kullanılır, id , isteğe bağlı bir yol 
parametresi olduğundan, id için bir değer olmadan URL başarıyla oluşturulur. 

Yol değerleri { controller = Home, action = index }, / URL 'SI oluşturulur.Belirtilen yol değerleri 
varsayılan değerlerle eşleşir ve varsayılan değerlere karşılık gelen segmentler güvenle atlanır. 

Her iki URL de aşağıdaki yol tanımıyla ( /Home/index ve / ) bir gidiş dönüş, URL oluşturmak için kullanılan 
rota değerlerini oluşturur. 


NOTE 

ASP.NET Core MVC kullanan bir uygulama doğrudan yönlendirmeye çağırmak yerine URL oluşturmak için UrlHelper 
kullanmalıdır. 


URL oluşturma hakkında daha fazla bilgi için URL oluşturma başvurusu bölümüne bakın. 

Yönlendirme ara yazılımı kullanma 

Uygulamanın proje dosyasındaki Microsoft AspNetCore. app metapackage öğesine başvurun. 
startup.configureServices ' de hizmet kapsayıcısına yönlendirme ekleyin: 
















public void ConfigureServices(IServiceCollection Services) 

{ 

Services .AddRouting(); 

} 

Yolların startup.configure yönteminde yapılandırılması gerekir. Örnek uygulama aşağıdaki API 'Leri 
kullanır: 

• RouteBuilder 

• MapGet-yalnızca HTTP GET istekleriyle eşleşir. 

• UseRouter 


var trackPackageRouteHandler = new RouteHandler(context => 

{ 

var routeValues = context.GetRouteData().Values; 
return context.Response.WriteAsync( 

$"Hello! Route values: {string.ToinC, ", routeValues)}"); 

»; 

var routeBuilder = new RouteBuilder(app, trackPackageRouteHandler); 

routeBuilder.MapRoute( 

"Track Package Route", 

"package/{operation:regex( A track|create$)}/{id:int}"); 

routeBuilder.MapGet("hello/{name}", context => 

{ 

var name = context.GetRouteValue("name"); 

// The route handler when HTTP GET "hello/<anything>" matches 
// To match HTTP GET "hello/<anything>/<anything>, 

// use routeBuilder.MapGet("hello/{*name}" 
return context.Response.WriteAsync($"Hi, {name}!"); 

}); 

var routes = routeBuilder.Build(); 
app.UseRouter(routes); 


Aşağıdaki tabloda verilen URI 'Ler ile ilgili yanıtlar gösterilmektedir. 


URI 

YANITIYLA 

/package/create/3 

Herkese! Rota değerleri: [işlem, oluşturma], [kimlik, 3] 

/package/track/-3 

Herkese! Rota değerleri: [işlem, izleme], [kimlik,-3] 

/package/track/-3/ 

Herkese! Rota değerleri: [işlem, izleme], [kimlik,-3] 

/package/tnack/ 

istek, eşleşme olmadan üzerinden yapılır. 

GET /hello/Doe 

Merhaba, ali! 

POST /hello/Doe 

istek üzerinden geçer, yalnızca HTTP GET ile eşleşir. 

GET /hello/Doe/Smith 

istek, eşleşme olmadan üzerinden yapılır. 


Tek bir yol yapılandırıyorsanız, bir iRouter örneğinde geçen UseRouter çağırın. RouteBuilderkullanmamz 
gerekmez. 











Çerçeve, yollar oluşturmak için bir genişletme yöntemleri kümesi sağlar 
(RequestDelegateRouteBuilderExtensions): 

• MapDelete 

• MapGet 

• MapMiddlevvareDelete 

• MapMiddlevvareGet 

• MapMiddlewarePost 

• MapMiddlevvarePut 

• MapMiddlewareRoute 

• MapMiddlevvareVerb 

• MapPost 

• MapPut 

• MapRoute 

• MapVerb 

MapGetgibi listelenen yöntemlerin bazıları RequestDelegategerektirir. Yol eşleştiğindeyo/ işleyicisi olarak 
RequestDelegate kullanılır. Bu ailedeki diğer yöntemler, yönlendirme işleyicisi olarak kullanılmak üzere bir 
ara yazılım ardışık düzeni yapılandırmaya olanak tanır. Map* yöntemi MapRoutegibi bir işleyiciyi kabul 
etmez DefaultHandlerkullanır. 

Map[verb] yöntemleri, yöntem adındaki HTTP fiili ile rotayı sınırlandırmak için kısıtlamaları kullanır. 
Örneğin, bkz. MapGet ve MapVerb. 

Rota şablonu başvurusu 

Küme ayraçları içindeki belirteçler ( { ... } ), yol eşleştirildiği takdirde bağlanan Rota parametrelerini 
tanımlar. Bir yol segmentinde birden fazla yol parametresi tanımlayabilirsiniz, ancak bunların bir değişmez 
değer ile ayrılması gerekir. Örneğin, {controiier} ve {action} arasında değişmez değer olmadığından 
{controiier=Home}{action=index} geçerli bir yol değil. Bu rota parametrelerinin bir adı olmalı ve ek 
öznitelikler belirtilmiş olabilir. 

Yol parametreleri dışında (örneğin, {id} ) ve yol ayırıcı / URL içindeki metinle eşleşmesi gerekir.Metin 
eşleştirme, büyük/küçük harfe duyarsızdır ve URL yolunun kodu çözülmüş gösterimine göre yapılır. 
Değişmez değer yol parametresi sınırlayıcısından ( { veya }) eşleştirmek için, karakteri ( {{ veya }} ) 
tekrarlayarak sınırlayıcıdan kaçış. 

isteğe bağlı bir dosya uzantısına sahip bir dosya adı yakalamaya deneyen URL desenlerinin ek konuları 
vardır. Örneğin, fiies/{fiiename}.{ext?} şablonu düşünün, filename ve ext değerlerinin her ikisi de 
varsa, her iki değer de doldurulur. URL'de yalnızca filename için bir değer varsa, bitiş dönemi ( . ) isteğe 
bağlı olduğundan yol eşleşir. Aşağıdaki URL 'Ler bu rota ile eşleşiyor: 


/files/myFile. 

txt 

/files/myFile 



Yıldız işaretini ( * ) URI 'nin geri kalanına bağlamak için bir yol parametresinin öneki olarak 
kullanabilirsiniz. Buna catch-all parametresi denir. Örneğin, biog/{*siug} /blog ile başlayan ve ondan 
sonraki bir değere sahip olan siug yol değerine atanan tüm URI ile eşleşir.Catch-all parametreleri boş 
dizeyle de aynı olabilir. 

Yol ayırıcısı ( / ) karakterleri de dahil olmak üzere bir URL oluşturmak için bir yol kullanıldığında, catch-all 
parametresi uygun karakterleri çıkar. Örneğin yol foo/{*path} rota değerleriyle { path = "my/path" } 
foo/my% 2 Fpath üretir. Atlanan eğik çizgiye göz önünde edin. 


















Yol parametrelerinin, parametre adından sonra varsayılan değer belirtilerek bir eşittir işareti ( = ) ile 
ayrıldıktan sonra belirlenen varsayılan değerleri olabilir. Örneğin, Home controiler için varsayılan değer 
olarak {controiier=Home} tanımlar. Parametresi için URL 'de hiçbir değer yoksa varsayılan değer kullanılır. 
Yol parametreleri, id? gibi parametre adının sonuna bir soru işareti ( ? ) eklenerek isteğe bağlı olarak 
yapılır, isteğe bağlı değerler ve varsayılan yol parametreleri arasındaki fark, varsayılan değere sahip bir yol 
parametresinin her zaman bir değer ürettiğinden—isteğe bağlı bir parametre yalnızca istek URL 'SI 
tarafından bir değer sağlandığında bir değere sahip olur. 

Rota parametrelerinin URL 'den bağlanan rota değeriyle eşleşmesi gereken kısıtlamaları olabilir.Yol 
parametre adından sonra bir iki nokta üst üste ( : ) ve kısıtlama adının eklenmesi, bir yol parametresi 
üzerinde bir satır içi kısıtlamayı belirtir. Kısıtlama bağımsız değişkenler gerektiriyorsa, kısıtlama adından 
sonra parantez ( (...) ) içine alınır. Birden çok satır içi kısıtlama, başka bir iki nokta ( : ) ve kısıtlama adı 
eklenerek belirtilebilir. 

Kısıtlama adı ve bağımsız değişkenler, URL işlemede kullanılacak bir IRouteConstraint örneği oluşturmak 
için UnlineConstraintResolver hizmetine geçirilir. Örneğin, yol şablonu biog/{articie:miniength(i 0 )} , 10 
bağımsız değişkeniyle bir minlength kısıtlaması belirtir. Yol kısıtlamaları ve Framevvork tarafından sunulan 
kısıtlamaların bir listesi hakkında daha fazla bilgi için, route kısıtlama başvurusu bölümüne bakın. 

Aşağıdaki tabloda örnek yol şablonları ve bunların davranışları gösterilmektedir. 

ROTA ŞABLONU ÖRNEK EŞLEŞEN URI İSTEK URl Sİ... 


hello 

/hello 

Yalnızca /hello tek yol ile eşleşir. 

{Page=Home} 


/ 

Home"' Page eşleşir ve ayarlar. 





{Page=Home} 


/Contact 

contact"" Page eşleşir ve ayarlar. 


{controller}/{action}/{id?} 


/Products/List 


Products 

denetleyicisi ve 

List 


eylemiyle eşlenir. 


{controller}/{action}/{id?} 


/Products/Details/123 


Products 

denetleyicisi ve 

Details 


eylemine eşlenir (id 123 olarak 
ayarlanır). 


{controller=Home}/{action=Index}/{ic / 


Home 

denetleyicisi ve 

Index 


yöntemiyle eşlenir ( id yok sayılır). 

Bir şablon kullanmak genellikle yönlendirmeye en basit yaklaşımdır. Kısıtlamalar ve varsayılanlar, yol 
şablonu dışında da belirtilebilir. 


TIP 

Route, istekleri eşleştirme gibi yerleşik yönlendirme uygulamalarının nasıl yapıldığını görmek için günlük kaydını 
etkinleştirin. 


Ayrılmış yönlendirme adları 

Aşağıdaki anahtar sözcükler ayrılmış isimlerdir ve yol adları veya parametreler olarak kullanılamaz: 

• action 

• area 




























• controller 

• handler 

• page 


Yol kısıtlama başvurusu 

Yol kısıtlamaları, gelen URL 'de bir eşleşme meydana geldiğinde ve URL yolu yol değerlerinde 
simgeleştirilir yürütülür. Rota kısıtlamaları genellikle yol şablonu aracılığıyla ilişkili rota değerini inceler ve 
değerin kabul edilebilir olup olmadığı konusunda bir Evet/Hayır kararı getirir. Bazı rota kısıtlamaları, isteğin 
yönlendirilip yönlendirilmeyeceğini göz önünde bulundurmanız için yol değeri dışındaki verileri kullanır. 
Örneğin HttpMethodRouteConstraint, HTTP fiiline bağlı olarak bir isteği kabul edebilir veya reddedebilir. 
Kısıtlamalar, yönlendirme isteklerinde ve bağlantı oluşturmada kullanılır. 


VVARNING 

Giriş doğrulamasıiçin kısıtlamaları kullanmayın. Giriş doğrulamasıiçin kısıtlamalar kullanılıyorsa, doğru bir hata 
iletisine sahip 400-Bad isteği yerine 404- olmayan bir Yanıt ile geçersiz giriş oluşur. Yol kısıtlamaları, belirli bir rota için 
girdileri doğrulamak üzere değil, benzer yolların belirsizliğini ortadan kaldırmak için kullanılır. 


Aşağıdaki tabloda örnek yol kısıtlamaları ve bunların beklenen davranışları gösterilmektedir. 

ÖRNEK EŞLEŞMELER 


KISITLAMA 


ÖRNEK 


int 


{id:int} 


123456789 , 

-123456789 


NOTLAR 


eşleşir 


bool 


{active:bool} 


true , 

FALSE 


true veya false eşleşir 
(büyük/küçük harfe 
duyarsız) 


datetime 

{dob:datetime} 

2016-12-31 , 

Geçerli bir DateTime 



2016-12-31 7:32pm 

değeriyle eşleşir (Sabit 


kültür içinde, bkz. uyarı) 


decimal 


{price:decimal} 


49.99 , 

-1,000.01 

Geçerli bir 

decimal 


değeriyle eşleşir (Sabit 
kültür içinde, bkz. uyarı) 


double 


{weight:double} 


1.234 , 

-1,001.01e8 

Geçerli bir 

double 


değeriyle eşleşir (Sabit 
kültür içinde, bkz. uyarı) 


f loat 


{weight:float} 


1.234 , 

-1,001.01e8 

Geçerli bir 

f loat 


değeriyle eşleşir (Sabit 
kültür içinde, bkz. uyarı) 


guid 


{id:guid} 


CD2C1638-1638-72D5- 

1638-DEADBEEF1638 


Geçerli bir Guid değeriyle 
eşleşir 


{CD2C1638-1638-72D5- 

1638-DEADBEEF1638} 


long 


{ticks:long} 


123456789 , 

-123456789 

Geçerli bir 

long 


eşleşir 




































KISITLAMA 


ÖRNEK 


ÖRNEK EŞLEŞMELER 


NOTLAR 


minlength(value) 


{username:minlength(4)} 


Rick 


maxlength(value) 


{filename:maxlength(8)} 


Richard 


length(length) 


{filename:length(12)} 


somefile.txt 


length(min,max) 


{filename:length(8 J 16)} 


somefile.txt 


min(value) 


{age:min(18)} 


19 


max(value) 


{age:max(120)} 


91 


Dize en az 4 karakter 
olmalıdır 


Dize 8 karakterden uzun 
olmamalıdır 


Dize tam olarak 12 
karakter uzunluğunda 
olmalıdır 


Dize en az 8 ve en fazla 16 
karakter uzunluğunda 
olmalıdır 


Tamsayı değeri en az 18 
olmalıdır 


Tamsayı değeri 120 1 ten 
fazla olmamalıdır 


range(minj max) 


{age:range(18,120)} 


91 


Tamsayı değeri en az 18 
olmalı ancak 120 ' ten 
fazla olmamalıdır 


alpha 


{name:alpha} 


Rick 


Dize bir veya daha fazla 
alfabetik karakterden 
oluşmalıdır ( a - z , 
büyük/küçük harfe 
duyarsız) 


regex(expression) 


{ssn:regex( A \\d{{3}}- 


123-45-6789 


\\d{{2}}-\\d{{4}}$)} 



Dize, normal ifadeyle 
eşleşmelidir (normal ifade 
tanımlama hakkında 
ipuçlarına bakın) 


required 


{name:required} 


Rick 


URL oluşturma sırasında 
parametre olmayan bir 
değerin mevcut olduğunu 
zorlamak için kullanılır 


Birden çok, iki nokta üst üste sınırlı kısıtlama tek bir parametreye uygulanabilir. Örneğin, aşağıdaki 
kısıtlama bir parametreyi 1 veya daha büyük bir tamsayı değeriyle kısıtlar: 

[Route("users/{id:int:min(l)}")] 
public User GetUserById(int id) { } 


VVARNING 

URL 'Yİ doğrulayan ve bir CLR türüne ( int veya DateTime ) dönüştürülen yol kısıtlamaları her zaman sabit kültürü 
kullanır. Bu kısıtlamalar, URL ’nin yerelleştirilemeyen olduğunu varsayar.Framevvork tarafından sunulan yol 
kısıtlamaları, yol değerlerinde depolanan değerleri değiştirmez. URL 'den Ayrıştırılan tüm rota değerleri dizeler olarak 
depolanır. Örneğin, float kısıtlaması yol değerini bir float öğesine dönüştürmeye çalışır, ancak dönüştürülen değer 
yalnızca bir float öğesine dönüştürülebileceğini doğrulamak için kullanılır. 



































Normal ifadeler 


ASP.NET Core Framevvork, normal ifade oluşturucusuna 

RegexOptions.IgnoreCase | RegexOptions.Compiled | RegexOptions.CultureInvariant ekler. Bu Üyelerin 
açıklaması için bkz. RegexOptions. 

Normal ifadeler, C# yönlendirme ve dil tarafından kullanılanlarla aynı sınırlayıcıları ve belirteçleri kullanır. 
Normal ifade belirteçlerinin atlanmalıdır. A \d{3}-\d{2}-\d{4}$ normal ifade ' i yönlendirmede kullanmak 
için, ifadede, C# kaynak \ dosyadaki \\ (çift ters eğik çizgi) karakter olarak belirtilen \ (tek ters eğik 
çizgi) karakterlere sahip olması gerekir, karakter (tam dize sabit değerlerikullanmadıkça). Yönlendirme 
parametresi sınırlayıcı karakterlerini ({ , }, [, ]) atlamak için, ifadedeki karakterleri çift ({{ , } , [[ , 
]] ). Aşağıdaki tabloda, bir normal ifade ve kaçan sürümü gösterilmektedir. 

NORMAL İFADE KAÇAN NORMAL İFADE 


A \d{3}-\d{2}-\d{4}$ 


A \\d{{3}}-\\d{{2}}-\\d{{4}}$ 


A [a-z]{2}$ 


A [[a-z]]{{2}}$ 


Yönlendirmelerde kullanılan normal ifadeler, genellikle şapka işareti ( A ) karakteriyle başlar ve dizenin 
başlangıç konumuyla eşleşir, ifadeler genellikle dolar işareti ( $ ) karakteriyle biter ve dizenin sonuyla 
eşleşir. A ve $ karakterler, normal ifadenin tüm yol parametresi değeri ile eşleştiğinden emin olun. A ve 
$ karakterleri olmadan normal ifade, dize içindeki herhangi bir alt dizeden eşleşir ve bu genellikle 
istenmeyen bir ifadedir. Aşağıdaki tabloda örnekler verilmektedir ve bunların eşleşmesinin neden 
eşleşmediği veya eşleşmemesi açıklanmaktadır. 


İFADE 

DİZE 

EŞLEŞTİRME 

YORUM 

[a-z]{2> 

herkese 

Evet 

Alt dize eşleşmeleri 

[a-z]{2> 

123abc456 

Evet 

Alt dize eşleşmeleri 

[a-z]{2> 

MZ 

Evet 

Eşleşen ifadesi 

[a-z]{2> 

MZ 

Evet 

Büyük/küçük harfe duyarlı 
değil 


A [a-z]{2}$ 

herkese Hayır Yukarıdaki 

A 

ve 

$ 

bakın 

A [a-z]{2}$ 

123abc456 Hayır Yukarıdaki 

A 

ve 

$ 

bakın 


Normal ifade sözdizimi hakkında daha fazla bilgi için bkz. .NET Framevvork normal ifadeler. 

kümesiyle kısıtlamak için, normal bir ifade kullanın. Örneğin 
yalnızca action Route değeri üst, get veya create ile eşleşir. 
Kısıtlama sözlüğüne geçirilirse dize A (iist|get|create)$ eşdeğerdir. Bilinen kısıtlamalardan biriyle 
eşleşmeyen kısıtlama sözlüğüne (bir şablon içinde satır içi değil) geçirilen kısıtlamalar da normal ifadeler 
olarak kabul edilir. 


Bir parametreyi bilinen olası değerler 
{action:regex( A (list|get|create)$)} , 


Özel yol kısıtlamaları 

Yerleşik yol kısıtlamalarına ek olarak, IRouteConstraint arabirimi uygulayarak özel yol kısıtlamaları 
oluşturulabilir. IRouteConstraint arabirimi, kısıtlama karşılandıysanız tnue döndüren Match tek bir yöntem 























içerir ve aksi takdirde faise . 


Özel bir IRouteConstraintkullanmak için, yol kısıtlama türü uygulamanın hizmet kapsayıcısında 
uygulamanın ConstraintMap kayıtlı olmalıdır. ConstraintMap, yol kısıtlama anahtarlarını bu kısıtlamaları 
doğrulayan IRouteConstraint uygulamalarla eşleyen bir sözlüktür. Bir uygulamanın ConstraintMap, bir 
hizmetin parçası olarak startup.configureServices güncelleştirilebilen olabilir. AddRouting çağrısı veya 
RouteOptions doğrudan Services.configure<RouteOptions> ile yapılandırma. Örneğin: 

Services. AddRouting(options => 

{ 

options.ConstraintMap.Add("customName", typeof(MyCustomConstraint)); 

}); 

Kısıtlama daha sonra, kısıtlama türü kaydedilirken belirtilen ad kullanılarak yollara her zamanki şekilde 
uygulanabilir. Örneğin: 

[HttpGet("{id:customName}")] 

public ActionResult<string> Get(string id) 


URL oluşturma başvurusu 

Aşağıdaki örnek, yol değerlerinin bir sözlüğü ve bir RouteCollectioniçin bir yol bağlantısının nasıl 
oluşturulacağını gösterir. 

app.Run(async (context) => 

{ 

var dictionary = new RouteValueDictionary 
{ 

{ "operation", "create" }, 

{ "id", 123} 

}; 

var vpc = new VirtualPathContext(context , null, dictionary, 

"Track Package Route"); 

var path = routes.GetVirtualPath(vpc).VirtualPath; 

context.Response.ContentType = "text/html"; 
await context.Response.WriteAsync("Menu<hr/>"); 
await context.Response.WriteAsync( 

$"<a href=' {path} ' >Create Package 123</axbr/>"); 

}); 

Yukarıdaki örnek sonunda oluşturulan VirtualPath /package/create /123 . Sözlük, "paket yolunu İzle" 
şablonunun package/{operation}/{id}"operation ve id yol değerlerini sağlar. Ayrıntılar için, yönlendirme 
ara yazılımı kullanma bölümünde veya örnek uygulamadaörnek koda bakın. 

VirtualPathContext oluşturucusunun ikinci parametresi bir ortam değer/er/koleksiyonudur. Ortam 
değerleri, bir geliştiricinin bir istek bağlamı içinde belirtmesi gereken değer sayısını sınırlandırdığından 
kullanım için uygundur. Geçerli isteğin geçerli yol değerleri, bağlantı oluşturma için çevresel değerler olarak 
kabul edilir. ASP.NET Core MVC uygulamasının HomeContnoller"About eyleminde,—ortam değeri Home 
index eyleme bağlamak için denetleyici yolu değerini belirtmeniz gerekmez. 

Bir parametreyle eşleşmeyen çevresel değerler yok sayılır. Ayrıca, açıkça sağlanmış bir değer çevresel 
değeri geçersiz kıldığında çevresel değerler de yoksayılır. Eşleştirme, URL 'de soldan sağa doğru gerçekleşir. 

Açık olarak sağlanmış ancak yolun bir segmentiyle eşleşmeyen değerler sorgu dizesine eklenir.Aşağıdaki 
tabloda {controiier}/{action}/{id?} yol şablonu kullanılırken sonuç gösterilmektedir. 












ÇEVRESEL DEĞERLER 

AÇIK DEĞERLER 

SONUÇ 

denetleyici = "giriş" 

Action = "hakkında" 

/Home/About 

denetleyici = "giriş" 

denetleyici = "Order", Action = 
"hakkında" 

/Order/About 

denetleyici = "giriş", renk = "kırmızı" 

Action = "hakkında" 

/Home/About 

denetleyici = "giriş" 

Action = "hakkında", color = "Red" 

/Home/About?color=Red 

Bir rotada bir parametreye karşılık gelen bir varsayılan değer varsa ve 
varsayılan değerle eşleşmelidir: 

bu değer açıkça sağlanmışsa, 

routes.MapRoute("blog_route ", 

"blog/{*slug}". 


defaults: new { controiler 

= "Blog"j action = "ReadPost" }); 



Bağlantı oluşturma yalnızca controiler ve action için eşleşen değerler sağlandığında bu yol için bir 
bağlantı oluşturur. 


Karmaşık segmentler 

Karmaşık segmentler (örneğin [Route("/x{token}y")] ), sabit değerli olmayan değişmez değerler ile sağdan 
sola eşleştirilirken işlenir. Karmaşık segmentlerin nasıl eşleştirileceği hakkında ayrıntılı bir açıklama için bu 
koda bakın. Kod örneği AS P.N ET Core tarafından kullanılmaz, ancak karmaşık segmentler hakkında iyi bir 
açıklama sağlar. 









ASRNET Core hataları işleme 

6.12.2019 • 14 minutes to read ı Edit Online 


Tom Dykstra, Luke Lathamve Steve Smith tarafından 

Bu makalede AS P.N ET Core Web Apps 'teki hataları işlemeye yönelik yaygın yaklaşımlar ele alınmaktadır. 
Bkz. Web API 'Leri için ASP.NET Core Web API 'Lerinde hataları işleme. 

Görüntüleme veya indirme örnek kodu. (Nasıl indirilir.) Makale, farklı senaryoları etkinleştirmek için örnek 
uygulamada Önişlemci yönergelerinin ( #if , #endif , #define ) nasıl ayarlanacağı hakkında yönergeler içerir. 

Geliştirici özel durum sayfası 

Geliştirici özel durum sayfası , istek özel durumları hakkında ayrıntılı bilgileri görüntüler. Sayfa, Microsoft, 
aspnetcore. app metapackageiçindeki Microsoft. Aspnetcore. Diagnostics paketi tarafından kullanılabilir hale 
getirilir. Uygulama geliştirme ortamındaçalışırken sayfayı etkinleştirmek için startup.configure yöntemine 
kod ekleyin: 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

app.UseHsts(); 

} 

Özel durumları yakalamak istediğiniz herhangi bir ara yazılımın önüne UseDeveloperExceptionPage çağrısı 
koyun. 


VVARNING 

Geliştirici özel durum sayfasını yalnızca uygulama geliştirme ortamında çalışırkenetkinleştirin. Uygulama üretimde 
çalıştırıldığında ayrıntılı özel durum bilgilerini herkese açık bir şekilde paylaşmak istemezsiniz. Ortamları yapılandırma 
hakkında daha fazla bilgi için bkz. ASP.NET Core çoklu ortamları kullanma. 


Sayfa, özel durum ve istek hakkında şu bilgileri içerir: 

• Yığın izleme 

• Sorgu dizesi parametreleri (varsa) 

• Tanımlama bilgileri (varsa) 

• Üstbilgiler 

Örnek uygulamadageliştirici özel durum sayfasını görmek için, DevEnvironment Önişlemci yönergesini 
kullanın ve giriş sayfasında özel durum Tetikle ' yi seçin. 

Özel durum işleyici sayfası 

Üretim ortamı için özel bir hata işleme sayfası yapılandırmak için özel durum İşleme ara yazılımını kullanın. 
Ara yazılım: 









• Özel durumları yakalar ve günlüğe kaydeder. 

• İsteği, belirtilen sayfa veya denetleyici için alternatif bir ardışık düzende yeniden yürütür. Yanıt başlatılmışsa 
istek yeniden yürütülmez. 

Aşağıdaki örnekte UseExceptionHandler, özel durum İşleme ara yazılımını geliştirme olmayan ortamlara 
ekler: 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 
app.UseHsts(); 

} 

Razor Pages App Template, Sayfalar klasöründe bir hata sayfası (. cshtml) ve PageModel sınıfı ( ErrorModei ) 
sağlar. MVC uygulaması için, proje şablonu bir hata eylemi yöntemi ve bir hata görünümü içerir. Eylem 
yöntemi aşağıda verilmiştir: 

[AllowAnonymous] 

public IActionResult Error() 

{ 

return View(new ErrorViewModel 

{ Reqııestld = Activity .Current ?. Id ?? HttpContext.TraceIdentifier }); 

} 

Hata işleyicisi eylem yöntemini, HttpGet gibi HTTP yöntemi öznitelikleriyle işaretlemeyin. Açık fiiller bazı 
isteklerin yönteme ulaşmasını önler. Kimliği doğrulanmamış kullanıcıların hata görünümünü alabilmesi için 
metoda anonim erişime izin verin. 

Özel duruma erişin 

Hata işleyicisi denetleyicisi veya sayfasındaki özel duruma ve özgün istek yoluna erişmek için 

IExceptionHandlerPathFeature kullanın: 

var exceptionHandlerPathFeature = 

HttpContext.Features.Get<IExceptionHandlerPathFeature>(); 
if (exceptionHandlerPathFeature?.Error is FileNotFoundException) 

{ 

ExceptionMessage = "File error thrown"; 

} 

if (exceptionHandlerPathFeature?.Path == "/index") 

{ 

ExceptionMessage += " from home page"; 

} 


VVARNING 

istemcilere hassas hata bilgileri sunma. Hatalara hizmet vermek bir güvenlik riskidir. 


Örnek uygulamadakiözel durum işleme sayfasını görmek için ProdEnvironment ve ErrorHandierPage 
önişlemci yönergelerini kullanın ve giriş sayfasında bir özel durum Tetikle 1 yi seçin. 


Özel durum işleyici lambda 













Özel bir özel durum işleyici sayfasına bir alternatif, UseExceptionHandlerlambda sağlamaktır. Lambda 
kullanılması, yanıtı döndürmeden önce hataya erişim sağlar. 

Özel durum işleme için lambda kullanmanın bir örneği aşağıda verilmiştir: 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler(errorApp => 

{ 

errorApp.Run(async context => 

{ 

context.Response.StatusCode = 500; 
context.Response.ContentType = "text/html"; 

await context.Response.WriteAsync("<html lang=\"en\"xbody>\r\n"); 

await context.Response.WriteAsync(" ERROR !<brxbr>\r\n")j 

var exceptionHandlerPathFeature = 

context.Features.Get<IExceptionHandlerPathFeature>(); 

// Use exceptionHandlerPathFeature to process the exception (for example, 

// logging), but do NOT expose sensitlve error information directly to 
// the Client. 

if (exceptionHandlerPathFeature?.Error is FileNotFoundException) 

{ 

await context.Response.WriteAsync("File error thrown!<brxbr>\r\n"); 

} 

await context.Response.WriteAsync("<a href=\"/\">Home</axbr>\r\n"); 

await context.Response.WriteAsync("</bodyx/html>\r\n"); 

await context.Response.WriteAsync(new string(' 512)); // IE padding 

}); 

}); 

app.UseHsts(); 

} 



önişlemci yönergelerini kullanın ve giriş sayfasında bir özel durum Tetikle 1 yi seçin. 

UseStatusCodePages 

Varsayılan olarak, bir AS P.N ET Core uygulama HTTP durum kodları için 404-bulunamadıg\b\ bir durum 
kodu sayfası sağlamaz. Uygulama bir durum kodu ve boş bir yanıt gövdesi döndürür. Durum kodu sayfaları 
sağlamak için durum kodu sayfaları ara yazılımını kullanın. 

Ara yazılım, Microsoft, aspnetcore. app metapackageiçindeki Microsoft. Aspnetcore. Diagnostics paketi 
tarafından kullanılabilir hale gelir. 

Ortak hata durum kodları için varsayılan salt metin işleyicilerini etkinleştirmek üzere startup.configure 
yönteminde UseStatusCodePages çağırın: 








app.UsestatusCodePages(); 

istek işleme ara yazılımı (örneğin, statik dosya ara yazılımı ve MVC ara yazılımı) için önce usestatusCodePages 
çağırın. 

Varsayılan işleyiciler tarafından görüntülenbir metin örneği aşağıda verilmiştir: 

Status Code: 404; Not Found 

Örnek uygulamadakiçeşitli durum kodu sayfası biçimlerinden birini görmek için statusCodePages ile başlayan 
Önişlemci yönergelerinden birini kullanın ve giriş sayfasında 404 tetikleme ' yı seçin. 

Biçim dizesiyle UseStatusCodePages 

Yanıt içerik türünü ve metnini özelleştirmek için, içerik türü ve biçim dizesi alan UsestatusCodePages aşırı 
yüklemesini kullanın: 

app.UsestatusCodePages( 

"text/plain", "Status code page, status code: {0}"); 


Lambda ile UsestatusCodePages 

Özel hata işleme ve yanıt yazma kodu belirtmek için, lambda ifadesi alan UsestatusCodePages aşırı 
yüklemesini kullanın: 

app.UseStatusCodePages(async context => 

{ 

context.HttpContext.Response.ContentType = "text/plain "; 

await context.HttpContext.Response.WriteAsync( 

"Status code page, status code: " + 
context.HttpContext.Response.StatusCode); 

}); 


Usestatuscodepageswithyönlendirmeler 

UseStatusCodePagesVVİthRedirects uzantısı yöntemi: 

• İstemciye 302 tarafından bulunan bir durum kodu gönderir. 

• İstemciyi, URL şablonunda belirtilen konuma yönlendirir. 

app.UseStatusCodePagesWithRedirects("/StatusCode?code={0}"); 

URL şablonu, örnekte gösterildiği gibi durum kodu için bir { 0 } yer tutucu içerebilir. URL şablonu bir tilde (~) 
ile başlıyorsa, tilde uygulamanın PathBase alır. Uygulamanın içindeki bir uç noktayı işaret ederseniz, uç nokta 
için bir MVC görünümü veya Razor sayfası oluşturun. Razor Pages bir örnek için bkz. örnek uygulamadaki 
Pages/StatusCode. cshtml. 

Bu yöntem genellikle uygulama şu şekilde kullanılır: 

• , Genellikle farklı bir uygulamanın hatayı işlediği durumlarda istemciyi farklı bir uç noktaya 
yönlendirmelidir. Web Apps için, istemcinin tarayıcı adres çubuğu yeniden yönlendirilen uç noktayı yansıtır. 












• İlk yeniden yönlendirme yanıtıyla birlikte özgün durum kodunu korumamalıdır ve döndürmemelidir. 


UseStatusCodePagesWithReExecute 

UseStatusCodePagesWithReExecute uzantısı yöntemi: 

• istemciye özgün durum kodunu döndürür. 

• Alternatif bir yol kullanarak istek ardışık düzenini yeniden yürüterek yanıt gövdesini oluşturur. 

app.UseStatusCodePagesWithReExecute("/StatusCode" , "?code={0}"); 

Uygulamanın içindeki bir uç noktayı işaret ederseniz, uç nokta için bir MVC görünümü veya Razor sayfası 
oluşturun. Razor Pages bir örnek için bkz. örnek uygulamadaki Pages/StatusCode. cshtml. 

Bu yöntem genellikle uygulama şunları yaparken kullanılır: 

• Farklı bir uç noktaya yönlendirmeye gerek kalmadan isteği işleyin. Web Apps için, istemcinin tarayıcı adres 
çubuğu, ilk olarak istenen uç noktayı yansıtır. 

• Yanıt ile orijinal durum kodunu koruyun ve geri döndürün. 

URL ve sorgu dizesi şablonları durum kodu için bir yer tutucu ( { 0 } ) içerebilir.URL şablonu eğik çizgiyle ( / ) 
başlamalıdır. Yolda bir yer tutucu kullanırken, uç noktanın (sayfa veya denetleyicinin) yol kesimini işleyediğini 
doğrulayın. Örneğin, bir Razor sayfası, @page yönergesi ile isteğe bağlı yol segmenti değerini kabul etmelidir 

@page "{code?}" 

Hatayı işleyen uç nokta, aşağıdaki örnekte gösterildiği gibi, hatayı oluşturan özgün URL 'Yİ alabilir: 

var statusCodeReExecuteFeature = HttpContext.Features.Get<IStatusCodeReExecuteFeature>(); 
if (statusCodeReExecuteFeature != null) 

{ 

OriginalURL = 

statusCodeReExecuteFeature.OriginalPathBase 
+ statusCodeReExecuteFeature.OriginalPath 
+ statusCodeReExecuteFeature.OriginalQueryString; 

} 

Durum kodu sayfalarını devre dışı bırak 

MVC denetleyicisi veya eylem yöntemi için durum kodu sayfalarını devre dışı bırakmak için 
[skipstatusCodePages] özniteliğini kullanın. 

Razor Pages işleyici yöntemindeki veya bir MVC denetleyicisindeki belirli istekler için durum kodu sayfalarını 
devre dışı bırakmak için IStatusCodePagesFeaturekullanın: 

var statusCodePagesFeature = HttpContext.Features.Get<IStatusCodePagesFeature>(); 

if (statusCodePagesFeature != null) 

{ 

statusCodePagesFeature.Enabled = false; 

} 


Özel durum işleme kodu 







Özel durum işleme sayfalarındaki kod özel durumlar oluşturabilir.Üretim hatası sayfalarının tamamen statik 
içerikten oluşması genellikle iyi bir fikirdir. 

Yanıt üst bilgileri 

Yanıt üstbilgileri gönderildikten sonra: 

• Uygulama, yanıtın durum kodunu değiştiremiyor. 

• Tüm özel durum sayfaları veya işleyicileri çalıştırılamaz. Yanıt tamamlanmalıdır veya bağlantı iptal edilmiş 
olmalıdır. 

Sunucu özel durum işleme 

Uygulamanızın özel durum işleme mantığına ek olarak, http sunucusu uygulaması bazı özel durumları 
işleyebilir. Sunucu yanıt üstbilgileri gönderilmeden önce bir özel durum yakalarsa, sunucu yanıt gövdesi 
olmadan 500-lç sunucu hatası yanıtı gönderir. Yanıt üstbilgileri gönderildikten sonra sunucu bir özel durum 
yakalar, sunucu bağlantıyı kapatır. Uygulamanız tarafından işlenmeyen istekler sunucu tarafından işlenir. 
Sunucu isteği gerçekleştirirken oluşan tüm özel durumlar sunucunun özel durum işleme tarafından işlenir. 
Uygulamanın özel hata sayfaları, özel durum işleme ara yazılımı ve filtreler bu davranışı etkilemez. 

Başlatma özel durum işleme 

Uygulama başlangıcında gerçekleşen özel durumları yalnızca barındırma katmanı işleyebilir. Konak, Başlangıç 
hatalarını yakalamak ve ayrıntılı hataları yakalamakiçin yapılandırılabilir. 

Barındırma katmanı, yalnızca hatanın ana bilgisayar adresi/bağlantı noktası bağlamalarından sonra oluşması 
durumunda yakalanan başlatma hatası için bir hata sayfası gösterebilir. Bağlama başarısız olursa: 

• Barındırma katmanı, kritik bir özel durumu günlüğe kaydeder. 

• DotNet işlemi kilitleniyor. 

• HTTP sunucusu Kestrelolduğunda hata sayfası gösterilmez. 

IIS 'de (veya Azure App Service) veya IIS Expressçalışırken, işlem başlatılamazsa ASP.NET Core modülü 
tarafından 502,5 işlem hatası döndürülür. Daha fazla bilgi için bkz. Azure App Service ve IIS 'de ASP.NET 
Core sorunlarını giderme. 

Veritabanı hata sayfası 

Veritabam hata sayfası ara yazılımı, Entity Framework geçişleri kullanılarak çözümleneyolabilecek 
veritabanıyla ilgili özel durumları yakalar. Bu özel durumlar gerçekleştiğinde, sorunu çözmeye yönelik olası 
eylemlerin ayrıntılarını içeren bir HTML yanıtı oluşturulur. Bu sayfa yalnızca geliştirme ortamında 
etkinleştirilmelidir. startup.configure kod ekleyerek sayfayı etkinleştirin: 

if (env.IsDevelopment()) 

{ 

app.UseDatabaseErrorPage(); 

} 


Özel durum filtreleri 

MVC uygulamalarında özel durum filtreleri, genel olarak veya denetleyicide veya eylem temelinde 
yapılandırılabilir. Razor Pages uygulamalarda, genel olarak veya sayfa modeli başına yapılandırılabilirler. Bu 
filtreler, bir denetleyici eyleminin veya başka bir filtrenin yürütülmesi sırasında oluşan işlenmemiş özel 
durumları işler. Daha fazla bilgi için bkz. ASP.NET Core filtreler. 





TIP 

Özel durum filtreleri, MVC eylemleri içinde oluşan özel durumları yakalamak için yararlıdır, ancak özel durum İşleme ara 
yazılımı kadar esnek değildir. Ara yazılımı kullanmanızı öneririz. Yalnızca hangi MVC eyleminin seçilmesinden ayrı olarak 
hata işleme yapmanız gereken durumlarda filtreleri kullanın. 


Model durumu hataları 

Model durumu hatalarını işleme hakkında daha fazla bilgi için bkz. model bağlama ve model doğrulaması. 

Ek kaynaklar 

• Azure App Service ve 11S 'de ASP.N ET Core sorunlarını giderme 

• ASP.N ET Core ile Azure App Service ve MS için ortak hatalar başvurusu 




ASRNET Core 'de ıhttpclientfactory kullanarak HTTP 
istekleri yapın 
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Glenn CONDRON, Ryan şimdi ak, Steve Gordon, Rick Andersonve Kirk larkabağı 

Bir IHttpClientFactory, bir uygulamadaki HttpClient örnekleri yapılandırmak ve oluşturmak için kaydedilebilir ve 
kullanılabilir. İHttpciientFactory aşağıdaki avantajları sunar: 

• .Mantıksal HttpClient örneklerinin adlandırılması ve yapılandırılması için merkezi bir konum sağlar. 

Örneğin, GitHub adlı bir İstemci, GitHub'a erişmek için kaydedilebilir ve yapılandırılabilir. Varsayılan istemci, 
genel erişim için kaydedilebilir. 

• HttpClient , işleyiciler için temsilci atama yoluyla giden ara yazılım kavramını daha da artırır. HttpClient ' de 
işleyiciler temsilci seçme avantajlarından faydalanmak için, Polya tabanlı bir ara yazılım için uzantılar sağlar. 

• Temel alınan HttpciientMessageHandier örneklerinin biriktirmesini ve ömrünü yönetir. Otomatik yönetim, 

HttpClient yaşam sürelerini el ile yönetirken oluşan ortak DNS (etki alanı adı sistemi) sorunlarını önler. 

• Fabrika tarafından oluşturulan istemcilerle gönderilen tüm istekler için yapılandırılabilir bir günlük deneyimi ( 
iLogger aracılığıyla) ekler. 

Örnek kodu görüntüleyin veya indirin (nasıl indirilir). 

Bu konu sürümündeki örnek kod, FITTP yanıtlarında döndürülen JSON içeriğinin serisini kaldırmak için 
System.Text.Json kullanır. ison.NET ve ReadAsAsync<T> kullanan örnekler için, bu konunun 2. x sürümünü seçmek 
üzere sürüm seçiciyi kullanın. 

Tüketim desenleri 

Bir uygulamada iHttpciientFactory çeşitli yollar vardır: 

• Temel kullanım 

• Adlandırılmış istemciler 

• Yazılan istemciler 

• Oluşturulan istemciler 

En iyi yaklaşım, uygulamanın gereksinimlerine bağlı olarak değişir. 

Temel kullanım 

İHttpciientFactory , AddHttpciient çağırarak kaydedilebilir: 














public class Startup 

{ 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services .AddHttpClient(); 

// Remaining code deleted for brevity. 

iHttpdientFactory , bağımlılık ekleme (dı)kullanılarak istenebilir. Aşağıdaki kod, bir Httpciient örneği 
oluşturmak için İHttpdientFactory kullanır: 

public class BasicUsageModel : PageModel 

{ 

private readonly İHttpdientFactory _clientFactory; 

public IEnumerable<GitHubBranch> Branches { get; private set; } 

public bool GetBranchesError { get; private set; } 

public BasicUsageModel(IHttpClientFactory clientFactory) 

{ 

_clientFactory = clientFactory; 

} 

public async Task OnGet() 

{ 

var request = new HttpRequestMessage(HttpMethod.Get, 

"https://api.github.com/repos/aspnet/AspNetCore.Docs/branches"); 
request.Headers.Add("Accept", "application/vnd.github.v3+json"); 
request.Headers.Add("User-Agent", "HttpClientFactory-Sample"); 

var Client = _clientFactory.CreateClient(); 

var response = await Client.SendAsync(request); 

if (response.IsSuccessStatusCode) 

{ 

using var responseStream = await response.Content.ReadAsStreamAsync(); 

Branches = await IsonSerializer.DeserializeAsync 
<IEnumerable<GitHubBranch>>(responseStream); 

} 

else 

{ 

GetBranchesError = true; 

Branches = Array.Empty<GitHubBranch>(); 

} 

} 

} 

Yukarıdaki örnekte olduğu gibi iHttpdientFactory kullanmak, mevcut bir uygulamayı yeniden düzenleme için 
iyi bir yoldur. Httpciient kullanılma şekli üzerinde hiçbir etkisi yoktur. Mevcut bir uygulamada Httpciient 
örneklerinin oluşturulduğu yerlerde, bu oluşumları CreateC lientçağrılarıyla değiştirin. 

Adlandırılmış istemciler 

Adlandırılmış istemciler şu durumlarda iyi bir seçimdir: 

• Uygulama birçok farklı Httpciient kullanımı gerektirir. 









• Birçok Httpciient farklı yapılandırmaya sahiptir. 

Adlandırılmış bir Httpciient yapılandırması, startup.configureServices kayıt sırasında belirtilebil 

Services.AddHttpClient("github", c => 

{ 

c.BaseAddress = new Uri("https://api. github.com/"); 

// Github API versioning 

c.DefaultRequestHeaders.Add("Accept", "application/vnd.github.v3+json"); 

// Github requires a user-agent 

c.DefaultRequestHeaders.Add("User-Agent", "HttpClientFactory-Sample"); 

}); 

istemcinin yapılandırıldığı önceki kodda: 

• Temel adres https://api.github.com/ . 

• GitHub API 'SI ile çalışmak için iki üst bilgi gereklidir. 

CreateClient 

CreateClient her çağrıldığında: 

• Yeni bir Httpciient örneği oluşturulur. 

• Yapılandırma eylemi çağrılır. 

Adlandırılmış bir istemci oluşturmak için adını CreateClient geçirin: 







public class NamedClientModel : PageModel 

{ 

private readonly IHttpClientFactory _clientFactory; 

public IEnumerable<GitHubPullRequest> PullRequests { get; private set; } 

public bool GetPullRequestsError { get; private set; } 

public bool HasPullRequests => PullRequests.Any(); 

public NamedClientModel(IHttpClientFactory clientFactory) 

{ 

_clientFactory = clientFactory; 

} 

public async Task OnGet() 

{ 

var request = new HttpRequestMessage(HttpMethod.Get , 

"repos/aspnet/AspNetCore.Docs/pulls"); 

var Client = _clientFactory.CreateClient("github"); 

var response = await Client.SendAsync(request); 

if (response.IsSuccessStatusCode) 

{ 

using var responseStream = await response.Content.ReadAsStreamAsync(); 

PullRequests = await IsonSerializer.DeserializeAsync 

<IEnumerable<GitHubPullRequest>>(responseStream); 

} 

else 

{ 

GetPullRequestsError = true; 

PullRequests = Array.Empty<GitHubPullRequest>(); 

} 

} 

} 

Yukarıdaki kodda, isteğin bir ana bilgisayar adı belirtmesi gerekmez, istemci için yapılandırılan taban adresi 
kullanıldığından, kod yalnızca yolu geçirebilir. 

Yazılan istemciler 

Yazılan istemciler: 

• Dizeleri anahtar olarak kullanma gereksinimi olmadan, adlandırılmış istemcilerle aynı özellikleri sağlayın. 

• İstemcileri tükettiren I ntel I i S ense ve derleyici yardımı sağlar. 

• Yapılandırmak ve belirli bir Httpciient etkileşimde bulunmak için tek bir konum sağlayın. Örneğin, tek bir 
türü belirtilmiş istemci kullanılabilir: 

o Tek bir arka uç uç noktası için, 
o Uç nokta ile ilgili tüm mantığı kapsüllemek için. 

• Dİ ile birlikte çalışın ve uygulamada gerektiğinde eklenebilir. 


Türü belirtilmiş istemci, oluşturucusunda bir Httpciient parametresi kabul eder: 





public class GitHubService 

{ 

public HttpClient Client { get; } 

public GitHubService(HttpClient Client) 

{ 

Client.BaseAddress = new Uri("https://api. github.com/"); 

// GitHub API vensioning 

Client.DefaultRequestHeaders.Add("Accept", 

"application/vnd.github.v3+json"); 

// GitHub requires a user-agent 

Client.DefaultRequestHeaders.Add("User-Agent ", 

"HttpClientFactory-Sample"); 

Client = Client; 

} 

public async Task<IEnumerable<GitHubIssue>> GetAspNetDocsIssues() 

{ 

var response = await Client.GetAsync( 

"/repos/aspnet/AspNetCore.Docs/issues?state=open&sort=created&direction=desc"); 
response.EnsureSuccessStatusCode(); 

using var responseStream = await response.Content.ReadAsStreamAsync(); 
return await IsonSerializer.DeserializeAsync 
<IEnumerable<GitHubIssue>>(responseStream); 

} 

} 

Önceki kodda: 

• Yapılandırma, yazılan istemciye taşınır. 

• HttpClient nesnesi ortak bir özellik olarak sunulur. 

HttpClient işlevselliği ortaya çıkaran API 'ye özgü Yöntemler oluşturulabilir. Örneğin, GetAspNetDocsissues 
yöntemi açık sorunları almak için kodu kapsüller. 

Aşağıdaki kod, bir tür istemci sınıfını kaydetmek için startup.configureServices AddHttpClient çağırır: 

Services.AddHttpClient<GitHubService>(); 


Yazılan istemci, Dİ ile geçici olarak kaydedilir.Yazılan istemci doğrudan eklenebilir ve tüketilebilir: 








public class TypedClientModel : PageModel 

{ 

private readonly GitHubService _gitHubService; 

public IEnumerable<GitHubIssue> Latestlssues { get; private set; } 

public bool Haslssue => Latestlssues.Any(); 

public bool GetlssuesError { get; private set; } 

public TypedClientModel(GitHubService gitHubService) 

{ 

_gitHubService = gitHubService; 

} 

public async Task OnGet() 

{ 

try 

{ 

Latestlssues = await _gitHubService.GetAspNetDocsIssues(); 

} 

catch(HttpRequestException) 

{ 

GetlssuesError = true; 

Latestlssues = Array.Empty<GitHubIssue>(); 

} 

} 

} 


Türü belirlenmiş bir istemcinin yapılandırması, türü belirlenmiş istemcinin Oluşturucusu yerine 
startup.configureServices kayıt sırasında belirtilebilir: 

Services.AddHttpClient<RepoService>(c => 

{ 

c.BaseAddress = new Uri("https://api. github.com/"); 

c.DefaultRequestHeaders.Add("Accept", "application/vnd.github.v3+json"); 
c.DefaultRequestHeaders.Add("User-Agent", "HttpClientFactory-Sample"); 

}); 

Httpciient , türü belirlenmiş bir istemci içinde kapsüllenebilir. Bunu bir özellik olarak göstermek yerine, 
Httpciient örneğini dahili olarak çağıran bir yöntem tanımlayın: 



public class RepoService 

{ 

// _httpClient isn't exposed publicly 
private readonly HttpClient _httpClient; 

public RepoService(HttpClient Client) 

{ 

_httpClient = Client; 

} 

public async Task<IEnumerable<string>> GetRepos() 

{ 

var response = await _httpClient.GetAsync("aspnet/repos"); 
response.EnsureSuccessStatusCode(); 

using var responseStream = await response.Content.ReadAsStreamAsync(); 
return await IsonSerializer.DeserializeAsync 
<IEnumerable<string>>(responseStream); 

} 

} 

Yukarıdaki kodda HttpClient bir özel alanda depolanır. HttpClient erişim, genel GetRepos yöntemine göre 
yapılır. 

Oluşturulan istemciler 

iHttpciientFactory , yeniden sığdırmagibi üçüncü taraf kitaplıklarla birlikte kullanılabilir. Yeniden sığdırma, .N ET 
için bir REST kitaplığıdır. REST API 'Leri canlı arabirimlere dönüştürür. Bir arabirimin uygulanması, dış HTTP 
çağrılarını yapmak için HttpClient kullanılarak Restservice tarafından dinamik olarak oluşturulur. 

Bir arabirim ve yanıt, dış API 'yi ve yanıtını temsil edecek şekilde tanımlanır: 


public interface IHelloClient 

{ 

[Get("/helloworld")] 

Task<Reply> GetMessageAsync(); 

} 

public class Reply 

{ 

public string Message { get; set; } 

} 


Türü belirlenmiş bir istemci eklenebilir, uygulamayı oluşturmak için yeniden sığdırma kullanımı kullanılabilir: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddHttpClient("hello", c => 

{ 

c.BaseAddress = new Uri("http://localhost:5000"); 

}) 

.AddTypedClient(c => Refit.RestService.For<IHelloClient>(c)); 

Services .AddCont rollers(); 

} 


Tanımlı arabirim, gereken yerde, mak ve Refit tarafından sağlanmış uygulama ile kullanılabilir. 











[ApiContnollen] 

public class ValuesController : ContnollenBase 
{ 

private readonly IHelloClient _client; 

public ValuesController(IHelloClient Client) 

{ 

_client = Client; 

} 

[HttpGet("/")] 

public async Task<ActionResult<Reply>> Index() 
{ 

netunn await _client.GetMessageAsync(); 

} 


Giden istek ara yazılımı 

Httpciient , giden HTTP istekleri için bir araya bağlanabilen işleyicileri temsilci seçme kavramıdır. 
IHttpClientFactony : 

• Her bir adlandırılmış istemci için uygulanacak işleyiciler tanımlamayı basitleştirir. 

• Bir giden istek ara yazılım işlem hattı oluşturmak için birden çok işleyicinin kaydedilmesini ve zincirleme 
kullanımını destekler. Bu işleyicilerin her biri, giden istekten önce ve sonra iş gerçekleştirebilir. Bu model: 

o AS P.N ET Core gelen ara yazılım ardışık düzenine benzerdir. 

o , HTTP istekleri etrafında çapraz kesme sorunlarını yönetmek için bir mekanizma sağlar, örneğin: 

o önbelleğe alma 
o hata işleme 
o serileştirme 
o günlük kaydı 

Temsilci seçme işleyicisi oluşturmak için: 

• DelegatingHandlertüret. 

• SendAsyncgeçersiz kıl. isteği ardışık düzen içindeki bir sonraki işleyiciye geçirmeden önce kodu yürütün 


public class ValidateHeadenHandlen : DelegatingHandlen 
{ 

pnotected ovennide async Task<HttpResponseMessage> SendAsync( 
HttpRequestMessage nequest, 

CancellationToken cancellationToken) 

{ 

if (I request .Headers .Contains("X-API-KEY")) 

{ 

netunn new HttpResponseMessage(HttpStatusCode.BadRequest) 

{ 

Content = new StningContent( 

"You must supply an API key headen called X-API-KEY") 

}; 

} 

netunn await base.SendAsync(nequest, cancellationToken); 





Yukarıdaki kod, x-api-key üst bilgisinin istekte olup olmadığını denetler. x-api-key eksikse, BadRequest 
döndürülür. 

Microsoft.Extensions.Dependencylnjection.HttpClientBuilderExtensions.AddHttpMessageHandlerbir Httpciient 
yapılandırmaya birden fazla işleyici eklenebilir: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddTransient<ValidateHeaderHandler>(); 

Services.AddHttpClient("externalservice", c => 

{ 

// Assume this is an "external" service which requires an API KEY 
c.BaseAddress = new Uri("https://localhost:5001/"); 

}) 

.AddHttpMessageHandler<ValidateHeaderHandler>(); 

// Remaining code deleted for brevity. 

Yukarıdaki kodda vaüdateHeaderHandier Dİ ile kaydedilir. iHttpClientFactory her işleyici için ayrı bir dı kapsamı 
oluşturur, işleyiciler herhangi bir kapsamın hizmetlerine bağlı olabilir, işleyicilerin bağımlı olduğu hizmetler, 
işleyicinin elden çıkarılmasıyla kaldırılır. 

Kaydedildikten sonra, işleyicinin türü olarak AddHttpMessageHandler çağrılabilir. 

Birden çok işleyici, yürütülmesi gereken sırayla kaydedilebilir. Her işleyici, son HttpciientHandier isteği 
çalıştırana kadar sonraki işleyiciyi sarmalar: 

Services.AddTransient<SecureRequestHandler>(); 

Services.AddTransient<RequestDataHandler>(); 

Services.AddHttpClient("clientwithhandlers") 

// This handler is on the outside and called first during the 
// request, last during the response. 

.AddHttpMessageHandler<SecureRequestHandler>() 

// This handler is on the inside, closest to the request being 
// sent. 

.AddHttpMessageHandler<RequestDataHandler>(); 

ileti işleyicileriyle istek başına durumu paylaşmak için aşağıdaki yaklaşımlardan birini kullanın: 

• HttpRequestMessage. Propertieskullanarak işleyicide veri geçirin. 

• Geçerli isteğe erişmek için IHttpContextAccessor kullanın. 

• Verileri geçirmek için özel bir AsyncLocakT> depolama nesnesi oluşturun. 

Polly tabanlı işleyiciler kullanın 

İHttpClientFactory , üçüncü taraf kitaplığı Pollyile tümleşir. Polly, .N ET için kapsamlı bir esnekliği ve geçici hata 
işleme kitaplığıdır. Geliştiricilerin yeniden deneme, devre kesici, zaman aşımı, Bulkbaş yalıtımı, akıcı ve iş 
parçacığı açısından güvenli bir şekilde geri dönüş gibi ilkeler almasına olanak tanır. 

Uzantı yöntemleri, yapılandırılmış Httpciient örnekleri ile Polly ilkelerin kullanımını etkinleştirmek için sağlanır. 
Polly uzantıları, istemcilere Polly tabanlı işleyiciler eklemeyi destekler. Polly, Microsoft. Extensions. http. Polly 
NuGet paketini gerektirir. 

Geçici hataları işle 

Hatalar genellikle dış HTTP çağrıları geçici olduğunda oluşur. AddTransientHttpErrorPolicy, geçici hataları 
işlemek için bir ilkenin tanımlanmasını sağlar. AddTransientHttpErrorPolicy ile yapılandırılan ilkeler aşağıdaki 















yanıtları işleyecek şekilde yapılandırılır: 

• HttpRequestException 

• HTTP 5xx 

• HTTP 408 

AddTransientHttpErrorPolicy , olası bir geçici hatayı temsil eden hataları işlemek için yapılandırılmış bir 
PolicyBuiider nesnesine erişim sağlar: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddHttpClient<UnreliableEndpointCallerService>() 

.AddTransientHttpErrorPolicy(p => 

p.WaitAndRetryAsync(3, _ => TimeSpan.FromMilliseconds(600))); 

// Remaining code deleted for brevity. 

Yukarıdaki kodda waitAndRetryAsync bir ilke tanımlanmıştır. Başarısız istekler, denemeler arasındaki 600 MS 
gecikmeyle en fazla üç kez yeniden denenir. 

Dinamik olarak ilke seçme 

Uzantı yöntemleri, örneğin AddPolicyHandler, Polly tabanlı işleyiciler eklemek için sağlanır.Aşağıdaki 
AddPolicyHandler aşırı yüklemesi hangi ilkenin uygulanacağını belirlemek için isteği inceler: 

var timeout = Policy.TimeoutAsync<HttpResponseMessage>( 

TimeSpan.FromSeconds(10)); 

var longTimeout = Policy.TimeoutAsync<HttpResponseMessage>( 

TimeSpan.FromSeconds(30)); 

Services.AddHttpClient("conditionalpolicy") 

// Run some code to select a policy based on the request 
.AddPolicyHandler(request => 

request.Method == HttpMethod.Get ? timeout : longTimeout); 


Yukarıdaki kodda, giden istek bir HTTP GET ise, 10 saniyelik birzaman aşımı uygulanır.Diğer HTTP yöntemleri 
için, 30 saniyelik bir zaman aşımı kullanılır. 

Birden çok Polly işleyici ekleme 

Polly ilkeleri iç içe almak yaygın bir şekilde yapılır: 

Services.AddHttpClient("multiplepolicies") 

.AddTransientHttpErrorPolicy(p => p.RetryAsync(3)) 

.AddTransientHttpErrorPolicy( 

p => p.CircuitBreakerAsync(5, TimeSpan.FromSeconds(30))); 


Yukarıdaki örnekte: 

• iki işleyici eklenir. 

• ilk işleyici, yeniden deneme ilkesi eklemek için AddTransientHttpErrorPolicy kullanır. Başarısız istekler en fazla 
üç kez yeniden denenir. 

• ikinci AddTransientHttpErrorPolicy çağrısı bir devre kesici ilkesi ekler. 5 başarısız girişim sıralı olarak 
gerçekleşirse, daha fazla dış istek 30 saniye boyunca engellenir. Devre kesici ilkeleri durum bilgisi vardır. Bu 
istemci aracılığıyla yapılan tüm çağrılar aynı devre durumunu paylaşır. 

Polly kayıt defterinden ilke ekleme 

Düzenli olarak kullanılan ilkeleri yönetmeye yönelik bir yaklaşım, bunları bir kez tanımlamak ve bir 





PoiicyRegistny kaydetmektir. 


Aşağıdaki kodda: 

• "Normal" ve "uzun" ilkeler eklenmiştir. 

• AddPolicyHandlerFromRegistry, kayıt defterinden "normal" ve "uzun" ilkeleri ekler. 

public void ConfigureServices(IServiceCollection Services) 

{ 

var timeout = Policy.TimeoutAsync<HttpResponseMessage>( 

TimeSpan.FromSeconds(10)); 

var longTimeout = Policy.TimeoutAsync<HttpResponseMessage>( 

TimeSpan.FromSeconds(30)); 

var registry = Services. AddPolicyRegistryO; 

registry.Add("regular ", timeout); 
registry.Add("long ", longTimeout); 

Services.AddHttpClient("regularTimeoutHandler") 

.AddPolicyHandlerFromRegistry("regular"); 

Services.AddHttpClient("longTimeoutHandler") 

.AddPolicyHandlerFromRegistry("long"); 

// Remaining code deleted for brevity. 

THttpciientFactory ve Polly tümleştirmeler hakkında daha fazla bilgi için bkz. Polly wiki. 


HttpClient ve ömür yönetimi 


İHttpciientFactory''CreateClient 

her çağrıldığında yeni bir 

HttpClient 

örneği döndürülür. Adlandırılmış 

istemci başına bir HttpMessageHandler oluşturulur. Fabrika 

HttpMessageHandler 

örneklerinin yaşam sürelerini 


yönetir. 

kaynak tüketimini azaltmak için fabrika tarafından oluşturulan HttpMessageHandler örnekleri iHttpciientFactory 
havuzlar. HttpMessageHandler bir örnek, süresi dolmamışsa yeni bir HttpClient örneği oluşturulurken havuzdan 
yeniden kullanılabilir. 

Her işleyici genellikle kendi temel HTTP bağlantılarını yönettiğinden, işleyicilerin havuzlaması tercih edilir. 
Gerekenden daha fazla işleyici oluşturulması bağlantı gecikmeleri oluşmasına neden olabilir. Ayrıca, bazı 
işleyiciler bağlantıları süresiz olarak açık tutar, bu da işleyicinin DNS (etki alanı adı sistemi) değişikliklerine 
yeniden davranmasını engelleyebilir. 

Varsayılan işleyici ömrü iki dakikadır.Varsayılan değer, adlandırılmış istemci temelinde geçersiz kılınabilir: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddHttpClient("extendedhandlerlifetime") 

.SetHandlerLifetime(TimeSpan.FromMinutes(5)); 

// Remaining code deleted for brevity. 

HttpClient örnekleri genellikle aktiften çıkarma gerektirmeyen .N ET nesneleri olarak kabul edilebilir. 
Aktiften çıkarma giden istekleri iptal eder ve Disposeçağrıldıktan sonra verilen HttpClient örneğinin 
kullanılamaz olmasını sağlar. iHttpciientFactory , HttpClient örnekleri tarafından kullanılan kaynakları izler ve 
ortadan kaldırır. 

Tekbir HttpClient örneğinin uzun süre canlı tutulması, iHttpciientFactory önünde kullanılmadan önce 















kullanılan ortak bir modeldir. Bu kalıp iHttpciientFactory geçtikten sonra gereksiz hale gelir. 

I httpclientfactory alternatifleri 

Dı özellikli bir uygulamada iHttpciientFactory kullanmak şunları önler: 

• HttpMessageHandler örnekleri havuza alarak kaynak tükenmesi sorunları. 

• Düzenli aralıklarla HttpMessageHandler örnekleri arasında geçiş yaparak eski DNS sorunları. 

Uzun süreli SocketsHttpHandler örneği kullanarak önceki sorunları çözmenin alternatif yolları vardır. 

• Uygulama başlatıldığında SocketsHttpHandler örneğini oluşturun ve uygulamanın ömrü boyunca kullanın. 

• PooledConnectionLifetime DNS yenileme zamanına göre uygun bir değere yapılandırın. 

• Gerektiğinde new Httpciient(handier, dispostHandler: faise) kullanarak HttpClient örnekleri oluşturun. 

Yukarıdaki yaklaşımlar iHttpciientFactory benzer bir şekilde çözdüğü kaynak yönetimi sorunlarını çözer. 

• SocketsHttpHandler , HttpClient örnekleri arasında bağlantıları paylaşır. Bu paylaşım, yuva azalmasına engel 
olur. 

• SocketsHttpHandler , eski DNS sorunlarından kaçınmak için bağlantıları PooledConnectionLifetime göre 
döngüler. 

Özgü 

Havuza alınmış HttpMessageHandler örnekleri, cookieContainer nesneleri paylaşılmasına neden olur. 
Beklenmeyen CookieContainer nesne paylaşımı genellikle hatalı kodla sonuçlanır. Tanımlama bilgileri gerektiren 
uygulamalar için şunlardan birini göz önünde bulundurun: 

• Otomatik tanımlama bilgisi işlemeyi devre dışı bırakma 

• İHttpciientFactory Önleme 

Otomatik tanımlama bilgisi işlemeyi devre dışı bırakmak için ConfigurePrimaryHttpMessageHandler çağırın: 

Services.AddHttpClient("configured-disable-automatic-cookies") 

.ConfigurePrimaryHttpMessageHandler(() => 

{ 

return new SocketsHttpHandler() 

{ 

UseCookies = faise, 

}J 

})J 


Günlüğe Kaydetme 

Tüm istekler için İHttpciientFactory kayıt günlüğü iletileri aracılığıyla oluşturulan istemciler. Varsayılan günlük 
iletilerini görmek için günlük yapılandırmasında uygun bilgi düzeyini etkinleştirin. İstek üst bilgilerinin günlüğe 
kaydedilmesi gibi ek Günlükler yalnızca izleme düzeyinde yer alır. 

Her istemci için kullanılan günlük kategorisi, istemcinin adını içerir.Örneğin, Mynamedclientad\\ bir istemci, 
"System .net. http. HttpClient" kategorisine sahip iletileri günlüğe kaydeder. Mynamedclient. LogicalHandler", 
Logicalhandler ile düzeltilen iletiler istek işleyicisi ardışık düzeni dışında oluşur, istekte, işlem hattındaki diğer 
işleyiciler işlenmeden önce iletiler günlüğe kaydedilir. Yanıtta, tüm diğer işlem hattı işleyicileri yanıtı aldıktan 
sonra iletiler günlüğe kaydedilir. 

Günlüğe kaydetme, istek işleyicisi ardışık düzeni içinde de gerçekleşir .Mynamedclient örneğinde, bu İletiler 
"System .net. http. HttpClient" günlük kategorisiyle günlüğe kaydedilir. Mynamedclient. ClientHandler", istek 
için bu, tüm diğer işleyiciler çalıştırıldıktan sonra ve istek gönderilmeden hemen önce gerçekleşir. Yanıtta, bu 
günlüğe kaydetme, işleyicinin işleyici işlem hattı üzerinden geri geçirmeden önce yanıtın durumunu içerir. 


















işlem hattının dışında ve içinde günlüğe kaydetmenin etkinleştirilmesi, diğer işlem hattı işleyicileri tarafından 
yapılan değişikliklerin incelemesini etkinleştirir. Bu, istek üst bilgilerinde veya yanıt durum kodunda yapılan 
değişiklikleri içerebilir. 

istemcinin adını log kategorisinde da içermek, belirli adlandırılmış istemciler için günlük filtrelemeyi sunar. 

HttpMessageHandler 'ı yapılandırma 

istemci tarafından kullanılan iç HttpMessageHandler yapılandırmasını denetlemek gerekli olabilir. 

Adlandırılmış veya yazılan istemciler eklenirken bir iHttpciientBuiider döndürülür. 

ConfigurePrimaryHttpMessageHandler uzantısı yöntemi bir temsilciyi tanımlamak için kullanılabilir. Temsilci, bu 
istemci tarafından kullanılan birincil HttpMessageHandler oluşturmak ve yapılandırmak için kullanılır: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddHttpClient("configured-inner-handler") 

.ConfigurePrimaryHttpMessageHandler(() => 

{ 

return new HttpClientHandler() 

{ 

AllowAutoRedirect = false, 

UseDefaultCredentials = true 

}; 

}); 

// Remaining code deleted for brevity. 


Konsol uygulamasında ıhttpclientfactory kullanma 

Konsol uygulamasında, aşağıdaki paket başvurularını projeye ekleyin: 

• Microsoft. Extensions. Hosting 

• Microsoft. Extensions. http 

Aşağıdaki örnekte: 

• IHttpClientFactory, genel konağın hizmet kapsayıcısına kaydedilir. 

• MyService , hizmetten bir Httpciient oluşturmak için kullanılan bir istemci fabrikası örneği oluşturur. 
Httpciient , bir Web sayfasını almak için kullanılır. 

• Main , hizmetin GetPage yöntemini yürütmek için bir kapsam oluşturur ve Web sayfası içeriğinin ilk 500 
karakterini konsola yazar. 


using System; 

using System.Net.Http; 

using System.Threading.Tasks; 

using Microsoft. Extensions .Dependencylnjection; 

using Microsoft. Extensions .Hosting; 

using Microsoft. Extensions. Logging; 

class Program 

{ 

static async Task<int> Main(string[] args) 

{ 

var builder = new HostBuilder() 

.ConfigureServices((hostContextj Services) => 

{ 

Services .AddHttpClient(); 

Services.AddTransient<IMyService 3 MyService>(); 
}) .UseConsoleLifetime(); 







var hoşt = builder.Build(); 


using (var serviceScope = hoşt.Services.CreateScope()) 

{ 

var Services = serviceScope.ServiceProvider; 

try 

{ 

var myService = Services.GetRequiredService<IMyService>(); 
var pageContent = await myService.GetPage(); 

Console.WriteLine(pageContent.Substring(0j 500)); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<ILogger<Program>>(); 
logger.LogError(ex, "An error occurred."); 

} 

} 

return 0; 

} 

public interface IMyService 

{ 

Task<string> GetPage(); 

} 

public class MyService : IMyService 

{ 

private readonly IHttpClientFactory _clientFactory; 

public MyService(IHttpClientFactory clientFactory) 

{ 

_clientFactory = clientFactory; 

} 

public async Task<string> GetPage() 

{ 

// Content from BBC One: Dr. Who website (©BBC) 
var request = new HttpRequestMessage(HttpMethod.Get, 
"https://www.bbc . co.uk/programmes/b006q2x0"); 
var Client = _clientFactory.CreateClient(); 
var response = await Client.SendAsync(request); 

if (response.IsSuccessStatusCode) 

{ 

return await response.Content.ReadAsStringAsync(); 

} 

else 

{ 

return $"StatusCode: {response.StatusCode}"; 

} 

} 

} 

} 


Ek kaynaklar 

• Dayanıklı HTTP isteklerini uygulamak için HttpClientFactory kullanma 

• HttpClientFactory ve Polly ilkeleriyle üstel geri alma ile HTTP çağrı yeniden denemeleri uygulayın 

• Devre Kesici desenini uygulama 
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Bir IHttpClientFactory, bir uygulamadaki HttpClient örnekleri yapılandırmak ve oluşturmak için kaydedilebilir ve 
kullanılabilir. Aşağıdaki avantajları sunar: 

• .Mantıksal HttpClient örneklerinin adlandırılması ve yapılandırılması için merkezi bir konum sağlar. 
Örneğin, GitHub istemcisi kayıtU ve GitHub'a erişebilecek şekilde yapılandırılabilir. Varsayılan istemci, diğer 
amaçlar için kaydedilebilir. 

• HttpClient ' de işleyiciler temsilci seçme yoluyla giden ara yazılım kavramını daha da artırır ve bundan 
faydalanmak için, Polya tabanlı ara yazılım için uzantılar sağlar. 

• HttpClient yaşam sürelerini el ile yönetirken gerçekleşen yaygın DNS sorunlarından kaçınmak için temel 
HttpClientMessageHandler örneklerinin biriktirmesini ve ömrünü yönetir. 

• Fabrika tarafından oluşturulan istemcilerle gönderilen tüm istekler için yapılandırılabilir bir günlük deneyimi ( 
nogger aracılığıyla) ekler. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Tüketim desenleri 

Bir uygulamada IHttpClientFactory çeşitli yollar vardır: 

• Temel kullanım 

• Adlandırılmış istemciler 

• Yazılan istemciler 

• Oluşturulan istemciler 

Hiçbiri diğerinden tamamen üst değildir. En iyi yaklaşım, uygulamanın kısıtlamalarına bağlıdır. 

Temel kullanım 


IHttpClientFactory , 

Startup.ConfigureServices 

yönteminin içindeki 

IServiceCollection''AddHttpClient 

genişletme yöntemi çağırarak kaydedilebilir. 




Services .AddHttpClient(); 

Kaydedildikten sonra kod, bağımlılık ekleme (dı)ile her yerden IHttpClientFactory kabul edebilir. 
IHttpClientFactory , bir HttpClient örneği oluşturmak için kullanılabilir: 












public class BasicUsageModel : PageModel 

{ 

private readonly IHttpClientFactory _clientFactory; 

public IEnumerable<GitHubBranch> Branches { get; private set; } 

public bool GetBranchesError { get; private set; } 

public BasicUsageModel(IHttpClientFactory clientFactory) 

{ 

_clientFactory = clientFactory; 

} 

public async Task OnGet() 

{ 

var request = new HttpRequestMessage(HttpMethod.Get , 

"https://api.github.com/repos/aspnet/AspNetCore.Docs/branches"); 
request.Headers.Add("Accept", "application/vnd.github.v3+json"); 
request.Headers.Add("User-Agent", "HttpClientFactory-Sample"); 

var Client = _clientFactory.CreateClient(); 

var response = await Client. SendAsync(request); 

if (response.IsSuccessStatusCode) 

{ 

Branches = await response.Content 

.ReadAsAsync<IEnumerable<GitHubBranch>>(); 

} 

else 

{ 

GetBranchesError = true; 

Branches = Array.Empty<GitFlubBranch>(); 

} 

} 

} 

Bu biçimde IHttpClientFactory kullanmak, mevcut bir uygulamayı yeniden düzenleme için iyi bir yoldur. 
Httpciient kullanılma şekli üzerinde hiçbir etkisi yoktur. Httpciient örneklerinin Şu anda oluşturulduğu 
yerlerde, bu oluşumların CreateClientçağrısı ile değiştirin. 

Adlandırılmış istemciler 

Bir uygulama, her biri farklı bir yapılandırmaya sahip 
adlandırılmış istemcilerkullanılır. Adlandırılmış bir 
kayıt sırasında belirtilebilir. 

Services.AddHttpClient("github", c => 

{ 

c.BaseAddress = new Uri("https://api. github.com/"); 

// Github API versioning 

c.DefaultRequestHeaders.Add("Accept", "application/vnd.github.v3+json"); 

// Github requires a user-agent 

c.DefaultRequestHeaders.Add("User-Agent", "HttpClientFactory-Sample"); 

}); 

Yukarıdaki kodda AddHttpciient , GitHubadU adı sağlar. Bu istemci, GitHub API 'SI ile çalışmak için gerekli olan 
temel adres ve iki üst bilgiyle—uygulanmış olan bazı varsayılan yapılandırmaları içerir. 

createciient her çağrıldığında, yeni bir Httpciient örneği oluşturulur ve yapılandırma eylemi çağrılır. 

Adlandırılmış bir istemciyi kullanmak için, createciient bir dize parametresi geçirilebilir. Oluşturulacak 
istemcinin adını belirtin: 


Httpciient birçok farklı kullanım gerektiriyorsa, 
Httpciient yapılandırması, Startup.ConfigureServices 












public class NamedClientModel : PageModel 

{ 

private readonly IHttpClientFactory _clientFactory; 

public IEnumerable<GitHubPullRequest> PullRequests { get; private set; } 

public bool GetPullRequestsError { get; private set; } 

public bool HasPullRequests => PullRequests.Any(); 

public NamedClientModel(IHttpClientFactory clientFactory) 

{ 

_clientFactory = clientFactory; 

} 

public async Task OnGet() 

{ 

var request = new HttpRequestMessage(HttpMethod.Get , 

"repos/aspnet/AspNetCore.Docs/pulls"); 

var Client = _clientFactory.CreateClient("github"); 

var response = await Client.SendAsync(request); 

if (response.IsSuccessStatusCode) 

{ 

PullRequests = await response.Content 

.ReadAsAsync<IEnumerable<GitHubPullRequest>>(); 

} 

else 

{ 

GetPullRequestsError = true; 

PullRequests = Array.Empty<GitHubPullRequest>(); 

} 

} 

} 

Yukarıdaki kodda, isteğin bir ana bilgisayar adı belirtmesi gerekmez, istemci için yapılandırılan taban adresi 
kullanıldığından, bu yalnızca yolu geçirebilir. 

Yazılan istemciler 

Yazılan istemciler: 

• Dizeleri anahtar olarak kullanma gereksinimi olmadan, adlandırılmış istemcilerle aynı özellikleri sağlayın. 

• istemcileri tükettiren I ntel I i S ense ve derleyici yardımı sağlar. 

• Yapılandırmak ve belirli bir Httpciient etkileşimde bulunmak için tek bir konum sağlayın. Örneğin, tek bir 
arka uç uç noktası için tek bir adet yazılmış istemci kullanılabilir ve bu uç nokta ile ilgili tüm mantığı 
kapsüllenebilir. 

• Dİ ile birlikte çalışın ve uygulamanızda gerektiğinde eklenebilir. 


Türü belirtilmiş istemci, oluşturucusunda bir Httpciient parametresi kabul eder: 




public class GitHubService 

{ 

public HttpClient Client { get; } 

public GitHubService(HttpClient Client) 

{ 

Client.BaseAddress = new Uri("https://api. github.com/"); 

// GitHub API vensioning 

Client.DefaultRequestHeaders.Add("Accept", 

"application/vnd.github.v3+json"); 

// GitHub requires a user-agent 

Client.DefaultRequestHeaders.Add("User-Agent ", 

"HttpClientFactory-Sample"); 

Client = Client; 

} 

public async Task<IEnumerable<GitHubIssue>> GetAspNetDocsIssues() 

{ 

var response = await Client.GetAsync( 

"/repos/aspnet/AspNetCore.Docs/issues?state=open&sort=created&direction=desc"); 

response.EnsureSuccessStatusCode(); 

var result = await response.Content 

.ReadAsAsync<IEnumerable<GitHubIssue>>(); 

return result; 

} 

} 

Önceki kodda, yapılandırma yazılan istemciye taşınır. HttpClient nesnesi ortak bir özellik olarak sunulur. 
HttpClient işlevselliği ortaya çıkaran API 'ye özel yöntemler tanımlamak mümkündür. GetAspNetDocsissues 
yöntemi, GitHub deposundan en son açık sorunları sorgulamak ve ayrıştırmak için gereken kodu kapsüller. 

Türü belirtilmiş bir istemciyi kaydetmek için genel AddHttpClient uzantısı yöntemi, türü belirlenmiş istemci 
sınıfını belirterek startup.configureServices içinde kullanılabilir: 

Services.AddHttpClient<GitHubService>(); 


Yazılan istemci, Dİ ile geçici olarak kaydedilir. Yazılan istemci doğrudan eklenebilir ve tüketilebilir: 







public class TypedClientModel : PageModel 

{ 

private readonly GitHubService _gitHubService; 

public IEnumerable<GitHubIssue> Latestlssues { get; private set; } 

public bool Haslssue => Latestlssues.Any(); 

public bool GetlssuesError { get; private set; } 

public TypedClientModel(GitHubService gitHubService) 

{ 

_gitHubService = gitHubService; 

} 

public async Task OnGet() 

{ 

try 

{ 

Latestlssues = await _gitHubService.GetAspNetDocsIssues(); 

} 

catch(HttpRequestException) 

{ 

GetlssuesError = true; 

Latestlssues = Array.Empty<GitHubIssue>(); 

} 

} 

} 


Tercih edilirse, yazılan istemcinin yapılandırması, türü belirlenmiş istemcinin Oluşturucusu yerine 
startup.configureServices kayıt sırasında belirtilebilir: 

Services.AddHttpClient<RepoService>(c => 

{ 

c.BaseAddress = new Uri("https://api. github.com/"); 

c.DefaultRequestHeaders.Add("Accept", "application/vnd.github.v3+json"); 
c.DefaultRequestHeaders.Add("User-Agent", "HttpClientFactory-Sample"); 

}); 

Türü belirlenmiş bir istemci içinde tamamen kapsül Httpciient lemek mümkündür. Bunu bir özellik olarak 
göstermek yerine, Httpciient örneğini dahili olarak çağıran ortak Yöntemler sunulabilir. 





public class RepoService 

{ 

// _httpClient isn't exposed publicly 
private readonly HttpClient _httpClient; 

public RepoService(HttpClient Client) 

{ 

_httpClient = Client; 

} 

public async Task<IEnumerable<string>> GetRepos() 

{ 

var response = await _httpClient.GetAsync("aspnet/repos"); 

response.EnsureSuccessStatusCode(); 

var result = await response.Content 

.ReadAsAsync<IEnumerable<string>>(); 

return result; 

} 

} 

Yukarıdaki kodda HttpClient bir özel alan olarak depolanır. Dış çağrıları yapmak için tüm erişim GetRepos 
yönteminden geçer. 

Oluşturulan istemciler 

iHttpciientFactory , yeniden sığdırmagibi diğer üçüncü taraf kitaplıklarla birlikte kullanılabilir. Yeniden sığdırma, 
.NET için bir REST kitaplığıdır. REST API 'Leri canlı arabirimlere dönüştürür.Bir arabirimin uygulanması, dış 
HTTP çağrılarını yapmak için HttpClient kullanılarak Restsenvice tarafından dinamik olarak oluşturulur. 

Bir arabirim ve yanıt, dış API 'yi ve yanıtını temsil edecek şekilde tanımlanır: 

public interface IHelloClient 

{ 

[Get("/helloworld")] 

Task<Reply> GetMessageAsync(); 

} 

public class Reply 

{ 

public string Message { get; set; } 

} 


Türü belirlenmiş bir istemci eklenebilir, uygulamayı oluşturmak için yeniden sığdırma kullanımı kullanılabilir: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddHttpClient("hello", c => 

{ 

c.BaseAddress = new Uri("https://localhost:5001"); 

}) 

.AddTypedClient(c => Refit.RestService.For<IHelloClient>(c)); 

Services.AddMvc(); 

} 


Tanımlı arabirim, gereken yerde, mak ve Refit tarafından sağlanmış uygulama ile kullanılabilir. 










[ApiController] 

public class ValuesController : ControllerBase 
{ 

private readonly IHelloClient _client; 

public ValuesController(IHelloClient Client) 

{ 

_client = Client; 

} 

[HttpGet("/")] 

public async Task<ActionResult<Reply>> Index() 
{ 

return await _client.GetMessageAsync(); 

} 


Giden istek ara yazılımı 

Httpciient , giden HTTP istekleri için bir araya bağlanabilen işleyicileri temsilci seçme kavramıdır. 
iHttpdientFactony , her bir adlandırılmış istemci için uygulanacak işleyicileri tanımlamanızı kolaylaştırır. Bir 
giden istek ara yazılım işlem hattı oluşturmak için birden çok işleyicinin kaydını ve zincirlemeyi destekler. Bu 
işleyicilerin her biri, giden istekten önce ve sonra iş gerçekleştirebilir. Bu düzen, AS P.N ET Core gelen ara yazılım 
ardışık düzenine benzer. Bu model, önbelleğe alma, hata işleme, serileştirme ve günlüğe kaydetme dahil olmak 
üzere HTTP istekleri etrafında çapraz kesme sorunlarını yönetmek için bir mekanizma sağlar. 

Bir işleyici oluşturmak için DelegatingHandlertüretilen bir sınıf tanımlayın, isteği ardışık düzen içindeki bir 
sonraki işleyiciye geçirmeden önce kodu yürütmek için sendAsync yöntemini geçersiz kılın: 

public class ValidateHeaderHandler : DelegatingHandler 
{ 

protected override async Task<HttpResponseMessage> SendAsync( 

HttpRequestMessage request, 

CancellationToken cancellationToken) 

{ 

if (!request.Headers.Contains("X-API-KEY")) 

{ 

retunn new HttpResponseMessage(HttpStatusCode.BadRequest) 

{ 

Content = new StningContent( 

"You must supply an API key header called X-API-KEY") 

}; 

} 

netunn await base.SendAsync(nequest i cancellationToken); 

} 

} 

Yukarıdaki kod, temel bir işleyiciyi tanımlar.isteğe bağlı bir x-api-key üst bilgisi olup olmadığını denetler. Üst 
bilgi eksikse, HTTP çağrısından kaçınabilir ve uygun bir yanıt döndürebilir. 

Kayıt sırasında, bir Httpciient yapılandırmasına bir veya daha fazla işleyici eklenebilir. Bu görev 
IHttpClientBuilderuzantı yöntemleri aracılığıyla gerçekleştirilir. 






Services.AddTransient<ValidateHeaderHandler>(); 

Services.AddHttpClient("externalservice", c => 

{ 

// Assume this is an "external" service which requires an API KEY 
c.BaseAddress = new Uri("https://localhost:5000/"); 

}) 

.AddHttpMessageHandler<ValidateHeaderHandler>(); 

Yukarıdaki kodda validateHeaderHandler Dİ ile kaydedilir. iHttpClientFactory her işleyici için ayrı bir dı kapsamı 
oluşturur, işleyiciler herhangi bir kapsamın hizmetlerine bağlı olarak ücretsizdir.işleyicilerin bağımlı olduğu 
hizmetler, işleyicinin elden çıkarılmasıyla kaldırılır. 

Kaydedildikten sonra, işleyicinin türü olarak AddHttpMessageHandler çağrılabilir. 

Birden çok işleyici, yürütülmesi gereken sırayla kaydedilebilir. Her işleyici, son HttpciientHandier isteği 
çalıştırana kadar sonraki işleyiciyi sarmalar: 

Services.AddTransient<SecureRequestHandler>(); 

Services.AddTransient<RequestDataHandler>(); 

Services.AddHttpClient("clientwithhandlers") 

// This handler is on the outside and called first during the 
// request, last during the response. 

.AddHttpMessageHandler<SecureRequestHandler>() 

// This handler is on the inside, closest to the request being 
// sent. 

.AddHttpMessageHandler<RequestDataHandler>(); 

ileti işleyicileriyle istek başına durumu paylaşmak için aşağıdaki yaklaşımlardan birini kullanın: 

• HttpRequestMessage.Properties kullanarak işleyicide veri geçirin. 

• Geçerli isteğe erişmek için iHttpContextAccessor kullanın. 

• Verileri geçirmek için özel bir AsyncLocai depolama nesnesi oluşturun. 

Polly tabanlı işleyiciler kullanın 

İHttpClientFactory , Pollyadlı popüler bir üçüncü taraf kitaplıkla tümleştirilir. Polly, .NET için kapsamlı bir 
esnekliği ve geçici hata işleme kitaplığıdır. Geliştiricilerin yeniden deneme, devre kesici, zaman aşımı, Bulkbaş 
yalıtımı, akıcı ve iş parçacığı açısından güvenli bir şekilde geri dönüş gibi ilkeler almasına olanak tanır. 

Uzantı yöntemleri, yapılandırılmış Httpciient örnekleri ile Polly ilkelerin kullanımını etkinleştirmek için sağlanır. 
Polly uzantıları: 

• İstemcilere Polly tabanlı işleyiciler eklemeyi destekler. 

• , Microsoft. Extensions. http. Polly NuGet paketini yükledikten sonra kullanılabilir.Paket, ASP.NET Core 
paylaşılan çerçevesine dahil değildir. 

Geçici hataları işle 

Yaygın hatalar, dış HTTP çağrıları geçici olduğunda oluşur. AddTransientHttpErrorPoiicy adlı, bir ilkenin geçici 
hataları işleyecek şekilde tanımlanmasını sağlayan uygun bir genişletme yöntemi vardır. Bu uzantı yöntemiyle 
yapılandırılan ilkeler HttpRequestException , HTTP 5xx yanıtları ve HTTP 408 yanıtları. 

AddTransientHttpErrorPoiicy uzantısı startup.configureServices içinde kullanılabilir. Uzantı, olası bir geçici 
hatayı temsil eden hataları işlemek için yapılandırılmış bir PolicyBuiider nesnesine erişim sağlar: 













Services.AddHttpClient<UnreliableEndpointCallerService>() 

.AddTransientHttpErrorPolicy(p => 

p.WaitAndRetryAsync(3, _ => TimeSpan.FromMilliseconds(600))); 

Yukarıdaki kodda uaitAndRetryAsync bir ilke tanımlanmıştır. Başarısız istekler, denemeler arasındaki 600 MS 
gecikmeyle en fazla üç kez yeniden denenir. 

Dinamik olarak ilke seçme 

Polly tabanlı işleyiciler eklemek için kullanılabilecek ek uzantı yöntemleri vardır. Bu tür bir uzantı birden çok aşırı 
yüklemesi olan AddPolicyHandler . Bir aşırı yükleme, hangi ilkenin uygulanacağını tanımlarken isteğin 
incelenebilirliğini sağlar: 

var timeout = Policy.TimeoutAsync<HttpResponseMessage>( 

TimeSpan.FromSeconds(10)); 

var longTimeout = Policy.TimeoutAsync<HttpResponseMessage>( 

TimeSpan.FromSeconds(30)); 

Services.AddHttpClient("conditionalpolicy") 

// Run some code to select a policy based on the request 
.AddPolicyHandler(request => 

request.Method == HttpMethod.Get ? timeout : longTimeout); 


Yukarıdaki kodda, giden istek bir HTTP GET ise, 10 saniyelik birzaman aşımı uygulanır.Diğer HTTP yöntemleri 
için, 30 saniyelik bir zaman aşımı kullanılır. 

Birden çok Polly işleyici ekleme 

Gelişmiş işlevsellik sağlamak için çok fazla ilke iç içe geçmiş bir yaygın hale gelir: 

Services.AddHttpClient("multiplepolicies") 

.AddTransientHttpErrorPolicy(p => p.RetryAsync(3)) 

.AddTransientHttpErrorPolicy( 

p => p.CircuitBreakerAsync(5, TimeSpan.FromSeconds(30))); 

Yukarıdaki örnekte, iki işleyici eklenmiştir.ilki, yeniden deneme ilkesi eklemek için AddTransientHttpErrorPoücy 
uzantısını kullanır. Başarısız istekler en fazla üç kez yeniden denenir. AddTransientHttpErrorPoücy ikinci çağrısı, 
devre kesici ilkesi ekler. Beş başarısız girişim sırayla gerçekleşiyorsa, daha fazla dış istek 30 saniye için engellenir. 
Devre kesici ilkeleri durum bilgisi vardır. Bu istemci aracılığıyla yapılan tüm çağrılar aynı devre durumunu 
paylaşır. 

Polly kayıt defterinden ilke ekleme 

Düzenli olarak kullanılan ilkeleri yönetmeye yönelik bir yaklaşım, bunları bir kez tanımlamak ve bir 
PoücyRegistny kaydetmektir. Kayıt defterinden bir ilke kullanılarak bir işleyicinin eklenmesine izin veren bir 
genişletme yöntemi sağlanır: 

var registry = Services. AddPolicyRegistryO; 

registry.Add("regular", timeout); 
registry.Add("long ", longTimeout); 

Services.AddHttpClient("regulartimeouthandler") 

.AddPolicyHandlerFromRegistry("regular"); 

Yukarıdaki kodda, PoücyRegistry serviceCollection eklendiğinde iki ilke kaydedilir. Kayıt defterinden bir ilke 
kullanmak için AddPolicyHandierFromRegistry yöntemi kullanılır ve uygulanacak ilke adı geçer. 












İHttpdientFactory ve Polly tümleştirmeler hakkında daha fazla bilgi, Polly vvikiüzerinde bulunabilir. 

HttpClient ve ömür yönetimi 

İHttpdientFactory' ' createciient her çağrıldığında yeni bir HttpClient örneği döndürülür. Adlandırılmış 
istemci başına bir HttpMessageHandler vardır. Fabrika HttpMessageHandler örneklerinin yaşam sürelerini yönetir. 

kaynak tüketimini azaltmak için fabrika tarafından oluşturulan HttpMessageHandler örnekleri iHttpdientFactory 
havuzlar. HttpMessageHandler bir örnek, süresi dolmamışsa yeni bir HttpClient örneği oluşturulurken havuzdan 
yeniden kullanılabilir. 

Her işleyici genellikle kendi temel HTTP bağlantılarını yönettiğinden, işleyicilerin havuzlaması tercih edilir. 
Gerekenden daha fazla işleyici oluşturulması bağlantı gecikmeleri oluşmasına neden olabilir. Ayrıca, bazı 
işleyiciler bağlantıları süresiz olarak açık tutar, bu da işleyicinin DNS değişikliklerine yeniden davranmasını 
engelleyebilir. 

Varsayılan işleyici ömrü iki dakikadır.Varsayılan değer, adlandırılmış istemci temelinde geçersiz kılınabilir.Bunu 
geçersiz kılmak için, istemci oluştururken döndürülen iHttpcıientBuiider SetHandlerLifetime çağırın: 

Services .AddHttpClient("extendedhandlerlifetime") 

.SetHandlerLifetime(TimeSpan.FromMinutes(5)); 

istemcinin çıkarılması gerekli değildir. Aktiften çıkarma giden istekleri iptal eder ve Disposeçağrıldıktan sonra 
verilen HttpClient örneğinin kullanılamaz olmasını sağlar. iHttpdientFactory, HttpClient örnekleri tarafından 
kullanılan kaynakları izler ve ortadan kaldırır. HttpClient örnekleri genellikle aktiften çıkarma gerektirmeyen 
.NET nesneleri olarak kabul edilebilir. 

Tekbir HttpClient örneğinin uzun süre canlı tutulması, iHttpdientFactory önünde kullanılmadan önce 
kullanılan ortak bir modeldir. Bu kalıp İHttpdientFactory geçtikten sonra gereksiz hale gelir. 

I httpclientfactory alternatifleri 

Dı özellikli bir uygulamada iHttpdientFactory kullanmak şunları önler: 

• HttpMessageHandler örnekleri havuza alarak kaynak tükenmesi sorunları. 

• Düzenli aralıklarla HttpMessageHandler örnekleri arasında geçiş yaparak eski DNS sorunları. 

Uzun süreli SocketsHttpHandler örneği kullanarak önceki sorunları çözmenin alternatif yolları vardır. 

• Uygulama başlatıldığında SocketsHttpHandler örneğini oluşturun ve uygulamanın ömrü boyunca kullanın. 

• PooledConnectionLifetime DNS yenileme zamanına göre uygun bir değere yapılandırın. 

• Gerektiğinde new Httpciient(handier, dispostHandler: faise) kullanarak HttpClient örnekleri oluşturun. 

Yukarıdaki yaklaşımlar iHttpdientFactory benzer bir şekilde çözdüğü kaynak yönetimi sorunlarını çözer. 

• SocketsHttpHandler , HttpClient örnekleri arasında bağlantıları paylaşır. Bu paylaşım, yuva azalmasına engel 
olur. 

• SocketsHttpHandler , eski DNS sorunlarından kaçınmak için bağlantıları PooledConnectionLifetime göre 
döngüler. 

Özgü 

Havuza alınmış HttpMessageHandler örnekleri, cookieContainer nesneleri paylaşılmasına neden olur. 
Beklenmeyen CookieContainer nesne paylaşımı genellikle hatalı kodla sonuçlanır. Tanımlama bilgileri gerektiren 
uygulamalar için şunlardan birini göz önünde bulundurun: 

• Otomatik tanımlama bilgisi işlemeyi devre dışı bırakma 

































IHttpClientFactory Önleme 


Otomatik tanımlama bilgisi işlemeyi devre dışı bırakmak için ConfigurePrimaryHttpMessageHandler çağırın: 


Services.AddHttpClient("configured-disable-automatic-cookies") 
.ConfigurePrimaryHttpMessageHandler(() => 

{ 

return new SocketsHttpHandler() 

{ 

UseCookies = false, 

}; 


Günlüğe Kaydetme 

Tüm istekler için IHttpClientFactory kayıt günlüğü iletileri aracılığıyla oluşturulan istemciler. Varsayılan günlük 
iletilerini görmek için günlük yapılandırmanızda uygun bilgi düzeyini etkinleştirin. istek üst bilgilerinin günlüğe 
kaydedilmesi gibi ek Günlükler yalnızca izleme düzeyinde yer alır. 

Her istemci için kullanılan günlük kategorisi, istemcinin adını içerir.Örneğin, Mynamedclientad\\ bir istemci, 
iletileri bir System.Net.Http.Httpciient.MyNamedciient.LogicaiHandier kategorisi ile günlüğe kaydeder. 
Logicalhandler ile düzeltilen iletiler istek işleyicisi ardışık düzeni dışında oluşur, istekte, işlem hattındaki diğer 
işleyiciler işlenmeden önce iletiler günlüğe kaydedilir. Yanıtta, tüm diğer işlem hattı işleyicileri yanıtı aldıktan 
sonra iletiler günlüğe kaydedilir. 

Günlüğe kaydetme, istek işleyicisi ardışık düzeni içinde de gerçekleşir .Mynamedclierıt örneğinde, bu iletiler 
System.Net .Http. HttpClient.MyNamedciient.ciientHandier günlük kategorisine göre günlüğe kaydedilir, istek için 
bu, tüm diğer işleyiciler çalıştıktan sonra ve istek ağda gönderilmeden hemen önce gerçekleşir. Yanıtta, bu 
günlüğe kaydetme, işleyicinin işleyici işlem hattı üzerinden geri geçirmeden önce yanıtın durumunu içerir. 

işlem hattının dışında ve içinde günlüğe kaydetmenin etkinleştirilmesi, diğer işlem hattı işleyicileri tarafından 
yapılan değişikliklerin incelemesini etkinleştirir. Bu, örneğin veya yanıt durum kodunda istek başlıklarındaki 
değişiklikleri içerebilir. 

istemci adı' nı log kategorisinde da içermek, gerektiğinde belirli adlandırılmış istemciler için günlük filtrelemeyi 
sunar. 

HttpMessageHandler 'ı yapılandırma 

istemci tarafından kullanılan iç HttpMessageHandler yapılandırmasını denetlemek gerekli olabilir. 

Adlandırılmış veya yazılan istemciler eklenirken bir iHttpciientBuiider döndürülür. 

ConfigurePrimaryHttpMessageHandler uzantısı yöntemi bir temsilciyi tanımlamak için kullanılabilir. Temsilci, bu 
istemci tarafından kullanılan birincil HttpMessageHandler oluşturmak ve yapılandırmak için kullanılır: 

Services.AddHttpClient("configured-inner-handler") 

. Conf igurePrimaryHttpMessageHandler( () => 

{ 

return new HttpClientHandler() 

{ 

AllowAutoRedirect = false, 

UseDefaultCredentials = true 

}; 

}); 


Konsol uygulamasında ıhttpclientfactory kullanma 










Konsol uygulamasında, aşağıdaki paket başvurularını projeye ekleyin: 

• Microsoft. Extensions. Hosting 

• Microsoft. Extensions. http 

Aşağıdaki örnekte: 

• IHttpCiientFactory, genel konağın hizmet kapsayıcısına kaydedilir. 

• MyService , hizmetten bir Httpciient oluşturmak için kullanılan bir istemci fabrikası örneği oluşturur. 
Httpciient , bir Web sayfasını almak için kullanılır. 

• Main , hizmetin GetPage yöntemini yürütmek için bir kapsam oluşturur ve Web sayfası içeriğinin ilk 500 
karakterini konsola yazar. 


using System; 

using System.Net.Http; 

using System.Threading.Tasks; 

using Microsoft. Extensions .Dependencylnjection; 

using Microsoft. Extensions .Hosting; 

using Microsoft. Extensions. Logging; 

class Program 

{ 

static async Task<int> Main(string[] args) 

{ 

var builder = new HostBuilder() 

.ConfigureServices((hostContextj Services) => 

{ 

Services.AddHttpClient(); 

Services.AddTransientcIMyService, MyService>(); 

}).UseConsoleLifetime(); 

var hoşt = builder.Build(); 

using (var serviceScope = hoşt.Services.CreateScope()) 

{ 

var Services = serviceScope.ServiceProvider; 

try 

{ 

var myService = Services.GetRequiredService<IMyService>(); 
var pageContent = await myService.GetPage(); 

Console.WriteLine(pageContent.Substring(0j 500)); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<II_ogger<Program>>(); 
logger.LogError(ex, "An error occurred."); 

} 

} 

return 0; 

} 

public interface IMyService 

{ 

Task<string> GetPage(); 

} 

public class MyService : IMyService 

{ 

private readonly IHttpCiientFactory _clientFactory; 


public MyService(IHttpClientFactory clientFactory) 

{ 




} 


clientFactory = clientFactory; 


public async Task<string> GetPage() 

{ 

// Content from BBC One: Dr. Who website (©BBC) 
var request = new HttpRequestMessage(HttpMethod.Get, 

"https://www.bbc.co.uk/programmes/b006q2x0"); 
var Client = _clientFactory.CreateClient(); 
var response = await Client.SendAsync(request); 

if (response.IsSuccessStatusCode) 

{ 

return await response.Content.ReadAsStringAsync(); 

} 

else 

{ 

return $"StatusCode: {response.StatusCode}"; 

} 

} 

} 

} 

Ek kaynaklar 

• Dayanıklı HTTP isteklerini uygulamak için HttpClientFactory kullanma 

• HttpClientFactory ve Polly ilkeleriyle üstel geri alma ile HTTP çağrı yeniden denemeleri uygulayın 

• Devre Kesici desenini uygulama 

, Glenn CONDRON, Ryan şimdi eve Steve Gordon 

Bir IHttpClientFactory, bir uygulamadaki HttpClient örnekleri yapılandırmak ve oluşturmak için kaydedilebilir ve 
kullanılabilir. Aşağıdaki avantajları sunar: 

• .Mantıksal HttpClient örneklerinin adlandırılması ve yapılandırılması için merkezi bir konum sağlar. 
Örneğin, GitHub istemcisi kayıtU ve GitHub'a erişebilecek şekilde yapılandırılabilir. Varsayılan istemci, diğer 
amaçlar için kaydedilebilir. 

• HttpClient ' de işleyiciler temsilci seçme yoluyla giden ara yazılım kavramını daha da artırır ve bundan 
faydalanmak için, Polya tabanlı ara yazılım için uzantılar sağlar. 

• HttpClient yaşam sürelerini el ile yönetirken gerçekleşen yaygın DNS sorunlarından kaçınmak için temel 
HttpClientMessageHandler örneklerinin biriktirmesini ve ömrünü yönetir. 

• Fabrika tarafından oluşturulan istemcilerle gönderilen tüm istekler için yapılandırılabilir bir günlük deneyimi ( 

iLogger aracılığıyla) ekler. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Prerequisites 

.NET Framevvork hedefleyen projeler Microsoft. Extensions. http NuGet paketinin yüklenmesini gerektirir..NET 
Core ile hedeflenen ve Microsoft. AspNetCore. app metapackage 'e başvuran projeler zaten 
Microsoft.Extensions.Http paketini içerir. 

Tüketim desenleri 

Bir uygulamada IHttpClientFactory çeşitli yollar vardır: 

• Temel kullanım 

• Adlandırılmış istemciler 








• Yazılan istemciler 

• Oluşturulan istemciler 


Hiçbiri diğerinden tamamen üst değildir. En iyi yaklaşım, uygulamanın kısıtlamalarına bağlıdır. 

Temel kullanım 


İHttpClientFactory , 

Startup.configureServices 

yönteminin içindeki 

IServiceCollection''AddHttpClient 


genişletme yöntemi çağırarak kaydedilebilir. 

Services .AddHttpClient(); 

Kaydedildikten sonra kod, bağımlılık ekleme (dı)ile her yerden iHttpClientFactory kabul edebilir. 
iHttpdientFactory , bir HttpClient örneği oluşturmak için kullanılabilir: 

public class BasicUsageModel : PageModel 

{ 

private readonly İHttpClientFactory _clientFactory; 

public IEnumerable<GitHubBranch> Branches { get; private set; } 

public bool GetBranchesError { get; private set; } 

public BasicUsageModel(IHttpClientFactory clientFactory) 

{ 

_clientFactory = clientFactory; 

} 

public async Task OnGet() 

{ 

var request = new HttpRequestMessage(HttpMethod.Get, 

"https://api.github.com/repos/aspnet/AspNetCore.Docs/branches"); 
request.Headers.Add("Accept", "application/vnd.github.v3+json"); 
request.Headers.Add("User-Agent", "HttpClientFactory-Sample"); 

var Client = _clientFactory.CreateClient(); 

var response = await Client.SendAsync(request); 

if (response.IsSuccessStatusCode) 

{ 

Branches = await response.Content 

.ReadAsAsync<IEnumerable<GitHubBranch>>(); 

} 

else 

{ 

GetBranchesError = true; 

Branches = Array.Empty<GitHubBranch>(); 

} 

} 

} 

Bu biçimde İHttpClientFactory kullanmak, mevcut bir uygulamayı yeniden düzenleme için iyi bir yoldur. 
HttpClient kullanılma şekli üzerinde hiçbir etkisi yoktur. HttpClient örneklerinin Şu anda oluşturulduğu 
yerlerde, bu oluşumların CreateClientçağrısı ile değiştirin. 

Adlandırılmış istemciler 

Bir uygulama, her biri farklı bir yapılandırmaya sahip HttpClient birçok farklı kullanım gerektiriyorsa, 
adlandırılmış istemcilerkullanılır. Adlandırılmış bir HttpClient yapılandırması, startup.configureServices 
kayıt sırasında belirtilebilir. 












Services. AddHttpClient("github", c => 

{ 

c.BaseAddress = new Uri("https://api. github.com/"); 

// Github API versioning 

c.DefaultRequestHeaders.Add("Accept", "application/vnd.github.v3+json"); 

// Github requires a user-agent 

c.DefaultRequestHeaders.Add("User-Agent", "HttpClientFactory-Sample"); 

}); 

Yukarıdaki kodda AddHttpciient , GitHubad\ı adı sağlar. Bu istemci, GitHub API 'SI ile çalışmak için gerekli olan 
temel adres ve iki üst bilgiyle—uygulanmış olan bazı varsayılan yapılandırmaları içerir. 

createciient her çağrıldığında, yeni bir Httpciient örneği oluşturulur ve yapılandırma eylemi çağrılır. 

Adlandırılmış bir istemciyi kullanmak için, createciient bir dize parametresi geçirilebilir. Oluşturulacak 
istemcinin adını belirtin: 

public class NamedClientModel : PageModel 

{ 

private readonly IHttpClientFactory _clientFactory; 

public IEnumerable<GitHubPullRequest> PullRequests { get; private set; } 

public bool GetPullRequestsError { get; private set; } 

public bool HasPullRequests => PullRequests.Any(); 

public NamedClientModel(IHttpClientFactory clientFactory) 

{ 

_clientFactory = clientFactory; 

} 

public async Task OnGet() 

{ 

var request = new HttpRequestMessage(HttpMethod.Get, 

"repos/aspnet/AspNetCore.Docs/pulls"); 

var Client = _clientFactory.CreateClient("github"); 

var response = await Client.SendAsync(request); 

if (response.IsSuccessStatusCode) 

{ 

PullRequests = await response.Content 

.ReadAsAsync<IEnumerable<GitHubPullRequest>>(); 

} 

else 

{ 

GetPullRequestsError = true; 

PullRequests = Array.Empty<GitHubPullRequest>(); 

} 

} 

} 

Yukarıdaki kodda, isteğin bir ana bilgisayar adı belirtmesi gerekmez, istemci için yapılandırılan taban adresi 
kullanıldığından, bu yalnızca yolu geçirebilir. 

Yazılan istemciler 

Yazılan istemciler: 


• Dizeleri anahtar olarak kullanma gereksinimi olmadan, adlandırılmış istemcilerle aynı özellikleri sağlayın. 

• istemcileri tükettiren IntelliSense ve derleyici yardımı sağlar. 







• Yapılandırmak ve belirli bir Httpciient etkileşimde bulunmak için tek bir konum sağlayın. Örneğin, tek bir 
arka uç uç noktası için tek bir adet yazılmış istemci kullanılabilir ve bu uç nokta ile ilgili tüm mantığı 
kapsüllenebilir. 

• Dİ ile birlikte çalışın ve uygulamanızda gerektiğinde eklenebilir. 

Türü belirtilmiş istemci, oluşturucusunda bir Httpciient parametresi kabul eder: 

public class GitHubService 

{ 

public Httpciient Client { get; } 

public GitHubService(HttpClient Client) 

{ 

Client.BaseAddress = new Uri("https://api. github.com/"); 

// GitHub API versioning 

Client.DefaultRequestHeaders.Add("Accept", 

"application/vnd.github.v3+json"); 

// GitHub requires a user-agent 

Client.DefaultRequestHeaders.Add("User-Agent ", 

"HttpClientFactory-Sample"); 

Client = Client; 

} 

public async Task<IEnumerable<GitHubIssue>> GetAspNetDocsIssues() 

{ 

var response = await Client.GetAsync( 

"/repos/aspnet/AspNetCore.Docs/issues?state=open&sort=created&direction=desc"); 

response.EnsureSuccessStatusCode(); 

var result = await response.Content 

.ReadAsAsync<IEnumerable<GitHubIssue>>(); 

return result; 

} 

} 

Önceki kodda, yapılandırma yazılan istemciye taşınır. Httpciient nesnesi ortak bir özellik olarak sunulur. 
Httpciient işlevselliği ortaya çıkaran API 'ye özel yöntemler tanımlamak mümkündür. GetAspNetDocsissues 
yöntemi, GitHub deposundan en son açık sorunları sorgulamak ve ayrıştırmak için gereken kodu kapsüller. 

Türü belirtilmiş bir istemciyi kaydetmek için genel AddHttpClient uzantısı yöntemi, türü belirlenmiş istemci 
sınıfını belirterek startup.configureServices içinde kullanılabilir: 

Services.AddHttpClient<GitHubService>(); 


Yazılan istemci, Dİ ile geçici olarak kaydedilir. Yazılan istemci doğrudan eklenebilir ve tüketilebilir: 








public class TypedClientModel : PageModel 

{ 

private readonly GitHubService _gitHubService; 

public IEnumerable<GitHubIssue> Latestlssues { get; private set; } 

public bool Haslssue => Latestlssues.Any(); 

public bool GetlssuesError { get; private set; } 

public TypedClientModel(GitHubService gitHubService) 

{ 

_gitHubService = gitHubService; 

} 

public async Task OnGet() 

{ 

try 

{ 

Latestlssues = await _gitHubService.GetAspNetDocsIssues(); 

} 

catch(HttpRequestException) 

{ 

GetlssuesError = true; 

Latestlssues = Array.Empty<GitHubIssue>(); 

} 

} 

} 


Tercih edilirse, yazılan istemcinin yapılandırması, türü belirlenmiş istemcinin Oluşturucusu yerine 
startup.configureServices kayıt sırasında belirtilebilir: 

Services.AddHttpClient<RepoService>(c => 

{ 

c.BaseAddress = new Uri("https://api. github.com/"); 

c.DefaultRequestHeaders.Add("Accept", "application/vnd.github.v3+json"); 
c.DefaultRequestHeaders.Add("User-Agent", "HttpClientFactory-Sample"); 

}); 

Türü belirlenmiş bir istemci içinde tamamen kapsül Httpciient lemek mümkündür. Bunu bir özellik olarak 
göstermek yerine, Httpciient örneğini dahili olarak çağıran ortak Yöntemler sunulabilir. 





public class RepoService 

{ 

// _httpClient isn't exposed publicly 
private readonly HttpClient _httpClient; 

public RepoService(HttpClient Client) 

{ 

_httpClient = Client; 

} 

public async Task<IEnumerable<string>> GetRepos() 

{ 

var response = await _httpClient.GetAsync("aspnet/repos"); 

response.EnsureSuccessStatusCode(); 

var result = await response.Content 

.ReadAsAsync<IEnumerable<string>>(); 

return result; 

} 

} 

Yukarıdaki kodda HttpClient bir özel alan olarak depolanır. Dış çağrıları yapmak için tüm erişim GetRepos 
yönteminden geçer. 

Oluşturulan istemciler 

iHttpciientFactory , yeniden sığdırmagibi diğer üçüncü taraf kitaplıklarla birlikte kullanılabilir. Yeniden sığdırma, 
.NET için bir REST kitaplığıdır. REST API 'Leri canlı arabirimlere dönüştürür.Bir arabirimin uygulanması, dış 
HTTP çağrılarını yapmak için HttpClient kullanılarak Restsenvice tarafından dinamik olarak oluşturulur. 

Bir arabirim ve yanıt, dış API 'yi ve yanıtını temsil edecek şekilde tanımlanır: 

public interface IHelloClient 

{ 

[Get("/helloworld")] 

Task<Reply> GetMessageAsync(); 

} 

public class Reply 

{ 

public string Message { get; set; } 

} 


Türü belirlenmiş bir istemci eklenebilir, uygulamayı oluşturmak için yeniden sığdırma kullanımı kullanılabilir: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddHttpClient("hello", c => 

{ 

c.BaseAddress = new Uri("http://localhost:5000"); 

}) 

.AddTypedClient(c => Refit.RestService.For<IHelloClient>(c)); 

Services.AddMvc(); 

} 


Tanımlı arabirim, gereken yerde, mak ve Refit tarafından sağlanmış uygulama ile kullanılabilir. 










[ApiController] 

public class ValuesController : ControllerBase 
{ 

private readonly IHelloClient _client; 

public ValuesController(IHelloClient Client) 

{ 

_client = Client; 

} 

[HttpGet("/")] 

public async Task<ActionResult<Reply>> Index() 
{ 

return await _client.GetMessageAsync(); 

} 


Giden istek ara yazılımı 

Httpciient , giden HTTP istekleri için bir araya bağlanabilen işleyicileri temsilci seçme kavramıdır. 
iHttpdientFactony , her bir adlandırılmış istemci için uygulanacak işleyicileri tanımlamanızı kolaylaştırır. Bir 
giden istek ara yazılım işlem hattı oluşturmak için birden çok işleyicinin kaydını ve zincirlemeyi destekler. Bu 
işleyicilerin her biri, giden istekten önce ve sonra iş gerçekleştirebilir. Bu düzen, AS P.N ET Core gelen ara yazılım 
ardışık düzenine benzer. Bu model, önbelleğe alma, hata işleme, serileştirme ve günlüğe kaydetme dahil olmak 
üzere HTTP istekleri etrafında çapraz kesme sorunlarını yönetmek için bir mekanizma sağlar. 

Bir işleyici oluşturmak için DelegatingHandlertüretilen bir sınıf tanımlayın, isteği ardışık düzen içindeki bir 
sonraki işleyiciye geçirmeden önce kodu yürütmek için sendAsync yöntemini geçersiz kılın: 

public class ValidateHeaderHandler : DelegatingHandler 
{ 

protected override async Task<HttpResponseMessage> SendAsync( 

HttpRequestMessage request, 

CancellationToken cancellationToken) 

{ 

if (!request.Headers.Contains("X-API-KEY")) 

{ 

retunn new HttpResponseMessage(HttpStatusCode.BadRequest) 

{ 

Content = new StningContent( 

"You must supply an API key header called X-API-KEY") 

}; 

} 

netunn await base.SendAsync(nequest i cancellationToken); 

} 

} 

Yukarıdaki kod, temel bir işleyiciyi tanımlar.isteğe bağlı bir x-api-key üst bilgisi olup olmadığını denetler. Üst 
bilgi eksikse, HTTP çağrısından kaçınabilir ve uygun bir yanıt döndürebilir. 

Kayıt sırasında, bir Httpciient yapılandırmasına bir veya daha fazla işleyici eklenebilir. Bu görev 
IHttpClientBuilderuzantı yöntemleri aracılığıyla gerçekleştirilir. 






Services.AddTransient<ValidateHeaderHandler>(); 

Services.AddHttpClient("externalservice", c => 

{ 

// Assume this is an "external" service which requires an API KEY 
c.BaseAddress = new Uri("https://localhost:5000/"); 

}) 

.AddHttpMessageHandler<ValidateHeaderHandler>(); 

Yukarıdaki kodda validateHeaderHandler Dİ ile kaydedilir. İşleyicinin, bir geçici hizmet olarak dı 'ye kayıtlı olması 
gerekir , hiçbir koşulda kapsamı yoktur, işleyici kapsamlı bir hizmet olarak kayıtlıysa ve işleyicinin bağımlı 
olduğu tüm hizmetler atılabilir olur: 

• işleyici kapsam dışına geçmeden önce işleyicinin Hizmetleri atılamaz. 

• Atılmış işleyici Hizmetleri işleyicinin başarısız olmasına neden olur. 

Kaydedildikten sonra, AddHttpMessageHandler, işleyici türünü geçirerek çağrılabilir. 

Birden çok işleyici, yürütülmesi gereken sırayla kaydedilebilir. Her işleyici, son HttpciientHandier isteği 
çalıştırana kadar sonraki işleyiciyi sarmalar: 

Services.AddTransient<SecureRequestHandler>(); 

Services.AddTransient<RequestDataHandler>(); 

Services.AddHttpClient("clientwithhandlers") 

// This handler is on the outside and called first during the 
// request, last during the response. 

.AddHttpMessageHandler<SecureRequestHandler>() 

// This handler is on the inside, closest to the request being 
// sent. 

.AddHttpMessageHandler<RequestDataHandler>(); 

ileti işleyicileriyle istek başına durumu paylaşmak için aşağıdaki yaklaşımlardan birini kullanın: 

• HttpRequestMessage.Properties kullanarak işleyicide veri geçirin. 

• Geçerli isteğe erişmek için iHttpContextAccessor kullanın. 

• Verileri geçirmek için özel bir AsyncLocai depolama nesnesi oluşturun. 

Polly tabanlı işleyiciler kullanın 

iHttpdientFactory , Pollyadlı popüler bir üçüncü taraf kitaplıkla tümleştirilir. Polly, .NET için kapsamlı bir 
esnekliği ve geçici hata işleme kitaplığıdır. Geliştiricilerin yeniden deneme, devre kesici, zaman aşımı, Bulkbaş 
yalıtımı, akıcı ve iş parçacığı açısından güvenli bir şekilde geri dönüş gibi ilkeler almasına olanak tanır. 

Uzantı yöntemleri, yapılandırılmış Httpciient örnekleri ile Polly ilkelerin kullanımını etkinleştirmek için sağlanır. 
Polly uzantıları: 

• istemcilere Polly tabanlı işleyiciler eklemeyi destekler. 

• , Microsoft. Extensions. http. Polly NuGet paketini yükledikten sonra kullanılabilir.Paket, ASP.NET Core 
paylaşılan çerçevesine dahil değildir. 

Geçici hataları işle 

Yaygın hatalar, dış HTTP çağrıları geçici olduğunda oluşur. AddTransientHttpErrorPolicy adlı, bir ilkenin geçici 
hataları işleyecek şekilde tanımlanmasını sağlayan uygun bir genişletme yöntemi vardır. Bu uzantı yöntemiyle 
yapılandırılan ilkeler HttpRequestException , HTTP 5xx yanıtları ve HTTP 408 yanıtları. 

AddTransientHttpErrorPolicy uzantısı startup.configureServices içinde kullanılabilir. Uzantı, olası bir geçici 













hatayı temsil eden hataları işlemek için yapılandırılmış bir PolicyBuiider nesnesine erişim sağlar: 


Services.AddHttpClient<UnreliableEndpointCallerService>() 

.AddTransientHttpErrorPolicy(p => 

p.WaitAndRetryAsync(3, _ => TimeSpan.FromMilliseconds(600))); 

Yukarıdaki kodda uaitAndRetryAsync bir ilke tanımlanmıştır. Başarısız istekler, denemeler arasındaki 600 MS 
gecikmeyle en fazla üç kez yeniden denenir. 

Dinamik olarak ilke seçme 

Polly tabanlı işleyiciler eklemek için kullanılabilecek ek uzantı yöntemleri vardır. Bu tür bir uzantı birden çok aşırı 
yüklemesi olan AddPolicyHandler . Bir aşırı yükleme, hangi ilkenin uygulanacağını tanımlarken isteğin 
incelenebiIirliğini sağlar: 

var timeout = Policy.TimeoutAsync<HttpResponseMessage>( 

TimeSpan.FromSeconds(10)); 

var longTimeout = Policy.TimeoutAsync<HttpResponseMessage>( 

TimeSpan.FromSeconds(30)); 

Services.AddHttpClient("conditionalpolicy") 

// Run some code to select a policy based on the request 
.AddPolicyHandler(request => 

request.Method == HttpMethod.Get ? timeout : longTimeout); 


Yukarıdaki kodda, giden istek bir HTTP GET ise, 10 saniyelik birzaman aşımı uygulanır.Diğer HTTP yöntemleri 
için, 30 saniyelik bir zaman aşımı kullanılır. 

Birden çok Polly işleyici ekleme 

Gelişmiş işlevsellik sağlamak için çok fazla ilke iç içe geçmiş bir yaygın hale gelir: 

Services.AddHttpClient("multiplepolicies") 

.AddTransientHttpErrorPolicy(p => p.RetryAsync(3)) 

.AddTransientHttpErrorPolicy( 

p => p.CircuitBreakerAsync(5, TimeSpan.FromSeconds(30))); 

Yukarıdaki örnekte, iki işleyici eklenmiştir.ilki, yeniden deneme ilkesi eklemek için AddTransientHttpErrorPoücy 
uzantısını kullanır. Başarısız istekler en fazla üç kez yeniden denenir. AddTransientHttpErrorPoücy ikinci çağrısı, 
devre kesici ilkesi ekler. Beş başarısız girişim sırayla gerçekleşiyorsa, daha fazla dış istek 30 saniye için engellenir. 
Devre kesici ilkeleri durum bilgisi vardır. Bu istemci aracılığıyla yapılan tüm çağrılar aynı devre durumunu 
paylaşır. 

Polly kayıt defterinden ilke ekleme 

Düzenli olarak kullanılan ilkeleri yönetmeye yönelik bir yaklaşım, bunları bir kez tanımlamak ve bir 
PoücyRegistny kaydetmektir. Kayıt defterinden bir ilke kullanılarak bir işleyicinin eklenmesine izin veren bir 
genişletme yöntemi sağlanır: 

var registry = Services. AddPolicyRegistryO; 

registry.Add("regular ", timeout); 
registry.Add("long ", longTimeout); 

Services.AddHttpClient("regulartimeouthandler") 

.AddPolicyHandlerFromRegistryC'regular"); 

Yukarıdaki kodda, PoücyRegistry serviceCollection eklendiğinde iki ilke kaydedilir. Kayıt defterinden bir ilke 











kullanmak için AddPolicyHandierFromRegistry yöntemi kullanılır ve uygulanacak ilke adı geçer. 

İHttpdientFactory ve Polly tümleştirmeler hakkında daha fazla bilgi, Polly vvikiüzerinde bulunabilir. 

HttpClient ve ömür yönetimi 

İHttpdientFactory"createciient her çağrıldığında yeni bir HttpClient örneği döndürülür. Adlandırılmış 
istemci başına bir HttpMessageHandler vardır. Fabrika HttpMessageHandler örneklerinin yaşam sürelerini yönetir. 

kaynak tüketimini azaltmak için fabrika tarafından oluşturulan HttpMessageHandler örnekleri İHttpdientFactory 
havuzlar. HttpMessageHandler bir örnek, süresi dolmamışsa yeni bir HttpClient örneği oluşturulurken havuzdan 
yeniden kullanılabilir. 

Her işleyici genellikle kendi temel HTTP bağlantılarını yönettiğinden, işleyicilerin havuzlaması tercih edilir. 
Gerekenden daha fazla işleyici oluşturulması bağlantı gecikmeleri oluşmasına neden olabilir. Ayrıca, bazı 
işleyiciler bağlantıları süresiz olarak açık tutar, bu da işleyicinin DNS değişikliklerine yeniden davranmasını 
engelleyebilir. 

Varsayılan işleyici ömrü iki dakikadır.Varsayılan değer, adlandırılmış istemci temelinde geçersiz kılınabilir.Bunu 
geçersiz kılmak için, istemci oluştururken döndürülen iHttpcıientBuiider SetHandlerLifetime çağırın: 

Services.AddHttpClient("extendedhandlerlifetime") 

.SetHandlerLifetime(TimeSpan.FromMinutes(5)); 

istemcinin çıkarılması gerekli değildir. Aktiften çıkarma giden istekleri iptal eder ve Disposeçağrıldıktan sonra 
verilen HttpClient örneğinin kullanılamaz olmasını sağlar. iHttpdientFactory, HttpClient örnekleri tarafından 
kullanılan kaynakları izler ve ortadan kaldırır. HttpClient örnekleri genellikle aktiften çıkarma gerektirmeyen 
.NET nesneleri olarak kabul edilebilir. 

Tekbir HttpClient örneğinin uzun süre canlı tutulması, iHttpdientFactory önünde kullanılmadan önce 
kullanılan ortak bir modeldir. Bu kalıp iHttpdientFactory geçtikten sonra gereksiz hale gelir. 

I httpclientfactory alternatifleri 

Dı özellikli bir uygulamada iHttpdientFactory kullanmak şunları önler: 

• HttpMessageHandler örnekleri havuza alarak kaynak tükenmesi sorunları. 

• Düzenli aralıklarla HttpMessageHandler örnekleri arasında geçiş yaparak eski DNS sorunları. 

Uzun süreli SocketsHttpHandler örneği kullanarak önceki sorunları çözmenin alternatif yolları vardır. 

• Uygulama başlatıldığında SocketsHttpHandler örneğini oluşturun ve uygulamanın ömrü boyunca kullanın. 

• PooledConnectionLifetime DNS yenileme zamanına göre uygun bir değere yapılandırın. 

• Gerektiğinde new Httpciient(handier, dispostHandler: faise) kullanarak HttpClient örnekleri oluşturun. 

Yukarıdaki yaklaşımlar iHttpdientFactory benzer bir şekilde çözdüğü kaynak yönetimi sorunlarını çözer. 

• SocketsHttpHandler , HttpClient örnekleri arasında bağlantıları paylaşır. Bu paylaşım, yuva azalmasına engel 
olur. 

• SocketsHttpHandler , eski DNS sorunlarından kaçınmak için bağlantıları PooledConnectionLifetime göre 
döngüler. 

Özgü 

Havuza alınmış HttpMessageHandler örnekleri, cookieContainer nesneleri paylaşılmasına neden olur. 
Beklenmeyen CookieContainer nesne paylaşımı genellikle hatalı kodla sonuçlanır. Tanımlama bilgileri gerektiren 
uygulamalar için şunlardan birini göz önünde bulundurun: 


































• Otomatik tanımlama bilgisi işlemeyi devre dışı bırakma 

• IHttpClientFactory Önleme 

Otomatik tanımlama bilgisi işlemeyi devre dışı bırakmak için ConfigurePrimaryHttpMessageHandler çağırın: 

Services.AddHttpClient("configured-disable-automatic-cookies") 

.ConfigurePrimaryHttpMessageHandler(() => 

{ 

retıırn new SocketsHttpHandler() 

{ 

UseCookies = false, 

}; 


Günlüğe Kaydetme 

Tüm istekler için IHttpClientFactory kayıt günlüğü iletileri aracılığıyla oluşturulan istemciler. Varsayılan günlük 
iletilerini görmek için günlük yapılandırmanızda uygun bilgi düzeyini etkinleştirin. İstek üst bilgilerinin günlüğe 
kaydedilmesi gibi ek Günlükler yalnızca izleme düzeyinde yer alır. 

Her istemci için kullanılan günlük kategorisi, istemcinin adını içerir.Örneğin, Mynamedclientad\\ bir istemci, 
iletileri bir System.Net.Http.Httpciient.MyNamedciient.LogicaiHandier kategorisi ile günlüğe kaydeder. 
Logicalhandler ile düzeltilen iletiler istek işleyicisi ardışık düzeni dışında oluşur, istekte, işlem hattındaki diğer 
işleyiciler işlenmeden önce iletiler günlüğe kaydedilir. Yanıtta, tüm diğer işlem hattı işleyicileri yanıtı aldıktan 
sonra iletiler günlüğe kaydedilir. 

Günlüğe kaydetme, istek işleyicisi ardışık düzeni içinde de gerçekleşir .Mynamedclierıt örneğinde, bu iletiler 
System.Net .Http. HttpClient.MyNamedciient.ciientHandier günlük kategorisine göre günlüğe kaydedilir, istek için 
bu, tüm diğer işleyiciler çalıştıktan sonra ve istek ağda gönderilmeden hemen önce gerçekleşir. Yanıtta, bu 
günlüğe kaydetme, işleyicinin işleyici işlem hattı üzerinden geri geçirmeden önce yanıtın durumunu içerir. 

işlem hattının dışında ve içinde günlüğe kaydetmenin etkinleştirilmesi, diğer işlem hattı işleyicileri tarafından 
yapılan değişikliklerin incelemesini etkinleştirir. Bu, örneğin veya yanıt durum kodunda istek başlıklarındaki 
değişiklikleri içerebilir. 

istemci adı' nı log kategorisinde da içermek, gerektiğinde belirli adlandırılmış istemciler için günlük filtrelemeyi 
sunar. 

HttpMessageHandler 'ı yapılandırma 

istemci tarafından kullanılan iç HttpMessageHandler yapılandırmasını denetlemek gerekli olabilir. 

Adlandırılmış veya yazılan istemciler eklenirken bir iHttpciientBuiider döndürülür. 

ConfigurePrimaryHttpMessageHandler uzantısı yöntemi bir temsilciyi tanımlamak için kullanılabilir. Temsilci, bu 
istemci tarafından kullanılan birincil HttpMessageHandler oluşturmak ve yapılandırmak için kullanılır: 

Services.AddHttpClient("configured-inner-handler") 

.ConfigurePrimaryHttpMessageHandler(() => 

{ 

retıırn new HttpClientHandler() 

{ 

AllowAutoRedirect = false, 

UseDefaııltCredentials = true 

}; 

}); 










Konsol uygulamasında ıhttpclientfactory kullanma 

Konsol uygulamasında, aşağıdaki paket başvurularını projeye ekleyin: 

• Microsoft. Extensions. Hosting 

• Microsoft. Extensions. http 

Aşağıdaki örnekte: 

• IHttpClientFactory, genel konağın hizmet kapsayıcısına kaydedilir. 

• MyService , hizmetten bir Httpciient oluşturmak için kullanılan bir istemci fabrikası örneği oluşturur. 
Httpciient , bir Web sayfasını almak için kullanılır. 

• Main , hizmetin GetPage yöntemini yürütmek için bir kapsam oluşturur ve Web sayfası içeriğinin ilk 500 
karakterini konsola yazar. 


using System; 

using System.Net.Http; 

using System.Threading.Tasks; 

using Microsoft.Extensions.Dependencylnjection; 

using Microsoft. Extensions .Hosting; 

using Microsoft.Extensions.Logging; 

class Program 

{ 

static async Task<int> Main(string[] args) 

{ 

var builder = new HostBuilder() 

.ConfigureServices((hostContext, Services) => 

{ 

Services.AddHttpClient(); 

Services.AddTransient<IMyService, MyService>(); 

}).UseConsoleLifetime(); 

var hoşt = builder.Build(); 

using (var serviceScope = hoşt.Services.CreateScope()) 

{ 

var Services = serviceScope.ServiceProvider; 

try 

{ 

var myService = Services.GetRequiredService<IMyService>(); 
var pageContent = await myService.GetPage(); 

Console.Writel_ine(pageContent .Substring(0, 500)); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<ILogger<Program>>(); 
logger.LogError(ex, "An error occurred."); 

} 

} 

return 0; 

} 

public interface IMyService 

{ 

Task<string> GetPage(); 

} 

public class MyService : IMyService 

{ 

private readonly IHttpClientFactory _clientFactory; 




public MyService(IHttpClientFactory clientFactory) 

{ 

_clientFactory = clientFactory; 

} 

public async Task<string> GetPage() 

{ 

// Content fnom BBC One: Dr. Who website (©BBC) 
var request = new HttpRequestMessage(FlttpMethod .Get, 
"https://www.bbc . co.uk/programmes/b006q2x0"); 
var Client = _clientFactory.CreateClient(); 
var response = await Client.SendAsync(request); 

if (response.IsSuccessStatusCode) 

{ 

return await response.Content.ReadAsStringAsync(); 

} 

else 

{ 

return $"StatusCode: {response.StatusCode}"; 

} 

} 

} 

} 


Ek kaynaklar 

• Dayanıklı HTTP isteklerini uygulamak için HttpClientFactory kullanma 

• HttpClientFactory ve Polly ilkeleriyle üstel geri alma ile HTTP çağrı yeniden denemeleri uygulayın 

• Devre Kesici desenini uygulama 


ASRNET Core statik dosyalar 
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By Rick Anderson ve Scott Ade 

HTML, CSS, resim ve JavaScript gibi statik dosyalar, ASP.NET Core bir uygulamanın doğrudan istemcilere 
hizmet verdiği varlıklardır. Bu dosyalara hizmet sunma özelliğini etkinleştirmek için bazı yapılandırmalar 
gerekir. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 


Statik dosyaları sunma 

Statik dosyalar projenin Web kök dizininde depolanır. Varsayılan dizin {Content root}/Wwwroot, ancak 
usevvebroot yöntemi aracılığıyla değiştirilebilir. Daha fazla bilgi için bkz. içerik kökü ve Web kök . 

Uygulamanın Web ana bilgisayarı, içerik kök dizininden haberdar olmalıdır. 

webHost.CreateüefauitBuiider yöntemi, içerik kökünü geçerli dizine ayarlar: 

public class Program 
{ 

public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build().Run(); 

} 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefauitBuiider(args) 

.UseStartup<Startup>(); 

} 

Program.Main içinde Usecontentroot 'yi çağırarak içerik kökünü geçerli dizine ayarlayın: 

public class Program 
{ 

public static void Main(string[] args) 

{ 

var hoşt = new WebHostBuilder() 

.UseKestrel() 

.UseContentRoot(Directory .GetCurrentDirectoryO) 

.UseIISIntegration() 

.UseStartup<Startup>() 

.UseApplicationInsights() 

.Build(); 

hoşt.Run(); 

} 

} 

Statik dosyalara, Web kökünegöre bir yol aracılığıyla erişilebilir. Örneğin, Web uygulaması proje şablonu 
Wwwroot klasörü içinde birkaç klasör içerir: 


• Wwwroot 
o Self 






o yansımasını 
o JS 

Görüntüler alt klasöründeki bir dosyaya erişmek için URI biçimi, http://<server_address 
>/images/<image_file_name > . Örneğin, http://localhost:9189/images/banner3.svg . 

.NET Framevvork hedefliyorsanız, Microsoft. AspNetCore. StaticFiles paketini projeye ekleyin. .NET Core 
hedefleniyorsa, Microsoft. AspNetCore. app metapackage bu paketi içerir. 

.NET Framevvork hedefliyorsanız, Microsoft. AspNetCore. StaticFiles paketini projeye ekleyin. .NET Core 
hedefleniyorsa, Microsoft. AspNetCore. Ali metapackage bu paketi içerir. 

Projeye Microsoft. AspNetCore. StaticFiles paketini ekleyin. 

Statik dosyaları sunmaya izin veren ara yazılımı yapılandırın. 

Web kökünün içindeki dosyaları sunma 

startup.configure içinde Usestaticfiles metodunu çağırın: 

public void Configure(IApplicationBuilder app) 

{ 

app.UseStaticFiles(); 

} 

Parametresiz usestaticFiles yöntemi aşırı yüklemesi, Web kökündeki dosyaları servable olarak işaretler. 
Aşağıdaki biçimlendirme Wwwroot/lmages/bannerl. Sl/Göğesine başvuruyor: 

<img src="~/images/bannerl.svg" alt="ASP.NET" class="img-responsive" /> 

Yukarıdaki kodda, tilde karakteri Web köküneişaret eder ~/ . 

Dosyaları Web kökünün dışında sunma 

Sunulacak statik dosyaların Web kökünündışında yer aldığı bir dizin hiyerarşisini göz önünde bulundurun 

• Wwwroot 
o Self 

o yansımasını 
o JS 

• MyStaticFiles 
o yansımasını 

o bannerl. SVG 

Bir istek statik dosya ara yazılımını aşağıdaki şekilde yapılandırarak bannerl. SVG dosyasına erişebilir: 

public void Configure(IApplicationBuilder app) 

{ 

app.UseStaticFiles(); // For the wwwroot folder 

app.UseStaticFiles(new StaticFileOptions 
{ 

FileProvider = new PhysicalFileProvider( 

Path.Combine(Directory .GetCurrentDirectoryO, "MyStaticFiles ")), 

RequestPath = "/StaticFiles" 

}); 









Yukarıdaki kodda, mystaticfiles dizin hiyerarşisi, stat'ıcf'ıles URI segmenti aracılığıyla herkese açıktır. 
Http://<server_address >/StaticFiles/images/bannerl.SVG için bir istek bannerl. SVG dosyasına hizmet 
verir. 

Aşağıdaki biçimlendirme Mystaticfiles/lmages/bannerl. SVG 1 ye başvurur: 


<img src="~/StaticFiles/images/bannerl.svg" alt="ASP.NET" class="img-responsive" /> 


HTTP yanıt üstbilgilerini ayarla 

Staticfileoptions NESNESİ, http yanıt üst bilgilerini ayarlamak için kullanılabilir. Web kökündenstatik dosya 
sunma yapılandırmasına ek olarak, aşağıdaki kod Cache-Control üst bilgisini ayarlar: 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

var cachePeriod = env.IsDevelopment() ? "600" : "604800"; 
app.UseStaticFiles(new StaticFileOptions 
{ 

OnPrepareResponse = ctx => 

{ 

// Requires the following import: 

// ıısing Microsoft.AspNetCore.Http; 

ctx.Context.Response.Headers.Append("Cache-Control", $"public, max-age={cachePeriod}"); 

} 

}); 

} 


Headerdictionaryextensions. Append yöntemi, Microsoft. Aspnetcore. http paketinde bulunur. 
Dosyalar, geliştirme ortamında 10 dakika (600 saniye) için genel olarak önbelleklenebilir hale getirilir: 


▼ Response Headers vîevv source 

Content-Length: 143058 
Content-Type: image/png 
Date: Wed, 01 Feb 2017 01:27:01 GUT 
ETag: "Idl909cf92bacd2” 

Last-Modified: Thu, 07 Apr 2016 07:13:24 GMT 


Statik dosya yetkilendirmesi 

Statik dosya ara yazılımı yetkilendirme denetimleri sağlamıyor. M/u/u/roofaltındakiler de dahil olmak üzere 
hizmet tarafından sunulan tüm dosyalar herkese açık olarak erişilebilir. Dosyalara yetkilendirme temelinde 
hizmeti sağlamak için: 

• Onları Wwwroot dışında ve statik dosya ara yazılımı tarafından erişilebilen herhangi bir dizinle 
saklayın. 

• Yetkilendirmeyi uygulanan bir eylem yöntemi aracılığıyla onlara sunar.Bir FileResult nesnesi 
döndürür: 


[Authorize] 

public IActionResult Bannerlmage() 

{ 

var file = Path.Combine(Directory.GetCurrentDirectory(), 

"MyStaticFiles", "images", "bannerl.svg"); 

return PhysicalFile(file, "image/svg+xml"); 

} 









Dizin taramayı etkinleştir 

Dizin tarama, Web uygulamanızın kullanıcılarına belirtilen bir dizin içindeki bir dizin listesini ve dosyalarını 
görmesini sağlar. Dizin tarama, güvenlik nedenleriyle varsayılan olarak devre dışıdır (bkz. hususlar), 
startup.configure içinde Usedirectorybrowser metodunu çağırarak dizin taramayı etkinleştirin: 

public void Configure(IApplicationBuilder app) 

{ 

app.UseStaticFiles(); // For the wwwroot folder 

app.UseStaticFiles(new StaticFileOptions 

{ 

FileProvider = new PhysicalFileProvider( 

Path.Combine(Directory.GetCurrentDirectory(), "wwwroot ", "images ")), 

RequestPath = "/Mylmages" 

}); 

app.UseDirectoryBrowser(new DirectoryBnowserOptions 
{ 

FileProvider = new PhysicalFileProvider( 

Path.Combine(Directory.GetCurrentDirectoryO, "wwwroot", "images ")), 

RequestPath = "/Mylmages" 

}); 

} 

startup.configureServices adresinden Adddirectorybrovvser yöntemini çağırarak gerekli hizmetleri ekleyin: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDirectoryBrowser(); 

} 


Yukarıdaki kod, her bir dosya ve klasörün bağlantılarıyla birlikte http://<server_address >/mylmages URL 
'sini kullanarak Wwwroot/görüntüler klasöründe Dizin taramasına izin verir: 


B lndex of /Mylmages/ X -f- — □ X 

O İJIİ localhost: 1234/Mylmages -fa =~ Xû & '" 


lndex of /Mylmo 


Name 

Size 

Last Modlfied 

aanner1.svg 

9,679 

5/13/2016 5:51:18 AM *00/» 

banner2.svg 

8,394 

5/13/2016 5:51:18 AM *00/» 

banner3.svg 

10,872 

5/13/2016 5:51:18 AM *00/» 

banner4.svg 

12,291 

5/13/2016 5:51:18 AM *00/» 


Göz atmayı etkinleştirirken güvenlik riskleri hakkındaki noktalara göz atın. 

Aşağıdaki örnekte iki usestaticFiles çağrısı olduğunu aklınızda edin, ilk çağrı Wwwroot klasöründeki statik 
dosyaları sunmaya izin veriyor, ikinci çağrı, http://<server_address >/mylmages\JRl 'sini kullanarak 
Wwwroot/görüntüler klasöründe dizin taramayı mümkün bir şekilde sunar: 









public void Configure(IApplicationBuilder app) 

{ 

app.UseStaticFiles(); // For the wwwroot folder 

app.UseStaticFiles(new StaticFileOptions 

{ 

FileProvider = new PhysicalFileProvider( 

Path.Combine(Directory .GetCurrentDirectoryO, "wwwroot", "images ")), 
RequestPath = "/Mylmages" 

}); 

app.UseDirectoryBrowser(new DirectoryBrowserOptions 

{ 

FileProvider = new PhysicalFileProvider( 

Path.Combine(Directory.GetCurrentDirectory()j "wwwroot"j "images ")), 
RequestPath = "/Mylmages" 

}); 


Varsayılan bir belge sunar 

Varsayılan ana sayfanın ayarlanması, ziyaretçi sitenizi ziyaret ederken mantıksal bir başlangıç noktası sağlar. 
Kullanıcı URI 'yi tamamen nitelemeden varsayılan bir sayfaya hizmeti sağlamak için startup.configure 1 den 
Usedefaultfiles metodunu çağırın: 

public void Configure(IApplicationBuilder app) 

{ 

app.UseDefaultFiles(); 
app.UseStaticFiles(); 

} 


IMPORTANT 

Varsayılan dosyayı kullanabilmek için usestaticFiles önce useDefaultFiles çağrılmalıdır. useDefaultFiles , 
dosyayı gerçekten sunan bir URL yeniden yazar. Dosyayı çalıştırmak için UsestaticFiles aracılığıyla statik dosya ara 
yazılımı etkinleştirin. 


useDefaultFiles , bir klasör için arama istekleri: 

• default. htm 

• default. html 

• index. htm 

• index. html 

Listedeki ilk dosya, istek tam URI olmasına rağmen olarak sunulur.Tarayıcı URL 'SI, istenen URI 'yi 
yansıtacak şekilde devam ediyor. 

Aşağıdaki kod varsayılan dosya adını mydefault. fıtm/olarak değiştirir: 








public void Configure(IApplicationBuilder app) 

{ 

// Serve my app-specific default file, if present. 

DefaultFilesOptions options = new DefaultFilesOptions(); 

options.DefaultFileNames.Clear(); 

options.DefaultFileNames.Add("mydefault.html"); 

app.UseDefaultFileş(options); 

app.UseStaticFiles(); 

} 


Usedosya sunucusu 

UseFileServer, UseStaticFiles , UseDefaultFiles ve isteğe bağlı olarak UseDirectoryBrowser işlevlerini 
birleştirir. 

Aşağıdaki kod, statik dosyaların ve varsayılan dosyanın kullanılmasına izin veriyor. Dizin tarama etkin değil. 

app.UseFileServer(); 

Aşağıdaki kod, dizin taramayı etkinleştirerek Parametresiz aşırı yüklemeden sonra oluşturulur: 

app.UseFileServer(enableDirectoryBrowsing: true); 

Aşağıdaki dizin hiyerarşisini göz önünde bulundurun: 

• Wwwroot 
o Self 

o yansımasını 
o JS 

• MyStaticFiles 
o yansımasını 

o bannerl. SVG 
o default. html 

Aşağıdaki kod, MyStaticFiles statik dosyaları, varsayılan dosyaları ve dizin taramayı mümkün bir şekilde 
sunar: 


public void Configure(IApplicationBuilder app) 

{ 

app.UseStaticFiles(); // For the wwwroot folder 

app.UseFileServer(new FileServerOptions 

{ 

FileProvider = new PhysicalFileProvider( 

Path.Combine(Directony.GetCurrentDirectonyO, "MyStaticFiles")), 

RequestPath = "/StaticFiles", 

EnableDinectoryBrowsing = true 

}); 

} 

AddDirectoryBrowser , EnableDirectoryBrowsing Özellik değeri true olduğunda çağrı I m alidir: 









public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDirectoryBrowser(); 

} 

Dosya hiyerarşisini ve önceki kodu kullanarak, URL 'Ler aşağıdaki şekilde çözümlenir: 

{1 > U Rl < 1 > YANITIYLA 

http://<server_address >/StaticFiles/images/bannerl.svg MyStaticFiles/lmages/bannerl. SVG 

http://<server_address >/StaticFiles MyStaticFiles/default.html 

Mystaticfiles dizininde varsayılan adlı dosya yoksa, http://<server_address >/staticfiles, tıklanabilir 
bağlantılarla dizin listesini döndürür: 



NOTE 

UseDefaultFiles ve UseDirectoryBrovvser http://{SERVER ADDRESS}/staticFiles (sondaki eğik çizgi olmadan) 
http:// {server ADDRESS}/staticFiles/ için (sondaki eğik çizgiyle) istemci tarafı yeniden yönlendirmesi 
gerçekleştirin. Staticfiles dizinindeki göreli URL ler, sondaki eğik çizgi olmadan geçersizdir. 


FileExtensionContentTypeProvider 

Fileextensioncontenttypeprovider sınıfı, MİME içerik türlerine dosya uzantılarının eşlemesi olarak hizmet 
veren bir Mappings özelliği içerir. Aşağıdaki örnekte, bazı dosya uzantıları bilinen MİME türlerine kaydedilir.. 
Rtf uzantısı değiştirilmiştir ve. mp4 kaldırılır. 






public void Configure(IApplicationBuilder app) 

{ 

// Set up custom content types - associating file extension to MİME type 
var provider = new FileExtensionContentTypeProvider(); 

// Add new mappings 

provider.Mappings[".myapp"] = "application/x-msdownload"; 
provider.Mappings[".htm3"] = "text/html"; 
provider.Mappings[".image"] = "image/png"; 

// Replace an existing mapping 

provider.Mappings[".rtf"] = "application/x-msdownload"; 

// Remove MP4 videos. 

provider.Mappings.Remove(".mp4"); 

app.UseStaticFiles(new StaticFileOptions 

{ 

FileProvider = new PhysicalFileProvider( 

Path.Combine(Directory.GetCurrentDirectoryO, "wwwroot", "images ")), 
RequestPath = "/Mylmages", 

ContentTypeProvider = provider 

}); 

app.UseDirectoryBrowser(new DirectoryBrowserOptions 

{ 

FileProvider = new PhysicalFileProvider( 

Path.Combine(Directory.GetCurrentDirectoryO^ "wwwroot"j "images ")), 
RequestPath = "/Mylmages" 

})J 

} 


Bkz. MİME içerik türleri. 

Standart olmayan içerik türleri 

Statik dosya ara yazılımı, neredeyse 400 bilinen dosya içerik türlerini anlamıştır. Kullanıcı bilinmeyen bir 
dosya türüne sahip bir dosya isterse, statik dosya ara yazılımı isteği ardışık düzendeki bir sonraki ara 
yazılıma geçirir. Bir ara yazılım, isteği işlediğinde, bir 404 bulunamadı yanıtı döndürülür. Dizin tarama 
etkinse, bir dizin listesinde dosyaya bir bağlantı görüntülenir. 

Aşağıdaki kod, bilinmeyen türlere hizmet olarak bilinmeyen türler sunar ve bilinmeyen dosyayı görüntü 
olarak işler: 

public void Configure(IApplicationBuilder app) 

{ 

app.UseStaticFiles(new StaticFileOptions 

{ 

ServeUnl<nownFileTypes = true, 

DefaultContentType = "image/png" 

}); 

} 


Yukarıdaki kodla, bilinmeyen içerik türüne sahip bir dosya isteği görüntü olarak döndürülür. 


VVARNING 

ServellnknovvnFileTypes etkinleştirme bir güvenlik riskidir. Varsayılan olarak devre dışıdır ve kullanımı önerilmez. 
Fileextensioncontenttypeprovider standart olmayan uzantılara sahip dosyalara hizmet vermeye yönelik daha güvenli 
bir alternatif sağlar. 


Birden çok konumdan dosyaları sunma 








usestaticFiles ve useFileServer , Wwwroot‘ a işaret eden dosya sağlayıcısına varsayılan olarak sahiptir. 
Diğer konumlardan dosya sunmak için diğer dosya sağlayıcılarıyla UsestaticFiles ve UseFileServer ek 
örnekleri sağlayabilirsiniz. Daha fazla bilgi için Bu GitHub sorununabakın. 


Dikkat Edilecekler 



büyük/küçük harf duyarlılığı ve karakter kısıtlamalarına tabidir. Örneğin, Windows büyük/küçük harfe 
duyarsız—macOS ve Linux değildir. 

• IIS 'de barındırılan ASP.NET Core uygulamalar, statik dosya istekleri de dahil olmak üzere tüm 
istekleri uygulamaya iletmek için ASP.NET Core modülünü kullanır. IIS statik dosya işleyicisi 
kullanılmıyor. Modül tarafından işlenmek üzere istekleri işleme şansı yoktur. 

• Sunucu veya Web sitesi düzeyinde IIS statik dosya işleyicisini kaldırmak için IIS Yöneticisi ' nde 
aşağıdaki adımları uygulayın: 

1. Modüller özelliğine gidin. 

2. Listeden StaticFileModule ' ü seçin. 

3. Eylemler kenar çubuğunda Kaldır 1 a tıklayın. 


VVARNING 

IIS statik dosya işleyicisi etkinse ve ASP.NET Core modülü yanlış yapılandırılmışsa, statik dosyalar sunulur. Bu, örneğin, 
Web. config dosyası dağıtılmamışsa oluşur. 


• Kod dosyalarını (. cs ve. cshfm/dahil) uygulama projesinin Web kökünündışına yerleştirin. Bu nedenle, 
uygulamanın istemci tarafı içeriği ile sunucu tabanlı kod arasında bir mantıksal ayrım oluşturulur. Bu, 
sunucu tarafı kodun sızmasını önler. 

Ek kaynaklar 

• Ara Yazılım 

• ASP.NET Core giriş 













ASRNET Core Razor Pages giriş 

6.12.2019 • 66 minutes to readz. Edit Online 


By Rick Anderson ve Ryan şimdi ak 

Razor Pages, kodlama sayfasına odaklanmış senaryolar denetleyicileri ve görünümleri kullanmaktan 
daha kolay ve daha üretken hale getirebilirsiniz. 

Model-View-Controller yaklaşımını kullanan bir öğretici arıyorsanız, bkz. ASP.NET Core MVC ile 
çalışmaya başlama. 

Bu belge Razor Pages bir giriş sağlar. Adım adım öğretici değildir. Bölümlerden bazılarını çok 
gelişmiş bir şekilde bulursanız, bkz. Razor Pages kullanmaya başlama. ASP.NET Core genel bir bakış 
için bkz. ASP.NET Core giriş. 

Prerequisites 

• Visuai Studio 

• Visuai Studio Code 

• Mac için Visuai Studio 

• ASP.net ve Web geliştirme iş yüküyle Visuai Studio 2019 

• .NET Core 3,0 SDK veya üzeri 

Razor Pages projesi oluşturma 

• Visuai Studio 

• Visuai Studio Code 

• Mac için Visuai Studio 

Razor Pages projesi oluşturma hakkında ayrıntılı yönergeler için bkz. Razor Pages kullanmaya 
başlama . 

Razor Pages 

Razor Pages, Startup.cs'de etkinleştirilmiştir: 





public class Startup 

{ 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRazorPages(); 

} 

public void Configure(IApplicationBuilder app, IWebHostEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 
app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 

app.UseRouting(); 

app.UseAuthorization(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapRazorPages(); 

}); 

} 

} 

Temel bir sayfa düşünün: 

@page 

<hl>Helİ 0 j world!</hl> 

<h2>The time on the server is @DateTime.Now</h2> 


Yukarıdaki kod, denetleyiciler ve görünümlerle ASP.NET Core bir uygulamada kullanılan Razor 
görünüm dosyası gibi bir çok şey arar. Bu, farklı kılan @page yönergedir. @page , dosyayı bir 
denetleyiciye geçmeden doğrudan istekleri işlediği anlamına gelen bir MVC eylemine sahip olur. 
@page sayfadaki ilk Razor yönergesi olmalıdır. @page diğer Razor yapıları davranışını etkiler. Razor 
Pages dosya adlarında . cshtml soneki vardır. 

PageModei sınıfı kullanan benzer bir sayfa aşağıdaki iki dosyada gösterilmiştir. Pages/lndex2. cshtml 
dosyası: 












@page 

@using RazorPagesIntro.Pages 
@model Index2Model 

<h2>Separate page model</h2> 

<p> 

@Model.Message 

</p> 


Pages/tndex2. cshtmi cs sayfa modeli: 

using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft. Extensions. Logging; 
using System; 

namespace RazorPagesIntro.Pages 
{ 

public class Index2Model : PageModel 
{ 

public string Message { get; private set; } = "PageModel in C#"; 

public void OnGet() 

{ 

Message += $" Server time is { DateTime.Now }"; 

} 

} 

} 

Kurala göre PageModel sınıf dosyası,. cs eklenmiş Razor sayfası dosyasıyla aynı ada sahiptir.Örneğin, 
önceki Razor sayfası Pages/lndex2. cshtmi' dir. PageModel sınıfını içeren dosya sayfa/lndex2. cshtmi. 
csolarak adlandırılır. 

URL yollarının sayfalara olan ilişkilendirmeleri, sayfanın dosya sistemindeki konumuna göre 
belirlenir. Aşağıdaki tabloda bir Razor sayfa yolu ve eşleşen URL gösterilmektedir: 

DOSYA ADI VE YOLU EŞLEŞEN URL 

/Pages/lndex.cshtml / veya /index 

/Pages/Contact.exe /Contact 

/Pages/Store/Contact.exe /store/contact 

/Pages/Store/lndex.cshtml /store veya /store/index 

Notlar: 

• Çalışma zamanı, Sayfalar klasöründeki Razor Pages dosyaları varsayılan olarak arar. 

• index , URL bir sayfa içermiyorsa varsayılan sayfasıdır. 

Temel form yazma 

Razor Pages, Web tarayıcıları ile kullanılan ortak desenleri bir uygulama oluştururken kolayca 
uygulanması için tasarlanmıştır. Model bağlama, ETİKET yardımcılarıve HTML Yardımcıları hepsi, 
Razor sayfası sınıfında tanımlanan özelliklerle çalışır . Contact modeli için temel bir "bize başvurun" 
formu uygulayan bir sayfa düşünün: 













Bu belgedeki örnekler için DbContext , Startup.es dosyasında başlatılır. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<CustomerDbContext>(options => 

options.UseInMemoryDatabase("name")); 
Services.AddRazorPages(); 

} 


Veri modeli: 


using System.ComponentModel.DataAnnotations; 

namespace RazorPagesContacts.Models 

{ 

public elass Customer 

{ 

public int Id { get; set; } 

[Requiredj StringLength(10)] 
public string Name { get; set; } 

} 

} 


DB bağlamı: 

using Microsoft.EntityFrameworkCore; 
using RazorPagesContacts.Models; 

namespace RazorPagesContacts.Data 

{ 

public elass CustomerDbContext : DbContext 

{ 

public CustomerDbContext(DbContextOptions options) 
: base(options) 

{ 

} 

public DbSet<Customer> Customers { get; set; } 

} 

} 


Pages/Create. cshtml görünüm dosyası: 

@page 

@model RazorPagesContacts.Pages.Customers.CreateModel 
@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 

<p>Enter a customer name:</p> 

<form method="post"> 

Name: 

cinput asp-for="Customer.Name" /> 

<input type="submit" /> 

</form> 


Pages/Create. cshtml. cs sayfa modeli: 








using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using RazorPagesContacts.Data; 

using RazorPagesContacts.Models; 

using System.Threading.Tasks; 

namespace RazorPagesContacts.Pages.Customers 

{ 

public class CreateModel : PageModel 

{ 

private readonly CustomerDbContext _context; 

public CreateModel(CustomerDbContext context) 

{ 

_context = context; 

} 

public IActionResult OnGet() 

{ 

return Page(); 

} 

[BindProperty] 

public Customer Customer { get; set; } 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_context.Customers.Add(Customer); 
await _context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 

} 

} 

Kurala göre PageModel sınıfı <PageName>Modei olarak adlandırılır ve sayfayla aynı ad alanında yer 
alan. 

PageModel sınıfı, bir sayfa mantığının sunumundaki ayırmayı sağlar. Sayfaya gönderilen istekler için 
sayfa işleyicilerini ve sayfayı işlemek için kullanılan verileri tanımlar. Bu ayrım şunları sağlar: 

• Bağımlılık eklemeyoluyla sayfa bağımlılıklarını yönetme. 

• Birim testi 

Sayfada, post isteklerinde çalışan bir onPostAsync işleyicisi yönfem/vardır (bir Kullanıcı formu 
gönderdiğinde). Herhangi bir HTTP fiili için işleyici metotları eklenebilir. En yaygın işleyiciler 
şunlardır: 

• Sayfanın başlatılması için gereken durum onGet . Yukarıdaki kodda onGet yöntemi CreateModel. 
cshtml Razor sayfasını görüntüler. 

• form gönderilerini işlemek için onPost . 

Async adlandırma son eki isteğe bağlıdır, ancak genellikle zaman uyumsuz işlevler için kural 
tarafından kullanılır. Yukarıdaki kod Razor Pages için tipik bir davranıştır. 

Denetleyicileri ve görünümleri kullanarak ASP.NET uygulamaları hakkında bilginiz varsa: 

• Yukarıdaki örnekteki OnPostAsync kodu, tipik denetleyici koduna benzer şekilde görünür. 















• Model bağlama, doğrulamave eylem sonuçlan gibi mvc temel elemanlarının çoğu denetleyiciler 
ve Razor Pages aynı şekilde çalışır. 

Önceki onPostAsync yöntemi: 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_context.Customers.Add(Customer); 
await _context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 

OnPostAsync temel akışı: 

Doğrulama hatalarını kontrol edin. 

• Hata yoksa, verileri kaydedin ve yeniden yönlendirin. 

• Hatalar varsa, doğrulama iletileriyle sayfayı yeniden görüntüleyin. Çoğu durumda, doğrulama 
hataları istemci üzerinde algılanır ve sunucuya hiçbir zaman gönderilmez. 

Pages/Create. cshtml görünüm dosyası: 

@page 

@model RazorPagesContacts.Pages.Customers.CreateModel 
@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 

<p>Enter a customer name:</p> 

<form method="post"> 

Name: 

cinput asp-for="Customer.Name" /> 
cinput type="submit" /> 

</form> 


Sayfalardan işlenmiş HTML /Create. cshtml: 

<p>Enter a customer name:</p> 

<form method="post"> 

Name: 

cinput type="text" data-val="true" 

data-val-length="The field Name must be a string with a maximum length of 10." 
data-val-length-max="10" data-val-required="The Name field is required." 
id="Customer_Name" maxlength="10" name="Customer.Name" value="" /> 
cinput type="submit" /> 

cinput name="_RequestVerificationToken" type="hidden" 

value="cAntiforgery token here>" /> 

c/form> 

Önceki kodda, formu deftere nakletme: 

• Geçerli verilerle: 

o OnPostAsync Handler yöntemi RedirectToPage yardımcı yöntemini çağırır. 
RedirectToPage , bir RedirectToPageResult Örneği döndürür. RedirectToPage : 





o Bir eylem sonucudur. 


o RedirectToAction veya RedirectToRoute benzerdir (denetleyiciler ve görünümlerde 
kullanılır). 

o Sayfalar için özelleştirilir.Önceki örnekte, kök dizin sayfasına ( /index ) yeniden 
yönlendirir. RedirectToPage , Sayfalar İçin URL oluşturma bölümünde ayrıntılı olarak 
açıklanmıştır. 

• Sunucuya geçirilen doğrulama hatalarıyla birlikte: 

o onPostAsync Handler yöntemi Page yardımcı yöntemini çağırır. Page , bir PageResult 
örneği döndürür. Page döndürmek, denetleyicilerde eylemlerin view nasıl dönüşlerine 
benzer. PageResult , bir işleyici yöntemi için varsayılan dönüş türüdür, void döndüren bir 
işleyici yöntemi sayfayı işler. 

o Yukarıdaki örnekte, formun hiçbir değer olmadan nakledilmesi ModelState ile sonuçlanır. 
IsValid yanlış döndürüyor. Bu örnekte, istemcide hiçbir doğrulama hatası gösterilmezler. 
Doğrulama hatası teslim etme bu belgenin ilerleyen bölümlerinde ele alınmıştır. 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_context.Customers.Add(Customer); 
await _context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 

• İstemci tarafı doğrulaması tarafından algılanan doğrulama hatalarıyla birlikte: 
o Veriler sunucuya nakledilmedi. 

o istemci tarafı doğrulaması bu belgenin ilerleyen kısımlarında açıklanmıştır. 

Customer özelliği, model bağlamasını kabul etmek için [BindProperty] özniteliğini kullanır: 













public class CreateModel : PageModel 

{ 

private readonly CustomerDbContext _context; 

public CreateModel(CustomerDbContext context) 

{ 

_context = context; 

} 

public IActionResult OnGet() 

{ 

return Page(); 

} 

[BindProperty] 

public Customer Customer { get; set; } 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

retunn Page(); 

} 

_context.Customers.Add(Customer); 
await _context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 

} 

[BindProperty] , istemci tarafından değiştirilmemesi gereken özellikler içeren modellerde 
kullanılmamalıdır. Daha fazla bilgi için bkz. fazla nakil. 

Razor Pages, varsayılan olarak, özellikleri yalnızca get olmayan fiiller ile bağlayın. Özelliklere 
bağlama, HTTP verilerini model türüne dönüştürmek için kod yazma ihtiyacını ortadan kaldırır. 
Bağlama, form alanlarını işlemek için aynı özelliği kullanarak kodu azaltır ( 
cinput asp-for="Customer.Name"> ) ve girişi kabul eder. 


VVARNING 

Güvenlik nedenleriyle, get istek verilerini sayfa modeli özelliklerine bağlamayı tercih etmeniz gerekir. 
Özelliklerle eşleştirmadan önce Kullanıcı girişini doğrulayın, get bağlamaya dönüştürmek, sorgu dizesine 
veya rota değerlerine dayanan senaryoları adreslemekte yararlıdır. 

get isteklerindeki bir özelliği bağlamak için, [BindProperty] özniteliğinin supportsGet özelliğini true 
olarak ayarlayın: 

[BindProperty(SupportsGet = true)] 

Daha fazla bilgi için bkz. ASP.NET Core topluluk alışması: Get tartışmasına bağlama (YouTube). 


Sayfalar/oluşturma, cshtml görünüm dosyası gözden geçiriliyor: 








@page 

@model RazorPagesContacts.Pages.Customers.CreateModel 
@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 

<p>Enter a customer name:</p> 

<form method="post"> 

Name: 

<input asp-for="Customer.Name" /> 

<input type="submit" /> 

</form> 

• Yukarıdaki kodda, giriş etiketi yardımcısı cinput asp-for="Customer.Name" /> HTML <input> 
öğesini customer.Name model ifadesine bağlar. 

• @addîagHeiper etiket yardımcılarını kullanılabilir hale getirir. 

Giriş sayfası 

lndex. cshtml giriş sayfasıdır: 

@page 

@model RazorPagesContacts.Pages.Customers.IndexModel 
@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 

<hl>Contacts home page</hl> 

<form method="post"> 

<table class="table"> 

<thead> 

<tr> 

<th>ID</th> 

<th>Name</th> 

</tr> 

</thead> 

<tbody> 

@foreach (var contact in Model.Customer) 

{ 

<tr> 

<td> @contact.Id </td> 

<td>@contact.Name</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@contact.Id">Edit</a> | 
cbutton type="submit" asp-page-handler="delete" 
asp-route-id="@contact.Id">delete 
</button> 

</td> 

</tr> 

} 

</tbody> 

</table> 

<a asp-page="Create">Create New</a> 

</form> 


ilişkili PageModei sınıfı (lndex.cshtml.cs): 









public class IndexModel : PageModel 

{ 

private readonly CustomerDbContext _context; 

public IndexModel(CustomerDbContext context) 

{ 

_context = context; 

} 

public IList<Customer> Customer { get; set; } 

public async Task OnGetAsync() 

{ 

Customer = await _context.Customers.ToListAsync(); 

} 

public async Task<IActionResult> OnPostDeleteAsync(int id) 

{ 

var contact = await _context.Customers.FindAsync(id); 

if (contact != null) 

{ 

_context.Customers.Remove(contact); 
await _context.SaveChangesAsync(); 

} 

return RedirectToPage(); 

} 

} 

lndex. cshtml dosyası aşağıdaki biçimlendirmeyi içerir: 

<a asp-page="./Edit" asp-route-id="@contact.Id">Edit</a> | 

<a /a> tutturucu etiketi Yardımcısı , düzenleme sayfasına bir bağlantı oluşturmak için 
asp-route-{vaiue} özniteliğini kullandı. Bağlantı, iletişim KİMLİĞİNE sahip rota verileri içerir. 
Örneğin: https://iocaihost:500i/Edit/ı . Etiket Yardımcıları, Razor dosyalarında HTML öğelerinin 
oluşturulmasına ve işlenmesine sunucu tarafı kodun katılmasını etkinleştir. 

Index. cshtml dosyası her müşteri için bir silme düğmesi oluşturmak için biçimlendirme içerir: 

<button type="submit" asp-page-handler="delete" 
asp-route-ld="@contact.Id">delete 

İşlenmiş HTML: 

<button type="submit" formaction="/Customers?id=l&amp;handler=delete">delete</button> 

Sil düğmesi HTML 'de işlendiğinde, bu nesnenin biçimlendirme parametreleri içerir: 

• asp-route-id özniteliğiyle belirtilen müşteri iletişim KİMLİĞİ. 

• asp-page-handler Öznitelİğiyle belirtilen handler . 

Düğme seçildiğinde, sunucuya bir form post isteği gönderilir. Kurala göre, işleyici yönteminin adı, 
düzen 0nPost[handier]Async göre handler parametresinin değerine göre seçilir. 

Bu örnekte handler delete olduğundan, onPostDeleteAsync Handler yöntemi post isteğini 
işlemek için kullanılır, asp-page-handler, remove gibi farklı bir değere ayarlandıysa 












onPostRemoveAsync ada sahip bir işleyici yöntemi seçilidir. 


public async Task<IActionResult> OnPostDeleteAsync(int id) 

{ 

var contact = await _context.Customers.FindAsync(id); 

if (contact != null) 

{ 

_context.Customers.Remove(contact); 
await _context.SaveChangesAsync(); 

} 

return RedirectToPage(); 

} 

OnPostDeleteAsync Yöntemi: 

• Sorgu dizesinden id alır. 

• FindAsync ile müşteri iletişim için veritabanını sorgular. 

• Müşteri iigili kişisi bulunursa, kaldırılır ve veritabanı güncelleştirilir. 

• Kök dizin sayfasına yeniden yönlendirmek için RedirectToPage çağırır ( /index ). 

Edit. cshtml dosyası 

@page "{id:int}" 

@model RazorPagesContacts.Pages.Customers.EditModel 
@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 

<hl>Edit Customer - @Model.Customer.Id</hl> 

<form method="post"> 

<div asp-validation-summary="All"x/div> 
cinput asp-for="Customer.Id" type="hidden" /> 

<div> 

clabel asp-for="Customer.Name"></label> 

<div> 

cinput asp-for="Customer.Name" /> 

<span asp-validation-for="Customer.Name"x/span> 

</div> 

</div> 

<div> 

cbutton type="submit">Save</button> 

</div> 

</form> 

ilk satır @page "{idıint}" yönergesini içerir. Yönlendirme kısıtlaması "{id:int}" , sayfaya istekleri 
int yönlendirme verileri içeren sayfaya kabul etmesini söyler. Sayfaya yapılan bir istek bir int 
dönüştürülebildiği rota verileri içermiyorsa, çalışma zamanı bir HTTP 404 (bulunamadı) hatası 
döndürür. KİMLİĞİ isteğe bağlı yapmak için ? yol kısıtlamasına ekleyin: 

@page "{id:int?}" 


Edlt.cshtmics dosyası: 











public class EditModel : PageModel 
{ 

private readonly CustomerDbContext _context; 

public Editl' / lodel(CustomerDbContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Customer Customer { get; set; } 

public async Task<IActionResult> OnGetAsync(int id) 

{ 

Customer = await _context.Customers.FindAsync(id); 

if (Customer == null) 

{ 

return RedirectToPage("./Index"); 

} 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 


_context.Attach(Customer).State = EntityState.Modified; 

try 

{ 

await _context.SaveChangesAsync(); 

} 

catch (DbUpdateConcurrencyException) 

{ 

throw new Exception($"Customer {Customer.Id} not found!"); 


} 


return RedirectToPage("./Index"); 

} 


} 


Doğrulama 

Doğrulama kuralları: 

• Model sınıfında bildirimli olarak belirtilir. 

• Uygulamada her yerde zorlanır. 

System.ComponentModel.DataAnnotations ad alanı, bir sınıfa veya özelliğe bildirimli olarak 
uygulanan bir yerleşik doğrulama öznitelikleri kümesi sağlar. Veri açıklamaları, biçimlendirme ile 
yardım eden [DataType] gibi biçimlendirme özniteliklerini de içerir ve herhangi bir doğrulama 
sağlamaz. 


customer modelini göz önünde bulundurun: 






using System.ComponentModel.DataAnnotations; 

namespace RazorPagesContacts.Models 

{ 

public class Customer 

{ 

public int Id { get; set; } 

[Requiredj StringLength(10)] 
public string Name { get; set; } 

} 

} 

Aşağıdaki Create. cshtml görünüm dosyasını kullanarak: 

@page 

@model RazorPagesContacts.Pages.Customers.CreateModel 
@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 

<p>Validation: customer name:</p> 

<form method="post"> 

<div asp-validation-summary="ModelOnly"x/div> 

<span asp-validation-for="Customer. Name "x/span> 

Name: 

<input asp-for="Customer.Name" /> 

<input type="submit" /> 

</form> 

<script src="~/lib/jquery/dist/jquery. js"x/script> 

<script src="~/lib/jquery-validation/dist/jquery. validate. js"x/script> 

<script src="~/lib/jquery-validation-unobtrusive/jquery.validate.unobtrusive.js"x/script> 


Yukarıdaki kod: 

• JQuery ve jQuery doğrulama betikleri içerir. 

• Etkinleştirmek için <div /> ve <span /> etiketi yardımcıları kullanır: 

o İstemci tarafı doğrulama, 
o Doğrulama hatası işleme. 

• Aşağıdaki HTML 'yi oluşturur: 

<p>Enter a customer name:</p> 

<form method="post"> 

Name: 

<input type="text" data-val="true" 

data-val-length="The field Name must be a string with a maximum length of 10." 
data-val-length-max="10" data-val-required="The Name field is required." 
id="Customer_Name" maxlength="10" name="Customer.Name" value="" /> 

<input type="submit" /> 

<input name="_RequestVerificationToken" type="hidden" 

value="<Antiforgery token here>" /> 

</form> 

<script src="/lib/jquery/dist/jquery. js"x/script> 

<script src="/lib/jquery-validation/dist/jquery.validate.js"x/script> 

<script src="/lib/jquery-validation-unobtrusive/jquery.validate.unobtrusive.js"x/script> 


Create formunu ad değeri olmadan göndermek "ad alanı gereklidir" hata iletisini görüntüler. 







formunda, istemcide JavaScript etkinse tarayıcı, sunucuya göndermeden hatayı görüntüler. 

[StringLength( 10 )] Öznitelİği işlenmiş HTML üzerinde data-val-length-max=" 10 " oluşturur. 
data-vai-iength-max , tarayıcıların belirtilen uzunluk üst sınırından daha fazlasını girmesini engeller. 
Gönderiyi düzenlemek ve yeniden oynatmak için Fiddler gibi bir araç kullanılıyorsa: 

• , Adı 10 1 dan daha uzun. 

• "Alan adı, en fazla 10 uzunluğunda bir dize olmalıdır" hata iletisi, döndürülür. 

Aşağıdaki Movie modelini göz önünde bulundurun: 

public class Movie 

{ 

public int ID { get; set; } 

[StringLength(60, MinimumLength = 3)] 

[Required] 

public string Title { get; set; } 

[Display(Name = "Release Date")] 

[DataType(DataType.Date)] 

public DateTime ReleaseDate { get; set; } 

[Range(l, 100)] 

[DataType(DataType.Currency)] 

[Column(TypeName = "decimal(18j 2)")] 
public decimal Price { get; set; } 

[RegularExpression(@" A [A-Z]+[a-zA-Z""'\s-]*$")] 

[Required] 

[StringLength(30)] 

public string Genre { get; set; } 

[RegularExpression(@" A [A-Z]+[a-zA-Z0-9""'\s-]*$")] 

[StringLength(5)] 

[Required] 

public string Rating { get; set; } 

} 


Doğrulama öznitelikleri, uygulanan model özellikleri üzerinde zorlamak için davranışı belirtir: 

• Required ve MinimumLength öznitelikleri bir özelliğin bir değere sahip olması gerektiğini 
belirtir, ancak hiçbir şey, kullanıcının bu doğrulamayı karşılamak için boşluk girmesini engeller. 

• ReguiarExpression özniteliği, hangi karakterlerin giriş yapabileceğini sınırlamak için kullanılır. 
Yukarıdaki kodda, "tarz": 

o Yalnızca harfler kullanılmalıdır. 

o ilk harfin büyük harfle olması gerekir. Boşluk, sayı ve özel karakterlere izin verilmez. 

• ReguiarExpression "derecelendirmesi": 

o ilk karakterin büyük harf olmasını gerektirir. 

o Sonraki boşlukların içindeki özel karakter ve sayılara izin verir. "PG-13" bir derecelendirme 
için geçerlidir, ancak bir "tarz" için başarısız olur. 

• Range özniteliği, bir değeri belirtilen bir aralık içinde kısıtlar. 

• stringLength özniteliği, bir dize özelliğinin en büyük uzunluğunu ve isteğe bağlı olarak en 
düşük uzunluğunu ayarlar. 

• Değer türleri (örneğin decimal, int, float , DateTime ), doğal olarak gereklidir ve 

[Required] özniteliğine gerek kalmaz. 













Movie modeli için Oluştur sayfasında, geçersiz değerlere sahip hatalar görüntülenir: 


| Create - Movie X + 

C A https://localhost:5001/Movies/Create O. ğ : 

RpMovie Home Privacy 

Create 

Movie 

Tîtle 

a 

The fîeld Title must be a string with a 
minimum length of 3 and a maximum 
length of 60. 

Release Date 

00/01/0001 x : » 

The Release Date field is required. 

Geme 

a 

The field Genre must match the regular 
expressıon A [A-Z)+|a-zA-Z'"\s-)*$'. 

Price 

Dog 

The field Price must be a number. 

Ratlng 

z 

The field Rating must match the regular 
expression' A [A-Z] ♦ [a-zA-ZO-9'"\s-]*$'. 


Create 


Back to List 

T 2019 - RazorPagesMovıe - Privacy 


Daha fazla bilgi için bkz. 

• Film uygulamasına doğrulama ekleme 

• ASP.NET Core 'de model doğrulaması. 

OnGet işleyicisi geri dönüşü ile tanıtıcı HEAD istekleri 

head istekleri belirli bir kaynağın üst bilgilerini almaya izin verir, get isteklerinin aksine head 
istekleri bir yanıt gövdesi döndürmez. 

Normalde, head istekleri için onHead işleyicisi oluşturulur ve çağırılır: 

public void OnHead() 

{ 

HttpContext.Response.Headers.Add("Head Test", "Handled by OnHead!"); 

} 

Razor Pages, OnHead işleyicisi tanımlanmamışsa OnGet işleyicisini çağırmaya geri döner. 


XSRF/CSRF ve Razor Pages 


















Razor Pages, Antiforgery doğrulamasıtarafından korunur. Formtaghelper , antiforgery belirteçlerini 
HTML form öğelerine çıkartır. 

Razor Pages ile düzenleri, partileri, şablonları ve etiket 
yardımcılarını kullanma 

Sayfalar, Razor görünüm altyapısının tüm özellikleri ile çalışır. Düzenler, partıals, şablonlar, etiket 
yardımcıları, _ViewStart. cshtmhe_Viewlmports. cshtml geleneksel Razor görünümlerinde oldukları 
gibi çalışır. 

Bu özelliklerden bazılarının avantajlarından yararlanarak bu sayfayı declutter edelim. 
Sayfa/paylaşdan/_Layout. cshtml'ye bir Düzen sayfası ekleyin: 

<!DOCTYPE html> 

<html> 

<head> 

<title>RP Sample</title> 

clink rel="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.css" /> 

</head> 

<body> 

<a asp-page="/Index">Home</a> 

<a asp-page="/Customers/Create">Create</a> 

<a asp-page="/Customers/Index">Customers</a> <br /> 

@RenderBody() 

<script src="~/lib/jquery/dist/jquery. js"x/script> 

<script src="~/lib/jquery-validation/dist/jquery.validate.js"x/script> 

<script src="~/lib/jquery-validation-unobtrusive/jquery.validate.unobtrusive.js"x/script> 
</body> 

</html> 


Düzen: 

• Her sayfanın yerleşimini denetler (sayfa düzen dışında değilse). 

• JavaScript ve stil sayfaları gibi HTML yapılarını içeri aktarır. 

• Razor sayfasının içerikleri @RenderBody() her çağrıldığında işlenir. 

Daha fazla bilgi için bkz. Düzen sayfası. 

Layout özelliği Pages/_ViewStart. cshtml' de ayarlanır: 

Layout = "_Layout"; 

} 


Düzen Sayfalar/paylaşdan klasöründedir. Sayfalar, geçerli sayfayla aynı klasörden başlayarak diğer 
görünümleri (düzenler, şablonlar, parals) hiyerarşik olarak arar. Sayfalar/paylaşdan klasördeki bir 
düzen, Sayfalar klasörü altındaki herhangi bir Razor sayfasından kullanılabilir. 

Düzen dosyası Sayfalar/paylaşdan klasörüne gitmelidir. 

Düzen dosyasını Görünümler/paylaşdan klasöre yerleştirmenizi öneririz . Görünümler/paylaşdan 
bir MVC görünümleri modelidir. Razor Pages, yol kurallarını değil klasör hiyerarşisine güvenmektir. 

Bir Razor sayfasından arama görüntüleme, Sayfalar klasörünü içerir. MVC denetleyicileri ve 
geleneksel Razor görünümleriyle kullanılan düzenler, şablonlar ve partUar yalnızca çadşLr. 


Bir Pages/_Viewlmports. cshtml dosyası ekleyin: 










Şnamespace RazorPagesContacts. Pages 

ŞaddTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 

ıŞnamespace öğreticide daha sonra açıklanmaktadır. ŞaddTagHelper yönergesi, yerleşik etiket 
yardımcılarını Sayfalar klasöründeki tüm sayfalara getirir. 

Bir sayfada şnamespace yönerge kümesi: 

@page 

Şnamespace RazorPagesIntro.Pages.Customers 

Şmodel NameSpaceModel 

<h2>Name space</h2> 

<P> 

ŞModel.Message 

</p> 

Şnamespace yönergesi sayfanın ad alanını ayarlar, şmodei yönergesinin ad alanını içermesi 
gerekmez. 

şnamespace yönergesi _ Vievvlmports. cshtm llçrıde yer aldığında, belirtilen ad alanı şnamespace 
yönergesini İçeri aktaran sayfada oluşturulan ad alanı için ön ek sağlar. Oluşturulan ad alanı (sonek 
bölümü) geri kalanı, _Viewlmports. cshtml içeren klasör ve sayfayı içeren klasör arasındaki noktayla 
ayrılmış göreli yoldur. 

Örneğin, PageModei Class Pages/Customers/Edit. cshtml. cs , ad alanını açıkça ayarlar: 

namespace RazorPagesContacts.Pages 
{ 

public class EditModel : PageModei 
{ 

private readonly AppDbContext _db; 

public EditModel(AppDbContext db) 

{ 

_db = db; 

} 

// Code removed for brevity. 

Pages/_Viewlmports. cshtml dosyası aşağıdaki ad alanını ayarlar: 

Şnamespace RazorPagesContacts.Pages 

ŞaddTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 

Pages/Customers/Edit. cshtml Razor sayfasının oluşturulan ad alanı PageModei sınıfıyla aynıdır, 
şnamespace Ayrıca geleneksel Razor görünümleriyle birlikte kullanılabilir. 

Pages/Create. cshtml görünüm dosyasını göz önünde bulundurun: 















@page 

@model RazorPagesContacts.Pages.Customers.CreateModel 
(ŞaddTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 

<p>Validation: customer name:</p> 

<form method="post"> 

<div asp-validation-summary="ModelOnly"x/div> 

<span asp-validation-for="Customer. Name "x/span> 

Name: 

cinput asp-for="Customer.Name" /> 
cinput type="submit" /> 

</form> 

<script src="~/lib/jquery/dist/jquery. js"x/script> 

<script src="~/lib/jquery-validation/dist/jquery. validate. js"x/script> 

<script src="~/lib/jquery-validation-unobtrusive/jquery.validate.unobtrusive.js"x/script> 


Güncelleştirilmiş sayfalar/oluşturma, cshtml görünüm dosyası _ Viewlmports. cshtml ve önceki düzen 
dosyası: 

@page 

@model CreateModel 

<p>Enter a customer name:</p> 

<form method="post"> 

Name: 

cinput asp-for="Customer.Name" /> 
cinput type="submit" /> 
c/form> 


Yukarıdaki kodda _Viewlmports. cshtml ad alanı ve etiket yardımcıları içeri aktardı. Düzen dosyası 
JavaScript dosyalarını içeri aktardı. 

Razor Pages Starter projesi , istemci tarafı doğrulamayı bağlayan sayfalcm/_ValidcıtionScriptsPcırtial. 
cshtml'y i içerir. 

Kısmi görünümler hakkında daha fazla bilgi için bkz. ASP.NET Core kısmi görünümler. 

Sayfalar için URL oluşturma 

Daha önce gösterilen create sayfası RedirectToPage kullanır: 








public class CreateModel : PageModel 

{ 

private readonly CustomerDbContext _context; 

public CreateModel(CustomerDbContext context) 

{ 

_context = context; 

} 

public IActionResult OnGet() 

{ 

return Page(); 

} 

[BindProperty] 

public Customer Customer { get; set; } 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

retunn Page(); 

} 

_context.Customers.Add(Customer); 
await _context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 

} 

Uygulama aşağıdaki dosya/klasör yapısına sahiptir: 

• /Pages 

o lndex.cshtml 

o Gizlilik, cshtml 

o /Customers 

o . Cshtml oluştur 
o Edit.cshtml 
o lndex.cshtml 

Pages/Customers/Create. cshtml ve Pages/Customers/Edit. cshtml sayfaları, başarılı olduktan sonra 
sayfaları/müşterileri/lndex. cshtml 'ye yeniden yönlendirir. Dize ./index , önceki sayfaya erişmek için 
kullanılan göreli bir sayfa adıdır. Pages/Customers/lndex. cshtml sayfasının URL 'leri oluşturmak için 
kullanılır. Örneğin: 

• Url.Page("./Index ", ...) 

• <a asp-page="./Index">Customers Index Page</a> 

• RedirectToPage("./Index") 

/index mutlak sayfa adı, Sayfalar/lndex. cshtml sayfasına URL 'ler oluşturmak için kullanılır. 
Örneğin: 

• Url.Page("/Irıdex", ...) 

• <a asp-page="/Index">Home Index Page</a> 

• RedirectToPage("/Index") 





Sayfa adı, kök /Pages klasöründeki, önde gelen / (örneğin, /index ) içeren sayfanın yoludur.Önceki 
URL oluşturma örnekleri, bir URL 'Yİ sabit kodlamadan gelişmiş seçenekler ve işlevsel yetenekler 
sunar. URL oluşturma yönlendirme kullanır ve yolun hedef yolda nasıl tanımlandığınıza göre 
parametreleri oluşturabilir ve kodlayabilir. 

Sayfalar için URL oluşturma göreli adları destekler.Aşağıdaki tabloda, sayfalarda/müşteriier/Create. 
cshtml'de farklı RedirectToPage parametreleri kullanılarak hangi dizin sayfasının seçildiği 
gösterilmektedir. 


REDİRECTTOPAGE (X) 

SAYFA 

RedirectToPage ("/lndex") 

Sayfa/dizin 

RedirectToPage (",/lndex"); 

Sayfa la r/müşteriler/Dizin 

RedirectToPage (".. /index ") 

Sayfa/dizin 

RedirectToPage ("Dizin") 

Sayfa la r/müşteriler/Dizin 

RedirectToPage("Index") , RedirectToPage(" 

./Index") ve RedirectToPage(" ../Index") göreli adlardır. 

RedirectToPage parametresi, hedef sayfanı 

n adını hesaplamak için geçerli sayfanın yoluyla birleştirilir 


Karmaşık bir yapıya sahip siteler oluştururken göreli ad bağlama yararlı olur. Bir klasördeki sayfalar 
arasında bağlantı için göreli adlar kullanıldığında: 

• Bir klasörü yeniden adlandırmak, göreli bağlantıları bozmaz. 

• Klasör adını içermediği için bağlantılar kopuk değildir. 

Farklı bir alandakibir sayfaya yeniden yönlendirmek için alanını belirtin: 

RedirectToPage("/Index ", new { area = "Services" }); 

Daha fazla bilgi için bkz. AS P.N ET Core bölgeler ve AS P.N ET Core Razor Pages yol ve uygulama 
kuralları. 

VievvData özniteliği 

Veriler, VievvDataAttributebir sayfaya geçirilebilir. [viewData] özniteliğiyle birlikte bulunan özellikler, 
VievvDataDictionarydeğerlerinin depolandığı ve yüklendiği değerlerdir. 

Aşağıdaki örnekte AboutModei , Title özelliğine [viewData] özniteliğini uygular: 

public class AboutModei : PageModel 

{ 

[ViewData] 

public string Title { get; } = "About"; 

public void OnGet() 

{ 

} 

} 


Hakkında sayfasında, Title özelliğine model özelliği olarak erişin: 










<hl>@Model.Title</hl> 


Mizanpajda, başlık VievvData sözlüğünden okundu: 

<!DOCTYPE html> 

<html lang="en"> 

<head> 

<title>@ViewData["Title"] - WebApplication</title> 


TempData 

AS P.N ET Core TempDatakullanıma sunar. Bu özellik, okunana kadar verileri depolar. Keep ve Peek 
yöntemleri silinmeden verileri incelemek için kullanılabilir. TempData , bir tek istekten daha fazla veri 
gerektiğinde yeniden yönlendirme için kullanışlıdır. 

Aşağıdaki kod, TempData kullanarak Message değerini ayarlar: 

public class CreateDotModel : PageModel 

{ 

private readonly AppDbContext _db; 

public CreateDotModel(AppDbContext db) 

{ 

_db = db; 

} 

[TempData] 

public string Message { get; set; } 

[BindProperty] 

public Customer Customer { get; set; } 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_db.Customers.Add(Customer); 
await _db.SaveChangesAsync(); 

Message = î"Customer {Customer.Name} added"; 
return RedirectToPage("./Index"); 

} 

} 

Pages/Customers/lndex. cshtml dosyasında aşağıdaki biçimlendirme TempData kullanarak Message 
değerini görüntüler. 

<h3>Msg: @Model.Message</h3> 

Pages/Customers/lndex. cshtml. cs sayfa modeli, [TempData] özniteliğini Message özelliğine uygular. 

[TempData] 

public string Message { get; set; } 














Daha fazla bilgi için bkz. TempData. 


Sayfa başına birden çok işleyici 

Aşağıdaki sayfa asp-page-handler etiketi Yardımcısını kullanarak iki işleyici için biçimlendirme 
oluşturur: 

@page 

@model CreateFATHModel 

<html> 

<body> 

<P> 

Enter your name. 

</p> 

<div asp-validation-summary="All"x/div> 

<form method="POST"> 

<div>Name: <input asp-for="Customer.Name" /></div> 

•cinput type="submit" asp-page-handler="]oinList" value="Doin" /> 

•cinput type="submit" asp-page-handler="]oinListUC" value="30IN UC" /> 

</form> 

</body> 

</html> 

Yukarıdaki örnekteki formda, her biri farklı bir URL 'ye göndermek için FormActionTagHelper 
kullanan iki gönderme düğmesi vardır, asp-page-handler özniteliği asp-page bir yardımcı olur, 
asp-page-handler , bir sayfa tarafından tanımlanan her bir işleyici yöntemini gönderen URL 'Ler 
oluşturur, örnek geçerli sayfaya bağlandığından asp-page belirtilmedi. 


Sayfa modeli: 








using System.Threading.Tasks; 
using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using RazorPagesContacts.Data; 

namespace RazorPagesContacts.Pages.Customers 

{ 

public class CreateFATHModel : PageModel 

{ 

private readonly AppDbContext _db; 

public CreateFATHModel(AppDbContext db) 

{ 

_db = db; 

} 

[BindProperty] 

public Customer Customer { get; set; } 

public async Task<IActionResult> OnPostloinListAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_db.Customers.Add(Customer); 
await _db.SaveChangesAsync(); 
return RedirectToPage("/Index"); 

} 

public async Task<IActionResult> OnPostloinListUCAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

Customer.Name = Customer.Name?.Tollpper(); 
return await OnPostloinListAsync(); 

} 

} 

} 


Yukarıdaki kod, adlandLrdmLş işleyici yöntemlerinikullarur. Adlandırılmış işleyici yöntemleri, 
0n<HTTP verb> sonra ve Async önce (varsa), ad içindeki metin alınarak oluşturulur. Yukarıdaki 
örnekte, Page metotları OnPostJoinlistAsync ve onpostJoinlıstucAsync ' dir. Onpost İle zaman 
uyumsuz olarak kaldırıldığında, işleyici adları loimist ve loimistuc . 


cinput type="submit" asp-page-handler="loinList" value="Ioin" /> 
<input type="submit" asp-page-handler="IoinListUC" value="10IN UC" /> 


Yukarıdaki kodu kullanarak, 

OnPostloinListAsync 

' a gönderen URL yolu 

https://localhost:5001/Customers/CreateFATH?handler=loinList . 

OnPostloinListUCAsync 

URL yolu 

https://localhost 

:5001/Customers/CreateFATHPhandler; 

OoinListUC . 


a gönderen 


Özel yollar 

@page yönergesini kullanarak şunları yapın: 

• Sayfaya özel bir yol belirtin. Örneğin, hakkında sayfasına olan yol 
@page "/some/other/Path"'' /some/other/Path olarak ayarlanabilir. 












• Kesimleri bir sayfanın varsayılan yoluna ekleyin. Örneğin, bir "öğe" segmenti sayfanın varsayılan 
yoluna @page "item" eklenebilir. 

• Bir sayfanın varsayılan yoluna parametreleri ekleyin. Örneğin, @page "{id}" bir sayfa için id bir 
İD parametresi gerekebilir. 

Yolun başındaki bir filde ( ~ ) tarafından atanan kök göreli bir yol desteklenir.Örneğin, 

@page "~/Some/Other/Path" @page "/Some/Other/Path" aynidir. 

Yol şablonu @page "{handler?}" belirterek /DoinList URL 'sindeki ?handler=]oinList sorgu dizesini 
bir rota kesimine değiştirebilirsiniz. 

Sorgu dizesini URL 'de ?handier=3oinList beğenmezseniz, işleyicinin yol bölümüne işleyici adını 
koymak için yolu değiştirebilirsiniz. Yolu, @page yönergesinden sonra çift tırnak içine alınmış bir rota 
şablonu ekleyerek özelleştirebilirsiniz. 

@page "{handler?}" 

@model CreateRouteModel 

<html> 

<body> 

<p> 

Enter your name. 

</p> 

<div asp-validation-summary="All"x/dlv> 

<form method="POST"> 

<div>Name: <input asp-for="Customer.Name" /></div> 

<input type="submit" asp-page-handler="]oinl_ist" value="Doin" /> 
cinput type="submit" asp-page-handler="Doinl_istUC" value="10IN UC" /> 

</form> 

</body> 

</html> 

Yukarıdaki kodu kullanarak, onPostioinListAsync ' a gönderen URL yolu 
https : //localhost : 5001/Customers/CreateFATH/loinList . OnPostloinListUCAsync a gönderen U RL 
yolu https://localhost : 5001/Customers/CreateFATH/DoinListUC . 

Aşağıdaki handler ? yol parametresinin isteğe bağlı olduğu anlamına gelir. 

Gelişmiş yapılandırma ve ayarlar 

Aşağıdaki bölümlerdeki yapılandırma ve ayarlar çoğu uygulama için gerekli değildir. 

Gelişmiş seçenekleri yapılandırmak için AddRazorPagesOptionsgenişletme yöntemini kullanın: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRazorPages() 

.AddRazorPagesOptions(options => 

{ 

options.RootDirectory = "/MyPages"; 

options.Conventions.AuthorizeFolder("/MyPages/Admin"); 

}); 

} 


Sayfaların kök dizinini ayarlamak için RazorPagesOptions kullanın veya sayfalar için uygulama 
modeli kuralları ekleyin. Kurallar hakkında daha fazla bilgi için bkz. Razor Pages yetkilendirme 
kuralları. 


Görünümleri önceden derlemek için bkz. Razor görünüm derlemesi. 
















Razor Pages içerik kökünde olduğunu belirtin 

Varsayılan olarak, Razor Pages /Pages dizininde kök olarak depolanır. Razor Pages uygulamanın 
(ContentRootPath) içerik kökünde olduğunu belirtmek için VVİthRazorPagesAtContentRoot ekleyin: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRazorPages() 

.AddRazorPagesOptions(options => 

{ 

options.Conventions.AuthorizeFolder("/MyPages/Admin"); 

}) 

.WithRazorPagesAtContentRoot(); 


Razor Pages özel kök dizinde olduğunu belirtin 

Razor Pages uygulamada bir özel kök dizinde olduğunu belirtmek için VVİthRazorPagesRoot ekleyin 
(göreli bir yol sağlayın): 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRazorPages() 

.AddRazorPagesOptions(options => 

{ 

options.Conventions.AuthorizeFolder("/MyPages/Admin"); 

}) 

.WithRazorPagesRoot("/path/to/razor/pages"); 


Ek kaynaklar 

• Bkz. Razor Pages kullanmaya başlama, bu giriş hakkında derleme 

• Örnek kodu indirme veya görüntüleme 

• ASP.NET Core'a Giriş 

• AS P.N ET Core Razor söz dizimi başvurusu 

• ASP.NET Core bölgeler 

• Öğretici: ASP.NET Core Razor Pages ile çalışmaya başlama 

• ASP.NET Core Razor Pages yetkilendirme kuralları 

• ASP.NET Core Razor Pages yol ve uygulama kuralları 

• ASP.NET Core birim testlerini Razor Pages 

• ASP.NET Core kısmi görünümler 

By Rick Anderson ve Ryan şimdi ak 

Razor Pages, kod odaklı senaryoları daha kolay ve daha üretken hale getiren AS P.N ET Core M VC 
'nin yeni bir yönüdür. 

Model-View-Controller yaklaşımını kullanan bir öğretici arıyorsanız, bkz. ASP.NET Core MVC ile 
çalışmaya başlama. 

Bu belge Razor Pages bir giriş sağlar. Adım adım öğretici değildir. Bölümlerden bazılarını çok 
gelişmiş bir şekilde bulursanız, bkz. Razor Pages kullanmaya başlama. ASP.NET Core genel bir bakış 
için bkz. ASP.NET Core giriş. 


Prerequisites 





• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Visual Studio 2019 ile ASP.N ET ve web geliştirme iş yükü 

• .NET core SDK 2.2 veya üzeri 


VVARNING 

Visual Studio 2017 kullanıyorsanız bkz dotnet/SDK'sı sorun #3124 Visual Studio ile çalışmayan .NET Core SDK 
sürümleri hakkında bilgi için. 


Razor Pages projesi oluşturma 

• Visual Studio 

• Mac için Visual Studio 

• Visual Studio Code 

Razor Pages projesi oluşturma hakkında ayrıntılı yönergeler için bkz. Razor Pages kullanmaya 
başlama . 

Razor Pages 

Razor Pages, Startup.cs'de etkinleştirilmiştir: 

public class Startup 
{ 

public void ConfigureServices(IServiceCollection Services) 

{ 

// Includes support for Razor Pages and controllers. 

Services .AddMvc(); 

} 

public void Configure(IApplicationBuilder app) 

{ 

app.UseMvc(); 

} 

} 

Temel bir sayfa düşünün: 

@page 

<hl>Hello, world!</hl> 

<h2>The time on the server is @DateTime.Now</h2> 

Yukarıdaki kod, denetleyiciler ve görünümlerle ASP.NET Core bir uygulamada kullanılan Razor 
görünüm dosyası gibi bir çok şey arar. Bu, farklı kılan @page yönergedir. @page , dosyayı bir 
denetleyiciye geçmeden doğrudan istekleri işlediği anlamına gelen bir MVC eylemine sahip olur. 
@page sayfadaki ilk Razor yönergesi olmalıdır. @page diğer Razor yapıları davranışını etkiler. 

PageModei sınıfı kullanan benzer bir sayfa aşağıdaki iki dosyada gösterilmiştir. Pages/lndex2. cshtml 
dosyası: 













@page 

@using RazorPagesIntro.Pages 
@model IndexModel2 

<h2>Separate page model</h2> 

<p> 

@Model.Message 

</p> 

Pages/lndex2. cshtml. cs sayfa modeli: 

using Microsoft.AspNetCore.Mvc.RazorPages; 
using System; 

namespace RazorPagesIntro.Pages 
{ 

public class IndexModel2 : PageModel 
{ 

public string Message { get; private set; } = "PageModel in C#"; 

public void OnGet() 

{ 

Message += $" Server time is { DateTime.Now }"; 

} 

} 

} 

Kurala göre PageModel sınıf dosyası,. cs eklenmiş Razor sayfası dosyasıyla aynı ada sahiptir.Örneğin, 
önceki Razor sayfası Pages/lndex2. cshtml' dir. PageModel sınıfını içeren dosya sayfa/lndex2. cshtml. 
csolarak adlandırılır. 

URL yollarının sayfalara olan ilişkilendirmeleri, sayfanın dosya sistemindeki konumuna göre 
belirlenir. Aşağıdaki tabloda bir Razor sayfa yolu ve eşleşen URL gösterilmektedir: 

DOSYA ADI VE YOLU EŞLEŞEN URL 

/Pages/lndex.cshtml / veya /index 

/Pages/Contact.exe /Contact 

/Pages/Store/Contact.exe /store/contact 

/Pages/Store/lndex.cshtml /store veya /store/index 


Notlar: 

• Çalışma zamanı, Sayfalar klasöründeki Razor Pages dosyaları varsayılan olarak arar. 

• index , URL bir sayfa içermiyorsa varsayılan sayfasıdır. 

Temel form yazma 

Razor Pages, Web tarayıcıları ile kullanılan ortak desenleri bir uygulama oluştururken kolayca 
uygulanması için tasarlanmıştır. Model bağlama, ETİKET yardımcılarıve HTML Yardımcıları hepsi, 
Razor sayfası sınıfında tanımlanan özelliklerle çalışır . Contact modeli için temel bir "bize başvurun" 
formu uygulayan bir sayfa düşünün: 

Bu belgedeki örnekler için DbContext , Startup.es dosyasında başlatılır. 















using Microsoft.AspNetCore.Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.EntityFrameworkCore; 

using Microsoft. Extensions.Dependencylnjection; 

using RazorPagesContacts.Data; 

namespace RazorPagesContacts 

{ 

public class Startup 

{ 

public IHostingEnvironment HostingEnvironment { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<AppDbContext>(options => 

options.UseInMemoryDatabase("name")) 

Services .AddMvc(); 

} 

public void Configure(IApplicationBuilder app) 

{ 

app.UseMvc(); 

} 

} 

} 

Veri modeli: 


using System.ComponentModel.DataAnnotations; 

namespace RazorPagesContacts.Data 

{ 

public class Customer 

{ 

public int Id { get; set; } 

[Requiredj StringLength(100)] 
public string Name { get; set; } 

} 

} 


DB bağlamı: 

using Microsoft.EntityFrameworkCore; 

namespace RazorPagesContacts.Data 

{ 

public class AppDbContext : DbContext 

{ 

public AppDbContext(DbContextOptions options) 

: base(options) 

{ 

} 

public DbSet<Customer> Customers { get; set; } 

} 

} 


Pages/Create. cshtml görünüm dosyası: 






@page 

@model RazorPagesContacts.Pages.CreateModel 
(ŞaddTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 

<html> 

<body> 

<P> 

Enter your name. 

</p> 

<div asp-validation-summary="All"x/div> 

<form method="POST"> 

<div>Name: <input asp-for="Customer.Name" /></div> 
<input type="submit" /> 

</form> 

</body> 

</html> 


Pages/Create. cshtmi cs sayfa modeli: 

using System.Threading.Tasks; 
using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using RazorPagesContacts.Data; 

namespace RazorPagesContacts.Pages 

{ 

public class CreateModel : PageModel 

{ 

private readonly AppDbContext _db; 

public CreateModel(AppDbContext db) 

{ 

_db = db; 

} 

[BindProperty] 

public Customer Customer { get; set; } 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_db.Customers.Add(Customer); 
await _db.SaveChangesAsync(); 
return RedirectToPage("/Index"); 

} 

} 

} 

Kurala göre PageModel sınıfı <PageName>Modei olarak adlandırılır ve sayfayla aynı ad alanında yer 
alan. 

PageModel sınıfı, bir sayfa mantığının sunumundaki ayırmayı sağlar. Sayfaya gönderilen istekler için 
sayfa işleyicilerini ve sayfayı işlemek için kullanılan verileri tanımlar. Bu ayrım şunları sağlar: 

• Bağımlılık eklemeyoluyla sayfa bağımlılıklarını yönetme. 

• Sayfaların birim testi . 

Sayfada, post isteklerinde çalışan bir onPostAsync işleyicisi yöntem iv ardır (bir Kullanıcı formu 
gönderdiğinde). Herhangi bir HTTP fiili için işleyici yöntemleri ekleyebilirsiniz. En yaygın işleyiciler 









şunlardır: 


• Sayfanın başlatılması için gereken durum onGet . OnGet örneği. 

• form gönderilerini işlemek için onPost . 

Async adlandırma son eki isteğe bağlıdır, ancak genellikle zaman uyumsuz işlevler için kural 
tarafından kullanılır. Yukarıdaki kod Razor Pages için tipik bir davranıştır. 

Denetleyicileri ve görünümleri kullanarak ASP.NET uygulamaları hakkında bilginiz varsa: 

• Yukarıdaki örnekteki onPostAsync kodu, tipik denetleyici koduna benzer şekilde görünür. 

• Model bağlama, doğrulama, doğrulamave eylem sonuçları gibi mvc temel elemanlarının çoğu 
paylaşılır. 

Önceki OnPostAsync yöntemi: 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

retunn Page(); 

} 

_db.Customers.Add(Customer); 
await _db.SaveChangesAsync(); 
retunn RedirectToPage("/Index"); 

} 

OnPostAsync temel akışı: 

Doğrulama hatalarını kontrol edin. 

• Hata yoksa, verileri kaydedin ve yeniden yönlendirin. 

• Hatalar varsa, doğrulama iletileriyle sayfayı yeniden görüntüleyin, istemci tarafı doğrulaması 
geleneksel ASP.NET Core MVC uygulamalarıyla aynıdır. Çoğu durumda, doğrulama hataları 
istemci üzerinde algılanır ve sunucuya hiçbir zaman gönderilmez. 

Veriler başarıyla girildiğinde, OnPostAsync Handler yöntemi bir RedirectToPageResuit örneğini 
döndürmek için RedirectToPage yardımcı yöntemini çağırır. RedirectToPage , RedirectToAction veya 
RedirectToRoute benzer ancak sayfalar için özelleştirilen yeni bir eylem sonucudur. Önceki örnekte, 
kök dizin sayfasına ( /index ) yeniden yönlendirir. RedirectToPage , Sayfalar İçin URL oluşturma 
bölümünde ayrıntılı olarak açıklanmıştır. 

Gönderilen formda doğrulama hataları olduğunda (sunucuya geçirilen) OnPostAsync işleyicisi 
yöntemi Page yardımcı yöntemini çağırır. Page , bir PageResuit örneği döndürür. Page döndürmek, 
denetleyicilerde eylemlerin view nasıl dönüşlerine benzer. PageResuit , bir işleyici yöntemi için 
varsayılan dönüş türüdür, void döndüren bir işleyici yöntemi sayfayı işler. 

customer özelliği, model bağlamasını kabul etmek için [BindProperty] özniteliğini kullanır. 























public class CreateModel : PageModel 

{ 

private readonly AppDbContext _db; 

public CreateModel(AppDbContext db) 

{ 

_db = db; 

} 

[BindProperty] 

public Customer Customer { get; set; } 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_db.Customers.Add(Customer); 
await _db.SaveChangesAsync(); 
return RedirectToPage("/Index"); 

} 

} 

Razor Pages, varsayılan olarak, özellikleri yalnızca get olmayan fiiller ile bağlayın. Özelliklere 
bağlamak, yazmanız gereken kod miktarını azaltabilir. Bağlama, form alanlarını işlemek için aynı 
özelliği kullanarak kodu azaltır ( cinput asp-for="Customer.Name"> ) ve girişi kabul eder. 


VVARNING 

Güvenlik nedenleriyle, get istek verilerini sayfa modeli özelliklerine bağlamayı tercih etmeniz gerekir. 
Özelliklerle eşleştirmadan önce Kullanıcı girişini doğrulayın, get bağlamaya dönüştürmek, sorgu dizesine 
veya rota değerlerine dayanan senaryoları adreslemekte yararlıdır. 

get isteklerindeki bir özelliği bağlamak için, [BindProperty] özniteliğinin supportsGet özelliğini true 
olarak ayarlayın: 

[BindProperty(SupportsGet = true)] 

Daha fazla bilgi için bkz. ASP.NET Core topluluk alışması: Get tartışmasına bağlama (YouTube). 


Giriş sayfası ( lndex. cshtml): 







@page 

@model RazorPagesContacts.Pages.IndexModel 
(ŞaddTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 

<hl>Contacts</hl> 

<form method="post"> 

<table class="table"> 

<thead> 

<tr> 

<th>ID</th> 

<th>Name</th> 

</tr> 

</thead> 

<tbody> 

@foreach (var contact in Model.Customers) 

{ 

<tr> 

<td>@contact.Id</td> 

<td>@contact.Name</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@contact.Id">edit</a> 
<button type="submit" asp-page-handler="delete" 

asp-route-id="@contact.Id">delete</button> 

</td> 

</tr> 

} 

</tbody> 

</table> 

<a asp-page="./Create">Create</a> 

</form> 


ilişkili PageModei sınıfı ( lndex.cshtml.csY 




using System.Threading.Tasks; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using RazorPagesContacts.Data; 

using System.Collections.Generic; 

using Microsoft.EntityFrameworkCore; 

namespace RazorPagesContacts.Pages 

{ 

public class IndexModel : PageModel 

{ 

private readonly AppDbContext _db; 

public IndexModel(AppDbContext db) 

{ 

_db = db; 

} 

public IList<Customer> Customers { get; private set; } 

public async Task OnGetAsync() 

{ 

Customers = await _db.Customers.AsNoTracking().ToListAsync(); 

} 

public async Task<IActionResult> OnPostDeleteAsync(int id) 

{ 

var contact = await _db.Customers.FindAsync(id); 

if (contact != null) 

{ 

_db.Customers.Remove(contact); 
await _db.SaveChangesAsync(); 

} 

return RedirectToPage(); 

} 

} 

} 

lndex. cshtml dosyası her kişi için bir düzenleme bağlantısı oluşturmak üzere aşağıdaki 
biçimlendirmeyi içerir: 

<a asp-page="./Edit" asp-route-id="@contact.Id">edit</a> 

<a asp-page="./Edit" asp-route-id="@contact.id">Edit</a> tutturucu etiketi Yardımcısı , düzenleme 
sayfasına bir bağlantı oluşturmak için asp-route-{vaiue} özniteliğini kullandı. Bağlantı, iletişim 
KİMLİĞİNE sahip rota verileri içerir. Örneğin: https://iocaihost: 500 i/Edit/ı . Etiket Yardımcıları, 
Razor dosyalarında HTML öğelerinin oluşturulmasına ve işlenmesine sunucu tarafı kodun 
katılmasını etkinleştir. Etiket Yardımcıları @addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 
tarafından etkinleştirilir 


Pages/Edlt. cshtml dosyası: 






@page "{id:int}" 

@model RazorPagesContacts.Pages.EditModel 
@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 

@{ 

ViewData["Title"] = "Edit Customer"; 

} 

<hl>Edit Customer - @Model.Customer.Id</hl> 

<form method="post"> 

<div asp-validation-summary="All"x/div> 

<input asp-for="Customer.Id" type="hidden" /> 

<div> 

<label a sp-for="Customer .Name" x/label> 

<div> 

<input asp-for="Customer.Name" /> 

<span asp-validation-for="Customer.Name" ></span> 

</div> 

</div> 

<div> 

<button type="submit">Save</button> 

</div> 

</form> 

ilk satır @page "{id:int}" yönergesini içerir. Yönlendirme kısıtlaması "{id:int}" , sayfaya istekleri 
int yönlendirme verileri içeren sayfaya kabul etmesini söyler. Sayfaya yapılan bir istek bir int 
dönüştürülebildiği rota verileri içermiyorsa, çalışma zamanı bir HTTP 404 (bulunamadı) hatası 
döndürür. KİMLİĞİ isteğe bağlı yapmak için ? yol kısıtlamasına ekleyin: 

@page "{id:int?}" 


Pages/Edit. cshtml. cs dosyası: 









using System; 

using System.Threading.Tasks; 
using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.EntityFrameworkCore; 
using RazorPagesContacts.Data; 

namespace RazorPagesContacts.Pages 

{ 

public class EditModel : PageModel 

{ 

private readonly AppDbContext _db; 

public EditModel(AppDbContext db) 

{ 

_db = db; 

} 


[BindProperty] 

public Customer Customer { get; set; } 

public async Task<IActionResult> OnGetAsync(int id) 

{ 

Customer = await _db.Customers.FindAsync(id); 

if (Customer == null) 

{ 

return RedirectToPage("/Index"); 

} 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 


_db.Attach(Customer).State = EntityState.Modified; 

try 

{ 


await _db.SaveChangesAsync(); 

} 

catch (DbUpdateConcurrencyException) 

{ 

throw new Exception($"Customer {Customer.Id} not found!"); 

} 


} 


} 


} 


return RedirectToPage("/Index"); 


lndex. cshtml dosyası, her müşteri kişisi için bir silme düğmesi oluşturmak için de biçimlendirme 
içerir: 

cbutton type="submit" asp-page-handler="delete" 

asp-route-id="@contact.Id">delete</button> 


Sil düğmesi HTML 'de işlendiğinde, formaction şunlar için parametreler içerir: 






• asp-route-id özniteliği tarafından belirtilen müşteri iletişim KİMLİĞİ. 

• asp-page-handler Özniteliği tarafından belirtilen handler . 

Müşteri irtibat KİMLİĞİ ı olan işlenmiş silme düğmesine bir örnek aşağıda verilmiştir: 

<button type="submit" formaction="/?id=l&ampj handler=delete">delete</button> 

Düğme seçildiğinde, sunucuya bir form post isteği gönderilir. Kurala göre, işleyici yönteminin adı, 
düzen 0nPost[handier]Async göre handler parametresinin değerine göre seçilir. 

Bu örnekte handler delete olduğundan, onPostoeleteAsync Handler yöntemi post isteğini 
işlemek için kullanılır, asp-page-handler , remove gibi farklı bir değere ayarlandıysa 
onPostRemoveAsync ada sahip bir işleyici yöntemi seçilidir. Aşağıdaki kod onPostDeleteAsync 
işleyicisini gösterir: 

public async Task<IActionResult> OnPostDeleteAsync(int id) 

{ 

var contact = await _db.Customers.FindAsync(id); 

if (contact != null) 

{ 

_db.Customers.Remove(contact); 
await _db.SaveChangesAsync(); 

} 

return RedirectToPage(); 

} 

OnPostDeleteAsync Yöntemi: 

• Sorgu dizesinden id kabul eder. Index. cshtml sayfa yönergesi yönlendirme kısıtlaması 

"{id:int?}" içeriyorsa, id rota verilerinden gelir, id için rota verileri, URI 'de 
https://localhost: 5001/Customers/2 gibi belirtilir. 

• FindAsync ile müşteri iletişim için veritabanını sorgular. 

• Müşteri ilgili kişisi bulunursa, bunlar müşteri kişileri listesinden kaldırılır.Veritabanı 
güncelleştirildi. 

• Kök dizin sayfasına yeniden yönlendirmek için RedirectToPage çağırır ( /index ). 

Sayfa özelliklerini gerektiği gibi işaretle 

PageModei Özellikler gerekli öznitelikle işaretlenebilir: 


















using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using System.ComponentModel.DataAnnotations; 

namespace RazorPagesMovie.Pages.Movies 

{ 

public class CreateModel : PageModel 

{ 

public IActionResult OnGet() 

{ 

return Page(); 

} 

[BindProperty] 

[Required(ErrorMessage = "Color is required")] 
public string Color { get; set; } 

public IActionResult OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

// Process color. 

return RedirectToPage("./Index"); 

} 

} 

} 


Daha fazla bilgi için bkz. model doğrulaması. 

OnGet işleyicisi geri dönüşü ile tanıtıcı HEAD istekleri 

head istekleri belirli bir kaynak için üst bilgileri almanızı sağlar, get isteklerinin aksine head 
istekleri bir yanıt gövdesi döndürmez. 

Normalde, head istekleri için onHead işleyicisi oluşturulur ve çağırılır: 

public void OnHead() 

{ 

HttpContext.Response.Headers.Add("HandledBy", "Handled by OnHead!"); 

} 

ASP.NET Core 2,1 veya sonraki sürümlerde Razor Pages, OnHead işleyici tanımlanmadığında OnGet 
işleyicisini çağırmaya geri döner. Bu davranış, startup.configureServices Setcompatibilityversion 
çağrısıyla etkinleştirilir: 

Services .AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_l); 

Varsayılan Şablonlar, ASP.NET Core 2,1 ve 2,2 ' de Setcompatibilityversion çağrısını üretir. 
Setcompatibilityversion AllowMappingHeadRequestsToGetHandler Razor Pages seçeneğini true için 
etkin şekilde ayarlar. 

Setcompatibilityversion tüm davranışlardan çıkmak yerine, açıkça belirli davranışları kabul 
edebilirsiniz. Aşağıdaki kod, head isteklerinin OnGet işleyicisine eşlenmesine izin vermek için 1 de 
kullanılır: 


















Services .AddMvc() 

.AddRazorPagesOptions(options => 

{ 

options.AllowMappingHeadRequestsToGetHandler = true; 
})J 


XSRF/CSRF ve Razor Pages 

Antiforgery doğrulamasıiçin herhangi bir kod yazmanız gerekmez. Antiforgery belirteci oluşturma ve 
doğrulama, Razor Pages otomatik olarak eklenir. 

Razor Pages ile düzenleri, partileri, şablonları ve etiket 
yardımcılarını kullanma 

Sayfalar, Razor görünüm altyapısının tüm özellikleri ile çalışır. Düzenler, partıals, şablonlar, etiket 
yardımcıları, _VıewStart. cshtml, _Viewlmports. cshtml geleneksel Razor görünümlerinde oldukları 
gibi çalışır. 

Bu özelliklerden bazılarının avantajlarından yararlanarak bu sayfayı declutter edelim. 
Sayfa/paylaşdan/_Layout. cshtml'ye bir Düzen sayfası ekleyin: 

<!DOCTYPE html> 

<html> 

<head> 

<title>Razor Pages Sample</title> 

</head> 

<body> 

<a asp-page="/Index">Home</a> 

@RenderBody() 

<a asp-page="/Cııstomers/Create">Create</a> <br /> 

</body> 

</html> 


Düzen: 

• Her sayfanın yerleşimini denetler (sayfa düzen dışında değilse). 

• JavaScript ve stil sayfaları gibi HTML yapılarını içeri aktarır. 

Daha fazla bilgi için bkz. Düzen sayfası . 

Layout özelliği Pages/_ViewStart. cshtml' de ayarlanır: 

Layout = "_Layout"; 

} 

Düzen Sayfalar/paylaşdarı klasöründedir. Sayfalar, geçerli sayfayla aynı klasörden başlayarak diğer 
görünümleri (düzenler, şablonlar, parals) hiyerarşik olarak arar. Sayfalar/paylaşdcm klasördeki bir 
düzen, Sayfalar klasörü altındaki herhangi bir Razor sayfasından kullanılabilir. 

Düzen dosyası Sayfalar/paylaşdan klasörüne gitmelidir. 

Düzen dosyasını Görünümler/paylaşdan klasöre yerleştirmenizi öneririz . Görünümler/paylaşdan 
bir MVC görünümleri modelidir. Razor Pages, yol kurallarını değil klasör hiyerarşisine güvenmektir. 

Bir Razor sayfasından arama görüntüleme, Sayfalar klasörünü içerir. MVC denetleyicileri ve 










geleneksel Razor görünümleriyle kullandığınız düzenler, şablonlar ve parals işlemleri yalnızca çalışır. 
Bir Pages/_Viewlmports. cshtml dosyası ekleyin: 

@namespace RazorPagesContacts.Pages 

(ŞaddTagHelpen *, Microsoft.AspNetCore.Mvc.TagHelpers 

@namespace öğreticide daha sonra açıklanmaktadır. @addTagHeiper yönergesi, yerleşik etiket 
yardımcılarını Sayfalar klasöründeki tüm sayfalara getirir. 

@namespace yönergesi açıkça bir sayfada kullanıldığında: 

@page 

@namespace RazorPagesIntro.Pages.Customers 

@model NameSpaceModel 

<h2>Name space</h2> 

<P> 

@Model.Message 

</p> 

Yönergesi sayfanın ad alanını ayarlar. @modei yönergesinin ad alanını içermesi gerekmez. 

@namespace yönergesi _ Viewlmports. cshtm /içinde yer aldığında, belirtilen ad alanı @namespace 
yönergesini İçeri aktaran sayfada oluşturulan ad alanı için ön ek sağlar. Oluşturulan ad alanı (sonek 
bölümü) geri kalanı, _Viewlmports. cshtml içeren klasör ve sayfayı içeren klasör arasındaki noktayla 
ayrılmış göreli yoldur. 

Örneğin, PageModei Class Pages/Customers/Edit. cshtml. cs, ad alanını açıkça ayarlar: 

namespace RazorPagesContacts.Pages 
{ 

public class EditModel : PageModei 
{ 

private readonly AppDbContext _db; 

public EditModel(AppDbContext db) 

{ 

_db = db; 

} 

// Code removed for brevity. 

Pages/_Viewlmports. cshtml dosyası aşağıdaki ad alanını ayarlar: 

@namespace RazorPagesContacts.Pages 

@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 

Pages/Customers/Edit. cshtml Razor sayfasının oluşturulan ad alanı PageModei sınıfıyla aynıdır. 
@namespace Ayrıca geleneksel Razor görünümleriyle birlikte kullanılabilir. 

Özgün Sayfalar/Create. cshtml görünüm dosyası: 













@page 

@model RazorPagesContacts.Pages.CreateModel 
(ŞaddTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 

<html> 

<body> 

<P> 

Enter your name. 

</p> 

<div asp-validation-summary="All"x/div> 

<form method="POST"> 

<div>Name: <input asp-for="Customer.Name" /></div> 
<input type="submit" /> 

</form> 

</body> 

</html> 


Güncelleştirilmiş Sayfalar/Create. cshtml görünüm dosyası: 

@page 

@model CreateModel 

<html> 

<body> 

<p> 

Enter your name. 

</p> 

<div asp-validation-summary="All"x/div> 

<form method="POST"> 

<div>Name: <input asp-for="Customer.Name" /x/div> 
<input type="submit" /> 

</form> 

</body> 

</html> 


Razor Pages Starter projesi , istemci tarafı doğrulamayı bağlayan sayfalarL/_ValidatiorıScriptsPartial. 
cshtml'y i içerir. 

Kısmi görünümler hakkında daha fazla bilgi için bkz. ASP.NET Core kısmi görünümler. 

Sayfalar için URL oluşturma 

Daha önce gösterilen create sayfası RedirectToPage kullanır: 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_db.Customers.Add(Customer); 
await _db.SaveChangesAsync(); 
return RedirectToPage("/Index"); 

} 


Uygulama aşağıdaki dosya/klasör yapısına sahiptir: 
• /Pages 


o lndex.cshtml 








o /Customers 


o . Cshtml oluştur 
o Edit.cshtml 
o lndex.cshtml 

Pages/Customers/Create. cshtml ve Pages/Customers/Edit. cshtml sayfalan, başarılı olduktan sonra 
Pages/lrıdex. cshtml dosyasına yönlendirilir. /index dize, önceki sayfaya erişmek için URI 'nin bir 
parçasıdır. /index dize /lndex. cshtml sayfasına URI oluşturmak için kullanılır.Örneğin: 

• Url.Page("/Index", ...) 

• <a asp-page="/Index">My Index Page</a> 

• RedirectToPage("/Index") 

Sayfa adı, kök /Pages klasöründeki, önde gelen / (örneğin, /index ) içeren sayfanın yoludur.Önceki 
URL oluşturma örnekleri bir URL 'Yİ kodlamadan gelişmiş seçenekler ve işlevsel yetenekler sunar. 
URL oluşturma yönlendirme kullanır ve yolun hedef yolda nasıl tanımlandığınıza göre parametreleri 
oluşturabilir ve kodlayabilir. 

Sayfalar için URL oluşturma göreli adları destekler.Aşağıdaki tabloda, sayfa/müşteri/oluşturma, 
cshtml'den farklı RedirecttoPage parametrelerle hangi dizin sayfasının seçildiği gösterilmektedir: 


REDİRECTTOPAGE (X) 

SAYFA 

RedirectToPage ("/lndex") 

Sayfa/dizin 

RedirectToPage (",/lndex"); 

Sayfa la r/müşteriler/Dizin 

RedirectToPage (".. /index ") 

Sayfa/dizin 

RedirectToPage ("Dizin") 

Sayfa lar/müşteriler/Dizin 

RedirectToPage("Index") , RedirectToPage(" 

./Index") ve RedirectToPage(" ../Index") , göreli adlardır. 

RedirecttoPage parametresi, hedef sayfanı 

n adını hesaplamak için geçerli sayfanın yoluyla birleştirilir 


Karmaşık bir yapıya sahip siteler oluştururken göreli ad bağlama yararlı olur. Bir klasördeki sayfalar 
arasında bağlantı sağlamak için göreli adlar kullanırsanız, bu klasörü yeniden adlandırabilirsiniz. Tüm 
bağlantılar hala çalışır (klasör adını içermediği için). 

Farklı bir alandakibir sayfaya yeniden yönlendirmek için alanını belirtin: 

RedirectToPage("/Index ", new { area = "Services" }); 

Daha fazla bilgi için bkz. AS P.N ET Core bölgeler. 

VievvData özniteliği 

Veri, Vievvdataattributeiçeren bir sayfaya geçirilebilir. [viewData] özniteliği olan denetleyicilerde veya 
Razor sayfa modellerinde bulunan özelliklerin değerleri, VievvDataDictionary'den depolanır ve 
yüklenir. 

Aşağıdaki örnekte AboutModei , [viewData] ile işaretlenmiş bir Title özelliği içerir. Title özelliği, 
hakkında sayfasının başlığına ayarlanır: 










public class AboutModel : 

PageModel 

{ 


[ViewData] 


public string Title { 

get; } = "About"; 

public void OnGet() 


{ 


} 


} 



Hakkında sayfasında, Title özelliğine model özelliği olarak erişin: 


<hl>@Model.Title</hl> 


Mizanpajda, başlık VievvData sözlüğünden okundu: 

<!DOCTYPE html> 

<html lang="en"> 

<head> 

<title>@ViewData["Title"] - WebApplication</title> 


TempData 

AS P.N ET Core bir denetleyicide TempData özelliğini kullanıma sunar. Bu özellik, okunana kadar 
verileri depolar. Keep ve Peek yöntemleri silinmeden verileri incelemek için kullanılabilir. TempData, 
bir tek istekten daha fazla veri gerektiğinde yeniden yönlendirme için kullanışlıdır. 

Aşağıdaki kod, TempData kullanarak Message değerini ayarlar: 

public class CreateDotModel : PageModel 

{ 

private readonly AppDbContext _db; 

public CreateDotModel(AppDbContext db) 

{ 

_db = db; 

} 

[TempData] 

public string Message { get; set; } 

[BindProperty] 

public Customer Customer { get; set; } 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_db.Customers.Add(Customer); 
await _db.SaveChangesAsync(); 

Message = î"Customer {Customer.Name} added"; 
return RedirectToPage("./Index"); 

} 

} 












Pages/Customers/lndex. cshtml dosyasında aşağıdaki biçimlendirme TempData kullanarak Message 
değerini görüntüler. 

<h3>Msg: @Model.Message</h3> 

Pages/Customers/lndex. cshtml. cs sayfa modeli, [TempData] özniteliğini Message özelliğine uygular. 

[TempData] 

public string Message { get; setj } 


Daha fazla bilgi için bkz. TempData . 

Sayfa başına birden çok işleyici 

Aşağıdaki sayfa asp-page-handler etiketi Yardımcısını kullanarak iki işleyici için biçimlendirme 
oluşturur: 

@page 

@model CreateFATHModel 

<html> 

<body> 

<P> 

Enter your name. 

</p> 

<div asp-validation-summary="All"x/div> 

<form method="POST"> 

<div>Name: <input asp-for="Customer.Name" /></div> 

•cinput type="submit" asp-page-handler="3oinList" value="3oin" /> 

•cinput type="submit" asp-page-handler="3oinListUC" value="30IN UC" /> 

</form> 

</body> 

</html> 

Yukarıdaki örnekteki formda, her biri farklı bir URL 'y e göndermek için FormActionTagHelper 
kullanan iki gönderme düğmesi vardır, asp-page-handler özniteliği asp-page bir yardımcı olur, 
asp-page-handler , bir sayfa tarafından tanımlanan her bir işleyici yöntemini gönderen URL 'Ler 
oluşturur, örnek geçerli sayfaya bağlandığından asp-page belirtilmedi. 


Sayfa modeli: 














using System.Threading.Tasks; 
using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using RazorPagesContacts.Data; 

namespace RazorPagesContacts.Pages.Customers 

{ 

public class CreateFATHModel : PageModel 

{ 

private readonly AppDbContext _db; 

public CreateFATHModel(AppDbContext db) 

{ 

_db = db; 

} 

[BindProperty] 

public Customer Customer { get; set; } 

public async Task<IActionResult> OnPostloinListAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_db.Customers.Add(Customer); 
await _db.SaveChangesAsync(); 
return RedirectToPage("/Index"); 

} 

public async Task<IActionResult> OnPostloinListUCAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

Customer.Name = Customer.Name?.Tollpper(); 
return await OnPostloinListAsync(); 

} 

} 

} 


Yukarıdaki kod, adlandLrdmLş işleyici yöntemlerinikullarur. Adlandırılmış işleyici yöntemleri, 
0n<HTTP verb> sonra ve Async önce (varsa), ad içindeki metin alınarak oluşturulur. Yukarıdaki 
örnekte, Page metotları OnPostJoinlistAsync ve onpostJoinlıstucAsync ' dir. Onpost İle zaman 
uyumsuz olarak kaldırıldığında, işleyici adları loimist ve loimistuc . 


cinput type="submit" asp-page-handler="loinList" value="Ioin" /> 
<input type="submit" asp-page-handler="IoinListUC" value="10IN UC" /> 


Yukarıdaki kodu kullanarak, 

OnPostloinListAsync 

' a gönderen URL yolu 

https://localhost:5001/Customers/CreateFATH?handler=loinList . 

OnPostloinListUCAsync 

URL yolu 

https://localhost 

:5001/Customers/CreateFATHPhandler; 

OoinListUC . 


a gönderen 


Özel yollar 

@page yönergesini kullanarak şunları yapın: 

• Sayfaya özel bir yol belirtin. Örneğin, hakkında sayfasına olan yol 
@page "/some/other/Path"'' /some/other/Path olarak ayarlanabilir. 












• Kesimleri bir sayfanın varsayılan yoluna ekleyin. Örneğin, bir "öğe" segmenti sayfanın varsayılan 
yoluna @page "item" eklenebilir. 

• Bir sayfanın varsayılan yoluna parametreleri ekleyin. Örneğin, @page "{id}" bir sayfa için id bir 
İD parametresi gerekebilir. 

Yolun başındaki bir filde ( ~ ) tarafından atanan kök göreli bir yol desteklenir.Örneğin, 

@page "~/Some/Other/Path" @page "/Some/Other/Path" aynidir. 

Yol şablonu @page "{handler?}" belirterek /DoinList URL 'sindeki ?handler=]oinList sorgu dizesini 
bir rota kesimine değiştirebilirsiniz. 

Sorgu dizesini URL 'de ?handier=3oinList beğenmezseniz, işleyicinin yol bölümüne işleyici adını 
koymak için yolu değiştirebilirsiniz. Yolu, @page yönergesinden sonra çift tırnak içine alınmış bir rota 
şablonu ekleyerek özelleştirebilirsiniz. 

@page "{handler?}" 

@model CreateRouteModel 

<html> 

<body> 

<p> 

Enter your name. 

</p> 

<div asp-validation-summary="All"x/dlv> 

<form method="POST"> 

<div>Name: <input asp-for="Customer.Name" /></div> 

<input type="submit" asp-page-handler="]oinl_ist" value="Doin" /> 
cinput type="submlt" asp-page-handler="Doinl_istUC" value="10IN UC" /> 

</form> 

</body> 

</html> 

Yukarıdaki kodu kullanarak, onPostioinListAsync ' a gönderen URL yolu 
https : //localhost : 5001/Customers/CreateFATH/loinList . OnPostloinListUCAsync a gönderen U RL 
yolu https://localhost : 5001/Customers/CreateFATH/DoinListUC . 

Aşağıdaki handler ? yol parametresinin isteğe bağlı olduğu anlamına gelir. 

Yapılandırma ve ayarlar 

Gelişmiş seçenekleri yapılandırmak için, MVC Oluşturucu 'da AddRazorPagesOptions genişletme 
yöntemini kullanın: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services .AddMvc() 

.AddRazorPagesOptions(options => 

{ 

options.RootDirectory = "/MyPages"; 

options.Conventions.AuthorizeFolder("/MyPages/Admin"); 

}); 

} 


Şu anda, sayfalar için kök dizini ayarlamak veya sayfalar için uygulama modeli kuralları eklemek 
üzere RazorPagesOptions kullanabilirsiniz. Gelecekte bu şekilde daha fazla genişletilebiIirlik 
etkinleştireceğiz. 


Görünümleri önceden derlemek için bkz. Razor görünüm derlemesi. 


















Örnek kodu indirin veya görüntüleyin. 

Bu giriş hakkında bilgi için bkz. Razor Pages kullanmaya başlama. 

Razor Pages içerik kökünde olduğunu belirtin 

Varsayılan olarak, Razor Pages /Pages dizininde kök olarak depolanır. Razor Pages, uygulamanın 
içerik kökünde (contentrootpath) olduğunu belirtmek İçin addmvc 'ye 
VVİthRazorPagesAtContentRoot ekleyin: 

Services.AddMvc() 

.AddRazorPagesOptions(options => 

{ 

}) 

.WithRazorPagesAtContentRoot(); 

Razor Pages özel kök dizinde olduğunu belirtin 

Razor Pages uygulamadaki özel bir kök dizinde olduğunu belirtmek için Addmvc 'ye 
VVİthRazorPagesRoot ekleyin (göreli bir yol sağlayın): 

Services.AddMvc() 

.AddRazorPagesOptions(options => 

{ 

}) 

.WithRazorPagesRoot("/path/to/razor/pages"); 


Ek kaynaklar 

• ASP.NET Core'a Giriş 

• AS P.N ET Core Razor söz dizimi başvurusu 

• ASP.NET Core bölgeler 

• Öğretici: ASP.NET Core Razor Pages ile çalışmaya başlama 

• AS P.N ET Core Razor Pages yetkilendirme kuralları 

• ASP.NET Core Razor Pages yol ve uygulama kuralları 

• ASP.NET Core birim testlerini Razor Pages 

• ASP.NET Core kısmi görünümler 





Öğretici: ASRNET Core ile Razor Pages Web 
uygulaması oluşturma 

1.10.2019 • 2 minutes to read ı Edit Online 


Bu öğretici dizisinde Razor Pages Web uygulaması oluşturma temelleri açıklanmaktadır. 

Denetleyiciler ve görünümler hakkında bilgi sahibi olan geliştiricilere daha gelişmiş bir giriş için bkz. tanıtım 
Razor Pages. 

Bu seri aşağıdaki öğreticileri içerir: 

1. Razor Sayfaları web uygulaması oluşturma 

2. Razor Pages uygulamasına model ekleme 

3. Yapı iskelesi (oluşturma) Razor sayfaları 

4. Bir veritabanıyla çalışma 

5. Razor sayfalarını güncelleştirme 

6. Arama ekleme 

7. Yeni alan ekleme 

8. Doğrulama ekleme 


Son olarak, bir film veritabanını görüntüleyebilen ve yönetebileceğini bir uygulamanıza sahip olacaksınız. 


| - lndex - Movie X + 

C A https://localhost:5001/Movies?SearchString=ghost O. ğ ! 

Rp Movie Home Privacy 


lndex 


Create New 

Title: ghost 


Filter 


Title 

Release Date 

Genre 

Price 


Ghostbusters 

3/13/1984 

Comedy 

8.99 

Edit | Details | Delete 

Ghostbusters 2 

2/23/1986 

Comedy 

9.99 

Edit | Details | Delete 


© 2019 - RazorPagesMovie - Privacy 














Öğretici: ASRNET Core Razor Pages ile 
çalışmaya başlama 

10.12.2019 • 19 minutes to readı Edit Online 


Tarafından Rick Anderson 

Bu, bir serinin ASP.NET Core Razor Pages Web uygulaması oluşturma hakkında temel bilgileri öğretir. 

Denetleyiciler ve görünümler hakkında bilgi sahibi olan geliştiricilere daha gelişmiş bir giriş için bkz. 
tanıtım Razor Pages. 

Serinin sonunda, bir film veritabanını yöneten bir uygulamanız olacaktır. 

Örnek kodu görüntüle veya indir (indirme). 

Örnek kodu görüntüle veya indir (indirme). 

Bu öğreticide şunları yaptınız: 

• Razor Pages bir Web uygulaması oluşturun. 

• Uygulamayı çalıştırın. 

• Proje dosyalarını inceleyin. 

Bu öğreticinin sonunda, daha sonraki öğreticilerde oluşturacağınız çalışan bir Razor Pages Web 
uygulamasına sahipsiniz. 


| Home page - RazorPagesMovie X + 

□ X 

C- -> C A https://localhost:S001 

0 i 

RazorPagesMovie Home Privacy 


Welcome 


Learn about building Web apps with ASP.NET Core. 


© 2018 - RazorPagesMovie - Privacy 



Prerequisites 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• ASP.net ve Web geliştirme iş yüküyle Visual Studio 2019 16,4 veya üzeri 

• .NET Core 3,1 SDK veya üzeri 






Razor Pages Web uygulaması oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Visual Studio'dan dosya menüsünde yeni > proje. 

• Yeni bir AS P.N ET Core Web uygulaması oluşturun ve İleri 1 yiseçin. Yeni AS P.N ET Core Web 
uygulaması 


Create a new project 

Recent project templates 

O ASP.NET Core Web Application o 

31 Class Library (.NET Standard) o 


Search for project templates P * Language - Platform - Project type - 


Console App (.NET Core) 

A project for creating a command-line application that can run on .NET Core on 
Windows, Linux and MacOS. 

C# Linux macOS Wmdows Console 


ASP.NET Core Web Application 

Project templates for creating ASP.NET Core applications for Wındows, Lınux and 
macOS using .NET Core or .NET Framework. Create Razor Pages. MVC, Web API, and 
Single Page (SPA) Applications. 


C# Windows Linux macOS Web 


^ c ? WPF App (.NET Core) 

«■»-! windows Presentation Foundation Client application 


C# Wındows Desktop 


g£ 

< 9 > 


Class Library (.NET Standard) 

A project for creating a class library that targets .NET Standard. 

C* Androıd iOS Linux macOS Windows Library 

Azure Functions 

A template to create an Azure Function project. 

C# Azure Cloud 


3=1 


Mobile App (Xamarin.Forms) 


Next 


• Projeyi RazorPagesMovieolarak adlandırın. Kodu kopyaladığınızda ve yapıştırdığınızda ad 
alanlarının eşleşmesi için Project RazorPagesMovie olarak adı vermek önemlidir. Yeni ASP.NET 
Core Web uygulaması 

Configure your new project 


ASP.NET Core Web Application C* Linux macOS Windo«ts aoud Serace Web 


Project name 


|RazorPagesMovie[ 


Location 


C:\repos 


Solution name O 


0 


Place solution and project in the same directory 


Back 


Create 


• Açılan Web uygulamasındaki ASP.NET Core 3,1 1 i seçin ve ardından Oluştur 1 u seçin. 











X 


Create a new ASP.NET Core Web Application 


.NET Core - ASP.NET Core 3.0 


^ Empty 

An empty project template for creating an ASP.NET Core application. This template does not have any 
content in it. 



A project template for creating an ASP.NET Core application with an example Controller for a RESTful HTTP 
senrice. This template can also be used for ASP.NET Core MVC Vievvs and Controllers. 

Worker Service 

An empty project template for creating a worker service. 


| Web Application 

A project template for creating an ASP.NET Core application with example ASP.NET Core Razor Pages 
content. 


Web Application (Model-View-Controller) 


A project template for creating an ASP.NET Core application with example ASP.NET Core MVC Views and 
Controllers. This template can also be used for RESTful HTTP Services. 


-oRPr <«pruir(> 


Get additional project templates 


Authentication 

No Authentication 

Change 


Advanced 

'■'] Configure for HTTPS 
□ Enable Docker Support 
(Reguires Docker Desktop) 


Author: Microsoft 

Source: SDK 3.0.100-preview7-012801 


Back Create 


Aşağıdaki Başlatıcı proje oluşturulur: 


Solution Explorer ” 9 X 

(ît a- T ©- Ü <9 © 

Search Solution Explorer (Ctrl +;) P~ 

S31 Solution 'RazorPagesMovie' (1 project) 

a ■“ RazorPagesMovie 



<3> 

Connected Services 

> 


Dependencies 

> 

> 

Properties 

E> 

© 

wwwroot 

A 

Ö 

Pages 


t> 

Shared 



@ _Viewlmports.cshtml 



@ _ViewStart.cshtml 


t> 

S) Errorcshtml 


t> 

@ lndex.cshtml 


t> 

@ Privacy.cshtml 

t> 

ST 

appsettingsjson 

t> 

c* 

Program.es 

> 

c* 

Startup.es 


Uygulamayı çalıştırma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Hata ayıklayıcı olmadan çalıştırmak için CTRL + F5 tuşlarına basın. 
Visual Studio aşağıdaki iletişim kutusunu görüntüler: 













Microsoft Visual Studio 


X 


Thıs project ıs confıgured to use SSL To avoıd SSL wamıngs in the browser you 
can choose to trust ttıe self-sıgned certifıcate that IIS Express has generated. 


Would you lıke to trust the IIS Express SSL certifıcate? 


0 Don't ask me agaın 


Yes No 


IIS Express SSL sertifikasına güveniyorsanız Evet ' i seçin. 
Aşağıdaki iletişim kutusu görüntülenir: 


Security VVarning 



You are about to install a certificate from a certification 
authority (CA) daiming to represent 


localhost 


Windows cannotvalidatethat the certifıcate is actuallyfrom 
'localhost'. You should confirm its origin by contacting 
'localhost'. The following number will assist you in this 
process: 

Thumbprint (shal): 35AAFB1F 70EC5F89 C7180FBD 61AFE491 
94580874 


VVarning: 

If you install this root certificate, VVindovvs will automatically 
trust any certificate issued by this CA. Installing a certificate 
with an unconfirmed thumbprint is a security risk. If you click 
'Yes' you acknovvledge this risk. 

Do you want to install this certificate? 


Yes 



Geliştirme sertifikasına güvenmeyi kabul ediyorsanız Evet 1 i seçin. 

Visual Studio IIS Express başlar ve uygulamayı çalıştırır. Adres çubuğunda localhost:port# ve 
exampie.com gibi bir şey görüntülenir. Bunun nedeni, localhost yerel bilgisayar için Standart 
ana bilgisayar adıdır. Localhost yalnızca yerel bilgisayardan Web isteklerine hizmet verir. Visual 
Studio bir Web projesi oluşturduğunda, Web sunucusu için rastgele bir bağlantı noktası kullanılır. 

Proje dosyalarını inceleyin 

Aşağıda, daha sonraki öğreticilerde birlikte çalışacağımız ana proje klasörlerine ve dosyalarına genel bir 
bakış sunulmaktadır. 

Sayfalar klasörü 

Razor sayfaları ve destekleyici dosyalar içerir. Her Razor sayfası bir dosya çiftidir: 

• Razor söz dizimi kullanarak C# kodla HTM L işaretlemesi içeren bir. cshtml dosyası. 

• Sayfa olaylarını işleyen kodu içeren C# bir. cshtml.cs dosyası. 

Destekleyici dosyalar bir alt çizgiyle başlayan adlara sahiptir.Örneğin, _Layout. cshtml dosyası tüm 
sayfalarda ortak kullanıcı arabirimi öğelerini yapılandırır. Bu dosya sayfanın en üstündeki gezinti 
menüsünü ve sayfanın alt kısmındaki telif hakkı bildirimini ayarlar. Daha fazla bilgi için bkz. ASP.NET 
Core düzen. 

Wwwroot klasörü 

HTML dosyaları, JavaScript dosyaları ve CSS dosyaları gibi statik dosyaları içerir. Daha fazla bilgi için 





















bkz. AS P.N ET Core statik dosyalar. 


appSettings. JSON 

Bağlantı dizeleri gibi yapılandırma verilerini içerir. Daha fazla bilgi için bkz. AS P.N ET Core yapılandırma. 

Program.es 

Programın giriş noktasını içerir.Daha fazla bilgi için bkz. .NET genel ana bilgisayar. 

Startup.es 

Uygulama davranışını yapılandıran kodu içerir.Daha fazla bilgi için bkz. ASP.NET Core 'de uygulama 
başlatma. 

Sonraki adımlar 

Serideki bir sonraki öğreticiye ilerleyin: 


MODEL 

EKLEME 


Bu, bir serinin ilk öğreticisidir.Seriler , bir ASP.NET Core Razor pages Web uygulaması oluşturma 
hakkında temel bilgileri öğretir. 

Denetleyiciler ve görünümler hakkında bilgi sahibi olan geliştiricilere daha gelişmiş bir giriş için bkz. 
tanıtım Razor Pages. 

Serinin sonunda, bir film veritabanını yöneten bir uygulamanız olacaktır. 

Örnek kodu görüntüle veya indir (indirme). 

Örnek kodu görüntüle veya indir (indirme). 

Bu öğreticide şunları yaptınız: 

• Razor Pages bir Web uygulaması oluşturun. 

• Uygulamayı çalıştırın. 

• Proje dosyalarını inceleyin. 

Bu öğreticinin sonunda, daha sonraki öğreticilerde oluşturacağınız çalışan bir Razor Pages Web 
uygulamasına sahipsiniz. 




| Home page - RazorPagesMovîe X + 

□ X 

<- -> C A https://localhost:5001 

0 i 

RaZOrPagesMoVİe Home Privacy 


Welcome 


Learn about building Web apps with ASP.NET Core. 


© 2018 - RazorPagesMovîe - Privacy 



Prerequisites 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Visual Studio 2019 ile ASP.NET ve web geliştirme iş yükü 

• .NET core SDK 2.2 veya üzeri 


VVARNING 

Visual Studio 2017 kullanıyorsanız bkz dotnet/SDK'sı sorun #3124 Visual Studio ile çalışmayan .NET Core SDK 
sürümleri hakkında bilgi için. 


Razor Pages Web uygulaması oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Visual Studio'dan dosya menüsünde yeni > proje. 

• Yeni bir AS P.N ET Core Web uygulaması oluşturun ve İleri ' yiseçin. 





Create a new project 

Recent project templates 

O ASP.NET Core Web Application c* 

SI Class Library (.NET Standard) c# 


Search for project templates P ’ Language - Platform - Project type - 




Console App (.NET Core) 

A project for creating a command-line application that can run on .NET Core on 
Windows, Linux and MacOS. 


C# Linux macOS Windows Console 


ASP.NET Core Web Application 

Project templates for creating ASP.NET Core applications for Wındows, Lınux and 
macOS usıng .NET Core or .NET Framevrark. Create Razor Pages, MVC, Web API, and 
Single Page (SPA) Applications. 


C* Windows ünux macOS Web 


rj 

<■»—* 


WPF App (.NET Core) 

Windows Presentation Foundation Client application 


C# Wındows Desktop 


<f> 


Class Library (.NET Standard) 

A project for creating a class library that targets .NET Standard. 

C* Android iOS Linux macOS Windows Library 

Azure Functions 

A template to create an Azure Function project. 

C« Azure CIolkJ 


m 


Mobile App (Xamarin.Forms) 


İOS 


Next 


• Projeyi RazorPagesMovieolarak adlandırın. Kodu kopyaladığınızda ve yapıştırdığınızda ad 
alanlarının eşleşmesi için Project RazorPagesMovie olarak adı vermek önemlidir. 

Configure your new project 

ASP.NET Core Web Application C# Linux macOS Wirı<lı»vs Omu! Service Vfcb 

Project name 

Location 



Solution name o 


0 


Place solution and project in the same directory 


Back 


Create 


• Açılan Web uygulamasındaki ASP.NET Core 2,2 1 i seçin ve ardından Oluştur 1 u seçin. 











Create a new ASP.NET Core Web Application 


.NET Core 


- ASP.NET Core 2.2 


sn 


Empty 


An empty project template for creating an ASP.NET Core application. This template does not have any 
content in it 



A project template for creating an ASP.NET Core application with an example Controller for a RESTful HTTP 
service. This template can also be used for ASP.NET Core MVC Views and Controllers. 


| Web Application 

A project template for creating an ASP.NET Core application with example ASP.NET Core Razor Pages 
content 


Web Application (Model-Vİevv-Controller) 


A project template for creating an ASP.NET Core application with example ASP.NET Core MVC Views and 
Controllers. This template can also be used for RESTful HTTP Services. 


jj| Razor Class Library 

A project template for creating a Razor class library. 


Get additional project templates 


Authentication 

No Authentication 

Change 


Advanced 

R1 Configure for HTTPS 
' 1 Enable Docker Support 


(Reguires Docker Desktop) 


|unux »| 

Author: Microsoft 


Source: SDK 2.2.104 


Back 

Create 


Aşağıdaki Başlatıcı proje oluşturulur: 


Solution Explorer 


- ¥ x 

dür S! - T © - t* 9 © 


* >0 

Search Solution Explorer (Ctrl+;> 


fi- 

«âl Solution RazorPagesMovie' (1 project) 

^ "T RazorPagesMovie 


Q> Connected Services 
P .V Depetıdencies 

P Properties 

P @ wwwroot 
■J — Pages 
P Shared 

@ _Vıewlmports.cshtml 
@ _ViewStart.cshtml 
P @ Error.cshtml 

P @ lndex.cshtml 

P @ Privacy.cshtml 

P ol appsettings.json 
P c* Program.es 
P c» Startup.es 


Uygulamayı çalıştırma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Hata ayıklayıcı olmadan çalıştırmak için CTRL + F5 tuşlarına basın. 
Visual Studio aşağıdaki iletişim kutusunu görüntüler: 




















Microsoft Visual Studio 


X 


Thıs project ıs confıgured to use SSL To avoıd SSL wamıngs in the browser you 
can choose to trust ttıe self-sıgned certifıcate that IIS Express has generated. 


Would you lıke to trust the IIS Express SSL certifıcate? 


0 Don't ask me agaın 


Yes No 


IIS Express SSL sertifikasına güveniyorsanız Evet ' i seçin. 
Aşağıdaki iletişim kutusu görüntülenir: 


Security VVarning 



You are about to install a certificate from a certification 
authority (CA) daiming to represent 


localhost 


Windows cannotvalidatethat the certifıcate is actuallyfrom 
'localhost'. You should confirm its origin by contacting 
'localhost'. The following number will assist you in this 
process: 

Thumbprint (shal): 35AAFB1F 70EC5F89 C7180FBD 61AFE491 
94580874 


VVarning: 

If you install this root certificate, VVindovvs will automatically 
trust any certificate issued by this CA. Installing a certificate 
with an unconfirmed thumbprint is a security risk. If you click 
'Yes' you acknovvledge this risk. 

Do you want to install this certificate? 


Yes 



Geliştirme sertifikasına güvenmeyi kabul ediyorsanız Evet ' i seçin. 

Express başlar ve uygulamayı çalıştırır. Adres çubuğu exampie.com gibi değil 
gösterir. Bunun nedeni, localhost yerel bilgisayar için Standart ana bilgisayar 
adıdır. Localhost yalnızca yerel bilgisayardan Web isteklerine hizmet verir. Visual Studio bir web 
projesi oluşturduğunda, web sunucusu için rastgele bir bağlantı noktası kullanılır. 

Uygulamanın giriş sayfasında, izlemeye izin vermek için kabul et ' i seçin. 

Bu uygulama kişisel bilgileri izlemez, ancak proje şablonu, Avrupa Birliği 'nin genel veri koruma 
yönetmeliği (GDPR)ile uyumlu olması için ihtiyaç duymanız durumunda izin özelliğini içerir. 


Visual Studio I 
localhost:port# 



















| Home page - RazorPagesMovie X + 

f- -> O i https://localhost:5001 ğ : 

RazorPagesMoVİe Home Privacy 


Use this space to summarize your privacy and cookie use policy. Leaın More. 

VVelcome 

Learn about building Web apps with ASP.NET Core. 


Accept 


© 2018 - RazorPagesMovie - Privacy 


Aşağıdaki görüntüde, izlemeye onay verdikten sonra uygulama gösterilmektedir: 


| Home page - RazorPagesMovie x + 

□ X 

C A https://localhost:5001 

0 i 

RazorPagesMovie Home Privacy 


VVelcome 


Learn about building Web apps with ASP.NET Core. 


© 2018 - RazorPagesMovie - Privacy 



Proje dosyalarını inceleyin 

Aşağıda, daha sonraki öğreticilerde birlikte çalışacağımız ana proje klasörlerine ve dosyalarına genel bir 
bakış sunulmaktadır. 

Sayfalar klasörü 

Razor sayfaları ve destekleyici dosyalar içerir. Her Razor sayfası bir dosya çiftidir: 

• Razor söz dizimi kullanarak C# kodla HTM L işaretlemesi içeren bir. cshtml dosyası. 

• Sayfa olaylarını işleyen kodu içeren C# bir. cshtml.cs dosyası. 

Destekleyici dosyalar bir alt çizgiyle başlayan adlara sahiptir.Örneğin, _Layout. cshtml dosyası tüm 
sayfalarda ortak kullanıcı arabirimi öğelerini yapılandırır. Bu dosya sayfanın en üstündeki gezinti 
menüsünü ve sayfanın alt kısmındaki telif hakkı bildirimini ayarlar. Daha fazla bilgi için bkz. ASP.NET 
Core düzen. 

Wwwroot klasörü 

HTML dosyaları, JavaScript dosyaları ve CSS dosyaları gibi statik dosyaları içerir. Daha fazla bilgi için 
bkz. AS P.N ET Core statik dosyalar. 


appSettings. JSON 









Bağlantı dizeleri gibi yapılandırma verilerini içerir. Daha fazla bilgi için bkz. AS P.N ET Core yapılandırma. 


Program.es 

Programın giriş noktasını içerir.Daha fazla bilgi için bkz. .NET genel ana bilgisayar. 

Startup.es 

Tanımlama bilgilerinin onayını gerektirip gerektirmediğini belirten uygulama davranışını yapılandıran 
kodu içerir. Daha fazla bilgi için bkz. AS P.N ET Core 'de uygulama başlatma. 

Ek kaynaklar 

• Bu öğreticinin YouTube sürümü 

Sonraki adımlar 

Serideki bir sonraki öğreticiye ilerleyin: 


MODEL 

EKLEME 



Bir ASPNET Core Razor sayfaları uygulama için 
model ekleme 

10.12.2019 • 40 minutes to read ı Edit Online 


Tarafından Rick Anderson 

Bu bölümde, platformlar arası bir SQLİte veritabanındafilm yönetimi için sınıflar eklenir. Bir ASP.NET Core 
şablondan oluşturulan uygulamalar bir SQLİte veritabanı kullanır. Uygulamanın model sınıfları, veritabanıyla 
çalışmak için Entity Framevvork Core (EF Core) (S QLite EF Core veritabanı sağlayıcısı) ile kullanılır. EF Core, 
veri erişimini kolaylaştıran bir nesne ilişkisel eşleme (ORM) çerçevesidir. 

EF Core üzerinde herhangi bir bağımlılığı olmadığından model sınıfları ("düz eski CLR nesnelerden") POCO 
sınıfları olarak bilinir. Bunlar, veritabanında depolanan verilerin özelliklerini tanımlayın. 

Örnek kodu görüntüle veya indir (indirme). 

Örnek kodu görüntüle veya indir (indirme). 

Bir veri modeli ekleme 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Sağ RazorPagesMovie Proje > Ekle > yeni klasör. Klasör adı modelleri. 

Sağ tıklayın modelleri klasör. Seçin ekleme > sınıfı. Sınıf adı film. 

Aşağıdaki özellikleri Movie sınıfına ekleyin: 

using System; 

using System.ComponentModel.DataAnnotations; 

namespace RazorPagesMovie.Models 
{ 

public class Movie 
{ 

public int ID { get; set; } 
public string Title { get; set; } 

[DataType(DataType.Date)] 
public DateTime ReleaseDate { get; set; } 
public string Genre { get; set; } 
public decimal Price { get; set; } 

} 

} 

Movie sınıfı şunları içerir: 

• id alanı birincil anahtar için veritabanı gerektirir. 

• [DataType(DataType.Date)] : DataType özniteliği verilerin türünü belirtir (Tarih). Bu öznitelikle: 

o Kullanıcının Tarih alanına saat bilgilerini girmesi gerekli değildir, 
o Zaman bilgisi değil yalnızca tarih görüntülenir. 






Veri açıklamaları sonraki bir öğreticide ele alınmıştır. 
Derleme hata doğrulamak için projeyi derleyin. 


Film modeli iskelesini 

Bu bölümde, film modeli iskele kurulmuş. Diğer bir deyişle, yapı iskelesi aracı sayfaları için oluşturma, okuma, 
güncelleştirme ve silme (CRUD) işlemlerine yönelik film modeli oluşturur. 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Oluşturma bir sayfalart/filmler klasörü: 

• Yeni > klasör eklemek > Sayfalar klasörüne sağ tıklayın. 

• Klasör adı filmler 


Sayfalar/filmler klasörüne sağ tıklayın > > yeni yapı İskelesi öğesi ekleyin . 



Solutiorı Explorer w ? X 

(2l nî ' T © ’ â 1 

Search Solution Explorer (Ctrl +; fi - 

Solution 'RazorPagesMovie2.2' (1 
a RazorPagesMovie 

Connected Services 

> Dependencies 

> 9 fi Properties 

> a@ wwwroot 

> al Models 
a as Pages 


View in Brovvser (Google Chrome) 
Task Runner Explorer 
Configure External Tools... 

Brovvse With... 


Ctrl+Shift+W 


*□ 

+□ 


fi 

% 


Razor Page... 

Controller... 

New Item... 

Existing Item... 

New Scaffolded Item... 

New Folder 

Container Orchestrator Support 
Docker Support 
Client-Side Library... 

Class... 


Ctrl+Shift+A 

Shift+Alt+A 



Add 

► 


Scope to This 



New Solution Explorer View 


© 

View History... 



Exclude From Project 


<54 

Cut 

Ctrl+X 

& 

Copy 

Ctrl+C 

X 

Delete 

Del 

O 

Rename 


c* 

Öpen Folder in File Explorer 


fi 

Properties 

Alt+Enter 


Yapı İskelesi Ekle iletişim kutusunda Razor Pages Entity Framevvork (crud) > Ekle 1 yi seçin. 













Tamamlamak ekleme Razor sayfaları (CRUD) Entity Framevvork kullanarak iletişim: 

• içinde Model sınıfı seçin, açılan menü film (RazorPagesMovie.Models). 

• Veri bağlamı sınıfı satırında + (artı) işaretini seçin ve oluşturulan adı RazorPagesMovie ' dan değiştirin. 
Modeller. RazorPagesMovieContext to RazorPagesMovie. Veri. RazorPagesMovieContext. Bu değişiklik 
gerekli değildir. Doğru ad alanıyla veritabanı bağlamı sınıfını oluşturur. 

• Add (Ekle) seçeneğini belirleyin. 


Add Razor Pages using Entity Framevvork (CRUD) 


X 


Generates Razor Pages using Entity Framevvork for; Create, Delete, Details, Edit and List operations for 
the selected model. 


Model class: 

Data context class: 


Movie (RazorPagesMovie.Models) 


RazorPaoesMovieJ»^lKtRazorPaaesMovieContext 


Options: 

I I Create as a partial view 
0 Reference script libraries 
0 Use a layout page: 


(Leave empty if it is set in a Razor _viewstart file) 


Add 


Cancel 


Appsettings.json dosya yerel bir veritabanına bağlanmak için kullanılan bağlantı dizesi ile güncelleştirilir. 

Oluşturulan dosyalar 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

iskele işlem oluşturur ve aşağıdaki dosyaları güncelleştirir: 

• S ayfa/film ler. oluşturma, silme, Ayrıntılar, düzenleme ve dizin. 














































• Da ta/R azorPagesMov'ıeCon text. cs 


Güncelleştirme tarihi 

• Startup.es 

Oluşturulan ve güncelleştirilen dosyalar, sonraki bölümde açıklanmıştır. 


İlk geçiş 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Bu bölümde, Paket Yöneticisi Konsolu (PMC'yi) için kullanılır: 

• Bir başlangıç geçiş ekleyin. 

• Veritabanı, ilk geçiş ile güncelleştirin. 


Araçlar menüsünde NuGet Paket Yöneticisi > Paket Yöneticisi konsolu 1 nu seçin. 


MvcMovie - Microsoft Visual Studio 
File Edit View Project Build Debug 
( E Extensions and Updates... 

T g Connectto Database... 

’Eİ Connectto Server... 

Add SQL Server... 

SQL Server 
Web Code Analysis 
D Code Snippets Manager... 

Choose Toolbox Items... 

NuGet Package Manager 
G& WCF Service Configuration Editör 
External Tools... 

Import and Export Settings... 
Customize... 

0 Options... 


Team Tools Test Analyze Window 


Ctrl+K, Ctrl+B 



PMC'de aşağıdaki komutları girin: 

Add-Migration InitialCreate 
Update-Database 

Yukarıdaki komutlar şu uyarıyı oluşturur:Movie 1 varlık türündeki' Price 1 ondalık sütunu için tür 
belirtilmedi. Bu, varsayılan duyarlık ve ölçeğe uygun olmadıkları takdirde değerlerin sessizce kesilmesine 
neden olur. 1 Hasccolumntype 0 1 kullanarak tüm değerleri barındırabilecek SQL Server sütun türünü açık 
olarak belirtin." 

Bu uyarıyı yoksayabilirsiniz, daha sonraki bir öğreticide düzeltilecektir. 

Geçişler komutu, ilk veritabanı şemasını oluşturmak için kod üretir. Şema, DbContext belirtilen modeli temel 
alır. InitialCreate Bağımsız değişkeni, geçişlerin adlandırmak için kullanılır. Herhangi bir ad kullanılabilir, 
ancak bir adı seçili kural gereği, geçiş açıklar. 

update komutu uygulanmamış geçişlerde up yöntemini çalıştırır. Bu durumda update , veritabanını 
oluşturan geçiş/<zaman damgası > _lrıitialCreate. cs dosyasında up yöntemini çalıştırır. 






• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Bağımlılık ekleme ile kayıtlı bağlamını İnceleme 

ASP.NET Core ile oluşturulmuş bağımlılık ekleme. Hizmetler (örneğin, EF Core DB bağlamı), uygulama 
başlatma sırasında bağımlılık ekleme ile kaydedilir. Bu hizmetler (örneğin, Razor sayfaları) gerektiren 
bileşenler bu hizmetler Oluşturucu parametresi üzerinden sağlanır. Bir DB bağlamı örneği alır Oluşturucu 
kodu öğreticinin ilerleyen bölümlerinde gösterilmektedir. 

Yapı iskelesi aracı otomatik olarak oluşturulmuş bir veritabanı bağlamını ve bağımlılık ekleme kapsayıcısını ile 
kayıtlı. 

inceleme startup.configureservices yöntemi. Vurgulanan satırı iskele kurucu tarafından eklendi: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRazorPages(); 

Services.AddDbContext<RazorPagesMovieContext>(options => 

options.UseSqlServer(Configuration.GetConnectionString("RazorPagesMovieContext"))); 

} 

RazorPagesMovieContext EF Core işlevleri (oluşturma, okuma, güncelleştirme, silme, vb.) için koordinatları 
Movie modeli. Veri bağlamı ( RazorPagesMovieContext ) türetilir Microsoft.EntityFrameworkCore.DbContext. 
Veri bağlamı, hangi varlıkları veri modelinde yer alan belirtir. 

using Microsoft.EntityFrameworkCore; 

namespace RazorPagesMovie.Models 
{ 

public class RazorPagesMovieContext : DbContext 
{ 

public RazorPagesMovieContext (DbContextOptions<RazorPagesMovieContext> options) 

: base(options) 

{ 

} 

public DbSet<RazorPagesMovie.Models.Movie> Movie { get; set; } 

} 

} 

Önceki kod, varlık kümesi için bir Dbset<filmi > özelliği oluşturur. Entity Framevvork terminolojisinde, bir 
varlık kümesini genellikle bir veritabanı tablosuna karşılık gelir. Bir varlık tablosunda bir satıra karşılık gelir. 

Bağlantı dizesi adı için bağlam üzerinde bir yöntemi çağırarak geçirilen bir DbContextOptions nesne. Yerel 
geliştirme için ASP.NET Core yapılandırma sistemi bağlantı dizesinden okur appsettings.json dosya. 

Uygulamayı test etme 

• Uygulamayı çalıştırın ve ekleme /Movies tarayıcıda URL'sine ( http://iocaihost:port/movies ). 

Hatası alırsanız: 

SqlException: Cannot öpen database "RazorPagesMovieContext-GUID" requested by the login. The login failed. 
Login failed for user 'User-name'. 


Eksik geçişler adım. 







• Test Oluştur bağlantı. 



Sonraki öğreticiye yapı iskelesi tarafından oluşturulan dosyaları açıklar. 

Ek kaynaklar 


ÖNCEKİ: ■ SON RAKI: RAZOR SAYFALARI İÇİN İSKELE 

BAŞLAMA ■ KURULMUŞ 


Bu bölümde, platformlar arası bir SQLİte veritabanındafilm yönetimi için sınıflar eklenir. Bir ASP.NET Core 
şablondan oluşturulan uygulamalar bir SQLİte veritabanı kullanır. Uygulamanın model sınıfları, veritabanıyla 
çalışmak için Entity Framevvork Core (EF Core) (SQLİte EF Core veritabanı sağlayıcısı) ile kullanılır. EF Core, 
veri erişimini kolaylaştıran bir nesne ilişkisel eşleme (ORM) çerçevesidir. 

EF Core üzerinde herhangi bir bağımlılığı olmadığından model sınıfları ("düz eski CLR nesnelerden") POCO 
sınıfları olarak bilinir. Bunlar, veritabanında depolanan verilerin özelliklerini tanımlayın. 








Örnek kodu görüntüle veya indir (indirme). 

Örnek kodu görüntüle veya indir (indirme). 

Bir veri modeli ekleme 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Sağ RazorPagesMovie Proje > Ekle > yeni klasör. Klasör adı modelleri. 

Sağ tıklayın modelleri klasör. Seçin ekleme > sınıfı. Sınıf adı film. 

Aşağıdaki özellikleri Movie sınıfına ekleyin: 

using System; 

using System.ComponentModel.DataAnnotations; 

namespace RazorPagesMovie.Models 
{ 

public class Movie 
{ 

public int ID { get; set; } 
public string Title { get; set; } 

[DataType(DataType.Date)] 
public DateTime ReleaseDate { get; set; } 
public string Genre { get; set; } 
public decimal Price { get; set; } 

} 

} 

Movie sınıfı şunları içerir: 

• id alanı birincil anahtar için veritabanı gerektirir. 

• [DataType(DataType.Date)] : DataType özniteliği verilerin türünü belirtir (Tarih). Bu öznitelikle: 

o Kullanıcının Tarih alanına saat bilgilerini girmesi gerekli değildir, 
o Zaman bilgisi değil yalnızca tarih görüntülenir. 

Veri açıklamaları sonraki bir öğreticide ele alınmıştır. 

Derleme hata doğrulamak için projeyi derleyin. 

Film modeli iskelesini 

Bu bölümde, film modeli iskele kurulmuş. Diğer bir deyişle, yapı iskelesi aracı sayfaları için oluşturma, okuma, 
güncelleştirme ve silme (CRUD) işlemlerine yönelik film modeli oluşturur. 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Oluşturma bir sayfaları/filmler klasörü: 

• Yeni > klasör eklemek > Sayfalar klasörüne sağ tıklayın. 

• Klasör adı filmler 




Sayfalar/filmler klasörüne sağ tıklayın > > yeni yapı İskelesi öğesi ekleyin . 


Solutiorı Explorer ^ ? X 

(ît Ö! - I T © - S 9 

Search Solution Explorer (Ctrl+; P - 

Solution 'RazorPagesMovie2.2' (1 
a RazorPagesMovie 

Cş> Connected Services 

> .-■* Dependencies 

> Properties 

> â@ wwwroot 

> si Models 

* fi» Pages _ 


Movies 


View in Brovvser (Google Chrome) Ctrl+Shift+W 


) Task Runner Explorer 
Configure External Tools... 
Brovvse With... 


© 

Razor Page... 



Add 


► 

© 

Controller... 



Scope to This 



*□ 

New Item... 

Ctrl+Shift+A 

& 

New Solution Explorer View 



+ a 

Existing Item... 

Shift+Alt+A 

© 

View History... 




New Scaffolded Item... 



Exclude From Project 



im 

New Folder 


& 

Cut 

Ctrl+X 



Container Orchestrator Support 


(5 

Copy 

Ctrl+C 



Docker Support 


X 

Delete 

Del 


& 

Client-Side Library... 


0 

Rename 




Class... 


c* 

Öpen Folder in File Explorer 




f* Properties Alt+Enter 


Yapı İskelesi Ekle iletişim kutusunda Razor Pages Entity Framevvork (crud) > Ekle 1 yi seçin. 


Add Scaffold 

a Installed 

a Common 
API 

t> MVC 
Razor Pages 
Identity 
Layout 


X 


Razor Page 

Razor Page using Entity Framework 


Razor Pages using Entity Framevvork 
(CRUD) 

by Microsoft 
vl .0.0.0 


I) 


Razor Pages using Entity Framevvork (CRUD) 


Generates Razor Pages using Entity 
Framevvork for; Create, Delete, Details, Edit 
and List operations for the given model. 

İd: Microsoft.AspNet.Scaffolding.Mvc.Mode 
IBasedCrudRazorPageScaffolder 


Click here to go online and find more scaffolding 

extensions. 


Add 


Cancel 


Tamamlamak ekleme Razor sayfaları (CRUD) Entity Framevvork kullanarak iletişim: 

• içinde Model sınıfı seçin, açılan menü film (RazorPagesMovie.Models). 

• içinde veri bağlamı sınıfının satır, select + (artı) oturum açın ve oluşturulan adı kabul 

























RazorPagesMovie.Models.RazorPagesMovieContext 
• Add (Ekle) seçeneğini belirleyin. 


Add Razor Pages using Entity Framework (CRUD) 


X 


Generates Razor Pages using Entity Framework for; Create, Delete, Details, Edit and List operationsforthe 
selected model. 


Model class: 

Data context class: 


Movie (RazorPagesMovie.Models) 


RazorPagesMovie.Models.RazorPagesMovieContext 



Options: 

I I Create as a partial view 
Reference script libraries 
R1 Use a layout page 

ı ı m 

(Leave empty if it is set in a Razor _viewstart file) 


Add 


Cancel 


Appsettings.json dosya yerel bir veritabanına bağlanmak için kullanılan bağlantı dizesi ile güncelleştiril 
İskele işlem oluşturur ve aşağıdaki dosyaları güncelleştirir: 

Oluşturulan dosyalar 

• S ayfa/film ter. oluşturma, silme, Ayrıntılar, düzenleme ve dizin. 

• Da ta/R azorPagesMovieCon text. cs 

Dosya güncelleştirildi 

• Startup.es 

Oluşturulan ve güncelleştirilen dosyalar, sonraki bölümde açıklanmıştır. 


İlk geçiş 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Bu bölümde, Paket Yöneticisi Konsolu (PMC'yi) için kullanılır: 

• Bir başlangıç geçiş ekleyin. 

• Veritabanı, ilk geçiş ile güncelleştirin. 

Araçlar menüsünde NuGet Paket Yöneticisi > Paket Yöneticisi konsolu 1 nu seçin. 





















£| MvcMovie - Microsoft Visual Studio 
File Edit View Project Build Debug 
( E Extensions and Updates... 

T jj Connectto Oatabase... 

T 5j Connectto Server... 

Ad d SQL Server... 


Team Tools 


WCF Service Configuration Editör 
External Tools... 

Import and Export Settings... 
Customize... 

Options... 


Analyze Window Help 
- ► IIS Errpress * Ö * 


SQL Server 

► 

Web Code Analysis 

► 

Code Snippets Manager... 

Ctrl+K, Ctrl+B 

Choose Toolbox Items... 

NuGet Package Manager 

► 



PMC'de aşağıdaki komutları girin: 

Add-Migration Initial 
Update-Database 

Add-Migration Komut, ilk veritabanı şeması oluşturmak için kod oluşturur. Şema, DbContext belirtilen modele 
dayalıdır ( RazorPagesMovieContext.cs dosyasında), initiaicreate bağımsız değişkeni, geçişi adlandırmak 
için kullanılır. Herhangi bir ad kullanılabilir, ancak kurala göre geçiş tanımlayan bir ad kullanılır.Daha fazla bilgi 
için bkz. Öğretici: EF Core ile geçiş özelliğini kullanma-ASP.NET MVC. 

update-Database Komutu çalıştırmaları up yönteminde geçişleri/<zaman damgası > JnitialCreate.es dosya, 
up Yöntemi veritabanı oluşturur. 


NOTE 

Yukarıdaki komutlar şu uyarıyı oluşturur: " ' Movie ' varlık türündeki ' Price ' ondalık sütunu için tür belirtilmedi. Bu, 
varsayılan duyarlık ve ölçeğe uygun olmadıkları takdirde değerlerin sessizce kesilmesine neden olur. ' 
Hasccolumntype 0 ' kullanarak tüm değerleri barındırabilecek SQL Server sütun türünü açık olarak belirtin. " Bu 
uyarıyı yoksayabilirsiniz, daha sonraki bir öğreticide düzeltilecektir. 


• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Bağımlılık ekleme ile kayıtlı bağlamını İnceleme 

ASP.NET Core ile oluşturulmuş bağımlılık ekleme. Hizmetler (örneğin, EF Core DB bağlamı), uygulama 
başlatma sırasında bağımlılık ekleme ile kaydedilir. Bu hizmetler (örneğin, Razor sayfaları) gerektiren 
bileşenler bu hizmetler Oluşturucu parametresi üzerinden sağlanır. Bir DB bağlamı örneği alır Oluşturucu 
kodu öğreticinin ilerleyen bölümlerinde gösterilmektedir. 

Yapı iskelesi aracı otomatik olarak oluşturulmuş bir veritabanı bağlamını ve bağımlılık ekleme kapsayıcısını ile 
kayıtlı. 

inceleme startup.configureservices yöntemi. Vurgulanan satırı iskele kurucu tarafından eklendi: 







// This method gets called by the runtime. 

// Use this method to add Services to the Container, 
public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

// This lambda determines whether user consent for non-essential cookies is 
// needed for a given request. 
options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

Services.AddDbContext<RazorPagesMovieContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("RazorPagesMovieContext"))); 

} 

RazorPagesMovieContext EF Core işlevleri (oluşturma, okuma, güncelleştirme, silme, vb.) için koordinatları 
Movie modeli. Veri bağlamı ( RazorPagesMovieContext ) türetilir Microsoft.EntityFrameworkCore.DbContext. 
Veri bağlamı, hangi varlıkları veri modelinde yer alan belirtir. 

using Microsoft.EntityFrameworkCore; 

namespace RazorPagesMovie.Models 

{ 

public class RazorPagesMovieContext : DbContext 

{ 

public RazorPagesMovieContext (DbContextOptions<RazorPagesMovieContext> options) 

: base(options) 

{ 

} 

public DbSet<RazorPagesMovie.Models.Movie> Movie { get; set; } 

} 

} 

Önceki kod, varlık kümesi için bir Dbset<filmi > özelliği oluşturur. Entity Framevvork terminolojisinde, bir 
varlık kümesini genellikle bir veritabanı tablosuna karşılık gelir. Bir varlık tablosunda bir satıra karşılık gelir. 

Bağlantı dizesi adı için bağlam üzerinde bir yöntemi çağırarak geçirilen bir DbContextOptions nesne. Yerel 
geliştirme için ASP.NET Core yapılandırma sistemi bağlantı dizesinden okur appsettings.json dosya. 

Uygulamayı test etme 

• Uygulamayı çalıştırın ve ekleme /Movies tarayıcıda URL'sine ( http://iocaihost:port/movies ). 

Hatası alırsanız: 


SqlException: Cannot öpen database "RazonPagesMovieContext-GUID" requested by the login. The login failed. 
Login failed for user 'User-name'. 


Eksik geçişler adım. 


• Test Oluştur bağlantı. 





I Create - RazorPagesMovie 


<- -> G i https://localhost:5001/Movies/Create 0 : 


RazorPagesMovie 


Create 

Movie 

Title 

The Good, the bad, and the ugly 

ReleaseDate 

11/30/2018 

Genre 

Western 

Price 

1.19 


Create 


Back to List 

© 2019 - RazorPagesMovie - Privacy 

w 

NOTE 

Ondalık virgül kullanımı girmeniz mümkün olmayabilir Price alan. Desteklemek için jQuery doğrulama virgül 
İngilizce olmayan yerel bir ondalık noktasının ve ABD İngilizce olmayan tarih biçimleri, uygulamayı Eğer 
gerekir. Genelleştirme hakkında yönergeler için bkz. bu GitHub sorunu. 


• Test Düzenle, ayrıntıları, ve Sil bağlantıları. 

Sonraki öğreticiye yapı iskelesi tarafından oluşturulan dosyaları açıklar. 

Ek kaynaklar 


ÖNCEKİ: ■ SON RAKI: RAZOR SAYFALARI İÇİN İSKELE 


BAŞLAMA 


KURULM UŞ 









ASRNET Core Razor Pages scafkatlama 

23.11.2019 * 25 minutes to read ı Edit Online 


Tarafından Rick Anderson 

Bu öğreticide, önceki öğreticidescafkatlama tarafından oluşturulan Razor Pages incelenir. 

Örnek kodu görüntüle veya indir (indirme). 

Örnek kodu görüntüle veya indir (indirme). 

Oluşturma, silme, Ayrıntılar ve düzenleme sayfaları 

Pages/filmler/lndex. cshtml. cs sayfa modelini inceleyin: 

// Unused usings removed. 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using Microsoft.EntityFrameworkCore; 

using RazorPagesMovie.Models; 

using System.Collections.Generic; 

using System.Threading.Tasks; 

namespace RazorPagesMovie.Pages.Movies 

{ 

public class IndexModel : PageModel 

{ 

private readonly RazorPagesMovie.Data.RazorPagesMovieContext _context; 

public IndexModel(RazorPagesMovie.Data.RazorPagesMovieContext context) 

{ 

_context = context; 

} 

public IList<Movie> Movie { get;set; } 

public async Task OnGetAsync() 

{ 

Movie = await _context.Movie.Tol_istAsync(); 

} 

} 

} 

Razor Pages PageModel türetilir. Kurala göre PageModel türetilmiş sınıf <PageName>Modei olarak adlandırılır. 
Oluşturucu, RazorPagesMovieContext sayfaya eklemek için bağımlılık ekleme işlemini kullanır. Tüm yapı iskelesi 
sayfaları bu düzene uyar. Entity Framevvork zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. 

zaman uyumsuz kod . 

Sayfa için bir istek yapıldığında onGetAsync yöntemi, Razor sayfasına bir film listesi döndürür. onGetAsync 
veya onGet , sayfanın durumunu başlatmak için çağırılır. Bu durumda, OnGetAsync film listesini alır ve 
görüntüler. 

OnGet void döndürdüğünde veya OnGetAsync" Task döndürürse, hiçbir dönüş açıklaması kullanılmaz. Dönüş 
türü iActionResuit veya Task<iActionResuit> olduğunda, return ifadesinin sağlanması gerekir. Örneğin, 
Pages/filmler/Create. cshtml. cs onPostAsync yöntemi: 

















public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_context.Movie.Add(Movie); 
await _context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 

} 

Pages/filmler/lndex. cshtml Razor sayfasını inceleyin: 



@page 

@model RazorPagesMovie.Pages.Movies.IndexModel 

@{ 

ViewData["Title"] = "Index"; 

} 

<hl>Index</hl> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<table class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model => model.Movie[0].Title) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movie[0].ReleaseDate) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movie[0].Genre) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movie[0].Price) 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model.Movie) { 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.ReleaseDate) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Genre) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Price) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID">Details</a> | 

<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 

Razor, HTML 'den C# ya da Razor 'e özgü biçimlendirmeye geçiş yapabilir. Bir @ sembol sonrasında Razor 
ayrılmış bir anahtar sözcükolduğunda, bu, 1 a geçiş yapar C#. 

@page yönergesi 

@page Razor yönergesi, dosyayı bir MVC eylemi yapar, bu da istekleri işleyebileceği anlamına gelir. @page 
sayfadaki ilk Razor yönergesi olmalıdır. @page , Razor 'e özgü biçimlendirmeye geçme örneğidir. Daha fazla 
bilgi için bkz. Razor söz dizimi . 


Aşağıdaki HTML Yardımcısı 'nda kullanılan lambda ifadesini inceleyin: 





@Html.DisplayNameFor(model => model.Movie[0].Title) 

DisplayNameFor HTML Yardımcısı, görünen adı belirlemede lambda ifadesinde başvurulan Title özelliğini 
inceler. Lambda ifadesi değerlendirilmek yerine incelenir. Bu, model, model.Movie veya model. Movie[0] nuiı 
veya boş olduğunda herhangi bir erişim ihlali olmadığı anlamına gelir. Lambda ifadesi değerlendirildiğinde 
(örneğin, @Htmi.DispiayFor(modeiıtem => item.Title) ), modelin özellik değerleri değerlendirilir. 

@model yönergesi 

@page 

@model RazorPagesMovie.Pages.Movies.IndexModel 

@modei yönergesi, Razor sayfasına geçirilen modelin türünü belirtir. Yukarıdaki örnekte @modei satırı, 

PageModei türetilmiş sınıfı Razor sayfası için kullanılabilir hale getirir. Model, @Htmi.DisplayNameFor ve 
sayfadaki HTML yardımcılarını @Htmi.DispiayFor kullanılır. 

Düzen sayfası 

Menü bağlantılarını (RazorPagesMovie, Homeve Gizlilik) seçin. Her sayfada aynı menü düzeni gösterilir. 
Menü düzeni sayfa/paylaşdan/_Layout. cshtml dosyasında uygulanır. Pages/Shared/_Layout. cshtmi dosyasını 
açın. 

Düzen ŞABLONLARI, HTML kapsayıcı düzeninin şu şekilde olmasını sağlar: 

• Tek bir yerde belirtildi. 

• Sitede birden çok sayfada uygulandı. 

@RenderBody() satırını bulun. RenderBody , tüm sayfaya özgü görünümlerin, Düzen sayfasında kaydırılan bir 
yer tutucudur. Örneğin, Gizlilik bağlantısını seçin ve Sayfalar/gizlilik, cshtml görünümü RenderBody yöntemi 
içinde işlenir. 

VievvData ve Layout 

Pages/filmler/lndex. cshtml dosyasından aşağıdaki biçimlendirmeyi göz önünde bulundurun: 

@page 

@model RazorPagesMovie.Pages.Movies.IndexModel 
@{ 

ViewData["Title"] = "Index"; 

} 

Önceki vurgulanan biçimlendirme, Razor geçişi örneği olan bir örnektir C#. { ve } karakterler bir C# kod 
bloğunu kapsar. 

PageModei temel sınıfı, verileri bir görünüme geçirmek için kullanılabilen bir viewData Dictionary özelliği içerir. 
Nesneler, anahtar/değer düzeniyle viewData sözlüğüne eklenir. Yukarıdaki örnekte, "Title" özelliği viewData 
sözlüğüne eklenir. 

"Title" özelliği sayfa/paylaşılan/_Layout. cshtml dosyasında kullanılır. Aşağıdaki biçimlendirme_/.oyout. 
cshtml dosyasının ilk birkaç satırını gösterir. 




















<!DOCTYPE html> 

<html> 

<head> 

<meta charset="utf-8" /> 

<meta name="viewport" content="width=device-width i initial-scale=1.0" /> 

<title>@ViewData["Title"] - RazorPagesMovie</title> 

@*Mankup removed for brevity.*@ 

Satır @*Markup removed for brevity.*@ bir Razor açıklamadır.HTML yorumlarının ( <!-- --> ) aksine, Razor 
açıklamaları istemciye gönderilmez. 

Düzeni güncelleştirme 

Pages/Shared/_Layout. cshtml dosyasındaki 
şekilde değiştirin. 

<!DOCTYPE html> 
chtml lang="en"> 

<head> 

<meta charset="utf-8" /> 

<meta name="viewport" content="width=device-width J initial-scale=1.0" /> 

<title>@ViewData["Title"] - Movie</title> 


<titie> öğesini RazorPagesMovieyerine filmi görüntüleyecek 


Sayfa/paylaşılan/_Layout. cshtml dosyasında aşağıdaki tutturucu öğeyi bulun. 

<a class="navbar-brand" asp-area="" asp-page="/Index">RazorPagesMovie</a> 

Önceki öğeyi aşağıdaki biçimlendirmeyle değiştirin: 

<a class="navbar-brand" asp-page="/l' / lovies/Index">RpMovie</a> 

Önceki tutturucu öğesi bir etiket yardımcıdır. Bu durumda, bağlantı etiketi yardımcısınınolması gerekir. 
asp-page="/Movies/index" Tag Helper özniteliği ve değeri, /Movies/index Razor sayfasına bir bağlantı 
oluşturur, asp-area öznitelik değeri boş olduğundan, alan bağlantıda kullanılmaz. Daha fazla bilgi için bkz. 
alanlara bakın. 

Değişikliklerinizi kaydedin ve Rpmovie bağlantısına tıklayarak uygulamayı test edin. Herhangi bir sorununuz 
varsa GitHub 'daki Layout. cshtml dosyasına bakın. 

Diğer bağlantıları test edin (giriş, rpmovie, oluşturma, düzenlemeve silme). Her sayfada, tarayıcı 
sekmesinde görebileceğiniz başlık ayarlanır. Bir sayfada yer işareti eklediğinizde başlık, yer işareti için kullanılır. 


NOTE 

Ondalık virgül kullanımı girmeniz mümkün olmayabilir Price alan. Ondalık bir nokta ve ABD İngilizcesi olmayan tarih 
biçimleri için virgül (",") kullanan İngilizce olmayan yerel ayarlarda jOuery doğrulamasını desteklemek için, uygulamanızı 
globalize için adımlar uygulamanız gerekir. Ondalık virgülden ekleme hakkında yönergeler için bkz. GitHub sorunu 4076 


Layout özelliği Pages/_ViewStart. cshtml dosyasında ayarlanır: 


Layout = "_Layout"; 

} 












Yukarıdaki biçimlendirme düzen dosyasını Sayfalar klasörü altındaki tüm Razor dosyaları için 
Sayfalar/paylaşılan/_Layout. cshtml olarak ayarlar. Daha fazla bilgi için bkz. Düzen . 

Sayfa oluştur modeli 

Pages/filmler/Create. cshtml. cs sayfa modelini inceleyin: 

using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using RazorPagesMovie.Models; 
using System; 

using System.Threading.Tasks; 

namespace RazorPagesMovie.Pages.Movies 

{ 

public class CreateModel : PageModel 

{ 

private readonly RazorPagesMovie.Data.RazorPagesMovieContext _context; 

public CreateModel(RazorPagesMovie.Data.RazorPagesMovieContext context) 

{ 

_context = context; 

} 

public IActionResult OnGet() 

{ 

return Page(); 

} 

[BindProperty] 

public Movie Movie { get; set; } 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_context.Movie.Add(Movie); 
await _context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 

} 

} 

onGet yöntemi, sayfa için gereken tüm durumları başlatır. Oluşturma sayfasında başlatılacak durum yok, bu 
nedenle Page döndürülür. Öğreticide daha sonra, OnGet başlatma durumuna bir örnek gösterilir. Page 
yöntemi Create. cshtml sayfasını işleyen bir PageResuit nesnesi oluşturur. 

Movie özelliği, model bağlamayıkabul etmek için [BindProperty] özniteliğini kullanır. Oluşturma formu form 
değerlerini gönderirse, ASP.NET Core çalışma zamanı, postalanan değerleri Movie modeline bağlar. 

onPostAsync yöntemi, sayfa form verileri gönderdiğinde çalıştırılır: 











public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_context. Movie. Add(Movie); 
await _context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 

Herhangi bir model hatası varsa, form, gönderilen tüm form verileriyle birlikte yeniden görüntülenir. Form 
gönderilmeden önce çoğu model hatası istemci tarafında yakalanabilir. Bir model hatasına bir örnek, Date alanı 
için bir tarihe dönüştürülemeyen bir değer gönderme. İstemci tarafı doğrulama ve model doğrulaması 
Öğreticinin ilerleyen kısımlarında ele alınmıştır. 

Model hatası yoksa, veriler kaydedilir ve tarayıcı dizin sayfasına yönlendirilir. 

Razor Oluştur sayfası 

Pages/filmler/Create. cshtml Razor sayfa dosyasını inceleyin: 




@page 

@model RazorPagesMovie.Pages.Movies.CreateModel 

@{ 

ViewData["Title"] = "Create"; 

} 

<hl>Create</hl> 

<h4>Movie</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<div class="form-group"> 

<label asp-for="Movie.Title" class="control-label"x/label> 

<input asp-for="Movie.Title" class="form-control" /> 

<span asp-validation-for="Movie.Title" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Movie.ReleaseDate" class="control-label"x/label> 
cinput asp-for="Movie.ReleaseDate" class="form-control" /> 

<span asp-validation-for="Movie.ReleaseDate" class="text-danger"x/span> 
</div> 

<div class="form-group"> 

<label asp-for="Movie.Genre" class="control-label"x/label> 

<input asp-for="Movie.Genre" class="form-control" /> 

<span asp-validation-for="Movie.Genre" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Movie.Price" class="control-label"x/label> 

<input asp-for="Movie.Price" class="form-control" /> 

<span asp-validation-for="Movie.Price" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<input type="submit" value="Create" class="btn btn-primary" /> 

</div> 

</fonm> 

</div> 

</div> 

<div> 

<a asp-page="Index">Back to List</a> 

</div> 

@section Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 


• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Visual Studio, etiket yardımcıları için kullanılan farklı kalın yazı tipiyle aşağıdaki etiketleri görüntüler: 

• <form method="post"> 

• <div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

• clabel asp-for="Movie.Title" class="control-label"x/label> 

• <input asp-for="Movie.Title" class="form-control" /> 

• <span asp-validation-for="Movie.Title" class="text-danger"x/span> 
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İŞpage 

@model RazorPagesMovie.Pages.Movies. Createl odel 

@{ 

ViewData["Title"] = "Create"; 

i 

<hl>Create</hl> 

<h4>Hovie</h4> 

<hr /> 

E!<div class="row"> 

E <div class="col-md-4''> 

E; <form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<div class="form-group"> 

<label asp-for="Movie.Title" class=”control-label"x/label> 

<input asp-for="Movie.Title" class="fonm-control" /> 

<span asp-validation-for="Movie. Title" class="text-dangen"X/span> 
</div> 

□ ; <div class="form-group"> 

<label asp-for="Hovie. ReleaseDate" class="control-label"X/label> 
cinput asp-for-"Hovie. ReleaseDate" class="form-control" /> 

<span asp-validation-for="Movie .ReleaseDate" class="text-danger"x 
</div> 

□' <div class="form-group"> 

<label asp-for="Hovie.Genre" class="contnol-label"X/label> 

<input asp-for="Hovie.Genre" class="fonn-control" /> 

<span asp-validation-for="Novie.Genre" class="text-danger"x/span> 
</div> 


100% » O No issues found 


<form method="post"> öğesi bir form etiketi yardımcıdır. Form etiketi Yardımcısı, bir antiforgery 
belirteciniotomatik olarak içerir. 

Yapı iskelesi altyapısı, modeldeki her alan için (KİMLİK hariç), aşağıdakine benzer Razor biçimlendirmesi 
oluşturur: 


<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<div class="form-group"> 

<label asp-for="Movie.Title" class="control-label"x/label> 

cinput asp-for="Movie.Title" class="form-control" /> 

cspan asp-validation-for="Movie.Title" class="text-danger"x/span> 

</div> 

Doğrulama etiketi yardımcıları ( <div asp-validation-summary ve cspan asp-validation-fon ) doğrulama 
hatalarını görüntüler. Doğrulama, bu serinin ilerleyen kısımlarında daha ayrıntılı bir şekilde ele alınmıştır. 

Etiket etiketi Yardımcısı ( clabel asp-for="Movie.Title" class="control-label">c/label> ), Title Özelliği için 
etiket başlığını ve for özniteliğini oluşturur. 

Giriş etiketi Yardımcısı ( cinput asp-for="Movie.Title" ciass="form-contnoi"> ), dataaçıklamaların özniteliklerini 
kullanır ve istemci tarafında jQuery doğrulaması için gerekli HTML özniteliklerini üretir. 

cform method="post"> gibi etiket yardımcıları hakkında daha fazla bilgi için bkz.ASP.NET Core etiket 
yardımcıları. 

Ek kaynaklar 


ÖNCEKİ: BİR MODEL 
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Tarafından Rick Anderson 


Bu öğreticide, önceki öğreticidescafkatlama tarafından oluşturulan Razor Pages incelenir. 

Görüntüleme veya indirme örnek. 

Oluşturma, silme, Ayrıntılar ve düzenleme sayfaları 

Pages/filmler/lndex. cshtml. cs sayfa modelini inceleyin: 

using System; 

using System.Collections.Generic; 

using System.Linq; 

using System.Threading.Tasks; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using Microsoft.EntityFrameworkCore; 

using RazorPagesMovie.Models; 

namespace RazorPagesMovie.Pages.Movies 

{ 

public class IndexModel : PageModel 

{ 

private readonly RazorPagesMovie.Models.RazorPagesMovieContext _context; 

public IndexModel(RazorPagesMovie.Models.RazorPagesMovieContext context) 

{ 

_context = context; 

} 

public IList<Movie> Movie { get;set; } 

public async Task OnGetAsync() 

{ 

Movie = await _context.Movie.Tol_istAsync(); 

} 

} 

} 

Razor Pages PageModel türetilir. Kurala göre PageModel türetilmiş sınıf <PageName>Modei olarak adlandırılır. 
Oluşturucu, RazorPagesMovieContext sayfaya eklemek için bağımlılık ekleme işlemini kullanır. Tüm yapı iskelesi 
sayfaları bu düzene uyar. Entity Framevvork zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. 

zaman uyumsuz kod . 

Sayfa için bir istek yapıldığında onGetAsync yöntemi, Razor sayfasına bir film listesi döndürür. onGetAsync 
veya onGet bir Razor sayfasında, sayfanın durumunu başlatmak için çağrılır. Bu durumda, OnGetAsync film 
listesini alır ve görüntüler. 

OnGet void döndürdüğünde veya OnGetAsync"Task döndürürse, hiçbir dönüş yöntemi kullanılmaz. Dönüş 
türü iActionResuit veya Task<iActionResuit> olduğunda, return ifadesinin sağlanması gerekir. Örneğin, 
Pages/filmler/Create. cshtml. cs onPostAsync yöntemi: 
















public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_context. Movie. Add(Movie); 
await _context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 

Pages/filmler/lndex. cshtml Razor sayfasını inceleyin: 



@page 

@model RazorPagesMovie.Pages.Movies.IndexModel 

@{ 

ViewData["Title"] = "Index"; 

} 

<hl>Index</hl> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

ctable class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model => model.Movie[0].Title) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movie[0].ReleaseDate) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movie[0].Genre) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movie[0].Price) 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model.Movie) { 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.ReleaseDate) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Genre) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Price) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID">Details</a> | 

<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 

Razor, HTML 'den C# ya da Razor 'e özgü biçimlendirmeye geçiş yapabilir. Bir @ sembol sonrasında Razor 
ayrılmış bir anahtar sözcükolduğunda, bu , 1 a geçiş yapar C#. 

@page Razor yönergesi, dosyayı bir MVC eylemine dönüştürür, bu da istekleri işleyebileceği anlamına gelir. 
@page sayfadaki ilk Razor yönergesi olmalıdır. @page , Razor 'e özgü biçimlendirmeye geçme örneğidir. Daha 
fazla bilgi için bkz. Razor söz dizimi . 


Aşağıdaki HTML Yardımcısı 'nda kullanılan lambda ifadesini inceleyin: 





@Html.DisplayNameFor(model => model.Movie[0].Title) 

DisplayNameFor HTML Yardımcısı, görünen adı belirlemede lambda ifadesinde başvurulan Title özelliğini 
inceler. Lambda ifadesi değerlendirilmek yerine incelenir. Bu, model, model.Movie veya model. Movie[0] nuiı 
veya boş olduğunda herhangi bir erişim ihlali olmadığı anlamına gelir. Lambda ifadesi değerlendirildiğinde 
(örneğin, @Htmi.DispiayFor(modeiıtem => item.Title) ), modelin özellik değerleri değerlendirilir. 

@model yönergesi 

@page 

@model RazorPagesMovie.Pages.Movies.IndexModel 

@modei yönergesi, Razor sayfasına geçirilen modelin türünü belirtir. Yukarıdaki örnekte @modei satırı, 
PageModei türetilmiş sınıfı Razor sayfası için kullanılabilir hale getirir. Model, @Htmi.DisplayNameFor ve 
sayfadaki HTML yardımcılarını @Htmi.DispiayFor kullanılır. 

Düzen sayfası 

Menü bağlantılarını (RazorPagesMovie, Homeve Gizlilik) seçin. Her sayfada aynı menü düzeni gösterilir. 
Menü düzeni sayfa/paylaşdan/_Layout. cshtml dosyasında uygulanır. Pages/Shared/_Layout. cshtmi dosyasını 
açın. 

Düzen şablonları, sitenizin HTM L kapsayıcı yerleşimini tek bir yerde belirtmenize ve sonra sitenizdeki birden 
çok sayfaya uygulamanıza olanak tanır. @RenderBody() satırını bulun. RenderBody , oluşturduğunuz tüm sayfaya 
özgü görünümlerin, Düzen sayfasında kaydırılan bir yer tutucudur. Örneğin, Gizlilik bağlantısını seçerseniz, 
Sayfa/Gizlilik, cshtml görünümü RenderBody yöntemi içinde işlenir. 

VievvData ve Layout 

Pages/filmler/lndex. cshtml dosyasından aşağıdaki kodu göz önünde bulundurun: 

@page 

@model RazorPagesMovie.Pages.Movies.IndexModel 
@{ 

ViewData["Title"] = "Index"; 

} 

Önceki vurgulanan kod, Razor geçişi örneği olan bir örnektir C#. { ve } karakterler bir C# kod bloğunu 
kapsar. 

PageModei temel sınıfında, bir görünüme geçirmek istediğiniz verileri eklemek için kullanılabilecek bir 
viewData Dictionary özelliği vardır. Bir anahtar/değer düzeniyle viewData sözlüğüne nesne eklersiniz. 
Yukarıdaki örnekte, "title" özelliği viewData sözlüğüne eklenir. 

"Title" özelliği sayfa/paylaşılan/_Layout. cshtml dosyasında kullanılır. Aşağıdaki biçimlendirme _Layout. cshtml 
dosyasının ilk birkaç satırını gösterir. 

<!DOCTYPE html> 

<html> 

<head> 

cmeta charset="utf-8" /> 

cmeta name="viewport" content="width=device-width, initial-scale=1.0" /> 

<title>@ViewData["Title"] - RazorPagesMovie</title> 

@*Markup removed for brevity.*@ 




















Satır @*Markup removed for brevity. *@ , düzen dosyanızda görünmeyen bir Razor açıklamadır. HTML 
yorumlarının ( <!-- --> ) aksine, Razor açıklamaları istemciye gönderilmez. 

Düzeni güncelleştirme 

Pages/Shared/_Layout. cshtml dosyasındaki <titie> öğesini RazorPagesMovieyerine filmi görüntüleyecek 
şekilde değiştirin. 

<!DOCTYPE html> 

<html> 

<head> 

cmeta charset="utf-8" /> 

cmeta name="viewport" content="width=device-width, initial-scale=1.0" /> 

<title>@ViewData["Title"] - Movie</title> 

Sayfa/paylaşılan/_Layout. cshtml dosyasında aşağıdaki tutturucu öğeyi bulun. 

<a class="navbar-brand" asp-area="" asp-page="/Index">RazorPagesMovie</a> 

Önceki öğeyi aşağıdaki biçimlendirme ile değiştirin. 

<a class="navbar-brand" asp-page="/f / lovies/Index">RpMovie</a> 

Önceki tutturucu öğesi bir etiket yardımcıdır. Bu durumda, bağlantı etiketi yardımcısınınolması gerekir. 
asp-page="/Movies/index" Tag Helper özniteliği ve değeri, /Movies/index Razor sayfasına bir bağlantı 
oluşturur, asp-area öznitelik değeri boş olduğundan, alan bağlantıda kullanılmaz. Daha fazla bilgi için bkz. 
alanlara bakın. 

Değişikliklerinizi kaydedin ve Rpmovie bağlantısına tıklayarak uygulamayı test edin. Herhangi bir sorununuz 
varsa GitHub 'daki ^Layout. cshtml dosyasına bakın. 

Diğer bağlantıları test edin (giriş, rpmovie, oluşturma, düzenlemeve silme). Her sayfada, tarayıcı 
sekmesinde görebileceğiniz başlık ayarlanır. Bir sayfada yer işareti eklediğinizde başlık, yer işareti için kullanılır. 


NOTE 

Ondalık virgül kullanımı girmeniz mümkün olmayabilir Price alan. Ondalık bir nokta ve ABD İngilizcesi olmayan tarih 
biçimleri için virgül (",") kullanan İngilizce olmayan yerel ayarlarda jOuery doğrulamasını desteklemek için, uygulamanızı 
globalize için adımlar uygulamanız gerekir. Bu GitHub, ondalık virgülden ekleme hakkında yönergeler için 4076 sorun . 


Layout özelliği Pages/_ViewStart. cshtml dosyasında ayarlanır: 

Layout = "_Layout"; 

} 

Yukarıdaki biçimlendirme düzen dosyasını Sayfalar klasörü altındaki tüm Razor dosyaları için 
Sayfalar/paylaşılan/_Layout. cshtml olarak ayarlar. Daha fazla bilgi için bkz. Düzen . 

Sayfa oluştur modeli 

Pages/filmler/Create. cshtml. cs sayfa modelini inceleyin: 









// Unused usings removed. 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using RazorPagesMovie.Models; 

using System; 

using System.Threading.Tasks; 

namespace RazorPagesMovie.Pages.Movies 

{ 

public class CreateModel : PageModel 

{ 

private readonly RazorPagesMovie.Models.RazorPagesMovieContext _context; 

public CreateModel(RazorPagesMovie.Models.RazorPagesMovieContext context) 

{ 

_context = context; 

} 

public IActionResult OnGet() 

{ 

return Page(); 

} 

[BindProperty] 

public Movie Movie { get; set; } 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_context. Movie. Add (Movie); 
await _context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 

} 

} 


onGet yöntemi, sayfa için gereken tüm durumları başlatır. Oluşturma sayfasında başlatılacak durum yok, bu 
nedenle Page döndürülür. Öğreticide daha sonra OnGet yöntemi başlatma durumunu görürsünüz. Page 
yöntemi Create. cshtml sayfasını işleyen bir PageResuit nesnesi oluşturur. 

Movie özelliği, model bağlamayıkabul etmek için [BindProperty] özniteliğini kullanır. Oluşturma formu form 
değerlerini gönderirse, ASP.NET Core çalışma zamanı, postalanan değerleri Movie modeline bağlar. 

onPostAsync yöntemi, sayfa form verileri gönderdiğinde çalıştırılır: 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_context.Movie.Add(Movie); 
await _context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 










Herhangi bir model hatası varsa, form, gönderilen tüm form verileriyle birlikte yeniden görüntülenir. Form 
gönderilmeden önce çoğu model hatası istemci tarafında yakalanabilir. Bir model hatasına bir örnek, Date alanı 
için bir tarihe dönüştürülemeyen bir değer gönderme. İstemci tarafı doğrulama ve model doğrulaması 
Öğreticinin ilerleyen kısımlarında ele alınmıştır. 

Model hatası yoksa, veriler kaydedilir ve tarayıcı dizin sayfasına yönlendirilir. 

Razor Oluştur sayfası 

Pages/filmler/Create. cshtml Razor sayfa dosyasını inceleyin: 

@page 

@model RazorPagesMovie.Pages.Movies.CreateModel 

@{ 

ViewData["Title"] = "Create"; 

} 

<hl>Create</hl> 

<h4>Movie</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<div class="form-group"> 

<label asp-for="Movie.Title" class="control-label"x/label> 

<input asp-for="Movie.Title" class="form-control" /> 

<span asp-validation-for="Movie.Title" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Movie.ReleaseDate" class="control-label"x/label> 

<input asp-for="Movie.ReleaseDate" class="form-control" /> 

<span asp-validation-for="Movie.ReleaseDate" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Movie.Genre" class="control-label"x/label> 

<input asp-for="Movie.Genre" class="form-control" /> 

<span asp-validation-for="Movle.Genre" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Movie.Price" class="control-label"x/label> 

<input asp-for="Movie.Price" class="form-control" /> 

<span asp-validation-for="Movie.Price" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<input type="submit" value="Create" class="btn btn-prlmary" /> 

</div> 

</form> 

</div> 

</div> 

<div> 

<a asp-page="Index">Back to List</a> 

</div> 

@section Scripts { 

@{await Html.RenderPartialAsync("_ValldatlonScriptsPartlal");} 

} 


• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 




Visual Studio, etiket yardımcıları için kullanılan farklı kalın yazı tipiyle <form method="post"> etiketini 
görüntüler: 


Create.cshtml.es 


1 

2 

3 

4 

5 

e 

7 

S 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

100 % - 


_ Create.cshtml -o X | 

@page 

(Bmodel RazorPagesMovie.Pages_ttovie.C-ea o e "c del 


@{ 


ViewData["Title"] = "Create"; 


<h2>Create</h2> 

<h4>Movie</h4> 

<hr /> 

Bediv class="row"> 

B <div class=”col-md-4"> 

B eform method="post”> 

B The form element represents a collection of form-associated elements, some of which can represent editable 
values that can be submitted to a server for processing. 

Learn more (Fi) 


Microsoft.AspNetCore.Mvc.TagHelpers.^ormTagHelper 
Microsoft.AspNetCore.Razor.TagHelpers. TagHelpe implementation targeting <form> elements. 

<span asp-validation-for="Movie. ReleaseDate" class="text-danger” 
</div> 

B <div class="form-group”> 

elabel asp-for="Movie.Genre" class="control-label"x/label> 
cinput asp-for="Movie.Genre" class=''form-control" /> 
espan asp-validation-for="Movie.Genre" class="text-danger”x/spa 
</div> 

El <div class=''form-group''> 

elabel asp-for="Movie.Price" class="control-label"x/label> 
cinput asp-for="Movie.Price" class="form-control" /> 
espan asp-validation-for="Movie.Price" class="text-danger”>e/spa 
e/div> 

El ediv class="form-group"> 

cinput type="submit" value=”Create" class="btn btn-default” /> 
e/div> 
e/fortn> 
e/div> 

^ Rick Anderson, 4days ago I 1 author, 1 change I lworkitem i ► 


eform method="post"> öğesi bir form etiketi yardımcıdır. Form etiketi Yardımcısı, bir antiforgery 
belirteciniotomatik olarak içerir. 


Yapı iskelesi altyapısı, modeldeki her alan için (KİMLİK hariç), aşağıdakine benzer Razor biçimlendirmesi 
oluşturur: 

ediv asp-validation-summary="ModelOnly" class="text-danger"x/div> 
ediv class="form-group"> 

elabel asp-for="Movie.Title" class="control-label"x/label> 
cinput asp-for="Movie.Title" class="form-control" /> 
espan asp-validation-for="Movie.Title" class="text-danger">e/span> 
e/div> 

Doğrulama etiketi yardımcıları ( ediv asp-validation-summary ve espan asp-validation-for ) doğrulama 
hatalarını görüntüler. Doğrulama, bu serinin ilerleyen kısımlarında daha ayrıntılı bir şekilde ele alınmıştır. 


Etiket etiketi Yardımcısı ( elabel asp-fon="Movie.Title" class="control-label">e/label> ), Title Özelliği için 
etiket başlığını ve for özniteliğini oluşturur. 


Giriş etiketi Yardımcısı ( cinput asp-for="Movie.ntie" ciass="form-controi"> ), dataaçıklamaların özniteliklerini 


kullanır ve istemci tarafında jQuery doğrulaması için gerekli HTML özniteliklerini üretir. 




















Ek kaynaklar 

• Bu öğreticinin YouTube sürümü 
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Veritabanı ve ASRNET Core çalışma 

23.11.2019 * 20 minutes to read ı Edit Online 


Tarafından Rick Anderson ve ALİ Audette 
Örnek kodu görüntüle veya indir (indirme). 

Örnek kodu görüntüle veya indir (indirme). 

RazorPagesMovieContext nesnesi veritabanına bağlanma ve Movie nesneleri veritabanı kayıtlarına eşleme 
görevini işler. Veritabanı bağlamı, Sfortup.csiçindeki configureServices yönteminde bağımlılık ekleme 
kapsayıcısına kaydedilir: 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRazorPages(); 

Services.AddDbContext<RazorPagesMovieContext>(options => 

options. UseSqlServer (Conf iguration. GetConnectionString(" RazorPagesMovieContext"))); 

} 

AS P.N ET Core yapılandırma sistemi Connectionstring okur. Yerel geliştirme için, appSettings. JSON 
dosyasından bağlantı dizesini alır. 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

Veritabanı ( Database={Database name} ) için ad değeri, oluşturulan kodunuz için farklı olacaktır. Ad değeri 
rastgele. 

{ 

"Logging": { 

"LogLevel": { 

"Default": "Information", 

"Microsoft": "Warning", 

"Microsoft.Hoşting.Lifetime": "Information" 

} 

b 

"AllowedHosts": 

"ConnectionStrings": { 

"RazorPagesMovieContext": "Server=(localdb)\\mssqllocaldb;Database=RazorPagesMovieContext- 
bc;Trusted_Connection=True;MultipleActiveResultSets=true" 

} 

} 

Uygulama bir test veya üretim sunucusuna dağıtıldığında, bağlantı dizesini gerçek bir veritabanı sunucusuna 
ayarlamak için bir ortam değişkeni kullanılabilir. Daha fazla bilgi için bkz. yapılandırma . 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 










SQL Server Express LocalDB 

LocalDB, program geliştirmeye yönelik SQL Server Express veritabanı altyapısının hafif bir sürümüdür. 

LocalDB, isteğe bağlı olarak başlar ve karmaşık yapılandırma olduğundan kullanıcı modunda çalışır.Varsayılan 

olarak, LocalDB veritabanı c:\users\<user>\ dizininde *.mdf dosyaları oluşturur. 

• Görünüm menüsünden SQL Server Nesne Gezgini (ssox) öğesini açın. 

RazorPagesMovie - Microsoft Visual Studio 
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• Movie tabloya sağ tıklayıp Görünüm Tasarımcısı 1 nı seçin: 


SQL Server Object Explorer ^ X 
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id yanındaki anahtar simgesine göz önünde edin. Varsayılan olarak, EF birincil anahtar için id adlı bir özellik 
oluşturur. 

• Movie tabloya sağ tıklayın ve verileri görüntüle' yi seçin: 



Veritabanının çekirdeğini oluşturma 


Modeller klasöründe aşağıdaki kodla seedData adlı yeni bir sınıf oluşturun: 





















using Microsoft.EntityFrameworkCore; 

using Microsoft. Extensions.Dependencylnjectionj 

using RazorPagesMovie.Data; 

using System; 

using System.Linq; 

namespace RazorPagesMovie.Models 

{ 

public static class SeedData 

{ 

public static void Initialize(IServiceProvider serviceProvider) 

{ 

using (var context = new RazorPagesMovieContext( 
serviceProvider.GetRequiredService< 

DbContextOptions<RazorPagesMovieContext>>())) 

{ 

// Look for any movies. 
if (context.Movie.Any()) 

{ 

return; // DB has been seeded 

} 

context.Movie.AddRange( 
new Movie 
{ 

Title = "When Harry Met Sally", 

ReleaseDate = DateTime.Parse("1989-2-12"), 

Genre = "Romantic Comedy", 

Price = 7.99M 

}, 

new Movie 

{ 

Title = "Ghostbusters ", 

ReleaseDate = DateTime.Parse("1984-3-13"), 

Genre = "Comedy", 

Price = 8.99M 

}, 

new Movie 

{ 

Title = "Ghostbusters 2 ", 

ReleaseDate = DateTime.Parse("1986-2-23"), 

Genre = "Comedy", 

Price = 9.99M 

b 

new Movie 

{ 

Title = "Rio Bravo", 

ReleaseDate = DateTime.Parse("1959-4-15"), 

Genre = "Western", 

Price = 3.99M 

} 

); 

context.SaveChanges(); 

} 

} 

} 

} 


VERITABANıN DA herhangi bir film varsa, tohum başlatıcısı döner ve hiçbir film eklenmez. 



if (context.Movie.Any()) 

{ 

return; // DB has been seeded. 

} 


Tohum başlatıcısı ekleme 

İçinde Program.es, değişiklik Main yöntemi aşağıdakileri yapmak için: 

• Bir DB bağlamı örneği bağımlılık ekleme kapsayıcısını alın. 

• Temel yöntemi çağırın ve bu yönteme geçerek bağlamı geçer. 

• Çekirdek yöntemi tamamlandığında bağlamı atın. 

Aşağıdaki kod güncelleştirilmiş gösterir Program.es dosya. 

using Microsoft.AspNetCore.Hosting; 

using Microsoft. Extensions.Dependencylnjection; 

using Microsoft. Extensions .Hosting; 

using Microsoft. Extensions. Logging; 

using RazorPagesMovie.Models; 

using System; 

namespace RazorPagesMovie 

{ 

public elass Program 

{ 

public static void Main(string[] args) 

{ 

var hoşt = CreateHostBuilder(args).Build(); 

using (var scope = hoşt.Services.CreateScope()) 

{ 

var Services = scope.ServiceProvider; 

try 

{ 

SeedData.Initialize(Services); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<ILogger<Program>>(); 
logger.LogError(ex, "An error occurred seeding the DB."); 

} 

} 

hoşt.Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

. ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 

} 

} 

update-Database çalıştırılmayan aşağıdaki özel durum oluşur: 


SqlException: Cannot öpen database 

"RazorPagesMovieContext-" requested by the login. The login failed. 

Login failed for user ’user name'. 





Uygulamayı test etme 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

• VERITABANıNDAKI tüm kayıtları silin. Bunu, tarayıcıda veya Ssox 'ten silme bağlantılarıyla 
yapabilirsiniz 

• Çekirdek yöntemin çalışması için uygulamayı başlamaya zorlayın ( startup sınıfında yöntemleri 
çağırın). Başlatmayı zorlamak için 11S Express durdurulup yeniden başlatılması gerekir. Bunu aşağıdaki 
yaklaşımlardan biriyle yapabilirsiniz: 

o Bildirim alanında MS Express sistem tepsisi simgesine sağ tıklayın ve Çıkış veya siteyi durdur' a 
dokunun: 

_ES Express ı 


View Sites 

RazorPagesMovie ► 



Show Ali Applications 



Exit 

Ll 

100% 

Mew\1\D... & ^ S 

tik 

HJ 



o VS hata ayıklama modunda çalıştırıyorsanız, hata ayıklama modunda çalıştırmak için F5 
tuşuna basın. 

o İle hata ayıklama modunda çalıştırıyorsanız, hata ayıklayıcıyı durdurun ve F5 tuşuna basın. 
Sonraki öğreticide, verilerin sunumu gelişmeyecektir. 

Ek kaynaklar 


ÖNCEKİ: YAPI İSKELESİ RAZOR 
PAG ES 




İLERİ: SAYFALARI 
GÜNCELLEŞTIRM E 


Örnek kodu görüntüle veya indir (indirme). 

Örnek kodu görüntüle veya indir (indirme). 

RazorPagesMovieContext nesnesi veritabanına bağlanma ve Movie nesneleri veritabanı kayıtlarına eşleme 
görevini işler. Veritabanı bağlamı, Sfortup.csiçindeki configureServices yönteminde bağımlılık ekleme 
kapsayıcısına kaydedilir: 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 





















// This method gets called by the runtime. 

// Use this method to add Services to the Container, 
public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

// This lambda determines whether user consent for non-essential cookies is 
// needed for a given request. 
options.CheckConsentNeeded = context => truej 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

Services.AddDbContext<RazorPagesMovieContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("RazorPagesMovieContext"))); 

} 

configureServices ' de kullanılan yöntemler hakkında daha fazla bilgi için bkz.: 

• cookiePoücyOptions için ASP.NET Core ab genel veri koruma yönetmeliği (GDPR) desteği. 

• SetCompatibilityVersion 

AS P.N ET Core yapılandırma sistemi Connectionstring okur. Yerel geliştirme için, appSettings. JSON 
dosyasından bağlantı dizesini alır. 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Veritabanı ( Database={Database name} ) için ad değeri, oluşturulan kodunuz için farklı olacaktır. Ad değeri 
rastgele. 

{ 

"Logging": { 

"LogLevel": { 

"Default": "Warning" 

} 

}, 

"AllowedHosts": "*"> 

"ConnectionStrings": { 

"RazorPagesMovieContext": "Server=(localdb)\\mssqllocaldb;Database=RazorPagesMovieContext- 
1234;Trusted_Connection=True;MultipleActiveResultSets=true" 

} 

} 


Uygulama bir test veya üretim sunucusuna dağıtıldığında, bağlantı dizesini gerçek bir veritabanı sunucusuna 
ayarlamak için bir ortam değişkeni kullanılabilir. Daha fazla bilgi için bkz. yapılandırma . 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

SQL Server Express LocalDB 

LocalDB, program geliştirmeye yönelik SQL Server Express veritabanı altyapısının hafif bir sürümüdür. 
LocalDB, isteğe bağlı olarak başlar ve karmaşık yapılandırma olduğundan kullanıcı modunda çalışır.Varsayılan 
olarak, LocalDB veritabanı c:/users/<user/> dizininde *.mdf dosyaları oluşturur. 







Görünüm menüsünden SQL Server Nesne Gezgini (ssox) öğesini açın. 
RazorPagesMovie - Microsoft Visual Studio 
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• Movie tabloya sağ tıklayıp Görünüm Tasarımcısı 1 nı seçin: 
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id yanındaki anahtar simgesine göz önünde edin. Varsayılan olarak, EF birincil anahtar için id adlı bir özellik 
oluşturur. 

• Movie tabloya sağ tıklayın ve verileri görüntüle' yi seçin: 



Veritabanının çekirdeğini oluşturma 


Modeller klasöründe aşağıdaki kodla seedData adlı yeni bir sınıf oluşturun: 





















using Microsoft.EntityFrameworkCore; 
using Microsoft. Extensions.Dependencylnjectionj 
using System; 
using System.Linq; 

namespace RazorPagesMovie.Models 

{ 

public static class SeedData 

{ 

public static void Initialize(IServiceProvider serviceProvider) 

{ 

using (var context = new RazorPagesMovieContext( 
serviceProvider.GetRequiredService< 

DbContextOptions<RazorPagesMovieContext>>())) 

{ 

// Look for any movies. 
if (context.Movie.Any()) 

{ 

return; // DB has been seeded 

} 

context.Movie.AddRange( 
new Movie 
{ 

Title = "When Harry Met Sally", 

ReleaseDate = DateTime.Parse("1989-2-12"), 

Genre = "Romantic Comedy", 

Price = 7.99M 

b 

new Movie 

{ 

Title = "Ghostbusters ", 

ReleaseDate = DateTime.Parse("1984-3-13"), 

Genre = "Comedy", 

Price = 8.99M 

b 

new Movie 

{ 

Title = "Ghostbusters 2", 

ReleaseDate = DateTime.Parse("1986-2-23")j 
Genre = "Comedy", 

Price = 9.99M 

b 

new Movie 

{ 

Title = "Rio Bravo"j 

ReleaseDate = DateTime.Parse("1959-4-15")j 
Genre = "l/Jestern", 

Price = 3.99M 

} 

); 

context.SaveChanges(); 

} 

} 

} 

} 


VERITABANıN DA herhangi bir film varsa, tohum başlatıcısı döner ve hiçbir film eklenmez. 



if (context.Movie.Any()) 

{ 

return; // DB has been seeded. 

} 


Tohum başlatıcısı ekleme 

İçinde Program.es, değişiklik Main yöntemi aşağıdakileri yapmak için: 

• Bir DB bağlamı örneği bağımlılık ekleme kapsayıcısını alın. 

• Temel yöntemi çağırın ve bu yönteme geçerek bağlamı geçer. 

• Çekirdek yöntemi tamamlandığında bağlamı atın. 


Aşağıdaki kod güncelleştirilmiş gösterir Program.es dosya. 


using Microsoft.AspNetCore; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft. Extensions .Dependencylnjection; 

using Microsoft. Extensions. Logging; 

using RazorPagesMovie.Models; 

using System; 

using Microsoft.EntityFrameworkCore; 

namespace RazorPagesMovie 

{ 

public elass Program 

{ 

public static void Main(string[] args) 

{ 

var hoşt = CreateWebHostBuilder(args).Build(); 

using (var scope = hoşt.Services.CreateScope()) 

{ 

var Services = scope.ServiceProvider; 


try 

{ 

var context=services. 

GetRequiredService<RazorPagesMovieContext>(); 
context.Database.Migrate(); 

SeedData.Initialize(Services); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<ILogger<Program>>(); 
logger.LogError(ex, "An error occurred seeding the DB."); 

} 


host.Run(); 

} 


} 


} 


public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 
WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>(); 


Bir üretim uygulaması Database.Migrate çağırmaz. update-Database çalıştırılmadığından aşağıdaki özel 
durumu engellemek için yukarıdaki koda eklenir: 


SqlException: oturum açma tarafından istenen "RazorPagesMovieContext-21" veritabanı açılamıyor.Oturum 
açılamadı.' Kullanıcı adı' kullanıcısı için oturum açma başarısız. 





Uygulamayı test etme 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• VERITABANıNDAKI tüm kayıtları silin. Bunu, tarayıcıda veya Ssox 'ten silme bağlantılarıyla 
yapabilirsiniz 

• Çekirdek yöntemin çalışması için uygulamayı başlamaya zorlayın ( startup sınıfında yöntemleri 
çağırın). Başlatmayı zorlamak için 11S Express durdurulup yeniden başlatılması gerekir. Bunu aşağıdaki 
yaklaşımlardan biriyle yapabilirsiniz: 

o Bildirim alanında IIS Express sistem tepsisi simgesine sağ tıklayın ve Çıkış veya siteyi durdur' a 
dokunun: 


ÜS Express 



ViewSites 

RazorPagesMovie ► 



Show Ali Applications 



Exit 

[ + 

100% 

SJew\1\D... £ A rj 

tu 

5J 


o VS hata ayıklama modunda çalıştırıyorsanız, hata ayıklama modunda çalıştırmak için F5 
tuşuna basın. 

o İle hata ayıklama modunda çalıştırıyorsanız, hata ayıklayıcıyı durdurun ve F5 tuşuna basın. 
Uygulama, sağlanan verileri gösterir: 

- □ x 

| lndex - Movie x + 

C A https://localhost:5001/Movies 0 : 

RpMoVİe Home Privacy 

lndex 

Create New 


Title 

ReleaseDate 

Genre 

Price 


When Harry Met Sally 

2/12/1989 

Romantic Comedy 

7.99 

Edit | Details | Delete 

Ghostbusters 

3/13/1984 

Comedy 

8.99 

Edit | Details | Delete 

Ghostbusters 2 

2/23/1986 

Comedy 

9.99 

Edit | Details | Delete 

Rio Bravo 

4/15/1959 

VVestern 

3.99 

Edit | Details | Delete 

The Good, the bad, and the ugly 

12/1/2018 

VVestern 

1.19 

Edit | Details | Delete 
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Sonraki öğretici, verilerin sunumunu temizler. 


















Ek kaynaklar 

• Bu öğreticinin YouTube sürümü 


ÖNCEKİ: YAPI İSKELESİ RAZOR 
PAGES 


İLERİ: SAYFALARI 
GÜNCELLEŞTIRM E 






ASRNET Core uygulamasında oluşturulan sayfalan 
güncelleştirme 

23.11.2019 • 14 minutes to read ı Edit Online 


Tarafından Rick Anderson 

Yapı iskelesi film uygulamasının iyi bir başlangıcı vardır ancak sunum ideal değildir. ReleaseDate Yayın tarihi 
(iki sözcük) olmalıdır. 

| lndex - Movie x + 

C i https://localhost:5001/Movies 

RpMovİe Home Privacy 

lndex 

Create New 


Title 

ReleaseDate 

Genre 

Price 


When Harry Met Sally 

2/12/1989 

Romantic Comedy 

7.99 

Edit | Details | Delete 

Ghostbusters 

3/13/1984 

Comedy 

8.99 

Edit | Details | Delete 

Ghostbusters 2 

2/23/1986 

Comedy 

9.99 

Edit | Details | Delete 

Rio Bravo 

4/15/1959 

VVestern 

3.99 

Edit | Details | Delete 

The Good, the bad, and the ugly 

12/1/2018 

VVestern 

1.19 

Edit | Details | Delete 
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Oluşturulan kodu Güncelleştir 


Modeller/film. cs dosyasını açın ve aşağıdaki kodda gösterilen vurgulanmış satırları ekleyin: 






using System; 

using System.ComponentModel.DataAnnotations; 
using System.ComponentModel.DataAnnotations.Schema; 

namespace RazorPagesMovie.Models 
{ 

public class Movie 

{ 

public int ID { get; set; } 
public string Title { get; set; } 

[Display(Name = "Release Date")] 

[DataType(DataType.Date)] 

public DateTime ReleaseDate { get; set; } 

public string Genre { get; set; } 

[Column(TypeName = "decimal(18, 2)")] 
public decimal Price { get; set; } 

} 

} 

[Coiumn(TypeName = "decimai(i8, 2 )")] veri ek açıklaması, Entity Framevvork Core veritabanında Price para 
birimine doğru şekilde eşlemesine olanak sağlar. Daha fazla bilgi için bkz. veri türleri. 

Veri açıklamaları sonraki öğreticide ele alınmıştır. Display özniteliği bir alanın adı için (Bu durumda 
"ReleaseDate" yerine "Yayın tarihi") görüntüleneceğini belirtir. DataType özniteliği verilerin türünü belirtir 
(Tarih), bu nedenle alanda depolanan zaman bilgileri gösterilmez. 


Hedef URL 'yi görmek için sayfalara/filmlere gidin ve bir düzenleme bağlantısının üzerine gelin. 


| lndex - Movie x + 

— 

□ X 

4- C i https://localhost:5001/Movies 


Ö i 

RpMoVİe Home Privacy 


■ 


Index 

Create New 


Title 

Release Date 

Genre 

Price 



When Harry Met Sally 

2/12/1989 

Romantic Comedy 

7.99 

Edit | Details 

Delete 

Ghostbusters 

3/13/1984 

Comedy 

8.99 

£diî| Details 

Delete 

Ghostbusters 2 

2/23/1986 

Comedy 

9.99 

Edit | Details 

Delete 

Rio Bravo 

4/15/1959 

Western 

3.99 

Edit | Details 

Delete 


_ ?niQ - RaTnıPanBtMnuia - Prjvacy 

httpşj//jocalhoştS001/Movleş/Edlt?id = 3j 


Düzenle, Ayrıntılarve Sil bağlantıları, Sayfa la r/film ler/lndex. cshtmt dosyasındaki tutturucu etiketi Yardımcısı 
tarafından oluşturulur. 















(Şforeach (var item in Model.Movie) { 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.ReleaseDate) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Genre) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Price) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID">Details</a> | 

<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 


Etiket Yardımcıları, Razor dosyalarında HTML öğelerinin oluşturulmasına ve işlenmesine sunucu tarafı kodun 
katılmasını etkinleştir. Yukarıdaki kodda AnchorTagHelper , Razor sayfasından (yol göreli), asp-page ve yol 
kimliği ( asp-route-id ) HTM L href öznitelik değerini dinamik olarak oluşturur. Daha fazla bilgi için bkz. 

Sayfalar İçin URL oluşturma . 

Oluşturulan biçimlendirmeyi incelemek için sık kullandığınız tarayıcıdan Görünüm kaynağını kullanın. 
Oluşturulan HTML 'nin bir bölümü aşağıda gösterilmiştir: 

<td> 

<a href="/Movies/Edit?id=l">Edit</a> | 

<a href="/Movies/Details?id=l">Details</a> | 

<a href="/Movies/Delete?id=l">Delete</a> 

</td> 

Dinamik olarak oluşturulan bağlantılar, film KİMLİĞİNİ bir sorgu dizesiyle (örneğin, 
https://localhost: 5001/Movies/Details?id=l'' ?ld=l ) iletir. 

Rota şablonu Ekle 

"(id: int}" yol şablonunu kullanmak için Düzenle, Ayrıntılar ve Sil Razor Pages güncelleştirin. Bu sayfaların her 
biri için Page yönergesini @page "{id:int}"''@page değiştirin. Uygulamayı çalıştırın ve kaynağı görüntüleyin. 
Oluşturulan HTML, URL 'nin yol bölümüne KİMLİĞİ ekler: 

<td> 

<a hnef="/Movles/Edit/l">Edlt</a> | 

<a href="/Movies/Details/l">Details</a> | 

<a href="/Movies/Delete/l">Delete</a> 

</td> 


Tamsayıyı içermeyen " {id: int}" yol şablonuna sahip sayfaya yönelik bir İstek, HTTP 404 (bulunamadı) hatası 
döndürüyor. Örneğin, http://iocaihost:5000/Movies/Detaiis bir 404 hatası döndürür. KİMLİĞİ isteğe bağlı 
yapmak için ? yol kısıtlamasına ekleyin: 

@page "{id:int?}" 











@page "{id:int?}" davranışını test etmek için: 


• Pages/filmler/detalis. cshtml içindeki page yönergesini @page "{id:int?}" olarak ayarlayın. 

• pubiic async Task<iActionResuit> 0nGetAsync(int? id) ( sayfalarda/filmlerde/details. cshtml. cs) bir kesme 
noktası ayarlayın. 

• https://test-cors.org sayfasına gidin. 

@page "{id:int}" yönergesi ile, kesme noktası hiçbir şekilde vurılmaz. Yönlendirme Altyapısı HTTP 404 
döndürür. @page "{id:int?}" kullanarak onGetAsync yöntemi NotFound (HTTP 404) döndürür. 

Eşzamanlılık özel durum işlemeyi gözden geçirme 

Pages/fiimier/Edit. cshtml. cs dosyasındaki onPostAsync yöntemini gözden geçirin: 

pubiic async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

retunn Page(); 

} 

_context.Attach(Movie).State = EntityState.Modified; 

try 

{ 

await _context.SaveChangesAsync(); 

} 

catch (DbUpdateConcurrencyException) 

{ 

if (!MovieExists(Movie.ID)) 

{ 

retunn NotFound(); 

} 

else 

{ 

throw; 

} 

} 

return RedirectToPage("./Index"); 

} 

private bool MovieExists(int id) 

{ 

return _context.Movie.Any(e = > e.ID == id); 

} 

Önceki kod, bir istemci filmi sildiği ve diğer istemci filmle değişiklik yaptığı zaman eşzamanlılık özel 
durumlarını algılar. 

catch bloğunu test etmek için: 

• catch (DbupdateConcurrencyException) kesme noktası ayarlama 

• Film için Düzenle 1 yi seçin, değişiklikler yapın, ancak Kaydet 1 i girmeyin. 

• Başka bir tarayıcı penceresinde, aynı filmin Sil bağlantısını seçin ve ardından filmi silin. 

• Önceki tarayıcı penceresinde filmdeki değişiklikleri gönderin. 

Üretim kodu eşzamanlılık çakışmalarını algılamak isteyebilir. Daha fazla bilgi için bkz. eşzamanlılık 
çakışmalarını işleme . 

Gönderme ve bağlama incelemesi 

Pages/filmler/Edit. cshtml. cs dosyasını inceleyin: 












public class EditModel : PageModel 

{ 

private readonly RazorPagesMovie.Data.RazorPagesMovieContext _context; 

public EditModel(RazorPagesMovie.Data.RazorPagesMovieContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Movie Movie { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Movie = await _context.Movie.FirstOrDefaultAsync(m => m.ID == id); 

if (Movie == null) 

{ 

retunn NotFound(); 

} 

retunn Page(); 


public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_context.Attach(Movie).State = EntityState.Modified; 

try 

{ 

await _context.SaveChangesAsync(); 

} 

catch (DbUpdateConcurrencyException) 

{ 

if (!MovieExists(Movie.ID)) 

{ 

return NotFound(); 

} 

else 

{ 

throw; 

} 

} 

return RedirectToPage("./Index"); 

} 

private bool MovieExists(int id) 

{ 

return _context.Movie.Any(e => e.ID == id); 

} 

Filmler/düzenleme sayfasına HTTP GET isteği yapıldığında (örneğin, http://iocaihost:5000/Movies/Edit/2 ): 

• onGetAsync yöntemi, filmi veritabanından getirir ve Page yöntemini döndürür. 

• Page yöntemi, Pages/fUmier/Edit. cshtml Razor sayfasını \ş\er.Pages/filmler/Edit. cshtml dosyası, film 




modelinin sayfada kullanılabilir olmasını sağlayan model yönergesini ( 

@model RazorPagesMovie. Pages .Movies. EditModel ) içerir. 

• Düzenleme formu filmdeki değerlerle birlikte görüntülenir. 

Filmler/Düzenle sayfası gönderildiğinde: 

• Sayfadaki form değerleri Movie özelliğine bağlıdır. [BindProperty] özniteliği model 
bağlamayımümkün. 

[BindProperty] 

public Movie Movie { get; set; } 

• Model durumunda hatalar varsa (örneğin, ReleaseDate bir tarihe dönüştürülemiyorsa), form gönderilen 
değerlerle yeniden görüntülenir. 

• Model hatası yoksa, film kaydedilir. 

Razor sayfalarında Dizin, oluşturma ve silme gibi HTTP GET yöntemleri benzer bir düzende yer alır.Razor 
Oluştur sayfasındaki HTTP POST onPostAsync yöntemi, Razor düzenleme sayfasındaki onPostAsync 
yöntemine benzer bir düzen izler. 

Ek kaynaklar 


ÖNCEKİ: BİR V E R İT A B A N IY L A 
ÇALIŞM A 




İLERİ: ARAMA 
EKLE 


Yapı iskelesi film uygulamasının iyi bir başlangıcı vardır ancak sunum ideal değildir. ReleaseDate Yayın tarihi 
(iki sözcük) olmalıdır. 

— □ X 

| lndex - Movie x + 

C i https://localhost:5001/Movies 0 : 

RpMovİe Home Privacy 

lndex 

Create New 


Title 

ReleaseDate 

Genre 

Price 


When Harry Met Sally 

2/12/1989 

Romantic Comedy 

7.99 

Edit | Details | Delete 

Ghostbusters 

3/13/1984 

Comedy 

8.99 

Edit | Details | Delete 

Ghostbusters 2 

2/23/1986 

Comedy 

9.99 

Edit | Details | Delete 

Rio Bravo 

4/15/1959 

VVestern 

3.99 

Edit | Details | Delete 

The Good, the bad, and the ugly 

12/1/2018 

VVestern 

1.19 

Edit | Details | Delete 
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Oluşturulan kodu Güncelleştir 













Modeiier/film. cs dosyasını açın ve aşağıdaki kodda gösterilen vurgulanmış satırları ekleyin: 
using System; 

using System.ComponentModel.DataAnnotations; 
using System.ComponentModel.DataAnnotations.Schema; 

namespace RazorPagesMovie.Models 

{ 

public class Movie 

{ 

public int ID { get; set; } 
public string Title { get; set; } 

[Display(Name = "Release Date")] 

[DataType(DataType.Date)] 

public DateTime ReleaseDate { get; set; } 

public string Genre { get; set; } 

[Column(TypeName = "decimal(18, 2)")] 
public decimal Price { get; set; } 

} 

} 

[Coiumn(TypeName = "decimai(i8, 2 )")] veri ek açıklaması, Entity Framevvork Core veritabanında Price para 
birimine doğru şekilde eşlemesine olanak sağlar. Daha fazla bilgi için bkz. veri türleri. 

Veri açıklamaları sonraki öğreticide ele alınmıştır. Display özniteliği bir alanın adı için (Bu durumda 
"ReleaseDate" yerine "Yayın tarihi") görüntüleneceğini belirtir. DataType özniteliği verilerin türünü belirtir 
(Tarih), bu nedenle alanda depolanan zaman bilgileri gösterilmez. 


Hedef URL 'yi görmek için sayfalara/filmlere gidin ve bir düzenleme bağlantısının üzerine gelin. 


| lndex - Movie 

X + 

- □ X 

C 

i https://localhost:5001/Movies 

Ö : 

RpMovie 

Home Privacy 



Index 

Create New 


Title 

Release Date 

Genre 

Price 



When Harry Met Sally 

2/12/1989 

Roırıantic Comedy 

7.99 

Edit | Details 

Delete 

Ghostbusters 

3/13/1984 

Comedy 

8.99 

Edit ) Details 

Delete 

Ghostbusters 2 

2/23/1986 

Comedy 

9.99 

Edit | Details 

Delete 

Rio Bravo 

4/15/1959 

Western 

3.99 

Edit | Details 

Delete 
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Düzenle, Ayrıntılarve Sil bağlantıları, Sayfalar/fllmler/lndex. cshtml dosyasındaki tutturucu etiketi Yardımcısı 
tarafından oluşturulur. 
















(Şforeach (var item in Model.Movie) { 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.ReleaseDate) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Genre) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Price) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID">Details</a> | 

<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 


Etiket Yardımcıları, Razor dosyalarında HTML öğelerinin oluşturulmasına ve işlenmesine sunucu tarafı kodun 
katılmasını etkinleştir. Yukarıdaki kodda AnchorTagHelper , Razor sayfasından (yol göreli), asp-page ve yol 
kimliği ( asp-route-id ) HTM L href öznitelik değerini dinamik olarak oluşturur. Daha fazla bilgi için bkz. 

Sayfalar İçin URL oluşturma . 

Oluşturulan biçimlendirmeyi incelemek için sık kullandığınız tarayıcıdan Görünüm kaynağını kullanın. 
Oluşturulan HTML 'nin bir bölümü aşağıda gösterilmiştir: 

<td> 

<a href="/Movies/Edit?id=l">Edit</a> | 

<a href="/Movies/Details?id=l">Details</a> | 

<a href="/Movies/Delete?id=l">Delete</a> 

</td> 

Dinamik olarak oluşturulan bağlantılar, film KİMLİĞİNİ bir sorgu dizesiyle (örneğin, 
https://localhost: 5001/Movies/Details?id=l'' ?ld=l ) iletir. 

"{id: int}" yol şablonunu kullanmak için Düzenle, Ayrıntılar ve Sil Razor Pages güncelleştirin. Bu sayfaların her 
biri için Page yönergesini @page "{id:int}""@page değiştirin. Uygulamayı çalıştırın ve kaynağı görüntüleyin. 
Oluşturulan HTML, URL 'nin yol bölümüne KİMLİĞİ ekler: 

<td> 

<a href="/Movies/Edit/l">Edlt</a> | 

<a hnef="/Movles/Detalls/l">Details</a> | 

<a hnef="/Movles/Delete/l">Delete</a> 

</td> 


Tamsayıyı içermeyen " {id: int}" yol şablonuna sahip sayfaya yönelik bir İstek, HTTP 404 (bulunamadı) hatası 
döndürüyor. Örneğin, http://iocaihost:5000/Movies/Detaiis bir 404 hatası döndürür. KİMLİĞİ isteğe bağlı 
yapmak için ? yol kısıtlamasına ekleyin: 

@page "{id:int?}" 


@page "(id:int?}" davranışını test etmek için: 










• Pages/filmler/details. cshtml içindeki page yönergesini @page "{id:int?}" olarak ayarlayın. 

• pubiic async Task<iActionResuit> 0nGetAsync(int? id) ( sayfalarda/filmlerde/details. cshtml. cs) bir kesme 
noktası ayarlayın. 

• https://test-cors.org sayfasına gidin. 

@page "{id:int}" yönergesi ile, kesme noktası hiçbir şekilde vurılmaz. Yönlendirme Altyapısı HTTP 404 
döndürür. @page ”{id:int?}" kullanarak onGetAsync yöntemi NotFound (HTTP 404) döndürür. 

Eşzamanlılık özel durum işlemeyi gözden geçirme 

Pages/filmler/Edit. cshtml. cs dosyasındaki onPostAsync yöntemini gözden geçirin: 


pubiic async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_context.Attach(Movie).State = EntityState.Modified; 

try 

{ 

await _context.SaveChangesAsync(); 

} 

catch (DbUpdateConcurrencyException) 

{ 

if (!MovieExists(Movie.ID)) 

{ 

return NotFound(); 

} 

else 

{ 

throw; 

} 

} 

return RedirectToPage("./Index"); 

} 

private bool MovieExists(int id) 

{ 

return _context.Movie.Any(e => e.ID == id); 

} 

Önceki kod, bir istemci filmi sildiği ve diğer istemci filmle değişiklik yaptığı zaman eşzamanlılık özel 
durumlarını algılar. 

catch bloğunu test etmek için: 

• catch (DbupdateConcurrencyException) kesme noktası ayarlama 

• Film için Düzenle 1 yi seçin, değişiklikler yapın, ancak Kaydet 1 i girmeyin. 

• Başka bir tarayıcı penceresinde, aynı filmin Sil bağlantısını seçin ve ardından filmi silin. 

• Önceki tarayıcı penceresinde filmdeki değişiklikleri gönderin. 

Üretim kodu eşzamanlılık çakışmalarını algılamak isteyebilir. Daha fazla bilgi için bkz. eşzamanlılık 
çakışmalarını işleme . 

Gönderme ve bağlama incelemesi 

Pages/filmler/Edit. cshtml. cs dosyasını inceleyin: 












public class EditModel : PageModel 

{ 

private readonly RazorPagesMovieContext _context; 

public EditModel(RazorPagesMovieContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Movie Movie { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Movie = await _context.Movie.SingleOrDefaultAsync(m => m.ID == id); 

if (Movie == null) 

{ 

return NotFound(); 

} 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_context.Attach(Movie).State = EntityState.Modified; 

try 

{ 

await _context.SaveChangesAsync(); 

} 

catch (DbUpdateConcurrencyException) 

{ 

if (!_context.Movie.Any(e => e.ID == Movie.ID)) 

{ 

return NotFound(); 

} 

else 

{ 

throw; 

} 

} 

return RedirectToPage("./Index"); 

} 

} 

Filmler/düzenleme sayfasına HTTP GET isteği yapıldığında (örneğin, http://iocaihost:5000/Movies/Edit/2 ): 

• onGetAsync yöntemi, filmi veritabanından getirir ve Page yöntemini döndürür. 

• Page yöntemi, Pages/fiLmier/Edit. cshtml Razor sayfasını \ş\er.Pages/filmler/Edit. cshtml dosyası, film 
modelinin sayfada kullanılabilir olmasını sağlayan model yönergesini ( 

@model RazorPagesMovie. Pages .Movies. EditModel ) içerir. 

• Düzenleme formu filmdeki değerlerle birlikte görüntülenir. 





Filmler/Düzenle sayfası gönderildiğinde: 


• Sayfadaki form değerleri Movie özelliğine bağlıdır. [BindProperty] özniteliği model 
bağlamayımümkün. 

[BindProperty] 

public Movie Movie { get; set; } 

• Model durumunda hatalar varsa (örneğin, ReleaseDate bir tarihe dönüştürülemiyorsa), form gönderilen 
değerlerle birlikte görüntülenir. 

• Model hatası yoksa, film kaydedilir. 

Razor sayfalarında Dizin, oluşturma ve silme gibi HTTP GET yöntemleri benzer bir düzende yer alır.Razor 
Oluştur sayfasındaki HTTP POST onPostAsync yöntemi, Razor düzenleme sayfasındaki onPostAsync 
yöntemine benzer bir düzen izler. 

Arama sonraki öğreticiye eklenir. 

Ek kaynaklar 

• Bu öğreticinin YouTube sürümü 


ÖNCEKİ: BİR V E R İT A B A N IY L A 
ÇALIŞM A 




İLERİ: ARAMA 
EKLE 










ASRNET Core Razor Pages arama Ekle 

6.12.2019 • 14 minutes to read^. Edit Online 


Tarafından Rick Anderson 

Örnek kodu görüntüle veya indir (indirme). 

Örnek kodu görüntüle veya indir (indirme). 

Aşağıdaki bölümlerde, film tarzya veya ada göre arama eklenir. 

Aşağıdaki Vurgulanan özellikleri sayfalara/f'dmlere/tndex. cshtml. csöğesine ekleyin: 

public class IndexModel : PageModel 

{ 

private readonly RazorPagesMovie.Data.RazorPagesMovieContext _context; 

public IndexModel(RazorPagesMovie.Data.RazorPagesMovieContext context) 

{ 

_context = context; 

} 

public IList<Movie> Movie { get; set; } 

[BindProperty(SupportsGet = true)] 
public string SearchString { get; set; } 

// Requires using Microsoft.AspNetCore.Mvc.Rendering; 
public SelectList Genres { get; set; } 

[BindProperty(SupportsGet = true)] 
public string MovieGenre { get; set; } 


SearchString 

: kullanıcıların arama metin kutusuna girebileceği metni içerir. 

SearchString 

[BindProperty] 


özniteliği vardır. [BindProperty] form değerlerini ve Sorgu dizelerini özelliğiyle aynı ada bağlar.GET 
isteklerinde bağlama için (SupportsGet = true) gereklidir. 


: tarzlar listesini içerir. 

Genres 

, kullanıcının listeden bir tarz seçmesine izin verir. 

SelectList 


using Microsoft.AspNetCore.Mvc.Rendering; gerektiriyor 

• MovieGenre : kullanıcının seçtiği belirli tarzı içerir (örneğin, "Batı"). 

• Genres ve MovieGenre daha sonra bu öğreticide kullanılır. 


VVARNING 

Güvenlik nedenleriyle, get istek verilerini sayfa modeli özelliklerine bağlamayı tercih etmeniz gerekir. Özelliklerle 
eşleştirmadan önce Kullanıcı girişini doğrulayın, get bağlamaya dönüştürmek, sorgu dizesine veya rota değerlerine 
dayanan senaryoları adreslemekte yararlıdır. 

get isteklerindeki bir özelliği bağlamak için, [BindProperty] özniteliğinin SupportsGet özelliğini true olarak 
ayarlayın: 

[BindProperty(SupportsGet = true)] 

Daha fazla bilgi için bkz. ASP.NET Core topluluk alışması: Get tartışmasına bağlama (YouTube). 


Dizin sayfasının onGetAsync yöntemini aşağıdaki kodla güncelleştirin: 
















public async Task OnGetAsync() 

{ 

var movies = from m in _context.Movie 
select m; 

if (!string.IsNullOrEmpty(SearchString)) 

{ 

movies = movies.Where(s => s.Title.Contains(SearchString)); 

} 

Movie = await movies.Tol_istAsync(); 

} 

onGetAsync yönteminin ilk satırı, filmleri seçmek için bir LINQ sorgusu oluşturur: 

// using System.Linq; 
var movies = from m in _context.Movie 
select m; 


Sorgu yalnızca bu noktada tanımlanmış, veritabanında çalıştırılmadı. 


searchstring özelliği null veya boş değilse, filmler sorgusu arama dizesinde filtrelenecek şekilde değiştirilir: 

if (!string.Isl\lullOrEmpty(SearchString)) 

{ 

movies = movies.Where(s => s.Title.Contains(SearchString)); 

} 


s => s.Title.Contains () kodu bir iambda ifadesidir. Lambdalar, Yöntem tabanlı LINQ sorgularında, VVhere 
yöntemi veya contains (önceki kodda kullanılan) gibi standart sorgu işleci yöntemlerine bağımsız değişkenler 
olarak kullanılır. LINQ sorguları tanımlandıklarında veya bir Yöntem (örneğin, where , contains veya orderBy ) 
çağırarak değiştirildiklerinde yürütülmez. Bunun yerine sorgu yürütmesi ertelenir. Diğer bir deyişle, bir ifadenin 
değerlendirmesi, gerçekleştirilmiş değeri yinelenene veya ToListAsync yöntemi çağrılana kadar gecikir. Daha 
fazla bilgi için bkz. sorgu yürütme . 
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Aşağıdaki yol şablonu dizin sayfasına eklendiyse, arama dizesi bir URL segmenti olarak geçirilebilir (örneğin, 
https://localhost:5001/Movies/Ghost ). 

@page "{searchString?}" 


Önceki yol kısıtlaması, başlığın sorgu dizesi değeri yerine rota verileri (bir URL segmenti) olarak aranmasına 
olanak tanır. "{searchString?}" ? , bu isteğe bağlı bir yol parametresi anlamına gelir. 



ASP.NET Core çalışma zamanı, SearchString özelliğinin değerini sorgu dizesinden ( ?searchstring=Ghost ) 
veya rota verilerinden ( https://localhost: 5001 /Movies/Ghost ) ayarlamak için model bağlamayı kullanır. Model 
bağlama büyük/küçük harfe duyarlı değildir. 












Ancak, kullanıcıların bir filmi aramak için URL 'Yİ değiştirmesini beklemeniz gerekmez. Bu adımda, filmleri 
filtrelemek için Kullanıcı arabirimi eklenir, "{searchstring?}" yol kısıtlaması eklediyseniz, kaldırın. 

Pages/filmler/lndex. cshtml dosyasını açın ve aşağıdaki kodda vurgulanan <form> işaretlemesini ekleyin: 

@page 

@model RazorPagesMovie.Pages.Movies.IndexModel 

@{ 

ViewData["Title"] = "Index"; 

} 

<hl>Index</hl> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<form> 

<P> 

Title: <input type="text" asp-for="SearchString" /> 

<input type="submit" value="Filter" /> 

</p> 

</form> 

<table class="table"> 

@*Mankup removed for brevity.*@ 


HTML <form> etiketi aşağıdaki Etiket Yardımcılarıkullanır: 

• Form etiketi Yardımcısı. Form gönderildiğinde, filtre dizesi, sorgu dizesi aracılığıyla Sayfalar/f'dmler/Dizin 
sayfasına gönderilir. 

• Giriş Etiketi Yardımcısı 

Değişiklikleri kaydedin ve filtreyi test edin. 
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Tarza göre ara 

onGetAsync yöntemini aşağıdaki kodla güncelleştirin: 

public async Task OnGetAsync() 

{ 

// Use LINQ to get list of genres. 

IQueryable<string> genreQuery = from m in _context.Movie 

orderby m.Genre 
select m.Genre; 

var movies = from m in _context.Movie 
select m; 

if (!string.IsNullOrEmpty(SearchString)) 

{ 

movies = movies.Where(s => s.Title.Contains(SearchString)); 

} 

if (! string. IslMullOrEmpty(MovieGenre)) 

{ 

movies = movies.Where(x => x.Genre == MovieGenre); 

} 

Genres = new SelectList(await genreQuery.Distinct().ToListAsync()) 
Movie = await movies .Tol_istAsync(); 

} 

Aşağıdaki kod, veritabanından tüm tarzları alan bir LINQ sorgusudur. 

// Use LINQ to get list of genres. 

IQueryable<string> genreQuery = from m in _context.Movie 

orderby m.Genre 
select m.Genre; 

Tarzın selectList , farklı tarzlar yansıtılayarak oluşturulur. 

Genres = new SelectList(await genreQuery.Distinct().ToListAsync()); 


Türe göre, Razor sayfasına arama ekleme 

lndex. cshtml 'yi aşağıdaki şekilde güncelleştirin: 





@page 

@model RazorPagesMovie.Pages.Movies.IndexModel 

@{ 

ViewData["Title"] = "Index"; 

} 

<hl>Index</hl> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<form> 

<P> 

<select asp-for="MovieGenre" asp-items="Model.Genres"> 
<option value="">All</option> 

</select> 

Title: <input type="text" asp-for="SearchString" /> 
<input type="submit" value="Filter" /> 

</p> 

</form> 

<table class="table"> 

@*Mankup removed for brevity.*@ 


Türe göre, film başlığına göre ve her ikisine birden arayarak uygulamayı test edin. 

Ek kaynaklar 

• Bu öğreticinin YouTube sürümü 


ÖNCEKİ: SAYFALARI ■ İ L E RI: Y E N I B IR A L A N 

GÜNCELLEŞTİRME H EKLEME 


Örnek kodu görüntüle veya indir (indirme). 

Örnek kodu görüntüle veya indir (indirme). 

Aşağıdaki bölümlerde, film tarzya veya ada göre arama eklenir. 

Aşağıdaki Vurgulanan özellikleri sayfalara/filmlere/lndex. cshtml. csöğesine ekleyin: 






public class IndexModel : PageModel 

{ 

private readonly RazorPagesMovie.Models.RazorPagesMovieContext _context; 

public IndexModel(RazorPagesMovie.Models.RazorPagesMovieContext context) 

{ 

_context = context; 

} 

public IList<Movie> Movie { get; set; } 

[BindProperty(SupportsGet = true)] 
public string SearchString { get; set; } 

// Requires using Microsoft.AspNetCore.Mvc.Rendering; 
public SelectList Genres { get; set; } 

[BindProperty(SupportsGet = true)] 
public string MovieGenre { get; set; } 


SearchString 

: kullanıcıların arama metin kutusuna girebileceği metni içerir. 

SearchString 

[BindProperty] 


özniteliği vardır. [BindProperty] form değerlerini ve Sorgu dizelerini özelliğiyle aynı ada bağlar.GET 
isteklerinde bağlama için (SupportsGet = true) gereklidir. 


: tarzlar listesini içerir. 

Genres 

, kullanıcının listeden bir tarz seçmesine izin verir. 

SelectList 


using Microsoft.AspNetCore.Mvc.Rendering; gerektiriyor 

• MovieGenre : kullanıcının seçtiği belirli tarzı içerir (örneğin, "Batı"). 

• Genres ve MovieGenre daha sonra bu öğreticide kullanılır. 


VVARNING 

Güvenlik nedenleriyle, get istek verilerini sayfa modeli özelliklerine bağlamayı tercih etmeniz gerekir. Özelliklerle 
eşleştirmadan önce Kullanıcı girişini doğrulayın, get bağlamaya dönüştürmek, sorgu dizesine veya rota değerlerine 
dayanan senaryoları adreslemekte yararlıdır. 

get isteklerindeki bir özelliği bağlamak için, [BindProperty] özniteliğinin SupportsGet özelliğini true olarak 
ayarlayın: 

[BindProperty(SupportsGet = true)] 

Daha fazla bilgi için bkz. ASP.NET Core topluluk alışması: Get tartışmasına bağlama (YouTube). 


Dizin sayfasının onGetAsync yöntemini aşağıdaki kodla güncelleştirin: 

public async Task OnGetAsync() 

{ 

var movies = from m in _context.Movie 
select m; 

if (Istring.IsNullOrEmpty(SearchString)) 

{ 

movies = movies.Where(s => s.Title.Contains(SearchString)); 

} 

Movie = await movies.ToListAsync(); 

} 


OnGetAsync yönteminin ilk satırı, filmleri seçmek için bir LINQ sorgusu oluşturur: 














// using System.Linq; 
var movies = from m in _context.Movie 
select m; 

Sorgu yalnızca bu noktada tanımlanmış, veritabanında çalıştırılmadı. 


searchstring özelliği null veya boş değilse, filmler sorgusu arama dizesinde filtrelenecek şekilde değiştirilir: 

if (Istring.IsNullOrEmpty(SearchString)) 

{ 

movies = movies.Where(s => s.Title.Contains(SearchString)); 

} 


s => s.Title.Contains () kodu bir lambda ifadesidir. Lambdalar, Yöntem tabanlı LINQ sorgularında, VVhere 
yöntemi veya contains (önceki kodda kullanılan) gibi standart sorgu işleci yöntemlerine bağımsız değişkenler 
olarak kullanılır. LINQ sorguları tanımlandıklarında veya bir Yöntem (örneğin, where , contains veya orderBy ) 
çağırarak değiştirildiklerinde yürütülmez. Bunun yerine sorgu yürütmesi ertelenir. Diğer bir deyişle, bir ifadenin 
değerlendirmesi, gerçekleştirilmiş değeri yinelenene veya ToListAsync yöntemi çağrılana kadar gecikir. Daha 
fazla bilgi için bkz. sorgu yürütme . 


Note: Contains yöntemi C# kodda değil, veritabanında çalıştırılır.Sorgudaki büyük/küçük harf duyarlılığı 
veritabanına ve harmanlamaya bağlıdır. SQL Server, SQL İle benzer, büyük/küçük harfe duyarsız contains 
eşlenir. SQLİte ' da, varsayılan harmanlama ile büyük/küçük harfe duyarlıdır. 

Filmler sayfasına gidin ve URL 'ye ?searchstring=Ghost gibi bir sorgu dizesi ekleyin (örneğin, 
https://localhost:5@0i/Movies?searchstring=Ghost ). Filtrelenmiş filmler görüntülenir. 



Aşağıdaki yol şablonu dizin sayfasına eklendiyse, arama dizesi bir URL segmenti olarak geçirilebilir (örneğin, 
https://localhost:5001/Movies/Ghost ). 

@page "{searchstring?}" 













Önceki yol kısıtlaması, başlığın sorgu dizesi değeri yerine rota verileri (bir URL segmenti) olarak aranmasına 
olanak tanır, "{searchstring?}" ? , bu isteğe bağlı bir yol parametresi anlamına gelir. 
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□ X 

O. â : 


ASP.NET Core çalışma zamanı, searchstring özelliğinin değerini sorgu dizesinden ( ?searchstring=Ghost ) 
veya rota verilerinden ( https://iocaihost:500i/Movies/Ghost ) ayarlamak için model bağlamayı kullanır. Model 
bağlama büyük/küçük harfe duyarlı değildir. 

Ancak, kullanıcıların bir filmi aramak için URL 'Yİ değiştirmesini beklemeniz gerekmez. Bu adımda, filmleri 
filtrelemek için Kullanıcı arabirimi eklenir, "{searchstring?}" yol kısıtlaması eklediyseniz, kaldırın. 

Pages/filmler/lndex. cshtml dosyasını açın ve aşağıdaki kodda vurgulanan <form> işaretlemesini ekleyin: 

@page 

@model RazorPagesMovie.Pages.Movies.IndexModel 

@{ 

ViewData["Title"] = "Index"; 

} 

<hl>Index</hl> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<form> 

<P> 

Title: cinput type="text" asp-for="SearchString" /> 

•cinput type="submit" value="Filter" /> 

</p> 

</form> 

<table class="table"> 

@*Markup removed for brevity.*@ 


HTML <form> etiketi aşağıdaki Etiket Yardımcılarıkullanır: 










• Form etiketi Yardımcısı. Form gönderildiğinde, filtre dizesi, sorgu dizesi aracılığıyla Sayfalar/filmler/Dizin 
sayfasına gönderilir. 

• Giriş Etiketi Yardımcısı 

Değişiklikleri kaydedin ve filtreyi test edin. 
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Tarza göre ara 

onGetAsync yöntemini aşağıdaki kodla güncelleştirin: 


public async Task OnGetAsync() 

{ 

// Use LINQ to get list of genres. 

IQueryable<string> genreQuery = from m in _context.Movie 

orderby m.Genre 
select m.Genre; 

var movies = from m in _context.Movie 
select m; 

if (Istring.IsNullOrEmpty(SearchString)) 

{ 

movies = movies.Where(s => s.Title.Contains(SearchString)); 

} 

if (I string.IsMullOrEmpty(MovieGenre)) 

{ 

movies = movies.Where(x => x.Genre == MovieGenre); 

} 

Genres = new SelectList(await genreQuery.Distinct().ToListAsync()); 
Movie = await movies.ToListAsync(); 


Aşağıdaki kod, veritabanından tüm tarzları alan bir LINQ sorgusudur. 










// Use LINQ to get list of genres. 

IQueryable<string> genreQuery = from m in _context.Movie 

orderby m.Genre 
select m.Genre; 

Tarzın selectList , farklı tarzlar yansıtılayarak oluşturulur. 

Genres = new SelectList(await genreQuery.Distinct().ToListAsync()); 


Türe göre, Razor sayfasına arama ekleme 

lndex. cshtml 'yi aşağıdaki şekilde güncelleştirin: 

@page 

@model RazorPagesMovie.Pages.Movies.IndexModel 

@{ 

ViewData["Title"] = "Index"; 

} 

<hl>Index</hl> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<form> 

<P> 

<select asp-for="MovieGenre" asp-items="Model.Genres"> 

<option value="">All</option> 

</select> 

Title: <input type="text" asp-for="SearchString" /> 
cinput type="submit" value="Filter" /> 

</p> 

</form> 

<table class="table"> 

@*Markup removed for brevity.*@ 

Türe göre, film başlığına göre ve her ikisine birden arayarak uygulamayı test edin. Önceki kod, Select etiketi 
yardımcısını ve seçenek etiketi yardımcısını kullanır. 

Ek kaynaklar 

• Bu öğreticinin YouTube sürümü 


ÖNCEKİ: SAYFALARI 




İLERİ: YENİ BİR ALAN 


GÜNCELLEŞTIRM E 


EKLEME 









ASPNET Core Razor sayfasına yeni bir alan ekleyin 

23.11.2019 • 17 minutes to readz. Edit Online 


Tarafından RickAnderson 

Örnek kodu görüntüle veya indir (indirme). 

Örnek kodu görüntüle veya indir (indirme). 

Bu bölümde Entity Framevvork için Code First Migrations kullanılır: 

• Modele yeni bir alan ekleyin. 

• Yeni alan şeması değişikliğini veritabanına geçirin. 

Bir veritabanını otomatik olarak oluşturmak için EF Code First kullanırken Code First: 

• Veritabanı şemasının oluşturulduğu model sınıflarıyla eşitlenmiş olup olmadığını izlemek için veritabanına 

bir _EFMigrationsHistory tablosu ekler. 

• Model sınıfları DB ile eşitlenmiyorsa, EF bir özel durum oluşturur. 

Şema/modelin eşitlemede otomatik olarak doğrulanması, tutarsız veritabanı/kod sorunlarını bulmayı 
kolaylaştırır. 

Film modeline bir derecelendirme özelliği ekleme 

Modeller/film, cs dosyasını açın ve bir Rating özelliği ekleyin: 

public class Movie 
{ 

public int ID { get; set; } 
public string Title { get; set; } 

[Display(Name = "Release Date")] 

[DataType(DataType.Date)] 

public DateTime ReleaseDate { get; set; } 

public string Genre { get; set; } 

[Column(TypeName = "decimal(18j 2)")] 
public decimal Price { get; set; } 
public string Rating { get; set; } 

} 


Uygulamayı derleyin. 

Sayfaları/filmleri/dizini. cshtml'yl düzenleyin ve bir Rating alanı ekleyin: 

@page 

@model RazorPagesMovie.Pages.Movies.IndexModel 


ViewData["Title"] = "Index"; 

} 

<hl>Index</hl> 

<P> 


<a asp-page="Create">Create New</a> 








</p> 


<fonm> 

<P> 

<select asp-for="MovieGenre" asp-items="Model.Genres"> 

<option value="">All</option> 

</select> 

Title: <input type="text" asp-for="SearchString" /> 

<input type="submit" value="Filter" /> 

</p> 

</form> 

ctable class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model => model.Movie[0].Title) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movie[0].ReleaseDate) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movie[0].Genre) 

</th> 

<th> 

@Html.DisplayNameFon(model => model.Movie[0].Price) 

</th> 

<th> 

@Html.DisplayNameFon(model => model.Movie[0].Rating) 

</th> 

<thx/th> 

</tn> 

</thead> 

<tbody> 

@foreach (var item in Model.Movie) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.ReleaseDate) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Genre) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Price) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Rating) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID">Details</a> | 

<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 


Aşağıdaki sayfaları güncelleştirin: 

• Silme ve Ayrıntılar sayfalarına Rating alanını ekleyin. 

• Create. cshtml dosyasını bir Rating alanla güncelleştirin. 




• Düzenleme sayfasına Rating alanını ekleyin. 


VERITABANı yeni alanı içerecek şekilde güncelleştirene kadar uygulama çalışmaz. Veritabanını 
güncelleştirmeden uygulamayı çalıştırmak bir sqiException oluşturur: 

SqlException: Invalid column name 'Rating'. 

sqiException özel durumu, güncelleştirilmiş film modeli sınıfının, veritabanının film tablosunun şemasından 
farklı olmasından kaynaklanır. (Veritabanı tablosunda Rating sütunu yoktur.) 

Hatayı çözmek için birkaç yaklaşım vardır: 

1. Yeni model sınıfı şemasını kullanarak veritabanını otomatik olarak bırakıp yeniden oluşturmaya Entity 
Framevvork. Bu yaklaşım, geliştirme döngüsünün başlarında daha erken bir yoldur; modeli ve veritabanı 
şemasını birlikte hızla gelişmenize olanak tanır. Dovvnsıde, veritabanında var olan verileri kaybetmeniz. 

Bu yaklaşımı bir üretim veritabanında kullanmayın! DB 'yi şema değişikliklerinde bırakıp bir başlatıcı 
kullanarak veritabanının test verileriyle otomatik olarak çekirdeğini oluşturmak, genellikle bir uygulama 
geliştirmeye yönelik üretken bir yoldur. 

2. Mevcut veritabanının şemasını model sınıflarıyla eşleşecek şekilde açıkça değiştirin. Bu yaklaşımın 
avantajı, verilerinizi tutmanızı kullanmaktır. Bu değişikliği el ile ya da bir veritabanı değişiklik betiği 
oluşturarak yapabilirsiniz. 

3. Veritabanı şemasını güncelleştirmek için Code First Migrations kullanın. 

Bu öğretici için Code First Migrations kullanın. 

seedData sınıfını yeni sütun için bir değer sağlayacak şekilde güncelleştirin. Aşağıda örnek bir değişiklik 
gösterilmektedir, ancak her bir new Movie bloğu için bu değişikliği yapmak isteyeceksiniz. 

context.Movie.AddRange( 
new Movie 
{ 

Title = "When Harry Met Sally", 

ReleaseDate = DateTime.Parse("1989-2-12"), 

Genre = "Romantic Comedy", 

Price = 7.99M, 

Rating = "R" 

b 

Tamamlanan SeedData.es dosyasınabakın. 

Çözümü oluşturun. 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

Derecelendirme alanı için bir geçiş ekleyin 

Araçlar menüsünde NuGet Paket Yöneticisi > Paket Yöneticisi konsolu 1 nu seçin. PMC'de aşağıdaki 
komutları girin: 

Add-Migration Rating 
Update-Database 

Add-Migration komutu, çerçeveye şunları belirtir: 

• Movie modelini Movie DB şemasıyla karşılaştırın. 

• DB şemasını yeni modele geçirmek için kod oluşturun. 










"Derecelendirme" adı rastgele olur ve geçiş dosyasını adlandırmak için kullanılır.Geçiş dosyası için anlamlı bir 
ad kullanılması yararlı olur. 

update-Database komutu, çerçeveye şema değişikliklerini uygulamaya ve var olan verileri korumanıza bildirir. 

VERITABANıNDAKI tüm kayıtları silerseniz, başlatıcı DB 'yi temel alır ve Rating alanını içerir. Bunu, tarayıcıda 
veya SQL Server Nesne Gezgini (ssox) silme bağlantılarıyla yapabilirsiniz. 

Başka bir seçenek de veritabanını silmek ve geçişleri kullanarak veritabanını yeniden oluşturmaktır.SSOX 'te 
veritabanını silmek için: 

• SSOX'te veritabanını seçin. 

• Veritabanına sağ tıklayın ve Sii i seçin. 

• Mevcut bağlantıları kapat' a bakın. 

• Seçin Tamam. 

• PMC'de veritabanını güncelleştirin: 

Update-Database 

Uygulamayı çalıştırın ve bir Rating alanı ile film oluşturabileceğiniz/düzenleyebileceğiniz/görüntüleydiğinizi 
doğrulayın. Veritabanı birlikte olmazsa, seedData.initialize yönteminde bir kesme noktası ayarlayın. 

Ek kaynaklar 

• Bu öğreticinin YouTube sürümü 
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Örnek kodu görüntüle veya indir (indirme). 

Örnek kodu görüntüle veya indir (indirme). 

Bu bölümde Entity Framevvork için Code First Migrations kullanılır: 

• Modele yeni bir alan ekleyin. 

• Yeni alan şeması değişikliğini veritabanına geçirin. 

Bir veritabanını otomatik olarak oluşturmak için EF Code First kullanırken Code First: 

• Veritabanı şemasının oluşturulduğu model sınıflarıyla uyumlu olup olmadığını izlemek için veritabanına bir 
tablo ekler. 

• Model sınıfları DB ile eşitlenmiyorsa, EF bir özel durum oluşturur. 

Şema/modelin eşitlemede otomatik olarak doğrulanması, tutarsız veritabanı/kod sorunlarını bulmayı 
kolaylaştırır. 

Film modeline bir derecelendirme özelliği ekleme 

Modeller/film. cs dosyasını açın ve bir Rating özelliği ekleyin: 











public class Movie 

{ 

public int ID { get; set; } 
public stning Title { get; set; } 

[Display(Name = "Release Date")] 
[DataType(DataType.Date)] 
public DateTime ReleaseDate { get; set; } 
public stning Genne { get; set; } 

[Column(TypeName = "decimal(18, 2)")] 
public decimal Price { get; set; } 
public stning Rating { get; set; } 


Uygulamayı derleyin. 

Sayfaları/filmleri/dizini. cshtml'yl düzenleyin ve bir Rating alanı ekleyin: 

@page 

@model RazorPagesMovie.Pages.Movies.IndexModel 

@{ 

ViewData["Title"] = "Index"; 

} 

<hl>Index</hl> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<form> 

<P> 

<select asp-fon="MovieGenne" asp-items="Model.Gennes"> 

<option value="">All</option> 

</select> 

Title: cinput type="text" asp-fon="SearchString" /> 
cinput type="submit" value="Filter" /> 

</p> 

</form> 

<table class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFon(model => model.Movie[0].Title) 

</th> 

<th> 

@Html.DisplayNameFon(model => model.Movie[0].ReleaseDate) 
</th> 

<th> 

@Html.DisplayNameFor(model => model.Movie[0].Genne) 

</th> 

<th> 

@Html.DisplayNameFon(model => model.Movie[0].Pnice) 

</th> 

<th> 

@Html.DisplayNameFon(model => model.Movie[0].Rating) 

</th> 

<thx/th> 

</tn> 

</thead> 

<tbody> 

@foneach (van item in Model.Movie) 




{ 

<trxtd> 


@Html.DisplayFor'(modelItem => item.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.ReleaseDate) 

</td> 

<td> 

@Fltml.DisplayFon(modelItem => item.Genre) 

</td> 

<td> 

@Html.DisplayFor'(modelItem => item.Price) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Rating) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID">Details</a> | 

<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 


Aşağıdaki sayfaları güncelleştirin: 

• Silme ve Ayrıntılar sayfalarına Rating alanını ekleyin. 

• Create. cshtml dosyasını bir Rating alanla güncelleştirin. 

• Düzenleme sayfasına Rating alanını ekleyin. 

VERITABANı yeni alanı içerecek şekilde güncelleştirilene kadar uygulama çalışmaz. Şimdi çalıştırırsanız, 

uygulama bir sqiException oluşturur: 

SqlException: Invalid column name 'Rating'. 

Bu hata, güncelleştirilmiş film modeli sınıfının, veritabanının film tablosunun şemasından farklı olmasından 

kaynaklanır. (Veritabanı tablosunda Rating sütunu yoktur.) 

Hatayı çözmek için birkaç yaklaşım vardır: 

1. Yeni model sınıfı şemasını kullanarak veritabanını otomatik olarak bırakıp yeniden oluşturmaya Entity 
Framevvork. Bu yaklaşım, geliştirme döngüsünün başlarında daha erken bir yoldur; modeli ve veritabanı 
şemasını birlikte hızla gelişmenize olanak tanır. Dovvnsıde, veritabanında var olan verileri kaybetmeniz. 
Bu yaklaşımı bir üretim veritabanında kullanmayın! DB 'yi şema değişikliklerinde bırakıp bir başlatıcı 
kullanarak veritabanının test verileriyle otomatik olarak çekirdeğini oluşturmak, genellikle bir uygulama 
geliştirmeye yönelik üretken bir yoldur. 

2. Mevcut veritabanının şemasını model sınıflarıyla eşleşecek şekilde açıkça değiştirin. Bu yaklaşımın 
avantajı, verilerinizi tutmanızı kullanmaktır. Bu değişikliği el ile ya da bir veritabanı değişiklik betiği 
oluşturarak yapabilirsiniz. 

3. Veritabanı şemasını güncelleştirmek için Code First Migrations kullanın. 

Bu öğretici için Code First Migrations kullanın. 

seedData sınıfını yeni sütun için bir değer sağlayacak şekilde güncelleştirin. Aşağıda örnek bir değişiklik 

gösterilmektedir, ancak her bir new Movie bloğu için bu değişikliği yapmak isteyeceksiniz. 








context.Movie.AddRange( 
new Movie 
{ 

Title = "When Harry Met Sally", 

ReleaseDate = DateTime.Parse("1989-2-12"), 

Genre = "Romantic Comedy", 

Pnice = 7.99M, 

Rating = "R" 

}, 

Tamamlanan SeedData.es dosyasınabakın. 

Çözümü oluşturun. 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

Derecelendirme alanı için bir geçiş ekleyin 

Araçlar menüsünde NuGet Paket Yöneticisi > Paket Yöneticisi konsolu 1 nu seçin. PMC'de aşağıdaki 
komutları girin: 

Add-Migration Rating 
Update-Database 

Add-Migration komutu, çerçeveye şunları belirtir: 

• Movie modelini Movie DB şemasıyla karşılaştırın. 

• DB şemasını yeni modele geçirmek için kod oluşturun. 

"Derecelendirme" adı rastgele olur ve geçiş dosyasını adlandırmak için kullanılır.Geçiş dosyası için anlamlı bir 
ad kullanılması yararlı olur. 

update-Database komutu, çerçeveye şema değişikliklerini veritabanına uygulamasını söyler. 

VERITABANıNDAKI tüm kayıtları silerseniz, başlatıcı DB 'yi temel alır ve Rating alanını içerir. Bunu, tarayıcıda 
veya SQL Server Nesne Gezgini (ssox) silme bağlantılarıyla yapabilirsiniz. 

Başka bir seçenek de veritabanını silmek ve geçişleri kullanarak veritabanını yeniden oluşturmaktır.SSOX 'te 
veritabanını silmek için: 

• SSOX'te veritabanını seçin. 

• Veritabanına sağ tıklayın ve Sil' i seçin. 

• Mevcut bağlantıları kapat' a bakın. 

• Seçin Tamam. 

• PMC'de veritabanını güncelleştirin: 

Update-Database 

Uygulamayı çalıştırın ve bir Rating alanı ile film oluşturabileceğiniz/düzenleyebileceğiniz/görüntüleydiğinizi 
doğrulayın. Veritabanı birlikte olmazsa, seedData.initialize yönteminde bir kesme noktası ayarlayın. 


Ek kaynaklar 









• Bu öğreticinin YouTube sürümü 
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ASRNET Core Razor sayfasına doğrulama ekleme 

15.10.2019 • 15 minutes to read z. Edit Online 


Rick Anderson tarafından 

Bu bölümde, Movie modeline doğrulama mantığı eklenir. Doğrulama kuralları, bir Kullanıcı bir filmi 
oluşturduğunda veya düzenleişinizde zorlanır. 

Doğrulama 

Yazılım geliştirmeye yönelik temel bir temel kuru ("Don't Repeon Yourself") olarak adlandırılır. Razor Pages, 
işlevselliği bir kez belirtildiğinde geliştirme ve uygulama genelinde yansıtılmıştır. Kuru şu şekilde yardımcı 
olabilir: 

• Uygulamadaki kod miktarını azaltın. 

• Kodu daha az hata haline getirin ve test ve bakım yapmayı kolaylaştırın. 

Razor Pages ve Entity Framevvork tarafından sunulan doğrulama desteği, Kuru ilkesine iyi bir örnektir. 
Doğrulama kuralları tek bir yerde (model sınıfında) bildirimli olarak belirtilir ve kurallar uygulamada her yerde 
zorlanır. 

Film modeline doğrulama kuralları ekleme 

Dataaçıklamalarda ad alanı, bir sınıfa veya özelliğe bildirimli olarak uygulanan bir yerleşik doğrulama 
öznitelikleri kümesi sağlar. Veri açıklamaları, biçimlendirme ile yardım eden ve herhangi bir doğrulama 
sağlamayan DataType gibi biçimlendirme öznitelikleri de içerir. 

@No_t-0 sınıfını, yerleşik Required , stringLength , ReguiarExpression ve Range doğrulama özniteliklerinden 
faydalanmak için güncelleştirin. 







public class Movie 
{ 

public int ID { get; set; } 

[StringLength(60, MinimumLength = 3)] 

[Required] 

public string Title { get; set; } 

[Display(Name = "Release Date")] 

[DataType(DataType.Date)] 

public DateTime ReleaseDate { get; set; } 

[Range(l, 100)] 

[DataType(DataType.Currency) ] 

[Column(TypeName = "decimal(18, 2)")] 
public decimal Pnice { get; set; } 

[RegularExpression(@" A [A-Z]+[a-zA-Z""'\s-]*$")] 
[Required] 

[StringLength(30) ] 

public string Genre { get; set; } 

[RegularExpression(@" A [A-Z]+[a-zA-Z0-9""'\s-]*$")] 
[StringLength(5) ] 

[Required] 

public string Rating { get; set; } 


Doğrulama öznitelikleri, uygulanan model özellikleri üzerinde zorlamak istediğiniz davranışı belirtir: 

• @No__t-0 ve MinimumLength öznitelikleri bir özelliğin bir değere sahip olması gerektiğini belirtir; Ancak 
hiçbir şey, kullanıcının bu doğrulamayı karşılamak için boşluk girmesini engeller. 

• @No__t-0 özniteliği, hangi karakterlerin girişi yapabileceğini sınırlamak için kullanılır.Yukarıdaki kodda, 
"tarz": 

o Yalnızca harfler kullanılmalıdır. 

o ilk harfin büyük harfle olması gerekir. Boşluk, sayı ve özel karakterlere izin verilmez. 

• @No__t-0 "derecelendirmesi": 

o ilk karakterin büyük harf olmasını gerektirir. 

o Sonraki boşlukların içindeki özel karakter ve sayılara izin verir. "PG-13" bir derecelendirme için 
geçerlidir, ancak bir "tarz" için başarısız olur. 

• @No__t-0 özniteliği, bir değeri belirtilen bir Aralık içinde kısıtlar. 

• @No__t-0 özniteliği, bir dize özelliğinin en büyük uzunluğunu ve isteğe bağlı olarak en düşük 
uzunluğunu ayarlamanıza olanak sağlar. 

• Değer türleri (örneğin decimal, int, float , DateTime ), doğal olarak gereklidir ve [Required] 
özniteliğine gerek kalmaz. 

Doğrulama kurallarının otomatik olarak uygulanmasını ASP.NET Core uygulamanızın daha sağlam olmasına 
yardımcı olur. Ayrıca, bir şeyi doğrulamayı unutmanızı ve veritabanına yanlışlıkla veri vermemesini de sağlar. 

Razor Pages 'de doğrulama hatası Kullanıcı arabirimi 

Uygulamayı çalıştırın ve sayfalar/Filmler' e gidin. 

Yeni oluştur bağlantısını seçin. Formu, bazı geçersiz değerlerle doldurun. JQuery istemci tarafı doğrulaması 
hatayı algıladığında, bir hata iletisi görüntüler. 
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Title 

a 

The field Title must be a string with a 
minimum length of 3 and a maximum 
length of 60. 

Release Date 
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The Release Date field ıs requıred. 

Genre 

a 

The field Genre must match the regular 
eıcpression ' A |A-Z)+|a-zA-Z"\s-)*S'. 

Price 

Dog 

The field Price must be a number. 

Rating 

z 

The field Rating must match the regular 
expression ' A [A-ZMa-zA-Z0-9”\s-]*S\ 
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NOTE 

Ondalık alanlara ondalık virgüller giremeyebilirsiniz. Ondalık bir nokta ve ABD İngilizcesi olmayan tarih biçimleri için virgül 
kullanan İngilizce olmayan yerel ayarlarda jOuery doğrulamasını desteklemek için, uygulamanızı globalize için adımlar 
uygulamanız gerekir. Ondalık virgülden ekleme hakkında yönergeler için bkz. GitHub sorunu 4076 . 


Formun geçersiz bir değer içeren her alanda otomatik olarak bir doğrulama hata iletisi nasıl oluşturulduğuna 
dikkat edin. Hatalar hem istemci tarafında (JavaScript ve jQuery kullanılarak) hem de sunucu tarafında (bir 
Kullanıcı JavaScript devre dışı bırakıldığında) zorlanır. 

Önemli bir avantaj, oluşturma veya düzenleme sayfalarında hiçbir kod değişikliği gerekli değildir. Veri ek 
açıklamaları modele uygulandıktan sonra, doğrulama kullanıcı arabirimi etkini eştiril m iştir. Bu öğreticide 
oluşturulan Razor Pages otomatik olarak doğrulama kurallarını ( Movie Model sınıfının özelliklerinde 
doğrulama özniteliklerini kullanarak) otomatik olarak alır. Düzenleme sayfasını kullanarak doğrulama testi, aynı 
doğrulama uygulanır. 

Form verileri, istemci tarafı doğrulama hatası kalmayana kadar sunucuya nakledilmez. Form verilerinin 
aşağıdaki yaklaşımlardan bir veya daha fazlası tarafından nakledilmediğinden emin olun: 

• @No__t-0 yöntemine bir kesme noktası koyun. Formu gönder ( Oluştur veya Kaydet 1 i seçin). Kesme 
noktası hiçbir şekilde isabet ettirilmez. 









• Fiddler aracınıkullanın. 

• Ağ trafiğini izlemek için tarayıcı Geliştirici Araçları ' nı kullanın. 

Sunucu tarafı doğrulaması 

Tarayıcıda JavaScript devre dışı bırakıldığında, formun hatalarla gönderilmesi sunucuya gönderilir, 
isteğe bağlı, test sunucusu-tarafı doğrulaması: 

• Tarayıcıda JavaScript 'ı devre dışı bırakın. Tarayıcının geliştirici araçlarını kullanarak JavaScript 'ı devre 
dışı bırakabilirsiniz. Tarayıcıda JavaScript 'ı devre dışı bırakadıysanız başka bir tarayıcı deneyin. 

• Oluşturma veya düzenleme sayfasının onPostAsync yönteminde bir kesme noktası ayarlayın. 

• Geçersiz verilerle form gönderme. 

• Model durumunun geçersiz olduğunu doğrulayın: 

if (IModelState.IsValid) 

{ 

return Page(); 

} 


Aşağıdaki kod, öğreticide daha önce Create. cshtml sayfa scafkatın bir bölümünü gösterir, ilk formu 
görüntülemek ve bir hata durumunda formu yeniden görüntülemek için sayfa oluşturma ve düzenleme sayfaları 
tarafından kullanılır. 


<form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<div class="form-group"> 

<label asp-for="Movie.Title" class="control-label"x/label> 

<input asp-for="Movie.Title" class="form-control" /> 

<span asp-validation-for="Movie.Title" class="text-danger"x/span> 
</div> 


Giriş etiketi Yardımcısı , dataaçıklamaların özniteliklerini kullanır ve istemci tarafında jQuery doğrulaması için 
gerekli HTML özniteliklerini üretir. Doğrulama etiketi Yardımcısı doğrulama hatalarını görüntüler. Daha fazla 
bilgi için bkz. doğrulama . 

Oluşturma ve düzenleme sayfalarında hiçbir doğrulama kuralı yoktur. Doğrulama kuralları ve hata dizeleri 
yalnızca Movie sınıfında belirtilmiştir. Bu doğrulama kuralları, Movie modelini düzenleyebilen Razor Pages 
otomatik olarak uygulanır. 

Doğrulama mantığının değişmesi gerektiğinde, yalnızca modelde yapılır. Doğrulama, uygulamanın tamamında 
tutarlı bir şekilde uygulanır (doğrulama mantığı tek bir yerde tanımlanır). Tek bir yerde doğrulama, kodun temiz 
kalmasına yardımcı olur ve bakım ve güncelleştirme işlemlerini kolaylaştırır. 

DataType özniteliklerini kullanma 

@No__t-0 sınıfını inceleyin. @No__t-0 ad alanı, yerleşik doğrulama öznitelikleri kümesine ek olarak 
biçimlendirme öznitelikleri sağlar. @No__t-0 özniteliği ReleaseDate ve Price özelliklerine uygulanır. 









[Display(Name = "Release Date")] 

[DataType(DataType.Date)] 

public DateTime ReleaseDate { get; set; } 

[Range(l, 100)] 

[DataType(DataType.Currency)] 
public decimal Pnice { get; set; } 

@No__t-0 öznitelikleri yalnızca görünüm altyapısının verileri biçimlendirmek için ipuçları sağlar (ve URL için 


<a> 

ve e-posta için 

<a 

ı href="mailto:EmailAddress.com"> 

gibi öznitelikleri sağlar). Verilerin biçimini doğrulamak 

için 

RegularExpression 

özniteliğini kullanın. @No__t-0 özniteliği, veritabanı iç türünden daha belirgin bir veri 


türü belirtmek için kullanılır. DataType öznitelikleri doğrulama öznitelikleri değildir. Örnek uygulamada, yalnızca 
tarih ve saat olmadan görüntülenir. 

@No__t-0 numaralandırması, tarih, saat, PhoneNumber, para birimi, Emaadresi ve daha fazlası gibi birçok veri 
türü sağlar. @No__t-0 özniteliği Ayrıca uygulamanın türe özgü özellikleri otomatik olarak sağlamasını da 
sağlayabilir. Örneğin, DataType.EmailAddress için mailto: bağlantısı oluşturulabilir. HTML5'i destekleyen 
tarayıcılarda DataType.Date için bir tarih seçici sağlanmış olabilir. @No__t-0 öznitelikleri HTML 5 tarayıcıların 
kullandığı HTML 5 data- (veri Dash) özniteliklerini yayar. @No__t-0 öznitelikleri herhangi bir doğrulama 
sağlamaz. 

DataType.Date , görüntülenen tarihin biçimini belirtmiyor. Varsayılan olarak, veri alanı, sunucunun cuitureinfo 1 
a göre varsayılan biçimlere göre görüntülenir. 

@No__t-0 veri ek açıklaması gereklidir, bu nedenle Entity Framevvork Core veritabanındaki para birimine Price 
1 i doğru şekilde eşleyebilir. Daha fazla bilgi için bkz. veri türleri. 

@No__t-0 özniteliği, açıkça tarih biçimini belirtmek için kullanılır: 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 
public DateTime ReleaseDate { get; set; } 

@No__t-0 ayarı, değer düzenlenmek üzere görüntülendiğinde biçimlendirmenin uygulanacağını belirtir. Bazı 
alanlar için bu davranışı istemiyor olabilirsiniz. Örneğin, para birimi değerlerinde, büyük olasılıkla düzenleme 
kullanıcı arabirimindeki para birimi sembolünü istemezsiniz. 

@No__t-0 özniteliği kendisi tarafından kullanılabilir, ancak genellikle DataType özniteliğini kullanmak iyi bir fikir 
olabilir. @No__t-0 özniteliği, verilerin semantiğini bir ekranda nasıl işleneceğini değil ve DisplayFormat ile elde 
olmadığınız avantajları sağlar: 

• Tarayıcı HTML5 özelliklerini etkinleştirebilir (örneğin, bir Takvim denetimini, yerel ayara uygun para birimi 
sembolünü, e-posta bağlantılarını vb. göstermek için) 

• Varsayılan olarak tarayıcı, verileri yerel ayarınızı temel alarak doğru biçimi kullanarak işleyebilir. 

• @No__t-0 özniteliği, ASP.NET Core çerçevesinin verileri işlemek için doğru alan şablonunu seçmesini 
sağlayabilir. Kendisi tarafından kullanılıyorsa DisplayFormat , dize şablonunu kullanır. 

Note:jöuery doğrulaması Range özniteliğiyle ve DateTime ile çalışmaz. Örneğin, aşağıdaki kod, tarih belirtilen 
aralıkta olduğunda bile her zaman bir istemci tarafı doğrulama hatası görüntüler: 

[Range(typeof(DateTime), "1/1/1966", "1/1/2020")] 

Modellerinizde sabit tarihleri derlemek genellikle iyi bir uygulamadır, bu nedenle Range özniteliği ve DateTime 
kullanılması önerilmez. 


Aşağıdaki kod, öznitelikleri tek bir satırda birleştirmeyi gösterir: 






















public class Movie 

{ 

public int ID { get; set; } 

[StringLength(60, MinimumLength = 3)] 
public string Title { get; set; } 

[Display(Name = "Release Date"), DataType(DataType.Date)] 
public DateTime ReleaseDate { get; set; } 

[RegularExpression(@" A [A-Z]+[a-zA-Z"" 1 \s-]*$"), Required, StringLength(30)] 
public string Genre { get; set; } 

[Range(l, 100), DataType(DataType.Currency)] 

[Column(TypeName = "decimal(18, 2)")] 
public decimal Price { get; set; } 

[RegularExpression(@" A [A-Z]+[a-zA-Z0-9""'\s-]*$"), StringLength(S)] 
public string Rating { get; set; } 


Razor Pages kullanmaya başlayın ve EF Core gelişmiş EF Core işlemlerini Razor Pages gösterir. 

Geçişleri Uygula 

Sınıfa uygulanan Dataek açıklamaları şemayı değiştirir.Örneğin, Title alanına uygulanan veri ek açıklamaları: 

[StringLength(60, MinimumLength = 3)] 

[Required] 

public string Title { get; set; } 


• Karakterleri 60 olarak sınırlandırır. 

• @No__t-0 değerine izin vermez. 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 
@No__t-0 tablosu şu anda aşağıdaki şemaya sahiptir: 


CREATE TABLE [dbo] 

.[Movie] ( 



[ID] 

INT 

IDENTITY (1, 1) NOT 

NULL, 

[Title] 

NVARCHAR (MAX) 

NULL, 


[ReleaseDate] 

DATETIME2 (7) 

NOT NULL, 


[Genre] 

NVARCHAR (MAX) 

NULL, 


[Price] 

DECİMAL (18, 2) 

NOT NULL, 


[Rating] 

NVARCHAR (MAX) 

NULL, 


CONSTRAINT [PK_Movİe] PRIMARY 

); 

KEY CLUSTERED ([ID] 

ASC) 


Önceki şema değişiklikleri, EF 'in özel durum oluşturmasına neden olmaz. Ancak, şemanın modelle tutarlı 
olması için bir geçiş oluşturun. 


Araçlar menüsünde NuGet Paket Yöneticisi > Paket Yöneticisi konsolu 1 nu seçin. PMC de aşağıdaki 
komutları girin: 


Add-Migration New_DataAnnotations 
Update-Database 

yöntemlerini çalıştırır. @No__t-0 yöntemini inceleyin: 


Update-Database 

New_DataAnnotations 

sınıfının 

Up 







public partial class New_DataAnnotations : Migration 

{ 

protected override void Up(MigrationBuilder migrationBuilder) 

{ 

migrationBuilder.AlterColumn<string>( 
name: "Title", 
table: "Movie", 
maxLength: 60, 
nullable: false, 
oldClrType: typeof(string), 
oldNullable: true); 

migrationBuilder.AlterColumn<string>( 
name: "Rating", 
table: "Movie", 
maxLength: S, 
nullable: false, 
oldClrType: typeof(string), 
oldNullable: true); 

migrationBuilder.AlterColumn<string>( 
name: "Genre", 
table: "Movie", 
maxLength: 30, 
nullable: false, 
oldClrType: typeof(string), 
oldNullable: true); 


Güncelleştirilmiş Movie tablosu aşağıdaki şemaya sahiptir: 


CREATE TABLE [dbo].[Movie] ( 

[ID] INT 

[Title] NVARCHAR (60) 

[ReleaseDate] DATETIME2 (7) 

[Genre] NVARCHAR (30) 

[Price] DECIMAL (18, 2) NOT NULL, 

[Rating] NVARCHAR (5) NOT NULL, 

CONSTRAINT [PK_Movİe] PRIMARY KEY CLUSTERED ([ID] ASC) 

); 


IDENTITY (1, 1) NOT NULL, 
NOT NULL, 

NOT NULL, 

NOT NULL, 


Azure'a Yayımlama 

Azure 'a dağıtma hakkında bilgi için bkz. öğretici: Azure 'DA SQL veritabanı ile ASP.NET Core uygulama 
oluşturma. 

Razor Pages için bu giriş tamamlanırken teşekkürler. Razor Pages kullanmaya başlayın ve Bu öğreticiye en 
uygun harika bir izleme EF Core. 

Ek kaynaklar 

• ASP.NET Core formlardaki etiket yardımcıları 

• ASP.NET Core Genelleştirme ve yerelleştirme 

• ASP.NET Core etiket yardımcıları 

• AS P.N ET core'da Yazar etiket Yardımcıları 

• Bu öğreticinin YouTube sürümü 


ÖNCEKİ: YENİ BİR ALAN 


EKLEM E 








ASPNET Core Razor Pages için filtre yöntemleri 

19.10.2019 • 6 minutes to read ı Edit Online 


Rick Anderson tarafından 

Razor sayfa filtreleri ıpagefilter ve lasyncpagefilter Razor Pages, bir Razor sayfa işleyicisi çalıştırılmadan önce ve 
sonra kodu çalıştırmasına izin verir. Razor sayfası filtreleri, tek sayfa işleyicisi yöntemlerine uygulanamadığından, 

ASP.NET Core MVC eylem filtrelerinebenzerdir. 

Razor sayfası filtreleri: 

• Bir işleyici yöntemi seçildikten sonra, ancak model bağlama gerçekleşmeden önce kodu çalıştırın. 

• Model bağlama işlemi tamamlandıktan sonra işleyici metodu yürütülmeden önce kodu çalıştırın. 

• işleyici yöntemi yürütüldükten sonra kodu çalıştırın. 

• , Bir sayfada veya genel olarak uygulanabilir. 

• Belirli sayfa işleyici yöntemlerine uygulanamaz. 

Bir işleyici yöntemi sayfa Oluşturucusu veya ara yazılım kullanılarak yürütülmeden önce kod çalıştırılabilir, ancak 
yalnızca Razor sayfası filtrelerinin HttpContext'e erişimi vardır. Filtrelerin HttpContext erişim sağlayan bir 
Filtercontext türetilmiş parametresi vardır. Örneğin, bir filtre uygula özniteliği örneği yanıta, oluşturucular veya ara 
yazılım ile yapılamadığını belirten bir üst bilgi ekler. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Razor sayfası filtreleri, genel olarak veya sayfa düzeyinde uygulanabilecek aşağıdaki yöntemleri sağlar: 

• Zaman uyumlu Yöntemler: 

o Onpagehandlerselected : bir işleyici yöntemi seçildikten sonra, ancak model bağlama gerçekleşmeden 
önce çağırılır. 

o Onpagehandlerexecuting : İşleyici Yöntemi yürütülmeden önce çağırılır, model bağlama işlemi 
tamamlandıktan sonra. 

o Onpagehandleryürütüldü : işleyici yöntemi yürütüldükten sonra, eylem sonucundan önce çağırılır. 

• Zaman uyumsuz yöntemler: 

o Onpagehandlerselectionasync : Flandler yöntemi seçildikten sonra zaman uyumsuz olarak çağırılır, ancak 
model bağlama gerçekleşmeden önce. 

o Onpagehandlerexecutionasync : Handler yöntemi çağrılmadan önce zaman uyumsuz olarak çağrıldı, 
model bağlama işlemi tamamlandıktan sonra. 


NOTE 

Her ikisini de değil, bir filtre arabiriminin zaman uyumlu veya zaman uyumsuz sürümünü uygulayın. Çerçeve öncelikle 
filtrenin zaman uyumsuz arabirimi uygulayıp uygulamadığını denetler ve bu durumda bunu çağırır. Aksi takdirde, zaman 
uyumlu arabirimin Yöntem (ler) i çağırır. Her iki arabirim de uygulanmışsa yalnızca zaman uyumsuz yöntemler çağrılır. Aynı 
kural sayfalardaki geçersiz kılmalara uygulanır, her ikisine de değil, geçersiz kılmanın zaman uyumlu veya zaman uyumsuz 
sürümünü uygular. 


Razor sayfası filtrelerini küresel olarak uygulama 


Aşağıdaki kod iAsyncPageFiiter uygular: 









using Microsoft.AspNetCore.Mvc.Filters; 
using Microsoft.Extensions.Logging; 
using System.Threading.Tasks; 

namespace PageFilter.Filters 

{ 

public class SampleAsyncPageFilter : IAsyncPageFilter 

{ 

private readonly ILogger _logger; 

public SampleAsyncPageFilter(ILogger logger) 

{ 

_logger = logger; 

} 

public async Task OnPageHandlerSelectionAsync( 

PageHandlerSelectedContext context) 

{ 

_logger.LogDebug("Global OnPageHandlerSelectionAsync called."); 
await Task.CompletedTask; 

} 

public async Task OnPageFlandlerExecutionAsync( 

PageHandlerExecutingContext context, 
PageHandlerExecutionDelegate next) 

{ 

_logger.LogDebug("Global OnPageHandlerExecutionAsync called."); 
await next.Invoke(); 

} 

} 

} 


Yukarıdaki kodda, ILogger gerekli değildir. Uygulama için izleme bilgilerini sağlamak üzere örnekte kullanılır. 
Aşağıdaki kod startup sınıfındaki SampleAsyncPageFilter sunar: 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddMvc(options => 

{ 

options.Filters.Add(new SampleAsyncPageFilter(_logger)); 

}); 

} 


Aşağıdaki kod, tüm startup sınıfını gösterir: 







using Microsoft.AspNetCore.Builder; 
using Microsoft.AspNetCore.Hosting; 
using Microsoft.Extensions.Configuration; 
using Microsoft.Extensions.DependencyInjection; 
using Microsoft.Extensions.Logging; 
using PageFilter.Filters; 

namespace PageFilter 

{ 

public class Startup 

{ 

ILogger _logger; 

public Startup(ILoggerFactory loggerFactory, IConfiguration configuration) 

{ 

_logger = loggerFactory.Createl_ogger<GlobalFiltersl_ogger>(); 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddMvc(options => 

{ 

options.Filters.Add(new SampleAsyncPageFilter(_logger)); 

}); 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 
app.UseCookiePolicy(); 

app.UseMvc(); 

} 

} 

} 

Aşağıdaki kod, sampleAsyncPageFilter yalnızca /alt klasöründekisayfa\ara uygulamak için 
AddFolderApplicationModelConvention çağInr: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services .AddMvc() 

.AddRazorPagesOptions(options => 

{ 

options.Conventions.AddFolderApplicationModelConvention( 

"/subFolder", 

model => model.Filters.Add(new SampleAsyncPageFilter(_logger))); 

})J 

} 


Aşağıdaki kod, zaman uyumlu iPageFilter uygular: 





using Microsoft.AspNetCore.Mvc.Filters; 
using Microsoft.Extensions.Logging; 

namespace PageFilter.Filters 

{ 

public class SamplePageFilter : IPageFilter 

{ 

private readonly ILogger _logger; 

public SamplePageFilter(ILogger logger) 

{ 

_logger = logger; 

} 

public void OnPageHandlerSelected(PageFlandlerSelectedContext context) 

{ 

_logger.LogDebug("Global sync OnPageHandlerSelected called."); 

} 

public void OnPageHandlerExecuting(PageHandlerExecutingContext context) 

{ 

_logger. LogDebug( "Global sync PageHandlerExecutingContext called."); 

} 

public void OnPageHandlerExecuted(PageFlandlerExecutedContext context) 

{ 

_logger.LogDebug("Global sync OnPageHandlerExecuted called."); 

} 

} 

} 


Aşağıdaki kod SamplePageFilter etkinleştirilir: 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddMvc(options => 

{ 

options.Filters.Add(new SamplePageFilter(_logger)); 

}); 

} 


Filtre yöntemlerini geçersiz kılarak Razor sayfası filtrelerini uygulama 

Aşağıdaki kod, zaman uyumlu Razor sayfası filtrelerini geçersiz kılar: 





using Microsoft.AspNetCore.Mvc.Filters; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.Extensions.Logging; 

namespace PageFilter.Pages 

{ 

public class IndexModel : PageModel 

{ 

private readonly ILogger _logger; 

public IndexModel(ILogger<IndexModel> logger) 

{ 

_logger = logger; 

} 

public string Message { get; set; } 

public void OnGet() 

{ 


_logger.LogDebug("IndexModel/OnGet"); 

} 

public override void OnPageHandlerSelected( 

PageFlandlerSelectedContext context) 


{ 


_logger.LogDebug("IndexModel/OnPageHandlerSelected"); 

} 


public override void OnPageHandlerExecuting( 

PageFlandlerExecutingContext context) 

{ 

Message = "Message set in handler executing"; 

_logger.LogDebug("IndexModel/OnPageHandlerExecuting"); 

} 


public override void OnPageHandlerExecuted( 

PageFlandlerExecutedContext context) 

{ 

_logger.LogDebug("IndexModel/OnPageHandlerExecuted"); 

} 


Filtre özniteliği uygulama 

Yerleşik öznitelik tabanlı filtre Onresultexecutionasync filtresi, alt sınıflı olabilir. Aşağıdaki filtre yanıta bir üst bilgi 
ekler: 



using System.Threading.Tasks; 

using Microsoft.AspNetCore.Mvc.Filters; 

namespace PageFilter.Filters 

{ 

public class AddHeaderAttribute : ResultFilterAttribute 

{ 

private readonly string _name; 
private readonly string _value; 

public AddHeaderAttribute (string name, string value) 

{ 

_name = name; 

_value = value; 

> 

public override void OnResultExecuting(ResultExecutingContext context) 

{ 

context.HttpContext.Response.Headers.Add(_name, new string[] { _value }); 

} 

} 

} 


Aşağıdaki kod AddHeader özniteliğini uygular: 

[AddHeader("Author", "Rick")] 

public class ContactModel : PageModel 

{ 

private readonly ILogger _logger; 

public ContactModel(ILogger<ContactModel> logger) 

{ 

_logger = logger; 

} 

public string Message { get; set; } 

public async Task OnGetAsync() 

{ 

Message = "Your contact page."; 

_logger.LogDebug("Contact/OnGet"); 
await Task.CompletedTask; 

} 


Sıralamayı geçersiz kılma yönergeleri için bkz. varsayılan sırayı geçersiz kılma . 
Filtre işlem hattının bir filtreden kısa devre dışı olması için bkz. iptal ve kısa devre. 

Yetkilendir filtre özniteliği 

Yetkilendir özniteliği bir PageModel uygulanabilir: 





using Microsoft.AspNetCore.Authorization; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.RazorPages; 


namespace PageFilter.Pages 

{ 

[Authorize] 

public class Modell/JithAuthFilterModel : 

PageModel 


{ 

public IActionResult OnGet() = > Page(); 

} 

} 



ASPNET Core Razor Pages yol ve uygulama 
kuralları 
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Luke Latham tarafından 

Razor Pages uygulamalarında sayfa yönlendirmeyi, bulmayı ve işlemeyi denetlemek için sayfa yolu ve 
uygulama modeli sağlayıcısı kurallarını nasıl kullanacağınızı öğrenin. 

Ayrı sayfalar için özel sayfa yolları yapılandırmanız gerektiğinde, bu konunun ilerleyen kısımlarında açıklanan 
Addpageroute kuralına sahip sayfalara yönlendirmeyi yapılandırın. 

Bir sayfa yolu belirtmek, yol kesimleri eklemek veya bir rotaya parametreler eklemek için, sayfanın @page 
yönergesini kullanın. Daha fazla bilgi için bkz. özel rotalar. 

Yol kesimleri veya parametre adları olarak kullanılamayan ayrılmış sözcükler vardır.Daha fazla bilgi için bkz. 

Yönlendirme: ayrılmış yönlendirme adları. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

SENARYO ÖRNEK GÖSTERİLMEKTEDİR... 

Model kuralları Uygulamanın sayfalarına bir yol şablonu ve üst bilgi ekleyin. 

Kurallar. Add 

• Ipageroutemodelconvention 

• Ipageapplicationmodelconvention 

• Ipagehandlermodelconvention 


Sayfa yolu eylem kuralları Bir klasördeki sayfalara ve tek bir sayfaya rota şablonu 

• AddFolderRouteModelConvention ekleyin. 

• AddPageRouteModelConvention 

• AddPageRoute 


Sayfa modeli eylem kuralları 

• AddFolderApplicationModelConvention 

• AddPageApplicationModelConvention 

• ConfigureFilter (filtre sınıfı, lambda ifadesi veya filtre 
fabrikası) 


Bir klasördeki sayfalara üst bilgi ekleyin, tek bir sayfaya üst 
bilgi ekleyin ve bir filtre fabrikası yapılandırarak 
uygulamanın sayfalarına üst bilgi ekleyin. 


Razor Pages kuralları, startup sınıfında hizmet koleksiyonuna AddMvc için AddRazorPagesOptions uzantısı 
yöntemi kullanılarak eklenir ve yapılandırılır. Aşağıdaki kural örnekleri bu konunun ilerleyen kısımlarında 
açıklanmıştır: 






public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRazorPages() 

.AddRazorPagesOptions(options => 

{ 

options.Conventions.Add( ... ); 

options.Conventions.AddFolderRouteModelConvention( 
"/OtherPages", model => { ... }); 
options.Conventions.AddPageRouteModelConvention( 
"/About", model => { ... }); 
options.Conventions.AddPageRoute( 

"/Contact ", ”TheContactPage/{text?}"); 
options.Conventions.AddFolderApplicationModelConvention( 
"/OtherPages", model => { ... }); 
options.Conventions.AddPageApplicationModelConvention( 
"/About"j model => { ... }); 
options.Conventions.ConfigureFilter(model => { ... }); 
options.Conventions.ConfigureFilter( ... ); 

}); 

} 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services. AddMvc() 

.AddRazorPagesOptions(options => 

{ 

options.Conventions.Add( ... ); 

options.Conventions.AddFolderRouteModelConvention( 
"/OtherPages", model => { ... }); 
options.Conventions.AddPageRouteModelConvention( 
"/About", model => { ... }); 
options.Conventions.AddPageRoute( 

"/Contact ", ”TheContactPage/{text?}"); 
options.Conventions.AddFolderApplicationModelConvention( 
"/OtherPages", model => { ... }); 
options.Conventions.AddPageApplicationModelConvention( 
"/About", model => { ... }); 
options.Conventions.ConfigureFilter(model => { ... }); 
options.Conventions.ConfigureFilter( ... ); 

}); 

} 


Rota sırası 

Rotalar işleme için bir Order belirtir (rota eşleştirme). 

SİPARİŞİ 

-1 

o 


DAVRANIŞ 

Yol, diğer rotalar işlenmeden önce işlenir. 

Sıra belirtilmemiş (varsayılan değer). @No_t_0 atanmazsa ( 
order = null ), yolun işlenmek üzere 0 (sıfır) olarak 
Order . 


1, 2,... n Yol işleme sırasını belirtir. 

Yol işleme, kurala göre belirlenir: 

• Yollar sıralı sırada işlenir (-1,0,1, 2,... n). 

• Yolların aynı order olduğunda, en belirli yol önce daha az özel yollarla eşleştirilir. 




• Aynı order ve aynı parametre sayısı ile rotalar bir istek URL 'siyle eşleşiyorsa, rotalar 
PageConventionCollection eklendiği sırada işlenir. 

Mümkünse, belirlenen bir yol işleme sırasına bağlı olarak kullanmaktan kaçının. Genellikle Yönlendirme, URL 
eşleştirme ile doğru yolu seçer, istekleri doğru yönlendirmek için yol order özelliklerini ayarlamanız 
gerekiyorsa, uygulamanın yönlendirme şeması büyük olasılıkla istemciler için kafa karıştırıcı olur ve bakımını 
yapmak için kırıcı olur. Uygulamanın yönlendirme şemasını basitleştirecek şekilde arama yapın. Örnek 
uygulama, tek bir uygulama kullanarak birkaç yönlendirme senaryosunu göstermek için açık bir yol işleme 
sırası gerektirir. Ancak, üretim uygulamalarında rota order ayarlama uygulamalarından kaçınmaya çalışın. 

Razor Pages yönlendirme ve MVC denetleyici yönlendirme bir uygulamayı paylaşır. MVC konularındaki yol 
sırasıyla ilgili bilgiler, Denetleyici eylemlerine yönlendirme sırasında mevcuttur: öznitelik yollarını sıralama. 

Model kuralları 

Razor Pages için uygulanan model kuralları eklemek üzere IPageConvention için bir temsilci ekleyin. 

Tüm sayfalara bir rota modeli kuralı ekleme 

Sayfa yönlendirme modeli oluşturma sırasında uygulanan IPageConvention örnekleri koleksiyonuna bir 
IPageRouteModelConvention oluşturmak ve eklemek için Conventions kullanın. 

Örnek uygulama, uygulamadaki tüm sayfalara bir {globaiTemplate?} Route şablonu ekler: 

public class GlobalTemplatePageRouteModelConvention 
: IPageRouteModelConvention 

{ 

public void Apply(PageRouteModel model) 

{ 

var selectorCount = model.Selectors.Count; 
for (var i = 0; i < selectorCountj i++) 

{ 

var selector = model.Selectors[i]j 
model.Selectors.Add(new SelectorModel 
{ 

AttributeRouteModel = new AttributeRouteModel 
{ 

Order = 1, 

Template = AttributeRouteModel.CombineTemplates( 
selector.AttributeRouteModel.Template, 

"{globaiTemplate ?}"), 

} 

}); 

} 

} 

} 






public class GlobalTemplatePageRouteModelConvention 
: IPageRouteModelConvention 

{ 

public void Apply(PageRouteModel model) 

{ 

var selectorCount = model.Selectors.Count; 
for (var i = 0; i < selectorCountj i++) 

{ 

var selector = model.Selectors[i]j 
model.Selectors.Add(new SelectorModel 
{ 

AttributeRouteModel = new AttributeRouteModel 
{ 

Order = 1, 

Template = AttributeRouteModel.CombineTemplates( 
selector.AttributeRouteModel.Template, 

"{globalTemplate ?}"), 

} 

}); 

} 

} 

} 

@No__t_1 için Order özelliği ı olarak ayarlanmıştır. Bu, örnek uygulamada aşağıdaki yol eşleştirme 
davranışını sağlar: 


• @No__t_0 için bir yol şablonu konuya daha sonra eklenir. İletişim sayfası yolu, nuiı ( order = 0 ) 
varsayılan sırasına sahiptir, bu nedenle {globalTemplate?} Route şablonundan önce eşleşir. 


• Konunun ilerleyen kısımlarında {aboutTemplate?} 

yol şablonu eklenir. @No__t_0 şablonuna 2 

Order 

verilir. @No__t_0 sayfası istendiğinde, 

Order = 2 

özelliğinin ayarlanması nedeniyle "RouteDataValue" 

RouteData.Values["globalTemplate"] ( 

Order = 1 ) 

ve RouteData.Values["aboutTemplate"] ( Order 

) değil. 


• Konunun ilerleyen kısımlarında {otherPagesTemplate?} yol şablonu eklenir. @No__t_0 şablonuna 2 
order verilir. Sayfalar/diğer sayfalar klasöründeki herhangi bir sayfa bir yol parametresiyle (örneğin, 
/otherPages/Pagei/RouteDatavaiue ) istendiğinde, Order = 2 özelliğinin ayarlanması nedeniyle 
"routedatavalue", RouteData.Values["otherPagesTemplate"] ( Order ) değil 
RouteData.Values["globalTemplate"] ( Order = 1 ) olarak yüklenir. 

Mümkün olan yerlerde, order Order = 0 sonuç olarak ayarlanmayın. Doğru yolu seçmek için 
yönlendirmeyi güvenin. 

@No__t_0 ekleme gibi Razor Pages seçenekler, MVC startup.configureServices hizmet koleksiyonuna 
eklendiğinde eklenir. Örnek için bkz. örnek uygulama. 

options.Conventions.Add(new GlobalTemplatePageRouteModelConvention()); 

options.Conventions.Add(new GlobalTemplatePageRouteModelConvention()); 

@No__t_0 'de örneğin hakkında sayfasını isteyin ve sonucu inceleyin: 
















□ X 

☆ L & — 


ModelProvİdersSample Home Other Pages - About Contact 


About 

Your application description page. 

Use this area to provide additional information. 

Route data for ’globalTemplate' was provided: GlobalRouteValue 
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0 «3 B About - ModelProvider: X + v 

O (jet localhost:5000/About/GlobalRouteValue | 


Tüm sayfalara uygulama modeli kuralı ekleme 

@No__t_0 kullanarak, sayfa uygulama modeli oluşturma sırasında uygulanan IPageConvention örnekleri 
koleksiyonuna bir IPageApplicationModelConvention ekleyin. 

Bu ve diğer kuralları konunun ilerleyen kısımlarında göstermek için, örnek uygulama bir AddHeaderAttribute 
sınıfı içerir. Sınıf Oluşturucusu bir name dize ve bir values dize dizisi kabul eder. Bu değerler, yanıt üst 
bilgisini ayarlamak için 0nResuitExecuting yönteminde kullanılır. Tam sınıf, konusunun ilerleyen kısımlarında 

sayfa modeli eylem kuralları bölümünde gösterilir. 

Örnek uygulama, uygulamadaki tüm sayfalara bir başlık, GlobalHeader eklemek için AddHeaderAttribute 
sınıfını kullanır: 

public class GlobalHeaderPageApplicationModelConvention 
: IPageApplicationModelConvention 

{ 

public void Apply(PageApplicationModel model) 

{ 

model.Filters.Add(new AddHeaderAttribute( 

"GlobalHeader ", new string[] { "Global Header Value" })); 

} 

} 


public class GlobalHeaderPageApplicationModelConvention 
: IPageApplicationModelConvention 

{ 

public void Apply(PageApplicationModel model) 

{ 

model.Filters.Add(new AddHeaderAttribute( 

"GlobalHeader ", new string[] { "Global Header Value" })); 

} 

} 

Startup.es : 

options.Conventions.Add(new GlobalHeaderPageApplicationModelConvention()); 


options.Conventions.Add(new GlobalHeaderPageApplicationModelConvention()); 

@No__t_0 sırasında örneğin hakkında daha fazla bilgi isteyin ve sonucu görüntülemek için üst bilgileri 





















inceleyin: 


▼ Response Headers view source 
AboutHeader: About Header Value 
Content-Type: text/html; charset=utf-8 
Date: Thu, 19 Oct 2017 21:09:07 GMT 
FilterFactoryHeader: Filter Factony Header Value 1 
FilterFactor^Headen_Filter_Façtory Header Value 2 
| GlobalHeader: Global Header Value 
Server: Kestrel 

Transfer-Encoding: chunked 

Tüm sayfalara bir işleyici modeli kuralı ekleme 

Sayfa işleyicisi modelinin oluşturulması sırasında uygulanan IPageConvention örnekleri koleksiyonuna bir 
IPageHandlerModelConvention oluşturmak ve eklemek için Conventions kullanın. 

public class GlobalPageHandlerModelConvention 
: IPageHandlerModelConvention 

{ 

public void Apply(PageHandlerModel model) 

{ 

// Access the PageHandlerModel 

} 

} 


public class GlobalPageHandlerModelConvention 
: IPageHandlerModelConvention 

{ 

public void Apply(PageHandlerModel model) 
{ 

// Access the PageHandlerModel 

} 

} 


Startup.es : 


options.Conventions.Add(new GlobalPageHandlerModelConvention()); 


options.Conventions.Add(new GlobalPageHandlerModelConvention()); 


Sayfa yolu eylem kuralları 

@No__t_0 türetilen varsayılan yol modeli sağlayıcısı, sayfa yollarını yapılandırmak için genişletilebiIirlik 
noktaları sağlamak üzere tasarlanan kuralları çağırır. 

Klasör Yönlendirme modeli kuralı 

Belirtilen klasör altındaki tüm sayfalar için PageRouteModel bir eylemi çağıran bir 
IPageRouteModelConvention oluşturmak ve eklemek için AddFolderRouteModelConvention kullanın. 

Örnek uygulama, diğer sayfalar klasöründeki sayfalara bir {otherPagesTemplate?} yol şablonu eklemek için 

AddFolderRouteModelConvention kullanır: 







options.Conventions.AddFolderRouteModelConvention("/OtherPages", model => 

{ 

var selectorCount = model.Selectors.Count; 
for (var i = 0; i < selectorCount; i++) 

{ 

var selector = model.Selectors[i]; 
model.Selectors.Add(new SelectorModel 
{ 

AttributeRouteModel = new AttributeRouteModel 

{ 

Order = 2, 

Template = AttributeRouteModel.CombineTemplates( 
selector.AttributeRouteModel.Template, 
"{otherPagesTemplate?}"), 

} 

}); 

} 

}); 


options.Conventions.AddFolderRouteModelConvention("/OtherPages", model => 

{ 

var selectorCount = model.Selectors.Count; 
for (var i = 0; i < selectorCount; i++) 

{ 

var selector = model.Selectors[i]; 
model.Selectors.Add(new SelectorModel 
{ 

AttributeRouteModel = new AttributeRouteModel 

{ 

Order = 2, 

Template = AttributeRouteModel.CombineTemplates( 
selector.AttributeRouteModel.Template, 

"{otherPagesTemplate?}"), 

} 

}); 

} 

}); 

@No__t_1 için Order özelliği 2 olarak ayarlanmıştır. Bu, tek bir rota değeri sağlandığında {globaiTemplate?} 
(konuda daha önce ı olarak ayarlanan) şablonunun ilk yol veri değeri konumu için öncelik verilmesini 
sağlar. Sayfalar/otherpages klasöründeki bir sayfa bir yol parametresi değeri (örneğin, 


/OtherPages/Pagel/RouteDataValue ) ile isteniyorsa, 

Order = 

= 2 

özelliğinin 

ayarlanması nedeniyle 

"routedatavalue", 

RouteData.Values["otherPagesTemplate"] 

( Order ) değil 

RouteData.Values["globaiTemplate"] 


( order = ı ) olarak yüklenir. 

Mümkün olan yerlerde, order order = 0 sonuç olarak ayarlanmayın. Doğru yolu seçmek için 
yönlendirmeyi güvenin. 

Örnekteki Sayfal sayfasını localhost:5000/OtherPages/Pagel/GlobalRouteValue/OtherPagesRouteValue isteyin ve 
sonucu inceleyin: 









Sayfa yönlendirme modeli kuralı 

Belirtilen ada sahip sayfanın PageRouteModel bir eylemi çağıran bir IPageRouteModelConvention 
oluşturmak ve eklemek için AddPageRouteModelConvention kullanın. 

Örnek uygulama, hakkında sayfasına bir {aboutTemplate?} yol şablonu eklemek için 
AddPageRouteModelConvention kullanır 


options.Conventions.AddPageRouteModelConvention("/About", model => 

{ 

var selectorCount = model.Selectors.Count; 
for (var i = 0; i < selectorCount; i++) 

{ 

var selector = model.Selectors[i]; 
model.Selectors.Add(new SelectorModel 
{ 

AttributeRouteModel = new AttributeRouteModel 

{ 

Order = 2, 

Template = AttributeRouteModel.CombineTemplates( 
selector.AttributeRouteModel.Template, 
"{aboutTemplate?}"), 

} 

}); 

} 

}); 


options.Conventions.AddPageRouteModelConvention("/About", model => 

{ 

var selectorCount = model.Selectors.Count; 
for (var i = 0; i < selectorCount; i++) 

{ 

var selector = model.Selectors[i]; 
model.Selectors.Add(new SelectorModel 
{ 

AttributeRouteModel = new AttributeRouteModel 

{ 

Order = 2, 

Template = AttributeRouteModel.CombineTemplates( 
selector.AttributeRouteModel.Template, 

"{aboutTemplate?}"), 

} 

}); 

} 

}); 

@No__t_1 için Order özelliği 2 olarak ayarlanmıştır. Bu, tek bir rota değeri sağlandığında {globaiTemplate?} 





















(konuda daha önce ı olarak ayarlanan) şablonunun ilk yol veri değeri konumu için öncelik verilmesini 



yönlendirmeyi güvenin. 

@No__t_0 'de örneğin hakkında sayfasını isteyin ve sonucu inceleyin: 



Sayfa yollarını özelleştirmek için bir parametre transformatörü 
kullanın 

AS P.N ET Core tarafından oluşturulan sayfa yolları, bir parametre transformatörü kullanılarak özelleştirilebilir. 
Bir parametre transformatörü ıoutboundParameterTransformer uygular ve parametrelerin değerini dönüştürür. 
Örneğin, özel bir SlugifyParameterTransformer parametresi transformatörü SubscriptionManagement Route 
değerini subscription-management olarak değiştirir. 

@No__t_0 Page Route model kuralı, bir uygulamadaki otomatik olarak oluşturulan sayfa yollarının klasör ve 
dosya adı kesimlerine bir parametre transformatörü uygular. Örneğin, 
/Pages/subscriptionmanagement/viewAll.exe konumundaki Razor Pages dosyasında yol 
/SubscriptionManagement/ViewAll /subscription-management/view-all olarak yeniden yazılabilir. 

PageRouteTransformerConvention , yalnızca Razor Pages klasöründen ve dosya adından gelen bir sayfa yolunun 
otomatik olarak oluşturulan segmentlerini dönüştürür. @No__t_0 yönergesiyle eklenen yol kesimlerini 
dönüştürmez. Kural, AddPageRoute eklenen yolları da dönüştürmez. 

@No__t_0, startup.configureServices bir seçenek olarak kaydedilir: 





























public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRazorPages() 

.AddRazorPagesOptions(options => 

{ 

options.Conventions.Add( 

new PageRouteTransformerConvention( 

new SlugifyParameterTransformer())); 

}); 


public class SlugifyParameterTransformer : IOutboundParameterTransformer 

{ 

public string TransformOutbound(object value) 

{ 

if (value == null) { return null; } 

// Slugify value 

return Regex.Replace(value.ToString(), "([a-z])([A-Z])", "$l-$2") .Tol_ower(); 

} 

} 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddMvc() 

. AddRazorPagesOptions(options => 

{ 

options.Conventions.Add( 

new PageRouteTransformerConvention( 

new SlugifyParameterTransformer())); 

}); 


public class SlugifyParameterTransformer : IOutboundParameterTransformer 

{ 

public string TransformOutbound(object value) 

{ 

if (value == null) { return null; } 

// Slugify value 

return Regex.Replace(value.ToString(), "([a-z])([A-Z])", "$l-$2") .Tol_ower(); 

} 

} 


Sayfa yolu yapılandırma 

Belirtilen sayfa yolundaki bir sayfaya bir yol yapılandırmak için AddPageRoute kullanın. Sayfa için 
oluşturulan bağlantılar belirtilen rotayı kullanır. AddPageRoute , yolu oluşturmak için 
AddPageRouteModelConvention kullanır. 

Örnek uygulama, Contact. csf?fm/için /TheContactPage bir yol oluşturur: 


options.Conventions.AddPageRoute("/Contact", 

"TheContactPage/{text?}"); 


options.Conventions.AddPageRoute("/Contact", 

"TheContactPage/{text?}"); 


İletişim sayfasına, varsayılan yolu aracılığıyla /Contact de erişilebilir. 


Örnek uygulamanın kişi sayfasına özel yolu, isteğe bağlı text yol segmentine ( {text?} ) izin verir. Bu sayfa, 












ziyaretçinin /Contact rotasında sayfaya erişmesi durumunda @page yönergesinde bu isteğe bağlı segmenti 
de içerir: 


@page "{text?}" 

@model ContactModel 

@{ 

ViewData["Title"] = "Contact"; 

} 

<hl>@ViewData["Title"]</hl> 

<h2>@Model.Message</h2> 

<address> 

One Microsoft Way<br> 

Redmond, WA 98052-6399<br> 

<abbr title="Phone">P:</abbr> 

425.555.0100 

</address> 

<address> 

<strong>Support:</strong> <a href="mailto:Support@example.com">Support@example.com</axbr> 
<strong>Marketing:</strong> <a href="mailto:Marketing@example.com">Marketing@example.com</a> 
</address> 

<p>@Model.RouteDataTextTemplateValue</p> 


@page "{text?}" 

@model ContactModel 

@{ 

ViewData["Title"] = "Contact"; 

} 

<hl>@ViewData["Title"]</hl> 

<h2>@Model.Message</h2> 

<address> 

One Microsoft Way<br> 

Redmond, WA 98052-6399<br> 

<abbr title="Phone">P:</abbr> 

425.555.0100 

</address> 

<address> 

<strong>Support:</strong> <a href="mailto:Support@example.com">Support@example.com</axbr> 
<strong>Marketing:</strong> <a href="mailto:Marketing@example.com">Marketing@example.com</a> 
</address> 

<p>@Model.RouteDataTextTemplateValue</p> 

işlenmiş sayfadaki kişi bağlantısı İÇİN oluşturulan URL 'nin güncelleştirilmiş yolu yansıttığını unutmayın: 


Contact 


* <1İ>.„</İİ> 

▼<lii _ 

I <a href =" /TheContactPage ">Contact< /a > 

■Trr --- 

::after 

<- /■ 11 s. 


@No__t_0, kendi sıradan yönlendirmekte olan kişi sayfasını ziyaret edin, veya özel yol /TheContactPage . Ek 











bir text yol kesimi sağlarsanız, sayfada sağladığınız HTML kodlu segment görüntülenir: 


O <£3 E3 Contact - ModelProvide X + ^ 


- □ X 

^~ ^ CS) {af localhost:5000/TheContactPage/TextValue 

☆ 

^ L & ••• 

ModelProvidersSample 


— 


Contact 

Your contact page. 

One Microsoft Way 
Redmond, WA 98052-6399 

P: 425.555.0100 

Support: Support@example.com 
Marketing: Marketing@example.com 


Route data for 'text' was provided: TextValue 
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Sayfa modeli eylem kuralları 

@No__t_0 uygulayan varsayılan sayfa modeli sağlayıcısı, sayfa modellerini yapılandırmak için 
genişletilebilirlik noktaları sağlamak üzere tasarlanan kuralları çağırır. Bu kurallar sayfa bulma ve işleme 
senaryolarını oluştururken ve değiştirirken yararlıdır. 

Bu bölümdeki örneklerde örnek uygulama, yanıt üst bilgisini uygulayan bir ResuItFilterAttribute 
AddHeaderAttribute Simfl kullanır: 

public class AddHeaderAttribute : ResultFilterAttribute 
{ 

private readonly string _name; 
private readonly string[] _values; 

public AddHeaderAttribute(string name, string[] values) 

{ 

_name = name; 

_values = values; 

> 

public override void OnResultExecuting(ResultExecutingContext context) 

{ 

context.HttpContext.Response.Headers.Add(_name, _values); 
base.OnResultExecuting(context); 

} 

} 














public class AddHeaderAttribute : ResultFilterAttribute 

{ 

private readonly string _name; 
private readonly string[] _values; 

public AddHeaderAttribute(string name, string[] values) 

{ 

_name = name; 

_values = values; 

> 

public override void OnResultExecuting(ResultExecutingContext context) 

{ 

context.HttpContext.Response.Headers.Add(_name, _values); 
base.OnResultExecuting(context); 

} 


Kurallar kullanılarak, örnek bir klasördeki tüm sayfalara ve tek bir sayfaya özniteliğin nasıl uygulanacağını 
gösterir. 

Klasör uygulama modeli kuralı 

Belirtilen klasör altındaki tüm sayfalar için PageApplicationModel örneklerine bir eylem çağıran bir 
IPageApplicationModelConvention oluşturmak ve eklemek için AddFolderApplicationModelConvention 
kullanın. 

Örnek, uygulamanın diğer sayfalar klasörünün içindeki sayfalara bir başlık, otherPagesHeader ekleyerek 
AddFolderApplicationModelConvention kullanımım gösterir: 

options.Conventions.AddFolderApplicationModelConvention("/OtherPages", model => 

{ 

model.Filters.Add(new AddHeaderAttribute( 

"OtherPagesHeader ", new string[] { "OtherPages Header Value" })); 

}); 


options.Conventions.AddFolderApplicationModelConvention("/OtherPages", model => 

{ 

model.Filters.Add(new AddHeaderAttribute( 

"OtherPagesHeader", new string[] { "OtherPages Header Value" })); 

}); 

Örnekteki Sayfal sayfasını iocaihost:5000/otherPages/Pagei isteyin ve sonucu görüntülemek için üst bilgileri 
inceleyin: 

▼ Response Headers view source 

Content-Type: text/html; charset=utf-8 
Date: Sat, 21 Oct 2017 06:13:16 GMT 
FilterFactoryHeader: Filter Factory Header Value 1 
FilterFactoryHeader: Filter Factory Header Value 2 
GlobalHeaderç_Globa^_Header_^falu^^^_^^^^ 

| OtherPagesHeader: OtherPages Header Value | 

Server: Kestrel 
Transfer-Encoding: chunked 


Sayfa uygulama modeli kuralı 

Belirtilen ada sahip sayfanın PageApplicationModel bir eylemi çağıran bir IPageApplicationModelConvention 
oluşturmak ve eklemek için AddPageApplicationModelConvention kullanın. 







Örnek, hakkında sayfasına AboutHeader bir başlık ekleyerek AddPageAppiicationModeiconvention kullanımını 
gösterir: 

options.Conventions.AddPageApplicationModelConvention("/About", model => 

{ 

model.Filters.Add(new AddHeaderAttribute( 

"AboutHeader", new string[] { "About Header Value" })); 

}); 


options.Conventions.AddPageApplicationModelConvention("/About", model => 

{ 

model.Filters.Add(new AddHeaderAttribute( 

"AboutHeader", new string[] { "About Header Value" })); 

}); 


@No__t_0 sırasında örneğin hakkında daha fazla bilgi isteyin ve sonucu görüntülemek için üst bilgileri 
inceleyin: 

▼ Response Headers view source 
AboutHeader: About Header Value 
Content-Type: text/html; charset=utf-8 
Date: Thu, 19 Oct 2017 21:09:07 GMT 
FilterFactoryHeader: Filter Factory Header Value 1 
FilterFactoryHeader: Filter Factory Header Value 2 
GlobalHeader: Global Header Value 
Server: Kestrel 
Transfer-Encoding: chunked 

Filtre yapılandırma 

ConfigureFilter, belirtilen filtreyi uygulamak üzere yapılandırır. Bir filtre sınıfı uygulayabilirsiniz, ancak örnek 
uygulama bir lambda ifadesinde bir filtrenin nasıl uygulanacağını gösterir, bu da bir filtre döndüren bir 
fabrika olarak arka planda uygulandı: 

options.Conventions.ConfigureFilter(model => 

{ 

if (model.RelativePath.Contains("0therPages/Page2")) 

{ 

return new AddHeaderAttribute( 

"0therPagesPage2Header", 

new string[] { "0therPages/Page2 Header Value" }); 

} 

return new EmptyFilter(); 

}); 


options.Conventions.ConfigureFilter(model => 

{ 

if (model.RelativePath.Contains("0therPages/Page2")) 

{ 

return new AddHeaderAttribute( 

"0therPagesPage2Header", 

new string[] { "0therPages/Page2 Header Value" }); 

} 

return new EmptyFilter(); 

}); 


Sayfa uygulama modeli, diğer sayfalar klasöründeki Page2 sayfasına yol açan parçaların göreli yolunu 







denetlemek için kullanılır. Koşul geçerse, bir üst bilgi eklenir. Aksi takdirde, EmptyFilter uygulanır. 

EmptyFilter bir eylem filtresidir. Eylem filtreleri Razor Pages tarafından yoksayıldığından, yolun 
0therPages/Page2 içermiyorsa EmptyFilter hiçbir etkisi yoktur. 

@No__t_0 'de örneğin Page2 sayfasını isteyin ve sonucu görüntülemek için üst bilgileri inceleyin: 

▼ Response Headers view source 

Content-Type: text/html; charset=utf-8 
Date: Mon, 23 Oct 2017 06:06:52 GMT 
FilterFactoryHeader: Filter Factory Header Value 1 
FilterFactoryHeader: Filter Factory Header Value 2 
GlobalHeader: Global Header Value 
OtherPagesHeader: OtherPages Header Value 

)therPagesPage2Header: 0therPages/Page2 Header Value | 

Server: Kestrel 
Transfer-Encoding: chunked 


Filtre fabrikası yapılandırma 

ConfigureFilter, belirtilen fabrikayı tüm Razor Pages filtre uygulayacak şekilde yapılandırır. 

Örnek uygulama, uygulamanın sayfalarına iki değer içeren FilterFactoryHeader bir üst bilgi ekleyerek bir 
filtre fabrikası kullanılmasına bir örnek sağlar: 

options. Conventions. ConfigureFilter(new AddHeaderl/JithFactory()); 

options. Conventions. ConfigureFilter(new AddHeaderl/JithFactory()); 


AddHeaderWithFactory.es'. 








public class AddHeaderl/JithFactory : IFilterFactory 

{ 

// Implement IFilterFactory 

public IFilterMetadata CreateInstance(IServiceProvider serviceProvider) 

{ 

return new AddHeaderFilter(); 

} 

private class AddFleaderFilter : IResultFilter 

{ 

public void OnResultExecuting(ResultExecutingContext context) 

{ 

context.HttpContext.Response.Headers.Add( 

"FilterFactoryHeader ", 
new string[] 

{ 

"Filter Factory Header Value 1", 

"Filter Factory Header Value 2" 

}); 

} 

public void OnResultExecuted(ResultExecutedContext context) 

{ 

} 

} 

public bool IsReusable 

{ 

get 

{ 

return false; 

} 

} 



public class AddHeaderl/JithFactory : IFilterFactory 
{ 

// Implement IFilterFactory 

public IFilterMetadata CreateInstance(IServiceProvider serviceProvider) 
{ 

return new AddHeaderFilter(); 

} 

private class AddFleaderFilter : IResultFilter 
{ 

public void OnResultExecuting(ResultExecutingContext context) 

{ 

context.HttpContext.Response.Headers.Add( 

"FilterFactoryHeader ", 
new string[] 

{ 

"Filter Factory Header Value 1", 

"Filter Factory Header Value 2" 

}); 

} 

public void OnResultExecuted(ResultExecutedContext context) 

{ 

} 

} 

public bool IsReusable 
{ 

get 

{ 

return false; 

} 

} 


@No__t_0 sırasında örneğin hakkında daha fazla bilgi isteyin ve sonucu görüntülemek için üst bilgileri 
inceleyin: 

▼ Response Headers view source 
AboutHeader: About Header Value 
Content-Type: text/html; charset=utf-8 

Pate: Thu. 19 Oct 2017 21:89:97 GHT _ 

FilterFactoryHeader: Filter Factory Header Value 1 
FilterFactoryHeader: Filter Factory Header Value 2 
GlobalHeader: Global Header Value 
Server: Kestrel 
Transfer-Encoding: chunked 


MVC filtreleri ve sayfa filtresi (ıpagefilter) 

Razor Pages işleyici yöntemleri kullandığından, MVC eylem filtreleri Razor Pages tarafından yok sayılır. Diğer 
MVC filtresi türleri şunlardır: Yetkilendirme, özel durum, kaynakve sonuç. Daha fazla bilgi için Filtreler 
konusuna bakın. 

Sayfa filtresi (I PageF i İter) Razor Pages için geçerli bir filtredir. Daha fazla bilgi için bkz. Razor Pages İçin filtre 
yöntemleri. 

Ek kaynaklar 

• ASP.NET Core Razor Pages yetkilendirme kuralları 

• ASP.NET Core bölgeler 





ASRNET Core Razor SDK 'Sı 
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Rick Anderson tarafından 

Genel bakış 

.NET core 2.1 SDK veya üzeri, Microsoft. net. sdk.Razor MSBuild SDK 'sini (Razor SDK) içerir.Razor SDK 'Sı: 

• ASP.NET Core MVC tabanlı veya Blazor projeleri için Razor dosyaları içeren projeleri derlemek, paketlemek 
ve yayımlamak için gereklidir. 

• , Razor (. cshtml veya . Razor) dosyalarının derlemesini özelleştirmeye izin veren bir dizi önceden tanımlanmış 
hedef, özellik ve öğe içerir. 

Razor SDK, **\*.cshtml ve **\*.razor glob desenlerine ayarlanmış inciude öznitelikleri olan content 
öğelerini içerir. Eşleşen dosyalar yayımlandı. 

• ASP.NET Core MVC tabanlı projeler için Razor dosyaları içeren projeleri oluşturma, paketleme ve yayımlama 
ile ilgili deneyimi standartlaştırır. 

• Razor dosyalarının derlemesini özelleştirmeye izin veren bir dizi önceden tanımlanmış hedef, özellik ve öğe 
içerir. 

Razor SDK, **\*.cshtml glob düzenine ayarlanmış bir inciude özniteliğine sahip content öğesi içerir. Eşleşen 
dosyalar yayımlandı. 

Prerequisites 

.NET core 2.1 SDK veya üzeri 

Razor SDK 'sini kullanma 

Çoğu Web uygulaması Razor SDK 'ya açıkça başvurmak için gerekli değildir. 

Razor görünümlerini veya Razor Pages içeren sınıf kitaplıkları oluşturmak için Razor SDK 'yı kullanmak için 
Razor sınıf kitaplığı (RCL) proje şablonuyla başlamasını öneririz. Blazor (. Razor) dosyalarını derlemek için 
kullanılan bir RCL, Microsoft. Aspnetcore. Components paketine en az bir başvuru gerektirir. Razor 
görünümlerini veya sayfalarını (. cshtml dosyaları) derlemek için kullanılan bir rcl, netcoreapp3.@ veya üzeri 
hedeflemeyi gerektirir ve proje dosyasındaki Microsoft. Aspnetcore. app metapackage öğesine 
FrameworkReference ' ye sahip olmalıdır. 

Razor görünümlerini veya Razor Pages içeren sınıf kitaplıkları derlemek için Razor SDK 'yı kullanmak için: 

• Microsoft.NET.Sdk yerine Microsoft.NET.Sdk.Razor kullanın: 

<Project SDK="Microsoft.NET.Sdk.Razor"> 

<!-- omitted for brevity --> 

</Project> 

• Genellikle, Razor Pages ve Razor görünümlerini derlemek ve derlemek için gerekli ek bağımlılıklar almak 
için Microsoft.AspNetcore.Mvc ' a yönelik bir paket başvurusu gerekir. En azından, projenizin paket 
başvurularını şu şekilde eklemesi gerekir: 



















o Microsoft.AspNetCore.Razor.Design 
o Microsoft.AspNetCore.Mvc.Razor.Extensions 
o Microsoft.AspNetCore.Mvc.Razor 

Microsoft.AspNetCore.Razor.Design paketi, proje için Razor derleme görevlerini ve hedeflerini sağlar. 

Önceki paketler Microsoft.AspNetCore.Mvc 1 a dahildir. Aşağıdaki biçimlendirme, bir ASP.NET Core Razor 
Pages uygulaması için Razor dosyaları derlemek için Razor SDK 'sini kullanan bir proje dosyası gösterir: 

<Project Sdk="Microsoft.NET.Sdk.Razor"> 

<PropertyGroup> 

<TargetFramework>netcoreapp2.l</TargetFramework> 

</PropertyGroup> 

<ItemGroup> 

<PackageReference Include="Microsoft.AspNetCore.Mvc" Version="2.1.3" /> 

</ItemGroup> 

</Project> 


VVARNING 

Microsoft. AspNetCore. Razor. Design ve Microsoft .AspNetCore. Mvc . Razor. Extensions paketleri Microsoft. 
AspNetCore. app metapackageiçinde yer alır. Ancak, sürüm-daha az Microsoft.AspNetCore.App paket başvurusu, en son 
Microsoft.AspNetCore.Razor.Design sürümünü içermeyen uygulamaya bir metapackage sağlar., Razor için en son 
derleme zamanı düzeltmelerinin dahil olması için projeler Microsoft. AspNetCore. Razor. Design ' ın (veya 
Microsoft. AspNetCore.Mvc ) tutarlı bir sürümüne başvurmalıdır. Daha fazla bilgi için Bu GitHub sorununabakın. 


Özellikler 

Aşağıdaki özellikler, bir proje derlemesinin parçası olarak Razor SDK davranışını denetler: 


RazorCompileOnBuild 

- 

true 

olduğunda, proje oluşturmanın bir parçası olarak Razor derlemesini derler ve 

yayar. Varsayılan değ 

er 

true 

' dır. 


• RazorCompileOnPubiish - true olduğunda, projenin yayımlaması kapsamında Razor derlemesini derler ve 
yayar. Varsayılan değer true 'dır. 

Aşağıdaki tablodaki Özellikler ve öğeler, Razor SDK 'ya giriş ve çıkış yapılandırmak için kullanılır. 

VVARNING 

ASP.NET Core 3,0 ' den başlayarak, MVC görünümleri veya Razor Pages, proje dosyasındaki RazorCompileOnBuild veya 
RazorCompileOnPubiish MSBuild özellikleri devre dışı bırakılmışsa varsayılan olarak sunulmuyor. Uygulama,. cshtml 
dosyalarını işlemek üzere çalışma zamanı derlemesini kullanıyorsa, uygulamalar Microsoft. Aspnetcore. Mvc. Razor. 
runtimecompilation paketine açık bir başvuru eklememelidir. 


ÖĞELER 

AÇIKLAMA 

RazorGenerate 

Kod oluşturmaya giriş olan öğe öğeleri (. cshtml dosyaları). 

RazorComponent 

Razor bileşen kodu oluşturmaya giriş olan öğe öğeleri (. 


Razor dosyaları). 













ÖĞELER 


AÇIKLAMA 


RazorCompile 

Razor derleme hedeflerine giriş olan öğe öğeleri ( . cs 
dosyaları). Razor derlemesine derlenecek ek dosyaları 
belirtmek için bu ıtemGroup kullanın. 

RazorTargetAssemblyAttribute 

Razor derlemesi için kod oluşturma öznitelikleri için kullanılan 
öğe öğeleri. Örneğin: 

RazorAssemblyAttribute 

inciude="System.Reflection.AssemblyMetadataAttribute" 

_Parameterl="BuildSource" 

_Parameter2="https://docs.microsoft.com/"> 

RazorEmbeddedResource 

Oluşturulan Razor derlemesine gömülü kaynaklar olarak 
eklenen öğe öğeleri. 

ÖZELLİK 

AÇIKLAMA 

RazorTargetName 

Razor tarafından üretilen derlemenin dosya adı (uzantısı 
olmadan). 

RazonOutputPath 

Razor çıkış dizini. 

RazonCompileToolset 

Razor derlemesini derlemek için kullanılan araç takımını tespit 
etmek için kullanılır. Geçerli değerler implicit , RazorSDK 
ve PrecompilationTool 1 dir. 

Enabledefaultcontentıtems 

Varsayılan değer true . true , Web. config,. JSONve . 
cshtml dosyalarını projeye içerik olarak ekler. 

Microsoft. net. sdk.uieb aracılığıyla başvuruluyorsa, 

Wwwroot ve yapılandırma dosyalan altındaki dosyalar da 
dahil edilir. 

EnableDefaultRazorGenenateltems 

true , RazorGenerate Öğelerinde Content Öğelerden . 
cshtml dosyalarını ekler. 

GenerateRazorTargetAssemblylnfo 

true , RazorAssemblyAttribute tarafından belirtilen 
öznitelikleri içeren bir. cs dosyası oluşturur ve derleme 
çıkışında dosyayı içerir. 

EnableDefauİtRazorTargetAssemblylnfoAttributes 

true , RazorAssemblyAttribute derleme özniteliklerinin 
varsayılan bir kümesini ekler. 

CopyRazorGenerateFilesToPublishDirectory 

true, RazorGenerate öğeleri (. cshtml) dosyalarını 

Yayımla dizinine kopyalar. Genellikle, derleme zamanında veya 
yayımlama zamanında derlemeye katılırsanız yayımlanmış bir 
uygulama için Razor dosyaları gerekli değildir. Varsayılan 
değer false ' dır. 



















ÖZELLİK 


AÇIKLAMA 


copyRefAssembliesToPublishDir'ectory true , başvuru derleme öğelerini yayımlama dizinine 

kopyalayın. Genellikle, derleme zamanında veya yayımlama 
zamanında Razor derlemesi gerçekleşirse, yayımlanan bir 
uygulama için başvuru derlemeleri gerekli değildir. 
Yayımlanmış uygulamanız çalışma zamanı derlemesi 
gerektiriyorsa, true olarak ayarlayın. Örneğin, uygulama 
çalışma zamanında . cshtml dosyalarını değiştirirse veya 
gömülü görünümleri kullanıyorsa değeri true olarak 
ayarlayın. Varsayılan değer false 1 dır. 


includeRazorContentinPack true , tüm Razor içerik öğeleri (. cshtml dosyaları) 

oluşturulan NuGet paketine eklenmek üzere işaretlenir. 
Varsayılan değer false 1 dır. 


EmbedRazorGenerateSources 

olarak RazorGenerate (. cshtml) öğelerini ekler. Varsayılan 
değer false ’ dır. 


true , oluşturulan Razor derlemesine gömülü dosyalar 


useRazorBuildserver true , kod oluşturma işinin yükünü boşaltmak için kalıcı bir 

yapı sunucusu işlemi kullanır. Varsayılan değer 
UseSharedCompilation 1 dır. 


GenerateMvcApplicationPartsAssemblyAttributes true , SDK, uygulama bölümü keşfi gerçekleştirmek için 

çalışma zamanında MVC tarafından kullanılan ek öznitelikler 
üretir. 

Özellikler hakkında daha fazla bilgi için bkz. MSBuild özellikleri. 

Hedefler 

Razor SDK iki birincil hedefi tanımlar: 

• RazorGenerate - kod RazorGenerate öğe öğelerinden . cs dosyaları oluşturur. Bu hedeften önce veya sonra 
çalışabilecek ek hedefleri belirtmek için RazorGenerateDependsOn özelliğini kullanın. 

• RazorCompile - bir Razor derlemesinde oluşturulan . cs dosyalarını derler. Bu hedeften önce veya sonra 
çalışabilecek ek hedefleri belirtmek için RazorCompileDependsOn kullanın. 

• RazorComponentGenerate - kod RazorComponent öğe öğeleri için . cs dosyaları oluşturur. Bu hedeften önce veya 
sonra çalışabilecek ek hedefleri belirtmek için RazorComponentGenerateDependsOn özelliğini kullanın. 

Razor görünümlerinin çalışma zamanı derlemesi 

• Varsayılan olarak, Razor SDK, çalışma zamanı derlemesini gerçekleştirmek için gerekli olan başvuru 
derlemelerini yayımlamaz. Bu durum, uygulama modeli bir çalışma zamanı derlemesini kullandığında 
derleme hatalarıyla sonuçlanır. Örneğin, uygulama yayımlandıktan sonra katıştırılmış görünümleri veya 
değişiklik görünümlerini kullanır. Başvuru derlemelerini yayımlamaya devam etmek için 

CopyRefAssembliesToPublishDirectory 1 i true olarak ayarlayın. 

• Bir Web uygulaması için uygulamanızın Microsoft. net. sdk.web SDK’Yı hedeflediğinden emin olun. 


Razor dili sürümü 

Microsoft. net. sdk.web SDK 'Sı hedeflenirken, Razor dili sürümü uygulamanın hedef Framevvork sürümünden 
algılanır. Microsoft. net. sdk.Razor SDK 'Yı hedefleyen projeler veya uygulamanın çıkarılan değerden farklı bir 
Razor dili sürümü gerektirmesi durumunda, uygulamanın proje dosyasındaki <RazorLangversion> özelliği 
ayarlanarak bir sürüm yapılandırılabilir: 


































<PropertyGroup> 

<RazorLangVersion>{VERSION}</RazorLangVersion> 

</PropertyGroup> 


Razor ‘nin dil sürümü, için oluşturulduğu çalışma zamanının sürümü ile sıkı bir şekilde tümleşiktir.Çalışma 
zamanı için tasarlanmamış bir dil sürümünü hedeflemek desteklenmez ve muhtemelen derleme hataları üretir. 

Ek kaynaklar 

• .NET Core için csproj biçimine eklemeler 

• Ortak MSBuild proje öğeleri 
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ASP.N ET Core MVC, Model-View-Controller tasarım modelini kullanarak Web uygulamaları ve API 'Ler 
oluşturmaya yönelik zengin bir çerçevedir. 


MVC deseninin anlamı nedir? 

Model-View-Controller (MVC) mimari modeli, bir uygulamayı üç ana bileşen grubuna ayırır: modeller, 
görünümler ve denetleyiciler. Bu model, kaygıları ayrımıelde etmeye yardımcı olur. Bu modeli kullanarak 
Kullanıcı istekleri, kullanıcı eylemlerini gerçekleştirmek ve/veya sorguların sonuçlarını almak için modeliyle 
çalışmaktan sorumlu bir denetleyiciye yönlendirilir. Denetleyici, kullanıcıya görüntülenecek görünümü seçer ve 
gereken model verilerini sağlar. 


Aşağıdaki diyagramda üç ana bileşen gösterilmektedir ve bunlar diğerlerine başvuramazlar: 


r 


1 


Vlodel 


k 


J 


* * 




Bu sorumlulukların bu şekilde çıkarılması, tek bir işi olan bir şeyi (model, görünüm veya denetleyici) 
kodlanmasını, hata ayıklamayı ve test etmek daha kolay olduğundan, uygulamayı karmaşıklık bakımından 
ölçeklendirmenize yardımcı olur. Bu üç alandan oluşan iki veya daha fazla bağımlılığı kapsayan bağımlılıklara 
sahip kodu güncelleştirmek, test etmek ve hata ayıklamak daha zordur. Örneğin, Kullanıcı arabirimi mantığı iş 
mantığından daha sık değişmeyi eğilimi gösterir. Sunum kodu ve iş mantığı tek bir nesnede birleştirilirse, 
Kullanıcı arabirimi her değiştirildiğinde iş mantığı içeren bir nesne değiştirilmelidir. Bu genellikle hataları tanıtır 
ve her bir en az kullanıcı arabirimi değişikliğinden sonra iş mantığının yeniden test edilmesini gerektirir. 


NOTE 

Hem görünüm hem de denetleyici modele bağlıdır. Ancak, model ne görünüm ne de yoksa denetleyiciye bağlıdır. Bu, 
ayrımı önemli avantajlarından biridir. Bu ayrım, modelin görsel sunudan bağımsız olarak oluşturulup test etmesine olanak 
tanır. 


Model sorumlulukları 

MVC uygulamasındaki model, uygulamanın durumunu ve bunun gerçekleştirilmesi gereken tüm iş mantığını 
veya işlemlerini temsil eder, iş mantığı, uygulamanın durumunu kalıcı hale getirme için herhangi bir uygulama 
mantığıyla birlikte, modelde kapsüllenmelidir. Türü kesin belirlenmiş görünümler genellikle bu görünümde 










görüntülenecek verileri içerecek şekilde tasarlanan ViewModel türlerini kullanır. Denetleyici bu VievvModel 
örneklerini modelden oluşturur ve doldurur. 

Sorumlulukları görüntüle 

Görünümler, kullanıcı arabiriminden içerik sunmadan sorumludur..NET kodunu HTML biçimlendirmesine 
eklemek için Razor görüntüleme altyapısını kullanırlar. Görünümler içinde en az mantık olmalıdır ve içerdikleri 
tüm mantığın içerik sunumu ile ilişkilendirilmesi gerekir. Karmaşık bir modelden veri görüntülemek için 
dosyaları görüntüle bölümünde harika bir mantık kullanımı gereksinimini fark ederseniz, görünümü 
basitleştirmek için bir Görünüm bileşeni, ViewModel veya görünüm şablonu kullanmayı düşünün. 

Denetleyici sorumlulukları 

Denetleyiciler, kullanıcı etkileşimini işleyen, modeliyle çalışan ve sonunda işlenecek bir görünüm olan 
bileşenleridir. MVC uygulamasında, görünüm yalnızca bilgileri görüntüler; denetleyici, Kullanıcı girişini ve 
etkileşimini işler ve yanıtlar. MVC modelinde, denetleyici ilk giriş noktasıdır ve hangi model türlerinin birlikte 
çalışacağını ve hangi görünümün işleneceğini seçmekten sorumludur (Bu nedenle adı, uygulamanın belirli bir 
istek için nasıl yanıt verdiğini denetler). 



ASP.NET Core MVC nedir? 

AS P.N ET Core MVC çerçevesi, AS P.N ET Core birlikte kullanılmak üzere en iyi duruma getirilmiş hafif, açık 
kaynaklı ve yüksek düzeyde bir sunum çerçevesidir. 

ASP.NET Core MVC, sorunların temiz bir şekilde ayrılmasını sağlayan dinamik Web siteleri oluşturmak için 
desen tabanlı bir yol sağlar. Biçimlendirme üzerinde tam denetim elde etmenizi sağlar, TDD kullanımı kolay 
geliştirmeyi destekler ve en son web standartlarını kullanır. 

Özellikler 

ASP.NET Core MVC şunları içerir: 

• Yönlendirme 

• Model bağlama 

• Model doğrulaması 

• Bağımlılık ekleme 

• Filtreler 

• Alanlar 

• VVebAPI'Leri 

• Test edilebilirlik 

• Razor Görünüm altyapısı 

• Türü kesin belirlenmiş görünümler 

• Etiket Yardımcıları 

• Bileşenleri görüntüle 













Yönlendirme 

ASP.N ET Core MVC, gelişmiş ve aranabilir URL 'Ler içeren uygulamalar oluşturmanıza olanak tanıyan güçlü 
bir URL eşleme bileşeni olan ASP.NET Core yönlendirmeninüzerine kurulmuştur. Bu, uygulamanızın URL 
adlandırma düzenlerini, Web sunucunuzdaki dosyaların nasıl düzenleneceğine bakılmaksızın, arama motoru 
iyileştirmesi (S EO) ve bağlantı oluşturma için iyi bir şekilde tanımlamanıza olanak sağlar. Yol değer 
kısıtlamalarını, Varsayılanları ve isteğe bağlı değerleri destekleyen uygun bir yol şablonu sözdizimi kullanarak 
rotalarınızı tanımlayabilirsiniz. 

Kural tabanlı yönlendirme , uygulamanızın kabul ettiği URL biçimlerini ve bu biçimlerin her birinin verilen 
denetleyicide belirli bir eylem yöntemiyle nasıl eşlendiğini genel olarak tanımlamanızı sağlar. Gelen bir istek 
alındığında, yönlendirme altyapısı URL 'Yİ ayrıştırır ve tanımlanan URL biçimlerinden biriyle eşleştirir ve 
ardından ilişkili denetleyicinin eylem yöntemini çağırır. 

routes.MapRoute(name: "Default", template: "{controller=Home}/{action=Index}/{id?}"); 

Öznitelikyönlendirme , denetleyicilerinizi ve eylemlerinizi uygulamanızın yollarını tanımlayan özniteliklerle 
süsleyerek yönlendirme bilgilerini belirtmenizi sağlar. Bu, yol tanımlarınızın ilişkili oldukları denetleyicinin ve 
eylemin yanına yerleştirildiği anlamına gelir. 

[Route("api/[controller]")] 

public class ProductsController : Controller 

{ 

[HttpGet("{id}")] 

public IActionResult GetProduct(int id) 

{ 

} 

} 

Model bağlama 

AS P.N ET Core MVC model bağlama , istemci isteği verilerini (form değerleri, rota verileri, sorgu dizesi 
PARAMETRELERİ, http üstbilgileri) denetleyicinin işleyebileceği nesnelere dönüştürür. Sonuç olarak, 
denetleyici mantığınızın gelen istek verilerini oluşturma işini yapması gerekmez; Yalnızca Eylem yöntemlerine 
parametre olarak verileri içerir. 

public async Task<IActionResult> Login(LoginViewModel model, string returnUrl = null) { ... } 

Model doğrulaması 

AS P.N ET Core MVC, model nesneniz veri ek açıklaması doğrulama öznitelikleriyle süsleyerek doğrulamayı 
destekler. Doğrulama öznitelikleri, değerler sunucuya gönderilmeden önce istemci tarafında ve denetleyici 
eylemi çağrılmadan önce sunucuda denetlenir. 







using System.ComponentModel.DataAnnotations; 
public class LoginViewModel 
{ 

[Required] 

[EmailAddress] 

public string Email { get; set; } 
[Required] 

[DataType(DataType.Password)] 
public string Password { get; set; } 

[Display(Name = "Remember me?")] 
public bool RememberMe { get; set; } 


Bir denetleyici eylemi: 

public async Task<IActionResult> Login(LoginViewModel model, string returnUrl = null) 

{ 

if (ModelState.IsValid) 

{ 

// work with the model 

} 

// At this point, something failed, redisplay form 
return View(model); 

} 

Çerçeve, istek verilerini hem istemcide hem de sunucuda doğrulamayı işler. Model türlerinde belirtilen 
doğrulama mantığı, işlenen görünümlere obtrusive ek açıklamaları olarak eklenir ve jQuery doğrulamasıile 
tarayıcıda zorlanır. 

Bağımlılık ekleme 

ASP.NET Core, bağımlılık ekleme (dı)için yerleşik desteğe sahiptir. ASP.NET Core MVC 'de, denetleyiciler 
oluşturucuları aracılığıyla gerekli hizmetleri talep edebilir ve bu kullanıcıların Açık bağımlılıklar 
ilkesiniizleyebilmesine olanak tanır. 

Uygulamanız Ayrıca, @inject yönergesini kullanarak, görüntüleme dosyalarına bağımlılık eklemeişlemini de 
kullanabilir: 


@inject SomeSenvice ServiceName 

<!DOCTYPE html> 
chtml lang="en"> 

<head> 

<title>@ServiceName.GetTitle</title> 
</head> 

<body> 

<hl>@ServiceName.GetTitle</hl> 

</body> 

</html> 


FilT Releri 

Filtreler , geliştiricilerin özel durum işleme veya yetkilendirme gibi çapraz sorunları yalıtmalarına yardımcı olur. 
Filtreler, eylem yöntemleri için özel ön ve son işlem dışı mantığı çalıştırmayı etkinleştirir ve belirli bir istek için 
yürütme işlem hattının içindeki belirli noktalarda çalışacak şekilde yapılandırılabilir. Filtreler, denetleyicilere 
veya eylemlere öznitelik olarak uygulanabilir (veya küresel olarak çalıştırılabilir). Çeşitli filtreler (örneğin 
Authorize ) çerçeveye dahil edilir. [Authorize] , MVC yetkilendirme filtrelerini oluşturmak için kullanılan 
özniteliktir. 








[Authonize] 

public class AccountController : Controller 

Alanlar 

Bölgeler , büyük BİR ASP.NET Core MVC web uygulamasını daha küçük işlevsel gruplandırmalar halinde 
bölümlemek için bir yol sağlar. Bir alan, bir uygulamanın içindeki bir MVC yapısıdır.MVC projesinde model, 
denetleyici ve görünüm gibi mantıksal bileşenler farklı klasörlerde tutulur ve MVC bu bileşenler arasındaki 
ilişkiyi oluşturmak için adlandırma kurallarını kullanır. Büyük bir uygulama için, uygulamayı işlevlerin ayrı üst 
düzey alanlarında bölümlemek avantajlı olabilir. Örneğin, kullanıma alma, faturalandırma ve arama gibi birden 
çok iş birimi içeren bir e-ticaret uygulaması. Bu birimlerin her birinin kendi mantıksal bileşen görünümleri, 
denetleyicileri ve modelleri vardır. 

Web API'leri 

Web siteleri oluşturmak için harika bir platform olmanın yanı sıra, ASP.NET Core MVC, Web API 'Leri 
oluşturmaya yönelik harika destek içerir. Tarayıcılar ve mobil cihazlar dahil olmak üzere çok çeşitli istemcilere 
ulaşan hizmetler oluşturabilirsiniz. 

Framevvork, verileri JSON veya XML olarak biçimlendirmeye yönelik yerleşik destek ile http içerik anlaşması 
için destek içerir. Kendi biçimlerinizin desteğini eklemek için özel biçimleri yazın. 

Hiper medya desteğini etkinleştirmek için bağlantı oluşturma kullanın. Web API 'lerinizin birden çok Web 
uygulaması arasında paylaşılabilmesi için, çıkış noktaları arası kaynak paylaşımı (CORS) desteğini kolayca 
etkinleştirin. 

Test edilebilirlik 

Çerçevenin arabirimlerin ve bağımlılık ekleme özelliğinin kullanımı, birim testine uygun hale getirir ve 
Framevvork, tümleştirme testlerini hızlı ve kolay hale getirmek için özellikler (Entity Framevvork İçin bir testhost 
ve InMemory sağlayıcısı gibi) içerir. Denetleyici mantığını test etmehakkında daha fazla bilgi edinin. 

Razor Görünüm altyapısı 

MVC görünümleri ASP.NET Core , görünümleri İşlemek için Razor görüntüleme altyapısını kullanır. Razor, 
gömülü C# kod kullanarak görünümler tanımlamaya yönelik kompakt, açıklayıcı ve akışkan şablonu 
biçimlendirme dilidir. Razor, sunucu üzerinde dinamik olarak Web içeriği oluşturmak için kullanılır.Sunucu 
kodunu istemci tarafı içeriğiyle ve kodla düzgün bir şekilde karıştırabilirsiniz. 

<ul> 

@for (int i = 0; i < 5; i++) { 

<li>List item @i</li> 

} 

</ul> 

Razor görünüm altyapısını kullanarak düzenler, kısmi görünümler ve değiştirilebilir bölümler 
tanımlayabilirsiniz. 

Türü kesin belirlenmiş görünümler 

MVC 'de Razor görünümleri modelinize göre kesin bir şekilde yazılabilir. Denetleyiciler, görünümlerinizin tür 
denetlemesi ve IntelliSense desteği olmasını sağlayan görünümlere kesin olarak belirlenmiş bir model 
geçirebilir. 

Örneğin, aşağıdaki görünüm iEnumerabie<Product> türünde bir model işler: 


















@model IEnumerable<Product> 

<ul> 

@foreach (Product p in Model) 
{ 

<li>@p.Name</li> 

} 

</ul> 


Etiket Yardımcıları 

Etiket Yardımcıları , Razor dosyalarında HTML öğeleri oluşturma ve oluşturma ile sunucu tarafı kodunun 
katılmasını sağlar. Etiket Yardımcıları kullanarak özel Etiketler tanımlayabilir (örneğin, <environment> ) veya 
varolan etiketlerin davranışını değiştirebilirsiniz (örneğin, <iabei> ). Etiket Yardımcıları, öğe adı ve öznitelikleri 
temelinde belirli öğelere bağlanır. Bunlar, hala HTML düzenlemesi deneyimini korurken sunucu tarafı 
işlemenin avantajlarını sağlar. 

Yaygın görevler için, genel GitHub depolarında ve NuGet paketleri olarak formlar, bağlantılar, yükleme varlıkları 
ve daha fazlasını ve daha fazlasını oluşturma gibi birçok yerleşik etiket yardımcıları vardır. Etiket Yardımcıları 1 
de C#yazılır ve öğe adı, öznitelik adı veya üst etikete göre HTML öğelerini hedefleyin. Örneğin, yerleşik 
Linakghelper, AccountsControiler'' Login eylemine bir bağlantı oluşturmak için kullanılabilir: 

<p> 

Thank you for confirming yoıır email. 

Please <a asp-controller="Account" asp-action="Login">Click here to Log in</a>. 

</p> 

EnvironmentTagHelper , geliştirme, hazırlama veya üretim gibi çalışma zamanı ortamına göre görünümlerinizde 
farklı betikler (örneğin, ham veya küçültülmüş) dahil etmek için kullanılabilir: 

<environment names="Development"> 

<script src="~/lib/jquery/dist/jquery. js"x/script> 

</environment> 

<environment names="Stagingj Production"> 

<script src=" https://ajax.aspnetcdn.eom/ajax/jquery/jquery-2.l.4.mln.j s" 
asp-fallback-src="~/lib/jquery/dist/jquery.min.js" 
asp-fallback-test="window.jQuery"> 

</script> 

</environment> 


Etiket Yardımcıları, HTML ve Razor biçimlendirmesi oluşturmaya yönelik zengin bir IntelliSense ortamı ve 
HTML kullanımı kolay bir geliştirme deneyimi sağlar. Yerleşik etiket yardımcıların çoğu, var olan HTML 
öğelerini hedefleyin ve öğesi için sunucu tarafı öznitelikleri sağlar. 

Bileşenleri görüntüle 

Görünüm bileşenleri , işleme mantığını paketlemenize ve uygulamanın tamamında yeniden kullanmanıza 
olanak tanır. Bunlar, kısmen görünümlerebenzer ancak ilişkili mantığa benzer. 

Uyumluluk sürümü 

SetCompatibilityVersion yöntemi, bir uygulamanın, ASP.NET Core MVC 2,1 veya sonraki sürümlerde ortaya 
çıkan olası davranış değişikliklerinin kabul etmesine veya devre dışı olmasına izin verir. 

Daha fazla bilgi için bkz. ASP.NET Core MVC için uyumluluk sürümü. 


Ek kaynaklar 








ASP.NET Core- MVC İçin Mysınanan. AspNetCore. Mvc-Floent test Kitaplığı , MVC ve Web API 
uygulamalarını test etmek için akıcı bir arabirim sağlar. {Microsoft tarafından korunmaz veya desteklenmez. 


ASPNET Core MVC ile bir web uygulaması oluşturma 

10.05.2019 • 2 minutes to read ı Edit Online 


Bu öğretici, ASP.NET Core MVC denetleyicileri ve görünümleri ile web geliştirme öğretir.ASP.NET Core vveb 
geliştirmeye yeni başladıysanız göz önünde bulundurun Razor sayfaları sürümü bu öğreticinin bir daha kolay bir 
başlangıç noktası sağlar. 

Öğretici serisinin aşağıdakileri içerir: 

1. Kullanmaya başlama 

2. Denetleyici ekleme 

3. Görünüm ekleme 

4. Model ekleme 

5. SQL Server LocalDB ile çalışma 

6. Denetleyici metotları ve görünümleri 

7. Arama ekleme 

8. Yeni alan ekleme 

9. Doğrulama ekleme 

10. Details ve Delete metotlarını inceleme 








ASRNET Core MVC ile çalışmaya başlama 

7.11.2019 * 20 minutes to read ı Edit Online 


Rick Anderson tarafından 

Bu öğretici, ASP.N ET Core MVC denetleyicileri ve görünümleri ile web geliştirme öğretir. ASP.NET Core web 
geliştirmeye yeni başladıysanız göz önünde bulundurun Razor sayfaları sürümü bu öğreticinin bir daha kolay 
bir başlangıç noktası sağlar. 

Bu öğretici, AS P.N ET Core MVC web uygulaması oluşturma hakkında temel bilgileri öğretir. 

Uygulama, bir film başlıkları veritabanını yönetir. Aşağıdakilerin nasıl yapıldığını öğreneceksiniz: 

• Bir Web uygulaması oluşturun. 

• Bir modeli ekleyin ve yapı iskelesi yapın. 

• Bir veritabanıyla çalışın. 

• Arama ve doğrulama ekleyin. 

Sonunda, film verilerini yönetebilen ve görüntüleyebilen bir uygulamanız vardır. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini). 

Prerequisites 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• ASP.net ve Web geliştirme iş yüküyle Visual Studio 2019 

• .NET Core 3,0 SDK veya üzeri 

Web uygulaması oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Visual Studio 'da Yeni proje oluştur' u seçin. 

• ASP.N ET Core Web uygulaması ' nı seçin ve ardından İleri' yi seçin. 






Create a new project 


Search for project templates fi - Language ▼ Platform - Project type 


Recent project templates 

O ASP.NET Core Web Application 
Sl Class Library (.NET Standard) 


C# 

C# 




Console App (.NET Core) 

A project for creating a command-line application that can run on .NET Core on 
Windows, Linux and MacOS. 


C# Lınux macOS Windows Console 



ASP.NET Core Web Application 

Project templates for creating ASP.NET Core applıcatıons for Wındows, Lınux and 
macOS usıng .NET Core or .NET Framework. Create Razor Pages, MVC, Web API, and 
Single Page (SPA) Applications. 


C# Windows Linux macOS Web 



WPF App (.NET Core) 

Windows Presentation Foundation dient application 


C* * Wındows Desktop 


pL^7 Class Library (.NET Standard) 

A project for creating a class library that targets .NET Standard. 

C# Android iOS Linux macOS Windows Library 


<f> 


Azure Functions 

A template to create an Azure Function project. 
C# Azure Cloud 


Mobile App (Xamarin.Forms) 

□=J ........... 


OS and Android vvith Xaı 


Next 


• Projeyi Mvcfilmi olarak adlandırın ve Oluştur' u seçin. Kodu kopyaladığınızda, ad alanının eşleşmesi 
için, projeyi Mvcfilmi olarak adlandırmak önemlidir. 


Configure your new project 

ASP.NET Core Web Application o wmdov*s unux macos w«b 

Project name 
MvcMovie 

Locatıon 

| C:\Users\nck\source\repos 

Solution name O 

R1 Place solution and project in the same directory 


Back Create 


• Web uygulaması (Model-View-Controller) öğesini seçin ve ardından Oluştur 1 u seçin. 







X 


Create a new ASP.NET Core web application 


.NET Core 


ASP.NET Core 3.0 


^ Empty 

An empty project template for creating an ASP.NET Core application. This template does not have any content in it 



A project template for creating an ASP.NET Core application with an cxample Controller for a RESTful HTTP service. 
This template can also be used for ASP.NET Core MVC Views and Controllers. 


Web Application 

A project template for creating an ASP.NET Core application vvitfı exarnple ASP.NET Razor Pages content. 


Web Application (Model-Vievv-Controller) 

A project template for creating an ASP.NET Core application vvith example ASP.NET Core MVC Vievvs and 
Controllers. This template can also be used for RESTful HTTP Services. 


fŞl Angular 

A project template for creating an ASP.NET Core application with Angular 


Authentication 

No Authentication 

Change 


Advanced 

0 Configurefor HIIPS 
I I Enable Docker Support 
(Reguires Docker Desktop) 


React.js 


Author: Microsoft 
Source: .NET Core 3.0.0 


Get additional project templates 


Back 


Create 


Visual Studio, az önce oluşturduğunuz MVC projesi için varsayılan şablonu kullandı. Şimdi bir proje adı girip 
birkaç seçenek belirleyerek, çalışan bir uygulamanız var. Bu, temel bir başlatıcı projem. 

Uygulamayı çalıştırma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Uygulamayı hata ayıklamasız modda çalıştırmak için CTRL-F5 ' i seçin. 

Visual Studio aşağıdaki iletişim kutusunu görüntüler: 

Microsoft Visual Studio X 

O This project ıs configured to use SSL To avoid SSL vvamings ın the browser you 
can choose to trust the self-sıgned certificate that IIS Express has generated. 

Would you lıke to trust the IIS Express SSL certificate? 

Leam More 

H Don't ask me again 

Yes No 

IIS Express SSL sertifikasına güveniyorsanız Evet 1 i seçin. 


Aşağıdaki iletişim kutusu görüntülenir: 






























Security VVaming 


You are about to install a certif icate from a certification 
| \ authority (CA) daiming to represent 

localhost 

Windows cannotvalidate thatthe certif icate is actuallyfrom 
'localhost'. You should confirm its origin by contacting 
'localhost'. The follovving number will assist you in this 
process: 

Thumbprint (shal): 35AAFB1F 70EC5F89 C7180FBD 61AFE491 
94580874 

Warning: 

If you install this root certificate, Windows vvill automatically 
trust any certificate issued by this CA. Installing a certificate 
with an unconfirmed thumbprint is a security risk. If you dick 
'Yes' you acknovvledge this risk. 

Do you want to install this certificate? 



Geliştirme sertifikasına güvenmeyi kabul ediyorsanız Evet ' i seçin. 

• Visual Studio I IS Express başlar ve uygulamayı çalıştırır. Adres çubuğunda localhost :port# ve 

exampie.com gibi bir şey gösterilmediğine dikkat edin. Bunun nedeni, localhost yerel bilgisayarınız için 
Standart ana bilgisayar adıdır. Visual Studio bir Web projesi oluşturduğunda, Web sunucusu için rastgele 
bir bağlantı noktası kullanılır. 

• Uygulamayı CTRL + F5 (hata ayıklama modu) ile başlatmak, kod değişiklikleri yapmanıza, dosyayı 
kaydetmenize, tarayıcıyı yenilemanıza ve kod değişikliklerini görmenize olanak tanır. Birçok geliştirici, 
uygulamayı hızlı bir şekilde başlatmak ve değişiklikleri görüntülemek için hata ayıklama olmayan modu 
kullanmayı tercih eder. 


Hata ayıklama menü öğesinden uygulamayı hata ayıklama veya hata ayıklama olmayan modda 
başlatabilirsiniz: 


MvcMovie - Microsoft Visual Studio 

File Edit View Project Build Debug 


Windows 

► 

► 

Start Debugging 

F5 

> 

Start Without Debugging 

Ctrl* F5 

m 

Performance Profiler... 

AK+F2 


Attach to Process... 

Ctrl+Alt+P 


Other Debug Targets 

► 


Profiler 

► 

* 

• 

Step Into 

Fil 

Ol 

• 

Step Över 

F10 


Toggle Breakpoint 

F9 


New Breakpoint 

► 


Delete Ali Breakpoints 

Ctrl+Shift+F9 

o 

Options... 


p 

MvcMovie Properties... 



fr 3 ^Quick Launch (Ctrl+OJ P _ □ X 

Team Tools Test Analyze Rick Anderson (ASP.NET) » ^ 


- ► US Express - 6 - * ^ 



• 11S Express düğmesini seçerek uygulamada hata ayıklaması yapabilirsiniz 























* MvcMovie - Microsoft Visual Studio 


File Edit View Project Build Debug Team Tools Architecture 



Aşağıdaki görüntüde uygulama gösterilmektedir: 


| - Home Page - MvcMovie X + 

O A https://localhost:5001 
MvcMovie Home Privacy 


Welcome 


Learn about building Web apps with ASP.NET Core. 


© 2019 - MvcMovie - Privacy 


□ X 

O. ö İ 


• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Visual Studio Yardım 

• Hata ayıklamayı öğrenin C# kullanarak Visual Studio code 

• Visual Studio IDE'yi giriş 

Bu öğreticinin bir sonraki bölümünde, MVC hakkında bilgi edinirsiniz ve kod yazmaya başlayabilirsiniz. 


N E X T 


Bu öğretici, ASP.N ET Core MVC denetleyicileri ve görünümleri ile web geliştirme öğretir. ASP.NET Core web 
geliştirmeye yeni başladıysanız göz önünde bulundurun Razor sayfaları sürümü bu öğreticinin bir daha kolay 
bir başlangıç noktası sağlar. 

Bu öğretici, AS P.N ET Core MVC vveb uygulaması oluşturma hakkında temel bilgileri öğretir. 

Uygulama, bir film başlıkları veritabanını yönetir. Aşağıdakilerin nasıl yapıldığını öğreneceksiniz: 









• Bir Web uygulaması oluşturun. 

• Bir modeli ekleyin ve yapı iskelesi yapın. 

• Bir veritabanıyla çalışın. 

• Arama ve doğrulama ekleyin. 

Sonunda, film verilerini yönetebilen ve görüntüleyebilen bir uygulamanız vardır. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini). 

Prerequisites 

• Visuai Studio 

• Visuai Studio Code 

• Mac için Visuai Studio 

• Visuai Studio 2019 ile ASP.N ET ve web geliştirme iş yükü 

• .NET core SDK 2.2 veya üzeri 


VVARNING 

Visuai Studio 2017 kullanıyorsanız bkz dotnet/SDK'sı sorun #3124 Visuai Studio ile çalışmayan .NET Core SDK sürümleri 
hakkında bilgi için. 


Web uygulaması oluşturma 

• Visuai Studio 

• Visuai Studio Code 

• Mac için Visuai Studio 

• Visuai Studio 'da Yeni proje oluştur' u seçin. 

• ASP.N ET Core Web uygulaması ' nı seçin ve ardından İleri' yi seçin. 




Create a new project 


Search for project templates fi - Language ▼ Platform - Project type 


Recent project templates 

O ASP.NET Core Web Application 
Sl Class Library (.NET Standard) 


C# 

C# 




Console App (.NET Core) 

A project for creating a command-line application that can run on .NET Core on 
Windows, Linux and MacOS. 


C# Lınux macOS Windows Console 



ASP.NET Core Web Application 

Project templates for creating ASP.NET Core applıcatıons for Wındows, Lınux and 
macOS usıng .NET Core or .NET Framework. Create Razor Pages, MVC, Web API, and 
Single Page (SPA) Applications. 


C# Windows Linux macOS Web 



WPF App (.NET Core) 

Windows Presentation Foundation dient application 


C* Wındows Desktop 


pL^7 Class Library (.NET Standard) 

A project for creating a class library that targets .NET Standard. 

C# Android iOS Linux macOS Windows Library 


<f> 


Azure Functions 

A template to create an Azure Function project. 
C# Azure Cloud 


Mobile App (Xamarin.Forms) 

□=J ........... 


OS and Android vvith Xaı 


Next 


• Projeyi Mvcfilmi olarak adlandırın ve Oluştur' u seçin. Kodu kopyaladığınızda, ad alanının eşleşmesi 
için, projeyi Mvcfilmi olarak adlandırmak önemlidir. 


Configure your new project 

ASP.NET Core Web Application o wmdov*s unux macos w«b 

Project name 
MvcMovie 

Locatıon 

| C:\Users\nck\source\repos 
Solution name O 

R1 Place solution and project in the same directory 


Back Create 


• Web uygulaması (Model-View-Controller) öğesini seçin ve ardından Oluştur 1 u seçin. 







Create a new ASP.NET Core Web Application 


.NET Core 


ASP.NET Core 2.2 


^ Empty 

An empty project template for creating an ASP.NET Core application. This template does not have any 
content in it. 



A project template for creating an ASP.NET Core application with an example Controller for a RESTful HTTP 
service. This template can also be used for ASP.NET Core MVC Vievvs and Controllers. 


§3 


Web Application 

A project template for creating an ASP.NET Core application with example ASP.NET Core Razor Pages 
content. 


Web Application (Model-Vievv-Controller) 

A project template for creating an ASP.NET Core application with example ASP.NET Core MVC Vievvs and 
Controllers. This template can also be used for RESTful HTTP Services. 


□ || Razor Class Library 

A project template for creating a Razor class library. 


Annıılar 

Get additional project templates 


Authentication 

No Authentication 

Change 


Advanced 

R1 Configure for HTTPS 
I | Enable Docker Support 
(Reguires Docker Desktop) 


Author: Microsoft 
Source: SDK 2.2.104 


Back 


Create 


Visual Studio, az önce oluşturduğunuz MVC projesi için varsayılan şablonu kullandı. Şimdi bir proje adı girip 
birkaç seçenek belirleyerek, çalışan bir uygulamanız var. Bu, temel bir başlatıcı projem ve başlamak için iyi bir 
yerdir. 

Uygulamayı çalıştırma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 


Uygulamayı hata ayıklamasız modda çalıştırmak için CTRL-F5 ' i seçin. 
Visual Studio aşağıdaki iletişim kutusunu görüntüler: 


Microsoft Visual Studio 


X 


O This project ıs confıgured to use SSL To avoıd SSL vvarnıngs ın the browser you 
can choose to trust the self-sıgned certificate that IIS Express has generated. 


Would you lıke to trust the IIS Express SSL certificate? 


H Don't ask me again 


Yes 


No 


IIS Express SSL sertifikasına güveniyorsanız Evet 1 i seçin. 
Aşağıdaki iletişim kutusu görüntülenir: 






















Security VVaming 


You are about to install a certif icate from a certification 
| \ authority (CA) daiming to represent 

localhost 

Windows cannotvalidate thatthe certif icate is actuallyfrom 
'localhost'. You should confirm its origin by contacting 
'localhost'. The follovving number will assist you in this 
process: 

Thumbprint (shal): 35AAFB1F 70EC5F89 C7180FBD 61AFE491 
94580874 

Warning: 

If you install this root certificate, Windows vvill automatically 
trust any certificate issued by this CA. Installing a certificate 
with an unconfirmed thumbprint is a security risk. If you dick 
'Yes' you acknovvledge this risk. 

Do you want to install this certificate? 



Geliştirme sertifikasına güvenmeyi kabul ediyorsanız Evet ' i seçin. 

• Visual Studio I IS Express başlar ve uygulamayı çalıştırır. Adres çubuğunda localhost :port# ve 

exampie.com gibi bir şey gösterilmediğine dikkat edin. Bunun nedeni, localhost yerel bilgisayarınız için 
Standart ana bilgisayar adıdır. Visual Studio bir Web projesi oluşturduğunda, Web sunucusu için rastgele 
bir bağlantı noktası kullanılır. 

• Uygulamayı CTRL + F5 (hata ayıklama modu) ile başlatmak, kod değişiklikleri yapmanıza, dosyayı 
kaydetmenize, tarayıcıyı yenilemanıza ve kod değişikliklerini görmenize olanak tanır. Birçok geliştirici, 
uygulamayı hızlı bir şekilde başlatmak ve değişiklikleri görüntülemek için hata ayıklama olmayan modu 
kullanmayı tercih eder. 


Hata ayıklama menü öğesinden uygulamayı hata ayıklama veya hata ayıklama olmayan modda 
başlatabilirsiniz: 


MvcMovie - Microsoft Visual Studio 

File Edit View Project Build Debug 


Windows 

► 

► 

Start Debugging 

F5 

> 

Start Without Debugging 

Ctrl* F5 

m 

Performance Profiler... 

AK+F2 


Attach to Process... 

Ctrl+Alt+P 


Other Debug Targets 

► 


Profiler 

► 

* 

• 

Step Into 

Fil 

Ol 

• 

Step Över 

F10 


Toggle Breakpoint 

F9 


New Breakpoint 

► 


Delete Ali Breakpoints 

Ctrl+Shift+F9 

o 

Options... 


p 

MvcMovie Properties... 



fr 3 ^Quick Launch (Ctrl+OJ P _ □ X 

Team Tools Test Analyze Rick Anderson (ASP.NET) » ^ 


- ► US Express - 6 - * ^ 



• 11S Express düğmesini seçerek uygulamada hata ayıklaması yapabilirsiniz 























* MvcMovie - Microsoft Visual Studio 


File Edit View Project Build Debug Team Tools Architecture 



izlemeye izin vermek için kabul et 1 i seçin. Bu uygulama kişisel bilgileri izlemez. Şablon tarafından 
oluşturulan kod, genel veri koruma yönetmeliği (GDPR)buluşmanıza yardımcı olan varlıkları içerir. 

| Home Page - MvcMovie X + 

O A https://localhost:5001 
MvcMovie Home Privacy 

Use this space to summarize your privacy and cookie use policy. Learn More. Accept 

VVelcome 

Learn about building Web apps with ASP.NET Core. 


© 2019 - MvcMovie - Privacy 


- □ X 

O. ö : 


Aşağıdaki görüntüde izlemeyi kabul ettikten sonra uygulama gösterilmektedir: 







| Home Page - MvcMovie X + 

O A https://localhost:5001 
MvcMovie Home Privacy 

VVelcome 

Learn about building Web apps vvith ASP.NET Core 


© 2019 - MvcMovie - Privacy 


- □ X 

o. 0 ; 




• Visuai Studio 

• Visuai Studio Code 

• Mac için Visuai Studio 

Visuai Studio Yardım 

• Hata ayıklamayı öğrenin C# kullanarak Visuai Studio code 

• Visuai Studio IDE'yi giriş 

Bu öğreticinin bir sonraki bölümünde, MVC hakkında bilgi edinirsiniz ve kod yazmaya başlayabilirsiniz. 


N E X T 





ASRNET Core MVC uygulamasına denetleyici 
ekleme 

7.08.2019 • 21 minutes to read ı Edit Online 


Tarafından Rick Anderson 

Model-View-Controller (MVC) mimari modeli, bir uygulamayı üç ana bileşene ayırır: Model, VIEW ve 

Controller. MVC deseninin daha kararlı ve geleneksel tek parçalı uygulamalardan güncelleştirilmesi daha kolay 

olan uygulamalar oluşturmanıza yardımcı olur. MVC tabanlı uygulamalar şunları içerir: 

• Aodels: Uygulamanın verilerini temsil eden sınıflar. Model sınıfları, bu veriler için iş kurallarını zorlamak 
üzere doğrulama mantığını kullanır. Genellikle, model nesneleri bir veritabanında model durumunu alır 
ve saklar. Bu öğreticide, bir Movie model bir veritabanından film verileri alır, bunu görünüme sağlar veya 
güncelleştirir. Güncelleştirilmiş veriler bir veritabanına yazılır. 

• Vıews: Görünümler, uygulamanın kullanıcı arabirimini (Ul) görüntüleyen bileşenlerdir.Genellikle, bu 
kullanıcı arabirimi model verilerini görüntüler. 

• Controlleyiciler: Tarayıcı isteklerini işleyen sınıflar. Model verileri alır ve yanıt döndüren çağrı görünümü 
şablonları. MVC uygulamasında, görünüm yalnızca bilgileri görüntüler; denetleyici, Kullanıcı girişini ve 
etkileşimini işler ve yanıtlar. Örneğin, denetleyici rota verilerini ve sorgu dizesi değerlerini işler ve bu 
değerleri modele geçirir. Model bu değerleri veritabanını sorgulamak için kullanabilir.Örneğin, 



kullanarak, İD = 5 olan filmi düzenleme isteği. Rota verileri öğreticide daha sonra açıklanmaktadır. 

MVC deseninin uygulamanın farklı yönlerini (Giriş mantığı, iş mantığı ve Kullanıcı arabirimi mantığı) ayıran 
uygulamalar oluşturmanıza yardımcı olur, bu öğeler arasında gevşek bir bağ sağlanır. Bu model, her bir mantık 
türünün uygulamada nerede bulunması gerektiğini belirtir. Kullanıcı arabirimi mantığı görünüme aittir.Giriş 
mantığı denetleyiciye aittir. İş mantığı modele aittir. Bu ayrım, bir uygulama oluşturduğunuzda karmaşıklığın 
yönetilmesine yardımcı olur, çünkü uygulamanın bir tek tarafında, başka bir kodu etkilemeden bir kez 
çalışmanıza olanak sağlar. Örneğin, iş mantığı koduna bağlı kalmadan görünüm kodu üzerinde çalışabilirsiniz. 

Bu kavramları, bu öğretici serisinde ele alınmaktadır ve bir film uygulaması oluşturmak için nasıl kullanacağınızı 
gösterir. MVC projesi denetleyicilerde Görünümlenç in klasörler içerir. 

Denetleyici ekleme 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 


• Çözüm Gezgini, denetleyiciler öğesine sağ tıklayın > > denetleyicisi 
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Docker Support 


(5 

Copy 

Ctri+C 


Client-Side Library... 
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Delete 

Del 


Class_. 


□ 

Rename 



C* Öpen Folder in File Explorer 
P Properties Alt+Enter 


Controllers 



• Yapı İskelesi Ekle iletişim kutusunda, MVC denetleyicisi-boş seçeneğini belirleyin 



• Boş MVC denetleyicisi Ekle iletişim kutusunda, Merhaba vvorldcontroller yazın ve Ekle 1 yi seçin. 


Controllers/HeUoWorldControUer. cs içeriğini aşağıdakiler ile değiştirin: 















using Microsoft.AspNetCore.Mvc; 
using System.Text.Encodings.Web; 

namespace MvcMovie.Controllers 
{ 

public class HelloWorldController : Controller 
{ 

// 

// GET: /HelloWorld/ 

public string Index() 

{ 

return "This is my default action..."; 

} 

// 

// GET: /HelloWorld/Welcome/ 

public string Welcome() 

{ 

return "This is the Welcome action method..."; 

} 

} 

} 

Bir public denetleyicideki her yöntem bir HTTP uç noktası olarak çağrılabilir. Yukarıdaki örnekte her iki 
yöntem de bir dize döndürür. Her yöntemden önceki açıklamalara göz önüne alın. 

HTTP uç noktası, https://iocaihost:500i/Heiioworid gibi Web uygulamasındaki bir hedeflenebilir URL 'sidir ve 
https kullanılan protokolü, Web sunucusunun ağ konumunu (TCP bağlantı noktası dahil): localhost : 500 ı ve 
hedef URI Heiioworid 'yi birleştirir. 

ilk açıklama bu, temel URL 'ye eklenerek /Heliouorid/ çağrılan bir http get yöntemi olduğunu belirtir, ikinci 
açıklama URL 'ye eklenerek /Heiioworid/weicome/ çağrılan bir http get yöntemini belirtir. Öğreticide daha 
sonra, verileri güncelleştiren Yöntemler oluşturmak http post için scafkatlama altyapısı kullanılır. 

Uygulamayı hata ayıklama modunda çalıştırın ve adres çubuğundaki yola "HelloVVorld" ekleyin. index Yöntemi 
bir dize döndürür. 


| https://localhost:5001/helloWorl X + 

C A https://localhost:5001/helloWorld O. ğ : 

This is my default action... 












MVC, gelen URL 'y e bağlı olarak denetleyici sınıflarını (ve içindeki eylem yöntemlerini) çağırır.MVC tarafından 
kullanılan varsayılan URL yönlendirme mantığı, çağrılacak kodu belirlemek için şöyle bir biçim kullanır: 

/[Controller]/[ActionName]/[Parameters] 

Yönlendirme biçimi configure Startup.es dosyasındaki yönteminde ayarlanır. 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapControllerRoute( 
name: "default", 

pattern: "{controller=Home}/{action=Index}/{id?}"); 

}); 

Uygulamaya gözatıp hiçbir URL kesimini sağlamadığınızda, varsayılan olarak "giriş" denetleyicisi ve yukarıda 
vurgulanan şablon satırında belirtilen "Dizin" yöntemi varsayılan olarak belirtilir. 

ilk URL segmenti, çalıştırılacak denetleyici sınıfını belirler.Bu localhost:{PORT}/Heiioworid nedenle 
HelloVVorldController sınıfıyla eşlenir.URL segmentinin ikinci bölümü, sınıfındaki Action metodunu belirler.Bu 
localhost:{PORT}/Heiioworid/index nedenle, Heiioi/JoridControiier sınıfın index yönteminin çalışmasına neden 
olur. Yalnızca göz atmanızı localhost:{PORT}/Heiioworid index ve yönteme varsayılan olarak çağrıldığına dikkat 
edin. Bunun nedeni index , açıkça bir yöntem adı belirtilmemişse bir denetleyicide çağrılacak varsayılan 
yöntemdir. URL segmentinin ( id ) üçüncü bölümü rota verileri içindir.Rota verileri öğreticide daha sonra 
açıklanmaktadır. 

konumuna gözatın https: //localhost:{PORT}/HeiioiAiorid/weicome . Yöntemi çalışır ve dizeyi 


This is the Welcome action method... 

döndürür. 

kleleome 

Bu URL için denetleyici 

Helloklorld 

, ve 

klelcome 


eylem yöntemidir. URL 'nin bir [Parameters] bölümünü henüz kullanmadınız. 



URL 'den denetleyiciye bazı parametre bilgilerini geçirmek için kodu değiştirin. Örneğin: 
/Heiioworid/weicome?name=Rick&numtimes=4 . weicome Yöntemi aşağıdaki kodda gösterildiği gibi iki parametre 
içerecek şekilde değiştirin. 


















// GET: /HelloWorld/Welcome/ 

// Requires using System.Text.Encodings.Web; 
public string Welcome(string name, int numTimes = 1) 

{ 

return HtmlEncoder.Default.Encode($"Hello {name}, NumTimes is: {numTimes}"); 

} 

Yukarıdaki kod: 

• Parametresi için C# hiçbir değer geçirilmemişse, numTimes parametrenin varsayılan olarak 1 ' e ait olduğunu 
belirtmek için isteğe bağlı parametre özelliğini kullanır. 

• Uygulamayı HtmiEncoder.Default.Encode kötü amaçlı girişten korumak için kullanır (yani JavaScript). 

• İçinde $"Heiio {name}, NumTimes is: {numTimes}" enterpolasyonlu dizeler kullanır. 

Uygulamayı çalıştırın ve şu konuma gidin: 

https://localhost:{P0RT}/HelloWorld/Welcome?name=Rick&numtimes=4 

(Bağlantı {port} noktası numaranız ile değiştirin.) URL'de ve name numtimes için farklı değerler 
deneyebilirsiniz. MVC model bağlama sistemi, adlandırılmış parametreleri adres çubuğundaki sorgu dizesinden 
yöntemdeki parametrelere otomatik olarak eşler. Daha fazla bilgi için bkz. model bağlama . 

. □ X 

| https://localhost:5001/helloWorl X + 

4- O A https://localhost:5001/helloWorld/welcome?name=Rick&numtimes=4 O. ğ : 

Hello Rick, NumTimes is: 4 


Yukarıdaki görüntüde, Parametens URL segmenti () kullanılmaz name , ve numTimes parametreleri sorgu 
dizeleriolarak geçirilir. Yukarıdaki URL 'deki (soru işareti) bir ayırıcı ve sorgu dizeleri izler. ? & Karakter Sorgu 
dizelerini ayırır. 

weicome Yöntemini aşağıdaki kodla değiştirin: 

public string Welcome(string name, int ID = 1) 

{ 

return HtmlEncoder.Default.Encode($"Hello {name}, ID: {ID}"); 

} 

Uygulamayı çalıştırın ve aşağıdaki URL 'Yİ girin: https://localhost:{P0RT}/HelloWorld/Welcome/3?name=Rick 

Bu kez, üçüncü URL segmenti rota parametresiyle id eşleşti. Yöntemi, MapControiierRoute yöntemindeki URL 
şablonuyla id eşleşen bir parametre içerir. weicome Sondaki ? (içinde id? ) id parametresinin isteğe bağlı 
olduğunu gösterir. 
















app.UseEndpoints(endpoints => 

{ 

endpoints.MapControllerRoute( 
name: "default", 

pattern: "{controller=Home}/{action=Index}/{id?}"); 

}); 


Bu örneklerde, denetleyici MVC 'nin “VC" bölümünü (yani, VIEW ve C) çalışır.Denetleyici HTML ‘i doğrudan 
döndürüyor. Genellikle, bu, kod ve bakım için çok daha fazla hale geldiği için denetleyicilerin doğrudan HTML 
döndürmesini istemezsiniz. Bunun yerine, genellikle HTML yanıtı oluşturmak için ayrı bir Razor görünümü 
şablon dosyası kullanırsınız. Bunu bir sonraki öğreticide yapabilirsiniz. 


ÖNCEKİ 


ileri 


Model-View-Controller (MVC) mimari modeli, bir uygulamayı üç ana bileşene ayırır: Model, VIEW ve 
Controller. MVC deseninin daha kararlı ve geleneksel tek parçalı uygulamalardan güncelleştirilmesi daha kolay 
olan uygulamalar oluşturmanıza yardımcı olur. MVC tabanlı uygulamalar şunları içerir: 

• Aodels: Uygulamanın verilerini temsil eden sınıflar. Model sınıfları, bu veriler için iş kurallarını zorlamak 
üzere doğrulama mantığını kullanır. Genellikle, model nesneleri bir veritabanında model durumunu alır 
ve saklar. Bu öğreticide, bir Movie model bir veritabanından film verileri alır, bunu görünüme sağlar veya 
güncelleştirir. Güncelleştirilmiş veriler bir veritabanına yazılır. 

• Vıews: Görünümler, uygulamanın kullanıcı arabirimini (Ul) görüntüleyen bileşenlerdir.Genellikle, bu 
kullanıcı arabirimi model verilerini görüntüler. 

• Controlleyiciler: Tarayıcı isteklerini işleyen sınıflar. Model verileri alır ve yanıt döndüren çağrı görünümü 
şablonları. MVC uygulamasında, görünüm yalnızca bilgileri görüntüler; denetleyici, Kullanıcı girişini ve 
etkileşimini işler ve yanıtlar. Örneğin, denetleyici rota verilerini ve sorgu dizesi değerlerini işler ve bu 
değerleri modele geçirir. Model bu değerleri veritabanını sorgulamak için kullanabilir.Örneğin, 



kullanarak, İD = 5 olan filmi düzenleme isteği. Rota verileri öğreticide daha sonra açıklanmaktadır. 

MVC deseninin uygulamanın farklı yönlerini (Giriş mantığı, iş mantığı ve Kullanıcı arabirimi mantığı) ayıran 
uygulamalar oluşturmanıza yardımcı olur, bu öğeler arasında gevşek bir bağ sağlanır. Bu model, her bir mantık 
türünün uygulamada nerede bulunması gerektiğini belirtir. Kullanıcı arabirimi mantığı görünüme aittir.Giriş 
mantığı denetleyiciye aittir. İş mantığı modele aittir. Bu ayrım, bir uygulama oluşturduğunuzda karmaşıklığın 
yönetilmesine yardımcı olur, çünkü uygulamanın bir tek tarafında, başka bir kodu etkilemeden bir kez 
çalışmanıza olanak sağlar. Örneğin, iş mantığı koduna bağlı kalmadan görünüm kodu üzerinde çalışabilirsiniz. 

Bu kavramları, bu öğretici serisinde ele alınmaktadır ve bir film uygulaması oluşturmak için nasıl kullanacağınızı 
gösterir. MVC projesi denetleyicilerde Görünümler için klasörler içerir. 

Denetleyici ekleme 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 


• Çözüm Gezgini, denetleyiciler öğesine sağ tıklayın > > denetleyicisi 
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• Yapı İskelesi Ekle iletişim kutusunda, MVC denetleyicisi-boş seçeneğini belirleyin 



• Boş MVC denetleyicisi Ekle iletişim kutusunda, Merhaba vvorldcontroller yazın ve Ekle 1 yi seçin. 


Controllers/HeUoWorldControUer. cs içeriğini aşağıdakiler ile değiştirin: 















using Microsoft.AspNetCore.Mvc; 
using System.Text.Encodings.Web; 

namespace MvcMovie.Controllers 
{ 

public class HelloWorldController : Controller 
{ 

// 

// GET: /HelloWorld/ 

public string Index() 

{ 

return "This is my default action..."; 

} 

// 

// GET: /HelloWorld/Welcome/ 

public string Welcome() 

{ 

return "This is the Welcome action method..."; 

} 

} 

} 

Bir public denetleyicideki her yöntem bir HTTP uç noktası olarak çağrılabilir. Yukarıdaki örnekte her iki 
yöntem de bir dize döndürür. Her yöntemden önceki açıklamalara göz önüne alın. 

HTTP uç noktası, https://iocaihost:500i/Heiioworid gibi Web uygulamasındaki bir hedeflenebilir URL 'sidir ve 
https kullanılan protokolü, Web sunucusunun ağ konumunu (TCP bağlantı noktası dahil): localhost : 500 ı ve 
hedef URI Heiioworid 'yi birleştirir. 

ilk açıklama bu, temel URL 'ye eklenerek /Heliouorid/ çağrılan bir http get yöntemi olduğunu belirtir, ikinci 
açıklama URL 'ye eklenerek /Heiioworid/weicome/ çağrılan bir http get yöntemini belirtir. Öğreticide daha 
sonra, verileri güncelleştiren Yöntemler oluşturmak http post için scafkatlama altyapısı kullanılır. 

Uygulamayı hata ayıklama modunda çalıştırın ve adres çubuğundaki yola "HelloVVorld" ekleyin. index Yöntemi 
bir dize döndürür. 


| https://localhost:5001/helloWorl X + 

C A https://localhost:5001/helloWorld O. ğ : 

This is my default action... 












MVC, gelen URL 'y e bağlı olarak denetleyici sınıflarını (ve içindeki eylem yöntemlerini) çağırır.MVC tarafından 
kullanılan varsayılan URL yönlendirme mantığı, çağrılacak kodu belirlemek için şöyle bir biçim kullanır: 

/[Controller]/[ActionName]/[Parameters] 

Yönlendirme biçimi configure Startup.es dosyasındaki yönteminde ayarlanır. 

app.UseMvc(routes => 

{ 

routes.MapRoute( 

name: "default", 

template: "{controller=Home}/{action=Index}/{id?}"); 

}); 

Uygulamaya gözatıp hiçbir URL kesimini sağlamadığınızda, varsayılan olarak "giriş" denetleyicisi ve yukarıda 
vurgulanan şablon satırında belirtilen "Dizin" yöntemi varsayılan olarak belirtilir. 

ilk URL segmenti, çalıştırılacak denetleyici sınıfını belirler.Bu localhost:{PORT}/Heiioworid nedenle, 
HeiioworidController sınıfıyla eşlenir. URL segmentinin ikinci bölümü, sınıfındaki Action metodunu belirler.Bu 
localhost:{PORT}/Heiioworid/index nedenle, HeiioworidControiier sınıfın index yönteminin çalışmasına neden 
olur. Yalnızca göz atmanızı localhost:{PORT}/Heiioworid index ve yönteme varsayılan olarak çağrıldığına dikkat 
edin. Bunun nedeni index , açıkça bir yöntem adı belirtilmemişse bir denetleyicide çağrılacak varsayılan 
yöntemdir. URL segmentinin ( id ) üçüncü bölümü rota verileri içindir.Rota verileri öğreticide daha sonra 
açıklanmaktadır. 

konumuna gözatın https://iocaihost:{PORT}/Heiioworid/weicome . Yöntemi çalışır ve dizeyi 


This is the Welcome action method... 

döndürür. 

Welcome 

Bu URL için denetleyici 

HelloİAİorld 

, ve 

Welcome 


eylem yöntemidir. URL ’nin bir [Parameters] bölümünü henüz kullanmadınız. 

. - □ X 

| https://localhost.5001/helloWorl X + 

O i https://localhost:5001/helloWorld/welcome O. ğ : 

This is the Uelcome action method... 


URL 'den denetleyiciye bazı parametre bilgilerini geçirmek için kodu değiştirin. Örneğin: 
/HeiioWorid/weicome?name=Rick&numtimes=4 . weicome Yöntemi aşağıdaki kodda gösterildiği gibi iki parametre 
içerecek şekilde değiştirin. 




















// GET: /HelloWorld/Welcome/ 

// Requires using System.Text.Encodings.Web; 
public string Welcome(string name, int numTimes = 1) 

{ 

return HtmlEncoder.Default.Encode($"Hello {name}, NumTimes is: {numTimes}"); 

} 

Yukarıdaki kod: 

• Parametresi için C# hiçbir değer geçirilmemişse, numTimes parametrenin varsayılan olarak 1 ' e ait olduğunu 
belirtmek için isteğe bağlı parametre özelliğini kullanır. 

• Uygulamayı HtmiEncoder.Default.Encode kötü amaçlı girişten korumak için kullanır (yani JavaScript). 

• İçinde $"Heiio {name}, NumTimes is: {numTimes}" enterpolasyonlu dizeler kullanır. 

Uygulamayı çalıştırın ve şu konuma gidin: 

https://localhost:{P0RT}/HelloWorld/Welcome?name=Rick&numtimes=4 

(Bağlantı {port} noktası numaranız ile değiştirin.) URL'de ve name numtimes için farklı değerler 
deneyebilirsiniz. MVC model bağlama sistemi, adlandırılmış parametreleri adres çubuğundaki sorgu dizesinden 
yöntemdeki parametrelere otomatik olarak eşler. Daha fazla bilgi için bkz. model bağlama . 

. □ X 

| https://localhost:5001/helloWorl X + 

4- O A https://localhost:5001/helloWorld/welcome?name=Rick&numtimes=4 O. ğ : 

Hello Rick, NumTimes is: 4 


Yukarıdaki görüntüde, Parametens URL segmenti () kullanılmaz name , ve numTimes parametreleri sorgu 
dizeleriolarak geçirilir. Yukarıdaki URL 'deki (soru işareti) bir ayırıcı ve sorgu dizeleri izler. ? & Karakter Sorgu 
dizelerini ayırır. 

weicome Yöntemini aşağıdaki kodla değiştirin: 

public string Welcome(string name, int ID = 1) 

{ 

return HtmlEncoder.Default.Encode($"Hello {name}, ID: {ID}"); 

} 

Uygulamayı çalıştırın ve aşağıdaki URL 'Yİ girin: https://localhost:{P0RT}/HelloWorld/Welcome/3?name=Rick 

Bu kez, üçüncü URL segmenti rota parametresiyle id eşleşti. Yöntemi, MapRoute yöntemindeki URL şablonuyla 
id eşleşen bir parametre içerir. weicome Sondaki ? (içinde id? ) id parametresinin isteğe bağlı olduğunu 
gösterir. 















app.UseMvc(routes => 

{ 

routes.MapRoute( 

name: "default", 

template: "{contnoller=Home}/{action=Index}/{id?}"); 

}); 


Bu örneklerde, denetleyici MVC 'nin "VC" bölümünü (yani, görünüm ve denetleyici çalışır) yapıyor.Denetleyici 
HTML 'i doğrudan döndürüyor. Genellikle, bu, kod ve bakım için çok daha fazla hale geldiği için denetleyicilerin 
doğrudan HTML döndürmesini istemezsiniz. Bunun yerine, genellikle HTML yanıtı oluşturmaya yardımcı 
olması için ayrı bir Razor görünümü şablon dosyası kullanırsınız. Bunu bir sonraki öğreticide yapabilirsiniz. 


ÖNCEKİ 


ileri 





ASRNET Core MVC uygulamasına görünüm 
ekleme 

23.11.2019 * 26 minutes to read ı Edit Online 


Tarafından Rick Anderson 

Bu bölümde, bir istemciye HTML yanıtları oluşturma işlemini düzgün bir şekilde kapsüllemek için 
HeiioworidController sınıfını Razor görünümü dosyalarını kullanacak şekilde değiştirirsiniz. 

Razor kullanarak bir görünüm şablonu dosyası oluşturursunuz. Razor tabanlı görünüm şablonlarının . cshtml 
dosya uzantısı vardır. Bu kişiler ile C#HTML çıktısı oluşturmanın zarif bir yolunu sağlarlar. 

Şu anda index yöntemi, denetleyici sınıfında sabit kodlanmış bir ileti içeren bir dize döndürür. 

HeiioworidController sınıfında, index yöntemini aşağıdaki kodla değiştirin: 

public IActionResult Index() 

{ 

return View(); 

} 

Yukarıdaki kod denetleyicinin Vievv yöntemini çağırır. HTML yanıtı oluşturmak için bir görünüm şablonu 
kullanır. Yukarıdaki index yöntemi gibi denetleyici Yöntemleri ( eylem yöntem /enolarak da bilinir), genellikle, 
string gibi bir tür değil, genellikle bir IActionResult (veya ActionResulttüretilen bir sınıf) döndürür. 

Görünüm ekleme 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Görünümler klasörüne sağ tıklayın ve ardından Yeni > klasör ekleyin ve HelloWorld klasörünü 
adlandırın. 

• Görünümler/HelloVVorld klasörüne sağ tıklayın ve ardından > yeni öğe ekleyin. 

• Yeni öğe Ekle-Mvcfilmi iletişim kutusunda 

o Sağ üst köşedeki arama kutusuna Görünüm girin 
o Razor görünümü seçin 
o lndex. cshtml adlı ad kutusu değerini saklayın. 


o Ekle 'yi seçin 

















Views/HelloWorld/lndex. cshtml Razor görünüm dosyasının içeriğini aşağıdakiler ile değiştirin: 

ViewData["Title"] = "Index"; 

} 

<h2>Index</h2> 

<p>Hello from our View Template!</p> 

https://test-cors.org sayfasına gidin. HeiioworidControiier index yöntemi çok bitmedi; Bu, yönteminin 
tarayıcıya yanıt işlemek için bir görünüm şablonu dosyası kullanması gerektiğini belirten return view(); 
ifadesini çalıştırdı. Bir görünüm şablonu dosya adı belirtilmediğinden, MVC varsayılan görünüm dosyasını 
kullanmaya göre varsayılan olarak ayarlanmış. Varsayılan görünüm dosyası yöntemiyle aynı ada sahiptir ( 
index ), bu nedenle /views/HeiioWorid/lndex.cshtml kullanılır. Aşağıdaki görüntüde "görünüm 
Şablonumuzdan Merhaba!" dizesi gösterilmektedir görünümde sabit kodlanmış. 

| - lndex - MvcMovie X + 

0 A https://localhost:5001/helloWorld 
MvcMovie Home Privacy 

lndex 

Hello from our View Template! 


□ X 

^ e s 


© 2019 - MvcMovie - Privacy 



















Görünümleri ve düzen sayfalarını değiştirme 

Menü bağlantılarını (Mvcmovie, Homeve Gizlilik) seçin. Her sayfada aynı menü düzeni gösterilir.Menü 
düzeni Görünümler/Shared/_Layout. cshtml dosyasında uygulanır. Görünümler/paylaşılan/_Layout. cshtml 
dosyasını açın. 

Düzen şablonları, sitenizin HTM L kapsayıcı yerleşimini tek bir yerde belirtmenize ve sonra sitenizdeki birden 
çok sayfaya uygulamanıza olanak tanır. @RenderBody() satırını bulun. RenderBody , oluşturduğunuz tüm 
görünüme özgü sayfaların, Düzen sayfasında kaydırılan bir yer tutucudur. Örneğin, Gizlilik bağlantısını 
seçerseniz, Görünümler/Home/privacy. cshtml görünümü RenderBody yöntemi içinde işlenir. 

Düzen dosyasındaki başlık, altbilgi ve menü bağlantısını değiştirme 

Görünümler/paylaşılan/_Layout. cshtml dosyasının içeriğini aşağıdaki biçimlendirme ile değiştirin. 
Değişiklikler vurgulanır: 








<!DOCTYPE html> 

<html lang="en"> 

<head> 

<meta charset="utf-8" /> 

<meta name="viewport" content="width=device-widthj initial-scale=1.0" /> 

<title>@ViewData["Title"] - Movie App</title> 

<link rel="stylesheet" hnef="~/lib/bootstrap/dist/css/bootstrap.css" /> 

<link rel="stylesheet" hnef="~/css/site.css" /> 

</head> 

<body> 

<header> 

<nav class="navbar navbar-expand-sm navbar-toggleable-sm navban-light bg-white border-bottom box- 
shadow mb-3"> 

<div class="container"> 

<a class="navbar-brand" asp-controller="Movies" asp-action="Index">Movie App</a> 

<button class="navbar-toggler" type="button" data-toggle="collapse" data-target=".navbar- 
collapse" aria-controls="navbarSupportedContent" 

aria-expanded="false" aria-label="Toggle navigation"> 

<span class="navban-toggler-icon"x/span> 

</button> 

<div class="navbar-collapse collapse d-sm-inline-flex flex-sm-now-reverse"> 

<ul class="navbar-nav flex-gnow-l"> 

<li class="nav-item"> 

<a class="nav-link text-dank" asp-area="" asp-contnoller="Home" asp- 

action="Index">Home</a> 

</li> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-area="" asp-contnoller="Home" asp- 

action="Privacy">Privacy</a> 

</li> 

</ul> 

</div> 

</div> 

</nav> 

</header> 

<div class="containen"> 

<main nole="main" class="pb-3"> 

@RendenBody() 

</main> 

</div> 

<footer class="border-top footer text-muted"> 

<div class="container"> 

&copy; 2019 - Movie App - <a asp-anea="" asp-controller="Home" asp- 
action="Privacy">Privacy</a> 

</div> 

</footer> 

<script src="~/lib/jquery/dist/jquery. js"x/script> 

<script src="~/lib/bootstrap/dist/js/bootstrap.bundle.js"x/script> 

<script src="~/js/site. js" asp-append-version="true"x/script> 

@RenderSection("Scripts", required: false) 

</body> 

</html> 


Yukarıdaki biçimlendirme aşağıdaki değişiklikleri yaptı: 

• MvcMovie Movie App için 3 OİUŞUm. 

• Tutturucu öğe 

<a class="navbar-brand" asp-controller'="Movies" asp-action="Index">Movie App</a>''<a class="navbar- 
brand" asp-area="" asp-controller="Home" asp-action="Index">MvcMovie</a> 


Yukarıdaki biçimlendirmede, bu uygulama alankullandığından asp-area="" tutturucu etiketi Yardımcısı 
özniteliği ve öznitelik değeri atlandı. 






Not: Movies denetleyicisi uygulanmadı. Bu noktada, Movie App bağlantısı işlevsel değildir. 

Değişikliklerinizi kaydedin ve Gizlilik bağlantısını seçin. Tarayıcı sekmesindeki başlığın Gizlilik ilkesi yerine bir 
film uygulaması (Gizlilik ilkesi değil) nasıl görüntülediğini fark edin -MVC filmi: 

. - □ X 

Privacy Policy - Movie App X + 

O i https://localhost:5001/Home/Privacy O. 0 i 

▲ 

Movie App Home Privacy 

Privacy Policy 

Use this page to detail your site's privacy policy. 

© 2019 - Movie App - Privacy 


Giriş bağlantısını seçin ve başlık ve bağlantı metninin film uygulamasımda görüntülediğine dikkat edin. 
Düzen şablonunda değişikliği bir kez yapabildik ve sitedeki tüm sayfalar yeni bağlantı metnini ve yeni başlığı 
yansıtmaktadır. 

Views/_ViewStart. cshtml dosyasını inceleyin: 

Layout = "_Layout"; 

} 

Views/_ViewStart. cshtml dosyası her bir görünüm için views/Shared/_Layout. cshtml dosyasını getirir. 

Layout özelliği, farklı bir düzen görünümü ayarlamak veya nuiı olarak ayarlamak için kullanılabilir; Bu 
nedenle hiçbir düzen dosyası kullanılmayacak. 

Views/HelloWorld/lndex. cshtml görünüm dosyasının başlığını ve <h 2 > öğesini değiştirin: 

ViewData["Title"] = "Movie List"; 

} 

<h2>My Movie List</h2> 

<p>Hello from our View Template!</p> 

Başlık ve <h 2 > öğesi biraz farklıdır, bu sayede kodun hangi bitini görüntülemesini görebilirsiniz. 

yukarıdaki koddaki viewData["Titie"] = "Movie List"; , viewData sözlüğün ntie özelliğini "film listesi" 
olarak ayarlar. Title özelliği, Düzen sayfasındaki <titie> HTML öğesinde kullanılır: 

<title>@ViewData["Title"] - Movie App</title> 

Değişikliği kaydedin ve https://iocaihost:{PORT}/Heiioworid gidin. Tarayıcı başlığı, birincil başlık ve ikincil 
başlıkların değiştirildiğini unutmayın. (Tarayıcıda değişiklik görmüyorsanız, önbelleğe alınmış içeriği 






















görüntülüyor olabilirsiniz. Sunucudan gelen yanıtı zorlamak için tarayıcınızda CTRL + F5 tuşlarına basın.) 
Tarayıcı başlığı, lndex. cshtml görünüm şablonunda belirlediğimiz viewData["Titie"] ve düzen dosyasına 
eklenen ek "-film uygulaması" ile oluşturulur. 


Index. cshtml görünüm şablonundaki içerik views/Shared/_Layout. cshtml görünüm şablonuyla birleştirilir. 
Tarayıcıya tek bir HTML yanıtı gönderilir.Düzen şablonları, bir uygulamadaki tüm sayfalara uygulanan 
değişiklikler yapmayı kolaylaştırır. Daha fazla bilgi için bkz. Düzen. 


| - Movie List - Movie App X + 

- □ X 

4- O A https://localhost:5001/helloWorId 

0. â : 

Movie App Home Privacy 

▲ 

My Movie List 


Hello from our View Template! 


© 2019 - Movie App - Privacy 

▼ 


"Data" (Bu durumda "Görünümümüzden Merhaba!") çok az. ileti) sabit kodludur, ancak. MVC uygulamasında 
bir "V" (görünüm) var ve bir "C" (denetleyici) var, ancak henüz "M" (model) yok. 

Denetleyiciden görünüme veri geçirme 

Gelen URL isteğine yanıt olarak denetleyici eylemleri çağrılır. Bir denetleyici sınıfı, gelen tarayıcı isteklerini 
işleyen kodun yazıldığı yerdir. Denetleyici verileri bir veri kaynağından alır ve tarayıcıya ne tür bir yanıt 
gönderileceğini belirler. Görünüm şablonları bir denetleyiciden, tarayıcıya HTML yanıtı oluşturmak ve 
biçimlendirmek için kullanılabilir. 

Bir görünüm şablonunun yanıt işlemesi için gereken verileri sağlamaktan denetleyiciler sorumludur.En iyi 
yöntem: Görünüm şablonları iş mantığı gerçekleştirmemelidir veya doğrudan bir veritabanıyla etkileşime 
girmemelidir. Bunun yerine, bir görünüm şablonu yalnızca denetleyici tarafından sunulan verilerle birlikte 
çalışmalıdır. Bu "kaygıları ayrımı", kodun temiz, test edilebilir ve sürdürülebilir kalmasına yardımcı olur. 

Şuanda, HeiioworidControiier sınıfındaki weicome yöntemi bir name ve id parametresi alır ve sonra 
değerleri doğrudan tarayıcıya çıkarır. Denetleyicinin bu yanıtı bir dize olarak işlemesini sağlamak yerine, 
denetleyiciyi bir görünüm şablonu kullanacak şekilde değiştirin. Görünüm şablonu dinamik bir yanıt üretir, bu, 
yanıtı oluşturmak için denetleyiciden görünüme uygun veri bitlerinin geçirilmesi gereken anlamına gelir. Bu, 
denetleyicinin görünüm şablonu tarafından daha sonra erişebileceği bir viewData sözlüğünde bulunan 
dinamik verileri (parametreler) yerleştirerek bunu yapın. 

HelloWorldController.cs' de, viewData sözlüğüne bir Message ve NumTimes değeri eklemek için weicome 
yöntemini değiştirin. viewData sözlüğü dinamik bir nesnedir, yani herhangi bir tür kullanılabilir; viewData 
nesnenin içine bir öğe yerleştirene kadar tanımlanmış özellikleri yok. MVC modeli bağlama sistemi , 



























adlandırılmış parametreleri ( name ve numTimes ), adres çubuğundaki sorgu dizesinden yöntemdeki 
parametrelere otomatik olarak eşler. Tüm HelloWorldController.cs dosyası şuna benzer: 

using Microsoft.AspNetCore.Mvc; 
using System.Text.Encodings.Web; 

namespace MvcMovie.Controllers 
{ 

public class HelloWorldController : Controller 
{ 

public IActionResult Index() 

{ 

return View(); 

} 

public IActionResult Welcome(string name, int numTimes = 1) 

{ 

ViewData["Message"] = "Hello " + name; 

ViewData["NumTimes"] = numTimes; 

return View(); 

} 

} 

} 

viewData Dictionary nesnesi görünüme geçirilecek verileri içerir. 

Görünümler/HelloWorld/Welcome. cshtmladU bir hoş geldiniz görünüm şablonu oluşturun. 

Welcome. cshtml görünüm şablonunda "Hello" NumTimes görüntüleyen bir döngü oluşturacaksınız. 
Views/HeUoWorld/Welcome. cshtml içeriğini aşağıdakiler ile değiştirin: 

ViewData["Title"] = "Welcome"; 

} 

<h2>Welcome</h2> 

<ul> 

@for (int i = 0; i < (int)ViewData["NumTimes"]; i++) 

{ 

<li>@ViewData["Message"]</li> 

} 

</ul> 


Değişikliklerinizi kaydedin ve aşağıdaki URL 'ye gidin: 


https://localhost:{P0RT}/HelloWorld/Welcome?name=Rick&numtimes=4 


Veriler URL 'den alınır ve MVC model Bağlayıcısı kullanılarak denetleyiciye geçirilir. Denetleyici, verileri bir 
viewData sözlüğüne paketler ve bu nesneyi görünüme geçirir. Daha sonra Görünüm, verileri tarayıcıda 
HTML olarak işler. 
















Yukarıdaki örnekte viewData sözlüğü denetleyiciden bir görünüme veri geçirmek için kullanılmıştır. 
Öğreticide daha sonra bir görünüm modeli, bir denetleyicideki verileri bir görünüme geçirmek için kullanılır. 
Veri geçirme yaklaşımına yönelik görünüm modeli, viewData sözlük yaklaşımına göre genel olarak çok tercih 
edilir. Daha fazla bilgi için bkz. VievvBag, VievvData veya TempData kullanma . 

Sonraki öğreticide, bir film veritabanı oluşturulur. 


ÖNCEKİ ■ İLERİ 


Bu bölümde, bir istemciye HTML yanıtları oluşturma işlemini düzgün bir şekilde kapsüllemek için 
HeiioworidController sınıfını Razor görünümü dosyalarını kullanacak şekilde değiştirirsiniz. 

Razor kullanarak bir görünüm şablonu dosyası oluşturursunuz. Razor tabanlı görünüm şablonlarının . cshtml 
dosya uzantısı vardır. Bu kişiler ile C#HTML çıktısı oluşturmanın zarif bir yolunu sağlarlar. 

Şu anda index yöntemi, denetleyici sınıfında sabit kodlanmış bir ileti içeren bir dize döndürür. 

HeiioworidController sınıfında, index yöntemini aşağıdaki kodla değiştirin: 

public IActionResult Index() 

{ 

return View(); 

} 

Yukarıdaki kod denetleyicinin Vievv yöntemini çağırır. HTML yanıtı oluşturmak için bir görünüm şablonu 
kullanır. Yukarıdaki index yöntemi gibi denetleyici Yöntemleri ( eylem yöntem /enolarak da bilinir), genellikle, 
string gibi bir tür değil, genellikle bir IActionResult (veya ActionResulttüretilen bir sınıf) döndürür. 

Görünüm ekleme 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Görünümler klasörüne sağ tıklayın ve ardından Yeni > klasör ekleyin ve /-/eZ/okl/oc/c/klasörünü 
adlandırın. 


























• Görünümler/HeUoVVorld klasörüne sağ tıklayın ve ardından > yeni öğe ekleyin. 


• Yeni öğe Ekle-Mvcfilmi iletişim kutusunda 

o Sağ üst köşedeki arama kutusuna Görünüm girin 
o Razor görünümü seçin 
o lndex. cshtml adlı ad kutusu değerini saklayın, 
o Ekle 'yi seçin 



Views/HelloWorld/lndex. cshtml Razor görünüm dosyasının içeriğini aşağıdakiler ile değiştirin: 

ViewData["Title"] = "Index"; 

} 

<h2>Index</h2> 

<p>Hello from our View Template!</p> 

https://test-cors.org sayfasına gidin. HeiioworidControiier index yöntemi çok bitmedi; Bu, yönteminin 
tarayıcıya yanıt işlemek için bir görünüm şablonu dosyası kullanması gerektiğini belirten return view(); 
ifadesini çalıştırdı. Bir görünüm şablonu dosya adı belirtilmediğinden, MVC varsayılan görünüm dosyasını 
kullanmaya göre varsayılan olarak ayarlanmış. Varsayılan görünüm dosyası yöntemiyle aynı ada sahiptir ( 
index ), bu nedeni e /views/HelloWorld/lndex.cshtml kullanılır. Aşağıdaki görüntüde "görünüm 
Şablonumuzdan Merhaba!" dizesi gösterilmektedir görünümde sabit kodlanmış. 






















| lndex - MvcMovie x + 

<- -> C A https://localhost:5001/helloWorld O, ğ : 


MvcMovie Home Privacy 

lndex 

Hello from our View Template! 


© 2019 - MvcMovie - Privacy 


Görünümleri ve düzen sayfalarını değiştirme 

Menü bağlantılarını (Mvcmovie, Homeve Gizlilik) seçin. Her sayfada aynı menü düzeni gösterilir.Menü 
düzeni Görünümler/Shared/_Layout. cshtml dosyasında uygulanır. Görünümler/paylaşdan/_Layout. cshtml 
dosyasını açın. 

Düzen şablonları, sitenizin HTM L kapsayıcı yerleşimini tek bir yerde belirtmenize ve sonra sitenizdeki birden 
çok sayfaya uygulamanıza olanak tanır. @RenderBody() satırını bulun. RenderBody , oluşturduğunuz tüm 
görünüme özgü sayfaların, Düzen sayfasında kaydirdan bir yer tutucudur. Örneğin, Gizlilik bağlantısını 
seçerseniz, Görünümler/Home/privacy. cshtml görünümü RenderBody yöntemi içinde işlenir. 

Düzen dosyasındaki başlık, altbilgi ve menü bağlantısını değiştirme 

• Başlık ve altbilgi öğelerinde MvcMovie Movie App olarak değiştirin. 

• Tutturucu öğe 

<a class="navbar-brand" asp-area="" asp-controller="Home" asp-action="Index">MvcMovie</a> 

<a class="navbar-brand" asp-controller="Movies" asp-action="Index">Movie App</a> olarak değiştirin. 


Aşağıdaki biçimlendirme vurgulanan değişiklikleri göstermektedir: 

<!DOCTYPE html> 

<html> 

<head> 

cmeta charset="utf-8" /> 

<meta name="viewport" content="width=device-width, initial-scale=1.0" /> 

<title>@ViewData["Title"] - Movie App</title> 

<environment include="Development"> 

<link rel="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.css" /> 

</environment> 

<environment exclude="Development"> 

clink rel="stylesheet" href="https://cdnjs. cloudflare.com/ajax/libs/twitter- 
bootstrap/4.1.3/css/bootstrap.min.css" 

asp-fallback-href="~/lib/bootstrap/dist/css/bootstrap.min.css" 

asp-fallback-test-class="sr-only" asp-fallback-test-property="position" asp-fallback-test- 
value="absolute" 

crossorigin="anonymous" 

integrity="sha256-eSilq2PG6D7g7ibl7yAaWMcrr5GrtohYChqibrV7PBE="/> 

</environment> 

<link rel="stylesheet" href="~/css/site.css" /> 











</head> 

<body> 

<header> 

<nav class="navbar navbar-expand-sm navbar-toggleable-sm navbar-light bg-white border-bottom box 
shadow mb-3"> 

<div class="container"> 

<a class="navbar-brand" asp-controller="Movies" asp-action="Index">Movie App</a> 

<button class="navbar-toggler" type="button" data-toggle="collapse" data-target=".navbar 
collapse" aria-controls="navbarSupportedContent" 

aria-expanded="false" aria-label="Toggle navigation"> 

<span class="navbar-toggler-icon"x/span> 

</button> 

<div class="navbar-collapse collapse d-sm-inline-flex flex-sm-row-reverse"> 

<ul class="navbar-nav flex-grow-l"> 

<li class="nav-ltem"> 

<a class="nav-llnk text-dark" asp-area="" asp-controllen="Home" asp- 

action="Index">Home</a> 

</li> 

<li class="nav-ltem"> 

<a class="nav-llnk text-dark" asp-area="" asp-controller="Home" asp- 

action="Privacy">Privacy</a> 

</li> 

</ul> 

</div> 

</div> 

</nav> 

</header> 

<div class="container"> 

<partial name="_CookieConsentPartial" /> 

<main role="main" class="pb-3"> 

@RenderBody() 

</main> 

</div> 

<footer class="border-top footer text-muted"> 

<div class="container"> 

&copy; 2019 - Movie App - <a asp-area="" asp-controller="Home" asp- 
action="Privacy">Privacy</a> 

</div> 

</footer> 

<environment include="Development"> 

<script src="~/lib/jquery/dist/jquery. js"x/script> 

<script src="~/lib/bootstrap/dist/js/bootstrap.bundle.js"x/script> 

</environment> 

<environment exclude="Development"> 

<script src=" https://cdnjs.cloudflare.eom/ajax/libs/jqueny/3.3.l/jquery.mln.js" 
asp-fallback-src="~/lib/jquery/dist/jquery.min.js" 
asp-fallback-test="window.jQuery" 
crossorigin="anonymous" 

integrity="sha256-FgpCb/K3QlLNfOu91ta32o/NMZxltwRo8QtmkMRdAu8="> 

</script> 

eseript src="https://cdnjs. cloudflare.com/ajax/libs/twitter- 
bootstrap/4.1.3/js/bootstrap.bundle.min.js" 

asp-fallback-src="~/lib/bootstrap/dist/js/bootstrap.bundle.min.js" 
asp-fallback-test="window.jQuery && window.jQuery.fn && window.jQuery.fn.modal" 
crossorigin="anonymous" 

integrity="sha256-E/V4cWE4qvAe05M0hjtGtqDzPndR01LBk811/PR7CA4="> 

</script> 

</environment> 

eseript src="~/js/site.js" asp-append-version="true"x/script> 

@RenderSection("Scripts", required: false) 

</body> 

</html> 


Yukarıdaki biçimlendirmede, bu uygulama alankullandığından asp-area tutturucu etiketi yardımcı özniteliği 



atlandı. 


Not: Movies denetleyicisi uygulanmadı. Bu noktada, Movie App bağlantısı işlevsel değildir. 

Değişikliklerinizi kaydedin ve Gizlilik bağlantısını seçin. Tarayıcı sekmesindeki başlığın Gizlilik ilkesi yerine bir 
film uygulaması (Gizlilik ilkesi değil) nasıl görüntülediğini fark edin -MVC filmi: 
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Privacy Policy 

Use this page to detail your site's privacy policy. 


© 2019 - Movie App - Privacy 


Giriş bağlantısını seçin ve başlık ve bağlantı metninin film uygulamasımda görüntülediğine dikkat edin. 
Düzen şablonunda değişikliği bir kez yapabildik ve sitedeki tüm sayfalar yeni bağlantı metnini ve yeni başlığı 
yansıtmaktadır. 

Views/_ViewStart. cshtml dosyasını inceleyin: 

Layout = "_Layout"; 

} 

Views/_ViewStart. cshtml dosyası her bir görünüm için views/Shared/_Layout. cshtml dosyasını getirir. 

Layout özelliği, farklı bir düzen görünümü ayarlamak veya nuiı olarak ayarlamak için kullanılabilir; Bu 
nedenle hiçbir düzen dosyası kullanılmayacak. 

Views/HelloWorld/lndex. cshtml görünüm dosyasının başlığını ve <h 2 > öğesini değiştirin: 

ViewData["Title"] = "Movie List"; 

} 

<h2>My Movie List</h2> 

<p>Hello from our View Template!</p> 

Başlık ve <h 2 > öğesi biraz farklıdır, bu sayede kodun hangi bitini görüntülemesini görebilirsiniz. 

yukarıdaki koddaki viewData["Titie"] = "Movie List"; , viewData sözlüğün ntie özelliğini "film listesi" 
olarak ayarlar. Title özelliği, Düzen sayfasındaki <titie> HTML öğesinde kullanılır: 

<title>@ViewData["Title"] - Movie App</title> 

Değişikliği kaydedin ve https://iocaihost:{PORT}/Heiioworid gidin. Tarayıcı başlığı, birincil başlık ve ikincil 























başlıkların değiştirildiğini unutmayın. (Tarayıcıda değişiklik görmüyorsanız, önbelleğe alınmış içeriği 
görüntülüyor olabilirsiniz. Sunucudan gelen yanıtı zorlamak için tarayıcınızda CTRL + F5 tuşlarına basın.) 
Tarayıcı başlığı, lndex. cshtml görünüm şablonunda belirlediğimiz viewData["Titie"] ve düzen dosyasına 
eklenen ek "-film uygulaması" ile oluşturulur. 

Ayrıca, lndex. cshtml görünüm şablonundaki içeriğin Görünümler/paylaşılan/_Layout. cshtml görünüm 
şablonuyla nasıl birleştirildiğini ve tarayıcıya tek bir HTML yanıtı gönderildiğini de unutmayın. Düzen 
şablonları, uygulamanızdaki tüm sayfalara uygulanan değişiklikler yapmayı gerçekten kolaylaştırır. Daha fazla 
bilgi için bkz. Düzen. 
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My Movie List 


Hello from our Vievv Template! 


© 2019 - Movie App - Privacy 
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"Data" (Bu durumda "Görünümümüzden Merhaba!") çok az. ileti) sabit kodludur, ancak. MVC uygulamasında 
bir "V" (görünüm) var ve bir "C" (denetleyici) var, ancak henüz "M" (model) yok. 

Denetleyiciden görünüme veri geçirme 

Gelen URL isteğine yanıt olarak denetleyici eylemleri çağrılır. Bir denetleyici sınıfı, gelen tarayıcı isteklerini 
işleyen kodun yazıldığı yerdir. Denetleyici verileri bir veri kaynağından alır ve tarayıcıya ne tür bir yanıt 
gönderileceğini belirler. Görünüm şablonları bir denetleyiciden, tarayıcıya HTM L yanıtı oluşturmak ve 
biçimlendirmek için kullanılabilir. 

Bir görünüm şablonunun yanıt işlemesi için gereken verileri sağlamaktan denetleyiciler sorumludur.En iyi 
yöntem: Görünüm şablonları iş mantığı gerçekleştirmemelidir veya doğrudan bir veritabanıyla etkileşime 
girmemelidir. Bunun yerine, bir görünüm şablonu yalnızca denetleyici tarafından sunulan verilerle birlikte 
çalışmalıdır. Bu "kaygıları ayrımı", kodun temiz, test edilebilir ve sürdürülebilir kalmasına yardımcı olur. 

Şuanda, HeiioworidControiier sınıfındaki weicome yöntemi bir name ve id parametresi alır ve sonra 
değerleri doğrudan tarayıcıya çıkarır. Denetleyicinin bu yanıtı bir dize olarak işlemesini sağlamak yerine, 
denetleyiciyi bir görünüm şablonu kullanacak şekilde değiştirin. Görünüm şablonu dinamik bir yanıt üretir, bu, 
yanıtı oluşturmak için denetleyiciden görünüme uygun veri bitlerinin geçirilmesi gereken anlamına gelir. Bu, 
denetleyicinin görünüm şablonu tarafından daha sonra erişebileceği bir viewData sözlüğünde bulunan 
dinamik verileri (parametreler) yerleştirerek bunu yapın. 


HelloWorldController.cs' de, viewData sözlüğüne bir Message ve NumTimes değeri eklemek için weicome 





























yöntemini değiştirin. viewData sözlüğü dinamik bir nesnedir, yani herhangi bir tür kullanılabilir; viewData 
nesnenin içine bir öğe yerleştirene kadar tanımlanmış özellikleri yok. MVC modeli bağlama sistemi , 
adlandırılmış parametreleri ( name ve numTimes ), adres çubuğundaki sorgu dizesinden yöntemdeki 
parametrelere otomatik olarak eşler. Tüm HelloWorldController.cs dosyası şuna benzer: 

using Microsoft.AspNetCore.Mvc; 
using System.Text.Encodings.Web; 

namespace MvcMovie.Controllers 
{ 

public class HelloWorldController : Controller 
{ 

public IActionResult Index() 

{ 

return View(); 

} 

public IActionResult Welcome(string name, int numTimes = 1) 

{ 

ViewData["Message"] = "Hello " + name; 

ViewData["NumTimes"] = numTimes; 

return View(); 

} 

} 

} 

viewData Dictionary nesnesi görünüme geçirilecek verileri içerir. 

Görünümler/HelloWorld/Welcome. cshtmladU bir hoş geldiniz görünüm şablonu oluşturun. 

Welcome. cshtml görünüm şablonunda "Hello" NumTimes görüntüleyen bir döngü oluşturacaksınız. 
Views/HelloWorld/Welcome. cshtml içeriğini aşağıdakiler ile değiştirin: 

ViewData["Title"] = "Welcome"; 

} 

<h2>Welcome</h2> 

<ul> 

@for (int i = 0; i < (int)ViewData["NumTimes"]; i++) 

{ 

<li>@ViewData["Message"]</li> 

} 

</ul> 

Değişikliklerinizi kaydedin ve aşağıdaki URL 'ye gidin: 
https://localhost:{P0RT}/HelloWorld/Welcome?name=Rick&numtimes=4 

Veriler URL 'den alınır ve MVC model Bağlayıcısı kullanılarak denetleyiciye geçirilir. Denetleyici, verileri bir 
viewData sözlüğüne paketler ve bu nesneyi görünüme geçirir. Daha sonra Görünüm, verileri tarayıcıda 
HTML olarak işler. 



















Yukarıdaki örnekte viewData sözlüğü denetleyiciden bir görünüme veri geçirmek için kullanılmıştır. 
Öğreticide daha sonra bir görünüm modeli, bir denetleyicideki verileri bir görünüme geçirmek için kullanılır. 
Veri geçirme yaklaşımına yönelik görünüm modeli, viewData sözlük yaklaşımına göre genel olarak çok tercih 
edilir. Daha fazla bilgi için bkz. VievvBag, VievvData veya TempData kullanma . 

Sonraki öğreticide, bir film veritabanı oluşturulur. 


ÖNCEKİ ■ İLERİ 














ASRNET Core MVC uygulamasına model ekleme 

23.11.2019 * 43 minutes to read ı Edit Online 


Rick Anderson ve Tom Dykstra tarafından 

Bu bölümde, bir veritabanında film yönetmeye yönelik sınıflar eklersiniz. Bu sınıflar,dVC uygulamasının 
"dodel" parçası olacaktır. 

Bu sınıfları bir veritabanıyla çalışmak için Entity Framevvork Core (EF Core) ile birlikte kullanırsınız. EF Core, 
yazmanız gereken veri erişim kodunu kolaylaştıran bir nesne ilişkisel eşleme (ORM) çerçevesidir. 

Oluşturduğunuz model sınıfları, EF Core hiçbir bağımlılığı olmadığından, POCO sınıfları olarak bilinir ( PLain 
O). Yalnızca veritabanında depolanacak verilerin özelliklerini tanımlar. 

Bu öğreticide, önce model sınıflarını yazdığınızda EF Core veritabanını oluşturur. Burada kapsanmayan 
alternatif bir yaklaşım var olan bir veritabanından model sınıfları oluşturmaktır. Bu yaklaşım hakkında daha 
fazla bilgi için bkz. ASP.NET Core-var olan veritabanı. 

Veri modeli sınıfı ekleme 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

> sınıf eklemek > modeller klasörüne sağ tıklayın. Dosyayı Mov/e.csolarak adlandırın. 

Movie.cs dosyasını aşağıdaki kodla güncelleştirin: 

using System; 

using System.ComponentModel.DataAnnotations; 

namespace MvcMovie.Models 
{ 

public class Movie 
{ 

public int Id { get; set; } 
public string Title { get; set; } 

[DataType(DataType.Date)] 
public DateTime ReleaseDate { get; set; } 
public string Genre { get; set; } 
public decimal Price { get; set; } 

} 

} 

novie sınıfı, birincil anahtar için veritabanı için gerekli olan bir id alanı içerir. 

ReleaseDate veri türü özniteliği, verilerin türünü belirtir ( Date ). Bu öznitelikle: 

• Kullanıcının Tarih alanına saat bilgilerini girmesi gerekli değildir. 

• Zaman bilgisi değil yalnızca tarih görüntülenir. 

Veri açıklamaları sonraki bir öğreticide ele alınmıştır. 


NuGet paketleri Ekle 







• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 


Araçlar menüsünde NuGet Paket Yöneticisi > Paket Yöneticisi konsolu (PMC) öğesini seçin. 


j MvcMovie - Microsoft Visual Studio 
File Edit View Project Build Debug 
( E Extensions and Updates... 

T g Connectto Database... 

T E Connectto Server... 

Add SQL Server... 


Team Tools 


WCF Service Configuration Editör 
External Tools... 

Import and Export Settings... 
Customize... 

Options... 


Analyze Window Help 
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SQL Server 

► 

Web Code Analysis 

► 

Code Snippets Manager... 

Ctrl+K, Ctrl+B 

Choose Toolbox Items... 

NuGet Package Manager 

► 



PMC 'de şu komutu çalıştırın: 

Install-Package Microsoft.EntityFrameworkCore.SqlServer 

Yukarıdaki komut, EF Core SQL Server sağlayıcısını ekler.Sağlayıcı paketi, EF Core paketini bir bağımlılık 
olarak yüklüyor. Ek paketler, öğreticinin sonraki bölümlerinde bulunan yapı iskelesi adımında otomatik olarak 
yüklenir. 

Veritabanı bağlamı sınıfı oluşturma 

Movie modeli için EF Core işlevselliği (oluşturma, okuma, güncelleştirme, silme) koordine etmek için bir 
veritabanı bağlamı sınıfı gerekir. Veritabanı bağlamı Microsoft. EntityFramevvorkCore. DbContext öğesinden 
türetilir ve veri modeline dahil edilecek varlıkları belirtir. 

Bir veri klasörü oluşturun. 

Aşağıdaki kodla bir Data/MvcMovieContext. cs dosyası ekleyin: 

using Microsoft.EntityFrameworkCore; 
using MvcMovie.Models; 

namespace MvcMovie.Data 
{ 

public class MvcMovieContext : DbContext 
{ 

public MvcMovieContext (DbContextOptions<MvcMovieContext> options) 

: base(options) 

{ 

} 

public DbSet<Movie> Movie { get; set; } 

} 

} 

Önceki kod, varlık kümesi için bir Dbset<filmi > özelliği oluşturur. Entity Framevvork terminolojisinde, bir varlık 







kümesini genellikle bir veritabanı tablosuna karşılık gelir. Bir varlık tablosunda bir satıra karşılık gelir. 

Veritabanı bağlamı Kaydet 

ASP.NET Core, bağımlılık ekleme (dı)ile oluşturulmuştur. Hizmetlerin (EF Core DB bağlamı gibi) uygulama 
başlatma sırasında Dİ ile kayıtlı olması gerekir. Bu hizmetler (örneğin, Razor sayfaları) gerektiren bileşenler bu 
hizmetler Oluşturucu parametresi üzerinden sağlanır. Bir DB bağlamı örneği alır Oluşturucu kodu öğreticinin 
ilerleyen bölümlerinde gösterilmektedir. Bu bölümde, veritabanı bağlamını dı kapsayıcısına kaydedersiniz. 



• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 


public void ConfigureServices(IServiceCollection Services) 
{ 

Services.AddControllersWithViews(); 


} 


Services.AddDbContext<MvcMovieContext>(options => 

options.UseSqlServer(Configuration.GetConnectionString("MvcMovieContext"))); 


Bağlantı dizesi adı için bağlam üzerinde bir yöntemi çağırarak geçirilen bir DbContextOptions nesne. Yerel 
geliştirme için ASP.NET Core yapılandırma sistemi bağlantı dizesinden okur appsettings.json dosya. 


Veritabanı bağlantı dizesi Ekle 

AppSettings. JSON dosyasına bir bağlantı dizesi ekleyin: 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 


{ 

"Logging": { 

"LogLevel": { 

"Default": "Information", 

"Microsoft": "Warning", 

"Microsoft.Hoşting.Lifetime": "Information" 

} 

}, 

"AllowedHosts": 

"ConnectionStrings": { 

"MvcMovieContext": "Server=(localdb)\\mssqllocaldbjDatabase=MvcMovieContext- 
l;Trusted_Connection=True;MultipleActiveResultSets=true" 

} 


Projeyi derleyici hatalarına yönelik bir denetim olarak derleyin. 

Yapı iskelesi film sayfaları 


Film modeli için oluşturma, okuma, güncelleştirme ve silme (CRUD) sayfaları üretmek için scafkatlama aracını 






kullanın. 


• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 
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Yapı Ekle iletişim kutusunda, Entity Framevvork > Ekle ‘ yi kullanarak vievvs ile MVC denetleyicisi ' ni 

seçin. 



Denetleyici Ekle iletişim kutusunu doldurun: 


• Model sınıfı: Film (mvcmovie. modeller) 






















• Veri bağlamı sınıfı: mvcmovlecontext (mvcmovie. Data) 


Add MVC Controller with views, using Entity Framework 


X 


Model class: 

Data context class: 
Views: 


Movie (MvcMovie.Models) 


m 


Add Data Context 


New data context type: MvcMovieJ^^.MvcMovieContext 


Add 


X 


Cancel 


Controller name: MoviesController 


Add 


Cancel 


• Görünümler: Her seçeneğin varsayılan kısmını işaretli tut 

• Denetleyici adı: Varsayılan MoviesController tat 

• Ekle 'yi seçin 

Visual Studio şunları oluşturur: 

• Bir filmler denetleyicisi [denetleyiciler/MoviesController. cs) 

• Razor oluşturma, silme, ayrıntılar, düzenleme ve dizin sayfaları için dosyaları görüntüleme 
(' Görünümler/filmler/*. cshtml) 

Bu dosyaların otomatik olarak oluşturulması, Yapı /ske/es/olarak bilinir. 

Veritabanı mevcut olmadığından, scafkatmış sayfaları henüz kullanamazsınız. Uygulamayı çalıştırır ve film 
uygulaması bağlantısına tıklarsanız, bir veritabanı açılamıyor veya böyle bir tablo yok: film hata iletisi. 

İlk geçiş 

Veritabanını oluşturmak için EF Core geçişleri özelliğini kullanın. Geçişler, veri modelinizle eşleşecek bir 
veritabanı oluşturmanıza ve güncelleştirmenize olanak sağlayan bir araç kümesidir. 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

Araçlar menüsünde NuGet Paket Yöneticisi > Paket Yöneticisi konsolu (PMC) öğesini seçin. 

PMC'de aşağıdaki komutları girin: 

Add-Migration InitialCreate 
Update-Database 

• Add-Migration InitialCreate : bir geçişler/ftimestamp}_lnitialCreate. cs geçiş dosyası oluşturuyor. 
InitialCreate bağımsız değişkeni geçiş adıdır. Herhangi bir ad kullanılabilir, ancak kurala göre, geçişi 

açıklayan bir ad seçilidir. Bu ilk geçiş olduğundan, oluşturulan sınıf veritabanı şemasını oluşturmak için 
kod içerir. Veritabanı şeması, MvcMovieContext sınıfında belirtilen modeli temel alır. 






























• update-Database : veritabanını, önceki komutun oluşturulduğu en son geçişe güncelleştirir. Bu komut, 
veritabanını oluşturan geçişler/{Time-damga} JnitialCreate. cs dosyasında up yöntemini çalıştırır. 

Database Update komutu aşağıdaki uyarıyı üretir: 

' Movie 1 varlık türündeki 1 Price ' ondalık sütunu için tür belirtilmedi. Bu, varsayılan duyarlık ve 
ölçeğe uygun olmadıkları takdirde değerlerin sessizce kesilmesine neden olur.' Hasccolumntype () 1 
kullanarak tüm değerleri barındırabilecek SQL Server sütun türünü açıkça belirtin. 


Bu uyarıyı yoksayabilirsiniz, daha sonraki bir öğreticide düzeltilecektir. 

EF Core için PMC araçları hakkında daha fazla bilgi için bkz. Visual Studio 'da EF Core araçları başvurusu- 
PMC. 

Initialcreate sınıfı 

Geçişleri/ftimestamp}_lnitialCreate. cs geçiş dosyasını inceleyin: 

public partial class Initial : Migration 

{ 

protected override void Up(MigrationBuilder migrationBuilder) 

{ 

migrationBuilder.CreateTable( 
name: "Movie", 
columns: table => new 
{ 

Id = table.Column<int>(nullable: false) 

.Annotation("SqlServer:ValueGenerationStrategy", 

SqlServerValueGenerationStrategy.IdentityColumn), 

Title = table.Column<string>(nullable: true), 

ReleaseDate = table.Column<DateTime>(nullable: false), 

Genre = table.Column<string>(nullable: true), 

Price = table.Column<decimal>(nullable: false) 

L 

constraints: table => 

{ 

table.PrimaryKey("PK_Movie", x => x.Id); 

}); 

} 

protected override void Down(MigrationBuilder migrationBuilder) 

{ 

migrationBuilder.DropTable( 
name: "Movie"); 

} 

} 

up yöntemi, film tablosunu oluşturur ve id birincil anahtar olarak yapılandırır. Down yöntemi, up geçişi 
tarafından yapılan şema değişikliklerini geri alır. 

Uygulamayı test etme 

• Uygulamayı çalıştırın ve film uygulaması bağlantısına tıklayın. 

Aşağıdakilerden birine benzer bir özel durum alırsanız: 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 


SqlException: Cannot öpen database "MvcMovieContext-l" requested by the login. The login failed. 







Muhtemelen geçişler adımınıkaçırdınız. 


• Oluştur sayfasını test edin. Veri girin ve gönderebilirsiniz. 


NOTE 

Ondalık virgül kullanımı girmeniz mümkün olmayabilir Price alan. Desteklemek için jQuery doğrulama virgül 
İngilizce olmayan yerel bir ondalık noktasının ve ABD İngilizce olmayan tarih biçimleri, uygulamayı Eğer 
gerekir. Genelleştirme hakkında yönergeler için bkz. bu GitHub sorunu. 


• Düzenleme, Ayrıntılarve silme sayfalarını test edin. 

Denetleyiciye bağımlılık ekleme 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

Controllers/MoviesControUer. cs dosyasını açın ve oluşturucuyu inceleyin: 

public class MoviesController : Controller 
{ 

private readonly MvcMovieContext _context; 

public MoviesController(MvcMovieContext context) 

{ 

_context = context; 

} 

Oluşturucu, veritabanı bağlamını ( MvcMovieContext ) denetleyiciye eklemek için bağımlılık ekleme işlemini 
kullanır. Her bir veritabanı bağlamı kullanılan CRUD denetleyici yöntemleri. 

Türü kesin belirlenmiş modeller ve @model anahtar sözcüğü 

Bu öğreticide daha önce, bir denetleyicinin viewData sözlüğünü kullanarak bir görünüme nasıl veri veya nesne 
geçirekullanabileceğinizi gördünüz. viewData sözlüğü bir görünüme bilgi geçirmek için uygun, geç bağlanan 
bir yol sağlayan dinamik bir nesnedir. 

MVC Ayrıca, kesin olarak belirlenmiş model nesnelerini bir görünüme geçirmeye olanak tanır. Bu kesin türü 
belirtilmiş yaklaşım derleme zamanı kodu denetimini sunar. Yapı iskelesi mekanizması, MovlesControiler sınıfı 
ve görünümleriyle bu yaklaşımı (türü kesin belirlenmiş bir modeli geçirerek) kullandı. 

Controllers/MoviesControUer. cs dosyasında oluşturulan Details yöntemini inceleyin: 














// GET: Movies/Details/5 

public async Task<IActionResult> Details(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var movie = await _context.Movie 

.FirstOrDefaultAsync(m => m.Id == id); 
if (movie == null) 

{ 

return NotFound(); 

} 

return View(movie); 

} 

id parametresi genellikle rota verileri olarak geçirilir. Örneğin https://iocaihost:500i/movies/detaiis/ı 
kümeler: 

• movies denetleyicisine denetleyici (ilk URL segmenti). 

• details eylemi (ikinci URL segmenti). 

• Kimliği 1 ' e (son URL segmenti). 

Aşağıdaki gibi bir sorgu dizesiyle id de geçirebilirsiniz: 
https://localhost:5001/movies/details?id=l 

KİMLİK değeri sağlanmazsa id parametresi null yapılabilir bir tür ( int? ) olarak tanımlanır. 

Bir lambda ifadesi, rota verileriyle veya sorgu dizesi değeriyle eşleşen film varlıklarını seçmek üzere 
FirstOrDefaultAsync ' A geçirilir. 

var movie = await _context.Movie 

.FirstOrDefaultAsync(m => m.Id == id); 

Bir film bulunursa, Movie modelinin bir örneği Details görünümüne geçirilir: 

return View(movie); 


Görünümier/filmler/ayrmtdar. cshtml dosyasının içeriğini inceleyin: 










@model MvcMovie.Models.Movie 

@{ 

ViewData["Title"] = "Details"; 

} 

<hl>Details</hl> 

<div> 

<h4>Movie</h4> 

<hr /> 

<dl class="row"> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Title) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Title) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.ReleaseDate) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.ReleaseDate) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Genre) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Genre) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Price) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Price) 

</dd> 

</dl> 

</div> 

<div> 

<a asp-action="Edit" asp-route-id="@Model.Id">Edit</a> | 

<a asp-action="Index">Back to List</a> 

</div> 

Görünüm dosyasının en üstündeki @modei ifade, görünümün beklediği nesne türünü belirtir. Film denetleyicisi 
oluşturulduğunda, aşağıdaki @modei deyimleri eklenmiştir: 

@model MvcMovie.Models.Movie 

Bu @modei yönergesi, denetleyicinin görünüme geçirildiği filme erişimine izin verir. Model nesne kesin olarak 
belirlenmiş. Örneğin, details. cshtml görünümünde, kod her bir film alanını DisplayNameFor DisplayFor ve 
HTML yardımcılarını türü kesin belirlenmiş Model nesnesiyle geçirir, create ve Edit yöntemleri ve 
görünümleri bir Movie model nesnesi de iletir. 

Dizin, cshtml görünümünü ve film denetleyicisindeki index yöntemini inceleyin. List, view yöntemini 
çağırdığında kodun bir nesne nasıl oluşturduğunu fark edin. Kod, index eylem yönteminden bu Movies 
listesini görünüme geçirir: 




















// GET: Movies 

public async Task<IActionResult> Index() 

{ 

retunn View(await _context.Movie.Tol_istAsync()); 

} 

Film denetleyicisi oluşturulduğunda, yapı iskelesi lndex. cshtml dosyasının en üstüne aşağıdaki @modei 
ifadesini içeriyordu: 

@model IEnumerable<MvcMovie.Models.Movie> 

@modei yönergesi, kesin olarak belirlenmiş bir Model nesnesi kullanarak, denetleyicinin görünüme geçirildiği 
film listesine erişmenizi sağlar. Örneğin, lndex. cshtml görünümünde, kod kesin türü belirtilmiş Model nesnesi 
üzerinde foreach bir ifadesiyle filmlerle döngü yapılır: 








@model IEnumerable<MvcMovie.Models.Movie> 

@{ 

ViewData["Title"] = "Index"; 

} 

<hl>Index</hl> 

<P> 

<a asp-action="Create">Create New</a> 

</p> 

<table class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model => model.Title) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.ReleaseDate) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Genre) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Price) 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model) { 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.ReleaseDate) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Genre) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Price) 

</td> 

<td> 

<a asp-action="Edit" asp-route-id="@item.Id">Edit</a> | 

<a asp-action="Details" asp-route-id="@item.Id">Details</a> | 

<a asp-action="Delete" asp-route-id="@item.Id">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 


olarak yazılır. Diğer avantajların yanı sıra, kodu derleme zaman denetimini alacağınız anlamına gelir. 

Ek kaynaklar 


Model 

nesne kesin olarak yazıldığı için (bir 

IEnumerable<Movie> 

nesnesi olarak), döngüdeki her öğe 

Movie 


• Etiket Yardımcıları 

• Genelleştirme ve yerelleştirme 





ÖNCE BİR GORUN UM 
EKLEME 


I 


DAHA SONRA SQL İLE 
ÇALIŞM A 


Veri modeli sınıfı ekleme 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

> sınıf eklemek > modeller klasörüne sağ tıklayın. Sınıf adı film. 

Aşağıdaki özellikleri Movie sınıfı: 

using System; 

using System.ComponentModel.DataAnnotations; 

namespace MvcMovie.Models 
{ 

public class Movie 
{ 

public int Id { get; set; } 
public string Title { get; set; } 

[DataType(DataType.Date)] 
public DateTime ReleaseDate { get; set; } 
public string Genre { get; set; } 
public decimal Price { get; set; } 

} 

} 

Movie Sınıfı içerir: 

• id Alanı ve veritabanı için birincil anahtarı gereklidir. 

• [DataType(DataType.Date)] : DataType özniteliği veri türünü belirtir ( Date ). Bu öznitelik ile: 

o Kullanıcının tarih alanı saat bilgilerini girmek için gerekli değildir, 
o Yalnızca tarih görüntülenen, olmayan zaman bilgilerdir. 

DataAnnotations bir sonraki öğreticide ele alınmaktadır. 

Film modeli iskelesini 

Bu bölümde, film modeli iskele kurulmuş. Diğer bir deyişle, yapı iskelesi aracı sayfaları için oluşturma, okuma, 
güncelleştirme ve silme (CRUD) işlemlerine yönelik film modeli oluşturur. 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Çözüm Gezgini, denetleyiciler klasörüne sağ tıklayıp yeni > yapı iskelesi > öğesi ekleyin. 








Solution Explorer 

(îl ÖJ " T © - ıf tf) 

- 4 X 

” 

Search Solution Explorer (Ctrl-*-;) 

P- 

531 Solution 'MvcMovie' (1 project) 

A MvcMovie 

Connected Services 
t> .V Dependencies 

> o> Properties 

> @ wwwroot 



El 

Controller... 


*□ 

New Item... 

Ctrl+Shift+A 


Existing Item... 

Shift+Alt+A 


New Scaffolded Item... 


•a 

IMew Folder 



Application Insights Telemetry... 


İSr 

Docker Support 

Container Orchestrator Support 



Class... 




View in Browser (Microsoft Edge) 
Brovvse With... 


Ctrl+Shift+W 


Add 

► 

Scopeto This 


New Solution Explorer View 


View History... 

Exclude From Project 

Cut 

Ctrl+X 

c°py 

Ctrl+C 

Delete 

Del 

Rename 


Öpen Folder in File Explorer 

Properties 

Alt-*- Enter 


Yapı Ekle iletişim kutusunda, Entity Framevvork > Ekle ' yi kullanarak views ile MVC denetleyicisi ' ni 

seçin. 



Denetleyici Ekle iletişim kutusunu doldurun: 

• Model sınıfı: Film (mvcmovie. modeller) 

• Veri bağlamı sınıfı: + simgesini seçin ve varsayılan Mvcmovie. modeller. MvcMovieContext öğesini 
ekleyin 





















• Görünümler: Her seçeneğin varsayılan kısmını işaretli tut 

• Denetleyici adı: Varsayılan MoviesController tut 

• Ekle 'yi seçin 


Add Controller 

Model class: 

Data context class: 

Views: 

k/| Gerıerate views 
0 Reference script libraries 
0 Use a layout page: 


Movie (MvcMovie.Models) 


MvcMovie.Models.MvcMovieContext 


(Leave empty if it is set in a Razor_viewstartfile) 


Controller name: 


MoviesController 


Add 


X 


^ + 


□ 


Cancel 


Visual Studio şunları oluşturur: 

• Entity Framework Core veritabanı bağlam sınıfı ( Data/MvcMovieContext. cs) 

• Bir filmler denetleyicisi ( denetleyiciler/MoviesController. cs) 

• Razor oluşturma, silme, ayrıntılar, düzenleme ve dizin sayfaları için dosyaları görüntüleme 
( Görünümler/filmler/*. cshtml) 

Veritabanı bağlamı ve CRUD (oluşturma, okuma, güncelleştirme ve silme) eylem yöntemlerinin ve 
görünümlerinin otomatik olarak oluşturulması, Yapı /ske/es/olarak bilinir. 

Uygulamayı çalıştırır ve M VC filmi bağlantısına tıklarsanız aşağıdakine benzer bir hata alırsınız: 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 
































































An unhandled exception occurred while Processing the request. 

SqlException: Cannot öpen database "MvcMovieContext-<GUID removed>" requested by the login. The login 
failed. 

Login failed for user 'Rick'. 

System.Data.SqlClient.SqlInternalConnectionTds..ctor(DbConnectionPoolIdentity identity, 
SqlConnectionString 


Veritabanını oluşturmanız ve bunu yapmak için EF Core geçişleri özelliğini kullanmanız gerekir. Geçişler veri 
modelinize uyan bir veritabanı oluşturmanıza ve veri modeliniz değiştiğinde veritabanı şemasını 
güncelleştirmenize olanak tanır. 


İlk geçiş 

Bu bölümde, aşağıdaki görevler tamamlanır: 

• Bir başlangıç geçiş ekleyin. 

• Veritabanı, ilk geçiş ile güncelleştirin. 


• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 


1. Araçlar menüsünde NuGet Paket Yöneticisi > Paket Yöneticisi konsolu (PMC) öğesini seçin. 
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2. PMC'de aşağıdaki komutları girin: 

Add-Migration Initial 
Update-Database 

Add-Migration Komut, ilk veritabanı şeması oluşturmak için kod oluşturur. 

Veritabanı şeması, MvcMovieContext sınıfında belirtilen modeli temel alır. ınitial bağımsız değişkeni 
geçiş adıdır. Herhangi bir ad kullanılabilir, ancak kurala göre, geçişi açıklayan bir ad kullanılır.Daha fazla 
bilgi için bkz. Öğretici: EF Core ile geçiş özelliğini kullanma-ASP.NET MVC. 

update-Database Komutu çalıştırmaları up yöntemi geçişleri/{zaman damgası} JnitialCreate.es 
dosyasını veritabanı oluşturur. 







Bağımlılık ekleme ile kayıtlı bağlamını İnceleme 

ASP.NET Core, bağımlılık ekleme (dı)ile oluşturulmuştur. Hizmetler (EF Core DB bağlamı gibi) uygulama 
başlatma sırasında dı ile kaydedilir. Bu hizmetler (örneğin, Razor sayfaları) gerektiren bileşenler bu hizmetler 
Oluşturucu parametresi üzerinden sağlanır. Bir DB bağlamı örneği alır Oluşturucu kodu öğreticinin ilerleyen 
bölümlerinde gösterilmektedir. 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

Scafkatlama aracı otomatik olarak bir DB bağlamı oluşturup dı kapsayıcısına kaydetti. 

Aşağıdaki startup.configureServices yöntemini inceleyin. Vurgulanan satırı iskele kurucu tarafından eklendi: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

// This lambda determines whether user consent for non-essential cookies 
// is needed for a given request. 
options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

Services.AddDbContext<MvcMovieContext>(options => 

options.UseSqlServer(Configuration.GetConnectionString("MvcMovieContext"))); 

} 

MvcMovieContext EF Core işlevleri (oluşturma, okuma, güncelleştirme, silme, vb.) için koordinatları Movie 
modeli. Veri bağlamı ( MvcMovieContext ) türetilir Microsoft.EntityFrameworkCore.DbContext. Veri bağlamı, veri 
modeline hangi varlıkların ekleneceğini belirtir: 

// Unused usings removed. 

using Microsoft.EntityFrameworkCore; 

using MvcMovie.Models; // Enables public DbSet<Movie> Movie 

namespace MvcMovie.Data 
{ 

public class MvcMovieContext : DbContext 
{ 

public MvcMovieContext (DbContextOptions<MvcMovieContext> options) 

: base(options) 

{ 

} 

public DbSet<Movie> Movie { get; set; } 

} 

} 

Önceki kod, varlık kümesi için bir Dbset<filmi > özelliği oluşturur. Entity Framevvork terminolojisinde, bir varlık 
kümesini genellikle bir veritabanı tablosuna karşılık gelir. Bir varlık tablosunda bir satıra karşılık gelir. 

Bağlantı dizesi adı için bağlam üzerinde bir yöntemi çağırarak geçirilen bir DbContextOptions nesne. Yerel 
geliştirme için ASP.NET Core yapılandırma sistemi bağlantı dizesinden okur appsettings.json dosya. 

Uygulamayı test etme 

• Uygulamayı çalıştırın ve ekleme /Movies tarayıcıda URL'sine ( http://iocaihost:port/movies ). 







Aşağıdakine benzer bir veritabanı özel durumu alırsanız: 


SqlException: Cannot öpen database "MvcMovieContext-GUID" requested by the login. The login failed. 
Login failed for user 'User-name'. 


Eksik geçişler adım. 

• Test Oluştur bağlantı. Veri girin ve gönderebilirsiniz. 

NOTE 

Ondalık virgül kullanımı girmeniz mümkün olmayabilir Price alan. Desteklemek için jQuery doğrulama virgül 
İngilizce olmayan yerel bir ondalık noktasının ve ABD İngilizce olmayan tarih biçimleri, uygulamayı Eğer 
gerekir. Genelleştirme hakkında yönergeler için bkz. bu GitHub sorunu. 


• Test Düzenle, ayrıntıları, ve Sil bağlantıları, 
startup sınıfını inceleyin: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

// This lambda determines whether user consent for non-essential cookies 
// is needed for a given request. 
options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 


Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

Services.AddDbContext<MvcMovieContext>(options => 

options.UseSqlServer(Configuration.GetConnectionString("MvcMovieContext"))); 

} 

Önceki vurgulanan kod, bağımlılık ekleme kapsayıcısına eklenen film veritabanı bağlamını gösterir: 

• Services.AddDbContext<MvcMovieContext>(options => kullanılacak veritabanını ve bağlantı dizesini belirtir. 

• => lambda operatörü 

Controllers/MoviesControUer. cs dosyasını açın ve oluşturucuyu inceleyin: 

public class MoviesController : Controller 

{ 

private readonly MvcMovieContext _context; 

public MoviesController(MvcMovieContext context) 

{ 

_context = context; 

} 

Oluşturucu, veritabanı bağlamını ( MvcMovieContext ) denetleyiciye eklemek için bağımlılık ekleme işlemini 
kullanır. Her bir veritabanı bağlamı kullanılan CRUD denetleyici yöntemleri. 

Türü kesin belirlenmiş modeller ve @model anahtar sözcüğü 


Bu öğreticide daha önce, bir denetleyicinin viewData sözlüğünü kullanarak bir görünüme nasıl veri veya nesne 








geçirekullanabileceğinizi gördünüz. viewData sözlüğü bir görünüme bilgi geçirmek için uygun, geç bağlanan 
bir yol sağlayan dinamik bir nesnedir. 

MVC Ayrıca, kesin olarak belirlenmiş model nesnelerini bir görünüme geçirmeye olanak tanır. Bu kesin türü 
belirtilmiş yaklaşım, kodunuzun daha iyi derleme zaman denetimini sunar. Yapı iskelesi mekanizması, yöntem 
ve görünümleri oluştururken MoviesControiler sınıfı ve görünümleriyle bu yaklaşımı (türü kesin belirlenmiş 
bir model geçirme) kullanır. 

Controllers/MoviesControUer. cs dosyasında oluşturulan Details yöntemini inceleyin: 

// GET: Movies/Details/5 

public async Task<IActionResult> Details(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var movie = await _context.Movie 

.FirstOrDefaultAsync(m => m.Id == id); 
if (movie == null) 

{ 

return NotFound(); 

} 

return View(movie); 

} 

id parametresi genellikle rota verileri olarak geçirilir. Örneğin https://iocaihost:500i/movies/detaiis/ı 
kümeler: 


• movies denetleyicisine denetleyici (ilk URL segmenti). 

• details eylemi (ikinci URL segmenti). 

• Kimliği 1 1 e (son URL segmenti). 

Aşağıdaki gibi bir sorgu dizesiyle id de geçirebilirsiniz: 


https://localhost:5001/movies/details?id=l 


KİMLİK değeri sağlanmazsa id parametresi null yapılabilir bir tür ( int? ) olarak tanımlanır. 

Bir lambda ifadesi, rota verileriyle veya sorgu dizesi değeriyle eşleşen film varlıklarını seçmek üzere 
FirstOrDefaultAsync ' A geçirilir. 

var movie = await _context.Movie 

.FirstOrDefaultAsync(m => m.Id == id); 

Bir film bulunursa, Movie modelinin bir örneği Details görünümüne geçirilir: 

return View(movie); 


Görünümier/filmler/ayrmtdar. cshtml dosyasının içeriğini inceleyin: 


















@model MvcMovie.Models.Movie 

@{ 

ViewData["Title"] = "Details"; 

} 

<hl>Details</hl> 

<div> 

<h4>Movie</h4> 

<hr /> 

<dl class="row"> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Title) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Title) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.ReleaseDate) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.ReleaseDate) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Genre) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Genre) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Price) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Price) 

</dd> 

</dl> 

</div> 

<div> 

<a asp-action="Edit" asp-route-id="@Model.Id">Edit</a> | 

<a asp-action="Index">Back to List</a> 

</div> 

Görünüm dosyasının üst kısmına bir @modei ifadesini ekleyerek, görünümün beklediği nesne türünü 
belirtebilirsiniz. Film denetleyicisini oluştururken, Ayrıntılar, cshtml dosyasının en üstüne aşağıdaki @modei 
deyimleri otomatik olarak eklenmiştir: 

@model MvcMovie.Models.Movie 

Bu @modei yönergesi, kesin olarak belirlenmiş bir Model nesnesi kullanarak denetleyicinin görünüme 
geçirildiği filme erişmenizi sağlar. Örneğin, details. cshtml görünümünde, kod her bir film alanını 


DisplayNameFor 

DisplayFor 

ve HTML yardımcılarını türü kesin belirlenmiş 

Model 

nesnesiyle geçirir. 

Create 


ve Edit yöntemleri ve görünümleri bir Movie model nesnesi de iletir. 


Dizin, cshtml görünümünü ve film denetleyicisindeki index yöntemini inceleyin. List, view yöntemini 
çağırdığında kodun bir nesne nasıl oluşturduğunu fark edin. Kod, index eylem yönteminden bu Movies 
listesini görünüme geçirir: 























// GET: Movies 

public async Task<IActionResult> Index() 

{ 

retunn View(await _context.Movie.Tol_istAsync()); 

} 


Film denetleyicisini oluştururken, yapı iskelesi lndex. cshtml dosyasının en üstüne aşağıdaki 

otomatik olarak dahil edin: 

(Şmodel 

ifadesini 

@model IEnumerable<MvcMovie.Models.Movie> 


@modei yönergesi, kesin olarak belirlenmiş bir Model nesnesi kullanarak, denetleyicinin görünüme geçirildiği 
film listesine erişmenizi sağlar. Örneğin, lndex. cshtml görünümünde, kod kesin türü belirtilmiş Model nesnesi 
üzerinde foreach bir ifadesiyle filmlerle döngü yapılır: 








@model IEnumerable<MvcMovie.Models.Movie> 

@{ 

ViewData["Title"] = "Index"; 

} 

<hl>Index</hl> 

<P> 

<a asp-action="Create">Create New</a> 

</p> 

<table class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model => model.Title) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.ReleaseDate) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Genre) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Price) 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model) { 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.ReleaseDate) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Genre) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Price) 

</td> 

<td> 

<a asp-action="Edit" asp-route-id="@item.Id">Edit</a> | 

<a asp-action="Details" asp-route-id="@item.Id">Details</a> | 

<a asp-action="Delete" asp-route-id="@item.Id">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 


olarak yazılır. Diğer avantajların yanı sıra, kodun derleme zaman denetimini alacağınız anlamına gelir: 

Ek kaynaklar 


Model 

nesne kesin olarak yazıldığı için (bir 

IEnumerable<Movie> 

nesnesi olarak), döngüdeki her öğe 

Movie 


• Etiket Yardımcıları 

• Genelleştirme ve yerelleştirme 




Daha 
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ASRNET Core 'de SQL ile çalışma 
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Tarafından RickAnderson 

MvcMovieContext nesnesi veritabanına bağlanma ve Movie nesneleri veritabanı kayıtlarına eşleme görevini işler. 
Veritabanı bağlamı, Startup.es dosyasındaki configureServices yönteminde bağımlılık ekleme kapsayıcısına 
kaydedilir: 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 


public void ConfigureServices(IServiceCollection Services) 
{ 

Services.AddControllersWithViews(); 


} 


Services.AddDbContext<MvcMovieContext>(options => 

options.UseSqlServer(Configuration.GetConnectionString("MvcMovieContext"))); 


AS P.N ET Core yapılandırma sistemi Connectionstring okur. Yerel geliştirme için, appSettirıgs. JSON 
dosyasından bağlantı dizesini alır: 


"ConnectionStrings": { 

"MvcMovieContext": "Server=(localdb)\\mssqllocaldbjDatabase=MvcMovieContext- 
2;Trusted_Connection=True;MultipleActiveResultSets=true" 

} 


Uygulama bir test veya üretim sunucusuna dağıtıldığında, bağlantı dizesini bir üretim SQL Server ayarlamak 
için bir ortam değişkeni kullanılabilir. Daha fazla bilgi için bkz. yapılandırma . 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 


SQL Server Express LocalDB 

LocalDB, program geliştirmeye yönelik SQL Server Express veritabanı altyapısının hafif bir sürümüdür. 
LocalDB, isteğe bağlı olarak başlar ve karmaşık yapılandırma olduğundan kullanıcı modunda çalışır.Varsayılan 
olarak, LocalDB veritabanı C:/Users/{User} dizininde, mdf dosyaları oluşturur. 


• Görünüm menüsünden SQL Server Nesne Gezgini (ssox) öğesini açın. 
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Movie tablo > görünüm tasarımcısına sağ tıklayın 


SQL Server Object Explorer ’ f X 

6 I *i ü 

A B* SQL Server 
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^ a Databases 

> M System Databases 
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l> K Exterrıal Tables 

t> ffl dbo._EFMİgratior 


[eİe! dbo.Movie 
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dbo.Movie [Design] -o x| 

♦ Update i Script File: dbo.Movie.sql 

Name Data Type 


İD 

Gen re 
Price 

ReleaseDate 

Title 


int 

nvarchar(MAX) 

decimal(18,2) 

datetime2(7) 

nvarchar(MAX) 


Allow Nulls 

□ 

0 

□ 

□ 

0 

□ 


Keys (1) 

PK_Movie (Primary Key, Clustered: I 

Check Constraints (0) 
lndexes (9) 

Foreign Keys (0) 

Triggers (0) 


CJ Design 

1 

2 

3 

4 

5 

6 

7 

8 
9 

100 % 


ti S T-SQL __ 

CREATE TABLE [dbo].[Movie] ( 

[ID] INT IDENTITY (1, 1) NOT NULL, 

[Genre] NVARCHAR (MAX) NULL, 

[Price] DECIMAL (18, 2) NOT NULL, 

[ReleaseDate] DATETIME2 (7) NOT NULL, 

[Title] NVARCHAR (MAX) NULL, 

CONSTRAINT [PK_Movie] PRİMARY KEY CLUSTERED ([ID] ASC) 

); 


• i 


ması 


ijU Connection Ready 

(localdb)\MSSQLLocalDB 

REDMOND\riande 

aspnet5-MvcMovie-8f261... 


id yanındaki anahtar simgesine göz önünde edin. Varsayılan olarak, EF birincil anahtar id adlı bir özellik 
oluşturacak. 

• Movie tabloya sağ tıklayarak verileri görüntüleyin > 


SQL Seıver Object Explorer •» ş X 

6 + 1 % 

4 yİ SQL Server 

4 E (localdb)\MSSQLLocalDB (SOL! 

4 a Databases 

> ■ System Databases 

4 IH MvcMovieContext-20613 
4 û Tables 

t> 0 System Tables 

l> M Extemal Tables 

t> ffl dbo._EFMİgratior 


P Fiil dbo.Movie 























^ MvcMovİe-Microsoft V... ^ & Quick Launch (Ctrl+Q) fi - n X 

File Edit View Project Build Debug Team SQL Tools rick * ^ 

Architecture Test Analyze Window Help 


d* 


► IIS Express - fi _ & 1*1 - 


dbo.Movie [Data] -b X | 

û |[*İT I > I MaxRows: 1000 - | £T £T 



İD 

Genre 

Price 

ReleaseDate 

Title 

► 

1 

Comedy 

1.99 

11/18/201512:0... 

When Harry Me... 


2 

Comedy 

2.99 

1/11/201612:00... 

Ghost Busters IV 


3 

Comedy 

3.99 

12/11/201512:0... 

Ghost Busters 7 

• 

NULL 

NULL 

NULL 

NULL 

NULL 




O 


ST 


Error List Output Find Results 1 


3 Rows | Celi is Read Only Ln 1 Col 1 


Veritabanının çekirdeğini oluşturma 

Modeller klasöründe seedData adlı yeni bir sınıf oluşturun. Oluşturulan kodu aşağıdaki kodla değiştirin: 










using Microsoft.EntityFrameworkCore; 

using Microsoft. Extensions.Dependencylnjection; 

using MvcMovie.Data; 

using System; 

using System.Linq; 

namespace MvcMovie.Models 

{ 

public static class SeedData 

{ 

public static void Initialize(IServiceProvider serviceProvider) 

{ 

using (var context = new MvcMovieContext( 
serviceProvider.GetRequiredService< 

DbContextOptions<MvcMovieContext>>())) 

{ 

// Look for any movies. 
if (context.Movie.Any()) 

{ 

return; // DB has been seeded 

} 

context.Movie.AddRange( 
new Movie 
{ 

Title = "When Harry Met Sally", 

ReleaseDate = DateTime.Parse("1989-2-12"), 

Genre = "Romantic Comedy", 

Price = 7.99M 

L 

new Movie 

{ 

Title = "Ghostbusters ", 

ReleaseDate = DateTime.Parse("1984-3-13"), 

Genre = "Comedy", 

Price = 8.99M 

}, 

new Movie 

{ 

Title = "Ghostbusters 2", 

ReleaseDate = DateTime.Parse("1986-2-23"), 

Genre = "Comedy", 

Price = 9.99M 

L 

new Movie 

{ 

Title = "Rio Bravo", 

ReleaseDate = DateTime.Parse("1959-4-15"), 

Genre = "Western", 

Price = 3.99M 

} 

); 

context.SaveChanges(); 

} 

} 

} 

} 


VERITABANıN DA herhangi bir film varsa, tohum başlatıcısı döner ve hiçbir film eklenmez. 



if (context.Movie.Any()) 

{ 

return; // DB has been seeded. 

} 


Tohum başlatıcısı ekleme 

Program.es içeriğini aşağıdaki kodla değiştirin: 

using Microsoft.AspNetCore.Hoşting; 

using Microsoft. Extensions.Dependencylnjection; 

using Microsoft. Extensions .Hoşting; 

using Microsoft. Extensions. Logging; 

using MvcMovie.Data; 

using MvcMovie.Models; 

using System; 

namespace MvcMovie 
{ 

public elass Program 
{ 

public static void Main(string[] args) 

{ 

var hoşt = CreateHostBuilder(args).Build(); 

using (var scope = hoşt.Services.CreateScope()) 

{ 

var Services = scope.ServiceProvider; 

try 

{ 

SeedData.Initialize(Services); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<ILogger<Program>>(); 
logger.LogError(ex, "An error occurred seeding the DB."); 

} 

} 

host.Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

h/ebBuilder .UseSt art up< Start up>(); 

}); 

} 

} 


Uygulamayı test etme 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

• VERITABANıN DAKI tüm kayıtları silin. Bunu, tarayıcıda veya SSOX 'ten silme bağlantılarıyla 
yapabilirsiniz. 

• Çekirdek yöntemin çalışması için uygulamayı başlamaya zorlayın ( startup sınıfında yöntemleri çağırın). 
Başlatmayı zorlamak için IIS Express durdurulup yeniden başlatılması gerekir. Bunu aşağıdaki 




yaklaşımlardan biriyle yapabilirsiniz: 


o Bildirim alanında IIS Express sistem tepsisi simgesine sağ tıklayın ve Çıkış veya siteyi durdur 1 a 
dokunun 





1 


View S it es 
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http://localhost1234/ 

MvcMovie ► 
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Exit 

Stop Site 

_ 

Mi... MvcMovie... £ 

|cT| C\Window... O /N fl 

□ 



o VS hata ayıklama modunda çalıştırıyorsanız, hata ayıklama modunda çalıştırmak için F5 'e 
basın 

o VS hata ayıklama modunda çalıştırıyorsanız, hata ayıklayıcıyı durdurun ve F5 tuşuna basın. 
Uygulama, sağlanan verileri gösterir. 
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Tarafından Rick Anderson 


MvcMovieContext nesnesi veritabanına bağlanma ve Movie nesneleri veritabanı kayıtlarına eşleme görevini işler. 
Veritabanı bağlamı, Startup.es dosyasındaki configureServices yönteminde bağımlılık ekleme kapsayıcısına 
kaydedilir: 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

// This lambda determines whether user consent for non-essential cookies 
// is needed for a given request. 
options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.None; 

})J 


Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

Services.AddDbContext<MvcMovieContext>(options => 

options.UseSqlServer(Configuration.GetConnectionString("MvcMovieContext"))); 

} 

AS P.N ET Core yapılandırma sistemi Connectionstring okur. Yerel geliştirme için, appSettings. JSON 
dosyasından bağlantı dizesini alır: 

"ConnectionStrings": { 

"MvcMovieContext": "Server=(localdb)\\mssqllocaldbjDatabase=MvcMovieContext- 
2;Trusted_Connection=True;MultipleActiveResultSets=true" 

} 


Uygulamayı bir test veya üretim sunucusuna dağıtırken, bağlantı dizesini gerçek bir SQL Server ayarlamak için 
bir ortam değişkeni veya başka bir yaklaşım kullanabilirsiniz. Daha fazla bilgi için bkz. yapılandırma . 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

SQL Server Express LocalDB 

LocalDB, program geliştirmeye yönelik SQL Server Express veritabanı altyapısının hafif bir sürümüdür. 
LocalDB, isteğe bağlı olarak başlar ve karmaşık yapılandırma olduğundan kullanıcı modunda çalışır.Varsayılan 
olarak, LocalDB veritabanı C:/Users/{User} dizininde, mdf dosyaları oluşturur. 


• Görünüm menüsünden SQL Server Nesne Gezgini (ssox) öğesini açın. 
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Movie tablo > görünüm tasarımcısına sağ tıklayın 


SQL Server Object Explorer ’ f X 

6 I *i ü 

A B* SQL Server 

a Ş (localdb)\MSSQLLocalDB (SQL ! 
^ a Databases 

> M System Databases 
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a ö Tables 

t> 0 System Tables 

l> K Exterrıal Tables 
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dbo.Movie [Design] -o x| 

♦ Update i Script File: dbo.Movie.sql 

Name Data Type 


İD 

Gen re 
Price 

ReleaseDate 

Title 


int 

nvarchar(MAX) 

decimal(18,2) 

datetime2(7) 

nvarchar(MAX) 


Allow Nulls 

□ 

0 

□ 

□ 

0 

□ 


Keys (1) 

PK_Movie (Primary Key, Clustered: I 

Check Constraints (0) 
lndexes (9) 

Foreign Keys (0) 

Triggers (0) 


CJ Design 

1 

2 

3 

4 

5 

6 

7 

8 
9 

100 % 


ti S T-SQL __ 

CREATE TABLE [dbo].[Movie] ( 

[ID] INT IDENTITY (1, 1) NOT NULL, 

[Genre] NVARCHAR (MAX) NULL, 

[Price] DECIMAL (18, 2) NOT NULL, 

[ReleaseDate] DATETIME2 (7) NOT NULL, 

[Title] NVARCHAR (MAX) NULL, 

CONSTRAINT [PK_Movie] PRİMARY KEY CLUSTERED ([ID] ASC) 

); 


• i 


ması 


ijU Connection Ready 

(localdb)\MSSQLLocalDB 

REDMOND\riande 

aspnet5-MvcMovie-8f261... 


id yanındaki anahtar simgesine göz önünde edin. Varsayılan olarak, EF birincil anahtar id adlı bir özellik 
oluşturacak. 

• Movie tabloya sağ tıklayarak verileri görüntüleyin > 


SQL Seıver Object Explorer •» ş X 

6 + 1 % 

4 yİ SQL Server 

4 E (localdb)\MSSQLLocalDB (SOL! 

4 a Databases 

> ■ System Databases 

4 IH MvcMovieContext-20613 
4 û Tables 

t> 0 System Tables 

l> M Extemal Tables 

t> ffl dbo._EFMİgratior 


P Fiil dbo.Movie 
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Veritabanının çekirdeğini oluşturma 

Modeller klasöründe seedData adlı yeni bir sınıf oluşturun. Oluşturulan kodu aşağıdaki kodla değiştirin: 










using Microsoft.EntityFrameworkCore; 
using Microsoft. Extensions.Dependencylnjection; 
using System; 
using System.Linq; 

namespace MvcMovie.Models 

{ 

public static class SeedData 

{ 

public static void Initialize(IServiceProvider serviceProvider) 

{ 

using (var context = new MvcMovieContext( 
serviceProvider.GetRequiredService< 

DbContextOptions<MvcMovieContext>>())) 

{ 

// Look for any movies. 
if (context.Movie.Any()) 

{ 

return; // DB has been seeded 

} 

context.Movie.AddRange( 
new Movie 
{ 

Title = "When Harry Met Sally", 

ReleaseDate = DateTime.Parse("1989-2-12"), 

Genre = "Romantic Comedy", 

Price = 7.99M 

}, 

new Movie 

{ 

Title = "Ghostbusters ", 

ReleaseDate = DateTime.Parse("1984-3-13"), 

Genre = "Comedy", 

Price = 8.99M 

}, 

new Movie 

{ 

Title = "Ghostbusters 2", 

ReleaseDate = DateTime.Parse("1986-2-23"), 

Genre = "Comedy", 

Price = 9.99M 

}, 

new Movie 

{ 

Title = "Rio Bravo", 

ReleaseDate = DateTime.Parse("1959-4-15"), 

Genre = "Western", 

Price = 3.99M 

} 

); 

context.SaveChanges(); 

} 

} 

} 

} 


VERITABANıN DA herhangi bir film varsa, tohum başlatıcısı döner ve hiçbir film eklenmez. 



if (context.Movie.Any()) 

{ 

return; // DB has been seeded. 

} 


Tohum başlatıcısı ekleme 

Program.es içeriğini aşağıdaki kodla değiştirin: 


using Microsoft.AspNetCore; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft. Extensions.Dependencylnjection; 

using Microsoft. Extensions. Logging; 

using System; 

using Microsoft.EntityFrameworkCore; 
using MvcMovie.Models; 
using MvcMovie; 

namespace MvcMovie 
{ 

public elass Program 
{ 

public static void Main(string[] args) 

{ 

var hoşt = CreateWebHostBuilder(args).Build(); 

using (var scope = hoşt.Services.CreateScope()) 
{ 

var Services = scope.ServiceProvider; 


try 

{ 

var context = Services.GetRequiredService<MvcMovieContext>(); 
context.Database.Migrate(); 

SeedData.Initialize(Services); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<ILogger<Program>>(); 
logger.LogError(ex, "An error occurred seeding the DB."); 

} 


hoşt.Run(); 


} 


} 


public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 
WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>(); 


Uygulamayı test etme 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

• VERITABANıN DAKI tüm kayıtları silin. Bunu, tarayıcıda veya SSOX 'ten silme bağlantılarıyla 
yapabilirsiniz. 

• Çekirdek yöntemin çalışması için uygulamayı başlamaya zorlayın ( startup sınıfında yöntemleri çağırın). 
Başlatmayı zorlamak için IIS Express durdurulup yeniden başlatılması gerekir. Bunu aşağıdaki 
yaklaşımlardan biriyle yapabilirsiniz: 




o Bildirim alanında 11S Express sistem tepsisi simgesine sağ tıklayın ve Çıkış veya siteyi durdur ' a 
dokunun 




View Sites 

Browse Applications 

http://l o c a 1 h o st 1 234/ 

MvcMovie ► 

Show Ali Applications 

Stop Site 

Exit 

Mi... 00 MvcMovie... £ ^ 

|cT| C\Window... O ^ C 



o VS hata ayıklama modunda çalıştırıyorsanız, hata ayıklama modunda çalıştırmak için F5 'e 
basın 

o VS hata ayıklama modunda çalıştırıyorsanız, hata ayıklayıcıyı durdurun ve F5 tuşuna basın. 
Uygulama, sağlanan verileri gösterir. 
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Denetleyici metotları ve görünümleri ASPNET Core 
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Tarafından Rick Anderson 


Film uygulaması için iyi bir başlangıç sahibiz ancak sunu Örneğin, ideal olarak, değildir ReleaseDate iki 
kelimeye olmalıdır. 
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Açık Models/Movie.cs dosya ve aşağıda vurgulanan satırları ekleyin: 







using System; 

using System.ComponentModel.DataAnnotations; 
using System.ComponentModel.DataAnnotations.Schema; 

namespace MvcMovie.Models 

{ 

public class Movie 

{ 

public int Id { get; set; } 
public string Title { get; set; } 

[Display(Name = "Release Date")] 
[DataType(DataType.Date)] 
public DateTime ReleaseDate { get; set; } 
public string Genre { get; set; } 

[Column(TypeName = "decimal(18, 2)")] 
public decimal Price { get; set; } 

} 

} 


Biz karşılarız DataAnnotations sonraki öğreticide. Görüntüleme öznitelik adı (Bu durumda "ReleaseDate" yerine 
"yayın tarihi") bir alan için görüntülenecek öğeleri belirtir. DataType öznitelik alanında depolanan saat bilgilerini 
görüntülenmediğini şekilde (tarih), veri türünü belirtir. 


[Coiumn(TypeName = "decimai(i8, 2)")] Veri ek açıklama, Entity Framevvork Core doğru şekilde eşleyebilirsiniz 
biçimde gereklidir Price veritabanında para birimi. Daha fazla bilgi için veri türleri. 


Gözat Movies denetleyicisi ve fare işaretçisini tutun bir Düzenle hedef URL'ye görmek için bağlantıyı. 
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Düzenle, ayrıntıları, ve Sil bağlantıları Core MVC yer işareti etiketi Yardımcısı tarafından üretilen 
V İews/M o vies/ln dex. csh t m l d o sy a. 













<a asp-action="Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-action="Details" asp-route-id="@item.ID">Details</a> | 
<a asp-action="Delete" asp-route-id="@item.ID">Delete</a> 
</td> 

</tr> 


Etiket Yardımcıları, Razor dosyalarında HTML öğelerinin oluşturulmasına ve işlenmesine sunucu tarafı kodun 
katılmasını etkinleştir. Yukarıdaki kodda AnchorTagHelper dinamik olarak HTML oluşturan href denetleyici 
eylem yöntemi ve rota kimliğinden öznitelik değeri. Kullandığınız kaynağı görüntüle sık kullandığınız 
tarayıcıyı ya da kullanım oluşturulan biçimlendirme incelemek için geliştirici araçları. Oluşturulan HTML 
değerinin bir bölümü aşağıda gösterilmiştir: 

<td> 

<a href="/Movies/Edit/4"> Edit </a> | 

<a href="/Movies/Details/4"> Details </a> | 

<a href="/Movies/Delete/4"> Delete </a> 

</td> 


Biçim için geri çağırma yönlendirme kümesinde Startup.es dosyası: 

app.UseMvc(routes => 

{ 

routes.MapRoute( 

name: "default", 

template: "{controller=Home}/{action=Index}/{id?}"); 

}); 

ASP.NET Core çevirir https://iocaihost:5@0i/Movies/Edit/4 bir istek halinde Edit eylem yöntemi Movies 
denetleyicisi parametresiyle id 4. (Denetleyici olarak da bilinen eylem yöntemleri yöntemlerdir.) 

Etiket Yardımcıları AS P.N ET Core en popüler yeni özellikler biridir. Daha fazla bilgi için ek kaynaklar. 


Movies 

denetleyicisi ve iki inceleyin 

Edit 

eylem yöntemleri. Aşağıdaki kodda gösterildiği 

HTTP GET Edit 


film getirir ve tarafından oluşturulan düzenleme formu dolduran yöntemi Edit.cshtml Razor dosya. 

// GET: Movies/Edit/5 

public async Task<IActionResult> Edit(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var movie = await _context.Movie.FindAsync(id); 
if (movie == null) 

{ 

return NotFound(); 

} 

return View(movie); 

} 


Aşağıdaki kodda gösterildiği http post Edit gönderilen film değerleri işleyen yöntemi: 














// POST: Movies/Edit/5 

// To protect from overposting attacks, please enable the specific properties you want to bind to, for 
// more details see http://go.microsoft.com/fwlink/?LinkId=317598. 

[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Edit(int id, [Bind("ID,Title,ReleaseDate,Genre,Price")] Movie movie) 

{ 

if (id != movie.ID) 

{ 

return NotFound(); 

} 

if (ModelState.IsValid) 

{ 

try 

{ 

_context.Update(movie); 

await _context. SaveChangesAsync(); 

} 

catch (DbUpdateConcunrencyException) 

{ 

if (!MovieExists(movie.ID)) 

{ 

return NotFound(); 

} 

else 

{ 

throw; 

} 

} 

return RedirectToAction("Index"); 

} 

return View(movie); 

} 


// GET: Movies/Edit/5 

public async Task<IActionResult> Edit(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var movie = await _context.Movie.SingleOrDefaultAsync(m => m.ID == id); 
if (movie == null) 

{ 

return NotFound(); 

} 

return View(movie); 

} 

Aşağıdaki kodda gösterildiği http post Edit gönderilen film değerleri işleyen yöntemi: 




// POST: Movies/Edit/5 

// To protect from overposting attacks, please enable the specific properties you want to bind to, for 
// more details see http://go.microsoft.com/fwlink/?LinkId=317598. 

[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Edit(int id, [Bind("ID,Title,ReleaseDate,Genre,Price")] Movie movie) 

{ 

if (id != movie.ID) 

{ 

return NotFound(); 

} 

if (ModelState.IsValid) 

{ 

try 

{ 

_context.Update(movie); 

await _context.SaveChangesAsync(); 

} 

catch (DbUpdateConcunrencyException) 

{ 

if (!MovieExists(movie.ID)) 

{ 

retunn NotFound(); 

} 

else 

{ 

thnow; 

} 

} 

netunn RedinectToAction("Index"); 

} 

netunn View(movie); 

} 

[Bind] Özniteliktir karşı korumak için bir yol aşırı yayınlayarak. Özellikler yalnızca içermelidir [Bind] 
değiştirmek istediğiniz özniteliği. Daha fazla bilgi için denetleyicinizin atlayarak nakil korumak. VievvmodeNar 
atlayarak önlemek için alternatif bir yaklaşım sağlar. 


ikinci fark Edit eylem yöntemine öncesinde [HttpPost] özniteliği. 





[HttpPost] 

[ValidateAntiFongenyToken] 

public async Task<IActionResult> Edit(int idj [BindC'IDjTitlejReleaseDatejGennejPnice")] Movie movie) 

{ 

if (id != movie.ID) 

{ 

netunn NotFound(); 

} 

if (ModelState.IsValid) 

{ 

tny 

{ 

_context.Update(movie); 

await _context. SaveChangesAsync (); 

} 

catch (DbUpdateConcunrencyException) 

{ 

if (!MovieExists(movie.ID)) 

{ 

return NotFound(); 

} 

else 

{ 

throw; 

} 

} 

retunn RedirectToAction(nameof(Index)); 

} 

netunn View(movie); 



// POST: Movies/Edit/5 

// To protect from overposting attacks, please enable the specific properties you want to bind to, for 
// more details see http://go.microsoft.com/fwlink/?LinkId=317598. 

[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Edit(int id, [Bind("ID,Title,ReleaseDate,Genre,Price")] Movie movie) 

{ 

if (id != movie.ID) 

{ 

return NotFound(); 

} 

if (ModelState.IsValid) 

{ 

try 

{ 

_context.Update(movie); 

await _context.SaveChangesAsync(); 

} 

catch (DbllpdateConcurrencyException) 

{ 

if (!MovieExists(movie.ID)) 

{ 

return NotFound(); 

} 

else 

{ 

throw; 

} 

} 

netunn RedinectToAction("Index"); 

} 

netunn View(movie); 

} 

HttpPost Özniteliği belirtir bu Edit yöntemi çağrılacakyo/nizco için post istekleri. Geçerli olabilir [HttpGet] 
ilk özniteliği Düzenle yöntemi, ancak gerekli değildir çünkü [HttpGet] varsayılandır. 

ValidateAntiForgeryToken Özniteliktir için kullanılan istek sahteciliğini önleme ve düzenleme görünümü 
dosyasında oluşturulan bir sahteciliğe karşı koruma belirteci ile eşleştirilmiş ( V'ıevvs/Movies/Edit.cshtml ). 
Sahteciliğe karşı koruma belirteci ile düzenleme görünüm dosyası oluşturur Form etiketi Yardımcısı. 

<form asp-action="Edit"> 

Form etiketi Yardımcısı eşleşmelidir gizli bir sahteciliğe karşı koruma belirteci oluşturan 

[ValidateAntiForgeryToken] oluşturulan sahteciliğe karşı koruma belirtecine Edit denetleyici filmler yöntemi. 
Daha fazla bilgi için istek sahteciliğinden koruma. 

HttpGet Edit Yöntemi alır film id parametresini arar Entity Framework kullanarak filmi FindAsync yöntemi 
ve düzenleme görünümü seçili film döndürür. Bir filmi bulunamazsa NotFound (HTTP 404) döndürülür. 














// GET: Movies/Edit/5 

public async Task<IActionResult> Edit(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var movie = await _context.Movie.FindAsync(id); 
if (movie == null) 

{ 

return NotFound(); 

} 

return View(movie); 

} 

Yapı iskelesi sistem düzenleme görünümü oluşturduğunuzda, onu incelenirken Movie sınıfı ve işlemek için 
oluşturulan kodu <iabei> ve <input> sınıfın her bir özellik için öğeleri. Aşağıdaki örnek, Visual Studio yapı 
iskelesi sistem tarafından oluşturulan düzenleme görünümünü gösterir: 







@model MvcMovie.Models.Movie 

@{ 

ViewData["Title"] = "Edit"; 

} 

<hl>Edit</hl> 

<h4>Movie</h4> 
chr /> 

<div class="row"> 

<div class="col-md-4"> 

<form asp-action="Edit"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 
cinput type="hidden" asp-for="Id" /> 
cdiv class="form-group"> 

clabel asp-for="Title" class="control-label"x/label> 

<input asp-for="Title" class="form-control" /> 

<span asp-validation-fon="Title" class="text-danger"x/span> 

</div> 

cdiv class="form-group"> 

clabel asp-for="ReleaseDate" class="control-label"x/label> 

<input asp-for="ReleaseDate" class="form-control" /> 

<span asp-validation-for="ReleaseDate" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

clabel asp-for="Genre" class="control-label"x/label> 

cinput asp-for="Genre" class="form-control" /> 

cspan asp-validation-for="Genre" class="text-danger"x/span> 

</div> 

cdiv class="form-group"> 

clabel asp-for="Price" class="control-label"x/label> 
cinput asp-for="Price" class="form-control" /> 
cspan asp-validation-for="Price" class="text-danger">c/span> 
c/div> 

cdiv class="form-group"> 

cinput type="submit" value="Save" class="btn btn-primary" /> 
c/div> 
c/form> 
c/div> 
c/div> 

cdiv> 

ca asp-action="Index">Back to Listc/a> 
c/div> 

@section Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 

Şablonu Görüntüle nasıl olduğunu fark bir @modei MvcMovie.Modeis.Movie deyimini dosyanın üst. 

@modei MvcMovie.Modeis.Movie Görünüm model görünüm şablonu türünde olmasını bekliyor belirtir Movie . 

iskele kurulan kodu birkaç etiketi Yardımcısı yöntemleri HTML biçimlendirmeyi kolaylaştırmak için kullanır. 
Etiket etiketi Yardımcısı ("Title", "ReleaseDate", "Tarzı" veya "Price") alanın adını görüntüler. Giriş etiketi 
Yardımcısı bir HTML işleyen cinput> öğesi. Doğrulama etiketi Yardımcısı bu özellikle ilişkili herhangi bir 
doğrulama iletisi görüntüler. 

Uygulamayı çalıştırmak ve gidin /Movies URL'si. 1 A tıklayın bir Düzenle bağlantı. Tarayıcıda, sayfa için 
kaynağı görüntüleyin. İçin oluşturulan HTML cform> öğesi aşağıda gösterilmektedir. 











<form action="/Movies/Edit/7" method="post"> 

<div class="form-horizontal"> 
ch4>Moviec/h4> 
chr /> 

<div class="text-danger" /> 

cinput type="hidden" data-val="true" data-val-required="The ID field is required." id="ID" 
name="ID" value="7" /> 

<div class="form-group"> 

<label class="control-label col-md-2" for="Genre" /> 

<div class="col-md-10"> 

<input class="form-control" type="text" id="Genre" name="Genre" value="Western" /> 

<span class="text-danger field-validation-valid" data-valmsg-for="Genre" data-valmsg- 
replace="true"x/span> 

</div> 

</div> 

<div class="form-group"> 

<label class="contnol-label col-md-2" for="Price" /> 

<div class="col-md-10"> 

<input class="form-control" type="text" data-val="true" data-val-number="The field Price 
must be a number." data-val-required="The Price field is required." id="Price" name="Price" value="3.99" /> 
<span class="text-danger field-validation-valid" data-valmsg-for="Price" data-valmsg- 
replace="true"x/span> 

</div> 

</div> 

<!-- Markup removed for brevity --> 

<div class="form-group"> 

<div class="col-md-offset-2 col-md-10"> 

cinput type="submit" value="Save" class="btn btn-default" /> 

</div> 

</div> 

</div> 

cinput name="_RequestVerificationToken" type="hidden" 

value="CfD38Inyxgp63fRFqUePGvuI5jGZslolulL7X91elgy7NCHSduCRx9jDQClrV9pOTTmqUyXnlBXhmrjcUVD2yDUMm7- 

MF_9rK8aAZdRdl0ri7FmKVkRe_2v5LIHGKFcTjPrWPYnc9AdSbomki0SaTEg7RU" /> 

c/form> 

cinput» Öğeler içinde bir html cform> öğesi olan action özniteliğinin ayarlanmış gönderinin yayımlanacağı 
/Movies/Edit/id URL'si. Form verileri sunucuya yayımlanacak olduğunda save düğmesine tıklandığında. Son 
satırı kapatmadan önce c/form> öğenin gizli gösterir XSRF tarafından oluşturulan belirteç Form etiketi 
Yardımcısı. 

POST isteğini işleme 

Aşağıdaki liste gösterildiği [HttpPost] sürümünü Edit eylem yöntemi. 








[HttpPost] 

[ValidateAntiFongenyToken] 

public async Task<IActionResult> Edit(int idj [BindC'IDjTitlejReleaseDatejGennejPnice")] Movie movie) 

{ 

if (id != movie.ID) 

{ 

netunn NotFound(); 

} 

if (ModelState.IsValid) 

{ 

tny 

{ 

_context.Update(movie); 

await _context. SaveChangesAsync (); 

} 

catch (DbUpdateConcunrencyException) 

{ 

if (!MovieExists(movie.ID)) 

{ 

return NotFound(); 

} 

else 

{ 

throw; 

} 

} 

retunn RedirectToAction(nameof(Index)); 

} 

netunn View(movie); 



// POST: Movies/Edit/5 

// To protect from overposting attacks, please enable the specific properties you want to bind to, for 
// more details see http://go.microsoft.com/fwlink/?LinkId=317598. 

[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Edit(int id, [Bind("ID,Title,ReleaseDate,Genre,Price")] Movie movie) 

{ 

if (id != movie.ID) 

{ 

netunn NotFound(); 

} 

if (ModelState.IsValid) 

{ 

try 

{ 

_context.Update(movie); 

await _context.SaveChangesAsync(); 

} 

catch (DbllpdateConcurrencyException) 

{ 

if (!MovieExists(movie.ID)) 

{ 

retunn NotFound(); 

} 

else 

{ 

thnow; 

} 

} 

netunn RedinectToAction("Index"); 

} 

netunn View(movie); 

} 

[validateAntiFongenyToken] Özniteliği gizli doğrular XSRF içinde sahteciliğe karşı koruma belirteci Oluşturucu 
tarafından oluşturulan belirteç Form etiketi Yardımcısı 

Model bağlama sistem gönderilen form değerlerini alır ve oluşturan bir Movie olarak geçirilen nesne movie 
parametresi. ModelState.IsValid Yöntemi doğrular (düzenleme veya güncelleştirme) değiştirileceğini biçiminde 
gönderilen veriler kullanılabilir bir Movie nesne. Veriler geçerliyse kaydedilir.Güncelleştirilmiş (düzenlenen) 
film verileri çağırarak veritabanına kaydedilir SaveChangesAsync veritabanı bağlamının yöntemi. Verileri 
kaydettikten sonra kodu kullanıcı için yönlendiren index eylem yöntemi MoviesControiler yaptığınız 
değişiklikleri içeren film koleksiyonu görüntüleyen sınıfı. 

Form, sunucuya gönderilen önce istemci tarafı doğrulama alanlarda tüm doğrulama kurallarını denetler. 
Herhangi bir doğrulama hatası varsa, bir hata iletisi görüntülenir ve form gönderilen değil. JavaScript devre dışı 
bırakılırsa, istemci tarafı doğrulama olmaz ancak sunucu, geçerli olmayan gönderilen değerlerden algılar ve 
form değerleri, hata iletileri ile yeniden. Öğreticinin ilerleyen bölümlerinde inceleyeceğiz Model doğrulama 
daha ayrıntılı bir şekilde. Doğrulama etiketi Yardımcısı içinde Vlews/Movles/Edit.cshtml görünüm şablonu 
uygun hata iletilerini görüntüleme üstlenir. 










| ■- Edit - Movie App X + 

C A https://localhost:5001/Movies/Edit/4 
Movie App Home Privacy 

Edit 

Movie 

Title 

Rio Bravo 
Release Date 

01/01/0000 x : ▼ 

The Release Date field is 
required. 

Genre 

VVestern 

Price 

abc 

The field Price must be a 
number. 


Save 


Back to List 

© 2019 - Movie App - Privacy 

Tüm HttpGet film denetleyici yöntemleri benzer bir desen uygulayın. Bir film nesnesi aldıkları (veya 
durumunda nesnelerin listesini index ) ve '% s'nesne (modeli) görünümüne geçirin, create Boş film nesneye 
yöntemi geçirir create görünümü. Bu nedenle, oluşturmak, düzenlemek, silmek veya aksi halde verileri 
değiştiren tüm yöntemler yapmak [HttpPost] yöntemi aşırı yüklemesi. Verileri değiştirme bir httpget bir 
güvenlik riski yöntemidir. Verileri değiştirme bir http get yöntemi de ihlal HTTP en iyi yöntemler ve mimari 
REST desen, GET istekleri, uygulamanızın durumunu değiştirmemeniz belirtir. Diğer bir deyişle, bir GET işlemi 
gerçekleştirilirken yan etkileri olan ve verilerinizi kalıcı değiştirmez güvenli bir işlem olmalıdır. 

Ek kaynaklar 

• Genelleştirme ve yerelleştirme 

• Etiket Yardımcıları giriş 

• Yazma etiketi Yardımcıları 

• istek Sahteciliğinden Koruma 

• Denetleyicinizden korumak aşırı gönderme 


□ X 

o. e s 















Vievvmodel'lar 
Form Etiketi Yardımcısı 
Giriş Etiketi Yardımcısı 
Etiket Etiketi Yardımcısı 
Seçim Etiketi Yardımcısı 
Doğrulama etiketi Yardımcısı 






ASRNET Core MVC uygulamasına arama ekleme 
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Tarafından Rick Anderson 

Bu bölümde, film metoduna farz veya ada göre arama index özelliği ekleyebilirsiniz. 
Controllers/MoviesController. cs içinde bulunan yöntemiaşağıdakikodlagüncelleştirin: index 

public async Task<IActionResult> Index(string searchString) 

{ 

var movies = from m in _context.Movie 
select m; 

if (IString.IsNullOrEmpty(searchString)) 

{ 

movies = movies.Where(s => s.Title.Contains(searchString)); 

} 

return View(await movies.ToListAsync()); 

} 

index Eylem yönteminin ilk satırı, filmleri seçmek için bir LINQ sorgusu oluşturur: 

var movies = from m in _context.Movie 
select m; 

Sorgu yalnızca bu noktada tanımlanmış, veritabanında çalıştırılmadı. 

searchString Parametresi bir dize içeriyorsa, filmler sorgusu arama dizesinin değerine göre filtrelenecek şekilde 
değiştirilir: 

if (IString.IsNullOrEmpty(searchString)) 

{ 

movies = movies.Where(s => s.Title.Contains(searchString)); 

} 

Yukarıdaki kod bir lambda ifadesidir, s => s.utie.contains() Lambdalar, Yöntem tabanlı LINQ sorgularında 
VVHERE yöntemi veya contains (Yukarıdaki kodda kullanılan) gibi standart sorgu işleci yöntemlerine bağımsız 
değişkenler olarak kullanılır. LINQ sorguları tanımlandıklarında veya where , contains ya orderBy da gibi bir 
yöntem çağırarak değiştirildiklerinde yürütülmez. Bunun yerine sorgu yürütmesi ertelenir. Diğer bir deyişle, bir 
ifadenin değerlendirmesi, gerçekleştirilmiş değeri gerçekten yineleneceği veya ToListAsync Yöntem çağrılana 
kadar geciktirilen anlamına gelir. Ertelenmiş sorgu yürütme hakkında daha fazla bilgi için bkz. sorgu yürütme. 

Not: Contains yöntemi yukarıda gösterilen c# kodunda değil, veritabanında çalıştırılır. Sorgudaki büyük/küçük 
harf duyarlılığı veritabanına ve harmanlamaya bağlıdır. SQL Server üzerinde SQL gibieşlemeler içerir , 
büyük/küçük harfe duyarsız olur. SQLİte ' da, varsayılan harmanlama ile büyük/küçük harfe duyarlıdır. 

/Movies/index sayfasına gidin. URL 'ye gibi ?searchstring=Ghost bir sorgu dizesi ekleyin. Filtrelenmiş filmler 
görüntülenir. 
















index Yönteminin imzasını adlı id bir parametreye sahip olacak şekilde değiştirirseniz, id parametresi 
Startup.csıçmde ayarlanan varsayılan yollar için isteğe bağlı {id} yer tutucuya eşleşir. 

app.UseMvc(routes => 

{ 

routes.MapRoute( 

name: "default", 

template: "{controller=Home}/{action=Index}/{id?}"); 

}); 

Parametresini id ve searchstring değişikliğin tümoluşumlarınıolarakdeğiştirin. id 
Önceki index Yöntem: 


public async Task<IActionResult> Index(string searchstring) 

{ 

var movies = from m in _context.Movie 
select m; 

if (IString.IsNullOrEmpty(searchstring)) 

{ 

movies = movies.Where(s => s.Title.Contains(searchString)); 

} 

return View(await movies.ToListAsync()); 

} 


Parametresi ile index 


id güncelleştirilmiş Yöntem: 
















public async Task<IActionResult> Index(string id) 

{ 

var movies = from m in _context.Movie 
select m; 

if (IString.IsNullOrEmpty(id)) 

{ 

movies = movies.Where(s => s.Title.Contains(id)); 

} 

return View(await movies.Tol_istAsync()); 

} 


Artık arama başlığını sorgu dizesi değeri yerine rota verileri (bir URL segmenti) olarak geçirebilirsiniz. 
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Ancak, kullanıcıların bir filmi her arayışınızda URL 'Yİ değiştirmesini beklemeniz gerekmez. Böylece, filmlerin 
filtrelemesine yardımcı olmak için UI öğeleri ekleyeceğiz. Yol ile bağlantılı id parametrenin nasıl geçirileceğini 
test index etmek için yönteminin imzasını değiştirdiyseniz, adlı searchstring bir parametre alması için geri 
değiştirin: 

public async Task<IActionResult> Index(string searchstring) 

{ 

van movies = from m in _context.Movie 
select m; 

if (IString.IsNullOrEmpty(searchstring)) 

{ 

movies = movies.Where(s => s.Title.Contains(searchString)); 

} 

return View(await movies.ToListAsync()); 

} 









Views/filmler/lndex. cshtml dosyasını açın ve aşağıda vurgulanan <form> biçimlendirmeyi ekleyin: 


ViewData["Title"] = "Index"; 

} 

<h2>Index</h2> 

<P> 

<a asp-action="Create">Create New</a> 

</p> 

<form asp-controller="Movies" asp-action="Index"> 

<P> 

Title: cinput type="text" name="SearchString"> 
<input type="submit" value="Filter" /> 

</p> 

</form> 

<table class="table"> 

<thead> 


HTML <form> etiketi, form etiketi yardımcısınıkullanır, bu nedenle formu gönderdiğinizde, filtre dizesi film 
denetleyicisinin index eylemine gönderilir. Değişikliklerinizi kaydedin ve sonra filtreyi test edin. 
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Bekleneceğiniz gibi [HttpPost] index metodun aşırı yüklemesi yoktur. Bunun için gerekli değildir, çünkü 
yöntem uygulamanın durumunu değiştirmediğinden verileri filtrelememeniz yeterlidir. 

Aşağıdaki [HttpPost] index yöntemi ekleyebilirsiniz. 















[HttpPost] 

public string Index(string searchStringj bool notUsed) 

{ 

retunn "From [HttpPost]Index: filter on " + searchString; 

} 

notused Parametresi, index yöntemi için bir aşırı yükleme oluşturmak için kullanılır. Öğreticide daha sonra 
konuşacağız. 

Bu yöntemi eklerseniz, Invoker [HttpPost] index yöntemi yöntemiyle eşleşir [HttpPost] index veyöntemi 
aşağıdaki görüntüde gösterildiği gibi çalışır. 

. - □ X 

| https://localhost:5001/Movies X + 

0İ https://localhost:5001/Movies O. ğ : 

From [HttpPost]Index: filter on ghost 


Ancak, bu [HttpPost] index yöntemin bu sürümünü eklemeseniz bile, tümünün nasıl uygulandığını gösteren 
bir sınırlama vardır. Belirli bir arama için yer işareti koymak istediğinizi veya aynı film filtrelenmiş listesini 
görmek için onlara tıklabilecekleri bir bağlantı göndermek istediğinizi düşünün. HTTP POST isteğinin URL 'SI 
GET isteğinin URL 'siyle (localhost: {P O RT}/f i I m I er/d izi n) aynı olduğunu fark edin; URL 'de arama bilgisi yok. 
Arama dizesi bilgileri sunucuya form alanı değeriolarak gönderilir. Tarayıcı geliştirici araçları veya harika Fiddler 
aracınınolduğunu doğrulayabilirsiniz. Aşağıdaki görüntüde Chrome tarayıcı geliştirici araçları gösterilmektedir: 
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Filter 


Regex U Hide data URLs 


0 XHR JS CSS Img Media Font Doc WS Manifest Other 

Previevv Response Cookies Timing 


Name 


jquery.js 

/lib/jquery/dist 

bootstrap.js 

/lıb/bootstrap/dıst/js 

site.js?v=EWaMeWsJBYWmL2g... 

/js 


Headers 


4 reguests i 3.9 KB transferred Fi. 


▼ General 

Request URL: http://localhost:5000/Movies 
Request Method: POST 
Status Code: • 200 OK 

-kemote Address: [::i]:589«- 

Referrer Policy: no-referrer-when-downgrade 

▼ Response Headers view source 

Cache-Control: no-cache 
Content-Type: text/html; charset=utf-8 
Date: Mon, 10 Apr 2017 00:10:32 GMT 
Pragma: no-cache 
Server: Kestrel 
Transfer-Encoding: chunked 

▼ Request Headers view source 

Accept text/html,application/xhtfnl+xml,application/xml; 

q=0. 9 , image/webp,*/»;q=0.8 

Accept-Encoding: g:ip, deflate, br 

Accept-Language: en-US.,en;q=0.8 

Cache-Control: max-age=0 

Connection: keep-alive 

Content-Length: 201 

Content-Type: application/x-www-form-urlencoded 

Cookie: .AspNetCore.Antiforgery.txPTUN878m8=CfDl8898MxUF 

L5pAq2aeCj59HP3vvTrLPKlkrIeXslFchnazwWjLRXzWQjTw-tsE3DQr 

8bQg-xCdy7DbpfcQ-Hi2HAx0inlR838CvFU6oyWz7VIKmiKjUuXI371_ 

S-YZR0pBdNaP0mTxZX9]RHy_jX_zIig; .AspNetCore.Antiforger 

y.Hkgl_D_R5qY=CfD38B98HxUFL5pAq2aeCj59HP2tNs0B01ewBFztİb 

CoKKfe2wxo9rL6Z-9YP41jarbKyl_I5aQvz9BMWGfPpwwbH713w4I8qg 

C-CkWyxAsFxWKQyP0MYsYab98gk-z_M4jHl_rtw9ODBZ3uBVSB0fzF4 

tH8 

Hoşt: localhost: 5000 

Origin: http://localhost:5000 

Referer: http: //localhost: 5000/Movies 

Upgrade-lnsecure-Requests: 1 

User-Agent: Mozilla/5.0 (Windows NT 10.0; W0W64) AppleWeb 
Kit/537.36 (KHTHL, like Gecko) Chrome/57.0.2987.133 Safa 
ri/537.36 


' Form Data view source view URL encoded 

SearchString: Ghost 

_RequestVerificationToken: CfD38B98MxUFL5pAq2aeCj59HPlg2HX 
MD176NabW7uuk2OAGreBb3y0NufBTHAjxm3CjRFe-2sF50PVla72IyfC 
A9Pao3muZ0f4jtjDNDlXEagdlk_g67wBX12qOKI7DLD98OGjNjBB_-5r 
vRh3uQCroPRw 


Arama parametresini ve XSRF belirtecini istek gövdesinde görebilirsiniz. Bu şekilde, önceki öğreticide 
bahsedildiği gibi, form etiketi Yardımcısı , bir XSRF Anti-forgery belirteci oluşturur. Verileri değiştiriyoruz, bu 
nedenle denetleyiciyi denetleyici yönteminde doğrulamamız gerekmiyor. 

Arama parametresi, URL değil, istek gövdesinde olduğundan, bu arama bilgilerini, yer işareti veya başkalarıyla 
paylaşmak için yakalayamazsınız, isteğin, http get Görünümler/filmler/lndex. cshtml dosyasında bulunması 
gerektiğini belirterek bunu düzeltemedi. 

















































@model IEnumerable<MvcMovie.Models.Movie> 

@{ 

ViewData["Title"] = "Index"; 

} 

<hl>Index</hl> 

<P> 

<a asp-action="Create">Create New</a> 

</p> 

<form asp-controller="Movies" asp-action="Index" method="get"> 

<P> 

Title: <input type="text" name="SearchString"> 

<input type="submit" value="Filter" /> 

</p> 

</form> 

<table class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(mod 0 İ => model.Title) 

Artık bir arama gönderdiğinizde, URL arama sorgu dizesini içerir. HttpGet index Bir HttpPost index yönteminiz 
olsa da, arama eylem yöntemine de gidecektir. 
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Aşağıdaki biçimlendirme form etiketine olan değişikliği gösterir: 

<form asp-controller="Movies" asp-action="Index" method="get"> 


Türe göre arama Ekle 
















Aşağıdaki MovieGenreviewModei sınıfının modelleri klasörü: 


using Microsoft.AspNetCore.Mvc.Rendering; 
using System.Collections.Generic; 

namespace MvcMovie.Models 

{ 

public class MovieGenreViewModel 

{ 

public List<Movie> Movies { get; set; } 
public SelectList Genres { get; set; } 
public string MovieGenre { get; set; } 
public string SearchString { get; set; } 

} 

} 


Film tarzı görünüm modeli şunları içerir: 

• Bir film listesi. 

• Tarzlar listesini içeren bir SelectList . Bu, kullanıcının listeden bir tarz seçmesine olanak sağlar. 

• MovieGenre , seçilen tarzı içeren. 

• SearchString , kullanıcılar arama metin kutusuna girdiğiniz metni içerir. 
index içindeki MoviesControiier.es yöntemini aşağıdaki kodla değiştirin: 

// GET: Movies 

public async Task<IActionResult> Index(string movieGenre, string SearchString) 

{ 

// Use LINQ to get list of genres. 

IQueryable<string> genreÇuery = from m in _context.Movie 

orderby m.Genre 
select m.Genre; 

var movies = from m in _context.Movie 
select m; 

if (!string.IsNullOrEmpty(SearchString)) 

{ 

movies = movies.Where(s => s.Title.Contains(searchString)); 

} 

if (!string.IsNullOrEmpty(movieGenre)) 

{ 

movies = movies.Where(x => x.Genre == movieGenre); 

} 

var movieGenreVM = new MovieGenreViewModel 

{ 

Genres = new SelectList(await genreQuery.Distinct().ToListAsync()), 

Movies = await movies.ToListAsync() 

}; 

return View(movieGenreVM); 

} 

Aşağıdaki kod, veritabanından tüm linq tarzları alan bir sorgudur. 

// Use LINQ to get list of genres. 

IQueryable<string> genreQuery = from m in _context.Movie 

orderby m.Genre 
select m.Genre; 









selectList Tarzlar ayrı tarzlar yansıtıyor (Select listenizin yinelenen tarzlar olmasını istemiyorum). 


Kullanıcı öğeyi aradığında arama değeri arama kutusuna tutulur. 

Tarzı, dizin görünümüne göre ara ekleme 

Şu index.cshtmi şekilde görünümlerde/filmlerde bulunan güncelleştirme: 






@model MvcMovie.Models.MovieGenreViewModel 

@{ 

ViewData["Title"] = "Index"; 

} 

<hl>Index</hl> 

<P> 

<a asp-action="Create">Create New</a> 

</p> 

<form asp-controller="Movies" asp-action="Index" method="get"> 

<P> 

<select asp-for="MovieGenre" asp-items="Model.Genres"> 

<option value="">All</option> 

</select> 

Title: cinput type="text" asp-for="SearchString" /> 

<input type="submit" value="Filter" /> 

</p> 

</form> 

«ctable class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model => model.Movies[0].Title) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movies[0].ReleaseDate) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movies[0].Genre) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movies[0].Price) 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model.Movies) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.ReleaseDate) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Genre) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Price) 

</td> 

<td> 

<a asp-action="Edit" asp-route-id="@item.Id">Edit</a> | 

<a asp-action="Details" asp-route-id="@item.Id">Details</a> | 
<a asp-action="Delete" asp-route-id="@item.Id">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 



Aşağıdaki HTML Yardımcısı ’nda kullanılan lambda ifadesini inceleyin: 


@Html.DisplayNameFor(model => model.Movies[0].Title) 

Yukarıdaki kodda, DisplayNameFor HTML Yardımcısı, görünen adı belirlemede Lambda Title ifadesinde 
başvurulan özelliği inceler. Lambda model ifadesi değerlendirilmek yerine incelenebileceğinden,, model.Movies , 
veya model.Movies[@] nuiı boş olduğunda bir erişim ihlali almazsınız. Lambda ifadesi değerlendirildiğinde 
(örneğin, @Htmi.DispiayFor(modeiıtem => item.Title) ), modelin özellik değerleri değerlendirilir. 

Türe göre, film başlığına göre ve her ikisine birden arayarak uygulamayı test edin: 
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ASRNET Core MVC uygulamasına yeni bir alan 
ekleme 

23.11.2019 * 8 minutes to read ı Edit Online 


Tarafından Rick Anderson 

Bu bölümde Entity Framevvork için Code First Migrations kullanılır: 

• Modele yeni bir alan ekleyin. 

• Yeni alanı veritabanına geçirin. 

EF Code First otomatik olarak bir veritabanı oluşturmak için kullanıldığında, Code First: 

• Veritabanının şemasını izlemek için veritabanına tablo ekler. 

• Veritabanının oluşturulduğu model sınıflarıyla eşitlenmiş olduğunu doğrular.Bunlar eşitlenmiş değilse EF bir 
özel durum oluşturur. Bu, tutarsız veritabanı/kod sorunlarını bulmayı kolaylaştırır. 

Film modeline bir derecelendirme özelliği ekleyin 

M o d e ile r/film. cs‘ ye bir Rating özelliği ekleyin: 

public class Movie 
{ 

public int Id { get; set; } 
public string Title { get; set; } 

[Display(Name = "Release Date")] 

[DataType(DataType.Date)] 

public DateTime ReleaseDate { get; set; } 

public string Genre { get; set; } 

[Column(TypeName = "decimal(18, 2)")] 
public decimal Price { get; set; } 
public string Rating { get; set; } 

} 

Uygulama oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Ctrl + Shift+B 

novie sınıfına yeni bir alan eklediyseniz, bu yeni özellik dahil edilecek şekilde bağlama beyaz listesini 
güncelleştirmeniz gerekir. MoviesController.es' de, Rating özelliği dahil etmek için hem create hem de Edit 
eylem yöntemlerinin [Bind] özniteliğini güncelleştirin: 

[Bind("Id,Title,ReleaseDate,Genre,Price,Rating")] 

Yeni Rating özelliğini tarayıcı görünümünde görüntülemek, oluşturmak ve düzenlemek için görünüm 
şablonlarını güncelleştirin. 














/Views/movies/lndex.cshtml dosyasını düzenleyin ve bir Rating alanı ekleyin: 


<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model => model.Movies[0].Title) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movies[0].ReleaseDate) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movies[0].Genre) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movies[0].Price) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Movies[0].Rating) 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model.Movies) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.ReleaseDate) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Genre) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Price) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Rating) 

</td> 

<td> 

<a asp-action="Edit" asp-route-id="@item.Id">Edit</a> | 

Bir Rating alanla /vlews/movies/Create.cshtml güncelleştirin. 

• Visual Studio/Mac için Visual Studio 

• Visual Studio Code 

Önceki "form grubunu kopyalayabiIir/yapıştırabilir" ve IntelliSense 'in alanları güncelleştirmenize yardımcı 
olmasına izin verebilirsiniz. IntelliSense, Etiket Yardımcılarıile birlikte çalışmaktadır. 





</div> 

<div class="form-group"> 

<label asp-for=”Title" class=”col-md-2 control-label”x/label> 
<div class="col-md-10 ,, > 

<input asp-for=”Title" class=”form-control" /> 

<span asp-validation-for=''Title" class="text-danger” /> 


</div> 

</div> 

<div class="form-group"> 
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</div> 

</form> 


Kalan şablonları güncelleştirin. 

seedData sınıfını yeni sütun için bir değer sağlayacak şekilde güncelleştirin. Aşağıda örnek bir değişiklik 
gösterilmektedir, ancak her bir new Movie için bu değişikliği yapmak isteyeceksiniz. 

new Movie 
{ 

Title = "Uhen Harry Met Sally", 

ReleaseDate = DateTime.ParseC'1989-l-H"), 

Genre = "Romantic Comedy", 

Rating = "R"j 
Price = 7.99M 

}, 

VERITABANı yeni alanı içerecek şekilde güncelleştirilene kadar uygulama çalışmaz. Şimdi çalıştırıldığında, 
aşağıdaki sqiException atılır: 

SqlException: Invalid column name 'Rating'. 

Bu hata, güncelleştirilmiş film modeli sınıfı varolan veritabanının film tablosunun şemasından farklı olduğu için 
oluşur. (Veritabanı tablosunda Rating sütunu yoktur.) 

Hatayı çözmek için birkaç yaklaşım vardır: 

1 . Entity Framevvork yeni model sınıfı şemasına göre otomatik olarak veritabanını bırakıp yeniden 
oluşturmayı sağlayabilirsiniz. Bu yaklaşım, bir test veritabanı üzerinde etkin geliştirme yaparken geliştirme 
döngüsünün başlarında çok daha kolay, modeli ve veritabanı şemasını birlikte hızla gelişmenize olanak 
tanır. Bunun yanında, bu yaklaşımı bir üretim veritabanında kullanmak istemezsiniz, ancak bu, 
veritabanında var olan verileri kaybetmeniz olur. Bir veritabanının test verileriyle otomatik olarak çekirdeği 
oluşturmak için bir başlatıcı kullanılması, genellikle bir uygulama geliştirmenin üretken bir yoludur. Bu, 
erken geliştirme ve SQLİte kullanılırken iyi bir yaklaşımdır. 

2. Mevcut veritabanının şemasını model sınıflarıyla eşleşecek şekilde açıkça değiştirin. Bu yaklaşımın 
avantajı, verilerinizi tutmanızı kullanmaktır. Bu değişikliği el ile ya da bir veritabanı değişiklik betiği 
oluşturarak yapabilirsiniz. 

3. Veritabanı şemasını güncelleştirmek için Code First Migrations kullanın. 

Bu öğretici için Code First Migrations kullanılır. 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 











Araçlar menüsünde NuGet Paket Yöneticisi > Paket Yöneticisi konsolu' nu seçin. 
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ES Extensions and Updates... 
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T E Connectto Server... 
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PMC'de aşağıdaki komutları girin: 

Add-Migration Rating 
Update-Database 

Add-Migration komutu, geçiş çerçevesinin geçerli Movie modelini geçerli Movie DB şemasıyla incelemesini ve 
VERITABANıNı yeni modele geçirmek için gerekli kodu oluşturmasını söyler. 

"Derecelendirme" adı rastgele olur ve geçiş dosyasını adlandırmak için kullanılır.Geçiş dosyası için anlamlı bir ad 
kullanılması yararlı olur. 

VERITABANıN DAKI tüm kayıtlar silinirse, Initialize yöntemi VERITABANıNı temel alır ve Rating alanını içerir. 

Uygulamayı çalıştırın ve bir Rating alanı ile film oluşturabileceğiniz/düzenleyebileceğiniz/görüntüleydiğinizi 
doğrulayın. Edit, Details ve Delete görünüm şablonlarına Rating alanı eklemeniz gerekir. 


ÖNCEKİ 


İLERİ 









ASRNET Core MVC uygulamasına doğrulama 
ekleme 

23.11.2019 • 15 minutes to read ı Edit Online 


Tarafından Rick Anderson 

Bu bölümde: 

• Doğrulama mantığı Movie modeline eklenir. 

• Bir Kullanıcı bir filmi oluşturduğunda veya düzenleişinizde doğrulama kurallarının uygulanmasını 
sağlayabilirsiniz. 

İşleri güncel tutma 

MVC ' nin tasarımdan biri (" kendini tekrarlama"). ASP.NET Core MVC, işlevselliği veya davranışı yalnızca bir kez 
belirtmenizi ve bir uygulamada her yerde yansıtıldığını önerir. Bu, yazmanız gereken kod miktarını azaltır ve daha 
az hata yazmanızı, daha kolay test yapmayı ve bakımını daha kolay hale getirir. 

MVC ve Entity Framevvork Core Code First tarafından sunulan doğrulama desteği, işlem içindeki kuru ilkeye 
uygun bir örnektir. Doğrulama kurallarını tek bir yerde (model sınıfında) bildirimli olarak belirtebilir ve kurallar 
uygulamada her yerde zorlanır. 

Film modeline doğrulama kuralları ekleme 

Dataaçıklamalarda ad alanı, bir sınıfa veya özelliğe bildirimli olarak uygulanan bir yerleşik doğrulama öznitelikleri 
kümesi sağlar. Dataaçıklamalarda, biçimlendirme ile ilgili Yardım DataType ve herhangi bir doğrulama 
sağlamayan gibi biçimlendirme öznitelikleri de bulunur. 

Yerleşik Required ,, ReguiarExpression vedoğrulama özniteliklerinden yararlanmak için sınıfıgüncelleştirin. Movie 
StringLength 


Range 








public class Movie 

{ 

public int Id { get; set; } 

[StringLength(60, MinimumLength = 3)] 

[Required] 

public string Title { get; set; } 

[Display(Name = "Release Date")] 

[DataType(DataType.Date)] 

public DateTime ReleaseDate { get; set; } 

[Range(lj 100)] 

[DataType(DataType.Currency)] 

[Column(TypeName = "decimal(18, 2)")] 
public decimal Pnice { get; set; } 

[RegularExpression(@" A [A-Z] + [a-zA-Z""'\s-]*$") ] 
[Required] 

[StringLength(30)] 

public string Genre { get; set; } 

[RegularExpression(@" A [A-Z]+[a-zA-Z0-9""'\s-]*$")] 
[StringLength(S)] 

[Required] 

public string Rating { get; set; } 


Doğrulama öznitelikleri, uygulanan model özellikleri üzerinde zorlamak istediğiniz davranışı belirtir: 

• Required Ve MinimumLength öznitelikleri bir özelliğin bir değere sahip olması gerektiğini belirtir; ancak 
hiçbir şey, bir kullanıcının bu doğrulamayı karşılamak için boşluk girmesini engeller. 

• ReguiarExpression Öznitelik, hangi karakterlerin girişi yapabileceğini sınırlamak için kullanılır. Yukarıdaki 
kodda, "tarz": 

o Yalnızca harfler kullanılmalıdır. 

o İlk harfin büyük harfle olması gerekir. Boşluk, sayı ve özel karakterlere izin verilmez. 

• ReguiarExpression "Derecelendirme": 

o İlk karakterin büyük harf olmasını gerektirir. 

o Sonraki boşlukların içindeki özel karakter ve sayılara izin verir. "PG-13" bir derecelendirme için 
geçerlidir, ancak bir "tarz" için başarısız olur. 

• Range Özniteliği bir değeri belirtilen bir Aralık içinde kısıtlar. 

• stringLength Özniteliği, bir dize özelliğinin en büyük uzunluğunu ve isteğe bağlı olarak en düşük 
uzunluğunu ayarlamanıza olanak sağlar. 

• Değer türleri (örneğin, decimal, int, float DateTime ), doğal olarak gereklidir ve [Required] özniteliğe 
gerek kalmaz. 

Doğrulama kurallarının otomatik olarak uygulanmasını ASP.NET Core uygulamanızın daha sağlam olmasına 
yardımcı olur. Ayrıca, bir şeyi doğrulamayı unutmanızı ve veritabanına yanlışlıkla veri vermemesini de sağlar. 

Doğrulama hatası Kullanıcı arabirimi 

Uygulamayı çalıştırın ve filmler denetleyicisine gidin. 

Yeni bir film eklemek için Yeni oluştur bağlantısına dokunun. Formu, bazı geçersiz değerlerle doldurun. JQuery 
istemci tarafı doğrulaması hatayı algıladıktan hemen sonra bir hata iletisi görüntüler. 
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Movie 

Title 

The field Title must be a 
string with a minimum length 
of 3 and a maximum length 
of 60. 

Release Date 

12/12/0000 x: ▼ 

The Release Date field is 
required. 

Genre 

The field Genre must match 
the regular expression ' A [A- 
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Price 

z 

The field Price must be a 
number. 

Rating 

The field Rating must match 
the regular expression ' A [A- 
Z]+[a-zA-Z0-9"'\s-]*$'. 
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NOTE 

Ondalık alanlara ondalık virgüller giremeyebilirsiniz. Ondalık bir nokta ve ABD İngilizcesi olmayan tarih biçimleri için virgül 
kullanan İngilizce olmayan yerel ayarlarda jOuery doğrulamasını desteklemek için, uygulamanızı globalize için adımlar 
uygulamanız gerekir. Ondalık virgülden ekleme hakkında yönergeler için bkz. GitHub sorunu 4076 . 


Formun, geçersiz bir değer içeren her bir alanda uygun bir doğrulama hata iletisini nasıl otomatik olarak 













oluşturduğuna dikkat edin. Hatalar hem istemci tarafında (JavaScript vejQuery kullanılarak) hem de sunucu 
tarafında (kullanıcının JavaScript devre dışı bırakılmış olması durumunda) zorlanır. 

Önemli bir avantaj, bu doğrulama kullanıcı arabirimini etkinleştirmek için MoviesControiler sınıfında veya 
Create. cshtml görünümündeki tek bir kod satırını değiştirmeniz gerekmez. Bu öğreticide daha önce 
oluşturduğunuz denetleyici ve görünümler, Movie model sınıfının özelliklerinde doğrulama özniteliklerini 
kullanarak belirttiğiniz doğrulama kurallarını otomatik olarak çekti. Edit Action yöntemini kullanarak test 
doğrulaması ve aynı doğrulama uygulanır. 

Form verileri, istemci tarafı doğrulama hatası kalmayana kadar sunucuya gönderilmez. Bunu, Fiddler aracını veya 
Fi 2 geliştirici araçlarınıkullanarak http Post yöntemine bir kesme noktası koyarak doğrulayabilirsiniz. 

Doğrulamanın çalışması 

Doğrulama Kullanıcı arabiriminin denetleyici veya görünümlerde kodda herhangi bir güncelleştirme yapmadan 
nasıl oluşturulduğunu merak edebilirsiniz. Aşağıdaki kod iki create yöntemini gösterir. 

// GET: Movies/Create 
public IActionResult Create() 

{ 

return View(); 

} 

// POST: Movies/Create 
[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Create( 

[Bind("IDjTitle,ReleaseDate,Germe,Price, Rating")] Movie movie) 

{ 

if (ModelState.IsValid) 

{ 

_context.Add(movie); 

await _context.SaveChangesAsync(); 

return RedirectToAction("Index"); 

} 

return View(movie); 

} 

ilk (HTTP GET) create Action yöntemi ilk oluşturma formunu görüntüler.İkinci ( [HttpPost] ) sürüm, form 
gönderisini işler, ikinci create yöntemi ( [HttpPost] sürümü), filmin herhangi bir doğrulama hatası olup 
olmadığını denetlemek için ModelState.IsValid çağırır. Bu yöntemi çağırmak, nesnesine uygulanmış olan tüm 
doğrulama özniteliklerini değerlendirir. Nesnede doğrulama hataları varsa create yöntemi formu yeniden 
görüntüler. Hata yoksa, yöntemi yeni filmi veritabanına kaydeder. Film örneğimizde, istemci tarafında algılanan 
doğrulama hataları olduğunda form sunucuya nakledilmez; istemci tarafı doğrulama hataları olduğunda ikinci 
create yöntemi hiçbir zaman çağrılmaz. Tarayıcınızda JavaScript 'i devre dışı bırakırsanız, istemci doğrulaması 
devre dışıdır ve herhangi bir doğrulama hatasını tespit ModelState.IsValid HTTPPOST create yöntemini test 
edebilirsiniz. 

[HttpPost] create yönteminde bir kesme noktası ayarlayabilir ve yöntemin hiçbir zaman çağrılmadığını 
doğrulayabilirsiniz, doğrulama hataları algılandığında istemci tarafı doğrulaması form verilerini göndermez. 
Tarayıcınızda JavaScript 'i devre dışı bırakır, ardından formu hatalarla gönderirseniz, kesme noktası isabet eder. 
JavaScript olmadan tam doğrulama almaya devam edersiniz. 

Aşağıdaki görüntüde, FireFox tarayıcısında JavaScript 'İn nasıl devre dışı bırakılacağı gösterilmektedir. 






















Aşağıdaki görüntüde, Chrome tarayıcısında JavaScript 'İn nasıl devre dışı bırakılacağı gösterilmektedir. 
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JavaScript 'i devre dışı bıraktıktan sonra, geçersiz veri gönderin ve hata ayıklayıcıda adım adım ilerleyin. 






























































74 // POST: Movies/Create 

// To protect from overposting attacks, please enable t 
// more details see htto://go.microsoft.com/fwlink/?Lin 

[HttpPost] 

[ValidateAntiForgeryToken] 

0 references 

public async . .. 'I 

80 { false 

D 81 i if (ModelState.IsValid) 

{ 

_context . Add ( movie ); 
awalt _context . SaveChangesAsync (); 
return RedinectToAction( "Index" ); 

} 

return View(raovie); 

} 


lt> Create([Bind("ID J Title 


Create. cshtml görünüm şablonunun bölümü aşağıdaki biçimlendirmede gösterilmiştir: 


<h4>Movie</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form asp-action="Create"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/dlv> 
<div class="form-group"> 

<label asp-for="Title" class="control-label"x/label> 

«cinput asp-for="Title" class="form-control" /> 

<span asp-validation-for="Title" class="text-danger"x/span> 
</div> 

@*Markup removed for brevity.*@ 


Yukarıdaki biçimlendirme eylem yöntemleri tarafından ilk formu görüntülemek ve bir hata durumunda onu 
yeniden görüntülemek için kullanılır. 

Giriş etiketi Yardımcısı , dataaçıklamaların özniteliklerini kullanır ve istemci tarafında jQuery doğrulaması için 
gerekli HTML özniteliklerini üretir. Doğrulama etiketi Yardımcısı doğrulama hatalarını görüntüler. Daha fazla bilgi 
için bkz. doğrulama . 

Bu yaklaşım ne kadar iyi bir şeydir, denetleyicinin ne de create görünüm şablonunun zorlanmakta olan gerçek 
doğrulama kuralları ya da görüntülenen belirli hata iletileri hakkında herhangi bir şeyi biliyor olması önemlidir. 
Doğrulama kuralları ve hata dizeleri yalnızca Movie sınıfında belirtilmiştir. Aynı doğrulama kuralları Edit 
görünümüne ve modelinizi düzenleyebilecek oluşturabileceğiniz diğer tüm görünümler şablonlarına otomatik 
olarak uygulanır. 

Doğrulama mantığını değiştirmeniz gerektiğinde, modele doğrulama öznitelikleri ekleyerek tam olarak bir yerde 
bunu yapabilirsiniz (Bu örnekte, Movie sınıfı). Kuralların nasıl zorlandığından, uygulamanın farklı bölümlerinin 
tutarsız olması konusunda endişelenmeniz gerekmez; tüm doğrulama mantığı tek bir yerde tanımlanır ve her 
yerde kullanılır. Bu, kodun temiz kalmasını sağlar ve bakımını ve gelişmesini kolaylaştırır.Ayrıca, KURULAMA 
ilkesini tam olarak sunabileceksiniz anlamına gelir. 

DataType özniteliklerini kullanma 

Movie.cs dosyasını açın ve Movie sınıfını inceleyin. System.componentModei.DataAnnotations ad alanı, yerleşik 
doğrulama öznitelikleri kümesine ek olarak biçimlendirme öznitelikleri sağlar. Yayın tarihine ve fiyat alanlarına 
DataType bir numaralandırma değeri zaten uyguladık. Aşağıdaki kod, uygun DataType özniteliğiyle ReleaseDate 















ve Price özelliklerini gösterir. 


[Display(Name = "Release Date")] 

[DataType(DataType.Date)] 

public DateTime ReleaseDate { get; set; } 

[Range(l, 100)] 

[DataType(DataType.Currency) ] 
public decimal Price { get; set; } 

DataType öznitelikleri yalnızca görünüm altyapısının verileri biçimlendirmek için ipuçları sağlar (ve URL 'ler için 


gibi öğeleri/öznitelikleri ve e-posta için 

<a href="mailto:EmailAddress.com"> 

sağlar. 

RegularExpression 


özniteliğini kullanarak verilerin biçimini doğrulayabilirsiniz. DataType özniteliği, veritabanı iç türünden daha özel 
bir veri türü belirtmek için kullanılır, bunlar doğrulama öznitelikleri değildir. Bu durumda, zamanı değil yalnızca 
tarihi izlemek istiyoruz. DataType numaralandırması, tarih, saat, PhoneNumber, para birimi, Emaadresi ve daha 
fazlası gibi birçok veri türü sağlar. DataType özniteliği Ayrıca uygulamanın türe özgü özellikleri otomatik olarak 
sağlamasını da sağlayabilir. Örneğin, DataType. EmailAddress için maiıto: bir bağlantı oluşturulabilir ve HTML5'i 
destekleyen tarayıcılarda DataType.Date için bir tarih seçici sağlaneklenebilir. DataType öznitelikleri HTML 5 
tarayıcıların anlayabilmesi için HTML 5 data- (bir veri Dash) öznitelikleri yayar. DataType öznitelikleri herhangi 
bir doğrulama sağlamaz. 

DataType.Date görüntülenen tarihin biçimini belirtmiyor. Varsayılan olarak, veri alanı, sunucunun cuitureinfo 
göre varsayılan biçimlere göre görüntülenir. 

DisplayFormat özniteliği, açıkça tarih biçimini belirtmek için kullanılır: 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 
public DateTime ReleaseDate { get; set; } 

ApplyFormatlnEditMode ayarı, bir metin kutusunda değer görüntülenmek üzere görüntülendiğinde 
biçimlendirmenin de uygulanacağını belirtir. (Örneğin, para birimi değerleri için, büyük olasılıkla, metin 
kutusundaki para birimi sembolünü, bazı alanlar için istemiyor olabilirsiniz.) 

DisplayFormat özniteliğini kendisi kullanabilirsiniz, ancak bu genellikle DataType özniteliğini kullanmak iyi bir 
fikir olabilir. DataType özniteliği, bir ekranda nasıl işlenirim aksine verilerin semantiğini sunar ve DisplayFormat 
ile elde olmadığınız aşağıdaki avantajları sağlar: 

• Tarayıcı HTML5 özelliklerini etkinleştirebilir (örneğin, bir Takvim denetimini, yerel ayara uygun para birimi 
sembolünü, e-posta bağlantılarını vb. göstermek için) 

• Varsayılan olarak tarayıcı, verileri yerel ayarınızı temel alarak doğru biçimi kullanarak işleyebilir. 

• DataType özniteliği, verileri işlemek için doğru alan şablonunu seçmek üzere MVC 'yi etkinleştirebilir 
(kendisi tarafından kullanılırsa, dize şablonunu kullanıyorsa DisplayFormat ). 


NOTE 

jOuery doğrulaması, Range özniteliğiyle ve DateTime birlikte çalışmaz. Örneğin, aşağıdaki kod, tarih belirtilen aralıkta 
olduğunda bile her zaman bir istemci tarafı doğrulama hatası görüntüler: 

[Range(typeof(DateTime), "1/1/1966", "1/1/2020")] 


DateTime'' Range özniteliğini kullanmak için jöuery Tarih doğrulamasını devre dışı bırakmanız gerekir. 
Modellerinizde sabit tarihleri derlemek genellikle iyi bir uygulamadır, bu nedenle Range özniteliği ve DateTime 
kullanılması önerilmez. 



























Aşağıdaki kod, öznitelikleri tek bir satırda birleştirmeyi gösterir: 


public class Movie 

{ 

public int Id { get; set; } 

[StringLength(60, MinimumLength = 3)] 
public string Title { get; set; } 

[Display(Name = "Release Date"), DataType(DataType.Date)] 
public DateTime ReleaseDate { get; set; } 

[RegularExpression(@" A [A-Z]+[a-zA-Z""'\s-]*$"), Required, StringLength(30)] 
public string Genre { get; set; } 

[Range(l, 100), DataType(DataType.Currency)] 

[Column(TypeName = "decimal(18, 2)")] 
public decimal Price { get; set; } 

[RegularExpression(@" A [A-Z]+[a-zA-Z0-9""'\s-]*$"), StringLength(5)] 
public string Rating { get; set; } 

} 

Serinin bir sonraki bölümünde, uygulamayı gözden geçiririz ve otomatik olarak oluşturulan Details ve Delete 
yöntemlerinde bazı geliştirmeler yaparsınız. 

Ek kaynaklar 

• Formlarla Çalışma 

• Genelleştirme ve yerelleştirme 

• Etiket yardımcılarına giriş 

• Yazar etiketi yardımcıları 


ÖNCEKİ 


İLERİ 








ASPNET Core uygulamasının Ayrıntılar ve silme 
yöntemlerini inceleyin 

4.12.2019 • 4 minutes to read ı Edit Online 


Tarafından Rick Anderson 

Film denetleyicisini açın ve Details yöntemi inceleyin: 

// GET: Movies/Details/5 

public async Task<IActionResult> Details(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var movie = await _context.Movie 

.FirstOrDefaultAsync(m => m.Id == id); 
if (movie == null) 

{ 

return NotFound(); 

} 

return View(movie); 

} 


Bu eylem yöntemini oluşturan MVC yapı iskelesi altyapısı, yöntemi çağıran bir HTTP isteğini gösteren bir 
açıklama ekler. Bu durumda, üç URL segmentine sahip bir GET isteği, Movies denetleyicisi, Details yöntemi ve 
bir id değeri. Bu kesimleri geri çağır Sfortup.csiçinde tanımlanmıştır. 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapControllerRoute( 
name: "default", 

pattern: "{controller=Home}/{action=Index}/{id?}"); 

}); 

EF, FirstorDefaultAsync yöntemini kullanarak verileri aramanızı kolaylaştırır. Yöntemi içinde yerleşik olarak 
bulunan önemli bir güvenlik özelliği, kodun, onunla herhangi bir şey yapmayı denemeden önce arama 
yönteminin bir filmi buldığını doğrulamasından kaynaklanmaktadır. Örneğin, bir korsan 
http://localhost:{PORT}/Movies/Detaiis/ı bağlantıları tarafından oluşturulan URL 'yi 

http://localhost:{P0RT}/Movies/Detaiis/i2345 (veya gerçek bir filmi temsil eden başka bir değer) gibi bir şeye 
değiştirerek siteye hata verebilir. Null bir filmi denetmediyseniz, uygulama bir özel durum oluşturur. 


Delete ve DeleteConfirmed yöntemlerini inceleyin. 











// GET: Movies/Delete/5 

public async Task<IActionResult> Delete(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var movie = await _context.Movie 

.FirstOrDefaultAsync(m => m.Id == id); 
if (movie == null) 

{ 

return NotFound(); 

} 

return View(movie); 

} 

// POST: Movies/Delete/5 
[HttpPost, ActionName("Delete")] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> DeleteConfirmed(int id) 

{ 

var movie = await _context.Movie. FindAsync(id); 

_context.Movie.Remove(movie); 
await _context.SaveChangesAsync(); 
return RedirectToAction(nameof(Index)); 

} 

http get Delete yöntemi belirtilen filmi silmediğini unutmayın. Bu, silme işlemini gönderebileceğiniz (HttpPost) 
filmin bir görünümünü döndürür. Bir G ET isteğine yanıt olarak silme işlemi gerçekleştirme (veya bu konuyla ilgili 
olarak, düzenleme işlemi gerçekleştirme, oluşturma işlemi yapma veya verileri değiştiren başka bir işlem) bir 
güvenlik deliği açılır. 

Verileri silen [HttpPost] yöntemi, HTTP POST yöntemine benzersiz bir imza veya ad vermek için 
DeleteConfirmed olarak adlandırılır. İki yöntem imzası aşağıda gösterilmiştir: 

// GET: Movies/Delete/5 

public async Task<IActionResult> Delete(int? id) 

{ 


// POST: Movies/Delete/5 
[HttpPost, ActionName("Delete")] 
[ValidateAntiForgeryToken] 

public async Task<IActionResult> DeleteConfirmed(int id) 
{ 


Ortak dil çalışma zamanı (CLR), aşırı yüklenmiş yöntemlerin benzersiz bir parametre imzasına sahip olmasını 
gerektirir (aynı yöntem adı ancak farklı parametre listesi). Bununla birlikte, her ikisi de aynı parametre imzasına 
sahip olmak üzere iki Delete yöntemi (GET için bir tane ve diğeri) gerekir.(Her ikisi de parametre olarak tek bir 
tamsayıyı kabul etmelidir.) 

Bu sorunun iki yaklaşımı vardır, biri yöntemlere farklı adlar vermektir.Bu, önceki örnekte bulunan yapı iskelesi 
mekanizmasına göre yapılır. Ancak, bu küçük bir sorun ortaya çıkarır: ASP.NET bir URL 1 nin segmentlerini ada 
göre eylem yöntemlerine eşler ve bir yöntemi yeniden adlandırırsanız, yönlendirme normalde bu yöntemi 
bulamaz. Çözüm, örnekte gördüğünüz şeydir. Bu, DeleteConfirmed yöntemine ActionName("Deiete") özniteliğini 
eklemektir. Bu öznitelik, yönlendirme sistemi için eşleme gerçekleştirerek, bir POST isteği için/Delete/içeren bir 
URL 'nin DeleteConfirmed yöntemi bulacaktır. 









Özdeş adlara ve imzalara sahip yöntemler için bir diğer yaygın çalışma yapay, POST yönteminin imzasını bir ek 
(kullanılmamış) parametre içerecek şekilde değiştirecek. Bu, notused parametresini eklediğimiz sırada önceki bir 
gönderimiz tarafından yaptığımız şeydir. [HttpPost] Delete yöntemi için burada aynı şeyi yapabilirsiniz: 

// POST: Movies/Delete/6 
[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Delete(int id, bool notUsed) 

Azure'a Yayımlama 

Azure 'a dağıtma hakkında bilgi için bkz. öğretici: Azure App Service .NET Core ve SQL veritabanı Web 
uygulaması oluşturma. 


ÖNCEKİ 






ASPNET Core MVC 'deki görünümler 
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Steve Smith ve Luke Latham tarafından 

Bu belgede ASP.NET Core MVC uygulamalarında kullanılan görünümler açıklanmaktadır.Razor Pages 
hakkında bilgi için bkz. Razor Pages giriş. 

Model-Vievv-Controller (MVC) modelinde, Görünüm uygulamanın veri sunumunu ve kullanıcı etkileşimini işler. 
Görünüm, gömülü Razor işaretlemesilÇEREN bir HTML şablonudur.Razor işaretleme, istemciye gönderilen bir 
Web sayfası oluşturmak için HTML işaretlemesi ile etkileşen koddur. 

ASP.NET Core MVC 'de, görünümler Razor biçimlendirmesinde C# programlama dilini kullanan . cshtml 
dosyalarıdır. Genellikle, görünüm dosyaları uygulama denetleyicilerininher biri için adlandırılmış klasörler 
halinde gruplandırılır. Klasörler, uygulamanın kökündeki bir Görünümler klasöründe depolanır: 

> M Controllers 

> Data 

> Models 

> Services 
a Ü Views 

> M Account 
a Û Home 

0 About.cshtml 
0 Contact.cshtml 
0 lndex.cshtml 

> M Manage 

> M Shared 

0 _Viewlmports.cshtml 
0 _ViewStart.cshtml 


Ana denetleyici, Görünümler klasörünün içindeki bir giriş klasörüyle temsil edilir. Giriş klasörü, hakkmda, 
iletişimce Dizin (giriş sayfası) Web sayfalarının görünümlerini içerir. Bir Kullanıcı bu üç Web sayfasından birini 
istediğinde, ana denetleyicideki denetleyici eylemleri, Kullanıcı için bir Web sayfası oluşturmak ve döndürmek 
için kullanılan üç görünümden hangisinin kullanıldığını tespit ediyor. 

Tutarlı Web sayfası bölümleri sağlamak ve kod tekrarlamayı azaltmak için düzenleri kullanın. Düzenler 
genellikle üstbilgiyi, gezinti ve menü öğelerini ve alt bilgisini içerir. Üst bilgi ve altbilgi genellikle birçok meta veri 
öğesi için ortak biçimlendirme ve betik ve stil varlıklarına bağlantılar içerir. Düzenler, görünümlerinizde bu ortak 
biçimlendirmeyi önlemenize yardımcı olur. 

Kısmi görünümler , görünümlerin yeniden kullanılabilir parçalarını yöneterek kod yinelemeyi azaltır. Örneğin, 
kısmi bir görünüm çeşitli görünümlerde görüntülenen bir blog web sitesinde yazar biyografi için yararlıdır. Yazar 
biyografları sıradan görünüm içeriğine sahiptir ve Web sayfasının içeriğini üretmek için kodun yürütülmesi 
gerekmez. Yazar biyografları, tek başına model bağlama tarafından kullanılabilir, bu nedenle bu içerik türü için 
kısmi bir görünüm kullanmak idealdir. 

Görünüm bileşenleri , yinelenen kodu azaltmanıza izin veren kısmi görünümlere benzerdir, ancak Web sayfasını 
işlemek için kodun sunucuda çalıştırılmasını gerektiren içeriği görüntüleme için uygundur. Görüntüleme 
bileşenleri, işlenen içerik bir Web sitesi alışveriş sepeti gibi veritabanı etkileşimi gerektirdiğinde yararlıdır. Web 
sayfası çıkışı oluşturmak için, görünüm bileşenlerini model bağlama ile sınırlı değildir. 

Görünümleri kullanmanın avantajları 

Görünümler, Kullanıcı arabirimi işaretlemesini uygulamanın diğer bölümlerinden ayırarak bir MVC 
uygulamasında kaygıların ayrılmasını sağlamaya yardımcı olur. Aşağıdaki SoC tasarımı, uygulamanızın modüler 

























olmasını sağlayarak çeşitli avantajlar sağlar: 


• Daha iyi bir şekilde düzenlendiğinden, uygulamanın bakımını daha kolay hale getirir.Görünümler genellikle 
uygulama özelliğine göre gruplandırılır. Bu, bir özellik üzerinde çalışırken ilgili görünümleri bulmayı 
kolaylaştırır. 

• Uygulamanın parçaları gevşek olarak bağlanmış. Uygulamanın görünümlerini iş mantığı ve veri erişim 
bileşenlerinden ayrı olarak oluşturup güncelleştirebilirsiniz. Uygulamanın diğer bölümlerini güncelleştirmek 
zorunda kalmadan uygulamanın görünümlerini değiştirebilirsiniz. 

• Görünümler ayrı birimler olduğundan uygulamanın kullanıcı arabirimi parçalarını test etmek daha kolay. 

• Daha iyi bir kuruluş nedeniyle, Kullanıcı arabiriminin bölümlerini yanlışlıkla tekrarlamanız daha az olabilir. 

Görünüm oluşturma 

Denetleyiciye özgü görünümler, Görünümler/fControllerName] klasöründe oluşturulur. Denetleyiciler arasında 
paylaşılan görünümler Görünümler/paylaşdan klasörüne yerleştirilir. Bir görünüm oluşturmak için yeni bir 
dosya ekleyin ve. cshtml dosya uzantısıyla ilişkili denetleyici eylemiyle aynı adı verin. Giriş denetleyicisindeki 
hakkmda eylemine karşılık gelen bir görünüm oluşturmak İçin, Görünümler/giriş klasöründe bir About. cshtml 
dosyası oluşturun: 

@{ 

ViewData["Title"] = "About"; 

} 

<h2>@ViewData["Title"].</h2> 

<h3>@ViewData["Message"]</h3> 

<p>Use this area to provide additional information.</p> 

Razor biçimlendirmesi @ simgesiyle başlar, ifadeleri C#, C# Razor kod blokları içine kod yerleştirerek küme 
ayraçları ( { ... } ) tarafından kapalı olarak ayarlayarak çalıştırın. Örneğin, yukarıda gösterilen 
viewData["Titie"] için "hakkında" atamasını inceleyin. Yalnızca @ simgesiyle bir değere başvurarak, HTML 
içindeki değerleri görüntüleyebilirsiniz. Yukarıdaki <h 2 > ve <h3> öğelerinin içeriğine bakın. 

Yukarıda gösterilen görünüm içeriği yalnızca kullanıcıya işlenmiş olan tüm Web sayfasının bir parçasıdır. 
Sayfanın düzeninin geri kalanı ve görünümün diğer yaygın yönleri diğer görünüm dosyalarında belirtilir. Daha 
fazla bilgi için Düzen konusunabakın. 

Denetleyiciler görünümleri nasıl belirler 

Görünümler genellikle eylemlerden bir ActionResulttürü olan VievvResultolarak döndürülür. Eylem yönteminiz 
doğrudan bir viewResuit oluşturup döndürebilir, ancak yaygın olarak yapılmaz. Çoğu Denetleyici 
denetleyicisindendevraldığı için, viewResuit döndürmek üzere view yardımcı yöntemini kullanmanız yeterlidir 

HomeControiier.es 

public IActionResult About() 

{ 

ViewData["Message"] = "Your application deseription page."; 
return View(); 

} 

Bu eylem döndüğünde, son bölümde gösterilen hakkmda. cshtml görünümü aşağıdaki Web sayfası olarak 
işlenir: 
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view Yardımcısı yönteminde birkaç aşırı yükleme vardır, isteğe bağlı olarak şunları belirtebilirsiniz: 

• Döndürülecek açık bir görünüm: 

return View("Orders"); 

• Görünüme geçirilecek bir model : 

return View(Orders); 

• Hem görünüm hem de model: 

return View("Orders ", Orders); 

Bulmayı görüntüle 

Bir eylem bir görünüm döndürdüğünde, görünüm bulma adlı bir işlem gerçekleşir. Bu işlem, görünüm adına 
göre hangi görünüm dosyasının kullanıldığını belirler. 

view yönteminin varsayılan davranışı ( return view(); ), çağrılan eylem yöntemiyle aynı ada sahip bir görünüm 
döndürmemelidir. Örneğin, denetleyicinin yaklaşık ActionResuit Yöntem adı. cshtmlad\\ bir görünüm dosyasını 
aramak için kullanılır, ilk olarak, çalışma zamanı görünümün Görünümler/[ControllerName] klasörüne bakar. 
Burada eşleşen bir görünüm bulamazsa, görünümün paylaşılan klasörünü arar. 

ViewResult Örtülü olarak return View(); döndürmeniz ya da görünüm adim return View("<ViewName>"); ile 
view yöntemine açıkça geçirmeniz önemlidir. Her iki durumda da, eşleşen bir görünüm dosyası için bulma 
aramalarını şu sırayla görüntüleyin: 

1. Görünümler/[ControllerName]/[ViewName]. cshtml 

2. Görünümler/paylaşılan/[ViewName], cshtml 

Görünüm adı yerine bir görünüm dosyası yolu sağlanıyor. Uygulama kökünde başlayan mutlak bir yol 
kullanılıyorsa (isteğe bağlı olarak "/" veya ile başlayan),. cshtml uzantısı belirtilmelidir: 

return View("Views/Home/About.cshtml"); 

Ayrıca,. cshtml uzantısı olmadan farklı dizinlerdeki görünümleri belirtmek için göreli bir yol da kullanabilirsiniz. 
HomeControiler içinde, Yönetim görünümlerinizin Dizin görünümünü göreli bir yol ile döndürebilirsiniz: 










































return View("../Manage/Index"); 

Benzer şekilde,önekiyle geçerli denetleyiciye özgü dizini belirtebilirsiniz: 

return View("./About"); 

Kısmi görünümler ve Görünüm bileşenleri benzer (ancak aynı) bulma mekanizmalarını kullanır. 

Özel bir ıvievvlocationgenişleticisikullanarak, görünümler uygulama içinde nasıl konumlandırılabilir varsayılan 
kuralı özelleştirebilirsiniz. 

Görünüm bulma, dosya adına göre görünüm dosyalarını bulmayı kullanır.Temeldeki dosya sistemi büyük/küçük 
harfe duyarlı ise, görünüm adları büyük olasılıkla büyük küçük harfe duyarlıdır. işletim sistemleri arasında 
uyumluluk için, denetleyici ve eylem adları ile ilişkili görünüm klasörleri ve dosya adları arasındaki büyük/küçük 
harfe eşleştirin. Büyük/küçük harfe duyarlı dosya sistemiyle çalışırken bir görünüm dosyasının bulunamadığını 
belirten bir hatayla karşılaşırsanız, istenen görünüm dosyası ile gerçek görünüm dosyası adı arasında 
büyük/küçük harf eşleştiğini doğrulayın. 

Görünümlerinizin dosya yapısını, bakım ve açıklık için denetleyiciler, Eylemler ve görünümler arasındaki ilişkileri 
yansıtacak şekilde düzenleme konusunda en iyi yöntemi izleyin. 

Verileri görünümlere geçirme 

Çeşitli yaklaşımlar kullanarak verileri görünümlere geçirin: 

• Kesin türü belirtilmiş veri: VievvModel 

• Zayıf yazılmış veriler 

o ViewData ( ViewDataAttribute ) 
o ViewBag 

Kesin tür belirtilmiş veriler (VievvModel) 

En güçlü yaklaşım, görünümde bir model türü belirtmektir. Bu model genellikle ViewModelo\arak adlandırılır. 
VievvModel türünün bir örneğini eylemden görünüme geçirirsiniz. 

Görünümü bir görünüme aktarmak için VievvModel kullanmak, görünümün tanımlayıcı tür denetlemesinin 
avantajlarından yararlanmasını sağlar. Kesin yazma (veya türü kesin belirlenmiş), her değişken ve sabitin açıkça 
tanımlanmış bir tür (örneğin, string , int veya DateTime ) olduğu anlamına gelir.Bir görünümde kullanılan 
türlerin geçerliliği derleme zamanında denetlenir. 

Visual Studio ve Visual Studio Code listesi IntelliSenseadlı bir özellik kullanılarak türü kesin belirlenmiş sınıf 
üyeleridir. VievvModel özelliklerini görmek istediğinizde, VievvModel için değişken adını ve ardından bir nokta ( 

. ) yazın. Bu, daha az hata vererek kodu daha hızlı yazmanıza yardımcı olur. 

@modei yönergesini kullanarak bir model belirtin. Modeli @Modei ile birlikte kullanın: 

@model WebApplicationl.ViewModels.Address 

<h2>Contact</h2> 

<address> 

@Model.Street<br> 

@Model.City, @Model.State @Model.PostalCode<br> 

<abbr title="Phone">P:</abbr> 425.555.0100 
</address> 


Modeli görünüme sağlamak için, denetleyici bu parametreyi bir parametre olarak geçirir: 



















public IActionResult Contact() 

{ 

ViewData["Message"] = "Your contact page."; 

var viewModel = new Address() 

{ 

Name = "Microsoft ", 

Street = "One Microsoft l/Jay", 

City = "Redmond"j 
State = "WA", 

PostalCode = "98052-6399" 

}; 

return View(viewModel); 

} 

Bir görünüme sağlayabilmeniz için model türlerinde hiçbir kısıtlama yoktur. Basit eski CLR nesnesi (POCO) 
vievvmodeller için çok az veya hiç davranış (Yöntem) tanımlanmış olarak kullanılması önerilir. Genellikle 
VievvModel sınıfları, uygulamanın kökündeki modeller klasöründe veya ayrı bir viewmodeller klasöründe 
depolanır. Yukarıdaki örnekte kullanılan Adres vievvmodel, Address.csadU bir dosyada depolanan bir poco 
VievvModel modelidir: 

namespace WebApplicationl.ViewModels 
{ 

public class Address 
{ 

public string Name { get; set; } 
public string Street { get; set; } 
public string City { get; set; } 
public string State { get; set; } 
public string PostalCode { get; set; } 

} 

} 

Hiçbir şey, hem VievvModel türleriniz hem de iş modeli türleriniz için aynı sınıfları kullanmanızı önler.Ancak, ayrı 
modeller kullanmak görünümlerinizin, uygulamanızın iş mantığı ve veri erişimi bölümlerinden bağımsız olarak 
değişiklik yapmasına izin verir. Modeller ve VievvModel ayrımı, modeller Kullanıcı tarafından uygulamaya 
gönderilen veriler için model bağlama ve doğrulama kullanırken de güvenlik avantajları sağlar. 

Zayıf yazılmış veriler (VievvData, VievvData özniteliği ve VievvBag) 

viewBag Razor Pages kullamlamaz. 

Türü kesin belirlenmiş görünümlere ek olarak, görünümler, verilerin b\r zayıf türü olan ( gevşek olarak yazılmış) 
bir veri koleksiyonu erişimi vardır. Güçlü türlerin aksine, zayıf türler (veya gevşek türler), kullanmakta olduğunuz 
veri türünü açıkça bildirmeyeceğiniz anlamına gelir. Denetleyicilerde ve görünümlerde küçük miktarlarda veri 
iletmek için zayıf yazılmış verilerin toplanmasını kullanabilirsiniz. 

VERİLERİ BİR... ARASINDA GEÇİRME ÖRNEK 

Denetleyici ve görünüm Açılan listeyi verilerle doldurma. 

Görünüm ve Düzen görünümü cbaşlığını bir görünüm dosyasındaki düzen görünümünde 

> öğe içeriğini ayarlama. 

Kısmi görünüm ve görünüm Kullanıcı tarafından istenen vveb sayfasını temel alan verileri 

görüntüleyen pencere öğesi. 


Bu koleksiyona, denetleyiciler ve görünümlerde viewData yada viewBag özellikleri aracılığıyla başvurulabilir. 













viewData özelliği, Zayıf yazılmış nesnelerin bir sözlüğüdür. viewBag özelliği, temel viewData koleksiyonu için 
dinamik özellikler sağlayan viewData çevresindeki bir sarmalayıcıdır. Note: anahtar aramaları hem viewData 
hem de viewBag için büyük/küçük harfe duyarsızdır. 

viewData ve viewBag , çalışma zamanında dinamik olarak çözümlenir. Derleme zamanı tür denetimi sunmadığı 
için, her ikisi de bir VievvModel kullanmaktan daha fazla hataya açıktır. Bu nedenle, bazı geliştiriciler viewData 
ve viewBag en düşük düzeyde bir süre önce kullanmaz veya hiç kullanmayın. 

VievvData 


viewData , string anahtarlar aracılığıyla erişilen bir VievvDataDictionary nesnesidir. Dize verileri doğrudan bir 
dönüştürme gerektirmeden depolanabilir ve kullanılabilir, ancak diğer viewData nesne değerlerini 
ayıkladığınızda belirli türlere atamaksınız. viewData kullanarak, kısmen görünümler ve düzenlerdahil olmak 
üzere denetleyicilerden görünümlere ve görünümlere veri geçirebilirsiniz. 

Aşağıda, bir bir eylem içinde viewData kullanarak bir selamlama ve adres değerlerini ayarlayan bir örnek 
verilmiştir: 

public IActionResult SomeAction() 

{ 

ViewData["Greeting"] = "Hello"; 

ViewData["Address"] = new Address() 

{ 

Name = "Steve", 

Street = "123 Main St", 

City = "Hudson", 

State = "OH ", 

PostalCode = "44236" 

}; 

return View(); 


Bir görünümdeki verilerle çalışın: 

@{ 

// Since Address isn't a string, it requires a cast. 
var address = ViewData["Address"] as Address; 

} 

@ViewData["Greeting"] WorldI 

<address> 

@address.Name<br> 

@address.Street<br> 

(Şaddress.City, @address.State @address.PostalCode 
</address> 


ViewData özniteliği 

VievvDataDictionary ' i kullanan başka bir yaklaşım da vievvdataattribute. [viewData] özniteliğiyle işaretlenmiş 
denetleyiciler veya Razor sayfa modelleriyle ilgili özellikler, değerlerinin depolandığı ve sözlükten yüklendiği 
değerlerdir. 

Aşağıdaki örnekte, giriş denetleyicisi [viewData] işaretli bir Title özelliği içerir. About yöntemi, hakkında bilgi 
görünümü için başlığı ayarlar: 


























public class HomeController : Controller 

{ 

[ViewData] 

public string Title { get; set; } 

public IActionResult About() 

{ 

Title = "About Us"; 

ViewData["Message"] = "Your application description page."; 
return View(); 

} 

} 

Hakkında görünümünde, Title özelliğine model özelliği olarak erişin: 

<hl>@Model.Title</hl> 


Mizanpajda, başlık VievvData sözlüğünden okundu: 

<!DOCTYPE html> 

<html lang="en"> 

<head> 

<title>@ViewData["Title"] - WebApplication</title> 


ViewBag 

viewBag Razor Pages kullandamaz. 

viewBag , viewData depolanan nesnelere dinamik erişim sağlayan bir Dynamicvievvdata nesnesidir. viewBag , 
atama gerektirmediğinden, ile çalışmak daha uygun olabilir. Aşağıdaki örnek, yukarıdaki viewData kullanmayla 
aynı sonuçla viewBag nasıl kullanacağınızı gösterir: 

public IActionResult SomeAction() 

{ 

ViewBag.Greeting = "Hello"; 

ViewBag.Address = new Address() 

{ 

Name = "Steve", 

Street = "123 Main St"j 
City = "Hudson"j 
State = "OH", 

PostalCode = "44236" 

}; 

return View(); 

} 


@ViewBag.Greeting World! 

<address> 

@ViewBag.Address.Name<br> 

@ViewBag.Address.Street<br> 

@ViewBag.Address.City, @ViewBag.Address.State @ViewBag.Address.PostalCode 
</address> 


VievvData ve VievvBag 'i aynı anda kullanma 











viewBag Razor Pages kullandamaz. 

viewData ve viewBag aynı temel viewData koleksiyonuna başvurduğundan, değerleri okurken ve yazarken 
aralarında hem viewData hem de viewBag ve karıştırma ve eşleştirme kullanabilirsiniz. 

Bir About. cshtml görünümünün en üstündeki viewData kullanarak viewBag ve açıklamayı kullanarak başlığı 
ayarlayın: 

@{ 

Layout = "/Views/Shared/_Layout.cshtml"; 

ViewBag.Title = "About Contoso"; 

ViewData["Description"] = "Let us teli you about Contoso's philosophy and mission."; 

} 

Özellikleri okuyun, ancak viewData ve viewBag kullanımını ters çevirin. _Layout. cshtml dosyasında, viewData 
kullanarak başlığı alın ve viewBag kullanarak açıklamayı alın: 

<!DOCTYPE html> 

<html lang="en"> 

<head> 

<tltle>@ViewData["Title"]</title> 

<meta name="description" content="@ViewBag.Description"> 

Dizelerin viewData için bir dönüştürme gerektirmemenizi unutmayın. @viewData["Titie"] , atama olmadan 
kullanabilirsiniz. 

Hem viewData hem de viewBag aynı anda kullanmak, özellikleri karıştırarak ve eşleştirirken de geçerlidir. 
Aşağıdaki biçimlendirme işlenir: 

<!DOCTYPE html> 

<html lang="en"> 

<head> 

<title>About Contoso</title> 

<meta name="description" content="Let us teli you about Contoso's philosophy and mission."> 

VievvData ve VievvBag arasındaki farkların Özeti 

viewBag Razor Pages yok. 

• ViewData 

o ViewDataDictionaryöğesinden türetilir, bu nedenle containsKey , Add , Remove ve ciear gibi yararlı 
olabilecek Sözlük özellikleri vardır. 

o Sözlükteki anahtarlar dizelerdir, bu nedenle boşluğa izin verilir.Örnek: 

ViewData["Some Key With Whitespace"] 

o string dışında herhangi bir tür viewData kullanmak için görünümde tür dönüştürme yapılmalıdır. 

• ViewBag 

o Dynamicviewdataöğesinden türetilir, bu nedenle, nokta gösterimini ( 

@viewBag.someKey = <vaiue or object> ) kullanarak dinamik özellikler oluşturulmasına izin verir ve 
hiçbir atama gerekmez. viewBag söz dizimi, denetleyicilere ve görünümlere daha hızlı eklemenizi 
sağlar. 

o Null değerleri denetlemek için daha basittir.Örnek: @viewBag.Person?.ı\iame 


VievvData veya VievvBag ne zaman kullanılır? 
































Hem viewData hem de viewBag , denetleyiciler ve görünümler arasında küçük miktarlarda veri iletmek için eşit 
ölçüde geçerli yaklaşımlar. Hangisinin kullanılacağı seçimi tercihi temel alır. viewData ve viewBag nesneleri 
karıştırıp eşleştirebilirsiniz, ancak kod, sürekli olarak kullanılan tek bir yaklaşımla daha kolay okunabilir ve 
devam edebilir. Her iki yaklaşım da çalışma zamanında dinamik olarak çözümlenir ve bu nedenle çalışma 
zamanı hatalarına neden olur. Bazı geliştirme ekipleri bunlardan kaçınır. 

Dinamik Görünümler 

@modei kullanarak bir model türü bildirmeyen ancak bunlara bir model örneği geçirmeyen görünümler 
(örneğin, return view(Address); ), örnek özelliklerine dinamik olarak başvurabilir: 

<address> 

@Model.Street<br> 

@Model.City, @Model.State @Model.PostalCode<br> 

<abbr title="Phone">P:</abbr> 425.555.0100 
</address> 

Bu özellik esneklik sunar, ancak derleme koruması veya IntelliSense sunmaz.Özellik yoksa, Web sayfası 
oluşturma çalışma zamanında başarısız olur. 

Daha fazla görünüm özelliği 

Etiket Yardımcıları , var olan HTM L etiketlerine sunucu tarafı davranışı eklemenizi kolaylaştırır. Etiket 
yardımcılarının kullanılması, görünümleriniz içinde özel kod veya yardımcılar yazma ihtiyacını önler. Etiket 
Yardımcıları HTM L öğelerine öznitelikler olarak uygulanır ve bunları işleyeamayan düzenleyiciler tarafından yok 
sayılır. Bu, çeşitli araçlarındaki görünüm işaretlemesini düzenlemenizi ve işlemeyi sağlar. 

Özel HTML işaretlemesi oluşturmak birçok yerleşik HTML Yardımcıda sağlanabilir. Daha karmaşık kullanıcı 
arabirimi mantığı, Görünüm bileşenleritarafından işlenebilir. Görüntüleme bileşenleri, denetleyiciler ve 
görünümler tarafından sunulan aynı SoC öğesine sahiptir. Ortak kullanıcı arabirimi öğeleri tarafından kullanılan 
verilerle ilgili eylemler ve görünümler gereksinimini ortadan kaldırabilir. 

AS P.N ET Core diğer birçok yönü gibi, görünümler bağımlılık eklemeişlemini destekler ve hizmetlerin 
görünümlereeklenmesine izin verir. 

















ASPNET Core kısmi görünümler 
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Steve Smith, Luke Latham, madan Jendoubı, Rick Andersonve Scott Sauber tarafından 

Kısmi görünüm , başka bir biçimlendirme dosyasının işlenmiş ÇıKTıSıNDAKI HTML çıkışını İşleyen bir Razor 
biçimlendirme dosyasıdır (. cshtml). 

Kısmi görünüm terimi, biçimlendirme dosyaları Görünümlerolarak adlandırılan bir MVC uygulaması veya 
biçimlendirme dosyalarının Sayfala rolarak adlandırıldığını Razor Pages bir uygulama geliştirirken kullanılır. 
Bu konu, MVC görünümlerini ve Razor Pages sayfalarını biçimlendirme dosyo/onolarak gösterir. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Kısmi görünümlerin ne zaman kullanılacağı 

Kısmi görünümler şu şekilde etkili bir yoldur: 

• Büyük biçimlendirme dosyalarını daha küçük bileşenlere bölün. 

Birkaç mantıksal parçadan oluşan büyük, karmaşık bir biçimlendirme dosyasında, her bir parçada 
kısmi bir görünümde yalıtılmış olarak çalışmanın bir avantajı vardır. Biçimlendirme dosyasındaki kod, 
biçimlendirme yalnızca genel sayfa yapısını ve kısmi görünümlere yönelik başvuruları içerdiğinden 
yönetilebilir. 

• Biçimlendirme dosyaları arasında ortak biçimlendirme içeriğinin çoğaltılmasını azaltın. 

Biçimlendirme dosyalarında aynı biçimlendirme öğeleri kullanıldığında, kısmi bir görünüm 
biçimlendirme içeriğinin tek bir kısmi görünüm dosyasına çoğaltılmasını kaldırır. Kısmi görünümdeki 
biçimlendirme değiştirildiğinde, kısmi görünümü kullanan biçimlendirme dosyalarının işlenmiş çıkışını 
günceller. 

Yaygın düzen öğelerini korumak için kısmi görünümler kullanılmamalıdır. ^Layout. cshtml dosyalarında ortak 
düzen öğeleri belirtilmelidir. 

Biçimlendirmeyi işlemek için karmaşık işleme mantığının veya kod yürütmenin gerekli olduğu kısmi bir 
görünüm kullanmayın. Kısmi bir görünüm yerine bir Görünüm bileşenikullanın. 

Kısmi görünümler bildirme 

Kısmi görünüm, Görünümler klasörü (MVC) veya sayfalar klasörü (Razor Pages) içinde tutulan bir. cshtml 
biçimlendirme dosyasıdır. 

ASP.NET Core MVC 'de, denetleyici VievvResult bir görünüm veya kısmi görünüm döndürmektedir. Razor 
Pages, bir PageModel PartialVievvResult nesnesi olarak temsil edilen kısmi bir görünüm döndürebilir. Kısmi 
görünümlere başvurmak ve işlemek kısmi görünüm başvurusu bölümünde açıklanmaktadır. 

MVC görünümü veya sayfa işleme farklı olarak, kısmi bir görünüm _Viewstart. cshtmlça\ışt\rmaz._Viewstart. 
csfjfm/hakkında daha fazla bilgi için bkz AS P.N ET Core düzen. 

Kısmi görünüm dosya adları genellikle bir alt çizgi ( _ ) ile başlar. Bu adlandırma kuralı gerekli değildir, ancak 
görünüm ve sayfalardan kısmi görünümleri görsel açıdan ayırt etmeye yardımcı olur. 

Kısmi görünüm, Görünümler klasörü içinde tutulan bir. cshtml biçimlendirme dosyasıdır. 






























Denetleyicinin bir görünüm VievvResult veya kısmi görünüm döndürme özelliği vardır. Kısmi görünümlere 
başvurmak ve işlemek kısmi görünüm başvurusu bölümünde açıklanmaktadır. 

MVC görünüm işlemenin aksine, kısmi bir görünüm _Viewstart. cs/?fm/çalıştırmaz._ Viewstart. 
cshfm/hakkında daha fazla bilgi için bkz AS P.N ET Core düzen. 

Kısmi görünüm dosya adları genellikle bir alt çizgi ( _ ) ile başlar. Bu adlandırma kuralı gerekli değildir, ancak 
kısmen görünümlerini görünümlerde görsel açıdan ayırt etmeye yardımcı olur. 

Kısmi görünüme başvur 

Razor Pages PageModel içinde kısmi bir görünüm kullanma 

ASP.NET Core 2,0 veya 2,1 ' de, aşağıdaki işleyici yöntemi _authorpartialrp. cshtml kısmi görünümünü yanıta 
işler: 

public IActionResult OnGetPartial() => 
new PartialViewResult 
{ 

ViewName = "_AuthorPartialRP", 

ViewData = ViewData, 

}; 

ASP.NET Core 2,2 veya sonraki sürümlerde, bir işleyici yöntemi alternatif olarak bir Partial 
PartiaiviewResuit nesnesi oluşturmak için yöntemini çağırabilir: 

public IActionResult OnGetPartial() => 

Partial("_AuthorPartialRP"); 

Biçimlendirme dosyasında kısmi görünüm kullanma 

Bir biçimlendirme dosyasında kısmi bir görünüme başvurmak için birkaç yol vardır. Uygulamaların aşağıdaki 
zaman uyumsuz işleme yaklaşımlardan birini kullanmasını öneririz: 

• Kısmi Etiket Yardımcısı 

• Zaman uyumsuz HTML Yardımcısı 

Bir biçimlendirme dosyasında, kısmi bir görünüme başvurmak için iki yol vardır: 

• Zaman uyumsuz HTML Yardımcısı 

• Zaman uyumlu HTML Yardımcısı 

Uygulamaların zaman uyumsuz HTML yardımcısınıkullanmasını öneririz. 

Kısmi etiket Yardımcısı 

Kısmi etiket yardımcısı ASP.NET Core 2,1 veya sonraki bir sürümü gerektirir. 

Kısmi etiket Yardımcısı içeriği zaman uyumsuz olarak işler ve HTML benzeri bir sözdizimi kullanır: 

<partial name="_PartialName" /> 

Bir dosya uzantısı mevcut olduğunda, etiket Yardımcısı kısmi görünümü çağıran biçimlendirme dosyasıyla 
aynı klasörde olması gereken kısmi bir görünüme başvurur: 

<partial name="_PartialName.cshtml" /> 













Aşağıdaki örnek, uygulama kökünden kısmi bir görünüme başvurur. Bir tilde işareti ( ~/ ) veya eğik çizgi ( / ) 
ile başlayan yollar uygulama köküne başvurur: 

Razor Sayfaları 

<partial name="~/Pages/Folder/_PartialName.cshtml" /> 

<partial name="/Pages/Folder/_PartialName.cshtml" /> 


MVC 


<partial name="~/Views/Folder/_PartialName.cshtml" /> 
<partial name="/Views/Folder/_PartialName.cshtml" /> 


Aşağıdaki örnek, göreli bir yol ile kısmi bir görünüme başvurur: 

<partial name="../Account/_PartialName.cshtml" /> 


Daha fazla bilgi için bkz. AS P.N ET Core kısmi etiket Yardımcısı. 

Zaman uyumsuz HTML Yardımcısı 

Bir HTML Yardımcısı kullanırken en iyi yöntem Partial Asynckullanılır. PartialAsync içinde Sarmalanan bir 
IHtmlContent tür döndürür. Task<TResult> Yöntemine, beklenen çağrının bir @ karakterle önek olarak 
eklenerek başvurulur: 

@await Html.PartialAsync("_PartialName") 

Dosya uzantısı varsa, HTML Yardımcısı kısmi görünümü çağıran biçimlendirme dosyasıyla aynı klasörde 
olması gereken kısmi bir görünüme başvurur: 

@await Html.PartialAsync("_PartialName.cshtml") 

Aşağıdaki örnek, uygulama kökünden kısmi bir görünüme başvurur. Bir tilde işareti ( ~/ ) veya eğik çizgi ( / ) 
ile başlayan yollar uygulama köküne başvurur: 

Razor Sayfaları 

@await Html.PartialAsync("~/Pages/Folder/_PartialName.cshtml") 

@await Html.PartialAsync("/Pages/Folder/_Part ialName.es html") 

MVC 

@await Html.PartialAsync("~/Views/Folder/_PartialName.cshtml") 

@await Html.PartialAsync("/Views/Folder/_PartialName.cshtml") 

Aşağıdaki örnek, göreli bir yol ile kısmi bir görünüme başvurur: 

@await Html.PartialAsync("../Account/_LoginPartial.cshtml") 

Alternatif olarak, ile RenderPartialAsynckısmi bir görünüm işleyebilirsiniz. Bu yöntem bir 
IHtmlContentdöndürmez. işlenmiş çıktıyı doğrudan yanıta akıp. Yöntem bir sonuç döndürmediği için, bir 
Razor kod bloğu içinde çağrılmalıdır: 













@{ 

await Html.RenderPartialAsync("_AuthorPartial"); 

} 

RendenPartiaiAsync , içeriği oluşturduğundan, bazı senaryolarda daha iyi performans sağlar. Performans 
açısından kritik durumlarda, her iki yaklaşımı kullanarak sayfayı kıyaslar ve daha hızlı bir yanıt üreten 
yaklaşımı kullanır. 

Zaman uyumlu HTML Yardımcısı 

Partialve sırasıyla zaman uyumlu RenderPartialAsync PartialAsync RenderPartial eşdeğerlerdir. Zaman 
uyumlu eşdeğerleri, kilitlendikleri senaryolar olduğu için önerilmez. Zaman uyumlu yöntemler gelecek 
sürümlerde kaldırılmak üzere hedeflenmiştir. 


IMPORTANT 

Kodu yürütmeniz gerekiyorsa, kısmi bir görünüm yerine bir Görünüm bileşeni kullanın. 


Bir Partial Visual RenderPartial Studio Çözümleyicisi uyarısıyla çağırma veya sonuç. Örneğin, varlığı 
Partial aşağıdaki uyarı iletisini verir: 

Ihtmlhelper. Partial kullanımı uygulama kilitlenmeleri oluşmasına neden olabilir.<Kısmi> etiket 
Yardımcısı veya ıhtmlhelper. partıalasync kullanmayı düşünün. 

Çağrıları @Htmi.Partial ile veya kısmi etiket Yardımcısıile @await Html.PartialAsync değiştirin. Kısmi etiket 
Yardımcısı geçişi hakkında daha fazla bilgi için bkz. HTML Yardımcısı 'Ndan geçiş. 

Kısmi görünüm bulma 

Bir dosya uzantısı olmayan kısmi bir görünüme ad ile başvurulduğunda, aşağıdaki konumlar belirtilen sırada 
aranır: 

Razor Sayfaları 

1. Şu anda sayfanın klasörü yürütülüyor 

2. Sayfanın klasörünün üzerindeki Dizin grafiği 

3. 

4. 

5. 

MVC 

1. /Areas/<Area-Name>/Views/<Controller-Name> 

2. /Areas/<Area-Name>/Views/Shared 

3. /Views/Shared 

4. /Pages/Shared 

1. /Areas/<Area-Name>/Views/<Controller-Name> 

2. /Areas/<Area-Name>/Views/Shared 

3. /Views/Shared 

Kısmi görünüm bulma için aşağıdaki kurallar geçerlidir: 

• Kısmi görünümler farklı klasörlerde olduğunda aynı dosya adına sahip farklı kısmi görünümlere izin verilir. 


/Shared 

/Pages/Shared 

/Views/Shared 















• Dosya uzantısı olmadan kısmi bir görünüme ada göre başvurulması ve kısmi görünümün hem arayanın 
klasöründe hem de paylaşılan klasörde mevcut olması halinde, çağıranın klasöründeki kısmi görünüm 
kısmi görünümü sağlar. Kısmi görünüm çağıranın klasöründe yoksa, kısmi görünüm paylaşılan klasörden 
sağlanır. Paylaşılan klasördeki kısmi görünümler, paylaşılan kısmi görünümler veya varsayılan kısmi 
görünümlero\arak adlandırılır. 

• Kısmi Görünümler zincirleme —olabilir kısmi görünüm, çağrılar tarafından bir döngüsel başvuru 
oluşturulmadığı durumlarda başka bir kısmi görünümü çağırabilir. Göreli yollar her zaman geçerli dosyaya 
göredir, dosyanın köküne veya üst öğesine göre değil. 


NOTE 

Kısmi görünümde tanımlanan bir Razor section , üst biçimlendirme dosyaları için görünmez değildir, section 
Yalnızca tanımlandığı kısmi görünüm için görülebilir. 


Kısmi görünümlerde verilere erişin 

Kısmi bir görünüm örneği oluşturulduğunda, üst öğenin viewData sözlüğünün bir kopyasını alır. Kısmi 
görünüm içindeki verilerde yapılan güncelleştirmeler üst görünümde kalıcı değildir. viewData kısmi görünüm 
geri döndüğünde kısmi görünümdeki değişiklikler kaybolur. 

Aşağıdaki örnek, bir VievvDataDictionary örneğinin kısmi bir görünüme nasıl geçirileceğini göstermektedir: 

@await Html.PartialAsync("_PartialName", customViewData) 

Bir modeli kısmi bir görünüme geçirebilirsiniz. Model özel bir nesne olabilir. Bir modeli ile PartialAsync 
geçirebilirsiniz (bir içerik bloğunu çağırana kaydedebilir) veya RenderPartialAsync (içeriği çıkışa akıp): 

@await Html.PartialAsync("_PartialName", model) 

Razor Sayfaları 

Örnek uygulamada aşağıdaki biçimlendirme, Pages/ArticlesRP/ReadRP. cshtml sayfasından yapılır. Sayfada iki 
kısmi görünüm bulunur, ikinci kısmi görünüm bir modelde ve viewData kısmi görünüme geçer. Oluşturucu 
aşırı yüklemesi, var olan viewData sözlüğü korurken yeni viewData bir sözlüğü geçirmek için kullanılır. 
ViewDataDictionary 































@model ReadRPModel 
<h2>@Model.Artiçle.Title</h2> 

@* Pass the author’s name to Pages\Shared\_AuthorPartialRP.cshtml *@ 

@await Html.PartialAsync("../Shared/_AuthorPartialRP", Model.Artiçle.AuthorName) 
@Model.Artiçle.PublicationDate 

@* Loop över the Sections and pass in a section and additional ViewData to 

the strongly typed Pages\ArticlesRP\_ArticleSectionRP.cshtml partial view. *@ 

@{ 

var index = 0; 

foreach (var section in Model.Article.Sections) 

{ 

await Html.PartialAsync("_ArticleSectionRP", 
section., 

new ViewDataDictionary(ViewData) 

{ 

{ "index", index } 

}); 

index++; 

} 

} 


Pages/Shared/^AuthorPartialRP. cshtml, readrp. cshtml işaretleme dosyası tarafından başvurulan ilk kısmi 
görünümüdür: 

@model string 
<div> 

<h3>@Model</h3> 

This partial view from /Pages/Shared/_AuthorPartialRP.cshtml. 

</div> 


Pages/ArticlesRP/_ArticleSectionRP. cshtml, readrp. cshtml biçimlendirme dosyası tarafından başvurulan 
ikinci kısmi görünümüdür: 

@using PartialViewsSample.ViewModels 
@model ArticleSection 

<h3>@Model.Title Index: @ViewData["index"]</h3> 

<div> 

@Model.Content 

</div> 


MVC 

Örnek uygulamada aşağıdaki biçimlendirme görünümleri/makaleleri/Read. cshtml görünümünü gösterir. 
Görünüm iki kısmi görünüm içerir, ikinci kısmi görünüm bir modelde ve viewData kısmi görünüme geçer. 
Oluşturucu aşırı yüklemesi, var olan viewData sözlüğü korurken yeni viewData bir sözlüğü geçirmek için 
kullanılır. ViewDataDictionany 

















@model PartialViewsSample.ViewModels.Artiçle 
<h2>@Model.Title</h2> 

@* Pass the author’s name to Views\Shared\_AuthorPartial.cshtml *@ 

@await Html.PartialAsync("_AuthorPartial", Model.AuthorName) 

@Model.PublicationDate 

@* Loop över the Sections and pass in a section and additional ViewData to 
the strongly typed Views\Articles\_ArticleSection.cshtml partial view. *@ 

@{ 

var index = 0; 

foreach (var section in Model.Sections) 

{ 

await Html. PartialAsync("_ArticleSection ", 
section., 

new ViewDataDictionary(ViewData) 

{ 

{ "index", index } 

}); 

index++; 

} 

} 


Vlews/Shared/_AuthorPartial. cshtml, Read. cshtml biçimlendirme dosyası tarafından başvurulan ilk kısmi 
görünümdür: 

@model string 
<div> 

<h3>@Model</h3> 

This partial view from /Views/Shared/_AuthorPartial.cshtml. 

</div> 


Görünümler/makaleler/_Art'ıdeSect'ıon. cshtml, Read. cshtml biçimlendirme dosyası tarafından başvurulan 
ikinci kısmi görünümdür: 

@using PartialViewsSample.ViewModels 
@model ArticleSection 

<h3>@Model.Title Index: @ViewData["index"]</h3> 

<div> 

@Model.Content 

</div> 


Çalışma zamanında, partiler, kendisini paylaşılan_/.oyouf. csfrfm/içinde işlenen üst biçimlendirme dosyasının 
işlenmiş çıktısına işlenir. İlk kısmi görünüm, makalenin adını ve yayımlama tarihini işler: 

Abrayhelincoln 

<Paylaşılan kısmi görünüm dosyası yolundan>bu kısmi görünüm. 11/19/1863 12:00:00 


ikinci kısmi görünüm, makalenin bölümlerini işler: 
Bölüm bir dizin: 0 
Dört puan ve yedi yıl önce... 


Bölüm İki Dizin: 1. 












Artık harika bir hukuki War, test ediyor... 
Bölüm üç Dizin: 2 

Ancak, daha büyük bir fikir için ayıramıyoruz... 

Ek kaynaklar 

• ASP.NET Core Razor söz dizimi başvurusu 

• ASP.NET Core etiket yardımcıları 

• AS P.N ET Core kısmi etiket Yardımcısı 

• ASP.NET Core bileşenleri görüntüleme 

• ASP.NET Core bölgeler 

• ASP.NET Core Razor söz dizimi başvurusu 

• ASP.NET Core bileşenleri görüntüleme 

• ASP.NET Core bölgeler 




ASPNET Core MVC 'de denetleyicilerle istekleri 
işleme 

6.12.2019 • 9 minutes to read ı Edit Online 


Tarafından Steve Smith ve Scott Addie 

Denetleyiciler, Eylemler ve eylem sonuçları, geliştiricilerin ASP.NET Core MVC kullanarak uygulama oluşturma 
konusunda temel bir parçasıdır. 

Denetleyici nedir? 

Bir denetleyici, bir dizi eylemi tanımlamak ve gruplandırmak için kullanılır. Bir eylem (veya eylem yöntemi), bir 
denetleyicide istekleri işleyen bir yöntemdir. Denetleyiciler benzer eylemleri birlikte mantıksal olarak gruplayın. 
Bu eylemlerin toplamı, yönlendirme, önbelleğe alma ve yetkilendirme gibi ortak kural kümelerinin toplu olarak 
uygulanmasını sağlar, istekler, yönlendirmearacılığıyla eylemlerle eşleştirilir. 

Kurala göre, denetleyici sınıfları: 

• Projenin kök düzeyi denetleyiciler klasöründe bulunur. 

• Microsoft.AspNetCore.Mvc.Controiler 'den devralma. 

Denetleyici, aşağıdaki koşullardan en az birinin doğru olduğu bir instantiable sınıfıdır: 

• Sınıf adı controiler ile Sonya düzeltildi. 

• Sınıfı, adı controiler sonındaki bir sınıftan devralır. 

• [Controiler] özniteliği sınıfa uygulanır. 

Denetleyici sınıfı ilişkili bir [NonControiler] özniteliğine sahip olmamalıdır. 

Denetleyiciler Açık bağımlılıklar il keşi nı izlemelidir. Bu ilkeyi uygulamak için birkaç yaklaşım vardır.Birden çok 
denetleyici eylemi aynı hizmeti gerektiriyorsa, bu bağımlılıkları istemek için Oluşturucu Ekleme kullanmayı 
düşünün. Hizmet yalnızca tek bir eylem yöntemiyle gerekliyse, bağımlılığı istemek için eylem ekleme işlemini 
kullanmayı düşünün. 

Model-VIEVV-Controller düzeninde bir denetleyici, modelin istek ve örneklemesinin ilk işlemeden sorumludur. 
Genellikle, iş kararları model içinde gerçekleştirilmelidir. 

Denetleyici, modelin işleme sonucunu alır (varsa) ve uygun görünümü ve ilgili görünüm verilerini ya da API 
çağrısının sonucunu döndürür. ASP.NET Core MVC 'ye genel bakış ve ASP.NET Core MVC ve Visual Studio ile 
çalışmaya başlamahakkında daha fazla bilgi edinin. 

Denetleyici bir Ul düzeyi soyutlamadır. Sorumlulukları, istek verilerinin geçerli olduğundan ve hangi görünümün 
(ya da bir API 'nin sonucunun) döndürüldüğünden emin sağlamaktır, iyi şekilde uyumlu olmayan 
uygulamalarda, doğrudan veri erişimi veya iş mantığı dahil değildir. Bunun yerine, denetleyici bu sorumlulukları 
işleyen hizmetlere temsilci seçer. 

Eylemleri tanımlama 

Bir denetleyicide, [NonAction] özniteliği olanlar hariç genel yöntemler eylemlerdir. Eylemlerdeki Parametreler 
istek verilerine bağlıdır ve model bağlamakullanılarak onaylanır. Model-bağlantılı her şey için model 
doğrulaması oluşur. Modeistate.isValid özelliği değeri, model bağlamanın ve doğrulamanın başarılı olup 
olmadığını gösterir. 











Eylem yöntemleri bir sorunu iş açısından eşlemek için mantık içermelidir, iş kaygıları genellikle denetleyicinin 
bağımlılık eklemeyoluyla eriştiği hizmetler olarak temsil edilmelidir. Eylemler daha sonra iş eyleminin sonucunu 
bir uygulama durumuna eşler. 

Eylemler her şeyi döndürebilir, ancak bir yanıt üreten iActionResuit (veya zaman uyumsuz metotlar için 
Task<iActionResuit> ) bir örneğini döndürür. Eylem yöntemi, ne tür bir yomtseçmekten sorumludur. Eylem 
sonucu Yonıtverir. 

Denetleyici Yardımcısı yöntemleri 

Denetleyiciler genellikle denetleyicidendevralınır, ancak bu gerekli değildir, Controiler türetmek, üç yardımcı 
yöntem kategorisine erişim sağlar: 

1. Yöntemler boş bir yanıt gövdesine yol açar 

Yanıt gövdesinde betimleyen içerik olmadığından Content-Type HTTP yanıt üst bilgisi dahil değildir. 

Bu kategori içinde iki sonuç türü vardır: Redirect ve HTTP durum kodu. 

• HTTP durum kodu 

Bu tür bir HTTP durum kodu döndürür. Bu türden birkaç yardımcı yöntem BadRequest , NotFound ve ok . 


return BadRequest(); 

yürütüldüğünde 400 durum kodu üretir. 

BadRequest , 

NotFound 

ve Ok 


gibi yöntemler aşırı yüklendiğinde, içerik anlaşması gerçekleşdiğinden artık HTTP durum kodu 
Yanıtlayıcıları olarak niteleyemez. 

• Meniz 

Bu tür bir eyleme veya hedefe yeniden yönlendirme döndürür ( Redirect , LocaiRedirect , 

RedirectToAction veya RedirectToRoute kullanarak). Örneğin, Complete bir anonim nesne geçirerek 
return RedirectToAction("Complete", new {id = 123}); yeniden yönlendirir. 

Yeniden yönlendirme sonuç türü, birincil olarak Location HTTP yanıt üst bilgisi ekleme içindeki HTTP 
durum kodu türünden farklıdır. 

2. Yöntemler, önceden tanımlanmış bir içerik türüyle boş olmayan bir yanıt gövdesine yol açar 

Bu kategorideki birçok yardımcı yöntem bir contentType özelliği içerir ve bu da yanıt gövdesini tanımlayacak 
Content-Type yanıt üst bilgisini ayarlamanıza olanak sağlar. 

Bu kategori içinde iki sonuç türü vardır: görüntüleme ve biçimli yanıt. 

• Görünümü 

Bu tür, HTML işlemek için bir model kullanan bir görünüm döndürür.Örneğin return view(customer); , 
veri bağlama için bir modeli bir modele geçirir. 

• Biçimlendirilen yanıt 

Bu tür, bir nesneyi belirli bir şekilde göstermek için JSON veya benzer bir veri değişimi biçimi döndürür. 
Örneğin, return Json(customer); , belirtilen nesneyi JSON biçimine dizleştirir. 

Bu türün diğer yaygın yöntemleri File ve PhysicaiFile içerir. Örneğin, 
return PhysicalFile(customerFilePathj "text/xml"); PhysicalfileresultdÖndÜrÜr. 

3. Yöntemler, istemci ile anlaşan bir içerik türünde biçimlendirilen boş olmayan bir yanıt gövdesinin oluşmasına neden olur 

Bu kategori, İçerik anlaşmasıolarak daha iyi bilinir, içerik anlaşması, bir eylem bir ObjectResult türü ya da 
lactionresult uygulaması dışında bir şey döndürdüğünde geçerlidir. iActionResuit olmayan bir uygulama 
döndüren bir eylem (örneğin, object ), aynı zamanda biçimli bir yanıt döndürür. 

Bu türden bazı yardımcı yöntemler BadRequest , createdAtRoute ve ok içerir. Bu yöntemlere örnek olarak 
sırasıyla return BadRequest(modelState); , return CreatedAtRoute("routename", values, newobject); ve 





















return ok(vaiue); verilebilir. BadRequest ve ok yalnızca bir değer geçirildiğinde içerik anlaşması 
gerçekleştirdiğine unutmayın; bir değer geçirilmeden, bunun yerine HTTP durum kodu sonuç türleri olarak işlev 
görür. Diğer taraftan createdAtRoute yöntemi her zaman içerik anlaşması gerçekleştirir, çünkü aşırı 
yüklemelerinin hepsi bir değer geçirilmesini gerektirir. 

Çapraz kesme konuları 

Uygulamalar genellikle iş akışının parçalarını paylaşır.Örnek olarak, alışveriş sepetine erişmek için kimlik 
doğrulaması gerektiren bir uygulama veya bazı sayfalarda verileri önbelleğe alan bir uygulama verilebilir. Bir 
eylem yönteminden önce veya sonra mantık gerçekleştirmek için bir /i'/frekullanın. Çapraz kesme sorunları 
üzerinde filtrelerin kullanılması, yinelemeyi azaltabilir. 

[Authorize] gibi çoğu filtre özniteliği, istenen ayrıntı düzeyi düzeyine bağlı olarak denetleyiciye veya eylem 
düzeyine uygulanabilir. 

Hata işleme ve yanıt önbelleklemesi genellikle çapraz kesme kaygılardır: 

• Hataları işleme 

• Yanıtları Önbelleğe Alma 

Birçok çapraz kesme konusu, filtreler veya özel Ara yazılımkullanılarak işlenebilir. 






ASRNET Core denetleyici eylemlerine 
yönlendirme 
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Ryan şimdi ak ve Rick Anderson 

ASP.NET Core MVC, gelen isteklerin URL 'Leriyle eşleştirmek ve bunları eylemlerle eşlemek için 
yönlendirme Ara yazılımını kullanır. Yollar başlangıç kodunda veya özniteliklerde tanımlanmıştır. Yollar 
URL yollarının eylemlerle nasıl eşleştirileceği açıklanır. Yollar, yanıt olarak gönderilen URL 'Leri 
(bağlantılar için) oluşturmak için de kullanılır. 

Eylemler genel olarak Dolaştırılan veya Attribute olarak yönlendirilir. Bir yolu denetleyiciye koymak veya 
eylemi, BT özniteliği yönlendirilmesini sağlar. Daha fazla bilgi için bkz. karma yönlendirme . 

Bu belge, MVC ve yönlendirme arasındaki etkileşimleri ve tipik MVC uygulamalarının yönlendirme 
özelliklerini nasıl kullandığını açıklar. Gelişmiş yönlendirme hakkında ayrıntılar için bkz. yönlendirme . 


Yönlendirme ara yazılımını ayarlama 


Yapdarıdırma yönteminde şuna benzer bir kod görebilirsiniz: 


app.UseMvc(routes => 

{ 

routes.MapRoute("default", "{controller=Home}/{action=Index}/{id?}"); 

}); 


useMvc çağrısının içinde MapRoute , default rota olarak başvurabileceğiniz tek bir yol oluşturmak için 
kullanılır. Çoğu MVC uygulaması, default yoluna benzer bir şablon içeren bir yol kullanır. 


Yol şablonu "{controller=Home}/{action=Index}/{id?}" /Products/Details/5 gibi bir URL yoluyla 
eşleştirebilir ve yolu simgeleştirerek { controiler = Products, action = Details, id = 5 } yol değerlerini 
ayıklar. MVC, ProductsControiler adlı bir denetleyiciyi bulmaya çalışır ve Details eylemi çalıştırır: 

public class ProductsControiler : Controiler 
{ 

public IActionResult Details(int id) { ... } 

} 

Bu örnekte model bağlamanın, bu eylemi çağırırken id parametresini s olarak ayarlamak için id = 5 
değerini kullanabileceğini unutmayın. Daha fazla ayrıntı için model bağlamaya bakın. 


default yolunu kullanma: 


routes.MapRoute("default", "{controller=Home}/{action=Index}/{id?}"); 


Yol şablonu: 



















{id?} id isteğe bağlı olarak tanımlar 


Bir eşleşme için URL yolunda varsayılan ve isteğe bağlı yol parametrelerinin mevcut olması gerekmez. 
Yol şablonu sözdiziminin ayrıntılı açıklaması için bkz. route Template Reference . 

"{controller=Home}/{action=Index}/{id?}" , / URL yolu İle eş leşti rebi Iİ r ve 

{ controiler = Home, action = index } yol değerlerini üretecektir, controiler ve action değerleri 
varsayılan değerleri kullanır id , URL yolunda karşılık gelen bir kesim olmadığından, bu değer 
oluşturmaz. MVC bu yol değerlerini kullanarak HomeControiler ve index eylemini seçer: 


public class HomeControiler : 

Controiler 

{ 



public IActionResult Index() 

{ 

■■ } 

} 




Bu denetleyici tanımı ve yönlendirme şablonunu kullanarak, aşağıdaki URL yollarından herhangi biri için 
HomeControiler.index eylemi yürütülür: 

• /Home/Index/17 

• /Home/Index 

• /Home 

• / 

Kolaylık yöntemi UseMvcI/dithDefaultRoute : 

app.UseMvcWithDefaultRoute(); 

Değiştirmek için kullanılabilir: 

app.UseMvc(routes => 

{ 

routes.MapRoute("default", "{controller=Home}/{action=Index}/{id?}"); 

}); 

useMvc ve useMvcwithDefauitRoute ara yazılım ardışık düzenine bir RouterMiddieware örneği ekleyin. 
MVC, doğrudan ara yazılım ile etkileşime girmez ve istekleri işlemek için yönlendirmeyi kullanır.MVC bir 
MvcRouteHandler örneği aracılığıyla yollara bağlanır. UseMvc içindeki kod aşağıdaki gibidir: 

var routes = new RouteBuilder(app); 

// Add connection to MVC, will be hooked up by calls to MapRoute. 
routes.DefaultHandler = new MvcRouteHandler(...); 

// Execute callback to register routes. 

// routes.MapRoute("default", "{controller=Home}/{action=Index}/{id?}"); 

// Create route collection and add the middleware. 
app.UseRouter(routes.Build()); 

useMvc doğrudan hiçbir yol tanımlamıyor, yol koleksiyonuna attribute yolu için bir yer tutucu ekler. 
Aşırı yükleme useMvc(Action<iRouteBuiider>) kendi rotalarınızı eklemenize ve öznitelik yönlendirmeyi de 
desteklemenizi sağlar. useMvc ve tüm çeşitlemeleri, UseMvc yapılandırma şeklinden bağımsız olarak her 
zaman kullanılabilir öznitelik yönlendirme özniteliği. useMvcwithDefauitRoute varsayılan bir yol tanımlar 























ve öznitelik yönlendirmeyi destekler. Öznitelik yönlendirme bölümü öznitelik yönlendirme hakkında daha 
fazla ayrıntı içerir. 

Geleneksel yönlendirme 

default yolu: 

routes .MapRoute( "defaıılt ", "{controller=Home}/{action=Index}/{id?}"); 

, geleneksel yönlendirmeye bir örnektir. Bu stil geleneksel yönlendirmeyi, URL yolları için bir kural 
oluşturduğundan çağırıyoruz: 

• ilk yol kesimi denetleyicinin adıyla eşlenir 

• İkincisi eylem adıyla eşlenir. 

• üçüncü segment bir model varlığına eşlemek için kullanılan isteğe bağlı id kullanılır 

Bu default yolunu kullanarak, U RL yolu /Products/List ProductsControiier.List eylemine eşlenir ve 
/Biog/Articie/i7 eşlenir BlogCont roller. Art ide . Bu eşleme yalnızca denetleyiciye ve eylem adlarına 
dayalıdır ve ad alanları, kaynak dosya konumları veya yöntem parametrelerine göre değildir. 


TIP 

Varsayılan yol ile geleneksel yönlendirmeyi kullanmak, tanımladığınız her eylem için yeni bir URL düzeniyle 
karşılaşmanıza gerek kalmadan uygulamayı hızlı bir şekilde oluşturmanıza olanak tanır. CRUD stilinde eylemlere 
sahip bir uygulama için denetleyicilerinizdeki URL 'Lerin tutarlılığı, kodunuzun basitleştirilmesine ve Kullanıcı 
arabiriminizi daha öngörülebilir hale getirmenize yardımcı olabilir. 


VVARNING 

id , yol şablonu tarafından isteğe bağlı olarak tanımlanır ve bu, eylemlerinizin URL ’nin bir parçası olarak 
sağlanmadan yürütebileceği anlamına gelir. Genellikle, URL 'den id atlandığında ne olur, bu durum model 
bağlama tarafından 0 olarak ayarlanır ve sonuç olarak veritabanında eşleşen id == 0 hiçbir varlık 
bulunamacaktır. Öznitelik yönlendirme, bazı eylemler için gereken KİMLİĞİ, diğerleri için değil, daha ayrıntılı bir 
denetim sağlayabilir. Kurala göre belgeler, doğru kullanımlarda görünebilecekleri id gibi isteğe bağlı 
parametreleri de içerecektir. 


Birden çok yol 


MapRoute daha fazla çağrı ekleyerek useMvc içine birden çok yol ekleyebilirsiniz. Bunun yapılması, birden 
çok kural tanımlamanızı veya belirli bir eyleme adanmış geleneksel yollar eklemenizi sağlar; örneğin: 



görünmadığından, bu yol yalnızca varsayılan değerlere sahip olabilir ve bu nedenle bu yol her zaman 

















eylem BlogControiier.Articie eşlenir. 


Rota koleksiyonundaki yollar sıralanır ve eklendikleri sırada işlenir. Bu örnekte, blog yolu default 
rotadan önce denenecek. 


NOTE 

Adanmış geleneksel yollar genellikle, URL yolunun kalan kısmını yakalamak için {*article} gibi catch-all Route 
parametrelerini kullanır. Bu, ' çok Greedy ' yolunu diğer yollarla eşleştirirken hedeflediğiniz URL 'Lerle eşleşen bir 
yol haline getirir. Bunu çözümlemek için ' Greedy ' yollarını daha sonra yol tablosuna koyun. 


Geri dönüş 

İstek işlemenin bir parçası olarak, MVC, uygulamanızdaki bir denetleyiciyi ve eylemi bulmak için yol 
değerlerinin kullanılabileceğini doğrular. Rota değerleri bir eylemle eşleşmezse, yol eşleşme olarak kabul 
edilmez ve sonraki rota denenir. Buna geri dönüş denir ve geleneksel yolların çakıştığı durumları 
basitleştirmek için tasarlanmıştır. 


Kesinleştirme eylemleri 

iki eylem yönlendirme aracılığıyla eşleşiyorsa, MVC ' en iyi 1 adayı seçmek için bir özel durum 
oluşturması veya bir özel durum oluşturmak için, MVC 'nin belirsizliğini Örneğin: 


public class ProductsController : Controiler 

{ 

public IActionResult Edit(int id) { ... } 


[HttpPost] 

public IActionResult Edit(int id, Product product) { ., 

} 

•• } 


Bu denetleyici, URL yolu /Products/Edit/i7 ile eşleşen iki eylemi tanımlar ve verileri 
{ controiler = Products, action = Edit, id = 17 } yönlendirir. Bu, Edit(int) bir ürünü düzenlemek 
üzere bir form gösterdiği ve Edit(int, Product) postalanan formu işleyen MVC denetleyicileri için tipik 
bir modeldir. Bunu yapmak için bu olası MVC, istek bir HTTP post olduğunda Edit(int, Product) ve 
HTTP fiili başka bir şey olduğunda Edit(int) ' ı seçmeniz gerekir. 


HttpPostAttribute 

( [HttpPost] ), yalnızca HTTP fiili 

post olduğunda eylemin seçili olmasını sağlayacak 

IActionConstraint 

uygulamasıdır. IActionConstraint 

olması, Edit(int, Product) ' daha iyi bir eşleşme 

Edit(int) , bu nedenle önce Edit(int, Product) denenmesini sağlar. 


Yalnızca özelleştirilmiş senaryolarda özel iActionConstraint uygulamalar yazmanız gerekir, ancak diğer 
HTTP fiilleri için HttpPostAttribute benzer öznitelikler gibi özniteliklerin rol olduğunu anlamak 
önemlidir. Geleneksel yönlendirmesinde, eylemler bir show form -> submit form iş akışının parçası 
olduğunda aynı eylem adını kullanmak yaygındır. Bu düzenin rahatlığı, lactionconstraint 'ı anlama 
bölümünde daha sonra görünür hale gelir. 

Birden çok yol eşleşirse ve MVC 1 en iyi 1 yolu bulamazsa, bir AmbiguousActionException oluşturur. 

Yol adları 

Aşağıdaki örneklerde "blog" ve "default" dizeler yol adlarıdır: 


























app.UseMvc(routes => 

{ 

routes.MapRoute("blog ", "blog/{*article}", 

defaults: new { controller = "Blog", action = "Article" }); 
routes.MapRoute("default", "{controller=Home}/{action=Index}/{id?}"); 

}); 


Yol adları, URL oluşturma için adlandırılmış yolun kullanılabilmesi için yola mantıksal bir ad verir.Bu, 
yolların sıralaması URL oluşturma karmaşık hale geldiğinde URL oluşturmayı büyük ölçüde basitleştirir. 
Yol adları, uygulama genelinde benzersiz olmalıdır. 

Yol adları, isteklerin URL 'SI ile eşleşmesini veya işlenmesini etkilemez; Bunlar yalnızca URL oluşturma 
için kullanılır. Yönlendirme , MVC 'ye özgü yardımcılardaki URL oluşturma da dahil olmak üzere URL 
oluşturma hakkında daha ayrıntılı bilgiler içerir. 

Öznitelik yönlendirme 

Öznitelik yönlendirme eylemleri doğrudan yönlendirme şablonlarına eşlemek için bir öznitelik kümesi 
kullanır. Aşağıdaki örnekte, app.useMvc(); configure yönteminde kullanılır ve hiçbir yol geçirilir. 
HomeControiler , varsayılan yol {controiier=Home}/{action=index}/{id?} eşleşeceğinize benzer bir URL 
kümesiyle eşleşir: 

public class HomeControiler : Controller 
{ 

[Route("")] 

[Route("Home")] 

[Route("Home/Index")] 
public IActionResult Index() 

{ 

return View(); 

} 

[Route("Home/About")] 
public IActionResult About() 

{ 

return View(); 

} 

[Route("Home/Contact") ] 
public IActionResult Contact() 

{ 

return View(); 

} 

} 



Öznitelik yönlendirme ile, denetleyici adı ve eylem adları, herhangi bir eylem seçildiği hiçbir rol oynar. 
Bu örnek, önceki örnekle aynı URL 'Lerle eşleştirecektir. 










public class MyDemoController : Controller 

{ 

[Route("")] 

[Route("Home")] 

[Route("Home/Index")] 
public IActionResult Mylndex() 

{ 

return View("Index"); 

} 

[Route("Home/About")] 
public IActionResult MyAbout() 

{ 

return View("About"); 

} 

[Route("Home/Contact") ] 
public IActionResult MyContact() 

{ 

return View("Contact"); 

} 


NOTE 

Yukarıdaki yol şablonları action , area ve controller için yol parametreleri tanımlamaz. Aslında, öznitelik 
rotalarında bu yol parametrelerine izin verilmez. Yol şablonu bir eylemle zaten ilişkili olduğundan, URL 'den eylem 
adını ayrıştırmak mantıklı değildir. 


Http [fiil] öznitelikleriyle öznitelik yönlendirme 

Öznitelik yönlendirme Ayrıca, HttpPostAttribute gibi Http[Verb] özniteliklerini de kullanabilir. Bu 
özniteliklerin hepsi bir yol şablonunu kabul edebilir. Bu örnekte, aynı rota şablonuyla eşleşen iki eylem 
gösterilmektedir: 


[HttpGet("/products")] 

public IActionResult ListProducts() 

{ 

// ... 

} 

[HttpPost("/products")] 

public IActionResult CreateProduct(...) 

{ 

II ... 

} 


/products gibi bir URL yolu için, HTTP fiili get olduğunda ProductsApi.ListProducts eylemi yürütülür 
ve HTTP fiili post olduğunda ProductsApi.createProduct yürütülür. Öznitelik yönlendirme öncelikle URL 
ile yol öznitelikleri tarafından tanımlanan yol şablonları kümesine göre eşleşir. Bir rota şablonu 
eşleştiğinde, hangi eylemlerin yürütüleceğini belirleyen iActionConstraint kısıtlamalar uygulanır. 


TIP 

Bir REST API oluştururken, eylem tüm HTTP yöntemlerini kabul edecek şekilde bir eylem yönteminde 
[Route (...) ] kullanmak isteyeceksiniz. API 'nizin neleri desteklediği hakkında kesin olması için daha özel 
Http*verb*Att ributes kullanmak daha iyidir REST API ferinin istemcileri, hangi yolların ve HTTP fiillerinin belirli 
mantıksal işlemlere eşlendiğini bilmelidir. 
















Bir öznitelik yolu belirli bir eyleme uyguladığı için, yol şablonu tanımının bir parçası olarak gerekli 



bir URL yolu için değil. Yol şablonlarının ve ilgili seçeneklerin tam açıklaması için bkz. yönlendirme . 

Yol adı 

Aşağıdaki kod Products_List yol adım tanımlar: 

public class ProductsApiController : Controller 
{ 

[HttpGet("/products/{id}", Name = "Pr'oducts_List")] 
public IActionResult GetProduct(int id) { ... } 

} 


Yol adları, belirli bir yolu temel alanbirURL oluşturmak için kullanılabilir. Rota adlarının, yönlendirmenin 
URL eşleştirme davranışına etkisi yoktur ve yalnızca URL oluşturma için kullanılır. Yol adları, uygulama 
genelinde benzersiz olmalıdır. 


NOTE 

Bunu, id parametresini isteğe bağlı ( {id?} ) olarak tanımlayan geleneksel varsayılan rafoy/okarşıtın. API ’Leri 
tam olarak belirtme özelliği, /products ve /products/5 farklı eylemlere dağıtılması gibi avantajlar sağlar. 


Yolları birleştirme 

Öznitelik yönlendirmeyi daha az tekrarlı hale getirmek için, denetleyicideki yol öznitelikleri, bireysel 
eylemlerdeki rota öznitelikleriyle birleştirilir. Denetleyicide tanımlanan tüm yol şablonları, eylemlerdeki 
rota şablonlarına eklenir. Bir Route özniteliğinin denetleyiciye yerleştirilmesi, denetleyicideki Tüm 
eylemlerin öznitelik yönlendirme kullanmasını sağlar. 

[Route("products") ] 

public class ProductsApiController : Controller 
{ 

[HttpGet] 

public IActionResult ListProducts() { ... } 

[HttpGet("{id}")] 

public ActionResult GetProduct(int id) { ... } 

} 

Bu örnekte, URL yolu /products ProductsApi.ListProducts ile eşleştirebilir ve URL yolu /products/5 
ProductsApi.GetProduct(int) eşleştirebilir. Bu eylemlerin her ikisi de, HttpGetAttribute olarak 
işaretlendiğinden HTTP get eşleşir. 

/ veya ~/ ile başlayan bir eyleme uygulanan yol şablonları denetleyiciye uygulanan yol şablonları ile 
birleştirilmemelidir. Bu örnek, varsayılan rofoyobenzer bir URL yolları kümesiyle eşleşir. 












[Route("Home")] 

public class HomeController : Controller 
{ 

[Route("")] // Combines to define the route template "Home" 

[Route("Index")] // Combines to define the route template "Home/Index" 
[Route("/")] // Doesn't combine., defines the route template "" 

public IActionResult Index() 

{ 

ViewData["Message"] = "Home index"; 
var url = Url.Action("Index", "Home"); 

ViewData["Message"] = "Home index" + "var url = Url.Action; = " + url; 

return View(); 

} 

[Route("About")] // Combines to define the route template "Home/About" 
public IActionResult About() 

{ 

return View(); 

} 


Öznitelik yollarını sıralama 

Tanımlı sırada yürütülen geleneksel yolların aksine, öznitelik yönlendirme bir ağaç oluşturur ve tüm 
yollarla aynı anda eşleşir. Bu, yol girişleri ideal bir sıralamaya yerleştirildiyse olduğu gibi davranır; en özel 
yolların, daha genel yollardan önce yürütülmesi şansınız vardır. 

Örneğin, biog/search/{topic} gibi bir yol biog/{*articie} gibi bir yol daha özgüdür, ilk olarak ' 
çalıştırmaları' biog/search/{topic} yolu için, varsayılan olarak, tek yapmanız gereken tek bir sıralama 
olduğundan mantıksal olarak konuşun. Geleneksel yönlendirmeyi kullanarak, yolları istenen sırada 
yerleştirmekten geliştirici sorumludur. 

Öznitelik yolları, tüm Framevvork yol özniteliklerinin order özelliğini kullanarak bir sıra yapılandırabilir. 
Yollar order özelliğinin artan sıralamasına göre işlenir. Varsayılan sıra e. order = -ı kullanarak bir 
yolun ayarlanması, bir sipariş ayarlamadan önce çalıştırılacak rotalardan önce çalıştırılır, order = ı 
kullanarak bir yolun ayarlanması, varsayılan yol sıralaması sonrasında çalışacaktır. 


TIP 

order bağlı olmadığından kaçının. URL alanınız, doğru sıralama değerlerinin doğru şekilde yönlendirilmesini 
gerektiriyorsa, istemciler de kafa karıştırıcı olabilir. Genel öznitelik yönlendirme ' de, URL eşleştirme ile doğru yolu 
seçer. URL oluşturma için kullanılan varsayılan sıra çalışmıyorsa, yol adının bir geçersiz kılma olarak kullanılması 
genellikle order özelliğini uygulamaktan daha basittir. 


Razor Pages yönlendirme ve MVC denetleyici yönlendirme bir uygulamayı paylaşır. Razor Pages 
konularındaki yol siparişi hakkında bilgiler Razor Pages yol ve uygulama kuralları: yol sıralaması' nda 
bulunabilir. 

Yol şablonlarında belirteç değiştirme ([denetleyici], [eylem], 
[alan]) 

Özellik yolları, bir belirteci köşeli ayraç içine alarak belirteç değişimini destekler ( [ , ] ). [action] , 
[area] ve [controller] belirteçleri, yolun tanımlandığı eylemden eylem adı, alan adı ve denetleyici adı 
değerleriyle değiştirilmiştir. Aşağıdaki örnekte, Eylemler, açıklamalarda açıklandığı gibi URL yollarıyla 
eşleşir: 

















[Route("[controller]/[action]") ] 

public class ProductsController : Controller 

{ 

[HttpGet] // Matches ’/Products/List' 
public IActionResult List() { 

II ... 

} 

[HttpGet("{id}")] // Matches '/Products/Edit/{id}' 
public IActionResult Edit(int id) { 

II ... 

} 


Belirteç değişikliği, öznitelik yollarının oluşturulması için son adım olarak gerçekleşir. Yukarıdaki örnek 
aşağıdaki kodla aynı şekilde davranır: 

public class ProductsController : Controller 

{ 

[HttpGet("[controller]/[action]")] // Matches '/Products/List' 
public IActionResult List() { 

II ... 

} 

[HttpGet("[controller]/[action]/{id}")] // Matches '/Products/Edit/{id}' 
public IActionResult Edit(int id) { 

II ... 

} 

} 

Öznitelik rotaları de devralma ile birleştirilebilir. Bu özellikle, belirteç değiştirme ile güçlü bir şekilde 
birleştirilir. 

[Route("api/[controller]")] 

public abstract class MyBaseController : Controller { ... } 

public class ProductsController : MyBaseController 

{ 

[HttpGet] // Matches '/api/Products' 
public IActionResult List() { } 

[HttpPut("{id}")] // Matches '/api/Products/{id}' 
public IActionResult Edit(int id) { ... } 

} 

Belirteç değişikliği, öznitelik rotaları tarafından tanımlanan yol adları için de geçerlidir. 
[Route("[controiier]/[action]'', Name="[controiier]_[action]")] her eylem için benzersiz bir yol adı 
üretir. 

Sabit belirteç değiştirme sınırlayıcısı [ veya ] eşleştirmek için, karakteri ( [[ veya ]]) tekrarlayarak 
kaçış. 

Belirteç değişimini özelleştirmek için bir parametre transformatörü kullanın 

Belirteç değiştirme, bir parametre transformatörü kullanılarak özelleştirilebilir. Bir parametre 


transformatörü 

IOutboundParameterT ransformer 

uygular ve parametrelerin değerini dönüştürür. Örneğin, 

özel bir 

değerini 

siugifyParameterTransformer parametresi transformatörü 
subscription-management olarak değiştirir. 

SubscriptionManagement 

Route 










RouteTokenTransformerConvention 


şu şekilde bir uygulama modeli kuralıdır: 


• Bir uygulamadaki tüm öznitelik yollarına bir parametre transformatörü uygular. 

• Öznitelik yol belirteci değerlerini değiştirildikleri gibi özelleştirir. 


public class SubscriptionManagementController : Controller 

{ 

[HttpGet("[controller]/[action]")] // Matches '/subscription-management/list-all' 
public IActionResult ListAll() { ... } 

} 

RouteTokenTransformerConvention , ConfigureServices bir seçenek olarak kaydedilir. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddMvc(options = > 

{ 

options.Conventions.Add(new RouteTokenTransformerConvention( 

new SlugifyParameterTransformer())); 

})J 


public class SlugifyParameterTransformer : IOutboundParameterTransformer 

{ 

public string TransformOutbound(object value) 

{ 

if (value == null) { return null; } 

// Slugify value 

return Regex.Replace(value.ToString(), "([a-z])([A-Z ])", "$l-$2").ToLower(); 

} 

} 


Birden çok yol 

Öznitelik yönlendirme, aynı eyleme ulaşan birden çok yolun tanımlanmasını destekler. Bunun en yaygın 
kullanımları, aşağıdaki örnekte gösterildiği gibi varsayılan geleneksel yolun davranışını taklit etmek olur 

[Route("[controller]")] 

public class ProductsController : Controller 

{ 

[Route("")] // Matches 'Products' 

[Route("Index")] // Matches ’Products/Index' 
public IActionResult Index() 

} 


Denetleyiciye birden çok yol özniteliği koymak, her birinin eylem yöntemlerinde yol özniteliklerinin her 
biriyle birleşmesi anlamına gelir. 

[Route("Store")] 

[Route("[controller]")] 

public class ProductsController : Controller 

{ 

[HttpPost("Buy")] // Matches 'Products/Buy' and 'Store/Buy' 

[HttpPost("Checkout")] // Matches 'Products/Checkout' and 'Store/Checkout' 
public IActionResult Buy() 

} 

Birden çok yol özniteliği ( iActionConstraint uygulayan) bir eyleme yerleştirildiğinde, her eylem 
kısıtlaması, onu tanımlayan öznitelikten yol şablonuyla birleştirir. 






[Route("api/[controller]")] 

public class ProductsController : Controller 

{ 

[HttpPut("Buy")] // Matches PUT 'api/Products/Buy' 

[HttpPost("Checkout")] // Matches POST 'api/Products/Checkout' 
public IActionResult Buy() 

} 


TIP 

Eylemlerde birden çok yolun kullanılması güçlü görünse de, uygulamanızın URL alanının basit ve iyi tanımlanmış 
tutulması daha iyidir. Yalnızca gerektiğinde eylemler üzerinde birden çok yol kullanın, örneğin mevcut istemcileri 
desteklemek için. 


Öznitelik rotası isteğe bağlı parametreler, varsayılan değerler ve kısıtlamalar belirtme 

Öznitelik yolları, isteğe bağlı parametreleri, varsayılan değerleri ve kısıtlamaları belirtmek için geleneksel 
yollarla aynı satır içi sözdizimini destekler. 

[HttpPost("product/{id:int}")] 

public IActionResult ShowPnoduct(int id) 

{ 

// ... 

} 

Yol şablonu sözdiziminin ayrıntılı açıklaması için bkz. route Template Reference . 
iRouteTempiateProvider kullanarak özel yol öznitelikleri 

Çerçevede ( [Route(...)] , [HttpGet(. ..)] , vb.) sunulan yol özniteliklerinin hepsi 
İRouteTempiateProvider arabirimini uygular. MVC, uygulama başlatıldığında denetleyici sınıflarında ve 
eylem yöntemlerinde öznitelikler arar ve ilk yol kümesini oluşturmak için İRouteTempiateProvider 
uygulayan uygulamaları kullanır. 

Kendi yol öznitelerinizi tanımlamak için İRouteTempiateProvider uygulayabilirsiniz. Her 
İRouteTempiateProvider , özel bir yol şablonu, sırası ve adı ile tek bir yol tanımlamanızı sağlar: 

public class MyApiControllerAttribute : Attribute, İRouteTempiateProvider 
{ 

public string Template => "api/[controller]"; 
public int? Order { get; set; } 
public string Name { get; set; } 

} 

Yukarıdaki örnekteki özniteliği, [MyApiControiler] uygulandığında otomatik olarak Template 
"api/[controller]" olarak ayarlar. 

Öznitelik yollarını özelleştirmek için uygulama modelini kullanma 

Uygulama modeli , MVC tarafından eylemlerinizi yönlendirmek ve yürütmek için kullanılan tüm meta 
veriler ile başlangıçta oluşturulan bir nesne modelidir. Uygulama modeli , yol özniteliklerinden toplanan 
tüm verileri içerir ( İRouteTempiateProvider aracılığıyla). Yönlendirme işleminin nasıl davranacağını 
özelleştirmek için, Başlangıç zamanında uygulama modelini değiştirmek üzere kurallar yazabilirsiniz. Bu 
bölümde, uygulama modeli kullanılarak yönlendirmeyi özelleştirmenin basit bir örneği gösterilmektedir. 














using Microsoft.AspNetCore.Mvc.ApplicationModels; 
using System.Linq; 
using System.Text; 

public class NamespaceRoutingConvention : IControllerModelConvention 

{ 

private readonly string _baseNamespace; 

public NamespaceRoutingConvention(string baseNamespace) 

{ 

_baseNamespace = baseNamespace; 

} 

public void Apply(ControllerModel controller) 

{ 

var hasRouteAttributes = controller.Selectors.Any(selector => 

selector.AttributeRouteModel != null); 

if (hasRouteAttributes) 

{ 

// This controller manually defined some routes, so treat this 

// as an override and not apply the convention here. 

return; 

} 

// Use the namespace and controller name to infer a route for the controller. 

// 

// Example: 

// 

// controller.ControllerTypelnfo -> "My.Application.Admin.UsersController" 

// baseNamespace -> "My.Application" 

// 

// template => "Admin/[controller]" 

// 

// This makes your routes roughly line up with the folder structure of your project. 

// 

var namespc = controller.ControllerType.Namespace; 
if (namespc == null) 
return; 

var template = new StringBuilder(); 

template.Append(namespc, _baseNamespace.Length + 1 , 

namespc.Length - _baseNamespace.Length - 1); 
template.Replace(, '/'); 
template.Append("/[controller]"); 

foreach (var selector in controller.Selectors) 

{ 

selector.AttributeRouteModel = new AttributeRouteModel() 

{ 

Template = template.ToStringO 

}; 

} 

} 

} 


Karma yönlendirme: öznitelik yönlendirme vs geleneksel 
yönlendirme 

MVC uygulamaları, geleneksel yönlendirme ve öznitelik yönlendirmenin kullanımını karıştırabilir. 
Tarayıcılar için HTML sayfalarına hizmet veren denetleyiciler için geleneksel yollar ve REST API 'Lerine 
hizmet veren denetleyiciler için öznitelik yönlendirme kullanılması normaldir. 

Eylemler genel olarak Dolaştırılan veya Attribute olarak yönlendirilir. Bir yolu denetleyiciye koymak veya 
eylemi, BT özniteliği yönlendirilmesini sağlar. Öznitelik yollarını tanımlayan eylemlere geleneksel yollar 
üzerinden ulaşılamıyor ve bunun tersi de geçerlidir. Denetleyicideki herhangi bir rota özniteliği, 



denetleyici özniteliğindeki tüm eylemlerin yönlendirilmesini sağlar. 


NOTE 

iki tür yönlendirme sisteminin ayırt edilmesini ne kadar ayırt eden, bir URL bir yol şablonuyla eşleştirdikten sonra 
uygulanan işlemdir. Geleneksel yönlendirmesinde, eşleşmeden yol değerleri, tüm geleneksel yönlendirilmiş 
eylemlerin arama tablosundan eylemi ve denetleyiciyi seçmek için kullanılır. Öznitelik yönlendirmesinde, her şablon 
zaten bir eylemle ilişkilendirilir ve başka bir arama gerekmez. 


Karmaşık segmentler 

Karmaşık segmentler (örneğin, [Route("/dog{token}cat")] ), sabit değerli olmayan değişmez değerler ile 
sağdan sola eşleştirilirken işlenir. Bir açıklama için bkz. kaynak kodu . Daha fazla bilgi için Bu 
sorunabakın. 

URL oluşturma 

MVC uygulamaları, eylemlere URL bağlantıları oluşturmak için yönlendirmenin URL oluşturma 
özelliklerini kullanabilir. URL oluşturma, kodlarınızın daha sağlam ve sürdürülebilir hale getirilmesi için 
sorunsuz kodlama URL 'Lerini ortadan kaldırır. Bu bölüm, MVC tarafından sunulan URL oluşturma 
özelliklerine odaklanır ve yalnızca URL oluşturmanın nasıl çalıştığına ilişkin temel bilgileri kapsar. URL 
oluşturma hakkında ayrıntılı bir açıklama için bkz. yönlendirme . 

ıuriHelper arabirimi, URL oluşturma için MVC ve yönlendirme arasındaki temel altyapı parçasıdır. 
Denetleyiciler, görünümler ve görünüm bileşenlerinde url özelliği aracılığıyla kullanılabilen bir 
ıuriHelper örneğini bulacaksınız. 

Bu örnekte ıuriHelper arabirimi, başka bir eyleme yönelik bir URL oluşturmak için controller.url 
özelliği aracılığıyla kullanılır. 

using Microsoft.AspNetCore.Mvc; 

public class UrlGenerationController : Controller 
{ 

public IActionResult Source() 

{ 

// Generates /UrlGeneration/Destination 
var url = Url.Action("Destination")j 

return Content($"Go check out {url}, it's really great."); 

} 

public IActionResult Destination() 

{ 

return View(); 

} 

} 

Uygulama varsayılan geleneksel rotayı kullanıyorsa, url değişkenin değeri /UrlGeneration/Destination 
URL yol dizesi olacaktır.Bu URL yolu, yönlendirme değerlerini, geçerli istekten (çevresel değerler), 
url.Action aktarılan değerlerle ve bu değerleri yol şablonuna geçirerek birleştirerek oluşturulur. 

ambient values: { controller = "UrlGeneration", action = "Source" } 

values passed to Url.Action: { controller = "UrlGeneration", action = "Destination" } 

route template: {controller}/{action}/{id?} 

result: /UrlGeneration/Destination 













Yol şablonundaki her bir rota parametresinin değeri, değerler ve ortam değerleri ile eşleşen adlara sahip 
olacak şekilde değiştirilir. Bir değere sahip olmayan bir rota parametresi, varsa varsayılan bir değer 
kullanabilir veya isteğe bağlı ise (Bu örnekteki id olduğu gibi) atlanır.Gerekli yol parametresinin karşılık 
gelen bir değeri yoksa, URL oluşturma başarısız olur. Bir yol için URL oluşturma başarısız olursa, tüm 
yollar Denenene veya bir eşleşme bulunana kadar sonraki yol denenir. 



verilmez; bunun yerine kullanılacak şablonu aramak için kullanılır. 
Bu örnek öznitelik yönlendirme kullanır: 

// In Startup class 

public void Configure(IApplicationBuilder app) 

{ 

app.UseMvc(); 

} 


using Microsoft.AspNetCore.Mvc; 

public class UrlGenerationController : Controller 
{ 

[HttpGet("") ] 

public IActionResult Source() 

{ 

var url = Url.Action("Destination"); // Generates /custom/url/to/destination 
return Content($"Go check out {url}, it's really great."); 

} 

[HttpGet("custom/url/to/destination")] 
public IActionResult Destination() { 
return View(); 

} 

} 

MVC, tüm öznitelik yönlendirilmiş eylemlerinin bir arama tablosunu oluşturur ve URL oluşturma için 
kullanılacak yol şablonunu seçmek üzere controller ve action değerleriyle eşleşir. Yukarıdaki örnekte 
custom/url/to/destination oluşturulur. 

Eylem adına göre URL 'Leri oluşturma 

url.Action ( ıuriHelper . Action ) ve tüm ilgili aşırı yüklemeler, bir denetleyici adı ve eylem adı 
belirterek ne bağlandığınızı belirtmek istediğinizi temel alır. 


NOTE 

url. Action kullanırken, controller ve action için geçerli yol değerleri sizin için belirtilir; controller 
değeri, action hem ortam değerlerinin hem de değerlerinin bir parçasıdır, url.Action yöntemi her zaman 
action ve controller geçerli değerlerini kullanır ve geçerli eyleme yönlendiren bir URL yolu oluşturacaktır. 


Yönlendirme, bir URL oluştururken sağlamadığınız bilgileri doldurmanızı sağlamak için çevresel 
değerlerde değerleri kullanmayı dener. Yönlendirme parametrelerinin bir değere sahip olduğundan, 
{a}/{b}/{c}/{d} ve çevresel değerler { a = Alice, b = Bob, c = carol, d = David } gibi bir yol 
kullanarak yönlendirme için ek değer olmadan bir URL oluşturmaya yetecek kadar bilgi vardır. Değer 


















{ d = Donovan } eklediyseniz, { d = David } değeri yok sayılır ve oluşturulan URL yolu 
Alice/Bob/Carol/Donovan olur. 


WARNING 

URL yolları hiyerarşiktir. Yukarıdaki örnekte, değeri { c = cheryl } eklediyseniz her iki değer de 
{ c = carolj d = David } yok sayılır. Bu durumda artık d için bir değer yoktur ve URL oluşturma başarısız 
olur İstediğiniz c ve d değerini belirtmeniz gerekir Bu sorunu varsayılan yol ( {controller}/{action}/{id?} ) 
ile 0 beklemeniz gerekebilir; ancak, url.Action her zaman açıkça bir controller ve action değeri belirtmesi 
gibi uygulamada bu davranış hakkında nadiren karşılaşacaksınız. 


Daha uzun url.Action aşırı yüklemeleri, controller ve action dışındaki rota parametreleri için 
değerler sağlamak üzere ek bir yol değerleri nesnesi de alır. Bu, en yaygın olarak 
Url.Action ("Buy"., "Products", new { id = 17 }) gibi id kullanıldığını görürsünüz. Kurala göre yol 
değerleri nesnesi genellikle anonim türdeki bir nesnedir, ancak bir iDictionaryo veya düz bir .net 
nesneside olabilir. Yol parametreleriyle eşleşmeyen ek rota değerleri sorgu dizesine konur. 

using Microsoft.AspNetCore.Mvc; 

public class TestController : Controller 

{ 

public IActionResult Index() 

{ 

// Generates /Products/Buy/17?color=red 

var url = Url.Action("Buy", "Products", new { id = 17, color = "red" }); 

return Content(url); 

} 

} 


TIP 

Mutlak URL oluşturmak için, protocol kabul eden bir aşırı yükleme kullanın: 

Url.Action("Buy", "Products", new { id = 17 }, protocol: Request.Scheme) 


Rotaya göre URL oluşturma 

Yukarıdaki kod, denetleyiciyi ve eylem adını geçirerek bir URL oluşturmayı göstermiştir. ıuriHelper 


Url.RouteUrl 

Yöntem ailesini da sağlar. Bu yöntemler 

url.Action benzerdir, ancak 

action 


controller geçerli değerlerini rota değerlerine kopyalamaz. En yaygın kullanım, genellikle bir 
denetleyici veya eylem adı belirtmeden, URL oluşturmak için belirli bir yolu kullanmak üzere bir yol adı 
belirtmektir. 















using Microsoft.AspNetCore.Mvc; 

public class UrlGenerationController : Controller 
{ 

[HttpGet("")] 

public IActionResult Source() 

{ 

var url = Url.RouteUrl("Destination_Route")j // Generates /custom/url/to/destination 
return Content($"See {url}, it's really great."); 

} 

[HttpGet("custom/url/to/destination", Name = "Destination_Route")] 
public IActionResult Destination() { 
return View(); 

} 


HTML 'de URL oluşturma 

IHtmlHelper , <form> ve <a> Öğeleri oluşturmak için HtmlHelper yöntemleri Html.BeginForm ve 
Htmi.ActionLink sağlar. Bu yöntemler bir URL oluşturmak için url.Action yöntemini kullanır ve benzer 
bağımsız değişkenleri kabul ederler. HtmlHelper için url.Routeuri compan, benzer işlevlere sahip 
Html.BeginRouteForm ve Html.RouteLink . 


Taghelmakalar, form TagHelperve <a> TagHelper aracılığıyla URL'Ler oluşturur.Bunların her ikisi de 
kendi uygulamaları için ıuriHelper . Daha fazla bilgi için bkz. formlarla çalışma . 


Görünümler içinde ıuriHelper , yukarıdaki herhangi bir geçici URL nesli için url özelliği aracılığıyla 
kullanılabilir. 


Eylem sonuçlarında URL oluşturma 

Yukarıdaki örnekler, bir denetleyicide ıuriHelper kullanılarak gösterilmektedir, ancak denetleyicideki en 
yaygın kullanım, bir eylem sonucunun parçası olarak bir URL oluşturmak olur. 

controiierBase ve Controller Taban sınıfları, başka bir eyleme başvuruda bulunan eylem sonuçları için 
kolay yöntemler sağlar. Tipik bir kullanım, Kullanıcı girişi kabul edildikten sonra yeniden 
yönlendirilmelidir. 

public IActionResult Edit(int id, Customer customer) 

{ 

if (ModelState.IsValid) 

{ 

// Update DB with new details. 
return RedirectToAction("Index"); 

} 

return View(customer); 

} 

Eylem sonuçları Fabrika yöntemleri ıuriHelper yöntemlere benzer bir model izler. 

Adanmış geleneksel yollar için özel durum 

Geleneksel yönlendirme, adanrruş geleneksel yo/olarak adlandırılan özel bir yol tanımı türünü 
kullanabilir. Aşağıdaki örnekte, blog adlı yol adanmış bir geleneksel yoldur. 





















app.UseMvc(routes => 

{ 

routes.MapRoute("blog", "blog/{*article}", 

defaults: new { controiler = "Blog", action = "Articie" }); 
routes.MapRoute("default", "{controller=Home}/{action=Index}/{id?}"); 

}); 

uri.Action("index", "Home") , bu yol tanımlarını kullanarak / URL yolunu default rotası ile 


oluşturacak, ancak neden? Yol değerlerini tahmin edebilirsiniz 

{ controiler = Home, action = Index 

} 

blog kullanarak URL oluşturmak için yeterli olacaktır ve sonuç 

: /blog?action=Index&controller=Home 



Adanmış geleneksel yollar, URL oluşturmayla "çok Greedy" olmasını önleyen karşılık gelen bir yol 
parametresi olmayan varsayılan değerlerin özel bir davranışına bağımlıdır. Bu durumda, varsayılan 
değerler { controiler = Blog, action = Articie } ve ne contnoller- ne de action yol parametresi 
olarak görünmez. Yönlendirme URL oluşturma işlemi gerçekleştirdiğinde, belirtilen değerler varsayılan 
değerlerle eşleşmelidir. blog kullanılarak URL oluşturma başarısız olur çünkü değerler 

{ controiler = Home, action = Index } { controiler = Blog, action = Articie } eşleşmiyor. Ardından 

yönlendirme default denemeye geri döner ve başarılı olur. 

Alanlar 

Bölgeler , ilgili işlevselliği ayrı bir yönlendirme-ad alanı (denetleyici eylemleri için) ve klasör yapısı 
(görünümler için) olarak bir grupla düzenlemek için kullanılan bir MVC özelliğidir. Alanların kullanılması, 
bir uygulamanın farklı alanlara sahip oldukları sürece aynı ada sahip birden çok denetleyicisi olmasına 
olanak sağlar. Alanların kullanılması, başka bir yol parametresi ekleyerek yönlendirme amacına yönelik 
bir hiyerarşi oluşturur, controiler ve action''area . Bu bölüm, yönlendirmenin alanlarla nasıl etkileşime 
gireceğini tartışır, alanların görünümlerle nasıl kullanıldığı hakkında ayrıntılar için bkz. alanlara bakın. 

Aşağıdaki örnek, MVC ‘yi, Blog adlı bir alan için varsayılan geleneksel yolu ve bir alan yolunu kullanacak 
şekilde yapılandırır: 

app.UseMvc(routes => 

{ 

routes.MapAreaRoute("blog_route", "Blog", 

"Manage/{controller}/{action}/{ld?}"); 
routes.MapRoute("default_route", "{controller}/{action}/{id?}"); 

}); 

/Manage/users/Adduser gibi bir URL yolu eşleştirilirken, ilk yol 

{ area = Blog, controiler = Users, action = AddUser } yol değerlerini oluşturur, area yol değeri, area 
için varsayılan bir değer tarafından üretilir, aslında MapAreaRoute tarafından oluşturulan yol, aşağıdaki 
değere eşdeğerdir: 

app.UseMvc(routes => 

{ 

routes.MapRoute("blog_route", "Manage/{controller}/{action}/{id?}", 

defaults: new { area = "Blog" }, constraints: new { area = "Blog" }); 
routes.MapRoute("default_route", "{controller}/{action}/{id?}"); 

}); 

MapAreaRoute, area için hem varsayılan değer hem de kısıtlama (Bu durumda Blog ) kullanarak bir yol 
oluşturur. Varsayılan değer, yolun her zaman { area = Blog, ... } üretmesini sağlar, kısıtlama, URL 
oluşturma için { area = Blog, ... } değer gerektirir. 





















TIP 

Geleneksel yönlendirme sıra bağımlıdır. Genel olarak, alanlar içeren rotalar, alan olmayan rotalardan daha belirgin 
olduklarından daha önce rota tablosuna yerleştirilmelidir. 


Yukarıdaki örneği kullanarak, yol değerleri aşağıdaki eylemle eşleşir: 

using Microsoft.AspNetCore.Mvc; 

namespace MyApp.Namespacel 

{ 

[Area("Blog")] 

public class UsersController : Controller 

{ 

public IActionResult AddUser() 

{ 

return View(); 

} 

} 

} 

AreaAttribute , bir alanın parçası olarak denetleyiciyi belirtir, bu denetleyicinin Blog alanında olduğunu 
varsayalım. [Area] özniteliği olmayan denetleyiciler hiçbir alanın üyesi değildir ve area yol değeri 
yönlendirme tarafından sağlandığında eşleşmeyecektir . Aşağıdaki örnekte, yalnızca listelenen ilk 
denetleyici { area = Blog, controller = Users, action = Adduser } rota değerleriyle eşleştirebilir. 

using Microsoft.AspNetCore.Mvc; 

namespace MyApp.Namespacel 

{ 

[Area("Blog")] 

public class UsersController : Controller 

{ 

public IActionResult AddUser() 

{ 

return View(); 

} 

} 

} 


using Microsoft.AspNetCore.Mvc; 

namespace MyApp.Namespace2 

{ 

// Matches { area = Zebra, controller = Users, action = AddUser } 
[Area("Zebra")] 

public class UsersController : Controller 

{ 

public IActionResult AddUser() 

{ 

return View(); 

} 

} 

} 









using Microsoft.AspNetCore.Mvc; 

namespace MyApp.Namespace3 

{ 

// Matches { area = string.Empty, controller = Users, action = AddUser } 
// Matches { area = null, controller = Users, action = AddUser } 

// Matches { controller = Users, action = AddUser } 
public class UsersController : Controller 
{ 

public IActionResult AddUser() 

{ 

return View(); 

} 

} 

} 


NOTE 

Her denetleyicinin ad alanı, tamamlanma için burada gösterilir. Aksi takdirde, denetleyicilerde adlandırma çakışması 
olur ve derleyici hatası oluşturur. Sınıf ad alanlarının MVC 'nin yönlendirme üzerinde hiçbir etkisi yoktur. 


ilk iki denetleyici alanların üyeleridir ve yalnızca ilgili alan adı area rota değeri tarafından sağlandığında 
eşleşir. Üçüncü denetleyici hiçbir alanın üyesi değildir ve yalnızca Yönlendirme tarafından area hiçbir 
değer sağlanmıyorsa eşleşemez. 


NOTE 

Değer olmadaneş leşme açısından, area değerinin yokluğu, area değeri null ya da boş dize olarak aynıdır. 


Bir alan içinde bir eylem yürütürken, area için rota değeri, yönlendirme için, URL oluşturma için 
kullanılacak çevresel bir değer olarak kullanılabilir. Bu, varsayılan olarak, aşağıdaki örnekte gösterildiği 
gibi, URL oluşturma için yapışkan olarak hareket ettiği anlamına gelir. 

app.UseMvc(routes => 

{ 

routes.MapAreaRoute("duck_route", "Duck", 

"Manage/{controller}/{action}/{ld?}")j 

routes.MapRoute("default ", "Manage/{controller=Home}/{action=Index}/{id?}"); 

}); 










using Microsoft.AspNetCore.Mvc; 

namespace MyApp.Namespace4 
{ 

[Area("Duck")] 

public class UsersController : Controller 
{ 

public IActionResult GenerateURLInArea() 

{ 

// Uses the 'ambient' value of area 
var url = Url.Action("Index", "Home"); 

// returns /Manage 
return Content(url); 

} 

public IActionResult GenerateüRLOutsideOfArea() 

{ 

// Uses the empty value for area 

var url = Url.Action("Index", "Home", new { area = "" }); 
// returns /Manage/Home/Index 
return Content(url); 

} 

} 

} 


lactionconstraint 'i anlama 


NOTE 

Bu bölüm, Framevvork iç işlevleri hakkında ayrıntılı bir bakış ve MVC 'nin yürütülecek eylemi nasıl seçtiği. Tipik bir 
uygulama özel bir iActionConstraint gerektirmez 


Büyük olasılıkla, arabirime tanıdık olmasanız bile iActionConstraint zaten kullandık. [HttpGet] 
özniteliği ve benzer [Http-VERB] öznitelikleri, bir eylem yönteminin yürütülmesini sınırlandırmak için 
IActionConstraint uygular. 

public class ProductsController : Controller 
{ 

[HttpGet] 

public IActionResult Edit() { } 
public IActionResult Edit(...) { } 

} 

Varsayılan geleneksel yolun kabul edilmesinden, URL yolunun /Products/Edit , burada gösterilen 
eylemlerle her ikisi de eşleşen değerler { controller = Products, action = Edit } üretecektir. 
IActionConstraint terminolojisinde, her ikisi de rota verileriyle eşleştiğinden, bu eylemlerin her ikisi de 
aday olarak kabul edilir. 

HttpGetAttribute yürütüldüğünde, Edit 0 , Get için bir EŞLEŞMEDİR ve diğer http fiili için bir eşleşme 
değildir. Edit(...) eyleminde tanımlı kısıtlama yok ve bu nedenle herhangi bir HTTP fiili ile eşleşir. Bu 
nedenle,yalnızca post bir Edit(...) eşleştiğini kabul eder. Ancak get için her iki eylem de eşleşemez, 
ancak IActionConstraint bir eylem, olmadan bir eylemden en iyi şekilde değerlendirilir. Bu nedenle 
Edit() , [HttpGet] daha belirgin olarak değerlendirilir ve her iki eylemin da eşleşeceğinden seçilecek. 

Kavramsal olarak, IActionConstraint aşırı yük/emebiçimidir, ancak aynı ada sahip yöntemlerin aşırı 
yüklenmesi yerine aynı URL ile eşleşen eylemler arasında aşırı yüklenir. Öznitelikyönlendirme 



















iActionConstnaint de kullanır ve farklı denetleyicilerden gelen eylemlere her ikisi de aday olarak kabul 
edilebilir. 

lactionconstraint uygulama 

iActionConstraint kullanmanın en kolay yolu, System.Attribute türetilmiş bir sınıf oluşturmaktır ve 
bunları eylemleriniz ve denetleyicilerinize yerleştirmelidir. MVC, öznitelik olarak uygulanan 
iActionConstraint otomatik olarak bulur. Kısıtlama uygulamak için uygulama modelini kullanabilirsiniz 
ve bu, büyük olasılıkla en esnek yaklaşımdır ve bu sayede, nasıl uygulanabileceğini meta 
programlayabilirsiniz. 

Aşağıdaki örnekte bir kısıtlama, rota verilerinden bir ülke kodunu temel alan bir eylem seçer. GitHub 
'daki tam örnek. 

public class CountrySpecificAttribute : Attribute, IActionConstraint 
{ 

private readonly string _countryCode; 

public CountrySpecificAttribute(string countryCode) 

{ 

_countryCode = countryCode; 

} 

public int Order 
{ 

get 

{ 

return 0; 

} 

} 

public bool Accept(ActionConstraintContext context) 

{ 

return string.Equals( 

context.RouteContext.RouteData.Values["country"].ToString(), 

_countryCode, 

StringComparison.OrdinalIgnoreCase); 

} 

} 

Accept yöntemi uygulamaktan ve kısıtlamanın yürütülmesi için bir' Order' seçmeye sorumlusunuz. Bu 
durumda Accept yöntemi, country rota değeri eşleştiğinde eylemin bir eşleşme olduğunu göstermek 
için true döndürür. Bu, varolmayan bir eyleme geri dönüş sağlayan bir RoutevalueAttribute farklıdır. 
Örnek, bir en-us eylemi tanımlarsanız fr-FR gibi bir ülke kodunun [CountrySpecific(...)] 
uygulanmamış daha genel bir denetleyiciye geri dönemeyeceğini gösterir. 

order özelliği, kısıtlamanın parçası olan aşamayı belirler. Eylem kısıtlamaları order göre gruplar halinde 
çalışır. Örneğin, tüm Framevvork tarafından sunulan HTTP yöntemi öznitelikleri aynı aşamada çalışacak 
şekilde aynı order değerini kullanır. İstediğiniz ilkeleri uygulamak için ihtiyacınız olan çok sayıda 
aşamaya sahip olabilirsiniz. 


TIP 

order bir değere karar vermek için, kısıtlamalarınızın HTTP yöntemlerinden önce uygulanıp uygulanmayacağı 
hakkında düşünün. Daha az sayı önce çalışır. 

















ASRNET core'da denetleyicilere bağımlılık ekleme 

10.05.2019 • 3 minutes to read •. Edit Online 


Tarafından Shadi Namrouti, Rick Anderson, ve Steve Smith 

ASP.NET Core MVC denetleyicileri oluşturucular açıkça aracılığıyla bağımlılıkları isteyin. ASP.NET Core için 
yerleşik desteği vardır bağımlılık ekleme (dı). Dİ uygulamaları test edin ve bakımını kolaylaştırır. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Oluşturucu ekleme 

Hizmet bir oluşturucu parametresi eklenir ve çalışma zamanı hizmet kapsayıcı hizmetinden giderir. Hizmetleri, 
genellikle arabirimleri kullanılarak tanımlanır. Örneğin, geçerli zamanı gerektiren bir uygulama düşünün. 
Aşağıdaki kullanıma sunan arabirim İDateTime hizmeti: 

public interface İDateTime 
{ 

DateTime Now { get; } 

} 

Aşağıdaki kod uygulayan İDateTime arabirimi: 

public class SystemDateTime : İDateTime 
{ 

public DateTime Now 
{ 

get { return DateTime.Now; } 

} 

} 

Hizmet, hizmet kapsayıcıya ekleyin: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddSingletoncİDateTime, SystemDateTime>(); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

} 

Daha fazla bilgi için AddSingleton, bkz: Dİ hizmet yaşam süreleri. 

Aşağıdaki kod bir karşılama günün saatini temel alan kullanıcı için görüntüler: 










public class HomeController : Controller 

{ 

private readonly IDateTime _dateTime; 

public HomeController(IDateTime dateTime) 

{ 

_dateTime = dateTime; 

} 

public IActionResult Index() 

{ 

var serverTime = _dateTime.Now; 
if (serverTime.Hour < 12) 

{ 

ViewData["Message"] = "It's morning here - Good Morningl"; 

} 

else if (serverTime.Hour < 17) 

{ 

ViewData["Message"] = "It's afternoon here - Good Afternoon!"; 

} 

else 

{ 

ViewData["Message"] = "It's evening here - Good Eveningl"; 

} 

return View(); 

} 

Uygulamayı çalıştırın ve saatini temel alan bir ileti görüntülenir. 

FromServices ile eylemi ekleme 

FromServicesAttribute Oluşturucu ekleme kullanmadan, doğrudan bir eylem yöntemi bir hizmet ekleme sağlar: 

public IActionResult About([FromServices] IDateTime dateTime) 

{ 

ViewData["Message"] = $"Current server time: {dateTime.Now}"; 
return View(); 

} 


Bir denetleyiciden erişim ayarları 

Bir denetleyici içinde gelen uygulama veya yapılandırma ayarlarına erişme ortak bir desendir. Seçenekleri deseni 
açıklanan ASP.NET Core için seçenek kalıbı ayarlarını yönetmek için tercih edilen yaklaşım. Genellikle doğrudan 
ekleme yoksa IConfiguration içine bir denetleyici. 

Seçenekleri temsil eden bir sınıf oluşturun. Örneğin: 

public class SampleİAİebSettings 

{ 

public string Title { get; set; } 
public int Updates { get; set; } 

} 


Yapılandırma sınıfı Hizmetleri koleksiyona ekleyin: 





public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddSingleton<IDateTimej SystemDateTime>(); 

Services.Configure<SampleWebSettings>(Configuration); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

} 


Okumasına JSON biçimli bir dosyadan ayarları yapılandırın: 

public class Program 

{ 

public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build().Run(); 

} 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 

1/JebHost .CreateDefaultBuilder(args) 

.ConfigureAppConfiguration((hostingContextj config) => 

{ 

config.AddlsonFile("samplewebsettings.json ", 

optional: false, // File is not optional. 

reloadOnChange: false); 

}) 

.UseStartup<Startup>(); 

} 

Aşağıdaki kod istekleri ıoptions<sampiewebSettings> hizmet kapsayıcı ayarları ve bunları kullanan index 
yöntemi: 

public class SettingsController : Controller 

{ 

private readonly Samplel/JebSettings _settings; 

public SettingsController(IOptions<SampleWebSettings> settingsOptions) 

{ 

_settings = settingsOptions.Value; 

} 

public IActionResult Index() 

{ 

ViewData["Title"] = _settings.Title; 

ViewData["Updates"] = _settings.Updates; 
return View(); 

} 


Ek kaynaklar 

• Bkz: AS P.N ET Core 'de test denetleyicisi mantığı kod test denetleyicileri bağımlılıkları açıkça isteyerek 
daha kolay hale getirmek öğrenin. 

• Varsayılan bağımlılık ekleme kapsayıcısını üçüncü taraf bir uygulama ile değiştirin. 







ASPNET core'da görünümlere bağımlılık ekleme 
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Tarafından Steve Smith 

ASP.NET Core destekler bağımlılık ekleme görünümlere. Bu, yerelleştirme veya yalnızca görünüm öğeleri 
doldurmak için gerekli veriler gibi özel görünüm Hizmetleri için yararlı olabilir. Korunacak denemelisiniz görev 
ayrımı nettir denetleyici ve görünüm arasında. Kendi görünümlerinizi görüntüleyin verilerden en iyi şekilde 
denetleyicisinden geçirilmelidir. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Yapılandırma ekleme 

appSettings.JSON değerleri doğrudan bir görünüme eklenmiş. 

Örnek bir appsettings.jsorı dosyası: 

{ 

"root": { 

"parent": { 

"child": "myvalue" 

} 

} 

} 

Sözdizimi (Sinject : (Sinject <type> <name> 

Bir örnek kullanarak @inject : 

(Şusing Microsoft.Extensions.Configuration 
(Şinject IConfiguration Configuration 
@{ 

string myValue = Configuration["root:parent:child "]; 

} 


Hizmet ekleme 

Bir görünümü kullanarak bir hizmet yerleştirilebilir @inject yönergesi. Düşünebilirsiniz @inject görünüme 
özellik ekleme ve Dİ kullanan özellik dolduruluyor. 


















@using System.Threading.Tasks 
@using ViewInjectSample.Model 
@using ViewInjectSample.Model.Services 
@model IEnumerable<ToDoItem> 

(Şinject StatisticsService StatsService 
<!DOCTYPE html> 

<html> 

<head> 

<title>To Do Items</title> 

</head> 

<body> 

<div> 

<hl>To Do Items</hl> 

<ul> 

<li>Total Items: @StatsService.GetCount()</li> 

<li>Completed: @StatsService.GetCompletedCount()</li> 

<li>Avg. Priority: @StatsService.GetAveragePriority()</li> 

</ul> 

<table> 

<tr> 

<th>Name</th> 

<th>Priority</th> 

<th>Is Done?</th> 

</tr> 

@foreach (var item in Model) 

{ 

<tr> 

<td>@item.Name</td> 

<td>@item.Priority</td> 

<td>@item.IsDone</td> 

</tr> 

} 

</table> 

</div> 

</body> 

</html> 

Bu görünüm listesini görüntüler ToDoitem örnekleri, genel istatistiklerini gösteren bir özetiyle birlikte. Özet 
doldurulur eklenen gelen StatisticsService . Bu hizmet bağımlılık ekleme için kayıtlı configureServices içinde 
Startup.es : 

// For more information on how to configure your application, visit http://go.microsoft.com/fwlink/? 
LinkID=398940 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services. AddMvc(); 

Services.AddTransient<IToDoItemRepository, ToDoItemRepository>(); 

Services.AddTransient<StatisticsService>(); 

Services.AddT ransient<ProfileOptionsService>(); 


StatisticsService Dizi üzerinde bazı hesaplamalar yapan ToDoitem bir depo erişir örnekleri: 










using System.Linq; 

using ViewInjectSample.Interfaces; 

namespace ViewInjectSample.Model.Services 

{ 

public class StatisticsService 

{ 

private readonly IToDoltemRepository _toDoItemRepository; 

public StatisticsService(IToDoltemRepository toDoltemRepository) 

{ 

_toDoItemRepository = toDoltemRepository; 

} 

public int GetCount() 

{ 

return _toDoItemRepository.List().Count(); 

} 

public int GetCompletedCount() 

{ 

return _toDoItemRepository.List().Count(x => x.IsDone); 

} 

public double GetAveragePriorityO 

{ 

if (_toDoItemRepository.List().Count() == 0) 

{ 

return 0.0; 

} 

return _toDoItemRepository.List().Average(x => x.Priority); 

} 

} 

} 

Örnek depoyu bir bellek içi koleksiyon kullanır. Yukarıda gösterilen uygulama (Bu, tüm verilerin bellek içinde 
çalışır), büyük, uzaktan erişim veri kümeleri için önerilmez. 

Örnek verileri modele görünüme bağlı ve görünüme eklenen hizmet görüntüler: 


C ri | □ localhost:10653/todo 


To Do Items 

• Total Items: 50 

• Completed: 17 

• Avs. Priority: 3 

Name Priority Is Doue? 

Task 1 1 True 

Task2 2 False 

Task 3 3 False 

Task 4 4 True 

Task 5 5 False 

Arama verilerini doldurma 

Görünüm ekleme açılır listeleri gibi kullanıcı Arabirimi öğeleri seçeneklerinde doldurmak yararlı olabilir.Cinsiyet, 
durumunu ve diğer tercihlerinizi belirtmek için seçenekleri içeren bir kullanıcı profili form göz önünde 
bulundurun. Bir standart MVC yaklaşımı kullanarak form işleme her biri, bu seçenekler için veri erişim 









Hizmetleri isteyin ve ardından bir model doldurmak için denetleyici içerseydi veya viewBag her bağlanacak 
seçenek kümesi ile. 

Alternatif bir yaklaşım Hizmetleri seçenekleri elde etmek için doğrudan görünümüne ekler. Bu görünüme bu 
görünüm öğesi oluşturma mantığı taşıma denetleyicisi tarafından gereken kod miktarını azaltır. Profil örneği 
form geçirmek bir profil düzenleme formu görüntülemek için denetleyici eylemi yeterlidir: 

using Microsoft.AspNetCore.Mvc; 
using ViewInjectSample.Model; 

namespace ViewInjectSample.Controllers 
{ 

public class ProfileController : Controller 
{ 

[Route("Profile")] 

public IActionResult Index() 

{ 

// TODO: look up profile based on logged-in user 
var profile = new Profile() 

{ 

Name = "Steve", 

FavColor = "Blue", 

Gender = "Male", 

State = new State("Ohio","OH") 

}; 

return View(profile); 

} 

} 

} 


Bu tercihler güncelleştirmek için kullanılan HTML formu açılır listeleri üç özellikleri içerir: 


<- C [ D localhostl 0653/profile 


Update Profile 


Name: 

îteve 

Geııder: 

Male * | 

State: Ohio ▼ 



Far. Color: Blue T 


Bu listeler, görünüme eklenmiş bir hizmet tarafından doldurulur: 
















@using System.Threading.Tasks 
@using ViewlnjectSample.Model.Services 
@model ViewlnjectSample.Model.Profile 
(Şinject ProfileOptionsService Options 
<!DOCTYPE html> 

<html> 

<head> 

<title>Update Profile</title> 

</head> 

<body> 

<div> 

<hl>Update Profile</hl> 

Name: @Html.TextBoxFor(m => m.Name) 

<br/> 

Gender: @Html.DropDownl_ist("Gender ", 

Options.ListGenders().Select(g => 

new SelectListItem() { Text = g, Value = g })) 

<br/> 

State: @Html.DropDownl_istFor(m => m.State.Code., 

Options.ListStates().Select(s => 

new SelectListItem() { Text = s.Name, Value = s.Code})) 

<br /> 

Fav. Color: @Html.DropDownl_ist("FavColor", 

Options.ListColors().Select(c => 

new SelectListItem() { Text = c, Value = c })) 

</div> 

</body> 

</html> 

ProfileOptionsService Yalnızca bu form için gereken verileri sağlamak üzere tasarlanmış bir Ul düzeyi hizmeti 

using System.Collections.Generic; 

namespace ViewlnjectSample.Model.Services 

{ 

public class ProfileOptionsService 

{ 

public List<string> ListGenders() 

{ 

// keeping this simple 

return new List<string>() {"Female", "Male"}; 

} 

public List<State> ListStates() 

{ 

// a few States from USA 

return new List<State>() 

{ 

new State("Alabama"j "AL")j 
new State("Alaska ", "AK")j 
new State("Ohio ", "OH") 

}; 

} 

public List<string> ListColors() 

{ 

return new List<string>() { "Blue"j"Green" , "Red","Yellow" }; 

} 



IMPORTANT 

Bağımlılık ekleme aracılığıyla istek türleri kaydedilecek unutmayın startup.configureservices . Hizmet sağlayıcısı 
aracılığıyla dahili olarak sorgulanır çünkü bir kaydı türü çalışma zamanında bir özel durum oluşturur. GetReguiredService. 


Hizmetleri geçersiz kılma 

Yeni hizmet ekleme ek olarak, bu tekniği de bir sayfada daha önce eklenen Hizmetleri geçersiz kılmak için 
kullanılabilir. Aşağıdaki şekilde ilk örnekte kullanılan sayfasında, kullanılabilir alanların tümünü gösterilmektedir: 

I 


3 Html 

IHtmlHelper< IEnumerable<ToDoltem> > 1 

ÇÇJ Component 

IVİewComponentHelper 

& StatsService 

StatisticsService 

O Uri 

IlIrlHelper 

• * s * a & 

1 0 v s & 


Gördüğünüz gibi varsayılan alanları dahil Htmi , component.ve url (yanı sıra StatsService biz hatalara). 
Örneği için varsayılan HTML Yardımcıları kendinizinkilerle değiştirildiğinden isteseydiniz, kolayca kullanarak 
bunu @inject : 


@using System.Threading.Tasks 
@using ViewInjectSample.Helpers 
(Sinject MyHtmlHelper Html 
<!DOCTYPE html> 

<html> 

<head> 

<title>My Helper</title> 
</head> 

<body> 

<div> 

Test: @Html.Value 
</div> 

</body> 

</html> 


Var olan hizmetleri genişletmek isterseniz, dan devralan veya mevcut bir uygulama ile kendi sarmalama 
sırasında yalnızca bu tekniği kullanabilirsiniz. 

Ayrıca Bkz. 

• Simon Timms Blog: Arama verileri görünümünüzü alma 
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Steve Smith tarafından 

Birim testleri , bir uygulamanın bir bölümünü altyapısından ve bağımlılıklarından yalıtımıyla test etmeyi içerir. Birim 
testi denetleyici mantığı olduğunda, yalnızca tek bir eylemin içerikleri test edilir, onun bağımlılıkları veya çerçevenin 
kendisi değildir. 

Birim test denetleyicileri 

Denetleyicinin davranışına odaklanmak için denetleyici eylemlerinin birim testlerini ayarlayın. Denetleyici birim testi 
Filtreler, yönlendirmeve model bağlamagibi senaryoları önler. Bir isteğe topluca yanıt veren bileşenler arasındaki 
etkileşimleri kapsayan testler, tümleştirme fesf/entarafından işlenir. Tümleştirme testleri hakkında daha fazla bilgi 
için bkz.ASP.NET Core tümleştirme testleri. 

Özel filtreler ve rotalar yazıyorsanız, birim, belirli bir denetleyici eyleminde testlerin bir parçası olarak değil, 
yalıtımına göre test eder. 

Denetleyici birim testlerini göstermek için örnek uygulamada aşağıdaki denetleyiciyi gözden geçirin. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Ana denetleyici bir beyin fırtınası oturumlarının listesini görüntüler ve yeni beyin fırtınası oturumlarının bir POST 
isteğiyle oluşturulmasına izin verir: 




public class HomeController : Controller 

{ 

private readonly IBrainstormSessionRepository _sessionRepository; 

public HomeController(IBrainstormSessionRepository sessionRepository) 

{ 

_sessionRepository = sessionRepository; 

} 

public async Task<IActionResult> Index() 

{ 

var sessionList = await _sessionRepository.ListAsync(); 

var model = sessionList.Select(session => new StormSessionViewModel() 

{ 

Id = session.Id, 

DateCreated = session.DateCreated, 

Name = session.Name, 

IdeaCount = session.Ideas.Count 

}); 

return View(model); 

} 

public class NewSessionModel 

{ 

[Required] 

public string SessionName { get; set; } 

} 

[HttpPost] 

public async Task<IActionResult> Index(NewSessionModel model) 

{ 

if (IModelState.IsValid) 

{ 

return BadRequest(ModelState); 

} 

else 

{ 

await _sessionRepository.AddAsync(new BrainstormSession() 

{ 

DateCreated = DateTimeOffset.Now, 

Name = model.SessionName 

}); 

} 

return RedirectToAction(actionName: nameof(Index)); 

} 

} 

Önceki denetleyici: 

• Açık bağımlılıklar ilkesiniizler. 

• IBrainstormSessionRepository örneğini sağlamak için bağımlılık ekleme (dı) bekliyor. 

• , Moqgibi bir sahte nesne çerçevesi kullanılarak bir moclenmiş IBrainstormSessionRepository hizmeti ile test 
edilebilir. Bir ilişkili nesne , test için kullanılan önceden tanımlanmış bir özellik ve Yöntem davranışları kümesine 
sahip bir fabricobject nesnesidir. Daha fazla bilgi için bkz. tümleştirme testlerine giriş. 

http get index yöntemi döngü veya dallandırma içermez ve yalnızca bir yöntem çağırır. Bu eylemin birim testi: 

• GetTestSessions yöntemini kullanarak IBrainstormSessionRepository hizmetini gizler. GetTestSessions , tarihler 
ve oturum adlarıyla iki adet sahte beyin fırtınası oturumu oluşturur. 


index yöntemini yürütür. 










• Yöntemi tarafından döndürülen sonuç üzerinde onaylama işlemleri yapar: 
o Bir VievvResult döndürülür. 

o VievvDataDictionary. model bir stormSessionviewModei . 
o viewDataDictionary.Model depolanan iki beyin fırtınası oturumu vardır. 


[Fact] 

public async Task Index_ReturnsAViewResult_WithAListOfBrainstormSessions() 

{ 

// Arrange 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.ListAsync()) 

.ReturnsAsync(GetTestSessions()); 
var controller = new HomeController(mockRepo.Object); 

// Act 

var result = await controller.Index(); 

// Assert 

var viewResult = Assert.IsType<ViewResult>(result); 

var model = Assert.IsAssignableFrom<IEnumerable<StormSessionViewModel>>( 
viewResult.ViewData.Model); 

Assert.Equal(2, model.Count()); 

} 


private List<BrainstormSession> GetTestSessions() 

{ 

var sessions = new List<BrainstormSession>(); 
sessions.Add(new BrainstormSession() 

{ 

DateCreated = new DateTime(2016, 7 , 2 ), 

Id = 1 , 

Name = "Test One" 

}); 

sessions.Add(new BrainstormSession() 

{ 

DateCreated = new DateTime(2016, 7 , 1 ), 

Id = 2 , 

Name = "Test Two" 

}); 

return sessions; 

} 

Ana denetleyicinin http post index yöntemi testleri şunları doğrular: 

• ModelState. IsValid faise olduğunda, eylem yöntemi uygun verilerle bir 400 hatalı istek VievvResult döndürür. 

• ModelState.IsValid true : 

o Depodaki Add yöntemi çağrılır. 

o Doğru bağımsız değişkenlerle bir RedirectToActionResult döndürülür. 

Geçersiz bir model durumu, aşağıdaki ilk testte gösterildiği gibi AddModelError kullanılarak hatalar eklenerek test 
edilir: 






[Fact] 

public async Task IndexPost_ReturnsBadRequestResult_WhenModelStateIsInvalid() 

{ 

// Arrange 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.ListAsync()) 

.ReturnsAsync(GetTestSessions()); 
var controller = new HomeController(mockRepo.Object); 
controller.ModelState.AddModelError("SessionName ", "Required"); 
var newSession = new HomeController.NewSessionModel(); 

// Act 

var result = await controller.Index(newSession); 

// Assert 

var badRequestResult = Assert.IsType<BadRequestObjectResult>(result); 

Assert.IsType<SerializableError>(badRequestResult.Value); 

} 

[Fact] 

public async Task IndexPost_ReturnsARedirectAndAddsSession_WhenModelStateIsValid() 

{ 

// Arrange 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.AddAsync(It.IsAny<BrainstormSession>())) 

.Returns(Task.CompletedTask) 

.Verifiable(); 

var controller = new HomeController(mockRepo.Object); 
var newSession = new HomeController.NewSessionModel() 

{ 

SessionName = "Test Name" 

}; 

// Act 

var result = await controller.Index(newSession); 

// Assert 

var redirectToActionResult = Assert.IsType<RedirectToActionResult>(result); 

Assert.Null(redirectToActionResult.ControllerName); 

Assert.Equal("Index ", redirectToActionResult.ActionName); 
mockRepo.Verify(); 

} 

ModelState geçerli olmadığında, bir get isteği için aynı viewResuit döndürülür. Test geçersiz bir modeli geçirmeye 
çalışmıyor. Model bağlama çalışmadığından (bir tümleştirme testi model bağlamayı kullansa da), geçersiz bir 
modelin geçirilmesi geçerli bir yaklaşım değildir. Bu durumda model bağlama sınanmamıştır.Bu birim testleri 
yalnızca eylem yöntemindeki kodu test eder. 

ikinci test ModelState geçerli olduğunda doğrular: 

• Yeni bir BrainstormSession eklenir (depo aracılığıyla). 

• Yöntemi, beklenen özelliklerle bir RedirectToActionResult döndürür. 

Çağrılmayan hiçbir çağrı normalde yok sayılır, ancak kurulum çağrısının sonunda verifiable çağrısı testte sahte 
doğrulamaya izin verir. Bu, beklenen yöntemin çağrılmaması durumunda test başarısız olan mockRepo.verify 
çağrısıyla gerçekleştirilir. 










NOTE 

Bu örnekte kullanılan moq kitaplığı, doğrulanabilir olmayan bir şekilde ("gevşek" bir veya saplamalar olarak da adlandırılır) 
doğrulanabilir veya "katı" olarak karışık bir şekilde karışık bir şekilde karıştırılamaz. Moq İle sahte davranışı 
özelleştirmehakkında daha fazla bilgi edinin. 


Örnek uygulamadaki Sessioncontroller , belirli bir beyin fırtınası oturumuyla ilgili bilgileri görüntüler. Denetleyici 
geçersiz id değerlerle ilgilenme mantığını içerir (bu senaryoları kapsayan aşağıdaki örnekte iki return senaryo 
vardır). Son return ifade görünüme yeni bir stormSessionviewModei döndürür (Controllers/SessionController. cs): 

public class SessionController : Controller 

{ 

private readonly IBrainstormSessionRepository _sessionRepository; 

public Sessioncontroller(IBrainstormSessionRepository sessionRepository) 

{ 

_sessionRepository = sessionRepository; 

} 

public async Task<IActionResult> Index(int? id) 

{ 

if (lid.HasValue) 

{ 

return RedirectToAction(actionName: nameof(Index), 
controllerName: "Home"); 

} 

var session = await _sessionRepository.GetByIdAsync(id.Value); 
if (session == null) 

{ 

return Content("Session not found."); 

} 

var viewModel = new StormSessionViewModel() 

{ 

DateCreated = session.DateCreated, 

Name = session.Name, 

Id = session.Id 

}; 

return View(viewModel); 

} 

} 

Birim testleri, oturum denetleyicisi index eyleminde her bir return senaryosu için bir test içerir: 









[Fact] 

public async Task IndexReturnsARedirectToIndexHomeWhenIdIsNull() 

{ 

// Arrange 

var controller = new SessionController(sessionRepository: null); 

// Act 

var result = await controller.Index(id: null); 

// Assert 

var redirectToActionResult = 

Assert.IsType<RedirectToActionResult>(result); 

Assert.Equal("Home", redirectToActionResult.ControllerName); 

Assert.Equal("Index", redirectToActionResult.ActionName); 

} 

[Fact] 

public async Task IndexReturnsContentWithSessionNotFoundWhenSessionNotFound() 

{ 

// Arrange 

int testSessionld = 1; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync((BrainstormSession)null); 
var controller = new SessionController(mockRepo.Object); 

// Act 

var result = await controller.Index(testSessionId); 

// Assert 

var contentResult = Assert.IsType<ContentResult>(result); 

Assert.Equal("Session not found.", contentResult.Content); 

} 

[Fact] 

public async Task IndexReturnsViewResultWithStormSessionViewModel() 

{ 

// Arrange 

int testSessionld = 1; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync(GetTestSessions().FirstOrDefault( 
s => s.Id == testSessionld)); 
var controller = new SessionController(mockRepo.Object); 

// Act 

var result = await controller.Index(testSessionId); 

// Assert 

var viewResult = Assert.IsType<ViewResult>(result); 
var model = Assert.IsType<StormSessionViewModel>( 
viewResult.ViewData.Model); 

Assert.Equal("Test One", model.Name); 

Assert.Equal(2, model.DateCreated.Day); 

Assert.Equal(testSessionld, model.Id); 

} 

Uygulama, fikirler denetleyicisine geçiş yaparken api/ideas rotasında bir Web API 'SI olarak işlevselliği kullanıma 
sunar: 

• Bir beyin fırtınası oturumuyla ilişkili fikirler ( ideaDTO ) listesi, ForSession yöntemi tarafından döndürülür. 


Create yöntemi bir oturuma yeni fikirler ekler. 








[HttpGet("forsession/{sessionId}") ] 

public async Task<IActionResult> ForSession(int sessionld) 

{ 

var session = await _sessionRepository.GetByIdAsync(sessionId); 
if (session == null) 

{ 

return NotFound(sessionld); 

} 

var result = session.Ideas.Select(idea => new IdeaDTO() 

{ 

Id = idea.Id, 

Name = idea.Name, 

Description = idea.Description, 

DateCreated = idea.DateCreated 
}).ToList(); 

return Ok(result); 

} 

[FlttpPost( "create") ] 

public async Task<IActionResult> Create([FromBody]NewIdeaModel model) 

{ 

if (ÎModelState.IsValid) 

{ 

return BadRequest(ModelState); 

} 

var session = await _sessionRepository.GetByIdAsync(model.Sessionld); 
if (session == null) 

{ 

return NotFound(model.Sessionld); 

} 

var idea = new Idea() 

{ 

DateCreated = DateTimeOffset.Now, 

Description = model. Description., 

Name = model.Name 

}; 

session.Addldea(idea); 

await _sessionRepository.UpdateAsync(session); 
return Ok(session); 

} 

iş etki alanı varlıklarını doğrudan API çağrıları aracılığıyla döndürmekten kaçının. Etki alanı varlıkları: 

• Genellikle istemcinin gerektirdiğinden daha fazla veri içerir. 

• Genel olarak sunulan API ile uygulamanın iç etki alanı modelini gereksiz bir şekilde yapın. 

Etki alanı varlıkları ve istemciye döndürülen türler arasında eşleme gerçekleştirilebilir: 

• Örnek uygulamanın kullandığı şekilde bir LINQ select el ile. Daha fazla bilgi için bkz. LINQ (dil İle tümleşik 
sorgu). 

• Otomatik olarak bir kitaplıkla (örneğin, Automaber). 

Ardından, örnek uygulama, fikirler denetleyicisinin create ve ForSession API yöntemlerine yönelik birim testlerini 
gösterir. 

Örnek uygulama iki ForSession test içerir. İlk test, ForSession geçersiz bir oturum için NotFoundObjectResult 
(HTTP bulunamadı) döndürüp döndürmeyeceğini belirler: 







[Fact] 

public async Task ForSession_ReturnsHttpNotFound_ForInvalidSession() 

{ 

// Arrange 

int testSessionld = 123; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync((BrainstormSession)null); 
var controller = new IdeasController(mockRepo.Object); 

// Act 

var result = awalt controller.ForSession(testSessionld); 

// Assert 

var notFoundObjectResult = Assert.IsType<NotFoundObjectResult>(result); 

Assert.Equal(testSessionIdj notFoundObjectResult.Value); 

} 

ikinci ForSession testi, ForSession geçerli bir oturum için oturum fikirleri ( <List<ideaDTO>> ) listesini döndürüp 
döndürmeyeceğini belirler. Denetimler Ayrıca, Name özelliğinin doğru olduğunu onaylamak için ilk fikri de inceler: 

[Fact] 

public async Task ForSession_ReturnsIdeasForSession() 

{ 

// Arrange 

int testSessionld = 123; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync(GetTestSession()); 
var controller = new IdeasController(mockRepo.Object); 

// Act 

var result = await controller.ForSession(testSessionld); 

// Assert 

var okResult = Assert.IsType<OkObjectResult>(result); 

var returnValue = Assert.IsType<List<IdeaDTO>>(okResult.Value); 

var idea = returnValue.FirstOrDefault(); 

Assert.Equal("One ", idea.Name); 


Modeistate geçersiz olduğunda create yönteminin davranışını test etmek için, örnek uygulama, testin bir parçası 
olarak denetleyiciye bir model hatası ekler. Birim testlerinde model doğrulama veya model bağlamayı sınamayı 
denemeyin—geçersiz bir Modeistate sahip olduğunda eylem yönteminin davranışını test edin: 

[Fact] 

public async Task Create_ReturnsBadRequest_GivenInvalidModel() 

{ 

// Arrange & Act 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
var controller = new IdeasController(mockRepo.Object); 
controller.Modeistate.AddModelError("error", "some error"); 

// Act 

var result = await controller.Create(model: null); 

// Assert 

Assert.IsTypecBadRequestObjectResult>(result); 

} 


create ikinci testi, null döndüren depoya bağlıdır, bu nedenle, sahte depo null döndürecek şekilde yapılandırılır. 









Bir test veritabanı (bellekte veya başka türlü) oluşturmanız gerekmez ve bu sonucu döndüren bir sorgu oluşturun. 
Örnek kodun gösterildiği gibi, test tek bir bildirimde gerçekleştirilebilir: 

[Fact] 

public async Task Create_ReturnsFlttpNotFound_ForInvalidSession() 

{ 

// Arrange 

int testSessionld = 123; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync((BrainstormSession)null); 
var controller = new IdeasController(mockRepo.Object); 

// Act 

var result = await controller.Create(new NewIdeaModel()); 

// Assert 

Assert.IsTypecNotFoundObjectResult>(result); 

} 

Create_ReturnsNewlyCreatedIdeaForSession üçüncü Create testi, deponun UpdateAsync yönteminin çağrıldığım 
doğrular. Sahte, verifiable ile çağrılır ve doğrulanabilen yöntemin yürütüldüğünü onaylamak için, moclenmiş 
deponun verify yöntemi çağırılır. UpdateAsync yönteminin bir tümleştirme testiyle gerçekleştirilebilecek verileri— 
kaydettiğinizden emin olmak için birim testinin sorumluluğu yoktur. 

[Fact] 

public async Task Create_ReturnsNewlyCreatedIdeaForSession() 

{ 

// Arrange 

int testSessionld = 123; 
string testName = "test name"; 
string testDescription = "test description"; 
var testSession = GetTestSession(); 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync(testSession); 

var controller = new IdeasController(mockRepo.Object); 

var newldea = new NewIdeaModel() 

{ 

Description = testDescription., 

Name = testName, 

Sessionld = testSessionld 

}; 

mockRepo.Setup(repo => repo.UpdateAsync(testSession)) 

.Returns(Task.CompletedTask) 

.Verifiable(); 

// Act 

var result = await controller.Create(newldea); 

// Assert 

var okResult = Assert.IsType<OkObjectResult>(result); 

var returnSession = Assert.IsType<BrainstormSession>(okResult.Value); 

mockRepo.Verify(); 

Assert.Equal(2, returnSession.Ideas.Count()); 

Assert.Equal(testName, returnSession.Ideas.LastOrDefault().Name); 

Assert.Equal(testDescription, returnSession.Ideas.LastOrDefault().Description); 

} 


Test ActionResultcT > 








ASP.NET Core 2,1 veya sonraki bir sürümde, actionresult<t > (ActionResult<TValue>) ActionResuit türetilen bir 
tür döndürmenizi veya belirli bir tür döndürmenizi sağlar. 

Örnek uygulama, belirli bir oturum id için List<ideaDTO> döndüren bir yöntemi içerir. Oturum id yoksa, 
denetleyici NotFounddöndürür: 

[HttpGet("forsessionactionresult/{sessionId}")] 

[ProducesResponseType(200)] 

[ProducesResponseType(404)] 

public async Task<ActionResult<List<IdeaDTO>>> ForSessionActionResult(int sessionld) 

{ 

var session = await _sessionRepository.GetByIdAsync(sessionId); 

if (session == null) 

{ 

return NotFound(sessionld); 

} 

var result = session.Ideas.Select(idea => new IdeaDTO() 

{ 

Id = idea.Idj 
Name = idea.Name, 

Description = idea.Description, 

DateCreated = idea.DateCreated 
}).ToList(); 

return result; 

} 

ForSessionActionResult denetleyicisinin iki testi ApildeasControllerTests dahil edilir. 

ilk test, denetleyicinin varolmayan bir oturum id için varolmayan bir fikir listesi ActionResuit döndürdüğünü 
onaylar: 


• ActionResuit türü ActionResult<List<IdeaDTO>> . 

• Result bir NotFoundObjectResult. 


[Fact] 

public async Task ForSessionActionResult_ReturnsNotFoundObjectResultForNonexistentSession() 

{ 

// Arrange 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
var controller = new IdeasController(mockRepo.Object); 
var nonExistentSessionId = 999; 

// Act 

var result = await controller.ForSessionActionResult(nonExistentSessionId); 

// Assert 

var actionResult = Assert.IsType<ActionResult<List<IdeaDTO>>>(result); 

Assert.IsType<NotFoundObjectResult>(actionResult.Result); 

} 

Geçerli bir oturum id için ikinci test, yöntemin döndürdüğünü doğrular: 

• List<IdeaDTO> türüne sahip bir ActionResuit. 

• ActionResultct >. Değer bir List<ideaDTO> türüdür. 

• Listedeki ilk öğe, sahte oturumda saklanan fikrle eşleşen geçerli bir fikrdir ( GetTestsession çağırarak elde edilir). 


















[Fact] 

public async Task ForSessionActionResult_ReturnsIdeasForSession() 

{ 

// Arrange 

int testSessionld = 123; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync(GetTestSession()); 
var controller = new IdeasController(mockRepo.Object); 

// Act 

var result = await controller.ForSessionActionResult(testSessionld); 

// Assert 

var actionResult = Assert.IsType<ActionResult<List<IdeaDTO>>>(result); 
var returnValue = Assert.IsType<List<IdeaDTO>>(actionResult.Value); 
var idea = returnValue. FirstOrDefault(); 

Assert.Equal("One ", idea.Name); 

} 


Örnek uygulama, belirli bir oturum için yeni idea oluşturmak üzere bir yöntemi de içerir. Denetleyici şunu 
döndürür: 

• geçersiz bir model için BadRequest. 

• oturum yoksa NotFound. 

• oturum yeni fikrle güncelleştirildiği zaman CreatedAtAction. 


[FlttpPost ("createaction result") ] 

[ProducesResponseType(201)] 

[ProducesResponseType(400)] 

[ProducesResponseType(404)] 

public async Task<ActionResult<BrainstormSession>> CreateActionResult([FromBody]NewIdeaModel model) 

{ 

if (ÎModelState.IsValid) 

{ 

return BadRequest(ModelState); 

} 

var session = await _sessionRepository.GetByIdAsync(model.SessionId); 

if (session == null) 

{ 

return NotFound(model.Sessionld); 

} 

var idea = new Idea() 

{ 

DateCreated = DateTimeOffset.Now, 

Description = model. Description., 

Name = model.Name 

}; 

session.Addldea(idea); 

await _sessionRepository.UpdateAsync(session); 

return CreatedAtAction(nameof(CreateActionResult ), new { id = session.Id }, session); 

} 

CreateActionResult ÜÇ test ApildeasControllerTests dahil edilir, 
ilk metin, geçersiz bir model için BadReguest döndürüldüğünü onaylar. 









[Fact] 

public async Task CreateActionResult_ReturnsBadRequest_GivenInvalidModelO 

{ 

// Arrange & Act 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
var controller = new IdeasController(mockRepo.Object); 
controller.ModelState.AddModelError("error", "some error"); 

// Act 

var result = await controller.CreateActionResult(model: null); 

// Assert 

var actionResult = Assert.IsType<ActionResult<BrainstormSession>>(result); 

Assert.IsType<BadRequestObjectResult>(actionResult.Result); 

} 

ikinci test, oturum yoksa NotFound döndürülüp döndürülmediğini denetler. 

[Fact] 

public async Task CreateActionResult_ReturnsNotFoundObjectResultForNonexistentSession() 

{ 

// Arrange 

var nonExistentSessionId = 999; 

string testName = "test name"; 

string testDescription = "test description"; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 

var controller = new IdeasController(mockRepo.Object); 

var newldea = new NewIdeaModel() 

{ 

Description = testDescription., 

Name = testName, 

Sessionld = nonExistentSessionId 

}; 

// Act 

var result = await controller.CreateActionResult(newIdea); 

// Assert 

var actionResult = Assert.IsType<ActionResult<BrainstormSession>>(result); 

Assert.IsTypecNotFoundObjectResult>(actionResult.Result); 

} 

Geçerli bir oturum id için son test şunları onaylar: 

• Yöntemi, bir BrainstormSession türü ile ActionResult döndürür. 

• ActionResult<t >. Sonuç bir CreatedAtActionResult. createdAtActionResuit , bir Location üst bilgisiyle 207 
tarafından oluşturulan bir yanıta benzerdir. 

• ActionResult<t >. Değer bir BrainstormSession türüdür. 

• Oturumu güncelleştirmek için kullanılan sahte çağrı, updateAsync(testsession) çağrıldı, verifiable yöntemi 
çağrısı onaylamalarda mockRepo.verify() yürütülerek denetlenir. 

• Oturum için iki idea nesnesi döndürülür. 

• Son öğe (sahte çağrının updateAsync tarafından eklenen idea ) testteki oturuma eklenen newidea eşleşir. 





















[Fact] 

public async Task CreateActionResult_ReturnsNewlyCreatedIdeaForSession() 

{ 

// Arrange 

int testSessionld = 123; 
string testIMame = "test name"; 
string testDescription = "test description"; 
var testSession = GetTestSession(); 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync(testSession); 

var controller = new IdeasController(mockRepo.Object); 

var newldea = new NewIdeaModel() 

{ 

Description = testDescription., 

Name = testName, 

Sessionld = testSessionld 

}; 

mockRepo.Setup(repo => repo.UpdateAsync(testSession)) 

.Returns(Task.CompletedTask) 

.Verifiable(); 

// Act 

var result = await controller.CreateActionResult(newIdea); 

// Assert 

var actionResult = Assert.IsType<ActionResult<BrainstormSession>>(result); 
var createdAtActionResult = Assert.IsType<CreatedAtActionResult>(actionResult.Result); 
var returnValue = Assert.IsType<BrainstormSession>(createdAtActionResult.Value); 
mockRepo.Verify(); 

Assert.Equal(2, returnValue.Ideas.Count()); 

Assert.Equal(testName, returnValue.Ideas.LastOrDefault().Name); 

Assert.Equal(testDescription, returnValue.Ideas.LastOrDefault().Description); 


Denetleyiciler herhangi BİR ASP.NET Core MVC uygulamasında merkezi bir rol oynar.Bu nedenle, denetleyicilerin 
amaçlanan gibi davrandığına güvenmelisiniz. Otomatik testler, uygulama bir üretim ortamına dağıtılmadan önce 
hataları tespit edebilir. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Denetleyici mantığının birim testleri 

Birim testleri , bir uygulamanın bir bölümünü altyapısından ve bağımlılıklarından yalıtımıyla test etmeyi içerir. Birim 
testi denetleyici mantığı olduğunda, yalnızca tek bir eylemin içerikleri test edilir, onun bağımlılıkları veya çerçevenin 
kendisi değildir. 

Denetleyicinin davranışına odaklanmak için denetleyici eylemlerinin birim testlerini ayarlayın. Denetleyici birim testi 
Filtreler, yönlendirmeye model bağlamagibi senaryoları önler. Bir isteğe topluca yanıt veren bileşenler arasındaki 
etkileşimleri kapsayan testler, tümleştirme fesf/en'tarafından işlenir. Tümleştirme testleri hakkında daha fazla bilgi 
için bkz.ASP.NET Core tümleştirme testleri. 

Özel filtreler ve rotalar yazıyorsanız, birim, belirli bir denetleyici eyleminde testlerin bir parçası olarak değil, 
yalıtımına göre test eder. 

Denetleyici birim testlerini göstermek için örnek uygulamada aşağıdaki denetleyiciyi gözden geçirin. Ana 
denetleyici bir beyin fırtınası oturumlarının listesini görüntüler ve yeni beyin fırtınası oturumlarının bir POST 
isteğiyle oluşturulmasına izin verir: 



public class HomeController : Controller 

{ 

private readonly IBrainstormSessionRepository _sessionRepository; 

public HomeController(IBrainstormSessionRepository sessionRepository) 

{ 

_sessionRepository = sessionRepository; 

} 

public async Task<IActionResult> Index() 

{ 

var sessionList = await _sessionRepository.ListAsync(); 

var model = sessionList.Select(session => new StormSessionViewModel() 

{ 

Id = session.Id, 

DateCreated = session.DateCreated, 

Name = session.Name, 

IdeaCount = session.Ideas.Count 

}); 

return View(model); 

} 

public class NewSessionModel 

{ 

[Required] 

public string SessionName { get; set; } 

} 

[HttpPost] 

public async Task<IActionResult> Index(NewSessionModel model) 

{ 

if (IModelState.IsValid) 

{ 

return BadRequest(ModelState); 

} 

else 

{ 

await _sessionRepository.AddAsync(new BrainstormSession() 

{ 

DateCreated = DateTimeOffset.Now, 

Name = model.SessionName 

}); 

} 

return RedirectToAction(actionName: nameof(Index)); 

} 

} 

Önceki denetleyici: 

• Açık bağımlılıklar ilkesiniizler. 

• IBrainstormSessionRepository örneğini sağlamak için bağımlılık ekleme (dı) bekliyor. 

• , Moqgibi bir sahte nesne çerçevesi kullanılarak bir moclenmiş IBrainstormSessionRepository hizmeti ile test 
edilebilir. Bir ilişkili nesne , test için kullanılan önceden tanımlanmış bir özellik ve Yöntem davranışları kümesine 
sahip bir fabricobject nesnesidir. Daha fazla bilgi için bkz. tümleştirme testlerine giriş. 

http get index yöntemi döngü veya dallandırma içermez ve yalnızca bir yöntem çağırır. Bu eylemin birim testi: 

• GetTestSessions yöntemini kullanarak IBrainstormSessionRepository hizmetini gizler. GetTestSessions , tarihler 
ve oturum adlarıyla iki adet sahte beyin fırtınası oturumu oluşturur. 


index yöntemini yürütür. 










• Yöntemi tarafından döndürülen sonuç üzerinde onaylama işlemleri yapar: 
o Bir VievvResult döndürülür. 

o VievvDataDictionary. model bir stormSessionviewModei . 
o viewDataDictionary.Model depolanan iki beyin fırtınası oturumu vardır. 


[Fact] 

public async Task Index_ReturnsAViewResult_WithAListOfBrainstormSessions() 

{ 

// Arrange 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.ListAsync()) 

.ReturnsAsync(GetTestSessions()); 
var controller = new HomeController(mockRepo.Object); 

// Act 

var result = await controller.Index(); 

// Assert 

var viewResult = Assert.IsType<ViewResult>(result); 

var model = Assert.IsAssignableFrom<IEnumerable<StormSessionViewModel>>( 
viewResult.ViewData.Model); 

Assert.Equal(2, model.Count()); 

} 


private List<BrainstormSession> GetTestSessions() 

{ 

var sessions = new List<BrainstormSession>(); 
sessions.Add(new BrainstormSession() 

{ 

DateCreated = new DateTime(2016, 7 , 2 ), 

Id = 1 , 

Name = "Test One" 

}); 

sessions.Add(new BrainstormSession() 

{ 

DateCreated = new DateTime(2016, 7 , 1 ), 

Id = 2 , 

Name = "Test Two" 

}); 

return sessions; 

} 

Ana denetleyicinin http post index yöntemi testleri şunları doğrular: 

• ModelState. IsValid faise olduğunda, eylem yöntemi uygun verilerle bir 400 hatalı istek VievvResult döndürür. 

• ModelState.IsValid true : 

o Depodaki Add yöntemi çağrılır. 

o Doğru bağımsız değişkenlerle bir RedirectToActionResult döndürülür. 

Geçersiz bir model durumu, aşağıdaki ilk testte gösterildiği gibi AddModelError kullanılarak hatalar eklenerek test 
edilir: 






[Fact] 

public async Task IndexPost_ReturnsBadRequestResult_WhenModelStateIsInvalid() 

{ 

// Arrange 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.ListAsync()) 

.ReturnsAsync(GetTestSessions()); 
var controller = new HomeController(mockRepo.Object); 
controller.ModelState.AddModelError("SessionName ", "Required"); 
var newSession = new HomeController.NewSessionModel(); 

// Act 

var result = await controller.Index(newSession); 

// Assert 

var badRequestResult = Assert.IsType<BadRequestObjectResult>(result); 

Assert.IsType<SerializableError>(badRequestResult.Value); 

} 

[Fact] 

public async Task IndexPost_ReturnsARedirectAndAddsSession_WhenModelStateIsValid() 

{ 

// Arrange 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.AddAsync(It.IsAny<BrainstormSession>())) 

.Returns(Task.CompletedTask) 

.Verifiable(); 

var controller = new HomeController(mockRepo.Object); 
var newSession = new HomeController.NewSessionModel() 

{ 

SessionName = "Test Name" 

}; 

// Act 

var result = await controller.Index(newSession); 

// Assert 

var redirectToActionResult = Assert.IsType<RedirectToActionResult>(result); 

Assert.Null(redirectToActionResult.ControllerName); 

Assert.Equal("Index ", redirectToActionResult.ActionName); 
mockRepo.Verify(); 

} 

ModelState geçerli olmadığında, bir get isteği için aynı viewResuit döndürülür. Test geçersiz bir modeli geçirmeye 
çalışmıyor. Model bağlama çalışmadığından (bir tümleştirme testi model bağlamayı kullansa da), geçersiz bir 
modelin geçirilmesi geçerli bir yaklaşım değildir. Bu durumda model bağlama sınanmamıştır.Bu birim testleri 
yalnızca eylem yöntemindeki kodu test eder. 

ikinci test ModelState geçerli olduğunda doğrular: 

• Yeni bir BrainstormSession eklenir (depo aracılığıyla). 

• Yöntemi, beklenen özelliklerle bir RedirectToActionResult döndürür. 

Çağrılmayan hiçbir çağrı normalde yok sayılır, ancak kurulum çağrısının sonunda verifiable çağrısı testte sahte 
doğrulamaya izin verir. Bu, beklenen yöntemin çağrılmaması durumunda test başarısız olan mockRepo.verify 
çağrısıyla gerçekleştirilir. 










NOTE 

Bu örnekte kullanılan moq kitaplığı, doğrulanabilir olmayan bir şekilde ("gevşek" bir veya saplamalar olarak da adlandırılır) 
doğrulanabilir veya "katı" olarak karışık bir şekilde karışık bir şekilde karıştırılamaz. Moq İle sahte davranışı 
özelleştirmehakkında daha fazla bilgi edinin. 


Örnek uygulamadaki Sessioncontroller , belirli bir beyin fırtınası oturumuyla ilgili bilgileri görüntüler. Denetleyici 
geçersiz id değerlerle ilgilenme mantığını içerir (bu senaryoları kapsayan aşağıdaki örnekte iki return senaryo 
vardır). Son return ifade görünüme yeni bir stormSessionviewModei döndürür (Controllers/SessionController. cs): 

public class SessionController : Controller 

{ 

private readonly IBrainstormSessionRepository _sessionRepository; 

public Sessioncontroller(IBrainstormSessionRepository sessionRepository) 

{ 

_sessionRepository = sessionRepository; 

} 

public async Task<IActionResult> Index(int? id) 

{ 

if (lid.HasValue) 

{ 

return RedirectToAction(actionName: nameof(Index), 
controllerName: "Home"); 

} 

var session = await _sessionRepository.GetByIdAsync(id.Value); 
if (session == null) 

{ 

return Content("Session not found."); 

} 

var viewModel = new StormSessionViewModel() 

{ 

DateCreated = session.DateCreated, 

Name = session.Name, 

Id = session.Id 

}; 

return View(viewModel); 

} 

} 

Birim testleri, oturum denetleyicisi index eyleminde her bir return senaryosu için bir test içerir: 









[Fact] 

public async Task IndexReturnsARedirectToIndexHomeWhenIdIsNull() 

{ 

// Arrange 

var controller = new SessionController(sessionRepository: null); 

// Act 

var result = await controller.Index(id: null); 

// Assert 

var redirectToActionResult = 

Assert.IsType<RedirectToActionResult>(result); 

Assert.Equal("Home", redirectToActionResult.ControllerName); 

Assert.Equal("Index", redirectToActionResult.ActionName); 

} 

[Fact] 

public async Task IndexReturnsContentWithSessionNotFoundWhenSessionNotFound() 

{ 

// Arrange 

int testSessionld = 1; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync((BrainstormSession)null); 
var controller = new SessionController(mockRepo.Object); 

// Act 

var result = await controller.Index(testSessionId); 

// Assert 

var contentResult = Assert.IsType<ContentResult>(result); 

Assert.Equal("Session not found.", contentResult.Content); 

} 

[Fact] 

public async Task IndexReturnsViewResultWithStormSessionViewModel() 

{ 

// Arrange 

int testSessionld = 1; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync(GetTestSessions().FirstOrDefault( 
s => s.Id == testSessionld)); 
var controller = new SessionController(mockRepo.Object); 

// Act 

var result = await controller.Index(testSessionId); 

// Assert 

var viewResult = Assert.IsType<ViewResult>(result); 
var model = Assert.IsType<StormSessionViewModel>( 
viewResult.ViewData.Model); 

Assert.Equal("Test One", model.Name); 

Assert.Equal(2, model.DateCreated.Day); 

Assert.Equal(testSessionld, model.Id); 

} 

Uygulama, fikirler denetleyicisine geçiş yaparken api/ideas rotasında bir Web API 'SI olarak işlevselliği kullanıma 
sunar: 

• Bir beyin fırtınası oturumuyla ilişkili fikirler ( ideaDTO ) listesi, ForSession yöntemi tarafından döndürülür. 


Create yöntemi bir oturuma yeni fikirler ekler. 








[HttpGet("forsession/{sessionId}") ] 

public async Task<IActionResult> ForSession(int sessionld) 

{ 

var session = await _sessionRepository.GetByIdAsync(sessionId); 
if (session == null) 

{ 

return NotFound(sessionld); 

} 

var result = session.Ideas.Select(idea => new IdeaDTO() 

{ 

Id = idea.Id, 

Name = idea.Name, 

Description = idea.Description, 

DateCreated = idea.DateCreated 
}).ToList(); 

return Ok(result); 

} 

[FlttpPost( "create") ] 

public async Task<IActionResult> Create([FromBody]NewIdeaModel model) 

{ 

if (ÎModelState.IsValid) 

{ 

return BadRequest(ModelState); 

} 

var session = await _sessionRepository.GetByIdAsync(model.Sessionld); 
if (session == null) 

{ 

return NotFound(model.Sessionld); 

} 

var idea = new Idea() 

{ 

DateCreated = DateTimeOffset.Now, 

Description = model. Description., 

Name = model.Name 

}; 

session.Addldea(idea); 

await _sessionRepository.UpdateAsync(session); 
return Ok(session); 

} 

iş etki alanı varlıklarını doğrudan API çağrıları aracılığıyla döndürmekten kaçının. Etki alanı varlıkları: 

• Genellikle istemcinin gerektirdiğinden daha fazla veri içerir. 

• Genel olarak sunulan API ile uygulamanın iç etki alanı modelini gereksiz bir şekilde yapın. 

Etki alanı varlıkları ve istemciye döndürülen türler arasında eşleme gerçekleştirilebilir: 

• Örnek uygulamanın kullandığı şekilde bir LINQ select el ile. Daha fazla bilgi için bkz. LINQ (dil İle tümleşik 
sorgu). 

• Otomatik olarak bir kitaplıkla (örneğin, Automaber). 

Ardından, örnek uygulama, fikirler denetleyicisinin create ve ForSession API yöntemlerine yönelik birim testlerini 
gösterir. 

Örnek uygulama iki ForSession test içerir. İlk test, ForSession geçersiz bir oturum için NotFoundObjectResult 
(HTTP bulunamadı) döndürüp döndürmeyeceğini belirler: 







[Fact] 

public async Task ForSession_ReturnsHttpNotFound_ForInvalidSession() 

{ 

// Arrange 

int testSessionld = 123; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync((BrainstormSession)null); 
var controller = new IdeasController(mockRepo.Object); 

// Act 

var result = awalt controller.ForSession(testSessionld); 

// Assert 

var notFoundObjectResult = Assert.IsType<NotFoundObjectResult>(result); 

Assert.Equal(testSessionIdj notFoundObjectResult.Value); 

} 

ikinci ForSession testi, ForSession geçerli bir oturum için oturum fikirleri ( <List<ideaDTO>> ) listesini döndürüp 
döndürmeyeceğini belirler. Denetimler Ayrıca, Name özelliğinin doğru olduğunu onaylamak için ilk fikri de inceler: 

[Fact] 

public async Task ForSession_ReturnsIdeasForSession() 

{ 

// Arrange 

int testSessionld = 123; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync(GetTestSession()); 
var controller = new IdeasController(mockRepo.Object); 

// Act 

var result = await controller.ForSession(testSessionld); 

// Assert 

var okResult = Assert.IsType<OkObjectResult>(result); 

var returnValue = Assert.IsType<List<IdeaDTO>>(okResult.Value); 

var idea = returnValue.FirstOrDefault(); 

Assert.Equal("One ", idea.Name); 


Modeistate geçersiz olduğunda create yönteminin davranışını test etmek için, örnek uygulama, testin bir parçası 
olarak denetleyiciye bir model hatası ekler. Birim testlerinde model doğrulama veya model bağlamayı sınamayı 
denemeyin—geçersiz bir Modeistate sahip olduğunda eylem yönteminin davranışını test edin: 

[Fact] 

public async Task Create_ReturnsBadRequest_GivenInvalidModel() 

{ 

// Arrange & Act 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
var controller = new IdeasController(mockRepo.Object); 
controller.Modeistate.AddModelError("error", "some error"); 

// Act 

var result = await controller.Create(model: null); 

// Assert 

Assert.IsTypecBadRequestObjectResult>(result); 

} 


create ikinci testi, null döndüren depoya bağlıdır, bu nedenle, sahte depo null döndürecek şekilde yapılandırılır. 









Bir test veritabanı (bellekte veya başka türlü) oluşturmanız gerekmez ve bu sonucu döndüren bir sorgu oluşturun. 
Örnek kodun gösterildiği gibi, test tek bir bildirimde gerçekleştirilebilir: 

[Fact] 

public async Task Create_ReturnsFlttpNotFound_ForInvalidSession() 

{ 

// Arrange 

int testSessionld = 123; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync((BrainstormSession)null); 
var controller = new IdeasController(mockRepo.Object); 

// Act 

var result = await controller.Create(new NewIdeaModel()); 

// Assert 

Assert.IsTypecNotFoundObjectResult>(result); 

} 

Create_ReturnsNewlyCreatedIdeaForSession üçüncü Create testi, deponun UpdateAsync yönteminin çağrıldığım 
doğrular. Sahte, verifiable ile çağrılır ve doğrulanabilen yöntemin yürütüldüğünü onaylamak için, moclenmiş 
deponun verify yöntemi çağırılır. UpdateAsync yönteminin bir tümleştirme testiyle gerçekleştirilebilecek verileri— 
kaydettiğinizden emin olmak için birim testinin sorumluluğu yoktur. 

[Fact] 

public async Task Create_ReturnsNewlyCreatedIdeaForSession() 

{ 

// Arrange 

int testSessionld = 123; 
string testName = "test name"; 
string testDescription = "test description"; 
var testSession = GetTestSession(); 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync(testSession); 

var controller = new IdeasController(mockRepo.Object); 

var newldea = new NewIdeaModel() 

{ 

Description = testDescription., 

Name = testName, 

Sessionld = testSessionld 

}; 

mockRepo.Setup(repo => repo.UpdateAsync(testSession)) 

.Returns(Task.CompletedTask) 

.Verifiable(); 

// Act 

var result = await controller.Create(newldea); 

// Assert 

var okResult = Assert.IsType<OkObjectResult>(result); 

var returnSession = Assert.IsType<BrainstormSession>(okResult.Value); 

mockRepo.Verify(); 

Assert.Equal(2, returnSession.Ideas.Count()); 

Assert.Equal(testName, returnSession.Ideas.LastOrDefault().Name); 

Assert.Equal(testDescription, returnSession.Ideas.LastOrDefault().Description); 

} 


Test ActionResultcT > 








ASP.NET Core 2,1 veya sonraki bir sürümde, actionresult<t > (ActionResult<TValue>) ActionResuit türetilen bir 
tür döndürmenizi veya belirli bir tür döndürmenizi sağlar. 

Örnek uygulama, belirli bir oturum id için List<ideaDTO> döndüren bir yöntemi içerir. Oturum id yoksa, 
denetleyici NotFounddöndürür: 

[HttpGet("forsessionactionresult/{sessionId}")] 

[ProducesResponseType(200)] 

[ProducesResponseType(404)] 

public async Task<ActionResult<List<IdeaDTO>>> ForSessionActionResult(int sessionld) 

{ 

var session = await _sessionRepository.GetByIdAsync(sessionId); 

if (session == null) 

{ 

return NotFound(sessionld); 

} 

var result = session.Ideas.Select(idea => new IdeaDTO() 

{ 

Id = idea.Idj 
Name = idea.Name, 

Description = idea.Description, 

DateCreated = idea.DateCreated 
}).ToList(); 

return result; 

} 

ForSessionActionResult denetleyicisinin iki testi ApildeasControllerTests dahil edilir. 

ilk test, denetleyicinin varolmayan bir oturum id için varolmayan bir fikir listesi ActionResuit döndürdüğünü 
onaylar: 


• ActionResuit türü ActionResult<List<IdeaDTO>> . 

• Result bir NotFoundObjectResult. 


[Fact] 

public async Task ForSessionActionResult_ReturnsNotFoundObjectResultForNonexistentSession() 

{ 

// Arrange 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
var controller = new IdeasController(mockRepo.Object); 
var nonExistentSessionId = 999; 

// Act 

var result = await controller.ForSessionActionResult(nonExistentSessionId); 

// Assert 

var actionResult = Assert.IsType<ActionResult<List<IdeaDTO>>>(result); 

Assert.IsType<NotFoundObjectResult>(actionResult.Result); 

} 

Geçerli bir oturum id için ikinci test, yöntemin döndürdüğünü doğrular: 

• List<IdeaDTO> türüne sahip bir ActionResuit. 

• ActionResultct >. Değer bir List<ideaDTO> türüdür. 

• Listedeki ilk öğe, sahte oturumda saklanan fikrle eşleşen geçerli bir fikrdir ( GetTestsession çağırarak elde edilir). 


















[Fact] 

public async Task ForSessionActionResult_ReturnsIdeasForSession() 

{ 

// Arrange 

int testSessionld = 123; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync(GetTestSession()); 
var controller = new IdeasController(mockRepo.Object); 

// Act 

var result = await controller.ForSessionActionResult(testSessionld); 

// Assert 

var actionResult = Assert.IsType<ActionResult<List<IdeaDTO>>>(result); 
var returnValue = Assert.IsType<List<IdeaDTO>>(actionResult.Value); 
var idea = returnValue. FirstOrDefault(); 

Assert.Equal("One ", idea.Name); 

} 


Örnek uygulama, belirli bir oturum için yeni idea oluşturmak üzere bir yöntemi de içerir. Denetleyici şunu 
döndürür: 

• geçersiz bir model için BadRequest. 

• oturum yoksa NotFound. 

• oturum yeni fikrle güncelleştirildiği zaman CreatedAtAction. 


[FlttpPost ("createaction result") ] 

[ProducesResponseType(201)] 

[ProducesResponseType(400)] 

[ProducesResponseType(404)] 

public async Task<ActionResult<BrainstormSession>> CreateActionResult([FromBody]NewIdeaModel model) 

{ 

if (ÎModelState.IsValid) 

{ 

return BadRequest(ModelState); 

} 

var session = await _sessionRepository.GetByIdAsync(model.SessionId); 

if (session == null) 

{ 

return NotFound(model.Sessionld); 

} 

var idea = new Idea() 

{ 

DateCreated = DateTimeOffset.Now, 

Description = model. Description., 

Name = model.Name 

}; 

session.Addldea(idea); 

await _sessionRepository.UpdateAsync(session); 

return CreatedAtAction(nameof(CreateActionResult ), new { id = session.Id }, session); 

} 

CreateActionResult ÜÇ test ApildeasControllerTests dahil edilir, 
ilk metin, geçersiz bir model için BadReguest döndürüldüğünü onaylar. 









[Fact] 

public async Task CreateActionResult_ReturnsBadRequest_GivenInvalidModelO 

{ 

// Arrange & Act 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
var controller = new IdeasController(mockRepo.Object); 
controller.ModelState.AddModelError("error", "some error"); 

// Act 

var result = await controller.CreateActionResult(model: null); 

// Assert 

var actionResult = Assert.IsType<ActionResult<BrainstormSession>>(result); 

Assert.IsType<BadRequestObjectResult>(actionResult.Result); 

} 

ikinci test, oturum yoksa NotFound döndürülüp döndürülmediğini denetler. 

[Fact] 

public async Task CreateActionResult_ReturnsNotFoundObjectResultForNonexistentSession() 

{ 

// Arrange 

var nonExistentSessionId = 999; 

string testName = "test name"; 

string testDescription = "test description"; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 

var controller = new IdeasController(mockRepo.Object); 

var newldea = new NewIdeaModel() 

{ 

Description = testDescription., 

Name = testName, 

Sessionld = nonExistentSessionId 

}; 

// Act 

var result = await controller.CreateActionResult(newIdea); 

// Assert 

var actionResult = Assert.IsType<ActionResult<BrainstormSession>>(result); 

Assert.IsTypecNotFoundObjectResult>(actionResult.Result); 

} 

Geçerli bir oturum id için son test şunları onaylar: 

• Yöntemi, bir BrainstormSession türü ile ActionResult döndürür. 

• ActionResult<t >. Sonuç bir CreatedAtActionResult. createdAtActionResuit , bir Location üst bilgisiyle 207 
tarafından oluşturulan bir yanıta benzerdir. 

• ActionResult<t >. Değer bir BrainstormSession türüdür. 

• Oturumu güncelleştirmek için kullanılan sahte çağrı, updateAsync(testsession) çağrıldı, verifiable yöntemi 
çağrısı onaylamalarda mockRepo.verify() yürütülerek denetlenir. 

• Oturum için iki idea nesnesi döndürülür. 

• Son öğe (sahte çağrının updateAsync tarafından eklenen idea ) testteki oturuma eklenen newidea eşleşir. 





















[Fact] 

public async Task CreateActionResult_ReturnsNewlyCreatedIdeaForSession() 

{ 

// Arrange 

int testSessionld = 123; 
string testIMame = "test name"; 
string testDescription = "test description"; 
var testSession = GetTestSession(); 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync(testSession); 

var controller = new IdeasController(mockRepo.Object); 

var newldea = new NewIdeaModel() 

{ 

Description = testDescription., 

Name = testName, 

Sessionld = testSessionld 

}; 

mockRepo.Setup(repo => repo.UpdateAsync(testSession)) 

.Returns(Task.CompletedTask) 

.Verifiable(); 

// Act 

var result = await controller.CreateActionResult(newIdea); 

// Assert 

var actionResult = Assert.IsType<ActionResult<BrainstormSession>>(result); 
var createdAtActionResult = Assert.IsType<CreatedAtActionResult>(actionResult.Result); 
var returnValue = Assert.IsType<BrainstormSession>(createdAtActionResult.Value); 
mockRepo.Verify(); 

Assert.Equal(2, returnValue.Ideas.Count()); 

Assert.Equal(testName, returnValue.Ideas.LastOrDefault().Name); 

Assert.Equal(testDescription, returnValue.Ideas.LastOrDefault().Description); 


Ek kaynaklar 

• ASP.NET Core tümleştirme testleri 

• Visual Studio ile birim testleri oluşturma ve çalıştırma 

• ASP.NET Core - MVC İçin Mysınanan. AspNetCore. Mvc-Floent test Kitaplığı , MVC ve Web API uygulamalarını 
test etmek için akıcı bir arabirim sağlar. (Microsoft tarafından korunmaz veya desteklenmez.) 
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Daniel Roth ve Luke Latham tarafından 
Blazorhoş geldiniz! 

Blazor, .NET ile etkileşimli istemci tarafı Web Kullanıcı arabirimi oluşturmaya yönelik bir çerçevedir: 

• JavaScript yerine zengin etkileşimli Uıusing C# oluşturma. 

• .NET 1 te yazılmış sunucu tarafı ve istemci tarafı uygulama mantığını paylaşabilirsiniz. 

• Mobil tarayıcılar dahil olmak üzere geniş tarayıcı desteği için Kullanıcı arabirimini HTML ve CSS olarak 
işleme. 

istemci tarafı vveb geliştirme için .N ET kullanmak aşağıdaki avantajları sunar: 

• JavaScript C# yerine kodu yazın. 

• .N ET kitaplıklarının mevcut .N ET ekosisteminden yararlanın. 

• Sunucu ve istemci arasında uygulama mantığını paylaşma. 

• Avantajı. N ET 1 in performans, güvenilirlik ve güvenlik. 

• Windows, Linux ve macOS 'ta Visual Studio ile üretken olun. 

• Kararlı, özellik açısından zengin ve kullanımı kolay olan ortak diller, çerçeveler ve araçlar kümesi oluşturun. 

Bileşenler 

Blazor uygulamalar biieşenleriteme\ alır. Blazor bir bileşen, bir sayfa, iletişim kutusu veya veri girişi formu gibi 
bir kullanıcı arabirimi öğesidir. 

Bileşenler, .NET Derlemeleriyle yerleşik olarak bulunan .NET sınıflarıdır: 

• Esnek kullanıcı arabirimi işleme mantığını tanımlayın. 

• Kullanıcı olaylarını işleyin. 

• iç içe ve yeniden kullanılabilir olabilir. 

• , Razor sınıfı kitaplıkları veya NuGet paketleriolarak paylaşılabilir ve dağıtılabilir. 

Bileşen sınıfı genellikle. Razor dosya uzantısına sahip bir Razor biçimlendirme sayfası biçiminde yazılır. Blazor 
bileşenler, resmi olarak Razor bileşenleriolarak adlandırılır. Razor, geliştirici üretkenliği için tasarlanan C# kodla 
HTML işaretlemesini birleştirmek için bir sözdizimidir. Razor, IntelliSense desteğiyle aynı dosyada HTML 
işaretlemesi ve C# arasında geçiş yapmanıza olanak sağlar. Razor Pages ve MVC de Razor kullanır, istek/yanıt 
modeli etrafında oluşturulan Razor Pages ve MVC 'nin aksine, bileşenler özellikle istemci tarafı Ul mantığı ve 
bileşimi için kullanılır. 

Aşağıdaki Razor biçimlendirmesi, başka bir bileşen içinde iç içe kullanılabilecek bir bileşeni ( İletişim kutusu. 
Razor) gösterir: 




<div> 

<hl>@Title</hl> 

(ŞChildContent 

<button @onclick="OnYes">Yes!</button> 

</div> 

@code { 

[Parameter] 

public string Title { get; set; } 

[Parameter] 

public RenderFragment ChildContent { get; set; } 

private void OnYes() 

{ 

Console.WriteLine("Write to the console in C#! 'Yes' button was selected."); 

} 


iletişim kutusunun gövde içeriği ( ChildContent ) ve başlığı ( Title ), bu bileşeni Kullanıcı arabiriminde kullanan 
bileşen tarafından sağlanır. onYes düğmenin onciick C# olayı tarafından tetiklenen bir yöntemdir. 

Blazor, Ul bileşimi için doğal HTML etiketleri kullamr.HTML öğeleri, bileşenleri belirtir ve bir etiketin 
öznitelikleri değerleri bir bileşenin özelliklerine iletir. 

Aşağıdaki örnekte index bileşeni Dialog bileşenini kullanır. ChildContent ve Title , <Diaiog> öğesinin 
özniteliklerine ve içeriğine göre ayarlanır. 

Index. Razor: 


@page "/" 

<hl>Hello, world!</hl> 

Welcome to your new app. 

<Dialog Title="Blazor"> 

Do you want to <i>leann more</i> about Blazor? 
</Dialog> 


Üst öğeye ( lndex. Razor) bir tarayıcıda erişildiğinde iletişim kutusu işlenir: 


Blazor App 


^ Home 

Hello, world! 

+ Counter 

Fetch data 

VVelcome to your new app. 

Blazor 

Do you want to learn more about Blazor? Yes! 


Bu bileşen uygulamada kullanıldığında, Visual Studio 'da ıntellisense ve Visual Studio Code , sözdizimi ve 
parametre tamammasıyla geliştirmeyi hızlandırır. 















Bileşenler, Kullanıcı arabirimini esnek ve verimli bir şekilde güncelleştirmek için kullanılan bir işleme ağacıadU, 
tarayıcı belge nesne MODELİ (DOM) 1 ın bellek içi gösterimine işlenir. 

Blazor VVebAssembly 

IMPORTANT 

Önizlemede Blazor VVeelsembly 

Blazor sunucusu ASP.NET Core 3,0 ' de desteklenir. Blazor WebAssembly ASP.NET Core 3,1 için önizlemededir. 


Blazor VVebAssembly, .NET ile etkileşimli istemci tarafı Web uygulamaları oluşturmaya yönelik tek sayfalı bir 
uygulama çerçevesidir. Blazor VVebAssembly, eklentiler veya Code transpilation olmadan açık VVeb standartları 
kullanır ve mobil tarayıcılar dahil tüm modern web tarayıcılarında kullanılabilir. 

VVeb tarayıcıları içinde .N ET kodu çalıştırmak, VVebassembly (kısaltılmış) tarafından mümkün hale getirilir. 
VVebAssembly hızlı indirme ve en yüksek yürütme hızı için iyileştirilmiş bir sıkıştırma kodu biçimidir. 
VVebAssembly, açık bir web standardıdır ve eklentileri olmayan VVeb tarayıcılarında desteklenir. 

VVebAssembly Code, JavaScript ile birlikte çalışabilirlik (veya JavaScript birlikte çalışma) olarak adlandırılan 
JavaScript aracılığıyla tarayıcının tüm işlevlerine erişebilir. Tarayıcıda VVebAssembly aracılığıyla yürütülen .N ET 
kodu, sanal makinenin istemci makinesindeki kötü amaçlı eylemlere karşı sağladığı korumalar ile tarayıcının 
JavaScript korumalı alanında çalışır. 



Blazor VVebAssembly uygulaması bir tarayıcıda oluşturulup çalıştırıldığında: 

• C#kod dosyaları ve Razor dosyaları .NET Derlemeleriyle derlenir. 

• Derlemeler ve ,N ET çalışma zamanı tarayıcıya indirilir. 

• VVebAssembly önyükleme .NET çalışma zamanını Blazor ve çalışma zamanını uygulamanın derlemelerini 
yükleyecek şekilde yapılandırır. Blazor VVebAssembly çalışma zamanı, DOM işleme ve tarayıcı API çağrılarını 
işlemek için JavaScript birlikte çalışabilirliği kullanır. 

Yayınlanan uygulamanın boyutu, Yük boyutu, uygulamanın useyeteneğinin önemli bir performans etkendir. 
Büyük bir uygulamanın tarayıcıya indirmesi oldukça uzun sürer ve bu da Kullanıcı deneyimini azaltabilecek. 
Blazor VVebAssembly, indirme sürelerini azaltmak için yük boyutunu iyileştirir: 

• Kullanılmayan kod, ara dil (İL) bağlayıcıtarafından yayımlandığında uygulamadan çıkarılır. 














• HTTP yanıtları sıkıştırılır. 

• .N ET çalışma zamanı ve derlemeler tarayıcıda önbelleğe alınır. 


Blazor Sunucusu 

Blazor, Kullanıcı arabirimi güncelleştirmelerinin uygulanma, bileşen işleme mantığını ayırır.Blazor Server, bir 
ASP.NET Core uygulamasındaki sunucuda Razor bileşenlerini barındırmak için destek sağlar. Kullanıcı 
Arabirimi güncelleştirmeleri SignalR bir bağlantı üzerinden işlenir. 

Çalışma zamanı, tarayıcıdan sunucuya kullanıcı arabirimi olayları göndermeyi ve bileşenleri çalıştırdıktan sonra 
sunucu tarafından tarayıcıya geri gönderilen Kullanıcı arabirimi güncelleştirmelerini uygular. 

Blazor sunucusu tarafından tarayıcıyla iletişim kurmak için kullanılan bağlantı, JavaScript birlikte çalışma 
çağrılarını işlemek için de kullanılır. 



JavaScript ile birlikte çalışma 

Üçüncü taraf JavaScript kitaplıklarını ve tarayıcı API 'Lerine erişimi gerektiren uygulamalar için, bileşenler 
JavaScript ile birlikte çalışır. Bileşenler, JavaScript 'in kullanabileceği herhangi bir kitaplığı veya API kullanma 
yeteneğine sahiptir. C#kod JavaScript kodunu çağırabilir ve JavaScript kodu C# koda çağrı yapabilir. Daha fazla 
bilgi için bkz. ASP.NET Core Blazor JavaScript birlikte çalışabilirliği. 

Kod paylaşımı ve .NET Standard 

Blazor, .NET Standard 2, Ouygular. .NET Standard, .NET uygulamaları genelinde ortak olan .NET API 'lerinin 
resmi bir belirtimidir. .NET Standard sınıf kitaplıkları, Blazor, .NET Framework, .NET Core, Xamarin, mono ve 
Unity gibi farklı .NET platformları arasında paylaşılabilir. 

Bir Web tarayıcısı içinde geçerli olmayan API 'Ler (örneğin, dosya sistemine erişmek, bir yuva açmak ve iş 
parçacığı açmak) PlatformNotSupportedExceptionoluşturur. 

Ek kaynaklar 

• VVebAssembly 

• Blazor barındırma modellerini ASP.NET Core 

• C# Kılavuzu 

• ASP.NET Core Razor söz dizimi başvurusu 

















HTML 

Başar Blazor topluluk bağlantıları 


Desteklenen Blazor platformları ASPNET Core 

13.11.2019 *2 minutes to read ı Edjt Online 


Luke Latham tarafından 

IMPORTANT 

Önizlemede Blazor VVeelsembly 

Blazor sunucusu ASP.NET Core 3,0 ' de desteklenir. Blazor VVebAssembly ASP.NET Core 3,1 için önizlemededir. 


Tarayıcı gereksinimleri 

Blazor VVebAssembly 

TARAYICI 

VERSION 

Microsoft Edge 

Geçerli 

Mozilla Firefox 

Geçerli 

Android dahil Google Chrome 

Geçerli 

İOS dahil Safari 

Geçerli 

Microsoft Internet Explorer 

Desteklenmezt 

tMicrosoft Internet Explorer VVebassembly'yi desteklemez. 

Blazor sunucusu 

TARAYICI 

VERSION 

Microsoft Edge 

Geçerli 

Mozilla Firefox 

Geçerli 

Android dahil Google Chrome 

Geçerli 

İOS dahil Safari 

Geçerli 

Microsoft Internet Explorer 

11 + 


+Ek polydolgular gereklidir (örneğin, Polyfîll.io bir paket aracılığıyla taahhüt eklenebilir). 

Ek kaynaklar 

• Blazor barındırma modellerini ASP.NET Core 






ASPNET Core Blazor kullanmaya başlama 
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IMPORTANT 

Önizlemede Blazor VVeelsembly 

Blazor sunucusu ASP.NET Core 3,0 ' de desteklenir. Blazor VVebAssembly ASP.NET Core 3,1 için öniziemededir. 


Blazorkullanmaya başlayın: 

1. .NET Core 3,1 SDK 'sınıyükler. 

2. İsteğe bağlı olarak Blazor VVebAssembly şablonunu yükler: 

• .NET Core 3,1 veya üzeri (Önizleme) SDK 'sınıyükler. 

• Komut kabuğu 'nda aşağıdaki komutu çalıştırın. Microsoft. AspNetCore.Blazor. Şablon paketinin 
önizleme sürümü varsa Blazor VVebAssembly önizleme aşamasındadır. 

dotnet new -i Microsoft.AspNetCore.Blazor.Templates::3.1.0-preview4.19579.2 

3. Araç seçiminiz için yönergeleri izleyin: 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• .NET Core CLI 

1 . ASP.net ve Web geliştirme iş yüküyle Visual Studio 16,4 veya üstünü yükledikten sonra . 

2 . Yeni bir proje oluşturun. 

3 . Blazor uygulama' yı seçin. İleri yi seçin. 

4 . Proje adı alanında bir proje adı girin veya varsayılan proje adını kabul edin. Konum girişinin doğru 
olduğunu onaylayın veya proje için bir konum belirtin. Oluştur'u seçin. 

5 . Blazor VVeelsembly deneyimi için, VVebassembly uygulama şablonunuBlazor seçin. Blazor 
sunucusu deneyimi için Blazor sunucusu uygulama şablonunu seçin. Oluştur'u seçin. Blazor, Blazor 
sunucusu ve Blazor webassembly'y\ barındıran iki hakkında bilgi için bkz. Blazor barındırma modellerini 
ASP.NET Core. 

6 . Uygulamayı çalıştırmak için Ctrl + F5 tuşuna basın. 

NOTE 

Blazor Visual Studio uzantısını ASP.NET Core Blazor önceki bir önizleme sürümü için yüklediyseniz (Previevv 6 veya 
daha önceki bir sürümü), uzantıyı kaldırabilirsiniz. Blazor şablonlarının bir komut kabuğu ’na yüklenmesi artık Visual 
Studio ’daki şablonları yüzeye eklemek yeterlidir. 










1. En son .NET Core 3,0 SDK 'sınıyükler. 


2. İsteğe bağlı olarak Blazor VVebAssembly şablonunu yükler: 

• .NET Core 3,1 veya üzeri (Önizleme) SDK 'sınıyükler. 

• Komut kabuğu 'nda aşağıdaki komutu çalıştırın. Microsoft. AspNetCore.Blazor. Şablon paketinin 
önizleme sürümü varsa Blazor VVebAssembly önizleme aşamasındadır. 

dotnet new -i Microsoft.AspNetCore.Blazor.Templates::3.1.0-preview4.19579.2 

3. Araç seçiminiz için yönergeleri izleyin: 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• .NET Core CLI 

1 . ASP.net ve Web geliştirme iş yüküyle en son Visual Studio 'yu yükler. 

2 . isteğe bağlı olarak Visual Studio 16,4 Previevv 2 veya üstünü , ASP.net ve Web geliştirme İş yüküyle 
Blazor vvebassembly uygulama geliştirmesi ile birlikte yükler. 

3 . Yeni bir proje oluşturun. 

4 . Blazor uygulama' yı seçin. İleri yi seçin. 

5 . Proje adı alanında bir proje adı girin veya varsayılan proje adını kabul edin. Konum girişinin doğru 
olduğunu onaylayın veya proje için bir konum belirtin. Oluştur'u seçin. 

6 . Blazor VVeelsembly deneyimi için, VVebassembly uygulama şablonunuBlazor seçin. Blazor 
sunucusu deneyimi için Blazor sunucusu uygulama şablonunu seçin. Oluştur'u seçin. Blazor, Blazor 
sunucusu ve Blazor webassembly'y\ barındıran iki hakkında bilgi için bkz. Blazor barındırma modellerini 
ASP.NET Core. 

7 . Uygulamayı çalıştırmak için F5 tuşuna basın. 


NOTE 

Blazor Visual Studio uzantısını ASP.NET Core Blazor önceki bir önizleme sürümü için yüklediyseniz (Previevv 6 veya 
daha önceki bir sürümü), uzantıyı kaldırabilirsiniz. Blazor şablonlarının bir komut kabuğu ’na yüklenmesi artık Visual 
Studio ’daki şablonları yüzeye eklemek yeterlidir. 


Kenar çubuğu 'ndaki sekmelerde birden çok sayfa mevcuttur: 

• Ana Sayfası 

• Sayaç 

• Verileri getir 

Sayaç sayfasında, bir sayfa yenilemesi olmadan sayacı artırmak için bana tıklama düğmesini seçin. Bir Web 
sayfasında normal olarak bir sayacı artırma, JavaScript yazmayı gerektirir, ancak kullanabilirsiniz C#Blazor. 


Pages/Counter. Razor. 






@page "/counter" 

<hl>Counter</hl> 

<p>Current count: @currentCount</p> 

<button class="btn btn-primary" @onclick="IncrementCount">Click me</button> 

@code { 

private int currentCount = 0; 

private void IncrementCount() 

{ 

currentCount++; 

} 

} 

Tarayıcıda /counter için bir istek, en üstteki @page yönergesi tarafından belirtilen şekilde counter bileşeninin 
içeriğini işlemesine neden olur. Bileşenler, daha sonra, Kullanıcı arabirimini esnek ve verimli bir şekilde 
güncelleştirmek için kullanılabilen işleme ağacının bellek içi gösterimine işlenir. 

Bana tıklama düğmesi her seçildiğinde: 

• onciick olayı tetiklenir. 

• incrementcount yöntemi çağrılır. 

• currentCount artırılır. 

• Bileşen yeniden işlenir. 

Çalışma zamanı, yeni içeriği önceki içerikle karşılaştırır ve yalnızca değiştirilen içeriği Belge Nesne Modeli 
(DOM) öğesine uygular. 

HTML sözdizimini kullanarak başka bir bileşene bileşen ekleyin. Örneğin, index bileşenine bir <counter /> 
öğesi ekleyerek counter bileşenini uygulamanın giriş sayfasına ekleyin. 

Pages/lndex. Razor. 


@page "/" 

<hl>Hello J world!</hl> 

Welcome to your new app. 
cCounter /> 

Uygulamayı çalıştırın. Giriş sayfasının counter bileşeni tarafından kendi sayacı vardır. 

Bileşen parametreleri, alt bileşende özellikler ayarlamanıza olanak tanıyan öznitelikler veya alt içerikkullanılarak 
belirtilir, counter bileşenine bir parametre eklemek için, bileşenin @code bloğunu güncelleştirin: 


• 

[Parameter] 

özniteliğiyle 

IncrementAmount 

için ortak özellik ekleyin. 



• 

currentCount 

değerini artırdığınızda 

IncrementAmount 

kullanmak için 

IncrementCount 

yöntemini değiştirin. 


Pages/Counter. Razor: 















@page "/counter" 

<hl>Counter</hl> 

<p>Current count: @currentCount</p> 

<button class="btn btn-primary" @onclick="IncrementCount">Click me</button> 
@code { 

private int currentCount = 0; 

[Parameter] 

public int IncrementAmount { get; set; } = 1; 

private void IncrementCoıınt() 

{ 

currentCount += IncrementAmount; 

} 


index bileşenin <counter> öğesindeki bir özniteliği kullanarak IncrementAmount belirtin. 
Pages/lndex. Razor. 


@page "/" 

<hl>Hello, world!</hl> 

Welcome to your new app. 

<Counter IncrementAmount="10" /> 

Uygulamayı çalıştırın. index bileşeni, bana tıklama düğmesi seçildiğinde her seferinde on ile artan kendi 
sayacıdır, /counter counter bileşeni (Counter. Razor), bir tarafından arttırmaya devam eder. 

Sonraki adımlar 

ilk Blazor uygulamanızı oluşturma 


Ek kaynaklar 

• ASP.NET Core Blazor şablonları 

• ASP.NET Core SignalR giriş 
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IMPORTANT 

Önizlemede Blazor VVeelsembly 

Blazor sunucusu ASP.NET Core 3,0 ' de desteklenir. Blazor VVebAssembly ASP.NET Core 3,1 için önizlemededir. 


Blazor, bir VVebassemblytabanlı .N ET çalışma zamanı ( Blazor webassembly) veya AS P.N ET Core ( Blazor 
Server) sunucu tarafında tarayıcıda istemci tarafı çalıştırmak için tasarlanan bir Web çerçevesidir. Barındırma 
modelinden bağımsız olarak, uygulama ve bileşen modelleri aynıdır. 

Bu makalede açıklanan barındırma modelleriyle ilgili bir proje oluşturmak için, bkz. ASP.NET Core Blazor 
kullanmaya başlama. 

Blazor VVebAssembly 

Blazor için sorumlu barındırma modeli, VVebAssembly üzerinde tarayıcıda istemci tarafında çalışmaktadır. 
Blazor uygulaması, bağımlılıkları ve .NET çalışma zamanı tarayıcıya indirilir.Uygulama doğrudan tarayıcı 
kullanıcı arabirimi iş parçacığında yürütülür. Ul güncelleştirmeleri ve olay işleme aynı işlem içinde oluşur. 
Uygulamanın varlıkları, istemcilere statik içerik sunan bir VVeb sunucusuna veya hizmete statik dosyalar 
olarak dağıtılır. 


Brovvser 
Ulthread 

Blazor 


İstemci tarafı barındırma modelini kullanarak bir Blazor uygulaması oluşturmak için, Blazor VVebAssembly 
uygulama şablonunu (DotNet New blazorwasm) kullanın. 

Blazor VVebAssembly uygulama şablonunu seçtikten sonra, ASP.N ET Core barındırılan onay kutusunu 
(DotNet New blazorvvasm—hosted) seçerek uygulamayı ASP.NET Core arka ucunu kullanacak şekilde 
yapılandırma seçeneğiniz vardır. AS P.N ET Core uygulaması, Blazor uygulamasına istemcilere hizmet verir. 
Blazor VVebAssembly uygulaması, VVeb API çağrılarını veya SignalRkullanarak ağ üzerinden sunucu ile 
etkileşime geçebilir. 

Şablonlar şunları ele alan blazor. webassembly.js betiğini içerir: 







• .NET çalışma zamanını, uygulamayı ve uygulamanın bağımlılıklarını indirme. 

• Uygulamayı çalıştırmak için çalışma zamanının başlatılması. 


Blazor VVebAssembly barındırma modeli çeşitli avantajlar sunar: 

• .NET sunucu tarafı bağımlılığı yoktur.Uygulama, istemciye indirildikten sonra tamamen çalışır. 

• istemci kaynakları ve yetenekleri tamamen yararlanılabilir. 

• İş sunucudan istemciye boşaltılır. 

• Uygulamayı barındırmak için bir ASP.N ET Core Web sunucusu gerekli değildir.Sunucusuz dağıtım 
senaryoları mümkündür (örneğin, bir CDN 'den uygulama sunma). 

VVebAssembly barındırma Blazor için aşağı yanlar vardır: 

• Uygulama tarayıcının özelliklerine kısıtlıdır. 

• Uyumlu istemci donanımı ve yazılımı (örneğin, VVebAssembly desteği) gereklidir. 

• indirme boyutu daha büyüktür ve uygulamaların yüklenmesi daha uzun sürer. 

• .N ET çalışma zamanı ve araç desteği daha az olgun. Örneğin, .N ET Standard desteğinin ve hata 
ayıklamada sınırlamalar mevcuttur. 

Blazor Sunucusu 

Blazor sunucusu barındırma modeliyle uygulama, sunucuda bir ASP.NET Core uygulamasının içinden 
yürütülür. Kullanıcı Arabirimi güncelleştirmeleri, olay işleme ve JavaScript çağrıları SignalR bir bağlantı 
üzerinden işlenir. 




SignalR 


N V 


Brovvser 


dotnet.exe 
ASP.NET Core 

Blazor 


Blazor sunucusu barındırma modelini kullanarak bir Blazor uygulaması oluşturmak için ASP.NET Core 
Blazor Server uygulama şablonunu (DotNet New blazorserver) kullanın. ASP.NET Core uygulaması Blazor 
sunucusu uygulamasını barındırır ve istemcilerin bağlanacağı SignalR uç noktasını oluşturur. 

ASP.NET Core uygulama, şu ekleme için uygulamanın startup sınıfına başvurur: 

• Sunucu tarafı hizmetler. 

• istek işleme işlem hattının uygulaması. 

Blazor. Server. js komut dosyasıt istemci bağlantısını kurar. Uygulamanın, uygulama durumunu (örneğin, 
kayıp ağ bağlantısı durumunda) kalıcı hale getirmek ve geri yüklemek, uygulamanın sorumluluğundadır. 

Blazor sunucusu barındırma modeli çeşitli avantajlar sunar: 

• indirme boyutu, Blazor VVebAssembly uygulamasından önemli ölçüde küçüktür ve uygulama çok daha 
hızlı yüklenir. 







• Uygulama, .N ET Core ile uyumlu API 'lerin kullanımı dahil olmak üzere sunucu olanaklarından tam olarak 
yararlanır. 

• Sunucuda .NET Core, uygulamayı çalıştırmak için kullanılır, bu nedenle hata ayıklama gibi mevcut .NET 
araçları beklendiği gibi çalışır. 

• Ölçülü istemciler desteklenir.Örneğin, Blazor Server Apps, VVebAssembly ve kaynak kısıtlı cihazlarda 
bulunan tarayıcılarla çalışır. 

• Uygulamanın bileşen kodu da dahilC# olmak üzere, uygulamanın .NET/kod tabanı istemcilere 
sunulmuyor. 

Sunucu barındırma Blazor için aşağı yanlar vardır: 

• Daha yüksek gecikme süresi genellikle vardır. Her Kullanıcı etkileşimi bir ağ atmasını içerir. 

• Çevrimdışı destek yoktur, istemci bağlantısı başarısız olursa, uygulama çalışmayı durduruyor. 

• Ölçeklenebilirlik, çok sayıda kullanıcısı olan uygulamalar için zorlayıcı bir uygulamalardır.Sunucunun 
birden çok istemci bağlantısını yönetmesi ve istemci durumunu işlemesi gerekir. 

• Uygulamayı çalıştırmak için bir ASP.N ET Core sunucusu gerekir. Sunucusuz dağıtım senaryoları mümkün 
değildir (örneğin, bir CDN 'den uygulama sunma). 

+ blazor. Server. js komut dosyası, AS P.N ET Core paylaşılan çerçevesindeki gömülü bir kaynaktan sunulur. 

Sunucu tarafından işlenmiş Kullanıcı arabirimine karşılaştırma 

Blazor Server uygulamalarını anlamanın bir yolu, Razor görünümlerini veya Razor Pages kullanarak 
ASP.NET Core uygulamalarda Kullanıcı arabirimini işlemek için geleneksel modellerden nasıl farklılık gösterir. 
Her iki model de, HTML içeriğini anlatmak için Razor dilini kullanır, ancak biçimlendirmenin nasıl işlendiği 
konusunda önemli ölçüde farklılık gösterir. 

Bir Razor sayfası veya görünüm işlendiğinde, her Razor kodu satırı metin biçiminde HTML yayar. 
Oluşturulduktan sonra sunucu, üretilen herhangi bir durum da dahil olmak üzere sayfayı veya görünüm 
örneğini ortadan kaldırır. Sayfa için başka bir istek gerçekleştiğinde, örneğin sunucu doğrulaması başarısız 
olduğunda ve doğrulama özeti görüntülendiğinde: 

• Sayfanın tamamı HTML metnine yeniden eklenir. 

• Sayfa istemciye gönderilir. 

Blazor bir uygulama, BileşerıleradU Kullanıcı arabiriminin yeniden kullanılabilir öğelerinden oluşur. Bir bileşen 
kod C#, biçimlendirme ve diğer bileşenleri içerir. Bir bileşen işlendiğinde Blazor, bir HTML veya XML Belge 
Nesne Modeli (DOM) gibi dahil edilen bileşenlerin bir grafiğini üretir. Bu grafik, özelliklerde ve alanlarında 
tutulan bileşen durumunu içerir. Blazor, biçimlendirme ikili gösterimini üretmek için bileşen grafiğini 
değerlendirir, ikili biçimi şu şekilde olabilir: 

• HTML metnine açıldı (prerendering sırasında). 

• Düzenli işleme sırasında biçimlendirmeyi verimli bir şekilde güncelleştirmek için kullanılır. 

Blazor bir kullanıcı arabirimi güncelleştirmesi tarafından tetiklenir: 

• Düğme seçme gibi kullanıcı etkileşimi. 

• Zamanlayıcı gibi uygulama Tetikleyicileri. 

Grafik yeniden tanımlanır ve bir Ul farkL (fark) hesaplanır. Bu fark, istemcideki Kullanıcı arabirimini 
güncelleştirmek için gereken en küçük DOM düzenlemelerinin kümesidir. Fark istemciye bir ikili biçimde 
gönderilir ve tarayıcı tarafından uygulanır. 

Kullanıcı, istemci üzerinde bundan uzaklaştığında bir bileşen atılmış olur. Bir Kullanıcı bir bileşenle etkileşim 
kurarken, bileşenin durumu (hizmetler, kaynaklar) sunucunun belleğinde tutulmalıdır. Birçok bileşenin 
durumu sunucu tarafından eşzamanlı olarak Korunabileceğinden, bellek tükenmesi sorunu ele alınmalıdır. 
Sunucu belleğinin en iyi şekilde kullanılmasını sağlamak üzere Blazor sunucu uygulamasının nasıl yazılacağı 



hakkında yönergeler için bkz. Güvenli ASP.NET Core Blazor Server uygulamaları. 

Uygulanıp 

Blazor sunucusu uygulaması ASP.NET Core SignalRüzerine kurulmuştur. Her istemci, bir devre olarak 
adlandırılan bir veya daha fazla SignalR bağlantı üzerinden sunucu ile iletişim kurar. Devre, geçici ağ 
kesintilerine tolerans sağlayan SignalR bağlantıları üzerinden Blazorsoyutlamasıdır. Blazor istemci SignalR 
bağlantısının kesileceğini gördüğünde, yeni bir SignalR bağlantısı kullanarak sunucuya yeniden bağlanmaya 
çalışır. 

Bir Blazor sunucusu uygulamasına bağlı her tarayıcı ekranı (tarayıcı sekmesi veya IFRAME) SignalR bir 
bağlantı kullanır. Bu, tipik sunucu tarafından işlenmiş uygulamalarla karşılaştırıldığında daha önemli bir ayırım 
ifade etmiştir. Sunucu tarafından işlenen bir uygulamada, aynı uygulamayı birden çok tarayıcı ekranında 
açmak genellikle sunucuda ek kaynak taleplerine çevirilmez. Blazor sunucusu uygulamasında, her tarayıcı 
ekranı, sunucu tarafından yönetilecek ayrı bir devre ve bileşen durumunun ayrı örneklerini gerektirir. 

Blazor bir tarayıcı sekmesini kapatmayı veya bir dış URL 'y e gidilmesini göz önünde bulundurur. Düzgün 
sonlandırma durumunda, devre ve ilişkili kaynaklar hemen serbest bırakılır. Bir istemci, örneğin bir ağ 
kesintisi nedeniyle düzgün şekilde kesilmeyen bir şekilde kesilebilir. Blazor sunucusu, istemcinin yeniden 
bağlanmasına izin vermek için, yapılandırılabilir bir Aralık için bağlantısı kesilen devreleri depolar. Daha fazla 
bilgi için aynı sunucuya yeniden bağlanma bölümüne bakın. 

Ul gecikmesi 

Ul gecikme süresi, başlatılan bir eylemden Kullanıcı arabiriminin güncelleştirildiği zamana kadar geçen 
süredir. Bir uygulamanın kullanıcıya yanıt vermesi için kullanıcı ARABİRİMİ gecikmesi için daha küçük 
değerler zorunludur. Blazor sunucu uygulamasında her bir eylem sunucusuna gönderilir, işlenir ve bir UI farkı 
geri gönderilir. Sonuç olarak, Ul gecikmesi ağ gecikme süresinin toplamı ve eylemi işlerken sunucu gecikmesi 
sayısıdır. 

Özel bir kurumsal ağla sınırlı bir iş kolu uygulaması için, ağ gecikmesi nedeniyle kullanıcı gecikmesi algılarını 
üzerindeki etki, genellikle çok sayıda CEPSİZ olur. Internet üzerinden dağıtılan bir uygulama için, özellikle de 
kullanıcılar coğrafi olarak coğrafi olarak dağıtılmışsa gecikme süresi kullanıcılara karşı farklılık gösterebilir. 

Bellek kullanımı ayrıca uygulama gecikme süresine de katkıda bulunabilir. Daha fazla bellek kullanımı, her ikisi 
de uygulama performansının düşmesine neden olan ve bu nedenle kullanıcı arabirimi gecikmesini arttığı 
diskte sık görülen çöp toplama veya disk belleği belleği Daha fazla bilgi için bkz. Güvenli ASP.NET Core 
Blazor Server uygulamaları. 

Blazor sunucu uygulamaları, ağ gecikmesini ve bellek kullanımını azaltarak Ul gecikmesini en aza indirmek 
için iyileştirilmelidir. Ağ gecikmesini ölçmeye yönelik bir yaklaşım için bkz. ASP.NET Core Blazor sunucusu 
barındırma ve dağıtma. SignalR ve Blazorhakkında daha fazla bilgi için bkz. 

• AS P.N ET Core Blazor sunucusu barındırma ve dağıtma 

• Güvenli ASP.NET Core Blazor Server uygulamaları 

Sunucuyla bağlantı 

Blazor Server uygulamaları sunucuya etkin bir SignalR bağlantısı gerektirir.Bağlantı kaybolursa, uygulama 
sunucuya yeniden bağlanmaya çalışır, istemcinin durumu hala bellekte olduğu sürece, istemci oturumu 
durum kaybı olmadan devam eder. 

Aynı sunucuya yeniden bağlanma 

Sunucu üzerinde kullanıcı arabirimi durumunu ayarlayan ilk istemci isteğine yanıt olarak önceden bir Blazor 
sunucusu uygulaması ön ekler, istemci bir SignalR bağlantısı oluşturmayı denediğinde, istemci aynı sunucuya 
yeniden bağlanmalıdır, birden fazla arka uç sunucusu kullanan Blazor Server uygulamalarının SignalR 
bağlantıları için yapışkan oturumlar uygulaması gerekir. 

Blazor Server uygulamaları için Azure SignalR hizmetini kullanmanızı öneririz. Hizmet, Blazor sunucu 



uygulamasının ölçeğini çok sayıda eşzamanlı SignalR bağlantı ile ölçeklendirmeye olanak tanır. Azure SignalR 
hizmeti için, hizmetin serverstickyMode seçeneği veya yapılandırma değeri Required olarak ayarlanarak 
yapışkan oturumlar etkinleştirilir. Daha fazla bilgi için bkz. ASP.NET Core Blazor sunucusu barındırma ve 
dağıtma. 

11S kullanırken, yapışkan oturumlar uygulama İsteği yönlendirme ile etkinleştirilir. Daha fazla bilgi için bkz. 

uygulama İsteği yönlendirme kullanarak HTTP yük dengelemesi. 

Kullanıcı arabirimindeki bağlantı durumunu yansıtır 

İstemci bağlantının kaybolduğunu algıladığında, istemci yeniden bağlanmayı denediğinde kullanıcıya 
varsayılan bir kullanıcı arabirimi görüntülenir. Yeniden bağlantı başarısız olursa, kullanıcıya yeniden deneme 
seçeneği sağlanır. 


Kullanıcı arabirimini özelleştirmek için _AYosf. cshtml Razor sayfasının <body> components-reconnect-modai 
id bir öğe tanımlayın: 


<div id="components-reconnect-modal"> 

</div> 


Aşağıdaki tabloda components-reconnect-modal 

öğesine uygulanan CSS sınıfları açıklanmaktadır. 

CSS SINIFI 

... GÖSTERİR 

components-reconnect-show 

Kayıp bir bağlantı, istemci yeniden bağlanmaya çalışıyor. 

Kalıcı olarak göster. 

components-reconnect-hide 

Etkin bir bağlantı sunucuya yeniden oluşturulur. Kalıcı olarak 
gizleyin. 

components-reconnect-failed 

Muhtemelen bir ağ hatasından dolayı yeniden bağlantı 
başarısız oldu. Yeniden bağlanmayı denemek için 
window. Blazor. reconnect () çağırın. 


components-reconnect-rejected Yeniden bağlantı reddedildi. Sunucuya ulaşıldı ancak 

bağlantı reddedildi ve kullanıcının sunucudaki durumu 
kayboldu. Uygulamayı yeniden yüklemek için 
location. reload() çağırın. Bu bağlantı durumu şu 
durumlarda oluşabilir: 

• Sunucu tarafında devre dışı bir kilitlenme oluşur. 

• Sunucunun kullanıcının durumunu bırakması için 
istemcinin bağlantısı yeterince uzun değil. 
Kullanıcının etkileşimde bulunduğu bileşenlerin 
örnekleri atıldı. 

• Sunucu yeniden başlatıldı veya uygulamanın çalışan 
işlemi geri dönüştürüldü. 


Prerendering sonrasında durum bilgisi olan yeniden bağlanma 

sunucu bağlantısı kurumadan önce sunucu üzerindeki kullanıcı arabirimine varsayılan olarak, Blazor Server 
uygulamaları varsayılan olarak ayarlanır. Bu, _Host. cshtml Razor sayfasında ayarlanır: 










<body> 

<app> 

<component type="typeof(App)" render-mode="ServerPrerendered" /> 
</app> 

<script src="_framework/blazor. server ,js"x/script> 

</body> 


<body> 

<app>@(await Html.RenderComponentAsync<App>(RenderMode.ServerPrerendered))</app> 

<script src="_framework/blazor. server .js"x/script> 

</body> 

RenderMode , bileşenin şunları yapıp kullanmadığını yapılandırır: 

• , Sayfaya ön gönderilir. 

• , Sayfada statik HTML olarak veya Kullanıcı aracısından bir Blazor uygulamasını önyüklemek için gerekli 
bilgileri içeriyorsa. 


RENDERMODE 

AÇIKLAMA 

ServerPrerendered 

Bileşeni statik HTML olarak işler ve Blazor sunucusu 
uygulaması için bir işaret içerir. Kullanıcı Aracısı başladığında, 
bu işaretleyici bir Blazor uygulamasının önyüklemesi için 
kullanılır. 

Server 

Blazor sunucusu uygulaması için bir işaret oluşturur. Bileşen 
çıkışı dahil değildir. Kullanıcı Aracısı başladığında, bu 
işaretleyici bir Blazor uygulamasının önyüklemesi için 
kullanılır. 

Static 

Bileşeni statik HTML olarak işler. 

RENDERMODE 

AÇIKLAMA 

ServerPrerendered 

Bileşeni statik HTML olarak işler ve Blazor sunucusu 
uygulaması için bir işaret içerir. Kullanıcı Aracısı başladığında, 
bu işaretleyici bir Blazor uygulamasının önyüklemesi için 
kullanılır. Parametreler desteklenmiyor. 

Server 

Blazor sunucusu uygulaması için bir işaret oluşturur. Bileşen 
çıkışı dahil değildir. Kullanıcı Aracısı başladığında, bu 
işaretleyici bir Blazor uygulamasının önyüklemesi için 
kullanılır. Parametreler desteklenmiyor. 


static Bileşeni statik HTML olarak işler. Parametreler destekleniyor. 


Statik HTML sayfasından sunucu bileşenleri işleme desteklenmiyor. 

RenderMode serverPrerendered , bileşen başlangıçta sayfanın bir parçası olarak statik olarak işlenir. Tarayıcı 
sunucuya geri bir bağlantı kurduğunda, bileşen yeniden işlenir ve bileşen artık etkileşimli olur. Bileşeni 
başlatmak için Onbaşlatılmış {Async} yaşam döngüsü yöntemi varsa, yöntem iki kezyürütülür: 

• Bileşen statik olarak önceden kullanılırken. 

• Sunucu bağlantısı kurulduktan sonra. 










Bu, bileşen son işlendiğinde Kullanıcı arabiriminde görünen verilerde fark edilebilir bir değişikliğe neden 
olabilir. 

Blazor sunucu uygulamasında çift işleme senaryosunu önlemek için: 

• Prerendering sırasında durumu önbelleğe almak için kullanılabilecek bir tanımlayıcı geçirin ve uygulamayı 
yeniden başlattıktan sonra durumu alma. 

• Bileşen durumunu kaydetmek için prerendering sırasında tanımlayıcıyı kullanın. 

• Önbelleğe alınan durumu almak için prerendering öğesinden sonra tanımlayıcıyı kullanın. 

Aşağıdaki kod, Çift işlemeyi engelleyen şablon tabanlı Blazor sunucu uygulamasındaki güncelleştirilmiş bir 
WeatherForecastService gösterir: 

public class lAİeatherForecastService 
{ 

private static readonly string[] Summaries = new[] 

{ 

"Freezing", "Bracing", "Chilly", "Cool", "Mild", 

"l/Jarm", "Balmy", "Hot", "Sweltering", "Scorching" 

}; 

public WeatherForecastService(IMemoryCache memoryCache) 

{ 

MemoryCache = memoryCache; 

} 

public IMemoryCache MemoryCache { get; } 

public Task<WeatherForecast[]> GetForecastAsync(DateTime startDate) 

{ 

return MemoryCache.GetOrCreateAsync(startDate, async e => 

{ 

e.SetOptions(new MemoryCacheEntryOptions 
{ 

AbsoluteExpirationRelativeToNow = 

TimeSpan.FromSeconds(30) 

}); 

var rng = new Random(); 

await Task.Delay(TimeSpan.FromSeconds(10)); 

return Enumerable.Range(l, 5).Select(index => new WeatherForecast 
{ 

Date = startDate.AddDays(index)j 
TemperatureC = rng.Next(-20, 55), 

Summary = Summaries[rng.Next(Summaries.Length)] 

}).ToArray(); 

}); 

} 

} 

Razor sayfaları ve görünümlerinden durum bilgisi olan etkileşimli bileşenleri işleme 

Durum bilgisi olan etkileşimli bileşenler Razor sayfasına veya görünümüne eklenebilir. 

Sayfa veya görünüm şunları işler: 

• Bileşen sayfa veya görünümle birlikte kullanılır. 

• Prerendering için kullanılan ilk bileşen durumu kayboldu. 

• SignalR bağlantısı oluşturulduğunda yeni bileşen durumu oluşturulur. 


Aşağıdaki Razor sayfası bir counter bileşeni işler: 






<hl>My Razor Page</hl> 

<component type="typeof(Counter)" render-mode="ServerPrerendered" 
param-InitialValue="InitialValue" /> 

@code { 

[BindProperty(SupportsGet=true)] 
public int InitialValue { get; set; } 


<hl>My Razor Page</hl> 

@(await Html.RenderComponentAsync<Counter>(RenderMode.ServerPrerendered)) 
@code { 

[BindProperty(SupportsGet=true)] 
public int InitialValue { get; set; } 


Razor sayfaları ve görünümlerinden etkileşimsiz bileşenleri işleme 

Aşağıdaki Razor sayfasında, counter bileşen bir form kullanılarak belirtilen bir başlangıç değeri ile statik 
olarak işlenir: 

<hl>My Razor Page</hl> 

<form> 

«cinput type="number" asp-for="InitialValue" /> 
cbutton type="submit">Set initial value</button> 

</form> 

<component type="typeof(Counter)" render-mode="Static" 
param-InitialValue="InitialValue" /> 

@code { 

[BindProperty(SupportsGet=true)] 
public int InitialValue { get; set; } 

} 


<hl>My Razor Page</hl> 

<form> 

<input type="number" asp-for="InitialValue" /> 
cbutton type="submit">Set initial value</button> 

</form> 

@(await Html.RenderComponentAsync<Counter>(RenderMode.Static, 
new { InitialValue = InitialValue })) 

@code { 

[BindProperty(SupportsGet=true)] 
public int InitialValue { get; set; } 

} 

MyComponent statik olarak işlendiğinde, bileşen etkileşimli olamaz. 

Uygulamanın ne zaman prerendering olduğunu Algıla 

Blazor sunucu uygulaması prerendering olduğunda, tarayıcıyla bir bağlantı kurulmadığından, JavaScript 'e 
çağırma gibi bazı eylemler mümkün değildir. Bileşenler, ön işlenmiş olduğunda farklı şekilde işlenmesi 
gerekebilir. 





Tarayıcı bağlantısı kurulana kadar JavaScript birlikte çalışma çağrılarını geciktirmek için Onafterrenderasync 
bileşen yaşam döngüsü olayınıkullanabilirsiniz. Bu olay yalnızca uygulama tam olarak işlendikten ve istemci 
bağlantısı kurulduktan sonra çağırılır. 

@using Microsoft.HSInterop 
@inject IISRuntime ISRuntime 

<div @ref="divElement">Text during render</div> 

@code { 

private ElementReference divElement; 

protected override async Task OnAfterRenderAsync(bool firstRender) 

{ 

if (firstRender) 

{ 

await JSRuntime.InvokeVoidAsync( 

"setElementText", divElement, "Text after render"); 

} 

} 

} 


Yukarıdaki örnek kod için, WwwrootAndex.html (Blazor VVebAssembly) veya Pages/_Host. cshtml (Blazor 
Server) <head> Öğesi içinde bir setElementText JavaScript işlevi sağlayın, işlevi HSRuntime.InvokeVoidAsync 
ile çağrılır ve bir değer döndürmez: 


<script> 

window.setElementText = (element, text) => element.innerText = text; 
</script> 


WARNING 

Yukarıdaki örnek yalnızca tanıtım amacıyla Belge Nesne Modeli (DOM) değiştirir. JavaScript, Blazor 'in değişiklik 
izlemesini kesintiye uğradığı için çoğu senaryoda, JavaScript ile DOM 'ı doğrudan değiştirme önerilmez. 


Aşağıdaki bileşen, prerendering ile uyumlu bir şekilde bileşenin başlatma mantığının bir parçası olarak 
JavaScript birlikte çalışabilirinin nasıl kullanılacağını göstermektedir. Bileşeni, onAfterRenderAsync içinden bir 
işleme güncelleştirmesi tetiklemenin mümkün olduğunu gösterir. Geliştirici Bu senaryoda sonsuz bir döngü 
oluşturmaktan kaçınmalıdır. 

ıSRuntime.invokeAsync çağrıldığında, bileşen işlenene kadar hiçbir JavaScript öğesi olmadığından, 

ElementRef yalnızca onAfterRenderAsync için kullanılır ve daha önceki bir yaşam döngüsü yönteminde değil. 

JavaScript birlikte çalışma çağrısından alınan yeni durumla birlikte bileşeni yeniden sağlamak için 
Statehaschanged çağrılır. stateHasehanged yalnızca infoFromis nuiı olduğunda çağrıldığı için, kod sonsuz 
bir döngü oluşturmaz. 











@page "/prerendered-interop" 

@using Microsoft.AspNetCore.Components 
@using Microsoft.ISInterop 
@inject IISRuntime ISRuntime 

<P> 

Get value via İS interop cali: 

<strong id="val-get-by-interop">@(infoFromls ?? "No value yet")</strong> 

</p> 

Set value via İS interop cali: 

<div id="val-set-by-interop" @ref="divElement"x/div> 

@code { 

private string infoFromls; 
private ElementReference divElement; 

protected override async Task OnAfterRenderAsync(bool firstRender) 

{ 

if (firstRender && infoFromls == null) 

{ 

İnfoFromls = await !SRuntime.InvokeAsync<string>( 

"setElementText", divElement, "Hello from interop cali!"); 

StateHasChanged(); 

} 

} 

} 


Yukarıdaki örnek kod için, WwwrootAndex.html (Blazor VVebAssembly) veya Pages/_Host. cshtml (Blazor 
Server) <head> Öğesi içinde bir setElementText JavaScript işlevi sağlayın, işlevi IISRuntime.InvokeAsync ile 
çağrılır ve bir değer döndürür: 

<script> 

window.setElementText = (element, text) => { 
element.innerText = text; 
return text; 

}; 

</script> 


VVARNING 

Yukarıdaki örnek yalnızca tanıtım amacıyla Belge Nesne Modeli (DOM) değiştirir. JavaScript, Blazor 'in değişiklik 
izlemesini kesintiye uğradığı için çoğu senaryoda, JavaScript ile DOM 'ı doğrudan değiştirme önerilmez. 


Blazor Server uygulamaları için SignalR istemcisini yapılandırma 

Bazen Blazor Server uygulamaları tarafından kullanılan SignalR istemcisini yapılandırmanız gerekir.Örneğin, 
bir bağlantı sorununu tanılamak için SignalR istemcisinde günlüğe kaydetmeyi yapılandırmak isteyebilirsiniz. 

Pages/_Host. cshtml dosyasında SignalR istemcisini yapılandırmak için: 

• Blazor. Server.js betiği için <script> etiketine bir autostart="faise" özniteliği ekleyin. 

• Blazor.start çağırın ve SignalR oluşturucuyu belirten bir yapılandırma nesnesini geçirin. 












<script src="_framework/blazor. server. js" autostart="false"x/script> 
<script> 

Blazor.start({ 

configureSignalR: function (builder) { 

builder.conf igurel_ogging("Information "); // LogLevel.Information 

} 

})J 

</script> 


Ek kaynaklar 

• ASP.NET Core Blazor kullanmaya başlama 

• ASP.NET Core SignalR giriş 
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IMPORTANT 

Önizlemede Blazor VVeelsembly 

Blazor sunucusu ASP.NET Core 3,0 ' de desteklenir. Blazor VVebAssembly ASP.NET Core 3,1 için önizlemededir. 


Bu öğreticide bir Blazor uygulamasının nasıl oluşturulacağı ve değiştirileceği gösterilmektedir. 

Bu öğreticide bir Blazor projesi oluşturmak için ASP.NET Core Blazor kullanmaya başlama makalesindeki 
yönergeleri izleyin. Projeyi 7öDo/.<sfolarak adlandırın. 

Derleme bileşenleri 

1. Sayfalar klasöründe uygulamanın üç sayfasının her birine gidin: giriş, sayaç ve veri getirme. Bu sayfalar, 
Razor bileşen dosyaları dizini. Razor, Counter. Razonre fetchdata. ftozortarafından uygulanır. 

2. Sayaç sayfasında, bir sayfa yenilemesi olmadan sayacı artırmak için bana tıklama düğmesini seçin. Bir 
Web sayfasında normal olarak bir sayacı artırma, JavaScript yazmayı gerektirir. Blazor, bunun yerine 
yazabilirsiniz C#. 

3. Counter. Razor dosyasındaki counter bileşeninin uygulamasını inceleyin. 

Pages/Counter. Razor: 

@page "/counter" 

<hl>Counter</hl> 

<p>Current count: @currentCount</p> 

cbutton class="btn btn-primary" @onclick="IncrementCount">Click me</button> 

@code { 

private int currentCount = 0; 

private void IncrementCount() 

{ 

currentCount++; 

} 

} 

Counter bileşenin kullanıcı arabirimi HTML kullanılarak tanımlanır. Dinamik işleme mantığı (örneğin, 
döngüler, koşullar, ifadeler) C# Razoradlı gömülü bir sözdizimi kullanılarak eklenir. HTML biçimlendirme ve 
C# işleme mantığı, derleme zamanında bir bileşen sınıfına dönüştürülür. Oluşturulan .NET sınıfının adı 
dosya adıyla eşleşir. 

Bileşen sınıfının üyeleri bir @code bloğunda tanımlanmıştır. @code bloğunda, bileşen durumu (özellikler, 
alanlar) ve yöntemler olay işleme için veya diğer bileşen mantığını tanımlamak için belirtilir. Bu Üyeler daha 
sonra bileşenin işleme mantığının bir parçası olarak ve olayları işlemek için kullanılır. 









Bana tıklama düğmesi seçildiğinde: 


• 

Counter 

bileşenin kayıtlı 

onclick 

işleyicisine ( IncrementCount 

yöntemi) denir. 

• 

Counter 

bileşeni, işleme ağacını yeniden oluşturur. 



• Yeni işleme ağacı öncekiyle karşılaştırılır. 

• Yalnızca Belge Nesne Modeli (DOM) üzerinde yapılan değişiklikler uygulanır.Görünen sayı 
güncelleştirildi. 

4. Sayıyı bir C# yerine iki ile artırmak için counter bileşenin mantığını değiştirin. 


@page "/counter" 

<hl>Counter</hl> 

<p>Current count: @currentCount</p> 

<button class="btn btn-primary" @onclick="IncrementCount">Click me</button> 

@code { 

private int currentCount = 0 ; 

private void IncrementCount() 

{ 

currentCount += 2 ; 

} 

} 

5. Değişiklikleri görmek için uygulamayı yeniden derleyin ve çalıştırın. Ben tıklama düğmesini seçin. Sayaç iki 
olarak artar. 


Bileşenleri kullanma 

Bir bileşeni, bir HTML söz dizimini kullanarak başka bir bileşene ekleyin. 

1. index bileşenine bir <counter /> öğesi ekleyerek uygulamanın index bileşenine counter bileşenini 
ekleyin ( lndex. Razor). 

Bu deneyim için Blazor VVebAssembly kullanıyorsanız, index bileşeni tarafından surveyPrompt bir bileşen 
kullanılır. <surveyPrompt> öğesini bir <counter /> öğesiyle değiştirin. Bu deneyim için bir Blazor sunucusu 
uygulaması kullanıyorsanız, index bileşenine <counter /> öğesini ekleyin: 

Pages/lndex. Razor: 


@page "/" 

<hl>Hello, world!</hl> 

Uelcome to your new app. 
cCounter /> 

2. Uygulamayı yeniden derleyin ve çalıştırın. index bileşeni kendi sayacıdır. 


Bileşen parametreleri 

Bileşenler de parametrelere sahip olabilir. Bileşen parametreleri, bileşen sınıfında [Parameter] özniteliğiyle ortak 
özellikler kullanılarak tanımlanır. Biçimlendirme içindeki bir bileşenin bağımsız değişkenlerini belirtmek için 
öznitelikleri kullanın. 



















1. Bileşenin @code C# kodunu güncelleştirin: 


• [Parameter] özniteliğiyle ortak bir incrementAmount özelliği ekleyin. 

• currentCount değerini artırdığınızda incrementAmount kullanmak için incrementcount yöntemini 
değiştirin. 

Pages/Counter. Razor. 

@page "/counter" 

<hl>Counter</hl> 

<p>Current count: @currentCount</p> 

<button class="btn btn-primary" @onclick="IncrementCount">Click me</button> 

@code { 

private int currentCount = 0; 

[Parameter] 

public int İncrementAmount { get; set; } = 1; 

private void IncrementCount() 

{ 

currentCount += İncrementAmount; 

} 

} 

1. Özniteliği kullanarak index bileşeninin <counter> öğesinde bir incrementAmount parametresi belirtin. 
Sayacı on olarak artırmak için değeri ayarlayın. 

Pages/lndex. Razor. 

@page "/" 

<hl>Hello, world!</hl> 

Welcome to your new app. 

<Counter IncrementAmount="10" /> 

2. index bileşenini yeniden yükleyin. Beni tıklama düğmesi seçildiğinde sayaç on bir kez artar, counter 
bileşenindeki sayaç bir artış ile devam eder. 

Bileşenlere yönlendir 

Counter. Razor dosyasının en üstündeki @page yönergesi, counter bileşeninin bir yönlendirme uç noktası 
olduğunu belirtir, counter bileşeni /counter gönderilen istekleri işler. @page yönergesi olmadan, bileşen 
yönlendirilmiş istekleri işlemez, ancak bileşen diğer bileşenler tarafından hala kullanılabilir. 

Bağımlılık ekleme 

Blazor sunucusu deneyimi 

Blazor sunucu uygulamasıyla çalışıyorsanız, WeatherForecastService hizmeti bir tek Startup.ConfigureServices 
olarak kaydedilir. Uygulamanın tamamında bağımlılık ekleme (dı)yoluyla hizmetin bir örneği mevcuttur: 


















public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRazorPages(); 

Services.AddServerSideBlazor(); 

Services.AddSingleton<WeatherForecastService>(); 

} 

@inject yönergesi, ueatherForecastservice hizmetinin örneğini FetchData bileşenine eklemek için kullanılır. 
Pages/FetchData. Razor. 

@page "/fetchdata" 

@using ToDoList.Data 

(Şinject 1/JeatherForecastService ForecastService 

FetchData bileşeni, weatherForecast nesnelerinin bir dizisini almak için, ForecastService olarak eklenen hizmeti 
kullanır: 


@code { 

private WeatherForecast[] forecasts; 


protected override async Task OnInitializedAsync() 

{ 

forecasts = await ForecastService.GetForecastAsync(DateTime.Now); 

} 


Blazor VVeelsembly deneyimi 

Blazor WebAssembly uygulamasıyla çalışıyorsanız, Wwwroot/Sample-Data klasöründeki Hava durumu. JSON 
dosyasından Hava durumu tahmin verileri almak için Httpciient eklenir. 

Pages/FetchData. Razor: 

(Şinject HttpClient Http 


protected override async Task OnInitializedAsync() 

{ 

forecasts = 

await Http.GetisonAsync<WeatherForecast[]>("sample-data/weather.json"); 

} 


@foreach döngüsü, her tahmin örneğini Hava durumu verileri tablosunda bir satır olarak işlemek için kullanılır: 










ctable class="table"> 

<thead> 

<tr> 

<th>Date</th> 

<th>Temp. (C)</th> 

<th>Temp. (F)</th> 

<th>Summary</th> 

</tr> 

</thead> 

<tbody> 

@foreach (var forecast in forecasts) 

{ 

<tr> 

<td>@forecast.Date.ToShortDateString()</td> 
<td>@forecast.TemperatureCc/td> 
<td>@forecast.TemperatureF</td> 
<td>@forecast.Summary</td> 

</tr> 

} 

</tbody> 

</table> 


Yapılacaklar listesi oluşturma 

Uygulamaya basit bir yapılacaklar listesi uygulayan yeni bir bileşen ekleyin. 

1. Uygulamalar klasörüne Todo. Razor adlı boş bir dosya ekleyin: 

2. Bileşen için ilk biçimlendirmeyi belirtin: 

@page "/todo" 

<hl>Todo</hl> 

3. Gezinti çubuğuna Todo bileşenini ekleyin. 

NavMenu bileşeni ( Shared/NavMenu. Razor) uygulamanın düzeninde kullanılır. Düzenler, uygulamadaki 
içeriğin çoğaltılmasını önlemenize olanak sağlayan bileşenlerdir. 

Aşağıdaki liste öğesi işaretlemesini paylaşdan/NavMenu. Razor dosyasında var olan liste öğelerinin altına 
ekleyerek Todo bileşeni için bir <NavLink> öğesi ekleyin: 

<li class="nav-item px-3"> 

<NavLink class="nav-link" href="todo"> 

<span class="oi oi-list-rich" aria-hidden="true"x/span> Todo 
</NavLink> 

</li> 

4. Uygulamayı yeniden derleyin ve çalıştırın. Todo bileşeni bağlantısının çalıştığından emin olmak için yeni 
Todo sayfasını ziyaret edin. 

5. Bir Todo öğesini temsil eden bir sınıfı tutmak için projenin köküne bir Todoltem.es dosyası ekleyin. 
Todoitem sınıfı için C# aşağıdaki kodu kullanın: 










public class Todoltem 

{ 

public string Title { get; set; } 
public bool IsDone { get; set; } 

} 

6. Todo bileşenine geri dönün (Pages/Todo. Razor): 

• @code bloğundaki Todo öğeleri için bir alan ekleyin. Todo bileşeni, Todo listesinin durumunu korumak 
için bu alanı kullanır. 

• Her Todo öğesini bir liste öğesi ( <ii> ) olarak işlemek için sıralanmamış liste işaretlemesi ve bir foreach 
döngüsü ekleyin. 

@page "/todo" 

<hl>Todo</hl> 

<ul> 

(Şforeach (var todo in todos) 

{ 

<li>@todo.Title</li> 

} 

</ul> 

@code { 

private IList<TodoItem> todos = new List<TodoItem>(); 

} 

7. Uygulama, listeye Todo öğeleri eklemek için Kullanıcı arabirimi öğeleri gerektirir.Sıralanmamış listenin ( 

<ui>.. .</ui> ) altına bir metin girişi ( <input> ) ve bir düğme ( <button> ) ekleyin: 

@page "/todo" 

<hl>Todo</hl> 

<ul> 

(Şforeach (var todo in todos) 

{ 

<li>@todo.Title</li> 

} 

</ul> 

<input placeholder="Something todo" /> 

<button>Add todo</button> 

@code { 

private IList<TodoItem> todos = new List<TodoItem>(); 

} 

8. Uygulamayı yeniden derleyin ve çalıştırın. Todo Ekle düğmesi seçildiğinde, bir olay işleyicisi düğmeye 
kablolu olmadığı için hiçbir şey olmaz. 

9. Todo bileşenine bir AddTodo yöntemi ekleyin ve @onciick özniteliğini kullanarak düğme seçimleri için 
kaydedin. Düğme seçildiğinde C# AddTodo yöntemi çağrılır: 












cinput placeholder="Something todo" /> 
<button @onclick="AddTodo">Add todo</button> 


@code { 

private IList<TodoItem> todos = new ListcTodoItem>(); 

private void AddTodo() 

{ 

// Todo: Add the todo 

} 

} 

10. Yeni Todo öğesinin başlığını almak için, @code bloğunun üst kısmına bir newTodo dize alanı ekleyin ve 
<input> öğesindeki bind özniteliğini kullanarak metin girişinin değerine bağlayın: 

private IList<TodoItem> todos = new ListcTodoItem>(); 
private string newTodo; 


cinput placeholder="Something todo" @bind="newTodo" /> 

11. AddTodo yöntemini, belirtilen başlığa sahip Todoitem listeye eklemek için güncelleştirin. newTodo boş bir 
dizeye ayarlayarak metin girişinin değerini temizleyin: 

@page "/todo" 

<hl>Todo</hl> 

<ul> 

@foreach (var todo in todos) 

{ 

cli>@todo.Titlec/li> 

} 

</ul> 

cinput placeholder="Something todo" @bind="newTodo" /> 
cbutton @onclick="AddTodo">Add todoc/button> 

@code { 

private IListcTodoItem> todos = new ListcTodoItem>(); 
private string newTodo; 

private void AddTodo() 

{ 

if (!string.IsNullOrWhiteSpace(newTodo)) 

{ 

todos.Add(new Todoitem { Title = newTodo }); 
newTodo = string.Empty; 

} 

} 


12. Uygulamayı yeniden derleyin ve çalıştırın. Yeni kodu test etmek için Todo listesine bazı Todo öğeleri ekleyin 

13. Her Todo öğesi için başlık metni düzenlenebilir hale getirilebilir ve bir onay kutusu kullanıcının 
tamamlanmış öğeleri izlemesine yardımcı olabilir. Her Todo öğesi için bir onay kutusu girişi ekleyin ve 
değerini isDone özelliğine bağlayın. @todo.Title , @todo.Title bağlantılı cinput> bir öğe olarak değiştirin 












<ul> 

(Sforeach (var todo in todos) 

{ 

<li> 

<input type="checkbox" @bind="todo.IsDone" /> 

<input @bind="todo.Title" /> 

</li> 

} 

</ul> 

14. Bu değerlerin bağlandığını doğrulamak için <hi> üst bilgisini, tamamlanmamış olan Todo öğelerinin 
sayısının sayısını gösterecek şekilde güncelleştirin ( isDone faise ). 

<hl>Todo (@todos.Count(todo => Itodo.IsDone))</hl> 

15. Tamamlanan Todo bileşeni (Sayfalar/Todo. Razor): 

@page "/todo" 

<hl>Todo (@todos.Count(todo => Itodo.IsDone))</hl> 

<ul> 

(Şforeach (var todo in todos) 

{ 

<li> 

<input type="checkbox" @bind="todo.IsDone" /> 
cinput @bind="todo.Title" /> 

</li> 

} 

</ul> 

<input placeholder="Something todo" @bind="newTodo" /> 

<button @onclick="AddTodo">Add todo</button> 

@code { 

private IList<TodoItem> todos = new List<TodoItem>(); 
private string newTodo; 

private void AddTodo() 

{ 

if (!string.IsNullOrWhiteSpace(newTodo)) 

{ 

todos.Add(new Todoltem { Title = newTodo }); 
newTodo = string.Empty; 

} 

} 


16. Uygulamayı yeniden derleyin ve çalıştırın. Yeni kodu test etmek için Todo öğeleri ekleyin. 


ASP.NET Core Razor bileşenleri oluşturma ve kullanma 
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IMPORTANT 

Önizlemede Blazor VVeelsembly 

Blazor sunucusu ASP.NET Core 3,0 ' de desteklenir. Blazor VVebAssembly ASP.NET Core 3,1 için önizlemededir. 

Blazor Framevvork, Blazor barındırma modellerinin her biri için uygulama geliştirmeye yönelik şablonlar sağlar: 

• Blazor VVebAssembly ( biazorwasm ) 

• Blazor sunucusu ( blazorserver ) 

Blazorbarındırma modelleri hakkında daha fazla bilgi için bkz. Blazor barındırma modellerini ASP.NET Core. 

Şablondan Blazor uygulama oluşturmaya yönelik adım adım yönergeler için, bkz. ASP.NET Core Blazor 
kullanmaya başlama. 

Blazor proje yapısı 

Aşağıdaki dosya ve klasörler, Blazor şablonundan oluşturulan Blazor bir uygulama yapar: 

• Program.es ana bilgisayarı AS P.N ET Core ayarlayan uygulamanın giriş noktasını -. Bu dosyadaki kod, 
ASP.NET Core şablonlarından oluşturulan tüm ASP.NET Core uygulamalarda ortaktır. 

• Startup.es-, uygulamanın başlangıç mantığını içerir, startup sınıfı iki yöntemi tanımlar: 

o configureServices uygulamanın bağımlılık ekleme (dı) hizmetlerini yapılandırır. Sunucu 

uygulamalarında Blazor, hizmetler AddServerSideBlazorçağırarak eklenir ve weatherForecastservice 
örnek FetchData bileşeni tarafından kullanılmak üzere hizmet kapsayıcısına eklenir, 
o configure uygulamanın istek işleme ardışık düzenini yapılandırır: 

o Blazor VVebAssembly uygulamanın kök bileşeni olan App bileşenini ( app DOM öğesi olarak 
belirtilen Addcomponent yöntemine) ekler, 
o Blazor Sunucusu 

o MapBlazorHub, tarayıcıya gerçek zamanlı bağlantı için bir uç nokta ayarlamak üzere 

çağırılır. Bağlantı, uygulamalara gerçek zamanlı Web işlevselliği eklemek için bir çerçeveden 
SignalRoluşturulur. 

o Mapfallbacktopage ("/_Host") , uygulamanın kök sayfasını ( Pages/_Host. cshtml) ayarlamak 
ve gezinmeyi etkinleştirmek için çağırılır. 

• WwwrootAndex.html (Blazor VVebAssembly) bir HTML sayfası olarak uygulanan uygulamanın kök sayfasını 


o Uygulamanın herhangi bir sayfası başlangıçta istendiğinde, Bu sayfa işlenir ve yanıtta döndürülür, 
o Bu sayfa, kök App bileşeninin nerede işleneceğini belirtir. App bileşeni (app. Razor) startup.configure 
içindeki Addcomponent metoduna app DOM öğesi olarak belirtilir, 
o _Framework/Blazor.webassembly.js JavaScript dosyası yüklenir ve şunları yapın: 
o .NET çalışma zamanını, uygulamayı ve uygulamanın bağımlılıklarını indirir. 



















o 


Uygulamayı çalıştırmak için çalışma zamanını başlatır. 

Pages/_Host. cshtml (Blazor Server), Razor sayfası olarak uygulanan uygulamanın kök sayfasına 

o Uygulamanın herhangi bir sayfası başlangıçta istendiğinde, Bu sayfa işlenir ve yanıtta döndürülür, 
o Tarayıcı ve sunucu arasındaki gerçek zamanlı SignalR bağlantısını ayarlayan _framework/Blazor.Serverjs 
JavaScript dosyası yüklenir. 

o Ana bilgisayar sayfası, kök App bileşeni 'nin ( app. Razor ) nerede işleneceğini belirtir. 

App. razor- Router bileşenini kullanarak istemci tarafı yönlendirmeyi ayarlayan uygulamanın kök 
bileşenidir. Router bileşeni tarayıcı gezintisini karşılar ve istenen adresle eşleşen sayfayı işler. 

Sayfalar klasörü - Blazor uygulamayı oluşturan yönlendirilebilir bileşenleri/sayfaları (. Razor) içerir. Her 
sayfanın yolu @page yönergesi kullanılarak belirtilir. Şablon aşağıdaki bileşenleri içerir: 

o index ( lndex. Razor) - giriş sayfasını uygular, 
o counter ( Counter. Razor ) - sayaç sayfasını uygular. 

o uygulamada işlenmeyen bir özel durum oluştuğunda Error (yalnızca/rota. Razor, Blazor sunucu 
uygulaması) -. 

o FetchData {fetchdata. Razor) - verileri getir sayfasını uygular. 

Paylaşdan klasör-, uygulama tarafından kullanılan diğer Kullanıcı Arabirimi bileşenlerini (. Razor) içerir: 
o MainLayout ( mainlayout. Razor) uygulamanın düzen bileşeni -. 

o NavMenu ( Navmerıu. Razor) - kenar çubuğu gezintisini uygular. Diğer Razor bileşenlerine yönelik gezinti 
bağlantılarını işleyen navlink bileşenini (NavLink) içerir. NavLink bileşeni, bileşeni yüklendiği zaman 
otomatik olarak seçili durumu gösterir ve bu, kullanıcının hangi bileşenin görüntülenmekte olduğunu 
anlamasına yardımcı olur. 

_lmports. razor -, uygulamanın bileşenlerine (. Razor) dahil edilecek, ad alanları için @using yönergeleri 
gibi ortak Razor yönergelerini içerir. 

Veri klasörü (Blazor sunucusu) -, uygulamanın FetchData bileşene örnek Hava durumu verileri sağlayan 
WeatherForecastService WeatherForecast sınıfını ve uygulamasını içerir. 

Wwwroot , uygulamanın ortak statik varlıklarını İçeren uygulamanın Web kök klasörünü -. 

appSettings. JSON (Blazor Server) uygulama için yapılandırma ayarlarını -. 
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Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Blazor uygulamalar, Meşen/er/kullanılarak oluşturulmuştur. Bir bileşen, bir sayfa, iletişim veya form gibi bir 
kullanıcı arabirimi (UI) öbekidir. Bir bileşen, veri eklemek veya UI olaylarına yanıt vermek için gereken HTM L 
işaretlemesini ve işleme mantığını içerir. Bileşenler esnek ve hafif. Bunlar, iç içe geçmiş, yeniden kullanılabilir ve 
projeler arasında paylaşılabilir. 

Bileşen sınıfları 

Bileşenler, C# ve HTML İşaretlemesi kullanılarak Razor bileşen dosyalarında (. Razor) uygulanır.Blazor bir 
bileşen, bir Razor Meşen/olarak adlandırılır. 

Bir bileşenin adı, büyük harfle başlamalıdır.Örneğin, mycoolcomponent. Razor geçerlidir ve mycoolcomponent. 
Razor geçersizdir. 

Bir bileşen için Kullanıcı arabirimi HTML kullanılarak tanımlanır. Dinamik işleme mantığı (örneğin, döngüler, 
koşullar, ifadeler) C# Razoradlı gömülü bir sözdizimi kullanılarak eklenir. Bir uygulama derlendiğinde, HTML 
biçimlendirme ve C# işleme mantığı bir bileşen sınıfına dönüştürülür. Oluşturulan sınıfın adı, dosyanın adıyla 
eşleşir. 

Bileşen sınıfının üyeleri bir @code bloğunda tanımlanmıştır. @code bloğunda, bileşen durumu (özellikler, alanlar) 
olay işleme yöntemleriyle veya diğer bileşen mantığını tanımlamaya yönelik yöntemlerle belirtilir. Birden fazla 
@code bloğu izin verilir. 


NOTE 

ASP.NET Core 3,0 ' nin önceki önizlemelerinde, @functions blokları Razor bileşenlerinde @code bloklarında aynı amaçla 
kullanılmıştır. @functions blokları Razor bileşenlerinde çalışmaya devam eder, ancak ASP.NET Core 3,0 Previevv 6 veya 
sonraki bir sürümünde @code bloğunun kullanılmasını öneririz. 


Bileşen üyeleri, @ ile başlayan ifadeleri kullanarak C# bileşenin işleme mantığının bir parçası olarak kullanılabilir. 
Örneğin bir C# alan, alan adına @ önek olarak işlenerek işlenir. Aşağıdaki örnek değerlendirilir ve işler: 



Bileşen ilk olarak işlendikten sonra, bileşen işleme ağacını olaylara yanıt olarak yeniden oluşturur. Blazor, yeni 
işleme ağacını öncekiyle karşılaştırır ve tarayıcının Belge Nesne Modeli (DOM) üzerinde herhangi bir değişiklik 











uygular. 


Bileşenler sıradan C# sınıflardır ve bir proje içinde herhangi bir yere yerleştirilebilir. Web sayfalarını üreten 
bileşenler genellikle Sayfalar klasöründe bulunur. Sayfa olmayan bileşenler sıklıkla paylaşılan klasöre veya 
projeye eklenen özel bir klasöre yerleştirilir. Özel bir klasör kullanmak için, özel klasörün ad alanını üst bileşene ya 
da uygulamanın _lmports. Razor dosyasına ekleyin. Örneğin, aşağıdaki ad alanı, uygulamanın kök ad alanı 
uebAppiication olduğunda Bileşenler klasöründeki bileşenleri kullanılabilir yapar: 

@using WebApplication.Components 


Bileşenleri Razor Pages ve MVC uygulamalarıyla tümleştirme 

Mevcut Razor Pages ve MVC uygulamalarıyla bileşenleri kullanın. Razor bileşenleri kullanmak için mevcut 
sayfaları veya görünümleri yeniden yazmanız gerekmez. Sayfa veya görünüm işlendiğinde, bileşenler aynı anda 
önceden işlenir. 

Bir sayfadan veya görünümden bir bileşeni işlemek için component etiketi yardımcısını kullanın: 

<component type="typeof(Counter)" render-mode="ServerPrerendered" 
param-IncrementAmount="10" /> 

Parametreleri geçirme (örneğin, önceki örnekteki incrementAmount ) desteklenir. 

RenderMode , bileşenin şunları yapıp kullanmadığını yapılandırır: 

• , Sayfaya ön gönderilir. 

• , Sayfada statik HTML olarak veya Kullanıcı aracısından bir Blazor uygulamasını önyüklemek için gerekli 
bilgileri içeriyorsa. 


RENDERMODE 


AÇIKLAMA 


serverPrerendered Bileşeni statik HTML olarak işler ve Blazor sunucusu 

uygulaması için bir işaret içerir. Kullanıcı Aracısı başladığında, 
bu işaretleyici bir Blazor uygulamasının önyüklemesi için 
kullanılır. 


server Blazor sunucusu uygulaması için bir işaret oluşturur. Bileşen 

çıkışı dahil değildir. Kullanıcı Aracısı başladığında, bu işaretleyici 
bir Blazor uygulamasının önyüklemesi için kullanılır. 

static Bileşeni statik HTML olarak işler. 

Sayfalar ve görünümler bileşenleri kullanırken, listesiyse doğru değildir.Bileşenler, kısmi görünümler ve bölümler 
gibi görüntüleme ve sayfaya özgü senaryolar kullanamaz. Bir bileşende kısmi görünümden mantığı kullanmak 
için kısmi görünüm mantığını bir bileşene ayırın. 

Statik HTML sayfasından sunucu bileşenleri işleme desteklenmiyor. 

Bileşenlerin nasıl işlendiği, bileşen durumu ve component etiketi Yardımcısı hakkında daha fazla bilgi için bkz. 

Blazor barındırma modellerini ASP.NET Core. 

Bir sayfadan veya görünümden bir bileşeni işlemek için RendenComponentAsync<TComponent> HTML yardımcı 
yöntemini kullanın: 



















@(await Html.RenderComponentAsync<MyComponent>(RenderMode.ServerPrerendered)) 

RenderMode , bileşenin şunları yapıp kullanmadığını yapılandırır: 

• , Sayfaya ön gönderilir. 

• , Sayfada statik HTML olarak veya Kullanıcı aracısından bir Blazor uygulamasını önyüklemek için gerekli 
bilgileri içeriyorsa. 


RENDERMODE 


AÇIKLAMA 


ServerPrerendered Bileşeni statik HTML olarak işler ve Blazor sunucusu 

uygulaması için bir işaret içerir. Kullanıcı Aracısı başladığında, 
bu işaretleyici bir Blazor uygulamasının önyüklemesi için 
kullanılır. Parametreler desteklenmiyor. 


server Blazor sunucusu uygulaması için bir işaret oluşturur. Bileşen 

çıkışı dahil değildir. Kullanıcı Aracısı başladığında, bu işaretleyici 
bir Blazor uygulamasının önyüklemesi için kullanılır. 
Parametreler desteklenmiyor. 


static Bileşeni statik HTML olarak işler. Parametreler destekleniyor. 

Sayfalar ve görünümler bileşenleri kullanırken, listesiyse doğru değildir. Bileşenler, kısmi görünümler ve bölümler 
gibi görüntüleme ve sayfaya özgü senaryolar kullanamaz. Bir bileşende kısmi görünümden mantığı kullanmak 
için kısmi görünüm mantığını bir bileşene ayırın. 

Statik HTML sayfasından sunucu bileşenleri işleme desteklenmiyor. 

Bileşenlerin nasıl işlendiği, bileşen durumu ve RenderComponentAsync HTML Yardımcısı hakkında daha fazla bilgi 
için bkz. Blazor barındırma modellerini ASP.NET Core. 

Bileşenleri kullanma 

Bileşenler, HTML öğesi söz dizimini kullanarak bildirerek diğer bileşenleri içerebilir.Bir bileşeni kullanmak için 
biçimlendirme, etiket adının bileşen türü olduğu bir HTML etiketi gibi görünür. 

Öznitelik bağlama büyük/küçük harfe duyarlıdır.Örneğin, @bind geçerlidirve @Bind geçersizdir. 

Index. Razor dosyasında aşağıdaki biçimlendirme HeadingComponent örneği işler: 

<HeadingComponent /> 


Bileşenler/HeadlngComponent. Razor: 












@using System.Globalization 

@* 

The ’using' directive makes System.Globalization available to 
the component. System.Globalization provides a method for 
converting a stning into title case (capitalizes the first 
letter of every word in a string), which is used to convert a 
a string into title case for a heading. 

*@ 

@* 

Heading text is rendered by evaluating the _headingText field. 

The font-style of the heading is rendered by evaluating the 
_headingfontStyle field. 

*@ 

<hl style="font-style:@_headingFontStyle">@_headingText</hl> 

<form> 

<div> 

@* 

A check box sets the font style and is bound to the 
_italicsCheck field. 

*@ 

<input type="checkbox" id="italicsCheck" 

@bind="_italicsCheck" /> 
dabel class="form-check-label" 

for="italicsCheck">Use italics</label> 

</div> 

@* 

When the form is submitted, the onclick event executes 
the UpdateHeading method. 

*@ 

<button type="button" class="btn btn-primary" @onclick="UpdateHeading"> 
Update heading 
</button> 

</form> 

@code { 

private static TextInfo _tinfo = CultureInfo.CurrentCulture.TextInfo; 
private string _headingText = 

_tinfo.ToTitleCase("welcome to blazor!"); 
private string _headingFontStyle = "normal"; 
private bool _italicsCheck = false; 

// When UpdateHeading is executed, _italicsCheck determines 
// the value of JıeadingFontStyle to set the font style of the 
// heading. 

public void UpdateHeading() 

{ 

_headingFontStyle = _italicsCheck ? "italic" : "normal"; 

} 


Bir bileşen bir bileşen adıyla eşleşmeyen büyük harfle yazılmış bir HTML öğesi içeriyorsa, öğenin beklenmeyen 
bir adı olduğunu gösteren bir uyarı yayınlanır. Bileşenin ad alanı için @using bir deyimin eklenmesi, bileşenin 
kullanılabilir olmasını sağlar ve bu da uyarıyı kaldırır. 

Bileşen parametreleri 

Bileşenler, bileşen sınıfında [Parameter] özniteliğiyle ortak özellikler kullanılarak tanımlanan bileşen 
parametrelerinesabip olabilir. Biçimlendirme içindeki bir bileşenin bağımsız değişkenlerini belirtmek için 
öznitelikleri kullanın. 


Bileşenler/ChildComponent. Razor. 





<div class="panel panel-default"> 

<div class="panel-heading">@Title</div> 

<div class="panel-body">@ChildContent</div> 

<button class="btn btn-primary" @onclick="OnClick"> 

Trigger a Parent component method 
</button> 

</div> 

@code { 

[Panameten] 

public stning Title { get; set; } 

[Parameter] 

public RenderFragment ChildContent { get; set; } 
[Parameter] 

public EventCallback<MouseEventArgs> OnClick { get; set; } 


Örnek uygulamadan aşağıdaki örnekte Parentcomponent , childcomponent' 'Title özelliğinin değerini ayarlar. 
Pages/ParentComponent. Razor. 

@page "/Parentcomponent" 

<hl>Parent-child example</hl> 

<ChildComponent Title="Panel Title from Parent" 

OnClick="@ShowMessage"> 

Content of the child component is supplied 
by the parent component. 

</ChildComponent> 


Alt içerik 

Bileşenler, başka bir bileşenin içeriğini ayarlayabilir.Atama bileşeni, alıcı bileşeni belirten Etiketler arasında içerik 
sağlar. 

Aşağıdaki örnekte childcomponent , işlemek için bir kullanıcı arabirimi segmentini temsil eden bir RenderFragment 
temsil eden bir ChildContent özelliğine sahiptir. ChildContent değeri bileşenin, içeriğin işlenmesi gereken 
biçimlendirmesinde konumlandırılır. ChildContent değeri üst bileşenden alınır ve önyükleme bölmesinin 
panel-body içinde işlenir. 

Bileşenler/ChildComponerıt. Razor: 










<div class="panel panel-default"> 

<div class="panel-heading">@Title</div> 

<div class="panel-body">@ChildContent</div> 

<button class="btn btn-primary" @onclick="OnClick"> 

Trigger a Parent component method 
</button> 

</div> 

@code { 

[Panameten] 

public stning Title { get; set; } 

[Parameter] 

public RenderFragment ChildContent { get; set; } 
[Parameter] 

public EventCallback<MouseEventArgs> OnClick { get; set; } 


NOTE 

RenderFragment içeriği alan özelliğin kurala göre ChildContent olarak adlandırılması gerekir. 


Örnek uygulamadaki Parentcomponent , içeriği <chiidComponent> etiketlerin içine yerleştirerek childcomponent 
işlemek için içerik sağlayabilir. 

Pages/ParentComponent. Razor. 

@page "/Parentcomponent" 

<hl>Parent-child example</hl> 

cChildComponent Title="Panel Title from Parent" 

OnClick="@ShowMessage"> 

Content of the child component is supplied 
by the parent component. 

</ChildComponent> 


Öznitelik döndürme ve rastgele parametreler 

Bileşenler, bileşen tarafından tanımlanan parametrelere ek olarak ek öznitelikler yakalayabilir ve işleyebilir. Ek 
öznitelikler bir sözlükte yakalanabilir ve sonra bileşen @attributes Razor yönergesi kullanılarak işlendiğinde bir 
öğe üzerine bırakılabilir. Bu senaryo, çeşitli özelleştirmeleri destekleyen bir işaretleme öğesi üreten bir bileşen 
tanımlarken yararlıdır. Örneğin, çok sayıda parametreyi destekleyen bir <input> öznitelikleri ayrı olarak 
tanımlamak sıkıcı olabilir. 

Aşağıdaki örnekte, ilk <input> öğesi ( id="useindividuaiParams" ) bağımsız bileşen parametrelerini kullanır, ancak 
ikinci <input> öğesi ( id="useAttributesDict" ) öznitelik sponu kullanır: 












cinput id="useIndividualParams" 
maxlength="@Maxlength" 
placeholder="@Placeholder" 
required="@Required" 
size="@Size" /> 

<input id="useAttributesDict" 

@attributes="InputAttributes" /> 

@code { 

[Parameter] 

public string Maxlength { get; set; } = "10"; 

[Parameter] 

public string Placeholder { get; set; } = "Input placeholder text"; 

[Parameter] 

public string Required { get; set; } = "required"; 

[Parameter] 

public string Size { get; set; } = "50"; 

[Parameter] 

public Dictionarycstring, object> InputAttributes { get; set; } = 
new Dictionarycstring, object>() 

{ 

{ "maxlength", "10" }, 

{ "placeholder", "Input placeholder text" }, 

{ "required", "required" }, 

{ "size", "50" } 

}; 

} 

Parametrenin türü dize anahtarlarıyla iEnumerabie<KeyvaiuePair<string, object>> uygulamalıdır. 

iReadOniyDictionary<string, object> kullanmak Bu senaryoda da bir seçenektir. 

Her iki yaklaşımın de kullanıldığı işlenen <input> öğeleri aynıdır: 

cinput id="useIndividualParams" 
maxlength="10" 

placeholder="Input placeholder text" 

required="required" 

size="50"> 

cinput id="useAttributesDict" 
maxlength="10" 

placeholder="Input placeholder text" 

required="required" 

size="50"> 

Rastgele öznitelikleri kabul etmek için, Captureunmatchedvalues özelliği true olarak ayarlanan [Parameter] 
özniteliğini kullanarak bir bileşen parametresi tanımlayın: 

@code { 

[Parameter(CaptureUnmatchedValues = true)] 

public Dictionarycstring, object> InputAttributes { get; set; } 

} 

[Parameter] Captureunmatchedvalues özelliği, parametrenin diğer bir parametreyle eşleşmeyen tüm özniteliklerle 
eşleşmesini sağlar. Bir bileşen yalnızca Captureunmatchedvalues olan tek bir parametre tanımlayabilir. 

Captureunmatchedvalues ile kullanılan özellik türü, Dictionarycstring, object> dize anahtarlarıyla atanabilir 












olmalıdır. IEnumerablecKeyValuePaircstring, object>> veya IReadOnlyDictionarycstring., object> Ayrıca bu 
senaryodaki seçeneklerdir. 

Öğe özniteliklerinin konumuna göre @attributes konumu önemlidir. Öğe üzerinde @attributes , öznitelikler 
sağdan sola (son olarak) işlenir, child bileşeni tüketen bir bileşen için aşağıdaki örneği göz önünde bulundurun: 

ParentComponent. Razor. 

cChildComponent extra="10" /> 

Childcomponent. Razor: 

<div @attributes="AdditionalAttributes" extra="5" /> 

[Parameter(CaptureUnmatchedValues = true)] 

public IDictionarycstring, object> AdditionalAttributes { get; set; } 


child bileşenin extra özniteliği @attributes sağına ayarlanmıştır. Parent 

bileşenin işlenmiş <div> , öznitelikler 

sağdan sola (en son) işlendiği için ek özniteliğiyle geçirildiğinde extra="5" 

içerir: 

cdiv extra="5" /> 

Aşağıdaki örnekte, extra ve @attributes sırası child bileşeninin cdiv> t 

:ersine çevrilir: 


ParentComponent. Razor: 

cChildComponent extra="10" /> 

Childcomponent. Razor: 


cdiv extra="5" @attributes="AdditionalAttributes" /> 
[Parameter(CapturellnmatchedValues = true)] 

public IDictionarycstring, object> AdditionalAttributes { get; set; } 


Parent 

bileşenindeki işlenen 

A 

CL 

H- 

< 

V 

, ek öznitelik üzerinden geçirildiğinde 

extra="10" 

içerir: 

cdiv 

extra="10" /> 






Veri bağlama 

Hem bileşenlere hem de DOM öğelerine veri bağlama @bind özniteliğiyle gerçekleştirilir. Aşağıdaki örnek, bir 
Currentvalue özelliğini metin kutusu değerine bağlar: 

cinput @bind="CurrentValue" /> 

@code { 

private string Currentvalue { get; set; } 

} 

Metin kutusu odağı kaybettiğinde, özelliğin değeri güncellenir. 

Metin kutusu kullanıcı arabiriminde, özelliğin değerini değiştirme yanıt olarak değil, yalnızca bileşen işlendiğinde 





















güncelleştirilir. Bileşenler olay işleyicisi kodu yürütüldükten sonra kendilerini oluşturduğundan, özellik 
güncelleştirmeleri genellikle olay işleyicisi tetiklendikten hemen sonra Kullanıcı arabirimine yansıtılır. 

Currentvalue özelliği ( <input @bind="Currentvaiue" /> ) ile @bind kullanmak, temelde aşağıdakilere eşdeğerdir: 

cinput value="@CurrentValue" 

@onchange="@( (ChangeEventArgs _e) => Currentvalue = 

_e.Value.ToString())" /> 

@code { 

private string Currentvalue { get; set; } 

} 

Bileşen işlendiğinde, giriş öğesinin value currentvalue özelliğinden gelir. Kullanıcı metin kutusuna yazdığında 
ve öğe odağını değiştirdiğinde, onchange olayı tetiklenir ve currentvalue özelliği değiştirilen değere ayarlanır. 
@bind , tür dönüştürmelerin gerçekleştirildiği durumları işlediği için kod oluşturma daha karmaşıktır. Prensibi 
@bind , bir ifadenin geçerli değerini bir value özniteliğiyle ilişkilendirir ve kayıtlı işleyiciyi kullanarak değişiklikleri 
işler. 

@bind sözdizimiyle onchange olaylarının işlenmesine ek olarak, bir özellik veya alan, event parametreli bir 
@bind-vaiue özniteliği belirterek diğer olaylar kullanılarak da bağlanabilir ( @bind-vaiue:event ). Aşağıdaki örnek, 
oninput olayı için Currentvalue özelliğini bağlar: 

cinput @bind-value="CurrentValue" @bind-value:event="oninput" /> 

@code { 

private string Currentvalue { get; set; } 

} 

onchange aksine, öğe odağı kaybettiğinde harekete geçirilir oninput metin kutusunun değeri değiştiğinde 
harekete geçirilir. 

Ayrıştırılamayan değerler 

Bir Kullanıcı, bir veri sınırlama öğesine ayrıştırılamayan bir değer sağlıyorsa, bağlama olayı tetiklendiğinde, 
çözümlenemeyen değer otomatik olarak önceki değerine döndürülür. 

Aşağıdaki senaryoyu ele alalım: 

• Bir <input> öğesi, 123 başlangıçtaki değeri olan bir int türüne bağlanır: 

cinput @bind="MyPnopenty" /> 

@code { 

[Parameter] 

public int MyProperty { get; set; } = 123; 

} 

• Kullanıcı, öğe değerini sayfada 123.45 olarak güncelleştirir ve öğe odağını değiştirir. 


Önceki senaryoda, öğenin değeri 123 olarak geri döndürülür. Değer 123.45 özgün 123 değerinin yararına 
reddedildiğinde, Kullanıcı değerinin kabul edilmediğini anlamıştır. 


Varsayılan olarak, bağlama öğenin onchange olayına ( @bind="{PROPERTY or field}" ) uygulanır. Farklı bir olay 

ayarlamak için @bind-vaiue= 

"{PROPERTY OR FİELD}" @bind-value:event={EVENT} kullanın. 

oninput olayı ( 

@bind-value:event="oninput" 

) için yeniden sürüm, ayrıştırılamayan bir değer sunan herhangi bir tuş vuruşu 

sonrasında oluşur, oninput 

olayı int bağlantılı bir türle hedeflenirken, kullanıcının bir 

. karakteri yazmasının 































engellenmiş olması engellenir. . bir karakter hemen kaldırılır, bu nedenle Kullanıcı yalnızca tam sayılara izin 
verilen anında geri bildirim alır, oninput olaylarındaki değerin geri döndürülmesi ideal olmayan, örneğin 
kullanıcının ayrıştırılamayan <input> bir değeri temizlemeye izin verilmesi gereken senaryolar vardır. 
Alternatifler şunlardır: 

• oninput olayını kullanmayın. Öğe odağı kaybederene kadar geçersiz bir değer geri döndürülmediğinde, 
varsayılan onchange olayını ( @bind="{PROPERTY or field}" ) kullanın. 

• int? veya string gibi null yapılabilir bir türe bağlayın ve geçersiz girdileri işlemek için özel mantık sağlayın. 

• inputNumber veya inputDate gibi bir form doğrulama bileşenikullanın. Form doğrulama bileşenlerinde 
geçersiz girişleri yönetmek için yerleşik destek vardır. Form doğrulama bileşenleri: 

o Kullanıcının geçersiz giriş sağlamasına ve ilişkili Editcontext doğrulama hataları almasına izin verin, 
o Kullanıcı ek VVebForm verisi girmeye uğramadan doğrulama hatalarını Kullanıcı ARABİRİMİNDE 
görüntüleyin. 

Genelleştirme 

@bind değerleri, geçerli kültürün kuralları kullanılarak görüntülenmek üzere biçimlendirilir ve ayrıştırılır. 

Geçerli kültüre System.Globalization.Culturelnfo.CurrentCulture özelliğinden erişilebilir. 

Culturelnfo. InvariantCulture aşağıdaki alan türleri için kullanılır ( <input type="{TYPE}" /> ): 

• date 

• number 

Yukarıdaki alan türleri: 

• , Uygun tarayıcı tabanlı biçimlendirme kuralları kullanılarak görüntülenir. 

• Serbest biçimli metin içeremez. 

• Tarayıcının uygulamasına göre Kullanıcı etkileşimi özellikleri sağlar. 

Aşağıdaki alan türleri belirli biçimlendirme gereksinimlerine sahiptir ve şu anda tüm büyük tarayıcılarda 
desteklenmediğinden Blazor tarafından desteklenmemektedir: 

• datetime-local 

• month 

• week 

@bind , bir değeri ayrıştırmak ve biçimlendirmek için bir System.Globalization.Culturelnfo sağlamak üzere 
@bind:cuiture parametresini destekler, date ve number alan türleri kullanılırken bir kültür belirtilmesi 
önerilmez, date ve number , gerekli kültürü sağlayan yerleşik Blazor desteğine sahiptir. 

Kullanıcının kültürünü ayarlama hakkında daha fazla bilgi için Yerelleştirme bölümüne bakın. 

Biçim dizeleri 

Veri bağlama @bind:format kullanarak DateTime biçim dizeleriyle birlikte kullanılabilir. Para birimi veya sayı 
biçimleri gibi diğer biçim ifadeleri şu anda kullanılamaz. 

cinput @bind="StartDate" @bind:format="yyyy-MM-dd" /> 

@code { 

[Parameter] 

public DateTime StartDate { get; set; } = new DateTime( 2020 j 1 , 1 ); 

} 


Yukarıdaki kodda <input> öğenin alan türü ( type ), text varsayılan olarak olur. @bind:format aşağıdaki .NET 

















türlerini bağlamak için desteklenir: 

• System. DateTime 

• System.DateTime? 

• System. DateTimeOffset 

• System.DateTimeOffset? 

@bind:format özniteliği, <input> öğesinin value uygulanacak tarih biçimini belirtir. Biçim Ayrıca, onchange bir 
olay gerçekleştiğinde değeri ayrıştırmak için de kullanılır. 

Blazor, tarihleri biçimlendirmek için yerleşik destek içerdiğinden date alanı türü için bir biçim belirtilmesi 
önerilmez. Önerinin artma, yyyy-m-dd tarih biçimini yalnızca date alan türüyle bir biçim sağlanırsa doğru 
şekilde çalışacak şekilde kullanın: 

cinput type="date" @bind="StartDate" @bind:format="yyyy-MM-dd"> 

Bileşen parametreleri 

Bağlama bileşen parametrelerini tanır; burada @bind-{property} , bileşenler arasında bir özellik değeri 
bağlayabilirler. 

Aşağıdaki alt bileşen ( childcomponent ) Year bir bileşen parametresine ve geri çağırmaya YearChanged sahiptir: 

<h 2 >Child Component</h 2 > 

<p>Year: @Year</p> 

@code { 

[Parameter] 

public int Year { get; set; } 

[Parameter] 

public EventCallback<int> YearChanged { get; set; } 

} 

Eventcaiiback<T> Eventcailback bölümünde açıklanmaktadır. 

Aşağıdaki üst bileşen childcomponent kullanır ve üst öğeden ParentYear parametresini alt bileşendeki Year 
parametresine bağlar: 














@page "/ParentComponent" 

<hl>Parent Component</hl> 

<p>ParentYear: @ParentYear</p> 

<ChildComponent @bind-Year="ParentYear" /> 

<button class="btn btn-primary" @onclick="ChangeTheYear"> 
Change Year to 1986 
</button> 

@code { 

[Parameter] 

public int ParentYear { get; set; } = 1978; 

private void ChangeTheYear() 

{ 

ParentYear = 1986; 

} 

} 

ParentComponent yüklemek aşağıdaki biçimlendirmeyi üretir: 

<hl>Parent Component</hl> 

<p>ParentYear: 1978</p> 

<h2>Child Component</h2> 

<p>Year: 1978</p> 


ParentYear 

özelliğinin değeri 

ParentComponent düğme seçilerek değiştirilirse, 

ChildComponent 

Year 

güncellenir. 

Year 

yeni değeri, 

ParentComponent 

yeniden eklendiğinde Kullanıcı arabiriminde işlenir: 


özelliği 


<hl>Parent Component</hl> 
<p>ParentYear: 1986</p> 
<h2>Child Component</h2> 
<p>Year: 1986</p> 


Year parametresi, Year parametresinin türüyle eşleşen bir yardımcı YearChanged olayına sahip olduğundan 
bağlanabilir. 

Kurala göre <chiidComponent @bind-Year="ParentYear" /> temelde yazmaya eşdeğerdir: 

cChildComponent @bind-Year="ParentYear" @bind-Year:event="YearChanged" /> 


Genel olarak, bir özellik @bind-property:event özniteliği kullanılarak karşılık gelen bir olay işleyicisine 
bağlanabilir. Örneğin, özellik MyProp aşağıdaki iki öznitelik kullanılarak MyEventHandler bağlanabilir: 

<MyComponent @bind-MyProp="MyValue" @bind-MyProp:event="MyEventHandler" /> 


Olay işleme 













Razor bileşenleri olay işleme özellikleri sağlar. oii{event} adlı bir HTML öğesi özniteliği için (örneğin, onciick ve 
onsubmit ), temsilci türü belirtilmiş bir değer ile, Razor bileşenleri özniteliğin değerini bir olay işleyicisi olarak 
değerlendirir. Özniteliğin adı her zaman @oii{event} biçimlendirilir. 

Aşağıdaki kod, Kullanıcı arabiriminde düğme seçildiğinde updateHeading yöntemini çağırır: 

<button class="btn btn-primary" @onclick="UpdateHeading"> 

Update heading 
</button> 

@code { 

private void UpdateHeading(MouseEventArgs e) 

{ 

} 

} 

Aşağıdaki kod, Kullanıcı arabiriminde onay kutusu değiştirildiğinde eheckehanged yöntemini çağırır: 

cinput type="checkbox" class="form-check-input" @onchange="CheckChanged" /> 

@code { 

private void CheckChanged() 

{ 

} 

} 


Olay işleyicileri Ayrıca zaman uyumsuz olabilir ve bir Taskdöndürebilir. Statehaschangedel ile çağırmanız 
gerekmez. Özel durumlar oluştuğunda günlüğe kaydedilir. 

Aşağıdaki örnekte, düğme seçildiğinde updateHeading zaman uyumsuz olarak çağrılır: 

<button class="btn btn-primary" @onclick="UpdateHeading"> 

Update heading 
</button> 

@code { 

private async Task UpdateHeading(MouseEventArgs e) 

{ 

} 

} 


Olay bağımsız değişken türleri 

Bazı olaylar için olay bağımsız değişkeni türlerine izin verilir. Bu olay türlerinden birine erişim gerekmiyorsa, 
yöntem çağrısında gerekli değildir. 

Desteklenen EventArgs aşağıdaki tabloda gösterilmiştir. 

OLAY SINIF DOM OLAYLARI VE NOTLARI 


Pano 


ClipboardEventArgs 


oncut , 

oncopy , 

onpaste 















OLAY 

Sürükle 


Hata 


Olay 


Odaklanma 

Giriş 

Klavye 

Fare 


SINIF 


DragEventArgs 


ErrorEventArgs 


EventArgs 


FocusEventArgs 


ChangeEventArgs 


KeyboardEventArgs 


MouseEventArgs 


DOM OLAYLARI VE NOTLARI 

ondrag , ondragstart , 
ondragenter , ondragleave , 
ondragover , ondrop , ondragend 

DataTransfer ve DataTransferltem 
öğe verilerini sürüklemiş tutun. 

onerror 

Genel 


onactivate , onbeforeactivate 


onbeforedeactivate 

, ondeactivate 

, onended , onfullscreenchange 


onfullscreenerror , 

onloadeddata , 

onloadedmetadata , 



onpointerlockchange 

, 


onpointerlockerror 



onreadystatechange 

, onscroll 



Pano 


onbeforecut 


onbeforecopy , 

onbeforepaste 



Giriş 

oninvalid , onreset , onselect , 
onselectionchange , onselectstart 
, onsubmit 

Medyasını 


oncanplay 

, 

oncanplaythrough , 

oncuechange 

, ondurationchange , 

onemptied 

, 

onpause , onplay , 

onplaying 

, 

onratechange , 

onseeked , 

onseeking , onstalled , 

onstop , o 

ınsuspend , ontimeupdate , 

onvolumechange , onwaiting 


onfocus , onblur , onfocusin , 
onfocusout 

relatedTarget için destek içermez. 

onchange , oninput 

onkeydown , onkeypress L onkeyup 

onclick , oncontextmenu , 
ondblclick , onmousedown , 
onmouseup , onmouseover , 


onmousemove 


onmouseout 















OLAY 


SINIF 


DOM OLAYLARI VE NOTLARI 


Fare işaretçisi 


PointerEventArgs 


onpointerdown , 

onpointerup , 


onpointercancel , 

onpointermove , 

onpointerover , 

, onpointerout 


onpointerenter , 

onpointerleave ( 


ongotpointercapture , 
onlostpointercapture 


Fare tekeri 

WheelEventArgs 

onwheel L 

onmousewheel 









ilerleme durumu 

ProgressEventArgs 

onabort , 

onload , onloadend , 



onloadstart , onprogress , 


ontimeout 


Dokunmatik 

TouchEventArgs 

ontouchstart 

, ontouchend , 



ontouchmove , 

ontouchenter , 



ontouchleave 

, ontouchcancel 


TouchPoint , dokunmaya duyarlı bir 
cihazdaki tek bir iletişim noktasını 
temsil eder. 

Önceki tablodaki olayların özellikleri ve olay işleme davranışı hakkında bilgi için bkz. başvuru kaynağında 
EventArgs sınıfları (ASPNET/AspNetCore Release/3.0 dalı). 

Lambda ifadeleri 

Lambda ifadeleri de kullanılabilir: 

<button @onclick="@(e => Console.WriteLine("HellOj world!"))">Say hello</button> 

Genellikle, bir dizi öğe üzerinde yineleme yaparken olduğu gibi ek değerlerin üzerinde kapatılabilir. Aşağıdaki 
örnek, her biri Kullanıcı arabiriminde seçildiğinde bir olay bağımsız değişkeni ( MouseEventArgs ) ve düğme 
numarası ( buttonNumber ) updateHeading çağıran üç düğme oluşturur: 

<h2>@message</h2> 

@for (var i = 1 ; i < 4 ; i++) 

{ 

var buttonNumber = i; 

<button class="btn btn-primary" 

@onclick="@(e => UpdateHeading(e., buttonNumber))"> 

Button #@i 
</button> 

} 

@code { 

private string message = "Select a button to learn its position."; 

private void UpdateHeading(MouseEventArgs e, int buttonNumber) 

{ 

message = $"You selected Button #{buttonNumber} at " + 

$"mouse position: {e.ClientX} X {e.ClientY}. 

} 

} 










NOTE 

Döngü değişkenini ( i ) doğrudan bir lambda ifadesinde bir for döngüsünde kullanmayın. Aksi halde aynı değişken 
tüm lambda ifadeleri tarafından, i değerinin tüm Lambdalar ile aynı olmasına neden olur. Her zaman değerini yerel bir 
değişkende (önceki örnekte buttonNumber ) yakalayın ve sonra kullanın. 


EventCalIback 

iç içe bileşenler içeren yaygın bir senaryo, bir alt bileşen olayı gerçekleştiğinde bir üst bileşenin yöntemini 
çalıştırma, örneğin, alt öğe içinde bir onciick olayı oluştuğunda—. Olayları bileşenler arasında göstermek için bir 
EventCalIback kullanın. Bir üst bileşen, bir alt bileşenin EventCalIback bir geri çağırma yöntemi atayabilir. 

Örnek uygulamadaki childcomponent ( B'deşenler/Ch'ıldComponent. Razor), bir düğmenin onciick işleyicisinin, 
örneğin Parentcomponent bir EventCalIback temsilcisini almak üzere nasıl ayarlandığını gösterir. EventCalIback , 
bir çevresel cihazdan onciick olayına uygun MouseEventArgs ile yazılır: 

<div class="panel panel-default"> 

<div class="panel-heading">@Title</div> 

<div class="panel-body">@ChildContent</div> 

<button class="btn btn-primary" @onclick="OnClick"> 

Trigger a Parent component method 
</button> 

</div> 

@code { 

[Parameten] 

public string Title { get; set; } 

[Panameter] 

public RenderFragment ChildContent { get; set; } 

[Panameter] 

public EventCallback<MouseEventArgs> OnClick { get; set; } 

} 


Parentcomponent , alt öğenin Eventcaiiback<T> showMessage yöntemine ayarlar. 
Pages/ParentComponent. Razor: 

@page "/Parentcomponent" 

<hl>Parent-child example</hl> 

cChildComponent Title="Panel Title from Parent" 

OnClick="@ShowMessage"> 

Content of the child component is supplied 
by the parent component. 

</ChildComponent> 

<pxb>@messageText</bx/p> 

@code { 

private string messageText; 

private void ShowMessage(MouseEventArgs e) 

{ 

messageText = $"Blaze a new trail with Blazor! ({e.ScreenX}, {e.ScreenY})"; 

} 

} 














childcomponent düğme seçildiğinde: 


• ParentComponent"ShowMessage yöntemi çağrılır. messageText güncellenir ve ParentComponent görüntülenir. 

• Geri çağırma yönteminde ( showMessage ) Statehaschanged çağrısı gerekli değildir. stateHasChanged , alt olaylar, 
alt öğe içinde yürütülen olay işleyicilerinde bileşen rerendering tetiklenmesi gibi ParentComponent yeniden 
çalıştırmak için otomatik olarak çağrılır. 



veriyor. 

<pxb>@messageText</bx/p> 

@{ var message = "Default Text"; } 
cChildComponent 

OnClick="@(async () => { await Task.Yield(); messageText = "Blaze It!"j })" /> 

@code { 

private string messageText; 

} 

invokeAsync ile bir Eventcaiiback veya Eventcaiiback<T> çağırın ve Taskawait: 

await callback.InvokeAsync(arg); 

Olay işleme ve bağlama bileşeni parametrelerini Eventcaiiback ve Eventcaiiback<T> kullanın. 

Eventcaiiback üzerinde türü kesin belirlenmiş Eventcaiiback<T> tercih edin. Eventcaiiback<T> .bileşenin 
kullanıcılarına daha iyi hata geri bildirimi sağlar. Diğer Ul olay işleyicileriyle benzer şekilde, olay parametresini 
belirtmek isteğe bağlıdır. Geri çağırmaya hiçbir değer geçirilmemişse Eventcaiiback kullanın. 

Varsayılan eylemleri engelle 

Bir olayın varsayılan eylemini engellemek için @on{EVENT}:preventDefault Directive özniteliğini kullanın. 

Giriş cihazında bir anahtar seçildiğinde ve öğe odağı bir metin kutusunda olduğunda, bir tarayıcı normalde metin 
kutusunda anahtarın karakterini görüntüler. Aşağıdaki örnekte, @onkeypress:preventDefault Directive özniteliği 
belirtilerek varsayılan davranış engellenir. Sayaç artar ve + anahtarı <input> öğenin değerine yakalanmaz: 

cinput value="@_count" @onkeypress="KeyHandler" (Şonkeypress:preventDefault /> 

@code { 

private int _count = 0; 

private void KeyHandler(KeyboardEventArgs e) 

{ 

if (e.Key == "+") 

{ 

_count++; 

} 

} 

} 

@on{EVENT}:preventDefault Özniteliğini bir değer olmadan belirtmek @on{EVENT}:preventDefault="true" 
eşdeğerdir. 

Özniteliğin değeri de bir ifade olabilir.Aşağıdaki örnekte _shouidPreventDefauit , true veya faise olarak 

























ayarlanan bir booi alandır: 


cinput @onkeypress:preventDefault="_shouldPreventDefault" /> 


Varsayılan eylemi engellemek için bir olay işleyicisi gerekli değildir.Olay işleyicisi ve varsayılan eylem 
senaryolarına bağımsız olarak bir şekilde kullanılabilir. 

Olay yaymayı durdur 

Olay yaymayı durdurmak için @on{EVENT}:stopPropagation Directive özniteliğini kullanın. 

Aşağıdaki örnekte, onay kutusunun seçilmesi ikinci alt <div> , üst <div> yaymadan sonraki olayları engeller: 

<label> 

cinput @bind="_stopPropagation" type="checkbox" /> 

Stop Propagation 
</label> 

cdiv @onclick="OnSelectParentDiv"> 

<hS>Parent div</h3> 

cdiv @onclick="OnSelectChildDiv"> 

Child div that doesn't stop propagation when selected. 
c/div> 

cdiv @onclick="OnSelectChildDiv" @onclick:stopPropagation="_stopPropagation"> 

Child div that stops propagation when selected. 
c/div> 
c/div> 

@code { 

private bool _stopPropagation = false; 

private void OnSelectParentDiv() => 

Console.WriteLine($"The parent div was selected. {DateTime.Now}"); 
private void OnSelectChildDiv() => 

Console.WriteLine($"A child div was selected. {DateTime.Now}"); 


Zincirleme bağlama 

Yaygın bir senaryo, bir veri bağlama parametresini bileşen çıkışında bir sayfa öğesine zincirlemesini sağlar. Birden 
çok bağlama düzeyi aynı anda gerçekleştiğinden, bu senaryoya zincirleme bağlama denir. 





Password özelliğindeki değişiklikleri, bir Eventcallbackile bir üst bileşene gösterir. 














Password: 

cinput @oninput="OnPasswordChanged" 
required 

type="@(showPassword ? "text" : "password")" 
value="@Password" /> 

<button class="btn btn-primary" @onclick="ToggleShowPassword"> 

Show password 
</button> 

@code { 

private bool showPassword; 

[Parameter] 

public string Password { get; set; } 

[Parameter] 

public EventCallback<string> PasswordChanged { get; set; } 

pnivate Task OnPasswordChanged(ChangeEventArgs e) 

{ 

Password = e.Value.ToString(); 

return PasswondChanged.InvokeAsync(Password); 

} 

pnivate void ToggleShowPasswond() 

{ 

showPasswond = !showPasswond; 

} 

} 

PasswondFieid bileşeni başka bir bileşende kullanılır: 

<PasswondField @bind-Passwond="passwond" /> 

@code { 

pnivate stning passwond; 

} 

Önceki örnekteki parolada denetim veya tuzak hataları gerçekleştirmek için: 

• Passwond için bir yedekleme alanı oluşturun (Aşağıdaki örnek kodda password ). 

• Passwond ayarlayıcısı 'nda denetimleri veya yakalama hatalarını gerçekleştirin. 


Aşağıdaki örnek, parolanın değerinde bir boşluk kullanılmışsa kullanıcıya anında geri bildirim sağlar: 




Password: 

cinput @oninput="OnPasswordChanged" 
required 

type="@(showPassword ? "text" : "password")" 
value="@Password" /> 

<button class="btn btn-primary" @onclick="ToggleShowPassword"> 
Show password 
</button> 

<span class="text-danger">@validationMessage</span> 

@code { 

private bool showPassword; 
private string password; 
private string validationMessage; 

[Parameter] 

public string Password 

{ 

get { return password ?? string.Empty; } 
set 
{ 

if (password != value) 

{ 

if (value.Contains(' ')) 

{ 

validationMessage = "Spaces not allowed!"; 

} 

else 

{ 

password = value; 
validationMessage = string.Empty; 

} 

} 

} 

} 

[Parameter] 

public EventCallback<string> PasswordChanged { get; set; } 

private Task OnPasswordChanged(ChangeEventArgs e) 

{ 

Password = e.Value.ToStringO; 

return PasswordChanged.InvokeAsync(Password); 

} 

private void ToggleShowPassword() 

{ 

showPassword = !showPassword; 

} 

} 


Bileşenlere başvuruları yakala 

Bileşen başvuruları, bir bileşen örneğine başvurmak için bir yol sağlar, böylece bu örneğe show veya Reset gibi 
komutlar verebilirsiniz. Bir bileşen başvurusunu yakalamak için: 

• Alt bileşene bir @ref özniteliği ekleyin. 

• Alt bileşenle aynı türde bir alan tanımlayın. 






<MyLoginDialog @ref="loginDialog" ... /> 

@code { 

private MyLoginDialog loginDialog; 

private void OnSomething() 

{ 

loginDialog.Show(); 

} 

} 

Bileşen işlendiğinde loginDialog alanı MyLoginDialog alt bileşen örneğiyle doldurulur. Daha sonra bileşen 
örneğinde .NET yöntemlerini çağırabilirsiniz. 


IMPORTANT 

loginDialog değişkeni yalnızca bileşen işlendikten sonra ve çıktısı MyLoginDialog öğesini içerdiğinde doldurulur. Bu 
noktaya kadar başvurulmasına hiçbir şey yok. Bileşen işlemesini tamamladıktan sonra bileşen başvurularını işlemek için 
Onafterrenderasync veya OnAfterRender yöntemlerinikullanın. 


Bileşen başvurularını yakalama, öğe başvurularını yakalamakiçin benzer bir sözdizimi kullanın, bir JavaScript 
birlikte çalışma özelliği değildir. Bileşen başvuruları yalnızca .NET kodunda kullanıldıkları—JavaScript koduna 
aktarılmaz. 


NOTE 

Alt bileşenlerin durumunu bulunmamalıdır için bileşen başvurularını kullanmayın. Bunun yerine, alt bileşenlere veri 
geçirmek için normal bildirime dayalı parametreleri kullanın. Normal bildirime dayalı parametrelerin kullanımı, otomatik 
olarak doğru zamanların yeniden yönlendirmesi için alt bileşenlerde oluşur. 


Durumu güncelleştirmek için bileşen yöntemlerini dışarıdan çağır 

Blazor, yürütmenin tek bir mantıksal iş parçacığını zorlamak için bir synchronizationContext kullanır. Bir bileşenin 
yaşam döngüsü yöntemleri ve Blazor tarafından oluşturulan tüm olay geri çağırmaları bu 
synchronizationContext yürütülür. Bir bileşenin Zamanlayıcı veya diğer bildirimler gibi dış bir olaya göre 
güncellenmesi gerekir, Blazor synchronizationContext dağıtım yapılacak invokeAsync yöntemini kullanın. 

Örneğin, güncelleştirilmiş durumdaki herhangi bir dinleme bileşenine bildirimde bulunan bir bildirim hizmeti 
düşünün: 

public class NotifierService 

{ 

// Can be called from anywhere 

public async Task Update(stning key, int value) 

{ 

if (Notify != null) 

{ 

await Notify.Invoke(key, value); 

} 

} 

public event Funccstring, int, Task> Notify; 

} 


Bir bileşeni güncelleştirmek için NotifierService kullanımı: 















@page "/" 

(Şinject NotifierService Notifier 
@implements IDisposable 

<p>Last update: (SlastNotification. key = @lastNotification.value</p> 

@code { 

pnivate (string key, int value) lastNotification; 

protected override void OnInitialized() 

{ 

Notifier.Notify += OnNotify; 

} 

public async Task OnNotify(string key, int value) 

{ 

await InvokeAsync(() => 

{ 

lastNotification = (key, value); 

StateHasChanged(); 

}); 

} 

public void Dispose() 

{ 

Notifier.Notify -= OnNotify; 

} 

} 

Yukarıdaki örnekte NotifierService bileşenin OnNotify yöntemini Blazor synchronizationContext dışında çağırır. 
invokeAsync , doğru bağlama geçmek ve bir işlemeyi kuyruğa almak için kullanılır. 

Öğelerin ve bileşenlerin korunmasını denetlemek için (©anahtarını 
kullanın 

Bir öğe veya bileşen listesi işlendiğinde ve öğeler ya da bileşenler daha sonra değiştiğinde, Blazoryayılma 
algoritması, önceki öğelerin veya bileşenlerin ne zaman tutulacağına ve model nesnelerinin bunlara nasıl 
eşleneceğine karar vermelidir. Normalde, bu işlem otomatiktir ve yoksayılabilir, ancak işlemi denetlemek 
isteyebileceğiniz durumlar vardır. 

Aşağıdaki örnek göz önünde bulundurun: 

@foreach (var person in People) 

{ 

<DetailsEditor Details="person.Details" /> 

} 

@code { 

[Parameter] 

public IEnumerable<Person> People { get; set; } 

} 

People koleksiyonun içerikleri, ekli, silinmiş veya yeniden sıralanmış girdilerle değişebilir. Bileşen yeniden 
oluşturulduğunda <DetaiisEditor> bileşeni farklı Details parametre değerleri almak için değişebilir. Bu, 
beklenenden daha karmaşık rerendering oluşmasına neden olabilir. Bazı durumlarda rerendering, kayıp öğe 
odağı gibi görünür davranış farklılıklarına yol açabilir. 

Eşleme işlemi @key Directive özniteliğiyle denetlenebilir. @key , anahtar değerine göre öğelerin veya bileşenlerin 
korunmasını güvence altına almak için dağıtılmış algoritmaya neden olur: 












(Sforeach (var person in People) 

{ 

<DetailsEditor @key="person" Details="person.Details" /> 

} 

@code { 

[Parameter] 

public IEnumerable<Person> People { get; set; } 

} 

People koleksiyonu değiştiğinde, yayılma algoritması <DetaiisEditor> örnekleri ve person örnekleri arasındaki 
ilişkilendirmeyi korur: 

• Bir Person People listesinden silinirse, yalnızca ilgili <DetaiisEditor> örneği kullanıcı arabiriminden kaldırılır. 
Diğer örnekler değişmeden bırakılır. 

• Listedeki bir konuma Person eklenirse, ilgili konuma bir yeni <DetaiisEditor> örneği eklenir. Diğer örnekler 
değişmeden bırakılır. 

• Person girdileri yeniden sıralandıysanız, karşılık gelen <DetaiisEditor> örnekleri korunur ve Kullanıcı 
arabiriminde yeniden sıralanır. 

Bazı senaryolarda @key kullanımı, rerendering karmaşıklığını en aza indirir ve odak konumu gibi DOM 'ın 
durum bilgisi olan kısımlarıyla ilgili olası sorunları önler. 


IMPORTANT 

Anahtarlar her kapsayıcı öğesi veya bileşeni için yereldir. Anahtarlar belge genelinde küresel olarak karşılaştırılmaz. 


@anahtarı ne zaman kullanılır? 

Genellikle, bir liste işlendiğinde (örneğin, bir @foreach bloğunda) ve @key tanımlamak için uygun bir değer 
olduğunda @key kullanmak mantıklı olur. 

Ayrıca, bir nesne değiştiğinde Blazor bir öğeyi veya bileşen alt ağacını @key engellemek için de kullanabilirsiniz: 

<div @key="currentPerson"> 

... content that depends on currentPerson ... 

</div> 

@currentPerson değişirse @key Attribute yönergesi Blazor <div> ve alt öğelerini atmayı ve yeni öğeler ve 
bileşenlerle Kullanıcı arabiriminde alt ağacı yeniden oluşturmayı zorlar. @currentPerson değiştiğinde hiçbir 
Kullanıcı arabirimi durumunun korunmayacağım garanti etmeniz gerekirse bu yararlı olabilir. 

@anahtar ne zaman kullanılmaz 

@key bir performans maliyeti vardır. Performans maliyeti büyük değildir, ancak öğe veya bileşen koruma 
kurallarının uygulamanın avantajına göre denetlenmesi durumunda yalnızca @key belirtin. 

@key kullanılmasa bile, Blazor alt öğe ve bileşen örneklerini mümkün olduğunca korur. @key kullanmanın 
avantajı, model örneklerinin eşlemeyi seçme algoritması yerine, korunan bileşen örneklerine nasıl eşlendiğine 
ilişkin denetimdir. 

@anahtarı için kullanılacak değerler 

Genellikle, @key için aşağıdaki değer türlerinden birini sağlamak mantıklı olur: 

• Model nesne örnekleri (örneğin, önceki örnekte olduğu gibi Person örneği). Bu, nesne başvurusu eşitliğine 
göre koruma sağlar. 


























• Benzersiz tanımlayıcılar (örneğin, int , string veya Guid için birincil anahtar değerleri). 

@key için kullanılan değerlerin çakışmayın olduğundan emin olun. Aynı üst öğe içinde çakışan değerler 
algılanırsa, eski öğeleri veya bileşenleri yeni öğe veya bileşenlere kesin bir şekilde eşlemediğinden Blazor bir özel 
durum oluşturur. Yalnızca nesne örnekleri veya birincil anahtar değerleri gibi farklı değerleri kullanın. 

Yönlendirme 

Blazor yönlendirme, uygulamadaki her erişilebilir bileşene bir rota şablonu sağlayarak elde edilir. 

@page yönergesine sahip bir Razor dosyası derlendiğinde, oluşturulan sınıfa yol şablonunu belirten bir 
RouteAttribute verilir. Çalışma zamanında, yönlendirici bileşen sınıflarını bir RouteAttribute arar ve hangi 
bileşenin istenen URL ile eşleşen bir rota şablonuna sahip olduğunu işler. 

Birden çok yol şablonu, bir bileşene uygulanabilir.Aşağıdaki bileşen /BiazorRoute ve /DifferentBiazorRoute 
isteklerine yanıt verir. 

Pages/BlazorRoute. Razor: 

@page "/BiazorRoute" 

@page "/DifferentBiazorRoute" 

<hl>Blazor routing</hl> 


Rota parametreleri 

Bileşenler, @page yönergesinde belirtilen yol şablonundan yol parametreleri alabilir. Yönlendirici, karşılık gelen 
bileşen parametrelerini doldurmak için yol parametrelerini kullanır. 

Pages/RouteParameter. Razor: 

@page "/RouteParameter" 

@page "/RouteParameter/{text}" 

<hl>Blazor is @Text!</hl> 

@code { 

[Parameter] 

public string Text { get; set; } 

protected override void OnInitialized() 

{ 

Text = Text ?? "fantastic"; 

} 

} 

isteğe bağlı parametreler desteklenmez, bu nedenle yukarıdaki örnekte iki @page yönergesi uygulanır, ilki, bir 
parametre olmadan bileşene gezinmesine izin verir, ikinci @page yönergesi {text} Route parametresini alır ve 
değeri Text özelliğine atar. 

Catch-all parametre sözdizimi (*/**), birden çok klasör sınırları genelinde yolu yakalayan Razor bileşenlerinde 
(. Razor ) desteklenmez. 

Kısmi sınıf desteği 

Razor bileşenleri kısmi sınıflar olarak oluşturulur. Razor bileşenleri aşağıdaki yaklaşımlardan birini kullanarak 
yazılır: 














• C#kod, tek bir dosyada HTML işaretlemesi ve Razor kodu ile bir @code bloğunda tanımlanmıştır. Blazor 
şablonlar, bu yaklaşımı kullanarak Razor bileşenlerini tanımlar. 

• C#kod, kısmi sınıf olarak tanımlanan bir arka plan kod dosyasına yerleştirilir. 

Aşağıdaki örnek, bir Blazor şablonundan oluşturulan bir uygulamada @code bloğu olan varsayılan counter 
bileşenini gösterir. HTML işaretleme, Razor kodu ve C# kod aynı dosyada: 

Counter. Razor: 


@page "/counter" 

<hl>Counter</hl> 

<p>Current count: @currentCount</p> 

<button class="btn btn-primary" @onclick="IncrementCount">Click me</button> 

@code { 

int currentCount = 0; 

void IncrementCount() 

{ 

currentCount++; 

} 

} 

Counter bileşeni, kısmi bir sınıf içeren bir arka plan kod dosyası kullanılarak da oluşturulabilir: 
Counter. Razor: 


@page "/counter" 

<hl>Counter</hl> 

<p>Current count: @currentCount</p> 

<button class="btn btn-primary" @onclick="IncrementCount">Click me</button> 

Counter.Razor.es: 


namespace BlazorApp.Pages 

{ 

public partial elass Counter 

{ 

int currentCount = 0; 

void IncrementCount() 

{ 

currentCount++; 

} 

} 

} 


Bir bileşen taban sınıfı belirtin 

@inherits yönergesi, bir bileşen için temel sınıf belirtmek üzere kullanılabilir. 

Örnek uygulama , bileşenin özelliklerini ve yöntemlerini sağlamak için bir bileşenin BiazorRocksBase temel sınıfı 
nasıl devralmasını gösterir. 








Pages/BlazorRocks. Razor. 


@page "/BlazorRocks" 

(Şinherits BlazorRocksBase 

<hl>@BlazorRocksText</hl> 

BlazorRocksBase.es : 

using Microsoft.AspNetCore.Components; 

namespace BlazorSample 
{ 

public elass BlazorRocksBase : ComponentBase 
{ 

public string BlazorRocksText { get; set; } = 

"Blazor roeks the browserl"; 

} 

} 

Temel sınıf ComponentBase türetmelidir. 

Bileşenleri içeri aktar 

Razor ile yazılan bir bileşenin ad alanı temel alınarak belirlenir (öncelik sırasına göre): 

• Razor dosyası (. Razor) biçimlendirmesinde @namespace ataması ( @namespace BlazorSample.MyNamespace ). 

• Projenin proje dosyasında RootNamespace ( <RootNamespace>BlazorSample</RootNamespace> ). 

• Proje dosyasının dosya adından (. esproj) ve proje kökünden bileşen yolundan alınan proje adı. Örneğin 
Framevvork, {Project root}/Pages/lrıdex.Razor ( BlazorSample. esproj) ad alanına BlazorSample.Pages 
çözümleniyor. Bileşenler ad C# bağlama kurallarını izler. Bu örnekteki index bileşeni için, kapsamdaki 
bileşenler tüm bileşenlerdir: 

o Aynı klasörde, sayfalarda. 

o Proje kökündeki, açıkça farklı bir ad alanı belirtmeyen bileşenler. 

Farklı bir ad alanında tanımlanan bileşenler, Razor 'nin @using yönergesi kullanılarak kapsam içine getirilir. 

BlazorSample/Shared/ klasöründe NavMenu.razor başka bir bileşen varsa, bileşen aşağıdaki @using ifadesiyle 
index.razor kullanılabilir: 

@using BlazorSample.Shared 
This is the Index page. 

<NavMenu></NavMenu> 

Bileşenlere Ayrıca, @using yönergesini gerektirmeyen tam nitelikli adları kullanılarak başvurulabilir: 

This is the Index page. 

< BlazorSample. Shared. NavMenux/BlazorSample. Shared. NavMenu > 














NOTE 

global :: niteleme desteklenmiyor. 

Diğer ad using deyimleriyle bileşenleri içeri aktarma (örneğin, @using Foo = Bar ) desteklenmez. 

Kısmen nitelenmiş adlar desteklenmez. Örneğin, @using BlazorSample eklemek ve NavMenu.razor başvurmak 
cShared. NavMenux/Shared. NavMenu> desteklenmez. 


Koşullu HTML öğesi öznitelikleri 

HTML öğesi öznitelikleri, .NET değerine göre koşullu olarak işlenir.Değer faise veya nuiı ise, öznitelik 
işlenmez. Değer true ise, öznitelik küçültülmüş olarak işlenir. 

Aşağıdaki örnekte, checked öğenin biçimlendirmesinde işlenip işlenmeyeceğini isCompleted belirler: 

<input type="checkbox" checked="@IsCompleted" /> 

@code { 

[Parameter] 

public bool IsCompleted { get; set; } 

} 

IsCompleted true , onay kutusu şu şekilde işlenir: 

cinput type="checkbox" checked /> 

IsCompleted faise , onay kutusu şu şekilde işlenir: 

cinput type="checkbox" /> 

Daha fazla bilgi için bkz. ASP.NET Core Razor söz dizimi başvurusu. 


VVARNING 

.NET türü bool olduğunda, Aria-basılangıbı bazı HTML öznitelikleri düzgün şekilde çalışmaz. Bu durumlarda, bool yerine 
string türü kullanın. 


Ham HTML 


Dizeler normalde DOM metin düğümleri kullanılarak işlenir. Bu, içerdikleri tüm biçimlendirmenin yok sayıldığı ve 
değişmez değer olarak kabul edildiği anlamına gelir. Ham HTML işlemek için, HTML içeriğini bir Markupstring 
değerde sarın. Değer HTML veya SVG olarak ayrıştırılır ve DOM 'a eklenir. 


VVARNING 

Güvenilmeyen bir kaynaktan oluşturulan ham HTML işleme bir güvenlik riskidir ve kaçınılması gerekir! 


Aşağıdaki örnek, bir bileşenin işlenmiş çıktısına statik HTML içeriği bloğunu eklemek için Markupstring türünü 
kullanmayı gösterir: 















@((MarkupString)myMarkup) 


@code { 

private string myMarkup = 

"<p class='markup'>This is a <em>markup string</em>.</p>"; 

} 


Şablonlu bileşenler 

Şablonlu bileşenler, bir veya daha fazla Ul şablonunu parametre olarak kabul eden bileşenlerdir, daha sonra 
bileşen işleme mantığının bir parçası olarak kullanılabilir. Şablonlu bileşenler, normal bileşenlerden daha yeniden 
kullanılabilir olan üst düzey bileşenleri yazmanıza izin verir. Birkaç örnek şunlardır: 

• Kullanıcının tablo üst bilgisi, satırları ve altbilgisi için şablon belirtmesini sağlayan tablo bileşeni. 

• Bir kullanıcının bir listedeki öğeleri işlemek için şablon belirlemesine izin veren bir liste bileşenidir. 

Şablon parametreleri 

Şablonlu bir bileşen, RenderFragment veya RenderFragment<T> türünde bir veya daha fazla bileşen parametresi 
belirtilerek tanımlanır. Bir işleme parçası, işlenecek Kullanıcı arabiriminin bir kesimini temsil eder. 

RenderFragment <t> , işleme parçası çağrıldığında belirtilebildiği bir tür parametresi alır. 

TableTemplate bileşeni: 

@typeparam Tltem 

<table class="table"> 

<thead> 

<tr>@TableHeader</tr> 

</thead> 

<tbody> 

(Şforeach (var item in Items) 

{ 

<tr>@RowTemplate(item)</tr> 

} 

</tbody> 

<tfoot> 

<tr>@TableFooter</tr> 

</tfoot> 

</table> 

@code { 

[Parameter] 

public RenderFragment TableHeader { get; set; } 

[Parameter] 

public RenderFragment<TItem> RowTemplate { get; set; } 

[Parameter] 

public RenderFragment TableFooter { get; set; } 

[Parameter] 

public IReadOnlyl_ist<TItem> Items { get; set; } 

} 

Şablonlu bir bileşen kullanırken, şablon parametreleri parametre adlarıyla eşleşen alt öğeler ( TableHeader ve 
aşağıdaki örnekte RowTempiate ) kullanılarak belirtilebilir: 







cTableTemplate Items="pets"> 
<TableHeader> 

<th>ID</th> 

<th>Name</th> 

</TableHeader> 

<RowTemplate> 

<td>@context.Petld</td> 
<td>@context.Name</td> 
</RowTemplate> 
</TableTemplate> 


Şablon bağlam parametreleri 

Öğe olarak geçirilen RenderFragmentcT» bileşen bağımsız değişkenleri context adında örtük bir parametreye 
sahiptir (örneğin, yukarıdaki kod örneğinden, @context.Petid ), ancak parametre adını alt öğe üzerindeki context 
özniteliğini kullanarak değiştirebilirsiniz. Aşağıdaki örnekte, RowTempiate öğenin context özniteliği pet 
parametresini belirtir: 

<TableTemplate Items="pets"> 

<TableHeaden> 

<th>ID</th> 

<th>Name</th> 

</TableHeader> 

<RowTemplate Context="pet"> 

<td>@pet.Petld</td> 

<td>@pet.Name</td> 

</RowTemplate> 

</TableTemplate> 

Alternatif olarak, bileşen öğesinde context özniteliğini de belirtebilirsiniz. Belirtilen context özniteliği belirtilen 
tüm şablon parametreleri için geçerlidir. Bu, örtük alt içerik (herhangi bir sarmalama alt öğesi olmadan) için içerik 
parametre adını belirtmek istediğinizde yararlı olabilir. Aşağıdaki örnekte, context özniteliği TableTemplate 
öğesinde görünür ve tüm şablon parametreleri için geçerlidir: 

cTableTemplate Items="pets" Context="pet"> 

<TableHeaden> 

<th>ID</th> 

<th>Name</th> 

</TableHeader> 

<RowTemplate> 

<td>@pet.Petld</td> 

<td>@pet.Name</td> 

</RowTemplate> 

</TableTemplate» 


Genel olarak yazılmış bileşenler 

Şablonlu bileşenler çoğunlukla genel olarak türdedir.Örneğin, bir genel ListviewTempiate bileşeni 
iEnumerabie<T> değerlerini işlemek için kullanılabilir. Genel bir bileşen tanımlamak için @typeparam yönergesini 
kullanarak tür parametrelerini belirtin: 

















@typeparam Tltem 
<ul> 

@foreach (var item in Items) 

{ 

@ItemTemplate(item) 

} 

</ul> 

@code { 

[Parameter] 

public RenderFragment<TItem> ItemTemplate { get; set; } 
[Parameter] 

public IReadOnlyList<TItem> Items { get; set; } 


Genel türsüz bileşenleri kullanırken tür parametresi mümkünse algılanır: 

<ListViewTemplate Items="pets"> 
dtemTemplate Context="pet"> 

<li>@pet.Name</li> 

</ItemTemplate> 

</ListViewTemplate> 


Aksi halde tür parametresi, tür parametresinin adıyla eşleşen bir öznitelik kullanılarak açıkça belirtilmelidir. 
Aşağıdaki örnekte, Titem="Pet" türü belirtir: 

<ListViewTemplate Items="pets" TItem="Pet"> 

<ItemTemplate Context="pet"> 

<li>@pet.Name</li> 

</ItemTemplate> 

</ListViewTemplate> 


Değerleri ve parametreleri basamaklama 

Bazı senaryolarda, özellikle birden çok bileşen katmanı olduğunda, bileşen parametrelerikullanarak bir üst 
bileşenden bir alt bileşene veri akışı yapmak uygun değildir. Değerleri ve parametreleri basamaklama, bir üst 
bileşenin tüm alt bileşenlerine değer sağlaması için kullanışlı bir yol sağlayarak bu sorunu çözebilir. Basamaklı 
değerler ve parametreler, bileşenlerin koordinasyonu için bir yaklaşım sağlar. 

Tema örneği 

Örnek uygulamadan aşağıdaki örnekte, Themeinfo sınıfı, uygulamanın belirli bir bölümündeki tüm düğmelerin 
aynı stili paylaştığı şekilde bileşen hiyerarşisinin akışını yapmak için tema bilgilerini belirtir. 

Uıthemeclasses/Thememfo. cs: 

public class Themeinfo 
{ 

public string ButtonClass { get; set; } 

} 

Bir üst bileşen basamaklı değer bileşeni kullanılarak basamaklı bir değer sağlayabilir. Cascadingvalue bileşeni, 
bileşen hiyerarşisinin bir alt ağacını sarmalanmış ve bu alt ağaçta bulunan tüm bileşenlere tek bir değer sağlar. 

Örneğin, örnek uygulama, @Body özelliğinin düzen gövdesini oluşturan tüm bileşenler için bir geçişli parametre 
olarak uygulamanın düzenlerindeki tema bilgilerini ( Themeinfo ) belirtir. ButtonClass , düzen bileşeninde 












btn-success bir değeri atanır. Tüm alt bileşenler, Themeinfo basamaklı nesne aracılığıyla bu özelliği kullanabilir. 


CascadingValuesParametersLayout bileşeni: 

(Şinherits LayoutComponentBase 
(Şusing BlazorSample.UIThemeClasses 

<div class="container-fluid"> 

<div class="row"> 

<div class="col-sm-3"> 

<l\lavMenu /> 

</div> 

<div class="col-sm-9"> 

<CascadingValue Value="theme"> 

<div class="content px-4"> 

@Body 

</div> 

</CascadingValue> 

</div> 

</div> 

</div> 

@code { 

private Themeinfo theme = new Themeinfo { ButtonClass = "btn-success" }; 

} 

Basamaklı değerleri kullanmak için, bileşenler [CascadingPanameten] özniteliği kullanarak Geçişli Parametreler 
bildirir. Basamaklı değerler, türe göre basamaklı parametrelere bağlanır. 

Örnek uygulamada cascadingvaiuesPanametensTheme bileşeni, Themeinfo geçişli değeri basamaklı bir parametreye 
bağlar. Parametresi, bileşen tarafından görünen düğmelerden birine ait CSS sınıfını ayarlamak için kullanılır. 

CascadingValuesParametersTheme bileşeni: 








@page "/cascadingvaluesparameterstheme" 

(Şlayout CascadingValuesParametersLayout 
@using BlazorSample.UIThemeClasses 

<hl>Cascading Values & Parameters</hl> 

<p>Current count: @currentCount</p> 

<P> 

<button class="btn" @onclick="IncrementCount"> 

Increment Counter (Unthemed) 

</button> 

</p> 

<P> 

<button class="btn @ThemeInfo.ButtonClass" @onclick="IncrementCount"> 

Increment Counter (Themed) 

</button> 

</p> 

@code { 

private int currentCount = 0; 

[CascadingParameter] 

protected Themelnfo Themelnfo { get; set; } 

private void IncrementCount() 

{ 

currentCount++; 

} 

} 

Aynı alt ağaç içindeki aynı türdeki birden çok değeri basamakla, her bir Cascadingvalue bileşenine ve karşılık 
gelen CascadingParameter benzersiz bir Name dizesi sağlayın. Aşağıdaki örnekte, iki Cascadingvalue bileşeni, 
MyCascadingType farklı örneklerini ada göre basamakla: 

cCascadingValue Value=@ParentCascadeParameterl Name="CascadeParaml"> 

cCascadingValue Value=@ParentCascadeParameter2 Name="CascadeParam2"> 

</Cascadingvalue» 

</Cascadingvalue» 

@code { 

private MyCascadingType ParentCascadeParameterl; 

[Parameter] 

public MyCascadingType ParentCascadeParameter2 { get; set; } 


} 


Alt bileşende, basamaklı parametreler değerlerini, üst bileşendeki ilgili basamaklı değerleri ada göre alır: 


@code { 

[CascadingParameter(Name = "CascadeParaml")] 

protected MyCascadingType ChildCascadeParameterl { get; set; } 

[CascadingParameter(Name = "CascadeParam2")] 

protected MyCascadingType ChildCascadeParameter2 { get; set; } 








TabSet örneği 

Basamaklı parametreler, bileşenlerin bileşen hiyerarşisinde işbirliği yapmasına de olanak tanır.Örneğin, örnek 
uygulamada aşağıdaki Tabset örneğini göz önünde bulundurun. 

Örnek uygulama, sekmelerin uygulandığı bir uab arabirimine sahiptir: 

using Microsoft.AspNetCore.Components; 

namespace BlazorSample.UIInterfaces 

{ 

public interface ITab 

{ 

RenderFragment ChildContent { get; } 

} 

} 

cascadingvaluesParametersTabSet bileşeni, çeşitli Tab bileşenleri içeren Tabset bileşenini kullanır: 

<TabSet> 

<Tab Title="First tab"> 

<h4>Greetings from the first tab!</h4> 

<label> 

<input type="checkbox" @bind="showThirdTab" /> 

Toggle third tab 
</label> 

</Tab> 

<Tab Title="Second tab"> 

<h4>The second tab says Hello World!</h4> 

</Tab> 

Şif (showThirdTab) 

{ 

<Tab Title="Third tab"> 

<h4>Welcome to the disappearing third tab!</h4> 

<p>Toggle this tab from the first tab.</p> 

</Tab> 

} 

</TabSet> 

Alt Tab bileşenleri, Tabset açıkça parametre olarak geçirilmemektedir. Bunun yerine, alt Tab bileşenleri Tabset 
alt içeriğinin bir parçasıdır. Ancak, Tabset üst bilgileri ve etkin sekmeyi işleyebilmesi için, her bir Tab bileşeni 
hakkında yine de bilmesi gerekir. Ek kod gerektirmeden bu koordinasyonu etkinleştirmek için, Tabset bileşen 
kendisini, alt Tab bileşenleri tarafından çekilen basamakU bir değer olarak sağlayabilir. 


Tabset bileşeni: 














@using BlazorSample.UIInterfaces 

<!-- Display the tab headers --> 

<CascadingValue Value=this> 

<ul class="nav nav-tabs"> 

(ŞChildContent 

</ul> 

</CascadingValue> 

<!-- Display body for only the active tab --> 

<div class="nav-tabs-body p-4"> 

@ActiveTab?.ChildContent 
</div> 

@code { 

[Panameten] 

public RenderFragment ChildContent { get; set; } 

public ITab ActiveTab { get; private set; } 

public void AddTab(ITab tab) 

{ 

if (ActiveTab == null) 

{ 

SetActivateTab(tab); 

} 

} 

public void RemoveTab(ITab tab) 

{ 

if (ActiveTab == tab) 

{ 

SetActivateTab(null); 

} 

} 

public void SetActivateTab(ITab tab) 

{ 

if (ActiveTab != tab) 

{ 

ActiveTab = tab; 

StateHasChanged(); 

} 

} 

} 


Tab 

bileşenleri, kapsayan 

TabSet 

kendisini basamaklı bir parametre olarak yakalar, bu nedenle 

Tab 


bileşenleri kendilerini TabSet ve bu sekmenin etkin olduğu koordine eder. 


Tab bileşeni: 







@using BlazorSample.UIInterfaces 
(Şimplements ITab 

<li> 

<a @onclick="Activate" class="nav-link (ŞTitleCssClass" role="button"> 

@Title 

</a> 

</li> 

@code { 

[CascadingParameter] 

public TabSet ContainerTabSet { get; set; } 

[Parameter] 

public string Title { get; set; } 

[Parameter] 

public RenderFragment ChildContent { get; set; } 

private string TitleCssClass => ContainerTabSet.ActiveTab == this ? "active" : null; 

protected override void OnInitialized() 

{ 

ContainerTabSet.AddTab(this); 

} 

private void Activate() 

{ 

ContainerTabSet.SetActivateTab(this); 

} 


Razor şablonları 


Oluşturma parçalan Razor şablonu sözdizimi kullanılarak tanımlanabilir.Razor şablonları, bir Ul parçacığı 
tanımlamak ve aşağıdaki biçimi varsaymak için bir yoldur: 



bir bileşende nasıl işleneceğini gösterir. Oluşturma parçaları, şablonlu bileşenlerebağımsız değişken olarak da 
geçirilebilir. 

@timeTemplate 

@petTemplate(new Pet { Name = "Rex" }) 

@code { 

private RenderFragment timeTemplate = @<p>The time is @DateTime.Now.</p>; 
private RenderFragment<Pet> petTemplate = 

(pet) => @<p>Your pet's name is @pet.Name.</p>; 

private class Pet 

{ 

public string Name { get; set; } 

} 

} 


Önceki kodun işlenmiş çıktısı: 







<p>The time is 10/04/2018 01:26:52.</p> 
<p>Your pet's name is Rex.</p> 


El ile RenderTreeBuilder mantığı 

Microsoft.AspNetcore.Components.Rendering.RenderTreeBuiider , bileşenleri ve öğeleri işlemek için yöntemler sağlar 
ve C# kodu kodda el ile oluşturma dahil. 


NOTE 

Bileşen oluşturmak için RenderTreeBuilder kullanımı gelişmiş bir senaryodur Hatalı biçimlendirilmiş bir bileşen (örneğin, 
kapatılmamış bir biçimlendirme etiketi) tanımsız davranışa neden olabilir. 


Başka bir bileşende el ile yerleşik olarak kullanılabilecek aşağıdaki PetDetails bileşenini göz önünde bulundurun: 

<h2>Pet Details Component</h2> 

<p>@PetDetailsQuote</p> 

@code 

{ 

[Parameter] 

public string PetDetailsQuote { get; set; } 

} 

Aşağıdaki örnekte, createcomponent yöntemindeki döngü üç PetDetails bileşeni oluşturur. Bileşenleri 
oluşturmak için RenderTreeBuilder Yöntemler çağrılırken ( Opencomponent ve AddAttribute ), dizi numaraları 
kaynak kodu satır numaralarıdır. Blazor farkı algoritması, ayrı çağrı etkinleştirmeleri değil, farklı kod satırlarına 
karşılık gelen sıra numaralarına dayanır. RenderTreeBuilder yöntemlerle bir bileşen oluştururken, dizi numaraları 
için bağımsız değişkenleri sabit olarak kodlayın. Sıra numarasını oluşturmak için bir hesaplama veya sayaç 
kullanmak kötü performansa neden olabilir. Daha fazla bilgi için bkz. kod satırı numaralarıyla İlgili sıra 
numaraları ve yürütme sırası çalışmıyor bölümü. 


Buiitcontent bileşeni: 













@page "/BuiltContent" 

<hl>Build a component</hl> 

(ŞCustomRender 

<button type="button" @onclick="RenderComponent"> 

Create three Pet Details components 
</button> 

@code { 

private RenderFragment CustomRender { get; set; } 

private RenderFragment CreateComponent() => builder => 

{ 

for (var i = 0; i < 3; i++) 

{ 

builder.OpenComponent(0, typeof(PetDetails)); 

builder.AddAttribute(l, "PetDetailsQuote", "Someone's best friend!"); 
builder.CloseComponent(); 

} 

}J 

private void RenderComponent() 

{ 

CustomRender = CreateComponent(); 

} 

} 

! WARNING Microsoft.AspNetcore.Components.RenderTree türler, işleme işlemlerinin sonuçlarının işlenmesine 
izin verir. Bunlar Blazor Framevvork uygulamasının iç ayrıntılardır. Bu türlerin dengesizleşilmesi ve gelecekteki 
sürümlerde değişikliğe tabi olması gerekir. 

Sıra numaraları, kod satırı numaralarıyla ilgilidir ve yürütme sırası değildir 

Blazor .razor dosyalar her zaman derlenir. Derleme adımı, çalışma zamanında uygulama performansını 
geliştiren bilgileri eklemek için kullanılabilir olduğundan, bu büyük olasılıkla .razor için harika bir avantajdır. 

Bu geliştirmelerin önemli bir örneği sıra numarasııçem. Sıra numaraları, hangi çıkışların ayrı ve sıralı kod 
satırlarından geldiğini çalışma zamanına işaret ediyor. Çalışma zamanı, doğrusal bir zamanda, genel ağaç farkı 
algoritması için genellikle mümkün olandan çok daha hızlı olan etkili ağaç SLA 'ları oluşturmak için bu bilgileri 
kullanır. 

Aşağıdaki Razor bileşeni (. Razor ) dosyasını göz önünde bulundurun: 

@if (someFlag) 

{ 

<text>First</text> 

} 

Second 


Yukarıdaki kod, aşağıdakine benzer şekilde derlenir: 

if (someFlag) 

{ 

builder.AddContent(0, "First"); 

} 

builder.AddContent(l, "Second"); 









Kod ilk kez yürütüldüğünde, someFiag true , Oluşturucu şunları alır: 


SEQUENCE 

TÜR 

VERİ 

0 

Metin düğümü 

Birinci 

1 . 

Metin düğümü 

Saniye 

someFiag false 

hale geldiğini ve biçimlendirmenin yeniden işleneceğini varsayın. Bu kez, Oluşturucu şunları alır: 

SEOUENCE 

TÜR 

VERİ 

1 . 

Metin düğümü 

Saniye 


Çalışma zamanı bir fark gerçekleştirdiğinde, sırasıyla 0 öğenin kaldırıldığını görür, bu nedenle aşağıdaki önemsiz 
düzenleme öef/ğın/oluşturur: 

• İlk metin düğümünü kaldırın. 

Program aracılığıyla sıra numaraları oluşturursanız ne yanlış gider 

Aşağıdaki işleme Ağacı Oluşturucusu mantığını yazmanız yerine düşünün: 

var seq = 0; 

if (someFiag) 

{ 

builder.AddContent(seq++, "First"); 

} 

builder.AddContent(seq++, "Second"); 

Şimdi ilk çıktı: 


SEQUENCE 

TÜR 

VERİ 

0 

Metin düğümü 

Birinci 

1. 

Metin düğümü 

Saniye 

Bu sonuç önceki bir durum ile aynıdır, 

çıktı: 

bu nedenle olumsuz bir sorun yoktur. 

someFiag 

SEOUENCE 

TÜR 

VERİ 

0 

Metin düğümü 

Saniye 


Bu kez, fark algoritması iki değişikliğin oluştuğunu görür ve algoritma aşağıdaki düzenleme betiğini üretir: 

• ilk metin düğümünün değerini second olarak değiştirin. 

• ikinci metin düğümünü kaldırın. 

Sıra numaralarının oluşturulması, özgün kodda if/eise dalların ve döngülerin bulunduğu yer hakkındaki tüm 
yararlı bilgileri kaybetti. Bu, daha önce olduğu gibi bir fark ile iki kez sonuçlanır. 

Bu, önemsiz bir örnektir. Karmaşık ve derin iç içe yapıları ve özellikle döngülerle daha gerçekçi durumlarda 
performans maliyeti daha önemlidir. Hangi döngü bloklarının veya dallarının eklendiğini veya kaldırıldığını 














hemen belirlemek yerine, fark algoritmasının işleme ağaçlarına katmaları ve genellikle eski ve yeni yapıların nasıl 
olduğu hakkında yanlış bir biçimde düzenleme betikleri oluşturması birbirleriyle ilişkilendir. 

Kılavuz ve ekibinizle 

• Sıra numaraları dinamik olarak oluşturulursa uygulama performansı de vardır. 


• Altyapı, derleme zamanında yakalanmadığı takdirde gerekli bilgiler bulunmadığından, çalışma zamanında 
kendi sıra numaralarını otomatik olarak oluşturamaz. 



Her bölge kendi ayrı dizi numaralarına sahiptir, bu nedenle her bölge içinde sıfırdan (veya herhangi bir 
rastgele sayıdan) yeniden başlatabilirsiniz. 

• Dizi numaraları sabit kodluysa, fark algoritması yalnızca değer değerinde sıra numaralarının artırılmasını 
gerektirir, ilk değer ve boşluklar ilgisiz. Tek bir seçenek, kod satırı numarasını sıra numarası olarak kullanmak 
veya sıfırdan başlayıp bir ya da yüzlerce (ya da tercih edilen aralığa) artırmak için kullanılır. 

• Blazor sıra numaralarını kullanır, diğer ağaç dağıtma Kullanıcı arabirimi çerçeveleri bunları kullanmaz. Dizi 
numaraları kullanıldığında, yayılma çok daha hızlıdır ve Blazor,. Razor dosyaları yazan geliştiriciler için 
otomatik olarak sıra numaralarıyla ilgilenen bir derleme adımının avantajına sahiptir. 

Yerelleştirme 

Blazor Server uygulamaları, Yerelleştirme ara yazılımıkullanılarak yerelleştirilmiştir. Ara yazılım, uygulamadan 
kaynak isteyen kullanıcılar için uygun kültürü seçer. 

Kültür aşağıdaki yaklaşımlardan biri kullanılarak ayarlanabilir: 

• Çerezler 

• Kültürü seçmek için Kullanıcı arabirimi sağlama 

Daha fazla bilgi ve örnek için bkz. ASP.NET Core Genelleştirme ve yerelleştirme. 

Bağlayıcıyı Uluslararası hale getirme için yapılandırma (Blazor VVebAssembly) 

Varsayılan olarak, Blazor VVebAssembly uygulamaları için Blazorbağlayıcı yapılandırması, açıkça istenen yerel 
ayarlar dışında uluslararası duruma getirme bilgilerini kaldırır. Bağlayıcının davranışını denetleme hakkında daha 
fazla bilgi ve yönergeler için bkz. AS P.N ET Core Blazor için bağlayıcı yapılandırma. 

Tanımlama bilgileri 

Yerelleştirme kültürü tanımlama bilgisi kullanıcının kültürünü kalıcı hale getirebilirler.Tanımlama bilgisi, 
uygulamanın ana bilgisayar sayfasının onGet yöntemiyle oluşturulur ( Pages/Host. cshtml. cs). Yerelleştirme ara 
yazılımı, sonraki isteklerde Kullanıcı kültürünü ayarlamak için tanımlama bilgilerini okur. 

Tanımlama bilgisinin kullanımı, VVebSocket bağlantısının kültürü doğru şekilde yaymasını sağlar. Yerelleştirme 
şemaları URL yolunu veya sorgu dizesini temel alıyorsa, düzen VVebSockets ile çalışmayabilir, bu nedenle kültürü 
kalıcı hale getiremeyebilir. Bu nedenle, yerelleştirme kültürü tanımlama bilgisinin kullanılması önerilen 
yaklaşımdır. 

Kültür bir yerelleştirme tanımlama bilgisinde kalıcı hale getirilir kültür atamak için herhangi bir teknik 
kullanılabilir. Uygulamanın zaten sunucu tarafı ASP.NET Core için bir yerelleştirme şeması varsa, uygulamanın 
var olan yerelleştirme altyapısını kullanmaya devam edin ve uygulamanın şeması içinde yerelleştirme kültür 
tanımlama bilgisini ayarlayın. 

Aşağıdaki örnekte, yerelleştirme ara yazılımı tarafından okunabilen bir tanımlama bilgisinde geçerli kültürün nasıl 
ayarlanacağı gösterilmektedir. Blazor Server uygulamasında aşağıdaki içeriklerle bir Pages/Host. cshtml. cs 
dosyası oluşturun: 








public class HostModel : PageModel 
{ 

public void OnGet() 

{ 

HttpContext.Response.Cookies.Append( 

CookieRequestCultureProvider.DefaultCookieName, 
CookieRequestCultureProvider.MakeCookieValue( 
new RequestCulture( 

Culturelnfo.CurrentCulture., 

Culturelnfo.CurrentUICulture))); 

} 

} 


Yerelleştirme uygulamada işlenir: 

1. Tarayıcı, uygulamaya bir ilk HTTP isteği gönderir. 

2. Kültür, yerelleştirme ara yazılımı tarafından atanır. 

3. _Host. cshtml. cs içindeki onGet yöntemi, yanıtın bir parçası olarak bir tanımlama bilgisinde kültürü devam 
ettirir. 

4. Tarayıcı, etkileşimli bir Blazor sunucusu oturumu oluşturmak için bir VVebSocket bağlantısı açar. 

5. Yerelleştirme ara yazılımı tanımlama bilgisini okur ve kültürü atar. 

6. Blazor Server oturumu doğru kültür ile başlar. 

Kültürü seçmek için Kullanıcı arabirimi sağlama 

Bir kullanıcının bir kültür seçmesine izin vermek için kullanıcı ARABİRİMİ sağlamak üzere bir yeniden 
yönlendirme tabanlı yaklaşım önerilir. Bu işlem, bir Kullanıcı bir oturum açma sayfasına yeniden yönlendirildiği 
ve ardından özgün kaynağa yeniden yönlendirildiği—bir Kullanıcı güvenli bir kaynağa erişmeyi denediğinde bir 
Web uygulamasında gerçekleşmelere benzer. 

Uygulama, bir denetleyiciye yeniden yönlendirme yoluyla kullanıcının seçili kültürünü devam ettirir. Denetleyici 
kullanıcının seçili kültürünü birtanımlama bilgisine ayarlar ve kullanıcıyı özgün URI 'ye yeniden yönlendirir. 

Bir tanımlama bilgisinde kullanıcının seçili kültürünü ayarlamak ve özgün URI 'ye yeniden yönlendirmeyi 
gerçekleştirmek için sunucuda bir HTTP uç noktası oluşturun: 

[Route("[controller]/[action]") ] 

public class CultureController : Controller 

{ 

public IActionResult SetCulture(string culture, string redirectUri) 

{ 

if (culture != null) 

{ 

HttpContext.Response.Cookies.Append( 

CookieRequestCultureProvider.DefaultCookieName , 

CookieRequestCultureProvider.MakeCookieValue( 
new RequestCulture(culture))); 

} 


return LocalRedirect(redirectUri); 

} 

} 










Aşağıdaki bileşen, Kullanıcı bir kültür seçtiğinde ilk yeniden yönlendirmenin nasıl gerçekleştirileceği hakkında bir 
örnek göstermektedir: 


(Şinject NavigationManager NavigationManager 

<h3>Select your language</h3> 

<select @onchange="OnSelected"> 

<option>Select...</option> 

<option value="en-US">English</option> 

<option value="fr-FR">Français</option> 

</select> 

@code { 

private double textNumber; 

private void OnSelected(ChangeEventArgs e) 

{ 

var culture = (string)e.Value; 

var uri = new Uri(NavigationManager.Uri()) 

.GetComponents(UriComponents.PathAndQueryj UriFormat.Unescaped); 
var query = $"?culture={Uri.EscapeDataString(culture)}&" + 

$"redirectUri={Uri.EscapeDataString(uri)}"; 

NavigationManager.NavigateTo("/Culture/SetCulture" + query, forceLoad: true); 

} 

} 


Blazor uygulamalarında .NET yerelleştirme senaryolarını kullanma 

Blazor uygulamalar içinde, aşağıdaki .N ET yerelleştirme ve genelleştirme senaryoları kullanılabilir: 

• . NET ' in kaynak sistemi 

• Kültüre özgü sayı ve Tarih biçimlendirmesi 

Blazor @bind işlevselliği, kullanıcının geçerli kültürüne göre Genelleştirme gerçekleştirir.Daha fazla bilgi için veri 
bağlama bölümüne bakın. 

Sınırlı birASP.NET Core yerelleştirme senaryosu kümesi şu anda desteklenmektedir: 


• 

IStringLocalizero 

Blazor uygulamalarda desteklenir. 

• 

IHtmlLocalizero 


IViewLocalizer<> 

ve veri ek açıklamaları yerelleştirme ASP.NET Core MVC 


senaryolarından ve Blazor uygulamalarında desteklenmez . 

Daha fazla bilgi için bkz. AS P.N ET Core Genelleştirme ve yerelleştirme. 


Ölçeklenebilir vektör grafik (SVG) görüntüleri 

Blazor HTML oluşturduğundan, ölçeklenebilir vektör grafik (SVG) görüntüleri (. SVG) dahil olmak üzere 
tarayıcıda desteklenen görüntüler <img> etiketi aracılığıyla desteklenir: 

<img alt="Example image" src="some-image.svg" /> 

Benzer şekilde, SVG görüntüleri bir stil sayfası dosyasının (. css) CSS kurallarında desteklenir: 

.my-element { 

background-image: url("some-image.svg"); 

} 







Ancak, satır içi SVG işaretlemesi tüm senaryolarda desteklenmez. Bir <svg> etiketini doğrudan bir bileşen 
dosyasına (. Razor) yerleştirirseniz, temel görüntü işleme desteklenir, ancak birçok gelişmiş senaryo 
desteklenmemiştir. Örneğin, <use> Etiketler Şu anda dikkate alınamaz ve @bind bazı SVG etiketleriyle 
kullanılamaz. Gelecekteki bir sürümde bu sınırlamaları ele almayı bekliyoruz. 

Ek kaynaklar 

• Güvenli ASP.NET Core Blazor Server uygulamaları kaynak tükenmesi ile Çekişmek zorunda olan Blazor 
sunucu uygulamaları oluşturmaya yönelik yönergeler İçerir. 





ASPNET Core Blazor yaşam döngüsü 
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Blazor Framevvork zaman uyumlu ve zaman uyumsuz yaşam döngüsü yöntemlerini içerir. Bileşen başlatma ve 
işleme sırasında bileşenlerde ek işlemler gerçekleştirmek için yaşam döngüsü yöntemlerini geçersiz kılın. 

Yaşam döngüsü yöntemleri 

Bileşen başlatma yöntemleri 

OnlnitializedAsync ve Onlnitialized bir bileşeni başlatan kodu yürütün. Bu yöntemlere yalnızca bileşen ilk örneği 
oluşturulduğunda bir kez çağırılır. 

Zaman uyumsuz bir işlem gerçekleştirmek için işlem üzerinde OnlnitializedAsync ve await anahtar sözcüğünü 
kullanın: 

pnotected ovenride async Task OnInitializedAsync() 

{ 

await ... 

} 



{ 

} 


Parametreler ayarlanmadan önce 

SetParametersAsync, işleme ağacındaki bileşenin üst öğesi tarafından sağlanan parametreleri ayarlar: 



olmayan parametreler değiştirilmeden bırakılır. 

base.setParametersAync çağrılmazsa, özel kod gelen parametreler değerini gerekli herhangi bir şekilde 


















yorumlayabilir. Örneğin, sınıftaki özelliklere gelen parametreleri atama gereksinimi yoktur. 

Parametreler ayarlandıktan sonra 

OnParametersSetAsync ve OnParametersSet bir bileşen üst öğeden parametreleri aldığında ve değerler 
özelliklerine atandığında çağrılır. Bu yöntemler bileşen başlatıldıktan sonra ve her yeni parametre değeri 
belirtildiğinde yürütülür: 

protected override async Task OnParametersSetAsync() 

{ 

await ... 

} 



{ 

} 

Bileşen oluşturulduktan sonra 

OnAfterRenderAsync ve OnAfterRender bir bileşen işlemeyi tamamladıktan sonra çağrılır. Öğe ve bileşen 
başvuruları bu noktada doldurulur. İşlenmiş DOM öğelerinde çalışan üçüncü taraf JavaScript kitaplıklarını 
etkinleştirme gibi, işlenmiş içeriği kullanarak ek başlatma adımları gerçekleştirmek için bu aşamayı kullanın. 



• Başlatma işinin yalnızca bir kez gerçekleştirildiğinden emin olmak için kullanılabilir. 


protected override async Task OnAfterRenderAsync(bool firstRender) 
{ 

if (firstRender) 

{ 

await ... 

} 

} 


NOTE 

OnAfterRenderAsync yaşam döngüsü olayında, işleme hemen sonra zaman uyumsuz çalışma gerçekleşmelidir. 

OnAfterRenderAsync bir Task döndürseniz bile, çerçeve bu görev tamamlandıktan sonra bileşen için başka bir işleme çevrimi 
zamanlayamaz. Bu, sonsuz bir işleme döngüsünden kaçınmaktır. Diğer yaşam döngüsü yöntemlerinden farklı olduğundan, 
döndürülen görev tamamlandığında daha fazla işleme döngüsü zamanlayabilirsiniz. 











Ul yenilemeyi bastır 

Ul yenilemeyi gizlemek için ShouldRender geçersiz kılın. Uygulama true döndürürse, Kullanıcı arabirimi 
yenilenir: 

protected override bool ShouldRender() 

{ 

var renderUI = true; 
return renderUI; 

} 

ShouldRender bileşen her işlendiğinde çağrılır. 

ShouldRender geçersiz kılınsa bile, bileşen her zaman ilk olarak işlenir. 

Durum değişiklikleri 

StateHasChanged bileşene durumunu değiştiğini bildirir. Uygun olduğunda, stateHasChanged çağırmak bileşenin 
yeniden yönlendirilmesine neden olur. 

İşleme sırasında tamamlanmamış zaman uyumsuz eylemleri işle 

Yaşam döngüsü olaylarında gerçekleştirilen zaman uyumsuz eylemler, bileşen işlenmeden önce tamamlanmamış 
olabilir. Yaşam döngüsü yöntemi yürütülürken nesneler nuiı veya verilerle tamamen doldurulmuş olabilir. 
Nesnelerin başlatıldığını onaylamak için işleme mantığı sağlayın. Nesneler nuiı yer tutucu Kullanıcı arabirimi 
öğelerini (örneğin, bir yükleme iletisi) işleme. 

Blazor şablonlarının FetchData bileşeninde, omnitiaiizedAsync tahmin verileri alma ( forecasts ) için geçersiz 
kılınır, forecasts nuiı olduğunda, kullanıcıya bir yükleme iletisi görüntülenir. omnitiaiizedAsync 
tamamlandığında döndürülen Task , bileşen güncelleştirilmiş durumla yeniden yapılır. 

Blazor Server şablonundaki Pages/FetchData. Razor : 
















@page "/fetchdata" 

@using MyBlazorApp.Data 

Şinject WeatherForecastService ForecastService 
<hl>Weather forecast</hl> 

<p>This component demonstrates fetching data from a service.</p> 

Şif (forecasts == null) 

{ 

<pxem>Loading. . .</emx/p> 

} 

else 

{ 

ctable class="table"> 

<!-- forecast data in table element content --> 

</table> 

} 

@code { 

private WeatherForecast[] forecasts; 

protected override async Task OnInitializedAsync() 

{ 

forecasts = await ForecastService.GetForecastAsync(DateTime.Now); 

} 

} 


IDisposable ile bileşen atma 

Bir bileşen IDİsposableuygularsa, bileşen kullanıcı arabiriminden kaldırıldığında Dispose yöntemi çağırılır. 
Aşağıdaki bileşen @impiements IDisposable ve Dispose yöntemini kullanır: 

@using System 
Şimplements IDisposable 


@code { 

public void Dispose() 

{ 

} 

} 


NOTE 

Dispose StateHasChanged çağrısı desteklenmiyor. stateHaschanged oluşturucunun bir parçası olarak çağrılabilir, bu 
nedenle bu noktada Ul güncelleştirmelerinin kullanılması desteklenmez. 


Hataları işleme 

Yaşam döngüsü yöntemi yürütme sırasında hataları işleme hakkında bilgi için bkz. ASP.NET Core Blazor 
uygulamalarda hataları işleme. 
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Forms ve doğrulama, veri ek açıklamalarıkullanılarak Blazor desteklenir. 

Aşağıdaki ExampieModei türü, veri ek açıklamalarını kullanarak doğrulama mantığını tanımlar: 

using System.ComponentModel.DataAnnotations; 

public class ExampleModel 

{ 

[Required] 

[StringLength(10j ErrorMessage = "Name is too long.")] 
public string Name { get; set; } 

} 

Bir form EditForm bileşeni kullanılarak tanımlanır. Aşağıdaki formda tipik öğeler, bileşenler ve Razor kodu 
gösterilmektedir: 

<EditForm Model="@exampleModel" OnValidSubmit="@HandleValidSubmit"> 

<DataAnnotationsValidator /> 
cValidationSummary /> 

<InputText id="name" @bind-Value="exampleModel.Name" /> 

<button type="submit">Submit</button> 

</EditForm> 

@code { 

private ExampleModel exampleModel = new ExampleModel(); 

private void HandleValidSubmit() 

{ 

Console.WriteLine("OnValidSubmit"); 

} 

} 

• Form, ExampieModei türünde tanımlanan doğrulamayı kullanarak name alanında Kullanıcı girişini doğrular. 
Model, bileşenin @code bloğunda oluşturulur ve özel bir alanda tutulur ( exampieModei ). Alan, <EditForm> 
öğesinin Model özniteliğine atanır. 

• DataAnnotationsVaüdator bileşeni, veri açıklamalarını kullanarak doğrulama desteğini ekler. 

• validationSummary bileşeni doğrulama iletilerini özetler. 

• HandievalidSubmit , form başarıyla gönderdiğinde tetiklenir (doğrulamayı geçirir). 

Kullanıcı girişini almak ve doğrulamak için yerleşik bir giriş bileşenleri kümesi vardır.Girişler değiştirildiklerinde ve 
bir form gönderildiğinde onaylanır. Kullanılabilir giriş bileşenleri aşağıdaki tabloda gösterilmiştir. 

GİRİŞ BİLEŞENİ ... olarak işlendi 


InputText 


<input> 















giriş bileşeni 


... OLARAK İŞLENDİ 


InputTextArea 

<textarea> 

InputSelect 

<select> 


InputNumber 

cinput type="number"> 



InputCheckbox 

<input type="checkbox"> 



InputDate 

cinput type="date"> 


EditForm dahil olmak üzere tüm giriş bileşenleri, rastgele öznitelikleri destekler. Bir bileşen parametresiyle 
eşleşmeyen herhangi bir öznitelik işlenmiş HTML öğesine eklenir. 

Giriş bileşenleri, düzenleme sırasında doğrulamak ve CSS sınıfını alan durumunu yansıtacak şekilde değiştirmek 
için varsayılan davranışı sağlar. Bazı bileşenler, yararlı ayrıştırma mantığını içerir.Örneğin, inputDate ve 
inputNumber , onları doğrulama hatası olarak kaydederek düzeltilemez değerleri düzgün şekilde işleyebilir. Null 
değerleri kabul edebilecek türler, hedef alanın null değer alabilme durumunu da destekler (örneğin, int? ). 

Aşağıdaki starship türü, önceki ExampieModei daha büyük bir özellik kümesi ve veri ek açıklamaları kullanarak 
doğrulama mantığını tanımlar: 

using System; 

using System.ComponentModel.DataAnnotations; 

public class Starship 

{ 

[Required] 

[StringLength(16, ErrorMessage = "Identifier too long (16 character limit).")] 
public string Identifier { get; set; } 

public string Description { get; set; } 

[Required] 

public string Classification { get; set; } 

[Range(l, 100000, ErrorMessage = "Accommodation invalid (1-100000).")] 
public int MaximumAccommodation { get; set; } 

[Required] 

[Range(typeof(bool), "true", "true", 

ErrorMessage = "This form disallows unapproved ships.")] 
public bool IsValidatedDesign { get; set; } 

[Required] 

public DateTime ProductionDate { get; set; } 

} 

Yukarıdaki örnekte, hiçbir veri ek açıklaması mevcut olmadığından Description isteğe bağlıdır. 

Aşağıdaki form, starship modelinde tanımlanan doğrulamayı kullanarak Kullanıcı girişini doğrular: 






















@page "/FormsValidation" 

<hl>Starfleet Stanship Database</hl> 

<h2>New Ship Entry Form</h2> 

<EditForm Model="@starship" OnValidSubmit="@ElandleValidSubmit"> 

<DataAnnotationsValidator /> 

<ValidationSummary /> 

<P> 

<label for="identifier">Identifier: </label> 

<InputText id="identifier" @bind-Value="starship.Identifier" /> 

</p> 

<P> 

<label for="description">Description (optional): </label> 

<InputTextArea id="description" @bind-Value="starship.Description" /> 

</p> 

<P> 

<label for="classification">Primary Classification: </label> 
dnputSelect id="classification" @bind-Value="starship.Classification"» 

<option value="">Select classification ...</option> 

<option value="Exploration">Exploration</option> 

<option value="Diplomacy">Diplomacy</option> 

<option value="Defense">Defense</option> 

</InputSelect> 

</p> 

<P> 

<label fon="accommodation">Maximum Accommodation: </label> 
dnputNumber id="accommodation" 

@bind-Value="starship.MaximumAccommodation" /> 

</p> 

<P> 

<label for="valid">Engineering Approval: </label> 

<InputCheckbox id="valid" @bind-Value="starship.IsValidatedDesign" /> 

</p> 

<P> 

<label for="productionDate">Production Date: </label> 

<InputDate id="productionDate" @bind-Value="starship.ProductionDate" /> 

</p> 

<button type="submit">Submit</button> 

<P> 

<a href="http://www.stantrek.com/">Star Trek</a>j 
Scopy;1966-2019 CBS Studios, Inc. and 

<a href="https://www.paramount.com">Paramount Pictures</a> 

</p> 

</EditForm> 

@code { 

private Stanship starship = new Stanship(); 

private void HandleValidSubmit() 

{ 

Console.WriteLine("OnValidSubmit"); 

} 

} 

EditForm , hangi alanların değiştirildiği ve geçerli doğrulama iletileri de dahil olmak üzere düzenleme işlemiyle 
ilgili meta verileri izleyen basamaklı bir değer olarak Editcontext oluşturur. EditForm ayrıca geçerli ve geçersiz 
gönderir ( OnValidSubmit , Oninvaiidsubmit ) için uygun olaylar sağlar. Alternatif olarak, doğrulamayı tetiklemek ve 
alan değerlerini özel doğrulama kodu ile denetlemek için onSubmit kullanın. 





Giriş olayına göre lnputText 

change olayı yerine input olayını kullanan özel bir bileşen oluşturmak için inputText bileşenini kullanın. 
Aşağıdaki biçimlendirmeye sahip bir bileşen oluşturun ve bileşeni tıpkı inputText kullanıldığı gibi kullanın: 

(Şinherits InputText 
cinput 

@attributes="AdditionalAttributes" 

class="@CssClass" 

value="@CurrentValue" 

@oninput="EventCallback.Factory.CreateBinder<string>( 

this, _value => CurrentValueAsString = _value, CurrentValueAsString)" /> 


Doğrulama desteği 

DataAnnotationsvaüdator bileşeni, basamaklı Editcontext veri açıklamalarını kullanarak doğrulama desteğini 
iliştirir. Veri ek açıklamalarını kullanarak doğrulama desteğinin etkinleştirilmesi bu açık hareketi gerektirir. Veri ek 
açıklamalarıyla farklı bir doğrulama sistemi kullanmak için DataAnnotationsvaüdator özel bir uygulamayla 
değiştirin. ASP.NET Core uygulama, başvuru kaynağında inceleme için kullanılabilir: 

Dataannotationsvalidator/Adddataannotationsvalidation. 

Blazor iki tür doğrulama gerçekleştirir: 

• Alan doğrulama , Kullanıcı bir alanın dışına eklendiğinde gerçekleştirilir. Alan doğrulaması sırasında, 

DataAnnotationsvaüdator bileşen bildirilen tüm doğrulama sonuçlarını alanla ilişkilendirir. 

• Kullanıcı formu gönderdiğinde model doğrulaması gerçekleştirilir. Model doğrulaması sırasında 
DataAnnotationsvaüdator bileşeni, doğrulama sonucunun raporlandığı üye adına göre alanı saptamaya çalışır. 

Tek bir üyeyle ilişkilendirilmeyen doğrulama sonuçları, bir alan yerine modeliyle ilişkilendirilir. 

Doğrulama özeti ve doğrulama İletisi bileşenleri 

vaiidationSummary bileşeni, doğrulama özeti etiketi Yardımcısı'na benzer olan tüm doğrulama iletilerini özetler: 

cVaüdationSummary /> 

Model parametresine sahip belirli bir model için çıkış doğrulama iletileri: 

cVaüdationSummary Model="@starship" /> 

vaiidationMessage bileşeni, doğrulama İletisi etiketi Yardımcısı'na benzer olan belirli bir alan için doğrulama 
iletilerini görüntüler. For özniteliğiyle doğrulama için alanı ve model özelliğini adlandırırken bir lambda ifadesini 
belirtin: 

cVaüdationMessage For="@(() => starship.MaximumAccommodation)" /> 

VaiidationMessage ve VaiidationSummary bileşenleri rastgele öznitelikleri destekler. Bir bileşen parametresiyle 
eşleşmeyen herhangi bir öznitelik, oluşturulan <div> veya <ui> öğesine eklenir. 

Özel doğrulama öznitelikleri 

Bir doğrulama sonucunun özel bir doğrulama özniteliğikullanılırken bir alanla doğru bir şekilde 
ilişkilendirildiğinden emin olmak için, ValidationResultoluştururken doğrulama bağlamının MemberName geçirin 















using System; 

using System.ComponentModel.DataAnnotations; 

private class MyCustomValidator : ValidationAttribute 
{ 

protected override ValidationResult IsValid(object value, 
ValidationContext validationContext) 

{ 


return new ValidationResult("Validation message to user.", 
new[] { validationContext.MemberName }); 

} 

} 

Blazor veri ek açıklamaları doğrulama paketi 

Microsoft. AspNetCore.Blazor. Dataaçıklamalarda. doğrulama , DataAnnotationsValidator bileşenini kullanarak 
doğrulama deneyimini boşlukları dolduran bir pakettir. Paket şu anda deneysel. 

[CompareProperty] özniteliği 

CompareAttribute DataAnnotationsValidator bileşeniyle iyi çalışmaz. Microsoft. AspNetCore.Blazor. Datareek 
açıklamaları, doğrulaması deneysel paketi, bu sınırlamalar etrafında çalıştırılan comparePropertyAttribute ek bir 
doğrulama özniteliği tanıtır. Blazor bir uygulamada, [CompareProperty] [Compare] özniteliğinin doğrudan bir 
değiştirme işlemi olur. Daha fazla bilgi için bkz. CompareAttribute Onvalidgönderim EditForm ile yoksayıldı 
(AS PN ET/AspNetCore #10643). 

İç içe modeller, koleksiyon türleri ve karmaşık türler 

Blazor, yerleşik DataAnnotationsValidator veri açıklamalarını kullanarak form girişini doğrulamaya yönelik destek 
sağlar. Ancak DataAnnotationsValidator , yalnızca koleksiyon veya karmaşık tür özellikleri olmayan forma bağlanan 
modelin en üst düzey özelliklerini doğrular. 

Koleksiyon ve karmaşık tür özellikleri dahil olmak üzere, bağlantılı modelin tüm nesne grafiğini doğrulamak için, 
deneysel Microsoft. aspnetcore.Blazortarafından sunulan objectGraphDataAnnotationsValidator kullanın. 
Dataaçıklamalarda. doğrulama paketi: 



forma bağlandığında doğrulanacak ek veri açıklamalarını içerir: 
Starshlp.es : 

using System; 

using System.ComponentModel.DataAnnotations; 

public class Starship 
{ 


[ValidateComplexType] 

public ShipDescription ShipDescription { get; set; } 


} 











ShipDescription.es: 


using System; 

using System.ComponentModel.DataAnnotations; 

public elass ShipDescription 

{ 

[Required] 

[StringLength(40j ErrorMessage = "Description too long (40 char).")] 
public stning ShontDescription { get; set; } 

[Required] 

[StringLength(240, ErrorMessage = "Description too long (240 char).")] 
public string LongDescription { get; set; } 

} 


Karmaşık veya koleksiyon türü özelliklerinin doğrulanması 

Bir modelin özelliklerine uygulanan doğrulama öznitelikleri, form gönderildiğinde doğrular. Ancak, koleksiyonların 
özellikleri veya bir modelin karmaşık veri türleri DataAnnotationsvalidator bileşeni tarafından form gönderimi 
üzerinde doğrulanmaz. Bu senaryoda iç içe geçmiş doğrulama özniteliklerini kabul etmek için özel bir doğrulama 
bileşeni kullanın. Bir örnek için Blazor doğrulama örneğine (ASPNET/Samples)bakın. 
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Simon Timms tarafından 

Bileşenler, projeler genelinde Razor sınıf kitaplığı 'nda (RCL) paylaşılabilir. Razor bileşenleri sınıf kitaplığı, şuradan 
eklenebilir: 

• Çözümdeki başka bir proje. 

• Bir NuGet paketi. 

• Başvurulan bir .NET kitaplığı. 

Bileşenler normal .NET türleri olduğu gibi, bir RCL tarafından sunulan bileşenler normal .NET derlemelerdir. 

RCL oluşturma 

Ortamınızı Blazoriçin yapılandırmak üzere ASP.NET Core Blazor kullanmaya başlama makalesindeki yönergeleri 
izleyin. 

• Visual Studio 

• .NET Core CLI 

1. Yeni bir proje oluşturun. 

2. Razor sınıfı kitaplığı' nı seçin. İleri yi seçin. 

3. Yeni bir Razor sınıf kitaplığı oluştur İletişim kutusunda Oluştur 1 u seçin. 

4. Proje adı alanında bir proje adı girin veya varsayılan proje adını kabul edin. Bu konudaki örneklerde 
MyComponentLibi proje adı kullanılır. Seçin oluşturma. 

5. RCL'yi bir çözüme ekleyin: 

a. Çözüme sağ tıklayın. > var olan projeyi Ekle ' yi seçin. 

b. RCL'nin proje dosyasına gidin. 

c. RCL 'nin proje dosyasını (. csproj) seçin. 

6. Uygulamadan RCL 'ye bir başvuru ekleyin: 

a. Uygulama projesine sağ tıklayın. > başvuru Ekle ' yi seçin. 

b. RCL projesini seçin. Seçin Tamam. 

Kitaplık bileşeni kullanma 

Başka bir projedeki bir kitaplıkta tanımlanan bileşenleri kullanmak için aşağıdaki yaklaşımlardan birini kullanın: 

• Ad alanı ile tam tür adını kullanın. 

• Razor kullanarak Razor @ kullanın. Tek tek bileşenler, ada göre eklenebilir. 

Aşağıdaki örneklerde MyComponentLibi , bir salesReport bileşeni içeren bir bileşen kitaplığıdır. 
salesReport bileşene, ad alanı ile tam tür adı kullanılarak başvurulabilir: 







<hl>Hello, world!</hl> 


Welcome to your new app. 

<MyComponentLibl.SalesReport /> 

Ayrıca, kitaplık bir @using yönergesi ile kapsama alınırsa bileşene de başvurulabilir: 

@using MyComponentLibl 
<hl>Hello J world!</hl> 

Welcome to your new app. 

<SalesReport /> 

Kitaplığın bileşenlerini bir projenin tamamına kullanılabilir hale getirmek için en üst düzey _lmport. Razor 
dosyasına @using MyComponentLibl yönergesini ekleyin. Ad alanını tek bir sayfaya veya bir klasör içindeki sayfa 
kümesine uygulamak için herhangi bir düzeydeki bir Jmport. Razor dosyasına yönergesini ekleyin. 

NuGet 'i derleyin, paketleyebilir ve iade edin 

Bileşen kitaplıkları standart .NET kitaplıkları olduğundan, paketlemeden ve tüm kitaplıkları NuGet 'e dağıtmadan 
farklı değildir. Paketleme, bir komut kabuğu 'nda DotNet Pack komutu kullanılarak gerçekleştirilir: 

dotnet pack 

Bir komut kabuğunda DotNet NuGet Push komutunu kullanarak paketi NuGet 'e yükleyin. 

Statik varlıklar ile Razor bileşenleri sınıf kitaplığı oluşturma 

RCL statik varlıkları içerebilir.Statik varlıklar, kitaplığı kullanan tüm uygulamalar tarafından kullanılabilir.Daha fazla 
bilgi için bkz. ASP.N ET Core ile sınıf kitaplıklarında yeniden kullanılabilir Razor Kullanıcı arabirimi. 

Ek kaynaklar 

• ASP.NET Core ile sınıf kitaplıklarında yeniden kullanılabilir Razor Kullanıcı arabirimi 
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Tarafından Rainer Stropek ve Luke Latham 

Menüler, telif hakkı iletileri ve şirket logoları gibi bazı uygulama öğeleri genellikle uygulamanın genel düzeninin 
parçasıdır ve uygulamadaki her bileşen tarafından kullanılır. Bu öğelerin kodunu bir uygulamanın tüm 
bileşenlerine kopyalamak, öğelerden biri bir güncelleştirme gerektirdiğinde her bileşenin güncelleştirilmesi gerekir 
—etkili bir yaklaşım değildir. Bu tür çoğaltmaya devam etmek zordur ve zaman içinde tutarsız içeriğe yol açabilir. 
Düzenler bu sorunu çözüyor. 

Teknik olarak, düzen yalnızca başka bir bileşendir. Bir düzen Razor şablonunda veya C# kodda tanımlanır ve veri 
bağlama, bağımlılık eklemeve diğer bileşen senaryolarını kullanabilir. 

Bir bileşeni bir düzenedönüştürmek için bileşen: 

• Düzen içindeki işlenmiş içerik için bir Body özelliği tanımlayan LayoutcomponentBase devralır. 

• içeriğin işlendiği yerleşim biçimlendirmesinde konumu belirtmek için Razor söz dizimi @Body kullanır. 


Aşağıdaki kod örneğinde, mainlayout. Razoro lan bir düzen bileşeninin Razor şablonu gösterilmektedir. Düzen 
LayoutcomponentBase devralır ve gezinti çubuğu ile altbilgi arasındaki @Body ayarlar: 


(Şinherits LayoutcomponentBase 


<header> 

<hl>Doctor Who&trade; Episode Database</hl> 

</header> 


<nav> 

<a href="masterlist">Master Episode List</a> 

<a href="search">Search</a> 

<a href="new">Add Episode</a> 

</nav> 


@Body 


<footer> 

@TrademarkMessage 

</footer> 


@code { 

public string TrademarkMessage { get; set; } = 

"Doctor Who is a registered trademark of the BBC. 
"https://www.doctorwho.tv/"; 

} 

" + 


Blazor uygulama şablonlarından birini temel alan bir uygulamada, MainLayout bileşeni ( Mainlayout. Razor) 
uygulamanın paylaşılan klasöründedir. 


Varsayılan düzen 

Uygulamanın app. Razor dosyasındaki Router bileşende varsayılan uygulama yerleşimini belirtin. Varsayılan 
Blazor şablonları tarafından sunulan aşağıdaki Router bileşeni, MainLayout bileşenine varsayılan düzeni ayarlar: 











<Router AppAssembly="typeof(Startup).Assembly"> 

<Found Context="routeData"> 

<RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" /> 

</Found> 

<NotFound> 

<p>Sorry, there's nothing at this address.</p> 

</NotFound> 

</Routen> 

NotFound içerik için varsayılan bir düzen sağlamak üzere NotFound içeriği için bir Layoutview belirtin: 

<Router AppAssembly="typeof(Stantup).Assembly"> 

<Found Context="nouteData"> 

<RouteView RouteData="@nouteData" DefaultLayout="@typeof(MainLayout)" /> 

</Found> 

<NotFound> 

<LayoutView Layout="typeof(MainLayout)"» 

<hl>Page not found</hl> 

<p>Sonry J there's nothing at this addness.</p> 

</LayoutView> 

</NotFound> 

</Router> 

Router bileşeni hakkında daha fazla bilgi için bkz. AS P.N ET Core Blazor yönlendirme. 


Düzen bir varsayılan düzen olarak belirtildiğinde, bileşen başına veya klasör temelinde geçersiz kılınabileceğinden, 
yararlı bir uygulamadır. En genel teknik olduğundan, uygulamanın varsayılan yerleşimini ayarlamak için 
yönlendiriciyi kullanmayı tercih edin. 


Bir bileşende düzen belirtme 

Bir bileşene düzen uygulamak için Razor yönergesini @iayout kullanın. Derleyici, @iayout bileşen sınıfına 
uygulanan bir LayoutAttribute dönüştürür. 

Aşağıdaki MasterList bileşenin içeriği, @Body konumundaki MastenLayout eklenir: 

(Şlayout MasterLayout 
@page "/masterlist" 

<hl>Master Episode List</hl> 


Düzen doğrudan bir bileşende belirtildiğinde, yönlendiricide ayarlanan varsayılan bir düzen veya _lmports. 
Razor' den içeri aktarılan bir @iayout yönergesi geçersiz kılınır. 

Merkezi düzen seçimi 

Bir uygulamanın her klasörü, isteğe bağlı olarak _lmports. Razorad\\ bir şablon dosyası içerebilir. Derleyici tüm 
Razor şablonlarındaki içeri aktarmalar dosyasında belirtilen yönergeleri aynı klasörde ve özyinelemeli olarak tüm 
alt klasörlerinde içerir. Bu nedenle, @iayout MyCoolLayout içeren bir Jmports. Razor dosyası, bir klasördeki tüm 
bileşenlerin MyCoolLayout kullanmasını sağlar. Klasör ve alt klasörler içindeki tüm . Razor dosyalarına 
@iayout MyCoolLayout tekrar tekrar eklemeniz gerekmez. @using yönergeler aynı zamanda bileşenlere aynı 
şekilde uygulanır. 

Aşağıdaki _lmports. Razor dosyası içeri aktarmaları: 


MyCoolLayout . 

Aynı klasörde ve alt klasörlerde bulunan tüm Razor bileşenleri. 


















BiazorAppi.Data ad alanı. 


(Şlayout MyCoolLayout 

@using Microsoft.AspNetCore.Components 

@using BiazorAppi.Data 


_lmports. Razor dosyası, Razor görünümleri ve sayfaları için _Viewlmports. cshtml dosyasına benzer ancak 
özellikle Razor bileşen dosyalarına uygulanır. 

Jmports bir düzen belirtme . Razor, yönlendiricinin varsayılan düzenıolarak belirtilen bir düzeni geçersiz kılar. 

İç içe düzenleri 

Uygulamalar iç içe düzenleri içerebilir. Bir bileşen, daha sonra başka bir düzene başvuruda bulunan bir düzene 
başvurabilir. Örneğin, iç içe düzenleri çok düzeyli bir menü yapısı oluşturmak için kullanılır. 

Aşağıdaki örnek, iç içe düzenleri nasıl kullanacağınızı gösterir. Epısodescomponent. Razor dosyası görüntülenecek 
bileşendir. Bileşen MasterListLayout başvurur: 

(Şlayout MasterListLayout 
@page "/masterlist/episodes" 

<hl>Episodes</hl> 

Masterlistlayout. Razor dosyası MasterListLayout sağlar. Düzen, MasterLayout başka bir düzene başvuruyor. 
EpisodesComponent , @Body göründüğü yerde işlenir: 

(Şlayout MasterLayout 
(Şinherits LayoutComponentBase 

<nav> 

<!-- Menü structure of master list --> 

</nav> 

@Body 

Son olarak, Masterlayout. Razor içindeki MasterLayout üstbilgi, ana menü ve alt bilgi gibi en üst düzey düzen 
öğelerini içerir. EpisodesComponent MasterListLayout @Body göründüğü yerde işlenir: 

(Şinherits LayoutComponentBase 

<header>...</header> 

<nav>...</nav> 

@Body 

<footer> 

(ŞTrademarkMessage 

</footer> 

@code { 

public string TrademarkMessage { get; setj } = 

"Doctor Who is a registered trademark of the BBC. " + 

''https://www.doctorwho.tv/"; 

} 












Ek kaynaklar 

• ASP.NET Core düzen 
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Rainer Stropek tarafından 


IMPORTANT 

Önizlemede Blazor VVeelsembly 

Blazor sunucusu ASP.NET Core 3,0 ' de desteklenir. Blazor WebAssembly ASP.NET Core 3,1 için önizlemededir. 


Blazor bağımlılık ekleme (dı)işlemini destekler. Uygulamalar, yerleşik hizmetleri ekleme tarafından bileşenlere 
kullanabilir. Uygulamalar Ayrıca özel hizmetleri tanımlayabilir ve kaydedebilir ve bu Hizmetleri uygulama 
genelinde Dİ aracılığıyla kullanılabilir hale getirebilirsiniz. 

Dİ, merkezi bir konumda yapılandırılmış hizmetlere erişmek için bir tekniktir.Bu, Blazor uygulamalarda şu şekilde 
yararlı olabilir: 

• Hizmet sınıfının tek bir örneğini tek bir hizmet olarak bilinen birçok bileşen arasında paylaşabilirsiniz. 

• Başvuru soyutlamalarını kullanarak somut hizmet sınıflarından bileşenleri ayırın. Örneğin, uygulamadaki 
verilere erişmek için bir arabirim iDataAccess düşünün. Arabirim somut bir DataAccess sınıfı tarafından 
uygulanır ve uygulamanın hizmet kapsayıcısında bir hizmet olarak kaydedilir. Bir bileşen bir İDataAccess 
uygulamasını almak için Dİ kullandığında, bileşen somut tür ile eşleştirilmez. Uygulama, büyük olasılıkla birim 
testlerinde bir sahte uygulama için değiştirilebilir. 

Varsayılan hizmetler 

Varsayılan hizmetler, uygulamanın hizmet koleksiyonuna otomatik olarak eklenir. 


HİZMET 

ÖMÜR 

AÇIKLAMA 

HttpClient 

Adet 

HTTP istekleri göndermek ve bir URI 


tarafından tanımlanan bir kaynaktan 
HTTP yanıtlarını almak için yöntemler 
sağlar. 


Bir Blazor VVebAssembly 
uygulamasındaki Httpclient örneği, 
arka planda HTTP trafiğini işlemek için 
tarayıcıyı kullanır. 

Blazor Server uygulamaları, varsayılan 
olarak hizmet olarak yapılandırılmış bir 
Httpclient içermez. Blazor sunucusu 
uygulamasına bir Httpclient 
sağlayın. 

Daha fazla bilgi için bkz. ASP.NET Core 
Blazor bir Web API 'SI çağırma. 













HİZMET 


OMUR 


AÇIKLAMA 


nsRuntime Adet JavaScript çağrılarının dağıtıldığı bir 

JavaScript çalışma zamanının örneğini 
temsil eder. Daha fazla bilgi için bkz. 
ASP.NET Core Blazor JavaScript birlikte 
çalışabilirliği. 


NavigationManager Adet URl'Ler ve gezinme durumu ile 

çalışmaya yönelik yardımcıları içerir. 
Daha fazla bilgi için bkz. URI ve gezinti 
durumu yardımcıları. 


Özel bir hizmet sağlayıcı, tabloda listelenen varsayılan Hizmetleri otomatik olarak sağlamaz. Özel bir hizmet 
sağlayıcısı kullanır ve tabloda gösterilen hizmetlerden herhangi birini gerekliyse, gerekli hizmetleri yeni hizmet 
sağlayıcısına ekleyin. 

Uygulamaya hizmet ekleme 

Yeni bir uygulama oluşturduktan sonra startup.configureServices yöntemini inceleyin: 

public void ConfigureServices(IServiceCollection Services) 

{ 

// Add custom Services here 

} 

Configureservices yöntemi, hizmet açıklayıcı nesnelerinin bir listesi olan bir IServiceCollectiongeçirilir 
(ServiceDescriptor). Hizmetler, hizmet koleksiyonuna hizmet tanımlayıcıları sağlayarak eklenir. Aşağıdaki örnek, 
iDataAccess arabirimiyle kavramı ve somut uygulama DataAccess gösterir: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddSingleton<İDataAccess , DataAccess>(); 

} 

Hizmetler, aşağıdaki tabloda gösterilen ömürlerle yapılandırılabilir. 

ÖMÜR AÇIKLAMA 

Scoped Blazor VVebAssembly uygulamalarının Şu anda bir dı 

kapsamları kavramı yoktur, scoped kayıtlı hizmetler 
singleton hizmetleri gibi davranır. Ancak, Blazor sunucusu 
barındırma modeli scoped ömrünü destekler. Blazor Server 
uygulamalarında, kapsamlı bir hizmet kaydı 
öoğ/onfmmkapsamına alınır. Bu nedenle, geçerli amaç 
tarayıcıda istemci tarafı çalıştırmak olsa bile, kapsama alınmış 
hizmetlerin kullanılması geçerli kullanıcı kapsamında olması 
gereken hizmetler için tercih edilir. 


Singleton Dı, hizmetin tek bir örneğini oluşturur. Bir singleton 

hizmeti gerektiren tüm bileşenler aynı hizmetin bir örneğini 
alır. 


Transient 


Bir bileşen hizmet kapsayıcısından bir Transient hizmeti 
örneği aldığında, hizmetin Yeni bir örneğini alır. 









Dı sistemi ASP.NET Core içindeki Dİ sistemini temel alır.Daha fazla bilgi için bkz. ASP.NET Core bağımlılık 
ekleme. 

Bir bileşende hizmet isteme 

Hizmetler hizmet koleksiyonuna eklendikten sonra, @Ekle Razor yönergesini kullanarak hizmetleri bileşenlere 
ekleyin. @inject iki parametreye sahiptir: 

• Eklenecek hizmetin türünü - yazın. 

• Özelliği, eklenen App Service 'i alan özelliğin adını -. Özelliği el ile oluşturma gerektirmez. Derleyici özelliği 
oluşturur. 

Daha fazla bilgi için bkz. ASP.NET core'da görünümlere bağımlılık ekleme. 

Farklı hizmetler eklemek için birden çok şinject deyimi kullanın. 

Aşağıdaki örnek @inject nasıl kullanacağınızı gösterir. Services.iDataAccess uygulayan hizmet bileşenin Özellik 
DataRepository eklenir. Kodun yalnızca İDataAccess soyutlamasını nasıl kullandığını aklınızda yapın: 

@page "/customer-list" 

Şusing Services 

Şinject İDataAccess DataRepository 

Şif (Customers != null) 

{ 

<ul> 

Şforeach (var customer in Customers) 

{ 

<li>Şcustomer.FirstName Şcustomer.LastName</li> 

} 

</ul> 

} 

Şcode { 

private IReadOnlyList<Customer> Customers; 

protected override async Task OnInitializedAsync() 

{ 

// The property DataRepository received an implementation 
// of İDataAccess through dependency injection. Use 
// DataRepository to obtain data from the server. 

Customers = await DataRepository.GetAllCustomersAsync(); 

} 

} 

Dahili olarak, oluşturulan Özellik ( DataRepository ) injectAttribute özniteliğini kullanır. Genellikle, bu öznitelik 
doğrudan kullanılmaz. Bileşenler için bir temel sınıf gerekliyse ve temel sınıf için eklenen özellikler de gerekliyse, 
injectAttribute el ile ekleyin: 

public class ComponentBase : IComponent 
{ 

// DI works even if using the InjectAttribute in a component's base class. 

[Inject] 

protected İDataAccess DataRepository { get; set; } 

} 


Temel sınıftan türetilmiş bileşenlerde şinject yönergesi gerekli değildir. Temel sınıfın InjectAttribute yeterlidir: 











@page "/demo" 

(Şinherits ComponentBase 

<hl>Demo Component</hl> 


Hizmetler 'de dı kullanma 

Karmaşık hizmetler için ek hizmetler gerekebilir.Önceki örnekte, DataAccess Httpciient varsayılan hizmeti 
gerektirebilir. @inject (veya injectAttribute ), hizmetlerde kullanılamaz. Bunun yerine Oluşturucu Ekleme 
kullanılmalıdır. Gerekli hizmetler, hizmetin oluşturucusuna parametreler eklenerek eklenir.Dı hizmeti 
oluşturduğunda, oluşturucuda gereken hizmetleri algılar ve bunlara göre sağlar. 

public class DataAccess : IDataAccess 
{ 

// The constructor receives an HttpClient via dependency 
// injection. HttpClient is a default service, 
public DataAccess(HttpClient Client) 

{ 

} 

} 

Oluşturucu Ekleme önkoşulları: 

• Bağımsız değişkenlerinin tümü Dİ tarafından yerine getirilme için tek bir Oluşturucu bulunmalıdır.Varsayılan 
değerleri belirttiklerinde, Dİ tarafından kapsanmayan ek parametrelere izin verilir. 

• Uygulanabilir Oluşturucu ortokolmalıdır. 

• Uygulanabilir bir Oluşturucu var olmalıdır. Belirsizlik söz konusu olduğunda, bir özel durum oluşturur. 

Bir dı kapsamını yönetmek için yardımcı program temel bileşen sınıfları 

ASP.NET Core uygulamalarda, kapsamlı hizmetler genellikle geçerli isteğin kapsamlandırılır.istek 
tamamlandıktan sonra, tüm kapsamlı veya geçici hizmetler dı sistemi tarafından silinir. Blazor Server 
uygulamalarında istek kapsamı, istemci bağlantısı süresince sürer ve bu da geçici ve kapsamlı hizmetlerin 
beklenenden çok daha uzun sürebileceği anlamına gelir. 

Hizmetlerin bir bileşenin kullanım ömrüne göre kapsamını atamak için 0wningComponentBase ve 
0wningComponentBase<TService> temel sınıfları kullanabilir. Bu temel sınıflar, bileşenin kullanım ömrü kapsamındaki 
Hizmetleri çözümlemek ıserviceProvider türünde bir Scopedservices özelliğini kullanıma sunar. Razor'teki bir 
taban sınıftan devralan bir bileşeni yazmak için @inherits yönergesini kullanın. 

@page "/users" 

@attribute [Authorize] 

(Şinherits OwningComponentBase<Data.ApplicationDbContext> 

<hl>Users (@Service.Users.Count())</hl> 

<ul> 

(Şforeach (var user in Service.Users) 

{ 

<li>@user.UserName</li> 

} 

</ul> 












NOTE 

(fflinject veya injectAttribute kullanılarak bileşene eklenen hizmetler bileşen kapsamında oluşturulmaz ve istek 
kapsamına bağlıdır. 


Ek kaynaklar 

• ASP.NET Core bağımlılık ekleme 

• ASP.NET core'da görünümlere bağımlılık ekleme 




ASPNET Core Blazor yönlendirme 

9.12.2019 • 11 minutes to read « Edit Online 


Tarafından Luke Latham 


IMPORTANT 

Önizlemede Blazor VVeelsembly 

Blazor sunucusu ASP.NET Core 3,0 ' de desteklenir. Blazor VVebAssembly ASP.NET Core 3,1 için önizlemededir. 


istekleri yönlendirmeyi ve Blazor uygulamalarda gezinti bağlantıları oluşturmak için NavLink bileşenini 
kullanmayı öğrenin. 

Uç nokta yönlendirme tümleştirmesi ASP.NET Core 

Blazor sunucusu ASP.NET Core uç nokta yönlendirmesindetümleşiktir. ASP.NET Core bir uygulama, 
startup.configure''MapBiazorHub etkileşimli bileşenlere yönelik gelen bağlantıları kabul edecek şekilde 
yapılandırılmıştır: 

app.UseRouting(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapBlazorHub(); 

endpoints.MapFallbackToPage("/_Host"); 

}); 


En yaygın yapılandırma, tüm istekleri Razor sayfasına yönlendirmesidir ve bu, Blazor sunucu uygulamasının 
sunucu tarafı bölümü için ana bilgisayar görevi görür. Kurala göre, ana bilgisayar sayfası genellikle _Host. 
cstrfm/olarak adlandırılır. Ana bilgisayar dosyasında belirtilen yol, yol eşleştirilirken düşük bir öncelik ile 
çalıştığından bir geri dönüş yolu olarak adlandırılır. Geri dönüş yolu, diğer yollar eşleşmediği zaman kabul edilir. 

Bu, uygulamanın Blazor sunucu uygulamasıyla kesintiye uğramadan diğer denetleyicileri ve sayfaları kullanmasına 
izin verir. 

Rota şablonları 

Router bileşeni, belirtilen bir rota ile her bileşene yönlendirmeyi sağlar. Router bileşeni app. Razor dosyasında 
görünür: 

<Router AppAssembly="typeof(Startup).Assembly"> 

<Found Context="routeData"> 

<RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" /> 

</Found> 

<NotFound> 

<p>Sorry, there's nothing at this address.</p> 

</NotFound> 

</Router> 

@page yönergesine sahip bir. Razor dosyası derlendiğinde, oluşturulan sınıf yol şablonunu belirten bir 

RouteAttribute sağlanır. 












Çalışma zamanında Routeview bileşeni: 


• Tüm istenen parametrelerle birlikte Router RouteData alır. 

• Belirtilen parametreleri kullanarak belirtilen bileşeni düzeniyle (veya isteğe bağlı bir varsayılan düzende) işler. 

isteğe bağlı olarak, düzen belirtmeyen bileşenler için kullanılacak düzen sınıfıyla bir DefauitLayout parametresi 
belirtebilirsiniz. Varsayılan Blazor şablonları MainLayout bileşenini belirtir. Mainlayout. Razor, şablon projenin 
paylaşılan klasöründedir. Düzenler hakkında daha fazla bilgi için bkz. ASP.NET Core Blazor düzenleri. 

Birden çok yol şablonu, bir bileşene uygulanabilir.Aşağıdaki bileşen /BiazorRoute ve /DifferentBiazorRoute 
isteklerine yanıt verir: 

@page "/BiazorRoute" 

@page "/DifferentBiazorRoute" 

<hl>Blazor routing</hl> 


IMPORTANT 

URL 'Lerin doğru bir şekilde çözülmesi için, uygulamanın, href özniteliğinde belirtilen uygulama temel yolu ile 
Wwwroot/index.html dosyasına (Blazor VVebAssembly) veya Pages/_Host. cshtml dosyasına (Blazor Server) bir <base> 
etiketi içermesi gerekir ( <base href="/"> ). Daha fazla bilgi için bkz. ASP.NET Core Blazor barındırma ve dağıtma. 


İçerik bulunamadığında özel içerik sağla 

Router bileşeni, istenen rota için içerik bulunmazsa uygulamanın özel içerik belirtmesini sağlar. 

App. Razor dosyasında, Router bileşeninin NotFound Şablon parametresinde özel içerik ayarlayın: 

<Router AppAssembly="typeof(Startup).Assembly"> 

<Found Context="routeData"> 

<RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" /> 

</Found> 

<NotFound> 

<hl>Sorry</hl> 

<p>Sorry, there's nothing at this address.</p> b 
</NotFound> 

</Router> 

<NotFound> etiketlerinin içeriği, diğer etkileşimli bileşenler gibi rastgele öğeler içerebilir. NotFound içeriğe 
varsayılan bir düzen uygulamak için bkz. AS P.N ET Core Blazor düzenleri. 

Birden çok derlemeden bileşenlere rota 

Router bileşenin yönlendirilebilir bileşenleri ararken dikkate alınması için ek derlemeler belirtmek üzere 
AdditionalAssemblies parametresini kullanın. Belirtilen derlemeler AppAssembiy belirtilen derlemeye ek olarak 
değerlendirilir. Aşağıdaki örnekte componentı , başvurulan bir sınıf kitaplığında tanımlanan yönlendirilebilir bir 
bileşendir. Aşağıdaki AdditionalAssemblies örnek, componentı için yönlendirme desteğiyle sonuçlanır: 

<Router 

AppAssembly="typeof(Program).Assembly" 

AdditionalAssemblies="new[] { typeof(Componentı).Assembly }"> 

</Router> 





















Rota parametreleri 

Yönlendirici, karşılık gelen bileşen parametrelerini aynı ada (büyük/küçük harfe duyarsız) doldurmak için yol 
parametrelerini kullanır: 

@page "/RouteParameter" 

@page "/RouteParameter/{text}" 

<hl>Blazor is @Text!</hl> 

@code { 

[Parameter] 

public string Text { get; set; } 

protected override void OnInitialized() 

{ 

Text = Text ?? "fantastic"; 

} 

} 

ASP.NET Core 3,0 1 deki Blazor uygulamalar için isteğe bağlı parametreler desteklenmez. Önceki örnekte iki 
@page yönergesi uygulanır. İlki, bir parametre olmadan bileşene gezinmesine izin verir.ikinci @page yönergesi 
{text} Route parametresini alır ve değeri Text özelliğine atar. 

Yol kısıtlamaları 

Yol kısıtlaması bir yönlendirme segmentinde bir bileşene tür eşleştirmeyi zorlar. 

Aşağıdaki örnekte, users bileşene olan yol yalnızca şu durumlarda eşleşir: 

• istek URL'sinde bir id yol kesimi var. 

• id segmenti bir tamsayıdır ( int ). 

@page "/Users/{Id:int}" 

<hl>The user Id is @Id!</hl> 

@code { 

[Parameter] 

public int Id { get; set; } 

} 

Aşağıdaki tabloda gösterilen yol kısıtlamaları mevcuttur. Sabit kültür ile eşleşen yol kısıtlamaları için daha fazla 
bilgi için tablonun altındaki uyarıya bakın. 


KISITLAMASI 


bool 


datetime 


decimal 


double 


BİLMESİ 

KÜLTÜR 


ÖRNEK 

ÖRNEK EŞLEŞMELER EŞLEŞTİRME 

{active:bool} 

true , false Hayır 



{dob:datetime} 

2016-12-31 , Evet 


2016-12-31 7:32pm 


{price:decimal} 

49.99 , - 1 , 000.01 Evet 



{weight:double} 

1.234 , - 1 , 001 . 01 e 8 Evet 




















KISITLAMASI ÖRNEK 

BİLMESİ 

KÜLTÜR 

ÖRNEK EŞLEŞMELER EŞLEŞTİRME 

float {weight:float} 

1.234 , -lj 001 . 01 e 8 Evet 



guid {idrguid} 

CD2C1638-1638-72D5- Hayır 

1638-DEADBEEF1638 


{CD2C1638-1638-72D5- 

1638-DEADBEEF1638} 


int 

{id:int} 

123456789 , 

-123456789 

Evet 











long 

{ticks:long} 

123456789 , 

-123456789 

Evet 


WARNING 

URL'Yİ doğrulayan ve bir CLR türüne (örneğin int veya DateTime ) dönüştürülen yol kısıtlamaları her zaman sabit kültürü 
kullanır. Bu kısıtlamalar, URL 'nin yerelleştirilemeyen olduğunu varsayar. 


Noktalar içeren URL 'lerle yönlendirme 

Blazor Server uygulamalarında, _Host. cshtml içindeki varsayılan yol / ( @page "/" ). URL bir dosya isteyecek 
şekilde göründüğünden, nokta ( . ) içeren bir istek URL 'SI varsayılan yol tarafından eşleşmiyor.Blazor bir 
uygulama, var olmayan bir statik dosya için 404-Found yanıtı döndürür. Bir nokta içeren yolları kullanmak için, 
_Host. cshtml 'yi aşağıdaki yol şablonuyla yapılandırın: 

@page "/{**path}" 

"/{**path}" şablonu şunları içerir: 

• Ters eğik çizgi ( / ) kodlaması olmadan birden çok klasör sınırlarındaki yolu yakalamak için çift yıldız catch-all 
söz dizimi ( ** ). 

• path Route parametresi adı. 


NOTE 

Catch-all parametre sözdizimi (*/**) Razor bileşenlerinde (. Razor) desteklenmez. 


Daha fazla bilgi için bkz. AS P.N ET Core yönlendirme. 

Gezinti bağlantısı bileşeni 

Gezinti bağlantıları oluştururken, HTML köprü öğelerinin yerine bir NavLink bileşeni kullanın ( <a> ). Bir NavLink 
bileşeni, href geçerli URL ile eşleşip eşleşmediğini temel alan active CSS sınıfına geçiş yaparken, bir <a> öğesi 
gibi davranır, active sınıfı, bir kullanıcının hangi sayfanın etkin sayfa olduğunu anlamasına yardımcı olan gezinti 
bağlantıları. 

Aşağıdaki NavMenu bileşeni, NavLink bileşenlerinin nasıl kullanılacağını gösteren bir önyükleme gezinti çubuğu 
oluşturur: 
































<div class="@NavMenuCssClass" @onclick="@ToggleNavMenu"> 

<ul class="nav flex-column"> 

<li class="nav-item px-3"> 

<NavLink class="nav-link" href="" Match="NavLinkMatch.All"> 

<span class="oi oi-home" aria-hidden="true"x/span> Home 
</NavLink> 

</li> 

<li class="nav-item px-3"> 

<NavLink class="nav-link" href="MyComponent" Match="NavLinkMatch.Prefix"> 

<span class="oi oi-plus" aria-hidden="true"x/span> My Component 
</NavLink> 

</li> 

</ul> 

</div> 

<MavLink> öğesinin Match özniteliğine atayabilmeniz için iki NavLinkMatch seçeneği vardır: 

• NavLinkMatch .ah - geçerli URL 'nin tamamı eşleştiğinde etkin NavLink . 

• NavLinkMatch.Prefix ( varsayılan ) NavLink geçerli URL 'nin herhangi bir ön ekiyle eşleştiğinde etkin -. 


Yukarıdaki örnekte, giriş NavLink href="" giriş URL 'siyle eşleşir ve yalnızca uygulamanın varsayılan temel yol 
URL'sindeki active CSS sınıfını alır (örneğin, https://iocaihost :500ı/ ). ikinci NavLink , Kullanıcı MyComponent 

ziyaret ettiğinde active sınıfını alır (örneğin, 
ve https://localhost:5001/MyComponent/AnotherSegment ). 


NavLink 

bileşen öznitelikleri, işlenen tutturucu etiketine geçirilir. Aşağıdaki örnekte 

NavLink 

bileşeni 

target 


özniteliğini içerir: 

<NavLink href="my-page" target="_blank">My page</NavLink> 


ön ekine sanıp herhangi bir URL 'Yİ 
https://localhost:5001/MyComponent 


Aşağıdaki HTML biçimlendirmesi işlenir: 


<a href="my-page" target="_blank" rel="noopener noneferren">My page</a> 


URI ve gezinti durumu yardımcıları 

Kod içinde C# , URI ' ler ve gezinme ile çalışmak için Micnosoft.AspNetCore.Components.NavigationManager kullanın. 
NavigationManager , aşağıdaki tabloda gösterilen olay ve yöntemleri sağlar. 

ÜYE AÇIKLAMA 

uni Geçerli mutlak URI 'yi alır. 


Baseiini Mutlak bir URI oluşturmak için göreli URI yollarına eklenebilir 

olan temel URI 'yi (sondaki eğik çizgiyle birlikte) alır. Genellikle 
BaseUri , belgenin WwwrootAndex.html (Blazor 
VVebAssembly) veya Pages/_Host. cshtml (Blazor Server) 
içindeki <base> öğesinde href özniteliğine karşılık gelir. 


NavigateTo Belirtilen URI'ye gider. forceLoad true : 

• istemci tarafı yönlendirme atlanır. 

• Bu tarayıcı, URI 'nin normalde istemci tarafı yönlendirici 
tarafından işlenip işlenmediğini sunucudan yeni sayfayı 
yüklemeye zorlanır. 


























UYE 


AÇIKLAMA 


LocationChanged 


Gezinti konumu değiştiğinde harekete gelen bir olay. 


ToAbsoluteUri 


Göreli bir URI 'yi mutlak bir URI 'ye dönüştürür. 


ToBaseRelativePath Temel URI (örneğin, daha önce GetBaseUri tarafından 

döndürülen bir URI) verildiğinde, mutlak bir URI 'yi taban URI 
ön ekine göre bir URI 'ye dönüştürür. 

Aşağıdaki bileşen, düğme seçildiğinde uygulamanın counter bileşenine gider: 

@page "/navigate" 

@inject NavigationManager NavigationManager 
<hl>Navigate in Code Example</hl> 

<button class="btn btn-primary" @onclick="NavigateToCounterComponent"> 

Navigate to the Counter component 
</button> 

@code { 

private void NavigateToCounterComponent() 

{ 

NavigationManager.NavigateTo("counter"); 

} 

} 








ASPNET Core Blazor JavaScript birlikte çalışabilirliği 
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Sağlayan Javier Calvarro Nelson, Daniel Rothve Luke Latham 


IMPORTANT 

Önizlemede Blazor VVeelsembly 

Blazor sunucusu ASP.NET Core 3,0 ' de desteklenir. Blazor WebAssembly ASP.NET Core 3,1 için önizlemededir. 


Blazor bir uygulama, JavaScript kodundan .N ET ve .N ET yöntemlerinden JavaScript işlevlerini çağırabilir. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

.NET metotlarından JavaScript işlevlerini çağırma 

Bir JavaScript işlevini çağırmak için .NET kodunun gerekli olduğu durumlar vardır.Örneğin, JavaScript çağrısı, 
tarayıcı özelliklerini veya bir JavaScript kitaplığından uygulamaya yönelik işlevselliği sunabilir. Bu senaryoya 
JavaScript birlikte çaiışabiliriiği (js birlikte çalışma) denir. 

.NET'ten JavaScript'i çağırmak için iDSRuntime soyutlamasını kullanın. invokeAsync<T> yöntemi, herhangi bir 
sayıda JSON seri hale getirilebilir bağımsız değişkenle birlikte çağırmak istediğiniz JavaScript işlevi için bir 
tanımlayıcı alır, işlev tanımlayıcısı, genel kapsama ( window ) göredir. window.someScope.someFunction çağırmak 
isterseniz, tanımlayıcı someScope.someFunction . Çağrılmadan önce işlevi kaydetmeniz gerekmez. Dönüş türü t 
ayrıca seri hale getirilebilir JSON olmalıdır, t , döndürülen JSON türüyle en iyi eşleşen .NET türüyle 
eşleşmelidir. 

Blazor Server uygulamaları için: 

• Blazor sunucusu uygulaması tarafından birden çok kullanıcı isteği işlenir.JavaScript işlevlerini çağırmak için 
bir bileşende DSRuntime.current çağırmayın. 

• iDSRuntime soyutlamasını ekler ve bu nesneyi kullanarak JS birlikte çalışma çağrıları verme. 

• Blazor bir uygulama prerendering olduğunda, tarayıcıyla bir bağlantı kurulmadığından JavaScript 'e çağrı 
yapılamaz. Daha fazla bilgi için, Blazor bir uygulamanın ne zaman prerendering olduğunu Algıla bölümüne 
bakın. 

Aşağıdaki örnek, deneysel bir JavaScript tabanlı kod çözücüsü olan Textdecodertabanlıdır. Örnek, bir C# 
yöntemden JavaScript işlevinin nasıl çağrılacağını gösterir. JavaScript işlevi bir C# yöntemden bir bayt dizisi 
kabul eder, dizinin kodunu çözer ve görüntülenecek metni bileşene döndürür. 

Wwwroot/index.html (Blazor VVebAssembly) veya Pages/_Host. cshtml (Blazor Server) <head> öğesi içinde, 
geçirilen bir dizinin kodunu çözmek İçin TextDecoder kullanan bir JavaScript işlevi sağlayın ve kodu çözülen 
değeri döndürün: 













<script> 

window.convertArray = (winl251Array) => { 

var winl251decoder = new TextDecoder('windows-1251'); 

var bytes = new Uint8Array(winl251Array); 

var decodedArray = winl251decoder.decode(bytes); 

console.log(decodedArray); 

return decodedArray; 

}; 

</script> 

Önceki örnekte gösterilen kod gibi JavaScript kodu, betik dosyasına yönelik bir başvuruya sahip bir JavaScript 
dosyasından ( .js) de yüklenebilir: 

<script src="exampletsInterop.js"x/script> 


Aşağıdaki bileşen: 

• Bir bileşen düğmesi (diziyi Dönüştür) seçildiğinde tSRuntime kullanarak convertArray JavaScript işlevini 
çağırır. 

• JavaScript işlevi çağrıldıktan sonra, geçirilen dizi bir dizeye dönüştürülür.Dize, görüntüleme için bileşene 
döndürülür. 







@page "/cali-js-example" 

@inject IJSRuntime JSRuntime; 

<hl>Call JavaScript Function Example</hl> 

cbutton type="button" class="btn btn-primary" @onclick="ConvertArray"> 
Convert Array 
</button> 

<p class="mt-2" style="font-size:1.6em"> 

<span class="badge badge-success"> 

@ConvertedText 

</span> 

</p> 

@code { 

// Quote (c)2005 Universal Pictures: Serenity 
// https://www.uphe.com/movies/serenity 

// David Krumholtz on IMDB: https://www.imdb.com/name/nm0472710/ 

private MarkupString ConvertedText = 

new MarkupString("Select the <b>Convert Array</b> button."); 

private uint[] QuoteArray = new uint[] 

{ 


60, 

101 , 

109, 62, 67, 97, 110 

, 39, 

, 116, 

, 32, 

, 115 

, 116, : 

111, 

112 , 

32, 

116, 

104, 

, 101, 32, 115, 105, 

103, 

110 , 

97, 

108, 

44, 32 

, 77, 

97, 


108, 

46, 

60, 47, 101, 109, 62 

, 32, 

, 45, 

32, 

77, 

114, 46 

, 32, 

lo 

00 

110 , 

105, 

118, 

, 101, 114, 115, 101, 

10 , 

10 , 








}; 

private async Task ConvertArray() 

{ 

var text = 

await JSRuntime.InvokeAsync<string>("convertArray", QuoteArray); 
ConvertedText = new MarkupString(text); 

StateHasChanged(); 

} 

} 


IJSRuntime kullanımı 

usRuntime soyutlamasını kullanmak için aşağıdaki yaklaşımlardan birini benimseyin: 

• IJSRuntime soyutlama Razor bileşenine (. Razor) ekleme: 

@inject IJSRuntime JSRuntime 
@code { 

protected override void OnInitialized() 

{ 

StocksService.OnStockTickerUpdated += stockUpdate => 

{ 

JSRuntime.InvokeVoidAsync("handleTickerChanged", 
stockUpdate.Symbol, stockUpdate.price); 

}; 

} 

} 

Wwwroot/index.html (Blazor VVebAssembly) veya Pages/_Host. cshtml (Blazor Server) <head> öğesinin 
İçinde, bir handieTickerChanged JavaScript işlevi sağlayın. İşlevi IJSRuntime.invokevoidAsync ile çağrılır ve 







bir değer döndürmez: 


<script> 

window.handleTickerChanged = (symbolj price) => { 

// ... client-side processing/display code ... 

}; 

</script> 

• iDSRuntime soyutlamasını bir sınıfa (. cs) Ekle: 

public class IsInteropClasses 

{ 

private readonly ITSRuntime JsRuntime; 

public IsInteropClassesJlSRuntime jsRuntime) 

{ 

JsRuntime = jsRuntime; 

} 

public ValueTask<string> TickerChanged(string data) 

{ 

retunn JsRuntime.InvokeAsync<stning>( 

"handleTickerChanged ", 
stockUpdate.symbolj 
stockUpdate.price); 

} 

} 

Wwwroot/index.html (Blazor VVebAssembly) veya Pages/_Host. cshtml (Blazor Server) <head> öğesinin 
İçinde, bir handleTickerChanged JavaScript işlevi sağlayın, işlevi ISRuntime.InvokeAsync ile çağrılır ve bir 
değer döndürür: 

<script> 

window.handleTickerChanged = (symbolj price) => { 

// ... client-side processing/display code ... 
return 'Done!'; 

}; 

</script> 

• Buildrendertreeile dinamik içerik oluşturma için [inject] özniteliğini kullanın: 

[Inject] 

IISRuntime ISRuntime { get; set; } 


Bu konuya eşlik eden istemci tarafı örnek uygulamada, Kullanıcı girişi almak ve bir hoş geldiniz iletisi göstermek 
üzere DOM ile etkileşime geçen uygulama için iki JavaScript işlevi mevcuttur: 

• showPrompt - Kullanıcı girişini kabul etmek için bir istem üretir (kullanıcının adı) ve çağıranın adını döndürür. 

• dispiayweicome -, çağıran bir id weicome bir DOM nesnesine bir hoş geldiniz iletisi atar. 


Wwwroot/Examplejsmterop.js\ 








window.examplelsFunctions = { 
showPrompt: function (text) { 

return prompt(text, 'Type your name here'); 

}, 

displayWelcome: function (welcomeMessage) { 

document.getElementById('welcome').innerText = welcomeMessage; 

}, 

returnArrayAsyncls: function () { 

DotNet.invokeMethodAsync('BlazorSample ', 'ReturnArrayAsync') 

.then(data => { 
data.push(4); 

console.log(data); 

}); 

}, 

sayHello: function (dotnetHelper) { 

return dotnetHelper.invokeMethodAsync('SayHello') 

.then(r => console.log(r)); 

} 

}; 

JavaScript dosyasına başvuran <script> etiketini WwwrootAndex.html dosyasında (Blazor VVebAssembly) veya 
Pages/_Host. cshtml dosyasında (Blazor Server) yerleştirin. 

Wwwroot/index.html (Blazor VVebAssembly): 

<!DOCTYPE html> 
chtml lang="en"> 

<head> 

<meta charset="utf-8" /> 

<meta name="viewport" content="width=device-width" /> 

<title>Blazor WebAssembly Sample</title> 

<base href="/" /> 

<link href="css/bootstrap/bootstrap.min.css" rel="stylesheet" /> 
clink href="css/site.css" rel="stylesheet" /> 

</head> 

<body> 

<app>Loading...</app> 

<div id="blazor-error-ui"> 

An unhandled error has occurred. 

<a href="" class="reload">Reload</a> 

<a class="dismiss">ia</a> 

</div> 

<script src="_framework/blazor.webassembly.js"x/script> 

<script src="examplelsInterop.js"x/script> 

</body> 

</html> 


Pages/_Host. cshtml (Blazor sunucusu): 





@page "/" 

@namespace BlazonSample.Pages 

(ŞaddTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 

@{ 

Layout = null; 

} 

<!DOCTYPE html> 

<html lang="en"> 

<head> 

<meta charset="utf-8" /> 

<meta name="viewport" content="width=device-width, initial-scale=1.0" /> 

<title>Blazor Server Sample</title> 

<base href="~/" /> 

<link rel="stylesheet" href="css/bootstrap/bootstrap.min.css" /> 

<link href="css/site.css" rel="stylesheet" /> 

</head> 

<body> 

<app> 

<component type="typeof(App)" render-mode="ServerPrerendered" /> 

</app> 

<div id="blazor-error-ui"> 

<environment include="Stagingj Production"> 

An error has occurred. This application may no longer respond until reloaded. 

</environment> 

<environment include="Development"> 

An unhandled exception has occurred. See browser dev tools for details. 

</environment> 

<a href="" class="reload">Reload</a> 

<a class="dismiss">ia</a> 

</div> 

<script src="_framework/blazor. server. js"x/script> 

<script src="example3sInterop.js"x/script> 

</body> 

</html> 

<script> etiketi dinamik olarak güncelleştirilemediğinden bir <script> etiketini bileşen dosyasına 
yerleştirmeyin. 

.NET yöntemleri, iDSRuntime.invokeAsync<T> çağırarak Examplejsmterop.js dosyasında JavaScript işlevleriyle 
birlikte çalışır. 

msRuntime soyutlama, Blazor sunucu senaryolarına izin vermek için zaman uyumsuzdur. Uygulama bir Blazor 
VVeelsembly uygulaması ise ve bir JavaScript işlevini zaman uyumlu olarak çağırmak istiyorsanız, 
iDSinProcessRuntime ve bunun yerine invoke<T> çağırın. Çoğu J S birlikte çalışma kitaplıklarının, kitaplıkların 
tüm senaryolarda kullanılabilir olmasını sağlamak için zaman uyumsuz API 1 Leri kullanmasını öneririz. 

Örnek uygulama, JS birlikte çalışabilirliği göstermek için bir bileşeni içerir. Bileşen: 

• Bir JavaScript istemi aracılığıyla Kullanıcı girişini alır. 

• işlemek için bileşene metni döndürür. 

• Bir hoş geldiniz iletisini göstermek için DOM ile etkileşime sahip ikinci bir JavaScript işlevini çağırır. 


Pages/Jsmterop. Razor. 








@page "/JSInterop" 

@using BlazonSample.JsInteropClasses 
@inject IJSRuntime JSRuntime 

<hl>JavaScript Interop</hl> 

<h2>Invoke JavaScript functions from .NET methods</h2> 

<button type="button" class="btn btn-primary" @onclick="TriggerJsPrompt"> 

Trigger JavaScript Prompt 
</button> 

<h3 id="welcome" style="color :green;font-style: İtalic"x/h3> 

@code { 

public async Task TriggerJsPrompt() 

{ 

// showPrompt is implemented in wwwroot/exampleJsInterop.js 
var name = await JSRuntime.InvokeAsync<string>( 

"exampleJsFunctions.showPrompt ", 

"Mhat's your name?"); 

// displayWelcome is implemented in wwwroot/exampleJsInterop.js 
await JSRuntime.InvokeVoidAsync( 

"exampleJsFunctions.displayWelcome ", 

$"Hello {name}! Welcome to Blazor!"); 

} 

} 

1 . TriggerJsPrompt , bileşenin tetikleyicisi JavaScript istem düğmesi seçilerek yürütüldüğünde, 
Wwwroot/Examplejsmterop.js dosyasında verilen JavaScript showPrompt işlevi çağırılır. 

2. showPrompt işlevi, HTML kodlu ve bileşene döndürülen kullanıcı girişini (kullanıcının adı) kabul eder.Bileşen, 
kullanıcının adını name yerel bir değişkende depolar. 

3. name depolanan dize, hoş geldiniz iletisini bir başlık etiketine işleyen dispiayweicome bir JavaScript işlevine 
iletilen bir hoş geldiniz iletisine dahil edilir. 

Void JavaScript işlevini çağırın 

Void (0)/void 0 veya undefined döndüren JavaScript işlevleri iJSRuntime.invokeVoidAsync ile çağırılır. 

Blazor bir uygulamanın ne zaman prerendering olduğunu Algıla 

Blazor sunucu uygulaması prerendering olduğunda, tarayıcıyla bir bağlantı kurulmadığından, JavaScript 'e 
çağırma gibi bazı eylemler mümkün değildir. Bileşenler, ön işlenmiş olduğunda farklı şekilde işlenmesi 
gerekebilir. 

Tarayıcı bağlantısı kurulana kadar JavaScript birlikte çalışma çağrılarını geciktirmek için Onafterrenderasync 
bileşen yaşam döngüsü olayınıkullanabilirsiniz. Bu olay yalnızca uygulama tam olarak işlendikten ve istemci 
bağlantısı kurulduktan sonra çağırılır. 










@using Microsoft.DSInterop 
@inject HSRuntime ISRuntime 

<div @ref="divElement">Text during render</div> 

@code { 

private ElementReference divElement; 

protected override async Task OnAfterRenderAsync(bool firstRender) 

{ 

if (firstRender) 

{ 

await ]SRuntime.InvokeVoidAsync( 

"setElementText", divElement, "Text after render"); 

} 

} 


Yukarıdaki örnek kod için, WwwrootAndex.html (Blazor VVebAssembly) veya Pages/_Host. cshtml (Blazor 
Server) <head> Öğesi içinde bir setElementîext JavaScript işlevi sağlayın, işlevi IDSRuntime.InvokeVoidAsync ile 
çağrılır ve bir değer döndürmez: 


<script> 

window.setElementText 
</script> 


(element, text) => element.innerText = text; 


WARNING 

Yukarıdaki örnek yalnızca tanıtım amacıyla Belge Nesne Modeli (DOM) değiştirir. JavaScript, Blazor 'in değişiklik izlemesini 
kesintiye uğradığı için çoğu senaryoda, JavaScript ile DOM 'ı doğrudan değiştirme önerilmez. 


Aşağıdaki bileşen, prerendering ile uyumlu bir şekilde bileşenin başlatma mantığının bir parçası olarak 
JavaScript birlikte çalışabilirinin nasıl kullanılacağını göstermektedir. Bileşeni, onAfterRenderAsync içinden bir 
işleme güncelleştirmesi tetiklemenin mümkün olduğunu gösterir. Geliştirici Bu senaryoda sonsuz bir döngü 
oluşturmaktan kaçınmalıdır. 

ıSRuntime.invokeAsync çağrıldığında, bileşen işlenene kadar hiçbir JavaScript öğesi olmadığından, ElementRef 
yalnızca OnAfterRenderAsync için kullanılır ve daha önceki bir yaşam döngüsü yönteminde değil. 

JavaScript birlikte çalışma çağrısından alınan yeni durumla birlikte bileşeni yeniden sağlamak için 
Statehaschanged çağrılır. stateHasChanged yalnızca infoFromis nuiı olduğunda çağrıldığı için, kod sonsuz bir 
döngü oluşturmaz. 














@page "/prerendered-interop" 

@using Microsoft.AspNetCore.Components 
@using Microsoft.ISInterop 
@inject IISRuntime ISRuntime 

<P> 

Get value via İS interop cali: 

<strong id="val-get-by-interop">@(infoFromls ?? "No value yet")</strong> 

</p> 

Set value via İS interop cali: 

<div id="val-set-by-interop" @ref="divElement"x/div> 

@code { 

private string infoFromls; 
private ElementReference divElement; 

protected override async Task OnAfterRenderAsync(bool firstRender) 

{ 

if (firstRender && infoFromls == null) 

{ 

İnfoFromls = await !SRuntime.InvokeAsync<string>( 

"setElementText", divElement, "Hello from interop cali!"); 

StateHasChanged(); 

} 

} 

} 


Yukarıdaki örnek kod için, WwwrootAndex.html (Blazor VVebAssembly) veya Pages/_Host. cshtml (Blazor 
Server) <head> Öğesi içinde bir setElementText JavaScript işlevi sağlayın, işlevi IISRuntime.InvokeAsync ile 
çağrılır ve bir değer döndürür: 

<script> 

window.setElementText = (element, text) => { 
element.innerText = text; 
return text; 

}; 

</script> 


WARNING 

Yukarıdaki örnek yalnızca tanıtım amacıyla Belge Nesne Modeli (DOM) değiştirir. JavaScript, Blazor 'in değişiklik izlemesini 
kesintiye uğradığı için çoğu senaryoda, JavaScript ile DOM 'ı doğrudan değiştirme önerilmez. 


Öğelere başvuruları yakala 

Bazı JS birlikte çalışma senaryoları HTML öğelerine başvurular gerektirir.Örneğin, bir kullanıcı arabirimi 
kitaplığı başlatma için bir öğe başvurusu gerektirebilir veya focus veya play gibi bir öğe üzerinde komut 
benzeri API 'Ler çağırmanız gerekebilir. 

Aşağıdaki yaklaşımı kullanarak bir bileşen içindeki HTML öğelerine başvuruları yakalayın: 

• HTML öğesine bir @ref özniteliği ekleyin. 

• Adı @ref özniteliği değeri ile eşleşen ElementReference türünde bir alan tanımlayın. 

Aşağıdaki örnek, username <input> öğesine bir başvuru yakalama göstermektedir: 















cinput @ref="username" ... /> 
@code { 

ElementReference username; 

} 


WARNING 

Yalnızca Blazoretkileşimde bulunmayan boş bir öğenin içeriğini bulunmamalıdır için bir öğe başvurusu kullanın. Bu senaryo, 
bir 3. taraf API ’SI öğeye içerik sağladığı zaman yararlıdır. Blazor öğesiyle etkileşmediği için, Blazoröğesi ve DOM gösterimi 
arasında bir çakışma olabilir. 

Aşağıdaki örnekte, Blazor, bu öğenin liste öğelerini ( <ii> ) doldurmak üzere DOM ile etkileşimde bulunduğundan, 
sıralanmamış listenin ( ul ) içeriğini () zaman zaman aşmaktır . 

<ul ref="MyList"> 

@foreach (var item in Todos) 

{ 

<li>@item.Text</li> 

} 

</ul> 

JS birlikte çalışma öğesi, öğe MyList içeriğini değiştiriyorsa ve Blazor SLA 'ya uygulamaya çalışırsa, diffler DOM ile 
eşleşmez. 


.NET kodu açısından düşünüldüğünde, ElementReference donuk bir tanıtıcıdır. ElementReference ile 
yapabileceğiniz tek şey, JS birlikte çalışma yoluyla JavaScript koduna geçiş yapar.Bunu yaptığınızda, JavaScript 
tarafı kodu normal DOM API 'Leri ile kullanılabilecek bir HTMLElement örneğini alır. 

Örneğin, aşağıdaki kod bir öğe üzerinde odağı ayarlamaya izin veren bir .NET genişletme yöntemi tanımlar: 
Examplejsınterop.js: 

window.example]sFunctions = { 

focusElement : function (element) { 
element.focus(); 

} 

} 

Değer döndürmeyen bir JavaScript işlevini çağırmak için iDSRuntime.invokeVoldAsync kullanın. Aşağıdaki kod, 
yakalanan ElementReference önceki JavaScript işlevini çağırarak Kullanıcı adı girişi üzerinde odağı ayarlar: 

@inject HSRuntime DSRuntime 
cinput @ref="username" /> 

cbutton @onclick="SetFocus">Set focus on username</button> 

@code { 

private ElementReference username; 

public async Task SetFocus() 

{ 

await 3SRuntime.InvokeVoidAsync( 

"examplelsFunctions.focusElement ", username); 

} 

} 


Bir genişletme yöntemi kullanmak için iJSRuntime örneğini alan bir statik genişletme yöntemi oluşturun: 














public static async Task Focus(this ElementReference elementRef, ITSRuntime jsRuntime) 

{ 

await jsRuntime.InvokeVoidAsync( 

"exampleJsFunctions.focusElement ", elementRef); 

} 

Focus yöntemi doğrudan nesne üzerinde çağrılır. Aşağıdaki örnek, focus yönteminin isinteropciasses ad 
alanından kullanılabildiğini varsayar: 

@inject IJSRuntime JSRuntime 
@using JsInteropClasses 

cinput @ref="username" /> 

<button @onclick="SetFocus">Set focus on username</button> 

@code { 

private ElementReference username; 

public async Task SetFocus() 

{ 

await username.Focus(lSRuntime); 

} 

} 


IMPORTANT 

username değişkeni yalnızca bileşen işlendikten sonra doldurulur. Doldurulmamış bir ElementReference JavaScript 
koduna geçirilirse, JavaScript kodu bir null değeri alır. Bileşen işlemeyi tamamladıktan sonra öğe başvurularını 
değiştirmek için (bir öğe üzerinde ilk odağı ayarlamak için) Onafterrenderasync veya OnAfterRender bileşen yaşam 
döngüsü yöntemlerinikullanın. 


Genel türlerle çalışırken ve bir değer döndürürken, Valuetask<t > kullanın: 

public static ValueTask<T> GenericMethod<T>(this ElementReference elementRef, 

IJSRuntime jsRuntime) 

{ 

return jsRuntime.InvokeAsync<T>( 

"examplelsFunctions.doSomethingGeneric", elementRef); 

} 

GenericMethod doğrudan nesne üzerinde bir tür ile çağırılır. Aşağıdaki örnek, GenericMethod isinteropciasses 
ad alanından kullanılabilir olduğunu varsayar: 










@inject ITSRuntime tSRuntime 
@using TsInteropClasses 

cinput @ref="username" /> 

<button @onclick="OnClick">Do something generic</button> 

<P> 

returnValue: (SreturnValue 

</p> 

@code { 

private ElementReference username; 
private string returnValue; 

private async Task OnClick() 

{ 

returnValue = await username.GenericMethod<string>(DSRuntime); 

} 

} 


JavaScript işlevlerinden .NET yöntemlerini çağır 

Statik .NET yöntemi çağrısı 

JavaScript 'ten statik bir .NET yöntemi çağırmak için DotNet.invokeMethod veya DotNet.invokeMethodAsync 
işlevlerini kullanın. Çağırmak istediğiniz statik metodun tanımlayıcısını, işlevi içeren derlemenin adını ve tüm 
bağımsız değişkenleri geçirin. Blazor sunucu senaryolarını desteklemek için zaman uyumsuz sürüm tercih edilir. 
JavaScript 'ten bir .N ET yöntemi çağırmak için, .N ET yönteminin public, static ve [jsinvokabie] özniteliğine 
sahip olması gerekir. Varsayılan olarak, yöntem tanımlayıcısı yöntem adıdır, ancak JsinvokabieAttribute 
oluşturucusunu kullanarak farklı bir tanımlayıcı belirtebilirsiniz. Açık genel yöntemlerin çağrılması Şu anda 
desteklenmiyor. 

Örnek uygulama, int s C# dizisini döndürmek için bir yöntem içerir, tsinvokable özniteliği yöntemine 
uygulanır. 

Pages/Jsınterop. Razor. 

<button type="button" class="btn btn-primary" 

onclick="exampleJsFunctions.returnArrayAsyncts()"> 

Trigger .NET static method ReturnArrayAsync 
</button> 

@code { 

[DSInvokable] 

public static Task<int[]> ReturnArrayAsync() 

{ 

return Task.FromResult(new int[] { 1, 2, 3 }); 

} 

} 

istemciye sunulan JavaScript, C# .net yöntemini çağırır. 


Wwwroot/Examplejsmterop.js: 










window.examplelsFunctions = { 
showPrompt: function (text) { 

return prompt(textj 'Type your name here'); 

}, 

displayWelcome: function (welcomeMessage) { 

document.getElementById('welcome').innerText = welcomeMessage; 

L 

returnArrayAsyncls: function () { 

DotNet.invokeMethodAsync('BlazorSample ', 'ReturnArrayAsync') 
.then(data => { 
data.push(4); 

console.log (data); 

}); 

}, 

sayHello: function (dotnetHelper) { 

retunn dotnetHelper.invokeMethodAsync('SayHello') 

.then(r => console.log(r)); 

} 

}; 


Tetikleyici .net static yöntemi ReturnArrayAsync düğmesi seçildiğinde, tarayıcının Web geliştirici 
araçlarında konsol çıkışını inceleyin. 

Konsol çıktısı: 

Array(4) [ 1, 2, 3, 4 ] 

Dördüncü dizi değeri, ReturnArrayAsync tarafından döndürülen diziye ( data.push(4); ) gönderilir. 

Örnek yöntem çağrısı 

JavaScript 'ten de .N ET örnek yöntemlerini çağırabilirsiniz. JavaScript 'ten bir .NET örnek yöntemi çağırmak için: 

• .NET örneğini bir DotNetobjectReference örneğine sarmalayarak JavaScript 'e geçirin. .NET örneği, 

JavaScript 'e başvuruya göre geçirilir. 

• invokeMethod veya invokeMethodAsync işlevlerini kullanarak örnekte ,N ET örnek yöntemlerini çağırın. ,N ET 
örneği, JavaScript 'ten başka .NET yöntemleri çağrılırken bir bağımsız değişken olarak da geçirilebilir. 


NOTE 

Örnek uygulama, iletileri istemci tarafı konsoluna kaydeder. Örnek uygulama tarafından gösterilen aşağıdaki örnekler için 
tarayıcının geliştirici araçlarında tarayıcının konsol çıkışını inceleyin. 


Tetikleyici .N ET örnek yöntemi HelloHelper. SayHello düğmesi seçildiğinde, 
Exampieisinterop.caiiHeiioHeiperSayHeiio çağrılır ve Biazor bir adı yöntemine geçirir. 

Pages/Jsmterop. Razor. 

<button type="button" class="btn btn-primary" @onclick="TriggerNetInstanceMethod"> 
Triggen .NET instance method HelloHelper.SayHello 
</button> 

@code { 

public async Task TriggerNetInstanceMethod() 

{ 

var examplelsInterop = new ExamplelsInterop(lSRuntime); 
await examplelsInterop.CallHelloHelperSayHello("Biazor"); 

} 

} 












caiiHeiioHeipenSayHeiio , JavaScript işlevini sayHello yeni bir HelloHelper örneğiyle çağırır. 
JslnteropClasses/Examplejsmterop. cs: 

public class ExampletsInterop 

{ 

private readonly IISRuntime JsRuntime; 

public Example]sInterop(IlSRuntime jsRuntime) 

{ 

JsRuntime = jsRuntime; 

} 

public ValueTask<string> CallHelloHelperSayHello(string name) 

{ 

// sayHello is implemented in wwwroot/examplelsInterop.js 
return JsRuntime.InvokeAsync<stning>( 

"examplelsFunctions.sayHello ", 

DotNetObjectReference.Create(new HelloHelper(name))); 

} 

} 


Wwwroot/Examplejsınterop.js: 

window.examplelsFunctions = { 
showPrompt: function (text) { 

return prompt(text, 'Type your name here'); 

}, 

displayWelcome: function (welcomeMessage) { 

document.getElementById('welcome').innerText = welcomeMessage; 

}, 

returnArrayAsyncls: function () { 

DotNet.invokeMethodAsync('BlazorSample ', 'ReturnArrayAsync') 

.then(data => { 
data.push(4); 

console.log (data); 

}); 

L 

sayHello: function (dotnetHelper) { 

return dotnetHelper.invokeMethodAsync('SayHello') 

.then(r => console.log(r)); 

} 

}; 

Ad, HelloHelper.Name özelliğini ayarlayan HelloHelper oluşturucusuna geçirilir. JavaScript işlevi sayHello 
yürütüldüğünde, HelloHelper.SayHello JavaScript işlevi tarafından konsola yazılan Hello, {Name}! iletisi 
döndürür. 

JsInteropClasses/HelloHelper. cs: 

public class HelloHelper 

{ 

public HelloHelper(string name) 

{ 

Name = name; 

} 

public string Name { get; set; } 

[JSInvokable] 

public string SayHello() => Ş'^ello, {Name}!"; 

} 













Tarayıcının Web geliştirici araçlarında konsol çıkışı: 


Hello, Blazor! 


Birlikte çalışma kodunu bir sınıf kitaplığında paylaşma 

JS birlikte çalışma kodu bir NuGet paketindeki kodu paylaşmanıza olanak sağlayan bir sınıf kitaplığına dahil 
edilebilir. 

Sınıf kitaplığı, yerleşik derlemede JavaScript kaynaklarını katıştırmayı işler.JavaScript dosyaları Wwwroot 
klasörüne yerleştirilir. Araç, kitaplık oluşturulduğunda kaynakları katıştırmaya önem kazanır. 

Oluşturulan NuGet paketine, uygulamanın proje dosyasında herhangi bir NuGet paketiyle aynı şekilde 
başvurulur. Paket geri yüklendikten sonra, uygulama kodu JavaScript 'e, gibi çağrı yapabilir C#. 

Daha fazla bilgi için bkz. AS P.N ET Core Razor bileşenleri sınıf kitaplıkları. 

Harden JS birlikte çalışma çağrıları 

JS birlikte çalışması, ağ hataları nedeniyle başarısız olabilir ve güvenilmez olarak değerlendirilmelidir.Varsayılan 
olarak, bir Blazor sunucusu uygulaması, bir dakika sonra sunucu üzerinde JS birlikte çalışabilirlik çağrılarını 
zaman aşımına uğrar. Bir uygulama, 10 saniye gibi daha agresif zaman aşımına uğrayedebilmesine, aşağıdaki 
yaklaşımlardan birini kullanarak zaman aşımını ayarlayın: 

• startup.configureServices genel olarak, zaman aşımını belirtin: 

Services.AddServerSideBlazor( 

options => options.DSInteropDefaultCallTimeout = TimeSpan.FromSeconds({SECONDS})); 

• Bileşen kodunda çağrı başına, tek bir çağrı zaman aşımını belirtebilir: 

var result = await ]SRuntime.InvokeAsync<string>("My]SOperation"j 
TimeSpan.FromSeconds({SECONDS})j new[] { "Argl" }); 

Kaynak tükenmesi hakkında daha fazla bilgi için bkz. Güvenli ASP.NET Core Blazor Server uygulamaları. 

Ek kaynaklar 

• InteropComponent. Razor örneği (ASPNET/AspNetCore GitHub deposu, 3,0 yayın dalı) 
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IMPORTANT 

Önizlemede Blazor VVeelsembly 

Blazor sunucusu ASP.NET Core 3,0 ' de desteklenir. Blazor VVebAssembly ASP.NET Core 3,1 için önizlemededir. 


ASP.NET Core, Blazor uygulamalardaki güvenlik yapılandırmasını ve yönetimini destekler. 

Güvenlik senaryoları Blazor Server ve VVebAssembly Apps Blazor farklıdır. Blazor sunucu uygulamaları sunucuda 
çalıştığından, yetkilendirme denetimleri şunları tespit edebilir: 

• Kullanıcıya sunulan kullanıcı ARABİRİMİ seçenekleri (örneğin, bir kullanıcı için hangi menü girişlerinin 
kullanılabildiği). 

• Uygulama ve bileşenlerin bölgeleri için erişim kuralları. 

Blazor VVebAssembly uygulamaları istemcide çalışır.Yetkilendirmeyo/n/zco hangi kullanıcı arabirimi seçeneklerinin 
gösterileceğini belirlemede kullanılır, istemci tarafı denetimleri bir kullanıcı tarafından değiştirililerek veya 
atlandığından, bir Blazor VVebAssembly uygulaması yetkilendirme erişim kurallarını zorunlu kılamaz. 

Kimlik Doğrulama 

Blazor, kullanıcının kimliğini kurmak için mevcut ASP.NET Core kimlik doğrulama mekanizmalarını kullanır.Tam 
mekanizma Blazor uygulamasının nasıl barındırıldığını, Blazor sunucunun veya Blazor VVebAssembly ' ne bağlıdır. 

Blazor sunucusu kimlik doğrulaması 

Blazor Server Apps, SignalRkullanılarak oluşturulan gerçek zamanlı bir bağlantı üzerinden çalışır. SignalRtabanlı 
uygulamalarda kimlik doğrulaması, bağlantı oluşturulduğunda işlenir. Kimlik doğrulaması, bir tanımlama bilgisine 
veya başka bir taşıyıcı belirtecine dayalı olabilir. 

Blazor sunucusu proje şablonu, proje oluşturulduğunda kimlik doğrulamasını sizin için ayarlayabilir. 

• Visual Studio 

• Visual Studio Code 

Kimlik doğrulama mekanizmasına sahip yeni bir Blazor sunucu projesi oluşturmak için ASP.NET Core Blazor 
kullanmaya başlama makalesindeki Visual Studio kılavuzunu izleyin. 

Yeni bir ASP.N ET Core Web uygulaması oluştur iletişim kutusunda Blazor sunucusu uygulama şablonunu 
seçtikten sonra, kimlik doğrulamasıaltında Değiştir ' i seçin. 

Diğer ASP.NET Core projelerine yönelik aynı kimlik doğrulama mekanizması kümesini sunmak için bir iletişim 
kutusu açılır: 

• Kimlik doğrulaması yok 

• Kullanıcı hesaplarının - bireysel kullanıcı hesapları depolanabilir: 
o ASP.NET Core kimlik sistemini kullanarak uygulama içinde. 






o AzureADB2C. 

• İş veya okul hesapları 

• Windows Kimlik Doğrulaması 

Blazor WebAssembly kimlik doğrulaması 

Blazor VVebAssembly uygulamalarında, tüm istemci tarafı kodlar kullanıcılar tarafından değiştirilemediği için kimlik 
doğrulama denetimleri atlanabilir. Aynı, JavaScript SPA çerçeveleri veya herhangi bir işletim sistemi için yerel 
uygulamalar dahil olmak üzere tüm istemci tarafı uygulama teknolojileri için de geçerlidir. 

Uygulamanın proje dosyasına Microsoft. AspNetCore. components. Authorization için bir paket başvurusu ekleyin. 

Blazor VVebAssembly uygulamaları için özel bir AuthenticationstateProvider hizmeti uygulaması aşağıdaki 
bölümlerde ele alınmıştır. 

AuthenticationstateProvider hizmeti 

Blazor Server uygulamaları ASP.NET Core HttpContext.user kimlik doğrulama durumu verilerini alan yerleşik bir 
AuthenticationstateProvider hizmeti içerir. Kimlik doğrulama durumu, mevcut ASP.NET Core sunucu tarafı kimlik 
doğrulama mekanizmalarıyla tümleştirilir. 

AuthenticationstateProvider , kimlik doğrulama durumunu almak için Authorizeview bileşeni ve 
cascadingAuthenticationstate bileşeni tarafından kullanılan temel hizmettir. 

Genellikle AuthenticationstateProvider doğrudan kullanmazsınız. Bu makalenin ilerleyen kısımlarında açıklanan 
Authorizevievv bileşenini veya görev yaklaşımlarını kullanın. AuthenticationstateProvider doğrudan kullanmanın 
ana dezavantajı, temeldeki kimlik doğrulama durumu verileri değişirse bileşen tarafından otomatik olarak 
bildirilmemektedir. 

AuthenticationstateProvider hizmeti, aşağıdaki örnekte gösterildiği gibi geçerli kullanıcının ClaimsPrincipal 
verilerini sağlayabilir: 

@page "/" 

@using Microsoft.AspNetCore.Components.Authorization 

(Şinject AuthenticationstateProvider AuthenticationstateProvider 

<button @onclick="@LogUsername">Write user info to console</button> 

@code { 

private async Task LogUsername() 

{ 

var authState = await AuthenticationstateProvider.GetAuthenticationStateAsync(); 
var user = authState.User; 

if (user.Identity.IsAuthenticated) 

{ 

Console.WriteLine($"{user.Identity.Name} is authenticated."); 

} 

else 

{ 

Console.WriteLine("The user is NOT authenticated."); 

} 

} 

} 

user.Identity.IsAuthenticated true ve Kullanıcı bir ClaimsPrincipalolduğundan, talepler, değerlendirilen rollerde 
numaralandırılabilir ve üyelik yapılabilir. 

Bağımlılık ekleme (dı) ve hizmetleri hakkında daha fazla bilgi için bkz. ASP.NET Core Blazor bağımlılığı ekleme ve 
ASP.NET Core bağımlılık ekleme. 









Özel bir AuthenticationStateProvider uygulama 

Blazor VVebAssembly uygulaması oluşturuyorsanız veya uygulamanızın belirtimi kesinlikle özel bir sağlayıcı 
gerektiriyorsa, bir sağlayıcı uygulayın ve GetAuthenticationstateAsync geçersiz kılın: 

using System.Security.Claims; 
using System.Threading.Tasks; 

using Microsoft.AspNetCore.Components.Authorization; 

namespace BlazorSample.Services 

{ 

public class CustomAuthStateProvider : AuthenticationStateProvider 

{ 

public override Task<AuthenticationState> GetAuthenticationstateAsync() 

{ 

var identity = new Claimsldentity(new[] 

{ 

new Claim(ClaimTypes.Name, "mrfibuli"), 

}, "Fake authentication type"); 

var user = new ClaimsPrincipal(identity); 

return Task.FromResult(new AuthenticationState(user)); 

} 

} 

} 

CustomAuthStateProvider hizmeti Startup.ConfigureServices kaydedilir: 

// using Microsoft.AspNetCore.Components.Authorization; 

// using BlazorSample.Services; 

Services. AddScoped< AuthenticationStateProvider., CustomAuthStateProvider>(); 

CustomAuthStateProvider kullanarak, tüm kullanıcıların Kullanıcı adı mrfibuli kimlik doğrulaması yapılır. 

Kimlik doğrulama durumunu basamaklı bir parametre olarak kullanıma 
sunma 

Kullanıcı tarafından tetiklenen bir eylem gerçekleştirirken olduğu gibi, yordamsal mantık için kimlik doğrulama 
durumu verileri gerekliyse, Task<Authenticationstate> türünde bir geçişli parametre tanımlayarak kimlik doğrulama 
durumu verilerini alın: 




@page "/" 

<button @onclick="@LogUsername">Log username</button> 

@code { 

[CascadingParameter] 

private Task<AuthenticationState> authenticationStateTask { get; set; } 

private async Task LogUsername() 

{ 

var authState = await authenticationStateTask; 
var user = authState.User; 

if (user.Identity.IsAuthenticated) 

{ 

Console.WriteLine($"{user.Identity.Name} is authenticated."); 

} 

else 

{ 

Console.WriteLine("The user is NOT authenticated."); 

} 

} 

} 


NOTE 

Blazor VVebAssembly uygulama bileşeninde, Microsoft.AspNetCore.Components.Authorization 

ad alanını ( 

@using Microsoft.AspNetCore.Components.Authorization ) ekleyin. 



user.Identity.IsAuthenticated true , talepler numaralandırılabilir ve değerlendirilen rollerde üyeliğe eklenebilir. 

App. Razor dosyasındaki AuthorizeRouteview ve cascadingAuthenticationstate bileşenlerini kullanarak 
Task<Authenticationstate> geçişli parametreyi ayarlayın: 

<Router AppAssembly="@typeof(Program).Assembly"> 

<Found Context="routeData"> 

<AuthorizeRouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" /> 

</Found> 

<NotFound> 

<CascadingAuthenticationState> 

<LayoutView Layout="@typeof(MainLayout)"> 

<p>Sorry, there's nothing at this address.</p> 

</LayoutView> 

</CascadingAuthenticationstate) 

</NotFound> 

</Router> 


Yetkilendirme 

Bir kullanıcının kimliği doğrulandıktan sonra, kullanıcının neler yapabileceğini denetlemek için Yetkilendirme 
kuralları uygulanır. 

Erişim, genellikle aşağıdakileri yapıp verilmeksizin verilir veya reddedilir: 

• Bir kullanıcının kimliği doğrulanır (oturum açıldı). 

• Bir Kullanıcı bir roldür. 

• Bir kullanıcının fo/eb/vardır. 

• Bir ilke karşılandı. 







Bu kavramların her biri, ASP.NET Core MVC veya Razor Pages uygulamasındaki ile aymdir.ASP.NET Core 
güvenliği hakkında daha fazla bilgi için, ASP.NET Core güvenlik ve kimlik' in altındaki makalelere bakın. 

AuthorizeVievv bileşeni 

Authorizeview bileşeni, kullanıcının onu görme yetkisine sahip olup olmadığına bağlı olarak Kullanıcı 
ARABİRİMİNİ seçmeli olarak görüntüler. Bu yaklaşım yalnızca Kullanıcı için veri görüntülemesi gerektiğinde ve 
Kullanıcı kimliğini yordamsal mantığda kullanmanıza gerek olmadığında yararlıdır. 



Kullanıcının kimliği doğrulanmadıysa, görüntülenmek üzere farklı içerikler de sağlayabilirsiniz: 



Kullanıcı arabirimi seçeneklerini veya erişimini denetleyen roller veya ilkeler gibi yetkilendirme koşulları, 
Yetkilendirme bölümünde ele alınmıştır. 

Yetkilendirme koşulları belirtilmemişse, Authorizeview varsayılan bir ilke kullanır ve şu şekilde davranır: 

• Kimliği doğrulanmış (oturum açmış) kullanıcılar yetkili olarak. 

• Kimliği doğrulanmamış (oturumu açılmış) kullanıcılar yetkilendirilmemiş. 

Rol tabanlı ve ilke tabanlı yetkilendirme 

Authorizeview bileşeni rol tabanU veya ilke tabanli yetkilendirmeyi destekler. 

Rol tabanlı yetkilendirme için Roles parametresini kullanın: 

<AuthorizeView Roles="admin, superuser"> 

<p>You can only see this if you're an admin or superuser.</p> 

</AuthorizeView> 


Daha fazla bilgi için bkz. ASP.NET Core rol tabanlı yetkilendirme, 
ilke tabanlı yetkilendirme için Poücy parametresini kullanın: 


<AuthorizeView Poücy="content-editör"> 

<p>You can only see this if you satisfy the "content-editor" policy.</p> 
</AuthorizeView> 











Talep tabanlı yetkilendirme, ilke tabanlı yetkilendirme için özel bir durumdur.Örneğin, kullanıcıların belirli bir talebe 
sahip olmasını gerektiren bir ilke tanımlayabilirsiniz. Daha fazla bilgi için bkz. ASP.NET Core ilke tabanlı 
yetkilendirme. 

Bu API 'Ler Blazor sunucuda Blazor ya da VVebAssembly uygulamalarında kullanılabilir. 

Ne Roles nede Policy belirtilmemişse, AuthorizeView varsayılan ilkeyi kullanır. 

Zaman uyumsuz kimlik doğrulaması sırasında görünen içerik 

Blazor, kimlik doğrulaması durumunun zaman uyumsuzo\arak belirlenmesine izin verir. Bu yaklaşım için birincil 
senaryo, kimlik doğrulaması için bir dış uç noktaya istek yapan Blazor VVebAssembly Apps ' dedir. 

Kimlik doğrulaması devam ederken, Authorizeview varsayılan olarak içerik görüntülemez. Kimlik doğrulama 
gerçekleştiğinde içeriği göstermek için <Authorizing> öğesini kullanın: 

<AuthorizeView> 

<Authorized> 

<hl>Hello, @context.User.Identity.Name!</hl> 

<p>You can only see this content if you're authenticated.</p> 

</Authorized> 

<Authorizing> 

<hl>Authentication in progress</hl> 

<p>You can only see this content while authentication is in progress.</p> 

</Authorizing> 

</AuthorizeView> 


Bu yaklaşım normalde Blazor Server uygulamaları için geçerli değildir. Blazor sunucu uygulamaları, durum 
oluşturulur almaz kimlik doğrulama durumunu bilir. Authorizing içerik Blazor sunucu uygulamasının 
Authorizeview bileşeninde bulunabilir, ancak içerik hiçbir şekilde gösterilmez. 

[Yetkilendir] özniteliği 

[Authorize] özniteliği Razor bileşenlerinde kullanılabilir: 

@page "/" 

@attribute [Authorize] 

You can only see this if you're signed in. 


NOTE 

Blazor VVebAssembly uygulama bileşeninde, bu bölümdeki örneklere Microsoft.AspNetcore.Authorization ad alanını ( 
@using Microsoft. AspNetCore. Authorization ) ekleyin. 


IMPORTANT 

Yalnızca Blazor yönlendirici üzerinden ulaşılan @page bileşenlerinde [Authorize] kullanın. Yetkilendirme yalnızca, bir sayfada 
işlenen alt bileşenler için değil , yönlendirmenin bir yönü olarak gerçekleştirilir. Bir sayfa içindeki belirli parçaların 
görüntülenmesini yetkilendirmek için, bunun yerine Authorizeview kullanın. 


[Authorize] özniteliği rol tabanlı veya ilke tabanlı yetkilendirmeyi de destekler. Rol tabanlı yetkilendirme için 
Roles parametresini kullanın: 













@page "/" 

(Şattribute [Authorize(Roles = "admin, superuser")] 

<p>You can only see this if you're in the ’admin' on 'superuser' role.</p> 
ilke tabanlı yetkilendirme için Policy parametresini kullanın: 

@page "/" 

(Şattribute [Authorize(Policy = "content-editor")] 

<p>You can only see this if you satisfy the 'content-editor' policy.</p> 

Ne Roles nede Policy belirtilmemişse, [Authorize] varsayılan ilkeyi kullanır, bu varsayılan olarak kabul edilir: 

• Kimliği doğrulanmış (oturum açmış) kullanıcılar yetkili olarak. 

• Kimliği doğrulanmamış (oturumu açılmış) kullanıcılar yetkilendirilmemiş. 

Yönlendirici bileşeniyle yetkisiz içeriği özelleştirme 

AuthorizeRouteView bileşeniyle birlikte Router bileşeni, uygulamanın şu durumlarda özel içerik belirlemesine izin 
verir: 

• içerik bulunamadı. 

• Kullanıcı, bileşene uygulanan bir [Authorize] koşulunu başarısız olur. [Authorize] özniteliği [Authorize] 
öznitelik bölümünde ele alınmıştır. 

• Zaman uyumsuz kimlik doğrulama devam ediyor. 

Varsayılan Blazor sunucusu proje şablonunda, app. Razor dosyası nasıl özel içerik ayarlanacağını gösterir: 

<Router AppAssembly="@typeof(Program).Assembly"> 

<Found Context="routeData"> 

<AuthorizeRouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)"> 

<NotAuthorized> 

<hl>Sorry</hl> 

<p>You're not authorized to reach this page.</p> 

<p>You may need to log in as a different user.</p> 

</NotAuthorized> 

<Authorizing> 

<hl>Authentication in progress</hl> 

<p>Only visible while authentication is in progress.</p> 

</Authorizing> 

</AuthorizeRouteView> 

</Found> 

<NotFound> 

<CascadingAuthenticationState> 

<LayoutView Layout="@typeof(MainLayout)"> 

<hl>Sorry</hl> 

<p>Sorryj there's nothing at this address.</p> 

</LayoutView> 

</CascadingAuthenticationState> 

</NotFound> 

</Router> 

<NotFound> , <NotAuthorized> ve <Authorizing> etiketlerinin içeriği, diğer etkileşimli bileşenler gibi rastgele öğeler 
içerebilir. 

<NotAuthorized> öğesi belirtilmemişse, AuthorizeRouteview aşağıdaki geri dönüş iletisini kullanır: 















Not authorized. 


Kimlik doğrulama durumu değişiklikleri hakkında bildirim 

Uygulama, temeldeki kimlik doğrulama durumu verilerinin değiştiğini belirlerse (örneğin, Kullanıcı oturumu 
kapattığından veya başka bir kullanıcı rollerini değiştirse), özel bir AuthenticationstateProvider isteğe bağlı olarak 
AuthenticationstateProvider temel sınıfında yöntemi NotifyAuthenticationstatechanged çağırabilir. Bu, yeni verileri 
kullanarak yeniden kimlik doğrulama durumu verilerini (örneğin, Authorizeview ) tüketicilere bildirir. 

Yordamsal mantık 

Uygulama, yordamsal mantığın bir parçası olarak yetkilendirme kurallarını denetmek için gerekliyse, kullanıcının 



(Şinject IAuthorizationService AuthorizationService 

<button @onclick="@DoSomething">Do something important</button> 

@code { 

[CascadingParameter] 

private Task<AuthenticationState> authenticationStateTask { get; set; } 

private async Task DoSomething() 

{ 

var user = (await authenticationStateTask).User; 

if (user.Identity.IsAuthenticated) 

{ 

// Perform an action only available to authenticated (signed-in) users. 

} 

if (user.IsInRole("admin")) 

{ 

// Perform an action only available to users in the 'admin' role. 

} 

if ((await AuthorizationService.AuthorizeAsync(user, "content-editor")) 
.Succeeded) 

{ 

// Perform an action only available to users satisfying the 
// 'content-editor' policy. 

} 

} 

} 



Blazor VVebAssembly uygulamalarında yetkilendirme 











Blazor VVebAssembly uygulamalarında, tüm istemci tarafı kodlar kullanıcılar tarafından değiştirilemediği için 
yetkilendirme denetimleri atlanabilir. Aynı, JavaScript SPA çerçeveleri veya herhangi bir işletim sistemi için yerel 
uygulamalar dahil olmak üzere tüm istemci tarafı uygulama teknolojileri için de geçerlidir. 

İstemci tarafı uygulamanız tarafından erişilen tüm API uç noktalarında sunucuda her zaman 
yetkilendirme denetimleri gerçekleştirin. 

Sorun giderme hataları 

Yaygın hatalar: 

• Yetkilendirme, görev<AuthenticationState > türünde bir geçişli parametre gerektirir. Bunu 
sağlamak için basamaklı Dingauthenticationstate kullanmayı göz önünde bulundurun. 

• null değer authenticationStateTask alindi 

Projenin kimlik doğrulaması etkin bir Blazor sunucu şablonu kullanılarak oluşturulmamış olması olasıdır. 
<cascadingAuthenticationstate> UI ağacının bir parçası etrafında sarmalayın, örneğin, app. Razor içinde aşağıdaki 
gibi: 

<CascadingAuthenticationState> 

<Router AppAssembly="typeof(Startup).Assembly"> 

</Router> 

</CascadingAuthenticationState> 

cascadingAuthenticationstate , Task<Authenticationstate> basamaklı parametresini sağlar ve bu, temel alınan 
AuthenticationStateProvider Dİ hizmetinden alır. 


Ek kaynaklar 

• ASP.NET Core güvenliğine genel bakış 

• Güvenli ASP.NET Core Blazor Server uygulamaları 

• ASP.NET Core VVİndovvs kimlik doğrulamasını yapılandırma 





Güvenli ASPNET Core Blazor Server uygulamaları 
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Sağlayan Javier Calvarro Nelson 

sunucu uygulamaları Blazor sunucu ve istemcinin uzun süreli bir ilişki korumasını gerektiren, durum bilgisi olan bir 
veri işleme modelini benimseyin. Kalıcı durum, büyük olasılıkla uzun süreli bağlantılara yayılabilen bir 
devretarafından korunur. 

Bir Kullanıcı Blazor sunucu sitesi ziyaret ettiğinde sunucu, sunucunun belleğinde bir devre oluşturur. Devre, 
kullanıcının Kullanıcı ARABİRİMİNDE bir düğme seçtiğinde olduğu gibi olaylara hangi içeriğin işleneceğini ve yanıt 
verdiğini tarayıcıya gösterir. Bu işlemleri gerçekleştirmek için, devre bir bağlantı, kullanıcının tarayıcısında ve .NET 
yöntemlerinde JavaScript işlevlerini çağırır. Bu iki yönlü JavaScript tabanlı etkileşim, JavaScript birlikte çalışma (js 
birlikte çalışma)olarak adlandırılır. 

JS birlikte çalışması Internet üzerinden yapıldığından ve istemci uzak bir tarayıcı kullandığından Blazor sunucu 
uygulamaları çoğu Web uygulaması güvenlik kaygılarını paylaşır. Bu konu, sunucu uygulamalarına Blazor yönelik 
yaygın tehditleri açıklar ve Internet 'e yönelik uygulamalara odaklanmış tehdit azaltma kılavuzu sağlar. 

Şirket ağları veya intranetleri gibi kısıtlı ortamlarda, azaltma yönerglarından bazıları şunlardır: 

• Kısıtlanmış ortamda uygulanmaz. 

• Güvenlik riski kısıtlı bir ortamda azaldığından, uygulama maliyeti değer değildir. 

Kaynak tükenmesi 

istemci sunucuyla etkileşime geçtiğinde kaynak tükenmesi gerçekleşebilir ve sunucunun aşırı kaynak kullanmasına 
neden olur. Aşırı kaynak tüketimi öncelikle şunları etkiler: 

• CPU 

• Bellek 

• istemci bağlantıları 

Hizmet reddi (DoS) saldırıları genellikle bir uygulamanın veya sunucunun kaynaklarını tüketme konusunda arama 
yapılır. Ancak, kaynak tükenmesi sistem üzerinde bir saldırının sonucu değildir.Örneğin, yüksek Kullanıcı talebi 
nedeniyle sınırlı kaynaklar tükenebilir. DoS, hizmet reddi (DOS) saldırıları bölümünde daha fazla ele alınmıştır. 

Veritabanları ve dosya tutamaçları (dosyaları okumak ve yazmak için kullanılır) gibi Blazor Framevvork harici 
kaynakları kaynak tükenmesi de yaşayabilir. Daha fazla bilgi için bkz. ASP.NET Core performans En İyi yöntemleri. 

CPU 

Bir veya daha fazla istemci, yoğun CPU işi gerçekleştirmeye çalışan bir veya daha fazla istemci tarafından meydana 
gelebilir. 

Örneğin, Fibonnacci numarasmıbesaplayan bir Blazor sunucusu uygulaması düşünün. Bir Fibonnacci numarası, 
dizideki her bir sayının önceki iki sayının toplamı olduğu bir Fibonnacci sırasından oluşturulur. Yanıta ulaşmak için 
gereken iş miktarı, sıranın uzunluğuna ve ilk değerin boyutuna bağlıdır. Uygulama bir istemcinin isteğine sınır 
yerleştirmezse, CPU yoğunluklu hesaplamalar CPU 'nun süresini ayırt edebilir ve diğer görevlerin performansını 
azalrlar. Aşırı kaynak tüketimi, kullanılabilirliği etkileyen bir güvenlik konusudur. 

CPU tükenmesi, herkese açık olan tüm uygulamalar için bir sorun teşkil etmez. Normal Web uygulamalarında, 
istekler ve bağlantılar bir güvenlik önlemi olarak zaman aşımına uğrar, ancak Blazor Server uygulamaları aynı 
korumaları sağlamaz. Blazor Server uygulamaları, CPU yoğun olabilecek işleri gerçekleştirmeden önce uygun 





denetimleri ve limitleri içermelidir. 

Bellek 

Bir veya daha fazla istemci, sunucuyu büyük miktarda bellek kullanmaya zorlmaya zorlarsanız bellek tükenmesi 
meydana gelebilir. 

Örneğin, öğelerin listesini kabul eden ve görüntüleyen bir bileşen ile Blazorsunucu tarafı uygulamasını düşünün. 
Blazor uygulama, izin verilen öğe sayısı veya istemciye geri işlenen öğe sayısı için sınır yerleştirmezse, bellek yoğun 
işleme ve işleme sunucu belleğini sunucunun performansının bulunduğu noktaya göre olumsuz etkileyebilir. 
Sunucu kilitlenmişse veya çöktüğünde göründüğü noktadan yavaş olabilir. 

Sunucuda olası bir bellek tükenmesi senaryosuna ait öğelerin listesini sürdürmek ve görüntülemek için aşağıdaki 
senaryoyu göz önünde bulundurun: 

• Bir List<Myitem> özellik veya alanındaki öğeler, sunucunun belleğini kullanır. Uygulama, öğelerin listesinin 
sınırsız olarak büyümesine izin veriyorsa, sunucunun belleği tükenmeye karşı bir risk vardır. Belleğin 
tükenmesinin geçerli oturum sonlandırmasına (kilitlenme) ve bu sunucu örneğindeki tüm eşzamanlı oturumlara 
bir bellek dışı özel durum almasına neden olur. Bu senaryonun oluşmasını önlemek için, uygulamanın eşzamanlı 
kullanıcılara bir öğe sınırı uygulayan bir veri yapısı kullanması gerekir. 

• Bir sayfalama şeması işleme için kullanılmazsa, sunucu Kullanıcı arabiriminde görünmeyen nesneler için ek 
bellek kullanır. Öğe sayısı sınırı olmadan, bellek talepleri kullanılabilir sunucu belleğini tüketebilir. Bu senaryoyu 
engellemek için aşağıdaki yaklaşımlardan birini kullanın: 

o işleme sırasında sayfalandırılmış listeler kullanın. 

o Yalnızca ilk 100 1 i 1.000 öğeyi görüntüleyin ve kullanıcının görüntülenen öğelerin ötesinde öğeleri 
bulmak için arama ölçütü girmesini gerektirir. 

o Daha gelişmiş bir işleme senaryosu için sarıallaştırmayidestekleyen listeler veya kılavuzlar uygulayın. 
Sanallaştırma kullanarak, listeler yalnızca kullanıcıya şu anda görünür olan öğelerin bir alt kümesini işler. 
Kullanıcı ARABİRİMDEKİ ScrolIBar ile etkileşime geçtiğinde, bileşen yalnızca görüntüleme için gereken 
öğeleri işler. Şu anda görüntülenmek üzere gerekli olmayan öğeler, en ideal yaklaşım olan ikincil 
depolamada tutulabilir. Görüntülenmezler olmayan öğeler bellekte tutulabilir ve bu da daha az idealdir. 

Blazor Server Apps, WPF, VVİndovvs Forms veya Blazor VVebAssembly gibi durum bilgisi olan uygulamalar için 
diğer kullanıcı arabirimi çerçevelerine benzer bir programlama modeli sunar. Ana fark, uygulama tarafından 
tüketilen belleğin, istemciye ait olduğu ve yalnızca o tek istemciyi etkilediği bazı Kullanıcı arabirimi çerçevelerinden 
biridir. Örneğin, bir Blazor VVebAssembly uygulaması tamamen istemcide çalışır ve yalnızca istemci bellek 
kaynaklarını kullanır. Blazor sunucusu senaryosunda, uygulama tarafından tüketilen bellek sunucuya aittir ve 
sunucu örneğindeki istemciler arasında paylaşılır. 

Sunucu tarafı bellek talepleri tüm Blazor sunucu uygulamaları için bir noktadır. Ancak, çoğu Web uygulaması 
durum bilgisiz olur ve bir isteği işlerken kullanılan bellek, yanıt döndürüldüğünde serbest bırakılır. Genel bir öneri 
olarak, istemcilerin, istemci bağlantılarını devam eden diğer tüm sunucu tarafı uygulamalarda olduğu gibi ilişkisiz 
miktarda bellek ayırmasına izin vermez. Bir Blazor sunucusu uygulaması tarafından tüketilen bellek, tek bir istekten 
daha uzun bir süre devam ettirir. 


NOTE 

Geliştirme sırasında, bir profil oluşturucu kullanılabilir veya istemci bellek taleplerini değerlendirmek için yakalanan bir izleme 
olabilir. Profil Oluşturucu veya izleme, belirli bir istemciye ayrılan belleği yakalamaz. Geliştirme sırasında belirli bir istemcinin 
bellek kullanımını yakalamak için, bir döküm yakalayın ve Kullanıcı devresi içinde kök olan tüm nesnelerin bellek talebini 
inceleyin. 


İstemci bağlantıları 

Bir veya daha fazla istemci sunucuya çok fazla eş zamanlı bağlantı açtıklarında, diğer istemcilerin yeni bağlantı 
kurmasını engellediğinden bağlantı tükenmesi meydana gelebilir. 







Blazor istemcileri, oturum başına tek bir bağlantı kurar ve tarayıcı penceresi açık olduğu sürece bağlantıyı açık halde 
tutar. Tüm bağlantıları koruma sunucusundaki talepler Blazor uygulamalarına özgü değildir. Bağlantıların kalıcı 
doğası ve Blazor Server uygulamalarının durum bilgisi olan doğası göz önüne alındığında, bağlantı tükenmesi 
uygulamanın kullanılabilirliğine daha fazla risk taşır. 

Varsayılan olarak, bir Blazor sunucusu uygulaması için Kullanıcı başına bağlantı sayısı sınırı yoktur. Uygulama bir 
bağlantı sınırı gerektiriyorsa aşağıdaki yaklaşımlardan birini veya daha fazlasını yapın: 

• Yetkisiz kullanıcıların uygulamaya bağlanma yeteneğini doğal olarak sınırlayan kimlik doğrulaması gerektir. Bu 
senaryonun etkili olabilmesi için kullanıcıların,' de Yeni Kullanıcı sağlaması engellenmelidir. 

• Kullanıcı başına bağlantı sayısını sınırlayın. Bağlantıları sınırlandırma, aşağıdaki yaklaşımlar aracılığıyla 
gerçekleştirilebilir. Meşru kullanıcıların uygulamaya erişmesine izin vermeye özen gösterin (örneğin, istemcinin 
İP adresine göre bir bağlantı sınırı oluşturulduğunda). 

o Uygulama düzeyinde: 

o Uç nokta yönlendirme genişletilebilirliği. 

o Uygulamaya bağlanmak ve Kullanıcı başına etkin oturumları izlemek için kimlik doğrulaması 
gerektir. 

o Sınıra ulaştıktan sonra yeni oturumları reddedin. 

o istemcilerden bir uygulamaya bağlantıları oluşturan Azure SignalR hizmeti gibi bir ara sunucu 
aracılığıyla uygulamaya yönelik proxy VVebSocket bağlantıları. Bu, tek bir istemcinin 
yapabileceğinden daha fazla bağlantı kapasitesine sahip bir uygulama sağlar ve istemcinin sunucu 
bağlantılarını tüketmesini önler. 

o Sunucu düzeyinde: uygulamanın önünde bir proxy/ağ geçidi kullanın. Örneğin, Azure ön kapısı, Web 
trafiğinin bir uygulamaya küresel olarak yönlendirilmesini tanımlamanıza, yönetmenize ve izlemenize 
olanak sağlar. 

Hizmet reddi (DoS) saldırıları 

Hizmet reddi (DoS) saldırıları, istemcinin bir veya daha fazla kaynağın bir veya daha fazla uygulamayı tüketmesine 
neden olan bir istemciyi içerir. Blazor Server uygulamaları, bazı varsayılan limitleri içerir ve DoS saldırılarına karşı 
koruma sağlamak için diğer ASP.NET Core ve SignalR limitlerini kullanır: 


BLAZOR SUNUCUSU UYGULAMA SINIRI AÇIKLAMA 

VARSAYILAN 

CircuitOptions.Disconnectedcir'cuitMaxRfldirHisir sunucunun bellekte tek seferde 

tuttuğu bağlantı kesilen en fazla 
bağlantı sayısı. 

100 

Circuitoptions. DisconnectedCircuitReterBaiğlaPltelıktfSİlmiş bir devre dışı 

bırakılmadan önce bellekte tutulan en 

fazla süre. 

3 dakika 

circuitoptions. nsinteropDefaultcallTimeJaman uyumsuz bir JavaScript işlev 

çağrısını zaman aşımına uğramadan 
önce sunucunun bekleyeceği en fazla 
süre. 

1 dakika 

Circuitoptions.MaxBufferedUnacknowledgfiTRfaalartBkÜtiteemiş işleme toplu işi 

sayısı sunucu, güçlü yeniden bağlanmayı 
desteklemek için belirli bir zamanda her 
bir devreye göre bellekte kalır. Sınıra 
ulaştıktan sonra sunucu, bir veya daha 
fazla toplu iş istemci tarafından 
onaylanana kadar yeni oluşturma toplu 
işleri oluşturmayı durduruyor. 
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SIGNALR VE ASP.NET CORE SINIRI 


AÇIKLAMA 


VARSAYILAN 


CircuitOptions .MaximumReceiveMessageSizfek bir İleti İçin İleti boyutu. 


32 KB 


Tarayıcıyla etkileşimler (istemci) 

istemci, JS birlikte çalışma olayı gönderme ve işleme tamamlama aracılığıyla sunucuyla etkileşime girer.JS birlikte 
çalışma iletişimi, JavaScript ve .NET arasında her iki yolla da geçer: 

• Tarayıcı olayları istemciden sunucuya zaman uyumsuz biçimde gönderilir. 

• Sunucu, gerektiği şekilde kullanıcı arabiriminden zaman uyumsuz olarak rerendering. 

.NET 'ten çağrılan JavaScript işlevleri 

.NET yöntemlerinden JavaScript 'e yapılan çağrılar için: 

• Tüm etkinleştirmeleri, başarısız olduktan sonra, çağırana bir OperationCanceledException döndüren 
yapılandırılabilir bir zaman aşımı sağlar. 

o Bir dakikalık çağrılar ( CircuitOptions. JSinteropDefauitcaiiTimeout ) için varsayılan bir zaman aşımı vardır. 

Bu sınırı yapılandırmak için bkz. ASP.NET Core Blazor JavaScript birlikte çalışabilirliği. 
o iptal belirtecini çağrı başına temelinde denetlemek için bir iptal belirteci sağlayabilirsiniz. Bir iptal belirteci 
sağlandıysa, mümkün olan ve istemciye yapılan tüm çağrıların zaman içinde sağlandığı varsayılan çağrı 
zaman aşımını kullanır. 

• JavaScript çağrısının sonucu güvenilir olamaz. Tarayıcıda çalışan Blazor uygulama istemcisi çağırmak için 
JavaScript işlevini arar, işlev çağrılır ve sonuç ya da bir hata oluşturulur. Kötü amaçlı bir istemci şunları 
gerçekleştirmeye çalışabilir: 

o JavaScript işlevinden bir hata döndürerek uygulamada sorun oluşmasına neden olur, 
o JavaScript işlevinden beklenmeyen bir sonuç döndürerek sunucuda istemeden bir davranış alır. 

Yukarıdaki senaryolara karşı koruma için aşağıdaki önlemleri alın: 

• Try-catch DEYİMLERİ içindeki js birlikte çalışabilirlik çağrılarını, çağırma sırasında oluşabilecek hataları hesaba 
eklemek için kaydırın. Daha fazla bilgi için bkz. AS P.N ET Core Blazor uygulamalarda hataları işleme. 

• Herhangi bir işlem yapmadan önce, hata iletileri de dahil olmak üzere J S birlikte çalışma çağırmaları tarafından 
döndürülen verileri doğrulayın. 

Tarayıcıdan çağrılan .NET yöntemleri 

JavaScript 'e yönelik çağrılara .NET yöntemlerine güvenmeyin. JavaScript 'e bir .NET yöntemi sunulduğunda, .NET 
yönteminin nasıl çağrılacağını göz önünde bulundurun: 

• Uygulamaya genel bir uç nokta gibi, JavaScript 'e sunulan tüm .NET metodunu değerlendirin, 
o Girişi doğrula. 

o Değerlerin beklenen aralıklar içinde olduğundan emin olun, 
o Kullanıcının istenen eylemi gerçekleştirme izni olduğundan emin olun, 
o .N ET Yöntem çağırma kapsamında aşırı miktarda kaynak ayırmayın. Örneğin, denetim gerçekleştirin ve 
CPU ve bellek kullanımı için sınır koyun. 

o Statik ve örnek yöntemlerinin JavaScript istemcilerine sunutabileceğiniz hesaba sahip olun. Tasarım, 
uygun kısıtlamalarla durum paylaşma için çağrı yaptığı müddetçe, oturumlar arasında durum 
paylaşmaktan kaçının. 

o İlk olarak bağımlılık ekleme (Dİ) aracılığıyla oluşturulan DotNetReference nesneleri aracılığıyla 
kullanıma sunulan örnek yöntemleri için nesnelerin kapsamlı nesneler olarak kaydedilmesi gerekir. 

Bu, Blazor sunucu uygulamasının kullandığı tüm Dİ Hizmetleri için geçerlidir. 
o Statik yöntemler için, uygulama bir sunucu örneğindeki tüm kullanıcılar genelinde durum 





tasarımını özel olarak paylaşmadığı müddetçe, istemciye kapsamdaki durumu oluşturmaktan 
kaçının. 

o Parametrelerde Kullanıcı tarafından sağlanan verileri JavaScript çağrılarına geçirmekten kaçının. 
Parametrelerde veri geçirilmesi kesinlikle gerekliyse, JavaScript kodunun, siteler arası betik oluşturma 
(XSS) güvenlik açıklarına gerek kalmadan verileri geçirmeyi işlediğinden emin olun. Örneğin, bir öğenin 
innerHTML özelliğini ayarlayarak Belge Nesne Modeli (DOM) Kullanıcı tarafından sağlanan verileri 
yazma, evai ve diğer güvenli olmayan JavaScript temel öğelerini devre dışı bırakmak için İçerik güvenlik 
ilkesi (CSP) kullanmayı düşünün. 

• Framevvork 'ün gönderme uygulamasının en üstünde .NET etkinleştirmeleri için özel bir dağıtma uygulamaktan 
kaçının. .N ET yöntemlerini tarayıcıya sunma, genel Blazor geliştirme için önerilmeyen gelişmiş bir senaryodur. 

Olaylar 

Olaylar Blazor sunucusu uygulamasına bir giriş noktası sağlar. Web Apps 'teki uç noktaları koruma için aynı kurallar, 
Blazor Server uygulamalarındaki olay işleme için geçerlidir. Kötü amaçlı bir istemci, istediği verileri bir olay için yük 
olarak gönderebilirler. 

Örneğin: 

• Bir <seiect> için değişiklik olayı, uygulamanın istemciye sunulan seçenekler içinde olmayan bir değer 
gönderebilir. 

• <input> , istemci tarafı doğrulamayı atlayarak herhangi bir metin verisini sunucuya gönderebilir. 

Uygulamanın, uygulamanın işlediği herhangi bir olay için verileri doğrulaması gerekir. Blazor Framevvork Forms 
bileşenleri temel doğrulamaları gerçekleştirir. Uygulama özel form bileşenleri kullanıyorsa, olay verilerinin uygun 
şekilde doğrulanması için özel kodun yazılması gerekir. 

Blazor sunucu olayları zaman uyumsuzdur, bu nedenle uygulamanın yeni bir işleme üreten bir işleme süresi 
geçmeden önce sunucuya birden çok olay gönderilebilir. Göz önünde bulundurulması gereken bazı güvenlik etkileri 
vardır. Uygulamadaki istemci eylemlerinin sınırlandırmasının, olay işleyicileri içinde gerçekleştirilmesi ve geçerli 
işlenen görünüm durumuna bağlı olmaması gerekir. 

Bir kullanıcının bir sayacı en fazla üç kez artmasını sağlayan bir sayaç bileşeni düşünün. Sayacı artırma düğmesi, 
count değerine göre koşullu olarak belirlenir: 

<p>Count: @count<p> 

Şif (count < 3) 

{ 

<button @onclick="IncrementCount" value="Increment count" /> 

} 

Şcode 

{ 

pnivate int count = 0 ; 

pnivate void IncrementCount() 

{ 

count++; 

} 

} 

Bir istemci, çerçeve bu bileşenin yeni bir işlemesini oluşturmadan önce bir veya daha fazla artış olayı gönderebilir. 
Bu, düğme kullanıcı ARABİRİMİ tarafından yeterince hızlı bir şekilde kaldırılmadığı için count , Kullanıcı tarafından 
üç kez artılabildiğinden oluşur. Üç count artımlarının sınırına ulaşmak için doğru yol aşağıdaki örnekte 
gösterilmiştir: 











<p>Count: @count<p> 

Şif (count < 3) 

{ 

<button @onclick="IncrementCount" value="Incr'ement count" /> 

} 

Şcode 

{ 

pnivate int count = 0; 

pnivate void IncrementCount() 

{ 

if (count < 3) 

{ 

count++; 

} 

} 

} 

İşleyicinin içindeki if (count < 3) { ... } denetimini ekleyerek, count artırma kararı geçerli uygulama durumuna 
göre belirlenir. Bu karar, önceki örnekte olduğu gibi Kullanıcı arabiriminin durumunu temel değildir ve bu da geçici 
olarak eski olabilir. 

Birden çok gönderine karşı koruma 

Bir olay geri çağırması, bir dış hizmetten veya veritabanından veri getirme gibi uzun süren bir işlemi çağıralıyorsa, 
bir koruyucu kullanmayı düşünün. Koruyucu, bir işlem görsel geri bildirimde çalışırken, kullanıcının birden çok 
işlemi sıraya almasını önleyebilir. Aşağıdaki bileşen kodu, GetForecastAsync verileri sunucudan alırken true 
isLoading ayarlar. isLoading true , bu düğme Kullanıcı arabiriminde devre dışı bırakılır: 

Şpage "/fetchdata" 

Şusing BlazorServerSample.Data 

Şinject 1/JeatherForecastService ForecastService 

<button disabled="@isLoading" @onclick="UpdateForecasts">Update</button> 

Şcode { 

private bool İsLoading; 

private WeatherForecast[] forecasts; 

private async Task UpdateForecasts() 

{ 

if (lisLoading) 

{ 

isLoading = true; 

forecasts = await ForecastService.GetForecastAsync(DateTime.Now); 
isLoading = false; 

} 

} 

} 

Erken iptali yapın ve bir-After-Dispose kullanmaktan kaçının 

Birden çok gönderenlere karşı koruma bölümünde açıklandığı gibi bir koruyucu kullanmanın yanı sıra, bileşen 
bırakıldığında uzun süreli işlemleri iptal etmek için bir CancellationToken kullanmayı düşünün. Bu yaklaşımda, 
bileşenlerden sonra kullanım-sonrasmda Dispose özelliğinden kaçmmanın sağladığı avantaj vardır: 











(Şimplements IDisposable 


@code { 

pnivate readonly CancellationTokenSource TokenSource = 
new CancellationTokenSource(); 

pnivate async Task UpdateForecasts() 

{ 

forecasts = await ForecastService.GetForecastAsync(DateTime.NoWj 
TokenSource.Token); 

if (TokenSource.Token.IsCancellationRequested) 

{ 

return; 

} 

} 

public void Dispose() 

{ 

CancellationTokenSource.Cancel(); 

} 

} 

Büyük miktarlarda veri üreten olaylardan kaçının 

oninput veya onscroiı gibi bazı DOM olayları, büyük miktarda veri üretebilir. Bu olayları Blazor Server 
uygulamalarında kullanmaktan kaçının. 

Ek güvenlik kılavuzu 

ASP.NET Core uygulamalarının güvenliğini sağlama kılavuzu Blazor sunucu uygulamalarına uygulanır ve aşağıdaki 
bölümlerde ele alınmıştır: 

• Günlüğe kaydetme ve hassas veriler 

• HTTPS ile yoldaki bilgileri koruma 

• Siteler arası betik oluşturma (XS S)) 

• Çapraz kaynak koruması 

• Tıklama-Jacking 

• Yeniden yönlendirmeleri aç 

Günlüğe kaydetme ve hassas veriler 

İstemci ve sunucu arasındaki JS birlikte çalışma etkileşimleri, ILogger örneklerle sunucu günlüklerine kaydedilir. 
Blazor, gerçek olaylar veya JS birlikte çalışma girişleri ve çıkışları gibi hassas bilgilerin günlüğe kaydedilmesini 
önler. 

Sunucuda bir hata oluştuğunda, çerçeve istemciye bildirir ve oturumu kapatır. Varsayılan olarak, istemci tarayıcının 
geliştirici araçlarında görünebileceğini belirten genel bir hata iletisi alır. 

istemci tarafı hatası, çağrı yığınını içermez ve hatanın nedeni hakkında ayrıntı sağlamaz, ancak sunucu günlükleri bu 
gibi bilgileri içerir. Geliştirme amacıyla, önemli hata bilgileri, ayrıntılı hataları etkinleştirerek istemciye kullanılabilir 
hale getirilebilir. 


ile ilgili ayrıntılı hataları etkinleştir: 





CircuitOptions.DetailedErrors 


• yapılandırma anahtarı DetailedErrors . Örneğin, aspnetcore_detailederrors ortam değişkenini true değerine 
ayarlayın. 


WARNING 

Internet 'teki istemcilere hata bilgilerini ortaya çıkarmak her zaman kaçınılması gereken bir güvenlik riskidir. 


HTTPS ile yoldaki bilgileri koruma 

Blazor sunucusu, istemci ve sunucu arasındaki iletişim için SignalR kullanır.Blazor sunucusu normalde SignalR 
üzerinde görüşür, genellikle VVebSockets olan aktarımı kullanır. 

Blazor sunucusu, sunucu ve istemci arasında gönderilen verilerin bütünlüğünü ve gizliliğini garanti etmez. Her 
zaman HTTPS kullanın. 

Siteler arası betik oluşturma (XSS) 

Siteler arası betik oluşturma (XSS), yetkisiz bir tarafın tarayıcı bağlamında rastgele mantık yürütmesine olanak 
sağlar. Güvenliği aşılmış bir uygulama, istemcide rastgele kod çalıştırabilir.Güvenlik açığı, sunucuda büyük olasılıkla 
çok sayıda kötü amaçlı eylem gerçekleştirmek için kullanılabilir: 

• Sahte/geçersiz olayları sunucuya gönderme. 

• Dağıtım başarısız/geçersiz işleme tamamlama. 

• işleme tamamlamamasını gönderdikten kaçının. 

• JavaScript 'ten .N ET 'e birlikte çalışma çağrıları gönderme. 

• .N ET 'ten JavaScript 'e birlikte çalışma çağrılarının yanıtını değiştirme. 

• .N ET ile JS birlikte çalışma sonuçlarına dağıtma kullanmaktan kaçının. 

Blazor Server Framework, önceki tehditlere karşı korumak için gereken adımları gerçekleştirir: 

• istemci, işleme toplu işlerini bildirmeden, yeni UI güncellemeleri oluşturmayı durduruyor. 
CircuitOptions.MaxBufferedUnacknowledgedRenderBat clıes ile yapılandırılır. 

• istemciden bir yanıt almadan bir dakikadan sonra herhangi bir .NET için JavaScript çağrısı süresi. 

CircuitOptions. JSInteropDefaultCallTimeout ile yapılandırılır. 

• J S birlikte çalışması sırasında tarayıcıdan gelen tüm girişte temel doğrulama gerçekleştirir: 
o .NET başvuruları geçerli ve .NET yöntemi tarafından beklenen türde. 

o Veriler hatalı biçimlendirilmemiş. 

o Yöntem için doğru sayıda bağımsız değişken, yükte bulunur. 

o Yöntemi çağırmadan önce bağımsız değişkenler veya sonuç doğru şekilde seri durumdan çıkarılmış 
olabilir. 

• Tarayıcıdan gönderilen olaylardan gelen tüm girişte temel doğrulama gerçekleştirir: 
o Olayın geçerli bir türü vardır. 

o Olay verilerinin serisi kaldırılamaz, 
o Olayla ilişkili bir olay işleyicisi var. 

Framevvork 'ün uyguladığı korumalarına ek olarak, tehditlere karşı korumak ve uygun işlemleri gerçekleştirmek için 
uygulamanın geliştirici tarafından kodlanmış olması gerekir: 

• Olayları işlerken her zaman verileri doğrulayın. 

• Geçersiz veri aldıktan sonra uygun eylemi gerçekleştirin: 

o Verileri yoksayın ve döndürün. Bu, uygulamanın istekleri işlemeye devam etmesine izin verir, 
o Uygulama girişin meşru olduğunu belirlerse ve meşru istemci tarafından üretilemeyecek bir özel durum 
oluşturun. Bir özel durum oluşturmak devre dışı olarak oturum kapatır ve oturumu sonlandırır. 











• Günlüklere dahil olan işleme toplu işlemleri tarafından sağlanan hata iletisine güvenmeyin. Hata istemci 
tarafından sağlanır ve istemcinin güvenliği tehlikeye aşmış olabileceğinden genellikle güvenilemez. 

• JS birlikte çalışma çağrılarında, JavaScript ve .NET yöntemleri arasında her iki yönde de girişe güvenmeyin. 

• Bağımsız değişkenlerin veya sonuçların doğru şekilde seri durumdan çıkarılsa bile, uygulama bağımsız 
değişkenlerin ve sonuçların içeriğinin geçerli olduğunu doğrulamaktan sorumludur. 

Bir XSS Güvenlik açığının mevcut olması için, uygulamanın işlenen sayfada Kullanıcı girişini içermesi gerekir. Blazor 
Server bileşenleri, bir. Razor dosyasındaki biçimlendirmenin yordamsal C# mantığa dönüştürülebileceği bir 
derleme zamanı adımı yürütür. Çalışma zamanında, C# Logic ööeleri, metinleri ve alt bileşenleri açıklayan bir işleme 
ağacı oluşturur. Bu, tarayıcı DOM 'a bir JavaScript yönergeleri dizisi aracılığıyla uygulanır (veya prerendering 
durumunda HTML olarak serileştirilir): 

• Normal Razor söz dizimi (örneğin, @somestringvaiue ) ile işlenen Kullanıcı girişi, Razor söz dizimi DOM 'a 
yalnızca metin yazabileceğiniz komutlar aracılığıyla eklendiğinden bir XSS Güvenlik Açığı sunmaz. Değer HTML 
biçimlendirmesi içerse bile, değer statik metin olarak görüntülenir. Prerendering olduğunda çıktı HTML 
kodlamalı olur ve bu da içeriği statik metin olarak görüntüler. 

• Betik etiketlerine izin verilmez ve uygulamanın bileşen işleme ağacına dahil edilmemelidir. Bir komut dosyası 
etiketi bir bileşenin biçimlendirmesinde yer alıyorsa, derleme zamanı hatası oluşturulur. 

• Bileşen yazarları, Razor kullanmadan bileşenleri C# içinde yazar. Bileşen yazarı, çıkış yayırken doğru API 'Leri 
kullanmaktan sorumludur. Örneğin, buiider.AddContentce, someUserSuppiiedstring) , İkincisi bir XSS Güvenlik 
Açığı oluşturmasından buiider.AddMarkupContent(0j someUserSuppiiedstring) değil ' i kullanın. 

XSS saldırılarına karşı koruma kapsamında, İçerik güvenlik ilkesi (CSP)gibi XSS azaltmalarını gerçekleştirmeyi 
düşünün. 

Daha fazla bilgi için bkz. Siteler arası betik kullanmayı (XSS) ASP.NET core'da engelle. 

Çapraz kaynak koruması 

Çapraz kaynak saldırıları, sunucuya yönelik bir eylem gerçekleştiren farklı bir kaynaktan gelen bir istemciyi içerir. 
Kötü amaçlı eylem, genellikle bir GET isteği veya bir form GÖNDERİSİNİ (siteler arası İstek sahteciliği, CSRF), 
ancak kötü amaçlı bir VVebSocket açmak da mümkündür. Blazor sunucu uygulamaları, hub protokolünü kullanan 
diğer SignalR uygulamaların aynısınısunar: 

• Blazor sunucu uygulamalarına ek ölçüler alınana kadar, kaynak dışı erişilebilir. Çapraz kaynak erişimini devre dışı 
bırakmak için, işlem hattında CORS ana hattını ekleyerek ve Blazor uç nokta meta verilerine ekleyerek 
DisableCorsAttribute izin verilen çıkış noktaları kümesini, çıkış noktaları arası kaynak paylaşımı için SignalR 

yapılandırarakbir süre sonu devre dışı bırakın. 

• CORS etkinse, CORS yapılandırmasına bağlı olarak uygulamayı korumak için ek adımlar gerekebilir.CORS 
genel olarak etkinleştirilmişse, hub.MapBiazorHub() çağrıldıktan sonra uç nokta meta verilerine 

DisableCorsAttribute meta verileri eklenerek Blazor sunucu hub 'ı için CORS devre dışı bırakılabilir. 

Daha fazla bilgi için bkz. ASP.NET Core siteler arası İstek sahteciliği (XSRF/CSRF) saldırılarını önle. 

Tıklama-Jacking 

Tıklama-Jacking, kullanıcıyı saldırı altında sitede eylemler gerçekleştirmeye ikna etmek için bir sitenin farklı bir 
kaynaktan bir <iframe> olarak işlenmesini içerir. 

Bir uygulamanın bir <iframe> içinde işlemesini korumak için İçerik güvenlik ilkesi (CSP) ve x-Frame- 0 ptions üst 
bilgisini kullanın. Daha fazla bilgi için bkz. MDN Web belgeleri: X-Frame-Options. 

Yeniden yönlendirmeleri aç 

Bir Blazor sunucusu uygulaması oturumu başladığında, sunucu, oturum başlatma işleminin bir parçası olarak 
gönderilen URL 'lerin temel doğrulamasını gerçekleştirir. Framevvork, devre oluşturmadan önce temel URL 'nin 
geçerli URL 'nin bir üst olduğunu denetler. Framework tarafından başka denetim yapılmaz. 













Kullanıcı istemcide bir bağlantı seçtiğinde, bağlantının URL 'SI sunucuya gönderilir ve bu işlem gerçekleştirilecek 
eylemi belirler. Örneğin, uygulama bir istemci tarafı gezintisi gerçekleştirebilir veya tarayıcıya yeni konuma 
gidemeyeceğini belirtebilir. 

Bileşenler, NavigationManager kullanımı aracılığıyla program aracılığıyla gezinme isteklerini de tetikleyebilirler. Bu 
tür senaryolarda, uygulama bir istemci tarafı gezintisi gerçekleştirebilir veya tarayıcıya yeni konuma gidebileceğini 
gösterebilir. 

Bileşenler: 

• Gezinti çağrısı bağımsız değişkenlerinin bir parçası olarak Kullanıcı girişini kullanmaktan kaçının. 

• Hedefin uygulama tarafından izin verildiğinden emin olmak için bağımsız değişkenleri doğrulayın. 

Aksi takdirde, kötü niyetli bir kullanıcı tarayıcıyı saldırgan tarafından denetlenen bir siteye gitmesini zorlayabilir. Bu 
senaryoda, saldırgan uygulamayı NavigationManager.Navigate yöntemi çağrısının bir parçası olarak bazı kullanıcı 
girişlerini kullanarak ' ye püf ediyor. 

Bu öneri, uygulamanın bir parçası olarak bağlantılar işlenirken de geçerlidir: 

• Mümkünse, göreli bağlantıları kullanın. 

• Mutlak bağlantı hedeflerinin bir sayfaya dahil etmeden önce geçerli olduğunu doğrulayın. 

Daha fazla bilgi için bkz. AS P.N ET core'da açık yeniden yönlendirme saldırılarını önleme. 

Kimlik doğrulaması ve yetkilendirme 

Kimlik doğrulama ve yetkilendirme hakkında yönergeler için bkz. ASP.NET Core Blazor kimlik doğrulaması ve 
yetkilendirme. 

Güvenlik denetim listesi 

Aşağıdaki güvenlik konuları listesi ayrıntılı değildir: 

• Etkinliklerden bağımsız değişkenleri doğrulayın. 

• Giriş ve, JS birlikte çalışma çağrılarındaki sonuçları doğrulayın. 

• .N ET için JS birlikte çalışabilirlik çağrılarına yönelik kullanıcı girişini kullanmaktan (veya önceden doğrulama) 
kaçının. 

• istemcinin ilişkisiz miktarda bellek ayırmasını engelleyin, 
o Bileşen içindeki veriler. 

o istemciye döndürülen başvuruları DotNetobject . 

• Birden çok gönderine karşı koruma. 

• Bileşen atıldığı zaman uzun süre çalışan işlemleri iptal edin. 

• Büyük miktarlarda veri üreten olaylardan kaçının. 

• NavigationManager.Navigate yapılan çağrıların bir parçası olarak Kullanıcı girişini kullanmaktan kaçının ve URL 
'Ler için Kullanıcı girişini, bir izin verilen kaynaklar kümesine göre doğrulama, önce kaçınılmaz. 

• Kullanıcı arabiriminin durumuna göre yetkilendirme kararları yapmayın, ancak yalnızca bileşen durumudur. 

• XSS saldırılarına karşı korunmak için İçerik güvenlik ilkesi'ni (CSP) kullanmayı düşünün. 

• Tıklama-Jacking 'e karşı korumak için CSP ve X çerçeve seçeneklerini kullanmayı düşünün. 

• CORS 'yi etkinleştirirken veya Blazor uygulamaları için doğrudan CORS 'yi devre dışı bırakrken CORS 
ayarlarının uygun olduğundan emin olun. 

• Blazor uygulamasına yönelik sunucu tarafı sınırlarının kabul edilemez bir risk düzeyi olmadan kabul edilebilir bir 
kullanıcı deneyimi sağlamasına emin olmak için test edin. 
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IMPORTANT 

Önizlemede Blazor VVeelsembly 

Blazor sunucusu ASP.NET Core 3,0 ' de desteklenir. Blazor WebAssembly ASP.NET Core 3,1 için önizlemededir. 


Blazor sunucusu, durum bilgisi olan bir uygulama çerçevesidir. Çoğu zaman, uygulama sunucuya devam eden bir 
bağlantı sağlar. Kullanıcının durumu, sunucu belleğinde bir devrende tutulur. 

Bir kullanıcının devresi için durum tutulan örnekler şunlardır: 

• işlenmiş Kullanıcı arabirimi, bileşen örneklerinin hiyerarşisini ve en son işleme çıktılarının—. 

• Bileşen örneklerinde alanların ve özelliklerin değerleri. 

• Devre kapsamına alınan bağımlılık ekleme (dı) hizmet örneklerinde tutulan veriler. 


NOTE 

Bu makale Blazor Server uygulamalarındaki durum kalıcılığını ele alınmaktadır. Blazor VVebAssembly Apps, Tarayıcıda istemci 
tarafı durum kalıcılığından yararlanabilir, ancak bu makalenin kapsamı dışında özel çözümler veya üçüncü taraf paketleri 
gerektirebilir. 


Blazor devreler 

Bir Kullanıcı geçici bir ağ bağlantısı kaybıyla karşılaşıyorsa, uygulamayı kullanmaya devam edebilmek için 
kullanıcıyı özgün devresine yeniden bağlamaya çalışır Blazor. Ancak, bir kullanıcıyı sunucunun belleğindeki özgün 
devresine yeniden bağlamak her zaman mümkün değildir: 

• Sunucu, bağlantısı kesilen bir devreni süresiz olarak sürdüremez. Sunucu, bir zaman aşımından sonra veya 
sunucu bellek baskısı altında olduğunda, bağlantısı kesilen bir bağlantı hattını serbest bırakmalıdır. 

• Çoklu sunucu, yük dengeli dağıtım ortamlarında, herhangi bir zamanda herhangi bir sunucu işleme isteği 
kullanılamaz hale gelebilir. Tek tek sunucular, tüm istek hacmini işlemek için artık gerekli olmadığında veya 
otomatik olarak kaldırılabilir. Kullanıcı yeniden bağlanmaya çalıştığında, özgün sunucu kullanılamayabilir. 

• Kullanıcı tarayıcıyı kapatabilir ve yeniden açabilir veya sayfayı yeniden yükleyerek tarayıcı belleğinde tutulan 
tüm durumları kaldırır. Örneğin, JavaScript birlikte çalışabilirlik çağrıları aracılığıyla ayarlanan değerler 
kaybolur. 

Kullanıcı özgün devresine yeniden bağlanalınmayacaksa, Kullanıcı boş duruma sahip yeni bir devre alır. Bu, bir 
masaüstü uygulamasını kapatıp yeniden açmaya eşdeğerdir. 

Devreler arasında durumu koru 

Bazı senaryolarda, devre genelinde durum koruma istenebilir. Bir uygulama, şu durumlarda bir kullanıcı için 
önemli verileri koruyabilir: 


• Web sunucusu kullanılamaz hale gelir. 







• Kullanıcının tarayıcısı yeni bir Web sunucusuyla yeni bir devre başlatmaya zorlanır. 

Genel olarak, devrelerde durumu korumak, kullanıcıların zaten var olan verileri okurken değil, etkin bir şekilde veri 
oluşturmakta olduğu senaryolar için geçerlidir. 

Tek bir devrenin ötesinde durumu korumak için, verileri yalnızca sunucunun belleğine depolamayın. Uygulama, 
verileri başka bir depolama konumuna kalıcı hale vermelidir. Durum kalıcılığı otomatik değil—durum bilgisi olan 
veri kalıcılığını uygulamak üzere uygulamayı geliştirirken adımları uygulamanız gerekir. 

Veri kalıcılığı genellikle yalnızca kullanıcıların oluşturma çabasında olduğu yüksek değerli durum için gereklidir. 
Aşağıdaki örneklerde, kalıcı durum ticari etkinliklerdeki zaman veya yardımlarını kaydeder: 

• Çok adımlı VVebForm bir kullanıcının, durumları kaybedilmişse, çok adımlı bir işlemin birkaç tamamlanmış 
adımı için verileri yeniden girmesi için zaman alan bir işlemdir. Kullanıcı, çok adımlı formdan uzaklaştıklarında 
ve daha sonra forma geri döndüğünüzde bu senaryodaki durumu kaybeder. 

• Alışveriş sepeti, olası geliri temsil eden bir uygulamanın ticari olarak önemli bir bileşeni Durumlarını 
kaybettikleri bir Kullanıcı ve bu nedenle alışveriş sepeti, siteye daha sonra geri döntiklerinde daha az ürün veya 
hizmet satın alabilir. 

Genellikle, gönderilmemiş bir oturum açma iletişim kutusuna girilen Kullanıcı adı gibi, kolayca yeniden 
oluşturulmuş durumu korumak gerekli değildir. 


IMPORTANT 

Uygulama, uygulama d uru mu nuya\nızca kalıcı hale getirebilirler. Usıs, bileşen örnekleri ve bunların işleme ağaçları gibi kalıcı 
hale getirilir. Bileşenler ve işleme ağaçları genellikle seri hale getirilebilir değildir. Bir TreeVievv 'un genişletilmiş düğümleri gibi 
kullanıcı arabirimi durumuna benzer bir şeyi sürdürmek için, uygulamanın davranışı seri hale getirilebilir uygulama durumu 
olarak modelleyeceği özel kodu olmalıdır. 


Durumun nerede kalıcı olduğu 

Blazor sunucu uygulamasındaki kalıcı durum için üç ortak konum vardır. Her yaklaşım farklı senaryolara en iyi 
şekilde uygundur ve farklı uyarılar içerir: 

• Veritabanında sunucu tarafı 

• URL 

• Tarayıcıda istemci tarafı 

Veritabanında sunucu tarafı 

Kalıcı veri kalıcılığı veya birden çok kullanıcı veya cihaza yayılması gereken veriler için, bağımsız bir sunucu tarafı 
veritabanı neredeyse en iyi seçenektir. Şu seçenekler mevcuttur: 

• ilişkisel SQL veritabanı 

• Anahtar değeri deposu 

• Blob deposu 

• Tablo deposu 

Veriler veritabanına kaydedildikten sonra, bir kullanıcı tarafından herhangi bir zamanda yeni bir devre başlatılabilir. 
Kullanıcının verileri korunur ve yeni bir devrede kullanılabilir. 

Azure veri depolama seçenekleri hakkında daha fazla bilgi için bkz. Azure depolama belgeleri ve Azure 
verita banları. 

{1 > U RL <1} 

Gezinti durumunu temsil eden geçici veriler için, verileri URL 'nin bir parçası olarak modelleyin. URL 'de 





modellenen durum örnekleri şunları içerir: 

• Görüntülenen varlığın KİMLİĞİ. 

• Disk belleğine alınmış bir kılavuzdaki geçerli sayfa numarası. 

Tarayıcının adres çubuğunun içeriği korunur: 

• Kullanıcı sayfayı el ile yeniden yükler. 

• Web sunucusu kullanılamaz hale gelirse—Kullanıcı farklı bir sunucuya bağlanmak için sayfayı yeniden 
yüklemeye zorlanır. 

@page yönergesi ile URL desenleri tanımlama hakkında bilgi için bkz. ASP.NET Core Blazor yönlendirme. 

Tarayıcıda istemci tarafı 

Kullanıcının etkin şekilde oluşturmakta olduğu geçici veriler için, yaygın bir yedekleme deposu tarayıcının 
locaistorage ve sessionstorage koleksiyonlarıdır. Devre dışı bırakılırsa, sunucu tarafı depolama alanının 
avantajlarından yararlanan uygulama, saklı durumu yönetmek veya temizlemek için gerekli değildir. 



• locaistorage kullanıcının tarayıcısına kapsamlandırılır. Kullanıcı sayfayı yeniden yüklediğinde veya tarayıcıyı 
kapatıp yeniden açarsa durum devam ettirir. Kullanıcı birden çok tarayıcı sekmesi açarsa, durum sekmeler 
arasında paylaşılır. Veriler açık olarak temizlenene kadar locaistorage devam ettirir. 

• sessionstorage , kullanıcının tarayıcı sekmesinin kapsamına alınır. Kullanıcı sekmeyi yeniden yüklediğinde 
durum devam ettirir. Kullanıcı sekmeyi veya tarayıcıyı kapatırsa durum kaybedilir. Kullanıcı birden çok tarayıcı 
sekmesi açarsa, her sekmenin kendi bağımsız bir veri sürümü vardır. 

Genellikle, sessionstorage kullanımı daha güvenlidir, sessionstorage , kullanıcının birden çok sekme açmasını ve 

aşağıdaki gibi karşılaştığı riskleri önler: 

• Sekmelerde durum depolamadaki hatalar. 

• Sekme diğer sekmelerin durumunun üzerine yazdığınızda kafa karıştırıcı davranışı. 

locaistorage , uygulamanın kapatma ve tarayıcıyı yeniden açma genelinde durumu kalıcı olması gerekiyorsa daha 

iyi bir seçenektir. 

Tarayıcı depolamayı kullanmaya yönelik uyarılar: 

• Sunucu tarafı veritabanının kullanımına benzer şekilde veri yükleme ve kaydetme zaman uyumsuzdur. 

• Sunucu tarafı veritabanının aksine, istenen sayfa prerendering aşamasında tarayıcıda bulunmadığından, 
depolama alanı prerendering sırasında kullanılamaz. 

• Birkaç kilobayt veri depolaması Blazor sunucu uygulamalarında kalıcı hale getiriyoruz. Birkaç kilobayt dışında, 
veriler ağ üzerinden yüklenip kaydedildiğinden performans etkilerini göz önünde bulundurmanız gerekir. 

• Kullanıcılar verileri görüntüleyebilir veya bunlarla karşılaşabilir. AS P.N ET Core veri koruma riski azaltabilirler. 

Üçüncü taraf tarayıcı depolama çözümleri 

Üçüncü taraf NuGet paketleri locaistorage ve sessionstorage çalışmaya yönelik API'Ler sağlar. 

AS P.N ET Core veri korumasınısaydam olarak kullanan bir paket seçmeyi düşünülüyor. AS P.N ET Core veri 
















koruma, depolanan verileri şifreler ve depolanan verilerle yapılan değişikliklere karşı olası riskleri azaltır. JSON seri 
hale getirilmiş veriler düz metin halinde depolanıyorsa, kullanıcılar tarayıcı geliştirici araçlarını kullanarak verileri 
görebilir ve depolanan verileri de değiştirebilir. Verilerin güvenliğini sağlamak her zaman bir sorun değildir çünkü 
veriler önemsiz olarak olabilir. Örneğin, bir kullanıcı ARABİRİMİ öğesinin saklı rengini okumak veya değiştirmek, 
Kullanıcı veya kuruluş için önemli bir güvenlik riski değildir. Kullanıcıların hassas veri/eriincelemesine veya 
değiştirmesine izin vermeyi önleyin. 

Korumalı tarayıcı depolaması deneysel paket 

locaistorage ve sessionstorage için veri koruması sağlayan bir NuGet paketi örneği Microsoft. Aspnetcore. 
protectedbrovvserstorage' dır. 


W ARNING 

Microsoft .As pNetco re. ProtectedBrowser'Storage , şu anda üretim kullanımı için uygun olmayan, desteklenmeyen bir 
deneysel pakettir. 

Yükleme 

Microsoft.AspNetCore.ProtectedBrowserStorage paketini yüklemek için: 

1. Blazor Server App projesinde, Microsoft. AspNetCore. ProtectedBrovvserStorageöğesine bir paket 
başvurusu ekleyin. 

2. Üst düzey HTML 'de (örneğin, varsayılan Proje şablonundaki Pages/_Host. cshtml dosyasında) aşağıdaki 

<script> etiketini ekleyin: 

cscript src="_content/Microsoft.AspNetCore.ProtectedBrowserStorage/protectedBrowserStorage.js"> 

</script> 

3. Startup.ConfigureServices yönteminde, hizmet koleksiyonuna localStorage ve sessionStorage hizmetleri 
eklemek için AddProtectedBrowserstorage çağırın: 

Services.AddProtectedBrowserStorage(); 

Bir bileşen içindeki verileri kaydetme ve yükleme 

Tarayıcı depolamaya veri yüklemeyi veya kaydetmeyi gerektiren herhangi bir bileşende, aşağıdakilerden birinin bir 
örneğini eklemek için @inject kullanın: 

• ProtectedLocalStorage 

• ProtectedSessionStorage 

Seçim, hangi yedekleme deposunu kullanmak istediğinize bağlıdır.Aşağıdaki örnekte sessionstorage kullanılır: 

@using Microsoft.AspNetCore.ProtectedBrowserStorage 
(Şinject ProtectedSessionStorage ProtectedSessionStore 

@using deyimin bileşen yerine bir_/mporfs. Razor dosyasına yerleştirilmesi olabili r.Jmports. Razor dosyası 
kullanımı, ad alanını uygulamanın daha büyük kesimlerine veya uygulamanın tamamına kullanılabilir hale getirir. 

Proje şablonunun counter bileşenindeki currenteount değerini kalıcı hale getirmek için incrementcount 
yöntemini ProtectedSessionStore.setAsync kullanılacak şekilde değiştirin: 
















private async Task IncrementCount() 

{ 

currentCount++; 

await ProtectedSessionstore.SetAsync("count", currentCount); 

} 

Daha büyük, daha gerçekçi uygulamalar, tek tek alanların depolanması ise olası bir senaryodur. Uygulamalar 
karmaşık durum içeren tüm model nesnelerini depolamaya daha olasıdır. ProtectedSessionstore JSON verilerini 
otomatik olarak serileştirir ve seri hale getirir. 

Yukarıdaki kod örneğinde, currentCount verileri kullanıcının tarayıcısında sessionstorage[’count' ] olarak 
depolanır. Veriler düz metin biçiminde depolanmaz, bunun yerine ASP.NET Core veri korumakullanılarak korunur. 
Şifrelenmiş veriler, sessionstorage[ 'count' ] tarayıcının geliştirici konsolunda değerlendirildiğinde görülebilir. 

Kullanıcı counter bileşene daha sonra geri dönerse currentCount verileri kurtarmak için (tamamen yeni bir 
devreye açık olanlar dahil), ProtectedSessionstore.GetAsync kullanın: 

protected override async Task OnInitializedAsync() 

{ 

currentCount = await ProtectedSessionstore.GetAsync<int>("count"); 

} 

Bileşenin parametreleri gezinti durumu içeriyorsa, ProtectedSessionstore.GetAsync çağırın ve sonucu 
OnlnitializedAsync değil OnParametersSetAsync atayın. OnlnitializedAsync , bileşen ilk kez oluşturulduğunda 
yalnızca bir kez çağırılır. OnlnitializedAsync , Kullanıcı aynı sayfada kaldığında farklı bir URL 'y e gittiğinde daha 
sonra yeniden çağrılmaz. Daha fazla bilgi için bkz. ASP.NET Core Blazor yaşam döngüsü. 


WARNING 

Bu bölümdeki örnekler yalnızca sunucuda prerendering etkinleştirilmemişse çalışır. Prerendering etkinken şuna benzer bir 
hata oluşturulur: 

JavaScript birlikte çalışabilirlik çağrıları şu an için verilemez. Bunun nedeni, bileşenin ön işlenmiş olmasından kaynaklanır. 

Prerendering T devre dışı bırakın ya da prerendering ile çalışmak için ek kod ekleyin. Prerendering ile birlikte çalışarak kodu 
yazma hakkında daha fazla bilgi için bkz. Handle prerendering bölümü. 


Yükleme durumunu işle 

Tarayıcı depolaması zaman uyumsuz olduğundan (bir ağ bağlantısı üzerinden erişilir), veriler yüklenmeden ve bir 
bileşen tarafından kullanıma sunulmadan önce her zaman bir zaman dilimi vardır. En iyi sonuçlar için, yükleme 
sırasında, boş veya varsayılan verileri görüntülemek yerine bir yükleme durumu iletisi işleme devam ediyor. 

Bir yaklaşım, verilerin nuiı (hala yükleme) olup olmadığını izlemedir. Varsayılan counter bileşende, sayı bir int 
tutulur. Türe bir soru işareti ( ? ) ekleyerek currentCount null yapılabilir yapın ( int ): 

private int? currentCount; 

Sayı ve artış düğmesini koşullu olarak görüntülemediğinizden, bu öğeleri yalnızca veriler yüklenmişse 
görüntülemeyi seçin: 





















Şif (currentCount.HasValue) 

{ 

<p>Current count: <strong>@currentCount</strongx/p> 

<button @onclick="IncrementCount">Increment</button> 

} 

else 

{ 

<p>Loading...</p> 

} 

Tanıtıcı prerendering 

Prerendering sırasında: 

• Kullanıcının tarayıcısına etkileşimli bir bağlantı yok. 

• Tarayıcıda, JavaScript kodunu çalıştırabildiği bir sayfa yok. 

locaistorage veya sessionstorage prerendering sırasında kullanılamaz. Bileşen depolama ile etkileşim kurmayı 
denerse şuna benzer bir hata oluşturulur: 

JavaScript birlikte çalışabilirlik çağrıları şu an için verilemez. Bunun nedeni, bileşenin ön işlenmiş olmasından 
kaynaklanır. 

Hatayı çözmek için bir yol prerendering devre dışı bırakılır. Bu genellikle uygulama tarayıcı tabanlı depolamanın 
yoğun bir şekilde kullanımını yapıyorsa en iyi seçenektir. Prerendering karmaşıklık ekler ve locaistorage veya 
sessionstorage kullanılabilir olana kadar uygulama yararlı bir içeriğe gidemez. 

Prerendering ‘yi devre dışı bırakmak için, Pages/_Host. cshtml dosyasını açın ve component etiketi Yardımcısı 
render-mode çağrısını server olarak değiştirin. 

Prerendering 'yi devre dışı bırakmak için, Pages/_Host. cshtml dosyasını açın ve 
Html.RenderComponentAsync<App>(RenderMode.Server) çağrısını değiştirin. 

Prerendering, locaistorage veya sessionstorage kullanmayan diğer sayfalar için yararlı olabilir. Prerendering 
etkin tutmak için, tarayıcı devreye bağlanana kadar yükleme işlemini erteleyin. Aşağıda, bir sayaç değeri 
depolamak için bir örnek verilmiştir: 











@using Microsoft.AspNetCore.ProtectedBrowserStorage 
(Şinject ProtectedLocalStorage ProtectedLocalStore 

... rendering code goes here ... 

@code { 

private int? currentCount; 
private bool isConnected = false; 

protected override async Task OnAfterRenderAsync(bool firstRender) 

{ 

if (firstRender) 

{ 

// When execution reaches this pointj the first *interactive* render 
// is complete. The component has an active connection to the browser. 
isConnected = true; 
await LoadStateAsync(); 

StateHasChanged(); 

} 

} 

private async Task LoadStateAsync() 

{ 

currentCount = await ProtectedLocalStore.GetAsync<int>("prerenderedCount"); 

} 

private async Task IncrementCount() 

{ 

currentCount++; 

await ProtectedSessionStore.SetAsync("count"j currentCount); 

} 


Durum korumasını ortak bir konuma ayırın 

Birçok bileşen tarayıcı tabanlı depolamaya güveniyorsa, durum sağlayıcısı kodu birçok kez yeniden uygulama kod 
yinelemesi oluşturur. Kod çoğaltmaktan kaçınmanın bir seçeneği, durum sağlayıcısı mantığını kapsülleyen bir 
durum sağlayLctsı ana bileşeni oluşturmaktır. Alt bileşenler, durum kalıcılığı mekanizmasına bakılmaksızın kalıcı 
verilerle çalışabilir. 

Aşağıdaki bir counterstateProvider bileşeni örneğinde, sayaç verileri kalıcıdır: 




Şusing Microsoft.AspNetCore.ProtectedBrowserStorage 
Şinject ProtectedSessionStorage ProtectedSessionStore 


Şif (hasLoaded) 

{ 

cCascadingValue Value="@this"> 

ŞChildContent 

</CascadingValue> 

} 

else 

{ 

<p>Loading...</p> 

} 

Şcode { 

private bool hasLoaded; 

[Parameter] 

public RenderFragment ChildContent { get; set; } 

public int CurrentCount { get; set; } 

protected override async Task OnInitializedAsync() 

{ 

CurrentCount = await ProtectedSessionStore.GetAsync<int>("count"); 
hasLoaded = true; 

} 

public async Task SaveChangesAsync() 

{ 

await ProtectedSessionStore.SetAsync("count"j CurrentCount); 

} 

} 


counterstateProvider bileşeni, yükleme tamamlanana kadar alt içeriğini işlemeden Yükleme aşamasını işler. 

counterstateProvider bileşenini kullanmak için, bileşenin bir örneğini sayaç durumuna erişimi gerektiren diğer 
tüm bileşenler etrafında sarmalayın. Bir uygulamadaki tüm bileşenlerin durumunu erişilebilir hale getirmek için, 
CounterstateProvider bileşenini App bileşenindeki Router etrafında sarmalayın (app. Razor): 

<CounterStateProvider> 

<Router AppAssembly="typeof(Startup).Assembly"> 

</Router> 

</CounterStateProvider> 

Sarmalanan bileşenler, kalıcı sayaç durumunu alır ve değiştirebilir.Aşağıdaki counter bileşeni, bu kalıbı uygular 






@page "/counter" 

<p>Current count: <str'ong>@CounterStateProvider.CurrentCount</strongx/p> 

<button @onclick="IncrementCount">Increment</button> 

@code { 

[CascadingParameter] 

pnivate CounterStateProvider CounterStateProvider { get; set; } 

private async Task IncrementCount() 

{ 

CounterStateProvider.CurrentCount++; 

await CounterStateProvider.SaveChangesAsync(); 

} 

} 

Yukarıdaki bileşen ProtectedBrowserstorage etkileşimde bulunmak veya bir "yükleme" aşaması ile uğraşmak için 
gerekli değildir. 

Daha önce açıklandığı gibi prerendering ile başa çıkmak için CounterStateProvider , sayaç verilerini kullanan tüm 
bileşenlerin prerendering ile otomatik olarak çalışmasını sağlayacak şekilde değiştirilebilir. Ayrıntılar için bkz. 

Handle prerendering bölümü. 

Genel olarak, durum sağlayıcısı üst bileşen deseninin kullanılması önerilir: 

• Diğer birçok bileşenin durumunu kullanmak için. 

• Kalıcı olacak yalnızca bir üst düzey durum nesnesi varsa. 


Birçok farklı durum nesnesini kalıcı hale getirmek ve farklı yerlerde nesnelerin farklı alt kümelerini kullanmak için, 
durumu küresel olarak yükleme ve kaydetme işlemlerini yapmaktan kaçınmak daha iyidir. 




ASPNET Core Blazor uygulamalarda hataları işleme 
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Steve Sanderson tarafından 

Bu makalede, işlenmemiş özel durumları Blazor nasıl yönettiği ve hataları algılayan ve işleyen uygulamalar 
geliştirileceği açıklanır. 

Geliştirme sırasında ayrıntılı hatalar 

Geliştirme sırasında Blazor bir uygulama düzgün bir şekilde çalışmadığı zaman, uygulamanın ayrıntılı hata 
bilgilerinin alınması sorunu gidermeye ve sorunun giderilmesine yardımcı olur. Bir hata oluştuğunda, Blazor 
uygulamalar ekranın alt kısmında altın bir çubuk görüntüler: 

• Geliştirme sırasında altın çubuk, özel durumu görebileceğiniz tarayıcı konsoluna yönlendirir. 

• Üretimde, altın çubuk kullanıcıya bir hata oluştuğunu bildirir ve tarayıcıyı yenilemeyi önerir. 

Bu hata işleme deneyimi için Kullanıcı arabirimi Blazor projesi şablonlarının bir parçasıdır. Blazor VVebAssembly 
uygulamasında, WwwrootAndex.html dosyasındaki deneyimi özelleştirin: 

<div id="blazor-error-ui"> 

An unhandled error has occurred. 

<a href="" class="reload">Reload</a> 

<a class="dismiss">0</a> 

</div> 


Blazor sunucu uygulamasında, Pages/_Host. cshtml dosyasındaki deneyimi özelleştirin: 

<div id="blazor-error-ui"> 

<environment include="Staging,Production"> 

An error has occurred. This application may no longer respond until reloaded. 

</environment> 

<environment include="Development"> 

An unhandled exception has occurred. See browser dev tools for details. 

</environment> 

<a href="" class="reload">Reload</a> 

<a class="dismiss">0</a> 

</div> 

biazor-error-ui öğesi Blazor şablonlarına eklenen stillerle gizlenir ve bir hata oluştuğunda gösterilir. 

Blazor Framevvork işlenmemiş özel durumlara nasıl yeniden davranır 

Blazor sunucusu durum bilgisi olan bir çerçevedir. Kullanıcılar bir uygulamayla etkileşim kurarken, devre olarak 
bilinen sunucuya bir bağlantı sağlar. Devre, etkin bileşen örneklerini ve diğer birçok durum düzeyini barındırır; 
örneğin: 

• Bileşenlerin en son işlenmiş çıktısı. 

• istemci tarafı olayları tarafından tetiklenebilecek geçerli olay işleme temsilcileri kümesi. 

Bir Kullanıcı uygulamayı birden çok tarayıcı sekmelerinde açarsa, birden çok bağımsız devreler vardır. 

Blazor, işlenmemiş özel durumların çoğunu gerçekleştiği devreyi önemli olarak değerlendirir, işlenmeyen bir özel 






durum nedeniyle devre sonlandırılırsa, Kullanıcı yalnızca yeni bir bağlantı oluşturmak için sayfayı yeniden 
yükleyerek uygulamayla etkileşime geçerek devam edebilir. Diğer kullanıcılar veya diğer tarayıcı sekmeleri için 
devre dışı bırakılmış olan Sonlandırıcı dışındaki devreleri etkilenmez. Bu senaryo, kilitlenen uygulamanın yeniden 
başlatılması gereken—, ancak diğer uygulamaların etkilenmemesi gerektiğini engelleyen bir masaüstü 
uygulamasına benzerdir. 

Aşağıdaki nedenlerden dolayı işlenmeyen bir özel durum oluştuğunda devre sonlandırılır: 

• işlenmeyen bir özel durum, genellikle devre dışı bir durumda bırakır. 

• işlenmemiş bir özel durumdan sonra uygulamanın normal işlemi garanti edilemez. 

• Devre devam ederse uygulamada güvenlik açıkları görünebilir. 

Geliştirici kodundaki işlenmemiş özel durumları yönetme 

Bir uygulamanın bir hatadan sonra devam edebilmesi için, uygulamanın hata işleme mantığı olması gerekir. Bu 
makalenin sonraki bölümlerinde işlenmemiş özel durumların olası kaynakları açıklanır. 

Üretimde, çerçeve özel durum iletilerini veya yığın izlemelerini Kullanıcı arabiriminde işlemez. Özel durum iletilerini 
veya yığın izlemelerini işleme şu şekilde olabilir: 

• Hassas bilgileri son kullanıcılara açıklayın. 

• Kötü niyetli bir kullanıcının uygulama, sunucu veya ağ güvenliğini tehlikeye atabilecek bir uygulamada zayıf 
yanları bulmasına yardımcı olun. 

Kalıcı bir sağlayıcıyla hataları günlüğe kaydet 

işlenmeyen bir özel durum oluşursa, özel durum hizmet kapsayıcısında yapılandırılmış ILogger örneklerine 
kaydedilir. Varsayılan olarak, Blazor uygulamalar konsol günlüğü sağlayıcısı ile konsol çıktısına kaydedilir. Günlük 
boyutunu ve günlük döndürmesini yöneten bir sağlayıcı ile daha kalıcı bir konuma oturum açmayı düşünün. Daha 
fazla bilgi için bkz. .N ET Core ve AS P.N ET Core oturum açma. 

Geliştirme sırasında, Blazor hata ayıklamaya yardımcı olması için genellikle özel durumların tüm ayrıntılarını 
tarayıcı konsoluna gönderir. Üretimde, tarayıcı konsolundaki ayrıntılı hatalar varsayılan olarak devre dışıdır. Bu, 
hataların istemcilere gönderilmediği, ancak özel durumun tam ayrıntılarının hala sunucu tarafında günlüğe 
kaydedildiği anlamına gelir. Daha fazla bilgi için bkz. ASP.NET Core hataları işleme. 

Hangi olayların günlüğe kaydedileceğini ve günlüğe kaydedilen olayların önem düzeyi düzeyini karar vermelisiniz. 
Saldırgan kullanıcılar hataları kasıtlı olarak tetikleyebiliyor olabilir.Örneğin, ürün ayrıntılarını görüntüleyen bir 
bileşenin URL 'sinde bilinmeyen bir Productid sağlandığı bir hatadan olay günlüğe kaydetme. Tüm hatalar 
günlüğe kaydetme için yüksek önem derecesine sahip olaylar olarak değerlendirilmemelidir. 

Hataların gerçekleşebileceği yerleri 

Çerçeve ve uygulama kodu aşağıdaki konumlardan herhangi birinde işlenmeyen özel durumları tetikleyebiliriz: 

• Bileşen örneği oluşturma 

• Yaşam döngüsü yöntemleri 

• İşleme mantığı 

• Olay işleyicileri 

• Bileşen elden çıkarma 

• JavaScript birlikte çalışma 

• Devre işleyicileri 

• Devre elden çıkarma 

• Prerendering 




Önceki işlenmemiş özel durumlar, bu makalenin aşağıdaki bölümlerinde açıklanmıştır. 

Bileşen örneği oluşturma 

Blazor bir bileşenin örneğini oluşturduğunda: 

• Bileşenin Oluşturucusu çağrılır. 

• @inject yönergesi veya [inject] özniteliği aracılığıyla bileşen oluşturucusuna sağlanan Singleton olmayan 
her türlü hizmeti Oluşturucu. 

Herhangi bir [inject] özelliği için yürütülen bir Oluşturucu veya ayarlayıcı işlenmeyen bir özel durum 
oluşturduğunda devre dışı olur. Framevvork bileşeni örneklemediğinden özel durum önemlidir.Oluşturucu mantığı 
özel durumlar oluşturmayabilir, uygulama hata işleme ve günlüğe kaydetme ile try-catch ifadesini kullanarak özel 
durumları yakalemelidir. 

Yaşam döngüsü yöntemleri 

Bir bileşenin kullanım ömrü boyunca Blazor aşağıdaki yaşam döngüsü yöntemleriniçağırır: 


Onlnitialized 

/ 

OnlnitializedAsync 


OnParametersSet 

/ OnParametersSetAsync 

ShouldRender 

/ 

ShouldRenderAsync 


OnAfterRender 

/ 

OnAfterRenderAsync 



Herhangi bir yaşam döngüsü yöntemi, zaman uyumlu veya zaman uyumsuz olarak bir özel durum oluşturursa, özel 
durum devre dışı olur. Bileşenler için yaşam döngüsü yöntemlerinde hatalarla başa çıkmak için hata işleme mantığı 
ekleyin. 

Aşağıdaki örnekte onParametersSetAsync bir ürünü almak için bir yöntemi çağırır: 

• ProductRepository .GetProductByidAsync yönteminde oluşan bir özel durum try-catch ifadesiyle işlenir. 

• catch bloğu yürütüldüğünde: 

o îoadFailed , kullanıcıya bir hata iletisi göstermek için kullanılan true olarak ayarlanır, 
o Hata günlüğe kaydedilir. 











@page "/product-details/{ProductIdrint}" 

@using Microsoft.Extensions.Logging 
Şinject IProductRepository ProductRepository 
Şinject ILogger<ProductDetails> Logger 

Şif (details != null) 

{ 

<hl>@details.ProductName</hl> 

<p>@details.Description</p> 

} 

else if (loadFailed) 

{ 

<hl>Sorry, we could not load this product due to an error.</hl> 

} 

else 

{ 

<hl>Loading...</hl> 

} 

@code { 

private ProductDetails details; 
private bool loadFailed; 

[Parameter] 

public int Productld { get; set; } 

protected override async Task OnParametersSetAsync() 

{ 

try 

{ 

loadFailed = false; 

details = await ProductRepository.GetProductByldAsync(Productld); 

} 

catch (Exception ex) 

{ 

loadFailed = true; 

Logger.LogWarning(ex, "Failed to load product {Productld }", Productld); 

} 

} 

} 


İşleme mantığı 

.razor bileşen dosyasındaki bildirim temelli biçimlendirme BuiidRenderîree adlı bir C# yönteme derlenir. Bir 
bileşen işlendiğinde BuiidRenderîree yürütülür ve işlenmiş bileşenin öğelerini, metnini ve alt bileşenlerini açıklayan 
bir veri yapısı oluşturur. 

işleme mantığı bir özel durum oluşturabilir. @someObject.Propertyi\iame değerlendiriliyorsa ancak @someObject null 
bu senaryoya bir örnek oluşur. İşleme mantığı tarafından oluşturulan işlenmeyen bir özel durum, devre için önemli 
bir durumdur. 

Oluşturma mantığındaki null başvuru özel durumunu engellemek için, üyelerine erişmeden önce bir null 
nesnesini denetleyin. Aşağıdaki örnekte, person.Address null" person.Address özelliklere erişilmez: 

@if (person.Address != null) 

{ 

<div>@person.Address.Linel</div> 

<div>@person.Address.Line2</div> 

<div>@person.Address.City</div> 

<div>@person.Address.Country</div> 

} 


Yukarıdaki kod, person 


null olmadığını varsayar. Genellikle, kodun yapısı, bileşenin işlendiği sırada bir nesnenin 












var olmasını garanti eder. Bu durumlarda, işleme mantığındaki nuiı denetlemek gerekli değildir. Önceki örnekte, 
bileşen örneği oluşturulduğunda person oluşturulduğu için person olması garanti edilebilir. 

Olay işleyicileri 

istemci tarafı kod, kullanarak olay işleyicileri C# oluşturulduğunda kodun çağırmaları tetikler: 


• 

@onclick 


• 

(Sonchange 


• 

Diğer 

@on 

... öznitelikleri 

• 

@bind 



Olay işleyici kodu, bu senaryolarda işlenmeyen bir özel durum oluşturabilir. 

Bir olay işleyicisi işlenmeyen bir özel durum oluşturursa (örneğin, bir veritabanı sorgusu başarısız olursa), özel 
durum devre dışı olarak önemli olur. Uygulama, dış nedenlerle başarısız olabilecek kodu çağırırsa, hata işleme ve 
günlüğe kaydetme ile try-catch ifadesini kullanarak özel durumlar yakalayın. 

Kullanıcı kodu yakalanmazsa ve özel durumu işlemezse çerçeve özel durumu günlüğe kaydeder ve devre 
sonlandırır. 

Bileşen elden çıkarma 

Örneğin, Kullanıcı başka bir sayfaya gezindiği için, bir bileşen kullanıcı arabiriminden kaldırılabilir. 

System.IDİsposable uygulayan bir bileşen kullanıcı arabiriminden kaldırıldığında, çerçeve bileşenin Dispose 
yöntemini çağırır. 

Bileşenin Dispose yöntemi işlenmeyen bir özel durum oluşturursa, bu özel durum devre dışı olarak önemli olur. 
Çıkarma mantığı özel durumlar oluşturmayabilir, uygulama hata işleme ve günlüğe kaydetme iletry-catch ifadesini 
kullanarak özel durumları yakalemelidir. 

Bileşen aktiften çıkarma hakkında daha fazla bilgi için bkz. AS P.N ET Core Blazor yaşam döngüsü. 

JavaScript ile birlikte çalışma 

ıusRuntime. invokeAsynccT > , .N ET kodunun Kullanıcı tarayıcısındaki JavaScript çalışma zamanına zaman uyumsuz 
çağrılar yapmasına izin verir. 

invokeAsync<T> ile ilgili hata işleme için aşağıdaki koşullar geçerlidir: 

• invokeAsync<T> çağrısı eşzamanlı olarak başarısız olursa, .N ET özel durumu oluşur. invokeAsync<T> çağrısı 
başarısız olabilir, örneğin, sağlanan bağımsız değişkenler serileştirilemiyor. Geliştirici kodu özel durumu 
yakalamalı. Bir olay işleyicisindeki veya bileşen yaşam döngüsü yöntemindeki uygulama kodu bir özel durumu 
işlemezse, ortaya çıkan özel durum devre dışı olur. 

• invokeAsync<T> çağrısı zaman uyumsuz olarak başarısız olursa, .NET Task başarısız olur. Örneğin, JavaScript 
tarafı kodu bir özel durum oluşturduğundan veya rejected olarak tamamlanan bir Promise döndürdüğünden 

invokeAsync<T> çağrısı başarısız olabilir. Geliştirici kodu özel durumu yakalamalı. Avvait işleci kullanılıyorsa, 
yöntem çağrısını hata işleme ve günlüğe kaydetme ile try-catch ifadesinde sarmalamak olarak düşünün. Aksi 
takdirde, başarısız kod, devre için önemli olan işlenmemiş bir özel durumla sonuçlanır. 

• Varsayılan olarak, invokeAsync<T> çağrıları belirli bir süre içinde tamamlanmalıdır veya çağrı zaman aşımına 
uğrar. Varsayılan zaman aşımı süresi bir dakikadır. Zaman aşımı, kodu ağ bağlantısında veya hiçbir zaman bir 
tamamlanma iletisi göndermeme JavaScript kodundaki bir kaybına karşı korur. Çağrı zaman aşımına uğrarsa, 
elde edilen Task bir OperationCanceledExceptionbaşarısız olur. Günlüğe kaydetme ile özel durumu yakalar ve 
işleyin. 

Benzer şekilde, JavaScript kodu [jsinvokable] özniteliği tarafından belirtilen .net yöntemlerine çağrı başlatabilir. 
Bu .NET yöntemleri işlenmeyen bir özel durum oluşturur: 


• Özel durum devre için önemli olarak değerlendirilmez. 
















• JavaScript tarafı Promise reddedilir. 

.NET tarafında ya da yöntem çağrısının JavaScript tarafında hata işleme kodu kullanma seçeneğiniz vardır. 

Daha fazla bilgi için bkz. ASP.NET Core Blazor JavaScript birlikte çalışabilirliği. 

Devre işleyicileri 

Blazor, bir kullanıcının devresi durumu değiştiğinde bildirimleri alan bir devre /ş/ey/c/s/tanımlamasına olanak tanır. 
Aşağıdaki durumlar kullanılır: 

• initialized 

• connected 

• disconnected 

• disposed 

Bildirimler, circuitHandler soyut temel sınıfından devralan bir Dİ hizmeti kaydedilerek yönetilir. 

Özel bir devre işleyicisindeki Yöntemler işlenmeyen bir özel durum oluşturuyorsam, özel durum devre için önemli 
olur. Bir işleyicinin kodundaki veya yöntemleri çağrılan özel durumlara tolerans sağlamak için kodu bir veya daha 
fazla try-catch deyiminde hata işleme ve günlüğe kaydetme ile sarın. 

Devre elden çıkarma 

Bir kullanıcının bağlantısı kesilmediği ve Framework devre durumunu temizlemede bir devre dışı bırakıldığında, 
çerçeve devre dışı bırakıldı. Kapsamı elden atılırken, System. IDİsposableuygulayan hiçbir devre kapsamlı Dİ hizmeti 
yok. Herhangi bir Dİ hizmeti, elden çıkarma sırasında işlenmeyen bir özel durum oluşturursa, çerçeve özel durumu 
günlüğe kaydeder. 

Prerendering 

Blazor bileşenleri, component etiketi Yardımcısı kullanılarak, işlenmiş HTML biçimlendirmesinin kullanıcının ilk 
HTTP isteğinin bir parçası olarak döndürülmesi için önceden kullanılabilir. Bu şu şekilde geçerlidir: 

• Aynı sayfanın parçası olan tüm ön işlenmiş bileşenler için yeni bir devre oluşturma. 

• ilk HTML oluşturuluyor. 

• Kullanıcı tarayıcısının aynı sunucuya geri SignalR bir bağlantı kuruncaya kadar devreyi disconnected olarak 
kabul edin. Bağlantı oluşturulduğunda, devre üzerindeki etkileşim sürdürülür ve bileşenlerin HTM L işaretlemesi 
güncelleştirilir. 

Herhangi bir bileşen prerendering sırasında, örneğin bir yaşam döngüsü yöntemi veya işleme mantığı sırasında 
işlenmeyen bir özel durum oluşturursa: 

• Bu, devre için önemli bir durumdur. 

• Özel durum, component Tag Yardımcısı 'ndan çağrı yığınını ortaya atılır. Bu nedenle, özel durum geliştirici kodu 
tarafından açıkça yakalanmadığı takdirde tüm HTTP isteği başarısız olur. 

Normal koşullarda, prerendering başarısız olduğunda bileşeni oluşturma ve işleme devam etmek, çalışan bir 
bileşen işlenemediği için mantıklı değildir. 

Prerendering sırasında oluşabilecek hatalara tolerans sağlamak için hata işleme mantığı özel durum oluşturabilecek 
bir bileşenin içine yerleştirilmelidir. Try-catch deyimlerini hata işleme ve günlüğe kaydetme ile kullanın. Bir 
try-catch bildiriminde component etiketi yardımcısını sarmalama yerine, component etiketi Yardımcısı tarafından 
işlenen bileşene hata işleme mantığını koyun. 

HTML işaretlemesi kullanıcının ilk HTTP isteğinin bir parçası olarak döndürüldüğünden 
kullanılarak önceden uygulanabilir. Bu şu şekilde geçerlidir: 

• Aynı sayfanın parçası olan tüm ön işlenmiş bileşenler için yeni bir devre oluşturma. 


Blazor bileşenleri, işlenmiş 
Html.RenderComponentAsync 












• ilk HTML oluşturuluyor. 

• Kullanıcı tarayıcısının aynı sunucuya geri SignalR bir bağlantı kuruncaya kadar devreyi disconnected olarak 
kabul edin. Bağlantı oluşturulduğunda, devre üzerindeki etkileşim sürdürülür ve bileşenlerin HTM L işaretlemesi 
güncelleştirilir. 

Herhangi bir bileşen prerendering sırasında, örneğin bir yaşam döngüsü yöntemi veya işleme mantığı sırasında 
işlenmeyen bir özel durum oluşturursa: 

• Bu, devre için önemli bir durumdur. 

• Özel durum, Htmi.RenderComponentAsync çağrısından çağrı yığınını ortaya atılır. Bu nedenle, özel durum geliştirici 
kodu tarafından açıkça yakalanmadığı takdirde tüm HTTP isteği başarısız olur. 

Normal koşullarda, prerendering başarısız olduğunda bileşeni oluşturma ve işleme devam etmek, çalışan bir 
bileşen işlenemediği için mantıklı değildir. 

Prerendering sırasında oluşabilecek hatalara tolerans sağlamak için hata işleme mantığı özel durum oluşturabilecek 
bir bileşenin içine yerleştirilmelidir. Try-catch deyimlerini hata işleme ve günlüğe kaydetme ile kullanın, try-catch 
bildiriminde RenderComponentAsync çağrısını sarmalama yerine, RenderComponentAsync tarafından işlenen bileşene 
hata işleme mantığını koyun. 

Gelişmiş senaryolar 

Özyinelemeli işleme 

Bileşenler yinelemeli olarak iç içe olabilir. Bu, özyinelemeli veri yapılarını temsil etmek için kullanışlıdır.Örneğin, bir 
TreeNode bileşeni, düğüm alt öğelerinin her biri için daha fazla TreeNode bileşeni işleyebilir. 

Yinelemeli olarak işlenirken, sonsuz özyineleme sonucu veren kodlama desenlerinden kaçının: 

• Bir döngüyü içeren bir veri yapısını yinelemeli olarak işlemez. Örneğin, alt öğeleri içeren bir ağaç düğümünü 
işlemez. 

• Bir döngüyü içeren bir düzen zinciri oluşturmayın. Örneğin, düzeni kendisi olan bir düzen oluşturmayın. 

• Son kullanıcının, kötü amaçlı veri girişi veya JavaScript birlikte çalışabilirlik çağrıları aracılığıyla 
özyineleme/varyantları (kurallar) ihlal etmemenizi izin verme. 

Oluşturma sırasında sonsuz döngüler: 

• İşleme işleminin süresiz olarak devam etmesine neden olur. 

• Sonlandırılmamış bir döngü oluşturmaya eşdeğerdir. 

Bu senaryolarda, etkilenen devre askıda kalır ve iş parçacığı genellikle şunları yapmayı dener: 

• Süresiz olarak işletim sisteminin izin verdiği CPU süresini çok fazla kullanın. 

• Sınırsız miktarda sunucu belleği tükettin. Sınırsız bellek tüketme, Sonlandırılmamış bir döngünün her 
yinelemede bir koleksiyona giriş eklediği senaryoya eşdeğerdir. 

Sonsuz özyineleme desenlerinin önüne geçmek için, özyinelemeli işleme kodunun uygun durdurma koşullarını 
içerdiğinden emin olun. 

Özel işleme ağacı mantığı 

Çoğu Blazor bileşen . Razor dosyaları olarak uygulanır ve çıktılarını oluşturmak için RenderTreeBuiider üzerinde 
çalışan Logic üretmek için derlenir. Bir geliştirici, yordamsal C# kodu kullanarak RenderTreeBuiider mantığını el ile 
uygulayabilir. Daha fazla bilgi için bkz. AS P.N ET Core Razor bileşenleri oluşturma ve kullanma. 











VVARNING 

El ile işleme ağacı Oluşturucu mantığının kullanımı, genel bileşen geliştirme için önerilmeyen gelişmiş ve güvenli olmayan bir 
senaryo olarak değerlendirilir. 


RenderTreeBuiider kod yazılmışsa, geliştirici kodun doğruluğunu garanti etmelidir. Örneğin, geliştirici şunları 
sağlamalıdır: 

• openElement ve cioseElement çağrıları doğru dengelenir. 

• Öznitelikler yalnızca doğru yerlere eklenir. 

Hatalı elle işleme ağacı Oluşturucu mantığı kilitlenmeler, sunucu askıda kalma ve güvenlik açıkları dahil rastgele 
tanımsız davranışa neden olabilir. 

El ile işleme ağacı Oluşturucu mantığını aynı karmaşıklık düzeyinde ve aynı tehlike düzeyiyle, el ile derleme kodu 
veya MS İL yönergeleri yazarak değerlendirin. 
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Daniel Roth 

IMPORTANT 

Önizlemede Blazor VVeelsembly 

Blazor sunucusu ASP.NET Core 3,0 ' de desteklenir. Blazor VVebAssembly ASP.NET Core 3,1 için önizlemededir. 


Chrome 'da VVebAssembly üzerinde çalışan Blazor VVebAssembly uygulamalarında hata ayıklama için erken destek 
bulunur. 

Hata ayıklayıcı özellikleri sınırlıdır. Kullanılabilir senaryolar şunlardır: 

• Kesme noktaları ayarlayın ve kaldırın. 

• Kod veya özgeçmişden ( fs ) kod yürütme aracılığıyla tek adımlı ( F 10 ). 

• Yereller görünümü 1 nde, int , string ve booi türündeki tüm yerel değişkenlerin değerlerini gözlemleyin. 

• JavaScript 'ten .N ET 'e ve .N ET 'ten JavaScript 'e gidecek çağrı zincirleri dahil olmak üzere çağrı yığınına bakın. 

Şunları yapamazsınız: 

• int , string veya booi olmayan herhangi bir yerelin değerlerini gözlemleyin. 

• Herhangi bir sınıf özelliklerinin veya alanının değerlerini gözlemleyin. 

• Değerlerini görmek için değişkenlerin üzerine gelin. 

• Konsolunda ifadeleri değerlendirin. 

• Zaman uyumsuz çağrılar arasında adımla. 

• Diğer birçok sıradan hata ayıklama senaryosunu gerçekleştirin. 

Daha fazla hata ayıklama senaryosu geliştirmesi, mühendislik ekibinin bir odadır. 

Prerequisites 

Hata ayıklama aşağıdaki tarayıcılardan birini gerektirir: 

• Google Chrome (sürüm 70 veya üzeri) 

• Microsoft Edge Önizlemesi (Edge geliştirme kanalı) 

Yordam 

1. Debug yapılandırmasında bir Blazor VVebAssembly uygulaması çalıştırın, --configuration Debug seçeneğini 
DotNet Run komutuna geçirin: dotnet run --configuration Debug . 

2. Uygulamaya tarayıcıda erişin. 

3. Klavye odağını geliştirici araçları paneline değil uygulamaya yerleştirin. Hata ayıklama başlatıldığında geliştirici 
araçları paneli kapatılabilir. 

4. Aşağıdaki Blazorözgü klavye kısayolunu seçin: 

• Windows/Linux üzerinde shift+Ait+D 

• macOS üzerinde shift+cmd+D 

5. Uzaktan hata ayıklama etkinken tarayıcıyı yeniden başlatmak için ekranda listelenen adımları izleyin. 













6. Hata ayıklama oturumu başlatmak için aşağıdaki Blazorözgü klavye kısayolunu bir kez daha seçin: 

• Windows/Linux üzerinde shift+Ait+D 

• macOS üzerinde shift+cmd+D 

Uzaktan hata ayıklamayı etkinleştir 

Uzaktan hata ayıklama devre dışıysa, hata ayıklanabilir Brovvser sekmesi hata sayfası Chrome tarafından 
oluşturulur. Hata sayfası, hata ayıklama proxy 'sinin uygulamaya bağlanabilmesi için hata ayıklama bağlantı noktası 
Blazor açıkken Chrome çalıştırmaya yönelik yönergeler içerir. Tüm Chrome örneklerini kapatin ve belirtildiği 
şekilde Chrome 'u yeniden başlatın. 

Uygulamada hata ayıklama 

Uzaktan hata ayıklama etkinken Chrome çalışmaya başladıktan sonra hata ayıklama klavye kısayolu yeni bir hata 
ayıklayıcı sekmesi açar. Bir süre sonra, kaynaklar sekmesi uygulamadaki .net derlemelerinin listesini gösterir. Her 
bir derlemeyi genişletin ve hata ayıklama için kullanılabilen . cs/. Razor kaynak dosyalarını bulun. Kesme noktaları 
ayarlayın, uygulamanın sekmesine geri dönün ve kod yürütüldüğünde kesme noktaları isabet edilir. Kesme noktası 
isabet ettikten sonra, kod veya özgeçmişden ( fs ) kod yürütme işlemi normal şekilde tek adımlı ( Fie ). 

Blazor, Chrome DevTools protokolünü uygulayan ve protokolünü ile genişletgetiren bir hata ayıklama proxy 'si 
sağlar. N ET 'e özgü bilgiler. Klavye kısayolunun hata ayıklaması basıldığında Blazor, ara sunucu üzerindeki Chrome 
DevTools 'u gösterir. Proxy, hata ayıklama işlemini Aradığınız tarayıcı penceresine bağlanır (Bu nedenle, uzaktan 
hata ayıklamayı etkinleştirmeniz gerekir). 

Tarayıcı kaynağı eşlemeleri 

Tarayıcı kaynak haritaları tarayıcının derlenmiş dosyaları özgün kaynak dosyalarına geri eşlemesine ve istemci tarafı 
hata ayıklama için yaygın olarak kullanılmasına izin verir. Ancak, Blazor Şu anda doğrudan C# JavaScript/, ile 
eşlenmiyor. Bunun yerine, Blazor, kaynak haritaları ilgili değil, tarayıcı içinde II yorumu yapar. 

Sorun giderme ipucu 

Hatalar halinde çal işti rıyorsanız, aşağıdaki ipucu yardımcı olabilir: 

Hata ayıklayıcı sekmesinde, tarayıcınızda Geliştirici Araçları ' nı açın. Konsolunda, tüm kesme noktalarını 
kaldırmak için iocaistorage.ciear() yürütün. 
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IMPORTANT 

Önizlemede Blazor VVeelsembly 

Blazor sunucusu ASP.NET Core 3,0 ' de desteklenir. Blazor WebAssembly ASP.NET Core 3,1 için önizlemededir. 


Blazor VVebAssembly Apps, önceden yapılandırılmış bir Httpciient hizmetini kullanarak Web API ’lerini çağırır. 
Blazor JSON yardımcıları veya HttpRequestMessagekullanarak JavaScript getirme API 'si seçeneklerini içerebilen 
oluşturma istekleri. 

Blazor Server Apps, genellikle IHttpClientFactorykullanılarak oluşturulan HttpClient örneklerini kullanarak Web 
API 'lerini çağırır. Daha fazla bilgi için bkz. ASP.NET Core 'de ıhttpclientfactory kullanarak HTTP istekleri yapın. 

Örnek kodu görüntüleyin veya indirin (nasıl İndirilir) - BlazorWebAssemblySample uygulamasını seçin. 

BlazorVVebAssemblySample örnek uygulamasında aşağıdaki bileşenlere bakın: 

• Web API çağrısı ( Pages/CallWebAPI. Razor) 

• HTTP İsteği Sınayıcısı ( Bileşenler/HTTPRequestTester. Razor) 

Paketler 

Deneysel Microsoft. aspnetcore.Blazorbaşvurun. Proje dosyasındaki HttpClient NuGet paketi. 

Microsoft.AspNetcore.Blazor.Httpciient , HttpClient ve System. Text. JSONtabanlıdır. 

Kararlı bir API kullanmak için, Nevvtonsoft. Json/JSON.netkullanan Microsoft. Aspnet. VVebApi. Client paketini 
kullanın. Microsoft.AspNet.webApi.Client ' de kararlı API kullanmak, bu konu başlığı altında açıklanan, deneysel 
Microsoft.AspNetcore.Blazor.Httpciient paketine özgü olan JSON yardımcıları sağlamaz. 

HttpClient ve JSON yardımcıları 

Blazor VVebAssembly uygulamasında, HttpClient , istekleri kaynak sunucuya geri getirmek için önceden 
yapılandırılmış bir hizmet olarak kullanılabilir. 

Blazor sunucusu uygulaması, varsayılan olarak bir Httpciient hizmeti içermez. HttpClient Factory 
altyapısınıkullanarak uygulamaya Httpciient sağlayın. 

Httpciient ve JSON yardımcıları, üçüncü taraf VVeb API uç noktalarını çağırmak için de kullanılır. Httpciient , 
tarayıcı getirme API 'si kullanılarak uygulanır ve aynı kaynak ilkesini zorlama dahil olmak üzere sınırlamalarına 
tabidir. 

istemcinin temel adresi, kaynak sunucunun adresine ayarlanır. @inject yönergesini kullanarak bir Httpciient 
örneği ekleme: 

@using System.Net.Http 
(Şinject HttpClient Http 

















Aşağıdaki örneklerde, bir Todo Web API 'SI oluşturma, okuma, güncelleştirme ve silme (CRUD) işlemlerini işler. 
Örnekler, aşağıdakileri depolayan bir Todoitem sınıfına dayalıdır: 

• Öğenin benzersiz KİMLİĞİ - KİMLİK ( id , long ). 

• Öğenin adi ( Name" string )-adı. 

• Durum ( isComplete , booi ) Todo öğesi tamamlandığında gösterge -. 

private class Todoitem 

{ 

public long Id { get; set; } 
public string Name { get; set; } 
public bool IsComplete { get; set; } 

} 


JSON yardımcı yöntemleri bir URI 'ye (aşağıdaki örneklerde bir Web API 'si) istek gönderir ve yanıtı işler: 

• GetisonAsync - bir HTTP GET isteği gönderir ve bir nesne oluşturmak için JSON yanıt gövdesini ayrıştırır. 

Aşağıdaki kodda _todoitems bileşen tarafından görüntülenir. GetTodoitems yöntemi, bileşen işlemeyi 
tamamladığında tetiklenir (Onınitializedadsync). Örnek uygulamaya bkz. örnek uygulama. 

@using System.Net.Http 
(Sinject HttpClient Http 

@code { 

private TodoItem[] _todoItems; 

protected override async Task OnInitializedAsync() => 

_todoItems = await Http.GetlsonAsync<TodoItem[]>("api/TodoItems"); 

} 

• PostisonAsync - JSON kodlu içerik dahil olmak üzere bir HTTP POST isteği gönderir ve bir nesne 
oluşturmak için JSON yanıt gövdesini ayrıştırır. 


Aşağıdaki kodda, _newitemName bileşenin bağlantılı bir öğesi tarafından sağlanır. Additem yöntemi bir 
<button> öğesi seçilerek tetiklenir. Örnek uygulamaya bkz. örnek uygulama. 

@using System.Net.Http 
(Şinject HttpClient Http 

cinput @bind="_newItemName" placeholder="New Todo Item" /> 

<button @onclick="@AddItem">Add</button> 

@code { 

private string _newItemName; 

private async Task Addltem() 

{ 

var additem = new Todoitem { Name = _newItemName, IsComplete = false }; 
await Http.PostIsonAsync("api/TodoItems"j additem); 

} 

} 

• PutisonAsync JSON kodlu içerik dahil olmak üzere bir HTTP PUT isteği gönderir. 

Aşağıdaki kodda, Name ve isCompleted değerlerinin _editıtem , bileşenin bağlantılı öğeleri tarafından 
sağlanır. Öğenin id , öğe Kullanıcı arabiriminin başka bir bölümünde seçildiğinde ve Editıtem 
çağrıldığında ayarlanır, saveitem yöntemi, Kaydet <button> öğesi seçilerek tetiklenir. Örnek uygulamaya 
bkz. örnek uygulama. 
















@using System.Net.Http 
(Şinject HttpClient Http 

cinput type="checkbox" @bind="_editltem.IsComplete" /> 

<input @bind="_editItem.Name" /> 

<button @onclick="@SaveItem">Save</button> 

@code { 

private Todoltem _editltem = new TodoItem(); 

private void EditItem(long id) 

{ 

var editltem = _todoItems.Single(i => i.Id == id); 

_editltem = new Todoltem { Id = editltem.Idj Name = editltem.Name, 
IsComplete = editltem.IsComplete }; 

} 

private async Task Saveltem() => 

await Http.PutlsonAsync($"api/TodoItems/{_editItem.Id}j _editltem); 

} 


System.Net.Http, HTTP istekleri göndermeye ve HTTP yanıtlarını almaya yönelik ek uzantı yöntemleri içerir. 
HttpClient. DeleteAsync , BİR Web API 'SİNE http delete isteği göndermek için kullanılır. 

Aşağıdaki kodda, DELETE <button> öğesi Deleteitem yöntemini çağırır. Bağlantılı <input> öğesi, silinecek 
öğenin id sağlar. Örnek uygulamaya bkz. örnek uygulama. 

@using System.Net.Http 
(Şinject HttpClient Http 

cinput @bind="_id" /> 

cbutton @onclick="@DeleteItem">Delete</button> 

@code { 

private long _id; 

private async Task Deleteltem() => 

await Http.DeleteAsync($"api/TodoItems/{_id}"); 

} 


Çıkış noktaları arası kaynak paylaşımı (CORS) 

Tarayıcı güvenliği, bir Web sayfasının, Web sayfasını sunduğundan farklı bir etki alanına istek yapmasını engeller. 
Bu kısıtlamaya aynı-Origin ilkesiadı verilir. Aynı-kaynak ilkesi, kötü niyetli bir sitenin gizli verileri başka bir siteden 
okumasını engeller. Tarayıcıdan farklı bir kaynağa sahip bir uç noktaya istek yapmak için uç noktanın , çıkış 
noktaları arası kaynak PAYLAŞıMı ’nı (CORS)etkinleştirmesi gerekir. 

Blazor VVebAssembly örnek uygulaması (BlazorVVebAssemblySample) , Web API bileşeninde CORS 'nin 
kullanımını gösterir ( Pages/callwebapi. Razor). 

Diğer sitelerin uygulamanıza çıkış noktaları arası kaynak paylaşımı (CORS) istekleri yapmasına izin vermek için 
bkz. ASP.N ET Core 'de çıkış noktaları arası İstekleri (CORS) etkinleştirme. 

API istek seçeneklerini getiren HttpClient ve HttpRequestMessage 

Blazor VVebAssembly uygulamasında VVebAssembly üzerinde çalışırken, istekleri özelleştirmek için HttpClient ve 
HttpReguestMessage kullanın. Örneğin, istek URI 'SI, HTTP yöntemi ve istenen istek üst bilgilerini belirtebilirsiniz. 








@using System.Net.Http 
@using System.Net.Http.Headers 
(Şinject HttpClient Http 

@code { 

private async Task PostRequest() 

{ 

Http.DefaultRequestHeaders.Authorization = 

new AuthenticationHeaderValue("Bearer", "{OAUTH TOKEN}"); 

var requestMessage = new HttpRequestMessage() 

{ 

Method = new HttpMethod("POST"), 

RequestUri = new Uri("https://localhost:10000/api/TodoItems"), 
Content = 

new StringContent( 

@"{""name"":""A New Todo item"",""isComplete"":false}") 

}; 

requestMessage.Content.Headers.ContentType = 

new System.Net.Http.Headers.MediaTypeHeaderValue( 

"application/json"); 

requestMessage.Content.Headers.TryAddWithoutValidation( 
"x-custom-header", "value"); 

var response = await Http.SendAsync(requestMessage); 

var responseStatusCode = response.StatusCode; 

var responseBody = await response.Content.ReadAsStringAsync(); 

} 

} 


API seçenekleri getirme hakkında daha fazla bilgi için bkz. MDN Web belgeleri: WindowOrWorkerGlobalScope. 
Fetch ():P arameters. 

CORS isteklerinde kimlik bilgileri (yetkilendirme tanımlama bilgileri/üstbilgileri) gönderilirken, CORS ilkesi 
tarafından Authorization üst bilgisine izin verilmelidir. 

Aşağıdaki ilke için yapılandırma içerir: 

• istek kaynakları ( http://localhost:5000 , https://localhost:5001 ). 

• Any yöntemi (fiil). 

• Content-Type ve Authorization Üst bilgileri. Özel bir ÜStbİlgİye (Örneğin, x-custom-header ) izin vermek için, 
VVİthHeadersçağrılırken üstbilgiyi listeleyin. 

• istemci tarafı JavaScript kodu tarafından ayarlanan kimlik bilgileri ( credentials Özellik inciude olarak 
ayarlanır). 


app.UseCors(policy => 

policy.WithOrigins("http://localhost:5000 ", "https://localhost:5001") 

.AllowAnyMethod() 

.WithHeaders(HeaderNames.ContentType, HeaderNames.Authorization, "x-custom-header") 
.AllowCredentials()); 


Daha fazla bilgi için bkz. ASP.NET Core 'de çıkış noktaları arası İstekleri (CORS) etkinleştirme ve örnek 
uygulamanın HTTP İsteği Sınayıcısı bileşeni ( Bileşenler/HTTPRequestTester. Razor). 

Ek kaynaklar 

• ASP.NET Core 'de ıhttpclientfactory kullanarak HTTP istekleri yapın 

• ASP.NET Core'de HTTPS'yi zorla 









Kestrel HTTPS uç noktası yapılandırması 

W3C üzerinde çapraz kaynak kaynak paylaşımı (CORS) 
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IMPORTANT 

Önizlemede Blazor VVeelsembly 

Blazor sunucusu ASP.NET Core 3,0 ' de desteklenir. Blazor VVebAssembly ASP.NET Core 3,1 için önizlemededir. 


Uygulamayı yayımlama 

Uygulamalar yayın yapılandırmasında dağıtım için yayımlanır. 

• Visual Studio 

• .NET Core CLI 

1. Gezinti çubuğundan derleme > {APPLICATION} Yayımla ' yı seçin. 

2. Yayımla hedefirılseçn. Yerel olarak yayımlamak için klasör' ü seçin. 

3. Klasör seçin alanında varsayılan konumu kabul edin veya farklı bir konum belirtin. Yayımla düğmesini seçin. 

Uygulamanın yayımlanması, projenin bağımlılıklarını geri yüklemeyi tetikler ve dağıtım için varlıkları oluşturmadan 
önce projeyi oluşturur . Yapı işleminin bir parçası olarak, uygulama indirme boyutunu ve yükleme sürelerini 
azaltmak için kullanılmayan Yöntemler ve derlemeler kaldırılır. 

Blazor VVebAssembly uygulaması /BIN/Release/{Target Framework}/publish/{ASSEMBLY Name}/Dist klasörüne 
yayımlanır. Bir Blazor sunucusu uygulaması /BIN/Release/{Target Framework}/Publish klasörüne yayımlanır. 

Klasördeki varlıklar Web sunucusuna dağıtılır. Dağıtım, kullanımdaki geliştirme araçlarına bağlı olarak el ile veya 
otomatik bir süreç olabilir. 

Uygulama temel yolu 

Uygulama temelyolu , UYGULAMANIN kök URL yoludur.Aşağıdaki ASP.NET Core uygulamayı ve Blazor alt 
uygulamayı göz önünde bulundurun: 

• ASP.NET Core uygulamasının adı MyApp : 

o Uygulama fiziksel olarak d./MyAppkonumunda bulunur. 



o Alt uygulama fiziksel olarak d:/MyApp/CoolApp konumunda bulunur, 
o istekler https://www.contoso.com/CoolApp/{COOLAPP RESOURCE} alindi. 

coolApp için ek yapılandırma belirtmeden, Bu senaryodaki alt uygulama, sunucuda nerede bulunduğu konusunda 
bilgi sahibi değildir. Örneğin, uygulama, /CoolApp/ göreli URL yolunda bulunduğunu bilmeden kaynaklarına doğru 
göreli URL 'Ler oluşturamıyoruz. 

Blazor uygulamasının temel https://www.contoso.com/cooiApp/ yolu için yapılandırma sağlamak üzere <base> 
etiketinin href özniteliği Pages/_Flost. cshtml dosyasında (Blazor Server) veya wwwrootAndex.html dosyasında 
(Blazor vvebassembly) göreli kök yolu olarak ayarlanır: 














<base href="/CoolApp/"> 

Blazor sunucu uygulamaları, uygulamanın startup.configure istek ardışık düzeninde UsePathBase çağırarak 
sunucu tarafı taban yolunu da ayarlar: 

app.UsePathBase("/CoolApp"); 

Göreli URL yolunu sağlayarak, kök dizinde olmayan bir bileşen, uygulamanın kök yoluna göre URL 'Ler 
oluşturabilir. Farklı dizin yapısı düzeylerindeki bileşenler, uygulama genelinde konumlardaki diğer kaynakların 
bağlantılarını oluşturabilir. Uygulama temel yolu Ayrıca, bağlantının href hedefinin uygulama temel yolu URI alanı 
içinde olduğu seçili köprüleri ele almak için de kullanılır. Blazor yönlendirici iç gezintiyi işler. 

Birçok barındırma senaryosunda, uygulamanın göreli URL yolu uygulamanın köküdür. Bu durumlarda, 
i URL taban yolu bir Blazor uygulamasının varsayılan yapılandırması olan eğik çizgi ( 

) olur.GitHub sayfaları ve 11S alt uygulamaları gibi diğer barındırma senaryolarında, uygulama 
temel yolu, sunucunun uygulamanın göreli URL 'SI yolu olarak ayarlanmalıdır. 

Uygulamanın temel yolunu ayarlamak için, Pages/_Host. cshtml dosyasının (Blazor Server) veya 
wwwrootAndex.html dosyasının (Blazor vvebassembly) <head> etiketi öğeleri içindeki <base> etiketini 
güncelleştirin, href öznitelik değerini /{relative url path}/ olarak ayarlayın (sondaki eğik çizgi gereklidir), 
burada {relative url path} uygulamanın tam göreli URL yoludur. 

Kök olmayan göreli URL yolu (örneğin, cbase href="/cooiApp/"> ) olan bir Blazor VVebAssembly uygulaması için, 
uygulama yerel olarak çaUştırıldiğında kaynaklarını bulamaz. Yerel geliştirme ve test sırasında bu sorunu aşmak için, 
çalışma zamanında <base> etiketinin href değeriyle eşleşen biryo/ temel bağımsız değişkeni sağlayabilirsiniz. 
Sondaki eğik çizgi eklemeyin. Uygulamayı yerel olarak çalıştırırken yol temel bağımsız değişkenini geçirmek için, 
--pathbase seçeneğiyle uygulamanın dizininden dotnet run komutunu yürütün: 

dotnet run --pathbase=/{RELATIVE URL PATH (no trailing slash)} 

Göreli URL yolu /coolApp/ ( cbase href="/cooiApp/"> ) olan bir Blazor VVebAssembly uygulaması için, komut şu 
şekilde olur: 

dotnet run --pathbase=/CoolApp 

Blazor VVebAssembly uygulaması, http://iocaihost:port/cooiApp yerel olarak yanıt verir. 

Dağıtım 

Dağıtım Kılavuzu için aşağıdaki konulara bakın: 

• ASP.NET Core Blazor VVebAssembly 'ı barındırma ve dağıtma 

• ASP.NET Core Blazor sunucusu barındırma ve dağıtma 


uygulamanın görel 
cbase href="/" /> 
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IMPORTANT 

Önizlemede Blazor VVeelsembly 

Blazor sunucusu ASP.NET Core 3,0 ' de desteklenir. Blazor VVebAssembly ASP.NET Core 3,1 için önizlemededir. 


Blazor VVebAssembly barındırma modeliyle: 

• Blazor uygulaması, bağımlılıkları ve .NET çalışma zamanı tarayıcıya indirilir. 

• Uygulama doğrudan tarayıcı kullanıcı arabirimi iş parçacığında yürütülür. 

Aşağıdaki dağıtım stratejileri desteklenir: 

• Blazor uygulama ASP.NET Core bir uygulama tarafından sunulur.Bu strateji ASP.NET Core bölümünde 
barındırılan dağıtımda ele alınmıştır. 

• Blazor uygulaması, .NET Blazor uygulamasına hizmet vermek için kullanılmayan bir statik barındırma VVeb 
sunucusuna veya hizmetine yerleştirilir. Bu strateji tek başına dağıtım bölümünde ele alınmıştır. Bu, bir Blazor 
VVebAssembly UYGULAMASıNı bir IIS alt uygulaması olarak barındırma hakkında bilgiler içerir. 

Doğru yönlendirme için URL 1 Leri yeniden yazın 

Blazor VVebAssembly uygulamasındaki sayfa bileşenlerine yönelik yönlendirme istekleri, Blazor sunucusu, 
barındırılan bir uygulamada yönlendirme istekleri kadar basittir, iki bileşeni olan bir Blazor VVebAssembly 
uygulaması düşünün: 

• Main. razor- uygulamanın köküne yüklenir ve About bileşenine bir bağlantı içerir ( href="About" ). 

• .Razor- About bileşeni hakkında. 

Uygulamanın varsayılan belgesi, tarayıcının adres çubuğu kullanılarak istendiğinde (örneğin, 
https://www.contoso.com/ ): 

1. Tarayıcı bir istek yapar. 

2. Varsayılan sayfa döndürülür, bu genellikle;ndex. html'dır. 

3. uygulamanın index. html önyükleme. 

4. Blazoryönlendirici yükleri ve Razor Main bileşeni işlenir. 

Ana sayfada, Blazor yönlendirici tarayıcının About için www.contoso.com için bir istek yapmasını durdurduğundan 
ve işlenmiş About bileşeninin kendisini hizmet ettiğinden, About bileşene olan bağlantıyı seçmek istemcide çalışır. 
Blazor VVebAssembly uygulamasL içindeki iç uç noktalara yönelik tüm istekler aynı şekilde çalışır: istekler tarayıcı 
tabanlı istekleri Internet 'teki sunucu tarafından barındırılan kaynaklara tetiklemez. Yönlendirici istekleri dahili olarak 
işler. 

www.contoso.com/About için tarayıcının adres çubuğu kullanılarak bir istek yapılırsa, istek başarısız olur. Uygulamanın 
Internet ana bilgisayarında böyle bir kaynak yok, bu nedeni e 404-bulunamayan bir yanıt döndürülür. 


















Tarayıcılar, istemci tarafı sayfaları için Internet tabanlı konaklara istek yaptığından, Web sunucuları ve barındırma 
hizmetleri, fiziksel olarak sunucu üzerinde olmayan kaynakların tüm isteklerini Dizin, html sayfasına yeniden 
yazmalıdır. index. html döndürüldüğünde, uygulamanın Blazor yönlendiricisi, doğru kaynakla yararlanır ve yanıt 
verir. 

Bir 11S sunucusuna dağıtım yaparken, URL yeniden yazma modülünü uygulamanın yayınlanan Web. config 
dosyasıyla birlikte kullanabilirsiniz. Daha fazla bilgi için 11S bölümüne bakın. 

ASP.NET Core ile barındırılan dağıtım 

Barındırılan bir dağıtım , bir Web sunucusu üzerinde çalışan bir ASP.NET Core uygulamasındaki tarayıcılara Blazor 
vvebassembly uygulamasını sunar. 

Blazor uygulaması, yayımlanan çıktıda ASP.NET Core uygulamasına dahildir, böylece iki uygulama birlikte dağıtılır. 
ASP.NET Core uygulamasını barındırabilen bir Web sunucusu gereklidir.Barındırılan bir dağıtım için Visual Studio, 
barındırılan seçeneği belirlenmiş olarak, Blazor VVebassembly uygulama projesi şablonunu ( DotNet New 
komutu kullanılırken biazorwasm şablonu) içerir. 

Uygulama barındırma ve dağıtım ASP.NET Core hakkında daha fazla bilgi için bkz. ASP.NET Core barındırma ve 
dağıtma. 

Azure App Service dağıtma hakkında daha fazla bilgi için bkz. Visual Studio ile Azure'a bir ASP.NET Core 
uygulaması yayımlama. 

Tek başına dağıtım 

Tek başına dağıtım , istemci tarafından doğrudan istenen statik dosyalar kümesi olarak Blazor VVebAssembly 
uygulamasına hizmet verir. Herhangi bir statik dosya sunucusu Blazor uygulamasına sunabilir. 

Tek başına dağıtım varlıkları bin/Release/{Target Framev/ork}/publish/{ASSEMBLY Name}/Dist klasöründe 
yayımlanır. 

IIS 

IIS, Blazor uygulamalar için özellikli bir statik dosya sunucusudur. IIS 'yi Blazorbarındıracak şekilde yapılandırmak 
için bkz. IIS 'de statik Web sitesi oluşturma. 

Yayımlanan varlıklar /BIN/Release/{Target Framework}/Publish klasöründe oluşturulur. Web sunucusunda veya 
barındırma hizmetinde Yayımlama klasörünün içeriğini barındırın. 

Web. config 

Bir Blazor projesi yayımlandığında, aşağıdaki IIS yapılandırmasıyla bir Web. config dosyası oluşturulur: 

• MİME türleri aşağıdaki dosya uzantıları için ayarlanır: 
o .dil— application/octet-stream 

o .json - application/json 
o . — application/wasm 
o . WOFF ~ application/font-woff 
o . woff2 — application/font-woff 

• Aşağıdaki MİME türleri için HTTP sıkıştırması etkindir: 


application/octet 

-stream 

application/wasm 



• URL yeniden yazma modülü kuralları oluşturuldu: 

o Uygulamanın statik varlıklarının bulunduğu alt dizini ( {Assembly Name}/dist/{PATFI istenen} ) sunar, 
o Dosya olmayan varlıklar için isteklerin statik varlıklar klasöründe ( {Assembly Name}/Dist/index.html) 
uygulamanın varsayılan belgesine yeniden YÖNLENDİRİLMESİ için Spa geri dönüş yönlendirmesi 








oluşturun. 


URL yeniden yazma modülünü yükler 

URL yeniden yazma modülü , URL 'leri yeniden yazmak için gereklidir. Modül varsayılan olarak yüklenmez ve bir 
Web sunucusu (MS) rol hizmeti özelliği olarak yükleme için kullanılamaz. Modül 11S Web sitesinden indirilmelidir. 
Modülünü yüklemek için Web Platformu Yükleyicisi'ni kullanın: 

1. Yerel olarak, URL yeniden yazma modülü indirmeleri sayfasınagidin. İngilizce sürümünde, VVebPI yükleyicisini 
indirmek için VVebPI ' ı seçin. Diğer diller için, yükleyiciyi indirmek üzere sunucu için uygun mimariyi (x86/x64) 
seçin. 

2. Yükleyiciyi sunucuya kopyalayın. Yükleyiciyi çalıştırın., Install düğmesini seçin ve lisans koşullarını kabul edin. 
Yüklemesi tamamlandıktan sonra sunucu yeniden başlatması gerekli değildir. 

Web sitesini yapılandırma 

Web sitesinin fiziksel yolunu uygulamanın klasörüne ayarlayın. Klasör şunları içerir: 

• Gerekli yeniden yönlendirme kuralları ve dosya içerik türleri dahil olmak üzere US 'nin Web sitesini 
yapılandırmak için kullandığı Web. config dosyası. 

• Uygulamanın statik varlık klasörü. 

MS alt uygulaması olarak barındırma 

Tek başına bir uygulama bir 11S alt uygulaması olarak barındırılıyorsa, aşağıdakilerden birini yapın: 

• Devralınan ASP.NET Core modülü işleyicisini devre dışı bırakın. 

Dosyaya bir <handiers> bölümü ekleyerek Blazor uygulamasının yayınlanan Web. config dosyasındaki 
işleyiciyi kaldırın: 

<handlers> 

cremove name="aspNetCore" /> 

</handlers> 

• inheritinChildAppiications faise olarak ayarlanan <iocation> bir öğesi kullanarak kök (üst) uygulamanın 
<system.webServer> bölümünü devralmayı devre dışı bırakın: 

<?xml version="1.0" encoding="utf-8"?> 

<configuration> 

docation path="." inheritInChildApplications="false"> 

<system.webServer> 

<handlers> 

<add name="aspNetCore" ... /> 

</handlers> 

<aspNetCore ... /> 

</system.webServer> 

</location> 

</configunation> 


işleyicinin kaldırılması veya devralma devre dışı bırakılması, uygulamanın temel yolunun yapılandırılmasınaek 
olarak gerçekleştirilir. Uygulamanın index. htnnl dosyasındaki uygulama temel yolunu, US 'de alt uygulamayı 
YAPıLANDıRıRKEN kullanılan MS diğer adına ayarlayın. 

Sorun giderme 

500-lç sunucu hatası ALıNMıŞSA ve US Yöneticisi Web sitesinin yapılandırmasına erişmeye çalışırken hatalar 
OLUŞTURURSA, URL yeniden yazma modülünün yüklü olduğunu doğrulayın. Modül yüklü olmadığında, Web. 
config dosyası US tarafından ayrıştırılamaz. Bu, IIS yöneticisinin Web sitesinin yapılandırmasını ve Web sitesinin 
Blazorstatik dosyalarına hizmet etmesini engeller. 

US ile dağıtım sorunlarını giderme hakkında daha fazla bilgi için bkz. Azure App Service ve US 'de ASP.NET Core 




sorunlarını giderme. 


Azure Depolama 

Azure depolama statik dosya barındırma, sunucusuz Blazor uygulama barındırılmasına olanak sağlar.Özel etki alanı 
adları, Azure Content Delivery Netvvork (CDN) ve HTTPS desteklenir. 

Blob hizmeti bir depolama hesabında barındırılan statik Web sitesi için etkinleştirildiğinde: 

• Dizin belgesi adını index.html olarak ayarlayın. 

• Hata belge yolunu index.html olarak ayarlayın. Razor bileşenleri ve diğer dosya olmayan uç noktaları, blob 
hizmeti tarafından depolanan statik içerikte fiziksel yollarda yer vermez. Blazor yönlendiricisinin işlemesi 
gereken bu kaynaklardan birine yönelik bir istek alındığında, blob hizmeti tarafından oluşturulan 404- 
bulunamayan hata, isteği hata belge yolunayönlendirir. index. html blobu döndürülür ve Blazor yönlendirici 
yolu yükler ve işler. 

Daha fazla bilgi için bkz. Azure Storage 'Da statik Web sitesi barındırma. 

NGINX 

Aşağıdaki NGINX. conf dosyası, NGINX 'in, disk üzerinde karşılık gelen bir dosyayı bulamadığı her seferinde index. 
html dosyasını göndermek üzere nasıl yapılandırılacağını gösterecek şekilde basitleştirilmiştir. 

events { } 
http { 

server { 

listen 80; 

location / { 

root /usr/share/nginx/html; 
try_files $uri $uri/ /index.html =404; 

} 

} 

} 

Üretim NGINX web sunucusu yapılandırması hakkında daha fazla bilgi için bkz. NGINX Plus ve NGINX 
yapılandırma dosyalan oluşturma. 

Docker'da NGINX 

Docker 'da NGINX kullanarak Blazor barındırmak için Dockerfile 'ı alp tabanlı NGINX görüntüsünü kullanacak 
şekilde ayarlayın. Dockerfile dosyasını, NGINX. config dosyasını kapsayıcıya kopyalamak için güncelleştirin. 

Aşağıdaki örnekte gösterildiği gibi Dockerfile dosyasına bir satır ekleyin: 

FROM nginx:alpine 

COPY ./bin/Release/netstandard2.0/publish /usr/share/nginx/html/ 

COPY nginx.conf /etc/nginx/nginx.conf 

Apache 

CentOS 7 veya üzeri bir Blazor VVebAssembly uygulaması dağıtmak için: 

1. Apache yapılandırma dosyasını oluşturun. Aşağıdaki örnek basitleştirilmiş bir yapılandırma dosyasıdır 
[blazorapp. config): 








cVirtualHost *:80> 

ServerName www.example.com 
ServenAlias *. example.com 

DocumentRoot "/var/www/blazorapp" 

ErrorDocument 404 /index.html 

AddType apllcation/wasm ,wasm 
AddType application/octet-stream .dil 

<Directory "/var/www/blazorapp"> 

Options -Indexes 
AllowOverride None 
</Directony> 

dfModule mod_deflate.c> 

AddOutputFilterByType DEFLATE text/css 
AddOutputFilterByType DEFLATE applicatlon/javascript 
AddOutputFilterByType DEFLATE text/html 
AddOutputFilterByType DEFLATE application/octet-stream 
AddOutputFilterByType DEFLATE application/wasm 
dfModule mod_setenvif. c> 

BrowserMatch A Mozilla/4 gzip-only-text/html 
BrowserMatch A Mozilla/4.0[678] no-gzip 
BrowserMatch bMSIE !no-gzip !gzip-only-text/html 
</IfModule> 

</IfModule> 

ErrorLog /var/log/httpd/blazorapp-error.log 
CustomLog /var/log/httpd/blazorapp-access.log common 
</VirtualFlost> 


2. Apache yapılandırma dosyasını, CentOS 7 ' de varsayılan Apache yapılandırma dizini olan 

/etc/httpd/conf .d/ dizinine yerleştirin. 

3. Uygulamanın dosyalarını /var/www/biazorapp dizinine yerleştirin (yapılandırma dosyasına DocumentRoot için 
belirtilen konum). 

4. Apache hizmetini yeniden başlatın. 

Daha fazla bilgi için bkz. mod_mime ve mod_deflate. 

GitHub sayfaları 

URL yeniden işlemesini işlemek için, isteği index. html sayfasına yönlendirmeyi işleyen bir betiği olan bir 404. html 
dosyası ekleyin. Topluluk tarafından sunulan örnek bir uygulama için bkz. GitHub sayfaları İçin tek sayfalı 
uygulamalar (GitHub üzerinde rafrex/Spa-GitHub-Pages). Topluluk yaklaşımını kullanan bir örnek, GitHub (canlı 
site) üzerinde blazor-demo/blazor-demo. GitHub. 10 adresinde görülebilir. 

Bir kuruluş sitesi yerine bir proje sitesi kullanırken, index. hfm/dosyasına <base> etiketi ekleyin veya güncelleştirin, 
href öznitelik değerini, sondaki eğik çizgiyle (örneğin, my-repository/ ) GitHub depo adına ayarlayın. 

Ana bilgisayar yapılandırma değerleri 

Blazor VVebAssembly Apps , geliştirme ortamındaki çalışma zamanında aşağıdaki ana bilgisayar yapılandırma 
değerlerini komut satırı bağımsız değişkenleri olarak kabul edebilir. 

İçerik kökü 

--contentroot bağımsız değişkeni, uygulamanın içerik dosyalarını (içerik kökü) içeren dizinin mutlak yolunu 
ayarlar. Aşağıdaki örneklerde, /content-root-path , uygulamanın içerik kök yoludur. 

• Uygulamayı bir komut isteminde yerel olarak çalıştırırken bağımsız değişkenini geçirin. Uygulamanın 











dizininden şunu yürütün: 


dotnet run --contentroot=/content-root-path 

• IIS Express profilindeki uygulamanın iaunchsettings. JSON dosyasına bir giriş ekleyin. Bu ayar, uygulama 
Visual Studio hata ayıklayıcıyla ve dotnet run ile bir komut isteminden çalıştırıldığında kullanılır. 

"commandLineArgs": "--contentroot=/content-root-path" 

• Visual Studio da > hata ayıklama > uygulama bağımsız değişkenlerinin Özelliklerbölümünde 

bağımsız değişkenini belirtin. Visual Studio özellik sayfasında bağımsız değişkeni ayarlama, bağımsız 
değişkenini Laurıchsettings. JSON dosyasına ekler. 

--contentroot=/content-root-path 

Yol tabanı 

--pathbase bağımsız değişkeni, kök olmayan göreli URL yoluyla yerel olarak çalıştırılan bir uygulamanın uygulama 
temel yolunu ayarlar ( <base> etiketi href , hazırlama ve üretim için / dışında bir yola ayarlanır). Aşağıdaki 
örneklerde, /relative-URL-path , uygulamanın yol tabanı olur. Daha fazla bilgi için bkz. uygulama temel yolu. 


IMPORTANT 

<base> etiketinin href olarak belirtilen yolun aksine, --pathbase bağımsız değişken değeri geçirilirken sondaki eğik çizgi ( 
/) eklemeyin. Uygulama temel yolu <base> etiketinde <base href="/coolApp/"> (sondaki eğik çizgi içeriyorsa) olarak 
sağlanmışsa, komut satırı bağımsız değişken değerini --pathbase=/coolApp (sondaki eğik çizgi olmadan) olarak geçirin. 


• Uygulamayı bir komut isteminde yerel olarak çalıştırırken bağımsız değişkenini geçirin. Uygulamanın 
dizininden şunu yürütün: 

dotnet run --pathbase=/relative-URL-path 

• MS Express profilindeki uygulamanın iaunchsettings. JSON dosyasına bir giriş ekleyin. Bu ayar, uygulamayı 
Visual Studio hata ayıklayıcıyla ve dotnet run ile bir komut isteminden çalıştırırken kullanılır. 

"commandLineArgs": "--pathbase=/relative-URL-path" 

• Visual Studio da > hata ayıklama > uygulama bağımsız değişkenlerinin Özelliklerbölümünde 

bağımsız değişkenini belirtin. Visual Studio özellik sayfasında bağımsız değişkeni ayarlama, bağımsız 
değişkenini Launchsettings. JSON dosyasına ekler. 

--pathbase=/relative-URL-path 

URL'ler 

--urls bağımsız değişkeni, istekler için dinlemek üzere bağlantı noktaları ve protokollerle İP adreslerini veya 
konak adreslerini ayarlar. 

• Uygulamayı bir komut isteminde yerel olarak çalıştırırken bağımsız değişkenini geçirin. Uygulamanın 
dizininden şunu yürütün: 

















dotnet run --urls=http://127.0.0.1:0 

• IIS Express profilindeki uygulamanın launchsettings. JSON dosyasına bir giriş ekleyin. Bu ayar, uygulamayı 
Visual Studio hata ayıklayıcıyla ve dotnet run ile bir komut isteminden çalıştırırken kullanılır. 

"commandLineArgs": "--urls=http://127.0.0.1:0" 

• Visual Studio da > hata ayıklama > uygulama bağımsız değişkenlerinin Özelliklerbölümünde 

bağımsız değişkenini belirtin. Visual Studio özellik sayfasında bağımsız değişkeni ayarlama, bağımsız 
değişkenini Laurıchsettings. JSON dosyasına ekler. 

--urls=http://127.0.0.1:0 


Bağlayıcıyı yapılandırma 

Blazor, çıkış derlemelerinden gereksiz II 'yi kaldırmak için her bir derlemede ara dil (İL) bağlamayı gerçekleştirir. 
Derleme bağlama, derleme üzerinde denetlenebilir.Daha fazla bilgi için bkz. ASP.NET Core Blazor için bağlayıcı 
yapılandırma. 
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Ana bilgisayar yapılandırma değerleri 

Blazor Server uygulamaları genel ana bilgisayar yapılandırma değerlerinikabul edebilir. 

Dağıtım 

Blazor sunucusu barındırma modelinikullanarak, Blazor sunucuda bir ASP.NET Core uygulaması içinden yürütülür. 
Kullanıcı Arabirimi güncelleştirmeleri, olay işleme ve JavaScript çağrıları SignalR bir bağlantı üzerinden işlenir. 

ASP.NET Core uygulaması barındırabilen bir Web sunucusu gerekiyor.Visual Studio, DotNet New komutu 
kullanılırken Blazor Server uygulaması proje şablonunu ( biazorserverside şablonu) içerir. 

Ölçeklenebilirlik 

Bir Blazor sunucusu uygulaması için kullanılabilir altyapıyı en iyi şekilde kullanmasını sağlamak üzere bir dağıtım 
planlayın. Blazor Server uygulama ölçeklenebilirliğini karşılamak için aşağıdaki kaynaklara bakın: 

• Blazor Server uygulamalarının temelleri 

• Güvenli ASP.NET Core Blazor Server uygulamaları 

Dağıtım sunucusu 

Tek bir sunucunun ölçeklenebilirliğini değerlendirirken (ölçeği büyütme), bir uygulama için kullanılabilir olan bellek 
büyük olasılıkla uygulamanın kullanıcı talebi arttıkça arttırabileceği ilk kaynaktır. Sunucudaki kullanılabilir bellek 
şunları etkiler: 

• Bir sunucunun destekleyebileceği etkin devre sayısı. 

• istemcide Ul gecikme süresi. 

Güvenli ve ölçeklenebilir Blazor sunucu uygulamaları oluşturma hakkında yönergeler için bkz. Güvenli ASP.NET 
Core Blazor Server uygulamaları. 

Her bağlantı hattı en düşük Merhaba Dünyostilinde bir uygulama için YAKLAŞıK 250 KB bellek kullanır.Bir 
devrenin boyutu, uygulamanın koduna ve her bileşenle ilişkili durum bakım gereksinimlerine bağlıdır. Uygulama ve 
altyapınız için geliştirme sırasında kaynak taleplerini ölçmenizi öneririz, ancak aşağıdaki taban çizgisi, dağıtım 
hedefini planlamada bir başlangıç noktası olabilir: uygulamanızın 5.000 eşzamanlı kullanıcı desteklemesini 
istiyorsanız, şu adreste bütçeleme yapmayı düşünün: uygulamaya en az 1,3 GB sunucu belleği (veya Kullanıcı 
başına ~ 273 KB). 

SignalR yapılandırması 

Blazor sunucu uygulamaları tarayıcıyla iletişim kurmak için ASP.NET Core SignalR kullanır. SignalRbarındırma ve 
ölçeklendirme koşulları Blazor sunucu uygulamaları için geçerlidir. 

daha düşük gecikme süresi, güvenilirlik ve güvenliknedeniyle SignalR taşıma olarak VVebSockets kullanırken Blazor 
en iyi şekilde işe yarar. Uzun yoklama, VVebSockets kullanılamadığında veya uygulama açıkça uzun yoklamayı 
kullanacak şekilde yapılandırıldığında SignalR tarafından kullanılır. Azure App Service dağıtım sırasında, 
uygulamayı hizmetin Azure portal ayarları içinde kullanmak üzere yapılandırın. Azure App Service için uygulamayı 
yapılandırma hakkında ayrıntılı bilgi için bkz. SignalR yayımlama yönergeleri. 








Azure SignalR hizmeti 

Blazor Server uygulamaları için Azure SignalR hizmetini kullanmanızı öneririz. Hizmet, Blazor sunucu 
uygulamasının ölçeğini çok sayıda eşzamanlı SignalR bağlantı ile ölçeklendirmeye olanak tanır. Ayrıca, SignalR 
hizmetin küresel erişim ve yüksek performanslı veri merkezleri Coğrafya nedeniyle gecikme süresini azaltmaya 
önemli ölçüde yardımcı olur. Azure SignalR hizmetini bir uygulamayı yapılandırmak (ve isteğe bağlı olarak 
sağlamak) için: 

1. Prerendering sırasında istemciler aynı sunucuya geri yönlendirildiği yapışkan oturumlarıdestek\err\ek için 
hizmeti etkinleştirin. serverstickyMode seçeneğini veya yapılandırma değerini Required olarak ayarlayın. 
Genellikle, bir uygulama aşağıdaki yaklaşımlardan birini kullanarak yapılandırmayı oluşturur: 


• Startup.ConfigureServices : 


Services.AddSignalR().AddAzureSignalR(options => 

{ 

options.ServerstickyMode = 

Microsoft.Azure.SignalR.ServerstickyMode.Required; 

}); 

• Yapılandırma (aşağıdaki yaklaşımlardan birini kullanın): 
o appSettings. JSON: 

"Azure:SignalR:ServerStickyMode": "Required" 


o App Service in yapılandırma Azure Portal uygulama ayarları > (ad: 

Azure:SignalR:ServerstickyMode , değer: Required ). 

2. Blazor Server uygulaması için Visual Studio 'da bir Azure Apps yayımlama profili oluşturun. 

3. Azure SignalR hizmeti bağımlılığını profile ekleyin. Azure aboneliğinin uygulamaya atanacak önceden 
mevcut bir Azure SignalR hizmeti örneği yoksa, yeni bir hizmet örneği sağlamak için Yeni bir azure 
SignalR hizmet örneği oluştur ' u seçin. 

4. Uygulamayı Azure'da yayımlama. 

MS 

11S kullanırken, yapışkan oturumlar uygulama İsteği yönlendirme ile etkinleştirilir. Daha fazla bilgi için bkz. 
uygulama İsteği yönlendirme kullanarak HTTP yük dengelemesi. 

Kubernetes 

Yapışkan oturumlar için aşağıdaki Kubernetes ek açıklamalarınıiçeren bir giriş tanımı oluşturun: 

apiVersion: extensions/vlbetal 
kind: Ingress 
metadata: 

name: <ingress-name> 
annotations: 

nginx.ingress.kubernetes.io/affinity: "cookie" 
nginx.ingress.kubernetes.io/session-cookle- name: "affinity" 
nginx.ingress.kubernetes.io/session-cookie-expires: "14400" 
nginx.ingress.kubernetes.io/session-cookie-max-age: "14400" 


Ölçü ağı gecikmesi 

Aşağıdaki örnekte gösterildiği gibi, js birlikte çalışması ağ gecikmesini ölçmek için kullanılabilir: 








Şinject IJSRuntime ]S 

Şif (latency is null) 

{ 

<span>Calculating...</span> 

} 

else 

{ 

<span>@(latency.Value.TotalMilliseconds)ms</span> 

} 

Şcode 

{ 

private DateTime startTime; 
private TimeSpan? latency; 

protected override async Task OnInitializedAsync() 

{ 

startTime = DateTime.UtcNow; 

var _ = await 3S.InvokeAsync<string>("toString"); 
latency = DateTime.UtcNow - startTime; 

} 


Makul bir kullanıcı arabirimi deneyimi için, 250ms veya daha az sayıda sürekli Kullanıcı arabirimi gecikme süresi 
önerilir. 
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IMPORTANT 

Önizlemede Blazor VVeelsembly 

Blazor sunucusu ASP.NET Core 3,0 ' de desteklenir. Blazor VVebAssembly ASP.NET Core 3,1 için önizlemededir. 


Blazor, uygulamanın çıkış derlemelerinden gereksiz II 'yi kaldırmak için bir derleme sırasında ara dil (İL) bağlamayı 
gerçekleştirir. 

Aşağıdaki yaklaşımlardan birini kullanarak derleme bağlamayı kontrol edin: 

• MSBuild özelliğiile genel olarak bağlamayı devre dışı bırakın. 

• Yapılandırma dosyasıile derleme temelinde bağlama denetimi. 

MSBuild özelliği ile bağlamayı devre dışı bırak 

Bir uygulama oluşturulduğunda, yayımlama de dahil olmak üzere varsayılan olarak bağlama etkindir.Tüm 
derlemeler için bağlamayı devre dışı bırakmak için BiazorLinkOnBuiid MSBuild özelliğini proje dosyasında faise 
olarak ayarlayın: 

<PropertyGroup> 

<BlazorLinkOnBuild>false</BlazorLinkOnBuild> 

</PropertyGroup> 


Yapılandırma dosyası ile bağlamayı denetleme 

Bir XML yapılandırma dosyası sağlayarak ve dosyayı proje dosyasında MSBuild öğesi olarak belirterek, derleme 
başına temelinde bağlamayı denetleyin: 

<ItemGroup> 

<BlazorLinkerDescriptor Include="Linker.xml" /> 

</ItemGroup> 


Bağlayicı. xmt: 










<?xml version="1.0" encoding="UTF-8" ?> 

<!-- 

This file specifies which parts of the BCL or Blazor packages must not be 
stripped by the IL Linker even if they aren't referenced by user code. 

--> 

<linker> 

cassembly fullname="mscorlib"> 

<!-- 

Preserve the methods in WasmRuntime because its methods are called by 
JavaScript client-side code to implement timers. 

Fixes: https://github.com/aspnet/Blazor/issues/239 

--> 

ctype fullname="System.Threading.WasmRuntime" /> 

</assembly> 

cassembly fullname="System.Core"> 

<!-- 

System.Linq.Expressions* is required by Json.NET and any 
expression.Compile caller. The assembly isn't stripped. 

--> 

ctype fullname="System.Linq.Expressions*" /> 

</assembly> 

<!-- 

In this example, the app's entry point assembly is listed. The assembly 
isn't stripped by the IL Linker. 

--> 

cassembly fullname="MyCoolBlazorApp" /> 

</linker> 


Daha fazla bilgi için bkz. II Bağlayıcısı: XML tanımlayıcısının sözdizimi. 

Bağlayıcıyı uluslararası duruma getirme için yapılandırma 

Varsayılan olarak, Blazor VVebAssembly uygulamaları için Blazorbağlayıcı yapılandırması, açıkça istenen yerel 
ayarlar dışında uluslararası duruma getirme bilgilerini kaldırır. Bu derlemelerin kaldırılması uygulamanın boyutunu 
en aza indirir. 

Hangi 118N derlemelerinin korunacağını denetlemek için, proje dosyasında cMonoLinkerii8NAssembiies> MSBuild 
özelliğini ayarlayın: 


<PropertyGroup> 

<MonoLinkerI18NAssemblies>{all|none|REGIONİ,REGI0N2, . 
</PropertyGroup> 

..}c/MonoLinkerI18NAssemblies> 

BÖLGE DEĞERİ 

MONO BÖLGESİ DERLEMESİ 

ali 

Tüm derlemeler dahil 

cjk 

118 N. CJK. dil 

mideast 

I18N. MİDEAST dil 

none (varsayılan) 

Yok. 

other 

I18N. Diğer, dil 

rare 

I18N. Nadir, dil 


west 


118N. Batı, dil 












Birden çok değeri ayırmak için virgül kullanın (örneğin, mideast,west ). 

Daha fazla bilgi için bkz. 118N: Pnetlib uluslararası duruma getirme çerçeve Libary (Mono/Mono GitHub deposu). 
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Güncelleştirilmiş angular proje şablonu, zengin, istemci tarafı Kullanıcı arabirimi (Ul) uygulamak için angular ve 
angular CLı kullanan ASP.NET Core uygulamalar için uygun bir başlangıç noktası sağlar. 

Şablon, bir API arka ucu görevi gören bir ASP.NET Core projesi ve Kullanıcı arabirimi olarak davranacak angular 
CLı projesi oluşturma ile eşdeğerdir. Şablon, her iki proje türünü tek bir uygulama projesinde barındırmanın 
kolaylığını sunar. Sonuç olarak, uygulama projesi tek bir birim olarak oluşturulup yayımlanabilir. 

Yeni bir uygulama oluşturma 

ASP.N ET Core 2,1 yüklüyse, angular proje şablonunu yüklemeye gerek yoktur. 

Boş bir dizinde komutunu dotnet new angular kullanarak komut isteminden yeni bir proje oluşturun. Örneğin, 
aşağıdaki komutlar uygulamayı Yeni bir uygulama dizininde oluşturur ve bu dizine geçer: 

dotnet new angular -o my-new-app 
cd my-new-app 

Uygulamayı Visual Studio 'dan veya .NET Core CLI çalıştırın: 

• Visual Studio 

• .NET Core CLI 

Oluşturulan . csproj dosyasını açın ve uygulamayı buradan normal olarak çalıştırın. 

Yapı işlemi ilk çalıştırmada N PM bağımlılıklarını geri yükler ve bu işlem birkaç dakika sürebilir.Sonraki derlemeler 
çok daha hızlıdır. 

Proje şablonu, bir ASP.NET Core uygulaması ve angular uygulaması oluşturur. ASP.NET Core uygulaması veri 
erişimi, yetkilendirme ve diğer sunucu tarafı sorunları için kullanılmak üzere tasarlanmıştır. Clientapp alt dizininde 
bulunan angular uygulamasının tüm Kullanıcı arabirimi sorunları için kullanılması amaçlanmıştır. 

Sayfa, resim, stil, modül vb. ekleyin 

Clientapp dizini standart ANGULAR CLI uygulaması içerir. Daha fazla bilgi için bkz. resmi angular belgeleri . 

Bu şablon tarafından oluşturulan angular uygulaması ve angular CLI 'nın kendisi (aracılığıyla ng new ) tarafından 
oluşturulan küçük farklılıklar vardır; ancak, uygulamanın özellikleri değiştirilmez. Şablon tarafından oluşturulan 
uygulama, önyüklemetabanlı bir düzen ve temel bir yönlendirme örneği içerir. 

Çalıştır komutları 

Bir komut isteminde clientapp alt dizinine geçin: 

cd ClientApp 

ng Araç genel olarak yüklüyse, komutlarından birini çalıştırabilirsiniz. Örneğin, diğer ng ünt angular CLI 
komutlarındanbirini veya birini çalıştırabilirsiniz ng test . ASP.NET Core uygulamanız uygulamanızın sunucu 
tarafı ve ng serve istemci tarafı bölümlerine sunma konusunda anlaştığından, ancak bu çalışmaya gerek yoktur. 









Dahili olarak, geliştirme ng serve sürecinde kullanır. 

Yüklü bir npm run ng araç yoksa, bunun yerine çalıştırın, ng Örneğin, veya npm run ng lint npm run ng test 
çalıştırabilirsiniz. 

NPM paketlerini yükler 

Üçüncü taraf NPM paketlerini yüklemek için clientapp alt dizininde bir komut istemi kullanın. Örneğin: 
cd ClientApp 

npm install --save <package_name> 


Yayımla ve dağıt 

Geliştirme aşamasında uygulama, geliştirici kolaylığı için iyileştirilmiş bir modda çalışır.Örneğin, JavaScript demeti 
kaynak eşlemeleri içerir (hata ayıklarken, özgün TypeScript kodunuzu görebilirsiniz). Uygulama TypeScript, HTML 
ve CSS dosya değişikliklerini diskte izler ve bu dosya değişikliğini gördüğünde otomatik olarak yeniden derlenir 
ve yeniden yükler. 

Üretimde, uygulamanızın performans için iyileştirilmiş bir sürümünü sunar.Bu otomatik olarak gerçekleşecek 
şekilde yapılandırılmıştır. Yayımladığınızda, derleme yapılandırması, istemci tarafı kodunuzun küçültülmüş, 
önceden derlenmiş bir derlemesini yayar. Geliştirme derlemesinin aksine, üretim derlemesi, Node. js 1 nin 
sunucuya yüklenmesini gerektirmez (sunucu tarafı işlemesini (SSR) etkinleştirmediğiniz müddetçe). 

Standart ASP.NET Core barındırma ve dağıtım yöntemlerikullanabilirsiniz. 

Bağımsız olarak "ng hizmeti" Çalıştır 

Proje, ASP.NET Core uygulaması geliştirme modunda başladığında arka planda kendi angular CLı sunucusu 
örneğini başlatacak şekilde yapılandırılmıştır. Ayrı bir sunucuyu el ile çalıştırmak zorunda olmadığınızdan bu 
kullanışlıdır. 

Bu varsayılan Kurulumun bir dezavantajı vardır.C# Kodunuzun her değiştirilişinde ve ASP.NET Core 
uygulamanızın yeniden başlatılması gerektiğinde, ANGULAR CLI sunucusu yeniden başlatılır. Yeniden başlatmak 
için yaklaşık 10 saniye gereklidir. Sık karşılaşılan C# kod düzenlemeleri yapıyorsanız ve ANGULAR CLI 'nın 
yeniden başlatılmasını beklemek İstemiyorsanız, angular clı sunucusunu ASP.NET Core işleminden bağımsız 
olarak dışarıdan çalıştırın. Bunu yapmak için: 

1. Bir komut isteminde clientapp alt dizinine geçin ve ANGULAR CLI geliştirme sunucusunu başlatın: 

cd ClientApp 
npm start 


IMPORTANT 

npm start Package. JSON içindeki yapılandırmanın kullanılması için değil ng serve , angular CLI geliştirme 
sunucusunu başlatmak için kullanın. Angular CLI sunucusuna ek parametreler geçirmek için bunları scripts 
Package. JSON dosyanızdaki ilgili satıra ekleyin. 


2. ASP.NET Core uygulamanızı, kendi kendine birini başlatmak yerine dış angular CLı örneğini kullanacak 
şekilde değiştirin. Başlangıç sınıfınıza, spa.useAngularciiServer çağrıyı aşağıdaki ile değiştirin: 












spa.UseProxyToSpaDevelopmentServer("http://localhost:4200"); 

ASP.NET Core uygulamanızı başlattığınızda, angular CLı sunucusunu başlatmayacaktır.Bunun yerine el ile 
başlattığınız örnek kullanılır. Bu, daha hızlı başlamasını ve yeniden başlatılmasını sağlar. Artık, istemci uygulamanızı 
her seferinde yeniden oluşturmak için angular CLı bekliyor. 

.NET kodundan verileri TypeScript koduna geçirme 

SSR sırasında, ASP.NET Core uygulamanızdaki istek başına verileri angular uygulamanıza geçirmek 
isteyebilirsiniz. Örneğin, tanımlama bilgisi bilgilerini veya bir veritabanından okunan bir şeyi geçirebilirsiniz. Bunu 
yapmak için Başlangıç sınıfınızı düzenleyin, için useSpaPrerendering geri çağırmada, aşağıdaki gibi bir 
options.suppiyData değer ayarlayın: 

options.SupplyData = (conteKt, data) => 

{ 

// Creates a new value called isHttpsRequest that's passed to TypeScript code 
data["isHttpsRequest"] = context.Request.IsHttps; 

}; 

suppiyData Geri arama, isteğe bağlı olarak, JSON ile seri hale getirilebilir verileri (örneğin, dizeler, Boole değerleri 
veya sayılar) geçirmenize olanak sağlar. Main. Server. TS kodunuz bunu olarak params.data alır. Örneğin, 
yukarıdaki kod örneği params.data.isHttpsRequest createServerRenderer geri çağırmada olduğu gibi bir Boole 
değeri geçirir. Bunu uygulamanızın diğer bölümlerine, angular tarafından desteklenen herhangi bir yolla 
geçirebilirsiniz. Örneğin, bkz. Main. Server. TS basejjrl değeri, Oluşturucusu onu almak için bildirildiği herhangi 
bir bileşene geçirir. 

SSR 'nin dezavantajları 

Tüm uygulamalar SSR 'den faydalanır.Birincil avantaj, performans algılanır.Yavaş bir ağ bağlantısı veya yavaş 
mobil cihazlarda uygulamanıza ulaşan ziyaretçiler, JavaScript paketlerini getirme veya ayrıştırma sırasında bile ilk 
Kullanıcı arabirimine hızlı bir şekilde bakın. Ancak, çoğu maça genellikle uygulamanın neredeyse anında 
göründüğü hızlı bilgisayarlarda hızlı, dahili şirket ağları üzerinde kullanılır. 

Aynı zamanda SSR 'yi etkinleştirmenin önemli sakıncaları vardır.Geliştirme sürecinizi karmaşıklık altına ekler. 
Kodunuzun iki farklı ortamda çalışması gerekir: istemci tarafı ve sunucu tarafı (ASP.NET Core bir Node.js 
ortamında çağrılır). Göz önünde bulundurmanız gereken bazı şeyler aşağıda verilmiştir: 

• SSR, üretim sunucularınızda bir Node.js yüklemesi gerektirir.Azure uygulama hizmetleri gibi bazı dağıtım 
senaryolarında bu durum otomatik olarak yapılır, ancak Azure Service Fabric gibi diğerleri için de değildir. 

• Yapı bayrağını BuiidServerSideRenderer etkinleştirmek, node_modules dizininizin yayımlamasına neden 
olur. Bu klasör, dağıtım süresini artıran 20000 + dosyalarını içerir. 

• Kodunuzu bir Node.js ortamında çalıştırmak için, window veya locaistorage gibi tarayıcıya özgü 
JavaScript API 'lerinin varlığına bağlı olamaz. Kodunuz (veya başvuru yaptığınız bazı üçüncü taraf kitaplığı) 

Bu API 'Leri kullanmayı denediğinde SSR sırasında bir hata alırsınız. Örneğin, birçok yerde tarayıcıya özgü 
API 'Lere başvurduğundan jöuery kullanmayın. Hataları önlemek için SSR 'yi kullanmaktan veya tarayıcıya 
özgü API ’lerden ya da kitaplıklardan kaçınmalısınız. Bu tür API 'lere yapılan çağrıları SSR sırasında 
çağrıdıklarından emin olmak için, denetimleri içinde kaydırabilirsiniz. Örneğin, JavaScript veya TypeScript 
kodunda aşağıdakiler gibi bir denetim kullanın: 

if (typeof window !== 'undefined') { 

// Cali browser-specific APIs here 

} 











Ek kaynaklar 

• AS P.N ET Core tek sayfalı uygulamalar için kimlik doğrulamaya giriş 


ASRNET Core ile tepki verme proje şablonunu 
kullanın 

31.10.2019 • 7 minutes to read^ Edit Online 


Güncelleştirilmiş tepki verme projesi şablonu, zengin, istemci tarafı Kullanıcı arabirimi (Ul) uygulamak için tepki 
verme ve oluşturma- yanıt verme (CRA) kurallarını kullanan ASP.NET Core uygulamalar için uygun bir başlangıç 
noktası sağlar. 

Şablon, API arka ucu olarak davranacak bir ASP.N ET Core projesi ve bir kullanıcı arabirimi olarak görev yapacak 
standart CRA tepki veren bir proje oluşturmaya eşdeğerdir, ancak her ikisini de tek bir birim olarak oluşturulup 
yayımlanabilen tek bir uygulama projesinde barındırmanın rahatlığını sağlar. 

Tepki verme projesi şablonu, sunucu tarafı işleme (SSR) için tasarlanmarmıştır. Yanıt verme ve Node.js ile SSR için, 
Next.js veya rampale'yı göz önünde bulundurun. 

Yeni bir uygulama oluşturun 

AS P.N ET Core 2,1 yüklüyse, tepki verme projesi şablonunu yüklemeniz gerekmez. 

Boş bir dizinde komut dotnet new react kullanarak komut isteminden yeni bir proje oluşturun. Örneğin, 
aşağıdaki komutlar uygulamayı Yeni bir uygulama dizininde oluşturur ve bu dizine geçer: 

dotnet new react -o my-new-app 
cd my-new-app 

Uygulamayı Visual Studio 'dan veya .NET Core CLI çalıştırın: 

• Visual Studio 

• .NET Core CLI 

Oluşturulan . csproj dosyasını açın ve uygulamayı buradan normal olarak çalıştırın. 

Yapı işlemi ilk çalıştırmada N PM bağımlılıklarını geri yükler ve bu işlem birkaç dakika sürebilir.Sonraki derlemeler 
çok daha hızlıdır. 

Proje şablonu, bir ASP.N ET Core uygulaması ve bir tepki verme uygulaması oluştu rur.ASP.NET Core uygulaması 
veri erişimi, yetkilendirme ve diğer sunucu tarafı sorunları için kullanılmak üzere tasarlanmıştır. Clientapp alt 
dizininde bulunan tepki verme uygulaması, tüm Kullanıcı arabirimi endişeleri için kullanılmak üzere tasarlanmıştır. 

Sayfa, resim, stil, modül vb. ekleyin 

Clientapp dizini standart bir CRA tepki uygulamadır. Daha fazla bilgi için resmi CRA belgelerine bakın. 

Bu şablon tarafından oluşturulan ve CRA tarafından oluşturulan tepki verme uygulaması arasında hafif farklar 
vardır; Ancak, uygulamanın özellikleri değiştirilmez. Şablon tarafından oluşturulan uygulama, önyüklemetabanlı 
bir düzen ve temel bir yönlendirme örneği içerir. 

NPM paketlerini yükler 

Üçüncü taraf NPM paketlerini yüklemek için clientapp alt dizininde bir komut istemi kullanın. Örneğin: 





cd ClientApp 

npm install --save <package_name> 


Yayımla ve dağıt 

Geliştirme aşamasında uygulama, geliştirici kolaylığı için iyileştirilmiş bir modda çalışır.Örneğin, JavaScript 
demeti kaynak eşlemeleri içerir (hata ayıklarken, özgün kaynak kodunuzu görebilirsiniz). Uygulama JavaScript, 
HTML ve CSS dosya değişikliklerini diskte izler ve bu dosya değişikliğini gördüğünde otomatik olarak yeniden 
derlenir ve yeniden yükler. 

Üretimde, uygulamanızın performans için iyileştirilmiş bir sürümünü sunar.Bu otomatik olarak gerçekleşecek 
şekilde yapılandırılmıştır. Yayımladığınızda, derleme yapılandırması, istemci tarafı kodunuzun küçültülmüş, 
transpiled derlemesini yayar. Geliştirme derlemesinin aksine, üretim derlemesi için Node.js 1 nin sunucuya 
yüklenmesi gerekmez. 

Standart ASP.NET Core barındırma ve dağıtım yöntemlerikullanabilirsiniz. 

CRA sunucusunu bağımsız olarak çalıştırma 

Proje, ASP.N ET Core uygulama geliştirme modunda başladığında, CRA geliştirme sunucusunun kendi örneğini 
arka planda başlatacak şekilde yapılandırılmıştır. Bu kullanışlı bir yöntemdir çünkü bu, ayrı bir sunucuyu el ile 
çalıştırmak zorunda olmadığınız anlamına gelir. 

Bu varsayılan Kurulumun bir dezavantajı vardır.C# Kodunuzun her değiştirilişinde ve ASP.NET Core 
uygulamanızın yeniden başlatılması gerektiğinde CRA sunucusu yeniden başlatılır. Yeniden başlamak için birkaç 
saniye gerekir. Sık C# kod düzenlemeleri yapıyorsanız ve CRA sunucusunun yeniden başlamasını beklemek 
istemiyorsanız, cra sunucusunu ASP.NET Core işleminden bağımsız olarak dışarıdan çalıştırın. Bunu yapmak için: 

1. Clientapp alt dizinine aşağıdaki ayarla bir. env dosyası ekleyin: 

BROWSER=none 

Bu, CRA sunucusunu dışarıdan başlatırken Web tarayıcınızın açılmasını engeller. 

2. Bir komut isteminde clientapp alt dizinine geçin ve CRA geliştirme sunucusunu başlatın: 

cd ClientApp 
npm start 

3. ASP.N ET Core uygulamanızı, kendi kendine birini başlatmak yerine dış CRA sunucu örneğini kullanacak 
şekilde değiştirin. Başlangiç sınıfınıza spa.useReactDevelopmentserver çağrılmasını aşağıdaki kodla 
değiştirin: 

spa.UseProxyToSpaDevelopmentServer("http://localhost:3000"); 


ASP.N ET Core uygulamanızı başlattığınızda, bir CRA sunucusu başlatılmaz. Bunun yerine el ile başlattığınız örnek 
kullanılır. Bu, daha hızlı başlamasını ve yeniden başlatılmasını sağlar. Artık, yanıt verme uygulamanızın her 
seferinde yeniden derlenmesini beklemiyordu. 








IMPORTANT 

"Sunucu tarafı işleme", bu şablonun desteklenen bir özelliği değildir.Bu şablonla olan amamız "oluşturma-tepki-uygulama" ile 
eşlik sağlamaktır. Bu nedenle, "oluşturma-yanıt verme uygulaması" projesine (SSR gibi) dahil olmayan senaryolar ve özellikler 
desteklenmez ve Kullanıcı için bir alıştırma olarak kalır. 


Ek kaynaklar 

• AS P.N ET Core tek sayfalı uygulamalar için kimlik doğrulamaya giriş 




ASPNET Core ile React-ile-Redux proje şablonu 
kullanın 

10.05.2019 • 2 minutes to read ı Edit Online 


Güncelleştirilmiş Redux ile React proje şablonu kullanarak ASP.NET Core uygulamaları, React Redux, uygun bir 
başlama noktası sağlar ve oluşturma-react-app (CRA) kuralları, istemci tarafı zengin kullanıcı arabirimi (Ul) 
uygulamak için. 

Proje oluşturma komutuna dışında React-ile-Redux şablonu hakkındaki tüm bilgileri React şablonu ile aynıdır. Bu 
proje türü oluşturmak için çalıştırılması dotnet new reactredux yerine dotnet new react . Her iki React tabanlı 
şablonlar için ortak olan işlevselliği hakkında daha fazla bilgi için bkz: React şablon belgeleri. 

11S React-ile-Redux bir alt uygulama yapılandırma hakkında daha fazla bilgi için bkz: açarken kilitlenmesi şablon 
2.1:11S üzerinde SPA kullanılamıyor (aspnet/şablon #555). 






ASPNET Core içinde tek sayfalı uygulamalar 
oluşturmak için JavaScript hizmetlerini kullanın 

19.09.2019 • 19 minutes to read^ Edit Online 


Tarafından Scott Addie ve Fiyaz Flasan 

Tek sayfa uygulama (SPA) web uygulamasının kendi devralınan zengin kullanıcı deneyimi nedeniyle popüler bir 
türdür. ASP.NET Core gibi sunucu tarafı çerçeveleri ile, angular veya yanıt verme gibi İSTEMCİ tarafı Spa 
çerçevelerini veya kitaplıklarınıtümleştirme zor olabilir. Tümleştirme sürecinde uçuşmayı azaltmak için JavaScript 
Hizmetleri geliştirilmiştir. Ancak, farklı istemci ve sunucu teknoloji yığınları arasında sorunsuz bir işlemi etkinleştirir. 


VVARNING 

Bu makalede açıklanan özellikler ASP.NET Core 3,0 itibariyle kullanımdan kalkmıştır. Microsoft. AspNetCore. SpaServices. 
Extensions NuGet paketinde daha basit bir spa çerçeveleri tümleştirme mekanizması mevcuttur. Daha fazla bilgi için bkz. 
Microsoft, aspnetcore. spaservices ve Microsoft. AspNetCore. NodeServices üzerinde kullanımdan bulunan [Duyuru], 


JavaScript Hizmetleri nedir? 

JavaScript Hizmetleri, ASP.N ET Core yönelik istemci tarafı teknolojilerinin bir koleksiyonudur.ASP.NET Core 
geliştiricilerinin Spa'lar oluşturmaya yönelik olarak tercih edilen sunucu tarafı platformu olarak yerleştirmek için 
hedefi sağlamaktır. 

JavaScript Hizmetleri iki ayrı NuGet paketi içerir: 

• Microsoft.AspNetCore.NodeServices (NodeServices) 

• Microsoft.AspNetCore.SpaServices (SpaServices) 

Bu paketler, aşağıdaki senaryolarda faydalıdır: 

• Sunucu üzerinde JavaScript çalıştırma 

• SPA altyapı veya kitaplığı kullanın 

• istemci tarafı Web varlıklarla oluşturun 

Bu makalenin odak çoğunu SpaServices paketini kullanarak yerleştirilir. 

SpaServices nedir 

ASP.NET Core geliştiricilerinin Spa'lar oluşturmaya yönelik olarak tercih edilen sunucu tarafı platformu olarak 
yerleştirmek için SpaServices oluşturulur. İstenmeyen hizmetler ASP.NET Core ile maça geliştirmek için gerekli 
değildir ve geliştiricileri belirli bir istemci çerçevesinde kilitlemez. 

SpaServices gibi kullanışlı bir altyapı sağlar: 

• Sunucu tarafı prerendering 

• Web geliştirme ara yazılımı 

• Sık erişimli modülü değiştirme 

• Yönlendirme Yardımcıları 

Toplu olarak, bu altyapı bileşenlerini, hem geliştirme iş akışını hem de çalışma zamanı deneyimi geliştirin. 
Bileşenleri ayrı ayrı önemsenmeksizin devralınabilir. 






SpaServices kullanmanın önkoşulları 

SpaServices ile çalışmak için aşağıdakileri yükleyin: 

• Node.js (sürüm 6 veya sonrası) npm ile 

o Bu bileşenler yüklenir ve bulunabilir doğrulamak için komut satırından aşağıdaki komutu çalıştırın: 

node -v && npm -v 

o Bir Azure Web sitesine dağıtım yapıyorsanız hiçbir işlem gerekli—değildir, js, sunucu ortamlarında 
yüklenir ve kullanılabilir. 

• .NET core SDK 2.0 veya üzeri 

o Visual Studio 2017 kullanarak Windows 'da SDK, .NET Core platformlar arası geliştirme iş yükü 
seçilerek yüklenir. 

• Microsoft.AspNetCore.SpaServices NuGet paketi 

Sunucu tarafı prerendering 

Bir evrensel (isomorphic olarak da bilinir) uygulama özellikli olan hem çalışan sunucu ve istemci üzerindeki bir 
JavaScript uygulamasıdır. Angular, React ve diğer popüler çerçeveleri için bu uygulama geliştirme stili Evrensel bir 
platform sağlar, ilk Node.js aracılığıyla sunucuda framevvork bileşenleri oluşturma ve yürütme istemciye daha fazla 
temsilci olur. 

ASP.NET Core etiket Yardımcıları tarafından sağlanan SpaServices server JavaScript işlevleri çağrılarak sunucu 
tarafı prerendering uygulamasını basitleştirin. 

Sunucu tarafı prerendering önkoşulları 

ASPNET-prerendering NPM paketini yükler: 

npm i -S aspnet-prerendering 

Sunucu tarafı prerendering yapılandırması 

Etiket Yardımcıları projesinin ad kayıt bulunabilir yapılan _viewımports.cshtml dosyası: 

@using SpaServicesSampleApp 

(ŞaddTagHelper Microsoft.AspNetCore.Mvc.TagHelpers" 

@addTagHelper Microsoft.AspNetCore.SpaServices" 

Bu etiket Yardımcıları hemen bir HTML benzeri sözdizimi Razor görünüm içinde yararlanarak alt düzey API'ler ile 
doğrudan iletişim ayrıntılı olarak İncelenmektedir soyut: 

<app asp-prerender-module="ClientApp/dist/main-server">Loading...</app> 

ASP-PreRender-Module etiketi Yardımcısı 

asp-prerender-modüle Etiketi Yardımcısı, önceki kod örneğinde kullanılan yürütür ClientApp/dist/main-serverjs 
Node.js aracılığıyla sunucuda. Açıklık'ın çok için ana server.js dosyasıdır TypeScript JavaScript transpilation görevin 
bir yapıt Web derleme işlemi. Web tanımlayan bir giriş noktası diğer main-server ; ve bu diğer adı için bağımlılık 
grafiği geçişini başlar CiientApp/önyükieme-server.ts dosyası: 









entry: { 'main-server': './ClientApp/boot-server.ts' }, 

Aşağıdaki Angular örnekte CiientApp/önyükieme-server.ts dosya kullanır createServerRenderer işlevi ve 
RenderResuit tür aspnet-prerendering npm paketi, sunucu işleme Node.js aracılığıyla yapılandırılır.Kesin türü 
belirtilmiş bir JavaScript içinde sarmalanmış bir Çözümle işlev çağrısı için sunucu tarafı işleme geçirilen 
hedefleyen bir HTML biçimlendirmesi Promise nesne. Promise Nesnenin önemi olan, zaman uyumsuz olarak 
DOM'ın yer tutucu öğesi yerleştirmeye sayfasına HTML biçimlendirme sağlar. 

import { createServerRenderer, RenderResuit } from 'aspnet-prerendering'; 

export default createServerRenderer(params => { 
const provlders = [ 

{ provlde: INITIAL_CONFIG, useValue: { document: '<appx/app>', url: params.url } }, 

{ provide: ’ORIGINJJRL', useValue: params.origin } 

]J 

return platformDynamicServer(providers).bootstrapModule(AppModule).then(moduleRef => { 
const appRef = moduleRef.injector.get(ApplicationRef); 
const State = moduleRef.injector.get(PlatformState); 
const zone = moduleRef.injector.get(NgZone); 

return new Promise<RenderResult>((resolve, reject) => { 

zone.onError.subscribe(errorInfo => reject(errorlnfo)); 
appRef,isStable.first(isStable => isStable).subscribe(() => { 

// Because ’onStable’ fires before 'onError', we have to delay slightly before 
// completing the request in case there's an error to report 
setlmmediate(() => { 
resolve({ 

html: State.renderToString() 

}); 

moduleRef.destroy(); 

}); 

}); 

}); 

}); 

}); 


ASP-PreRender-veri etiketi Yardımcısı 

ile birlikte zaman asp-prerender-module etiketi Yardımcısı asp-prerender-data etiketi Yardımcısı, bağlamsal bilgiler 
için sunucu tarafı JavaScript Razor görünümden geçirmek için kullanılabilir. Örneğin, kullanıcı verilerini aşağıdaki 
biçimlendirme geçirir main-server Modülü: 

<app asp-prerender-module="ClientApp/dist/main-server" 
asp-prerender-data='new { 

UserName = "Dohn Doe" 

}'>Loading...</app> 

Alınan UserName bağımsız değişkeni yerleşik JSON serileştirici kullanılarak serileştirilmiş ve depolanan 
params.data nesne. Angular aşağıdaki örnekte veri içinde kişiselleştirilmiş bir karşılama oluşturmak için kullanılan 
bir hi öğesi: 

















import { createServerRenderer, RenderResult } from 'aspnet-prerendering'; 

export default createServerRenderer(params => { 
const providers = [ 

{ pnovide: INITIAL_CONFIG, useValue: { document: ' <appx/app >', url: params.url } }, 

{ provide: ’ORIGINJJRL’, useValue: params.origin } 

]; 

return platformDynamicServer(providers).bootstrapModule(AppModule).then(moduleRef => { 
const appRef = moduleRef.injector.get(ApplicationRef); 
const State = moduleRef.injector.get(PlatformState); 
const zone = moduleRef.injector.get(NgZone); 

return new Promise<RenderResult>((resolve, reject) => { 

const result = '<hl>Hello, ${params.data.userName}</hl>'; 

zone.onError.subscribe(errorInfo => reject(errorlnfo)); 
appRef,isStable.first(isStable => isStable).subscribe(() => { 

// Because ’onStable’ fires before 'onError', we have to delay slightly before 
// completing the request in case there's an error to report 
setlmmediate(() => { 
resolve({ 

html: result 

}); 

moduleRef.destroy(); 

}); 

}); 

}); 

}); 

}); 

Etiket yardımcılarının geçirildiği Özellik adları PascalCase gösterimi ile temsil edilir. Burada aynı özellik adları ile 
gösterilir, JavaScript, Karşıtlık camelCase. Bu fark için varsayılan JSON seri hale getirme yapılandırması 
sorumludur. 

Yukarıdaki kod örneğinde genişletmek için verileri sunucudan görünüme hydrating tarafından geçirilebilir 
globals özelliği için sağlanan resolve işlevi: 





import { createServerRenderer, RenderResult } from 'aspnet-prerendering'; 

export default createServerRenderer(params => { 
const providers = [ 

{ pnovide: INITIAL_CONFIG, useValue: { document: ' <appx/app >', url: params.url } }, 

{ pnovide: 'ORIGINJJRL', useValue: params.onigin } 

]; 

return platformDynamicServer(providers).bootstrapModule(AppModule).then(moduleRef => { 
const appRef = moduleRef.injector.get(ApplicationRef); 
const State = moduleRef.injector.get(PlatformState); 
const zone = moduleRef.injector.get(NgZone); 

return new Promise<RenderResult>((resolve, reject) => { 

const result = '<hl>Hello, ${params.data.userName}</hl>'; 

zone.onError.subscribe(errorInfo => reject(errorlnfo)); 
appRef.isStable.first(isStable => isStable).subscribe(() => { 

// Because ’onStable' fires before 'onError', we have to delay slightly before 
// completing the request in case there's an error to report 
setlmmediate(() => { 
resolve({ 

html: result, 
globals: { 

postList: [ 

'Introduction to ASP.NET Core', 

’Making apps with Angular and ASP.NET Core' 

] 

} 

}); 

moduleRef.destroy(); 

}); 

}); 

}); 

}); 

}); 


postList İçinde tanımlanan bir dizi globals nesne bağlı tarayıcının genel window nesne. Bu değişken hoisting 
genel kapsam için aynı verileri bir kez sunucuda ve istemcinin yeniden yüklenmesi için özellikle ilgili olarak çaba, 
çoğaltma ortadan kaldırır. 


/home - F12 Developer Tools - Microsoft Edge 

□ X 

F12 DOM Explorer Debugger 

[El | ? % 5 


O 2 A 0 


window.postList 
a [object Array] 
0 
1 

length 




Target _top: home 




["Introductio..."Making apps..."] 
"Introduction to ASP.NET Core" 

"Making apps with Angular and ASP.NET Core" 
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Web geliştirme ara yazılımı 

Web geliştirme ara yazılım yapabildiği Web yapılar kaynakları isteğe bağlı olarak Basitleştirilmiş geliştirme iş akışı 
sunar. Ara yazılım, otomatik olarak derler ve bir sayfa tarayıcıya yeniden yüklendiğinde istemci-tarafı kaynaklar 
sunar. Başka bir üçüncü taraf bağımlılığı veya özel kod değiştiğinde Web projenin npm derleme betiği aracılığıyla 










el ile başlatmak için yaklaşımdır. Bir npm derleme betiği package.json dosya, aşağıdaki örnekte gösterilmiştir: 


"build": "npm run build:vendor && npm run build:custom", 


VVebPack dev ara yazılım önkoşulları 

ASPNET-VVebPack NPM paketini yükler: 

npm i -D aspnet-webpack 


VVebPack dev ara yazılım yapılandırması 

HTTP istek işlem hattı aşağıdaki kod aracılığıyla içine kayıtlı Web geliştirme ara yazılım Startup.es dosyanın 
configure yöntemi: 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 
app.UseWebpackDevMiddleware(); 

} 

else 

{ 

app.UseExceptionHandler("/Home/Error"); 

} 

// Cali UseWebpackDevMiddleware before UseStatlcFiles 
app.UseStaticFiles(); 

usewebpackDevMiddieware Genişletme yöntemi çağrıldığında, önce statik dosya barındırma kaydetme aracılığıyla 
usestaticFiles genişletme yöntemi. Uygulama geliştirme modunda çalıştırıldığında güvenlik nedenleriyle, ara 
yazılım kaydedin. 

Webpack.config.js dosyanın output.pubiicPath özelliği söyler izlemek için bir ara yazılım dist klasördeki 
değişiklikleri: 

modüle.exports = (env) => { 
output: { 

filename: , [name].js' J 

publicPath: '/dist/' // Webpack dev middleware, if enabled, handles requests for this URL prefix 

}, 


Sık erişimli modülü değiştirme 

VVeb'ın düşünebilirsiniz sık erişimli modülü değiştirme (HMR) özelliği'nın Gelişmiş hali olarak Web geliştirme ara 
yazılım. HMR aynı avantajları sunar, ancak otomatik olarak değişiklikleri derledikten sonra sayfa içeriği 
güncelleştirerek daha fazla geliştirme iş akışı kolaylaştırır. Bu, geçerli bellek içi durumu ve hata ayıklama oturumu 
SPA ile neden tarayıcı yenileme ile karıştırmayın. Web geliştirme ara yazılım hizmeti ve değişiklikleri tarayıcıya 
gönderilmesini anlamına gelir tarayıcı arasında canlı bir bağlantı yoktur. 

Sık kullanılan modül değiştirme önkoşulları 

WebPack-Hot-ara yazılım NPM paketini yükler: 

npm i -D webpack-hot-middleware 


Sık kullanılan modül değiştirme yapılandırması 







HMR bileşen MVC'nin HTTP istek işlem hattı, kaydedilmesi gerekir configure yöntemi: 


app.UseWebpackDevMiddleware(new WebpackDevMiddlewareOptions { 

HotModuleReplacement = true 

}); 

ile doğru olarak Web geliştirme ara yazılım, usewebpackDevMiddieware genişletme yöntemi çağrıldığında, önce 
usestaticFiles genişletme yöntemi. Uygulama geliştirme modunda çalıştırıldığında güvenlik nedenleriyle, ara 
yazılım kaydedin. 

Webpack.config.js dosya tanımlamalıdır bir plugins dizi bile boş bırakılır: 

modüle.exports = (env) => { 

plugins: [new CheckerPlugin()] 

Uygulamayı tarayıcıda yüklendikten sonra geliştirici araçları konsol sekmesi HMR Etkinleştirme Onayı sağlar: 


/home - F12 Developer Tools - Microsoft Edge — □ X 

Fi2 DOM Explorer Debugger Network (►) Performance ▼ 0 ? % B 



Yönlendirme Yardımcıları 

Çoğu AS P.N ET Core tabanlı maça, istemci tarafı yönlendirme genellikle sunucu tarafı yönlendirmeye ek olarak 
istenir. SPA ve MVC yönlendirme sistemleri girişim bağımsız olarak çalışabilir. Yoktur, ancak bir kenar büyük/küçük 
harf taşıyor sorunlarını: HTTP 404 yanıtları tanımlayan. 

Senaryoyu göz önünde bulundurun uzantısız bir yolu /some/page kullanılır, istek deseni-sunucu tarafı rota match 
değil, ancak desenine bir istemci-tarafı rota ile eşleşmekte varsayılır. Şimdi gelen bir istek için göz önünde 
bulundurun /images/user-5i2.png , hangi genellikle bekliyor sunucudaki bir görüntü dosyası bulunamıyor, istenen 
kaynak yolu herhangi bir sunucu tarafı yolu veya statik dosya ile eşleşmiyorsa, istemci tarafı uygulamanın bu— 
işlemi genellikle bir 404 HTTP durum kodu döndürerek işlemesi çok düşüktür. 

Yönlendirme Yardımcıları önkoşulları 

istemci tarafı yönlendirme NPM paketini yükler.Angular örnek olarak kullanıp: 
npm i -S @angular/router 

Yönlendirme Yardımcıları yapılandırması 

Adlı bir genişletme yöntemi MapSpaFaiibackRoute kullanılır configure yöntemi: 



















app.UseMvc(routes => 

{ 

routes.MapRoute( 

name: "default", 

template: "{controller=Home}/{action=Index}/{id?}"); 

routes.MapSpaFallbackRoute( 
name: "spa-fallback", 

defaults: new { controllen = "Home", action = "Index" }); 

}); 

Yollar yapılandırıldıkları sırayla değerlendirilir.Sonuç olarak, default rota önceki kod örneğinde kullanılan ilk 
desen eşleştirmesi için. 

Yeni bir proje oluşturma 

JavaScript Hizmetleri önceden yapılandırılmış uygulama şablonları sağlar.İstenmeyen hizmetler, bu şablonlarda, 
angular, tepki ve Redux gibi farklı çerçeveler ve kitaplıklarla birlikte kullanılır. 

Bu şablonlar, aşağıdaki komutu çalıştırarak, .NET Core CLI yüklenebilir: 

dotnet new --install Microsoft.AspNetCore.SpaTemplates::* 


Kullanılabilir SPA şablonlar listesi görüntülenir: 


ŞABLONLAR 

KISA AD 

DİL 

ETİKETLER 

Angular ile ASP.NET Core 

MVC 

Angular 

[C#] 

MVC/Web/SPA 

React.js ile ASP.NET Core 

MVC 

react 

[C#] 

MVC/Web/SPA 

ASP.NET Core MVC React.js 
ve Redux 

açarken kilitlenmesi 

[C#] 

MVC/Web/SPA 


SPA şablonlardan birini kullanarak yeni bir proje oluşturmak için dahil kısa ad şablonda, yeni dotnet komutu. 
Aşağıdaki komut, sunucu tarafı için yapılandırılan ASP.NET Core MVC ile Angular bir uygulama oluşturur: 

dotnet new angular 

Çalışma zamanı yapılandırma modunu ayarlayın 

Birincil çalışma zamanı yapılandırma için iki mod vardır: 

• Geliştirme: 

o Hata ayıklamayı kolaylaştırmak için kaynak eşlemeleri içerir, 
o istemci tarafı kod performans için en iyi duruma değil. 

• Üretim: 

o Kaynak eşlemeleri dışlar. 

o Paketleme ve küçültmeye göre istemci tarafı kodunu iyileştirir. 

ASP.NET Core kullanan adlı bir ortam değişkeni aspnetcore_enviroi\iment yapılandırma modunu depolamak için. 
Daha fazla bilgi için bkz. ortamı ayarlama. 







.NET Core CLI ile Çalıştır 

Proje kök dizininde aşağıdaki komutu çalıştırarak gerekli NuGet ve npm paketlerini geri yükleyin: 

dotnet restore && npm i 


Derleme ve uygulamayı çalıştırın: 

dotnet run 


Şunlara göre localhost üzerinde uygulama başladığında çalışma zamanı yapılandırma modunu. Gezinme 
http: //localhost: 5000 tarayıcısında giriş sayfası görüntüler. 

Visual Studio 2017 ile çalıştırma 

Açık .csproj tarafından oluşturulan dosya yeni dotnet komutu. Gerekli NuGet ve npm paketleri proje üzerinde 
otomatik olarak geri yüklenir. Bu geri yükleme işlemi birkaç dakika sürebilir ve tamamlandığında çalıştırmaya hazır 
bir uygulamadır. Yeşil çalıştırma düğmesine veya tuşuna tıklayın Ctrl + fs , ve tarayıcıda uygulama giriş sayfası 
açılır. Uygulama ayarına göre localhost üzerinde çalışır çalışma zamanı yapılandırma modunu. 

Uygulamayı test etme 

SpaServices şablonları kullanarak istemci tarafı testleri çalıştırmak için önceden yapılandırılmış Karma ve Jasmine. 
Test Çalıştırıcısı bu testler için karma bilgileriyse jasmine bir popüler birim testi çerçevesi için JavaScript,' dir. 
Karma çalışmak üzere yapılandırılmış Web geliştirme ara yazılım sağlayacak şekilde Geliştirici durdurmak ve 
değişiklikler her zaman test çalıştırması için gerekli değildir. Test çalışması veya test çalışması karşı çalışan kod olup 
olmadığını test otomatik olarak çalıştırılır. 

Angular uygulamasını örnek olarak kullanıp, Jasmine iki test çalışmaları zaten için sağlanan countercomponent 
içinde counter.componentspec.ts dosyası: 

it('should display a title', async(() => { 

const titleText = fixture.nativeElement.querySelector(’hl').textContent; 
expect(titleText).toEqual('Counter'); 

}))J 

it('should start with count 0 , then increments by 1 when clicked', async(() => { 
const countElement = fixture.nativeElement.querySelector(’strong'); 
expect(countElement.textContent).toEqual(' 0 ')j 

const incrementButton = fixture.nativeElement.querySelector( 'button'); 
incrementButton.click(); 
fixture.detectChanges(); 

expect(countElement.textContent).toEqual(' 1 '); 

})); 


Komut istemi açın ClierıtApp dizin. Şu komutu çalıştırın: 

npm test 


Komut dosyası içinde tanımlanan ayarlarını okur Karma test Çalıştırıcısı başlatır karma.conf.js dosya. Diğer ayarlar 
arasında karma.conf.js aracılığıyla yürütülecek test dosyalarını tanımlar, fileş dizi: 







modüle.exports = function (config) { 
config.set({ 
fileş: [ 

' ../wwwroot/dist/vendor.js ', 
' ./boot-tests.ts' 

L 


Uygulamayı yayımlama 

Oluşturulan istemci-tarafı varlıkları ve yayımlanan ASP.NET Core yapıları dağıtmak için hazır bir pakete birleştiren 
çok uğraşmayı gerektirebilir. Ne SpaServices adlı özel bir MSBuild hedefi ile tüm yayın işlem düzenler RunWebpack 

cTarget Name="RunWebpack" AfterTargets="ComputeFilesToPublish"> 

<!-- As part of publishingj ensure the İS resources are freshly built in production mode --> 

<Exec Command="npm install" /> 

<Exec Command="node node_modules/webpack/bin/webpack.js --config webpack.config.vendor.js --env.prod" /> 
<Exec Command="node node_modules/webpack/bin/webpack.js --env.prod" /> 

<!-- İncilide the newly-built fileş in the publish output --> 

<ItemGroup> 

<DistFiles Include="wwwroot\dist\**; ClientApp\dist\**" /> 

<ResolvedFileToPublish Include="@(DistFiles->’%(FullPath)')" Exclude="@(ResolvedFileToPublish)"> 
<RelativePath>%(DistFiles.Identity)</RelativePath> 
<CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory> 

</ResolvedFileToPublish> 

</ItemGroup> 

</Target> 


MSBuild hedefi aşağıdaki sorumluluklara sahiptir: 

1. NPM paketlerini geri yükleyin. 

2. Üçüncü taraf, istemci tarafı varlıkların üretim sınıfı derlemesini oluşturun. 

3. Özel istemci tarafı varlıkların üretim sınıfı derlemesini oluşturma. 

4. Web paketi tarafından oluşturulan varlıkları Yayımla klasörüne kopyalayın. 

MSBuild hedefi çalıştırılırken çağrılır: 

dotnet publish -c Release 


Ek kaynaklar 


• Angular belgeleri 





LibMan ile ASPNET Core istemci tarafı kitaplık alma 

11.09.2019 • 2 minutes to read ı Edit Online 


Scott Ade tarafından 

Kitaplık Yöneticisi (LibMan), basit, istemci tarafı bir kitaplık alma aracıdır. LibMan, dosya sisteminden veya bir içerik 
teslim ağından (CDN)popüler kitaplıkları ve çerçeveleri indirir. Desteklenen CDNs, Cdnjs, jsdelivrve unpkg'yi içerir. 
Seçilen kitaplık dosyaları getirildi ve ASP.NET Core projesi içindeki uygun konuma yerleştirildi. 

LibMan kullanım örnekleri 

LibMan aşağıdaki avantajları sunar: 

• Yalnızca ihtiyacınız olan kitaplık dosyaları indirilir. 

• Node.js, NPMve VVebPackgibi ek araçlar, bir kitaplıktaki dosyaların alt kümesini almak için gerekli değildir. 

• Dosyalar, derleme görevleri veya el ile dosya kopyalama işlemleri yapılmadan belirli bir konuma yerleştirilebilir. 

Libman 'ın avantajları hakkında daha fazla bilgi için Visual Studio 2017 1 de modern ön uç Web geliştirmesini 
izleyin: LibMan segmenti. 

LibMan bir paket yönetim sistemi değildir.Zaten NPM veya Yarngibi bir paket Yöneticisi kullanıyorsanız, bunu 
yapmaya devam edin. LibMan, bu araçların yerini alacak şekilde geliştirilmedi. 

Ek kaynaklar 

• Visual Studio'da ASP.NET Core ile LibMan kullanın 

• ASP.NET Core ile LibMan komut satırı arabirimini (CLı) kullanın 

• LibMan GitHub deposu 




ASPNET Core ile LibMan komut satırı arabirimini 
(CLı) kullanın 

13.11.2019 • 12 minutes to read ı Edit Online 


Scott Ade tarafından 

Libman CLI, .N ET Core 'un desteklendiği her yerde desteklenen platformlar arası bir araçtır. 

Prerequisites 

• .NET core 2.1 SDK veya üzeri 

Yükleme 

LibMan CLı 'yı yüklemek için: 

dotnet tool install -g Microsoft .l/Jeb. LibraryManager .Cli 


.NET Core küresel aracı , Microsoft. Web. LibraryManager. CLI NuGet paketinden yüklenir. 

Belirli bir NuGet paket kaynağından LibMan CLı 'yı yüklemek için: 

dotnet tool install -g Microsoft .l/Jeb. LibraryManager .Cli --version 1.0.94-g606058a278 --add-source C:\Temp\ 


Yukarıdaki örnekte,yerel VVİndovvs makinenin C:\Temp\Microsoft.Web.LibraryManager.dll .0.94- 
g606058a278.nupkg dosyasından bir .NET Core genel aracı yüklenir. 

Kullanım 

CLı başarıyla yüklendikten sonra aşağıdaki komut kullanılabilir: 

libman 


Yüklü CLı sürümünü görüntülemek için: 

libman --version 


Kullanılabilir CLı komutlarını görüntülemek için: 

libman --help 


Yukarıdaki komut aşağıdakine benzer bir çıktı görüntüler: 









1.0.163+g45474d37ed 

Usage: libman [options] [command] 

Options: 

--help|-h 

Show help information 

--version 

Show version information 

Commands: 

cache 

List or clean libman cache contents 

clean 

Deletes ali library fileş defined in libman.json from the project 

init 

Create a new libman.json 

install 

Add a library definition to the libman.json file, and download the 
library to the specified location 

restore 

Downloads ali fileş from provider and saves them to specified 

destination 

uninstall 

Deletes ali fileş for the specified library from their specified 
destination, then removes the specified library definition from 
libman.json 

update 

Updates the specified library 

Use "libman 

[command] --help" for more information about a command. 


Aşağıdaki bölümlerde kullanılabilir CLı komutları ana hatlarıyla verilmiştir. 

Projedeki LibMan 'ı Başlat 

libman init komutu, yoksa bir Libman. JSON dosyası oluşturur. Dosya varsayılan öğe şablonu içeriğiyle 
oluşturulur. 

Özeti 

libman init [-d|--default-destination] [-p|--default-provider] [--verbosity] 
libman init [-h|--help] 


Seçenekler 

libman init komutu için aşağıdaki seçenekler kullanılabilir: 

• -d|--default-destination <PATH> 

Geçerli klasöre göreli bir yol. Libman. JSOA/içindeki bir kitaplık için destination özelliği tanımlanmamışsa 
kitaplık dosyaları bu konuma yüklenir. <path> değeri Libman. JSO A/öğesinin defaultDestination özelliğine 
yazılır. 

• -p|--default-provider <PROVIDER> 

Belirli bir kitaplık için hiçbir sağlayıcı tanımlanmamışsa kullanılacak sağlayıcı. <provider> değeri Libman. 
VSOA/öğesinin defaultProvider özelliğine yazılır. <provider> aşağıdaki değerlerden biriyle değiştirin: 


O 

cdnjs 


o 

filesystem 

o 

jsdelivr 

o 

unpkg 


-h 

|--help 



Yardım bilgilerini gösterir. 




--verbosity <LEVEL> 
















Çıkışın ayrıntı düzeyini ayarlayın. Değiştirin <level> aşağıdaki değerlerden biriyle: 


o quiet 
o normal 
o detailed 

Örnekler 

ASP.NET Core projesinde bir Libmarı. JSON dosyası oluşturmak için: 

• Proje köküne gidin. 

• Şu komutu çalıştırın: 

libman init 

• Varsayılan sağlayıcının adını yazın veya varsayılan CDNJS sağlayıcısını kullanmak için Enter 'abasın. 
Geçerli değerler şunlardır: 

o cdnjs 
o filesystem 
o jsdelivr 
o unpkg 



Aşağıdaki içeriğe sahip proje köküne bir Libmarı. JSON dosyası eklenir: 

{ 

"version": "1.0", 

"defaultProvider": "cdnjs", 

"libraries": [] 

} 


Kitaplık dosyaları Ekle 

libman instaiı komutu, kitaplık dosyalarını indirir ve projeye yükler. Bir Libman. JSON dosyası yoksa eklenir. 
Libman. JSON dosyası kitaplık dosyaları için yapılandırma ayrıntılarını depolayacak şekilde değiştirilir. 

Özeti 

libman install <LIBRARY> [-d| - -destination] [--fileş] [-p|--provider] [--verbosity] 
libman install [-h|--help] 


Arguments 















LIBRARY 


Yüklenecek kitaplığın adı. Bu ad, sürüm numarası gösterimi içerebilir (örneğin, @ 1 . 2.0 ). 

Seçenekler 

libman instaiı komutu için aşağıdaki seçenekler kullanılabilir: 

• -d|--destination <PATH> 

Kitaplığın yükleneceği konum. Belirtilmemişse, varsayılan konum kullanılır. Libman. JSONlçnde 
defauitDestination özelliği belirtilmemişse, bu seçenek gereklidir. 

• --fileş <FILE> 

Kitaplıktan yüklenecek dosyanın adını belirtin. Belirtilmemişse, kitaplıktaki tüm dosyalar yüklenir. 

Yüklenecek dosya başına bir --fileş seçeneği belirtin. Göreli yollar da desteklenir.Örneğin: 

--fileş dist/browser/signalr.js . 

• -p|--pnoviden <PROVIDER> 

Kitaplık alımı için kullanılacak sağlayıcının adı. <provider> aşağıdaki değerlerden biriyle değiştirin: 

o cdnjs 
o filesystem 
o jsdelivr 
o unpkg 

Belirtilmemişse, Libman. JSON içindeki defaultProvider özelliği kullanılır. Libman. YSOA/içinde 
defaultProvider özelliği belirtilmemişse, bu seçenek gereklidir. 

• -h|— help 

Yardım bilgilerini gösterir. 

• --verbosity <LEVEL> 

Çıkışın ayrıntı düzeyini ayarlayın. Değiştirin <level> aşağıdaki değerlerden biriyle: 

o quiet 
o normal 
o detailed 

Örnekler 

Aşağıdaki Libman. JSON dosyasını göz önünde bulundurun: 

{ 

"version": "1.0", 

"defaultProvider": "cdnjs", 

"libraries": [] 

} 

JQuery sürümü 3.2.1 jÇuery. min.js dosyasını CDNJS sağlayıcısını kullanarak Wwwroot/Scripts/jQuery klasörüne 
yüklemek için: 

libman install jquery@3.2.1 --provider cdnjs --destination wwwroot/scripts/jquery --fileş jquery.min.js 


Libman. JSON dosyası şuna benzer: 


















{ 

"version": "1.0", 

"defaııltProvider": "cdnjs", 

"libraries": [ 

{ 

"library": "jquery@3.2.1", 

"destination": "wwwroot/scripts/jquery", 

"fileş": [ 

"jquery.min.js" 

] 

} 

] 

} 

C:\temp\contosotakvim\ dosya sistemi sağlayıcısını kullanarak Calendar. jsve Calendar. css dosyalarını yüklemek 
için: 

libman install C:\temp\contosoCalendar\ --provider filesystem --fileş calendar.js --fileş calendar.css 

Aşağıdaki istem iki nedenden dolayı görünür: 

• Libman. JSON dosyası bir defaultDestination özelliği içermiyor. 

• libman install komutu -d|--destination seçeneğini içermez. 


[XI Cmder — □ X 


C: \Projects\BasicWebApp 

X libman install C:\temp\contosoCalendar\ --provid 
er filesystem --fileş calendar.js --fileş calendar 
. css 

Destination [wwwroot\lib\contosoCalendar]: 


[XI libman.exe | Search ,P| 0 T D ’ â [3 =: 


Varsayılan hedefi kabul ettikten sonra, Libman. JSON dosyası şuna benzer: 












{ 

"version": "1.0", 

"defaultProvider": "cdnjs", 

"libraries": [ 

{ 

"library": "jquery@3.2.1", 

"destination": "wwwroot/scripts/jquery", 
"fileş": [ 

"jquery.min.js" 

] 

b 

{ 

"library": "C:\\temp\\contosoCalendar\\", 
"provider": "filesystem", 

"destination": "wwwroot/lib/contosoCalendar", 
"fileş": [ 

"calendar.js", 

"calendar.css" 

] 

} 

] 

} 


Kitaplık dosyalarını geri yükleme 

libman restore komutu Libman. JSONlçmde tanımlanan kitaplık dosyalarını yüklüyor. Aşağıdaki kurallar 
geçerlidir: 

• Proje kökünde bir Libman. JSON dosyası yoksa bir hata döndürülür. 

• Bir kitaplık bir sağlayıcıyı belirtiyorsa, Libman. JSON içindeki defaultProvider özelliği yok sayılır. 

• Bir kitaplık bir hedef belirtiyorsa, Libman. JSON içinde defaultDestination özelliği yok sayılır. 

Özeti 

libman restore [--verbosity] 
libman restore [-h|--help] 

Seçenekler 

libman restore komutu için aşağıdaki seçenekler kullanılabilir: 

• -h|— help 

Yardım bilgilerini gösterir. 

• --verbosity <LEVEL> 

Çıkışın ayrıntı düzeyini ayarlayın. Değiştirin <level> aşağıdaki değerlerden biriyle: 

o quiet 
o normal 
o detailed 

Örnekler 

Libman. JSON' da tanımlanan kitaplık dosyalarını geri yüklemek için: 

libman restore 













Kitaplık dosyalarını sil 

libman ciean komutu, daha önce LibMan aracılığıyla geri yüklenen kitaplık dosyalarını siler. Bu işlemden sonra 
boş olacak klasörler silinir. Libman. JSON ' nin libraries özelliğindeki kitaplık dosyalarının ilişkili yapılandırması 
kaldırılmaz. 

Özeti 

libman clean [--venbosity] 
libman clean [-h|— help] 

Seçenekler 

libman clean komutu için aşağıdaki seçenekler kullanılabilir: 

• -h|— help 

Yardım bilgilerini gösterir. 

• --verbosity <LEVEL> 

Çıkışın ayrıntı düzeyini ayarlayın. Değiştirin <level> aşağıdaki değerlerden biriyle: 

o quiet 
o normal 
o detailed 

Örnekler 

LibMan aracılığıyla yüklenen kitaplık dosyalarını silmek için: 

libman clean 


Kitaplık dosyalarını kaldır 

libman uninstall komutu: 

• Belirtilen kitaplıkla ilişkili tüm dosyaları Libman. ./SO/Vdosyasındaki hedefle siler. 

• Libman. JSON' dan ilişkili kitaplık yapılandırmasını kaldırır. 

Şu durumlarda bir hata oluşur: 

• Proje kökünde Libman. JSON dosyası yok. 

• Belirtilen kitaplık yok. 

Aynı ada sahip birden fazla kitaplık yüklüyse, bir tane seçmeniz istenir. 

Özeti 

libman uninstall <LIBRARY> [--verbosity] 
libman uninstall [-h|--help] 

Arguments 

LIBRARY 

Kaldırılacak kitaplığın adı. Bu ad, sürüm numarası gösterimi içerebilir (örneğin, @ 1 . 2.0 ). 


Seçenekler 













übman uninstaiı komutu için aşağıdaki seçenekler kullanılabilir: 


• -h|— help 


Yardım bilgilerini gösterir. 


• --verbosity <LEVEL> 


Çıkışın ayrıntı düzeyini ayarlayın. Değiştirin <level> aşağıdaki değerlerden biriyle: 

o quiet 
o normal 
o detailed 

Örnekler 

Aşağıdaki Libman. JSON dosyasını göz önünde bulundurun: 


"version": "1.0", 

"defaultProvider": "cdnjs", 

"libraries": [ 

{ 

"library": "jquery@3.3.1", 

"fileş": [ 

"jquery.min.js", 

"jquery.js", 

"jquery.min.map" 

], 

"destination": "wwwroot/lib/jquery/" 

L 

{ 

"provider": "unpkg", 

"library": "bootstrap@4.1.3", 
"destination": "wwwroot/lib/bootstrap/" 

}, 

{ 

"provider": "filesystem", 

"library": "C:\\temp\\lodash\\", 
"fileş": [ 

"lodash. js", 

"lodash.min.js" 

], 

"destination": "wwwroot/lib/lodash/" 

} 

] 

} 


• JQuery 'i kaldırmak için aşağıdaki komutlardan biri başarılı olur: 


libman uninstall jquery 


libman uninstall jquery@3.3.1 


• filesystem sağlayıcısı aracılığıyla yüklenen Lodash dosyalarını kaldırmak için: 


libman uninstall C:\temp\lodash\ 








Kitaplık sürümünü Güncelleştir 

libman update komutu, LibMan aracılığıyla yüklenen bir kitaplığı belirtilen sürüme güncelleştirir. 
Şu durumlarda bir hata oluşur: 

• Proje kökünde Libman. JSON dosyası yok. 

• Belirtilen kitaplık yok. 

Aynı ada sahip birden fazla kitaplık yüklüyse, bir tane seçmeniz istenir. 

Özeti 

libman update <LIBRARY> [-pre] [--to] [--verbosity] 
libman update [-h|--help] 

Arguments 

LIBRARY 

Güncelleştirilecek kitaplığın adı. 

Seçenekler 

libman update komutu için aşağıdaki seçenekler kullanılabilir: 

• -pne 

Kitaplığın en son yayın öncesi sürümünü edinin. 

• --to <VERSION> 

Kitaplığın belirli bir sürümünü edinin. 

• -h|— help 

Yardım bilgilerini gösterir. 

• --verbosity <LEVEL> 

Çıkışın ayrıntı düzeyini ayarlayın. Değiştirin <level> aşağıdaki değerlerden biriyle: 


quiet 


normal 


detailed 


Örnekler 






libman update jquery -pre 


JQuery 'ı en son sürüme güncelleştirmek için: 

libman update jquery 

JQuery 'i 3.3.1 sürümüne güncelleştirmek için: 

libman update jquery --to 3.3.1 

JQuery 'i en son ön sürüm sürümüne güncelleştirmek için: 














Kitaplık önbelleğini Yönet 

libman cache komutu LibMan kitaplık önbelleğini yönetir, filesystem sağlayıcı kitaplık önbelleğini kullanmaz. 

Özeti 

libman cache clean [<PROVIDER>] [--verbosity] 

libman cache list [--fileş] [--libranies] [--verbosity] 

libman cache [-h|— help] 


Arguments 

PROVIDER 

Yalnızca clean komutuyla birlikte kullanılır. Temizleyen sağlayıcı önbelleğini belirtir. Geçerli değerler şunlardır: 

• cdnjs 

• filesystem 

• jsdelivr 

• unpkg 

Seçenekler 

libman cache komutu için aşağıdaki seçenekler kullanılabilir: 

• --fileş 

Önbelleğe alınan dosyaların adlarını listeleyin. 

• --libraries 

Önbelleğe alınan kitaplıkların adlarını listeleyin. 


• -h|— help 

Yardım bilgilerini gösterir. 

• --verbosity <LEVEL> 

Çıkışın ayrıntı düzeyini ayarlayın. Değiştirin <level> aşağıdaki değerlerden biriyle: 


quiet 


normal 


detailed 


Örnekler 

• Sağlayıcı başına önbelleğe alınmış kitaplıkların adlarını görüntülemek için aşağıdaki komutlardan birini 
kullanın: 

libman cache list 

libman cache list --libraries 


Aşağıdakine benzer bir çıktı görüntülenir: 














Cache contents: 


unpkg: 

knockout 
react 
vue 
cdnjs: 

font-awesome 
jquery 
knockout 
lodash.js 
react 


• Sağlayıcı başına önbelleğe alınmış kitaplık dosyalarının adlarını görüntülemek için: 

libman cache list --fileş 


Aşağıdakine benzer bir çıktı görüntülenir: 

Cache contents: 


unpkg: 

knockout: 

clist omitted for brevity> 
react: 

clist omitted for brevity> 

vue: 

clist omitted for brevity> 

cdnjs: 

font-awesome 

metadata.json 
jquery 

metadata.json 
3.2.1\core.js 
3.2.1\jquery.js 
3.2.1\jquery.min.js 
3.2.1\jquery.min.map 
3.2.1\jquery.slim.js 
3.2.1\jquery.slim.min.js 
3.2.1\jquery.slim.min.map 
3.3.1\core.js 
3.3.1\jquery.js 
3.3.1\jquery.min.js 
3.3.1\jquery.min.map 
3.3.1\jquery.slim.js 
3.3.1\jquery.slim.min.js 
3.3.1\jquery.slim.min.map 
knockout 

metadata.json 
3.4.2\knockout-debug.js 
3.4.2\knockout-min.js 
lodash.js 

metadata.json 
4.17.10\lodash.js 
4.17.10\lodash.min.js 
react 

metadata.json 


Yukarıdaki çıktıda, 3.2.1 ve 3.3.1 jQuery sürümlerinin CDNJS sağlayıcısı altında önbelleğe alındığını 
görürsünüz. 


• CDNJS sağlayıcısı için kitaplık önbelleğini boşaltmak için: 






libman cache clean cdnjs 


CDNJS sağlayıcı önbelleğini boşaltdıktan sonra, libman cache üst komutu şunları görüntüler 

Cache contents: 


unpkg: 

knockout 
react 
vue 
cdnjs: 

(empty) 


• Tüm desteklenen sağlayıcıların önbelleğini boşaltmak için: 

libman cache clean 


Tüm sağlayıcı önbellekleri boşaltıldıktan sonra, libman cache list komutu şunları görüntüler: 

Cache contents: 


unpkg: 

(empty) 
cdnjs: 

(empty) 


Ek kaynaklar 

• Küresel bir araç yükler 

• Visual Studio'da ASP.NET Core ile LibMan kullanın 

• LibMan GitHub deposu 









Visual Studio'da ASPNET Core ile LibMan kullanın 

11 . 07.2019 • 13 minutes to read •_ Edit Online 


Tarafından Scott Addie 

Visual Studio için yerleşik desteği vardır LibMan dahil olmak üzere, ASP.NET Core projelerinde: 

• Yapılandırma ve yapı LibMan geri yükleme işlemleri çalıştırma desteği. 

• LibMan geri yükleme ve temizleme işlemlerini tetikleme menü öğeleri. 

• Kitaplıkları bulma ve dosyalar projeye ekleme için arama iletişim kutusu. 

• Düzenleme için desteği libman.jsorı —LibMan bildirim dosyası. 

Görüntüleme veya indirme örnek kodu (karşıdan yükleme) 

Önkoşullar 

• Visual Studio 2019 ile ASP.NET ve web geliştirme iş yükü 


Kitaplık dosyaları Ekle 

Kitaplık dosyalarını bir AS P.N ET Core projesi için iki farklı şekilde eklenebilir: 


1. istemci tarafı kitaplık Ekle iletişim kutusunu kullanın 

2. LibMan bildirim dosyası girişlerini el ile yapılandırma 

İstemci tarafı kitaplık Ekle iletişim kutusunu kullanın 

Bir istemci-tarafı kitaplığını yüklemek için aşağıdaki adımları izleyin: 


İçinde Çözüm Gezgini, hangi dosyaların eklenmelidir proje klasörüne sağ tıklayın. Seçin ekleme > 
istemci tarafı kitaplık. İstemci tarafı kitaplık Ekle iletişim kutusu görüntülenir: 


Add Client-Side Library 

Providen cdnjs 
Library; 


<Typeto search> 


X 


© 


(§) Include ali library fileş 
O Choose specific fileş: 


<Choosea library to select fileş to install> 


Target Location: 


wwwroot/lib/ 


Install 


Cancel 


• Kitaplık sağlayıcısından seçin sağlayıcısı açılır. CDNJS varsayılan sağlayıcıdır. 

• içinde getirilecek kitaplığı adı Kitaplığı metin kutusu. IntelliSense belirtilen metinle başlayan kitaplıkların 
bir listesi sağlar. 

• IntelliSense listeden kitaplığı seçin. Bildirimi kitaplık adı soneki ile @ sembol ve seçili sağlayıcıya bilinen en 



























son kararlı sürümü. 


• Dahil etmek için hangi dosyaların karar verin: 

o Seçin tüm kitaplık dosyalarını dahil et tüm kitaplık dosyalarını içerecek şekilde radyo düğmesi, 
o Seçin belirli dosyaları seçin kitaplığın dosyaların bir alt kümesine eklenecek radyo düğmesi. Dosya 
Seçici ağaç radyo düğmesi seçili olduğunda etkindir, indirmek için dosya adlarını sol tarafındaki kutuları 
işaretleyin. 

• Dosyaları depolamak için proje klasörü belirtin hedef konum metin kutusu. Bir öneri olarak, her kitaplık 
ayrı bir klasörde depolar. 

Önerilen hedef konum klasör konumu iletişim kutusu, başlatılan dayanır: 

o Başlatılan proje kök ise: 

o wwwroot/lib kullanılır wwwroot bulunmaktadır, 
o LIB kullanılır wwwroot yok. 

o Başlatılan proje klasöründen, karşılık gelen klasörü adı kullanılır. 

Klasör öneri kitaplık adı ile soneki. Aşağıdaki tabloda, jöuery Razor sayfaları projesinde yüklerken klasör 
öneriler gösterilmektedir. 

BAŞLATMA KONUMU ÖNERİLEN KLASÖRÜ 

Proje kök dizinini (varsa wwwroot var) wwwroot/lib/jquery / 

Proje kök dizinini (varsa wwwroot yok) lib/jquery/ 

Sayfalan proje klasöründe Sayfa/jquery / 

• Tıklayın yükleme başına yapılandırma dosyalarını indirmek için düğmeye libman.json. 

• Gözden geçirme Kitaplık Yöneticisi akışı çıkış yükleme Ayrıntıları penceresi. Örneğin: 

Restore operation started... 

Restoring libraries for project LibManSample 
Restoring library jquery@3.3.1... (LibManSample) 

wwwroot/lib/jquery/jquery.min.js written to destination (LibManSample) 
wwwroot/lib/jquery/jquery.js written to destination (LibManSample) 
wwwroot/lib/jquery/jquery.min.map written to destination (LibManSample) 

Restore operation completed 
1 libraries restored in 2.32 seconds 

LibMan bildirim dosyası girişlerini el ile yapılandırma 

Proje kök 's LibMan bildiriminin içeriği üzerinde Visual Studio'da tüm LibMan işlemleri temel alır ( libman.json ). El 
ile düzenleyebilirsiniz libman.json proje için kitaplık dosyalarını yapılandırmak için. Visual Studio tüm kitaplık 
dosyalarını bir kez yükler libman.json kaydedilir. 

Açmak için libman.json düzenlemek için aşağıdaki seçenekler mevcuttur: 

• Çift libman.json dosyası Çözüm Gezgini. 

• Projeye sağ Çözüm Gezgini seçip istemci tarafı kitaplıkları yönetmek, t 

• Seçin istemci tarafı kitaplıkları yönetmek Visual Studio'dan proje menüsü, t 

t Varsa libman.json dosya proje kök dizininde zaten yoksa, varsayılan öğe şablonu içeriği ile oluşturulur. 

Visual Studio düzenleme desteği renklendirme gibi biçimlendirme, IntelliSense ve şema doğrulama zengin JSON 
sunar. LibMan bildirim JSON şeması bulunduğu https://json.schemastore.org/libman . 




Aşağıdaki bildirim dosyası ile tanımlanan yapılandırma başına LibMan alır libraries özelliği. Bir açıklama içinde 
tanımlanan nesne değişmez değerlerinin libraries izler: 

• Bir alt kümesini jQuery sürüm 3.3.1 CDNJS sağlayıcısından alınır. Alt tanımlanan fileş özelliği —jquery.min.js, 
jquery.js, ve jquery.min.map. Dosyalar projesinin yerleştirilir wwwroot/lib/jquery klasör. 

• Tamamen önyükleme sürüm 4.1.3 alınır ve yerleştirilmiş bir wwwroot/lib/önyükleme klasör. Nesne sabit değeri 

provider özelliklerine defaultProvider özellik değeri. LibMan unpkg sağlayıcısından önyükleme dosyaları alır. 

• Bir alt kümesini Lodash unsurun kuruluştaki tarafından onaylandı. Lodash.js ve lodash.min.js dosyaları yerel 
dosya sisteminden alınır C:\temp\lodash\ . Dosyalar projenin kopyalanır wwwroot/lib/lodash klasör. 

{ 

"version": "1.0", 

"defaultProvider": "cdnjs", 

"libraries": [ 

{ 

"library": "jquery@3.3.1", 

"fileş": [ 

"jquery.min.js", 

"jquery. js", 

"jquery.min.map" 

L 

"destination": "wwwroot/lib/jquery/" 

b 

{ 

"provider": "unpkg"., 

"library": "bootstrap@4.1.3", 

"destination": "wwwroot/lib/bootstrap/" 

b 

{ 

"provider": "filesystem", 

"library": "C:\\temp\\lodash\\", 

"fileş": [ 

"lodash.js", 

"lodash.min.js" 

b 

"destination": "wwwroot/lib/lodash/" 

} 

] 

} 



Kitaplık dosyaları geri yükleme 

Visual Studio içinden kitaplık dosyaları geri yüklemek için olmalıdır geçerli bir libman.json proje kök dosyasında. 
Geri yüklenen dosya projenin her kitaplık için belirtilen konuma yerleştirilir. 

ASP.NET Core projesinde iki yolla kitaplık dosyalarını geri yüklenebilir: 

1. Derleme sırasında dosyaları geri yükleme 

2. Dosyaları el ile geri yükleme 

Derleme sırasında dosyaları geri yükleme 

LibMan yapı işleminin bir parçası olarak tanımlanan kitaplık dosyalarını geri yükleyebilirsiniz. Varsayılan olarak, 
derleme üzerinde geriyükleme davranışı devre dışı bırakıldı. 









Ve test derleme üzerinde geri yükleme davranışı etkinleştirmek için: 

• Sağ libman.jsorı içinde Çözüm Gezgini seçip etkinleştirme geri istemci-tarafı kitaplıklarım temel 
yapı bağlam menüsünden. 

• Tıklayın Evet NuGet paketini yüklemek isteyip istemediğiniz sorulduğunda düğmesi. 
Microsoft.VVeb.LibraryManager.Build NuGet paketini projeye eklendi: 

<PackageReference Include="Microsoft.Web.LibraryManager.Build" Version="l.0.113" /> 


• LibMan dosya geri yüklemesi gerçekleşir doğrulamak için projeyi derleyin. 

Microsoft.web.LibraryManager.Build Paket LibMan projenin derleme işlemi sırasında çalıştırılan bir MSBuild 
hedefi yerleştirir. 

• Gözden geçirme derleme akışı çıkış LibMan etkinlik günlüğü penceresi: 

1>- Build started: Project: LibManSample, Configuration: Debug Any CPU - 

1 > 

l>Restore operation started... 
l>Restoring library jquery@3.3.1... 
l>Restoring library bootstrap@4.1.3... 

1 > 

1>2 libraries restored in 10.66 seconds 

l>LibManSample -> C:\LibManSample\bin\Debug\netcoreapp2.1\LibManSample.dll 
========== Build: 1 succeeded, 0 failed, 0 up-to-date, 0 skipped ========== 


Derleme üzerinde geri yükleme davranışı etkinleştirildiğinde libman.json bağlam menüsünü görüntüler bir devre 
dışı bırakma geri istemci-tarafı kitaplıklarını temel yapı seçeneği. Bu seçeneğin belirlenmesi kaldırır 
Microsoft.web. LibraryManager.Build paket proje dosyasından başvuru. Sonuç olarak, istemci tarafı kitaplıkları 
üzerinde her derleme artık geri yüklenir. 

Derleme üzerinde geri yükleme ayar ne olursa olsun, el ile diledikleri zaman geri yükleyebilirsiniz libman.json 
bağlam menüsü. Daha fazla bilgi için dosyaları el ile geri. 

Dosyaları el ile geri yükleme 

Kitaplık dosyaları el ile geri yüklemek için: 

• Çözümdeki tüm projeleri için: 

o içinde çözüm adına sağ tıklayın Çözüm Gezgini, 
o Seçin geri istemci tarafı kitaplıkları seçeneği. 

• Belirli bir proje için: 

o Sağ libman.json dosyası Çözüm Gezgini, 
o Seçin geri istemci tarafı kitaplıkları seçeneği. 

Geri yükleme işlemi devam ederken: 

• Görev durumu Merkezi (TSC) simgesi Visual Studio durum çubuğunda animasyon uygulanır ve okuyacaksa 
geri yükleme işlemi başladı. Simgesine tıklayarak, bilinen arka plan görevleri listeleme bir araç ipucu açılır. 

• Durum çubuğundaki ileti gönderilecek ve Kitaplık Yöneticisi akışı çıkış penceresi. Örneğin: 












Restore operation started... 

Restoring libraries for project LibManSample 
Restoring library jquery@3.3.1... (LibManSample) 

wwwroot/lib/jquery/jquery.min.js written to destination (LibManSample) 
wwwroot/lib/jquery/jquery.js written to destination (LibManSample) 
wwwroot/lib/jquery/jquery.min.map written to destination (LibManSample) 
Restore operation completed 
1 libraries restored in 2.32 seconds 


Kitaplık dosyaları sil 

Gerçekleştirilecek temiz Visual Studio'da daha önce geri kitaplık dosyaları silen işlemi: 

• Sağ libmarı.json dosyası Çözüm Gezgini. 

• Seçin temiz istemci tarafı kitaplıkları seçeneği. 

Kitaplık olmayan dosyaları kaldırılmamıştır önlemek için temizleme işlemi tüm dizinleri silmez. Yalnızca önceki geri 
yükleme dahil edilen dosyalar da kaldırır. 

Temizleme işlemi devam ederken: 

• Visual Studio durum çubuğunda TSC simge animasyon uygulanır ve okuyacaksa istemci kitaplıkları işlemi 
başlatıldı. Simgesine tıklayarak, bilinen arka plan görevleri listeleme bir araç ipucu açılır. 

• iletileri için durum çubuğu gönderilir ve Kitaplık Yöneticisi akışı çıkış penceresi. Örneğin: 

Clean libraries operation started... 

Clean libraries operation completed 
2 libraries were successfully deleted in 1.91 secs 

Temizleme işlemi, yalnızca dosyaları projeden siler. Kitaplık dosyaları için daha hızlı alma gelecekteki geri yükleme 
işlemleri üzerindeki önbellekte kalır. Yerel makinenin önbelleğinde depolanan kitaplık dosyalarını yönetmek için 
kullandığınız LibMan CLI. 

Kitaplık dosyaları kaldırma 

Kitaplık dosyaları kaldırmak için: 

• Açık libmarı.json. 

• Giriş işaretini içinde karşılık gelen konum libraries nesne sabit değeri. 

• Sol kenar boşluğunda görünür ampul simgesini tıklatın ve seçin kaldırma <library_name > 
@<library_version > : 


1 E 

]{ 


2 

"version": "1.0", 


3 

"defaultProvider" : "cdnjs". 

4 E 

"libraries": [ 


5 B { 


6 

"library": ”jquery|ŞI3.3.1", 

7 

"destination": ”wwwroot/lib/jquery/". 


"fileş": [ 


1{ Şort Properties 


|X Uninstalljquery@3.3.1 

' 

Checkfor updates ► 


14 E 




Alternatif olarak, el ile düzenleyebilir ve LibMan bildirimi kaydetmek Uibman.json). Geri yükleme işlemi dosyası 
kaydedildiğinde çalıştırır. Artık tanımlanan kitaplık dosyalarını libman.json projeden kaldırıldı. 











Kitaplık sürümünü güncelleştirme 

Bir güncelleştirilen kitaplığı sürümünü denetlemek için: 

• Açık libman.json. 

• Giriş işaretini içinde karşılık gelen konum libraries nesne sabit değeri. 

• Sol kenar boşluğunda görünür ampul simgesini tıklatın. Üzerine Güncelleştirmeleri denetle. 

LibMan yüklü olan sürümden daha yeni bir kitaplık sürümü olup olmadığını denetler.Aşağıdaki sonuçlar ortaya 
çıkabilir: 

• A güncelleştirme bulunamadı en son sürümü zaten yüklü değilse, ileti görüntülenir. 


• En son kararlı sürüm görüntülenme olmasa bile zaten yüklü. 


14 B { 

1? 9 - "library": "bootstrap@4.1.1". 

lf 

1} Şort Properties 

X Uninstall bootstrap@4.1.1 

ot/lib/bootstrap/". 

Check for updates ► 

O Stable: bootstrap@4.1.3 


• Yüklü olan sürümden daha yeni bir ön sürüm varsa, ön sürümü görüntülenir. 

Eski bir kitaplığı sürümünün indirgemek için el ile düzenlemeniz libman.json dosya. Dosya kaydedildiğinde, 
LibMan geri yükleme işlemi: 

• Gereksiz dosyaları önceki sürümden kaldırır. 

• Yeni ve güncelleştirilmiş dosyaları yeni sürümden ekler. 

Ek kaynaklar 

• ASP.NET Core ile LibMan komut satırı arabirimini (CLı) kullanın 

• LibMan GitHub deposu 







ASRNET Core Grönyı kullanma 

6.12.2019 • 15 minutes to read ı Edit Online 


Grrete, komut dosyası küçültmeye, TypeScript derlemesini, kod kalitesi "Lint" araçlarını, CSS ön işlemcilerini ve 
yalnızca istemci geliştirmeyi desteklemek için gereken tüm yinelenen chore 'yi otomatikleştiren bir JavaScript 
görev Çalıştırıcısı. Gryeniden bağlama Visual Studio 'da tam olarak desteklenir. 

Bu örnek, başlangıç noktası olarak boş bir AS P.N ET Core projesi kullanarak, istemci derleme işleminin sıfırdan 
nasıl otomatikleştirileceğim gösterir. 

Tamamlanmış örnek, hedef dağıtım dizinini temizler, JavaScript dosyalarını birleştirir, kod kalitesini denetler, 
JavaScript dosya içeriğini daraltabilir ve Web uygulamanızın köküne dağıtır. Aşağıdaki paketleri kullanacağız: 

• gryeniden bağlama: gryeniden görev Çalıştırıcısı paketi. 

• gryeniden bağlama-contrib-Clean: dosya veya dizinleri kaldıran bir eklenti. 

• grkıt-contrib-jshınt: JavaScript kod kalitesini inceleyen bir eklenti. 

• gryeniden bağlama-contrib-Concat: dosyaları tek bir dosyaya birleştiren bir eklenti. 

• gryeniden bağlama-contrib-utimy: boyutu azaltmak İçin JavaScript 'i mini görüntüleyen bir eklenti. 

• gryeniden bağlama-contrib-VVatch: dosya etkinliğini izleyen bir eklenti. 

Uygulama hazırlanıyor 

Başlamak için yeni bir boş Web uygulaması ayarlayın ve TypeScript örnek dosyaları ekleyin. TypeScript dosyaları 
varsayılan Visual Studio ayarları kullanılarak JavaScript 'e otomatik olarak derlenir ve Grönyı kullanarak işlemek 
için ham malzemelerimiz olacaktır. 

1. Visual Studio 'da yeni bir asp.net web Application oluşturun. 

2. Yeni ASP.NET projesi İletişim kutusunda boş şablon ASP.NET Core seçin ve Tamam düğmesine tıklayın. 

3. Çözüm Gezgini, proje yapısını gözden geçirin. \src klasör boş wwwnoot ve Dependencies düğümlerini 
içerir. 


Solution Expl 

O O 

örer 

T © - 

c 

ıf Tf) 

P 

_■ 

n x 

Search Solution Explorer (Ctrl*;) 



P* 


Solution 'GruntFromEmptyWeb' (1 project) 
a Solution Items 
£T global.json 
a Ö src 


GruntFromEmptyVVeb 


/ Properties 
© wwwroot 
, 71 Dependencies 
> References 
oT project.json 
<13 Project_Readme.html 
c* Startup.es 


4. Proje dizininize TypeScript adlı yeni bir klasör ekleyin. 










5. Herhangi bir dosya eklemeden önce, Visual Studio 'Nun TypeScript dosyaları için 1 kaydetme sırasında derle 
1 seçeneğinin işaretli olduğundan emin olun. Araçlar > Seçenekler > metin Düzenleyicisi > TypeScript 
> projesi' ne gidin: 



6. TypeScript dizinine sağ tıklayın ve bağlam menüsünden > yeni öğe Ekle 1 yi seçin. JavaScript dosya 
öğesini seçin ve dosyayı tastes. TS olarak adlandırın (*. TS uzantısını aklınızda edin). Aşağıdaki TypeScript 
kodu satırını dosyaya kopyalayın (kaydettiğinizde, JavaScript kaynağıyla yeni bir tastes. js dosyası görünür). 

enum Tastes { Sweet, Sour, Salty, Bitter } 

7. TypeScript dizinine ikinci bir dosya ekleyin ve Food.ts adlandırın. Aşağıdaki kodu dosyasına kopyalayın. 

class Food { 

constructor(name: string, calories: number) { 
this._name = name; 
this._calories = calories; 

} 

private _name: string; 

get Name() { 

return this._name; 

} 

private _calories: number; 

get Calories() { 

return this._calories; 

} 

private _taste: Tastes; 

get Taste(): Tastes { return this._taste } 

set Taste(value: Tastes) { 
this._taste = value; 

} 


NPM 'yi yapılandırma 

Daha sonra, NPM 'yi, grer ve grsıt-görevler 'i indirmek için yapılandırın 

1. Çözüm Gezgini, projeye sağ tıklayın ve bağlam menüsünden > yeni öğe Ekle 1 yi seçin. NPM 
yapılandırma dosyası öğesini seçin, varsayılan adı Package. JSOA/olarak bırakın ve Ekle düğmesine 
tıklayın. 

2. Package. JSON dosyasında, devDependencies nesne ayraçları içinde "grönbağlama" yazın. IntelliSense 
listesinden grunt ' yi seçin ve ENTER tuşuna basın. Visual Studio gryeniden paket adını teklif eder ve iki 
nokta üst üste ekler, iki nokta üst üste, IntelliSense listesinin en üstünden paketin en son kararlı sürümünü 




















seçin (IntelliSense görünmüyorsa ctri-space 


a basın). 


"devDependencies": { 


"grunt": "" 

} 

£ 0-4-5 

gj A 0.4.5 
-0.4.5 


NOTE 

NPM, bağımlılıkları düzenlemek için anlamsal sürüm oluşturmayı kullanır. SemVer olarak da bilinen anlamsal sürüm 
oluşturma, büyük > <numaralandırma düzenine sahip paketleri tanımlar.<küçük >.<Patch >. IntelliSense yalnızca 
birkaç ortak seçeneği göstererek anlamsal sürüm oluşturmayı basitleştirir. IntelliSense listesindeki üst öğe (Yukarıdaki 
örnekte 0.4.5), paketin en son kararlı sürümü olarak değerlendirilir. Şapka ( A ) simgesi en son ana sürümle eşleşir ve 
tilde (~) en son ikincil sürümle eşleşir. SemVer 'in sağladığı tam ifade çekimi için bir kılavuz olarak NPM semver sürüm 
ayrıştırıcısı başvurusuna bakın. 


3. Aşağıdaki örnekte gösterildiği gibi, Clearıjshmt, Concat, uıshovvmyve Watch için grkıt-contrib-* paketlerine 
yük daha fazla bağımlılık ekleyin. Sürümlerin örnekle eşleşmesi gerekmez. 


"devDependencies": { 


"grunt": "0.4.5", 


"grunt-contrib-clean": 

"0.6.0", 

"grunt-contrib-jshint" 

"0.11.0", 

"grunt-contrib-concat" 

"0.5.1", 

"grunt-contrib-uglify" 

"0.8.0", 

"grunt-contrib-watch": 

"0.6.1" 

} 



4. Package. JSON dosyasını kaydedin. 

Her bir devDependencies öğesi için paketler, her paketin gerektirdiği tüm dosyalarla birlikte indirilir. Paket 
dosyalarını, Çözüm Gezgini tüm dosyaları göster düğmesini etkinleştirerek node_modules dizininde 
bulabilirsiniz. 

* S nodejtıodules 
t> f j grunt 

> lj grunt-contrib-dean 

> grunt-contrib-concat 

> fj grunt-contrib-jshint 
t> ı;;"3 grunt-contrib-uglify 
P grunt-contrib-vvatch 


NOTE 

Gerekirse, Dependencies\NPM ' a sağ tıklayıp paketleri geri yükle menü seçeneğini belirleyerek Çözüm Gezgini 
bağımlılıkları el ile geri yükleyebilirsiniz. 


wwwroot 
P Dependencies 


> g] NPM 


TypeScrip- 
£T Food.j: 
TS Food.t 
£T Tastes, 
TS Tastes, 



Restore Packages k 



Web Essentials 
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Configure External Tools... 
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Scopeto This 

New Solution Explorer View 



Properties 

Alt+Enter 
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Grönbağlama yapılandırma 

Gror, el ile çalıştırılabilecek veya Visual Studio 'daki olaylara göre otomatik olarak çalışacak şekilde yapılandırılmış 

görevleri tanımlayan, yükleyen ve kaydeden Gruntfile.js adlı bir bildirim kullanılarak yapılandırılır. 

1. Projeye sağ tıklayın ve > Yeni öğe Ekle 1 yi seçin. JavaScript dosya öğesi şablonunu seçin, adı Gruntfile. 
/solarak değiştirin ve Ekle düğmesine tıklayın. 

2. Gruntfile.js' ye aşağıdaki kodu ekleyin, initconfig işlevi her bir paket için seçenekleri ayarlar ve modülün 
geri kalanı görevleri yükler ve kaydeder. 

modüle.exports = function (grunt) { 
grunt.initConfig({ 

}); 

}; 

3. initconfig işlevi içinde, aşağıdaki örnek Gruntfile.js ' de gösterildiği gibi ciean görevi için seçenekler 
ekleyin, ciean görevi Dizin dizeleri dizisini kabul eder. Bu görev, dosyaları Wwwroot/lib 'den kaldırır ve tüm 
/Temp klasörüne yazılır dizinini kaldırır. 

modüle.exports = function (grunt) { 
grunt.İnitConfig({ 

clean: ["wwwroot/lib /*", "temp/"], 

}); 

}; 

4. initconfig işlevinin altında, grunt.îoadNpmTasks için bir çağrı ekleyin. Bu işlem, görevin Visual Studio 'dan 
bir şekilde bir şekilde bir şekilde bir şekilde 

grunt.ÎoadNpmTasks("grunt-contrib-clean"); 


5. Gruntfile.js dosyasınıkaydedirı. Dosya aşağıdaki ekran görüntüsüne benzer şekilde görünmelidir. 


Gruntfile.js x B 

Si <global> » j © module.exports(grunt) 

- modüle.exports = function (grunt) { 

İE grunt.initConfig({ 

clean: ["wwwroot/lib /*" t "temp/"] 

}); 

grunt . ÎoadNpmTasks ("grunt-contrib-clean"); 


6. Gruntfile.js ' ye sağ tıklayın ve bağlam menüsünden görev Çalıştırıcısı Gezgini ' ni seçin. Görev 

çalıştırıcı Gezgini penceresi açılır. 

Web Essentials 
C* Öpen 

Öpen VVith... 

Search for TypeScript Typings... 

) Task Runner Explorer 

Configure External Tools... 

Çrnnctn TWır 


7. clean görev Çalıştırıcısı Gezgininde Görevler altında görüntülendiğini doğrulayın. 











Task Runner Explorer 

- ? X 

GruntFromEmptyVVeb 

yü Bindings 

p a £T gruntfile.js 

t Before Build (0) 

a Tasks 

t After Build (0) 

y 

clean 

t Clean (0) 


t Project Öpen (0) 


8. Temizleme görevine sağ tıklayın ve bağlam menüsünden Çalıştır ' ı seçin. Bir komut penceresi, görevin 
ilerlemesini görüntüler. 


Task Runner Explorer 

- ? X 

6 

GruntFromEmptyVVeb v 

I yE Bindings clean X 

F 

V 

a H gruntfile.js 

a Tasks 

dean^ 

\users\noel\documents\visual studio B 
2015 .Project s GruntFromEmptyWeb\src H 
\GruntFromEmptyWeb\gruntfile. js" clean H 
Running ”clean:0" (clean) task H 
Process terminated with code 0. H 
» 0 paths cleaned. M 



Running "clean:l" (clean) task H 

>> 0 paths cleaned. 



_1 


NOTE 

Henüz temizleyene dosya veya dizin yok. isterseniz, bunları Çözüm Gezgini el ile oluşturabilir ve sonra temiz görevi bir 
test olarak çalıştırabilirsiniz. 


9. initconfig işlevinde, aşağıdaki kodu kullanarak concat için bir giriş ekleyin. 

src Property dizisi birleştirilecek dosyaları, birleştirilmeleri gereken sırayla listeler, dest özelliği, üretilen 
Birleşik dosyanın yolunu atar. 

concat: { 
ali: { 

src: ['TypeScript/Tastes.js', 'TypeScript/Food.js '], 
dest: 'temp/combined.js' 

} 

}, 


NOTE 

Yukarıdaki koddaki ali özelliği bir hedefin adıdır. Hedefler, bazı Grsi görevlerinde birden çok derleme ortamına izin 
vermek için kullanılır IntelliSense kullanarak yerleşik hedefleri görüntüleyebilir veya kendi kendinize atayabilirsiniz. 


10. Aşağıdaki kodu kullanarak jshint görevini ekleyin. 

Jshınt code-quaiity yardımcı programı, Temp dizininde bulunan her JavaScript dosyasında çalıştırılır. 

jshint: { 

fileş: ['temp/*.js']j 
options: { 

'-W069': false. 


} 














NOTE 

"-W069" seçeneği, JavaScript, nokta gösterimi yerine bir özellik atamak için köşeli ayraç sözdizimi kullandığında jshınt 
tarafından oluşturulan bir hatadır, örneğin Tastes.sweet yerine Tastes["sweet"] . Seçeneği, işlemin geri kalanının 
devam etmesine izin vermek için uyarıyı kapatır. 


11. Aşağıdaki kodu kullanarak uglify görevini ekleyin. 

Görev, Temp dizininde bulunan birleştirilmiş, js dosyasını mini olarak oluşturur ve standart adlandırma 
kuralı <dosya adı>. mirı.js' den sonra sonuç dosyasını Wwwroot/lib içinde oluşturur. 

uglify: { 
ali: { 

src: ['temp/combined. js ' ], 

dest: 'wwwroot/lib/combined.min.js' 

} 

}, 

12. grunt-contrib-ciean yükleyen grunt.loadNpmTasks çağrısı altında, aşağıdaki kodu kullanarakjshınt, Concat 
ve UART My için aynı çağrıyı ekleyin. 

grunt.loadNpmTasks('grunt-contrib-jshint'); 
grunt.loadNpmTasks('grunt-contrib-concat'); 
grunt.loadNpmTasks('grunt-contrib-uglify'); 


13. Grurıtfile.js dosyasınıkayded\r\. Dosya aşağıdaki örnekteki gibi görünmelidir. 

B 


14. Görev çalıştırıcı Gezgini görev listesi ciean , concat, jshint ve uglify görevleri içerdiğine dikkat edin. 
Her görevi sırayla çalıştırın ve Çözüm Gezginisonuçları gözlemleyin. Her görev hatasız çalışmalıdır. 


Gruntfıle.js -o X | 
(1 modüle 


» © exports(grunt) 


E 

ı 

E 


İEmodule.exports = function (grunt) { 
grunt.initConfig({ 

clean: ["wwwroot/lib/*", "temp/"], 
concat: { 
ali: { 

src: [ ’TypeScript/Tastes.js', 'TypeScript/Food.js'], 
dest: 'temp/combined.js’ 

} 

}, 

jshint: { fileş: [ 'temp/*.js' ] , options: { ' 
uglify: { 
ali: { 

src: [ ’temp/combined.js' ] , 
dest: 'wwwroot/lib/combined.min.js‘ 

I > ’ 


E 

E 


-W069': false, } }, 


grunt.loadNpmTasks( 'grunt-contrib-ciean' ); 
grunt.loadNpmTasks( 'grunt-contrib-jshint' ); 
grunt.loadNpmTasks( 'grunt-contrib-concat' ); 
grunt.loadNpmTasks( 'grunt-contrib-uglify' ); 


}; 


110 % 












Task Runner Explorer 
£ GruntFromEmptyVVeb 

p Â <CT gruntfile.js 

- T-k* 

clean 


J sl ► Run 


ug 


Bind 


I yE Bindings concat x 


- ¥ X 


"c: \users\noel\documents\visual studio 
2015\Projects\GruntFromEmptyWeb\src 
\GruntFromEmptyWeb" --gruntfile “c: 
\users\noel\documents\visual studio 
/\Projects\GruntFromEmptyWeb\src 
ıntFromEmptyWeb\gruntfile. js” concat 
ing "concat:ali" (concat) task 
_ temp/combined.js created. 


Process termınated wıth code 0. 


Concat görevi yeni bir birleştirilmiş, js dosyası oluşturur ve bunu Temp dizinine koyar, jshint görevi 
yalnızca çalışır ve çıkış üretmez, uglify görevi yeni bir birleştirilmiş, min.js dosyası oluşturur ve bunu 
Wwwroot/lib'e koyar. Tamamlandığında, çözüm aşağıdaki ekran görüntüsüne benzer şekilde görünmelidir: 

A iğ] GruntFromEmptyVVeb 

f* Properties 
a @ wwwroot 

A |ib 

combined.min.js 

> .C Dependencies 

> ■■ References 
A d temp 

£T combined.js 
a dİ TypeScript 
£T Food.js 
TS Food.ts 
İT Tastes.js 
TS Tastes.ts 
£T Gruntfile.js 
£T package.json 
oT project.json 
<13 Project_Readme.html 
c» Startup.es 


NOTE 

Her pakete ilişkin seçenekler hakkında daha fazla bilgi için https://www.npmjs.com/ziyaret edin ve ana sayfadaki 
arama kutusunda paket adını arayın. Örneğin, tüm parametrelerini açıklayan bir belge bağlantısı almak için grcönt- 
contrib-Clean paketini arayabilirsiniz. 


Şimdi hepsi bir arada 

Belirli bir dizideki bir dizi görevi çalıştırmak için Gryeniden registerTask() yöntemini kullanın. Örneğin, yukarıdaki 
örnek adımları sırayla çalıştırmak için > Concat-> jshınt-> uıshowmy 1 a gidin ve aşağıdaki kodu modüle ekleyin. 
Kod, InitConfig dışında loadNpmTasks () çağrılarıyla aynı düzeye eklenmelidir. 

grunt.registerTask("all", [’clean'j 'concat', 'jshint', 'uglify']); 


Yeni görev, görev Çalıştırıcısı Gezgini ’nde diğer ad görevleri altında görüntülenir.Bunu, diğer görevleri yaptığınız 
gibi sağ tıklayıp çalıştırabilirsiniz, ali görevi sırasıyla clean , concat , jshint ve uglify çalışacaktır. 



£T gruntfile.js 

a AliasTasks 


jshint 

uglify 






















Değişiklik izleme 

watch bir görev, dosyaları ve dizinleri göz önünde bulundurur, izleme, değişiklikleri algılarsa görevleri otomatik 
olarak tetikler. TypeScript dizinindeki *.js dosyalarında yapılan değişiklikleri izlemek için aşağıdaki kodu InitConfig 
dosyasına ekleyin. Bir JavaScript dosyası değiştirilirse watch ali görevini çalıştırır. 

watch: { 

fileş: ["TypeScript/*.js"], 
tasks: ["ali"] 

} 

Görev çalıştırıcı Gezgini'nde watch görevi göstermek için ioadNpmTasks() bir çağrı ekleyin. 

grunt.loadNpmTasks(’grunt-contrib-watch’); 


Görev çalıştırıcı Gezgini ' nde gözcü görevine sağ tıklayın ve bağlam menüsünden Çalıştır 1 ı seçin. Çalışan izleme 
görevini gösteren komut penceresinde "bekleniyor..." görüntülenir ileti. TypeScript dosyalarından birini açın, bir 
boşluk ekleyin ve dosyayı kaydedin. Bu işlem, izleme görevini tetikler ve diğer görevleri sırayla çalışacak şekilde 
tetikler. Aşağıdaki ekran görüntüsünde örnek bir çalıştırma gösterilmektedir. 


yll Bindings watch (running) X 


2015\Projects\GruntFromEmptyWeb\src 
\GruntFromEmptyWeb" --gruntfile "c: 
\users\noel\documents\ visual studio 
2015\Projects\GruntFromEnptyWeb\src 
\GruntFromEmptyWeb\gruntfile. js" watch 
Running ”watch" task 
Waiting... 

Running “clean:0" (clean) task 


Running “clean:l" (clean) task 

» 1 path cleaned. 


ile temp/combined.js creat 
jnning "jshint:files" (jsh 


Running “uglify:all" (uglify) task 


Completed in 1.236s at Fri Mar 13 2015 
17:12:36 GMT-0700 (Pacific Daylight 
Time) - Waiting... 


Visual Studio olaylarına bağlama 

Visual Studio 'da her çalıştığınızda görevlerinizi el ile başlatmak istemediğiniz müddetçe, derleme, Temizlemeve 
proje açık olayları sonrasında derlemeden öncegörevleri bağlayın. 


watch , Visual Studio her açıldığında çalışacak şekilde bağlayın. Görev çalıştırıcı Gezgini' nde, Gözcü görevine sağ 
tıklayın ve bağlam menüsünden bağlamalar > Proje Aç ' ı seçin. 


jshint 

uglify 


vvatch 

► Run 


Bindings t 


Before Build 

After Build 

Clean 




Project Öpen [\ 



Projeyi kaldırın ve yeniden yükleyin. Proje yeniden yüklendiğinde, izleme görevi otomatik olarak çalışmaya başlar. 


















Özet 


Gryeniden oluşturma, çoğu istemci derleme görevini otomatikleştirmek için kullanılabilen güçlü bir görev 
Çalıştırıcısı. Grsıt, paketlerini teslim etmek için NPM 'den yararlanır ve Visual Studio ile tümleştirme özellikleri 
sağlar. Visual Studio 'nun görev Çalıştırıcısı Gezgini yapılandırma dosyalarındaki değişiklikleri algılar ve görevleri 
çalıştırmak, çalışan görevleri görüntülemek ve görevleri Visual Studio olaylarına bağlamak için uygun bir arabirim 
sağlar. 



ASPNET Core statik varlıkları paketleyin ve azın 

4.12.2019 • 16 minutes to read ı Edit Online 


Scott Ade ve David çam tarafından 

Bu makalede, bu özelliklerin ASP.NET Core Web uygulamalarıyla nasıl kullanılabileceği da dahil olmak üzere 
paketleme ve küçültmeye yönelik uygulama avantajları açıklanmaktadır. 

Paketlemeyi ve küçültmeye göre 

Paketleme ve küçültme, bir Web uygulamasında uygulayabileceğiniz iki ayrı performans iyileştirmesidir. Birlikte 
kullanıldığında, paketleme ve minbirleştirime, sunucu isteklerinin sayısını azaltarak ve istenen statik varlıkların 
boyutunu azaltarak performansı geliştirir. 

Paketleme ve minbirleştirmesi birincil olarak ilk sayfa isteği yükleme süresini geliştirir. Bir Web sayfası 
istendiğinde, tarayıcı statik varlıkları (JavaScript, CSS ve görüntüler) önbelleğe alır. Sonuç olarak, aynı sayfada veya 
sayfalarda aynı varlıkları talep eden aynı siteye veya sayfalara istekte bulunduğunda, paketleme ve minlıme 
performansı artırmayın. Süre sonu üst bilgisi varlıklarda doğru ayarlanmamışsa ve paketleme ve küçültme 
kullanılmıyorsa, tarayıcının yenilik buluşsal yöntemleri, varlıkları birkaç günden daha eski bir süre sonra işaretler. 
Ayrıca, tarayıcı her varlık için bir doğrulama isteği gerektirir. Bu durumda, paketleme ve minbirleşme, ilk sayfa 
isteğinden sonra bile bir performans geliştirmesi sağlar. 

Paketleme 

Paketleme, birden çok dosyayı tek bir dosya halinde birleştirir. Paketleme, Web sayfası gibi bir Web varlığını 
işlemek için gerekli olan sunucu isteği sayısını azaltır. Özellikle CSS, JavaScript vb. için istediğiniz sayıda ayrı paket 
oluşturabilirsiniz. Daha az dosya tarayıcıdan sunucuya veya uygulamanızı sağlayan hizmetten daha az HTTP 
isteğinin olması anlamına gelir. Bu, geliştirilmiş ilk sayfa yükü performansına neden olur. 

Küçültme 

Minbirleşme işlevleri işlevselliği değiştirmeden koddan gereksiz karakterleri kaldırır.Sonuç, istenen varlıklarda 
(CSS, görüntüler ve JavaScript dosyaları gibi) önemli bir boyut azalmasıyla sonuçlanır. Yaygın olarak kullanılan yan 
etkileri, değişken adlarını tek bir karaktere kısaltmayı ve açıklamaları ve gereksiz boşlukları kaldırmayı içerir. 

Aşağıdaki JavaScript işlevini göz önünde bulundurun: 

AddAltTolmg = function (imageTagAndlmagelD, imageContext) { 

///<signature> 

///<summary> Adds an alt tab to the image 
// </summary> 

//<panam name="imgElement" type="String">The image selector.</param> 

//<param name="ContextForImage" type="String">The image context.</param> 

///</signature> 

var imageElement = $(imageTagAndImageIDj imageContext); 

imageElement.attr('alt', İmageElement.attr('id')•replace(/ID/, ' ')); 

} 


Minbirleşme işlevi şu şekilde azaltır: 


AddAltToImg=function(tj a){var r=$(t,a); r. attr( "alt", r. attr("id"). neplace(/ID/, ""))}; 


Açıklamaları ve gereksiz boşlukları kaldırmanın yanı sıra aşağıdaki parametre ve değişken adları şu şekilde yeniden 
adlandırıldı: 






OZGUN 


ISIM 


imageTagAndlmagelD 


t 


imageContext 


imageElement 


Paketleme ve küçültmeye yönelik etkileri 

Aşağıdaki tabloda, tek tek yükleme varlıkları ve paketleme ve küçültme kullanımı arasındaki farklılıklar 
özetlenmektedir: 


EYLEM 

B/M İLE 

B/M OLMADAN 

DEĞİŞİKLİK 

Dosya İstekleri 

7 

18 

157% 

KB aktarıldı 

156 

264.68 

70% 

Yükleme süresi (MS) 

885 

2360 

167% 


Tarayıcılar HTTP istek üst bilgileriyle ilgili oldukça ayrıntılıdır.Gönderilen toplam bayt ölçümü, paketleme sırasında 
önemli bir düşüş gördük. Yükleme zamanı önemli bir geliştirme gösterir, ancak bu örnek yerel olarak çalışır.Ağ 
üzerinden aktarılan varlıklarla paketleme ve küçültmeye karşı kullanım sırasında daha fazla performans artışı 
gerçekleştirilir. 

Bir paketleme ve küçültmeye karşı bir strateji seçin 

MVC ve Razor Pages proje şablonları, bir JSON yapılandırma dosyasından oluşan paketleme ve küçültmeye 
yönelik kullanıma hazır bir çözüm sunar. Grdalar görev Çalıştırıcısı gibi üçüncü taraf araçlar, aynı görevleri biraz 
daha karmaşıklıkla yerine getirmiş. Geliştirme iş akışınız, bağlama ve görüntü iyileştirmesi gibi—, paket oluşturma 
ve küçültmeye göre işleme gerektirdiğinde, üçüncü taraf bir araç harika bir araçtır. Tasarım zamanı paketleme ve 
küçültme kullanarak, küçültülmüş dosyalar uygulamanın dağıtımından önce oluşturulur. Dağıtımdan önce 
paketleme ve küçültme, azaltılmış sunucu yükünün avantajlarından faydalanabilmenizi sağlar. Bununla birlikte, 
tasarım zamanı paketleme ve küçültme, derleme karmaşıklığını artırır ve yalnızca statik dosyalarla birlikte 
kullanılabilir. 

Paketlemeyi ve küçültmeye göre yapılandırma 

ASP.NET Core 2,0 veya önceki sürümlerde, MVC ve Razor Pages proje şablonları her bir paket için seçenekleri 
tanımlayan bir paketleme liconfig. JSON yapılandırma dosyası sağlar: 

ASP.NET Core 2,1 veya sonraki sürümlerde, MVC veya Razor Pages proje köküne paketleme liconfig. JSONadU 
yem bir JSON dosyası ekleyin. Aşağıdaki JSON 'yi bir başlangıç noktası olarak bu dosyaya ekleyin: 






[ 

{ 

"outputFileName": "wwwroot/css/site.min.css", 

"inputFiles": [ 

"wwwroot/css/site.css" 

] 

}, 

{ 

"outputFileName": "wwwroot/js/site.min.js", 

"İnputFiles": [ 

"wwwroot/js/site,js" 

b 

"minify": { 

"enabled": true, 

"renameLocals": tnue 

b 

"sourceMap": false 

} 

] 

Paketleme liconfig. JSON dosyası her bir paket için seçenekleri tanımlar. Yukarıdaki örnekte, özel JavaScript 
( Wwwroot/js/site.js ) ve stil sayfası ( Wwwroot/CSS/site. css) dosyaları için tek bir paket yapılandırması 
tanımlanmıştır. 

Yapılandırma seçenekleri şunlardır: 

• outputFileName : çıkış yapılacak paket dosyasının adı., Paketleme liconfig. JSON dosyasından göreli bir yol 
içerebilir. Gerekli 

• inputFiles : birlikte paketedilecek dosya dizisi. Bunlar yapılandırma dosyasına yönelik göreli yollardır. isteğe 
bağlı* boş bir değer boş bir çıktı dosyasıyla sonuçlanır. Glob desenleri desteklenir. 

• minify : çıkış türü için minbirleşme seçenekleri, isteğe bağlı, varsayılan minify: { enabied: true } 
o Yapılandırma seçenekleri çıkış dosyası türü başına kullanılabilir. 

o CSS minifier 
o JavaScript minifier 
o HTML minifier 

• inciudeinProject : oluşturulan dosyaların proje dosyasına eklenip eklenmeyeceğini belirten bayrak, isteğe 
bağlı, Varsayılan-yanlış 

• sourceMap : paketlenmiş dosya için bir kaynak eşlemesi oluşturulup oluşturulmayacağım belirten bayrak, isteğe 
bağlı, Varsayılan-yanlış 

• sourceMapRootPath : oluşturulan kaynak eşleme dosyasını depolamak için kök yolu. 

Paketleme ve küçültmeye yönelik derleme zamanı yürütme 

BuildBundlerMinifier NuGet paketi, derleme zamanında paketleme ve küçültmeye karşı yürütmeyi mümkün bir 
şekilde sunar. Paket, derleme ve Temizleme zamanında çalıştırılan MSBuild hedeflerini çıkartır. Paketleme liconfig. 
JSON dosyası, tanımlanan yapılandırmaya göre çıkış dosyalarını oluşturmak için yapı işlemi tarafından çözümlenir. 


NOTE 

BuildBundlerMinifier, GitHub 'da Microsoft 'un destek sunmamakta olan topluluk odaklı bir projeye aittir. Sorunlar 
buradadosyalanmalıdır. 


• Visual Studio 

• .NETCoreCLI 







BuildBurıdlerMinifier paketini projenize ekleyin. 


Projeyi oluşturun. Çıkış penceresinde aşağıdakiler görüntülenir: 

1>- Build started: Project: BuildBundlerMinifierApp, Configuration: Debug Any CPU - 

1 > 

l>Bundler: Begin Processing bundleconfig.json 
1> Minified wwwroot/css/site.min.css 
1> Minified wwwroot/js/site.min.js 
l>Bundler: Done Processing bundleconfig.json 

l>BuildBundlerMinifierApp -> C: \BuildBundlerMinifierApp\bin\Debug\netcoreapp2.0\BuildBundlerMinifierApp .dil 
========== Build: 1 succeeded, 0 failed, 0 up-to-date, 0 skipped ========== 


Projeyi temizleyin. Çıkış penceresinde aşağıdakiler görüntülenir: 

1>- Clean started: Project: BuildBundlerMinifierApp, Configuration: Debug Any CPU 

1 > 

l>Bundler: Cleaning output from bundleconfig.json 
l>Bundler: Done cleaning output file from bundleconfig.json 
========== Clean: 1 succeeded, 0 failed, 0 skipped ========== 


Paketlemeyi ve küçültmeye karşı geçici yürütme 


Paketleme ve küçültmeye yönelik görevleri, projeyi oluşturmadan geçici olarak çalıştırmak mümkündür. 
BundlerMinifier. Core NuGet paketini projenize ekleyin: 



Bu paket, .NET Core CLI DotNet-demeti aracını içerecek şekilde genişletir. Aşağıdaki komut, Paket Yöneticisi 
Konsolu (PMC) penceresinde veya bir komut kabuğunda çalıştırılabilir: 


dotnet bundle 


IMPORTANT 

NuGet Paket Yöneticisi, *. csproj dosyasına <PackageReference /> düğümleri olarak bağımlılıklar ekler, dotnet bundle 
komutu, yalnızca bir <DotNetdiToolReference /> düğümü kullanıldığında .NET Core CLI kaydedilir.*. Csproj dosyasını 
uygun şekilde değiştirin. 


İş akışına dosya ekleme 


Aşağıdakilere benzer bir ek özel, css dosyası eklendiğini bir örnek düşünün: 






















.about, [role=main], [role=complementary] { 
margin-top: 60px; 

} 

footer { 

margin-top: 10px; 

} 


Custom. css dosyasını küçültmeye ve site, css ' yi bir site. min. css dosyasına paketlemek için, ilgili yolu paketleme 
liconfig. JSONöğeslne ekleyin: 

[ 

{ 

"outputFileName": "wwwroot/css/site.min.css ", 

"inputFiles": [ 

"wwwroot/css/site.css", 

"wwwroot/css/custom.css" 

] 

L 

{ 

"outputFileName": "wwwroot/js/site.min.js", 

"İnputFiles": [ 

"wwwroot/js/site.js" 

b 

"minify": { 

"enabled": true, 

"renameLocals": true 

b 

"sourceMap": false 

} 

] 


NOTE 

Alternatif olarak, aşağıdaki glob deseninin kullanılması gerekir: 

"inputFiles": ["wwwroot/**/I(*.min).css" ] 

Bu glob model tüm CSS dosyalarıyla eşleşir ve küçültülmüş dosya modelini dışlar. 


Uygulamayı derleyin. Site. min. css dosyasını açın ve Custom. css içeriğinin dosyanın sonuna ekleneceğini 
unutmayın. 

Ortam tabanlı paketleme ve minbirleşme 

En iyi uygulama olarak, uygulamanızın paketlenmiş ve küçültülmüş dosyaları bir üretim ortamında kullanılmalıdır. 
Geliştirme sırasında, özgün dosyalar uygulamanın hata ayıklamasını daha kolay hale getirir. 

Görünümlerinizde ortam etiketi yardımcısını kullanarak sayfalarınıza hangi dosyaların ekleneceğini belirleyin. 
Ortam etiketi Yardımcısı yalnızca belirli ortamlardaçalışırken içeriğini işler. 

Aşağıdaki environment etiketi, Development ortamında çalışırken işlenmemiş CSS dosyalarını işler: 

<environment include="Development"> 

clink rel="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.css" /> 
clink rel="stylesheet" href="~/css/site.css" /> 

</environment> 










<environment names="Development"> 

<link rel="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.css" /> 

<link rel="stylesheet" href="~/css/site.css" /> 

</environment> 

Aşağıdaki environment etiketi, Development dışında bir ortamda çalışırken paketlenmiş ve küçültülmüş CSS 
dosyalarını işler. Örneğin, Production veya staging içinde çalıştırmak, bu stil sayfaları işlemesini tetikler: 

<environment exclude="Development"> 

clink rel="stylesheet" href=" https://ajax.aspnetcdn.eom/ajax/bootstrap/3.3.7/css/bootstrap.min. ess" 
asp-fallback-href="~/lib/bootstrap/dist/css/bootstrap.min.ess" 

asp-fallback-test-class="sr-only" asp-fallback-test-property="position" asp-fallback-test- 
value="absolute" /> 

<link rel="stylesheet" href="~/css/site.min.css" asp-append-version="true" /> 

</environment> 


<environment names="Staging,Production"> 

<link rel="stylesheet" href=" https://ajax.aspnetcdn.eom/ajax/bootstrap/3.3.7/css/bootstrap.min.css" 
asp-fallback-href="~/lib/bootstrap/dist/css/bootstrap.min.ess" 

asp-fallback-test-class="sr-only" asp-fallback-test-property="position" asp-fallback-test- 
value="absolute" /> 

<link rel="stylesheet" href="~/css/site.min.css" asp-append-version="true" /> 

</environment> 


Gulp adresinden paketleme liconfig. JSON kullanın 

Uygulamanın paketleme ve küçültmeye yönelik iş akışının ek işlem gerektirdiği durumlar vardır.Örnek görüntü 
iyileştirmesi, önbellek performansı ve CDN varlık işleme sayılabilir. Bu gereksinimleri karşılamak için, paketleme ve 
küçültmeye yönelik iş akışını Gulp kullanacak şekilde dönüştürebilirsiniz. 

Paketleme & minifier uzantısını kullanma 

Visual Studio Paketcisi & minifier uzantısı, Gulp 'e dönüştürmeyi işler. 


NOTE 

Paketleme & minifier uzantısı, Microsoft 'un hiçbir destek sunmamakta olan GitHub ’daki topluluk odaklı bir projeye aittir. 
Sorunlar buradadosyalanmalıdır. 


Çözüm Gezgini paketleme liconfig. JSON dosyasına sağ tıklayın ve paketler & minifier ' ı seçin > Gulp ’e 

Dönüştür...: 


► £T appsettmgs.json 

® bundleconfia.ison 

c* Öpen 




Öpen Wıth... 




Bundler & Minifier 

► 

T 

Update Bundles 


> Task Runner Explorer 


X 

Delete Bundle Output Fileş 


Configure Ettemal Tools... 



Enable bundle on build... 


Publısh bundleconfıg.json 

Alt-*-;, Alt+P 

j 

Produce Output Fileş 


Prevıew changes to bundleconfig.json 

Alt-*-;, Alt+C 

□ 

Convert To Gulp~ 

Replace bundleconfıg.json from server 

Alt-*-;, Alt+R 

O 

Setti ngs... 



Gulpfile.js ve Package. JSON dosyaları projeye eklenir. Package. JSON dosyasının devDependencies bölümünde 
listelenen NPM paketlerinin desteklenmesi yüklüdür. 

Gulp CLı 'yi genel bağımlılık olarak yüklemek için PMC penceresinde aşağıdaki komutu çalıştırın: 



















npm i -g gulp-cli 


Gulpfile.js dosyası, girdiler, çıktılar ve ayarlar için paketleme liconfig. JSON dosyasını okur. 

’use strict'; 

var gulp = require('gulp '), 

concat = require(' gulp-concat' 
cssmin = require('gulp-cssmin'), 
htmlmin = require(’gulp-htmlmin'), 
uglify = require('gulp-uglify'), 
merge = require(’merge-stream '), 
del = require('del '), 

bundleconfig = require('./bundleconfig.json')l 

// Code omitted for brevity 


El ile Dönüştür 

Visual Studio ve/veya paketleme & minifier uzantısı kullanılmıyorsa, el ile dönüştürün. 
Proje köküne aşağıdaki devDependencies sahip bir Package. JSON dosyası ekleyin: 


W ARNING 

gulp-uglify modülü ECMAScript (ES) 201 5/ES6 ve üstünü desteklemez. ES2015/ES6 veya sonraki bir sürümü kullanmak 
için gulp-uglify yerine Gulp-Terser 'i yükler. 


"devDependencies": { 

"del": " A 3.0.0", 

"gulp": " A 4.0.0"j 
"gulp-concat": " A 2.6.1"j 
"gulp-cssmin": " / ' 0 . 2 . 0 ", 

"gulp-htmlmin": " A 3.0.0" J 
"gulp-uglify": " A 3.0.0"j 
"merge-stream": " A 1.0.1" 

} 

Aşağıdaki komutu Package. 750A/ile aynı düzeyde çalıştırarak bağımlılıkları yükler: 

npm i 

Gulp CLı 'y 1 genel bağımlılık olarak yükler: 

npm i -g gulp-cli 


Aşağıdaki gulpfile.js dosyasını proje köküne kopyalayın: 

’use strict'; 

var gulp = require('gulp '), 

concat = require('gulp-concat'), 
cssmin = require('gulp-cssmin'), 
htmlmin = require(’gulp-htmlmin'), 
uglify = require('gulp-uglify '), 
merge = require(’merge-stream'), 
del = renuiref'del'1. 










bundleconfig = require(' ./bundleconfig. json'); 

const regex = { 
css: /\.css$/, 
html: /\.(html|htm)$/, 
js: /\-j s$/ 

}; 


gulp.task('min:js ', async function () { 

merge(getBundles(regex.js).map(bundle => { 

return gulp.src(bundle.inputFiles, { base: }) 

.pipe(concat(bundle.outputFileName)) 

• pipe(ugiifyO) 

•pipe(gulp.dest('.’)); 

})) 

}); 

gulp.task('min:css ’, async function () { 

merge(getBundles(regex.css).map(bundle => { 

return gulp.src(bundle.inputFiles, { base: }) 

.pipe(concat(bundle.outputFileName)) 

.pipe(cssmin()) 

•pipe(gulp.dest('.’)); 

})) 

}); 

gulp.task('min:html ', async function () { 

merge(getBundles(regex.html),map(bundle => { 

return gulp.src(bundle.inputFiles, { base: }) 

.pipe(concat(bundle.outputFileName)) 

.pipe(htmlmin({ collapseklhitespace: true, minifyCSS: true, minifylS: true })) 
•pipe(gulp.dest('.’)); 

})) 

}); 

gulp.task('min', gulp.series([’min:js ', 'min:css'j 'min:html'])); 
gulp.task('clean’, () => { 

return del(bundleconfig.map(bundle => bundle.outputFileName)); 

}); 

gulp.task('watch', () => { 

getBundles(regex.js).forEach( 

bundle => gulp.watch(bundle.inputFileSj gulp.series(["min:js"]))); 
getBundles(regex.css).forEach( 

bundle => gulp.watch(bundle.inputFileSj gulp.series(["min:css"]))); 
getBundles(regex.html),forEach( 

bundle => gulp.watch(bundle.inputFileSj gulp.series(['min:html']))); 

}); 

const getBundles = (regexPattern) => { 

return bundleconfig.filter(bundle => { 

return regexPattern.test(bundle.outputFileName); 

}); 

}; 


gulp.task('default ’, gulp.series("min")); 


Gulp görevlerini Çalıştır 

Proje Visual Studio 'da yapılandırmadan önce Gulp minbirleşme görevini tetiklemek için, *. csproj dosyasına 
aşağıdaki MSBuild hedefini ekleyin: 


cTarget Name="MyPreCompileTarget" BeforeTargets="Build"> 

<Exec Command="gulp min" /> 

</Target> 

Bu örnekte, MyPreCompileTarget hedefi içinde tanımlanan tüm görevler önceden tanımlanmış Buiid hedeften 
önce çalışır. Visual Studio 'nun çıkış penceresinde aşağıdakine benzer bir çıktı görüntülenir: 

1>- Buiid started: Project: BuildBundlerMinifierApp, Configuration: Debug Any CPU - 

l>BuildBundlerMinifierApp -> C:\BuildBundlerMinifierApp\bin\Debug\netcoreapp2.0\BuildBundlerMinifierApp .dil 
1>[14:17:49] Using gulpfile C:\BuildBundlerMinifierApp\gulpfile.js 
1>[14:17:49] Starting 'min:js'... 

1>[14:17:49] Starting ’minıcss'... 

1>[14:17:49] Starting 'min:html'... 

1>[14:17:49] Finished 'min:js' after 83 ms 
1>[14:17:49] Finished 'min:css' after 88 ms 

========== Buiid: 1 succeededj 0 failed, 0 up-to-date, 0 skipped ========== 


Ek kaynaklar 

• Grunt kullanma 

• Birden çok ortam kullanma 

• Etiket Yardımcıları 












ASPNET Core tarayıcı bağlantısı 
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, Nicolö Carandini, Mike, sonve Tom Dykstra tarafından 

Tarayıcı bağlantısı, Visual Studio 'da geliştirme ortamı ile bir veya daha fazla Web tarayıcısı arasında bir iletişim 
kanalı oluşturan bir özelliktir. Tarayıcı bağlantısını, Web uygulamanızı birden çok tarayıcıda tek seferde yenilemek 
için kullanabilirsiniz. Bu, tarayıcılar arası testler için kullanışlıdır. 

Tarayıcı bağlantısı kurulumu 

ASP.NET Core 2,0 projesi ASP.NET Core 2,1 ' e dönüştürülürken ve Microsoft. AspNetCore. app metapackage'e 
geçiş yaparken, brovvserlink İşlevselliği için Microsoft. VisualStudio. Web. brovvserlink paketini yükledikten sonra. 
ASP.NET Core 2,1 proje şablonları varsayılan olarak Microsoft.AspNetcore.App metapaketini kullanır. 

ASP.NET Core 2,0 Web uygulaması, Emptyve Web API proje şablonları, Microsoft. VisualStudio. Web. 
brovvserlinklçin bir paket başvurusu içeren Microsoft, aspnetcore. Ali meta paketinikullanır. Bu nedenle, 

Microsoft.AspNetCore .ah metapackage 'in kullanılması, tarayıcı bağlantısının kullanılabilir olmasını sağlamak için 
başka bir eylem gerektirmez. 

ASP.NET Core 1. x Web uygulaması proje şablonunda, Microsoft. VisualStudio. Web. brovvserlink paketi için bir 
paket başvurusu vardır. Boş veya Web apı şablonu projeleri Microsoft.VisualStudio.web.BrowserLink için bir paket 
başvurusu eklemenizi gerektirir. 

Bu bir Visual Studio özelliği olduğundan, paketi boş veya Web API şablonu projesine eklemenin en kolay yolu, 

Paket Yöneticisi konsolu 'nu açmak ( diğer Windows > Paket Yöneticisi konsolunu>görüntüleyin ) ve şu 

komutu çalıştırmalıdır: 

install-package Microsoft.VisualStudio.Web.BrowserLink 

Alternatif olarak, NuGet Paket Yöneticisi' ni kullanabilirsiniz. Çözüm Gezgini ' de proje adına sağ tıklayın ve 

NuGet Paketlerini Yönet' i seçin: 







Solutıon Explorer 
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Edit BrowserLink.WebApp.csproj 
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r Manage NuGet Packages... 
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Paketi bulun ve yükledikten sonra: 


NuGet Browserlınk.WebApp -0 X 

1 _ • 


Installed Updates 

NuGet Package Manager: BrowserLink.WebApp 

Microsoft.VısualStudıo.Web.Browsertink.Loader 

X • ($ n Indude prerelease Package source: nugetorg ’ 0 




Microsoft.VisualStudio.Web.BrowserLink.Loader by Microsoft 441K downloads 
A middleware that supports creating a communication channel between the development 
environment and one or more web browsers. 


Microsoft.VisualStudio.Web.Brows< 


Version: Latest stable 14.1.0 


(v) Options 


Description 

A middlevvare that supports creating a communication 
channel betvveen the development environment and one or 
more web brovvsers. 

Version: 14.1.0 


Yapılandırma 

startup.configure yönteminde: 

app.UseBrowserLink(); 

Genellikle kod, burada gösterildiği gibi yalnızca geliştirme ortamında tarayıcı bağlantısını sağlayan bir if 
bloğunun içindedir: 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 
app.UseBrowserLink(); 

} 

Daha fazla bilgi için bkz. birden çok ortam kullanma. 


Tarayıcı bağlantısı kullanma 












Bir ASP.NET Core projesi açıkken, Visual Studio hata ayıklama hedefi araç çubuğu denetiminin yanında tarayıcı 
bağlantısı araç çubuğu denetimini gösterir: 


* 

File 
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BrovvserLink - Microsoft Visual Studio 
Edit View Project Build Debug 
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Team Tools Architecture Test R Tools Analyze 


Debug 

-j Any CPU -| 

► IIS Express * EİS 
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Refresh Lınked Brovvsers 

Ctrl+Alt+Enter 

0 

Browser Link Dashboard 


V 

Enable Brovvser Link 


V 

Enable CSS Aııto-Sync 



Window 


Help 


Tarayıcı bağlantısı araç çubuğu denetiminden şunları yapabilirsiniz: 

• Web uygulamasını aynı anda birkaç tarayıcıda yenileyin. 

• Tarayıcı bağlantısı panosunuaçın. 

• Tarayıcı bağlantısımetkinleştirin veya devre dışı bırakın. Note: tarayıcı bağlantısı, Visual Studio 2017 (15,3) 
içinde varsayılan olarak devre dışıdır. 

• CSS otomatik eşitlemesinietkinleştirin veya devre dışı bırakın. 


NOTE 

Bazı Visual Studio eklentileri, en önemlisi Web uzantısı paketi 2015 ve web uzantısı paketi 2017, tarayıcı bağlantısı için 
genişletilmiş işlevsellik sunar, ancak bazı ek özellikler ASP.NET Core projelerle çalışmaz. 


Aynı anda birkaç tarayıcıda Web uygulamasını yenileyin 

Projeyi başlatırken başlatılacak tek bir Web tarayıcısı seçmek için, Hata Ayıkla hedef araç çubuğu denetimindeki 
açılan menüyü kullanın: 
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Web Brovvser (Microsoft Edge) 


Google Chrome 

Brovvse With... 


Internet Explorer 
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Microsoft Edge 


Aynı anda birden çok tarayıcı açmak için, aynı açılan listeden ... öğesine gidin ' i seçin, istediğiniz tarayıcıları 
seçmek için CTRL tuşunu basılı tutarak, ardından da Araştır 1 a tıklayın: 









Toolbox 
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Size of browser window: Default 
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Brovvse Cancel 


Visual Studio 'Yu Açık Dizin görünümü ve iki açık tarayıcıyla gösteren bir ekran görüntüsü aşağıda verilmiştir: 
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ASP.NET Core Windows Linux OSX 


Application uses 


1 Sample pages using ASP.NET Core MVC 
1 Bower for managing client-side libraries 
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<span class="sr-only">Previous</span> 
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<h2>|Application uses</h2> 
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<li>Sample pages using ASP.NET Core MVC</li> 
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Output Package Manager Console Error List 
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Projeye bağlı tarayıcıları görmek için tarayıcı bağlantısı araç çubuğu denetiminin üzerine gelin: 


Solution Explorer Team Explorer Diagnostic Tools Properties 
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Dizin görünümünü değiştirin ve tarayıcı bağlantısı yenileme düğmesine tıkladığınızda tüm bağlı tarayıcılar 
güncelleştirilir: 
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Tarayıcı bağlantısı, Visual Studio dışından başlamış ve uygulama URL 'sine gidebileceğiniz tarayıcılarla de 
kullanılabilir. 

Tarayıcı bağlantısı panosu 

Açık tarayıcılarla bağlantıyı yönetmek için tarayıcı bağlantısı açılan menüsünden tarayıcı bağlantısı panosunu açın: 


Solution Explorer Team Explorer Diagnostic Tools Properties 
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Hiçbir tarayıcı bağlı değilse, Tarayıcıda görüntüle bağlantısını seçerek hata ayıklama olmayan bir oturum 
başlatabilirsiniz: 

BrovvserLinkSample - Microsoft Visual Studio & Quick Launch (Ctrl+Q) fi - n 

File Edit View Project Build Debug Team Tools Test Analyze Window Help Nicolö Carandini ’ 
© - S ■ İl M J * Debug " Any CPU ► IIS Express " C/ ” ÇJ ~ - 



Error List Output Web Publish Activity Package Manager Console 
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Aksi halde, bağlı tarayıcılar her bir tarayıcının gösterdiği sayfanın yoluyla gösterilir: 


Device Log Team Explorer X ^ Properties Team Explorer Solution Explorer 
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isterseniz, bu tek tarayıcıyı yenilemek için listelenen bir tarayıcı adına tıklayabilirsiniz. 

Tarayıcı bağlantısını etkinleştir veya devre dışı bırak 

Tarayıcı bağlantısını devre dışı bıraktıktan sonra yeniden etkinleştirdiğinizde, bunları yeniden bağlamak için 
tarayıcıları yenilemeniz gerekir. 

CSS otomatik eşitlemesini etkinleştir veya devre dışı bırak 

CSS otomatik eşitleme etkinleştirildiğinde, CSS dosyalarında herhangi bir değişiklik yaptığınızda bağlantılı 
tarayıcılar otomatik olarak yenilenir. 

Nasıl çalıştığı 

Tarayıcı bağlantısı, Visual Studio ile tarayıcı arasında bir iletişim kanalı oluşturmak için SignalR kullanır.Tarayıcı 
bağlantısı etkinleştirildiğinde, Visual Studio birden çok istemcinin (tarayıcının) bağlanabileceği bir SignalR 
sunucusu gibi davranır. Tarayıcı bağlantısı ayrıca AS P.N ET Core isteği ardışık düzenine bir ara yazılım bileşeni 
kaydeder. Bu bileşen, sunucudan her sayfa isteğine özel <script> başvurularını çıkarır. Tarayıcıda Görünüm 
kaynağı ' nı seçerek komut dosyası başvurularını görebilir ve <body> Tag içeriğinin sonuna kadar kaydırma 
yapabilirsiniz: 

<!-- Visual Studio Browser Link --> 

<script type="application/json" id="_browserLink_initializationData"> 

("requestld":"a717d5a07cl741949a7cefd6fa2bad08","requestMappingFromServer":false} 

</script> 

<script type="text/javascript" src="http://localhost:54139/b6e36e429d034f578ebccd6a79bfl9bf/browsenLink" 
async="async"x/script> 

<!-- End Browser Link --> 

</body> 


Kaynak dosyalarınız değiştirilmez. Ara yazılım bileşeni, betik başvurularını dinamik olarak çıkarır. 

Tarayıcı tarafı kodu tüm JavaScript olduğundan, tarayıcı eklentisi gerekmeden SignalR desteklediği tüm 
tarayıcılarda çalışıyor olur. 












ASPNET Core oturum ve uygulama durumu 
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By Rick Anderson, Steve Smith, Diana Lagülve Luke Latham 

HTTP durum bilgisiz bir protokoldür. Ek adımlar uygulamadan, HTTP istekleri Kullanıcı değerlerini veya uygulama 
durumunu içermeyen bağımsız iletilerdir. Bu makalede, istekler arasında kullanıcı verilerini ve uygulama 
durumunu korumak için çeşitli yaklaşımlar açıklanmaktadır. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Durum yönetimi 

Durum, çeşitli yaklaşımlar kullanılarak depolanabilir. Her yaklaşım, bu konunun ilerleyen kısımlarında 
açıklanmıştır. 


DEPOLAMA YAKLAŞIMI 

DEPOLAMA MEKANİZMASI 

Çerezler 

HTTP tanımlama bilgileri (sunucu tarafı uygulama kodu 
kullanılarak depolanan veriler içerebilir) 

Oturum durumu 

HTTP tanımlama bilgileri ve sunucu tarafı uygulama kodu 

TempData 

HTTP tanımlama bilgileri veya oturum durumu 

Sorgu dizeleri 

HTTP sorgu dizeleri 

Gizli alanlar 

HTTP form alanları 

HttpContext. Items 

Sunucu tarafı uygulama kodu 

Önbellek 

Sunucu tarafı uygulama kodu 

Bağımlılık Ekleme 

Sunucu tarafı uygulama kodu 


Özgü 

Tanımlama bilgileri istekler arasında veri depolar.Tanımlama bilgileri her istekle birlikte gönderildiğinden, 
boyutları minimum olarak tutulmalıdır, ideal olarak, uygulama tarafından depolanan verileri içeren bir tanımlama 
bilgisinde yalnızca bir tanımlayıcı depolanmalıdır. Tarayıcıların çoğu, tanımlama bilgisi boyutunu 4096 bayt olarak 
kısıtlar. Her etki alanı için yalnızca sınırlı sayıda tanımlama bilgisi vardır. 

Tanımlama bilgileri değişikliklere tabi olduğundan, uygulama tarafından doğrulanması gerekir.Tanımlama bilgileri 
kullanıcılar tarafından silinebilir ve istemciler üzerinde zaman alabilir. Ancak, tanımlama bilgileri genellikle 
istemcide en dayanıklı veri kalıcılığı biçimidir. 

Tanımlama bilgileri genellikle içerik bilinen bir kullanıcı için özelleştirildiğinde kişiselleştirme için kullanılır. 
Kullanıcı yalnızca tanımlı ve kimlik doğrulaması değil çoğu durumda. Tanımlama bilgisi kullanıcının adını, hesap 
adını veya benzersiz kullanıcı KİMLİĞİNİ (GUID gibi) saklayabilir. Daha sonra kullanıcının tercih ettiği Web sitesi 
arka plan rengi gibi kişiselleştirilmiş ayarlarına erişmek için tanımlama bilgisini kullanabilirsiniz. 




Tanımlama bilgilerini verirken ve gizlilik kaygılarıyla ilgilenirken Avrupa Birliği genel veri koruma düzenlemelerine 
(GDPR) sahip olun. Daha fazla bilgi için ASP.NET Core genel veri koruma yönetmeliği (GDPR) desteğiniinceleyin. 

Oturum durumu 

Oturum durumu, Kullanıcı bir Web uygulamasına göz atarken Kullanıcı verilerinin depolanması için bir ASP.NET 
Core senaryodur. Oturum durumu, bir istemciden gelen istekler arasında verileri kalıcı hale getirmek için 
uygulama tarafından tutulan bir depoyu kullanır. Oturum verileri bir önbellek tarafından desteklenir ve geçici veri 
olarak kabul edilir—site oturum verileri olmadan çalışmaya devam etmelidir. Kritik uygulama verileri Kullanıcı 
veritabanında depolanmalıdır ve oturum yalnızca bir performans iyileştirmesi olarak önbelleğe alınmalıdır. 


NOTE 

SignalR uygulamalarında oturum desteklenmiyor, çünkü bir SignalR hub 'ı bir http bağlamından bağımsız olarak 
yürütülemeyebilir. Örneğin, bir uzun yoklama isteği, isteğin HTTP bağlamının ömrü ötesinde bir hub tarafından açık 
tutulduğunda bu durum oluşabilir. 


ASP.NET Core, her istekle birlikte uygulamaya gönderilen oturum KİMLİĞİ içeren istemciye bir tanımlama bilgisi 

sağlayarak oturum durumunu korur. Uygulama, oturum verilerini getirmek için oturum KİMLİĞİNİ kullanır. 

Oturum durumu aşağıdaki davranışları sergiler: 

• Oturum tanımlama bilgisi tarayıcıya özel olduğundan, oturumlar tarayıcılar arasında paylaşılmaz. 

• Tarayıcı oturumu sona erdiğinde oturum tanımlama bilgileri silinir. 

• Kullanım dışı bir oturum için tanımlama bilgisi alınmışsa, aynı oturum tanımlama bilgisini kullanan yeni bir 
oturum oluşturulur. 

• Boş oturumlar korunmaz—oturum, oturum istekleri arasında kalıcı hale getirmek için en az bir değere 
ayarlanmış olmalıdır. Bir oturum tutulmadığı zaman, her yeni istek için yeni bir oturum KİMLİĞİ oluşturulur. 

• Uygulama, son istekten sonra sınırlı bir süre boyunca bir oturum tutar.Uygulama, oturum zaman aşımını 
ayarlar ya da 20 dakikalık varsayılan değeri kullanır. Oturum durumu, belirli bir oturuma özgü kullanıcı 
verilerini depolamak için idealdir, ancak verilerin oturumlarda kalıcı depolama gerektirmez. 

• Oturum verileri, ISession. Clear uygulaması çağrıldığında veya oturumun süresi dolarsa silinir. 

• Uygulama kodunu istemci tarayıcısının kapatıldığını veya istemcide oturum tanımlama bilgisinin silindiği veya 
süresi dolduğunda bilgilendirmeye yönelik varsayılan bir mekanizma yoktur. 

• ASP.NET Core MVC ve Razor sayfaları şablonları, Genel Veri Koruma Yönetmeliği (GDPR) desteğini içerir. 
Oturum durumu tanımlama bilgileri varsayılan olarak temel olarak işaretlenmez, bu nedenle site ziyaretçisi 
tarafından izlemeye izin verilmediği takdirde oturum durumu işlevsel değildir. Daha fazla bilgi için bkz. 
ASP.NET Core Genel Veri Koruma Yönetmeliği (GDPR) desteği. 


VVARNING 

Gizli verileri oturum durumunda depolamayin. Kullanıcı tarayıcıyı Kapatmayabilir ve oturum tanımlama bilgisini temizleyebilir. 
Bazı tarayıcılar tarayıcı pencereleri arasında geçerli oturum tanımlama bilgilerini korur. Bir oturum tek bir kullanıcıyla 
kısıtlanmayabilir—sonraki Kullanıcı aynı oturum tanımlama bilgisiyle uygulamaya gözatmaya devam edebilir. 


Bellek içi önbellek sağlayıcısı, oturum verilerini uygulamanın bulunduğu sunucunun belleğinde depolar.Sunucu 
grubu senaryosunda: 

• Her oturumu tek bir sunucudaki belirli bir uygulama örneğine bağlamak için yapışkan oturumları kullanın. 
Azure App Service , varsayılan olarak yapışkan oturumları zorlamak İçin uygulama isteği yönlendirme (ARR) 
kullanır. Ancak, yapışkan oturumlar ölçeklenebilirliği etkileyebilir ve Web uygulaması güncelleştirmelerini 
karmaşıklaştırır. Daha iyi bir yaklaşım, yapışkan oturum gerektirmeyen bir redya veya SQL Server dağıtılmış 







önbellek kullanmaktır. Daha fazla bilgi için bkz. ASP.NET Core 'de dağıtılmış önbelleğe alma. 

• Oturum tanımlama bilgisi, ıdataprotectoraracılığıyla şifrelenir. Veri koruma, her makinede oturum tanımlama 
bilgilerini okumak için düzgün şekilde yapılandırılmalıdır. Daha fazla bilgi için bkz. ASP.NET Core veri 
koruması ve anahtar depolama sağlayıcıları. 

Oturum durumunu yapılandırma 

Microsoft. AspNetCore. app metapackageiçinde yer alan Microsoft. Aspnetcore. Session paketi, oturum 
durumunu yönetmek için ara yazılım sağlar. Oturum ara yazılımını etkinleştirmek için startup şunları içermelidir: 

• Idistributedönbellek belleği önbellekler. iDistributedCache uygulama, oturum için bir yedekleme deposu 
olarak kullanılır. Daha fazla bilgi için bkz. ASP.NET Core 'de dağıtılmış önbelleğe alma. 

• configureServices 'de Addsession çağrısı. 

• Configure 'de Usesession çağrısı. 

Aşağıdaki kod, bellek içi oturum sağlayıcısının iDistributedCache varsayılan bir bellek içi uygulamasıyla nasıl 
ayarlanacağını gösterir: 

public class Startup 
{ 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDistributedMemoryCache(); 

Services.AddSession(options => 

{ 

// Set a short timeout for easy testing. 
options.IdleTimeout = TimeSpan.FromSeconds(10); 
options.Cookie.HttpOnly = true; 

// Make the session cookie essential 
options.Cookie.IsEssential = true; 

}); 

Services .AddMvc () 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 
app.UseSession(); 

app.UseHttpContextItemsMiddleware(); 
app.UseMvc(); 

} 

} 

Ara yazılım sırası önemlidir.Yukarıdaki örnekte, useMvc sonra useSession çağrıldığında 
invaüdOperationException bir özel durum oluşur. Daha fazla bilgi için bkz. Ara yazılım sıralaması. 

HttpContext. Session , oturum durumu yapılandırıldıktan sonra kullanılabilir. 


usesession çağrılmadan önce HttpContext.Session erişilemez. 










Uygulama yanıt akışına yazmaya başladıktan sonra yeni bir oturum tanımlama bilgisine sahip yeni bir oturum 
oluşturulamıyor. Özel durum Web sunucusu günlüğüne kaydedilir ve tarayıcıda gösterilmez. 

Oturum durumunu zaman uyumsuz olarak yükle 

AS P.N ET Core varsayılan oturum sağlayıcısı, arka plandaki ıdistributedcache 'ten oturum kayıtlarını, yalnızca 
ISession. LoadAsync yöntemi doğrudan TryGetValue, setveya Remove yöntemleriyle önce çağrılırsa zaman 
uyumsuz olarak yükler, ilk olarak LoadAsync çağrılmadıysa, temel alınan oturum kaydı zaman uyumlu olarak 
yüklenir ve bu da ölçekte performans cezası oluşturabilir. 

Uygulamaların bu kalıbı zorunlu kılmak için, LoadAsync yöntemi TryGetValue , set veya Remove önce 
çağrılmıyorsa, Distributedsessionstore ve distributedoturum uygulamalarını bir özel durum oluşturan sürümlerle 
sarın. Sarmalanan sürümleri hizmetler kapsayıcısına kaydedin. 

Oturum seçenekleri 

Oturum varsayılanlarını geçersiz kılmak için SessionOptions' ı kullanın. 

SEÇENEK AÇIKLAMA 


Bilgilerinin Tanımlama bilgisini oluşturmak için kullanılan ayarları belirler. 

Ad varsayılan olarak Sessiondefaults. tanımlama adı ( 

. AspNetcore. Session ) olarak belirlenmiştir. Yol varsayılan 
olarak Sessiondefaults. tarif lepath ( / ) olarak belirlenmiştir. 
SameSite varsayılan olarak samesitemode. Iax ( ı ) olarak 
belirlenmiştir. HttpOnly varsayılan olarak true . IsEssential 
varsayılan olarak false . 


Timeout idleTimeout , oturumun içeriği terk edilmeden önce ne 

kadar süreyle boşta kalabileceğini gösterir. Her oturum erişimi 
zaman aşımını sıfırlar. Bu ayar, tanımlama bilgisi değil yalnızca 
oturumun içeriği için geçerlidir. Varsayılan değer 20 dakikadır. 


lOTİmeout Mağazadan bir oturumu yüklemesine veya depolama alanına 

geri kaydetmeye izin verilen en uzun süre. Bu ayar yalnızca 
zaman uyumsuz işlemlere uygulanabilir. Bu zaman aşımı, 
InfiniteTimeSpankullanılarak devre dışı bırakılabilir. Varsayılan 
değer 1 dakikadır. 


Oturum, tek bir tarayıcıdan gelen istekleri izlemek ve tanımlamak için bir tanımlama bilgisi kullanır.Varsayılan 
olarak, bu tanımlama bilgisinin .AspNetcore.Session adı verilir ve / bir yolu kullanır. Tanımlama bilgisi varsayılan 
olarak bir etki alanı belirtmediğinden, sayfada istemci tarafı komut dosyası için kullanılamaz hale getirilmez ( 
HttpOnly yalnızca true için varsayılan değerdir). 

Tanımlama bilgisi oturum varsayılanlarını geçersiz kılmak için SessionOptions kullanın: 









public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

options.CheckConsentNeeded = context => truej 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 

Services.AddDistributedMemoryCache(); 

Services .AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

Services.AddSession(options => 

{ 

options.Cookie.Name = " .Adventurel/Jorks.Session"; 
options.IdleTimeout = TimeSpan.FromSeconds(10); 
options.Cookie.IsEssential = true; 

}); 

} 

Uygulama, sunucunun önbelleğindeki içeriği terk edilmeden önce bir oturumun ne kadar süreyle boşta 
kalabileceğini anlamak için IdleTimeout özelliğini kullanır. Bu özellik, tanımlama bilgisi bitiş zamanından 
bağımsızdır. Oturum ara yazılımı üzerinden geçen her istek zaman aşımını sıfırlar. 

Oturum durumu kilitlideg\\. iki istek aynı anda bir oturumun içeriğini değiştirmeyi denerseniz, son istek ilk 
geçersiz kılar. Session tutarlı bir oturumolarak uygulanır. Bu, tüm içeriklerin birlikte depolandığı anlamına gelir.iki 
istek farklı oturum değerlerini değiştirmek için arama yaparken, son istek ilk tarafından yapılan oturum 
değişikliklerini geçersiz kılabilir. 

Oturum değerlerini ayarlama ve edinme 

Razor Pages Pagemodel sınıfından ya da HttpContext. Sessionile MVC Denetleyici sınıfından oturum durumuna 
erişilir. Bu özellik bir ISession uygulamasıdır. 

ısession uygulama, tamsayı ve dize değerlerini ayarlamak ve almak için birkaç uzantı yöntemi sağlar. Uzantı 
yöntemleri, proje tarafından Microsoft. AspNetCore. http. Extensions paketine başvurulduğunda Microsoft, 
aspnetcore. http ad alanında (uzantı yöntemlerine erişim kazanmak için bir using Microsoft.AspNetCore.Http; 
bildirisi ekleyin). Her iki paket de Microsoft. AspNetCore. app metapackage'e dahildir. 

ısession uzantısı yöntemleri: 

• Al (ISession, dize) 

• Getınt32 (ISession, dize) 

• GetString (ISession, dize) 

• Setınt32 (ISession, dize, Int32) 

• SetString (ISession, dize, dize) 

Aşağıdaki örnek, bir Razor Pages sayfasındaki indexModei.sessionKeyName anahtarı (örnek uygulamada _Name ) için 
oturum değerini alır: 

@page 

@using Microsoft.AspNetCore.Http 
@model IndexModel 

Name: @HttpContext.Session.GetString(IndexModel.SessionKeyName) 









Aşağıdaki örnek, bir tamsayı ve bir dizenin nasıl ayarlanacağını ve alınacağını gösterir: 


public class IndexModel : PageModel 

{ 

public const string SessionKeyName = "_Name"; 
public const string SessionKeyAge = "_Age"; 
const string SessionKeyTime = "_Time"; 

public string SessionInfo_Name { get; private set; } 
public string SessionInfo_Age { get; private set; } 
public string SessionInfo_CurrentTime { get; private set; } 
public string SessionInfo_SessionTime { get; private set; } 
public string SessionInfo_MiddlewareValue { get; private set; } 

public void OnGet() 

{ 

// Requires: using Microsoft.AspNetCore.Http; 

if (string.IsNullOrEmpty(HttpContext.Session.GetString(SessionKeyName))) 

{ 

HttpContext.Session.SetString(SessionKeyName, "The Doctor"); 
HttpContext.Session.SetInt32(SessionKeyAge, 773); 

} 

var name = HttpContext.Session.GetString(SessionKeyName); 
var age = HttpContext.Session.GetInt32(SessionKeyAge); 


Tüm oturum verileri, bellek içi önbellek kullanılırken bile dağıtılmış önbellek senaryosunu etkinleştirmek üzere 
serileştirilmelidir. En az dize ve numara serileştiricileri sağlanır (bkz. ISession'un yöntemlerine ve genişletme 
yöntemlerine bakın). Karmaşık türler JSON gibi başka bir mekanizma kullanılarak Kullanıcı tarafından 
serileştirilmelidir. 

Seri hale getirilebilir nesneleri ayarlamak ve almak için aşağıdaki uzantı yöntemlerini ekleyin: 

public static class SessionExtensions 

{ 

public static void Set<T>(this ISession session, string key, T value) 

{ 

session.SetString(key, IsonConvert.SerializeObject(value)); 

} 

public static T Get<T>(this ISession session, string key) 

{ 

var value = session.GetString(key); 

return value == null ? default(T) : 

TsonConvert.DeserializeObject<T>(value); 

} 

} 


Aşağıdaki örnek, uzantı yöntemleriyle bir serileştirilebilir nesnenin nasıl ayarlanacağını ve alınacağını gösterir: 

// Requires you add the Set and Get extension method mentioned in the topic. 
if (HttpContext.Session.Get<DateTime>(SessionKeyTime) == default(DateTime)) 

{ 

HttpContext.Session.Set<DateTime>(SessionKeyTime, currentTime); 

} 


TempData 


ASP.NET Core, Razor Pages TempData veya Controller TempDatakullanıma sunar. Bu özellik, verileri başka bir 





istekte okunana kadar depolar. Sakla (dize) ve Peek (dize) yöntemleri, isteğin sonunda silme yapılmadan verileri 
incelemek için kullanılabilir. Keep 0 sözlükte tüm öğeleri bekletme için işaretler. TempData , bir tek istekten daha 
fazla veri gerektiğinde yeniden yönlendirme için özellikle kullanışlıdır. TempData , tanımlama bilgileri veya oturum 
durumu kullanılarak TempData sağlayıcılar tarafından uygulanır. 

TempData örnekleri 

Bir müşteri oluşturan aşağıdaki sayfayı göz önünde bulundurun: 


public class CreateModel : PageModel 

{ 

private readonly RazorPagesContactsContext _context; 

public CreateModel(RazorPagesContactsContext context) 

{ 

_context = context; 

} 

public IActionResult OnGet() 

{ 

return Page(); 

} 

[TempData] 

public string Message { get; set; } 

[BindProperty] 

public Customer Customer { get; set; } 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_context.Customer.Add(Customer); 
await _context.SaveChangesAsync(); 

Message = $"Customer {Customer.Name} added"; 

return RedirectToPage("./IndexPeek"); 

} 

} 

Aşağıdaki sayfada TempData ["Message"] görüntülenir: 

@page 

@model IndexModel 
<hl>Peek Contacts</hl> 

@{ 

if (TempData.Peek("Message") ! = null) 

{ 

<h3>Message: (STempData.Peek("Message")</h3> 

} 

} 

@*Content removed for brevity.*@ 


Önceki biçimlendirmede, isteğin sonunda, Peek kullanıldığından TempData ["Message"] silinmez. Sayfayı 









yenilemek TempData["Message"] görüntüler. 


Aşağıdaki biçimlendirme önceki koda benzerdir, ancak isteğin sonundaki verileri korumak için Keep kullanır: 

@page 

@model IndexModel 
<hl>Contacts Keep</hl> 

@{ 

if (TempData["Message"] != null) 

{ 

<h3>Message: @TempData["Message"]</h3> 

} 

TempData.Keep("Message"); 

} 

@*Content removed for brevity.*@ 

lndexpeek ve ındexkeep sayfaları arasında gezinmek TempData ["Message"] silmez. 

Aşağıdaki kod TempData ["Message"] görüntüler, ancak isteğin sonunda TempData["Message"] silinir: 

@page 

@model IndexModel 

<hl>Index no Keep or Peek</hl> 

@{ 

if (TempData["Message"] != null) 

{ 

<h3>Message: @TempData["Message"]</h3> 

} 

} 

@*Content removed for brevity.*@ 

TempData sağlayıcıları 

Tanımlama bilgisi tabanlı TempData sağlayıcısı, TempData 'ı tanımlama bilgilerinde depolamak için varsayılan 
olarak kullanılır. 

Tanımlama bilgisi verileri, Base64UrlTextEncoderile kodlanan ve sonra öbekli ıdataprotectorkullanılarak şifrelenir. 
Tanımlama bilgisi öbekli olduğundan, ASP.N ET Core 1. x içinde bulunan tek tanımlama bilgisi boyut sınırı 
uygulanmaz. Şifreli verileri sıkıştırmak, suç ve ihlal saldırıları gibi güvenlik sorunlarına yol açacağından, tanımlama 
bilgisi verileri sıkıştırılmaz. Tanımlama bilgisi tabanlı TempData sağlayıcısı hakkında daha fazla bilgi için bkz. 
tanımlama, letempdataprovider. 

Bir TempData sağlayıcısı seçin 

Bir TempData sağlayıcısı seçmek şöyle bazı hususlar içerir: 

1. Uygulama oturum durumunu zaten kullanıyor mu? Bu durumda, oturum durumu, TempData Provider ’ın 
kullanılması uygulamaya ek bir ücret vermez (verilerin boyutundan itibaren). 

2. Uygulama yalnızca görece küçük miktarlarda veri (500 bayta kadar) için TempData kullanıyor mu? Bu 
durumda, bir tanımlama bilgisi TempData Provider, TempData kullanan her isteğe küçük bir maliyet ekler. Aksi 
takdirde, oturum durumu TempData Provider, Geçicimiz veri tüketilene kadar her istekte büyük miktarda veri 
dönüşü olmaması yararlı olabilir. 

3. Uygulama, birden çok sunucuda bir sunucu grubunda mi çalışıyor? Bu durumda, veri koruma dışındaki 
tanımlama bilgisi TempData sağlayıcısını kullanmak için ek yapılandırma gerekmez (bkz. ASP.NET Core veri 










koruması ve anahtar depolama sağlayıcıları). 


NOTE 

Çoğu Web istemcisi (Web tarayıcıları gibi), her tanımlama bilgisinin en büyük boyutu, toplam tanımlama bilgisi sayısı veya 
her ikisi için sınır uygular. Bu tanımlama bilgisi TempData sağlayıcısını kullanırken, uygulamanın bu sınırları aşmadığını 
doğrulayın. Verilerin toplam boyutunu göz önünde bulundurun. Şifreleme ve parçalama nedeniyle tanımlama bilgisi 
boyutundaki artışlar için hesap. 


TempData sağlayıcısını yapılandırma 

Tanımlama bilgisi tabanlı TempData sağlayıcısı varsayılan olarak etkindir. 

Oturum tabanlı TempData sağlayıcısını etkinleştirmek için Addsessionstatetempdataprovider genişletme 
yöntemini kullanın: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

options.CheckConsentNeeded = context => truej 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 

Services.AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2) 

.AddSessionStateTempDataProvider(); 

Services.AddSession(); 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopmentO) 

{ 

app.UseDeveloperExceptionPage(); 
app.UseDatabaseErrorPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 
app.UseCookiePolicy(); 
app.UseSession(); 
app.UseMvc(); 

} 

Ara yazılım sırası önemlidir.Yukarıdaki örnekte, useMvc sonra useSession çağrıldığında 
invaiidOperationException bir özel durum oluşur. Daha fazla bilgi için bkz. Ara yazılım sıralaması. 


IMPORTANT 

.NET Framevvork hedefleme ve oturum tabanlı TempData sağlayıcısını kullanıyorsanız, Microsoft. AspNetCore. Session 
paketini projeye ekleyin. 


Sorgu dizeleri 










Yeni isteğin sorgu dizesine eklenerek sınırlı miktarda veri, bir istekten diğerine geçirilebilir. Bu durum, gömülü 
durum ile bağlantıların e-posta veya sosyal ağlar aracılığıyla paylaşılmasını sağlamak için durumu kalıcı bir şekilde 
yakalamak için yararlıdır. URL sorgu dizeleri ortak olduğundan, gizli veriler için hiçbir şekilde Sorgu dizelerini 
kullanmayın. 

Sorgu dizelerindeki veriler de dahil olmak üzere, istenmeyen paylaşıma ek olarak, siteler arası İstek forgery 
(CSRF) saldırıları için fırsat oluşturabilir ve bu da kullanıcıların kimliği doğrulandığında kötü amaçlı siteleri ziyaret 
etmesini sağlayabilir. Saldırganlar daha sonra Kullanıcı verilerini uygulamadan çalabilir veya Kullanıcı adına kötü 
amaçlı eylemler gerçekleştirebilir. Korunan uygulamaların veya oturum durumunun CSRF saldırılarına karşı 
korunması gerekir. Daha fazla bilgi için bkz. siteler arası İstek forgery (XSRF/CSRF) saldırılarını önleme. 

Gizli alanlar 

Veriler gizli form alanlarına kaydedilebilir ve sonraki istek üzerine geri gönderilebilir. Bu çok sayfalı formlarda 
yaygındır, istemci verilerle oynayabilir olabileceğinden, uygulamanın gizli alanlarda depolanan verileri her zaman 
yeniden doğrulaması gerekir. 

HttpContext. Items 

HttpContext. Items koleksiyonu, tek bir isteği işlerken verileri depolamak için kullanılır. Koleksiyon içeriği bir istek 
işlendikten sonra atılır. ıtems koleksiyonu, genellikle bir istek sırasında farklı noktalarda çalıştıklarında ve 
parametreleri geçirmek için doğrudan bir yol olmadığında bileşenlerin veya ara yazılımların iletişim kurmasına 
izin vermek için kullanılır. 

Aşağıdaki örnekte, Ara yazılım ıtems koleksiyonuna isverified ekler. 

app.Use(async (context, next) => 

{ 

// perform some verification 
context.Items["isVerified"] = true; 
await next.Invoke(); 

}); 

Ardışık düzen daha sonra, başka bir ara yazılım isverified değerine erişebilir: 

app.Run(async (context) => 

{ 

await context.Response.WriteAsync($"Verified: {context.Items["isverified"]}"); 

})J 

Yalnızca tek bir uygulama tarafından kullanılan ara yazılım için string anahtarları kabul edilebilir. Uygulama 
örnekleri arasında paylaşılan ara yazılım, anahtar çakışmalarını önlemek için benzersiz nesne anahtarları 
kullanmalıdır. Aşağıdaki örnek, bir ara yazılım sınıfında tanımlanan benzersiz bir nesne anahtarının nasıl 
kullanılacağını gösterir: 








public class HttpContextItemsMiddleware 

{ 

private readonly RequestDelegate _next; 

public static readonly object HttpContextItemsMiddlewareKey = new Object(); 

public HttpContextItemsMiddleware(RequestDelegate next) 

{ 

_next = next; 

} 

public async Task Invoke(HttpContext httpContext) 

{ 

httpContext.Items[HttpContextItemsMiddlewareKey] = "K-9"; 
await _next(httpContext); 

} 

} 

public static class HttpContextItemsMiddlewareExtensions 

{ 

public static IApplicationBuilder 

UseHttpContextItemsMiddleware(this IApplicationBuilder builder) 

{ 

return builder.UseMiddleware<HttpContextItemsMiddleware>(); 

} 

} 

Diğer kod, ara yazılım sınıfı tarafından kullanıma sunulan anahtar kullanılarak HttpContext.ıtems içinde 
depolanan değere erişebilir: 

HttpContext.Items 

.TryGetValue(HttpContextItemsMiddleware.HttpContextItemsMiddlewareKeyj 
out var middleiA/areSetValue); 

SessionInfo_MiddlewareValue = 

middlewareSetValue?.ToString() ?? "Middleware value not seti"; 


Bu yaklaşım ayrıca koddaki anahtar dizelerinin kullanımını ortadan kaldırma avantajına sahiptir. 

Önbellek 

Önbelleğe alma, verileri depolamak ve almak için etkili bir yoldur. Uygulama, önbelleğe alınmış öğelerin ömrünü 
denetleyebilir. 

Önbelleğe alınan veriler belirli bir istek, Kullanıcı veya oturumla ilişkili değildir. Diğer kullanıcıların istekleri 
tarafından alınabilecek kullanıcıya özgü verileri önbelleğe alma konusunda dikkatli olun. 

Daha fazla bilgi için bkz. AS P.N ET Core 'de yanıt önbelleğe alma. 

Bağımlılık Ekleme 

Verilerin tüm kullanıcılar tarafından kullanılabilmesini sağlamak için bağımlılık ekleme 'yi kullanın: 

1. Verileri içeren bir hizmet tanımlayın. Örneğin, MyAppData adlı bir sınıf tanımlanmıştır: 

public class MyAppData 

{ 

// Declare properties and methods 

} 







2. Hizmet sınıfım Startup.ConfigureServices ekleyin: 


public void ConfigureServices(IServiceCollection Services) 
{ 

Services .AddSingleton<MyAppData>(); 

} 

3. Veri hizmeti sınıfını tüketme: 


public class IndexModel : PageModel 
{ 

public IndexModel(MyAppData myService) 

{ 

// Do something with the service 

// Examples: Read data, store in a field or property 

} 


Sık karşılaşılan hatalar 

• Microsoft. AspNetCore. Session. DistributedSessionStore ' etkinleştirilmeye çalışılırken 1 Microsoft. 
Extensions. Caching. Distributed. ıdistributedcache ' türü için hizmet çözümlenemiyor." 

Bunun nedeni genellikle en az bir iDistributedCache uygulamasını yapılandırma başarısız olmuştur. Daha 
fazla bilgi için bkz. ASP.NET Core 'de dağıtılmış önbelleğe alma ve ASP.NET Core 'de önbellek belleği. 

• Oturum ara yazılımı bir oturumu kalıcı hale getiremediğinde (örneğin, yedekleme deposu 
kullanılamıyorsa), ara yazılım özel durumu günlüğe kaydeder ve istek normal olarak devam eder. Bu, 
öngörülemeyen davranışa yol açar. 

Örneğin, bir Kullanıcı bir alışveriş sepetini oturum içinde depolar. Kullanıcı sepete bir öğe ekler, ancak kayıt 
başarısız olur. Uygulama hata hakkında bilgi sahibi değildir, bu nedenle bu, doğru olmayan, kullanıcıya 
öğenin sepetine eklendiğini bildirir. 

Hataları denetlemek için önerilen yaklaşım, uygulama oturuma yazma işlemi tamamlandığında uygulama 
kodundan await feature.Session.commitAsync(); çağırmalıdır. yedekleme deposu kullanılamıyorsa 
commitAsync bir özel durum oluşturur. commitAsync başarısız olursa, uygulama özel durumu işleyebilir. 
LoadAsync , veri deposunun kullanılamadığı koşulların altında oluşturulur. 

SignalR ve oturum durumu 

SignalR uygulamalar, bilgileri depolamak için oturum durumunu kullanmamalıdır. SignalR uygulamalar, hub 'da 
context.ıtems her bağlantı durumunu depolayabilirler. 

Ek kaynaklar 

Web çiftliğinde AS P.N ET Core ana bilgisayar 








ASPNET Core düzen 
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Steve Smith ve bave Brock tarafından 

Sayfalar ve görünümler genellikle görsel ve programlı öğeleri paylaşır. Bu makalede nasıl 
yapılacağı gösterilmektedir: 

• Ortak düzenleri kullanın. 

• Komutları paylaşma. 

• Sayfaları veya görünümleri işlemeden önce ortak kodu çalıştırın. 

Bu belgede, ASP.NET Core MVC: Razor Pages ve denetleyicilerin görünümleriyle olan iki farklı 
yaklaşım için düzenler açıklanmaktadır. Bu konu için, farklar en az: 

• Razor Pages, Sayfalar klasöründedir. 

• Görünümleri olan denetleyiciler görünümler için bir Görünümler klasörü kullanır. 

Düzen nedir? 

Çoğu Web uygulaması, bir sayfadan sayfaya gezindikleri sürece kullanıcıya tutarlı bir deneyim 
sağlayan ortak bir düzene sahiptir. Düzen genellikle uygulama üstbilgisi, gezinti veya menü 
öğeleri ve alt bilgi gibi ortak kullanıcı arabirimi öğelerini içerir. 


Header 


Footer 




Betikler ve stil sayfaları gibi ortak HTM L yapıları de bir uygulama içindeki birçok sayfa tarafından 
sık kullanılır. Bu paylaşılan öğelerin tümü, bir Düzen dosyasında tanımlanabilir ve bu daha sonra 
uygulama içinde kullanılan herhangi bir görünüm tarafından başvurulabilirler. Düzenler 
görünümlerde yinelenen kodu azaltır. 

Kurala göre, bir AS P.N ET Core uygulamasının varsayılan düzeni _Layout. cshtm/olarak 
adlandırılır. Şablonlarla oluşturulan yeni ASP.NET Core projelerine yönelik düzen dosyaları 
şunlardır: 

• Razor Pages: sayfa/paylaşılan/_Layout. cshtml 
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Pages 

A Shared 

di _CookieConsentPartial.cshtml 
d _Layout.cshtml 
d _ValidationScriptsPartial.cshtml 
d _Viewlmports.cshtml 
d _ViewStart.cshtml 

• Görünümler içeren denetleyici: views/Shared/_Layout. cshtml 

* £1 Vievvs 

Home 

A Shared 

d _CookieConsentPartial.cshtml 
d _Layout.cshtml 
d _ValidationScriptsPartial.cshtml 
d Error.cshtml 
d _Viewlmports.cshtml 
d _ViewStart.cshtml 

Düzen, uygulamadaki görünümler için üst düzey bir şablon tanımlar. Uygulamalar bir düzen 
gerektirmez. Uygulamalar, farklı düzenleri belirleyen farklı görünümlerle birden fazla düzen 
tanımlayabilir. 

Aşağıdaki kod, bir şablon tarafından oluşturulan ve bir denetleyici ve görünümleri olan bir proje 
için Düzen dosyasını gösterir: 

<!DOCTYPE html> 

<html> 

<head> 

<meta charset="utf-8" /> 

<meta name="viewport" content="width=device-width, initial-scale=1.0" /> 
<title>@ViewData["Title"] - WebApplicationl</title> 

<environment include="Development"> 

<link rel="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.css" /> 

<link rel="stylesheet" href="~/css/site.css" /> 

</environment> 

<environment exclude="Development"> 
clink rel="stylesheet" 

href=" https://ajax.aspnetcdn.eom/ajax/bootstrap/3.3.7/css/bootstrap.min.es s" 
asp-fallback-href="~/lib/bootstrap/dist/css/bootstrap.min.css" 
asp-fallback-test-class="sr-only" asp-fallback-test-property="position" asp- 
fallback-test-value="absolute" /> 

<link rel="stylesheet" href="~/css/site.min.css" asp-append-version="true" /> 
</environment> 

</head> 

<body> 

<nav class="navbar navbar-inverse navbar-fixed-top"> 

<div class="container"> 

<div class="navbar-header"> 

<button type="button" class="navbar-toggle" data-toggle="collapse" data- 
target=".navbar-collapse"> 

<span class="sr-only">Toggle navigation</span> 

<span class="icon-bar"x/span> 

<span class="icon-bar"x/span> 

<span class="icon-bar"x/span> 

</button> 
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</div> 

<div class="navbar-collapse collapse"> 

<ul class="nav navban-nav"> 

<lixa asp-page="/Index">Home</a></li> 

<lixa asp-page="/About">About</ax/li> 

<lixa asp-page="/Contact">Contact</ax/li> 

</ul> 

</div> 

</div> 

</nav> 

<partial name="_CookieConsentPartial" /> 

<div class="container body-content"> 

@RenderBody() 

<hr /> 

<footen> 

<p>&copy; 2018 - WebApplicationl</p> 

</footer> 

</div> 

<environment include="Development"> 

<script src="~/lib/jquery/dlst/jquery. js"x/script> 

<script src="~/lib/bootstrap/dist/js/bootstrap.js"x/script> 

<script src="~/js/slte.js" asp-append-version="true"x/script> 

</environment> 

<environment exclude="Development"> 

<script src="https://a jax.aspnetcdn.com/ajax/jquery/jquery-3. 3.l.min.js" 
asp-fallback-src="~/llb/jquery/dist/jquery.min.js" 
asp-fallback-test="window.jQuery" 
crossorigin="anonymous" 

İntegrity="sha384- 

tsQFqpEReu7ZLhBV2VZlAu7zcOV+rXbYlF2cqB8txI/8aZajjp4Bqd+V6D5IgvKT"> 

</script> 

<script src= "https://ajax.aspnetcdn.eom/ajax/bootstrap/3.3.7/bootstrap.min.js" 
asp-fallback-src="~/lib/bootstrap/dist/js/bootstrap.min.js" 
asp-fallback-test="window.jQuery && window.jQuery.fn && 
window.jQuery.fn.modal" 

crossorigin="anonymous" 

İntegrity="sha384- 

Tc5IQİb027qvyjSMfHjOMaLkfuWVxZxUPnC3A712mCWNIpG9mGCD8wGNIcPD7Txa"> 

</script> 

<script src="~/js/site.min.js" asp-append-version="true"x/script> 
</environment> 

@RenderSection("Scripts", required: false) 

</body> 

</html> 


Düzen belirtme 

Razor görünümlerinin Layout bir özelliği vardır. Bireysel görünümler bu özelliği ayarlayarak bir 
düzen belirtir: 

Layout = "_Layout"; 

} 

Belirtilen Düzen tam yol (örneğin, /Pages/Shared/_Layout. cshtmlveya /views/Shared/_Layout. 
cshtml) ya da kısmi bir ad kullanabilir (örnek: _Layout ). Kısmi bir ad sağlandığında, Razor 
görüntüleme altyapısı, kendi standart bulma işlemini kullanarak düzen dosyasını arar. Önce 
işleyici yönteminin (veya denetleyicinin) bulunduğu klasör, sonra paylaşılan klasör tarafından 





aranır. Bu bulma işlemi, kısmi görünümleribulmak için kullanılan işlemle aynıdır. 

Varsayılan olarak, her düzen RenderBody çağırmalıdır. RenderBody çağrısının yerleştirildiği her 
yerde, görünümün içerikleri işlenir. 

Bölümler 

Bir düzen, RenderSection çağırarak, isteğe bağlı olarak bir veya daha fazla bö/ümebaşvurabilir. 
Bölümler, belirli sayfa öğelerinin yerleştirilmesi gereken yerleri düzenlemek için bir yol sağlar. Her 
RenderSection çağrısı, bu bölümün gerekli veya isteğe bağlı olup olmadığını belirtebilir: 

<script type="text/javascript" src="~/scripts/global.js"x/script> 

@RenderSection("Scripts", required: false) 


Gerekli bir bölüm bulunamazsa, bir özel durum oluşturulur.Tek görünümler, @section Razor söz 
dizimi kullanarak bir bölüm içinde işlenecek içeriği belirtir. Bir sayfa veya görünüm bir bölümü 
tanımlıyorsa, oluşturulması gerekir (veya bir hata oluşur). 



uygulamadaki diğer sayfalar veya görünümler bu betiği gerektirmeyebilir ve betikler bölümü 
tanımlamaz. 


Aşağıdaki biçimlendirme _ValidationScriptsPartial. cshtmlöğes\r\'\ İşlemek İçin kısmi etiket 
yardımcısını kullanır: 

@section Scripts { 

<partial name="_ValidationScriptsPartial" /> 

} 

Önceki biçimlendirme, Yapı İskelesi kimliğitarafından oluşturulmuştur. 

Bir sayfada veya görünümde tanımlanan bölümler yalnızca kendi düzen sayfasında kullanılabilir. 
Parçalardan başvurulamaz, bileşenleri veya görünüm sisteminin diğer kısımlarını bunlara 
başvuramaz. 

Bölümler yoksayılıyor 

Varsayılan olarak, içerik sayfasındaki gövde ve tüm bölümler Düzen sayfası tarafından 
işlenmelidir. Razor görünümü altyapısı, gövdenin ve her bölümün işlenip işlenmeyeceğini 
izleyerek bunu zorlar. 

Görünüm altyapısına gövde veya bölümleri yok saymasını bildirmek için ignoreBody ve 
ignoreSection yöntemlerini çağırın. 

Bir Razor sayfasındaki gövde ve her bölüm işlenen ya da yoksayıldı olmalıdır. 

Paylaşılan yönergeler içeri aktarılıyor 

Görünümler ve sayfalar, ad alanlarını içeri aktarmak vebağımlılık ekleme'yi kullanmak için Razor 
yönergeleri kullanabilir. Birçok görünüm tarafından paylaşılan yönergeler, ortak bir _Viewlmports. 



















cshtml dosyasında belirtilebilir. _viewimports dosyası aşağıdaki yönergeleri destekler: 


• @addTagHelper 

• @removeTagHelper 

• @tagHelperPrefix 


@using 


@model 


@inherits 

@inject 



Dosya, işlevler ve bölüm tanımları gibi diğer Razor özelliklerini desteklemez. 

Örnek bir _viewimports.cshtml dosyası: 

@using WebApplicationl 

@using WebApplicationl.Models 

@using WebApplicationl.Models.AccountViewModels 

@using WebApplicationl.Models.ManageViewModels 

@using Microsoft.AspNetCore.Identity 

(ŞaddTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 

ASP.NET Core MVC uygulamasının _Viewlmports. cshtml dosyası genellikle Sayfalar (veya 
Görünümler) klasörüne yerleştirilir.Bir _Viewlmports. cshtml dosyası herhangi bir klasöre 
yerleştirilebilir, bu durumda yalnızca söz konusu klasör ve alt klasörleri içindeki sayfalara veya 
görünümlere uygulanacaktır. _viewimports dosyalar, kök düzeyinden başlayarak işlenir ve sonra 
her bir klasör için sayfanın konumu veya görünümü görüntülenir, kök düzeyinde belirtilen 
_viewimports ayarları klasör düzeyinde geçersiz kılınabilir. 

Örneğin, şunu varsayın: 

• Kök düzeyi _VieWİmportS. cshtml dosyası @model MyModell ve @addTagHelper MyTagHelperl 
içerir. 

• Bir alt klas0r_ Vievvlmports. cshtml dosyası @model MyModel2 ve @addTagHelper MyTagHelper2 
içerir. 

Alt klasördeki sayfaların ve görünümlerin her ikisi de etiket yardımcılarını ve MyModei2 modeli 
erişimine sahip olur. 

Dosya hiyerarşisinde birden çok_Viewlmports. cshtml dosyası bulunursa, yönergelerin 
birleştirilmiş davranışı şunlardır: 

• @addTagHelper , (ŞremoveTagHelper : tüm çalıştırma, sırasıyla 

• @tagHeiperPrefix : en yakın bir görünüm, diğerlerini geçersiz kılar 

• @modei : en yakın bir görünüm, diğerlerini geçersiz kılar 

• @inherits : en yakın bir görünüm, diğerlerini geçersiz kılar 

• @using : tümü dahildir; yinelemeler yoksayıldı 

• @inject : her bir özellik için, görünümün en yakın olanı aynı özellik adına sahip diğerlerini 
geçersiz kılar 

Her görünümden önce kod çalıştırma 

Her görünüm veya sayfadan önce çalıştırılması gereken kod_ ViewStart. cshtml dosyasına 
yerleştirilmelidir. Kurala göre,_ ViewStart. cshtml dosyası Sayfalar (veya Görünümler) klasöründe 
bulunur. _ViewStart. cshtml 'de listelenen deyimler her tam görünüm (düzen değil ve kısmi 

















görünümler değil) öncesinde çalıştırılır. Vievvvvimports. cshtmlgibi_WeıvSforf. cshtml de 
hiyerarşiktir. Görünüm veya sayfalar klasöründe bir _ ViewStart. cshtml dosyası tanımlanmışsa, 
Sayfalar (veya Görünümler) klasörünün kökünde (varsa) tanımlandıktan sonra çalıştırılır. 

Örnek bir _ViewStart. cshtml dosyası: 

Layout = "_Layout"; 

} 

Yukarıdaki dosya tüm görünümlerin _Layout. cshtml mizanpajını kullanacağı belirtir. 

_VlewStart. cshtml ve _Viewlmports. cshtml genellikle /Pages/Shared (veya /views/Shared) 
klasörüne yerleştirilmez . Bu dosyaların uygulama düzeyi sürümleri doğrudan /Pages (veya 
/vlews) klasörüne yerleştirilmelidir. 
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Tarafından Rick Anderson, Luke Latham, Taylor Mullen, ve Dan Vicarel 

Razor kod sunucu tabanlı Web sayfalarını eklemek için bir biçimlendirme sözdizimi aşağıdaki gibidir. 
Razor işaretlemesi Razor sözdizimini oluşur C#ve HTML. Razor genellikle içeren dosyalarınız bir 
.cshtml dosya uzantısı. Razor, Razor bileşenleri dosyalarında (. Razor) de bulunur. 

HTML işleme 

HTML varsayılan Razor dilidir.HTML Razor işaretlemesi işleme bir HTML dosyasından HTML'yi 
işlemeye değerinden farklı değildir. HTM L biçimlendirmede .cshtml Razor dosyaları değiştirilmemiş 
sunucu tarafından işlenir. 

Razor söz dizimi 

Razor destekler C# ve kullandığı @ HTM L geçiş sembolünden C#. Razor değerlendirir C# ifadeleri ve 
bunları HTML çıktısında oluşturur. 

Olduğunda bir @ sembol tarafından izlenen bir Razor ayrılmış anahtar sözcüğü, Razor özgü 
biçimlendirme geçer. Aksi takdirde düz geçiş C#. 

Kaçış için bir @ sembol Razor işaretlemede, ikinci bir kullanın @ sembol: 

<p>@@Username</p> 

Kodunu HTML ile tek bir işlenen @ sembol: 

<p>@Username</p> 

Olmayan HTML öznitelikleri ve e-posta adreslerini içeren bir içerik işleme @ geçiş karakter olarak 
sembol. Aşağıdaki örnekte e-posta adresleri tarafından Razor ayrıştırma olduğu: 

<a href="mailto:Support@contoso.com">Support@contoso.com</a> 


Örtük Razor ifadeleri 

Örtük Razor ifadeleri ile başlayıp @ ardından C# kod: 

<p>@DateTime.Now</p> 

<p>@DateTime.IsLeapYear(2016)</p> 

Dışında C# await anahtar sözcüğü, örtük ifadeleri boşluk içermemelidir. Varsa C# deyimi açık bir bitiş 
sahipse, boşluk intermingled: 

<p>@await DoSomethingC'hello", "world")</p> 












Örtük ifade olamaz içeren C# köşeli ayraçlar içindeki karakterler olarak genel türler ( <> ) bir HTML 
etiketi yorumlanır. Aşağıdaki kod değil geçerli: 

<p>@GenericMethod<int>()</p> 

Yukarıdaki kod, aşağıdakilerden birini benzer bir derleyici hatası oluşturur: 

• "int" öğesi kapalı değildi. Tüm öğeleri olmalıdır kendi kendine kapanan veya eşleşen bir bitiş etiketi 
sahip. 

• Yöntem grubu 'object' türü temsilci GenericMethod' dönüştürülemiyor. Bir yöntemi çağırmak mı 
istiyordunuz?' 

Genel yöntem çağrılarını sarmalanmış, içinde bir Razor açık ifadesi veya Razor kodu bloğu. 

Açık Razor ifadeleri 

Açık Razor ifadeleri oluşur bir @ dengeli parantez ile simge. Geçen haftaki zaman işlemek için 
aşağıdaki Razor işaretlemesi kullanılır: 

<p>Last week this time: @(DateTime.Now - TimeSpan.FromDays(7))</p> 

içinde herhangi bir içerik @() parantez değerlendirilir ve işlenen çıkışı. 

Önceki bölümde açıklanan, örtük ifadeleri genellikle boşluk içeremez. Aşağıdaki kodda, bir hafta, geçerli 
saatten çıkarılabilir değil: 

<p>Last week: @DateTime.Now - TimeSpan.FromDays(7)</p> 

Kod aşağıdaki HTML'yi oluşturur: 

<p>Last week: 7/7/2016 4:39:52 PM - TimeSpan.FromDays(7)</p> 


Açık ifadeler, metin bir ifadenin sonucu ile birleştirmek için kullanılabilir: 



Açık bir ifade olarak yazılırken <p>Age33</p> işlenir. 

Açık ifadeleri, genel yöntemleri gelen çıkış işleme için kullanılabilir .cshtml dosyaları. Aşağıdaki 
biçimlendirmede gösterilen hatayı düzeltmek gösterilmektedir köşeli parantez önceki neden bir C# 
genel. Kodu açık bir ifade olarak yazılır: 

<p>@(GenericMethod<int>())</p> 


İfade kodlama 


C#HTML kodlu bir dizeye değerlendirilen ifadeleri var.C#değerlendirmek için ifadeleri iHtmicontent 











doğrudan aracılığıyla işlenir iHtmicontent.uriteTo . C#Değerlendirme yok ifadeleri mtmicontent 
tarafından bir dizeye dönüştürülür Tostring ve bunlar işlenen önce kodlanır. 

@("<span>Hello World</span>") 

Kod aşağıdaki HTML'yi oluşturur: 

&lt;span&gt;Hello World&lt;/span&gt; 

HTML tarayıcı gösterilir: 

<span>Hello World</span> 

HtmiHeiper.Raw Çıktı kodlanmış değildir, ancak geri HTML biçimlendirmesi olarak çizilir. 

VVARNING 

Kullanarak HtmlHelper.Raw unsanitized kullanıcı girişi bir güvenlik riski oluşturur. Kullanıcı girişi, kötü amaçlı 
JavaScript veya diğer saldırılara içerebilir. Kullanıcı girişi temizlenirken zordur. Kullanmaktan kaçının 
HtmlHeiper. Raw kullanıcı girişi ile. 

@Html.Raw("<span>Hello World</span>") 

Kod aşağıdaki HTML'yi oluşturur: 

<span>Hello World</span> 


Razor kodu bloğu 

Razor kod blokları kullanmaya başlama @ ve tarafından alınmış {}. ifadeler, aksine C# olmayan kod 
blokları içinde kod çizilir. Kod blokları ve ifadeler bir görünümdeki aynı kapsamı paylaşan ve sırayla 
tanımlanır: 


var quote = "The future depends on what you do today. - Mahatma Gandhi"; 

} 

<p>@quote</p> 

quote = "Hate cannot drive out hate, only love can do that. - Martin Luther Ring, ir."; 

} 

<p>@quote</p> 


Kod aşağıdaki HTML'yi oluşturur: 

<p>The future depends on what you do today. - Mahatma Gandhi</p> 

<p>Hate cannot drive out hate, only love can do that. - Martin Luther Ring, 3r.</p> 


Kod blokları' nda, şablon oluşturma yöntemleri olarak kullanılacak biçimlendirme ile yerel işlevler 














bildirin: 


void RenderName(string name) 

{ 

<p>Name: <strong>@name</strongx/p> 

} 

RenderName("Mahatma Gandhi"); 
RenderName("Martin Luther King, Tr."); 


Kod aşağıdaki HTML'yi oluşturur: 

<p>Name: <strong>Mahatma Gandhi</stnongx/p> 

<p>Name: <strong>Martin Luther King, Zlr.</strongx/p> 


Örtük geçişleri 

Bir kod bloğu varsayılan dilde C#, ancak Razor sayfası HTML olarak geçiş yapabilir: 

@{ 

var inCSharp = true; 

<p>Now in HTML, was in C# @inCSharp</p> 

} 

Açık ayrılmış geçiş 

HTML oluşturması gereken bir kod bloğunun alt bölümünü tanımlamak için, karakterleri Razor <text> 
etiketiyle çevreleyin: 

@for (var i = 0; i < people.Lengthj i++) 

{ 

var person = people[i]; 

<text>Name: @person.Name</text> 

} 

Tarafından HTML etiketleri arasına olmayan HTML oluşturmak için bu yaklaşımı kullanın. Bir HTML 
veya Razor etiket olmadan, bir Razor çalışma zamanı hatası oluşur. 

<text> etiketi, içerik işlerken boşluğu denetlemek için yararlıdır: 

• Yalnızca <text> etiketi arasındaki içerik işlenir. 

• HTML çıktısında <text> etiketi görüntülenmeden önce veya sonra boşluk yok. 

Açık satır geçişi 

Tüm satırın geri kalanını bir kod bloğu içinde HTML olarak işlemek için söz dizimini kullanın: 

@for (var i = 0; i < people.Lengthj i++) 

{ 

var person = people[i]; 

@:Name: @person.Name 

} 

Olmadan kodda bir Razor çalışma zamanı hatası oluşturulur. 

Razor dosyasındaki ek @ karakterler, bloktaki daha sonra bulunan deyimlerde derleyici hatalarına 












neden olabilir. Bu derleyici hataları önce bildirilen hatayı gerçek bir hata oluştuğu için anlamak zor 
olabilir. Bu hata, tek bir kod bloğunun birden çok örtük/açık ifadelere birleştirdikten sonra yaygındır. 


Denetim yapıları 

Denetim yapıları kod bloğu bir uzantı var. Kod blokları tüm yönlerini (biçimlendirme, satır içi geçiş C#) 
aşağıdaki yapılar için de geçerlidir: 

Conditionals, else if, Else ve @Switch @ 

@if kod çalıştığında denetimleri: 

@if (value % 2 == 0) 

{ 

<p>The value was even.</p> 

} 


else ve else if gerektirmeyen @ sembol: 


@if (value % 2 == 0) 

{ 

<p>The value was even.</p> 

} 

else if (value >= 1337) 

{ 


<p>The value is large.</p> 

} 

else 


{ 

<p>The value is odd and small.</p> 

} 


Aşağıdaki biçimlendirme svvitch deyimi kullanma işlemini gösterir: 

@switch (value) 

{ 

case 1: 

<p>The value is l!</p> 
break; 
case 1337: 

<p>Youn number is 1337!</p> 
break; 
default: 

<p>Youn number wasn't 1 or 1337.</p> 
break; 


İçin döngü @foreach, @sırasında ve @do 

Şablonlu HTML denetim ifadeleri döngü ile oluşturulabilir. Kişi listesini oluşturmak için: 

@{ 

var people = new Person[] 

{ 


new Person("Weston", 33), 
new Person("3ohnathon", 41), 




Aşağıdaki döngü deyimi desteklenir: 


@for 


@for (var i = 0; i < people.Length; i++) 

{ 

var person = people[i]; 

<p>Name: @person.Name</p> 

<p>Age: @person.Age</p> 

} 


@foreach 


@foreach (var person in people) 

{ 

<p>Name: @person.Name</p> 
<p>Age: @person.Age</p> 

} 


@while 


@{ var i = 0; } 

@while (i < people.Length) 

{ 

var person = people[i]; 
<p>Name: @person.Name</p> 
<p>Age: @person.Age</p> 

i++; 

} 


@do while 

@{ var i = 0 ; } 

@do 

{ 

var person = people[i]; 
<p>Name: @person.Name</p> 
<p>Age: @person.Age</p> 

i++; 

} while (i < people.Length); 


Kullanarak bileşik @ 

içinde C#, using deyimi, bir nesne kullanıldığında emin olmak için kullanılır. Razor aynı mekanizmayı 
ek içeriklere sahip bir HTML Yardımcıları oluşturmak için kullanılır. Aşağıdaki kodda, HTML Yardımcıları 
@using ifadesiyle bir <form> etiketi işlerler: 

@using (Html.BeginForm()) 

{ 

<div> 

Email: cinput type="email" id="Email" value=""> 

<button>Register</button> 

</div> 

} 


@TRY, catch, finally 




Özel durum işleme benzer C#: 


@try 

{ 

throw new InvalidOperationException("You did something invalid."); 

} 

catch (Exception ex) 

{ 


<p>The exception message: @ex.Message</p> 

} 

finally 

{ 


<p>The finally statement.</p> 

} 


@ kilidi 

Razor kilit deyimleri kritik bölümlerle korumanın yeteneğine sahiptir: 


@lock (SomeLock) 

{ 

// Do critical section work 

} 


Açıklamalar 

Razor destekler C# ve HTML yorumlarında: 

@{ 

/* C# comment */ 

// Another C# comment 

} 

<!-- HTML comment --> 

Kod aşağıdaki HTML'yi oluşturur: 

<!-- HTML comment --> 

Web sayfası işlenmeden önce razor açıklama sunucu tarafından kaldırılır. Razor kullanan @* *@ 
açıklamaları sınırlandırmak için. Sunucu tüm biçimlendirme işlemesi yapmıyor için aşağıdaki kodu, 
geçersiz kılınan: 

@* 

@{ 

/* C# comment */ 

// Another C# comment 

} 

<!-- HTML comment --> 


Yönergeler 

Razor yönergesi örtük ayrılmış anahtar sözcükler aşağıdaki deyimlerle tarafından temsil edilir @ 
simgesi. Bir yönergesi, genellikle bir görünüm ayrıştırılır veya farklı bir işlevsellik sağlar şeklini değiştirir. 

Razor kod görünümü nasıl oluşturur? anlama yönergeleri nasıl çalıştığını anlamak kolaylaştırır. 









@{ 

var quote = "Getting old ain't for wimps! - Anonymous"; 

} 

<div>Quote of the Day: @quote</div> 

Kod aşağıdaki gibi bir sınıf oluşturur: 

public class _Views_Something_cshtml : RazorPage<dynamic> 

{ 

public override async Task ExecuteAsync() 

{ 

var output = "Getting old ain't for wimps! - Anonymous"; 

WriteLiteral("/r/n<div>Quote of the Day: "); 

Write(output); 

WriteLiteral("</div>"); 

} 

} 

Bölümü bu makalenin ilerleyen bölümlerinde Razor İnceleme C# bir görünümü için oluşturulan sınıf bu 
oluşturulan sınıf görüntülemek açıklanmaktadır. 

@özniteliği 

@attribute yönergesi, verilen özniteliği oluşturulan sayfanın veya görünümün sınıfına ekler. Aşağıdaki 
örnek [Authorize] özniteliğini ekler: 

@attribute [Authorize] 

@kodu 

Bu senaryo yalnızca Razor bileşenleri (. Razor) için geçerlidir. 

@code bloğu bir Razor bileşeninin bir bileşene üye ( C# alanlar, Özellikler ve Yöntemler) eklemesini 
sağlar: 

@code { 

// C# members (fields, properties, and methods) 

} 

Razor bileşenleri için, @code @functions diğer adı @functions üzerinde önerilir. Birden fazla @code 
bloğu izin verilir. 

@işlevleri 

@functions yönergesi, oluşturulan sınıfa C# üye (alanlar, Özellikler ve Yöntemler) eklemeyi sağlar: 
@functions { 

// C# members (fields, properties, and methods) 

} 

Razor bileşenlerinde, üye eklemek C# için @functions üzerinde @code kullanın. 

Örneğin: 















(Şfunctions { 

public string GetHello() 

{ 

return "Hello"; 

} 

} 

<div>From method: @GetHello()</div> 


Kod aşağıdaki HTML biçimlendirmeyi oluşturur: 

<div>From method: Hello</div> 


Aşağıdaki kodu oluşturulmuş Razor olan C# sınıfı: 

using System.Threading.Tasks; 
using Microsoft.AspNetCore.Mvc.Razor; 

public class _Views_Home_Test_cshtml : RazorPage<dynamic> 

{ 

// Functions placed between here 
public string GetHello() 

{ 

return "Hello"; 

} 

// And here. 

#pragma warning disable 1998 

public override async Task ExecuteAsync() 

{ 

WriteLiteral("\r\n<div>From method: "); 

Write(GetHello()); 

WriteLiteral("</div>\r\n"); 

} 

#pragma warning restore 1998 

@functions Yöntemler, biçimlendirme olduğunda şablon oluşturma yöntemleri olarak görev yapar: 

@{ 

RenderName("Mahatma Gandhi"); 

RenderName("Martin Luther King, İr."); 

} 

@functions { 

private void RenderName(string name) 

{ 

<p>Name: <strong>@name</strongx/p> 

} 

} 


Kod aşağıdaki HTML'yi oluşturur: 

<p>Name: <strong>Mahatma Gandhi</strongx/p> 

<p>Name: <strong>Martin Luther King, lr.</strongx/p> 


@ uygular 

@impiements yönergesi, oluşturulan sınıf için bir arabirim uygular. 

Aşağıdaki örnek, Dispose yönteminin çağrılabilmesi için System.IDİsposable uygular: 




@implements IDisposable 
<hl>Example</hl> 

(Şfunctions { 

private bool _isDisposed; 

public void Dispose() => _isDisposed = true; 

} 


@devralır 

@inherits Yönergesi görünümü devralan sınıf tam denetim sağlar: 

@inherits TypeNameOfClassTolnheritFrom 


Aşağıdaki kod bir özel bir Razor sayfası türüdür: 

using Microsoft.AspNetCore.Mvc.Razor; 

public abstract class CustomRazorPage<TModel> : RazorPage<TModel> 

{ 

public string CustomText { get; } = 

"Gardyloo! - A Scottish warning yelled from a window before dutnping" + 
"a slop bucket on the Street below."; 


customText Bir görünümde görüntülenir: 

@inherits CustomRazorPage<TModel> 
<div>Custom text: @CustomText</div> 


Kod aşağıdaki HTML'yi oluşturur: 


<div> 

Custom text: Gardyloo! - A Scottish warning yelled from 
a slop bucket on the Street below. 

</div> 

a window before dumping 

@model ve @inherits 

görünümü alır dosyas 

aynı görünümde kullanılabilir. 

ı: 

(Şinherits 

kullanılabilir bir _viewımports.cshtml 

@inherits CustomRazorPage<TModel> 


Aşağıdaki kod, kesin türü belirtilmiş görünüm örneğidir: 

@inherits CustomRazorPage<TModel> 

<div>The Login Email: @Model.Email</div> 

<div>Custom text: @CustomText</div> 


Varsa "rick@contoso.com" geçirilen modeldeki görünümünü aşağıdaki HTML biçimlendirmeyi 











oluşturur: 


<div>The Login Email: rick@contoso.com</div> 

<div> 

Custom text: Gardyloo! - A Scottish warning yelled from a window before dumping 
a slop bucket on the Street below. 

</div> 

@ekleme 

@inject Yönergesi sağlayan bir hizmet eklemesine Razor sayfası hizmet kapsayıcı bir görünümde. 

Daha fazla bilgi için görünümlere bağımlılık ekleme. 

@düzeni 

Bu senaryo yalnızca Razor bileşenleri (. Razor) için geçerlidir. 

@iayout yönergesi Razor bileşeninin bir yerleşimini belirtir. Düzen bileşenleri kod yinelemeyi ve 
tutarsızlığın önüne geçmek için kullanılır. Daha fazla bilgi için bkz. ASP.NET Core Blazor düzenleri. 

@modeli 

Bu senaryo yalnızca MVC görünümleri ve Razor Pages (. cshtml) için geçerlidir. 

@modei yönergesi, bir görünüme veya sayfaya geçirilen modelin türünü belirtir: 

@model TypeNameOfModel 

Bir ASP.NET Core MVC veya bireysel kullanıcı hesaplarıyla oluşturulan Razor Pages uygulama, 
Görünümler/Account/Login. cshtml aşağıdaki model bildirimini içerir: 

@model LoginViewModel 

Oluşturulan sınıf devraldığı RazorPage<dynamic> : 

public class _Views_Account_Login_cshtml : RazorPage<LoginViewModel> 

Razor sunan bir Model modeli erişmek için özelliği geçirilen görünümü: 

<div>The Login Email: @Model.Email</div> 

@modei yönergesi Model özelliğinin türünü belirtir. Yönergesi belirtir t içinde RazorPage<T> 
türetildiği görünümü oluşturulan, sınıfın. Varsa @modei yönergesi belirtilmediyse, Model özelliği 
türüdür dynamic . Daha fazla bilgi için bkz. türü kesin belirlenmiş modeller ve @model anahtar sözcüğü. 

@ad alanı 

@namespace yönergesi: 

• Oluşturulan Razor sayfası, MVC görünümü veya Razor bileşeni sınıfının ad alanını ayarlar. 

• Bir sayfa, görünüm veya bileşen sınıfının kök türetilmiş ad alanlarını dizin ağacındaki en yakın içeri 
aktarmalar dosyasından, _Viewimports. cshtml (görünümler veya sayfalar) veya _lmports. Razor 
(Razor bileşenleri) olarak ayarlar. 

@namespace Your.Mamespace.Here 






















Aşağıdaki tabloda gösterilen Razor Pages örneği için: 

• Her sayfa sayfaları/_Viewlmports. cshtml'yı içeri aktarır. 

• Pages/_ViewlmportS. cshtml @namespace Hello.World içerir. 

• Her sayfa, ad alanının kökü olarak Hello.worid sahiptir. 

SAYFA AD ALANI 

Pages/lndex. cshtml Hello.world 

Sayfa/fazla sayfa/sayfa, cshtml Hello. world.MorePages 

Pages/te Pages/Evente Pages/Page. cshtml Hello.World.MorePages. EvenMorePages 

Yukarıdaki ilişkiler, MVC görünümleri ve Razor bileşenleriyle kullanılan dosyaları içeri aktarmak için 
geçerlidir. 

Birden çok içeri aktarma dosyası @namespace yönergesine sahip olduğunda, kök ad alanını ayarlamak 
için dizin ağacındaki sayfaya, görünüme veya bileşene en yakın dosya kullanılır. 

Yukarıdaki örnekteki evente Pages klasörünün @namespace Another.Planet bir içeri aktarmalar dosyası 
varsa (veya sayfa/değer sayfaları/Evente Pages/Page. cshtml dosyası @namespace Another.Planet 
içeriyorsa), sonuç aşağıdaki tabloda gösterilmiştir. 


SAYFA 


AD ALANI 


Pages/lndex. cshtml 


Hello.World 


Sayfa/fazla sayfa/sayfa, cshtml 


Hello.Worİd.MorePages 


Pages/te Pages/Evente Pages/Page. cshtml 


Another.Planet 


@sayfası 

@page yönergesinin göründüğü dosyanın türüne bağlı olarak farklı etkileri vardır. Yönergesi: 

• içindeki bir. cshtml dosyasında, dosyanın bir Razor sayfası olduğunu gösterir. Daha fazla bilgi için 
bkz. özel rotalar ve AS P.N ET Core Razor Pages giriş. 

• Bir Razor bileşeninin istekleri doğrudan işlemesini belirtir. Daha fazla bilgi için bkz. ASP.NET Core 
Blazor yönlendirme. 

Bir. cshtml dosyasının ilk satırındaki @page yönergesi, dosyanın bir Razor sayfası olduğunu gösterir. 
Daha fazla bilgi için bkz. AS P.N ET Core Razor Pages giriş. 

@bölümü 

Bu senaryo yalnızca MVC görünümleri ve Razor Pages (. cshtml) için geçerlidir. 

@section yönergesi, görünümler veya sayfaların HTML sayfasının farklı bölümlerinde içerik işlemesini 
sağlamak için MVC ve Razor Pages düzenleriyle birlikte kullanılır. Daha fazla bilgi için bkz. ASP.NET 
Core düzen. 

kullanarak @ 

@using Yönergesi ekler C# using yönerge oluşturulmuş görünümü için: 




















@using System.10 
@{ 

var dir = Directory.GetCurrentDirectoryO; 

} 

<p>@din</p> 

Razor bileşenlerinde @using Ayrıca hangi bileşenlerin kapsamda olduğunu denetler. 

Yönerge öznitelikleri 

@öznitelikleri 

Bu senaryo yalnızca Razor bileşenleri (. Razor) için geçerlidir. 

@attributes , bir bileşenin bildirilmeyen öznitelikleri işlemesini sağlar. Daha fazla bilgi için bkz. 

ASP.NET Core Razor bileşenleri oluşturma ve kullanma. 

@bağlama 

Bu senaryo yalnızca Razor bileşenleri (. Razor) için geçerlidir. 

Bileşenlerdeki veri bağlama @bind özniteliğiyle gerçekleştirilir. Daha fazla bilgi için bkz. AS P.N ET Core 
Razor bileşenleri oluşturma ve kullanma. 

{EVENT} üzerinde @ 

Bu senaryo yalnızca Razor bileşenleri (. Razor) için geçerlidir. 

Razor, bileşenler için olay işleme özellikleri sağlar. Daha fazla bilgi için bkz. ASP.NET Core Razor 
bileşenleri oluşturma ve kullanma. 

{EVENThp reventDefault @ 

Bu senaryo yalnızca Razor bileşenleri (. Razor) için geçerlidir. 

Olay için varsayılan eylemi engeller. 

{EVENT} üzerinde Stopyayma 

Bu senaryo yalnızca Razor bileşenleri (. Razor) için geçerlidir. 

Olay için olay yaymayı sonlandırır. 

@anahtarı 

Bu senaryo yalnızca Razor bileşenleri (. Razor) için geçerlidir. 

@key Directive özniteliği, bileşenlerin, anahtar değerine göre öğelerin veya bileşenlerin korunmasını 
güvence altına almasına neden olur. Daha fazla bilgi için bkz. ASP.NET Core Razor bileşenleri 
oluşturma ve kullanma. 

@ref 

Bu senaryo yalnızca Razor bileşenleri (. Razor) için geçerlidir. 

Bileşen başvuruları ( @ref ) bir bileşen örneğine başvurmak için bir yol sağlar, böylece bu örneğe komut 
verebilirsiniz. Daha fazla bilgi için bkz. ASP.NET Core Razor bileşenleri oluşturma ve kullanma. 

@typeparam 

Bu senaryo yalnızca Razor bileşenleri (. Razor) için geçerlidir. 

@typeparam yönergesi, oluşturulan bileşen sınıfı için genel bir tür parametresi bildirir. Daha fazla bilgi 
için bkz. ASP.NET Core Razor bileşenleri oluşturma ve kullanma. 







Şablonlu Razor temsilciler 

Razor şablonları aşağıdaki biçimde bir kullanıcı Arabirimi parçacığı tanımlamanıza izin ver: 

@<tag>...</tag> 


Aşağıdaki örnekte, şablonlu Razor temsilci olarak belirtmek verilmektedir bir Func<T,TResult>. 
Dinamik tür temsilci kapsülleyen yönteminin parametresi için belirtilir. Bir nesne türü temsilcinin dönüş 
değeri olarak belirtilir. Şablon ile kullanılan bir List<T> , Pet olan bir Name özelliği. 


public class Pet 
{ 

public string Name { get; set; } 

} 


Func<dynamic, object> petTemplate = @<p>You have a pet named <strong>@item.Name</strong>.</p>; 

var pets = new List<Pet> 

{ 

new Pet { Name = "Rin Tin Tin" }, 
new Pet { Name = "Mr. Bigglesworth" }, 
new Pet { Name = "K-9" } 

}; 


Şablon ile işlenen pets tarafından sağlanan bir foreach deyimi: 


@foreach (var pet in pets) 
{ 

@petTemplate(pet) 

} 


İşlenmiş çıkışı: 


<p>You have a pet named <strong>Rin Tin Tin</strong>.</p> 
<p>You have a pet named <strong>Mr. Bigglesworth</strong>.</p> 
<p>You have a pet named <strong>K-9</strong>.</p> 


Bir yöntem bağımsız değişkeni olarak bir satır içi Razor şablonu da sağlayabilirsiniz. Aşağıdaki örnekte, 
Repeat yöntem Razor şablonu alır.Yöntemi, HTML içerik ile sağlanan bir listeden öğeleri yineler 
üretmek için şablonu kullanır: 











@using Microsoft.AspNetCore.Html 
@functions { 

public static IHtmlContent Repeat(IEnumerable<dynamic> items, int times, 
Func<dynamic, IHtmlContent> template) 

{ 

var html = new HtmlContentBuilder(); 

foreach (var item in items) 

{ 

for (var i = 0; i < times; i++) 

{ 

html.AppendHtml(template(item)); 

} 

} 

return html; 

} 

} 

Önceki örnekte, Evcil Hayvanlar listesi kullanarak Repeat yöntemi çağrıldığında: 

• List<T > ' ın Pet . 

• Her evcil hayvan yineleme sayısı. 

• Satır içi şablon sırasız bir listesini liste öğeleri için kullanın. 


<ul> 

@Repeat(pets, 3 , @<li>@item.Name</li>) 
</ul> 

İşlenmiş çıkışı: 

<ul> 

<li>Rin Tin Tin</li> 

<li>Rin Tin Tin</li> 

<li>Rin Tin Tin</li> 

<li>Mr. Bigglesworth</li> 

<li>Mr. Bigglesworth</li> 

<li>Mr. Bigglesworth</li> 

<li>K-9</li> 

<li>K-9</li> 

<li>K-9</li> 

</ul> 


Etiket Yardımcıları 

Bu senaryo yalnızca MVC görünümleri ve Razor Pages (. cshtml) için geçerlidir. 
ilgili üç yönergeleri vardır etiket Yardımcıları. 

YÖNERGESİ İŞLEV 

ıŞaddTagHelper Etiket Yardımcıları bir görünüm için kullanılabilir hale 

getirir. 


(ŞlremoveTagHelper 


Daha önce bir görünümden eklenen etiket Yardımcıları 
kaldırır. 










YÖNERGESİ 


İŞLEV 


@tagHelperPrefix Etiket Yardımcısı desteğinin etkinleştirmek ve etiket 

Yardımcısı kullanım açık hale getirmek için bir etiket 
öneki belirtir. 


Razor ayrılmış anahtar sözcükler 

Razor anahtar sözcükleri 

• sayfa (ASP.NET Core 2,1 veya üzeri bir sürüm gerektirir) 

• ad alanı 

• işlevleri 

• Devralan 

• {1>model<1} 

• section 

• yardımcı (şu anda AS P.N ET Core tarafından desteklenmez) 

Razor anahtar sözcükleri kaçış ile @(Razor Keyword) (örneğin, @(functions) ). 

C#Razor anahtar sözcükleri 

• büyük/küçük harf 

• do 

• (1 >default< 1} 

• for 

• foreach 

• if 

• else 

• lock 

• anahtarı 

• deneyin 

• Yakalama 

• finally 

• kullanma 

• while 

C#Razor anahtar sözcükleri çift kaçış ile olmalıdır @(@c# Razor Keyword) (örneğin, @(@case) ). ilk @ 
Razor ayrıştırıcısı atlar. İkinci @ çıkışları C# ayrıştırıcı. 

Razor tarafından kullanılmayan ayrılmış anahtar sözcükler 

• sınıf 

Razor İnceleme C# bir görünümü için oluşturulan sınıfı 

.NET Core SDK'sını 2.1 veya daha sonra Razor SDK derleme Razor dosyaları işler.Bir proje derlenirken 
Razor SDK'sı oluşturur bir obj/< buUd_configuration > / < target_framework_moniker >/Razor 
proje kök dizini. Dizin yapısında Razor dizini proje dizin yapısına yansıtır. 

.NET Core 2.1 hedefleyen ASP.NET Core 2.1 Razor sayfaları projesinde aşağıdaki dizin yapısını göz 
önünde bulundurun: 


• Alanlar/ 






o Yönetim / 
o Sayfa / 

o lndex.cshtml 
o lndex.cshtml.cs 

• Sayfa / 

o Paylaşılan / 

o _Layout.cshtml 
o _Viewımports.cshtml 
o _ViewStart.cshtml 
o lndex.cshtml 
o lndex.cshtml.cs 

Projenin oluşturulmasında hata ayıklama yapılandırma aşağıdaki verir obj dizini: 

• obj/ 

o Hata ayıklama / 
o netcoreapp2.1 / 
o Razor/ 
o Alanlar/ 
o Yönetim / 
o Sayfa / 

o lndex.g.cshtml.cs 
o Sayfa / 

o Paylaşılan / 

o _Layout.g.cshtml.cs 
o _Viewlmports.g.cshtml.cs 
o _ViewStart.g.cshtml.cs 
o lndex.g.cshtml.cs 

Oluşturulan sınıf için görüntülenecek Pages/lndex.cshtmlaçr\ 
obj/Debug/netcoreapp2.1/Razor/Pages/tndex.g.cshtml.cs. 

Aşağıdaki sınıf, ASP.NET Core MVC projeye ekleyin: 

using Microsoft.AspNetCore.Mvc.Razor.Extensions; 
using Microsoft.AspNetCore.Razor.Language; 

public class CustomTemplateEngine : MvcRazorTemplateEngine 
{ 

public CustomTemplateEngine(RazorEngine engine, RazorProject project) 

: base(engine, project) 

{ 

} 

public override RazorCSharpDocument GenerateCode(RazorCodeDocument codeDocument) 
{ 

var csharpDocument = base.GenerateCode(codeDocument); 
var generatedCode = csharpDocument.GeneratedCode; 

// Look at generatedCode 

return csharpDocument; 

} 

} 



İçinde startup.configureServices , geçersiz kılma 
CustomTemplateEngine Sinifi: 

public void ConfigureServices(IServiceCollection Services) 

{ 

services.AddMvc(); 

Services.AddSingleton<RazorTemplateEngine, CustomTemplateEngine>(); 

} 


RazorTemplateEngine ile MVC tarafından eklenen 


Bir kesme noktası ayarlamak return csharpOocument; deyiminin CustomTemplateEngine . Program 
yürütme kesme noktasında durduğunda değerini görüntülemek generatedcode . 


Text Visualizer 


□ X 


bcpression: 


generatedcode 


Value: 

public override async Task ExecuteAsync() 

{ 

#line 1 "/Views/Home/Contact3.cshtml” 

var output = "Hello World”; 

#line default 
#line hidden 

BeginContext(40, 15, true); 
WriteLiteral(”\r\n<div>Output: "); 
EndContext(); 

BeginContext(56, 6, false); 

#line 5 "/Views/Home/Contact3.cshtml” 
Write(output); 

#line default 
#line hidden 

EndContext()j 

BeginContext(62, 6, true); 
WriteLiteral(”</div>”); 

EndContext(); 

} 

#pragma warning restore 1998 


□ Wrap 


Close 


Help 


Görünüm aramaları ve büyük/küçük harfe duyarlılık 

Razor görüntüleme motorunu büyük küçük harfe duyarlı aramalar, görünümler için gerçekleştirir. 

Ancak, gerçek arama, temel alınan dosya sistemi tarafından belirlenir: 

• Dosya tabanlı kaynağı: 

o Büyük küçük harfe duyarlı dosya sistemleri (örneğin, VVİndovvs) ile işletim sistemlerinde, 
fiziksel dosya sağlayıcısı aramaları büyük küçük harfe duyarlı. Örneğin, return view(”Test") 
eşleşmelerini sonuçlanıyor /Views/Home/Test.cshtml, /Vlews/home/test.cshtm /ve diğer 
büyük/küçük harf değişken. 

o Büyük küçük harfe duyarlı dosya sistemlerindeki (örneğin, Linux, OSX ile 

EmbeddedFileProvider ), büyük küçük harfe duyarlı aramalar.Örneğin, return view("Test") 
özellikle eşleşen /Views/Home/Test.cshtml. 

• Görünümleri önceden derlenmiş: ASP.NET Core 2.0 ve sonraki sürümleri, önceden derlenmiş 
görünümleri arama büyük/küçük harf tüm işletim sistemlerinde büyük harflere duyarlı değildir. 
Davranış VVİndovvs fiziksel dosya Sağlayıcısının davranış aynıdır.Önceden derlenmiş iki görünüm 
yalnızca durumda farklıysa, arama sonucu belirleyici değildir. 

Geliştiriciler, dosya ve dizin adlarını büyük küçük harfleri büyük/küçük harf eşleşmesi için önerilir: 




























• Alan, denetleyici ve eylem adları. 

• Razor sayfalan. 

Eşleşen servis talebi, temel alınan dosya sisteminden bağımsız olarak kendi görünümler dağıtımları Bul 
sağlar. 



ASRNET Core 'de Razor Sınıf Kitaplığı projesini 
kullanarak yeniden kullanılabilir kullanıcı arabirimi 
oluşturma 
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Rick Anderson tarafından 

Razor görünümleri, sayfalar, denetleyiciler, sayfa modelleri, Razor bileşenleri, Görünüm bileşenlerive veri 
modelleri Razor sınıf kitaplığı 'nda (RCL) yerleşik olarak bulunabilir. RCL paketlenebilir ve yeniden 
kullanılabilir. Uygulamalar RCL 'yi içerebilir ve içerdiği görünümleri ve sayfaları geçersiz kılabilir.Hem Web 
uygulamasında hem de RCL 'de bir görünüm, kısmi görünüm veya Razor sayfası bulunduğunda, Web 
uygulamasındaki Razor biçimlendirmesi (. cshtml dosyası) önceliklidir. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Razor Kullanıcı arabirimi içeren bir sınıf kitaplığı oluşturma 

• Visuai Studio 

• .NET Core CLI 

• Visuai Studio 'dan Yeni bir proje oluştur' u seçin. 

• Razor sınıfı kitaplığı > İleri ' yiseçin. 

• Kitaplığı adlandırın (örneğin, "RazorCIassLib"), > Oluştur. Oluşturulan görünüm kitaplığıyla bir dosya adı 
çarpışmasını önlemek için, kitaplık adının ,views ' da bitmediğinden emin olun. 

• Görünümleri desteketmeniz gerekiyorsa destek sayfaları ve görünümleri 1 ni seçin. Varsayılan olarak 
yalnızca Razor Pages desteklenir. Oluştur' u seçin. 

Razor sınıf kitaplığı (RCL) şablonu varsayılan olarak Razor bileşen geliştirmeyi varsayılan olarak belirler. 
Destek sayfaları ve görünümleri seçeneği sayfaları ve görünümleri destekler. 

RCL 'ye Razor dosyaları ekleyin. 

ASP.NET Core şablonları RCL içeriğinin Areas klasöründe olduğunu varsayar. ~/Areas/Pages yerine ~/Pages 
içeriği kullanıma sunan bir RCL oluşturmak için RCL Pages düzenine bakın. 

RCL içeriğine başvur 

RCL 'ye şu şekilde başvurulabilir: 

• NuGet paketi. Bkz. NuGet paketleri oluşturma ve DotNet paket ekleme ve bir NuGet paketi oluşturma ve 
yayımlama. 

• {ProjectName}. csproj. Bkz. DotNet-başvuru Ekle. 

Görünümleri, kısmi görünümleri ve sayfaları geçersiz kıl 

Hem Web uygulamasında hem de RCL 'de bir görünüm, kısmi görünüm veya Razor sayfası bulunduğunda, 
Web uygulamasındaki Razor biçimlendirmesi (. cshtml dosyası) önceliklidir.Örneğin, 

VVebAppl/Areas/MyFeature/Pages/Sayfal. cshtml öğesini VVebAppl öğesine ekleyin ve VVebAppl içindeki 
Sayfal, RCL 'deki Sayfal 'e göre öncelikli olur. 









Örnek indirme içinde WebAppl/Areas/MyFeature2 öğesini WebAppl/Areas/myfeature olarak yeniden 
adlandırın ve test önceliğini belirtin. 

RazorUIClassLib/Areas/myfeature/Pages/Shared/_Message. cshtml kısmi görünümünü 
WebAppl/Areas/Myfeature/Pages/Shared/_Message. cshtml'ye kopyalayın. Biçimlendirmeyi yeni konumu 
belirtecek şekilde güncelleştirin. Uygulamanın kısmi sürümünün kullanılmakta olduğunu doğrulamak için 
uygulamayı derleyin ve çalıştırın. 

RCL sayfaları düzeni 

RCL içeriğine, Web uygulamasının Sayfalar klasörünün bir parçası olmasına rağmen başvurmak için, 
aşağıdaki dosya yapısıyla RCL projesini oluşturun: 

• RazorUlClassLib/sayfalar 

• RazorUlClassLib/sayfalar/paylaşılan 

RazorUlClassLib/Pages/Shared iki kısmi dosya \çer\r._header. cshtml \/e_footer. cshtml. <partiai> Etiketler 
_Layout. cshtml dosyasına eklenebilir: 

<body> 

<partial name="_Header"> 

@RenderBody() 

<partial name="_Footer"> 

</body> 


Statik varlıklar içeren bir RCL oluşturma 

RCL, RCL 'nin tüketen uygulaması tarafından başvurulabilen, yardımcı statik varlıklar gerektirebilir.ASP.NET 
Core, tüketen bir uygulama tarafından kullanılabilen statik varlıkları içeren RCLs oluşturulmasına izin verir. 

Yardımcı varlıkları RCL 'nin bir parçası olarak dahil etmek için, sınıf kitaplığında bir Wwwroot klasörü 
oluşturun ve gerekli dosyaları bu klasöre ekleyin. 

RCL 'yi paketleyerek, Wwwroot klasöründeki tüm yardımcı varlıklar pakete otomatik olarak eklenir. 

Statik varlıkları hariç tut 

Statik varlıkları dışlamak için, istenen dışlama yolunu proje dosyasındaki $(DefauitıtemExciudes) özellik 
grubuna ekleyin. Girişleri noktalı virgülle ayırın ( ; ). 

Aşağıdaki örnekte, Wwwroot klasöründeki lib. css stil sayfası statik bir varlık olarak değerlendirilmez ve 
yayımlanan RCL 'ye dahil değildir: 

<PropertyGroup> 

<DefaultItemExcludes>$(DefaultItemExcludes);wwwroot\lib.css</DefaultItemExcludes> 

</PropertyGroup> 

TypeScript tümleştirmesi 

TypeScript dosyalarını RCL 'ye eklemek için: 

1. TypeScript dosyalarını (. TS) Wwwroot klasörünün dışına yerleştirin. Örneğin, dosyaları bir istemci 
klasörüne yerleştirin. 

2. Wwwroot klasörü için TypeScript derleme çıkışını yapılandırın. Proje dosyasında bir PropertyGroup 
içinde TypescriptoutDir özelliğini ayarlayın: 

<TypescriptOutDir>wwwroot</TypescriptOutDir> 









3. Proje dosyasında bir PropertyGroup içine aşağıdaki hedefi ekleyerek TypeScript hedefini 
ResoiveCurrentProjectstaticiAiebAssets hedefinin bir bağımlılığı olarak ekleyin: 

<ResolveCurrentProjectStaticWebAssetsInputsDependsOn> 

CompileTypeScript; 

$(ResolveCurrentProjectStaticWebAssetsInputs) 

</ResolveCurrentProjectStaticWebAssetsInputsOependsOn> 

Başvurulan bir RCL 'den içerik tüketme 

RCL ’nin Wwwroot klasörüne eklenen dosyalar, _content/{ı_iBRARY name}/ önek altında tüketen uygulamaya 
sunulur. Örneğin, Razor. Class. lib adlı bir kitaplık _content/Razor.ciass.Lib/ statik içerik yolu ile sonuçlanır. 

Kullanan uygulama, kitaplık tarafından <script> , <styie> , <img> ve diğer HTML etiketleriyle sunulan statik 
varlıklara başvurur. Tüketim uygulaması startup.configure 1 de statik dosya desteğinin etkin olması gerekir: 

public void Configure(IApplicationBuilder app, IWebHostEnvironment env) 

{ 

app.UseStaticFiles(); 

} 

Yapı çıktısından tüketen uygulamayı çalıştırırken ( dotnet run ), statik Web varlıkları geliştirme ortamında 
varsayılan olarak etkindir. Derleme çıktılarından çalışırken diğer ortamlardaki varlıkları desteklemek için, 
program.es' deki konak oluşturucusu 'nda ıisestaticwebAssets ' ı çağırın: 

using Microsoft.AspNetCore.Hosting; 
using Microsoft.Extensions.Hosting; 

public class Program 
{ 

public static void Main(string[] args) 

{ 

CreateHostBuilder(args).Build().Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStaticWebAssets(); 
webBuilder.UseStartup<Startup>(); 

}); 

} 

Yayımlanan çıktıdan bir uygulama çalıştırılırken çağrı usestaticwebAssets gerekmez ( dotnet pubiish ). 

Çoklu projeli geliştirme akışı 

Kullanan uygulama şu şekilde çalışır: 

• RCL içindeki varlıklar özgün klasörlerinde kalır.Varlıklar, tüketim uygulamasına taşınmaz. 

• RCL 'nin Wwwroot klasörü içindeki tüm değişiklikler, RCL yeniden oluşturulduktan ve tüketen uygulamayı 
yeniden oluşturmadan önce tüketen uygulamaya yansıtılır. 

RCL yapılandırıldığında, statik Web varlık konumlarını açıklayan bir bildirim oluşturulur.Tüketen uygulama, 
başvurulan proje ve paketlerden varlıkları kullanmak için çalışma zamanında bildirimi okur. Bir RCL 'ye yeni bir 












varlık eklendiğinde, bir uygulamanın yeni varlığa erişebilmesi için bildirim güncellemek üzere RCL ’nin 
yeniden oluşturulması gerekir. 

Yayınlamanız 

Uygulama yayımlandığında, tüm başvurulan projeler ve paketlerin yardımcı varlıkları 
_content/{LiBRARY NAME}/ altında Yayınlanan uygulamanın Wwwroot klasörüne kopyalanır. 

Razor görünümleri, sayfalar, denetleyiciler, sayfa modelleri, Razor bileşenleri, Görünüm bileşenlerive veri 
modelleri Razor sınıf kitaplığı 'nda (RCL) yerleşik olarak bulunabilir. RCL paketlenebilir ve yeniden 
kullanılabilir. Uygulamalar RCL 'yi içerebilir ve içerdiği görünümleri ve sayfaları geçersiz kılabilir.Hem Web 
uygulamasında hem de RCL 'de bir görünüm, kısmi görünüm veya Razor sayfası bulunduğunda, Web 
uygulamasındaki Razor biçimlendirmesi (. cshtml dosyası) önceliklidir. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Razor Kullanıcı arabirimi içeren bir sınıf kitaplığı oluşturma 

• Visual Studio 

• .NETCoreCLI 

• Visual Studio Dosya menüsünden Yeni > Proje' yi seçin. 

• ASP.N ET Core Web uygulaması' nı seçin. 

• Kitaplığı adlandırın (örneğin, "RazorCIassLib") > Tamam. Oluşturulan görünüm kitaplığıyla bir dosya adı 
çarpışmasını önlemek için, kitaplık adının ,views ' da bitmediğinden emin olun. 

• ASP.NET Core 2,1 veya sonraki bir sürümü seçildiğini doğrulayın. 

• Razor sınıfı kitaplığı > Tamam ' ıseçin. 

RCL aşağıdaki proje dosyasına sahiptir: 

<Project Sdk="Microsoft.NET.Sdk.Razor"> 

<PropertyGroup> 

<TargetFramework>netstandard2.0</TargetFramework> 

</PropertyGroup> 

<ItemGroup> 

<PackageReference Include="Microsoft.AspNetCore.Mvc" Version="2.2.0" /> 

</ItemGroup> 

</Project> 

RCL 'ye Razor dosyaları ekleyin. 

ASP.NET Core şablonları RCL içeriğinin Areas klasöründe olduğunu varsayar. ~/Areas/Pages yerine ~/Pages 
içeriği kullanıma sunan bir RCL oluşturmak için RCL Pages düzenine bakın. 

RCL içeriğine başvur 

RCL 'ye şu şekilde başvurulabilir: 

• NuGet paketi. Bkz. NuGet paketleri oluşturma ve DotNet paket ekleme ve bir NuGet paketi oluşturma ve 
yayımlama. 

• {ProjectName}. csproj. Bkz. DotNet-başvuru Ekle. 


İzlenecek yol: bir Razor Pages projesinden bir RCL projesi oluşturma 









ve kullanma 


Tüm projeyi indirebilir ve oluşturmak yerine test edebilirsiniz. Örnek indirme, projenin test olmasını 
kolaylaştıran ek kod ve bağlantılar içerir. Yükleme örnekleri ve adım adım yönergeler hakkındaki 
açıklamalarınızla Bu GitHub sorunuyla ilgili geri bildirimde bulunun. 

İndirme uygulamasını test etme 

Tamamlanmış uygulamayı indirmediyseniz ve gözden geçirme projesi oluşturmak istiyorsanız, sonraki 
bölümeatlayın. 

• Visual Studio 

• .NETCoreCLI 

Visual Studio 'da . sin dosyasını açın. Uygulamayı çalıştırın. 

Test VVebAppl içindeki yönergeleri izleyin 

RCL oluşturma 

Bu bölümde bir RCL oluşturulur.Razor dosyaları RCL 'ye eklenir. 

• Visual Studio 

• .NETCoreCLI 

RCL projesini oluşturun: 

• Visual Studio Dosya menüsünden Yeni > Proje' yi seçin. 

• ASP.N ET Core Web uygulaması' nı seçin. 

• > Tamam, uygulamayı RazorUlCIassLib olarak adlandırın. 

• ASP.NET Core 2,1 veya sonraki bir sürümü seçildiğini doğrulayın. 

• Razor sınıfı kitaplığı > Tamam ' ıseçin. 

• RazorUIClassLlb/Areas/MyFeature/Pages/Shared/_Message. cshtmladh bir Razor kısmi görünüm dosyası 
ekleyin. 

Projeye Razor dosyaları ve klasörleri ekleme 

• RazorUIClassLlb/Areas/MyFeature/Pages/Shared/_Message. cshtml içindeki biçimlendirmeyi aşağıdaki 
kodla değiştirin: 

<h3>_Message.cshtml partial view.</h3> 

<p>RazorUIClassl_ib\Areas\MyFeature\Pages\Shared\_Message. cshtml</p> 

• RazorUlClassLib/Areas/MyFeature/Pages/Sayfal. cshtml içindeki biçimlendirmeyi aşağıdaki kodla 
değiştirin: 

@page 

@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 
<h2>Hello from a Razor UI class library!</h2> 

<p> From RazorUIClassLib\Areas\MyFeature\Pages\Pagel.cshtml</p> 

<partial name="_Message" /> 

kısmi görünümü kullanmak için @addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers gereklidir ( 
<partiai name="_Message" /> ). @addTagHeiper yönergesini dahil etmek yerine,_ Viewwimports. cshtml 







dosyası ekleyebilirsiniz. Örneğin: 

dotnet new viewimports -o RazorllIClassLib/Areas/MyFeature/Pages 

_Viewwimports. cshfm/hakkında daha fazla bilgi için bkz. paylaşılan yönergeleri içeri aktarma 

• Derleyici hatası olmadığını doğrulamak için sınıf kitaplığı oluşturun: 

dotnet build RazorUIClassLib 

Derleme çıkışı RazorUIClassLib. dil ve RazorUIClassLib. views. d//içerir. RazorUIClassLib. views. dil derlenen 
Razor içeriğini içerir. 

Razor Pages projesinden Razor Kullanıcı arabirimi kitaplığını kullanma 

• Visual Studio 

• .NETCoreCLI 

Razor Pages Web uygulaması oluşturun: 

• Çözüm Gezgini>yeni proje eklemek > çözüme sağ tıklayın. 

• ASP.N ET Core Web uygulaması' nı seçin. 

• Uygulamayı VVebApplolarak adlandırın. 

• ASP.NET Core 2,1 veya sonraki bir sürümü seçildiğini doğrulayın. 

• Web uygulaması > Tamam ' ıseçin. 

• Çözüm Gezgini, VVebAppl ' ye sağ tıklayın ve Başlangıç projesi olarak ayarla 1 yı seçin. 

• Çözüm Gezgini, VVebAppl ' ye sağ tıklayın ve derleme bağımlılıkları > Proje bağımlılıkları' nı 

seçin. 

• VVebAppl in bağımlılığı olarak RazorUIClassLib denetleyin. 

• Çözüm Gezgini, VVebAppl ' a sağ tıklayıp > başvurusu Ekle ' yi seçin. 

• Başvuru Yöneticisi İletişim kutusunda RazorUIClassLib > Tamam' ı işaretleyin. 

Uygulamayı çalıştırın. 

Test VVebAppl 

Razor Ul sınıfı kitaplığının kullanımda olduğunu doğrulamak için /MyFeature/Pagei ' a gidin. 

Görünümleri, kısmi görünümleri ve sayfaları geçersiz kıl 

Hem Web uygulamasında hem de RCL 'de bir görünüm, kısmi görünüm veya Razor sayfası bulunduğunda, 
Web uygulamasındaki Razor biçimlendirmesi (. cshtml dosyası) önceliklidir.Örneğin, 
WebApp1/Areas/MyFeature/Pages/Sayfal. cshtml öğesini VVebAppl öğesine ekleyin ve VVebAppl içindeki 
Sayfal, RCL 'deki Sayfal 'e göre öncelikli olur. 

Örnek indirme içinde VVebAppl/Areas/MyFeature2 öğesini VVebAppl/Areas/myfeature olarak yeniden 
adlandırın ve test önceliğini belirtin. 

RazorUICIassLib/Areas/myfeature/Pages/Shared/_Message. cshtml kısmi görünümünü 
WebAppl/Areas/Myfeature/Pages/Shared/_Message. cshtml'ye kopyalayın. Biçimlendirmeyi yeni konumu 
belirtecek şekilde güncelleştirin. Uygulamanın kısmi sürümünün kullanılmakta olduğunu doğrulamak için 







uygulamayı derleyin ve çalıştırın. 

RCL sayfaları düzeni 

RCL içeriğine, Web uygulamasının Sayfalar klasörünün bir parçası olmasına rağmen başvurmak için, 
aşağıdaki dosya yapısıyla RCL projesini oluşturun: 

• RazorU IClassLib/sayfalar 

• RazorU IC lassLib/sayfa la r/pay laşılan 

RazorUlClassLib/Pages/Shared iki kısmi dosya İçerir \_header. cshtml \/e_footer. cshtml. <partiai> Etiketler 
_Layout. cshtml dosyasına eklenebilir: 

<body> 

<partial name="_Header"> 

@RenderBody() 

<partial name="_Footer"> 

</body> 





ASRNET Core yerleşik etiket Yardımcıları 
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Tarafından Peter Kellner 

Etiket Yardımcıları genel bakış için bkz. AS P.N ET Core etiket yardımcıları. 

Bu belgede listelenen olmayan yerleşik etiket Yardımcıları vardır. Listelenmemiş etiket Yardımcıları tarafından 
dahili olarak kullanılan Razor görünüm altyapısı. Etiket Yardımcıları ~ (tilde) karakteridir listeden kaldırıldı. Tilde 
işareti etiketi Yardımcısı Web sitesinin kök yolunu genişletir. 

Yerleşik ASP.NET Core etiket yardımcıları 

Tutturucu etiketi Yardımcısı 

Önbellek etiketi Yardımcısı 

Dağıtılmış önbellek etiketi Yardımcısı 

Ortam etiketi Yardımcısı 

Form etiketi Yardımcısı 

Form eylemi etiketi Yardımcısı 

Resim etiketi Yardımcısı 

Giriş etiketi Yardımcısı 

Etiket etiketi Yardımcısı 

Bağlantı etiketi Yardımcısı 

Kısmi etiket Yardımcısı 

Betik etiketi Yardımcısı 

Etiket yardımcısını seçin 

TextArea etiketi Yardımcısı 

Doğrulama İletisi etiketi Yardımcısı 

Doğrulama Özeti etiketi Yardımcısı 

Ek kaynaklar 

• ASP.NET Core etiket yardımcıları 

• AS P.N ET Core içindeki etiket Yardımcısı bileşenleri 





ASPNET Core etiket yardımcıları 
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Rick Anderson tarafından 

Etiket Yardımcıları nelerdir 

Etiket Yardımcıları, Razor dosyalarında HTM L öğeleri oluşturma ve işlemeye 
katılmak için sunucu tarafı kodu etkinleştirir. Örneğin, yerleşik imageTagHelper 
görüntü adına bir sürüm numarası ekleyebilir. Görüntü her değiştiğinde, 
sunucu görüntü için yeni bir benzersiz sürüm oluşturur, bu nedenle 
istemcilerin geçerli görüntüyü alma garantisi vardır (eski önbelleğe alınmış bir 
görüntü yerine). Yaygın görevler için, genel GitHub depolarında ve NuGet 
paketleri olarak formlar, bağlantılar, yükleme varlıkları ve daha fazlasını ve 
daha fazlasını oluşturma gibi birçok yerleşik etiket yardımcıları vardır. Etiket 
Yardımcıları 1 de C#yazılır ve öğe adı, öznitelik adı veya üst etikete göre HTML 
öğelerini hedefleyin. Örneğin, LabeiTagHelper öznitelikleri uygulandığında 
yerleşik LabeiTagHelper HTML <iabei> öğesini hedefleyebilir. HTML 
Yardımcılarıhakkında bilginiz varsa, ETİKET yardımcıları HTML ve C# Razor 
görünümlerinde açık geçişleri azaltır. Birçok durumda, HTML Yardımcıları 
belirli bir etiket Yardımcısı için alternatif bir yaklaşım sağlar, ancak bu etiket 
yardımcıların HTML yardımcılarını değiştirmez ve her HTML Yardımcısı için 
bir etiket Yardımcısı olmadığını bilmek önemlidir. HTML yardımcılarına kıyasla 
etiket yardımcıları daha ayrıntılı olarak açıklanır. 

Hangi etiket yardımcıları sağlar 

HTML kullanımı kolay bir geliştirme deneyimi Çoğu bölümde, etiket 
yardımcıları kullanan Razor işaretlemesi standart HTML gibi görünür. Ön uç 
tasarımcıları HTML/CSS/JavaScript ile iletişim Razor söz dizimi, öğrenmeden 
C# Razor 'yi düzenleyebilir. 

HTML ve Razor biçimlendirmesi oluşturmak için zengin bir 
IntelliSense ortamı Bu, daha önceki bir deyişle, Razor görünümlerinde, 
sunucu tarafı biçimlendirme oluşturmaya yönelik önceki yaklaşım olan HTML 
yardımcılarından daha keskin karşıtlığa sahiptir. HTML yardımcılarına kıyasla 
etiket yardımcıları daha ayrıntılı olarak açıklanır. Etiket Yardımcıları İçin 
IntelliSense desteği, IntelliSense ortamını açıklar. Razor C# söz dizimi ile 
karşılaşılan geliştiriciler, Razor İşaretlemesi yazmadan C# etiket yardımcıları 
kullanılarak daha üretken olmanızı sağlar. 

Daha üretken olmanızı sağlamak ve yalnızca sunucuda bulunan 
bilgileri kullanarak daha sağlam, güvenilir ve sürdürülebilir kodlar 
elde etmek İçin bir yol Örneğin, geçmişe dönük olarak görüntülerin 
güncelleştirilmesi, görüntüyü değiştirdiğinizde görüntünün adını değiştiriydi. 
Görüntülerin performans nedenleriyle bir şekilde ön belleğe alınması gerekir 
ve bir görüntünün adını değiştirmediğiniz takdirde, istemcilerin eski bir kopya 
alıyor olması risklidir. Tarihsel olarak, bir görüntü düzenlendikten sonra ad 
değiştirilmelidir ve Web uygulamasındaki görüntünün güncellenmesi için 
gereken her başvuru. Bu çok işçiliği yoğun bir şekilde değil, bu da hataya 







açıktır (bir başvuruyu kaçırmanızı, yanlışlıkla yanlış dize girmeniz vb.) Yerleşik 
ImageTagHelper bunu SİZİn için Otomatik olarak yapabilir. ImageTagHelper 
görüntü adına bir sürüm numarası ekleyebilir, böylece görüntü her 
değiştiğinde sunucu otomatik olarak görüntü için yeni bir benzersiz sürüm 
oluşturur, istemcilerin geçerli görüntüyü alması garanti edilir. Bu sağlamlık ve 
işgücü tasarrufları ImageTagHelper kullanılarak ücretsizdir. 

Çoğu yerleşik etiket yardımcıları standart HTM L öğelerini hedefleyin ve öğesi 
için sunucu tarafı öznitelikleri sağlar. Örneğin, Görünümler/hesap 
klasöründeki birçok görünümde kullanılan <input> öğesi asp-for 
özniteliğini içerir. Bu öznitelik, belirtilen model özelliğinin adını işlenmiş 
HTML içine ayıklar. Aşağıdaki modelle bir Razor görünümü göz önünde 
bulundurun: 

public class Movie 
{ 

public int ID { get; set; } 
public string Title { get; set; } 
public DateTime ReleaseDate { get; set; } 
public string Genre { get; set; } 
public decimal Price { get; set; } 

} 

Aşağıdaki Razor biçimlendirmesi: 

dabel asp-for= "Movie.Title"x/label> 

Aşağıdaki HTML 'yi oluşturur: 

<label for="Movie_Title">Title</label> 

asp-for özniteliği Labeltaghelper'daki For özelliği tarafından kullanılabilir 
hale getirilir. Daha fazla bilgi için bkz. Yazar etiketi yardımcıları . 

Etiket Yardımcısı kapsamını yönetme 

Etiket Yardımcıları kapsamı, @addTagHelper , (ŞremoveTagHelper ve "I" geri 
çevirme karakterinin bir birleşimi tarafından denetlenir. 

@addTagHeiper etiket yardımcıları kullanılabilir hale getirir 

Authoringtaghelmakaadıad\\ yeni bir ASP.NET Core Web uygulaması 
oluşturursanız, projenize aşağıdaki Görünümler/_Viewlmports. cshtml dosyası 
eklenecektir: 

(ŞaddTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 
(ŞaddTagHelper *, AuthoringTagHelpers 

@addTagHeiper yönergesi, etiket yardımcılarını görünüm için kullanılabilir hale 
getirir. Bu durumda, görünüm dosyası sayfalar/, Vievvlmports. cshtml'd\r ve 
varsayılan olarak Sayfalar klasörü ve alt klasörlerdeki tüm dosyalar tarafından 
devralınır. Etiket Yardımcıları kullanılabilir hale getirme. Yukarıdaki kod, 
belirtilen derlemedeki tüm etiket yardımcılarını ( Microsoft. AspNetCore. Mvc. 
Taghelmakat), Görünümler dizinindeki veya alt dizininde bulunan her 
















görünüm dosyası için kullanılabilir olacağını belirtmek için joker karakter söz 
dizimini ("*") kullanır. @addTagHeiper sonraki ilk parametre, yüklenecek etiket 
yardımcıları (tüm etiket yardımcıları için "*" kullanıyoruz) ve ikinci parametre 
olan "Microsoft. AspNetCore. Mvc. Taghelmakat", etiket yardımcıları içeren 
derlemeyi belirtir. Microsoft. AspNetCore. Mvc. Taghelmakatem , yerleşik 
AS P.N ET Core etiket yardımcıları için derlemedir. 

Bu projedeki tüm etiket yardımcılarını ortaya çıkarmak için ( 
Authoringtaghelmakatıadh bir derleme oluşturur), aşağıdakileri kullanın: 

@using AuthoringTagHelpers 

(ŞaddTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 
(ŞaddTagHelper *, AuthoringTagHelpers 

Projeniz varsayılan ad alanı ( AuthoringTagHelpers.TagHelpers.EmailTagHelper ) 
ile bir EmailTagHelper içeriyorsa, etiket yardımcısından tam nitelikli adı (FQN) 
sağlayabilirsiniz: 

@using AuthoringTagHelpers 

@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 
(ŞaddTagHelper AuthoringTagHelpers.TagHelpers.EmailTagHelper, 
AuthoringTagHelpers 

Bir FQN kullanarak bir görünüme etiket Yardımcısı eklemek için, önce FQN ( 
AuthoringTagHelpers.TagHelpers.EmailTagHelper ) ve ardından derleme adi 
(. Authoringtaghelmakcu) eklersiniz. Çoğu geliştirici, joker sözdizimini 
kullanmayı tercih eder. Joker karakter sözdizimi, bir FQN içinde sonek olarak 
joker karakterini eklemenizi sağlar. Örneğin, aşağıdaki yönergelerden 
herhangi biri EmailTagHelper alınacaktır: 

(ŞaddTagHelper AuthoringTagHelpers.TagHelpers.E*, AuthoringTagHelpers 
(ŞaddTagHelper AuthoringTagHelpers.TagHelpers.Email*, AuthoringTagHelpers 

Daha önce belirtildiği gibi, views/_Viewlmports. cshtml dosyasına 
@addTagHeiper yönergesini eklemek, etiket Yardımcısı' nı Görünümler 
dizinindeki ve alt dizinlerindeki tüm görünüm dosyaları için kullanılabilir hale 
getirir. Etiket yardımcısını yalnızca bu görünümlerde kullanıma sunmak 
istiyorsanız, belirli görünüm dosyalarında @addTagHeiper yönergesini 
kullanabilirsiniz. 

(SremoveTagHelper etiket yardımcıları kaldırır 

@removeTagHelper @addTagHeiper aynı iki parametreye sahiptir ve daha önce 
eklenmiş bir etiket yardımcısını kaldırır. Örneğin, belirli bir görünüme 
uygulanan @removeTagHeiper , belirtilen etiket yardımcısını görünümden 
kaldırır. Bir views/Folder/_Viewlmports. cshtml dosyasında @removeTagHeiper 
kullanmak, belirtilen etiket yardımcısını klasördekitüm görünümlerden 
kaldırır. 

Etiket Yardımcısı kapsamını _ Vievvlmports. cshtml dosyası ile denetleme 

Herhangi bir görünüm klasörüne_ Vievvlmports. cshtml ekleyebilirsiniz ve 
Görünüm altyapısı, bu dosya ve Görünümler/_Viewlmports. cshtml 
dosyasından yönergeleri uygular. Giriş görünümleri için boş bir 
Görünümler/Home/_Viewlmports. cshtml dosyası eklediyseniz, _Viewlmports. 






















cshtml dosyası eklenebilir olduğundan hiçbir değişiklik olmaz. 
Görünümler/Home/_Viewlmports. cshtml dosyasına eklediğiniz (varsayılan 
görünümlerde/_Viewlmports. cshtml dosyasında olmayan) tüm 
@addîagHeiper yönergeleri, bu etiket yardımcılarını yalnızca giriş klasöründeki 
görünümlerde kullanıma sunar. 

Ayrı öğelerin dışında tutma 

Etiket Yardımcısı geri çevirme karakteriyle ("!") birlikte öğe düzeyinde bir 
etiket yardımcısını devre dışı bırakabilirsiniz. Örneğin, Email doğrulaması 
etiket Yardımcısı geri çevirme karakteriyle <span> devre dışı bırakılır: 

<!span asp-validation-for="Email" class="text-danger"></!span> 

Açılış ve kapanış etiketine etiket Yardımcısı geri çevirme karakterini 
uygulamanız gerekir. (Açılış etiketine bir tane eklediğinizde, Visual Studio 
Düzenleyicisi, kapatma etiketine otomatik olarak bir kapanış karakteri ekler). 
Kabul etme karakterini ekledikten sonra, öğe ve etiket Yardımcısı öznitelikleri 
artık farklı bir yazı tipinde gösterilmez. 

Etiket Yardımcısı kullanımını açık hale getirmek için @tagHeiperPrefix kullanma 

@tagHeiperPrefix yönergesi etiket Yardımcısı desteğini etkinleştirmek ve 
etiket Yardımcısı kullanımını açık hale getirmek için bir etiket öneki dizesi 
belirtmenize olanak tanır. Örneğin, aşağıdaki biçimlendirmeyi 
views/_Viewlmports. cshtml dosyasına ekleyebilirsiniz: 

@tagHelperPrefix th: 

Aşağıdaki kod görüntüsünde, etiket Yardımcısı ön eki th: olarak ayarlanır, bu 
nedenle, yalnızca ön th: eki kullanan öğeler etiket yardımcıları destekler 
(etiket Yardımcısı etkin öğeleri farklı bir yazı tipine sahiptir). <iabei> ve 
<input> öğeleri etiket Yardımcısı ön ekine sahiptir ve etiket Yardımcısı etkin, 
ancak <span> öğesi değil. 

<div class="form-group”> 

<th:label asp-for="Password" class=''col-md-2"></th:label> 

<div class=”col-md-10"> 

<th:input asp-for="Password" class=''form-control" /> 

<span asp-validation-for="Password" class="text-danger"x/span> 

</div> 

</div> 

@addTagHeiper için uygulanan aynı hiyerarşi kuralları @tagHeiperPrefix için de 
geçerlidir. 

Kendi kendine kapanan etiket yardımcıları 

Birçok etiket yardımcıları, kendinden kapanış etiketleri olarak kullanılamaz. 

Bazı etiket yardımcıları, kendinden kapanış etiketleri olacak şekilde 
tasarlanmıştır. Kendi kendini kapatmak üzere tasarlanmamış bir etiket 
Yardımcısı kullanılması işlenmiş çıktıyı bastırır. Bir etiket Yardımcısı kendinden 
kapanış, işlenen çıktıda kendi kendine kapanan bir etikete neden olur. Daha 
fazla bilgi için bkz. etiket yardımcılarını yazma. 


C#Etiket Yardımcıları özniteliğinde/bildiriminde 
















Etiket Yardımcıları öğenin özniteliğinde veya C# etiket bildirim alanında izin 
vermez. Örneğin, aşağıdaki kod geçerli değildir: 

cinput asp-for="Lastl\lame" 

@(Model?.Licenseld == null ? "disabled" : string.Empty) /> 

Yukarıdaki kod şöyle yazılabilir: 

cinput asp-for="LastName" 

disabled="@(Model?.Licenseld == null)" /> 


Etiket Yardımcıları için IntelliSense desteği 

Visual Studio 'da yeni bir AS P.N ET Core Web uygulaması oluşturduğunuzda, 
"Microsoft. AspNetCore. Razor. Tools" NuGet paketini ekler. Bu, etiket 
Yardımcısı araçları ekleyen pakettir. 

Bir HTML <iabei> öğesi yazmayı düşünün. Visual Studio düzenleyicisinde 
<ı girdiğinizde, IntelliSense eşleşen öğeleri görüntüler: 

<jj 


<> details 

O dialog 

O dİ 

O fieldset 



link 


ng-include 


ng-pluralize 


g£! ol 

▼ 


The label element represents a caption in a user interface. The caption can be associated with a specific form 
control, knovvn as the label element's labeled control, either using the for attribute, or by putting the form control 
inside the label element itself. 


Yalnızca HTML Yardımı edinmeyin ancak simgenin ("@" symbol vvith "< >" 
altında "). 

öğesi etiket yardımcıları tarafından hedeflenen şekilde tanımlar. Saf HTML 
öğeleri ( fieldset gibi) "< >" simgesini görüntüler. 

Saf HTML <iabei> etiketi, HTML etiketini (varsayılan Visual Studio renk 
teması ile) bir kahverengi yazı tipinde, kırmızı olan özniteliklere ve öznitelik 
değerlerini mavi olarak görüntüler. 

clabel class="col-md-2">Email</label> 


ciabel girdikten sonra, IntelliSense kullanılabilen HTML/CSS özniteliklerinı 
ve etiket Yardımcısı 'nın hedeflenen özniteliklerini listeler: 













<label 


0 

accesskey 

~ n ▲ 

(V 

aria-... 


9 

asp-for 


0 

class 


0 

contenteditable 


0 

contectmenu 


© 

data-... 


§£ db 


0 

dir 

▼ 


IntelliSense deyimin tamamlanması, seçili değere sahip ifadeyi tamamlamak 
için sekme tuşunu girmenizi sağlar: 

<label as| 


.9 

asp-for 

0 

class 


Etiket Yardımcısı özniteliği girildiğinde, Tag ve Attribute yazı tipleri değişir. 
Varsayılan Visual Studio "mavi" veya "hafif" renkli temasını kullanarak yazı tipi 
kalın mor olur. "Koyu" temasını kullanıyorsanız, yazı tipi kalın deniz mavisi 
olur. Bu belgedeki görüntüler varsayılan tema kullanılarak alınmıştır. 

<label asp-for 


Visual Studio CompleteVVord kısayolunu (Ctrl + Ara çubuğu), çift tırnak 
işaretleri ("") içinde varsayılan değer olan ve artık 1 de C#olduğu gibi, bir C# 
sınıfta olacak şekilde girebilirsiniz. IntelliSense, sayfa modelindeki tüm 
yöntemleri ve özellikleri görüntüler. Özellik türü ModeiExpression olduğundan 
Yöntemler ve özellikler kullanılabilir. Aşağıdaki görüntüde Register 
görünümünü düzenledim, bu nedenle RegisterViewModei kullanılabilir. 


clabel asp-for="e" 



f* ConfirmPassvvord 

string Register. ıe .Model. Email { get; set; } 

A 

Email 


© Equals 
© GetHashCode 
© GetType 
f* Password 
© ToString 


IntelliSense, sayfada modelin kullanabileceği özellikleri ve yöntemleri listeler. 
Zengin IntelliSense ortamı, CSS sınıfını seçmenize yardımcı olur: 

<input asp-for="Email" cll 

*v wvw » > 


class 


f- onclick 
f onclose 
f ondblciick 


cinput asp-for="Email" 


class=”co|" 


0 

0 

0 

□ 

□ 


body-content 

bs-example-control-sizing 

bs-glyphicons 

carousel-control 


col 


0 col-1 
0 col-2 
0 col-3 
0 col-4 


























HTML Yardımcıları ile karşılaştırılan etiket 
yardımcıları 

Etiket Yardımcıları Razor görünümlerinde HTML öğelerine iliştirirken, HTML 
Yardımcıları Razor görünümlerinde HTML ile yöntemler olarak çağrılır.CSS 
sınıfı "Caption" içeren bir HTML etiketi oluşturan aşağıdaki Razor 
işaretlemesini göz önünde bulundurun: 

@Html.Label("FirstName", "First Name:", new {@class="caption"}) 

At ( @ ) simgesi, Razor 'in kodun başlangıcı olduğunu söyler.Sonraki iki 
parametre ("FirstName" ve "First Name:") dizelerdir, bu nedenle IntelliSense 
yardımcı olamaz. Son bağımsız değişken: 

new {@class="caption"} 

Öznitelikleri temsil etmek için kullanılan anonim bir nesnedir, ciass 1 de 
C#ayrılmış bir anahtar sözcük olduğundan, bir sembol olarak @ciass= 
yorumlama zorlamak C# için @ sembolünü kullanın (özellik adı). Bir ön uç 
tasarımcısına (HTML/CSS/JavaScript 'eve diğer istemci teknolojilerine 
tanıdık ancak C# ve Razor hakkında bilgi sahibi olmayan bir kişiye), satırın 
çoğu yabancı olur. Tüm satır, IntelliSense 'den yardım olmadan yazılmalıdır. 

LabeiTagHelper kullanarak, aynı biçimlendirme şöyle yazılabilir: 

clabel class="caption" asp-for="FirstName"x/label> 

Etiket yardımcı sürümünde, Visual Studio düzenleyicisinde <ı girdiğinizde 
IntelliSense eşleşen öğeleri görüntüler: 

< 1 ) 


<> details 

O dialog 

O dİ 

O fieldset 


□ label 

jf link 


ng-include 


Q ng-pluralize 


80 o\ 

▼ 


The label element represents a caption in a user interface. The caption can be associated with a specific form 
control, known as the label element's labeled control, either using the for attribute, or by putting the form control 
inside the label element itself. 


IntelliSense, tüm satırı yazmanıza yardımcı olur. 

Aşağıdaki kod görüntüsünde, Visual Studio 'da bulunan ASP.NET 4.5. x MVC 
şablonundan oluşturulan vievvs/Account/Register. cshtml Razor görünümünün 
form kısmı gösterilmektedir. 













@using (Html.BeginForm("Register", "Account", :- i "ethod .Post, new { (öclass = "form-horizo 
{ 

@Html.AntiForgeryToken() 

<h4>Create a new account. </h4> 

<hr /> 

@Html.ValidationSummary("", new { (öclass = "text-danger" }) 

<div class="form-group”> 

@Html.LabelFor(m => m.Email, new { (öclass = "col-md-2 control-label" }) 

<div class="col-md-10"> 

@Html.TextBoxFor(m => m.Email, new { (öclass = "form-control" }) 

</div> 

</div> 

<div class="form-group"> 

@Html.LabelFor(m => m.Password, new { (öclass = "col-md-2 control-label" }) 

<div class="col-md-10"> 

@Html.PasswordFor(m => m.Password, new { @class = "form-control" }) 

</div> 

</div> 

<div class=”form-group”> 

@Html.LabelFor(m => m.ConfirmPassword, new { (öclass = "col-md-2 control-label" }) 

<div class="col-md-10"> 

@Html.PasswordFor(m => m.ConfirmPassword, new { (öclass = "form-control" }) 
</div> 

</div> 

<div class="form-group"> 

<div class="col-md-offset-2 col-md-10"> 

<input type="submit" class="btn btn-default" value="Register" /> 

</div> 

</div> 


Visual Studio Düzenleyicisi gri bir C# arka plana sahip kodu görüntüler. 
Örneğin, AntiForgeryToken HTML Yardımcısı: 


@Html.AntiForgeryToken() 


gri bir arka planla görüntülenir. Kayıt görünümündeki biçimlendirmenin çoğu 
C#. Etiket Yardımcıları kullanarak eşdeğer yaklaşımla karşılaştırın: 

<form asp-controller="Account" asp-action="Register" method="post" class="fornı-hori 
<h4>Create a new account. </h4> 

<hr /> 

<div asp-validation-summary=”ValidationSui nary.All" class="text-danger"x/div> 
<div class="form-group"> 

<label asp-for="Email" class="col-md-2 control-label"x/label> 

<div class="col-md-10"> 

<input asp-for="Email" class="form-control" /> 

<span asp-validation-for="Email" class="text-danger"x/span> 

</div> 

</div> 

<div class="form-group"> 

<label asp-for="Password" class="col-md-2 control-label"x/label> 

<div class="col-md-10"> 

<input asp-for="Password" class="form-control" /> 

< span asp-validation-for="Password'’ class="text-danger"x/span> 

</div> 

</div> 

<div class="form-group”> 

<label asp-for="Conf irmPassword" class="col-md-2 control-label"x/label> 
<div class=”col-md-10"> 

cinput asp-for="ConfirmPassword" class="form-control" /> 

<span asp-validation-for="ConfirmPassword" class="text-danger"x/span> 
</div> 

</div> 

<div class="form-group"> 

<div class="col-md-offset-2 col-md-10"> 

<button type="submit" class="btn btn-default" >Register</button> 

</div> 

</div> 

</fortn> 


Biçimlendirme çok daha temiz ve HTML Yardımcıları yaklaşımıyla daha kolay 
okunabilir, düzenlenebilir ve korunur. C# Kod, sunucunun hakkında bilgi sahibi 
olması gereken en düşük düzeyde azaltılır. Visual Studio Düzenleyicisi, bir 
etiket Yardımcısı tarafından hedeflenen biçimlendirmeyi farklı bir yazı tipinde 
görüntüler. 

E-posta grubunu göz önünde bulundurun: 





<div class="form-group"> 

<label asp-for="Email" class="col-md-2 contnol-label"x/label> 

<div class="col-md-10"> 

<input asp-for="Email" class="form-control" /> 

<span asp-validation-for="Email" class="text-danger"x/span> 

</div> 

</div> 

"ASP-" özniteliklerinin her biri "e-posta" değerine sahiptir, ancak "e-posta" bir 
dize değildir. Bu bağlamda, "e-posta" RegisterViewModei C# model ifadesi 
özelliğidir. 

Visual Studio Düzenleyicisi, kayıt formunun etiket Yardımcısı yaklaşımında 
Tüm biçimlendirmeyi yazmanıza yardımcı olur, ancak Visual STUDİO, HTML 
Yardımcıları yaklaşımında kodun çoğu için yardım vermez. Etiket Yardımcıları 
İçin IntelliSense desteği , Visual Studio düzenleyicisinde etiket yardımcıları ile 
çalışma hakkında ayrıntılı bilgiler alır. 

Web sunucusu denetimleriyle karşılaştırılan etiket 
yardımcıları 

• Etiket Yardımcıları ilişkili oldukları öğeye sahip değil; yalnızca öğe ve 
içerik işleme katılır. ASP.NET Web sunucusu denetimleri bir sayfada 
bildirilmiştir ve çağrılır. 

• Web sunucusu denetimlerinde geliştirme ve hata ayıklama zor hale 
getirmek için önemsiz olmayan bir yaşam döngüsü vardır. 

• Web sunucusu denetimleri, istemci denetimi kullanarak istemci Belge 
Nesne Modeli (DOM) öğelerine işlevsellik eklemenize olanak tanır. 

Etiket yardımcıların DOM 'ı yok. 

• Web sunucusu denetimleri otomatik tarayıcı algılamayı içerir. Etiket 
yardımcılarına tarayıcı bilgisi yok. 

• Birden çok etiket yardımcıları aynı öğe üzerinde işlem yapabilir (bkz. 
etiket Yardımcısı çakışmalarını önleme ), genellikle Web sunucusu 
denetimleri oluşturamazsınız. 

• Etiket Yardımcıları, kapsamında oldukları HTML öğelerinin etiketini ve 
içeriğini değiştirebilir ancak sayfada başka bir şeyi doğrudan 
değiştirmez. Web sunucusu denetimleri, daha az belirli bir kapsama 
sahiptir ve Sayfanızın diğer bölümlerini etkileyen eylemler 
gerçekleştirebilir; istenmeyen yan etkileri etkinleştirme. 

• Web sunucusu denetimleri, dizeleri nesnelere dönüştürmek için tür 
dönüştürücüler kullanır. Etiket Yardımcıları sayesinde yerel olarak 1 de 
C#çalışır, bu nedenle tür dönüştürmesi yapmanız gerekmez. 

• Web sunucusu denetimleri, bileşenlerin ve denetimlerin çalışma 
zamanı ve tasarım zamanı davranışını uygulamak için System. 
ComponentModel kullanır. System.componentModei , öznitelik ve tür 
dönüştürücüler uygulamak, veri kaynaklarına bağlama ve lisans 
bileşenlerine yönelik temel sınıflar ve arabirimler içerir. Genellikle 
TagHelper türeten ve TagHelper temel sınıftan türetilen yardımcıları 

etiketleyerek, Process ve ProcessAsync yalnızca iki yöntem sunar. 










Etiket Yardımcısı öğe yazı tipini özelleştirme 

Yazı tipi ve renklendirmeyi araçlar > seçenekler > ortam > yazı tipi ve 
renkler 1 de özelleştirebilirsiniz: 


Options ? X 


Show settings fon 

Text Editör 

v Use Defaults 

Font (bold type indicates fixed-width fonts): 

Size: 

Consolas 
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Search Options (Ctrl+E) fi\ 

a Environment a 

General 
AutoRecover 
Documents 

Extensions and Updates 

Find and Replace 

Fonts and Colors 

Import and Export Settings 

International Settings 

Keyboard 
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Quick Launch 

Startup 

Synchronized Settings 
Tabs and Windows 
Task List 
Web Browser 

> Projects and Solutions 
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> Text Editör 

> Debugging 
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> PerformanceTools 
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HTML Server-Side Script 

HTML Tag Delimiter 
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İnline Rename 

İnline Rename Fixup 

Interactive Window Error Output 

JSON Property Name 

Keyvvord 

Knockout Region 

LESS Keyvvord 
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LESS Mixin Reference 

LESS Namespace Reference 

LESS Variable Declaration 

LESS Variable Reference 
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MarkerFormatDefinition/VerticalHigF 
Memory Address 
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Yerleşik ASP.NET Core etiket yardımcıları 

Tutturucu etiketi Yardımcısı 

Önbellek etiketi Yardımcısı 

Dağıtılmış önbellek etiketi Yardımcısı 

Ortam etiketi Yardımcısı 

Form etiketi Yardımcısı 

Form eylemi etiketi Yardımcısı 

Resim etiketi Yardımcısı 

Giriş etiketi Yardımcısı 

Etiket etiketi Yardımcısı 

Bağlantı etiketi Yardımcısı 

Kısmi etiket Yardımcısı 

Betik etiketi Yardımcısı 

Etiket yardımcısını seçin 

TextArea etiketi Yardımcısı 

Doğrulama İletisi etiketi Yardımcısı 

Doğrulama Özeti etiketi Yardımcısı 



































Ek kaynaklar 

• Yazar etiketi yardımcıları 

• Formlarla Çalışma 

• GitHub 'Daki Taghelpersamples , önyüklemelle çalışmaya yönelik etiket 
Yardımcısı örnekleri içerir. 


ASPNET core'da Yazar etiket Yardımcıları 

6.12.2019 • 24 minutes to readz. Edit Online 


Tarafından Rick Anderson 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Etiket Yardımcıları ile çalışmaya başlama 

Bu öğreticide programlama etiket Yardımcıları tanıtır. Etiket Yardımcıları giriş etiket Yardımcıları sağlayan 
avantajlarına açıklar. 

Etiket Yardımcısı uygulayan sınıf olan iTagHelper arabirimi. Etiket Yardımcısı geliştirdiğinizde, Bununla birlikte, 
genellikle öğesinden türetilen TagHelper , yapmak için bunu erişmenizi Process yöntemi. 

1. Adlı yeni bir AS P.N ET Core projesi oluşturma AuthoringTagHelpers. Bu proje için kimlik doğrulaması 
gerekmez. 

2. Adlı etiket Yardımcıları tutmak için bir klasör oluşturun TagHelpers. TagHelpers klasördür değil gerekli, 
ancak bunu makul bir kuraldır. Şimdi bazı basit etiket Yardımcıları yazmaya başlayalım. 

En az bir etiketi Yardımcısı 

Bu bölümde, bir e-posta etiketi güncelleştiren etiket Yardımcısı yazmaya. Örneğin: 

<email>Support</email> 

Sunucu, bizim e-posta etiketi Yardımcısı, biçimlendirme ve bunlar aşağıdaki şekilde dönüştürmek için kullanır: 

<a href="mailto:Support@contoso.com">Support@contoso.com</a> 

Diğer bir deyişle, bir yer işareti etiketi, bu e-posta bağlantısı sağlar. Blog altyapısıdır ve yazma ve aynı etki alanı 
için pazarlama desteği ve diğer kişiler için e-posta göndermek istiyorsanız bunu yapmak isteyebilirsiniz. 

1. Aşağıdaki EmailTagHelper sınıfının TagHelpers klasör. 


using Microsoft.AspNetCore.Razor.TagHelpers; 
using System.Threading.Tasks; 

namespace AuthoringTagHelpers.TagHelpers 
{ 

public class EmailTagHelper : TagHelper 
{ 

public override void Process(TagHelperContext context, TagHelperOutput output) 

{ 

output.TagMame = "a"; // Replaces <email> with <a> tag 

} 

} 

} 

• Etiket Yardımcıları kök sınıf adı öğelerini hedefleyen bir adlandırma kuralını kullanın (eksi 
TagHelper sınıf adı kısmı). Bu örnekte, kök adı EmailTagHelper olduğu e-posta, bu nedenle 











<emaii> etiketi hedeflenecek. Bu adlandırma çoğu etiket Yardımcıları için çalışır, daha sonra bu 
geçersiz kılma göstereceğiz. 

• EmailTagHelper Sınıf türetilir TagHelper . TagHelper SAX yöntemleri ve özellikleri etiket 
Yardımcıları yazmak için. 

• Geçersiz kılınan Process yöntemi denetimleri etiketi Yardımcısı yürütüldüğünde yapar. TagHelper 
Sınıfı zaman uyumsuz bir sürümü sağlar ( ProcessAsync ) aynı parametrelere sahip. 

• Bağlam parametresi Process (ve ProcessAsync ) geçerli HTML etiketinin yürütme ile ilgili bilgiler 
içerir. 

• Çıkış parametresi Process (ve ProcessAsync ) bir HTML etiketi ve içerik oluşturmak için kullanılan 
özgün kaynağını temsil eden bir durum bilgisi olan HTML öğesi içeriyor. 


• Bizim sınıf adı son eki olan TagHelper, olduğu değil gerekli, ancak bir en iyi yöntem kuralı dikkate 
almıştır. Sınıf olarak bildirebilirsiniz: 


public class 

Email : TagHelper 


EmailTagHelper sınıfını tüm Razor görünümlerimize kullanılabilir hale getirmek için, 
yönergesini views/_Viewlmports. cshtml dosyasına ekleyin: 

addTagHelper 



@using AuthoringTagHelpers 

@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 
@addTagHelper *, AuthoringTagHelpers 


Yukarıdaki kod, bizim derlemedeki tüm etiket Yardımcıları kullanılabilir olacağını belirtmek için joker 
karakter sözdizimini kullanır. Sonra ilk dize @addTagHeiper yüklemek için etiket Yardımcısı belirtir (kullan 
"*" tüm etiket Yardımcıları için), ve ikinci dize "AuthoringTagHelpers" etiketi Yardımcısı olan derlemeyi 
belirtir. Ayrıca, ikinci satırın joker karakter söz dizimini kullanarak ASP.NET Core MVC etiket 
yardımcılarına getirdiğine unutmayın (Bu yardımcılar etiket yardımcılarına girişbölümünde ele alınmıştır.) 
Bu, etiket yardımcısını Razor görünümü için kullanılabilir hale getiren @addTagHeiper yönergedir. 
Alternatif olarak, aşağıda gösterildiği gibi bir etiket Yardımcısı'nın (FQN) tam nitelikli ad sağlayabilirsiniz: 

@using AuthoringTagHelpers 

@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 

@addTagHelper AuthoringTagHelpers.TagHelpers. EmailTagHelper., AuthoringTagHelpers 

FQN kullanarak bir görünüme bir etiket Yardımcısı eklemek için, önce FQN ( 

AuthoringTagHelpers.TagHelpers.EmailTagHelper ) ve ardından derleme adi ( authoringtaghel , namespace ) 
eklersiniz. Çoğu geliştirici, joker karakter sözdizimini kullanmayı tercih eder. Etiket Yardımcıları giriş etiket 
Yardımcısı ekleme, kaldırma, hiyerarşi vejoker karakter sözdizimi, ayrıntıya gider. 


1. Biçimlendirme içinde güncelleştirme Views/Home/Contact.cshtml bu değişikliklerle dosyası: 

























ViewData["Title"] = "Contact"; 

} 

<h2>@ViewData["Title"].</h2> 

<h3>@ViewData["Message"]</h3> 

<address> 

One Microsoft Way<br /> 

Redmondj WA 98052<br /> 

<abbr title="Phone">P:</abbr> 

425.555.0100 

</address> 

<address> 

<strong>Support: </strongxemail>Support</emailxbr /> 
<strong>Marketing:</strongxemail>Marl<eting</email> 
</address> 


2. Uygulamayı çalıştırın ve e-posta etiketler ile bağlantı biçimlendirme değiştirilir doğrulayabilmeniz için 
HTML kaynağını görüntülemek için sık kullandığınız tarayıcıyı kullanabilirsiniz (örneğin, <a>support</a> ). 
Destek ve pazarlama bir bağlantı olarak işlenir ancak bir href işlevsel hale getirmek için özniteliği. 

Sonraki bölümde, gidereceğiz. 

SetAttribute ve SetContent 

Bu bölümde, güncelleştireceğiz EmailTagHelper böylece e-posta için bir geçerli yer işareti etiketi oluşturur. Razor 
görünümü bilgilerinden gerçekleştirecek şekilde güncelleştireceğiz (biçiminde bir maiı-to özniteliği) ve bağlantı 
oluşturmak kullanın. 

Güncelleştirme EmailTagHelper aşağıdaki sınıfı: 

public class EmailTagHelper : TagHelper 

{ 

private const string EmailDomain = "contoso.com"; 

// Can be passed via <email mail-to="..." />. 

// PascalCase gets translated into kebab-case. 
public string MailTo { get; set; } 

public override void Process(TagHelperContext context, TagHelperOutput output) 

{ 

output.TagName = "a"; // Replaces <email> with <a> tag 

var address = MailTo + + EmailDomain; 

output.Attributes.SetAttribute("href"j "mailto:" + address); 
output.Content.SetContent(address); 

} 

} 

• Etiket Yardımcıları için Pascal özellikli sınıf ve özellik adları, Kebab durumlarınaçevrilir. Bu nedenle, 
kullanılacak MailTo kullanacağınız özniteliği <emaii maii-to="vaiue"/> eşdeğer. 

• Son satırı tamamlanmış içeriği bizim için en düşük düzeyde işlevsel etiket Yardımcısı ayarlar. 


• Vurgulanan satır öznitelikleri eklemek için sözdizimini gösterir: 












public override void Process(TagHelperContext context J TagHelperOutput output) 

{ 

output.TagName = "a"; // Replaces <email> with <a> tag 

var address = MailTo + + EmailDomain; 

output.Attributes.SetAttributeÇ’href", "mailto:" + address); 
output.Content.SetContent(address); 


Şu anda öznitelikleri koleksiyonda yok sürece bu yaklaşımı "href =" özniteliği için çalışır.Ayrıca 
output.Attributes.Add etiketi yardımcı öznitelik etiketi özniteliklerinin koleksiyonunu sonuna eklemek için 
yöntemi. 

1. Biçimlendirme içinde güncelleştirme Viev/s/Home/Contact.cshtml bu değişikliklerle dosyası: 

ViewData["Title"] = "Contact Copy"; 

} 

<h2>@ViewData["Title"].</h2> 

<h3>@ViewData["Message"]</h3> 

<address> 

One Microsoft Way Copy Version <br /> 

Redmond, WA 98052-6399<br /> 

<abbr title="Phone">P:</abbr> 

425.555.0100 

</address> 

<address> 

<strong>Support:</strongxemail mail-to="Support"></emailxbr /> 

<strong>Marketing: </strongxemail mail-to="Marketing"x/email> 

</address> 


2. Uygulamayı çalıştırın ve doğrulayın, doğru bağlantıları oluşturur. 


NOTE 

E-posta kendi kendine kapanan etiket yazmak için olsaydı ( <email mail-to="Rick" /> ), son Çıkışta aynı zamanda kendi 
kendine kapanan olacaktır. Etiketi yalnızca bir başlangıç etiketiyle ( <email ınail-to=''Rick"> ) yazma özelliğini 
etkinleştirmek için, sınıfı şu şekilde işaretlemeniz gerekir: 

[HtmlTargetElement("email", TagStructure = TagStructure.WithoutEndTag)] 
public class EmailVoidTagHelper : TagHelper 
{ 

private const string EmailDomain = "contoso.com"; 

// Code removed for brevity 


Bir kendi kendine kapanan e-posta etiket Yardımcısı ile çıkış olacaktır <a href="maiıto:Rick@contoso.com" /> . 
Kendi kendine kapanan bağlantı etiketler geçerli HTML oluşturmak istemezsiniz, ancak kendi kendine kapanan 
etiket Yardımcısı oluşturmak isteyebilirsiniz değildir. Etiket Yardımcıları türünü ayarlayın TagMode sonra bir 
etiketi okuma özelliği. 

ProcessAsync 

Bu bölümde, biz bir zaman uyumsuz bir e-posta yardımcı yazacaksınız. 


1. Değiştirin EmaiitagHeiper aşağıdaki kodla sınıfı: 










public class EmailTagHelper : TagHelper 

{ 

private const string EmailDomain = "contoso.com"; 

public override async Task ProcessAsync(TagHelperContext context, TagHelperOutput output) 

{ 

output.TagName = "a"; // Replaces <email> with <a> tag 

var content = await output.GetChildContentAsync(); 

var target = content.GetContent() + + EmailDomain; 

output.Attributes.SetAttribute("href"j "mailto:" + target); 

output.Content.SetContent(target); 

} 


Notlar: 


• 

Bu sürüm, zaman uyumsuz kullanır 

ProcessAsync 

yöntemi. Zaman uyumsuz 


GetChildContentAsync 

döndürür bir 

Task 

içeren 

TagHelperContent 



• Kullanım output parametresi HTML öğesinden içeriği alamadı. 


2. Aşağıdaki değişiklik Views/Home/Contact.cshtml etiketi Yardımcısı hedef e-posta alabilmeniz için dosya. 

ViewData["Title"] = "Contact"; 

} 

<h2>@ViewData["Title"].</h2> 

<h3>@ViewData["Message"]</h3> 

<address> 

One Microsoft Way<br /> 

Redmondj WA 98052<br /> 

<abbr title="Phone">P:</abbr> 

425.555.0100 

</address> 

<address> 

<strong>Support: </strongxemail>Support</emailxbr /> 
<strong>Marketing:</strongxemail>Marl<eting</email> 

</address> 


3. Uygulamayı çalıştırın ve geçerli bir e-posta bağlantılarını oluşturur doğrulayın. 

RemoveAlI ve PreContent.SetHtmlContent PostContent.SetHtmlContent 

1. Aşağıdaki BoldTagHelper sınıfının TagHelpers klasör. 

using Microsoft.AspNetCore.Razor.TagHelpers; 

namespace AuthoringTagHelpers.TagHelpers 

{ 

[HtmlTargetElement(Attributes = "bold")] 
public class BoldTagHelper : TagHelper 
{ 

public override void Process(TagHelperContext context, TagHelperOutput output) 

{ 

output.Attributes.RemoveAlI("bold"); 

output.PreContent.SetHtmlContent("<strong>"); 

output.PostContent.SetHtmlContent("</strong>"); 

} 

} 

} 








• [HtmiTargetElement] Özniteliği belirten bir HTML öznitelik içeren herhangi bir HTML öğesi "bold" 
adlı bir öznitelik parametresi eşleşir, geçişleri ve Process sınıfı yöntemi geçersiz kılma çalışır. Bizim 
örnek içinde Process yöntemi "kalın" özniteliğini kaldırır ve içeren biçimlendirme çevreleyen 

<strongx/strong> . 

• içerik var olan etiket değiştirilecek istemediğinden açılış yazmanız gereken <strong> ile etiketi 


PreContent.SetHtmlContent 

yöntemi ve kapatma 

</strong> 

ile etiketi 

PostContent.SetHtmlContent 


yöntemi. 

2. Değiştirme About.cshtml görünümü içerecek bir bold öznitelik değeri. Tamamlanan kodu aşağıda 
gösterilmiştir. 

ViewData["Title"] = "About"; 

} 

<h2>@ViewData["Title"].</h2> 

<h3>@ViewData["Message"]</h3> 

<p bold>Use this area to provide additional information.</p> 

<bold> Is this bold?</bold> 

3. Uygulamayı çalıştırın. Kaynak inceleyin ve biçimlendirme doğrulamak için sık kullandığınız tarayıcıyı 
kullanabilirsiniz. 

[HtmiTargetElement] Yukarıdaki özniteliği bir öznitelik adı "kalın" sağlayan HTML biçimlendirmesi 
hedefler. <boid> Öğesi etiketi Yardımcısı tarafından değiştirilen değildi. 

4. Açıklama [HtmiTargetElement] özniteliği satır ve varsayılan hedeflemeye <boid> etiketleri, diğer bir 
deyişle, HTML biçimlendirmesi formun <boid> . Unutmayın, varsayılan adlandırma kuralı, sınıf adı eşleşir 
kalıniçin TagHelper <boid> etiketler. 

5. Uygulamayı çalıştırın ve doğrulayın <boid> etiketin, etiket Yardımcısı tarafından işlenir. 

Bir sınıf birden çok dekorasyon [HtmiTargetElement] hedefleri mantıksal-veya sonuçlarını öznitelikleri. Örneğin, 
aşağıdaki kodu kullanarak, kalın bir etiket veya bold özniteliğinin eşleşir. 

[HtmiTargetElement("bold")] 

[HtmlTargetElement(Attributes = "bold")] 
public class BoldTagHelper : TagHelper 
{ 

public override void Process(TagHelperContext context, TagHelperOutput output) 

{ 

output.Attributes.RemoveAll("bold"); 

output.PreContent.SetHtmlContent("<strong>"); 

output.PostContent.SetHtmlContent("</strong>"); 

} 

} 

Birden çok öznitelik için aynı deyimde eklendiğinde, çalışma zamanı bunları bir mantıksal-and davranır Örneğin, 
aşağıdaki kod bir HTML öğesi "bold" adlı bir öznitelik ile "bold" olarak adlandırılmalıdır ( <boid bold /> ) 
eşleştirilecek. 

[HtmlTargetElement("bold ", Attributes = "bold")] 

Ayrıca [HtmiTargetElement] hedeflenen öğesi adını değiştirmek için, isterseniz örneğin BoldTagHelper hedef 
<MyBoid> etiketleri, aşağıdaki öznitelik kullanmanız gerekir: 


























[HtmlTargetElement("MyBold")] 


Etiket Yardımcısı için bir model geçirin 

1. Ekleme bir modelleri klasör. 

2. Aşağıdaki websiteContext sınıfının modelleri klasörü: 

using System; 

namespace AuthoringTagHelpers.Models 

{ 

public class WebsiteContext 

{ 

public Version Version { get; set; } 
public int CopyrightYear { get; set; } 
public bool Approved { get; set; } 
public int TagsToShow { get; set; } 

} 


3. Aşağıdaki websiteinformationTagHeiper sınıfının TagHelpers klasör. 

using System; 

using AuthoringTagHelpers.Models; 

using Microsoft.AspNetCore.Razor.TagHelpers; 

namespace AuthoringTagHelpers.TagHelpers 

{ 

public class WebsiteInformationTagHelper : TagHelper 

{ 

public WebsiteContext Info { get; set; } 

public override void Process(TagHelperContext context, TagHelperOutput output) 

{ 

output.TagName = "section"; 
output.Content.SetHtmlContent( 

$@"<ulxlixstrong>Version:</strong> {Info.Version}</li> 

<lixstrong>Copyright Year:</strong> {Info.CopyrightYear}</li> 

<lixstrong>Approved:</strong> {Info.Approved}</li> 

<lixstrong>Number of tags to show:</strong> {Info.TagsToShow}</lix/ul>"); 
output.TagMode = TagMode.StartTagAndEndTag; 

} 

} 

} 


• Daha önce belirtildiği gibi, etiket yardımcıları, etiket yardımcıları için C# Pascal özellikli sınıf 
adlarını ve özellikleri Kebab örneğineçevirir. Bu nedenle, kullanılacak websiteinformationTagHeiper 
Razor içinde yazacaksınız <website-information /> . 


• Açıkça hedef öğeyi tanımlayan değil [HtmiTargetElement] özniteliği, bunu varsayılan 

website-information hedeflenir. Aşağıdaki özniteliği (kebab durum geçerli değildir ama sınıfın 
adıyla eşleşen unutmayın) uygulandığında: 



özniteliği, aşağıda gösterildiği gibi kebab çalışması kullanmanız: 














[HtmlTargetElement("Website-Information")] 

• Kendi kendine kapanan öğeler hiçbir içeriğe sahip. Bu örnekte, bir kendi kendine kapanan etiketi 
Razor işaretlemesi kullanır, ancak etiketi Yardımcısı oluşturma bir bölümü öğesi (hangi kendi 
kendine kapanan değildir ve içeriği yazıyorsanız section öğesi). Bu nedenle, ayarlanacak 
ihtiyacınız TagMode için startTagAndEndTag çıkışını yazmak için. Satır ayarını WMl'ya alternatif 
olarak, yorum TagMode ve bir kapatma etiketi ile işaretleme yazma. (Daha sonra Bu öğreticide 
örnek biçimlendirme sağlanır.) 

• $ (Dolar işareti) dosyasında aşağıdaki satırı kullanan bir ilişkilendirilmiş bir dizedir: 

$@"<ulxlixstrong>Version: </strong> {Info.Version}</li> 

4. için aşağıdaki işaretlemeyi ekleyin About.cshtml görünümü. Vurgulanan biçimlendirme web site bilgilerini 
görüntüler. 

@using AuthoringTagHelpers.Models 

@{ 

ViewData["Title"] = "About"; 

WebsiteContext webContext = new WebsiteContext { 

Version = new Version(l, 3), 

CopyrightYear = 1638, 

Approved = true, 

TagsToShow = 131 }; 

} 

<h2>@ViewData["Title"].</h2> 

<h3>@ViewData["Message"]</h3> 

<p bold>Use this area to provide additional Information.</p> 

<bold> Is this bold?</bold> 

<h3> web site info </h3> 

<website-information info="webContext" /> 


NOTE 

Aşağıda gösterilen Razor biçimlendirme içinde: 

<website-information info="webContext" /> 

Razor bilir info özniteliği bir sınıf, bir dize değil ve C# kodu yazmak istediğiniz. Herhangi bir dize olmayan etiketi 
yardımcı öznitelik olmadan yazılmalıdır @ karakter. 


5. Uygulamayı çalıştırın ve web sitesi bilgileri görmek için hakkında görünümüne gidin. 


NOTE 

Aşağıdaki biçimlendirme bir kapatma etiketi ile kullanın ve içeren satırı Kaldır TagMode.StartTagAndEndTag etiketi 
Yardımcısı'nda: 


<website-information info="webContext" > 
</website-information> 













Koşul etiketi Yardımcısı 

True değeri geçirildiğinde çıkış koşulu etiket Yardımcısı işler. 

1. Aşağıdaki conditionTagHelper sınıfının TagHelpers klasör. 

using Microsoft.AspNetCore.Razor.TagHelpers; 

namespace AuthoringTagHelpers.TagHelpers 

{ 

[HtmlTargetElement(Attributes = nameof(Condition))] 
public class ConditionTagHelper : TagHelper 
{ 

public bool Condition { get; setj } 

public override void Process(TagHelperContext context, TagHelperOutput output) 

{ 

if (ICondition) 

{ 

output.SuppressOutput(); 

} 

} 

} 

} 

2. Öğesinin içeriğini değiştirin V İews/H o m e/l n d ex.cshtml aşağıdaki işaretlemeyle dosyası: 


@using AuthoringTagHelpers.Models 
@model WebsiteContext 

@{ 

ViewData["Title"] = "Home Page"; 

} 

<div> 

<h3>Information about our website (outdated):</h3> 

<Website-InforMation info="Model" /> 

<div condition^"Model.Approved"> 

<P> 

This website has <strong surround="em">@Model.Approved</strong> been approved yet. 
Visit www.contoso.com for more information. 

</p> 

</div> 

</div> 


3. Değiştirin index yönteminde Home aşağıdaki kodla denetleyicisi: 

public IActionResult Index(bool approved = false) 

{ 

return View(new WebsiteContext 

{ 

Approved = approved, 

CopyrightYear = 2015, 

Version = new Version(l, 3, 3, 7), 

TagsToShow = 20 

}); 


4. Uygulamayı çalıştırın ve giriş sayfasına göz atın. Koşullu biçimlendirmeyi div işlenmez. Sorgu dizesini 


?approved=true 

URL'sine (örneğin, 

http://localhost:1235/Home/Index?approved=true 

). 

approved 


TRUE olarak ve koşullu biçimlendirme görüntülenir. 










NOTE 

Kullanım nameof işleci ile kalın etiket Yardımcısı yaptığınız gibi dize belirtme yerine hedef özniteliğe belirtmek için: 

[HtmlTargetElement(Attributes a nameof(Condition))] 

// [HtmlTargetElement(Attributes = "condition")] 
public class ConditionTagHelper : TagHelper 

{ 

public bool Condition { get; set; } 

public override void Pnocess(TagHelperContext context, TagHelperOutput output) 

{ 

if (ICondition) 

{ 

output.SuppressOutput(); 

} 

} 

} 

Nameof işleci korumak kod hiç olmadığı kadar yeniden (biz adını değiştirmek de isteyebilirsiniz Redcondition ). 


Etiket Yardımcısı çakışmaları 

Bu bölümde, otomatik bağlama etiket Yardımcıları çifti yazın. İlk biçimlendirme içeren bir HTML yer işareti 
etiketi aynı URL'yi içeren (ve bu nedenle bağlantı URL'si sonuçlanmıyor) HTTP ile başlayan bir URL yerini alır, 
ikinci aynı WWW ile başlayan bir URL yapar. 

Bu iki Yardımcıları yakından ilgili ve gelecekte yeniden çünkü bunların aynı dosyada saklayacağız. 

1. Aşağıdaki AutoLinkerHttpTagHelper sınıfının TagHelpers klasör. 

[HtmlTargetElement("p")] 

public class AutoLinkerHttpTagHelper : TagHelper 

{ 

public override async Task ProcessAsync(TagHelperContext context, TagHelperOutput output) 

{ 

var childContent = await output.GetChildContentAsync(); 

// Find Urls in the content and replace them with their anchor tag equivalent. 
output.Content.SetHtmlContent(Regex.Replace( 
childContent.GetContent (), 

@"\b(?:https?://)(\S+)\b", 

"<a target=\"_blank\" href=\"$0\">$0</a>")); // http link version} 

} 

} 


NOTE 

AutoLinkerHttpTagHelper Sınıfı hedefler p öğeleri ve kullanıyor Regex bağlantı oluşturmak için. 


2. Sonuna aşağıdaki işaretlemeyi ekleyin Views/Home/Contact.cshtml dosyası: 







ViewData["Title"] = "Contact"; 

} 

<h2>@ViewData["Title"].</h2> 

<h3>@ViewData["Message"]</h3> 

<addness> 

One Microsoft Way<br /> 

Redmondj WA 98052<br /> 

<abbr title="Phone">P:</abbr> 

425.555.0100 

</address> 

<address> 

<strong>Support: </strongxemail>Support</emailxbr /> 
<strong>Marketing:</strongxemail>Marketing</email> 
</address> 

<p>Visit us at http://docs.asp.net or at www.microsoft.com</p> 


3. Uygulamayı çalıştırın ve etiket Yardımcısı bağlantı doğru şekilde işlediğinden emin olun. 

4. Güncelleştirme AutoLinker içerecek şekilde sınıfı AutoLinkerwwwTagHeiper hangi www metne dönüştürme 
ayrıca orijinal www metni içeren bir yer işareti etiketi. Güncelleştirilmiş kod aşağıda vurgulanır: 

[HtmlTargetElement("p")] 

public class AutoLinkerHttpTagHelper : TagHelper 

{ 

public override async Task ProcessAsync(TagHelperContext context, TagHelperOutput output) 

{ 

var childContent = await output.GetChildContentAsync(); 

// Find Urls in the content and replace them with their anchor tag equivalent. 
output.Content.SetHtmlContent(Regex.Replace( 
childContent.GetContent (), 

@"\b(?:https?://)(\S+)\b", 

"<a target=\"_blank\" href=\"$0\">$0</a>")); // http link version} 

} 

} 

[HtmlTargetElement("p")] 

public class AutoLinkerWwwTagHelper : TagHelper 

{ 

public override async Task ProcessAsync(TagHelperContext context, TagHelperOutput output) 

{ 

var childContent = await output.GetChildContentAsync(); 

// Find Urls in the content and replace them with their anchor tag equivalent. 
output.Content.SetHtmlContent(Regex.Replace( 
childContent.GetContent()j 
@"\b(www\.)(\S+)\b", 

"<a target=\"_blank\" href=\"http://$0\">$0</a>")); // www version 

} 

} 

} 


5. Uygulamayı çalıştırın. Www metin bağlantı olarak işlenir ancak HTTP metin değil dikkat edin. Her iki 
sınıflarda kesme noktası koymak, HTTP etiket Yardımcısı sınıfı ilk çalıştığını görebilirsiniz. Etiket 
Yardımcısı çıkışı önbelleğe alınır ve WWW etiketi Yardımcısı çalıştırdığınızda, önbelleğe alınan HTTP 
etiketi Yardımcısı çıktısı üzerine yazar sorunudur. Etiket Yardımcıları Çalıştır sırasını denetlemek nasıl 
öğreticinin ilerleyen bölümlerinde göreceğiz. Kodu aşağıdakiler ile gidereceğiz: 







public class AutoLinkerHttpTagHelper : TagHelper 

{ 

public override async Task ProcessAsync(TagHelperContext context, TagHelperOutput output) 

{ 

var childContent = output.Content.IsModified ? output.Content.GetContent() : 

(await output.GetChildContentAsync()).GetContent(); 

// Find Urls in the content and replace them with their anchor tag equivalent. 
output.Content.SetHtmlContent(Regex.Replace( 
childContent , 

@"\b(?:https?://)(\S+)\b"j 

"<a target=\"_blank\" href=\"$0\">$0</a>")); // http link version} 

} 

} 

[HtmlTargetElement("p")] 

public class AutoLinkerWwwTagHelper : TagHelper 

{ 

public override async Task ProcessAsync(TagHelperContext context, TagHelperOutput output) 

{ 

var childContent = output.Content.IsModified ? output.Content.GetContent() : 

(await output.GetChildContentAsync()).GetContent(); 

// Find Urls in the content and replace them with their anchor tag equivalent. 
output. Content. SetFItmlContent (Regex. Replace ( 
childContent , 

@"\b(www\.)(\S+)\b", 

"<a target=\"_blank\" href=\"http://$0\">$0</a>")); // www version 

} 

} 


NOTE 

Otomatik bağlama etiket Yardımcıları, ilk sürümünde, aşağıdaki kod ile hedef içeriğini alındı: 

var childContent = await output.GetChildContentAsync()j 

Diğer bir deyişle, çağırma GetChildContentAsync kullanarak TagHelperOutput yöntemlere geçirilen 
ProcessAsync yöntemi. Belirtildiği gibi daha önce çıktıyı önbelleğe alındığından, son etiket WINS çalışmasına 
yardımcı. Aşağıdaki kod ile ilgili sorun düzeltildi: 

var childContent = output.Content.IsModified ? output.Content.GetContent() : 

(await output.GetChildContentAsync()).GetContent()j 

Yukarıdaki kod içeriği değiştirildi ve varsa, çıkış arabellek içeriği alır olup olmadığını denetler. 


6. Uygulamayı çalıştırın ve iki bağlantı beklendiği gibi çalıştığını doğrulayın. Bizim otomatik bağlayıcı etiket 
Yardımcısı doğru ve eksiksiz görünebilir, ancak ince bir sorun var. WWW etiketi Yardımcısı ilk 
çalıştırıyorsa, www bağlantıları doğru olmayacaktır. Ekleyerek kodu güncelleştirmeniz order etiket 
çalışan sırasını denetlemek için aşırı yükleme, order Özelliği aynı öğeye hedefleyen diğer etiket 
Yardımcıları göre yürütme sırasını belirler. Varsayılan sıra değeri sıfırdır ve düşük değerler örnekleriyle 
önce yürütülür. 









public class AutoLinkerHttpTagHelper : TagHelper 

{ 

// This filter must run befone the AutoLinkerWwwTagHelper as it searches and replaces http and 
// the AutoLinkerWwwTagHelper adds http to the markup. 
public override int Order 
{ 

get { return int.MinValue; } 

} 

Yukarıdaki kod, HTTP etiketi Yardımcısı önce WWW etiketi Yardımcısı çalıştığını garanti eder. Değişiklik 
order için Maxvaiue ve WWW etiketi için oluşturulmuş biçimlendirmeyi yanlış olduğundan emin olun. 

Alt içeriği almak ve İnceleme 

Etiket Yardımcıları içerik almak için çeşitli özellikler sağlar. 

• Sonucu GetChildContentAsync eklenerek output.Content . 

• Sonucu inceleyebilirsiniz GetChildContentAsync ile GetContent . 

• Değiştirirseniz output.Content , TagHelper gövdesi olmaz yürütülen veya siz işlenen GetChildContentAsync 
otomatik bağlayıcı örneğimizi olduğu gibi: 


public class AutoLinkerHttpTagHelper : TagHelper 

{ 

public override async Task ProcessAsync(TagHelperContext context, TagHelperOutput output) 

{ 

var childContent = output.Content.IsModified ? output.Content.GetContent() : 

(await output.GetChildContentAsync()).GetContent(); 

// Find Urls in the content and replace them with their anchor tag equivalent. 
output.Content.SetHtmlContent(Regex.Replace( 
childContent, 

@"\b(?:https?://)(\S+)\b", 

"<a target=\"_blank\" href=\"$0\">$0</a>")); // http link version} 

} 

} 

• Birden çok çağrılar GetChildContentAsync aynı değeri döndürür ve yeniden yürütülmez TagHelper önbelleğe 
alınan sonuç kullanmayı gösteren yanlış parametre geçirmezseniz gövde. 

Mini yükleme küçük bir kısmı görüntüleme TagHelper 

Üretim ortamlarında, Mini karşılaşılan kısmi görünümler yüklenirken performans artırılabilir. Üretimde 
küçültülmüş kısmi görünümden faydalanmak için: 

• Kısmi görünümleri mini görüntülemesi için derleme öncesi bir işlem oluşturun/ayarlayın. 

• Geliştirme dışı ortamlarda mini kullanılan kısmi görünümleri yüklemek için aşağıdaki kodu kullanın. 



















public class MinifiedVersionPartialTagHelper : PartialTagHelper 

{ 

public MinifiedVersionPartialTagHelper(ICompositeViewEngine viewEngine, 
IViewBufferScope viewBufferScope) 

: base(viewEnginej viewBuffenScope) 

{ 

} 

public ovenride Task ProcessAsync(TagHelperContext contextj TagHelperOutput output) 

{ 

// Append ".min" to load the minified partial view. 
if (!IsDevelopment()) 

{ 

Name += ".min"; 

} 

retunn base.ProcessAsync(context, output); 

} 


} 


private bool IsDevelopment() 

{ 


} 


return Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT") 

== EnvironmentName.Development; 



ASPNET Core formlardaki etiket yardımcıları 
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By Rick Anderson, N. Taylor Mullen, Davve Patııve Jerrie Pelser 

Bu belge, formlarda ve genellikle form üzerinde kullanılan HTML öğeleriyle çalışmayı gösterir. HTML form öğesi, 
Web uygulamalarının sunucuya veri geri göndermek için kullanacağı birincil mekanizmayı sağlar. Bu belgenin 
çoğunda Etiket Yardımcıları ve BUNLARıN güçlü HTML formları oluşturma konusunda nasıl yardımcı olabilecekleri 
açıklanmaktadır. Bu belgeyi okuyabilmeniz İçin yardımcıları etiketleyerek okumanız önerilir. 

Birçok durumda, HTML Yardımcıları belirli bir etiket Yardımcısı için alternatif bir yaklaşım sağlar, ancak bu etiket 
yardımcıların HTML yardımcılarını değiştirmez ve her HTML Yardımcısı için bir etiket Yardımcısı olmadığını bilmek 
önemlidir. Bir HTML Yardımcısı alternatifi varsa, bu, bahsedilir. 

Form etiketi Yardımcısı 

Form etiketi Yardımcısı: 

• MVC denetleyicisi eylemi veya adlandırılmış yol için HTML <FORM > action öznitelik değeri oluşturur 


• Siteler arası istek yasaklamasını engellemek için gizli bir İstek doğrulama belirteci ÜRETİR (http post eylem 



Örnek: 

<form asp-controller="Demo" asp-action="Register" method="post"> 
<!-- Input and Submit elements --> 

</form> 


Yukarıdaki form etiketi Yardımcısı aşağıdaki HTML 'yi oluşturur: 



oluşturur. Bir saf HTML formunun siteler arası istek sahteciliğini önleme 'den korunması zordur, form etiketi 
Yardımcısı bu hizmeti sizin için sağlar. 

Adlandırılmış yol kullanma 


asp-route 

Tag Helper özniteliği, HTML 

action 

özniteliği için de biçimlendirme oluşturabilir. 

register 


uygulama, kayıt sayfası için aşağıdaki biçimlendirmeyi kullanabilir: 






















<form asp-route="register" method="post"> 
<!-- Input and Submit elements --> 
</form> 


Görünümler/hesap klasöründeki görünümlerin birçoğu ( bireysel kullanıcı hesaplarıylayenl bir Web uygulaması 
oluşturduğunuzda oluşturulur), ASP-Route-ReturnUrl özniteliğini içerir: 

<form asp-controllen="Account" asp-action="Login" 
asp-route-returnurl="@ViewData["Returnllrl"]" 
method="post" class="form-horizontal" role="form"> 


NOTE 

Yerleşik şablonlarla returniiri , yalnızca yetkili bir kaynağa erişmeye çalıştığınızda ancak kimliği doğrulanmamış veya 
yetkilendirilmeyen otomatik olarak doldurulur. Yetkisiz erişim yapmaya çalıştığınızda, güvenlik ara yazılımı sizi neturnuri 
kümesi ile oturum açma sayfasına yönlendirir. 


Form eylemi etiketi Yardımcısı 


Form eylemi etiketi Yardımcısı, formaction özniteliği oluşturulan <button ...> veya cinput type="image" ...> 


etiketi üzerinde oluşturur. 

formaction 

özniteliği bir formun verilerini nereden gönderdiğini denetler. 

image 

ve 

<düğme > öğeleri <giriş 

> öğelerine 

bağlanır. Form eylemi etiketi Yardımcısı, karşılık gelen öğe için 

formaction 


bağlantısının oluşturulduğunu denetlemek için birkaç AnchorTagHelper asp- özniteliği kullanımını sağlar, 
formaction değerini denetlemek için desteklenen AnchorTagHelper öznitelikleri: 


ÖZNITELIK 

AÇIKLAMA 

ASP-Controller 

Denetleyicinin adı. 

ASP-eylem 

Eylem yönteminin adı. 

ASP-alanı 

Alanın adı. 

asp-sayfa 

Razor sayfasının adı. 

ASP-Page-Handler 

Razor sayfası işleyicisinin adı. 

ASP-Route 

Rotanın adı. 

ASP-Route-{Value} 

Tek bir URL yol değeri. Örneğin: asp-route-id="i 234 " . 

ASP-Ali- Route- Data 

Tüm rota değerleri. 

ASP-Fragment 

URL parçası. 


Denetleyiciye gönder örneği 

Aşağıdaki biçimlendirme, giriş veya düğme seçildiğinde formu HomeControiler 


index eylemine gönderir: 














cform method="post"> 

<button asp-controller="Hom 0 ” asp-action="Index">Click Me</button> 
<input type="image" src="..." alt="Or Click Me" asp-controller="Home" 

asp-action="Index"> 

</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/Home">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" formaction="/Home"> 
</form> 


Sayfa örneğine gönder 

Aşağıdaki biçimlendirme formu About Razor sayfasına gönderir: 

<form method="post"> 

<button asp-page="About">Click Me</button> 

cinput type="image" src="...“ alt="Or Click Me" asp-page="About"> 
</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/About">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" formaction="/About"> 
</form> 


Yönlendirme örneğine gönder 

/Home/Test uç noktasını göz önünde bulundurun: 

public class HomeController : Controller 

{ 

[Route("/Home/Test", Name = "Custom")] 
public string Test() 

{ 

return "This is the test page"; 

} 

} 

Aşağıdaki biçimlendirme formu /Home/Test uç noktasına gönderir. 

<form method="post"> 

<button asp-route="Custom">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" asp-route="Custom"> 
</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/Home/Test">Click Me</button> 

cinput type="image" snc="..." alt="Or Click Me" formaction="/Home/Test"> 
</form> 











Giriş etiketi Yardımcısı 

Giriş etiketi Yardımcısı, bir HTML <girişi > öğesini Razor görünüminizdeki bir model ifadesine bağlar. 

Sözdizimi: 

cinput asp-for="<Expression Name>"> 

Giriş etiketi Yardımcısı: 

• asp-for özniteliğinde belirtilen ifade adı için id ve name HTML özniteliklerini üretir. 
asp-for="Propertyl.Property2" m => m.Propertyl.Property2 eşdeğerdir, ifadenin adi, asp-for Öznitelİği 

değeri için kullanılan şeydir. Ek bilgi için ifade adları bölümüne bakın. 

• Model özelliğine uygulanan model türüne ve veri ek açıklaması ÖZNİTELİKLERINE göre HTML type 
öznitelik değerini ayarlar 

• Belirtilirse, HTML type öznitelik değerinin üzerine yazmaz 

• Model özelliklerine uygulanan veri ek açıklama özniteliklerinden HTML5 doğrulama öznitelikleri oluşturur 

• Htmi.TextBoxFor ve Htmi.EditorFor bir HTML Yardımcısı özelliği örtüşüyor. Ayrıntılar için bkz. giriş etiketi 
Yardımcısı İçin HTML Yardımcısı alternatifleri. 

• Güçlü yazma sağlar.Özelliğin adı değişirse ve etiket yardımcısını güncelleştirmezseniz aşağıdakine benzer bir 
hata alırsınız: 



ve oluşturulan HTML türü listelenmekte (her .NET türü listelenmemiştir). 


.NET TÜRÜ 

GİRİŞ türü 

Bool 

Type = "onay kutusu" 

Dize 

Type = "metin" 

DateTime 

Type ="TarihSaat-yerel' 

Bayt 

Type = "Number" 

int 

Type = "Number" 

Tek, Çift 

Type = "Number" 


Aşağıdaki tabloda, giriş etiketi Yardımcısı 'nın belirli giriş türleriyle eşleşecağı bazı ortak veri ek açıklamaları (her 
doğrulama özniteliğı listelenmez) gösterilmektedir: 












OZNITELIK 


GİRİŞ TURU 


EmailAddress 

Type = "e-posta" 

'Deki 

Type = "URL" 

[Hiddenınput] 

Type = "Hidden" 

Numarası 

Type = "tel" 

[DataType (DataType. Password)] 

Type = "Passvvord" 

[DataType (DataType. Date)] 

Type = "Date" 

[DataType (DataType. Time)] 

yazın = "Time" 


Örnek: 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class RegisterViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 

[Required] 

[DataType(DataType.Password)] 
public stning Password { get; set; } 

} 

} 


@model RegisterViewModel 

<form asp-controller="Demo" asp-action="RegisterInput" method="post"> 
Email: <input asp-for="Email" /> <br /> 

Password: cinput asp-fon="Password" /><bn /> 

<button type="submit">Registen</button> 

</fonm> 


Yukarıdaki kod, aşağıdaki HTML 'yi oluşturur: 

<fonm method="post" action="/Demo/RegistenInput"> 

Email: 

<input type="email" data-val="tnue" 

data-val-email="The Email Addness field is not a valid email address." 
data-val-required="The Email Address field is required." 
id="Email" name="Email" value=""xbr> 

Password: 

cinput type="password" data-val="true" 

data-val-required="The Password field is required." 
id="Password" name="Password"xbr> 
cbutton type="submit">Register</button> 

cinput name="_RequestVerificationToken" type="hidden" value="cremoved for brevity>"> 

c/form> 




Email ve Passwond özelliklerine uygulanan veri ek açıklamaları modelde meta veriler oluşturur. Giriş etiketi 
Yardımcısı, model meta verilerini kullanır ve HTM L5 data-vai-* öznitelikleri üretir (bkz. model doğrulama). Bu 
öznitelikler, giriş alanlarına iliştirilecek Doğrulayıcıları anlatmaktadır. Bu unobtrusive HTML5 vejQuery doğrulaması 
sağlar. Unobtrusive özniteliklerinin biçimi data-vai-ruie="Error Message" , burada kural doğrulama kuralının adıdır 
(örneğin, data-val-required , data-val-email , data-val-maxlength vb.) Öznitelikte bir hata iletisi sağlanırsa, 
data-vai-rule özniteliği için değer olarak görüntülenir. Ayrıca, kuralla ilgili ek ayrıntılar sağlayan 
data-val-ruleName-argumentName="argumentValue" form Öznitelikleri de vardır, Örneğin, 
data-val-maxlength-max="1024" . 

Giriş etiketi Yardımcısı için HTML Yardımcısı alternatifleri 

Htmi.TextBox , Htmi.TextBoxFor , Htmi.Editör ve Htmi.EditorFor , giriş etiketi Yardımcısı ile çakışan özelliklere 


sahiptir. Giriş etiketi Yardımcısı 

type 

özniteliğini otomatik olarak ayarlar; 

Htmi.TextBox 

ve 

Htmi.TextBoxFor 


Htmi.Editör 

ve 

Htmi.EditorFor 

■ tanıtıcı koleksiyonları, karmaşık nesneler ve şablonlar; Giriş etiketi Yardımcısı yok. 

Giriş etiketi Yardımcısı, Htmi.EditorFor ve Htmi.TextBoxFor kesin türdedir (lambda ifadeleri kullanırlar); 

Html.TextBox 

ve 

Htmi.Editör ı 

değildir (ifade adlarını kullanırlar). 


HtmlAttributes 

@Htmi.Editor() ve @Htmi.EditorFor( ), varsayılan şablonlarını yürütürken htmiAttributes adlı özel bir 
viewDataDictionary girişi kullanır. Bu davranış, isteğe bağlı olarak additionaiviewData parametreleri kullanılarak 
genişletilebilir. "HtmlAttributes" anahtarı büyük/küçük harfe duyarlıdır."HtmlAttributes" anahtarı, @Htmi.TextBox() 
gibi giriş yardımcılarını geçirilmiş htmiAttributes nesnesine benzer şekilde işlenir. 

@Html.EditorFor(model => model.YourProperty, 

new { htmiAttributes = new { @class="myCssClass ", style="Width:100px" } }) 

İfade adları 

asp-for öznitelik değeri, bir lambda ifadesinin bir ModeiExpression ve sağ tarafıdır. Bu nedenle, 
asp-for="Propertyi" oluşturulan kodda m => m.Propertyi hale gelir ve bu nedenle Model ile önek gerektirmez. 
karakterini kullanarak bir satır içi ifadeyi başlatabilir ve m. önce taşıyabilirsiniz: 

@{ 

var joe = "Doe"; 

} 

<input asp-for="@joe"> 


Şunları üretir: 


cinput type="text" id="joe" name="joe" value="loe"> 


Koleksiyon özellikleriyle 

asp-for="CollectionProperty[23].Member" , 

asp-for="CollectionProperty[i].Member" 

aynı adı üretir. 


i değer 23 olduğunda 


ASP.NET Core MVC ModeiExpression değerini hesapladığında Modeistate dahil olmak üzere çeşitli kaynakları 
inceler, cinput type="text" asp-for="@Name"> göz önünde bulundurun. Hesaplanan value özniteliği, öğesinden 
gelen ilk null olmayan değerdir: 


• "Name" anahtarına sahip giriş Modeistate. 

• İfadenin sonucu Model.Name . 


Alt özelliklerde gezinme 

Ayrıca, görünüm modelinin özellik yolunu kullanarak alt Özellikler 1 e gidebilirsiniz. Alt Address özelliği içeren daha 
karmaşık bir model sınıfı düşünün. 











































public class AddressViewModel 

{ 

public string AddressLinel { get; set; } 

} 


public class RegisterAddressViewModel 

{ 

public string Email { get; set; } 

[DataType(DataType.Password)] 
public string Password { get; set; } 

public AddressViewModel Address { get; set; } 

} 

Görünümde Address.AddressLinei bağlandık: 


@model RegisterAddressViewModel 

<form asp-controller="Demo" asp-action="RegisterAddress" method="post"> 
Email: <input asp-for="Email" /> <br /> 

Password: <input asp-for="Password" /><br /> 

Address: <input asp-for="Address.AddressLinel" /><br /> 

<button type="submit">Register</button> 

</form> 


Address.AddressLinei için aşağıdaki HTML oluşturulmuştur: 

<input type="text" id="Address_AddressLinel" name="Address.AddressLinel" value=""> 


İfade adları ve koleksiyonlar 

Örnek, bir dizi colors içeren bir modeldir: 

public class Person 

{ 

public List<string> Colors { get; set; } 
public int Age { get; set; } 

} 

Eylem yöntemi: 


public IActionResult Edit(int id, int colorIndex) 

{ 

ViewData["Index"] = colorIndex; 
return View(GetPerson(id)); 

} 


Aşağıdaki Razor, belirli bir color öğesine nasıl erişistediğinizi göstermektedir: 











@model Person 

@{ 

var index = (int)ViewData["index"]; 

} 

<form asp-controller="ToDo" asp-action="Edit" method="post"> 
@Html.EditorFor(m => m.Colors[index]) 
dabel asp-for="Age"x/label> 

<input asp-for="Age" /><br /> 

<button type="submit">Post</button> 

</form> 


Views/Shared/EdltorTemplates/Strlng. cshtml şablonu: 

@model string 

<label asp-for="@Model"x/label> 

<input asp-for="@Model" /> <br /> 

List<T > kullanarak örnek: 


public class ToDoltem 

{ 

public string Name { get; set; } 
public bool IsDone { get; set; } 

} 


Aşağıdaki Razor, bir koleksiyonun üzerinde nasıl yineleme yapılacağını göstermektedir: 

@model List<ToDoItem> 

<form asp-controller="ToDo" asp-action="Edit" method="post"> 

<table> 

<tr> <th>Name</th> <th>Is Done</th> </tr> 

@for (int i = 0; i < Model.Count; i++) 

{ 

<tr> 

@Html.EditorFor(model => modelfi]) 

</tr> 

} 

</table> 

<button type="submit">Save</button> 

</form> 


Views/Shared/EditorTemplates/Todoltem. cshtml şablonu: 




@model ToDoltem 
<td> 

<label asp-for="@Model.Name"x/label> 

@Html.DisplayFor(model = > model.Name) 

</td> 

<td> 

cinput asp-fon="@Model.IsDone" /> 

</td> 

This template replaces the following Razor which evaluates the indexer three tlmes. 

<td> 

<label asp-for="@Model[i] .Name"x/label> 

@Html.DisplayFor(model => model[i].Name) 

</td> 

<td> 

<input asp-for="@Model[i].IsDone" /> 

</td> 

*@ 

değer bir asp-for veya Htmi.DisplayFor denk bir bağlamda kullanılacaksa, mümkünse foreach kullanılmalıdır. 
Genel olarak, for bir Numaralandırıcı ayırması gerekmiyorsa, foreach daha iyidir (senaryo buna izin veriyorsa). 
Ancak, bir LINQ ifadesinde bir dizin oluşturucuyu değerlendirmek pahalı olabilir ve simge durumuna küçültülmüş 
olmalıdır. 


NOTE 

Yukarıdaki açıklamalı örnek kod, listedeki her bir ToDoltem erişmek için lambda ifadesinin @ işleçle nasıl değiştirileceğini 
gösterir. 


TextArea etiketi Yardımcısı 

Textarea Tag Helper Tag Yardımcısı giriş etiketi Yardımcısı ile benzerdir. 

• id ve name özniteliklerini ve <textarea > öğesi için modelden veri doğrulama özniteliklerini üretir. 

• Güçlü yazma sağlar. 

• HTML Yardımcısı alternatifi: Htmi.TextAreaFor 
Örnek: 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class DescriptionViewModel 

{ 

[MinLength(S) ] 

[MaxLength(1024)] 

public stning Description { get; set; } 

} 

} 













@model DescriptionViewModel 

<form asp-controller="Demo" asp-action="RegisterTextArea" method="post"> 
<textarea asp-for="Description"x/textarea> 

<button type="submit">Test</button> 

</form> 


Aşağıdaki HTML oluşturulur: 

<form method="post" action="/Demo/RegisterTextArea"> 

<textarea data-val="true" 

data-val-maxlength="The field Description must be a string or array type with a maximum length of 
&#x27;1024&#x27;." 

data-val-maxlength-max="1024" 

data-val-minlength="The field Description must be a string or array type with a minimum length of 
&#x27;5&#x27; 

data-val-minlength-min="5" 

id="Description" name="Description") 

</textarea> 

<button type="submit">Test</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Etiket etiketi Yardımcısı 

• Bir ifade adı için bir <label > öğesinde etiket başlık yazısı ve for özniteliği oluşturur 

• HTML Yardımcısı alternatifi: Htmi.LabeiFor . 

Label Tag Helper , saf HTML etiket öğesi üzerinde aşağıdaki avantajları sağlar: 

• Display özniteliğinden açıklayıcı etiket değerini otomatik olarak alırsınız, istenen görünen ad zaman içinde 
değişebilir ve Display özniteliği ve etiket etiketi Yardımcısı 'nın birleşimi, Display her yere uygular. 

• Kaynak kodunda daha az biçimlendirme 

• Model özelliğiyle güçlü yazma. 

Örnek: 


using System.ComponentModel.DataAnnotations; 


namespace FormsTagHelper.ViewModels 

{ 


public class SimpleViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 

} 










@model SimpleViewModel 

<fonm asp-controller="Demo" asp-action="Registerl_abel" method="post"> 

<label asp-fon="Email"x/label> 

<input asp-for="Email" /> <br /> 

</form> 

<iabei> öğesi için aşağıdaki HTML oluşturulur: 

dabel for="Email">Email Address</label> 

Etiket etiketi Yardımcısı, <input> öğesiyle ilişkili KİMLİK olan "e-posta" for öznitelik değerini oluşturdu. Etiket 
Yardımcıları, doğru ilişkilendirilebilen şekilde tutarlı id ve for öğeleri oluşturur. Bu örnekteki başlık Display 
özniteliğinden gelir. Modelde bir Display özniteliği yoksa, başlık ifadenin Özellik adı olacaktır. 

Doğrulama etiketi yardımcıları 

iki doğrulama etiketi yardımcıları vardır, validation Message Tag Helper (modelinizdeki tek bir özellik için bir 
doğrulama iletisi görüntüler) ve validation summary Tag Helper (doğrulama hatalarının özetini görüntüler), 
input Tag Helper , model sınıflarınızda bulunan veri ek açıklaması özniteliklerini temel alan giriş öğelerine HTML5 
istemci tarafı doğrulama öznitelikleri ekler. Doğrulama de sunucuda gerçekleştirilir. Doğrulama etiketi Yardımcısı, 
bir doğrulama hatası oluştuğunda bu hata iletilerini görüntüler. 

Doğrulama İletisi etiketi Yardımcısı 

• Belirtilen model özelliğinin giriş alanındaki doğrulama hatası mesajlarını bağlayan span öğesine HTML5 
data-vaimsg-for="property" özniteliğini ekler, istemci tarafı doğrulama hatası oluştuğunda, jöuery <span> 

öğesinde hata iletisini görüntüler. 

• Doğrulama de sunucuda gerçekleşir, istemciler JavaScript devre dışı bırakılmış olabilir ve bazı doğrulamalar 
yalnızca sunucu tarafında yapılabilir. 

• HTML Yardımcısı alternatifi: Html.ValidationMessageFor 

validation Message Tag Helper , bir HTML span öğesinde asp-validation-for özniteliğiyle kullanılır. 

<span asp-validation-for="Email"></span> 

Doğrulama İletisi etiketi Yardımcısı aşağıdaki HTML 'yi oluşturur: 

<span class="field-validation-valid" 
data-valmsg-for="Email" 
data-valmsg-replace="true"x/span> 

Aynı özellik için bir input etiketi Yardımcısı sonrasında validation Message Tag Helper genellikle kullanırsınız. 
Bunun yapılması, hataya neden olan girişin yakınında herhangi bir doğrulama hata iletisi görüntüler. 


NOTE 

İstemci tarafı doğrulaması için doğru JavaScript ve jQuery betik başvurularını içeren bir görünümsiniz olmalıdır. Daha fazla bilgi 
için bkz. model doğrulaması . 


Sunucu tarafı doğrulama hatası oluştuğunda (örneğin, özel sunucu tarafı doğrulamadan veya istemci tarafı 
doğrulaması devre dışı bırakılmışsa), MVC bu hata iletisini <span> öğesinin gövdesi olarak koyar. 




















<span class="field-validation-error" data-valmsg-for="Email" 
data-valmsg-replace="true"> 

The Email Address field is required. 

</span> 


Doğrulama Özeti etiketi Yardımcısı 

• asp-validation-summary özniteliği olan öğeleri <div> hedefleri 

• HTML Yardımcısı alternatifi: @Html.ValidationSummary 

Validation Summary Tag Helper , doğrulama iletilerinin Özetini göstermek için kullanılır, asp-validation-summary 
öznitelik değeri, aşağıdakilerden herhangi biri olabilir: 

ASP-DOĞRULAMA-ÖZET GÖRÜNEN DOĞRULAMA İLETİLERİ 

ValidationSummary. Ali Özellik ve model düzeyi 

Yalnızca ValidationSummary. model Model 

ValidationSummary. None Yok. 

Örnek 

Aşağıdaki örnekte, veri modelinde <input> öğesinde doğrulama hata iletileri üreten DataAnnotation öznitelikleri 
vardır. Doğrulama hatası oluştuğunda, doğrulama etiketi Yardımcısı şu hata iletisini görüntüler: 

using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class RegisterViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 

[Required] 

[DataType(DataType.Password)] 
public string Password { get; set; } 

} 

} 


@model RegisterViewModel 

<form asp-controller="Demo" asp-action="RegisterValidation" method="post"> 
<div asp-validation-summary="ModelOnly"x/div> 

Email: <input asp-for="Email" /> <br /> 

<span asp-validation-for="Email"x/spanxbr /> 

Password: <input asp-for="Password" /xbr /> 

<span asp-validation-for="Password"x/spanxbr /> 

<button type="submit">Register</button> 

</form> 


Oluşturulan HTML (model geçerli olduğunda): 











<form action="/DemoReg/Register" method="post"> 

<div class="validation-summary-valid" data-valmsg-summary="true"> 

<ulxli style="display: none"x/lix/ulx/div> 

Email: cinput name="Email" id="Email" type="email" value="" 
data-val-required="The Email field is required." 
data-val-email="The Email field is not a valid email address." 
data-val="true"xbr> 

<span elass="field-validation-valid" data-valmsg-replace="true" 
data-valmsg-fon=" Email "x/spanxbr> 

Password: <input name="Password" id="Password" type="password" 
data-val-required="The Password field is required." data-val="true"xbr> 

<span elass="field-validation-valid" data-valmsg-replace="true" 
data-valmsg-fon="Password"x/spanxbn> 

<button type="submit">Registen</button> 

cinput name="_RequestVerificationToken" type="hidden" value="<removed fon brevity>"> 

</fonm> 


Etiket Seç Yardımcısı 

• Modelinizin özellikleri için Select ve ilişkili seçenek öğeleri oluşturur. 



Örneğin: 


<select asp-for="Country" asp-items="Model.Countries"x/select> 


Örnek: 


using Microsoft.AspNetCone.Mvc.Rendering; 
using System.Collections.Generic; 

namespace FonmsTagHelpen.ViewModels 

{ 

public elass CountryViewModel 

{ 

public stning Country { get; set; } 

public List<SelectListItem> Countnies { get; } = new List<SelectListItem> 

{ 

new SelectListltem { Value = "MX", Text = "Mexico" }j 

new SelectListltem { Value = "CA", Text = "Canada" }j 

new SelectListltem { Value = "US", Text = "USA" }, 

}; 

} 

} 


index yöntemi countnyviewModei başlatır, seçilen ülkeyi ayarlar ve index görünümüne geçirir. 

public IActionResult Index() 

{ 

var model = new CountryViewModel(); 
model.Country = "CA"; 
return View(model); 

} 


HTTP POST index yöntemi seçimi görüntüler: 













[HttpPost] 

[ValidateAntiForgeryToken] 

public IActionResult Index(CountryViewModel model) 

{ 

if (ModelState.IsValid) 

{ 

var msg = model.Country + " selected"; 

return RedirectToAction("IndexSuccess", new { message = msg }); 

} 

// If we got this far, something failed; redlsplay form, 
return View(model); 


index görünümü: 


@model CountryViewModel 

<form asp-controller="Home" asp-action="Index" method="post"> 

<select asp-for="Country" asp-items="Model .Countries"x/select> 
<br /><button type="submit">Register</button> 

</form> 


Aşağıdaki HTML 'yi üreten ("CA" seçiliyken): 


<form method="post" action="/"> 

<select id="Country" name="Country"> 

<option value="MX">Mexico</option> 

coption selected="selected" value="CA">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


NOTE 

Etiket Seç Yardımcısı ile viewBag veya viewData kullanmanızı önermiyoruz. Bir görünüm modeli, MVC meta verileri 
sağlamaya ve genellikle daha az soruna neden olacak daha sağlamdır. 


asp-for öznitelik değeri özel bir durumdur ve Model öneki gerektirmez, diğer etiket Yardımcısı öznitelikleri olur ( 
asp-items gibi) 

<select asp-for="Country" asp-items="Model.Countries"x/select> 


Sabit Listesi bağlama 

<seiect> , enum bir özellik ile kullanmak ve enum değerlerinden selectListitem öğeleri oluşturmak için 
kullanışlıdır. 


Örnek: 









public class CountryEnumViewModel 

{ 

public CountryEnum EnumCountry { get; set; } 

} 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public enum CountryEnum 

{ 

[Display(Name = "United Mexican States")] 
Mexico, 

[Display(Name = "United States of America")] 
USA, 

Canada, 

France, 

Germany, 

Spain 

} 

} 


GetEnumSelectList yöntemi bir numaralandırma için selectList nesnesi oluşturur. 

@model CountryEnumViewModel 

<form asp-controller="Home" asp-action="IndexEnum" method="post"> 

<select asp-for="EnumCountry" 

asp-items="Html.GetEnumSelectList<CountryEnum>()"> 

</select> 

<br /><button type="submit">Register</button> 

</form> 

Daha zengin bir kullanıcı arabirimi almak için, Numaralandırıcı listenizi Display özniteliğiyle işaretleyebilirsiniz: 

using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public enum CountryEnum 

{ 

[Display(Name = "United Mexican States")] 

Mexico, 

[Display(Name = "United States of America")] 

USA, 

Canada, 

France, 

Germany, 

Spain 

} 

} 


Aşağıdaki HTML oluşturulur: 






<form method="post" action="/Home/IndexEnum"> 

<select data-val="true" data-val-required="The EnumCountry field is required." 
id="EnumCountry" name="EnumCountry"> 

<option value="0">United Mexican States</option> 

<option value="l">United States of America</option> 

<option value="2">Canada</option> 

<option value="3">France</option> 
coption value="4">Germany</option> 

<option selected="selected" value="5">Spain</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Seçenek grubu 

HTML <SeçenekGrubu > öğesi, görünüm modelinde bir veya daha fazla selectListGroup nesnesi içerdiğinde 
oluşturulur. 

countryviewModeiGroup , selectListitem öğelerini "Kuzey Amerika" ve "Avrupa" gruplarına gruplandırır: 






public class CountryViewModelGroup 

{ 

public CountryViewModelGroup() 

{ 

var NorthAmericaGroup = new SelectListGroup { Name = "North America" }; 
var EuropeGroup = new SelectListGroup { Name = "Europe" }; 

Countries = new List<SelectListItem> 

{ 

new SelectListltem 

{ 

Value = "MEX", 

Text = "Mexico", 

Group = NorthAmericaGroup 

}, 

new SelectListltem 

{ 

Value = "CAN", 

Text = "Canada", 

Group = NorthAmericaGroup 

b 

new SelectListltem 

{ 

Value = "US", 

Text = "USA", 

Group = NorthAmericaGroup 

b 

new SelectListltem 

{ 

Value = "FR", 

Text = "France", 

Group = EuropeGroup 

b 

new SelectListltem 

{ 

Value = "ES", 

Text = "Spain", 

Group = EuropeGroup 

b 

new SelectListltem 

{ 

Value = "DE", 

Text = "Germany", 

Group = EuropeGroup 

} 

b 

} 

public string Country { get; set; } 

public List<SelectListItem> Countries { get; } 


iki grup aşağıda gösterilmiştir: 
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Oluşturulan HTML: 


<form method="post" action="/Home/IndexGroup"> 

<select id="Country" name="Country"> 

<optgroup label="North America"» 

coption value="MEX">Mexicoc/option> 

<option value="CAN">Canada</option> 
coption value="US">USA</option> 

</optgroup> 

coptgroup label="Europe"> 

coption value="FR">Francec/option> 
coption value="ES">Spainc/option> 
coption value="DE">Germanyc/option> 
c/optgroup> 
c/select> 

cbr /»cbutton type="submit">Registerc/button> 

cinput name="_RequestVerificationToken" type="hidden" value="cremoved for brevity>"> 

c/form> 


Çoklu seçim 

asp-for özniteliğinde belirtilen özellik bir iEnumerabie ise, select etiketi Yardımcısı otomatik olarak birden çok = 
"Muitiple" özniteliği oluşturacaktır. Örneğin, aşağıdaki model verildiğinde: 


using Microsoft.AspNetCore.Mvc. Rendering; 
using System.Collections.Generic; 

namespace FormsTagHelper.ViewModels 

{ 

public class CountryViewModelIEnumerable 

{ 

public IEnumerablecstring» CountryCodes { get; set; } 

public ListcSelectListltem» Countries { get; } = new ListcSelectListltem» 

{ 

new SelectListltem { Value = "MX", Text = "Mexico" }, 

new SelectListltem { Value = "CA", Text = "Canada" }j 

new SelectListltem { Value = "US", Text = "USA" }, 

new SelectListltem { Value = "FR", Text = "France" }, 

new SelectListltem { Value = "ES", Text = "Spain" }, 

new SelectListltem { Value = "DE", Text = "Germany"} 

}; 

} 

} 


Aşağıdaki görünümle: 












@model CountryViewModelIEnumerable 

<form asp-controller="Home" asp-action="IndexMultiSelect" method="post"> 
<select asp-for="CountryCodes" asp-items="Model.Countries"x/select> 
<br /><button type="submit">Register</button> 

</form> 


Aşağıdaki HTML 'yi oluşturur: 

<form method="post" action="/Home/IndexMultiSelect"> 

<select id="CountryCodes" 
muitiple="muitiple" 

name="CountryCodes"xoption value="MX">Mexico</option> 

<option value="CA">Canada</option> 

<option value="US">USA</option> 

<option value="FR">France</option> 

<option value="ES">Spain</option> 

<option value="DE">Germany</option> 

</select> 

<br /xbutton type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Seçim yok 

Birden çok sayfada "belirtilmemiş" seçeneğini kullanarak kendinizi bulursanız, HTML 'yi yinelemeyi ortadan 
kaldırmak için bir şablon oluşturabilirsiniz: 

@model CountryViewModel 

<form asp-controller="Home" asp-action="IndexEmpty" method="post"> 

@Fltml. EditorForModel() 

<br /xbutton type="submit">Register</button> 

</form> 


Vİews/Shared/EditorTemplates/CountryVievvModel, cshtml şablonu: 

@model CountryViewModel 

<select asp-for="Country" asp-items="Model.Countr'ies"> 

<option value="">--none--</option> 

</select> 


HTML <seçenek > öğeleri ekleme hiçbir seçim durumuyla sınırlı değildir. Örneğin, aşağıdaki görünüm ve eylem 
yöntemi yukarıdaki koda benzer HTML oluşturur: 


public IActionResult IndexNone() 

{ 

var model = new CountryViewModel(); 
model.Insert(0j new SelectListItem("<none>", 


return Vlew(model); 

} 









@model CountryViewModel 

<form asp-controller="Home" asp-action="IndexEmpty" method="post"> 

<select asp-for="Country"> 

<option value="">&lt;none&gt;</option> 
coption value="MX">Mexico</option> 

<option value="CA">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

</form> 

Geçerli country değerine bağlı olarak doğru <option> öğesi seçilecek ( seiected="seiected" özniteliğini içerir). 

public IActionResult IndexOption(int id) 

{ 

var model = new CountryViewModel(); 
model.Country = "CA"; 
return View(model); 

} 


<form method="post" action="/Home/IndexEmpty"> 

<select id="Country" name="Country"> 

<option value="">&lt;none&gt;</option> 

<option value="MX">Mexico</option> 

<option value="CA" selected="selected">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Ek kaynaklar 

• ASP.NET Core etiket yardımcıları 

• HTML form öğesi 

• istek doğrulama belirteci 

• ASP.NET Core'de model bağlama 

• ASP.NET Core MVC 'de model doğrulaması 

• lattributeadapter arabirimi 

• Bu belge için kod parçacıkları 







ASPNET Core içindeki etiket Yardımcısı bileşenleri 

6.12.2019 • 8 minutes to read ı Edit Online 


Scott Ade ve fiyaz bin haşan tarafından 

Etiket Yardımcısı bileşeni, sunucu tarafı kodundan HTML öğelerini koşullu olarak değiştirmenize veya eklemenize 
olanak sağlayan bir etiket yardımcıdır. Bu özellik AS P.N ET Core 2,0 veya üzeri sürümlerde kullanılabilir. 

ASP.NET Core iki yerleşik etiket Yardımcısı bileşeni içerir: head ve body . 

Microsoft.AspNetCore.Mvc.Razor.TagHelpers ad alanında konumlanır ve hem MVC hem de Razor Pages 
kullanılabilir. Etiket Yardımcısı bileşenleri _Viewlmports. cshtml'de uygulamayla kayıt gerektirmez. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Uygulama alanları 

Etiket Yardımcısı bileşenlerinin iki yaygın kullanım durumu şunlardır: 


<head> 

bir 

<link> 

ekleme. 

<body> bir 

<script> 

ekleme. 


Aşağıdaki bölümlerde bu kullanım durumları açıklanır. 

HTML Head öğesine Ekle 

HTML <head> öğesinin içinde, CSS dosyaları genellikle HTML <iink> öğesiyle içeri aktarılır. Aşağıdaki kod head 
etiketi Yardımcısı bileşenini kullanarak bir <ünk> öğesini <head> öğesine çıkartır: 

using System; 

using System.Threading.Tasks; 

using Microsoft.AspNetCore.Razon.TagHelpens; 

namespace RazorPagesSample.TagHelpers 
{ 

public class AddressStyleTagHelperComponent : TagHelperComponent 
{ 

private readonly string _style = 

@"<link rel=""stylesheet"" href=""/css/address.css"" />"; 

public override int Order => 1; 

public override Task ProcessAsync(TagHelperContext context, 

TagHelperOutput output) 

{ 

if (string.Equals(context.TagName, "head", 

StringComparison.OrdinalIgnoreCase)) 

{ 

output.PostContent.AppendHtml(_style); 

} 

return Task.CompletedTask; 

} 

} 

} 

Yukarıdaki kodda: 


AddressStyleTagHelperComponent TagHelperComponentuygular. Soyutlama: 














o TagHelperContextile sınıfın başlatılmasına izin verir. 

o HTML öğeleri eklemek veya değiştirmek için etiket Yardımcısı bileşenlerinin kullanılmasını sağlar. 

• Order özelliği, bileşenlerin işlendiği sırayı tanımlar, bir uygulamada birden çok etiket Yardımcısı bileşeni 
kullanımı olduğunda order gereklidir. 

• ProcessAsync, yürütme bağlamının TagName özellik değerini head karşılaştırır. Karşılaştırma true olarak 
değerlendirilirse, _styie alanının içeriği HTML <head> öğesine eklenir. 


HTML Body öğesine Ekle 

body Tag yardımcı bileşeni <body> öğesine bir <script> öğesi ekleyebilir. Aşağıdaki kod bu tekniği 
göstermektedir: 


using System; 

using System.10; 

using System.Thneading.Tasks; 

using Microsoft.AspNetCore.Razor.TagHelpers; 


namespace RazorPagesSample.TagHelpers 
{ 

public class AddressScriptTagHelperComponent : TagHelperComponent 
{ 

public override int Order => 2; 


} 


public override async Task ProcessAsync(TagHelperContext context, 

TagHelperOutput output) 


{ 


if (string.Equals(context.TagName, "body", 

StringComparison.OrdinalIgnoreCase)) 


{ 


var script = await File.ReadAllTextAsync( 

"TagHelpers/Templates/AddressToolTipScript.html"); 
output.PostContent.AppendHtml(script); 


} 


} 


<script> öğesini depolamak için ayrı bir HTM L dosyası kullanılır. HTM L dosyası, kod temizleyici ve daha 
sürdürülebilir hale gelir. Önceki kod TagHelpers/Templates/AddressToolTipScript.html içeriğini okur ve etiket 
Yardımcısı çıktısına ekler. Addresstooltipscript. html dosyası aşağıdaki biçimlendirmeyi içerir: 


<script> 

$("address[printable]").hover(function() { 
î(this).attr({ 

"data-toggle": "tooltip", 

"data-placement": "right", 

"title": "Home of Microsoft!" 

}); 

}); 

</script> 

Yukarıdaki kod, bir önyükleme araç ipucu pencere öğesini bir printable özniteliği içeren herhangi bir <address> 
öğesine bağlar. Bir fare işaretçisi öğenin üzerine geldiğinde efekt görünür. 


Bir bileşeni kaydetme 

Uygulamanın etiket Yardımcısı bileşenleri koleksiyonuna bir etiket Yardımcısı bileşeni eklenmelidir. Koleksiyona 
eklemenin üç yolu vardır: 


• Hizmetler kapsayıcısı aracılığıyla kayıt 













• Razor dosyası aracılığıyla kayıt 

• Sayfa modeli veya denetleyici aracılığıyla kaydolma 

Hizmetler kapsayıcısı aracılığıyla kayıt 

Etiket Yardımcısı bileşen sınıfı ITagHelperComponentManagerile yönetilmemişse, bağımlılık ekleme (dı) sistemine 
kaydedilmelidir. Aşağıdaki Startup.ConfigureServices kod, AddressStyleTagHelperComponent ve 
AddressScriptTagHelperComponent sınıflarını geçici bir yaşam süresinekaydeder: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.Nonej 

}); 

Services. AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_l); 

Services.AddTransient<ITagHelperComponentj 
AddressScriptTagHelperComponent>(); 

Services.AddTransient<ITagHelperComponentj 
AddressStyleTagHelperComponent>(); 

} 

Razor dosyası aracılığıyla kayıt 

Etiket Yardımcısı bileşeni, Dİ ile kayıtlı değilse, bir Razor Pages sayfasından veya bir MVC görünümünden kayıt 
olabilir. Bu teknik, eklenen biçimlendirmeyi ve bir Razor dosyasından bileşen yürütme sırasını denetlemek için 
kullanılır. 

iTagHelperComponentManager etiket Yardımcısı bileşenleri eklemek veya uygulamadan kaldırmak için kullanılır. 
Aşağıdaki kod, AddressTagHelperComponent ile bu tekniği gösterir: 

@using RazorPagesSample.TagHelpers; 

@using Microsoft.AspNetCore.Mvc.Razor.TagHelpers; 

(Şinject İTagHelperComponentManager manager; 

@{ 

string markup; 

if (Model.IsİAİeekend) 

{ 

markup = "<em class='text-warning'>Office closed today!</em>"; 

} 

else 

{ 

markup = "<em class='text-info'»Office öpen today!</em>"; 

} 

manager.Components.Add(new AddressTagHelperComponent(markupj 1)); 

} 

Yukarıdaki kodda: 

• @inject yönergesi İTagHelperComponentManager örneğini sağlar. Örnek, Razor dosyasındaki erişim yönündeki 
manager adlı bir değişkene atanır. 

• Uygulamanın etiket Yardımcısı bileşenleri koleksiyonuna bir AddressTagHelperComponent örneği eklenir. 
AddressTagHelperComponent, markup ve order parametrelerini kabul eden bir oluşturucuya uyacak şekilde 











değiştirilmiştir: 


private readonly string _markup; 
public override int Order { get; } 

public AddressTagHelperComponent(string markup = int order = 1) 

{ 

_markup = markup; 

Order = order; 

} 

Belirtilen markup parametresi ProcessAsync içinde aşağıdaki gibi kullanılır: 

public override async Task ProcessAsync(TagHelperContext context, 

TagHelperOutput output) 

{ 

if (string.Equals(context.TagName, "address", 

StringComparison.OrdinalIgnoreCase) && 
output.Attributes.ContainsName("printable")) 

{ 

TagHelperContent childContent = await output.GetChildContentAsync(); 
string content = childContent.GetContent(); 
output.Content.SetHtmlContent( 

$"<div>{content}<br>{_markup}</div>{_printableButton}"); 

} 


Sayfa modeli veya denetleyici aracılığıyla kaydolma 

Etiket Yardımcısı bileşeni, Dİ ile kayıtlı değilse, bir Razor Pages sayfa modelinden veya bir MVC denetleyicisinden 
kaydedilebilir. Bu teknik, Razor dosyalarından mantık C# ayırmak için faydalıdır. 

iTagHelperComponentManager örneğine erişmek için Oluşturucu ekleme kullanılır. Etiket Yardımcısı bileşeni, örneğin 
etiket Yardımcısı bileşenleri koleksiyonuna eklenir. Aşağıdaki Razor Pages sayfa modelinde bu teknik 
AddressTagHelperComponent gösterilmektedir: 







using System; 

using Microsoft.AspNetCore.Mvc.Razor.TagHelpers; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using RazorPagesSample.TagHelpers; 

public class IndexModel : PageModel 

{ 

private readonly ITagHelperComponentManager _tagHelperComponentManager; 


public bool IsWeekend 

{ 

get 

{ 

var dayOfWeek = DateTime.Now.DayOfWeek; 


} 


} 


return dayOfİAİeek == DayOfWeek.Saturday | 
dayOfl/Jeek == DayOfWeek.Sunday; 


public IndexModel(ITagHelperComponentManager tagHelperComponentManager) 

{ 

_tagHelperComponentManager = tagHelperComponentManager; 

} 


public void OnGet() 

{ 

string markup; 

if (Isl/Jeekend) 

{ 

markup = "<em class='text-warning'>Office closed today!</em>"; 

} 

else 

{ 

markup = "<em class='text-info’>Office öpen today!</em>"; 

} 


} 


} 


tagHelperComponentManager.Components.Add( 
new AddressTagHelperComponent(markupj 1)); 


Yukarıdaki kodda: 

• ITagHelperComponentManager örneğine erişmek için Oluşturucu ekleme kullanılır. 

• Uygulamanın etiket Yardımcısı bileşenleri koleksiyonuna bir AddressTagHelperComponent örneği eklenir. 

Bileşen oluşturma 

Özel bir etiket Yardımcısı bileşeni oluşturmak için: 

• TagHelperComponentTagHelpertüreten bir ortak sınıf oluşturun. 

• Sınıfa bir [HtmiTargetElement] özniteliği uygulayın. Hedef HTML öğesinin adını belirtin. 

• İsteğe bağU: türün IntelliSense 'de görüntülenmesini engellemek için sınıfa bir 

[EditorBrowsable(EditorBrowsableState.Never)] Özniteliği uygulayın. 

Aşağıdaki kod, <address> HTML öğesini hedefleyen özel bir etiket Yardımcısı bileşeni oluşturur: 








using System.ComponentModel; 

using Microsoft.AspNetCore.Mvc.Razor.TagHelpers; 
using Microsoft.AspNetCore.Razor.TagHelpers; 
using Microsoft.Extensions.Logging; 

namespace RazorPagesSample.TagHelpers 

{ 

[HtmlTargetElement("address")] 

[EditorBrowsable(EditorBrowsableState.Never)] 

public class AddressTagHelperComponentTagHelper : TagHelperComponentTagHelper 

{ 

public AddressTagHelperComponentTagHelper( 

ITagHelperComponentManager componentManager, 

ILoggerFactory loggerFactory) : base(componentManager, loggerFactory) 

{ 

} 

} 

} 

HTML işaretlemesini aşağıdaki gibi eklemek için özel address Tag yardımcı bileşenini kullanın: 

public class AddressTagHelperComponent : TagHelperComponent 

{ 

private readonly string _printableButton = 

"cbutton type='button' class='btn btn-info' onclick=\"window.open(" + 

"' https://binged.it/2AXRRYw' )\">" + 

"<span class='glyphicon glyphicon-road' aria-hidden='true'></span>" + 

"</button>"; 

public override int Order => 3; 

public override async Task ProcessAsync(TagHelperContext context, 

TagHelperOutput output) 

{ 

if (string.Equals(context.TagName, "address", 

StringComparison.OrdinalIgnoreCase) && 
output.Attributes.ContainsName("printable")) 

{ 

var content = await output.GetChildContentAsync(); 
output.Content.SetHtmlContent( 

$"<div>{content.GetContent()}</div>{_printableButton}"); 

} 

} 

} 

Yukarıdaki ProcessAsync yöntemi, eşleşen <address> öğesine SetHtmlContent için belirtilen HTML'yi çıkarır. 
Ekleme şu durumlarda oluşur: 

• Yürütme bağlamının TagName Özellik değeri address eşittir. 

• Karşılık gelen <address> öğesi printable bir özniteliğe sahip. 

Örneğin, aşağıdaki <address> öğesi işlenirken if deyiminin doğru sonucu verilmiştir: 

<address printable> 

One Microsoft Way<br /> 

Redmond, WA 98052-6399<br /> 

<abbr title="Phone">P:</abbr> 

425.555.0100 

</address> 














Ek kaynaklar 

• ASP.NET Core bağımlılık ekleme 

• ASP.NET core'da görünümlere bağımlılık ekleme 

• ASP.NET Core yerleşik etiket Yardımcıları 



ASPNET Core 'de bağlayıcı etiketi Yardımcısı 

15.10.2019 • 10 minutes to read z. Edit Online 


By Peter Keilner ve Scott Ade 

Tutturucu etiketi Yardımcısı, yeni öznitelikler ekleyerek standart HTML bağlayıcısı ( <a ... ></a> ) 
etiketini geliştirir. Kurala göre, öznitelik adlarına önek olarak asp- eklenir, işlenmiş bağlayıcı 
öğesinin href öznitelik değeri, asp- özniteliklerinin değerleriyle belirlenir. 

Etiket Yardımcıları 'na genel bakış için bkz. ASP.NET Core etiket yardımcıları. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Speakercontroller bu belgenin tamamında örneklerde kullanılır: 

using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using System.Linq; 

public class SpeakerController : Controller 

{ 

private List<Speaker> Speakers = 
new List<Speaker> 

{ 

new Speaker {Speakerld = 10}, 

new Speaker {Speakerld = 11}, 

new Speaker {Speakerld = 12} 

}; 

[Route("Speaker/{id:int}")] 

public IActionResult Detail(int id) => 

View(Speakers.FirstOrDefault(a => a.Speakerld == id)); 

[Route("/Speaker/Evaluations ", 

Name = "speakerevals")] 
public IActionResult Evaluations() => View(); 

[Route("/Speaker/EvaluationsCurrent", 

Name = "speakerevalscurrent")] 
public IActionResult Evaluations( 
int speakerld, 

bool currentYear) => View(); 
public IActionResult Index() => View(Speakers); 

} 

public class Speaker 

{ 

public int Speakerld { get; set; } 

} 


Tutturucu etiketi yardımcı öznitelikleri 

ASP-Controller 

ASP-Controller ÖZNITELIĞI, URL oluşturmak için kullanılan denetleyiciyi atar.Aşağıdaki 
biçimlendirme tüm hoparlörleri listeler: 









<a asp-controller="Speaker" 

asp-action="Index">All Speakers</a> 

Oluşturulan HTML: 

<a href="/Speaker">All Speakers</a> 

@No__t-0 özniteliği belirtilirse ve asp-action değilse, varsayılan asp-action değeri, yürütülmekte 
olan görünüm ile ilişkili denetleyici eylemi olur. @No__t-0 önceki işaretten atlanırsa ve bağlayıcı 
etiketi Yardımcısı HomeController'm Dizin görünümünde {/Home) kullanılırsa, oluşturulan HTML: 

<a href="/Home">All Speakers</a> 

ASP-eylem 

ASP-Action öznitelik değeri, oluşturulan href özniteliğinde bulunan denetleyici eylemi adını 
temsil eder. Aşağıdaki biçimlendirme oluşturulan href öznitelik değerini konuşmacı 
değerlendirmeleri sayfasına ayarlar: 

<a asp-controller="Speaker" 

asp-action="Evaluations">Speaker Evaluations</a> 

Oluşturulan HTML: 

<a href="/Speaker/Evaluations">Speal<er Evaluations</a> 

@No__t-0 özniteliği belirtilmezse, geçerli görünümü yürüten görünümü çağıran varsayılan 
denetleyici kullanılır. 

@No__t-0 öznitelik değeri index ise, URL'ye hiçbir eylem eklenmez ve bu, varsayılan index 
eyleminin çağrılması için önde gelen bir eylem yoktur. Belirtilen eylem (veya varsayılan olarak) 
asp-controiler ' da başvurulan denetleyicide var olmalıdır. 

ASP-Route-{Value} 

ASP-Route-{Value} özniteliği bir joker karakter yolu öneki sunar. @No__t-0 yer tutucusunu 
kullanan herhangi bir değer olası bir yol parametresi olarak yorumlanır. Varsayılan bir yol 
bulunmazsa, bu yol öneki, bir istek parametresi ve değeri olarak oluşturulan href özniteliğine 
eklenir. Aksi takdirde, yol şablonunda değiştirilir. 

Aşağıdaki denetleyici eylemini göz önünde bulundurun: 

public IActionResult AnchorTagHelper(int id) 

{ 

var speaker = new Speaker 
{ 

Speakerld = id 

}; 

return View(speaker); 

} 


Başlangıçta tanımlanmış varsayılan bir yol şablonuyla . Yapılandir. 

















app.UseMvc(routes => 

{ 

// need route and attribute on controllen: [Anea("Blogs")] 
routes.MapRoute(name: "mvcAreaRoute ", 

template: "{area:exists}/{controller=Home}/{action=Index}"); 

// default route for non-areas 
routes.MapRoute( 

name: "default ", 

template: "{controller=Home}/{action=Index}/{id?}"); 

}); 


MVC görünümü, aşağıdaki gibi eylem tarafından belirtilen modeli kullanır: 


@model Speaker 
<!DOCTYPE html> 

<html> 

<body> 

<a asp-controller="Speaker" 
asp-action="Detail" 

asp-route-id="@Model.SpeakerId">SpeakerId: @Model.SpeakerId</a> 

</body> 

</html> 

Varsayılan yolun {id?} yer tutucusu eşleşti. Oluşturulan HTML: 

<a href="/Speaker/Detail/12">Speaker!d: 12</a> 


Aşağıdaki MVC görünümünde olduğu gibi, yol ön ekinin eşleşen yönlendirme şablonunun bir 
parçası olmadığını varsayın: 

@model Speaker 
<!DOCTYPE html> 

<html> 

<body> 

<a asp-controller="Speaker" 
asp-action="Detail" 

asp-route-speakerid="@Model.SpeakerId">SpeakerId: @Model.Speakerld</a> 

<body> 

</html> 

Eşleşen rotada speakerid bulunamadığı için aşağıdaki HTML oluşturuldu: 

<a href="/Speaker/Detail?speakerid=12">SpeakerId: 12</a> 

@No__t-0yada asp-action belirtilmemişse, asp-route özniteliğinde olduğu gibi aynı varsayılan 
işleme de olur. 

ASP-Route 

ASP-Route özniteliği, doğrudan adlandırılmış bir yola bağlanan bir URL oluşturmak için kullanılır. 
Yönlendirme özniteliklerinikullanarak, bir yol speakerControiler ' de gösterildiği gibi 
adlandırılabilir ve Evaluations eyleminde kullanılır: 













[Route("/Speaker/Evaluations ", 

Name = "speakerevals") ] 
public IActionResult Evaluations() => View(); 

Aşağıdaki biçimlendirmede, asp-route özniteliği adlandırılmış yola başvurur: 

<a asp-route="speakerevals">Speaker Evaluations</a> 


Tutturucu etiketi Yardımcısı, /Hoparlörker/değerlendirmeleriURİ 'sini kullanarak bu denetleyiciye 
doğrudan bir yol oluşturur. Oluşturulan HTML: 



öznitelikleriyle kullanılmamalıdır. 

ASP-AII-Route-Data 

ASP-AII-Route-Data özniteliği, anahtar-değer çiftleri sözlüğü oluşturmayı destekler.Anahtar 
parametre adıdır ve değer parametre değeridir. 

Aşağıdaki örnekte, bir sözlük başlatılmış ve Razor görünümüne geçirilir. Alternatif olarak, veriler 
modelinize iletilebilir. 


@{ 

var parms = new Dictionarycstring., string> 

{ 

{ "speakerld", "11" }, 

{ "currentYear ", "true" } 

}; 

} 

<a asp-route="speakerevalscurrent" 

asp-all-route-data="parms">Speaker Evaluatlons</a> 


Yukarıdaki kod, aşağıdaki HTML 'yi oluşturur: 

<a href="/Speaker/EvaluationsCurrent?speakerId=ll&currentYear=true">Speaker Evaluations</a> 

@No__t-0 sözlüğü, aşırı yüklenmiş Evaluations eyleminin gereksinimlerini karşılayan bir 
QueryString oluşturmak üzere düzleştirilir: 

[Route("/Speaker/EvaluationsCurrent", 

Name = "speakerevalscurrent")] 
public IActionResult Evaluations( 
int speakerld, 

bool currentYear) => View(); 


Sözlükteki herhangi bir anahtar yol parametreleriyle eşleşiyorsa, bu değerler rotada uygun şekilde 
değiştirilir. Diğer eşleşme olmayan değerler istek parametreleri olarak oluşturulur. 

ASP-Fragment 

ASP-Fragment özniteliği URL 'ye eklenecek URL parçasını tanımlar.Tutturucu etiketi Yardımcısı, 













karma karakterini (#) ekler. Aşağıdaki biçimlendirmeyi göz önünde bulundurun: 


<a asp-controller="Speaker" 
asp-action="Evaluations" 

asp-fragment="SpeakerEvaluations">Speaker Evaluations</a> 

Oluşturulan HTML: 

<a href="/Speaker/Evaluations#SpeakerEvaluations">Speaker Evaluations</a> 

Karma Etiketler, istemci tarafı uygulamalar oluşturulurken faydalıdır.JavaScript 'te kolay 
işaretlemek ve aramak için kullanılabilirler. 

ASP-alanı 

ASP-Area özniteliği, uygun yolu ayarlamak için kullanılan alan adını ayarlar. Aşağıdaki örneklerde 
asp-area özniteliğinin yolların yeniden eşleştirmesine neden olduğu gösterilmektedir. 

Razor Pages kullanımı 

Razor Pages alan ASP.NET Core 2,1 veya sonraki sürümlerde desteklenir. 

Aşağıdaki dizin hiyerarşisini göz önünde bulundurun: 

• {Proje adı} 
o Wwwroot 
o Alanlar 

o Bağlanabilecek 
o Sayfalar 

o _ViewStart. cshtml 
o lndex. cshtml 
o lndex.cshtml.cs 
o Sayfalar 

Oturum alanı dizini Razor sayfasına başvurmak için yapılan biçimlendirme şunlardır: 


<a asp-area="Sessions" 

asp-page="/Index">View Sessions</a> 











MVC 'de kullanım 

Aşağıdaki dizin hiyerarşisini göz önünde bulundurun: 

• {Proje adı} 
o Wwwroot 
o Alanlar 
o Bloglar 

o Denetleyiciler 
o HomeController.es 
o Görünümler 
o Sayfa 

o AboutBlog. cshtml 
o lndex. cshtml 
o _ViewStart, cshtml 

o Denetleyiciler 

@No__t-0 ' i "blogları" olarak ayarlamak, Dizin alanlan/bloglarmı bu tutturucu etiketi için ilişkili 
denetleyicilerin ve görünümlerin yollarına ön ekler. Aboutblog görünümüne başvurmak için 
yapılan biçimlendirme şu şekilde yapılır: 

<a asp-area="Blogs" 

asp-controller="Home" 
asp-action="AboutBlog">About Blog</a> 


Oluşturulan HTML: 


<a href="/Blogs/Home/AboutBlog">About Blog</a> 


TIP 

MVC uygulamasındaki bölgeleri desteklemek için, yol şablonu varsa alana bir başvuru içermelidir. Bu şablon, 
başlangıçta routes.MapRoute yöntem çağrısının ikinci parametresiyle temsil edilir. configure : 

app.UseMvc(routes => 

{ 

// need route and attribute on controller: [Area("Blogs")] 
routes.MapRoute(name: "mvcAreaRoute", 

template: "{area:exists}/{controller=Home}/{action=Index}"); 

// default route for non-areas 
routes.MapRoute( 

name: "default", 

template: "{controller=Home}/{action=Index}/{id?}"); 

}); 


ASP-protokol 

) belirtmek içindir. Örneğin: 

<a asp-protocol="https" 
asp-controller="Home" 
asp-action="About">About</a> 


ASP-Protocol ÖZNITELIĞI, URL 'nize bir protokol (örneğin, https 


Oluşturulan HTML: 










<a href="https://localhost/Home/About">About</a> 

Örnekteki ana bilgisayar adı localhost 'tur.Tutturucu etiketi Yardımcısı, URL oluştururken Web 

sitesinin ortak etki alanını kullanır. 

ASP-ana bilgisayar 

AS P-Hoşt ÖZNİTELİĞİ, URL ' niz için bir ana bilgisayar adı belirtmektir. Örneğin: 

<a asp-protocol="https" 
asp-host="microsoft.com" 
asp-controller="Home" 
asp-action="About">About</a> 


Oluşturulan HTML: 


<a href="https://microsoft.com/Home/About">About</a> 


asp-sayfa 

ASP-Page özniteliği Razor Pages ile kullanılır. Bir bağlayıcı etiketinin href öznitelik değerini belirli 
bir sayfaya ayarlamak için kullanın. Sayfa adının eğik çizgiyle ("/") önek olarak URL 'SI oluşturulur. 

Aşağıdaki örnek, katılımcı Razor sayfasına işaret eder: 

<a asp-page="/Attendee">All Attendees</a> 


Oluşturulan HTML: 

<a href="/Attendee">All Attendees</a> 

@No_t-0 özniteliği, asp-route , asp-controiler ve asp-action öznitelikleriyle birbirini dışlıyor. 

Ancak, aşağıdaki biçimlendirmede gösterildiği gibi asp-page asp-route-{vaiue} ile birlikte 
yönlendirmeyi denetlemek için kullanılabilir: 

<a asp-page="/Attendee" 

asp-route-attendeeid="10">View Attendee</a> 


Oluşturulan HTML: 


<a href="/Attendee?attende0İd=10">View Attendee</a> 


ASP-Page-Handler 

AS P-Page-Handler özniteliği Razor Pages ile birlikte kullanılır. Belirli sayfa işleyicileriyle bağlantı 
için tasarlanmıştır. 

Aşağıdaki sayfa işleyicisini göz önünde bulundurun: 












public void OnGetProfile(int attendeeld) 

{ 

ViewData["AttendeeId"] = attendeeld; 

// code omitted fon brevity 

} 

Sayfa modelinin ilişkili biçimlendirmesi onGetProfile sayfa işleyicisine bağlanır. @No__t-1 
öznitelik değerinde sayfa işleyicisi yöntem adının on<verb> öneki atlandığına göz ardı edin. 
Yöntem zaman uyumsuz olduğunda, Async soneki de atlanır. 

<a asp-page="/Attendee" 

asp-page-handlen="Profile" 

asp-noute-attendeeid="12">Attendee Profile</a> 


Oluşturulan HTML: 

<a href="/Attendee?attendeeid=12&handler=Profile">Attendee Profile</a> 


Ek kaynaklar 

• ASP.NET Core bölgeler 

• ASP.NET Core Razor Pages giriş 

• ASP.NET Core MVC için uyumluluk sürümü 









Önbellek etiketi Yardımcısı, ASPNET Core MVC 

12.07.2019 • 7 minutes to read ^ Edit Online 


Tarafından Peter Kellnerve Luke Latham 

Önbellek etiketi Yardımcısı iç AS P.N ET Core önbelleği sağlayıcısı için içeriği önbelleğe alarak AS P.N ET Core 
uygulamanızı performansını olanağı sağlar. 

Etiket Yardımcıları genel bakış için bkz. AS P.N ET Core etiket yardımcıları. 

Aşağıdaki Razor biçimlendirme, geçerli tarihi önbelleğe alır: 

<cache>@DateTime.Now</cache> 

Etiket Yardımcısını içeren sayfasında ilk isteği, geçerli tarihi görüntüler.(Varsayılan 20 dakika) önbelleğe süresi 
dolana kadar veya önbellekten önbelleğe alınan tarih veriler çıkarıldığında kadar ek isteklerin önbelleğe alınan 
değeri gösterilir. 

Önbellek etiketi Yardımcısı öznitelikleri 

Etkin 

ÖZNITELIK TÜRÜ ÖRNEKLER VARSAYILAN 

Boole değeri true , false true 

enabled Önbellek etiketi Yardımcısı tarafından alınmış içeriği önbelleğe alınmış belirler.Varsayılan, true 
değeridir. Varsa kümesine false , işlenmiş çıktı değil önbelleğe alınmış. 

Örnek: 

ccache enabled="true"> 

Current Time inside Cache Tag Helper: @DateTime.Now 
</cache> 

süresi dolmadan açma 

ÖZNITELIK TÜRÜ ÖRNEK 


DateTimeOffset 


@new DateTime(2025 J l J 29 J 17,02.,0) 


expires-on önbelleğe alınan öğe için bir mutlak sona erme tarihi ayarlar. 

Aşağıdaki örnek, 17:02:00 29 Ocak 2025 üzerinde kadar önbellek etiketi Yardımcısı içeriğini önbelleğe alır: 

ccache expires-on="@new DateTime(2025,l J 29 J 17 J 02 J 0)"> 

Current Time inside Cache Tag Helper: @DateTime.Now 
</cache> 


süresi dolduktan sonra 














OZNITELIK TURU 


ÖRNEK 


VARSAYILAN 


TimeSpan 


@TimeSpan.FromSeconds(120) 20 dakika 


expires-after içeriği önbelleğe almak için ilk isteği zamanından sürenin uzunluğunu ayarlar. 


Örnek: 


ccache expires-after="@TimeSpan.FromSeconds(120)"> 

Current Time inside Cache Tag Helper: @DateTime.Now 
</cache> 

Razor görüntüleme motorunu varsayılan ayarlar expires-after yirmi dakika değeri. 

süresi dolmadan kayan 

ÖZNITELIK TÜRÜ ÖRNEK 


TimeSpan 


@TimeSpan.FromSeconds(60) 


Değerini erişilmeyen, önbellek girişi çıkarılacak süreyi ayarlar. 
Örnek: 


<cache expires-sliding="@TimeSpan.FromSeconds(60)"> 

Current Time inside Cache Tag Helper: @DateTime.Now 
</cache> 


Vary-tarafından-üstbilgisi 

ÖZNITELIK TÜRÜ 


ÖRNEKLER 


Dize 


User-Agent , User-Agent,content-encoding 


vary-by-header Bunlar değiştirdiğinizde, önbellek yenileme tetiklemek üstbilgi değerlerini virgülle ayrılmış 
listesini kabul eder. 

Aşağıdaki örnekte üst bilgi değeri izler user-Agent . Bu örnek için içerikleri önbelleğe alan her farklı user-Agent 
web sunucusuna sunulur: 


<cache vary-by-header="User-Agent"> 

Current Time inside Cache Tag Helper: @DateTime.Now 
</cache> 


farklı-tarafından-sorgu 

ÖZNITELIK TÜRÜ ÖRNEKLER 

Dize Make , Make,Model 


vary-by-query bir virgülle ayrılmış listesini kabul eder Keys bir sorgu dizesinde (öuery), tetikleme önbellek 
yenileme herhangi bir değerini listelenen anahtar değişiklikler. 

Aşağıdaki örnek değerleri izler Make ve Model . Bu örnek için içerikleri önbelleğe alan her farklı Make ve Model 
web sunucusuna sunulur: 




















<cache vary-by-query="Make,Model"> 

Current Time inside Cache Tag Helper: @DateTime.Now 
</cache> 


farklı-tarafından-route 

ÖZNITELIK TÜRÜ 


ÖRNEKLER 


Dize 


Make , Make,Model 


vary-by-route Rota veri parametre değeri değiştiğinde bir önbellek yenileme tetikleyen rota parametre 
adlarının virgülle ayrılmış listesini kabul eder. 

Örnek: 

Startup.es : 

routes.MapRoute( 

name: "default", 

template: "{controller=Home}/{action=Index}/{Make?}/{Model?}"); 


Irıdex.cshtml\ 


<cache vary-by-route="Make,Model"> 

Current Time inside Cache Tag Helper: @DateTime.Now 
</cache> 


farklı-tarafından-tanımlama bilgisi 

ÖZNITELIK TÜRÜ ÖRNEKLER 


.AspNetCore.Identity.Application 


.AspNetCore.Identity.Application, 

HairColor 


vary-by-cookie tanımlama bilgisi değerleri değiştiğinde önbelleği yenileme tetiklemek tanımlama bilgisi 
adlarının virgülle ayrılmış listesini kabul eder. 

Aşağıdaki örnek, ASP.NET Core kimliği ile ilişkili tanımlama izler. Bir kullanıcının kimliği doğrulandığında, kimlik 
tanımlama değişikliği bir önbellek yenileme tetikleyen: 

<cache vary-by-cookie=".AspNetCore.Identity.Application"> 

Current Time inside Cache Tag Helper: @DateTime.Now 
</cache> 


farklı kullanıcı tarafından 

ÖZNITELIK TÜRÜ ÖRNEKLER VARSAYILAN 

Boole değeri true , false true 


vary-by-user oturum açmış kullanıcı (veya bağlam sorumlusu) değiştiğinde önbelleği sıfırlar olup olmadığını 
belirtir. Geçerli kullanıcı olarak da bilinen istek bağlamı sorumlusu ve bir Razor Görünümü'nde başvurarak 
görüntülenebilir @User.Identity.Name . 













Aşağıdaki örnek, geçerli bir önbellek yenileme tetiklemek için kullanıcı oturum izler: 

ccache vary-by-user="true"> 

Current Time inside Cache Tag Helper: @DateTime.Now 
</cache> 

Bu özniteliği kullanarak içerikleri önbellekte aracılığıyla bir oturum açma ve oturum kapatma döngüsü tutar. 
Değer ayarlandığında true , önbellek kimliği doğrulanmış kullanıcı için bir kimlik doğrulama döngüsü geçersiz 
kılar. Yeni bir benzersiz tanımlama bilgisi değeri, bir kullanıcının kimliği doğrulandığında oluşturulmuş olduğu 
için önbellek geçersiz kılınır. Önbellek anonim durumu için tanımlama bilgisi mevcut olduğunda veya tanımlama 
bilgisinin doldu korunur. Kullanıcı, değil kimliği doğrulanmış ve önbellek korunur. 

değişiklik tarafından 

ÖZNITELIK TÜRÜ ÖRNEK 

Dize @Model 


vary-by hangi verilerin önbelleğe alınmış bir özelleştirme için sağlar. Önbellek etiketi Yardımcısı içeriğini 
özniteliğin dize değeri değiştiğinde tarafından başvurulan nesne güncelleştirildiğinde. Genellikle, model 
değerlerinin dize birleştirme bu özniteliğe atanır. Etkili bir şekilde, burada önbellek nesnelerindeki değerleri 
herhangi bir güncelleştirme geçersiz kılar bir senaryoda sonuçlanır. 

Aşağıdaki örnek iki yol parametreleri, tamsayı değeri görünümü SUM'ları oluşturma denetleyici yöntemi 
varsayar myParami ve myParam2 ve tek bir model özelliği olarak toplamını döndürür. Bu toplam değiştiğinde, 
önbellek etiketi Yardımcısı içeriğini oluşturulur ve tekrar önbelleğe alınmış. 

Eylem: 

public IActionResult Index(string myParaml, string myParam2., string myParam3) 

{ 

int numl; 
int num2; 

int.TryParse(myParamlj out numl); 
int.TryParse(myParam2j out num2); 
return View(viewName, numl + num2); 

} 


lndex.cshtml: 


ccache vary-by="@Model"> 

Current Time inside Cache Tag Helper: @DateTime.Now 
</cache> 


öncelik 

ÖZNITELIK TÜRÜ 


ÖRNEKLER 


VARSAYILAN 


CacheltemPriority 


High , Low , NeverRemove , Normal 


Normal 


priority Yerleşik önbelleği sağlayıcısı için önbellek çıkarma rehberlik sağlar. Web sunucusu çıkarır ı_ow bellek 
baskısı altında olduğunda girişleri ilk önbellek. 


Örnek: 














<cache priority="High"> 

Current Time inside Cache Tag Helper: @DateTime.Now 
</cache> 

prionity Özniteliği, belirli bir önbellek bekletme düzeyini garanti etmez. cacheitemPriority yalnızca bir 
öneridir. Bu öznitelik ayarını NeverRemove önbelleğe alınmış öğeleri her zaman korunur garanti etmez. Konular, 
bkz: ek kaynaklar bölümünde daha fazla bilgi için. 

Önbellek etiketi Yardımcısı bağlıdır bellek önbellek hizmeti. Önbellek etiketi Yardımcısı eklenmemiş olan hizmet 
ekler. 

Ek kaynaklar 

• ASP.NET Core'de önbellek belleği 

• ASP.NET Core kimliğe giriş 




Dağıtılmış önbellek etiketi Yardımcısı ASRNET 
core'da 

12.07.2019 • 2 minutes to read ı Edit Online 


Tarafından Peter Kellner ve Luke Latham 

Dağıtılmış önbellek etiketi Yardımcısı, dağıtılmış önbellek kaynağına içeriği önbelleğe alarak ASP.NET Core 
uygulamanızı performansını önemli ölçüde artırmak olanağı sağlar. 

Etiket Yardımcıları genel bakış için bkz. AS P.N ET Core etiket yardımcıları. 

Dağıtılmış önbellek etiketi Yardımcısı, önbellek etiketi Yardımcısı olarak aynı temel sınıfından devralır.Tüm 
önbellek etiketi Yardımcısı öznitelikleri dağıtılmış etiketi Yardımcısı için kullanılabilir. 

Dağıtılmış önbellek etiketi Yardımcısı kullanan Oluşturucu ekleme. IDİstributedCache Arabirimi, dağıtılmış 
önbellek etiketi Yardımcısı'nın oluşturucuya geçirilir. Hiçbir somut uygulaması varsa IDİstributedCache 
oluşturulur startup.configureServices ( Startup.cs ), dağıtılmış önbellek etiketi Yardımcısı olarak önbelleğe 
alınmış verileri depolamak için aynı bellek içi sağlayıcısı kullanan önbellek etiketi Yardımcısı. 

Dağıtılmış önbellek etiketi Yardımcısı öznitelikleri 

Önbellek etiketi Yardımcısı ile paylaşılan öznitelikleri 

• enabled 

• expires-on 

• expires-after 

• expires-sliding 

• vary-by-header 

• vary-by-query 

• vary-by-route 

• vary-by-cookie 

• vary-by-user 

• vary-by priority 

Önbellek etiketi Yardımcısı aynı sınıfta dağıtılmış önbellek etiketi Yardımcısı devralır. Bu öznitelikler açıklaması 
için bkz. önbellek etiketi Yardımcısı. 

name 

ÖZNITELIK TÜRÜ ÖRNEK 

Dize my-distributed-cache-ıınique-key-101 


name gerekli değildir, name Özniteliği, her depolanan önbellek örneği için bir anahtar olarak kullanılır.Önbellek 
etiketi Razor sayfası adı ve Razor sayfası konuma göre her bir örneği için bir önbellek anahtarı atayan Yardımcısı, 
dağıtılmış önbellek etiketi Yardımcısı yalnızca anahtarıyla özniteliğini tabanları name . 


Örnek: 











<distributed-cache name="my-distributed-cache-unique-key-101"> 
Time inside Cache Tag Helper: @DateTime.Now 
</distnibuted-cache> 


Dağıtılmış önbellek etiketi Yardımcısı IDistributedCache uygulamaları 

iki uygulamaları vardır IDistributedCache ASP.NET Core için yerleşik olarak bulunur.Bir SQL Sunucusu'nu 
temel alır ve diğer Redis dayanır. Bu uygulamalar ayrıntıları bulunabilir ASP.NET Core 'de dağıtılmış önbelleğe 
alma. Bir örneği her iki uygulamaları içeren IDistributedCache içinde startup . 

Tüm özel uygulanışı kullanmaya özellikle ilişkili hiçbir etiket öznitelik IDistributedCache . 

Ek kaynaklar 

• Önbellek etiketi Yardımcısı, ASP.NET Core MVC 

• ASP.NET Core bağımlılık ekleme 

• ASP.NET Core 'de dağıtılmış önbelleğe alma 

• ASP.NET Core'de önbellek belleği 

• ASP.NET Core kimliğe giriş 






ASRNET core'da ortam etiketi Yardımcısı 

12.07.2019 • 2 minutes to read ı Edit Online 


Tarafından Peter Kellner, Hisham Bin Ateya, ve Luke Latham 

Ortam etiketi Yardımcısı koşullu olarak geçerli göre kapalı içeriğini işler barındırma ortamı. Ortam etiketi 
Yardımcısı'nın tek öznitelik names , ortam adlarının virgülle ayrılmış listesidir. Sağlanan ortam adları geçerli 
ortamı hiçbiriyle, ekteki içeriğin işlenir. 

Etiket Yardımcıları genel bakış için bkz. AS P.N ET Core etiket yardımcıları. 

Ortam etiketi Yardımcısı öznitelikleri 

adlar 

names Tek bir barındırma ortamı adı veya işleme ekteki içeriğin tetikleyen ortam adları barındırma virgülle 
ayrılmış listesini kabul eder. 

Tarafından döndürülen değeri, geçerli ortam değerlerini karşılaştırılır IHostingEnvironment.EnvironmentName. 
Karşılaştırma çalışması yoksayar. 

Aşağıdaki örnek, bir ortam etiketi Yardımcısı kullanır. Barındırma ortamı hazırlık veya üretim olması durumunda 
içeriğinin işlenip: 

cenvironment names="Stagingj Production"> 

<strong>HostingEnvironment.EnvironmentName is Staging or Production</strong> 

</environment> 


dahil etme ve dışlama öznitelikleri 

inciude & exciude dahil veya hariç tutulan barındırma ortamı adlarını temel alarak ekteki içeriğin işleme 
öznitelikleri denetimi. 

inciude 

inciude Özelliği için benzer bir davranış gösteriyor names özniteliği. Listelenen bir ortam inciude öznitelik 
değeri, uygulamanın barındırma ortamına eşleşmelidir (IHostingEnvironment.EnvironmentName) içeriği 
işlemek için <environment> etiketi. 

cenvironment include="Staging , Production"> 

<strong>HostingEnvironment.EnvironmentName is Staging or Production</strong> 

</environment> 


exclude 


Tersine 

inciude 

özniteliği, içeriğini 

<environment> 

etiket listede bir ortam barındırma ortamı eşleşmediğinde 

işlenir 

exclude 

öznitelik değeri. 




cenvironment exclude="Development"> 

<strong>HostingEnvironment.EnvironmentName is not Development</strong> 
</environment> 


















Ek kaynaklar 

• ASP.NET Core çoklu ortamları kullanma 


ASPNET Core formlardaki etiket yardımcıları 

6.12.2019 • 27 minutes to read ı Edit Online 


By Rick Anderson, N. Taylor Mullen, Davve Patııve Jerrie Pelser 

Bu belge, formlarda ve genellikle form üzerinde kullanılan HTML öğeleriyle çalışmayı gösterir. HTML form öğesi, 
Web uygulamalarının sunucuya veri geri göndermek için kullanacağı birincil mekanizmayı sağlar. Bu belgenin 
çoğunda Etiket Yardımcıları ve BUNLARıN güçlü HTML formları oluşturma konusunda nasıl yardımcı olabilecekleri 
açıklanmaktadır. Bu belgeyi okuyabilmeniz İçin yardımcıları etiketleyerek okumanız önerilir. 

Birçok durumda, HTML Yardımcıları belirli bir etiket Yardımcısı için alternatif bir yaklaşım sağlar, ancak bu etiket 
yardımcıların HTML yardımcılarını değiştirmez ve her HTML Yardımcısı için bir etiket Yardımcısı olmadığını bilmek 
önemlidir. Bir HTML Yardımcısı alternatifi varsa, bu, bahsedilir. 

Form etiketi Yardımcısı 

Form etiketi Yardımcısı: 

• MVC denetleyicisi eylemi veya adlandırılmış yol için HTML <FORM > action öznitelik değeri oluşturur 


• Siteler arası istek yasaklamasını engellemek için gizli bir İstek doğrulama belirteci ÜRETİR (http post eylem 



Örnek: 

<form asp-controller="Demo" asp-action="Register" method="post"> 
<!-- Input and Submit elements --> 

</form> 


Yukarıdaki form etiketi Yardımcısı aşağıdaki HTML 'yi oluşturur: 



oluşturur. Bir saf HTML formunun siteler arası istek sahteciliğini önleme 'den korunması zordur, form etiketi 
Yardımcısı bu hizmeti sizin için sağlar. 

Adlandırılmış yol kullanma 


asp-route 

Tag Helper özniteliği, HTML 

action 

özniteliği için de biçimlendirme oluşturabilir. 

register 


uygulama, kayıt sayfası için aşağıdaki biçimlendirmeyi kullanabilir: 






















<form asp-route="register" method="post"> 
<!-- Input and Submit elements --> 
</form> 


Görünümler/hesap klasöründeki görünümlerin birçoğu ( bireysel kullanıcı hesaplarıylayenl bir Web uygulaması 
oluşturduğunuzda oluşturulur), ASP-Route-ReturnUrl özniteliğini içerir: 

<form asp-controllen="Account" asp-action="Login" 
asp-route-returnurl="@ViewData["Returnllrl"]" 
method="post" class="form-horizontal" role="form"> 


NOTE 

Yerleşik şablonlarla returniiri , yalnızca yetkili bir kaynağa erişmeye çalıştığınızda ancak kimliği doğrulanmamış veya 
yetkilendirilmeyen otomatik olarak doldurulur. Yetkisiz erişim yapmaya çalıştığınızda, güvenlik ara yazılımı sizi neturnuri 
kümesi ile oturum açma sayfasına yönlendirir. 


Form eylemi etiketi Yardımcısı 


Form eylemi etiketi Yardımcısı, formaction özniteliği oluşturulan <button ...> veya cinput type="image" ...> 


etiketi üzerinde oluşturur. 

formaction 

özniteliği bir formun verilerini nereden gönderdiğini denetler. 

image 

ve 

<düğme > öğeleri <giriş 

> öğelerine 

bağlanır. Form eylemi etiketi Yardımcısı, karşılık gelen öğe için 

formaction 


bağlantısının oluşturulduğunu denetlemek için birkaç AnchorTagHelper asp- özniteliği kullanımını sağlar, 
formaction değerini denetlemek için desteklenen AnchorTagHelper öznitelikleri: 


ÖZNITELIK 

AÇIKLAMA 

ASP-Controller 

Denetleyicinin adı. 

ASP-eylem 

Eylem yönteminin adı. 

ASP-alanı 

Alanın adı. 

asp-sayfa 

Razor sayfasının adı. 

ASP-Page-Handler 

Razor sayfası işleyicisinin adı. 

ASP-Route 

Rotanın adı. 

ASP-Route-{Value} 

Tek bir URL yol değeri. Örneğin: asp-route-id="i 234 " . 

ASP-Ali- Route- Data 

Tüm rota değerleri. 

ASP-Fragment 

URL parçası. 


Denetleyiciye gönder örneği 

Aşağıdaki biçimlendirme, giriş veya düğme seçildiğinde formu HomeControiler 


index eylemine gönderir: 














cform method="post"> 

<button asp-controller="Hom 0 ” asp-action="Index">Click Me</button> 
<input type="image" src="..." alt="Or Click Me" asp-controller="Home" 

asp-action="Index"> 

</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/Home">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" formaction="/Home"> 
</form> 


Sayfa örneğine gönder 

Aşağıdaki biçimlendirme formu About Razor sayfasına gönderir: 

<form method="post"> 

<button asp-page="About">Click Me</button> 

cinput type="image" src="...“ alt="Or Click Me" asp-page="About"> 
</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/About">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" formaction="/About"> 
</form> 


Yönlendirme örneğine gönder 

/Home/Test uç noktasını göz önünde bulundurun: 

public class HomeController : Controller 

{ 

[Route("/Home/Test", Name = "Custom")] 
public string Test() 

{ 

return "This is the test page"; 

} 

} 

Aşağıdaki biçimlendirme formu /Home/Test uç noktasına gönderir. 

<form method="post"> 

<button asp-route="Custom">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" asp-route="Custom"> 
</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/Home/Test">Click Me</button> 

cinput type="image" snc="..." alt="Or Click Me" formaction="/Home/Test"> 
</form> 











Giriş etiketi Yardımcısı 

Giriş etiketi Yardımcısı, bir HTML <girişi > öğesini Razor görünüminizdeki bir model ifadesine bağlar. 

Sözdizimi: 

cinput asp-for="<Expression Name>"> 

Giriş etiketi Yardımcısı: 

• asp-for özniteliğinde belirtilen ifade adı için id ve name HTML özniteliklerini üretir. 
asp-for="Propertyl.Property2" m => m.Propertyl.Property2 eşdeğerdir, ifadenin adi, asp-for Öznitelİği 

değeri için kullanılan şeydir. Ek bilgi için ifade adları bölümüne bakın. 

• Model özelliğine uygulanan model türüne ve veri ek açıklaması ÖZNİTELİKLERINE göre HTML type 
öznitelik değerini ayarlar 

• Belirtilirse, HTML type öznitelik değerinin üzerine yazmaz 

• Model özelliklerine uygulanan veri ek açıklama özniteliklerinden HTML5 doğrulama öznitelikleri oluşturur 

• Htmi.TextBoxFor ve Htmi.EditorFor bir HTML Yardımcısı özelliği örtüşüyor. Ayrıntılar için bkz. giriş etiketi 
Yardımcısı İçin HTML Yardımcısı alternatifleri. 

• Güçlü yazma sağlar.Özelliğin adı değişirse ve etiket yardımcısını güncelleştirmezseniz aşağıdakine benzer bir 
hata alırsınız: 



ve oluşturulan HTML türü listelenmekte (her .NET türü listelenmemiştir). 


.NET TÜRÜ 

GİRİŞ türü 

Bool 

Type = "onay kutusu" 

Dize 

Type = "metin" 

DateTime 

Type ="TarihSaat-yerel' 

Bayt 

Type = "Number" 

int 

Type = "Number" 

Tek, Çift 

Type = "Number" 


Aşağıdaki tabloda, giriş etiketi Yardımcısı 'nın belirli giriş türleriyle eşleşecağı bazı ortak veri ek açıklamaları (her 
doğrulama özniteliğı listelenmez) gösterilmektedir: 












OZNITELIK 


GİRİŞ TURU 


EmailAddress 

Type = "e-posta" 

'Deki 

Type = "URL" 

[Hiddenınput] 

Type = "Hidden" 

Numarası 

Type = "tel" 

[DataType (DataType. Password)] 

Type = "Passvvord" 

[DataType (DataType. Date)] 

Type = "Date" 

[DataType (DataType. Time)] 

yazın = "Time" 


Örnek: 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class RegisterViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 

[Required] 

[DataType(DataType.Password)] 
public stning Password { get; set; } 

} 

} 


@model RegisterViewModel 

<form asp-controller="Demo" asp-action="RegisterInput" method="post"> 
Email: <input asp-for="Email" /> <br /> 

Password: cinput asp-fon="Password" /><bn /> 

<button type="submit">Registen</button> 

</fonm> 


Yukarıdaki kod, aşağıdaki HTML 'yi oluşturur: 

<fonm method="post" action="/Demo/RegistenInput"> 

Email: 

<input type="email" data-val="tnue" 

data-val-email="The Email Addness field is not a valid email address." 
data-val-required="The Email Address field is required." 
id="Email" name="Email" value=""xbr> 

Password: 

cinput type="password" data-val="true" 

data-val-required="The Password field is required." 
id="Password" name="Password"xbr> 
cbutton type="submit">Register</button> 

cinput name="_RequestVerificationToken" type="hidden" value="cremoved for brevity>"> 

c/form> 




Email ve Passwond özelliklerine uygulanan veri ek açıklamaları modelde meta veriler oluşturur. Giriş etiketi 
Yardımcısı, model meta verilerini kullanır ve HTM L5 data-vai-* öznitelikleri üretir (bkz. model doğrulama). Bu 
öznitelikler, giriş alanlarına iliştirilecek Doğrulayıcıları anlatmaktadır. Bu unobtrusive HTML5 vejQuery doğrulaması 
sağlar. Unobtrusive özniteliklerinin biçimi data-vai-ruie="Error Message" , burada kural doğrulama kuralının adıdır 
(örneğin, data-val-required , data-val-email , data-val-maxlength vb.) Öznitelikte bir hata iletisi sağlanırsa, 
data-vai-rule özniteliği için değer olarak görüntülenir. Ayrıca, kuralla ilgili ek ayrıntılar sağlayan 
data-val-ruleName-argumentName="argumentValue" form Öznitelikleri de vardır, Örneğin, 
data-val-maxlength-max="1024" . 

Giriş etiketi Yardımcısı için HTML Yardımcısı alternatifleri 

Htmi.TextBox , Htmi.TextBoxFor , Htmi.Editör ve Htmi.EditorFor , giriş etiketi Yardımcısı ile çakışan özelliklere 


sahiptir. Giriş etiketi Yardımcısı 

type 

özniteliğini otomatik olarak ayarlar; 

Htmi.TextBox 

ve 

Htmi.TextBoxFor 


Htmi.Editör 

ve 

Htmi.EditorFor 

■ tanıtıcı koleksiyonları, karmaşık nesneler ve şablonlar; Giriş etiketi Yardımcısı yok. 

Giriş etiketi Yardımcısı, Htmi.EditorFor ve Htmi.TextBoxFor kesin türdedir (lambda ifadeleri kullanırlar); 

Html.TextBox 

ve 

Htmi.Editör ı 

değildir (ifade adlarını kullanırlar). 


HtmlAttributes 

@Htmi.Editor() ve @Htmi.EditorFor( ), varsayılan şablonlarını yürütürken htmiAttributes adlı özel bir 
viewDataDictionary girişi kullanır. Bu davranış, isteğe bağlı olarak additionaiviewData parametreleri kullanılarak 
genişletilebilir. "HtmlAttributes" anahtarı büyük/küçük harfe duyarlıdır."HtmlAttributes" anahtarı, @Htmi.TextBox() 
gibi giriş yardımcılarını geçirilmiş htmiAttributes nesnesine benzer şekilde işlenir. 

@Html.EditorFor(model => model.YourProperty, 

new { htmiAttributes = new { @class="myCssClass ", style="Width:100px" } }) 

İfade adları 

asp-for öznitelik değeri, bir lambda ifadesinin bir ModeiExpression ve sağ tarafıdır. Bu nedenle, 
asp-for="Propertyi" oluşturulan kodda m => m.Propertyi hale gelir ve bu nedenle Model ile önek gerektirmez. 
karakterini kullanarak bir satır içi ifadeyi başlatabilir ve m. önce taşıyabilirsiniz: 

@{ 

var joe = "Doe"; 

} 

<input asp-for="@joe"> 


Şunları üretir: 


cinput type="text" id="joe" name="joe" value="loe"> 


Koleksiyon özellikleriyle 

asp-for="CollectionProperty[23].Member" , 

asp-for="CollectionProperty[i].Member" 

aynı adı üretir. 


i değer 23 olduğunda 


ASP.NET Core MVC ModeiExpression değerini hesapladığında Modeistate dahil olmak üzere çeşitli kaynakları 
inceler, cinput type="text" asp-for="@Name"> göz önünde bulundurun. Hesaplanan value özniteliği, öğesinden 
gelen ilk null olmayan değerdir: 


• "Name" anahtarına sahip giriş Modeistate. 

• İfadenin sonucu Model.Name . 


Alt özelliklerde gezinme 

Ayrıca, görünüm modelinin özellik yolunu kullanarak alt Özellikler 1 e gidebilirsiniz. Alt Address özelliği içeren daha 
karmaşık bir model sınıfı düşünün. 











































public class AddressViewModel 

{ 

public string AddressLinel { get; set; } 

} 


public class RegisterAddressViewModel 

{ 

public string Email { get; set; } 

[DataType(DataType.Password)] 
public string Password { get; set; } 

public AddressViewModel Address { get; set; } 

} 

Görünümde Address.AddressLinei bağlandık: 


@model RegisterAddressViewModel 

<form asp-controller="Demo" asp-action="RegisterAddress" method="post"> 
Email: <input asp-for="Email" /> <br /> 

Password: <input asp-for="Password" /><br /> 

Address: <input asp-for="Address.AddressLinel" /><br /> 

<button type="submit">Register</button> 

</form> 


Address.AddressLinei için aşağıdaki HTML oluşturulmuştur: 

<input type="text" id="Address_AddressLinel" name="Address.AddressLinel" value=""> 


İfade adları ve koleksiyonlar 

Örnek, bir dizi colors içeren bir modeldir: 

public class Person 

{ 

public List<string> Colors { get; set; } 
public int Age { get; set; } 

} 

Eylem yöntemi: 


public IActionResult Edit(int id, int colorIndex) 

{ 

ViewData["Index"] = colorIndex; 
return View(GetPerson(id)); 

} 


Aşağıdaki Razor, belirli bir color öğesine nasıl erişistediğinizi göstermektedir: 











@model Person 

@{ 

var index = (int)ViewData["index"]; 

} 

<form asp-controller="ToDo" asp-action="Edit" method="post"> 
@Html.EditorFor(m => m.Colors[index]) 
dabel asp-for="Age"x/label> 

<input asp-for="Age" /><br /> 

<button type="submit">Post</button> 

</form> 


Views/Shared/EdltorTemplates/Strlng. cshtml şablonu: 

@model string 

<label asp-for="@Model"x/label> 

<input asp-for="@Model" /> <br /> 

List<T > kullanarak örnek: 


public class ToDoltem 

{ 

public string Name { get; set; } 
public bool IsDone { get; set; } 

} 


Aşağıdaki Razor, bir koleksiyonun üzerinde nasıl yineleme yapılacağını göstermektedir: 

@model List<ToDoItem> 

<form asp-controller="ToDo" asp-action="Edit" method="post"> 

<table> 

<tr> <th>Name</th> <th>Is Done</th> </tr> 

@for (int i = 0; i < Model.Count; i++) 

{ 

<tr> 

@Html.EditorFor(model => modelfi]) 

</tr> 

} 

</table> 

<button type="submit">Save</button> 

</form> 


Views/Shared/EditorTemplates/Todoltem. cshtml şablonu: 




@model ToDoltem 
<td> 

<label asp-for="@Model.Name"x/label> 

@Html.DisplayFor(model = > model.Name) 

</td> 

<td> 

cinput asp-fon="@Model.IsDone" /> 

</td> 

This template replaces the following Razor which evaluates the indexer three tlmes. 

<td> 

<label asp-for="@Model[i] .Name"x/label> 

@Html.DisplayFor(model => model[i].Name) 

</td> 

<td> 

<input asp-for="@Model[i].IsDone" /> 

</td> 

*@ 

değer bir asp-for veya Htmi.DisplayFor denk bir bağlamda kullanılacaksa, mümkünse foreach kullanılmalıdır. 
Genel olarak, for bir Numaralandırıcı ayırması gerekmiyorsa, foreach daha iyidir (senaryo buna izin veriyorsa). 
Ancak, bir LINQ ifadesinde bir dizin oluşturucuyu değerlendirmek pahalı olabilir ve simge durumuna küçültülmüş 
olmalıdır. 


NOTE 

Yukarıdaki açıklamalı örnek kod, listedeki her bir ToDoltem erişmek için lambda ifadesinin @ işleçle nasıl değiştirileceğini 
gösterir. 


TextArea etiketi Yardımcısı 

Textarea Tag Helper Tag Yardımcısı giriş etiketi Yardımcısı ile benzerdir. 

• id ve name özniteliklerini ve <textarea > öğesi için modelden veri doğrulama özniteliklerini üretir. 

• Güçlü yazma sağlar. 

• HTML Yardımcısı alternatifi: Htmi.TextAreaFor 
Örnek: 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class DescriptionViewModel 

{ 

[MinLength(S) ] 

[MaxLength(1024)] 

public stning Description { get; set; } 

} 

} 













@model DescriptionViewModel 

<form asp-controller="Demo" asp-action="RegisterTextArea" method="post"> 
<textarea asp-for="Description"x/textarea> 

<button type="submit">Test</button> 

</form> 


Aşağıdaki HTML oluşturulur: 

<form method="post" action="/Demo/RegisterTextArea"> 

<textarea data-val="true" 

data-val-maxlength="The field Description must be a string or array type with a maximum length of 
&#x27;1024&#x27;." 

data-val-maxlength-max="1024" 

data-val-minlength="The field Description must be a string or array type with a minimum length of 
&#x27;5&#x27; 

data-val-minlength-min="5" 

id="Description" name="Description") 

</textarea> 

<button type="submit">Test</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Etiket etiketi Yardımcısı 

• Bir ifade adı için bir <label > öğesinde etiket başlık yazısı ve for özniteliği oluşturur 

• HTML Yardımcısı alternatifi: Htmi.LabeiFor . 

Label Tag Helper , saf HTML etiket öğesi üzerinde aşağıdaki avantajları sağlar: 

• Display özniteliğinden açıklayıcı etiket değerini otomatik olarak alırsınız, istenen görünen ad zaman içinde 
değişebilir ve Display özniteliği ve etiket etiketi Yardımcısı 'nın birleşimi, Display her yere uygular. 

• Kaynak kodunda daha az biçimlendirme 

• Model özelliğiyle güçlü yazma. 

Örnek: 


using System.ComponentModel.DataAnnotations; 


namespace FormsTagHelper.ViewModels 

{ 


public class SimpleViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 

} 










@model SimpleViewModel 

<fonm asp-controller="Demo" asp-action="Registerl_abel" method="post"> 

<label asp-fon="Email"x/label> 

<input asp-for="Email" /> <br /> 

</form> 

<iabei> öğesi için aşağıdaki HTML oluşturulur: 

dabel for="Email">Email Address</label> 

Etiket etiketi Yardımcısı, <input> öğesiyle ilişkili KİMLİK olan "e-posta" for öznitelik değerini oluşturdu. Etiket 
Yardımcıları, doğru ilişkilendirilebilen şekilde tutarlı id ve for öğeleri oluşturur. Bu örnekteki başlık Display 
özniteliğinden gelir. Modelde bir Display özniteliği yoksa, başlık ifadenin Özellik adı olacaktır. 

Doğrulama etiketi yardımcıları 

iki doğrulama etiketi yardımcıları vardır, validation Message Tag Helper (modelinizdeki tek bir özellik için bir 
doğrulama iletisi görüntüler) ve validation summary Tag Helper (doğrulama hatalarının özetini görüntüler), 
input Tag Helper , model sınıflarınızda bulunan veri ek açıklaması özniteliklerini temel alan giriş öğelerine HTML5 
istemci tarafı doğrulama öznitelikleri ekler. Doğrulama de sunucuda gerçekleştirilir. Doğrulama etiketi Yardımcısı, 
bir doğrulama hatası oluştuğunda bu hata iletilerini görüntüler. 

Doğrulama İletisi etiketi Yardımcısı 

• Belirtilen model özelliğinin giriş alanındaki doğrulama hatası mesajlarını bağlayan span öğesine HTML5 
data-vaimsg-for="property" özniteliğini ekler, istemci tarafı doğrulama hatası oluştuğunda, jöuery <span> 

öğesinde hata iletisini görüntüler. 

• Doğrulama de sunucuda gerçekleşir, istemciler JavaScript devre dışı bırakılmış olabilir ve bazı doğrulamalar 
yalnızca sunucu tarafında yapılabilir. 

• HTML Yardımcısı alternatifi: Html.ValidationMessageFor 

validation Message Tag Helper , bir HTML span öğesinde asp-validation-for özniteliğiyle kullanılır. 

<span asp-validation-for="Email"></span> 

Doğrulama İletisi etiketi Yardımcısı aşağıdaki HTML 'yi oluşturur: 

<span class="field-validation-valid" 
data-valmsg-for="Email" 
data-valmsg-replace="true"x/span> 

Aynı özellik için bir input etiketi Yardımcısı sonrasında validation Message Tag Helper genellikle kullanırsınız. 
Bunun yapılması, hataya neden olan girişin yakınında herhangi bir doğrulama hata iletisi görüntüler. 


NOTE 

İstemci tarafı doğrulaması için doğru JavaScript ve jQuery betik başvurularını içeren bir görünümsiniz olmalıdır. Daha fazla bilgi 
için bkz. model doğrulaması . 


Sunucu tarafı doğrulama hatası oluştuğunda (örneğin, özel sunucu tarafı doğrulamadan veya istemci tarafı 
doğrulaması devre dışı bırakılmışsa), MVC bu hata iletisini <span> öğesinin gövdesi olarak koyar. 




















<span class="field-validation-error" data-valmsg-for="Email" 
data-valmsg-replace="true"> 

The Email Address field is required. 

</span> 


Doğrulama Özeti etiketi Yardımcısı 

• asp-validation-summary özniteliği olan öğeleri <div> hedefleri 

• HTML Yardımcısı alternatifi: @Html.ValidationSummary 

Validation Summary Tag Helper , doğrulama iletilerinin Özetini göstermek için kullanılır, asp-validation-summary 
öznitelik değeri, aşağıdakilerden herhangi biri olabilir: 

ASP-DOĞRULAMA-ÖZET GÖRÜNEN DOĞRULAMA İLETİLERİ 

ValidationSummary. Ali Özellik ve model düzeyi 

Yalnızca ValidationSummary. model Model 

ValidationSummary. None Yok. 

Örnek 

Aşağıdaki örnekte, veri modelinde <input> öğesinde doğrulama hata iletileri üreten DataAnnotation öznitelikleri 
vardır. Doğrulama hatası oluştuğunda, doğrulama etiketi Yardımcısı şu hata iletisini görüntüler: 

using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class RegisterViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 

[Required] 

[DataType(DataType.Password)] 
public string Password { get; set; } 

} 

} 


@model RegisterViewModel 

<form asp-controller="Demo" asp-action="RegisterValidation" method="post"> 
<div asp-validation-summary="ModelOnly"x/div> 

Email: <input asp-for="Email" /> <br /> 

<span asp-validation-for="Email"x/spanxbr /> 

Password: <input asp-for="Password" /xbr /> 

<span asp-validation-for="Password"x/spanxbr /> 

<button type="submit">Register</button> 

</form> 


Oluşturulan HTML (model geçerli olduğunda): 











<form action="/DemoReg/Register" method="post"> 

<div class="validation-summary-valid" data-valmsg-summary="true"> 

<ulxli style="display: none"x/lix/ulx/div> 

Email: cinput name="Email" id="Email" type="email" value="" 
data-val-required="The Email field is required." 
data-val-email="The Email field is not a valid email address." 
data-val="true"xbr> 

<span elass="field-validation-valid" data-valmsg-replace="true" 
data-valmsg-fon=" Email "x/spanxbr> 

Password: <input name="Password" id="Password" type="password" 
data-val-required="The Password field is required." data-val="true"xbr> 

<span elass="field-validation-valid" data-valmsg-replace="true" 
data-valmsg-fon="Password"x/spanxbn> 

<button type="submit">Registen</button> 

cinput name="_RequestVerificationToken" type="hidden" value="<removed fon brevity>"> 

</fonm> 


Etiket Seç Yardımcısı 

• Modelinizin özellikleri için Select ve ilişkili seçenek öğeleri oluşturur. 



Örneğin: 


<select asp-for="Country" asp-items="Model.Countries"x/select> 


Örnek: 


using Microsoft.AspNetCone.Mvc.Rendering; 
using System.Collections.Generic; 

namespace FonmsTagHelpen.ViewModels 

{ 

public elass CountryViewModel 

{ 

public stning Country { get; set; } 

public List<SelectListItem> Countnies { get; } = new List<SelectListItem> 

{ 

new SelectListltem { Value = "MX", Text = "Mexico" }j 

new SelectListltem { Value = "CA", Text = "Canada" }j 

new SelectListltem { Value = "US", Text = "USA" }, 

}; 

} 

} 


index yöntemi countnyviewModei başlatır, seçilen ülkeyi ayarlar ve index görünümüne geçirir. 

public IActionResult Index() 

{ 

var model = new CountryViewModel(); 
model.Country = "CA"; 
return View(model); 

} 


HTTP POST index yöntemi seçimi görüntüler: 













[HttpPost] 

[ValidateAntiForgeryToken] 

public IActionResult Index(CountryViewModel model) 

{ 

if (ModelState.IsValid) 

{ 

var msg = model.Country + " selected"; 

return RedirectToAction("IndexSuccess", new { message = msg }); 

} 

// If we got this far, something failed; redlsplay form, 
return View(model); 


index görünümü: 


@model CountryViewModel 

<form asp-controller="Home" asp-action="Index" method="post"> 

<select asp-for="Country" asp-items="Model .Countries"x/select> 
<br /><button type="submit">Register</button> 

</form> 


Aşağıdaki HTML 'yi üreten ("CA" seçiliyken): 


<form method="post" action="/"> 

<select id="Country" name="Country"> 

<option value="MX">Mexico</option> 

coption selected="selected" value="CA">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


NOTE 

Etiket Seç Yardımcısı ile viewBag veya viewData kullanmanızı önermiyoruz. Bir görünüm modeli, MVC meta verileri 
sağlamaya ve genellikle daha az soruna neden olacak daha sağlamdır. 


asp-for öznitelik değeri özel bir durumdur ve Model öneki gerektirmez, diğer etiket Yardımcısı öznitelikleri olur ( 
asp-items gibi) 

<select asp-for="Country" asp-items="Model.Countries"x/select> 


Sabit Listesi bağlama 

<seiect> , enum bir özellik ile kullanmak ve enum değerlerinden selectListitem öğeleri oluşturmak için 
kullanışlıdır. 


Örnek: 









public class CountryEnumViewModel 

{ 

public CountryEnum EnumCountry { get; set; } 

} 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public enum CountryEnum 

{ 

[Display(Name = "United Mexican States")] 
Mexico, 

[Display(Name = "United States of America")] 
USA, 

Canada, 

France, 

Germany, 

Spain 

} 

} 


GetEnumSelectList yöntemi bir numaralandırma için selectList nesnesi oluşturur. 

@model CountryEnumViewModel 

<form asp-controller="Home" asp-action="IndexEnum" method="post"> 

<select asp-for="EnumCountry" 

asp-items="Html.GetEnumSelectList<CountryEnum>()"> 

</select> 

<br /><button type="submit">Register</button> 

</form> 

Daha zengin bir kullanıcı arabirimi almak için, Numaralandırıcı listenizi Display özniteliğiyle işaretleyebilirsiniz: 

using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public enum CountryEnum 

{ 

[Display(Name = "United Mexican States")] 

Mexico, 

[Display(Name = "United States of America")] 

USA, 

Canada, 

France, 

Germany, 

Spain 

} 

} 


Aşağıdaki HTML oluşturulur: 






<form method="post" action="/Home/IndexEnum"> 

<select data-val="true" data-val-required="The EnumCountry field is required." 
id="EnumCountry" name="EnumCountry"> 

<option value="0">United Mexican States</option> 

<option value="l">United States of America</option> 

<option value="2">Canada</option> 

<option value="3">France</option> 
coption value="4">Germany</option> 

<option selected="selected" value="5">Spain</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Seçenek grubu 

HTML <SeçenekGrubu > öğesi, görünüm modelinde bir veya daha fazla selectListGroup nesnesi içerdiğinde 
oluşturulur. 

countryviewModeiGroup , selectListitem öğelerini "Kuzey Amerika" ve "Avrupa" gruplarına gruplandırır: 






public class CountryViewModelGroup 

{ 

public CountryViewModelGroup() 

{ 

var NorthAmericaGroup = new SelectListGroup { Name = "North America" }; 
var EuropeGroup = new SelectListGroup { Name = "Europe" }; 

Countries = new List<SelectListItem> 

{ 

new SelectListltem 

{ 

Value = "MEX", 

Text = "Mexico", 

Group = NorthAmericaGroup 

}, 

new SelectListltem 

{ 

Value = "CAN", 

Text = "Canada", 

Group = NorthAmericaGroup 

b 

new SelectListltem 

{ 

Value = "US", 

Text = "USA", 

Group = NorthAmericaGroup 

b 

new SelectListltem 

{ 

Value = "FR", 

Text = "France", 

Group = EuropeGroup 

b 

new SelectListltem 

{ 

Value = "ES", 

Text = "Spain", 

Group = EuropeGroup 

b 

new SelectListltem 

{ 

Value = "DE", 

Text = "Germany", 

Group = EuropeGroup 

} 

b 

} 

public string Country { get; set; } 

public List<SelectListItem> Countries { get; } 


iki grup aşağıda gösterilmiştir: 
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France 
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Oluşturulan HTML: 


<form method="post" action="/Home/IndexGroup"> 

<select id="Country" name="Country"> 

<optgroup label="North America"» 

coption value="MEX">Mexicoc/option> 

<option value="CAN">Canada</option> 
coption value="US">USA</option> 

</optgroup> 

coptgroup label="Europe"> 

coption value="FR">Francec/option> 
coption value="ES">Spainc/option> 
coption value="DE">Germanyc/option> 
c/optgroup> 
c/select> 

cbr /»cbutton type="submit">Registerc/button> 

cinput name="_RequestVerificationToken" type="hidden" value="cremoved for brevity>"> 

c/form> 


Çoklu seçim 

asp-for özniteliğinde belirtilen özellik bir iEnumerabie ise, select etiketi Yardımcısı otomatik olarak birden çok = 
"Muitiple" özniteliği oluşturacaktır. Örneğin, aşağıdaki model verildiğinde: 


using Microsoft.AspNetCore.Mvc. Rendering; 
using System.Collections.Generic; 

namespace FormsTagHelper.ViewModels 

{ 

public class CountryViewModelIEnumerable 

{ 

public IEnumerablecstring» CountryCodes { get; set; } 

public ListcSelectListltem» Countries { get; } = new ListcSelectListltem» 

{ 

new SelectListltem { Value = "MX", Text = "Mexico" }, 

new SelectListltem { Value = "CA", Text = "Canada" }j 

new SelectListltem { Value = "US", Text = "USA" }, 

new SelectListltem { Value = "FR", Text = "France" }, 

new SelectListltem { Value = "ES", Text = "Spain" }, 

new SelectListltem { Value = "DE", Text = "Germany"} 

}; 

} 

} 


Aşağıdaki görünümle: 












@model CountryViewModelIEnumerable 

<form asp-controller="Home" asp-action="IndexMultiSelect" method="post"> 
<select asp-for="CountryCodes" asp-items="Model.Countries"x/select> 
<br /><button type="submit">Register</button> 

</form> 


Aşağıdaki HTML 'yi oluşturur: 

<form method="post" action="/Home/IndexMultiSelect"> 

<select id="CountryCodes" 
muitiple="muitiple" 

name="CountryCodes"xoption value="MX">Mexico</option> 

<option value="CA">Canada</option> 

<option value="US">USA</option> 

<option value="FR">France</option> 

<option value="ES">Spain</option> 

<option value="DE">Germany</option> 

</select> 

<br /xbutton type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Seçim yok 

Birden çok sayfada "belirtilmemiş" seçeneğini kullanarak kendinizi bulursanız, HTML 'yi yinelemeyi ortadan 
kaldırmak için bir şablon oluşturabilirsiniz: 

@model CountryViewModel 

<form asp-controller="Home" asp-action="IndexEmpty" method="post"> 

@Fltml. EditorForModel() 

<br /xbutton type="submit">Register</button> 

</form> 


Vİews/Shared/EditorTemplates/CountryVievvModel, cshtml şablonu: 

@model CountryViewModel 

<select asp-for="Country" asp-items="Model.Countr'ies"> 

<option value="">--none--</option> 

</select> 


HTML <seçenek > öğeleri ekleme hiçbir seçim durumuyla sınırlı değildir. Örneğin, aşağıdaki görünüm ve eylem 
yöntemi yukarıdaki koda benzer HTML oluşturur: 


public IActionResult IndexNone() 

{ 

var model = new CountryViewModel(); 
model.Insert(0j new SelectListItem("<none>", 


return Vlew(model); 

} 









@model CountryViewModel 

<form asp-controller="Home" asp-action="IndexEmpty" method="post"> 

<select asp-for="Country"> 

<option value="">&lt;none&gt;</option> 
coption value="MX">Mexico</option> 

<option value="CA">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

</form> 

Geçerli country değerine bağlı olarak doğru <option> öğesi seçilecek ( seiected="seiected" özniteliğini içerir). 

public IActionResult IndexOption(int id) 

{ 

var model = new CountryViewModel(); 
model.Country = "CA"; 
return View(model); 

} 


<form method="post" action="/Home/IndexEmpty"> 

<select id="Country" name="Country"> 

<option value="">&lt;none&gt;</option> 

<option value="MX">Mexico</option> 

<option value="CA" selected="selected">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Ek kaynaklar 

• ASP.NET Core etiket yardımcıları 

• HTML form öğesi 

• istek doğrulama belirteci 

• ASP.NET Core'de model bağlama 

• ASP.NET Core MVC 'de model doğrulaması 

• lattributeadapter arabirimi 

• Bu belge için kod parçacıkları 







ASPNET Core formlardaki etiket yardımcıları 
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By Rick Anderson, N. Taylor Mullen, Davve Patııve Jerrie Pelser 

Bu belge, formlarda ve genellikle form üzerinde kullanılan HTML öğeleriyle çalışmayı gösterir. HTML form öğesi, 
Web uygulamalarının sunucuya veri geri göndermek için kullanacağı birincil mekanizmayı sağlar. Bu belgenin 
çoğunda Etiket Yardımcıları ve BUNLARıN güçlü HTML formları oluşturma konusunda nasıl yardımcı olabilecekleri 
açıklanmaktadır. Bu belgeyi okuyabilmeniz İçin yardımcıları etiketleyerek okumanız önerilir. 

Birçok durumda, HTML Yardımcıları belirli bir etiket Yardımcısı için alternatif bir yaklaşım sağlar, ancak bu etiket 
yardımcıların HTML yardımcılarını değiştirmez ve her HTML Yardımcısı için bir etiket Yardımcısı olmadığını bilmek 
önemlidir. Bir HTML Yardımcısı alternatifi varsa, bu, bahsedilir. 

Form etiketi Yardımcısı 

Form etiketi Yardımcısı: 

• MVC denetleyicisi eylemi veya adlandırılmış yol için HTML <FORM > action öznitelik değeri oluşturur 


• Siteler arası istek yasaklamasını engellemek için gizli bir İstek doğrulama belirteci ÜRETİR (http post eylem 



Örnek: 

<form asp-controller="Demo" asp-action="Register" method="post"> 
<!-- Input and Submit elements --> 

</form> 


Yukarıdaki form etiketi Yardımcısı aşağıdaki HTML 'yi oluşturur: 



oluşturur. Bir saf HTML formunun siteler arası istek sahteciliğini önleme 'den korunması zordur, form etiketi 
Yardımcısı bu hizmeti sizin için sağlar. 

Adlandırılmış yol kullanma 


asp-route 

Tag Helper özniteliği, HTML 

action 

özniteliği için de biçimlendirme oluşturabilir. 

register 


uygulama, kayıt sayfası için aşağıdaki biçimlendirmeyi kullanabilir: 






















<form asp-route="register" method="post"> 
<!-- Input and Submit elements --> 
</form> 


Görünümler/hesap klasöründeki görünümlerin birçoğu ( bireysel kullanıcı hesaplarıylayenl bir Web uygulaması 
oluşturduğunuzda oluşturulur), ASP-Route-ReturnUrl özniteliğini içerir: 

<form asp-controllen="Account" asp-action="Login" 
asp-route-returnurl="@ViewData["Returnllrl"]" 
method="post" class="form-horizontal" role="form"> 


NOTE 

Yerleşik şablonlarla returniiri , yalnızca yetkili bir kaynağa erişmeye çalıştığınızda ancak kimliği doğrulanmamış veya 
yetkilendirilmeyen otomatik olarak doldurulur. Yetkisiz erişim yapmaya çalıştığınızda, güvenlik ara yazılımı sizi neturnuri 
kümesi ile oturum açma sayfasına yönlendirir. 


Form eylemi etiketi Yardımcısı 


Form eylemi etiketi Yardımcısı, formaction özniteliği oluşturulan <button ...> veya cinput type="image" ...> 


etiketi üzerinde oluşturur. 

formaction 

özniteliği bir formun verilerini nereden gönderdiğini denetler. 

image 

ve 

<düğme > öğeleri <giriş 

> öğelerine 

bağlanır. Form eylemi etiketi Yardımcısı, karşılık gelen öğe için 

formaction 


bağlantısının oluşturulduğunu denetlemek için birkaç AnchorTagHelper asp- özniteliği kullanımını sağlar, 
formaction değerini denetlemek için desteklenen AnchorTagHelper öznitelikleri: 


ÖZNITELIK 

AÇIKLAMA 

ASP-Controller 

Denetleyicinin adı. 

ASP-eylem 

Eylem yönteminin adı. 

ASP-alanı 

Alanın adı. 

asp-sayfa 

Razor sayfasının adı. 

ASP-Page-Handler 

Razor sayfası işleyicisinin adı. 

ASP-Route 

Rotanın adı. 

ASP-Route-{Value} 

Tek bir URL yol değeri. Örneğin: asp-route-id="i 234 " . 

ASP-Ali- Route- Data 

Tüm rota değerleri. 

ASP-Fragment 

URL parçası. 


Denetleyiciye gönder örneği 

Aşağıdaki biçimlendirme, giriş veya düğme seçildiğinde formu HomeControiler 


index eylemine gönderir: 














cform method="post"> 

<button asp-controller="Hom 0 ” asp-action="Index">Click Me</button> 
<input type="image" src="..." alt="Or Click Me" asp-controller="Home" 

asp-action="Index"> 

</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/Home">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" formaction="/Home"> 
</form> 


Sayfa örneğine gönder 

Aşağıdaki biçimlendirme formu About Razor sayfasına gönderir: 

<form method="post"> 

<button asp-page="About">Click Me</button> 

cinput type="image" src="...“ alt="Or Click Me" asp-page="About"> 
</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/About">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" formaction="/About"> 
</form> 


Yönlendirme örneğine gönder 

/Home/Test uç noktasını göz önünde bulundurun: 

public class HomeController : Controller 

{ 

[Route("/Home/Test", Name = "Custom")] 
public string Test() 

{ 

return "This is the test page"; 

} 

} 

Aşağıdaki biçimlendirme formu /Home/Test uç noktasına gönderir. 

<form method="post"> 

<button asp-route="Custom">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" asp-route="Custom"> 
</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/Home/Test">Click Me</button> 

cinput type="image" snc="..." alt="Or Click Me" formaction="/Home/Test"> 
</form> 











Giriş etiketi Yardımcısı 

Giriş etiketi Yardımcısı, bir HTML <girişi > öğesini Razor görünüminizdeki bir model ifadesine bağlar. 

Sözdizimi: 

cinput asp-for="<Expression Name>"> 

Giriş etiketi Yardımcısı: 

• asp-for özniteliğinde belirtilen ifade adı için id ve name HTML özniteliklerini üretir. 
asp-for="Propertyl.Property2" m => m.Propertyl.Property2 eşdeğerdir, ifadenin adi, asp-for Öznitelİği 

değeri için kullanılan şeydir. Ek bilgi için ifade adları bölümüne bakın. 

• Model özelliğine uygulanan model türüne ve veri ek açıklaması ÖZNİTELİKLERINE göre HTML type 
öznitelik değerini ayarlar 

• Belirtilirse, HTML type öznitelik değerinin üzerine yazmaz 

• Model özelliklerine uygulanan veri ek açıklama özniteliklerinden HTML5 doğrulama öznitelikleri oluşturur 

• Htmi.TextBoxFor ve Htmi.EditorFor bir HTML Yardımcısı özelliği örtüşüyor. Ayrıntılar için bkz. giriş etiketi 
Yardımcısı İçin HTML Yardımcısı alternatifleri. 

• Güçlü yazma sağlar.Özelliğin adı değişirse ve etiket yardımcısını güncelleştirmezseniz aşağıdakine benzer bir 
hata alırsınız: 



ve oluşturulan HTML türü listelenmekte (her .NET türü listelenmemiştir). 


.NET TÜRÜ 

GİRİŞ türü 

Bool 

Type = "onay kutusu" 

Dize 

Type = "metin" 

DateTime 

Type ="TarihSaat-yerel' 

Bayt 

Type = "Number" 

int 

Type = "Number" 

Tek, Çift 

Type = "Number" 


Aşağıdaki tabloda, giriş etiketi Yardımcısı 'nın belirli giriş türleriyle eşleşecağı bazı ortak veri ek açıklamaları (her 
doğrulama özniteliğı listelenmez) gösterilmektedir: 












OZNITELIK 


GİRİŞ TURU 


EmailAddress 

Type = "e-posta" 

'Deki 

Type = "URL" 

[Hiddenınput] 

Type = "Hidden" 

Numarası 

Type = "tel" 

[DataType (DataType. Password)] 

Type = "Passvvord" 

[DataType (DataType. Date)] 

Type = "Date" 

[DataType (DataType. Time)] 

yazın = "Time" 


Örnek: 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class RegisterViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 

[Required] 

[DataType(DataType.Password)] 
public stning Password { get; set; } 

} 

} 


@model RegisterViewModel 

<form asp-controller="Demo" asp-action="RegisterInput" method="post"> 
Email: <input asp-for="Email" /> <br /> 

Password: cinput asp-fon="Password" /><bn /> 

<button type="submit">Registen</button> 

</fonm> 


Yukarıdaki kod, aşağıdaki HTML 'yi oluşturur: 

<fonm method="post" action="/Demo/RegistenInput"> 

Email: 

<input type="email" data-val="tnue" 

data-val-email="The Email Addness field is not a valid email address." 
data-val-required="The Email Address field is required." 
id="Email" name="Email" value=""xbr> 

Password: 

cinput type="password" data-val="true" 

data-val-required="The Password field is required." 
id="Password" name="Password"xbr> 
cbutton type="submit">Register</button> 

cinput name="_RequestVerificationToken" type="hidden" value="cremoved for brevity>"> 

c/form> 




Email ve Passwond özelliklerine uygulanan veri ek açıklamaları modelde meta veriler oluşturur. Giriş etiketi 
Yardımcısı, model meta verilerini kullanır ve HTM L5 data-vai-* öznitelikleri üretir (bkz. model doğrulama). Bu 
öznitelikler, giriş alanlarına iliştirilecek Doğrulayıcıları anlatmaktadır. Bu unobtrusive HTML5 vejQuery doğrulaması 
sağlar. Unobtrusive özniteliklerinin biçimi data-vai-ruie="Error Message" , burada kural doğrulama kuralının adıdır 
(örneğin, data-val-required , data-val-email , data-val-maxlength vb.) Öznitelikte bir hata iletisi sağlanırsa, 
data-vai-rule özniteliği için değer olarak görüntülenir. Ayrıca, kuralla ilgili ek ayrıntılar sağlayan 
data-val-ruleName-argumentName="argumentValue" form Öznitelikleri de vardır, Örneğin, 
data-val-maxlength-max="1024" . 

Giriş etiketi Yardımcısı için HTML Yardımcısı alternatifleri 

Htmi.TextBox , Htmi.TextBoxFor , Htmi.Editör ve Htmi.EditorFor , giriş etiketi Yardımcısı ile çakışan özelliklere 


sahiptir. Giriş etiketi Yardımcısı 

type 

özniteliğini otomatik olarak ayarlar; 

Htmi.TextBox 

ve 

Htmi.TextBoxFor 


Htmi.Editör 

ve 

Htmi.EditorFor 

■ tanıtıcı koleksiyonları, karmaşık nesneler ve şablonlar; Giriş etiketi Yardımcısı yok. 

Giriş etiketi Yardımcısı, Htmi.EditorFor ve Htmi.TextBoxFor kesin türdedir (lambda ifadeleri kullanırlar); 

Html.TextBox 

ve 

Htmi.Editör ı 

değildir (ifade adlarını kullanırlar). 


HtmlAttributes 

@Htmi.Editor() ve @Htmi.EditorFor( ), varsayılan şablonlarını yürütürken htmiAttributes adlı özel bir 
viewDataDictionary girişi kullanır. Bu davranış, isteğe bağlı olarak additionaiviewData parametreleri kullanılarak 
genişletilebilir. "HtmlAttributes" anahtarı büyük/küçük harfe duyarlıdır."HtmlAttributes" anahtarı, @Htmi.TextBox() 
gibi giriş yardımcılarını geçirilmiş htmiAttributes nesnesine benzer şekilde işlenir. 

@Html.EditorFor(model => model.YourProperty, 

new { htmiAttributes = new { @class="myCssClass ", style="Width:100px" } }) 

İfade adları 

asp-for öznitelik değeri, bir lambda ifadesinin bir ModeiExpression ve sağ tarafıdır. Bu nedenle, 
asp-for="Propertyi" oluşturulan kodda m => m.Propertyi hale gelir ve bu nedenle Model ile önek gerektirmez. 
karakterini kullanarak bir satır içi ifadeyi başlatabilir ve m. önce taşıyabilirsiniz: 

@{ 

var joe = "Doe"; 

} 

<input asp-for="@joe"> 


Şunları üretir: 


cinput type="text" id="joe" name="joe" value="loe"> 


Koleksiyon özellikleriyle 

asp-for="CollectionProperty[23].Member" , 

asp-for="CollectionProperty[i].Member" 

aynı adı üretir. 


i değer 23 olduğunda 


ASP.NET Core MVC ModeiExpression değerini hesapladığında Modeistate dahil olmak üzere çeşitli kaynakları 
inceler, cinput type="text" asp-for="@Name"> göz önünde bulundurun. Hesaplanan value özniteliği, öğesinden 
gelen ilk null olmayan değerdir: 


• "Name" anahtarına sahip giriş Modeistate. 

• İfadenin sonucu Model.Name . 


Alt özelliklerde gezinme 

Ayrıca, görünüm modelinin özellik yolunu kullanarak alt Özellikler 1 e gidebilirsiniz. Alt Address özelliği içeren daha 
karmaşık bir model sınıfı düşünün. 











































public class AddressViewModel 

{ 

public string AddressLinel { get; set; } 

} 


public class RegisterAddressViewModel 

{ 

public string Email { get; set; } 

[DataType(DataType.Password)] 
public string Password { get; set; } 

public AddressViewModel Address { get; set; } 

} 

Görünümde Address.AddressLinei bağlandık: 


@model RegisterAddressViewModel 

<form asp-controller="Demo" asp-action="RegisterAddress" method="post"> 
Email: <input asp-for="Email" /> <br /> 

Password: <input asp-for="Password" /><br /> 

Address: <input asp-for="Address.AddressLinel" /><br /> 

<button type="submit">Register</button> 

</form> 


Address.AddressLinei için aşağıdaki HTML oluşturulmuştur: 

<input type="text" id="Address_AddressLinel" name="Address.AddressLinel" value=""> 


İfade adları ve koleksiyonlar 

Örnek, bir dizi colors içeren bir modeldir: 

public class Person 

{ 

public List<string> Colors { get; set; } 
public int Age { get; set; } 

} 

Eylem yöntemi: 


public IActionResult Edit(int id, int colorIndex) 

{ 

ViewData["Index"] = colorIndex; 
return View(GetPerson(id)); 

} 


Aşağıdaki Razor, belirli bir color öğesine nasıl erişistediğinizi göstermektedir: 











@model Person 

@{ 

var index = (int)ViewData["index"]; 

} 

<form asp-controller="ToDo" asp-action="Edit" method="post"> 
@Html.EditorFor(m => m.Colors[index]) 
dabel asp-for="Age"x/label> 

<input asp-for="Age" /><br /> 

<button type="submit">Post</button> 

</form> 


Views/Shared/EdltorTemplates/Strlng. cshtml şablonu: 

@model string 

<label asp-for="@Model"x/label> 

<input asp-for="@Model" /> <br /> 

List<T > kullanarak örnek: 


public class ToDoltem 

{ 

public string Name { get; set; } 
public bool IsDone { get; set; } 

} 


Aşağıdaki Razor, bir koleksiyonun üzerinde nasıl yineleme yapılacağını göstermektedir: 

@model List<ToDoItem> 

<form asp-controller="ToDo" asp-action="Edit" method="post"> 

<table> 

<tr> <th>Name</th> <th>Is Done</th> </tr> 

@for (int i = 0; i < Model.Count; i++) 

{ 

<tr> 

@Html.EditorFor(model => modelfi]) 

</tr> 

} 

</table> 

<button type="submit">Save</button> 

</form> 


Views/Shared/EditorTemplates/Todoltem. cshtml şablonu: 




@model ToDoltem 
<td> 

<label asp-for="@Model.Name"x/label> 

@Html.DisplayFor(model = > model.Name) 

</td> 

<td> 

cinput asp-fon="@Model.IsDone" /> 

</td> 

This template replaces the following Razor which evaluates the indexer three tlmes. 

<td> 

<label asp-for="@Model[i] .Name"x/label> 

@Html.DisplayFor(model => model[i].Name) 

</td> 

<td> 

<input asp-for="@Model[i].IsDone" /> 

</td> 

*@ 

değer bir asp-for veya Htmi.DisplayFor denk bir bağlamda kullanılacaksa, mümkünse foreach kullanılmalıdır. 
Genel olarak, for bir Numaralandırıcı ayırması gerekmiyorsa, foreach daha iyidir (senaryo buna izin veriyorsa). 
Ancak, bir LINQ ifadesinde bir dizin oluşturucuyu değerlendirmek pahalı olabilir ve simge durumuna küçültülmüş 
olmalıdır. 


NOTE 

Yukarıdaki açıklamalı örnek kod, listedeki her bir ToDoltem erişmek için lambda ifadesinin @ işleçle nasıl değiştirileceğini 
gösterir. 


TextArea etiketi Yardımcısı 

Textarea Tag Helper Tag Yardımcısı giriş etiketi Yardımcısı ile benzerdir. 

• id ve name özniteliklerini ve <textarea > öğesi için modelden veri doğrulama özniteliklerini üretir. 

• Güçlü yazma sağlar. 

• HTML Yardımcısı alternatifi: Htmi.TextAreaFor 
Örnek: 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class DescriptionViewModel 

{ 

[MinLength(S) ] 

[MaxLength(1024)] 

public stning Description { get; set; } 

} 

} 













@model DescriptionViewModel 

<form asp-controller="Demo" asp-action="RegisterTextArea" method="post"> 
<textarea asp-for="Description"x/textarea> 

<button type="submit">Test</button> 

</form> 


Aşağıdaki HTML oluşturulur: 

<form method="post" action="/Demo/RegisterTextArea"> 

<textarea data-val="true" 

data-val-maxlength="The field Description must be a string or array type with a maximum length of 
&#x27;1024&#x27;." 

data-val-maxlength-max="1024" 

data-val-minlength="The field Description must be a string or array type with a minimum length of 
&#x27;5&#x27; 

data-val-minlength-min="5" 

id="Description" name="Description") 

</textarea> 

<button type="submit">Test</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Etiket etiketi Yardımcısı 

• Bir ifade adı için bir <label > öğesinde etiket başlık yazısı ve for özniteliği oluşturur 

• HTML Yardımcısı alternatifi: Htmi.LabeiFor . 

Label Tag Helper , saf HTML etiket öğesi üzerinde aşağıdaki avantajları sağlar: 

• Display özniteliğinden açıklayıcı etiket değerini otomatik olarak alırsınız, istenen görünen ad zaman içinde 
değişebilir ve Display özniteliği ve etiket etiketi Yardımcısı 'nın birleşimi, Display her yere uygular. 

• Kaynak kodunda daha az biçimlendirme 

• Model özelliğiyle güçlü yazma. 

Örnek: 


using System.ComponentModel.DataAnnotations; 


namespace FormsTagHelper.ViewModels 

{ 


public class SimpleViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 

} 










@model SimpleViewModel 

<fonm asp-controller="Demo" asp-action="Registerl_abel" method="post"> 

<label asp-fon="Email"x/label> 

<input asp-for="Email" /> <br /> 

</form> 

<iabei> öğesi için aşağıdaki HTML oluşturulur: 

dabel for="Email">Email Address</label> 

Etiket etiketi Yardımcısı, <input> öğesiyle ilişkili KİMLİK olan "e-posta" for öznitelik değerini oluşturdu. Etiket 
Yardımcıları, doğru ilişkilendirilebilen şekilde tutarlı id ve for öğeleri oluşturur. Bu örnekteki başlık Display 
özniteliğinden gelir. Modelde bir Display özniteliği yoksa, başlık ifadenin Özellik adı olacaktır. 

Doğrulama etiketi yardımcıları 

iki doğrulama etiketi yardımcıları vardır, validation Message Tag Helper (modelinizdeki tek bir özellik için bir 
doğrulama iletisi görüntüler) ve validation summary Tag Helper (doğrulama hatalarının özetini görüntüler), 
input Tag Helper , model sınıflarınızda bulunan veri ek açıklaması özniteliklerini temel alan giriş öğelerine HTML5 
istemci tarafı doğrulama öznitelikleri ekler. Doğrulama de sunucuda gerçekleştirilir. Doğrulama etiketi Yardımcısı, 
bir doğrulama hatası oluştuğunda bu hata iletilerini görüntüler. 

Doğrulama İletisi etiketi Yardımcısı 

• Belirtilen model özelliğinin giriş alanındaki doğrulama hatası mesajlarını bağlayan span öğesine HTML5 
data-vaimsg-for="property" özniteliğini ekler, istemci tarafı doğrulama hatası oluştuğunda, jöuery <span> 

öğesinde hata iletisini görüntüler. 

• Doğrulama de sunucuda gerçekleşir, istemciler JavaScript devre dışı bırakılmış olabilir ve bazı doğrulamalar 
yalnızca sunucu tarafında yapılabilir. 

• HTML Yardımcısı alternatifi: Html.ValidationMessageFor 

validation Message Tag Helper , bir HTML span öğesinde asp-validation-for özniteliğiyle kullanılır. 

<span asp-validation-for="Email"></span> 

Doğrulama İletisi etiketi Yardımcısı aşağıdaki HTML 'yi oluşturur: 

<span class="field-validation-valid" 
data-valmsg-for="Email" 
data-valmsg-replace="true"x/span> 

Aynı özellik için bir input etiketi Yardımcısı sonrasında validation Message Tag Helper genellikle kullanırsınız. 
Bunun yapılması, hataya neden olan girişin yakınında herhangi bir doğrulama hata iletisi görüntüler. 


NOTE 

İstemci tarafı doğrulaması için doğru JavaScript ve jQuery betik başvurularını içeren bir görünümsiniz olmalıdır. Daha fazla bilgi 
için bkz. model doğrulaması . 


Sunucu tarafı doğrulama hatası oluştuğunda (örneğin, özel sunucu tarafı doğrulamadan veya istemci tarafı 
doğrulaması devre dışı bırakılmışsa), MVC bu hata iletisini <span> öğesinin gövdesi olarak koyar. 




















<span class="field-validation-error" data-valmsg-for="Email" 
data-valmsg-replace="true"> 

The Email Address field is required. 

</span> 


Doğrulama Özeti etiketi Yardımcısı 

• asp-validation-summary özniteliği olan öğeleri <div> hedefleri 

• HTML Yardımcısı alternatifi: @Html.ValidationSummary 

Validation Summary Tag Helper , doğrulama iletilerinin Özetini göstermek için kullanılır, asp-validation-summary 
öznitelik değeri, aşağıdakilerden herhangi biri olabilir: 

ASP-DOĞRULAMA-ÖZET GÖRÜNEN DOĞRULAMA İLETİLERİ 

ValidationSummary. Ali Özellik ve model düzeyi 

Yalnızca ValidationSummary. model Model 

ValidationSummary. None Yok. 

Örnek 

Aşağıdaki örnekte, veri modelinde <input> öğesinde doğrulama hata iletileri üreten DataAnnotation öznitelikleri 
vardır. Doğrulama hatası oluştuğunda, doğrulama etiketi Yardımcısı şu hata iletisini görüntüler: 

using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class RegisterViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 

[Required] 

[DataType(DataType.Password)] 
public string Password { get; set; } 

} 

} 


@model RegisterViewModel 

<form asp-controller="Demo" asp-action="RegisterValidation" method="post"> 
<div asp-validation-summary="ModelOnly"x/div> 

Email: <input asp-for="Email" /> <br /> 

<span asp-validation-for="Email"x/spanxbr /> 

Password: <input asp-for="Password" /xbr /> 

<span asp-validation-for="Password"x/spanxbr /> 

<button type="submit">Register</button> 

</form> 


Oluşturulan HTML (model geçerli olduğunda): 











<form action="/DemoReg/Register" method="post"> 

<div class="validation-summary-valid" data-valmsg-summary="true"> 

<ulxli style="display: none"x/lix/ulx/div> 

Email: cinput name="Email" id="Email" type="email" value="" 
data-val-required="The Email field is required." 
data-val-email="The Email field is not a valid email address." 
data-val="true"xbr> 

<span elass="field-validation-valid" data-valmsg-replace="true" 
data-valmsg-fon=" Email "x/spanxbr> 

Password: <input name="Password" id="Password" type="password" 
data-val-required="The Password field is required." data-val="true"xbr> 

<span elass="field-validation-valid" data-valmsg-replace="true" 
data-valmsg-fon="Password"x/spanxbn> 

<button type="submit">Registen</button> 

cinput name="_RequestVerificationToken" type="hidden" value="<removed fon brevity>"> 

</fonm> 


Etiket Seç Yardımcısı 

• Modelinizin özellikleri için Select ve ilişkili seçenek öğeleri oluşturur. 



Örneğin: 


<select asp-for="Country" asp-items="Model.Countries"x/select> 


Örnek: 


using Microsoft.AspNetCone.Mvc.Rendering; 
using System.Collections.Generic; 

namespace FonmsTagHelpen.ViewModels 

{ 

public elass CountryViewModel 

{ 

public stning Country { get; set; } 

public List<SelectListItem> Countnies { get; } = new List<SelectListItem> 

{ 

new SelectListltem { Value = "MX", Text = "Mexico" }j 

new SelectListltem { Value = "CA", Text = "Canada" }j 

new SelectListltem { Value = "US", Text = "USA" }, 

}; 

} 

} 


index yöntemi countnyviewModei başlatır, seçilen ülkeyi ayarlar ve index görünümüne geçirir. 

public IActionResult Index() 

{ 

var model = new CountryViewModel(); 
model.Country = "CA"; 
return View(model); 

} 


HTTP POST index yöntemi seçimi görüntüler: 













[HttpPost] 

[ValidateAntiForgeryToken] 

public IActionResult Index(CountryViewModel model) 

{ 

if (ModelState.IsValid) 

{ 

var msg = model.Country + " selected"; 

return RedirectToAction("IndexSuccess", new { message = msg }); 

} 

// If we got this far, something failed; redlsplay form, 
return View(model); 


index görünümü: 


@model CountryViewModel 

<form asp-controller="Home" asp-action="Index" method="post"> 

<select asp-for="Country" asp-items="Model .Countries"x/select> 
<br /><button type="submit">Register</button> 

</form> 


Aşağıdaki HTML 'yi üreten ("CA" seçiliyken): 


<form method="post" action="/"> 

<select id="Country" name="Country"> 

<option value="MX">Mexico</option> 

coption selected="selected" value="CA">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


NOTE 

Etiket Seç Yardımcısı ile viewBag veya viewData kullanmanızı önermiyoruz. Bir görünüm modeli, MVC meta verileri 
sağlamaya ve genellikle daha az soruna neden olacak daha sağlamdır. 


asp-for öznitelik değeri özel bir durumdur ve Model öneki gerektirmez, diğer etiket Yardımcısı öznitelikleri olur ( 
asp-items gibi) 

<select asp-for="Country" asp-items="Model.Countries"x/select> 


Sabit Listesi bağlama 

<seiect> , enum bir özellik ile kullanmak ve enum değerlerinden selectListitem öğeleri oluşturmak için 
kullanışlıdır. 


Örnek: 









public class CountryEnumViewModel 

{ 

public CountryEnum EnumCountry { get; set; } 

} 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public enum CountryEnum 

{ 

[Display(Name = "United Mexican States")] 
Mexico, 

[Display(Name = "United States of America")] 
USA, 

Canada, 

France, 

Germany, 

Spain 

} 

} 


GetEnumSelectList yöntemi bir numaralandırma için selectList nesnesi oluşturur. 

@model CountryEnumViewModel 

<form asp-controller="Home" asp-action="IndexEnum" method="post"> 

<select asp-for="EnumCountry" 

asp-items="Html.GetEnumSelectList<CountryEnum>()"> 

</select> 

<br /><button type="submit">Register</button> 

</form> 

Daha zengin bir kullanıcı arabirimi almak için, Numaralandırıcı listenizi Display özniteliğiyle işaretleyebilirsiniz: 

using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public enum CountryEnum 

{ 

[Display(Name = "United Mexican States")] 

Mexico, 

[Display(Name = "United States of America")] 

USA, 

Canada, 

France, 

Germany, 

Spain 

} 

} 


Aşağıdaki HTML oluşturulur: 






<form method="post" action="/Home/IndexEnum"> 

<select data-val="true" data-val-required="The EnumCountry field is required." 
id="EnumCountry" name="EnumCountry"> 

<option value="0">United Mexican States</option> 

<option value="l">United States of America</option> 

<option value="2">Canada</option> 

<option value="3">France</option> 
coption value="4">Germany</option> 

<option selected="selected" value="5">Spain</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Seçenek grubu 

HTML <SeçenekGrubu > öğesi, görünüm modelinde bir veya daha fazla selectListGroup nesnesi içerdiğinde 
oluşturulur. 

countryviewModeiGroup , selectListitem öğelerini "Kuzey Amerika" ve "Avrupa" gruplarına gruplandırır: 






public class CountryViewModelGroup 

{ 

public CountryViewModelGroup() 

{ 

var NorthAmericaGroup = new SelectListGroup { Name = "North America" }; 
var EuropeGroup = new SelectListGroup { Name = "Europe" }; 

Countries = new List<SelectListItem> 

{ 

new SelectListltem 

{ 

Value = "MEX", 

Text = "Mexico", 

Group = NorthAmericaGroup 

}, 

new SelectListltem 

{ 

Value = "CAN", 

Text = "Canada", 

Group = NorthAmericaGroup 

b 

new SelectListltem 

{ 

Value = "US", 

Text = "USA", 

Group = NorthAmericaGroup 

b 

new SelectListltem 

{ 

Value = "FR", 

Text = "France", 

Group = EuropeGroup 

b 

new SelectListltem 

{ 

Value = "ES", 

Text = "Spain", 

Group = EuropeGroup 

b 

new SelectListltem 

{ 

Value = "DE", 

Text = "Germany", 

Group = EuropeGroup 

} 

b 

} 

public string Country { get; set; } 

public List<SelectListItem> Countries { get; } 


iki grup aşağıda gösterilmiştir: 






B localhost 

X + — o x 

<- O 1 
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North America 


Mexico 


Canada 


USA 


Europe 


France 


Spain 


Germany 



Oluşturulan HTML: 


<form method="post" action="/Home/IndexGroup"> 

<select id="Country" name="Country"> 

<optgroup label="North America"» 

coption value="MEX">Mexicoc/option> 

<option value="CAN">Canada</option> 
coption value="US">USA</option> 

</optgroup> 

coptgroup label="Europe"> 

coption value="FR">Francec/option> 
coption value="ES">Spainc/option> 
coption value="DE">Germanyc/option> 
c/optgroup> 
c/select> 

cbr /»cbutton type="submit">Registerc/button> 

cinput name="_RequestVerificationToken" type="hidden" value="cremoved for brevity>"> 

c/form> 


Çoklu seçim 

asp-for özniteliğinde belirtilen özellik bir iEnumerabie ise, select etiketi Yardımcısı otomatik olarak birden çok = 
"Muitiple" özniteliği oluşturacaktır. Örneğin, aşağıdaki model verildiğinde: 


using Microsoft.AspNetCore.Mvc. Rendering; 
using System.Collections.Generic; 

namespace FormsTagHelper.ViewModels 

{ 

public class CountryViewModelIEnumerable 

{ 

public IEnumerablecstring» CountryCodes { get; set; } 

public ListcSelectListltem» Countries { get; } = new ListcSelectListltem» 

{ 

new SelectListltem { Value = "MX", Text = "Mexico" }, 

new SelectListltem { Value = "CA", Text = "Canada" }j 

new SelectListltem { Value = "US", Text = "USA" }, 

new SelectListltem { Value = "FR", Text = "France" }, 

new SelectListltem { Value = "ES", Text = "Spain" }, 

new SelectListltem { Value = "DE", Text = "Germany"} 

}; 

} 

} 


Aşağıdaki görünümle: 












@model CountryViewModelIEnumerable 

<form asp-controller="Home" asp-action="IndexMultiSelect" method="post"> 
<select asp-for="CountryCodes" asp-items="Model.Countries"x/select> 
<br /><button type="submit">Register</button> 

</form> 


Aşağıdaki HTML 'yi oluşturur: 

<form method="post" action="/Home/IndexMultiSelect"> 

<select id="CountryCodes" 
muitiple="muitiple" 

name="CountryCodes"xoption value="MX">Mexico</option> 

<option value="CA">Canada</option> 

<option value="US">USA</option> 

<option value="FR">France</option> 

<option value="ES">Spain</option> 

<option value="DE">Germany</option> 

</select> 

<br /xbutton type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Seçim yok 

Birden çok sayfada "belirtilmemiş" seçeneğini kullanarak kendinizi bulursanız, HTML 'yi yinelemeyi ortadan 
kaldırmak için bir şablon oluşturabilirsiniz: 

@model CountryViewModel 

<form asp-controller="Home" asp-action="IndexEmpty" method="post"> 

@Fltml. EditorForModel() 

<br /xbutton type="submit">Register</button> 

</form> 


Vİews/Shared/EditorTemplates/CountryVievvModel, cshtml şablonu: 

@model CountryViewModel 

<select asp-for="Country" asp-items="Model.Countr'ies"> 

<option value="">--none--</option> 

</select> 


HTML <seçenek > öğeleri ekleme hiçbir seçim durumuyla sınırlı değildir. Örneğin, aşağıdaki görünüm ve eylem 
yöntemi yukarıdaki koda benzer HTML oluşturur: 


public IActionResult IndexNone() 

{ 

var model = new CountryViewModel(); 
model.Insert(0j new SelectListItem("<none>", 


return Vlew(model); 

} 









@model CountryViewModel 

<form asp-controller="Home" asp-action="IndexEmpty" method="post"> 

<select asp-for="Country"> 

<option value="">&lt;none&gt;</option> 
coption value="MX">Mexico</option> 

<option value="CA">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

</form> 

Geçerli country değerine bağlı olarak doğru <option> öğesi seçilecek ( seiected="seiected" özniteliğini içerir). 

public IActionResult IndexOption(int id) 

{ 

var model = new CountryViewModel(); 
model.Country = "CA"; 
return View(model); 

} 


<form method="post" action="/Home/IndexEmpty"> 

<select id="Country" name="Country"> 

<option value="">&lt;none&gt;</option> 

<option value="MX">Mexico</option> 

<option value="CA" selected="selected">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Ek kaynaklar 

• ASP.NET Core etiket yardımcıları 

• HTML form öğesi 

• istek doğrulama belirteci 

• ASP.NET Core'de model bağlama 

• ASP.NET Core MVC 'de model doğrulaması 

• lattributeadapter arabirimi 

• Bu belge için kod parçacıkları 







ASPNET core'da görüntü etiketi Yardımcısı 

12.07.2019 • 2 minutes to read ı Edjt Online 


Tarafından Peter Kellner 

Görüntü etiketi Yardımcısı geliştirir <img> statik resim dosyaları için önbellek busting davranışı sağlamak için 
etiket. 

Bir önbellek busting dize varlığın URL'ye eklenen statik görüntü dosyasının bir karmasını temsil eden benzersiz 
bir değerdir. Benzersiz bir dize istemciler (ve bazı Ara sunucular) konak web sunucusu ve istemci önbelleğinden 
görüntü yeniden yüklemek ister. 

Varsa resim kaynağını ( src ) konak web sunucusundaki bir statik dosya: 

• Önbellek busting benzersiz bir dize, görüntü kaynağı için bir sorgu parametresi olarak eklenir. 

• Konak web sunucusunda dosyayı değişirse, güncelleştirilmiş istek parametresi içeren bir benzersiz istek URL'si 
oluşturulur. 

Etiket Yardımcıları genel bakış için bkz. AS P.N ET Core etiket yardımcıları. 

Görüntü etiketi Yardımcısı öznitelikleri 

src 

Görüntü etiketi Yardımcısı, etkinleştirme src öznitelik gerekli <img> öğesi. 

Resim kaynağını ( src ) statik fiziksel bir dosya sunucusuna işaret etmelidir.Varsa src uzak bir URI önbelleği 
busting sorgu dizesi parametresi oluşturulmadığından. 

ASP ekleme sürümü 

Zaman asp-append-version ile belirtilen bir true değer ile birlikte bir src özniteliği, görüntü etiketi Yardımcısı 
çağrılır. 

Aşağıdaki örnek, bir görüntü etiketi Yardımcısı kullanır: 

cimg src="~/images/asplogo.png" asp-append-version="true"> 

Statik dosya dizininde bulunuyorsa /wwwroot/resimler/, oluşturulan HTML (karma farklı olacaktır) aşağıdakine 
benzer: 

cimg src="/images/asplogo.png?v=Kl_dqr9NVtnMdsM2MUg4qthUnİAİZm5TlfCEİmBPWDNgM"> 

Parametresine atanan değer v karma değeri asplogo.png diskteki dosya. Web sunucusu statik dosya için okuma 
erişimi alamadı ise hiçbir v parametresi eklenir src biçimlendirmenin özniteliği. 

Karma önbelleğe alma davranışı 

Görüntü etiketi Yardımcısı önbelleği sağlayıcısı hesaplanan depolamak için yerel web sunucusu üzerinde kullanır 
Sha5i2 belirli bir dosya karması. Dosyanın birden çok kez istenirse, karma yeniden hesaplanması değil. Önbellek 
dosyaya eklenmiş bir dosya izleyicisi tarafından geçersiz olduğunda dosyanın Sha5i2 karma hesaplanır. Dosyanın 
diskte değiştiğinde yeni bir karma hesaplanır ve önbelleğe alınmış. 














Ek kaynaklar 

• ASP.NET Core'de önbellek belleği 


ASPNET Core formlardaki etiket yardımcıları 

6.12.2019 • 27 minutes to read ı Edit Online 


By Rick Anderson, N. Taylor Mullen, Davve Patııve Jerrie Pelser 

Bu belge, formlarda ve genellikle form üzerinde kullanılan HTML öğeleriyle çalışmayı gösterir. HTML form öğesi, 
Web uygulamalarının sunucuya veri geri göndermek için kullanacağı birincil mekanizmayı sağlar. Bu belgenin 
çoğunda Etiket Yardımcıları ve BUNLARıN güçlü HTML formları oluşturma konusunda nasıl yardımcı olabilecekleri 
açıklanmaktadır. Bu belgeyi okuyabilmeniz İçin yardımcıları etiketleyerek okumanız önerilir. 

Birçok durumda, HTML Yardımcıları belirli bir etiket Yardımcısı için alternatif bir yaklaşım sağlar, ancak bu etiket 
yardımcıların HTML yardımcılarını değiştirmez ve her HTML Yardımcısı için bir etiket Yardımcısı olmadığını bilmek 
önemlidir. Bir HTML Yardımcısı alternatifi varsa, bu, bahsedilir. 

Form etiketi Yardımcısı 

Form etiketi Yardımcısı: 

• MVC denetleyicisi eylemi veya adlandırılmış yol için HTML <FORM > action öznitelik değeri oluşturur 


• Siteler arası istek yasaklamasını engellemek için gizli bir İstek doğrulama belirteci ÜRETİR (http post eylem 



Örnek: 

<form asp-controller="Demo" asp-action="Register" method="post"> 
<!-- Input and Submit elements --> 

</form> 


Yukarıdaki form etiketi Yardımcısı aşağıdaki HTML 'yi oluşturur: 



oluşturur. Bir saf HTML formunun siteler arası istek sahteciliğini önleme 'den korunması zordur, form etiketi 
Yardımcısı bu hizmeti sizin için sağlar. 

Adlandırılmış yol kullanma 


asp-route 

Tag Helper özniteliği, HTML 

action 

özniteliği için de biçimlendirme oluşturabilir. 

register 


uygulama, kayıt sayfası için aşağıdaki biçimlendirmeyi kullanabilir: 






















<form asp-route="register" method="post"> 
<!-- Input and Submit elements --> 
</form> 


Görünümler/hesap klasöründeki görünümlerin birçoğu ( bireysel kullanıcı hesaplarıylayenl bir Web uygulaması 
oluşturduğunuzda oluşturulur), ASP-Route-ReturnUrl özniteliğini içerir: 

<form asp-controllen="Account" asp-action="Login" 
asp-route-returnurl="@ViewData["Returnllrl"]" 
method="post" class="form-horizontal" role="form"> 


NOTE 

Yerleşik şablonlarla returniiri , yalnızca yetkili bir kaynağa erişmeye çalıştığınızda ancak kimliği doğrulanmamış veya 
yetkilendirilmeyen otomatik olarak doldurulur. Yetkisiz erişim yapmaya çalıştığınızda, güvenlik ara yazılımı sizi neturnuri 
kümesi ile oturum açma sayfasına yönlendirir. 


Form eylemi etiketi Yardımcısı 


Form eylemi etiketi Yardımcısı, formaction özniteliği oluşturulan <button ...> veya cinput type="image" ...> 


etiketi üzerinde oluşturur. 

formaction 

özniteliği bir formun verilerini nereden gönderdiğini denetler. 

image 

ve 

<düğme > öğeleri <giriş 

> öğelerine 

bağlanır. Form eylemi etiketi Yardımcısı, karşılık gelen öğe için 

formaction 


bağlantısının oluşturulduğunu denetlemek için birkaç AnchorTagHelper asp- özniteliği kullanımını sağlar, 
formaction değerini denetlemek için desteklenen AnchorTagHelper öznitelikleri: 


ÖZNITELIK 

AÇIKLAMA 

ASP-Controller 

Denetleyicinin adı. 

ASP-eylem 

Eylem yönteminin adı. 

ASP-alanı 

Alanın adı. 

asp-sayfa 

Razor sayfasının adı. 

ASP-Page-Handler 

Razor sayfası işleyicisinin adı. 

ASP-Route 

Rotanın adı. 

ASP-Route-{Value} 

Tek bir URL yol değeri. Örneğin: asp-route-id="i 234 " . 

ASP-Ali- Route- Data 

Tüm rota değerleri. 

ASP-Fragment 

URL parçası. 


Denetleyiciye gönder örneği 

Aşağıdaki biçimlendirme, giriş veya düğme seçildiğinde formu HomeControiler 


index eylemine gönderir: 














cform method="post"> 

<button asp-controller="Hom 0 ” asp-action="Index">Click Me</button> 
<input type="image" src="..." alt="Or Click Me" asp-controller="Home" 

asp-action="Index"> 

</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/Home">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" formaction="/Home"> 
</form> 


Sayfa örneğine gönder 

Aşağıdaki biçimlendirme formu About Razor sayfasına gönderir: 

<form method="post"> 

<button asp-page="About">Click Me</button> 

cinput type="image" src="...“ alt="Or Click Me" asp-page="About"> 
</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/About">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" formaction="/About"> 
</form> 


Yönlendirme örneğine gönder 

/Home/Test uç noktasını göz önünde bulundurun: 

public class HomeController : Controller 

{ 

[Route("/Home/Test", Name = "Custom")] 
public string Test() 

{ 

return "This is the test page"; 

} 

} 

Aşağıdaki biçimlendirme formu /Home/Test uç noktasına gönderir. 

<form method="post"> 

<button asp-route="Custom">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" asp-route="Custom"> 
</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/Home/Test">Click Me</button> 

cinput type="image" snc="..." alt="Or Click Me" formaction="/Home/Test"> 
</form> 











Giriş etiketi Yardımcısı 

Giriş etiketi Yardımcısı, bir HTML <girişi > öğesini Razor görünüminizdeki bir model ifadesine bağlar. 

Sözdizimi: 

cinput asp-for="<Expression Name>"> 

Giriş etiketi Yardımcısı: 

• asp-for özniteliğinde belirtilen ifade adı için id ve name HTML özniteliklerini üretir. 
asp-for="Propertyl.Property2" m => m.Propertyl.Property2 eşdeğerdir, ifadenin adi, asp-for Öznitelİği 

değeri için kullanılan şeydir. Ek bilgi için ifade adları bölümüne bakın. 

• Model özelliğine uygulanan model türüne ve veri ek açıklaması ÖZNİTELİKLERINE göre HTML type 
öznitelik değerini ayarlar 

• Belirtilirse, HTML type öznitelik değerinin üzerine yazmaz 

• Model özelliklerine uygulanan veri ek açıklama özniteliklerinden HTML5 doğrulama öznitelikleri oluşturur 

• Htmi.TextBoxFor ve Htmi.EditorFor bir HTML Yardımcısı özelliği örtüşüyor. Ayrıntılar için bkz. giriş etiketi 
Yardımcısı İçin HTML Yardımcısı alternatifleri. 

• Güçlü yazma sağlar.Özelliğin adı değişirse ve etiket yardımcısını güncelleştirmezseniz aşağıdakine benzer bir 
hata alırsınız: 



ve oluşturulan HTML türü listelenmekte (her .NET türü listelenmemiştir). 


.NET TÜRÜ 

GİRİŞ türü 

Bool 

Type = "onay kutusu" 

Dize 

Type = "metin" 

DateTime 

Type ="TarihSaat-yerel' 

Bayt 

Type = "Number" 

int 

Type = "Number" 

Tek, Çift 

Type = "Number" 


Aşağıdaki tabloda, giriş etiketi Yardımcısı 'nın belirli giriş türleriyle eşleşecağı bazı ortak veri ek açıklamaları (her 
doğrulama özniteliğı listelenmez) gösterilmektedir: 












OZNITELIK 


GİRİŞ TURU 


EmailAddress 

Type = "e-posta" 

'Deki 

Type = "URL" 

[Hiddenınput] 

Type = "Hidden" 

Numarası 

Type = "tel" 

[DataType (DataType. Password)] 

Type = "Passvvord" 

[DataType (DataType. Date)] 

Type = "Date" 

[DataType (DataType. Time)] 

yazın = "Time" 


Örnek: 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class RegisterViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 

[Required] 

[DataType(DataType.Password)] 
public stning Password { get; set; } 

} 

} 


@model RegisterViewModel 

<form asp-controller="Demo" asp-action="RegisterInput" method="post"> 
Email: <input asp-for="Email" /> <br /> 

Password: cinput asp-fon="Password" /><bn /> 

<button type="submit">Registen</button> 

</fonm> 


Yukarıdaki kod, aşağıdaki HTML 'yi oluşturur: 

<fonm method="post" action="/Demo/RegistenInput"> 

Email: 

<input type="email" data-val="tnue" 

data-val-email="The Email Addness field is not a valid email address." 
data-val-required="The Email Address field is required." 
id="Email" name="Email" value=""xbr> 

Password: 

cinput type="password" data-val="true" 

data-val-required="The Password field is required." 
id="Password" name="Password"xbr> 
cbutton type="submit">Register</button> 

cinput name="_RequestVerificationToken" type="hidden" value="cremoved for brevity>"> 

c/form> 




Email ve Passwond özelliklerine uygulanan veri ek açıklamaları modelde meta veriler oluşturur. Giriş etiketi 
Yardımcısı, model meta verilerini kullanır ve HTM L5 data-vai-* öznitelikleri üretir (bkz. model doğrulama). Bu 
öznitelikler, giriş alanlarına iliştirilecek Doğrulayıcıları anlatmaktadır. Bu unobtrusive HTML5 vejQuery doğrulaması 
sağlar. Unobtrusive özniteliklerinin biçimi data-vai-ruie="Error Message" , burada kural doğrulama kuralının adıdır 
(örneğin, data-val-required , data-val-email , data-val-maxlength vb.) Öznitelikte bir hata iletisi sağlanırsa, 
data-vai-rule özniteliği için değer olarak görüntülenir. Ayrıca, kuralla ilgili ek ayrıntılar sağlayan 
data-val-ruleName-argumentName="argumentValue" form Öznitelikleri de vardır, Örneğin, 
data-val-maxlength-max="1024" . 

Giriş etiketi Yardımcısı için HTML Yardımcısı alternatifleri 

Htmi.TextBox , Htmi.TextBoxFor , Htmi.Editör ve Htmi.EditorFor , giriş etiketi Yardımcısı ile çakışan özelliklere 


sahiptir. Giriş etiketi Yardımcısı 

type 

özniteliğini otomatik olarak ayarlar; 

Htmi.TextBox 

ve 

Htmi.TextBoxFor 


Htmi.Editör 

ve 

Htmi.EditorFor 

■ tanıtıcı koleksiyonları, karmaşık nesneler ve şablonlar; Giriş etiketi Yardımcısı yok. 

Giriş etiketi Yardımcısı, Htmi.EditorFor ve Htmi.TextBoxFor kesin türdedir (lambda ifadeleri kullanırlar); 

Html.TextBox 

ve 

Htmi.Editör ı 

değildir (ifade adlarını kullanırlar). 


HtmlAttributes 

@Htmi.Editor() ve @Htmi.EditorFor( ), varsayılan şablonlarını yürütürken htmiAttributes adlı özel bir 
viewDataDictionary girişi kullanır. Bu davranış, isteğe bağlı olarak additionaiviewData parametreleri kullanılarak 
genişletilebilir. "HtmlAttributes" anahtarı büyük/küçük harfe duyarlıdır."HtmlAttributes" anahtarı, @Htmi.TextBox() 
gibi giriş yardımcılarını geçirilmiş htmiAttributes nesnesine benzer şekilde işlenir. 

@Html.EditorFor(model => model.YourProperty, 

new { htmiAttributes = new { @class="myCssClass ", style="Width:100px" } }) 

İfade adları 

asp-for öznitelik değeri, bir lambda ifadesinin bir ModeiExpression ve sağ tarafıdır. Bu nedenle, 
asp-for="Propertyi" oluşturulan kodda m => m.Propertyi hale gelir ve bu nedenle Model ile önek gerektirmez. 
karakterini kullanarak bir satır içi ifadeyi başlatabilir ve m. önce taşıyabilirsiniz: 

@{ 

var joe = "Doe"; 

} 

<input asp-for="@joe"> 


Şunları üretir: 


cinput type="text" id="joe" name="joe" value="loe"> 


Koleksiyon özellikleriyle 

asp-for="CollectionProperty[23].Member" , 

asp-for="CollectionProperty[i].Member" 

aynı adı üretir. 


i değer 23 olduğunda 


ASP.NET Core MVC ModeiExpression değerini hesapladığında Modeistate dahil olmak üzere çeşitli kaynakları 
inceler, cinput type="text" asp-for="@Name"> göz önünde bulundurun. Hesaplanan value özniteliği, öğesinden 
gelen ilk null olmayan değerdir: 


• "Name" anahtarına sahip giriş Modeistate. 

• İfadenin sonucu Model.Name . 


Alt özelliklerde gezinme 

Ayrıca, görünüm modelinin özellik yolunu kullanarak alt Özellikler 1 e gidebilirsiniz. Alt Address özelliği içeren daha 
karmaşık bir model sınıfı düşünün. 











































public class AddressViewModel 

{ 

public string AddressLinel { get; set; } 

} 


public class RegisterAddressViewModel 

{ 

public string Email { get; set; } 

[DataType(DataType.Password)] 
public string Password { get; set; } 

public AddressViewModel Address { get; set; } 

} 

Görünümde Address.AddressLinei bağlandık: 


@model RegisterAddressViewModel 

<form asp-controller="Demo" asp-action="RegisterAddress" method="post"> 
Email: <input asp-for="Email" /> <br /> 

Password: <input asp-for="Password" /><br /> 

Address: <input asp-for="Address.AddressLinel" /><br /> 

<button type="submit">Register</button> 

</form> 


Address.AddressLinei için aşağıdaki HTML oluşturulmuştur: 

<input type="text" id="Address_AddressLinel" name="Address.AddressLinel" value=""> 


İfade adları ve koleksiyonlar 

Örnek, bir dizi colors içeren bir modeldir: 

public class Person 

{ 

public List<string> Colors { get; set; } 
public int Age { get; set; } 

} 

Eylem yöntemi: 


public IActionResult Edit(int id, int colorIndex) 

{ 

ViewData["Index"] = colorIndex; 
return View(GetPerson(id)); 

} 


Aşağıdaki Razor, belirli bir color öğesine nasıl erişistediğinizi göstermektedir: 











@model Person 

@{ 

var index = (int)ViewData["index"]; 

} 

<form asp-controller="ToDo" asp-action="Edit" method="post"> 
@Html.EditorFor(m => m.Colors[index]) 
dabel asp-for="Age"x/label> 

<input asp-for="Age" /><br /> 

<button type="submit">Post</button> 

</form> 


Views/Shared/EdltorTemplates/Strlng. cshtml şablonu: 

@model string 

<label asp-for="@Model"x/label> 

<input asp-for="@Model" /> <br /> 

List<T > kullanarak örnek: 


public class ToDoltem 

{ 

public string Name { get; set; } 
public bool IsDone { get; set; } 

} 


Aşağıdaki Razor, bir koleksiyonun üzerinde nasıl yineleme yapılacağını göstermektedir: 

@model List<ToDoItem> 

<form asp-controller="ToDo" asp-action="Edit" method="post"> 

<table> 

<tr> <th>Name</th> <th>Is Done</th> </tr> 

@for (int i = 0; i < Model.Count; i++) 

{ 

<tr> 

@Html.EditorFor(model => modelfi]) 

</tr> 

} 

</table> 

<button type="submit">Save</button> 

</form> 


Views/Shared/EditorTemplates/Todoltem. cshtml şablonu: 




@model ToDoltem 
<td> 

<label asp-for="@Model.Name"x/label> 

@Html.DisplayFor(model = > model.Name) 

</td> 

<td> 

cinput asp-fon="@Model.IsDone" /> 

</td> 

This template replaces the following Razor which evaluates the indexer three tlmes. 

<td> 

<label asp-for="@Model[i] .Name"x/label> 

@Html.DisplayFor(model => model[i].Name) 

</td> 

<td> 

<input asp-for="@Model[i].IsDone" /> 

</td> 

*@ 

değer bir asp-for veya Htmi.DisplayFor denk bir bağlamda kullanılacaksa, mümkünse foreach kullanılmalıdır. 
Genel olarak, for bir Numaralandırıcı ayırması gerekmiyorsa, foreach daha iyidir (senaryo buna izin veriyorsa). 
Ancak, bir LINQ ifadesinde bir dizin oluşturucuyu değerlendirmek pahalı olabilir ve simge durumuna küçültülmüş 
olmalıdır. 


NOTE 

Yukarıdaki açıklamalı örnek kod, listedeki her bir ToDoltem erişmek için lambda ifadesinin @ işleçle nasıl değiştirileceğini 
gösterir. 


TextArea etiketi Yardımcısı 

Textarea Tag Helper Tag Yardımcısı giriş etiketi Yardımcısı ile benzerdir. 

• id ve name özniteliklerini ve <textarea > öğesi için modelden veri doğrulama özniteliklerini üretir. 

• Güçlü yazma sağlar. 

• HTML Yardımcısı alternatifi: Htmi.TextAreaFor 
Örnek: 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class DescriptionViewModel 

{ 

[MinLength(S) ] 

[MaxLength(1024)] 

public stning Description { get; set; } 

} 

} 













@model DescriptionViewModel 

<form asp-controller="Demo" asp-action="RegisterTextArea" method="post"> 
<textarea asp-for="Description"x/textarea> 

<button type="submit">Test</button> 

</form> 


Aşağıdaki HTML oluşturulur: 

<form method="post" action="/Demo/RegisterTextArea"> 

<textarea data-val="true" 

data-val-maxlength="The field Description must be a string or array type with a maximum length of 
&#x27;1024&#x27;." 

data-val-maxlength-max="1024" 

data-val-minlength="The field Description must be a string or array type with a minimum length of 
&#x27;5&#x27; 

data-val-minlength-min="5" 

id="Description" name="Description") 

</textarea> 

<button type="submit">Test</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Etiket etiketi Yardımcısı 

• Bir ifade adı için bir <label > öğesinde etiket başlık yazısı ve for özniteliği oluşturur 

• HTML Yardımcısı alternatifi: Htmi.LabeiFor . 

Label Tag Helper , saf HTML etiket öğesi üzerinde aşağıdaki avantajları sağlar: 

• Display özniteliğinden açıklayıcı etiket değerini otomatik olarak alırsınız, istenen görünen ad zaman içinde 
değişebilir ve Display özniteliği ve etiket etiketi Yardımcısı 'nın birleşimi, Display her yere uygular. 

• Kaynak kodunda daha az biçimlendirme 

• Model özelliğiyle güçlü yazma. 

Örnek: 


using System.ComponentModel.DataAnnotations; 


namespace FormsTagHelper.ViewModels 

{ 


public class SimpleViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 

} 










@model SimpleViewModel 

<fonm asp-controller="Demo" asp-action="Registerl_abel" method="post"> 

<label asp-fon="Email"x/label> 

<input asp-for="Email" /> <br /> 

</form> 

<iabei> öğesi için aşağıdaki HTML oluşturulur: 

dabel for="Email">Email Address</label> 

Etiket etiketi Yardımcısı, <input> öğesiyle ilişkili KİMLİK olan "e-posta" for öznitelik değerini oluşturdu. Etiket 
Yardımcıları, doğru ilişkilendirilebilen şekilde tutarlı id ve for öğeleri oluşturur. Bu örnekteki başlık Display 
özniteliğinden gelir. Modelde bir Display özniteliği yoksa, başlık ifadenin Özellik adı olacaktır. 

Doğrulama etiketi yardımcıları 

iki doğrulama etiketi yardımcıları vardır, validation Message Tag Helper (modelinizdeki tek bir özellik için bir 
doğrulama iletisi görüntüler) ve validation summary Tag Helper (doğrulama hatalarının özetini görüntüler), 
input Tag Helper , model sınıflarınızda bulunan veri ek açıklaması özniteliklerini temel alan giriş öğelerine HTML5 
istemci tarafı doğrulama öznitelikleri ekler. Doğrulama de sunucuda gerçekleştirilir. Doğrulama etiketi Yardımcısı, 
bir doğrulama hatası oluştuğunda bu hata iletilerini görüntüler. 

Doğrulama İletisi etiketi Yardımcısı 

• Belirtilen model özelliğinin giriş alanındaki doğrulama hatası mesajlarını bağlayan span öğesine HTML5 
data-vaimsg-for="property" özniteliğini ekler, istemci tarafı doğrulama hatası oluştuğunda, jöuery <span> 

öğesinde hata iletisini görüntüler. 

• Doğrulama de sunucuda gerçekleşir, istemciler JavaScript devre dışı bırakılmış olabilir ve bazı doğrulamalar 
yalnızca sunucu tarafında yapılabilir. 

• HTML Yardımcısı alternatifi: Html.ValidationMessageFor 

validation Message Tag Helper , bir HTML span öğesinde asp-validation-for özniteliğiyle kullanılır. 

<span asp-validation-for="Email"></span> 

Doğrulama İletisi etiketi Yardımcısı aşağıdaki HTML 'yi oluşturur: 

<span class="field-validation-valid" 
data-valmsg-for="Email" 
data-valmsg-replace="true"x/span> 

Aynı özellik için bir input etiketi Yardımcısı sonrasında validation Message Tag Helper genellikle kullanırsınız. 
Bunun yapılması, hataya neden olan girişin yakınında herhangi bir doğrulama hata iletisi görüntüler. 


NOTE 

İstemci tarafı doğrulaması için doğru JavaScript ve jQuery betik başvurularını içeren bir görünümsiniz olmalıdır. Daha fazla bilgi 
için bkz. model doğrulaması . 


Sunucu tarafı doğrulama hatası oluştuğunda (örneğin, özel sunucu tarafı doğrulamadan veya istemci tarafı 
doğrulaması devre dışı bırakılmışsa), MVC bu hata iletisini <span> öğesinin gövdesi olarak koyar. 




















<span class="field-validation-error" data-valmsg-for="Email" 
data-valmsg-replace="true"> 

The Email Address field is required. 

</span> 


Doğrulama Özeti etiketi Yardımcısı 

• asp-validation-summary özniteliği olan öğeleri <div> hedefleri 

• HTML Yardımcısı alternatifi: @Html.ValidationSummary 

Validation Summary Tag Helper , doğrulama iletilerinin Özetini göstermek için kullanılır, asp-validation-summary 
öznitelik değeri, aşağıdakilerden herhangi biri olabilir: 

ASP-DOĞRULAMA-ÖZET GÖRÜNEN DOĞRULAMA İLETİLERİ 

ValidationSummary. Ali Özellik ve model düzeyi 

Yalnızca ValidationSummary. model Model 

ValidationSummary. None Yok. 

Örnek 

Aşağıdaki örnekte, veri modelinde <input> öğesinde doğrulama hata iletileri üreten DataAnnotation öznitelikleri 
vardır. Doğrulama hatası oluştuğunda, doğrulama etiketi Yardımcısı şu hata iletisini görüntüler: 

using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class RegisterViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 

[Required] 

[DataType(DataType.Password)] 
public string Password { get; set; } 

} 

} 


@model RegisterViewModel 

<form asp-controller="Demo" asp-action="RegisterValidation" method="post"> 
<div asp-validation-summary="ModelOnly"x/div> 

Email: <input asp-for="Email" /> <br /> 

<span asp-validation-for="Email"x/spanxbr /> 

Password: <input asp-for="Password" /xbr /> 

<span asp-validation-for="Password"x/spanxbr /> 

<button type="submit">Register</button> 

</form> 


Oluşturulan HTML (model geçerli olduğunda): 











<form action="/DemoReg/Register" method="post"> 

<div class="validation-summary-valid" data-valmsg-summary="true"> 

<ulxli style="display: none"x/lix/ulx/div> 

Email: cinput name="Email" id="Email" type="email" value="" 
data-val-required="The Email field is required." 
data-val-email="The Email field is not a valid email address." 
data-val="true"xbr> 

<span elass="field-validation-valid" data-valmsg-replace="true" 
data-valmsg-fon=" Email "x/spanxbr> 

Password: <input name="Password" id="Password" type="password" 
data-val-required="The Password field is required." data-val="true"xbr> 

<span elass="field-validation-valid" data-valmsg-replace="true" 
data-valmsg-fon="Password"x/spanxbn> 

<button type="submit">Registen</button> 

cinput name="_RequestVerificationToken" type="hidden" value="<removed fon brevity>"> 

</fonm> 


Etiket Seç Yardımcısı 

• Modelinizin özellikleri için Select ve ilişkili seçenek öğeleri oluşturur. 



Örneğin: 


<select asp-for="Country" asp-items="Model.Countries"x/select> 


Örnek: 


using Microsoft.AspNetCone.Mvc.Rendering; 
using System.Collections.Generic; 

namespace FonmsTagHelpen.ViewModels 

{ 

public elass CountryViewModel 

{ 

public stning Country { get; set; } 

public List<SelectListItem> Countnies { get; } = new List<SelectListItem> 

{ 

new SelectListltem { Value = "MX", Text = "Mexico" }j 

new SelectListltem { Value = "CA", Text = "Canada" }j 

new SelectListltem { Value = "US", Text = "USA" }, 

}; 

} 

} 


index yöntemi countnyviewModei başlatır, seçilen ülkeyi ayarlar ve index görünümüne geçirir. 

public IActionResult Index() 

{ 

var model = new CountryViewModel(); 
model.Country = "CA"; 
return View(model); 

} 


HTTP POST index yöntemi seçimi görüntüler: 













[HttpPost] 

[ValidateAntiForgeryToken] 

public IActionResult Index(CountryViewModel model) 

{ 

if (ModelState.IsValid) 

{ 

var msg = model.Country + " selected"; 

return RedirectToAction("IndexSuccess", new { message = msg }); 

} 

// If we got this far, something failed; redlsplay form, 
return View(model); 


index görünümü: 


@model CountryViewModel 

<form asp-controller="Home" asp-action="Index" method="post"> 

<select asp-for="Country" asp-items="Model .Countries"x/select> 
<br /><button type="submit">Register</button> 

</form> 


Aşağıdaki HTML 'yi üreten ("CA" seçiliyken): 


<form method="post" action="/"> 

<select id="Country" name="Country"> 

<option value="MX">Mexico</option> 

coption selected="selected" value="CA">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


NOTE 

Etiket Seç Yardımcısı ile viewBag veya viewData kullanmanızı önermiyoruz. Bir görünüm modeli, MVC meta verileri 
sağlamaya ve genellikle daha az soruna neden olacak daha sağlamdır. 


asp-for öznitelik değeri özel bir durumdur ve Model öneki gerektirmez, diğer etiket Yardımcısı öznitelikleri olur ( 
asp-items gibi) 

<select asp-for="Country" asp-items="Model.Countries"x/select> 


Sabit Listesi bağlama 

<seiect> , enum bir özellik ile kullanmak ve enum değerlerinden selectListitem öğeleri oluşturmak için 
kullanışlıdır. 


Örnek: 









public class CountryEnumViewModel 

{ 

public CountryEnum EnumCountry { get; set; } 

} 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public enum CountryEnum 

{ 

[Display(Name = "United Mexican States")] 
Mexico, 

[Display(Name = "United States of America")] 
USA, 

Canada, 

France, 

Germany, 

Spain 

} 

} 


GetEnumSelectList yöntemi bir numaralandırma için selectList nesnesi oluşturur. 

@model CountryEnumViewModel 

<form asp-controller="Home" asp-action="IndexEnum" method="post"> 

<select asp-for="EnumCountry" 

asp-items="Html.GetEnumSelectList<CountryEnum>()"> 

</select> 

<br /><button type="submit">Register</button> 

</form> 

Daha zengin bir kullanıcı arabirimi almak için, Numaralandırıcı listenizi Display özniteliğiyle işaretleyebilirsiniz: 

using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public enum CountryEnum 

{ 

[Display(Name = "United Mexican States")] 

Mexico, 

[Display(Name = "United States of America")] 

USA, 

Canada, 

France, 

Germany, 

Spain 

} 

} 


Aşağıdaki HTML oluşturulur: 






<form method="post" action="/Home/IndexEnum"> 

<select data-val="true" data-val-required="The EnumCountry field is required." 
id="EnumCountry" name="EnumCountry"> 

<option value="0">United Mexican States</option> 

<option value="l">United States of America</option> 

<option value="2">Canada</option> 

<option value="3">France</option> 
coption value="4">Germany</option> 

<option selected="selected" value="5">Spain</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Seçenek grubu 

HTML <SeçenekGrubu > öğesi, görünüm modelinde bir veya daha fazla selectListGroup nesnesi içerdiğinde 
oluşturulur. 

countryviewModeiGroup , selectListitem öğelerini "Kuzey Amerika" ve "Avrupa" gruplarına gruplandırır: 






public class CountryViewModelGroup 

{ 

public CountryViewModelGroup() 

{ 

var NorthAmericaGroup = new SelectListGroup { Name = "North America" }; 
var EuropeGroup = new SelectListGroup { Name = "Europe" }; 

Countries = new List<SelectListItem> 

{ 

new SelectListltem 

{ 

Value = "MEX", 

Text = "Mexico", 

Group = NorthAmericaGroup 

}, 

new SelectListltem 

{ 

Value = "CAN", 

Text = "Canada", 

Group = NorthAmericaGroup 

b 

new SelectListltem 

{ 

Value = "US", 

Text = "USA", 

Group = NorthAmericaGroup 

b 

new SelectListltem 

{ 

Value = "FR", 

Text = "France", 

Group = EuropeGroup 

b 

new SelectListltem 

{ 

Value = "ES", 

Text = "Spain", 

Group = EuropeGroup 

b 

new SelectListltem 

{ 

Value = "DE", 

Text = "Germany", 

Group = EuropeGroup 

} 

b 

} 

public string Country { get; set; } 

public List<SelectListItem> Countries { get; } 


iki grup aşağıda gösterilmiştir: 
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Oluşturulan HTML: 


<form method="post" action="/Home/IndexGroup"> 

<select id="Country" name="Country"> 

<optgroup label="North America"» 

coption value="MEX">Mexicoc/option> 

<option value="CAN">Canada</option> 
coption value="US">USA</option> 

</optgroup> 

coptgroup label="Europe"> 

coption value="FR">Francec/option> 
coption value="ES">Spainc/option> 
coption value="DE">Germanyc/option> 
c/optgroup> 
c/select> 

cbr /»cbutton type="submit">Registerc/button> 

cinput name="_RequestVerificationToken" type="hidden" value="cremoved for brevity>"> 

c/form> 


Çoklu seçim 

asp-for özniteliğinde belirtilen özellik bir iEnumerabie ise, select etiketi Yardımcısı otomatik olarak birden çok = 
"Muitiple" özniteliği oluşturacaktır. Örneğin, aşağıdaki model verildiğinde: 


using Microsoft.AspNetCore.Mvc. Rendering; 
using System.Collections.Generic; 

namespace FormsTagHelper.ViewModels 

{ 

public class CountryViewModelIEnumerable 

{ 

public IEnumerablecstring» CountryCodes { get; set; } 

public ListcSelectListltem» Countries { get; } = new ListcSelectListltem» 

{ 

new SelectListltem { Value = "MX", Text = "Mexico" }, 

new SelectListltem { Value = "CA", Text = "Canada" }j 

new SelectListltem { Value = "US", Text = "USA" }, 

new SelectListltem { Value = "FR", Text = "France" }, 

new SelectListltem { Value = "ES", Text = "Spain" }, 

new SelectListltem { Value = "DE", Text = "Germany"} 

}; 

} 

} 


Aşağıdaki görünümle: 












@model CountryViewModelIEnumerable 

<form asp-controller="Home" asp-action="IndexMultiSelect" method="post"> 
<select asp-for="CountryCodes" asp-items="Model.Countries"x/select> 
<br /><button type="submit">Register</button> 

</form> 


Aşağıdaki HTML 'yi oluşturur: 

<form method="post" action="/Home/IndexMultiSelect"> 

<select id="CountryCodes" 
muitiple="muitiple" 

name="CountryCodes"xoption value="MX">Mexico</option> 

<option value="CA">Canada</option> 

<option value="US">USA</option> 

<option value="FR">France</option> 

<option value="ES">Spain</option> 

<option value="DE">Germany</option> 

</select> 

<br /xbutton type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Seçim yok 

Birden çok sayfada "belirtilmemiş" seçeneğini kullanarak kendinizi bulursanız, HTML 'yi yinelemeyi ortadan 
kaldırmak için bir şablon oluşturabilirsiniz: 

@model CountryViewModel 

<form asp-controller="Home" asp-action="IndexEmpty" method="post"> 

@Fltml. EditorForModel() 

<br /xbutton type="submit">Register</button> 

</form> 


Vİews/Shared/EditorTemplates/CountryVievvModel, cshtml şablonu: 

@model CountryViewModel 

<select asp-for="Country" asp-items="Model.Countr'ies"> 

<option value="">--none--</option> 

</select> 


HTML <seçenek > öğeleri ekleme hiçbir seçim durumuyla sınırlı değildir. Örneğin, aşağıdaki görünüm ve eylem 
yöntemi yukarıdaki koda benzer HTML oluşturur: 


public IActionResult IndexNone() 

{ 

var model = new CountryViewModel(); 
model.Insert(0j new SelectListItem("<none>", 


return Vlew(model); 

} 









@model CountryViewModel 

<form asp-controller="Home" asp-action="IndexEmpty" method="post"> 

<select asp-for="Country"> 

<option value="">&lt;none&gt;</option> 
coption value="MX">Mexico</option> 

<option value="CA">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

</form> 

Geçerli country değerine bağlı olarak doğru <option> öğesi seçilecek ( seiected="seiected" özniteliğini içerir). 

public IActionResult IndexOption(int id) 

{ 

var model = new CountryViewModel(); 
model.Country = "CA"; 
return View(model); 

} 


<form method="post" action="/Home/IndexEmpty"> 

<select id="Country" name="Country"> 

<option value="">&lt;none&gt;</option> 

<option value="MX">Mexico</option> 

<option value="CA" selected="selected">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Ek kaynaklar 

• ASP.NET Core etiket yardımcıları 

• HTML form öğesi 

• istek doğrulama belirteci 

• ASP.NET Core'de model bağlama 

• ASP.NET Core MVC 'de model doğrulaması 

• lattributeadapter arabirimi 

• Bu belge için kod parçacıkları 







ASPNET Core formlardaki etiket yardımcıları 
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By Rick Anderson, N. Taylor Mullen, Davve Patııve Jerrie Pelser 

Bu belge, formlarda ve genellikle form üzerinde kullanılan HTML öğeleriyle çalışmayı gösterir. HTML form öğesi, 
Web uygulamalarının sunucuya veri geri göndermek için kullanacağı birincil mekanizmayı sağlar. Bu belgenin 
çoğunda Etiket Yardımcıları ve BUNLARıN güçlü HTML formları oluşturma konusunda nasıl yardımcı olabilecekleri 
açıklanmaktadır. Bu belgeyi okuyabilmeniz İçin yardımcıları etiketleyerek okumanız önerilir. 

Birçok durumda, HTML Yardımcıları belirli bir etiket Yardımcısı için alternatif bir yaklaşım sağlar, ancak bu etiket 
yardımcıların HTML yardımcılarını değiştirmez ve her HTML Yardımcısı için bir etiket Yardımcısı olmadığını bilmek 
önemlidir. Bir HTML Yardımcısı alternatifi varsa, bu, bahsedilir. 

Form etiketi Yardımcısı 

Form etiketi Yardımcısı: 

• MVC denetleyicisi eylemi veya adlandırılmış yol için HTML <FORM > action öznitelik değeri oluşturur 


• Siteler arası istek yasaklamasını engellemek için gizli bir İstek doğrulama belirteci ÜRETİR (http post eylem 



Örnek: 

<form asp-controller="Demo" asp-action="Register" method="post"> 
<!-- Input and Submit elements --> 

</form> 


Yukarıdaki form etiketi Yardımcısı aşağıdaki HTML 'yi oluşturur: 



oluşturur. Bir saf HTML formunun siteler arası istek sahteciliğini önleme 'den korunması zordur, form etiketi 
Yardımcısı bu hizmeti sizin için sağlar. 

Adlandırılmış yol kullanma 


asp-route 

Tag Helper özniteliği, HTML 

action 

özniteliği için de biçimlendirme oluşturabilir. 

register 


uygulama, kayıt sayfası için aşağıdaki biçimlendirmeyi kullanabilir: 






















<form asp-route="register" method="post"> 
<!-- Input and Submit elements --> 
</form> 


Görünümler/hesap klasöründeki görünümlerin birçoğu ( bireysel kullanıcı hesaplarıylayenl bir Web uygulaması 
oluşturduğunuzda oluşturulur), ASP-Route-ReturnUrl özniteliğini içerir: 

<form asp-controllen="Account" asp-action="Login" 
asp-route-returnurl="@ViewData["Returnllrl"]" 
method="post" class="form-horizontal" role="form"> 


NOTE 

Yerleşik şablonlarla returniiri , yalnızca yetkili bir kaynağa erişmeye çalıştığınızda ancak kimliği doğrulanmamış veya 
yetkilendirilmeyen otomatik olarak doldurulur. Yetkisiz erişim yapmaya çalıştığınızda, güvenlik ara yazılımı sizi neturnuri 
kümesi ile oturum açma sayfasına yönlendirir. 


Form eylemi etiketi Yardımcısı 


Form eylemi etiketi Yardımcısı, formaction özniteliği oluşturulan <button ...> veya cinput type="image" ...> 


etiketi üzerinde oluşturur. 

formaction 

özniteliği bir formun verilerini nereden gönderdiğini denetler. 

image 

ve 

<düğme > öğeleri <giriş 

> öğelerine 

bağlanır. Form eylemi etiketi Yardımcısı, karşılık gelen öğe için 

formaction 


bağlantısının oluşturulduğunu denetlemek için birkaç AnchorTagHelper asp- özniteliği kullanımını sağlar, 
formaction değerini denetlemek için desteklenen AnchorTagHelper öznitelikleri: 


ÖZNITELIK 

AÇIKLAMA 

ASP-Controller 

Denetleyicinin adı. 

ASP-eylem 

Eylem yönteminin adı. 

ASP-alanı 

Alanın adı. 

asp-sayfa 

Razor sayfasının adı. 

ASP-Page-Handler 

Razor sayfası işleyicisinin adı. 

ASP-Route 

Rotanın adı. 

ASP-Route-{Value} 

Tek bir URL yol değeri. Örneğin: asp-route-id="i234" . 

ASP-Ali- Route- Data 

Tüm rota değerleri. 

ASP-Fragment 

URL parçası. 


Denetleyiciye gönder örneği 

Aşağıdaki biçimlendirme, giriş veya düğme seçildiğinde formu HomeControiler 


index eylemine gönderir: 














cform method="post"> 

<button asp-controller="Hom 0 ” asp-action="Index">Click Me</button> 
<input type="image" src="..." alt="Or Click Me" asp-controller="Home" 

asp-action="Index"> 

</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/Home">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" formaction="/Home"> 
</form> 


Sayfa örneğine gönder 

Aşağıdaki biçimlendirme formu About Razor sayfasına gönderir: 

<form method="post"> 

<button asp-page="About">Click Me</button> 

cinput type="image" src="...“ alt="Or Click Me" asp-page="About"> 
</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/About">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" formaction="/About"> 
</form> 


Yönlendirme örneğine gönder 

/Home/Test uç noktasını göz önünde bulundurun: 

public class HomeController : Controller 

{ 

[Route("/Home/Test", Name = "Custom")] 
public string Test() 

{ 

return "This is the test page"; 

} 

} 

Aşağıdaki biçimlendirme formu /Home/Test uç noktasına gönderir. 

<form method="post"> 

<button asp-route="Custom">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" asp-route="Custom"> 
</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/Home/Test">Click Me</button> 

cinput type="image" snc="..." alt="Or Click Me" formaction="/Home/Test"> 
</form> 











Giriş etiketi Yardımcısı 

Giriş etiketi Yardımcısı, bir HTML <girişi > öğesini Razor görünüminizdeki bir model ifadesine bağlar. 

Sözdizimi: 

cinput asp-for="<Expression Name>"> 

Giriş etiketi Yardımcısı: 

• asp-for özniteliğinde belirtilen ifade adı için id ve name HTML özniteliklerini üretir. 
asp-for="Propertyl.Property2" m => m.Propertyl.Property2 eşdeğerdir, ifadenin adi, asp-for Öznitelİği 

değeri için kullanılan şeydir. Ek bilgi için ifade adları bölümüne bakın. 

• Model özelliğine uygulanan model türüne ve veri ek açıklaması ÖZNİTELİKLERINE göre HTML type 
öznitelik değerini ayarlar 

• Belirtilirse, HTML type öznitelik değerinin üzerine yazmaz 

• Model özelliklerine uygulanan veri ek açıklama özniteliklerinden HTML5 doğrulama öznitelikleri oluşturur 

• Htmi.TextBoxFor ve Htmi.EditorFor bir HTML Yardımcısı özelliği örtüşüyor. Ayrıntılar için bkz. giriş etiketi 
Yardımcısı İçin HTML Yardımcısı alternatifleri. 

• Güçlü yazma sağlar.Özelliğin adı değişirse ve etiket yardımcısını güncelleştirmezseniz aşağıdakine benzer bir 
hata alırsınız: 



ve oluşturulan HTML türü listelenmekte (her .NET türü listelenmemiştir). 


.NET TÜRÜ 

GİRİŞ türü 

Bool 

Type = "onay kutusu" 

Dize 

Type = "metin" 

DateTime 

Type ="TarihSaat-yerel' 

Bayt 

Type = "Number" 

int 

Type = "Number" 

Tek, Çift 

Type = "Number" 


Aşağıdaki tabloda, giriş etiketi Yardımcısı 'nın belirli giriş türleriyle eşleşecağı bazı ortak veri ek açıklamaları (her 
doğrulama özniteliğı listelenmez) gösterilmektedir: 












OZNITELIK 


GİRİŞ TURU 


EmailAddress 

Type = "e-posta" 

'Deki 

Type = "URL" 

[Hiddenınput] 

Type = "Hidden" 

Numarası 

Type = "tel" 

[DataType (DataType. Password)] 

Type = "Passvvord" 

[DataType (DataType. Date)] 

Type = "Date" 

[DataType (DataType. Time)] 

yazın = "Time" 


Örnek: 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class RegisterViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 

[Required] 

[DataType(DataType.Password)] 
public stning Password { get; set; } 

} 

} 


@model RegisterViewModel 

<form asp-controller="Demo" asp-action="RegisterInput" method="post"> 
Email: <input asp-for="Email" /> <br /> 

Password: cinput asp-fon="Password" /><bn /> 

<button type="submit">Registen</button> 

</fonm> 


Yukarıdaki kod, aşağıdaki HTML 'yi oluşturur: 

<fonm method="post" action="/Demo/RegistenInput"> 

Email: 

<input type="email" data-val="tnue" 

data-val-email="The Email Addness field is not a valid email address." 
data-val-required="The Email Address field is required." 
id="Email" name="Email" value=""xbr> 

Password: 

cinput type="password" data-val="true" 

data-val-required="The Password field is required." 
id="Password" name="Password"xbr> 
cbutton type="submit">Register</button> 

cinput name="_RequestVerificationToken" type="hidden" value="cremoved for brevity>"> 

c/form> 




Email ve Passwond özelliklerine uygulanan veri ek açıklamaları modelde meta veriler oluşturur. Giriş etiketi 
Yardımcısı, model meta verilerini kullanır ve HTM L5 data-vai-* öznitelikleri üretir (bkz. model doğrulama). Bu 
öznitelikler, giriş alanlarına iliştirilecek Doğrulayıcıları anlatmaktadır. Bu unobtrusive HTML5 vejQuery doğrulaması 
sağlar. Unobtrusive özniteliklerinin biçimi data-vai-ruie="Error Message" , burada kural doğrulama kuralının adıdır 
(örneğin, data-val-required , data-val-email , data-val-maxlength vb.) Öznitelikte bir hata iletisi sağlanırsa, 
data-vai-rule özniteliği için değer olarak görüntülenir. Ayrıca, kuralla ilgili ek ayrıntılar sağlayan 
data-val-ruleName-argumentName="argumentValue" form Öznitelikleri de vardır, Örneğin, 
data-val-maxlength-max="1024" . 

Giriş etiketi Yardımcısı için HTML Yardımcısı alternatifleri 

Htmi.TextBox , Htmi.TextBoxFor , Htmi.Editör ve Htmi.EditorFor , giriş etiketi Yardımcısı ile çakışan özelliklere 


sahiptir. Giriş etiketi Yardımcısı 

type 

özniteliğini otomatik olarak ayarlar; 

Htmi.TextBox 

ve 

Htmi.TextBoxFor 


Htmi.Editör 

ve 

Htmi.EditorFor 

■ tanıtıcı koleksiyonları, karmaşık nesneler ve şablonlar; Giriş etiketi Yardımcısı yok. 

Giriş etiketi Yardımcısı, Htmi.EditorFor ve Htmi.TextBoxFor kesin türdedir (lambda ifadeleri kullanırlar); 

Html.TextBox 

ve 

Htmi.Editör ı 

değildir (ifade adlarını kullanırlar). 


HtmlAttributes 

@Htmi.Editor() ve @Htmi.EditorFor( ), varsayılan şablonlarını yürütürken htmiAttributes adlı özel bir 
viewDataDictionary girişi kullanır. Bu davranış, isteğe bağlı olarak additionaiviewData parametreleri kullanılarak 
genişletilebilir. "HtmlAttributes" anahtarı büyük/küçük harfe duyarlıdır."HtmlAttributes" anahtarı, @Htmi.TextBox() 
gibi giriş yardımcılarını geçirilmiş htmiAttributes nesnesine benzer şekilde işlenir. 

@Html.EditorFor(model => model.YourProperty, 

new { htmiAttributes = new { @class="myCssClass ", style="Width:100px" } }) 

İfade adları 

asp-for öznitelik değeri, bir lambda ifadesinin bir ModeiExpression ve sağ tarafıdır. Bu nedenle, 
asp-for="Propertyi" oluşturulan kodda m => m.Propertyi hale gelir ve bu nedenle Model ile önek gerektirmez. 
karakterini kullanarak bir satır içi ifadeyi başlatabilir ve m. önce taşıyabilirsiniz: 

@{ 

var joe = "Doe"; 

} 

<input asp-for="@joe"> 


Şunları üretir: 


cinput type="text" id="joe" name="joe" value="loe"> 


Koleksiyon özellikleriyle 

asp-for="CollectionProperty[23].Member" , 

asp-for="CollectionProperty[i].Member" 

aynı adı üretir. 


i değer 23 olduğunda 


ASP.NET Core MVC ModeiExpression değerini hesapladığında Modeistate dahil olmak üzere çeşitli kaynakları 
inceler, cinput type="text" asp-for="@Name"> göz önünde bulundurun. Hesaplanan value özniteliği, öğesinden 
gelen ilk null olmayan değerdir: 


• "Name" anahtarına sahip giriş Modeistate. 

• İfadenin sonucu Model.Name . 


Alt özelliklerde gezinme 

Ayrıca, görünüm modelinin özellik yolunu kullanarak alt Özellikler 1 e gidebilirsiniz. Alt Address özelliği içeren daha 
karmaşık bir model sınıfı düşünün. 











































public class AddressViewModel 

{ 

public string AddressLinel { get; set; } 

} 


public class RegisterAddressViewModel 

{ 

public string Email { get; set; } 

[DataType(DataType.Password)] 
public string Password { get; set; } 

public AddressViewModel Address { get; set; } 

} 

Görünümde Address.AddressLinei bağlandık: 


@model RegisterAddressViewModel 

<form asp-controller="Demo" asp-action="RegisterAddress" method="post"> 
Email: <input asp-for="Email" /> <br /> 

Password: <input asp-for="Password" /><br /> 

Address: <input asp-for="Address.AddressLinel" /><br /> 

<button type="submit">Register</button> 

</form> 


Address.AddressLinei için aşağıdaki HTML oluşturulmuştur: 

<input type="text" id="Address_AddressLinel" name="Address.AddressLinel" value=""> 


İfade adları ve koleksiyonlar 

Örnek, bir dizi colors içeren bir modeldir: 

public class Person 

{ 

public List<string> Colors { get; set; } 
public int Age { get; set; } 

} 

Eylem yöntemi: 


public IActionResult Edit(int id, int colorIndex) 

{ 

ViewData["Index"] = colorIndex; 
return View(GetPerson(id)); 

} 


Aşağıdaki Razor, belirli bir color öğesine nasıl erişistediğinizi göstermektedir: 











@model Person 

@{ 

var index = (int)ViewData["index"]; 

} 

<form asp-controller="ToDo" asp-action="Edit" method="post"> 
@Html.EditorFor(m => m.Colors[index]) 
dabel asp-for="Age"x/label> 

<input asp-for="Age" /><br /> 

<button type="submit">Post</button> 

</form> 


Views/Shared/EdltorTemplates/Strlng. cshtml şablonu: 

@model string 

<label asp-for="@Model"x/label> 

<input asp-for="@Model" /> <br /> 

List<T > kullanarak örnek: 


public class ToDoltem 

{ 

public string Name { get; set; } 
public bool IsDone { get; set; } 

} 


Aşağıdaki Razor, bir koleksiyonun üzerinde nasıl yineleme yapılacağını göstermektedir: 

@model List<ToDoItem> 

<form asp-controller="ToDo" asp-action="Edit" method="post"> 

<table> 

<tr> <th>Name</th> <th>Is Done</th> </tr> 

@for (int i = 0; i < Model.Count; i++) 

{ 

<tr> 

@Html.EditorFor(model => modelfi]) 

</tr> 

} 

</table> 

<button type="submit">Save</button> 

</form> 


Views/Shared/EditorTemplates/Todoltem. cshtml şablonu: 




@model ToDoltem 
<td> 

<label asp-for="@Model.Name"x/label> 

@Html.DisplayFor(model = > model.Name) 

</td> 

<td> 

cinput asp-fon="@Model.IsDone" /> 

</td> 

This template replaces the following Razor which evaluates the indexer three tlmes. 

<td> 

<label asp-for="@Model[i] .Name"x/label> 

@Html.DisplayFor(model => model[i].Name) 

</td> 

<td> 

<input asp-for="@Model[i].IsDone" /> 

</td> 

*@ 

değer bir asp-for veya Htmi.DisplayFor denk bir bağlamda kullanılacaksa, mümkünse foreach kullanılmalıdır. 
Genel olarak, for bir Numaralandırıcı ayırması gerekmiyorsa, foreach daha iyidir (senaryo buna izin veriyorsa). 
Ancak, bir LINQ ifadesinde bir dizin oluşturucuyu değerlendirmek pahalı olabilir ve simge durumuna küçültülmüş 
olmalıdır. 


NOTE 

Yukarıdaki açıklamalı örnek kod, listedeki her bir ToDoltem erişmek için lambda ifadesinin @ işleçle nasıl değiştirileceğini 
gösterir. 


TextArea etiketi Yardımcısı 

Textarea Tag Helper Tag Yardımcısı giriş etiketi Yardımcısı ile benzerdir. 

• id ve name özniteliklerini ve <textarea > öğesi için modelden veri doğrulama özniteliklerini üretir. 

• Güçlü yazma sağlar. 

• HTML Yardımcısı alternatifi: Htmi.TextAreaFor 
Örnek: 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class DescriptionViewModel 

{ 

[MinLength(S) ] 

[MaxLength(1024)] 

public stning Description { get; set; } 

} 

} 













@model DescriptionViewModel 

<form asp-controller="Demo" asp-action="RegisterTextArea" method="post"> 
<textarea asp-for="Description"x/textarea> 

<button type="submit">Test</button> 

</form> 


Aşağıdaki HTML oluşturulur: 

<form method="post" action="/Demo/RegisterTextArea"> 

<textarea data-val="true" 

data-val-maxlength="The field Description must be a string or array type with a maximum length of 
&#x27;1024&#x27;." 

data-val-maxlength-max="1024" 

data-val-minlength="The field Description must be a string or array type with a minimum length of 
&#x27;5&#x27; 

data-val-minlength-min="5" 

id="Description" name="Description") 

</textarea> 

<button type="submit">Test</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Etiket etiketi Yardımcısı 

• Bir ifade adı için bir <label > öğesinde etiket başlık yazısı ve for özniteliği oluşturur 

• HTML Yardımcısı alternatifi: Htmi.LabeiFor . 

Label Tag Helper , saf HTML etiket öğesi üzerinde aşağıdaki avantajları sağlar: 

• Display özniteliğinden açıklayıcı etiket değerini otomatik olarak alırsınız, istenen görünen ad zaman içinde 
değişebilir ve Display özniteliği ve etiket etiketi Yardımcısı 'nın birleşimi, Display her yere uygular. 

• Kaynak kodunda daha az biçimlendirme 

• Model özelliğiyle güçlü yazma. 

Örnek: 


using System.ComponentModel.DataAnnotations; 


namespace FormsTagHelper.ViewModels 

{ 


public class SimpleViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 

} 










@model SimpleViewModel 

<fonm asp-controller="Demo" asp-action="Registerl_abel" method="post"> 

<label asp-fon="Email"x/label> 

<input asp-for="Email" /> <br /> 

</form> 

<iabei> öğesi için aşağıdaki HTML oluşturulur: 

dabel for="Email">Email Address</label> 

Etiket etiketi Yardımcısı, <input> öğesiyle ilişkili KİMLİK olan "e-posta" for öznitelik değerini oluşturdu. Etiket 
Yardımcıları, doğru ilişkilendirilebilen şekilde tutarlı id ve for öğeleri oluşturur. Bu örnekteki başlık Display 
özniteliğinden gelir. Modelde bir Display özniteliği yoksa, başlık ifadenin Özellik adı olacaktır. 

Doğrulama etiketi yardımcıları 

iki doğrulama etiketi yardımcıları vardır, validation Message Tag Helper (modelinizdeki tek bir özellik için bir 
doğrulama iletisi görüntüler) ve validation summary Tag Helper (doğrulama hatalarının özetini görüntüler), 
input Tag Helper , model sınıflarınızda bulunan veri ek açıklaması özniteliklerini temel alan giriş öğelerine HTML5 
istemci tarafı doğrulama öznitelikleri ekler. Doğrulama de sunucuda gerçekleştirilir. Doğrulama etiketi Yardımcısı, 
bir doğrulama hatası oluştuğunda bu hata iletilerini görüntüler. 

Doğrulama İletisi etiketi Yardımcısı 

• Belirtilen model özelliğinin giriş alanındaki doğrulama hatası mesajlarını bağlayan span öğesine HTML5 
data-vaimsg-for="property" özniteliğini ekler, istemci tarafı doğrulama hatası oluştuğunda, jöuery <span> 

öğesinde hata iletisini görüntüler. 

• Doğrulama de sunucuda gerçekleşir, istemciler JavaScript devre dışı bırakılmış olabilir ve bazı doğrulamalar 
yalnızca sunucu tarafında yapılabilir. 

• HTML Yardımcısı alternatifi: Html.ValidationMessageFor 

validation Message Tag Helper , bir HTML span öğesinde asp-validation-for özniteliğiyle kullanılır. 

<span asp-validation-for="Email"></span> 

Doğrulama İletisi etiketi Yardımcısı aşağıdaki HTML 'yi oluşturur: 

<span class="field-validation-valid" 
data-valmsg-for="Email" 
data-valmsg-replace="true"x/span> 

Aynı özellik için bir input etiketi Yardımcısı sonrasında validation Message Tag Helper genellikle kullanırsınız. 
Bunun yapılması, hataya neden olan girişin yakınında herhangi bir doğrulama hata iletisi görüntüler. 


NOTE 

İstemci tarafı doğrulaması için doğru JavaScript ve jQuery betik başvurularını içeren bir görünümsiniz olmalıdır. Daha fazla bilgi 
için bkz. model doğrulaması . 


Sunucu tarafı doğrulama hatası oluştuğunda (örneğin, özel sunucu tarafı doğrulamadan veya istemci tarafı 
doğrulaması devre dışı bırakılmışsa), MVC bu hata iletisini <span> öğesinin gövdesi olarak koyar. 




















<span class="field-validation-error" data-valmsg-for="Email" 
data-valmsg-replace="true"> 

The Email Address field is required. 

</span> 


Doğrulama Özeti etiketi Yardımcısı 

• asp-validation-summary özniteliği olan öğeleri <div> hedefleri 

• HTML Yardımcısı alternatifi: @Html.ValidationSummary 

Validation Summary Tag Helper , doğrulama iletilerinin Özetini göstermek için kullanılır, asp-validation-summary 
öznitelik değeri, aşağıdakilerden herhangi biri olabilir: 

ASP-DOĞRULAMA-ÖZET GÖRÜNEN DOĞRULAMA İLETİLERİ 

ValidationSummary. Ali Özellik ve model düzeyi 

Yalnızca ValidationSummary. model Model 

ValidationSummary. None Yok. 

Örnek 

Aşağıdaki örnekte, veri modelinde <input> öğesinde doğrulama hata iletileri üreten DataAnnotation öznitelikleri 
vardır. Doğrulama hatası oluştuğunda, doğrulama etiketi Yardımcısı şu hata iletisini görüntüler: 

using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class RegisterViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 

[Required] 

[DataType(DataType.Password)] 
public string Password { get; set; } 

} 

} 


@model RegisterViewModel 

<form asp-controller="Demo" asp-action="RegisterValidation" method="post"> 
<div asp-validation-summary="ModelOnly"x/div> 

Email: <input asp-for="Email" /> <br /> 

<span asp-validation-for="Email"x/spanxbr /> 

Password: <input asp-for="Password" /xbr /> 

<span asp-validation-for="Password"x/spanxbr /> 

<button type="submit">Register</button> 

</form> 


Oluşturulan HTML (model geçerli olduğunda): 











<form action="/DemoReg/Register" method="post"> 

<div class="validation-summary-valid" data-valmsg-summary="true"> 

<ulxli style="display: none"x/lix/ulx/div> 

Email: cinput name="Email" id="Email" type="email" value="" 
data-val-required="The Email field is required." 
data-val-email="The Email field is not a valid email address." 
data-val="true"xbr> 

<span elass="field-validation-valid" data-valmsg-replace="true" 
data-valmsg-fon=" Email "x/spanxbr> 

Password: <input name="Password" id="Password" type="password" 
data-val-required="The Password field is required." data-val="true"xbr> 

<span elass="field-validation-valid" data-valmsg-replace="true" 
data-valmsg-fon="Password"x/spanxbn> 

<button type="submit">Registen</button> 

cinput name="_RequestVerificationToken" type="hidden" value="<removed fon brevity>"> 

</fonm> 


Etiket Seç Yardımcısı 

• Modelinizin özellikleri için Select ve ilişkili seçenek öğeleri oluşturur. 



Örneğin: 


<select asp-for="Country" asp-items="Model.Countries"x/select> 


Örnek: 


using Microsoft.AspNetCone.Mvc.Rendering; 
using System.Collections.Generic; 

namespace FonmsTagHelpen.ViewModels 

{ 

public elass CountryViewModel 

{ 

public stning Country { get; set; } 

public List<SelectListItem> Countnies { get; } = new List<SelectListItem> 

{ 

new SelectListltem { Value = "MX", Text = "Mexico" }j 

new SelectListltem { Value = "CA", Text = "Canada" }j 

new SelectListltem { Value = "US", Text = "USA" }, 

}; 

} 

} 


index yöntemi countnyviewModei başlatır, seçilen ülkeyi ayarlar ve index görünümüne geçirir. 

public IActionResult Index() 

{ 

var model = new CountryViewModel(); 
model.Country = "CA"; 
return View(model); 

} 


HTTP POST index yöntemi seçimi görüntüler: 













[HttpPost] 

[ValidateAntiForgeryToken] 

public IActionResult Index(CountryViewModel model) 

{ 

if (ModelState.IsValid) 

{ 

var msg = model.Country + " selected"; 

return RedirectToAction("IndexSuccess", new { message = msg }); 

} 

// If we got this far, something failed; redlsplay form, 
return View(model); 


index görünümü: 


@model CountryViewModel 

<form asp-controller="Home" asp-action="Index" method="post"> 

<select asp-for="Country" asp-items="Model .Countries"x/select> 
<br /><button type="submit">Register</button> 

</form> 


Aşağıdaki HTML 'yi üreten ("CA" seçiliyken): 


<form method="post" action="/"> 

<select id="Country" name="Country"> 

<option value="MX">Mexico</option> 

coption selected="selected" value="CA">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


NOTE 

Etiket Seç Yardımcısı ile viewBag veya viewData kullanmanızı önermiyoruz. Bir görünüm modeli, MVC meta verileri 
sağlamaya ve genellikle daha az soruna neden olacak daha sağlamdır. 


asp-for öznitelik değeri özel bir durumdur ve Model öneki gerektirmez, diğer etiket Yardımcısı öznitelikleri olur ( 
asp-items gibi) 

<select asp-for="Country" asp-items="Model.Countries"x/select> 


Sabit Listesi bağlama 

<seiect> , enum bir özellik ile kullanmak ve enum değerlerinden selectListitem öğeleri oluşturmak için 
kullanışlıdır. 


Örnek: 









public class CountryEnumViewModel 

{ 

public CountryEnum EnumCountry { get; set; } 

} 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public enum CountryEnum 

{ 

[Display(Name = "United Mexican States")] 
Mexico, 

[Display(Name = "United States of America")] 
USA, 

Canada, 

France, 

Germany, 

Spain 

} 

} 


GetEnumSelectList yöntemi bir numaralandırma için selectList nesnesi oluşturur. 

@model CountryEnumViewModel 

<form asp-controller="Home" asp-action="IndexEnum" method="post"> 

<select asp-for="EnumCountry" 

asp-items="Html.GetEnumSelectList<CountryEnum>()"> 

</select> 

<br /><button type="submit">Register</button> 

</form> 

Daha zengin bir kullanıcı arabirimi almak için, Numaralandırıcı listenizi Display özniteliğiyle işaretleyebilirsiniz: 

using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public enum CountryEnum 

{ 

[Display(Name = "United Mexican States")] 

Mexico, 

[Display(Name = "United States of America")] 

USA, 

Canada, 

France, 

Germany, 

Spain 

} 

} 


Aşağıdaki HTML oluşturulur: 






<form method="post" action="/Home/IndexEnum"> 

<select data-val="true" data-val-required="The EnumCountry field is required." 
id="EnumCountry" name="EnumCountry"> 

<option value="0">United Mexican States</option> 

<option value="l">United States of America</option> 

<option value="2">Canada</option> 

<option value="3">France</option> 
coption value="4">Germany</option> 

<option selected="selected" value="5">Spain</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Seçenek grubu 

HTML <SeçenekGrubu > öğesi, görünüm modelinde bir veya daha fazla selectListGroup nesnesi içerdiğinde 
oluşturulur. 

countryviewModeiGroup , selectListitem öğelerini "Kuzey Amerika" ve "Avrupa" gruplarına gruplandırır: 






public class CountryViewModelGroup 

{ 

public CountryViewModelGroup() 

{ 

var NorthAmericaGroup = new SelectListGroup { Name = "North America" }; 
var EuropeGroup = new SelectListGroup { Name = "Europe" }; 

Countries = new List<SelectListItem> 

{ 

new SelectListltem 

{ 

Value = "MEX", 

Text = "Mexico", 

Group = NorthAmericaGroup 

}, 

new SelectListltem 

{ 

Value = "CAN", 

Text = "Canada", 

Group = NorthAmericaGroup 

b 

new SelectListltem 

{ 

Value = "US", 

Text = "USA", 

Group = NorthAmericaGroup 

b 

new SelectListltem 

{ 

Value = "FR", 

Text = "France", 

Group = EuropeGroup 

b 

new SelectListltem 

{ 

Value = "ES", 

Text = "Spain", 

Group = EuropeGroup 

b 

new SelectListltem 

{ 

Value = "DE", 

Text = "Germany", 

Group = EuropeGroup 

} 

b 

} 

public string Country { get; set; } 

public List<SelectListItem> Countries { get; } 


iki grup aşağıda gösterilmiştir: 






B localhost 

X + — o x 

<- O 1 
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North America 


Mexico 


Canada 


USA 


Europe 


France 


Spain 


Germany 



Oluşturulan HTML: 


<form method="post" action="/Home/IndexGroup"> 

<select id="Country" name="Country"> 

<optgroup label="North America"» 

coption value="MEX">Mexicoc/option> 

<option value="CAN">Canada</option> 
coption value="US">USA</option> 

</optgroup> 

coptgroup label="Europe"> 

coption value="FR">Francec/option> 
coption value="ES">Spainc/option> 
coption value="DE">Germanyc/option> 
c/optgroup> 
c/select> 

cbr /»cbutton type="submit">Registerc/button> 

cinput name="_RequestVerificationToken" type="hidden" value="cremoved for brevity>"> 

c/form> 


Çoklu seçim 

asp-for özniteliğinde belirtilen özellik bir iEnumerabie ise, select etiketi Yardımcısı otomatik olarak birden çok = 
"Muitiple" özniteliği oluşturacaktır. Örneğin, aşağıdaki model verildiğinde: 


using Microsoft.AspNetCore.Mvc. Rendering; 
using System.Collections.Generic; 

namespace FormsTagHelper.ViewModels 

{ 

public class CountryViewModelIEnumerable 

{ 

public IEnumerablecstring» CountryCodes { get; set; } 

public ListcSelectListltem» Countries { get; } = new ListcSelectListltem» 

{ 

new SelectListltem { Value = "MX", Text = "Mexico" }, 

new SelectListltem { Value = "CA", Text = "Canada" }j 

new SelectListltem { Value = "US", Text = "USA" }, 

new SelectListltem { Value = "FR", Text = "France" }, 

new SelectListltem { Value = "ES", Text = "Spain" }, 

new SelectListltem { Value = "DE", Text = "Germany"} 

}; 

} 

} 


Aşağıdaki görünümle: 












@model CountryViewModelIEnumerable 

<form asp-controller="Home" asp-action="IndexMultiSelect" method="post"> 
<select asp-for="CountryCodes" asp-items="Model.Countries"x/select> 
<br /><button type="submit">Register</button> 

</form> 


Aşağıdaki HTML 'yi oluşturur: 

<form method="post" action="/Home/IndexMultiSelect"> 

<select id="CountryCodes" 
muitiple="muitiple" 

name="CountryCodes"xoption value="MX">Mexico</option> 

<option value="CA">Canada</option> 

<option value="US">USA</option> 

<option value="FR">France</option> 

<option value="ES">Spain</option> 

<option value="DE">Germany</option> 

</select> 

<br /xbutton type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Seçim yok 

Birden çok sayfada "belirtilmemiş" seçeneğini kullanarak kendinizi bulursanız, HTML 'yi yinelemeyi ortadan 
kaldırmak için bir şablon oluşturabilirsiniz: 

@model CountryViewModel 

<form asp-controller="Home" asp-action="IndexEmpty" method="post"> 

@Fltml. EditorForModel() 

<br /xbutton type="submit">Register</button> 

</form> 


Vİews/Shared/EditorTemplates/CountryVievvModel, cshtml şablonu: 

@model CountryViewModel 

<select asp-for="Country" asp-items="Model.Countr'ies"> 

<option value="">--none--</option> 

</select> 


HTML <seçenek > öğeleri ekleme hiçbir seçim durumuyla sınırlı değildir. Örneğin, aşağıdaki görünüm ve eylem 
yöntemi yukarıdaki koda benzer HTML oluşturur: 


public IActionResult IndexNone() 

{ 

var model = new CountryViewModel(); 
model.Insert(0j new SelectListItem("<none>", 


return Vlew(model); 

} 









@model CountryViewModel 

<form asp-controller="Home" asp-action="IndexEmpty" method="post"> 

<select asp-for="Country"> 

<option value="">&lt;none&gt;</option> 
coption value="MX">Mexico</option> 

<option value="CA">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

</form> 

Geçerli country değerine bağlı olarak doğru <option> öğesi seçilecek ( seiected="seiected" özniteliğini içerir). 

public IActionResult IndexOption(int id) 

{ 

var model = new CountryViewModel(); 
model.Country = "CA"; 
return View(model); 

} 


<form method="post" action="/Home/IndexEmpty"> 

<select id="Country" name="Country"> 

<option value="">&lt;none&gt;</option> 

<option value="MX">Mexico</option> 

<option value="CA" selected="selected">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Ek kaynaklar 

• ASP.NET Core etiket yardımcıları 

• HTML form öğesi 

• istek doğrulama belirteci 

• ASP.NET Core'de model bağlama 

• ASP.NET Core MVC 'de model doğrulaması 

• lattributeadapter arabirimi 

• Bu belge için kod parçacıkları 







ASPNET Core etiket Yardımcısı bağlantı 

25.09.2019 • 3 minutes to read ı Edjt Online 


Tarafından RickAnderson 

Bağlantı etiketi Yardımcısı , birincil veya GERİ dönüş CSS dosyasına bir bağlantı oluşturur.Genellikle birincil CSS 
dosyası Content Delivery Netvvork (CDN). 

CDN: 

• , Varlığın Web uygulamasıyla barındırılmasına karşı çeşitli performans avantajları sağlar. 

• Varlık için tek kaynak olarak hiçbir şekilde güvenilmemelidir.CDNs her zaman kullanılabilir değildir, bu nedenle 
güvenilir bir geri dönüş kullanılmalıdır. Genellikle geri dönüş, Web uygulamasını barındıran sitedir. 

Bağlantı etiketi Yardımcısı, CSS dosyası için CDN ve CDN kullanılabilir olmadığında geri dönüş belirtmenize 
olanak tanır. Bağlantı etiketi Yardımcısı, CDN 'nin performans avantajlarından yararlanarak yerel barındırma 
sağlamlığı sağlar. 

Aşağıdaki Razor biçimlendirmesinde, AS P.N ET Core Web head uygulaması şablonuyla oluşturulan bir düzen 
dosyasının öğesi gösterilmektedir: 

<!DOCTYPE html> 

<html> 

<head> 

<meta charset="utf-8" /> 

<meta name="viewport" content="width=device-width, initial-scale=1.0" /> 

<title>@ViewData["Title"] - WebLinkTH</title> 

<environment include="Development"> 

<link rel="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.css" /> 

</environment> 

<environment exclude="Development"> 

<link rel="stylesheet" 

href=" https://cdnjs.cloudflare.eom/ajax/libs/twitter-bootstrap/4.l.3/css/bootstrap.min.css" 
asp-fallback-href="~/lib/bootstrap/dist/css/bootstrap.min.ess" 
asp-fallback-test-class="sr-only" asp-fallback-test-property="position" 
asp-fallback-test-value="absolute" 
crossorigin="anonymous" 

integrity="sha256-eSilq2PG6]7g7ibl7yAaWMcrr5GrtohYChqibrV7PBE=" /> 

</environment> 

<link rel="stylesheet" href="~/css/site.css" /> 

</head> 


Aşağıdaki kod, önceki koddan (geliştirme olmayan bir ortamda) HTML olarak işlenir: 






<html> 

<head> 

<meta charset="utf-8" /> 

cmeta name="viewport" content= ,, width=device-width, initial-scale=1.0" /> 

<title>Home page - WebLinkTH</title> 

<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter- 
bootstrap/4.1.3/css/bootstrap.min.css" 

crossorigin="anonymous" integrity="sha256-eS<snip>BE=" /> 

<meta name="x-stylesheet-fallback-test" content="" class="sr-only" /> 

<script> 

Ifunction (a, b, c, d) { 
var e, f = document, 

g = f.getElementsByTagName("SCRIPT "), 
h = g[g.length - 1].previousElementSibling, 

i = f.defaultView && f.defaultView.getComputedStyle ? f.defaultView.getComputedStyle(h) : 

h.currentStyle; 

if (i && i[a] !== b) for (e = 0j e < c.lengthj e++) 
f.write('<link href="' + c[e] + + d + "/>") 

} 

("position", "absolute", ["\/lib\/bootstrap\/dist\/css\/bootstrap.min.css "], 

"rel=\u0022stylesheet\u0022 crossorigin=\u0022anonymous\u0022 integrity=\abc<snip>BE=\u0022 

</script> 

<link rel="stylesheet" href="/css/site.css" /> 

</head> 

Önceki kodda, bağlantı etiketi Yardımcısı <meta name="x-stylesheet-fallback-test" content="" class="sr-only" /> 
öğesi ve istenen Bootstrap. miri, css dosyasının CDN üzerinde kullanılabilir olduğunu doğrulamak için kullanılan 
aşağıdaki JavaScript 'i oluşturdu. Bu durumda, CSS dosyası kullanılabilir olduğundan, etiket Yardımcısı CDN CSS 
dosyası ile <ünk /> öğeyi üretti. 

Yaygın olarak kullanılan bağlantı etiketi Yardımcısı öznitelikleri 

Tüm bağlantı etiketi Yardımcısı öznitelikleri, özellikleri ve yöntemleri için bağlantı etiketi Yardımcısı ' na bakın. 

değerini 

Bağlı kaynağın tercih edilen adresi. Adres, her durumda oluşturulan HTML 'ye düşünce olarak iletilir. 

ASP-geri dönüş-href 

Birincil URL 'nin başarısız olması durumunda öğesine geri dönüş için CSS stil sayfasının URL "SI. 

ASP-geri dönüş-test sınıfı 

Geri dönüş testi için kullanılacak stil sayfasında tanımlanan sınıf adı. Daha fazla bilgi için bkz. FalIbackTestClass. 

ASP-FalIback-test-özelliği 

Geri dönüş testi için kullanılacak CSS özellik adı. Daha fazla bilgi için bkz. FalIbackTestProperty. 

ASP-geri dönüş-test-değeri 

Geri dönüş testi için kullanılacak CSS özelliği değeri. Daha fazla bilgi için bkz. FalIbackTestValue. 

ASP-geri dönüş-test-değeri 

Geri dönüş testi için kullanılacak CSS özelliği değeri. Daha fazla bilgi için bkz.FalIbackTestValue 

Ek kaynaklar 

• ASP.NET Core etiket yardımcıları 

• ASP.NET Core bölgeler 

• ASP.NET Core Razor Pages giriş 





ASP.NET Core MVC için uyumluluk sürümü 


ASRNET Core kısmi etiket Yardımcısı 

6.12.2019 • 4 minutes to read ı Edit Online 


Scott Ade tarafından 

Etiket Yardımcıları hakkında genel bilgi için bkz. AS P.N ET Core etiket yardımcıları. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Genel bakış 

Kısmi etiket Yardımcısı Razor Pages ve MVC uygulamalarında kısmi bir Görünüm oluşturmak için kullanılır. 
Bunu göz önünde bulundurun: 

• ASP.NET Core 2,1 veya üstünü gerektirir. 

• , HTM L yardımcı söz diziminebir alternatiftir. 

• Kısmi görünümü zaman uyumsuz olarak işler. 

Kısmi görünümü işlemeye yönelik HTML yardımcı seçenekleri şunlardır: 

• @await Html.PartialAsync 

• @await Html.RenderPartialAsync 

• (ŞHtml.Partial 

• @Html.RenderPartial 

Ürün modeli bu belgenin tamamında örneklerde kullanılır: 

namespace TagHelpersBuiltln.Models 
{ 

public class Product 
{ 

public int Number { get; set; } 
public string Name { get; set; } 
public string Description { get; set; } 

} 

} 

Kısmi etiket Yardımcısı özniteliklerinin bir stoku aşağıda verilmiştir. 

{1 >name<1} 

name özniteliği gereklidir, işlenecek kısmi görünümün adını veya yolunu gösterir. Kısmi bir görünüm adı 
sağlandığında, görünüm bulma işlemi başlatılır. Açık bir yol sağlandığında bu işlem atlanır.Tüm kabul edilebilir 
name değerleri için bkz. kısmi görünüm bulma. 

Aşağıdaki biçimlendirme, _ProductPartial. cshtml 'nin paylaşılan klasörden yükleneceğini belirten açık bir yol 
kullanır. For özniteliği kullanılarak, bağlama için kısmi görünüme bir model geçirilir. 

<partial name="Shared/_ProductPartial.cshtml" fon="Product"> 















for 


for 

özniteliği, geçerli modele göre değerlendirilecek bir Modelexpression atar. Bir 

ModelExpression 

@Model. 


söz dizimini anlar. Örneğin, for="Product" for="@Modei.Product" yerine kullanılabilir. Bu varsayılan çıkarım 
davranışı, bir satır içi ifade tanımlamak için @ simgesi kullanılarak geçersiz kılınır. 


Aşağıdaki biçimlendirme_P/'oc/ucfPo/'ft'o/. cshtml‘y\ yükler: 


cpartial name="_ProductPartial" for= 

:"Product"> 

Kısmi görünüm, ilişkili sayfa modelinin 

Product 

özelliğine bağlanır: 


using Microsoft.AspNetCore.Mvc.RazorPages; 
using TagHelpersBuiltln.Models; 


namespace TagHelpersBuiltln.Pages 
{ 

public class ProductModel : PageModel 
{ 

public Product Product { get; set; } 

public void OnGet() 

{ 

Product = new Product 
{ 

Number = 1 , 

Name = "Test product ", 

Description = "This is a test product" 
}J 

} 

} 

} 


{1 >model<1} 

model özniteliği kısmi görünüme geçirilecek bir model örneği atar, model özniteliği for özniteliğiyle birlikte 
kullanılamaz. 

Aşağıdaki biçimlendirmede, yeni bir Product nesnesi oluşturulur ve bağlama için model özniteliğine geçirilir: 

<partial name="_ProductPartial" 

model='new Product { Number = 1 , Name = "Test product ", Description = "This is a test" }'> 


verileri görüntüle 

view-data özniteliği, kısmi görünüme geçirilecek bir VievvDataDictionary atar. Aşağıdaki biçimlendirme tüm 
VievvData toplamasını kısmi görünüm için erişilebilir hale getirir: 

@{ 

ViewData["IsNumberReadOnly"] = true; 

} 

<partial name="_ProductViewDataPartial" for="Product" view-data="ViewData"> 

Yukarıdaki kodda isNumberReadOniy anahtar değeri true olarak ayarlanır ve VievvData koleksiyonuna eklenir. 
Sonuç olarak, viewData["isNumberReadOniy"] aşağıdaki kısmi görünüm içinde erişilebilir hale getirilir: 






















@model TagHelpersBuiltln.Models.Product 

<div class="form-group"> 

<label asp-for="Number"x/label> 

(Şif ((bool)ViewData["IsNumberReadOnly"]) 

{ 

cinput asp-for="Number" type="number" class="form-control" readonly /> 

} 

else 

{ 

cinput asp-for="Number" type="number" class="form-control" /> 

} 

</div> 

cdiv class="form-group"> 

clabel asp-for="Name"x/label> 

cinput asp-for="Name" type="text" class="form-control" /> 
c/div> 

cdiv class="form-group"> 

clabel asp-for="Description"x/label> 

ctextarea asp-for="Description" rows="4" cols="50" class="form-control">c/textarea> 
c/div> 

Bu örnekte, viewData["isNumberReadOniy"] değeri, sayı alanının salt okunurdur olarak görüntülenip 
görüntülenmeyeceğini belirler. 

HTML yardımcısından geçiş yapma 

Aşağıdaki zaman uyumsuz HTML Yardımcısı örneğini göz önünde bulundurun. Bir ürün koleksiyonu 
tekrarlandırılır ve görüntülenir. PartialAsync yönteminin ilk parametresi başına, _ProductPartial. cshtml kısmi 
görünümü yüklenir. Product modelinin bir örneği bağlama için kısmi görünüme geçirilir. 

(Şforeach (var product in Model.Products) 

{ 

@await Html.PartialAsync("_ProductPartial"j product) 

} 

Aşağıdaki kısmi etiket Yardımcısı PartialAsync HTML Yardımcısı ile aynı zaman uyumsuz işleme davranışına 
erişir, model özniteliğine, kısmi görünüme bağlama için bir Product model örneği atanır. 

(Şforeach (var product in Model.Products) 

{ 

cpartial name="_ProductPartial" model="product" /> 

} 


Ek kaynaklar 


• ASP.NET Core kısmi görünümler 

• ASP.NET Core MVC'deki görünümler 














ASPNET Core 'de betik etiketi Yardımcısı 
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Rick Anderson tarafından 

Betik etiketi Yardımcısı , birincil veya geri dönüş betik dosyasına bir bağlantı oluşturur. Genellikle birincil betik 
dosyası Content Delivery Netvvork (CDN). 

CDN: 

• , Varlığın Web uygulamasıyla barındırılmasına karşı çeşitli performans avantajları sağlar. 

• Varlık için tek kaynak olarak hiçbir şekilde güvenilmemelidir.CDNs her zaman kullanılabilir değildir, bu nedenle 
güvenilir bir geri dönüş kullanılmalıdır. Genellikle geri dönüş, Web uygulamasını barındıran sitedir. 

Betik etiketi Yardımcısı, CDN kullanılabilir olmadığında betik dosyası ve geri dönüş için CDN belirtmenize olanak 
tanır. Betik etiketi Yardımcısı, bir CDN 'nin performans avantajlarından yararlanarak yerel barındırma sağlamlığı 
sağlar. 

Aşağıdaki Razor biçimlendirmesinde geri dönüş içeren bir script öğesi gösterilmektedir: 

<script src="https://ajax.aspnetcdn.com/ajax/jquery/jquery-3.3.l.min.js" 
asp-fallback-src="~/lib/jquery/dist/jquery.min.js" 
asp-fallback-test="window.jQuery" 
crossorigin="anonymous" 

integrity="sha384-tsQFqpEReu7ZLhBV2VZlAu7zcOV+rXbYlF2cqB8txI/8aZajjp4Bqd+V6D5IgvKT"> 

</script> 

CDN betiğini yüklemeyi ertelemek için <script> öğenin erteleme özniteliğini kullanmayın. Komut dosyası etiketi 
Yardımcısı, ASP-FalIback-test ifadesini hemen yürüten JavaScript 'i işler. CDN betiği yükleme ertelenir ise ifade 
başarısız olur. 

Yaygın olarak kullanılan betik etiketi Yardımcısı öznitelikleri 

Tüm betik etiketi Yardımcısı öznitelikleri, özellikleri ve yöntemleri için komut dosyası etiketi Yardımcısı ' na bakın. 

ASP-geri dönüş-test 

Geri dönüş testi için kullanılacak birincil betikte tanımlanan betik yöntemi. Daha fazla bilgi için bkz. 

FallbackTestExpression. 

ASP-geri dönüş-src 

Birincil bir hata durumunda öğesine geri dönüş yapılacak bir betik etiketinin URL "SI. Daha fazla bilgi için bkz. 

FalIbackSrc. 

Ek kaynaklar 

• ASP.NET Core etiket yardımcıları 

• ASP.NET Core bölgeler 

• ASP.NET Core Razor Pages giriş 

• ASP.NET Core MVC için uyumluluk sürümü 
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By Rick Anderson, N. Taylor Mullen, Davve Patııve Jerrie Pelser 

Bu belge, formlarda ve genellikle form üzerinde kullanılan HTML öğeleriyle çalışmayı gösterir. HTML form öğesi, 
Web uygulamalarının sunucuya veri geri göndermek için kullanacağı birincil mekanizmayı sağlar. Bu belgenin 
çoğunda Etiket Yardımcıları ve BUNLARıN güçlü HTML formları oluşturma konusunda nasıl yardımcı olabilecekleri 
açıklanmaktadır. Bu belgeyi okuyabilmeniz İçin yardımcıları etiketleyerek okumanız önerilir. 

Birçok durumda, HTML Yardımcıları belirli bir etiket Yardımcısı için alternatif bir yaklaşım sağlar, ancak bu etiket 
yardımcıların HTML yardımcılarını değiştirmez ve her HTML Yardımcısı için bir etiket Yardımcısı olmadığını bilmek 
önemlidir. Bir HTML Yardımcısı alternatifi varsa, bu, bahsedilir. 

Form etiketi Yardımcısı 

Form etiketi Yardımcısı: 

• MVC denetleyicisi eylemi veya adlandırılmış yol için HTML <FORM > action öznitelik değeri oluşturur 


• Siteler arası istek yasaklamasını engellemek için gizli bir İstek doğrulama belirteci ÜRETİR (http post eylem 



Örnek: 

<form asp-controller="Demo" asp-action="Register" method="post"> 
<!-- Input and Submit elements --> 

</form> 


Yukarıdaki form etiketi Yardımcısı aşağıdaki HTML 'yi oluşturur: 



oluşturur. Bir saf HTML formunun siteler arası istek sahteciliğini önleme 'den korunması zordur, form etiketi 
Yardımcısı bu hizmeti sizin için sağlar. 

Adlandırılmış yol kullanma 


asp-route 

Tag Helper özniteliği, HTML 

action 

özniteliği için de biçimlendirme oluşturabilir. 

register 


uygulama, kayıt sayfası için aşağıdaki biçimlendirmeyi kullanabilir: 






















<form asp-route="register" method="post"> 
<!-- Input and Submit elements --> 
</form> 


Görünümler/hesap klasöründeki görünümlerin birçoğu ( bireysel kullanıcı hesaplarıylayenl bir Web uygulaması 
oluşturduğunuzda oluşturulur), ASP-Route-ReturnUrl özniteliğini içerir: 

<form asp-controllen="Account" asp-action="Login" 
asp-route-returnurl="@ViewData["Returnllrl"]" 
method="post" class="form-horizontal" role="form"> 


NOTE 

Yerleşik şablonlarla returniiri , yalnızca yetkili bir kaynağa erişmeye çalıştığınızda ancak kimliği doğrulanmamış veya 
yetkilendirilmeyen otomatik olarak doldurulur. Yetkisiz erişim yapmaya çalıştığınızda, güvenlik ara yazılımı sizi neturnuri 
kümesi ile oturum açma sayfasına yönlendirir. 


Form eylemi etiketi Yardımcısı 


Form eylemi etiketi Yardımcısı, formaction özniteliği oluşturulan <button ...> veya cinput type="image" ...> 


etiketi üzerinde oluşturur. 

formaction 

özniteliği bir formun verilerini nereden gönderdiğini denetler. 

image 

ve 

<düğme > öğeleri <giriş 

> öğelerine 

bağlanır. Form eylemi etiketi Yardımcısı, karşılık gelen öğe için 

formaction 


bağlantısının oluşturulduğunu denetlemek için birkaç AnchorTagHelper asp- özniteliği kullanımını sağlar, 
formaction değerini denetlemek için desteklenen AnchorTagHelper öznitelikleri: 


ÖZNITELIK 

AÇIKLAMA 

ASP-Controller 

Denetleyicinin adı. 

ASP-eylem 

Eylem yönteminin adı. 

ASP-alanı 

Alanın adı. 

asp-sayfa 

Razor sayfasının adı. 

ASP-Page-Handler 

Razor sayfası işleyicisinin adı. 

ASP-Route 

Rotanın adı. 

ASP-Route-{Value} 

Tek bir URL yol değeri. Örneğin: asp-route-id="i 234 " . 

ASP-Ali- Route- Data 

Tüm rota değerleri. 

ASP-Fragment 

URL parçası. 


Denetleyiciye gönder örneği 

Aşağıdaki biçimlendirme, giriş veya düğme seçildiğinde formu HomeControiler 


index eylemine gönderir: 














cform method="post"> 

<button asp-controller="Hom0” asp-action="Index">Click Me</button> 
<input type="image" src="..." alt="Or Click Me" asp-controller="Home" 

asp-action="Index"> 

</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/Home">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" formaction="/Home"> 
</form> 


Sayfa örneğine gönder 

Aşağıdaki biçimlendirme formu About Razor sayfasına gönderir: 

<form method="post"> 

<button asp-page="About">Click Me</button> 

cinput type="image" src="...“ alt="Or Click Me" asp-page="About"> 
</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/About">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" formaction="/About"> 
</form> 


Yönlendirme örneğine gönder 

/Home/Test uç noktasını göz önünde bulundurun: 

public class HomeController : Controller 

{ 

[Route("/Home/Test", Name = "Custom")] 
public string Test() 

{ 

return "This is the test page"; 

} 

} 

Aşağıdaki biçimlendirme formu /Home/Test uç noktasına gönderir. 

<form method="post"> 

<button asp-route="Custom">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" asp-route="Custom"> 
</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/Home/Test">Click Me</button> 

cinput type="image" snc="..." alt="Or Click Me" formaction="/Home/Test"> 
</form> 











Giriş etiketi Yardımcısı 

Giriş etiketi Yardımcısı, bir HTML <girişi > öğesini Razor görünüminizdeki bir model ifadesine bağlar. 

Sözdizimi: 

cinput asp-for="<Expression Name>"> 

Giriş etiketi Yardımcısı: 

• asp-for özniteliğinde belirtilen ifade adı için id ve name HTML özniteliklerini üretir. 
asp-for="Propertyl.Property2" m => m.Propertyl.Property2 eşdeğerdir, ifadenin adi, asp-for Öznitelİği 

değeri için kullanılan şeydir. Ek bilgi için ifade adları bölümüne bakın. 

• Model özelliğine uygulanan model türüne ve veri ek açıklaması ÖZNİTELİKLERINE göre HTML type 
öznitelik değerini ayarlar 

• Belirtilirse, HTML type öznitelik değerinin üzerine yazmaz 

• Model özelliklerine uygulanan veri ek açıklama özniteliklerinden HTML5 doğrulama öznitelikleri oluşturur 

• Htmi.TextBoxFor ve Htmi.EditorFor bir HTML Yardımcısı özelliği örtüşüyor. Ayrıntılar için bkz. giriş etiketi 
Yardımcısı İçin HTML Yardımcısı alternatifleri. 

• Güçlü yazma sağlar.Özelliğin adı değişirse ve etiket yardımcısını güncelleştirmezseniz aşağıdakine benzer bir 
hata alırsınız: 



ve oluşturulan HTML türü listelenmekte (her .NET türü listelenmemiştir). 


.NET TÜRÜ 

GİRİŞ türü 

Bool 

Type = "onay kutusu" 

Dize 

Type = "metin" 

DateTime 

Type ="TarihSaat-yerel' 

Bayt 

Type = "Number" 

int 

Type = "Number" 

Tek, Çift 

Type = "Number" 


Aşağıdaki tabloda, giriş etiketi Yardımcısı 'nın belirli giriş türleriyle eşleşecağı bazı ortak veri ek açıklamaları (her 
doğrulama özniteliğı listelenmez) gösterilmektedir: 












OZNITELIK 


GİRİŞ TURU 


EmailAddress 

Type = "e-posta" 

'Deki 

Type = "URL" 

[Hiddenınput] 

Type = "Hidden" 

Numarası 

Type = "tel" 

[DataType (DataType. Password)] 

Type = "Passvvord" 

[DataType (DataType. Date)] 

Type = "Date" 

[DataType (DataType. Time)] 

yazın = "Time" 


Örnek: 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class RegisterViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 

[Required] 

[DataType(DataType.Password)] 
public stning Password { get; set; } 

} 

} 


@model RegisterViewModel 

<form asp-controller="Demo" asp-action="RegisterInput" method="post"> 
Email: <input asp-for="Email" /> <br /> 

Password: cinput asp-fon="Password" /><bn /> 

<button type="submit">Registen</button> 

</fonm> 


Yukarıdaki kod, aşağıdaki HTML 'yi oluşturur: 

<fonm method="post" action="/Demo/RegistenInput"> 

Email: 

<input type="email" data-val="tnue" 

data-val-email="The Email Addness field is not a valid email address." 
data-val-required="The Email Address field is required." 
id="Email" name="Email" value=""xbr> 

Password: 

cinput type="password" data-val="true" 

data-val-required="The Password field is required." 
id="Password" name="Password"xbr> 
cbutton type="submit">Register</button> 

cinput name="_RequestVerificationToken" type="hidden" value="cremoved for brevity>"> 

c/form> 




Email ve Passwond özelliklerine uygulanan veri ek açıklamaları modelde meta veriler oluşturur. Giriş etiketi 
Yardımcısı, model meta verilerini kullanır ve HTM L5 data-vai-* öznitelikleri üretir (bkz. model doğrulama). Bu 
öznitelikler, giriş alanlarına iliştirilecek Doğrulayıcıları anlatmaktadır. Bu unobtrusive HTML5 vejQuery doğrulaması 
sağlar. Unobtrusive özniteliklerinin biçimi data-vai-ruie="Error Message" , burada kural doğrulama kuralının adıdır 
(örneğin, data-val-required , data-val-email , data-val-maxlength vb.) Öznitelikte bir hata iletisi sağlanırsa, 
data-vai-rule özniteliği için değer olarak görüntülenir. Ayrıca, kuralla ilgili ek ayrıntılar sağlayan 
data-val-ruleName-argumentName="argumentValue" form Öznitelikleri de vardır, Örneğin, 
data-val-maxlength-max="1024" . 

Giriş etiketi Yardımcısı için HTML Yardımcısı alternatifleri 

Htmi.TextBox , Htmi.TextBoxFor , Htmi.Editör ve Htmi.EditorFor , giriş etiketi Yardımcısı ile çakışan özelliklere 


sahiptir. Giriş etiketi Yardımcısı 

type 

özniteliğini otomatik olarak ayarlar; 

Htmi.TextBox 

ve 

Htmi.TextBoxFor 


Htmi.Editör 

ve 

Htmi.EditorFor 

■ tanıtıcı koleksiyonları, karmaşık nesneler ve şablonlar; Giriş etiketi Yardımcısı yok. 

Giriş etiketi Yardımcısı, Htmi.EditorFor ve Htmi.TextBoxFor kesin türdedir (lambda ifadeleri kullanırlar); 

Html.TextBox 

ve 

Htmi.Editör ı 

değildir (ifade adlarını kullanırlar). 


HtmlAttributes 

@Htmi.Editor() ve @Htmi.EditorFor( ), varsayılan şablonlarını yürütürken htmiAttributes adlı özel bir 
viewDataDictionary girişi kullanır. Bu davranış, isteğe bağlı olarak additionaiviewData parametreleri kullanılarak 
genişletilebilir. "HtmlAttributes" anahtarı büyük/küçük harfe duyarlıdır."HtmlAttributes" anahtarı, @Htmi.TextBox() 
gibi giriş yardımcılarını geçirilmiş htmiAttributes nesnesine benzer şekilde işlenir. 

@Html.EditorFor(model => model.YourProperty, 

new { htmiAttributes = new { @class="myCssClass ", style="Width:100px" } }) 

İfade adları 

asp-for öznitelik değeri, bir lambda ifadesinin bir ModeiExpression ve sağ tarafıdır. Bu nedenle, 
asp-for="Propertyi" oluşturulan kodda m => m.Propertyi hale gelir ve bu nedenle Model ile önek gerektirmez. 
karakterini kullanarak bir satır içi ifadeyi başlatabilir ve m. önce taşıyabilirsiniz: 

@{ 

var joe = "Doe"; 

} 

<input asp-for="@joe"> 


Şunları üretir: 


cinput type="text" id="joe" name="joe" value="loe"> 


Koleksiyon özellikleriyle 

asp-for="CollectionProperty[23].Member" , 

asp-for="CollectionProperty[i].Member" 

aynı adı üretir. 


i değer 23 olduğunda 


ASP.NET Core MVC ModeiExpression değerini hesapladığında Modeistate dahil olmak üzere çeşitli kaynakları 
inceler, cinput type="text" asp-for="@Name"> göz önünde bulundurun. Hesaplanan value özniteliği, öğesinden 
gelen ilk null olmayan değerdir: 


• "Name" anahtarına sahip giriş Modeistate. 

• İfadenin sonucu Model.Name . 


Alt özelliklerde gezinme 

Ayrıca, görünüm modelinin özellik yolunu kullanarak alt Özellikler 1 e gidebilirsiniz. Alt Address özelliği içeren daha 
karmaşık bir model sınıfı düşünün. 











































public class AddressViewModel 

{ 

public string AddressLinel { get; set; } 

} 


public class RegisterAddressViewModel 

{ 

public string Email { get; set; } 

[DataType(DataType.Password)] 
public string Password { get; set; } 

public AddressViewModel Address { get; set; } 

} 

Görünümde Address.AddressLinei bağlandık: 


@model RegisterAddressViewModel 

<form asp-controller="Demo" asp-action="RegisterAddress" method="post"> 
Email: <input asp-for="Email" /> <br /> 

Password: <input asp-for="Password" /><br /> 

Address: <input asp-for="Address.AddressLinel" /><br /> 

<button type="submit">Register</button> 

</form> 


Address.AddressLinei için aşağıdaki HTML oluşturulmuştur: 

<input type="text" id="Address_AddressLinel" name="Address.AddressLinel" value=""> 


İfade adları ve koleksiyonlar 

Örnek, bir dizi colors içeren bir modeldir: 

public class Person 

{ 

public List<string> Colors { get; set; } 
public int Age { get; set; } 

} 

Eylem yöntemi: 


public IActionResult Edit(int id, int colorIndex) 

{ 

ViewData["Index"] = colorIndex; 
return View(GetPerson(id)); 

} 


Aşağıdaki Razor, belirli bir color öğesine nasıl erişistediğinizi göstermektedir: 











@model Person 

@{ 

var index = (int)ViewData["index"]; 

} 

<form asp-controller="ToDo" asp-action="Edit" method="post"> 
@Html.EditorFor(m => m.Colors[index]) 
dabel asp-for="Age"x/label> 

<input asp-for="Age" /><br /> 

<button type="submit">Post</button> 

</form> 


Views/Shared/EdltorTemplates/Strlng. cshtml şablonu: 

@model string 

<label asp-for="@Model"x/label> 

<input asp-for="@Model" /> <br /> 

List<T > kullanarak örnek: 


public class ToDoltem 

{ 

public string Name { get; set; } 
public bool IsDone { get; set; } 

} 


Aşağıdaki Razor, bir koleksiyonun üzerinde nasıl yineleme yapılacağını göstermektedir: 

@model List<ToDoItem> 

<form asp-controller="ToDo" asp-action="Edit" method="post"> 

<table> 

<tr> <th>Name</th> <th>Is Done</th> </tr> 

@for (int i = 0; i < Model.Count; i++) 

{ 

<tr> 

@Html.EditorFor(model => modelfi]) 

</tr> 

} 

</table> 

<button type="submit">Save</button> 

</form> 


Views/Shared/EditorTemplates/Todoltem. cshtml şablonu: 




@model ToDoltem 
<td> 

<label asp-for="@Model.Name"x/label> 

@Html.DisplayFor(model = > model.Name) 

</td> 

<td> 

cinput asp-fon="@Model.IsDone" /> 

</td> 

This template replaces the following Razor which evaluates the indexer three tlmes. 

<td> 

<label asp-for="@Model[i] .Name"x/label> 

@Html.DisplayFor(model => model[i].Name) 

</td> 

<td> 

<input asp-for="@Model[i].IsDone" /> 

</td> 

*@ 

değer bir asp-for veya Htmi.DisplayFor denk bir bağlamda kullanılacaksa, mümkünse foreach kullanılmalıdır. 
Genel olarak, for bir Numaralandırıcı ayırması gerekmiyorsa, foreach daha iyidir (senaryo buna izin veriyorsa). 
Ancak, bir LINQ ifadesinde bir dizin oluşturucuyu değerlendirmek pahalı olabilir ve simge durumuna küçültülmüş 
olmalıdır. 


NOTE 

Yukarıdaki açıklamalı örnek kod, listedeki her bir ToDoltem erişmek için lambda ifadesinin @ işleçle nasıl değiştirileceğini 
gösterir. 


TextArea etiketi Yardımcısı 

Textarea Tag Helper Tag Yardımcısı giriş etiketi Yardımcısı ile benzerdir. 

• id ve name özniteliklerini ve <textarea > öğesi için modelden veri doğrulama özniteliklerini üretir. 

• Güçlü yazma sağlar. 

• HTML Yardımcısı alternatifi: Htmi.TextAreaFor 
Örnek: 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class DescriptionViewModel 

{ 

[MinLength(S) ] 

[MaxLength(1024)] 

public stning Description { get; set; } 

} 

} 













@model DescriptionViewModel 

<form asp-controller="Demo" asp-action="RegisterTextArea" method="post"> 
<textarea asp-for="Description"x/textarea> 

<button type="submit">Test</button> 

</form> 


Aşağıdaki HTML oluşturulur: 

<form method="post" action="/Demo/RegisterTextArea"> 

<textarea data-val="true" 

data-val-maxlength="The field Description must be a string or array type with a maximum length of 
&#x27;1024&#x27;." 

data-val-maxlength-max="1024" 

data-val-minlength="The field Description must be a string or array type with a minimum length of 
&#x27;5&#x27; 

data-val-minlength-min="5" 

id="Description" name="Description") 

</textarea> 

<button type="submit">Test</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Etiket etiketi Yardımcısı 

• Bir ifade adı için bir <label > öğesinde etiket başlık yazısı ve for özniteliği oluşturur 

• HTML Yardımcısı alternatifi: Htmi.LabeiFor . 

Label Tag Helper , saf HTML etiket öğesi üzerinde aşağıdaki avantajları sağlar: 

• Display özniteliğinden açıklayıcı etiket değerini otomatik olarak alırsınız, istenen görünen ad zaman içinde 
değişebilir ve Display özniteliği ve etiket etiketi Yardımcısı 'nın birleşimi, Display her yere uygular. 

• Kaynak kodunda daha az biçimlendirme 

• Model özelliğiyle güçlü yazma. 

Örnek: 


using System.ComponentModel.DataAnnotations; 


namespace FormsTagHelper.ViewModels 

{ 


public class SimpleViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 

} 










@model SimpleViewModel 

<fonm asp-controller="Demo" asp-action="Registerl_abel" method="post"> 

<label asp-fon="Email"x/label> 

<input asp-for="Email" /> <br /> 

</form> 

<iabei> öğesi için aşağıdaki HTML oluşturulur: 

dabel for="Email">Email Address</label> 

Etiket etiketi Yardımcısı, <input> öğesiyle ilişkili KİMLİK olan "e-posta" for öznitelik değerini oluşturdu. Etiket 
Yardımcıları, doğru ilişkilendirilebilen şekilde tutarlı id ve for öğeleri oluşturur. Bu örnekteki başlık Display 
özniteliğinden gelir. Modelde bir Display özniteliği yoksa, başlık ifadenin Özellik adı olacaktır. 

Doğrulama etiketi yardımcıları 

iki doğrulama etiketi yardımcıları vardır, validation Message Tag Helper (modelinizdeki tek bir özellik için bir 
doğrulama iletisi görüntüler) ve validation summary Tag Helper (doğrulama hatalarının özetini görüntüler), 
input Tag Helper , model sınıflarınızda bulunan veri ek açıklaması özniteliklerini temel alan giriş öğelerine HTML5 
istemci tarafı doğrulama öznitelikleri ekler. Doğrulama de sunucuda gerçekleştirilir. Doğrulama etiketi Yardımcısı, 
bir doğrulama hatası oluştuğunda bu hata iletilerini görüntüler. 

Doğrulama İletisi etiketi Yardımcısı 

• Belirtilen model özelliğinin giriş alanındaki doğrulama hatası mesajlarını bağlayan span öğesine HTML5 
data-vaimsg-for="property" özniteliğini ekler, istemci tarafı doğrulama hatası oluştuğunda, jöuery <span> 

öğesinde hata iletisini görüntüler. 

• Doğrulama de sunucuda gerçekleşir, istemciler JavaScript devre dışı bırakılmış olabilir ve bazı doğrulamalar 
yalnızca sunucu tarafında yapılabilir. 

• HTML Yardımcısı alternatifi: Html.ValidationMessageFor 

validation Message Tag Helper , bir HTML span öğesinde asp-validation-for özniteliğiyle kullanılır. 

<span asp-validation-for="Email"></span> 

Doğrulama İletisi etiketi Yardımcısı aşağıdaki HTML 'yi oluşturur: 

<span class="field-validation-valid" 
data-valmsg-for="Email" 
data-valmsg-replace="true"x/span> 

Aynı özellik için bir input etiketi Yardımcısı sonrasında validation Message Tag Helper genellikle kullanırsınız. 
Bunun yapılması, hataya neden olan girişin yakınında herhangi bir doğrulama hata iletisi görüntüler. 


NOTE 

İstemci tarafı doğrulaması için doğru JavaScript ve jQuery betik başvurularını içeren bir görünümsiniz olmalıdır. Daha fazla bilgi 
için bkz. model doğrulaması . 


Sunucu tarafı doğrulama hatası oluştuğunda (örneğin, özel sunucu tarafı doğrulamadan veya istemci tarafı 
doğrulaması devre dışı bırakılmışsa), MVC bu hata iletisini <span> öğesinin gövdesi olarak koyar. 




















<span class="field-validation-error" data-valmsg-for="Email" 
data-valmsg-replace="true"> 

The Email Address field is required. 

</span> 


Doğrulama Özeti etiketi Yardımcısı 

• asp-validation-summary özniteliği olan öğeleri <div> hedefleri 

• HTML Yardımcısı alternatifi: @Html.ValidationSummary 

Validation Summary Tag Helper , doğrulama iletilerinin Özetini göstermek için kullanılır, asp-validation-summary 
öznitelik değeri, aşağıdakilerden herhangi biri olabilir: 

ASP-DOĞRULAMA-ÖZET GÖRÜNEN DOĞRULAMA İLETİLERİ 

ValidationSummary. Ali Özellik ve model düzeyi 

Yalnızca ValidationSummary. model Model 

ValidationSummary. None Yok. 

Örnek 

Aşağıdaki örnekte, veri modelinde <input> öğesinde doğrulama hata iletileri üreten DataAnnotation öznitelikleri 
vardır. Doğrulama hatası oluştuğunda, doğrulama etiketi Yardımcısı şu hata iletisini görüntüler: 

using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class RegisterViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 

[Required] 

[DataType(DataType.Password)] 
public string Password { get; set; } 

} 

} 


@model RegisterViewModel 

<form asp-controller="Demo" asp-action="RegisterValidation" method="post"> 
<div asp-validation-summary="ModelOnly"x/div> 

Email: <input asp-for="Email" /> <br /> 

<span asp-validation-for="Email"x/spanxbr /> 

Password: <input asp-for="Password" /xbr /> 

<span asp-validation-for="Password"x/spanxbr /> 

<button type="submit">Register</button> 

</form> 


Oluşturulan HTML (model geçerli olduğunda): 











<form action="/DemoReg/Register" method="post"> 

<div class="validation-summary-valid" data-valmsg-summary="true"> 

<ulxli style="display: none"x/lix/ulx/div> 

Email: cinput name="Email" id="Email" type="email" value="" 
data-val-required="The Email field is required." 
data-val-email="The Email field is not a valid email address." 
data-val="true"xbr> 

<span elass="field-validation-valid" data-valmsg-replace="true" 
data-valmsg-fon=" Email "x/spanxbr> 

Password: <input name="Password" id="Password" type="password" 
data-val-required="The Password field is required." data-val="true"xbr> 

<span elass="field-validation-valid" data-valmsg-replace="true" 
data-valmsg-fon="Password"x/spanxbn> 

<button type="submit">Registen</button> 

cinput name="_RequestVerificationToken" type="hidden" value="<removed fon brevity>"> 

</fonm> 


Etiket Seç Yardımcısı 

• Modelinizin özellikleri için Select ve ilişkili seçenek öğeleri oluşturur. 



Örneğin: 


<select asp-for="Country" asp-items="Model.Countries"x/select> 


Örnek: 


using Microsoft.AspNetCone.Mvc.Rendering; 
using System.Collections.Generic; 

namespace FonmsTagHelpen.ViewModels 

{ 

public elass CountryViewModel 

{ 

public stning Country { get; set; } 

public List<SelectListItem> Countnies { get; } = new List<SelectListItem> 

{ 

new SelectListltem { Value = "MX", Text = "Mexico" }j 

new SelectListltem { Value = "CA", Text = "Canada" }j 

new SelectListltem { Value = "US", Text = "USA" }, 

}; 

} 

} 


index yöntemi countnyviewModei başlatır, seçilen ülkeyi ayarlar ve index görünümüne geçirir. 

public IActionResult Index() 

{ 

var model = new CountryViewModel(); 
model.Country = "CA"; 
return View(model); 

} 


HTTP POST index yöntemi seçimi görüntüler: 













[HttpPost] 

[ValidateAntiForgeryToken] 

public IActionResult Index(CountryViewModel model) 

{ 

if (ModelState.IsValid) 

{ 

var msg = model.Country + " selected"; 

return RedirectToAction("IndexSuccess", new { message = msg }); 

} 

// If we got this far, something failed; redlsplay form, 
return View(model); 


index görünümü: 


@model CountryViewModel 

<form asp-controller="Home" asp-action="Index" method="post"> 

<select asp-for="Country" asp-items="Model .Countries"x/select> 
<br /><button type="submit">Register</button> 

</form> 


Aşağıdaki HTML 'yi üreten ("CA" seçiliyken): 


<form method="post" action="/"> 

<select id="Country" name="Country"> 

<option value="MX">Mexico</option> 

coption selected="selected" value="CA">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


NOTE 

Etiket Seç Yardımcısı ile viewBag veya viewData kullanmanızı önermiyoruz. Bir görünüm modeli, MVC meta verileri 
sağlamaya ve genellikle daha az soruna neden olacak daha sağlamdır. 


asp-for öznitelik değeri özel bir durumdur ve Model öneki gerektirmez, diğer etiket Yardımcısı öznitelikleri olur ( 
asp-items gibi) 

<select asp-for="Country" asp-items="Model.Countries"x/select> 


Sabit Listesi bağlama 

<seiect> , enum bir özellik ile kullanmak ve enum değerlerinden selectListitem öğeleri oluşturmak için 
kullanışlıdır. 


Örnek: 









public class CountryEnumViewModel 

{ 

public CountryEnum EnumCountry { get; set; } 

} 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public enum CountryEnum 

{ 

[Display(Name = "United Mexican States")] 
Mexico, 

[Display(Name = "United States of America")] 
USA, 

Canada, 

France, 

Germany, 

Spain 

} 

} 


GetEnumSelectList yöntemi bir numaralandırma için selectList nesnesi oluşturur. 

@model CountryEnumViewModel 

<form asp-controller="Home" asp-action="IndexEnum" method="post"> 

<select asp-for="EnumCountry" 

asp-items="Html.GetEnumSelectList<CountryEnum>()"> 

</select> 

<br /><button type="submit">Register</button> 

</form> 

Daha zengin bir kullanıcı arabirimi almak için, Numaralandırıcı listenizi Display özniteliğiyle işaretleyebilirsiniz: 

using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public enum CountryEnum 

{ 

[Display(Name = "United Mexican States")] 

Mexico, 

[Display(Name = "United States of America")] 

USA, 

Canada, 

France, 

Germany, 

Spain 

} 

} 


Aşağıdaki HTML oluşturulur: 






<form method="post" action="/Home/IndexEnum"> 

<select data-val="true" data-val-required="The EnumCountry field is required." 
id="EnumCountry" name="EnumCountry"> 

<option value="0">United Mexican States</option> 

<option value="l">United States of America</option> 

<option value="2">Canada</option> 

<option value="3">France</option> 
coption value="4">Germany</option> 

<option selected="selected" value="5">Spain</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Seçenek grubu 

HTML <SeçenekGrubu > öğesi, görünüm modelinde bir veya daha fazla selectListGroup nesnesi içerdiğinde 
oluşturulur. 

countryviewModeiGroup , selectListitem öğelerini "Kuzey Amerika" ve "Avrupa" gruplarına gruplandırır: 






public class CountryViewModelGroup 

{ 

public CountryViewModelGroup() 

{ 

var NorthAmericaGroup = new SelectListGroup { Name = "North America" }; 
var EuropeGroup = new SelectListGroup { Name = "Europe" }; 

Countries = new List<SelectListItem> 

{ 

new SelectListltem 

{ 

Value = "MEX", 

Text = "Mexico", 

Group = NorthAmericaGroup 

}, 

new SelectListltem 

{ 

Value = "CAN", 

Text = "Canada", 

Group = NorthAmericaGroup 

b 

new SelectListltem 

{ 

Value = "US", 

Text = "USA", 

Group = NorthAmericaGroup 

b 

new SelectListltem 

{ 

Value = "FR", 

Text = "France", 

Group = EuropeGroup 

b 

new SelectListltem 

{ 

Value = "ES", 

Text = "Spain", 

Group = EuropeGroup 

b 

new SelectListltem 

{ 

Value = "DE", 

Text = "Germany", 

Group = EuropeGroup 

} 

b 

} 

public string Country { get; set; } 

public List<SelectListItem> Countries { get; } 


iki grup aşağıda gösterilmiştir: 






B localhost 

X + — o x 

<- O 1 

• • • 

North America 


Mexico 


Canada 


USA 


Europe 


France 


Spain 


Germany 



Oluşturulan HTML: 


<form method="post" action="/Home/IndexGroup"> 

<select id="Country" name="Country"> 

<optgroup label="North America"» 

coption value="MEX">Mexicoc/option> 

<option value="CAN">Canada</option> 
coption value="US">USA</option> 

</optgroup> 

coptgroup label="Europe"> 

coption value="FR">Francec/option> 
coption value="ES">Spainc/option> 
coption value="DE">Germanyc/option> 
c/optgroup> 
c/select> 

cbr /»cbutton type="submit">Registerc/button> 

cinput name="_RequestVerificationToken" type="hidden" value="cremoved for brevity>"> 

c/form> 


Çoklu seçim 

asp-for özniteliğinde belirtilen özellik bir iEnumerabie ise, select etiketi Yardımcısı otomatik olarak birden çok = 
"Muitiple" özniteliği oluşturacaktır. Örneğin, aşağıdaki model verildiğinde: 


using Microsoft.AspNetCore.Mvc. Rendering; 
using System.Collections.Generic; 

namespace FormsTagHelper.ViewModels 

{ 

public class CountryViewModelIEnumerable 

{ 

public IEnumerablecstring» CountryCodes { get; set; } 

public ListcSelectListltem» Countries { get; } = new ListcSelectListltem» 

{ 

new SelectListltem { Value = "MX", Text = "Mexico" }, 

new SelectListltem { Value = "CA", Text = "Canada" }j 

new SelectListltem { Value = "US", Text = "USA" }, 

new SelectListltem { Value = "FR", Text = "France" }, 

new SelectListltem { Value = "ES", Text = "Spain" }, 

new SelectListltem { Value = "DE", Text = "Germany"} 

}; 

} 

} 


Aşağıdaki görünümle: 












@model CountryViewModelIEnumerable 

<form asp-controller="Home" asp-action="IndexMultiSelect" method="post"> 
<select asp-for="CountryCodes" asp-items="Model.Countries"x/select> 
<br /><button type="submit">Register</button> 

</form> 


Aşağıdaki HTML 'yi oluşturur: 

<form method="post" action="/Home/IndexMultiSelect"> 

<select id="CountryCodes" 
muitiple="muitiple" 

name="CountryCodes"xoption value="MX">Mexico</option> 

<option value="CA">Canada</option> 

<option value="US">USA</option> 

<option value="FR">France</option> 

<option value="ES">Spain</option> 

<option value="DE">Germany</option> 

</select> 

<br /xbutton type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Seçim yok 

Birden çok sayfada "belirtilmemiş" seçeneğini kullanarak kendinizi bulursanız, HTML 'yi yinelemeyi ortadan 
kaldırmak için bir şablon oluşturabilirsiniz: 

@model CountryViewModel 

<form asp-controller="Home" asp-action="IndexEmpty" method="post"> 

@Fltml. EditorForModel() 

<br /xbutton type="submit">Register</button> 

</form> 


Vİews/Shared/EditorTemplates/CountryVievvModel, cshtml şablonu: 

@model CountryViewModel 

<select asp-for="Country" asp-items="Model.Countr'ies"> 

<option value="">--none--</option> 

</select> 


HTML <seçenek > öğeleri ekleme hiçbir seçim durumuyla sınırlı değildir. Örneğin, aşağıdaki görünüm ve eylem 
yöntemi yukarıdaki koda benzer HTML oluşturur: 


public IActionResult IndexNone() 

{ 

var model = new CountryViewModel(); 
model.Insert(0j new SelectListItem("<none>", 


return Vlew(model); 

} 









@model CountryViewModel 

<form asp-controller="Home" asp-action="IndexEmpty" method="post"> 

<select asp-for="Country"> 

<option value="">&lt;none&gt;</option> 
coption value="MX">Mexico</option> 

<option value="CA">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

</form> 

Geçerli country değerine bağlı olarak doğru <option> öğesi seçilecek ( seiected="seiected" özniteliğini içerir). 

public IActionResult IndexOption(int id) 

{ 

var model = new CountryViewModel(); 
model.Country = "CA"; 
return View(model); 

} 


<form method="post" action="/Home/IndexEmpty"> 

<select id="Country" name="Country"> 

<option value="">&lt;none&gt;</option> 

<option value="MX">Mexico</option> 

<option value="CA" selected="selected">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Ek kaynaklar 

• ASP.NET Core etiket yardımcıları 

• HTML form öğesi 

• istek doğrulama belirteci 

• ASP.NET Core'de model bağlama 

• ASP.NET Core MVC 'de model doğrulaması 

• lattributeadapter arabirimi 

• Bu belge için kod parçacıkları 







ASPNET Core formlardaki etiket yardımcıları 
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By Rick Anderson, N. Taylor Mullen, Davve Patııve Jerrie Pelser 

Bu belge, formlarda ve genellikle form üzerinde kullanılan HTML öğeleriyle çalışmayı gösterir. HTML form öğesi, 
Web uygulamalarının sunucuya veri geri göndermek için kullanacağı birincil mekanizmayı sağlar. Bu belgenin 
çoğunda Etiket Yardımcıları ve BUNLARıN güçlü HTML formları oluşturma konusunda nasıl yardımcı olabilecekleri 
açıklanmaktadır. Bu belgeyi okuyabilmeniz İçin yardımcıları etiketleyerek okumanız önerilir. 

Birçok durumda, HTML Yardımcıları belirli bir etiket Yardımcısı için alternatif bir yaklaşım sağlar, ancak bu etiket 
yardımcıların HTML yardımcılarını değiştirmez ve her HTML Yardımcısı için bir etiket Yardımcısı olmadığını bilmek 
önemlidir. Bir HTML Yardımcısı alternatifi varsa, bu, bahsedilir. 

Form etiketi Yardımcısı 

Form etiketi Yardımcısı: 

• MVC denetleyicisi eylemi veya adlandırılmış yol için HTML <FORM > action öznitelik değeri oluşturur 


• Siteler arası istek yasaklamasını engellemek için gizli bir İstek doğrulama belirteci ÜRETİR (http post eylem 



Örnek: 

<form asp-controller="Demo" asp-action="Register" method="post"> 
<!-- Input and Submit elements --> 

</form> 


Yukarıdaki form etiketi Yardımcısı aşağıdaki HTML 'yi oluşturur: 



oluşturur. Bir saf HTML formunun siteler arası istek sahteciliğini önleme 'den korunması zordur, form etiketi 
Yardımcısı bu hizmeti sizin için sağlar. 

Adlandırılmış yol kullanma 


asp-route 

Tag Helper özniteliği, HTML 

action 

özniteliği için de biçimlendirme oluşturabilir. 

register 


uygulama, kayıt sayfası için aşağıdaki biçimlendirmeyi kullanabilir: 






















<form asp-route="register" method="post"> 
<!-- Input and Submit elements --> 
</form> 


Görünümler/hesap klasöründeki görünümlerin birçoğu ( bireysel kullanıcı hesaplarıylayenl bir Web uygulaması 
oluşturduğunuzda oluşturulur), ASP-Route-ReturnUrl özniteliğini içerir: 

<form asp-controllen="Account" asp-action="Login" 
asp-route-returnurl="@ViewData["Returnllrl"]" 
method="post" class="form-horizontal" role="form"> 


NOTE 

Yerleşik şablonlarla returniiri , yalnızca yetkili bir kaynağa erişmeye çalıştığınızda ancak kimliği doğrulanmamış veya 
yetkilendirilmeyen otomatik olarak doldurulur. Yetkisiz erişim yapmaya çalıştığınızda, güvenlik ara yazılımı sizi neturnuri 
kümesi ile oturum açma sayfasına yönlendirir. 


Form eylemi etiketi Yardımcısı 


Form eylemi etiketi Yardımcısı, formaction özniteliği oluşturulan <button ...> veya cinput type="image" ...> 


etiketi üzerinde oluşturur. 

formaction 

özniteliği bir formun verilerini nereden gönderdiğini denetler. 

image 

ve 

<düğme > öğeleri <giriş 

> öğelerine 

bağlanır. Form eylemi etiketi Yardımcısı, karşılık gelen öğe için 

formaction 


bağlantısının oluşturulduğunu denetlemek için birkaç AnchorTagHelper asp- özniteliği kullanımını sağlar, 
formaction değerini denetlemek için desteklenen AnchorTagHelper öznitelikleri: 


ÖZNITELIK 

AÇIKLAMA 

ASP-Controller 

Denetleyicinin adı. 

ASP-eylem 

Eylem yönteminin adı. 

ASP-alanı 

Alanın adı. 

asp-sayfa 

Razor sayfasının adı. 

ASP-Page-Handler 

Razor sayfası işleyicisinin adı. 

ASP-Route 

Rotanın adı. 

ASP-Route-{Value} 

Tek bir URL yol değeri. Örneğin: asp-route-id="i234" . 

ASP-Ali- Route- Data 

Tüm rota değerleri. 

ASP-Fragment 

URL parçası. 


Denetleyiciye gönder örneği 

Aşağıdaki biçimlendirme, giriş veya düğme seçildiğinde formu HomeControiler 


index eylemine gönderir: 














cform method="post"> 

<button asp-controller="Hom 0 ” asp-action="Index">Click Me</button> 
<input type="image" src="..." alt="Or Click Me" asp-controller="Home" 

asp-action="Index"> 

</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/Home">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" formaction="/Home"> 
</form> 


Sayfa örneğine gönder 

Aşağıdaki biçimlendirme formu About Razor sayfasına gönderir: 

<form method="post"> 

<button asp-page="About">Click Me</button> 

cinput type="image" src="...“ alt="Or Click Me" asp-page="About"> 
</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/About">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" formaction="/About"> 
</form> 


Yönlendirme örneğine gönder 

/Home/Test uç noktasını göz önünde bulundurun: 

public class HomeController : Controller 

{ 

[Route("/Home/Test", Name = "Custom")] 
public string Test() 

{ 

return "This is the test page"; 

} 

} 

Aşağıdaki biçimlendirme formu /Home/Test uç noktasına gönderir. 

<form method="post"> 

<button asp-route="Custom">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" asp-route="Custom"> 
</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/Home/Test">Click Me</button> 

cinput type="image" snc="..." alt="Or Click Me" formaction="/Home/Test"> 
</form> 











Giriş etiketi Yardımcısı 

Giriş etiketi Yardımcısı, bir HTML <girişi > öğesini Razor görünüminizdeki bir model ifadesine bağlar. 

Sözdizimi: 

cinput asp-for="<Expression Name>"> 

Giriş etiketi Yardımcısı: 

• asp-for özniteliğinde belirtilen ifade adı için id ve name HTML özniteliklerini üretir. 
asp-for="Propertyl.Property2" m => m.Propertyl.Property2 eşdeğerdir, ifadenin adi, asp-for Öznitelİği 

değeri için kullanılan şeydir. Ek bilgi için ifade adları bölümüne bakın. 

• Model özelliğine uygulanan model türüne ve veri ek açıklaması ÖZNİTELİKLERINE göre HTML type 
öznitelik değerini ayarlar 

• Belirtilirse, HTML type öznitelik değerinin üzerine yazmaz 

• Model özelliklerine uygulanan veri ek açıklama özniteliklerinden HTML5 doğrulama öznitelikleri oluşturur 

• Htmi.TextBoxFor ve Htmi.EditorFor bir HTML Yardımcısı özelliği örtüşüyor. Ayrıntılar için bkz. giriş etiketi 
Yardımcısı İçin HTML Yardımcısı alternatifleri. 

• Güçlü yazma sağlar.Özelliğin adı değişirse ve etiket yardımcısını güncelleştirmezseniz aşağıdakine benzer bir 
hata alırsınız: 



ve oluşturulan HTML türü listelenmekte (her .NET türü listelenmemiştir). 


.NET TÜRÜ 

GİRİŞ türü 

Bool 

Type = "onay kutusu" 

Dize 

Type = "metin" 

DateTime 

Type ="TarihSaat-yerel' 

Bayt 

Type = "Number" 

int 

Type = "Number" 

Tek, Çift 

Type = "Number" 


Aşağıdaki tabloda, giriş etiketi Yardımcısı 'nın belirli giriş türleriyle eşleşecağı bazı ortak veri ek açıklamaları (her 
doğrulama özniteliğı listelenmez) gösterilmektedir: 












OZNITELIK 


GİRİŞ TURU 


EmailAddress 

Type = "e-posta" 

'Deki 

Type = "URL" 

[Hiddenınput] 

Type = "Hidden" 

Numarası 

Type = "tel" 

[DataType (DataType. Password)] 

Type = "Passvvord" 

[DataType (DataType. Date)] 

Type = "Date" 

[DataType (DataType. Time)] 

yazın = "Time" 


Örnek: 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class RegisterViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 

[Required] 

[DataType(DataType.Password)] 
public stning Password { get; set; } 

} 

} 


@model RegisterViewModel 

<form asp-controller="Demo" asp-action="RegisterInput" method="post"> 
Email: <input asp-for="Email" /> <br /> 

Password: cinput asp-fon="Password" /><bn /> 

<button type="submit">Registen</button> 

</fonm> 


Yukarıdaki kod, aşağıdaki HTML 'yi oluşturur: 

<fonm method="post" action="/Demo/RegistenInput"> 

Email: 

<input type="email" data-val="tnue" 

data-val-email="The Email Addness field is not a valid email address." 
data-val-required="The Email Address field is required." 
id="Email" name="Email" value=""xbr> 

Password: 

cinput type="password" data-val="true" 

data-val-required="The Password field is required." 
id="Password" name="Password"xbr> 
cbutton type="submit">Register</button> 

cinput name="_RequestVerificationToken" type="hidden" value="cremoved for brevity>"> 

c/form> 




Email ve Passwond özelliklerine uygulanan veri ek açıklamaları modelde meta veriler oluşturur. Giriş etiketi 
Yardımcısı, model meta verilerini kullanır ve HTM L5 data-vai-* öznitelikleri üretir (bkz. model doğrulama). Bu 
öznitelikler, giriş alanlarına iliştirilecek Doğrulayıcıları anlatmaktadır. Bu unobtrusive HTML5 vejQuery doğrulaması 
sağlar. Unobtrusive özniteliklerinin biçimi data-vai-ruie="Error Message" , burada kural doğrulama kuralının adıdır 
(örneğin, data-val-required , data-val-email , data-val-maxlength vb.) Öznitelikte bir hata iletisi sağlanırsa, 
data-vai-rule özniteliği için değer olarak görüntülenir. Ayrıca, kuralla ilgili ek ayrıntılar sağlayan 
data-val-ruleName-argumentName="argumentValue" form Öznitelikleri de vardır, Örneğin, 
data-val-maxlength-max="1024" . 

Giriş etiketi Yardımcısı için HTML Yardımcısı alternatifleri 

Htmi.TextBox , Htmi.TextBoxFor , Htmi.Editör ve Htmi.EditorFor , giriş etiketi Yardımcısı ile çakışan özelliklere 


sahiptir. Giriş etiketi Yardımcısı 

type 

özniteliğini otomatik olarak ayarlar; 

Htmi.TextBox 

ve 

Htmi.TextBoxFor 


Htmi.Editör 

ve 

Htmi.EditorFor 

■ tanıtıcı koleksiyonları, karmaşık nesneler ve şablonlar; Giriş etiketi Yardımcısı yok. 

Giriş etiketi Yardımcısı, Htmi.EditorFor ve Htmi.TextBoxFor kesin türdedir (lambda ifadeleri kullanırlar); 

Html.TextBox 

ve 

Htmi.Editör ı 

değildir (ifade adlarını kullanırlar). 


HtmlAttributes 

@Htmi.Editor() ve @Htmi.EditorFor( ), varsayılan şablonlarını yürütürken htmiAttributes adlı özel bir 
viewDataDictionary girişi kullanır. Bu davranış, isteğe bağlı olarak additionaiviewData parametreleri kullanılarak 
genişletilebilir. "HtmlAttributes" anahtarı büyük/küçük harfe duyarlıdır."HtmlAttributes" anahtarı, @Htmi.TextBox() 
gibi giriş yardımcılarını geçirilmiş htmiAttributes nesnesine benzer şekilde işlenir. 

@Html.EditorFor(model => model.YourProperty, 

new { htmiAttributes = new { @class="myCssClass ", style="Width:100px" } }) 

İfade adları 

asp-for öznitelik değeri, bir lambda ifadesinin bir ModeiExpression ve sağ tarafıdır. Bu nedenle, 
asp-for="Propertyi" oluşturulan kodda m => m.Propertyi hale gelir ve bu nedenle Model ile önek gerektirmez. 
karakterini kullanarak bir satır içi ifadeyi başlatabilir ve m. önce taşıyabilirsiniz: 

@{ 

var joe = "Doe"; 

} 

<input asp-for="@joe"> 


Şunları üretir: 


cinput type="text" id="joe" name="joe" value="loe"> 


Koleksiyon özellikleriyle 

asp-for="CollectionProperty[23].Member" , 

asp-for="CollectionProperty[i].Member" 

aynı adı üretir. 


i değer 23 olduğunda 


ASP.NET Core MVC ModeiExpression değerini hesapladığında Modeistate dahil olmak üzere çeşitli kaynakları 
inceler, cinput type="text" asp-for="@Name"> göz önünde bulundurun. Hesaplanan value özniteliği, öğesinden 
gelen ilk null olmayan değerdir: 


• "Name" anahtarına sahip giriş Modeistate. 

• İfadenin sonucu Model.Name . 


Alt özelliklerde gezinme 

Ayrıca, görünüm modelinin özellik yolunu kullanarak alt Özellikler 1 e gidebilirsiniz. Alt Address özelliği içeren daha 
karmaşık bir model sınıfı düşünün. 











































public class AddressViewModel 

{ 

public string AddressLinel { get; set; } 

} 


public class RegisterAddressViewModel 

{ 

public string Email { get; set; } 

[DataType(DataType.Password)] 
public string Password { get; set; } 

public AddressViewModel Address { get; set; } 

} 

Görünümde Address.AddressLinei bağlandık: 


@model RegisterAddressViewModel 

<form asp-controller="Demo" asp-action="RegisterAddress" method="post"> 
Email: <input asp-for="Email" /> <br /> 

Password: <input asp-for="Password" /><br /> 

Address: <input asp-for="Address.AddressLinel" /><br /> 

<button type="submit">Register</button> 

</form> 


Address.AddressLinei için aşağıdaki HTML oluşturulmuştur: 

<input type="text" id="Address_AddressLinel" name="Address.AddressLinel" value=""> 


İfade adları ve koleksiyonlar 

Örnek, bir dizi colors içeren bir modeldir: 

public class Person 

{ 

public List<string> Colors { get; set; } 
public int Age { get; set; } 

} 

Eylem yöntemi: 


public IActionResult Edit(int id, int colorIndex) 

{ 

ViewData["Index"] = colorIndex; 
return View(GetPerson(id)); 

} 


Aşağıdaki Razor, belirli bir color öğesine nasıl erişistediğinizi göstermektedir: 











@model Person 

@{ 

var index = (int)ViewData["index"]; 

} 

<form asp-controller="ToDo" asp-action="Edit" method="post"> 
@Html.EditorFor(m => m.Colors[index]) 
dabel asp-for="Age"x/label> 

<input asp-for="Age" /><br /> 

<button type="submit">Post</button> 

</form> 


Views/Shared/EdltorTemplates/Strlng. cshtml şablonu: 

@model string 

<label asp-for="@Model"x/label> 

<input asp-for="@Model" /> <br /> 

List<T > kullanarak örnek: 


public class ToDoltem 

{ 

public string Name { get; set; } 
public bool IsDone { get; set; } 

} 


Aşağıdaki Razor, bir koleksiyonun üzerinde nasıl yineleme yapılacağını göstermektedir: 

@model List<ToDoItem> 

<form asp-controller="ToDo" asp-action="Edit" method="post"> 

<table> 

<tr> <th>Name</th> <th>Is Done</th> </tr> 

@for (int i = 0; i < Model.Count; i++) 

{ 

<tr> 

@Html.EditorFor(model => modelfi]) 

</tr> 

} 

</table> 

<button type="submit">Save</button> 

</form> 


Views/Shared/EditorTemplates/Todoltem. cshtml şablonu: 




@model ToDoltem 
<td> 

<label asp-for="@Model.Name"x/label> 

@Html.DisplayFor(model = > model.Name) 

</td> 

<td> 

cinput asp-fon="@Model.IsDone" /> 

</td> 

This template replaces the following Razor which evaluates the indexer three tlmes. 

<td> 

<label asp-for="@Model[i] .Name"x/label> 

@Html.DisplayFor(model => model[i].Name) 

</td> 

<td> 

<input asp-for="@Model[i].IsDone" /> 

</td> 

*@ 

değer bir asp-for veya Htmi.DisplayFor denk bir bağlamda kullanılacaksa, mümkünse foreach kullanılmalıdır. 
Genel olarak, for bir Numaralandırıcı ayırması gerekmiyorsa, foreach daha iyidir (senaryo buna izin veriyorsa). 
Ancak, bir LINQ ifadesinde bir dizin oluşturucuyu değerlendirmek pahalı olabilir ve simge durumuna küçültülmüş 
olmalıdır. 


NOTE 

Yukarıdaki açıklamalı örnek kod, listedeki her bir ToDoltem erişmek için lambda ifadesinin @ işleçle nasıl değiştirileceğini 
gösterir. 


TextArea etiketi Yardımcısı 

Textarea Tag Helper Tag Yardımcısı giriş etiketi Yardımcısı ile benzerdir. 

• id ve name özniteliklerini ve <textarea > öğesi için modelden veri doğrulama özniteliklerini üretir. 

• Güçlü yazma sağlar. 

• HTML Yardımcısı alternatifi: Htmi.TextAreaFor 
Örnek: 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class DescriptionViewModel 

{ 

[MinLength(S) ] 

[MaxLength(1024)] 

public stning Description { get; set; } 

} 

} 













@model DescriptionViewModel 

<form asp-controller="Demo" asp-action="RegisterTextArea" method="post"> 
<textarea asp-for="Description"x/textarea> 

<button type="submit">Test</button> 

</form> 


Aşağıdaki HTML oluşturulur: 

<form method="post" action="/Demo/RegisterTextArea"> 

<textarea data-val="true" 

data-val-maxlength="The field Description must be a string or array type with a maximum length of 
&#x27;1024&#x27;." 

data-val-maxlength-max="1024" 

data-val-minlength="The field Description must be a string or array type with a minimum length of 
&#x27;5&#x27; 

data-val-minlength-min="5" 

id="Description" name="Description") 

</textarea> 

<button type="submit">Test</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Etiket etiketi Yardımcısı 

• Bir ifade adı için bir <label > öğesinde etiket başlık yazısı ve for özniteliği oluşturur 

• HTML Yardımcısı alternatifi: Htmi.LabeiFor . 

Label Tag Helper , saf HTML etiket öğesi üzerinde aşağıdaki avantajları sağlar: 

• Display özniteliğinden açıklayıcı etiket değerini otomatik olarak alırsınız, istenen görünen ad zaman içinde 
değişebilir ve Display özniteliği ve etiket etiketi Yardımcısı 'nın birleşimi, Display her yere uygular. 

• Kaynak kodunda daha az biçimlendirme 

• Model özelliğiyle güçlü yazma. 

Örnek: 


using System.ComponentModel.DataAnnotations; 


namespace FormsTagHelper.ViewModels 

{ 


public class SimpleViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 

} 










@model SimpleViewModel 

<fonm asp-controller="Demo" asp-action="Registerl_abel" method="post"> 

<label asp-fon="Email"x/label> 

<input asp-for="Email" /> <br /> 

</form> 

<iabei> öğesi için aşağıdaki HTML oluşturulur: 

dabel for="Email">Email Address</label> 

Etiket etiketi Yardımcısı, <input> öğesiyle ilişkili KİMLİK olan "e-posta" for öznitelik değerini oluşturdu. Etiket 
Yardımcıları, doğru ilişkilendirilebilen şekilde tutarlı id ve for öğeleri oluşturur. Bu örnekteki başlık Display 
özniteliğinden gelir. Modelde bir Display özniteliği yoksa, başlık ifadenin Özellik adı olacaktır. 

Doğrulama etiketi yardımcıları 

iki doğrulama etiketi yardımcıları vardır, validation Message Tag Helper (modelinizdeki tek bir özellik için bir 
doğrulama iletisi görüntüler) ve validation summary Tag Helper (doğrulama hatalarının özetini görüntüler), 
input Tag Helper , model sınıflarınızda bulunan veri ek açıklaması özniteliklerini temel alan giriş öğelerine HTML5 
istemci tarafı doğrulama öznitelikleri ekler. Doğrulama de sunucuda gerçekleştirilir. Doğrulama etiketi Yardımcısı, 
bir doğrulama hatası oluştuğunda bu hata iletilerini görüntüler. 

Doğrulama İletisi etiketi Yardımcısı 

• Belirtilen model özelliğinin giriş alanındaki doğrulama hatası mesajlarını bağlayan span öğesine HTML5 
data-vaimsg-for="property" özniteliğini ekler, istemci tarafı doğrulama hatası oluştuğunda, jöuery <span> 

öğesinde hata iletisini görüntüler. 

• Doğrulama de sunucuda gerçekleşir, istemciler JavaScript devre dışı bırakılmış olabilir ve bazı doğrulamalar 
yalnızca sunucu tarafında yapılabilir. 

• HTML Yardımcısı alternatifi: Html.ValidationMessageFor 

validation Message Tag Helper , bir HTML span öğesinde asp-validation-for özniteliğiyle kullanılır. 

<span asp-validation-for="Email"></span> 

Doğrulama İletisi etiketi Yardımcısı aşağıdaki HTML 'yi oluşturur: 

<span class="field-validation-valid" 
data-valmsg-for="Email" 
data-valmsg-replace="true"x/span> 

Aynı özellik için bir input etiketi Yardımcısı sonrasında validation Message Tag Helper genellikle kullanırsınız. 
Bunun yapılması, hataya neden olan girişin yakınında herhangi bir doğrulama hata iletisi görüntüler. 


NOTE 

İstemci tarafı doğrulaması için doğru JavaScript ve jQuery betik başvurularını içeren bir görünümsiniz olmalıdır. Daha fazla bilgi 
için bkz. model doğrulaması . 


Sunucu tarafı doğrulama hatası oluştuğunda (örneğin, özel sunucu tarafı doğrulamadan veya istemci tarafı 
doğrulaması devre dışı bırakılmışsa), MVC bu hata iletisini <span> öğesinin gövdesi olarak koyar. 




















<span class="field-validation-error" data-valmsg-for="Email" 
data-valmsg-replace="true"> 

The Email Address field is required. 

</span> 


Doğrulama Özeti etiketi Yardımcısı 

• asp-validation-summary özniteliği olan öğeleri <div> hedefleri 

• HTML Yardımcısı alternatifi: @Html.ValidationSummary 

Validation Summary Tag Helper , doğrulama iletilerinin Özetini göstermek için kullanılır, asp-validation-summary 
öznitelik değeri, aşağıdakilerden herhangi biri olabilir: 

ASP-DOĞRULAMA-ÖZET GÖRÜNEN DOĞRULAMA İLETİLERİ 

ValidationSummary. Ali Özellik ve model düzeyi 

Yalnızca ValidationSummary. model Model 

ValidationSummary. None Yok. 

Örnek 

Aşağıdaki örnekte, veri modelinde <input> öğesinde doğrulama hata iletileri üreten DataAnnotation öznitelikleri 
vardır. Doğrulama hatası oluştuğunda, doğrulama etiketi Yardımcısı şu hata iletisini görüntüler: 

using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class RegisterViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 

[Required] 

[DataType(DataType.Password)] 
public string Password { get; set; } 

} 

} 


@model RegisterViewModel 

<form asp-controller="Demo" asp-action="RegisterValidation" method="post"> 
<div asp-validation-summary="ModelOnly"x/div> 

Email: <input asp-for="Email" /> <br /> 

<span asp-validation-for="Email"x/spanxbr /> 

Password: <input asp-for="Password" /xbr /> 

<span asp-validation-for="Password"x/spanxbr /> 

<button type="submit">Register</button> 

</form> 


Oluşturulan HTML (model geçerli olduğunda): 











<form action="/DemoReg/Register" method="post"> 

<div class="validation-summary-valid" data-valmsg-summary="true"> 

<ulxli style="display: none"x/lix/ulx/div> 

Email: cinput name="Email" id="Email" type="email" value="" 
data-val-required="The Email field is required." 
data-val-email="The Email field is not a valid email address." 
data-val="true"xbr> 

<span elass="field-validation-valid" data-valmsg-replace="true" 
data-valmsg-fon=" Email "x/spanxbr> 

Password: <input name="Password" id="Password" type="password" 
data-val-required="The Password field is required." data-val="true"xbr> 

<span elass="field-validation-valid" data-valmsg-replace="true" 
data-valmsg-fon="Password"x/spanxbn> 

<button type="submit">Registen</button> 

cinput name="_RequestVerificationToken" type="hidden" value="<removed fon brevity>"> 

</fonm> 


Etiket Seç Yardımcısı 

• Modelinizin özellikleri için Select ve ilişkili seçenek öğeleri oluşturur. 



Örneğin: 


<select asp-for="Country" asp-items="Model.Countries"x/select> 


Örnek: 


using Microsoft.AspNetCone.Mvc.Rendering; 
using System.Collections.Generic; 

namespace FonmsTagHelpen.ViewModels 

{ 

public elass CountryViewModel 

{ 

public stning Country { get; set; } 

public List<SelectListItem> Countnies { get; } = new List<SelectListItem> 

{ 

new SelectListltem { Value = "MX", Text = "Mexico" }j 

new SelectListltem { Value = "CA", Text = "Canada" }j 

new SelectListltem { Value = "US", Text = "USA" }, 

}; 

} 

} 


index yöntemi countnyviewModei başlatır, seçilen ülkeyi ayarlar ve index görünümüne geçirir. 

public IActionResult Index() 

{ 

var model = new CountryViewModel(); 
model.Country = "CA"; 
return View(model); 

} 


HTTP POST index yöntemi seçimi görüntüler: 













[HttpPost] 

[ValidateAntiForgeryToken] 

public IActionResult Index(CountryViewModel model) 

{ 

if (ModelState.IsValid) 

{ 

var msg = model.Country + " selected"; 

return RedirectToAction("IndexSuccess", new { message = msg }); 

} 

// If we got this far, something failed; redlsplay form, 
return View(model); 


index görünümü: 


@model CountryViewModel 

<form asp-controller="Home" asp-action="Index" method="post"> 

<select asp-for="Country" asp-items="Model .Countries"x/select> 
<br /><button type="submit">Register</button> 

</form> 


Aşağıdaki HTML 'yi üreten ("CA" seçiliyken): 


<form method="post" action="/"> 

<select id="Country" name="Country"> 

<option value="MX">Mexico</option> 

coption selected="selected" value="CA">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


NOTE 

Etiket Seç Yardımcısı ile viewBag veya viewData kullanmanızı önermiyoruz. Bir görünüm modeli, MVC meta verileri 
sağlamaya ve genellikle daha az soruna neden olacak daha sağlamdır. 


asp-for öznitelik değeri özel bir durumdur ve Model öneki gerektirmez, diğer etiket Yardımcısı öznitelikleri olur ( 
asp-items gibi) 

<select asp-for="Country" asp-items="Model.Countries"x/select> 


Sabit Listesi bağlama 

<seiect> , enum bir özellik ile kullanmak ve enum değerlerinden selectListitem öğeleri oluşturmak için 
kullanışlıdır. 


Örnek: 









public class CountryEnumViewModel 

{ 

public CountryEnum EnumCountry { get; set; } 

} 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public enum CountryEnum 

{ 

[Display(Name = "United Mexican States")] 
Mexico, 

[Display(Name = "United States of America")] 
USA, 

Canada, 

France, 

Germany, 

Spain 

} 

} 


GetEnumSelectList yöntemi bir numaralandırma için selectList nesnesi oluşturur. 

@model CountryEnumViewModel 

<form asp-controller="Home" asp-action="IndexEnum" method="post"> 

<select asp-for="EnumCountry" 

asp-items="Html.GetEnumSelectList<CountryEnum>()"> 

</select> 

<br /><button type="submit">Register</button> 

</form> 

Daha zengin bir kullanıcı arabirimi almak için, Numaralandırıcı listenizi Display özniteliğiyle işaretleyebilirsiniz: 

using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public enum CountryEnum 

{ 

[Display(Name = "United Mexican States")] 

Mexico, 

[Display(Name = "United States of America")] 

USA, 

Canada, 

France, 

Germany, 

Spain 

} 

} 


Aşağıdaki HTML oluşturulur: 






<form method="post" action="/Home/IndexEnum"> 

<select data-val="true" data-val-required="The EnumCountry field is required." 
id="EnumCountry" name="EnumCountry"> 

<option value="0">United Mexican States</option> 

<option value="l">United States of America</option> 

<option value="2">Canada</option> 

<option value="3">France</option> 
coption value="4">Germany</option> 

<option selected="selected" value="5">Spain</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Seçenek grubu 

HTML <SeçenekGrubu > öğesi, görünüm modelinde bir veya daha fazla selectListGroup nesnesi içerdiğinde 
oluşturulur. 

countryviewModeiGroup , selectListitem öğelerini "Kuzey Amerika" ve "Avrupa" gruplarına gruplandırır: 






public class CountryViewModelGroup 

{ 

public CountryViewModelGroup() 

{ 

var NorthAmericaGroup = new SelectListGroup { Name = "North America" }; 
var EuropeGroup = new SelectListGroup { Name = "Europe" }; 

Countries = new List<SelectListItem> 

{ 

new SelectListltem 

{ 

Value = "MEX", 

Text = "Mexico", 

Group = NorthAmericaGroup 

}, 

new SelectListltem 

{ 

Value = "CAN", 

Text = "Canada", 

Group = NorthAmericaGroup 

b 

new SelectListltem 

{ 

Value = "US", 

Text = "USA", 

Group = NorthAmericaGroup 

b 

new SelectListltem 

{ 

Value = "FR", 

Text = "France", 

Group = EuropeGroup 

b 

new SelectListltem 

{ 

Value = "ES", 

Text = "Spain", 

Group = EuropeGroup 

b 

new SelectListltem 

{ 

Value = "DE", 

Text = "Germany", 

Group = EuropeGroup 

} 

b 

} 

public string Country { get; set; } 

public List<SelectListItem> Countries { get; } 


iki grup aşağıda gösterilmiştir: 
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Oluşturulan HTML: 


<form method="post" action="/Home/IndexGroup"> 

<select id="Country" name="Country"> 

<optgroup label="North America"» 

coption value="MEX">Mexicoc/option> 

<option value="CAN">Canada</option> 
coption value="US">USA</option> 

</optgroup> 

coptgroup label="Europe"> 

coption value="FR">Francec/option> 
coption value="ES">Spainc/option> 
coption value="DE">Germanyc/option> 
c/optgroup> 
c/select> 

cbr /»cbutton type="submit">Registerc/button> 

cinput name="_RequestVerificationToken" type="hidden" value="cremoved for brevity>"> 

c/form> 


Çoklu seçim 

asp-for özniteliğinde belirtilen özellik bir iEnumerabie ise, select etiketi Yardımcısı otomatik olarak birden çok = 
"Muitiple" özniteliği oluşturacaktır. Örneğin, aşağıdaki model verildiğinde: 


using Microsoft.AspNetCore.Mvc. Rendering; 
using System.Collections.Generic; 

namespace FormsTagHelper.ViewModels 

{ 

public class CountryViewModelIEnumerable 

{ 

public IEnumerablecstring» CountryCodes { get; set; } 

public ListcSelectListltem» Countries { get; } = new ListcSelectListltem» 

{ 

new SelectListltem { Value = "MX", Text = "Mexico" }, 

new SelectListltem { Value = "CA", Text = "Canada" }j 

new SelectListltem { Value = "US", Text = "USA" }, 

new SelectListltem { Value = "FR", Text = "France" }, 

new SelectListltem { Value = "ES", Text = "Spain" }, 

new SelectListltem { Value = "DE", Text = "Germany"} 

}; 

} 

} 


Aşağıdaki görünümle: 












@model CountryViewModelIEnumerable 

<form asp-controller="Home" asp-action="IndexMultiSelect" method="post"> 
<select asp-for="CountryCodes" asp-items="Model.Countries"x/select> 
<br /><button type="submit">Register</button> 

</form> 


Aşağıdaki HTML 'yi oluşturur: 

<form method="post" action="/Home/IndexMultiSelect"> 

<select id="CountryCodes" 
muitiple="muitiple" 

name="CountryCodes"xoption value="MX">Mexico</option> 

<option value="CA">Canada</option> 

<option value="US">USA</option> 

<option value="FR">France</option> 

<option value="ES">Spain</option> 

<option value="DE">Germany</option> 

</select> 

<br /xbutton type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Seçim yok 

Birden çok sayfada "belirtilmemiş" seçeneğini kullanarak kendinizi bulursanız, HTML 'yi yinelemeyi ortadan 
kaldırmak için bir şablon oluşturabilirsiniz: 

@model CountryViewModel 

<form asp-controller="Home" asp-action="IndexEmpty" method="post"> 

@Fltml. EditorForModel() 

<br /xbutton type="submit">Register</button> 

</form> 


Vİews/Shared/EditorTemplates/CountryVievvModel, cshtml şablonu: 

@model CountryViewModel 

<select asp-for="Country" asp-items="Model.Countr'ies"> 

<option value="">--none--</option> 

</select> 


HTML <seçenek > öğeleri ekleme hiçbir seçim durumuyla sınırlı değildir. Örneğin, aşağıdaki görünüm ve eylem 
yöntemi yukarıdaki koda benzer HTML oluşturur: 


public IActionResult IndexNone() 

{ 

var model = new CountryViewModel(); 
model.Insert(0j new SelectListItem("<none>", 


return Vlew(model); 

} 









@model CountryViewModel 

<form asp-controller="Home" asp-action="IndexEmpty" method="post"> 

<select asp-for="Country"> 

<option value="">&lt;none&gt;</option> 
coption value="MX">Mexico</option> 

<option value="CA">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

</form> 

Geçerli country değerine bağlı olarak doğru <option> öğesi seçilecek ( seiected="seiected" özniteliğini içerir). 

public IActionResult IndexOption(int id) 

{ 

var model = new CountryViewModel(); 
model.Country = "CA"; 
return View(model); 

} 


<form method="post" action="/Home/IndexEmpty"> 

<select id="Country" name="Country"> 

<option value="">&lt;none&gt;</option> 

<option value="MX">Mexico</option> 

<option value="CA" selected="selected">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Ek kaynaklar 

• ASP.NET Core etiket yardımcıları 

• HTML form öğesi 

• istek doğrulama belirteci 

• ASP.NET Core'de model bağlama 

• ASP.NET Core MVC 'de model doğrulaması 

• lattributeadapter arabirimi 

• Bu belge için kod parçacıkları 







ASPNET Core formlardaki etiket yardımcıları 
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By Rick Anderson, N. Taylor Mullen, Davve Patııve Jerrie Pelser 

Bu belge, formlarda ve genellikle form üzerinde kullanılan HTML öğeleriyle çalışmayı gösterir. HTML form öğesi, 
Web uygulamalarının sunucuya veri geri göndermek için kullanacağı birincil mekanizmayı sağlar. Bu belgenin 
çoğunda Etiket Yardımcıları ve BUNLARıN güçlü HTML formları oluşturma konusunda nasıl yardımcı olabilecekleri 
açıklanmaktadır. Bu belgeyi okuyabilmeniz İçin yardımcıları etiketleyerek okumanız önerilir. 

Birçok durumda, HTML Yardımcıları belirli bir etiket Yardımcısı için alternatif bir yaklaşım sağlar, ancak bu etiket 
yardımcıların HTML yardımcılarını değiştirmez ve her HTML Yardımcısı için bir etiket Yardımcısı olmadığını bilmek 
önemlidir. Bir HTML Yardımcısı alternatifi varsa, bu, bahsedilir. 

Form etiketi Yardımcısı 

Form etiketi Yardımcısı: 

• MVC denetleyicisi eylemi veya adlandırılmış yol için HTML <FORM > action öznitelik değeri oluşturur 


• Siteler arası istek yasaklamasını engellemek için gizli bir İstek doğrulama belirteci ÜRETİR (http post eylem 



Örnek: 

<form asp-controller="Demo" asp-action="Register" method="post"> 
<!-- Input and Submit elements --> 

</form> 


Yukarıdaki form etiketi Yardımcısı aşağıdaki HTML 'yi oluşturur: 



oluşturur. Bir saf HTML formunun siteler arası istek sahteciliğini önleme 'den korunması zordur, form etiketi 
Yardımcısı bu hizmeti sizin için sağlar. 

Adlandırılmış yol kullanma 


asp-route 

Tag Helper özniteliği, HTML 

action 

özniteliği için de biçimlendirme oluşturabilir. 

register 


uygulama, kayıt sayfası için aşağıdaki biçimlendirmeyi kullanabilir: 






















<form asp-route="register" method="post"> 
<!-- Input and Submit elements --> 
</form> 


Görünümler/hesap klasöründeki görünümlerin birçoğu ( bireysel kullanıcı hesaplarıylayenl bir Web uygulaması 
oluşturduğunuzda oluşturulur), ASP-Route-ReturnUrl özniteliğini içerir: 

<form asp-controllen="Account" asp-action="Login" 
asp-route-returnurl="@ViewData["Returnllrl"]" 
method="post" class="form-horizontal" role="form"> 


NOTE 

Yerleşik şablonlarla returniiri , yalnızca yetkili bir kaynağa erişmeye çalıştığınızda ancak kimliği doğrulanmamış veya 
yetkilendirilmeyen otomatik olarak doldurulur. Yetkisiz erişim yapmaya çalıştığınızda, güvenlik ara yazılımı sizi neturnuri 
kümesi ile oturum açma sayfasına yönlendirir. 


Form eylemi etiketi Yardımcısı 


Form eylemi etiketi Yardımcısı, formaction özniteliği oluşturulan <button ...> veya cinput type="image" ...> 


etiketi üzerinde oluşturur. 

formaction 

özniteliği bir formun verilerini nereden gönderdiğini denetler. 

image 

ve 

<düğme > öğeleri <giriş 

> öğelerine 

bağlanır. Form eylemi etiketi Yardımcısı, karşılık gelen öğe için 

formaction 


bağlantısının oluşturulduğunu denetlemek için birkaç AnchorTagHelper asp- özniteliği kullanımını sağlar, 
formaction değerini denetlemek için desteklenen AnchorTagHelper öznitelikleri: 


ÖZNITELIK 

AÇIKLAMA 

ASP-Controller 

Denetleyicinin adı. 

ASP-eylem 

Eylem yönteminin adı. 

ASP-alanı 

Alanın adı. 

asp-sayfa 

Razor sayfasının adı. 

ASP-Page-Handler 

Razor sayfası işleyicisinin adı. 

ASP-Route 

Rotanın adı. 

ASP-Route-{Value} 

Tek bir URL yol değeri. Örneğin: asp-route-id="i 234 " . 

ASP-Ali- Route- Data 

Tüm rota değerleri. 

ASP-Fragment 

URL parçası. 


Denetleyiciye gönder örneği 

Aşağıdaki biçimlendirme, giriş veya düğme seçildiğinde formu HomeControiler 


index eylemine gönderir: 














cform method="post"> 

<button asp-controller="Hom 0 ” asp-action="Index">Click Me</button> 
<input type="image" src="..." alt="Or Click Me" asp-controller="Home" 

asp-action="Index"> 

</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/Home">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" formaction="/Home"> 
</form> 


Sayfa örneğine gönder 

Aşağıdaki biçimlendirme formu About Razor sayfasına gönderir: 

<form method="post"> 

<button asp-page="About">Click Me</button> 

cinput type="image" src="...“ alt="Or Click Me" asp-page="About"> 
</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/About">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" formaction="/About"> 
</form> 


Yönlendirme örneğine gönder 

/Home/Test uç noktasını göz önünde bulundurun: 

public class HomeController : Controller 

{ 

[Route("/Home/Test", Name = "Custom")] 
public string Test() 

{ 

return "This is the test page"; 

} 

} 

Aşağıdaki biçimlendirme formu /Home/Test uç noktasına gönderir. 

<form method="post"> 

<button asp-route="Custom">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" asp-route="Custom"> 
</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/Home/Test">Click Me</button> 

cinput type="image" snc="..." alt="Or Click Me" formaction="/Home/Test"> 
</form> 











Giriş etiketi Yardımcısı 

Giriş etiketi Yardımcısı, bir HTML <girişi > öğesini Razor görünüminizdeki bir model ifadesine bağlar. 

Sözdizimi: 

cinput asp-for="<Expression Name>"> 

Giriş etiketi Yardımcısı: 

• asp-for özniteliğinde belirtilen ifade adı için id ve name HTML özniteliklerini üretir. 
asp-for="Propertyl.Property2" m => m.Propertyl.Property2 eşdeğerdir, ifadenin adi, asp-for Öznitelİği 

değeri için kullanılan şeydir. Ek bilgi için ifade adları bölümüne bakın. 

• Model özelliğine uygulanan model türüne ve veri ek açıklaması ÖZNİTELİKLERINE göre HTML type 
öznitelik değerini ayarlar 

• Belirtilirse, HTML type öznitelik değerinin üzerine yazmaz 

• Model özelliklerine uygulanan veri ek açıklama özniteliklerinden HTML5 doğrulama öznitelikleri oluşturur 

• Htmi.TextBoxFor ve Htmi.EditorFor bir HTML Yardımcısı özelliği örtüşüyor. Ayrıntılar için bkz. giriş etiketi 
Yardımcısı İçin HTML Yardımcısı alternatifleri. 

• Güçlü yazma sağlar.Özelliğin adı değişirse ve etiket yardımcısını güncelleştirmezseniz aşağıdakine benzer bir 
hata alırsınız: 



ve oluşturulan HTML türü listelenmekte (her .NET türü listelenmemiştir). 


.NET TÜRÜ 

GİRİŞ türü 

Bool 

Type = "onay kutusu" 

Dize 

Type = "metin" 

DateTime 

Type ="TarihSaat-yerel' 

Bayt 

Type = "Number" 

int 

Type = "Number" 

Tek, Çift 

Type = "Number" 


Aşağıdaki tabloda, giriş etiketi Yardımcısı 'nın belirli giriş türleriyle eşleşecağı bazı ortak veri ek açıklamaları (her 
doğrulama özniteliğı listelenmez) gösterilmektedir: 












OZNITELIK 


GİRİŞ TURU 


EmailAddress 

Type = "e-posta" 

'Deki 

Type = "URL" 

[Hiddenınput] 

Type = "Hidden" 

Numarası 

Type = "tel" 

[DataType (DataType. Password)] 

Type = "Passvvord" 

[DataType (DataType. Date)] 

Type = "Date" 

[DataType (DataType. Time)] 

yazın = "Time" 


Örnek: 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class RegisterViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 

[Required] 

[DataType(DataType.Password)] 
public stning Password { get; set; } 

} 

} 


@model RegisterViewModel 

<form asp-controller="Demo" asp-action="RegisterInput" method="post"> 
Email: <input asp-for="Email" /> <br /> 

Password: cinput asp-fon="Password" /><bn /> 

<button type="submit">Registen</button> 

</fonm> 


Yukarıdaki kod, aşağıdaki HTML 'yi oluşturur: 

<fonm method="post" action="/Demo/RegistenInput"> 

Email: 

<input type="email" data-val="tnue" 

data-val-email="The Email Addness field is not a valid email address." 
data-val-required="The Email Address field is required." 
id="Email" name="Email" value=""xbr> 

Password: 

cinput type="password" data-val="true" 

data-val-required="The Password field is required." 
id="Password" name="Password"xbr> 
cbutton type="submit">Register</button> 

cinput name="_RequestVerificationToken" type="hidden" value="cremoved for brevity>"> 

c/form> 




Email ve Passwond özelliklerine uygulanan veri ek açıklamaları modelde meta veriler oluşturur. Giriş etiketi 
Yardımcısı, model meta verilerini kullanır ve HTM L5 data-vai-* öznitelikleri üretir (bkz. model doğrulama). Bu 
öznitelikler, giriş alanlarına iliştirilecek Doğrulayıcıları anlatmaktadır. Bu unobtrusive HTML5 vejQuery doğrulaması 
sağlar. Unobtrusive özniteliklerinin biçimi data-vai-ruie="Error Message" , burada kural doğrulama kuralının adıdır 
(örneğin, data-val-required , data-val-email , data-val-maxlength vb.) Öznitelikte bir hata iletisi sağlanırsa, 
data-vai-rule özniteliği için değer olarak görüntülenir. Ayrıca, kuralla ilgili ek ayrıntılar sağlayan 
data-val-ruleName-argumentName="argumentValue" form Öznitelikleri de vardır, Örneğin, 
data-val-maxlength-max="1024" . 

Giriş etiketi Yardımcısı için HTML Yardımcısı alternatifleri 

Htmi.TextBox , Htmi.TextBoxFor , Htmi.Editör ve Htmi.EditorFor , giriş etiketi Yardımcısı ile çakışan özelliklere 


sahiptir. Giriş etiketi Yardımcısı 

type 

özniteliğini otomatik olarak ayarlar; 

Htmi.TextBox 

ve 

Htmi.TextBoxFor 


Htmi.Editör 

ve 

Htmi.EditorFor 

■ tanıtıcı koleksiyonları, karmaşık nesneler ve şablonlar; Giriş etiketi Yardımcısı yok. 

Giriş etiketi Yardımcısı, Htmi.EditorFor ve Htmi.TextBoxFor kesin türdedir (lambda ifadeleri kullanırlar); 

Html.TextBox 

ve 

Htmi.Editör ı 

değildir (ifade adlarını kullanırlar). 


HtmlAttributes 

@Htmi.Editor() ve @Htmi.EditorFor( ), varsayılan şablonlarını yürütürken htmiAttributes adlı özel bir 
viewDataDictionary girişi kullanır. Bu davranış, isteğe bağlı olarak additionaiviewData parametreleri kullanılarak 
genişletilebilir. "HtmlAttributes" anahtarı büyük/küçük harfe duyarlıdır."HtmlAttributes" anahtarı, @Htmi.TextBox() 
gibi giriş yardımcılarını geçirilmiş htmiAttributes nesnesine benzer şekilde işlenir. 

@Html.EditorFor(model => model.YourProperty, 

new { htmiAttributes = new { @class="myCssClass ", style="Width:100px" } }) 

İfade adları 

asp-for öznitelik değeri, bir lambda ifadesinin bir ModeiExpression ve sağ tarafıdır. Bu nedenle, 
asp-for="Propertyi" oluşturulan kodda m => m.Propertyi hale gelir ve bu nedenle Model ile önek gerektirmez. 
karakterini kullanarak bir satır içi ifadeyi başlatabilir ve m. önce taşıyabilirsiniz: 

@{ 

var joe = "Doe"; 

} 

<input asp-for="@joe"> 


Şunları üretir: 


cinput type="text" id="joe" name="joe" value="loe"> 


Koleksiyon özellikleriyle 

asp-for="CollectionProperty[23].Member" , 

asp-for="CollectionProperty[i].Member" 

aynı adı üretir. 


i değer 23 olduğunda 


ASP.NET Core MVC ModeiExpression değerini hesapladığında Modeistate dahil olmak üzere çeşitli kaynakları 
inceler, cinput type="text" asp-for="@Name"> göz önünde bulundurun. Hesaplanan value özniteliği, öğesinden 
gelen ilk null olmayan değerdir: 


• "Name" anahtarına sahip giriş Modeistate. 

• İfadenin sonucu Model.Name . 


Alt özelliklerde gezinme 

Ayrıca, görünüm modelinin özellik yolunu kullanarak alt Özellikler 1 e gidebilirsiniz. Alt Address özelliği içeren daha 
karmaşık bir model sınıfı düşünün. 











































public class AddressViewModel 

{ 

public string AddressLinel { get; set; } 

} 


public class RegisterAddressViewModel 

{ 

public string Email { get; set; } 

[DataType(DataType.Password)] 
public string Password { get; set; } 

public AddressViewModel Address { get; set; } 

} 

Görünümde Address.AddressLinei bağlandık: 


@model RegisterAddressViewModel 

<form asp-controller="Demo" asp-action="RegisterAddress" method="post"> 
Email: <input asp-for="Email" /> <br /> 

Password: <input asp-for="Password" /><br /> 

Address: <input asp-for="Address.AddressLinel" /><br /> 

<button type="submit">Register</button> 

</form> 


Address.AddressLinei için aşağıdaki HTML oluşturulmuştur: 

<input type="text" id="Address_AddressLinel" name="Address.AddressLinel" value=""> 


İfade adları ve koleksiyonlar 

Örnek, bir dizi colors içeren bir modeldir: 

public class Person 

{ 

public List<string> Colors { get; set; } 
public int Age { get; set; } 

} 

Eylem yöntemi: 


public IActionResult Edit(int id, int colorIndex) 

{ 

ViewData["Index"] = colorIndex; 
return View(GetPerson(id)); 

} 


Aşağıdaki Razor, belirli bir color öğesine nasıl erişistediğinizi göstermektedir: 











@model Person 

@{ 

var index = (int)ViewData["index"]; 

} 

<form asp-controller="ToDo" asp-action="Edit" method="post"> 
@Html.EditorFor(m => m.Colors[index]) 
dabel asp-for="Age"x/label> 

<input asp-for="Age" /><br /> 

<button type="submit">Post</button> 

</form> 


Views/Shared/EdltorTemplates/Strlng. cshtml şablonu: 

@model string 

<label asp-for="@Model"x/label> 

<input asp-for="@Model" /> <br /> 

List<T > kullanarak örnek: 


public class ToDoltem 

{ 

public string Name { get; set; } 
public bool IsDone { get; set; } 

} 


Aşağıdaki Razor, bir koleksiyonun üzerinde nasıl yineleme yapılacağını göstermektedir: 

@model List<ToDoItem> 

<form asp-controller="ToDo" asp-action="Edit" method="post"> 

<table> 

<tr> <th>Name</th> <th>Is Done</th> </tr> 

@for (int i = 0; i < Model.Count; i++) 

{ 

<tr> 

@Html.EditorFor(model => modelfi]) 

</tr> 

} 

</table> 

<button type="submit">Save</button> 

</form> 


Views/Shared/EditorTemplates/Todoltem. cshtml şablonu: 




@model ToDoltem 
<td> 

<label asp-for="@Model.Name"x/label> 

@Html.DisplayFor(model = > model.Name) 

</td> 

<td> 

cinput asp-fon="@Model.IsDone" /> 

</td> 

This template replaces the following Razor which evaluates the indexer three tlmes. 

<td> 

<label asp-for="@Model[i] .Name"x/label> 

@Html.DisplayFor(model => model[i].Name) 

</td> 

<td> 

<input asp-for="@Model[i].IsDone" /> 

</td> 

*@ 

değer bir asp-for veya Htmi.DisplayFor denk bir bağlamda kullanılacaksa, mümkünse foreach kullanılmalıdır. 
Genel olarak, for bir Numaralandırıcı ayırması gerekmiyorsa, foreach daha iyidir (senaryo buna izin veriyorsa). 
Ancak, bir LINQ ifadesinde bir dizin oluşturucuyu değerlendirmek pahalı olabilir ve simge durumuna küçültülmüş 
olmalıdır. 


NOTE 

Yukarıdaki açıklamalı örnek kod, listedeki her bir ToDoltem erişmek için lambda ifadesinin @ işleçle nasıl değiştirileceğini 
gösterir. 


TextArea etiketi Yardımcısı 

Textarea Tag Helper Tag Yardımcısı giriş etiketi Yardımcısı ile benzerdir. 

• id ve name özniteliklerini ve <textarea > öğesi için modelden veri doğrulama özniteliklerini üretir. 

• Güçlü yazma sağlar. 

• HTML Yardımcısı alternatifi: Htmi.TextAreaFor 
Örnek: 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class DescriptionViewModel 

{ 

[MinLength(S) ] 

[MaxLength(1024)] 

public stning Description { get; set; } 

} 

} 













@model DescriptionViewModel 

<form asp-controller="Demo" asp-action="RegisterTextArea" method="post"> 
<textarea asp-for="Description"x/textarea> 

<button type="submit">Test</button> 

</form> 


Aşağıdaki HTML oluşturulur: 

<form method="post" action="/Demo/RegisterTextArea"> 

<textarea data-val="true" 

data-val-maxlength="The field Description must be a string or array type with a maximum length of 
&#x27;1024&#x27;." 

data-val-maxlength-max="1024" 

data-val-minlength="The field Description must be a string or array type with a minimum length of 
&#x27;5&#x27; 

data-val-minlength-min="5" 

id="Description" name="Description") 

</textarea> 

<button type="submit">Test</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Etiket etiketi Yardımcısı 

• Bir ifade adı için bir <label > öğesinde etiket başlık yazısı ve for özniteliği oluşturur 

• HTML Yardımcısı alternatifi: Htmi.LabeiFor . 

Label Tag Helper , saf HTML etiket öğesi üzerinde aşağıdaki avantajları sağlar: 

• Display özniteliğinden açıklayıcı etiket değerini otomatik olarak alırsınız, istenen görünen ad zaman içinde 
değişebilir ve Display özniteliği ve etiket etiketi Yardımcısı 'nın birleşimi, Display her yere uygular. 

• Kaynak kodunda daha az biçimlendirme 

• Model özelliğiyle güçlü yazma. 

Örnek: 


using System.ComponentModel.DataAnnotations; 


namespace FormsTagHelper.ViewModels 

{ 


public class SimpleViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 

} 










@model SimpleViewModel 

<fonm asp-controller="Demo" asp-action="Registerl_abel" method="post"> 

<label asp-fon="Email"x/label> 

<input asp-for="Email" /> <br /> 

</form> 

<iabei> öğesi için aşağıdaki HTML oluşturulur: 

dabel for="Email">Email Address</label> 

Etiket etiketi Yardımcısı, <input> öğesiyle ilişkili KİMLİK olan "e-posta" for öznitelik değerini oluşturdu. Etiket 
Yardımcıları, doğru ilişkilendirilebilen şekilde tutarlı id ve for öğeleri oluşturur. Bu örnekteki başlık Display 
özniteliğinden gelir. Modelde bir Display özniteliği yoksa, başlık ifadenin Özellik adı olacaktır. 

Doğrulama etiketi yardımcıları 

iki doğrulama etiketi yardımcıları vardır, validation Message Tag Helper (modelinizdeki tek bir özellik için bir 
doğrulama iletisi görüntüler) ve validation summary Tag Helper (doğrulama hatalarının özetini görüntüler), 
input Tag Helper , model sınıflarınızda bulunan veri ek açıklaması özniteliklerini temel alan giriş öğelerine HTML5 
istemci tarafı doğrulama öznitelikleri ekler. Doğrulama de sunucuda gerçekleştirilir. Doğrulama etiketi Yardımcısı, 
bir doğrulama hatası oluştuğunda bu hata iletilerini görüntüler. 

Doğrulama İletisi etiketi Yardımcısı 

• Belirtilen model özelliğinin giriş alanındaki doğrulama hatası mesajlarını bağlayan span öğesine HTML5 
data-vaimsg-for="property" özniteliğini ekler, istemci tarafı doğrulama hatası oluştuğunda, jöuery <span> 

öğesinde hata iletisini görüntüler. 

• Doğrulama de sunucuda gerçekleşir, istemciler JavaScript devre dışı bırakılmış olabilir ve bazı doğrulamalar 
yalnızca sunucu tarafında yapılabilir. 

• HTML Yardımcısı alternatifi: Html.ValidationMessageFor 

validation Message Tag Helper , bir HTML span öğesinde asp-validation-for özniteliğiyle kullanılır. 

<span asp-validation-for="Email"></span> 

Doğrulama İletisi etiketi Yardımcısı aşağıdaki HTML 'yi oluşturur: 

<span class="field-validation-valid" 
data-valmsg-for="Email" 
data-valmsg-replace="true"x/span> 

Aynı özellik için bir input etiketi Yardımcısı sonrasında validation Message Tag Helper genellikle kullanırsınız. 
Bunun yapılması, hataya neden olan girişin yakınında herhangi bir doğrulama hata iletisi görüntüler. 


NOTE 

İstemci tarafı doğrulaması için doğru JavaScript ve jQuery betik başvurularını içeren bir görünümsiniz olmalıdır. Daha fazla bilgi 
için bkz. model doğrulaması . 


Sunucu tarafı doğrulama hatası oluştuğunda (örneğin, özel sunucu tarafı doğrulamadan veya istemci tarafı 
doğrulaması devre dışı bırakılmışsa), MVC bu hata iletisini <span> öğesinin gövdesi olarak koyar. 




















<span class="field-validation-error" data-valmsg-for="Email" 
data-valmsg-replace="true"> 

The Email Address field is required. 

</span> 


Doğrulama Özeti etiketi Yardımcısı 

• asp-validation-summary özniteliği olan öğeleri <div> hedefleri 

• HTML Yardımcısı alternatifi: @Html.ValidationSummary 

Validation Summary Tag Helper , doğrulama iletilerinin Özetini göstermek için kullanılır, asp-validation-summary 
öznitelik değeri, aşağıdakilerden herhangi biri olabilir: 

ASP-DOĞRULAMA-ÖZET GÖRÜNEN DOĞRULAMA İLETİLERİ 

ValidationSummary. Ali Özellik ve model düzeyi 

Yalnızca ValidationSummary. model Model 

ValidationSummary. None Yok. 

Örnek 

Aşağıdaki örnekte, veri modelinde <input> öğesinde doğrulama hata iletileri üreten DataAnnotation öznitelikleri 
vardır. Doğrulama hatası oluştuğunda, doğrulama etiketi Yardımcısı şu hata iletisini görüntüler: 

using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class RegisterViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 

[Required] 

[DataType(DataType.Password)] 
public string Password { get; set; } 

} 

} 


@model RegisterViewModel 

<form asp-controller="Demo" asp-action="RegisterValidation" method="post"> 
<div asp-validation-summary="ModelOnly"x/div> 

Email: <input asp-for="Email" /> <br /> 

<span asp-validation-for="Email"x/spanxbr /> 

Password: <input asp-for="Password" /xbr /> 

<span asp-validation-for="Password"x/spanxbr /> 

<button type="submit">Register</button> 

</form> 


Oluşturulan HTML (model geçerli olduğunda): 











<form action="/DemoReg/Register" method="post"> 

<div class="validation-summary-valid" data-valmsg-summary="true"> 

<ulxli style="display: none"x/lix/ulx/div> 

Email: cinput name="Email" id="Email" type="email" value="" 
data-val-required="The Email field is required." 
data-val-email="The Email field is not a valid email address." 
data-val="true"xbr> 

<span elass="field-validation-valid" data-valmsg-replace="true" 
data-valmsg-fon=" Email "x/spanxbr> 

Password: <input name="Password" id="Password" type="password" 
data-val-required="The Password field is required." data-val="true"xbr> 

<span elass="field-validation-valid" data-valmsg-replace="true" 
data-valmsg-fon="Password"x/spanxbn> 

<button type="submit">Registen</button> 

cinput name="_RequestVerificationToken" type="hidden" value="<removed fon brevity>"> 

</fonm> 


Etiket Seç Yardımcısı 

• Modelinizin özellikleri için Select ve ilişkili seçenek öğeleri oluşturur. 



Örneğin: 


<select asp-for="Country" asp-items="Model.Countries"x/select> 


Örnek: 


using Microsoft.AspNetCone.Mvc.Rendering; 
using System.Collections.Generic; 

namespace FonmsTagHelpen.ViewModels 

{ 

public elass CountryViewModel 

{ 

public stning Country { get; set; } 

public List<SelectListItem> Countnies { get; } = new List<SelectListItem> 

{ 

new SelectListltem { Value = "MX", Text = "Mexico" }j 

new SelectListltem { Value = "CA", Text = "Canada" }j 

new SelectListltem { Value = "US", Text = "USA" }, 

}; 

} 

} 


index yöntemi countnyviewModei başlatır, seçilen ülkeyi ayarlar ve index görünümüne geçirir. 

public IActionResult Index() 

{ 

var model = new CountryViewModel(); 
model.Country = "CA"; 
return View(model); 

} 


HTTP POST index yöntemi seçimi görüntüler: 













[HttpPost] 

[ValidateAntiForgeryToken] 

public IActionResult Index(CountryViewModel model) 

{ 

if (ModelState.IsValid) 

{ 

var msg = model.Country + " selected"; 

return RedirectToAction("IndexSuccess", new { message = msg }); 

} 

// If we got this far, something failed; redlsplay form, 
return View(model); 


index görünümü: 


@model CountryViewModel 

<form asp-controller="Home" asp-action="Index" method="post"> 

<select asp-for="Country" asp-items="Model .Countries"x/select> 
<br /><button type="submit">Register</button> 

</form> 


Aşağıdaki HTML 'yi üreten ("CA" seçiliyken): 


<form method="post" action="/"> 

<select id="Country" name="Country"> 

<option value="MX">Mexico</option> 

coption selected="selected" value="CA">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


NOTE 

Etiket Seç Yardımcısı ile viewBag veya viewData kullanmanızı önermiyoruz. Bir görünüm modeli, MVC meta verileri 
sağlamaya ve genellikle daha az soruna neden olacak daha sağlamdır. 


asp-for öznitelik değeri özel bir durumdur ve Model öneki gerektirmez, diğer etiket Yardımcısı öznitelikleri olur ( 
asp-items gibi) 

<select asp-for="Country" asp-items="Model.Countries"x/select> 


Sabit Listesi bağlama 

<seiect> , enum bir özellik ile kullanmak ve enum değerlerinden selectListitem öğeleri oluşturmak için 
kullanışlıdır. 


Örnek: 









public class CountryEnumViewModel 

{ 

public CountryEnum EnumCountry { get; set; } 

} 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public enum CountryEnum 

{ 

[Display(Name = "United Mexican States")] 
Mexico, 

[Display(Name = "United States of America")] 
USA, 

Canada, 

France, 

Germany, 

Spain 

} 

} 


GetEnumSelectList yöntemi bir numaralandırma için selectList nesnesi oluşturur. 

@model CountryEnumViewModel 

<form asp-controller="Home" asp-action="IndexEnum" method="post"> 

<select asp-for="EnumCountry" 

asp-items="Html.GetEnumSelectList<CountryEnum>()"> 

</select> 

<br /><button type="submit">Register</button> 

</form> 

Daha zengin bir kullanıcı arabirimi almak için, Numaralandırıcı listenizi Display özniteliğiyle işaretleyebilirsiniz: 

using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public enum CountryEnum 

{ 

[Display(Name = "United Mexican States")] 

Mexico, 

[Display(Name = "United States of America")] 

USA, 

Canada, 

France, 

Germany, 

Spain 

} 

} 


Aşağıdaki HTML oluşturulur: 






<form method="post" action="/Home/IndexEnum"> 

<select data-val="true" data-val-required="The EnumCountry field is required." 
id="EnumCountry" name="EnumCountry"> 

<option value="0">United Mexican States</option> 

<option value="l">United States of America</option> 

<option value="2">Canada</option> 

<option value="3">France</option> 
coption value="4">Germany</option> 

<option selected="selected" value="5">Spain</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Seçenek grubu 

HTML <SeçenekGrubu > öğesi, görünüm modelinde bir veya daha fazla selectListGroup nesnesi içerdiğinde 
oluşturulur. 

countryviewModeiGroup , selectListitem öğelerini "Kuzey Amerika" ve "Avrupa" gruplarına gruplandırır: 






public class CountryViewModelGroup 

{ 

public CountryViewModelGroup() 

{ 

var NorthAmericaGroup = new SelectListGroup { Name = "North America" }; 
var EuropeGroup = new SelectListGroup { Name = "Europe" }; 

Countries = new List<SelectListItem> 

{ 

new SelectListltem 

{ 

Value = "MEX", 

Text = "Mexico", 

Group = NorthAmericaGroup 

}, 

new SelectListltem 

{ 

Value = "CAN", 

Text = "Canada", 

Group = NorthAmericaGroup 

b 

new SelectListltem 

{ 

Value = "US", 

Text = "USA", 

Group = NorthAmericaGroup 

b 

new SelectListltem 

{ 

Value = "FR", 

Text = "France", 

Group = EuropeGroup 

b 

new SelectListltem 

{ 

Value = "ES", 

Text = "Spain", 

Group = EuropeGroup 

b 

new SelectListltem 

{ 

Value = "DE", 

Text = "Germany", 

Group = EuropeGroup 

} 

b 

} 

public string Country { get; set; } 

public List<SelectListItem> Countries { get; } 


iki grup aşağıda gösterilmiştir: 
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Oluşturulan HTML: 


<form method="post" action="/Home/IndexGroup"> 

<select id="Country" name="Country"> 

<optgroup label="North America"» 

coption value="MEX">Mexicoc/option> 

<option value="CAN">Canada</option> 
coption value="US">USA</option> 

</optgroup> 

coptgroup label="Europe"> 

coption value="FR">Francec/option> 
coption value="ES">Spainc/option> 
coption value="DE">Germanyc/option> 
c/optgroup> 
c/select> 

cbr /»cbutton type="submit">Registerc/button> 

cinput name="_RequestVerificationToken" type="hidden" value="cremoved for brevity>"> 

c/form> 


Çoklu seçim 

asp-for özniteliğinde belirtilen özellik bir iEnumerabie ise, select etiketi Yardımcısı otomatik olarak birden çok = 
"Muitiple" özniteliği oluşturacaktır. Örneğin, aşağıdaki model verildiğinde: 


using Microsoft.AspNetCore.Mvc. Rendering; 
using System.Collections.Generic; 

namespace FormsTagHelper.ViewModels 

{ 

public class CountryViewModelIEnumerable 

{ 

public IEnumerablecstring» CountryCodes { get; set; } 

public ListcSelectListltem» Countries { get; } = new ListcSelectListltem» 

{ 

new SelectListltem { Value = "MX", Text = "Mexico" }, 

new SelectListltem { Value = "CA", Text = "Canada" }j 

new SelectListltem { Value = "US", Text = "USA" }, 

new SelectListltem { Value = "FR", Text = "France" }, 

new SelectListltem { Value = "ES", Text = "Spain" }, 

new SelectListltem { Value = "DE", Text = "Germany"} 

}; 

} 

} 


Aşağıdaki görünümle: 












@model CountryViewModelIEnumerable 

<form asp-controller="Home" asp-action="IndexMultiSelect" method="post"> 
<select asp-for="CountryCodes" asp-items="Model.Countries"x/select> 
<br /><button type="submit">Register</button> 

</form> 


Aşağıdaki HTML 'yi oluşturur: 

<form method="post" action="/Home/IndexMultiSelect"> 

<select id="CountryCodes" 
muitiple="muitiple" 

name="CountryCodes"xoption value="MX">Mexico</option> 

<option value="CA">Canada</option> 

<option value="US">USA</option> 

<option value="FR">France</option> 

<option value="ES">Spain</option> 

<option value="DE">Germany</option> 

</select> 

<br /xbutton type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Seçim yok 

Birden çok sayfada "belirtilmemiş" seçeneğini kullanarak kendinizi bulursanız, HTML 'yi yinelemeyi ortadan 
kaldırmak için bir şablon oluşturabilirsiniz: 

@model CountryViewModel 

<form asp-controller="Home" asp-action="IndexEmpty" method="post"> 

@Fltml. EditorForModel() 

<br /xbutton type="submit">Register</button> 

</form> 


Vİews/Shared/EditorTemplates/CountryVievvModel, cshtml şablonu: 

@model CountryViewModel 

<select asp-for="Country" asp-items="Model.Countr'ies"> 

<option value="">--none--</option> 

</select> 


HTML <seçenek > öğeleri ekleme hiçbir seçim durumuyla sınırlı değildir. Örneğin, aşağıdaki görünüm ve eylem 
yöntemi yukarıdaki koda benzer HTML oluşturur: 


public IActionResult IndexNone() 

{ 

var model = new CountryViewModel(); 
model.Insert(0j new SelectListItem("<none>", 


return Vlew(model); 

} 









@model CountryViewModel 

<form asp-controller="Home" asp-action="IndexEmpty" method="post"> 

<select asp-for="Country"> 

<option value="">&lt;none&gt;</option> 
coption value="MX">Mexico</option> 

<option value="CA">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

</form> 

Geçerli country değerine bağlı olarak doğru <option> öğesi seçilecek ( seiected="seiected" özniteliğini içerir). 

public IActionResult IndexOption(int id) 

{ 

var model = new CountryViewModel(); 
model.Country = "CA"; 
return View(model); 

} 


<form method="post" action="/Home/IndexEmpty"> 

<select id="Country" name="Country"> 

<option value="">&lt;none&gt;</option> 

<option value="MX">Mexico</option> 

<option value="CA" selected="selected">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Ek kaynaklar 

• ASP.NET Core etiket yardımcıları 

• HTML form öğesi 

• istek doğrulama belirteci 

• ASP.NET Core'de model bağlama 

• ASP.NET Core MVC 'de model doğrulaması 

• lattributeadapter arabirimi 

• Bu belge için kod parçacıkları 
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By Rick Anderson, N. Taylor Mullen, Davve Patııve Jerrie Pelser 

Bu belge, formlarda ve genellikle form üzerinde kullanılan HTML öğeleriyle çalışmayı 
gösterir. HTML form öğesi, Web uygulamalarının sunucuya veri geri göndermek için 
kullanacağı birincil mekanizmayı sağlar. Bu belgenin çoğunda Etiket Yardımcıları ve 
BUNLARıN güçlü HTML formları oluşturma konusunda nasıl yardımcı olabilecekleri 
açıklanmaktadır. Bu belgeyi okuyabilmeniz İçin yardımcıları etiketleyerek okumanız önerilir. 

Birçok durumda, HTM L Yardımcıları belirli bir etiket Yardımcısı için alternatif bir yaklaşım 
sağlar, ancak bu etiket yardımcıların HTML yardımcılarını değiştirmez ve her HTML 
Yardımcısı için bir etiket Yardımcısı olmadığını bilmek önemlidir. Bir HTML Yardımcısı 
alternatifi varsa, bu, bahsedilir. 

Form etiketi Yardımcısı 

Form etiketi Yardımcısı: 

• MVC denetleyicisi eylemi veya adlandırılmış yol için HTML <FORM > action 
öznitelik değeri oluşturur 

• Siteler arası istek yasaklamasını engellemek için gizli bir İstek doğrulama belirteci 
ÜRETİR (http post eylem yönteminde [validateAntiForgeryToken] özniteliğiyle 
kullanıldığında) 

• Yol değerlerine <Parameter Name> eklendiği asp-route-<Parameter Name> Özniteliğini 
sağlar. Htmi.BeginForm ve Htmi.BeginRouteForm routevalues parametreleri benzer 
işlevlere sahiptir. 

• Bir HTML Yardımcısı alternatifi Htmi.BeginForm ve Htmi.BeginRouteForm 
Örnek: 

<form asp-controller="Demo" asp-action="Register" method="post"> 

<!-- Input and Submit elements --> 

</form> 


Yukarıdaki form etiketi Yardımcısı aşağıdaki HTML 'yi oluşturur: 


















kullanıldığında) engellemek için gizli bir İstek doğrulama belirteci oluşturur. Bir saf HTML 
formunun siteler arası istek sahteciliğini önleme 'den korunması zordur, form etiketi 
Yardımcısı bu hizmeti sizin için sağlar. 

Adlandırılmış yol kullanma 

asp-route Tag Helper özniteliği, HTML action özniteliği için de biçimlendirme 
oluşturabilir, register adlı bir uygulama, kayıt sayfası için aşağıdaki biçimlendirmeyi 
kullanabilir: 

<form asp-route="register" method="post"> 

<!-- Input and Submit elements --> 

</form> 

Görünümler/hesap klasöründeki görünümlerin birçoğu ( bireysel kullanıcı hesaplarıylayen\ 
bir Web uygulaması oluşturduğunuzda oluşturulur), ASP-Route-ReturnUrl özniteliğini 
içerir: 

<form asp-controller="Account" asp-action="Login" 
asp-route-returnurl="@ViewData["ReturnUrl"]" 
method="post" class="form-horizontal" role="form"> 


NOTE 

Yerleşik şablonlarla returnurl , yalnızca yetkili bir kaynağa erişmeye çalıştığınızda ancak kimliği 
doğrulanmamış veya yetkilendirilmeyen otomatik olarak doldurulur. Yetkisiz erişim yapmaya 
çalıştığınızda, güvenlik ara yazılımı sizi returnurl kümesi ile oturum açma sayfasına yönlendirir. 


Form eylemi etiketi Yardımcısı 

Form eylemi etiketi Yardımcısı, formaction özniteliği oluşturulan <button ...> veya 
<input type="image" ...> etiketi üzerinde oluşturur, formaction özniteliği bir formun 
verilerini nereden gönderdiğini denetler, image ve <düğme > öğeleri <giriş > öğelerine 
bağlanır. Form eylemi etiketi Yardımcısı, karşılık gelen öğe için formaction bağlantısının 
oluşturulduğunu denetlemek için birkaç AnchorTagHelper asp- özniteliği kullanımını 
sağlar. 

formaction değerini denetlemek için desteklenen AnchorTagHelper öznitelikleri: 


ÖZNITELIK 

AÇIKLAMA 

ASP-Controller 

Denetleyicinin adı. 

ASP-eylem 

Eylem yönteminin adı. 

ASP-alanı 

Alanın adı. 

asp-sayfa 

Razor sayfasının adı. 

ASP-Page-Handler 

Razor sayfası işleyicisinin adı. 

ASP-Route 

Rotanın adı. 















OZNITELIK 


AÇIKLAMA 


ASP-Route-{Value} 


Tek bir URL yol değeri. Örneğin: 

asp-route-id="1234" . 


ASP-Ali- Route- Data 


Tüm rota değerleri. 


ASP-Fragment URL parçası. 

Denetleyiciye gönder örneği 

Aşağıdaki biçimlendirme, giriş veya düğme seçildiğinde formu HomeControiler 
eylemine gönderir: 

<form method="post"> 

cbutton asp-controller="Home" asp-action="Index">Click Mec/button> 
<input type="image" src="...“ alt="Or Click Me" asp-controller="Home" 

asp-action="Index"> 

c/form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

cform method="post"> 

<button formaction="/Home">Click Mec/button> 

<input type="image" src="..." alt="Or Click Me" formaction="/Home"> 
c/form> 


Sayfa örneğine gönder 

Aşağıdaki biçimlendirme formu About Razor sayfasına gönderir: 

<form method="post"> 

cbutton asp-page="About">Click Me</button> 

cinput type="image" src="..." alt="Or Click Me" asp-page="About"> 
</fonm> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

cbutton formaction="/About">Click Mec/button> 

cinput type="image" src="...“ alt="On Click Me" formaction="/About"> 
c/form> 


Yönlendirme örneğine gönder 

/Home/Test uç noktasını göz önünde bulundurun: 

public class HomeControiler : Controller 

{ 

[Route("/Home/Test"j Name = "Custom")] 
public string Test() 

{ 

return "This is the test page"; 

} 

} 

Aşağıdaki biçimlendirme formu /Home/Test uç noktasına gönderir. 


Index 











<form method="post"> 

<button asp-route="Custom">Click Me</button> 

<input type="image" src="..." alt="Or Click Me" asp-route="Custom"> 
</form> 

Önceki biçimlendirme, aşağıdaki HTML 'yi oluşturur: 

<form method="post"> 

<button formaction="/Home/Test">Click Me</button> 

<input type="image" src="...“ alt="Or Click Me" formaction="/Home/Test"> 
</form> 


Giriş etiketi Yardımcısı 

Giriş etiketi Yardımcısı, bir HTML <girişi > öğesini Razor görünüminizdeki bir model 
ifadesine bağlar. 

Sözdizimi: 

<input asp-for="<Expression Name>"> 

Giriş etiketi Yardımcısı: 

• asp-for özniteliğinde belirtilen ifade adı için id ve name HTML özniteliklerini 
Üretir. asp-for="Propertyl.Property2" m => m.Propertyl.Property2 eşdeğerdir, 
ifadenin adı, asp-for özniteliği değeri için kullanılan şeydir. Ek bilgi için ifade adları 
bölümüne bakın. 

• Model özelliğine uygulanan model türüne ve veri ek açıklaması ÖZNITELIKLERINE 
göre HTML type öznitelik değerini ayarlar 

• Belirtilirse, HTML type öznitelik değerinin üzerine yazmaz 

• Model özelliklerine uygulanan veri ek açıklama özniteliklerinden HTML5 doğrulama 
öznitelikleri oluşturur 

• Htmi.TextBoxFor ve Htmi.EditorFor bir HTML Yardımcısı özelliği örtüşüyor. 

Ayrıntılar için bkz. giriş etiketi Yardımcısı İçin HTML Yardımcısı alternatifleri. 

• Güçlü yazma sağlar. Özelliğin adı değişirse ve etiket yardımcısını 
güncelleştirmezseniz aşağıdakine benzer bir hata alırsınız: 

An error occurred during the compilation of a resource required to process 
this request. Please review the following specific error details and modify 
your source code appropriately. 

Type expected 

'ReglsterViewModel' does not contain a definition for 'Email' and no 
extension method 'Email' accepting a first argument of type 'RegisterViewModel' 
could be found (are you missing a using directive or an assembly reference?) 

input Tag Yardımcısı, HTML type özniteliğini .NET türüne göre ayarlar.Aşağıdaki tabloda 
bazı ortak .NET türleri ve oluşturulan HTML türü listelenmekte (her .NET türü 
listelenmemiştir). 













.NET TÜRÜ 

GİRİŞ TÜRÜ 

Bool 

Type = "onay kutusu" 

Dize 

Type = "metin" 

DateTime 

Type ="TarihSaat-yerel" 

Bayt 

Type = "Number" 

int 

Type = "Number" 

Tek, Çift 

Type = "Number" 

Aşağıdaki tabloda, giriş etiketi Yardımcısı 'nın belirli giriş türleriyle eşleşecağı bazı ortak 
veri ek açıklamaları (her doğrulama özniteliği listelenmez) gösterilmektedir: 

ÖZNITELIK 

GİRİŞ türü 

EmailAddress 

Type = "e-posta" 

'Deki 

Type = "URL" 

[Hiddenınput] 

Type = "Hidden" 

Numarası 

Type = "tel" 

[DataType (DataType. Passvvord)] 

Type = "Passvvord" 

[DataType (DataType. Date)] 

Type = "Date" 

[DataType (DataType. Time)] 

yazın = "Time" 

Örnek: 


using System.ComponentModel. DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class RegisterViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Address")] 
public string Email { get; set; } 


[Required] 

[DataType(DataType.Password)] 
public string Password { get; set; } 

} 

} 




@model RegisterViewModel 

<form asp-controller="Demo" asp-action="RegisterInput" method="post"> 
Email: <input asp-for="Email" /> <br /> 

Password: <input asp-for="Password" /><br /> 

<button type="submit">Registerc/button> 
c/form> 


Yukarıdaki kod, aşağıdaki HTML 'yi oluşturur: 


<form method="post" action="/Demo/RegisterInput"> 

Email: 

cinput type="email" data-val="true" 

data-val-email="The Email Address field is not a valid email address." 
data-val-required="The Email Address field is required." 
id="Email" name="Email" value=""xbr> 

Password: 

cinput type="password" data-val="true" 

data-val-required="The Passwond field is required." 
id="Password" name="Password"xbr> 
cbutton type="submit">Registerc/button> 

cinput name="_RequestVenificationToken" type="hidden" value="cremoved for 

brevity>"> 

c/form> 


Email ve Password özelliklerine uygulanan veri ek açıklamaları modelde meta veriler 
oluşturur. Giriş etiketi Yardımcısı, model meta verilerini kullanır ve HTML5 data-vai-* 
öznitelikleri üretir (bkz. model doğrulama). Bu öznitelikler, giriş alanlarına iliştirilecek 
Doğrulayıcıları anlatmaktadır. Bu unobtrusive HTML5 vejQuery doğrulaması sağlar. 
Unobtrusive özniteliklerinin biçimi data-vai-ruie="Error Message" , burada kural 
doğrulama kuralının adıdır (örneğin, data-val-required , data-val-email , 
data-vai-maxiength vb.) Öznitelikte bir hata iletisi sağlanırsa, data-vai-rule özniteliği için 
değer olarak görüntülenir. Ayrıca, kuralla ilgili ek ayrıntılar sağlayan 
data-val-ruleName-argumentName="argumentValue" form Öznitelikleri de vardır, Örneğin, 
data-val-maxlength-max="1024" . 


Giriş etiketi Yardımcısı için HTML Yardımcısı alternatifleri 

Html.TextBox , Html.TextBoxFor , Html. Editör Ve Html. EditorFor , giriş etiketi YardimCISI ile 
çakışan özelliklere sahiptir. Giriş etiketi Yardımcısı type özniteliğini otomatik olarak 
ayarlar; Html.TextBox ve Html.TextBoxFor . Html.Editör Ve Html.EditorFor tamtlCI 
koleksiyonları, karmaşık nesneler ve şablonlar; Giriş etiketi Yardımcısı yok. Giriş etiketi 
Yardımcısı, Html.EditorFor ve Html.TextBoxFor kesin türdedir (lambda ifadeleri 
kullanırlar); Htmi.TextBox ve Html.Editör değildir (ifade adlarını kullanırlar). 

HtmlAttributes 

@Htmi.Editor() ve @Htmi.EditorFor(), varsayılan şablonlarını yürütürken htmiAttributes 
adlı özel bir viewDataDictionary girişi kullanır. Bu davranış, isteğe bağlı olarak 
additionaiviewData parametreleri kullanılarak genişletilebilir. "HtmlAttributes" anahtarı 
büyük/küçük harfe duyarlıdır. "HtmlAttributes" anahtarı, @Htmi.TextBox() gibi giriş 
yardımcılarını geçirilmiş htmiAttributes nesnesine benzer şekilde işlenir. 

@Html.EditorFor(model => model.YourProperty, 

new { htmiAttributes = new { @class="myCssClass", style="Width:100px" } }) 


İfade adlan 




























asp-for 

öznitelik değeri, bir lambda ifadesinin bir 

ModelExpression 

ve sağ tarafıdır. Bu 

nedenle, 

asp-for="Propertyi" oluşturulan kodda 

m => m.Propertyl 

hale gelir ve bu 

nedenle 

Model 

ile önek gerektirmez. karakterini kullanarak bir satır içi ifadeyi 

başlatabilir ve 

m. önce taşıyabilirsiniz: 






var joe = "loe"; 


} 

<input asp-for="@joe"> 


Şunları üretir: 

<input type="text" id="joe" name="joe" value="Doe"> 

Koleksiyon özellikleriyle asp-for="CoiiectionProperty[23] .Member" , i değer 23 olduğunda 
asp-for="CollectionProperty[i].Member" ayni adi Üretir. 

ASP.NET Core MVC ModeiExpression değerini hesapladığında Modeistate dahil olmak 
üzere çeşitli kaynakları inceler. <input type="text" asp-for="@Name"> göz önünde 
bulundurun. Hesaplanan value özniteliği, öğesinden gelen ilk null olmayan değerdir: 

• "Name" anahtarına sahip giriş Modeistate. 

• ifadenin sonucu Model.Name . 

Alt özelliklerde gezinme 

Ayrıca, görünüm modelinin özellik yolunu kullanarak alt Özellikler' e gidebilirsiniz. Alt 
Address özelliği içeren daha karmaşık bir model sınıfı düşünün. 

public class AddressViewModel 

{ 

public string AddressLinel { get; set; } 

} 


public class RegisterAddressViewModel 

{ 

public string Email { get; set; } 

[DataType(DataType.Password)] 
public string Password { get; set; } 

public AddressViewModel Address { get; set; } 

} 

Görünümde Address.AddressLinel bağlandık: 

@model RegisterAddressViewModel 

<form asp-controller="Demo" asp-action="RegisterAddress" method="post"> 
Email: <input asp-for="Email" /> <br /> 

Password: <input asp-for="Password" /><br /> 

Address: <input asp-for="Address.AddressLinel" /><br /> 

<button type="submit">Register</button> 

</form> 


Address.AddressLinel için aşağıdaki HTML oluşturulmuştur: 






















cinput type="text" id="Address_Addressl_inel" name="Address.AddressLinel" value=""> 


İfade adları ve koleksiyonlar 

Örnek, bir dizi colors içeren bir modeldir: 


public class Person 

{ 

public List<string> Colors { get; set; } 
public int Age { get; set; } 

} 


Eylem yöntemi: 

public IActionResult Edit(int id, int colorIndex) 

{ 

ViewData["Index"] = colorIndex; 
return View(GetPerson(id)); 

} 

Aşağıdaki Razor, belirli bir color öğesine nasıl erişistediğinizi göstermektedir: 

@model Person 

@{ 

var index = (int)ViewData["index"]; 

} 

<form asp-controller="ToDo" asp-action="Edit" method="post"> 

@Html.EditorFor(m => m.Colors[index]) 

<label asp-for="Age"x/label> 

<input asp-for="Age" /><br /> 

<button type="submit">Post</button> 

</form> 


Views/Shared/EditorTemplates/String. cshtml şablonu: 

@model string 

<label asp-for="@Model"></label> 
cinput asp-for="@Model" /> <br /> 

List<t> kullanarak örnek: 


public class ToDoltem 

{ 

public string Name { get; set; } 
public bool IsDone { get; set; } 

} 


Aşağıdaki Razor, bir koleksiyonun üzerinde nasıl yineleme yapılacağını göstermektedir: 









@model List<ToDoItem> 

<form asp-contnoller="ToDo" asp-action="Edit" method="post"> 
<table> 

<tn> <th>Name</th> <th>Is Done</th> </tr> 

@for (int i = 0; i < Model.Countj i++) 

{ 

<tn> 

@Html.EditorFor(model => model[i]) 

</tr> 

} 

</table> 

<button type="submit">Save</button> 

</form> 


Views/Shared/EditorTemplates/Todoltem. cshtml şablonu: 

@model ToDoltem 
<td> 

clabel asp-for="@Model.Name"x/label> 

@Html.DisplayFor(model => model.Name) 

</td> 

<td> 

<input asp-for="@Model.IsDone" /> 

</td> 

This template neplaces the followlng Razor whlch evaluates the lndexer three times. 
<td> 

clabel asp-for="@Model[i] .Name"x/label> 

@Html.DisplayFor(model => modelfi].Name) 

</td> 

<td> 

cinput asp-for="@Model[i].IsDone" /> 

</td> 

değer bir asp-for veya Htmi.DisplayFor denk bir bağlamda kullanılacaksa, mümkünse 
foreach kullanılmalıdır. Genel olarak, for bir Numaralandırıcı ayırması gerekmiyorsa, 
foreach daha iyidir (senaryo buna izin veriyorsa). Ancak, bir LINQ ifadesinde bir dizin 
oluşturucuyu değerlendirmek pahalı olabilir ve simge durumuna küçültülmüş olmalıdır. 


NOTE 

Yukarıdaki açıklamalı örnek kod, listedeki her bir ToDoltem erişmek için lambda ifadesinin @ 
işleçle nasıl değiştirileceğini gösterir. 


TextArea etiketi Yardımcısı 

Textarea Tag Helper Tag Yardımcısı giriş etiketi Yardımcısı ile benzerdir. 

• id ve name özniteliklerini ve <textarea > öğesi için modelden veri doğrulama 
özniteliklerini üretir. 


• Güçlü yazma sağlar. 













• HTML Yardımcısı alternatifi: Htmi.TextAreaFor 


Örnek: 


using System.ComponentModel. DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class DescriptionViewModel 

{ 

[MinLength(5) ] 

[MaxLength(1024)] 

public string Description { get; setj } 

} 


@model DescriptionViewModel 

<form asp-controller="Demo" asp-action="RegisterîextArea" method="post"> 
<textarea asp-for="Descr'iption"x/textarea> 

<button type="submit">Test</button> 

</form> 


Aşağıdaki HTML oluşturulur: 

<form method="post" action="/Demo/RegisterTextArea"> 

<textarea data-val="true" 

data-val-maxlength="The field Description must be a string or array type with a 
maximum length of &#x27;1024&#x27;." 
data-val-maxlength-max="1024" 

data-val-minlength="The field Description must be a string or array type with a 
minimum length of &#x27;5&#x27;." 
data-val-minlength-min="5" 
id="Description" name="Description"> 

</textarea> 

<button type="submit">Test</button> 

cinput name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Etiket etiketi Yardımcısı 

• Bir ifade adı için bir < label > öğesinde etiket başlık yazısı ve for özniteliği oluşturur 

• HTML Yardımcısı alternatifi: Htmi.LabeiFor . 

Label Tag Helper , saf HTML etiket öğesi üzerinde aşağıdaki avantajları sağlar: 

• Display özniteliğinden açıklayıcı etiket değerini otomatik olarak alırsınız, istenen 
görünen ad zaman içinde değişebilir ve Display özniteliği ve etiket etiketi 
Yardımcısı'nın birleşimi, Display her yere uygular. 

• Kaynak kodunda daha az biçimlendirme 

• Model özelliğiyle güçlü yazma. 


Örnek: 











using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 
{ 

public class SimpleViewModel 
{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Addness")] 
public string Email { get; set; } 

} 

} 


@model SimpleViewModel 

<form asp-controller="Demo" asp-action="RegisterLabel" method="post"> 

<label asp-for="Email"x/label> 

<input asp-for="Email" /> <br /> 

</fonm> 

<iabei> öğesi için aşağıdaki HTML oluşturulur: 

clabel for="Email">Email Address</label> 

Etiket etiketi Yardımcısı, <input> öğesiyle ilişkili KİMLİK olan "e-posta" for öznitelik 
değerini oluşturdu. Etiket Yardımcıları, doğru ilişkilendirilebilen şekilde tutarlı id ve for 
öğeleri oluşturur. Bu örnekteki başlık Display özniteliğinden gelir. Modelde bir Display 
özniteliği yoksa, başlık ifadenin Özellik adı olacaktır. 

Doğrulama etiketi yardımcıları 

iki doğrulama etiketi yardımcıları vardır, validation Message Tag Helper (modelinizdeki tek 
bir özellik için bir doğrulama iletisi görüntüler) ve validation summary Tag Helper 
(doğrulama hatalarının özetini görüntüler), mput Tag Helper , model sınıflarınızda bulunan 
veri ek açıklaması özniteliklerini temel alan giriş öğelerine HTML5 istemci tarafı doğrulama 
öznitelikleri ekler. Doğrulama de sunucuda gerçekleştirilir. Doğrulama etiketi Yardımcısı, bir 
doğrulama hatası oluştuğunda bu hata iletilerini görüntüler. 

Doğrulama İletisi etiketi Yardımcısı 

• Belirtilen model özelliğinin giriş alanındaki doğrulama hatası mesajlarını bağlayan 
span öğesine HTML5 data-vaimsg-for="property" özniteliğini ekler, istemci tarafı 
doğrulama hatası oluştuğunda, jöuery <span> öğesinde hata iletisini görüntüler. 

• Doğrulama de sunucuda gerçekleşir, istemciler JavaScript devre dışı bırakılmış 
olabilir ve bazı doğrulamalar yalnızca sunucu tarafında yapılabilir. 

• HTML Yardımcısı alternatifi: Html.ValidationMessageFor 

Validation Message Tag Helper , bir HTM L span Öğesinde asp-validation-for Özniteliğiyle 
kullanılır. 

<span asp-validation-for="Email"></span> 


Doğrulama İletisi etiketi Yardımcısı aşağıdaki HTML 'yi oluşturur: 

















<span class="field-validation-valid" 
data-valmsg-for="Email" 
data-valmsg-replace="true"x/span> 

Aynı özellik için bir input etiketi Yardımcısı sonrasında validation Message Tag Helper 
genellikle kullanırsınız. Bunun yapılması, hataya neden olan girişin yakınında herhangi bir 
doğrulama hata iletisi görüntüler. 


NOTE 

istemci tarafı doğrulaması için doğru JavaScript ve jQuery betik başvurularını içeren bir 
görünümsiniz olmalıdır. Daha fazla bilgi için bkz. model doğrulaması . 


Sunucu tarafı doğrulama hatası oluştuğunda (örneğin, özel sunucu tarafı doğrulamadan 
veya istemci tarafı doğrulaması devre dışı bırakılmışsa), MVC bu hata iletisini <span> 
öğesinin gövdesi olarak koyar. 

<span class="field-validation-erron" data-valmsg-for="Email" 
data-valmsg-replace="true"> 

The Email Address field is required. 

</span> 

Doğrulama Özeti etiketi Yardımcısı 

• asp-validation-summany özniteliği olan öğeleri <div> hedefleri 

• HTML Yardımcısı alternatifi: @Htmi.vaiidationSummary 

validation Summary Tag Helper , doğrulama iletilerinin özetini göstermek için kullanılır, 
asp-validation-summary öznitelik değeri, aşağıdakilerden herhangi biri olabilir: 

ASP-DOĞRULAMA-ÖZET GÖRÜNEN DOĞRULAMA İLETİLERİ 

ValidationSummary. Ali Özellik ve model düzeyi 

Yalnızca ValidationSummary. model Model 

ValidationSummary. None Yok. 

Örnek 

Aşağıdaki örnekte, veri modelinde <input> öğesinde doğrulama hata iletileri üreten 
DataAnnotation öznitelikleri vardır. Doğrulama hatası oluştuğunda, doğrulama etiketi 
Yardımcısı şu hata iletisini görüntüler: 












using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public class RegisterViewModel 

{ 

[Required] 

[EmailAddress] 

[Display(Name = "Email Addness")] 
public string Email { get; set; } 

[Required] 

[DataType(DataType.Password)] 
public string Password { get; set; } 

} 

} 


@model RegisterViewModel 

<form asp-controller="Demo" asp-action="RegisterValidation" method="post"> 
<div a sp-validation-suruma ry="ModelOnly"x/div> 

Email: <input asp-for="Email" /> <br /> 

<span asp-validation-for="Email"x/spanxbr /> 

Password: <input asp-for="Password" /xbr /> 

<span asp-validation-for="Password"x/spanxbr /> 

<button type="submit">Register</button> 

</form> 


Oluşturulan HTML (model geçerli olduğunda): 

<form action="/DemoReg/Register" method="post"> 

<div class="validation-summary-valid" data-valmsg-summary="true"> 

<ulxli style="display: none"x/lix/ulx/div> 

Email: cinput name="Email" id="Email" type="email" value="" 
data-val-required="The Email field is required." 
data-val-email="The Email field is not a valid email address." 
data-val="true"xbr> 

<span class="field-validation-valid" data-valmsg-replace="true" 
data-valmsg-for=" Email" x/spanxbr> 

Password: <input name="Password" id="Password" type="password" 
data-val-required="The Password field is required." data-val="true"xbr> 

<span class="field-validation-valid" data-valmsg-replace="true" 
data-valmsg-for="Password"x/spanxbr> 

<button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Etiket Seç Yardımcısı 

• Modelinizin özellikleri için Select ve ilişkili seçenek öğeleri oluşturur. 



seçenek öğelerini belirtir. Örneğin: 

<select asp-for="Country" asp-items="Model.Countries"x/select> 


Örnek: 









using Microsoft.AspNetCore.Mvc.Rendering; 
using System.Collections.Generic; 

namespace FormsTagHelper.ViewModels 

{ 

public class CountryViewModel 

{ 

public string Country { get; set; } 

public List<SelectListItem> Countries { get; } = new List<SelectListItem> 

{ 

new SelectListltem { Value = "MX", Text = "Mexico" }, 

new SelectListltem { Value = "CA", Text = "Canada" }, 

new SelectListltem { Value = "US", Text = "USA" }, 

}; 

} 

} 


index yöntemi countryViewModei başlatır, seçilen ülkeyi ayarlar ve index görünümüne 
geçirir. 

public IActionResult Index() 

{ 

var model = new CountryViewModel(); 
model.Country = "CA"; 
return View(model); 

} 


HTTP POST index yöntemi seçimi görüntüler: 

[HttpPost] 

[ValidateAntiForgeryToken] 

public IActionResult Index(CountryViewModel model) 

{ 

if (ModelState.IsValid) 

{ 

var msg = model.Country + " selected"; 

return RedirectToAction("IndexSuccess", new { message = msg }); 

} 

// If we got this far, something failed; redisplay form, 
return View(model); 

} 


index görünümü: 


@model CountryViewModel 

<form asp-controller="Home" asp-action="Index" method="post"> 

<select asp-for="Country" asp-items="Model.Countries"></select> 
<br /><button type="submit">Register</button> 

</form> 


Aşağıdaki HTML 'yi üreten ("CA" seçiliyken): 







<form method="post" action="/"> 

<select id="Country" name="Country"> 

<option value="MX">Mexico</option> 

<option selected="selected" value="CA">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for 

brevity>"> 

</form> 


NOTE 

Etiket Seç Yardımcısı ile viewBag veya viewData kullanmanızı önermiyoruz. Bir görünüm modeli, 
MVC meta verileri sağlamaya ve genellikle daha az soruna neden olacak daha sağlamdır. 


asp-fon öznitelik değeri özel bir durumdur ve Model öneki gerektirmez, diğer etiket 
Yardımcısı öznitelikleri olur ( asp-items gibi) 

<select asp-for="Country" asp-items="Model.Countrles"x/select> 


Sabit Listesi bağlama 


<select> , 

enum 

bir özellik ile kullanmak ve 

enum 

değerlerinden 

SelectListltem 


oluşturmak için kullanışlıdır. 


Örnek: 


public class CountryEnumViewModel 

{ 

public CountryEnum EnumCountry { get; set; } 

} 


using System.ComponentModel.DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public enum CountryEnum 

{ 

[Display(Name = "United Mexican States")] 
Mexico, 

[Display(Name = "United States of America")] 
USA, 

Canada, 

France, 

Germany, 

Spain 

} 

} 


GetEnumSelectList yöntemi bir numaralandırma için selectList nesnesi oluşturur. 
















@model CountryEnumViewModel 

<form asp-controller="Home" asp-action="IndexEnum" method="post"> 

<select asp-for="EnumCountry" 

asp-items="Html.GetEnumSelectListcCountryEnum>()"> 

</select> 

<br /><button type="submit">Register</button> 

</form> 

Daha zengin bir kullanıcı arabirimi almak için, Numaralandırıcı listenizi Display 
özniteliğiyle işaretleyebilirsiniz: 

using System.ComponentModel. DataAnnotations; 

namespace FormsTagHelper.ViewModels 

{ 

public enum CountryEnum 

{ 

[Display(Name = "United Mexican States")] 

Mexico, 

[Display(Name = "United States of America")] 

USA, 

Canada, 

France, 

Germany, 

Spain 

} 

} 


Aşağıdaki HTML oluşturulur: 

<form method="post" action="/Home/IndexEnum"> 

<select data-val="true" data-val-required="The EnumCountry field is required." 
id="EnumCountry" name="EnumCountry"> 

<option value="0">United Mexican States</option> 
coption value="l">United States of America</option> 
coption value="2">Canada</option> 
coption value="3">France</option> 
coption value="4">Germanyc/option> 
coption selected="selected" value="5">Spainc/option> 
c/select> 

cbr />cbutton type="submit">Registerc/button> 

cinput name="_RequestVerificationToken" type="hidden" value="cremoved for 

brevity>"> 

c/form> 


Seçenek grubu 

HTML <SeçenekGrubu > öğesi, görünüm modelinde bir veya daha fazla selectListGroup 
nesnesi içerdiğinde oluşturulur. 

countryViewModeiGroup , Seiectüstıtem öğelerini "Kuzey Amerika" ve "Avrupa" gruplarına 
gruplandırır: 









public class CountryViewModelGroup 

{ 

public CountryViewModelGroup() 

{ 

var NorthAmericaGroup = new SelectListGroup { Name = "North America" } 
var EuropeGroup = new SelectListGroup { Name = "Europe" }; 

Countries = new List<SelectListItem> 

{ 

new SelectListltem 

{ 

Value = "MEX", 

Text = "Mexico", 

Group = NorthAmericaGroup 

b 

new SelectListltem 

{ 

Value = "CAN", 

Text = "Canada", 

Group = NorthAmericaGroup 

b 

new SelectListltem 

{ 

Value = "US", 

Text = "USA", 

Group = NorthAmericaGroup 

b 

new SelectListltem 

{ 

Value = "FR", 

Text = "France", 

Group = EuropeGroup 

b 

new SelectListltem 

{ 

Value = "ES", 

Text = "Spain", 

Group = EuropeGroup 

new SelectListltem 

{ 

Value = "DE", 

Text = "Germany", 

Group = EuropeGroup 

} 

b 

} 

public string Country { get; set; } 

public List<SelectListItem> Countries { get; } 


iki grup aşağıda gösterilmiştir: 
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USA 
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Oluşturulan HTML: 

<form method="post" action="/Home/IndexGroup"> 

<select id="Country" name="Country"> 

<optgroup label="North America"» 

coption value="MEX">Mexico</option> 

<option value="CAN">Canada</option> 

<option value="US">USA</option> 

</optgroup> 

<optgroup label="Europe"> 

<option value="FR">France</option> 

<option value="ES">Spain</option> 

<option value="DE">Germany</option> 

</optgroup> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for 

brevity>"> 

</form> 


Çoklu seçim 

asp-for özniteliğinde belirtilen özellik bir iEnumerabie ise, select etiketi Yardımcısı 
otomatik olarak birden çok = "Multiple" özniteliği oluşturacaktır. Örneğin, aşağıdaki model 
verildiğinde: 

using Microsoft.AspNetCore.Mvc.Rendering; 
using System.Collections.Generic; 

namespace FormsTagHelper.ViewModels 

{ 

public class CountryViewModelIEnumerable 

{ 

public IEnumerable<string> CountryCodes { get; set; } 

public List<SelectListItem> Countries { get; } = new List<SelectListItem> 

{ 

new SelectListltem { Value = "MX", Text = "Mexico" }, 

new SelectListltem { Value = "CA", Text = "Canada" }, 

new SelectListltem { Value = "US", Text = "USA" }, 

new SelectListltem { Value = "FR", Text = "France" }, 

new SelectListltem { Value = "ES", Text = "Spain" }, 

new SelectListltem { Value = "DE", Text = "Germany"} 

}; 

} 

} 










Aşağıdaki görünümle: 


@model CountryViewModelIEnumerable 

<form asp-controller="Home" asp-action="IndexMultiSelect" method="post"> 
<select asp-for="CountryCodes" asp-items="Model .Countries"x/select> 
<br /><button type="submit">Register</button> 

</form> 


Aşağıdaki HTML 'yi oluşturur: 

<form method="post" action="/Home/IndexMultiSelect"> 

<select id="CountryCodes" 
multiple="multiple" 

name="CountryCodes"xoption value="MX">Mexico</option> 

<option value="CA">Canada</option> 

<option value="US">USA</option> 

<option value="FR">France</option> 

<option value="ES">Spain</option> 
coption value="DE">Germany</option> 

</select> 

<br /xbutton type="submit">Register'</button> 

<input name="_RequestVerificationToken" type="hidden" value="<removed for brevity>"> 

</form> 


Seçim yok 

Birden çok sayfada "belirtilmemiş" seçeneğini kullanarak kendinizi bulursanız, HTML 'yi 
yinelemeyi ortadan kaldırmak için bir şablon oluşturabilirsiniz: 

@model CountryViewModel 

<form asp-controller="Home" asp-action="IndexEmpty" method="post"> 

@Html.EditorForModel() 

<br /xbutton type="submit">Register'</button> 

</form> 


Views/Shared/EditorTemplates/CountryViewModel, cshtml şablonu: 

@model CountryViewModel 

<select asp-for="Country" asp-items="Model.Countries"> 

<option value="">--none--</option> 

</select> 


HTML <seçenek > öğeleri ekleme hiçbir seçim durumuyla sınırlı değildir. Örneğin, 
aşağıdaki görünüm ve eylem yöntemi yukarıdaki koda benzer HTML oluşturur: 

public IActionResult IndexNone() 

{ 

var model = new CountryViewModel(); 
model.Insert(0, new SelectLlstItem("<none>"j 
return View(model); 

} 







@model CountryViewModel 

<form asp-controller="Home" asp-action="IndexEmpty" method="post"> 
<select asp-for="Country"> 

<option value="">&ltj none&gt;</option> 

<option value="MX">Mexico</option> 

<option value="CA">Canada</option> 

«coption value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

</form> 


Geçerli country değerine bağlı olarak doğru <option> öğesi seçilecek l 
seiected="seiected" özniteliğini içerir). 


public IActionResult IndexOption(int id) 

{ 

var model = new CountryViewModel(); 
model.Country = "CA"; 
return View(model); 

} 


<form method="post" action="/Home/IndexEmpty"> 

<select id="Country" name="Country"> 

<option value="">&ltj none&gt;</option> 

«coption value="MX">Mexico</option> 

<option value="CA" selected="selected">Canada</option> 

<option value="US">USA</option> 

</select> 

<br /><button type="submit">Register</button> 

<input name="_RequestVerificationTol<en" type="hidden" value="<removed for 

brevity>"> 

</form> 


Ek kaynaklar 

• ASP.NET Core etiket yardımcıları 

• HTML form öğesi 

• istek doğrulama belirteci 

• ASP.NET Core'de model bağlama 

• ASP.NET Core MVC 'de model doğrulaması 

• lattributeadapter arabirimi 

• Bu belge için kod parçacıkları 
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31.07.2019 • 18 minutes to read ı Edit Online 


Tarafından Rick Anderson 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Görünüm bileşenleri 

Görünüm bileşenleri kısmi görünümlere benzerdir, ancak çok daha güçlüdür.Görüntüleme bileşenleri model 
bağlama kullanmaz ve yalnızca içine çağrılırken belirtilen verilere bağımlıdır. Bu makale, denetleyiciler ve 
görünümler kullanılarak yazılmıştır, ancak bileşenleri görüntüle Razor Pages ile de çalışır. 

Bir görünüm bileşeni: 

• Tam yanıt yerine bir öbek işler. 

• , Bir denetleyici ve görünüm arasında aynı sorun ayrımı ve test edilebilirlik avantajları içerir. 

• Parametrelere ve iş mantığına sahip olabilir. 

• Genellikle bir düzen sayfasından çağrılır. 

Görünüm bileşenleri, kısmi bir görünüm için çok karmaşık olan işleme mantığınızı her yerde, örneğin: 

• Dinamik gezinti menüleri 

• Etiket bulutu (veritabanını sorgular) 

• Oturum açma paneli 

• Alışveriş sepeti 

• Son yayımlanan makaleler 

• Normal blogdaki kenar çubuğu içeriği 

• Her sayfada işlenecek bir oturum açma paneli ve kullanıcının oturum açma durumuna bağlı olarak oturum 
açma veya oturum açma bağlantılarını gösterme 

Bir görünüm bileşeni iki bölümden oluşur: Sınıf (genellikle Vievvcomponentöğesinden türetilir) ve 
döndürdüğü sonuç (genellikle bir görünüm). Denetleyiciler gibi bir görünüm bileşeni de bir POCO olabilir, 
ancak çoğu geliştirici, 1 den viewComponent türeterek kullanılabilir yöntemler ve özelliklerden faydalanmak ister. 

Görünüm bileşenlerinin bir uygulamanın belirtimlerini karşılayıp karşılamadığını düşünürken, bunun yerine 
Razor bileşenleri kullanmayı göz önünde bulundurun. Razor bileşenleri ayrıca yeniden kullanılabilir Kullanıcı 
C# arabirimi birimleri oluşturmak için biçimlendirmeyi kodla birleştirir. Razor bileşenleri, istemci tarafı Ul 
mantığı ve kompozisyonu sağlarken geliştirici üretkenliği için tasarlanmıştır. Daha fazla bilgi için bkz. 

ASP.NET Core Razor bileşenleri oluşturma ve kullanma. 

Görünüm bileşeni oluşturma 

Bu bölüm, bir görünüm bileşeni oluşturmak için üst düzey gereksinimleri içerir. Makalenin ilerleyen 
kısımlarında, her adımı ayrıntılı olarak inceleyecek ve bir görünüm bileşeni oluşturacağız. 

Görünüm bileşeni sınıfı 

Bir görünüm bileşeni sınıfı, aşağıdakilerden herhangi biri tarafından oluşturulabilir: 

• Viewcomponent 'dan türetme 

• [viewComponent] Özniteliği özniteliğiyle bir sınıfı dekorasyon veya [viewComponent] özniteliği ile bir 






















sınıftan türetiliyor 

• Sonekin son ek Viev/component ile bittiği bir sınıf oluşturma 

Denetleyiciler gibi, görünüm bileşenleri ortak, iç içe olmayan ve soyut olmayan sınıflar olmalıdır. Görünüm 
bileşeni adı, "VievvComponent" sonekini kaldıran sınıf adıdır. Ayrıca viewComponentAttribute.Name özelliği 
kullanılarak açıkça belirtilebilir. 

Bir görünüm bileşeni Sınıfı: 

• Oluşturucu bağımlılığı ekleme işlemini tamamen destekler 

• , Bir görünüm bileşeninde filtre kullanamayabilmeniz için denetleyicinin yaşam döngüsünde bir parçası 
almaz 

Bileşen yöntemlerini görüntüle 

Bir InvokeAsync görünüm bileşeni, bir Task<IViewComponentResult> veya döndüren IViewComponentResult 
zaman uyumlu invoke bir yöntemde veya döndüren bir yöntemde mantığını tanımlar. Parametreler, model 
bağlamalarından değil doğrudan görünüm bileşeni çağrısından gelir. Bir görünüm bileşeni hiçbir şekilde isteği 
doğrudan işlemez. Genellikle, bir görünüm bileşeni bir modeli başlatır ve view yöntemini çağırarak bir 
görünüme geçirir. Özet bölümünde bileşen yöntemlerini görüntüleyin: 

• Bir veya döndüren invoke zamanuyumlu bir yöntem InvokeAsync Task<ıviewComponentResuit> döndüren 
bir yöntem tanımlayın. ıviewComponentResuit 

• Genellikle bir modeli başlatır ve viewComponent view yöntemini çağırarak bir görünüme geçirir. 

• Parametreler, HTTP değil çağırma yönteminden gelir. Model bağlama yok. 

• Doğrudan bir HTTP uç noktası olarak erişilemez. Bunlar, kodunuzun içinden çağrılır (genellikle bir 
görünümde). Bir görünüm bileşeni hiçbir şekilde isteği hiçbir şekilde işlemez. 

• Geçerli HTTP isteğindeki tüm ayrıntılar yerine imzada aşırı yüklendi. 

Arama yolunu görüntüle 

Çalışma zamanı, görünümü aşağıdaki yollarda arar: 

• /Views/{Controller adı}/Components/{View bileşen adı}/{View Name} 

• /Views/Shared/Components/{View bileşen adı}/{View Name} 

• /Pages/Shared/Components/{View bileşen adı}/{View Name} 

Arama yolu, denetleyiciler + görünümler ve Razor Pages kullanan projeler için geçerlidir. 

Bir görünüm bileşeni için varsayılan görünüm adı varsayılandır, yani görünüm dosyanız genellikle default. 
cs/ıfm/olarak adlandırılır. Görünüm bileşeni sonucunu oluştururken veya view yöntemini çağırırken farklı bir 
görünüm adı belirtebilirsiniz. 

Görünüm dosyasını default. cshtml olarak yazmanız ve görünümleri/paylaşılan/bileşenler/fgörünüm bileşen 
adı}/{View Name} yolunu kullanmanız önerilir. Bu örnekte kullanılan PriorityList görünüm bileşeni 
görünüm bileşeni görünümü için Görünümler/paylaşılan/bileşenler/prioritylist/default. cshtml kullanır. 

Bir görünüm bileşenini çağırma 

Görünüm bileşenini kullanmak için, aşağıdakileri bir görünüm içinde çağırın: 

@await Component.InvokeAsync("Name of view component", {Anonymous Type Containing Parameters}) 

Parametreleri InvokeAsync yöntemine geçirilir. Makalede geliştirilen görünüm bileşeni, 
Görünümler/Todo/lndex. cshtml görünüm dosyasından çağrılır. PriorityList Aşağıdaki şekilde, InvokeAsync 
yöntemi iki parametreyle çağrılır: 















































@await Component.InvokeAsync("PriorityList", new { maxPriority = 4, isDone = true }) 


Bir görünüm bileşenini etiket Yardımcısı olarak çağırma 

ASP.N ET Core 1,1 ve üzeri için bir görünüm bileşenini etiket Yardımcısıolarak çağırabilirsiniz: 

<vc:priority-list max-priority="2" is-done="false"> 

</vc:priority-list> 


Etiket Yardımcıları için Pascal özellikli sınıf ve Yöntem parametreleri, Kebab durumlarınaçevrilir. Bir görünüm 
bileşenini çağırmak için etiket Yardımcısı <vcx/vc> öğesini kullanır. Görünüm bileşeni aşağıdaki gibi belirtilir: 

<vc:[view-component-name] 

parameterl="parameterl value" 
parameter2="parameter2 value"> 

</vc:[view-component-name]> 

Bir görünüm bileşenini etiket Yardımcısı olarak kullanmak için, @addTagHeiper yönergesini kullanarak 
görünüm bileşenini içeren derlemeyi kaydedin. Görünüm bileşeniniz adlı MywebApp bir derlemede yer alıyorsa, 
_viewwimports. cshtml dosyasına aşağıdaki yönergeyi ekleyin: 

@addTagHelper *, Myl/JebApp 


Görünüm bileşenine başvuran herhangi bir dosyaya bir görünüm bileşenini etiket Yardımcısı olarak 
kaydedebilirsiniz. Etiket yardımcılarını kaydetme hakkında daha fazla bilgi için bkz. etiket Yardımcısı kapsamını 
yönetme . 

Bu öğreticide kullanılan yöntem: invokeAsync 

@await Component.InvokeAsync("PriorityList", new { maxPriority = 4, isDone = true }) 


Etiket Yardımcısı biçimlendirmesinde: 

<vc:priority-list max-priority="2" is-done="false"> 

</vc:priority-list> 

Yukarıdaki örnekte, PriorityList görünüm bileşeni olur priority-list . Görünüm bileşenine yönelik 
parametreler, Kebab durumunda öznitelik olarak geçirilir. 

Bir görünüm bileşenini doğrudan bir denetleyiciden çağırma 

Görünüm bileşenleri genellikle bir görünümden çağrılır, ancak bunları doğrudan bir denetleyici yönteminden 
çağırabilirsiniz. Görüntüleme bileşenleri, denetleyiciler gibi uç noktaları tanımlamıyorsa, 1 ın 
viewComponentResuit içeriğini döndüren bir denetleyici eylemini kolayca uygulayabilirsiniz. 

Bu örnekte, görünüm bileşeni doğrudan denetleyiciden çağrılır: 

public IActionResult IndexVC() 

{ 

return ViewComponent("Priorityl_ist", new { maxPriority = 3, İsDone = false }); 

} 


























İzlenecek yol: Basit bir görünüm bileşeni oluşturma 

Başlatıcı kodunu indirin, derleyin ve test edin. Bu, Yapılacaklar öğelerinin listesini görüntüleyen bir ToDo 
denetleyiciyi olan basit bir projem . 
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VievvComponent sınıfı ekleme 

Bir viewcomponents klasörü oluşturun ve aşağıdaki PriorityListviewComponent sınıfı ekleyin: 


using Microsoft.AspNetCore.Mvc; 
using Microsoft.EntityFrameworkCore; 
using System.Collections.Generic; 
using System.Linq; 
using System.Threading.Tasks; 
using ViewComponentSample.Models; 

namespace ViewComponentSample.ViewComponents 

{ 

public class Priorityl_istViewComponent : ViewComponent 

{ 

private readonly ToDoContext db; 

public Priorityl_istViewComponent(ToDoContext context) 

{ 

db = context; 

} 


} 


} 


public async Task<IViewComponentResult> InvokeAsync( 
int maxPriority, bool isDone) 

{ 

var items = await GetItemsAsync(maxPriority J İsDone); 
return View(items); 

} 

private Task<List<TodoItem>> GetItemsAsync(int maxPriorityj bool isDone) 

{ 


} 


return db.ToDo.Where(x => x.İsDone == isDone && 

x.Priority <= maxPriority).ToListAsync(); 


Koda notlar: 


• Görünüm bileşen sınıfları projedeki herhangi bir klasörde bulunabilir. 









• PriorityListviewcomponent sınıf adı, son ek vievvcomponentile sona ertiğinden, çalışma zamanı bir 
görünümden sınıf bileşenine başvururken "prioritylist" dizesini kullanır. Daha sonra ayrıntılı olarak 
açıklayacağım. 

• [viewComponent] Özniteliği bir görünüm bileşenine başvurmak için kullanılan adı değiştirebilir. 
Örneğin, sınıfını xyz adlandırdık ve viewComponent özniteliği uygulamış olduğumuz: 

[ViewComponent(Name = "PriorityList")] 
public class XYZ : ViewComponent 

• Yukarıdaki özniteliği görüntüle bileşen seçicisine bileşenle ilişkili görünümleri ararken adı 

PriorityList kullanmasını ve bir görünümden sınıf bileşenine başvururken "prioritylist" dizesini 
kullanmasını söyler. [viewComponent] Daha sonra ayrıntılı olarak açıklayacağım. 

• Bileşen, veri bağlamını kullanılabilir hale getirmek için bağımlılık ekleme işlemini kullanır. 

• invokeAsync bir görünümden çağrılabilen bir yöntemi gösterir ve rastgele sayıda bağımsız değişken 
alabilir. 

• invokeAsync ToDo Yöntemi isDone ve parametrelerinikarşılayanöğekümesinidöndürür maxPriority . 

Görünüm bileşeni Razor görünümünü oluşturma 

• Görünümler/paylaşdan/bileşenler klasörünü oluşturun. Bu klasör, adlandırılmış Bileşenler olmalıdır. 

• Görünümler/paylaşdan/bileşenler/PriorityList klasörünü oluşturun. Bu klasör adı, görünüm bileşen 
sınıfının adıyla ya da sınıfın adı eksi sonek ile eşleşmelidir (Bu kural izleniyorsa ve sınıf adında 
Vlev/component sonekini kullandıysanız). viewComponent Özniteliğini kullandıysanız, sınıf adının 
öznitelik atamasını eşleşmesi gerekir. 

• Bir Görünümler/paylaşdan/bileşenler/PriorityList/default. cshtml Razor görünümü oluşturun: 

@model IEnumerable<ViewComponentSample.Models.TodoItem> 

<h3>Priority Items</h3> 

<ul> 

(Şforeach (var todo in Model) 

{ 

<li>@todo.Name</li> 

} 

</ul> 

Razor görünümü bir listesini Todoitem alır ve görüntüler. Görünüm bileşeni invokeAsync yöntemi, 
görünümün adını (örneğimizde olduğu gibi) geçirmezse, varsaydan olarak kurala göre görünüm adı 
için kullanılır. Öğreticide daha sonra görünümün adının nasıl geçirileceğini göstereceğiz. Belirli bir 
denetleyicinin varsayılan stilini geçersiz kılmak için denetleyiciye özgü görünüm klasörüne bir 
görünüm ekleyin (örneğin, Görünümler/Todo/Components/PriorityList/default. cshtml) . 

Görünüm bileşeni denetleyiciye özgü ise, denetleyiciyi denetleyiciye özgü klasöre ekleyebilirsiniz 
(Görü nü m ler/Todo/bileşenler/Priority List/def a ult. cshtml). 

• Priority listesi div bileşenine, Görünümler/Todo/index. cshtml dosyasının altına bir çağrı içeren bir 
çağrı ekleyin: 


































</table> 

<div> 

@await Component.InvokeAsync("PriorityList", new { maxPriority = 2 , isDone = false }) 
</div> 


Biçimlendirme 


@await Component.InvokeAsync 


görünüm bileşenlerini çağırma söz dizimini gösterir, ilk 


bağımsız değişken, çağırmak veya çağırmak istediğimiz bileşenin adıdır. Sonraki parametreler bileşene 
geçirilir. invokeAsync rastgele sayıda bağımsız değişken alabilir. 


Uygulamayı test edin. Aşağıdaki görüntüde ToDo listesi ve öncelik öğeleri gösterilmektedir: 



Görünüm bileşenini doğrudan denetleyiciden de çağırabilirsiniz: 


public IActionResult IndexVC() 

{ 

return ViewComponent("PriorityList", new { maxPriority = 3, İsDone = false }); 

} 
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Bir görünüm adı belirtme 

Karmaşık bir görünüm bileşeninin bazı koşullarda varsayılan olmayan bir görünüm belirtmesi gerekebilir. 
Aşağıdaki kod, invokeAsync yönteminden "PVC" görünümünün nasıl ekleneceğini gösterir. 
PriorityListviewComponent Sınıfında invokeAsync yöntemi güncelleştirin. 

public async Task<IViewComponentResult> InvokeAsync( 
int n^Priority, bool isDone) 

{ 

string MyView = "Default"; 

// If asking for ali completed tasks, render with the "PVC" vlew. 
if (maxPriority > 3 && İsDone == true) 

{ 

MyView = "PVC"; 

} 

var items = await GetItemsAsync(maxPriority, İsDone); 
return View(MyView, items); 

} 


Görünümleri/paylaşdan/bileşenler/prioritylist/default. cshtml dosyasını 

views/Shared/Components/PRIORITYLIST/PVC. cshtmladU bir görünüme kopyalayın. PVC görünümünün 
kullanıldığını belirtmek için bir başlık ekleyin. 

@model IEnumerable<ViewComponentSample.Models.TodoItem> 

<h2> PVC Named Priority Component View</h2> 

<h4>@ViewBag.PriorityMessage</h4> 

<ul> 

@foreach (var todo in Model) 

{ 

<li>@todo.Name</li> 

} 

</ul> 


Güncelleştirme görünümierl/Todo/lndex. cshtml: 

@await Component.InvokeAsync("PriorityList"j new { maxPriority = 4, isDone = true }) 


Uygulamayı çalıştırın ve PVC görünümünü doğrulayın. 














PVC görünümü işlenmemişse, görünüm bileşenini 4 veya daha yüksek bir önceliğe sahip olduğunuzu 
doğrulayın. 

Görünüm yolunu inceleyin 

• Öncelik görünümü döndürülmemesi için öncelik parametresini üç veya daha az olacak şekilde 
değiştirin. 

• Vlews/Todo/Components/PriorltyList/default. cshtml 'Yi Idefault. cshtmlolarak geçici olarak yeniden 
adlandırın. 

• Uygulamayı test edin, şu hatayı alırsınız: 


An unhandled exception occurred while Processing the request. 

InvalidOperationException: The view 'Components/PriorityList/Default' wasn't found. The following 
locations were searched: 

/Views/ToDo/Components/PriorityList/Default.cshtml 
/Views/Shared/Components/PriorityList/Default.cshtml 
EnsureSııccessful 


• Görünümleri/ Todo/bileşenler/PriorityList/lDefault. cshtml 'yi 
vievvs/Shared/Components/Priorityllst/default. cshtm /olarak kopyalayın. 

• Görünümün paylaşılan klasörden olduğunu göstermek için paylaşılan Todo görünümü bileşen 
görünümüne bir biçimlendirme ekleyin. 


• Paylaşılan bileşen görünümünü test edin. 
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Sabit kodlanmış dizelerin önleme 

Derleme zamanı güvenliğini istiyorsanız, sabit kodlanmış görünüm bileşeni adını sınıf adıyla değiştirebilirsiniz. 
"VievvComponent" soneki olmadan görünüm bileşenini oluşturun: 


using Microsoft.AspNetCore.Mvc; 
using Microsoft.EntityFrameworkCore; 
using System.Collections.Generic; 
using System.Linq; 
using System.Threading.Tasks; 
using ViewComponentSample.Models; 

namespace ViewComponentSample.ViewComponents 

{ 

public class PriorityList : ViewComponent 

{ 

private readonly ToDoContext db; 

public PriorityList(ToDoContext context) 

{ 

db = context; 

} 


} 


} 


public async Task<IViewComponentResult> InvokeAsync( 
int maxPriority, bool isDone) 

{ 

var items = await GetItemsAsync(maxPriority J İsDone); 
return View(items); 

} 

private Task<List<TodoItem>> GetItemsAsync(int maxPriorityj bool isDone) 

{ 

return db.ToDo.Where(x => x.İsDone == isDone && 

x.Priority <= maxPriority) .Tol_istAsync(); 


} 


Razor görünümü using dosyanıza bir ifade ekleyin ve nameof işlecini kullanın: 










@using ViewComponentSample.Models 
@using ViewComponentSample.ViewComponents 
@model IEnumerable<TodoItem> 

<h2>ToDo nameof</h2> 

<!-- Markup removed fon brevity. --> 

<div> 

Note: 

To use the below line, you need to #define no_suffix in ViewComponents/PriorityList.cs or it 
won't compile. 

By doing so it will cause a problem to index as there will be multiple viewcomponents 

with the same name after the compilen removes the suffix "ViewComponent" 

*@ 

@*@await Component.InvokeAsync(nameof(PriorityList), new { maxPnionity = 4, isDone = true })*@ 
</div> 


Zaman uyumlu iş gerçekleştirin 

Zaman uyumsuz iş yapmanız gerekmiyorsa çerçeve invoke zaman uyumlu bir yöntem çağırma işlemini 
gerçekleştirir. Aşağıdaki yöntem, zaman uyumlu invoke bir görünüm bileşeni oluşturur: 

public class PriorityList : ViewComponent 

{ 

public IViewComponentResult Invoke(int maxPriority, bool İsDone) 

{ 

var items = new List<string> { $"maxPriority: {maxPriority}", $"isDone: {İsDone}" }; 
return View(items); 

} 

} 

Görünüm bileşeninin Razor dosyası invoke yöntemine geçirilen dizeleri listeler 
(Görü nü m ler/giriş/bileşenler/priority list/def a ult. cshtml): 

@model List<string> 

<h3>Priority Items</h3> 

<ul> 

@foreach (var item in Model) 

{ 

<li>@item</li> 

} 

</ul> 

Görünüm bileşeni, aşağıdaki yaklaşımlardan birini kullanarak bir Razor dosyasında (örneğin, 
views/Home/lndex. cshtml) çağrılır: 

• IVİevvComponentHelper 

• Etiket Yardımcısı 

IVİevvComponentHelper Yaklaşımı kullanmak için şunu çağırın component.invokeAsync : 

Görünüm bileşeni ile IVİevvComponentHelperRazor dosyası (örneğin, Görünümler/Home/lndex. cshtml) 
çağrılır. 


Çağrı Component.invokeAsync : 















@await Component.InvokeAsync(nameof(PriorityList) J new { maxPriority = 4, isDone = true }) 

Etiket Yardımcısını kullanmak için, @addTagHeipen yönergesini kullanarak görünüm bileşenini içeren derlemeyi 
kaydedin (görünüm bileşeni adlı MywebApp bir derlemede): 

@addTagHelper *, Myl/JebApp 

Razor biçimlendirme dosyasında bileşen etiketini görüntüle yardımcısını kullanın: 

<vc:priority-list max-priority="999" is-done="false"> 

</vc:priority-list> 

Öğesinin PriorityList.invoke Yöntem imzası zaman uyumludur, ancak Razor, biçimlendirme dosyasında ile 
Component.invokeAsync metodunu bulur ve çağırır. 

Tüm görünüm bileşeni parametreleri gereklidir 

Bir görünüm bileşenindeki her bir parametre gerekli bir özniteliktir. Bu GitHub sorununabakın. Herhangi bir 
parametre atlanırsa: 

• invokeAsync Yöntem imzası eşleşmez, bu nedenle Yöntem yürütülmez. 

• VievvComponent hiçbir biçimlendirmeyi işlemez. 

• Hata oluşturulmayacak. 

Ek kaynaklar 

• Görünümlere bağımlılık ekleme 












ASPNET Core 'de Razor dosyası derlemesi 

6.12.2019 • 6 minutes to read ı Edit Online 


Tarafından Rick Anderson 

Bir Razor dosyası, ilişkili MVC görünümü çağrıldığında çalışma zamanında derlenir. Derleme zamanı Razor 
dosyası yayımlama desteklenmiyor. Razor dosyaları isteğe bağlı olarak yayımlama zamanında derlenebilir ve ön 
derleme Aracı kullanılarak uygulama—dağıtılabilir. 

Razor dosyası, ilişkili Razor sayfası veya MVC görünümü çağrıldığında çalışma zamanında derlenir. Derleme 
zamanı Razor dosyası yayımlama desteklenmiyor. Razor dosyaları isteğe bağlı olarak yayımlama zamanında 
derlenebilir ve ön derleme Aracı kullanılarak uygulama—dağıtılabilir. 

Razor dosyası, ilişkili Razor sayfası veya MVC görünümü çağrıldığında çalışma zamanında derlenir. Razor 
dosyaları, Razor SDKkullanılarak hem derlemede hem de yayımlama zamanında derlenir. 

. Cshtml uzantılı Razor dosyaları, Razor SDKkullanılarak hem derlemede hem de yayımlama zamanında derlenir. 
Çalışma zamanı derlemesi, uygulamanız yapılandırılarak isteğe bağlı olarak etkinleştirilebilir. 

Razor derleme 

Razor dosyalarının derleme ve yayımlama zamanı derlemesi, Razor SDK tarafından varsayılan olarak 
etkinleştirilmiştir. Etkinleştirildiğinde, çalışma zamanı derlemesi derleme zamanı derlemesini tamamlar ve bunlar 
düzenlendiklerinde, Razor dosyalarının güncelleştirilmesine izin verir. 

Razor dosyalarının derleme ve yayımlama zamanı derlemesi, Razor SDK tarafından varsayılan olarak 
etkinleştirilmiştir. Razor dosyalarını güncelleştirildikten sonra düzenlediğinizde derleme zamanında desteklenir. 
Varsayılan olarak, yalnızca derlenen views. dil ve No. cshtml dosyaları ya da Razor dosyalarını derlemek için 
gerekli derlemeler, uygulamanız ile dağıtılır. 


IMPORTANT 

Ön derleme aracı kullanım dışı bırakılmıştır ve ASP.NET Core 3,0 ' de kaldırılacak. Razor SDK'ya geçiş yapmanızı öneririz. 

Razor SDK yalnızca proje dosyasında ön derleme özgü hiçbir özellik ayarlanmamışsa etkilidir. Örneğin,. csproj dosyasının 
MvcRazorCompileOnPublish özelliğinin true olarak ayarlanması Razor SDK 'sini devre dışı bırakır. 


Projeniz .NET Framevvork hedefliyorsa Microsoft. AspNetCore. Mvc. Razor. VievvCompilation NuGet paketini 
yükler: 

<PackageReference Include="Microsoft.AspNetCore.Mvc.Razor.ViewCompilation" 

Version="2.0.4" 

PrivateAssets="All" /> 

Projeniz .NET Core 'u hedefliyorsa, hiçbir değişiklik yapılması gerekmez. 

ASP.NET Core 2. x proje şablonları, varsayılan olarak MvcRazorCompileOnPublish özelliğini true olarak ayarlar. 
Sonuç olarak, bu öğe . csproj dosyasından güvenle kaldırılabilir. 









IMPORTANT 

Ön derleme aracı kullanım dışı bırakılmıştır ve ASP.NET Core 3,0 ' de kaldırılacak. Razor SDK'ya geçiş yapmanızı öneririz. 

ASP.NET Core 2,0 ' de otomatik olarak barındırılan bir dağıtım (SCD) gerçekleştirilirken Razor dosyası ön derlemesi 
kullanılamaz. 


MvcRazorCompileOnPubiish özelliğini tme olarak ayarlayın ve Microsoft AspNetCore. Mvc. Razor. 
VievvCompilation NuGet paketini yükler.Aşağıdaki. csproj örneği bu ayarları vurgular: 

<Project Sdk="Microsoft.NET.Sdk.Web"> 

<PropertyGroup> 

<TargetFramework>netcoreappl.1</TargetFramework> 

<MvcRazorCompileOnPublish>true</MvcRazorCompileOnPubiish» 

</PropertyGroup> 

<ItemGroup> 

<PackageReference Include="Microsoft.AspNetCore" Version="1.1.0" /> 

<PackageReference Include="Microsoft.AspNetCore.Mvc" Version="1.1.0" /> 

<PackageReference Include="Microsoft.AspNetCore.StaticFiles" Version="1.1.0" /> 

<PackageReference Include="Microsoft.AspNetCore.Mvc.Razor.ViewCompilation" Version="1.1.0-*" /> 
</ItemGroup> 

</Project> 

.NET Core CLI Publish komutuylauygulamayı çerçeveye bağlı bir dağıtım için hazırlayın. Örneğin, proje kökünde 
aşağıdaki komutu yürütün: 

dotnet publish -c Release 


Bir <project_name >. Derlenen Razor dosyalarını içeren PrecompiledViews. dil dosyası, ön derleme başarılı 
olduğunda üretilir. Örneğin, aşağıdaki ekran görüntüsünde VVebApplication 7. PrecompiledViews. c///içindekı 
lndex. cshtml 'nin içerikleri gösterilmektedir: 


Assembly Explorer 


ype to search ^ 

ı O WebApplication1.PrecompiledViews 1 1.0.0.0, msil. .Net 

> ^ Metadata 

> g3 References 
A (d AspNetCore 

t> ^ _Views_Home_About_cshtml 
t> <%Vı ews H o m e C o nta ct cshtm I 


> ı %. 


Views Home lndex cshtml 


> ^ Views Shared Error cshtml 

> ^ _Views_Shared_Layout_cshtml 

> _Views_Shared_ValidationScriptsPartial_cshtml 

> ^ _Vi ews_Vi ewl m p o rts_c shtm I 

> ^ _Views_ViewStart_cshtml 


lndex.cshtml X I 


> 


ViewData["Title"] = "Home Page"; 


<div id=”myCarousel" class=”carousel slide" data-ride="carousel" data-interval="6000"> 

<ol class="carousel-indicators"> 

<li data-target="#myCarousel” data-slide-to="0" class="active"X/li> 

<li data-target="#myCarousel" data-slide-to=”l"x/li> 

<li data-target="#myCarousel" data-slide-to="2"x/li> 

<li data-target="#myCarousel” data-slide-to=”3"x/li> 

</ol> 

<div class=”carousel-inner" role= M listbox"> 

<div class="item active"> 

<img src="~/images/bannerl.svg" alt="ASP.NET" class=”img-responsive” /> 

<div class="carousel-caption" role=”option"> 

<P> 

Learn how to build ASP.NET apps that can run anywhere. 

<a class="btn btn-default" href="https ://go.microsoft.com/fwlink/?LinkID=525028&clcid=0x409": 


Çalışma zamanı derlemesi 

Yapı zamanı derlemesi, Razor dosyalarının çalışma zamanı derlemesi tarafından belirlenir.ASP.NET Core MVC, 
bir. cshtml dosyasının İçeriği değiştiğinde Razor dosyalarını yeniden derleyerek. 

Yapı zamanı derlemesi, Razor dosyalarının çalışma zamanı derlemesi tarafından belirlenir. 
RazorVievvEngineOptions AllowRecompilingViewsOnFileChange, Razor dosyalarının (Razor görünümleri ve 
Razor Pages) yeniden derlendiğini ve dosyaların diskte değiştirilmesi durumunda güncelleştirilip 
güncelleştirilmediğini belirleyen bir değer alır veya ayarlar. 

Varsayılan değer için true : 

• Uygulamanın uyumluluk sürümü Version_2_1 veya daha önceki bir sürüme ayarlandıysa 



















• Uygulamanın uyumluluk sürümü Version_2_2 veya üzeri olarak ayarlandıysa ve uygulama geliştirme 
ortamındaysanız IsDevelopment. Diğer bir deyişle, AllovvRecompilingVievvsOnFileChange açıkça 
ayarlanmamışsa Razor dosyaları geliştirme dışı ortamda yeniden derlenmemiş. 

Uygulamanın uyumluluk sürümünü ayarlamaya yönelik rehberlik ve örnekler için bkz. ASP.NET Core MVC için 
uyumluluk sürümü. 

Tüm ortamlar ve yapılandırma modları için çalışma zamanı derlemesini etkinleştirmek için: 

1. Microsoft. AspNetCore. Mvc. Razor. RuntimeCompilation NuGet paketini yükler. 

2. Projenin Startup.ConfigureServices yöntemini AddRazorRuntimeCompilation çağrısı içerecek şekilde 
güncelleştirin. Örneğin: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRazorPages() 

.AddRazorRuntimeCompilation(); 

// code omitted for brevity 

} 

Çalışma zamanı derlemesini koşullu olarak etkinleştir 

Çalışma zamanı derlemesi, yalnızca yerel geliştirme için kullanılabilir olacak şekilde etkinleştirilebilir. Bu şekilde 
koşullu etkinleştirme, yayımlanan çıktının olmasını sağlar: 

• Derlenmiş görünümleri kullanır. 

• Boyutu küçüktür. 

• , izleyicileri dosyasını üretimde etkinleştirmez. 

Çalışma zamanı derlemesini ortam ve yapılandırma moduna göre etkinleştirmek için: 

1. Etkin configuration değerini temel alarak Microsoft. AspNetCore. Mvc. Razor. RuntimeCompilation 
paketine koşullu olarak başvurun: 

<PackageReference Include="Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation" Version="3.1.0" 
Condition="'$(Configuration)' == 'Debug'" /> 

2. Projenin Startup.ConfigureServices yöntemini AddRazorRuntimeCompilation çağrısı içerecek şekilde 
güncelleştirin. AddRazorRuntimeCompilation , yalnızca ASPNETCORE_ENVIRONMENT değişkeni Development olarak 
ayarlandığında hata ayıklama modunda çalışacak şekilde koşullu olarak yürütün: 

public IWebHostEnvironment Env { get; set; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

IMvcBuilder builder = Services.AddRazorPages(); 

#if DEBUG 

if (Env.IsDevelopment()) 

{ 

builder.AddRazorRuntimeCompilation(); 

} 

#endif 

// code omitted for brevity 

} 












Ek kaynaklar 

• ASP.NET Core MVC'deki görünümler 

• ASP.NET Core Razor Pages giriş 

• ASP.NET Core MVC'deki görünümler 

• ASP.NET Core Razor Pages giriş 

• ASP.NET Core MVC'deki görünümler 

• ASP.NET Core Razor SDK'Sı 





ASPNET Core 'de uygulama modeliyle çalışma 

6.12.2019 • 15 minutes to read ı Edit Online 


Steve Smith tarafından 

ASP.NET Core MVC, MVC uygulamasının bileşenlerini temsil eden bir uygulama modeli tanımlar. MVC öğelerinin 
nasıl davrandığını değiştirmek için bu modeli okuyabilir ve düzenleyebilirsiniz. Varsayılan olarak, MVC, hangi 
sınıfların denetleyici olduğunu belirlemek için bazı kuralları izler, bu sınıfların hangi yöntemlerin eylem olduğunu ve 
parametrelerin ve yönlendirmenin nasıl davranacağını sağlar. Kendi kurallarınızı oluşturarak ve bunları küresel 
olarak veya öznitelik olarak uygulayarak, uygulamanızın gereksinimlerine uyacak şekilde bu davranışı 
özelleştirebilirsiniz. 

Modeller ve sağlayıcılar 

ASP.NET Core MVC uygulama modeli, hem soyut arabirimleri hem de bir MVC uygulamasını tanımlayan somut 
uygulama sınıflarını içerir. Bu model, uygulamanın denetleyicilerini, eylemlerini, eylem parametrelerini, yolları ve 
filtreleri varsayılan kurallara göre bulma hakkında MVC 'nin sonucudur. Uygulama modeliyle çalışarak, 
uygulamanızı varsayılan MVC davranışından farklı kurallara göre izlemek için değiştirebilirsiniz. Parametrelerin, 
adların, yolların ve filtrelerin hepsi, Eylemler ve denetleyiciler için yapılandırma verileri olarak kullanılır. 

ASP.NET Core MVC uygulama modeli aşağıdaki yapıya sahiptir: 

• ApplicationModel 

o Denetleyiciler (ControllerModel) 
o Eylemler (ActionModel) 

o Parametreler (ParameterModel) 

Modelin her düzeyinin ortak bir Properties koleksiyonuna erişimi vardır ve alt düzeyler hiyerarşide daha yüksek 
düzeyler tarafından ayarlanan özellik değerlerine erişebilir ve üzerine yazabilir. Eylemler oluşturulduğunda 
Özellikler ActionDescriptor.Properties kalıcı hale getirilir. Bir istek işlenirken, bir kurala eklenen veya değiştirilen 
tüm özelliklere ActionContext.ActionDescriptor.Properties aracılığıyla erişilebilir. Özellikleri kullanmak, filtrelerinizi, 
model ciltlerinizi, vb. her eylem temelinde yapılandırmanın harika bir yoludur. 


NOTE 

Uygulama başlatma işlemi tamamlandıktan sonra ActionDescriptor.Properties koleksiyonu iş parçacığı güvenli değildir 
(yazma işlemleri için). Kurallar, bu koleksiyona güvenle veri eklemenin en iyi yoludur. 


lapplicationmodelprovider 

ASP.NET Core MVC, lapplicationmodelprovider arabirimi tarafından tanımlanan bir sağlayıcı modeli kullanarak 
uygulama modelini yükler. Bu bölümde, bu sağlayıcının nasıl çalıştığı hakkında bazı iç uygulama ayrıntıları ele 
alınmaktadır. Bu gelişmiş bir konudur, uygulama modelinden yararlanan birçok uygulama, kurallara göre çalışır. 

Her uygulamayla, order özelliğine göre artan sırada 0nProvidersExecuting arayan iAppiicationModeiProvider 
arabiriminin "Wrap" uygulamaları diğeri. 0 nProvidersExecuted yöntemi daha sonra ters sırada çağrılır. Framevvork 
çeşitli sağlayıcıları tanımlar: 

ilk ( Order=-1000 ): 


DefaultApplicationModelProvider 














Sonra ( Order=-990 ): 


• AuthorizationApplicationModelProvider 

• CorsApplicationModelProvider 



DefaultAppiicationModeiProvider , ASP.NET Core MVC tarafından kullanılan varsayılan davranışların çoğunu 
belirler. Sorumlulukları şunları içerir: 

• Bağlama genel filtreler ekleme 

• Bağlama denetleyicilere ekleniyor 

• Genel denetleyici yöntemlerini eylem olarak ekleme 

• Bağlama eylem yöntemi parametreleri ekleme 

• Yol ve diğer öznitelikler uygulanıyor 

Bazı yerleşik davranışlar DefaultApplicationModelProvider uygulanır. Bu sağlayıcı, ActionModel , PropertyModel ve 
ParameterModei örneklerine başvuran controiierModei oluşturmaktan sorumludur. 

DefaultAppiicationModeiProvider sınıfı, gelecekte değiştirecek bir iç çerçeve uygulama ayrıntısıyla sonuçlanır. 

AuthorizationApplicationModelProvider , AuthorizeFilter ve AllowAnonymousFilter Öznİtel İ kİ er İyi e ilişkili davranışı 
uygulamaktan sorumludur. Bu öznitelikler hakkında daha fazla bilgi edinin. 

CorsApplicationModelProvider , IEnableCorsAttribute ve IDisableCorsAttribute ve DisableCorsAuthorizationFilter 
ilişkili davranışı uygular. CORS hakkında daha fazla bilgi edinin. 

Kurallar 

Uygulama modeli, modellerin tüm model veya sağlayıcıyı geçersiz kılmasından daha basit bir yol sağlayan kural 
soyutlamalarını tanımlar. Bu soyutlamalar, uygulamanızın davranışını değiştirmek için önerilen yoldur.Kurallar, 
özelleştirmeleri dinamik olarak uygulayacak kodu yazmanız için bir yol sağlar. Filtreler çerçeve davranışının 
değiştirilmesini sağlayan bir yol sağlarken, özelleştirmeler uygulamanın tamamının birlikte nasıl çalıştığını 
denetlemenizi sağlar. 

Aşağıdaki kurallar kullanılabilir: 

• IApplicationModelConvention 

• IControllerModelConvention 

• IActionModelConvention 

• IParameterModelConvention 

Kurallar, MVC seçeneklerine eklenerek veya Attribute s uygulayarak ve bunları denetleyicilere, eylemlere veya 
eylem parametrelerine uygulayarak ( Filters benzer şekilde) uygulanır. Filtrelerin aksine, kurallar yalnızca 
uygulama başlatıldığında yürütülür, her isteğin bir parçası olarak değildir. 

Örnek: ApplicationModel değiştirme 












Aşağıdaki kural uygulama modeline bir özellik eklemek için kullanılır. 


using Microsoft.AspNetCore.Mvc.ApplicationModels; 

namespace AppModelSample.Conventions 

{ 

public class ApplicationDescription : IApplicationModelConvention 

{ 

private readonly string _description; 

public ApplicationDescription(string description) 

{ 

_description = description; 

} 

public void Apply(ApplicationModel application) 

{ 

application.Propertiesf'description"] = _description; 

} 

} 

} 

startup''configureServices MVC eklendiğinde, uygulama modeli kuralları seçenek olarak uygulanır. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddMvc(options => 

{ 

options.Conventions.Add(new ApplicationDescription("My Application Description")); 
options.Conventions.Add(new NamespaceRoutingConvention()); 

//options.Conventions.Add(new IdsMustBeInRouteParameterModelConvention()); 

}); 

} 


Özellikler, denetleyici eylemleri içindeki ActionDescriptor özellikleri koleksiyonundan erişilebilir: 

public class AppModelController : Controller 

{ 

public string Description() 

{ 

return "Description: " + ControllerContext.ActionDescriptor.Properties["description"]; 

} 

} 

Örnek: ControllerModel açıklamasını değiştirme 

Önceki örnekte olduğu gibi, denetleyici modeli de özel özellikler içerecek şekilde değiştirilebilir. Bunlar, varolan 
özellikleri uygulama modelinde belirtilen adla geçersiz kılar. Aşağıdaki kural özniteliği, denetleyici düzeyine bir 
açıklama ekler: 




using System; 

using Microsoft. AspNetCore.Mvc.ApplicationModels; 

namespace AppModelSample.Conventions 

{ 

public class ControllerDescriptionAttribute : Attribute, IControllerModelConvention 

{ 

private readonly string _description; 

public ControllerDescriptionAttribute(string description) 

{ 

_description = description; 

} 

public void Apply(ControllerModel controllerModel) 

{ 

controllerModel.Properties["description"] = _description; 

} 

} 

} 


Bu kural, bir denetleyiciye bir öznitelik olarak uygulanır. 

[ControllerDescription("Controller Description")] 

public class DescriptionAttributesController : Controller 

{ 

public string Index() 

{ 

return "Description: " + ControllerContext.ActionDescriptor.Properties["description"]; 

} 


"Description" özelliğine, önceki örneklerde olduğu gibi erişilir. 

Örnek: ActionModel açıklamasını değiştirme 

Ayrı bir öznitelik kuralı tek tek eylemlere uygulanabilir, uygulama veya denetleyici düzeyinde zaten uygulanmış 
davranışı geçersiz kılar. 

using System; 

using Microsoft.AspNetCore.Mvc.ApplicationModels; 

namespace AppModelSample.Conventions 

{ 

public class ActionDescriptionAttribute : Attribute, IActionModelConvention 

{ 

private readonly string _description; 

public ActionDescriptionAttribute(string description) 

{ 

_description = description; 

} 

public void Apply(ActionModel actionModel) 

{ 

actionModel.Properties["description"] = _description; 

} 

} 

} 


Bu, önceki örnekte denetleyicinin içindeki bir eyleme uygulandığında, denetleyici düzeyi kuralı nasıl geçersiz 
kılacağını gösterir: 






[ControllerDescription("Controller Description")] 

public class DescriptionAttributesController : Controller 

{ 

public string Index() 

{ 

return "Description: " + ControllerContext.ActionDescriptor.Properties["description"]; 

} 

[ActionDescription("Action Description")] 
public string UseActionDescriptionAttribute() 

{ 

return "Description: " + ControllerContext.ActionDescriptor.Properties["description"]; 

} 

} 

Örnek: ParameterModel değiştirme 

Aşağıdaki kural, Bindinginfo değiştirmek için eylem parametrelerine uygulanabilir. Aşağıdaki kural parametrenin 
bir yol parametresi olmasını gerektirir; diğer olası bağlama kaynakları (sorgu dizesi değerleri gibi) yok sayılır. 

using System; 

using Microsoft.AspNetCore.Mvc.ApplicationModels; 
using Microsoft.AspNetCore.Mvc.ModelBinding; 

namespace AppModelSample.Conventions 

{ 

public class MustBelnRouteParameterModelConvention : Attribute, IParameterModelConvention 

{ 

public void Apply(ParameterModel model) 

{ 

if (model.Bindinginfo == null) 

{ 

model.Bindinginfo = new BindingInfo(); 

} 

model.Bindinginfo.BindingSource = BindingSource.Path; 

} 

} 

} 

Öznitelik herhangi bir eylem parametresine uygulanabilir: 

public class ParameterModelController : Controller 

{ 

// Will bind: /ParameterModel/GetById/123 
// WON’T bind: /ParameterModel/GetById?id=123 

public string GetById([MustBeInRouteParameterModelConvention]int id) 

{ 

return $"Bound to id: {id}"; 

} 

} 

Örnek: ActionModel adını değiştirme 

Aşağıdaki kural, uygulandığı eylemin adını güncelleştirmek için ActionModel değiştirir. Yeni ad, özniteliğe bir 
parametre olarak sağlanır. Bu yeni ad yönlendirme tarafından kullanılır, bu nedenle bu eylem yöntemine ulaşmak 
için kullanılan yolu etkileyecektir. 







using System; 

using Microsoft. AspNetCore.Mvc.ApplicationModels; 

namespace AppModelSample.Conventions 

{ 

public class CustomActionNameAttribute : Attribute, IActionModelConvention 

{ 

private readonly string _actionName; 

public CustomActionMameAttribute(string actionName) 

{ 

_actionName = actionName; 

} 

public void Apply(ActionModel actionModel) 

{ 

// this name will be used by routing 
actionModel.ActionName = _actionName; 

} 

} 

} 

Bu öznitelik HomeControiler bir eylem yöntemine uygulanır: 

// Route: /Home/MyCoolAction 
[CustomActionName("MyCoolAction")] 
public string SomeName() 

{ 

return ControllerContext.ActionDescriptor.ActionName; 

} 

Yöntem adı someName olsa da öznitelik, yöntem adını kullanmanın MVC kuralını geçersiz kılar ve eylem adını 



Örnek; özel yönlendirme kuralı 

Yönlendirmenin nasıl çalıştığını özelleştirmek için bir iAppiicationModeiconvention kullanabilirsiniz. Örneğin, 
aşağıdaki kural, denetleyiciler 1 ad alanlarını rotalarıyla birleştirir ve ad alanındaki . , rotadaki / olacak şekilde 
değiştirir: 










using Microsoft.AspNetCore.Mvc.ApplicationModels; 
using System.Linq; 

namespace AppModelSample.Conventions 

{ 

public class NamespaceRoutingConvention : IApplicationModelConvention 

{ 

public void Apply(ApplicationModel application) 

{ 

foreach (var controller in application.Controllers) 

{ 

var hasAttributeRouteModels = controller.Selectors 

.Any(selector => selector.AttributeRouteModel != null); 

if (!hasAttributeRouteModels 

&& controller.ControllerName.Contains("Namespace")) // affect one controller in this sample 

{ 

// Replace the . in the namespace with a / to create the attribute route 
// Ex: MySite.Admin namespace will correspond to MySite/Admin attribute route 
// Then attach [controller], [action] and optional {id?} token. 

// [Controller] and [action] is replaced with the controller and action 
// name to generate the final template 

controller.Selectors[0].AttributeRouteModel = new AttributeRouteModel() 

{ 

Template = controller.ControllerType.Namespace.Replace(, '/') + 

"/[controller]/[action]/{id?}" 

}; 

} 

} 

// You can continue to put attribute route templates for the controller actions depending on the 
way you want them to behave 
} 

} 

} 


Kural başlangıçta bir seçenek olarak eklenir. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddMvc(options => 

{ 

options.Conventions.Add(new ApplicationDescription("My Application Description")); 
options.Conventions.Add(new NamespaceRoutingConvention()); 

//options.Conventions.Add(new IdsMustBeInRouteParameterModelConvention()); 

}); 

} 



Bu örnek, denetleyicinin adında "namespace" özelliği bulunan öznitelik yönlendirme kullanmayan yollara bu kuralı 
uygular. Aşağıdaki denetleyicide bu kural gösterilmektedir: 






using Microsoft.AspNetCore.Mvc; 

namespace AppModelSample.Controllers 
{ 

public class NamespaceRoutingController : Controller 
{ 

// using NamespaceRoutingConvention 

// route: /AppModelSample/Controllers/NamespaceRouting/Index 
public string Index() 

{ 

return "This demonstrates namespace routing."; 

} 

} 

} 


WebApiCompatShim 'de uygulama modeli kullanımı 

ASP.NET Core MVC, ASP.NET Web API 2 ' den farklı bir kural kümesi kullanır.Özel kuralları kullanarak, bir 
ASP.NET Core MVC uygulamasının davranışını bir Web API uygulaması ile tutarlı olacak şekilde değiştirebilirsiniz. 
Microsoft bu amaçla VVebApiCompatShim 'i özel olarak sevk eder. 


NOTE 

ASP.NET Web API 'sinden geçişhakkında daha fazla bilgi edinin. 


Web API 'SI uyumluluk dolgusu 'nı kullanmak için, paketi projenize eklemeniz ve sonra 
startup'' AdduebApiConventions çağırarak kuralları MVC 'ye eklemeniz gerekir: 

Services.AddMvc().AddWebApiConventions(); 

Dolgu tarafından belirtilen kurallar yalnızca belirli özniteliklerin uygulanmış olduğu uygulamanın bölümlerine 
uygulanır. Aşağıdaki dört öznitelik, hangi denetleyicilerin kendi kurallarını Shim 'in kuralları tarafından 
değiştirildiğini denetlemek için kullanılır: 

• UseVVebApiActionConventionsAttribute 

• UseVVebApiOverioadingAttribute 

• UseVVebApiParameterConventionsAttribute 

• UseVVebApiRoutesAttribute 

Eylem kuralları 

useifliebApiActionConventionsAttribute , HTTP yöntemini adına göre eylemlerle eşlemek için kullanılır (örneğin, Get 
HttpGet eşlenir). Yalnızca öznitelik yönlendirme kullanmayan eylemler için geçerlidir. 

Aşırı Yükleme 

UseWebApiOverloadingAttribute , WebApiOverloadingApplicationModelConvention kuralım uygulamak için kullanılır. Bu 
kural, aday eylemlerini isteğin tüm isteğe bağlı olmayan parametreleri karşılayan olanlarla sınırlayan eylem seçimi 
işlemine bir overloadActionConstraint ekler. 

Parametre kuralları 

UseWebApiParameterConventionsAttribute , WebApiParameterConventionsApplicationModelConvention eylem kuralım 
uygulamak için kullanılır. Bu kural, eylem parametreleri olarak kullanılan basit türlerin varsayılan olarak URI 'den 
bağlandığı, karmaşık türlerin istek gövdesinden bağlandığı bir şekilde belirtir. 


Rotalar 









usewebApiRoutesAttribute , webApiAppiicationModeiconvention denetleyicisi kuralının uygulanıp uygulanmadığını 
denetler. Bu kural etkinleştirildiğinde, rotadaki alanlara yönelik destek eklemek için kullanılır. 

Bir kural kümesine ek olarak, uyumluluk paketi, Web API 'SI tarafından sağlanarak yerine geçen bir 
System.web.Http.ApiController taban sınıfı içerir. Bu, denetleyicilerinizin Web API 'SI için yazılmasını ve 
ApiControiler AS P.N ET Core MVC üzerinde çalıştırılırken tasarlandıkları şekilde çalışmasını sağlar. Daha önce 
listelenen tüm usewebApi* öznitelikleri, temel denetleyici sınıfına uygulanır. ApiControiler ,WebAPI 'sinde 
bulunan özelliklerle uyumlu özellikleri, yöntemleri ve sonuç türlerini kullanıma sunar. 

Uygulamanızı belgelemek için ApiExplorer kullanma 

Uygulama modeli, uygulamanın yapısına çapraz geçiş için kullanılabilecek her düzeyde bir ApiExpiorer özelliği 
sunar. Bu, Svvagger gibi araçları kullanarak Web API 'leriniz için yardım sayfaları oluşturmaküzere kullanılabilir. 
ApiExpiorer özelliği, uygulamanızın modelinin hangi bölümlerinin sunulduğunu belirtmek üzere ayarlanabilir bir 
isvisible özelliğini kullanıma sunar. Bu ayarı, bir kuralı kullanarak yapılandırabilirsiniz: 

using Microsoft.AspNetCore.Mvc.ApplicationModelsj 

namespace AppModelSample.Conventions 
{ 

public class EnableApiExplorerApplicationConvention : IApplicationModelConvention 
{ 

public void Apply(ApplicationModel application) 

{ 

application.ApiExplorer.IsVisible = true; 

} 

} 

} 

Bu yaklaşımı (ve gerekirse ek kuralları) kullanarak uygulamanızın içindeki herhangi bir düzeyde API görünürlüğünü 
etkinleştirebilir veya devre dışı bırakabilirsiniz. 
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Kirk Larkabağı, Rick Anderson, Tom Dykstrave Steve Smith tarafından 

AS P.N ET Core Filtreler , istek işleme ardışık düzeninde belirli aşamalardan önce veya sonra kod 
çalıştırılmasına izin verir. 

Yerleşik Filtreler şunları gibi görevleri işler: 

• Yetkilendirme (kullanıcının yetkili olmadığı kaynaklara erişimi önler). 

• Yanıt önbelleğe alma (istek ardışık düzenini önbelleğe alınmış bir yanıt döndürecek şekilde döndürür). 

Çapraz kesme sorunlarını işlemek için özel filtreler oluşturulabilir.Çapraz kesme sorunlarına örnek olarak 
hata işleme, önbelleğe alma, yapılandırma, yetkilendirme ve günlüğe kaydetme dahildir. Filtreler kodu 
çoğaltmaktan kaçının. Örneğin, bir hata işleme özel durum filtresi hata işlemeyi birleştirebilir. 

Bu belge, görünümler içeren Razor Pages, API denetleyicileri ve denetleyiciler için geçerlidir. 

Örneği (indirme) görüntüleyin veya indirin . 

Filtreler nasıl çalışır? 

Filtreler, bazen Filtre işlem hattıolarak da adlandırılan ASP.NET Core eylemi çağırma işlem hattı\çr\de çalışı 
Filtre işlem hattı çalıştırılacak eylemi ASP.NET Core seçtikten sonra çalışır. 
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Filtre türleri 

Her filtre türü, filtre ardışık düzeninde farklı bir aşamada yürütülür: 













• ilk olarak Yetkilendirme filtreleri çalışır ve kullanıcının istek için yetkilendirilip yetkilendirilmediğini 
tespit etmek için kullanılır. Yetkilendirme filtreleri, istek yetkisiz ise işlem hattı kısa devre dışı. 

• Kaynak filtreleri: 

o Yetkilendirmeden sonra çalıştırın. 

o OnResourceExecuting, filtre işlem hattının geri kalanının önüne kod çalıştırabilir. Örneğin 
0nResourceExecuting , model bağlamadan önce kodu çalıştırabilir, 
o OnResourceExecuted, ardışık düzenin geri kalanı tamamlandıktan sonra kodu çalıştırabilir. 

• Eylem filtreleri , tek bir eylem yöntemi çağrıldıktan hemen önce ve sonra kodu çalıştırabilir. Bir eyleme 
geçirilen bağımsız değişkenleri ve eylemden döndürülen sonucu işlemek için kullanılabilirler. Eylem 
filtreleri Razor Pages desteklenmez. 

• Özel durum filtreleri , yanıt gövdesine hiçbir şey yazılmadan önce oluşan işlenmemiş özel durumlara 
genel ilkeler uygulamak için kullanılır. 

• Sonuç filtreleri, tek tek eylem sonuçlarının yürütülmesinden hemen önce ve sonra kodu çalıştırabilir. 
Bunlar yalnızca eylem yöntemi başarıyla yürütüldüğünde çalışır. Bu değerler, görünüm veya 
biçimlendirici yürütmesinin yürütülmesi gereken mantık için faydalıdır. 

Aşağıdaki diyagramda filtre türlerinin filtre ardışık düzeninde nasıl etkileşimde bulunduğu gösterilmektedir. 
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Result execution 


Uygulama 

Filtreler, farklı arabirim tanımları aracılığıyla hem zaman uyumlu hem de zaman uyumsuz uygulamaları 
destekler. 

Zaman uyumlu filtreler, ardışık düzen aşamasından önce ( on-stage-Executing ) ve sonra kodu çalıştırabilir ( 
on-stage-Executed ). Örneğin, 0nActionExecuting eylem yöntemi çağrılmadan önce çağrılır. 
0nActionExecuted , eylem yöntemi döndüğünde çağrılır. 











public class MySampleActionFilter : IActionFilten 
{ 

public void OnActionExecuting(ActionExecutingContext context) 

{ 

// Do something before the action executes. 

} 

public void OnActionExecuted(ActionExecutedContext context) 

{ 

// Do something after the action executes. 

} 

} 

Zaman uyumsuz filtreler bir 0n-stage-ExecutionAsync yöntemi tanımlar: 

public class SampleAsyncActionFilter : IAsyncActionFilter 
{ 

public async Task OnActionExecutionAsync( 

ActionExecutingContext context, 

ActionExecutionDelegate next) 

{ 

// Do something before the action executes. 

// next() calls the action method. 
var resultContext = await next(); 

// resultContext.Result is set. 

// Do something after the action executes. 

} 

} 

Yukarıdaki kodda SampleAsyncActionFilter , eylem yöntemini yürüten bir ActionExecutionDelegate ( next ) 
sahiptir. 0n-stage-ExecutionAsync yöntemlerinin her biri, filtrenin ardışık düzen aşamasını yürüten bir 
FilterType-ExecutionDelegate alır. 

Birden çok filtre aşaması 

Birden çok filtre aşaması için arabirimler tek bir sınıfta uygulanabilir.Örneğin, ActionFilterAttribute sınıfı 
iActionFiiter , iResuitFilter ve zaman uyumsuz eşdeğerlerini uygular. 

Her ikisini de değil , bir filtre arabiriminin zaman uyumlu veya zaman uyumsuz sürümünü uygulayın. 
Çalışma zamanı öncelikle filtrenin zaman uyumsuz arabirimi uygulayıp uygulamadığını denetler ve bu 
durumda bunu çağırır. Aksi takdirde, zaman uyumlu arabirimin Yöntem (ler) i çağırır.Tek bir sınıfta hem 
zaman uyumsuz hem de zaman uyumlu arabirimler uygulanmışsa, yalnızca zaman uyumsuz yöntem çağrılır. 
ActionFilterAttribute gibi soyut sınıflar kullanılırken, yalnızca zaman uyumlu yöntemleri veya her bir filtre 
türü için zaman uyumsuz yöntemi geçersiz kılın. 

Yerleşik filtre öznitelikleri 

ASP.NET Core, alt sınıflanmış ve özelleştirilebilen yerleşik öznitelik tabanlı filtreler içerir.Örneğin, aşağıdaki 
sonuç filtresi yanıta bir üst bilgi ekler: 








public class AddHeaderAttribute : ResultFilterAttribute 
{ 

private readonly string _name; 
private readonly string _value; 

public AddHeaderAttribute(string name, string value) 

{ 

_name = name; 

_value = value; 

> 

public override void OnResultExecuting(ResultExecutingContext context) 

{ 

context.HttpContext.Response.Headers.Add( _name, new string[] { _value }); 
base.OnResultExecuting(context); 

} 

} 

Öznitelikler, önceki örnekte gösterildiği gibi, filtrelerin bağımsız değişkenleri kabul etmesine izin verir. 
AddHeaderAttribute bir denetleyiciye veya eylem yöntemine uygulayın ve HTTP üstbilgisinin adını ve 
değerini belirtin: 

[AddHeader("Author", "loe Smith")] 

public class SampleController : Controller 

{ 

public IActionResult Index() 

{ 

return Content("Examine the headers using the F12 developer tools."); 

} 

[ShortCircuitingResourceFilter] 
public IActionResult SomeResource() 

{ 

return Content("Successful access to resource - header is set."); 

} 

Filtre arabirimlerinden birkaçı, özel uygulamalar için temel sınıflar olarak kullanılabilecek karşılık gelen 
özniteliklere sahiptir. 

Filtre öznitelikleri: 

• ActionFilterAttribute 

• ExceptionFilterAttribute 

• ResultFilterAttribute 

• FormatFilterAttribute 

• ServiceFilterAttribute 

• TypeFilterAttribute 

Kapsamları ve yürütme sırasını filtrele 

Üç kapsamından birindeki işlem hattına bir filtre eklenebilir: 

• Bir eylem üzerinde bir öznitelik kullanma. 

• Bir denetleyicide bir özniteliği kullanma. 

• Aşağıdaki kodda gösterildiği gibi tüm denetleyiciler ve eylemler için genel olarak: 





public void ConfigureSer'vices(ISer'viceCollection Services) 

{ 

Services.AddMvc(options => 

{ 

options.Filters.Add(new AddHeaderAttribute("GlobalAddHeader ", 

"Result filter added to MvcOptions.Filters")); // An instance 

options.Filters.Add(typeof(MySampleActionFilter)); // By type 

options.Filters.Add(new SampleGlobalActionFilter()); // An instance 

}).SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


Yukarıdaki kod, Mvcoptions. Filters koleksiyonunu kullanarak genel olarak üç filtre ekler. 

Varsayılan yürütme sırası 

işlem hattının belirli bir aşamasına ilişkin birden çok filtre olduğunda, kapsam varsayılan filtre yürütme 
sırasını belirler. Genel filtreler kapsayan sınıf filtreleri, bu da kapsayan Yöntem filtreleri. 

Filtre iç içe geçme sonucu olarak, filtrenin kodu, önceki kodun ters sırasına göre çalışır. Filtre sırası: 

• Genel filtrelerin önceki kodu. 

o Denetleyici filtrelerinden önceki kod. 

o Eylem yöntemi filtrelerinden önceki kod. 
o Eylem yöntemi filtrelerinden sonraki kod. 
o Denetleyici filtrelerinden sonraki kod. 

• Genel filtrelerin sonraki kodu. 

Zaman uyumlu eylem filtreleri için filtre yöntemlerinin çağrıldığı sırayı gösteren aşağıdaki örnek. 


SEQUENCE 

FİLTRE KAPSAMI 

FİLTER YÖNTEMİ 

1 

Global 

OnActionExecuting 

2 

Denetleyici 

OnActionExecuting 

3 

Yöntem 

OnActionExecuting 

4 

Yöntem 

OnActionExecuted 

5 

Denetleyici 

OnActionExecuted 

6 

Global 

OnActionExecuted 


Bu sıra şunları gösterir: 

• Yöntem filtresi, denetleyici filtresi içinde iç içe geçmiş. 

• Denetleyici filtresi, genel filtrenin içinde iç içe geçmiş. 

Denetleyici ve Razor sayfa düzeyi filtreleri 

Controller temel sınıfından devralan her denetleyici Controller. OnActionExecuting, Controller. 
OnActionExecutionAsyncve controller. onactionyürütülmüş 0 nActionExecuted yöntemlerini içerir. Bu 
Yöntemler: 

• Belirli bir eylem için çalışan filtreleri sarın. 

• 0nActionExecııting , eylemin filtrelerinden herhangi birinin önüne çağırılır. 

• 0nActionExecuted tüm eylem filtrelerinden sonra çağrılır. 











• 0nActionExecutionAsync , eylemin filtrelerinden herhangi birinin önüne çağırılır. next sonra filtre içindeki 
kod eylem yönteminden sonra çalışır. 

Örneğin, indirme örneğinde MySampleActionFilter , başlangıçta genel olarak uygulanır. 

TestController : 

• FilterTest2 eyleme SampleActionFilterAttribute ( [SampleActionFilter] ) uygular. 

• OnActionExecuting ve OnActionExecuted geçersiz kılar. 


public class TestController : Controller 

{ 

[SampleActionFilter] 

public IActionResult FilterTest2() 

{ 

return Content($"From FilterTest2"); 

} 

public override void OnActionExecuting(ActionExecutingContext context) 

{ 

// Do something before the action executes. 
base.OnActionExecuting(context); 

} 

public override void OnActionExecuted(ActionExecutedContext context) 

{ 

// Do something after the action executes. 
base.OnActionExecuted(context); 

} 


https://localhost:500i/Test/FiiterTest2 gitme aşağıdaki kodu çalıştırır: 

• TestController.OnActionExecuting 

o MySampleActionFilter.OnActionExecuting 

o SampleActionFilterAttribute.OnActionExecuting 
o TestController.FilterTest2 
o SampleActionFilterAttribute.OnActionExecuted 
o MySampleActionFilter.OnActionExecuted 

• TestController.OnActionExecuted 

Razor Pages için bkz. filtre yöntemlerini geçersiz kılarak Razor sayfası filtrelerini uygulama. 

Varsayılan sırayı geçersiz kılma 

Varsayılan yürütme sırası lOrderedFilteruygulayarak geçersiz kılınabilir. ıorderedFiiter , yürütme sırasını 
belirlemede kapsama göre öncelik alan Order özelliğini kullanıma sunar. Daha düşük bir order değerine 
sahip bir filtre: 

• Daha yüksek bir order bir filtrenin önüne kodundan önce kodu çalıştırır. 

• Daha yüksek order değerine sahip bir filtrenin sonrasında koddan sonra çalışır. 

order özelliği bir Oluşturucu parametresiyle ayarlanabilir: 

[MyFilter(Name = "Controller Level Attribute", Order=l)] 


Yukarıdaki örnekte gösterilen 3 eylem filtresini göz önünde bulundurun. Denetleyicinin ve genel filtrelerin 
order özelliği sırasıyla 1 ve 2 1 ye ayarlandıysa, yürütme sırası tersine çevrilir. 


















SEQUENCE 

FİLTRE KAPSAMI 

ORDER ÖZELLİĞİ 

FILTER YÖNTEMİ 

1 

Yöntem 

0 

OnActionExecuting 

2 

Denetleyici 

1 

OnActionExecuting 

3 

Global 

2 

OnActionExecuting 

4 

Global 

2 

OnActionExecuted 

5 

Denetleyici 

1 

OnActionExecuted 

6 

Yöntem 

0 

OnActionExecuted 


önder özelliği filtrelerin çalıştırıldığı sırayı belirlerken kapsamı geçersiz kılar. Filtreler sırasıyla sıraya göre 
sıralanır, ardından kapsam bölmek için kullanılır. Yerleşik filtrelerin tümü ıorderedFiiter uygular ve 
varsayılan order değerini O olarak ayarlar. Yerleşik filtreler için, order sıfır olmayan bir değere 
ayarlanmadığı takdirde kapsam sıralamayı belirler. 

İptal ve kısa devre dışı 

Filtre işlem hattı, filtre yöntemine sunulan ResourceExecutingContext parametresindeki Result özelliği 
ayarlanarak kısa devre dışı olabilir. Örneğin, aşağıdaki kaynak filtresi, ardışık düzenin geri kalanının 
yürütülmesini engeller: 

public class ShortCircuitingResourceFilterAttribute : Attribute, IResourceFilter 
{ 

public void OnResourceExecuting(ResourceExecutingContext context) 

{ 

context.Result = new ContentResult() 

{ 

Content = "Resource unavailable - header not set." 

}; 

} 

public void OnResourceExecuted(ResourceExecutedContext context) 

{ 

} 

} 

Aşağıdaki kodda, hem ShortCircuitingResourceFilter hem de AddHeader filtresi SomeResource Action 
metodunu hedefleyin. ShortCircuitingResourceFilter : 

• Önce bir kaynak filtresi olduğundan ve AddHeader bir eylem filtresi olduğundan, önce çalışır. 

• Kısa süreli işlem hattının geri kalanı. 

Bu nedenle AddHeader filtresi SomeResource eylemi için hiçbir şekilde çalışmamayacaktır. Her iki filtre de 
eylem yöntemi düzeyinde uygulanırsa, ShortCircuitingResourceFilter ilk kez çalıştırıldıysa bu davranış aynı 
olur. ShortCircuitingResourceFilter , filtre türü veya Order özelliğinin açık kullanımı nedeniyle önce çalışır. 
























[AddHeaden("Authon", "loe Smith")] 

public class SampleController : Controller 

{ 

public IActionResult Index() 

{ 

return Content("Examine the headers using the F12 developer tools."); 

} 

[ShortCircuitingResourceFilter] 
public IActionResult SomeResource() 

{ 

return Content("Successful access to resource - header is set."); 

} 


Bağımlılık ekleme 

Filtreler türe veya örneğe göre eklenebilir. Bir örnek eklenirse, bu örnek her istek için kullanılır. Bir tür 
eklenirse, türü etkinleştirilmiş olur. Tür etkinleştirilmiş bir filtre şu anlama gelir: 

• Her istek için bir örnek oluşturulur. 

• Herhangi bir Oluşturucu bağımlılığı bağımlılık ekleme (dı) tarafından doldurulur. 

Öznitelik olarak uygulanan ve doğrudan denetleyici sınıflarına veya eylem yöntemlerine eklenen filtreler 
bağımlılık ekleme (dı) tarafından sağlanmış Oluşturucu bağımlılıklarına sahip olamaz. Oluşturucu 
bağımlılıkları şu nedenle şu nedenle sağlanamaz: 

• Özniteliklerin, uygulandıkları yerlerde, Oluşturucu parametreleri sağlanmalıdır. 

• Bu, özniteliklerin nasıl çalıştığı konusunda bir kısıtlamadır. 

Aşağıdaki filtreler, dı tarafından belirtilen Oluşturucu bağımlılıklarını destekler: 

• ServiceFilterAttribute 

• TypeFilterAttribute 

• IFİlterFactory özniteliğe uygulandı. 

Önceki filtreler bir denetleyiciye veya eylem yöntemine uygulanabilir: 

Günlükçüler, Dİ 'den alınabilir.Ancak, yalnızca günlüğe kaydetme amacıyla filtre oluşturmaktan ve 
kullanmaktan kaçının. Yerleşik çerçeve günlüğü genellikle günlüğe kaydetme için gerekenleri sağlar. 
Filtrelere günlük eklendi: 

• , İş etki alanı kaygılarını veya filtreye özgü davranışları odaklamalıdır. 

• Eylemleri veya diğer çerçeve olaylarını günlüğe içermemelidir . Yerleşik filtreler günlük eylemleri ve 
çerçeve olayları. 

ServiceFilterAttribute 

Hizmet filtresi uygulama türleri configureServices kaydedilir. ServiceFilterAttribute, bir filtrenin bir örneğini 
dı öğesinden alır. 


Aşağıdaki kod AddHeaderResultServiceFilter gösterir: 




public class AddHeaderResultServiceFilter : IResultFilter 

{ 

private ILogger _logger; 

public AddHeaderResultServiceFilter(ILoggerFactory loggerFactory) 

{ 

_logger = loggerFactory. CreateLogger<AddFleaderResultServiceFilter>(); 

} 

public void OnResultExecuting(ResultExecutingContext context) 

{ 

var headerName = "OnResultExecuting"; 
context. FlttpContext. Response. Fleaders. Add ( 

headerName, new string[] { "ResultExecutingSuccessfully" }); 
_logger. LogInformation("Fleader added: {HeaderName }", headerName); 

} 

public void OnResultExecuted(ResultExecutedContext context) 

{ 

// Can't add to headers here because response has started. 

} 


Aşağıdaki kodda, AddHeaderResultServiceFilter dı kapsayıcısına eklenir: 

public void ConfigureServices(IServiceCollection Services) 

{ 

// Add service filters. 

Services.AddScoped<AddHeaderResultServiceFilter>(); 

Services.AddScoped<SampleActionFilterAttribute>(); 

Services.AddMvc(options => 

{ 

options.Filters.Add(new AddHeaderAttribute("GlobalAddHeader ", 

"Result filter added to MvcOptions.Filters")); // An instance 

options.Filters.Add(typeof(MySampleActionFilter)); // By type 

options.Filters.Add(new SampleGlobalActionFilter()); // An instance 

}).SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

} 

Aşağıdaki kodda, serviceFilter özniteliği dı öğesinden AddHeaderResultServiceFilter filtrenin bir örneğini 
alır: 


[ServiceFilter(typeof(AddHeaderResultServiceFilter))] 
public IActionResult Index() 

{ 

return View(); 

} 

serviceFilterAttribute kullanırken, Servicefilterattribute. ısyeniden kullanılabilirolarak ayarlanıyor: 

• Filtre örneğinin, içinde oluşturulduğu istek kapsamının dışında yeniden kullanılabilir olabileceğini 
gösteren bir ipucu sağlar. AS P.N ET Core çalışma zamanı garanti etmez: 

o Filtrenin tek bir örneğinin oluşturulması gerekir, 
o Filtre, sonraki bir noktada dı kapsayıcısından yeniden istenmeyecek. 

• Tek bir yaşam süresine sahip hizmetlere bağımlı olan bir filtreyle kullanılmamalıdır. 

ServiceFilterAttribute IFİlterFactoryuygular. iFilterFactory , bir IFİlterMetadata örneği oluşturmak için 
Createlnstance yöntemini kullanıma sunar. Createinstance , belirtilen türü Dİ 'dan yükler. 








TypeFilterAttribute 

TypeFilterAttribute ServiceFilterAttributebenzerdir, ancak türü doğrudan dı kapsayıcısından çözümlenmez. 
Microsoft.Extensions.Dependencylnjection.ObjectFactory kullanarak türü başlatır. 

TypeFilterAttribute türler doğrudan dı kapsayıcısından çözümlenmediğinden: 

• TypeFilterAttribute kullanılarak başvurulan türlerin dı kapsayıcısına kaydedilmesi gerekmez. Bunların 
bağımlılıkları, dı kapsayıcısı tarafından yerine getirilir. 

• TypeFilterAttribute , isteğe bağlı olarak tür için Oluşturucu bağımsız değişkenlerini kabul edebilir. 

TypeFilterAttribute kullanırken Typefilterattribute. iyeniden kullanılabilirolarak ayarlanıyor: 

• Filtre örneğinin, içinde oluşturulduğu istek kapsamının dışında yeniden kullanılabilir olabileceği ipucu 
sağlar. AS P.N ET Core çalışma zamanı, filtrenin tek bir örneğinin oluşturulacağı garantisi vermez. 

• Tek bir yaşam süresine sahip hizmetlere bağımlı olan bir filtreyle kullanılmamalıdır. 

Aşağıdaki örnek TypeFilterAttribute kullanarak bir türe bağımsız değişkenlerin nasıl geçirileceğini gösterir 

[TypeFilter(typeof(LogConstantFilten), 

Arguments = new object[] { "Method 'Hi' called" })] 
public IActionResult Hi(string name) 

{ 

return Content($"Hi {name}"); 

} 


public class LogConstantFilter : IActionFilten 
{ 

private readonly string _value; 

private readonly ILogger<LogConstantFilter> _logger; 

public LogConstantFilter(string value, ILogger<LogConstantFilter> logger) 
{ 

_logger = logger; 

_value = value; 

} 

public void OnActionExecuting(ActionExecutingContext context) 

{ 

_logger.LogInformation(_value); 

} 

public void OnActionExecuted(ActionExecutedContext context) 

{ } 

} 


Yetkilendirme filtreleri 

Yetkilendirme filtreleri: 

• , Filtre ardışık düzeninde ilk filtrelerin çalıştırılmasıyla sonuçlanır. 

• Eylem yöntemlerine erişimi denetleyin. 

• Bir Before yöntemi, ancak After yönteminden hiçbiri. 

Özel Yetkilendirme filtreleri özel bir yetkilendirme çerçevesi gerektirir. Özel bir filtre yazmak için 
yetkilendirme ilkelerini yapılandırmayı veya özel bir yetkilendirme ilkesi yazmayı tercih edin. Yerleşik 
yetkilendirme filtresi: 


• Yetkilendirme sistemini çağırır. 








• istekleri yetkilendirmez. 

Yetkilendirme filtreleri içinde özel durumlar atamayın: 

• Özel durum işlenmeyecektir. 

• Özel durum filtreleri özel durumu işleymeyecektir. 

Bir yetkilendirme filtresinde özel durum oluştuğunda bir sınama vermeyi düşünün. 
Yetkilendirmehakkında daha fazla bilgi edinin. 

Kaynak filtreleri 

Kaynak filtreleri: 

• IResourceFilter ya da lAsyncResourceFilter arabirimini uygulayın. 

• Yürütme, filtre işlem hattının çoğunu sarmalar. 

• Kaynak filtrelerinden önce yalnızca Yetkilendirme filtreleri çalışır. 

Kaynak filtreleri, işlem hattının büyük bir yanındaki kısa devre için faydalıdır.Örneğin, bir önbelleğe alma 
filtresi, bir önbellek isabetinden ardışık düzen geri kalanından kaçınabilir. 

Kaynak filtresi örnekleri: 

• Daha önce gösterilen kısa devre dışı kaynak filtresi . 

• Disableformvaluemodelbindingattribute: 

o Model bağlamanın form verilerine erişimini engeller. 

o Form verilerinin belleğe okunmasını engellemek için büyük dosya yüklemeleri için kullanılır. 

Eylem filtreleri 

IMPORTANT 

Eylem filtreleri Razor Pages için uygulanmaz. Razor Pages I PageFilter ve lAsyncPageFilter destekler. Daha fazla bilgi 
için bkz. Razor Pages İçin filtre yöntemleri. 

Eylem filtreleri: 

• lActionFilter ya da lAsyncActionFiiter arabirimini uygulayın. 

• Yürütmesinin, eylem yöntemlerinin yürütülmesi çevreler. 

Aşağıdaki kod bir örnek eylem filtresi gösterir: 

public class MySampleActionFilter : lActionFilter 
{ 

public void OnActionExecuting(ActionExecutingContext context) 

{ 

// Do something before the action executes. 

} 

public void OnActionExecuted(ActionExecutedContext context) 

{ 

// Do something after the action executes. 

} 

} 







ActionExecutingContext aşağıdaki özellikleri sağlar: 

• ActionArguments-bir eylem yöntemine yönelik girişlerin okunmalarını sağlar. 

• Controller-denetleyici örneğinin işlenmesine izin vermez. 

• Result-eylem yönteminin ve sonraki eylem filtrelerinin Resuit kısa devre dışı yürütmesi. 

Eylem yönteminde özel durum oluşturma: 

• Sonraki filtrelerin çalıştırılmasını önler. 

• Resuit ayarının aksine, başarılı bir sonuç yerine başarısızlık olarak değerlendirilir. 
ActionExecutedContext controiier ve Resuit ek olarak aşağıdaki özellikleri sağlar: 

• Canceled-eylem yürütmesi başka bir filtre tarafından kabul edilse true. 

• Exception-eylem veya daha önce çalıştırılan eylem filtresi bir özel durum oluşturdu, null değil. Bu 
özellik null olarak ayarlanıyor: 

o Özel durumu etkin bir şekilde işler. 

o Resuit , eylem yönteminden döndürülmüş gibi yürütülür. 

Bir iAsyncActionFiiter için ActionExecutionDelegateçağrısı: 

• Sonraki eylem filtrelerini ve eylem yöntemini yürütür. 

• ActionExecutedContext döndürür. 

Kısa devre dışı, bir sonuç örneğine Microsoft.AspNetCore.Mvc.Filters.ActionExecutingContext.Result atayın 
ve next çağırmayın ( ActionExecutionDelegate ). 

Framevvork, alt sınıflı olabilecek bir soyut ActionFilterAttribute sağlar. 

0nActionExecuting eylem filtresi şu şekilde kullanılabilir: 

• Model durumunu doğrulayın. 

• Durum geçersizse bir hata döndürür. 

public class ValidateModelAttribute : ActionFilterAttribute 
{ 

public override void OnActionExecuting(ActionExecutingContext context) 

{ 

if (!context.ModelState.IsValid) 

{ 

context.Resuit = new BadRequestObjectResult(context.ModelState); 

} 

} 

0nActionExecuted yöntemi eylem yönteminden sonra çalışır: 

• Ve Resuit özelliği aracılığıyla eylemin sonuçlarını görebilir ve değiştirebilir. 

• eylem yürütmesi başka bir filtre tarafından kabul edilse, Canceled true olarak ayarlanır. 

• eylem veya sonraki eylem filtresi bir özel durum harekete geçirdi, Exception null olmayan bir değere 
ayarlanır. Exception null olarak ayarlanıyor: 

o Bir özel durumu etkin bir şekilde işler. 

o ActionExecutedContext.Resuit , normal olarak eylem yönteminden döndürülmüş gibi yürütülür. 














public class ValidateModelAttribute : ActionFilterAttribute 
{ 

public override void OnActionExecuting(ActionExecutingContext context) 

{ 

if (!context.ModelState.IsValid) 

{ 

context.Result = new BadRequestObjectResult(context.ModelState); 

} 

} 


public override void OnActionExecuted(ActionExecutedContext context) 
{ 

var result = context.Result; 

// Do something with Result. 
if (context.Canceled == true) 

{ 

// Action execution was short-circuited by another filter. 

} 

if(context.Exception != null) 

{ 

// Exception thrown by action or action filter. 

// Set to null to handle the exception. 
context.Exception = null; 

} 

base.OnActionExecuted(context); 

} 

} 


Özel durum filtreleri 

Özel durum filtreleri: 

• IException Fi İter veya IAsyncExceptionFilteruygulayın. 

• , Yaygın hata işleme ilkelerini uygulamak için kullanılabilir. 

Aşağıdaki örnek özel durum filtresi, uygulama geliştirmede olduğunda oluşan özel durumlar hakkındaki 
ayrıntıları görüntülemek için özel bir hata görünümü kullanır: 



public class CustomExceptionFilter : IExceptionFilter 
{ 

pnivate readonly IHostingEnvironment _hostingEnvironment; 
pnivate readonly IModelMetadataProvider _modelMetadataProvider; 

public CustomExceptionFilter( 

IHostingEnvironment hostingEnvironment , 

IModelMetadataProvider modelMetadataProvider) 

{ 

_hostingEnvironment = hostingEnvironment; 

_modelMetadataProvider = modelMetadataProvider; 

} 

public void OnException(ExceptionContext context) 

{ 

if (!_hostingEnvironment.IsDevelopment()) 

{ 

return; 

} 

var result = new ViewResult {ViewName = "CustomError"}; 
result.ViewData = new ViewDataDictionary(_modelMetadataProvider, 

context.ModelState); 

result.ViewData.Add("Exception", context.Exception); 

// TODO: Pass additional detailed data via ViewData 
context.Result = result; 

} 

} 

Özel durum filtreleri: 

• Etkinlikden önceki ve sonraki olaylar yok. 

• OnException veya OnExceptionAsyncuygulayın. 

• Razor sayfası veya denetleyici oluşturma, model bağlama, eylem filtreleri veya eylem yöntemlerinde 
oluşan işlenmemiş özel durumları işleyin. 

• Kaynak filtrelerinde, sonuç filtrelerinde veya MVC sonuç yürütülürken oluşan özel durumları 
yakalamayın . 

Bir özel durumu işlemek için ExceptionHandled özelliğini true veya bir yanıt yazın. Bu, özel durumun 
yayılmasını engeller. Özel durum filtresi bir özel durumu "başarılı" olarak açamaz. Yalnızca bir eylem filtresi 
bunu yapabilir. 

Özel durum filtreleri: 

• Eylemler içinde oluşan özel durumları yakalamaya uygundur. 

• , Hata işleme ara yazılımı olarak esnek değildir. 

Özel durum işleme için ara yazılımı tercih edin. Yalnızca hata işlemenin hangi eylem yöntemine göre farklılık 
gösteren özel durum filtrelerini kullanın. Örneğin, bir uygulama hem API uç noktaları hem de 
görünümler/HTML için eylem yöntemlerine sahip olabilir. API uç noktaları, hata bilgilerini JSON olarak 
döndürebilir, ancak görünüm tabanlı eylemler bir hata sayfasını HTML olarak döndürebilir. 

Sonuç filtreleri 

Sonuç filtreleri: 

• Arabirim uygulama: 

o I Resu ItF i İter veya lAsyncResultFilter 
o IAIwaysRunResultFilter veya IAsyncAlwaysRunResultFilter 

• Yürütmesi, eylem sonuçlarının yürütülmesini çevreler. 







I ResultFilter ve lasyncresultfilter 

Aşağıdaki kod, bir HTTP üst bilgisi ekleyen bir sonuç filtresi gösterir: 

public class AddHeaderResultServiceFilter : IResultFilter 
{ 

private ILogger _logger; 

public AddHeaderResultServiceFilter(ILoggerFactory loggerFactory) 

{ 

_logger = loggerFactory .Createl_ogger<AddHeaderResultServiceFilter>(); 

} 

public void OnResultExecuting(ResultExecutingContext context) 

{ 

var headerName = "OnResultExecuting"; 
context.HttpContext.Response.Headers.Add( 

headerName, new string[] { "ResultExecutingSuccessfully" }); 
_logger.LogInformation("Header added: {HeaderName}", headerName); 

} 

public void OnResultExecuted(ResultExecutedContext context) 

{ 

// Can't add to headers here because response has started. 

} 


Yürütülen sonuç türü eyleme göre değişir. Bir görünüm döndüren bir eylem, yürütülen VievvResult bir 
parçası olarak tüm Razor işlemlerini içerir. Bir API yöntemi, sonucun yürütülmesinin bir parçası olarak bazı 
serileştirme işlemleri gerçekleştirebilir. Eylem sonuçlarıhakkında daha fazla bilgi edinin. 

Sonuç filtreleri yalnızca bir eylem veya eylem filtresi bir eylem sonucu üretirse yürütülür.Şu durumlarda 
sonuç filtreleri yürütülmez: 

• Bir yetkilendirme filtresi veya kaynak filtresi, işlem hattı için kısa süreli olarak devre dışı. 

• Bir özel durum filtresi, bir eylem sonucu üreterek özel durumu işler. 

Microsoft.AspNetCore.Mvc.Filters.lResultFilter.OnResultExecuting yöntemi, eylem sonucunun ve sonraki 
sonuç filtrelerinin true Microsoft.AspNetCore.Mvc.Filters.ResultExecutingContext.Cancel ayarlanarak kısa 
devre yürütülmesine neden olabilir. Boş bir yanıt oluşturmamaya kaçınmak için kısa devre dışı bırakıldığında 
yanıt nesnesine yazın. IResultFilter.0nResuitExecuting bir özel durum oluşturma şu şekilde yapılır: 

• Eylem sonucunun ve sonraki filtrelerin yürütülmesini önleyin. 

• Başarılı bir sonuç yerine hata olarak kabul edilir. 


Microsoft.AspNetCore.Mvc.Filters.lResultFilter.OnResultExecuted yöntemi çalıştırıldığında, yanıt istemciye 
zaten gönderilir. Yanıt istemciye zaten gönderildiyse, daha fazla değiştirilemez. 


ResuitExecutedContext.Canceled , eylem sonucu yürütmesi başka bir filtre tarafından kabul edilen kısa devre 
ise true olarak ayarlanır. 


eylem sonucu veya sonraki sonuç filtresi bir özel durum harekete geçirdi, ResuitExecutedContext.Exception 
null olmayan bir değere ayarlanır. Exception null olarak ayarlanması, bir özel durumu etkili bir şekilde işler 
ve özel durumun, ardışık düzendeki AS P.N ET Core daha sonra yeniden oluşturulmasını önler. Bir sonuç 
filtresinde özel durum işlenirken yanıta veri yazmanın güvenilir bir yolu yoktur. Bir eylem sonucu bir özel 
durum oluşturduğunda üstbilgiler istemciye temizleniyorsa, hata kodu göndermek için güvenilir bir 
mekanizma yoktur. 


Bir lAsyncResultFilteriçin, ResultExecutionDelegate bir await next çağrısı, sonraki sonuç filtrelerini ve 
eylem sonucunu yürütür. Kısa devre dışı, ResultExecutingContext. Cancel true ve ResuitExecutionDeiegate 
çağırmayın: 




















public class MyAsyncResponseFilter : IAsyncResultFilter 
{ 

public async Task OnResultExecutionAsync(ResultExecutingContext context, 

ResultExecutionDelegate next) 

{ 

if (!(context.Result is EmptyResult)) 

{ 

await next(); 

} 

else 

{ 

context.Cancel = true; 

} 

} 

} 

Framevvork, alt sınıflı olabilecek bir soyut ResuitFilterAttribute sağlar. Daha önce gösterilen 
Addheaderattribute sınıfı bir sonuç Filtresi özniteliği örneğidir. 

lalvvaysrunresultfilter ve lasyncah/vaysrunresultfilter 

IAIwaysRunResultFilter ve IAsyncAlwaysRunResultFilter arabirimleri, tüm eylem sonuçları için çalışan bir 
IResultFilter uygulamasını bildirir. Bu, tarafından oluşturulan eylem sonuçlarını içerir: 

• Kısa devre olan Yetkilendirme filtreleri ve kaynak filtreleri. 

• Özel durum filtreleri. 

Örneğin, aşağıdaki filtre her zaman çalışır ve içerik anlaşması başarısız olduğunda 422 olmayan bir varhk 
durum kodu ile bir eylem sonucu (ObjectResult) ayarlar: 

public class UnprocessableResultFilter : Attribute, IAlwaysRunResultFilter 
{ 

public void OnResultExecuting(ResultExecutingContext context) 

{ 

if (context.Result is StatusCodeResult statusCodeResult && 
statusCodeResult.StatusCode == 415) 

{ 

context.Result = new ObjectResult("Can't process thisl") 

{ 

StatusCode = 422, 

} 

} 

public void OnResultExecuted(ResultExecutedContext context) 

{ 

} 

} 


IFilterFactory 

IFİIterFactory IFİlterMetadatauygular. Bu nedenle, bir IFilterFactory örneği, filtre ardışık düzeninde 
herhangi bir yerde iFilterMetadata bir örnek olarak kullanılabilir. Çalışma zamanı filtreyi çağırmayı 
hazırlarken, bir IFilterFactory dönüştürmeyi dener. Bu atama başarılı olursa, çağrılan iFilterMetadata 
örneğini oluşturmak için Createlnstance yöntemi çağırılır. Bu, tam filtre işlem hattının uygulama 
başladığında açıkça ayarlanması gerektiğinden esnek bir tasarım sağlar. 

IFilterFactory , filtre oluşturmaya yönelik başka bir yaklaşım olarak özel öznitelik uygulamaları kullanılarak 
uygulanabilir: 










public class AddHeaderl/JithFactoryAttribute : Attribute, IFilterFactory 
{ 

// Implement IFilterFactory 

public IFilterMetadata CreateInstance(IServiceProvider serviceProvider) 
{ 

return new InternalAddHeaderFilterO; 

} 

private class InternalAddHeaderFilter : IResultFilter 
{ 

public void OnResultExecuting(ResultExecutingContext context) 

{ 

context. HttpContext. Response. Fleaders. Add ( 

"Internal", new string[] { "My header" }); 

} 

public void OnResultExecuted(ResultExecutedContext context) 

{ 

} 

} 

public bool IsReusable 
{ 

get 

{ 

return false; 

} 

} 


Önceki kod, indirme örneğiçal iştirılarak test edilebilir: 

• F12 geliştirici araçlarını çağırın. 

• https://test-cors.org sayfasına gidin. 

F12 geliştirici araçları, örnek kod tarafından eklenen aşağıdaki yanıt üstbilgilerini görüntüler: 

• Yazar: ioe smith 

• globaladdheader: Result filter added to MvcOptions.Filters 

• İç: My header 

Yukarıdaki kod, iç: My header yanıt üst bilgisini oluşturur. 

Öznitelik üzerinde IFilterFactory uygulandı 

IFilterFactory uygulayan filtreler şu filtreler için yararlıdır: 

• Parametre geçirme gerekmez. 

• Dİ tarafından doldurulması gereken Oluşturucu bağımlılıkları vardır. 

TypeFilterAttribute IFİlterFactoryuygular. IFilterFactory , bir IFilterMetadata örneği oluşturmak için 
Createlnstance yöntemini kullanıma sunar. Createinstance , belirtilen türü hizmetler kapsayıcısından (Dİ) 
yükler. 









public class SampleActionFilterAttribute : TypeFilterAttribute 

{ 

public SampleActionFilterAttribute() :base(typeof (SampleActionFilterlmpl)) 

{ 

} 

private class SampleActionFilterlmpl : IActionFilter 

{ 

private readonly ILogger _logger; 

public SampleActionFilterImpl(ILoggerFactory loggerFactory) 

{ 

_logger = loggerFactory.CreateLogger<SampleActionFilterAttribute>(); 

} 

public void OnActionExecuting(ActionExecutingContext context) 

{ 

_logger.LogInformation("Business action starting... 

// perform some business logic work 

} 

public void OnActionExecuted(ActionExecutedContext context) 

{ 

// perform some business logic work 

_logger.LogInformation("Business action completed."); 

} 

} 

} 

Aşağıdaki kodda [SampleActionFilter] uygulamak için üç yaklaşım gösterilmektedir: 

[SampleActionFilter] 

public IActionResult FilterTest() 

{ 

return Content($"From FilterTest"); 

} 

[TypeFilter(typeof(SampleActionFilterAttribute))] 
public IActionResult TypeFilterTest() 

{ 

return Content($"From ServiceFilterTest"); 

} 

// ServiceFilter must be registered in ConfigureServices or 

// System.InvalidOperationException: No service for type '<filter>' has been registered. 

// Is thrown. 

[ServiceFilter(typeof(SampleActionFilterAttribute))] 
public IActionResult ServiceFilterTest() 

{ 

return Content($"From ServiceFilterTest"); 

} 

Yukarıdaki kodda, yöntemi [SampleActionFilter] olarak dekorasyon, SampleActionFilter uygulamak için 
tercih edilen yaklaşımdır. 

Filtre ardışık düzeninde ara yazılım kullanma 

Kaynak filtreleri, işlem hattında daha sonra gelen her şeyin yürütülmesini çevreleyecek olan Ara yazılım gibi 
çalışır. Ancak filtreler, ASP.N ET Core çalışma zamanının bir parçası olan ara yazılımlar dışında farklılık 
gösterir, bu da ASP.NET Core bağlamına ve yapılarına erişime sahip oldukları anlamına gelir. 

Ara yazılımı bir filtre olarak kullanmak için, filtre ardışık düzenine eklenecek olan ara yazılımı belirten 








configune yöntemi ile bir tür oluşturun. Aşağıdaki örnek, bir istek için geçerli kültürü oluşturmak üzere 
yerelleştirme ara yazılımını kullanır: 

public class LocalizationPipeline 

{ 

public void Configure(IApplicationBuilder applicationBuilder) 

{ 

var supportedCultures = new[] 

{ 

new CultureInfo("en-US "), 
new CultureInfo("fr") 

}J 

var options = new RequestLocalizationOptions 

{ 

DefaultRequestCulture = new RequestCulture(culture: "en-US", 

uiCulture: "en-US"), 

SupportedCultures = supportedCultures, 

SupportedUICultures = supportedCultures 

}; 

options.RequestCultureProviders = new[] 

{ new RouteDataRequestCultureProvider() { Options = options } }; 

applicationBuilder.UseRequestLocalization(options); 

} 

} 


Ara yazılımı çalıştırmak için MiddlevvareFilterAttribute kullanın: 

[Route("(culture}/[controller]/[action]")] 

[MiddlewareFilter(typeof(LocalizationPipeline))] 
public IActionResult CultureFromRouteData() 

{ 

return Content($"CurrentCulture:{CultureInfo.CurrentCulture.Name}," 
+ $"CurrentUICulture:{CultureInfo.CurrentUICulture.Name}"); 

} 


Ara yazılım filtreleri, filtre işlem hattının aynı aşamasında, model bağlamadan önce ve işlem hattının geri 
kalanı ile kaynak filtreleri olarak çalışır. 

Sonraki eylemler 

• Razor Pages İçin filtre yöntemlerinebakın. 

• Filtrelerle denemek için GitHub örneğini indirin, test edin ve değiştirin. 




ASRNET Core bölgeler 
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Dhananjay Rohan ve Rick Anderson 

Bölgeler, ilgili işlevselliği ayrı bir ad alanı (yönlendirme için) ve klasör yapısı (görünümler için) olarak bir 
grup içinde düzenlemek için kullanılan bir ASP.NET özelliğidir. Alanların kullanılması area , controiler 
ve action ya da Razor sayfası page başka bir rota parametresi ekleyerek yönlendirme amacına yönelik 
bir hiyerarşi oluşturur. 

Alanları, her biri kendi Razor Pages, denetleyiciler, görünümler ve modeller kümesine sahip bir AS P.N ET 
Core Web uygulamasını daha küçük işlevsel gruplar halinde bölümlemek için bir yol sağlar. Bir alan, bir 
uygulamanın içindeki yapısı etkin bir şekilde. Bir ASP.NET Core Web projesinde, sayfalar, model, 
denetleyici ve görünüm gibi mantıksal bileşenler farklı klasörlerde tutulur. ASP.NET Core çalışma 
zamanı, bu bileşenler arasındaki ilişkiyi oluşturmak için adlandırma kurallarını kullanır. Büyük bir 
uygulama için, uygulamayı işlevlerin ayrı üst düzey alanlarında bölümlemek avantajlı olabilir. Örneğin, 
kullanıma alma, faturalandırma ve arama gibi birden çok iş birimi içeren bir e-ticaret uygulaması. Bu 
birimlerin her birinin görünümleri, denetleyicileri, Razor Pages ve modelleri içermesi için kendi alanı 
vardır. 

Şu durumlarda bir projedeki alanı kullanmayı göz önünde bulundurun: 

• Uygulama, mantıksal olarak ayrılabilen birden çok üst düzey işlevsel bileşenden oluşur. 

• Her işlevsel alanın bağımsız olarak çalışabilmesi için uygulamayı bölümlemek istiyorsunuz. 

Örnek kodu görüntüleyin veya indirin (nasıl indirilir), indirme örneği, test bölgeleri için temel bir 
uygulama sağlar. 

Razor Pages kullanıyorsanız, bu belgede Razor Pages bulunan alanlara bakın. 

Görünümlere sahip denetleyiciler için bölgeler 

Alanları, denetleyicileri ve görünümleri kullanan tipik bir ASP.NET Core Web uygulaması şunları içerir: 

• Bir alan klasörü yapısı. 

• Denetleyiciyi alanla ilişkilendirmek için [Area] özniteliğine sahip denetleyiciler: 

[Area("Products")] 

public class ManageController : Controiler 
{ 


• Başlangıç alanına eklenen alan yolu: 















app.UseMvc(routes => 

{ 

routes.MapRoute( 
name: "MyArea", 

template: "{area:exists}/{controller=Home}/{action=Index}/{id?}"); 

routes.MapRoute( 
name: "default", 

template: "{controller=Home}/{action=Index}/{id?}"); 

}); 

Alan klasörü yapısı 

iki mantıksal grup, ürün ve hizmetiçeren bir uygulamayı düşünün. Alan kullanarak, klasör yapısı 
aşağıdakine benzer olacaktır: 

• Proje adı 
o Alanlar 
o Ürünler 

o Denetleyiciler 

o HomeController.es 
o ManageController.es 
o Görünümler 
o Ana Sayfası 
o lndex.cshtml 
o Yönet 

o lndex.cshtml 
o . Cshtml hakkında 
o Hizmetler 

o Denetleyiciler 

o HomeController.es 
o Görünümler 
o Ana Sayfası 
o lndex.cshtml 

Yukarıdaki düzen, alan kullanılırken tipik olsa da, bu klasör yapısını kullanmak için yalnızca görünüm 
dosyaları gereklidir. Eşleşen bir alan görünümü dosyası için bulma aramalarını aşağıdaki sırayla 
görüntüleyin: 

/Areas/<Area-Name>/Views/<Controller-Name>/<Action-Name>.cshtml 
/Areas/<Area-Name>/Views/Shared/<Action-Name>.cshtml 
/Views/Shared/<Action-Name>.cshtml 
/Pages/Shared/<Action-Name>.cshtml 

Denetleyiciyi bir alanla ilişkilendir 

Alan denetleyicileri lalanı] özniteliğiyle belirlenir: 








using Microsoft.AspNetCore.Mvc; 

namespace MVCareas.Areas.Products.Controllers 

{ 

[Area("Products")] 

public class ManageController : Controller 

{ 

public IActionResult Index() 

{ 

return View(); 

} 

public IActionResult About() 

{ 

return View(); 

} 

} 

} 


Alan yolu Ekle 

Alan rotaları genellikle öznitelik yönlendirme yerine geleneksel yönlendirmeyi kullanır.Geleneksel 
yönlendirme sıra bağımlıdır. Genel olarak, alanlar içeren rotalar, alan olmayan rotalardan daha belirgin 
olduklarından daha önce rota tablosuna yerleştirilmelidir. 

{area:...} , URL alanı tüm alanlarda Tekdüzen ise yol şablonlarında bir belirteç olarak kullanılabilir: 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Home/Error"); 
app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 

app.UseMvc(routes => 

{ 

routes.MapRoute( 
name: "MyArea", 

template: "{area:exists}/{controller=Home}/{action=Index}/{id?}"); 

routes.MapRoute( 
name: "default"., 

template: "{controller=Home}/{action=Index}/{id?}"); 

})J 

} 

Yukarıdaki kodda exists , yolun bir alanla eşleşmesi gereken bir kısıtlama uygular, {area:...} 
kullanmak, alanlara yönlendirme eklemek için en az karmaşık mekanizmadır. 

Aşağıdaki kod, iki adlandırılmış alan yolu oluşturmak için MapAreaRoute kullanır: 





public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Home/Error"); 
app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 

app.UseMvc(routes => 

{ 

routes.MapAreaRoute( 

name: "MyAreaProducts", 
areaName:"Products", 

template: "Products/{controller=Home}/{action=Index}/{id?}"); 

routes.MapAreaRoute( 

name: "MyAreaServices", 
areaName: "Services", 

template: "Services/{controller=Home}/{action=Index}/{id?}"); 

routes.MapRoute( 
name: "default", 

template: "{controller=Home}/{action=Index}/{id?}"); 

})J 

} 

ASP.NET Core2,2ile MapAreaRoute kullanırken, Bu GitHub sorununabakın. 

Daha fazla bilgi için bkz. alan yönlendirme. 

MVC alanlarıyla bağlantı oluşturma 

Örnek indirmenin aşağıdaki kodu, belirtilen alanla birlikte bağlantı oluşturmayı gösterir 



<li>Anchor Tag Helpen links</li> 

<ul> 

<li> 

<a asp-area="Pnoducts" asp-controller="Home" asp-action="About"> 
Products/Home/About 

</a> 

</li> 

<li> 

<a asp-area="Services" asp-controller="Home" asp-action="About"> 
Services About 

</a> 

</li> 

<li> 

<a asp-area="" asp-controller="Home" asp-action="About"> 
/Home/About 

</a> 

</li> 

</ul> 

<li>Html.ActionLink generated links</li> 

<ul> 


<li> 

@Html.ActionLink("Product/Manage/About"j "About ", "Manage", 

new { area = "Products" }) 

</li> 

</ul> 

<li>Url.Action generated links</li> 

<ul> 

<li> 

<a href='@Url.Action("About"j "Manage", new { area = "Products" })’> 
Products/Manage/About 

</a> 

</li> 

</ul> 


Yukarıdaki kodla oluşturulan bağlantılar, uygulamanın herhangi bir yerinde geçerlidir. 

Örnek indirme, önceki bağlantıları içeren kısmi bir görünüm ve alanı belirtmeksizin aynı bağlantıları 
içerir. Kısmi görünüme, Düzen dosyasındabaşvurulur, bu nedenle uygulamadaki her sayfa oluşturulan 
bağlantıları görüntüler. Alanı belirtmeden oluşturulan bağlantılar yalnızca aynı alan ve denetleyicideki bir 
sayfadan başvuruluyorsa geçerlidir. 

Alan veya denetleyici belirtilmediğinde, yönlendirme ortam değerlerine göre değişir. Geçerli isteğin 
geçerli yol değerleri, bağlantı oluşturma için çevresel değerler olarak kabul edilir. Örnek uygulama için 
birçok durumda, ortam değerlerini kullanmak yanlış bağlantılar oluşturur. 

Daha fazla bilgi için bkz. Denetleyici eylemlerine yönlendirme. 

_ViewStart. cshtml dosyasını kullanan alanların paylaşılan düzeni 

Uygulamanın tamamında ortak bir düzen paylaşmak için _ViewStart. cshtml 'yi uygulama kök klasörüne 
taşıyın. 

_Viewlmports. cshtml 

Standart konumunda /views/_Viewlmports. cshtml , alanlara uygulanmaz. Bölgenizdeki ortak Etiket 
Yardımcıları, @using veya @inject kullanmak için, uygun bir _Viewlmports. cshtml dosyasının, alan 
Görünümleriniz için geçerliolduğundan emin olun. Tüm görünümlerinizin aynı davranışını istiyorsanız, 
/views/_Viewlmports. cshtml öğesini uygulama köküne taşıyın. 

Görünümlerin depolandığı varsayılan alan klasörünü değiştirme 

Aşağıdaki kod, varsayılan alan klasörünü "Areas" "MyAreas" olarak değiştirir: 












public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<RazorViewEngineOptions>(options => 

{ 

options.AreaViewLocationFormats.Clear(); 

options.AreaViewLocationFormats.Add("/MyAreas/{2}/Views/{l}/{0}.cshtml"); 
options.AreaViewLocationFormats.Add("/MyAreas/{2}/Views/Shared/{0}.cshtml"); 
options.AreaViewLocationFormats.Add("/Views/Shared/{0}.cshtml"); 

})J 

Services.AddMvc(); 

} 


Razor Pages alan bölgeler 

Razor Pages olan alanlarda, uygulamanın kökünde bir alan//Pages klasörü gerekir. Aşağıdaki klasör 
yapısı örnek uygulamaylabirlikte kullanılır: 

• Proje adı 
o Alanlar 
o Ürünler 
o Sayfalar 

o _Viewlmports 
o hakkında 
o Dizin 
o Hizmetler 
o Sayfalar 
o Yönet 

o hakkında 
o Dizin 


Razor Pages ve alanlarıyla bağlantı oluşturma 

Örnek indirmenin aşağıdaki kodu, belirtilen alanla birlikte bağlantı oluşturmayı gösterir (örneğin, 
asp-area="Products" ): 



<li>Anchor Tag Helper links</li> 

<ul> 

<li> 

<a asp-area="Products" asp-page="/About"> 

Products/About 

</a> 

</li> 

<li> 

<a asp-area="Services" asp-page="/Manage/About"> 
Services/Manage/About 

</a> 

</li> 

<li> 

<a asp-area="" asp-page="/About"> 

/About 

</a> 

</li> 

</ul> 

<li>Url.Page generated links</li> 

<ul> 

<li> 

<a href='@Url.Page("/Manage/About", new { area = "Services" })’> 
Services/Manage/About 

</a> 

</li> 

<li> 

<a href='@Url.Page("/About", new { area = "Products" })'> 
Products/About 

</a> 

</li> 

</ul> 


Yukarıdaki kodla oluşturulan bağlantılar, uygulamanın herhangi bir yerinde geçerlidir. 

Örnek indirme, önceki bağlantıları içeren kısmi bir görünüm ve alanı belirtmeksizin aynı bağlantıları 
içerir. Kısmi görünüme, Düzen dosyasındabaşvurulur, bu nedenle uygulamadaki her sayfa oluşturulan 
bağlantıları görüntüler. Alanı belirtmeden oluşturulan bağlantılar yalnızca aynı alandaki bir sayfadan 
başvuruluyorsa geçerlidir. 

Alan belirtilmediğinde, yönlendirme ortam değerlerine göre değişir. Geçerli isteğin geçerli yol değerleri, 
bağlantı oluşturma için çevresel değerler olarak kabul edilir. Örnek uygulama için birçok durumda, 
ortam değerlerini kullanmak yanlış bağlantılar oluşturur. Örneğin, aşağıdaki koddan oluşturulan 
bağlantıları göz önünde bulundurun: 

<li> 

<a asp-page="/Manage/About"> 

Services/Manage/About 

</a> 

</li> 

<li> 

<a asp-page="/About"> 

/About 

</a> 

</li> 

Önceki kod için: 

• <a asp-page="/Manage/About"> oluşturulan bağlantı, yalnızca son istek Services alanındaki bir sayfa 
için olduğunda doğrudur. Örneğin, /Services/Manage/ , /Services/Manage/Index veya 
/Services/Manage/About . 


<a asp-page="/About"> oluşturulan bağlantı, yalnızca son istek /Home bir sayfa için olduğunda 









doğrudur. 

• Kod, örnek indirden. 

Ad alanı ve etiket yardımcıları _Viewlmports dosya ile içeri aktarma 

Bir_ Vievvlmports. cshtml dosyası her bir alan sayfalan klasörüne eklenerek, ad alanı ve etiket 
yardımcıları, klasördeki her bir Razor sayfasına içeri aktarabilir. 

Örnek kodun bir _ Vievvlmports. cs/rfm/dosyası içermeyen Hizmetler alanını göz önünde bulundurun. 
Aşağıdaki biçimlendirme /Services/Manage/about Razor sayfasını göstermektedir: 

@page 

(ŞaddTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 
@model RPareas.Areas.Services.Pages.Manage.AboutModel 
@{ 

ViewData["Title"] = "Srv Mng About"; 

} 

<h2>/Services/Manage/About</h2> 

<a asp-area="Products" asp-page="/Index"> 

Products/Index 

</a> 

Önceki biçimlendirmede: 

• Modeli belirtmek için tam etki alanı adının kullanılması gerekir ( 

@model RPareas.Areas.Services.Pages.Manage.AboutModel ). 

• Etiket yardımcıları @addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers tarafından etkinleştirilir 

Örnek indirme sırasında, ürünler alanı aşağıdaki _Viewlmports. cshtml dosyasını içerir: 

@namespace RPareas.Areas.Products.Pages 
(ŞaddTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 

Aşağıdaki biçimlendirme/Producfs/obouf Razor sayfasını göstermektedir: 

@page 

@model AboutModel 
@{ 

ViewData["Title"] = "Prod About"j 

} 

<h2>Products/About</h2> 

<a asp-area="Services" asp-page="/Manage/About"> 

Services/Manage/About 

</a> 

Önceki dosyada, ad alanı ve @addTagHeiper yönergesi, alan/ürünler/Pages/_Viewlmports. cshtml 
dosyası tarafından dosyaya aktarılır. 

Daha fazla bilgi için bkz. etiket Yardımcısı kapsamını yönetme ve paylaşılan yönergeleri içeri aktarma. 

Razor Pages alanlarıyla ilgili paylaşılan düzen 

Uygulamanın tamamında ortak bir düzen paylaşmak için _ViewStart. cshtml 'yi uygulama kök klasörüne 
taşıyın. 


Yayımlama alanı 







Wwwroot dizinindeki tüm *. cshtml dosyalan ve dosyalan, <Project sdk="Micnosoft.NET.sdk.web ,, > 
csproj dosyasına dahil edildiğinde çıktıya yayımlanır. 
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Luke Latham, Steve Smithve Rutger fırtınası tarafından 

AS P.N ET Core, daha küçük dosyalar için arabellekli model bağlama ve daha büyük dosyalar için arabelleğe 

alınmamış akış kullanarak bir veya daha fazla dosyanın yüklenmesini destekler 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Güvenlik konuları 

Kullanıcılara bir sunucuya dosya yükleme yeteneği sağlarken dikkatli olun. Saldırganlar şunları deneyebilir: 

• Hizmet reddi saldırıları yürütün. 

• Virüsleri veya kötü amaçlı yazılımları karşıya yükleyin. 

• Ağları ve sunucuları diğer yollarla tehlikeye atabilir. 

Başarılı bir saldırının olasılığını azaltan güvenlik adımları şunlardır: 

• Dosyaları, tercihen sistem dışı bir sürücüye, özel bir dosya yükleme alanına yükleyin. Ayrılmış bir konum, karşıya 
yüklenen dosyalar üzerinde güvenlik kısıtlamaları yapmayı kolaylaştırır. Dosya yükleme konumunda yürütme 
izinlerini devre dışı bırakın.+ 

• Karşıya yüklenen dosyaları uygulamayla aynı dizin ağacında kalıcı yapma .+ 

• Uygulama tarafından belirlenen bir güvenli dosya adı kullanın. Kullanıcı tarafından belirtilen bir dosya adı veya 
karşıya yüklenen dosyanın güvenilmeyen dosya adı kullanmayın.t HTML 'yi görüntülerken güvenilmeyen dosya 
adını kodlayın. Örneğin, dosya adını günlüğe kaydetme veya Kullanıcı arabiriminde görüntüleme (Razor 
otomatik olarak HTML kodlama çıkışı). 

• Uygulamanın tasarım belirtimi için yalnızca onaylanan dosya uzantılarına izin verin.t 

• Sunucuda istemci tarafı denetimlerinin gerçekleştirildiğinden emin olun.t İstemci tarafı denetimleri kolayca 
atlayabilirsiniz. 

• Karşıya yüklenen dosyanın boyutunu denetleyin. Büyük karşıya yüklemeleri engellemek için en büyük boyut 
sınırını ayarlayın.t 

• Aynı ada sahip karşıya yüklenen bir dosya tarafından dosyaların üzerine yazılmaması gerektiğinde, dosyayı 
karşıya yüklemeden önce dosya adını veritabanına veya fiziksel depolamaya göre denetleyin. 

• Dosya depolanmadan önce karşıya yüklenen içerik üzerinde bir virüs/kötü amaçlı yazılım tarayıcısı 
çalıştırın. 

örnek uygulama tölçütleri karşılayan bir yaklaşımı gösterir. 
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Kötü amaçlı bir kodun bir sisteme karşıya yükleme için kod yürütme için ilk adımı sık şöyledir: 

• Sistemin denetimini tamamen elde edin. 

• Sistemin kilitlenme sonucuyla bir sistemi aşırı yükleme. 

• Kullanıcı veya sistem verilerini tehlikeye. 

• Genel Kullanıcı arabirimine Graffiti uygulayın. 

Kullanıcıların dosyaları kabul ederken saldırı yüzey alanı azaltma hakkında daha fazla bilgi için aşağıdaki kaynaklara bakın: 

• Sınırsız dosya karşıya yükleme 

• Azure güvenlik: uygun denetimleri kullanıcıların dosyaları kabul ederken karşılandığından emin 


Örnek uygulamadaki örnekler de dahil olmak üzere güvenlik önlemlerini uygulama hakkında daha fazla bilgi için 
doğrulama bölümüne bakın. 

Depolama senaryoları 

Dosyalar için ortak depolama seçenekleri şunlardır: 

• Veritabanı 

o Küçük dosya yüklemeleri için, bir veritabanı genellikle fiziksel depolama (dosya sistemi veya ağ 
paylaşımından) seçeneklerinden daha hızlıdır. 

o Kullanıcı verileri için bir veritabanı kaydının alınması eşzamanlı olarak dosya içeriğini (örneğin, avatar 
görüntüsü) sağlayabildiğinden, veritabanı genellikle fiziksel depolama seçeneklerine göre daha uygundur, 
o Bir veritabanı, veri depolama hizmeti kullanmaktan daha ucuz olabilir. 

• Fiziksel depolama (dosya sistemi veya ağ paylaşma) 

o Büyük dosya yüklemeleri için: 

o Veritabanı limitleri karşıya yükleme boyutunu kısıtlayabilir. 

o Fiziksel depolama genellikle bir veritabanındaki depolamadan daha az ekonomik olur, 
o Fiziksel depolama, veri depolama hizmeti kullanmaktan daha ucuz olabilir. 

o Uygulamanın işlemi, depolama konumu için okuma ve yazma izinlerine sahip olmalıdır. Hiçbirzaman 
yürütme izni vermeyin. 

• Veri depolama hizmeti (örneğin, Azure Blob depolama) 

o Hizmetler genellikle tek hata noktalarına tabi olan şirket içi çözümler üzerinde geliştirilmiş 
ölçeklenebilirlik ve esneklik sunar. 

o Hizmetler büyük depolama altyapısı senaryolarında düşük maliyetlidir. 

Daha fazla bilgi için bkz. hızlı başlangıç: nesne depolamada blob oluşturmak için .NET kullanma. Konu 
UploadFromFileAsyncgösterir, ancak UploadFromStreamAsync bir Streamçalışırken blob depolamaya 
FileStream kaydetmek için kullanılabilir. 

Karşıya dosya yükleme senaryoları 

Dosyaları karşıya yüklemek için iki genel yaklaşım arabelleğe alınır ve akışlardır. 

Ara 

Dosyanın tamamı bir IFormFileokur, bu dosya dosyayı işlemek veya kaydetmek C# için kullanılan bir gösterimidir. 

Dosya karşıya yüklemeleri tarafından kullanılan kaynaklar (disk, bellek), eşzamanlı dosya karşıya yüklemelerinin 
sayısına ve boyutuna bağlıdır. Bir uygulama çok fazla karşıya yükleme arabelleğini denerse, bellek veya disk alanı 




tükenirse site çöker. Karşıya dosya yükleme boyutu veya sıklığı uygulama kaynaklarını tüketme ise, akış 1 ı kullanın. 


NOTE 

64 KB geçen tek bir arabelleğe alınmış dosya, bellekten diskte geçid bir dosyaya taşınır. 


Dosya arabelleğe alma, bu konunun aşağıdaki bölümlerinde ele alınmıştır: 

• Fiziksel depolama alanı 

• Veritabanı 

Akış 

Dosya çok parçalı bir istekten alınır ve doğrudan uygulama tarafından işlenir veya kaydedilir. Akış performansı 
önemli ölçüde iyileştirmez. Akış, dosya karşıya yüklenirken bellek veya disk alanı taleplerini azaltır. 

Akış büyük dosyaları akış ile büyük dosyaları karşıya yükle bölümünde ele alınmıştır. 

Fiziksel depolamaya arabellekli model bağlamaya sahip küçük dosyaları karşıya yükleme 

Küçük dosyaları karşıya yüklemek için, çok parçalı bir form kullanın veya JavaScript kullanarak bir POST isteği 
oluşturun. 

Aşağıdaki örnek, tek bir dosyayı karşıya yüklemek için bir Razor Pages formunun kullanımını gösterir (örnek 
uygulamadaPages/Bufferedsinglefileuploadfiziksel. cshtml): 

<form enctype="multipart/form-data" method="post"> 

<dl> 

<dt> 

<label asp-for="FileUpload. FormFile"x/label> 

</dt> 

<dd> 

<input asp-for="FileUpload.FormFile" type="file"> 

<span asp-validation-for="Filellpload. FormFile"x/span> 

</dd> 

</dl> 

cinput asp-page-handler="Upload" class="btn" type="submit" value="Upload" /> 

</form> 


Aşağıdaki örnek, önceki örneğe benzerdir, ancak şunları hariç: 

• Form verilerini göndermek için JavaScript (Fetch API) kullanılır. 

• Doğrulama yok. 




<form action="BufferedSingleFilellploadPhysical/?handler=Upload" 

enctype="multipart/form-data" onsubmit="A]AXSubmit(this);return false;" 
method="post"> 

<dl> 

<dt> 

<label for="FileUpload_FormFile">File</label> 

</dt> 

<dd> 

<input id="FileUpload_FormFile" type="file" 
name="Filellpload. FormFile" /> 

</dd> 

</dl> 

cinput class="btn" type="submit" value="Upload" /> 

<div style="margin-top:15px"> 

<output name="result"x/output> 

</div> 

</form> 

<script> 

async function ADAXSubmit (oFormElement) { 

var resultElement = oFormElement.elements.namedltem("result"); 
const formData = new FormData(oFormElement); 

try { 

const response = await fetch(oFormElement.action., { 
method: 'POST', 
body: formData 
}); 

if (response.ok) { 

window.location.href = 

} 

resultElement.value = ’Result: ' + response.status +''+ 
response.statusText; 

} catch (error) { 

console.error('Error: ', error); 

} 

} 

</script> 


Fetch API 'sini desteklemeyenistemcilerde form gönderisini JavaScript 'te gerçekleştirmek için aşağıdaki 
yaklaşımlardan birini kullanın: 

• Fetch Polyfill kullanın (örneğin, Window. Fetch (GitPIub/fetch)). 

• XMLHttpRequest kullanın. Örneğin: 

<script> 

"use strict"; 

function ADAXSubmit (oFormElement) { 
var oReq = new XMLHttpRequest(); 
oReq.onload = function(e) { 

oFormElement.elements.namedltem("result").value = 

’Result: ' + this.status + ' ' + this.statusText; 

}J 

oReq.öpen("post", oFormElement.action); 
oReq.send(new FormData(oFormElement)); 

} 

</script> 



Dosya yüklemelerini desteklemek için, HTML formları muitipart/form-data bir kodlama türü ( enctype ) 
belirtmelidir. 

Birden çok dosyayı karşıya yüklemeyi desteklemek için fileş giriş öğesi için, <input> öğesinde multiple 
özniteliğini sağlayın: 

cinput asp-for="FileUpload.FormFiles" type="file" multiple> 

Sunucuya yüklenen tek dosyalara IFormFilekullanılarak model bağlama yoluyla erişilebilir. Örnek uygulama, 
veritabanı ve fiziksel depolama senaryoları için birden çok arabellekli dosya yüklemeyi gösterir. 
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Görüntüleme ve günlüğe kaydetme için dışında IFormFile FileName özelliğini kullanmayın. Görüntüleme veya günlüğe 
kaydetme sırasında, HTML dosya adını kodlayın. Saldırgan, tam yollar veya göreli yollar dahil olmak üzere kötü amaçlı bir 
dosya adı sağlayabilir. Uygulamalar: 

• Kullanıcı tarafından sağlanan dosya adının yolunu kaldırın. 

• Kullanıcı arabirimi veya günlüğe kaydetme için HTML kodlu, yol tarafından kaldırılan dosya adını kaydedin. 

• Depolama için yeni bir rastgele dosya adı oluşturun. 

Aşağıdaki kod, dosya adından yolu kaldırır: 

string untrustedFileName = Path.GetFileName(pathName)j 

Bu nedenle, şu ana kadar dikkate alınması gereken örnekler aşağıda verilmiştir. Ek bilgiler aşağıdaki bölümler ve örnek 
uygulamatarafından sağlanır: 

• Güvenlik konuları 

• Doğrulama 


Model bağlama ve IFormFilekullanarak dosya karşıya yüklerken, eylem yöntemi şunları kabul edebilir: 

• Tek bir IFormFile. 

• Birkaç dosyayı temsil eden aşağıdaki koleksiyonlardan herhangi biri: 
o IFormFileCollection 

o IEnumerable<IFormFile> 
o Liste<IFormFile> 


NOTE 

Bağlama, form dosyaları adına göre eşleşir.Örneğin, <input type="file" name="formFlle"> HTML name değeri C# 
parametre/özellik ile ( FormFile ) eşleşmelidir. Daha fazla bilgi için, ad öznitelik DEĞERİNİ Post yönteminin parametre adına 
eşleştirin bölümüne bakın. 


Aşağıdaki örnek: 

• Karşıya yüklenen bir veya daha fazla dosya üzerinden döngü. 

• Dosya adı da dahil olmak üzere bir dosyanın tam yolunu döndürmek için Path. GetTempFileName kullanır. 

• Dosyalar, uygulama tarafından oluşturulan bir dosya adı kullanılarak yerel dosya sistemine kaydedilir. 

• Karşıya yüklenen dosyaların toplam sayısını ve boyutunu döndürür. 












public async Task<IActionResult> OnPostUploadAsync(List<IFormFile> fileş) 

{ 

long size = fileş.Sum(f => f.Length); 

foreach (var formFile in fileş) 

{ 

if (formFile.Length > 0) 

{ 

var filePath = Path.GetTempFileName(); 

using (var stream = System.10.File.Create(filePath)) 

{ 

await formFile.CopyToAsync(stream); 

} 

} 

} 

// Process uploaded fileş 

// Don't rely on or trust the FileName property without validation. 
return Ok(new { count = fileş.Countj size, filePath }); 

} 

Yol olmadan bir dosya adı oluşturmak için Path.GetRandomFileName kullanın. Aşağıdaki örnekte, yol 
yapılandırmadan alınır: 

foreach (var formFile in fileş) 

{ 

if (formFile.Length > 0) 

{ 

var filePath = Path.Combine(_config["StoredFilesPath "], 

Path.GetRandomFileName()); 

using (var stream = System.10.File.Create(filePath)) 

{ 

await formFile.CopyToAsync(stream); 

} 

} 

} 

FileStream geçirilen yol, dosya adını içermelidir. Dosya adı sağlanmazsa, çalışma zamanında bir 
UnauthorizedAccessException oluşturulur. 

IFormFile tekniği kullanılarak yüklenen dosyalar, işlemeden önce sunucuda veya diskte bellek halinde arabelleğe 
alınır. Eylem yönteminde, IFormFile içeriğe Streamolarak erişilebilir. Yerel dosya sistemine ek olarak, dosyalar bir ağ 
paylaşımında veya Azure Blob depolamagibi bir dosya depolama hizmetine kaydedilebilir. 

Karşıya yüklemek için birden çok dosya üzerinde döngü yapan ve güvenli dosya adları kullanan başka bir örnek 
için, örnek uygulamadaki Pages/Bufferedmultiplefileuploadfiziksel. cshtml. cs dosyasına bakın. 
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Path. GetTempFileName , önceki geçici dosyaları silmeden 65.535 'den fazla dosya oluşturulduysa bir IOException oluşturur. 
65.535 dosya sınırının sunucu başına sınırı vardır. Windows işletim sistemi için bu sınır hakkında daha fazla bilgi için aşağıdaki 
konulara bakın: 

• GetTempFileNameA işlevi 

• GetTempFileName 


Bir veritabanına arabellekli model bağlamaya sahip küçük dosyaları karşıya yükleme 







ikili dosya verilerini Entity Framevvorkkullanarak bir veritabanında depolamak için, varlıkta bir Byte Array özelliği 
tanımlayın: 

public class AppFile 

{ 

public int Id { get; set; } 
public byte[] Content { get; set; } 

} 


Bir IFormFileiçeren sınıf için bir sayfa modeli özelliği belirtin: 

public class BufferedSingleFileUploadDbModel : PageModel 

{ 


[BindProperty] 

public BufferedSingleFileUploadDb FileLIpload { get; set; } 


} 

public class BufferedSingleFileUploadDb 

{ 

[Required] 

[Display(Name="File")] 

public IFormFile FormFile { get; set; } 

} 



<dl> 

<dt> 

clabel asp-for="FileUpload. FormFile"x/label> 

</dt> 

<dd> 

<input asp-for="FileUpload.FormFile" type="file"> 

</dd> 

</dl> 

<input asp-page-handler="Upload" class="btn" type="submit" value="Upload"> 
</form> 


Form sunucuya gönderildiğinde, IFormFile bir akışa kopyalayın ve veritabanına bir bayt dizisi olarak kaydedin. 
Aşağıdaki örnekte, uygulamanın veritabanı bağlamını _dbContext depolar: 






public async Task<IActionResult> OnPostUploadAsync() 

{ 

using (var memoryStream = new MemoryStream()) 

{ 

await FileUpload.FormFile.CopyToAsync(memoryStream); 

// Upload the file if less than 2 MB 
if (memoryStream.Length < 2097152) 

{ 

var file = new AppFile() 

{ 

Content = memoryStream.ToArray() 

}; 

_dbContext.File.Add(file); 

await _dbContext.SaveChangesAsync(); 

} 

else 

{ 

ModelState.AddModelError("File"j "The file is too large."); 

} 

} 

return Page(); 

} 

Yukarıdaki örnek, örnek uygulamada gösterilen senaryoya benzerdir: 

• Pages/BufferedSingleFileUploadDb. cshtml 

• Pages/BufferedSingleFileUploadDb. cshtml. cs 
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ikili verileri ilişkisel veritabanlarında depolarken dikkatli olun, çünkü performansı olumsuz etkileyebilir. 

Doğrulaması olmadan IFormFile FileName özelliğine güvenmeyin veya güvenmeyin. FileName özelliği yalnızca 
görüntüleme amacıyla ve yalnızca HTML kodlaması sonrasında kullanılmalıdır. 

Belirtilen örneklerde dikkate alınması gereken önemli noktalar. Ek bilgiler aşağıdaki bölümler ve örnek uygulamatarafından 
sağlanır: 

• Güvenlik konuları 

• Doğrulama 


Akışa sahip büyük dosyaları karşıya yükleme 

Aşağıdaki örnek, bir denetleyiciyi bir denetleyici eyleminde akışa almak için JavaScript 'in nasıl kullanılacağını 
gösterir. Dosyanın antiforgery belirteci özel bir filtre özniteliği kullanılarak oluşturulur ve istek gövdesi yerine 
istemci HTTP üst bilgilerine geçirilir. Eylem yöntemi karşıya yüklenen verileri doğrudan işlediğinden, form modeli 
bağlama başka bir özel filtre tarafından devre dışı bırakıldı. Eylem içinde formun içerikleri, her bir Muitipartsection 
okuyan, dosyayı işleyen veya içeriği uygun şekilde depolayan bir MuitipartReader kullanılarak okunur. Çok parçalı 
bölümler okunduktan sonra eylem kendi model bağlamasını gerçekleştirir. 

ilk sayfa yanıtı formu yükler ve bir tanımlama bilgisine ( GenerateAntiforgeryTokenCookieAttribute özniteliği 
aracılığıyla) bir antiforgery belirteci kaydeder. Öznitelik, bir istek belirtecine sahip bir tanımlama bilgisi ayarlamak 
için AS P.N ET Core yerleşik antiforgery desteğini kullanır: 







public class GenerateAntiforgeryTokenCookieAttribute : ResultFilterAttribute 

{ 

public override void OnResultExecuting(ResultExecutingContext context) 

{ 

var antiforgery = context.HttpContext.RequestServices.GetService<IAntiforgery>(); 

// Send the request token as a JavaScript-readable cookie 

var tokens = antiforgery.GetAndStoreTokens(context.HttpContext); 

context.HttpContext.Response.Cookies.Append( 

"RequestVerificationToken ", 
tokens.RequestToken, 

new CookieOptions() { HttpOnly = false }); 

} 

public override void OnResultExecuted(ResultExecutedContext context) 

{ 

} 

} 

Model bağlamayı devre dışı bırakmak için DisableFormValueModelBindingAttribute kullanılır: 

[Attributellsage(AttributeTargets.Class | AttributeTargets.Method)] 

public class DisableFormValueModelBindingAttribute : Attribute, IResourceFilter 

{ 

public void OnResourceExecuting(ResourceExecutingContext context) 

{ 

var factories = context.ValueProviderFactories; 
factories.RemoveType<FormValueProviderFactory>(); 
factories.RemoveType<FormFileValueProviderFactory>(); 
factories.RemoveType<JQueryFormValueProviderFactory>(); 

} 

public void OnResourceExecuted(ResourceExecutedContext context) 

{ 

} 

} 


Örnek uygulamada GenerateAntiforgeryTokenCookieAttribute 

ve DisableFormValueModelBindingAttribute , 

startup.configureServices kurallarıkullanılarak Razor Pages 

/StreamedSingleFileUploadDb ve 

/streamedSingleFileuploadPhysicai sayfa uygulama modellerine filtre olarak uygulanır: 






Services. AddRazorPages() 

.AddRazorPagesOptions(options => 

{ 

options.Conventions 

.AddPageApplicationModelConvention("/StreamedSingleFileUploadDb ", 
model => 

{ 

model.Filters.Add( 

new GenerateAntiforgeryTokenCookieAttribute()); 
model.Filters.Add( 

new DisableFormValueModelBindingAttribute()); 

}); 

options.Conventions 

.AddPageApplicationModelConvention("/StreamedSingleFileUploadPhysical ", 
model => 

{ 

model.Filters.Add( 

new GenerateAntiforgeryTokenCookieAttribute()); 
model.Filters.Add( 

new DisableFormValueModelBindingAttribute()); 

}); 

}); 


Model bağlama formu okumadığından formdan bağlanan parametreler bağlanamaz (sorgu, yol ve başlık çalışmaya 
devam eder). Action yöntemi doğrudan Request özelliği ile birlikte çalışabilir. Her bölümü okumak için bir 
MuitipartReader kullanılır. Anahtar/değer verileri bir KeyvalueAccumulator depolanır. Çok parçalı bölümler 
okunduktan sonra, KeyvalueAccumulator içeriği form verilerini bir model türüne bağlamak için kullanılır. 

EF Core ile bir veritabanına akışa yönelik tüm streamingControiier.uploadDatabase yöntemi: 

[HttpPost] 

[DisableFormValueModelBinding] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> UploadDatabase() 

{ 

if (!MultipartRequestHelper.IsMultipartContentType(Request.ContentType)) 

{ 

ModelState.AddModelError("File ", 

$"The request couldn't be processed (Error 1)."); 

// Log error 

return BadRequest(ModelState); 

} 

// Accumulate the form data key-value palrs İn the request (formAccumulator). 
var formAccumulator = new KeyValueAccumulator(); 
var trustedFileNameForDisplay = string.Empty; 
var untrustedFileNameForStorage = string.Empty; 
var streamedFileContent = new byte[0]; 

var boundary = MultipartRequestHelper.GetBoundary( 

MediaTypeHeaderValue.Parse(Request.ContentType), 

_defaultFormOptions.MultipartBoundaryLengthLimit); 
var reader = new MultipartReader(boundary, HttpContext.Request.Body); 

var section = await reader.ReadNextSectionAsync(); 

while (section != null) 

{ 

var hasContentDispositionHeader = 

ContentDispositionHeaderValue.TryParse( 

section.ContentDisposition, out var contentDisposition); 


if (hasContentDispositionHeader) 

{ 








if (MultipartRequestHelper 

.HasFileContentDisposition(contentDisposition)) 

{ 

untrustedFileNameForStorage = contentDisposition.FileName.Value; 

// Don't trust the file name sent by the Client. To display 
// the file name, HTML-encode the value. 
tnustedFileNameForDisplay = WebUtility.HtmlEncode( 
contentDisposition. FileName. Value); 

streamedFileContent = 

await FileHelpers.ProcessStreamedFile(section, contentDisposition, 
ModelState, _permittedExtensions, _fileSizeLimit); 

if (IModelState.IsValid) 

{ 

return BadRequest(ModelState); 

} 

} 

else if (MultipartRequestFlelper 

.HasFormDataContentDisposition(contentDisposition)) 

{ 

// Don't limit the key name length because the 
// multipart headers length limit is already in effect. 
var key = FleaderUtilities 

.RemoveQuotes(contentDisposition.Name).Value; 
var encoding = GetEncoding(section); 

if (encoding == null) 

{ 

ModelState.AddModelError("File", 

$"The request couldn't be processed (Error 2)."); 

// Log error 

return BadRequest(ModelState); 

} 

using (var streamReader = new StreamReader( 
section.Body, 
encoding, 

detectEncodingFromByteOrderMarks: true, 
bufferSize: 1024, 
leaveOpen: true)) 

{ 

// The value length limit is enforced by 
// MultipartBodyLengthLimit 

var value = await streamReader.ReadToEndAsync(); 

if (string.Equals(value, "undefined", 
StringComparison.OrdinalIgnoreCase)) 

{ 

value = string.Empty; 

} 

formAccumulator.Append(key, value); 

if (formAccumulator.ValueCount > 

_defaultFormOptions.ValueCountLimit) 

{ 

// Form key count limit of 
// _defaultFormOptions.ValueCountLimit 
// is exceeded. 

ModelState.AddModelError("File", 

$"The request couldn't be processed (Error 3)."); 

// Log error 

return BadRequest(ModelState); 

} 


} 

// Drain any remaining section body that hasn't been consumed and 
// read the headers for the next section. 
section = await reader.ReadNextSectionAsync(); 

} 

// Bind form data to the model 
var formData = new FormData(); 
var formValueProvider = new FormValueProvider( 

BindingSource.Form, 

new FormCollection(formAccumulator.GetResults ()), 
Culturelnfo.CurrentCulture); 

var bindingSuccessful = await TryllpdateModelAsync(formData., prefix: 
valueProvider: formValueProvider); 

if (!bindingSuccessful) 

{ 

ModelState.AddModelError("File ", 

"The request couldn't be processed (Error 5)."); 

// Log error 

return BadRequest(ModelState); 

} 

// **WARNING!** 

// In the following example, the file is saved without 
// scanning the file's contents. In most production 
// scenarios, an anti-virus/anti-malware scanner API 
// is used on the file before making the file available 
// for download or for use by other Systems. 

// For more information., see the topic that accompanies 
// this sample app. 

var file = new AppFile() 

{ 

Content = streamedFileContentj 
UntrustedName = untrustedFileNameForStorage, 

Note = formData.Note, 

Size = streamedFileContent.Length, 

UploadDT = DateTime.UtcNow 

}; 

_context.File.Add(file); 

await _context.SaveChangesAsync(); 

return Created(nameof(StreamingController ), null); 


MuitipartRequestHeiper (Utilities/MultipartRequestHelper. cs): 


using System; 
using System.10; 

using Microsoft.Net.Http.Headers; 

namespace SampleApp.Utilities 

{ 

public static class MultipartRequestHelper 

{ 

// Content-Type: multipart/form-data; boundary="-WebKitFormBoundarymx2fSWqWSd0OxQqq" 

// The spec at https://tools.ietf.Org/html/rfc2046#section-5.l States that 70 characters is a 
reasonable limit. 

public static string GetBoundary(MediaTypeHeaderValue contentType, int lengthLimit) 

{ 

var boundary = HeaderUtilities.RemoveQuotes(contentType.Boundary).Value; 

if (string.IsNullOrWhiteSpace(boundary)) 

{ 

throw new InvalidDataException("Missing content-type boundary."); 

} 

if (boundary.Length > lengthLimit) 

{ 

throw new InvalidDataException( 

$"Multipart boundary length limit {lengthLimit} exceeded."); 

} 

return boundary; 

} 

public static bool IsMultipartContentType(string contentType) 

{ 

return !string.IsNullOrEmpty(contentType) 

&& contentType.IndexOf("multipart/"j StringComparison.OrdinalIgnoreCase) >= 0; 

} 

public static bool HasFormDataContentOisposition(ContentDispositionHeaderValue contentDisposition) 

{ 

// Content-Disposition: form-data; name="key"; 
return contentDisposition != null 

&& contentDisposition.DispositionType.Equals("form-data") 

&& string.IsNullOrEmpty(contentDisposition.FileName.Value) 

&& string.IsNullOrEmpty(contentDisposition.FileNameStar.Value); 

} 


} 


} 


public static bool HasFileContentDisposition(ContentDispositionHeaderValue contentDisposition) 

{ 

// Content-Disposition: form-data; name="myfilel"; filename="Misc 002.jpg" 
return contentDisposition != null 

&& contentDisposition.DispositionType.Equals("form-data") 

&& (!string.IsNullOrEmpty(contentDisposition.FileName.Value) 

| !string.IsNullOrEmpty(contentDisposition.FileNameStar.Value)); 

} 


Fiziksel bir konuma akışa yönelik tüm streamingControiier.uploadPhysicai yöntemi: 

[FlttpPost] 

[DisableFormValueModelBinding] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> UploadPhysical() 

{ 

if (!MultipartRequestFlelper.IsMultipartContentType(Request .ContentType)) 

{ 

ModelState.AddModelError("File ", 

$"The request couldn't be processed (Error 1)."); 




// Log error 


return BadRequest(ModelState); 

} 

var boundary = MultipartRequestHelper.GetBoundary( 

MediaTypeHeaderValue.Parse(Request. ContentType), 

_defaultFormOptions.MuitipartBoundaryLengthLimit); 
var reader = new MultipartReader(boundary, HttpContext.Request.Body); 
var section = await reader.ReadNextSectionAsync(); 

while (section != null) 

{ 

var hasContentDispositionHeader = 

ContentDispositionHeaderValue.TryParse( 

section.ContentDisposition, out var contentDisposition); 

if (hasContentDispositionHeader) 

{ 

// This check assumes that there's a file 
// present without form data. If form data 
// is present, this method immediately fails 
// and returns the model error. 
if (!MultipartRequestHelper 

.HasFileContentDisposition(contentDisposition)) 

{ 

ModelState.AddModelError("File", 

$"The request couldn't be processed (Error 2)."); 

// Log error 

return BadRequest(ModelState); 

} 

else 

{ 

// Don't trust the file name sent by the Client. To display 
// the file name, HTML-encode the value. 
var trustedFileNameForDisplay = WebUtility.HtmlEncode( 
contentDisposition. FileName. Value); 
var trustedFileNameForFileStorage = Path.GetRandomFileName(); 

// **WARNING!** 

// In the following example, the file is saved without 
// scanning the file's contents. In most production 
// scenarios, an anti-virus/anti-malware scanner API 
// is used on the file before making the file available 
// for download or for use by other Systems. 

// For more information, see the topic that accompanies 
// this sample. 

var streamedFileContent = await FileHelpers.ProcessStreamedFile( 
section, contentDisposition, ModelState, 

_permittedExtensions, _fileSizeLimit); 

if (İModelState.IsValid) 

{ 

return BadRequest(ModelState); 

} 

using (var targetStream = System.10.File.Create( 

Path.Combine(_targetFilePath, trustedFileNameForFileStorage))) 

{ 

await targetStream.WriteAsync(streamedFileContent); 

_logger.LogInformation( 

"Uploaded file '{TrustedFileNameForDisplay}' saved to " + 

"'{TargetFilePath}' as {TrustedFileNameForFileStorage}", 
trustedFileNameForDisplay, _targetFilePath, 
trustedFileNameForFileStorage); 

} 


} 

} 

// Drain any remaining section body that hasn't been consumed and 
// read the headers for the next section. 
section = await reader.ReadNextSectionAsync(); 

} 

return Created(nameof(StreamingController ), null); 

} 

Örnek uygulamada, doğrulama denetimleri FileHelpers.ProcessstreamedFile tarafından işlenir. 

Doğrulama 

Örnek uygulamanın FileHelpers sınıfı, arabelleğe alınmış IFormFile ve akış dosya yüklemeleri için birkaç denetim 
gösterir. Örnek uygulamada arabelleğe alınmış IFormFile dosya yüklemelerini işlemek için, Utilities/Fileycırdımalar. 
cs dosyasındaki ProcessFormFile yöntemine bakın. Akış dosyalarını işlemek için aynı dosyadaki 
ProcessstreamedFiie yöntemine bakın. 


VVARNING 

Örnek uygulamada gösterilen doğrulama işleme yöntemleri karşıya yüklenen dosyaların içeriğini taramaz. Çoğu üretim 
senaryosunda, dosyanın kullanıcılara veya diğer sistemlere kullanılabilir hale getirilmesi için dosya üzerinde bir virüs/kötü 
amaçlı yazılım tarayıcı API 'SI kullanılır. 

Konu örneği, doğrulama tekniklerine yönelik çalışan bir örnek sağlasa da şunları gerçekleştirmediğiniz takdirde bir üretim 
uygulamasında FileHelpers sınıfını uygulamayın: 

• Uygulamayı tam olarak anlayın. 

• Uygulamayı uygulamanın ortamı ve belirtimleri için uygun şekilde değiştirin. 

Bu gereksinimleri bilmeden bir uygulamada güvenlik kodunu hiçbir şekilde sayısının fark gözetmeden uygulayın. 


İçerik doğrulama 

Karşıya yüklenen içerikte üçüncü taraf bir virüs/kötü amaçlı yazılım tarama API 'SI kullanın. 

Dosyaları tarama, yüksek hacimli senaryolarda sunucu kaynaklarında yoğun bir şekilde yapılır. Dosya tarama 
nedeniyle istek işleme performansı azaldığında, tarama işini, muhtemelen uygulamanın sunucusundan farklı bir 
sunucuda çalışan bir arka plan hizmetinedevredere göz önünde bulundurun. Genellikle, arka plan virüs tarayıcısı 
tarafından denetlene kadar karşıya yüklenen dosyalar karantinaya alınmış bir alanda tutulur. Bir dosya geçtiğinde 
dosya normal dosya depolama konumuna taşınır. Bu adımlar genellikle bir dosyanın tarama durumunu gösteren 
bir veritabanı kaydıyla birlikte gerçekleştirilir. Böyle bir yaklaşım kullanarak, uygulama ve uygulama sunucusu 
isteklere yanıt vermeye odaklanmaya devam eder. 

Dosya Uzantısı doğrulaması 

Karşıya yüklenen dosyanın uzantısı izin verilen uzantılar listesine göre denetlenmelidir.Örneğin: 

private string[] permittedExtensions = { ",txt", ".pdf" }; 

var ext = Path.GetExtension(uploadedFileName) .Tol_owerInvariant(); 

if (string.IsNullOrEmpty(ext) || !permittedExtensions.Contains(ext)) 

{ 

// The extension is invalid ... discontinue Processing the file 

} 








Dosya imzası doğrulaması 

Bir dosyanın imzası, bir dosyanın başlangıcında ilk birkaç bayta göre belirlenir. Bu baytlar, uzantının dosyanın 
içeriğiyle eşleşip eşleşmediğini göstermek için kullanılabilir. Örnek uygulama, birkaç ortak dosya türü için dosya 
imzalarını denetler. Aşağıdaki örnekte, bir JPEG görüntüsünün dosya imzası, dosyaya karşı denetlenir: 

private static readonly Dictionary<string, List<byte[]>> _fileSignature = 
new Dictionary<string, List<byte[]>> 

{ 

{ ".jpeg", new List<byte[]> 

{ 

new byte[] { 0xFF, 0xD8, 0xFF, 0xE0 }, 

new byte[] { 0xFF, 0xD8, 0xFF, 0xE2 }, 

new byte[] { 0xFF, 0xD8, 0xFF, 0xE3 }, 

} 

}, 

}; 

using (var reader = new BinaryReader(uploadedFileData)) 

{ 

var signatures = _fileSignature[ext]; 

var headerBytes = reader.ReadBytes(signatures.Max(m => m.Length)); 

return signatures.Any(signature => 

headerBytes.Take(signature.Length).SequenceEqual(signature)); 

} 


Ek dosya imzaları almak için Dosya İmzaları veritabanı ve resmi dosya belirtimleri bölümüne bakın. 

Dosya adı güvenliği 

Fiziksel depolamaya bir dosyayı kaydetmek için hiçbir şekilde istemci tarafından sağlanan dosya adı kullanmayın. 
Geçici depolama için tam yol (dosya adı da dahil olmak üzere) oluşturmak için Path. GetRandomFileName veya 
Path. GetTempFileName kullanarak dosya için güvenli bir dosya adı oluşturun. 

Razor otomatik olarak HTML, görüntüleme için özellik değerlerini kodlar.Aşağıdaki kodun kullanımı güvenlidir: 

(Şforeach (var file in Model.DatabaseFiles) { 

<tr> 

<td> 

@f ile.UntrustedName 
</td> 

</tr> 

} 


Razor dışında, her zaman bir kullanıcının isteğinden dosya adı içeriği HtmlEncode. 

Birçok uygulama, dosyanın var olduğunu bir denetim içermelidir; Aksi takdirde, dosyanın üzerine aynı ada sahip bir 
dosya yazılır. Uygulamanızın belirtimlerini karşılamak için ek mantık sağlayın. 

Boyut doğrulaması 

Karşıya yüklenen dosyaların boyutunu sınırlayın. 

Örnek uygulamada, dosyanın boyutu 2 MB ile sınırlıdır (bayt cinsinden gösterilir). Sınır, appSettings. JSON 
dosyasındaki yapılandırma yoluyla sağlanır: 

{ 

"FileSizeLimit": 2097152 

} 

FileSizeLimit PageModei sınıflarına eklenmiş: 





public class BufferedSingleFileUploadPhysicalModel : PageModel 
{ 

private readonly long _fileSizeLimit; 

public BufferedSingleFileUploadPhysicalModel(IConfiguration config) 
{ 

_fileSizeLimit = config.GetValue<long>("FileSizel_imit"); 

} 


} 

Dosya boyutu sınırı aştığında, dosya reddedilir: 

if (formFile.Length > _fileSizeLimit) 

{ 

// The file is too large ... discontinue processing the file 

} 

Name öznitelik değerini POST yönteminin Parameteradı ile Eşleştir 

Form verileri oluşturan veya JavaScript 'in FormData doğrudan kullanan Razor olmayan formlarda, formun 
öğesinde veya FormData belirtilen adın, denetleyicinin eyleminde parametrenin adıyla eşleşmesi gerekir. 

Aşağıdaki örnekte: 


• Bir <input> öğesi kullanılırken, name özniteliği battiePlans değere ayarlanır: 


cinput type="file" name= 

"battiePlans" multiple> 


JavaScript içinde 

FormData 

kullanırken ad, 

battiePlans değer olarak ayarlanır: 


var formData = new FormData(); 


for (var file in fileş) { 

formData.append("battlePlans", file, file.name); 

} 


C# Yöntemin parametresi için eşleşen bir ad kullanın ( battiePlans ): 

• upload adlı Razor Pages sayfa işleyicisi yöntemi için: 

public async Task<IActionResult> OnPostUploadAsync(List<IFormFile> battiePlans) 

• MVC POST denetleyicisi eylem yöntemi için: 

public async Task<IActionResult> Post(List<IFormFile> battiePlans) 


Sunucu ve uygulama yapılandırması 

Çok parçalı gövde uzunluğu sınırı 

MultipartBodyLengthLimit her bir çok parçalı gövdenin uzunluğu için sınır ayarlar. Bu sınırı aşan form bölümleri 
ayrıştırdığında bir lnvalidDataException oluşturur. Varsayılan değer 134.217.728 ' dir (128 MB). 
start up.configureServices MultipartBodyLengthLimit ayarını kullanarak sınırı özelleştirin: 















public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<FormOptions>(options => 

{ 

// Set the limit to 256 MB 

options.MultipartBodyLengthLimit = 268435456; 

}); 


RequestFormLimitsAttribute, tek sayfa veya eylem için MultipartBodyLengthLimit ayarlamak üzere kullanılır. 
Razor Pages bir uygulamada, filtreyi startup.configureServices bir kurala uygulayın: 

Services.AddRazorPages() 

.AddRazorPagesOptions(options => 

{ 

options.Conventions 

.AddPageApplicationModelConvention("/FileUploadPage ", 
model.Filters.Add( 

new RequestFormLimitsAttribute() 

{ 

// Set the limit to 256 MB 
MultipartBodyLengthLimit = 268435456 

}); 

}); 


Razor Pages bir uygulamada veya bir MVC uygulamasında, filtreyi sayfa modeline veya eylem yöntemine 
uygulayın: 

// Set the limit to 256 MB 

[RequestFormLimits(MultipartBodyLengthLimit = 268435456)] 
public class BufferedSingleFileUploadPhysicalModel : PageModel 
{ 

} 


Kestrel maksimum istek gövdesi boyutu 

Kestrel tarafından barındırılan uygulamalar için, varsayılan en büyük istek gövdesi boyutu 30.000.000 bayttır ve bu, 
yaklaşık 28,6 MB 'tır. MaxRequestBodySize Kestrel Server seçeneğini kullanarak sınırı özelleştirin: 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureKestrel((contextj options) => 

{ 

// Handle requests up to 50 MB 

options.Limits.MaxRequestBodySize = 52428800; 

}) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 


RequestSizeLimitAttribute, tek sayfa veya eylem için MaxRequestBodySize ayarlamak üzere kullanılır. 
Razor Pages bir uygulamada, filtreyi Startup.configureServices bir kurala uygulayın: 






Services. AddRazorPages() 

.AddRazorPagesOptions(options => 

{ 

options.Conventions 

.AddPageApplicationModelConvention("/FileUploadPage ", 
model => 

{ 

// Handle requests up to 50 MB 
model.Filters.Add( 

new RequestSizeLimitAttribute(52428800)); 

}); 

}); 


Bir Razor sayfalan uygulamasında veya bir MVC uygulamasında, filtreyi sayfa işleyici sınıfına veya eylem 
yöntemine uygulayın: 

// Handle requests up to 50 MB 
[RequestSizeLimit(52428800)] 

public class BufferedSingleFileUploadPhysicalModel : PageModel 

{ 

} 

RequestsizeLimitAttribute , @attribute Razor yönergesi kullanılarak da uygulanabilir: 

@attribute [RequestSizeLimitAttribute(52428800)] 


Diğer Kestrel limitleri 

Kestrel tarafından barındırılan uygulamalar için diğer Kestrel limitleri de uygulanabilir: 

• istemci bağlantıları üst sınırı 

• istek ve yanıt veri ücretleri 

IIS içerik uzunluğu sınırı 

Varsayılan istek sınırı ( maxAiiowedContentı_ength ), yaklaşık 28.6 MB olan 30.000.000 bayttır. Web. config dosyasında 
sınırı özelleştirin: 

<system.webServer> 

<security> 

<requestFiltering> 

<!-- Handle requests up to 50 MB --> 

<requestLimits maxAllowedContentl_ength="52428800" /> 

</requestFiltering> 

</security> 

</system.webServen> 


Bu ayar yalnızca IIS için geçerlidir. Kestrel üzerinde barındırırken davranış varsayılan olarak gerçekleşmez. Daha 
fazla bilgi için bkz. İstek limitleri <requestLimits >. 

ASP.NET Core modülündeki sınırlamalar veya IIS İstek filtreleme modülünün varlığı, karşıya yüklemeleri 2 veya 4 
GB ile sınırlandırabilir. Daha fazla bilgi için bkz. 2 GB 'tan büyük dosya karşıya yüklenemiyor 
(ASPNET/AspNetCore #2711). 

Sorunları Gider 

Dosyaları karşıya yükleme ve olası çözümleri ile çalışırken karşılaşılan bazı yaygın sorunlar aşağıda verilmiştir. 





Bir IIS sunucusuna dağıtılırken bulunamadı hatası 

Aşağıdaki hata karşıya yüklenen dosyanın, sunucunun yapılandırılmış içerik uzunluğunu aştığını gösterir: 

HTTP 404.13 - Not Found 

The request filtering modüle is configuned to deny a request that exceeds the request content length. 

Limiti artırma hakkında daha fazla bilgi için bkz. IIS içerik uzunluğu sınırı bölümü. 

Bağlantı hatası 

Bir bağlantı hatası ve bir sıfırlama sunucu bağlantısı büyük olasılıkla karşıya yüklenen dosyanın Kestrel 'in en büyük 
istek gövdesi boyutunu aştığını gösterir. Daha fazla bilgi için, Kestrel maksimum istek gövdesi boyutu bölümüne 
bakın. Kestrel istemci bağlantı limitleri de ayarlama gerektirebilir. 

Iformfile ile null başvuru özel durumu 

Denetleyici IFormFile kullanarak karşıya yüklenen dosyaları kabul ediyorsanız, ancak değer null , HTML 
formunun muitipart/form-data"enctype değerini belirtdiğini doğrulayın. Bu öznitelik <form> öğesinde 
ayarlanmamışsa, dosya karşıya yükleme gerçekleşmez ve herhangi bir bağlı IFormFile bağımsız değişken null . 
Ayrıca, form verilerinde karşıya yükleme adlandırmasının uygulamanın adlandırmayla eşleştiğindenemin olun. 

Akış çok uzun 

Bu konudaki örneklerde karşıya yüklenen dosyanın içeriğini tutmak için MemoryStream bağımlıdır. Bir 
Memorystream boyut limiti int.Maxvaiue . Uygulamanın dosya yükleme senaryosu, dosya içeriğinin 50 M B 'tan 
büyük olmasını gerektiriyorsa, karşıya yüklenen dosyanın içeriğini tutmak için tek bir MemoryStream kullanmayan 
alternatif bir yaklaşım kullanın. 

AS P.N ET Core, daha küçük dosyalar için arabellekli model bağlama ve daha büyük dosyalar için arabelleğe 
alınmamış akış kullanarak bir veya daha fazla dosyanın yüklenmesini destekler 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Güvenlik konuları 

Kullanıcılara bir sunucuya dosya yükleme yeteneği sağlarken dikkatli olun. Saldırganlar şunları deneyebilir: 

• Hizmet reddi saldırıları yürütün. 

• Virüsleri veya kötü amaçlı yazılımları karşıya yükleyin. 

• Ağları ve sunucuları diğer yollarla tehlikeye atabilir. 

Başarılı bir saldırının olasılığını azaltan güvenlik adımları şunlardır: 

• Dosyaları, tercihen sistem dışı bir sürücüye, özel bir dosya yükleme alanına yükleyin. Ayrılmış bir konum, karşıya 
yüklenen dosyalar üzerinde güvenlik kısıtlamaları yapmayı kolaylaştırır. Dosya yükleme konumunda yürütme 
izinlerini devre dışı bırakın.t 

• Karşıya yüklenen dosyaları uygulamayla aynı dizin ağacında kalıcı yapma .+ 

• Uygulama tarafından belirlenen bir güvenli dosya adı kullanın. Kullanıcı tarafından belirtilen bir dosya adı veya 
karşıya yüklenen dosyanın güvenilmeyen dosya adı kullanmayın.t HTML 'yi görüntülerken güvenilmeyen dosya 
adını kodlayın. Örneğin, dosya adını günlüğe kaydetme veya Kullanıcı arabiriminde görüntüleme (Razor 
otomatik olarak HTML kodlama çıkışı). 

• Uygulamanın tasarım belirtimi için yalnızca onaylanan dosya uzantılarına izin verin.t 

• Sunucuda istemci tarafı denetimlerinin gerçekleştirildiğinden emin olun.t İstemci tarafı denetimleri kolayca 
atlayabilirsiniz. 

• Karşıya yüklenen dosyanın boyutunu denetleyin. Büyük karşıya yüklemeleri engellemek için en büyük boyut 
sınırını ayarlayın.t 

• Aynı ada sahip karşıya yüklenen bir dosya tarafından dosyaların üzerine yazılmaması gerektiğinde, dosyayı 











karşıya yüklemeden önce dosya adını veritabanına veya fiziksel depolamaya göre denetleyin. 

• Dosya depolanmadan önce karşıya yüklenen içerik üzerinde bir virüs/kötü amaçlı yazılım tarayıcısı 
çalıştırın. 

örnek uygulama tölçütleri karşılayan bir yaklaşımı gösterir. 

VVARNING 

Kötü amaçlı bir kodun bir sisteme karşıya yükleme için kod yürütme için ilk adımı sık şöyledir: 

• Sistemin denetimini tamamen elde edin. 

• Sistemin kilitlenme sonucuyla bir sistemi aşırı yükleme. 

• Kullanıcı veya sistem verilerini tehlikeye. 

• Genel Kullanıcı arabirimine Graffiti uygulayın. 

Kullanıcıların dosyaları kabul ederken saldırı yüzey alanı azaltma hakkında daha fazla bilgi için aşağıdaki kaynaklara bakın: 

• Sınırsız dosya karşıya yükleme 

• Azure güvenlik: uygun denetimleri kullanıcıların dosyalan kabul ederken karşılandığından emin 


Örnek uygulamadaki örnekler de dahil olmak üzere güvenlik önlemlerini uygulama hakkında daha fazla bilgi için 
doğrulama bölümüne bakın. 

Depolama senaryoları 

Dosyalar için ortak depolama seçenekleri şunlardır: 

• Veritabanı 

o Küçük dosya yüklemeleri için, bir veritabanı genellikle fiziksel depolama (dosya sistemi veya ağ 
paylaşımından) seçeneklerinden daha hızlıdır. 

o Kullanıcı verileri için bir veritabanı kaydının alınması eşzamanlı olarak dosya içeriğini (örneğin, avatar 
görüntüsü) sağlayabildiğinden, veritabanı genellikle fiziksel depolama seçeneklerine göre daha uygundur, 
o Bir veritabanı, veri depolama hizmeti kullanmaktan daha ucuz olabilir. 

• Fiziksel depolama (dosya sistemi veya ağ paylaşma) 

o Büyük dosya yüklemeleri için: 

o Veritabanı limitleri karşıya yükleme boyutunu kısıtlayabilir. 

o Fiziksel depolama genellikle bir veritabanındaki depolamadan daha az ekonomik olur, 
o Fiziksel depolama, veri depolama hizmeti kullanmaktan daha ucuz olabilir. 

o Uygulamanın işlemi, depolama konumu için okuma ve yazma izinlerine sahip olmalıdır. Hiçbirzaman 
yürütme izni vermeyin. 

• Veri depolama hizmeti (örneğin, Azure Blob depolama) 

o Hizmetler genellikle tek hata noktalarına tabi olan şirket içi çözümler üzerinde geliştirilmiş 
ölçeklenebilirlik ve esneklik sunar. 

o Hizmetler büyük depolama altyapısı senaryolarında düşük maliyetlidir. 

Daha fazla bilgi için bkz. hızlı başlangıç: nesne depolamada blob oluşturmak için .NET kullanma. Konu 
UploadFromFileAsyncgösterir, ancak UploadFromStreamAsync bir Streamçalışırken blob depolamaya 
FileStream kaydetmek için kullanılabilir. 

Karşıya dosya yükleme senaryoları 

Dosyaları karşıya yüklemek için iki genel yaklaşım arabelleğe alınır ve akışlardır. 




Ara 


Dosyanın tamamı bir IFormFileokur, bu dosya dosyayı işlemek veya kaydetmek C# için kullanılan bir gösterimidir. 

Dosya karşıya yüklemeleri tarafından kullanılan kaynaklar (disk, bellek), eşzamanlı dosya karşıya yüklemelerinin 
sayısına ve boyutuna bağlıdır. Bir uygulama çok fazla karşıya yükleme arabelleğini denerse, bellek veya disk alanı 
tükenirse site çöker. Karşıya dosya yükleme boyutu veya sıklığı uygulama kaynaklarını tüketme ise, akış 1 ı kullanın. 


NOTE 

64 KB geçen tek bir arabelleğe alınmış dosya, bellekten diskte geçid bir dosyaya taşınır. 


Dosya arabelleğe alma, bu konunun aşağıdaki bölümlerinde ele alınmıştır: 

• Fiziksel depolama alanı 

• Veritabanı 

Akış 

Dosya çok parçalı bir istekten alınır ve doğrudan uygulama tarafından işlenir veya kaydedilir. Akış performansı 
önemli ölçüde iyileştirmez. Akış, dosya karşıya yüklenirken bellek veya disk alanı taleplerini azaltır. 

Akış büyük dosyaları akış ile büyük dosyaları karşıya yükle bölümünde ele alınmıştır. 

Fiziksel depolamaya arabellekli model bağlamaya sahip küçük dosyaları karşıya yükleme 

Küçük dosyaları karşıya yüklemek için, çok parçalı bir form kullanın veya JavaScript kullanarak bir POST isteği 
oluşturun. 

Aşağıdaki örnek, tek bir dosyayı karşıya yüklemek için bir Razor Pages formunun kullanımını gösterir (örnek 
uygu\arr\adaPages/Bufferedsirıglefileuploadfiziksel. cshtml): 

<form enctype="multipart/form-data" method="post"> 

<dl> 

<dt> 

clabel asp-for="Filellpload. FormFile"x/label> 

</dt> 

<dd> 

cinput asp-for="FileUpload.FormFile" type="file"> 

<span asp-validation-for="FileUpload. FormFile"x/span> 

</dd> 

</dl> 

cinput asp-page-handler="Upload" class="btn" type="submit" value="Upload" /> 

</form> 


Aşağıdaki örnek, önceki örneğe benzerdir, ancak şunları hariç: 

• Form verilerini göndermek için JavaScript (Fetch API) kullanılır. 

• Doğrulama yok. 




<form action="BufferedSingleFilellploadPhysical/?handler=Upload" 

enctype="multipart/form-data" onsubmit="A]AXSubmit(this);return false;" 
method="post"> 

<dl> 

<dt> 

<label for="FileUpload_FormFile">File</label> 

</dt> 

<dd> 

<input id="FileUpload_FormFile" type="file" 
name="Filellpload. FormFile" /> 

</dd> 

</dl> 

cinput class="btn" type="submit" value="Upload" /> 

<div style="margin-top:15px"> 

<output name="result"x/output> 

</div> 

</form> 

<script> 

async function ADAXSubmit (oFormElement) { 

var resultElement = oFormElement.elements.namedltem("result"); 
const formData = new FormData(oFormElement); 

try { 

const response = await fetch(oFormElement.action., { 
method: 'POST', 
body: formData 
}); 

if (response.ok) { 

window.location.href = 

} 

resultElement.value = ’Result: ' + response.status +''+ 
response.statusText; 

} catch (error) { 

console.error('Error: ', error); 

} 

} 

</script> 


Fetch API 'sini desteklemeyenistemcilerde form gönderisini JavaScript 'te gerçekleştirmek için aşağıdaki 
yaklaşımlardan birini kullanın: 

• Fetch Polyfill kullanın (örneğin, Window. Fetch (GitPIub/fetch)). 

• XMLHttpRequest kullanın. Örneğin: 

<script> 

"use strict"; 

function ADAXSubmit (oFormElement) { 
var oReq = new XMLHttpRequest(); 
oReq.onload = function(e) { 

oFormElement.elements.namedltem("result").value = 

’Result: ' + this.status + ' ' + this.statusText; 

}J 

oReq.öpen("post", oFormElement.action); 
oReq.send(new FormData(oFormElement)); 

} 

</script> 



Dosya yüklemelerini desteklemek için, HTML formları muitipart/form-data bir kodlama türü ( enctype ) 
belirtmelidir. 

Birden çok dosyayı karşıya yüklemeyi desteklemek için fileş giriş öğesi için, <input> öğesinde multiple 
özniteliğini sağlayın: 

cinput asp-for="FileUpload.FormFiles" type="file" multiple> 

Sunucuya yüklenen tek dosyalara IFormFilekullanılarak model bağlama yoluyla erişilebilir. Örnek uygulama, 
veritabanı ve fiziksel depolama senaryoları için birden çok arabellekli dosya yüklemeyi gösterir. 


VVARNING 

Görüntüleme ve günlüğe kaydetme için dışında IFormFile FileName özelliğini kullanmayın. Görüntüleme veya günlüğe 
kaydetme sırasında, HTML dosya adını kodlayın. Saldırgan, tam yollar veya göreli yollar dahil olmak üzere kötü amaçlı bir 
dosya adı sağlayabilir. Uygulamalar: 

• Kullanıcı tarafından sağlanan dosya adının yolunu kaldırın. 

• Kullanıcı arabirimi veya günlüğe kaydetme için HTML kodlu, yol tarafından kaldırılan dosya adını kaydedin. 

• Depolama için yeni bir rastgele dosya adı oluşturun. 

Aşağıdaki kod, dosya adından yolu kaldırır: 

string untrustedFileName = Path.GetFileName(pathName)j 

Bu nedenle, şu ana kadar dikkate alınması gereken örnekler aşağıda verilmiştir. Ek bilgiler aşağıdaki bölümler ve örnek 
uygulamatarafından sağlanır: 

• Güvenlik konuları 

• Doğrulama 


Model bağlama ve IFormFilekullanarak dosya karşıya yüklerken, eylem yöntemi şunları kabul edebilir: 

• Tek bir IFormFile. 

• Birkaç dosyayı temsil eden aşağıdaki koleksiyonlardan herhangi biri: 
o IFormFileCollection 

o IEnumerable<IFormFile> 
o Liste<IFormFile> 


NOTE 

Bağlama, form dosyaları adına göre eşleşir.Örneğin, <input type="file" name="formFlle"> HTML name değeri C# 
parametre/özellik ile ( FormFile ) eşleşmelidir. Daha fazla bilgi için, ad öznitelik DEĞERİNİ Post yönteminin parametre adına 
eşleştirin bölümüne bakın. 


Aşağıdaki örnek: 

• Karşıya yüklenen bir veya daha fazla dosya üzerinden döngü. 

• Dosya adı da dahil olmak üzere bir dosyanın tam yolunu döndürmek için Path. GetTempFileName kullanır. 

• Dosyalar, uygulama tarafından oluşturulan bir dosya adı kullanılarak yerel dosya sistemine kaydedilir. 

• Karşıya yüklenen dosyaların toplam sayısını ve boyutunu döndürür. 












public async Task<IActionResult> OnPostUploadAsync(List<IFormFile> fileş) 

{ 

long size = fileş.Sum(f => f.Length); 

foreach (var formFile in fileş) 

{ 

if (formFile.Length > 0) 

{ 

var filePath = Path.GetTempFileName(); 

using (var stream = System.10.File.Create(filePath)) 

{ 

await formFile.CopyToAsync(stream); 

} 

} 

} 

// Process uploaded fileş 

// Don't rely on or trust the FileName property without validation. 
return Ok(new { count = fileş.Countj size, filePath }); 

} 

Yol olmadan bir dosya adı oluşturmak için Path.GetRandomFileName kullanın. Aşağıdaki örnekte, yol 
yapılandırmadan alınır: 

foreach (var formFile in fileş) 

{ 

if (formFile.Length > 0) 

{ 

var filePath = Path.Combine(_config["StoredFilesPath "], 

Path.GetRandomFileName()); 

using (var stream = System.10.File.Create(filePath)) 

{ 

await formFile.CopyToAsync(stream); 

} 

} 

} 

FileStream geçirilen yol, dosya adını içermelidir. Dosya adı sağlanmazsa, çalışma zamanında bir 
UnauthorizedAccessException oluşturulur. 

IFormFile tekniği kullanılarak yüklenen dosyalar, işlemeden önce sunucuda veya diskte bellek halinde arabelleğe 
alınır. Eylem yönteminde, IFormFile içeriğe Streamolarak erişilebilir. Yerel dosya sistemine ek olarak, dosyalar bir ağ 
paylaşımında veya Azure Blob depolamagibi bir dosya depolama hizmetine kaydedilebilir. 

Karşıya yüklemek için birden çok dosya üzerinde döngü yapan ve güvenli dosya adları kullanan başka bir örnek 
için, örnek uygulamadaki Pages/Bufferedmultiplefileuploadfiziksel. cshtml. cs dosyasına bakın. 


VVARNING 

Path. GetTempFileName , önceki geçici dosyaları silmeden 65.535 'den fazla dosya oluşturulduysa bir IOException oluşturur. 
65.535 dosya sınırının sunucu başına sınırı vardır. Windows işletim sistemi için bu sınır hakkında daha fazla bilgi için aşağıdaki 
konulara bakın: 

• GetTempFileNameA işlevi 

• GetTempFileName 


Bir veritabanına arabellekli model bağlamaya sahip küçük dosyaları karşıya yükleme 







ikili dosya verilerini Entity Framevvorkkullanarak bir veritabanında depolamak için, varlıkta bir Byte Array özelliği 
tanımlayın: 

public class AppFile 

{ 

public int Id { get; set; } 
public byte[] Content { get; set; } 

} 


Bir IFormFileiçeren sınıf için bir sayfa modeli özelliği belirtin: 

public class BufferedSingleFileUploadDbModel : PageModel 

{ 


[BindProperty] 

public BufferedSingleFileUploadDb FileLIpload { get; set; } 


} 

public class BufferedSingleFileUploadDb 

{ 

[Required] 

[Display(Name="File")] 

public IFormFile FormFile { get; set; } 

} 



<dl> 

<dt> 

clabel asp-for="FileUpload. FormFile"x/label> 

</dt> 

<dd> 

<input asp-for="FileUpload.FormFile" type="file"> 

</dd> 

</dl> 

<input asp-page-handler="Upload" class="btn" type="submit" value="Upload"> 
</form> 


Form sunucuya gönderildiğinde, IFormFile bir akışa kopyalayın ve veritabanına bir bayt dizisi olarak kaydedin. 
Aşağıdaki örnekte, uygulamanın veritabanı bağlamını _dbContext depolar: 






public async Task<IActionResult> OnPostUploadAsync() 

{ 

using (var memoryStream = new MemoryStream()) 

{ 

await FileUpload.FormFile.CopyToAsync(memoryStream); 

// Upload the file if less than 2 MB 
if (memoryStream.Length < 2097152) 

{ 

var file = new AppFile() 

{ 

Content = memoryStream.ToArray() 

}; 

_dbContext.File.Add(file); 

await _dbContext.SaveChangesAsync(); 

} 

else 

{ 

ModelState.AddModelError("File"j "The file is too large."); 

} 

} 

return Page(); 

} 

Yukarıdaki örnek, örnek uygulamada gösterilen senaryoya benzerdir: 

• Pages/BufferedSingleFileUploadDb. cshtml 

• Pages/BufferedSingleFileUploadDb. cshtml. cs 


VVARNING 

ikili verileri ilişkisel veritabanlarında depolarken dikkatli olun, çünkü performansı olumsuz etkileyebilir. 

Doğrulaması olmadan IFormFile FileName özelliğine güvenmeyin veya güvenmeyin. FileName özelliği yalnızca 
görüntüleme amacıyla ve yalnızca HTML kodlaması sonrasında kullanılmalıdır. 

Belirtilen örneklerde dikkate alınması gereken önemli noktalar. Ek bilgiler aşağıdaki bölümler ve örnek uygulamatarafından 
sağlanır: 

• Güvenlik konuları 

• Doğrulama 


Akışa sahip büyük dosyaları karşıya yükleme 

Aşağıdaki örnek, bir denetleyiciyi bir denetleyici eyleminde akışa almak için JavaScript 'in nasıl kullanılacağını 
gösterir. Dosyanın antiforgery belirteci özel bir filtre özniteliği kullanılarak oluşturulur ve istek gövdesi yerine 
istemci HTTP üst bilgilerine geçirilir. Eylem yöntemi karşıya yüklenen verileri doğrudan işlediğinden, form modeli 
bağlama başka bir özel filtre tarafından devre dışı bırakıldı. Eylem içinde formun içerikleri, her bir Muitipartsection 
okuyan, dosyayı işleyen veya içeriği uygun şekilde depolayan bir MuitipartReader kullanılarak okunur. Çok parçalı 
bölümler okunduktan sonra eylem kendi model bağlamasını gerçekleştirir. 

ilk sayfa yanıtı formu yükler ve bir tanımlama bilgisine ( GenerateAntiforgeryTokenCookieAttribute özniteliği 
aracılığıyla) bir antiforgery belirteci kaydeder. Öznitelik, bir istek belirtecine sahip bir tanımlama bilgisi ayarlamak 
için AS P.N ET Core yerleşik antiforgery desteğini kullanır: 







public class GenerateAntiforgeryTokenCookieAttribute : ResultFilterAttribute 

{ 

public override void OnResultExecuting(ResultExecutingContext context) 

{ 

var antiforgery = context.HttpContext.RequestServices.GetService<IAntiforgery>(); 

// Send the request token as a JavaScript-readable cookie 

var tokens = antiforgery.GetAndStoreTokens(context.HttpContext); 

context.HttpContext.Response.Cookies.Append( 

"RequestVerificationToken ", 
tokens.RequestToken, 

new CookieOptions() { HttpOnly = false }); 

} 

public override void OnResultExecuted(ResultExecutedContext context) 

{ 

} 

} 

Model bağlamayı devre dışı bırakmak için DisableFormValueModelBindingAttribute kullanılır: 

[Attributellsage(AttributeTargets.Class | AttributeTargets.Method)] 

public class DisableFormValueModelBindingAttribute : Attribute, IResourceFilter 

{ 

public void OnResourceExecuting(ResourceExecutingContext context) 

{ 

var factories = context.ValueProviderFactories; 
factories.RemoveType<FormValueProviderFactory>(); 
factories.RemoveTypeOQueryFormValueProviderFactory>(); 

} 

public void OnResourceExecuted(ResourceExecutedContext context) 

{ 

} 

} 


Örnek uygulamada GenerateAntiforgeryTokenCookieAttribute 

ve DisableFormValueModelBindingAttribute , 

startup.ConfigureServices kurallarıkullanılarak Razor Pages 

/StreamedSingleFileUploadDb ve 

/streamedSingleFileuploadPhysicai sayfa uygulama modellerine filtre olarak uygulanır: 





Services. AddMvc() 

.AddRazorPagesOptions(options => 

{ 

options.Conventions 

.AddPageApplicationModelConvention("/StreamedSingleFileUploadDb", 
model => 

{ 

model.Filters.Add( 

new GenerateAntiforgeryTokenCookieAttribute()); 
model.Filters.Add( 

new DisableFormValueModelBindingAttribute()); 

}); 

options.Conventions 

.AddPageApplicationModelConvention("/StreamedSingleFileUploadPhysical", 
model => 

{ 

model.Filters.Add( 

new GenerateAntiforgeryTokenCookieAttribute()); 
model.Filters.Add( 

new DisableFormValueModelBindingAttribute()); 

}); 

}) 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


Model bağlama formu okumadığından formdan bağlanan parametreler bağlanamaz (sorgu, yol ve başlık çalışmaya 
devam eder). Action yöntemi doğrudan Request özelliği ile birlikte çalışabilir. Her bölümü okumak için bir 
MuitipartReader kullanılır. Anahtar/değer verileri bir KeyvaiueAccumuiator depolanır. Çok parçalı bölümler 
okunduktan sonra, KeyvalueAccumulator içeriği form verilerini bir model türüne bağlamak için kullanılır. 

EF Core ile bir veritabanına akışa yönelik tüm streamingControiier.uploadDatabase yöntemi: 

[HttpPost] 

[DisableFormValueModelBinding] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> UploadDatabase() 

{ 

if (!MultipartRequestHelper.IsMultipartContentType(Request.ContentType)) 

{ 

ModelState.AddModelError("File", 

$"The request couldn't be pnocessed (Error 1)."); 

// Log ernor 

return BadRequest(ModelState); 

} 

// Accumulate the form data key-value pairs İn the request (formAccumulator). 
var formAccumulator = new KeyValueAccumulator(); 
var trustedFileNameForDisplay = string.Empty; 
var untrustedFileNameForStorage = string.Empty; 
var streamedFileContent = new byte[0]; 

var boundary = MultipartRequestHelper.GetBoundary( 

MediaTypeHeaderValue.Parse(Request.ContentType), 

_defaultFormOptions.MultipartBoundaryLengthLimit); 
var reader = new MultipartReader(boundary, HttpContext.Request.Body); 

var section = await reader.ReadNextSectionAsync(); 

while (section != null) 

{ 

var hasContentDispositionHeader = 

ContentDispositionHeaderValue.TryParse( 

section.ContentDisposition, out var contentDisposition); 


if (hasContentDispositionHeader) 








if (MultipartRequestHelper 

.HasFileContentDisposition(contentDisposition)) 

{ 

untrustedFileNameForStorage = contentDisposition.FileName.Value; 

// Don't trust the file name sent by the Client. To display 
// the file name, HTML-encode the value. 
trustedFileNameForDisplay = WebUtility.HtmlEncode( 
contentDisposition. FileName. Value); 

streamedFileContent = 

await FileHelpers.ProcessStreamedFile(section, contentDisposition, 
ModelState, _permittedExtensions, _fileSizeLimit); 

if (IModelState.IsValid) 

{ 

return BadRequest(ModelState); 

} 

} 

else if (MultipartRequestFlelper 

.HasFormDataContentDisposition(contentDisposition)) 

{ 

// Don't limit the key name length because the 
// multipart headers length limit is already in effect. 
var key = FleaderUtilities 

. RemoveQuot es (contentDisposition .Name) .Value; 
var encoding = GetEncoding(section); 

if (encoding == null) 

{ 

ModelState.AddModelError("File", 

$"The request couldn't be processed (Error 2)."); 

// Log error 

return BadRequest(ModelState); 

} 

using (var streamReader = new StreamReader( 
section.Body, 
encoding, 

detectEncodingFromByteOrderMarks: true, 
bufferSize: 1024, 
leaveOpen: true)) 

{ 

// The value length limit is enforced by 
// MultipartBodyLengthLimit 

var value = await streamReader.ReadToEndAsync(); 

if (string.Equals(value, "undefined", 
StringComparison.OrdinalIgnoreCase)) 

{ 

value = string.Empty; 

} 

formAccumulator.Append(key, value); 

if (formAccumulator.ValueCount > 

_defaultFormOptions.ValueCountLimit) 

{ 

// Form key count limit of 
// _defaultFormOptions.ValueCountLimit 
// is exceeded. 

ModelState.AddModelError("File", 

$"The request couldn't be processed (Error 3)."); 

// Log error 

return BadRequest(ModelState); 

} 


} 

} 

// Drain any remaining section body that hasn't been consumed and 
// read the headers for the next section. 
section = await reader.ReadNextSectionAsync(); 

} 

// Bind form data to the model 
var formData = new FormData(); 
var formValueProvider = new FormValueProvider( 

BindingSource.Form, 

new FormCollection(formAccumulator.GetResults ()), 
Culturelnfo.CurrentCulture); 

var bindingSuccessful = await TryllpdateModelAsync(formData., prefix: 
valueProvider: formValueProvider); 

if (!bindingSuccessful) 

{ 

ModelState.AddModelError("File ", 

"The request couldn't be processed (Error 5)."); 

// Log error 

return BadRequest(ModelState); 

} 

// **WARNING!** 

// In the following example, the file is saved without 
// scanning the file's contents. In most production 
// scenarios, an anti-virus/anti-malware scanner API 
// is used on the file before making the file available 
// for download or for use by other Systems. 

// For more information, see the topic that accompanies 
// this sample app. 

var file = new AppFile() 

{ 

Content = streamedFileContentj 
UntrustedName = untrustedFileNameForStorage, 

Note = formData.Note, 

Size = streamedFileContent.Length, 

UploadDT = DateTime.UtcNow 

}; 

_context.File.Add(file); 

await _context.SaveChangesAsync(); 

return Created(nameof(StreamingController ), null); 


MuitipartRequestHeiper (Utilities/MultipartRequestHelper. cs ): 


using System; 
using System.10; 

using Microsoft.Net.Http.Headers; 

namespace SampleApp.Utilities 

{ 

public static class MultipartRequestHelper 

{ 

// Content-Type: multipart/form-data; boundary="-WebKitFormBoundarymx2fSWqWSd0OxQqq" 

// The spec at https://tools.ietf.Org/html/rfc2046#section-5.l States that 70 characters is a 
reasonable limit. 

public static string GetBoundary(MediaTypeHeaderValue contentType, int lengthLimit) 

{ 

var boundary = HeaderUtilities.RemoveQuotes(contentType.Boundary).Value; 

if (string.IsNullOrWhiteSpace(boundary)) 

{ 

throw new InvalidDataException("Missing content-type boundary."); 

} 

if (boundary.Length > lengthLimit) 

{ 

throw new InvalidDataException( 

$"Multipart boundary length limit {lengthLimit} exceeded."); 

} 

return boundary; 

} 

public static bool IsMultipartContentType(string contentType) 

{ 

return !string.IsNullOrEmpty(contentType) 

&& contentType.IndexOf("multipart/"j StringComparison.OrdinalIgnoreCase) >= 0; 

} 

public static bool HasFormDataContentOisposition(ContentDispositionHeaderValue contentDisposition) 

{ 

// Content-Disposition: form-data; name="key"; 
return contentDisposition != null 

&& contentDisposition.DispositionType.Equals("form-data") 

&& string.IsNullOrEmpty(contentDisposition.FileName.Value) 

&& string.IsNullOrEmpty(contentDisposition.FileNameStar.Value); 

} 


} 


} 


public static bool HasFileContentDisposition(ContentDispositionHeaderValue contentDisposition) 

{ 

// Content-Disposition: form-data; name="myfilel"; filename="Misc 002.jpg" 
return contentDisposition != null 

&& contentDisposition.DispositionType.Equals("form-data") 

&& (!string.IsNullOrEmpty(contentDisposition.FileName.Value) 

| !string.IsNullOrEmpty(contentDisposition.FileNameStar.Value)); 

} 


Fiziksel bir konuma akışa yönelik tüm streamingControiier.uploadPhysicai yöntemi: 

[FlttpPost] 

[DisableFormValueModelBinding] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> UploadPhysical() 

{ 

if (!MultipartRequestFlelper.IsMultipartContentType(Request .ContentType)) 

{ 

ModelState.AddModelError("File ", 

$"The request couldn't be processed (Error 1)."); 




// Log error 


return BadRequest(ModelState); 

} 

var boundary = MultipartRequestHelper.GetBoundary( 

MediaTypeHeaderValue.Parse(Request. ContentType), 

_defaultFormOptions.MuitipartBoundaryLengthLimit); 
var reader = new MultipartReader(boundary, HttpContext.Request.Body); 
var section = await reader.ReadNextSectionAsync(); 

while (section != null) 

{ 

var hasContentDispositionHeader = 

ContentDispositionHeaderValue.TryParse( 

section.ContentDisposition, out var contentDisposition); 

if (hasContentDispositionHeader) 

{ 

// This check assumes that there's a file 
// present without form data. If form data 
// is present, this method immediately fails 
// and returns the model error. 
if (!MultipartRequestHelper 

.HasFileContentDisposition(contentDisposition)) 

{ 

ModelState.AddModelError("File", 

$"The request couldn't be processed (Error 2)."); 

// Log error 

return BadRequest(ModelState); 

} 

else 

{ 

// Don't trust the file name sent by the Client. To display 
// the file name, HTML-encode the value. 
var trustedFileNameForDisplay = WebUtility.HtmlEncode( 
contentDisposition. FileName. Value); 
var trustedFileNameForFileStorage = Path.GetRandomFileName(); 

// **WARNING!** 

// In the following example, the file is saved without 
// scanning the file's contents. In most production 
// scenarios, an anti-virus/anti-malware scanner API 
// is used on the file before making the file available 
// for download or for use by other Systems. 

// For more information, see the topic that accompanies 
// this sample. 

var streamedFileContent = await FileHelpers.ProcessStreamedFile( 
section, contentDisposition, ModelState, 

_permittedExtensions, _fileSizeLimit); 

if (İModelState.IsValid) 

{ 

return BadRequest(ModelState); 

} 

using (var targetStream = System.10.File.Create( 

Path.Combine(_targetFilePath, trustedFileNameForFileStorage))) 

{ 

await targetStream.WriteAsync(streamedFileContent); 

_logger.LogInformation( 

"Uploaded file '{TrustedFileNameForDisplay}' saved to " + 

"'{TargetFilePath}' as {TrustedFileNameForFileStorage}", 
trustedFileNameForDisplay, _targetFilePath, 
trustedFileNameForFileStorage); 

} 


} 

} 

// Drain any remaining section body that hasn't been consumed and 
// read the headers for the next section. 
section = await reader.ReadNextSectionAsync(); 

} 

return Created(nameof(StreamingController ), null); 

} 

Örnek uygulamada, doğrulama denetimleri FileHelpers.ProcessstreamedFile tarafından işlenir. 

Doğrulama 

Örnek uygulamanın FileHelpers sınıfı, arabelleğe alınmış IFormFile ve akış dosya yüklemeleri için birkaç denetim 
gösterir. Örnek uygulamada arabelleğe alınmış IFormFile dosya yüklemelerini işlemek için, Utilities/Fileycırdımalar. 
cs dosyasındaki ProcessFormFile yöntemine bakın. Akış dosyalarını işlemek için aynı dosyadaki 
ProcessstreamedFiie yöntemine bakın. 


VVARNING 

Örnek uygulamada gösterilen doğrulama işleme yöntemleri karşıya yüklenen dosyaların içeriğini taramaz. Çoğu üretim 
senaryosunda, dosyanın kullanıcılara veya diğer sistemlere kullanılabilir hale getirilmesi için dosya üzerinde bir virüs/kötü 
amaçlı yazılım tarayıcı API 'SI kullanılır. 

Konu örneği, doğrulama tekniklerine yönelik çalışan bir örnek sağlasa da şunları gerçekleştirmediğiniz takdirde bir üretim 
uygulamasında FileHelpers sınıfını uygulamayın: 

• Uygulamayı tam olarak anlayın. 

• Uygulamayı uygulamanın ortamı ve belirtimleri için uygun şekilde değiştirin. 

Bu gereksinimleri bilmeden bir uygulamada güvenlik kodunu hiçbir şekilde sayısının fark gözetmeden uygulayın. 


İçerik doğrulama 

Karşıya yüklenen içerikte üçüncü taraf bir virüs/kötü amaçlı yazılım tarama API 'SI kullanın. 

Dosyaları tarama, yüksek hacimli senaryolarda sunucu kaynaklarında yoğun bir şekilde yapılır. Dosya tarama 
nedeniyle istek işleme performansı azaldığında, tarama işini, muhtemelen uygulamanın sunucusundan farklı bir 
sunucuda çalışan bir arka plan hizmetinedevredere göz önünde bulundurun. Genellikle, arka plan virüs tarayıcısı 
tarafından denetlene kadar karşıya yüklenen dosyalar karantinaya alınmış bir alanda tutulur. Bir dosya geçtiğinde 
dosya normal dosya depolama konumuna taşınır. Bu adımlar genellikle bir dosyanın tarama durumunu gösteren 
bir veritabanı kaydıyla birlikte gerçekleştirilir. Böyle bir yaklaşım kullanarak, uygulama ve uygulama sunucusu 
isteklere yanıt vermeye odaklanmaya devam eder. 

Dosya Uzantısı doğrulaması 

Karşıya yüklenen dosyanın uzantısı izin verilen uzantılar listesine göre denetlenmelidir.Örneğin: 

private string[] permittedExtensions = { ",txt", ".pdf" }; 

var ext = Path.GetExtension(uploadedFileName) .Tol_owerInvariant(); 

if (string.IsNullOrEmpty(ext) || !permittedExtensions.Contains(ext)) 

{ 

// The extension is invalid ... discontinue Processing the file 

} 








Dosya imzası doğrulaması 

Bir dosyanın imzası, bir dosyanın başlangıcında ilk birkaç bayta göre belirlenir. Bu baytlar, uzantının dosyanın 
içeriğiyle eşleşip eşleşmediğini göstermek için kullanılabilir. Örnek uygulama, birkaç ortak dosya türü için dosya 
imzalarını denetler. Aşağıdaki örnekte, bir JPEG görüntüsünün dosya imzası, dosyaya karşı denetlenir: 

private static readonly Dictionary<string, List<byte[]>> _fileSignature = 
new Dictionary<string, List<byte[]>> 

{ 

{ ".jpeg", new List<byte[]> 

{ 

new byte[] { 0xFF, 0xD8, 0xFF, 0xE0 }, 

new byte[] { 0xFF, 0xD8, 0xFF, 0xE2 }, 

new byte[] { 0xFF, 0xD8, 0xFF, 0xE3 }, 

} 

}, 

}; 

using (var reader = new BinaryReader(uploadedFileData)) 

{ 

var signatures = _fileSignature[ext]; 

var headerBytes = reader.ReadBytes(signatures.Max(m => m.Length)); 

return signatures.Any(signature => 

headerBytes.Take(signature.Length).SequenceEqual(signature)); 

} 


Ek dosya imzaları almak için Dosya İmzaları veritabanı ve resmi dosya belirtimleri bölümüne bakın. 

Dosya adı güvenliği 

Fiziksel depolamaya bir dosyayı kaydetmek için hiçbir şekilde istemci tarafından sağlanan dosya adı kullanmayın. 
Geçici depolama için tam yol (dosya adı da dahil olmak üzere) oluşturmak için Path. GetRandomFileName veya 
Path. GetTempFileName kullanarak dosya için güvenli bir dosya adı oluşturun. 

Razor otomatik olarak HTML, görüntüleme için özellik değerlerini kodlar.Aşağıdaki kodun kullanımı güvenlidir: 

(Şforeach (var file in Model.DatabaseFiles) { 

<tr> 

<td> 

@f ile.UntrustedName 
</td> 

</tr> 

} 


Razor dışında, her zaman bir kullanıcının isteğinden dosya adı içeriği HtmlEncode. 

Birçok uygulama, dosyanın var olduğunu bir denetim içermelidir; Aksi takdirde, dosyanın üzerine aynı ada sahip bir 
dosya yazılır. Uygulamanızın belirtimlerini karşılamak için ek mantık sağlayın. 

Boyut doğrulaması 

Karşıya yüklenen dosyaların boyutunu sınırlayın. 

Örnek uygulamada, dosyanın boyutu 2 MB ile sınırlıdır (bayt cinsinden gösterilir). Sınır, appSettings. JSON 
dosyasındaki yapılandırma yoluyla sağlanır: 

{ 

"FileSizeLimit": 2097152 

} 

FileSizeLimit PageModei sınıflarına eklenmiş: 





public class BufferedSingleFileUploadPhysicalModel : PageModel 
{ 

private readonly long _fileSizeLimit; 

public BufferedSingleFileUploadPhysicalModel(IConfiguration config) 
{ 

_fileSizeLimit = config.GetValue<long>("FileSizel_imit"); 

} 


} 

Dosya boyutu sınırı aştığında, dosya reddedilir: 

if (formFile.Length > _fileSizeLimit) 

{ 

// The file is too large ... discontinue processing the file 

} 

Name öznitelik değerini POST yönteminin Parameteradı ile Eşleştir 

Form verileri oluşturan veya JavaScript 'in FormData doğrudan kullanan Razor olmayan formlarda, formun 
öğesinde veya FormData belirtilen adın, denetleyicinin eyleminde parametrenin adıyla eşleşmesi gerekir. 

Aşağıdaki örnekte: 


• Bir <input> öğesi kullanılırken, name özniteliği battiePlans değere ayarlanır: 


cinput type="file" name= 

"battiePlans" multiple> 


JavaScript içinde 

FormData 

kullanırken ad, 

battiePlans değer olarak ayarlanır: 


var formData = new FormData(); 


for (var file in fileş) { 

formData.append("battlePlans", file, file.name); 

} 


C# Yöntemin parametresi için eşleşen bir ad kullanın ( battiePlans ): 

• upload adlı Razor Pages sayfa işleyicisi yöntemi için: 

public async Task<IActionResult> OnPostUploadAsync(List<IFormFile> battiePlans) 

• MVC POST denetleyicisi eylem yöntemi için: 

public async Task<IActionResult> Post(List<IFormFile> battiePlans) 


Sunucu ve uygulama yapılandırması 

Çok parçalı gövde uzunluğu sınırı 

MultipartBodyLengthLimit her bir çok parçalı gövdenin uzunluğu için sınır ayarlar. Bu sınırı aşan form bölümleri 
ayrıştırdığında bir lnvalidDataException oluşturur. Varsayılan değer 134.217.728 ' dir (128 MB). 
start up.configureServices MultipartBodyLengthLimit ayarını kullanarak sınırı özelleştirin: 















public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<FormOptions>(options => 

{ 

// Set the limit to 256 MB 

options.MultipartBodyLengthLimit = 268435456; 

}); 


RequestFormLimitsAttribute, tek sayfa veya eylem için MultipartBodyLengthLimit ayarlamak üzere kullanılır. 
Razor Pages bir uygulamada, filtreyi startup.configureServices bir kurala uygulayın: 

Services. AddMvc() 

.AddRazorPagesOptions(options => 

{ 

options.Conventions 

.AddPageApplicationModelConvention("/FileUploadPage ", 
model.Filters.Add( 

new RequestFormLimitsAttribute() 

{ 

// Set the limit to 256 MB 
MultipartBodyLengthLimit = 268435456 

}); 

}) 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


Razor Pages bir uygulamada veya bir MVC uygulamasında, filtreyi sayfa modeline veya eylem yöntemine 
uygulayın: 

// Set the limit to 256 MB 

[RequestFormLimits(MultipartBodyLengthLimit = 268435456)] 
public class BufferedSingleFileUploadPhysicalModel : PageModel 
{ 

} 


Kestrel maksimum istek gövdesi boyutu 

Kestrel tarafından barındırılan uygulamalar için, varsayılan en büyük istek gövdesi boyutu 30.000.000 bayttır ve bu, 
yaklaşık 28,6 MB 'tır. MaxRequestBodySize Kestrel Server seçeneğini kullanarak sınırı özelleştirin: 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 

UebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.ConfigureKestrel((context, options) => 

{ 

// Handle requests up to 50 MB 

options.Limits.MaxRequestBodySize = 52428800; 

}); 


RequestSizeLimitAttribute, tek sayfa veya eylem için MaxRequestBodySize ayarlamak üzere kullanılır. 
Razor Pages bir uygulamada, filtreyi Startup.configureServices bir kurala uygulayın: 






Services. AddMvc() 

.AddRazorPagesOptions(options => 

{ 

options.Conventions 

.AddPageApplicationModelConvention("/FileUploadPage ", 
model => 

{ 

// Handle requests up to 50 MB 
model.Filters.Add( 

new RequestSizeLimitAttribute(52428800)); 

}); 

}) 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


Bir Razor sayfalan uygulamasında veya bir MVC uygulamasında, filtreyi sayfa işleyici sınıfına veya eylem 
yöntemine uygulayın: 

// Handle requests up to 50 MB 
[RequestSizeLimit(52428800)] 

public class BufferedSingleFileUploadPhysicalModel : PageModel 
{ 

} 


Diğer Kestrel limitleri 

Kestrel tarafından barındırılan uygulamalar için diğer Kestrel limitleri de uygulanabilir: 

• istemci bağlantıları üst sınırı 

• istek ve yanıt veri ücretleri 

IIS içerik uzunluğu sınırı 

Varsayılan istek sınırı ( maxAiiowedContentı_ength ), yaklaşık 28.6 MB olan 30.000.000 bayttır. Web. config dosyasında 
sınırı özelleştirin: 

<system.webServer> 

<security> 

<requestFiltering> 

<!-- Handle requests up to 50 MB --> 

<requestl_imits maxAllowedContentLength="52428800" /> 

</requestFiltering> 

</security> 

</system.webServer> 


Bu ayar yalnızca IIS için geçerlidir. Kestrel üzerinde barındırırken davranış varsayılan olarak gerçekleşmez. Daha 
fazla bilgi için bkz. İstek limitleri <requestLimits >. 

ASP.NET Core modülündeki sınırlamalar veya IIS İstek filtreleme modülünün varlığı, karşıya yüklemeleri 2 veya 4 
GB ile sınırlandırabilir. Daha fazla bilgi için bkz. 2 GB 'tan büyük dosya karşıya yüklenemiyor 
(AS P N ET/AspN etCore #2711). 

Sorunları Gider 

Dosyaları karşıya yükleme ve olası çözümleri ile çalışırken karşılaşılan bazı yaygın sorunlar aşağıda verilmiştir. 

Bir MS sunucusuna dağıtılırken bulunamadı hatası 

Aşağıdaki hata karşıya yüklenen dosyanın, sunucunun yapılandırılmış içerik uzunluğunu aştığını gösterir: 





HTTP 404.13 - Not Found 

The request filtering modüle is configured to deny a request that exceeds the nequest content length. 

Limiti artırma hakkında daha fazla bilgi için bkz. IIS içerik uzunluğu sınırı bölümü. 

Bağlantı hatası 

Bir bağlantı hatası ve bir sıfırlama sunucu bağlantısı büyük olasılıkla karşıya yüklenen dosyanın Kestrel 'in en büyük 
istek gövdesi boyutunu aştığını gösterir. Daha fazla bilgi için, Kestrel maksimum istek gövdesi boyutu bölümüne 
bakın. Kestrel istemci bağlantı limitleri de ayarlama gerektirebilir. 

Iformfile ile null başvuru özel durumu 

Denetleyici IFormFile kullanarak karşıya yüklenen dosyaları kabul ediyorsanız, ancak değer null , HTML 
formunun muitipart/form-data"enctype değerini belirtdiğini doğrulayın. Bu öznitelik <fonm> öğesinde 
ayarlanmamışsa, dosya karşıya yükleme gerçekleşmez ve herhangi bir bağlı IFormFile bağımsız değişken null . 
Ayrıca, form verilerinde karşıya yükleme adlandırmasının uygulamanın adlandırmayla eşleştiğindenemin olun. 

Akış çok uzun 

Bu konudaki örneklerde karşıya yüklenen dosyanın içeriğini tutmak için MemoryStream bağımlıdır. Bir 
MemoryStream boyut limiti int.MaxVaiue . Uygulamanın dosya yükleme senaryosu, dosya içeriğinin 50 M B 'tan 
büyük olmasını gerektiriyorsa, karşıya yüklenen dosyanın içeriğini tutmak için tek bir MemoryStream kullanmayan 
alternatif bir yaklaşım kullanın. 

Ek kaynaklar 

• Sınırsız dosya karşıya yükleme 

• Azure güvenliği: güvenlik çerçevesi: giriş doğrulaması | Karşı 

• Azure bulut tasarım desenleri: Valet anahtar düzeni 
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Tarafından Rick Anderson 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Uygulama bölümü , bir uygulamanın kaynakları üzerinde soyutlamadır. Uygulama bölümleri AS P.N ET Core 
denetleyicileri bulmasına, bileşenleri, etiket yardımcılarını, Razor Pages, Razor derleme kaynaklarını ve daha 
fazlasını bulmasına olanak tanır. AssemblyPart bir uygulama bölümüdür. AssembiyPart bir derleme başvurusunu 
kapsüller ve türleri ve derleme başvurularını ortaya koyar. 

Özellik sağlayıcıları , uygulama bölümleriyle birlikte çalışarak bir ASP.NET Core uygulamasının özelliklerini 
doldurur. Uygulama bölümleri için ana kullanım örneği, bir derlemeyi, bir derlemeden ASP.NET Core özellikleri 
bulacak (ya da yüklemeden kaçınacak) şekilde yapılandırmaktır. Örneğin, birden çok uygulama arasında ortak 
işlevselliği paylaşmak isteyebilirsiniz. Uygulama parçalarını kullanarak, birden çok uygulamayla denetleyiciler, 
görünümler, Razor Pages, Razor derleme kaynakları, etiket yardımcıları ve daha fazlasını içeren bir derlemeyi (DLL) 
paylaşabilirsiniz. Birden çok projedeki kodu çoğaltmak için bir derlemeyi paylaşma tercih edilir. 

AS P.N ET Core uygulamalar Application Partözel Iikleri yükler. AssemblyPart sınıfı, bir derleme tarafından 
desteklenen bir uygulama bölümünü temsil eder. 

ASP.NET Core özellikleri yükle 

AS P.N ET Core özelliklerini (denetleyiciler, görünüm bileşenleri vb.) bulup yüklemek için 
Microsoft.AspNetCore.Mvc.ApplicationParts ve AssemblyPart sınıflarını kullanın. ApplicationPartManager, 
kullanılabilir uygulama parçalarını ve özellik sağlayıcılarını izler. ApplicationPartManager startup.configureservices 
yapılandırılır: 

// Requires using System.Reflection; 

public void ConfigureServices(IServiceCollection Services) 

{ 

var assembly = typeof(MySharedController).Assembly; 

Services.AddControllersWithViews() 

.AddApplicationPart(assembly); 

} 

Aşağıdaki kod, AssemblyPart kullanarak ApplicationPartManager yapılandırmaya yönelik alternatif bir yaklaşım 
sağlar: 

// Requires using System.Reflection; 

// Requires using Microsoft.AspNetCore.Mvc.ApplicationParts; 
public void ConfigureServices(IServiceCollection Services) 

{ 

var assembly = typeof(MySharedController).GetTypeInfo().Assembly; 

// This creates an AssemblyPart, but does not create any related parts for items such as views. 
var part = new AssemblyPart(assembly); 

Services.AddControllersWithViews() 

.ConfigureApplicationPartManager(apm => apm.ApplicationParts.Add(part)); 

} 











uygulamanın projesinde değil. 


Önceki iki kod örneği bir derlemeden sharedcontroiler yükler, sharedcontroiler , 

Bkz. VVebappparts çözüm örneği indirmesi. 

Görünümleri dahil et 

Derlemeye görünümler eklemek için Razor sınıf kitaplığı kullanın. 

Kaynakları yüklemeyi engelle 

Uygulama bölümleri, belirli bir derleme veya konumdaki kaynakları yüklemeyi önlemek için kullanılabilir. 
Kullanılabilir kaynakları gizlemek veya mevcut hale getirmek için Microsoft.AspNetCore.Mvc.ApplicationParts 
koleksiyonun üyelerini ekleyin veya kaldırın. AppiicationParts koleksiyonundaki girdilerin sırası önemli değildir. 
Kapsayıcıdaki hizmetleri yapılandırmak için kullanmadan önce AppiicationPartManager yapılandırın. Örneğin, 
AddcontrollersAsServices çağırmadan önce AppiicationPartManager yapılandırın. Bir kaynağı kaldırmak için 
AppiicationParts koleksiyonundaki Remove çağırın. 

AppiicationPartManager şunlar için parçalar içerir: 

• Uygulamanın derlemesi ve bağımlı derlemeleri. 

• Microsoft.AspNetCore.Mvc.AppiicationParts.CompiledRazorAssemblyPart 

• Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation 

• Microsoft.AspNetCore.Mvc.TagHelpers . 

• Microsoft.AspNetCore.Mvc.Razor . 


Özellik sağlayıcıları 

Uygulama özelliği sağlayıcıları uygulama parçalarını inceler ve bu parçalar için özellikler sağlar. Aşağıdaki ASP.NET 
Core özellikleri için yerleşik özellik sağlayıcıları vardır: 

• ControllerFeatureProvider 

• TagHelperFeatureProvider 

• M etadata ReferenceFeatureP rovider 

• VievvsFeatureProvider 

• internai ciass RazorCompiledltemFeatureProvider 

Özellik sağlayıcıları, t özelliğin türü olduğu IApplicationFeatureProvider<TFeature>devralınır. Özellik 
sağlayıcıları, daha önce listelenen özellik türlerinden herhangi biri için uygulanabilir. 

AppiicationPartManager.FeatureProviders özellik sağlayıcılarının sırası çalışma zamanı davranışını etkileyebilir. Daha 
sonra eklenen sağlayıcılar, daha önce eklenen sağlayıcıların yaptığı eylemlere yanıt verebilir. 

Kullanılabilir özellikleri görüntüle 

Bir uygulama için kullanılabilen özellikler, bağımlılık eklemeyoluyla bir AppiicationPartManager isteyerek 
numaralandırılabilir: 













using AppPartsSample.ViewModels; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.ApplicationParts; 

using Microsoft.AspNetCore.Mvc.Controllers; 

using System.Linq; 

using Microsoft.AspNetCore.Mvc.Razor.Compilation; 
using Microsoft.AspNetCore.Mvc.Razor.TagHelpers; 
using Microsoft.AspNetCore.Mvc.ViewComponents; 

namespace AppPartsSample.Controllers 

{ 

public class FeaturesController : Controller 

{ 

private readonly ApplicationPartManager _partManager; 

public FeaturesController(ApplicationPartManager partManager) 

{ 

_partManager = partManager; 

} 

public IActionResult Index() 

{ 

var viewModel = new FeaturesViewModel(); 

var controllerFeature = new ControllerFeature(); 

_partManager.PopulateFeature(controllerFeature); 
viewModel.Controllers = controllerFeature.Controllers.ToList(); 

var tagHelperFeature = new TagHelperFeature(); 

_partManager.PopulateFeature(tagHelperFeature); 
viewModel.TagHelpers = tagHelperFeature.TagHelpers.ToList(); 

var viewComponentFeature = new ViewComponentFeature(); 

_partManager.PopulateFeature(viewComponentFeature); 

viewModel.ViewComponents = viewComponentFeature.ViewComponents.ToList(); 
return View(viewModel); 

} 

} 

} 


Yükleme örneği, uygulama özelliklerini göstermek için yukarıdaki kodu kullanır: 

Controllers: 

- FeaturesController 

- HomeController 

- HelloController 

- GenericController'1 

- GenericController'1 
Tag Helpers: 

- PrerenderTagHelper 

- AnchorTagHelper 

- CacheTagHelper 

- DistributedCacheTagHelper 

- EnvironmentTagHelper 

- Additional Tag Helpers omitted for brevity. 

View Components: 

- SampleVieiA/Component 


Uygulama bölümlerinde bulma 

HTTP 404 hataları, uygulama parçalarıyla geliştirme sırasında sık karşılaşılan bir durumdur. Bu hatalar genellikle 
uygulamaların bölümlerinin nasıl keşfedildiği konusunda önemli bir gereksinimin eksik olmasından kaynaklanır. 




Uygulamanız bir HTTP 404 hatası döndürürse, aşağıdaki gereksinimlerin karşılandığından emin olun: 

• appücationName ayarının, bulma için kullanılan kök derlemeye ayarlanması gerekir. Bulma için kullanılan kök 
derleme normalde giriş noktası derlemesidir. 

• Kök derlemenin, bulma için kullanılan bölümlere bir başvuruya sahip olması gerekir. Başvuru doğrudan veya 
geçişli olabilir. 

• Kök derlemenin Web SDK 'sına başvurması gerekiyor.Çerçevede, öznitelikleri bulma için kullanılan kök 
derlemeye damgalayan mantık vardır. 

Tarafından RickAnderson 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 
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görünümler, Razor Pages, Razor derleme kaynakları, etiket yardımcıları ve daha fazlasını içeren bir derlemeyi (DLL) 
paylaşabilirsiniz. Birden çok projedeki kodu çoğaltmak için bir derlemeyi paylaşma tercih edilir. 

AS P.N ET Core uygulamalar Application Partözellikleri yükler. AssemblyPart sınıfı, bir derleme tarafından 
desteklenen bir uygulama bölümünü temsil eder. 

ASP.NET Core özellikleri yükle 

AS P.N ET Core özelliklerini (denetleyiciler, görünüm bileşenleri vb.) bulup yüklemek için AppiicationPart ve 
AssemblyPart sınıflarını kullanın. ApplicationPartManager, kullanılabilir uygulama parçalarını ve özellik 
sağlayıcılarım izler. ApplicationPartManager Startup.ConfigureServices yapılandırılır: 

public void ConfigureServices(IServiceCollection Services) 

{ 

// Requires using System.Reflection; 

var assembly = typeof(MySharedController).GetTypeInfo().Assembly; 

Services. AddMvc() 

.AddApplicationPart(assembly) 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

} 

Aşağıdaki kod, AssemblyPart kullanarak ApplicationPartManager yapılandırmaya yönelik alternatif bir yaklaşım 
sağlar: 

public void ConfigureServices(IServiceCollection Services) 

{ 

// Requires using System.Reflection; 

// Requires using Microsoft.AspNetCore.Mvc.ApplicationParts; 
var assembly = typeof(MySharedController).GetTypeInfo().Assembly; 
var part = new AssemblyPart(assembly); 

Services. AddMvc() 

.ConfigureApplicationPartManager(apm => apm.AppiicationParts.Add(part)) 
.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

} 












uygulamanın projesinde değil. 


Önceki iki kod örneği bir derlemeden sharedcontroiler yükler, sharedcontroiler , 

Bkz. VVebappparts çözüm örneği indirmesi. 

Görünümleri dahil et 

Derlemeye görünümler eklemek için Razor sınıf kitaplığı kullanın. 

Kaynakları yüklemeyi engelle 

Uygulama bölümleri, belirli bir derleme veya konumdaki kaynakları yüklemeyi önlemek için kullanılabilir. 
Kullanılabilir kaynakları gizlemek veya mevcut hale getirmek için Microsoft.AspNetCore.Mvc.ApplicationParts 
koleksiyonun üyelerini ekleyin veya kaldırın. AppiicationParts koleksiyonundaki girdilerin sırası önemli değildir. 
Kapsayıcıdaki hizmetleri yapılandırmak için kullanmadan önce AppiicationPartManager yapılandırın. Örneğin, 
AddcontrollersAsServices çağırmadan önce AppiicationPartManager yapılandırın. Bir kaynağı kaldırmak için 
AppiicationParts koleksiyonundaki Remove çağırın. 

Aşağıdaki kod uygulamadan MyDependentLibrary kaldırmak için Microsoft.AspNetCore.Mvc.ApplicationParts 
kullanır: [Icode-csharp] 

AppiicationPartManager şunlar için parçalar içerir: 

• Uygulamanın derlemesi ve bağımlı derlemeleri. 

• Microsoft.AspNetCore.Mvc.TagHelpers . 

• Microsoft.AspNetCore.Mvc.Razor . 


Uygulama özelliği sağlayıcıları 

Uygulama özelliği sağlayıcıları uygulama parçalarını inceler ve bu parçalar için özellikler sağlar.Aşağıdaki ASP.NET 
Core özellikleri için yerleşik özellik sağlayıcıları vardır: 

• Denetleyiciler 

• Etiket Yardımcıları 

• Bileşenleri görüntüle 

Özellik sağlayıcıları, t özelliğin türü olduğu IApplicationFeatureProvider<TFeature>devralınır. Özellik 
sağlayıcıları, daha önce listelenen özellik türlerinden herhangi biri için uygulanabilir. 

AppiicationPartManager. FeatureProviders özellik sağlayıcılarının sırası çalışma zamanı davranışını etkileyebilir. Daha 
sonra eklenen sağlayıcılar, daha önce eklenen sağlayıcıların yaptığı eylemlere yanıt verebilir. 

Kullanılabilir özellikleri görüntüle 

Bir uygulama için kullanılabilen özellikler, bağımlılık eklemeyoluyla bir AppiicationPartManager isteyerek 
numaralandırılabilir: 












using AppPartsSample.ViewModels; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.ApplicationParts; 

using Microsoft.AspNetCore.Mvc.Controllers; 

using System.Linq; 

using Microsoft.AspNetCore.Mvc.Razor.Compilation; 
using Microsoft.AspNetCore.Mvc.Razor.TagHelpers; 
using Microsoft.AspNetCore.Mvc.ViewComponents; 

namespace AppPartsSample.Controllers 

{ 

public class FeaturesController : Controller 

{ 

private readonly ApplicationPartManager _partManager; 

public FeaturesController(ApplicationPartManager partManager) 

{ 

_partManager = partManager; 

} 

public IActionResult Index() 

{ 

var viewModel = new FeaturesViewModel(); 

var controllerFeature = new ControllerFeature(); 

_partManager.PopulateFeature(controllerFeature); 
viewModel.Controllers = controllerFeature.Controllers.ToList(); 

var tagHelperFeature = new TagHelperFeature(); 

_partManager.PopulateFeature(tagHelperFeature); 
viewModel.TagHelpers = tagHelperFeature.TagHelpers.ToList(); 

var viewComponentFeature = new ViewComponentFeature(); 

_partManager.PopulateFeature(viewComponentFeature); 

viewModel.ViewComponents = viewComponentFeature.ViewComponents.ToList(); 
return View(viewModel); 

} 

} 

} 


Yükleme örneği, uygulama özelliklerini göstermek için yukarıdaki kodu kullanır: 

Controllers: 

- FeaturesController 

- HomeController 

- HelloController 

- GenericController'1 

- GenericController'1 
Tag Helpers: 

- PrerenderTagHelper 

- AnchorTagHelper 

- CacheTagHelper 

- DistributedCacheTagHelper 

- EnvironmentTagHelper 

- Additional Tag Helpers omitted for brevity. 

View Components: 

- SampleVieiA/Component 


Uygulama bölümlerinde bulma 

HTTP 404 hataları, uygulama parçalarıyla geliştirme sırasında sık karşılaşılan bir durumdur. Bu hatalar genellikle 
uygulamaların bölümlerinin nasıl keşfedildiği konusunda önemli bir gereksinimin eksik olmasından kaynaklanır. 




Uygulamanız bir HTTP 404 hatası döndürürse, aşağıdaki gereksinimlerin karşılandığından emin olun: 

• appiicationName ayarının, bulma için kullanılan kök derlemeye ayarlanması gerekir. Bulma için kullanılan kök 
derleme normalde giriş noktası derlemesidir. 

• Kök derlemenin, bulma için kullanılan bölümlere bir başvuruya sahip olması gerekir. Başvuru doğrudan veya 
geçişli olabilir. 

• Kök derlemenin Web SDK 'sına başvurması gerekiyor. 

o ASP.NET Core Framevvork 'te, bulma için kullanılan kök derlemeye öznitelikleri damgalayan özel yapı 
mantığı vardır. 




DotNet ASPNET-CodeGenerator 

19.09.2019 • 7 minutes to read ı Edit Online 


Tarafından RickAnderson 

-AS P.N ET Core scafkatlama altyapısını çalıştırır, 
yalnızca komut satırından yapı iskelesi sağlamak için gereklidir, Visual 
Studio ile scafkatlamayı kullanmak gerekli değildir. 

Bu makale .NET Core 2,1 SDK ve üzeri için geçerlidir. 

ASPNET-CodeGenerator yükleniyor 

dotnet-aspnet-codegenerator yüklenmesi gereken küresel bir araçtır . Aşağıdaki komut 
dotnet-aspnet-codegenerator aracın en son kararlı sürümünü yüklüyor: 

dotnet tool install -g dotnet-aspnet-codegenerator 

Aşağıdaki komut, yüklü dotnet-aspnet-codegenerator .NET Core SDK 'larında kullanılabilen en son 
kararlı sürümü güncelleştirir: 

dotnet tool update -g dotnet-aspnet-codegenerator 


dotnet aspnet-codegenerator 
dotnet aspnet-codegenerator 


Özeti 

dotnet aspnet-codegenerator [arguments] [-p|--project] [-n|--nuget-package-dir] [-c|-- 
configuration] [-tfm|--target-framework] [-b|--build-base-path] [--no-build] 
dotnet aspnet-codegenerator [-h|— help] 


Açıklama 

dotnet aspnet-codegenerator Genel komutASP.NET Core kod Oluşturucu ve yapı iskelesi 
altyapısını çalıştırır. 

Arguments 

generator 


Çalıştırılacak kod Oluşturucu. Aşağıdaki oluşturucular kullanılabilir: 


OLUŞTURUCU 

ÇALIŞMA 

Alan 

Bir alanı dolandırın 

denetleyici 

Bir denetleyiciyi yapı iskelesi 

kimlik 

Yapı iskelesi kimliği 











OLUŞTURUCU 


ÇALIŞMA 


razorpage Yapı iskelesi Razor Pages 

Görünümü Bir görünümü dolandırın 

Seçenekler 

-n|--nuget-package-dir 
NuGet paket dizinini belirtir. 

-c|--configuration {Debug|Release} 

Yapı yapılandırmasını tanımlar.Varsayılan değer Debug şeklindedir. 

-tfm|--target-framework 
Kullanılacak hedef çerçeve . Örneğin: net46 . 

-b|--build-base-path 
Yapı temel yolu. 

-h|--help 

Komut için kısa bir yardım yazdırır. 

--no-build 

Çalıştırmadan önce projeyi oluşturmaz. Ayrıca --no-restore bayrağı örtülü olarak ayarlar. 
-p|--project <PATH> 

Çalıştırılacak proje dosyasının yolunu belirtir (klasör adı veya tam yol). Belirtilmezse, varsayılan 
olarak geçerli dizini alır. 

Oluşturucu seçenekleri 

Aşağıdaki bölümler, desteklenen oluşturucular için kullanılabilen seçenekleri ayrıntılandırır: 

• Alan 

• Kumandasını 

• Kimlik 

• Razorpage 

• Görüntüle 

Alan seçenekleri 

Bu araç, denetleyiciler ve görünümler içeren ASP.NET Core Web projelerine yöneliktir.Razor Pages 
uygulamalarına yönelik değildir. 

Kullanım: dotnet aspnet-codegenerator area AreaNameToGenerate 
Yukarıdaki komut aşağıdaki klasörleri oluşturur: 

• Alanlar 

o AreaNameToGenerate 
o Denetleyiciler 












o Veri 
o Modelde 
o Görünümler 


Denetleyici Seçenekleri 


Aşağıdaki tabloda aspnet-codegenerator 

controiler ve seçeneklerilistelenmiştir: razorpage 

SEÇENEK 

AÇIKLAMA 

--model veya -m 

Kullanılacak model sınıfı. 

--dataContext or -dc 

DbContext Kullanılacak sınıfı. 

--bootstrapVersion veya -b 

Önyükleme sürümünü belirtir. Geçerli değerler 3 
veya 4 . Varsayılan değer 4 . Gerekli ve mevcut bir 
wwwroot dizin belirtilen sürümü önyükleme dosyaları 
içeren oluşturulur. 

--referenceScriptLibraries veya - betikleri 

Oluşturulan görünümler, betik kitaplıkları başvuru. 
Ekler _ValidationScriptsPartial düzenleyip 
sayfaları oluşturun. 

--düzeni veya -m 

Kullanılacak özel düzen sayfası. 

--useDefaultLayout veya - udi 

Varsayılan düzen görünümleri kullanın. 

--force veya -t 

Varolan dosyaların üzerine yaz. 

--relativeFolderPath veya - outDir 

Klasör yolu göreli çıkış projesi dosyası burada 
oluşturulur. Belirtilmezse, dosyalar proje klasöründe 
oluşturulur. 


Aşağıdaki tabloda aşağıdakiler için aspnet-codegenerator controiler benzersiz seçenekler 


listelenmektedir: 


SEÇENEK 

AÇIKLAMA 

--controllerName veya-Name 

Denetleyicinin adı. 

--Kullanılan Asyncactions veya-async 

Zaman uyumsuz denetleyici eylemleri oluştur. 

--noVievvs veya-NV 

Hiçbir görünüm oluşturun. 

--restWithNoViews veya-API 

REST stili API ile bir denetleyici oluşturun. noviews 
varsayılır ve tüm görünümle ilgili seçenekler yok 
sayılır. 

--readVVriteActions veya-Actions 

Model olmadan okuma/yazma eylemleri ile denetleyici 
oluşturun. 


Komutuyla ilgili yardım için -h aspnet-codegenerator controiler anahtarı kullanın 

dotnet aspnet-codegenerator controiler -h 











Bir örneği dotnet aspnet-codegenerator controiler için bkz. film modelini yapı iskelesi . 

Razorpage 

Razor Pages yeni sayfanın adı ve kullanılacak şablon belirtilerek tek tek iskele alınabilir. Desteklenen 
şablonlar şunlardır: 

• Empty 

• Create 

• Edit 

• Delete 

• Details 

• List 


Örneğin, aşağıdaki komut myedit. cshtml ve Myf'd/f.cshfm/.csoluşturmak için düzenleme şablonunu 
kullanır: 


dotnet aspnet-codegenerator razorpage MyEdit Edit -m Movie -dc RazorPagesMovieContext -outDir 
Pages/Movies 

Genellikle, şablon ve oluşturulan dosya adı belirtilmez ve aşağıdaki şablonlar oluşturulur: 

• Create 

• Edit 

• Delete 

• Details 

• List 

Aşağıdaki tabloda aspnet-codegenerator razorpage 

ve seçeneklerilistelenmiştir: controiler 

SEÇENEK 

AÇIKLAMA 

--model veya -m 

Kullanılacak model sınıfı. 

--dataContext or -dc 

DbContext Kullanılacak sınıfı. 

--bootstrapVersion veya -b 

Önyükleme sürümünü belirtir. Geçerli değerler 3 
veya 4 . Varsayılan değer 4 . Gerekli ve mevcut bir 
wwwroot dizin belirtilen sürümü önyükleme dosyaları 
içeren oluşturulur. 

--referenceScriptLibraries veya - betikleri 

Oluşturulan görünümler, betik kitaplıkları başvuru. 

Ekler _ValidationScriptsPartial düzenleyip 
sayfaları oluşturun. 

--düzeni veya -m 

Kullanılacak özel düzen sayfası. 

--useDefaultLayout veya - udi 

Varsayılan düzen görünümleri kullanın. 

--force veya -f 

Varolan dosyaların üzerine yaz. 

--relativeFolderPath veya - outDir 

Klasör yolu göreli çıkış projesi dosyası burada 
oluşturulur. Belirtilmezse, dosyalar proje klasöründe 
oluşturulur. 









Aşağıdaki tabloda aşağıdakiler için aspnet-codegenerator razorpage benzersiz seçenekler 
listelenmektedir: 


SEÇENEK 

AÇIKLAMA 

--namespaceName veya-Namespace 

Oluşturulan PageModel için kullanılacak ad alanının 
adı 

--partialVievv veya-Partial 

Kısmi bir görünüm oluşturun. Bu belirtilirse, düzen 
seçenekleri-l ve-UDL yok sayılır. 

--noPageModel veya-NPM 

Boş şablon için bir PageModel sınıfı oluşturmamı geç 


Komutuyla ilgili yardım için -h aspnet-codegenerator razorpage anahtarı kullanın: 

dotnet aspnet-codegenerator razorpage -h 

Bir örneği dotnet aspnet-codegenerator razorpage için bkz. film modelini yapı iskelesi 

Kimlik 

Bkz. Yapı İskelesi kimliği 





ASRNET Core ile Web API 'Leri oluşturma 

6.12.2019 • 13 minutes to readz. Edit Online 


Scott Ade ve Tom Dykstra tarafından 

ASP.NET Core, web API'leri olarak da bilinen RESTful hizmetleri oluşturulmasını C# kullanarak 
desteklemektedir. İstekleri işlemek için, bir Web API 'SI denetleyicileri kullanır.Bir Web API 'sindeki 
denetleyiciler ControiierBase türetilen sınıflardır. Bu makalede, Web API isteklerini işlemek için denetleyicilerin 
nasıl kullanılacağı gösterilmektedir. 

Görüntüleme veya indirme örnek kodu, (indirme). 


ControiierBase sınıfı 

Bir Web API 'SI ControllerBasetüretilen bir veya daha fazla denetleyici sınıfından oluşur. Web API proje şablonu 
bir başlatıcı denetleyicisi sağlar: 

[ApiController] 

[Route("[controller]")] 

public class WeatherForecastController : ControiierBase 


[Route("api/[controller]")] 

[ApiController] 

public class ValuesController : ControiierBase 

Controller sınıfından türeterek bir Web API denetleyicisi oluşturmayın, controiler ControiierBase türetilir ve 
görünümler için destek ekler, bu nedenle Web API istekleri için değil Web sayfalarını işlemeye yöneliktir. Bu 
kural için bir özel durum var: aynı denetleyiciyi hem görünümler hem de Web API 'Leri için kullanmayı 
planlıyorsanız, controller türetirsiniz. 

ControiierBase sınıfı, HTTP isteklerini işlemek için yararlı olan çok sayıda özellik ve yöntem sağlar.Örneğin, 
ControiierBase.CreatedAtAction 201 durum kodu döndürür: 

[HttpPost] 

[ProducesResponseType(StatusCodes.Status201Created)] 

[ProducesResponseType(StatusCodes.Status400BadRequest)] 
public ActionResult<Pet> Create(Pet pet) 

{ 

pet.Id = _petsInMemoryStore.Any() ? 

_petsInMemoryStore.Max(p => p.Id) + 1:1; 

_petsInMemoryStore.Add(pet); 

return CreatedAtAction(nameof(GetByld), new { id = pet.Id }, pet); 

} 

ControiierBase sağladığı yöntemlere ilişkin bazı örnekler aşağıda verilmiştir. 

YÖNTEM NOTLAR 

BadReguest 400 durum kodunu döndürür. 










YÖNTEM 


NOTLAR 


NotFound 404 durum kodunu döndürür. 

PhysicalFile Bir dosya döndürür. 

TryllpdateModelAsync Model bağlamasınıçağırır. 

TryValidateModel Model doğrulamasınıçağırır. 

Tüm kullanılabilir yöntemlerin ve özelliklerin listesi için bkz. ControllerBase. 

{1 >{2>Öznitelikler<2}< 1} 

Microsoft.AspNetCore.Mvc ad alanı, Web API denetleyicileri ve eylem yöntemlerinin davranışını yapılandırmak 
için kullanılabilen öznitelikleri sağlar. Aşağıdaki örnek, desteklenen HTTP eylem fiilini ve döndürülebilecek 
bilinen HTTP durum kodlarını belirtmek için özniteliklerini kullanır: 

[HttpPost] 

[ProducesResponseType(StatusCodes.Status201Created)] 

[ProducesResponseType(StatusCodes.Status400BadRequest)] 
public ActionResult<Pet> Create(Pet pet) 

{ 

pet.Id = _petsInMemoryStore.Any() ? 

_petsInMemoryStore.Max(p => p.Id) + 1 : 1; 

_petsInMemoryStore.Add(pet); 

return CreatedAtAction(nameof(GetByld ), new { id = pet.Id }, pet); 

} 

Aşağıda, kullanılabilecek özniteliklerin daha fazla örneği verilmiştir. 


ÖZNİTELİK 

NOTLAR 

[Route] 

Bir denetleyicinin veya eylemin URL modelini belirtir. 

[Bind] 

Model bağlama için dahil edilecek öneki ve özellikleri belirtir. 

[HttpGet] 

HTTP GET ACTION fiilini destekleyen bir eylemi tanımlar. 

[Consumes] 

Bir eylemin kabul ettiği veri türlerini belirtir. 

[Produces] 

Bir eylemin döndürdüğü veri türlerini belirtir. 


Kullanılabilir öznitelikleri içeren bir liste için Microsoft.AspNetCore.Mvc ad alanına bakın. 

ApiController özniteliği 

[ApiControiler] özniteliği, AŞAĞıDAKI, API 'ye özgü davranışları etkinleştirmek üzere bir denetleyici sınıfına 
uygulanabilir: 

• Öznitelik yönlendirme gereksinimi 

• Otomatik HTTP 400 yanıtları 

• Bağlama kaynak parametresi çıkarımı 









• Multipart/form-veri isteği çıkarımı 

• Hata durum kodları için sorun ayrıntıları 


Bu özellikler, 2,1 veya üzeri bir Uyumluluk sürümü gerektirir. 

Belirli denetleyicilerde öznitelik 

[ApiControiler] özniteliği, proje şablonundan aşağıdaki örnekte olduğu gibi belirli denetleyicilere 
uygulanabilir: 

[ApiControiler] 

[Route("[controller]")] 

public class 1/JeatherForecastController : ControllerBase 


[Route("api/[controller]")] 

[ApiControiler] 

public class ValuesController : ControllerBase 


Birden çok denetleyicilerde öznitelik 

Özniteliği birden fazla denetleyicide kullanmanın bir yaklaşımı, [ApiControiler] özniteliğiyle açıklanmış bir özel 
temel denetleyici sınıfı oluşturmaktır. Aşağıdaki örnekte, özel bir temel sınıf ve ondan türetilen bir denetleyici 
gösterilmektedir: 

[ApiControiler] 

public class MyControllerBase : ControllerBase 
{ 

} 


[Produces(MediaTypeNames.Application.Ison)] 
[Route("[controller]")] 

public class PetsController : MyControllerBase 


[Produces(MediaTypeNames.Application.3 son)] 
[Route("api/[controller]")] 

public class PetsController : MyControllerBase 


Bir derlemedeki öznitelik 

Uyumluluk sürümü 2,2 veya üzeri bir sürüme ayarlandıysa, [ApiControiler] özniteliği bir derlemeye 
uygulanabilir. Bu şekilde ek açıklama, derlemedeki tüm denetleyicilere Web APİ davranışını uygular.Tek tek 
denetleyiciler için geri alma yöntemi yoktur. Derleme düzeyi özniteliğini startup sınıfını çevreleyen ad alanı 
bildirimine uygulayın: 

[assembly: ApiControiler] 
namespace WebApiSample 
{ 

public class Startup 
{ 

} 

} 


Öznitelik yönlendirme gereksinimi 









[ApiControiler] özniteliği öznitelik yönlendirme bir gereksinim yapar. Örneğin: 

[ApiController] 

[Route("[controller]")] 

public class 1/JeatherForecastController : ControllerBase 

Eylemler startup.configure içinde useEndpoints , UseMvcveya UseMvcVVİthDefaultRoute tarafından 
tanımlanan geleneksel yollar aracılığıyla erişilemez. 

[Route("api/[controller]")] 

[ApiController] 

public class ValuesController : ControllerBase 

Eylemler startup.configure UseMvc veya UseMvcVVİthDefaultRoute tarafından tanımlanan geleneksel yollar 
aracılığıyla erişilemez. 

Otomatik HTTP 400 yanıtları 

[ApiController] özniteliği, model doğrulama hatalarının otomatik olarak bir HTTP 400 yanıtı tetiklenmesine 
neden olur. Sonuç olarak, aşağıdaki kod bir eylem yönteminde gereksizdir: 

if (IModelState.IsValid) 

{ 

return BadRequest(ModelState); 

} 


ASP.NET Core MVC, önceki denetimi yapmak için ModelStatelnvalidFilter eylem filtresini kullanır. 

Varsayılan BadRequest yanıtı 

2,1 uyumluluk sürümü ile bir HTTP 400 yanıtı için varsayılan yanıt türü SerializableError. Aşağıdaki istek 
gövdesi, serileştirilmiş türün bir örneğidir: 

{ 

..... t 

"A non-empty request body is required." 

] 

} 


2,2 veya üzeri bir uyumluluk sürümü ile, bir HTTP 400 yanıtı için varsayılan yanıt türü 
ValidationProblemDetails. Aşağıdaki istek gövdesi, serileştirilmiş türün bir örneğidir: 

{ 

"type": "https://tools.ietf.org/html/rfc7231#section-6.5.1 ", 

"title": "One or more validation errors occurred.", 

"status": 400, 

"traceld": "|7fb5el6a-4c8f23bbfc974667.", 

"errors": { 

t 

"A non-empty request body is required." 

] 

} 

} 

ValidationProblemDetails türü: 


• Web APİ yanıtlarında hata belirtmek için makine tarafından okunabilen bir biçim sağlar. 









• RFC 7807 belirtimineuyar. 


Otomatik 400 yanıtlarını günlüğe kaydet 

Bkz. otomatik 400 yanıtlarını model doğrulama hatalarında günlüğe kaydetme (ASPNET/AspNetCore. Docs 
#12157). 

Otomatik 400 yanıtını devre dışı bırak 

Otomatik 400 davranışını devre dışı bırakmak için SuppressModelStatelnvalidFilter özelliğini true olarak 
ayarlayın. Aşağıdaki Vurgulanan kodu startup.configureServices ekleyin: 

Services .AddCont rollersQ 

.ConfigureApiBehaviorOptions(options => 

{ 

options.SuppressConsumesConstraintForFormFileParameters = true; 
options.SuppressinferBindingSourcesForParameters = true; 
options.SuppressModelStatelnvalidFilter = true; 
options.SuppressMapClientErrors = true; 
options.ClientErrorMapping[404].Link = 

"https://httpstatuses.com/404"; 

}); 


Services .AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2) 
.ConfigureApiBehaviorOptions(options => 

{ 

options.SuppressConsumesConstraintForFormFileParameters = true; 
options.SuppressinferBindingSourcesForParameters = true; 
options.SuppressModelStatelnvalidFilter = true; 
options.SuppressMapClientErrors = true; 
options.ClientErrorMapping[404].Link = 

"https://httpstatuses.com/404"; 

}); 


Services.Configure<ApiBehaviorOptions>(options => 

{ 

options.SuppressConsumesConstraintForFormFileParameters = true; 
options.SuppressinferBindingSourcesForParameters = true; 
options.SuppressModelStatelnvalidFilter = true; 

}); 


Bağlama kaynak parametresi çıkarımı 

Bağlama kaynak özniteliği, bir eylem parametresi değerinin bulunduğu konumu tanımlar. Aşağıdaki bağlama 
kaynak öznitelikleri var: 

ÖZNITELIK BAĞLAMA KAYNAĞI 


[FromBody] 


İstek gövdesi 


[FromForm] 


İstek gövdesinde form verileri 


[FromHeader] 


İstek üst bilgisi 


[FromQuery] 


İstek sorgusu dize parametresi 









ÖZNITELIK 


BAĞLAMA KAYNAĞI 


[FromRoute] 


Geçerli istekten veri yönlendir 


[FromServices] 


Eylem parametresi olarak eklenen istek hizmeti 


VVARNING 

Değerler %2f (/) içerdiğinde [FromRoute] kullanmayın. %2f / atlanmaz. Değer %2f içeriyorsa [FromQuery] 

kullanın. 


[FromQuery] gibi [ApiControiler] özniteliği veya bağlama kaynağı öznitelikleri olmadan AS P.N ET Core çalışma 
zamanı karmaşık nesne modeli Ciltçi kullanmaya çalışır. Karmaşık nesne modeli Ciltçi, verileri değer 
sağlayıcılarından tanımlı bir düzende çeker. 

Aşağıdaki örnekte [FromQuery] özniteliği, istek URL'sinin sorgu dizesinde discontinuedOniy parametre 
değerinin sağlandığını belirtir: 

[HttpGet] 

public ActionResult<List<Product>> Get( 

[FromQuery] bool discontinuedOniy = false) 

{ 

List<Product> products = null; 

if (discontinuedOniy) 

{ 

products = _productsInMemoryStore.Where(p => p.IsDiscontinued).ToList(); 

} 

else 

{ 

products = _productsInMemoryStore; 

} 

return products; 

} 

[ApiControiler] özniteliği, eylem parametrelerinin varsayılan veri kaynakları için çıkarım kuralları uygular. Bu 
kurallar, eylem parametrelerine öznitelikleri uygulayarak bağlama kaynaklarını el ile tanımlamak zorunda 
kalmadan sizi kaydeder. Bağlama kaynak çıkarımı kuralları aşağıdaki gibi davranır: 

• karmaşık tür parametreleri için [FromBody] algılanır. [FromBody] çıkarım kuralı için bir özel durum, 
IFormCollection ve CancellationTokengibi özel bir anlamı olan karmaşık, yerleşik bir türdür. Bağlama kaynak 
çıkarımı kodu bu özel türleri yoksayar. 

• IFormFileve IFormFileCollectiontüründeki eylem parametreleri için [FromForm] algılanır. Bu, herhangi bir 
basit veya Kullanıcı tanımlı tür için çıkarsanamıyor. 

• yol şablonundaki bir parametreyle eşleşen herhangi bir eylem parametresi adı için [FromRoute] algılanır. 
Birden fazla yol bir eylem parametresiyle eşleştiğinde, herhangi bir rota değeri [FromRoute] olarak 
değerlendirilir. 

• [FromQuery] diğer eylem parametreleri için algılanır. 

FromBody çıkarım notları 

string veya int gibi basit türler için [FromBody] çıkarsanamıyor. Bu nedenle, bu işlev gerektiğinde basit türler 
için [FromBody] özniteliği kullanılmalıdır. 

Bir eylem, istek gövdesinden birden fazla parametre bağlamışsa, bir özel durum oluşturulur.Örneğin, aşağıdaki 



















eylem yöntemi imzalarının tümü bir özel duruma neden olur: 

• karmaşık türler olduklarından her ikisi de [FromBody], 

[HttpPost] 

public IActionResult Actionl(Product product, Order order) 

• karmaşık bir tür olduğundan, başka bir üzerinde [FromBody] özniteliği. 

[HttpPost] 

public IActionResult Action2(Product product, [FromBody] Order order) 

• her ikisinde de [FromBody] özniteliği. 

[HttpPost] 

public IActionResult Action3([FromBody] Product product, [FromBody] Order order) 


NOTE 

ASP.NET Core 2,1 ' de, listeler ve diziler gibi koleksiyon türü parametreleri [FromQuery] olarak yanlış şekilde algılanır. 

[FromBody] özniteliği, istek gövdesinden bağlanmaları durumunda bu parametreler için kullanılmalıdır. Bu davranış 
ASP.NET Core 2,2 veya sonraki bir sürümde düzeltilir, burada, koleksiyon türü parametrelerinin varsayılan olarak gövdeden 
bağlanacak şekilde çıkarsandır. 


Çıkarım kurallarını devre dışı bırak 

Bağlama kaynak çıkarımını devre dışı bırakmak için SuppressInferBindingSourcesForParameters true olarak 
ayarlayın. Aşağıdaki kodu startup.configureServices ekleyin: 

Services .AddCont rollers() 

.ConfigureApiBehaviorOptions(options => 

{ 

options.SuppressConsumesConstraintForFormFileParameters = true; 
options.SuppressinferBindingSourcesForParameters = true; 
options.SuppressModelStatelnvalidFilter = true; 
options.SuppressMapClientErrors = true; 
options.ClientErrorMapping[404].Link = 

"https://httpstatuses.com/404"; 

}); 


Services .AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2) 
.ConfigureApiBehaviorOptions(options => 

{ 

options.SuppressConsumesConstraintForFormFileParameters = true; 
options.SuppressinferBindingSourcesForParameters = true; 
options.SuppressModelStatelnvalidFilter = true; 
options.SuppressMapClientErrors = true; 
options.ClientErrorMapping[404].Link = 

"https://httpstatuses.com/404"; 

}); 












Services.Configure<ApiBehaviorOptions>(options => 

{ 

options.SuppressConsumesConstraintForFormFileParameters = true; 
options.SuppressinferBindingSourcesForParameters = true; 
options.SuppressModelStatelnvalidFilter = true; 

}); 


Multipart/form-veri isteği çıkarımı 

[FromForm] özniteliğiyle bir eylem parametresine ek açıklama eklendiğinde [ApiControiler] özniteliği bir 
çıkarım kuralı uygular, muitipart/form-data isteği içerik türü algılanır. 

Varsayılan davranışı devre dışı bırakmak için SuppressConsumesConstraintForFormFileParameters özelliğini 
startup.configureServices' 'true olarak ayarlayın: 

Services .AddCont rollers() 

.ConfigureApiBehaviorOptions(options => 

{ 

options.SuppressConsumesConstraintForFormFileParameters = true; 
options.SuppressinferBindingSourcesForParameters = true; 
options.SuppressModelStatelnvalidFilter = true; 
options.SuppressMapClientErrors = true; 
options.ClientErrorMapping[404].Link = 

"https://httpstatuses.com/404"; 

}); 


Services .AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2) 
.ConfigureApiBehaviorOptions(options => 

{ 

options.SuppressConsumesConstraintForFormFileParameters = true; 
options.SuppressinferBindingSourcesForParameters = true; 
options.SuppressModelStatelnvalidFilter = true; 
options.SuppressMapClientErrors = true; 
options.ClientErrorMapping[404].Link = 

"https://httpstatuses.com/404"; 

}); 


Services.Configure<ApiBehaviorOptions>(options => 

{ 

options.SuppressConsumesConstraintForFormFileParameters = true; 
options.SuppressinferBindingSourcesForParameters = true; 
options.SuppressModelStatelnvalidFilter = true; 

})J 


Hata durum kodları için sorun ayrıntıları 

Uyumluluk sürümü 2,2 veya üzeri olduğunda, MVC bir hata sonucunu (durum kodu 400 veya üzeri olan bir 
sonuç) ProblemDetailsbir sonuçla dönüştürür. ProblemDetails türü, bir HTTP yanıtında makine tarafından 
okunabilen hata ayrıntılarını sağlamak için RFC 7807 belirtimine dayanır. 


Bir denetleyici eyleminde aşağıdaki kodu göz önünde bulundurun: 









if (pet == null) 

{ 

return NotFound(); 

} 

NotFound yöntemi ProblemDetails gövde içeren bir HTTP 404 durum kodu üretir.Örneğin: 
{ 

type: "https://tools.ietf,org/html/rfc7231#section-6.5.4 ", 
title: "Not Found", 
status: 404j 

traceld: "0HLHLV31KRN83:00000001" 

} 


ProblemDetails yanıtını devre dışı bırak 

SuppressMapClientErrors özelliği true olarak ayarlandığında ProblemDetails örneğinin otomatik olarak 
oluşturulması devre dışıdır. Aşağıdaki kodu startup.configureServices ekleyin: 

Services.AddControllers() 

.ConfigureApiBehaviorOptions(options => 

{ 

options.SuppressConsumesConstraintForFormFileParameters = true; 
options.SuppressinferBindingSourcesForParameters = true; 
options.SuppressModelStatelnvalidFilter = true; 
options.SuppressMapClientErrors = true; 
options.ClientErrorMapping[404].Link = 

"https://httpstatuses.com/404"; 

}); 


Services .AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2) 

.ConfigureApiBehaviorOptions(options => 

{ 

options.SuppressConsumesConstraintForFormFileParameters = true; 
options.SuppressinferBindingSourcesForParameters = true; 
options.SuppressModelStatelnvalidFilter = true; 
options.SuppressMapClientErrors = true; 
options.ClientErrorMapping[404].Link = 

"https://httpstatuses.com/404"; 

}); 


Ek kaynaklar 

• ASP.NET Core Web API 'sindeki denetleyici eylemi dönüş türleri 

• ASP.NET Core Web API 'Lerinde hataları işleme 

• ASP.NET Core Web API 'sindeki özel formatıcılar 

• ASP.NET Core Web API 'sindeki yanıt verilerini biçimlendirme 

• ASP.N ET Core Web API Yardım sayfaları ile Svvagger / Openapı 

• ASP.NET Core denetleyici eylemlerine yönlendirme 









Öğretici: ASPNET Core bir Web API 'SI oluşturma 

10.12.2019 • 47 minutes to read z. Edit Online 


Tarafından Rick Anderson ve Mike VVasson 

Bu öğretici, bir vveb API ASP.NET Core ile oluşturmaya ilişkin temel bilgileri öğretir. 

Bu öğreticide şunların nasıl yapıladığını öğreneceksiniz: 

• Bir Web API projesi oluşturun. 

• Bir model sınıfı ve bir veritabanı bağlamı ekleyin. 

• CRUD yöntemleriyle bir denetleyiciyi dolandırın. 

• Yönlendirmeyi, URL yollarını ve dönüş değerlerini yapılandırın. 

• Web API'si Postman ile çağırın. 

Sonunda, bir veritabanında depolanan "yapılacaklar" öğelerini yönetebilmek için bir Web API 'SI vardır. 

Genel bakış 

Bu öğretici yandaki API oluşturur: 


API 

AÇIKLAMA 

İSTEK GÖVDESİ 

YANIT GÖVDESİ 

/Api/Todoltems al 

Tüm yapılacak iş öğeleri al 

Yok. 

Yapılacaklar öğelerinin bir 
dizisi 

/Api/Todoltems/{id} al 

Bir öğeyi Kimliğine göre Al 

Yok. 

Yapılacak iş öğesi 

POST/api/Todoltems 

Yeni Öğe Ekle 

Yapılacak iş öğesi 

Yapılacak iş öğesi 

/Api/Todoltems/{id} koy 

Mevcut öğeyi güncelleştirin 

Yapılacak iş öğesi 

Yok. 

/Api/Todoltems/{id} SİL 

Öğeyi Sil 

Yok. 

Yok. 


Aşağıdaki diyagramda, bu uygulamanın tasarımını gösterir. 























Prerequisites 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• ASP.net ve Web geliştirme iş yüküyle Visual Studio 2019 16,4 veya üzeri 

• .NET Core 3,1 SDK veya üzeri 


Birvveb projesi oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Dosya menüsünden Yeni > Proje' yi seçin. 

• ASP.NET Core Web uygulaması şablonunu seçin ve İleri 1 ye tıklayın. 

• Projeyi TodoApi olarak adlandırın ve Oluştur 1 a tıklayın. 

• Yeni birASP.NET Core Web uygulaması oluştur iletişim kutusunda, .net Core ve ASP.NET Core 3,1 ' 

un seçili olduğunu doğrulayın. API şablonunu seçin ve Oluştur 1 a tıklayın. 


X 


Create a new ASP.NET Core Web Application 


.NET Core 

- 

ASP.NET Core 3.0 

- 





Empty 


An empty project template tor creating an ASP.NET Core application. This template does not have any 
content in it 



A project template for creating an ASP.NET Core application with an example Controller for a RESTful HTTP 
service. This template can also be used for ASP.NET Core MVC Views and Controllers. 


VVorker Service 

An empty project template for creating a vvorker service. 

Web Application 

A project template for creating an ASP.NET Core application with example ASP.NET Core Razor Pages 
content 


Web Application (Model-Vievv-Controller) 


A project template for creating an ASP.NET Core application vvith example ASP.NET Core MVC Vievvs and 
Controllers. This template can also be used for RESTful HTTP Services. 


—~ rıRPC Servire 

Get additional project templates 


Authentication 

No Authentication 

Change 


Advanced 

R1 Configure for HTTPS 
| Enable Docker Support 
(Reguires Docker Desktop) 


Author: Microsoft 

Source: SDK 3.0.100-preview7-012801 


Back Create 


API'yi test etme 

Proje şablonu oluşturur bir weatherForecast API. Çağrı Get uygulamayı test etmek için bir tarayıcıdan 
yöntemi. 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Uygulamayı çalıştırmak için CTRL + F5 tuşlarına basın. Visual Studio bir tarayıcı ile başlatarak 



















https://localhost:<port>/weatherForecast burada <port> bir rastgele seçilen bağlantı noktası numarasıdır. 

IIS Express sertifika güven varsa soran bir iletişim kutusu alırsanız seçin Evet, içinde Güvenlik Uyarısı 
ardından, görüntülenen iletişim seçin Evet. 

Aşağıdakine benzer bir JSON döndürülür: 

[ 

{ 

"date": "2019-07-16T19:04:05.7257911-06:00", 

"temperatureC": 52, 

"temperatureF": 125, 

"summary": "Mild" 

b 

{ 

"date": "2019-07-17T19:04:05.7258461-06:00", 

"temperatureC": 36, 

"temperatureF": 96, 

"summary": "Warm" 

b 

{ 

"date": "2019-07-18T19:04:05.7258467-06:00", 

"temperatureC": 39, 

"temperatureF": 102, 

"summary": "Cool" 

b 

{ 

"date": "2019-07-19T19:04:05.7258471-06:00", 

"temperatureC": 10, 

"temperatureF": 49, 

"summary": "Bracing" 

b 

{ 

"date": "2019-07-20T19:04:05.7258474-06:00", 

"temperatureC": -1, 

"temperatureF": 31, 

"summary": "Chilly" 

} 


Bir model sınıfı ekleme 

A modeli uygulamayı yöneten verilerini temsil eden sınıflar kümesidir. Tek bir modeldir bu uygulama için 

Todoltem Sinifl. 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• içinde Çözüm Gezgini, projeye sağ tıklayın. Seçin ekleme > yeni klasör. Klasör adı modelleri. 

• Sağ modelleri klasörü ve select Ekle > sınıfı. Sınıf adı Todoıtem seçip Ekle. 

• Şablon kodunu aşağıdaki kodla değiştirin: 







namespace TodoApi.Models 

{ 

public class Todoltem 

{ 

public long Id { get; set; } 
public string Name { get; set; } 
public bool IsComplete { get; set; } 

} 

} 

id Özelliği işlevlerinin bir ilişkisel veritabanında benzersiz anahtar. 

Model sınıfları herhangi bir projede gidip ancak modelleri klasörü, kural olarak kullanılır. 

Veritabanı bağlamı Ekle 

Veritabam bağlami koordine eden bir veri modeli için Entity Framework işlevsellik ana sınıftır. Bu sınıf türetme 
tarafından oluşturulan Microsoft. EntityFrameworkCore.DbContext Simfl. 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

Microsoft. EntityFramevvorkCore. SqlServer ekleyin 

• Araçlar menüsünde nuget Paket Yöneticisi > çözüm İçin NuGet Paketlerini Yönet 1 i seçin. 

• Araştır sekmesini seçin ve arama kutusuna Microsoft. Entityframevvorkcore. SqlServer yazın. 

• Sol bölmedeki Microsoft. EntityFramevvorkCore. SqlServer öğesini seçin. 

• Sağ bölmedeki Proje onay kutusunu seçin ve ardından Install 1 ı seçin. 

• Microsoft.EntityFrameworkCore.inMemory NuGet paketini eklemek için yukarıdaki yönergeleri kullanın. 


TodoContextcs 


NuGet - Solution X 

Installed Updates Consolidate 


Todoltem.es TodoApi 


Microsoft.EntityFrameworkCore.SqlServe X ■ û j Include prerelease 


Manage Packages for Solution 


Package source: nuget.org 



Microsoft.EntityFrameworkCore.SqlServer 5 by Microsoft, 3: 
Microsoft SQL Server database provider for Entity FrameworkCore. 

▲ 

V3.0.0 


Microsoft.EntityFrameworkCore O by Microsoft 52.3M downlc 
Entity Framework Core is a lightvveight and extensible version of tfıe 
popular Entity Framewort( data access technology. 

V3.0.0 


Microsoft.EntityFramevvorkCore.Relational ö by Microsoft, 5 
Shared Entity Framework Core components for relational database 
providers. 

v3.0.0 


Microsoft.EntityFrameworkCore.Analyzers 0 by Microsoft, 3 
CSharp Analyzers for Entity Framework Core. 

V3.0.0 


Microsoft.EntityFramevvorkCore.Design O by Microsoft, 34.11 
Shared design-time components for Entity Framevvork Core tools. 

V3.0.0 




Microsoft.EntityFrameworkCore.Tools Ö by Microsoft, 28.8M 
Entity Framework Core Tools for the NuGet Package Manager Console in 
Visual Studio. 

V3.0.0 

▼ 

Each package is licensed to you by its owner. NuGet is not responsible for, nor does it 
grant any licenses to, third-party packages. 

1 1 Do not sbow this again 


J Microsoft.EntityFrame<% nugetorg 


Versions - O 



^1 Project 

Version 


[✓1 TodoApi 



Installed: notinstalled 
Vcrsion: Latest stable 3.0.0 

(v Options 


Install 


Description 

Microsoft SQl Server database provider for Entity 
Framework Core. 

Version: 3.0.0 

Author(s): Microsoft 


TodoContext veritabanı bağlamını ekleme 





















• Sağ modelleri klasörü ve select Ekle > sınıfı. Sınıf adı TodoContext tıklatıp Ekle. 


• Aşağıdaki kodu girin: 

using Microsoft.EntityFrameworkCore; 

namespace TodoApi.Models 
{ 

public class TodoContext : DbContext 
{ 

public TodoContext(DbContextOptions<TodoContext> options) 
: base(options) 

{ 

} 

public DbSet<TodoItem> Todoltems { get; set; } 

} 

} 


Veritabanı bağlamı Kaydet 

ASP.NET Core DB bağlamı gibi hizmetler ile kaydedilmelidir bağımlılık ekleme (dı) kapsayıcı. Kapsayıcı hizmeti 
denetleyicilerine sağlar. 

Güncelleştirme Startup.es aşağıdaki vurgulanmış kodu: 



// Unused usings removed 

using Microsoft.AspNetCore.Builder; 

using Microsoft.AspNetCore. Hosting; 

using Microsoft. Extensions.Configuration; 

using Microsoft.Extensions.Dependencylnjection; 

using Microsoft. Extensions .Hosting; 

using Microsoft.EntityFrameworkCore; 

using TodoApi.Models; 

namespace TodoApi 

{ 

public class Startup 

{ 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<TodoContext>(opt => 
opt.UseInMemoryDatabase("TodoList")); 

Services.AddControllers(); 

} 

public void Configure(IApplicationBuilder app, IWebHostEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

app.UseHttpsRedirection(); 

app.UseRouting(); 

app.UseAuthorization(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapControllers(); 

}); 

} 

} 

} 


Yukarıdaki kod: 

• Kullanılmayan kaldırır using bildirimleri. 

• Veritabanı bağlamı Dİ kapsayıcıya ekler. 

• Veritabanı bağlamı bir bellek içi veritabanına kullanacağını belirtir. 

Denetleyiciyi bir denetleyiciye katlama 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

• Sağ denetleyicileri klasör. 

• > yeni yapı İskelesi öğesi Ekle 1 yi seçin. 


• Entity Framevvork kullanarak ve eylemler İçeren API denetleyicisi' ni seçin ve ardından Ekle' yi 




seçin. 


• API denetleyiciyi eylemler İle Ekle ' de Entity Framevvork iletişim kutusunu kullanarak: 

o Model sınıfında Todoltem (TodoApi. modeller) öğesini seçin, 
o Veri bağlamı sınıfında TodoContext (TodoApi. modeller) öğesini seçin, 
o Add (Ekle) seçeneğini belirleyin. 

Oluşturulan kod: 

• Bir API denetleyicisi sınıfı yöntemleri olmadan tanımlar. 

• Sınıfı [ApiControiler] özniteliğiyle işaretler. Bu öznitelik, denetleyicinin web API'si isteklerine yanıt verdiğini 
gösterir. Özniteliğin izin aldığı belirli davranışlar hakkında daha fazla bilgi için bkz. ASP.NET Core ile Web 
API 'Leri oluşturma. 

• Veritabanı bağlamı eklemesine Dİ kullanır ( TodoContext ) içine denetleyici. Her bir veritabanı bağlamı 
kullanılan CRUD denetleyici yöntemleri. 

PostTodoltem Create metodunu inceleyin 

PostTodoitem ' deki retum ifadesini, NameOf işlecini kullanacak şekilde değiştirin: 

// POST: api/Todoltems 
[HttpPost] 

public async Task<ActionResult<TodoItem>> PostTodoItem(TodoItem todoltem) 

{ 

_context.Todoltems.Add(todoltem); 
await _context.SaveChangesAsync(); 

//retum CreatedAtAction("GetTodoltem", new { id = todoltem.Id }, todoltem); 
return CreatedAtAction(nameof(GetTodoltem ), new { id = todoltem.Id }, todoltem); 

} 

Yukarıdaki kod, [HttpPost] özniteliğiyle gösterildiği gibi bir http post yöntemidir. Yöntemi, HTTP isteği 
gövdesinden Yapılacaklar öğenin değerini alır. 

CreatedAtAction Yöntemi: 

• Başarılı olursa bir HTTP 201 durum kodu döndürür. HTTP 201 sunucuda yeni bir kaynak oluşturan bir HTTP 
POST yöntemi için standart yanıttır. 

• Yanıta bir konum üst bilgisi ekler. Location üstbilgisi, yeni oluşturulan Yapılacaklar öğesinin URI 'sini belirtir. 
Daha fazla bilgi için 1 0.2.2 201 oluşturuldu. 

• Location üst bilgisinin URI 'sini oluşturmak için GetTodoltem eyleme başvurur. C# nameof anahtar sözcüğü, 
CreatedAtAction çağrısında eylem adının sabit kodlanmasını önlemek için kullanılır. 

Postman yükleme 

Bu öğreticide Postman vveb API'si test etmek için kullanılır. 

• Yükleme Postman 

• Web uygulaması başlatın. 

• Postman'i başlatın. 

• Devre dışı SSL sertifika doğrulama 

• Dosya > ayarları ' ndan (genel sekmesinden) SSL sertifikası doğrulamasınıdevre dışı bırakın. 







VVARNING 

Test denetleyicisi sonra SSL sertifika doğrulamasını yeniden etkinleştirin. 


Postman ile test PostTodoltem 

• Yeni bir istek oluşturun. 

• HTTP yöntemini post olarak ayarlayın. 

• Seçin gövdesi sekmesi. 

• Seçin ham radyo düğmesi. 

• Tür kümesine JSON (application/json). 

• istek gövdesinde bir yapılacak iş öğesi için JSON girin: 

{ 

"name":"walk dog", 

"isComplete":true 

} 


• Gönder i seçin. 
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"isComplete" :true 
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Status 201 Created Time: 178ms Size: 247 B 
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Konum üst bilgisi URI test 

• Seçin üstbilgileri sekmesinde yanıt bölmesi. 

• Kopyalama konumu üst bilgi değeri: 
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No Environment 


POST ▼ https://localhost:5001/api/Todoltems 
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Save ▼ 
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• Yöntemini GET öğesine Ayarla. 

• URI 'yi yapıştırın (Örneğin, https://localhost:5001/api/TodoItems/l ). 

• Gönder i seçin. 

GET yöntemlerini inceleyin 

iki GET uç noktası bu yöntemleri uygulayın: 

• GET /api/Todoltems 

• GET /api/TodoItems/{id} 

Tarayıcıdan veya Postman 'dan iki uç noktayı çağırarak uygulamayı test edin. Örneğin: 

• https://localhost:5001 /api/Todoltems 

• https://localhost:5001/api/Todoltems/1 

Aşağıdakine benzer bir yanıt, GetTodoitems çağrısı tarafından üretilir: 

[ 

{ 

"id": 1 , 

"name": "Iteml", 

"isComplete": false 

} 

] 

Postman ile test al 

• Yeni bir istek oluşturun. 

• HTTP yöntemi kümesine alma. 


istek URL'si kümesine 

https://localhost:<port>/api/Todo!tems 

https://localhost:5001/api/TodoItems 



• Ayarlama iki bölme görünümü postman'deki. 

• Gönder i seçin. 


Bu uygulama, bellek içi bir veritabanını kullanır.Uygulama durdurulup başlatılırsa, önceki GET isteği herhangi 





















bir veri döndürmez. Hiçbir veri döndürülmezse, verileri uygulamaya gönderin . 


URL Yönlendirme ve yolları 

[HttpGet] Özniteliği bir HTTP GET isteğine yanıt vermeden bir yöntemi gösterir. Her yöntem için URL yolu şu 
şekilde oluşturulur: 

• Denetleyicinin şablonu dizesi ile başlayıp Route özniteliği: 

[Route("api/[controller]")] 

[ApiController] 

public class TodoltemsController : ControllerBase 
{ 

private readonly TodoContext _context; 

public TodoItemsController(TodoContext context) 

{ 

_context = context; 

} 

• Değiştirin [controiler] denetleyicinin adı ile kural tarafından olduğu "Controller" soneki eksi denetleyici 
sınıfı adı. Bu örnek için denetleyici sınıfı adı todoıtemsdenetleyicisidir, bu nedenle denetleyicinin adı 
"todoıtems" olur. AS P.N ET Core yönlendirme büyük/küçük harfe duyarlıdır. 

• [HttpGet] özniteliğinin bir yol şablonu varsa (örneğin, [HttpGet("products")] ), yola ekleyin. Bu örnek, 
bir şablon kullanmaz. Daha fazla bilgi için özniteliği Http [eylem] özniteliği ile yönlendirme. 

Aşağıdaki GetTodoitem yöntemi "{id}" yapılacak iş öğesi benzersiz tanımlayıcısı için bir yer tutucu 
değişkendir. GetTodoitem çağrıldığında, URL'deki "{id}" değeri id parametresindeki yöntemine sağlanır. 

// GET: api/TodoItems/5 
[HttpGet( "{id}")] 

public async Task<ActionResult<TodoItem>> GetTodoItem(long id) 

{ 

var todoltem = await _context.Todoltems.FindAsync(id); 

if (todoltem == null) 

{ 

return NotFound(); 

} 

return todoltem; 

} 


Döndürülen değerler 

Dönüş türünü GetTodoitems ve GetTodoitem yöntemler actionresult öğesinkT > türü. AS P.N ET Core, nesneyi 
otomatik olarak serileştiren JSON ve yanıt iletisinin gövdesine JSON yazar. Yanıt kodu 200 bu dönüş türü için 
olduğu varsayılırsa işlenmeyen özel durumlar vardır, işlenmeyen özel durumları 5xx hatalarla karşılaşırsanız 
çevrilir. 

ActionResuit dönüş türleri, geniş HTTP durum kodları temsil edebilir.Örneğin, GetTodoitem iki farklı durum 
değerleri döndürebilir: 

• Öğe istenen kimliği eşleşirse, yöntem bir 404 döndürür NotFound hata kodu. 

• Aksi takdirde yöntem bir JSON yanıt gövdesine 200 döndürür. Döndüren item sonuçları bir HTTP 200 
yanıtı. 



















PutTodoltem yöntemi 

PutTodoitem yöntemini inceleyin: 

// PUT: api/TodoItems/5 
[HttpPut("{id}")] 

public async Task<IActionResult> PutTodoItem(long id, Todoltem todoltem) 

{ 

if (id != todoltem.Id) 

{ 

return BadRequest(); 

} 

_context.Entry(todoltem).State = EntityState.Modified; 

try 

{ 

await _context.SaveChangesAsync(); 

} 

catch (DbUpdateConcurrencyException) 

{ 

if (!TodoItemExists(id)) 

{ 

return NotFound(); 

} 

else 

{ 

throw; 

} 

} 

return NoContent(); 

} 

PutTodoltem benzer PostTodoitem , HTTP PUT kullanır.Yanıt 204 (içerik yok). HTTP belirtimine göre bir PUT 
isteği tüm güncelleştirilmiş varlık yalnızca değişiklikler değil göndermek istemci gerektirir. Kısmi 
güncelleştirmeleri desteklemek için kullanma HTTP PATCH. 

PutTodoltem çağırırken bir hata alırsanız, veritabanında bir öğe olduğundan emin olmak için get çağırın. 

Test PutTodoltem yöntemi 

Bu örnek, uygulama her başlatıldığında başlatılmış olması gereken bellek içi bir veritabanını kullanır. Bir PUT 
çağrısı yapmadan önce veritabanında bir öğe olmalıdır. PUT çağrısı yapmadan önce veritabanında bir öğe 
olduğundan emin olmak için GET çağrısı yapın. 

İD = 1 olan Yapılacaklar öğesini güncelleştirin ve adını "Feed balık" olarak ayarlayın: 

{ 

"ID":lj 

"name":"feed fish", 

"isComplete":true 

} 


Aşağıdaki görüntüde, Postman güncelleştirme gösterilmektedir: 
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Body Cookies Headers (2) Test Results 
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DeleteTodoltem yöntemi 

DeieteTodoitem yöntemini inceleyin: 

// DELETE: api/Todoltems/S 
[HttpDelete("{id}")] 

public async Task<ActionResult<TodoItem>> DeleteTodoItem(long id) 

{ 

var todoltem = await _context.TodoItems.FindAsync(id); 
if (todoltem == null) 

{ 

return NotFound(); 

} 

_context.Todoltems.Remove(todoltem); 
await _context.SaveChangesAsync(); 

return todoltem; 

} 

DeleteTodoltem Yanıt 204 (içerik yok). 

Test DeleteTodoltem yöntemi 

Postman bir yapılacak iş öğesini silmek için kullanın: 

• Yöntem kümesine delete . 

• Silinecek nesnenin URI 'sini ayarlayın (örneğin https://iocaihost:500i/api/Todoitems/ı ). 

• Gönder i seçin. 

JavaScript ile Web API 'sini çağırma 

Bkz. öğretici: JavaScript ile ASP.NET Core Web API 'Si çağırma. 

Bu öğreticide şunların nasıl yapıladığını öğreneceksiniz: 

















• Bir Web API projesi oluşturun. 

• Bir model sınıfı ve bir veritabanı bağlamı ekleyin. 

• Bir denetleyici ekleyeceksiniz. 

• CRUD yöntemleri ekleyin. 

• Yönlendirmeyi Yapılandırma ve URL yolu. 

• Dönüş değerleri belirtin. 

• Web API'si Postman ile çağırın. 

• JavaScript ile Web API 'sini çağırın. 

Sonunda, web API'si "Yapılacaklar" öğelerini ilişkisel bir veritabanında depolanan yönetebileceği sahip. 

Genel bakış 

Bu öğretici yandaki API oluşturur: 


API 

AÇIKLAMA 

İSTEK GÖVDESİ 

YANIT GÖVDESİ 

/Api/Todoltems al 

Tüm yapılacak iş öğeleri al 

Yok. 

Yapılacaklar öğelerinin bir 
dizisi 

/Api/Todoltems/{id} al 

Bir öğeyi Kimliğine göre Al 

Yok. 

Yapılacak iş öğesi 

POST/api/Todoltems 

Yeni Öğe Ekle 

Yapılacak iş öğesi 

Yapılacak iş öğesi 

/Api/Todoltems/{id} koy 

Mevcut öğeyi güncelleştirin 

Yapılacak iş öğesi 

Yok. 

/Api/Todoltems/{id} SİL 

Öğeyi Sil 

Yok. 

Yok. 


Aşağıdaki diyagramda, bu uygulamanın tasarımını gösterir. 



Prerequisites 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Visual Studio 2019 ile ASP.NET ve web geliştirme iş yükü 

• .NET core SDK 2.2 veya üzeri 
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Visual Studio 2017 kullanıyorsanız bkz dotnet/SDK'sı sorun #3124 Visual Studio ile çalışmayan .NET Core SDK sürümleri 
hakkında bilgi için. 


Birvveb projesi oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 


• Dosya menüsünden Yeni > Proje' yi seçin. 

• ASP.NET Core Web uygulaması şablonunu seçin ve İleri 1 ye tıklayın. 

• Projeyi TodoApi olarak adlandırın ve Oluştur 1 a tıklayın. 

• Yeni birASP.NET Core Web uygulaması oluştur iletişim kutusunda, .net Core ve ASP.NET Core 2,2 ' 

un seçili olduğunu doğrulayın. API şablonunu seçin ve Oluştur 1 a tıklayın. Docker desteğini etkinleştir ' i 
seçmeyin . 


X 


Create a new ASP.NET Core Web Application 


.NET Core 


ASP.NET Core 


2.2 


^ Empty 

An empty project templ>ıte for oreriting arı ASP.NFT Core application. Ttıis template does not have any 
content in it. 


A project template for creating an ASP.NET Core application with an example Controller for a RESTful HTTP 
service. This template can also be used for ASP.NET Core MVC Views and Controllers. 


Web Application 

A project template for creating an ASP.NL I Core application wtth example ASP.NL I Core Kazor Pages content. 


Web Application (Model-View-Controller) 


A project template tor creating an ASP.NET Core application with example ASP.NET Core MVC Views and 
Controllers. Ihis template can also be used for RbSIful H11P Services. 


□i C ii Razor Class Library 

®ıl 

A project template (or creating a Razor dass library. 


Anoular 

Gel additiorıal project lerrıplales 


Authentication 

No Authentication 

Change 


Advanced 
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(Iteguires Docker Uesktop) 


Author: Microsoft 
Source: SDK 2.2.20T 
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API'yi test etme 

Proje şablonu oluşturur bir values API. Çağrı Get uygulamayı test etmek için bir tarayıcıdan yöntemi. 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Uygulamayı çalıştırmak için CTRL + F5 tuşlarına basın. Visual Studio bir tarayıcı ile başlatarak 
https://localhost:<port>/api/vaiues burada <port> bir rastgele seçilen bağlantı noktası numarasıdır. 

11S Express sertifika güven varsa soran bir iletişim kutusu alırsanız seçin Evet, içinde Güvenlik Uyarısı 
ardından, görüntülenen iletişim seçin Evet. 


























Aşağıdaki JSON döndürülür: 


["valuel" , "value2"] 


Bir model sınıfı ekleme 

A modeli uygulamayı yöneten verilerini temsil eden sınıflar kümesidir. Tek bir modeldir bu uygulama için 
Todoltem Sinifl. 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• içinde Çözüm Gezgini, projeye sağ tıklayın. Seçin ekleme > yeni klasör. Klasör adı modelleri. 

• Sağ modelleri klasörü ve select Ekle > sınıfı. Sınıf adı Todoıtem seçip Ekle. 

• Şablon kodunu aşağıdaki kodla değiştirin: 

namespace TodoApi.Models 
{ 

public class Todoltem 
{ 

public long Id { get; set; } 
public string Name { get; set; } 
public bool IsComplete { get; set; } 

} 

} 

id Özelliği işlevlerinin bir ilişkisel veritabanında benzersiz anahtar. 

Model sınıfları herhangi bir projede gidip ancak modelleri klasörü, kural olarak kullanılır. 

Veritabanı bağlamı Ekle 

VeritabariL bağlami koordine eden bir veri modeli için Entity Framework işlevsellik ana sınıftır. Bu sınıf türetme 
tarafından oluşturulan Microsoft. EntityFrameworkCore.DbContext Sinifl. 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

• Sağ modelleri klasörü ve select Ekle > sınıfı. Sınıf adı TodoContext tıklatıp Ekle. 


• Şablon kodunu aşağıdaki kodla değiştirin: 





using Microsoft.EntityFrameworkCore; 

namespace TodoApi.Models 
{ 

public class TodoContext : DbContext 
{ 

public TodoContext(DbContextOptions<TodoContext> options) 
: base(options) 

{ 

} 

public DbSet<TodoItem> Todoltems { get; set; } 

} 

} 


Veritabanı bağlamı Kaydet 

ASP.NET Core DB bağlamı gibi hizmetler ile kaydedilmelidir bağımlılık ekleme (dı) kapsayıcı. Kapsayıcı hizmeti 
denetleyicilerine sağlar. 

Güncelleştirme Startup.es aşağıdaki vurgulanmış kodu: 



// Unused usings removed 

using Microsoft.AspNetCore.Builder; 

using Microsoft.AspNetCore. Hosting; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.EntityFrameworkCore; 

using Microsoft. Extensions.Configuration; 

using Microsoft.Extensions.Dependencylnjection; 

using TodoApi.Models; 

namespace TodoApi 

{ 

public class Startup 

{ 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

// This method gets called by the runtime. Use this method to add Services to the 
//Container. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<TodoContext>(opt => 
opt.UseInMemoryDatabase("TodoList")); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

} 

// This method gets called by the runtime. Use this method to configure the HTTP 
//request pipeline. 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

// The default HSTS value is 30 days. You may want to change this for 
// production scenarios, see https://aka.ms/aspnetcore-hsts. 
app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseMvc(); 

} 

} 

} 


Yukarıdaki kod: 

• Kullanılmayan kaldırır using bildirimleri. 

• Veritabanı bağlamı Dİ kapsayıcıya ekler. 

• Veritabanı bağlamı bir bellek içi veritabanına kullanacağını belirtir. 

Denetleyici ekleme 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

• Sağ denetleyicileri klasör. 


• > Yeni öğe Ekle 1 yi seçin. 



• İçinde Yeni Öğe Ekle iletişim kutusunda API denetleyici sınıfı şablonu. 

• Sınıf adı TodoControllerseçp Ekle. 
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• Şablon kodunu aşağıdaki kodla değiştirin: 

using Microsoft.AspNetCore.Mvc; 
using Microsoft.EntityFrameworkCore; 
using System.Collections.Generic; 
using System.Linq; 
using System.Threading.Tasks; 
using TodoApi.Models; 

namespace TodoApi.Controllers 

{ 

[Route("api/[controller]")] 

[ApiController] 

public class TodoController : ControllerBase 

{ 

private readonly TodoContext _context; 

public TodoController(TodoContext context) 

{ 

_context = context; 

if (_context.TodoItems.Count() == 0) 

{ 

// Create a new Todoltem if collection is empty, 

// which means you can't delete ali Todoltems. 
_context.TodoItems.Add(new Todoltem { Name = "Iteml" }); 
_context.SaveChanges(); 

} 

} 

} 

} 


Yukarıdaki kod: 
















• Bir API denetleyicisi sınıfı yöntemleri olmadan tanımlar. 

• Sınıfı [ApiControiler] özniteliğiyle işaretler. Bu öznitelik, denetleyicinin web API'si isteklerine yanıt verdiğini 
gösterir. Özniteliğin izin aldığı belirli davranışlar hakkında daha fazla bilgi için bkz. ASP.NET Core ile Web 
API 'Leri oluşturma. 

• Veritabanı bağlamı eklemesine Dİ kullanır ( TodoContext ) içine denetleyici. Her bir veritabanı bağlamı 
kullanılan CRUD denetleyici yöntemleri. 

• Adlı bir öğe ekler ıtemi veritabanı boşsa veritabanı. Her çalıştığında bu kod oluşturucusunun içinde yeni bir 
HTTP isteği olduğundan. Tüm öğeleri silerseniz, oluşturucu oluşturur ıtemi API yöntemi çağrıldığında 
tekrar başlattığınızda. Bu nedenle, gerçekten işe yaradı silme işlemi işe yaramadı gibi görünebilir. 

Get yöntemleri ekleyin 

Yapılacak iş öğeleri alır bir API sağlamak için aşağıdaki yöntemi ekleyin. TodoControiler sınıfı: 

// GET: api/Todo 
[HttpGet] 

public async Task<ActionResult<IEnumerable<TodoItem>>> GetTodoItems() 

{ 

return await _context.TodoItems.ToListAsync(); 

} 

// GET: api/Todo/5 
[HttpGet("{id}") ] 

public async Task<ActionResult<TodoItem>> GetTodoItem(long id) 

{ 

var todoltem = await _context.TodoItems.FindAsync(id); 

if (todoltem == null) 

{ 

return NotFound(); 

} 

return todoltem; 

} 

iki GET uç noktası bu yöntemleri uygulayın: 

• GET /api/todo 

• GET /api/todo/{id} 

Hala çalışıyorsa uygulamayı durdurun. Ardından, en son değişiklikleri dahil etmek için yeniden çalıştırın. 

Bir tarayıcıdan iki uç nokta çağırarak uygulamayı test edin. Örneğin: 

• https://localhost:<port>/api/todo 

• https://localhost:<port>/api/todo/l 

Şu HTTP yanıtı çağrısı tarafından üretilen GetTodoitems : 


{ 

"id": I, 

"name": "Iternl", 
"isComplete": false 

} 

] 









URL Yönlendirme ve yolları 

[HttpGet] Özniteliği bir HTTP GET isteğine yanıt vermeden bir yöntemi gösterir. Her yöntem için URL yolu şu 
şekilde oluşturulur: 

• Denetleyicinin şablonu dizesi ile başlayıp Route özniteliği: 

namespace TodoApi.Controllers 
{ 

[Route("api/[controller]")] 

[ApiController] 

public class TodoController : ControllerBase 
{ 

private readonly TodoContext _context; 

• Değiştirin [controiler] denetleyicinin adı ile kural tarafından olduğu "Controller" soneki eksi denetleyici 
sınıfı adı. Bu örnek, denetleyici sınıfı adı olan TodoDenetleyici adı "todo" Bu nedenle denetleyicisi. 

AS P.N ET Core yönlendirme büyük/küçük harfe duyarlıdır. 

• [HttpGet] özniteliğinin bir yol şablonu varsa (örneğin, [HttpGet("products")] ), yola ekleyin. Bu örnek, 
bir şablon kullanmaz. Daha fazla bilgi için özniteliği Http [eylem] özniteliği ile yönlendirme. 


Aşağıdaki GetTodoitem yöntemi "{id}" yapılacak iş öğesi benzersiz tanımlayıcısı için bir yer tutucu 
değişkendir. Zaman GetTodoitem çağrılır, değerini "{id}" yöntemine URL'de sağlanan kendi id parametresi. 

// GET: api/Todo/S 
[HttpGet("{id}")] 

public async Task<ActionResult<TodoItem>> GetTodoItem(long id) 

{ 

var todoltem = await _context.TodoItems.FindAsync(id); 

if (todoltem == null) 

{ 

return NotFound(); 

} 

return todoltem; 

} 


Döndürülen değerler 

Dönüştürümü GetTodoitems ve GetTodoitem yöntemler actionresult öğesini <T > türü. AS P.N ET Core, nesneyi 
otomatik olarak serileştiren JSON ve yanıt iletisinin gövdesine JSON yazar.Yanıt kodu 200 bu dönüş türü için 
olduğu varsayılırsa işlenmeyen özel durumlar vardır, işlenmeyen özel durumları 5xx hatalarla karşılaşırsanız 
çevrilir. 

ActionResuit dönüş türleri, geniş HTTP durum kodları temsil edebilir.Örneğin, GetTodoitem iki farklı durum 
değerleri döndürebilir: 

• Öğe istenen kimliği eşleşirse, yöntem bir 404 döndürür NotFound hata kodu. 

• Aksi takdirde yöntem bir JSON yanıt gövdesine 200 döndürür. Döndüren item sonuçları bir HTTP 200 
yanıtı. 

Test GetTodoitems yöntemi 

Bu öğreticide Postman web API'si test etmek için kullanılır. 


• Postman'yi yükleme. 

















• Web uygulaması başlatın. 

• Postman'i başlatın. 

• SSL sertifikası doğrulamasınıdevre dışı bırakın. 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

• Dosya > ayarları ' ndan (genel sekmesinden) SSL sertifikası doğrulamasınıdevre dışı bırakın. 


VVARNING 

Test denetleyicisi sonra SSL sertifika doğrulamasını yeniden etkinleştirin. 


• Yeni bir istek oluşturun. 

o HTTP yöntemi kümesine alma. 

o İstek U RL'si kümesine https://localhost:<port>/api/todo .Örneğin: https://localhost:5001/api/todo 


• Ayarlama iki bölme görünümü postman'deki. 

• Gönder i seçin. 
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Create yöntemi ekleme 


Aşağıdaki PostTodoitem yöntemini Controllers/TodoController. csiçine ekleyin: 



















// POST: api/Todo 
[HttpPost] 

public async Task<ActionResult<TodoItem>> PostTodoItem(TodoItem item) 

{ 

_context.Todoltems.Add(item); 
await _context.SaveChangesAsync(); 

return CreatedAtAction(nameof(GetTodoltem ), new { id = item.Id }, item); 

} 

Yukarıdaki kod, [HttpPost] özniteliğiyle gösterildiği gibi bir http post yöntemidir. Yöntemi, HTTP isteği 
gövdesinden Yapılacaklar öğenin değerini alır. 

CreatedAtAction Yöntemi: 

• Başarılı olursa bir HTTP 201 durum kodu döndürür. HTTP 201 sunucuda yeni bir kaynak oluşturan bir 
HTTP POST yöntemi için standart yanıttır. 

• Yanıta bir Location üst bilgisi ekler. Location üstbilgisi, yeni oluşturulan Yapılacaklar öğesinin URI 'sini 
belirtir. Daha fazla bilgi için 10.2.2 201 oluşturuldu. 

• Location üst bilgisinin URI 'sini oluşturmak için GetTodoltem eyleme başvurur. C# nameof anahtar 
sözcüğü, CreatedAtAction çağrısında eylem adının sabit kodlanmasını önlemek için kullanılır. 

// GET: api/Todo/S 
[HttpGet("{id}") ] 

public async Task<ActionResult<TodoItem>> GetTodoItem(long id) 

{ 

var todoltem = await _context.TodoItems.FindAsync(id); 

if (todoltem == null) 

{ 

return NotFound(); 

} 

return todoltem; 

} 


Test PostTodoltem yöntemi 

• Projeyi oluşturun. 

• Postman HTTP yöntemi kümesine post . 

• Seçin gövdesi sekmesi. 

• Seçin ham radyo düğmesi. 

• Tür kümesine JSON (application/json). 

• istek gövdesinde bir yapılacak iş öğesi için JSON girin: 

{ 

"name":"walk dog", 

"isComplete":true 

} 


• Gönder i seçin. 
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Bir 405 yöntemine İzin verilmiyor hatası alırsanız, PostTodoitem yöntemi eklendikten sonra projenin 
derlenmesinin sonucu büyük olasılıkla oluşur. 

Konum üst bilgisi URI test 
• Seçin üstbilgileri sekmesinde yanıt bölmesi. 


• Kopyalama konumu üst bilgi değeri: 
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• Yöntemini GET öğesine Ayarla. 

• URI'yi yapıştırın (örneğin, https://iocaihost:500i/api/Todo/2 ). 

• Gönder i seçin. 

PutTodoltem yöntemi ekleme 


Aşağıdaki PutTodoltem yöntemi: 





























// PUT: api/Todo/5 
[HttpPut("{id}")] 

public async Task<IActionResult> PutTodoItem(long id, Todoltem item) 

{ 

if (id != item.Id) 

{ 

return BadRequest(); 

} 

_context.Entry(item).State = EntityState.Modified; 
await _context.SaveChangesAsync(); 

return NoContent(); 

} 

PutTodoitem benzer PostTodoitem , HTTP PUT kullanır.Yanıt 204 (içerik yok). HTTP belirtimine göre bir PUT 
isteği tüm güncelleştirilmiş varlık yalnızca değişiklikler değil göndermek istemci gerektirir. Kısmi 
güncelleştirmeleri desteklemek için kullanma HTTP PATCH. 

PutTodoitem çağırırken bir hata alırsanız, veritabanında bir öğe olduğundan emin olmak için get çağırın. 

Test PutTodoitem yöntemi 

Bu örnek, uygulama her başlatıldığında başlatılmış olması gereken bellek içi bir veritabanını kullanır. Bir PUT 
çağrısı yapmadan önce veritabanında bir öğe olmalıdır. PUT çağrısı yapmadan önce veritabanında bir öğe 
olduğundan emin olmak için GET çağrısı yapın. 

Kimliğine sahip bir yapılacak iş öğesi güncelleştirme = 1 ve "balık akış için" adını girin: 

{ 

"ID":1, 

"name":"feed fish", 

"isComplete":true 

} 


Aşağıdaki görüntüde, Postman güncelleştirme gösterilmektedir: 
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DeleteTodoltem yöntemi ekleme 

Aşağıdaki DeleteTodoltem yöntemi: 

// DELETE: api/Todo/5 
[HttpDelete("{id}")] 

public async Task<IActionResult> DeleteTodoItem(long İd) 

{ 

var todoltem = await _context.TodoItems.FindAsync(id); 

if (todoltem == null) 

{ 

return NotFound(); 

} 

_context.Todoltems.Remove(todoltem); 
await _context.SaveChangesAsync(); 

return NoContent(); 

} 

DeleteTodoltem Yanıt 204 (içerik yok). 

Test DeleteTodoltem yöntemi 

Postman bir yapılacak iş öğesini silmek için kullanın: 

• Yöntem kümesine delete . 

• Silinecek nesnenin URI 'sini ayarlayın (örneğin https://iocaihost:500i/api/todo/ı ). 

• Gönder i seçin. 

Örnek uygulama, tüm öğeleri silmenizi sağlar.Ancak, son öğe silindiğinde, API 'nin bir sonraki çağrılışında 
model sınıfı Oluşturucu tarafından yeni bir tane oluşturulur. 

JavaScript ile Web API 'sini çağırma 

Bu bölümde, Web API 'sini çağırmak için JavaScript kullanan bir HTML sayfası eklenir.jöuery isteği başlatır. 
JavaScript, sayfayı Web API 'sinin yanıtından alınan ayrıntılarla güncelleştirir. 

Uygulamayı statik dosyalara sunacak şekilde yapılandırın ve aşağıdaki vurgulanmış kodla Startup.es 
güncelleştirerek varsayılan dosya eşlemesini etkinleştirin : 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopmentO) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

// The default HSTS value is 30 days. You may want to change this for 
// produetion scenarios, see https://aka.ms/aspnetcore-hsts. 
app.UseHsts(); 

} 

app.UseDefaultFiles(); 
app.UseStaticFiles(); 
app.UseHttpsRedirection(); 
app.UseMvc(); 






Oluşturma bir wwwroot proje dizininde klasör. 


Adlı bir HTML dosyası ekleyin index.html için wwwroot dizin. Dosyanın içeriğini aşağıdaki biçimlendirme ile 
değiştirin: 

<!DOCTYPE html> 

<html> 

<head> 

<meta charset="UTF-8"> 

<title>To-do CRUD</title> 

<style> 

input[type='submit' ], button, [aria-label] { 
cursor: pointer; 

} 

#spoiler { 

display: none; 

} 

table { 

font-family: Arial, sans-serif; 
border: lpx solid; 
border-collapse: collapse; 

} 

th { 

background-color: #0066CC; 
color: white; 

} 

td { 

border: lpx solid; 
padding: 5px; 

} 

</style> 

</head> 

<body> 

<hl>To-do CRUD</hl> 

<h3>Add</h3> 

<form action="javascript:void(0);" method="POST" onsubmit="addItem()"> 

<input type="text" id="add-name" placeholder="New to-do"> 

<input type="submit" value="Add"> 

</form> 

<div id="spoiler"> 

<h3>Edit</h3> 

<form class="my-form"> 

<input type="hidden" id="edit-id"> 

<input type="checkbox" id="edit-isComplete"> 

<input type="text" id="edit-name"> 

<input type="submit" value="Save"> 

<a onclick="closeInput()" aria-label="Close">&#10006;</a> 

</form> 

</div> 

<p id="counter"x/p> 

<table> 

<tr> 

<th>Is Complete</th> 

<th>Name</th> 

<thx/th> 

<thx/th> 

</tr> 

<tbody id="todos"x/tbody> 

</table> 


<scrıpt src= "rıttps://coae.]query.com/]query-J.J.l.mın.]s" 

integrity="sha256-FgpCb/KDQlLNfOu91ta32o/NMZxltwRo8QtmkMRdAu8= 

crossorigin="anonymous"x/script> 

<script src="site.js"x/script> 

</body> 

</html> 


Adlı bir JavaScript dosyası ekleyin site.js için wwwroot dizin. Dosyanın içeriği 

const uri = "api/todo"; 
let todos = null; 
function getCount(data) { 
const el = $("#counter"); 
let name = "to-do"; 
if (data) { 

if (data > 1) { 
name = "to-dos"; 

} 

el.text(data + " " + name); 

} else { 

el.text("No " + name); 

} 


$(document).ready(function() { 
getData(); 

}); 

function getData() { 

$.ajax({ 

type: "GET", 
url: uri, 
cache: false, 
success: function(data) { 
const tBody = $("#todos"); 

$(tBody).empty(); 

getCount(data.length); 

$.each(dataj function(key, item) { 
const tr = $("<trx/tr>") 

.append( 

$( "<tdx/td>") .append( 

$("<input/>", { 
type: "checkbox", 
disabled: true, 
checked: item.isComplete 

}) 

) 

) 

.append($("<tdx/td>") .text(item.name)) 

.append( 

$( "<tdx/td>") .append( 

$("<button>Edit</button>").on("click"j function() { 
editltem(item.id); 

}) 

) 

) 

.append( 

$( "<tdx/td>") .append( 

$("<button>Delete</button>").on("click"j function() { 
deleteltem(item.id); 

}) 

) 

); 


i aşağıdaki kodla değiştirin: 


■cr.appena lo^rboay;; 

»j 

todos = data; 

} 

})J 

} 

function addltem() { 
const item = { 

name: $("#add-name").val(), 
isComplete: false 

}; 


$.ajax({ 

type: "POST", 

accepts: "application/json", 
url: uni, 

contentType: "application/json", 
data: TSON.stringify(item), 

error: function(jqXHR, textStatus, errorThrown) { 
alert("Something went wrong!"); 

}, 

success: function(result) { 
getData(); 

$("#add-name").val("")j 

} 

»J 


function deleteltem(id) { 
$.ajax({ 

url: uri + "/" + id, 
type: "DELETE", 
success: function(result) { 
getData(); 

} 

}); 


function editltem(id) { 

$.each(todos, function(key, item) { 
if (item.id === id) { 

$("#edit-name").val(item.name); 

$("#edit-id").val(item.id); 

$("#edit-isComplete")[0].checked = item.İsComplete 

} 

}); 

$("#spoiler").css({ display: "block" }); 

} 

$(".my-form").on("submit", function() { 
const item = { 

name: $("#edit-name").val(), 

İsComplete: $("#edit-isComplete").is(":checked"), 
id: $("#edit-id").val() 

}; 


$.ajax({ 

url: uri + "/" + $("#edit-id").val(), 
type: "PUT", 

accepts: "application/json", 
contentType: "application/json", 
data: ISON.stringify(item), 
success: function(result) { 
getData(); 

} 


closeInput(); 
retunn false; 

}); 

function closeInput() { 

$("#spoilen").css({ display: "none" }); 

} 


ASP.NET Core proje başlatma ayarlarında bir değişiklik HTML sayfasını yerel olarak test etmek için gerekli: 

• Açık Properties\launchSettings.json. 

• Kaldırma launchuri , açmak için uygulamayı zorlamak için özellik index.html —projenin varsayılan dosya. 
Bu örnek, Web API 'sinin tüm CRUD yöntemlerini çağırır.API çağrıları açıklamaları aşağıda verilmiştir. 

Yapılacaklar öğelerinin bir listesini alın 

jQuery, bir to-do öğesi dizisini temsil eden JSON döndüren Web API 'sine bir HTTP GET isteği gönderir, 
success istek başarılı olursa geri çağırma işlevi çağrılır.Geri çağırma içinde DOM Yapılacaklar bilgilerle 
güncelleştirilir. 





$(document).ready(function() { 
getData(); 

}); 

function getData() { 

$.ajax({ 

type: "GET", 
url: uni, 
cache: false, 
success: function(data) { 
const tBody = $("#todos"); 

$(tBody).empty(); 

getCount(data.length); 

$.each(dataj function(key, item) { 
const tr = $("<trx/tr>") 

.append( 

$( "<tdx/td>") .append( 

$("<input/>"., { 
type: "checkbox", 
disabled: true, 
checked: item.isComplete 

}) 

) 

) 

.append($( "<tdx/td>").text(item. name)) 

.append( 

$( "<tdx/td>") .append( 

$("<button>Edit</button>").on("click"j function() { 
editltem(item.id); 

}) 

) 

) 

.append( 

$( "<tdx/td>") .append( 

$("<button>Delete</button>").on("click"j function() { 
deleteltem(item.id); 

}) 

) 

); 

tr.appendTo(tBody); 

}); 

todos = data; 

} 

}); 

} 


Yapılacak İş Öğesi Ekle 

jQuery, istek gövdesinde Yapılacaklar öğesiyle bir HTTP POST isteği gönderir, accepts Ve contentType 
seçeneklerini ayarlamak appücation/json gönderilen ve alınan medya türü belirtmek için. Yapılacak iş öğesi 
kullanarak JSON'a dönüştürülür JSON.stringify. API'yi bir başarılı durum kodu döndürdüğünde getData işlevi 
HTML tablosu güncelleştirmek için çağrılır. 








function addltem() { 
const item = { 

name: $("#add-name").val(), 
isComplete: false 

}; 

$.ajax({ 

type: "POST", 

accepts: "application/json", 
url: uri, 

contentType: "application/json", 
data: HSON.stringify(item), 

error: function(jqXHR, textStatus, errorThrown) { 
alert("Something went wrong!"); 

L 

success: function(nesult) { 
getData(); 

$("#add-name").val("")j 

} 

}); 


Yapılacak iş öğesini güncelleştirme 

Yapılacak iş öğesi güncelleştirilirken bir eklemeye benzerdir, url Öğenin benzersiz tanıtıcısı eklemek için 
değişiklikleri ve type olduğu put . 

$.ajax({ 

url: uri + "/" + $("#edit-id").val(), 
type: "PUT", 

accepts: "application/json", 
contentType: "application/json", 
data: JSON.stringify(item), 
success: function(result) { 
getData(); 

} 

}); 


Yapılacak iş öğesi silme 

Yapılacak iş öğesi silme gerçekleştirilir ayarlayarak type AJAX çağrısı hedefi üzerinde delete ve öğenin 
benzersiz tanıtıcısı URL'yi belirterek. 

$.ajax({ 

url: uri + "/" + id, 
type: "DELETE", 
success: function(result) { 
getData(); 

} 

}); 


Web API 'sine kimlik doğrulama desteği ekleme 

ASP.NET Core kimlik, ASP.NET Core Web uygulamalarına Kullanıcı arabirimi (Ul) oturum açma işlevselliği 
ekler. Web API 'Leri ve maça 'ları güvenli hale getirmek için aşağıdakilerden birini kullanın: 

• Azure Active Directory 

• Azure Active Directory B2C (Azure AD B2C)] 

• Identityserver4 










Identityserver4, AS P.N ET Core 3,0 için bir Öpeni D Connect ve OAuth 2,0 çerçevesidir. Identityserver4 aşağıdaki 
güvenlik özelliklerini sunar: 

• Hizmet olarak kimlik doğrulaması (AaaS) 

• Birden çok uygulama türü üzerinde çoklu oturum açma/kapatma (SSO) 

• API'Ler için erişim denetimi 

• Federasyon ağ geçidi 

Daha fazla bilgi için bkz. ıdentityserver4 to VVelcome. 

Ek kaynaklar 

Görüntülemek veya Bu öğretici için örnek kodu indirdikten. Bkz: nasıl indirileceğini. 

Daha fazla bilgi için aşağıdaki kaynaklara bakın: 

• ASP.NET Core ile Web API 'Leri oluşturma 

• AS P.N ET Core Web API Yardım sayfaları ile Svvagger / Openapı 

• ASP.NET Core - Öğreticisi 1.8'de Entity Framework Core ile Razor sayfaları 

• ASP.NET Core denetleyici eylemlerine yönlendirme 

• ASP.NET Core Web API 'sindeki denetleyici eylemi dönüş türleri 

• AS P.N ET Core uygulamalarını Azure App Service dağıtma 

• ASP.NET Core barındırma ve dağıtma 

• Bu öğreticinin YouTube sürümü 



MongoDB ile ASPNET Core ile web API'si oluşturma 

6.12.2019 • 33 minutes to read ı Edit Online 
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Bu öğreticide web API'si temel oluşturma, okuma, güncelleştirme ve silme (CRUD) işlemleri gerçekleştiren 
oluşturur bir MongoDB NoSQL veritabanı. 

Bu öğreticide şunların nasıl yapıladığını öğreneceksiniz: 

• MongoDB yapılandırın 

• MongoDB veritabanı oluşturma 

• MongoDB koleksiyonu ve şema tanımlayın 

• Bir vveb API'sini MongoDB CRUD işlemleri gerçekleştirme 

• JSON serileştirmesini özelleştirme 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Prerequisites 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• .NET Core SDK 3.0 veya üzeri 

• ASP.net ve Web geliştirme iş yüküyle Visual Studio 2019 

• MongoDB 

MongoDB yapılandırın 

Windows kullanıyorsanız MongoDB, varsayılan olarak mongodb\C:\Program Fileş 'a yüklenir. \Program 
Files\MongoDB\Server\ <Version_Number >\ Path ) ortam değişkenine ekleyin. Bu değişiklik yerden MongoDB 
erişim sağlar, geliştirme makinenizde. 

Mongo kabuğunu veritabanı oluşturma, koleksiyonları yapın ve belgeleri depolamak için aşağıdaki adımları 
kullanın. Mongo Kabuğu komutları hakkında daha fazla bilgi için bkz. mongo kabuğunu çalışma. 

1. Geliştirme makinenizde verilerin depolanması için bir dizin seçin. Örneğin, C: Windows üzerinde\BooksData 
. Yoksa dizini oluşturun. Mongo kabuğunu yeni dizinleri oluşturmaz. 

2. Bir komut kabuğunu açın. Varsayılan bağlantı noktası 27017 mongodb'ye bağlanmak için aşağıdaki komutu 
çalıştırın. Değiştirmeyi unutmayın <data_directory_path> önceki adımda seçtiğiniz dizini. 

mongod --dbpath <data_directory_path> 

3. Başka bir komut kabuğu örneği açın. Aşağıdaki komutu çalıştırarak varsayılan test veritabanı'na bağlanma: 

mongo 


4. Bir komut kabuğu'nda aşağıdaki komutu çalıştırın: 







use BookstoreDb 


Adlı bir veritabanı zaten mevcut olmayan halinde BookstoreDb oluşturulur. Veritabanı mevcut değilse, 
bağlantı işlemleri için açılır. 

5. Oluşturma bir Books koleksiyon aşağıdaki komutu kullanarak: 

db.createCollection('Books') 


Aşağıdaki sonucu görüntülenir: 

{ "ok" : 1 } 

6. için bir şema tanımlayabilir Books toplama ve ekleme iki belge aşağıdaki komutu kullanarak: 

db.Books.insertMany([{'Name':'Design Patterns','Price':54.93,'Category':'Computers','Author':’Ralph 
lohnson'}, {'Name':'Clean Code','Price':43.15,'Category'Computers','AuthorRobert C. Martin'}]) 


Aşağıdaki sonucu görüntülenir: 


{ 

"acknowledged" : true, 

"insertedlds" : [ 

ObjectId("5bfd996f7b8e48dcl5ff215d"), 
ObjectId("5bfd996f7b8e48dcl5ff215e") 

] 


NOTE 

Bu makalede gösterilen KİMLİK, bu örneği çalıştırdığınızda kimliklerle eşleşmeyecektir. 


7. Aşağıdaki komutu kullanarak veritabanında belgelerini görüntüleyin: 

db.Books.find({}).pretty() 


Aşağıdaki sonucu görüntülenir: 


{ 

"_id" : ObjectId("5bfd996f7b8e48dcl5ff215d"), 
"Name" : "Design Patterns", 

"Price" : 54.93, 

"Category" : "Computers", 

"Author" : "Ralph Dohnson" 

} 

{ 

"_id" : ObjectId("5bfd996f7b8e48dcl5ff215e"), 
"Name" : "Clean Code", 

"Price" : 43.15, 

"Category" : "Computers", 

"Author" : "Robert C. Martin" 

} 










Şema girmiş ekler _id türünün özelliği objectid her belge için. 


Veritabanı hazırdır.ASP.N ET Core web API'si oluşturmaya başlayabilirsiniz. 

ASP.NET Core web API projesi oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

1. Dosya > Yeni > projesi' ne gidin. 

2. ASP.N ET Core Web uygulaması proje türünü seçin ve İleri' yi seçin. 

3. Projeyi Booksapıolarak adlandırın ve Oluştur' u seçin. 

4. .NET Core hedef çerçevesini ve 3,0 ASP.N ET Coreseçin. API proje şablonunu seçin ve Oluştur' u seçin. 

5. MongoDB için .NET sürücüsünün en son kararlı sürümünü öğrenmek üzere NuGet galerisini ziyaret edin: 
MongoDB. Driver . içinde Paket Yöneticisi Konsolu penceresinde proje kök dizinine gidin. MongoDB için 
.NET sürücüsünü yüklemek için aşağıdaki komutu çalıştırın: 

Install-Package MongoDB.Driver -Version {VERSION} 


Varlık modeli ekleme 


1. Ekleme bir modelleri proje kök dizini. 

2. Ekleme bir Book sınıfının modelleri aşağıdaki kod ile dizin: 

using MongoDB.Bson; 

using MongoDB.Bson.Serialization.Attributes; 

namespace BooksApi.Models 
{ 

public class Book 
{ 

[Bsonld] 

[BsonRepresentation(BsonType.Objectld)] 
public string Id { get; set; } 

[BsonElement("Name")] 

public string BookName { get; set; } 

public decimal Price { get; set; } 

public string Category { get; set; } 

public string Author { get; set; } 

} 

} 

Önceki sınıfta id özelliği: 


Ortak dil çalışma zamanı (CLR) nesnesini MongoDB koleksiyonuna eşlemek için gereklidir. 

, Bu özelliği belgenin birincil anahtarı olarak belirlemek için [Bsonid] ile açıklama eklenir. 

, Parametreyi ObjectlD yapısı yerine tür string olarak geçirmeyi sağlayan 
[BsonRepresentation(BsonType.Objectld) ] ile açıklama eklenir. Mongo, string dönüştürmeyi Objectld 

















olarak işler. 

BookName özelliğine [BsonElement] özniteliğiyle açıklama eklenir. Özniteliğin Name değeri, MongoDB 
koleksiyonundaki özellik adını temsil eder. 

Yapılandırma modeli ekleme 

1. Aşağıdaki veritabanı yapılandırma değerlerini appSettings. JSOA/öğesine ekleyin: 

{ 

"BookstoreDatabaseSettings": { 

"BooksCollectionName": "Books", 

"ConnectionString": "mongodb://localhost:27017", 

"DatabaseName": "BookstoreDb" 

}, 

"Logging": { 

"IncludeScopes": false, 

"Debug": { 

"LogLevel": { 

"Default": "l/Jarning" 

} 

}, 

"Console": { 

"LogLevel": { 

"Default": "l/Jarning" 

} 

} 

} 

} 


2. Modeller dizinine aşağıdaki kodla bir BookstoreDatabaseSettlngs.es dosyası ekleyin: 

namespace BooksApi.Models 

{ 

public elass BookstoreDatabaseSettings : IBookstoreDatabaseSettings 

{ 

public string BooksCollectionName { get; set; } 
public string ConnectionString { get; set; } 
public string DatabaseName { get; set; } 

} 

public interface IBookstoreDatabaseSettings 

{ 

string BooksCollectionName { get; set; } 
string ConnectionString { get; set; } 
string DatabaseName { get; set; } 

} 

} 

Yukarıdaki BookstoreDatabaseSettings Simfl, appSettings. JSON dosyasının BookstoreDatabaseSettings 
özellik değerlerini depolamak için kullanılır. JSON ve C# Özellik adları, eşleme sürecini kolaylaştırmak için 
aynı şekilde adlandırılır. 

3. Aşağıdaki Vurgulanan kodu startup.configureServices ekleyin: 








public void ConfigureServices(IServiceCollection Services) 

{ 

// requires using Microsoft.Extensions.Options 
Services.Configure<BookstoreDatabaseSettings>( 

Configuration.GetSection(nameof(BookstoreDatabaseSettings))); 

Services.AddSingleton<IBookstoreDatabaseSettings>(sp => 

sp.GetRequiredService<IOptions<BookstoreDatabaseSettings>>().Value); 

Services.AddControllers(); 

} 

Yukarıdaki kodda: 

• AppSettings. JSON dosyasının BookstoreDatabaseSettings bölüm bağlandığı yapılandırma örneği, 
bağımlılık ekleme (dı) kapsayıcısına kaydedilir. Örneğin, bir BookstoreDatabaseSettings nesnesinin 

ConnectionString Özelliği appSettings. JSO A/İÇİndeki BookstoreDatabaseSettingsrConnectionString 
özelliği ile doldurulur. 

• iBookstoreDatabaseSettings arabirimi, tek bir hizmet ömrüile dı 'y e kaydedilir. Eklerken, arabirim örneği 
bir BookstoreDatabaseSettings nesnesine çözümlenir. 

4. BookstoreDatabaseSettings ve iBookstoreDatabaseSettings başvurularını çözümlemek için aşağıdaki kodu 
en üst kısmına ekleyin : 

using BooksApi.Models; 


CRUD işlemleri hizmeti ekleme 

1. Ekleme bir Hizmetleri proje kök dizini. 


2. Ekleme bir BookService sınıfının Hizmetleri aşağıdaki kod ile dizin: 













using BooksApi.Models; 
using MongoDB.Driver; 
using System.Collections.Generic; 
using System.Linq; 

namespace BooksApi.Services 

{ 

public class BookService 

{ 

private readonly IMongoCollection<Book> _books; 

public BookService(IBookstoreDatabaseSettings settings) 

{ 

var Client = new MongoClient(settings.ConnectionString); 
var database = Client.GetDatabase(settings.DatabaseName); 

_books = database.GetCollection<Book>(settings.BooksCollectionName); 

} 

public List<Book> Get() => 

_books.Find(book => true).ToList(); 

public Book Get(string id) => 

_books.Find<Book>(book => book.Id == id).FirstOrDefault(); 

public Book Create(Book book) 

{ 

_books.InsertOne(book); 
return book; 

} 

public void Update(string id, Book bookln) => 

_books.ReplaceOne(book => book.Id == id, bookln); 

public void Remove(Book bookln) => 

_books.DeleteOne(book => book.Id == bookln.Id); 

public void Remove(string id) => 

_books.DeleteOne(book => book.Id == id); 

} 

} 

Yukarıdaki kodda, Oluşturucu ekleme yoluyla dı 'den bir iBookstoreDatabaseSettings örneği alınır. Bu teknik, 
yapılandırma modeli ekleme bölümüne eklenen appSettings. JSON yapılandırma değerlerine erişim sağlar. 

3. Aşağıdaki Vurgulanan kodu startup.configureServices ekleyin: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<BookstoreDatabaseSettings>( 

Configuration.GetSection(nameof(BookstoreDatabaseSettings))); 

Services.AddSingleton<IBookstoreDatabaseSettings>(sp => 

sp.GetRequiredService<IOptions<BookstoreDatabaseSettings>>().Value); 

Services.AddSingleton<BookService>(); 

Services.AddControllers(); 

} 

Önceki kodda, BookService sınıfı, tüketen sınıflarda Oluşturucu ekleme işlemini desteklemek için Dİ ile 
kaydedilir. BookService, Mongociient doğrudan bağımlılığı sağladığından, tek hizmet ömrü en uygundur. 
Resmi Mongo istemci yeniden kullanım yönergeleritemelinde Mongociient , tek bir hizmet ömrü ile birlikte 







kaydedilmelidir. 

4. BookService başvurusunu çözümlemek için aşağıdaki kodu Startup.es 'un en üstüne ekleyin: 

using BooksApi.Services; 

BookService Sınıfını kullanan aşağıdaki MongoDB.Driver veritabanında CRUD işlemleri gerçekleştirmek için 
üyeleri: 

• Mongoclient-, veritabanı işlemlerini gerçekleştirmek için sunucu örneğini okur.Bu sınıfın oluşturucusu, 
MongoDB bağlantı dizesini sağlanır: 

public BookService(IBookstoreDatabaseSettings settings) 

{ 

var Client = new MongoClient(settings.ConnectionString); 
var database = Client.GetDatabase(settings.DatabaseName); 

_books = database.GetCollection<Book>(settings.BooksCollectionName); 

} 

• Imongodatabase- işlemleri gerçekleştirmek İçin Mongo veritabanını temsil eder. Bu öğretici, belirli bir 
koleksiyondaki verilere erişim kazanmak için arabirimindeki genel GetCollection<TDocument > 
(koleksiyon) yöntemini kullanır. Bu yöntem çağrıldıktan sonra, koleksiyonda CRUD işlemleri gerçekleştirin. 
İçinde Getcoiiection<TDocument>(coiiection) yöntem çağrısı: 

o colleetion Koleksiyon adını temsil eder. 

o TDocument Bir koleksiyonda depolanan CLR nesne türünü temsil eder. 

Getcoiiection<TDocument>(colleetion) , koleksiyonu temsil eden bir Mongocollection nesnesi döndürür. Bu 
öğreticide, aşağıdaki yöntemlerden koleksiyonunda çağrılır: 

• Deleteone -, belirtilen arama ölçütleriyle eşleşen tek bir belgeyi siler. 

• -cTDocument > bul koleksiyonda belirtilen arama ölçütleriyle eşleşen tüm belgeleri döndürür. 

• Insertone -, belirtilen nesneyi koleksiyondaki yeni bir belge olarak ekler. 

• Replaceone -, belirtilen arama ölçütleriyle eşleşen tek belgeyi, belirtilen nesneyle değiştirir. 

Denetleyici ekleme 

Ekleme bir BooksControiler sınıfının denetleyicileri aşağıdaki kod ile dizin: 

using BooksApi.Models; 
using BooksApi.Services; 
using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 

namespace BooksApi.Controllers 
{ 

[Route("api/[controller]")] 

[ApiController] 

public elass BooksControiler : ControllerBase 
{ 

private readonly BookService _bookService; 

public BooksController(BookService bookService) 

{ 

_bookService = bookService; 

} 
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public ActionResult<List<Book>> Get() => 

_bookService.Get(); 

[HttpGet("{id:length(24)}", Name = "GetBook")] 
public ActionResult<Book> Get(string id) 

{ 

var book = _bookService.Get(id); 

if (book == null) 

{ 

return NotFound(); 

} 

return book; 

} 

[HttpPost] 

public ActionResult<Book> Create(Book book) 

{ 

_bookService.Create(book); 

return CreatedAtRoute("GetBook", new { id = book.Id.ToString() }, book); 

} 

[HttpPut("{id:length(24)}")] 

public IActionResult Update(string id, Book bookln) 

{ 

var book = _bookService.Get(id); 

if (book == null) 

{ 

return NotFound(); 

} 

_bookService.Update(id, bookln); 
return NoContent(); 

} 

[FlttpDelete("{id:length(24)}")] 
public IActionResult Delete(string id) 

{ 

var book = _bookService.Get(id); 

if (book == null) 

{ 

return NotFound(); 

} 

_bookService.Remove(book.Id); 
return NoContent(); 

} 

} 

} 

Önceki web API denetleyicisi: 

• Kullanan BookService CRUD işlemleri gerçekleştirmek için sınıf. 

• GET, POST, PUT ve DELETE HTTP isteklerini desteklemek için eylem yöntemleri içerir. 

• Bir HTTP 201 yanıtı döndürmek için create eylemi yönteminde CreatedAtRoute çağırır. Durum kodu 201, 
sunucuda yeni bir kaynak oluşturan HTTP POST yöntemi için standart yanıttır. CreatedAtRoute Ayrıca yanıta bir 

Location üst bilgisi ekler. Location üstbilgisi yeni oluşturulan kitabın U RI 'sini belirtir. 







Web API 'sini test etme 

1. Uygulamayı derleyin ve çalıştırın. 


2. Denetleyicinin parametresiz Get eylem yöntemini sınamak için http://iocaihost:<port>/api/books gidin. 
Aşağıdaki JSON yanıtı gösterilir: 

[ 

{ 

"id":"5bfd996f7b8e48dcl5ff215d", 

"bookName":"Design Patterns", 

"price":54.93, 

"category":"Computers", 

"author":"Ralph lohnson" 

}, 

{ 

"id":"5bfd996f7b8e48dcl5ff215e", 

"bookName":"Clean Code", 

"price":43.15, 

"category":"Computers", 

"author":"Robert C. Martin" 

} 

] 

3. Denetleyicinin aşırı yüklenmiş Get eylem yöntemini sınamak için 

http://localhost:<port>/api/books/{id here} gidin. Aşağıdaki JSON yanıtı gösterilir: 

{ 

"id":"{ID}", 

"bookName":"Clean Code", 

"price":43.15, 

"category":"Computers", 

"author":"Robert C. Martin" 


JSON serileştirme seçeneklerini yapılandırma 

Web API 'Sini test etme bölümünde döndürülen JSON yanıtları hakkında iki ayrıntı vardır: 

• ' Varsayılan ortası büyük/küçük harf özelliği, CLR nesnesinin özellik adlarının Pascal büyük küçük harfleriyle 
eşleşecek şekilde değiştirilmelidir. 

• bookName özelliği Name olarak döndürülmelidir. 

Önceki gereksinimleri karşılamak için aşağıdaki değişiklikleri yapın: 

1. JSON.NET, ASP.NET paylaşılan çerçevesinden kaldırılmıştır. Microsoft. AspNetCore. Mvc. 
NevvtonsoftJsonöğesine bir paket başvurusu ekleyin. 

2. stantup.configuneSenvices ' de, aşağıdaki vurgulanmış kodu AddMvc yöntemi çağrısına zincirle: 










public void ConfigureSenvices(IServiceCollection Services) 

{ 

Services.Configure<BookstoreDatabaseSettings>( 

Configuration.GetSection(nameof(BookstoreDatabaseSettings))); 

Services.AddSingleton<IBookstoreDatabaseSettings>(sp => 

sp.GetRequiredService<IOptions<BookstoreDatabaseSettings>>().Value); 

Services.AddSingleton<BookService>(); 

Services.AddControllers() 

.AddNewtonsoftison(options => options.UseMemberCasingO); 

} 

Önceki değişiklik ile, Web API 'sinin seri hale getirilmiş JSON yanıtındaki Özellik adları CLR nesne 
türündeki ilgili özellik adlarıyla eşleşir. Örneğin, Book sınıfının Author özelliği Author olarak serileştirir. 

3. Modeller/Book. cs' de, BookName özelliğine aşağıdaki [DsonProperty] özniteliğiyle açıklama ekleyin: 

[BsonElement("Name")] 

[DsonProperty("Name")] 

public string BookName { get; set; } 

[JsonProperty] özniteliğinin değeri Name , Web API 'sinin serileştirilmiş JSON yanıtında özellik adını temsil 
eder. 

4. [isonProperty] öznitelik başvurusunu çözümlemek için modeller/Book. cs ' nin en üstüne aşağıdaki kodu 
ekleyin: 

using Newtonsoft.Ison; 

5. Web API 'Sini test etme bölümünde tanımlanan adımları yineleyin. JSON Özellik adlarındaki farka dikkat 
edin. 

Bu öğreticide vveb API'si temel oluşturma, okuma, güncelleştirme ve silme (CRUD) işlemleri gerçekleştiren 
oluşturur bir MongoDB NoSQL veritabanı. 

Bu öğreticide şunların nasıl yapıladığını öğreneceksiniz: 

• MongoDB yapılandırın 

• MongoDB veritabanı oluşturma 

• MongoDB koleksiyonu ve şema tanımlayın 

• Bir vveb API'sini MongoDB CRUD işlemleri gerçekleştirme 

• JSON serileştirmesini özelleştirme 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Prerequisites 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• .N ET Core SDK 2,2 

• ASP.net ve Web geliştirme iş yüküyle Visual Studio 2019 

• MongoDB 











MongoDB yapılandırın 

Windows kullanıyorsanız MongoDB, varsayılan olarak mongodb\C:\Program Fileş 'a yüklenir. \Program 
Files\MongoDB\Server\ <Version_Number >\ Path ) ortam değişkenine ekleyin. Bu değişiklik yerden MongoDB 
erişim sağlar, geliştirme makinenizde. 

Mongo kabuğunu veritabanı oluşturma, koleksiyonları yapın ve belgeleri depolamak için aşağıdaki adımları 
kullanın. Mongo Kabuğu komutları hakkında daha fazla bilgi için bkz. mongo kabuğunu çalışma. 

1. Geliştirme makinenizde verilerin depolanması için bir dizin seçin. Örneğin, C: Windows üzerinde\BooksData 
. Yoksa dizini oluşturun. Mongo kabuğunu yeni dizinleri oluşturmaz. 

2. Bir komut kabuğunu açın. Varsayılan bağlantı noktası 27017 mongodb'ye bağlanmak için aşağıdaki komutu 
çalıştırın. Değiştirmeyi unutmayın <data_directory_path> önceki adımda seçtiğiniz dizini. 

mongod --dbpath <data_directory_path> 

3. Başka bir komut kabuğu örneği açın. Aşağıdaki komutu çalıştırarak varsayılan test veritabanı 1 na bağlanma: 

mongo 

4. Bir komut kabuğu'nda aşağıdaki komutu çalıştırın: 

use BookstoreDb 

Adlı bir veritabanı zaten mevcut olmayan halinde BookstoreDb oluşturulur. Veritabanı mevcut değilse, 
bağlantı işlemleri için açılır. 

5. Oluşturma bir Books koleksiyon aşağıdaki komutu kullanarak: 

db.createCollection('Books') 

Aşağıdaki sonucu görüntülenir: 

{ "ok" : ı } 

6. İçin bir şema tanımlayabilir Books toplama ve ekleme iki belge aşağıdaki komutu kullanarak: 

db.Books.insertMany([{'Name':'Design Pattenns','Price':54.93,'Category':'Computers','Author':'Ralph 
Johnson'}, {'Name':'Clean Code’,'Price’:43.15,'Category':'Computers','Author':'Robert C. Martin'}]) 


Aşağıdaki sonucu görüntülenir: 

{ 

"acknowledged" : true, 

"insertedlds" : [ 

ObjectId("5bfd996f7b8e48dcl5ff215d"), 
ObjectId("5bfd996f7b8e48dcl5ff215e") 

] 

} 












NOTE 

Bu makalede gösterilen KİMLİK, bu örneği çalıştırdığınızda kimliklerle eşleşmeyecektir. 


7. Aşağıdaki komutu kullanarak veritabanında belgelerini görüntüleyin: 
db.Books.find({}).pretty() 

Aşağıdaki sonucu görüntülenir: 

{ 

"_id" : ObjectId("5bfd996f7b8e48dcl5ff215d"), 

"Name" : "Design Patterns", 

"Price" : 54.93, 

"Category" : "Computers", 

"Author" : "Ralph Dohnson" 

} 

{ 

"_id" : ObjectId("5bfd996f7b8e48dcl5ff215e"), 

"Name" : "Clean Code", 

"Price" : 43.15, 

"Category" : "Computers", 

"Author" : "Robert C. Martin" 

} 

Şema girmiş ekler _id türünün özelliği objectid her belge için. 

Veritabanı hazırdır.ASP.N ET Core web API'si oluşturmaya başlayabilirsiniz. 

ASP.NET Core web API projesi oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

1. Dosya > Yeni > projesi' ne gidin. 

2. ASP.N ET Core Web uygulaması proje türünü seçin ve İleri' yi seçin. 

3. Projeyi Booksapıolarak adlandırın ve Oluştur' u seçin. 

4. .NET Core hedef çerçevesini ve 2,2 ASP.NET Coreseçin. API proje şablonunu seçin ve Oluştur' u seçin. 

5. MongoDB için .NET sürücüsünün en son kararlı sürümünü öğrenmek üzere NuGet galerisini ziyaret edin: 
MongoDB. Driver. içinde Paket Yöneticisi Konsolu penceresinde proje kök dizinine gidin. MongoDB için 
.NET sürücüsünü yüklemek için aşağıdaki komutu çalıştırın: 

Install-Package MongoDB.Driver -Version {VERSION} 


Varlık modeli ekleme 

1. Ekleme bir modelleri proje kök dizini. 


2. Ekleme bir Book sınıfının modelleri aşağıdaki kod ile dizin: 












using MongoDB.Bson; 

using MongoDB.Bson.Serialization.Attributes; 

namespace BooksApi.Models 

{ 

public class Book 

{ 

[Bsonld] 

[BsonRepresentation(BsonType.Objectld) ] 
public string Id { get; set; } 

[BsonElement("Name")] 

public stning BookName { get; set; } 

public decimal Pnice { get; set; } 

public stning Categony { get; set; } 

public stning Authon { get; set; } 

} 

} 

Önceki sınıfta id özelliği: 


Ortak dil çalışma zamanı (CLR) nesnesini MongoDB koleksiyonuna eşlemek için gereklidir. 

, Bu özelliği belgenin birincil anahtarı olarak belirlemek için [Bsonid] ile açıklama eklenir. 

, Parametreyi ObjectlD yapısı yerine tür stning olarak geçirmeyi sağlayan 
[BsonRepnesentation(BsonType.Objectld)] ile açıklama eklenir. Mongo, stning dönüştürmeyi Objectld 


olarak işler. 

BookName özelliğine [BsonElement] özniteliğiyle açıklama eklenir. Özniteliğin Name değeri, MongoDB 
koleksiyonundaki özellik adını temsil eder. 


Yapılandırma modeli ekleme 

1. Aşağıdaki veritabanı yapılandırma değerlerini appSettlngs. JSOA/öğesine ekleyin: 


"BookstoneDatabaseSettings": { 
"BooksCollectionName": "Books", 
"ConnectionStning": "mongodb://localhost:27017", 
"DatabaseName": "BookstoneDb" 

}, 

"Logging": { 

"IncludeScopes": false, 

"Debug": { 

"LogLevel": { 

"Default": "Wanning" 

} 

b 

"Console": { 

"LogLevel": { 

"Default": "Nanning" 

} 

} 

} 

} 


2. Modeller dizinine aşağıdaki kodla bir BookstoreDatabaseSettlngs.es dosyası ekleyin: 














namespace BooksApi.Models 

{ 

public class BookstoneDatabaseSettings : IBookstoneDatabaseSettings 

{ 

public stning BooksCollectionName { get; set; } 
public stning ConnectionString { get; set; } 
public stning DatabaseName { get; set; } 

} 

public intenface IBookstoneDatabaseSettings 

{ 

stning BooksCollectionName { get; set; } 
stning ConnectionStning { get; set; } 
stning DatabaseName { get; set; } 

} 

} 

Yukarıdaki BookstoneDatabaseSettings Sinifl, appSettings. JSON dosyasının BookstoneDatabaseSettings 
özellik değerlerini depolamak için kullanılır. JSON ve C# Özellik adları, eşleme sürecini kolaylaştırmak için 
aynı şekilde adlandırılır. 


3. Aşağıdaki Vurgulanan kodu stantup.configuneSenvices ekleyin: 


public void ConfiguneSenvices(ISenviceCollection senvices) 

{ 

senvices.Configune<BookstoneDatabaseSettings>( 

Configunation.GetSection(nameof(BookstoneDatabaseSettings))); 

senvices.AddSingleton<IBookstoneDatabaseSettings>(sp => 

sp.GetRequinedSenvice<IOptions<BookstoneDatabaseSettings>>().Value); 


} 


senvices.AddMvc() 

.SetCompatibilityVension(CompatibilityVension.Vension_2_2); 


Yukarıdaki kodda: 

• AppSettings. JSON dosyasının BookstoneDatabaseSettings bölüm bağlandığı yapılandırma örneği, 
bağımlılık ekleme (dı) kapsayıcısına kaydedilir. Örneğin, bir BookstoneDatabaseSettings nesnesinin 

ConnectionStning Özelliği appSettings. VSO/VİÇİndeki BookstoneDatabaseSettings:ConnectionStning 
özelliği ile doldurulur. 

• IBookstoneDatabaseSettings arabirimi, tek bir hizmet ömrüile dı 'ye kaydedilir. Eklerken, arabirim örneği 
bir BookstoneDatabaseSettings nesnesine çözümlenir. 

4. BookstoneDatabaseSettings ve IBookstoneDatabaseSettings başvurularım çözümlemek için aşağıdaki kodu 
en üst kısmına ekleyin : 

using BooksApi.Models; 


CRUD işlemleri hizmeti ekleme 

1. Ekleme bir Hizmetleri proje kök dizini. 


2. Ekleme bir BookSenvice sınıfının Hizmetleri aşağıdaki kod ile dizin: 
















using BooksApi.Models; 
using MongoDB.Driver; 
using System.Collections.Generic; 
using System.Linq; 

namespace BooksApi.Services 

{ 

public class BookService 

{ 

private readonly IMongoCollection<Book> _books; 

public BookService(IBookstoreDatabaseSettings settings) 

{ 

var Client = new MongoClient(settings.ConnectionString); 
var database = Client.GetDatabase(settings.DatabaseName); 

_books = database.GetCollection<Book>(settings.BooksCollectionName); 

} 

public List<Book> Get() => 

_books.Find(book => true).ToList(); 

public Book Get(string id) = > 

_books.Find<Book>(book => book.Id == id).FirstOrDefault(); 

public Book Create(Book book) 

{ 

_books.InsertOne(book); 
return book; 

} 

public void Update(string id, Book bookln) => 

_books.ReplaceOne(book => book.Id == id, bookln); 

public void Remove(Book bookln) => 

_books.DeleteOne(book => book.Id == bookln.Id); 

public void Remove(string id) => 

_books.DeleteOne(book => book.Id == id); 

} 

} 

Yukarıdaki kodda, Oluşturucu ekleme yoluyla dı 'den bir iBookstoreDatabaseSettings örneği alınır. Bu teknik, 
yapılandırma modeli ekleme bölümüne eklenen appSettings. JSON yapılandırma değerlerine erişim sağlar. 


3. Aşağıdaki Vurgulanan kodu startup.configureServices ekleyin: 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<BookstoreDatabaseSettings>( 

Configuration.GetSection(nameof(BookstoreDatabaseSettings))); 

Services.AddSingleton<IBookstoreDatabaseSettings>(sp => 

sp.GetRequiredService<IOptions<BookstoreDatabaseSettings>>().Value); 

Services.AddSingleton<BookService>(); 


} 


Services. AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


Önceki kodda, BookService sınıfı, tüketen sınıflarda Oluşturucu ekleme işlemini desteklemek için Dİ ile 
kaydedilir. BookService, Mongodient doğrudan bağımlılığı sağladığından, tek hizmet ömrü en uygundur. 






Resmi Mongo istemci yeniden kullanım yönergeleritemelinde Mongociient , tek bir hizmet ömrü ile birlikte 
kaydedilmelidir. 

4. BookService başvurusunu çözümlemek için aşağıdaki kodu Startup.es 'un en üstüne ekleyin: 

using BooksApi.Services; 

BookService Sınıfını kullanan aşağıdaki MongoDB.Driver veritabanında CRUD işlemleri gerçekleştirmek için 
üyeleri: 

• Mongociient-, veritabanı işlemlerini gerçekleştirmek için sunucu örneğini okur.Bu sınıfın oluşturucusu, 
MongoDB bağlantı dizesini sağlanır: 

public BookService(IBookstoreDatabaseSettings settings) 

{ 

var Client = new MongoClient(settings.ConnectionString); 
var database = Client.GetDatabase(settings.DatabaseName); 

_books = database.GetCollection<Book>(settings.BooksCollectionName); 

} 

• Imongodatabase- işlemleri gerçekleştirmek İçin Mongo veritabanını temsil eder. Bu öğretici, belirli bir 
koleksiyondaki verilere erişim kazanmak için arabirimindeki genel GetCollectioncTDocument > 
(koleksiyon) yöntemini kullanır. Bu yöntem çağrıldıktan sonra, koleksiyonda CRUD işlemleri gerçekleştirin, 
içinde Getcoiiection<TDocument>(coiiection) yöntem çağrısı: 

o colleetion Koleksiyon adını temsil eder. 

o TDocument Bir koleksiyonda depolanan CLR nesne türünü temsil eder. 

Getcoiiection<TDocument>(colleetion) , koleksiyonu temsil eden bir Mongocollection nesnesi döndürür. Bu 
öğreticide, aşağıdaki yöntemlerden koleksiyonunda çağrılır: 

• Deleteone -, belirtilen arama ölçütleriyle eşleşen tek bir belgeyi siler. 

• <TDocument > bul -, koleksiyonda belirtilen arama ölçütleriyle eşleşen tüm belgeleri döndürür. 

• Insertone -, belirtilen nesneyi koleksiyondaki yeni bir belge olarak ekler. 

• Replaceone -, belirtilen arama ölçütleriyle eşleşen tek belgeyi, belirtilen nesneyle değiştirir. 

Denetleyici ekleme 

Ekleme bir BooksControiler sınıfının denetleyicileri aşağıdaki kod ile dizin: 

using BooksApi.Models; 
using BooksApi.Services; 
using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 

namespace BooksApi.Controllers 
{ 

[Route("api/[controller]")] 

[ApiController] 

public elass BooksControiler : ControllerBase 
{ 

private readonly BookService _bookService; 

public BooksController(BookService bookService) 

{ 

_bookService = bookService; 

} 










[HttpGet] 

public ActionResult<List<Book>> Get() => 

_bookService.Get(); 

[HttpGet("{id:length(24)}"j Name = "GetBook")] 
public ActionResult<Book> Get(string id) 

{ 

var book = _bookService.Get(id); 

if (book == null) 

{ 

return NotFound(); 

} 

return book; 

} 

[HttpPost] 

public ActionResult<Book> Create(Book book) 

{ 

_bookService.Create(book); 

return CreatedAtRoute("GetBook ", new { id = book.Id.ToString() }, book); 

} 

[HttpPut("{id:length(24)}")] 

public IActionResult Update(string id, Book bookln) 

{ 

var book = _bookService.Get(id); 

if (book == null) 

{ 

return NotFound(); 

} 

_bookService.Update(idj bookln); 
return NoContent(); 

} 

[PlttpDelete("{id:length(24)}")] 
public IActionResult Delete(string id) 

{ 

var book = _bookService.Get(id); 

if (book == null) 

{ 

return NotFound(); 

} 

_bookService.Remove(book.Id); 
return NoContent(); 

} 

} 

} 

Önceki web API denetleyicisi: 

• Kullanan BookService CRUD işlemleri gerçekleştirmek için sınıf. 

• GET, POST, PUT ve DELETE HTTP isteklerini desteklemek için eylem yöntemleri içerir. 

• Bir HTTP 201 yanıtı döndürmek için create eylemi yönteminde CreatedAtRoute çağırır. Durum kodu 201, 
sunucuda yeni bir kaynak oluşturan HTTP POST yöntemi için standart yanıttır. CreatedAtRoute Ayrıca yanıta bir 

Location üst bilgisi ekler. Location üstbilgisi yeni oluşturulan kitabın U RI 'sini belirtir. 






Web API 'sini test etme 

1. Uygulamayı derleyin ve çalıştırın. 


2. Denetleyicinin parametresiz Get eylem yöntemini sınamak için http://iocaihost:<port>/api/books gidin. 
Aşağıdaki JSON yanıtı gösterilir: 

[ 

{ 

"id":"5bfd996f7b8e48dcl5ff215d", 

"bookName":"Design Patterns", 

"price":54.93, 

"category":"Computers", 

"author":"Ralph lohnson" 

}, 

{ 

"id":"5bfd996f7b8e48dcl5ff215e", 

"bookName":"Clean Code", 

"price":43.15, 

"category":"Computers", 

"author":"Robert C. Martin" 

} 

] 

3. Denetleyicinin aşırı yüklenmiş Get eylem yöntemini sınamak için 

http://localhost:<port>/api/books/{id here} gidin. Aşağıdaki JSON yanıtı gösterilir: 

{ 

"id":"{ID}", 

"bookName":"Clean Code", 

"price":43.15, 

"category":"Computers", 

"author":"Robert C. Martin" 


JSON serileştirme seçeneklerini yapılandırma 

Web API 'Sini test etme bölümünde döndürülen JSON yanıtları hakkında iki ayrıntı vardır: 

• ' Varsayılan ortası büyük/küçük harf özelliği, CLR nesnesinin özellik adlarının Pascal büyük küçük harfleriyle 
eşleşecek şekilde değiştirilmelidir. 

• bookName özelliği Name olarak döndürülmelidir. 

Önceki gereksinimleri karşılamak için aşağıdaki değişiklikleri yapın: 

1. startup.configureServices ' de, aşağıdaki vurgulanmış kodu AddMvc yöntemi çağrısına zincirle: 










public void ConfigureServicesOServiceCollection Services) 

{ 

Services.Configure<BookstoreDatabaseSettings>( 

Configuration.GetSection(nameof(BookstoreDatabaseSettings))); 

Services.AddSingleton<IBookstoreDatabaseSettings>(sp => 

sp.GetRequiredService<IOptions<BookstoreDatabaseSettings>>().Value); 

Services.AddSingleton<BookService>(); 

Services. AddMvc() 

.AddisonOptions(options => options.UseMemberCasingO) 
.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

} 

Önceki değişiklik ile, Web API 'sinin seri hale getirilmiş JSON yanıtındaki Özellik adları CLR nesne 
türündeki ilgili özellik adlarıyla eşleşir. Örneğin, Book sınıfının Author özelliği Author olarak serileştirir. 

2. Modeller/Book. cs' de, BookName özelliğine aşağıdaki [DsonProperty] özniteliğiyle açıklama ekleyin: 

[BsonElement("Name")] 

[]sonProperty("Name")] 

public string BookName { get; set; } 

[isonProperty] özniteliğinin değeri Name , Web API 'sinin serileştirilmiş JSON yanıtında özellik adını temsil 
eder. 


3. [isonProperty] öznitelik başvurusunu çözümlemek için modeller/Book. cs ' nin en üstüne aşağıdaki kodu 
ekleyin: 

using Newtonsoft.Ison; 

4. Web API 'Sini test etme bölümünde tanımlanan adımları yineleyin. JSON Özellik adlarındaki farka dikkat 
edin. 

Web API 'sine kimlik doğrulama desteği ekleme 

ASP.NET Core kimlik, ASP.NET Core Web uygulamalarına Kullanıcı arabirimi (Ul) oturum açma işlevselliği ekler. 
Web API 'Leri ve maça 'ları güvenli hale getirmek için aşağıdakilerden birini kullanın: 

• Azure Active Directory 

• Azure Active Directory B2C (Azure AD B2C)] 

• Identityserver4 

Identityserver4, ASP.NET Core 3,0 için bir OpenlD Connect ve OAuth 2,0 çerçevesidir.Identityserver4 aşağıdaki 
güvenlik özelliklerini sunar: 

• Hizmet olarak kimlik doğrulaması (AaaS) 

• Birden çok uygulama türü üzerinde çoklu oturum açma/kapatma (SSO) 

• API 'Ler için erişim denetimi 

• Federasyon ağ geçidi 

Daha fazla bilgi için bkz. ıdentityserver4 to VVelcome. 


Sonraki adımlar 











ASP.NET Core web API'leri oluşturmaya daha fazla bilgi için aşağıdaki kaynaklara bakın: 


• Bu makalenin YouTube sürümü 

• ASP.NET Core ile Web API 'Leri oluşturma 

• ASP.NET Core Web API 'sindeki denetleyici eylemi dönüş türleri 


ASRNET Core web API Yardım sayfaları ile Svvagger 
/ Openapı 

9.12.2019 • 4 minutes to read ı Edit Online 


Tarafından Christoph Nienaber ve Riko Suter 

Bir Web API'si kullanılırken, çeşitli metotlarını anlama bir geliştirici için zor olabilir. Svvaggerolarak da bilinen 
Openapı, Web API'leri için kullanışlı belgeler ve Yardım sayfaları oluşturma sorununu çözer.Bu, etkileşimli 
belgeleri, istemci SDK oluşturma ve API keşfedilebilirliğini gibi avantajlar sağlar. 

Bu makalede, Svvashbuckle.AspNetCore ve NSvvag uygulamaları .NET Svvagger büyütmüş: 

• Svvashbuckle.AspNetCore Svvagger belgeler için ASP.NET Core Web API'leri oluşturmak için açık 
kaynak bir projedir. 

• NSvvag Svvagger belgeler oluşturmak ve tümleştirme için başka bir açık kaynaklı proje Svvagger kullanıcı 
arabirimini veya ReDoc içinde ASP.NET Core vveb API'leri. Ayrıca, NSvvag API'niz için C# ve TypeScript 
istemci kodu oluşturmak için bir yaklaşım sunar. 

Svvagger nedir / Openapı? 

Svvagger belirtimidir tanımlamak için bir dilden REST API'leri. Svvagger proje için üzerinde Bağış Openapı 
girişim, burada, artık Openapı adlandırılır. Her iki birbirinin yerine kullanılır; Ancak, Openapı tercih edilir. Bu hem 
bilgisayarları hem de bir hizmet uygulaması (kaynak kodu, ağ erişimi, belgeleri) doğrudan erişim olmadan 
yeteneklerini anlamalarına insanlar sağlar, ilişkisi kaldırılan Hizmetleri bağlanmak için gerekli çalışma miktarını 
en aza bir hedeftir. Başka bir hedefe doğru bir şekilde bir hizmet belgesi için gereken süreyi azaltmaktır. 

Svvagger belirtimi (svvagger.json) 

Svvagger akışa çekirdek Svvagger belirtimidir—varsayılan olarak, bir belge adlı sv/aggerjson. Hizmet tabanlı 
Svvagger araç zinciri (veya bu üçüncü taraf uygulamaları) tarafından oluşturulur. Bu, API'nizi ve HTTP ile erişmek 
nasıl yeteneklerini açıklar. Svvagger kullanıcı arabirimini yönlendirir ve araç zinciri tarafından bulma ve istemci 
kodu oluşturmayı etkinleştirme için kullanılır. Konuyu uzatmamak amacıyla sınırlı bir Svvagger belirtimi bir örnek 
aşağıda verilmiştir: 





"swagger": " 2 . 0 ", 

"info": { 

"version": "vl", 

"title": "API VI" 

b 

"basePath": 

"paths": { 

"/api/Todo": { 

"get": { 

"tags": [ 

"Todo" 

b 

"operationld": "ApiTodoGet ", 

"consumes": [], 

"produces": [ 

"text/plain", 

"application/json", 

"text/json" 

b 

"responses": { 

" 200 ": { 

"description": "Success", 

"schema": { 

"type": "array", 

"items": { 

"$ref": "#/definitions/TodoItem" 

} 

} 

} 

} 

b 

"post": { 

} 

b 

"/api/Todo/{id}": { 

"get": { 

b 

"put": { 

b 

"delete": { 

b 

"definitions": { 

"Todoltem": { 

"type": "object", 

"properties": { 

"id": { 

"format": "İnt64", 

"type": "integen" 

b 

"name": { 

"type": "string" 

b 

"isComplete": { 

"default": false, 

"type": "boolean" 

} 

} 

} 

b 

"securityDefinitions": {} 

} 



Svvagger kullanıcı Arabirimi 

Svvagger kullanıcı Arabirimi oluşturulan Svvagger belirtimi kullanarak hizmeti hakkında bilgi sağlayan bir web 
tabanlı bir kullanıcı Arabirimi sunar. ASP.N ET Core uygulamanızı bir ara yazılım kayıt çağrısı kullanarak 
barındırılan Svvashbuckle hem NSwag Svvagger kullanıcı arabirimini, katıştırılmış bir sürümünü içerir. Web 
kullanıcı Arabirimi şöyle görünür: 


B svvagger 

| http://localhost:60201/swagger/v1/swagger.json 


My API VI ▼ 


My API 


Todo Show/Hide List Operations Expand Operations 


GET 

/api/Todo 


POST 

/api/Todo 


DELETE 

| /api/Todo/{id} 


GET 

| /api/Todo/{id} 


PUT 

/api/Todo/{id} 


[ BASE URL! / , API version: Vİ ] 

Kullanıcı Arabiriminden denetleyicilerinizi her genel bir eylem yöntemi test edilebilir. Bir yöntem adı bölümü 
genişletmek için tıklayın. Gerekli tüm parametreleri ekleyin ve deneyin!. 















Todo 


Expand Opefations 


OET 


/api/Todo 


Response Class (Status 200) 

Success 


Example Value 


{ 

"id": 0, 

"nane": "string", 
"isComplete": false 

> 

] 


Response Conlent Type text/plaln » 

Try it outl * ' 

Curl 

curl -X GET --header ’Accept: application/json’ ’http://localhost:60201/api/Todo‘ 

Request URL 

http://localhost:60201/api/Todo 

Response Body 
[ 

{ 

"id": 1, 

"name": "Iteml", 

"isComplete": false 

> 


Response Code 


200 


Response Headers 


"date": "Thu, 31 Aug 2017 17:29:04 GMT", 

"5erver": “Kestrel", 

"transfer-encoding": "chunked", 

"content-type": "application/json; charset*utf-8" 


NOTE 

Ekran görüntüleri için kullanılan Svvagger kullanıcı arabirimini sürüm sürüm 2 ' dir. Sürüm 3 örnek için bkz: Petstore örnek. 


Sonraki adımlar 

• Svvashbuckle kullanmaya başlama 

• NSvvag Kullanmaya Başlama 






Svvashbuckle ve ASRNET Core kullanmaya başlayın 

6.12.2019 • 20 minutes to read ı Edit Online 


, Shayne Boyer ve Scott Ade tarafından 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Svvashbuckle'ın üç temel bileşeni vardır: 

• Svvashbuckle. AspNetCore. Svvagger: nesneleri JSON uç noktaları olarak swaggerDocument göstermek için 
Svvagger nesne modeli ve ara yazılımı. 

• Svvashbuckle. AspNetCore. SvvaggerGen: doğrudan rotalarınız, Denetleyicilerinizden ve modellerinizde 

swaggerDocument nesneleri oluşturan bir Svvagger Oluşturucu. Bu genellikle Svvagger JSON uç noktasını 
otomatik olarak kullanıma sunmak için Svvagger uç noktası ara katmanıyla birlikte kullanılır. 

• Svvashbuckle. AspNetCore. SvvaggerUl: Svvagger Kullanıcı arabirimi aracının gömülü bir sürümü. Svvagger 
JSON uç noktasını yorumlayarak vveb API'sinin işlevlerini tanımlayan zengin ve özelleştirilebilir bir 
deneyim oluşturur. Genel yöntemler için yerleşik test kuluçkaları içerir. 

Paket yüklemesi 

Aşağıdaki yaklaşımlar ile svvashbuckle eklenebilir: 

• Visual Studio 

• Mac için Visual Studio 

• Visual Studio Code 

• NET Core CLI 

• Paket Yöneticisi konsol penceresinde: 

o Diğer Windows > paket Yöneticisi konsolu > görüntüle 1 ye gidin 
o TodoApi. csproj dosyasının bulunduğu dizine gidin 
o Aşağıdaki komutu yürütün: 

Install-Package Svvashbuckle.AspNetCore -Verslon 5.0.0-rc4 

• NuGet Paketlerini Yönet iletişim kutusunda: 

o NuGet paketlerini yönetmek > Çözüm Gezgini ' de projeye sağ tıklayın 
o Paket kaynağını "NuGet.org" olarak ayarlayın 
o "Ön sürümü dahil et" seçeneğinin etkinleştirildiğinden emin olun 
o Arama kutusuna "svvashbuckle. AspNetCore" yazın 

o Araştır sekmesinden en son "svvashbuckle. aspnetcore" paketini seçin ve sonra da yüklensin ' e tıklayın. 

Svvagger ara yazılım ekleme ve yapılandırma 

startup sınıfında, openApiinfo sınıfını kullanmak için aşağıdaki ad alanını içeri aktarın: 










using Microsoft.OpenApi.Models; 

Svvagger oluşturucuyu 

Startup.ConfigureServices 

yöntemindeki Services koleksiyonuna ekleyin: 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<TodoContext>(opt => 
opt.UseInMemoryDatabase("TodoList")); 

Services. AddMvc(); 

// Register the Swagger generator, defining 1 or more Swagger documents 
Services.AddSwaggerGen(c => 

{ 

c.SwaggerDoc("vl" J , new OpenApilnfo { Title = "My API", Version = "vl" }); 

}); 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<TodoContext>(opt => 
opt.UseInMemoryDatabase("TodoList")); 

Services. AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_l); 

// Register the Swagger generator, defining 1 or more Swagger documents 
Services.AddSwaggerGen(c => 

{ 

c.SwaggerDoc("vl" J , new OpenApilnfo { Title = "My API", Version = "vl" }); 

}); 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<TodoContext>(opt => 
opt.UseInMemoryDatabase("TodoList")); 

Services.AddControllers(); 

// Register the Swagger generator, defining 1 or more Swagger documents 
Services.AddSwaggerGen(c => 

{ 

c.SwaggerDoc("vl"j new OpenApilnfo { Title = "My API", Version = "vl" })j 

}); 

yönteminde, oluşturulan JSON belgesine ve Svvagger Kullanıcı arabirimine hizmet veren ara 
yazılımı etkinleştirin: 


} 

Startup.Configure 






public void Configure(IApplicationBuilder app) 

{ 

// Enable middleware to serve generated Swagger as a 1SON endpoint. 
app.UseSwagger(); 

// Enable middleware to serve swagger-ui (HTML., IS, CSS, ete.), 

// specifying the Swagger 1SON endpoint. 
app.UseSwaggerUI(c => 

{ 

c.SwaggerEndpoint("/swagger/vl/swagger.json", "My API VI"); 

}); 

app.UseMvc(); 

} 


public void Configure(IApplicationBuilder app) 

{ 

// Enable middleware to serve generated Swagger as a 1S0N endpoint. 
app.UseSwagger(); 

// Enable middleware to serve swagger-ui (HTML, İS, CSS, ete.)., 

// specifying the Swagger 1S0N endpoint. 
app.UseSwaggerUI(c = > 

{ 

c.SwaggerEndpoint("/swagger/vl/swagger.json", "My API VI"); 

}); 

app.UseRoutingO; 
app.UseEndpoints(endpoints => 

{ 

endpoints.MapControllers(); 

}); 

} 

Yukarıdaki useSwaggeruı yöntemi çağrısı statik dosya ara yazılımınısunar. .NET Framevvork veya .NET Core 1. x 'i 
hedefliyorsanız, projeye Microsoft. AspNetCore. StaticFiles NuGet paketini ekleyin. 

Uygulamayı başlatın ve http://iocaihost:<port>/swagger/vi/swagger. json gidin. Uç noktaları tanımlayan 
oluşturulan belge, Svvagger belirtiminde (Svvagger. JSON) gösterildiği gibi görünür. 

Svvagger Kullanıcı arabirimi http://iocaihost:<port>/swagger 1 de bulunabilir. Svvagger Kullanıcı arabirimi 
aracılığıyla API 'Yi keşfet ve diğer programlarda birleştirme. 


TIP 

Svvagger Kullanıcı arabirimine uygulamanın kökünde ( http://locaihost:<port>/ ) hizmeti sağlamak için RoutePrefix 
özelliğini boş bir dize olarak ayarlayın: 

app.UseSwaggerUI(c => 

{ 

c.SwaggenEndpoint("/swaggen/vl/swagger.json"j "My API VI"); 
c.RoutePrefix = string.Empty; 

})» 


11S veya ters proxy ile dizin kullanıyorsanız, Svvagger uç noktasını ./ önekini kullanarak göreli bir yol olarak 
ayarlayın. Örneğin: ./swagger/vi/swagger. json . /swagger/vi/swagger. json kullanmak, uygulamayı URL 'nin gerçek 
kökünde (artı kullanılıyorsa rota öneki), JSON dosyasını aramasını söyler. Örneğin, 
http://localhost:<port>/<virtual_directory>/<route_prefix>/swagger/vl/swagger.json yerine 
http://localhost:<port>/<route_prefix>/swagger/vl/swagger.json kullanın. 









Özelleştirme ve genişletme 

Svvagger, nesne modelini belgeleme ve Kullanıcı arabirimini temanızla eşleşecek şekilde özelleştirme seçenekleri 
sağlar. 

startup sınıfında, aşağıdaki ad alanlarını ekleyin: 

using System; 

using System.Reflection; 

using System.10; 


API bilgisi ve açıklaması 

AddSwaggerGen yöntemine geçirilen yapılandırma eylemi yazar, lisans ve açıklama gibi bilgileri ekler: 


// Register the Swagger generator, defining 1 or more Swagger documents 
Services.AddSwaggerGen(c => 

{ 

c.SwaggerDoc("vl", new OpenApilnfo 

{ 

Version = "vl", 

Title = "ToDo API"j 

Description = "A simple example ASP.NET Core Web API", 
TermsOfService = new Uri("https://example.com/terms"), 

Contact = new OpenApiContact 

{ 

Name = "Shayne Boyer", 

Email = string.Empty, 

Url = new Uri("https://twitter.com/spboyer"), 

License = new OpenApiLicense 

{ 

Name = "Use under LICX", 

Url = new Uri("https://example.com/license")j 

} 

}); 

}); 


Svvagger Kullanıcı arabirimi, sürümün bilgilerini görüntüler: 



XML açıklamaları 

XML açıklamaları aşağıdaki yaklaşımlar ile etkinleştirilebilir: 


















• Visual Studio 

• Mac için Visual Studio 

• Visual Studio Code 

• .NETCoreCLI 

• Çözüm Gezgini projeye sağ tıklayın ve >. csproj Project_Name < Düzenle' yi seçin. 

• Vurgulanan satırları. csproj dosyasına el ile ekleyin: 


<PropertyGroup> 

<GenerateDocumentationFile>true</GenerateDocumentationFile> 
<NoWarn>$(NoWarn); 1591</NoWarn> 

</PropertyGroup> 


• Projeye sağ Çözüm Gezgini seçip özellikleri. 

• Build sekmesinin output bölümünün altındaki XML belge dosyası kutusunu işaretleyin. 

XM L açıklamalarını etkinleştirmek, belgelenmemiş ortak türler ve Üyeler için hata ayıklama bilgileri sağlar. 
Belgelenmemiş türler ve Üyeler uyarı iletisiyle belirtilir. Örneğin, aşağıdaki ileti 1591 uyarı kodunu ihlal eder: 

warning CS1591: Missing XML comment for publicly visible type or member , TodoController'.GetAll()' 


Uyarıları proje genelinde gizlemek için, proje dosyasında yoksayılacak uyarı kodlarının noktalı virgülle ayrılmış bir 
listesini tanımlayın. Uyarı kodlarının $(Nowarn); eklenmesi, C# varsayılan değerleri de uygular. 

<PropertyGroup> 

<GenerateDocumentationFile>true</GenerateDocumentationFile> 

<NoWarn>$(NoWarn) ; 1591</NoWarn> 

</PropertyGroup> 


<PropertyGroup> 

<DocumentationFile>bin\$(Configuration)\$(TargetFramework)\$(AssemblyName).xml</DocumentationFile> 
<NoWarn>$(NoWarn) ; 1591</NoWarn> 

</PropertyGroup> 

Yalnızca belirli Üyeler için uyarıları gizlemek için, kodu #pragma uyarı Önişlemci yönergeleri arasına alın. Bu 
yaklaşım, API belgeleri aracılığıyla sunulmaması gereken kod için yararlıdır. Aşağıdaki örnekte, tüm Program sınıfı 
için uyarı kodu CS1591 yok sayılır. Uyarı kodu zorlaması sınıf tanımının kapandığına geri yüklenir. Virgülle ayrılmış 
bir liste ile birden çok uyarı kodu belirtin. 

namespace TodoApi 
{ 

#pragma warning disable CS1591 
public class Program 
{ 

public static void Main(string[] args) => 

BuildWebHost(args).Run(); 

public static IWebHost BuildWebHost(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.Build(); 

} 

#pragma warning restore CS1591 
} 







Svvagger 'yi yukarıdaki yönergelerle oluşturulan XM L dosyasını kullanacak şekilde yapılandırın. Linux veya 
Windows dışı işletim sistemleri için dosya adları ve yolları büyük/küçük harfe duyarlı olabilir. Örneğin, TodoApl 
xml dosyası VVİndovvs üzerinde geçerlidir ancak CentOS değildir. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<TodoContext>(opt => 
opt.UseInMemoryDatabase("TodoList")); 

Services.AddControllers(); 

// Register the Swagger generator, defining 1 or more Swagger documents 
Services.AddSwaggerGen(c => 

{ 

c.SwaggerDoc("vl", new OpenApilnfo 

{ 

Version = "vl", 

Title = "ToDo API", 

Description = "A simple example ASP.NET Core Web API", 

TermsOfService = new Uri("https://example.com/terms"), 

Contact = new OpenApiContact 

{ 

Name = "Shayne Boyer", 

Email = string.Empty, 

Url = new Uri("https://twitter.com/spboyer")j 

License = new OpenApiLicense 

{ 

Name = "Use under LICX", 

Url = new Uri("https://example.com/license")j 

} 

}); 

// Set the comments path for the Swagger İSON and UI. 

var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml"; 

var xmlPath = Path.Combine(AppContext.BaseDirectoryj xmlFile); 

c.IncludeXmlComments(xmlPath); 

}); 

} 



public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<TodoContext>(opt => 
opt.UseInMemoryDatabase("TodoList")); 

Services. AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_l); 

// Register the Swagger generator, defining 1 or more Swagger documents 
Services.AddSwaggerGen(c => 

{ 

c.SwaggerDoc("vl"j new OpenApilnfo 

{ 

Version = "vl", 

Title = "ToDo API", 

Description = "A simple example ASP.NET Core Web API", 
TermsOfService = new Uri("https://example.com/terms "), 

Contact = new OpenApiContact 

{ 

Name = "Shayne Boyer", 

Email = string.Empty, 

Url = new Uri("https://twitter.com/spboyer"), 

b 

License = new OpenApiLicense 

{ 

Name = "Use under LICX", 

Url = new Uri("https://example.com/license"), 

} 

}); 

// Set the comments path for the Swagger TSON and UI. 

var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml"; 

var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile); 

c.IncludeXmlComments(xmlPath); 

}); 

} 



public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<TodoContext>(opt => 
opt.UseInMemoryDatabase("TodoList")); 

Services. AddMvc(); 

// Register the Swagger generator, defining 1 or more Swagger documents 
Services.AddSwaggerGen(c => 

{ 

c.SwaggerDoc("vl", new OpenApilnfo 

{ 

Version = "vl", 

Title = "ToDo API", 

Description = "A simple example ASP.NET Core Web API", 
TermsOfService = new Uri("https://example.com/terms "), 

Contact = new OpenApiContact 

{ 

Name = "Shayne Boyer", 

Email = string.Empty, 

Url = new Uri("https://twitter.com/spboyer"), 

L 

License = new OpenApiLicense 

{ 

Name = "Use under LICX", 

Url = new Uri("https://example.com/license"), 

} 

}); 

// Set the comments path for the Swagger DSON and UI. 

var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml" 

var xmlPath = Path.Combine(AppContext.BaseDirectoryj xmlFile); 

c.IncludeXmlComments(xmlPath); 

}); 



public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<TodoContext>(opt => 
opt.UseInMemoryDatabase("TodoList")); 

Services. AddMvc(); 

// Register the Swagger generator, defining 1 or more Swagger documents 
Services.AddSwaggerGen(c => 

{ 

c.SwaggerDoc("vl"j new OpenApilnfo 

{ 

Version = "vl", 

Title = "ToDo API", 

Description = "A simple example ASP.NET Core Web API", 
TermsOfService = new Uri("https://example.com/terms "), 

Contact = new OpenApiContact 

{ 

Name = "Shayne Boyer", 

Email = string.Empty, 

Url = new Uri("https://twitter.com/spboyer"), 

L 

License = new OpenApiLicense 

{ 

Name = "Use under LICX", 

Url = new Uri("https://example.com/license"), 

} 

}); 

// Set the comments path for the Swagger 1S0N and UI. 
var xmlFile = $"{Assembly.GetEntryAssembly().GetName().Name}.xml"; 
var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile); 
c.IncludeXmlComments(xmlPath); 

}); 

} 


Yukarıdaki kodda, yansıma , Web API projesi ile eşleşen bir XML dosya adı oluşturmak için kullanılır. AppContext. 
BaseDirectory ÖZELLİĞİ, XML dosyasının yolunu oluşturmak için kullanılır.Bazı Svvagger özellikleri (örneğin, bir 
XML belge dosyası kullanılmadan, giriş parametrelerinin veya HTTP yöntemlerinin ve yanıt kodlarının) bir bölümü 
çalışır. Çoğu özellik için, yöntem özetleri ve parametrelerin ve yanıt kodlarının açıklamaları, bir XML dosyası 
kullanımı zorunludur. 

Bir eyleme üç eğik çizgiyle açıklama eklediğinizde bölüm üst bilgisine açıklama eklenir ve Svvagger UI geliştirilir. 
Delete eyleminin üstüne bir <summary > öğesi ekleyin: 

III <summary> 

III Deletes a specific Todoltem. 

III </summany> 

III <param name="id"x/param> 

[HttpDelete("{id}")] 

public IActionResult Delete(long id) 

{ 

var todo = _context.TodoItems.Find(id); 

if (todo == null) 

{ 

return NotFound(); 

} 

_context.Todoltems.Remove(todo); 

_context.SaveChanges(); 

return NoContent(); 

} 



Svvagger Kullanıcı arabirimi, önceki kodun <summary> öğesinin iç metnini görüntüler: 



Kullanıcı arabirimi, oluşturulan JSON şeması tarafından çalıştırılır: 


"delete": { 

"tags": [ 

"Todo" 

b 

"summary": "Deletes a specific Todoltem.", 
"operationld": "ApiTodoByldDelete ", 
"consumes": [], 

"produces": [], 

"parameters": [ 

{ 

"name": "id", 

"in": "path", 

"descniption": 

"nequired": tnue, 

"type": "integen", 

"format": "İnt64" 

} 

b 

"responses": { 

" 200 ": { 

"description": "Success" 

} 

} 


cneate Action yöntemi belgelerine bir oçıklamaları > öğesi ekleyin. <summary> öğesinde belirtilen bilgileri 
tamamlar ve daha sağlam bir Svvagger Kullanıcı arabirimi sağlar. <nemarks> öğesi içeriği metin, JSON veya XML 
içerebilir. 



























/// <summary> 

III Creates a Todoltem. 

III </summary> 

III <remarks> 

III Sample request: 

III 

III POST /Todo 

III { 

III "id": 1, 

III "name": "Iteml", 

III "isComplete": true 

III } 

III 

III </remarks> 

III <param name="item"x/param> 

III <returns>A newly created TodoItem</netunns> 

III <nesponse code="201">Retunns the newly created item</response> 

III <response code="400">If the item is null</response> 

[HttpPost] 

[ProducesResponseType(typeof(Todoltem ), StatusCodes.Status201Created)] 
[ProducesResponseType(StatusCodes.Status400BadRequest) ] 
public IActionResult Create([FromBody] Todoltem item) 

{ 

if (item == null) 

{ 

return BadRequest(); 

} 

_context.Todoltems.Add(item); 

_context.SaveChanges(); 

return CreatedAtRoute("GetTodo"j new { id = item.Id }, item); 

} 


III <summary> 

III Creates a Todoltem. 

III </summary> 

III <remarks> 

III Sample request: 

III 

III POST /Todo 

III { 

III "id": 1, 

III "name": "Iteml", 

III "isComplete": true 

İli } 

III 

III </remarks> 

III <param name="item"x/param> 

III <returns>A newly created TodoItem</returns> 

III <response code="201">Returns the newly created item</response> 
III cresponse code="400">If the item is null</response> 

[HttpPost] 

[ProducesResponseType(StatusCodes.Status201Created)] 

[ProducesResponseType(StatusCodes.Status400BadRequest)] 
public ActionResult<TodoItem> Create(TodoItem item) 

{ 

_context.Todoltems.Add(item); 

_context.SaveChanges(); 

return CreatedAtRoute("GetTodo", new { id = item.Id item); 

} 



/// <summary> 

III Creates a Todoltem. 

III </summary> 

III <remarks> 

III Sample request: 

III 

III POST /Todo 

/// { 

III "id": 1, 

III "name": "Iteml", 

III "isComplete": true 

/// } 

III 

III </remarks> 

III <param name="item"x/param> 

III <returns>A newly created TodoItem</netunns> 

III <nesponse code="201">Retunns the newly created item</response> 
III <response code="400">If the item is null</response> 

[HttpPost] 

[ProducesResponseType(StatusCodes.Status201Created)] 

[ProducesResponseType(StatusCodes.Status400BadRequest) ] 
public ActionResult<TodoItem> Create(TodoItem item) 

{ 

_context.Todoltems.Add(item); 

_context.SaveChanges(); 

return CreatedAtRoute("GetTodo", new { id = item.Id item); 

} 


Bu ek açıklamalarla Ul geliştirmelerini göz unutmayın: 



Veri açıklamaları 

Svvagger Kullanıcı Arabirimi bileşenlerini sağlamaya yardımcı olmak için System. ComponentModel. 
Dataaçıklamalarda ad alanında bulunan öznitelikleri olan modeli işaretleyin. 

Todoltem sınıfının Name özelliğine [Required] özniteliğini ekleyin: 




















using System.ComponentModel; 

using System.ComponentModel.DataAnnotations; 

namespace TodoApi.Models 

{ 

public class Todoltem 

{ 

public long Id { get; set; } 
[Required] 

public string Name { get; set; } 

[DefaultValue(false)] 

public bool IsComplete { get; set; } 

} 

} 


Bu özniteliğin varlığı, Kullanıcı arabirimi davranışını değiştirir ve temel alınan JSON şemasını değiştirir: 

"definitions": { 

"Todoltem": { 

"required": [ 

"name" 

b 

"type": "object", 

"properties": { 

"id": { 

"fonmat": "İnt64", 

"type": "integen" 

L 

"name": { 

"type": "string" 

L 

"isComplete": { 

"default": false, 

"type": "boolean" 

} 

} 

} 

}, 

API denetleyicisine [Produces("appiication/json")] özniteliğini ekleyin. Amaç, denetleyicinin eylemlerinin bir 
uyg ula m a/J S O A/yanıt içerik türünü desteklediğini bildirsağlamaktır: 

[Produces("application/json")] 

[Route("api/[controller]") ] 

public class TodoController : ControllerBase 

{ 

private readonly TodoContext _context; 


[Produces("application/json") ] 
[Route("api/[controller]")] 

[ApiController] 

public class TodoController : ControllerBase 

{ 

private readonly TodoContext _context; 







[Produces("application/json") ] 

[Route("api/[controller]") ] 

[ApiController] 

public class TodoController : ControllerBase 
{ 

private readonly TodoContext _context; 


Yanıt İçerik türü açılan liste, denetleyicinin al eylemleri için varsayılan olarak bu içerik türünü seçer: 


/api/Todo 


Parameters 


Try itout 


No parameters 


Responses 


Response content type application/json 


Web APİ 'sindeki veri ek açıklamaların kullanımı arttıkça, Ul ve APİ Yardım sayfaları daha açıklayıcı ve yararlı hale 
gelir. 

Yanıt türlerini açıkla 

Web APİ kullanan geliştiriciler, özellikle yanıt türleri ve hata kodları (Standart değilse)—döndürülmesiyle ilgilidir. 
Yanıt türleri ve hata kodları XML açıklamaları ve veri ek açıklamalarında gösterilir. 

Create eylemi başarılı olduğunda bir HTTP 201 durum kodu döndürür. Postalanan istek gövdesi null olduğunda 
bir HTTP 400 durum kodu döndürülür. Svvagger Kullanıcı arabiriminde doğru belgeler olmadan, tüketici beklenen 
bu sonuçlar hakkında bilgi sahibi yoktur. Aşağıdaki örneğe vurgulanan satırları ekleyerek bu sorunu 
giderebilirsiniz: 




















/// <summary> 

III Creates a Todoltem. 

III </summary> 

III <remarks> 

III Sample request: 

III 

III POST /Todo 

III { 

III "id": 1, 

III "name": "Iteml", 

III "isComplete": true 

III } 

III 

III </remarks> 

III <param name="item"x/param> 

III <returns>A newly created TodoItem</netunns> 

III <nesponse code="201">Retunns the newly created item</response> 

III <response code="400">If the item is null</response> 

[HttpPost] 

[ProducesResponseType(typeof(Todoltem ), StatusCodes.Status201Created)] 
[ProducesResponseType(StatusCodes.Status400BadRequest) ] 
public IActionResult Create([FromBody] Todoltem item) 

{ 

if (item == null) 

{ 

return BadRequest(); 

} 

_context.Todoltems.Add(item); 

_context.SaveChanges(); 

return CreatedAtRoute("GetTodo"j new { id = item.Id }, item); 

} 


III <summary> 

III Creates a Todoltem. 

III </summary> 

III <remarks> 

III Sample request: 

III 

III POST /Todo 

III { 

III "id": 1, 

III "name": "Iteml", 

III "isComplete": true 

İli } 

III 

III </remarks> 

III <param name="item"x/param> 

III <returns>A newly created TodoItem</returns> 

III <response code="201">Returns the newly created item</response> 
III cresponse code="400">If the item is null</response> 

[HttpPost] 

[ProducesResponseType(StatusCodes.Status201Created)] 

[ProducesResponseType(StatusCodes.Status400BadRequest)] 
public ActionResult<TodoItem> Create(TodoItem item) 

{ 

_context.Todoltems.Add(item); 

_context.SaveChanges(); 

return CreatedAtRoute("GetTodo", new { id = item.Id item); 

} 



/// <summary> 

III Creates a Todoltem. 

III </summary> 

III <remarks> 

III Sample request: 

III 

III POST /Todo 

/// { 

III "id": 1, 

III "name": "Iteml", 

III "isComplete": true 

/// } 

III 

III </remarks> 

III <param name="item"x/param> 

III <returns>A newly created TodoItem</netunns> 

III <nesponse code="201">Retunns the newly created item</response> 
III <response code="400">If the item is null</response> 

[HttpPost] 

[ProducesResponseType(StatusCodes.Status201Created)] 

[ProducesResponseType(StatusCodes.Status400BadRequest) ] 
public ActionResıılt<TodoItem> Create(TodoItem item) 

{ 

_context.Todoltems.Add(item); 

_context.SaveChanges(); 

return CreatedAtRoute("GetTodo", new { id = item.Id }, item); 

} 


Svvagger Kullanıcı arabirimi artık beklenen HTTP yanıt kodlarını açıkça belgelemektedir: 


Responses 


Response content type 


application/json 


Code 


Description 



AS P.N ET Core 2,2 veya üzeri sürümlerde, kurallar [ProducesResponseType] ile tek tek eylemleri açıkça dekorasyon 
alternatif olarak kullanılabilir. Daha fazla bilgi için bkz. Web API 'SI kurallarını kullanma. 

Kullanıcı arabirimini özelleştirme 

Hisse senedi Kullanıcı arabirimi hem işlevsel hem de edileni. Ancak, API belge sayfaları markanızı veya temanızı 
temsil etmelidir. Marka, svvashbuckle bileşenleri, statik dosyalara ve bu dosyaları barındırmak için klasör yapısını 
oluşturmaya yönelik kaynakların eklenmesini gerektirir. 

.NET Framevvork veya ,NET Core 1. x 'i hedefliyorsanız, Microsoft. AspNetCore. StaticFiles NuGet paketini projeye 
ekleyin: 
















<PackageReference Include="Microsoft.AspNetCore.StaticFiles" Version="2.0.0" /> 

Önceki NuGet paketi, .NET Core 2. x hedefleniyorsa ve metapackagekullanılarak zaten yüklüdür. 
Statik dosya ara yazılımını etkinleştir: 

public void Configure(IApplicationBuilder app) 

{ 

app.UseStaticFiles(); 

// Enable middleware to serve generated Swagger as a DSON endpoint. 
app.UseSwagger(); 

// Enable middleware to serve swagger-ui (HTML, İS, CSS, ete.), 

// speclfying the Swagger DSON endpoint. 
app.UseSwaggerUI(c = > 

{ 

c.SwaggerEndpoint("/swagger/vl/swagger.json", "My API VI"); 

}); 

app.UseMvc(); 

} 


public void Configure(IApplicationBuilder app) 

{ 

app.UseStaticFiles(); 

// Enable middleware to serve generated Swagger as a DSON endpoint. 
app.UseSwagger(); 

// Enable middleware to serve swagger-ui (HTML, DS, CSS, ete.), 

// specifying the Swagger DSON endpoint. 
app.UseSwaggerUI(c => 

{ 

c.SwaggerEndpoint("/swagger/vl/swagger.json", "My API VI"); 

}); 

app.UseRoutingO; 
app.UseEndpoints(endpoints => 

{ 

endpoints.MapControllers(); 

}); 


Swagger Kullanıcı arabirimi GitHub deposundan D'ıst klasörünün içeriğini alın. Bu klasör, Svvagger Kullanıcı 
arabirimi sayfası için gerekli varlıkları içerir. 

Bir Wwwroot/Swagger/UI klasörü oluşturun ve bunu D'ıst klasörünün içeriğine kopyalayın. 

Sayfa üstbilgisini özelleştirmek için aşağıdaki CSS ile Wwwroot/Swagger/UI\ç.\nde özel bir. ess dosyası oluşturun: 

.swagger-ui .topbar { 

background-color: #000; 
border-bottom: 3px solid #547f00; 

} 


Diğer CSS dosyalarından sonra, Kullanıcı arabirimi klasörünün içindeki irıdex. html dosyasında Custom. ess 
dosyasına başvurun: 






<link hnef="https://fonts.googleapis.com/css? 

family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+İAİeb:400,600,700" rel="stylesheet"> 

<link rel="stylesheet" type="text/css" href="./swagger-ui.css"> 

<link rel="stylesheet" type="text/css" href="custom.css"> 

http://localhost:<port>/swagger/ui/index.htmi adresindeki index. html sayfasına gidin. Üstbilginin metin kutusuna 
https://localhost:<port>/swagger/vi/swagger. json girin ve ardından keşfet düğmesine tıklayın. Elde edilen sayfa 
şu şekilde görünür: 



Sayfada yapabileceğiniz çok daha fazla şey vardır. Svvagger Kullanıcı arabirimi GitHub DEPOSUNDAKIUI 
kaynakları için tam yeteneklere bakın. 



























NSvvag ve ASPNET Core kullanmaya başlayın 
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, Christoph Nienaber, Riko Suterve bave Brock tarafından 
Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

NSvvag aşağıdaki özellikleri sunar: 

• Svvagger Kullanıcı arabirimi ve Svvagger oluşturucuyu kullanma özelliği. 

• Esnek kod oluşturma özellikleri. 

NSvvag ile, var olan bir API 'ye ihtiyacınız yoktur—Svvagger içeren üçüncü taraf API 1 Leri kullanabilir ve bir istemci 
uygulamasını oluşturabilirsiniz. NSvvag, geliştirme döngüsünü hızlandırın ve API değişikliklerine kolayca uyum 
sağlar. 

NSvvag ara yazılımını kaydetme 

NSvvag ara yazılımını şu şekilde kaydedin: 

• Uygulanan Web API 'SI için Svvagger belirtimini oluşturun. 

• Web API 'sini taramak ve test etmek için Svvagger Kullanıcı arabirimini sunar. 

Nsvvag ASP.NET Core ara yazılımını kullanmak İçin nsvvag. aspnetcore NuGet paketini yüklemelisiniz. Bu paket 
Svvagger belirtimini oluşturma ve sunma ara yazılımını, Svvagger Kullanıcı arabirimini (v2 ve v3) ve Redoc Kullanıcı 
arabiriminiiçerir. 

NSvvag NuGet paketini yüklemek için aşağıdaki yaklaşımlardan birini kullanın: 

• Visual Studio 

• Mac için Visual Studio 

• .NET Core CLI 

• Paket Yöneticisi konsol penceresinde: 

o Diğer Windows > paket Yöneticisi konsolu > görüntüle ' ye gidin 
o TodoApi. csproj dosyasının bulunduğu dizine gidin 
o Aşağıdaki komutu yürütün: 

Install-Package NSwag.AspNetCore 

• NuGet Paketlerini Yönet iletişim kutusunda: 

o NuGet paketlerini yönetmek > Çözüm Gezgini ' de projeye sağ tıklayın 
o Paket kaynağını "NuGet.org" olarak ayarlayın 
o Arama kutusuna "NSvvag. AspNetCore" yazın 

o Araştır sekmesinden "NSvvag. aspnetcore" paketini seçin ve sonra da yüklensin ' e tıklayın. 


Svvagger ara yazılım ekleme ve yapılandırma 







Aşağıdaki adımları gerçekleştirerek AS P.N ET Core uygulamanızda Svvagger ekleyin ve yapılandırın: 

• startup.configureServices yönteminde, gerekli Svvagger hizmetlerini kaydedin: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<TodoContext>(opt => 
opt.UseInMemoryDatabase("TodoList")); 

Services. AddMvc(); 

// Register the Svvagger Services 
Services. AddSvvaggerDoc ument(); 

} 

• startup.Configure yönteminde, oluşturulan Svvagger belirtimini ve Svvagger Kullanıcı arabirimini sunan ara 
yazılımı etkinleştirin: 

public void Configure(IApplicationBuilder app) 

{ 

app.UseStaticFiles(); 

// Register the Svvagger generator and the Sıvagger UI middleıvares 

app.UseOpenApi(); 

app. UseSwaggerlli3(); 

app.UseMvc(); 

} 

• Uygulamayı başlatma. Şuraya gidin: 

o Svvagger Kullanıcı arabirimini görüntülemek için http://iocaihost:<port>/swagger . 
o Svvagger belirtimini görüntülemek için http://iocaihost:<port>/swagger/vi/swagger. json . 

Kod oluşturma 

Aşağıdaki seçeneklerden birini seçerek NSvvag 'nin kod oluşturma özelliğinden yararlanabilirsiniz: 

• NSvvagStudio , veya TYPESCRIPT içinde C# API istemci kodu oluşturmak için bir VVİndovvs masaüstü 
uygulaması -. 

• Projenizin içindeki kod üretimi için Nsvvag. CodeGeneration. CSharp veya Nsvvag. CodeGeneration. TypeScript 
NuGet paketleri. 

• Komut satırındanNSvvag. 

• Nsvvag. MSBuild NuGet paketi. 

• Unchase Openapı (Svvagger) bağlı hizmeti , veya TYPESCRİPT içinde C# API istemci kodu oluşturmak İçin bir 
Visual Studio bağlı hizmeti -. Ayrıca, C# NSvvag İle openapı Hizmetleri için denetleyiciler oluşturur. 

NSvvagStudio ile kod oluşturma 

• NSvvagStudio GitHub deposundakiyönergeleri izleyerek NSvvagStudio 'i yükler. NSvvag Release sayfasında, 
yükleme ve yönetici ayrıcalıkları olmadan başlatılabilen bir Xcopy sürümü indirebilirsiniz. 

• NSvvagStudio başlatın ve Svvagger BELİRTİM URL 'si metin kutusuna Svvagger. JSON dosya URL 'sini 
girin. Örneğin, http://localhost:44354/swagger/v1/swagger.json. 

• Svvagger belirtimin bir JSON gösterimini oluşturmak için Yerel kopya oluştur düğmesine tıklayın. 









Input: Svvagger Specification 


Runtime 

NetCore22 

Specifies the used command line binary; should match the selected assembly type. 

Default Variables Cfoo-bar,baz=bar‘), usage: S(foo) 


Web API orASP.NET Core via Reflection (deprecated) 

JSON Schema 

.NET Assembly 

Svvagger Specification 

ASP.NET Core via API Explorer 


Svvagger Specification URL: 


https://localhost:44354/swagger/v1/swagger.json 


Create local Copy 


Svvagger Specification JSON (if specified, the URL is ignored): 


1 { 

2 "x-generator" : "NSwag vll.19.2.0 (NDsonSchema V9.10. 

3 "swagger" : "2.0", 

4 "info" : { 

5 "title" : "My Title", 

6 "version": "1.0.0" 

7 }, 

8 "hoşt": "localhost:44354", 

9 "schemes": [ 

10 "https" 

11 ]> 

12 "consumes”: [ 

1 O m nnnl A An /-J r 


A 


Çıktılar alanında, CSharp Client onay kutusuna tıklayın. Projenize bağlı olarak, TypeScript Client veya 
CSharp Web API Controller' ı da seçebilirsiniz. CSharp Web API denetleyicisi 1 ni seçerseniz, bir hizmet 
belirtimi hizmeti yeniden oluşturur ve bu da ters bir oluşturma görevi görür. 

TodoApi. NSvvag projesinin tüm C# İstemci uygulamasını oluşturmak için çıkış oluştur 1 a tıklayın. 
Oluşturulan istemci kodunu görmek için CSharp istemci sekmesine tıklayın: 

















// - 

// <auto-generated> 

// Generated using the NSwag toolchain vl2.0.9.0 (NlsonSchema v9.13.10.0 (Newtonsoft.Ison vll.0.0.0)) 
(http://NSwag.org) 

// </auto-generated> 

// - 

namespace MyNamespace 

{ 

#pragma warning disable 

[System.CodeDom.Compiler.GeneratedCode("NSwag", "12.0.9.0 (NlsonSchema v9.13.10.0 (Newtonsoft.3son 
vll.0.0.0))")] 

public partial class TodoClient 

{ 

private string _basellrl = "https://localhost:44354"; 
private System.Net.Http.HttpClient _httpClient; 

private System.Lazy<Newtonsoft. J son.3sonSerializerSettings> _settings; 

public TodoClient(System.Net.Http.HttpClient httpClient) 

{ 

_httpClient = httpClient; 

_settings = new System.Lazy<Newtonsoft.Ison.lsonSerializerSettings>(() => 

{ 

var settings = new Newtonsoft.lson.3sonSerializerSettings(); 

Update3sonSerializerSettings(settings); 
return settings; 

}); 

} 

public string BaseUrl 

{ 

get { return _baseUrl; } 
set { _basellrl = value; } 

} 

// code omitted for brevity 


TIP 

C# istemci kodu, Ayarlar sekmesindeki seçimlere göre oluşturulur, varsayılan ad alanı yeniden adlandırma ve zaman uyumlu 
yöntem oluşturma gibi görevleri gerçekleştirmek için ayarları değiştirin. 


• Oluşturulan C# kodu, istemci projesindeki bir dosyaya, API 'yi kullanacak şekilde kopyalayın. 

• Web API'sini kullanmayı Başlat: 


var todoClient = new TodoClient(); 

// Gets ali to-dos from the API 
var allîodos = await todoClient.GetAllAsync(); 

// Create a new Todoltem, and save it via the API. 
var createdTodo = await todoClient.CreateAsync(new TodoItem()); 

// Get a single to-do by ID 

var foundTodo = await todoClient.GetByldAsync(l); 


API belgelerini özelleştirme 


Svvagger, Web API 'sinin kullanımını kolaylaştırmak için nesne modelini belgeleme seçeneklerini sağlar. 







API bilgisi ve açıklaması 

startup.configureServices yönteminde, AddSwaggerDocument yöntemine geçirilen bir yapılandırma eylemi yazar, 
lisans ve açıklama gibi bilgileri ekler: 


Services.AddSwaggerDocument(config => 

{ 

config.PostProcess = document => 

{ 

document.Info.Version = "vl"; 
document.Info.Title = "ToDo API"; 

document.Info.Description = "A simple ASP.NET Core web API"; 
document.Info.TermsOfService = "None"; 
document.Info.Contact = new NSwag.OpenApiContact 
{ 

Name = "Shayne Boyer", 

Email = string.Empty, 

Url = "https://twitter.com/spboyer" 

}; 

document.Info.License = new NSwag.OpenApiLicense 
{ 

Name = "Use under LICX", 

Url = "https://example.com/license" 

}; 

}); 


Swagger Kullanıcı arabirimi, sürümün bilgilerini görüntüler: 


{•••} swagger 


ToDo API® 

[ Base URL: localhost:44354 ] 
/swagger/v1/swagger.json 

A simple ASP.NET Core web API 

Terms of service 
Shayne Boyer - VVebsite 
Use under LICX 


XML açıklamaları 

XML açıklamalarını etkinleştirmek için aşağıdaki adımları uygulayın: 

• Visual Studio 

• Mac için Visual Studio 

• .NET Core CLI 

• Çözüm Gezgini projeye sağ tıklayın ve >. csproj Project_Name < Düzenle 1 yi seçin. 

• Vurgulanan satırları. csproj dosyasına el ile ekleyin: 







<PropertyGroup> 

<GenerateDocumentationFile>true</GenerateDocumentationFile> 

<IMoWann>$(NoWarn); 1591</NoWarn> 

</PropertyGroup> 

• Çözüm Gezgini 1 de projeye sağ tıklayın ve Özellikler ' i seçin 

• Build sekmesinin output bölümünün altındaki XML belge dosyası kutusunu işaretleyin 

Veri açıklamaları 

NSvvag yansımakullandığından ve Web API 'si eylemleri için önerilen dönüş türü lactionresultolduğundan, 
eyleminiz ne yaptığını ve döndürdüğü şeyi çıkarmaz. 

Aşağıdaki örnek göz önünde bulundurun: 

[HttpPost] 

public IActionResult Create([FromBody] Todoltem item) 

{ 

if (item == null) 

{ 

return BadRequest(); 

} 

_context.Todoltems.Add(item); 

_context.SaveChanges(); 

return CreatedAtRoute("GetTodo", new { id = item.Id }, item); 

} 

Önceki eylem IActionResult döndürüyor, ancak eylemin içinde Createdatroute veya BadRequestdöndürüyor. 
İstemcilere bu eylemin hangi HTTP durum kodlarına geri dönebileceği bilinmektedir olduğunu bildirmek için veri 
açıklamalarını kullanın. Eylemi aşağıdaki özniteliklerle işaretleyin: 

[ProducesResponseType(typeof(Todoltem), StatusCodes.Status201Created)] // Created 
[ProducesResponseType(StatusCodes.Statüs400BadRequest)] // BadRequest 


NSvvag yansımakullandığından ve Web API eylemleri için önerilen dönüş türü ActionResult<t >olduğundan, 
yalnızca t tarafından tanımlanan dönüş türünü çıkarabilir. Diğer olası dönüş türlerini otomatik olarak 
çıkarsanamıyor. 

Aşağıdaki örnek göz önünde bulundurun: 

[HttpPost] 

public ActionResult<TodoItem> Create(TodoItem item) 

{ 

_context.Todoltems.Add(item); 

_context.SaveChanges(); 

return CreatedAtRoute("GetTodo", new { id = item.Id }, item); 

} 

Önceki eylem ActionResuit<T> döndürür. Eylemin içinde, Createdatroutedöndürüyor. Denetleyicinin 
[ApiControiler] özniteliği olduğundan, bir BadRequest yanıtı da mümkündür. Daha fazla bilgi için bkz. OTOMATİK 
HTTP 400 yanıtları, istemcilere bu eylemin hangi HTTP durum kodlarına geri dönebileceği bilinmektedir olduğunu 
bildirmek için veri açıklamalarını kullanın. Eylemi aşağıdaki özniteliklerle işaretleyin: 









[ProducesResponseType(StatusCodes.Status201Created)] // Created 
[ProducesResponseType(StatusCodes.Statüs400BadReqjest)] // BadRequest 

AS P.N ET Core 2,2 veya üzeri sürümlerde, tek tek eylemleri [ProducesResponseType] birlikte açıkça dekorasyon 
yerine kuralları kullanabilirsiniz. Daha fazla bilgi için bkz. Web API 'SI kurallarını kullanma. 

Svvagger Oluşturucusu artık bu eylemi doğru bir şekilde tanımlayabilir ve üretilen istemciler, uç noktayı çağırırken 
ne elde ettikleri hakkında bilgi alabilir. Öneri olarak tüm eylemleri bu özniteliklerle işaretleyin. 

API eylemlerinizin dönmesi gereken HTTP yanıtlarının hakkında yönergeler için bkz. RFC 7231 belirtimi. 



Openapı araçlarını kullanarak ASRNET Core 
uygulamaları geliştirme 
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ile Ryan Brandenburg 

Microsoft. DotNet-openapı , bir proje İçindeki openapı başvurularını yönetmek için .NET Core küresel bir araçtır . 

Yükleme 

Yüklemek Microsoft.dotnet-openapi için şu komutu çalıştırın: 

dotnet tool install -g Microsoft.dotnet-openapi 


Ekle 


Bu sayfadaki komutlardan herhangi birini kullanarak bir openapı başvurusu eklemek,. csproj dosyasına 


<OpenApiReference /> 

aşağıdakine benzer bir öğe ekler: 



cOpenApiReference 

Include="openapi.json" /> 



Uygulamanın oluşturulan istemci kodunu çağırması için önceki başvuru gereklidir. 


Dosya Ekle 

Seçenekler 




SHORT SEÇENEĞİ 

LONG SEÇENEĞİ 

AÇIKLAMA 

ÖRNEK 

-v 

--ayrıntılı 

Ayrıntılı çıktıyı göster. 

DotNet openapı dosya Ekle - 
v .\Openapi.exe 

-p 

--updateProject 

Üzerinde çalışılacak proje. 

DotNet openapı dosya Ekle - 
-updateproject .\Ref.exe 
.\Openapi.exe 

-c 

--Code-Generator 

Başvuruya uygulanacak kod 
Oluşturucu. Seçenekler ve 
NSwagCSharp 

NSwagTypeScript dir. 
Belirtilmemişse, araçları 
varsayılan olarak 

NSwagcsharp ayarlanır. 

--code-generator 

DotNet openapı Add dosyası 
.\Openapi.exe JSON--Code- 
Generator 

-h 

--yardım 

Yardım bilgilerini göster 

DotNet openapı dosya Ekle-- 


yardım 


Bağımsız Değişkenler 






BAĞIMSIZ DEĞİŞKEN 


AÇIKLAMA 


ÖRNEK 


Kaynak dosya Başvuru oluşturulacak kaynak. Bir DotNet openapı dosya ekleme 

Openapı dosyası olmalıdır. \Openopi.exe 

URL ekle 

Seçenekler 


SHORT SEÇENEĞİ LONG SEÇENEĞİ AÇIKLAMA ÖRNEK 


-v 

--ayrıntılı 

Ayrıntılı çıktıyı göster. 

DotNet openapı URL 'si Ekle 

-v 

https://contoso.com/openapi.j son 

-p 

--updateProject 

Üzerinde çalışılacak proje. 

DotNet openapı Add URL -- 
updateproject .\Ref.exe 
https://contoso.com/openapi.j son 

-o 

--Çıkış-dosya 

Openapı dosyasının yerel 
kopyasının yerleştirileceği yer. 

DotNet openapı Add URL 
https://contoso.com/openapi.j son 

--çıktı-F'de MyClierıt. JSON 

-c 

--Code-Generator 

Başvuruya uygulanacak kod 
Oluşturucu. Seçenekler ve 
NSwagCSharp 

NSwagTypeScript dir. 

DotNet openapı Add dosyası 
.\Openapi.exe JSON--Code- 
Generator 

-h 

--yardım 

Yardım bilgilerini göster 

DotNet openapı URL 
ekleme--Yardım 


Bağımsız Değişkenler 



BAĞIMSIZ DEĞİŞKEN 

AÇIKLAMA 

ÖRNEK 

Kaynak-URL 

Başvuru oluşturulacak kaynak. Bir URL 
olmalıdır. 

DotNet openapı URL 'si Ekle 

https://contoso.com/openapi.json 


Kaldır 

Verilen dosya adıyla eşleşen Openapı başvurusunu . csproj dosyasından kaldırır. Openapı başvurusu kaldırıldığında, 
istemciler oluşturulmaz. Local. JSON ve. YAML dosyaları silinir. 


Seçenekler 




SHORT SEÇENEĞİ 

LONG SEÇENEĞİ 

AÇIKLAMA 

ÖRNEK 

-v 

--ayrıntılı 

Ayrıntılı çıktıyı göster. 

DotNet openapı Remove -v 

-p 

--updateProject 

Üzerinde çalışılacak proje. 

DotNet openapı Remove -- 
updateproject ,\ref. csproj 
.\openapi.exe 

-h 

--yardım 

Yardım bilgilerini göster 

DotNet openapı Remove-- 
Help 


Bağımsız Değişkenler 




BAĞIMSIZ DEĞİŞKEN 


AÇIKLAMA 


ÖRNEK 


Kaynak dosya 


Başvurunun kaldırılacağı kaynak. DotNet openapı kaldırma .\Openapi.exe 


Yenile 

indirme URL 'sindeki en son içerik kullanılarak indirilen bir dosyanın yerel sürümünü yeniler. 


Seçenekler 




SHORT SEÇENEĞİ 

LONG SEÇENEĞİ 

AÇIKLAMA 

ÖRNEK 

-v 

--ayrıntılı 

Ayrıntılı çıktıyı göster. 

DotNet openapı yenileme -v 

https://contoso.com/openapi.json 


-P 


--updateProject 


Üzerinde çalışılacak proje. DotNet openapı yenileme -- 

updateproject .\ref.exe 
https://contoso.com/openapi.j son 


-h 


--yardım 


Yardım bilgilerini göster DotNet openapı yenilemesi-- 

yardım 


Bağımsız Değişkenler 

BAĞIMSIZ DEĞİŞKEN AÇIKLAMA ÖRNEK 

Kaynak-URL Başvurunun yenileneceği URL. DotNet openapı yenilemesi 

https://contoso.com/openapi.j son 




ASRNET Core Web API 'sindeki denetleyici eylemi 
dönüş türleri 
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Scott Ade tarafından 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

ASP.NET Core Web API denetleyicisi eylem dönüş türleri için aşağıdaki seçenekleri sunar: 

• Belirli tür 

• lactionresult 

• ActionResult<T > 

• Belirli tür 

• lactionresult 

Bu belgede, her dönüş türünü kullanmak için en uygun olan bilgiler açıklanmaktadır. 

Belirli tür 

En basit eylem, basit veya karmaşık bir veri türü döndürür (örneğin, string veya özel nesne türü). Özel Product 
nesnelerinin bir koleksiyonunu döndüren aşağıdaki eylemi göz önünde bulundurun: 

[HttpGet] 

public List<Product> Get() => 

_repository.GetProducts(); 

Eylem yürütme sırasında korunmak üzere bilinen koşullar olmadan, belirli bir türü döndürmek yeterli olabilir. 
Önceki eylem hiçbir parametre kabul etmez, bu nedenle parametre kısıtlamaları doğrulaması gerekli değildir. 

Bir eylemde, bilinen koşulların ne zaman hesaba katılması gerektiği olduğunda, birden fazla dönüş yolu 
tanıtılmıştır. Böyle bir durumda, basit veya karmaşık dönüş türüyle ActionResult bir dönüş türü karıştırmak 
yaygındır. Bu tür eyleme uyum sağlamak için lactionresult veya ActionResult<t > gereklidir. 

IEnumerable<T > veya ıasyncenumerable<T > döndürün 

ASP.NET Core 2,2 ve önceki sürümlerde, bir eylemden IEnumerable<T> döndürmek seri hale getirici tarafından 
zaman uyumlu koleksiyon yinelemesi ile sonuçlanır. Sonuç olarak, çağrı engelleme ve iş parçacığı havuzu için 
olası bir olasılık vardır. Göstermek için, Web API 'sinin veri erişimi ihtiyaçları için Entity Framework (EF) Core 
kullanıldığını düşünün. Aşağıdaki eylemin dönüş türü serileştirme sırasında zaman uyumlu olarak 
numaralandırılır: 

public IEnumerable<Product> GetOnSaleProducts() => 

_context.Products.Where(p => p.IsOnSale); 

Zaman uyumlu numaralandırmayı önlemek ve engellemeyi ASP.NET Core 2,2 ve önceki sürümlerde veritabanı 
üzerinde bekleyip, ToListAsync çağırın: 












public IEnumerable<Product> GetOnSaleProducts() => 

_context.Products.Where(p => p.IsOnSale).Tol_istAsync(); 

ASP.NET Core 3,0 ve üzeri sürümlerde iAsyncEnumerabie<T> bir eylemden geri döndürülüyor: 

• Zaman uyumlu yineleme ile sonuçlanmayacaktır. 

• IEnumerable<T>döndüren etkin hale gelir. 

AS P.N ET Core 3,0 ve üzeri, serileştiriciye sağlamadan önce aşağıdaki eylemin sonucunu arabelleğe alır: 

public IEnumerable<Product> GetOnSaleProducts() => 

_context.Products.Where(p => p.IsOnSale); 

Zaman uyumsuz yinelemeyi garantilemek için eylem imzasının dönüş türünü iAsyncEnumerabie<T> olarak 
bildirmeyi düşünün. Sonuç olarak, yineleme modu döndürülmekte olan temel somut türü temel alır. MVC, 
iAsyncEnumerabie<T> uygulayan herhangi bir somut türü otomatik olarak arabelleğe alır. 

iEnumerabie<Product> olarak satış fiyatlı ürün kayıtları döndüren aşağıdaki eylemi göz önünde bulundurun: 

[HttpGet("syncsale")] 

public IEnumerable<Product> GetOnSaleProducts() 

{ 

var products = _repository.GetProducts(); 

foreach (var product in products) 

{ 

if (product.IsOnSale) 

{ 

yield return product; 

} 

} 

} 

Önceki eylemin iAsyncEnumerabie<Product> eşdeğeri şunlardır: 

[HttpGet("asyncsale") ] 

public async IAsyncEnumerable<Product> GetOnSaleProductsAsync() 

{ 

var products = _repository.GetProductsAsync(); 

await foreach (var product in products) 

{ 

if (product.IsOnSale) 

{ 

yield return product; 

} 

} 

} 

Yukarıdaki eylemlerin her ikisi de AS P.N ET Core 3,0 itibariyle engellenmeyen bir işlem değildir. 

lactionresult türü 

dönüş türü, bir eylemde birden çok ActionResuit dönüş türü mümkün olduğunda uygundur, 
türleri çeşitli HTTP durum kodlarını temsil eder. ActionResuit türetilen Özet olmayan herhangi bir 
sınıf, geçerli bir dönüş türü olarak nitelendirir. Bu kategorideki bazı yaygın dönüş türleri BadRequestResult (400), 
NotFoundResult (404) ve OkObjectResult (200). Alternatif olarak, ControllerBase sınıfındaki kullanışlı yöntemler 


lActıonResult 

ActionResuit 















bir eylemden ActionResuit türlerini döndürmek için kullanılabilir. Örneğin, return BadRequest(); 
return new BadRequestResult(); toplu bir biçimidir. 

Bu tür bir eylemde birden çok dönüş türü ve yolu olduğundan, [ProducesResponseType] özniteliğin serbest 
kullanımı gereklidir. Bu öznitelik, Svvaggergibi araçlar tarafından oluşturulan Web API Yardım sayfaları için daha 
açıklayıcı yanıt ayrıntıları üretir. [ProducesResponseType] , eylem tarafından döndürülecek bilinen türleri ve HTTP 
durum kodlarını gösterir. 

Zaman uyumlu eylem 

iki olası dönüş türü olan aşağıdaki zaman uyumlu eylemi göz önünde bulundurun: 

[HttpGet("{id}")] 

[ProducesResponseType(StatusCodes.Status200OK)] 

[ProducesResponseType(StatusCodes.Status404NotFound)] 
public IActionResult GetById(int id) 

{ 

if (!_repository.TryGetProduct(id, out var product)) 

{ 

return NotFound(); 

} 

return Ok(product); 

} 


[HttpGet("{id}")] 

[ProducesResponseType(typeof(Product), StatusCodes.Status200OK)] 

[ProducesResponseType(StatusCodes.Status404NotFound)] 

public IActionResult GetById(int id) 

{ 

if (!_repository.TryGetProduct(id, out var product)) 

{ 

return NotFound(); 

} 

return Ok(product); 

} 

Önceki eylemde: 

• Temel alınan veri deposunda id tarafından temsil edilen ürün yoksa 404 durum kodu döndürülür. NotFound 
kolaylığı yöntemi return new NotFoundResuit(); için toplu olarak çağrılır. 

• Ürün mevcut olduğunda Product nesnesi ile bir 200 durum kodu döndürülür. Ok kolaylığı yöntemi 

return new OkObjectResult(product) ; için toplu olarak çağrılır. 

Zaman uyumsuz eylem 

iki olası dönüş türü olan aşağıdaki zaman uyumsuz eylemi göz önünde bulundurun: 















[HttpPost] 

[Consumes(MediaTypeNames.Application.Ison) ] 
[ProducesResponseType(StatusCodes.Status201Created)] 
[ProducesResponseType(StatusCodes.Status400BadRequest)] 
public async Task<IActionResult> CreateAsync(Product product) 

{ 

if (product.Description.Contains("XYZ Widget")) 

{ 

return BadRequest(); 

} 

await _repository.AddProductAsync(product); 

return CreatedAtAction(nameof(GetByld), new { id = product.Id }, product); 

} 


[HttpPost] 

[Consumes("application/json")] 

[ProducesResponseType(typeof(Product), StatusCodes.Status201Created)] 

[ProducesResponseType(StatusCodes.Status400BadRequest)] 

public async Task<IActionResult> CreateAsync([FromBody] Product product) 

{ 

if (product.Description.Contains("XYZ Widget")) 

{ 

return BadRequest(); 

} 

await _repository.AddProductAsync(product); 

return CreatedAtAction(nameof(GetByld), new { id = product.Id }, product); 

} 

Önceki eylemde: 

• Ürün açıklaması "XYZ pencere öğesi" içerdiğinde 400 durum kodu döndürülür. BadRequest kolaylığı yöntemi 

return new BadRequestResult(); için toplu olarak çağrılır. 

• Bir ürün oluşturulduğunda CreatedAtAction kullanışlı yöntem tarafından bir 201 durum kodu oluşturulur. 


CreatedAtAction 

çağırma alternatifi 




return new CreatedAtActionResult(nameof(GetByld), "Products", new { id = product.Id }, product); 

. Bu kod 

yolunda, 

Product 

nesnesi yanıt gövdesinde sağlanır. Yeni oluşturulan ürünün URL 'sini içeren 

Location 

bir 


yanıt üst bilgisi sağlanır. 

Örneğin, aşağıdaki model isteklerin Name ve Description özelliklerini içermesi gerektiğini gösterir. Name 
sağlama hatası ve istekte Description , model doğrulamasının başarısız olmasına neden oluyor. 

public class Product 

{ 

public int Id { get; set; } 

[Required] 

public string Name { get; set; } 

[Required] 

public string Description { get; set; } 

} 

ASP.NET Core 2,1 veya sonraki bir sürümde [Apicontroiler] özniteliği uygulanırsa, model doğrulama hataları 
400 durum koduna neden olur. Daha fazla bilgi için bkz. OTOMATİK HTTP 400 yanıtları. 













ActionResultcT > türü 


ASP.NET Core 2,1, Web API denetleyicisi eylemleri için <t > geri dönüş türünü sunmuştur. ActionResult 
türettikten veya belirli bir türdöndürmenize olanak sağlar. ActionResuit<T> , lactionresult türüüzerinde aşağıdaki 
avantajları sunmaktadır: 


[ProducesResponseType] özniteliğin Type özelliği dışarıda bırakılabilirler. Örneğin, 

[ProducesResponseType(200, Type = typeof(Product))] [ProducesResponseType(200) ] basitleştirilmiştir. Eylemin 


beklenen dönüş türü, ActionResuit<T>' ' t çıkarsandı. 
Örtük atama işleçleri hem t hem d 
ObjectResultdönüştürür, bu, return 


hem de 

ActionResult<T>' ActionResult 

return new ObjectResult(T); 

return T; 


return Tj olarak basitleşdüğü anlamına gelir. 


C#arabirimlerde örtük atama işleçlerini desteklemez. Sonuç olarak, ActionResuit<T> kullanmak için arabirimin 
somut bir türe dönüştürülmesi gerekir. Örneğin, aşağıdaki örnekte iEnumerabie kullanımı çalışmaz: 

[HttpGet] 

public ActionResult<IEnumerable<Product>> Get() => 

_repository.GetProducts(); 

Önceki kodu gidermeye yönelik bir seçenek _repository.GetProducts().ToList(); döndürmemelidir. 


Çoğu eylemin belirli bir dönüş türü vardır. Eylem yürütme sırasında beklenmeyen koşullar gerçekleşebilir, bu 
durumda belirli tür döndürülmez. Örneğin, bir eylemin giriş parametresi, model doğrulamasının başarısız 
olmasına neden olabilir. Böyle bir durumda, belirli tür yerine uygun ActionResult türünü döndürmek yaygın bir 
durumdur. 


Zaman uyumlu eylem 

iki olası dönüş türü olan zaman uyumlu bir eylem düşünün: 

[HttpGet("{id}")] 

[ProducesResponseType(StatusCodes.Status200OK)] 

[ProducesResponseType(StatusCodes.Status404NotFound)] 
public ActionResult<Product> GetById(int id) 

{ 

if (!_repository.TryGetProduct(id, out var product)) 

{ 

return NotFound(); 

} 

return product; 

} 

Önceki eylemde: 

• Ürün veritabanında mevcut olmadığında bir 404 durum kodu döndürülür. 

• Ürün mevcut olduğunda karşılık gelen Product nesnesiyle bir 200 durum kodu döndürülür. 2,1 ASP.NET 
Core önce return product; satirinin return Ok(product); olması gerekiyordu. 

Zaman uyumsuz eylem 

iki olası dönüş türü olan zaman uyumsuz bir eylem düşünün: 





















[HttpPost] 

[Consumes(MediaTypeNames.Application.i son)] 

[ProducesResponseType(StatusCodes.Status201Created)] 

[ProducesResponseType(StatusCodes.Status400BadRequest)] 

public async Task<ActionResult<Product>> CreateAsync(Product product) 

{ 

if (product.Description.Contains("XYZ Widget")) 

{ 

return BadRequest(); 

} 

await _repository.AddProductAsync(product); 

return CreatedAtAction(nameof(GetByld ), new { id = product.Id }, product); 

} 

Önceki eylemde: 

• Bir 400 durum kodu (BadRequest), şu durumlarda ASP.NET Core çalışma zamanı tarafından döndürülür: 
o [ApiControiler] özniteliği uygulandı ve model doğrulaması başarısız oluyor. 

o Ürün açıklaması "XYZ pencere öğesi" içerir. 

• Bir ürün oluşturulduğunda CreatedAtAction yöntemi tarafından 201 durum kodu oluşturulur. Bu kod yolunda, 
Product nesnesi yanıt gövdesinde sağlanır. Yeni oluşturulan ürünün URL 'sini içeren Location bir yanıt üst 

bilgisi sağlanır. 

Ek kaynaklar 

• AS P.N ET Core MVC 'de denetleyicilerle istekleri işleme 

• ASP.NET Core MVC 'de model doğrulaması 

• AS P.N ET Core Web API Yardım sayfaları ile Svvagger / Openapı 
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tarafından Tom Dykstra 

Bu makalede, bir ASP.NET Core web API'si, JSON Patch isteklerinin nasıl işleneceğini açıklar. 

PATCH HTTP istek yöntemi 

KOY ve düzeltme eki yöntemleri, mevcut bir kaynağı güncelleştirmek için kullanılır. Aralarındaki fark, düzeltme eki 
yalnızca değişiklikleri belirtirken PUT tüm kaynak değiştirir' dir. 

JSON yaması 

JSON yaması bir kaynağa uygulanacak güncelleştirmeleri belirtmek için bir biçimidir. Bir dizi JSON yama belgesi 
sahip operations. Her bir işlemin belirli bir değişiklik türünü tanımlar, gibi bir dizi öğesine eklemek veya bir özellik 
değeri değiştirin. 

Örneğin, aşağıdaki JSON belgelerini bir kaynak, kaynak ve patch işlemleri sonucu için JSON patch belgenin 
gösterir. 


Kaynak örneği 


{ 

"customerName": 

"Tohn ", 


"orders": [ 

{ 

"orderName": 

: "Order0"j 


"orderType": 

; null 


b 

{ 

"orderName": 

: "Orderl", 


"orderType": 

; null 

} 

} 

] 



JSON patch örneği 

[ 

{ 

"op": "add", 

"path": "/customerName", 
"value": "Barry" 

b 

{ 

"op": "add", 

"path": "/orders/-", 
"value": { 

"orderName": "Order2", 
"orderType": null 

} 

} 

] 


Yukarıdaki JSON: 






• op Özelliği işlem türünü belirtir. 

• path Güncelleştirilecek öğe özelliği belirtir. 

• value Özelliğinin yeni değeri sağlar. 


Düzeltme eki sonra kaynak 

Yukarıdaki JSON yama belgesi uyguladıktan sonra kaynak şöyledir: 


{ 

"customerName": 

"Barry", 


"orders": [ 

{ 

"orderName": 

"Order0", 


"orderType": 

null 


L 

{ 

"orderName": 

"Orderl", 


"orderType": 

null 


L 

{ 

"orderName": 

"0rder2", 


"orderType": 

null 

} 

} 

] 



Kaynak JSON yama belgesi uygulayarak yapılan değişiklikler atomiktir: listedeki herhangi bir işlem başarısız 
olursa, listedeki işlem uygulanır. 

Yolu sözdizimi 

Yolu işlem nesnesi özelliğine düzeyleri arasında eğik çizgi sahiptir. Örneğin: "/address/zipCode" . 

Sıfır tabanlı dizin, dizi öğeleri belirtmek için kullanılır, ilk öğesi addresses dizi konumunda olacak /addresses /0 . 
için add bir dizinin sonuna bir tire (-) yerine bir dizin numarasını kullanın: /addresses/-. 

İşlemler 

Aşağıdaki tablo desteklenen gösterir işlemleri sınıfında tanımlandığı gibi JSON Patch belirtimi: 


ÇALIŞMA 

NOTLAR 

add 

Bir özellik ya da dizi öğesini ekleyin. Var olan bir özellik için: 


değeri ayarlayın. 

remove 

Bir özellik ya da dizi öğesini kaldırın. 

replace 

Aynı remove ardından add aynı konumda. 

move 

Aynı remove ardından kaynağından add değerini kullanarak 

bir kaynaktan bir hedefe. 

copy 

Aynı add değerini kullanarak bir kaynaktan bir hedefe. 

test 

Başarılı durum kodu döndürür değerini path sağlanan = 


value . 


ASP.NET core'da JsonPatch 





















JSON yaması ASP.NET Core uygulaması sağlanan Microsoft.AspNetCore.JsonPatch NuGet paketi. Paket dahil 
Microsoft.AspnetCore.App metapackage. 

Eylem yöntemi kodu 

API denetleyicisi içinde bir eylem yöntemi için JSON Patch: 

• ile açıklanıyor HttpPatch özniteliği. 

• Kabul eden bir 3sonPatchDocument<T> , genellikle [FromBody] ile. 

• Çağrıları AppiyTo üzerindeki değişiklikleri uygulamak için yama belgesi. 

Örnek buradadır: 

[HttpPatch] 

public IActionResult HsonPatchWithModelState( 

[FromBody] JsonPatchDocument<Customer> patchDoc) 

{ 

if (patchDoc != null) 

{ 

var customer = CreateCustomer(); 

patchDoc.AppiyTo(customer, ModelState); 

if (IModelState.IsValid) 

{ 

return BadRequest(ModelState); 

} 

return new ObjectResult(customer); 

} 

else 

{ 

return BadRequest(ModelState); 

} 


Bu örnek uygulama kodundan aşağıdakilerle çalışır customer modeli. 

public class Customer 
{ 

public string CustomerName { get; set; } 
public List<Order> Orders { get; set; } 


public class Order 
{ 

public string OrderName { get; set; } 
public string OrderType { get; set; } 


Örnek eylem yöntemi: 

• Oluşturur bir Customer . 

• Düzeltme eki uygular. 

• Yanıt gövdesinde sonucunu döndürür. 

Gerçek bir uygulamada kod bir veritabanı gibi bir depolama alanından verileri almak ve düzeltme eki 
uygulandıktan sonra veritabanı güncelleştirmesi. 










Model durumu 

Önceki eylem yöntemi örneği bir aşırı yüklemesini çağırır AppiyTo , parametrelerinden biri olarak model 
durumunu alır. Bu seçenek belirtilmişse, hata iletileri yanıtlarını alabilirsiniz. Aşağıdaki örnek, bir 400 Hatalı istek 
yanıt gövdesinin gösterir, bir test işlemi: 

{ 

"Customer": [ 

"The current value ’Hohn' at path 'customerName' is not equal to the test value 'Nancy'." 

] 

} 

Dinamik nesneler 

Eylem yöntemi aşağıda dinamik bir nesne için bir düzeltme eki uygulama işlemini gösterir. 

[HttpPatch] 

public IActionResult TsonPatchForDynamic( [FromBodypsonPatchDocument patch) 

{ 

dynamic obj = new ExpandoObject(); 
patch.AppiyTo(obj); 

return Ok(obj); 

} 


Ekleme işlemi 

• Varsa path bir dizi öğesine işaret eder: tarafından belirtilen bir önce yeni bir öğe ekler path. 

• Varsa path gösteren bir özelliğe: özellik değeri ayarlar. 

• Varsa path varolmayan bir konuma işaret eder: 

o Düzeltme eki kaynağa dinamik bir nesne ise: bir özellik ekler, 
o Kaynak düzeltme eki için statik bir nesneyse: istek başarısız olur. 


Aşağıdaki örnek yama belgesi değerini ayarlar CustomerName ve ekler bir order nesnesinin sonuna orders dizisi. 


[ 

{ 

"op": "add", 

"path": "/customerName", 
"value": "Barry" 

h 

{ 

"op": "add", 

"path": "/orders/-", 
"value": { 

"orderName": "Order2", 
"orderType": null 

} 

} 

] 


Kaldırma işlemi 

• Varsa path bir dizi öğesine işaret eder: öğeyi kaldırır. 

• Varsa path işaret eden bir özellik için: 

o Kaynak düzeltme eki için dinamik bir nesne ise: özelliği kaldırır, 
o Kaynak düzeltme eki için statik bir nesne ise: 













o Özellik boş değer atanabilir ise: null olarak ayarlar, 
o NULL olmayan bir özelliğidir, bu ayarlar defauit<T> . 

Aşağıdaki örnek, düzeltme eki belge kümeleri customerName null ve silmeleri Orders[ 0 ] . 


{ 

"op": "remove", 

"path": "/customerName" 

}, 

{ 

"op": "remove", 

"path": "/orders/0", 

> 

ı 


Değiştirme işlemi 

Bu işlem işlevsel olarak aynıdır bir remove arkasından bir add . 


Aşağıdaki örnek yama belgesi değerini ayarlar CustomerName ve değiştirir Orders[0] yeni bir order nesne. 


[ 

{ 

"op": "replace", 

"path": "/customerName", 
"value": "Barry" 

}, 

{ 

"op": "replace", 

"path": "/orders/0", 
"value": { 

"orderName": "0rder2", 
"orderType": null 

} 

} 

] 


Taşıma işlemi 

• Varsa path bir dizi öğesine işaret: kopyalar from konumunu öğesine path öğesi, daha sonra çalışan bir 

remove işlemi from Öğesi. 

• Varsa path gösteren bir özelliğe: kopyalar değerini from özelliğini path özelliği, daha sonra çalışan bir 

remove işlemi from özelliği. 

• Varsa path işaret varolmayan bir özellik için: 

o Kaynak düzeltme eki için statik bir nesneyse: istek başarısız olur. 

o Yama kaynak dinamik bir nesne ise: kopyaları from özelliği tarafından belirtilen konuma path , sonra 
çalışan bir remove işlemi from özelliği. 

Aşağıdaki örnek yama belgesi: 

• Değerini kopyalar Orders[0] .OrderName için CustomerName . 

• Kümeleri Orders[0] .OrderName null. 

• Taşır Orders[l] için önce Orders[0] . 






























{ 

"op": "move", 

"from": "/orders/0/orderName”, 
"path": "/customerName" 

}, 

{ 

"op": "move", 

"from": "/orders/1", 

"path": "/orders/0" 

} 

] 


Kopyalama işlemi 

Bu işlem işlevsel olarak aynıdır bir move son olmadan işlemi remove adım. 
Aşağıdaki örnek yama belgesi: 

• Değerini kopyalar Orders[0] .OrderName için CustomerName . 

• Bir kopyasını ekler orders[i] önce Orders[ 0 ] . 


[ 

{ 

"op": "copy", 

"from": "/orders/0/orderName”, 
"path": "/customerName" 

}, 

{ 

"op": "copy", 

"from": "/orders/0", 

"path": "/orders/1" 

} 

] 


Test işlemi 

Bu konumdaki değeri tarafından belirtilmişse path sağlanan değerinden farklı value , istek başarısız olur. Bu 
durumda bile yama belgesindeki tüm diğer işlemler, aksi takdirde başarılı olabilir tüm PATCH isteği başarısız olur. 

test İşlemi bir eşzamanlılık çakışması olduğunda, bir güncelleştirme önlemek için yaygın olarak kullanılır. 

Aşağıdaki örnek yama belgesi etkisizdir başlangıç değeri oluşan CustomerName "John", test başarısız çünkü: 

[ 

{ 

"op": "test", 

"path": "/customerName", 

"value": "Nancy" 

L 

{ 

"op": "add", 

"path": "/customerName", 

"value": "Barry" 

} 

] 


Kodu alma 














Görüntüleme veya indirme örnek kodu. (Nasıl indirileceğini). 

Örnek test etmek için uygulamayı çalıştırın ve aşağıdaki ayarlarla HTTP istekleri göndermek için: 

• URL: 

• HTTP 

• Ust bilgi: Content-Type: application/json-patch+json 

• Gövdesi: JSON patch belge örneklerinden birini kopyalayıp JSON proje klasörü. 

Ek kaynaklar 

• İETF RFC 5789 düzeltme eki yöntemi belirtimi 

• İETF RFC 6902 JSON Patch belirtimi 

• İETF RFC 6901 JSON Patch yolu biçim belirtimi 

• JSON yaması belgeleri. JSON yaması belgeleri oluşturmak için kaynakların bağlantılarını içerir. 

• ASP.NET Core JSON Patch kaynak kodu 


http://localhost:{port}/jsonpatch/jsonpatchwithmodelstate 
yöntemi: patch 
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biçimlendirme 

10.12.2019 • 12 minutes to read^ Edit Online 


By Rick Anderson ve Steve Smith 

ASP.NET Core MVC, yanıt verilerini biçimlendirme desteğine sahiptir.Yanıt verileri, belirli biçimler kullanılarak 
veya istemci tarafından istenen biçime yanıt olarak biçimlendirilebilir. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 


Formata özgü eylem sonuçları 

Bazı eylem sonuç türleri, JsonResult ve ContentResultgibi belirli bir biçime özgüdür. Eylemler, istemci 
tercihlerinden bağımsız olarak belirli bir biçimde biçimlendirilen sonuçları döndürebilir. Örneğin, döndürme 
JsonResult JSON biçimli verileri döndürür. contentResuit veya dize döndürüldüğünde düz metin biçimli dize 
verileri döndürülür. 


Belirli bir tür döndürmek için bir eylem gerekli değildir. ASP.NET Core, tüm nesne dönüş değerlerini destekler. 
lActionResult türler olmayan nesneleri döndüren eylemlerin sonuçları, uygun lOutputFormatter uygulamasını 
kullanarak serileştirilir. Daha fazla bilgi için bkz. ASP.NET Core Web API 'sindeki denetleyici eylemi dönüş türleri. 

Yerleşik yardımcı yöntem Ok JSON biçimli verileri döndürür: [Icode-csharp] 

Örnek indirme, yazarların listesini döndürür.Önceki kodla F12 tarayıcı geliştirici araçları veya Postman kullanma: 

• Content-Type: appiication/json; charset=utf-8 içeren yanıt üst bilgisi görüntülenir. 

• istek üst bilgileri görüntülenir.Örneğin, Accept üst bilgisi. Accept üst bilgisi, önceki kod tarafından yok 
sayılır. 

Düz metin biçimli verileri döndürmek için Content ve Content yardımcısını kullanın: 

// GET api/authors/about 

[HttpGet("About")] 

public ContentResuit About() 

{ 

return Content("An API listing authors of docs.asp.net."); 

} 

Yukarıdaki kodda, döndürülen Content-Type text/piain . Bir dize döndürmek text/piain' 'Content-Type sağlar: 

// GET api/authors/version 
[HttpGet("version")] 
public string Version() 

{ 

return "Version 1.0.0"; 

} 

Birden çok dönüş türüne sahip eylemler için lActionResult döndürün. Örneğin, gerçekleştirilen işlemlerin 
sonucuna göre farklı PITTP durum kodları döndürülüyor. 


İçerik anlaşması 
















istemci bir Accept üst bilgisibelirttiğinde içerik anlaşması oluşur. ASP.NET Core tarafından kullanılan varsayılan 
biçim JSON'dir. içerik anlaşması: 

• ObjectResulttarafından uygulandı. 

• Yardımcı metotlarından döndürülen durum koduna özgü eylem sonuçlarına yerleşik olarak. Eylem sonuçları 
yardımcı yöntemleri ObjectResuit tabanlıdır. 

Bir model türü döndürüldüğünde, dönüş türü ObjectResuit . 

Aşağıdaki eylem yöntemi ok ve NotFound yardımcı yöntemlerini kullanır: 

// GET: api/authors/search?namelike=th 
[HttpGet("Search")] 

public IActionResult Search(string namelike) 

{ 

var result = _authors.GetByNameSubstring(namelike); 
if (!result.Any()) 

{ 

return NotFound(namelike); 

} 

return Ok(result); 

} 

Varsayılan olarak, ASP.NET Core appiication/json , text/json ve text/piain medya türlerini destekler. Fiddler 
veya Postman gibi araçlar, dönüş biçimini belirtmek için Accept istek üst bilgisini ayarlayabilir. Accept üst bilgisi 
sunucunun desteklediği bir tür içerdiğinde, bu tür döndürülür. Sonraki bölümde, ek Biçimlendiriciler ekleme 
gösterilmektedir. 

Denetleyici eylemleri POCOs (düz eski CLR nesneleri) döndürebilir.POCO döndürüldüğünde, çalışma zamanı 
otomatik olarak nesneyi sarmalayan bir ObjectResuit oluşturur, istemci, biçimlendirilen serileştirilmiş nesneyi 
alır. Döndürülen nesne nuiı , bir 204 no content yanıtı döndürülür. 

Nesne türü döndürülüyor: 

// GET api/authors/RickAndMSFT 

[HttpGet("{alias}")] 

public Author Get(string alias) 

{ 

return _authors.GetByAlias(alias); 

} 

Önceki kodda, geçerli bir yazar diğer adı için bir istek yazarın verileriyle 200 ok bir yanıt döndürür. Geçersiz bir 
diğer ad isteği bir 204 No content yanıtı döndürüyor. 

Accept üstbilgisi 

istekte bir Accept üst bilgisi göründüğünde içerik arılaşması gerçekleşir. Bir istek bir Accept üst bilgisi 
içerdiğinde ASP.NET Core: 

• Kabul üst bilgisindeki medya türlerini tercih sırasına göre numaralandırır. 

• Belirtilen biçimlerden birinde yanıt üretemeyen bir biçimlendirici bulmaya çalışır. 

istemcinin isteğini karşılayabilen bir biçimlendirici bulunmazsa ASP.NET Core: 

• MvcOptions ayarlandıysa 406 Not Acceptable döndürür veya- 

• Yanıt üreten ilk biçimlendirici bulmayı dener. 

istenen biçim için bir biçimlendirici yapılandırılmamışsa, nesneyi biçimlendirebileceğini ilk biçimlendirici 
kullanılır, istekte hiçbir Accept üstbilgisi görünürse: 





















• Nesneyi işleyebilen ilk biçimlendirici, yanıtı seri hale getirmek için kullanılır. 

• Hiçbir anlaşma gerçekleşmiyor.Sunucu hangi biçimin döneceğine karar verir. 

Accept üst bilgisi */* içeriyorsa, MvcOptions RespectBrowserAcceptHeader true olarak ayarlanmadığı takdirde 
başlık yok sayılır. 

Tarayıcılar ve içerik anlaşması 

Tipik API istemcilerinin aksine Web tarayıcıları Accept üst bilgileri sağlar. Web tarayıcısı, joker karakterler dahil 
olmak üzere birçok biçim belirtir. Varsayılan olarak, Framework isteğin bir tarayıcıdan geldiğini algıladığında: 

• Accept üst bilgisi yok sayılır. 

• Aksi yapılandırıImadiği takdirde içerik JSON içinde döndürülür. 

Bu, API 'Leri tükettiren tarayıcılarda daha tutarlı bir deneyim sağlar. 

Bir uygulamayı tarayıcı onay üstbilgilerini kabul edecek şekilde yapılandırmak için RespectBrovvserAcceptHeader 
true olarak ayarlayın: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddControllers(options => 

{ 

options.RespectBrowserAcceptHeader = true; // false by default 

}); 

} 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddMvc(options => 

{ 

options.RespectBrowserAcceptHeader = true; // false by default 

}); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_l); 

} 


Biçimleri yapılandırma 

Ek biçimleri desteklemesi gereken uygulamalar uygun NuGet paketlerini ekleyebilir ve desteği yapılandırabilir. 
Giriş ve çıkış için ayrı biçimlendirme vardır.Giriş formatlayıcıları model bağlamatarafından kullanılır. Çıkış 
biçimleri, yanıtları biçimlendirmek için kullanılır. Özel bir biçimlendirici oluşturma hakkında daha fazla bilgi için 
bkz. özel Formatlayıcılar. 

XML biçimi desteği ekle 

XmlSerializer kullanılarak uygulanan XML formatlayıcıları AddXmlSerializerFormattersçağırarak yapılandırılır: 

public void ConfiguneSenvices(IServiceCollection Services) 

{ 

Services. AddCont rollers() 

.AddXmlSerializerFormatters(); 

} 

Yukarıdaki kod, xmiseriaiizer kullanarak sonuçları seri hale getirir. 

Önceki kodu kullanırken, denetleyici yöntemleri isteğin Accept üst bilgisine göre uygun biçimi döndürür. 

System. Text. JSON tabanlı formatlayıcıları yapılandırma 










System.Text.lson tabanlı formatlayicilar için özellikler, Microsoft.AspNetCore.Mvc.lsonOptions.SerializerOptions 
kullanılarak yapılandırılabilir. 

Services.AddControllers().AddtsonOptions(options => 

{ 

// Use the default property (Pascal) casing. 
options.SerializerOptions.PropertyNamingPolicy = nullj 

// Configure a custom converter. 

options.SerializerOptions.Converters.Add(new MyCustomtsonConverterO); 

}); 

Çıkış serileştirme seçenekleri, eylem başına temelinde, isonResuit kullanılarak yapılandırılabilir. Örneğin: 

public IActionResult Get() 

{ 

return tson(model, new tsonSerializerOptions 
{ 

options .l/Jritelndented = true, 

}); 

} 

Nevvtonsoft. JSON tabanlı JSON biçimi desteği ekleyin 

ASP.NET Core 3,0 1 dan önce, varsayılan olarak kullanılan JSON formatlayıcıları Newtonsoft.ison paketi 
kullanılarak uygulanır. ASP.NET Core 3,0 veya üzeri sürümlerde, varsayılan JSON biçimleri system.Text.tson 
temel alır. Newtonsoft.tson tabanlı formatlayıcılar ve özellikler için destek, Microsoft. AspNetCore. Mvc. 
NevvtonsoftJson NuGet paketini yükleyerek ve startup.configureServices yapılandırılarak kullanılabilir. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddControllers() 

.AddNewtonsofttson(); 

} 

Bazı özellikler System.Text.tson tabanlı formatlayıcılar ile iyi çalışmayabilir ve Newtonsoft.tson tabanlı 
Biçimlendiriciler için bir başvuru gerektirir. Uygulama şu durumlarda Newtonsoft.ison tabanlı formatlayıcıları 
kullanmaya devam edin: 


Newtonsoft.lson 

özniteliklerini kullanır. Örneğin, 

[IsonProperty] 

veya 

[Dsonlgnore] 


• Serileştirme ayarlarını özelleştirir. 

• Newtonsoft.Json sağladığı özellikleri kullanır. 

• Microsoft.AspNetCore.Mvc.tsonResuit.serializerSettings yapılandırır. ASP.NET Core 3,0 1 dan önce 
IsonResult.SerializerSettings , Newtonsoft.tson Özgü bir IsonSerializerSettings Örneğini kabul eder. 

• Openapı belgeleri oluşturur. 

Newtonsoft.tson tabanlı formatlayıcılar için özellikler 

Microsoft .AspNetCore. Mvc. MvcNewtonsof 11 sonOptions .SerializerSettings kullanılarak yapılandırılabilir: 
















Services.AddControllers().AddNewtonsoftlson(options => 

{ 

// Use the default property (Pascal) casing 

options.SerializerSettings.ContractResolver = new DefaultContractResolver(); 

// Configure a custom converter 

options.SerializerOptions.Converters.Add(new MyCustomlsonConverterO); 

}); 

Çıkış serileştirme seçenekleri, eylem başına temelinde, isonResuit kullanılarak yapılandırılabilir. Örneğin: 

public IActionResult Get() 

{ 

return lson(model, new IsonSerializerSettings 
{ 

options.Formatting = Formatting. Indented., 

}); 

} 

XML biçimi desteği ekle 

XML biçimlendirme, Microsoft. AspNetCore. Mvc. Formatters. xml NuGet paketini gerektirir. 

XmlSerializer kullanılarak uygulanan XML formatlayıcıları AddXmlSerializerFormattersçağırarak yapılandırılır 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services. AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_l) 

.AddXmlSerializerFormatters(); 

} 

Yukarıdaki kod, xmiseriaiizer kullanarak sonuçları seri hale getirir. 

Önceki kodu kullanırken, denetleyici yöntemleri isteğin Accept üst bilgisine göre uygun biçimi döndürmelidir. 

Biçim belirtin 

Yanıt biçimlerini kısıtlamak için [Produces] filtresini uygulayın. Çoğu filtregibi [Produces] eylem, denetleyici 
veya genel kapsamda uygulanabilir: 

[ApiController] 

[Route("[controller]")] 

[Produces("application/j son")] 

public class WeatherForecastController : ControllerBase 
{ 

Önceki [Produces] filtresi: 

• Denetleyici içindeki tüm eylemleri JSON biçimli yanıtları döndürecek şekilde zorlar. 

• Diğer formatlayıcılar yapılandırıldıysa ve istemci farklı bir biçim belirtiyorsa JSON döndürülür. 

Daha fazla bilgi için bkz. Filtreler. 

Özel durum formatları 

Bazı özel durumlar, yerleşik formatlayıcılar kullanılarak uygulanır, string dönüş türleri varsayılan olarak 
metin/düz ( Accept üst bilgisi ile isteniyorsameft'n/ıhfm/) olarak biçimlendirilir. Bu davranış, 
StringOutputFormatterkaldırılarak silinebilir. Biçimlendiriciler configureServices yönteminde kaldırılır. Model 












nesne dönüş türü olan eylemler nuiı döndürürken 204 No content döndürür. Bu davranış, 
HttpNoContentOutputFormatterkaldırılarak silinebilir. Aşağıdaki kod stringOutputFormatter ve 
HttpNoContentOutputFormatter kaldırır. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddControllers(options => 

{ 

// requires using Microsoft.AspNetCore.Mvc.Formatters; 
options.OutputFormatters.RemoveType<StringOutputFormatter>0; 
options.OutputFormatters.RemoveType<HttpNoContentOutputFormatter>(); 

}); 

} 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddMvc(options => 

{ 

// requires using Microsoft.AspNetCore.Mvc.Formatters; 
options.OutputFormatters.RemoveType<StringOutputFormatter>(); 
options.OutputFormatters.RemoveType<HttpNoContentOutputFormatter>(); 

}); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_l); 

} 

stringOutputFormatter olmadan, yerleşik J S O N biçimlendirici string dönüş türlerini biçimlendirir. Yerleşik 
JSON biçimlendiricisi kaldırılırsa ve bir XML biçimlendirici varsa, XML biçimlendirici string dönüş türlerini 
biçimlendirir. Aksi takdirde, string dönüş türleri 406 Not Acceptable döndürür. 

HttpNoContentOutputFormatter olmadan, null nesneler yapılandırılmış biçimlendirici kullanılarak biçimlendirilir. 
Örneğin: 

• JSON biçimlendiricisi null gövdesiyle bir yanıt döndürür. 

• XML biçimlendiricisi, xsi:niı="true" ayarlanan özniteliğe sahip boş bir XML öğesi döndürür. 

Yanıt biçimi URL eşlemeleri 

istemciler URL 'nin bir parçası olarak belirli bir biçim talep edebilir, örneğin: 

• Sorgu dizesinde veya yolun bir bölümünde. 

• . Xml veya. JSON gibi formata özgü bir dosya uzantısı kullanarak. 

istek yolundan eşleme, API 'nin kullandığı rotada belirtilmelidir. Örneğin: 

[Route("api/[controller]")] 

[ApiController] 

[FormatFilter] 

public class ProductsController : ControllerBase 
{ 

[HttpGet("{id}.{format?}")] 
public Product Get(int id) 

{ 

Önceki yol, istenen biçimin isteğe bağlı bir dosya uzantısı olarak belirtilmesini sağlar. [FormatFilter] özniteliği, 
RouteData biçim değerinin varlığını denetler ve yanıt oluşturulduğu zaman yanıt biçimini uygun biçimlendirici ile 
eşler. 
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BIÇIMLENDIRICI 


/api/pnoducts/5 

Varsayılan çıkış biçimlendiricisi 

/api/pnoducts/5.json 

JSON biçimlendiricisi (yapılandırıldıysa) 

/api/products/5.xml 

XML biçimlendiricisi (yapılandırıldıysa) 






ASPNET Core Web API 'sindeki özel formatıcılar 

13.09.2019 • 7 minutes to read ı Edit Online 


Tom Dykstra tarafından 

ASP.NET Core MVC, giriş ve çıkış formatlayıcıları kullanılarak Web API 'Lerinde veri değişimini destekler.Giriş 
formatlayıcıları model bağlamatarafından kullanılır. Çıkış biçimleri, yanıtları biçimlendirmekiçin kullanılır. 

Framevvork, JSON ve XML için yerleşik giriş ve çıkış biçimleri sağlar. Düz metin için yerleşik bir çıkış 
biçimlendiricisi sağlar, ancak düz metin için bir giriş biçimlendiricisi sağlamaz. 

Bu makalede, özel formatlayıcılar oluşturarak ek biçimler için nasıl destek ekleneceği gösterilmektedir. Düz metin 
için özel bir giriş biçimlendirici örneği için GitHub 'da Textplainınputformatter bölümüne bakın. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Özel formatlayıcılar ne zaman kullanılır? 

İçerik anlaşma işleminin yerleşik biçimleri tarafından desteklenmeyen bir içerik türünü desteklemesini 
istediğinizde, özel bir biçimlendirici kullanın. 

Örneğin, Web API 'niz için bazı istemciler prototip biçimini işleyebildiğinden, daha verimli olduğundan bu 
istemcilerle prototip kullanmak isteyebilirsiniz. Ya da Web API 'nizin kişi adlarını ve adresleri, kişi verilerini değiş 
tokuş için sık kullanılan bir biçimde, vCard biçiminde göndermesini isteyebilirsiniz. Bu makalede belirtilen örnek 
uygulama, basit bir vCard biçimlendiricisi uygular. 

Özel biçimlendirici kullanma konusuna genel bakış 

Özel bir biçimlendirici oluşturma ve kullanma adımları aşağıda verilmiştir: 

• istemciye göndermek için veri serileştirmek istiyorsanız çıkış biçimlendirici sınıfı oluşturun. 

• istemciden alınan verilerin serisini kaldırmak istiyorsanız bir giriş biçimlendirici sınıfı oluşturun. 

• inputFormatters Mvcoptionsiçindeki ve outputFormatters koleksiyonlarına Biçimlendiriciler örneklerini 
ekleyin. 

Aşağıdaki bölümlerde, bu adımların her biri için rehberlik ve kod örnekleri sağlanmaktadır. 

Özel bir biçimlendirici sınıfı oluşturma 

Bir biçimlendirici oluşturmak için: 

• Sınıfı uygun temel sınıftan türet. 

• Oluşturucuda geçerli medya türleri ve kodlamalar belirtin. 

• Geçersiz CanReadType klima / yöntemleri CanWriteType 

• Geçersiz ReadRequestBodyAsync klima / yöntemleri UriteResponseBodyAsync 

Uygun taban sınıftan türet 

Metin medya türleri (örneğin, vCard) için, Textinputformatter veya Textoutputformatter temel sınıfından 
türetirsiniz. 

public class VcardOutputFormatter : TextOutputFormatter 










Bir giriş biçimlendirici örneği için bkz. örnek uygulama. 

ikili türler için inputformatter veya outputformatter temel sınıfından türetirsiniz. 

Geçerli medya türlerini ve kodlamaları belirtin 

Oluşturucuda, supportedMediaTypes ve supportedEncodings koleksiyonlarına ekleyerek geçerli medya türlerini ve 
kodlamaları belirtin. 

public VcardOutputFormatter() 

{ 

SupportedMediaTypes.Add(MediaTypeHeaderValue.Parse("text/vcard")); 

SupportedEncodings.Add(Encoding.UTF8); 

SupportedEncodings.Add(Encoding.Unicode); 

} 

Bir giriş biçimlendirici örneği için bkz. örnek uygulama. 


NOTE 

Bir biçimlendirici sınıfında Oluşturucu bağımlılığı ekleme yapamazsınız. Örneğin, oluşturucuya bir günlükçü parametresi 
ekleyerek günlükçü alamazsınız. Hizmetlere erişmek için yöntemlerinize geçirilen bağlam nesnesini kullanmanız gerekir. 
Aşağıdaki kod örneği bunun nasıl yapılacağını gösterir. 


CanReadType/CanVVriteType geçersiz kıl 

canReadîype Veya canwriteType yöntemlerini geçersiz kılarak seri durumdan çıkarabilen veya seri hale 
getirekullanabileceğiniz türü belirtin. Örneğin, yalnızca bir Contact türden vCard metni oluşturabileceğiniz gibi, 
tam tersi de olabilir. 

pnotected override bool CanWriteType(Type type) 

{ 

if (typeof(Contact).IsAssignableFnom(type) 

| typeof(IEnumerable<Contact>).IsAssignableFrom(type)) 

{ 

return base.CanWriteType(type); 

} 

return false; 

} 

Bir giriş biçimlendirici örneği için bkz. örnek uygulama. 

CanVVriteResult yöntemi 

Bazı senaryolarda canwriteResuit canwriteType yerine geçersiz kılmanız gerekir. Aşağıdaki canWriteResuit 
koşullar doğruysa kullanın: 

• Eylem yönteminiz bir model sınıfı döndürür. 

• Çalışma zamanında döndürülebilecek türetilmiş sınıflar var. 

• Eylem tarafından türetilen sınıfın döndürüldüğü çalışma zamanında bilmeniz gerekir. 

Örneğin, eylem yöntemi Person imzanızın bir tür döndürdüğünden, ancak ondan Person türetilen bir student 
veya instructor türü döndürebildiğini varsayalım. Biçimlendiricinin yalnızca student nesneleri işlemesini 
istiyorsanız, canwriteResuit metoduna sunulan bağlam nesnesindeki nesne türünü denetleyin. Eylem 
canwriteResuit yöntemidöndürüldüğünde canuriteType kullanılması gerekmediğini unutmayın 
;Budurumdayöntemçalışmazamanıtürünüalır. iActionResuit 

ReadRequestBodyAsync/WriteResponseBodyAsync geçersiz kıl 



















ReadRequestBodyAsync Ya writeResponseBodyAsync da ' de serileştirilir! veya serileştirme fiili işi yapabilirsiniz. 
Aşağıdaki örnekte vurgulanan satırlarda, bağımlılık ekleme kapsayıcısından hizmetlerin nasıl alınacağı 
gösterilmektedir (Bu parametreleri Oluşturucu parametrelerinden alamazsınız). 

public override async Task WriteResponseBodyAsync(OutputFormatterWriteContext context, Encoding 
selectedEncoding) 

{ 

IServiceProvider serviceProvider = context.HttpContext.RequestServices; 

var logger = serviceProvider.GetService(typeof(ILogger<VcardOutputFormatter>)) as ILogger; 

var response = context.HttpContext.Response; 

var buffer = new StringBuilder(); 
if (context.Object is IEnumerable<Contact>) 

{ 

foreach (Contact contact in context.Object as IEnumerable<Contact>) 

{ 

FormatVcard(buffer, contact., logger); 

} 

} 

else 

{ 

var contact = context.Object as Contact; 

FormatVcard(buffer, contact, logger); 

} 

await response.WriteAsync(buffer.ToString()); 

} 

private static void FormatVcard(StringBuilder buffer, Contact contact, ILogger logger) 

{ 

buffer.AppendLine("BEGIN:VCARD"); 
buffer.AppendLine("VERSION:2.1"); 

buffer.AppendFormat($"N:(contact.LastName};(contact.FirstName}\r\n"); 
buffer.AppendFormat($"FN:(contact.FirstName} (contact.LastName}\r\n"); 
buffer.AppendFormat($"UID:(contact.ID}\r\n"); 
buffer.AppendLine("END:VCARD"); 

logger.LogInformation("Writing {FirstName} {LastName}", contact.FirstName, contact.LastName); 

} 


Bir giriş biçimlendirici örneği için bkz. örnek uygulama. 

MVC 'yi özel bir biçimlendirici kullanacak şekilde yapılandırma 

Özel bir biçimlendirici kullanmak için, inputFormatters veya outputFormatters koleksiyonuna biçimlendirici 
sınıfının bir örneğini ekleyin. 

Services.AddMvc(options => 

{ 

options.InputFormatters.Insert(0, new VcardInputFormatter()); 
options.OutputFormatters.Insert(0, new VcardOutputFormatter()); 

}) 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


Biçimlendiriciler, eklediğiniz sırada değerlendirilir. Birincisi bir öncelik alır. 

Sonraki adımlar 

• Bu belge içinbasit vCard giriş ve çıkış biçimleri uygulayan örnek uygulama. Uygulamalar aşağıdaki örnekteki 
gibi görünen vCard 'ları okur ve yazar: 








BEGIN:VCARD 
VERSION:2.1 
N:Davolio;Nancy 
FN:Nancy Davolio 

UID:20293482-9240-4d68-b47S-325df4a83728 
END:VCARD 

VCard çıktısını görmek için, uygulamayı çalıştırın ve "metin/vCard" http://iocaihost:633i3/api/contacts/ onay 
üst bilgisine sahip bir get isteği gönderin (Visual Studio 'dan çalıştırıldığında) veya 
http://iocaihost: 5000/api/contacts/ (komut satırından çalıştırıldığında). 

Bir vCard 'ı bellek içi kişiler koleksiyonuna eklemek için, İçerik türü üst bilgisi "metin/vCard" ile aynı URL 'ye bir 
post isteği gönderin ve gövdesinde örnek olarak biçimlendirilen vCard metni yazın. 
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ASP.N ET Core 2,2 ve üzeri, Web API projeleriyle kullanılması amaçlanan bir MVC Çözümleyicileri paketi sağlar. 
Çözümleyiciler, Web API kurallarıüzerinde oluşturma sırasında ApiControllerAttributeile açıklanmış olan 
denetleyicilerle birlikte çalışır. 

Çözümleyiciler paketi şu şekilde bir denetleyici eylemi bildirir: 

• Bildirilmemiş bir durum kodu döndürür. 

• Bildirilmemiş başarı sonucunu döndürür. 

• Döndürülen bir durum kodunu belgeler. 

• Açık model doğrulama denetimi içerir. 

Çözümleyici paketine başvur 

ASP.NET Core 3,0 veya sonraki sürümlerde, çözümleyiciler .NET Core SDK dahil edilmiştir.Projenizdeki 
çözümleyici 'yi etkinleştirmek için, proje dosyasına inciudeOpenAPiAnaiyzers özelliği ekleyin: 

<PropertyGroup> 

<IncludeOpenAPIAnalyzers>true</IncludeOpenAPIAnalyzers> 

</PropertyGroup> 


Paket yüklemesi 

Aşağıdaki yaklaşımlardan biriyle Microsoft. AspNetCore. Mvc. api. çözümleyiciler NuGet paketini yükler: 

• Visual Studio 

• Mac için Visual Studio 

• Visual Studio Code 

• .NET Core CLI 

Paket Yöneticisi konsol penceresinde: 

• > Diğer VVİndovvs paket> Yöneticisi konsolunugörüntüle ' ye gidin. 

• Apiconventions. csproj dosyasının bulunduğu dizine gidin. 

• Aşağıdaki komutu yürütün: 

Install-Package Microsoft.AspNetCore.Mvc.Api.Analyzers 


Web API kuralları için çözümleyiciler 

Openapı belgeleri, bir eylemin döndürebildiği durum kodlarını ve yanıt türlerini içerir. ASP.NET Core MVC 'de, 
ProducesResponseTypeAttribute ve ProducesAttribute gibi öznitelikler bir eylemi belgelemek için kullanılır. 
ASP.N ET Core Web API Yardım sayfaları ile Svvagger / OpenapıVVeb API 'nizi belgeleme hakkında daha fazla 
ayrıntıya gider. 

Paketteki çözümleyicilerden biri ile ApiControllerAttribute açıklanmış denetimleri inceler ve yanıtlarını tamamen 








belgemeyen eylemleri tanımlar. Aşağıdaki örnek göz önünde bulundurun: 


// GET api/contacts/{guid} 

[HttpGet("{id}", Name = "GetByld")] 

[ProducesResponseType(typeof(Contact ), StatusCodes.Status200OK)] 
public IActionResult Get(string id) 

{ 

var contact = _contacts.Get(id); 

if (contact == null) 

{ 

return NotFound(); 

} 

return Ok(contact); 

} 


Yukarıdaki eylem HTTP 200 başarılı dönüş türünü belgeler, ancak HTTP 404 hata durumu kodunu belgeetmez. 
Çözümleyici, HTTP 404 durum kodu için eksik belgeleri uyarı olarak bildirir. Sorunu gidermeye yönelik bir seçenek 
sağlanır. 
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// GET api/contacts/{guid} 

[HttpGet("{id}”)] 

[ProducesResponseType(typeof(Contact), StatusCodes .Status200OK)] 
public IActionResult Get(string id) 

{ 

var contact = Contacts.Get(id); 
if (contact == null) 

{ 

return[ NotFound()j 

} _ 

|return Ok(contact);| 


I 


} 


#endregion 


Ek kaynaklar 

• Web API'SI kurallarını kullanma 

• ASP.NET Core Web API Yardım sayfaları ile Svvagger / Openapı 

• ASP.NET Core ile Web API 'Leri oluşturma 
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, Pranav Krishnamoorthy ve Scott Ade tarafından 

ASP.NET Core 2,2 ve üzeri, ortak API belgelerini ayıklamanızı ve bunu birden çok eyleme, denetleyiciye veya bir 
derleme içindeki tüm denetleyicilere uygulamanıza yönelik bir yol içerir. Web API kuralları, 

[ProducesResponseType] tek tek eylemleri dekorasyon bir yerdir. 

Bir kural şunları yapmanıza olanak sağlar: 

• Belirli bir eylem türünden döndürülen en yaygın dönüş türlerini ve durum kodlarını tanımlayın. 

• Tanımlanan standartta saptacak eylemleri belirler. 

ASP.NET Core MVC 2,2 ve üzeri, Microsoft.AspNetCore.Mvc.DefaultApiConventionsbir dizi varsayılan kural 
içerir. Kurallar ASP.NET Core API proje şablonunda belirtilen denetleyiciyi ( ValuesController.es ) temel alır. 
Eylemleriniz şablondaki desenleri izledikten sonra varsayılan kuralları kullanarak başarılı olmanız gerekir. 
Varsayılan kurallar ihtiyaçlarınızı karşılamıyorsa, bkz. Web API kuralları oluşturma. 

Çalışma zamanında Microsoft.AspNetCore.Mvc.ApiExplorer kuralları anlamıştır. ApiExpiorer , Openapı (Svvagger 
olarak da bilinir) belge oluşturucuları ile iletişim kurmak için MVC 'nin soyutlamasıdır. Uygulanan kuraldaki 
öznitelikler bir eylemle ilişkilendirilir ve eylemin Openapı belgelerine dahil edilir. API Çözümleyicileri , kuralları da 
anlalar. Eyleminiz geleneksel değilse (örneğin, uygulanan kural tarafından belgelenmemiş bir durum kodu 
döndürürse), durum kodunu belgeleyerek bir uyarı görürsünüz. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

VVebAPI 'SI kurallarını Uygula 

Kurallar oluşturma; Her eylem, tam olarak bir kurala göre ilişkilendirilebilir. Daha belirgin kuralların daha az 
belirli kurallara göre daha fazla olması. Aynı önceliğe sahip iki veya daha fazla kural bir eyleme uygulandığınızda 
seçim belirleyici değildir. Aşağıdaki seçenekler, en çok belirli olan en az belirli bir eyleme bir kural uygulamak için 
mevcuttur: 

1 . Microsoft.AspNetcore.Mvc.ApiConventionMethodAttribute — tek tek eylemler için geçerlidir ve kural türünü 
ve uygulanan kural yöntemini belirtir. 

Aşağıdaki örnekte, varsayılan kural türünün Microsoft.AspNetcore.Mvc.DefaultApiConventions.Put kuralı 
yöntemi update eylemine uygulanır: 











// PUT api/contactsconvention/{guid} 

[HttpPut("{id}")] 

[ApiConventionMethod(typeof(DefaultApiConventions), 

nameof(DefaultApiConventions.Put))] 
public IActionResult Update(string id, Contact contact) 

{ 

var contactToUpdate = _contacts.Get(id); 

if (contactToUpdate == null) 

{ 

return NotFound(); 

} 

_contacts.Update(contact); 
return NoContent(); 

} 

Microsoft.AspNetcore.Mvc.DefaultApiConventions.Put Convention yöntemi eyleme aşağıdaki öznitelikleri 
uygular: 

[ProducesDefaultResponseType] 

[ProducesResponseType(StatusCodes.Status204NoContent)] 

[ProducesResponseType(StatusCodes.Status404NotFound) ] 

[ProducesResponseType(StatusCodes.Status400BadRequest)] 

[ProducesDefaultResponseType] hakkında daha fazla bilgi için bkz. Varsayılan Yanıt. 

2. bir denetleyiciye uygulanan Microsoft.AspNetcore.Mvc.ApiConventionTypeAttribute , belirtilen kural türünü 
denetleyicideki tüm eylemlere uygular—. Kural yöntemi, kural yönteminin uygulandığı eylemleri 
belirleyen ipuçlarıyla işaretlenir, ipuçları hakkında daha fazla bilgi için bkz. Web API kuralları oluşturma). 

Aşağıdaki örnekte, varsayılan kurallar kümesi ContactsConventionControllenq\r\dek'\ tüm eylemlere 
uygulanır: 

[ApiController] 

[ApiConventionType(typeof (DefaultApiConventions))] 

[Route("api/[controller]")] 

public class ContactsConventionController : ControllerBase 

{ 

3. bir derlemeye uygulanan Microsoft.AspNetcore.Mvc.ApiConventionTypeAttribute , belirtilen kural türünü 
geçerli derlemedeki tüm denetleyicilere uygular —. Öneri olarak, Startup.es dosyasına derleme düzeyi 
öznitelikleri uygulayın. 

Aşağıdaki örnekte, varsayılan kural kümesi derlemedeki tüm denetleyicilere uygulanır: 

[assembly: ApiConventionType(typeof(DefaultApiConventions))] 
namespace ApiConventions 
{ 

public class Startup 

{ 


Web API kuralları oluşturma 

Varsayılan API kuralları gereksinimlerinizi karşılamıyorsa, kendi kurallarınızı oluşturun. Bir kural: 


• Metotları olan statik bir tür. 






• Eylemlerde Yanıt türleri ve adlandırma gereksinimleri tanımlama özelliğine sahiptir. 

Yanıt türleri 

Bu yöntemlere [ProducesResponseType] veya [ProducesDefaultResponseType] öznitel i kİ er iy I e açıklama eklenir. 
Örneğin: 

public static class MyAppConventions 
{ 

[ProducesResponseType(StatusCodes.Status200OK) ] 

[ProducesResponseType(StatusCodes.Status404NotFound)] 
public static void Find(int id) 

{ 

} 

} 


Daha özel meta veri öznitelikleri yoksa, bu kuralı bir derlemeye uygulamak şunları uygular: 

• Kural yöntemi, Find adlı tüm eylemler için geçerlidir. 

• Find eyleminde id adlı bir parametre var. 

Adlandırma gereksinimleri 

[ApiConventionNameMatch] ve [ApiConventionTypeMatch] öznitelikleri, uygulandıkları eylemleri belirleyen kural 
yöntemine uygulanabilir. Örneğin: 

[ProducesResponseType(StatusCodes.StatüS200OK) ] 

[ProducesResponseType(StatusCodes.Statüs404NotFound)] 
[ApiConventionNameMatch(ApiConventionl\lameMatchBehavior. Pref ix) ] 
public static void Find( 

[ApiConventionNameMatch(ApiConventionNameMatchBehavior .Suffix) ] 
int id) 

{ } 


Yukarıdaki örnekte: 

• Yöntemine uygulanan Microsoft.AspNetCore.Mvc.ApiExplorer.ApiConventionNameMatchBehavior.Prefix seçeneği, 
kuralının "Find" önekini ön eki eklenmiş herhangi bir eylem ile eşleştiğini gösterir. Eşleşen eylemlere örnek 
olarak Find , FindPet ve FindByid verilebilir. 

• Parametreye uygulanan Microsoft.AspNetCore.Mvc.ApiExplorer.ApiConventionNameMatchBehavior.Suffix , 
yöntemin sonek tanımlayıcısında biten tek bir parametreye sahip yöntemlerle eşleştiğini gösterir. Örnekler 

id veya petid gibi parametreleri içerir, parametre türünü kısıtlamak için ApiConventionTypeMatch benzer 
şekilde türlere uygulanabilir. params[] bağımsız değişkeni, açıkça eşleştirilmesinin gerekli olmadığı kalan 
parametreleri gösterir. 

Ek kaynaklar 

• Web API Çözümleyicileri kullanma 

• ASP.NET Core Web API Yardım sayfaları ile Svvagger / Openapı 
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Bu makalede, ASP.N ET Core Web API 'Leriyle hata işlemenin nasıl işleneceği ve özelleştirileceği açıklanır. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Geliştirici özel durum sayfası 

Geliştirici özel durum sayfası , sunucu hataları için ayrıntılı yığın izlemeleri almak için kullanışlı bir araçtır. HTTP 
ardışık düzeninde zaman uyumlu ve zaman uyumsuz özel durumları yakalamak ve hata yanıtları oluşturmak için 
DeveloperExceptionPageMiddleware kullanır. Göstermek için aşağıdaki denetleyici eylemini göz önünde 
bulundurun: 

[HttpGet("{city}")] 

public WeatherForecast Get(string city) 

{ 

if (!string.Equals(city?.TrimEnd(), "Redmond", StringComparison.OrdinalIgnoreCase)) 

{ 

throw new ArgumentException( 

$"We don't offer a weather forecast for {city}.", nameof(city)); 

} 

return GetWeather().First(); 

} 

Önceki eylemi test etmek için aşağıdaki curi komutunu çalıştırın: 

curl -i https://localhost:5001/weatherforecast/chicago 

ASP.NET Core 3,0 ve üzeri sürümlerde geliştirici özel durum sayfasında, istemci HTML biçimli çıkış isteğinde 
yoksa bir düz metin yanıtı görüntülenir. Şu çıktı görünür: 







HTTP/1.1 500 Internal Server Error 

Transfer-Encoding: chunked 

Content-Type: text/plain 

Server: Microsoft-IIS/10.0 

X-Powered-By: ASP.NET 

Date: Fri, 27 Sep 2019 16:13:16 GMT 

System.ArgumentException: We don't offer a weather forecast for Chicago. (Parameter 'city') 
at WebApiSample.Controllers.WeatherForecastController.Get(String city) in 
C:\working_folder\aspnet\AspNetCore.Docs\aspnetcore\web-api\handle- 
errors\samples\3.x\Controllers\Weat herForecastController.es :line 34 
at lambda_method(Closure , Object , Object[] ) 

at Microsoft.Extensions.Internal.ObjectMethodExecutor.Execute(Object target, Object[] parameters) 
at 

Microsoft.AspNetCore.Mvc.Infrastructure.ActionMethodExecutor.SyncObjectResultExecutor.Execute(IActionResultTyp 
eMapper mapper, ObjectMethodExecutor executor, Object controller, Objectf] arguments) 
at Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionlnvoker. 

<InvokeActionMethodAsync>g_Logged|12_l(ControllerActionInvoker invoker) 

at Microsoft.AspNetCore.Mvc.Infrastrueture.ControllerActionlnvoker. 

<InvokeNextActionFilterAsync>g_Awaited|10_0(ControllerActionInvoker invoker, Task lastTask, State next, Scope 

scope, Object State, Boolean isCompleted) 

at Microsoft.AspNetCore.Mvc.Infrastrueture.ControllerActionlnvoker.Rethrow(ActionExecutedContextSealed 
context) 

at Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionInvoker.Next(State& next, ScopeS scope, Object& 
State, BooleanS isCompleted) 

at Microsoft.AspNetCore.Mvc.Infrastrueture.ControllerActionlnvoker.InvokelnnerFilterAsync() 

— End of stack trace from previous location where exception was thrown — 
at Microsoft.AspNetCore.Mvc.Infrastructure.Resourcelnvoker. 

<InvokeFilterPipelineAsync>g_Awaited|19_0(ResourceInvoker invoker, Task lastTask, State next, Scope scope, 

Object State, Boolean isCompleted) 

at Microsoft.AspNetCore.Mvc.Infrastrueture.Resourcelnvoker.<InvokeAsync>g_Logged|17_l(ResourceInvoker 

invoker) 

at Microsoft.AspNetCore.Routing.EndpointMiddleware.<Invoke>g_AwaitRequestTask|6_0(Endpoint endpoint, Task 

requestTask, ILogger logger) 

at Microsoft.AspNetCore.Authorization.AuthorizationMiddleware.Invoke(HttpContext context) 
at Microsoft.AspNetCore.Diagnostics.DeveloperExceptionPageMiddleware.Invoke(HttpContext context) 

HEADERS 


Accept: */* 

Hoşt: localhost:44312 
User-Agent: curl/7.55.1 

Bunun yerine HTML biçimli bir yanıt göstermek için Accept HTTP istek üst bilgisini text/htmi medya türüne 
ayarlayın. Örneğin: 

curl -i -H "Accept: text/html" https://localhost:5001/weatherforecast/chicago 


HTTP yanıtından aşağıdaki alıntıyı göz önünde bulundurun: 

ASP.NET Core 2,2 ve önceki sürümlerde, geliştirici özel durum sayfasında HTML biçimli bir yanıt görüntülenir. 
Örneğin, HTTP yanıtından aşağıdaki alıntıyı göz önünde bulundurun: 










HTTP/1.1 500 Internal Server Error 
Transfer-Encoding: chunked 
Content-Type: text/html; charset=utf-8 
Server: Microsoft-IIS/10.0 
X-Powered-By: ASP.NET 
Date: Fri, 27 Sep 2019 16:55:37 GMT 

<!DOCTYPE html> 

<html lang="en" xmlns="http://www.w3.org/1999/xhtml"> 

<head> 

<meta charset="utf-8" /> 

<title>Internal Server Error</title> 

<style> 
body { 

font-famlly: 'Segoe UI', Tahoma, Arial, Helvetica, sans-serif; 
font-size: .813em; 
color: # 222 ; 
background-color: #fff; 

} 


HTML biçimli yanıt Postman gibi araçlar aracılığıyla test edilirken yararlı olur.Aşağıdaki ekran yakalama, Postman 
'daki düz metin ve HTML biçimli yanıtları gösterir: 



VVARNING 

Geliştirici özel durum sayfasını yalnızca uygulama geliştirme ortamında çalışırkenetkinleştirin. Uygulama üretimde 
çalıştırıldığında ayrıntılı özel durum bilgilerini herkese açık bir şekilde paylaşmak istemezsiniz. Ortamları yapılandırma hakkında 
daha fazla bilgi için bkz. ASP.NET Core çoklu ortamları kullanma. 


Özel durum işleyicisi 

Geliştirme dışı ortamlarda, özel durum İşleme ara yazılımı bir hata yükü oluşturmak için kullanılabilir: 
1. stantup.Configune ' de, ara yazılımı kullanmak için UseExceptionHandler çağırın: 







public void Configure(IApplicationBuilder app, IklebHostEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/error"); 

} 

app.UseHttpsRedirection(); 
app.UseRouting(); 
app.UseAuthorization(); 
app.UseEndpoints(endpoints = > 

{ 

endpoints.MapContnollers(); 

}); 


public void Configure(IApplicationBuilder app 3 IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/error"); 
app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseMvc(); 


2. /emor yoluna yanıt vermek için bir denetleyici eylemi yapılandırın: 

[ApiController] 

public class ErrorController : ControllerBase 

{ 

[Route("/erron")] 

public IActionResult Error() => Problem(); 

} 



[ApiController] 

public class ErrorController : ControllerBase 

{ 

[Route("/error")] 

public ActionResult Error([FromServices] IHostingEnvironment webHostEnvironment) 

{ 

var feature = HttpContext.Features.Get<IExceptionHandlerPathFeature>(); 
var ex = feature?.Error; 

var isDev = webHostEnvironment.IsDevelopment(); 
var problemDetails = new ProblemDetails 
{ 

Status = (int)HttpStatusCode.InternalServerError, 

Instance = feature?.Path, 

Title = isDev ? $"{ex.GetType().Name}: {ex.Message}" : "An error occurred.", 
Detail = İsDev ? ex.StackTrace : null, 

}; 


} 


return StatusCode(problemDetails.Status.Value, problemDetails); 

} 


Yukarıdaki Error eylemi istemciye RFC 7807ile uyumlu bir yük gönderir. 

Özel durum İşleme ara yazılımı, yerel geliştirme ortamında daha ayrıntılı içerik üzerinde anlaşılan çıkış de 
sağlayabilir. Geliştirme ve üretim ortamları genelinde tutarlı bir yük biçimi oluşturmak için aşağıdaki adım 
kullanın: 

1 . startup.Configure , ortama özgü özel durum İşleme ara yazılım örneklerini kaydedin: 

public void Configure(IApplicationBuilder app, IUebHostEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseExceptionHandler("/error-local-development"); 

} 

else 

{ 

app.UseExceptionHandler("/error"); 

} 

} 


public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseExceptionHandler("/error-local-development"); 

} 

else 

{ 

app.UseExceptionHandler("/error"); 

} 

} 

Yukarıdaki kodda, ara yazılım ile kaydedilir: 

• Geliştirme ortamında /error-local-development yolu. 

• Geliştirmeyen ortamlarda /error yolu. 

2. Denetleyici eylemlerine öznitelik yönlendirmeyi Uygula: 






[ApiController] 

public class ErrorController : ControllerBase 

{ 

[Route("/error-local-development")] 
public IActionResult ErrorLocalDevelopment( 

[FromServices] IWebHostEnvironment webHostEnvironment) 

{ 

if (webHostEnvironment.EnvironmentName != "Development") 

{ 

throw new InvalidOperationException( 

"This shouldn't be invoked in non-development environments.") 

} 

var context = HttpContext.Features.Get<IExceptionHandlerFeature>(); 
return Problem( 

detail: context.Error.StackTrace, 
title: context.Error.Message); 

} 

[Route("/error")] 

public IActionResult Error() => Problem(); 



[ApiController] 

public class ErrorController : ControllerBase 

{ 

[Route("/error-local-development")] 
public IActionResult ErrorLocalDevelopment( 

[FromServices] IHostingEnvironment webFlostEnvironment) 

{ 

if (!webHostEnvironment.IsDevelopment()) 

{ 

throw new InvalidOperationException( 

"This shouldn't be invoked in non-development environments."); 

} 

var feature = HttpContext.Features.Get<IExceptionHandlerPathFeature>(); 
var ex = feature?.Error; 

var problemDetails = new ProblemDetails 

{ 

Status = (int)HttpStatusCode.InternalServerError, 

Instance = feature?.Pattı, 

Title = ex.GetType().Name, 

Detail = ex.StackTrace, 

}; 

return StatusCode(problemDetails.Status.Value, problemDetails); 

} 

[Route("/error")] 
public ActionResult Error( 

[FromServices] IHostingEnvironment webFlostEnvironment) 

{ 

var feature = HttpContext.Features.Get<IExceptionHandlerPathFeature>(); 
var ex = feature?.Error; 

var isDev = webHostEnvironment.IsDevelopment(); 
var problemDetails = new ProblemDetails 
{ 

Status = (int)HttpStatusCode.InternalServerError, 

Instance = feature?.Path, 

Title = isDev ? $"{ex.GetType().Name}: {ex.Message}" : "An error occurred.", 
Detail = İsDev ? ex.StackTrace : null, 

}; 

return StatusCode(problemDetails.Status.Value, problemDetails); 

} 

} 


Yanıtı değiştirmek için özel durumları kullanın 

Yanıtın içeriği, denetleyicinin dışından değiştirilebilir. ASP.NET 4. x Web API 'sinde, bunu yapmanın bir yolu 
HttpResponseException türünü kullanmaktır. ASP.NET Core eşdeğer bir tür içermez. HttpResponseException için 
destek aşağıdaki adımlarla eklenebilir: 

1 . HttpResponseException adlı iyi bilinen bir özel durum türü oluşturun: 

public class HttpResponseException : Exception 

{ 

public int Status { get; set; } = 500; 
public object Value { get; set; } 

} 


2. HttpResponseExceptionFiiter adlı bir eylem filtresi oluşturun: 





public class HttpResponseExceptionFilter : IActionFilter., IOrderedFilter 

{ 

public int Order { get; set; } = int.MaxValue - 10; 

public void OnActionExecuting(ActionExecutingContext context) { } 

public void OnActionExecuted(ActionExecutedContext context) 

{ 

if (context.Exception is HttpResponseException exception) 

{ 

context.Result = new ObjectResult(exception.Value) 

{ 

StatusCode = exception.Status, 

}; 

context.ExceptionHandled = true; 

} 

} 

} 

3. Startup.configureServices , filtre koleksiyonuna eylem filtresini ekleyin: 

Services.AddControllers(options => 

options.Filters.Add(new HttpResponseExceptionFilter())); 


Services.AddMvc(options => 

options.Filters.Add(new HttpResponseExceptionFilter())) 
.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


Services.AddMvc(options => 

options.Filters.Add(new HttpResponseExceptionFilter())) 
.SetCompatibilityVersion(CompatibilityVersion.Version_2_l); 


Doğrulama hatası hata yanıtı 

Web API denetleyicileri için,, model doğrulama başarısız olduğunda MVC bir ValidationProblemDetails yanıt 
türüyle yanıt verir. MVC, bir doğrulama hatasına yönelik hata yanıtını oluşturmak için 
InvalidModelStateResponseFactory sonuçlarını kullanır. Aşağıdaki örnek, varsayılan yanıt türünü 
Startup.configureServices SerializableError olarak değiştirmek için fabrikası kullanır: 


Services.AddControllers() 

.ConfigureApiBehaviorOptions(options => 

{ 

options.InvalidModelStateResponseFactory = context => 

{ 

var result = new BadRequestObjectResult(context.ModelState); 

// TODO: add 'using using System.Net.Mime;' to resolve MediaTypeNames 
result.ContentTypes.Add(MediaTypeNames.Application.Hson); 
result.ContentTypes.Add(MediaTypeNames.Application.Xml); 

return result; 

}; 

}); 





Services. AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2) 
.ConfigureApiBehaviorOptions(options => 

{ 

options.InvalidModelStateResponseFactory = context => 

{ 

var result = new BadRequestObjectResult(context.ModelState); 

// TODO: add 'using using System.Net.Mime;' to resolve MediaTypeNames 
result.ContentTypes.Add(MediaTypeNames.Application.Tson); 
result.ContentTypes.Add(MediaTypeNames.Application.Xml); 

return result; 

}); 


Services. AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_l); 

Services.Configure<ApiBehaviorOptions>(options => 

{ 

options.InvalidModelStateResponseFactory = context => 

{ 

var result = new BadRequestObjectResult(context.ModelState); 

// TODO: add 'using using System.Net.Mime;' to resolve MediaTypeNames 
result.ContentTypes.Add(MediaTypeNames.Application.Tson); 
result .ContentTy pes .Add (MediaTypeNames .Application .Xml); 

return result; 

}); 


İstemci hata yanıtı 

Bir hata sonucu , 400 veya ÜZERİ bir http durum kodu ile sonuç olarak tanımlanır. Web API denetleyicileri için, 
MVC bir hata sonucunu ProblemDetailsbir sonuçla dönüştürür. 


IMPORTANT 

ASP.NET Core 2,1, neredeyse RFC 7807 uyumlu olan bir sorun ayrıntıları yanıtı üretir. Yüzde 100 uyumluluğu önemliyse, 
projeyi ASP.NET Core 2,2 veya üzeri bir sürüme yükseltin. 


Hata yanıtı aşağıdaki yollarla yapılandırılabilir: 

1. Problemayrıntılar Fabrikası Uygulama 

2. ApiBehaviorOptions. CIİentErrorMapping kullanın 

Problemayrıntılar Fabrikası Uygulama 

MVC, tüm ProblemDetails ve ValidationProblemDetailsörneklerini üretmek için 



uygulamasını kaydedin: 








public void ConfigureServices(IServiceCollection serviceCollection) 

{ 

Services.AddControllers(); 

Services.AddTransientcProblemDetailsFactory, CustomProblemDetailsFactory>(); 

} 


Hata yanıtı, Use ApiBehaviorOptions. ClientErrorMapping bölümünde özetlenen şekilde yapılandırılabilir. 

ApiBehaviorOptions. ClientErrorMapping kullanın 

ProblemDetails yanıtının içeriğini yapılandırmak için ClientErrorMapping özelliğini kullanın. Örneğin, 
startup.configureServices aşağıdaki kod 404 yanıtları için type özelliğini güncelleştirir: 

Services.AddControllers() 

.ConfigureApiBehaviorOptions(options = > 

{ 

options.SuppressConsumesConstraintForFormFileParameters = true; 
options.SuppressinferBindingSourcesForParameters = true; 
options.SuppressModelStatelnvalidFilter = true; 
options.SuppressMapClientErrors = true; 
options.ClientErrorMapping[404].Link = 

"https://httpstatuses.com/404"; 

}); 


Services. AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2) 

.ConfigureApiBehaviorOptions(options => 

{ 

options.SuppressConsumesConstraintForFormFileParameters = true; 
options.SuppressinferBindingSourcesForParameters = true; 
options.SuppressModelStatelnvalidFilter = true; 
options.SuppressMapClientErrors = true; 
options.ClientErrorMapping[404].Link = 

"https://httpstatuses.com/404"; 

}); 
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Scott Ade tarafından 

HTTP okuma-değerlendirme-yazdırma döngüsü (REPL): 

• .N ET Core 'un her yerde desteklenen basit, platformlar arası bir komut satırı aracı desteklenir. 

• ASP.NET Core Web API 'Lerini (ve non-ASP.NET çekirdek Web API 1 Leri) test etmek ve sonuçlarını 
görüntülemek için kullanılır. 

• Localhost ve Azure App Service dahil olmak üzere herhangi bir ortamda barındırılan Web API 'Lerini test etme 
özelliğine sahiptir. 

Aşağıdaki http fiilleri desteklenir: 

• SILMELI 

• Al 

• BAŞLı 

• Seçenekler 

• DÜZELTMESİ 

• Yayınla 

• KONUR 

Takip etmek için, örnek ASP.NET Core Web API 'sini (indirme) görüntüleyin veya indirin. 

Prerequisites 

• .N ET core 2.1 SDK veya üzeri 

Yükleme 

HTTP REPL 'u yüklemek için aşağıdaki komutu çalıştırın: 

dotnet tool install -g Microsoft.dotnet-httprepl 

.NET Core küresel aracı , Microsoft. DotNet-httprepl NuGet paketinden yüklenir. 

Kullanım 

Aracın başarıyla yüklenmesinden sonra, HTTP REPL 'u başlatmak için aşağıdaki komutu çalıştırın: 

httprepl 

Kullanılabilir HTTP REPL komutlarını görüntülemek için aşağıdaki komutlardan birini çalıştırın: 

httprepl -h 







httprepl --help 


Aşağıdaki çıktı görüntülenir: 

Usage: 

httprepl [<BASE_ADDRESS>] [options] 

Arguments: 

<BASE_ADDRESS> - The initial base address for the REPL. 

Options: 

-h|--help - Show help information. 

Önce the REPL starts, these commands are valid: 

Setup Commands: 

Use these commands to configure the tool for your API server 

connect Configures the directory structure and base address of the api server 

set header Sets or clears a header for ali requests. e.g. 'set header content-type application/json' 

HTTP Commands: 

Use these commands to execute requests against your application. 

GET get - Issues a GET request 

POST post - Issues a POST request 

PUT put - Issues a PUT request 

DELETE delete - Issues a DELETE request 

PATCH patch - Issues a PATCH request 

HEAD head - Issues a HEAD request 

OPTİONS options - Issues a OPTİONS request 

Navigation Commands: 

The REPL allows you to navigate your URL space and focus on specific APIs that you are working on. 

set base Set the base URI. e.g. 'set base http://locahost:5000' 

İs Show ali endpoints for the current path 

cd Append the given directory to the currently selected path, or move up a path when using 'cd .. 

Shell Commands: 

Use these commands to interact with the REPL Shell. 

clear Removes ali text from the Shell 

echo [on/off] Turns request echoing on or off, show the request that was made when using request commands 
exit Exit the Shell 

REPL Customization Commands: 

Use these commands to customize the REPL behavior. 

pref [get/set] Allows viewing or changing preferences, e.g. ’pref set editör.command.default 'C:\XProgram 
Files\\Microsoft VS CodeWCode.exe” 

run Runs the script at the given path. A script is a set of commands that can be typed with one 

command per line 

ui Displays the Swagger UI page, if available, in the default browser 

Use help <COMMAND>' for more detail on an individual command. e.g. 'help get'. 

For detailed tool info, see https://aka.ms/http-repl-doc. 


HTTP REPL komut tamamlama sağlar.Sekme tuşuna basıldığında, yazdığınız KARAKTERLERİ veya API uç 
noktasını tamamlayacak komutların listesi üzerinden yinelenir. Aşağıdaki bölümlerde kullanılabilir CLı komutları 
ana hatlarıyla verilmiştir. 


Web API ‘sine bağlanma 




Aşağıdaki komutu çalıştırarak bir Web API 'sine bağlanın: 


httprepl <ROOT URI> 

<root uri> ,WebAPI 'sinin temel URI 'sidir.Örneğin: 
httprepl https://localhost:5001 

Alternatif olarak, HTTP REPL çalışırken istediğiniz zaman aşağıdaki komutu çalıştırın: 

connect <ROOT URI> 

Örneğin: 

(Disconnected)~ connect https://localhost:5001 


Web API 'SI için Svvagger belgesine el ile işaret edin 

Yukarıdaki Connect komutu Svvagger belgesini otomatik olarak bulmaya çalışacaktır. Bir nedenden dolayı 
yapamaması durumunda, --swagger seçeneğini kullanarak Web API 'SI için Svvagger belgesinin URI 'sini 
belirtebilirsiniz: 

connect <ROOT URI> --swagger <SWAGGER URI> 

Örneğin: 

(Disconnected)~ connect https://localhost:5001 --swagger /swagger/vl/swagger.json 


Web API 'sinde gezin 

Kullanılabilir uç noktaları görüntüle 

Web API adresinin geçerli yolundaki farklı uç noktaları (denetleyiciler) listelemek için is veya dir komutunu 
çalıştırın: 

https://localhot:5001/~ İs 

Aşağıdaki çıkış biçimi görüntülenir: 

[] 

Fruits [get|post] 

People [get|post] 

https://localhost:5001/~ 

Yukarıdaki çıkış iki denetleyicinin bulunduğunu gösterir: Fruits ve People . Her iki denetleyici de parametresiz 
HTTP GET ve POST işlemlerini destekler. 

Belirli bir denetleyicide gezinmek daha ayrıntılı bilgi gösterir.Örneğin, aşağıdaki komut çıktısı, Fruits 
denetleyicisinin HTTP GET, PUT ve DELETE işlemlerini de desteklediğini gösterir. Bu işlemlerin her biri, rotada bir 













id parametresi bekler: 


https://localhost:5001/fruits~ İs 
[get|post] 

[] 

{id} [get|put|delete] 
https://localhost:5001/fruits~ 

Alternatif olarak, Web API 'sinin Svvagger Kullanıcı Arabirimi sayfasını bir tarayıcıda açmak için ui komutunu 
çalıştırın. Örneğin: 

https://localhost:5001/~ ui 

Bir uç noktaya gitme 

Web API 'sindeki farklı bir uç noktaya gitmek için cd komutunu çalıştırın: 

https://localhost:5001/~ cd people 

cd komutundan sonraki yol büyük/küçük harfe duyarlıdır. Aşağıdaki çıkış biçimi görüntülenir: 

/people [get|post] 

https://localhost:5001/people~ 


HTTP REPL 'ı özelleştirme 

HTTP REPL 'un varsayılan renkleri özelleştirilebilir. Ayrıca, varsayılan bir metin Düzenleyicisi tanımlanabilir. HTTP 
REPL tercihleri geçerli oturum genelinde kalıcı hale getirilir ve gelecekteki oturumlarda kabul edilir. Değiştirildikten 
sonra, Tercihler aşağıdaki dosyada depolanır: 

• 'Un 

• macOS 

• Windows 

% GIRIŞ%/. httpreplprefs 

. Httpreplprefs dosyası başlangıçta yüklendi ve çalışma zamanında değişiklikler için izlenmiyor. Dosyada el ile 
yapılan değişiklikler yalnızca araç yeniden başlatıldıktan sonra devreye girer. 

Ayarları görüntüleyin 

Kullanılabilir ayarları görüntülemek için pref get komutunu çalıştırın. Örneğin: 
https://localhost:5001/~ pref get 


Yukarıdaki komut, kullanılabilir anahtar-değer çiftlerini görüntüler: 







colors.j son=Green 
colors.json.arrayBrace=BoldCyan 
colors.j son.comma=BoldYellow 
colors.j son.name=BoldMagenta 
colors.json.nameSeparator=BoldWhite 
colors.json.objectBrace=Cyan 
colors.protocol=BoldGreen 
colors.status=BoldYellow 

Renk tercihlerini ayarla 

Yanıt renklendirme Şu anda yalnızca JSON için destekleniyor.Varsayılan HTTP REPL aracı renklendirmesini 
özelleştirmek için, değiştirilecek renge karşılık gelen anahtarı bulun. Anahtarları bulma hakkında yönergeler için 
bkz. ayarları görüntüleme bölümü. Örneğin, Green colors. json anahtar değerini aşağıdaki gibi white olarak 
değiştirin: 

https://localhost:5001/people~ pref set colors.json White 

Yalnızca izin verilen renkler kullanılabilir. Sonraki HTTP istekleri, yeni renklendirmesi ile çıktıyı görüntüler. 

Belirli renk anahtarları ayarlanmamışsa, daha genel anahtarlar kabul edilir. Bu geri dönüş davranışını göstermek 
için aşağıdaki örneği göz önünde bulundurun: 

• colors. json.name bir değere sahip değilse, colors. json.string kullanılır. 

• colors. json.string bir değere sahip değilse, colors. json.literai kullanılır. 

• colors. json.literai bir değere sahip değilse, colors. json kullanılır. 

• colors. json bir değere sahip değilse, komut kabuğun varsayılan metin rengi ( AiiowedCoiors.None ) kullanılır. 

Girinti boyutunu ayarla 

Yanıt girintileme boyut özelleştirmesi Şu anda yalnızca JSON için destekleniyor.Varsayılan boyut iki boşluklardan 
oluşamaz. Örneğin: 

[ 

{ 

"id": 1 , 

"name": "Apple" 

b 

{ 

"id": 2 , 

"name": "Orange" 

b 

{ 

"id": 3, 

"name": "Strawberry" 

} 

] 


Varsayılan boyutu değiştirmek için 

boşluk kullanmak için: 

formatting.json.indentSize 

anahtarını ayarlayın. Örneğin, her zaman dört 

pref set formatting.json.indentSize 4 


Sonraki yanıtlar dört boşluk ayarına uyar: 










[ 

{ 

"id": 1 , 

"name": "Apple" 

b 

{ 

"id": 2 , 

"name": "Orange" 

b 

{ 

"id": 3 , 

"name": "Stnawberry" 

} 

] 

Varsayılan metin düzenleyiciyi ayarlama 

Varsayılan olarak, HTTP REPL 'un kullanılmak üzere yapılandırılmış metin Düzenleyicisi yok. HTTP istek gövdesi 
gerektiren Web API yöntemlerini test etmek için varsayılan metin Düzenleyicisi ayarlanmalıdır. HTTP REPL Aracı, 
istek gövdesini oluşturma amacıyla yapılandırılmış metin düzenleyicisini başlatır. Tercih ettiğiniz metin düzenleyiciyi 
varsayılan olarak ayarlamak için aşağıdaki komutu çalıştırın: 

pref set editör.command.default "<EXECUTABLE>" 

Yukarıdaki komutta, <executable> metin düzenleyicisinin yürütülebilir dosyasının tam yoludur. Örneğin, Visual 
Studio Code varsayılan metin düzenleyicisi olarak ayarlamak için aşağıdaki komutu çalıştırın: 

• 'Un 

• macOS 

• Windows 

pref set editör.command.default "/usr/bin/code" 

Varsayılan metin düzenleyiciyi belirli CLı bağımsız değişkenleriyle başlatmak için editör.command.default.arguments 
anahtarını ayarlayın. Örneğin, Visual Studio Code varsayılan metin Düzenleyicisi olduğunu ve her zaman HTTP 
REPL 'un uzantıları devre dışı bırakılmış yeni bir oturumda Visual Studio Code açmasını istediğinizi varsayalım. Şu 
komutu çalıştırın: 

pref set editör.command.default.arguments "--disable-extensions --new-window" 

Svvagger arama yollarını ayarla 

Varsayılan olarak, HTTP REPL, --swagger seçeneği olmadan connect komutunu yürütürken Svvagger belgesini 
bulmak için kullandığı bir göreli yollar kümesine sahiptir. Bu göreli yollar, connect komutunda belirtilen kök ve 
taban yollarla birleştirilir. Varsayılan göreli yollar şunlardır: 

• Svvagger. JSON 

• Swagger/vl/Swagger. JSON 

• /svvagger.json 

• /svvagger/vl /svvagger.json 

Ortamınızda farklı bir arama yolları kümesi kullanmak için swagger.searchPaths tercihini ayarlayın. Değer, göreli 
yolların kanal ile ayrılmış bir listesi olmalıdır. Örneğin: 














pref set swagger.searchPaths "swagger/v2/swagger.json|swagger/v3/swagger.json" 


HTTP GET isteklerini test etme 

Özeti 

get <PARAMETER> [-F|--no-formatting] [-h|--header] [--response] [--responseıbody] [--responseıheaders] [ - s | - - 
streaming] 

Arguments 

PARAMETER 

Varsa, ilişkili denetleyici eylem yöntemi tarafından beklenen rota parametresi. 

Seçenekler 

get komutu için aşağıdaki seçenekler kullanılabilir: 

• -F|--no-formatting 

HTTP yanıt biçimlendirme, varlığı bastırır bir bayrak. 

• -h|--header 

Bir HTTP isteği üstbilgisini ayarlar.Aşağıdaki iki değer biçimleri desteklenir: 

o 

o 

• --response 

Bir dosya (üstbilgi ve gövde dahil) tüm HTTP yanıtı yazılması gerektiğini belirtir. Örneğin: 

--response "C:\response.txt" . Dosya yoksa oluşturulur. 

• --responseıbody 

Bir dosya HTTP yanıt gövdesinde yazılması gerektiğini belirtir. Örneğin: --response:body "C:\response.json" 

. Dosya yoksa oluşturulur. 

• --response:headers 

Bir dosya HTTP yanıt üstbilgilerinin yazılması gerektiğini belirtir. Örneğin: 

--responseıheaders "C:\response.txt" . Dosya yoksa oluşturulur. 

• -s|--streaming 

HTTP yanıtı akış, durum sağlayan bir bayrak. 

Örnek 

HTTP GET isteği vermek için: 

1. get komutunu bunu destekleyen bir uç noktada çalıştırın: 

https://localhost:5001/people~ get 


{header}={value} 
{header}:{value} 


Yukarıdaki komut aşağıdaki çıkış biçimini görüntüler: 














HTTP/1.1 200 OK 

Content-Type: application/jsonj charset=utf-8 
Date: Fri, 21 1un 2019 03:38:45 GMT 
Serven: Kestrel 
Transfen-Encoding: chunked 

[ 

{ 

"id": lj 

"name": "Scott Hunter" 

b 

{ 

"id": 2, 

"name": "Scott Hanselman" 

b 

{ 

"id": 3, 

"name": "Scott Guthrie" 

} 

] 


https://localhost:5001/people~ 

2. get komutuna bir parametre geçirerek belirli bir kaydı alın: 

https://localhost:5001/people~ get 2 

Yukarıdaki komut aşağıdaki çıkış biçimini görüntüler: 

HTTP/1.1 200 OK 

Content-Type: application/json; charset=utf-8 
Date: Fri, 21 1un 2019 06:17:57 GMT 
Server: Kestrel 
Transfer-Encoding: chunked 

[ 

{ 

"id": 2, 

"name": "Scott Hanselman" 

} 

] 


https://localhost:5001/people~ 


HTTP POST isteklerini test et 

Özeti 

post <PARAMETER> [-c|--content] [-f|--file] [-h|--header] [--no-body] [-F|--no-formatting] [--response] [- 
response:body] [--response:headers] [-s|--streaming] 


Arguments 

PARAMETER 


Varsa, ilişkili denetleyici eylem yöntemi tarafından beklenen rota parametresi. 


Seçenekler 





• -F|--no-formatting 

HTTP yanıt biçimlendirme, varlığı bastırır bir bayrak. 

• -h|--header 

Bir HTTP isteği üstbilgisini ayarlar.Aşağıdaki iki değer biçimleri desteklenir: 

o {header}={value} 
o {header}:{value} 

• --response 

Bir dosya (üstbilgi ve gövde dahil) tüm HTTP yanıtı yazılması gerektiğini belirtir. Örneğin: 

--response "C:\response.txt" . Dosya yoksa oluşturulur. 

• --response:body 

Bir dosya HTTP yanıt gövdesinde yazılması gerektiğini belirtir. Örneğin: --response:body "C:\response.json" 

. Dosya yoksa oluşturulur. 

• --response:headers 

Bir dosya HTTP yanıt üstbilgilerinin yazılması gerektiğini belirtir. Örneğin: 

--response:headers "C:\response.txt" . Dosya yoksa oluşturulur. 

• -s|--streaming 

HTTP yanıtı akış, durum sağlayan bir bayrak. 

• -c|--content 

Bir satır içi HTTP isteği gövdesinin sağlar.Örneğin: -c "{ 'id': 2 , 'name': 'Cherry' . 

• -f|--file 

HTTP isteği gövdesinin içeren bir dosya için bir yol sağlar.Örneğin: -f "C:\request.json" . 

• --no-body 

Hiç HTTP istek gövdesi gerekli olduğunu gösterir. 

Örnek 

HTTP POST isteği vermek için: 

1. post komutunu bunu destekleyen bir uç noktada çalıştırın: 

https://localhost:5001/people~ post -h Content-Type=application/json 

Önceki komutta, Content-Type HTTP istek üst bilgisi bir istek gövdesi medya türü olan JSON belirten 
şekilde ayarlanır. Varsayılan metin Düzenleyicisi, HTTP istek gövdesini temsil eden bir JSON şablonuyla bir. 
tmp dosyası açar. Örneğin: 

{ 

"id": 0, 

"name": "" 

> 



















{ 

"id": 0, 

"name": "Scott Addie" 

} 


3. . Tmp dosyasını kaydedin ve metin düzenleyicisini kapatın. Aşağıdaki çıktı komut kabuğu ’nda görünür: 

HTTP/1.1 201 Created 

Content-Type: application/json; charset=utf-8 
Date: Thu, 27 1un 2019 21:24:18 GMT 
Location: https://localhost:5001/people/4 
Server: Kestrel 
Transfer-Encoding: chunked 

{ 

"id": 4, 

"name": "Scott Addie" 

} 

https://localhost:5001/people~ 


HTTP PUT isteklerini test etme 

Özeti 

put <PARAMETER> [-c|--content] [-f|--file] [-h|--header] [--no-body] [-F|--no-formatting] [--response] [-- 
response:body] [--response:headers] [-s |--streaming] 


Arguments 

PARAMETER 

Varsa, ilişkili denetleyici eylem yöntemi tarafından beklenen rota parametresi. 

Seçenekler 

• -F|--no-formatting 

HTTP yanıt biçimlendirme, varlığı bastırır bir bayrak. 

• -h|--header 

Bir HTTP isteği üstbilgisini ayarlar.Aşağıdaki iki değer biçimleri desteklenir: 

o {header}={value} 
o {header}:{value} 

• --response 

Bir dosya (üstbilgi ve gövde dahil) tüm HTTP yanıtı yazılması gerektiğini belirtir. Örneğin: 
--response "C:\response.txt" . Dosya yoksa oluşturulur. 













- -response:body "C: \response .json" 


• --response:body 

Bir dosya HTTP yanıt gövdesinde yazılması gerektiğini belirtir. Örneğin: 
. Dosya yoksa oluşturulur. 


• --response:headers 


Bir dosya HTTP yanıt üstbilgilerinin yazılması gerektiğini belirtir. Örneğin: 
--response:headers "C:\nesponse.txt" . Dosya yoksa oluşturulur. 


• -s|--stneaming 


HTTP yanıtı akış, durum sağlayan bir bayrak. 


• -c|--content 

Bir satır içi HTTP isteği gövdesinin sağlar.Örneğin: -c "{ 'id': 2 , 'name': 'Cherry' }" . 

• -f|--file 

HTTP isteği gövdesinin içeren bir dosya için bir yol sağlar.Örneğin: -f "C:\request.json" . 

• --no-body 


Hiç HTTP istek gövdesi gerekli olduğunu gösterir. 

Örnek 

HTTP PUT isteği vermek için: 

1. İsteğe bağlı: verileri değiştirmeden önce görüntülemek için get komutunu çalıştırın: 

https://localhost:5001/fruits~ get 
HTTP/1.1 200 OK 

Content-Type: application/json; charset=utf-8 
Date: Sat, 22 1un 2019 00:07:32 GMT 
Server: Kestrel 
Transfer-Encoding: chunked 

[ 

{ 

"id": 1, 

"data": "Apple" 

b 

{ 

"id": 2, 

"data": "Orange" 

b 

{ 

"id": 3, 

"data": "Strawberry" 

} 

] 


2. Run the put command on an endpoint that supports it: 

https://localhost:5001/fruits~ put 2 -h Content-Type=application/json 

Önceki komutta, Content-Type HTTP istek üst bilgisi bir istek gövdesi medya türü olan JSON belirten 
şekilde ayarlanır. Varsayılan metin Düzenleyicisi, HTTP istek gövdesini temsil eden bir JSON şablonuyla bir. 
tmp dosyası açar. Örneğin: 

















{ 

"id": 0j 

"name": "" 



{ 

"id": 2, 

"name": "Cherry" 


4. . Tmp dosyasını kaydedin ve metin düzenleyicisini kapatın. Aşağıdaki çıktı komut kabuğu ’nda görünür: 

[main 2019-06-28T17:27:01.805Z] update#setState idle 

HTTP/1.1 204 No Content 

Date: Fri, 28 1un 2019 17:28:21 GMT 

Server: Kestrel 

5. İsteğe bağlı: değişiklikleri görmek için bir get komutu verin. Örneğin, metin düzenleyicisinde "Chraz" 
yazdıysanız, get aşağıdakileri döndürür: 

https://localhost:5001/fruits~ get 
HTTP/1.1 200 OK 

Content-Type: application/json; charset=utf-8 
Date: Sat, 22 1un 2019 00:08:20 GMT 
Server: Kestrel 
Transfer-Encoding: chunked 

[ 

{ 

"id": 1, 

"data": "Apple" 

b 

{ 

"id": 2, 

"data": "Cherry" 

b 

{ 

"id": 3, 

"data": "Strawberry" 

} 

] 


https://localhost:5001/fruits~ 


HTTP SİLME isteklerini test etme 


Özeti 











delete <PARAMETER> [-F|--no-formatting] [-h|--header] [--response] [--response:body] [--response:headers] [-s|- 
-streaming] 

Arguments 

PARAMETER 

Varsa, ilişkili denetleyici eylem yöntemi tarafından beklenen rota parametresi. 

Seçenekler 

• -F|--no-formatting 

HTTP yanıt biçimlendirme, varlığı bastırır bir bayrak. 

• -h|--header 

Bir HTTP isteği üstbilgisini ayarlar.Aşağıdaki iki değer biçimleri desteklenir: 

o 

o 

• --response 

Bir dosya (üstbilgi ve gövde dahil) tüm HTTP yanıtı yazılması gerektiğini belirtir. Örneğin: 

--response "C:\response.txt" . Dosya yoksa oluşturulur. 

• --responseıbody 

Bir dosya HTTP yanıt gövdesinde yazılması gerektiğini belirtir. Örneğin: --response:body "C:\response.json" 

. Dosya yoksa oluşturulur. 

• --responseıheaders 

Bir dosya HTTP yanıt üstbilgilerinin yazılması gerektiğini belirtir. Örneğin: 

--response:headers "C:\response.txt" . Dosya yoksa oluşturulur. 

• -s|--streaming 

HTTP yanıtı akış, durum sağlayan bir bayrak. 

Örnek 

HTTP SİLME isteği vermek için: 

1. İsteğe bağlı: verileri değiştirmeden önce görüntülemek için get komutunu çalıştırın: 


{header}={value} 
{header}:{value} 














https://localhost:5001/fruits~ get 
HTTP/1.1 200 OK 

Content-Type: application/json; charset=utf-8 
Date: Sat, 22 1un 2019 00:07:32 GMT 
Server: Kestrel 
Transfen-Encoding: chunked 

[ 

{ 

"id": 1, 

"data": "Apple" 

b 

{ 

"id": 2, 

"data": "Orange" 

b 

{ 

"id": 3, 

"data": "Strawberry" 

} 

] 


2. Run the delete command on an endpoint that supports it: 


https://localhost:5001/fruits~ delete 2 


Yukarıdaki komut aşağıdaki çıkış biçimini görüntüler: 

HTTP/1.1 204 No Content 

Date: Fri, 28 1un 2019 17:36:42 GMT 

Server: Kestrel 

3. İsteğe bağU: değişiklikleri görmek için bir get komutu verin. Bu örnekte, bir get aşağıdakini döndürür 

https://localhost:5001/fruits~ get 
HTTP/1.1 200 OK 

Content-Type: application/json; charset=utf-8 
Date: Sat, 22 1un 2019 00:16:30 GMT 
Server: Kestrel 
Transfer-Encoding: chunked 

[ 

{ 

"id": 1, 

"data": "Apple" 

b 

{ 

"id": 3, 

"data": "Strawberry" 

} 

] 


https://localhost:5001/fruits~ 


HTTP PATCH isteklerini test etme 


Özeti 









patch <PARAMETER> [-c|--content] [-f|--file] [-h|--header] [--no-body] [-F|--no-formatting] [--response] [-- 
responseıbody] [--response:headers] [-s|--streaming] 


Arguments 

PARAMETER 

Varsa, ilişkili denetleyici eylem yöntemi tarafından beklenen rota parametresi. 

Seçenekler 

• -F|--no-formatting 

HTTP yanıt biçimlendirme, varlığı bastırır bir bayrak. 

• -h|--header 

Bir HTTP isteği üstbilgisini ayarlar.Aşağıdaki iki değer biçimleri desteklenir: 

o 

o 

• --response 

Bir dosya (üstbilgi ve gövde dahil) tüm HTTP yanıtı yazılması gerektiğini belirtir. Örneğin: 

--response "C:\response.txt" . Dosya yoksa oluşturulur. 

• --response:body 

Bir dosya HTTP yanıt gövdesinde yazılması gerektiğini belirtir. Örneğin: --response:body "C:\response.json" 

. Dosya yoksa oluşturulur. 

• --response:headers 

Bir dosya HTTP yanıt üstbilgilerinin yazılması gerektiğini belirtir. Örneğin: 

--response:headers "C:\response.txt" . Dosya yoksa oluşturulur. 

• -s|--streaming 

HTTP yanıtı akış, durum sağlayan bir bayrak. 

• -c|--content 

Bir satır içi HTTP isteği gövdesinin sağlar.Örneğin: -c "{ 'id': 2 , 'name': 'Cherry' . 

• -f|--file 

HTTP isteği gövdesinin içeren bir dosya için bir yol sağlar.Örneğin: -f "C:\request.json" . 

• --no-body 

Hiç HTTP istek gövdesi gerekli olduğunu gösterir. 

HTTP HEAD isteklerini test etme 

Özeti 

head <PARAMETER> [-F|--no-formatting] [-h|--header] [--response] [--responserbody] [--response:headers] [-s|- 
streaming] 


{header}={value} 
{header}:{value} 


Arguments 


















PARAMETER 

Varsa, ilişkili denetleyici eylem yöntemi tarafından beklenen rota parametresi. 

Seçenekler 

• -F|--no-formatting 

HTTP yanıt biçimlendirme, varlığı bastırır bir bayrak. 

• -h|--header 

Bir HTTP isteği üstbilgisini ayarlar.Aşağıdaki iki değer biçimleri desteklenir: 

o 

o 

• --response 

Bir dosya (üstbilgi ve gövde dahil) tüm HTTP yanıtı yazılması gerektiğini belirtir. Örneğin: 

--response "C:\response.txt" . Dosya yoksa oluşturulur. 

• --response:body 

Bir dosya HTTP yanıt gövdesinde yazılması gerektiğini belirtir. Örneğin: --response:body "C:\response.json" 

. Dosya yoksa oluşturulur. 

• --response:headers 

Bir dosya HTTP yanıt üstbilgilerinin yazılması gerektiğini belirtir. Örneğin: 

--response:headers "C:\response.txt" . Dosya yoksa oluşturulur. 

• -s|--streaming 

HTTP yanıtı akış, durum sağlayan bir bayrak. 

Sınama HTTP SEÇENEKLERİ istekleri 

Özeti 

options <PARAMETER> [-F|--no-formatting] [-h|--header] [--response] [--responseıbody] [--response:headers] [- 
s|--streaming] 

Arguments 

PARAMETER 

Varsa, ilişkili denetleyici eylem yöntemi tarafından beklenen rota parametresi. 

Seçenekler 

• -F|--no-formatting 

HTTP yanıt biçimlendirme, varlığı bastırır bir bayrak. 

• -h|--header 

Bir HTTP isteği üstbilgisini ayarlar.Aşağıdaki iki değer biçimleri desteklenir: 

o 

o 

• --response 


{header}={value} 
{header}:{value} 


{header}={value} 
{header}:{value} 



















Bir dosya (üstbilgi ve gövde dahil) tüm HTTP yanıtı yazılması gerektiğini belirtir. Örneğin: 

--response "C:\response.txt" . Dosya yoksa oluşturulur. 

• --response:body 

Bir dosya HTTP yanıt gövdesinde yazılması gerektiğini belirtir. Örneğin: --responserbody "C:\response.json" 
. Dosya yoksa oluşturulur. 

• --responseıheaders 

Bir dosya HTTP yanıt üstbilgilerinin yazılması gerektiğini belirtir. Örneğin: 

--responseıheaders "C:\response.txt" . Dosya yoksa oluşturulur. 

• -s|--streaming 

HTTP yanıtı akış, durum sağlayan bir bayrak. 

HTTP istek üst bilgilerini ayarla 

Bir HTTP istek üst bilgisi ayarlamak için aşağıdaki yaklaşımlardan birini kullanın: 

• HTTP isteğiyle satır içi ayarlayın. Örneğin: 

https://localhost:5001/people~ post -h Content-Type=application/json 

Önceki yaklaşımla, her ayrı HTTP istek üst bilgisi kendi -h seçeneğini gerektirir. 

• HTTP isteğini göndermeden önce ayarlayın. Örneğin: 

https://localhost:5001/people~ set header Content-Type application/json 

Bir isteği göndermeden önce üst bilgi ayarlanırken üst bilgi, komut kabuğu oturumunun süresi boyunca 
ayarlanmış olarak kalır. Üstbilgiyi temizlemek için boş bir değer sağlayın. Örneğin: 

https://localhost:5001/people~ set header Content-Type 


Güvenli uç noktaları test et 

HTTP REPL, HTTP istek üst bilgilerinin kullanımı aracılığıyla güvenli uç noktaların sınamasını destekler. 
Desteklenen kimlik doğrulama ve yetkilendirme düzenlerine örnek olarak temel kimlik doğrulaması, JWT taşıyıcı 
belirteçleri ve Özet kimlik doğrulaması verilebilir. Örneğin, aşağıdaki komutla bir uç noktaya bir taşıyıcı belirteci 
gönderebilirsiniz: 

set header Authorization "bearer cTOKEN VALUE>" 

Azure 'da barındırılan bir uç noktaya erişmek veya azure REST APIkullanmak için bir taşıyıcı belirtecine ihtiyacınız 
vardır. Azure CLI aracıIığıyla Azure Aboneliğinize yönelik bir taşıyıcı belirteci almak için aşağıdaki adımları kullanın. 
HTTP REPL, bir HTTP istek üstbilgisindeki taşıyıcı belirtecini ayarlar ve Azure App Service Web Apps listesini alır. 

1. Azure'da oturum açın: 

az login 











2. Aşağıdaki komutla abonelik KİMLİĞİNİZİ alın: 


az account show --query id 

3. Abonelik KİMLİĞİNİZİ kopyalayın ve şu komutu çalıştırın: 


az account set --subscription "<SUBSCRIPTION ID>" 


4. Aşağıdaki komutla taşıyıcı belirtecinizi alın: 

az account get-access-token --query accessToken 


5. HTTP REPL aracılığıyla Azure REST API bağlanma: 

httprepl https://management.azune.com 

6. Authorization HTTP istek üst bilgisini ayarlayın: 


https://management.azure.com/> set header Authorization "bearer <ACCESS TOKEN>" 


7. Aboneliğe gidin: 

https://management.azure.com/> cd subscriptions/<SUBSCRIPTION ID> 


8. Aboneliğinizin Azure App Service Web Apps bir listesini alın: 

https://management.azure.com/subscriptions/{SUBSCRİPTİON ID}> get providers/Microsoft.Web/sites?api- 
version=2016-08-01 


Aşağıdaki yanıt görüntülenir: 

HTTP/1.1 200 OK 
Cache-Control: no-cache 
Content-Length: 35948 

Content-Type: application/jsonj charset=utf-8 
Date: Thu, 19 Sep 2019 23:04:03 GMT 
Expires: -1 
Pragma: no-cache 

Strict-Transport-Security: max-age=31536000j includeSubDomains 
X-Content-Type-Options: nosniff 

x-ms-correlation-request-id: <em>xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx</em> 
x-ms-original-request-ids: <em>xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx;xxxxxxxx-xxxx-xxxx-xxxx- 
xxxxxxxxxxxx</em> 

x-ms-ratelimit-remaining-subscription-reads: 11999 
x-ms-request-id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 

x-ms-routing-request-id: WESTUS:xxxxxxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx 

{ 

"value": [ 

<AZURE RESOURCES LIST> 

] 

} 








HTTP istek görüntüsünü değiştirme 

Varsayılan olarak, gönderilmekte olan HTTP isteğinin görüntüsü bastırılır. Komut kabuğu oturumunun süresi 
boyunca ilgili ayarı değiştirmek mümkündür. 

İstek görüntülemesini etkinleştir 

echo on komutunu çalıştırarak gönderilmekte olan HTTP isteğini görüntüleyin. Örneğin: 

https://localhost:5001/people~ echo on 
Request echoing is on 

Geçerli oturumdaki sonraki HTTP istekleri, istek üst bilgilerini görüntüler.Örneğin: 

https://localhost:5001/people~ post 

[main 2019-06-28T18:50:11.930Z] update#setState idle 
Request to https://localhost:5001... 

POST /people HTTP/1.1 
Content-Length: 41 
Content-Type: application/json 
User-Agent: HTTP-REPL 

{ 

"id": 0, 

"name": "Scott Addie" 

} 

Response from https://localhost:5001... 

HTTP/1.1 201 Created 

Content-Type: application/json; charset=utf-8 
Date: Fri, 28 1un 2019 18:50:21 GMT 
Location: https: //localhost:5001/people/4 
Server: Kestrel 
Tnansfer-Encoding: chunked 

{ 

"id": 4, 

"name": "Scott Addie" 

} 


https://localhost:5001/people~ 


İstek görüntüsünü devre dışı bırak 

echo off komutu çalıştırılarak gönderilmekte olan HTTP isteğinin görüntülenmesini gizleyin. Örneğin: 

https://localhost:5001/people~ echo off 
Request echoing is off 


Betik çalıştır 

Aynı HTTP REPL komutları kümesini sıklıkla yürütüyorsanız bunları bir metin dosyasında depolamayı göz önünde 
bulundurun. Dosyadaki komutlar, komut satırında el ile çalıştıranlarla aynı formu alır.Komutlar, run komutu 
kullanılarak toplanmış bir biçimde yürütülebilir. Örneğin: 

1. Yeni satır için ayrılmış komutlar kümesini içeren bir metin dosyası oluşturun. Göstermek için aşağıdaki 
komutları içeren bir People-Script. txt dosyası düşünün: 








set base https://localhost:5001 
İs 

cd People 
İs 

get 1 

2. Metin dosyasının yolunu geçirerek run komutunu yürütün. Örneğin: 
https://localhost:5001/~ run C: \http-repl-scripts\people-script.txt 


Aşağıdaki çıktı görüntülenir: 


https://localhost:5001/~ set base https://localhost:5001 

Using swagger metadata from https://localhost:5001/swagger/vl/swagger.json 

https://localhost:5001/~ İs 

[] 

Fruits [get|post] 

People [get|post] 

https://localhost:5001/~ cd People 
/People [get|post] 

https://localhost:5001/People~ İs 
[get|post] 

[] 

{id} [get|put|delete] 

https://localhost:5001/People~ get 1 
HTTP/1.1 200 OK 

Content-Type: application/jsonj charset=utf-8 
Date: Fri, 12 Jul 2019 19:20:10 GMT 
Server: Kestrel 
Transfer-Encoding: chunked 

{ 

"id": 1, 

"name": "Scott Hunter" 

} 

https://localhost:5001/People~ 


Çıktıyı temizle 

HTTP REPL aracı tarafından komut kabuğu'na yazılan tüm çıktıyı kaldırmak için ciear veya cis komutunu 
çalıştırın. Göstermek için komut kabuğu 'nun aşağıdaki çıktıyı içerdiğini düşünün: 

httprepl https://localhost:5001 
(Disconnected)~ set base "https://localhost:5001" 

Using swagger metadata from https://localhost:5001/swagger/vl/swagger.json 

https://localhost:5001/~ İs 

[] 

Fruits [get|post] 

People [get|post] 

https://localhost:5001/~ 










Çıktıyı temizlemek için aşağıdaki komutu çalıştırın: 


https://localhost:5001/~ clear 


Yukarıdaki komutu çalıştırdıktan sonra, komut kabuğu yalnızca şu çıktıyı içerir: 

https://localhost:5001/~ 


Ek kaynaklar 

• REST API istekleri 

• HTTP REPL GitHub deposu 




ASRNET Core SignalR giriş 
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SignalRnedir? 

ASP.NET Core SignalR, uygulamalara gerçek zamanlı Web işlevselliği eklemeyi kolaylaştıran açık kaynaklı 
bir kitaplıktır. Gerçek zamanlı Web işlevselliği, sunucu tarafı kodun anında istemcilere içerik 
gönderebilmesine olanak sağlar. 

SignalRiçin iyi adaylar: 

• Sunucudan yüksek frekanslı güncelleştirmeler gerektiren uygulamalar.Oyun, sosyal ağlar, oylama, açık 
eksiltme, haritalar ve G PS uygulamaları örnekleri verilmiştir. 

• Panolar ve izleme uygulamaları. Şirket panoları, anlık satış güncelleştirmeleri veya seyahat uyarıları 
örnekleri bulunur. 

• işbirliğine dayalı uygulamalar. Beyaz tahta uygulamaları ve takım toplantısı yazılımı, işbirliğine dayalı 
uygulamalara örnek olarak verilebilir. 

• Bildirimleri gerektiren uygulamalar.Sosyal ağlar, e-posta, sohbet, Oyunlar, seyahat uyarıları ve diğer 
birçok uygulama kullanım bildirimleri. 

SignalR, sunucudan istemciye uzak yordam çağrıları (RPC)oluşturmak İÇİN bir API sağlar.RPC 'ler, sunucu 
tarafı .NET Core kodundan gelen istemcilerdeki JavaScript işlevlerini çağırır. 

ASP.NET Core için SignalR bazı özellikler şunlardır: 

• Bağlantı yönetimini otomatik olarak işler. 

• Tüm bağlı istemcilere aynı anda iletiler gönderir.Örneğin, bir sohbet odası. 

• Belirli istemcilere veya istemci gruplarına iletiler gönderir. 

• Artan trafiği işleyecek şekilde ölçeklendirilir. 

Kaynak, GitHub 'daki birSignalR deposundabarındırılır. 

Taşımalar 

SignalR gerçek zamanlı iletişimi (düzgün geri dönüş sırasıyla) işlemek için aşağıdaki teknikleri destekler: 

• VVebSockets 

• Sunucu tarafından gönderilen olaylar 

• Uzun yoklama 

SignalR, sunucu ve istemci özellikleri içinde en iyi taşıma yöntemini otomatik olarak seçer. 

Merkezler 

SignalR, istemciler ve sunucular arasında iletişim kurmak için hub 'lar kullanır. 

Hub, bir istemcinin ve sunucunun birbirlerine Yöntemler çağırmasını sağlayan üst düzey bir işlem hattdır. 
SignalR, makinenin sunucu sınırları genelinde dağıtımını otomatik olarak işler ve istemcilerin sunucuda 
Yöntemler çağırmasını sağlar ve tam tersi de geçerlidir. Model bağlamayı sağlayan yöntemlere kesin olarak 
yazılmış parametreler geçirebilirsiniz. SignalR iki yerleşik hub Protokolü sağlar: JSON tabanlı bir metin 
Protokolü ve MessagePacktemelli bir ikili protokol. MessagePack genellikle JSON ile karşılaştırıldığında daha 
küçük iletiler oluşturur. Daha eski tarayıcıların, MessagePack protokolü desteği sağlamak için XHR düzey 2 ' i 




desteklemesi gerekir. 


Hub 1ar, istemci tarafı yönteminin adını ve parametrelerini içeren iletiler göndererek istemci tarafı kodu 
çağırır. Yöntem parametreleri olarak gönderilen nesneler, yapılandırılan protokol kullanılarak seri durumdan 
çıkarılacak, istemci, adı istemci tarafı koddaki bir yöntemle eşleştirmeye çalışır, istemci bir eşleşme 
bulduğunda, yöntemini çağırır ve seri durumdan çıkarılan parametre verilerine geçirir. 

Ek kaynaklar 

• ASP.NET Core için SignalR kullanmaya başlama 

• Desteklenen Platformlar 

• Merkezler 

• JavaScript istemcisi 


Desteklenen SignalR platformları ASPNET Core 
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Sunucu sistem gereksinimleri 

ASP.NET Core için SignalR, ASP.NET Core desteklediği tüm sunucu platformunu destekler. 

JavaScript istemcisi 

JavaScript İstemcisi NodeJS 8 ve sonraki sürümlerde ve aşağıdaki tarayıcılarda çalışır: 


BROVVSER 

SÜRÜM 

Microsoft Edge 

Geçerlit 

Mozilla Firefox 

Geçerlit 

Google Chrome; Android içerir 

Geçerlit 

Uygulamasını İOS içerir 

Geçerlit 

Microsoft internet Explorer 

11 


+ geçerli, tarayıcının en son sürümünü ifade eder. 

.NET istemcisi 

.Net Client .ASP.NET Core tarafından desteklenen herhangi bir platformda çalışır.Örneğin, Xamarin geliştiricileri, 
Xamarin. İOS 8.4.0.1 ve üstünü kullanarak Android uygulamaları oluşturmak için SignalRkullanabilir ve Xamarin. 
İOS 11.14.0.4 ve üstünü kullanarak İOS uygulamaları oluşturabilir. 

Sunucu 11S çal işti rıyorsa, VVebSockets aktarımı Windows Server 2012 veya üzeri sürümlerde IIS 8,0 veya sonraki 
bir sürümü gerektirir. Diğer aktarımlar tüm platformlarda desteklenir. 

Java istemcisi 

Java istemcisi , Java 8 ve sonraki sürümlerini destekler. 

Desteklenmeyen istemciler 

Aşağıdaki istemciler mevcuttur, ancak deneysel veya resmi olmayan bir.Şu anda desteklenmemektedir ve hiçbir 
şekilde bulunmayabilir. 

• C + + istemcilerinin 


• Swift istemcisi 





Öğretici: ASPNET Core SignalR ile çalışmaya 
başlama 

26.11.2019 • 21 minutes to read ı Edit Online 


Bu öğreticide SignalRkullanarak gerçek zamanlı bir uygulama oluşturmanın temelleri öğretilir.Aşağıdakileri nasıl 
yapacağınızı öğrenirsiniz: 

• Web projesi oluşturun. 

• SignalR istemci kitaplığı ekleyin. 

• SignalR hub'ı oluşturun. 

• Projeyi SignalRkullanacak şekilde yapılandırın. 

• Herhangi bir istemciden tüm bağlı istemcilere ileti gönderen kodu ekleyin. 

Sonunda, çalışan bir sohbet uygulamanız olacaktır: 


| SignalRChat X + 

— n x 

| SignalRChat X + 

4- C A localhost:44378 ☆ © : 

4- C A localhost:44378 ☆ © : 

SignalRChat 

SignalRChat 

User Hanna 

User Spencer 


Message ni everyone! 

Message Got y 0 ur message Hanna. 

Send Message 

Send Message 


• Hanna says Hi everyone! 

• Spencer says Got your 
message Hanna. 

• Hanna says Hi everyone! 

• Spencer says Got your 
message Hanna. 
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Önkoşullar 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• ASP.net ve Web geliştirme iş yüküyle Visual Studio 2019 

• .NET Core 3,0 SDK veya üzeri 

Web uygulaması projesi oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Menüden dosya > yeni proje' yi seçin. 

• Yeni proje oluştur iletişim kutusunda ASP.N ET Core Web uygulaması' nı seçin ve ardından İleri' yi 













seçin. 


• Yeni projenizi yapılandırın iletişim kutusunda, proje signalrchatad\ru adlandırın ve ardından Oluştur' u 
seçin. 

• Yeni bir ASP.N ET Core Web uygulaması oluştur iletişim kutusunda .net Core ve ASP.NET Core 3,0' i 

seçin. 

• Razor Pages kullanan bir proje oluşturmak için Web uygulaması 1 nı seçin ve ardından Oluştur' u seçin. 


X 


Create a new ASP.NET Core web application 


.NFT Core 


ASP.NFT Core .3.0 


^ Empty 

An empty project template for creating an ASP.NFT Core application. This template does not have any content in it. 



A project template for creating an ASP.NET Core application with an exarnple Controller for a RESTful HTTP service. 
This template can also be used for ASP.NFT Core MVC Views and Controllers. 


Web Application 

A project template for creating an ASP.NET Core application with example ASP.NET Razor Pages content. 


Web Application (Model-Vievv-Controller) 


A project template for creating an ASP.NET Core application with example ASP.NET Core MVC Vievvs and 
Controllers. This template can also be used for RESTful HTTP Services. 


Authentication 

No Authentication 

Change 


Advanced 

0 Configuıe for HITPS 
□ Enable Docker Support 
(Reguires Docker Desktop) 


O 


Angular 

A project template for creating an ASP.NEI Core application with Angular 


React.js 


Author: Microsoft 
Source: .NFT Core 3.0.0 


Get additional project templates 


Back 


Create 


SignalR istemci kitaplığı ekleme 

SignalR sunucusu kitaplığı, ASP.NET Core 3,0 paylaşılan çerçevesine dahildir.JavaScript istemci kitaplığı projeye 
otomatik olarak dahil değildir. Bu öğreticide, istemci kitaplığını unpkg' den almak İçin kitaplık Yöneticisi 'N i 
(Libman) kullanacaksınız, unpkg, Node.js Paket Yöneticisi NPM 'de bulunan her şeyi teslim edebilen bir içerik 
teslim ağı (CDN)). 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Çözüm Gezgini, projeye sağ tıklayın ve > İstemci tarafı kitaplığı Ekle ' yi seçin. 

• İstemci tarafı kitaplığı Ekle İletişim kutusunda sağlayıcı için unpkgseçeneğini belirleyin. 

• Kitapllkiçin @microsoft/signalr@latest girin. 

• Belirli dosyaları seç' i seçin, dağ/Browser klasörünü genişletin ve SignalR. js ve SignalR. min.js' yi seçin. 

• Hedef konumu Wwwroot/js/SignalR/ olarak ayarlayın ve yüklemeyiseçin. 






















Add Client-Side Library 


Provider: 


Library: 


unpkg 


@microsoft/signalr@latest 


O Include ali library fileş 
(•) Choose specific fileş: 


X 


a ■ Fileş: 
a M dist 


"of 


browser 

J signalr.js | 


I | 2l signalr.js.map 

ig rj signalr.minjs 


Target Location: 


wwwroot/js/signalr 


Install 


Cancel 


LibMan, bir Wwwroot/js/SignalR klasörü oluşturur ve seçilen dosyaları buna kopyalar. 


SignalR hub 'ı oluşturma 

Hub , istemci-sunucu iletişimini işleyen yüksek düzeyli bir işlem hattı görevi gören bir sınıftır. 

• SignalRChat proje klasöründe bir hub klasörü oluşturun. 

• Hub 'lar klasöründe, aşağıdaki kodla bir ChatHub.es dosyası oluşturun: 

using Microsoft.AspNetCore.SignalR; 
using System.Threading.Tasks; 

namespace SignalRChat.Hubs 
{ 

public elass ChatHub : Hub 
{ 

public async Task SendMessage(string üşer, string message) 

{ 

await Clients.All.SendAsync("ReceiveMessage"j user, message); 

} 

} 

} 

ChatHub sınıfı SignalR Hub sınıfından devralır. Hub sınıfı bağlantıları, grupları ve mesajlaşmayı yönetir. 

sendMessage yöntemi, tüm istemcilere ileti göndermek için bağlı bir istemci tarafından çağrılabilir. Yöntemi 
çağıran JavaScript istemci kodu Öğreticinin ilerleyen kısımlarında gösterilmektedir. SignalR kod, en fazla 
ölçeklenebilirlik sağlamak için zaman uyumsuzdur. 


SignalR Yapılandır 

SignalR sunucusu, SignalRSİgnalR istekleri geçirilecek şekilde yapılandırılmalıdır. 


• Aşağıdaki Vurgulanan kodu Startup.es dosyasına ekleyin. 








































using System; 

using System.Collections.Generic; 

using System.Linq; 

using System.Threading.Tasks; 

using Microsoft.AspNetCore.Builder; 

using Microsoft.AspNetCore.Hoşting; 

using Microsoft.AspNetCore.HttpsPolicy; 

using Microsoft. Extensions.Configuration; 

using Microsoft. Extensions .Dependencylnjection; 

using Microsoft. Extensions .Hoşting; 

using SignalRChat.Hubs; 

namespace SignalRChat 

{ 

public class Startup 

{ 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

// This method gets called by the runtime. Use this method to add Services to the Container, 
public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRazorPages(); 

Services.AddSignalR(); 

} 

// This method gets called by the runtime. Use this method to configure the HTTP request 
pipeline. 

public void Configure(IApplicationBuilder app, IWebHostEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

// The default HSTS value is 30 days. You may want to change this for production 
scenarioSj see https://aka.ms/aspnetcore-hsts. 
app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 

app.UseRouting(); 

app.UseAuthorization(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapRazorPages(); 

endpoints.MapHub<ChatHub>("/chatHub"); 

}); 

} 

} 

} 


Bu değişiklikler, ASP.NET Core bağımlılığı ekleme ve yönlendirme sistemlerine SignalR ekler. 


SignalR istemci kodu ekle 



Pages\mdex.cshtml içindeki içeriği şu kodla değiştirin: 


@page 

<div class="container"> 

<div class="row">&nbsp;</div> 

<div class="row"> 

<div class="col-2">User</div> 

<div class="col-4"xinput type="text" id="userlnput" /></div> 
</div> 

<div class="row"> 

<div class="col-2">Message</div> 

<div class="col-4"xinput type="text" id="messagelnput" /x/div> 
</div> 

<div class="row">&nbsp;</div> 

<div class="row"> 

<div class="col-6"> 

<input type="button" id="sendButton" value="Send Message" /> 
</div> 

</div> 

</div> 

<div class="row"> 

<div class="col-12"> 

<hr /> 

</div> 

</div> 

<div class="row"> 

<div class="col-6"> 

<ul id="messagesList"x/ul> 

</div> 

</div> 

<script src="~/js/signalr/dist/browser/signalr. js"x/script> 

<script src="~/js/chat. js"x/script> 


Yukarıdaki kod: 

o Ad ve ileti metni ve Gönder düğmesi için metin kutuları oluşturur. 

o SignalR hub’ından alınan iletileri görüntülemek için id="messagesList" içeren bir liste oluşturur, 
o Bir sonraki adımda oluşturduğunuz SignalR ve sohbet, js uygulama koduna yönelik betik başvurularını 
içerir. 

Wwwroot/js klasöründe, aşağıdaki kodla bir chat.js dosyası oluşturun: 




"use strict"; 

var connection = new signalR.HubConnectionBuilder().withUrl("/chatHub").build(); 

//Disable send button until connection is established 
document.getElementById("sendButton").disabled = true; 

connection.on("ReceiveMessage"j function (user, message) { 

var msg = message.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"); 
var encodedMsg = user + " says " + msg; 
var li = document.createElement("li"); 
li.textContent = encodedMsg; 

document.getElementByld("messagesList").appendChild(li); 


connection.start().then(function () { 

document.getElementById("sendButton").disabled = false; 

}).catch(function (err) { 

return console.error(err.toString()); 

}); 

document.getElementById("sendButton").addEventListener("click", function (event) { 
var user = document.getElementById("userInput").value; 
var message = document.getElementById("messageInput").value; 
connection.invoke("SendMessage", user, message).catch(function (err) { 
return console.error(err.toStringO); 

}); 

event.preventDefault(); 


Yukarıdaki kod: 

o Bir bağlantı oluşturur ve başlatır. 

o , Hub 'a ileti gönderen bir işleyiciye Gönder düğmesine ekler. 

o , Hub 'dan iletileri alan ve bunları listeye ekleyen bir işleyici olan bağlantı nesnesine ekler. 

Uygulamayı çalıştırma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Uygulamayı hata ayıklamadan çalıştırmak için CTRL + F5 tuşlarına basın. 

• Adres çubuğundan URL 'yi kopyalayın, başka bir tarayıcı örneği veya sekme açın ve adres çubuğuna URL 
'Yİ yapıştırın. 

• Tarayıcı ' yı seçin, bir ad ve ileti girin ve İleti gönder düğmesini seçin. 

Ad ve ileti anında her iki sayfada da görüntülenir. 



| SignalRChat X 4* 

— n X 

| SignalRChat X 4- 

C A localhost:44378 'fr O : 

<- -» C ■ localhost:44378 ☆ 0 : 

SignalRChat 

SignalRChat 

User Hanna 

User Spencer 

Message Hi everyone! 

Message Got y 0ur message Hanna. 

Send Message 

Send Message 

• Hanna says Hi everyone! 

• Spencer says Got your 
message Hanna. 

• Hanna says Hi everyone! 

• Spencer says Got your 
message Hanna. 
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• Uygulama işe yaramazsa, tarayıcı geliştirici araçlarınızı (Fi 2) açın ve konsola gidin. HTML ve JavaScript kodunuzla 
ilgili hatalarla karşılaşabilirsiniz. Örneğin, SignalR.js ' yi yönlendirenden farklı bir klasöre yerleştirdiğinizi varsayalım. 
Bu durumda, bu dosyaya başvuru çalışmaz ve konsolunda 404 hatası görürsünüz. 


0 DevTools - !ocalhost:44378/ 


□ X 

[* (5H Elements Console Sources Netvvork Performance 

Memory Application 

Security Audits O 2 • 

[0 ® top ’ O Filter 

Default levels ▼ 

o 

O Failed to load resource: the server responded with a status of 

404 () 

aignalr,jaıl 

O Uncaught Referencetrror: signalR is not defined 
at chat»jâi3 


chat.is;3 

> 


• Chrome 'da hata ERR_SPDY_INADEQUATE_TFtANSPORT_SECURITY alırsanız, geliştirme sertifikanızı güncelleştirmek 
için şu komutları çalıştırın: 


dotnet 

dev-cents 

https 

--clean 

dotnet 

dev-cents 

https 

--trust 


Bu öğreticide SignalRkullanarak gerçek zamanlı bir uygulama oluşturmanın temelleri öğretilir.Aşağıdakileri nasıl 
yapacağınızı öğrenirsiniz: 

• Web projesi oluşturun. 

• SignalR istemci kitaplığı ekleyin. 

• SignalR hub'ı oluşturun. 

• Projeyi SignalRkullanacak şekilde yapılandırın. 

• Herhangi bir istemciden tüm bağlı istemcilere ileti gönderen kodu ekleyin. 

Sonunda, çalışan bir sohbet uygulamasına sahipsiniz: 






















□ X 


- SignalRChat 

C i Secure | https://loc... ☆ 


SignalRChat 


□ X 


- SignalRChat 


C 8 Secure | https://localho... ☆ 


— SignalRChat 


User... 

Joe 


Message... 

Hi everyone! 

Send Message 


User.... 

Nancy 


Message... 

Got your message, Joe 

Send Message 


Joe says Hi everyone! 

Nancy says Got your message, Joe 


Joe says Hl everyone! 

Nancy says Got your message, Joe 


©2018-SignalRChat 


©2018-SignalRChat 


Önkoşullar 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Visual Studio 2017 sürüm 15,9 veya üzeri ile ASP.N ET ve web geliştirme iş yükü. Kullanabileceğiniz Visual 
Studio 2019, ancak bazı proje oluşturma adımlarını öğreticide gösterilen öğesinden farklı. 

• .NET core SDK 2.2 veya üzeri 


VVARNING 

Visual Studio 2017 kullanıyorsanız bkz dotnet/SDK'sı sorun #3124 Visual Studio ile çalışmayan .NET Core SDK sürümleri 
hakkında bilgi için. 


Birvveb projesi oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Menüden dosya > yeni proje 1 yi seçin. 

• Yeni proje iletişim kutusunda, yüklü > Visual C# > Web > ASP.NET Core Web uygulaması' nı seçin. 
Projeyi Signalrchato\arak adlandırın. 


































New Project 


X 


t> Recent 
A Installed 
A VisualC# 

Windows Classic Desktop 



Previous Vers'ıons 
.NET Core 
.NET Standard 
Cloud 
Test 
WCF 

t Visual Basic 
t- Visual F# 

SQL Server 
Azure Data Lake 
t 1 JavaScript 
t- Stream Analytks 
t- TypeScript 
t* Other Project Types 


Şort by: D efault 


Search (Ctrl* E) 


fi * 


ASP.NET Core Web Application 


ASP.NET Web Application (.NET Framework) 


Visual C# 


Visual C# 


Type: VisualC# 

Project templates for creating ASP.NET 
Core applications for Windows. Linux and 
macOS using .NET Core or .NET 
Frameworlc Create Razor Pages. MVC. 
Web API. and Single Page (SPA) 
Applications. 


Not finding what you are looking for? 


Öpen Visual Studio Installer 


Name: 

SignalRChat] 

Location: 

C:\Users\Rachef\source\repos 

^ | Browse... 

Solution: 

Create new solution 

ıl 

Solution name: 

SignalRChat 

0 Create directory for solution 


O Add to Source Control 


E2EH ^ ance * 


• Razor Pages kullanan bir proje oluşturmak için Web uygulaması 1 nı seçin. 

• .N ET Core'un hedef çerçevesini seçin, ASP.N ET Core 2 , 2 ' i seçin ve Tamam 1 ı tıklatın. 


New ASP.NET Core Web Application - SignalRChat 


? 


X 


| .NEÎ Core 

- ASP.NET Core 2.2 

v I Learn more 



n 

Esi 



m 

Empty 

API 

Web 

Application 

Web 

Application 

(Model-View- 

Controller) 

Razor Class 
Library 

0 





Angular 

React.js 

Reactjs and 
Redux 




A project template for creating an ASP.NET Core 
application with example ASP.NET Core Razor Pages 
content. 

Learn more 


Author: Microsoft 

Source: SDK 2.2.100-preview3-009430 


Get additional project templates Authentication: No Authentİcation 


I I £nable Docker Support (Reguires Docker for Wındows) 


OS: Windows 


Change Authentication 


0 Çonfigure for HTTPS 


OK 

Cancel 




SignalR istemci kitaplığı ekleme 

SignalR sunucusu kitaplığı, Microsoft.AspNetcore.App metapackage 'e dahildir. JavaScript istemci kitaplığı 
projeye otomatik olarak dahil değildir. Bu öğreticide, istemci kitaplığını unpkg 'den almak İçin kitaplık Yöneticisi 
1 Ni (Libman) kullanacaksınız, unpkg, Node.js Paket Yöneticisi NPM 'de bulunan her şeyi teslim edebilen bir içerik 
teslim ağı (CDN)). 


















































• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 


• Çözüm Gezgini, projeye sağ tıklayın ve > İstemci tarafı kitaplığı Ekle 1 yi seçin. 

• İstemci tarafı kitaplığı Ekle İletişim kutusunda sağlayıcı için unpkgseçeneğini belirleyin. 

• Kitaplıkiçin @microsoft/signair@s girin ve Önizleme olmayan en son sürümü seçin. 


Add Client-Side Library 


X 


Providen 


Library: 


unpkg w 


©aspnet/signalr®l| | 


O Include ali library fileş 
® Choose specific fileş: 


□ M Fileş: 


©aspnet/signalr@1.0.0 
©aspnet/signalr@1.0.2 
_ [ ©aspnet/signalr@1.0.3 | 

@aspnet/signalr@1.1.0-preview1 -35029 


Target Location: wwwroot/lib/signalr/ 


Install 


Cancel 


• Belirli dosyaları seç' i seçin, dağ/Browser klasörünü genişletin ve SignalR.js ve SignalR. min.js' yi seçin. 


• Hedef konumu Wwwroot/lib/SignaIR/ olarak ayarlayın ve yüklemeyiseçin. 


Add Client-Side Library 


X 


Providen unpkg 

Library: ©aspnet/signalr© 1.0.3 

O Include ali library fileş 


® Choose specific fileş: 




LibMan, bir Wwwroot/LIB/SignalR klasörü oluşturur ve seçilen dosyaları buna kopyalar. 


SignalR hub 'ı oluşturma 























































Hub , istemci-sunucu iletişimini işleyen yüksek düzeyli bir işlem hattı görevi gören bir sınıftır. 

• SignalRChat proje klasöründe bir hub klasörü oluşturun. 

• Hub 'lar klasöründe, aşağıdaki kodla bir ChatHub.es dosyası oluşturun: 

using Microsoft.AspNetCore.SignalR; 
using System.Threading.Tasks; 

namespace SignalRChat.Hubs 
{ 

public elass ChatHub : Hub 
{ 

public async Task SendMessage(string user, string message) 

{ 

await Clients.All.SendAsync("ReceiveMessage", user, message); 

} 

} 

} 

ChatHub sınıfı SignalR Hub sınıfından devralır. Hub sınıfı bağlantıları, grupları ve mesajlaşmayı yönetir. 

sendMessage yöntemi, tüm istemcilere ileti göndermek için bağlı bir istemci tarafından çağrılabilir. Yöntemi 
çağıran JavaScript istemci kodu Öğreticinin ilerleyen kısımlarında gösterilmektedir. SignalR kod, en fazla 
ölçeklenebilirlik sağlamak için zaman uyumsuzdur. 

SignalR Yapılandır 

SignalR sunucusu, SignalRSİgnalR istekleri geçirilecek şekilde yapılandırılmalıdır. 

• Aşağıdaki Vurgulanan kodu Startup.es dosyasına ekleyin. 





using Microsoft.AspNetCore.Builder; 

using Microsoft.AspNetCore.Hoşting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft. Extensions .Configuration; 

using Microsoft. Extensions .Dependencylnjection; 

using SignalRChat.Hubs; 

namespace SignalRChat 

{ 

public class Startup 

{ 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

// This method gets called by the runtime. Use this method to add Services to the Container, 
public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

// This lambda determines whether user consent for non-essential cookies is needed for 

a given request. 

options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 


Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_l); 

Services .AddSignalR(); 

} 

// This method gets called by the runtime. Use this method to configure the HTTP request 
pipeline. 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 
app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 
app.UseCookiePolicy(); 
app.UseSignalR(routes => 

{ 

routes.MapHub<ChatHub>("/chatHub"); 

}); 

app.UseMvc(); 

} 

} 

} 


Bu değişiklikler, ASP.NET Core bağımlılık ekleme sistemine ve ara yazılım ardışık düzenine SignalR ekler. 


SignalR istemci kodu ekle 



• Pages\mdex.cshtml içindeki içeriği şu kodla değiştirin: 


@page 

<div class="container"> 

<div class="row">&nbsp;</div> 

<div class="row"> 

<div class="col-6">&nbsp;</div> 

<div class="col-6"> 

User.«cinput type="text" id="userlnput" /> 

<br /> 

Message. . .«cinput type="text" id="messagelnput" /> 
cinput type="button" id="sendButton" value="Send Message" /> 
</div> 

</div> 

<div class="row"> 

<div class="col-12"> 

<hr /> 

</div> 

</div> 

<div class="row"> 

<div class="col-6">&nbsp;</div> 

<div class="col-6"> 

<ul id="messagesList"x/ul> 

</div> 

</div> 

</div> 

<script src="~/lib/signalr/dist/browser/signalr.js"x/script> 

<script src="~/js/chat. js"x/script> 


Yukarıdaki kod: 

o Ad ve ileti metni ve Gönder düğmesi için metin kutuları oluşturur. 

o SignalR hub'ından alınan iletileri görüntülemek için id="messagesList" içeren bir liste oluşturur, 
o Bir sonraki adımda oluşturduğunuz SignalR ve sohbet, js uygulama koduna yönelik betik başvurularını 
içerir. 

• Wwwroot/js klasöründe, aşağıdaki kodla bir chat.js dosyası oluşturun: 





"use strict"; 

var connection = new signalR.HubConnectionBuilder().withUrl("/chatHub").build(); 

//Disable send button until connection is established 
document.getElementById("sendButton").disabled = true; 

connection.on("ReceiveMessage"j function (user, message) { 

var msg = message.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"); 
var encodedMsg = user + " says " + msg; 
var li = document.createElement("li"); 
li.textContent = encodedMsg; 

document.getElementByld("messagesList").appendChild(li); 


connection.start().then(function(){ 

document.getElementById("sendButton").disabled = false; 

}).catch(function (err) { 

return console.error(err.toString()); 

}); 

document.getElementById("sendButton").addEventListener("click", function (event) { 
var user = document.getElementById("userInput").value; 
var message = document.getElementById("messageInput").value; 
connection.invoke("SendMessage", user, message).catch(function (err) { 
return console.error(err.toStringO); 

}); 

event.preventDefault(); 


Yukarıdaki kod: 

o Bir bağlantı oluşturur ve başlatır. 

o , Hub 'a ileti gönderen bir işleyiciye Gönder düğmesine ekler. 

o , Hub 'dan iletileri alan ve bunları listeye ekleyen bir işleyici olan bağlantı nesnesine ekler. 

Uygulamayı çalıştırma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Uygulamayı hata ayıklamadan çalıştırmak için CTRL + F5 tuşlarına basın. 

• Adres çubuğundan URL 'yi kopyalayın, başka bir tarayıcı örneği veya sekme açın ve adres çubuğuna URL 
'Yİ yapıştırın. 

• Tarayıcı ' yı seçin, bir ad ve ileti girin ve İleti gönder düğmesini seçin. 

Ad ve ileti anında her iki sayfada da görüntülenir. 
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• Joe says Hi everyone! 

• Nancy says Got your message, Joe 
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• Joe says Hi everyone! 

• Nancy says Got your message, Joe 


© 2018 - SignalRChat 


TIP 

Uygulama işe yaramazsa, tarayıcı geliştirici araçlarınızı (Fi2) açın ve konsola gidin. HTML ve JavaScript kodunuzla ilgili 
hatalarla karşılaşabilirsiniz. Örneğin, SignalR.js ' yi yönlendirenden farklı bir klasöre yerleştirdiğinizi varsayalım. Bu durumda, 
bu dosyaya başvuru çalışmaz ve konsolunda 404 hatası görürsünüz. 



Ek kaynaklar 


• Bu öğreticinin YouTube sürümü 















































TypeScript ve VVebPack ile ASPNET Core SignalR 
kullanma 

26.11.2019 * 34 minutes to read ı Edit Online 


, Sebastien Sougnez ve Scott Ade tarafından 

VVebPack , geliştiricilerin bir VVeb uygulamasının istemci tarafı kaynaklarını paketleyip oluşturmalarına olanak 
sağlar. Bu öğretici, istemcisinin TypeScript'te yazıldığı bir ASP.NET Core SignalR VVeb uygulamasında VVebPack 'in 
kullanımını gösterir. 

Bu öğreticide şunların nasıl yapıldığını öğreneceksiniz: 

• Bir başlatıcı ASP.NET Core SignalR uygulama için yapı iskelesi 

• SignalR TypeScript istemcisini yapılandırma 

• VVebPack kullanarak derleme işlem hattı yapılandırma 

• SignalR sunucusunu yapılandırma 

• istemci ve sunucu arasındaki iletişimi etkinleştir 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Önkoşullar 

• Visual Studio 

• Visual Studio Code 

• ASP.net ve VVeb geliştirme iş yüküyle Visual Studio 2019 

• .NET Core SDK 3,0 veya üzeri 

• NPM ile Node.js 

ASP.NET Core VVeb uygulaması oluşturma 

• Visual Studio 

• Visual Studio Code 

Visual Studio 'Yu, Path ortam değişkeninde NPM için arama yapmak üzere yapılandırın. Varsayılan olarak, Visual 
Studio yükleme dizininde bulunan NPM sürümünü kullanır. Visual Studio 'da şu yönergeleri izleyin: 

1. VVeb Paket Yönetimi > dış web araçları > > > Araçlar ve Seçenekler 1 e gidin. 

2. Listeden $ (yol) girişini seçin. Girdiyi listedeki ikinci konuma taşımak için yukarı oka tıklayın. 
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Locations of external tools: 




1^1 .\node_m odules\.bin 

|Bs(path)| 

0 S(VSINSTALLDIR)\Web\External 
0S(DevEnvDir)\CommonExtensions\Microsoft\TeamFoundation\Team Explorer\Git\ 
0S(DevEnvDiıj\CommonExtensions\Microsoft\TeamFoundation\Team Explorer\Git\ 
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Reset to Defaults 


The paths listed above will be searched vvhen Visual Studio uses Srd-party tools such as 
Grunt, Gulp, Bower, or npm. 


OK 


Cancel 


Visual Studio yapılandırması tamamlandı. Projeyi oluşturma zamanı. 

1 . Dosya > Yeni > projesi menü seçeneğini kullanın ve ASP.N ET Core Web uygulaması şablonunu seçin. 

2. Projeyi Sigrıalrwebpacko\arak adlandırın ve Oluştur' u seçin. 

3. Hedef çerçeve açılır listesinden .NET Core ' u seçin ve çerçeve Seçicisi açılır listesinden ASP.NET Core 3,0 ' ı 
seçin. Boş şablonu seçin ve Oluştur' u seçin. 

VVebPack ve TypeScript yapılandırma 

Aşağıdaki adımlar, TypeScript 'in JavaScript 'e dönüştürülmesini ve istemci tarafı kaynaklarını paketlemeyi 
yapılandırır. 


1. Bir Package. JSON dosyası oluşturmak için proje kökünde aşağıdaki komutu yürütün: 



"name": "SignalRWebPack", 

"version": "1.0.0", 

"pnivate": tnue, 

"description": 

"main": "index.js", 

"scripts": { 

"test": "echo Y'Error: no test specified\" && exit 1" 

}, 

"keywords": [], 

"author": 

"license": "ISC" 

} 

private özelliğinin true olarak ayarlanması, sonraki adımda paket yükleme uyarılarını önler. 
3. Gerekli NPM paketlerini yükler.Proje kökünden aşağıdaki komutu yürütün: 































npm install -D -E clean-webpack-plugin@1.0.1 css-loader@2.1.0 html-webpack-plugin@4.0.0-beta.5 mini-css- 
extract-plugin@0.5.0 ts-loader@5.3.3 typescript@3.3.3 webpack@4.29.3 webpack-cli@3.2.3 

Aklınızda bazı komut ayrıntıları: 

• Sürüm numarası, her paket adı için @ işaretini izler. NPM bu özel paket sürümlerini yüklüyor. 

• -e seçeneği, NPM 'nin semantik sürüm aralığı işleçlerini Package. VSOA/öğesine yazmanın varsayılan 
davranışını devre dışı bırakır. Örneğin, "webpack": " A 4.29.3" yerine "webpack": "4.29.3" kullanılır. Bu 
seçenek, daha yeni paket sürümlerine istenmeden yükseltme yapılmasını engeller. 

Daha ayrıntılı bilgi için resmi NPM-Install docs bölümüne bakın. 

4. Package. JSON dosyasının scripts özelliğini aşağıdaki kod parçacığıyla değiştirin: 

"scripts": { 

"build": "webpack --mode=development --watch", 

"release": "webpack --mode=production", 

"publish": "npm run release && dotnet publish -c Release" 

L 

Betiklerin bazı açıklamaları: 

• build : istemci tarafı kaynaklarınızı geliştirme modunda paketler ve dosya değişikliklerini izler. Dosya 
izleyici, bir proje dosyası her değiştiğinde paketin yeniden oluşturulmasına neden olur, mode seçeneği, 
Tree gerçekleşmesi ve minbirleşme gibi üretim iyileştirmeleri devre dışı bırakır. Yalnızca geliştirmede 

build kullanın. 

• release : istemci tarafı kaynaklarınızı üretim modunda Paketlayın. 

• publish : release betiği, istemci tarafı kaynaklarını üretim modunda paketleyip çalıştırır. Uygulamayı 
yayımlamak için .NET Core CLI Publish komutunu çağırır. 

5. Aşağıdaki içeriğe sahip proje kökünde WebPack. config.jsadU bir dosya oluşturun: 









const path = require("path"); 

const HtmlWebpackPlugin = require("html-webpack-plugin"); 
const Cleanl/JebpackPlugin = require("clean-webpack-plugin"); 
const MiniCssExtractPlugin = require("mini-css-extract-plugin"); 

modüle.exports = { 

entry: "./src/index.ts ", 
output: { 

path: path.resolve(_dirname, "wwwroot"), 

filename: "[name].[chunkhash].js", 
publicPath: "/" 

}, 

resolve: { 

extensions: [".js", ".ts"] 

L 

modüle: { 
rules: [ 

{ 

test: /\.ts $/, 
use: "ts-loader" 

L 

{ 

test: /\.css$/, 

use: [MiniCssExtractPlugin.loader, "css-loader"] 

} 

] 

}, 

plugins: [ 

new Cleanl/JebpackPlugin (["wwwroot/*" ]), 
new HtmlWebpackPlugin({ 

template: "./src/index.html" 

}), 

new MiniCssExtnactPlugin({ 

filename: "css/[name].[chunkhash].css" 

}) 

] 

}; 


Yukarıdaki dosya Web paketi derlemesini yapılandırır. Aklınızda bazı yapılandırma ayrıntıları: 

• output özelliği, dağ 'ın varsayılan değerini geçersiz kılar. Paket, Wwwroot dizininde yayınlanı 

• resolve.extensions dizisi, SignalR istemci JavaScript 'ı içeri aktarmak için .js içerir. 

6. Proje kökünde yeni bir src dizini oluşturun. Amaç, projenin istemci tarafı varlıklarını depolardır. 

7. Aşağıdaki içerikle src/index.html oluşturun. 

<!DOCTYPE html> 

<html> 

<head> 

«cmeta charset="utf-8" /> 

<title>ASP.NET Core SignalR</title> 

</head> 

<body> 

<div id="divMessages" class="messages"> 

</div> 

<div class="input-zone"> 

<label id="lblMessage" for="tbMessage">Message:</label> 

<input id="tbMessage" class="input-zone-input" type="text" /> 
cbutton id="btnSend">Send</button> 

</div> 

</body> 

</html> 




Önceki HTML, giriş sayfasının ortak işaretlemesini tanımlar. 

8. Yeni bir src/CSS dizini oluşturun. Amacı, projenin . css dosyalarını depolamadır. 

9. Aşağıdaki içerikle src/CSS/Main. css oluşturun: 

*, *::before, *::after { 
box-sizing: border-box; 

} 

html, body { 
margin: 0; 
padding: 0; 

} 

.input-zone { 

align-items: çenter; 
display: flex; 
flex-direction: row; 
margin: 10px; 

} 

.input-zone-input { 
flex: 1; 

margin-right: 10px; 

} 

.message-author { 

font-weight: bold; 

} 

.messages { 

border: lpx solid #000; 
margin: 10px; 
max-height: 300px; 
min-height: 300px; 
overflow-y: auto; 
padding: 5px; 

} 

Önceki Mairı. css dosyası uygulamayı stiller. 

10. Şu içerikle src/tsconfig. JSON oluşturun: 

{ 

"compilerOptions": { 

"target": "es5" 

} 

} 


Yukarıdaki kod, TypeScript derleyicisini ECMAScript 5 uyumlu JavaScript üretecek şekilde yapılandırır. 


11. Aşağıdaki içeriğe sahip src/index. TS oluşturun: 




import "./css/main.css"; 

const divMessages: HTMLDivElement = document.querySelector("#divMessages"); 
const tbMessage: HTMLInputElement = document.querySelector("#tbMessage"); 
const btnSend: HTMLButtonElement = document.querySelector("#btnSend"); 
const username = new Date(),getTime(); 

tbMessage.addEventListener("keyup", (e: KeyboandEvent) => { 
if (e.keyCode === 13) { 
send(); 

} 

}); 

btnSend.addEventListener("click ", send); 

function send() { 

} 

Önceki TypeScript, DOM öğelerine başvurulan alır ve iki olay işleyicisini ekler: 

• keyup : Bu olay Kullanıcı metin kutusuna tbMessage olarak tanımlanan bir şeyi yazdığında ateşlenir, 
send işlevi, Kullanıcı ENTER tuşuna bastığında çağrılır. 

• click : Kullanıcı Gönder düğmesine tıkladığında bu olay ateşlenir, send işlevi çağırılır. 

ASP.NET Core uygulamasını yapılandırma 

1. startup.configure yönteminde, Usedefaultfiles ve usestaticfilesöğesine çağrılar ekleyin. 

app. UseRoutingO; 
app.UseDefault Fileş Q; 
app.UseStaticFiles(); 


Yukarıdaki kod, kullanıcının tam URL 'sini veya Web uygulamasının kök URL 'sini girmeksizin Dizin, html 
dosyasını bulmasını ve sunmasını sağlar. 

2. startup.configure yönteminin sonunda, bir /hub yolunu chatHub hub 'ma eşleyin. Merhaba Dünya 
görüntülenen kodu değiştirin ! Aşağıdaki satırla: 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapHub<ChatHub>("/hub"); 

})J 

3. startup.configureServices yönteminde Addsignalröğesini çağırın. SignalR hizmetlerini projenize ekler. 

Services.AddSignalR(); 


4. Proje kökünde hub olarak adlandırılan yeni bir dizin oluşturun. Amacı, bir sonraki adımda oluşturulan 
SignalR hub 'ını deposağlamaktır. 

5. Aşağıdaki kodla hub hub 'lan/ChatHub. cs oluşturun: 






using Microsoft.AspNetCore.SignalR; 
using System.Threading.Tasks; 

namespace SignalRI/JebPack.Hubs 
{ 

public class ChatHub : Hub 
{ 

} 


6. ChatHub başvurusunu çözümlemek için, Startup.es dosyasının en üstüne aşağıdaki kodu ekleyin: 

using SignalRI/JebPack.Hubs; 


İstemci ve sunucu iletişimini etkinleştir 

Uygulama Şu anda ileti göndermek için basit bir form görüntülüyor. Bunu yapmayı denediğinizde hiçbir şey olmaz. 
Sunucu belirli bir yolu dinliyor, ancak gönderilen iletilerle hiçbir şey yapmıyor. 

1. Proje kökünde aşağıdaki komutu yürütün: 

npm install @microsoft/signalr 

Yukarıdaki komut, istemcinin sunucuya ileti göndermesini sağlayan SignalR TypeScript istemcisiniyüklüyor. 

2. Vurgulanan kodu src/index. TS dosyasına ekleyin: 





import "./css/main.css"; 

impont * as signalR from "@microsoft/signalr"; 

const divMessages: HTMLDivElement = document.querySelector("#divMessages"); 
const tbMessage: HTMLInputElement = document.querySelector("#tbMessage"); 
const btnSend: HTMLButtonElement = document.querySelector("#btnSend")j 
const username = new Date(),getTime(); 

const connection = new signalR.HubConnectionBuilder() 

.withllrl("/hub") 

.build(); 

connection.on("messageReceived", (username: string, message: string) => { 
let m = document.createElement("div"); 

m.innerHTML = 

' <div class="message-author">${username}</divxdiv>${message}</div>'; 
divMessages.appendChild(m); 

divMessages.scrollTop = divMessages.scrollHeight; 

}); 

connection.start().catch(err => document.write(err)); 

tbMessage.addEventListener("keyup", (e: KeyboardEvent) => { 
if (e.keyCode === 13) { 
send(); 

} 

})J 

btnSend.addEventListener("click ", send); 

function send() { 

} 

Yukarıdaki kod, sunucudan ileti almayı destekler. HubConnectionBuiider sınıfı, sunucu bağlantısını 
yapılandırmak için yeni bir Oluşturucu oluşturur. withuri işlevi hub URL 'sini yapılandırır. 

SignalR, istemci ile sunucu arasında ileti alışverişi yapılmasını mümkün. Her ileti belirli bir ada sahiptir. 
Örneğin, ileti bölgesindeki yeni iletiyi görüntülemekten sorumlu mantığı çalıştıran messageReceived adına 
sahip iletilere sahip olabilirsiniz. Belirli bir iletiyi dinlemek on işlevi aracılığıyla yapılabilir. Herhangi bir 
sayıda ileti adını dinleyebilmeniz gerekir. Ayrıca, yazarın adı ve alınan iletinin içeriği gibi parametreleri iletiye 
geçirmek da mümkündür, istemci bir ileti aldıktan sonra yazarın adı ve innermm özniteliğinde ileti 
içeriğiyle yeni bir div öğesi oluşturulur. Bu, iletileri görüntüleyen ana div öğesine eklenir. 

3. Artık istemci bir ileti aldığına göre, ileti gönderecek şekilde yapılandırın. Vurgulanan kodu src/index. TS 
dosyasına ekleyin: 









import "./css/main.css"; 

import * as signalR from "@aspnet/signalr"; 

const divMessages: HTMLDivElement = document.querySelector("#divMessages"); 
const tbMessage: HTMLInputElement = document.querySelector("#tbMessage"); 
const btnSend: HTMLButtonElement = document.querySelector("#btnSend"); 
const username = new Date(),getTime(); 

const connection = new signalR.HubConnectionBuilden() 

.withUrl("/hub") 

.build(); 

connection.on("messageReceived", (username: string, message: string) => { 
let messageContainer = document.createElement("div"); 

messageContainer.innerHTML = 

' <div class="message-author">${username}</divxdiv>${message}</div>'; 

divMessages.appendChild(messageContainer); 
divMessages.scrollTop = divMessages.scrollHeight; 

}); 

connection.start().catch(err => document.write(err)); 

tbMessage.addEventListener("keyup", (e: KeyboardEvent) => { 
if (e.keyCode === 13) { 
send(); 

} 

})J 

btnSend.addEventListener("click", send); 


function send() { 

connection.send("newMessage", username, tbMessage.value) 
.then(() => tbMessage.value = ""); 


} 


VVebSockets bağlantısı aracılığıyla bir ileti gönderildiğinde send yönteminin çağrılması gerekir. Yöntemin ilk 
parametresi ileti adıdır. İleti verileri diğer parametreleri geçersiz kılar.Bu örnekte, newMessage sunucusuna 
gönderildiği gibi bir ileti gönderilir, ileti, bir metin kutusundan Kullanıcı adından ve Kullanıcı girişinden 
oluşur. Gönderme işlemi çalışırsa metin kutusu değeri temizlenir. 


4. Vurgulanan yöntemi chatHub sınıfına ekleyin: 

using Microsoft.AspNetCore.SignalR; 
using System.Threading.Tasks; 

namespace SignalRUebPack.Hubs 

{ 

public class ChatHub : Hub 

{ 

public async Task NewMessage(long username, string message) 

{ 

await Clients.All.SendAsync("messageReceived", username, message); 

} 

} 


Yukarıdaki kod, sunucu onları aldıktan sonra tüm bağlı kullanıcılara ileti almış iletileri yayınlar.Tüm iletileri 
almak için genel bir on yöntemi olması gereksizdir. İleti adından sonra adlandırılmış bir yöntem. 

Bu örnekte, TypeScript istemcisi newMessage olarak tanımlanan bir ileti gönderir. C# NewMessage yöntemi, 
istemci tarafından gönderilen verileri bekler. İstemcilerdeki sendadsync yöntemine bir çağrı yapılır. Alınan 










iletiler, hub 'a bağlı tüm istemcilere gönderilir. 


Uygulamayı test etme 

Uygulamanın aşağıdaki adımlarla çalıştığından emin olun. 

• Visual Studio 

• Visual Studio Code 

1. Web paketini yayın modunda çalıştırın. Paket Yöneticisi konsol penceresini kullanarak, proje kökünde 
aşağıdaki komutu yürütün. Proje kökünde değilseniz, komutu girmeden önce cd signaiRWebPack girin. 

npm run release 

Bu komut, uygulamayı çalıştırırken alınacağı istemci-tarafı varlıkları verir.Varlıkları yerleştirilir wwwroot 
klasör. 

Web, aşağıdaki görevleri tamamlandı: 

• içeriğini temizleneceği wwwroot dizin. 

• JavaScript için TypeScript dönüştürülen—olarak da bilinen bir işlem transpilation. 

• Dosya boyutunu küçültmek için oluşturulan JavaScript karıştırılmış—olarak da bilinen bir işlem 
küçültme. 

• işlenen JavaScript, CSS ve HTML dosyalarından kopyalanan src için vzvzvzroot dizin. 

• Aşağıdaki öğeleri içine eklenen wwwroot/index.html dosyası: 

o A <ünk> başvuran etiketi wwwroot/ma'ın.< karma>.css dosya. Bu etiket kapatılmadan hemen 
önce yerleştirilir </head> etiketi. 

o A <script> küçültülmüş başvuran etiketi wwwroot/main.< karma>.js dosya. Bu etiket 
kapatılmadan hemen önce yerleştirilir </body> etiketi. 

2. Hata ayıklayıcıyı eklemeden uygulamayı bir tarayıcıda başlatmak **için hata ayıklama > ** Başlat 1 ı seçin. 
WwwrootAndex.html dosyası http://iocaihost:<port_number> olarak sunulur. 

Derleme hataları alırsanız, çözümü kapatıp yeniden açmayı deneyin. 

3. Başka bir tarayıcı örneği (herhangi bir tarayıcı) açın. URL 'Yİ adres çubuğuna yapıştırın. 

4. Tarayıcı seçin, ileti metin kutusuna bir şey yazın ve Gönder düğmesine tıklayın. Benzersiz Kullanıcı adı ve 
ileti anında her iki sayfada da görüntülenir. 
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• Visual Studio 

• Visual Studio Code 


• ASP.net ve Web geliştirme iş yüküyle Visual Studio 2019 

• .NET Core SDK 2,2 veya üzeri 

• N PM ile Node. js 


ASP.NET Core Web uygulaması oluşturma 

• Visual Studio 

• Visual Studio Code 

Visual Studio 'Yu, Path ortam değişkeninde NPM için arama yapmak üzere yapılandırın. Varsayılan olarak, Visual 
Studio yükleme dizininde bulunan NPM sürümünü kullanır. Visual Studio 'da şu yönergeleri izleyin: 

1 . Web Paket Yönetimi > dış web araçları > > > Araçlar ve Seçenekler ' e gidin. 

2. Listeden $ (yol) girişini seçin. Girdiyi listedeki ikinci konuma taşımak için yukarı oka tıklayın. 
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Web Projects 

> Source Control 

> Work Items 

> Text Editör 

> Debugging 

> IntelliTrace 


Locations of external tools: 




1^1 .\node_m odules\.bin 

|Bs(path)| 

0 S(VSINSTALLDIR)\Web\External 
0S(DevEnvDir)\CommonExtensions\Microsoft\TeamFoundation\Team Explorer\Git\ 
0S(DevEnvDiıj\CommonExtensions\Microsoft\TeamFoundation\Team Explorer\Git\ 


■ 


Reset to Defaults 


The paths listed above will be searched vvhen Visual Studio uses Srd-party tools such as 
Grunt, Gulp, Bower, or npm. 


OK 


Cancel 


Visual Studio yapılandırması tamamlandı. Projeyi oluşturma zamanı. 

1 . Dosya > Yeni > projesi menü seçeneğini kullanın ve ASP.N ET Core Web uygulaması şablonunu seçin. 

2. Projeyi Sigrıalrwebpacko\arak adlandırın ve Oluştur' u seçin. 

3. Hedef çerçeve açılır listesinden .NET Core ' u seçin ve çerçeve Seçicisi açılır listesinden ASP.NET Core 2,2 ' ı 
seçin. Boş şablonu seçin ve Oluştur' u seçin. 

VVebPack ve TypeScript yapılandırma 

Aşağıdaki adımlar, TypeScript 'in JavaScript 'e dönüştürülmesini ve istemci tarafı kaynaklarını paketlemeyi 
yapılandırır. 


1. Bir Package. JSON dosyası oluşturmak için proje kökünde aşağıdaki komutu yürütün: 



"name": "SignalRWebPack ", 

"version": "1.0.0", 

"pnivate": tnue, 

"description": 

"main": "index.js", 

"scripts": { 

"test": "echo Y'Error: no test specified\" && exit 1" 

}, 

"keywords": [], 

"author": 

"license": "ISC" 

} 

private özelliğinin true olarak ayarlanması, sonraki adımda paket yükleme uyarılarını önler. 
3. Gerekli NPM paketlerini yükler.Proje kökünden aşağıdaki komutu yürütün: 































npm install -D -E clean-webpack-plugin@1.0.1 css-loader@2.1.0 html-webpack-plugin@4.0.0-beta.5 mini-css- 
extract-plugin@0.5.0 ts-loader@5.3.3 typescript@3.3.3 webpack@4.29.3 webpack-cli@3.2.3 

Aklınızda bazı komut ayrıntıları: 

• Sürüm numarası, her paket adı için @ işaretini izler. NPM bu özel paket sürümlerini yüklüyor. 

• -e seçeneği, NPM 'nin semantik sürüm aralığı işleçlerini Package. VSOA/öğesine yazmanın varsayılan 
davranışını devre dışı bırakır. Örneğin, "webpack": " A 4.29.3" yerine "webpack": "4.29.3" kullanılır. Bu 
seçenek, daha yeni paket sürümlerine istenmeden yükseltme yapılmasını engeller. 

Daha ayrıntılı bilgi için resmi NPM-Install docs bölümüne bakın. 

4. Package. JSON dosyasının scripts özelliğini aşağıdaki kod parçacığıyla değiştirin: 

"scripts": { 

"build": "webpack --mode=development --watch", 

"release": "webpack --mode=production", 

"publish": "npm run release && dotnet publish -c Release" 

L 

Betiklerin bazı açıklamaları: 

• build : istemci tarafı kaynaklarınızı geliştirme modunda paketler ve dosya değişikliklerini izler. Dosya 
izleyici, bir proje dosyası her değiştiğinde paketin yeniden oluşturulmasına neden olur, mode seçeneği, 
Tree gerçekleşmesi ve minbirleşme gibi üretim iyileştirmeleri devre dışı bırakır. Yalnızca geliştirmede 

build kullanın. 

• release : istemci tarafı kaynaklarınızı üretim modunda Paketlayın. 

• publish : release betiği, istemci tarafı kaynaklarını üretim modunda paketleyip çalıştırır. Uygulamayı 
yayımlamak için .NET Core CLI Publish komutunu çağırır. 

5. Aşağıdaki içeriğe sahip proje kökünde WebPack. config.jsadU bir dosya oluşturun: 









const path = require("path"); 

const HtmlWebpackPlugin = require("html-webpack-plugin"); 
const Cleanl/JebpackPlugin = require("clean-webpack-plugin"); 
const MiniCssExtractPlugin = require("mini-css-extract-plugin"); 

modüle.exports = { 

entry: "./src/index.ts ", 
output: { 

path: path.resolve(_dirname, "wwwroot"), 

filename: "[name].[chunkhash].js", 
publicPath: "/" 

}, 

resolve: { 

extensions: [".js", ".ts"] 

L 

modüle: { 
rules: [ 

{ 

test: /\.ts $/, 
use: "ts-loader" 

L 

{ 

test: /\.css$/, 

use: [MiniCssExtractPlugin.loader, "css-loader"] 

} 

] 

}, 

plugins: [ 

new Cleanl/JebpackPlugin (["wwwroot/*" ]), 
new HtmlWebpackPlugin({ 

template: "./src/index.html" 

}), 

new MiniCssExtnactPlugin({ 

filename: "css/[name].[chunkhash].css" 

}) 

] 

}; 


Yukarıdaki dosya Web paketi derlemesini yapılandırır. Aklınızda bazı yapılandırma ayrıntıları: 

• output özelliği, dağ 'ın varsayılan değerini geçersiz kılar. Paket, Wwwroot dizininde yayınlanı 

• resolve.extensions dizisi, SignalR istemci JavaScript 'ı içeri aktarmak için .js içerir. 

6. Proje kökünde yeni bir src dizini oluşturun. Amaç, projenin istemci tarafı varlıklarını depolardır. 

7. Aşağıdaki içerikle src/index.html oluşturun. 

<!DOCTYPE html> 

<html> 

<head> 

«cmeta charset="utf-8" /> 

<title>ASP.NET Core SignalR</title> 

</head> 

<body> 

<div id="divMessages" class="messages"> 

</div> 

<div class="input-zone"> 

<label id="lblMessage" for="tbMessage">Message:</label> 

<input id="tbMessage" class="input-zone-input" type="text" /> 
cbutton id="btnSend">Send</button> 

</div> 

</body> 

</html> 




Önceki HTML, giriş sayfasının ortak işaretlemesini tanımlar. 

8. Yeni bir src/CSS dizini oluşturun. Amacı, projenin . css dosyalarını depolamadır. 

9. Aşağıdaki içerikle src/CSS/Main. css oluşturun: 

*, *::before, *::after { 
box-sizing: border-box; 

} 

html, body { 
margin: 0; 
padding: 0; 

} 

.input-zone { 

align-items: çenter; 
display: flex; 
flex-direction: row; 
margin: 10px; 

} 

.input-zone-input { 
flex: 1; 

margin-right: 10px; 

} 

.message-author { 

font-weight: bold; 

} 

.messages { 

border: lpx solid #000; 
margin: 10px; 
max-height: 300px; 
min-height: 300px; 
overflow-y: auto; 
padding: 5px; 

} 

Önceki Mairı. css dosyası uygulamayı stiller. 

10. Şu içerikle src/tsconfig. JSON oluşturun: 

{ 

"compilerOptions": { 

"target": "es5" 

} 

} 


Yukarıdaki kod, TypeScript derleyicisini ECMAScript 5 uyumlu JavaScript üretecek şekilde yapılandırır. 


11. Aşağıdaki içeriğe sahip src/index. TS oluşturun: 




import "./css/main.css"; 


const divMessages: HTMLDivElement = document.querySelector("#divMessages"); 
const tbMessage: HTMLInputElement = document.querySelector("#tbMessage"); 
const btnSend: HTMLButtonElement = document.querySelector("#btnSend"); 
const username = new Date(),getTime(); 

tbMessage.addEventListener("keyup", (e: KeyboandEvent) => { 
if (e.keyCode === 13) { 
send(); 

} 

}); 

btnSend.addEventListener("click ", send); 

function send() { 

} 

Önceki TypeScript, DOM öğelerine başvurulan alır ve iki olay işleyicisini ekler: 

• keyup : Bu olay Kullanıcı metin kutusuna tbMessage olarak tanımlanan bir şeyi yazdığında ateşlenir, 
send işlevi, Kullanıcı ENTER tuşuna bastığında çağrılır. 

• click : Kullanıcı Gönder düğmesine tıkladığında bu olay ateşlenir, send işlevi çağırılır. 

ASP.NET Core uygulamasını yapılandırma 

1. startup.configure yönteminde belirtilen kod Merhaba Dünya! görüntülüyor. app.Run yöntemi çağrısını, 
Usedefaultfiles ve usestaticfi lesçağrılarıyla değiştirin. 

app. UseDefault Fileş (); 
app.UseStaticFileş(); 


Yukarıdaki kod, kullanıcının tam URL 'sini veya Web uygulamasının kök URL 'sini girmeksizin Dizin, html 
dosyasını bulmasını ve sunmasını sağlar. 

2. startup.configureServices yönteminde Addsignalr öğesini çağırın. SignalR hizmetlerini projenize ekler. 

Services.AddSignalR(); 

3. B\r/hub yolunu chatHub hub'ma eşleyin, startup.configure yönteminin sonuna aşağıdaki satırları ekley 

app.UseSignalR(options => 

{ 

options.MapHub<ChatHub>("/hub"); 

}); 


4. Proje kökünde hub olarak adlandırılan yeni bir dizin oluşturun. Amacı, bir sonraki adımda oluşturulan 
SignalR hub ’ını deposağlamaktır. 

5. Aşağıdaki kodla hub hub 'lan/ChatHub. cs oluşturun: 










using Microsoft.AspNetCore.SignalR; 
using System.Threading.Tasks; 

namespace SignalRI/JebPack.Hubs 
{ 

public class ChatHub : Hub 
{ 

} 


6. ChatHub başvurusunu çözümlemek için, Startup.es dosyasının en üstüne aşağıdaki kodu ekleyin: 

using SignalRI/JebPack.Hubs; 


İstemci ve sunucu iletişimini etkinleştir 

Uygulama Şu anda ileti göndermek için basit bir form görüntülüyor. Bunu yapmayı denediğinizde hiçbir şey olmaz. 
Sunucu belirli bir yolu dinliyor, ancak gönderilen iletilerle hiçbir şey yapmıyor. 

1. Proje kökünde aşağıdaki komutu yürütün: 

npm install @microsoft/signalr 

Yukarıdaki komut, istemcinin sunucuya ileti göndermesini sağlayan SignalR TypeScript istemcisiniyüklüyor. 

2. Vurgulanan kodu src/index. TS dosyasına ekleyin: 





import "./css/main.css"; 

impont * as signalR from "@aspnet/signalr"; 

const divMessages: HTMLDivElement = document.querySelector("#divMessages"); 
const tbMessage: HTMLInputElement = document.querySelector("#tbMessage"); 
const btnSend: HTMLButtonElement = document.querySelector("#btnSend")j 
const username = new Date(),getTime(); 

const connection = new signalR.HubConnectionBuilder() 

.withllrl("/hub") 

.build(); 

connection.on("messageReceived", (username: string, message: string) => { 
let m = document.createElement("div"); 

m.innerHTML = 

' <div class="message-author">${username}</divxdiv>${message}</div>'; 
divMessages.appendChild(m); 

divMessages.scrollTop = divMessages.scrollHeight; 

}); 

connection.start().catch(err => document.write(err)); 

tbMessage.addEventListener("keyup", (e: KeyboardEvent) => { 
if (e.keyCode === 13) { 
send(); 

} 

})J 

btnSend.addEventListener("click ", send); 

function send() { 

} 

Yukarıdaki kod, sunucudan ileti almayı destekler. HubConnectionBuiider sınıfı, sunucu bağlantısını 
yapılandırmak için yeni bir Oluşturucu oluşturur. withuri işlevi hub URL 'sini yapılandırır. 

SignalR, istemci ile sunucu arasında ileti alışverişi yapılmasını mümkün. Her ileti belirli bir ada sahiptir. 
Örneğin, ileti bölgesindeki yeni iletiyi görüntülemekten sorumlu mantığı çalıştıran messageReceived adına 
sahip iletilere sahip olabilirsiniz. Belirli bir iletiyi dinlemek on işlevi aracılığıyla yapılabilir. Herhangi bir 
sayıda ileti adını dinleyebilmeniz gerekir. Ayrıca, yazarın adı ve alınan iletinin içeriği gibi parametreleri iletiye 
geçirmek da mümkündür, istemci bir ileti aldıktan sonra yazarın adı ve innermm özniteliğinde ileti 
içeriğiyle yeni bir div öğesi oluşturulur. Bu, iletileri görüntüleyen ana div öğesine eklenir. 

3. Artık istemci bir ileti aldığına göre, ileti gönderecek şekilde yapılandırın. Vurgulanan kodu src/index. TS 
dosyasına ekleyin: 









import "./css/main.css"; 

import * as signalR from "@aspnet/signalr"; 

const divMessages: HTMLDivElement = document.querySelector("#divMessages"); 
const tbMessage: HTMLInputElement = document.querySelector("#tbMessage"); 
const btnSend: HTMLButtonElement = document.querySelector("#btnSend"); 
const username = new Date(),getTime(); 

const connection = new signalR.HubConnectionBuilden() 

.withUrl("/hub") 

.build(); 

connection.on("messageReceived", (username: string, message: string) => { 
let messageContainer = document.createElement("div"); 

messageContainer.innerHTML = 

' <div class="message-author">${username}</divxdiv>${message}</div>'; 

divMessages.appendChild(messageContainer); 
divMessages.scrollTop = divMessages.scrollHeight; 

}); 

connection.start().catch(err => document.write(err)); 

tbMessage.addEventListener("keyup", (e: KeyboardEvent) => { 
if (e.keyCode === 13) { 
send(); 

} 

})J 

btnSend.addEventListener("click", send); 


function send() { 

connection.send("newMessage", username, tbMessage.value) 
.then(() => tbMessage.value = ""); 


} 


VVebSockets bağlantısı aracılığıyla bir ileti gönderildiğinde send yönteminin çağrılması gerekir. Yöntemin ilk 
parametresi ileti adıdır. İleti verileri diğer parametreleri geçersiz kılar.Bu örnekte, newMessage sunucusuna 
gönderildiği gibi bir ileti gönderilir, ileti, bir metin kutusundan Kullanıcı adından ve Kullanıcı girişinden 
oluşur. Gönderme işlemi çalışırsa metin kutusu değeri temizlenir. 


4. Vurgulanan yöntemi chatHub sınıfına ekleyin: 

using Microsoft.AspNetCore.SignalR; 
using System.Threading.Tasks; 

namespace SignalRUebPack.Hubs 

{ 

public class ChatHub : Hub 

{ 

public async Task NewMessage(long username, string message) 

{ 

await Clients.All.SendAsync("messageReceived", username, message); 

} 

} 


Yukarıdaki kod, sunucu onları aldıktan sonra tüm bağlı kullanıcılara ileti almış iletileri yayınlar.Tüm iletileri 
almak için genel bir on yöntemi olması gereksizdir. İleti adından sonra adlandırılmış bir yöntem. 

Bu örnekte, TypeScript istemcisi newMessage olarak tanımlanan bir ileti gönderir. C# NewMessage yöntemi, 
istemci tarafından gönderilen verileri bekler. İstemcilerdeki sendadsync yöntemine bir çağrı yapılır. Alınan 










iletiler, hub 'a bağlı tüm istemcilere gönderilir. 


Uygulamayı test etme 

Uygulamanın aşağıdaki adımlarla çalıştığından emin olun. 

• Visual Studio 

• Visual Studio Code 

1. Web paketini yayın modunda çalıştırın. Paket Yöneticisi konsol penceresini kullanarak, proje kökünde 
aşağıdaki komutu yürütün. Proje kökünde değilseniz, komutu girmeden önce cd signaiRWebPack girin. 

npm run release 

Bu komut, uygulamayı çalıştırırken alınacağı istemci-tarafı varlıkları verir.Varlıkları yerleştirilir wwwroot 
klasör. 

Web, aşağıdaki görevleri tamamlandı: 

• içeriğini temizleneceği wwwroot dizin. 

• JavaScript için TypeScript dönüştürülen—olarak da bilinen bir işlem transpilation. 

• Dosya boyutunu küçültmek için oluşturulan JavaScript karıştırılmış—olarak da bilinen bir işlem 
küçültme. 

• işlenen JavaScript, CSS ve HTML dosyalarından kopyalanan src için vzvzvzroot dizin. 

• Aşağıdaki öğeleri içine eklenen wwwroot/index.html dosyası: 

o A <ünk> başvuran etiketi wwwroot/ma'ın.< karma>.css dosya. Bu etiket kapatılmadan hemen 
önce yerleştirilir </head> etiketi. 

o A <script> küçültülmüş başvuran etiketi wwwroot/main.< karma>.js dosya. Bu etiket 
kapatılmadan hemen önce yerleştirilir </body> etiketi. 

2. Hata ayıklayıcıyı eklemeden uygulamayı bir tarayıcıda başlatmak **için hata ayıklama > ** Başlat 1 ı seçin. 
WwwrootAndex.html dosyası http://iocaihost:<port_number> olarak sunulur. 

3. Başka bir tarayıcı örneği (herhangi bir tarayıcı) açın. URL 'Yİ adres çubuğuna yapıştırın. 

4. Tarayıcı seçin, ileti metin kutusuna bir şey yazın ve Gönder düğmesine tıklayın. Benzersiz Kullanıcı adı ve 
ileti anında her iki sayfada da görüntülenir. 
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Ek kaynaklar 

• ASP.NET Core SignalR JavaScript istemcisi 

• ASP.NET Core SignalR hub ’ları kullanma 















































ASRNET Core için SignalR hub ları kullanma 

13.11.2019 • 11 minutes to read ı Edit Online 


, Rachel Appel ve Kevin Griffin tarafından 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

SignalR hub nedir? 

SignalR hub 'Ları API 'SI, bağlı istemcilerdeki yöntemleri sunucudan çağırmanızı sağlar.Sunucu kodunda, 
istemci tarafından çağrılan yöntemleri tanımlarsınız, istemci kodunda, sunucudan çağrılan yöntemleri 
tanımlarsınız. SignalR, gerçek zamanlı istemciden sunucuya ve sunucudan istemciye iletişimleri olanaklı kılan 
arka planda her şeyi ele alır. 

SignalR hub ları yapılandırma 

SignalR ara yazılımı, Services. AddSignaiR çağırarak yapılandırılmış bazı hizmetler gerektirir. 

Services .AddSignalR(); 

BirASP.NET Core uygulamasına SignalR işlevselliği eklerken, startup.configure yönteminin app.useEndpoints 
geri aramasında endpoint.MapHub çağırarak SignalR yollar ayarlayın. 

app.UseRouting(); 
app.UseEndpoints(endpoints => 

{ 

endpoints.MapHub<ChatHub>("/chathub"); 

}); 

BirASP.NET Core uygulamasına SignalR işlevselliği eklerken, startup.configure yöntemindeki app.useSignaiR 
çağırarak SignalR yollar ayarlayın. 

app.UseSignalR(route => 

{ 

route.MapHub<ChatHub>("/chathub"); 

}); 


Hub 1ar oluşturma ve kullanma 

Hub devralan bir sınıf bildirerek bir hub oluşturun ve buna ortak yöntemler ekleyin, istemciler, pubüc olarak 
tanımlanan yöntemleri çağırabilir. 

public class ChatHub : Hub 
{ 

public Task SendMessage(string user, string message) 

{ 

return Clients.All.SendAsync("ReceiveMessage", user, message); 

} 

} 
















Herhangi C# bir yöntemde yaptığınız gibi, karmaşık türler ve diziler dahil olmak üzere bir dönüş türü ve 
parametreleri belirtebilirsiniz. SignalR parametrelerinizin ve dönüş değerlerindeki karmaşık nesne ve dizilerin 
serileştirilmesi ve serisini kaldırma işlemi gerçekleştirir. 


NOTE 

Hub 'lar geçicidir: 

• Durumu hub sınıfının bir özelliğinde depolamayın. Her hub yöntemi çağrısı yeni bir hub örneğinde yürütülür. 

• Hub'a bağlı olan zaman uyumsuz yöntemleri çağırırken await kullanın. Örneğin, clients. All.sendAsync(...) gibi 
bir yöntem, await olmadan çağrılırsa ve hub yöntemi sendAsync bitmeden önce tamamlandığında başarısız olabilir. 


Bağlam nesnesi 

Hub sınıfı, bağlantıyla ilgili bilgilerle aşağıdaki özellikleri içeren bir context özelliğine sahiptir 


ÖZELLİK 

AÇIKLAMA 

Connectionld 

SignalRtarafından atanan bağlantının benzersiz KİMLİĞİNİ 
alır. Her bağlantı için bir bağlantı KİMLİĞİ vardır. 

Userldentifier 

Kullanıcı tanımlayıcısınıalır. Varsayılan olarak, SignalR, Kullanıcı 
tanımlayıcısı olarak bağlantıyla ilişkili claimsPrincipal 
ClaimTypes .Nameldentifier' kullanır. 

User 

Geçerli kullanıcıyla ilişkili ClaimsPrincipal alır. 

Items 

Bu bağlantının kapsamındaki verileri paylaşmak için 
kullanılabilecek bir anahtar/değer koleksiyonu alır. Veriler bu 
koleksiyonda depolanabilir ve farklı hub yöntemi 
etkinleştirmeleri arasında bağlantı için kalıcı hale gelir. 

Features 

Bağlantıda kullanılabilen özelliklerin koleksiyonunu alır. 

Şimdilik bu koleksiyon Çoğu senaryoda gerekli değildir, bu 
nedenle henüz ayrıntılı olarak açıklanmamıştır. 

ConnectionAborted 

Bağlantı iptal edildiğinde bildirim veren bir 

CancellationToken alır. 


Hub.context aşağıdaki yöntemleri de içerir 


YÖNTEM 

AÇIKLAMA 

GetHttpContext 

Bağlantı için HttpContext döndürür veya bağlantı bir HTTP 
isteğiyle ilişkilendirilmediği durumlarda null . HTTP 
bağlantılarında, HTTP üstbilgileri ve sorgu dizeleri gibi bilgileri 
almak için bu yöntemi kullanabilirsiniz. 

Abort 

Bağlantıyı iptal eder. 

İstemciler nesnesi 



Hub sınıfı, sunucu ve istemci arasındaki iletişim için aşağıdaki özellikleri içeren bir clients özelliğine sahiptir: 






















ÖZELLİK 


AÇIKLAMA 


Ali 

Tüm bağlı istemcilerde bir yöntemi çağırır 

Caller 

istemciye, hub yöntemini çağıran bir yöntemi çağırır 

Others 

Yöntemi çağıran istemci hariç tüm bağlı istemcilerde bir 
yöntemi çağırır 

Hub.clients aşağıdaki yöntemleri de içerir: 


YÖNTEM 

AÇIKLAMA 

AllExcept 

Belirtilen bağlantılar hariç tüm bağlı istemcilerde bir yöntemi 
çağırır 

Client 

Belirli bir bağlı istemcide bir yöntemi çağırır 

Clients 

Belirli bağlı istemcilerde bir yöntemi çağırır 

Group 

Belirtilen gruptaki tüm bağlantılarda bir yöntemi çağırır 

GroupExcept 

Belirtilen bağlantılar dışında, belirtilen gruptaki tüm 
bağlantılarda bir yöntemi çağırır 

Groups 

Birden çok bağlantı grubunda bir yöntemi çağırır 

OthersInGroup 

Hub yöntemini çağıran istemci hariç bir bağlantı grubu 
üzerinde bir yöntemi çağırır 

User 

Belirli bir kullanıcıyla ilişkili tüm bağlantılarda bir yöntemi 
çağırır 

Users 

Belirtilen kullanıcılarla ilişkili tüm bağlantılarda bir yöntemi 


çağırır 


Yukarıdaki tablolardaki her bir özellik veya yöntem sendAsync yöntemi olan bir nesne döndürür. sendAsync 
yöntemi, çağrılacak istemci yönteminin adını ve parametrelerini girmenize olanak sağlar. 

İstemcilere ileti gönderme 

Belirli istemcilere çağrı yapmak için ciients nesnesinin özelliklerini kullanın. Aşağıdaki örnekte, üç hub yöntemi 
vardır: 

• sendMessage , ciients.Aiı kullanarak tüm bağlı istemcilere bir ileti gönderir. 


• 

SendMessageToCaller , 

clients.Caller kullanarak çağırana geri ileti gönderir. 

• 

SendMessageToGroups , 

SignalR Users 

grubundaki tüm istemcilere bir ileti gönderir. 



















public Task SendMessage(string user, string message) 

{ 

return Clients.All.SendAsync("ReceiveMessage"., user, message); 

} 

public Task SendMessageToCaller(string message) 

{ 

return Clients.Caller.SendAsync("ReceiveMessage", message); 

} 

public Task SendMessageToGroup(string message) 

{ 

return Clients.Group("SignalR Users").SendAsync("ReceiveMessage", message); 


} 


Türü kesin belirlenmiş hub 1ar 

sendAsync kullanmanın bir dezavantajı, çağrılacak istemci yöntemini belirtmek üzere bir sihirli dize kullanır. Bu, 
yöntem adı yanlış yazıldığında veya istemcide eksikse kodu, çalışma zamanı hatalarına açık bırakır. 


SendAsync 

kullanmanın bir alternatifi Hub<T>ile 

Hub 

kesin olarak yazmadır. Aşağıdaki örnekte, 

ChatHub 


istemci yöntemleri ıchatciient adlı bir arabirimde ayıklanır. 

public interface IChatClient 
{ 

Task ReceiveMessage(string user, string message); 

Task ReceiveMessage(string message); 

} 

Bu arabirim, önceki chatHub örneğini yeniden düzenleme için kullanılabilir. 

public class StronglyTypedChatHub : Hub<IChatClient> 

{ 

public async Task SendMessage(string üşer, string message) 

{ 

await Clients.All.ReceiveMessage(userj message); 

} 

public Task SendMessageToCaller(string message) 

{ 

return Clients.Caller.ReceiveMessage(message); 

} 

} 

Hub<ıchatciient> kullanmak, istemci yöntemlerinin derleme zamanı denetimini mümkün yapar. Bu, Hub<T> 
yalnızca arabirimde tanımlanan yöntemlere erişim sağlayabileceğinizden, sihirli dizeler kullanılarak oluşan 
sorunları önler. 

Türü kesin belirlenmiş Hub<T> kullanmak SendAsync kullanma özelliğini devre dışı bırakır. Arabirim üzerinde 
tanımlanan Yöntemler hala zaman uyumsuz olarak tanımlanabilir. Aslında, bu yöntemlerin her biri bir Task 
döndürmelidir. Bir arabirim olduğundan, async anahtar sözcüğünü kullanmayın. Örneğin: 

public interface IClient 
{ 

Task ClientMethod(); 

} 
















NOTE 

Async soneki yöntem adından çıkarılır, istemci yönteminiz . on( ’MyMethodAsync ') ile tanımlanmamışsa, ad olarak 
MyMethodAsync kullanmamalısınız. 


Bir hub yönteminin adını değiştirme 

Varsayılan olarak, bir sunucu hub 'ı Yöntem adı .N ET yönteminin adıdır. Ancak, bu Varsayılanı değiştirmek ve 
yöntemi için el ile bir ad belirtmek için Hubmethodname özniteliğini kullanabilirsiniz. İstemci, yöntemi çağırırken 
.NET Yöntem adı yerine bu adı kullanmalıdır. 

[HubMethodName("SendMessageTollser") ] 

public Task DirectMessage(string user, string message) 

{ 

return Clients.User(user).SendAsync("ReceiveMessage ", message); 

} 


Bir bağlantı için olayları işleyin 

SignalR hub ' Ları API'SI, bağlantıları yönetmek ve izlemek için onConnectedAsync ve onDisconnectedAsync sanal 
yöntemleri sağlar. Bir istemci hub 'a bağlanırken bir gruba ekleme gibi işlemleri gerçekleştirmek için 
OnConnectedAsync sanal yöntemini geçersiz kılın. 

public override async Task OnConnectedAsync() 

{ 

await Groups.AddToGroupAsync(Context.ConnectionIdj "SignalR Users"); 
await base.OnConnectedAsync(); 

} 

Bir istemcinin bağlantısı kesildiğinde eylemler gerçekleştirmek için OnDisconnectedAsync sanal yöntemini 
geçersiz kılın. İstemci kasıtlı olarak bağlantı kesildiğinde (örneğin connection.stop() çağırarak), exception 
parametresi nuiı olur. Ancak, istemcinin bağlantısı bir hata nedeniyle kesildiyse (örneğin, bir ağ hatası), 
exception parametresi hatayı açıklayan bir özel durum içerir. 

public override async Task OnDisconnectedAsync(Exception exception) 

{ 

await Groups.RemoveFromGroupAsync(Context.ConnectionId, "SignalR Users"); 
await base.OnDisconnectedAsync(exception ); 

} 


Hataları işleme 

Hub yöntemleriniz içinde oluşturulan özel durumlar, yöntemi çağıran istemciye gönderilir.JavaScript 



Hub 'iniz bir özel durum oluşturursa, bağlantılar kapanmamıştır.Varsayılan olarak, SignalR istemciye genel bir 
hata iletisi döndürür. Örneğin: 













Microsoft.AspNetCore.SignalR.HubException: An unexpected error occurred invoking 'MethodName' on the server. 

Beklenmeyen özel durumlar genellikle veritabanı bağlantısı başarısız olduğunda tetiklenen bir özel durumda 
veritabanı sunucusunun adı gibi hassas bilgiler içerir. SignalR, bu ayrıntılı hata iletilerini varsayılan olarak bir 
güvenlik ölçüsü olarak kullanıma sunmaz. Özel durum ayrıntılarının neden bastırıldığına ilişkin daha fazla bilgi 
için güvenlik konuları makalesine bakın. 

istemciye yaymak istediğiniz olağanüstü bir koşulunuz varsa HubException sınıfını kullanabilirsiniz. Hub 
yönteinizden bir HubException oluşturursanız, SignalR Metinin tamamını, değiştirilmemiş olarak istemciye 
gönderir. 

public Task ThrowException() 

{ 

throw new HubException("This error will be sent to the Client!"); 

} 



İlgili kaynaklar 

• ASP.NET Core SignalR giriş 

• JavaScript istemcisi 

• Azure'a Yayımlama 








Bir hub dışında ileti gönderme 

10.05.2019 • 2 minutes to read ı Edit Online 


Tarafından Mikael Mengistu 

SignalR hub'ı, SignalR sunucuya bağlı istemcilere ileti göndermek için çekirdek soyutlamadır. Diğer yerlerden 
uygulama kullanarak ileti göndermek mümkündür iHubContext hizmeti. Bu makalede, bir SignalR erişmeye 
açıklanmaktadır iHubContext hub dışında istemcilere bildirimleri göndermek için. 

Görüntüleme veya indirme örnek kodu (karşıdan yükleme) 

IHubContext örneğini al 

ASP.NET Core SignalR öğesinde bir örneğini erişebileceğiniz iHubContext aracılığıyla bağımlılık ekleme. Örneği 
ekleyebilir iHubContext bir denetleyici, ara yazılım veya diğer Dİ hizmeti, istemcilere göndermek için örneği 
kullanın. 


NOTE 

Bu, ASP.NET tarafından farklıdır 4.x GlobalHost erişim sağlamak için kullanılan SignalR iHubcontext . ASP.NET Core, bu genel 
tekil gereksinimini ortadan kaldırır, bir bağımlılık ekleme çerçeve vardır. 


Bir denetleyici IHubContext örneğinde ekleme 

Örneği ekleyebilir iHubContext , oluşturucuya ekleyerek bir denetleyici içinde: 

public class HomeController : Controller 
{ 

pnivate readonly IHubContext<NotificationHub> _hubContext; 

public HomeController(IHubContext<NotificationHub> hubContext) 

{ 

_hubContext = hubContext; 

} 

} 

Şimdi, örneğine erişimi olan iHubContext , hub içinde değilmiş gibi hub yöntemlerini çağırabilirsiniz. 

public async Task<IActionResult> Index() 

{ 

await _hubContext.Clients.All.SendAsync("Notify"j $"Home page loaded at: {DateTime.Now}"); 
return View(); 

} 

Ara yazılım IHubContext örneğinde Al 

Erişim iHubContext ara yazılım ardışık düzenini içinde şu şekilde: 













app.Use(async (context, next) => 

{ 

var hubContext = context.RequestServices 

.GetRequiredService<IHubContext<MyHub>>(); 

II... 

}); 


NOTE 

Ne zaman hub yöntemleri çağrıldığında gelen dışında Hub çağırmayla ilgili hiçbir arayan olduğunda, sınıf. Bu nedenle, erişim 
yoktur Connectionld , Caller , ve Others Özellikleri. 


Kesin türü belirtilmiş bir HubContext ekleme 

Hub'ınıza devraldığı kesin türü belirtilmiş bir HubContext eklemesine olun Hub<T> . Kullanarak ekleme 
IHubContext<THubj T> arabirimi yerine IHubContext<THub> . 

public class ChatController : Controller 

{ 

public IHubContext<ChatHubj IChatClient> _strongChatHubContext { get; } 

public ChatController(IHubContext<ChatHubj IChatClient> chatHubContext) 

{ 

_strongChatHubContext = chatHubContext; 

} 

public async Task SendMessage(string message) 

{ 

await _strongChatHubContext.Clients.Ali.ReceiveMessage(message); 

} 

} 


İlgili kaynaklar 

• Kullanmaya başlama 

• Merkezler 

• Azure'a Yayımlama 






SignalR içinde kullanıcıları ve gruplan yönetme 
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Brennan Conroy tarafından 

SignalR, iletilerin belirli bir kullanıcıyla ilişkili tüm bağlantılara ve ayrıca adlandırılmış bağlantı gruplarına 
gönderilmesini sağlar. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

SignalR kullanıcılar 

SignalR, belirli bir kullanıcıyla ilişkili tüm bağlantılara ileti göndermenizi sağlar. Varsayılan olarak, SignalR, 
Kullanıcı tanımlayıcısı olarak bağlantıyla ilişkili ciaimsPrincipai ciaimTypes.Nameidentifier kullanır. Tek bir 
kullanıcının SignalR uygulamasına birden fazla bağlantısı olabilir. Örneğin, bir Kullanıcı masaüstüne ve 
telefonlarına bağlanabilir. Her cihazın ayrı bir SignalR bağlantısı vardır, ancak hepsi aynı kullanıcıyla ilişkilendirilir. 
Kullanıcıya bir ileti gönderildiğinde, bu kullanıcıyla ilişkili tüm bağlantılar iletiyi alır. Bir bağlantı için Kullanıcı 
tanımlayıcısına, hub 'ınızdaki context.useridentifier özelliği tarafından erişilebilir. 


Aşağıdaki örnekte gösterildiği gibi, kullanıcı tanımlayıcısını hub yönteminizin User işleve geçirerek belirli bir 
kullanıcıya bir ileti gönderin: 



{ 

return Clients.User(user).SendAsync("ReceiveMessage", message); 

} 


SignalR gruplar 

Grup, bir adla ilişkili bir bağlantı koleksiyonudur.iletiler, bir gruptaki tüm bağlantılara gönderilebilir.Gruplar 
uygulama tarafından yönetildiğinden, gruplar bir bağlantıya veya birden çok bağlantıya göndermek için önerilen 
yoldur. Bir bağlantı, birden fazla grubun üyesi olabilir. Bu, grupları her odanın bir grup olarak gösterilebileceği bir 
sohbet uygulaması gibi bir şey için ideal hale getirir. AddToGroupAsync ve RemoveFromGroupAsync yöntemleri 
aracılığıyla gruplardan bağlantılar eklenebilir veya gruplardan kaldırılabilir. 










public async Task AddToGroup(str'ing groupName) 

{ 

await Groups.AddToGroupAsync(Context.ConnectionIdj groupName); 

await Clients.Group(groupName).SendAsync("Send ", $"{Context.ConnectionId} has joined the group 
{groupName}."); 

} 

public async Task RemoveFromGroup(string groupName) 

{ 

await Groups.RemoveFromGroupAsync(Context.Connectionld, groupName); 

await Clients.Group(groupName).SendAsync("Send"j $"{Context.ConnectionId} has left the group 
{groupName}."); 

} 

Bağlantı yeniden bağlandığında grup üyeliği korunmaz. Bağlantı, yeniden oluşturulduğunda gruba yeniden 
katılması gerekir. Uygulama birden çok sunucuya ölçeklendirildiyse bu bilgiler kullanılamadığından, bir grubun 
üyelerini saymak mümkün değildir. 

Grupları kullanırken kaynaklara erişimi korumak için ASP.NET Core kimlik doğrulaması ve yetkilendirme işlevini 
kullanın. Yalnızca bu grup için kimlik bilgileri geçerliyse bir gruba Kullanıcı eklerseniz, bu gruba gönderilen iletiler 
yalnızca yetkili kullanıcılara gider. Ancak, gruplar bir güvenlik özelliği değildir. Kimlik doğrulama talepleri, süre 
sonu ve iptal gibi grupların olmadığı özelliklere sahiptir. Bir kullanıcının gruba erişim izni iptal edildiğinde, bunu el 
ile tespit etmeniz ve gruptan kaldırmanız gerekir. 


NOTE 

Grup adları büyük/küçük harfe duyarlıdır. 


İlgili kaynaklar 

• Kullanmaya başlama 

• Merkezler 

• Azure'a Yayımlama 




SignalR API tasarım konuları 
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Tarafından Andrew Stanton-Nurse 

Bu makalede, SignalR tabanlı API'leri oluşturmaya yönelik rehberlik sağlar. 

Geriye dönük uyumluluk sağlamak için özel nesne parametreleri 
kullanma 

Bir SignalR hub'yöntemini (istemci veya sunucu) parametreleri ekleyerek olan bir değişiklik. Başka bir deyişle, eski 
istemciler/sunucuları parametreleri uygun sayıda olmayan bir yöntem çağırmak çalıştığınızda bir hata almazsınız. 
Ancak, bir özel nesne parametresi için Özellikler ekleme olan değil bir değişiklik. Bu, istemci veya Sunucu'da 
değişikliklere dayanıklı uyumlu API'leri tasarlamak için kullanılabilir. 

Örneğin, aşağıdaki gibi bir sunucu tarafı API göz önünde bulundurun: 

public async Task<string> GetTotalLength(string paraml) 

{ 

return paraml.Length; 

} 


JavaScript istemcisi kullanarak bu yöntemi çağıran 

İnvoke 

gibi: 

connection.invoke("GetîotalLength", "valuel"); 

Eski istemciler, sunucu yöntemi daha sonra ikinci bi 

r parametre ekleyin, bu parametre değeri sağlamaz.Örneğin: 


public async Task<string> GetTotalLength(string paraml, string param2) 

{ 

return paraml.Length + param2.Length; 

} 

Eski istemci, bu yöntem çağırmak çalıştığında, şunun gibi bir hata alırsınız: 

Microsoft.AspNetCore.SignalR.HubException: Failed to invoke 'GetTotalLength' due to an error on the server. 

Sunucuda böyle bir günlük iletisi görürsünüz: 

System.IO.InvalidDataException: Invocation provides 1 argument(s) but target expects 2. 

Eski istemci yalnızca bir parametreye gönderilen, ancak yeni sunucu API iki parametre gerekli. Parametre olarak 
özel nesneler kullanarak daha fazla esneklik sağlar. Şimdi yeniden tasarlamanız özgün API'yi özel bir nesne 
kullanın: 









public class TotalLengthRequest 

{ 

public string Paramı { get; set; } 

} 


public async Task GetTotalLength(TotalLengthRequest req) 

{ 

return req.Paramı.Length; 

} 


Şimdi, istemci yöntemini çağırmak için bir nesne kullanır: 

connection.invoke("GetîotalLength ", { paraml: "valuel" }); 

Bir parametre eklemek yerine, özellik eklemek TotaiLengthRequest nesnesi: 

public class TotalLengthRequest 

{ 

public string Paraml { get; set; } 
public string Param2 { get; set; } 

} 

public async Task GetTotalLength(TotalLengthRequest req) 

{ 

var length = req.Paraml.Length; 
if (req.Param2 != null) 

{ 

length += req.Param2.Length; 

} 

return length; 

} 

Eski istemci, tek bir parametre, ek gönderdiğinde Param 2 özellik sol null . Kontrol ederek daha eski bir istemci 
tarafından gönderilen bir iletinin algılayabilir Param 2 için null ve varsayılan değer geçerlidir. Yeni bir istemci, her 
iki parametre gönderebilirsiniz. 

connection.invoke("GetTotalLength", { paraml: "valuel", param2: "value2" }); 

istemci üzerinde tanımlanan yöntemleri için aynı tekniği çalışır. Sunucu tarafındaki özel bir nesne gönderebilirsiniz: 

public async Task Broadcast(string message) 

{ 

await Clients.All.SendAsync("ReceiveMessage", new 

{ 

Message = message 

}); 

} 

istemci tarafında size erişim Message bir parametre kullanmak yerine özelliği: 

connection.on("ReceiveMessage", (req) => { 
appendMessageToChatWindow(req.message); 

}); 

iletiyi gönderen yüküne eklemek üzere daha sonra karar verirseniz, nesnenin bir özellik ekleyin: 














public async Task Broadcast(string message) 

{ 

await Clients.All.SendAsync("ReceiveMessage", new 

{ 

Senden = Context.User.Identity.Name, 

Message = message 

}); 

} 


Eski istemciler bekleniyor olmaz sender bunu yoksaymak şekilde değeri. Yeni bir istemci yeni özelliği okunamıyor 
güncelleştirerek kabul edebilirsiniz: 








ASPNET Core SignalR istemci özellikleri 
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Özellik dağıtımı 

Aşağıdaki tabloda, gerçek zamanlı destek sunan istemciler için özellikler ve destek gösterilmektedir. Her özellik için, 
bu özelliği destekleyen En düşük sürüm listelenir. Listelenen bir sürüm yoksa özellik desteklenmez. 


ÖZELLİK 

.NET 

JAVASCRIPT 

JAVA 

Azure SignalR hizmeti 

1.0.0 

1.0.0 

1.0.0 

desteği 




Sunucudan istemciye akış 

1.0.0 

1.0.0 

1.0.0 

istemciden sunucuya akış 

3.0.0 

3.0.0 

3.0.0 

Otomatik yeniden bağlanma 

3.0.0 

3.0.0 

□ 

(.net, JavaScript) 




VVebSockets taşıma 

1.0.0 

1.0.0 

1.0.0 

Sunucu tarafından 

1.0.0 

1.0.0 

□ 

gönderilen olay aktarımı 




Uzun yoklama taşıması 

1.0.0 

1.0.0 

3.0.0 

JSON hub 'ı Protokolü 

1.0.0 

1.0.0 

1.0.0 

MessagePack Hub Protokolü 

1.0.0 

1.0.0 

□ 


Java istemcisinde otomatik yeniden bağlanma desteği, sorun izleyici'de izlenir. 

Ek kaynaklar 

• ASP.NET Core için SignalR ile çalışmaya başlama 

• Desteklenen platformlar 

• Merkezler 

• JavaScript istemcisi 




.NET Client ASRNET Core SignalR 
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ASP.NET Core SignalR .NET istemci kitaplığı, .NET uygulamalarından SignalR hub 'larla iletişim kurmanızı 
sağlar. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Bu makaledeki kod örneği, SignalR .NET Client ASP.NET Core kullanan bir WPF uygulamasıdır. 

SignalR .NET istemci paketini yükler 

Microsoft. AspNetCore.SignalR. .Net istemcilerinin SignalR hub 'lara bağlanması için istemci paketi gerekir. 

• Visual Studio 

• .NET Core CLI 

istemci kitaplığını yüklemek için, Paket Yöneticisi konsolu penceresinde aşağıdaki komutu çalıştırın: 
Install-Package Microsoft.AspNetCore.SignalR.Client 


Bir hub 'a bağlanma 

Bir bağlantı kurmak için bir HubConnectionBuiider oluşturun ve Buiid çağırın. Hub URL'SI, protokol, aktarım 
türü, günlük düzeyi, üst bilgiler ve diğer seçenekler bir bağlantı oluşturulurken yapılandırılabilir. 
HubConnectionBuiider yöntemlerinden herhangi birini Buiid ekleyerek gerekli seçenekleri yapılandırın. 
Bağlantıyı startAsync başlatın. 







using System; 

using System.Threading.Tasks; 
using System.Windows; 

using Microsoft.AspNetCore.SignalR.Client; 

namespace SignalRChatClient 

{ 

public partial class MainWindow : Window 

{ 

HubConnection connection; 
public MainWindow() 

{ 

InitializeComponent(); 

connection = new HubConnectionBuilder() 

.WithUrl("http: //localhost: 53353/ChatHub") 

.Build(); 

connection.Closed += async (error) => 

{ 

await Task.Delay(new Random().Next(0j5) * 1000); 
await connection.StartAsync(); 

}; 

} 

private async void connectButton_Click(object sender, RoutedEventArgs e) 

{ 

connection.On<string, string>("ReceiveMessage"j (user, message) => 

{ 

this.Dispatcher.Invoke(() => 

{ 

var newMessage = $"{user}: {message}"; 
messagesList.Items.Add(newMessage); 

}); 

}); 

try 

{ 

await connection.StartAsync(); 
messagesList.Items.Add("Connection started"); 
connectButton.IsEnabled = false; 
sendButton.IsEnabled = true; 

} 

catch (Exception ex) 

{ 

messagesList.Items.Add(ex.Message); 

} 

} 

private async void sendButton_Click(object sender, RoutedEventArgs e) 

{ 

try 

{ 

await connection.InvokeAsync("SendMessage"j 
userTextBox.Textj messageTextBox.Text); 

} 

catch (Exception ex) 

{ 

messagesList.Items.Add(ex.Message); 

} 

} 

} 

} 


Kayıp bağlantıyı işle 



Otomatik olarak yeniden bağlan 

HubConnection, HubConnectionBuilder withAutomaticReconnect yöntemi kullanılarak otomatik olarak yeniden 
bağlanacak şekilde yapılandırılabilir. Varsayılan olarak otomatik olarak yeniden bağlanmaz. 

HubConnection connection= new HubConnectionBuilden() 

.Withllrl(new Uri( "http: //127.0.0.1: 5000/chatHub")) 

.WithAutomaticReconnect() 

.Build(); 

Hiçbir parametre olmadan, withAutomaticReconnect() her bir yeniden bağlanma denemesini denemeden önce, 
dört başarısız denemeden sonra durdurmadan, istemciyi 0, 2,10 ve 30 saniye bekleyecek şekilde yapılandırır. 

Yeniden bağlanma girişimlerini başlatmadan önce, HubConnection HubConnectionstate.Reconnecting durumuna 
geçer ve Reconnecting olayını harekete geçirebilir. Bu, kullanıcıların bağlantının kaybedildiği ve Kullanıcı arabirimi 
öğelerini devre dışı bırakan kullanıcıları uyarma fırsatı sağlar. Etkileşimli olmayan uygulamalar, iletileri sıraya 
alabilir veya bırakarak başlatabilir. 



iletileri sıradan bildiren bir fırsat sağlar. 

Bağlantı sunucuya tamamen yeni göründüğünden, Reconnected olay işleyicilerine yeni bir Connectionid 
sunulacaktır. 


W ARNING 

Reconnected olay işleyicisinin connectionid parametresi, HubConnection anlaşmayı atlayacakşekilde yapılandırıldıysa 
null olacaktır. 


connection.Reconnected += connectionid => 

{ 

Debug.Assert(connection.State == HubConnectionState.Connected); 

// Notify usens the connection was reestablished. 

// Start dequeuing messages queued while reconnecting if any. 

return Task.CompletedTask; 

}; 

withAutomaticReconnect() , ilk başlatma başarısızlıklarını yeniden denemek için HubConnection yapılandırmaz, bu 
nedenle başlatma hatalarının el ile işlenmesi gerekir: 















public static async Task<bool> ConnectWithRetryAsync(HubConnection connection, CancellationToken token) 

{ 

// Keep trying to until we can start or the token is canceled. 
while (true) 

{ 

try 

{ 

await connection.StartAsync(token); 

Debug.Assert(connection.State == HubConnectionState.Connected); 
return true; 

} 

catch when (token.IsCancellationRequested) 

{ 

return false; 

} 

catch 

{ 

// Failed to connect, trying again in 5000 ms. 

Debug.Assert(connection.State == HubConnectionState.Disconnected); 
await Task.Delay(5000); 

} 

} 

} 

istemci ilk dört denemeden sonra başarıyla yeniden bağlanmazsa, HubConnection Disconnected durumuna geçer 
ve Closed olayını harekete geçirebilir. Bu, bağlantıyı el ile yeniden başlatmayı denemek veya bağlantıyı kalıcı 
olarak kaybettiğini bildirmek için bir fırsat sağlar. 

connection.Closed += error => 

{ 

Debug.Assert(connection.State == HubConnectionState.Disconnected); 

// Notify users the connection has been closed or manually try to restart the connection. 
return Task.CompletedTask; 

}; 


Bağlantıyı kesmeden veya yeniden bağlanma zamanlamasını değiştirmeden önce özel sayıda yeniden bağlantı 
girişimi yapılandırmak için withAutomaticReconnect , her bir yeniden bağlanma girişimine başlamadan önce 
beklenecek gecikme süresi temsil eden bir sayı dizisini kabul eder. 

HubConnection connection= new HubConnectionBuilder() 

.WithUrl(new Uri("http://127.0.0.1:5000/chatHub")) 

.WithAutomaticReconnect(new[] { TimeSpan.Zero, TimeSpan.Zero, TimeSpan.FromSeconds(10) }) 

.Build(); 

// .WithAutomaticReconnect(new[] { TimeSpan.Zero, TimeSpan.FromSeconds(2), TimeSpan.FromSeconds(10), 
TimeSpan.FromSeconds(30) }) yields the default behavior. 

Yukarıdaki örnek, bağlantı kaybolduktan hemen sonra yeniden bağlanmaya başlamak için HubConnection 
yapılandırır. Bu, varsayılan yapılandırma için de geçerlidir. 

ilk yeniden bağlantı girişimi başarısız olursa, ikinci yeniden bağlanma denemesi de varsayılan yapılandırmada 
olduğu gibi 2 saniye beklemek yerine hemen başlatılır. 

İkinci yeniden bağlantı girişimi başarısız olursa, üçüncü yeniden bağlanma denemesi varsayılan yapılandırma gibi 
10 saniye içinde başlar. 

Özel davranış daha sonra, üçüncü yeniden bağlantı girişimi başarısızlığından sonra durarak varsayılan 
davranıştan daha sonra yeniden ayrılmış. Varsayılan yapılandırmada, 30 saniye içinde bir veya daha fazla yeniden 








bağlantı denemesi olur. 

Otomatik yeniden bağlanma denemelerinin zamanlaması ve sayısı üzerinde daha fazla denetime sahip olmak 


istiyorsanız withAutomaticReconnect , NextRetryDeiay adlı tek bir yönteme sahip iRetryPoücy arabirimini 

uygulayan bir nesneyi kabul eder. 


NextRetnyDeiay RetnyContext türünde tek bir bağımsız değişken alır 

. RetryContext üç özelliğe sahiptir: 

PreviousRetryCount , ElapsedTime ve RetryReason long , TimeSpan 

ve Exception . ilk yeniden bağlanma 

denemesinden önce, hem PreviousRetryCount hem de ElapsedTime 

sıfır olur ve RetryReason bağlantının 


kaybolmasına neden olan özel durum olacaktır. Her başarısız yeniden deneme denemesinden sonra 
PreviousRetryCount , bu ana kadar geçen süreyi yansıtacak şekilde ElapsedTime güncelleştirilir ve RetryReason 
son yeniden bağlanma denemesinin başarısız olmasına neden olan özel durum olacaktır. 

NextRetryDeiay , sonraki yeniden bağlanma girişiminden önce beklenecek süreyi temsil eden bir TimeSpan 
değeri döndürmelidir veya HubConnection yeniden bağlamayı durdurması gerekiyorsa nuiı . 

public class RandomRetryPolicy : IRetryPolicy 
{ 

private readonly Random _random = new Random(); 

public TimeSpan? NextRetryDelay(RetryContext retryContext) 

{ 

// If we’ve been reconnecting for less than 60 seconds so far, 

// wait between 0 and 10 seconds before the next reconnect attempt. 
if (retryContext.ElapsedTime < TimeSpan.FromSeconds(60)) 

{ 

return TimeSpan.FromSeconds(_random.Next() * 10); 

} 

else 

{ 

// If we’ve been reconnecting for more than 60 seconds so far, stop reconnecting. 
return null; 

} 

} 

} 


HubConnection connection = new HubConnectionBuilder() 

.WithUrl(new Uri("http://127.0.0.1:5000/chatHub")) 

. 1/dithAutomaticReconnect(new RandomRetryPolicy()) 

.Build(); 

Alternatif olarak, el ile yeniden bağlanmabölümünde gösterildiği gibi istemcinizi el ile yeniden bağlayacaksınız. 

El ile yeniden bağlan 

VVARNING 

3,0 ' den önce, SignalR .NET istemcisi otomatik olarak yeniden bağlanmaz, istemcinizi el ile yeniden bağlayacaksınız kodu 
yazmanız gerekir. 


Kayıp bir bağlantıya yanıt vermek için Closed olayını kullanın. Örneğin, yeniden bağlanmayı otomatik hale 
getirmek isteyebilirsiniz. 

closed olayı, zaman uyumsuz kodun async void kullanılmadan çalışmasına izin veren bir Task döndüren bir 
temsilci gerektirir. Zaman uyumlu olarak çalışan bir closed olay işleyicisindeki temsilci imzasını karşılamak için 
Task.CompletedTask döndürün: 





















connection.Closed += (error) => { 
// Do your close logic. 
return Task.CompletedTask; 

}; 


Zaman uyumsuz desteğin ana nedeni, bağlantıyı yeniden başlatabilmeniz için kullanılır. Bir bağlantının 
başlatılması zaman uyumsuz bir işlemdir. 

Bağlantıyı yeniden başlatan bir ciosed işleyicisinde, aşağıdaki örnekte gösterildiği gibi, sunucunun aşırı 
yüklenmesini engellemek için bazı rastgele gecikme yapmayı düşünün: 

connection.Closed += async (error) => 

{ 

await Task.Delay(new Random().Next(0,5) * 1000); 
await connection.StartAsync(); 

}; 


İstemciden çağrı merkezi yöntemleri 

invokeAsync hub ‘daki yöntemleri çağırır. Hub yöntemi adını ve hub yönteminde tanımlanan tüm bağımsız 
değişkenleri invokeAsync geçirin. SignalR zaman uyumsuzdur, bu nedenle çağrıları yaparken async ve await 
kullanın. 


await connection.InvokeAsync("SendMessage ", 
userTextBox.Textj messageTextBox.Text); 

invokeAsync yöntemi, sunucu yöntemi döndürüldüğünde tamamlayan bir Task döndürür. Varsa, dönüş değeri 

Task sonucu olarak sağlanır. Sunucu üzerindeki yöntemi tarafından oluşturulan özel durumlar hatalı bir Task 
üretir. Sunucu yönteminin tamamlanmasını beklemek için await sözdizimini kullanın ve hataları işlemek için söz 
dizimini try.. .catch . 

sendAsync yöntemi, ileti sunucuya gönderildiğinde tamamlayan bir Task döndürür. Bu Task sunucu yöntemi 
tamamlanana kadar beklemediğinden, dönüş değeri sağlanmaz. İletiyi gönderirken istemcide oluşturulan özel 
durumlar hatalı bir Task üretir. Gönderme hatalarını işlemek için await ve try...catch söz dizimini kullanın. 


NOTE 

Azure SignalR hizmetini sunucusuz modda kullanıyorsanız, bir istemciden hub yöntemlerini çağıramezsiniz. Daha fazla bilgi 
için SignalR hizmeti belgelerinebakın. 


Hub 'dan istemci yöntemlerini çağır 

Bağlantıyı başlatmadan önce, derleme sonrasında connection.on kullanarak hub çağıran yöntemleri tanımlayın. 

connection.On<string, string>("ReceiveMessage"j (user, message) => 

{ 

this.Dispatcher.Invoke(() => 

{ 

var newMessage = $"{user}: {message}"; 
messagesList.Items.Add(newMessage); 




















connection.on önceki kod, sunucu tarafı kodu sendAsync yöntemini kullanarak çağırdığında çalışır. 


public async Task SendMessage(string user, string message) 

{ 

await Clients.All.SendAsync("ReceiveMessage" J user,message); 

} 


Hata işleme ve günlüğe kaydetme 

Try-catch ifadesiyle hataları işleyin. Bir hata oluştuktan sonra gerçekleştirilecek uygun eylemi öğrenmek için 
Exception nesnesini inceleyin. 

try 

{ 

await connection.InvokeAsync("SendMessage ", 
userTextBox.Text , messageTextBox.Text); 

} 

catch (Exception ex) 

{ 

messagesList.Items.Add(ex.Message); 

} 


Ek kaynaklar 

• Merkezler 

• JavaScript istemcisi 

• Azure'a Yayımlama 

• Azure SignalR hizmeti sunucusuz belgeler 



ASPNET Core SignalR Java istemcisi 
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X MIKAEL Mengistu tarafından 

Java istemcisi, Android uygulamaları dahil olmak üzere Java kodundan bir ASP.NET Core SignalR sunucusuna 
bağlanmasını sağlar. JavaScript istemcisi ve .NET istemcisigibi Java istemcisi, bir hub 'a gerçek zamanlı iletiler alıp 
göndermenizi sağlar. Java istemcisi ASP.NET Core 2,2 ve üzeri sürümlerde kullanılabilir. 

Bu makalede başvurulan örnek Java konsol uygulaması SignalR Java istemcisini kullanır. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

SignalR Java istemci paketini yükler 

SignalR-1.0.0 jar dosyası istemcilerin SignalR hub 'lara bağlanmasına izin verir.En son JAR dosyası sürüm 
numarasını bulmak için bkz. Maven arama sonuçları. 


Gradle kullanıyorsanız, Build. Gradle dosyanızın dependencies bölümüne aşağıdaki satırı ekleyin: 


implementation 'com.microsoft.signalr:signaİr:1.0.0' 

Maven kullanıyorsanız, Pok. xml dosyanızın 

<dependencies> 

öğesinin içine aşağıdaki satırları ekleyin: 


<dependency> 

<groupId>com.microsoft.signalr</groupId> 

<artifactld>signalr</artifactld> 

<version>1.0.0</version> 

</dependency> 


Bir hub 'a bağlanma 


HubConnection oluşturmak için 

HubConnectionBuilder 

kullanılmalıdır. Hub URL 'SI ve günlük düzeyi bir bağlantı 

derlenirken yapılandırılabilir. build 
seçenekleri yapılandırın. Bağlantıyı 

Önce HubConnectionBuilder 

start başlatın. 

yöntemlerinden herhangi birini çağırarak gerekli 


HubConnection hubConnection = HubConnectionBuilder.create(input) 
.build(); 


İstemciden çağrı merkezi yöntemleri 

Bir send çağrısı, hub yöntemini çağırır. Hub yöntemi adını ve hub yönteminde tanımlanan tüm bağımsız 
değişkenleri send geçirin. 

hubConnection.send("Send", input); 














NOTE 

Azure SignalR hizmetini sunucusuz moddakullanıyorsanız, bir istemciden hub yöntemlerini çağıramezsiniz. Daha fazla bilgi için 
SignalR hizmeti belgelerinebakın. 


Hub 'dan istemci yöntemlerini çağır 

istemcide hub 'ın çağırakullanabileceği yöntemleri tanımlamak için hubConnection.on kullanın. Bağlantıyı 
başlatmadan önce, oluşturma işleminden sonra yöntemleri tanımlayın. 

hubConnection.on("Send", (message) -> { 

System.out.println("New Message: " + message); 

}, String.class); 


Günlüğe kaydetme ekleme 

SignalR Java istemcisi, günlük kaydı için dolayısıyla slf4j kitaplığını kullanır. Bu, kitaplık kullanıcılarının belirli bir 
günlüğe kaydetme bağımlılığı vererek kendi belirli günlük uygulamasını seçmesine olanak sağlayan, üst düzey bir 
günlüğe kaydetme API 'sidir. Aşağıdaki kod parçacığı, SignalR Java istemcisiyle java.util.iogging nasıl 
kullanacağınızı gösterir. 

implementation 'org.slf4j:slf4j-jdkl4:1.7.25' 

Bağımlılıklarınız için günlük kaydını yapılandırmazsanız, DOLAYıSıYLA SLF4J aşağıdaki uyarı iletisiyle varsayılan 
işlem olmayan bir günlükçü yükler: 

SLF41: Failed to load class "org.slf4j.impl.StaticLoggerBinder". 

SLF41: Defaulting to no-operation (NOP) logger implementation 

SLF4J: See http://www.slf 4 j. 0 rg/c 0 des.html#StaticL 0 ggerBinder for further details. 

Bu, güvenle yoksayılabilir. 

Android geliştirme notları 

SignalR istemci özelliklerine Android SDK uyumlulukla ilgili olarak, hedef Android SDK sürümünüzü belirtirken 
aşağıdaki öğeleri göz önünde bulundurun: 

• SignalR Java İstemcisi, Android API düzeyi 16 ve sonrasında çalışır. 

• Azure SignalR HİZMETİ TLS 1,2 GEREKTİRDİĞİNDEN ve SHA-1 tabanlı şifre paketlerini desteklemediğinden 
Azure SignalR hizmeti üzerinden bağlanmak İÇİN Android API düzeyi 20 ve üzeri bir sürüm gerekir. Android, 
API düzeyi 20 1 de SHA-256 (ve üzeri) şifre paketleri için destek ekledi . 

Taşıyıcı belirteç kimlik doğrulamasını yapılandırma 

Java istemcisinde SignalR, Httphubconnectionbuilder'a "erişim belirteci fabrikası" sağlayarak kimlik doğrulaması 
için kullanılacak bir taşıyıcı belirteç yapılandırabilirsiniz. Rxjava tek bir<dize >sağlamak İçin 
vvithaccesstokenfactory kullanın. Tek. erteleçağrısıyla, istemciniz için erişim belirteçleri oluşturmak üzere mantık 
yazabilirsiniz. 











HubConnection hubConnection = HubConnectionBuilder.create("YOUR HUB URL HERE") 
.withAccessTokenProvider(Single.defer(() -> { 

// Your logic here. 

return Single.just("An Access Token"); 

})).build()j 


Bilinen sınırlamalar 

• Yalnızca JSON Protokolü destekleniyor. 

• Taşıma geri dönüşü ve sunucu gönderme olayları aktarımı desteklenmez. 

• Yalnızca JSON Protokolü destekleniyor. 

• Yalnızca VVebSockets taşıması desteklenir. 

• Akış henüz desteklenmiyor. 

Ek kaynaklar 

• Java API'si başvurusu 

• ASP.NET Core SignalR hub 'ları kullanma 

• ASP.NET Core SignalR JavaScript istemcisi 

• Azure App Service için ASP.NET Core SignalR uygulaması yayımlama 

• Azure SignalR hizmeti sunucusuz belgeler 




ASPNET Core SignalR JavaScript istemcisi 
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, Oychel Appel tarafından 

ASP.NET Core SignalR JavaScript istemci kitaplığı, geliştiricilerin sunucu tarafı hub kodunu çağırmasını sağlar. 
Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

SignalR istemci paketini yükler 

SignalR JavaScript istemci kitaplığı NPM paketi olarak dağıtılır. Visual Studio kullanıyorsanız, kök klasörde, 
Paket Yöneticisi konsolundan npm instaiı çalıştırın. Visual Studio Code için, Tümleşik 
terminaldenkomutunu çalıştırın. 

npm init -y 

npm install @microsoft/signalr 

NPM node_modules\@microsoft\signalr\dist\browser klasöre paket içeriğini yüklüyor. Wwwroot\lib klasörü 
altında SignalR adlı yeni bir klasör oluşturun. SignalR. js dosyasını wwwroot\lib\signalr klasörüne kopyalayın. 

npm init -y 

npm install @aspnet/signalr 

NPM node_modules\@aspnet\signalr\dist\browser klasöre paket içeriğini yüklüyor. Wwwroot\lib klasörü 
altında SignalR adlı yeni bir klasör oluşturun. SignalR. js dosyasını wwwroot\lib\signalr klasörüne kopyalayın. 

SignalR JavaScript istemcisini kullanma 

<script> öğesinde JavaScript istemcisine SignalR başvurun. 

<script snc="~/lib/signaln/signaln.js"x/script> 


Bir hub 'a bağlanma 

Aşağıdaki kod bir bağlantı oluşturur ve başlatır.Hub 'ın adı büyük/küçük harfe duyarlıdır. 

const connection = new SignalR.HubConnectionBuilder() 

,withUrl("/chatHub") 

.configurel_ogging( SignalR.LogLevel.Information) 

.build(); 

connection.start().then(function () { 
console.logC'connected"); 

}); 


Çapraz kaynak bağlantıları 

Genellikle, tarayıcılar istenen sayfayla aynı etki alanındaki bağlantıları yükler. Ancak, başka bir etki alanına 
bağlantı gerektiğinde bu durumlar vardır. 








Kötü amaçlı bir sitenin başka bir siteden hassas verileri okumasını engellemek için, Çıkış noktaları varsayılan 
olarak devre dışı bırakılır. Bir çapraz kaynak isteğine izin vermek için startup sınıfında etkinleştirin. 



using Microsoft.AspNetCore.Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.Configuration; 

using Microsoft.Extensions.DependencyInjection; 

using SignalRChat.Hubs; 

namespace SignalRChat 

{ 

public class Startup 

{ 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 

Services. AddMvc(); 

Services.AddCors(options => options.AddPolicy("CorsPolicy", 
builder => 

{ 

builder.AllowAnyMethod().AllowAnyHeader() 

.WithOrigins("http://localhost:55830") 
.AllowCredentials(); 

}))J 

Services. AddSignalR(); 

} 

public void Configure(IApplicationBuilder appj IElostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseBrowserl_ink(); 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 
app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 
app.UseCookiePolicy(); 
app.UseCors("CorsPolicy"); 
app.UseSignalR(routes => 

{ 

routes.MapHub<ChatHub>("/chathub"); 

}); 

app.UseMvc(); 

} 

} 

} 



İstemciden çağrı merkezi yöntemleri 

JavaScript istemcileri, Hubconnection'un Invoke yöntemi aracılığıyla hub 'larda ortak yöntemleri çağırır, 
invoke yöntemi iki bağımsız değişkeni kabul eder: 

• Hub yönteminin adı. Aşağıdaki örnekte, hub 'daki Yöntem adı sendMessage . 

• Hub yönteminde tanımlanan bağımsız değişkenler. Aşağıdaki örnekte, bağımsız değişken adı message . 
Örnek kod, Internet Explorer hariç tüm büyük tarayıcıların güncel sürümlerinde desteklenen ok işlev 
sözdizimini kullanır. 

connection.invoke("SendMessage", user, message).catch(err => console.error(err.toString())); 


NOTE 

Azure SignalR hizmetini sunucusuz moddokullanıyorsanız, bir istemciden hub yöntemlerini çağıramezsiniz. Daha fazla bilgi 
için SignalR hizmeti belgelerinebakın. 


invoke yöntemi bir JavaScript Promisedöndürür. Promise , sunucudaki yöntemi döndürdüğünde döndürülen 
değer (varsa) ile çözümlenir. Sunucu üzerindeki yöntem bir hata oluşturursa Promise hata iletisiyle reddedilir. 
Bu durumları (veya await sözdizimini) işlemek için Promise üzerinde then ve catch yöntemlerini kullanın. 

send yöntemi bir JavaScript Promise döndürür, ileti sunucuya gönderildiğinde Promise çözümlenir, ileti 
gönderilirken bir hata oluşursa Promise hata iletisiyle reddedilir. Bu durumları (veya await sözdizimini) 
işlemek için Promise üzerinde then ve catch yöntemlerini kullanın. 


NOTE 

send kullanmak sunucu iletiyi almadan önce beklemez. Sonuç olarak, sunucudan veri veya hata döndürülmesi mümkün 
değildir. 


Hub 'dan istemci yöntemlerini çağır 

Hub 'dan ileti almak için HubConnection on metodunu kullanarak bir yöntemi tanımlayın. 

• JavaScript istemci yönteminin adı. Aşağıdaki örnekte, yöntem adı ReceiveMessage . 

• Hub 'ın yönteme geçirdiği bağımsız değişkenler.Aşağıdaki örnekte, bağımsız değişken değeri message . 

connection.on("ReceiveMessage", (user, message) => { 
const encodedMsg = user + " says " + message; 
const li = document.createElement("li"); 
li.textContent = encodedMsg; 

document .getElementByld("messagesList").appendChild(li); 

}); 

connection.on önceki kod, sunucu tarafı kodu Sendadsync yöntemi kullanılarak çağırdığında çalışır. 

public async Task SendMessagefstring user, string message) 

{ 

await Clients.All.SendAsync("ReceiveMessage", user., message); 

} 


SignalR, sendAsync ve connection.on tanımlanan yöntem adı ve bağımsız değişkenlerle eşleştirerek hangi 





















istemci yönteminin çağrılacağını belirler. 


NOTE 

En iyi uygulama olarak, on sonra Hubconnection Başlangıç yöntemini çağırın. Bunun yapılması, işleyicilerinin herhangi 
bir ileti alınmadan önce kaydolmasını sağlar 


Hata işleme ve günlüğe kaydetme 

istemci tarafı hatalarını işlemek için start yönteminin sonuna bir catch yöntemi zincirleyin. Hataları tarayıcı 
konsoluna çıkarmak için console.error kullanın. 

connection.start().catch(function (err) { 
return console.error(err.toString()); 

}); 

Bağlantı yapıldığında günlüğe bir günlükçü ve olay türü geçirerek istemci tarafı günlük izlemeyi ayarlayın, 
iletiler, belirtilen günlük düzeyi ve daha yükseği ile günlüğe kaydedilir. Kullanılabilir günlük düzeyleri aşağıdaki 
gibidir: 

• - hata iletileri signalR.LogLevel.Error . Yalnızca Error iletileri günlüğe kaydeder. 

• olası hatalar hakkında - uyarı iletileri signalR.LogLevel.warning . uarning ve Error iletileri günlüğe 
kaydeder. 

• hata olmadan - durum iletileri signalR. LogLevel. Information . Information, Uarning ve Error iletileri 
günlüğe kaydeder. 

• İzleme iletilerini - signalR.LogLevel.Trace . Hub ve istemci arasında taşınan veriler de dahil olmak üzere her 
şeyi günlüğe kaydeder. 

Günlük düzeyini yapılandırmak için Hubconnectionbuilder üzerinde configurelogging yöntemini kullanın, 
iletiler tarayıcı konsoluna kaydedilir. 

const connection = new signalR.HubConnectionBuilder() 

,withUrl("/chatHub") 

.configureLogging(signalR. LogLevel. Information) 

,build(); 


İstemcileri yeniden bağla 

Otomatik olarak yeniden bağlan 

SignalR için JavaScript istemcisi, Hubconnectionbuilder'daki withAutomaticReconnect yöntemi kullanılarak 
otomatik olarak yeniden bağlanacak şekilde yapılandırılabilir. Varsayılan olarak otomatik olarak yeniden 
bağlanmaz. 

const connection = new signalR.HubConnectionBuilder() 

,withUrl("/chatHub") 

,withAutomaticReconnect() 

,build(); 

Hiçbir parametre olmadan, withAutomaticReconnect() her bir yeniden bağlanma denemesini denemeden önce, 
dört başarısız denemeden sonra durdurmadan, istemciyi 0, 2,10 ve 30 saniye bekleyecek şekilde yapılandırır. 

Yeniden bağlanma girişimlerini başlatmadan önce, Hubconnection HubConnectionstate.Reconnecting durumuna 


















geçer ve onciose geri çağırmaları Disconnected , otomatik yeniden bağlanma yapılandırması olmadan 
HubConnection gibi tetikleyerek onreconnecting geri çağırmaları tetikler. Bu, kullanıcıların bağlantının 
kaybedildiği ve Kullanıcı arabirimi öğelerini devre dışı bırakan kullanıcıları uyarma fırsatı sağlar. 

connection.onreconnecting((error) => { 

console.assert(connection.State === s ignalR. HubConnect İonState. Reconnecting); 
document.getElementById("messageInput").disabled = true; 
const li = document.createElement("li"); 

li.textContent = 'Connection lost due to error "${error'}". Reconnecting.'; 
document .getElementByld("messagesList").appendChild(li); 

}); 

istemci ilk dört denemeden sonra başarıyla yeniden bağlanırsa, HubConnection Connected duruma geri 
dönerek onneconnected geri çağırmaları harekete geçer. Bu, kullanıcılara bağlantı yeniden kurulmadığını 
bildirmek için bir fırsat sağlar. 

Bağlantı sunucuya tamamen yeni göründüğünden, onreconnected geri çağırması için yeni bir connectionid 
sunulacaktır. 



connection.onneconnected((connectionid) => { 

console.assert(connection.State === signalR.HubConnectionState.Connected); 

document.getElementById("messageInput").disabled = false; 

const li = document.createElement("li"); 

li.textContent = 'Connection reestablished. Connected with connectionid "${connectionId}".'; 
document .getElementByld("messagesList").appendChild(li); 

}); 

withAutomaticReconnect() , ilk başlatma başarısızlıklarını yeniden denemek için HubConnection yapılandırmaz, 
bu nedenle başlatma hatalarının el ile işlenmesi gerekir: 

async function start() { 
tny { 

await connection.start(); 

console.assert(connection.State === signalR.HubConnectionState.Connected); 
console.log("connected"); 

} catch (err) { 

console.assert(connection.State === sİgnalR. HubConnectİonState.Disconnected); 

console.log(err); 

setTimeout(() => start(), 5000); 

} 

}; 

istemci ilk dört denemeden sonra başarıyla yeniden bağlanmazsa, HubConnection Disconnected durumuna 
geçer ve OnCIose geri aramalarını harekete geçirebilir. Bu, kullanıcılara bağlantının kalıcı olarak 
kaybedilmediğini bildirme ve sayfayı yenilemeyi önerme olanağı sağlar: 


















connection.onclose((error) => { 

console.assert(connection.State === signalR.HubConnectionState.Disconnected); 
document.getElementById("messageInput").disabled = true; 
const li = document.createElement("li"); 

li.textContent = 'Connection closed due to error "${error}". Try refreshing this page to restart the 
connection.'; 

document.getElementByld("messagesList").appendChild(li); 

}); 

Bağlantıyı kesmeden veya yeniden bağlanma zamanlamasını değiştirmeden önce özel sayıda yeniden bağlantı 
girişimi yapılandırmak için withAutomaticReconnect , her bir yeniden bağlanma girişimine başlamadan önce 
beklenecek gecikme süresi temsil eden bir sayı dizisini kabul eder. 

const connection = new signalR.HubConnectionBuilder() 

,withUrl("/chatHub") 

.withAutomaticReconnect([0, 0, 10000]) 

.build(); 

// .withAutomaticReconnect([0, 2000, 10000, 30000]) yields the default behavior 

Yukarıdaki örnek, bağlantı kaybolduktan hemen sonra yeniden bağlanmaya başlamak için HubConnection 
yapılandırır. Bu, varsayılan yapılandırma için de geçerlidir. 

ilk yeniden bağlantı girişimi başarısız olursa, ikinci yeniden bağlanma denemesi de varsayılan yapılandırmada 
olduğu gibi 2 saniye beklemek yerine hemen başlatılır. 

ikinci yeniden bağlantı girişimi başarısız olursa, üçüncü yeniden bağlanma denemesi varsayılan yapılandırma 
gibi 10 saniye içinde başlar. 

Özel davranış daha sonra varsayılan şekilde yeniden bağlantı kurmayı denemek yerine, üçüncü yeniden 
bağlantı girişimi başarısızlığından sonra varsayılan davranıştan sonra yeniden bir kez daha fazla yeniden 
bağlantı kurmaya çalışır. 

Otomatik yeniden bağlanma denemelerinin zamanlaması ve sayısı üzerinde daha fazla denetime sahip olmak 
istiyorsanız wlthAutomaticReconnect , nextRetryDelayInMilliseconds adil tek bir yönteme sahip IRetryPolicy 
arabirimini uygulayan bir nesneyi kabul eder. 

nextR 0 tnyDeiayinMiiiiseconds RetnyContext türünde tek bir bağımsız değişken alır. RetryContext üç özelliğe 
sahiptir: previousRetryCount , elapsedMilliseconds ve retryReason number , number ve Error |. İlk yeniden 
bağlanma denemesinden Önce, hem previousRetryCount hem de elapsedMilliseconds sıfır olur ve 
retryReason bağlantının kaybolmasına neden olan hata olacaktır. Her başarısız yeniden deneme denemesinden 
previousRetryCount , elapsedMilliseconds bir kez artırılır, bu, şimdiye kadar geçen süre (milisaniye olarak) ve 
retryReason son yeniden bağlanma denemesinin başarısız olmasına neden olacak hata miktarını yansıtacak 
şekilde güncelleştirilir. 

nextRetryDeiayinMiiiiseconds , sonraki yeniden bağlanma girişiminden önce beklenecek milisaniye sayısını 
temsil eden bir sayı döndürmelidir veya HubConnection yeniden bağlamayı durdurması gerekiyorsa nuiı . 















const connection = new signalR.HubConnectionBuilder() 

.withUrl("/chatHub") 

,withAutomaticReconnect({ 

nextRetryDelayInMilliseconds: retryContext => { 
if (retryContext.elapsedMilliseconds < 60000) { 

// If we've been reconnecting for less than 60 seconds so far, 

// wait between 0 and 10 seconds before the next reconnect attempt. 
return Math.random() * 10000; 

} else { 

// If we’ve been reconnecting for more than 60 seconds so far, stop reconnecting. 
return null; 

} 

}) 

,build(); 


Alternatif olarak, el ile yeniden bağlanmabölümünde gösterildiği gibi istemcinizi el ile yeniden bağlayacaksınız. 

El ile yeniden bağlan 

VVARNING 

3,0 ' den önce SignalR JavaScript istemcisi otomatik olarak yeniden bağlanmaz, istemcinizi el ile yeniden bağlayacaksınız 
kodu yazmanız gerekir. 


Aşağıdaki kod, genel bir el ile yeniden bağlantı yaklaşımını göstermektedir: 

1. Bir işlev (Bu durumda start işlevi) bağlantıyı başlatmak için oluşturulur. 

2. Bağlantının onciose olay işleyicisinde start işlevini çağırın. 

async function start() { 
try { 

await connection.start(); 
console.log("connected"); 

} catch (err) { 

console.log(err); 

setTimeout(() => start(), 5000); 

} 

}; 

connection.onclose(async () => { 
await start(); 

}); 


Gerçek dünyada bir uygulama, bir üstel geri kapatmayı kullanır veya vermeden önce belirtilen sayıda kez 
yeniden dener. 

Ek kaynaklar 

• JavaScript API'si başvurusu 

• JavaScript öğreticisi 

• VVebPack ve TypeScript öğreticisi 

• Merkezler 

• .N ET istemcisi 

• Azure'a Yayımlama 

• Çıkış noktaları arası İstekler (CORS) 

• Azure SignalR hizmeti sunucusuz belgeler 









ASPNET Core SignalR barındırma ve ölçeklendirme 

13.11.2019 *8 minutes to read ı Edjt Online 


, Andrevv Stanton-nuri, Brady Gasterve Tom Dykstra, 

Bu makalede, ASP.NET Core SignalRkullanan yüksek trafik uygulamalarına yönelik barındırma ve ölçeklendirme 
konuları açıklanmaktadır. 

Yapışkan oturumlar 

SignalR, belirli bir bağlantı için tüm HTTP isteklerinin aynı sunucu işlemi tarafından işlenmesini gerektirir.Sunucu 
grubunda (birden çok sunucu) SignalR çalıştığında, "yapışkan oturumlar" kullanılmalıdır. "Yapışkan oturumlar", bazı 
yük dengeleyiciler tarafından oturum benzeşimi olarak da adlandırılır. Azure App Service istekleri yönlendirmek 
için uygulama İsteği yönlendirme (ARR) kullanır.Azure App Service "ARR benzeşimi" ayarının etkinleştirilmesi 
"yapışkan oturumlar" sağlayacaktır. Yapışkan oturumların gerekmediği tek koşullar şunlardır: 

1. Tek bir sunucuda barındırırken, tek bir işlemde. 

2. Azure SignalR hizmetini kullanırken. 

3. Tüm istemciler yalnızca VVebSockets kullanacak şekilde yapılandırıldığında ve istemci yapılandırmasında 

skipanlaşma ayarı etkinse. 

Tüm diğer koşullarda (Redsıs geri düzlemi kullanıldığında dahil), sunucu ortamının yapışkan oturumlar için 
yapılandırılması gerekir. 

SignalRiçin Azure App Service yapılandırma hakkında yönergeler için bkz. Azure App Service için ASP.NET Core 
SignalR uygulaması yayımlama. 

TCP bağlantı kaynakları 

Bir Web sunucusunun destekleyebileceği eşzamanlı TCP bağlantısı sayısı sınırlıdır.Standart HTTP istemcileri, kisa 
ömürlü bağlantıları kullanır. Bu bağlantılar, istemci boşta kaldığında ve daha sonra yeniden açıldığı zaman 
kapatılabilir. Öte yandan, SignalR bir bağlantı kaUcıdir. SignalR bağlantılar, istemci boşta kaldığında bile açık kalır. 
Çok sayıda istemciye hizmet veren yüksek trafikli bir uygulamada, bu kalıcı bağlantılar sunucuların en fazla 
bağlantı sayısına ulaşmasına neden olabilir. 

Kalıcı bağlantılar, her bağlantıyı izlemek için ek bellek de tüketir. 

SignalR göre bağlantıyla ilgili kaynakların ağır kullanımı, aynı sunucuda barındırılan diğer Web uygulamalarını 
etkileyebilir. SignalR açılıp en son kullanılabilir TCP bağlantılarını tutuyorsa, aynı sunucudaki diğer Web 
uygulamalarına da daha fazla bağlantı bulunmaz. 

Sunucuda bağlantı biterse rastgele yuva hataları ve bağlantı sıfırlama hataları görürsünüz. Örneğin: 

An attempt was made to access a Socket in a way forbidden by its access permissions... 

SignalR kaynak kullanımını diğer Web uygulamalarındaki hatalara neden olacak şekilde korumak için, diğer Web 
uygulamalarınızdan farklı sunucularda SignalR çalıştırın. 

SignalR kaynak kullanımını SignalR uygulamasında hatalara neden olacak şekilde korumak için, bir sunucunun 
işleyeceği bağlantı sayısını sınırlamak üzere ölçeği ölçeklendirin. 





Ölçeklendirme 

SignalR kullanan bir uygulamanın, bir sunucu grubu için sorunlar oluşturan tüm bağlantılarını izlemesi gerekir. Bir 
sunucu ekleyin ve diğer sunucuların hakkında bilgi sahibi olmadığı yeni bağlantıları alır. Örneğin, aşağıdaki 
diyagramdaki her bir sunucuda SignalR diğer sunuculardaki bağlantılardan haberdar değildir. Sunuculardan 
birindeki SignalR tüm istemcilere ileti göndermek istediğinde, ileti yalnızca bu sunucuya bağlı olan istemcilere 
gider. 


Client #1 


Client #2 


Client #3 


[ ~~Ü 

L n(i) User acarson 
Groups: A, B 


Gr 


User Inorman 
Groups B, C 


Client #4 I 


Groups: A, C 

{£) User Ismith 
Groups: A, B 


Client #5 




User njones 
Groups: B, D 



Bu sorunu çözmeye yönelik seçenekler Azure SignalR hizmetidir ve redsıs arkadüzledir. 


Azure SignalR hizmeti 

Azure SignalR hizmeti, arka düzlemi yerine bir ara sunucu, istemci sunucuya bir bağlantı başlattığında, istemci 
hizmete bağlanmak için yeniden yönlendirilir. Bu işlem aşağıdaki diyagramda gösterilmiştir: 


Client 


Authentîcate and connect to App 


( ) Connect to Service 


Send "Redırect" Response 
with Auth Token and URL 


Azure 

SignalR 

Service 


Request Auth Token 


Retum Auth Token 



Sonuç olarak, hizmetin tüm istemci bağlantılarını yönetmesi, her sunucunun aşağıdaki diyagramda gösterildiği gibi 
yalnızca küçük bir sabit bağlantı sayısına ihtiyacı vardır: 


Client 



Bu genişleme yaklaşımına yönelik bu yaklaşım, Redsıs geri düzlemi 'nin diğer avantajlarından biridir: 




































• istemci benzeşimiolarak da bilinen yapışkan oturumlar gerekli değildir, çünkü istemciler, bağlandıklarında Azure 
SignalR hizmetine anında yönlendirilir. 

• SignalR bir uygulama, gönderilen ileti sayısına göre ölçeklenebilir, ancak Azure SignalR hizmeti herhangi bir 
sayıda bağlantıyı işleyecek şekilde otomatik olarak ölçeklendirilir. Örneğin, binlerce istemci olabilir, ancak saniye 
başına yalnızca birkaç ileti gönderiliyorsa, SignalR uygulamanın yalnızca bağlantıları işlemek için birden çok 
sunucuya ölçeklendirilmesi gerekmez. 

• SignalR bir uygulama, SignalRolmayan bir Web uygulamasından daha fazla bağlantı kaynağı kullanmaz. 

Bu nedenlerden dolayı, App Service, VM 'Ler ve kapsayıcılar dahil olmak üzere Azure üzerinde barındırılan tüm 

ASP.NET Core SignalR uygulamaları için Azure SignalR hizmetini öneririz. 

Daha fazla bilgi için bkz. Azure SignalR hizmeti belgeleri. 


Redis kartı 


Redsıs , bir yayımlama/abonelik modeliyle bir mesajlaşma sistemini destekleyen bellek içi anahtar-değer 
deposudur. SignalR redin backdüzlemi, iletileri diğer sunuculara iletmek için pub/Sub özelliğini kullanır.istemci bir 
bağlantı yaptığında, bağlantı bilgileri geri düzleme geçirilir. Bir sunucu tüm istemcilere ileti göndermek istediğinde, 
bu geri düzlemi gönderir. Biriktirme listesi, tüm bağlı istemcileri ve bunların hangi sunuculara olduğunu bilir.iletiyi 
ilgili sunucuları aracılığıyla tüm istemcilere gönderir. Bu işlem aşağıdaki diyagramda gösterilmiştir: 
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Redsıs geri düzlemi, kendi altyapınızda barındırılan uygulamalar için önerilen genişleme yaklaşımıdır. Azure 
SignalR hizmeti, veri merkezinizdeki bir Azure veri merkezi arasındaki bağlantı gecikmesi nedeniyle Şirket içi 
uygulamalarla üretim kullanımı için pratik bir seçenek değildir. 

Daha önce bahsedilen Azure SignalR hizmet avantajları Redsıs geri düzlemi için dezavantajlardır: 

• istemci benzeşimiolarak da bilinen yapışkan oturumlar gereklidir. Sunucuda bir bağlantı başlatıldıktan sonra 
bağlantı o sunucuda kalmaya devam etmek zorunda kalır. 

• Birkaç ileti gönderilse bile SignalR bir uygulama, istemci sayısına göre ölçeklendirmelidir. 

• SignalR uygulaması, SignalRolmayan bir Web uygulamasından çok daha fazla bağlantı kaynağı kullanır. 


Sonraki adımlar 

Daha fazla bilgi için aşağıdaki kaynaklara bakın: 


• Azure SignalR hizmeti belgeleri 

• Redsıs geri düzlemi ayarlama 














Azure App Service için ASPNET Core SignalR 
uygulaması yayımlama 

13.11.2019 *4 minutes to read ı Edit Online 


, Brady Gaster tarafından 

Azure App Service , Web uygulamalarını barındırmak için ASP.NET Core dahil olmak üzere bir Microsoft bulut 
bilgi işlem platformu hizmetidir. 

NOTE 

Bu makale, Visual Studio 'dan bir ASP.NET Core SignalR uygulaması yayımlamaya başvurur. Daha fazla bilgi için bkz. Azure 
içinSignalR hizmeti. 


Uygulamayı yayımlama 

Bu makalede, Visual Studio 'daki araçları kullanarak yayımlama ele alınmaktadır. Visual Studio Code 
kullanıcılar, Azure 'da uygulama yayımlamak için Azure CLI komutlarını kullanabilir. Daha fazla bilgi için bkz. 

komut satırı araçlarıyla Azure 'da AS P.N ET Core uygulama yayımlama. 

1 . Çözüm Gezgini projede projeye sağ tıklayın ve Yayımla' yı seçin. 

2. Bir yayımlama hedefi seç iletişim kutusunda App Service ve Yeni oluştur ' un seçili olduğunu 
doğrulayın. 

3. Yayımla düğmesi açılan listesinden Profil oluştur ' u seçin. 

App Service oluştur iletişim kutusunda aşağıdaki tabloda açıklanan bilgileri girin ve Oluştur' u seçin. 


ÖGE 

AÇIKLAMA 

Ad 

Uygulamanın benzersiz adı. 

Aboneliğiniz 

Uygulamanın kullandığı Azure aboneliği. 

Kaynak grubu 

Uygulamanın ait olduğu ilgili kaynaklar grubu. 

Barındırma planı 

Web uygulaması için fiyatlandırma planı. 


4. Bağımlılıklar > Ekle açılan listesinden Azure SignalR hizmetini seçin: 


Dependencies 

^ Add ▼ 

No dependencies currently configured, please click 'Add' to connect to additional Services. 

Azure SignalR Service 

Azure SQL Database 

Azure Storage 


5. Azure SignalR hizmeti iletişim kutusunda yeni bir Azure SignalR hizmet örneği oluştur' u seçin. 

6. Bir ad, kaynak grubuve konumbelirtin. Azure SignalR hizmeti iletişim kutusuna dönün ve Ekle' yi 


seçin. 











Visual Studio aşağıdaki görevleri tamamlar: 


• Yayımlama ayarlarını içeren bir yayımlama profili oluşturur. 

• Belirtilen ayrıntılarla bir Azure Web uygulaması oluşturur. 

• Uygulamayı yayımlar. 

• Web uygulamasını yükleyen bir tarayıcı başlatır. 



Bir Previevv .NET Core sürümünü hedefleyen bir uygulama dağıtırken HTTP 502,2-Hatalı ağ geçidi hatası 
oluşursa, bu sorunu çözmek için Azure App Service ASP.NET Core önizleme sürümünü dağıtma bölümüne 
bakın. 

Uygulamayı Azure App Service yapılandırma 


NOTE 

Bu bölüm yalnızca Azure SignalR hizmetini kullanmayan uygulamalar için geçerlidir. 

Uygulama Azure SignalR hizmetini kullanıyorsa, App Service uygulama İsteği yönlendirme (ARR) benzeşimi ve bu 
bölümde açıklanan Web Yuvalan yapılandırmasını gerektirmez, istemciler Web yuvalarını doğrudan uygulamaya değil 
Azure SignalR hizmetine birbirine bağlayamıyor. 


Azure SignalR hizmeti olmadan barındırılan uygulamalar için şunları etkinleştirin: 

• istekleri bir kullanıcıdan tekrar aynı App Service örneğine yönlendirmek için ARR benzeşimi. Varsayılan 
ayar Açık 'dır. 

• Web Sockets taşımanın çalışmasına izin veren Web Yuvaları . Varsayılan ayar kapalıdır. 

1. Azure portal, uygulama hizmetleri' nde Web uygulamasına gidin. 

2. Yapılandırma > genel ayarları' nı açın. 

3. Web yuvalarını Açıkolarak ayarlayın. 

4. ARR benzeşiminin Açıkolarak ayarlandığını doğrulayın. 

App Service planı limitleri 

Web Yuvaları ve diğer aktarımlar, seçilen App Service planına göre sınırlandırılır.Daha fazla bilgi için Azure 
abonelik ve hizmet sınırları, Kotalar ve kısıtlamalar makalesinin Azure Cloud Services sınırları ve App Service 
sınırları bölümlerine bakın. 

Ek kaynaklar 

• Azure SignalR hizmeti nedir? 

• ASP.NET Core SignalR giriş 

• ASP.NET Core barındırma ve dağıtma 

• Visual Studio ile Azure'a bir ASP.N ET Core uygulaması yayımlama 

• Komut satırı araçlarıyla Azure 'da ASP.NET Core uygulaması yayımlama 

• Azure 'da ASP.NET Core Previevv uygulamaları barındırma ve dağıtma 






ASRNET Core SignalR genişleme için Redsıs arka 
düzlemi ayarlama 
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, Andrevv Stanton-nuri, Brady Gasterve Tom Dykstra, 

Bu makalede, bir ASP.NET Core SignalR uygulamasını ölçeklendirmek için kullanılacak bir redo sunucusu 
ayarlamanın SignalRözgü yönleri açıklanmaktadır. 

Redsıs geri düzlemi ayarlama 

• Redsıs sunucusunu dağıtın. 


IMPORTANT 

Üretim kullanımı için, yalnızca SignalR uygulamasıyla aynı veri merkezinde çalıştığında Redsıs geri düzlemi önerilir. Aksi 
takdirde, ağ gecikmesi performansı düşürür. SignalR uygulamanız Azure bulutu 'nda çalışıyorsa, redin geri düzlemi 
yerine Azure SignalR hizmeti önerilir. Geliştirme ve test ortamları için Azure Redis Cache hizmetini kullanabilirsiniz. 


Daha fazla bilgi için aşağıdaki kaynaklara bakın: 

o ASP.NET Core SignalR üretim barındırma ve ölçeklendirme 
o Redsıs belgeleri 
o Azure Redis Cache belgeleri 

• SignalR uygulamasında Microsoft.AspNetcore.SignalR.Redis NuGet paketini () yüklemeksiniz. 

• startup.configureServices yönteminde, AddSignalR sonra AddRedis çağırın: 

Services.AddSignalR().AddRedis("<your_Redis_connection_string>"); 

• Seçenekleri gerektiği şekilde yapılandırın: 

Çoğu seçenek bağlantı dizesinde veya ConfigurationOptions nesnesinde ayarlanabilir. 
configurationOptions belirtilen seçenekler bağlantı dizesinde ayarlanmış olanları geçersiz kılar. 

Aşağıdaki örnek, ConfigurationOptions nesnesindeki seçeneklerin nasıl ayarlanacağını gösterir. Bu örnek, 
aşağıdaki adımda anlatıldığı gibi birden çok uygulamanın aynı redo örneğini paylaşabilmesi için bir kanal 
öneki ekler. 

Services. AddSignalR() 

.AddRedisfconnectionString, options => { 

options.Configuration.ChannelPrefix = "MyApp"; 

}); 

Yukarıdaki kodda options.configuration , bağlantı dizesinde belirtilen şeyle başlatılır. 

• SignalR uygulamasında, aşağıdaki NuGet paketlerinden birini yüklemeksiniz: 

o Microsoft.AspNetcore.SignalR.stackExchangeRedis -StackExchange 'e bağlıdır. Redsıs 2. X.X.Bu, ASP.NET 
Core 2,2 ve üzeri için önerilen pakettir. 














o Microsoft.AspNetcore.signaiR.Redis -StackExchange. Redsıs 1. X.X. 'e bağımlıdır Bu paket ASP.NET Core 
3,0 ve üzeri bir sürüme dahil değildir. 

• startup.configureServices yönteminde, AddStackExchangeRedisçağırın: 

Services .AddSignalR().AddStackExchangeRedis("<your_Redis_connection_string>")t 

Microsoft.AspNetcore.SignaiR.Redis kullanırken AddRedisçağırın. 

• Seçenekleri gerektiği şekilde yapılandırın: 

Çoğu seçenek bağlantı dizesinde veya ConfigurationOptions nesnesinde ayarlanabilir. 
configurationOptions belirtilen seçenekler bağlantı dizesinde ayarlanmış olanları geçersiz kılar. 

Aşağıdaki örnek, ConfigurationOptions nesnesindeki seçeneklerin nasıl ayarlanacağını gösterir. Bu örnek, 
aşağıdaki adımda anlatıldığı gibi birden çok uygulamanın aynı redo örneğini paylaşabilmesi için bir kanal 
öneki ekler. 

Services.AddSignalR() 

.AddStackExchangeRedis(connectionString., options => { 
options.Configuration.ChannelPrefix = "MyApp"; 

}); 

Microsoft.AspNetcore.SignaiR.Redis kullanırken AddRedisçağırın. 

Yukarıdaki kodda options.configuration , bağlantı dizesinde belirtilen şeyle başlatılır. 

Redu seçenekleri hakkında daha fazla bilgi için bkz. StackExchange redin belgeleri. 

• SignaiR uygulamasında, aşağıdaki NuGet paketini yüklerken: 

o Microsoft.AspNetcore.SignaiR.StackExchangeRedis 

• Startup.configureServices yönteminde, AddStackExchangeRedisçağırın: 

Services.AddSignalR().AddStackExchangeRedis("<your_Redis_connection_string>"); 

• Seçenekleri gerektiği şekilde yapılandırın: 

Çoğu seçenek bağlantı dizesinde veya ConfigurationOptions nesnesinde ayarlanabilir. 

ConfigurationOptions belirtilen seçenekler bağlantı dizesinde ayarlanmış olanları geçersiz kılar. 

Aşağıdaki örnek, ConfigurationOptions nesnesindeki seçeneklerin nasıl ayarlanacağını gösterir. Bu örnek, 
aşağıdaki adımda anlatıldığı gibi birden çok uygulamanın aynı redo örneğini paylaşabilmesi için bir kanal 
öneki ekler. 

Services.AddSignalR() 

.AddStackExchangeRedis(connectionString, options => { 
options.Configuration.ChannelPrefix = "MyApp"j 
})J 

Yukarıdaki kodda options.configuration , bağlantı dizesinde belirtilen şeyle başlatılır. 

Redu seçenekleri hakkında daha fazla bilgi için bkz. StackExchange redin belgeleri. 

• Birden çok SignaiR uygulama için bir Redsıs sunucusu kullanıyorsanız, her bir SignaiR uygulaması için farklı 
bir kanal öneki kullanın. 














Kanal öneki ayarlamak, farklı kanal öneklerini kullanan diğerlerinden bir SignalR uygulamasını yalıtır. Farklı 
ön ekler atamadıysanız, bir uygulamadan tüm istemcilerine gönderilen bir ileti, Redo sunucusunu bir geri 
düzlemi olarak kullanan tüm uygulamaların tüm istemcilerine gider. 

• Sunucu grubu yük dengeleme yazılımınızı yapışkan oturumlar için yapılandırın. Bunun nasıl yapılacağını 
gösteren bazı örnekler aşağıda verilmiştir: 

o ISS 
o FIAProxy 
o NGINX 
o pfSense 

Redsıs sunucu hataları 

Bir redin sunucusu aşağı gittiğinde SignalR, iletilerin teslim edilmediğini belirten özel durumlar oluşturur. Bazı tipik 
özel durum iletileri: 

• ileti yazıla m a di 

• ' MethodName ' hub yöntemi çağrılamadı 

• Redsıs bağlantısı başarısız oldu 

SignalR, sunucu geri geldiğinde iletileri göndermek için arabelleğe almaz. Redsıs sunucusu kapatıldığında 
gönderilen iletiler kaybedilir. 

Redi sunucusu yeniden kullanılabilir olduğunda SignalR otomatik olarak yeniden bağlanır. 

Bağlantı hatalarıyla ilgili özel davranış 

Redsıs bağlantı hatası olaylarının nasıl işleneceğini gösteren bir örnek aşağıda verilmiştir. 

Services.AddSignalR() 

.AddRedis(o => 

{ 

o.ConnectionFactory = async writer => 

{ 

var config = new ConfigurationOptions 
{ 

AbortOnConnectFail = false 

}; 

config.EndPoints.Add(IPAddress.Loopback, 0); 
config.SetDefaultPorts(); 

var connection = await ConnectionMultiplexer.ConnectAsync(configj writer); 
connection.ConnectionFailed += e) => 

{ 

Console.WriteLine("Connection to Redis failed."); 

}; 

if (Iconnection.IsConnected) 

{ 

Console.WriteLine("Did not connect to Redis."); 

} 

return connection; 

}; 

}); 



Services.AddSignalR() 

.AddMessagePackProtocol() 

.AddStackExchangeRedis(o => 

{ 

o.ConnectionFactory = async writer => 

{ 

var config = new ConfigurationOptions 
{ 

AbortOnConnectFail = false 

}; 

config.EndPoints.Add(IPAddress.Loopbackj 0); 
config.SetDefaultPorts(); 

var connection = await ConnectionMultiplexer.ConnectAsync(configj writer); 
connection.ConnectionFailed += (_, e) => 

{ 

Console.Writel_ine("Connection to Redis failed."); 

}; 

if (!connection.IsConnected) 

{ 

Console.WriteLine("Did not connect to Redis."); 

} 

return connection; 

}; 

}); 


Redsıs Kümelemesi 

Redsıs Kümelemesi, birden çok redo sunucusu kullanarak yüksek kullanılabilirlik elde etmek için kullanılan bir 
yöntemdir. Kümeleme resmi olarak desteklenmez, ancak çalışmayabilir. 

Sonraki adımlar 

Daha fazla bilgi için aşağıdaki kaynaklara bakın: 

• ASP.NET Core SignalR üretim barındırma ve ölçeklendirme 

• Redsıs belgeleri 

• StackExchange redin belgeleri 

• Azure Redis Cache belgeleri 



Arka plan hizmetlerinde ana bilgisayar ASPNET Core 
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, Brady Gaster tarafından 

Bu makalede şu yönergelere kılavuzluk sunulmaktadır: 

• ASP.NET Core ile barındırılan arka plan çalışan işlemini kullanarak SignalR hub 1 Ları barındırma. 

• .NET Core Backgroundserviceiçinden bağlı istemcilere ileti gönderme. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Başlangıç sırasında SignalR 

Arka plan çalışan işleminin bağlamında ASP.NET Core SignalR hub 'Ları barındırmak, bir ASP.NET Core Web 
uygulamasındaki hub barındırmakla aynıdır. startup.configureServices yönteminde, Services.AddSignaiR 
çağırmak gereken hizmetleri SignalRdesteklemek için ASP.NET Core bağımlılık ekleme (dı) katmanına ekler, 
startup.configure , MapHub yöntemi, ASP.NET Core isteği ardışık düzeninde Merkez uç noktaları arasında bağlantı 
kurmak için useEndpoints geri çağırmada çağrılır. 

public class Startup 
{ 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services. AddSignaiR(); 

Services.AddHostedService<Worker >(); 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

app.UseRouting(); 
app.UseEndpoints(endpoints => 

{ 

endpoints.MapHub<ClockHub>("/hubs/clock"); 

}); 

} 

} 

Arka plan çalışan işleminin bağlamında ASP.NET Core SignalR hub 'Ları barındırmak, bir ASP.NET Core Web 
uygulamasındaki hub barındırmakla aynidir. Startup.configureServices yönteminde, Services.AddSignaiR 
çağırmak gereken hizmetleri SignalRdesteklemek için ASP.NET Core bağımlılık ekleme (dı) katmanına ekler, 
startup.configure , useSignaiR yöntemi ASP.NET Core isteği ardışık düzeninde hub uç noktaları için çağrılır. 












public class Startup 
{ 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services. AddSignalR(); 

Services.AddHostedService<Worker>(); 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

app.UseSignalR((routes) => 

{ 

routes.MapHub<ClockHub>("/hubs/clock"); 

}); 

} 

} 

Yukarıdaki örnekte ciockHub sınıfı, türü kesin belirlenmiş bir hub oluşturmak için Hub<T> sınıfını uygular. 
ciockHub , uç nokta /hubs/ciock isteklere yanıt vermek için startup sınıfında yapılandırıldı. 


Türü kesin belirlenmiş hub 'Lar hakkında daha fazla bilgi için bkz. SignalR hub 1 ları ASP.NET Core İçin kullanma. 



{ 

public async Task SendTimeToClients(DateTime dateTime) 

{ 

await Clients.Ali.ShowTime(dateTime); 

} 

} 

Türü kesin belirlenmiş ciockHub tarafından kullanılan arabirim ıciock arabirimidir. 


public interface IClock 
{ 

Task ShowTime(DateTime currentTime); 

} 


Arka plan hizmetinden bir SignalR hub 'ı çağırma 

Başlangıç sırasında, BackgroundService"Worker sınıfı AddHostedService kullanılarak bağlanır. 

Services.AddHostedService<Worker>(); 

SignalR, her hub 1 ın, ASP.NET Core HTTP isteği ardışık düzeninde tek bir uç noktaya eklendiği startup 
aşamasında da kablolu olduğundan, her hub sunucu üzerinde bir iHubContext<T> temsil edilir. ASP.NET Core dı 
özelliklerini kullanarak, barındırma katmanı tarafından oluşturulan BackgroundService sınıflar, MVC denetleyici 
sınıfları veya Razor sayfa modelleri gibi diğer sınıflar, oluşturma sırasında iHubContext<ciockHub, ıciock> 



















örneklerini kabul ederek sunucu tarafı hub 'Larına başvurular alabilir. 


public class Worker : BackgroundService 
{ 

private readonly ILogger<Worker> _logger; 

private readonly IHubContext<ClockHub, IClock> _clockHub; 

public Worker(ILogger<Worker> logger, IHubContext<ClockHub, IClock> clockHub) 

{ 

_logger = logger; 

_clockHub = clockHub; 

} 

protected override async Task ExecuteAsync(CancellationToken stoppingToken) 

{ 

while (!stoppingToken.IsCancellationRequested) 

{ 

_logger.LogInformation("Worker running at: {Time}", DateTime.Now); 
await _clockHub.Clients.Ali.ShowTime(DateTime.Now); 
await Task.Delay(1000); 

} 

} 

} 

ExecuteAsync yöntemi arka plan hizmetinde yinelemeli olarak çağrıldığı için, sunucunun geçerli tarih ve saati 
ClockHub kullanılarak bağlı istemcilere gönderilir. 

Arka plan hizmetleriyle SignalR olaylara tepki verme 

SignalR veya bir .NET masaüstü uygulamasının JavaScript istemcisini kullanan tek sayfalı bir uygulama gibi .NET 
Client ASP.NET Core SignalRkullanarak kullanarak BackgroundService veya iHostedService bir uygulama da 
SignalR hub 'Larına bağlanıp olaylara yanıt vermek için kullanılabilir. 


ClockHubClient 

sınıfı hem 

IClock 

arabirimini hem de 

IHostedService 

arabirimini uygular. Bu şekilde, 

Startup 


sırasında, sürekli olarak çalışmak ve sunucudan hub olaylarına yanıt vermek için bu şekilde kablolu bir şekilde 
erişilebilir. 

public partial class ClockHubClient : IClock, IHostedService 
{ 

} 

Başlatma sırasında ClockHubClient , bir HubConnection örneğini oluşturur ve hub'ın showTime olayı için işleyici 
olarak ıciock.showTime metodunu kablodan bir şekilde kablolar. 














private readonly ILogger<ClockHubClient> _logger; 
private HubConnection _connection; 

public ClockHubClient(ILogger<ClockHubClient> logger) 

{ 

_logger = logger; 

_connection = new HubConnectionBullder() 

.WithUrl(Strings.HubUrl) 

.Build(); 

_connection.On<DateTime>(Strings.Events.TimeSent , 
dateTime => _ = ShowTime(dateTime)); 

} 

public Task ShowTime(DateTime currentTime) 

{ 

_logger.LogInformation("{CurrentTime }", currentTime.ToShortTimeString()); 
return Task.CompletedTask; 

} 

iHostedService.startAsync uygulamasında HubConnection zaman uyumsuz olarak başlatılır. 

public async Task StartAsync(CancellationToken cancellationToken) 

{ 

// Loop is here to wait until the server is running 
while (true) 

{ 

try 

{ 

await _connection.StartAsync(cancellationToken); 
break; 

} 

catch 

{ 

await Task.Delay(1000); 

} 

} 

} 



Ek kaynaklar 

• Kullanmaya başlama 

• Merkezler 

• Azure'a Yayımlama 

• Türü kesin belirlenmiş hub'Lar 
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JSON/MessagePack serileştirme seçenekleri 

ASP.NET Core SignalR iletileri kodlamak için iki protokolü destekler: JSON ve MessagePack. Her protokol 
serileştirme yapılandırma seçenekleri vardır. 

JSON serileştirme, Addjsonprotocol genişletme yöntemi kullanılarak sunucuda yapılandırılabilir. AddDsonProtocoi , 
startup.configureServices Addsignalr öğesinden sonra eklenebilir. AddusonProtocoi yöntemi, options nesnesini 
alan bir temsilciyi alır. Bu nesnedeki Payloadserializeroptions özelliği, bağımsız değişkenlerin serileştirmesini ve 
dönüş değerlerini yapılandırmak için kullanılabilen bir System.Text.Dson JsonSerializerOptions nesnesidir. Daha 
fazla bilgi için bkz. System. Text. JSON belgeleri. 

Örnek olarak, serileştiriciyi varsayılan "camelCase" adları yerine özellik adlarının büyük küçük harflerini 
değiştirmemelidir şekilde yapılandırmak için, Startup.configureServices içinde aşağıdaki kodu kullanın: 

Services .AddSignalR() 

.AddisonProtocol(options => { 

options.Payloadserializeroptions.PropertyNamingPolicy = null 

}); 

.NET istemcisinde aynı AddisonProtocoi uzantısı yöntemi Hubconnectionbuilderüzerinde bulunur. Uzantı 
metodunu çözümlemek için Microsoft.Extensions.Dependencyinjection ad alanı içeri aktarılmalıdır: 

// At the top of the file: 

using Microsoft.Extensions.Dependencylnjection; 

// When constructing your connection: 
var connection = new HubConnectionBuilder() 

.AddlsonProtocol(options => { 

options.Payloadserializeroptions.PropertyNamingPolicy = nullj 

}) 

.Build(); 


NOTE 

JavaScript istemcisinde Şu anda JSON serileştirme yapılandırmak mümkün değildir. 


Nevvtonsoft. JSON öğesine geç 

System.Text.Json desteklenmeyen Newtonsoft.ison özelliklerine ihtiyacınız varsa, bkz. Nevvtonsoft. JSON öğesine 
geçme. 

JSON serileştirme, Startup.configureServices yönteminizin Addsignalr öğesinden sonra eklenebilecek 
addjsonprotocol genişletme yöntemi kullanılarak sunucuda yapılandırılabilir. AddisonProtocoi yöntemi, options 
nesnesini alan bir temsilciyi alır. Bu nesnedeki Payloadserializersettings özelliği, bağımsız değişkenlerin 
serileştirmesini ve dönüş değerlerini yapılandırmak için kullanılabilen bir JSON.net isonSeriaiizerSettings 
nesnesidir. Daha fazla bilgi için JSON.net belgelerinebakın. 

Örnek olarak, serileştiriciyi varsayılan "camelCase" adları yerine "PascalCase" özellik adlarını kullanacak şekilde 
yapılandırmak için, Startup.configureServices ' de aşağıdaki kodu kullanın: 





















Services.AddSignalR() 

.AddisonProtocol(options => { 

options.PayloadSerializerSettings.ContractResolver = 
new DefaultContractResolver(); 

}); 

.NET istemcisinde aynı AddtsonProtocoi uzantısı yöntemi Hubconnectionbuilderüzerinde bulunur. Uzantı 
metodunu çözümlemek için Microsoft.Extensions.Dependencyinjection ad alanı içeri aktarılmalıdır: 

// At the top of the file: 

using Microsoft.Extensions.Dependencylnjection; 

// When constructing your connection: 
var connection = new HubConnectionBuilder() 

.Add3sonProtocol(options => { 

options.PayloadSerializerSettings.ContractResolver = 
new DefaultContractResolver(); 

}) 

.Build(); 



MessagePack serileştirme seçenekleri 

MessagePack serileştirme, Addmessagepackprotocol çağrısına bir temsilci sağlanarak yapılandırılabilir. Daha fazla 
bilgi için bkz. SignalRMessagePack . 


NOTE 

Şu anda JavaScript istemcisinde MessagePack serileştirme yapılandırmak mümkün değildir. 


Sunucu seçeneklerini yapılandırma 

Aşağıdaki tabloda SignalR hub 'ları yapılandırmaya yönelik seçenekler açıklanmaktadır: 


SEÇENEK 

VARSAYILAN DEĞER 

AÇIKLAMA 

ClientTimeoutlnterval 

30 saniye 

Sunucu, bu aralıkta (canlı tut dahil) bir 


ileti almamışsa istemcinin bağlantısının 
kesileceğini kabul eder. Bu işlem, 
uygulanması nedeniyle istemcinin 
bağlantısının gerçekten kesilmesinin 
ardından bu zaman aşımı aralığından 
daha uzun sürebilir. Önerilen değer 
KeepAlivelnterval değeri iki katına 
kaydedilir. 










SEÇENEK 


VARSAYILAN DEĞER 


AÇIKLAMA 


HandshakeTimeout 


KeepAlivelnterval 


SupportedProtocols 

EnableDetailedErrors 

StreamBufferCapacity 

MaximumReceiveMessageSize 

SEÇENEK 

ClientTimeoutInterval 


15 saniye istemci bu zaman aralığı içinde bir ilk el 

sıkışma iletisi göndermezse bağlantı 
kapatılır. Bu, yalnızca önemli ağ 
gecikmesi nedeniyle el sıkışma zaman 
aşımı hataları gerçekleşirken 
değiştirilmesi gereken gelişmiş bir 
ayardır. El sıkışma işlemi hakkında daha 
fazla ayrıntı için SignalR hub protokol 
belirtiminebakın. 


15 saniye Sunucu bu Aralık dahilinde bir ileti 

göndermediyse bağlantının açık 
tutulması için bir ping iletisi otomatik 
olarak gönderilir. KeepAlivelnterval 
değiştirilirken, istemcide 

ServerTimeout / 


serverTimeoutlnMilliseconds 

ayarını 

değiştirin. Önerilen 

ServerTimeout / 

serverTimeoutlnMilliseconds 

değeri 


KeepAlivelnterval değeri iki katına 
kaydedilir. 


Tüm yüklü protokoller Bu hub tarafından desteklenen 

protokoller. Varsayılan olarak, sunucuda 
kayıtlı tüm protokollere izin verilir, ancak 
tek tek hub 'lara yönelik belirli 
protokolleri devre dışı bırakmak için 
protokollerin bu listeden kaldırılması 
gerekir. 


false true , bir hub yönteminde özel durum 

oluştuğunda istemcilere ayrıntılı özel 
durum iletileri döndürülür. Varsayılan 
değer false , bu özel durum 
iletilerinde gizli bilgiler bulunabilir. 


18 istemci yükleme akışları için ara belleğe 

oluşturulabilecek en fazla öğe sayısı. Bu 
sınıra ulaşıldığında, sunucu akış öğelerini 
işlemeden, etkinleştirmeleri işleme 
engellenir. 


32 KB 


Tek bir gelen hub iletisinin en büyük 
boyutu. 


VARSAYILAN DEĞER AÇIKLAMA 

30 saniye Sunucu, bu aralıkta (canlı tut dahil) bir 

ileti almamışsa istemcinin bağlantısının 
kesileceğini kabul eder. Bu işlem, 
uygulanması nedeniyle istemcinin 
bağlantısının gerçekten kesilmesinin 
ardından bu zaman aşımı aralığından 
daha uzun sürebilir. Önerilen değer 
KeepAlivelnterval değeri iki katına 
kaydedilir. 
















SEÇENEK 


VARSAYILAN DEĞER 


AÇIKLAMA 


HandshakeTimeout 


KeepAlivelnterval 


SupportedProtocols 

EnableDetailedErrors 

SEÇENEK 

HandshakeTimeout 


15 saniye istemci bu zaman aralığı içinde bir ilk el 

sıkışma iletisi göndermezse bağlantı 
kapatılır. Bu, yalnızca önemli ağ 
gecikmesi nedeniyle el sıkışma zaman 
aşımı hataları gerçekleşirken 
değiştirilmesi gereken gelişmiş bir 
ayardır. El sıkışma işlemi hakkında daha 
fazla ayrıntı için SignalR hub protokol 
belirtiminebakın. 


15 saniye Sunucu bu Aralık dahilinde bir ileti 

göndermediyse bağlantının açık 
tutulması için bir ping iletisi otomatik 
olarak gönderilir. KeepAlivelnterval 
değiştirilirken, istemcide 

ServerTimeout / 


serverTimeoutlnMilliseconds 

ayarını 

değiştirin. Önerilen 

ServerTimeout / 

serverTimeoutlnMilliseconds 

değeri 


KeepAlivelnterval değeri iki katına 
kaydedilir. 


Tüm yüklü protokoller Bu hub tarafından desteklenen 

protokoller. Varsayılan olarak, sunucuda 
kayıtlı tüm protokollere izin verilir, ancak 
tek tek hub 'lara yönelik belirli 
protokolleri devre dışı bırakmak için 
protokollerin bu listeden kaldırılması 
gerekir. 


false true , bir hub yönteminde özel durum 

oluştuğunda istemcilere ayrıntılı özel 
durum iletileri döndürülür. Varsayılan 
değer false , bu özel durum 
iletilerinde gizli bilgiler bulunabilir. 


VARSAYILAN DEĞER AÇIKLAMA 

15 saniye istemci bu zaman aralığı içinde bir ilk el 

sıkışma iletisi göndermezse bağlantı 
kapatılır. Bu, yalnızca önemli ağ 
gecikmesi nedeniyle el sıkışma zaman 
aşımı hataları gerçekleşirken 
değiştirilmesi gereken gelişmiş bir 
ayardır. El sıkışma işlemi hakkında daha 
fazla ayrıntı için SignalR hub protokol 
belirtiminebakın. 












SEÇENEK 


VARSAYILAN DEĞER 


AÇIKLAMA 


KeepAliveinterval 15 saniye Sunucu bu Aralık dahilinde bir ileti 

göndermediyse bağlantının açık 
tutulması için bir ping iletisi otomatik 
olarak gönderilir. KeepAliveinterval 
değiştirilirken, istemcide 

ServerTimeout / 


ServerTimeoutInMilliseconds 

ayarını 

değiştirin. Önerilen 

ServerTimeout / 

serverTimeoutlnMilliseconds 

değeri 


KeepAliveinterval değeri iki katına 
kaydedilir. 


supportedProtocols Tüm yüklü protokoller Bu hub tarafından desteklenen 

protokoller Varsayılan olarak, sunucuda 
kayıtlı tüm protokollere izin verilir, ancak 
tek tek hub ’lara yönelik belirli 
protokolleri devre dışı bırakmak için 
protokollerin bu listeden kaldırılması 
gerekir 


EnableDetailedErrors false true , bir hub yönteminde özel durum 

oluştuğunda istemcilere ayrıntılı özel 
durum iletileri döndürülür. Varsayılan 
değer false , bu özel durum 
iletilerinde gizli bilgiler bulunabilir. 

Seçenekler, startup.configureServices"AddSignaiR çağrısına bir seçenek temsilcisi sağlayarak tüm Hub ' lar için 
yapılandırılabilir. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services .AddSignalR(hubOptions => 

{ 

hubOptions.EnableDetailedErrors = true; 

hubOptions.KeepAliveinterval = TimeSpan.FromMinutes(l); 

}); 

} 

Tek bir hub için seçenekler, AddSignaiR belirtilen genel seçenekleri geçersiz kılar ve AddHubOptionskullanılarak 
yapılandırılabilir: 

Services .AddSignalR().AddHubOptions<MyHub>(options => 

{ 

options.EnableDetailedErrors = true; 

}); 


Gelişmiş HTTP yapılandırma seçenekleri 

Aktarımlara ve bellek arabelleği yönetimine ilişkin gelişmiş ayarları yapılandırmak için 
HttpConnectionDispatcherOptions kullanın. Bu seçenekler, startup.configure > Maphubct 'ye bir temsilci 
geçirilerek yapılandırılır. 















public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

app.UseRouting(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapHub<MyHub>("/myhub", options => 

{ 

options.Transports = 

HttpTransportType.WebSockets | 

HttpTransportType.LongPolling; 

}); 

}); 

} 


Aktarımlara ve bellek arabelleği yönetimine ilişkin gelişmiş ayarları yapılandırmak için 
HttpConnectionDispatcherOptions kullanın. Bu seçenekler, startup.configure > Maphubct 'ye bir temsilci 
geçirilerek yapılandırılır. 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

app.UseSignalR((configure) => 

{ 

var desiredTransports = 

HttpTransportType.WebSockets | 

HttpTransportType.LongPolling; 

configure.MapHub<MyHub>("/myhub", (options) => 

{ 

options.Transports = desiredTransports; 

}); 

}); 

} 


Aşağıdaki tabloda ASP.NET Core SignalRgelişmiş HTTP seçeneklerini yapılandırma seçenekleri açıklanmaktadır: 


SEÇENEK 

VARSAYILAN DEĞER 

AÇIKLAMA 

ApplicationMaxBuffersize 

32 KB 

İstemci tarafından, geri basıncı 


uygulamadan önce sunucunun 
arabelleğe aldığı en fazla bayt sayısı. Bu 
değeri artırmak, sunucunun geri basınç 
uygulamadan daha büyük iletileri daha 
hızlı almasına izin verir, ancak bellek 
tüketimini artırabilir. 


AuthorizationData Veriler, hub sınıfına uygulanan Bir istemcinin hub 'a bağlanmasına 

Authorize özniteliklerinden otomatik yetkili olup olmadığını belirlemede 
olarak toplanır. kullanılan lauthorizedata nesnelerinin 

listesi. 


t r a nsportMaxB uf fersize 32 KB Uygulama tarafından, geri basıncını 

gözlemlenmadan önce sunucunun 
arabelleklerinin gönderdiği en fazla bayt 
sayısı. Bu değeri artırmak, sunucunun 
geri basınç beklemeden daha büyük 
iletileri daha hızlı arabelleğe almasına 
izin verir, ancak bellek tüketimini 
artırabilir. 










SEÇENEK 

VARSAYILAN DEĞER 

AÇIKLAMA 

T ransports 

Tüm aktarımlar etkin. 

Bir istemcinin bağlanmak için 
kullanabileceği taşımaları kısıtlayabilecek 
HttpTransportType değerlerinin bir 
bit bayrakları numaralandırması. 

LongPolling 

Aşağıya bakın. 

Uzun yoklama taşımasına özgü ek 
seçenekler. 

WebSockets 

Aşağıya bakın. 

VVebSockets taşımasına özgü ek 
seçenekler. 

SEÇENEK 

VARSAYILAN DEĞER 

AÇIKLAMA 

ApplicationMaxBuffersize 

32 KB 

istemciden sunucunun arabelleğe aldığı 
en fazla bayt sayısı. Bu değeri artırmak, 
sunucunun daha büyük iletiler almasına 
izin verir, ancak bellek tüketimini 
olumsuz etkileyebilir. 

AuthorizationData 

Veriler, hub sınıfına uygulanan 

Authorize özniteliklerinden otomatik 

olarak toplanır. 

Bir istemcinin hub 'a bağlanmasına 
yetkili olup olmadığını belirlemede 
kullanılan lauthorizedata nesnelerinin 

listesi. 

T ransportMaxBufferSize 

32 KB 

Uygulama tarafından sunucunun 
arabelleklerinin gönderdiği en fazla bayt 
sayısı. Bu değeri artırmak, sunucunun 
daha büyük iletiler göndermesini sağlar, 
ancak bellek tüketimini olumsuz 
etkileyebilir. 

T ransports 

Tüm aktarımlar etkin. 

Bir istemcinin bağlanmak için 
kullanabileceği taşımaları kısıtlayabilecek 
HttpT ransportType değerlerinin bir 
bit bayrakları numaralandırması. 

LongPolling 

Aşağıya bakın. 

Uzun yoklama taşımasına özgü ek 
seçenekler. 

WebSockets 

Aşağıya bakın. 

VVebSockets taşımasına özgü ek 
seçenekler. 

Uzun yoklama taşıması LongPolling 

özelliği kullanılarak yapılandırılabilecek ek seçeneklere sahiptir: 

SEÇENEK 

VARSAYILAN DEĞER 

AÇIKLAMA 

PollTimeout 

90 saniye 

Tek bir yoklama isteğini sonlandırmadan 
önce sunucunun istemciye göndermek 
için bekleyeceği en uzun süre. Bu değeri 
azaltmak istemcinin yeni yoklama 
istekleri daha sık vermesine neden olur. 


VVebSocket taşıması webSockets özelliği kullanılarak yapılandırılabilen ek seçeneklere sahiptir: 
















SEÇENEK 


VARSAYILAN DEĞER 


AÇIKLAMA 


CloseTimeout 


5 saniye 


Sunucu kapandıktan sonra, istemci bu 
zaman aralığında kapanamazsa bağlantı 
sonlandırılır. 


SubProtocolSelector null Sec-WebSocket-Protocol Üst bilgisini 

özel bir değere ayarlamak için 
kullanılabilen bir temsilci. Temsilci, 
istemci tarafından istenen değerleri girdi 
olarak alır ve istenen değeri döndürmesi 
beklenir. 


İstemci seçeneklerini yapılandırma 

istemci seçenekleri HubConnectionBuiider türünde yapılandırılabilir (.NET ve JavaScript istemcilerinde 
kullanılabilir). Java istemcisinde de bulunur, ancak HttpHubConnectionBuiider alt sınıfı, Oluşturucu yapılandırma 
seçeneklerinin yanı sıra HubConnection kendisidir. 

Günlüğe kaydetmeyi yapılandırma 

Günlüğe kaydetme, .N ET İstemcisinde configureLogging yöntemi kullanılarak yapılandırılır. Günlüğe kaydetme 
sağlayıcıları ve filtreler, sunucuda oldukları gibi aynı şekilde kaydedilebilir. Daha fazla bilgi için oturum açma 
ASP.NET Core belgelerine bakın. 


NOTE 

Günlüğe kaydetme sağlayıcılarını kaydetmek için gerekli paketleri yüklemelisiniz. Tam liste için docs 'ın yerleşik günlük 
sağlayıcıları bölümüne bakın. 


Örneğin, konsol günlüğünü etkinleştirmek için Microsoft.Extensions.Logging.consoie NuGet paketini 
yüklemelisiniz. AddConsole uzantısı yöntemini çağırın: 

var connection = new HubConnectionBuilder() 

.Withllrl( "https://example.com/myhub") 

.ConfigureLogging(logging => { 

logging.SetMinimumLevel(LogLevel.Information); 
logging.AddConsole(); 

}) 

.Build(); 

JavaScript istemcisinde benzer bir configureLogging yöntemi vardır. Üretilecek günlük iletilerinin en düşük 
düzeyini belirten bir LogLevel değeri girin. Günlükler tarayıcı konsolu penceresine yazılır. 

let connection = new signalR.HubConnectionBuilder() 

.withUrl("/myhub") 

.configureLogging(signalR.LogLevel.Information) 

.build(); 


LogLevel bir değer yerine, bir günlük düzeyi adını temsil eden bir string değeri de sağlayabilirsiniz. Bu, LogLevel 
sabitlerine erişiminizin olmadığı ortamlarda SignalR günlüğe kaydetme yapılandırırken yararlı olur. 



















let connection = new signalR.HubConnectionBuilder() 

.withUrl("/myhub") 

.configuneLogging("warn") 

.build(); 

Aşağıdaki tabloda kullanılabilir günlük düzeyleri listelenmektedir. configureLogging için sağladığınız değer, günlüğe 
kaydedilecek Minimum günlük düzeyini ayarlar. Bu düzeyde günlüğe kaydedilen iletiler veya tabloda bundan 
sonra listelenen düzeylergünlüğe kaydedilir. 


DİZE LOGLEVEL 


trace 

LogLevel.Trace 

debug 

LogLevel.Debug 


info veya information 

LogLevel.information 


warn veya warning 

LogLevel.Warning 

error 

LogLevel.Error 

critical 

LogLevel.Critical 


none 


LogLevel.None 


NOTE 

Günlüğe kaydetmeyi tamamen devre dışı bırakmak için configureLogging yönteminde signalR.LogLevel.None belirtin. 


Günlüğe kaydetme hakkında daha fazla bilgi için SignalR tanılama belgelerinebakın. 

SignalR Java istemcisi, günlük kaydı için dolayısıyla slf4j kitaplığını kullanır. Bu, kitaplık kullanıcılarının belirli bir 
günlüğe kaydetme bağımlılığı vererek kendi belirli günlük uygulamasını seçmesine olanak sağlayan, üst düzey bir 
günlüğe kaydetme API 'sidir. Aşağıdaki kod parçacığı, SignalR Java istemcisiyle java.utii.iogging nasıl 
kullanacağınızı gösterir. 

implementation 'org.slf4j:slf4j-jdkl4:1.7.25' 


Bağımlılıklarınız için günlük kaydını yapılandırmazsanız, DOLAYıSıYLA SLF4J aşağıdaki uyarı iletisiyle varsayılan 
işlem olmayan bir günlükçü yükler: 


SLF4H: Failed to load class "org.slf4j.impl.StaticLoggerBinder". 

SLF4H: Defaulting to no-operation (NOP) logger implementation 

SLF41: See http://www.slf4j.Org/codes.html#StaticLoggerBinder for further details. 


Bu, güvenle yoksayılabilir. 

İzin verilen taşımaları yapılandırma 

kullanılan aktarımlar withuri çağrısında ( withuri JavaScript ’te) yapılandırılabilir. 
değerlerinin bit düzeyinde veya değerleri yalnızca belirtilen aktarımları kullanacak şekilde 
sınırlamak için kullanılabilir. Tüm aktarımlar varsayılan olarak etkindir. 


SignalR tarafından 
HttpTransportType 




























Örneğin, sunucu tarafından gönderilen olay taşımasını devre dışı bırakmak, ancak VVebSockets ve uzun yoklama 
bağlantılarına izin vermek için: 

var connection = new HubConnectionBuilder() 

.Withl)rl("https ://example. com/myhub", HttpTransportType.UebSockets | HttpTransportType.LongPolling) 

.Build(); 

JavaScript istemcisinde aktarımlar, withuri için sunulan Options nesnesindeki transport alanı ayarlanarak 
yapılandırılır: 

let connection = new signalR.HubConnectionBuilder() 

.withUrl("/myhub ", { transport: signalR.HttpTransportType.UebSockets | 
signalR.HttpTransportType.LongPolling }) 

.build(); 


Java Client VVebSockets 'in bu sürümünde, kullanılabilir tek aktarım bir sürümdür. 

Java istemcisinde, taşıma, HttpHubConnectionBuiider"withTransport yöntemiyle seçilir. Java istemcisi VVebSockets 
taşımasını varsayılan olarak kullanmaktır. 


HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/myhub") 
.withTransport(TransportEnum.WEBSOCKETS) 

.build(); 



Taşıyıcı kimlik doğrulamasını yapılandırma 

SignalR isteklerle birlikte kimlik doğrulama verileri sağlamak için, istenen erişim belirtecini döndüren bir işlevi 
belirtmek üzere AccessTokenProvider seçeneğini (JavaScript 'te accessTokenFactory ) kullanın. .NET İstemcisinde, bu 
erişim belirteci bir HTTP "taşıyıcı kimlik doğrulaması" belirteci olarak geçirilir ( Bearer türü ile Authorization üst 
bilgisi kullanılarak). JavaScript istemcisinde, tarayıcı API 'Lerinin üstbilgileri uygulama özelliğini (özellikle de 
sunucu tarafından gönderilen olaylar ve VVebSockets istekleri) kısıtlayacağı birkaç durum dışında , erişim belirteci 
bir taşıyıcı belirteci olarak kullanılır. Bu durumlarda, erişim belirteci access_token bir sorgu dizesi değeri olarak 
sağlanır. 

.NET istemcisinde AccessTokenProvider seçeneği, withuri içindeki seçenekler temsilcisi kullanılarak belirtilebilir: 

var connection = new HubConnectionBuilder() 

.Withllrl("https://example.com/myhub", options => { 
options.AccessTokenProvider = async () => { 

// Get and return the access token. 

}; 

}) 

.Build(); 

JavaScript istemcisinde, erişim belirteci withuri içindeki seçenekler nesnesindeki accessTokenFactory alanı 
ayarlanarak yapılandırılır: 

















let connection = new signalR.HubConnectionBuilder() 

.withl)r’l("/myhub", { 

accessTokenFactony: () => { 

// Get and return the access token. 

// This function can return a JavaScript Promise if asynchronous 
// logic is required to retrieve the access token. 

} 

}) 

.build(); 


Java istemcisinde SignalR, Httphubconnectionbuilder'a bir erişim belirteci fabrikası sağlayarak kimlik doğrulaması 
için kullanılacak bir taşıyıcı belirteç yapılandırabilirsiniz. Rxjava tek bir<dize >sağlamak İçin withaccesstokenfactory 
kullanın. Tek. erteleçağrısıyla, istemciniz için erişim belirteçleri oluşturmak üzere mantık yazabilirsiniz. 

HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/myhub") 
.withAccessTokenProvider(Single.defer(() -> { 

// Your logic here. 

return Single.just("An Access Token"); 

})).build(); 


Zaman aşımını yapılandırın ve canlı tut seçeneklerini yapılandırın 

Zaman aşımını ve canlı tutma davranışını yapılandırmaya yönelik ek seçenekler HubConnection nesnenin 

kendisinde bulunabilir: 

• .NET 

• JavaScript 

• Java 

SEÇENEK VARSAYILAN DEĞER AÇIKLAMA 

serverTimeout 30 saniye (30.000 milisaniye) Sunucu etkinliği için zaman aşımı. 

Sunucu bu aralıkta bir ileti 
göndermediyse istemci, sunucunun 
bağlantısının kesileceğini kabul eder ve 
ciosed olayını (JavaScript 'te onclose 
) tetikler. Bu değer, ping iletisinin 
sunucudan gönderilmesi ve istemci 
tarafından zaman aşımı aralığı içinde 
alınması için yeterince büyük olmalıdır. 
Önerilen değer, ping için en az iki 
sunucunun KeepAlivelnterval değeri 
olan bir sayıdır. 

HandshakeTimeout 15 saniye ilk sunucu el sıkışması için zaman aşımı. 

Sunucu bu aralıkta bir el sıkışma yanıtı 
göndermezse, istemci el sıkışmasını iptal 
eder ve ciosed olayını (JavaScript'te 
onclose ) tetikler. Bu, yalnızca önemli 
ağ gecikmesi nedeniyle el sıkışma zaman 
aşımı hataları gerçekleşirken 
değiştirilmesi gereken gelişmiş bir 
ayardır. El sıkışma işlemi hakkında daha 
fazla ayrıntı için SignalR hub protokol 
belirtiminebakın. 









SEÇENEK 


VARSAYILAN DEĞER 


AÇIKLAMA 


KeepAliveinterval 15 saniye istemcinin ping iletileri gönderdiği aralığı 

belirler, istemciden herhangi bir ileti 
gönderildiğinde, süreölçeri aralığın 
başına sıfırlanır, istemci sunucuda 
ClientTimeoutlnterval ayarlanmış 
bir ileti göndermediyse sunucu, 
istemcinin bağlantısının kesileceğini 
kabul eder. 


.N ET İstemcisinde zaman aşımı değerleri TimeSpan değerler olarak belirtilir. 

• .NET 

• JavaScript 

• Java 

SEÇENEK VARSAYILAN DEĞER AÇIKLAMA 

serverTimeout 30 saniye (30.000 milisaniye) Sunucu etkinliği için zaman aşımı. 

Sunucu bu aralıkta bir ileti 
göndermediyse istemci, sunucunun 
bağlantısının kesileceğini kabul eder ve 
elosed olayını (JavaScript 'te onclose 
) tetikler. Bu değer, ping iletisinin 
sunucudan gönderilmesi ve istemci 
tarafından zaman aşımı aralığı içinde 
alınması için yeterince büyük olmalıdır. 
Önerilen değer, ping için en az iki 
sunucunun KeepAliveinterval değeri 
olan bir sayıdır. 

HandshakeTimeout 15 saniye ilk sunucu el sıkışması için zaman aşımı. 

Sunucu bu aralıkta bir el sıkışma yanıtı 
göndermezse, istemci el sıkışmasını iptal 
eder ve elosed olayını (JavaScript'te 
onclose ) tetikler. Bu, yalnızca önemli 
ağ gecikmesi nedeniyle el sıkışma zaman 
aşımı hataları gerçekleşirken 
değiştirilmesi gereken gelişmiş bir 
ayardır. El sıkışma işlemi hakkında daha 
fazla ayrıntı için SignalR hub protokol 
belirtiminebakın. 


.N ET İstemcisinde zaman aşımı değerleri TimeSpan değerler olarak belirtilir. 


Ek seçenekleri yapılandırma 

Ek seçenekler, HubConnectionBuiider veya Java istemcisindeki HttpHubConnectionBuiider çeşitli yapılandırma API 
'Lerinde withuri (JavaScript'te withuri ) yönteminde yapılandırılabilir: 

• .NET 

• JavaScript 

• Java 

.NET SEÇENEĞİ VARSAYILAN DEĞER AÇIKLAMA 













.NET SEÇENEĞİ 


VARSAYILAN DEĞER 


AÇIKLAMA 


AccessTokenProvider 

null 

HTTP isteklerinde taşıyıcı kimlik 
doğrulama belirteci olarak belirtilen bir 
dize döndüren bir işlev. 

SkipNegotiation 

f alse 

Anlaşma adımını atlamak için bunu 
true olarak ayarlayın. Yalnızca 
VVebSockets taşıması etkin olan tek 
taşıma olduğunda desteklenir. Azure 
SignalR hizmeti kullanılırken bu ayar 
etkinleştirilemez. 

ClientCertificates 

Olmamalıdır 

Kimlik doğrulaması isteklerine 
gönderilmek üzere TLS sertifikaları 
koleksiyonu. 

Cookies 

Olmamalıdır 

Her HTTP isteğiyle gönderilmek üzere 

HTTP tanımlama bilgilerinin bir 
koleksiyonu. 

Credentials 

Olmamalıdır 

Her HTTP isteğiyle gönderilen kimlik 
bilgileri. 

CloseTimeout 

5 saniye 

Yalnızca VVebSockets. Sunucunun 
kapatma isteğini onaylaması için 
kapatıldıktan sonra bekleyeceği en uzun 
süre. Sunucu bu süre içinde kapatmayı 
kabul etmezse, istemci bağlantısını keser. 


Headers 

Olmamalıdır 

Her HTTP isteğiyle birlikte gönderilmek 
üzere ek HTTP üstbilgileri haritası. 

HttpMessageHandlerFactory 

null 

HTTP istekleri göndermek için kullanılan 

HttpMessageHandler yapılandırmak 


veya değiştirmek için kullanılabilen bir 
temsilci. VVebSocket bağlantıları için 
kullanılmıyor. Bu temsilci null olmayan 
bir değer döndürmelidir ve varsayılan 
değeri bir parametre olarak alır. Bu 
varsayılan değerde ayarları değiştirin ve 
döndürün ya da yeni bir 
HttpMessageHandler Örneği 
döndürün. İşleyiciyi değiştirirken, 
belirtilen işleyiciden tutmak 
istediğiniz ayarları 
kopyalamadığınızdan emin olun, 
aksi takdirde, yapılandırılan 
seçenekler (tanımlama bilgileri ve 
üstbilgiler gibi) yeni işleyiciye 
uygulanmaz. 


null 


Proxy 


HTTP istekleri gönderilirken kullanılacak 
bir HTTP proxy 'si. 



















.NET SEÇENEĞİ 


VARSAYILAN DEĞER 


AÇIKLAMA 


useDefaultcredentials false Bu Boole değeri HTTP ve VVebSockets 

istekleri için varsayılan kimlik bilgilerini 
gönderecek şekilde ayarlayın. Bu, 
Windows kimlik doğrulamasının 
kullanılmasını mümkün. 


websocketconf iguration null Ek WebSocket seçeneklerini 

yapılandırmak için kullanılabilen bir 
temsilci. Seçenekleri yapılandırmak için 
kullanılabilecek ClientVVebSocketOptions 
örneğini alır. 

.N ET İstemcisinde, bu seçenekler uithuri için belirtilen seçenekler temsilcisi tarafından değiştirilebilir: 

var connection = new HubConnectionBuilder() 

.WithUrl("https://example.com/myhub", options => { 
options.Headers["Foo"] = "Bar"; 
options.Cookies.Add(new Cookie(/* ... */); 
options.ClientCertificates.Add(/* ... */); 

}) 

.Build(); 

JavaScript İstemcisinde, bu seçenekler withuri için sunulan bir JavaScript nesnesi içinde bulunabilir: 

let connection = new signalR.HubConnectionBuilder() 

.withUrl("/myhub ", { 

skipNegotiation: true, 

transport: signalR.HttpTransportType.UebSockets 

}) 

.build(); 

Java istemcisinde, bu seçenekler HubConnectionBuilder.create("HUB URL") döndürülen HttpHubConnectionBuilder 

yöntemleriyle yapılandırılabilir 

HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/myhub") 

.i/jithHeaderC'Foo", "Bar") 

.shouldSkipNegotiate(true) 

.withHandshakeResponseTimeout(30*1000) 

.build(); 


Ek kaynaklar 

• ASP.NET Core SignalR kullanmaya başlama 

• ASP.NET Core SignalR hub 1 ları kullanma 

• ASP.NET Core SignalR JavaScript istemcisi 

• .NET Client ASP.NET Core SignalR 

• ASP.NET Core için SignalR içinde MessagePack hub protokolünü kullanın 

• Desteklenen SignalR platformları ASP.NET Core 











ASPNET Core SignalR kimlik doğrulaması ve 
yetkilendirme 

6.12.2019 • 13 minutes to read ı Edit Online 


, Andrevv Stanton-nurte 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

SignalR hub 'ına bağlanan kullanıcıların kimliğini doğrulama 

SignalR, bir kullanıcıyı her bağlantıyla ilişkilendirmek için ASP.NET Core kimlik doğrulamasıyla birlikte 
kullanılabilir. Bir hub 'da, Hubconnectioncontext. User özelliğinden kimlik doğrulama verilerine erişilebilir. Kimlik 
doğrulaması, hub ’ın bir kullanıcıyla ilişkili tüm bağlantılar üzerinde Yöntemler çağırmasını sağlar. Daha fazla bilgi 
için bkz. SignalRkullanıcıları ve grupları yönetme . Birden çok bağlantı tek bir kullanıcıyla ilişkilendirilebilir. 

Aşağıda, SignalR ve ASP.NET Core kimlik doğrulaması kullanan startup.configure bir örneği verilmiştir: 

public void Configure(IApplicationBuilder app) 

{ 


app.UseStaticFiles(); 

app.UseRoutingO; 

app.UseAuthentication(); 
app.UseAuthorization(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapHub<ChatHub>("/chat"); 

endpoints.MapControllerRoute("default ", "{controller=Home}/{action=Index}/{id?}"); 

}); 

} 


public void Configure(IApplicationBuilder app) 
{ 


app.UseStaticFiles(); 

app.UseAuthentication(); 

app.UseSignalR(hubs => 

{ 

hubs.MapHub<ChatHub>("/chat"); 

}); 

app.UseMvc(routes => 

{ 

routes.napRoute("default"j "{controller=Home}/{action=Index}/{id?}"); 

}); 

} 






NOTE 

SignalR ve ASP.NET Core kimlik doğrulama ara yazılımını kaydetme sırası önemli. SignalR HttpContext bir kullanıcıya sahip 
olması için usesignalR önce her zaman useAuthentication çağırın. 


Tanımlama bilgisi kimlik doğrulaması 

Tarayıcı tabanlı bir uygulamada, tanımlama bilgisi kimlik doğrulaması, mevcut kullanıcı kimlik bilgilerinizin 
SignalR bağlantılarına otomatik olarak akmasını sağlar. Tarayıcı istemcisi kullanılırken ek yapılandırma gerekmez. 
Kullanıcı uygulamanızda oturum açtıysa, SignalR bağlantı bu kimlik doğrulamasını otomatik olarak devralır. 

Tanımlama bilgileri, erişim belirteçleri göndermek için tarayıcıya özgü bir yoldur, ancak tarayıcı olmayan istemciler 
bunları gönderebilir. .NET istemcisikullanılırken, tanımlama bilgisi sağlamak için ,withuri çağrısında cookies 
özelliği yapılandırılabilir. Ancak, .N ET istemcisinden tanımlama bilgisi kimlik doğrulamasını kullanmak, 
uygulamanın bir tanımlama bilgisi için kimlik doğrulama verilerini Exchange için bir API sağlamasını gerektirir. 

Taşıyıcı belirteç kimlik doğrulaması 

İstemci, tanımlama bilgisi kullanmak yerine bir erişim belirteci sağlayabilir. Sunucu belirteci doğrular ve kullanıcıyı 
tanımlamak için kullanır. Bu doğrulama yalnızca bağlantı kurulduunda yapılır. Bağlantının kullanım ömrü boyunca, 
sunucu otomatik olarak yeniden doğrulamadan belirteç iptalini kontrol etmez. 

Sunucusunda, taşıyıcı belirteç kimlik doğrulaması JWT taşıyıcı ara yazılımıkullanılarak yapılandırılır. 

JavaScript istemcisinde, belirteç Accesstokenfactory seçeneği kullanılarak sağlanabilirler. 

// Connect, using the token we got. 
this.connection = new SignalR.HubConnectionBuilder() 

,withUrl("/hubs/chat", { accessTokenFactory: () => this.loginToken }) 

.build(); 


.NET istemcisinde, belirteci yapılandırmak için kullanılabilecek, benzer bir Accesstokenprovider özelliği vardır: 

var connection = new HubConnectionBuilder() 

.WithUrl("https://example.com/myhub", options => 

{ 

options.AccessTokenProvider = () => Task.FromResult(_myAccessToken); 

}) 

.Build(); 


NOTE 

Sağladığınız erişim belirteci işlevi, SignalRtarafından yapılan her http isteğinin önüne çağırılır. Bağlantıyı etkin tutmak için 
belirteci yenilemeniz gerekiyorsa (bağlantı sırasında süresi dolarsa), bunu bu işlevin içinden yapın ve güncelleştirilmiş belirteci 
döndürün. 


Standart Web API 'Lerinde, taşıyıcı belirteçleri bir HTTP üst bilgisinde gönderilir. Ancak, bazı aktarımlar 
kullanılırken SignalR tarayıcılarda bu üst bilgileri ayarlayamadı. VVebSockets ve sunucu tarafından gönderilen 
olaylar kullanılırken, belirteç bir sorgu dizesi parametresi olarak iletilir. Bunu sunucuda desteklemek için ek 
yapılandırma gerekir: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<ApplicationDbContext>(options => 

options. UseSqlServer(Configuration .GetConnectionSt ring ("Def aultConnection"))); 


Services.AddIdentity<Applicationtlser, IdentityRole>() 








.AddEntityFrameworkStores<ApplicationDbContext>() 

.AddDefaultTokenProviders(); 

Services.AddAuthentication(options => 

{ 

// Identity made Cookie authentication the default. 

// However, we want 1WT Bearer Auth to be the default. 

options.DefaultAuthenticateScheme = lwtBearerDefaults.AuthenticationScheme; 
options.DefaultChallengeScheme = TwtBearerDefaults.AuthenticationScheme; 

}) 

.AddlwtBearer(options => 

{ 

// Configure the Authority to the expected value for your authentication provider 
// This ensures the token is appropriately validated 
options.Authority = /* TODO: Insert Authority URL here */; 

// We have to hook the OnMessageReceived event in order to 
// allow the JWT authentication handler to read the access 
// token from the query string when a WebSocket or 
// Server-Sent Events request comes in. 

// Sending the access token in the query string is required due to 
// a limitation in Browser APIs. We restrict it to only calls to the 
// SignalR hub in this code. 

// See https://docs.microsoft.com/aspnet/core/signalr/security#access-token-logging 
// for more information about security considerations when using 
// the query string to transmit the access token. 
options.Events = new 3wtBearerEvents 
{ 

OnMessageReceived = context => 

{ 

var accessToken = context.Request.Query["access_token"]; 

// If the request is for our hub... 

var path = context.HttpContext.Request.Pathj 

if (!string.IsNullOrEmpty(accessToken) && 

(path .Start sl/JithSegments ("/hubs/chat"))) 

{ 

// Read the token out of the query string 
context.Token = accessToken; 

} 

return Task.CompletedTask; 

} 

}; 

}); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_l); 

Services. AddSignalR(); 

// Change to use Name as the user identifier for SignalR 
// IaJARNING: This requires that the source of your !WT token 
// ensures that the Name daim is unique! 

// If the Name daim isn't unique, users could receive messages 
// intended for a different user! 

Services.AddSingleton<IUserIdProvider, NameUserIdProvider>(); 

// Change to use email as the user identifier for SignalR 

// Services.AddSingletondUserldProvider, EmailBasedUserIdProvider>(); 

// l/JARNING: use *either* the NameUserldProvider *or* the 
// EmailBasedUserldProvider, but do not use both. 


NOTE 

Sorgu dizesi tarayıcı API 'SI sınırlamaları nedeniyle VVebSockets ve sunucu tarafından gönderilen olaylarla bağlantı kurulurken 
tarayıcılarda kullanılır. HTTPS kullanılırken sorgu dizesi değerleri TLS bağlantısıyla korunmuş hale getirilir. Ancak, birçok 
sunucu günlük sorgu dizesi değerlerini günlüğe kaydeder. Daha fazla bilgi için ASP.NET Core SignalRgüvenlik konuları 
bölümüne bakın. SignalR, belirteçleri destekleyen ortamlarda (.NET ve Java istemcileri gibi) belirteçleri iletmek için üst bilgileri 
kullanır. 


Tanımlama bilgileri ve taşıyıcı belirteçleri karşılaştırması 

Tanımlama bilgileri tarayıcılara özeldir. Diğer istemci türlerinden gönderilmesi, taşıyıcı belirteçlerinin 
gönderilmesine kıyasla karmaşıklık ekler. Sonuç olarak, uygulamanın yalnızca tarayıcı istemcisinden kullanıcıların 
kimliğini doğrulaması gerekmediği takdirde tanımlama bilgisi kimlik doğrulaması önerilmez. Taşıyıcı belirteç 
kimlik doğrulaması, tarayıcı istemcisi dışındaki istemcileri kullanırken önerilen yaklaşımdır. 

Windows kimlik doğrulama 

Uygulamanızda Windows kimlik doğrulaması yapılandırılırsa, SignalR hub 'ları güvenli hale getirmek için bu 
kimliği kullanabilir. Ancak, bireysel kullanıcılara ileti göndermek için özel bir kullanıcı KİMLİĞİ sağlayıcısı 
eklemeniz gerekir. Windows kimlik doğrulama sistemi, "ad tanımlayıcı" talebi sağlamaz. SignalR, Kullanıcı adını 
belirlemede talebi kullanır. 

ıuseridProvider uygulayan yeni bir sınıf ekleyin ve Kullanıcı tarafından tanımlayıcı olarak kullanılacak taleplerden 
birini alın. Örneğin, "ad" talebini ( [Domain]\[username] biçimde VVİndovvs Kullanıcı adı) kullanmak için aşağıdaki 
sınıfı oluşturun: 

public class NameUserldProvider : IUserldProvider 
{ 

public string GetUserId(HubConnectionContext connection) 

{ 

return connection.User?.Identity?.Name; 

} 

} 

ciaimTypes.Name yerine, User herhangi bir değeri (VVİndovvs SID tanımlayıcısı gibi) kullanabilirsiniz. 


NOTE 

Seçtiğiniz değer, sisteminizdeki tüm kullanıcılar arasında benzersiz olmalıdır.Aksi takdirde, bir kullanıcı için tasarlanan bir ileti 
farklı bir kullanıcıya gidiyor olabilir. 


Bu bileşeni startup.configureservices yöntemine kaydedin. 

public void ConfigureServices(IServiceCollection Services) 

{ 

// ... other Services ... 

Services. AddSignalR(); 

Services.AddSingleton<IUserldProvider, NameUserIdProvider>(); 

} 

.NET İstemcisinde, UseDefaultCredentials özelliği ayarlanarak VVİndovvs kimlik doğrulamasının etkinleştirilmesi 
gerekir: 








var connection = new HubConnectionBuilder() 

.WithUrl("https://example.com/myhub", options => 

{ 

options.UseDefaultCredentials = true; 

}) 

.Build(); 


Windows kimlik doğrulaması yalnızca Microsoft Internet Explorer veya Microsoft Edge kullanılırken tarayıcı 
istemcisi tarafından desteklenir. 

Kimlik işlemeyi özelleştirmek için talepler kullanma 

Kullanıcıların kimliğini doğrulayan bir uygulama, Kullanıcı taleplerinden SignalR Kullanıcı kimliği türetilebilir. 
SignalR Kullanıcı kimliklerini nasıl oluşturduğunu belirtmek için, ıuseridProvider uygulayın ve uygulamayı 
kaydedin. 


Örnek kod, tanımlama özelliği olarak kullanıcının e-posta adresini seçmek için talepleri nasıl kullanacağınızı 
gösterir. 



{ 

public Virtual string GetUserId(HubConnectionContext connection) 

{ 

return connection.User?.FindFirst(ClaimTypes.Email)?.Value; 

} 

} 

Hesap kaydı, ASP.NET Identity veritabanına ciaimsTypes.Email türünde bir talep ekler. 

// create a new user 

var user = new ApplicationUser { UserName = Input.Email, Email = Input.Email }; 
var result = await _userManager.CreateAsync(user, Input.Password); 

// add the email daim and value for this user 

await _userManager.AddClaimAsync(user, new Claim(ClaimTypes.Email, Input.Email)); 

Bu bileşeni startup.configureServices kaydedin. 

Services.AddSingletoncIUserldProvider, EmailBasedUserIdProvider>(); 


Kullanıcılara, hub lara ve hub yöntemlerine erişim yetkisi verme 


Varsayılan olarak, bir hub ’daki tüm yöntemler kimliği doğrulanmamış bir kullanıcı tarafından çağrılabilir. Kimlik 
doğrulaması gerektirmek için, Yetkilendir özniteliğini hub 'a uygulayın: 


[Authorize] 

public class ChatHub: Hub 

{ 

} 












yetkilendirme ilkeniz varsa, aşağıdaki kodu kullanarak yalnızca bu ilkeyle eşleşen kullanıcıların hub 'a erişmesini 
sağlayabilirsiniz: 

[Authorize("MyAuthorizationPolicy")] 
public class ChatHub : Hub 
{ 

} 

Tek tek hub yöntemlerinde [Authorize] özniteliği de uygulanabilir. Geçerli Kullanıcı, yönteme uygulanan ilkeyle 
eşleşmezse, çağırana bir hata döndürülür: 

[Authorize] 

public class ChatHub : Hub 
{ 

public async Task Send(string message) 

{ 

// ... send a message to ali users ... 

} 

[Authorize("Administrators")] 
public void BanUser(string userName) 

{ 

// ... ban a user from the chat room (something only Administrators can do) ... 

} 

} 

Hub yöntemi yetkilendirmesini özelleştirmek için yetkilendirme işleyicilerini kullanma 

SignalR, bir hub yöntemi yetkilendirme gerektirdiğinde, yetkilendirme işleyicilerine özel bir kaynak sağlar. Kaynak 
bir HubinvocationContext örneğidir. HubinvocationContext , HubCaiierContext , çağrılan hub yönteminin adını ve 
hub yönteminin bağımsız değişkenlerini içerir. 

Azure Active Directory aracılığıyla birden çok kuruluşun oturum açmasına izin veren bir sohbet odası örneğini göz 
önünde bulundurun. Microsoft hesabı olan herkes sohbet için oturum açabilir, ancak yalnızca sahip olunan 
kuruluşun üyeleri kullanıcıları yasaklatabilecek veya kullanıcıların sohbet geçmişlerini görüntüleyebilmelidir. 

Ayrıca, belirli kullanıcılardan belirli işlevleri kısıtlamak isteyebilirsiniz. ASP.NET Core 3,0 ' deki güncelleştirilmiş 
özellikleri kullanarak bu tamamen mümkündür. DomainRestrictedRequirement nasıl özel bir 
iAııthorizationRequirement görevi gördüğüne göz önünde edin. Artık HubinvocationContext kaynak parametresi 
geçirildiğinden, iç mantık hub 'ın çağrıldığı bağlamı inceleyebilir ve kullanıcının bireysel hub yöntemlerini 
yürütmesine izin verirken kararlar verebilir. 












[Authorize] 

public class ChatHub : Hub 

{ 

public void SendMessage(string message) 

{ 

} 

[Authorize("DomainRestricted")] 
public void Banllser(string username) 

{ 

} 

[Authorize("DomainRestricted")] 

public void ViewUserHistory(string username) 

{ 

} 


public class DomainRestrictedRequirement : 

AuthorizationHandler<DomainRestrictedRequirement , HubInvocationContext>, 

IAuthorizationRequirement 

{ 

protected override Task HandleRequirementAsync(AuthorizationHandlerContext context, 
DomainRestrictedRequirement requirementj 
HubInvocationContext resource) 

{ 

if (IsUserAllowedToDoThis(resource.HubMethodl\lamej context.User.Identity.Name) && 
context.User.Identity.Name.EndsWith( "(Şmicrosoft. com")) 

{ 

context.Succeed(requirement); 

} 

return Task.CompletedTask; 

} 

private bool IsUserAllowedToDoThis(string hubMethodName, 
string currentUsername) 

{ 

return !(currentUsername.Equals("asdf42@microsoft.com") && 

hubMethodName.Equals("banUser ", StringComparison.OrdinalIgnoreCase)); 

} 

} 

startup.configureServices , yeni ilkeyi ekleyerek DomainRestricted ilkesini oluşturmak için parametre olarak özel 
DomainRestrictedRequirement gereksinimini sağlar. 

public void ConfigureServices(IServiceCollection Services) 

{ 

// ... other Services ... 

Services 

.AddAuthorization(options => 

{ 

options.AddPolicy("DomainRestricted"j policy => 

{ 

policy.Requirements.Add(new DomainRestrictedRequirement()); 

}); 

}); 

} 

Yukarıdaki örnekte DomainRestrictedRequirement Simfl, bu gereksinim için hem IAuthorizationRequirement hem 
de kendi AuthorizationHandler . Bu iki bileşeni birbirinden ayrı ayrı sınıflara bölmek kabul edilebilir.Örneğin 
yaklaşımın bir avantajı, gereksinim ve işleyicinin aynı şey olduğu için başlangıç sırasında AuthorizationHandler 
eklemeye gerek yoktur. 







Ek kaynaklar 

• ASP.NET Core 'de taşıyıcı belirteç kimlik doğrulaması 

• Kaynak tabanlı yetkilendirme 


ASPNET Core SignalR güvenlik konuları 
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Bu makalede SignalRgüvenliğini sağlama hakkında bilgi sağlanır. 

Çıkış noktaları arası kaynak paylaşma 

Çapraz kaynak kaynak paylaşımı (CORS) , tarayıcıda çapraz kaynak SignalR bağlantılara izin vermek için 
kullanılabilir. JavaScript kodu SignalR uygulamasından farklı bir etki alanında barındırılıyorsa, JavaScript 'İn 
SignalR uygulamasına bağlanmasına izin vermek için CORS ara yazılımı etkinleştirilmelidir. Yalnızca güvendiğiniz 
veya denetlediğiniz etki alanlarından çıkış noktaları arası isteklere izin verin. Örneğin: 

• Siteniz http://www.exampie.com barındırılıyor 

• SignalR uygulamanız http://signair.exampie.com üzerinde barındırılıyor 

CORS, SignalR uygulamasında yalnızca kaynak www.exampie.com izin verecek şekilde yapılandırılmalıdır. 

CORS 'yi yapılandırma hakkında daha fazla bilgi için bkz. çıkış noktaları arası istekleri (CORS) etkinleştirme. 
SignalR aşağıdaki CORS ilkelerini gerektirir: 

• Beklenen belirli kaynaklardan izin verin. Herhangi bir kaynağa izin verilmesi mümkün olsa da güvenli veya 
önerilmez. 

• HTTP yöntemlerine get ve post izin verilmelidir. 

• Kimlik doğrulaması kullanılmasa bile kimlik bilgilerinin etkinleştirilmesi gerekir. 

Örneğin, aşağıdaki CORS ilkesi, https://exampie.com barındırılan SignalR tarayıcısı istemcisinin 
https://signair.exampie.com üzerinde barındırılan SignalR uygulamasına erişmesine izin verir: 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

// ... other middleware ... 

// Make sure the CORS middleware is ahead of SignalR. 
app.UseCors(builder => 

{ 

builder.WithOrigins(" https://example.com") 

.AllowAnyHeader() 

.WithMethods("GET ", "POST") 

.AllowCredentials(); 

}); 

// ... other middleware ... 
app.UseRouting(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapHub<ChatHub>("/chatHub"); 

}); 

// ... other middleware ... 

} 










public void Configure(IApplicationBuilder app, IHostingEnvinonment env) 
{ 

// ... other middleware ... 

// Hake sure the CORS middleware is ahead of SignalR. 
app.UseCors(builder => 

{ 

builder.WithOrigins(" https://example.com") 

.AllowAnyHeader() 

.WithHethods("GET ", "POST") 

.AllowCredentials(); 

}); 

// ... other middleware ... 

app.UseSignalR(routes => 

{ 

routes.HapHub<ChatHub>("/chatHub"); 

}); 

// ... other middleware ... 

} 


NOTE 

SignalR, Azure App Service yerleşik CORS özelliğiyle uyumlu değildir. 


VVebSocket kaynak kısıtlaması 

CORS tarafından sunulan korumalar VVebSockets için geçerlidir.VVebSockets üzerindeki kaynak kısıtlaması için 

VVebSockets kaynak kısıtlaması' nı okuyun. 

CORS tarafından sunulan korumalar VVebSockets için geçerlidir.Tarayıcılar şunları desteklemez: 

• CORS ön uçuş istekleri gerçekleştirin. 

• VVebSocket istekleri yaparken Access-Control üst bilgilerinde belirtilen kısıtlamalara saygı. 

Ancak, tarayıcılar VVebSocket istekleri verirken origin üst bilgisini gönderir. Yalnızca beklenen kaynaklardan 
gelen VVebSockets izin verildiğinden emin olmak için uygulamalar bu üstbilgileri doğrulamak üzere 
yapılandırılmalıdır. 

ASP.NET Core 2,1 ve üzeri sürümlerde, üst bilgi doğrulaması, useSignaiR ve configure kimlik doğrulama ara 
yazılımı aracılığıyla bulunan özel bir ara yazılım kullanılarak elde edilebilir: 








// In Startup, add a static field listing the allowed Origin values: 

private static readonly HashSet<string> _allowedOrigins = new HashSet<string>() 

{ 

// Add allowed origins here. For example: 

"https://www.mysite.com", 

"https://mysite.com", 

}; 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

// ... other middleware ... 

// Validate Origin header on WebSocket requests to prevent unexpected cross-site 
// WebSocket requests. 
app.Use((context, next) => 

{ 

// Check for a WebSocket request. 

if (string.Equals(context.Request.Headers["Upgrade"], "websocket")) 

{ 

var origin = context.Request.Headers["Origin"]; 

// If there is an origin header, and the origin header doesn't match 
// an allowed value: 

if (!string.IsNullOrEmpty(origin) && !_allowedOrigins.Contains(origin)) 

{ 

// The origin is not allowed, reject the request 
context.Response.StatusCode = StatusCodes.Status403Forbidden; 
return Task.CompletedTask; 

} 

} 

// The request is a valid Origin or not a UebSocket request, so continue. 
return next(); 

}); 

// ... other middleware ... 

app.UseSignalR(routes => 

{ 

routes.MapHub<ChatHub>("/chatHub"); 

}); 

// ... other middleware ... 


NOTE 

origin üstbilgisi istemci tarafından denetlenir ve Referer üst bilgisi gibi erişilebilir. Bu üst bilgiler bir kimlik doğrulama 
mekanizması olarak kullanılmamalıdır. 


Erişim belirteci günlüğe kaydetme 

VVebSockets veya sunucu tarafından gönderilen olaylar kullanılırken, tarayıcı istemcisi erişim belirtecini sorgu 
dizesinde gönderir. Sorgu dizesi aracılığıyla erişim belirtecinin alınması genellikle standart Authorization üst 
bilgisi kullanılarak güvenlidir, istemci ve sunucu arasında güvenli bir uçtan uca bağlantı sağlamak için her zaman 
HTTPS kullanmanız gerekir. Birçok Web sunucusu, sorgu dizesi dahil olmak üzere her bir isteğin URL 'sini 
günlüğe kaydeder. URL 'Leri günlüğe kaydetme erişim belirtecini günlüğe alabilir. ASP.NET Core, her isteğin 
URL 'sini varsayılan olarak günlüğe kaydeder ve bu sorgu dizesini içerir. Örneğin: 





info: Microsoft.AspNetCore.Hosting.Internal.WebHost[l] 

Request starting HTTP/1.1 GET http://localhost:5000/myhub?access_token=1234 

Bu verileri sunucu günlüklerinize kaydetme hakkında endişeleriniz varsa, Microsoft.AspNetCore.Hosting 
günlükçüsü uarning düzeyine veya üstüne yapılandırarak (Bu iletiler info düzeyinde yazılır) bu günlüğü 
tamamen devre dışı bırakabilirsiniz. Daha fazla bilgi için günlük filtrelemeye yönelik belgelere bakın. Hala belirli 
istek bilgilerini günlüğe kaydetmek istiyorsanız, ihtiyacınız olan verileri günlüğe kaydetmek için bir ara yazılım 
yazabilir ve access_token sorgu dizesi değerini (varsa) filtreleyebilirsiniz. 

Özel Durumlar 

Özel durum iletileri genellikle bir istemciye görüntülenmemelidir gizli veriler olarak değerlendirilir.Varsayılan 
olarak, SignalR bir hub yöntemi tarafından oluşturulan bir özel durumun ayrıntılarını istemciye göndermez. 
Bunun yerine, istemci bir hata oluştuğunu belirten genel bir ileti alır, istemciye özel durum iletisi teslimi, 
Enabledetailederrorsile geçersiz kılınabilir (örneğin, geliştirme veya test). Özel durum iletileri, üretim 
uygulamalarındaki istemciye gösterilmemelidir. 

Arabellek Yönetimi 

SignalR gelen ve giden iletileri yönetmek için bağlantı başına arabellekleri kullanır. Varsayılan olarak, SignalR bu 
arabellekleri 32 KB ile sınırlandırır. Bir istemcinin veya sunucunun gönderecan en büyük ileti 32 KB 'tır.ileti 
bağlantısı tarafından tüketilen maksimum bellek 32 KB 'tır. İletileriniz her zaman 32 KB 'den küçükse, sınırı 
azaltabilirsiniz ve şunları yapabilirsiniz: 

• Bir istemcinin daha büyük bir ileti gönderebilmesini engeller. 

• Sunucu, iletileri kabul etmek için hiçbir şekilde büyük arabellekler ayırmayı gerektirmez, 
iletileriniz 32 KB 'tan büyükse, limiti artırabilirsiniz. Bu sınırı artırmak şu anlama gelir: 

• istemci, sunucunun büyük bellek arabellekleri ayırmasına neden olabilir. 

• Büyük arabelleklerin sunucu ayırması, eşzamanlı bağlantı sayısını azaltabilir. 

Gelen ve giden iletiler için her ikisi de MapHub ' de yapılandırılan Httpconnectiondispatcheroptions nesnesinde 
yapılandırılabilir: 

• AppiicationMaxBuffersize , istemciden sunucunun arabelleğe aldığı en fazla bayt sayısını temsil eder, istemci 
bu sınırdan daha büyük bir ileti göndermemeyi denerse bağlantı kapatılabilir. 

• TransportMaxBuffersize , sunucunun gönderemediği en fazla bayt sayısını temsil eder. Sunucu, bu sınırdan 
daha büyük bir ileti (hub metotlarından dönüş değerleri dahil) gönderilmeye çalışırsa, bir özel durum 
oluşturulur. 

Sınırın e olarak ayarlanması sınırı devre dışı bırakır. Sınırı kaldırmak, bir istemcinin herhangi bir boyutta ileti 
göndermesini sağlar. Büyük iletiler gönderen kötü amaçlı istemciler fazla belleğin ayrılmasına neden olabilir. Aşırı 
bellek kullanımı, eşzamanlı bağlantı sayısını önemli ölçüde azaltabilir. 
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Bu makalede, okuyucunun Başlarkenbölümünde ele alınan konular hakkında bilgi sahibi olduğu varsayılır. 

MessagePack nedir? 

MessagePack hızlı ve kompakt bir ikili serileştirme biçimidir. Bu, JSONİle karşılaştırıldığında daha küçük iletiler 
oluşturduğundan performans ve bant genişliği açısından yararlıdır, ikili bir biçim olduğundan, baytlar bir 
MessagePack ayrıştırıcısı üzerinden geçirilmediği takdirde ağ izlemeleri ve günlükleri aranırken iletiler okunamaz. 
SignalR MessagePack biçimi için yerleşik desteğe sahiptir ve istemci ve sunucunun kullanması için API 1 Ler sağlar. 

Sunucuda MessagePack 'i yapılandırma 


Sunucuda MessagePack hub protokolünü etkinleştirmek için Microsoft.AspNetCore.SignalR.Protocols.MessagePack 
paketini uygulamanıza yüklersiniz. Startup.es dosyasında, sunucuda MessagePack desteğini etkinleştirmek için 
AddSignalR çağrısına AddMessagePackProtocol ekleyin. 



Services. AddSignalR() 

.AddMessagePackProtocol(); 

MessagePack 'in verilerinizi nasıl biçimlendiğini özelleştirmek için AddMessagePackProtocol seçenekleri 
yapılandırmak için bir temsilci alır. Bu temsilcisinde, FormatterResolvers özelliği MessagePack serileştirme 
seçeneklerini yapılandırmak için kullanılabilir. Çözümleyiciler nasıl çalıştığı hakkında daha fazla bilgi için, 
MessagePack-CSharpkonumundaki MessagePack kitaplığını ziyaret edin. Öznitelikler, serileştirilmeleri nasıl ele 
alınacağını tanımlamak için seri hale getirmek istediğiniz nesnelerde kullanılabilir. 

Services. AddSignalR() 

.AddMessagePackProtocol(options => 

{ 

options.FormatterResolvers = new List<MessagePack.IFormatterResolver>() 

{ 

MessagePack.Resolvers.StandardResolver.Instance 

}; 

}); 


İstemcide MessagePack 'i yapılandırma 












NOTE 

JSON, desteklenen istemciler için varsayılan olarak etkindir, istemciler yalnızca tek bir protokolü destekleyebilir. MessagePack 
desteği eklemek, önceden yapılandırılmış tüm protokollerin yerini alır. 


.NET istemcisi 

.NET İstemcisinde MessagePack 'i etkinleştirmek için Microsoft.AspNetcore.signaiR.Protocols.MessagePack paketini 
yükleyip HubConnectionBuilder'' AddMessagePackProtocol çağırın. 

var hubConnection = new HubConnectionBuilder() 

.WithUrl("/chatHub") 

.AddMessagePackProtocol() 

.Build(); 



JavaScript istemcisi 

JavaScript istemcisi için MessagePack desteği @microsoft/signair-protocoi-msgpack NPM paketi tarafından 
sağlanmaktadır. Aşağıdaki komutu bir komut kabuğu ’nda yürüterek paketi yüklemelisiniz: 

npm install @microsoft/signalr-protocol-msgpack 

JavaScript istemcisi için MessagePack desteği @aspnet/signair-protocoi-msgpack NPM paketi tarafından 
sağlanmaktadır. Aşağıdaki komutu bir komut kabuğu 'nda yürüterek paketi yüklemelisiniz: 

npm install @aspnet/signalr-protocol-msgpack 

NPM paketini yükledikten sonra modül, doğrudan bir JavaScript Modül Yükleyicisi aracılığıyla veya aşağıdaki 
dosyaya başvurarak tarayıcıya içeri aktarılabilecek şekilde kullanılabilir: 

node_modules\@microsoft\signalr-protocol-msgpack\dlst\browser\signalr-protocol-msgpack.js 

node_modules\@aspnet\signalr-protocol-msgpack\dist\browser\signalr-protocol-msgpack.js 

Bir tarayıcıda msgpacks kitaplığına da başvurulmalıdır. Başvuru oluşturmak için bir <script> etiketi kullanın. 
Kitaplık, node_modules \msgpack5\dist\msgpack5,JSkor\urr\ur\da bulunabilir. 



<script src="~/lib/signalrVsignalr.js"x/scnipt> 

<script src="~/lib/msgpack5/msgpack5.js"></Scripts 

<script src="~/lib/signalr/signalr-protocol-msgpack.js"x/script> 

HubConnectionBuilder ,withHubProtocol(new signalR.protocols.msgpack.MessagePackHubProtocol( )) eklemek, 
istemciyi bir sunucuya bağlanırken MessagePack protokolünü kullanacak şekilde yapılandırır. 













const connection = new signalR.HubConnectionBuilder() 

.withUrl("/chatHub") 

.withHubProtocol(new signalR.protocols.msgpack.MessagePackHubProtocol()) 
.build(); 



MessagePack süslemeler 

MessagePack hub protokolünü kullanırken dikkat etmeniz birkaç sorun vardır. 

MessagePack büyük/küçük harfe duyarlıdır 

MessagePack Protokolü büyük/küçük harfe duyarlıdır.Örneğin, aşağıdaki C# sınıfı göz önünde bulundurun: 

public class ChatMessage 
{ 

public string Sender { get; } 
public string Message { get; } 

} 

JavaScript istemcisinden gönderirken, büyük/küçük harf C# sınıfıyla tam olarak eşleşmesi gerektiğinden 
Pascaicased özellik adlarını kullanmanız gerekir. Örneğin: 

connection.invoke("SomeMethod"j { Sender: "Sally", Message: "Hello!" }); 

camelCased adları kullanmak C# sınıfa düzgün şekilde bağlanmaz. MessagePack özelliği için farklı bir ad belirtmek 
üzere Key özniteliğini kullanarak bu soruna geçici bir çözüm bulabilirsiniz. Daha fazla bilgi için bkz. MessagePack- 
CSharp belgeleri. 

Seri hale getirme/seri durumdan çıkarma sırasında DateTime. Kind korunmaz 

MessagePack protokolü, bir DateTime'' Kind değerini kodlamak için bir yol sağlamaz. Sonuç olarak, bir tarih serisi 
kaldırılırken, MessagePack hub protokolü gelen tarihin UTC biçiminde olduğunu varsayar. Yerel saat içinde 
DateTime değerlerle çalışıyorsanız, göndermeden önce UTC 'ye dönüştürmeniz önerilir. Bunları aldığınızda UTC 
'den yerel saate dönüştürün. 

Bu sınırlama hakkında daha fazla bilgi için bkz. GitHub sorun ASPNET/SignalR#2632. 

DateTime. MinValue, JavaScript 'te MessagePack tarafından desteklenmiyor 

SignalR JavaScript istemcisi tarafından kullanılan msgpack5 kitaplığı MessagePack içindeki timestamp96 türünü 
desteklemez. Bu tür, çok büyük tarih değerlerini kodlamak için kullanılır (daha önce geçmişte veya daha önce bir 
süre içinde çok erken). DateTime.MinValue değeri, bir timestamp96 değerinde kodlanması gereken 
lanuany ı, 000 i . Bu nedenle, JavaScript istemcisine DateTime.MinValue gönderilmesi desteklenmez. JavaScript 
istemcisi tarafından DateTime.MinValue alındığında, aşağıdaki hata oluşur: 

Uncaught Error: unable to find ext type 255 at decoder.js:427 

Genellikle, DateTime.MinValue bir "eksik" veya nuiı değeri kodlamak için kullanılır. Bu değeri MessagePack'te 
kodlamak gerekirse, null yapılabilir DateTime değeri ( DateTime? ) kullanın veya tarihin mevcut olup olmadığını 
belirten ayrı bir booi değeri kodlayın. 




















Bu sınırlama hakkında daha fazla bilgi için bkz. GitHub sorun ASPNET/SignalR#2228. 

"Zamanında" derleme ortamında MessagePack desteği 

.NET istemcisi ve sunucusu tarafından kullanılan MessagePack-CSharp kitaplığı, serileştirme işlemini iyileştirmek 
için kod oluşturmayı kullanır. Sonuç olarak, "güncel olmayan" derleme (Xamarin İOS veya Unity gibi) kullanan 
ortamlarda varsayılan olarak desteklenmez. Seri hale getirici/seri hale getirici kodunu "önceden oluşturma" 
yoluyla bu ortamlarda MessagePack kullanmak mümkündür. Daha fazla bilgi için bkz. MessagePack-CSharp 
belgeleri. Serileştiriciler önceden oluşturulduktan sonra, AddMessagePackProtocoi geçirilen yapılandırma temsilcisini 
kullanarak kaydedebilirsiniz: 

Services. AddSignalR() 

.AddMessagePackProtocol(options => 

{ 

options.FormatterResolvers = new List<MessagePack.IFormatterResolver>() 

{ 

MessagePack.Resolvers.GeneratedResolver.Instance, 

MessagePack.Resolvers.StandardResolver.Instance 

}; 

}); 

Tür denetimleri MessagePack 'te daha sıkı 

JSON hub 'ı protokolü, seri durumdan çıkarma sırasında tür dönüştürmeleri gerçekleştirecek. Örneğin, gelen 
nesnenin bir sayı olan ( { foo: 42 } ) bir özellik değeri varsa, ancak .NET sınıfındaki özelliği string türündedir, 
değer dönüştürülür. Ancak, MessagePack bu dönüştürmeyi gerçekleştirmez ve sunucu tarafı günlüklerinde (ve 
konsolunda) görünebileceğini bir özel durum oluşturur: 

InvalidDataException: Error binding arguments. Make sure that the types of the provided values match the types 
of the hub method being invoked. 

Bu sınırlama hakkında daha fazla bilgi için bkz. GitHub sorun ASPNET/SignalR#2937. 

İlgili kaynaklar 

• Başlarken 

• .N ET istemcisi 

• JavaScript istemcisi 
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ASP.NET Core SignalR istemciden sunucuya ve sunucudan istemciye akışı destekler.Bu, veri parçalarının zaman 
içinde nereden ulaştığını senaryolar için yararlıdır. Akış sırasında her parça, tüm verilerin kullanılabilir hale 
gelmesini beklemek yerine istemciye veya sunucuya gönderilir. 

ASP.NET Core SignalR, sunucu yöntemlerinin akış dönüş değerlerini destekler.Bu, veri parçalarının zaman içinde 
nereden ulaştığını senaryolar için yararlıdır. Bir dönüş değeri istemciye akışa eklendiğinde, her parça, tüm verilerin 
kullanılabilir hale gelmesini beklemek yerine istemciye gönderilir. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Akış için bir hub ayarlama 

Hub yöntemi, IAsyncEnumerable<T >, ChannelReader<T>, Task<iAsyncEnumerabie<T>> veya 
Task<channeiReader<T» döndürdüğünde otomatik olarak bir akış hub yöntemi haline gelir. 

Bir hub yöntemi, bir ChannelReader<T> veya Task<channeiReader<T» döndürdüğünde otomatik olarak akış hub 
yöntemi haline gelir. 

Sunucudan istemciye akış 

Akış hub'l yöntemleri, ChannelReader<T> ek olarak IAsyncEnumerable<T> döndürebilir. IAsyncEnumerable<T> 
döndürmenin en kolay yolu, aşağıdaki örnekte gösterildiği gibi hub yöntemini zaman uyumsuz bir yineleyici 
yöntemi yaparak kullanmaktır. Merkez zaman uyumsuz Yineleyici yöntemleri, istemci akıştan aboneliği 
kaldırdığında tetiklenen bir canceliationToken parametresi kabul edebilir. Zaman uyumsuz Yineleyici yöntemleri, 
channelReader erken olarak döndürülmemek veya ChannelWriter<T>tamamlamadan yöntemden çıkmak gibi 
kanallarla ortak olan sorunlardan kaçının. 


NOTE 

Aşağıdaki örnek gerektirir C# 8.0 veya üzeri. 











public class AsyncEnumerableHub : Hub 

{ 

public async IAsyncEnumerable<int> Counter( 
int countj 
int delay, 

CancellationToken cancellationToken) 

{ 

for (var i = 0; i < count; i++) 

{ 

// Check the cancellation token regularly so that the server will stop 
// producing items if the Client disconnects. 
cancellationToken.ThrowIfCancellationRequested(); 

yield return i; 

// Use the cancellationToken in other APIs that accept cancellation 
// tokens so the cancellation can flow down to them. 
await Task.Delay(delay, cancellationToken); 

} 

} 

} 


Aşağıdaki örnekte, kanalları kullanarak istemciye veri akışı hakkında temel bilgiler gösterilmektedir. 
ChannelWriter<T>bir nesne her yazıldığında, nesne hemen istemciye gönderilir. Sonunda channeiwriter , 
istemciye akışın kapatıldığını bildirmek için tamamlanır. 


NOTE 

Arka plan iş parçacığında channelwriter<T> yazın ve channelReader mümkün olan en kısa sürede geri döndürün. Diğer 
Merkez çağırmaları channelReader döndürülünceye kadar engellenir. 

try ... catch mantığı çevrele. Hub yöntemi çağrısının düzgün şekilde tamamlandığından emin olmak için catch ve 
catch dışında channel doldurun. 






public ChannelReader<int> Counter( 
int count, 
int delay, 

CancellationToken cancellationToken) 

{ 

var channel = Channel.CreateUnbounded<int>(); 

// We don't want to await WriteItemsAsync, otherwise we'd end up waiting 
// for ali the items to be written before returning the channel back to 
// the Client. 

_ = WriteItemsAsync(channel.Writer, count, delay, cancellationToken); 
return channel.Reader; 

} 

private async Task WriteItemsAsync( 

ChannelWriter<int> writer, 
int count, 
int delay, 

CancellationToken cancellationToken) 

{ 

Exception localException = null; 
try 
{ 

for (var i = 0; i < count; i++) 

{ 

await writer.WriteAsync(i, cancellationToken); 

// Use the cancellationToken in other APIs that accept cancellation 
// tokens so the cancellation can flow down to them. 
await Task.Delay(delay, cancellationToken); 

} 

} 

catch (Exception ex) 

{ 

localException = ex; 

} 

writer.Complete(localException); 

} 



public class StreamHub : Hub 

{ 

public ChannelReader<int> Counter( 
int countj 
int delay, 

CancellationToken cancellationToken) 

{ 

var channel = Channel.CreateUnbounded<int>(); 

// We don't want to await WriteItemsAsync, otherwise we'd end up waiting 
// for ali the items to be written before returning the channel back to 
// the Client. 

_ = WriteItemsAsync(channel .l/Jriter., count, delay, cancellationToken); 
return channel.Reader; 

} 

private async Task WriteItemsAsync( 

ChannelWriter<int> writer, 
int countj 
int delay, 

CancellationToken cancellationToken) 

{ 

try 

{ 

for (var i = 0; i < count; i++) 

{ 

// Check the cancellation token regularly so that the server will stop 
// producing items if the Client disconnects. 
cancellationToken.ThrowIfCancellationRequested(); 
await writer.WriteAsync(i); 

// Use the cancellationToken in other APIs that accept cancellation 
// tokens so the cancellation can flow down to them. 
await Task.Delay(delay, cancellationToken); 

} 

} 

catch (Exception ex) 

{ 

writer.TryComplete(ex); 

} 

writer.TryComplete(); 

} 

} 



public class StreamHub : Hub 

{ 

public ChannelReader<int> Counter(int count, int delay) 

{ 

var channel = Channel.CreateUnbounded<int>(); 

// We don't want to await l/JriteltemsAsync, otherwise we'd end up waiting 
// for ali the items to be written before returning the channel back to 
// the Client. 

_ = WriteItemsAsync(channel .l/Jriter., count, delay); 
return channel.Reader; 

} 

private async Task WriteItemsAsync( 

ChannelWriter<int> writer, 
int countj 
int delay) 

{ 

try 

{ 

for (var i = 0; i < count; i++) 

{ 

await writer.WriteAsync(i); 
await Task.Delay(delay); 

} 

} 

catch (Exception ex) 

{ 

writer.TryComplete(ex); 

} 

writer.T ryComplete(); 

} 

} 


Sunucudan istemciye akış hub 'ı yöntemleri, istemci akıştan aboneliği kaldırdığında tetiklenen bir 
canceliationToken parametresini kabul edebilir. Sunucu işlemini durdurmak ve istemci akışın sonundan önce 
bağlantıyı kestiğinde tüm kaynakları serbest bırakmak için bu belirteci kullanın. 

İstemciden sunucuya akış 

Hub yöntemi, ChannelReadercT> veya !AsyncEnumerable<T >türünde bir veya daha fazla nesne kabul ettiğinde, 
otomatik olarak istemciden sunucuya akış hub yöntemi haline gelir. Aşağıdaki örnek, istemciden gönderilen akış 
verilerini okumayla ilgili temel bilgileri gösterir, istemci ChannelWriter<T>her yazdığında, veriler hub yönteminin 
okuduğu sunucuda ChannelReader yazılır. 

public async Task UploadStream(ChannelReader<string> stream) 

{ 

while (await stream.WaitToReadAsync()) 

{ 

while (stream.TryRead(out var item)) 

{ 

// do something with the stream item 
Console.WriteLine(item); 

} 

} 

} 


Yöntemin IAsyncEnumerable<T> bir sürümü aşağıda verilmiştir. 







.NET istemcisi 


Sunucudan istemciye akış 


HubConnection streamAsync ve streamAsChannelAsync yöntemleri sunucudan istemciye akış yöntemlerini çağırmak 
için kullanılır. Hub yöntemi adı ve streamAsync veya streamAsChannelAsync , hub metodunda tanımlanan bağımsız 
değişkenleri geçirin. streamAsync<T> ve streamAsChanneiAsync<T> genel parametresi, akış yöntemi tarafından 
döndürülen nesne türünü belirtir. iAsyncEnumerabie<T> veya channeiReader<T> türünde bir nesne, akış çağrısından 
döndürülür ve istemcideki akışı temsil eder. 


IAsyncEnumerable<int> döndüren StreamAsync bir Örnek: 

// Cali "Cancel" on this CancellationTokenSource to send a cancellation message to 
// the server, which will trigger the corresponding token in the hub method. 
var CancellationTokenSource = new CancellationTokenSource(); 
var stream = await hubConnection.StreamAsync<int>( 

"Counter", 10, 500, CancellationTokenSource.Token); 

await foreach (var count in stream) 

{ 

Console.Writel_ine($" {count}"); 

} 

Console.WriteLine("Streaming completed"); 

ChannelReader<int> döndüren karşılık gelen StreamAsChannelAsync Örneği: 

// Cali "Cancel" on this CancellationTokenSource to send a cancellation message to 
// the server, which will trigger the corresponding token in the hub method. 
var CancellationTokenSource = new CancellationTokenSource(); 
var channel = await hubConnection.StreamAsChannelAsync<int>( 

"Counter", 10, 500, CancellationTokenSource.Token); 

// Wait asynchronously for data to become available 
while (await channel.WaitToReadAsync()) 

{ 

// Read ali currently available data synchronously, before waiting for more data 
while (channel.TryRead(out var count)) 

{ 

Console.WriteLine($"{count}"); 

} 

} 

Console.WriteLine("Streaming completed"); 

HubConnection StreamAsChannelAsync yöntemi, sunucudan istemciye akış yöntemini çağırmak için kullanılır. 
















streamAschannelAsync için hub yöntemi adını ve hub yöntemi içinde tanımlanan bağımsız değişkenleri geçirin. 
streamAschanneiAsync<T> genel parametresi, akış yöntemi tarafından döndürülen nesne türünü belirtir. Akış 
çağrısından bir channeiReader<T> döndürülür ve istemcideki akışı temsil eder. 

// Cali "Cancel" on this CancellationTokenSource to send a cancellation message to 
// the servet", which will trigger the correspondlng token İn the hub method. 
var CancellationTokenSource = new CancellationTokenSource(); 
var channel = await hubConnection.StreamAsChannelAsync<int>( 

"Counter", 10, 500, CancellationTokenSource.Token); 

// Wait asynchronously for data to become available 
while (await channel.WaitToReadAsync()) 

{ 

// Read ali currently available data synchronously, before waiting for more data 
while (channel.TryRead(out var count)) 

{ 

Console.WriteLine($"{count}"); 

} 

} 

Console.WriteLine("Streaming completed"); 

HubConnection StreamAschannelAsync yöntemi, sunucudan istemciye akış yöntemini çağırmak için kullanılır. 
StreamAschannelAsync için hub yöntemi adını ve hub yöntemi içinde tanımlanan bağımsız değişkenleri geçirin. 
streamAsChanneiAsync<T> genel parametresi, akış yöntemi tarafından döndürülen nesne türünü belirtir. Akış 
çağrısından bir channeiReader<T> döndürülür ve istemcideki akışı temsil eder. 

var channel = await hubConnection 

,StreamAsChannelAsync<int>("Counter", 10, 500, CancellationToken.None); 

// Wait asynchronously for data to become available 
while (await channel.WaitToReadAsync()) 

{ 

// Read ali currently available data synchronously, before waiting for more data 
while (channel.TryRead(out var count)) 

{ 

Console.WriteLine($"{count}"); 

} 

} 

Console.WriteLine("Streaming completed"); 


İstemciden sunucuya akış 

.NET istemcisinden istemciden sunucuya akış hub 'ı yöntemini çağırmak için iki yol vardır.Çağrılan hub yöntemine 



verilerle yeni bir öğe alır. 

Bir iAsyncEnumerabie nesnesi kullanıyorsanız, akış öğeleri döndüren yöntem çıktıktan sonra akış sonlanır. 


NOTE 

Aşağıdaki örnek gerektirir C# 8.0 veya üzeri. 
















async IAsyncEnumerable<string> clientStreamData() 

{ 

for (var i = 0; i < 5; i++) 

{ 

var data = await FetchSomeData(); 
yield return data; 

} 

//After the for loop has completed and the local function exits the stream completion will be sent. 

} 

await connection.SendAsync("UploadStream", clientStreamData()); 

channeiwriter kullanıyorsanız, kanalı channei.writer.compiete() ile tamamlıyoruz: 

var channel = Channel.CreateBounded<string>(10); 
await connection.SendAsync("UploadStream", channel.Reader); 
await channel.Writer.WriteAsync("some data"); 
await channel.Writer.WriteAsync("some more data"); 
channel.Writer.Complete(); 


JavaScript istemcisi 

Sunucudan istemciye akış 

JavaScript istemcileri, connection.stream hub 'larda sunucudan istemciye akış yöntemlerini çağırır, stream 
yöntemi iki bağımsız değişkeni kabul eder: 

• Hub yönteminin adı. Aşağıdaki örnekte, hub yöntemi adı counter . 

• Hub yönteminde tanımlanan bağımsız değişkenler. Aşağıdaki örnekte, bağımsız değişkenler alacak akış öğesi 
sayısı ve akış öğeleri arasındaki gecikme için bir sayıdır. 


connection. stream , subscribe yöntemi içeren bir IStreamResult döndürür. Bir IStreamSubscriber subscribe 
geçirin ve complete çağrısından bildirimleri almak için next , error ve stream geri çağırmaları ayarlayın. 

connection.stream("Counter", 10, 500) 

.subscribe({ 

next: (item) => { 

var li = document.createElement("li"); 
li.textContent = item; 

document.getElementByld("messagesList").appendChild(li); 

b 

complete: () => { 

var li = document.createElement("li"); 
li.textContent = "Stream completed"; 

document. get Element Byld("messages List") .appendChild(li); 

}, 

error: (err) => { 

var li = document.createElement("li"); 
li.textContent = err; 

document. get Element Byld("messages List") .appendChild(li); 

}, 

}); 

Akışı istemciden sonlandırmak için subscribe yönteminden döndürülen ısubscription dispose yöntemi çağırın. 
Bu yöntemi çağırmak, bir tane sağladıysanız hub yönteminin canceliationToken parametresinin iptal edilmesine 
neden olur. 













connection.stream("Counter", 10, 500) 

.subscribe({ 

next: (item) => { 

var li = document.createElement("li"); 
li.textContent = item; 

document.getElementByld("messagesList").appendChild(li); 

}, 

complete: () => { 

var li = document.createElement("li"); 
li.textContent = "Stream completed"; 

document.getElementByld("messagesList").appendChild(li); 

h 

error: (err) => { 

var li = document.createElement("li"); 
li.textContent = err; 

document .getElementByld("messagesList"). appendChild(li); 

}, 

}); 

Akışı istemciden sonlandırmak için 

İstemciden sunucuya akış 

JavaScript istemcileri, çağrılan hub yöntemine bağlı olarak bir subject send , invoke veya stream bir bağımsız 
değişken olarak geçirerek hub 'larda istemciden sunucuya akış yöntemlerini çağırır, subject , subject gibi 
görünen bir sınıftır. Örneğin, RxJS 1 de, bu kitaplıktaki Konu sınıfını kullanabilirsiniz. 

const subject = new signalR.Subject(); 

yield connection.send("UploadStream"j subject); 

var iteration = 0; 

const intervalHandle = setlnterval(() => { 
iteration++; 

subject.next(iteration.toString()); 
if (iteration === 10) { 

clearlnterval(intervalHandle); 
subject.complete(); 

} 

}, 500); 

Bir öğeyle subject.next(item) çağırmak öğeyi akışa yazar ve hub yöntemi sunucudaki öğeyi alır. 

Akışı sonlandırmak için subject.compiete() çağırın. 


subscribe yönteminden döndürülen ısubscription dispose yöntemi çağırın. 


Java istemcisi 

Sunucudan istemciye akış 

SignalR Java istemcisi, akış yöntemlerini çağırmak için stream yöntemini kullanır, stream üç veya daha fazla 
bağımsız değişken kabul eder: 

• Akış öğelerinin beklenen türü. 

• Hub yönteminin adı. 

• Hub yönteminde tanımlanan bağımsız değişkenler. 


hubConnection.stream(String.elass, "ExampleStreamingHubMethod ", "Argl") 
.subscribe( 

(item) -> {/* Define your onNext handler here. */ }, 

(error) -> {/* Define your onError handler here. */}, 

() -> {/* Define your onCompleted handler here. */}); 













HubConnection 


stream yöntemi akış öğesi türü için bir observable döndürür. Observable türünün subscribe 
yöntemi onNext , onError ve onCompleted iş ley ici leri ni n tanımlanmıştır. 

Ek kaynaklar 

• Merkezler 

• .NET istemcisi 

• JavaScript istemcisi 

• Azure'a Yayımlama 






ASPNET SignalR ve ASPNET Core arasındaki farklar 
SignalR 
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ASP.NET Core SignalR, ASP.NET SignalRiçin istemcilerle veya sunucularla uyumlu değildir.Bu makalede, 
ASP.NET Core SignalR kaldı rı lan veya değiştirilen özellikler ayrıntılı olarak anlatılmaktadır. 


SignalR sürümünü belirleme 



ASP.NET SİGNALR 

ASP.NET CORE SİGNALR 

Sunucu NuGet paketi 

Microsoft. AspNet.SignalR 

Yok. Microsoft. AspNetCore. app Shared 
Framevvork 'e dahildir. 

istemci NuGet paketleri 

Microsoft. AspNet.SignalR. istemcilerinin 
Microsoft. AspNet.SignalR. JS 

Microsoft. AspNetCore.SignalR. 
İstemcilerinin 

JavaScript istemcisi NPM paketi 

SignalR 

(fflmicrosoft/signalr 

Java istemcisi 

GitHub deposu (kullanım dışı) 

Maven paketi com. Microsoft. SignalR 

Sunucu uygulaması türü 

ASP.NET (System. Web) veya OWıN Self- 
Host 

ASP.NET Core 

Desteklenen sunucu platformları 

.NET Framevvork 4,5 veya üzeri 

.NET Core 3,0 veya üzeri 


ASP.NET SİGNALR 

ASPNET CORE SİGNALR 

Sunucu NuGet paketi 

Microsoft. AspNet.SignalR 

Microsoft. AspNetCore. app (.NET Core) 


Microsoft. AspNetCore.SignalR (.NET 
Framevvork) 


istemci NuGet paketleri 

Microsoft. AspNet.SignalR. istemcilerinin 
Microsoft. AspNet.SignalR. JS 

Microsoft. AspNetCore.SignalR. 
İstemcilerinin 

JavaScript istemcisi NPM paketi 

SignalR 

(Baspnet/signalr 

Java istemcisi 

GitHub deposu (kullanım dışı) 

Maven paketi com. Microsoft. SignalR 

Sunucu uygulaması türü 

ASP.NET (System. Web) veya OWıN Self- 
Host 

ASP.NET Core 

Desteklenen sunucu platformları 

.NET Framevvork 4,5 veya üzeri 

.NET Framevvork 4.6.1 veya üzeri 
.NET Core 2,1 veya üzeri 


Özellik farklılıkları 


Otomatik yeniden bağlantılar 

ASP.NET SignalR: 






• Varsayılan olarak, bağlantı kesildiğinde SignalR sunucuya yeniden bağlanmaya çalışır. 

ASP.NET CoreSignalR: 

• Otomatik yeniden bağlantılar hem net istemcisiyle hem de JavaScript istemcisiylebirlikte kabul edilir: 

HubConnection connection = new HubConnectionBuilder() 

.Withllrl(new Uri("http://127.0.0.1:5000/chatHub")) 

.WithAutomaticReconnect() 

.Build(); 


const connection = new signalR.HubConnectionBuilder() 

.withllrl("/chatHub") 

.withAutomaticReconnect() 

.build(); 

ASP.NET Core 3,0 1 dan önce SignalR otomatik yeniden bağlanma desteği desteklemez, istemcinin bağlantısı 
kesilirse, kullanıcının yeniden bağlanmak için açık olarakyeni bir bağlantı başlatması gerekir. ASP.NET SignalR' de, 
bağlantı kesildiğinde SignalR sunucuya yeniden bağlanmaya çalışır. 

Protokol desteği 

ASP.NET Core SignalR, JSON 'ı ve MessagePacktabanlı yeni bir ikili protokolü destekler. Ek olarak özel protokoller 
de oluşturulabilir. 

Taşımalar 

ASP.NET Core SignalRiçin süresiz çerçeve taşıması desteklenmez. 

Sunucu farkları 

ASP.NET Core SignalR sunucu tarafı kitaplıkları, hem Razor hem de MVC projeleri için ASP.NET Core Web 
uygulaması şablonunda kullanılan Microsoft. Aspnetcore. app'e dahildir. 


ASP.NET CoreSignalR birASP.NET Core ara yazılımı. startup.configureServices AddSignalR çağırarak 
yapılandırılması gerekir. 


Services.AddSignaİR() 

Yönlendirmeyi yapılandırmak için, yolları 
hub 'lara eşleyin. 

Startup.configure 

yönteminde UseEndpoints yöntemi çağrısının içindeki 


app.UseRouting(); 


app.UseEndpoints(endpoints => 

{ 

endpoints.MapHub<ChatHub>("/hub"); 

}); 

Yönlendirmeyi yapılandırmak için, yolları startup.configure yönteminde UseSignalR yöntemi çağrısının içindeki 
hub 'lara eşleyin. 

app.UseSignalR(routes => 

{ 

routes.MapHub<ChatHub>("/hub"); 

}); 







Yapışkan oturumlar 

ASP.NET SignalR için genişleme modeli, istemcilerin gruptaki herhangi bir sunucuya yeniden bağlanmasını ve 
iletileri göndermesini sağlar. ASP.NET Core SignalR, istemci bağlantı süresince aynı sunucu ile etkileşime sahip 
olmalıdır. Redsıs kullanarak genişleme için, bu, yapışkan oturumların gerekli olduğu anlamına gelir. Azure SignalR 
hizmetinıkullanarak genişleme için, hizmet istemcilerle bağlantıları işlediği için yapışkan oturumlar gerekli değildir. 

Bağlantı başına tek hub 

ASP.NET Core SignalR, bağlantı modeli basitleştirilmiştir.Bağlantılar, birden çok hub 'a erişimi paylaşmak için 
kullanılan tek bir bağlantı yerine doğrudan tek bir hub 'a yapılır. 

Akış 

ASP.NET Core SignalR artık hub 'dan istemciye veri akışını desteklemektedir. 

State 

istemcilerle Hub (genellikle Hubstate olarak adlandırılır) arasında rastgele durum geçirme özelliği kaldırılmıştır ve 
ilerleme durumu iletileri için destek de sağlar. Şu anda hub proxy 'lerinin karşılığı yok. 

PersistentConnection kaldırma 

ASP.NET Core SignalR, PersistentConnection sınıfı kaldırılmıştır. 

GlobalHost 

ASP.NET Core çerçeveye yerleşik bağımlılık ekleme (dı) vardır. Hizmetler, Hubcontext'e erişmek için dı kullanabilir. 
HubContext almak için ASP.NET SignalR içinde kullanılan GlobalHost nesnesi ASP.NET Core SignalRyok. 

HubPipeline 

ASP.NET Core SignalR HubPipeline modül desteğine sahip değildir. 

İstemci farkları 

TypeScript 

ASP.NET Core SignalR istemcisi TypeScript'te yazılmıştır. JavaScript istemcisini kullanırken JavaScript veya 
TypeScript ile yazabilirsiniz. 

JavaScript istemcisi NPM 'de barındırılıyor 

ASP.NET sürümlerinde JavaScript istemcisi, Visual Studio 'da bir NuGet paketi aracılığıyla elde edildi. AS P.N ET 
Core sürümlerinde, @microsoft/signair NPM paketi JavaScript kitaplıklarını içerir.Bu paket, ASP.NET Core Web 
uygulaması şablonuna dahil değildir. @microsoft/signair NPM paketini edinmek ve yüklemek için NPM kullanın. 

npm init -y 

npm install (Smicrosoft/signalr 

ASP.NET sürümlerinde JavaScript istemcisi, Visual Studio 'da bir NuGet paketi aracılığıyla elde edildi. ASP.N ET 
Core sürümlerinde, @aspnet/signair NPM paketi JavaScript kitaplıklarını içerir.Bu paket, ASP.NET Core Web 
uygulaması şablonuna dahil değildir. @aspnet/signair NPM paketini edinmek ve yüklemek için NPM kullanın. 

npm init -y 

npm install @aspnet/signalr 

jQuery 

JQuery üzerindeki bağımlılık kaldırılmıştır, ancak projeler jQuery kullanmaya devam edebilir. 

Internet Explorer desteği 

ASP.NET Core SignalR Microsoft Internet Explorer 11 veya üstünü gerektirir (ASP.NET SignalR desteklenen 











Microsoft Internet Explorer 8 ve üzeri). 

JavaScript istemci yöntemi sözdizimi 

JavaScript sözdizimi, SignalRASP.NET sürümünden değiştirilmiştir. $connection nesnesini kullanmak yerine, 

Hubconnectionbuilder API 'sini kullanarak bir bağlantı oluşturun. 

const connection = new signalR.HubConnectionBuilder() 

.withllrl("/hub") 

.build(); 

Hub 'ın çağırakullanabileceği istemci yöntemlerini belirtmek için on metodunu kullanın. 

JavaScript sözdizimi, SignalRASP.NET sürümünden değiştirilmiştir. $connection nesnesini kullanmak yerine, 

Hubconnectionbuilder API 'sini kullanarak bir bağlantı oluşturun. 

const connection = new signalR.HubConnectionBuilder() 

.withllrl("/hub") 

,build(); 


Hub 'm çağırakullanabileceği istemci yöntemlerini belirtmek için on metodunu kullanın. 

connection.on("ReceiveMessage"j (user, message) => { 

const msg = message.replace(/&/gj "Sampj").replace(/</gj "&ltj").neplace(/>/g, "&gtj"); 
const encodedMsg = ’${user} says ${msg}'; 
console.log(encodedMsg); 

}); 

istemci yöntemini oluşturduktan sonra hub bağlantısını başlatın. Günlüğe kaydetmek veya hataları işlemek için bir 
catch metodunu zincirleyin. 

connection.start().catch(err => console.error(err)); 


Hub proxy 'leri 

Hub proxy 'leri artık otomatik olarak oluşturulmaz. Bunun yerine, yöntem adı Invoke API 'sine bir dize olarak 
geçirilir. 

Hub proxy 'leri artık otomatik olarak oluşturulmaz. Bunun yerine, yöntem adı Invoke API 'sine bir dize olarak 
geçirilir. 

.NET ve diğer istemciler 

Microsoft. AspNetCore.SignalR. istemci NuGet paketi ASP.NET Core SignalR.NET istemci kitaplıklarını içerir. 
Hub 'a bağlantı örneği oluşturmak ve derlemek için HubConnectionBuilder kullanın. 

connection = new HubConnectionBuilder() 

.WithUrl("url") 

.Build(); 


Ölçek Genişletme farklılıkları 

ASP.NET SignalR SQL Server ve Redsıs 'yi destekler.ASP.NET Core SignalR Azure SignalR hizmeti 'ni ve Redsıs 
'yi destekler. 


ASP.NET 









• Azure Service Bus iie ölçeği SignalR 

• Redsıs ile SignalR ölçeği 

• SQL Server ile ölçeği SignalR 

ASP.NET Core 

• Azure SignalR hizmeti 

• Redsıs geri düzlemi 

Ek kaynaklar 

• Merkezler 

• JavaScript istemcisi 

• .N ET istemcisi 

• Desteklenen platformlar 


ASPNET Core desteği WebSockets 
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Tom Dykstra ve Andrevv Stanton-nurte 

Bu makalede, ASP.N ET Core 1 de VVebSockets ile çalışmaya başlama açıklanmaktadır.VVebSocket (RFC 6455), 
TCP bağlantıları üzerinden iki yönlü kalıcı iletişim kanalları sağlayan bir protokoldür. Bu, sohbet, pano ve oyun 
uygulamaları gibi hızlı, gerçek zamanlı iletişimden faydalanabilir uygulamalarda kullanılır. 

Örnek kodu görüntüleyin veya indirin (nasıl indirilir). Nasıl çalıştırılır? 

SignalR 

ASP.NET Core SignalR , uygulamalara gerçek zamanlı Web işlevselliği eklemeyi kolaylaştıran bir kitaplıktır. 
Mümkün olduğunda VVebSockets kullanır. 

Çoğu uygulama için ham VVebSockets üzerinde SignalR önerilir.SignalR, VVebSockets 'in kullanılamadığı 
ortamlar için taşıma geri dönüşü sağlar. Ayrıca, basit bir uzak yordam çağrısı uygulama modeli sağlar.Çoğu 
senaryoda, ham VVebSockets kullanmaya kıyasla SignalR önemli bir performans dezavantajı yoktur. 

Prerequisites 

• ASP.NET Core 1,1 veya üzeri 

• ASP.NET Core destekleyen herhangi bir işletim sistemi: 

o VVİndovvs 7/Windows Server 2008 veya üzeri 
o Linux 
o macOS 

• Uygulama 11S ile VVİndovvs üzerinde çalışıyorsa: 

o VVİndovvs 8/Windows Server 2012 veya üzeri 
o IIS 8/1 IS 8 Express 

o VVebSockets etkinleştirilmelidir ( 11S/lIS Express destek bölümüne bakın.). 

• Uygulama http. sysüzerinde çalışıyorsa: 

o VVİndovvs 8/Windows Server 2012 veya üzeri 

• Desteklenen tarayıcılar için bkz. https://caniuse.com/#feat=websockets. 

NuGet paketi 

Microsoft. AspNetCore. VVebSockets paketini yükler. 

Ara yazılımı yapılandırma 

startup sınıfının configure metoduna VVebSockets ara yazılımını ekleyin: 

app. UseİAİebSockets (); 


Aşağıdaki ayarlar yapılandırılabilir: 






• KeepAiiveintervai -proxy ’lerin bağlantının açık kalmasını sağlamak için istemciye "ping" çerçeveleri 
gönderme sıklığı. Varsayılan değer iki dakikadır. 

• ReceiveBuffersize -verileri almak için kullanılan arabelleğin boyutu. Gelişmiş kullanıcıların, verilerin boyutuna 
bağlı olarak performans ayarlaması için bunu değiştirmesi gerekebilir. Varsayılan değer 4 KB 'tır. 

Aşağıdaki ayarlar yapılandırılabilir: 

• KeepAiiveintervai -proxy ’lerin bağlantının açık kalmasını sağlamak için istemciye "ping" çerçeveleri 
gönderme sıklığı. Varsayılan değer iki dakikadır. 

• ReceiveBufferSize-verileri almak için kullanılan arabelleğin boyutu. Gelişmiş kullanıcıların, verilerin boyutuna 
bağlı olarak performans ayarlaması için bunu değiştirmesi gerekebilir. Varsayılan değer 4 KB 'tır. 

• AiiowedOrigins -VVebSocket istekleri için izin verilen kaynak üst bilgi değerleri listesi. Varsayılan olarak, tüm 
kaynaklardan izin verilir. Ayrıntılar için aşağıdaki "WebSocket kaynak kısıtlaması" başlığına bakın. 

var webSocketOptions = new WebSocketOptions() 

{ 

KeepAlivelnterval = TimeSpan.FromSeconds(120), 

ReceiveBufferSize = 4 * 1024 

}; 


app.UseWebSockets(webSocketOptions); 


VVebSocket isteklerini kabul et 

istek yaşam döngüsünün (daha sonra configure yönteminde veya bir eylem yönteminde) daha sonra bir yerde, 
bir VVebSocket isteği olup olmadığını denetleyin ve VVebSocket isteğini kabul edin. 

Aşağıdaki örnek daha sonra configure yönteminde verilmiştir: 

app.Use(async (context, next) => 

{ 

if (context.Request.Path == "/ws") 

{ 

if (context.IfllebSockets.IsWebSocketRequest) 

{ 

WebSocket webSocket = await context.WebSockets.AcceptWebSocketAsync(); 
await Echo(contextj webSocket); 

} 

else 

{ 

context.Response.StatusCode = 400j 

} 

} 

else 

{ 

await next(); 

} 

}); 

Herhangi bir URL 'de bir VVebSocket isteği gelebilir, ancak bu örnek kod yalnızca /ws isteklerini kabul eder. 

VVebSocket kullanırken, bağlantı süresince ara yazılım işlem hattını çalışır durumda tutmanız gerekir . Ara yazılım 
ardışık düzeni bittikten sonra bir VVebSocket iletisi göndermeye veya almaya çalışırsanız, aşağıdaki gibi bir özel 
durum alabilirsiniz: 









System.Net.WebSockets.WebSocketException (0x80004005): The nemote party closed the 1/JebSocket connection 
without completing the close handshake. —> System.ObjectDisposedException: Cannot write to the response 
body, the response has completed. 

Object name: 'HttpResponseStream'. 


VVebSocket 'e veri yazmak için bir arka plan hizmeti kullanıyorsanız, ara yazılım ardışık düzenini çalışır durumda 
tutmanız gerekir. Bunu bir TaskCompletionSource<TResult>kullanarak yapın. TaskCompletionSource arka plan 
hizmetinize geçirin ve VVebSocket ile bitirdiğinizde TrySetResult çağırın. Ardından, aşağıdaki örnekte gösterildiği 
gibi, istek sırasında Task özelliğini await : 

app.Use(async (context, next) => { 

var Socket = await context.WebSockets.AcceptWebSocketAsync(); 
var socketFinishedTcs = new TaskCompletionSource<object>(); 

BackgroundSocketProcessor.AddSocket(Socket , socketFinishedTcs); 

await socketFinishedTcs.Task; 

}); 


Bir eylem yönteminden çok yakında döndürüyseniz, VVebSocket kapalı özel durumu da oluşabilir. Bir eylem 
yönteminde bir yuvayı kabul ediyorsanız, işlem yönteminden dönmeden önce yuva kullanan kodun 
tamamlanmasını bekleyin. 

Önemli iş parçacığı sorunlarına neden olabileceği için, yuvanın tamamlanmasını beklemek için Task.wait() , 

Task.Resuit veya benzer engelleme çağrılarını hiçbir şekilde kullanmayın. await her zaman kullanın. 

İleti gönderme ve alma 

AcceptwebSocketAsync yöntemi, TCP bağlantısını VVebSocket bağlantısıyla yükseltir ve bir VVebSocket nesnesi 
sağlar, ileti göndermek ve almak için webSocket nesnesini kullanın. 

VVebSocket isteğini kabul eden daha önce gösterilen kod webSocket nesnesini bir Echo yöntemine geçirir. Kod 
bir ileti alır ve hemen aynı iletiyi geri gönderir, iletiler, istemci bağlantıyı kapatana kadar bir döngüde gönderilir ve 
alınır: 


private async Task Echo(HttpContext context, WebSocket webSocket) 

{ 

var buffer = new byte[1024 * 4]; 

WebSocketReceiveResult resuit = await webSocket.ReceiveAsync(new ArraySegment<byte>(buffer ), 
CancellationToken.None); 

while (Iresuit.CloseStatus.HasValue) 

{ 

await webSocket.SendAsync(new ArraySegment<byte>(buffer, 0 , resuit.Count), resuit.MessageType, 
resuit.EndOfMessage, CancellationToken.None); 

resuit = await webSocket.ReceiveAsync(new ArraySegment<byte>(buffer ), CancellationToken.None); 

} 

await webSocket.CloseAsync(resuit.CloseStatus.Value, resuit.CloseStatusDescriptionj 
CancellationToken.None); 

} 


Döngüye başlamadan önce VVebSocket bağlantısı kabul edildiğinde, ara yazılım ardışık düzeni sona erer.Yuva 
kapatıldıktan sonra işlem hattı kaldırımları. Diğer bir deyişle, VVebSocket kabul edildiğinde isteğin işlem hattında 
ileri doğru hareket ettirilmesi durduruluyor. Döngü bittiğinde ve yuva kapalıyken, istek ardışık düzeni yedekler. 


İstemci bağlantısı kesilen işleme 













istemci bağlantı kaybı nedeniyle bağlantısı kesildiğinde sunucu otomatik olarak bilgilendirilmedi. Sunucu, yalnızca 
istemci gönderirse, internet bağlantısı kaybedilmişse gerçekleştirilemez bir bağlantı kesme iletisi alır. Bu durumda 
bazı işlemleri gerçekleştirmek istiyorsanız, belirli bir zaman penceresinde istemciden hiçbir şey alınmadığında bir 
zaman aşımı ayarlayın. 

istemci her zaman ileti göndermiyor ve bağlantı boşta kaldığı için zaman aşımına uğramasını istemiyorsanız, 
istemcinin her X saniyede bir ping iletisi göndermesi için bir Zamanlayıcı kullanmasını sağlamak için bir 
Zamanlayıcı kullanmasını sağlayabilirsiniz. Sunucusunda, bir ileti öncekinden sonra 2 *X saniye içinde 
gelmediyse, bağlantıyı sonlandırın ve istemcinin bağlantısının kesildiğini bildirin. Beklenen zaman aralığının iki 
kez, ping iletisini tutabilecek Ağ gecikmeleri için ek süre kalmasını bekleyin. 

VVebSocket kaynak kısıtlaması 

CORS tarafından sunulan korumalar VVebSockets için geçerlidir.Tarayıcılar şunları desteklemez: 

• CORS ön uçuş istekleri gerçekleştirin. 

• VVebSocket istekleri yaparken Access-Control üst bilgilerinde belirtilen kısıtlamalara saygı. 

Ancak, tarayıcılar VVebSocket istekleri verirken origin üst bilgisini gönderir. Yalnızca beklenen kaynaklardan 
gelen VVebSockets izin verildiğinden emin olmak için uygulamalar bu üstbilgileri doğrulamak üzere 
yapılandırılmalıdır. 

Sunucunuzu "https://server.com" üzerinde barındırıyorsanız ve istemcinizi "https://client.com" üzerinde 
barındırıyorsanız, doğrulamak üzere VVebSockets için AiiowedOrigins listesine "https://client.com" ekleyin. 

var webSocketOptions = new WebSocketOptions() 

{ 

KeepAlivelnterval = TimeSpan.FromSeconds(120), 

ReceiveBufferSize = 4 * 1024 

}; 

webSocketOptions.AllowedOrigins.Add("https://Client.com"); 
webSocketOptions.AllowedOrigins.Add("https://www.Client.com"); 

app.UseWebSockets(webSocketOptions); 


NOTE 

origin üstbilgisi istemci tarafından denetlenir ve Referer üst bilgisi gibi erişilebilir. Bu üst bilgileri kimlik doğrulama 
mekanizması olarak kullanmayın. 


IIS/l IS Express desteği 

11S/lIS Express 8 veya üzeri ile Windows Server 2012 veya üzeri ve VVİndovvs 8 veya üzeri, VVebSocket protokolü 
için destek içerir. 


NOTE 

IIS Express kullanılırken VVebSockets her zaman etkindir. 


IIS üzerinde VVebSockets etkinleştirme 

VVİndovvs Server 2012 veya sonraki sürümlerde VVebSocket protokolü desteğini etkinleştirmek için: 









NOTE 

IIS Express kullanılırken bu adımlar gerekli değildir 


1. Yönet menüsündeki rol ve özellik ekleme sihirbazı 1 nı veya Sunucu Yöneticisibağlantısındaki bağlantıyı 
kullanın. 

2. Rol tabanlı veya özellik tabanlı yükleme 1 yi seçin. İleri ' yiseçin. 

3. Uygun sunucuyu seçin (yerel sunucu varsayılan olarak seçilidir). İleri ' yiseçin. 

4. Roller ağacında Web sunucusu (IIS) öğesini genişletin, Web sunucusu 1 nu genişletin ve ardından 
uygulama geliştirme' yi genişletin. 

5. VVebSocket protokolünüseçin. İleri ' yiseçin. 

6. Ek özellikler gerekmiyorsa, İleri' yi seçin. 

7. Yükle'yi seçin. 

8. Yükleme tamamlandığında sihirbazdan çıkmak için Kapat ' ı seçin. 

Windows 8 veya sonraki sürümlerde VVebSocket protokolü desteğini etkinleştirmek için: 


NOTE 

IIS Express kullanılırken bu adımlar gerekli değildir 


1. > programlar ve Özellikler > Programlar ve Özellikler \ *e gidin >\ * VVindovvs özelliklerini açın veya 
kapatın (ekranın sol tarafında). 

2. Şu düğümleri açın: Internet Information Services > VVorld Wide Web > Hizmetleri uygulama 
geliştirme özellikleri. 

3. VVebSocket protokolü özelliğini seçin. Tamam 1 ıseçin. 

Node. js üzerinde socket.io kullanırken VVebSocket 'i devre dışı bırakma 

Socket.io içindeki VVebSocket desteğini Node. jsüzerinde kullanıyorsanız, Web. config veya ApplicationHost. 
config dosyasındaki webSocket öğesini kullanarak varsayılan IIS VVebSocket modülünü devre dışı bırakın. Bu 
adım gerçekleştirilmemişse, IIS VVebSocket modülü Node.js ve uygulama yerine VVebSocket iletişimini işlemeye 
çalışır. 

<system.webServer> 

<webSocket enabled="false" /> 

</system.webServer> 


Örnek uygulama 

Bu makaleye eşlik eden örnek uygulama bir Echo uygulamasıdır. VVebSocket bağlantısı yapan bir Web sayfasına 
sahiptir ve sunucu istemciye geri aldığı tüm iletileri daha sonra sonlandırır. Uygulamayı bir komut isteminden 
çalıştırın (IIS Express Visual Studio 'dan çalışacak şekilde ayarlanmamış) ve http://localhost:5000 ' a gidin. Web 
sayfası, sol üstteki bağlantı durumunu gösterir: 
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Gösterilen URL 'y e WebSocket isteği göndermek için Bağlan ' ı seçin. Bir sınama iletisi girin ve Gönder 1 i seçin, 
işiniz bittiğinde yuvayı kapat' ı seçin. İletişim günlüğü bölümünde her açık, gönder ve Kapat eylemi 
gerçekleşir. 
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ASPNET Core SignalR günlüğe kaydetme ve tanılama 

13.11.2019 • 12 minutes to read^. Edit Online 


, Andrevv Stanton-nurte 

Bu makalede, sorunları gidermeye yardımcı olmak için ASP.NET Core SignalR uygulamanızdan tanılama 
toplamaya yönelik rehberlik sunulmaktadır. 

Sunucu tarafında günlüğe kaydetme 

VVARNING 

Sunucu tarafı günlükleri, uygulamanızdan önemli bilgiler içerebilir. Ham günlükleri hiçbir şekilde üretim uygulamalarından 
GitHub gibi genel forumlara nakletmeyin. 


SignalR AS P.N ET Core bir parçası olduğundan, ASP.NET Core günlük sistemini kullanır. Varsayılan 
yapılandırmada SignalR çok az bilgi günlüğe kaydedilir, ancak bu yapılandırılabilir. ASP.NET Core günlüğü 
yapılandırma hakkında ayrıntılar için ASP.NET Core günlüğe kaydetme hakkındaki belgelere bakın. 

SignalR iki günlükçü kategorisi kullanır: 

• Merkez protokolleriyle ilgili Günlükler için Microsoft.AspNetcone.SignalR , hub 'Ları etkinleştirme, yöntemleri 
çağırma ve hub ile ilgili diğer etkinlikler için 

• VVebSockets, uzun yoklama ve sunucu tarafından gönderilen olaylar ve alt düzey SignalR altyapısı gibi 
aktarımlarıyla ilgili Günlükler için Microsoft.AspNetCore.Http.Connections -. 

SignalRayrıntı 11 günlükleri etkinleştirmek için, aşağıdaki öğeleri Logging'' LogLevel alt bölümüne ekleyerek, 
yukarıdaki ön ekleri appSettings. JSON dosyanızdaki Debug düzeyine yapılandırın: 

{ 

"Logging": { 

"LogLevel": { 

"Default": "Debug", 

"System": "Information", 

"Microsoft": "Information", 

"Microsoft.AspNetCore.SignalR": "Debug", 

"Microsoft.AspNetCore.Http.Connections": "Debug" 

} 

} 

} 

Ayrıca, createwebHostBuiider yöntemdeki kodda de yapılandırabilirsiniz: 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.ConfigureLogging(logging => 

{ 

logging.AddFilter("Microsoft.AspNetCore.SignalR", LogLevel.Debug); 
logging.AddFilter("Microsoft.AspNetCore.Http.Connections", LogLevel.Debug); 

}) 

.UseStartup<Startup>(); 


JSON tabanlı yapılandırma kullanmıyorsanız, yapılandırma sisteminizde aşağıdaki yapılandırma değerlerini 













ayarlayın: 


Logging:LogLevel:Microsoft.AspNetCore.SignaİR 

= 

Debug 



Logging:LogLevel:Microsoft.AspNetCore.Http.Connections 

= 

Debug 


iç içe yapılandırma değerlerinin nasıl belirleneceğini belirlemek için yapılandırma sisteminizin belgelerini 
denetleyin. Örneğin, ortam değişkenlerini kullanırken, : yerine iki _ karakter kullanılır (örneğin, 

Logging_LogLevel_Microsoft.AspNetCore.SignaİR ). 

Uygulamanız için daha ayrıntılı tamlama toplanırken Debug düzeyinin kullanılması önerilir. Trace düzeyi çok 
düşük düzey Tanılamalar üretir ve uygulamanızdaki sorunları tanılamak için nadiren gereklidir. 

Sunucu tarafı günlüklerine erişin 

Sunucu tarafı günlüklerine erişme, çalıştırdığınız ortama bağlıdır. 

i IS dışında bir konsol uygulaması olarak 

Konsol uygulamasında çalıştırıyorsanız, konsol günlükçüsü varsayılan olarak etkinleştirilmelidir. SignalR Günlükler 
konsolunda görünür. 

Visual Studio 'dan IIS Express içinde 

Visual Studio çıktı penceresinde günlük çıktısını görüntüler. ASP.NET Core Web sunucusu açılır seçeneğini 
belirleyin. 

Azure App Service 

Azure App Service portalının tanılama günlükleri bölümünde uygulama günlüğü (dosya sistemi) seçeneğini 
etkinleştirin ve düzeyi verbose olarak yapılandırın. Günlükler günlük akış hizmetinden ve App Service dosya 
sistemindeki günlüklerde kullanılabilir olmalıdır. Daha fazla bilgi için bkz. Azure günlük akışı. 

Diğer ortamlar 

Uygulama başka bir ortama (örneğin, Docker, Kubernetes veya Windows hizmeti) dağıtılırsa, ortama uygun 
günlük sağlayıcılarının nasıl yapılandırılacağı hakkında daha fazla bilgi için bkz. .NET Core ve ASP.NET Core 
oturum açma. 

JavaScript istemci günlüğü 

VVARNING 

istemci tarafı günlükleri, uygulamanızdan önemli bilgiler içerebilir. Ham günlükleri hiçbir şekilde üretim uygulamalarından 
GitHub gibi genel forumlara nakletmeyin. 


JavaScript istemcisini kullanırken, HubConnectionBuiider"configureLogging yöntemi kullanarak günlüğe kaydetme 
seçeneklerini yapılandırabilirsiniz: 

let connection = new signalR.HubConnectionBuilder() 

,withUrl("/my/hub/unl") 

.configureLogging(signalR.LogLevel.Debug) 

,build(); 

Günlüğe kaydetmeyi tamamen devre dışı bırakmak için configureLogging yönteminde signalR.LogLevel.None 
belirtin. 

Aşağıdaki tabloda JavaScript istemcisi için kullanılabilir olan günlük düzeyleri gösterilmektedir.Günlük düzeyinin 
bu değerlerden birine ayarlanması, bu düzeyde ve tabloda üzerindeki tüm düzeylerde günlüğe kaydetmeyi sağlar. 















DÜZEY 


AÇIKLAMA 


None 

Hiçbir ileti günlüğe kaydedilmez. 

Critical 

Uygulamanın tamamında bir hata olduğunu gösteren mesajlar. 

Error 

Geçerli işlemdeki bir hatayı gösteren mesajlar. 

Wanning 

Önemli olmayan bir sorunu belirten mesajlar. 

Information 

Bilgi iletileri. 

Debug 

Tanılama iletileri hata ayıklama için yararlıdır. 

T race 

Belirli sorunları tanılamak için tasarlanan çok ayrıntılı tanılama 


iletileri. 


Ayrıntı düzeyini yapılandırdıktan sonra, Günlükler tarayıcı konsoluna yazılır (veya bir NodeJS uygulamasında 
standart çıkış). 

Günlükleri özel bir günlüğe kaydetme sistemine göndermek istiyorsanız, iLogger arabirimini uygulayan bir 
JavaScript nesnesi sağlayabilirsiniz. Uygulanması gereken tek yöntem, olayın düzeyini ve olayla ilişkili iletiyi alan 
log . Örneğin: 

import { ILogger, LogLevel, HubConnectionBuilder } from "@aspnet/signalr"; 

export class MyLogger implements ILogger { 

log(logLevel: LogLevel, message: string) { 

// Use 'message' and 'logLevel' to record the log message to your own system 

} 

} 

// later on, when configuning youn connection... 

let connection = new HubConnectionBuilder() 

.withUrl("/my/hub/url") 

.configuneLogging(new MyLogger()) 

.build(); 


.NET istemci günlüğü 

VVARNING 

İstemci tarafı günlükleri, uygulamanızdan önemli bilgiler içerebilir. Ham günlükleri hiçbir şekilde üretim uygulamalarından 
GitHub gibi genel forumlara nakletmeyin. 


.NET istemcisinden günlükleri almak için HubConnectionBuilder"configureLogging yöntemi kullanabilirsiniz. Bu, 
webHostBuiider ve HostBuiider"ConfigureLogging yöntemiyle aynı şekilde çalışmaktadır. ASP.N ET Core ' de 
kullandığınız günlük sağlayıcılarını yapılandırabilirsiniz. Ancak, bireysel günlük sağlayıcıları için NuGet paketlerini 
el ile yükleyip etkinleştirmeniz gerekir. 

Konsol günlüğü 

Konsol günlüğünü etkinleştirmek için Microsoft. Extensions. Logging. Console paketini ekleyin. Ardından, konsol 
günlükçüsü 'yi yapılandırmak için AddConsole yöntemini kullanın: 

















var connection = new HubConnectionBuilder() 
.WithUrl("https://example.com/my/hub/url") 
.ConfigureLogging(logging => 

{ 

// Log to the Console 
logging.AddConsole(); 

// This will set ALL logging to Debug level 
logging.SetMinimumLevel(LogLevel.Debug); 

}) 

.Build(); 


Çıkış penceresi günlüğüne hata ayıkla 

Günlükleri, Visual Studio 'daki Çıkış penceresine gitmek için de yapılandırabilirsiniz. Microsoft Extensions. 
Logging. Debug paketini yükleyip AddDebug yöntemi kullanın: 

var connection = new HubConnectionBuilder() 

.WithUrl("https://example.com/my/hub/url") 

.ConfigureLogging(logging => 

{ 

// Log to the Output Window 
logging.AddDebug(); 

// This will set ALL logging to Debug level 
logging.SetMinimumLevel(LogLevel.Debug) 

}) 

.Build(); 


Diğer günlüğe kaydetme sağlayıcıları 

SignalR, Serilog, seq, NLog veya Microsoft.Extensions.Logging ile tümleştirilen herhangi bir günlük sistemi gibi 
diğer günlük sağlayıcılarını destekler. Günlüğe kaydetme sisteminiz bir iLoggerProvider sağlıyorsa, bu dosyayı 
AddProvider kaydedebilirsiniz: 

var connection = new HubConnectionBuilder() 

.WithUrl("https://example.com/my/hub/url") 

.ConfigureLogging(logging => 

{ 

// Log to your custom provider 

logging.AddProvider(new MyCustomLoggingProvider()); 

// This will set ALL logging to Debug level 
logging.SetMinimumLevel(LogLevel.Debug) 

}) 

.Build(); 


Denetim ayrıntı düzeyi 

Uygulamanızdaki diğer yerlerden oturum açıyorsanız, varsayılan düzeyin Debug olarak değiştirilmesi çok ayrıntılı 
olabilir. Kayıt düzeyini SignalR Günlükler için yapılandırmak üzere bir filtre kullanabilirsiniz. Bu, sunucuda olduğu 
şekilde kodda yapılabilir: 







var connection = new HubConnectionBuilder() 
.WithUrl("https://example.com/my/hub/url") 
.ConfigureLogging(logging => 

{ 

// Register your providers 


// Set the default log level to Informatiorn but to Debug for SignalR-related loggers. 
logging.SetMinimumLevel(LogLevel.Information); 

logging.AddFilter("Microsoft.AspNetCore.SignalR", LogLevel.Debug); 
logging.AddFilter("Microsoft.AspNetCore.Http.Connections", LogLevel.Debug); 

}) 

.Build(); 


Ağ izlemeleri 

VVARNING 

Bir ağ izlemesi, uygulamanız tarafından gönderilen her iletinin tam içeriğini içerir. Ham ağ izlemelerini, üretim 
uygulamalarından GitHub gibi genel forumlara hiçbir şekilde yayımlayamazsınız. 


Bir sorunla karşılaşırsanız, ağ izleme bazen yararlı olabilecek çok sayıda bilgi sağlayabilir. Sorun izleyicimizde bir 
sorun oluşturacaksanız bu özellikle yararlı olur. 

Fiddler ile ağ izleme toplama (tercih edilen seçenek) 

Bu yöntem tüm uygulamalar için geçerlidir. 

Fiddler, HTTP izlemelerinin toplanması için çok güçlü bir araçtır. Telerik.com/Fiddleradresinden yükleyip 
uygulamayı çalıştırın ve sorunu yeniden oluşturun. Fiddler VVİndovvs için kullanılabilir ve macOS ve Linux için beta 
sürümleri mevcuttur. 

HTTPS kullanarak bağlanıyorsanız, Fiddler'ın HTTPS trafiğinin şifresini çözebilmesini sağlamaya yönelik bazı ek 
adımlar vardır. Daha ayrıntılı bilgi için bkz. Fiddler belgeleri. 

izlemeyi topladıktan sonra, dosya > seçerek izlemeyi dışarı aktarabilirsiniz, bu işlemi, menü çubuğundan tüm 

oturumları > Kaydet 1 i seçin. 
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Tcpdump ile bir ağ izlemesi toplayın (yalnızca macOS ve Linux) 

Bu yöntem tüm uygulamalar için geçerlidir. 

Komut kabuğundan aşağıdaki komutu çalıştırarak, tcpdump kullanarak ham TCP izlemeleri toplayabilirsiniz. Bir 
izin hatası alırsanız, root olması veya komutun sudo öneki olması gerekebilir: 

tcpdump -i [interface] -w trace.pcap 

[interface] , yakalamak istediğiniz ağ arabirimiyle değiştirin. Genellikle bu, /dev/ethe (Standart Ethernet 
arabiriminiz için) veya /dev/io 0 (localhost trafiği için) gibi bir şeydir. Daha fazla bilgi için, ana bilgisayar 
sisteminizdeki tcpdump Man sayfasına bakın. 

Tarayıcıda bir ağ izlemesi toplayın 

Bu yöntem yalnızca tarayıcı tabanlı uygulamalar için geçerlidir. 

Çoğu tarayıcı Geliştirici Araçları, tarayıcı ve sunucu arasında ağ etkinliğini yakalamanızı sağlayan bir "ağ" sekmesi 
vardır. Ancak, bu izlemeler VVebSocket ve sunucu tarafından gönderilen olay iletilerini içermez. Bu taşımaları 
kullanıyorsanız, Fiddler veya TcpDump (aşağıda açıklanmıştır) gibi bir araç kullanmak daha iyi bir yaklaşımdır. 

Microsoft Edge ve Internet Explorer 

(Yönergeler hem Edge hem de Internet Explorer için aynıdır) 

1. Geliştirici araçlarını açmak için F12 tuşuna basın 

2. Ağ sekmesine tıklayın 

3. Sayfayı (gerekirse) yenileyin ve sorunu yeniden oluşturun 

4. izlemeyi "HAR" dosyası olarak dışarı aktarmak için araç çubuğundaki Kaydet simgesine tıklayın: 




















Google Chrome 

1. Geliştirici araçlarını açmak için F12 tuşuna basın 

2. Ağ sekmesine tıklayın 

3. Sayfayı (gerekirse) yenileyin ve sorunu yeniden oluşturun 

4. istek listesinde herhangi bir yere sağ tıklayın ve "İçerikle HAR olarak Kaydet" i seçin: 

«Jame 



Mozilla Firefox 

1. Geliştirici araçlarını açmak için F12 tuşuna basın 

2. Ağ sekmesine tıklayın 

3. Sayfayı (gerekirse) yenileyin ve sorunu yeniden oluşturun 

4. istek listesinde herhangi bir yere sağ tıklayın ve "tümünü HAR olarak Kaydet" i seçin 
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GitHub sorunlarına tanılama dosyaları iliştirme 

Tanılama dosyalarını, .txt uzantısına sahip olacak şekilde yeniden adlandırarak ve sonra sorunu üzerine 
sürükleyip bırakarak GitHub sorunlarına iliştirebilirsiniz. 


NOTE 

Lütfen günlük dosyalarının veya ağ izlemelerinin içeriğini bir GitHub sorununa yapıştırmayın. Bu Günlükler ve izlemeler 
oldukça büyük olabilir ve GitHub genellikle bunları keser. 


S. 


lnvalidOperationException when invoking a Hub Method starting with "a" 

Write Previevv B / (C <> ‘Tb := 1= @ H 


* Versions of Server-Side NuGet Packages: 1,0.0-rct-final 

* Versions of Client-Side NuGet/NPM Packages: 1.0.0-rcl -final 

* Are you using the C# Client or the JavaScript client: JavaScript 

* The Server you are using (Kestrel/HttpSysServer/IIS/IIS Express/Azure Web App/etc.): Azure Web App 

* The Operating System on the Server (Windows/Linux/macOS): VVİndovvs 

* The Operating System on the Client (Windows/Linux/macOS): macOS 

* The Brovvser on the client, if using the JavaScript client (IE/Chrome/Edge/Firefox/etc.): Safari 

Any time I invoke a hub ı 'hat starts with the letter "a" I get an lnvalidOperationException ! 

S 

Here are my logs: 


+ c°py | 

Attach fileş by dragging & dropping, selecting them, or pasting from the clipboard. 


h 


CH Styling with Markdown is supported 


Submit new issue 


P C:\Users\anurse\Desktc X 


Home Share View 

v ^ > Andrevv Stanton-Nurse > Desktop > logs 

0 Name Date modified 


Type 


Size 



0 = networktrace.har.txt 

5/8/2018 8:52 PM 

Text Document 

1 KB 

1 

0 El clientlogs.txt 

5/8/2018 8:52 PM 

Text Document 

1 KB 

1 

0 ! serverlogs.txt 

5/8/2018 8:52 PM 

Text Document 

1 KB 


Ek kaynaklar 


• ASP.NET Core SignalR yapılandırması 

• ASP.NET Core SignalR JavaScript istemcisi 

























.NET ClientASP.NET Core SignalR 


.NET Core 'da gRPC 'ye giriş 
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John Luo ve James bAyKİNg 

GRPC , dilden bağımsız, yüksek performanslı bir uzak yordam ÇAĞRıSı (RPC) çerçevesidir. 

GRPC 'nin başlıca avantajları şunlardır: 

• Modern, yüksek performanslı, hafif RPC çerçevesi. 

• Sözleşme-ilk API geliştirmesi, varsayılan olarak protokol arabellekleri kullanarak, dilden bağımsız 
uygulamalar için izin verir. 

• Birçok dilde araç, kesin türü belirtilmiş sunucu ve istemciler oluşturmak için kullanılabilir. 

• istemci, sunucu ve iki yönlü akış çağrılarını destekler. 

• Protoarabelleğe ikili serileştirme ile azaltılmış ağ kullanımı. 

Bu avantajlar, gRPC 'yi ideal hale getirir: 

• Verimlilik açısından kritik olan hafif mikro hizmetler. 

• Geliştirme için birden fazla dilin gerekli olduğu çok yönlü sistemleri. 

• Akış isteklerini veya yanıtlarını işlemek için gereken noktadan noktaya gerçek zamanlı hizmetler. 

C#. Proto dosyaları için araç desteği 

gRPC, API geliştirmesi için bir sözleşmenin ilk yaklaşımını kullanır. Hizmetler ve mesajlar *. proto 
dosyalarında tanımlanmıştır: 

syntax = "proto3"; 
service Greeter { 

rpc SayHello (HelloRequest) returns (HelloReply); 

} 

message HelloRequest { 
string name = 1; 

} 

message HelloReply { 
string message = 1; 

} 

Hizmetler, istemciler ve iletiler için .net türleri bir projedeki *. proto dosyaları eklenerek otomatik olarak 
oluşturulur: 

• GRPC. Tools paketine bir paket başvurusu ekleyin. 

• *. Proto dosyalarını <Protobuf> öğe grubuna ekleyin. 

<ItemGroup> 

<Protobuf Include="Protos\greet.proto" /> 

</ItemGroup> 


GRPC araç desteği hakkında daha fazla bilgi için bkz C# içeren gRPC hizmetleri. 






ASP.NET Core gRPC Hizmetleri 

gRPC Hizmetleri, ASP.NET Core üzerinde barındırılabilir.Hizmetler, günlüğe kaydetme, bağımlılık ekleme 
(dı), kimlik doğrulama ve yetkilendirme gibi popüler ASP.NET Core özelliklerle tam tümleştirmeye sahiptir. 

GRPC hizmeti proje şablonu bir başlatıcı hizmeti sağlar: 

public class GreeterService : Greeter.GreeterBase 
{ 

private readonly ILogger<GreeterService> _logger; 

public GreeterService(ILogger<GreeterService> logger) 

{ 

_logger = logger; 

} 

public override Task<HelloReply> SayHello(HelloRequest request, 

ServerCallContext context) 

{ 

_logger. LogInformation("Saying hello to {Name}"., request.Name); 
return Task.FromResult(new HelloReply 
{ 

Message = "Hello " + request.Name 

}); 

} 

} 

GreeterService ,. proto dosyasındaki GreeterBase Greeter hizmetten oluşturulan türden devraUr. * Hizmet, 
Sfo/'fup.csiçindeki istemciler için erişilebilir hale getirilir: 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapGrpcService<GreeterService>(); 

}); 

ASP.NET Core 'de gRPC hizmetleri hakkında daha fazla bilgi edinmek için ASP.NET Core içeren gRPC 
Hizmetleribkz. 

Bir .NET istemcisiyle gRPC hizmetlerini çağırma 

GRPC istemcileri * proto dosyalarından oluşturulansomut istemci türleridir. Somut GRPC istemcisinde *. 
proto dosyasındaki GRPC hizmetine çeviren yöntemler vardır. 

var channel = GrpcChannel.ForAddress("https://localhost:5001"); 
var Client = new Greeter.GreeterClient(channel); 

var response = await Client.SayHello( 

new HelloRequest { Name = "World" }); 

Console.WriteLine(response.Message); 

GRPC istemcisi, bir gRPC hizmeti ile uzun süreli bağlantıyı temsil eden bir kanal kullanılarak oluşturulur. 
Kullanılarak GrpcChannel.ForAddress bir kanal oluşturulabilir. 

istemci oluşturma ve farklı hizmet yöntemlerini çağırma hakkında daha fazla bilgi için bkz .N ET istemcisiyle 
gRPC hizmetlerini çağırma. 


gRPC Azure App Service desteklenmiyor 






VVARNING 

ASP.NET Core gRPC Azure App SERVİCE veya IIS 'de Şu anda desteklenmiyor. Http. sys ' nin HTTP/2 uygulamasına 
uygulanması, gRPC 'nin bağımlı olduğu HTTP yanıtı sondaki üst bilgileri desteklemez. Daha fazla bilgi için bu GitHub 
sorunu. 


Ek kaynaklar 

• C# içeren gRPC hizmetleri 

• ASP.NET Core içeren gRPC Hizmetleri 

• .NET istemcisiyle gRPC hizmetlerini çağırma 

• .NET Core 'da gRPC istemci fabrikası tümleştirmesi 

• ASP.NET Core .NET Core gRPC istemcisi ve sunucusu oluşturma 




Öğretici: ASPNET Core bir gRPC istemcisi ve 
sunucusu oluşturma 
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John Luo tarafından 

Bu öğreticide, bir .NET Core GRPC istemcisinin ve bir ASP.NET Core GRPC sunucusunun nasıl oluşturulacağı 
gösterilmektedir. 

Sonda, gRPC Greeter hizmeti ile iletişim kuran bir gRPC istemcisine sahip olacaksınız. 

Örnek kodu görüntüleyin veya indirin (nasıl indirilir). 

Bu öğreticide şunları yaptınız: 

• GRPC sunucusu oluşturun. 

• GRPC istemcisi oluşturun. 

• GRPC istemci hizmetini gRPC Greeter hizmeti ile test edin. 

Prerequisites 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• ASP.net ve Web geliştirme iş yüküyle Visual Studio 2019 

• .NET Core 3,0 SDK veya üzeri 

GRPC hizmeti oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Visual Studio 'Yu başlatın ve Yeni proje oluştur 1 u seçin. Alternatif olarak, Visual Studio Dosya 
menüsünden Yeni > projesi' ni seçin. 

• Yeni proje oluştur İletişim kutusunda GRPC hizmeti ' ni seçin ve İleri' yi seçin: 


Create a new project 



Recent project templates 


Ali Languages ▼ Ali Platforms 


Ali Project Types 


««« gRPC Service 
■ğl Blank Solution 


gRPC gRPC Service 

A project template for creating a gRPC ASP.NET Core service using .NET Core. 
C# Unux macOS Windows Cloud Service Web 


• Projeyi Grpcgreeterolarak adlandırın. Kodu kopyalayıp yapıştırdığınızda ad alanlarının eşleşmesi için, 
proje Grpcgreeter adında bir ad vermek önemlidir. 


• Seçin oluşturma. 






• Yeni birgRPC hizmeti oluştur iletişim kutusunda: 


o GRPC hizmeti şablonu seçilidir, 
o Seçin oluşturma. 

Hizmeti çalıştırma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 


Hata ayıklayıcı olmadan çalıştırmak için CTRL + F5 tuşlarına basın. 
Visual Studio aşağıdaki iletişim kutusunu görüntüler: 


Microsoft Visual Studio 


X 


O Thıs project ıs confıgured to use SSL To avoıd SSL vvarnıngs ın the browser you 
can choose to trust the self-sıgned certificate that IIS Express has generated. 

Would you lıke to trust the IIS Express SSL certificate? 

Leam More 

H Don't ask me again 


Yes 


No 


IIS Express SSL sertifikasına güveniyorsanız Evet 1 i seçin. 
Aşağıdaki iletişim kutusu görüntülenir: 


Security VVarning 


You are about to install a certificate from a certification 
| authority (CA) daiming to represent 

localhost 

Windows cannot validate that the certificate is actually from 
"localhost". You should confirm its origin by contacting 
"localhost". The following number will assist you in this 
process: 

Thumbprint (shal): 35AAFB1F 70EC5F89 C7180FBD 61AFE491 
94580874 

Warning: 

If you install this root certificate, Windows will automatically 
trust any certificate issued by this CA. Installing a certificate 
with an unconfirmed thumbprint is a security risk. If you click 
"Yes" you acknowledge this risk. 

Do you want to install this certificate? 



Geliştirme sertifikasına güvenmeyi kabul ediyorsanız Evet ' i seçin. 

Visual Studio IIS Express başlar ve uygulamayı çalıştırır. Adres çubuğunda localhost:port# ve 
exampie.com gibi bir şey görüntülenir. Bunun nedeni, localhost yerel bilgisayar için Standart ana 
bilgisayar adıdır. Localhost yalnızca yerel bilgisayardan Web isteklerine hizmet verir. Visual Studio bir Web 
projesi oluşturduğunda, Web sunucusu için rastgele bir bağlantı noktası kullanılır. 


Günlükler, https://localhost:500i üzerinde dinleme hizmetini gösterir. 


























info: Microsoft.Hosting.Lifetime[@] 

Now listening on: https://localhost:5001 
info: Microsoft.Hosting.Lifetime[0] 

Application started. Press Ctrl+C to shut down. 
info: Microsoft.Hosting.Lifetime[0] 

Hosting environment: Development 


NOTE 

GRPC şablonu, Aktarım Katmanı Güvenliği (TLS)kullanmak üzere yapılandırılmıştır. gRPC istemcilerinin, sunucuyu çağırmak 
için HTTPS kullanması gerekir. 

macOS, TLS ile ASP.NET Core gRPC 'yi desteklemez. MacOS 'ta gRPC hizmetlerini başarıyla çalıştırmak için ek yapılandırma 
gerekir. Daha fazla bilgi için bkz. macOS üzerinde gRPC uygulaması ASP.NET Core başlatılamıyor. 


Proje dosyalarını inceleyin 

Grpcgreeter proje dosyaları: 

• Greet. proto - prototips/Greet. proto dosyası Greeter GRPC'Yi tanımlar ve GRPC sunucu varlıklarını 
oluşturmak için kullanılır. Daha fazla bilgi için bkz. gRPC 'ye giriş. 

• Hizmetler klasörü: Greeter hizmetinin uygulamasını içerir. 

• appSettings.jsorı Kestrel tarafından kullanılan protokol gibi yapılandırma verilerini içerir. Daha fazla bilgi için 
bkz.ASP.NET Core yapılandırma. 

• Program.es-, GRPC hizmetinin giriş noktasını içerir.Daha fazla bilgi için bkz. .NET genel ana bilgisayar. 

• Startup.es - uygulama davranışını yapılandıran kodu içerir. Daha fazla bilgi için bkz. uygulama başlatma. 

Bir .NET konsol uygulamasında gRPC istemcisini oluşturma 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Visual Studio 'nun ikinci bir örneğini açın ve Yeni proje oluştur' u seçin. 

• Yeni proje oluştur İletişim kutusunda konsol uygulaması (.NET Core) öğesini seçin ve İleri' yi seçin. 

• Ad metin kutusuna Grpcgreeterclient girin ve Oluştur 1 u seçin. 

Gerekli paketleri Ekle 

GRPC istemci projesi aşağıdaki paketleri gerektirir: 

• .NET Core istemcisini içeren GRPC .net. Client. 

• için C#prototipsiz İleti API 'Leri içeren Google. protoarabellek. 

• Prototipleme dosyaları için araç desteğini C# İçeren GRPC. Tools. Araç, çalışma zamanında gerekli değildir, bu 
nedenle bağımlılık PrivateAssets="Aii" olarak işaretlenir. 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Paket Yöneticisi Konsolu (PMC) veya NuGet Paketlerini Yönet' i kullanarak paketleri yükler. 

Paket yüklemek için PMC seçeneği 

• Visual Studio da araçlar > NuGet Paket Yöneticisi > Paket Yöneticisi konsolu 1 nu seçin. 

• Paket Yöneticisi konsol penceresinde, Grpcgreeterclient. esproj dosyalarını içeren klasöre Dizin 







değiştirmek için cd GrpcGreeterciient çalıştırın. 

• Aşağıdaki komutları çalıştırın: 

Install-Package Grpc.Net.Client 
Install-Package Google.Protobuf 
Install-Package Grpc.Tools 

Paket yüklemek için NuGet Paketlerini Yönet seçeneği 

• NuGet paketlerini yönetmek > Çözüm Gezgini 1 de projeye sağ tıklayın 

• Gözat sekmesini seçin. 

• Arama kutusuna GRPC .net. Client girin. 

• Araştır sekmesinden GRPC .net. Client paketini seçin ve ardından Install 1 ı seçin. 

• Google.Protobuf ve Grpc.Tools için yineleyin. 

Greet. proto Ekle 

• GRPC istemci projesinde bir Prototips klasörü oluşturun. 

• Protos\b ilgise m. proto dosyasını GRPC Greeter hizmetinden GRPC istemci projesine kopyalayın. 

• Grpcgreeterclient. csproj proje dosyasını düzenleyin: 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

Projeye sağ tıklayın ve Proje dosyasını Düzenle 1 yi seçin. 

• Greet proto dosyasına başvuran <Protobuf> öğesi olan bir öğe grubu ekleyin: 

<ItemGroup> 

<Protobuf Include="Protos\greet.proto" GrpcServices="Client" /> 

</ItemGroup> 

Greeter istemcisini oluşturma 

GrpcGreeter ad alanındaki türleri oluşturmak için projeyi derleyin. GrpcGreeter türleri yapı işlemi tarafından 
otomatik olarak oluşturulur. 

GRPC Clientpragram.es dosyasını aşağıdaki kodla güncelleştirin: 









using System; 

using System.Net.Http; 

using System.Threading.Tasks; 

using GrpcGreeter; 

using Grpc.Net.Client; 


namespace GrpcGreeterClient 

{ 

class Program 

{ 

static async Task Main(string[] args) 

{ 

// The port number(5001) must match the port of the gRPC server. 
var channel = GrpcChannel.ForAddress("https://localhost:5001"); 
var Client = new Greeter.GreeterClient(channel); 
var reply = await Client.SayHelloAsync( 

new HelloRequest { Name = "GreeterClient" }); 
Console.Writel_ine("Greeting: " + reply.Message); 

Console.Writel_ine("Press any key to exit..."); 

Console.ReadKey(); 

} 

} 


Program.es , GRPC istemcisinin giriş noktasını ve mantığını içerir. 

Greeter istemcisi şu şekilde oluşturulur: 

• GRPC hizmetine bağlantı oluşturma bilgilerini içeren bir GrpcChannel örnekleniyor. 

• Greeter istemcisini oluşturmak için GrpcChannel kullanma: 

static async Task Main(string[] args) 

{ 

// The port number(5001) must match the port of the gRPC server. 
var channel = GrpcChannel.ForAddress("https://localhost:5001"); 
var Client = new Greeter.GreeterClient(channel); 
var reply = await Client.SayHelloAsync( 

new HelloRequest { Name = "GreeterClient" }); 

Console.WriteLine("Greeting: " + reply.Message); 

Console.WriteLine("Press any key to exit..."); 

Console.ReadKey(); 


Greeter istemcisi zaman uyumsuz sayHello yöntemini çağırır. sayHello çağrısının sonucu görüntülenir: 

static async Task Main(string[] args) 

{ 

// The port number(5001) must match the port of the gRPC server. 
var channel = GrpcChannel.ForAddress("https://localhost:5001"); 
var Client = new Greeter.GreeterClient(channel); 
var reply = await Client.SayHelloAsync( 

new HelloRequest { Name = "GreeterClient" }); 

Console.WriteLine("Greeting: " + reply.Message); 

Console.WriteLine("Press any key to exit..."); 

Console.ReadKey(); 


GRPC istemcisini gRPC Greeter hizmeti ile test etme 


• Visual Studio 









• Visual Studio Code 

• Mac için Visuai Studio 


Greeter hizmetinde, hata ayıklayıcı olmadan sunucuyu başlatmak için 

Ctrl+F5 

' a basın 

GrpcGreeterClient 

projede, hata ayıklayıcı olmadan istemcisini başlatmak için 

Ctrl+F5 


istemci, adı Greetercliento\ar\ bir iletiyle hizmete bir tebrik gönderir. Hizmet, "Hello GreeterCIİent" iletisini yanıt 
olarak gönderir. Komut isteminde "Hello GreeterCIİent" yanıtı görüntülenir: 

Greeting: Hello GreeterCIİent 
Press any key to exit... 


GRPC hizmeti, komut istemine yazılan günlüklerde başarılı çağrının ayrıntılarını kaydeder: 

info: Microsoft.Hosting.Lifetime[0] 

Now listening on: https://localhost:5001 
info: Microsoft.Hosting.Lifetime[@] 

Application started. Press Ctrl+C to shut down. 
info: Microsoft.Hosting.Lifetime[0] 

Hosting environment: Development 
info: Microsoft.Hosting.Lifetime[@] 

Content root path: C:\GH\aspnet\docs\4\Docs\aspnetcore\tutorials\grpc\grpc-start\sample\GrpcGreeter 
info: Microsoft.AspNetCore.Hosting.Diagnostics[1] 

Request starting HTTP/2 POST https://localhost:5001/Greet.Greeter/SayHello application/grpc 
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[0] 

Executing endpoint 'gRPC - /Greet.Greeter/SayHello' 
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[l] 

Executed endpoint 'gRPC - /Greet.Greeter/SayHello' 
info: Microsoft.AspNetCore.Hosting.Diagnostics[2] 

Request finished in 78.32260000000001ms 200 application/grpc 


NOTE 

Bu makaledeki kod, gRPC hizmetini güvenli hale getirmek için ASP.NET Core HTTPS geliştirme sertifikası gerektirir, istemci 
The remote certificate is invalid according to the validation procedure. ileti ile başarısız olursa, geliştirme 
sertifikası güvenilir değildir. Bu sorunu gidermeye yönelik yönergeler için bkz. VVİndovvs ve macOS 'ta ASP.NET Core https 
geliştirme sertifikasına güvenin. 


gRPC Azure App Service desteklenmiyor 


VVARNING 

ASP.NET Core gRPC Azure App SERVİCE veya IIS 'de Şu anda desteklenmiyor. Http. sys ' nin HTTP/2 uygulamasına 
uygulanması, gRPC 'nin bağımlı olduğu HTTP yanıtı sondaki üst bilgileri desteklemez. Daha fazla bilgi için bu GitHub sorunu. 


Sonraki adımlar 

• .NET Core'da gRPC'ye giriş 

• C# içeren gRPC hizmetleri 

• GRPC hizmetlerini C Core 'dan ASP.NET Core geçirme 










C# ile gRPC Hizmetleri 
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Bu belgede, 1 de C# GRPC uygulamaları yazmak için gereken kavramlar özetlenmektedir. Burada ele alınan 
konular hem C Coretabanlı hem deASP.NET Coretabanlı GRPC uygulamaları için geçerlidir. 

Proto dosyası 

gRPC, API geliştirmesi için bir sözleşmenin ilk yaklaşımını kullanır. Protokol arabellekleri (protobellek) varsayılan 
olarak arabirim tasarım dili (IDL) olarak kullanılır. *. proto dosyası şunları içerir: 

• GRPC hizmetinin tanımı. 

• istemciler ve sunucular arasında gönderilen iletiler. 

Prototipsiz dosyaların sözdizimi hakkında daha fazla bilgi için, resmi belgelere (protoarabellek)bakın. 

Örneğin, gRPC hizmetini kullanmaya başlamabölümünde kullanılan Greet. proto dosyasını düşünün: 


• 

Greeter 

bir hizmeti tanımlar. 

• 

Greeter 

hizmeti SayHello 

çağrısını tanımlar. 

• 

SayHello 

bir HelloRequest 

iletisi gönderir ve bir HelloReply iletisi alır: 


syntax = 

"proto3"; 



option csharp_namespace = "GrpcGreeter"; 
package greet; 

// The greeting service definition. 
service Greeter { 

// Sends a greeting 

rpc SayHello (HelloRequest) returns (HelloReply); 

} 

// The request message containing the user's name, 
message HelloRequest { 
string name = 1; 

} 

// The response message containing the greetings. 
message HelloReply { 
string message = 1; 

} 


C# uygulamasına, proto dosyası ekleme 

*. proto dosyası bir projeye <Protobuf> öğesi grubuna eklenerek eklenir: 

<ItemGroup> 

<Protobuf Include="Protos\greet.proto" GrpcServices="Server" /> 
</ItemGroup> 


C#. Proto dosyaları için araç desteği 











Araç Paketi GRPC. Tools , C# *. proto dosyalarından varlıkları oluşturmak için gereklidir. Oluşturulan varlıklar 
(dosyalar): 

• , Projenin oluşturulduğu her seferinde gerekli olarak oluşturulur. 

• Projeye eklenmez veya kaynak denetimine iade edilmedi. 

• Obj dizininde bulunan bir yapı yapıtı. 

Bu paket hem sunucu hem de istemci projeleri için gereklidir. Grpc.AspNetcore metapackage Grpc.Tools bir 
başvuru içerir. Sunucu projeleri, Visual Studio'da Paket Yöneticisi'Ni kullanarak veya proje dosyasına bir 
<PackageReference> ekleyerek Grpc.AspNetcore ekleyebilir: 

<PackageReference Include="Grpc.AspNetCore" Version="2.23.2" /> 

istemci projeleri, gRPC istemcisini kullanmak için gereken diğer paketlerle birlikte Grpc.Tools doğrudan 
başvurmalıdır. Araç, çalışma zamanında gerekli değildir, bu nedenle bağımlılık PrivateAssets="Aii" olarak 
işaretlenir: 

<PackageReference Include="Google.Protobuf" Version="3.9.2" /> 

<PackageReference Include="Grpc.Net.Client" Version="2.23.2" /> 

<PackageReference Include="Grpc.Tools" Version="2.23.0" PrivateAssets="All" /> 


Oluşturulan C# varlıklar 

Araç paketi, eklenen C# *. proto dosyalarında tanımlanan iletileri temsil eden türleri oluşturur. 

Sunucu tarafı varlıklar için, soyut bir hizmet temel türü oluşturulur.Temel tür,, proto dosyasında bulunan tüm 
GRPC çağrılarının tanımlarını içerir. Bu temel türden türetilen somut bir hizmet uygulamasını oluşturun ve gRPC 
çağrılarının mantığını uygular, greet.proto için, daha önce açıklanan örnek, bir sanal sayHello yöntemi içeren 
soyut bir GreeterBase türü oluşturulur. Somut bir uygulama GreeterService yöntemi geçersiz kılar ve gRPC 
çağrısını idare eden mantığı uygular. 

public class GreeterService : Greeter.GreeterBase 
{ 

public override Task<HelloReply> SayHello( 

HelloRequest request, ServerCallContext context) 

{ 

return Task.FromResult(new HelloReply 
{ 

Message = "Hello " + request.Name 

}); 

} 

} 

istemci tarafı varlıklar için somut bir istemci türü oluşturulur.. Proto dosyasındaki GRPC çağrıları, çağrılabilecek 
somut türdeki yöntemlere çevrilir. Daha önce açıklanan örnek greet.proto için somut bir Greeterciient türü 
oluşturulur. Sunucuya bir gRPC çağrısı başlatmak için Greeterciient.sayHelloAsync çağırın. 














static async Task Main(string[] args) 

{ 

// The port number(5001) must match the port of the gRPC server. 
var channel = GrpcChannel.ForAddress("https://localhost:5001"); 
var Client = new Greeter.GreeterClient(channel); 
var reply = await Client.SayHelloAsync( 

new HelloRequest { Name = "GreeterClient" }); 

Console.WriteLine("Greeting: " + reply.Message); 

Console.WriteLine("Press any key to exit..."); 

Console.ReadKey(); 

} 

Varsayılan olarak, sunucu ve istemci varlıkları <Protobuf> öğesi grubuna eklenen her bir *. proto dosyası için 
oluşturulur. Sunucu projesinde yalnızca sunucu varlıklarının oluşturulmasını sağlamak için, GrpcServices 
özniteliği Server olarak ayarlanır. 

<ItemGroup> 

<Protobuf Include="Protos\greet.proto" GrpcServices="Server" /> 

</ItemGroup> 

Benzer şekilde, özniteliği istemci projelerinde Client olarak ayarlanır. 

gRPC Azure App Service desteklenmiyor 


VVARNING 

ASP.NET Core gRPC Azure App SERVİCE veya IIS 'de Şu anda desteklenmiyor. Http. sys ' nin HTTP/2 uygulamasına 
uygulanması, gRPC 'nin bağımlı olduğu HTTP yanıtı sondaki üst bilgileri desteklemez. Daha fazla bilgi için bu GitHub 
sorunu. 


Ek kaynaklar 

• .NET Core'da gRPC'ye giriş 

• ASP.NET Core .NET Core gRPC istemcisi ve sunucusu oluşturma 

• ASP.NET Core içeren gRPC Hizmetleri 

• .NET istemcisiyle gRPC hizmetlerini çağırma 










ASRNET Core içeren gRPC Hizmetleri 
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Bu belgede, ASP.NET Core kullanarak gRPC Hizmetleri ile çalışmaya başlama gösterilmektedir. 

Önkoşullar 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• ASP.net ve Web geliştirme iş yüküyle Visual Studio 2019 

• .NET Core 3,0 SDK veya üzeri 

ASP.NET Core'da gRPC hizmeti ile çalışmaya başlama 

Örnek kodu görüntüle veya indir (indirme). 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

GRPC projesi oluşturma hakkında ayrıntılı yönergeler için bkz. GRPC hizmetlerini kullanmaya başlama . 

ASP.NET Core uygulamasına gRPC Hizmetleri ekleme 

gRPC, GRPC. AspNetCore paketini gerektirir. 

GRPC 'y< yapılandırma 

Sfortup.csiçinde: 

• GRPC, AddGrpc yöntemiyle etkinleştirilir. 


• Her GRPC hizmeti, yönlendirme ardışık düzenine MapGrpcService yöntemi aracılığıyla eklenir. 





public class Startup 
{ 

// This method gets called by the runtime. Use this method to add Services to the Container. 

// For more information on how to configure your application, visit https://go.microsoft.com/fwlink/? 
LinkID=398940 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddGrpc(); 

} 

// This method gets called by the runtime. Use this method to configure the HTTP request pipeline. 
public void Configure(IApplicationBuilder app, IWebHostEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

app.UseRouting(); 

app.UseEndpoints(endpoints => 

{ 

// Communication with gRPC endpoints must be made through a gRPC Client. 

// To learn how to create a Client, visit: https://go.microsoft.com/fwlink/?linkid=2086909 
endpoints.MapGrpcService<GreeterService>(); 

}); 

} 

} 

AS P.N ET Core middlevvares ve Özellikler yönlendirme işlem hattını paylaşır, bu nedenle uygulama ek istek 
işleyicileri sunacak şekilde yapılandırılabilir. MVC denetleyicileri gibi ek istek işleyicileri, yapılandırılmış gRPC 
hizmetleriyle paralel olarak çalışır. 

Kestrel yapılandırma 

Kestrel gRPC uç noktaları: 

• HTTP/2 gerektir. 

• Aktarım Katmanı Güvenliği (TLS)ile güvenli hale getirilmesi gerekir. 

HTTP/2 

gRPC, HTTP/2 gerektirir.ASP.NET Core için gRPC, HttpRequest. Protocol olduğunu http /2 doğrular. 

Kestrel çoğu modern işletim sisteminde http/2 destekler. Kestrel uç noktaları, varsayılan olarak HTTP/1.1 ve 
HTTP/2 bağlantılarını destekleyecek şekilde yapılandırılmıştır. 

TLS 

GRPC için kullanılan Kestrel uç noktaları TLS ile güvenli hale gelmelidir.Geliştirme aşamasında, ASP.NET Core 
geliştirme sertifikası mevcut https://iocaihost:50@ı olduğunda, TLS ile güvenli bir uç nokta otomatik olarak 
oluşturulur. Yapılandırma gerekmiyor, https Ön ek, Kestrel uç noktasının TLS kullandığını doğrular. 

Üretimde, TLS açıkça yapılandırılmalıdır.Aşağıdaki appSettings. JSON ÖRNEĞİNDE, TLS ile güvenliği 
SAĞLANMıŞ bir http/2 uç noktası verilmiştir: 





"Kestrel": { 

"Endpoints": { 

"HttpsInlineCentFile": { 

"Url": "https://localhost:5001", 
"Protocols": "Http2", 

"Certificate": { 

"Path": "<path to .pfx file>", 
"Password": "<certificate password>" 

} 

} 

} 

} 

} 


Alternatif olarak, Kestrel uç noktaları program .csiçinde yapılandırılabilir: 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt .CreateDefaııltBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.ConfigureKestrel(optlons => 

{ 

options.Listen(IPAddress.Any, 5001, listenOptlons => 

{ 

listenOptions.Protocols = HttpProtocols.Http2; 
listenoptions.UseHttps("<path to .pfx file>", 

"<certificate password>"); 

}); 

}); 

webBuilder.UseStartup<Startup>(); 

})J 

Protokol anlaşması 

TLS, iletişimin güvenliğinin daha fazlası için kullanılır.TLS uygulama katmanı protokol anlaşması (ALPN) el 
sıkışması, bir uç nokta birden çok protokolü desteklediğinde istemci ile sunucu arasındaki bağlantı protokolünü 
anlaşmak için kullanılır. Bu anlaşma, bağlantının HTTP/1.1 veya HTTP/2 kullanıp kullanmadığını belirler. 

Bir HTTP/2 uç noktası TLS olmadan yapılandırılırsa, uç noktanın Listenoptions. Protocols olarak 
HttpProtocols.Http2 ayarlanmalıdır. Bir anlaşma olmadığından, birden fazla protokolle ( 

HttpProtocols.HttpiAndHttp2 Örneğin,) bir uç nokta TLS olmadan kullanılamaz. Güvenli olmayan uç nokta 
varsayılan HTTP/1.1 ve gRPC çağrıları için tüm bağlantılar başarısız olur. 

HTTP/2 ve TLS 'yi Kestrel ile etkinleştirme hakkında daha fazla bilgi için bkz. Kestrel Endpoint Configuration. 


NOTE 

macOS, TLS ile ASP.NET Core gRPC 'yi desteklemez. MacOS 'ta gRPC hizmetlerini başarıyla çalıştırmak için ek yapılandırma 
gerekir. Daha fazla bilgi için bkz. macOS üzerinde gRPC uygulaması ASP.NET Core başlatılamıyor. 


ASP.NET Core API 1 Leri ile tümleştirme 

gRPC Hizmetleri, bağımlılık ekleme (dı) ve günlüğe kaydetmegibi ASP.NET Core özelliklerine tam erişime 
sahiptir. Örneğin, hizmet uygulama, Oluşturucu aracılığıyla bir günlükçü hizmetini dı kapsayıcısından 
çözümleyebilir: 





public class GreeterService : Greeter.GreeterBase 

{ 

public GreeterService(ILogger<GreeterService> logger) 

{ 

} 

} 

Varsayılan olarak, gRPC hizmeti uygulama diğer dı hizmetlerini herhangi bir yaşam süresi (tek, kapsamlı veya 
geçici) ile çözümleyebilir. 

GRPC yöntemlerinde HttpContext 'i çözümle 

GRPC API 'SI, yöntem, ana bilgisayar, üst bilgi ve tanıtımları gibi bazı HTTP/2 ileti verilerine erişim sağlar.Erişim, 
her GRPC yöntemine geçirilen bağımsızdeğişkendir: serverCaiıcontext 

public class GreeterService : Greeter.GreeterBase 

{ 

public override Task<HelloReply> SayHello( 

HelloRequest request, ServerCallContext context) 

{ 

return Task.FromResult(new HelloReply 

{ 

Message = "Hello " + request.Name 

}); 

} 

} 

serverCaiıcontext tüm ASP.NET API 'lerinde tam erişim HttpContext sağlamaz. Genişletme yöntemi, ASP.NET 
API 'lerinde temel alınan HttpContext http/2 iletisini temsil eden öğesine tam erişim sağlar: GetHttpContext 

public class GreeterService : Greeter.GreeterBase 

{ 

public override Task<HelloReply> SayHello( 

HelloRequest request, ServerCallContext context) 

{ 

var httpContext = context.GetHttpContext(); 

var clientCertificate = httpContext.Connection.ClientCertificate; 

return Task.FromResult(new HelloReply 

{ 

Message = "Hello " + request.Name + " from " + clientCertificate.Issuer 

}); 

} 

} 


gRPC Azure App Service desteklenmiyor 


VVARNING 

ASP.NET Core gRPC Azure App SERVİCE veya MS 'de Şu anda desteklenmiyor. Http. sys ' nin HTTP/2 uygulamasına 
uygulanması, gRPC 'nin bağımlı olduğu HTTP yanıtı sondaki üst bilgileri desteklemez. Daha fazla bilgi için bu GitHub sorunu. 


Ek kaynaklar 

• ASP.NET Core .NET Core gRPC istemcisi ve sunucusu oluşturma 

• .NET Core'da gRPC'ye giriş 

• C# içeren gRPC hizmetleri 










• AS P.N ET Core Web sunucusu uygulamasını Kestrel 


.NET istemcisiyle gRPC hizmetlerini çağırma 
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GRPC .net. Client NuGet paketinde bir .net GRPC istemci kitaplığı mevcuttur.Bu belgede nasıl yapılacağı 
açıklanmaktadır: 

• GRPC istemcisini, gRPC hizmetlerini çağırmak üzere yapılandırın. 

• GRPC 'yi birli, sunucu akışı, istemci akışı ve iki yönlü akış yöntemlerine göre çağırır. 

GRPC istemcisini yapılandırma 

GRPC istemcileri *. proto dosyalarından oluşturulansomut istemci türleridir. Somut GRPC istemcisinde *. proto 
dosyasındaki GRPC hizmetine çeviren yöntemler vardır. 

Bir kanaldan gRPC istemcisi oluşturulur.' I kullanarak GrpcChannel.ForAddress bir kanal oluşturun ve ardından bir 
GRPC istemcisi oluşturmak için kanalı kullanın: 

var channel = GrpcChannel.ForAddress("https://localhost:5001"); 
var Client = new Greet.GreeterClient(channel); 

Kanal, gRPC hizmetine uzun süreli bir bağlantıyı temsil eder. Bir kanal oluşturulduğunda, hizmet çağırma ile ilgili 
seçeneklerle yapılandırılır. Örneğin, Httpciient çağrı yapmak için kullanılan, en fazla ileti ve alma iletisi boyutu, 
ve ' de üzerinde GrpcChannelOptions GrpcChannel.ForAddress günlüğe kaydetme belirlenebilir. Seçeneklerin 
tamamı listesi için bkz. istemci yapılandırma seçenekleri. 

Kanal oluşturma maliyetli bir işlem olabilir ve gRPC çağrıları için bir kanalı yeniden kullanmak performans 
avantajları sunar. Farklı türlerde istemciler de dahil olmak üzere bir kanaldan birden fazla somut gRPC istemcisi 
oluşturulabilir. Somut gRPC istemci türleri basit nesnelerdir ve gerektiğinde oluşturulabilir. 

var channel = GrpcChannel.ForAddress("https://localhost:5001"); 

var greeterClient = new Greet.GreeterClient(channel); 
var counterClient = new Count.CounterClient(channel); 

// Use clients to cali gRPC Services 

GrpcChannel.ForAddress gRPC istemcisi oluşturmak için tek seçenek değildir.GRPC hizmetlerini bir ASP.NET 
Core uygulamasından arıyorsanız, GRPC istemci fabrikası tümleştirmesinigöz önünde bulundurun, ile GRPC 
tümleştirmesi HttpciientFactory , GRPC istemcileri oluşturmaya yönelik merkezi bir alternatif sunar. 


NOTE 

.Net istemcisiyle güvenli olmayan gRPC hizmetlerini çağırmakiçin ek yapılandırma gerekir. 


GRPC çağrıları yapma 

Bir gRPC çağrısı, istemcideki bir yöntem çağırarak başlatılır.GRPC istemcisi, ileti serileştirme işlemini işleyecek ve 
doğru hizmete gRPC çağrısını ele alacak. 

gRPC farklı türde yöntemlere sahiptir. Bir gRPC çağrısını yapmak için istemcisini nasıl kullandığınız, çağırdığınız 












yöntemin türüne bağlıdır. GRPC Yöntem türleri şunlardır: 


• Li 

• Sunucu akışı 

• istemci akışı 

• iki yönlü akış 

Birli çağrı 

Birli çağrı, istemci isteği iletisi gönderen ile başlar. Hizmet bittiğinde bir yanıt iletisi döndürülür. 

var Client = new Greet.GreeterClient(channel); 

var response = await Client.SayHelloAsync(new HelloRequest { Name = "World" }); 

Console.Writel_ine("Greeting: " + response.Message); 

// Greeting: Hello World 


. Proto dosyasındaki her birli hizmet yöntemi *, yöntemi çağırmak için somut GRPC istemci türünde iki .NET 
yöntemi oluşmasına neden olur: zaman uyumsuz bir yöntem ve engelleyici bir yöntem. Örneğin, Greeterciient 
iki çağırma sayHello yöntemi vardır: 


• 

GreeterClient.SayHelloAsync 

-hizmeti 

Greeter.SayHello 

zaman uyumsuz olarak çağırır. Beklenmiş olabilir. 

• 

GreeterClient.SayHello 

-tamamlanana 

Greeter.SayHello 

kadar hizmeti ve blokları çağırır. Zaman uyumsuz 


kodda kullanmayın. 


Sunucu akışı çağrısı 

Sunucu akış çağrısı, istemci isteği iletisi gönderen ile başlar. Responsestream.MoveNext() hizmetten akan iletileri 
okur.' i Responsestream.MoveNext( ) döndüğünde faise sunucu akış çağrısı tamamlanmıştır. 

var Client = new Greet.GreeterClient(channel); 

using (var cali = Client.SayHellos(new HelloRequest { Name = "World" })) 

{ 

while (await call.ResponseStream.MoveNext()) 

{ 

Console.Writel_ine("Greeting: " + cali.ResponseStream.Current.Message); 

// "Greeting: Hello World" is written multiple times 

} 

} 

C# 8 veya sonraki bir sürümünü kullanıyorsanız, await foreach söz konusu sözdizimi iletileri okumak için 
kullanılabilir. iAsyncstreamReader<T>.ReadAHAsync() Uzantı yöntemi, yanıt akışından gelen tüm iletileri okur: 

var Client = new Greet.GreeterClient(channel); 

using (var cali = Client.SayHellos(new HelloRequest { Name = "World" })) 

{ 

await foreach (var response in call.ResponseStream.ReadAHAsync()) 

{ 

Console.Writel_ine("Greeting: " + response.Message); 

// "Greeting: Hello World" is written multiple times 

} 

} 

İstemci akışı çağrısı 

istemci akış çağrLSL, istemci ileti göndermeden başlatılır.İstemci, ile Requeststream.writeAsync ileti gönderip 
göndermemeyi seçebilir, istemcinin iletiyi göndermesi tamamlandığında, hizmete bildirimde 
Requeststream.compieteAsync bulunan iletiler çağr 1 1 m a 1 1 d ı r. Hizmet bir yanıt iletisi döndürdüğünde çağrı 
tamamlanır. 














var Client = new Counter.CounterClient(channel); 
using (var cali = Client.AccumulateCount()) 

{ 

for (var i = 0; i < 3; i++) 

{ 

await call.RequestStream.WriteAsync(new CounterRequest { Count = 1 }); 

} 

await cali.RequestStream.CompleteAsync(); 
var response = await cali; 

Console.WriteLine($"Count: {response.Count}"); 

// Count: 3 

} 

İki yönlü akış çağrısı 

Çift yönlü bir akış çağrısı, istemci bir ileti göndermeden başlatılır, istemci, ile Requeststream.writeAsync ileti 
göndermek için seçim yapabilir. Hizmetten akışa alınan iletilere veya ResponseStream.MoveNext() 

ResponseStream.ReadAllAsync() ile erişilebilir, iki yönlü akış çağrısı, ResponseStream daha fazla ileti olmadığında 
tamamlanır. 


using (var cali = Client .Echo()) 

{ 

Console.WriteLine("Starting background task to receive messages"); 
var readTask = Task.Run(async () => 

{ 

await foreach (var response in cali.ResponseStream.ReadAllAsync()) 

{ 

Console.WriteLine(response.Message); 

// Echo messages sent to the service 

} 

}); 

Console.WriteLine("Starting to send messages"); 

Console.WriteLine("Type a message to echo then press enter."); 
while (true) 

{ 

var result = Console.ReadLine(); 
if (string.IsNullOrEmpty(result)) 

{ 

break; 

} 

await call.RequestStream.WriteAsync(new EchoMessage { Message = result }); 

} 

Console.WriteLine("Disconnecting"); 
await cali.RequestStream.CompleteAsync(); 
await readTask; 


Çift yönlü bir akış araması sırasında, istemci ve hizmet herhangi bir zamanda iletileri birbirlerine gönderebilir.Çift 
yönlü bir çağrı ile etkileşimde bulunmak için en iyi istemci mantığı, hizmet mantığına bağlı olarak farklılık gösterir. 

Ek kaynaklar 

• .NET Core 'da gRPC istemci fabrikası tümleştirmesi 

• C# içeren gRPC hizmetleri 
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HttpClientFactory ile gRPC tümleştirmesi, gRPC istemcilerinin oluşturulması için merkezi bir yol sunar. Tek 
başına gRPC istemci örneklerini yapılandırmayaalternatif olarak kullanılabilir. Fabrika tümleştirmesi, GRPC .net. 
ClientFactory NuGet paketinde bulunabilir. 

Fabrika aşağıdaki avantajları sunar: 

• Mantıksal gRPC istemci örneklerini yapılandırmak için merkezi bir konum sağlar 

• Temel alınan HttpciientMessageHandier ömrünü yönetir 

• ASP.NET Core gRPC hizmetinde son tarih ve iptali otomatik olarakyayma 

GRPC istemcilerini kaydetme 

Bir gRPC istemcisini kaydetmek için genel AddGrpcciient uzantısı yöntemi, startup.configureservices içinde, 
gRPC türü belirtilmiş istemci sınıfı ve hizmet adresi belirtilerek kullanılabilir: 

Services.AddGrpcClient<Greeter.GreeterClient>(o => 

{ 

o.Address = new Uri("https://localhost:5001"); 

}); 

GRPC istemci türü, bağımlılık ekleme (dı) ile geçici olarak kaydedilir, istemci artık, Dİ tarafından oluşturulan 
türlere eklenebilir ve doğrudan tüketilebilir. ASP.NET Core MVC denetleyicileri, SignalR hub 1ar ve gRPC 
Hizmetleri, gRPC istemcilerinin otomatik olarak eklenmesi için gereken yerdir: 

public class AggregatorService : Aggregator.AggregatorBase 
{ 

private readonly Greeter.GreeterClient _client; 

public AggregatorService(Greeter.GreeterClient Client) 

{ 

_client = Client; 

} 

public override async Task SayHellos(HelloRequest request, 

IServerStreamWriter<HelloReply> responseStream, ServerCallContext context) 

{ 

// Forward the cali on to the greeter service 
using (var cali = _client.SayHellos(request)) 

{ 

await foreach (var response in call.ResponseStream.ReadAHAsync()) 

{ 

await responseStream.WriteAsync(response); 

} 

} 

} 

} 


HttpClient 'ı yapılandırma 

HttpClientFactory , gRPC istemcisi tarafından kullanılan HttpClient oluşturur. Standart HttpClientFactory 
Yöntemler, giden istek ara yazılımı eklemek veya HttpClient temel HttpciientHandier yapılandırmak için 















kullanılabilir: 


Services 

.AddGrpcClient<Greeter.GreeterClient>(o => 

{ 

o.Address = new Uri("https://localhost:5001"); 

}) 

.ConfigurePrimaryHttpMessageHandler(() => 

{ 

var handler = new HttpClientHandler(); 
handler.ClientCertificates.Add(LoadCertificate()); 
return handler; 

})J 


Daha fazla bilgi için bkz. ıhttpclientfactory kullanarak http İstekleri oluşturma. 

Kanalı ve Yakacıları yapılandırma 

gRPC 'y e özgü Yöntemler şu şekilde kullanılabilir: 

• Bir gRPC istemcisinin temel kanalını yapılandırın. 

• GRPC çağrıları yaparken istemcinin kullanacağı interceptor örnekleri ekleyin. 

Services 

.AddGrpcClient<Greeter.GreeterClient>(o => 

{ 

o.Address = new Uri("https://localhost:5001")j 

}) 

.AddInterceptor(() => new LoggingInterceptor()) 

.ConfigureChannel(o => 

{ 

o.Credentials = new CustomCredentials(); 

}); 


Son Tarih ve iptal yayma 

bir gRPC hizmetinde fabrika tarafından oluşturulan gRPC istemcileri, son tarih ve iptal belirtecini alt çağrılara 
otomatik olarak yaymak için EnableCallContextPropagation() ile yapilandirilabilir. EnableCallContextPropagation() 
uzantısı yöntemi GRPC. AspNetCore. Server. ClientFactory NuGet paketinde bulunur. 

Çağrı bağlamı yayma, geçerli gRPC isteği bağlamından son tarih ve iptal belirtecini okuyarak ve bunları otomatik 
olarak gRPC istemcisi tarafından yapılan giden çağrılara yayarak işe yarar. Çağrı bağlamı yayma, karmaşık, iç içe 
gRPC senaryolarının her zaman son tarihi ve iptali yaymasını sağlamaya yönelik mükemmel bir yoldur. 

Services 

.AddGrpcClient<Greeter.GreeterClient>(o => 

{ 

o.Address = new Uri("https://localhost:5001"); 

}) 

.EnableCallContextPropagation(); 

Son tarihler ve RPC iptali hakkında daha fazla bilgi için bkz. RPC yaşam döngüsü. 

Ek kaynaklar 

• .NET istemcisiyle gRPC hizmetlerini çağırma 

• ASP.NET Core 'de ıhttpclientfactory kullanarak HTTP istekleri yapın 









.NET için gRPC yapılandırması 
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Hizmet seçeneklerini yapılandırma 

GRPC Hizmetleri, Startup.cs\çnde AddGrpc ile yapılandırılır. Aşağıdaki tabloda, gRPC hizmetlerini yapılandırma 
seçenekleri açıklanmaktadır: 


SEÇENEK 

DEFAULT VALUE 

AÇIKLAMA 

MaxSendMessageSize 

null 

Sunucudan gönderilebilecek en büyük 
ileti boyutu (bayt). Yapılandırılan en 
büyük ileti boyutunu aşan bir ileti 
gönderilmeye çalışılıyor, bir özel 
durumla sonuçlanır. 


MaxReceiveMessagesize 4 MB Sunucu tarafından alınabilecek, bayt 

olarak en büyük ileti boyutu. Sunucu bu 
sınırı aşan bir ileti alırsa bir özel durum 
oluşturur. Bu değeri artırmak, 
sunucunun daha büyük iletiler almasına 
izin verir, ancak bellek tüketimini 
olumsuz etkileyebilir. 


EnableDetailedErrors false ise true , bir hizmet yönteminde özel 

durum oluştuğunda istemcilere ayrıntılı 
özel durum iletileri döndürülür. 
Varsayılan, false değeridir. 

EnableDetailedErrors İçin true 
ayarı, hassas bilgileri sızdırabilir. 


compressionProviders Gzip iletileri sıkıştırmak ve açmak için 

kullanılan bir sıkıştırma sağlayıcıları 
koleksiyonu. Özel sıkıştırma sağlayıcıları 
oluşturulup koleksiyona eklenebilir. 
Varsayılan yapılandırılmış sağlayıcılar 
gzip sıkıştırmasını destekler. 


ResponseCompressionAlgorithm null Sunucudan gönderilen iletileri 

sıkıştırmak için kullanılan sıkıştırma 
algoritması. Algoritmanın içindeki 
CompressionProviders bir sıkıştırma 
sağlayıcısıyla eşleşmesi gerekir. Bir yanıtı 
sıkıştırmaya yönelik algoritma için, 
istemci, GRPC-Accept-Encoding 
üstbilgisine göndererek algoritmayı 
desteklediğini göstermelidir. 


ResponseCompressionLevel 


null 


Sunucudan gönderilen iletileri 
sıkıştırmak için kullanılan sıkıştırma 
düzeyi. 


Seçenekler, AddGrpc içindeki startup.configureServices çağrıya bir seçenek temsilcisi sağlayarak tüm hizmetler 
için yapılandırılabilir: 


















public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddGrpc(options => 

{ 

options.EnableDetailedErrors = true; 

options.MaxReceiveMessageSize = 2 * 1024 * 1024; // 2 MB 
options.MaxSendMessageSize = 5 * 1024 * 1024; // 5 MB 

}); 

} 

Tek bir hizmetin seçenekleri ' de AddGrpc belirtilen genel seçenekleri geçersiz kılar ve kullanılarak 
AddServiceOptions<TService> yapılandırılabilir: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddGrpc().AddServiceOptions<MyService>(options => 

{ 

options.MaxReceiveMessageSize = 2 * 1024 * 1024; // 2 MB 
options.MaxSendMessageSize = 5 * 1024 * 1024; // 5 MB 

}); 

} 


İstemci seçeneklerini yapılandırma 

gRPC istemci yapılandırması üzerinde GrpcChannelOptions ayarlanır. Aşağıdaki tabloda, gRPC kanallarını 
yapılandırma seçenekleri açıklanmaktadır: 

SEÇENEK DEFAULT VALUE AÇIKLAMA 


Httpclient Yeni örnek GRPC çağrısı yapmak için kullanılır. 

Httpclient istemci, özel 
HttpclientHandler yapılandırmak 
üzere ayarlanabilir veya GRPC 
çağrılarına yönelik http işlem hattına ek 
işleyiciler ekleyebilir. Hayır Httpclient 
belirtilmişse kanal için yeni 
Httpclient bir örnek oluşturulur. 
Otomatik olarak elden kaldırılacaktır. 


DisposeHttpClient false , Ve bir Httpclient belirtilmişse, 

Httpclient „ bırakıldığında 
GrpcChannel örnek de silinir, true 

LoggerFactory null istemci tarafından GRPC çağrıları 

hakkındaki bilgileri günlüğe kaydetmek 
için kullanılır. LoggerFactory Örnek, 


kullanılarak LoggerFactory. Create 
bağımlılık ekleme veya oluşturma 
Öğesinden çözülebilir. LoggerFactory 
Günlüğe kaydetmeyi yapılandırma 
örnekleri için bkz .NET üzerinde gRPC 
'de günlüğe kaydetme ve tanılama. 














SEÇENEK 


DEFAULT VALUE 


AÇIKLAMA 


MaxSendMessagesize null istemciden gönderilebilecek en büyük 

ileti boyutu (bayt). Yapılandırılan en 
büyük ileti boyutunu aşan bir ileti 
gönderilmeye çalışılıyor, bir özel 
durumla sonuçlanır. 


MaxReceiveMessagesize 4 MB istemci tarafından alınabilecek, bayt 

olarak en büyük ileti boyutu, istemci bu 
sınırı aşan bir ileti alırsa bir özel durum 
oluşturur. Bu değeri artırmak, istemcinin 
daha büyük iletiler almasına izin verir, 
ancak bellek tüketimini olumsuz 
etkileyebilir. 


Credentials null Bir ChannelCredentials Örnek. Kimlik 

bilgileri, gRPC çağrılarına kimlik 
doğrulama meta verileri eklemek için 
kullanılır. 


compr'essionProviders Gzip iletileri sıkıştırmak ve açmak için 

kullanılan bir sıkıştırma sağlayıcıları 
koleksiyonu. Özel sıkıştırma sağlayıcıları 
oluşturulup koleksiyona eklenebilir. 
Varsayılan yapılandırılmış sağlayıcılar 
gzip sıkıştırmasını destekler. 


Aşağıdaki kod: 

• Kanalda en büyük gönderme ve alma iletisi boyutunu ayarlar. 

• istemci oluşturur. 


static async Task Main(string[] args) 

{ 

var channel = GrpcChannel.ForAddress("https://localhost:5001", new GrpcChannelOptions 
{ 

MaxReceiveMessageSize = 5 * 1024 * 1024, // 5 MB 
MaxSendMessageSize = 2 * 1024 * 1024 // 2 MB 

}); 

var Client = new Greeter.GreeterClient(channel); 

var reply = await Client.SayHelloAsync( 

new HelloRequest { Name = "GreeterClient" }); 
Console.WriteLine("Greeting: " + reply.Message); 

} 


gRPC Azure App Service desteklenmiyor 


VVARNING 

ASP.NET Core gRPC Azure App SERVİCE veya MS 'de Şu anda desteklenmiyor. Http. sys ' nin HTTP/2 uygulamasına 
uygulanması, gRPC 'nin bağımlı olduğu HTTP yanıtı sondaki üst bilgileri desteklemez. Daha fazla bilgi için bu GitHub sorunu. 


Ek kaynaklar 


• ASP.NET Core içeren gRPC Hizmetleri 












.NET istemcisiyle gRPC hizmetlerini çağırma 

.NET üzerinde gRPC 'de günlüğe kaydetme ve tanılama 

ASP.NET Core .NET Core gRPC istemcisi ve sunucusu oluştu 


ASPNET Core için gRPC 'de kimlik doğrulaması ve 
yetkilendirme 
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, James bAyKİNg 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

GRPC hizmetini çağıran kullanıcıların kimliğini doğrulama 

gRPC, bir kullanıcıyı her çağrıyla ılişkilendirmek için ASP.NET Core kimlik doğrulamasıyla birlikte kullanılabilir. 
Aşağıda, gRPC ve ASP.NET Core kimlik doğrulaması kullanan startup.configure bir örneği verilmiştir: 

public void Configure(IApplicationBuilder app) 

{ 

app.UseRoutingO; 

app.UseAuthentication(); 
app.UseAuthorization(); 

app.UseEndpoints(endpoints => 

{ 

routes.MapGrpcService<GreeterService>(); 

}); 

} 


NOTE 

ASP.NET Core kimlik doğrulama ara yazılımını kaydetme sırası önemli. useRouting ve useEndpoints önce 
UseAuthentication ve UseAuthorization her zaman çağırın. 


Bir çağrı sırasında uygulamanızın kullandığı kimlik doğrulama mekanizması yapılandırılmalıdır. Kimlik doğrulama 
yapılandırması startup.configureservices eklenir ve uygulamanızın kullandığı kimlik doğrulama mekanizmasına 
bağlı olarak farklı olacaktır. AS P.N ET Core uygulamaları güvenli hale getirmeye yönelik örnekler için bkz. kimlik 
doğrulama örnekleri. 

Kimlik doğrulaması kurulduktan sonra, kullanıcıya serverCaiıcontext aracılığıyla bir gRPC hizmeti yöntemleriyle 
erişilebilir. 

public override Task<BuyTicketsResponse> BuyTickets( 

BuyTicketsRequest requestj ServerCallContext context) 

{ 

var user = context.GetHttpContext().User; 

// ... access data from ClaimsPrincipal .. . 

} 

Taşıyıcı belirteç kimlik doğrulaması 

istemci, kimlik doğrulaması için bir erişim belirteci sağlayabilir. Sunucu belirteci doğrular ve kullanıcıyı tanımlamak 
için kullanır. 











Sunucusunda, taşıyıcı belirteç kimlik doğrulaması JWT taşıyıcı ara yazılımıkullanılarak yapılandırılır. 

.NET gRPC istemcisinde, belirteç aramalar ile üst bilgi olarak gönderilebilir: 

public bool DoAuthenticatedCall( 

Ticketer.TicketerClient Client, string token) 

{ 

var headers = new Metadata(); 

headers.Add("Authorization", $"Bearer {token}"); 

var request = new BuyTicketsRequest { Count = 1 }; 

var response = await Client.BuyTicketsAsync(request, headers); 

return response.Success; 

} 

Bir kanalda channeicredentiais yapılandırmak, belirteci gRPC çağrılarıyla hizmete göndermenin alternatif bir 
yoludur. Kimlik bilgisi her bir gRPC çağrısının yapılışında çalıştırılır. Bu, belirteci kendi kendinize geçirmek için 
birden çok yere kod yazma gereksinimini ortadan kaldırır. 

Aşağıdaki örnekteki kimlik bilgileri, kanalı her gRPC çağrısıyla birlikte gönderecek şekilde yapılandırır: 

private static GrpcChannel CreateAuthenticatedChannel(string address) 

{ 

var credentials = CallCredentials.FromInterceptor((context, metadata) => 

{ 

if (!string.IsNullOrEmpty(_token)) 

{ 

metadata.AddC'Authorization", $"Bearer {_token}"); 

} 

return Task.CompletedTask; 

}); 

// SslCredentials is used here because this channel is using TLS. 

// CallCredentials can't be used with ChannelCredentials.Insecure on non-TLS channels. 
var channel = GrpcChannel.ForAddress(address, new GrpcChannelOptions 
{ 

Credentials = ChannelCredentials.Create(new SslCredentials(), credentials) 

}); 

return channel; 

} 

İstemci sertifikası kimlik doğrulaması 

istemci alternatif olarak kimlik doğrulaması için bir istemci sertifikası sağlayabilir. Sertifika kimlik doğrulaması TLS 
düzeyinde gerçekleşir ve bu süre AS P.N ET Core. istek AS P.N ET Core girdiğinde, istemci sertifikası kimlik 
doğrulama paketi, sertifikayı bir ciaimsPrincipai çözmenize olanak tanır. 


NOTE 

Konağın istemci sertifikalarını kabul edecek şekilde yapılandırılması gerekir. Bkz. Kestrel, MS ve Azure 'da istemci sertifikalarını 
kabul etme hakkında bilgi için bkz. ana bilgisayarınızı yapılandırma . 


.NET gRPC istemcisinde istemci sertifikası, daha sonra gRPC istemcisini oluşturmak için kullanılan 
HttpClientHandler eklenir: 








public Ticketer.TicketerClient CreateClientWithCert( 
string baseAddresSj 
X509Certificate2 centificate) 

{ 

// Add Client cert to the handler 

var handler = new HttpClientHandler(); 

handler.ClientCertificates.Add(certificate); 

// Create the gRPC channel 

var channel = GrpcChannel.ForAddress(baseAddress, new GrpcChannelOptions 
{ 

HttpClient = new HttpClient(handler) 

}); 

return new Ticketer.TicketerClient(channel); 

} 

Diğer kimlik doğrulama mekanizmaları 

Desteklenen birçok ASP.NET Core kimlik doğrulama mekanizması gRPC ile çalışır: 

• Azure Active Directory 

• istemci sertifikası 

• IdentityServer 

• JWT belirteci 

• OAuth 2.0 

• Öpeni D Connect 

• WS-Federation 

Sunucuda kimlik doğrulamasını yapılandırma hakkında daha fazla bilgi için, ASP.NET Core kimlik doğrulaması' na 
bakın. 

GRPC istemcisini kimlik doğrulaması kullanacak şekilde yapılandırmak, kullanmakta olduğunuz kimlik doğrulama 
mekanizmasına bağlı olarak değişir. Önceki taşıyıcı belirteci ve istemci sertifikası örnekleri, GRPC istemcisinin, 
gRPC çağrılarına yönelik kimlik doğrulama meta verilerini gönderecek şekilde yapılandırılabilmesinin birkaç 
yolunu gösterir: 

• Türü kesin belirlenmiş gRPC istemcileri dahili olarak HttpClient kullanır. Kimlik doğrulaması, 
HttpClientHandlerüzerinde veya HttpClient özel HttpMessageHandler örnekleri eklenerek yapılandırılabilir. 

• Her gRPC çağrısının isteğe bağlı bir Caiıoptions bağımsız değişkeni vardır. Özel üstbilgiler, seçeneğin 
üstbilgiler koleksiyonu kullanılarak gönderilebilir. 


NOTE 

Windows kimlik doğrulaması (NTLM/Kerberos/Negotiate), gRPC ile kullanılamaz. gRPC için HTTP/2 ve HTTP/2 Windows kimlik 
doğrulamasını desteklemez. 


Kullanıcılara hizmetlere ve hizmet yöntemlerine erişim yetkisi verme 

Varsayılan olarak, bir hizmette tüm yöntemler kimliği doğrulanmamış kullanıcılar tarafından çağrılabilir. Kimlik 
doğrulaması gerektirmek için [Authorize] özniteliğini hizmete uygulayın: 

[Authorize] 

public class TicketerService : Ticketer.TicketerBase 
{ 

} 








Yalnızca belirli Yetkilendirme ilkeleriyleeşleşen kullanıcılara erişimi kısıtlamak için [Authorize] özniteliğinin 
Oluşturucu bağımsız değişkenlerini ve özelliklerini kullanabilirsiniz. Örneğin, MyAuthorizationPolicy adlı bir özel 
yetkilendirme ilkeniz varsa, aşağıdaki kodu kullanarak yalnızca bu ilkeyle eşleşen kullanıcıların hizmete 
erişebildiğinden emin olun: 


[Authorize("MyAuthorizationPolicy")] 

public class TicketerService : Ticketer.TicketerBase 

{ 

} 


Tek tek hizmet yöntemlerinde [Authorize] özniteliği de uygulanabilir. Geçerli Kullanıcı hem yönteme hem de sınıfa 
uygulanan ilkelerle eşleşmezse, çağırana bir hata döndürülür: 

[Authorize] 

public class TicketerService : Ticketer.TicketerBase 
{ 

public override Task<AvailableTicketsResponse> GetAvailableTickets( 

Empty requestj ServerCallContext context) 

{ 

// ... buy tickets for the current user ... 

} 

[Authorize("Administrators")] 

public override Task<BuyTicketsResponse> RefundTickets( 

BuyTicketsRequest request, ServerCallContext context) 

{ 

// ... refund tickets (something only Administrators can do) .. 

} 

} 


Ek kaynaklar 

• AS P.N ET Core 'de taşıyıcı belirteç kimlik doğrulaması 

• ASP.NET Core 'de İstemci sertifikası kimlik doğrulamasını yapılandırma 







.NET üzerinde gRPC 'de günlüğe kaydetme ve 
tanılama 
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Bu makalede, sorunları gidermeye yardımcı olmak için gRPC uygulamanızdan tanılamayı toplamaya yönelik 
rehberlik sunulmaktadır. 

gRPC Hizmetleri günlüğü 

VVARNING 

Sunucu tarafı günlükleri, uygulamanızdan önemli bilgiler içerebilir. Ham günlükleri hiçbir şekilde üretim uygulamalarından 
GitHub gibi genel forumlara nakletmeyin. 


GRPC Hizmetleri ASP.NET Core üzerinde barındırıldığından, bu, ASP.NET Core günlük sistemini kullanır. 
Varsayılan yapılandırmada, gRPC çok az bilgiyi günlüğe kaydeder, ancak bu yapilandinlabilir.ASP.NET Core 
günlüğü yapılandırma hakkında ayrıntılar için ASP.NET Core günlüğe kaydetme hakkındaki belgelere bakın. 

GRPC, Grpc kategori altına Günlükler ekler.GRPC 'den ayrıntılı günlükleri etkinleştirmek için, aşağıdaki öğeleri 
Grpc LogLevel içindeki Logging alt bölümüne Debug ekleyerek, ön ekleri appSettings. JSON dosyanızdaki 
düzeye yapılandırın: 

{ 

"Logging": { 

"LogLevel": { 

"Default": "Debug", 

"System": "Information", 

"Microsoft": "Information", 

"Grpc": "Debug" 

} 

} 

} 

Bunu, Startup.es configureLogging içinde şu şekilde de yapılandırabilirsiniz: 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureLogging(logging => 

{ 

logging.AddFilter("Grpc", LogLevel.Debug); 

}) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 

JSON tabanlı yapılandırma kullanmıyorsanız, yapılandırma sisteminizde aşağıdaki yapılandırma değerini ayarlayın: 
• Logging:LogLevel:Grpc = Debug 















iç içe yapılandırma değerlerinin nasıl belirleneceğini belirlemek için yapılandırma sisteminizin belgelerini 
denetleyin. Örneğin, ortam değişkenleri kullanılırken, yerine _ : iki karakter kullanılır (örneğin, 

Logging_LogLevel_Grpc ). 


Uygulamanız için daha ayrıntılı Debug tanılama toplanırken düzeyin kullanılmasını öneririz. Düzey Trace , çok 
düşük düzey Tanılamalar üretir ve uygulamanızdaki sorunları tanılamak için nadiren gereklidir. 

Örnek günlüğe kaydetme çıkışı 

Aşağıda, bir GRPC hizmeti Debug düzeyinde konsol çıkışının bir örneği verilmiştir: 

info: Microsoft.AspNetCore.Hosting.Diagnostics[1] 

Request starting HTTP/2 POST https://localhost:5001/Greet.Greeter/SayHello application/grpc 
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[0] 

Executing endpoint 'gRPC - /Greet.Greeter/SayHello' 
dbug: Grpc.AspNetCore.Server.ServerCallHandlerfl] 

Reading message. 

info: GrpcService.GreeterService[0] 

Hello World 

dbug: Grpc.AspNetCore.Server.ServerCallHandler[6] 

Sending message. 

info: Microsoft.AspNetCore.Routing.EndpointMiddleware[l] 

Executed endpoint ’gRPC - /Greet.Greeter/SayHello' 
info: Microsoft.AspNetCore.Hosting.Diagnostics[2] 

Request finished in 1.4113ms 200 application/grpc 


Sunucu tarafı günlüklerine erişin 

Sunucu tarafı günlüklerine erişme, çalıştırdığınız ortama bağlıdır. 

Konsol uygulaması olarak 

Konsol uygulamasında çalıştırıyorsanız, konsol günlükçüsü varsayılan olarak etkinleştirilmelidir. gRPC günlükleri 
konsolunda görünür. 

Diğer ortamlar 

Uygulama başka bir ortama (örneğin, Docker, Kubernetes veya Windows hizmeti) dağıtılırsa, ortama uygun 
günlük sağlayıcılarının nasıl .NET Core ve ASP.NET Core oturum açma yapılandırılacağı hakkında daha fazla bilgi 
için bkz. 

gRPC istemci günlüğü 

VVARNING 

istemci tarafı günlükleri, uygulamanızdan önemli bilgiler içerebilir. Ham günlükleri hiçbir şekilde üretim uygulamalarından 
GitHub gibi genel forumlara nakletmeyin. 


.Net istemcisinden günlükleri almak için, GrpcChannelOptions.LoggerFactory özelliği istemci kanalının oluşturulduğu 
zaman ayarlayabilirsiniz. Bir ASP.NET Core uygulamasından gRPC hizmetini arıyorsanız, günlükçü fabrikası 
bağımlılık ekleme (Dİ) 1 dan çözülebilir: 










[ApiController] 

[Route("[controller]")] 

public class GreetingController : ControllerBase 

{ 

private ILoggerFactory _loggerFactory; 

public GreetingController(ILoggerFactory loggerFactory) 

{ 

_loggerFactory = loggerFactory; 

} 

[FlttpGet] 

public async Task<ActionResult<string>> Get(string name) 

{ 

var channel = GrpcChannel.ForAddress("https://localhost:5001", 
new GrpcChannelOptions { LoggerFactory = _loggerFactory }); 
var Client = new Greeter.GreeterClient(channel); 

var reply = await Client.SayFlelloAsync(new HelloRequest { Name = name }); 
return Ok(reply.Message); 

} 

} 

İstemci günlüğünü etkinleştirmenin alternatif bir yolu, istemci oluşturmak için GRPC istemci fabrikası kullanmaktır, 
istemci fabrikasına kayıtlı ve di 'den çözümlenen bir gRPC istemcisi, otomatik olarak uygulamanın yapılandırılmış 
günlüğünü kullanacaktır. 

Uygulamanız dı kullanıyorsa, ILoggerFactory loggerfactory. Createile yeni bir örnek oluşturabilirsiniz. Bu yönteme 
erişmek için Microsoft. Extensions. Logging paketini uygulamanıza ekleyin. 

var loggerFactory = LoggerFactory.Create(logging => 

{ 

logging.AddConsole(); 

logging.SetMinimumLevel(LogLevel.Debug); 

}); 

var channel = GrpcChannel.ForAddress("https://localhost:5001", 
new GrpcChannelOptions { LoggerFactory = loggerFactory }); 

var Client = Greeter.GreeterClient(channel); 


Örnek günlüğe kaydetme çıkışı 

Aşağıda, bir GRPC istemcisinin Debug düzeyindeki konsol çıkışının bir örneği verilmiştir: 

dbug: Grpc.Net.Client.Internal.GrpcCall[l] 

Starting gRPC cali. Method type: 'Unary', URI: 'https://localhost:5001/Greet.Greeter/SayHello’. 
dbug: Grpc.Net.Client.Internal.GrpcCall[6] 

Sending message. 

dbug: Grpc.Net.Client.Internal.GrpcCall[l] 

Reading message. 

dbug: Grpc.Net.Client.Internal.GrpcCall[4] 

Finished gRPC cali. 


Ek kaynaklar 

• .N ET Core ve AS P.N ET Core oturum açma 

• .NET için gRPC yapılandırması 

• .NET Core 'da gRPC istemci fabrikası tümleştirmesi 
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Bu makalede, gRPC 'yi -N ET Core ile güvenli hale getirme hakkında bilgi verilmektedir. 

Taşıma güvenliği 

gRPC iletileri HTTP/2 kullanılarak gönderilir ve alınır.Şunları öneririz: 

• Aktarım Katmanı Güvenliği (TLS) , üretim GRPC uygulamalarında iletileri güvenli hale getirmek için kullanılır. 

• gRPC Hizmetleri yalnızca güvenli bağlantı noktalarını dinler ve bunlara yanıt vermelidir. 

TLS, Kestrel içinde yapılandırılır. Kestrel uç noktalarını yapılandırma hakkında daha fazla bilgi için bkz. Kestrel 
Endpoint Configuration. 

Özel Durumlar 

Özel durum iletileri genellikle bir istemciye görüntülenmemelidir gizli veriler olarak değerlendirilir. Varsayılan 
olarak, gRPC, bir gRPC hizmeti tarafından oluşturulan özel durumun ayrıntılarını istemciye göndermez. Bunun 
yerine, istemci bir hata oluştuğunu belirten genel bir ileti alır, istemciye özel durum iletisi teslimi, 
Enabledetailederrorsile geçersiz kılınabilir (örneğin, geliştirme veya test). Özel durum iletileri, üretim 
uygulamalarındaki istemciye gösterilmemelidir. 

İleti boyutu sınırları 

GRPC istemcilerine ve hizmetlerine gelen iletiler belleğe yüklenir, ileti boyutu sınırları, gRPC 'nin aşırı kaynak 
tüketmesini önlemeye yardımcı olmak için bir mekanizmadır. 

gRPC gelen ve giden iletileri yönetmek için ileti başına boyut sınırlarını kullanır.Varsayılan olarak, gRPC gelen 
iletileri 4 MB ile sınırlandırır. Giden iletilerde sınır yoktur. 

Sunucusunda, gRPC ileti limitleri bir uygulamadaki tüm hizmetler için ile AddGrpc yapılandırılabilir: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddGrpc(options => 

{ 

options.MaxReceiveMessageSize = 1 * 1024 * 1024; // 1 MB 
options.MaxSendMessageSize = 1 * 1024 * 1024; // 1 MB 

}); 

} 

Ayrıca, kullanılarak AddServiceOptions<TService> tek bir hizmet için sınırlamalar da yapılandırılabilir. ileti boyutu 
sınırlarını yapılandırma hakkında daha fazla bilgi için bkz. GRPC yapılandırması. 

İstemci sertifikası doğrulaması 

istemci sertifikaları , bağlantı oluşturulduğunda başlangıçta onaylanır. Varsayılan olarak, Kestrel bir bağlantının 
istemci sertifikası için ek doğrulama gerçekleştirmez. 

istemci sertifikaları tarafından güvenliği sağlanan gRPC hizmetlerinin Microsoft. AspNetCore. Authentication. 






Certificate paketini kullanması önerilir. AS P.N ET Core sertifika kimlik doğrulaması, bir istemci sertifikasında 
aşağıdakiler de dahil olmak üzere ek doğrulama gerçekleştirir: 

• Sertifikada geçerli bir genişletilmiş anahtar kullanımı (EKU) vardır 

• Geçerlilik süresi içinde 

• Sertifika iptalini denetle 


dotnet-grpc ile Protobuf başvurularını yönetme 
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dotnet-grpc , bir .NET gRPC projesindeki protodeğer (. proto) başvurularını yönetmek için .NET Core küresel bir 
araçtır. Araç, prototipleme başvurularını eklemek, yenilemek, kaldırmak ve listelemek için kullanılabilir. 

Yükleme 

@No__t-0 .NET Core küresel aracı'nı yüklemek için şu komutu çalıştırın: 

dotnet tool install -g dotnet-grpc 


Başvuru Ekle 

dotnet-grpc ,. csproj dosyasına <Protobuf /> öğe olarak prototip başvuruları eklemek için kullanılabilir: 

<Protobuf Include="Protos\greet.proto" GrpcServices="Server" /> 

Prototip başvuruları, C# istemci ve/veya sunucu varlıklarını oluşturmak için kullanılır.@No_t-0 aracı şunları 

yapabilir: 

• Diskteki yerel dosyalardan Prototipsiz başvuru oluştur. 

• Bir URL ile belirtilen uzak dosyadan Protobir başvuru oluştur. 

• Projeye doğru gRPC paket bağımlılıklarının eklendiğinden emin olun. 

Örneğin, Grpc.AspNetcore paketi bir Web uygulamasına eklenir. Grpc.AspNetcore gRPC sunucusu ve istemci 
kitaplıklarını ve araç desteğini içerir. Alternatif olarak, yalnızca gRPC istemci kitaplıklarını ve araç desteğini içeren 
Grpc.Net.Client Grpc.Tools ve Google.Protobuf paketleri konsol uygulamasına eklenir. 

Dosya Ekle 

@No__t-0 komutu, disk üzerindeki yerel dosyaları prototip başvuruları olarak eklemek için kullanılır.Belirtilen 
dosya yolları: 

• Geçerli dizin veya mutlak yollarla göreli olabilir. 

• , Globmodel tabanlı dosya için joker karakterler içerebilir. 

Herhangi bir dosya proje dizininin dışındaysa, dosyayı Visual Studio 'da Protos klasörü altında göstermek için 
Link öğesi eklenir. 

Kullanım 

dotnet grpc add-file [options] <files>... 

Arguments 

BAĞIMSIZ DEĞİŞKEN AÇIKLAMA 













BAĞIMSIZ DEĞİŞKEN 


AÇIKLAMA 


dosyaları 


Seçenekler 


Prototip dosyası başvuruları. Bunlar yerel prototipli dosyalar 
için glob 'nin bir yolu olabilir. 


SHORT SEÇENEĞİ 

LONG SEÇENEĞİ 

AÇIKLAMA 

-p 

--Proje 

Üzerinde çalışılacak proje dosyasının 
yolu. Bir dosya belirtilmemişse, komut 
geçerli dizinde bir arama yapar. 

-s 

--Hizmetler 

Oluşturulması gereken gRPC Hizmetleri 
türü. @No_t-0 belirtilirse, Web projeleri 
için Both kullanılır ve Web dışı projeler 
için Client kullanılır. Kabul edilen 
değerler Both , Client , Default , 

None , Server ' tir. 

-i 

--ek-içeri aktarma-Dizin 

Prototip dosyaları için içeri aktarmalar 
çözümlenirken kullanılacak ek dizinler. 

Bu, yolların noktalı virgülle ayrılmış 
listesidir. 


--erişim 

Oluşturulan C# sınıflar için kullanılacak 
erişim değiştiricisi. Varsayılan değer 

Public şeklindedir. Kabul edilen 
değerler Internal ve Public ' dir. 

URL Ekle 



@No__t-0 komutu, kaynak URL tarafından belirtilen bir uzak dosyayı prototipde başvuru olarak eklemek için 
kullanılır. Uzak dosyanın nereye indirileceği belirtmek için bir dosya yolu belirtilmelidir. Dosya yolu, geçerli dizin 
veya mutlak bir yol ile ilişkili olabilir. Dosya yolu proje dizininin dışındaysa, Visual Studio 'da Protos sanal klasörü 
altında dosyayı göstermek için bir Link öğesi eklenir. 

Kullanım 



dotnet-grpc add-url [options] <url> 

Arguments 



BAĞIMSIZ DEĞİŞKEN 

AÇIKLAMA 


'deki 

Uzak protoarabellek dosyasının URL 'SI. 

Seçenekler 



SHORT SEÇENEĞİ 

LONG SEÇENEĞİ 

AÇIKLAMA 

-o 

-çıkış 

Uzak protoarabellek dosyası için indirme 
yolunu belirtir. Bu gerekli bir seçenektir. 

-p 

--Proje 

Üzerinde çalışılacak proje dosyasının 


yolu. Bir dosya belirtilmemişse, komut 
geçerli dizinde bir arama yapar. 







SHORT SEÇENEĞİ 


LONG SEÇENEĞİ 


AÇIKLAMA 


-s --Hizmetler Oluşturulması gereken gRPC Hizmetleri 

türü. @No_t-0 belirtilirse, Web projeleri 
için Both kullanılır ve Web dışı projeler 
için Client kullanılır. Kabul edilen 
değerler Both , Client , Default , 
None , Server ' tir. 


--ek-içeri aktarma-Dizin Prototip dosyaları için içeri aktarmalar 

çözümlenirken kullanılacak ek dizinler. 
Bu, yolların noktalı virgülle ayrılmış 
listesidir. 


--erişim 


Oluşturulan C# sınıflar için kullanılacak 
erişim değiştiricisi. Varsayılan değer 



Kaldır 

@No__t-0 komutu,. csproj dosyasından prototipsiz başvuruları kaldırmak için kullanılır. Komut bağımsız değişken 
olarak yol bağımsız değişkenlerini ve kaynak URL 'Lerini kabul eder. Araç: 

• Yalnızca Prototipsiz başvuruyu kaldırır. 

• , ilk olarak uzak bir URL 'den indirilse bile,. proto dosyasını silmez. 

Kullanım 

dotnet-grpc remove [options] <references>... 

Arguments 

BAĞIMSIZ DEĞİŞKEN AÇIKLAMA 

başvurular Kaldırılacak prototip başvurularının URL 'Leri veya dosya 

yolları. 


Seçenekler 


SHORT SEÇENEĞİ 

LONG SEÇENEĞİ 

AÇIKLAMA 

-P 

--Proje 

Üzerinde çalışılacak proje dosyasının 



yolu. Bir dosya belirtilmemişse, komut 



geçerli dizinde bir arama yapar. 


Yenile 

@No__t-0 komutu, kaynak URL 'den en son içerikle uzak bir başvuruyu güncelleştirmek için kullanılır.Yalnızca 
indirme dosyası yolu ve kaynak URL 'SI, güncellenmek üzere olan başvuruyu belirtmek için kullanılabilir. Not 

• Dosya içeriğinin karmaları yerel dosyanın güncelleştirilip güncelleştirilmediğini belirleme ile karşılaştırılır. 

• Zaman damgası bilgisi karşılaştırılmaz. 


Bir güncelleştirme gerekiyorsa araç her zaman yerel dosyayı uzak dosya ile değiştirir. 





Kullanım 


dotnet-grpc refresh [options] [<references>...] 

Arguments 



BAĞIMSIZ DEĞİŞKEN 


AÇIKLAMA 

başvurular 


Güncellenmesi gereken uzak prototip başvurularına yönelik 

URL veya dosya yolları. Tüm Uzak başvuruları yenilemek için 
bu bağımsız değişkeni boş bırakın. 

Seçenekler 



SHORT SEÇENEĞİ 

LONG SEÇENEĞİ 

AÇIKLAMA 

-P 

--Proje 

Üzerinde çalışılacak proje dosyasının 
yolu. Bir dosya belirtilmemişse, komut 
geçerli dizinde bir arama yapar. 


--Kuıu-Çalıştır 

Herhangi bir yeni içerik indirilmeden 
güncelleştirilenecek dosyaların listesini 
verir. 

List 



@No__t-0 komutu, proje dosyasındaki tüm Prototipsiz 
değerleri varsayılan değerler ise, sütun atlanabilir. 

başvuruları göstermek için kullanılır. Bir sütunun tüm 

Kullanım 



dotnet-grpc list 

[options] 


Seçenekler 



SHORT SEÇENEĞİ 

LONG SEÇENEĞİ 

AÇIKLAMA 

-P 

--Proje 

Üzerinde çalışılacak proje dosyasının 
yolu. Bir dosya belirtilmemişse, komut 
geçerli dizinde bir arama yapar. 


Ek kaynaklar 


• .N ET Core'da gRPC'y e giriş 

• C# içeren gRPC hizmetleri 

• ASP.NET Core içeren gRPC Hizmetleri 




GRPC hizmetlerini C Core 'dan ASRNET Core 
geçirme 
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Temel alınan yığının uygulanması nedeniyle, tüm özellikler C Core tabanlı GRPC uygulamaları ve ASP.NET Core 
tabanlı uygulamalar arasında aynı şekilde çalışmaz. Bu belgede, iki yığın arasında geçiş yapmak için önemli 
farklılıklar vurgulanmıştır. 

gRPC hizmeti uygulama ömrü 

ASP.N ET Core yığınında, varsayılan olarak gRPC Hizmetleri kapsamlı bir ömürile oluşturulur. Buna karşılık, gRPC 
C-Core varsayılan olarak tek bir yaşam süresinesahip bir hizmete bağlanır. 

Kapsamlı ömür, hizmet uygulamasının kapsamlı ömürlerle diğer hizmetleri çözümlemesine izin verir.Örneğin, 
kapsamlı bir yaşam süresi Ayrıca, Oluşturucu ekleme yoluyla Dİ kapsayıcısından DbContext çözümleyebilir. 
Kapsamlı ömür kullanımı: 

• Her istek için hizmet uygulamasının yeni bir örneği oluşturulur. 

• Uygulama türündeki örnek üyeleri aracılığıyla istekler arasında durum paylaşmak mümkün değildir. 

• Beklentisi, paylaşılan durumları dı kapsayıcısında tek bir hizmette depobir biçimde depokadır. Depolanan 
paylaşılan durumlar, gRPC hizmet uygulamasının oluşturucusunda çözümlenir. 

Hizmet yaşam süreleri hakkında daha fazla bilgi için bkz. ASP.NET Core bağımlılık ekleme. 

Tek bir hizmet ekleyin 

GRPC C çekirdekli bir uygulamadan ASP.NET Core geçişi kolaylaştırmak için, hizmet uygulamasının hizmet 
ömrünü kapsamlı olarak tek başına değiştirmek mümkündür. Bu, bir hizmet uygulamasının bir örneğini dı 
kapsayıcısına eklemeyi içerir: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services .AddGrpc(); 

Services.AddSingleton(new GreeterService()); 

} 

Ancak, tek bir yaşam süresine sahip bir hizmet uygulamasının kapsamı, kapsamlı hizmetleri Oluşturucu ekleme 
yoluyla çözemeyebilir. 

GRPC Hizmetleri seçeneklerini yapılandırma 

C Core tabanlı uygulamalarda, grpc.max_receive_message_iength ve grpc.max_send_message_iength gibi ayarlar 
sunucu örneği oluşturulurken channeioption ile yapılandırılır. 

ASP.NET Core, gRPC GrpcServiceOptions türü aracılığıyla yapılandırma sağlar. Örneğin, bir gRPC hizmetinin en 
büyük gelen ileti boyutu AddGrpc aracılığıyla yapılandırılabilir. Aşağıdaki örnek, varsayılan MaxReceiveMessageSize 
4 MB ile 16 MB arasında değişir: 












public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddGrpc(options => 

{ 

options.MaxReceiveMessageSize = 16 * 1024 * 1024 j // 16 MB 
})J 

} 

Yapılandırma hakkında daha fazla bilgi için bkz. .NET için gRPC yapılandırması. 

Günlüğe Kaydetme 

C çekirdekli tabanlı uygulamalar, hata ayıklama amacıyla günlükçüsü yapılandırmak için GrpcEnvironment kullanır. 
ASP.N ET Core Stack, bu işlevselliği günlüğe kaydetme API 'siaracılığıyla sağlar. Örneğin, gRPC hizmetine 
Oluşturucu ekleme yoluyla bir günlükçü eklenebilir: 

public class GreeterService : Greeter.GreeterBase 
{ 

public GreeterService(ILogger<GreeterService> logger) 

{ 

} 

} 


HTTPS 

C-Core tabanlı uygulamalar, Server. Ports özel liğiaracılığıyla https 'yi yapılandırır. Benzer bir kavram, ASP.N ET 
Core sunucuları yapılandırmak için kullanılır. Örneğin, Kestrel Bu işlevsellik için uç nokta yapılandırması kullanır. 


gRPC yakalayıcılar vs ara yazılımı 

ASP.N ET Core Ara yazılım , C çekirdekli tabanlı GRPC uygulamalarındaki yakalayıcılar ile karşılaştırıldığında 
benzer işlevler sunar. AS P.N ET Core ara yazılımı ve yakalayıcılar kavramsal olarak benzerdir, is 

• , Bir gRPC isteğini işleyen bir işlem hattı oluşturmak için kullanılır. 

• işlem hattındaki bir sonraki bileşenden önce veya sonra iş gerçekleştirilmesine izin verin. 

• HttpContext erişim sağlayın: 

o Ara yazılım ' de HttpContext bir parametredir. 

o Yakalayıcılar ' de HttpContext , Ser'ver'CallContext.GetHttpContext uzantısı yöntemiyle ServerCallContext 
parametresi kullanılarak erişilebilir. Bu özelliğin ASP.NET Core ' de çalışan yakalayıcılar için özel 
olduğunu unutmayın. 

gRPC yakalayıcısı ASP.NET Core ara yazılım farklılıkları: 

• Kesiciler 

o Servercallcontextkullanarak GRPC soyutlama katmanı üzerinde çalışır, 
o Erişim sağla: 

o Seri durumdan çıkarılmış ileti bir çağrıya gönderildi, 
o Seri hale getirilmeden önce çağrıdan döndürülen ileti. 

• Yazılımlar 

o GRPC yakalayıcılar öncesinde çalışır, 
o Temel alınan HTTP/2 iletileri üzerinde çalışır, 
o Yalnızca istek ve yanıt akışlarından gelen baytlara erişebilir. 








Ek kaynaklar 

• .NET Core'da gRPC'ye giriş 

• C# içeren gRPC hizmetleri 

• ASP.NET Core içeren gRPC Hizmetleri 

• ASP.NET Core .NET Core gRPC istemcisi ve sunucusu oluşturma 


gRPC hizmetlerini HTTP APNeriyle karşılaştırma 
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Bu makalede, GRPC HİZMETLERİNİN HTTP API 'leri (ASP.NET Core Web API ' leridahil) ile nasıl karşılaştırılacağı 
açıklanmaktadır. Uygulamanız için bir API sağlamak için kullanılan teknoloji önemli bir seçimdir ve gRPC, HTTP 
API 'Lerine kıyasla benzersiz avantajlar sunmaktadır. Bu makalede, gRPC ’nin güçlü ve zayıf yönleri ele 
alınmaktadır ve gRPC 'nin diğer teknolojiler üzerinden kullanılması için senaryolar önerilmektedir. 

Üst düzey karşılaştırma 

Aşağıdaki tabloda, gRPC ve HTTP API 'Leri arasında JSON ile yüksek düzeyde bir karşılaştırma sunulmaktadır. 


ÖZELLİK 

GRPC 

JSON İLE HTTP API LERİ 

Sözleşme 

Gerekli (. proto) 

isteğe bağlı (Openapı) 

Protokol 

HTTP/2 

HTTP 

Te 

Prototip (küçük, ikili) 

JSON (büyük, insan tarafından 
okunabilir) 

Dikkatli olun 

Katı belirtim 

Miş. Herhangi bir HTTP geçerlidir. 

Akış 

istemci, sunucu, iki yönlü 

istemci, sunucu 

Tarayıcı desteği 

Hayır (GRPC-Web gerektirir) 

Evet 

Güvenlik 

Taşıma (TLS) 

Taşıma (TLS) 

istemci kod oluşturma 

Evet 

Openapı + üçüncü taraf araçları 


gRPC güçleri 

Performans 

gRPC iletileri, etkin bir ikili ileti biçimi olan Protoarabelleğekullanılarak serileştirilir. Sunucu ve istemcide prototip 
çok hızlı hale getirir. Prototip serileştirme, mobil uygulamalar gibi sınırlı bant genişliği senaryolarında önemli olan 
küçük ileti yüklerine neden olur. 

gRPC, http 1. x üzerinden önemli performans avantajları sağlayan büyük bir HTTP düzeltmesi olan HTTP/2 için 
tasarlanmıştır: 

• ikili çerçevelemeye sıkıştırma. HTTP/2 Protokolü, hem gönderme hem de alma sırasında kompakt ve verimlidir. 

• Tek bir TCP bağlantısı üzerinden birden çok HTTP/2 çağrısının çoğullama. Çoğullama , satır başı 
engellemeyiortadan kaldırır. 

Kod oluşturma 

Tüm gRPC çerçeveleri, kod oluşturma için birinci sınıf destek sağlar.GRPC geliştirmeye yönelik bir çekirdek dosya, 
gRPC Hizmetleri ve iletilerinin sözleşmesini tanımlayan proto dosyasıdır. Bu dosya gRPC çerçevelerinden kod, bir 




hizmet temel sınıfı, iletiler ve tüm istemci oluşturur. 

Sunucu ile istemci arasında . proto dosyasını paylaşarak iletiler ve istemci kodu uçtan uca oluşturulabilir, istemcinin 
kod üretimi, istemci ve sunucudaki iletilerin çoğaltılmasını ortadan kaldırır ve sizin için kesin olarak belirlenmiş bir 
istemci oluşturur. İstemci yazmak gerekmez, birçok hizmet içeren uygulamalarda önemli geliştirme süresini 
kaydeder. 

Katı belirtim 

JSON ile HTTP API 'SI için biçimsel belirtim yok. Geliştiriciler, URL 'Lerin, HTTP fiillerinin ve yanıt kodlarının en iyi 
biçimini kaldırır. 

GRPC belirtimi , bir GRPC hizmetinin izlenmesi gereken biçim hakkında ayrıntılı bir şekilde yapılır.GRPC, 
platformlar ve uygulamalar arasında tutarlı olduğundan, GRPC başarılacağı 'y 1 ortadan kaldırır ve geliştirici 
süresini kaydeder. 

Akış 

HTTP/2, uzun süreli, gerçek zamanlı iletişim akışları için bir temel sağlar.gRPC, HTTP/2 üzerinden akış için birinci 
sınıf destek sağlar. 

GRPC hizmeti tüm akış kombinasyonlarını destekler: 

• Birli (akış yok) 

• Sunucudan istemciye akışa 

• istemciden sunucuya akışa 

• iki yönlü akış 

Son tarih/zaman aşımları ve iptal 

gRPC, istemcilerin bir RPC 'nin tamamlanmasını beklemek zorunda kalabilecekleri süreyi belirtmesini sağlar. Son 
tarih sunucuya gönderilir ve sunucu son tarihi aşarsa hangi eylemin yapılacağını seçebilir. Örneğin, sunucu devam 
eden gRPC/HTTP/veritabanı isteklerini zaman aşımında iptal edebilir. 

Son tarihi ve iptali alt gRPC çağrıları aracılığıyla yayın, kaynak kullanım sınırlarının uygulanmasını sağlar. 

gRPC önerilen senaryolar 

gRPC aşağıdaki senaryolara uygundur: 

• Mikro hizmetler- GRPC, düşük gecikme süresi ve yüksek işleme iletişimi için tasarlanmıştır.gRPC, verimlilik 
açısından kritik olan hafif mikro hizmetler için harika. 

• Noktadan noktaya gerçek zamanlı iletişim - GRPC, iki yönlü akış için harika desteğe sahiptir.gRPC 
Hizmetleri, yoklama yapmadan iletileri gerçek zamanlı olarak gönderebilir. 

• - GRPC araçları, tüm popüler geliştirme dillerini destekler ve GRPC 'yi çok dilli ortamlar için iyi bir seçenek 
yapar. 

• Ağ kısıtlamalı ortamlar- GRPC iletileri, hafif bir ileti biçimi olan protoarabellek ile serileştirilir.GRPC iletisi 
her zaman denk bir JSON iletisinden daha küçüktür. 

gRPC zayıflığı 

Sınırlı tarayıcı desteği 

Doğrudan bir tarayıcıda bir gRPC hizmetini doğrudan çağırmak olanaksızdır.gRPC, HTTP/2 özelliklerini çok fazla 
kullanır ve tarayıcı, bir gRPC istemcisini desteklemek için Web istekleri üzerinde gerekli denetim düzeyini sağlar. 
Örneğin, tarayıcılar arayan HTTP/2 1 nin kullanılmasına izin vermez veya temel alınan HTTP/2 çerçevelerine erişim 
sağlar. 

GRPC-Web , GRPC ekibinin tarayıcıda sınırlı GRPC desteği sağlayan ek bir teknolojidir.gRPC-Web iki bölümden 



oluşur: tüm modern tarayıcıları ve sunucudaki gRPC-Web proxy 'sini destekleyen bir JavaScript istemcisi. GRPC- 
Web istemcisi ara sunucuyu çağırır ve proxy, gRPC isteklerini gRPC sunucusuna iletir. 

GRPC 'nin özelliklerinin hepsi gRPC-Web tarafından desteklenmez, istemci ve iki yönlü akış desteklenmez ve 
sunucu akışı için sınırlı destek vardır. 

Okunabilir değil 

HTTP API istekleri metin olarak gönderilir ve insanların okuyabilmesi ve oluşturulabilmesi olabilir. 

gRPC iletileri varsayılan olarak Protodeğer ile kodlanır. Protoarabellek gönderme ve alma açısından verimli olsa da, 
ikili biçimi insanlar tarafından okunabilir değildir. Protoarabelleğe doğru bir şekilde seri durumdan çıkarmak için . 
proto dosyasında belirtilen iletinin arabirim açıklaması gereklidir. Ek araçlar, hat üzerindeki prototiplerin yüklerini 
analiz etmek ve istekleri el ile oluşturmak için gereklidir. 

Sunucu yansıtma ve GRPC komut satırı aracı gibi özellikler, ikili prototipsiz iletilerle yardım etmek için mevcuttur. 
Ayrıca, prototipli mesajlar JSON öğesine ve öğesinden dönüştürmeyidestekler. Yerleşik JSON dönüştürmesi, hata 
ayıklarken prototip iletileri okunabilir ve okunabilir biçime dönüştürmek için etkili bir yol sağlar. 

Alternatif Framevvork senaryoları 

Aşağıdaki senaryolarda gRPC üzerinden diğer çerçeveler önerilir: 

• Tarayıcı erişilebilir API ’ler- GRPC, tarayıcıda tam olarak desteklenmez. gRPC-Web tarayıcı desteği sunabilir, 
ancak sınırlamaları vardır ve sunucu proxy 'sini tanıtır. 

• Gerçek zamanlı iletişim - GRPC, akış aracılığıyla gerçek zamanlı iletişimi destekler, ancak kayıtlı bağlantılara 
bir ileti yayınlama kavramı mevcut değildir. Örneğin, sohbet odasındaki tüm istemcilere yeni sohbet iletilerinin 
gönderilmesi gereken bir sohbet odası senaryosunda her bir gRPC çağrısı, istemciye yeni sohbet iletilerini tek 
tek akışa almak için gereklidir. SignalR , bu senaryo için kullanışlı bir çerçevedir. SignalR, sürekli bağlantılar ve 
yayın iletileri için yerleşik destek kavramıdır. 

• İşlemler arası iletişim - bir işlem, gelen GRPC çağrılarını kabul etmek İÇİN bir http/2 sunucusu barındırmalıdır. 
Windows için, işlemler arası iletişim kanalları hızlı ve hafif bir iletişim yöntemidir. 

Ek kaynaklar 

• ASP.NET Core .NET Core gRPC istemcisi ve sunucusu oluşturma 

• .N ET Core'da gRPC'ye giriş 

• C# içeren gRPC hizmetleri 

• GRPC hizmetlerini C Core 'dan ASP.NET Core geçirme 




.NET Core 'da gRPC sorunlarını giderme 
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, James bAyKiNg 

Bu belgede, .NET üzerinde gRPC uygulamaları geliştirirken yaygın olarak karşılaşılan sorunlar ele alınmaktadır. 

İstemci ve hizmet SSL/TLS yapılandırması arasında uyuşmazlık 

GRPC şablonu ve örnekleri, varsayılan olarak gRPC hizmetlerini güvenli hale getirmek için Aktarım Katmanı 
Güvenliği 'ni (TLS) kullanır. gRPC istemcilerinin güvenli gRPC hizmetlerini başarıyla çağırması için güvenli bir 
bağlantı kullanması gerekir. 

ASP.NET Core gRPC hizmetinin uygulama başlatma bölümünde yazılan günlüklerde TLS kullandığını 
doğrulayabilirsiniz. Hizmet bir HTTPS uç noktasını dinleyerek: 

info: Microsoft.Hoşting.Lifetime[0] 

Now listening on: https://localhost:5001 
info: Microsoft.Hosting.Lifetime[0] 

Application started. Press Ctrl+C to shut down. 
info: Microsoft.Hosting.Lifetime[0] 

Hosting environment: Development 

.NET Core istemcisinin, güvenli bir bağlantıyla çağrı yapmak için sunucu adresinde https kullanması gerekir: 

static async Task Main(string[] args) 

{ 

// The port number(5001) must match the port of the gRPC server. 
var channel = GrpcChannel.ForAddress("https://localhost:5001"); 
var Client = new Greet.GreeterClient(channel); 

} 

Tüm gRPC istemci uygulamaları TLS 'yi destekler.diğer dillerden gRPC istemcileri genellikle Ssicredentials ile 
yapılandırılmış kanalı gerektirir. Ssicredentials , istemcinin kullanacağı sertifikayı belirtir ve güvenli olmayan 
kimlik bilgileri yerine kullanılması gerekir. Farklı gRPC istemci uygulamalarını TLS kullanmak üzere yapılandırma 
örnekleri için bkz. GRPC kimlik doğrulaması. 

Güvenilir olmayan/geçersiz sertifikayla gRPC hizmetini çağırma 

.NET gRPC istemcisi hizmetin güvenilen sertifikaya sahip olmasını gerektirir. Bir gRPC hizmeti güvenilir bir 
sertifika olmadan çağrılırken aşağıdaki hata iletisi döndürülür: 

işlenmeyen özel durum. System .net. http. HttpRequestException: SSL bağlantısı kurulamadı, iç özel duruma 
bakın. —> System. Security. Authentication. AuthenticationException: uzak sertifika, doğrulama yordamına 
göre geçersiz. 


Uygulamanızı yerel olarak test ediyorsanız ve AS P.N ET Core HTTPS geliştirme sertifikası güvenilir değilse bu 
hatayı görebilirsiniz. Bu sorunu gidermeye yönelik yönergeler için bkz. Windows ve macOS 'ta ASP.NET Core 
https geliştirme sertifikasına güvenin. 

Bir gRPC hizmetini başka bir makineye arıyorsanız ve sertifikaya güvenmiyorsanız, gRPC istemcisi geçersiz 
sertifikayı yoksayacak şekilde yapılandırılabilir. Aşağıdaki kod, güvenilir bir sertifika olmadan çağrılara izin vermek 










için HttpClientHandler. ServerCertificateCustomValidationCalIback kullanır: 


var httpClientHandler = new HttpClientHandler(); 

// Return 'true' to allow certificates that are untrusted/invalid 
httpClientHandler.ServerCertificateCustomValidationCallback = 

HttpClientHandler.DangerousAcceptAnyServerCertificateValidator; 
var httpClient = new HttpClient(httpClientHandler); 

var channel = GrpcChannel.ForAddress("https://localhost:5001", 
new GrpcChannelOptions { HttpClient = httpClient }); 
var Client = new Greet.GreeterClient(channel); 


WARNING 

Güvenilmeyen sertifikalar yalnızca uygulama geliştirme sırasında kullanılmalıdır. Üretim uygulamaları her zaman geçerli 
sertifikaları kullanmalıdır. 


.NET Core istemcisiyle güvenli olmayan gRPC hizmetlerini çağırma 

.NET Core istemcisiyle güvenli olmayan gRPC hizmetlerini çağırmak için ek yapılandırma gerekir.GRPC 
istemcisinin, System.Net.Http.socketsHttpHandier.Http2UnencryptedSupport anahtarını true olarak ayarlaması ve 
sunucu adresinde http kullanması gerekir: 

// This switch must be set before creating the GrpcChannel/HttpClient. 

AppContext.SetSwitch( 

"System.Net.Http.SocketsHttpHandler.Http2UnencryptedSupport", true); 

// The port number(5000) must match the port of the gRPC server. 
var channel = GrpcChannel.ForAddress("http://localhost:5000"); 
var Client = new Greet.GreeterClient(channel); 


MacOS 'ta ASP.NET Core gRPC uygulaması başlatılamıyor 

Kestrel, macOS ve Windows 7 gibi eski Windows sürümlerindeki TLS ile HTTP/2 1 yi desteklemez. ASP.NET Core 
gRPC şablonu ve örnekleri varsayılan olarak TLS kullanır. GRPC sunucusunu başlatmayı denediğinizde aşağıdaki 
hata iletisini görürsünüz: 

IPv4 geri döngü arabirimindeki https://localhost:5001 bağlanamıyor: eksik ALPN desteği nedeniyle, macOS 'ta 
1 HTTP/2 TLS üzerinden desteklenmez.'. 


Bu sorunu geçici olarak çözmek için Kestrel ve gRPC istemcisini TLS olmadan http/2 kullanacak şekilde 
yapılandırın. Bunu yalnızca geliştirme sırasında yapmanız gerekir.TLS 'nin kullanılması, gRPC iletilerinin 
şifrelenmeden gönderilmesine neden olur. 

Kestrel, program .csiçinde TLS olmadan bir http/2 uç noktası yapılandırmalıdır: 










public static IHostBuilder CreateHostBuilder(string[] angs) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder'.ConfigureKestrel(options => 

{ 

// Setup a HTTP/2 endpoint without TLS. 
options.ListenLocalhost(5000j o => o.Protocols = 

HttpProtocols.Http2); 

}); 

webBuilder.UseStartup<Startup>(); 

}); 

Bir HTTP/2 uç noktası TLS olmadan yapılandırıldığında, uç noktanın Listenoptions. Protocols HttpProtocols.Http 2 
olarak ayarlanmalıdır. HTTP/2 üzerinde anlaşmak için TLS gerektiğinden HttpProtocols.HttpiAndHttp 2 
kullanılamıyor. TLS olmadan, uç nokta varsayılan HTTP/1.1 ve gRPC çağrıları için tüm bağlantılar başarısız olur. 

GRPC istemcisinin, TLS kullanmak için de yapılandırılması gerekir. Daha fazla bilgi için bkz. .NET Core istemcisiyle 
güvenli olmayan gRPC hizmetlerini çağırma. 


VVARNING 

HTTP/2, TLS olmadan yalnızca uygulama geliştirme sırasında kullanılmalıdır. Üretim uygulamaları her zaman aktarım güvenliği 
kullanmalıdır. Daha fazla bilgi için bkz. gRPC 'Deki güvenlik konuları ASP.NET Core. 


gRPC C# varlıkları, proto dosyalarından oluşturulan kod değildir 

aynı somut istemci ve hizmet temel sınıflarının gRPC kod üretimi, bir projeden başvurulmak için prototip dosyaları 
ve araçları gerektirir. Şunları dahil etmeniz gerekir: 

• <Protobuf> öğesi grubunda kullanmak istediğiniz. proto dosyaları. İçeri aktarılan . proto dosyalarına proje 
tarafından başvurulmalıdır. 

• GRPC araç paketi GRPC. Tools'a paket başvurusu. 

GRPC C# varlıkları oluşturma hakkında daha fazla bilgi için bkz. C# içeren gRPC hizmetleri. 

Varsayılan olarak, bir <Protobuf> başvurusu somut istemci ve hizmet temel sınıfı oluşturur. Başvuru öğesinin 
GrpcServices özniteliği varlık oluşturmayı sınırlamak C# için kullanılabilir.Geçerli GrpcServices seçenekleri 
şunlardır: 

• Both (mevcut olmadığında varsayılan) 

• Server 

• Client 

• None 

GRPC hizmetlerini barındıran bir ASP.NET Core Web uygulaması yalnızca oluşturulan hizmet taban sınıfına ihtiyaç 
duyuyor: 

<ItemGroup> 

<Protobuf Include="Protos\greet.proto" GrpcServices="Server" /> 

</ItemGroup> 

GRPC çağrısı yapan bir gRPC istemci uygulaması yalnızca somut istemcinin oluşturulması gerekir: 












<ItemGroup> 

<Protobuf Include="Protos\gneet.pr'oto" GrpcServices="Client" /> 
</ItemGroup> 


WPF projeleri, proto dosyalarından gRPC C# varlıkları oluşturamıyor 

WPF projelerinde, gRPC kod oluşturmanın düzgün çalışmasını engelleyen bilinen bir sorun vardır. Grpc.Tools ve. 
proto dosyalarına başvurarak bir WPF projesinde oluşturulan tüm GRPC türleri, kullanıldığında derleme hataları 
oluşturur: 

hata CS0246: 1 MyGrpcServices 1 türü veya ad alanı adı bulunamadı (bir using yönergeniz veya derleme 
başvurunuz mu eksik?) 

Bu soruna geçici çözüm olarak şunları yapabilirsiniz: 

1. Yeni bir .N ET Core sınıf kitaplığı projesi oluşturun. 

2. Yeni projede, C# *. proto dosyalarından kod oluşturmayıetkinleştirmek için başvurular ekleyin: 

• GRPC. Tools paketine bir paket başvurusu ekleyin. 

• <Protobuf> öğesi grubuna *. proto dosyaları ekleyin. 

3. WPF uygulamasında yeni projeye bir başvuru ekleyin. 

WPF uygulaması, yeni sınıf kitaplığı projesinden gRPC tarafından oluşturulan türleri kullanabilir. 

gRPC Azure App Service desteklenmiyor 


VVARNING 

ASP.NET Core gRPC Azure App SERVİCE veya IIS 'de Şu anda desteklenmiyor. Http. sys ' nin HTTP/2 uygulamasına 
uygulanması, gRPC 'nin bağımlı olduğu HTTP yanıtı sondaki üst bilgileri desteklemez. Daha fazla bilgi için bu GitHub sorunu. 
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Tarafından Luke Latham 

ASP.NET Core, Razor Pages uygulamaların birim testlerini destekler. Veri erişim katmanı (DAL) ve sayfa 
modellerinin testleri şunları sağlamaya yardımcı olur: 

• Razor Pages uygulamasının parçaları, uygulama oluşturma sırasında bağımsız olarak ve bir birim olarak 
birlikte çalışır. 

• Sınıfların ve yöntemlerin sınırlı sorumluluk kapsamları vardır. 

• Uygulamanın nasıl davranması ile ilgili ek belgeler vardır. 

• Kod güncelleştirmeleri tarafından ilgili hatalar olan gerileme, otomatik derleme ve dağıtım sırasında bulunur. 

Bu konu, Razor Pages uygulamalar ve birim testleri hakkında temel bir anladığınızı varsayar. Razor Pages 
uygulamalar veya test kavramları hakkında bilgi sahibi değilseniz aşağıdaki konulara bakın: 

• ASP.NET Core Razor Pages giriş 

• Öğretici: ASP.NET Core Razor Pages ile çalışmaya başlama 

• DotNet test C# ve xUnit kullanarak .NET Core 'da birim testi 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Örnek proje iki uygulamalardan oluşur: 


UYGULAMA 

PROJE KLASÖRÜ 

AÇIKLAMA 

İleti uygulaması 

src/RozorPoges TestSample 

Kullanıcının ileti eklemesine, bir ileti 
silmesine, tüm iletileri silmesine ve 
iletileri çözümlemesine (ileti başına 
ortalama sözcük sayısını bulur) izin 
verir. 


Test uygulaması testier/RazorPagesTestSample. testler ileti uygulamasının DAL ve Dizin sayfa 

modelini test etmek için kullanılır. 


Testler, Visual Studio veya Mac İÇİN VISUAL STUDIOgibi bir IDE ’nin yerleşik test özellikleri kullanılarak 
çalıştırılabilir. Visual Studio Code veya komut satırı kullanıyorsanız, testier/RazorPagesTestSample. Tests 
klasöründeki bir komut isteminde aşağıdaki komutu yürütün: 

dotnet test 


İleti uygulama organizasyonu 

ileti uygulaması, aşağıdaki özelliklere sahip bir Razor Pages ileti sistemidir: 

• Uygulamanın ( Pages/lndex. cshtml ve Pages/index. cshtml. cs) dizin sayfası, iletilerin eklenmesi, silinmesini ve 
ANALİZİNİ denetlemek için bir Ul ve sayfa modeli yöntemleri sağlar (ileti başına ortalama sözcük sayısını 
bulur). 

• Bir ileti, Message sınıfı {Data/Message. cs) ile iki özelliği id olan (anahtar) ve Text (ileti) açıklanmaktadır. 
Text Özelliği gereklidir ve 200 karakterle sınırlıdır. 










• iletiler, Entity Framevvork bellek içi veritabanı+kullanılarak depolanır. 

• Uygulama, AppDbContext veritabanı bağlamı sınıfında ( Data/appdbcontext. cs) bir dal içerir. DAL Yöntemleri 
işaretlenir Virtual ve bu yöntemler, testlerde kullanım için izin verir. 

• Veritabanı uygulama başlangıcında boşsa, ileti deposu üç iletiyle başlatılır. Bu sağlanan iletiler , testlerde de 
kullanılır. 

tlnMemory İle testolan EF konusu, MSTest ile testler için bellek içi bir veritabanının nasıl kullanılacağını açıklar. Bu 
konu xUnit test çerçevesini kullanır. Farklı test çerçeveleri genelinde test kavramları ve test uygulamaları benzerdir 
ancak aynı değildir. 

Örnek uygulama depo desenini kullanmaz ve İş birimi (UoW) düzenininetkin bir örneği olmasa da Razor Pages 
bu geliştirme düzenlerini destekler. Daha fazla bilgi için bkz. altyapı Kalıcılık katmanını tasarlama ve ASP.NET 
Core 'de test denetleyicisi mantığı (örnek depo modelini uygular). 

Test uygulaması kuruluşu 

Test uygulaması, testler/RazorPagesTestSample. Tests klasörünün içindeki bir konsol uygulamasıdır. 

TEST UYGULAMASI KLASÖRÜ AÇIKLAMA 

UnitTests • DataAccessLayerTest.es , dal için birim testlerini içerir. 

• lndexPageTests.cs , Dizin sayfası modelinin birim 
testlerini içerir. 


Programların Her bir dal birim testi için yeni veritabanı bağlamı seçenekleri 

oluşturmak için kullanılan 

yöntemiiçerir,böyleceveritabanıhertestiçinkenditemelkoşuluna 
sıfırlanır. TestDbContextOptions 


Test çerçevesi xUnit' dir. Nesne sahte işlem çerçevesi moqolur. 

Veri erişim katmanının birim testleri (DAL) 

ileti uygulamasında AppDbContext , sınıfında dört yöntem bulunan bir dal vardır 

(. src/RazorPagesTestSample/Data/appdbcontext. cs). Her yöntemin test uygulamasında bir veya iki birim testi 
vardır. 

DAL YÖNTEMİ İŞLEV 

GetMessagesAsync Özelliği tarafından sıralanan veritabanından bir 

List<Message> alır. Text 


AddMessageAsync 


Veritabanına bir Message ekler. 


DeleteAllMessagesAsync 


Tüm Message girdileri veritabanından siler. 


DeleteMessageAsync 


Veritabanından tek tek Message siler, id 


DAL birim testleri her bir test DbContextOptions için yeni AppDbContext bir oluşturma için gereklidir. Her test için 
öğesini oluşturmaya DbContextoptions yönelik bir yaklaşım, şunu DbContextOptionsBuilderkullanmaktır: 















var optionsBuilder = new DbContextOptionsBuilder<AppDbContext>() 
.UseInMemoryDatabase("InMemoryDb"); 

using (var db = new AppDbContext(optionsBuilder.Options)) 

{ 

// Use the db here in the unit test. 

} 


Bu yaklaşımla ilgili sorun, her testin, önceki testin bulunduğu herhangi bir durumda veritabanını aldığından emin 
olur. Bu, birbirleriyle karışmaz atomik birim testleri yazmaya çalışırken sorunlu olabilir. Her test için AppDbContext 
yeni bir veritabanı bağlamı kullanmaya zorlamak için, yeni bir hizmet sağlayıcısına DbContextoptions dayalı bir 
örnek sağlayın. Test uygulaması, Utilities sınıfının sınıf yöntemi TestDbContextoptions kullanılarak nasıl 
yapılacağını gösterir (testler /RazorPagesTestSample. testler/UtUities/UtiUties. cs): 

public static DbContextOptions<AppDbContext> TestDbContextOptions() 

{ 

// Create a new service provider to create a new in-memory database. 
var serviceProvider = new ServiceCollection() 

.AddEntityFrameworkInMemoryDatabase() 

.BuildServiceProvider(); 

// Create a new options instance using an in-memory database and 
// IServiceProvider that the context should resolve ali of its 
// Services from. 

var builder = new DbContextOptionsBuilder<AppDbContext>() 

.UseInMemoryDatabase("InMemoryDb") 

.UseInternalServiceProvider(serviceProvider); 

return builder.Options; 

} 

DAL birim DbContextoptions testlerinde kullanılması, her testin yeni bir veritabanı örneğiyle otomatik olarak 
çalıştırılmasına izin verir: 

using (var db = new AppDbContext(Utilities.TestDbContextOptions())) 

{ 

// Use the db here in the unit test. 

} 

DataAccessLayerTest Sınıftaki her bir test yöntemi ( urıittests/DataAccessLayerTest. cs) benzer bir düzenleme-işlem 
onaylama düzeni izler: 

1. ' Veritabanı test için yapılandırıldı ve/veya beklenen sonuç tanımlandı. 

2. Çalışanlarının Test yürütülür. 

3. Vermediğini Test sonuçlarının başarılı olup olmadığını belirleme onayları yapılır. 

Örneğin, DeleteMessageAsync yöntemi id (src/RazorPagesTestSample/Data/appdbcontext. cs) tarafından 
tanımlanan tek bir iletinin kaldırılmasından sorumludur: 











public async Virtual Task DeleteMessageAsync(int id) 

{ 

var message = await Messages.FindAsync(id); 

if (message != null) 

{ 

Messages.Remove(message); 
await SaveChangesAsync(); 

} 


Bu yöntem için iki test vardır. Bir test, bir ileti veritabanında olduğunda yöntemin bir iletiyi sildiğini denetler. Diğer 
yöntem, silme iletisi id yoksa veritabanının değişmediğini sınar. 

DeleteMessageAsync_MessageIsDeleted_WhenMessageIsFound Yöntemi aşağıda gösterilmiştir 

[Fact] 

public async Task DeleteMessageAsync_MessageIsDeleted_WhenMessageIsFound() 

{ 

using (var db = new AppDbContext(Utilities.TestDbContextOptions())) 

{ 

// Arrange 

var seedMessages = AppDbContext.GetSeedingMessages(); 

await db.AddRangeAsync(seedMessages); 

await db.SaveChangesAsync(); 

var recld = 1; 

var expectedMessages = 

seedMessages.Where(message => message.Id != recld) .Tol_ist(); 

// Act 

await db.DeleteMessageAsync(recld); 

// Assert 

var actualMessages = await db.Messages.AsNoTrackingO .ToListAsync(); 

Assert.Equal( 

expectedMessages.OrderBy(m => m.Id).Select(m => m.Text)j 
actualMessages.OrderBy(m => m.Id).Select(m => m.Text)); 

} 

} 

ilk olarak, yöntemi, hareket adımının hazırlanması gereken düzenleme adımını gerçekleştirir. Dengeli dağıtım 
iletileri 1 de seedMessages alınır ve tutulur. Dengeli dağıtım iletileri veritabanına kaydedilir, id içereni ileti 
silinmek üzere ayarlanmış. Yöntemi yürütüldüğünde, beklenen iletilerde, id ' ın ı dışında bir ileti olmalıdır. 
DeleteMessageAsync Değişken expectedMessages , beklenen bu sonucu temsil eder. 

// Arrange 

var seedMessages = AppDbContext.GetSeedingMessages(); 

await db.AddRangeAsync(seedMessages); 

await db.SaveChangesAsync(); 

var recld = 1; 

var expectedMessages = 

seedMessages.Where(message => message.Id != recld) .Tol_ist(); 

Yöntemi şu şekilde davranır: DeleteMessageAsync Yöntemi , recld ' ın içinde geçirme yürütülür: ı 

// Act 

await db.DeleteMessageAsync(recld); 


Son olarak, yöntemi bağlamını edinir Messages ve iki eşit olan expectedMessages asserile karşılaştırır: 















// Assert 

var actualMessages = await db.Messages.AsNoTracking().ToListAsync(); 

Assert. Equal( 

expectedMessages.OrderBy(m => m.Id).Select(m => m.Text), 
actualMessages.OrderBy(m => m.Id).Select(m => m.Text)); 

iki ikisinin List<Message> de aynı olduğunu karşılaştırmak için: 

• iletiler tarafından id sıralanır. 

• ileti çiftleri Text özelliği ile karşılaştırılır. 

Benzer bir test yöntemi, DeleteMessageAsync_NoMessageIsDeleted_WhenMessageIsNotFound mevcut olmayan bir iletiyi 
silmeye çalışılması sonucunu denetler. Bu durumda, veritabanındaki beklenen iletiler, DeleteMessageAsync Yöntem 
yürütüldükten sonra gerçek iletilere eşit olmalıdır. Veritabanının içeriğinde değişiklik olmamalıdır: 

[Fact] 

public async Task DeleteMessageAsync_NoMessageIsDeleted_WhenMessageIsNotFound() 

{ 

using (var db = new AppDbContext(Utilitles.TestDbContextOptlons())) 

{ 

// Arrange 

var expectedMessages = AppDbContext.GetSeedingMessages(); 
await db.AddRangeAsync(expectedMessages); 
await db.SaveChangesAsync(); 
var recld = 4; 

// Act 
try 
{ 

await db.DeleteMessageAsync(recld); 

} 

catch 

{ 

// recld doesn't exist 

} 

// Assert 

var actualMessages = await db.Messages.AsNoTracking().ToListAsync(); 

Assert.Equal( 

expectedMessages.OrderBy(m => m.Id).Select(m => m.Text), 
actualMessages.OrderBy(m => m.Id).Select(m => m.Text)); 

} 

} 


Sayfa modeli yöntemlerinin birim testleri 

Başka bir birim testi kümesi, sayfa modeli yöntemlerinin sınamalarından sorumludur.ileti uygulamasında Dizin 
sayfası modelleri indexModei src/RazorPagesTestSample/Pages/lndex. cshtml. csiçindeki sınıfta bulunur. 

SAYFA MODELİ YÖNTEMİ İŞLEV 


OnGetAsync 


GetMessagesAsync Yöntemini kullanarak, Kullanıcı arabirimi 
için dal öğesinden gelen iletileri alır. 


OnPostAddMessageAsync 


ModelState geçerliyse, veritabanına bir ileti eklemek 
AddMessageAsync için çağırır. 













SAYFA MODELİ YÖNTEMİ 


İŞLEV 


OnPostDeleteAllMessagesAsync Veritabanindaki DeleteAllMessagesAsync tüm iletileri 

silmek için çağırır. 

OnPostDeleteMessageAsync Id Belirtilen DeleteMessageAsync bir iletiyi silmek için 

yürütülür. 

onPostAnalyzeMessagesAsync Veritabanında bir veya daha fazla ileti varsa, ileti başına 

ortalama sözcük sayısını hesaplar. 

Sayfa modeli yöntemleri, indexPageTests sınıfında yedi test kullanılarak test edilir 

( testler/RazorPagesTestSample. testler/urıittests/mdexpagetests. cs). Testler tanıdık düzenleme-onaylama-lşlem 
düzeni kullanır. Bu sınamalar üzerinde odaklanılmıştır: 

• ModelState geçersiz olduğunda yöntemlerin doğru davranışı izleyip izlemediğini belirleme. 

• Yöntemlerin doğru lActionResuitbir şekilde ürettiği doğrulanıyor. 

• Özellik değeri atamalarının doğru şekilde yapıldığından emin olup olmadığı denetleniyor. 

Bu test grubu genellikle, bir sayfa modeli yönteminin yürütüldüğü İşlem adımı için beklenen verileri oluşturmak 
üzere DAL yöntemlerini oluşturuyor. Örneğin, GetMessagesAsync AppDbContext öğesinin yöntemi çıkış oluşturmak 
için kullanılır. Bir sayfa modeli yöntemi bu yöntemi yürüttüğünde, sahte sonuç döndürür. Veriler veritabanından 
gelmiyor. Bu, sayfa modeli testlerinde DAL kullanımı için öngörülebilir, güvenilir bir test koşulları oluşturur. 

Test, GetMessagesAsync yöntemin sayfa modeli için nasıl kullanılacağını gösterir: 
OnGetAsync_PopulatesThePageModel_WithAListOfMessages 

var mockAppDbContext = new Mock<AppDbContext>(optionsBuilder.Options ); 
var expectedMessages = AppDbContext.GetSeedingMessages(); 
mockAppDbContext.Setup( 

db => db.GetMessagesAsync()).Returns(Task.FromResult(expectedMessages)); 
var pageModel = new IndexModel(mockAppDbContext.Object); 

Yöntem, işlem adımında yürütüldüğünde, sayfa GetMessagesAsync modelinin yöntemini çağırır. onGetAsync 
Birim testi İşlem adımı ( testler/RazorPagesTestSample. testler/UnitTests/ındexpagetests. cs): 

// Act 

await pageModel.OnGetAsync(); 

indexPage sayfa modelinin OnGetAsync yöntemi ( src/RazorPagesTestSample/Pages/lndex. cshtml. cs): 

public async Task OnGetAsync() 

{ 

Messages = await _db.GetMessagesAsync(); 

} 

DAL GetMessagesAsync içindeki yöntemi bu yöntem çağrısının sonucunu döndürmez. Metodun moclenmiş 
sürümü sonucu döndürür. 

Adımda, gerçek iletiler ( actualMessages Messages ) sayfa modelinin özelliğinden atanır. Assert iletiler 
atandığında bir tür denetimi de gerçekleştirilir. Beklenen ve gerçek iletiler Text özellikleriyle karşılaştırılır. Test, iki 
List<Message> örneğinin aynı iletileri içerdiğini onaylar. 






















// Assert 

var actualMessages = Assert.IsAssignableFrom<List<Message>>(pageModel.Messages); 

Assert.Equal( 

expectedMessages.OrderBy(m => m.Id).Select(m => m.Text), 
actualMessages.OrderBy(m => m.Id).Select(m => m.Text)); 

Bu gruptaki diğer testler,,, ve 1 ı DefaultHttpContextkurmak PageContext ModelStateDictionary ActionContext 
PageContext viewDataDictionary için,, bir içeren sayfa modeli nesneleri oluşturur. Bunlar, testleri yürütmek için 
faydalıdır. Örneğin, Modeistate ileti uygulaması yürütüldüğünde geçerli AddModelError PageResult bir 
döndürülüp döndürüldüğünden emin olmak için bir hata oluşturur: onPostAddMessageAsync 

[Fact] 

public async Task OnPostAddMessageAsync_ReturnsAPageResult_WhenModelStateIsInvalid() 

{ 

// Arrange 

var optionsBuilder = new DbContextOptionsBuilder<AppDbContext>() 

.UseInMemoryDatabase("InMemoryDb"); 

var mockAppDbContext = new Mock<AppDbContext>(optlonsBuilder.Options); 
var expectedMessages = AppDbContext.GetSeedingMessages(); 

mockAppDbContext.Setup(db => db.GetMessagesAsync()).Returns(Task.FromResult(expectedMessages)); 
var httpContext = new DefaultHttpContext(); 
var modeistate = new ModelStateDictionaryO; 

var actionContext = new ActionContext(httpContext , new RouteData(), new PageActionDescriptor(), 
modeistate); 

var modelMetadataProvider = new EmptyModelMetadataProvider(); 

var viewData = new ViewDataDictionary(modelMetadataProvider., modeistate); 

var tempData = new TempDataDictionary(httpContext , Mock.Of<ITempDataProvider>()); 

var pageContext = new PageContext(actlonContext) 

{ 

ViewData = viewData 

}; 

var pageModel = new IndexModel(mockAppDbContext.Object) 

{ 

PageContext = pageContext, 

TempData = tempData, 

Url = new UrlHelper(actionContext) 

}; 

pageModel.Modeistate.AddModelError("Message.Text"j "The Text field is required."); 

// Act 

var result = await pageModel.OnPostAddMessageAsync(); 

// Assert 

Assert.IsType<PageResult>(result); 


Ek kaynaklar 

• DotNet test C# ve xllnit kullanarak .NET Core 'da birim testi 

• AS P.N ET Core 'de test denetleyicisi mantığı 

• Kodunuzun birim testi (Visual Studio) 

• ASP.NET Core tümleştirme testleri 

• xllnit.net 

• Mac için Visual Studio kullanarak macOS'ta eksiksiz bir ,N ET Core çözümü derleme 

• XUnit.net kullanmaya başlama: .NET SDK komut satırı ile .NET Core kullanma 

• Moq dili 

• Moq hızlı başlangıç 










ASP.NET Core, Razor Pages uygulamaların birim testlerini destekler. Veri erişim katmanı (DAL) ve sayfa 
modellerinin testleri şunları sağlamaya yardımcı olur: 

• Razor Pages uygulamasının parçaları, uygulama oluşturma sırasında bağımsız olarak ve bir birim olarak 
birlikte çalışır. 

• Sınıfların ve yöntemlerin sınırlı sorumluluk kapsamları vardır. 

• Uygulamanın nasıl davranması ile ilgili ek belgeler vardır. 

• Kod güncelleştirmeleri tarafından ilgili hatalar olan gerileme, otomatik derleme ve dağıtım sırasında bulunur. 

Bu konu, Razor Pages uygulamalar ve birim testleri hakkında temel bir anladığınızı varsayar. Razor Pages 
uygulamalar veya test kavramları hakkında bilgi sahibi değilseniz aşağıdaki konulara bakın: 

• ASP.NET Core Razor Pages giriş 

• Öğretici: ASP.NET Core Razor Pages ile çalışmaya başlama 

• DotNet test C# ve xUnit kullanarak .NET Core 'da birim testi 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Örnek proje iki uygulamalardan oluşur: 


UYGULAMA 

PROJE KLASÖRÜ 

AÇIKLAMA 

İleti uygulaması 

src/RazorPages TestSample 

Kullanıcının ileti eklemesine, bir ileti 
silmesine, tüm iletileri silmesine ve 
iletileri çözümlemesine (ileti başına 
ortalama sözcük sayısını bulur) izin 
verir. 


Test uygulaması testler/RazorPagesTestSample. testler ileti uygulamasının DAL ve Dizin sayfa 

modelini test etmek için kullanılır. 


Testler, Visual Studio veya Mac İÇİN VISUAL STUDIOgibi bir IDE 'nin yerleşik test özellikleri kullanılarak 
çalıştırılabilir. Visual Studio Code veya komut satırı kullanıyorsanız, testler/RazorPagesTestSample. Tests 
klasöründeki bir komut isteminde aşağıdaki komutu yürütün: 

dotnet test 


İleti uygulama organizasyonu 

ileti uygulaması, aşağıdaki özelliklere sahip bir Razor Pages ileti sistemidir: 

• Uygulamanın ( Pages/tndex. cshtml ve Pages/irıdex. cshtml. cs) dizin sayfası, iletilerin eklenmesi, silinmesini ve 
ANALİZİNİ denetlemek için bir Ul ve sayfa modeli yöntemleri sağlar (ileti başına ortalama sözcük sayısını 
bulur). 

• Bir ileti, Message sınıfı [Data/Message. cs) ile iki özelliği id olan (anahtar) ve Text (ileti) açıklanmaktadır. 

Text Özelliği gereklidir ve 200 karakterle sınırlıdır. 

• iletiler, Entity Framevvork bellek içi veritabanı+kullanılarak depolanır. 

• Uygulama, AppDbContext veritabanı bağlamı sınıfında ( Data/appdbcontext. cs) bir dal içerir. DAL Yöntemleri 
işaretlenir Virtual ve bu yöntemler, testlerde kullanım için izin verir. 

• Veritabanı uygulama başlangıcında boşsa, ileti deposu üç iletiyle başlatılır. Bu sağlanan iletiler , testlerde de 
kullanılır. 

tlnMemory İle testolan EF konusu, MSTest ile testler için bellek içi bir veritabanının nasıl kullanılacağını açıklar. Bu 

konu xUnit test çerçevesini kullanır. Farklı test çerçeveleri genelinde test kavramları ve test uygulamaları benzerdir 









ancak aynı değildir. 


Örnek uygulama depo desenini kullanmaz ve İş birimi (UoW) düzenininetkin bir örneği olmasa da Razor Pages 
bu geliştirme düzenlerini destekler. Daha fazla bilgi için bkz. altyapı Kalıcılık katmanını tasarlama ve ASP.NET 
Core 'de test denetleyicisi mantığı (örnek depo modelini uygular). 

Test uygulaması kuruluşu 

Test uygulaması, testler/RazorPagesTestSample. Tests klasörünün içindeki bir konsol uygulamasıdır. 

TEST UYGULAMASI KLASÖRÜ AÇIKLAMA 

UrıitTests • DataAccessLayerTest.es , dal için birim testlerini içerir. 

• lndexPageTests.cs , Dizin sayfası modelinin birim 
testlerini içerir. 


Programların Her bir dal birim testi için yeni veritabanı bağlamı seçenekleri 

oluşturmak için kullanılan 

yöntemiiçerir,böyleceveritabanıhertestiçinkenditemelkoşuluna 
sıfırlanır. TestDbContextOptions 


Test çerçevesi xllnit' dir. Nesne sahte işlem çerçevesi moqolur. 

Veri erişim katmanının birim testleri (DAL) 

ileti uygulamasında AppDbContext , sınıfında dört yöntem bulunan bir dal vardır 

(. src/RazorPagesTestSample/Data/appdbcontext. cs). Her yöntemin test uygulamasında bir veya iki birim testi 
vardır. 

DAL YÖNTEMİ İŞLEV 

GetMessagesAsync Özelliği tarafından sıralanan veritabanından bir 

List<Message> alır. Text 


AddMessageAsync 


Veritabanına bir Message ekler. 


DeleteAllMessagesAsync Tüm Message girdileri veritabanından siler. 

DeleteMessageAsync Veritabanından tek tek Message siler. Id 

DAL birim testleri her bir test DbContextOptions için yeni AppDbContext bir oluşturma için gereklidir. Her test için 
öğesini oluşturmaya DbContextoptions yönelik bir yaklaşım, şunu DbContextOptionsBuilderkullanmaktır: 

var optionsBuilder = new DbContextOptionsBuilder<AppDbContext>() 

.UseInMemoryDatabase("InMemoryDb"); 

using (var db = new AppDbContext(optionsBuilder.Options)) 

{ 

// Use the db here in the unit test. 

} 

Bu yaklaşımla ilgili sorun, her testin, önceki testin bulunduğu herhangi bir durumda veritabanını aldığından emin 
olur. Bu, birbirleriyle karışmaz atomik birim testleri yazmaya çalışırken sorunlu olabilir. Her test için AppDbContext 
yeni bir veritabanı bağlamı kullanmaya zorlamak için, yeni bir hizmet sağlayıcısına DbContextciptions dayalı bir 
















örnek sağlayın. Test uygulaması, Utilities sınıfının sınıf yöntemi TestDbContextoptions kullanılarak nasıl 
yapılacağını gösterir ( test\er/RazorPagesTestSample. testler/Utilities/Utilities. cs): 

public static DbContextOptions<AppDbContext> TestDbContextOptions() 

{ 

// Create a new service provider to create a new in-memory database. 
var serviceProvider = new ServiceCollection() 

. AddEntityFramevjorklnMemoryDatabaseO 
.BuildServiceProvider(); 

// Create a new options instance using an in-memory database and 
// IServiceProvider that the context should resolve ali of its 
// Services from. 

var builder = new DbContextOptionsBuilder<AppDbContext>() 

.UseInMemoryDatabase("InMemoryDb") 

.UseInternalServiceProvider(serviceProvider); 

return builder.Options; 

} 

DAL birim DbContextoptions testlerinde kullanılması, her testin yeni bir veritabanı örneğiyle otomatik olarak 
çalıştırılmasına izin verir: 

using (var db = new AppDbContext(Utilities.TestDbContextOptions())) 

{ 

// Use the db here in the unit test. 

} 

DataAccessLayerTest Sınıftaki her bir test yöntemi ( unittests/DataAccessLayerTest. cs) benzer bir düzenleme-işlem 
onaylama düzeni izler: 

1. ' Veritabanı test için yapılandırıldı ve/veya beklenen sonuç tanımlandı. 

2. Çalışanlarının Test yürütülür. 

3. Vermediğini Test sonuçlarının başarılı olup olmadığını belirleme onayları yapılır. 

Örneğin, DeleteMessageAsync yöntemi id (src/RazorPagesTestSample/Data/appdbcontext. cs) tarafından 
tanımlanan tek bir iletinin kaldırılmasından sorumludur: 


public async Virtual Task DeleteMessageAsync(int id) 

{ 

var message = await Messages.FindAsync(id); 

if (message != null) 

{ 

Messages.Remove(message); 
await SaveChangesAsync(); 

} 

} 

Bu yöntem için iki test vardır. Bir test, bir ileti veritabanında olduğunda yöntemin bir iletiyi sildiğini denetler. Diğer 
yöntem, silme iletisi id yoksa veritabanının değişmediğini sınar. 

DeleteMessageAsync_MessageIsDeleted_WhenMessageIsFound Yöntemi aşağıda gösterilmiştir: 













[Fact] 

public async Task DeleteMessageAsync_MessageIsDeleted_WhenMessageIsFound() 

{ 

using (var db = new AppDbContext(Utilities.TestDbContextOptions())) 

{ 

// Arrange 

var seedMessages = AppDbContext.GetSeedingMessages(); 

await db.AddRangeAsync(seedMessages); 

await db.SaveChangesAsync(); 

var recld = 1; 

var expectedMessages = 

seedMessages.Where(message => message.Id != recld).ToList()j 
// Act 

await db.DeleteMessageAsync(recld); 

// Assert 

var actualMessages = await db.Messages.AsNoTrackingO .ToListAsync(); 

Assert.Equal( 

expectedMessages.OrderBy(m => m.Id).Select(m => m.Text), 
actualMessages.OrderBy(m => m.Id).Select(m => m.Text)); 

} 

} 

ilk olarak, yöntemi, hareket adımının hazırlanması gereken düzenleme adımını gerçekleştirir. Dengeli dağıtım 
iletileri 1 de seedMessages alınır ve tutulur. Dengeli dağıtım iletileri veritabanına kaydedilir, id İçereni ileti 
silinmek üzere ayarlanmış. Yöntemi yürütüldüğünde, beklenen iletilerde, id ' ın ı dışında bir ileti olmalıdır. 
DeleteMessageAsync Değişken expectedMessages , beklenen bu sonucu temsil eder. 

// Arrange 

var seedMessages = AppDbContext.GetSeedingMessages(); 

await db.AddRangeAsync(seedMessages); 

await db.SaveChangesAsync(); 

var recld = 1 ; 

var expectedMessages = 

seedMessages.Where(message => message.Id != recld).ToList(); 

Yöntemi şu şekilde davranır: DeleteMessageAsync Yöntemi , recld 1 ın içinde geçirme yürütülür: ı 

// Act 

await db.DeleteMessageAsync(recld); 

Son olarak, yöntemi bağlamını edinir Messages ve iki eşit olan expectedMessages asserile karşılaştırır: 

// Assert 

var actualMessages = await db.Messages.AsNoTracking().ToListAsync(); 

Assert.Equal( 

expectedMessages.OrderBy(m => m.Id).Select(m => m.Text)j 
actualMessages.OrderBy(m => m.Id).Select(m => m.Text)); 

iki ikisinin List<Message> de aynı olduğunu karşılaştırmak için: 

• iletiler tarafından id sıralanır. 

• ileti çiftleri Text özelliği ile karşılaştırılır. 

Benzer bir test yöntemi, DeleteMessageAsync_NoMessageIsDeleted_WhenMessageIsl\lotFound mevcut olmayan bir iletiyi 
silmeye çalışılması sonucunu denetler. Bu durumda, veritabanındaki beklenen iletiler, DeleteMessageAsync Yöntem 
yürütüldükten sonra gerçek iletilere eşit olmalıdır. Veritabanının içeriğinde değişiklik olmamalıdır: 



















[Fact] 

public async Task DeleteMessageAsyncJtoMessagelsDeletedjAİhenMessagelsNotFoundO 

{ 

using (var db = new AppDbContext(Utilities.TestDbContextOptions())) 

{ 

// Arrange 

var expectedMessages = AppDbContext.GetSeedingMessages(); 
await db.AddRangeAsync(expectedMessages); 
await db.SaveChangesAsync(); 
var recld = 4; 

// Act 

await db.DeleteMessageAsync(recld); 

// Assert 

var actualMessages = await db.Messages.AsNoTrackingO.ToListAsync(); 
Assert.Equal( 

expectedMessages.OrderBy(m => m.Id).Select(m => m.Text)j 
actualMessages.OrderBy(m => m.Id).Select(m => m.Text)); 

} 

} 


Sayfa modeli yöntemlerinin birim testleri 

Başka bir birim testi kümesi, sayfa modeli yöntemlerinin sınamalarından sorumludur.ileti uygulamasında Dizin 
sayfası modelleri indexModei src/RazorPagesTestSample/Pages/lrıdex. cshtml. csiçindeki sınıfta bulunur. 

SAYFA MODELİ YÖNTEMİ İŞLEV 


onGetAsync GetMessagesAsync Yöntemini kullanarak, Kullanıcı arabirimi 

için dal öğesinden gelen iletileri alır. 

onPostAddMessageAsync ModelState geçerliyse, veritabanına bir ileti eklemek 

AddMessageAsync için çağırır. 


OnPostDeleteAllMessagesAsync Veritabanindaki DeleteAllMessagesAsync tüm iletileri 

silmek için çağırır. 

OnPostDeleteMessageAsync Id Belirtilen DeleteMessageAsync bir iletiyi silmek için 

yürütülür. 


onPostAnalyzeMessagesAsync Veritabanında bir veya daha fazla ileti varsa, ileti başına 

ortalama sözcük sayısını hesaplar. 

Sayfa modeli yöntemleri, indexPageTests sınıfında yedi test kullanılarak test edilir 

(; testler/RazorPagesTestSample. testler/unittests/mdexpagetests. cs). Testler tanıdık düzenleme-onaylama-lşlem 
düzeni kullanır. Bu sınamalar üzerinde odaklanılmıştır: 

• ModelState geçersiz olduğunda yöntemlerin doğru davranışı izleyip izlemediğini belirleme. 

• Yöntemlerin doğru lActionResultbir şekilde ürettiği doğrulanıyor. 

• Özellik değeri atamalarının doğru şekilde yapıldığından emin olup olmadığı denetleniyor. 

Bu test grubu genellikle, bir sayfa modeli yönteminin yürütüldüğü İşlem adımı için beklenen verileri oluşturmak 
üzere DAL yöntemlerini oluşturuyor. Örneğin, GetMessagesAsync AppDbContext öğesinin yöntemi çıkış oluşturmak 
için kullanılır. Bir sayfa modeli yöntemi bu yöntemi yürüttüğünde, sahte sonuç döndürür. Veriler veritabanından 
gelmiyor. Bu, sayfa modeli testlerinde DAL kullanımı için öngörülebilir, güvenilir bir test koşulları oluşturur. 


















Test, GetMessagesAsync yöntemin sayfa modeli için nasıl kullanılacağını gösterir: 
OnGetAsync_PopulatesThePageModel_WithAListOfMessages 

var mockAppDbContext = new Mock<AppDbContext>(optionsBuilder.Options); 
var expectedMessages = AppDbContext.GetSeedingMessages(); 
mockAppDbContext.Setup( 

db => db.GetMessagesAsync()).Returns(Task.FromResult(expectedMessages)); 
var pageModel = new IndexModel(mockAppDbContext.Object); 

Yöntem, işlem adımında yürütüldüğünde, sayfa GetMessagesAsync modelinin yöntemini çağırır. onGetAsync 
Birim testi İşlem adımı ( testler/RazorPagesTestSample. testler/UnıtTests/ındexpagetests. cs): 

// Act 

await pageModel.OnGetAsync(); 

indexPage sayfa modelinin OnGetAsync yöntemi ( src/RazorPagesTestSample/Pages/lndex. cshtml. cs): 

public async Task OnGetAsync() 

{ 

Messages = await _db.GetMessagesAsync(); 

} 

DAL GetMessagesAsync içindeki yöntemi bu yöntem çağrısının sonucunu döndürmez. Metodun moclenmiş 
sürümü sonucu döndürür. 

Adımda, gerçek iletiler ( actualMessages Messages ) sayfa modelinin özelliğinden atanır. Assert iletiler 
atandığında bir tür denetimi de gerçekleştirilir. Beklenen ve gerçek iletiler Text özellikleriyle karşılaştırılır. Test, iki 
List<Message> örneğinin aynı iletileri içerdiğini onaylar. 

// Assert 

var actualMessages = Assert.IsAssignableFrom<List<Message>>(pageModel.Messages); 

Assert.Equal( 

expectedMessages.OrderBy(m => m.Id).Select(m => m.Text), 
actualMessages.OrderBy(m => m.Id).Select(m => m.Text)); 

Bu gruptaki diğer testler,,, ve 1 ı DefaultHttpContextkurmak PageContext ModelStateDictionary ActionContext 
PageContext viewDataDictionary için,, bir içeren sayfa modeli nesneleri oluşturur. Bunlar, testleri yürütmek için 
faydalıdır. Örneğin, Modeistate ileti uygulaması yürütüldüğünde geçerli AddModelError PageResult bir 
döndürülüp döndürüldüğünden emin olmak için bir hata oluşturur: onPostAddMessageAsync 
















[Fact] 

public async Task OnPostAddMessageAsync_ReturnsAPageResult_WhenModelStateIsInvalid() 

{ 

// Arrange 

var optionsBuilder = new DbContextOptionsBuilder<AppDbContext>() 
.UseInMemoryDatabase("InMemoryDb"); 

var mockAppDbContext = new Mock<AppDbContext>(optionsBuilder.Options); 
var expectedMessages = AppDbContext.GetSeedingMessages(); 

mockAppDbContext.Setup(db => db.GetMessagesAsync()).Returns(Task.FromResult(expectedMessages)) 
var httpContext = new DefaultHttpContext(); 
var modelState = new ModelStateDictionaryO; 

var actionContext = new ActionContext(httpContext , new RouteData(), new PageActionDescriptor() 
modelState); 

var modelMetadataProvider = new EmptyModelMetadataProvider(); 

var viewData = new ViewDataDictionary(modelMetadataProvider, modelState); 

var tempData = new TempDataDictionary(httpContext, Mock.Of<ITempDataProvider>()); 

var pageContext = new PageContext(actlonContext) 

{ 

ViewData = viewData 

}; 

var pageModel = new IndexModel(mockAppDbContext.Object) 

{ 

PageContext = pageContext, 

TempData = tempData^ 

Url = new UrlHelper(actionContext) 

}; 

pageModel.ModelState.AddModelError("Message.Text"j "The Text field is required."); 

// Act 

var result = await pageModel.OnPostAddMessageAsync(); 

// Assert 

As sert.IsType<PageResult>(result); 

} 


Ek kaynaklar 
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3.12.2019 • 34 minutes to read z. Edit Online 


Steve Smith tarafından 

Birim testleri , bir uygulamanın bir bölümünü altyapısından ve bağımlılıklarından yalıtımıyla test etmeyi içerir. 
Birim testi denetleyici mantığı olduğunda, yalnızca tek bir eylemin içerikleri test edilir, onun bağımlılıkları veya 
çerçevenin kendisi değildir. 

Birim test denetleyicileri 

Denetleyicinin davranışına odaklanmak için denetleyici eylemlerinin birim testlerini ayarlayın. Denetleyici birim 
testi Filtreler, yönlendirmeye model bağlamagibi senaryoları önler. Bir isteğe topluca yanıt veren bileşenler 
arasındaki etkileşimleri kapsayan testler, tümleştirme fesf/entarafından işlenir. Tümleştirme testleri hakkında 
daha fazla bilgi için bkz. ASP.NET Core tümleştirme testleri. 

Özel filtreler ve rotalar yazıyorsanız, birim, belirli bir denetleyici eyleminde testlerin bir parçası olarak değil, 
yalıtımına göre test eder. 

Denetleyici birim testlerini göstermek için örnek uygulamada aşağıdaki denetleyiciyi gözden geçirin. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Ana denetleyici bir beyin fırtınası oturumlarının listesini görüntüler ve yeni beyin fırtınası oturumlarının bir 
POST isteğiyle oluşturulmasına izin verir: 




public class HomeController : Controller 

{ 

private readonly IBrainstormSessionRepository _sessionRepository; 

public HomeController(IBrainstormSessionRepository sessionRepository) 

{ 

_sessionRepository = sessionRepository; 

} 

public async Task<IActionResult> Index() 

{ 

var sessionList = await _sessionRepository.ListAsync(); 

var model = sessionList.Select(session => new StormSessionViewModel() 

{ 

Id = session.Id, 

DateCreated = session.DateCreated, 

Name = session.Name, 

IdeaCount = session.Ideas.Count 

}); 

return View(model); 

} 

public class NewSessionModel 

{ 

[Required] 

public string SessionName { get; set; } 

} 

[HttpPost] 

public async Task<IActionResult> Index(NewSessionModel model) 

{ 

if (IModelState.IsValid) 

{ 

return BadRequest(ModelState); 

} 

else 

{ 

await _sessionRepository.AddAsync(new BrainstormSession() 

{ 

DateCreated = DateTimeOffset.Now, 

Name = model.SessionName 

}); 

} 

return RedirectToAction(actionName: nameof(Index)); 

} 

} 

Önceki denetleyici: 

• Açık bağımlılıklar ilkesiniizler. 

• IBrainstormSessionRepository örneğini sağlamak için bağımlılık ekleme (dı) bekliyor. 

• , Moqgibi bir sahte nesne çerçevesi kullanılarak bir moclenmiş IBrainstormSessionRepository hizmeti ile test 
edilebilir. Bir ilişkili nesne , test için kullanılan önceden tanımlanmış bir özellik ve Yöntem davranışları 
kümesine sahip bir fabricobject nesnesidir. Daha fazla bilgi için bkz. tümleştirme testlerine giriş. 

http get index yöntemi döngü veya dallandırma içermez ve yalnızca bir yöntem çağırır. Bu eylemin birim testi: 


GetTestSessions 

yöntemini kullanarak 

IBrainstormSessionRepository 

hizmetini gizler. 

GetTestSessions , 


tarihler ve oturum adlarıyla iki adet sahte beyin fırtınası oturumu oluşturur. 
• index yöntemini yürütür. 










• Yöntemi tarafından döndürülen sonuç üzerinde onaylama işlemleri yapar: 
o Bir VievvResult döndürülür. 

o VievvDataDictionary. model bir stormSessionviewModei . 
o viewDataDictionary.Model depolanan iki beyin fırtınası oturumu vardır. 

[Fact] 

public async Task Index_ReturnsAViewResult_İAİithAListOfBrainstormSessions() 

{ 

// Arrange 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.ListAsync()) 

.ReturnsAsync(GetTestSessions()); 
var controller = new HomeController(mockRepo.Object); 

// Act 

var result = await controller.Index(); 

// Assert 

var viewResult = Assert.IsType<ViewResult>(result); 

var model = Assert.IsAssignableFrom<IEnumerable<StormSessionViewModel>>( 
viewResult.ViewData.Model); 

Assert.Equal(2, model.Count()); 

} 


private List<BrainstormSession> GetTestSessions() 

{ 

var sessions = new List<BrainstormSession>(); 
sessions.Add(new BrainstormSession() 

{ 

DateCreated = new DateTime(2016, 7 , 2 ), 

Id = 1 , 

Name = "Test One" 

}); 

sessions.Add(new BrainstormSession() 

{ 

DateCreated = new DateTime(2016, 7 , 1 ), 

Id = 2 , 

Name = "Test Two" 

}); 

return sessions; 

} 

Ana denetleyicinin http post index yöntemi testleri şunları doğrular: 

• ModelState. IsValid faise olduğunda, eylem yöntemi uygun verilerle bir 400 hatalı istek VievvResult 
döndürür. 

• ModelState.IsValid true : 

o Depodaki Add yöntemi çağrılır. 

o Doğru bağımsız değişkenlerle bir RedirectToActionResult döndürülür. 

Geçersiz bir model durumu, aşağıdaki ilk testte gösterildiği gibi AddModelError kullanılarak hatalar eklenerek 
test edilir: 










[Fact] 

public async Task IndexPost_ReturnsBadRequestResult_WhenModelStateIsInvalid() 

{ 

// Arrange 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.ListAsync()) 

.ReturnsAsync(GetTestSessions ()); 
var controller = new HomeController(mockRepo.Object); 
controller.ModelState.AddModelError("SessionName ", "Required"); 
var newSession = new HomeController.NewSessionModel(); 

// Act 

var result = await controller.Index(newSession); 

// Assert 

var badRequestResult = Assert.IsType<BadRequestObjectResult>(result); 

Assert.IsType<SerializableError>(badReqjestResult.Value); 

} 

[Fact] 

public async Task IndexPost_ReturnsARedirectAndAddsSession_WhenModelStateIsValid() 

{ 

// Arrange 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.AddAsync(It.IsAny<BrainstormSession>())) 

.Returns(Task.CompletedTask) 

.Verifiable(); 

var controller = new HomeController(mockRepo.Object); 
var newSession = new HomeController.NewSessionModel() 

{ 

SessionName = "Test Name" 

}; 

// Act 

var result = await controller.Index(newSession); 

// Assert 

var redirectToActionResult = Assert.IsType<RedirectToActionResult>(result); 

Assert.Null(redirectToActionResult.ControllerName); 

Assert.Equal("Index ", redirectToActionResult.ActionName); 
mockRepo.Verify(); 

} 

ModelState geçerli olmadığında, bir get isteği için aynı viewResuit döndürülür. Test geçersiz bir modeli 
geçirmeye çalışmıyor. Model bağlama çalışmadığından (bir tümleştirme testi model bağlamayı kullansa da), 
geçersiz bir modelin geçirilmesi geçerli bir yaklaşım değildir. Bu durumda model bağlama sınanmamıştır. Bu 
birim testleri yalnızca eylem yöntemindeki kodu test eder. 

ikinci test ModelState geçerli olduğunda doğrular: 

• Yeni bir BrainstormSession eklenir (depo aracılığıyla). 

• Yöntemi, beklenen özelliklerle bir RedirectToActionResult döndürür. 

Çağrılmayan hiçbir çağrı normalde yok sayılır, ancak kurulum çağrısının sonunda verifiable çağrısı testte sahte 
doğrulamaya izin verir. Bu, beklenen yöntemin çağrılmaması durumunda test başarısız olan mockRepo.verify 
çağrısıyla gerçekleştirilir. 










NOTE 

Bu örnekte kullanılan moq kitaplığı, doğrulanabilir olmayan bir şekilde ("gevşek" bir veya saplamalar olarak da adlandırılır) 
doğrulanabilir veya "katı" olarak karışık bir şekilde karışık bir şekilde karıştırılamaz. Moq İle sahte davranışı 
özelleştirmehakkında daha fazla bilgi edinin. 


Örnek uygulamadaki Sessioncontroller , belirli bir beyin fırtınası oturumuyla ilgili bilgileri görüntüler. 
Denetleyici geçersiz id değerlerle ilgilenme mantığını içerir (bu senaryoları kapsayan aşağıdaki örnekte iki 
return senaryo vardır). Son return ifade görünüme yeni bir stormSessionViewModei döndürür 
( Controllers/SessionControUer. cs ): 

public class SessionController : Controller 

{ 

private readonly IBrainstormSessionRepository _sessionRepository; 

public Sessioncontroller(IBrainstormSessionRepository sessionRepository) 

{ 

_sessionRepository = sessionRepository; 

} 

public async Task<IActionResult> Index(int? id) 

{ 

if (üd.HasValue) 

{ 

return RedirectToAction(actionName: nameof(Index), 
controllerName: "Home"); 

} 

var session = await _sessionRepository.GetByIdAsync(id.Value); 
if (session == null) 

{ 

return Content("Session not found."); 

} 

var viewModel = new StormSessionViewModel() 

{ 

DateCreated = session.DateCreated, 

Name = session.Name, 

Id = session.Id 

}; 

return View(viewModel); 

} 

} 


Birim testleri, oturum denetleyicisi index eyleminde her bir return senaryosu için bir test içerir: 










[Fact] 

public async Task IndexReturnsARedirectToIndexHomeWhenIdIsNull() 

{ 

// Arrange 

var controller = new SessionController(sessionRepository: null); 

// Act 

var result = await controller.Index(id: null); 

// Assert 

var redirectToActionResult = 

Assert.IsType<RedirectToActionResult>(result); 

Assert.Equal("Home", redirectToActionResult.ControllerName); 

Assert.Equal("Index", redirectToActionResult.ActlonName); 

} 

[Fact] 

public async Task IndexReturnsContentWithSessionNotFoundWhenSessionNotFound() 

{ 

// Arrange 

int testSessionld = 1; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync((BrainstormSession)null); 
var controller = new SessionController(mockRepo.Object); 

// Act 

var result = await controller.Index(testSessionId); 

// Assert 

var contentResult = Assert.IsType<ContentResult>(result); 

Assert.Equal("Session not found.", contentResult.Content); 

} 

[Fact] 

public async Task IndexReturnsViewResultWithStormSessionViewModel() 

{ 

// Arrange 

int testSessionld = 1; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync(GetTestSessions().FirstOrDefault( 
s => s.Id == testSessionld)); 
var controller = new SessionController(mockRepo.Object); 

// Act 

var result = await controller.Index(testSessionId); 

// Assert 

var viewResult = Assert.IsType<ViewResult>(result); 
var model = Assert.IsType<StormSessionViewModel>( 
viewResult.ViewData.Model); 

Assert.Equal("Test One", model.Name); 

Assert.Equal(2, model.DateCreated.Day); 

Assert.Equal(testSessionld, model.Id); 

} 

Uygulama, fikirler denetleyicisine geçiş yaparken api/ideas rotasında bir Web API 'SI olarak işlevselliği 
kullanıma sunar: 

• Bir beyin fırtınası oturumuyla ilişkili fikirler ( ideaDTO ) listesi, ForSession yöntemi tarafından döndürülür. 


Create yöntemi bir oturuma yeni fikirler ekler. 








[HttpGet("forsession/{sessionId}") ] 

public async Task<IActionResult> ForSession(int sessionld) 

{ 

var session = await _sessionRepository.GetByldAsync(sessionld); 
if (session == null) 

{ 

return NotFound(sessionld); 

} 

var result = session.Ideas.Select(idea => new IdeaDTO() 

{ 

Id = idea.Idj 
Name = idea.Name, 

Description = idea.Description, 

DateCreated = idea.DateCreated 
}).ToList(); 

return Ok(result); 

} 

[FlttpPost( "create") ] 

public async Task<IActionResult> Create([FromBody]NewIdeaModel model) 

{ 

if (IModelState.IsValid) 

{ 

return BadRequest(ModelState); 

} 

var session = await _sessionRepository.GetByIdAsync(model.Sessionld); 
if (session == null) 

{ 

return NotFound(model.Sessionld); 

} 

var idea = new Idea() 

{ 

DateCreated = DateTimeOffset.Now, 

Description = model. Description., 

Name = model.Name 

}; 

session.Addldea(idea); 

await _sessionRepository.UpdateAsync(session); 
return Ok(session); 

} 

iş etki alanı varlıklarını doğrudan API çağrıları aracılığıyla döndürmekten kaçının. Etki alanı varlıkları: 

• Genellikle istemcinin gerektirdiğinden daha fazla veri içerir. 

• Genel olarak sunulan API ile uygulamanın iç etki alanı modelini gereksiz bir şekilde yapın. 

Etki alanı varlıkları ve istemciye döndürülen türler arasında eşleme gerçekleştirilebilir: 

• Örnek uygulamanın kullandığı şekilde bir LINQ select el ile. Daha fazla bilgi için bkz. LINQ (dil İle tümleşik 
sorgu). 

• Otomatik olarak bir kitaplıkla (örneğin, Automaber). 

Ardından, örnek uygulama, fikirler denetleyicisinin create ve ForSession API yöntemlerine yönelik birim 
testlerini gösterir. 

Örnek uygulama iki ForSession test içerir. İlk test, ForSession geçersiz bir oturum için NotFoundObjectResult 
(HTTP bulunamadı) döndürüp döndürmeyeceğini belirler: 








[Fact] 

public async Task ForSession_ReturnsHttpNotFound_ForInvalidSession() 

{ 

// Arrange 

int testSessionld = 123; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync((BrainstormSession)null); 
var controller = new IdeasController(mockRepo.Object); 

// Act 

var result = awalt controller.ForSession(testSessionld); 

// Assert 

var notFoundObjectResult = Assert.IsType<NotFoundObjectResult>(result); 

Assert.Equal(testSessionIdj notFoundObjectResult.Value); 

} 

ikinci ForSession testi, ForSession geçerli bir oturum için oturum fikirleri ( <List<ideaDTO>> ) listesini döndürüp 
döndürmeyeceğini belirler. Denetimler Ayrıca, Name özelliğinin doğru olduğunu onaylamak için ilk fikri de 
inceler: 


[Fact] 

public async Task ForSession_ReturnsIdeasForSession() 

{ 

// Arrange 

int testSessionld = 123; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync(GetTestSession()); 
var controller = new IdeasController(mockRepo.Object); 

// Act 

var result = await controller.ForSession(testSessionld); 

// Assert 

var okResult = Assert.IsType<OkObjectResult>(result); 

var returnValue = Assert.IsType<List<IdeaDTO>>(okResult.Value); 

var idea = returnValue.FirstOrDefault(); 

Assert.Equal("One ", idea.Name); 

} 

Modeistate geçersiz olduğunda create yönteminin davranışını test etmek için, örnek uygulama, testin bir 
parçası olarak denetleyiciye bir model hatası ekler. Birim testlerinde model doğrulama veya model bağlamayı 
sınamayı denemeyin—geçersiz bir Modeistate sahip olduğunda eylem yönteminin davranışını test edin: 

[Fact] 

public async Task Create_ReturnsBadRequest_GivenInvalidModel() 

{ 

// Arrange & Act 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
var controller = new IdeasController(mockRepo.Object); 
controller.Modeistate.AddModelError("error", "some error"); 

// Act 

var result = await controller.Create(model: null); 

// Assert 

Assert.IsTypecBadRequestObjectResult>(result); 







Create ikinci testi, nuiı döndüren depoya bağlıdır, bu nedenle, sahte depo nuiı döndürecek şekilde 
yapılandırılır. Bir test veritabanı (bellekte veya başka türlü) oluşturmanız gerekmez ve bu sonucu döndüren bir 
sorgu oluşturun. Örnek kodun gösterildiği gibi, test tek bir bildirimde gerçekleştirilebilir: 

[Fact] 

public async Task Create_ReturnsHttpNotFound_ForInvalidSession() 

{ 

// Arrange 

int testSessionld = 123; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync((BrainstormSession)null); 
var controller = new IdeasController(mockRepo.Object); 

// Act 

var result = await controller.Create(new NewIdeaModel()); 

// Assert 

Assert.IsType<NotFoundObjectResult>(result); 

} 

Create_ReturnsNewlyCreatedIdeaForSession üçüncü Create testi, deponun UpdateAsync yönteminin çağrıldığım 
doğrular. Sahte, verifiable ile çağrılır ve doğrulanabilen yöntemin yürütüldüğünü onaylamak için, moclenmiş 
deponun verify yöntemi çağırılır. UpdateAsync yönteminin bir tümleştirme testiyle gerçekleştirilebilecek 
verileri—kaydettiğinizden emin olmak için birim testinin sorumluluğu yoktur. 

[Fact] 

public async Task Create_ReturnsNewlyCreatedIdeaForSession() 

{ 

// Arrange 

int testSessionld = 123; 
string testIMame = "test name"; 
string testDescription = "test description"; 
var testSession = GetTestSession(); 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync(testSession); 

var controller = new IdeasController(mockRepo.Object); 

var newldea = new NewIdeaModel() 

{ 

Description = testDescription, 

Name = testName, 

Sessionld = testSessionld 

}; 

mockRepo.Setup(repo => repo.UpdateAsync(testSession)) 

.Returns(Task.CompletedTask) 

.Verifiable(); 

// Act 

var result = await controller.Create(newldea); 

// Assert 

var okResult = Assert.IsType<OkObjectResult>(result); 

var returnSession = Assert.IsType<BrainstormSession>(okResult.Value); 

mockRepo.Verify(); 

Assert.Equal(2, returnSession.Ideas.Count()); 

Assert.Equal(testName, returnSession.Ideas.LastOrDefault().Name); 

Assert.Equal(testDescription, returnSession.Ideas.LastOrDefault().Description); 

} 











Test ActionResultcT > 


ASP.NET Core 2,1 veya sonraki bir sürümde, actionresultct > (ActionResult<TValue>) ActionResuit türetilen 
bir tür döndürmenizi veya belirli bir tür döndürmenizi sağlar. 

Örnek uygulama, belirli bir oturum id için List<ideaDTO> döndüren bir yöntemi içerir. Oturum id yoksa, 
denetleyici NotFounddöndürür: 

[HttpGet("forsessionactionresult/{sessionId}")] 

[Produc8sResponseType(200)] 

[ProducesResponseType(404)] 

public async Task<ActionResult<List<IdeaDTO>>> ForSessionActionResult(int sessionld) 

{ 

var session = await _sessionRepository.GetByldAsync(sessionld); 

if (session == null) 

{ 

return NotFound(sessionld); 

} 

var result = session.Ideas.Select(idea => new IdeaDTO() 

{ 

Id = idea.Id, 

Name = idea-Name, 

Description = idea.Description, 

DateCreated = idea.DateCreated 
}).ToList(); 

return result; 

} 

ForSessionActionResult denetleyicisinin iki testi ApildeasControllerTests dahil edilir. 

İlk test, denetleyicinin varolmayan bir oturum id için varolmayan bir fikir listesi ActionResuit döndürdüğünü 
onaylar: 


• ActionResuit türü ActionResult<List<IdeaDTO>> . 

• Result bir NotFoundObjectResult. 


[Fact] 

public async Task ForSessionActionResult_ReturnsNotFoundObjectResultForNonexistentSession() 

{ 

// Arrange 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
var controller = new IdeasController(mockRepo.Object); 
var nonExistentSessionId = 999; 

// Act 

var result = await controller.ForSessionActionResult(nonExistentSessionId); 

// Assert 

var actionResult = Assert.IsType<ActionResult<List<IdeaDTO>>>(result); 

Assert.IsTypecNotFoundObjectResult>(actionResult.Result); 

} 

Geçerli bir oturum id için ikinci test, yöntemin döndürdüğünü doğrular: 



• Listedeki ilk öğe, sahte oturumda saklanan fikrle eşleşen geçerli bir fikrdir ( GetTestsession çağırarak elde 
edilir). 
















[Fact] 

public async Task ForSessionActionResult_ReturnsIdeasForSession() 

{ 

// Arrange 

int testSessionld = 123; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync(GetTestSesslon()); 
var controller = new IdeasController(mockRepo.Object); 

// Act 

var result = awalt controller.ForSessionActionResult(testSessionld); 

// Assert 

var actionResult = Assert.IsType<ActlonResult<List<IdeaDTO>>>(result); 
var returnValue = Assert.IsType<List<IdeaDTO>>(actionResult.Value); 
var idea = returnValue.FirstOrDefault(); 

Assert.Equal("One ", idea.Name); 

} 

Örnek uygulama, belirli bir oturum için yeni idea oluşturmak üzere bir yöntemi de içerir. Denetleyici şunu 
döndürür: 

• geçersiz bir model için BadRequest. 

• oturum yoksa NotFound. 

• oturum yeni fikrle güncelleştirildiği zaman CreatedAtAction. 


[HttpPost("createactionresult")] 

[ProducesResponseType(201)] 

[ProducesResponseType(400)] 

[ProducesResponseType(404)] 

public async Task<ActionResult<BrainstormSession>> CreateActionResult([FromBody]NewIdeaModel model) 

{ 

if (ÎModelState.IsValid) 

{ 

return BadRequest(ModelState); 

} 

var session = await _sessionRepository.GetByldAsync(model.Sessionld); 

if (session == null) 

{ 

return NotFound(model.Sessionld); 

} 

var idea = new Idea() 

{ 

DateCreated = DateTimeOffset.NoWj 
Description = model. Description., 

Name = model.Name 

}; 

session.Addldea(idea); 

await _sessionRepository.UpdateAsync(session); 

return CreatedAtAction(nameof(CreateActionResult), new { id = session.Id }, session); 

} 

CreateActionResult ÜÇ test ApildeasControllerTests dahil edilir. 

İlk metin, geçersiz bir model için BadReguest döndürüldüğünü onaylar. 






[Fact] 

public async Task CreateActionResult_ReturnsBadRequest_GivenInvalidModelO 

{ 

// Arrange & Act 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
var controller = new IdeasController(mockRepo.Object); 
controller.ModelState.AddModelError("error", "some error"); 

// Act 

var result = await controller.CreateActionResult(model: null); 

// Assert 

var actionResult = Assert.IsType<ActionResult<BrainstormSession>>(result); 

Assert.IsType<BadRequestObjectResult>(actionResult.Result); 

} 

ikinci test, oturum yoksa NotFound döndürülüp döndürülmediğini denetler. 

[Fact] 

public async Task CreateActionResult_ReturnsNotFoundObjectResultForNonexistentSession() 

{ 

// Arrange 

var nonExistentSessionId = 999; 

string testName = "test name"; 

string testDescription = "test description"; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 

var controller = new IdeasController(mockRepo.Object); 

var newldea = new NewIdeaModel() 

{ 

Description = testDescription., 

Name = testName, 

Sessionld = nonExistentSessionId 

}; 

// Act 

var result = await controller.CreateActionResult(newIdea); 

// Assert 

var actionResult = Assert.IsType<ActionResult<BrainstormSession>>(result); 

Assert.IsTypecNotFoundObjectResult>(actionResult.Result); 

} 

Geçerli bir oturum id için son test şunları onaylar: 

• Yöntemi, bir BrainstormSession türü ile ActionResult döndürür. 

• ActionResult<t >. Sonuç bir CreatedAtActionResult. createdAtActionResuit , bir Location üst bilgisiyle 207 
tarafmdan oluşturulan bir yanıta benzerdir. 

• ActionResult<t >. Değer bir BrainstormSession türüdür. 

• Oturumu güncelleştirmek için kullanılan sahte çağrı, updateAsync(testsession) çağrıldı, verifiable yöntemi 
çağrısı onaylamalarda mockRepo.verify() yürütülerek denetlenir. 

• Oturum için iki idea nesnesi döndürülür. 

• Son öğe (sahte çağrının updateAsync tarafından eklenen idea ) testteki oturuma eklenen newidea eşleşir. 



















[Fact] 

public async Task CreateActionResult_ReturnsNewlyCreatedIdeaForSession() 

{ 

// Arrange 

int testSessionld = 123; 
string testIMame = "test name"; 
string testDescription = "test description"; 
var testSession = GetTestSession(); 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync(testSession); 

var controller = new IdeasController(mockRepo.Object); 

var newldea = new NewIdeaModel() 

{ 

Description = testDescription., 

Name = testName, 

Sessionld = testSessionld 

}J 

mockRepo.Setup(repo => repo.UpdateAsync(testSession)) 

.Returns(Task.CompletedTask) 

.Verifiable(); 

// Act 

var result = await controller.CreateActionResult(newIdea); 

// Assert 

var actionResult = Assert.IsType<ActionResult<BrainstormSession>>(result); 
var createdAtActionResult = Assert.IsType<CreatedAtActionResult>(actionResult.Result); 
var returnValue = Assert.IsType<BrainstormSession>(createdAtActionResult.Value); 
mockRepo.Verify(); 

Assert.Equal(2, returnValue.Ideas.Count()); 

Assert.Equal(testName, returnValue.Ideas.LastOrDefault().Name); 

Assert.Equal(testDescription, returnValue.Ideas.LastOrDefault().Description); 


Denetleyiciler herhangi BİR ASP.NET Core MVC uygulamasında merkezi bir rol oynar.Bu nedenle, 
denetleyicilerin amaçlanan gibi davrandığına güvenmelisiniz. Otomatik testler, uygulama bir üretim ortamına 
dağıtılmadan önce hataları tespit edebilir. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Denetleyici mantığının birim testleri 

Birim testleri , bir uygulamanın bir bölümünü altyapısından ve bağımlılıklarından yalıtımıyla test etmeyi içerir. 
Birim testi denetleyici mantığı olduğunda, yalnızca tek bir eylemin içerikleri test edilir, onun bağımlılıkları veya 
çerçevenin kendisi değildir. 

Denetleyicinin davranışına odaklanmak için denetleyici eylemlerinin birim testlerini ayarlayın. Denetleyici birim 
testi Filtreler, yönlendirmeye model bağlamagibi senaryoları önler. Bir isteğe topluca yanıt veren bileşenler 
arasındaki etkileşimleri kapsayan testler, tümleştirme fesf/entarafından işlenir. Tümleştirme testleri hakkında 
daha fazla bilgi için bkz. ASP.NET Core tümleştirme testleri. 

Özel filtreler ve rotalar yazıyorsanız, birim, belirli bir denetleyici eyleminde testlerin bir parçası olarak değil, 
yalıtımına göre test eder. 

Denetleyici birim testlerini göstermek için örnek uygulamada aşağıdaki denetleyiciyi gözden geçirin. Ana 
denetleyici bir beyin fırtınası oturumlarının listesini görüntüler ve yeni beyin fırtınası oturumlarının bir POST 
isteğiyle oluşturulmasına izin verir: 



public class HomeController : Controller 

{ 

private readonly IBrainstormSessionRepository _sessionRepository; 

public HomeController(IBrainstormSessionRepository sessionRepository) 

{ 

_sessionRepository = sessionRepository; 

} 

public async Task<IActionResult> Index() 

{ 

var sessionList = await _sessionRepository.ListAsync(); 

var model = sessionList.Select(session => new StormSessionViewModel() 

{ 

Id = session.Id, 

DateCreated = session.DateCreated, 

Name = session.Name, 

IdeaCount = session.Ideas.Count 

}); 

return View(model); 

} 

public class NewSessionModel 

{ 

[Required] 

public string SessionName { get; set; } 

} 

[HttpPost] 

public async Task<IActionResult> Index(NewSessionModel model) 

{ 

if (IModelState.IsValid) 

{ 

return BadRequest(ModelState); 

} 

else 

{ 

await _sessionRepository.AddAsync(new BrainstormSession() 

{ 

DateCreated = DateTimeOffset.Now, 

Name = model.SessionName 

}); 

} 

return RedirectToAction(actionName: nameof(Index)); 

} 

} 

Önceki denetleyici: 

• Açık bağımlılıklar ilkesiniizler. 

• IBrainstormSessionRepository örneğini sağlamak için bağımlılık ekleme (dı) bekliyor. 

• , Moqgibi bir sahte nesne çerçevesi kullanılarak bir moclenmiş IBrainstormSessionRepository hizmeti ile test 
edilebilir. Bir ilişkili nesne , test için kullanılan önceden tanımlanmış bir özellik ve Yöntem davranışları 
kümesine sahip bir fabricobject nesnesidir. Daha fazla bilgi için bkz. tümleştirme testlerine giriş. 

http get index yöntemi döngü veya dallandırma içermez ve yalnızca bir yöntem çağırır. Bu eylemin birim testi: 


GetTestSessions 

yöntemini kullanarak 

IBrainstormSessionRepository 

hizmetini gizler. 

GetTestSessions , 


tarihler ve oturum adlarıyla iki adet sahte beyin fırtınası oturumu oluşturur. 
• index yöntemini yürütür. 










• Yöntemi tarafından döndürülen sonuç üzerinde onaylama işlemleri yapar: 
o Bir VievvResult döndürülür. 

o VievvDataDictionary. model bir stormSessionviewModei . 
o viewDataDictionary.Model depolanan iki beyin fırtınası oturumu vardır. 

[Fact] 

public async Task Index_ReturnsAViewResult_İAİithAListOfBrainstormSessions() 

{ 

// Arrange 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.ListAsync()) 

.ReturnsAsync(GetTestSessions()); 
var controller = new HomeController(mockRepo.Object); 

// Act 

var result = await controller.Index(); 

// Assert 

var viewResult = Assert.IsType<ViewResult>(result); 

var model = Assert.IsAssignableFrom<IEnumerable<StormSessionViewModel>>( 
viewResult.ViewData.Model); 

Assert.Equal(2, model.Count()); 

} 


private List<BrainstormSession> GetTestSessions() 

{ 

var sessions = new List<BrainstormSession>(); 
sessions.Add(new BrainstormSession() 

{ 

DateCreated = new DateTime(2016, 7 , 2 ), 

Id = 1 , 

Name = "Test One" 

}); 

sessions.Add(new BrainstormSession() 

{ 

DateCreated = new DateTime(2016, 7 , 1 ), 

Id = 2 , 

Name = "Test Two" 

}); 

return sessions; 

} 

Ana denetleyicinin http post index yöntemi testleri şunları doğrular: 

• ModelState. IsValid faise olduğunda, eylem yöntemi uygun verilerle bir 400 hatalı istek VievvResult 
döndürür. 

• ModelState.IsValid true : 

o Depodaki Add yöntemi çağrılır. 

o Doğru bağımsız değişkenlerle bir RedirectToActionResult döndürülür. 

Geçersiz bir model durumu, aşağıdaki ilk testte gösterildiği gibi AddModelError kullanılarak hatalar eklenerek 
test edilir: 










[Fact] 

public async Task IndexPost_ReturnsBadRequestResult_WhenModelStateIsInvalid() 

{ 

// Arrange 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.ListAsync()) 

.ReturnsAsync(GetTestSessions ()); 
var controller = new HomeController(mockRepo.Object); 
controller.ModelState.AddModelError("SessionName ", "Required"); 
var newSession = new HomeController.NewSessionModel(); 

// Act 

var result = await controller.Index(newSession); 

// Assert 

var badRequestResult = Assert.IsType<BadRequestObjectResult>(result); 

Assert.IsType<SerializableError>(badReqjestResult.Value); 

} 

[Fact] 

public async Task IndexPost_ReturnsARedirectAndAddsSession_WhenModelStateIsValid() 

{ 

// Arrange 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.AddAsync(It.IsAny<BrainstormSession>())) 

.Returns(Task.CompletedTask) 

.Verifiable(); 

var controller = new HomeController(mockRepo.Object); 
var newSession = new HomeController.NewSessionModel() 

{ 

SessionName = "Test Name" 

}; 

// Act 

var result = await controller.Index(newSession); 

// Assert 

var redirectToActionResult = Assert.IsType<RedirectToActionResult>(result); 

Assert.Null(redirectToActionResult.ControllerName); 

Assert.Equal("Index ", redirectToActionResult.ActionName); 
mockRepo.Verify(); 

} 

ModelState geçerli olmadığında, bir get isteği için aynı viewResuit döndürülür. Test geçersiz bir modeli 
geçirmeye çalışmıyor. Model bağlama çalışmadığından (bir tümleştirme testi model bağlamayı kullansa da), 
geçersiz bir modelin geçirilmesi geçerli bir yaklaşım değildir. Bu durumda model bağlama sınanmamıştır. Bu 
birim testleri yalnızca eylem yöntemindeki kodu test eder. 

ikinci test ModelState geçerli olduğunda doğrular: 

• Yeni bir BrainstormSession eklenir (depo aracılığıyla). 

• Yöntemi, beklenen özelliklerle bir RedirectToActionResult döndürür. 

Çağrılmayan hiçbir çağrı normalde yok sayılır, ancak kurulum çağrısının sonunda verifiable çağrısı testte sahte 
doğrulamaya izin verir. Bu, beklenen yöntemin çağrılmaması durumunda test başarısız olan mockRepo.verify 
çağrısıyla gerçekleştirilir. 










NOTE 

Bu örnekte kullanılan moq kitaplığı, doğrulanabilir olmayan bir şekilde ("gevşek" bir veya saplamalar olarak da adlandırılır) 
doğrulanabilir veya "katı" olarak karışık bir şekilde karışık bir şekilde karıştırılamaz. Moq İle sahte davranışı 
özelleştirmehakkında daha fazla bilgi edinin. 


Örnek uygulamadaki Sessioncontroller , belirli bir beyin fırtınası oturumuyla ilgili bilgileri görüntüler. 
Denetleyici geçersiz id değerlerle ilgilenme mantığını içerir (bu senaryoları kapsayan aşağıdaki örnekte iki 
return senaryo vardır). Son return ifade görünüme yeni bir stormSessionViewModei döndürür 
( Controllers/SessionControUer. cs ): 

public class SessionController : Controller 

{ 

private readonly IBrainstormSessionRepository _sessionRepository; 

public Sessioncontroller(IBrainstormSessionRepository sessionRepository) 

{ 

_sessionRepository = sessionRepository; 

} 

public async Task<IActionResult> Index(int? id) 

{ 

if (üd.HasValue) 

{ 

return RedirectToAction(actionName: nameof(Index), 
controllerName: "Home"); 

} 

var session = await _sessionRepository.GetByIdAsync(id.Value); 
if (session == null) 

{ 

return Content("Session not found."); 

} 

var viewModel = new StormSessionViewModel() 

{ 

DateCreated = session.DateCreated, 

Name = session.Name, 

Id = session.Id 

}; 

return View(viewModel); 

} 

} 


Birim testleri, oturum denetleyicisi index eyleminde her bir return senaryosu için bir test içerir: 










[Fact] 

public async Task IndexReturnsARedirectToIndexHomeWhenIdIsNull() 

{ 

// Arrange 

var controller = new SessionController(sessionRepository: null); 

// Act 

var result = await controller.Index(id: null); 

// Assert 

var redirectToActionResult = 

Assert.IsType<RedirectToActionResult>(result); 

Assert.Equal("Home", redirectToActionResult.ControllerName); 

Assert.Equal("Index", redirectToActionResult.ActlonName); 

} 

[Fact] 

public async Task IndexReturnsContentWithSessionNotFoundWhenSessionNotFound() 

{ 

// Arrange 

int testSessionld = 1; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync((BrainstormSession)null); 
var controller = new SessionController(mockRepo.Object); 

// Act 

var result = await controller.Index(testSessionId); 

// Assert 

var contentResult = Assert.IsType<ContentResult>(result); 

Assert.Equal("Session not found.", contentResult.Content); 

} 

[Fact] 

public async Task IndexReturnsViewResultWithStormSessionViewModel() 

{ 

// Arrange 

int testSessionld = 1; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync(GetTestSessions().FirstOrDefault( 
s => s.Id == testSessionld)); 
var controller = new SessionController(mockRepo.Object); 

// Act 

var result = await controller.Index(testSessionId); 

// Assert 

var viewResult = Assert.IsType<ViewResult>(result); 
var model = Assert.IsType<StormSessionViewModel>( 
viewResult.ViewData.Model); 

Assert.Equal("Test One", model.Name); 

Assert.Equal(2, model.DateCreated.Day); 

Assert.Equal(testSessionld, model.Id); 

} 

Uygulama, fikirler denetleyicisine geçiş yaparken api/ideas rotasında bir Web API 'SI olarak işlevselliği 
kullanıma sunar: 

• Bir beyin fırtınası oturumuyla ilişkili fikirler ( ideaDTO ) listesi, ForSession yöntemi tarafından döndürülür. 


Create yöntemi bir oturuma yeni fikirler ekler. 








[HttpGet("forsession/{sessionId}") ] 

public async Task<IActionResult> ForSession(int sessionld) 

{ 

var session = await _sessionRepository.GetByldAsync(sessionld); 
if (session == null) 

{ 

return NotFound(sessionld); 

} 

var result = session.Ideas.Select(idea => new IdeaDTO() 

{ 

Id = idea.Idj 
Name = idea.Name, 

Description = idea.Description, 

DateCreated = idea.DateCreated 
}).ToList(); 

return Ok(result); 

} 

[FlttpPost( "create") ] 

public async Task<IActionResult> Create([FromBody]NewIdeaModel model) 

{ 

if (IModelState.IsValid) 

{ 

return BadRequest(ModelState); 

} 

var session = await _sessionRepository.GetByIdAsync(model.Sessionld); 
if (session == null) 

{ 

return NotFound(model.Sessionld); 

} 

var idea = new Idea() 

{ 

DateCreated = DateTimeOffset.Now, 

Description = model. Description., 

Name = model.Name 

}; 

session.Addldea(idea); 

await _sessionRepository.UpdateAsync(session); 
return Ok(session); 

} 

iş etki alanı varlıklarını doğrudan API çağrıları aracılığıyla döndürmekten kaçının. Etki alanı varlıkları: 

• Genellikle istemcinin gerektirdiğinden daha fazla veri içerir. 

• Genel olarak sunulan API ile uygulamanın iç etki alanı modelini gereksiz bir şekilde yapın. 

Etki alanı varlıkları ve istemciye döndürülen türler arasında eşleme gerçekleştirilebilir: 

• Örnek uygulamanın kullandığı şekilde bir LINQ select el ile. Daha fazla bilgi için bkz. LINQ (dil İle tümleşik 
sorgu). 

• Otomatik olarak bir kitaplıkla (örneğin, Automaber). 

Ardından, örnek uygulama, fikirler denetleyicisinin create ve ForSession API yöntemlerine yönelik birim 
testlerini gösterir. 

Örnek uygulama iki ForSession test içerir. İlk test, ForSession geçersiz bir oturum için NotFoundObjectResult 
(HTTP bulunamadı) döndürüp döndürmeyeceğini belirler: 








[Fact] 

public async Task ForSession_ReturnsHttpNotFound_ForInvalidSession() 

{ 

// Arrange 

int testSessionld = 123; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync((BrainstormSession)null); 
var controller = new IdeasController(mockRepo.Object); 

// Act 

var result = awalt controller.ForSession(testSessionld); 

// Assert 

var notFoundObjectResult = Assert.IsType<NotFoundObjectResult>(result); 

Assert.Equal(testSessionIdj notFoundObjectResult.Value); 

} 

ikinci ForSession testi, ForSession geçerli bir oturum için oturum fikirleri ( <List<ideaDTO>> ) listesini döndürüp 
döndürmeyeceğini belirler. Denetimler Ayrıca, Name özelliğinin doğru olduğunu onaylamak için ilk fikri de 
inceler: 


[Fact] 

public async Task ForSession_ReturnsIdeasForSession() 

{ 

// Arrange 

int testSessionld = 123; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync(GetTestSession()); 
var controller = new IdeasController(mockRepo.Object); 

// Act 

var result = await controller.ForSession(testSessionld); 

// Assert 

var okResult = Assert.IsType<OkObjectResult>(result); 

var returnValue = Assert.IsType<List<IdeaDTO>>(okResult.Value); 

var idea = returnValue.FirstOrDefault(); 

Assert.Equal("One ", idea.Name); 

} 

Modeistate geçersiz olduğunda create yönteminin davranışını test etmek için, örnek uygulama, testin bir 
parçası olarak denetleyiciye bir model hatası ekler. Birim testlerinde model doğrulama veya model bağlamayı 
sınamayı denemeyin—geçersiz bir Modeistate sahip olduğunda eylem yönteminin davranışını test edin: 

[Fact] 

public async Task Create_ReturnsBadRequest_GivenInvalidModel() 

{ 

// Arrange & Act 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
var controller = new IdeasController(mockRepo.Object); 
controller.Modeistate.AddModelError("error", "some error"); 

// Act 

var result = await controller.Create(model: null); 

// Assert 

Assert.IsTypecBadRequestObjectResult>(result); 







Create ikinci testi, nuiı döndüren depoya bağlıdır, bu nedenle, sahte depo nuiı döndürecek şekilde 
yapılandırılır. Bir test veritabanı (bellekte veya başka türlü) oluşturmanız gerekmez ve bu sonucu döndüren bir 
sorgu oluşturun. Örnek kodun gösterildiği gibi, test tek bir bildirimde gerçekleştirilebilir: 

[Fact] 

public async Task Create_ReturnsHttpNotFound_ForInvalidSession() 

{ 

// Arrange 

int testSessionld = 123; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync((BrainstormSession)null); 
var controller = new IdeasController(mockRepo.Object); 

// Act 

var result = await controller.Create(new NewIdeaModel()); 

// Assert 

Assert.IsType<NotFoundObjectResult>(result); 

} 

Create_ReturnsNewlyCreatedIdeaForSession üçüncü Create testi, deponun UpdateAsync yönteminin çağrıldığım 
doğrular. Sahte, verifiable ile çağrılır ve doğrulanabilen yöntemin yürütüldüğünü onaylamak için, moclenmiş 
deponun verify yöntemi çağırılır. UpdateAsync yönteminin bir tümleştirme testiyle gerçekleştirilebilecek 
verileri—kaydettiğinizden emin olmak için birim testinin sorumluluğu yoktur. 

[Fact] 

public async Task Create_ReturnsNewlyCreatedIdeaForSession() 

{ 

// Arrange 

int testSessionld = 123; 
string testIMame = "test name"; 
string testDescription = "test description"; 
var testSession = GetTestSession(); 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync(testSession); 

var controller = new IdeasController(mockRepo.Object); 

var newldea = new NewIdeaModel() 

{ 

Description = testDescription, 

Name = testName, 

Sessionld = testSessionld 

}; 

mockRepo.Setup(repo => repo.UpdateAsync(testSession)) 

.Returns(Task.CompletedTask) 

.Verifiable(); 

// Act 

var result = await controller.Create(newldea); 

// Assert 

var okResult = Assert.IsType<OkObjectResult>(result); 

var returnSession = Assert.IsType<BrainstormSession>(okResult.Value); 

mockRepo.Verify(); 

Assert.Equal(2, returnSession.Ideas.Count()); 

Assert.Equal(testName, returnSession.Ideas.LastOrDefault().Name); 

Assert.Equal(testDescription, returnSession.Ideas.LastOrDefault().Description); 

} 











Test ActionResultcT > 


ASP.NET Core 2,1 veya sonraki bir sürümde, actionresultct > (ActionResult<TValue>) ActionResuit türetilen 
bir tür döndürmenizi veya belirli bir tür döndürmenizi sağlar. 

Örnek uygulama, belirli bir oturum id için List<ideaDTO> döndüren bir yöntemi içerir. Oturum id yoksa, 
denetleyici NotFounddöndürür: 

[HttpGet("forsessionactionresult/{sessionId}")] 

[Produc8sResponseType(200)] 

[ProducesResponseType(404)] 

public async Task<ActionResult<List<IdeaDTO>>> ForSessionActionResult(int sessionld) 

{ 

var session = await _sessionRepository.GetByldAsync(sessionld); 

if (session == null) 

{ 

return NotFound(sessionld); 

} 

var result = session.Ideas.Select(idea => new IdeaDTO() 

{ 

Id = idea.Id, 

Name = idea-Name, 

Description = idea.Description, 

DateCreated = idea.DateCreated 
}).ToList(); 

return result; 

} 

ForSessionActionResult denetleyicisinin iki testi ApildeasControllerTests dahil edilir. 

İlk test, denetleyicinin varolmayan bir oturum id için varolmayan bir fikir listesi ActionResuit döndürdüğünü 
onaylar: 


• ActionResuit türü ActionResult<List<IdeaDTO>> . 

• Result bir NotFoundObjectResult. 


[Fact] 

public async Task ForSessionActionResult_ReturnsNotFoundObjectResultForNonexistentSession() 

{ 

// Arrange 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
var controller = new IdeasController(mockRepo.Object); 
var nonExistentSessionId = 999; 

// Act 

var result = await controller.ForSessionActionResult(nonExistentSessionId); 

// Assert 

var actionResult = Assert.IsType<ActionResult<List<IdeaDTO>>>(result); 

Assert.IsTypecNotFoundObjectResult>(actionResult.Result); 

} 

Geçerli bir oturum id için ikinci test, yöntemin döndürdüğünü doğrular: 



• Listedeki ilk öğe, sahte oturumda saklanan fikrle eşleşen geçerli bir fikrdir ( GetTestsession çağırarak elde 
edilir). 
















[Fact] 

public async Task ForSessionActionResult_ReturnsIdeasForSession() 

{ 

// Arrange 

int testSessionld = 123; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync(GetTestSesslon()); 
var controller = new IdeasController(mockRepo.Object); 

// Act 

var result = awalt controller.ForSessionActionResult(testSessionld); 

// Assert 

var actionResult = Assert.IsType<ActlonResult<List<IdeaDTO>>>(result); 
var returnValue = Assert.IsType<List<IdeaDTO>>(actionResult.Value); 
var idea = returnValue.FirstOrDefault(); 

Assert.Equal("One ", idea.Name); 

} 

Örnek uygulama, belirli bir oturum için yeni idea oluşturmak üzere bir yöntemi de içerir. Denetleyici şunu 
döndürür: 

• geçersiz bir model için BadRequest. 

• oturum yoksa NotFound. 

• oturum yeni fikrle güncelleştirildiği zaman CreatedAtAction. 


[HttpPost("createactionresult")] 

[ProducesResponseType(201)] 

[ProducesResponseType(400)] 

[ProducesResponseType(404)] 

public async Task<ActionResult<BrainstormSession>> CreateActionResult([FromBody]NewIdeaModel model) 

{ 

if (ÎModelState.IsValid) 

{ 

return BadRequest(ModelState); 

} 

var session = await _sessionRepository.GetByldAsync(model.Sessionld); 

if (session == null) 

{ 

return NotFound(model.Sessionld); 

} 

var idea = new Idea() 

{ 

DateCreated = DateTimeOffset.NoWj 
Description = model. Description., 

Name = model.Name 

}; 

session.Addldea(idea); 

await _sessionRepository.UpdateAsync(session); 

return CreatedAtAction(nameof(CreateActionResult), new { id = session.Id }, session); 

} 

CreateActionResult ÜÇ test ApildeasControllerTests dahil edilir. 

İlk metin, geçersiz bir model için BadReguest döndürüldüğünü onaylar. 






[Fact] 

public async Task CreateActionResult_ReturnsBadRequest_GivenInvalidModelO 

{ 

// Arrange & Act 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
var controller = new IdeasController(mockRepo.Object); 
controller.ModelState.AddModelError("error", "some error"); 

// Act 

var result = await controller.CreateActionResult(model: null); 

// Assert 

var actionResult = Assert.IsType<ActionResult<BrainstormSession>>(result); 

Assert.IsType<BadRequestObjectResult>(actionResult.Result); 

} 

ikinci test, oturum yoksa NotFound döndürülüp döndürülmediğini denetler. 

[Fact] 

public async Task CreateActionResult_ReturnsNotFoundObjectResultForNonexistentSession() 

{ 

// Arrange 

var nonExistentSessionId = 999; 

string testName = "test name"; 

string testDescription = "test description"; 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 

var controller = new IdeasController(mockRepo.Object); 

var newldea = new NewIdeaModel() 

{ 

Description = testDescription., 

Name = testName, 

Sessionld = nonExistentSessionId 

}; 

// Act 

var result = await controller.CreateActionResult(newIdea); 

// Assert 

var actionResult = Assert.IsType<ActionResult<BrainstormSession>>(result); 

Assert.IsTypecNotFoundObjectResult>(actionResult.Result); 

} 

Geçerli bir oturum id için son test şunları onaylar: 

• Yöntemi, bir BrainstormSession türü ile ActionResult döndürür. 

• ActionResult<t >. Sonuç bir CreatedAtActionResult. createdAtActionResuit , bir Location üst bilgisiyle 207 
tarafmdan oluşturulan bir yanıta benzerdir. 

• ActionResult<t >. Değer bir BrainstormSession türüdür. 

• Oturumu güncelleştirmek için kullanılan sahte çağrı, updateAsync(testsession) çağrıldı, verifiable yöntemi 
çağrısı onaylamalarda mockRepo.verify() yürütülerek denetlenir. 

• Oturum için iki idea nesnesi döndürülür. 

• Son öğe (sahte çağrının updateAsync tarafından eklenen idea ) testteki oturuma eklenen newidea eşleşir. 



















[Fact] 

public async Task CreateActionResult_ReturnsNewlyCreatedIdeaForSession() 

{ 

// Arrange 

int testSessionld = 123; 
string testIMame = "test name"; 
string testDescription = "test description"; 
var testSession = GetTestSession(); 

var mockRepo = new Mock<IBrainstormSessionRepository>(); 
mockRepo.Setup(repo => repo.GetByldAsync(testSessionld)) 

.ReturnsAsync(testSession); 

var controller = new IdeasController(mockRepo.Object); 

var newldea = new NewIdeaModel() 

{ 

Description = testDescription., 

Name = testName, 

Sessionld = testSessionld 

}J 

mockRepo.Setup(repo => repo.UpdateAsync(testSession)) 

.Returns(Task.CompletedTask) 

.Verifiable(); 

// Act 

var result = await controller.CreateActionResult(newIdea); 

// Assert 

var actionResult = Assert.IsType<ActionResult<BrainstormSession>>(result); 
var createdAtActionResult = Assert.IsType<CreatedAtActionResult>(actionResult.Result); 
var returnValue = Assert.IsType<BrainstormSession>(createdAtActionResult.Value); 
mockRepo.Verify(); 

Assert.Equal(2, returnValue.Ideas.Count()); 

Assert.Equal(testName, returnValue.Ideas.LastOrDefault().Name); 

Assert.Equal(testDescription, returnValue.Ideas.LastOrDefault().Description); 


Ek kaynaklar 

• ASP.NET Core tümleştirme testleri 

• Visual Studio ile birim testleri oluşturma ve çalıştırma 

• ASP.NET Core - MVC İçin Mysınanan. AspNetCore. Mvc-Floent test Kitaplığı , MVC ve Web API 
uygulamalarını test etmek için akıcı bir arabirim sağlar. (Microsoft tarafından korunmaz veya desteklenmez.) 



ASPNET Core tümleştirme testleri 
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Luke Latham, Javier Calvarro Nelson, Steve Smithve Jos van der. 

Tümleştirme sınamaları, uygulamanın bileşenlerinin veritabanı, dosya sistemi ve ağ gibi destekleyici 
altyapısını içeren bir düzeyde doğru şekilde çalışmasını güvence altına alır. ASP.NET Core, test Web ana 
bilgisayarı ve bellek içi test sunucusu olan bir birim testi çerçevesini kullanarak tümleştirme testlerini 
destekler. 

Bu konuda, birim testlerinin temel bir şekilde anlaşıldığı varsayılır.Test kavramları hakkında bilgi sahibi 
değilseniz, .NET Core 'Da birim testine ve .NET Standard konusuna ve bağlı içeriğine bakın. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Örnek uygulama bir Razor Pages uygulamasıdır ve Razor Pages temel bir anlama sahip olduğunu varsayar. 
Razor Pages hakkında bilginiz yoksa, aşağıdaki konulara bakın: 

• Razor Pages'e giriş 

• Razor Sayfaları kullanmaya başlama 

• Razor Sayfaları birim testleri 


NOTE 

Maça ’Ları test etmek için, bir tarayıcıyı otomatikleştirebilen Seleniumgibi bir araç öneririz. 


Tümleştirme testlerine giriş 

Tümleştirme testleri, bir uygulamanın bileşenlerini birim testlerindendaha geniş bir düzeyde değerlendirir. 
Birim testleri, ayrı sınıf yöntemleri gibi yalıtılmış yazılım bileşenlerini test etmek için kullanılır.Tümleştirme 
testleri iki veya daha fazla uygulama bileşeninin beklenen bir sonuç üretmek için birlikte çalıştığını ve 
muhtemelen bir isteği tam olarak işlemek için gereken her bileşeni de dahil olduğunu onaylar. 

Bu geniş testler, uygulamanın altyapısını ve tüm çatısını test etmek için kullanılır, genellikle aşağıdaki 
bileşenler dahil: 

• Veritabanı 

• Dosya sistemi 

• Ağ gereçleri 

• istek-yanıt işlem hattı 

Birim testleri, altyapı bileşenlerinin yerine, Fakes veya sahte nesnelero larak bilinen fabriccomponents 
bileşenlerini kullanır. 

Birim testlerinin aksine, tümleştirme testleri: 

• Uygulamanın üretimde kullandığı gerçek bileşenleri kullanın. 

• Daha fazla kod ve veri işleme gerektir. 

• Çalıştırmak daha uzun sürer. 

Bu nedenle, tümleştirme testlerinin kullanımını en önemli altyapı senaryolarıyla sınırlayın. Bir davranış, birim 
testi veya tümleştirme testi kullanılarak test edilebilir ise, birim testini seçin. 





TIP 

Veritabanları ve dosya sistemleriyle ilgili her olası veri ve dosya erişimi için tümleştirme testleri yazma. Bir 
uygulamadaki kaç yerde veritabanlarıyla ve dosya sistemleriyle etkileşime girdiğinize bakılmaksızın, bir dizi Read, Write, 
Update ve DELETE tümleştirme testi, genellikle veritabanı ve dosya sistemi bileşenlerinin yeterli şekilde test edilmesine 
sahip olur. Bu bileşenlerle etkileşime geçen Yöntem mantığının rutin testleri için birim testleri kullanın. Birim testlerinde, 
altyapı kullanımı ve moizler 'in kullanılması daha hızlı test yürütmesiyle sonuçlanır 


NOTE 

Tümleştirme testlerinin tartışmalarında, test edilen proje genellikle test altındaki s'ıstemve ya kısa İÇİN "sut" olarak 
adlandırılır. 

Bu konu başlığı altında, sınanan ASRNET Core uygulamasına başvurmak için "SUT" kullanılır. 


ASP.NET Core tümleştirme testleri 

AS P.N ET Core tümleştirme testleri şunları gerektirir: 

• Testleri içermesi ve yürütmek için bir test projesi kullanılır.Test projesinin SUT 'a bir başvurusu vardır. 

• Test projesi SUT için bir test Web Konağı oluşturur ve SUT ile istekleri ve yanıtları işlemek için bir test 
sunucusu istemcisi kullanır. 

• Test Çalıştırıcısı, testleri yürütmek ve test sonuçlarını raporlamak için kullanılır. 

Tümleştirme testleri, olağan düzenleme, hareketle onaylama testi adımlarını içeren bir olay dizisini izler: 

1. SUT 'un web ana bilgisayarı yapılandırıldı. 

2. İstekleri uygulamaya göndermek için bir test sunucusu istemcisi oluşturulur. 

3. Testi Düzenle adımı yürütülür: test uygulaması bir istek hazırlar. 

4. Davran test adımı yürütülür: istemci, isteği gönderir ve yanıtını alır. 

5. Onaylama testi adımı yürütülür: Gerçek yanıt, beklenen bir yanıta bağlı olarak başarılı veya başarısız 
olarak onaylanır. 

6. İşlem, tüm testler yürütülene kadar devam eder. 

7. Test sonuçları raporlanır. 

Genellikle, test Web ana bilgisayarı, test çalıştırmaları için uygulamanın normal web ana bilgisayarında farklı 
şekilde yapılandırılır. Örneğin, testler için farklı bir veritabanı veya farklı uygulama ayarları kullanılıyor 
olabilir. 

Test Web Konağı ve bellek içi test sunucusu (TestServer) gibi altyapı bileşenleri, Microsoft. Aspnetcore. Mvc. 
Testing paketi tarafından sağlanır veya yönetilir. Bu paketin kullanımı, test oluşturma ve yürütmeyi 
kolaylaştırır. 

Microsoft.AspNetcore.Mvc.Testing paketi aşağıdaki görevleri gerçekleştirir: 

• Bağımlılıklar dosyasını (. Deps) sut 'den test projesinin bin dizinine kopyalar. 

• , Testler yürütüldüğünde statik dosya ve sayfa/görünümlerin bulunması için içerik kökünü sut 'nin proje 
köküne ayarlar. 

• TestServer ile SUT önyükleyiciyi kolaylaştırmak için VVebapplicationfactory sınıfını sağlar. 

Birim testi belgeleri bir test projesi ve Test Çalıştırıcısı ayarlamayı ve testlerin ve test sınıflarının nasıl 
belirleneceğini gösteren testlerin ve önerilerin nasıl çalıştırılacağını gösteren ayrıntılı yönergelerle birlikte 
açıklanır. 














NOTE 

Bir uygulama için test projesi oluştururken, birim testlerini tümleştirme testlerinden farklı projelere ayırın. Bu, altyapı 
testi bileşenlerinin birim testlerine yanlışlıkla dahil olmamasını sağlamaya yardımcı olur. Birim ve tümleştirme testlerinin 
ayrımı, hangi test kümesinin çalıştırılmasına da izin verir. 


Razor Pages Apps ve MVC uygulamalarının testleri için yapılandırma arasında neredeyse fark yoktur.Tek 
fark testlerin adlandırılmasınlardır. Razor Pages uygulamasında, sayfa uç noktalarının testleri genellikle sayfa 
modeli sınıfından sonra adlandırılır (örneğin, dizin sayfasına yönelik bileşen tümleştirmesini test etmek için 
indexPageTests ). MVC uygulamasında testler genellikle denetleyici sınıfları tarafından düzenlenir ve test 
ettikleri denetleyiciler (örneğin, ana denetleyicinin bileşen tümleştirmesini test etmek için 
HomeControllerTests ). 


Test uygulaması önkoşulları 

Test projesi şunları vermelidir: 

• Microsoft. AspNetCore. Mvc. Testing paketine başvurun. 

• Proje dosyasında Web SDK'sini belirtin ( <Project sdk="Microsoft.NET.sdk.web"> ). 

Bu Önkoşullar örnek uygulamadagörülebilir. Testler/RazorPagesProject. Tests/RazorPagesProject. Tests. 
csproj dosyasını inceleyin. Örnek uygulama, xllnit test çerçevesini ve anglesharp Parser kitaplığını kullanır, 
bu nedenle örnek uygulama de şu şekilde başvurur: 

• xllnit 

• xllnit. Çalıştırıcısı. VisualStudio 

• AngleSharp 

Entity Framevvork Core, testlerde de kullanılır. Uygulama başvuru: 

• Microsoft. AspNetCore. Diagnostics. EntityFramevvorkCore 

• Microsoft. AspNetCore. Identity. EntityFramevvorkCore 

• Microsoft EntityFramevvorkCore 

• Microsoft. EntityFramevvorkCore. InMemory 

• Microsoft EntityFramevvorkCore. Tools 


SUT ortamı 

SUT ortamı ayarlanmamışsa, ortam varsayılan olarak geliştirme olur. 


Varsayılan VVebApplicationFactory ile temel testler 

VVebapplicationfactory <TEntryPoint > , tümleştirme testleri İçin bir TestServer oluşturmak üzere kullanılır. 
TEntryPoint , genellikle startup sınıfının SUT giriş noktası sınıfıdır. 


Test sınıfları sınıfı testlerin içerdiğini göstermek ve sınıftaki testler arasında paylaşılan nesne örnekleri 
sağlamak için bir sınıf armatürü arabirimi (ıssfixture) uygular. 


Aşağıdaki test sınıfı BasicTests , SUT 'yi önyüklemek ve bir test yöntemine HttpClient sağlamak için 


UebApplicationFactory kullanır Get_EndpointsReturnSuccessAndCorrectContentType . Yöntemi, yanıt durum 
kodunun başarılı olup olmadığını denetler (200-299 aralığındaki durum kodları) ve Content-Type üstbilgisi 
çeşitli uygulama sayfaları için text/htmij charset=utf-8 1 dir. 


Createclient , yeniden yönlendirmeleri otomatik olarak izleyen ve tanımlama bilgilerini işleyen bir 









HttpClient örneği oluşturur. 


public class BasicTests 

: IClassFixture<WebApplicationFactory<RazorPagesProject.Startup>> 

{ 

private readonly WebApplicationFactory<RazorPagesProject.Startup> _factory; 

public BasicTests(WebApplicationFactory<RazorPagesProject.Startup> factory) 

{ 

_factory = factory; 

} 

[Theory] 

[InlineData("/")] 

[InlineData("/Index")] 

[InlineData("/About")] 

[InlineData("/Privacy")] 

[InlineDataC'/Contact") ] 

public async Task Get_EndpointsReturnSuccessAndCorrectContentType(string url) 

{ 

// Arrange 

var Client = _factory.CreateClient(); 

// Act 

var response = await Client. GetAsync(url); 

// Assert 

response.EnsureSuccessStatusCode(); // Status Code 200-299 
Assert.Equal("text/html; charset=utf-8", 

response.Content.Headers.ContentType.ToStringO); 

} 

} 


Varsayılan olarak, GDPR onay ilkesi etkinleştirildiğinde, önemli olmayan tanımlama bilgileri istekler arasında 
korunmaz. TempData sağlayıcısı tarafından kullanılanlar gibi, önemli olmayan tanımlama bilgilerini korumak 
için, bunları testlerinizde gerekli olarak işaretleyin. Tanımlama bilgisini önemli olarak işaretleme hakkında 
yönergeler için bkz. temel tanımlama bilgileri. 

VVebApplicationFactory 'yi özelleştirme 

Web ana bilgisayar yapılandırması, bir veya daha fazla özel fabrika oluşturmak için uebAppiicationFactory 1 
dan devralarak test sınıflarından bağımsız olarak oluşturulabilir: 

1 . uebAppiicationFactory 'den devralma ve Configurevvebhost'i geçersiz kılma. Ivvebhostbuilder , hizmet 
koleksiyonunun ConfigureServicesile yapılandırılmasına izin verir: 




public class CustomWebApplicationFactory<TStartup> 

: WebApplicationFactory<TStartup> where TStartup: class 

{ 

protected override void ConfigureWebHost(IWebHostBuilder builder) 

{ 

builder.ConfigureServices(Services => 

{ 

// Remove the app's ApplicationDbContext registration. 
var descriptor = Services.SingleOrDefault( 
d => d.ServiceType == 

typeof(DbContextOptions<ApplicationDbContext>)); 

if (descriptor != null) 

{ 

Services.Remove(descriptor); 

} 

// Add ApplicationDbContext using an in-memory database for testing. 

Services.AddDbContext<ApplicationDbContext>(options => 

{ 

options.UselnMemoryDatabase("InMemoryDbForTesting"); 

}); 

// Build the service provider. 

var sp = Services.BuildServiceProvider(); 

// Create a scope to obtain a reference to the database 
// context (ApplicationDbContext). 
using (var scope = sp.CreateScope()) 

{ 

var scopedServices = scope.ServiceProvider; 

var db = scopedServices.GetRequiredService<ApplicationDbContext>(); 
var logger = scopedServices 

.GetRequiredService<ILogger<CustomWebApplicationFactory<TStartup>>>(); 

// Ensure the database is created. 
db.Database.EnsureCreated(); 


} 


} 


try 

{ 

// Seed the database with test data. 

Utilities.InitializeDbForTests(db); 

} 

catch (Exception ex) 

{ 

logger.LogError(eXj "An error occurred seeding the " + 

"database with test messages. Error: {Message}", ex.Message); 

} 

} 

}); 


Örnek uygulamadaki veritabanı dengeli dağıtımı initializeDbForTests yöntemi tarafından 
gerçekleştirilir. Yöntemi, tümleştirme testleri örneği: test uygulaması kuruluşu bölümünde 
açıklanmaktadır. 


SUT 'un veritabanı bağlamı startup.configureServices yönteminde kayıtlı. Uygulamanın 
Startup.ConfigureServices kodu yürütüldükten sonra , test uygulamasının builder.ConfigureServices 
geri çağırması yürütülür. Uygulamanın veritabanından farklı testler için farklı bir veritabanı kullanmak 
istiyorsanız, uygulamanın veritabanı bağlamı builder.ConfigureServices 1 da değiştirilmelidir. 

Örnek uygulama, veritabanı bağlamı için hizmet tanımlayıcısını bulur ve hizmet kaydını kaldırmak için 
tanımlayıcıyı kullanır. Ardından, fabrika, testler için bellek içi veritabanı kullanan yeni bir 









ApplicationDbContext ekler. 


Bellek içi veritabanından farklı bir veritabanına bağlanmak için, bağlamı farklı bir veritabanına 
bağlamak üzere useinMemoryDatabase çağrısını değiştirin. SQL Server test veritabanı kullanmak için: 

• Proje dosyasındaki Microsoft. EntityFramevvorkCore. SqlServer NuGet paketine başvurun. 

• Veritabanına bir bağlantı dizesiyle useSqiserver çağrısı yapın. 

Services.AddDbContext<ApplicationDbContext>((options, context) => 

{ 

context.UseSqlServer( 

Configuration.GetConnectionString("TestingDbConnectionString")); 

}); 

2. Test sınıflarında özel customwebAppiicationFactory kullanın. Aşağıdaki örnek indexPageTests sınıfında 
fabrikası kullanır: 


public class IndexPageTests : 

IClassFixture<CustomWebApplicationFactory<RazorPagesProject.Startup>> 

{ 

private readonly HttpClient _client; 

private readonly CustomWebApplicationFactory<RazorPagesProject.Startup> 

_factory; 

public IndexPageTests( 

CustomWebApplicationFactory<RazorPagesProject.Startup> factory) 

{ 

_factory = factory; 

_client = factory.CreateClient(new WebApplicationFactoryClientOptions 

{ 

AllowAutoRedirect = false 

}); 

} 

Örnek uygulamanın istemcisi, aşağıdaki yeniden yönlendirmelere HttpClient ' i engelleyecek şekilde 
yapılandırılmıştır. Daha sonra, sahte kimlik doğrulama bölümünde açıklandığı gibi, bu, testlerin 
uygulamanın ilk yanıtının sonucunu denetlemesini sağlar, ilk yanıt, Location üst bilgisiyle bu testlerin 
çoğunda bir yeniden yönlendirmelidir. 

3. Tipik bir test, isteği ve yanıtı işlemek için HttpClient ve yardımcı yöntemlerini kullanır: 

[Fact] 

public async Task Post_DeleteAllMessagesHandler_ReturnsRedirectToRoot() 

{ 

// Arrange 

var defaultPage = await _client.GetAsync("/"); 

var content = await HtmlHelpers.GetDocumentAsync(defaultPage); 

/ / Act 

var response = await _client.SendAsync( 

(IHtmlFormElement)content.QuerySelector("form[id='messages ']"), 

(IHtmlButtonElement)content.QuerySelector("button[id=' deleteAHBtn']")); 

// Assert 

Assert.Equal(HttpStatusCode.OK, defaultPage.StatusCode); 

Assert.Equal(HttpStatusCode.Redirect, response.StatusCode); 

Assert.Equal("/"j response.Headers.Location.OriginalString); 

} 


SUT 'a yönelik herhangi bir POST isteği, uygulamanın veri koruma antiforgery sistemitarafından otomatik 












olarak oluşturulan antiforgery denetimini karşılamalıdır. Bir testin POST isteğini düzenlemek için test 
uygulaması şunları kullanmalıdır: 

1. Sayfa için bir istek oluşturun. 

2. Antiforgery tanımlama bilgisini ayrıştırın ve yanıt doğrulama belirtecini istekten isteyin. 

3. POST isteğini, antiforgery tanımlama bilgisiyle ve istek doğrulama belirteciyle birlikte yapın. 

Örnek uygulamadaki SendAsync yardımcı uzantı yöntemleri ( yardımcılar/Httpclienconversionsions. cs) ve 
GetDocumentAsync yardımcı yöntemi ( yardımcılar/htmlyardımcıları. cs ), Aşağıdaki Yöntemler: 


GetDocumentAsync 

- HttpResponseMessage 'yi alır ve bir 

IHtmlDocument 

döndürür. 

GetDocumentAsync , 


özgün HttpResponseMessage göre sanal bir Yanıt hazırlayan bir fabrika kullanır. Daha fazla bilgi için bkz. 

Anglesharp belgeleri. 

• Httpciient için SendAsync genişletme yöntemleri bir HttpRequestMessage oluşturun ve istekleri sut 'e 
göndermek İçin sendadsync (HttpRequestMessage) çağrısı yapın. SendAsync için aşırı yüklemeler HTML 
formunu ( iHtmiFonmElement ) ve aşağıdakileri kabul eder: 
o Formun Gönder düğmesi ( iHtmiElement ) 

o Form değerleri koleksiyonu ( IEnumerable<KeyValuePair<stringj string>> ) 

o Gönder düğmesi ( İHtmiElement ) ve form değerleri ( IEnumerable<KeyValuePair<string, string>> ) 


NOTE 

Anglesharp , bu konuda ve örnek uygulamada Gösterim amacıyla kullanılan bir üçüncü taraf ayrıştırma kitaplığıdır. 
ASP.NET Core uygulamalarının tümleştirme testi için AngleSharp desteklenmez veya gerekli değildir. Diğer 
çözümleyiciler, HTML çevikliği paketi (HAP)gibi kullanılabilir. Diğer bir yaklaşım ise, antiforgery sisteminin istek 
doğrulama belirtecini ve antiforgery tanımlama bilgisini doğrudan işlemek için kod yazmaktır. 


WithWebHostBuilder ile istemciyi özelleştirme 

Bir test yönteminde ek yapılandırma gerektiğinde, Withwebhostbuilder , yapılandırmaya göre daha fazla 
özelleştirilmiş bir ıvvebhostbuilder ile yeni bir uebAppiicationFactory oluşturur. 

Örnek uygulamanın Post_DeleteMessageHandler_ReturnsRedirectToRoot test yöntemi WithWebHostBuilder 
kullanımını gösterir. Bu test, SUT 'da form gönderimini tetikleyerek veritabanında silme işlemini 
gerçekleştirir. 

indexPageTests sınıftaki başka bir test, veritabanındaki tüm kayıtları silen ve 
Post_DeieteMessageHandier_ReturnsRedirectToRoot yönteminden önce çalışabilen bir işlem 
gerçekleştirdiğinden, SUT 'in silinmesine yönelik bir kaydın mevcut olduğundan emin olmak için veritabanı 
bu test yönteminde yeniden oluşturulur. SUT içindeki messages formunun ilk Sil düğmesini seçmek, SUT 
isteğine göre benzetilir: 














[Fact] 

public async Task Post_DeleteMessageHandler_ReturnsRedirectToRoot() 

{ 

// Arrange 

var Client = _factory.WithWebHostBuilder(builder => 

{ 

builder.ConfigureServices(Services => 

{ 

var serviceProvider = Services.BuildServiceProvider(); 

using (var scope = serviceProvider.CreateScope()) 

{ 

var scopedServices = scope.ServiceProvider; 
var db = scopedServices 

.GetRequiredService<ApplicationDbContext>(); 
var logger = scopedServices 

.GetRequiredService<ILogger<IndexPageTests>>(); 

try 

{ 

Utilities.ReinitializeDbForTests(db); 

} 

catch (Exception ex) 

{ 

logger.LogError(eXj "An error occurred seeding " + 

"the database with test messages. Error: {Message}", 
ex.Message); 

} 

} 

}); 

}) 

.CreateClient(new WebApplicationFactoryClientOptions 

{ 

AllowAutoRedirect = false 

}); 

var defaultPage = await Client.GetAsync("/"); 

var content = await HtmlFlelpers.GetDocumentAsync(defaultPage); 

/ / Act 

var response = await Client.SendAsync( 

(IHtmlFormElement)content.QuerySelector("form[id='messages ']"), 

(IHtmlButtonElement)content.QuerySelector("form[id='messages']") 

.QuerySelector("div[class='panel-body']") 

.QuerySelector("button")); 

// Assert 

Assert. Equal(FlttpStatusCode.OK J defaultPage.StatusCode); 

Assert. Equal(FlttpStatusCode. Redirect , response.StatusCode); 

Assert.Equal("/"j response.Headers.Location.OriginalString); 


İstemci seçenekleri 

Aşağıdaki tabloda Httpciient örnekleri oluşturulurken kullanılabilen varsayılan 

VVebapplicationfactorycIientoptions gösterilmektedir. 

SEÇENEK AÇIKLAMA VARSAYILAN 

Allovvoto yeniden yönlendirme Httpciient örneklerinin yeniden true 

yönlendirme yanıtlarını otomatik 
olarak izleyip ayarlamamayacağını alır 
veya ayarlar. 






SEÇENEK 


AÇIKLAMA 


VARSAYILAN 


BaseAddress 


Httpclient örneklerinin temel http://localhost 

adresini alır veya ayarlar. 


HandleCookies Httpclient örneklerinin tanımlama true 

bilgilerini işlemesinin gerekip 
gerekmediğini alır veya ayarlar. 

Maxautomaticyönlendirmeler Httpclient örneklerin izlemesi 7 

gereken en fazla yeniden yönlendirme 
yanıtı sayısını alır veya ayarlar. 

webAppiicationFactoryciientoptions sınıfını oluşturun ve Createclient yöntemine geçirin (varsayılan değerler 
kod örneğinde gösterilir): 

// Default Client option values are shown 

var clientOptions = new WebApplicationFactoryClientOptions(); 

clientOptions.AllowAutoRedirect = true; 

clientOptions.BaseAddress = new Uri("http://localhost"); 

clientOptions.HandleCookies = true; 

clientOptions.MaxAutomaticRedirections = 7; 

_client = _factory.CreateClient(clientOptions); 


Sahte hizmetler ekleme 

Hizmetler, ana bilgisayar tasarımcısında Configuretestservices çağrısıyla bir testte geçersiz kılınabilir. Sahte 
hizmetleri eklemek için SUT, startup.configureServices yöntemine sahip startup sınıfına sahip 
olmalıdır. 

Örnek SUT, bir teklif döndüren kapsamlı bir hizmet içerir.Dizin sayfası istendiğinde, teklif Dizin sayfasındaki 
gizli bir alana katıştırılır. 

HizmetlerAquoteservice. cs: 

public interface IQuoteService 

{ 

Task<string> GenerateQuote(); 

} 


Hizmetler/ÇuoteService. cs: 

// Quote ©1975 BBC: The Doctor (Tom Baker); Dr. Who: Planet of Evil 
// https://www.bbc.co.uk/programmes/p@0pyrx6 
public class QuoteService : IQuoteService 
{ 

public Task<string> GenerateQuote() 

{ 

return Task.FromResult<string>( 

"Come on, Sarah. We've an appointment in London, " + 
"and we're already 30,000 years late."); 

} 

} 


Startup.es : 













Services.AddScoped<IQuoteService, QuoteService>(); 


Pages/lndex. cshtmi cs: 

public class IndexModel : PageModel 

{ 

private readonly ApplicationDbContext _db; 
private readonly IQuoteService _quoteService; 

public IndexModel(ApplicationDbContext db, IQuoteService quoteService) 

{ 

_db = db; 

_quoteService = quoteService; 

} 

[BindProperty] 

public Message Message { get; set; } 

public IList<Message> Messages { get; private set; } 

[TempData] 

public string MessageAnalysisResult { get; set; } 

public string Quote { get; private set; } 

public async Task OnGetAsync() 

{ 

Messages = await _db.GetMessagesAsync(); 

Quote = await _quoteService.GenerateQuote(); 

} 


Sayfa/dizin, cs: 

cinput id="quote" type="hidden" value="@Model.Quote"> 


Aşağıdaki biçimlendirme, SUT uygulaması çalıştırıldığında oluşturulur: 

cinput id="quote" type="hidden" value="Come on, Sarah. We&#x27;ve an appointment in 
London, and we&#x27;re already 30,000 years late."> 


Bir tümleştirme testinde hizmet ve teklif ekleme işlemini test etmek için, test tarafından SUT 'ye bir sahte 
hizmet eklenir. Sahte hizmet, uygulamanın QuoteService ' ı, TestçuoteService adlı test uygulaması 
tarafından verilen bir hizmetle değiştirir: 

Integration Tests.lndexPage Tests.cs: 

II Quote ©1975 BBC: The Doctor (Tom Baker); Pyramids of Mars 
// https://www.bbc. co.uk/programmes/p00pys55 
public class TestQuoteService : IQuoteService 
{ 

public Task<string> GenerateQuote() 

{ 

return Task.FromResult<string>( 

"Something's interfering with time, Mr. Scarman, " + 

"and time is my business."); 

} 

} 








configureTestservices çağrılır ve kapsamlı hizmet kaydedilir: 


[Fact] 

public async Task Get_QuoteService_ProvidesQuoteInPage() 

{ 

// Arrange 

var Client = _factory .İAİithWebHostBuilder(builder => 

{ 

builder.ConfigureTestservices(Services => 

{ 

Services.AddScoped<IQuoteService, TestQuoteService>(); 

}); 

}) 

•CreateClient(); 

//Act 

var defaultPage = await Client.GetAsync("/"); 

var content = await HtmlHelpers.GetDocumentAsync(defaultPage); 

var quoteElement = content.QuerySelector("#quote"); 

// Assert 

Assert.Equal("Something's interfering with time, Mr. Scarman, " + 

"and time is my business.", quoteElement.Attributes["value"].Value); 

} 

Testin yürütülmesi sırasında üretilen biçimlendirme TestçuoteService tarafından sağlanan tırnak metnini 
yansıtır, bu nedenle onaylama işlemi geçirilir: 

cinput id="quote" type="hidden" value="Something&#x27;s interfering with time, 

Mr. Scarman, and time is my business."> 


Sahte kimlik doğrulaması 

AuthTests sınıftaki testler güvenli bir uç noktanın bulunup bulunmadığını denetler: 

• Kimliği doğrulanmamış bir kullanıcıyı uygulamanın oturum açma sayfasına yönlendirir. 

• Kimliği doğrulanmış bir kullanıcı için içerik döndürür. 

SUT 'de /securePage sayfası, sayfaya bir Authorizefilter uygulamak İçin bir authorizepage kuralı kullanır. 
Daha fazla bilgi için bkz. Razor Pages yetkilendirme kuralları. 

Services.AddRazorPages() 

. AddRazorPagesOptions(options => 

{ 

options.Conventions.AuthorizePage("/SecurePage"); 

}); 

Get_SecurePageRedirectsAnUnauthenticatedUser testinde, bir VVebapplicationfactorycIientoptions , false 
olarak allovvoto Redirect ayarlanarak yeniden yönlendirmeye izin vermez olarak ayarlanır: 










[Fact] 

public async Task Get_SecurePageRedirectsAnUnauthenticatedUser() 

{ 

// Arrange 

var Client = _factory.CreateClient( 

new WebApplicationFactoryClientOptions 

{ 

AllowAutoRedirect = false 

}); 

// Act 

var response = await Client.GetAsync("/SecurePage"); 

// Assert 

Assert.Equal(HttpStatusCode.Redirect , response.StatusCode); 

Assert.StartsWith("http://localhost/Identity/Account/Login", 
response.Headers.Location.OriginalString); 

} 

istemcinin yeniden yönlendirmeyi izlemeye izin vererek aşağıdaki denetimler yapılabilir: 

• SUT tarafından döndürülen durum kodu, oturum açma sayfasına yeniden yönlendirmeden sonra, 
HttpStatusCode. Tamamolacak şekilde, son durum koduna değil beklenen HttpStatusCode. Redirect 
sonucuyla denetlenebilir. 

• Yanıt üst bilgilerindeki Location üst bilgi değeri, Location üstbilgisinin mevcut olmadığı son oturum 
açma sayfası yanıtıyla değil http://iocaihost/identity/Account/Login ile başlayacağını doğrulamak üzere 
denetlenir. 

Test uygulaması, kimlik doğrulama ve yetkilendirme işlemlerini test etmek için Configuretestservices içindeki 
bir AuthenticationHandler<TOptions> sahte olabilir. En az bir senaryo, bir kimlik doğrulayan Poesult. 
Successdöndürür: 


public class TestAuthHandler : AuthenticationHandler<AuthenticationSchemeOptions> 

{ 

public TestAuthHandler(IOptionsMonitor<AuthenticationSchemeOptions> options, 

ILoggerFactory logger, UrlEncoder encoder, ISystemClock clock) 

: base(options, logger, encoder, clock) 

{ 

} 

pnotected override Task<AuthenticateResult> HandleAuthenticateAsync() 

{ 

var claims = new[] { new Claim(ClaimTypes.Name, "Test user") }; 
var identity = new Claimsldentity(claims, "Test"); 
var principal = new ClaimsPrincipal(identity); 
var ticket = new AuthenticationTicket(principalj "Test"); 

var result = AuthenticateResult.Success(ticket); 

return Task.FromResult(result); 

} 

} 

TestAuthHandler , kimlik doğrulama şeması, ConfigureTestServices için AddAuthentication kaydedildiği 
Test olarak ayarlandığında bir kullanıcının kimliğini doğrulamak için çağrılır: 








[Fact] 

public async Task Get_SecurePageIsReturnedForAnAuthenticatedUser() 

{ 

// Arrange 

var Client = _factory.WithWebHostBuilder(builder => 

{ 

builder.ConfigureTestServices(Services => 

{ 

Services.AddAuthentication("Test") 

. AddScheme< Aut hent icat ionSchemeOptions, Test Aut hFlandler>( 
"Test", options => {}); 

}); 

}) 

.CreateClient(new WebApplicationFactoryClientOptions 
{ 

AllowAutoRedirect = false, 

}); 

Client .Def aultRequestFleader s. Aut horization = 
new AuthenticationHeaderValue("Test"); 

/ / Act 

var response = await Client. GetAsync("/SecurePage"); 

// Assert 

Assert.Equal(FlttpStatusCode.OK, response.StatusCode); 


webAppiicationFactoryciientoptions hakkında daha fazla bilgi için istemci seçenekleri bölümüne bakın. 

Ortamı ayarlama 

Varsayılan olarak, SUT 'nin ana bilgisayar ve uygulama ortamı geliştirme ortamını kullanacak şekilde 
yapılandırılmıştır. SUT ortamını geçersiz kılmak için: 

• aspnetcore_environment ortam değişkenini ayarlayın (örneğin, staging , Production veya Testing gibi 
başka bir özel değer). 

• aspnetcore ön eki eklenmiş ortam değişkenlerini okumak için test uygulamasındaki createHostBuiider 
geçersiz kılın. 


protected override IHostBuilder CreateFlostBullder() => 
base.CreateHostBuilder() 

.ConfigureHostConfiguration( 

config => config.AddEnvironmentVariables("ASPNETCORE")); 


Test altyapısının uygulama içeriği kök yolunu nasıl öğrendiğini 


WebApplicationFactory 

Oluşturucusu, 

TEntryPoint 

bütünleştirilmiş 

System. Reflection.Assembly.FullName 


koduna eşit bir anahtarla tümleştirme testlerini içeren derlemede bir 

VVebapplicationfactorycontentrootattribute arayarak uygulama içeriği kök yolunu alır. Doğru anahtara sahip 
bir özniteliğin bulunamaması durumunda, webAppiicationFactory bir çözüm dosyasını (. sin) aramaya geri 
döner ve TEntryPoint derleme adını çözüm dizinine ekler. Uygulama kök dizini (içerik kök yolu) görünümleri 
ve içerik dosyalarını saptamak için kullanılır. 

Gölge kopyalamayı devre dışı bırak 

Gölge kopyalama, testlerin çıkış dizininden farklı bir dizinde yürütülmesine neden olur.Testlerin düzgün 
çalışması için gölge kopyalama devre dışı bırakılmalıdır. Örnek uygulama xUnit kullanır ve doğru 














yapılandırma ayarıyla bir xUnit. Runner. JSON dosyası ekleyerek xUnit için gölge kopyalamayı devre dışı 
bırakır. Daha fazla bilgi için bkz. JSON İlexllnit yapılandırma. 

Aşağıdaki içeriğe sahip test projesinin köküne xUn'ıt. Runner. JSON dosyasını ekleyin: 

{ 

"shadowCopy": false 

} 


Nesnelerin elden çıkarılması 

ıciassFixture uygulamasının testleri yürütüldükten sonra, TestServer ve HttpClient , 
vvebapplicationfactory'nin xllnit 'i çıkardığı zaman yürütülür.Geliştirici tarafından oluşturulan nesneler için 
aktiften çıkarma gerekiyorsa, bunları ıciassFixture uygulamasında atın. Daha fazla bilgi için bkz. Dispose 
yöntemi uygulama. 

Tümleştirme Testleri örneği 

Örnek uygulama iki uygulamalardan oluşur: 

UYGULAMANIZDA PROJE DİZİNİ AÇIKLAMA 

ileti uygulaması (SUT) src/RazorPagesProject Bir kullanıcının, iletileri eklemesini, 

silmesini, silmesini ve analiz etmesini 
sağlar. 

Test uygulaması testler/RazorPagesProject. testler SUT test tümleştirmesi için kullanılır. 

Testler, Visual Studiogıbı bir IDE 'nin yerleşik test özellikleri kullanılarak çalıştırılabilir. Visual Studio Code 
veya komut satırı kullanıyorsanız, testler/RazorPagesProject. Tests dizinindeki bir komut isteminde aşağıdaki 
komutu yürütün: 

dotnet test 

İleti uygulaması (SUT) kuruluşu 

SUT, aşağıdaki özelliklere sahip bir Razor Pages ileti sistemidir: 

• Uygulamanın ( Pages/lndex. cshtml ve Pages/index. cshtml. cs ) dizin sayfası, iletilerin eklenmesi, 
silinmesini ve ANALİZİNİ denetlemek için bir Ul ve sayfa modeli yöntemleri sağlar (ileti başına ortalama 
sözcük). 

• Bir ileti, iki özellik içeren Message sınıfı (Data/Message. cs) tarafından tanımlanır: id (anahtar) ve Text 
(ileti). Text özelliği gereklidir ve 200 karakterle sınırlıdır. 

• iletiler, Entity Framevvork bellek içi veritabanı+kullanılarak depolanır. 

• Uygulama, AppDbContext ( Data/AppDbContext. cs) veritabanı bağlamı sınıfında bir veri erişim KATMANı 
(dal) içerir. 

• Veritabanı uygulama başlangıcında boşsa, ileti deposu üç iletiyle başlatılır. 

• Uygulama yalnızca kimliği doğrulanmış bir kullanıcı tarafından erişilebilen bir /securePage içerir. 

tlnMemory İle testolan EF konusu, MSTest ile testler için bellek içi bir veritabanının nasıl kullanılacağını 
açıklar. Bu konu xUnit test çerçevesini kullanır. Farklı test çerçeveleri genelinde test kavramları ve test 
uygulamaları benzerdir ancak aynı değildir. 

Uygulama, depo desenini kullanmıyor ve İş birimi (UoW) düzenininetkin bir örneği olmamasına karşın, 












Razor Pages bu geliştirme düzenlerini destekler. Daha fazla bilgi için bkz. altyapı Kalıcılık katmanını 
tasarlama ve Test denetleyicisi mantığı (örnek, depo modelini uygular). 

Test uygulaması kuruluşu 

Test uygulaması, testler/RazorPagesProject. Tests dizini içindeki bir konsol uygulamasıdır. 


UYGULAMA DİZİNİNİ TEST ET 

AÇIKLAMA 

AuthTests 

için test yöntemleri içerir: 

• Güvenli bir sayfaya, kimliği doğrulanmamış bir 
kullanıcıyla erişme. 

• Bir sahte AuthenticationHandler<TOptions> kimliği 
doğrulanmış bir kullanıcı tarafından güvenli bir 
sayfaya erişme. 

• GitHub kullanıcı profilini alma ve profilin Kullanıcı 
oturum açma bilgilerini denetleme. 

BasicTests 

Yönlendirme ve içerik türü için bir test yöntemi içerir. 

Tümleştirme Testleri 

Özel webApplicationFactory sınıfı kullanarak dizin 
sayfasına yönelik tümleştirme testlerini içerir. 


Yardımcılar/yardima programlar • Utilities.es , veritabanını test verileriyle tohum için 

kullanılan initializeDbForTests metodunu içerir. 

• HtmlHelpers.es , test yöntemleri tarafından 
kullanılmak üzere AngleSharp mtmlDocument 
döndüren bir yöntem sağlar. 

• HttpClientExtensions.cs , istekleri sut 'a göndermek 
için sendAsync için aşırı yüklemeler sağlar. 


Test çerçevesi xUnit' dir. Tümleştirme testleri, TestS erveriçeren Microsoft. Aspnetcore. testhostkullanılarak 
yürütülür. Test ana bilgisayarı ve test sunucusunu yapılandırmak için Microsoft. AspNetCore. Mvc. Testing 
paketi kullanıldığından, TestHost ve Testserver paketleri test uygulamasının proje dosyasında ya da 
testteki geliştirici yapılandırmasında doğrudan paket başvuruları gerektirmez uygulamanızda. 

Test için veritabanının temelini sağlama 

Tümleştirme testleri genellikle veritabanında test yürütmeden önce küçük bir veri kümesi gerektirir.Örneğin, 
veritabanı kaydı silme için bir silme testi çağrılarında, silme isteğinin başarılı olması için veritabanının en az 
bir kaydı olmalıdır. 

Örnek uygulama, Utilities.es içinde testlerin, yürütme sırasında kullanabileceği üç iletiyle birlikte veritabanını 
kullanır: 









public static void InitializeDbFonTests(ApplicationDbContext db) 

{ 

db.Messages.AddRange(GetSeedingMessages()); 
db.SaveChanges(); 

} 

public static void ReinitializeDbForTests(ApplicationDbContext db) 

{ 

db.Messages.RemoveRange(db.Messages); 

InitializeDbForTests(db); 

} 

public static List<Message> GetSeedingMessages() 

{ 

return new List<Message>() 

{ 

new Message(){ Text = "TEST RECORD: You're standing on my scarf." }, 
new Message(){ Text = "TEST RECORD: Would you like a jelly baby?" }, 
new Message(){ Text = "TEST RECORD: To the rational mind, " + 

"nothing is inexplicable; only unexplained." } 

}; 

} 

SUT 'un veritabanı bağlamı stantup.configuneSenvices yönteminde kayıtlı. Uygulamanın 
Stantup.ConfiguneServices kodu yürütüldükten sonra , test uygulamasının builder.ConfigureServices geri 
çağırması yürütülür. Testler için farklı bir veritabanı kullanmak istiyorsanız, uygulamanın veritabanı bağlamı 
builder.ConfigureServices ' da değiştirilmelidir. Daha fazla bilgi için, VVebApplicationFactory 'Yi özelleştirme 
bölümüne bakın. 

Tümleştirme sınamaları, uygulamanın bileşenlerinin veritabanı, dosya sistemi ve ağ gibi destekleyici 
altyapısını içeren bir düzeyde doğru şekilde çalışmasını güvence altına alır. ASP.NET Core, test Web ana 
bilgisayarı ve bellek içi test sunucusu olan bir birim testi çerçevesini kullanarak tümleştirme testlerini 
destekler. 

Bu konuda, birim testlerinin temel bir şekilde anlaşıldığı varsayılır.Test kavramları hakkında bilgi sahibi 
değilseniz, .NET Core 'Da birim testine ve .NET Standard konusuna ve bağlı içeriğine bakın. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Örnek uygulama bir Razor Pages uygulamasıdır ve Razor Pages temel bir anlama sahip olduğunu varsayar. 
Razor Pages hakkında bilginiz yoksa, aşağıdaki konulara bakın: 

• Razor Pages'e giriş 

• Razor Sayfaları kullanmaya başlama 

• Razor Sayfaları birim testleri 


NOTE 

Maça ’Ları test etmek için, bir tarayıcıyı otomatikleştirebilen Seleniumgibi bir araç öneririz. 


Tümleştirme testlerine giriş 

Tümleştirme testleri, bir uygulamanın bileşenlerini birim testlerindendaha geniş bir düzeyde değerlendirir. 
Birim testleri, ayrı sınıf yöntemleri gibi yalıtılmış yazılım bileşenlerini test etmek için kullanılır.Tümleştirme 
testleri iki veya daha fazla uygulama bileşeninin beklenen bir sonuç üretmek için birlikte çalıştığını ve 
muhtemelen bir isteği tam olarak işlemek için gereken her bileşeni de dahil olduğunu onaylar. 

Bu geniş testler, uygulamanın altyapısını ve tüm çatısını test etmek için kullanılır, genellikle aşağıdaki 










bileşenler dahil: 

• Veritabanı 

• Dosya sistemi 

• Ağ gereçleri 

• istek-yanıt işlem hattı 

Birim testleri, altyapı bileşenlerinin yerine, Fakes veya sahte nesnelero larak bilinen fabriccomponents 
bileşenlerini kullanır. 

Birim testlerinin aksine, tümleştirme testleri: 

• Uygulamanın üretimde kullandığı gerçek bileşenleri kullanın. 

• Daha fazla kod ve veri işleme gerektir. 

• Çalıştırmak daha uzun sürer. 

Bu nedenle, tümleştirme testlerinin kullanımını en önemli altyapı senaryolarıyla sınırlayın. Bir davranış, birim 
testi veya tümleştirme testi kullanılarak test edilebilir ise, birim testini seçin. 


TIP 

Veritabanları ve dosya sistemleriyle ilgili her olası veri ve dosya erişimi için tümleştirme testleri yazma. Bir 
uygulamadaki kaç yerde veritabanlarıyla ve dosya sistemleriyle etkileşime girdiğinize bakılmaksızın, bir dizi Read, Write, 
Update ve DELETE tümleştirme testi, genellikle veritabanı ve dosya sistemi bileşenlerinin yeterli şekilde test edilmesine 
sahip olur. Bu bileşenlerle etkileşime geçen Yöntem mantığının rutin testleri için birim testleri kullanın. Birim testlerinde, 
altyapı kullanımı ve moizler 'in kullanılması daha hızlı test yürütmesiyle sonuçlanır. 


NOTE 

Tümleştirme testlerinin tartışmalarında, test edilen proje genellikle test altındaki sistemce ya kısa İÇİN "sut" olarak 
adlandırılır. 

Bu konu başlığı altında, sınanan ASRNET Core uygulamasına başvurmak için "SUT" kullanılır. 


ASP.NET Core tümleştirme testleri 

AS P.N ET Core tümleştirme testleri şunları gerektirir: 

• Testleri içermesi ve yürütmek için bir test projesi kullanılır.Test projesinin SUT 'a bir başvurusu vardır. 

• Test projesi SUT için bir test Web Konağı oluşturur ve SUT ile istekleri ve yanıtları işlemek için bir test 
sunucusu istemcisi kullanır. 

• Test Çalıştırıcısı, testleri yürütmek ve test sonuçlarını raporlamak için kullanılır. 

Tümleştirme testleri, olağan düzenleme, hareketve onaylama testi adımlarını içeren bir olay dizisini izler: 

1. SUT 'un web ana bilgisayarı yapılandırıldı. 

2. istekleri uygulamaya göndermek için bir test sunucusu istemcisi oluşturulur. 

3. Testi Düzenle adımı yürütülür: test uygulaması bir istek hazırlar. 

4. Davran test adımı yürütülür: istemci, isteği gönderir ve yanıtını alır. 

5. Onaylama testi adımı yürütülür: Gerçek yanıt, beklenen bir yanıta bağlı olarak başarılı veya başarısız 
olarak onaylanır. 

6. İşlem, tüm testler yürütülene kadar devam eder. 

7. Test sonuçları raporlanır. 










Genellikle, test Web ana bilgisayarı, test çalıştırmaları için uygulamanın normal web ana bilgisayarında farklı 
şekilde yapılandırılır. Örneğin, testler için farklı bir veritabanı veya farklı uygulama ayarları kullanılıyor 
olabilir. 

Test Web Konağı ve bellek içi test sunucusu (TestServer) gibi altyapı bileşenleri, Microsoft. Aspnetcore. Mvc. 
Testing paketi tarafından sağlanır veya yönetilir. Bu paketin kullanımı, test oluşturma ve yürütmeyi 
kolaylaştırır. 

Microsoft.AspNetcore.Mvc.Testing paketi aşağıdaki görevleri gerçekleştirir: 

• Bağımlılıklar dosyasını (. Deps) sut 'den test projesinin bin dizinine kopyalar. 

• , Testler yürütüldüğünde statik dosya ve sayfa/görünümlerin bulunması için içerik kökünü sut 'nin proje 
köküne ayarlar. 

• TestServer ile SUT önyükleyiciyi kolaylaştırmak için VVebapplicationfactory sınıfını sağlar. 

Birim testi belgeleri bir test projesi ve Test Çalıştırıcısı ayarlamayı ve testlerin ve test sınıflarının nasıl 
belirleneceğini gösteren testlerin ve önerilerin nasıl çalıştırılacağını gösteren ayrıntılı yönergelerle birlikte 
açıklanır. 


NOTE 

Bir uygulama için test projesi oluştururken, birim testlerini tümleştirme testlerinden farklı projelere ayırın. Bu, altyapı 
testi bileşenlerinin birim testlerine yanlışlıkla dahil olmamasını sağlamaya yardımcı olur. Birim ve tümleştirme testlerinin 
ayrımı, hangi test kümesinin çalıştırılmasına da izin verir. 


Razor Pages Apps ve MVC uygulamalarının testleri için yapılandırma arasında neredeyse fark yoktur.Tek 
fark testlerin adlandırılmasınlardır. Razor Pages uygulamasında, sayfa uç noktalarının testleri genellikle sayfa 
modeli sınıfından sonra adlandırılır (örneğin, dizin sayfasına yönelik bileşen tümleştirmesini test etmek için 
indexPageTests ). MVC uygulamasında testler genellikle denetleyici sınıfları tarafından düzenlenir ve test 
ettikleri denetleyiciler (örneğin, ana denetleyicinin bileşen tümleştirmesini test etmek için 
HomeControllerTests ). 


Test uygulaması önkoşulları 

Test projesi şunları vermelidir: 

• Aşağıdaki paketlere başvurun: 
o Microsoft. AspNetCore. app 

o Microsoft. AspNetCore. Mvc. test 

• Proje dosyasında Web SDK 'sini belirtin ( <Project sdk="Microsoft.NET.sdk.web"> ). Microsoft. 
AspNetCore. app metapackage'e başvururken Web SDK 'sı gereklidir. 

Bu Önkoşullar örnek uygulamadagörülebilir. Testler/RazorPagesProject. Tests/RazorPagesProject. Tests. 
csproj dosyasını inceleyin. Örnek uygulama, xUnit test çerçevesini ve anglesharp Parser kitaplığını kullanır, 
bu nedenle örnek uygulama de şu şekilde başvurur: 

• xUnit 

• xUnit. Çalıştırıcısı. VisualStudio 

• AngleSharp 

SUT ortamı 

SUT ortamı ayarlanmamışsa, ortam varsayılan olarak geliştirme olur. 










Varsayılan VVebApplicationFactory ile temel testler 

VVebapplicationfactory <TEntryPoint > , tümleştirme testleri İçin bir TestServer oluşturmak üzere kullanılır. 
TEntryPoint , genellikle startup sınıfının SUT giriş noktası sınıfıdır. 

Test sınıfları sınıfı testlerin içerdiğini göstermek ve sınıftaki testler arasında paylaşılan nesne örnekleri 
sağlamak için bir sınıf armatürü arabirimi (ıssfixture) uygular. 


Aşağıdaki test sınıfı BasicTests , S UT 'yi önyüklemek ve bir test yöntemine HttpClient sağlamak için 
WebApplicationFactory kullanır Get_EndpointsReturnSuccessAndCorrectContentType . Yöntemi, yanıt durum 
kodunun başarılı olup olmadığını denetler (200-299 aralığındaki durum kodları) ve Content-Type üstbilgisi 
çeşitli uygulama sayfaları için text/htmi; charset=utf-8 1 dir. 


Createclient, yeniden yönlendirmeleri otomatik olarak izleyen ve tanımlama bilgilerini işleyen bir 
HttpClient örneği oluşturur. 

public class BasicTests 

: IClassFixture<WebApplicationFactory<RazorPagesProject.Startup>> 

{ 

private readonly WebApplicationFactory<RazorPagesProject.Startup> _factory; 

public BasicTests(WebApplicationFactory<RazorPagesProject.Startup> factory) 

{ 

_factory = factory; 

} 

[Theory] 

[InlineData("/")] 

[InlineData("/Index")] 

[InlineData("/About")] 

[InlineData("/Privacy")] 

[InlineData("/Contact")] 

public async Task Get_EndpointsReturnSuccessAndCorrectContentType(string url) 

{ 

// Arrange 

var Client = _factory.CreateClient(); 

// Act 

var response = await Client .GetAsync(url); 

// Assert 

response.EnsureSuccessStatusCode(); // Status Code 200-299 
Assert.Equal("text/html; charset=utf-8", 

response.Content.Headers.ContentType.ToStringO); 

} 

} 


Varsayılan olarak, GDPR onay ilkesi etkinleştirildiğinde, önemli olmayan tanımlama bilgileri istekler arasında 
korunmaz. TempData sağlayıcısı tarafından kullanılanlar gibi, önemli olmayan tanımlama bilgilerini korumak 
için, bunları testlerinizde gerekli olarak işaretleyin. Tanımlama bilgisini önemli olarak işaretleme hakkında 
yönergeler için bkz. temel tanımlama bilgileri. 

VVebApplicationFactory 'yi özelleştirme 

Web ana bilgisayar yapılandırması, bir veya daha fazla özel fabrika oluşturmak için webAppiicationFactory 1 
dan devralarak test sınıflarından bağımsız olarak oluşturulabilir: 

1 . webAppiicationFactory 'den devralma ve Configurevvebhost'i geçersiz kılma. Ivvebhostbuilder , hizmet 
koleksiyonunun ConfigureServicesile yapılandırılmasına izin verir: 









public class CustomWebApplicationFactory<TStartup> 

: WebApplicationFactory<TStartup> where TStartup: class 

{ 

protected override void ConfigureWebHost(IWebHostBuilder builder) 

{ 

builder.ConfigureServices(Services => 

{ 

// Create a new service provider. 

var serviceProvider = new ServiceCollection() 

.AddEntityFrameworkInMemoryDatabase() 

.BuildServiceProvider(); 

// Add a database context (ApplicationDbContext) using an in-memory 
// database for testing. 

Services.AddDbContext<ApplicationDbContext>(options => 

{ 

options.UseInMemoryDatabase("InMemoryDbForTesting"); 
options.UseInternalServiceProvider(serviceProvider); 

}); 

// Build the service provider. 

var sp = Services.BuildServiceProvider(); 

// Create a scope to obtain a reference to the database 
// context (ApplicationDbContext). 
using (var scope = sp.CreateScope()) 

{ 

var scopedServices = scope.ServiceProvider; 

var db = scopedServices.GetRequiredService<ApplicationDbContext>(); 
var logger = scopedServices 

.GetRequiredService<ILogger<CustomWebApplicationFactory<TStartup>>>(); 

// Ensure the database is created. 
db.Database.EnsureCreated(); 

try 

{ 

// Seed the database with test data. 

Utilities.InitializeDbForTests(db); 

} 

catch (Exception ex) 

{ 

logger.LogError(eXj "An error occurred seeding the database. Error: 
{Message}", ex.Message); 

} 

} 

}); 

} 

} 

Örnek uygulamadaki veritabanı dengeli dağıtımı initializeDbForTests yöntemi tarafından 
gerçekleştirilir. Yöntemi, tümleştirme testleri örneği: test uygulaması kuruluşu bölümünde 
açıklanmaktadır. 

2. Test sınıflarında özel customwebAppiicationFactory kullanın. Aşağıdaki örnek indexPageTests sınıfında 
fabrikası kullanır: 






public class IndexPageTests : 

IClassFixture<CustomWebApplicationFactory<RazorPagesProject.Startup>> 

{ 

private readonly FlttpClient _client; 

private readonly CustomWebApplicationFactory<RazorPagesProject.Startup> 

_factory; 

public IndexPageTests( 

CustomWebApplicationFactory<RazorPagesProject.Startup> factory) 

{ 

_factory = factory; 

_client = factory.CreateCllent(new WebApplicationFactoryClientOptions 

{ 

AllowAutoRedirect = false 

}); 

} 

Örnek uygulamanın istemcisi, aşağıdaki yeniden yönlendirmelere Httpciient ' i engelleyecek şekilde 
yapılandırılmıştır. Daha sonra, sahte kimlik doğrulama bölümünde açıklandığı gibi, bu, testlerin 
uygulamanın ilk yanıtının sonucunu denetlemesini sağlar, ilk yanıt, Location üst bilgisiyle bu testlerin 
çoğunda bir yeniden yönlendirmelidir. 

3. Tipik bir test, isteği ve yanıtı işlemek için Httpciient ve yardımcı yöntemlerini kullanır: 

[Fact] 

public async Task Post_DeleteAllMessagesHandler_ReturnsRedirectToRoot() 

{ 

// Arrange 

var defaultPage = await _client.GetAsync("/"); 

var content = await HtmlHelpers.GetDocumentAsync(defaultPage); 

/ / Act 

var response = await _client.SendAsync( 

(IHtmlFormElement)content.QuerySelector("form[id=’messages ']"), 

(IHtmlButtonElement) content .QuerySelector("button[id=' deleteAHBtn']")); 

// Assert 

Assert.Equal(HttpStatusCode.OK, defaultPage.StatusCode); 

Assert.Equal(HttpStatusCode.Redirect , response.StatusCode); 

Assert.Equal("/"j response.Headers.Location.OriginalString); 

} 


SUT 'a yönelik herhangi bir POST isteği, uygulamanın veri koruma antiforgery sistemitarafından otomatik 
olarak oluşturulan antiforgery denetimini karşılamalıdır. Bir testin POST isteğini düzenlemek için test 
uygulaması şunları kullanmalıdır: 

1. Sayfa için bir istek oluşturun. 

2. Antiforgery tanımlama bilgisini ayrıştırın ve yanıt doğrulama belirtecini istekten isteyin. 

3. POST isteğini, antiforgery tanımlama bilgisiyle ve istek doğrulama belirteciyle birlikte yapın. 

Örnek uygulamadaki SendAsync yardımcı uzantı yöntemleri ( yardımcılar/Httpclienconversionsions. cs) ve 
GetDocumentAsync yardımcı yöntemi ( yardımcılar/htmlyardımcıları. cs ), Aşağıdaki Yöntemler: 


GetDocumentAsync 

- HttpResponseMessage 'yi alır ve bir 

IHtmlDocument 

döndürür. 

GetDocumentAsync , 


özgün HttpResponseMessage göre sanal bir Yanıt hazırlayan bir fabrika kullanır. Daha fazla bilgi için bkz. 

Anglesharp belgeleri. 

• Httpciient için SendAsync genişletme yöntemleri bir HttpRequestMessage oluşturun ve istekleri sut 'e 
göndermek İçin sendadsync (HttpRequestMessage) çağrısı yapın. SendAsync için aşırı yüklemeler HTML 
formunu ( IHtmlFormElement ) ve aşağıdakileri kabul eder: 


















WithWebHostBuilder ile istemciyi özelleştirme 

Bir test yönteminde ek yapılandırma gerektiğinde, Withwebhostbuilder , yapılandırmaya göre daha fazla 
özelleştirilmiş bir ıvvebhostbuilder ile yeni bir webAppiicationFactory oluşturur. 

Örnek uygulamanın PostJDeleteMessageHandler^ReturnsRedirectToRoot test yöntemi WithWebHostBuilder 
kullanımını gösterir. Bu test, SUT 'da form gönderimini tetikleyerek veritabanında silme işlemini 
gerçekleştirir. 

indexPageîests sınıftaki başka bir test, veritabanındaki tüm kayıtları silen ve 
Post_DeieteMessageHandier_ReturnsRedirectToRoot yönteminden önce çalışabilen bir işlem 
gerçekleştirdiğinden, SUT 'in silinmesine yönelik bir kaydın mevcut olduğundan emin olmak için veritabanı 
bu test yönteminde yeniden oluşturulur. SUT içindeki messages formunun ilk Sil düğmesini seçmek, SUT 
isteğine göre benzetilir: 










[Fact] 

public async Task Post_DeleteMessageHandler_ReturnsRedirectToRoot() 

{ 

// Arrange 

var Client = _factory.WithWebHostBuilder(builder => 

{ 

builder.ConfigureServices(Services => 

{ 

var serviceProvider = Services.BuildServiceProvider(); 

using (var scope = serviceProvider.CreateScope()) 

{ 

var scopedServices = scope.ServiceProvider; 
var db = scopedServices 

.GetRequiredService<ApplicationDbContext>(); 
var logger = scopedServices 

.GetRequiredService<ILogger<IndexPageTests>>(); 

try 

{ 

Utilities.ReinitializeDbForTests(db); 

} 

catch (Exception ex) 

{ 

logger.LogError(eXj "An error occurred seeding " + 

"the database with test messages. Error: {Message}" + 
ex.Message); 

} 

} 

}); 

}) 

.CreateClient(new WebApplicationFactoryClientOptions 

{ 

AllowAutoRedirect = false 

}); 

var defaultPage = await Client.GetAsync("/"); 

var content = await HtmlFlelpers.GetDocumentAsync(defaultPage); 

/ / Act 

var response = await Client.SendAsync( 

(IHtmlFormElement)content.QuerySelector("form[id='messages ']"), 

(IHtmlButtonElement)content.QuerySelector("form[id='messages']") 

.QuerySelector("div[class='panel-body']") 

.QuerySelector("button")); 

// Assert 

Assert. Equal(FlttpStatusCode.OK J defaultPage.StatusCode); 

Assert. Equal(FlttpStatusCode. Redirect , response.StatusCode); 

Assert.Equal("/"j response.Headers.Location.OriginalString); 


İstemci seçenekleri 

Aşağıdaki tabloda Httpciient örnekleri oluşturulurken kullanılabilen varsayılan 

VVebapplicationfactorycIientoptions gösterilmektedir. 

SEÇENEK AÇIKLAMA VARSAYILAN 

Allovvoto yeniden yönlendirme Httpciient örneklerinin yeniden true 

yönlendirme yanıtlarını otomatik 
olarak izleyip ayarlamamayacağını alır 
veya ayarlar. 






SEÇENEK 


AÇIKLAMA 


VARSAYILAN 


BaseAddress 


Httpclient örneklerinin temel http://localhost 

adresini alır veya ayarlar. 


HandleCookies Httpclient örneklerinin tanımlama true 

bilgilerini işlemesinin gerekip 
gerekmediğini alır veya ayarlar. 

Maxautomaticyönlendirmeler Httpclient örneklerin izlemesi 7 

gereken en fazla yeniden yönlendirme 
yanıtı sayısını alır veya ayarlar. 

webAppiicationFactoryciientoptions sınıfını oluşturun ve Createclient yöntemine geçirin (varsayılan değerler 
kod örneğinde gösterilir): 

// Default Client option values are shown 

var clientOptions = new WebApplicationFactoryClientOptions(); 

clientOptions.AllowAutoRedirect = true; 

clientOptions.BaseAddress = new Uri("http://localhost"); 

clientOptions.HandleCookies = true; 

clientOptions.MaxAutomaticRedirections = 7; 

_client = _factory.CreateClient(clientOptions); 


Sahte hizmetler ekleme 

Hizmetler, ana bilgisayar tasarımcısında Configuretestservices çağrısıyla bir testte geçersiz kılınabilir. Sahte 
hizmetleri eklemek için SUT, startup.configureServices yöntemine sahip startup sınıfına sahip 
olmalıdır. 

Örnek SUT, bir teklif döndüren kapsamlı bir hizmet içerir.Dizin sayfası istendiğinde, teklif Dizin sayfasındaki 
gizli bir alana katıştırılır. 

HizmetlerAquoteservice. cs: 

public interface IQuoteService 

{ 

Task<string> GenerateQuote(); 

} 


Hizmetler/ÇuoteService. cs: 

// Quote ©1975 BBC: The Doctor (Tom Baker); Dr. Who: Planet of Evil 
// https://www.bbc.co.uk/programmes/p@0pyrx6 
public class QuoteService : IQuoteService 
{ 

public Task<string> GenerateQuote() 

{ 

return Task.FromResult<string>( 

"Come on, Sarah. We've an appointment in London, " + 
"and we're already 30,000 years late."); 

} 

} 


Startup.es : 













Services.AddScoped<IQuoteService, QuoteService>(); 


Pages/lndex. cshtmi cs: 

public class IndexModel : PageModel 

{ 

private readonly ApplicationDbContext _db; 
private readonly IQuoteService _quoteService; 

public IndexModel(ApplicationDbContext db, IQuoteService quoteService) 

{ 

_db = db; 

_quoteService = quoteService; 

} 

[BindProperty] 

public Message Message { get; set; } 

public IList<Message> Messages { get; private set; } 

[TempData] 

public string MessageAnalysisResult { get; set; } 

public string Quote { get; private set; } 

public async Task OnGetAsync() 

{ 

Messages = await _db.GetMessagesAsync(); 

Quote = await _quoteService.GenerateQuote(); 

} 


Sayfa/dizin, cs: 

cinput id="quote" type="hidden" value="@Model.Quote"> 


Aşağıdaki biçimlendirme, SUT uygulaması çalıştırıldığında oluşturulur: 

cinput id="quote" type="hidden" value="Come on, Sarah. We&#x27;ve an appointment in 
London, and we&#x27;re already 30,000 years late."> 


Bir tümleştirme testinde hizmet ve teklif ekleme işlemini test etmek için, test tarafından SUT 'ye bir sahte 
hizmet eklenir. Sahte hizmet, uygulamanın QuoteService ' ı, TestçuoteService adlı test uygulaması 
tarafından verilen bir hizmetle değiştirir: 

Integration Tests.lndexPage Tests.cs: 

II Quote ©1975 BBC: The Doctor (Tom Baker); Pyramids of Mars 
// https://www.bbc. co.uk/programmes/p00pys55 
public class TestQuoteService : IQuoteService 
{ 

public Task<string> GenerateQuote() 

{ 

return Task.FromResult<string>( 

"Something's interfering with time, Mr. Scarman, " + 

"and time is my business."); 

} 

} 








configureTestservices çağrılır ve kapsamlı hizmet kaydedilir: 


[Fact] 

public async Task Get_QuoteService_ProvidesQuoteInPage() 

{ 

// Arrange 

var Client = _factory .İAİithWebHostBuilder(builder => 

{ 

builder.ConfigureTestservices(Services => 

{ 

Services.AddScoped<IQuoteService, TestQuoteService>(); 

}); 

}) 

•CreateClient(); 

//Act 

var defaultPage = await Client.GetAsync("/"); 

var content = await HtmlHelpers.GetDocumentAsync(defaultPage); 

var quoteElement = content.QuerySelector("#quote"); 

// Assert 

Assert.Equal("Something's interfering with time, Mr. Scarman, " + 

"and time is my business.", quoteElement.Attributes["value"].Value); 

} 

Testin yürütülmesi sırasında üretilen biçimlendirme TestçuoteService tarafından sağlanan tırnak metnini 
yansıtır, bu nedenle onaylama işlemi geçirilir: 

cinput id="quote" type="hidden" value="Something&#x27;s interfering with time, 

Mr. Scarman, and time is my business."> 


Sahte kimlik doğrulaması 

AuthTests sınıftaki testler güvenli bir uç noktanın bulunup bulunmadığını denetler: 

• Kimliği doğrulanmamış bir kullanıcıyı uygulamanın oturum açma sayfasına yönlendirir. 

• Kimliği doğrulanmış bir kullanıcı için içerik döndürür. 

SUT 'de /securePage sayfası, sayfaya bir Authorizefilter uygulamak İçin bir authorizepage kuralı kullanır. 
Daha fazla bilgi için bkz. Razor Pages yetkilendirme kuralları. 

Services. AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2) 

.AddRazorPagesOptions(options => 

{ 

options.Conventions.AuthorizePage("/SecurePage"); 

}); 

Get_SecurePageRedirectsAnUnauthenticatedUser testinde, bir VVebapplicationfactorycIientoptions , false 
olarak allovvoto Redirect ayarlanarak yeniden yönlendirmeye izin vermez olarak ayarlanır: 








[Fact] 

public async Task Get_SecurePageRedirectsAnUnauthenticatedUser() 

{ 

// Arrange 

var Client = _factory.CreateClient( 

new WebApplicationFactoryClientOptions 

{ 

AllowAutoRedirect = false 

}); 

// Act 

var response = await Client.GetAsync("/SecurePage"); 

// Assert 

Assert.Equal(HttpStatusCode.Redirect , response.StatusCode); 

Assert.StartsWith("http://localhost/Identity/Account/Login", 
response.Headers.Location.OriginalString); 

} 

istemcinin yeniden yönlendirmeyi izlemeye izin vererek aşağıdaki denetimler yapılabilir: 

• SUT tarafından döndürülen durum kodu, oturum açma sayfasına yeniden yönlendirmeden sonra, 
HttpStatusCode. Tamamolacak şekilde, son durum koduna değil beklenen HttpStatusCode. Redirect 
sonucuyla denetlenebilir. 

• Yanıt üst bilgilerindeki Location üst bilgi değeri, Location üstbilgisinin mevcut olmadığı son oturum 
açma sayfası yanıtıyla değil http://iocaihost/identity/Account/Login ile başlayacağını doğrulamak üzere 
denetlenir. 

Test uygulaması, kimlik doğrulama ve yetkilendirme işlemlerini test etmek için Configuretestservices içindeki 
bir AuthenticationHandler<TOptions> sahte olabilir. En az bir senaryo, bir kimlik doğrulayan Poesult. 
Successdöndürür: 


public class TestAuthHandler : AuthenticationHandler<AuthenticationSchemeOptions> 

{ 

public TestAuthHandler(IOptionsMonitor<AuthenticationSchemeOptions> options, 

ILoggerFactory logger, UrlEncoder encoder, ISystemClock clock) 

: base(options, logger, encoder, clock) 

{ 

} 

pnotected override Task<AuthenticateResult> HandleAuthenticateAsync() 

{ 

var claims = new[] { new Claim(ClaimTypes.Name, "Test user") }; 
var identity = new Claimsldentity(claims, "Test"); 
var principal = new ClaimsPrincipal(identity); 
var ticket = new AuthenticationTicket(principalj "Test"); 

var result = AuthenticateResult.Success(ticket); 

return Task.FromResult(result); 

} 

} 

TestAuthHandler , kimlik doğrulama şeması, ConfigureTestServices için AddAuthentication kaydedildiği 
Test olarak ayarlandığında bir kullanıcının kimliğini doğrulamak için çağrılır: 








[Fact] 

public async Task Get_SecurePageIsReturnedForAnAuthenticatedUser() 

{ 

// Arrange 

var Client = _factory.WithWebHostBuilder(builder => 

{ 

builder.ConfigureTestServices(Services => 

{ 

Services.AddAuthentication("Test") 

. AddScheme< Aut hent icat ionSchemeOptions, Test Aut hFlandler>( 
"Test", options => {}); 

}); 

}) 

.CreateClient(new WebApplicationFactoryClientOptions 
{ 

AllowAutoRedirect = false, 

}); 

Client .Def aultRequestFleader s. Aut horization = 
new AuthenticationHeaderValue("Test"); 

/ / Act 

var response = await Client. GetAsync("/SecurePage"); 

// Assert 

Assert.Equal(FlttpStatusCode.OK, response.StatusCode); 


webAppiicationFactoryciientoptions hakkında daha fazla bilgi için istemci seçenekleri bölümüne bakın. 

Ortamı ayarlama 

Varsayılan olarak, SUT 'nin ana bilgisayar ve uygulama ortamı geliştirme ortamını kullanacak şekilde 
yapılandırılmıştır. SUT ortamını geçersiz kılmak için: 

• aspnetcore_environment ortam değişkenini ayarlayın (örneğin, staging , Production veya Testing gibi 
başka bir özel değer). 

• aspnetcore ön eki eklenmiş ortam değişkenlerini okumak için test uygulamasındaki createHostBuiider 
geçersiz kılın. 


protected override IHostBuilder CreateFlostBullder() => 
base.CreateHostBuilder() 

.ConfigureHostConfiguration( 

config => config.AddEnvironmentVariables("ASPNETCORE")); 


Test altyapısının uygulama içeriği kök yolunu nasıl öğrendiğini 


WebApplicationFactory 

Oluşturucusu, 

TEntryPoint 

bütünleştirilmiş 

System. Reflection.Assembly.FullName 


koduna eşit bir anahtarla tümleştirme testlerini içeren derlemede bir 

VVebapplicationfactorycontentrootattribute arayarak uygulama içeriği kök yolunu alır. Doğru anahtara sahip 
bir özniteliğin bulunamaması durumunda, webAppiicationFactory bir çözüm dosyasını (. sin) aramaya geri 
döner ve TEntryPoint derleme adını çözüm dizinine ekler. Uygulama kök dizini (içerik kök yolu) görünümleri 
ve içerik dosyalarını saptamak için kullanılır. 

Gölge kopyalamayı devre dışı bırak 

Gölge kopyalama, testlerin çıkış dizininden farklı bir dizinde yürütülmesine neden olur.Testlerin düzgün 
çalışması için gölge kopyalama devre dışı bırakılmalıdır. Örnek uygulama xUnit kullanır ve doğru 














yapılandırma ayarıyla bir xUnit. Runner. JSON dosyası ekleyerek xUnit için gölge kopyalamayı devre dışı 
bırakır. Daha fazla bilgi için bkz. JSON İlexllnit yapılandırma. 

Aşağıdaki içeriğe sahip test projesinin köküne xUn'ıt. Runner. JSON dosyasını ekleyin: 

{ 

"shadowCopy": false 

} 


Visual Studio kullanıyorsanız, dosyanın Çıkış Dizinine Kopyala özelliğini her zaman Kopyalaolarak 
ayarlayın. Visual Studio kullanmıyorsanız, test uygulamasının proje dosyasına bir content hedefi ekleyin: 

<ItemGroup> 

cContent Update="xunit.runner.json"> 

<CopyToOutputDirectory>Always</CopyToOutputDirectory> 

</Content> 

</ItemGroup> 


Nesnelerin elden çıkarılması 

ıciassFixture uygulamasının testleri yürütüldükten sonra, TestServer ve HttpClient , 
vvebapplicationfactory'nin xllnit 'i çıkardığı zaman yürütülür.Geliştirici tarafından oluşturulan nesneler için 
aktiften çıkarma gerekiyorsa, bunları ıciassFixture uygulamasında atın. Daha fazla bilgi için bkz. Dispose 
yöntemi uygulama. 

Tümleştirme Testleri örneği 

Örnek uygulama iki uygulamalardan oluşur: 

UYGULAMANIZDA PROJE DİZİNİ AÇIKLAMA 

ileti uygulaması (SUT) src/RazorPagesProject Bir kullanıcının, iletileri eklemesini, 

silmesini, silmesini ve analiz etmesini 
sağlar. 

Test uygulaması testler/RazorPagesProject. testler SUT test tümleştirmesi için kullanılır. 

Testler, Visual Studiogıbı bir IDE 'nin yerleşik test özellikleri kullanılarak çalıştırılabilir. Visual Studio Code 
veya komut satırı kullanıyorsanız, testler/RazorPagesProject. Tests dizinindeki bir komut isteminde aşağıdaki 
komutu yürütün: 

dotnet test 

İleti uygulaması (SUT) kuruluşu 

SUT, aşağıdaki özelliklere sahip bir Razor Pages ileti sistemidir: 

• Uygulamanın ( Pages/lndex. cshtml ve Pages/index. cshtml. cs) dizin sayfası, iletilerin eklenmesi, 
silinmesini ve ANALİZİNİ denetlemek için bir Ul ve sayfa modeli yöntemleri sağlar (ileti başına ortalama 
sözcük). 

• Bir ileti, iki özellik içeren Message sınıfı (Data/Message. cs) tarafından tanımlanır: id (anahtar) ve Text 
(ileti). Text özelliği gereklidir ve 200 karakterle sınırlıdır. 

• iletiler, Entity Framevvork bellek içi veritabanı+kullanılarak depolanır. 

• Uygulama, AppDbContext ( Data/AppDbContext. cs) veritabanı bağlamı sınıfında bir veri erişim KATMANı 














(dal) içerir. 

• Veritabanı uygulama başlangıcında boşsa, ileti deposu üç iletiyle başlatılır. 

• Uygulama yalnızca kimliği doğrulanmış bir kullanıcı tarafından erişilebilen bir /securePage içerir. 

tlnMemory İle testolan EF konusu, MSTest ile testler için bellek içi bir veritabanının nasıl kullanılacağını 
açıklar. Bu konu xUnit test çerçevesini kullanır. Farklı test çerçeveleri genelinde test kavramları ve test 
uygulamaları benzerdir ancak aynı değildir. 

Uygulama, depo desenini kullanmıyor ve İş birimi (UoW) düzenininetkin bir örneği olmamasına karşın, 
Razor Pages bu geliştirme düzenlerini destekler. Daha fazla bilgi için bkz. altyapı Kalıcılık katmanını 
tasarlama ve Test denetleyicisi mantığı (örnek, depo modelini uygular). 

Test uygulaması kuruluşu 

Test uygulaması, testler/RazorPagesProject. Tests dizini içindeki bir konsol uygulamasıdır. 

UYGULAMA DİZİNİNİ TEST ET AÇIKLAMA 

AuthTests için test yöntemleri içerir: 

• Güvenli bir sayfaya, kimliği doğrulanmamış bir 
kullanıcıyla erişme. 

• Bir sahte AuthenticationHandler<TOptions>kimliği 
doğrulanmış bir kullanıcı tarafından güvenli bir 
sayfaya erişme. 

• GitHub kullanıcı profilini alma ve profilin Kullanıcı 
oturum açma bilgilerini denetleme. 


BasicTests 


Yönlendirme ve içerik türü için bir test yöntemi içerir. 


Tümleştirme Testleri 


Özel webApplicationFactory sınıfı kullanarak dizin 
sayfasına yönelik tümleştirme testlerini içerir. 


Yardımcılar/yardima programlar • Utilities.es , veritabanını test verileriyle tohum için 

kullanılan initializeDbForTests metodunu içerir. 

• HtmlHelpers.es , test yöntemleri tarafından 
kullanılmak üzere AngleSharp iHtmlDocument 
döndüren bir yöntem sağlar. 

• HttpClientExtensions.cs , istekleri sut 'a göndermek 
için sendAsync için aşırı yüklemeler sağlar. 


Test çerçevesi xUnit' dir. Tümleştirme testleri, TestS erveriçeren Microsoft. Aspnetcore. testhostkullanılarak 
yürütülür. Test ana bilgisayarı ve test sunucusunu yapılandırmak için Microsoft. AspNetCore. Mvc. Testing 
paketi kullanıldığından, TestHost ve Testserver paketleri test uygulamasının proje dosyasında ya da 
testteki geliştirici yapılandırmasında doğrudan paket başvuruları gerektirmez uygulamanızda. 

Test için veritabanının temelini sağlama 

Tümleştirme testleri genellikle veritabanında test yürütmeden önce küçük bir veri kümesi gerektirir.Örneğin, 
veritabanı kaydı silme için bir silme testi çağrılarında, silme isteğinin başarılı olması için veritabanının en az 
bir kaydı olmalıdır. 

Örnek uygulama, Utilities.es içinde testlerin, yürütme sırasında kullanabileceği üç iletiyle birlikte veritabanını 
kullanır: 











public static void InitializeDbForTests(ApplicationDbContext db) 

{ 

db.Messages.AddRange(GetSeedingMessages()); 
db.SaveChanges(); 

} 

public static void ReinitializeDbForTests(ApplicationDbContext db) 

{ 

db.Messages.RemoveRange(db.Messages); 

InitializeDbForTests(db); 

} 

public static List<Message> GetSeedingMessages() 

{ 

return new List<Message>() 

{ 

new Message(){ Text = "TEST RECORD: You're standing on my scanf." }, 
new Message(){ Text = "TEST RECORD: Would you like a jelly baby?" }, 
new Message(){ Text = "TEST RECORD: To the national mind, " + 
"nothing is inexplicable; only unexplained." } 

}; 

} 


Ek kaynaklar 

• Birim testleri 

• ASP.NET Core birim testlerini Razor Pages 

• ASP.NET Core ara yazılımı 

• ASP.NET Core'de test denetleyicisi mantığı 



Yük/stres testini ASPNET Core 
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Yük testi ve stres testi, Web uygulamasının performansı ve ölçeklenebilir olmasını sağlamak için önemlidir. 
Genellikle benzer testleri paylaşsalar bile hedefleri farklıdır. 

Yük testleri , uygulamanın belirli bir kullanıcı yükünü, yanıt hedefini karşılarken, belirli bir senaryo için işleyebilip 
İşleyemeyeceğini Test eder Uygulama normal koşullarda çalıştırılır. 

Stres testleri , genellikle uzun bir süre boyunca yoğun koşullarda çalışırken test uygulaması kararlılığını Testler, 
uygulamanın yoğun veya aşamalı olarak yükünü artırır ya da uygulamanın bilgi işlem kaynaklarını sınırlar. 

Stres testleri, stres kapsamındaki bir uygulamanın hatadan kurtulacağını ve düzgün biçimde beklenen davranışa 
geri döneceğini denetler. Stres altında, uygulama normal koşullarda çalıştırılmamaları. 

Visual Studio 2019, Visual Studio 'nun yük testi özellikleriyle son sürümüdür.Gelecekte yük testi araçları gerektiren 
müşteriler için Apache J Meter, Akamai CloudTest ve BlazeMeter gibi alternatif araçlar önerilir. Daha fazla bilgi için 
bkz. Visual Studio 201 9 sürüm notları. 

Visual Studio Araçları 

Visual Studio, kullanıcıların Web performans ve yük testleri oluşturmalarına, geliştirmesine ve hata ayıklamasına 
olanak tanır. Bir Web tarayıcısında eylemleri kaydederek testler oluşturmak için bir seçenek mevcuttur. 

Visual Studio 2017 kullanarak yük testi projeleri oluşturma, yapılandırma ve çalıştırma hakkında daha fazla bilgi için 
bkz. hızlı başlangıç: yük testi projesi oluşturma. 

Yük testleri, şirket içinde çalışacak veya Azure DevOps kullanılarak bulutta çalıştırılacak şekilde yapılandırılabilir. 

Üçüncü taraf araçları 

Aşağıdaki listede, çeşitli özellik kümelerine sahip üçüncü taraf Web performans araçları yer almaktadır: 

• Apache J Meter 

• ApacheBench (AB) 

• Gatling 

• Locust 

• Batı rüzgar Web dalgalanma 

• Netling 

• Vegeta 






ASRNET Core projeleri sorunlarını giderme 
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Tarafından Rick Anderson 

Aşağıdaki bağlantılar sorun giderme kılavuzunu sağlar: 

• Azure App Service ve 11S 'de ASP.NET Core sorunlarını giderme 

• ASP.N ET Core ile Azure App Service ve MS için ortak hatalar başvurusu 

• N DC Konferansı (Londra, 2018): AS P.N ET Core uygulamalardaki sorunları tanılama 

• ASP.NET bloğu: ASP.NET Core performans sorunlarını giderme 

.NET Core SDK uyarılar 

.NET Core SDK hem 32-bit hem de 64-bit sürümleri yüklenir 

Yeni proje iletişim kutusunda ASP.NET Core için aşağıdaki uyarıyı görebilirsiniz: 

.NET Core SDK hem 32-bit hem de 64-bit sürümleri yüklenir.YalnızcaY C: Program Files\DotNet\SDK\' 
konumunda yüklü olan 64 bitlik sürümlerden alınan şablonlar görüntülenir. 

Bu uyarı, .NET Core SDK hem 32-bit (x86) hem de 64-bit (x64) sürümleri yüklendiğinde görüntülenir.Her iki 
sürümün de sık yüklenebileceği yaygın nedenler şunlardır: 

• ilk olarak 32 bitlik bir makine kullanarak .NET Core SDK yükleyicisini indirdiniz, ancak bu dosyayı bir 64 bit 
makineye kopyaladınız ve bu makinede yüklediniz. 

• 32 bit .NET Core SDK başka bir uygulama tarafından yüklendi. 

• Yanlış sürüm indirildi ve yüklendi. 

Bu uyarıyı engellemek için 32 bit .NET Core SDK kaldırın. Denetim Masası > Programlar ve Özellikler > 'den 
Kaldırbir programı kaldırma veya değiştirme. Uyarının neden oluştuğunu ve etkilerini anladıysanız, uyarıyı 
yoksayabilirsiniz. 

.NET Core SDK birden çok konuma yüklendi 

Yeni proje iletişim kutusunda ASP.NET Core için aşağıdaki uyarıyı görebilirsiniz: 

.NET Core SDK birden çok konuma yüklenir.YalnızcaY C: Program Files\DotNet\SDK\' konumunda yüklü 
SDK 'lardan şablonlar görüntülenir. 

C:\Program Files\DotNet\SDKdLşmdcıbirdizindeenazbir.NETCoreSDKyül<lemenizolcluğundabuiletiyigörürsünüz.\ 
Genellikle bu, .NET Core SDK MSI yükleyicisi yerine Kopyala/Yapıştır kullanılarak bir makineye dağıtıldığında 
meydana gelir. 

Bu uyarıyı engellemek için tüm 32-bit .NET Core SDK 'larını ve çalışma zamanlarını kaldırın. Denetim Masası > 
Programlar ve Özellikler > den Kaldırbir programı kaldırma veya değiştirme. Uyarının neden oluştuğunu 
ve etkilerini anladıysanız, uyarıyı yoksayabilirsiniz. 

.NET Core SDK 'Ları algılanmadı 

• AS P.N ET Core için Visual Studio Yeni proje iletişim kutusunda aşağıdaki uyarıyı görebilirsiniz: 


.NET Core SDK 'Ları algılanmadı, ortam değişkenine path dahil olduklarından emin olun. 




• Bir dotnet komut yürütürken, uyarı şöyle görünür: 


Yüklü olan DotNet SDK 'Ları bulmak mümkün değildi. 

Bu uyarılar, ortam değişkeni path makinede herhangi bir .NET Core SDK ‘sı üzerine işaret etmez görüntülenir. 
Bu sorunu çözmek için: 

• .NET Core SDK 'i yükler. .Net Indirmelerindeen son yükleyiciyi edinin. 

• Ortam değişkeninin SDK 'nın yüklü olduğu konuma işaret ettiğini doğrulayın ( c:\Program Fiies\dotnet\ 64 
bit/x64 veya c:\Program Fileş (x86)\dotnet\ 32 bit/x86 için), path S D K yükleyicisi normalde ' i ayarlar 

path . Aynı bit genişliği SDK 'larını ve çalışma zamanlarını aynı makineye her zaman yükler. 

.NET Core barındırma paketi yüklendikten sonra SDK eksik 

.NET Core barındırma paketinin yüklenmesi, path .NET Core 'un 32-bit (x86) sürümünü ( 
c:\Program Fileş (x86)\dotnet\ ) işaret etmek üzere ,NET Core çalışma zamanını yüklerken değiştirir.Bu, 32-bit 
(x86) .NET Core dotnet komutu kullanıldığında (.NET Core SDK 'ları algılanmadığında) eksik SDK 1 lara yol 
açabilir. Bu sorunu çözmek için, Öncesinde C:\ProgramFiles\dotnet\ C:\ProgramFiles (x86)\dotnet\ PATH bir 
konuma geçin. 

Bir uygulamadan veri alın 

Bir uygulama isteklere yanıt veriyorsa, ara yazılım kullanarak uygulamadan aşağıdaki verileri alabilirsiniz: 

• istek - yöntemi, düzen, ana bilgisayar, pathbase, yol, sorgu dizesi, üst bilgiler 

• Bağlantı - uzak İP adresi, uzak bağlantı noktası, yerel İP adresi, yerel bağlantı noktası, istemci sertifikası 

• Kimlik - adı, görünen ad 

• Yapılandırma ayarları 

• Ortam değişkenleri 

Aşağıdaki Ara yazılım kodunu startup.configure metodun istek işleme işlem hattının başına yerleştirin. Bu 
ortam, kodun yalnızca geliştirme ortamında yürütülmesini sağlamak için, ara yazılım çalıştırılmadan önce 
denetlenir. 

Ortamı edinmek için aşağıdaki yaklaşımlardan birini kullanın: 

• Metodunuyöntemine startup.configure ekleyin ve yerel değişkenle ortamı kontrol edin. 

iHostingEnvironment Aşağıdaki örnek kodda bu yaklaşım gösterilmektedir. 

• Ortamı startup sınıfındaki bir özelliğe atayın. Özelliğini kullanarak ortamı denetleyin (örneğin, 

if (Environment.IsDevelopment()) ). 

public void Configure(IApplicationBuilder app, IHostingEnvironment env, 

IConfiguration config) 

{ 

if (env.IsDevelopment()) 

{ 

app.Run(async (context) => 

{ 

var sb = new StringBuilder(); 

var nl = System. Environment. Newl_ine; 

var rule = string.Concat(nl, new string('-', 40), nl); 

var authSchemeProvider = app.ApplicationServices 

.GetRequiredService<IAuthenticationSchemeProvider>(); 

sb.Append($"Request{rule}"); 

sb.Append($"{DateTimeOffset.Now}{nl}"); 

sb.Append($"{context.Request.Method} {context.Request.Path}{nl}"); 
sh.Annendi”î"Srheme: Trontext.Rpnupst.SehemeİTnl T"t: 


















sb.Append($"Host: {context.Request.Headers["Host"]}{nl}"); 
sb.Append($"PathBase: {context.Request.PathBase.Value}{nl}"); 
sb.Append($"Path: {context.Request.Path.Value}{nl}"); 
sb.Append($"Query: {context.Request.QueryString.Value}{nl}{nl}"); 

sb.Append($"Connection{rule}"); 

sb.App 0 nd($"RemoteIp: {context.Connection.RemoteIpAddress}{nl}"); 
sb.Append($"RemotePort: {context.Connection.RemotePort}{nl}"); 
sb.Append($"LocalIp: {context.Connection.LocalIpAddress}{nl}"); 
sb.Append($"LocalPort: {context.Connection.LocalPort}{nl}"); 
sb.Append($"ClientCert: {context.Connection.ClientCertificate}{nl}{nl}") 

sb.Append($"Identity{rule}"); 

sb.Append($"User: {context.User.Identity.Name}{nl}"); 
var scheme = await authSchemeProvider 

.GetSchemeAsync(IISDefaults.AuthenticationScheme); 
sb.Append($"DisplayName: {scheme?.DisplayName}{nl}{nl}"); 

sb.Append($"Headers{rule}"); 

foreach (var header in context.Request.Headers) 

{ 

sb.Append(î"{header.Key}: {header.Value}{nl}"); 

} 

sb.Append(nl); 

sb.Append($"Websockets{rule}"); 

if (context.Features.Get<IHttpUpgradeFeature>() != null) 

{ 

sb.Append($"Status: Enabled{nl}{nl }"); 

} 

else 

{ 

sb.Append($"Status: Disabled{nl}{nl}"); 

} 

sb.Append($"Configuration{rule}"); 
foreach (var pair in config.AsEnumerable()) 

{ 

sb.Append(î"{pair.Path}: {pair.Value}{nl}"); 

} 

sb.Append(nl); 

sb.Append($"Environment Variables{rule}"); 
var vars = System.Environment.GetEnvironmentVariables(); 
foreach (var key in vars.Keys.Cast<string>().OrderBy(key => key^ 
StringComparer.OrdinalIgnoreCase)) 

{ 

var value = vars[key]; 

sb.Append($"{key}: {value}{nl}"); 

} 

context.Response.ContentType = "text/plain"; 
await context.Response.WriteAsync(sb.ToString()); 



.NET Core ve ASPNET Core oturum açma 
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Tom Dykstra ve Steve Smith tarafından 

.N ET Core, çeşitli yerleşik ve üçüncü taraf oturum açma sağlayıcılarıyla birlikte çalışarak bir günlüğe 
kaydetme API 'sini destekler. Bu makalede, yerleşik sağlayıcılarla günlüğe kaydetme API 'sinin nasıl 
kullanılacağı gösterilmektedir. 

Bu makalede gösterilen kod örneklerinin çoğu AS P.N ET Core uygulamalardan oluşur. Bu kod 
parçacıklarının günlüğe kaydetmeye özgü bölümleri, genel ana bilgisayarıkullanan tüm .NET Core 
uygulamaları için geçerlidir. Genel konağın Web 'de olmayan uygulamalarda kullanımı hakkında bilgi 
için bkz. barındırılan hizmetler. 

Genel ana bilgisayarı olmayan uygulamalar için günlük kodu, sağlayıcıların Eklenme ve günlükçülerin 
oluşturulmabiçiminde farklılık gösterir. Ana bilgisayar olmayan kod örnekleri, makalenin bu 
bölümlerinde gösterilmiştir. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Sağlayıcı Ekle 

Günlük sağlayıcısı günlükleri görüntüler veya depolar.Örneğin, konsol sağlayıcısı günlükleri 
konsolunda görüntüler ve Azure Application Insights sağlayıcısı bunları Azure Application Insights 
depolar. Birden çok sağlayıcı eklenerek Günlükler birden çok hedefe gönderilebilir. 

Genel ana bilgisayar kullanan bir uygulamaya sağlayıcı eklemek için, program.cs'de sağlayıcının 
Add{provider name} uzantısı metodunu çağırın: 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureLogging(logging => 

{ 

logging.ClearProviders(); 
logging.AddConsole(); 

}) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 

Konak olmayan bir konsol uygulamasında, bir LoggerFactory oluştururken sağlayıcının 
Add{pnoviden name} uzantısı metodunu çağırın: 






Varsayılan AS P.N ET Core proje şablonları, aşağıdaki günlük sağlayıcılarını ekleyen 

CreateDefaultBuilderçağırır: 

• Console 

• Hata ayıklama 

• EventSource 

• Olay günlüğü (yalnızca VVİndovvs üzerinde çalışırken) 

Varsayılan sağlayıcıları kendi seçimlerinizle değiştirebilirsiniz. ClearProvidersçağırın ve istediğiniz 
sağlayıcıları ekleyin. 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureLogging(logging => 

{ 

logging.ClearProviders(); 
logging.AddConsole(); 

}) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 


Bir sağlayıcı eklemek için sağlayıcının Add{provider name} uzantısı yöntemini program.es içinde çağırın: 






public static void Main(string[] args) 

{ 

var webHost = new WebHostBuilder() 

.UseKestrel() 

.UseContentRoot(Directory.GetCurrentDirectory()) 
.ConfigureAppConfiguration((hostingContext, config) => 

{ 

var env = hostingContext.HostingEnvironment; 

config.AddlsonFile("appsettings.json", optional: true, reloadOnChange: true) 

.Add]sonFile($"appsettings.{env.EnvironmentName}.json", 
optional: true., reloadOnChange: true); 
config.AddEnvironmentVariables(); 

}) 

.ConfigureLogging((hostingContext, logging) => 

{ 

// Requires 'using Microsoft.Extensions.Logging;' 

logging. AddConf iguration (hostingContext. Conf iguration. GetSection (" Logging")); 

logging.AddConsole(); 

logging.AddDebug(); 

logging.AddEventSourceLogger(); 

}) 

.UseStartup<Startup>() 

.Build(); 

webHost.Run(); 

} 

Yukarıdaki kod Microsoft. Extensions. Logging ve Microsoft. Extensions .Configuration başvurulan 
gerektirir. 

Varsayılan proje şablonu, aşağıdaki günlük sağlayıcılarını ekleyen CreateDefaultBuilderçağırır: 

• Konsolu 

• Hata ayıklama 

• EventSource (ASP.NET Core 2,2 ' den başlayarak) 


public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build{).Run(); 

} 

public static IlulebHostBuilder CreateWebHostBuilder(string[] args) => 
UebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>(); 


createDefaultBuiider kullanıyorsanız, varsayılan sağlayıcıları kendi seçimlerinizle değiştirebilirsiniz. 
ClearProvidersçağırın ve istediğiniz sağlayıcıları ekleyin. 






public static void Main(string[] args) 

{ 

var hoşt = CreateWebHostBuilder(args).Build(); 

var todoRepository = hoşt.Services.GetRequiredService<ITodoRepository>(); 
todoRepository.Add(new Core.Model.TodoItem() { Name = "Feed the dog" }); 
todoRepository.Add(new Core.Model.TodoItem() { Name = "Walk the dog" }); 

var logger = hoşt.Services.GetRequiredService<ILogger<Program>>(); 
logger.LogInformation("Seeded the database."); 

host.Run(); 

} 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.ConfigureLogging(logging => 

{ 

logging.ClearProviders(); 
logging.AddConsole(); 

}); 


Makalenin ilerleyen kısımlarında yerleşik günlük sağlayıcıları ve üçüncü taraf günlüğü sağlayıcıları 
hakkında daha fazla bilgi edinin. 

Günlükleri oluştur 

Günlükler oluşturmak için bir ILogger<TCategoryName> nesnesi kullanın. Bir Web uygulamasında 
veya barındırılan hizmette, bağımlılık ekleme (Dİ) iLogger alın. Konak dışı konsol uygulamalarında, bir 
iLogger oluşturmak için LoggerFactory kullanın. 

Aşağıdaki ASP.NET Core örnek kategori olarak TodoApiSample.Pages.AboutModei içeren bir günlükçü 
oluşturur. Günlük kategorisi , her günlük ile ilişkili bir dizedir. Dı tarafından belirtilen iLogger<T> örneği, 
kategori olarak t tam adı olan Günlükler oluşturur. 

public class AboutModel : PageModel 

{ 

private readonly ILogger _logger; 

public AboutModel(ILogger<AboutModel> logger) 

{ 

_logger = logger; 

} 

Aşağıdaki konak olmayan konsol uygulaması örneği, kategori olarak LoggingConsoleApp.Program olan 
bir günlükçü oluşturur. 

var loggerFactory = LoggerFactory.Create(builder => 

{ 

builder 

.AddFilter("Microsoft ", LogLevel.Warning) 

.AddFilter("System", LogLevel.Uarning) 

.AddFilter("LoggingConsoleApp.Program ", LogLevel.Debug) 

.AddConsole() 

.AddEventLogO; 

}); 

ILogger logger = loggerFactory.CreateLogger<Program>(); 
logger.LogInformation("Example log message"); 











public class AboutModel : PageModel 

{ 

private readonly ILogger _logger; 

public AboutModel(ILogger<AboutModel> logger) 

{ 

_logger = logger; 

} 

Aşağıdaki ASP.NET Core ve konsol uygulaması örneklerinde, günlükçü, düzeyi Information olan 
günlükleri oluşturmak için kullanılır. Günlük düzeyi günlüğe kaydedilen etkinliğin önem derecesini 
gösterir. 

public void OnGet() 

{ 

Message = $"About page visited at {DateTime.UtcNow.ToLongTimeString()}"; 

_logger.LogInformation("Message displayed: {Message}", Message); 

} 


var loggerFactory = LoggerFactory.Create(builder => 

{ 

builder 

.AddFilter("Microsoft", LogLevel .I/Jarning) 

.AddFilter("System", LogLevel.VJarning) 

.AddFilter("LoggingConsoleApp.Program", LogLevel.Debug) 
.AddConsole() 

.AddEventLogO; 

}); 

ILogger logger = loggerFactory.CreateLogger<Program>(); 
logger. LogInformation("Example log message"); 


public void OnGet() 

{ 

Message = $"About page visited at {DateTime.UtcNow.ToLongTimeString()}"; 
_logger.LogInformation("Message displayed: {Message}", Message); 

} 


Düzeyler ve Kategoriler Bu makalenin ilerleyen kısımlarında daha ayrıntılı olarak açıklanmıştır. 

Program sınıfında Günlükler oluşturma 

ASP.NET Core uygulamasının Program sınıfında Günlükler yazmak için, konak oluşturulduktan sonra 
bir ILogger örneği alın: 







public static void Main(string[] args) 

{ 

var hoşt = CreateHostBuilder(args).Build(); 

var todoRepository = hoşt.Services.GetRequiredService<ITodoRepository>(); 
todoRepository.Add(new Core.Model.TodoItem() { Name = "Feed the dog" }); 
todoRepository.Add(new Core.Model.TodoItem() { Name = "Walk the dog" }); 

var logger = hoşt.Services.GetRequiredService<ILogger<Program>>(); 
logger.LogInformation("Seeded the database."); 

IMyService myService = hoşt.Services.GetRequiredService<IMyService>(); 
myService.WriteLog("Logged from MyService."); 

host.Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 


Ana bilgisayar oluşturma sırasında günlüğe kaydetme doğrudan desteklenmez. Ancak, ayrı bir 
günlükçü kullanılabilir. Aşağıdaki örnekte, createHostBuiider oturum açmak için bir Serilog günlükçü 
kullanılır. AddSerilog , Log. Logger belirtilen statik yapılandırmayı kullanır: 




using System; 

using Microsoft.AspNetCore.Hosting; 
using Microsoft.Extensions.Dependencylnjection; 
using Microsoft.Extensions.Configuration; 
using Microsoft.Extensions.Hosting; 
using Microsoft.Extensions.Logging; 

public class Program 

{ 

public static void Main(string[] args) 

{ 

CreateHostBuilder(args).Build().Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) 

{ 

var builtConfig = new ConfigurationBuilder() 

.AddlsonFile("appsettings.json") 

.AddCommandLine(args) 

.Build(); 

Log.Logger = new LoggerConfiguration() 

.WriteTo.Console() 

. WriteTo.File(builtConfig["Logging:FilePath" ]) 
.CreateLogger(); 

try 

{ 

return Hoşt.CreateDefaultBuilder(args) 

,ConfigureServices((contextj Services) => 

{ 

Services.AddRazorPages(); 

}) 

,ConfigureAppConfiguration((hostingContextj config) => 

{ 

config. AddConfiguration( builtConfig); 

}) 

.ConfigureLogging(logging => 

{ 

logging.AddSerilog(); 

}) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 

} 

catch (Exception ex) 

{ 

Log.Fatal(ex, "Hoşt builder error"); 
throw; 

} 

finally 

{ 

Log.CloseAndFlush(); 

} 

} 

} 


Başlangıç sınıfında Günlükler oluşturma 

BirASP.NET Core uygulamasının startup.configure yönteminde Günlükler yazmak için, yöntem 
imzasına bir iLogger parametresi ekleyin: 




public void Configure(IApplicationBuilder app, IHostEnvironment env, ILogger<Startup> logger) 

{ 

if (env.IsDevelopment()) 

{ 

logger.LogInformation("In Development environment"); 
app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error")L 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 

app.UseRoutingO; 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapControllers(); 
endpoints.MapRazorPages(); 

}); 

} 

startup.configureServices yönteminde Dİ kapsayıcısı kurulumu tamamlanmadan önce Günlüklerin 
yazılması desteklenmez: 

• startup oluşturucusuna günlükçü ekleme desteklenmiyor. 

• Startup.configureServices yöntemi imzasına günlükçü ekleme desteklenmiyor 

Bu kısıtlamanın nedeni, günlük kaydının dı ve yapılandırmaya göre değişir ve bu da, ara ' ya bağlıdır. Dİ 
kapsayıcısı configureServices bitene kadar ayarlanamaz. 

Web ana bilgisayarı için ayrı bir dı kapsayıcısı oluşturulduğundan, bir günlükçü startup ' ye 
Oluşturucu Ekleme AS P.N ET Core önceki sürümlerinde çalışmaktadır. Genel ana bilgisayar için yalnızca 
bir kapsayıcı oluşturma hakkında daha fazla bilgi için bkz. Son değişiklik duyurusu. 

iLogger<T> bağımlı bir hizmet yapılandırmanız gerekiyorsa, bunu Oluşturucu ekleme veya bir fabrika 
yöntemi sağlayarak de yapabilirsiniz. Fabrika yöntemi yaklaşımı yalnızca başka bir seçenek yoksa 
önerilir. Örneğin, bir özelliği kaynağından bir hizmete doldurmanız gerektiğini varsayalım: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddControllers(); 

Services.AddRazorPages(); 

Services.AddSingleton<IMyService>((Container) => 

{ 

var logger = Container.GetRequiredService<ILogger<MyService>>(); 
return new MyService() { Logger = logger }; 

}); 

Services.AddSingletontlTodoRepository, TodoRepository>(); 

} 

Önceki vurgulanan kod, Dİ kapsayıcısının bir MyService örneği oluşturmak için ilk kez çalışan bir Func . 
Kayıtlı hizmetlerden herhangi birine bu şekilde erişebilirsiniz. 


Başlangıçta günlük oluşturma 







startup sınıfında Günlükler yazmak için, Oluşturucu imzasına bir ILogger parametresi ekleyin: 


public class Startup 

{ 

private readonly ILogger _logger; 

public Startup(IConfiguration configuration, ILogger<Startup> logger) 

{ 

Configuration = configuration; 

_logger = logger; 

} 

public IConfiguration Configuration { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services .AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

// Add our repository type 

Services.AddSingleton<ITodoRepository, TodoRepository>(); 

_logger.LogInformation("Added TodoRepository to Services"); 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

_logger.LogInformation("In Development environment"); 
app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 
app.UseCookiePolicy(); 

app.UseMvc(); 

} 

} 


Program sınıfında Günlükler oluşturma 

Program sınıfında Günlükler yazmak için, Dİ'den bir ILogger örneği alın: 





public static void Main(string[] args) 

{ 

var hoşt = CreateWebHostBuilder(args).Build(); 

var todoRepository = hoşt.Services.GetRequiredService<ITodoRepository>(); 
todoRepository.Add(new Core.Model.TodoItem() { Name = "Feed the dog" }); 
todoRepository.Add(new Core.Model.TodoItem() { Name = "Walk the dog" }); 

var logger = hoşt.Services.GetRequiredService<ILogger<Program>>(); 
logger.LogInformation("Seeded the database."); 

host.Run(); 

} 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.ConfigureLogging(logging => 

{ 

logging.ClearProviders(); 
logging.AddConsole(); 

}); 


Ana bilgisayar oluşturma sırasında günlüğe kaydetme doğrudan desteklenmez. Ancak, ayrı bir 
günlükçü kullanılabilir. Aşağıdaki örnekte, createwebHostBuiider oturum açmak için bir Serilog 
günlükçü kullanılır. AddSerilog , Log. Logger belirtilen statik yapılandırmayı kullanır: 




using System; 

using Microsoft.AspNetCore; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.Extensions.Dependencylnjection; 

using Microsoft.Extensions.Configuration; 

using Microsoft.Extensions.Logging; 

public class Program 

{ 

public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build().Run(); 

} 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) 

{ 

var builtConfig = new ConfigurationBuilder() 

.AddlsonFile("appsettings.json") 

.AddCommandLine(args) 

.Build(); 

Log.Logger = new LoggerConfiguration() 

.WriteTo.Console() 

. WriteTo.File(builtConfig["Logging:FilePath" ]) 
.CreateLogger(); 

try 

{ 

return WebHost.CreateDefaultBuilder(args) 

,ConfigureServices((contextj Services) => 

{ 

Services.AddMvc(); 

}) 

,ConfigureAppConfiguration((hostingContextj config) => 

{ 

config. AddConfiguration( builtConfig); 

}) 

.ConfigureLogging(logging => 

{ 

logging.AddSerilog(); 

}) 

.UseStartup<Startup>(); 

} 

catch (Exception ex) 

{ 

Log.Fatal(ex, "Hoşt builder error"); 
throw; 

} 

finally 

{ 

Log.CloseAndFlush(); 

} 

} 

} 


Zaman uyumsuz günlükçü yöntemi yok 

Günlüğe kaydetme, zaman uyumsuz kodun performans maliyetine değer olmaması kadar hızlı 
olmalıdır. Günlüğe kaydetme veri depoluizin yavaşsa, doğrudan buna yazmayın. Başlangıç olarak 
günlük iletilerini hızlı bir mağazaya yazmayı ve sonra yavaş depoya daha sonra taşımayı düşünün. 
Örneğin, SQL Server için günlük kaydı yapıyorsanız, Log Yöntemler zaman uyumlu olduğundan bunu 
doğrudan bir Log yönteminde yapmak istemezsiniz. Bunun yerine, günlük iletilerini bir bellek içi 
kuyruğa eşzamanlı olarak ekleyin ve bir arka plan çalışanı, SQL Server veri gönderme zaman uyumsuz 
çalışmasını sağlamak için iletileri kuyruktan çekin. Daha fazla bilgi için Bıı GitHub sorununa bakın. 






Yapılandırma 

Günlüğe kaydetme sağlayıcısı yapılandırması bir veya daha fazla yapılandırma sağlayıcısı tarafından 
sağlanır: 

• Dosya biçimleri (ıNı, JSON ve XML). 

• Komut satırı bağımsız değişkenleri. 

• Ortam değişkenleri. 

• Bellek içi .NET nesneleri. 

• Şifrelenmemiş gizli dizi Yöneticisi depolaması. 

• Azure Key Vaultgibi şifreli bir kullanıcı deposu. 

• Özel sağlayıcılar (yüklü veya oluşturulmuş). 

Örneğin, günlük yapılandırma genellikle uygulama ayarları dosyalarının Logging bölümü tarafından 
sağlanır. Aşağıdaki örnek tipik bir appSettings 'in içeriğini gösterir. Development. JSON dosyası: 

{ 

"Logging": { 

"LogLevel": { 

"Default": "Debug", 

"System": "Information", 

"Microsoft": "Information" 

"Console": 

{ 

"IncludeScopes": true 

} 

} 

} 


Logging 

özelliği 

LogLevel ' 

»/e günlük sağlayıcısı özelliklerine sahip olabilir (konsol gösterilir). 

Logging 

altındaki LogLevel 

özelliği, Seçili kategoriler için günlüğe kaydedilecek minimum düzeyi 

belirtir. Örnekte, 

System ve 

Microsoft kategorileri Information düzeyinde günlüğe kaydedilir ve 

diğerleri 

Debug ı 

düzeyinde günlüğe kaydedilir. 


Logging altındaki diğer özellikler günlük sağlayıcılarını belirtir. Örnek, konsol sağlayıcısına yöneliktir. 

Bir sağlayıcı, günlük kapsamlarınıdestekliyorsa IncludeScopes etkinleştirilip etkinleştirilmeyeceğini 
gösterir. Bir sağlayıcı özelliği (örneğin console gibi), bir LogLevel özelliği de belirtebilir, sağlayıcı 
altında LogLevel , bu sağlayıcının günlüğe kaydedilecek düzeyleri belirtir. 

Logging.{providername}.LogLevel düzeyler belirtilirse, Logging.LogLevel ayarlanan her şeyi geçersiz kılar. 

Günlüğe kaydetme API 'SI, bir uygulama çalışırken günlük düzeylerini değiştirme senaryosu içermez. 
Ancak, bazı yapılandırma sağlayıcıları yapılandırmayı yeniden yükleme yeteneğine sahiptir ve bu, 
günlüğe kaydetme yapılandırması üzerinde etkili bir şekilde gerçekleşir. Örneğin, ayar dosyalarını 
okumak için createDefauitBuiider tarafından eklenen dosya yapılandırma sağlayıcısı, varsayılan olarak 
günlük yapılandırmasını yeniden yükler. Uygulama çalışırken kodda yapılandırma değiştirilirse 
uygulama, uygulamanın günlük yapılandırmasını güncelleştirmek için IController. Reload ' i çağırabilir. 

Yapılandırma sağlayıcılarını uygulama hakkında daha fazla bilgi için bkz. ASP.NET Core yapılandırma. 

Örnek günlüğe kaydetme çıkışı 

Yukarıdaki bölümde gösterilen örnek kodla, uygulama komut satırından çalıştırıldığında Günlükler 
konsolunda görüntülenir. Konsol çıkışının bir örneği aşağıda verilmiştir: 














info: Microsoft.AspNetCore.Hoşting.Diagnostics[1] 

Request starting HTTP/1.1 GET http://localhost:5000/api/todo/0 
info: Microsoft.AspNetCore.Hoşting.Diagnostics[2] 

Request finished in 84.26180000000001ms 307 
info: Microsoft.AspNetCore.Hoşting.Diagnostics[1] 

Request starting HTTP/2 GET https://localhost:5001/api/todo/0 
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[0] 

Executing endpoint 'TodoApiSample.Controllers.TodoController.GetByld (TodoApiSample)' 
info: Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionInvoker[3] 

Route matched with {action = "GetByld", controller = "Todo", page = Executing controller 

action with signature Microsoft.AspNetCore.Mvc.IActionResult GetByld(System.String) on controller 
TodoApiSample.Controllers.TodoController (TodoApiSample). 
info: TodoApiSample.Controllers.TodoController[1002] 

Getting item 0 

warn: TodoApiSample.Controllers.TodoController[4000] 

GetById(0) NOT FOUND 

info: Microsoft.AspNetCore.Mvc.StatusCodeResult[l] 

Executing HttpStatusCodeResult, setting HTTP status code 404 


info: Microsoft.AspNetCore.Hoşting.Internal.WebHost[l] 

Request starting HTTP/1.1 GET http://localhost:5000/api/todo/0 
info: Microsoft.AspNetCore.Mvc.Internal.ControllerActionlnvoker[1] 

Executing action method TodoApi.Controllers.TodoController.GetByld (TodoApi) with arguments 
(0) - ModelState is Valid 

info: TodoApi.Controllers.TodoController[1002] 

Getting item 0 

warn: TodoApi.Controllers.TodoController[4000] 

GetById(0) NOT FOUND 

info: Microsoft.AspNetCore.Mvc.StatusCodeResult[1] 

Executing HttpStatusCodeResult, setting HTTP status code 404 
info: Microsoft.AspNetCore.Mvc.Internal.ControllerActionlnvoker[2] 

Executed action TodoApi.Controllers.TodoController.GetByld (TodoApi) in 42.9286ms 
info: Microsoft.AspNetCore.Hosting.Internal.WebHost[2] 

Request finished in 148.889ms 404 

Yukarıdaki Günlükler, http://localhost:5000/api/todo/0 konumundaki örnek uygulamaya HTTP GET 
isteği yapılarak oluşturulmuştur. 

Visual Studio 'da örnek uygulamayı çalıştırdığınızda hata ayıklama penceresinde göründükleri 
günlüklere yönelik bir örnek aşağıda verilmiştir: 

Microsoft.AspNetCore.Hosting.Diagnostics: Information: Request starting HTTP/2.0 GET 
https://localhost:44328/api/todo/0 

Microsoft.AspNetCore.Routing.EndpointMiddleware: Information: Executing endpoint 
'TodoApiSample.Controllers.TodoController.GetByld (TodoApiSample)' 

Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionlnvoker: Information: Route matched with 
{action = "GetByld", controller = "Todo", page = ""}. Executing controller action with signature 
Microsoft.AspNetCore.Mvc.IActionResult GetByld(System.String) on controller 
TodoApiSample.Controllers.TodoController (TodoApiSample). 

TodoApiSample.Controllers.TodoController: Information: Getting item 0 
TodoApiSample.Controllers.TodoController: Uarning: GetById(0) NOT FOUND 

Microsoft.AspNetCore.Mvc.StatusCodeResult: Information: Executing HttpStatusCodeResult, setting 
HTTP status code 404 

Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionlnvoker: Information: Executed action 
TodoApiSample.Controllers.TodoController.GetByld (TodoApiSample) in 34.167ms 
Microsoft.AspNetCore.Routing.EndpointMiddleware: Information: Executed endpoint 
'TodoApiSample.Controllers.TodoController.GetByld (TodoApiSample)' 

Microsoft.AspNetCore.Hosting.Diagnostics: Information: Request finished in 98.41300000000001ms 404 

Yukarıdaki bölümde gösterilen nogger çağrıları tarafından oluşturulan Günlükler "TodoApiSample" 
ile başlar. "Microsoft" kategorileri ile başlayan Günlükler ASP.NET Core Framevvork kodundan alınır. 








ASP.NET Core ve uygulama kodu aynı günlük API 'sini ve sağlayıcılarını kullanıyor. 


Microsoft .AspNetCore. Hosting. Internal.UlebHost: Information: Request starting HTTP/1.1 GET 
http://localhost:53104/api/todo/0 

Microsoft.AspNetCore.Mvc.Internal.ControllerActionInvoker:Information: Executing action method 
TodoApi.Controllers.TodoController.GetByld (TodoApi) with arguments (0) - ModelState is Valid 
TodoApi.Controllers.TodoController:Information: Getting item 0 
TodoApi.Controllers.TodoController:Warning: GetById(0) NOT FOUND 

Microsoft.AspNetCore.Mvc.StatusCodeResult:Information: Executing HttpStatusCodeResult, setting HTTP 
status code 404 

Microsoft.AspNetCore.Mvc.Internal.ControllerActionlnvoker:Information: Executed action 
TodoApi.Controllers.TodoController.GetByld (TodoApi) in 152.5657ms 

Microsoft.AspNetCore.Hosting.Internal.VJebHost:Information: Request finished in 316.3195ms 404 

Yukarıdaki bölümde gösterilen nogger çağrıları tarafından oluşturulan Günlükler "TodoApi" ile başlar. 
"Microsoft" kategorileri ile başlayan Günlükler ASP.NET Core Framework kodundan almir.ASP.NET 
Core ve uygulama kodu aynı günlük API 'sini ve sağlayıcılarını kullanıyor. 

Bu makalenin geri kalanında günlüğe kaydetme için bazı ayrıntılar ve seçenekler açıklanmaktadır. 

NuGet paketleri 

iLogger ve noggerFactory arabirimleri Microsoft. Extensions. Logging. soyutlamalarve bunların 
varsayılan uygulamaları Microsoft. Extensions. Logging 1 dir. 

Günlük kategorisi 

ILogger bir nesne oluşturulduğunda, için bir Kategori belirtilir. Bu kategori, bu nogger örneği 
tarafından oluşturulan her günlük iletisine dahildir. Kategori herhangi bir dize olabilir, ancak kural, 
"TodoApi. Controllers. TodoController" gibi sınıf adını kullanmaktır. 

Kategori olarak t tam nitelikli tür adını kullanan bir nogger örneğini almak için nogger<T> kullanın: 

public class TodoController : Controller 

{ 

private readonly ITodoRepository _todoRepository; 
private readonly ILogger _logger; 

public TodoController(ITodoRepository todoRepository, 

ILogger<TodoController> logger) 

{ 

_todoRepository = todoRepository; 

_logger = logger; 

} 


public class TodoController : Controller 

{ 

private readonly ITodoRepository _todoRepository; 
private readonly ILogger _logger; 

public TodoController(ITodoRepository todoRepository, 
ILogger<TodoController> logger) 

{ 

_todoRepository = todoRepository; 

_logger = logger; 

} 

Kategoriyi açıkça belirtmek için iLoggerFactory.createLogger çağırın: 










public class TodoController : Controller 

{ 

private readonly ITodoRepository _todoRepository; 
private readonly ILogger _logger; 

public TodoController(ITodoRepository todoRepository, 

ILoggerFactory logger) 

{ 

_todoRepository = todoRepository; 

_logger = logger.CreateLogger("TodoApiSample.Controllers.TodoController"); 

} 


public class TodoController : Controller 

{ 

private readonly ITodoRepository _todoRepository; 
private readonly ILogger _logger; 

public TodoController(ITodoRepository todoRepository, 

ILoggerFactory logger) 

{ 

_todoRepository = todoRepository; 

_logger = logger.CreateLogger("TodoApiSample.Controllers.TodoController"); 

} 

iLogger<T> , t tam nitelikli tür adıyla createLogger çağırma ile eşdeğerdir. 

Günlük düzeyi 

Her günlük bir LogLevel değerini belirtir. Günlük düzeyi önem derecesini veya önemini gösterir. 
Örneğin, bir yöntem normal olarak sona erdiğinde bir Information günlüğü ve bir yöntem 404 
bulunmayan bir durum kodu döndürdüğünde bir uarning günlüğü yazabilirsiniz. 

Aşağıdaki kod Information ve warning günlüklerini oluşturur: 

public IActionResult GetById(string id) 

{ 

_logger.LogInformation(LoggingEvents.Getltem, "Getting item {Id}", id); 
var item = _todoRepository.Find(id); 
if (item == null) 

{ 

_logger.LogWarning(LoggingEvents.GetltemNotFound, "GetById({Id}) NOT FOUND", id); 
return NotFound(); 

} 

return new ObjectResult(item); 

} 


public IActionResult GetById(string id) 

{ 

_logger.LogInformation(LoggingEvents.Getltem, "Getting item {Id}", id); 
var item = _todoRepository.Find(id); 
if (item == null) 

{ 

_logger.LogWarning(LoggingEvents.GetltemNotFound, "GetById({Id}) NOT FOUND", id); 
return NotFound(); 

} 

return new ObjectResult(item); 

} 


Önceki kodda, ilk parametredir oturum öğesini belirten Olay No. ikinci parametre, kalan Yöntem 










parametreleri tarafından belirtilen bağımsız değişken değerleri için yer tutucuları olan bir ileti 
şablonudur. Yöntem parametreleri bu makalenin ilerleyen kısımlarında bulunan ileti şablonu 
bölümünde açıklanmaktadır. 

Yöntem adındaki düzeyi (örneğin, Loginformation ve Loguarning ) içeren günlük yöntemleri, ILogger 
için uzantı yöntemleridir. Bu yöntemler bir LogLevel parametresi alan Log yöntemini çağırır. Bu uzantı 
yöntemlerinden biri yerine doğrudan Log yöntemi çağırabilirsiniz, ancak söz dizimi görece karmaşıktır. 
Daha fazla bilgi için bkz. ILogger ve günlükçü uzantıları kaynak kodu. 

ASP.NET Core, en küçükten en yüksek öneme doğru sıralanan aşağıdaki günlük düzeylerini tanımlar. 

• izleme = 0 

Genellikle yalnızca hata ayıklama için değerli bilgiler için. Bu iletiler hassas uygulama verileri 
içerebilir, bu nedenle bir üretim ortamında etkinleştirilmemelidir. Varsayılan olarak devre dışıdır. 

• Hata Ayıkla = 1 

Geliştirme ve hata ayıklama konusunda yararlı olabilecek bilgiler için. Örnek: 



• Bilgi = 2 

Uygulamanın genel akışını izlemek için. Bu günlüklerde genellikle uzun süreli bir değer vardır. 
Örnek: Request received for pattı /api/todo 

• Uyarı = 3 

Uygulama akışında anormal veya beklenmedik olaylar için. Bunlar, uygulamanın durmasına 
neden olmayan ancak araştırılması gerekebilecek hataları veya diğer koşulları içerebilir, işlenmiş 
özel durumlar warning günlük düzeyini kullanmak için yaygın bir yerdir. Örnek: 
FileNotFoundException for file quotes.txt. 

• Hata = 4 

İşlenemeyen hatalar ve özel durumlar için. Bu iletiler, uygulama genelinde bir hata değil geçerli 
etkinlikte veya işlemde (geçerli HTTP isteği gibi) bir hata olduğunu gösterir. Örnek günlük iletisi: 
Cannot insert record due to duplicate key violation. 

• Kritik = 5 

Anında ilgilenilmesi gereken hatalarda. Örnekler: veri kaybı senaryoları, disk alanı yetersiz. 

Belirli bir depolama ortamında veya görüntüleme penceresinde ne kadar günlük çıkışının yazıldığını 
denetlemek için günlük düzeyini kullanın. Örneğin: 

• Üretimde: 

o Trace Information düzeylerinde günlüğe kaydetme, yüksek hacimli ayrıntılı günlük iletileri 
oluşturur. Maliyetleri denetlemek ve veri depolama sınırlarını aşmamak için, Information 
düzey iletileri kullanarak Trace yüksek hacimli, düşük maliyetli bir veri deposuna günlüğe 
kaydedin. 

o warning Criticai düzeyler aracılığıyla günlüğe kaydetme işlemi genellikle daha az, daha 
küçük günlük iletileri üretir. Bu nedenle, maliyetler ve depolama sınırları genellikle bir sorun 
değildir ve bu da veri deposu seçiminden daha fazla esneklik elde etmez. 

• Geliştirme sırasında: 

o Konsola Criticai iletileri aracılığıyla uarning . 
o Sorun giderirken Information iletileri aracılığıyla Trace ekleyin. 





















Bu makalede daha sonra bulunan günlük filtreleme bölümünde, bir sağlayıcının hangi günlük 
düzeylerinin işlediğini nasıl denetleneceği açıklanmaktadır. 

AS P.N ET Core çerçeve olayları için günlükleri yazar. Bu makalede daha önce gelen günlük örnekleri 
Information düzeyin altında tutulur, dolayısıyla hiçbir Debug veya Trace düzeyi günlüğü 
oluşturulmaz. Aşağıda, Debug günlüklerini göstermek için yapılandırılmış örnek uygulama çalıştırılarak 
oluşturulan konsol günlüklerinin bir örneği verilmiştir: 

info: Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionlnvoker[3] 

Route matched with {action = "GetByld", controller = "Todo", page = Executing controller 

action with signature Microsoft.AspNetCore.Mvc.IActionResult GetByld(System.String) on controller 
TodoApiSample.Controllers.TodoController (TodoApiSample). 
dbug: Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionInvoker[l] 

Execution plan of authorization filters (in the following order): None 
dbug: Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionlnvoker[1] 

Execution plan of resource filters (in the following order): 

Microsoft.AspNetCore.Mvc.ViewFeatures.Filters.SaveTempDataFilter 
dbug: Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionInvoker[l] 

Execution plan of action filters (in the following order): 

Microsoft.AspNetCore.Mvc.Filters.ControllerActionFilter (Order: -2147483648 ), 

Microsoft.AspNetCore.Mvc.ModelBinding.UnsupportedContentTypeFilter (Order: -3000) 
dbug: Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionInvoker[l] 

Execution plan of exception filters (in the following order): None 
dbug: Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionlnvoker[1] 

Execution plan of result filters (in the following order): 

Microsoft.AspNetCore.Mvc.ViewFeatures.Filters.SaveTempDataFilter 
dbug: Microsoft.AspNetCore.Mvc.ModelBinding.ParameterBinder[22] 

Attempting to bind parameter 'id' of type 'System.String' ... 
dbug: Microsoft.AspNetCore.Mvc.ModelBinding.Binders.SimpleTypeModelBinder[44] 

Attempting to bind parameter 'id' of type 'System.String' using the name 'id' in request data 

dbug: Microsoft.AspNetCore.Mvc.ModelBinding.Binders.SimpleTypeModelBinder[45] 

Done attempting to bind parameter 'id' of type 'System.String'. 
dbug: Microsoft.AspNetCore.Mvc.ModelBinding.ParameterBinder[23] 

Done attempting to bind parameter 'id' of type 'System.String'. 
dbug: Microsoft.AspNetCore.Mvc.ModelBinding.ParameterBinder[26] 

Attempting to validate the bound parameter 'id' of type 'System.String' ... 
dbug: Microsoft.AspNetCore.Mvc.ModelBinding.ParameterBinder[27] 

Done attempting to validate the bound parameter 'id' of type 'System.String'. 
info: TodoApiSample.Controllers.TodoController[1002] 

Getting item 0 

warn: TodoApiSample.Controllers.TodoController[4000] 

GetById(0) NOT FOUND 

info: Microsoft.AspNetCore.Mvc.StatusCodeResultfl] 

Executing HttpStatusCodeResult, setting FITTP status code 404 
info: Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionlnvoker[2] 

Executed action TodoApiSample.Controllers.TodoController.GetByld (TodoApiSample) in 
32.690400000000004ms 

info: Microsoft.AspNetCore.Routing.EndpointMiddleware[l] 

Executed endpoint 'TodoApiSample.Controllers.TodoController.GetByld (TodoApiSample)' 
info: Microsoft.AspNetCore.Hosting.Diagnostics[2] 

Request finished in 176.9103ms 404 







info: Microsoft.AspNetCore.Hoşting.Internal.klebHost[1] 

Request starting HTTP/1.1 GET http://localhost:62555/api/todo/0 
dbug: Microsoft.AspNetCore.Routing.Tree.TreeRouter[1] 

Request successfully matched the route with name 'GetTodo' and template 'api/Todo/{id}'. 
dbug: Microsoft.AspNetCore.Mvc.Internal.ActionSelector[2] 

Action 'TodoApi.Controllers.TodoController.Update (TodoApi)' with id '089d59b6-92ec-472d- 
b552-cc613dfd625d' did not match the constraint 
’Microsoft.AspNetCore.Mvc.Internal.HttpMethodActionConstraint' 
dbug: Microsoft.AspNetCore.Mvc.Internal.ActionSelector[2] 

Action 'TodoApi.Controllers.TodoController.Delete (TodoApi)' with id 'f3476abe-4bd9-4ad3- 
9261-3ead09607366' did not match the constraint 
’Microsoft.AspNetCore.Mvc.Internal.HttpMethodActionConstraint' 
dbug: Microsoft.AspNetCore.Mvc.Internal.ControllerActionInvoker[l] 

Executing action TodoApi.Controllers.TodoController.GetByld (TodoApi) 
info: Microsoft.AspNetCore.Mvc. Internal.ControllerActionInvol<er[l] 

Executing action method TodoApi.Controllers.TodoController.GetByld (TodoApi) with arguments 
(0) - ModelState is Valid 

info: TodoApi.Controllers.TodoController[1002] 

Getting item 0 

warn: TodoApi.Controllers.TodoController[4000] 

GetById(0) NOT FOUND 

dbug: Microsoft.AspNetCore.Mvc.Internal.ControllerActionlnvoker[2] 

Executed action method TodoApi.Controllers.TodoController.GetByld (TodoApi), returned result 
Microsoft.AspNetCore.Mvc.NotFoundResult. 
info: Microsoft.AspNetCore.Mvc.StatusCodeResultfl] 

Executing HttpStatusCodeResult, setting HTTP status code 404 
info: Microsoft.AspNetCore.Mvc.Internal.ControllerActionlnvoker[2] 

Executed action TodoApi.Controllers.TodoController.GetByld (TodoApi) in 0.8788ms 
dbug: Microsoft.AspNetCore.Server.Kestrel[9] 

Connection id "0HL6L7NEFF2QD" completed keep alive response. 
info: Microsoft.AspNetCore.Hoşting.Internal.UebHost[2] 

Request finished in 2.7286ms 404 


Günlüğe olay KİMLİĞİ 

Her günlük belirtebilirsiniz bir öğesini belirten Olay No. Örnek uygulama bunu yerel olarak 
tanımlanmış bir LoggingEvents sınıfını kullanarak yapar: 

public IActionResult GetById(string id) 

{ 

_logger.LogInformation(LoggingEvents.Getltem, "Getting item {Id}", id); 
var item = _todoRepository.Find(id); 
if (item == null) 

{ 

_logger.LogWarning(LoggingEvents.GetltemNotFound, "GetById({Id}) NOT FOUND", id); 
return NotFound(); 

} 

return new ObjectResult(item); 

} 





public class LoggingEvents 

{ 

public const int Generateltems = 1000; 
public const int Listltems = 1001; 
public const int Getltem = 1002; 
public const int Insentltem = 1003; 
public const int Updateltem = 1004; 
public const int Deleteltem = 1005; 

public const int GetltemNotFound = 4000; 
public const int UpdateltemNotFound = 4001; 

} 


public IActionResult GetById(stning id) 

{ 

_logger.LogInformation(LoggingEvents.Getltem, "Getting item {Id}" 3 id); 
var item = _todoRepository.Find(id); 
if (item == null) 

{ 

_logger.LogWarning(LoggingEvents.GetltemNotFound, "GetById({Id}) NOT FOUND", id); 
return NotFound(); 

} 

return new ObjectResult(item); 

} 


public class LoggingEvents 

{ 

public const int Generateltems = 1000; 
public const int Listltems = 1001; 
public const int Getltem = 1002; 
public const int Insertltem = 1003; 
public const int Updateltem = 1004; 
public const int Deleteltem = 1005; 

public const int GetltemNotFound = 4000; 
public const int UpdateltemNotFound = 4001; 

} 

Olay KİMLİĞİ bir olay kümesini ilişkilendirir.Örneğin, bir sayfadaki öğelerin listesini görüntülemek için 
ilgili tüm Günlükler 1001 olabilir. 

Günlüğe kaydetme sağlayıcısı, olay KİMLİĞİNİ günlüğe kaydetme iletisindeki kimlik alanında veya hiç 
değil, bir kimlik alanında saklayabilir. Hata ayıklama sağlayıcısı olay kimliklerini göstermiyor.Konsol 
sağlayıcısı, etkinlik kimliklerini kategoriden sonra parantez içinde gösterir: 

info: TodoApi.Controllers.TodoController[1002] 

Getting item invalidid 

warn: TodoApi.Controllers.TodoController[4000] 

GetById(invalidid) NOT FOUND 


Günlük iletisi şablonu 

Her günlük bir ileti şablonunu belirtir, ileti şablonu, bağımsız değişkenlerin sağlandığı yer tutucuları 
içerebilir. Sayılar değil, yer tutucular için adları kullanın. 




public IActionResult GetById(string id) 

{ 

_logger. LogInformation(LoggingEvents .Getltem, "Getting item {Id}", id); 
var item = _todoRepository.Find(id); 
if (item == null) 

{ 

_logger.LogWarning(LoggingEvents.GetltemNotFoundj "GetById({Id}) NOT FOUND", id); 
return NotFound(); 

} 

return new ObjectResult(item); 

} 


public IActionResult GetById(string id) 

{ 

_logger.LogInformation(LoggingEvents.Getltem, "Getting item {Id}", id); 
var item = _todoRepository.Find(id); 
if (item == null) 

{ 

_logger.LogWarning(LoggingEvents.GetltemNotFoundj "GetById({Id}) NOT FOUND"j id); 
return NotFound(); 

} 

return new ObjectResult(item); 

} 


Adlarının, değerlerinin sağlanması için hangi parametrelerin kullanılacağını belirleyen yer tutucular 
sırası. Aşağıdaki kodda, parametre adlarının ileti şablonunda sıra dışı olduğuna dikkat edin: 

string pl = "parml"; 
string p2 = "parm2"; 

_logger.LogInformation("Parameter values: {p2}j {pl}", pl, p2); 


Bu kod, sırasıyla parametre değerleriyle bir günlük iletisi oluşturur: 

Parameter values: parml, parm2 


Günlüğe kaydetme altyapısı bu şekilde çalışarak, günlük sağlayıcılarının yapılandırılmış günlüğe yazma 
olarak da bilinen anlamsal günlüğüuygulayabilmesini sağlayabilir. Bağımsız değişkenler yalnızca biçimli 
ileti şablonuna değil, günlük sistemine geçirilir. Bu bilgiler, günlük sağlayıcılarının parametre değerlerini 
alan olarak depolamasına olanak sağlar. Örneğin, günlükçü yönteminin şuna benzer şekilde 
göründüğünü varsayın: 

_logger.LogInformation("Getting İtem {Id} at {RequestTime}", id, DateTime.Now); 

Günlükleri Azure Tablo depolama alanına gönderiyorsanız, her bir Azure Tablo varlığı id ve 
RequestTime özelliklerine sahip olabilir. Bu, günlük verilerinde sorguları basitleştirir.Bir sorgu, belirli bir 
RequestTime aralığındaki tüm günlükleri, metin iletisinden zaman aşımına uğratmadan bulabilir. 

Günlüğe kaydetme özel durumları 

Günlükçü yöntemlerinin, aşağıdaki örnekte olduğu gibi bir özel durum iletmenizi sağlayan aşırı 
yüklemeleri vardır: 








catch (Exception ex) 

{ 

_logger.LogWarning(LoggingEvents.GetltemNotFound, ex, "GetById({Id}) NOT FOUND", id); 
return NotFound(); 

} 

return new ObjectResult(item); 


catch (Exception ex) 

{ 

_logger.LogWarning(LoggingEvents.GetltemNotFound, ex, "GetById({Id}) NOT FOUND", id); 
return NotFound(); 

} 

return new ObjectResult(item); 

Özel durum bilgileri farklı yollarla farklı sağlayıcılarda işler. Yukarıda gösterilen koddan hata ayıklama 
sağlayıcısı çıktısına bir örnek aşağıda verilmiştir. 

TodoApiSample.Controllers.TodoController: Warning: GetById(55) NOT FOUND 

System.Exception: Item not found exception. 

at TodoApiSample.Controllers.TodoController.GetById(String id) in 
C: \TodoApiSample\Cont rollers\TodoController. cs: line 226 


Günlük filtreleme 

Belirli bir sağlayıcı ve kategori için en az bir günlük düzeyi veya tüm sağlayıcılar ya da tüm kategoriler 
için belirtebilirsiniz. Minimum düzeyin altındaki tüm Günlükler bu sağlayıcıya aktarılmaz, bu nedenle 
görüntülenmez veya depolanmaz. 

Tüm günlükleri gizlemek için en düşük günlük düzeyi olarak LogLevel.None belirtin. LogLevel.None 
tamsayı değeri 6 1 dır ve LogLevel.critieal (5) daha yüksektir. 

Yapılandırmada filtre kuralları oluşturma 

Proje şablonu kodu, konsol, hata ayıklama ve EventSource (ASP.NET Core 2,2 veya üzeri) sağlayıcılar 
için günlük kaydı ayarlamak üzere createoefaultBuiider çağırır. createDefaultBuiider yöntemi, Bu 
makalenin önceki kısımlarındaaçıklandığı gibi, Logging bir bölümünde yapılandırma aramak için 
günlüğe kaydetmeyi ayarlar. 

Yapılandırma verileri aşağıdaki örnekte olduğu gibi sağlayıcıya ve kategoriye göre en düşük günlük 
düzeylerini belirtir: 









{ 

"Logging": { 

"Debug": { 

"LogLevel": { 

"Default": "Information" 

} 

}, 

"Console": { 

"IncludeScopes": false, 

"LogLevel": { 

"Microsoft.AspNetCore.Mvc.Razor.Internal": "Warning ", 
"Microsoft.AspNetCore.Mvc.Razor.Razor": "Debug ", 
"Microsoft.AspNetCore.Mvc.Razor": "Error", 

"Default": "Information" 

} 

}, 

"LogLevel": { 

"Default": "Debug" 

} 

} 

} 


{ 

"Logging": { 

"Debug": { 

"LogLevel": { 

"Default": "Information" 

} 

}, 

"Console": { 

"IncludeScopes": false, 

"LogLevel": { 

"Microsoft.AspNetCore.Mvc.Razor.Internal": "Warning ", 
"Microsoft.AspNetCore.Mvc.Razor.Razor": "Debug ", 
"Microsoft.AspNetCore.Mvc.Razor": "Error", 

"Default": "Information" 

} 

}, 

"LogLevel": { 

"Default": "Debug" 

} 

} 

} 


Bu JSON altı filtre kuralı oluşturur: biri hata ayıklama sağlayıcısı, konsol sağlayıcısı için dört ve diğeri 
tüm sağlayıcılar için. iLogger bir nesne oluşturulduğunda her sağlayıcı için tek bir kural seçilir. 

Koddaki filtre kuralları 

Aşağıdaki örnek, koddaki filtre kurallarının nasıl kaydedileceği gösterilmektedir: 

.ConfigureLogging(logging => 

logging.AddFilter("System ", LogLevel.Debug) 

.AddFilter<DebugLoggerProvider>("Microsoft ", LogLevel.Trace)) 


NebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.ConfigureLogging(logging => 

logging.AddFilter("System ", LogLevel.Debug) 

.AddFilter<DebugLoggerProvider>("Microsoft ", LogLevel.Trace)); 





ikinci AddFilter , tür adını kullanarak hata ayıklama sağlayıcısını belirtir, ilk AddFilter bir sağlayıcı türü 
belirtmediğinden, tüm sağlayıcılar için geçerlidir. 


Filtreleme kuralları nasıl uygulanır 

Yapılandırma verileri ve önceki örneklerde gösterilen AddFilter kodu, aşağıdaki tabloda gösterilen 
kuralları oluşturur, ilk altı yapılandırma örneğinde ve son iki ise kod örneğinde gelir. 


SAYI 

SAĞLAYICI 

ŞUNUNLA BAŞLAYAN 
KATEGORİLER... 

EN DÜŞÜK GÜNLÜK 

DÜZEYİ 

1 . 

Hata ayıklama 

Tüm kategoriler 

Bilgisi 

2 

Konsolu 

M icrosoft. AspNetCore. M 
vc.Razor.Internal 

Uyarı 

3 

Konsolu 

M icrosoft.AspNetCore. M 
vc.Razor.Razor 

Hata ayıklama 

4 

Konsolu 

M icrosoft.AspNetCore. M 
vc. Razor 

Hata 

5 

Konsolu 

Tüm kategoriler 

Bilgisi 

6 

Tüm sağlayıcılar 

Tüm kategoriler 

Hata ayıklama 

7 

Tüm sağlayıcılar 

Sistem 

Hata ayıklama 

8 

Hata ayıklama 

Microsoft 

izleme 


Bir iLogger nesnesi oluşturulduğunda, iLoggerFactory nesnesi, bu günlükçü için uygulanacak her 
sağlayıcı için tek bir kural seçer. Bir iLogger örneği tarafından yazılan tüm iletiler, seçilen kurallara göre 
filtrelenmiştir. Her sağlayıcı ve kategori çifti için mümkün olan en özel kural kullanılabilir kurallardan 
seçilir. 

Belirli bir kategori için nogger oluşturulduğunda, her sağlayıcı için aşağıdaki algoritma kullanılır: 

• Sağlayıcı veya diğer adıyla eşleşen tüm kuralları seçin. Hiçbir eşleşme bulunmazsa, boş bir 
sağlayıcıya sahip tüm kurallar 1 ı seçin. 

• Önceki adımın sonucunda, en uzun eşleşen kategori ön ekine sahip kurallar' ı seçin. Eşleşme 
bulunmazsa, kategori belirtmeyen tüm kuralları seçin. 

• Birden çok kural seçilirse, son olanı götürün. 

• Hiçbir kural seçilmezse MinimumLevel kullanın. 

Yukarıdaki kurallar listesinde, "Microsoft. AspNetCore. Mvc. Razor. RazorVievvEngine" kategorisi için 
bir iLogger nesnesi oluşturduğunuzu varsayalım: 

• Hata ayıklama sağlayıcısı, kurallar 1, 6 ve 8 için geçerlidir. Kural 8 ' i en özeldir, yani seçili olanı 
seçilidir. 

• Konsol sağlayıcısı için, kurallar 3,4, 5 ve 6 geçerlidir. Kural 3 en özeldir. 

Elde edilen iLogger örneği, hata ayıklama sağlayıcısına Trace düzeyi ve üzeri Günlükler gönderir. 
Debug düzeyi ve üzeri Günlükler konsol sağlayıcısına gönderilir. 

Sağlayıcı diğer adları 

Her sağlayıcı, tam nitelikli tür adı yerine yapılandırmada kullanılabilecek bir diğer ad tanımlar. Yerleşik 















sağlayıcılar için aşağıdaki diğer adları kullanın: 

• Konsolu 

• Hata ayıklama 

• EventSource 

• EventLog 

• TraceSource 

• AzureAppServicesFile 

• AzureAppServicesBIob 

• Applicationlnsights 

Varsayılan en düşük düzey 

Yalnızca belirli bir sağlayıcı ve kategori için yapılandırma veya koddan kural uygulanmaz geçerli olan en 
düşük düzey ayar vardır. Aşağıdaki örnekte, en düşük düzeyin nasıl ayarlanacağı gösterilmektedir: 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureLogging(logging => logging.SetMinimumLevel(LogLevel.Warning)) 


1/JebHost .CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.ConfigureLogging(logging => logging.SetMinimumLevel(LogLevel.Uarning)); 

En düşük düzeyi açıkça ayarlamazsanız, varsayılan değer Information , bu da Trace ve Debug 
günlüklerinin yoksayıldığı anlamına gelir. 

Filtre işlevleri 

Configuration veya Code tarafından kendisine atanmış kuralları olmayan tüm sağlayıcılar ve kategoriler 
için bir filtre işlevi çağırılır, işlevindeki kodun sağlayıcı türü, kategorisi ve günlük düzeyine erişimi vardır. 
Örneğin: 

.ConfigureLogging(logBuilder => 

{ 

logBuilder. AddFilter((provider., category, logLevel) => 

{ 

if (provider == "Microsoft.Extensions.Logging.Console.ConsoleLoggerProvider" && 
category == "TodoApiSample.Controllers.TodoController") 

{ 

return false; 

} 

return true; 

}); 






WebHost.CreateDefaultBuilder(args) 

.UseStantup<Stantup>() 

.ConfigureLogging(logBuilder => 

{ 

logBuilder.AddFilter((provider, category, logLevel) => 

{ 

if (pnovider == "Microsoft.Extensions.Logging.Console.ConsoleLoggerProvider" && 
category == "TodoApiSample.Controllers.TodoController") 

{ 

return false; 

} 

return true; 

}); 

}); 


Sistem kategorileri ve Düzeyler 

ASP.NET Core ve Entity Framevvork Core tarafından kullanılan bazı kategoriler şunlardır ve bunlardan 
beklenen Günlükler hakkında notlar bulunur: 

KATEGORİ NOTLAR 


Microsoft.AspNetCore 

Genel ASP.NET Core tanılama. 

Microsoft.AspNetCore.DataProtection 

Hangi anahtarların kabul edildiği, bulunduğu ve 
kullanıldığı. 

Microsoft.AspNetCore.HostFiltering 

izin verilen konaklar. 

Microsoft.AspNetCore.Hosting 

HTTP isteklerinin tamamlanması için geçen süre ve ne 
zaman başladıkları. Hangi barındırma başlangıç 
derlemeleri yüklendi. 

Microsoft.AspNetCore.Mvc 

MVC ve Razor tanılama. Model bağlama, filtre yürütme, 
derlemeyi görüntüleme, eylem seçimi. 

Microsoft.AspNetCore.Routing 

Eşleşen bilgileri yönlendirin. 

Microsoft. AspNetCore. Server 

Bağlantı başlatın, durdurun ve canlı yanıtları koruyun. 
HTTPS sertifika bilgileri. 

Microsoft.AspNetCore.StaticFiles 

Sunulan dosyalar. 


Microsoft. EntityFramevvorkCore Genel Entity Framevvork Core tanılama. Veritabanı 

etkinliği ve yapılandırması, değişiklik algılama, geçişler. 


Günlük kapsamları 

Kapsam bir mantıksal işlemler kümesini gruplandırabilir. Bu gruplandırma, kümenin bir parçası olarak 
oluşturulan her günlüğe aynı verileri eklemek için kullanılabilir. Örneğin, bir işlemin işlenmesi 
kapsamında oluşturulan her günlük işlem KİMLİĞİ içerebilir. 

Kapsam, BeginScope yöntemi tarafından döndürülen ve atılana kadar bir iDisposable türüdür, using 
bloğunda günlükçü çağrılarını sarmalayarak kapsam kullanın: 





public IActionResult GetById(string id) 

{ 

Todoltem item; 

using (_logger.BeginScope("Message attached to logs created in the using block")) 

{ 

_logger.LogInformation(LoggingEvents.Getltem, "Getting item {Id}", id); 
item = _todoRepository.Find(id); 
if (item == null) 

{ 

_logger.LogWarning(LoggingEvents.GetltemNotFound, "GetById({Id}) NOT FOUND", id); 
return NotFound(); 

} 

} 

return new ObjectResult(item); 


public IActionResult GetById(string id) 

{ 

Todoltem item; 

using (_logger.BeginScope("Message attached to logs created in the using block")) 

{ 

_logger.LogInformation(LoggingEvents.Getltem, "Getting item {Id}", id); 
item = _todoRepository.Find(id); 
if (item == null) 

{ 

_logger.LogWarning(LoggingEvents.GetltemNotFoundj "GetById({Id}) NOT FOUND", id); 
return NotFound(); 

} 

} 

return new ObjectResult(item); 


Aşağıdaki kod konsol sağlayıcısı için kapsamları etkinleştirilir: 

Program.es : 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureLogging((hostingContext, logging) => 

{ 

logging.ClearProviders(); 

logging.AddConsole(options => options.IncludeScopes = true); 
logging.AddDebug(); 

}) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 


.ConfigureLogging((hostingContextj logging) => 

{ 

logging.AddConfiguration(hoştingContext.Configuration.GetSection("Logging")); 
logging.AddConsole(options => options.IncludeScopes = true); 
logging.AddDebug(); 

}) 





info: TodoApiSample.Controllers.TodoController[1002] 

=> RequestId:0HKV9C49II9CK RequestPath:/api/todo/0 => 

TodoApiSample.Controllers.TodoController.GetByld (TodoApi) => Message attached to logs created in 
the using block 

Getting item 0 

warn: TodoApiSample.Controllers.TodoController[4000] 

=> RequestId:0HKV9C49II9CK RequestPath:/api/todo/0 => 

TodoApiSample.Controllers.TodoController.GetByld (TodoApi) => Message attached to logs created in 
the using block 

GetById(0) NOT FOUND 


Yerleşik günlük oluşturma sağlayıcıları 

ASP.NET Core aşağıdaki sağlayıcıları sevk eder: 

• Console 

• Hata ayıklama 

• EventSource 

• EventLog 

• TraceSource 

• AzureAppServicesFile 

• AzureAppServicesBIob 

• Applicationlnsights 

AS P.N ET Core modülüyle stdout ve hata ayıklama günlüğü hakkında daha fazla bilgi için, bkz. Azure 
App Service ve 11S 'de AS P.N ET Core sorunlarını giderme ve ASP.NET Core Modülü. 

Konsol sağlayıcısı 

Microsoft. Extensions. Logging. Console sağlayıcı paketi, günlük çıktısını konsola gönderir, 
logging.AddConsole(); 


Konsol günlüğü çıkışını görmek için proje klasöründe bir komut istemi açın ve aşağıdaki komutu 
çalıştırın: 

dotnet run 

Hata ayıklama sağlayıcısı 

Microsoft. Extensions. Logging. Debug sağlayıcı paketi, System. Diagnostics. Debug sınıfını ( 
Debug.writeLine Yöntem çağrıları) kullanarak günlük çıktısını yazar. 

Linux 'ta, bu sağlayıcı günlükleri/vor/Zog/Messogedosyasına yazar. 






logging.AddDebug(); 

Olay kaynak sağlayıcısı 

Microsoft. Extensions. Logging. EventSource sağlayıcı paketi, Microsoft-Extensions-Logging adı İle bir 
olay kaynağı platformlar arası yazar. VVİndovvs 'da, sağlayıcı ETWkullanır. 

logging.AddEventSourceLogger(); 

Konak oluşturmak için cneateDefauitBuiiden çağrıldığında olay kaynak sağlayıcısı otomatik olarak 
eklenir. 

DotNet izleme araçları 

DotNet-Trace Aracı, çalışan bir İşlemin .N ET Core izlemelerinin toplanmasını sağlayan platformlar arası 
CLI genel aracıdır. Araç, bir LoggingEventSourcekullanarak Microsoft.Extensions.Logging.EventSource 
sağlayıcı verileri toplar. 

DotNet Trace araçları komutunu aşağıdaki komutla birlikte yüklersiniz: 

dotnet tool install --global dotnet-tnace 

Bir uygulamadan izleme toplamak için DotNet Trace araçları kullanın: 

1. Uygulama ana bilgisayarı createDefaultBuiider oluşturmaz, olay kaynak sağlayıcısını 
uygulamanın günlük yapılandırmasına ekleyin. 

2. dotnet run komutuyla uygulamayı çalıştırın. 

3. .NET Core uygulamasının işlem tanımlayıcısını (PID) belirleme: 

• VVİndovvs 'ta aşağıdaki yaklaşımlardan birini kullanın: 
o Görev Yöneticisi (Ctrl + Alt + Del) 

o Tasklist komutu 
o Get-Process PovverShell komutu 

• Linux'ta pidof komutunukullanın. 

Uygulamanın derlemesi ile aynı ada sahip olan işlem için PID 'i bulun. 

4. dotnet trace komutunu yürütün. 

Genel komut sözdizimi: 

dotnet trace collect -p {PID} 

--providers Microsoft-Extensions-Logging:{Keyword}:{Event Level} 

:FilterSpecs=\" 

{Logger Category l}:{Event Level 1}; 

{Logger Category 2}:{Event Level 2}; 

{Logger Category N}:{Event Level N}\" 

PovverShell komut kabuğu kullanırken --providers değerini tek tırnak içine alın ( ' ): 













dotnet trace collect -p {PID} 

--providers 'Microsoft-Extensions-Logging:{Keyword}:{Event Level} 

:FilterSpecs=\" 

{Logger Category 1}:{Event Level 1}; 

{Logger Category 2}:{Event Level 2 }; 

{Logger Category N}:{Event Level N}\"' 

VVİndovvs dışı platformlarda, çıkış izleme dosyasının biçimini speedscope olarak değiştirmek için 
-f speedscope seçeneğini ekleyin. 


ANAHTAR SÖZCÜĞÜ AÇIKLAMA 


1 . 

LoggingEventsource ilgili meta olayları günlüğe 
kaydedin. Olayları iLogger ) günlüğe kaydetmez. 

2 

iLogger. Log( ) çağrıldığında Message olayı açar. 


Programlı (biçimlendirilmedi) bir şekilde bilgi sağlar. 

4 

ILogger. Log( ) çağrıldığında FormatMessage 


olayı açar., Bilgilerin biçimlendirilen dize sürümünü 


sağlar. 

8 

ILogger. Log() çağrıldığında Messagelson olayı 


açar. Bağımsız değişkenlerin JSON gösterimini sağlar. 

OLAY DÜZEYİ 

AÇIKLAMA 

0 

LogAlways 

1 . 

Critical 

2 

Error 

3 

lAİarning 

4 

Informational 


5 Verbose 


{Logger Category} ve {Event Level} için FilterSpecs girişleri ek günlük filtreleme koşullarını 
temsil eder. FilterSpecs girdileri noktalı virgülle ayırın (; ). 

VVİndovvs komut kabuğu ile örnek ( --providers değeri etrafında tek tırnakyoktur): 

dotnet trace collect -p {PID} --providers Microsoft-Extensions- 
Logging:4:2:FilterSpecs=\"Microsoft.AspNetCore.Hoşting*:4\" 

Yukarıdaki komut şunları etkinleştirir: 

• Hatalar için ( 2 ) biçimlendirilen dizeler ( 4 ) üretmek üzere olay kaynağı günlükçüsü. 

• günlüğe kaydetme Informational günlük düzeyinde ( 4 ) Microsoft.AspNetCore.Hosting . 

5. ENTER tuşuna veya CTRL + C tuşlarına basarak DotNet izleme araçlarını durdurun. 






















izleme, dotnet trace komutunun yürütüldüğü klasörde Trace. NetTrace adıyla kaydedilir. 

6. Trace 'i PerfVievvile açın. Trace. NetTrace dosyasını açın ve izleme olaylarını araştırın. 

Daha fazla bilgi için bkz. 

• Performans Analizi yardımcı programı İçin izleme (DotNet-Trace) (.NET Core belgeleri) 

• Performans Analizi yardımcı programı (DotNet-Trace) İçin izleme (DotNet/Diagnostics GitHub 
deposu belgeleri) 

• Loggingeventsource sınıfı (.NET API tarayıcısı) 

• EventLevel 

• Loggingeventsource başvuru kaynağı (3,0) - farklı bir sürüm için başvuru kaynağı elde etmek üzere, 
dalı reiease/{Version} olarak değiştirin, burada {version} istenen ASP.NET Core sürümüdür. 

• PerfVievv , olay kaynağı izlemelerini görüntülemek için kullanışlıdır 

PerfVievv 

Günlükleri toplamak ve görüntülemek için PerfVievv yardımcı programını kullanın. ETW günlüklerini 
görüntülemeye yönelik başka araçlar da mevcuttur, ancak PerfVievv, AS P.N ET Core tarafından 
yayınlanan ETW olaylarıyla çalışmak için en iyi deneyimi sağlar. 

Bu sağlayıcı tarafından günlüğe kaydedilen olayları toplamak için PerfVievv 'ı yapılandırmak için, 
*Microsoft-Extensions-ı_ogging dizeyi ek sağlayıcılar listesine ekleyin. (Dizenin başlangıcında yıldız 
işaretini kaçırmayın.) 



Windows olay günlüğü sağlayıcısı 

Microsoft. Extensions. Logging. EventLog sağlayıcı paketi, VVİndovvs olay günlüğüne günlük çıktısı 
gönderir. 

logging.AddEventLog(); 

AddEventLog aşırı yüklemeler EventLogSettingsiletmenizi sağlar, nuiı veya belirtilmemişse, aşağıdaki 
varsayılan ayarlar kullanılır: 

• "uygulama" LogName - 

• SourceName — ".N ET Runtime" 

• MachineName -yerel makine 































TraceSource sağlayıcısı 

Microsoft. Extensions. Logging. TraceSource sağlayıcı paketi TraceSource kitaplıklarını ve sağlayıcıları 
kullanır. 

logging.AddTraceSource(sourceSwitchName); 

Addtracesource aşırı yüklemeleri , bir kaynak anahtarı ve bir izleme dinleyicisi geçirmenize olanak 
sağlar. 

Bu sağlayıcıyı kullanmak için, bir uygulamanın .NET Framevrork çalışması gerekir (.NET Core yerine). 
Sağlayıcı, iletileri örnek uygulamada kullanılan TextWriterTraceListener gibi çeşitli 
dinleyicilerineyönlendirebilir. 

Azure App Service sağlayıcı 

Microsoft. Extensions. Logging. AzureAppServices sağlayıcı paketi, günlükleri bir Azure App Service 
uygulamasının dosya sistemindeki metin dosyalarına ve bir Azure depolama hesabındaki BLOB 
depolama alanına yazar. 

logging. AddAzurel/JebAppDiagnostics (); 

Sağlayıcı paketi, paylaşılan çerçeveye dahil değildir.Sağlayıcıyı kullanmak için sağlayıcı paketini projeye 
ekleyin. 

Sağlayıcı paketi Microsoft. AspNetCore. app metapackage'e dahil değildir. .NET Framevvork veya 
Microsoft.AspNetcore.App metapackage 'e başvuru yaparken, sağlayıcı paketini projeye ekleyin. 

Sağlayıcı ayarlarını yapılandırmak için aşağıdaki örnekte gösterildiği gibi AzureFileLoggerOptions ve 
AzureBlobLoggerOptionsku İlanın: 





public static void Main(string[] args) 

{ 

var hoşt = CreateHostBuilder(args).Build(); 

var todoRepository = hoşt.Services.GetRequiredService<ITodoRepository>(); 
todoRepository.Add(new Core.Model.TodoItem() { Name = "Feed the dog" }); 
todoRepository.Add(new Core.Model.TodoItem() { Name = "Walk the dog" }); 

var logger = hoşt.Services.GetRequiredService<ILogger<Program>>(); 
logger.LogInformation("Seeded the database."); 

host.Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureLogging(logging => logging.AddAzurel/JebAppDiagnostics()) 
.ConfigureServices(serviceCollection => serviceCollection 
.Configure<AzureFileLoggerOptions>(options => 

{ 

options.FileName = "azure-diagnostics-"; 
options.FileSizeLimit = 50 * 1024; 
options.RetainedFileCountLimit = 5; 

}).Configure<AzureBlobLoggerOptions>(options => 

{ 

options.BlobName = "log.txt"; 

}) 

) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 


Sağlayıcı ayarlarını yapılandırmak için aşağıdaki örnekte gösterildiği gibi AzureFileLoggerOptions ve 
AzureBlobLoggerOptionsku İlanın: 

public static void Main(string[] args) 

{ 

var hoşt = CreateWebHostBuilder(args).Build(); 

var todoRepository = hoşt.Services.GetRequiredService<ITodoRepository>(); 
todoRepository.Add(new Core.Model.TodoItem() { Name = "Feed the dog" }); 
todoRepository.Add(new Core.Model.TodoItem() { Name = "Walk the dog" }); 

var logger = hoşt.Services.GetRequiredService<ILogger<Program>>(); 
logger.LogInformation("Seeded the database."); 

host.Run(); 

} 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.ConfigureLogging(logging => logging.AddAzureWebAppDiagnostics()) 
.ConfigureServices(serviceCollection => serviceCollection 
.Configure<AzureFileLoggerOptions»(options => 

{ 

options.FileName = "azure-diagnostics-"; 
options.FileSizeLimit = 50 * 1024; 
options.RetainedFileCountLimit = 5; 

}).Configure<AzureBlobLoggerOptions>(options => 

{ 

options.BlobName = "log.txt"; 

})) 

.UseStartup<Startup>(); 




AddAzureVVebAppDiagnostics aşırı yüklemesi AzureAppServicesDiagnosticsSettingsgeçirmenize 

olanak tanır. Ayarlar nesnesi, günlük çıkış şablonu, blob adı ve dosya boyutu sınırı gibi varsayılan 
ayarları geçersiz kılabilir. (Çr/cft şablonu , bir iLogger yöntemi çağrısıyla sağlandığının yanı sıra tüm 
günlüklere uygulanan bir ileti şablonudur.) 

App Service uygulamasına dağıtırken, uygulama, Azure portal App Service sayfasının App Service 
Günlükler bölümündeki ayarları kabul eder. Aşağıdaki ayarlar güncelleştirilirken, değişiklikler 
uygulamanın yeniden başlatılmasını veya yeniden dağıtımı gerekmeden hemen etkili olur. 

• Uygulama günlüğü (dosya sistemi) 

• Uygulama günlüğü (blob) 

Günlük dosyaları için varsayılan konum D:\home\LogFiles\uygulama klasöründedir ve varsayılan 
dosya adı Diagnostics-YYYYMMDD. txt‘ dir. Varsayılan dosya boyutu sınırı 10MB 'tır ve tutulan 
varsayılan en fazla dosya sayısı 2 ' dir. Varsayılan blob adı {app-name} 
{timestamp}/yyyy/mm/dd/ss/{Guid}- ApplicationLog.txt. 

Sağlayıcı yalnızca proje Azure ortamında çalıştırıldığında çalışır. Proje yerel olarak çalıştırıldığında, yerel 
dosyalara veya Bloblar için yerel geliştirme depolamasına yazmazsa—hiçbir etkisi yoktur. 

Azure günlük akışı 

Azure günlük akışı, günlük etkinliklerini gerçek zamanlı olarak görüntülemenize izin verir: 

• Uygulama sunucusu 

• Web sunucusu 

• Başarısız istek izleme 

Azure günlük akışını yapılandırmak için: 

• Uygulamanızın Portal sayfasından App Service günlükleri sayfasına gidin. 

• Uygulama günlüğünü (FileSystem) Açıkolarak ayarlayın. 

• Günlük düzeyiniseçin. Bu ayar, uygulamadaki diğer günlük sağlayıcılarını değil, yalnızca Azure 
günlük akışı için geçerlidir. 

Uygulama iletilerini görüntülemek için günlük akışı sayfasına gidin. Uygulama tarafından iLogger 
arabirimi aracılığıyla günlüğe kaydedilir. 

Azure Application Insights izleme günlüğü 

Microsoft. Extensions. Logging. Applicationlnsights sağlayıcı paketi günlükleri Azure Application 
Insights yazar. Application Insights, bir Web uygulamasını izleyen ve telemetri verilerini sorgulamak ve 
analiz etmek için araçlar sağlayan bir hizmettir. Bu sağlayıcıyı kullanıyorsanız, Application Insights 
araçlarını kullanarak günlüklerinizi sorgulayabilir ve analiz edebilirsiniz. 

Günlüğe kaydetme sağlayıcısı, ASP.N ET Core için tüm kullanılabilir telemetri sağlayan paket olan 
Microsoft. Applicationlnsights. AspNetCore'un bağımlılığı olarak eklenmiştir. Bu paketi kullanırsanız, 
sağlayıcı paketini yüklemek zorunda kalmazsınız. 

ASP.NET 4. x için olan Microsoft. Applicationlnsights. Web paketini kullanmayın—•. 

Daha fazla bilgi için aşağıdaki kaynaklara bakın: 

• Application Insights genel bakış 

• ASP.NET Core uygulamalar için Application Insights -günlük kaydı ile birlikte Application Insights 
telemetrinin tam aralığını uygulamak istiyorsanız buraya başlayın. 

• .NET Core ILogger günlükleri İçin Applicationınsightsloggerprovider -günlük sağlayıcısını 
Application Insights telemetri olmadan uygulamak istiyorsanız buraya başlayın. 

• Günlüğe kaydetme bağdaştırıcılarını Application Insights. 




• Microsoft Learn sitede Application Insights SDK-etkileşimli öğreticisini yükleyip başlatın . 

Üçüncü taraf günlük oluşturma sağlayıcıları 

AS P.N ET Core ile birlikte çalışan üçüncü taraf günlük çerçeveleri: 

• ELMAH.İo (GitHub deposu) 

• Gelf (GitHub deposu) 

• Jsnlog (GitHub deposu) 

• KissLog.net (GitHub deposu) 

• Log4Net (GitHub deposu) 

• Loggr (GitHub deposu) 

• NLog (GitHub deposu) 

• Sentry (GitHub deposu) 

• Serilog (GitHub deposu) 

• Stackdriver (GitHub deposu) 

Bazı üçüncü taraf çerçeveler , yapılandırılmış günlük olarak da bilinen anlam günlüğe kaydetmeişlemini 
gerçekleştirebilir. 

Bir üçüncü taraf çerçevesinin kullanılması, yerleşik sağlayıcılardan birini kullanmaya benzer: 

1. Projenize bir NuGet paketi ekleyin. 

2. Günlüğe kaydetme çerçevesi tarafından sağlanmış bir iLoggerFactory Extension yöntemi çağırın. 

Daha fazla bilgi için bkz. her sağlayıcının belgeleri. Üçüncü taraf günlüğü sağlayıcıları Microsoft 
tarafından desteklenmez. 

Ek kaynaklar 

• ASP.NET Core 'de LoggerMessage ile yüksek performanslı günlüğe kaydetme 
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, Luke Latham ve, kotalik tarafından 

Bu makalede, bir uygulama Azure App Service veya 11S 'ye dağıtıldığında hataların nasıl tanılanacağı hakkında 
genel uygulama başlatma hataları ve yönergeleri hakkında bilgi verilmektedir: 

Uygulama başlatma hataları 

Ortak Başlangıç HTTP durum kodu senaryolarını açıklar. 

Azure App Service sorunlarını giderme 

Azure App Service dağıtılan uygulamalar için sorun giderme önerisi sağlar. 

11S üzerinde sorun giderme 

IIS 'ye dağıtılan veya 11S Express yerel olarak çalışan uygulamalar için sorun giderme önerisi sağlar.Bu kılavuz hem 
Windows Server hem de Windows masaüstü dağıtımları için geçerlidir. 

Paket önbelleklerini temizle 

Önemli güncelleştirmeler gerçekleştirirken veya paket sürümlerini değiştirirken ne yapmanız gerektiğini açıklar. 

Ek kaynaklar 

Ek sorun giderme konularını listeler. 

Uygulama başlatma hataları 

Visual Studio 'da bir ASP.NET Core projesi, hata ayıklama sırasında IIS Express barındırmak için varsayılan 
değerdir. 502,5-lşlem hatasL veya yerel olarak hata ayıklarken oluşan 500,30-başlatma hatası , bu konudaki öneri 
kullanılarak tamlanabilir. 

Visual Studio 'da bir ASP.NET Core projesi, hata ayıklama sırasında IIS Express barındırmak için varsayılan 
değerdir. Yerel olarak hata ayıklamada oluşan 502,5 İşlem hatası , bu konudaki öneri kullanılarak tamlanabilir. 

403,14 yasak 

Uygulama başlatılamıyor.Aşağıdaki hata günlüğe kaydedilir: 

The Web server is configured to not list the contents of this directory. 

Hata genellikle barındırma sisteminde, aşağıdaki senaryolardan birini içeren bozuk bir dağıtım nedeniyle oluşur: 

• Uygulama, barındırma sisteminde yanlış klasöre dağıtılır. 

• Dağıtım işlemi, uygulamanın tüm dosyalarını ve klasörlerini barındırma sistemindeki dağıtım klasörüne 
taşıyamadı. 

• W eh. config dosyası dağıtımda yok veya Web. config dosyası içerikleri hatalı biçimlendirilmiş. 

Aşağıdaki adımları uygulayın: 

1. Tüm dosya ve klasörleri barındırma sistemindeki dağıtım klasöründen silin. 

2. Visual Studio, PovverShell veya el ile dağıtım gibi normal dağıtım yönteminizi kullanarak, uygulamanın 
Yayımlama klasörünün içeriğini barındırma sistemine yeniden dağıtın: 

• Web. config dosyasının dağıtımda mevcut olduğunu ve içeriğinin doğru olduğunu doğrulayın. 





• Azure App Service barındırırken, uygulamanın D:\home\site\wwwroot klasörüne dağıtıldığını doğrulayın. 

• Uygulama 11S tarafından barındırıliyorsa, uygulamanın 11S yöneticisinin temel ayarlarındagösterilen 
11S fiziksel yoluna dağıtıldığını doğrulayın. 

3. Barındırma sistemindeki dağıtımı projenin Yayımla klasörünün içeriğiyle karşılaştırarak uygulamanın tüm dosya 
ve klasörlerinin dağıtıldığını doğrulayın. 

Yayımlanan ASP.NET Core uygulamasının düzeni hakkında daha fazla bilgi için bkz. ASP.NET Core dizin yapısı. 

W eh. config dosyası hakkında daha fazla bilgi için bkz. AS P.N ET Core Modülü. 

500 İç sunucu hatası 

Uygulamayı başlatır, ancak bir hata sunucu isteği yerine getirmesini önler. 

Bu hata, başlatma sırasında veya bir yanıt oluşturulurken uygulamanın kod içinde oluşur. Yanıtta içerik yok olabilir 
veya Yanıt, tarayıcıda 500 İç sunucu hatası olarak görünebilir. Uygulama olay günlüğü, genellikle uygulama normal 
şekilde çalışmaya belirtir. Sunucunun açısından bakıldığında, doğru olmasıdır.Uygulama başladı, ancak geçerli bir 
yanıt oluşturulamıyor. Uygulamayı sunucuda bir komut isteminde çalıştırın veya sorunu gidermek için ASP.N ET 
Core modülü stdout günlüğünü etkinleştirin. 

500.0 işlem içi işleyici yükleme hatası 

Çalışan işlemi başarısız olur. Uygulama başlamaz. 

ASP.NET Core modülü .NET Core CLR 'yi bulamıyor ve işlem içi istek işleyicisini (aspnetcorev2Jnprocess. dil) 
bulamıyor. Kontrol edin: 

• Uygulama Microsoft. AspNetCore. Server. MS NuGet paketini ya da Microsoft. Aspnetcore. app metapackage'i 
hedefler. 

• AS P.N ET Core paylaşılan framevvork'ün hedefliyorsa hedef makinede yüklü sürümü. 

500.0 giden işlem işleyicisi yükleme hatası 

Çalışan işlemi başarısız olur. Uygulama başlamaz. 

AS P.N ET Core modülü işlem dışı barındırma isteği işleyicisini bulamıyor. Aspnetcorev2_outofprocess. dil' nin 
aspnetcorev2. dil' nin yanındaki bir alt klasörde bulunduğundan emin olun. 

500.0 işlem içi işleyici yükleme hatası 

Çalışan işlemi başarısız olur. Uygulama başlamaz. 

ASP.NET Core Modüle bileşenleri yüklenirken bilinmeyen bir hata oluştu. Aşağıdaki eylemlerden birini 
gerçekleştirin: 

• Microsoft desteğ iletişim kurun (Geliştirici Araçları ve ASP.NET Core 1 i seçin). 

• Stack Overflovv soru sorun. 

• GitHub deponuzdabir sorun yapın. 

500.30 işlemdeki başlatma hatası 

Çalışan işlemi başarısız olur. Uygulama başlamaz. 

ASP.NET Core modülü .NET Core CLR 'yi işlem içi başlatmaya çalışır, ancak başlatılamıyor.İşlem başlatma 
hatasının nedeni genellikle uygulama olay günlüğündeki girişlerden ve ASP.NET Core modülü stdout günlüğünde 
belirlenebilir. 

Ortak bir hata durumu, uygulamanın mevcut olmayan AS P.N ET Core paylaşılan framevvork sürümü hedefleme 
nedeniyle yanlış yapılandırılmış ' dir. Hangi sürümlerinin bir ASP.NET Core paylaşılan çerçeve hedef makinede 
yüklü olduğunu denetleyin. 

500.31 ANCM yerel bağımlılıklar bulunamadı 



Çalışan işlemi başarısız olur. Uygulama başlamaz. 

ASP.NET Core modülü , .NET Core çalışma zamanını işlem içinde başlatmaya çalışır, ancak başlatılamıyor.Bu 
başlatma hatasının en yaygın nedeni, Microsoft.NETCore.App veya Microsoft.AspNetcore.App çalışma zamanının 
yüklenmemesine neden olur. Uygulama, hedef AS P.N ET Core 3,0 1 ye dağıtılmışsa ve bu sürüm makinede yoksa, bu 
hata oluşur. Örnek bir hata iletisi aşağıda verilmiştir: 

The specified framework 'Microsoft.NETCore.App', version '3.0.0' was not found. 

- The following frameworks were found: 

2.2.1 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App] 

3.0.0-preview5-27626-15 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App] 
3.0.0-preview6-27713-13 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App] 
3.0.0-preview6-27714-15 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App] 
3.0.0-preview6-27723-08 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App] 


Hata iletisi, yüklü tüm .N ET Core sürümlerini ve uygulama tarafından istenen sürümü listeler. Bu hatayı onarmak 
için aşağıdakilerden birini yapın: 

• Uygun .NET Core sürümünü makineye yükler. 

• Uygulamayı, makinede bulunan .NET Core 'un bir sürümünü hedefleyecek şekilde değiştirin. 

• Uygulamayı kendi kendine kapsanan bir dağıtımolarak yayımlayın. 

Geliştirme aşamasında çalışırken ( aspnetcore_environment ortam değişkeni Development olarak ayarlandığında), 
HTTP yanıtına belirli bir hata yazılır, işlem başlatma hatasının nedeni uygulama olay günlüğünde de bulunur. 

500.32 ANCM dil yüklenemedi 

Çalışan işlemi başarısız olur. Uygulama başlamaz. 

Bu hatanın en yaygın nedeni, uygulamanın uyumsuz bir işlemci mimarisi için yayımlanmakta olması olabilir.Çalışan 
işlemi 32 bitlik bir uygulama olarak çalışıyorsa ve uygulama 64 bit hedef için yayımlandıysa, bu hata oluşur. 

Bu hatayı onarmak için aşağıdakilerden birini yapın: 

• Çalışan işlemle aynı işlemci mimarisi için uygulamayı yeniden yayımlayın. 

• Uygulamayı çerçeveye bağlı bir dağıtımolarak yayımlayın. 

500.33 ANCM İstek Işleyicisi yükleme hatası 

Çalışan işlemi başarısız olur. Uygulama başlamaz. 

Uygulama Microsoft.AspNetcore.App çerçevesine başvurmadı. Yalnızca Microsoft.AspNetcore.App çerçevesini 
hedefleyen uygulamalar AS P.N ET Core modülütarafından barındırılabilir. 

Bu hatayı düzeltemedi, uygulamanın Microsoft.AspNetcore.App çerçevesini hedeflediğinden emin olun. 
Uygulamanın hedeflediği çerçeveyi doğrulamak için .runtimeconfig. json denetleyin. 

500.34 ANCM karışık barındırma modelleri desteklenmez 

Çalışan işlem, aynı işlemde hem işlem içi uygulama hem de işlem dışı bir uygulama çalıştırılamaz. 

Bu hatayı onarmak için uygulamaları ayrı 11S uygulama havuzlarında çalıştırın. 

500.35 ANCM birden çok işlem İçi uygulama aynı İşlemde 

Çalışan işlemi aynı işlemde birden çok işlem içi uygulama çalıştıramıyor. 

Bu hatayı onarmak için uygulamaları ayrı 11S uygulama havuzlarında çalıştırın. 

500.36 ANCM İşlem dışı Işleyici yükleme hatası 

işlem dışı istek işleyicisi, aspnetcorev2_outofprocess. dil, aspnetcorev2. dil dosyasının yanında değildir. Bu, ASP.NET 
Core modülününbozuk bir yüklemesini gösterir. 











Bu hatayı gidermek için .NET Core barındırma paketi (US için) veya Visual Studio (IIS Express için) yüklemesini 
onarın. 

500,37 ANCM başlangıç zamanı sınırı İçinde başlatılamadı 

ANCM, kısımları başlangıç süresi sınırı içinde başlatılamadı. Varsayılan olarak, zaman aşımı 120 saniyedir. 

Aynı makinede çok sayıda uygulama başlatılırken bu hata oluşabilir.Başlangıç sırasında sunucuda CPU/bellek 
kullanımı artışlarını denetleyin. Birden çok uygulamanın başlatma işlemini şaşırtmayı yapmanız gerekebilir. 

502.5 işlem hatası 

Çalışan işlemi başarısız olur. Uygulama başlamaz. 

ASP.NET Core modülü çalışan işlemini başlatmaya çalışır, ancak başlatılamıyor. işlem başlatma hatasının nedeni 
genellikle uygulama olay günlüğündeki girişlerden ve ASP.NET Core modülü stdout günlüğünde belirlenebilir. 

Ortak bir hata durumu, uygulamanın mevcut olmayan AS P.N ET Core paylaşılan framevvork sürümü hedefleme 
nedeniyle yanlış yapılandırılmış ' dir. Hangi sürümlerinin bir ASP.NET Core paylaşılan çerçeve hedef makinede 
yüklü olduğunu denetleyin. Paylaşdan çerçeve , makinede yüklü olan ve Microsoft.AspNetCore.App gibi bir 
metapackage tarafından başvurulan derleme (. dil dosyaları) kümesidir. Metapackage başvurusu, gerekli en düşük 
sürümü belirtebilir. Daha fazla bilgi için bkz. paylaşılan çerçeve. 

Bir barındırma veya uygulamanın yanlış yapılandırılması, çalışan işleminin başarısız olmasına neden olduğunda, 

502.5 İşlem hata hatası sayfası döndürülür: 

Uygulama (hata kodu: '0x800700c1') başlatılamadı. 

EventlD: 1010 

Source: IIS AspNetCore Modüle V2 

Failed to start application '/LM/W3SVC/6/R00T/', ErrorCode '0x800700cl'. 

Uygulamanın derlemesi (. dil) yüklenemediğinden uygulama başlatılamadı. 

W3wp/ıısexpress işlemi ile yayımlanan uygulama arasındaki bir bit genişliği uyuşmazlığı olduğunda bu hata oluşur. 
Uygulama havuzunun 32-bit ayarının doğru olduğundan emin olun: 

1. IIS yöneticisinin uygulama havuzlarındauygulama havuzunu seçin. 

2. Eylemler panelinde uygulama havuzunu Düzenle altında Gelişmiş ayarlar ' ı seçin. 

3. Enable 32 bit uygulamalarmıayarla: 

• 32-bit (x86) bir uygulama dağıtıyorsanız, değeri True olarak ayarlayın. 

• 64 bit (x64) uygulaması dağıtıyorsanız, değeri Faise olarak ayarlayın. 

Proje dosyasındaki <Piatform> MSBuild özelliği ile uygulamanın yayınlanan bit durumuyla ilgili bir çakışma 
olmadığını doğrulayın. 

Bağlantı sıfırlama 

Üstbilgiler gönderildikten sonra bir hata oluşursa, bir hata oluştuğunda sunucunun 500 İç sunucu hatası 
gönderebilmesi için çok geç olur. Bu durum, genellikle bir yanıt için karmaşık nesne serileştirme sırasında bir hata 
oluştuğunda gerçekleşir. Bu tür bir hata, istemcide bir bağlanti sıfirlama hatası olarak görüntülenir. Uygulama 
günlüğü bu tür hataların giderilmesine yardımcı olabilir. 

Varsayılan başlangıç sınırları 

AS P.N ET Core modülü varsayılan bir StartupTimeLlmlt 120 saniye ile yapılandırılır. Varsayılan değer olarak sol 
uygulama modülü bir işlem hatası oturum önce başlatmak için iki dakika sürebilir. Modülü yapılandırma hakkında 
daha fazla bilgi için bkz. aspNetCore öğesinin öznitelikleri. 






Azure App Service sorunlarını giderme 


IMPORTANT 

Azure App Service ile Önizleme sürümlerini ASP.NET Core 

ASP.NET Core önizleme sürümleri varsayılan olarak Azure App Service dağıtılır. ASP.NET Core Previevv sürümü kullanan bir 
uygulamayı barındırmak için, bkz. Azure App Service için ASP.NET Core Previevv sürümünü dağıtma. 


Uygulama olay günlüğü (Azure App Service) 

Uygulama olay günlüğüne erişmek için Azure portal sorunları Tanıla ve çöz dikey penceresini kullanın: 

1. Azure portal uygulama Hizmetleri' nde uygulamayı açın. 

2. Tanıla ve sorunları çöz ' ü seçin. 

3. Tanılama araçları başlığını seçin. 

4. Destek Araçları' nın altında, uygulama olayları düğmesini seçin. 

5. Kaynak sütununda IIS AspNetCoreModule veya IIS Aspnetcoremodule v2 girişi tarafından belirtilen en son 
hatayı inceleyin. 

Sorunları Tanıla ve çöz dikey penceresini kullanmanın bir alternatifi, uygulama olay günlüğü dosyasını doğrudan 
kudukullanarak incelemektir: 

1 . Gelişmiş araçları geliştirme araçları alanında açın. Git-> düğmesini seçin. Kudu konsolu yeni bir tarayıcı 
sekmesi veya penceresinde açılır. 

2. Sayfanın üst kısmındaki gezinti çubuğunu kullanarak hata ayıklama konsolu 'nu açın ve cmd' yi seçin. 

3. LogFiles klasörünü açın. 

4. EverıtLog. xml dosyasının yanındaki kurşun kalem simgesini seçin. 

5. Günlüğü inceleyin. En son olayları görmek için günlüğün en altına gidin. 

Uygulamayı kudu konsolunda çalıştırma 

Başlatma hataları birçok yararlı bilgiler uygulama olay günlüğü'ndeki üretmediği. Bu hatayı saptamak için, 
uygulamayı kudu uzaktan yürütme konsolu 'nda çalıştırabilirsiniz: 

1 . Gelişmiş araçları geliştirme araçları alanında açın. Git^ düğmesini seçin. Kudu konsolu yeni bir tarayıcı 
sekmesi veya penceresinde açılır. 

2. Sayfanın üst kısmındaki gezinti çubuğunu kullanarak hata ayıklama konsolu 'nu açın ve cmd' yi seçin. 

32 bit (x86) uygulamayı test etme 
Geçerli yayın 

1. cd d:\home\site\wwwroot 

2. Uygulamayı çalıştırın: 

• Uygulama, çerçeveye bağımlı bir dağıtımise: 

dotnet .\{ASSEMBLY NAME}.dil 

• Uygulama, kendinden bağımsız bir dağıtımise: 

{ASSEMBLY NAME}.exe 

Uygulamadan alınan konsol çıktısı, tüm hataları gösteren kudu konsoluna gönderilir. 

Önizleme sürümünde çalışan çerçeveye bağımlı dağıtım 








ASP.NET Core {VERSION} (x86) çalışma zamanı site uzantısının yüklenmesini gerektirir. 

1. cd D:\home\SiteExtensions\AspNetCoreRuntime. {X.Y}.x32 ( {X.Y} çalışma Zamanı Sürümüdür) 

2. Uygulamayı çalıştırın: dotnet \home\site\wwwroot\{ASSEMBLY NAME}.dil 

Uygulamadan alınan konsol çıktısı, tüm hataları gösteren kudu konsoluna gönderilir. 

64 bit (x64) uygulamayı test etme 
Geçerli yayın 

• Uygulama 64 bit (x64) çerçeveye bağımlı bir dağıtımise: 

1. cd D:\Program Files\dotnet 

2. Uygulamayı çalıştırın: dotnet \home\site\wwwroot\{ASSEMBLY NAME} . dil 

• Uygulama, kendinden bağımsız bir dağıtımise: 

1. cd D:\home\site\wwwnoot 

2. Uygulamayı çalıştırın: {assembly NAME}.exe 

Uygulamadan alınan konsol çıktısı, tüm hataları gösteren kudu konsoluna gönderilir. 

Önizleme sürümünde çalışan çerçeveye bağımlı dağıtım 

ASP.NET Core {VERSION} (x64) çalışma zamanı site uzantısını yüklemeyi gerektirir. 

1. cd D:\home\SiteExtensions\AspNetCoreRuntime. {X.Y}.x64 ( {X.Y} çalışma Zamanı Sürümüdür) 

2. Uygulamayı çalıştırın: dotnet \home\site\wwwroot\{ASSEMBLY NAME}.dil 

Uygulamadan alınan konsol çıktısı, tüm hataları gösteren kudu konsoluna gönderilir. 

ASP.NET Core modülü stdout günlüğü (Azure App Service) 

ASP.NET Core Modüle stdout günlüğü genellikle uygulama olay günlüğünde bulunmayan yararlı hata iletilerini 
kaydeder. Stdout günlükleri görüntülemek ve etkinleştirmek için: 

1 . Azure portal sorunları Tanıla ve çöz dikey penceresine gidin. 

2. Sorun kategorisini seçinaltında Web uygulaması aşağı düğmesini seçin. 

3. Önerilen çözümler ' de stdout günlük yeniden yönlendirmeyi etkinleştirmek > , Web. config dosyasını 
düzenlemek için kudu konsolunu açmaküzere düğmeyi seçin. 

4. Kudu Tanılama konsolunda, dosyaları Wwwroot > yol sitesine açın. Listenin altındaki Web. config dosyasını 
açığa çıkarmak için aşağı kaydırın. 

5. Web. config dosyasının yanındaki kurşun kalem simgesine tıklayın. 

6. StdoutLogEnabled olarak ayarlayın ve stdoutLogFile yolunu true olarak değiştirin: 

\\?\%home%\LogFiles\stdout . 

7. Güncelleştirilmiş Web. config dosyasını kaydetmek için Kaydet ' i seçin. 

8. Uygulamaya bir istek oluşturun. 

9. Azure portal dönün. GELİŞTİRME araçları alanında Gelişmiş Araçlar dikey penceresini seçin. Git-* 
düğmesini seçin. Kudu konsolu yeni bir tarayıcı sekmesi veya penceresinde açılır. 

10. Sayfanın üst kısmındaki gezinti çubuğunu kullanarak hata ayıklama konsolu 'nu açın ve cmd' yi seçin. 

11. LogFiles klasörünü seçin. 

12. Değiştirilen sütunu inceleyin ve son değiştirilme tarihiyle stdout günlüğünü düzenlemek için kalem simgesini 
seçin. 

13. Günlük dosyası açıldığında hata görüntülenir. 

Sorun giderme tamamlandığında stdout günlüğünü devre dışı bırak: 

1. Kudu Tanılama konsolunda, 14/efe. config dosyasını açığa çıkarmak için Wwwroot > yolu sitesine dönün. 
Kalem simgesini seçerek Web. config dosyasını tekrar açın. 












2. faise için stdoutLogEnabled ayarlayın. 

3. Dosyayı kaydetmek için Kaydet 1 i seçin. 

Daha fazla bilgi için bkz. ASP.NET Core Modülü. 


VVARNING 

Uygulama veya sunucu başarısızlığı için hata stdout günlüğünü devre dışı bırakmak için yol açabilir. Günlük dosyası boyutunu 
sınırlama yok veya oluşturulan günlük dosyası sayısı yoktur. Yalnızca uygulama başlatma sorunlarını gidermek için stdout 
günlüğünü kullanın. 

Başlangıçtan sonra ASP.NET Core bir uygulamada genel günlüğe kaydetme için, günlük dosyası boyutunu sınırlayan ve 
günlükleri döndüren bir günlüğe kaydetme kitaplığı kullanın. Daha fazla bilgi için bkz. üçüncü taraf günlüğü sağlayıcıları. 


ASP.NET Core modülü hata ayıklama günlüğü (Azure App Service) 

ASP.NET Core Modüle hata ayıklama günlüğü, ASP.NET Core modülünden daha ayrıntılı günlük kaydı sağlar. 
Stdout günlükleri görüntülemek ve etkinleştirmek için: 

1. Gelişmiş tanılama günlüğünü etkinleştirmek için aşağıdakilerden birini yapın: 

• Uygulamayı gelişmiş tanılama günlüğü için yapılandırmak üzere Gelişmiş tanılama günlükleri 
bölümündeki yönergeleri izleyin. Uygulamayı yeniden dağıtın. 

• Gelişmiş tanılama günlüklerinde gösterilen <handierSettings> kudu konsolunu kullanarak canlı 
uygulamanın Web. config dosyasına ekleyin: 

a. Gelişmiş araçları geliştirme araçları alanında açın. Git^ düğmesini seçin. Kudu konsolu yeni bir 
tarayıcı sekmesi veya penceresinde açılır. 

b. Sayfanın üst kısmındaki gezinti çubuğunu kullanarak hata ayıklama konsolu 'nu açın ve cmd' yi 
seçin. 

c. Dosyaları wwwroot > yol sitesine açın. Web. config dosyasını, kurşun kalem düğmesini seçerek 
düzenleyin. <handierSettings> bölümünü, Gelişmiş tanılama günlüklerindegösterildiği gibi 
ekleyin. Kaydet düğmesini seçin. 

2. Gelişmiş araçları geliştirme araçları alanında açın. Git-> düğmesini seçin. Kudu konsolu yeni bir tarayıcı 
sekmesi veya penceresinde açılır. 

3. Sayfanın üst kısmındaki gezinti çubuğunu kullanarak hata ayıklama konsolu 'nu açın ve cmd' yi seçin. 

4. Dosyaları wwwroot > yol sitesine açın. Aspnetcore-Debug. log dosyası için bir yol sağlamadıysanız dosya 
listede görüntülenir. Bir yol sağladıysanız, günlük dosyasının konumuna gidin. 

5. Dosya adının yanındaki kurşun kalem düğmesiyle günlük dosyasını açın. 

Sorun giderme tamamlandığında hata ayıklama günlüğünü devre dışı bırak: 

Gelişmiş hata ayıklama günlüğünü devre dışı bırakmak için aşağıdakilerden birini yapın: 

• Web. config dosyasından <handierSettings> yerel olarak kaldırın ve uygulamayı yeniden dağıtın. 

• Web. config dosyasını düzenlemek ve <handierSettings> bölümünü kaldırmak İçin kudu konsolunu kullanın. 
Dosyayı kaydedin. 


Daha fazla bilgi için bkz. ASP.NET Core Modülü. 











VVARNING 

Hata ayıklama günlüğünü devre dışı bırakma hatası, uygulama veya sunucu hatasına yol açabilir. Günlük dosyası boyutunda 
sınır yoktur. Yalnızca uygulama başlatma sorunlarını gidermek için hata ayıklama günlüğünü kullanın. 

Başlangıçtan sonra ASP.NET Core bir uygulamada genel günlüğe kaydetme için, günlük dosyası boyutunu sınırlayan ve 
günlükleri döndüren bir günlüğe kaydetme kitaplığı kullanın. Daha fazla bilgi için bkz. üçüncü taraf günlüğü sağlayıcıları. 

Yavaş veya askıda olan uygulama (Azure App Service) 

Bir uygulama bir istek üzerinde yavaş bir şekilde yanıt verdiğinde veya Kilitlenmelerinde, aşağıdaki makalelere 
bakın: 

• Azure App Service 'de yavaş Web uygulaması performans sorunlarını giderme 

• Azure Web uygulamasında aralıklı özel durum sorunları veya performans sorunları için döküm yakalamak üzere 
kilitlenme tamlayıcı site uzantısı 'nı kullanın 

İzleme kanatları 

izleme dikey pencereleri, konusunda daha önce açıklanan yöntemlere alternatif bir sorun giderme deneyimi sağlar. 
Bu kanatlar 500 serisi hataları tanılamak için kullanılabilir. 

ASP.NET Core uzantılarının yüklü olduğunu doğrulayın. Uzantılar yüklü değilse, bunları el ile yükleyebilirsiniz: 

1 . GELİŞTİRME araçları dikey penceresinde Uzantılar dikey penceresini seçin. 

2. ASP.NET Core uzantıları listede görünmelidir. 

3. Uzantılar yüklü değilse, Ekle düğmesini seçin. 

4. Listeden ASP.N ET Core uzantılarını seçin. 

5. Yasal koşulları kabul etmek için Tamam 1 1 seçin. 

6. Uzantı Ekle dikey penceresinde Tamam ' ı seçin. 

7. Bilgilendirici bir açılan ileti, uzantıların başarıyla yüklenip yüklenmediğini gösterir. 

Stdout günlüğü etkinleştirilmemişse, şu adımları izleyin: 

1. Azure portal, GELİŞTİRME araçları alanındaki Gelişmiş Araçlar dikey penceresini seçin. Git-> düğmesini 
seçin. Kudu konsolu yeni bir tarayıcı sekmesi veya penceresinde açılır. 

2. Sayfanın üst kısmındaki gezinti çubuğunu kullanarak hata ayıklama konsolu 'nu açın ve cmd' yi seçin. 

3. Dosya yolu > sitesindeki klasörleri açın ve listenin altındaki Web. config dosyasını açığa çıkarmak için aşağı 
kaydırın. 

4. Web. config dosyasının yanındaki kurşun kalem simgesine tıklayın. 

5. StdoutLogEnabled olarak ayarlayın ve stdoutLogFile yolunu true olarak değiştirin: 

\\?\%home%\LogFiles\stdout . 

6. Güncelleştirilmiş Web. config dosyasını kaydetmek için Kaydet 1 i seçin. 

Tanılama günlüğünü etkinleştirmek için ilerleyin: 

1. Azure portal tanılama günlükleri dikey penceresini seçin. 

2. Uygulama günlüğü (dosya sistemi) ve ayrıntılı hata iletileriiçin bir anahtar seçin . Dikey pencerenin üst 
kısmındaki Kaydet düğmesini seçin. 

3. Başarısız istek izlemeyi, başarısız İstek olayı arabelleğe alma (FREB) günlüğü olarak da bilinen bir şekilde 
eklemek için , başarısız istek izlemeanahtarını seçin. 

4. Portalda tanılama günlükleri dikey penceresinde hemen listelenen günlük akışı dikey penceresini seçin. 

5. Uygulamaya bir istek oluşturun. 

6. Günlük akışı verileri içinde hatanın nedeni belirtilir. 







Sorun giderme tamamlandığında stdout günlüğünü devre dışı bıraktığınızdan emin olun. 

Başarısız istek izleme günlüklerini görüntülemek için (FREB günlükleri): 

1. Azure portal sorunları Tanıla ve çöz dikey penceresine gidin. 

2. Kenar çubuğunun Destek Araçları alanından başarısız istek izleme günlüklerini seçin. 

Azure App Service konusundaki Web uygulamaları için tanılama günlüğünü etkinleştirme ve Azure 'Daki Web 
Apps İçin uygulama performansı SSS bölümündeki başarısız istek izlemeleri bölümüne bakın: daha fazla bilgi için 
nasıl yaparım? başarısız istek izlemeyi açın. 

Daha fazla bilgi için bkz. Azure App Service Web Apps için tanılama günlüğünü etkinleştirme. 


VVARNING 

Uygulama veya sunucu başarısızlığı için hata stdout günlüğünü devre dışı bırakmak için yol açabilir. Günlük dosyası boyutunu 
sınırlama yok veya oluşturulan günlük dosyası sayısı yoktur. 

ASP.NET Core uygulamanızı rutin günlüğü için günlük dosyası boyutunu sınırlar ve günlükleri döndürür bir günlük kitaplığını 
kullanın. Daha fazla bilgi için bkz. üçüncü taraf günlüğü sağlayıcıları. 


IIS 'de sorun giderme 

Uygulama olay günlüğü (IIS) 

Uygulama olay günlüğüne erişemedi: 

1. Başlat menüsünü açın, Olay Görüntüleyicisiaraması yapın ve ardından Olay Görüntüleyicisi uygulamasını 
seçin. 

2. Olay Görüntüleyicisi, Windows günlükleri düğümünü açın. 

3. Uygulama olay günlüğünü açmak için uygulama 1 yı seçin. 

4. Başarısız olan uygulama ile ilişkili hataları arayın. Hataların, kaynak sütununda IIS aspnetcore modülünün veya 
IIS Express aspnetcore modülünün bir değeri vardır. 

Uygulamayı bir komut isteminde aşağıdakini çalıştırın 

Başlatma hataları birçok yararlı bilgiler uygulama olay günlüğü'ndeki üretmediği. Bazı hataların nedeni, barındıran 

sistemde bir komut isteminde uygulamayı çalıştırarak bulabilirsiniz. 

Framevvork bağımlı dağıtım 

Uygulama, çerçeveye bağımlı bir dağıtımise: 

1. Bir komut isteminde, dağıtım klasörüne gidin ve uygulamanın derlemesini DotNet. exe\\e yürüterek uygulamayı 
çalıştırın. Aşağıdaki komutta, <assembly_name >: dotnet .\<assembiy_name>.diı için uygulama derlemesinin 
adını yerine koyun. 

2. Konsol çıkışını herhangi bir hata gösteren uygulamadan konsol penceresine yazılır. 

3. Uygulamaya bir istek yaparken, hataları meydana gelirse, burada Kestrel dinlediği bağlantı noktası ve ana 
bilgisayar için istekte bulunmak. Varsayılan konak ve gönderi kullanarak http://iocaihost:50@0/ bir istek yapın. 
Uygulamayı, normalde Kestrel uç nokta adresindeki yanıt verirse, sorun barındırma yapılandırmasında ve büyük 
olasılıkla daha az uygulama içinde ilgili daha yüksektir. 

Kendi içinde dağıtım 

Uygulama, kendinden bağımsız bir dağıtımise: 

1. Bir komut isteminde dağıtım klasörüne gidin ve uygulamanın yürütülebilir dosyayı çalıştırın. Aşağıdaki komutta, 
<assembly_name >: <assembiy_name>.exe için uygulama derlemesinin adını yerine koyun. 

2. Konsol çıkışını herhangi bir hata gösteren uygulamadan konsol penceresine yazılır. 











3. Uygulamaya bir istek yaparken, hataları meydana gelirse, burada Kestrel dinlediği bağlantı noktası ve ana 
bilgisayar için istekte bulunmak. Varsayılan konak ve gönderi kullanarak http://iocaihost 15000 / bir istek yapın. 
Uygulamayı, normalde Kestrel uç nokta adresindeki yanıt verirse, sorun barındırma yapılandırmasında ve büyük 
olasılıkla daha az uygulama içinde ilgili daha yüksektir. 

ASP.NET Core Modüle stdout günlüğü (IIS) 

Stdout günlükleri görüntülemek ve etkinleştirmek için: 

1. Barındıran sistemde sitenin dağıtım klasörüne gidin. 

2. Günlükler klasörü yoksa, klasörü oluşturun. MSBuild 'in dağıtımdaki Günlükler klasörünü otomatik olarak 
oluşturmak üzere nasıl etkinleştirileceği hakkında yönergeler için, bkz. Dizin yapısı konusu. 

3. Web. config dosyasını düzenleyin. StdoutLogEnabled öğesini true olarak ayarlayın ve stdoutLogFile yolunu 
Günlükler klasörünü işaret etmek üzere değiştirin (örneğin, .\iogs\stdout ). yoldaki stdout günlük dosyası adı 
önekidir. Oturum oluşturulduğunda bir zaman damgası, işlem kimliği ve dosya uzantısı otomatik olarak eklenir. 
Dosya adı ön eki olarak stdout kullanarak, tipik bir günlük dosyası, stdout_20180205184032_5412. log olarak 
adlandırılır. 

4. Uygulama havuzunuzun kimliğinin Günlükler klasörü için yazma izinlerine sahip olduğundan emin olun. 

5. Güncelleştirilmiş Web. config dosyasını kaydedin. 

6. Uygulamaya bir istek oluşturun. 

7. Günlükler klasörüne gidin. Bulun ve en son stdout günlüğü'nü açın. 

8. Hatalar için günlüğü inceleyin. 

Sorun giderme tamamlandığında stdout günlüğünü devre dışı bırak: 

1. Web. config dosyasını düzenleyin. 

2. faise için StdoutLogEnabled ayarlayın. 

3. Dosyayı kaydedin. 

Daha fazla bilgi için bkz. ASP.NET Core Modülü. 


WARNING 

Uygulama veya sunucu başarısızlığı için hata stdout günlüğünü devre dışı bırakmak için yol açabilir. Günlük dosyası boyutunu 
sınırlama yok veya oluşturulan günlük dosyası sayısı yoktur. 

ASP.NET Core uygulamanızı rutin günlüğü için günlük dosyası boyutunu sınırlar ve günlükleri döndürür bir günlük kitaplığını 
kullanın. Daha fazla bilgi için bkz. üçüncü taraf günlüğü sağlayıcıları. 


ASP.NET Core modülü hata ayıklama günlüğü (IIS) 

ASP.NET Core modülü hata ayıklama günlüğünü etkinleştirmek için aşağıdaki işleyici ayarlarını uygulamanın Web. 
config dosyasına ekleyin: 

<aspNetCore ...> 

<handlenSettings> 

<handlenSetting name="debugLevel" value="file" /> 

<handlenSetting name="debugFile" value="c: \temp\ancm. log" /> 

</handlerSettings> 

</aspNetCore> 

Günlüğü için belirtilen yolun var olduğundan ve uygulama havuzu kimliğinin konumuna yazma izinlerine sahip 
olduğunu doğrulayın. 

Daha fazla bilgi için bkz. ASP.NET Core Modülü. 


Geliştirici özel durumu sayfasını etkinleştir 













aspnetcore_environment ortam değişkeni, uygulamayı geliştirme ortamında çalıştırmak için Web. config dosyasına 
eklenebilir. Ortam, ana bilgisayar tasarımcısında useEnvironment tarafından uygulama başlangıcında geçersiz 
kılınmadığı sürece, ortam değişkenini ayarlamak, uygulama çalıştırıldığında Geliştirici özel durum sayfasının 
görünmesine izin verir. 

<aspNetCore processPath="dotnet" 
arguments=". \MyApp.dll" 
stdoutLogEnabled="false" 
stdoutLogFile=". \logs\stdout" 
hostingModel="InProcess"> 

<environmentVariables> 

<environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" /> 

</environmentVariables> 

</aspNetCore> 

<aspNetCore processPath="dotnet" 
arguments=". \MyApp.dll" 
stdoutLogEnabled="false" 
stdoutLogFile=".\logs\stdout"> 

<environmentVariables> 

<environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" /> 

</environmentVariables> 

</aspNetCore> 

aspnetcore_environment için ortam değişkenini ayarlamak yalnızca Internet 'e açık olmayan hazırlama ve test etme 
sunucularında kullanılması önerilir. Sorun giderme işleminden sonra Web. config dosyasından ortam değişkenini 
kaldırın. Web. config 'de ortam değişkenlerini ayarlama hakkında daha fazla bilgi İçin, Aspnetcore 'un 
EnvironmentVariables alt öğesibölümüne bakın. 

Bir uygulamadan veri alın 

Bir uygulama isteklerini yanıtlayabileceği ise, istek, bağlantı ve ek veri terminal satır içi ara yazılımın kullanılması 
uygulamayı edinin. Daha fazla bilgi ve örnek kod için bkz. ASP.NET Core projeleri sorunlarını giderme. 

Yavaş veya askıda olan uygulama (IIS) 

Kilitlenme dökümü , sistem belleğinin bir anlık görüntüsüdür ve uygulama kilitlenmesinin, başlatma hatasının veya 
yavaş uygulamanın nedenini belirlemenize yardımcı olabilir. 

Uygulama kilitleniyor veya bir özel durumla karşılaşırsa 

Windows Hata Bildirimi bir döküm edinin ve çözümleyin (WER): 

1. Kilitlenme döküm dosyalarını c:\dumps tutmak için bir klasör oluşturun. Uygulama havuzunun klasöre 
yazma erişimi olmalıdır. 

2. Enabledökümler PovverShell betiğiniçalıştırın: 

• Uygulama, işlem içi barındırma modelinikullanıyorsa, W3wp. exeiçin betiği çalıştırın: 

.\EnableDumps w3wp.exe c:\dumps 


• Uygulama işlem dışı barındırma modelinikullanıyorsa, DotNet. exeiçin betiği çalıştırın: 

.\EnableDumps dotnet.exe c:\dumps 


3. Uygulamayı kilitlenmenin oluşmasına neden olan koşullar altında çalıştırın. 

4. Kilitlenme gerçekleştirildikten sonra, Disabledökümler PovverShell betiğiniçalıştırın: 






• Uygulama, işlem içi barındırma modelinikullanıyorsa, W3wp. exeiçin betiği çalıştırın: 


. \DisableDumps w3wp.exe 

• Uygulama işlem dışı barındırma modelinikullanıyorsa, DotNet. exeiçin betiği çalıştırın: 

.\DisableDumps dotnet.exe 

Uygulama kilitlenmeleri ve döküm koleksiyonu tamamlandıktan sonra, uygulamanın normal olarak 
sonlandırılmasına izin verilir. PovverShell betiği, WER 'i uygulama başına en fazla beş döküm toplayacak şekilde 
yapılandırır. 


VVARNING 

Kilitlenme dökümleri büyük miktarda disk alanı kaplar (her birine kadar çok gigabayt kadar). 


Uygulama askıda kalıyor, başlatma sırasında başarısız oluyor veya normal şekilde çalışıyor 

Bir uygulama askLda kaldığında (yanıt vermeyi keser ancak kilitlenmez), başlatma sırasında başarısız olur veya 
normal şekilde çalışır. Kullanıcı modu döküm dosyaları: döküm oluşturmak için uygun bir aracı seçmek üzere en iyi 
aracı seçme. 

Dökümü çözümle 

Bir döküm çeşitli yaklaşımlar kullanılarak analiz edilebilir. Daha fazla bilgi için bkz. Kullanıcı modu döküm dosyasını 
çözümleme. 

Paket önbelleklerini temizle 

Bazen, geliştirme makinesindeki .N ET Core SDK yükseltmeden ya da uygulamadaki paket sürümlerini değiştirirken 
çalışan bir uygulama hemen başarısız olur. Bazı durumlarda, ana yükseltme yaparken, bir uygulama tutarsız 
paketleri kesilebilir. Bu sorunların çoğu, bu yönergeleri izleyerek düzeltilebilir: 

1. Bin ve obj klasörlerini silin. 

2. Bir komut kabuğundan dotnet nuget locals ali --ciear yürüterek paket önbelleklerini temizleyin. 

Paket önbelleklerini Temizleme, NuGet. exe aracı ile de gerçekleştirilebilir ve komut nuget locals ali -ciear 
yürütülebilir. NuGet. exe , Windows masaüstü işletim sistemiyle birlikte paketlenmiş bir yüklemedir ve 
NuGet Web sitesindenayrı olarak alınmalıdır. 

3. Geri yükle ve projeyi yeniden derleyin. 

4. Uygulamayı yeniden dağıtmadan önce sunucusundaki dağıtım klasöründeki tüm dosyaları silin. 

Ek kaynaklar 

• ASP.NET Core projeleri sorunlarını giderme 

• ASP.NET Core ile Azure App Service ve 11S için ortak hatalar başvurusu 

• ASP.NET Core hataları işleme 

• ASP.NET Core Modülü 

Azure belgeleri 

• ASP.NET Core için Application Insights 

• Visual Studio 'Yu kullanarak Azure App Service Web uygulamasının sorunlarını giderme bölümünde uzaktan 
hata ayıklama Web Apps bölümü 










• Azure App Service tanılamada genel bakış 

• Nasıl yapılır: Azure App Service uygulamaları İzleme 

• Visual Studio 'Yu kullanarak Azure App Service bir Web uygulamasının sorunlarını giderme 

• Azure Web uygulamalarınızda "502 hatalı Ağ Geçidi" ve "503 hizmeti kullanılamıyor" HTTP hatalarında sorun 
giderme 

• Azure App Service 'de yavaş Web uygulaması performans sorunlarını giderme 

• Azure 'da Web Apps için uygulama performansı SSS 

• Azure Web uygulaması korumalı alanı (App Service çalışma zamanı yürütme sınırlamaları) 

• Azure Cuma: Azure App Service tanılama ve sorun giderme deneyimi (12 dakikalık video) 

Visual Studio belgeleri 

• Visual Studio 2017 ' de Azure 'da 11S 'de uzaktan hata ayıklama ASP.NET Core 

• Visual Studio 2017 ' de uzak MS bilgisayarında uzaktan hata ayıklama ASP.NET Core 

• Visual Studio kullanarak hata ayıklamayı öğrenin 

Visual Studio Code belgeleri 

• Visual Studio Code ile hata ayıklama 


ASRNET Core ile Azure App Service ve IIS için ortak 
hatalar başvurusu 
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Tarafından Luke Latham 

Bu konuda yaygın hatalar açıklanmakta ve Azure Apps hizmetinde ve IIS 'de ASP.NET Core uygulamalar 
barındırırken belirli hatalar için sorun giderme önerileri sunulmaktadır. 

Genel sorun giderme kılavuzu için bkz. Azure App Service ve IIS 'de ASP.NET Core sorunlarını giderme. 
Aşağıdaki bilgileri toplayın: 

• Tarayıcı davranışı (durum kodu ve hata iletisi) 

• Uygulama olay günlüğü girdileri 

o Azure App Service - Azure App Service ve IIS 'de ASP.NET Core sorunlarını gidermebakın. 
o IIS 

1. Windows menüsünde Başlat ' ı seçin, Olay Görüntüleyicisiyazm ve ENTERtuşuna basın. 

2. Olay Görüntüleyicisi açıldıktan sonra, kenar çubuğundan VVindovvs günlükleri > uygulaması ' 

nı genişletin. 

• ASP.NET Core modülü stdout ve hata ayıklama günlüğü girdileri 

o Azure App Service - Azure App Service ve IIS 'de ASP.NET Core sorunlarını gidermebakın. 
o IIS-ASP.NET Core modülü konusunun günlük oluşturma ve yeniden yönlendirme ve Gelişmiş tanılama 
günlükleri bölümlerindeki yönergeleri izleyin. 

Hata bilgilerini aşağıdaki yaygın hatalarla karşılaştırın. Bir eşleşme bulunursa, sorun giderme talimatını izleyin. 

Bu konudaki hataların listesi ayrıntılı değildir.Burada listelenmeyen bir hatayla karşılaşırsanız, bu konunun en 
altındaki içerik geri bildirim düğmesini kullanarak yeni bir sorun açın ve hatayı yeniden oluşturma hakkında 
ayrıntılı yönergeler kullanın. 


IMPORTANT 

Azure App Service ile Önizleme sürümlerini ASP.NET Core 

ASP.NET Core önizleme sürümleri varsayılan olarak Azure App Service dağıtılır. ASP.NET Core Previevv sürümü kullanan bir 
uygulamayı barındırmak için, bkz. Azure App Service için ASP.NET Core Previevv sürümünü dağıtma. 


İşletim sistemi yükseltmesi 32-bit ASP.NET Core modülünü kaldırdı 

Uygulama günlüğü: C:\windows\system32\inetsrv\aspnetcore.dll modül dil si yüklenemedi. Veriler hatadır. 
Sorun Giderme: 

Bir işletim sistemi yükseltmesi sırasında C:\Windows\SysWOW64\inetsrv dizininde işletim sistemi olmayan 
dosyalar korunmaz. AS P.N ET Core modülü bir işletim sistemi yükseltmesinden önce yüklendiyse ve sonra 
herhangi bir uygulama havuzu bir işletim sistemi yükseltmesinden sonra 32 bit modda çalıştıktan sonra bu sorunla 
karşılaşılmıştır. Bir işletim sistemi yükseltmesinden sonra ASP.NET Core modülünü onarın. Bkz. .NET Core 
barındırma paketi 'Ni yüklemeyi. Yükleyici çalıştırıldığında Onar ' ı seçin. 






Eksik site uzantısı, 32-bit (x86) ve 64-bit (x64) site uzantıları yüklü veya 
yanlış işlem bit genişliği ayarlanmış 

Azure Uygulama Hizmetleri tarafından barındırılan uygulamalar için geçerlidir. 

• Tarayıcı: HTTP hatası 500,0-lşlem İçi Işleyici yükleme hatası 

• Uygulama günlüğü: InProcess istek işleyicisini bulmak için hostfxr çağırma hiçbir yerel bağımlılığı 
bulamamadan başarısız oldu. InProcess istek işleyicisi bulunamadı. Hostfxr çağırmadan yakalanan çıkış: 
herhangi bir uyumlu çerçeve sürümü bulmak mümkün değildi. Belirtilen ' Microsoft. AspNetCore. App 1 
çerçevesi,' {VERSION}-Preview-*' sürümü bulunamadı. '/LM/W3SVC/1416782824/ROOT ' uygulaması 
başlatılamadı, hata kodu ' 0x8000FFFF '. 

• ASP.NET Core modülü stdout günlüğü: Uyumlu bir çerçeve sürümü bulmak mümkün değildi. Belirtilen 1 
Microsoft. AspNetCore. App ' çerçevesi, 1 {VERSION}-Preview-*‘ sürümü bulunamadı. 

• ASP.NET Core modülü hata ayıklama günlüğü: InProcess istek işleyicisini bulmak için hostfxr çağırma 
hiçbir yerel bağımlılığı bulamamadan başarısız oldu. Büyük olasılıkla uygulamanın yanlış yapılandırılmış olduğu 
anlamına gelir, lütfen uygulamanın hedeflediği ve makinede yüklü olduğu Microsoft. NetCore. App ve Microsoft. 
AspNetCore. app sürümlerini denetleyin. Başarısız HRESULT döndürüldü: 0x8000FFFF. InProcess istek işleyicisi 
bulunamadı. Uyumlu bir çerçeve sürümü bulmak mümkün değildi. Belirtilen 1 Microsoft. AspNetCore. App ' 
çerçevesi,' {VERSION}-Preview-*' sürümü bulunamadı. 

Sorun Giderme: 

• Uygulamayı bir önizleme çalışma zamanı üzerinde çal işti rıyorsanız, uygulamanın ve uygulamanın çalışma 
zamanının bit durumuyla eşleşen 32-bit (x86) veya 64 bit (x64) site uzantısını da yükler. Uzantı veya 
birden çok çalışma zamanı sürümünü yüklemeyin. 

o ASP.NET Core {RUNTIME VERSION} (x86) çalışma zamanı 
o ASP.NET Core {RUNTIME VERSION} (x64) çalışma zamanı 

Uygulamayı yeniden başlatın. Uygulamanın yeniden başlatılması için birkaç saniye bekleyin. 

• Uygulamayı bir önizleme çalışma zamanında çalıştırmak ve 32-bit (x86) ve 64 bit (x64) site uzantıları 
yüklüyse, uygulamanın bit durumuyla eşleşmeyen site uzantısını kaldırın. Site uzantısını kaldırdıktan sonra 
uygulamayı yeniden başlatın. Uygulamanın yeniden başlatılması için birkaç saniye bekleyin. 

• Uygulamayı bir önizleme çalışma zamanında çalıştırmak ve site uzantısının bit kullanımı uygulamayla 
eşleşiyorsa, önizleme sitesi uzantısının çalışma zamanı sürümünün uygulamanın çalışma zamanı sürümüyle 
eşleştiğini doğrulayın. 

• Uygulamanın uygulama ayarlarındaki platformunun uygulamanın bit durumuyla eşleştiğinden emin 
olun. 

Daha fazla bilgi için bkz. ASP.NET Core uygulamalarını Azure App Service dağıtma. 

X86 uygulaması dağıtıldı, ancak uygulama havuzu 32-bit uygulamalar 
için etkinleştirilmemiş 

• Tarayıcı: HTTP hatası 500,30-lşlem İçi İşlem başlatma hatası 

• Uygulama günlüğü: 1 {PATH} 1 fiziksel köküne sahip '/LM/VV3SVC/5/ROOT ' uygulaması beklenmeyen 
yönetilen özel duruma ulaştı, özel durum kodu = 1 0xe0434352 '. Daha fazla bilgi için lütfen stderr 
günlüklerine bakın. 1 {PATH} 1 fiziksel köküne sahip '/LM/W3SVC/5/ROOT 1 uygulaması clr ve yönetilen 
uygulamayı yükleyemedi. CLR VVorker iş parçacığından erken çıkıldı 

• ASP.NET Core modülü stdout günlüğü: Günlük dosyası oluşturulur ancak boştur. 


• ASP.NET Core modülü hata ayıklama günlüğü: Başarısız HRESULT döndürüldü: 0x8007023e 

Bu senaryo, kendi içinde bulunan bir uygulama yayımlanırken SDK tarafından yakalanarak yapılır. RID platform 
hedefi ile eşleşmezse SDK bir hata üretir (örneğin, proje dosyasında <piatformTarget>x86</piatformTarget> ile RID 
winl0-x64 ). 

Sorun Giderme: 

X86 çerçevesine bağımlı bir dağıtım ( <PiatformTarget>x86</piatformTarget> ) için 11S uygulama havuzunu 32 bitlik 
uygulamalar için etkinleştirin. 11S Yöneticisi 'nde, uygulama havuzunun Gelişmiş ayarlarını açın ve 32 bitlik 
uygulamaları doğruolarak etkinleştir ayarını yapın. 

Platform RID ile çakışıyor 

• Tarayıcı: HTTP hatası 502,5-lşlem hatası 

• Uygulama günlüğü:' C:{PATH}' fiziksel köküne sahip 1 MACHıNE/WEBROOT/APPHOST/{ASSEMBLY}' 
uygulaması,' 1 "C:{PATH} {ASSEMBLY} komut satırı ile işleme başlatamadı. {exe | dil}ErrorCode = 1 
0x80004005: ff. 

• ASP.NET Core modülü stdout günlüğü: işlenmeyen özel durum: System. BadlmageFormatException:' 
{ASSEMBLY}. dil ' dosyası veya bütünleştirilmiş kodu yüklenemedi. Bir programı hatalı biçimde yükleme 
girişiminde bulunuldu. 

Sorun Giderme: 

• Uygulamanın Kestrel üzerinde yerel olarak çalıştığını doğrulayın, işlem hatası, uygulamanın içindeki bir 
sorunun sonucu olabilir. Daha fazla bilgi için bkz. Azure App Service ve 11S 'de ASP.NET Core sorunlarını 
giderme. 

• Bu özel durum, bir uygulamayı yükseltirken ve daha yeni derlemeler dağıtıldığında bir Azure Apps dağıtımı 
için oluşursa, önceki dağıtımdan tüm dosyaları el ile silin. Kalan uyumsuz derlemeler, yükseltilen bir 
uygulama dağıtıldığında System.BadimageFormatException özel durumuyla sonuçlanabilir. 

URI uç noktası yanlış veya durdurulmuş Web sitesi 

• Tarayıcı: ERR_CONNECTION_REFUSED —veya— bağlantı kurulamıyor 

• Uygulama günlüğü: Giriş yok 

• ASP.NET Core modülü stdout günlüğü: Günlük dosyası oluşturulmaz. 

• ASP.NET Core modülü hata ayıklama günlüğü: Günlük dosyası oluşturulmaz. 

Sorun Giderme: 

• Uygulamanın kullanımda olduğu doğru URI uç noktasını onaylayın. Bağlamaları denetleyin. 

• 11S Web sitesinin durdurulmuş durumda olmadığını doğrulayın. 

CoreVVebEngine veya VV3SVC sunucu özellikleri devre dışı 

İşletim sistemi özel durumu: ASP.NET Core modülünü kullanmak için 11S 7,0 CoreVVebEngine ve W3SVC 
özelliklerinin yüklü olması gerekir. 

Sorun Giderme: 


Uygun rol ve özelliklerin etkinleştirildiğini doğrulayın. Bkz. 11 S yapılandırması. 





Yanlış web sitesi fiziksel yolu veya uygulaması eksik 

• Tarayıcı: 403 Yasak-erişim reddedildi -veya-- 403,14 yasak-Web sunucusu bu dizinin içeriğini listebir 
şekilde yapılandırılmıştır. 

• Uygulama günlüğü: Giriş yok 

• ASP.NET Core modülü stdout günlüğü: Günlük dosyası oluşturulmaz. 

• ASP.NET Core modülü hata ayıklama günlüğü: Günlük dosyası oluşturulmaz. 

Sorun Giderme: 

IIS Web sitesi temel ayarları ve fiziksel uygulama klasörü 1 ne bakın. Uygulamanın 11S Web sitesi fiziksel 
yolundakiklasörde olduğunu doğrulayın. 

Yanlış rol, ASP.NET Core modülü yüklü değil veya yanlış izinler 

• Tarayıcı: 500,19 İç sunucu hatası-sayfanın ilgili yapılandırma verileri geçersiz olduğundan istenen sayfaya 
erişilemiyor. --Veya— Bu sayfa görüntülenemiyor 

• Uygulama günlüğü: Giriş yok 

• ASP.NET Core modülü stdout günlüğü: Günlük dosyası oluşturulmaz. 

• ASP.NET Core modülü hata ayıklama günlüğü: Günlük dosyası oluşturulmaz. 

Sorun Giderme: 

• Doğru rolün etkin olduğunu onaylayın. Bkz. IIS yapılandırması. 

• Programlar & Özellikler veya uygulamalar & özellikleri açın ve VVindovvs Server barındırma nın 

yüklü olduğunu doğrulayın. Yüklü programlar listesinde VVindovvs Server barındırma yoksa, .NET Core 
barındırma paketi ' ni indirip yükleyin. 

Geçerli .NET Core barındırma Paket Yükleyici (doğrudan indirme) 

Daha fazla bilgi için bkz. .NET Core barındırma paketini yüklemeye. 

• Uygulama havuzunun > İşlem modeli > kimliğinin applicationpokaydentity olarak ayarlandığından 
emin olun veya özel kimliğin uygulamanın dağıtım klasörüne erişmek için doğru izinlere sahip olduğundan 
emin olun. 

• ASP.NET Core barındırma paketini kaldırdıysanız ve barındırma paketinin önceki bir sürümünü 
yüklediyseniz ApplicationHost. config dosyası ASP.NET Core modülü için bir bölüm içermez. 

Application Hoşt, config dosyasını % windir%/system32/inetsrv/config konumunda açın ve 

<configurationxconfigSectionsxsectionGroup name="system.webServer"> bölüm grubunu bulun. Bölüm 
grubunda ASP.NET Core modülünün bölümü eksikse, Bölüm öğesini ekleyin: 

<section name="aspNetCore" overrideModeDefault="Allow" /> 

Alternatif olarak, AS P.N ET Core barındıran paketin en son sürümünü de yüklersiniz. En son sürüm, 
desteklenen AS P.N ET Core uygulamalarla geriye dönük olarak uyumludur. 


Hatalı processPath, eksik yol değişkeni, barındırma paketi yüklü değil, 
sistem/IIS yeniden başlatılmadı, VC + + yeniden dağıtılabilir yüklü değil 
veya DotNet. exe erişim ihlali 




• Tarayıcı: HTTP hatası 500,0-lşlem İçi Işleyici yükleme hatası 

• Uygulama günlüğü: ' C:{PATH}' fiziksel köküne sahip 1 MACHıNE/WEBROOT/APPHOST/{ASSEMBLY}' 
uygulaması,' 1 komut satırı ile işlem başlatamadıErrorCode = ' 0x80070002:0. 1 {PATH} 1 uygulaması 
başlatılamadı. 1 {PATH}' konumunda yürütülebilir dosya bulunamadı. '/LM/W3SVC/2/ROOT 1 uygulaması 
başlatılamadı, hata kodu ' 0x8007023e '. 

• ASP.NET Core modülü stdout günlüğü: Günlük dosyası oluşturulmaz. 

• ASP.NET Core modülü hata ayıklama günlüğü: Olay günlüğü:' {PATH}' uygulaması başlatılamadı. 1 
{PATH} 1 konumunda yürütülebilir dosya bulunamadı. Başarısız HRESULT döndürüldü: 0x8007023e 

• Tarayıcı: HTTP hatası 502,5-lşlem hatası 

• Uygulama günlüğü: ' C:{PATH}' fiziksel köküne sahip 1 MACHıNE/WEBROOT/APPHOST/{ASSEMBLY}' 
uygulaması,' ' "{...}" komut satırı ile işlem başlatamadı ', ErrorCode = ' 0x80070002:0. 

• ASP.NET Core modülü stdout günlüğü: Günlük dosyası oluşturulur ancak boştur. 

Sorun Giderme: 

• Uygulamanın Kestrel üzerinde yerel olarak çalıştığını doğrulayın, işlem hatası, uygulamanın içindeki bir 
sorunun sonucu olabilir. Daha fazla bilgi için bkz. Azure App Service ve IIS 'de ASP.NET Core sorunlarını 
giderme. 

• Çerçeveye bağlı bir dağıtım (FDD) veya kendi kendine dahil olan bir dağıtım için . \{assembly}. exe dotnet 
olduğunu doğrulamak için Web. config 'deki <aspNetcore> öğesindeki processPath ÖZNITELIĞINI kontrol 
edin (SCD). 

• FDD için, DotNet. exe ' nin yol ayarları aracılığıyla erişilebilir olmayabilir. C:\Program Files\dotnet\ sistem 
yolu ayarlarında bulunduğunu onaylayın. 

• FDD için, DotNet. exe ' yi uygulama havuzunun Kullanıcı kimliği için erişilebilir olmayabilir.Uygulama 
havuzu Kullanıcı kimliğinin C:\Program Files\dotnet dizinine erişimi olduğunu doğrulayın. C:\Program 
Files\dotnet\/e uygulama dizinlerindeki uygulama havuzu Kullanıcı kimliği için yapılandırılmış reddetme 
kuralı olmadığını doğrulayın. 

• Bir FDD dağıtılmış ve IIS 'nin yeniden başlatılmasına gerek kalmadan .NET Core yüklenmiş olabilir. Bir 
komut isteminden net stop was/y ve ardından net start w3svc ' i yürüterek sunucuyu YENİDEN başlatın ya 
da IIS 'yi yeniden başlatın. 

• Bir FDD, barındırma sistemine .NET Core çalışma zamanı yüklenmeden dağıtılmış olabilir..NET Core çalışma 
zamanı yüklenmemişse, sistemde .N ET Core barındırma paketi yükleyicisini çalıştırın. 

Geçerli .NET Core barındırma Paket Yükleyici (doğrudan indirme) 

Daha fazla bilgi için bkz. .NET Core barındırma paketini yüklemeye. 

Belirli bir çalışma zamanı gerekliyse, .net dovvnload arşivleri ' nden çalışma zamanını indirin ve sisteme 
yükleyin. Bir komut isteminden net stop idi ve ardından net start w3svc ' i yürüterek SİSTEMİ yeniden 
başlatarak veya IIS 'yi yeniden başlatarak yüklemeyi doldurun. 

<aspNetCore > öğesinin bağımsız değişkenleri yanlış 

• Tarayıcı: HTTP hatası 500,0-lşlem İçi Işleyici yükleme hatası 

• Uygulama günlüğü: InProcess istek işleyicisini bulmak için hostfxr çağırma hiçbir yerel bağımlılığı 
bulamamadan başarısız oldu. Büyük olasılıkla uygulamanın yanlış yapılandırılmış olduğu anlamına gelir, 
lütfen uygulamanın hedeflediği ve makinede yüklü olduğu Microsoft. NetCore. App ve Microsoft. 






AspNetCore. app sürümlerini denetleyin. InProcess istek işleyicisi bulunamadı. Hostfxr çağırmadan 
yakalanan çıkış: DotNet SDK komutlarını çalıştırmak mı istediniz? Lütfen 7LM/W3SVC/3/ROOT 1 
uygulaması başlatılamadı, hata kodu 1 0x8000FFFF https://go.microsoft.com/fwlink/? 

Linki D = 798306&cicid = 0x409. 

• ASP.NET Core modülü stdout günlüğü: DotNet SDK komutlarını çalıştırmak mı istediniz? Lütfen ' dan 
DotNet SDK 'Yı yükledikten sonra: https://go.microsoft.com/fwlink/?LinklD = 798306&clcid=0x409 

• ASP.NET Core modülü hata ayıklama günlüğü: InProcess istek işleyicisini bulmak için hostfxr çağırma 
hiçbir yerel bağımlılığı bulamamadan başarısız oldu. Büyük olasılıkla uygulamanın yanlış yapılandırılmış 
olduğu anlamına gelir, lütfen uygulamanın hedeflediği ve makinede yüklü olduğu Microsoft. NetCore. App 
ve Microsoft. AspNetCore. app sürümlerini denetleyin. Başarısız HRESULT döndürüldü: 0x8000FFFF, 
InProcess istek işleyicisi bulamadı. Hostfxr çağırmadan yakalanan çıkış: DotNet SDK komutlarını çalıştırmak 
mı istediniz? Lütfen şu kaynaktan DotNet SDK 'Yı yüklersiniz: https://go.microsoft.com/fwlink/? 

LinklD = 798306&clcid = 0x409 başarısız HRESULT döndürüldü: 0x8000FFFF 

• Tarayıcı: HTTP hatası 502,5-lşlem hatası 

• Uygulama günlüğü: ' C:{PATH)' fiziksel köküne sahip 1 MACHıNE/WEBROOT/APPHOST/{ASSEMBLY}' 
uygulaması'' "DotNet" komut satırı ile işleme başlatılamadı.iASSEMBLY}. dilErrorCode = ' 
0x80004005:80008081. 

• ASP.NET Core modülü stdout günlüğü: Yürütülecek uygulama yok: 1 yolfDERLEMESI). dil' 

Sorun Giderme: 

• Uygulamanın Kestrel üzerinde yerel olarak çalıştığını doğrulayın, işlem hatası, uygulamanın içindeki bir 
sorunun sonucu olabilir. Daha fazla bilgi için bkz. Azure App Service ve 11S 'de ASP.NET Core sorunlarını 
giderme. 

• Framework'e bağımlı bir dağıtım (FDD) için .\{ASSEMBLY}.diı (a) olduğunu doğrulamak üzere Web. config 
içindeki <aspNetcore> öğesindeki argumerıts özniteliğini inceleyin; ya da (b) yok, boş bir dize ( arguments="" 
veya bağımsız bir dağıtım için ( arguments="{ARGUMENT_i} J {argumen^}, ... {argument_x}" ) uygulamanın 
bağımsız değişkenlerinin bir listesi (SCD). 

Eksik .NET Core paylaşılan çerçevesi 

• Tarayıcı: HTTP hatası 500,0-lşlem İçi Işleyici yükleme hatası 

• Uygulama günlüğü: InProcess istek işleyicisini bulmak için hostfxr çağırma hiçbir yerel bağımlılığı 
bulamamadan başarısız oldu. Büyük olasılıkla uygulamanın yanlış yapılandırılmış olduğu anlamına gelir, 
lütfen uygulamanın hedeflediği ve makinede yüklü olduğu Microsoft. NetCore. App ve Microsoft. 
AspNetCore. app sürümlerini denetleyin. InProcess istek işleyicisi bulunamadı. Hostfxr çağırmadan 
yakalanan çıkış: herhangi bir uyumlu çerçeve sürümü bulmak mümkün değildi. Belirtilen 1 Microsoft. 
AspNetCore. App 1 çerçevesi, 1 {VERSION} 1 sürümü bulunamadı. 

'/LM/W3SVC/5/ROOT 1 uygulaması başlatılamadı, hata kodu ' 0x8000FFFF '. 

• ASP.NET Core modülü stdout günlüğü: Uyumlu bir çerçeve sürümü bulmak mümkün değildi. Belirtilen ' 
Microsoft. AspNetCore. App ' çerçevesi,' {VERSION}' sürümü bulunamadı. 

• ASP.NET Core modülü hata ayıklama günlüğü: Başarısız HRESULT döndürüldü: 0x8000FFFF 

Sorun Giderme: 

Çerçeveye bağımlı bir dağıtım (FDD) için, sistemde doğru çalışma zamanının yüklü olduğunu doğrulayın. 




Uygulama havuzu durduruldu 

• Tarayıcı: 503 Hizmet kullanılamıyor 

• Uygulama günlüğü: Giriş yok 

• ASP.NET Core modülü stdout günlüğü: Günlük dosyası oluşturulmaz. 

• ASP.NET Core modülü hata ayıklama günlüğü: Günlük dosyası oluşturulmaz. 

Sorun Giderme: 

Uygulama havuzunun durdurulmuş durumda olmadığını onaylayın. 

Alt uygulama bir <işleyicileri içerir > Bölüm 

• Tarayıcı: HTTP hatası 500,19-lç sunucu hatası 

• Uygulama günlüğü: Giriş yok 

• ASP.NET Core modülü stdout günlüğü: Kök uygulamanın günlük dosyası oluşturulur ve normal işlemi 
gösterir. Alt uygulamanın günlük dosyası oluşturulmaz. 

• ASP.NET Core modülü hata ayıklama günlüğü: Kök uygulamanın günlük dosyası oluşturulur ve normal 
işlemi gösterir. Alt uygulamanın günlük dosyası oluşturulmaz. 

Sorun Giderme: 

Alt uygulamanın Web. corıfig dosyasının <handiers> bir bölüm içermediğinden veya alt uygulamanın üst 
uygulamanın işleyicilerini almadığından emin olun. 

Web. config dosyasının üst uygulamanın <system.webServer> bölümü bir <iocation> öğesinin içine yerleştirilir. 
InheritlnChildApplications özelliği, clocation > öğesi içinde belirtilen ayarların üst uygulamanın bir alt dizininde 
bulunan uygulamalar tarafından devralınmadığını göstermek için faise olarak ayarlanır. Daha fazla bilgi için bkz. 
ASP.NET Core Modülü. 

Alt uygulamanın Web. config dosyasının <handiers> bir bölüm içermediğinden emin olun. 

stdout günlük yolu yanlış 

• Tarayıcı: Uygulama normal olarak yanıt verir. 

• Uygulama günlüğü: C:\Program Files\IIS\Asp.Net Core Module\v2\aspnetcorev2.dll' de stdout yeniden 
yönlendirmesi başlatılamadı. Özel durum iletisi: {PATH} 

\aspnetcoremodulev2\commonlib\fileoutputmanager.cpp: 84 konumunda HRESULT 0x80070005 
döndürüldü. C:\Program Files\IIS\Asp.Net Core Module\v2\aspnetcorev2.dll' de stdout yeniden 
yönlendirmesi durdurulamadı. Özel durum iletisi: HRESULT 0x80070002 {PATH} konumunda döndürüldü. 
{PATH} \ aspnetcorev2_inprocess. dil içinde stdout yeniden yönlendirmesi başlatılamadı. 

• ASP.NET Core modülü stdout günlüğü: Günlük dosyası oluşturulmaz. 

• ASP.NET Core modülü hata ayıklama günlüğü: C:\Program Files\IIS\Asp.Net Core 
Module\v2\aspnetcorev2.dll 1 de stdout yeniden yönlendirmesi başlatılamadı. Özel durum iletisi: {PATH} 
\aspnetcoremodulev2\commonlib\fileoutputmanager.cpp: 84 konumunda HRESULT 0x80070005 
döndürüldü. C:\Program Files\IIS\Asp.Net Core Module\v2\aspnetcorev2.dll' de stdout yeniden 
yönlendirmesi durdurulamadı. Özel durum iletisi: HRESULT 0x80070002 {PATH} konumunda döndürüldü. 
{PATH} \ aspnetcorev2_inprocess. dil içinde stdout yeniden yönlendirmesi başlatılamadı. 

• Uygulama günlüğü: Uyarı: stdoutLogFile \oluşturulamadı?{yol} \ path_doesnt_exist \ stdout_ {İşlem 






KİMLİĞİ} _ {zaman DAMGASı}. günlük, hata kodu =-2147024893. 

• ASP.NET Core modülü stdout günlüğü: Günlük dosyası oluşturulmaz. 

Sorun Giderme: 

• Web. config dosyasının <aspNetcore> öğesinde belirtilen stdoutLogFile yolu yok. Daha fazla bilgi için bkz. 
ASP.NET Core modülü: günlük oluşturma ve yeniden yönlendirme. 

• Uygulama havuzu kullanıcısının stdout günlük yoluna yazma erişimi yok. 

Uygulama yapılandırması genel sorunu 

• Tarayıcı: HTTP hatası 500,0-lşlem İçi Işleyici yükleme hatası —veya— HTTP hatası 500,30-Ancm İşlem İçi 
başlatma hatası 

• Uygulama günlüğü: Değişken 

• ASP.NET Core modülü stdout günlüğü: Günlük dosyası oluşturulur ancak boş veya, uygulamanın noktası 
başarısız olana kadar normal girdilerle oluşturulur. 

• ASP.NET Core modülü hata ayıklama günlüğü: Değişken 

• Tarayıcı: HTTP hatası 502,5-lşlem hatası 

• Uygulama günlüğü: ' C:{PATH} fiziksel köküne sahip 1 MACHıNE/WEBROOT/APPHOST/{ASSEMBLY}' 
uygulaması' ' "C:{PATH}{ASSEMBLY} komut satırı ile oluşturulan işlem oluşturdu. {exe | dil}ancak 
belirtilen ' {PORT}' bağlantı noktasında kilitlenen veya yanıt vermeyen ya da bu bağlantı noktası üzerinde 
dinleme yapamadı, ErrorCode = 1 {ERROR CODE}' 

• ASP.NET Core modülü stdout günlüğü: Günlük dosyası oluşturulur ancak boştur. 

Sorun Giderme: 

Büyük olasılıkla uygulama yapılandırması veya programlama sorunu nedeniyle işlem başlatılamadı. 

Daha fazla bilgi için aşağıdaki konulara bakın: 

• Azure App Service ve MS 'de ASP.NET Core sorunlarını giderme 

• ASP.NET Core projeleri sorunlarını giderme 




ASPNET Core - Öğreticisi 1. 8'de Entity 
Framevvork Core ile Razor sayfaları 

23.11.2019 * 53 minutes to read ı Edit Online 


Tarafından Tom Dykstra ve Rick Anderson 

Bu, bir ASP.NET Core Razor Pages uygulamasında ENTİTY Framework (EF) çekirdeğini nasıl 
kullanacağınızı gösteren bir öğretici serisinin ilkisidir. Öğreticiler, kurgusal bir Contoso Üniversitesi 
için bir Web sitesi oluşturur. Site, öğrenci giriş, kurs oluşturma ve eğitmen atamaları gibi işlevleri 
içerir. 

indirme veya tamamlanmış uygulamayı görüntüleyin. Yükleme yönergeleri. 

Önkoşullar 

• Razor Pages yeni başladıysanız, bu duruma başlamadan önce Razor Pages öğretici serisini 
kullanmaya başlayın. 

• Visual Studio 

• Visual Studio Code 

• ASP.net ve Web geliştirme iş yüküyle Visual Studio 2019 

• .NET Core 3,0 SDK veya üzeri 

Veritabanı altyapıları 

Visual Studio yönergeleri, yalnızca Windows üzerinde çalışan bir SQL Server Express sürümü olan 

SQL Server LocalDB'yi kullanır. 

Visual Studio Code yönergeler, platformlar arası bir veritabanı altyapısı olan SQLİtekullanır. 

SQLİte kullanmayı seçerseniz, SQLİte İçin DB tarayıcısıgibi bir SQLİte veritabanını yönetmek ve 
görüntülemek için üçüncü taraf bir araç indirip yükleyin. 

Sorun giderme 

Giderebileceğiniz bir sorunla karşılaşırsanız, kodunuzu Tamamlanan projeylekarşılaştırın. Yardım 
almanın iyi bir yolu, ASP.NET Core etiketi veya EF Core etiketikullanılarak StackOverflow.com 'e bir 
soru göndererek. 

Örnek uygulama 

Aşağıdaki öğreticilerde oluşturulan bir uygulamayı bir temel university web sitesidir. Kullanıcılar 
görüntüleyebilir ve Öğrenci, kurs ve Eğitmen bilgileri güncelleştirin. Öğreticide oluşturulan ekranlar 
birkaçını aşağıda verilmiştir. 
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Bu sitenin kullanıcı arabirimi stili yerleşik proje şablonlarına dayalıdır.Öğreticinin odağı, Kullanıcı 
arabirimini nasıl özelleştireceğinizi değil EF Core kullanma konusunda yer alır. 

Tamamlanan projenin kaynak kodunu almak için sayfanın üst kısmındaki bağlantıyı izleyin. Cu30 
klasörü, öğreticinin AS P.N ET Core 3,0 sürümü için kod içerir. 1 -7 öğreticileri için kodun durumunu 
yansıtan dosyalar cu30snapshots klasöründe bulunabilir. 

• Visual Studio 

• Visual Studio Code 


Tamamlanmış projeyi indirdikten sonra uygulamayı çalıştırmak için: 














• Üç dosyayı ve ad içinde SÇLİte içeren bir klasörü silin. 

• Projeyi oluşturun. 

• Paket Yöneticisi konsolu 'nda (PMC) aşağıdaki komutu çalıştırın: 

Update-Database 

• Veritabanını temel alarak projeyi çalıştırın. 

Web uygulaması projesi oluşturma 

• Visual Studio 

• Visual Studio Code 

• Visual Studio'dan dosya menüsünde yeni > proje. 

• Seçin ASP.NET Core Web uygulaması. 

• Projeyi adlandırın ContosoUn'ıverslty. Büyük harfler de dahil olmak üzere bu tam adı kullanmak 
önemlidir, bu nedenle kod kopyalanıp yapıştırılırken ad alanları eşleşir. 

• Açılan menüden .N ET Core ve 3,0 ASP.NET Core seçin ve ardından Web uygulaması' nı seçin. 

Site stili Ayarla 

Sayfa/paylaşdan/_Layout. cshtml'yl güncelleştirerek site üst bilgisini, alt bilgisini ve menüsünü 
ayarlayın: 

• "Contoso Üniversitesi" için "ContosoUniversity" her örneğini değiştirin. Üç örnekleri vardır. 

• Giriş ve Gizlilik menü girişlerini silin ve hakkında, öğrenciler, Kurslar, eğitmenlerve 
Departmanlariçin girişler ekleyin. 


Değişiklikler vurgulanır. 




<!DOCTYPE html> 

<html lang="en"> 

<head> 

<meta chanset="utf-8" /> 

<meta name="viewport" content="width=device-widthj initial-scale=1.0" /> 
<title>@ViewData["Title"] - Contoso University</title> 

<link rel="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.css" /> 

<link rel="stylesheet" href="~/css/site.css" /> 

</head> 

<body> 

<header> 

<nav class="navbar navbar-expand-sm navbar-toggleable-sm navbar-light bg-white border- 
bottom box-shadow mb-3"> 

<div class="container"> 

<a class="navban-brand" asp-area="" asp-page="/Index">Contoso University</a> 
<button class="navbar-toggler" type="button" data-toggle="collapse" data- 
target=".navbar-collapse" aria-controls="navbarSupportedContent" 

aria-expanded="false" aria-label="Toggle navigation"> 

<span class="navbar-toggler-icon"x/span> 

</button> 

<div class="navban-collapse collapse d-sm-inline-flex flex-sm-row-reverse"> 

<ul class="navbar'-nav flex-grow-l"> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-anea="" asp-page="/About">About</a> 
</li> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-area="" asp- 
page="/Students/Index">Students</a> 

</li> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-area="" asp- 
page="/Courses/Index">Counses</a> 

</li> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-area="" asp- 
page="/Instructors/Index">Instructors</a> 

</li> 

di class="nav-item"> 

<a class="nav-link text-dark" asp-area="" asp- 
page="/Depantments/Index">Departments</a> 

</li> 

</ul> 

</div> 

</div> 

</nav> 

</headen> 

<div class="container"> 

<main role="main" class="pb-3"> 

@RenderBody() 

</main> 

</div> 

<footer class="border-top footen text-muted"> 

<div class="contain8r"> 

Scopy; 2019 - Contoso University - <a asp-area="" asp-page="/Pnivacy">Privacy</a> 
</div> 

</footen> 

<script src="~/lib/jquery/dist/jquery. js"x/script> 

<script src="~/lib/bootstrap/dist/js/bootstrap. bundle. js"x/scnipt> 

<script snc="~/js/site.js" asp-append-version="true"x/scnipt> 

@RenderSection("Scripts"j nequired: false) 

</body> 

</html> 



Pages/lndex. cs/ıfm/dosyasında, AS P.N ET Core hakkındaki metni bu uygulamayla ilgili metinle 
değiştirmek için dosyanın içeriğini aşağıdaki kodla değiştirin: 

@page 

@model IndexModel 

@{ 

ViewData["Title"] = "Home page"; 

} 

<div class="row mb-auto"> 

<div class="col-md-4"> 

<div class="row no-gutters border mb-4"> 

<div class="col p-4 mb-4 "> 

<p class="card-text"> 

Contoso University is a sample application that 
demonstrates how to use Entity Framework Core in an 
ASP.NET Core Razor Pages web app. 

</p> 

</div> 

</div> 

</div> 

<div class="col-md-4"> 

<div class="row no-gutters border mb-4"> 

<div class="col p-4 d-flex flex-column position-static"> 

<p class="card-text mb-auto"> 

You can build the application by following the steps in a series of 

tutorials. 

</p> 

<P> 

<a href="https://docs.microsoft.com/aspnet/core/data/ef-rp/intro" 
class="stretched-link">See the tutorial</a> 

</p> 

</div> 

</div> 

</div> 

<div class="col-md-4"> 

<div class="row no-gutters border mb-4"> 

<div class="col p-4 d-flex flex-column"> 

<p class="card-text mb-auto"> 

You can download the completed project from GitHub. 

</p> 

<P> 

<a 

href="https://github.com/aspnet/AspNetCore.Docs/tree/master/aspnetcore/data/ef-rp/intro/samples" 
class="stretched-link">See project source code</a> 

</p> 

</div> 

</div> 

</div> 

</div> 


Giriş sayfasının göründüğünü doğrulamak için uygulamayı çalıştırın. 

Veri modeli 


Aşağıdaki bölümler bir veri modeli oluşturur: 




Course 


Enrollment 


Student 


Properties 
yî CourselD 

A Title 

A Credits 

0-C 

1 

Properties 
ıfi EnrolImentlD 

A CourselD 

A StudentiD 

A Grade 

0-0 

* 1 

Properties 
yî İD 

A LastName 

A FirstMidName 

A EnrolImentDate 

Navigation Properties 
y3 Enrollments 

Navigation Properties 

Navigation Properties 


y3 Course 
y3 Student 


y3 Enrollments 





Bir öğrenci herhangi bir sayıda kursa kaydolabilir ve bir kurs, kayıtlı sayıda öğrenciye sahip olabilir. 

Öğrenci varlık 


Student 


Properties 
V? İD 

A LastName 
A FirstMidName 
A EnrolImentDate 
Navigation Properties 
y'S Enrollments 


• Proje klasöründe bir modeller klasörü oluşturun. 

• Aşağıdaki kodla modeller/öğrenci, cs oluşturun: 

using System; 

using System.Collections.Generic; 

namespace ContosoUniversity.Models 
{ 

public class Student 
{ 

public int ID { get; set; } 
public string LastName { get; set; } 
public string FirstMidName { get; set; } 
public DateTime EnrolImentDate { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 

id özelliği, bu sınıfa karşılık gelen veritabanı tablosunun birincil anahtar sütunu olur. Varsayılan 
olarak EF Core adlı bir özellik yorumlar id veya ciassnameiD birincil anahtar olarak. Bu nedenle, 
student sınıfı birincil anahtarı için otomatik olarak tanınan ad studentiD . 

Enrollments Özelliği bir gezinti özelliği. Gezinti özellikleri, bu varlıkla ilgili diğer varlıkları tutar. Bu 
durumda, bir Student varlığının Enrollments Özelliği SÖZ konusu öğrenci ile ilgili Enrollment 
varlıkların tümünü barındırır. Örneğin, veritabanındaki bir öğrenci satırında iki ilişkili kayıt satırı varsa, 
Enrollments gezinti özelliği bu iki kayıt varlığını içerir. 

Veritabanında, bir kayıt satırı, Studentitıd sütunu öğrencinin İD değerini içeriyorsa bir öğrenci satırıyla 
ilgilidir. Örneğin, bir öğrenci satırının İD = 1 olduğunu varsayalım. İlgili kayıt satırları Studentitıd = 1 
olacaktır. Studentitıd, kayıt tablosundaki bir yabana anahtardır . 

Birden çok ilgili kayıt varlığı olabileceğinden Enrollments özelliği ıcoiiection<Enroiiment> olarak 



































tanımlanır. List<Enroiiment> veya HashSet<Enroiiment> gibi başka koleksiyon türleri de 
kullanabilirsiniz. Zaman ıcoiiection<Enroiiment> olduğu EF Core kullanıldığında, oluşturur bir 
HashSet<Enroiiment> varsayılan olarak koleksiyon. 

Kayıt varlık 


Enrollment 



t 

public enum Grade 
{ 


A, Bj C, D, F 

} 

public class Enrollment 
{ 

public int EnrollmentlD { get; set; } 
public int CourselD { get; set; } 
public int StudentlD { get; set; } 
public Grade? Grade { get; set; } 

public Course Course { get; set; } 
public Student Student { get; set; } 

} 

} 

EnrollmentlD özelliği birincil anahtardır; Bu varlık, id yerine ciassnameiD modelini kullanır. Bir 
üretim veri modeli için bir model seçin ve bunu tutarlı bir şekilde kullanın. Bu öğretici her ikisinin de 
yalnızca bir iş olduğunu göstermek için kullanır, ciassname olmadan id kullanmak, bazı veri modeli 
değişikliklerinin uygulanmasını kolaylaştırır. 

Grade Özelliği bir enum . Grade türü bildiriminden sonraki soru işareti, Grade özelliğinin null 
yapılabiIi rolduğunu gösterir. Null olan bir sınıf sıfır bir sınıfa göre farklılık gösterir—null, henüz bir 
sınıf bilinmediğini veya henüz atanmadığını belirtir. 

StudentlD Özelliği olduğundan yabancı anahtar ve karşılık gelen gezinme özelliğini student .Bir 
Enrollment varlıktır biriyle ilişkili student tek bir özellik içerecek şekilde varlık student varlık. 

CourselD Özelliği olduğundan yabancı anahtar ve karşılık gelen gezinme özelliğini course .Bir 
Enrollment varlıktır biriyle ilişkili course varlık. 

EF Core adlandırılmışsa, bu özellik bir yabancı anahtar olarak yorumlar 


<navigation property namexprimary key property name> 

. Örneğin, student varlığın birincil anahtarı 

id olduğundan, student gezinti özelliği için StudentlD 

yabancı anahtardır. Yabancı anahtar özellikleri 

de adi <primary key property name> . Örneğin, CourselD 

beri course varlığın birincil anahtarı 

CourselD . 





























Kurs varlık 



using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations.Schema; 


namespace ContosoUniversity.Models 
{ 

public class Course 
{ 

[DatabaseGenerated(DatabaseGeneratedOption.None)] 
public int CourselD { get; set; } 
public stning Title { get; set; } 
public int Credits { get; set; } 

public ICollection<Ennollment> Enrollments { get; set; } 

} 

} 

Enrollments Özelliktir bir gezinme özelliği. A course varlık dilediğiniz sayıda ilgili olabileceğini 
Enroiiment varlıklar. 

DatabaseGenerated özniteliği, uygulamanın veritabanını oluşturmak yerine birincil anahtarı 
belirtmesini sağlar. 

Derleyici hatası olmadığını doğrulamak için projeyi derleyin. 

Yapı iskelesi öğrenci sayfaları 

Bu bölümde, oluşturmak için ASP.NET Core scafkatlama aracını kullanırsınız: 

• EF Core bağlamı sınıfı. Bağlam, belirli bir veri modeli için Entity Framevvork işlevselliği koordine 
eden ana sınıftır. Microsoft.EntityFrameworkCore.DbContext sınıfından türetilir. 

• student varlık için oluşturma, okuma, güncelleştirmeye silme (CRUD) işlemlerini işleyen Razor 
sayfaları. 

• Visual Studio 

• Visual Studio Code 

• Sayfalar klasöründe bir öğrenciler klasörü oluşturun. 

• Çözüm Gezgini, Sayfalar/öğrenciler klasörüne sağ tıklayın ve > yeni yapı iskelesi öğesi Ekle ' 
yi seçin. 

• İçinde İskele Ekle iletişim kutusunda Entity Framevvork (CRU D) kullanarak Razor sayfaları > 
ekleme. 

• Entity Framevvork kullanarak Razor Pages Ekle (CRU D) iletişim kutusunda: 

o içinde Model sınıfı açılan listesinde, select Öğrenci (ContosoUniversity.Models). 
o Veri bağlamı sınıfı satırında + (artı) işaretini seçin. 











o Contosouniversity. modeller. Contosoünlversıtycontext olan veri bağlamı adını 
Contosourıiversity. Data. SchoolContexto\arak değiştirin. 

O Add (Ekle) seçeneğini belirleyin. 

Aşağıdaki paketler otomatik olarak yüklenir: 

• Microsoft. VisualStudio. Web. CodeGeneration. Design 

• Microsoft.EntityF rameworkCore.SqlServer 

• Microsoft.Extensions.Logging.Debug 

• Microsoft.EntityFrameworkCore.Tools 

Önceki adımla ilgili bir sorununuz varsa, projeyi derleyin ve yapı iskelesi adımını yeniden deneyin. 
Yapı iskelesi işlemi: 

• Sayfalar/öğrenciler klasöründe Razor sayfaları oluşturur: 
o . Cshtml ve Create.cshtml.es oluşturma 

o De/efe. cshtml ve delete.cshtml.es 
o Detalls. cshtml ve detalls.cshtml.es 
o . Cshtml ve Edlt.cshtml.es Düzenle 
o lndex. cshtml ve lndex.cshtml.cs 

• Data/SchoolContext. csoluşturur. 

• Startup.cs\çr\de bağımlılık eklenmesine bağlam ekler. 

• AppSettlngs. JSONöğesme bir veritabanı bağlantı dizesi ekler. 

Veritabanı bağlantı dizesi 

• Visual Studio 

• Visual Studio Code 

Bağlantı dizesini belirtir SQL Server LocalDB. 

{ 

"Logging": { 

"LogLevel": { 

"Default": "Information ", 

"Microsoft": "l/Jarning", 

"Microsoft.Hosting.Lifetime": "Information" 

} 

b 

"AllowedHosts": 

"ConnectionStrings": { 

"SchoolContext": "Server= 

(localdb)\\mssqllocaldb;Database=SchoolContext;Trusted_Connection=True;MultipleActiveResultSets=t 

rue" 

} 

} 

LocalDB, SQL Server Express veritabanı Motoru'nu hafif bir sürümüdür ve uygulama geliştirme, 
üretim kullanımı için tasarlanmıştır. Varsayılan olarak, LocalDB c:/users/<user> dizininde. mdf 
dosyaları oluşturur. 

Veritabanı bağlam sınıfını Güncelleştir 

Belirli bir veri modeli için EF Core işlevselliğini koordine eden ana sınıf veritabanı bağlamı sınıfıdır. 
Bağlam Microsoft. EntityFramevvorkCore. DbContextöğesinden türetilir. Bağlam, veri modeline hangi 




varlıkların ekleneceğini belirtir. Bu projede adlı sınıfı schooicontext . 

Güncelleştirme SchoolContext.cs aşağıdaki kod ile: 

using Microsoft.EntityFrameworkCore; 
using ContosoUniversity.Models; 

namespace ContosoUniversity.Data 
{ 

public class SchoolContext : DbContext 
{ 

public SchoolContext (DbContextOptions<SchoolContext> options) 

: base(options) 

{ 

} 

public DbSet<Student> Students { get; set; } 
public DbSet<Enrollment> Enrollments { get; set; } 
public DbSet<Course> Courses { get; set; } 

protected override void OnModelCreating(ModelBuilder modelBuilder) 

{ 

modelBuilder.Entity<Course>().ToTable("Course"); 
modelBuilder.Entity<Enrollment>().ToTable("Enrollment"); 
modelBuilder.Entity<Student>().ToTable("Student"); 

} 

} 

} 

Vurgulanan kod oluşturur bir olan DBcTEntity > her varlık kümesi özelliği. EF Core terminolojisinde: 

• Bir varlık kümesi, genellikle bir veritabanı tablosuna karşılık gelir. 

• Bir varlık tablosunda bir satıra karşılık gelir. 

Bir varlık kümesi birden çok varlık içerdiğinden, DBSet özellikleri çoğul adlar olmalıdır.Scafkatlama 
aracı bir student DBSet oluşturduğundan, bu adım bunu plural students olarak değiştirir. 

Razor Pages kodun yeni DBSet adıyla eşleşmesini sağlamak için, tüm _context.student projesi 
genelinde _context.students için genel bir değişiklik yapın. 8 oluşum vardır. 

Derleyici hatası olmadığını doğrulamak için projeyi derleyin. 

Startup.es 

ASP.NET Core ile oluşturulmuş bağımlılık ekleme. Hizmetler (EF Core veritabanı bağlamı gibi) 
uygulama başlatma sırasında bağımlılık ekleme ile kaydedilir. Bu hizmetler (örneğin, Razor sayfaları) 
gerektiren bileşenler bu hizmetler Oluşturucu parametresi üzerinden sağlanır. Bir veritabanı bağlamı 
örneğini alan Oluşturucu kodu öğreticide daha sonra gösterilmiştir. 

Scafkatlama Aracı, bağlam sınıfını bağımlılık ekleme kapsayıcısına otomatik olarak kaydetti. 

• Visual Studio 

• Visual Studio Code 




configureServices , vurgulanan satırlar scaffolder tarafından eklenmiştir: 








public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRazorPages(); 


} 


Services.AddDbContext<SchoolContext>(options => 

options.UseSqlServer(Configuration.GetConnectionString("SchoolContext"))); 


Bağlantı dizesi adı için bağlam üzerinde bir yöntemi çağırarak geçirilen bir DbContextOptions nesne. 
Yerel geliştirme için AS P.N ET Core yapılandırma sistemi bağlantı dizesinden okur appsettings.jsorı 
dosya. 

Veritabanını oluşturma 

Mevcut değilse veritabanını oluşturmak için program.es güncelleştirin: 

using ContosoUniversity.Data; 

ıısing Microsoft.Extensions.DependencyInjection; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.Extensions.Hosting; 

using Microsoft.Extensions.Logging; 

using System; 

namespace ContosoUniversity 

{ 

public elass Program 

{ 

public static void Main(string[] args) 

{ 

var hoşt = CreateHostBuilder(args).Build(); 

CreateDbIfNotExists(host); 
host.Run(); 

} 

private static void CreateDbIfNotExists(IHost hoşt) 

{ 

using (var scope = hoşt.Services.CreateScope()) 

{ 

var Services = scope.ServiceProvider; 

try 

{ 

var context = Services.GetRequiredService<SchoolContext>(); 
context.Database.EnsureCreated(); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<ILogger<Program>>(); 
logger.LogError(eXj "An error occurred creating the DB."); 

} 

} 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 

} 

} 




Bağlam için bir veritabanı varsa, Ensuyeniden oluşturma yöntemi hiçbir eylemde bulunmaz. 
Veritabanı yoksa, veritabanını ve şemayı oluşturur. EnsureCreated , veri modeli değişikliklerini işlemek 
için aşağıdaki iş akışına izin vermez: 

• Veritabanını silin. Mevcut veriler kaybolur. 

• Veri modelini değiştirin. Örneğin, bir EmailAddress alanı ekleyin. 

• Uygulamayı çalıştırın. 

• EnsureCreated yeni şemaya sahip bir veritabanı oluşturur. 

Bu iş akışı, verileri korumanıza gerek olmadığı sürece, şema hızlı bir şekilde gelişen zaman geliştirme 
aşamasında iyi bir şekilde gerçekleştirilir. Veritabanına girilen verilerin korunması gerektiğinde bu 
durum farklıdır. Bu durumda, geçişleri kullanın. 

Öğretici serisinde daha sonra, EnsureCreated tarafından oluşturulan veritabanını silin ve bunun 
yerine geçişleri kullanın. EnsureCreated tarafından oluşturulan bir veritabanı, geçişler kullanılarak 
güncelleştirilemiyor. 

Uygulamayı test etme 

• Uygulamayı çalıştırın. 

• Seçin Öğrenciler bağlantısını ve ardından Yeni Oluştur. 

• Ayrıntılar, düzenleme, test edin ve bağlantılarını silin. 

Veritabanının çekirdeğini oluşturma 

EnsureCreated yöntemi boş bir veritabanı oluşturur. Bu bölüm, veritabanını test verileriyle dolduran 
kodu ekler. 

Aşağıdaki kodla veri/Dbmizer. cs oluşturun: 

using ContosoUniversity.Data; 
using ContosoUniversity.Models; 
using System; 
using System.Linq; 

namespace ContosoUniversity.Data 

{ 

public static class Dblnitializer 

{ 

public static void Initialize(SchoolContext context) 

{ 

context.Database.EnsureCreated(); 

// Look for any students. 
if (context.Students.Any()) 

{ 

return; // DB has been seeded 

} 

var students = new Student[] 

{ 

new 

Student{FirstMidName="Carson"j LastName="Alexander",EnrollmentDate=DateTime.Parse("2019-09-01")} J 
new 

Student{FirstMidName="Meredith"j Lastl\lame="Alonso", EnrollmentDate=DateTime.Parse("2017-09-01")}, 
new 

Student{FirstMidName="Arturo",LastName="Anand",EnrollmentDate=DateTime.Parse("2018-09-01")}, 
new 

Student{FirstMidName="Gytis",LastName="Barzdukas",EnrollmentDate=DateTime.Parse("2017-09-01")}, 

new Student{FirstMidName="Yan", LastName="Li", EnrollmentDate=DateTime. Parse("2017- 

09-01")}, 

new 








Student{FirstMidName="Peggy",LastName=":iustice",EnrollmentDate=DateTime.Parse("2016-09-01")}, 
new 

Student{FirstMidName="Laura",LastName="Norman",EnrollmentDate=DateTime.Parse("2018-09-01")}, 
new 

Student{FirstMidName="Nino",LastName="01ivetto",EnrollmentDate=DateTime.Parse("2019-09-01")} 

}; 

foreach (Student s in students) 

{ 

context.Students.Add(s); 

} 

context.SaveChanges(); 

var courses = new Course[] 

{ 

new Course{CourseID=1050,Title="Chemistry",Credits=3}, 
new Course{CourseID=4022,Title="Microeconomics",Credits=3}, 
new Course{CourseID=4041,Title="Macroeconomics",Credits=3}, 
new Course{CourseID=1045,Title="Calculus",Credits=4}, 
new Course{CourseID=3141,Title="Trigonometry",Credits=4}, 
new Course{CourseID=2021,Title="Composition",Credits=3}, 
new Course{CourseID=2042,Title="Literature",Credits=4} 

}; 

foreach (Course c in courses) 

{ 

context.Courses.Add(c); 

} 

context.SaveChanges(); 

var enrollments = new Enrollment[] 

{ 

new Enrollment{StudentID=l,CourseID=1050,Grade=Grade.A}, 
new Enrollment{StudentID=l,CourseID=4022,Grade=Grade.C}, 
new Enrollment{StudentID=l,CourseID=4041,Grade=Grade.B}, 
new Enrollment{StudentID=2,CourseID=1045,Grade=Grade.B}, 
new Enrollment{StudentID=2,CourseID=3141,Grade=Grade.F}, 
new Enrollment{StudentID=2,CourseID=2021,Grade=Grade.F}, 
new Enrollment{StudentID=3,CourseID=1050}, 
new Enrollment{StudentID=4,CourseID=1050}, 
new Enrollment{StudentID=4,CourseID=4022,Grade=Grade.F}, 
new Enrollment{StudentID=5,CourseID=4041,Grade=Grade.C}, 
new Enrollment{StudentID=6,CourseID=1045}, 
new Enrollment{StudentID=7,CourseID=3141,Grade=Grade.A}, 

}; 

foreach (Enrollment e in enrollments) 

{ 

context.Enrollments.Add (e); 

} 

context.SaveChanges(); 

} 

} 

} 

Kod, veritabanında herhangi bir öğrenci olup olmadığını denetler.Öğrenci yoksa, veritabanına test 
verileri ekler. Performansı iyileştirmek için List<T> koleksiyonları yerine diziler halinde test verileri 
oluşturur. 

• Program.es' de EnsureCreated çağrısını Dbinitializer.initialize çağrısıyla değiştirin: 

// context.Database.EnsureCreated(); 

Dblnitializer.Initialize(context); 


• Visual Studio 

• Visual Studio Code 






Çalışıyorsa uygulamayı durdurun ve Paket Yöneticisi konsolunda (PMC) aşağıdaki komutu 
çalıştırın: 

Drop-Database 

• Uygulamayı yeniden başlatın. 

• Sağlanan verileri görmek için öğrenciler sayfasını seçin. 

Veritabanını görüntüleme 

• Visual Studio 

• Visual Studio Code 

• Açık SQL Server Nesne Gezgini (SSOX) öğesinden görünümü Visual Studio'daki menü. 

• SSOX te, (LocalDB) \MSSQLLocalDB > veritabanları > SchoolContext-{GUID} öğesini 
seçin. Veritabanı adı, daha önce belirttiğiniz bağlam adından ve bir tire ve bir GUID ile oluşturulur. 

• Genişletin tabloları düğümü. 

• Sağ Öğrenci tablosu ve'ı tıklatın görünüm verilerini oluşturulan sütunları ve tabloya eklenen 
satırları görebilirsiniz. 

• student modelinin student tablo şemasına nasıl eşlendiğini görmek için öğrenci tablosuna sağ 
tıklayın ve kodu görüntüle ' ye tıklayın. 

Zaman uyumsuz kod 

Zaman uyumsuz programlama, ASP.NET Core ve EF Core için varsayılan moddur. 

Sınırlı sayıda iş parçacığı kullanılabilir bir web sunucusuna sahip ve yüksek yük durumlarda tüm 
kullanılabilir iş parçacıklarının kullanımda olabilir. Bu durum oluştuğunda, sunucunun iş 
parçacıklarının serbest bırakılana kadar yeni istekleri işleyemiyor. G/ç tamamlanması bekleniyor 
çünkü bunlar herhangi bir iş gerçekten yapmamanız sırasında eş zamanlı kod ile birçok iş parçacığı 
bağlanması. İşlemi tamamlamak, g/ç için beklerken zaman uyumsuz kod ile diğer istekleri işlemek 
için kullanılacak sunucuyu için kendi iş parçacığı serbest bırakılır. Sonuç olarak, zaman uyumsuz kod 
sunucu kaynaklarının daha verimli kullanılmasını sağlar ve sunucu gecikmeksizin daha fazla trafiği 
işleyebilir. 

Zaman uyumsuz kod, çalışma zamanında az miktarda bir ek yükü sunar. Düşük trafiğe durumlar, 
performans düşüşüne yüksek trafik durumlar için göz ardı edilebilir, çalışırken, olası performans 
geliştirmesi önemli. 

Aşağıdaki kodda, zaman uyumsuz anahtar sözcüğü, Task<T> dönüş değeri, await anahtar sözcüğü 
ve ToListAsync yöntemi zaman uyumsuz yürütülen kod olun. 

public async Task OnGetAsync() 

{ 

Students = await _context.Students.Tol_istAsync(); 

} 

• async Anahtar sözcüğü, derleyiciye bildirir: 

o Yöntem gövdesini bölümleri için geri çağırmaları oluşturur, 
o Döndürülen görev nesnesini oluşturun. 

• Task<T > dönüş türü devam eden çalışmayı temsil eder. 

• await Anahtar sözcüğü, derleyicinin yöntemin iki parçalara bölmek neden olur.ilk bölüm ile 












zaman uyumsuz olarak başlatıldığında işlemi sonlandırır. ikinci bölümü, işlemi tamamlandıktan 
sonra çağrılan bir geri çağırma yöntemi yerleştirilir. 

• ToListAsync zaman uyumsuz sürümüdür ToList genişletme yöntemi. 

EF Core kullanan zaman uyumsuz kodu yazarken dikkat edilmesi gereken bazı noktalar şunlardır: 

• Yalnızca sorguları veya komutlarının veritabanına gönderilmesine neden olan deyimler zaman 
uyumsuz olarak yürütülür. Bu ToListAsync, SingleOrDefaultAsync , FirstOrDefaultAsync ve 

saveChangesAsync içerir. Yalnızca değiştirmek deyimleri içermeyen bir iQuenyabie , gibi 
var students = context.Students.Where(s => s.LastName == "Davolio") . 

• EF Core bağlam iş parçacığı güvenli olmayan: paralel birden çok işlem yapmak yeniden 
denemeyin. 

• Zaman uyumsuz kodun performans avantajlarından yararlanmak için, veritabanına sorgu 
gönderen EF Core yöntemleri çağırıyorsa kitaplık paketlerinin (örneğin, sayfalama için) zaman 
uyumsuz olarak kullanılacağını doğrulayın. 

. N ET'te zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. zaman uyumsuz genel 

bakış ve zaman uyumsuz programlama ile async ve avvait. 

Sonraki adımlar 


SON RAKI 
ÖĞRETİCİ 


Contoso University örnek web uygulamasını, Entity Framevvork (EF) çekirdek kullanarak bir ASP.N ET 
Core Razor sayfalar uygulamasının nasıl oluşturulacağını gösterir. 

Örnek uygulama, kurgusal Contoso üniversite için bir web sitesidir.Öğrenci giriş, kurs oluşturma ve 
Eğitmen atamaları gibi işlevleri içerir. Contoso University örnek uygulamasının nasıl oluşturulacağını 
açıklayan öğreticileri serisinin ilk sayfadır. 

indirme veya tamamlanmış uygulamayı görüntüleyin. Yükleme yönergeleri. 

Önkoşullar 

• Visual Studio 

• Visual Studio Code 

Visual Studio 2019 aşağıdaki iş yükleri ile: 

• ASP.N ET ve web geliştirme 

• .NET core platformlar arası geliştirme 

.NET core 2.1 SDK veya üzeri 

Konusunda Razor sayfaları. Yeni programcılar tamamlamanız gereken Razor sayfaları kullanmaya 
başlama Bu seriyi başlatmadan önce. 

Sorun giderme 

Bir sorunla karşılaşırsanız, çözümleyemiyor çalıştırırsanız, genel olarak çözüm kodunuzda 
karşılaştırarak bulabilirsiniz projeyi. Soru göndererek Yardım almak için en iyi yolu olan 

StackOverflow.com için ASP.NET Core veya EF Core. 








Contoso University web uygulaması 

Aşağıdaki öğreticilerde oluşturulan bir uygulamayı bir temel university web sitesidir. 

Kullanıcılar görüntüleyebilir ve Öğrenci, kurs ve Eğitmen bilgileri güncelleştirin. Öğreticide 
oluşturulan ekranlar birkaçını aşağıda verilmiştir. 
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Bu sitenin Ul Stili yerleşik şablonları tarafından üretilen yakın 1 dir.EF çekirdekli Razor sayfaları, Ul ile 
öğretici odağı açıktır. 

ContosoUniversity Razor sayfaları web uygulaması oluşturma 

• Visual Studio 

• Visual Studio Code 

• Visual Studio'dan dosya menüsünde yeni > proje. 

• Yeni bir ASP.NET Core Web uygulaması oluşturun. Projeyi adlandırın ContosoUniversity. 
Projeyi adlandırın önemlidir ContosoUniversity kod kopyalanıp/yapıştırılmış ad alanları 
eşleştirmek için. 

• Seçin ASP.NET Core 2.1 açılır ve ardından Web uygulaması. 

Önceki adımlarda görüntüleri için bkz: Razor web uygulaması oluşturma. Uygulamayı çalıştırın. 

Site stili Ayarla 

Birkaç değişiklik site menü, Düzen ve giriş sayfası ayarlayın. Güncelleştirme 
Pages/Shared/_Layout.cshtml aşağıdaki değişikliklerle birlikte: 

• "Contoso Üniversitesi" için "ContosoUniversity" her örneğini değiştirin. Üç örnekleri vardır. 

• Menü girdileri eklemek Öğrenciler, kursları, Eğitmenler, ve Departmanlarve silme 
başvurun menüsü girişi. 

Değişiklikler vurgulanır. (Tüm biçimlendirme değil görüntülenir.) 














<!DOCTYPE html> 

<html> 

<head> 

<meta charset="utf-8" /> 

<meta name="viewport" content="width=device-widthj initial-scale=1.0" /> 
<title>@ViewData["Title"] : Contoso University</title> 

<environment include="Development"> 

<link rel="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.css" /> 

<link rel="stylesheet" href="~/css/site.css" /> 

</environment> 

<environment exclude="Development"> 

<link r8İ="stylesheet" 

href=" https://ajax.aspnetcdn.eom/ajax/bootstrap/3.3.7/css/bootstrap.min.css" 
asp-fallback-href="~/lib/bootstrap/dist/css/bootstrap.min.ess" 
asp-fallback-test-class="sr-only" asp-fallback-test-property="position" asp- 
fallback-test-value="absolute" /> 

<link rel="stylesheet" href="~/css/site.min.css" asp-append-version="true" /> 
</environment> 

</head> 

<body> 

<nav class="navbar navbar-inverse navbar-fixed-top"> 

<div class="container"> 

<div class="navbar-header"> 

<button type="button" class="navbar-toggle" data-toggle="collapse" data- 
target=".navbar-collapse"> 

<span class="sr-only">Toggle navigation</span> 

<span class="icon-bar"x/span> 

<span class="icon-bar"x/span> 

<span class="icon-bar"x/span> 

</button> 

<a asp-page="/Index" class="navbar-brand">Contoso University</a> 

</div> 

<div class="navbar-collapse collapse"> 

<ul class="nav navbar-nav"> 

<lixa asp-page="/Index">Home</ax/li> 

<lixa asp-page="/About">About</ax/li> 

<lixa asp-page="/Students/Index">Students</ax/li> 

<lixa asp-page="/Courses/Index">Courses</ax/li> 

<lixa asp-page="/Instructors/Index">Instructors</ax/li> 

<lixa asp-page="/Departments/Index">Departments</ax/li> 

</ul> 

</div> 

</div> 

</nav> 

<partial name="_CookieConsentPartial" /> 

<div class="container body-content"> 

@RenderBody() 

<hr /> 

<footer> 

<p>&copy; 2018 : Contoso University</p> 

</footer> 

</div> 

@*Remaining markup not shown for brevity.*@ 


içinde sayfa la r/dizin.cshtml, dosyanın içeriğini ASP.NET ve MVC hakkında metnin bu uygulama 
hakkında metinle değiştirmek için aşağıdaki kodla değiştirin: 



@page 

@model IndexModel 

@{ 

ViewData["Title"] = "Home page"; 

} 

<div class="jumbotron"> 

<hl>Contoso University</hl> 

</div> 

<div class="row"> 

<div class="col-md-4"> 

<h2>Welcome to Contoso University</h2> 

<P> 

Contoso Univensity is a sample application that 
demonstnates how to use Entity Framework Cone in an 
ASP.NET Core Razon Pages web app. 

</p> 

</div> 

<div class="col-md-4"> 

<h2>Build it from scratch</h2> 

<p>You can build the application by following the steps in a senies of tutorials.</p> 
<P> 

<a class="btn btn-default" 

href="https://docs.micnosoft.com/aspnet/core/data/ef-rp/intro"> 

See the tutorial &raquo; 

</a> 

</p> 

</div> 

<div class="col-md-4"> 

<h2>Download İt</h2> 

<p>You can download the completed project fnom GitHub.</p> 

<P> 

<a class="btn btn-default" 

href="https://github.com/aspnet/AspNetCore.Docs/tree/master/aspnetcore/data/ef- 
rp/intro/samples/"> 

See project source code &raquo; 

</a> 

</p> 

</div> 

</div> 


Veri modeli oluşturma 

Varlık sınıflarının Contoso University uygulama oluşturun. Aşağıdaki üç varlıklarla başlayın: 
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Bir-çok ilişkisi arasında student ve Enroiiment varlıklar. Bir-çok ilişkisi arasında course ve 
Enroiiment varlıklar. Bir öğrenci herhangi bir sayıda kursları kaydedebilirsiniz. Bir kurs herhangi bir 
sayıda Öğrenciler içinde kayıtlı olabilir. 

Aşağıdaki bölümlerde, bu varlıkların her biri için bir sınıf oluşturulur. 

Öğrenci varlık 
























Student 
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Oluşturma bir modelleri klasör, içinde modelleri klasöründe adlı bir sınıf dosyası oluşturma Student.es 
aşağıdaki kod ile: 

using System; 

using System.Collections.Generic; 

namespace ContosoUniversity.Models 
{ 

public elass Student 
{ 

public int ID { get; set; } 
public stning LastName { get; set; } 
public stning FirstMidName { get; set; } 
public DateTime EnrolImentDate { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 

id Özelliği bu sınıfa karşılık gelen veritabanı (DB) tablosunun birincil anahtar sütunu duruma gelir. 
Varsayılan olarak EF Core adlı bir özellik yorumlar id veya ciassnameiD birincil anahtar olarak, 
içinde ciassnameiD , elassname sınıf adıdır. Alternatif birincil anahtarı otomatik olarak kabul edilen 
studentiD önceki örnekte. 


Enrollments Özelliği bir gezinti özelliği. Gezinti özellikleri bu varlıkla ilgili diğer varlıkları bağlayın. Bu 
durumda, Enrollments özelliği bir student entity tüm tutan Enroiiment olarak ilişkili varlıkları 
student . Örneğin, bir öğrenci satır DB'de iki kayıt satırları ilgili olan Enrollments gezinti özelliği 
içerir, bu iki Enroiiment varlıklar. İlgili Enroiiment satırdır bu öğrencinin birincil anahtar değerini 
içeren bir satır studentiD sütun. Örneğin, Öğrenci kimlikli varsayalım = 1 olan iki satır Enroiiment 
tablo. Enroiiment Tablosunda var olan iki satır studentiD =1. studentiD içinde bir yabancı anahtar 
Enroiiment içinde Öğrenci belirten tablo student tablo. 


Bir gezinme özelliği birden çok varlık tutarsanız gezinme özelliğini bir liste türü gibi olmalıdır 


ICollection<T> . 

. ICollection<T> 

belirtilebilir, ya da bir tür gibi 

List<T > 

veya 

HashSet<T> 

. Zaman 

ICollection<T> 

olduğu EF Core kullanıldığında, oluşturur bir 

HashSet<T> 

varsayılan olarak 


koleksiyon. Birden çok varlık tutun Gezinti özellikleri çoktan çoğa ve bire çok ilişkileri gelir. 


Kayıt varlık 


Enrollment 


Properties 
yî EnrolImentlD 
A CourselD 
A StudentiD 
A Grade 

Navigation Properties 
y3 Course 
yTl Student 


































içinde modelleri klasör oluşturma Enrollment.es aşağıdaki kod ile: 


namespace ContosoUniversity.Models 
{ 

public enum Grade 
{ 

A, Bj C, D, F 

} 

public elass Enrollment 
{ 

public int EnrollmentlD { get; set; } 
public int CourselD { get; set; } 
public int StudentlD { get; set; } 
public Grade? Grade { get; set; } 

public Course Course { get; set; } 
public Student Student { get; set; } 

} 

} 

EnrollmentlD Birincil anahtar özelliğidir. Bu varlığı kullanan ciassnameiD yerine desen id gibi 
student varlık. Genellikle geliştiriciler bir düzen seçin ve veri modelini kullanın. Bir sonraki 
öğreticide, elassname Kimliğini kullanarak, veri modelinde aktarma uygulamak daha kolay hale 
getirmek için gösterilir. 


Grade Özelliği bir enum . Sonra soru işareti Grade türü bildirimi gösterir Grade özelliği boş değer 
atanabilir. Boş bir sınıf bir sıfır sınıf farklı—null anlamına gelir bir sınıf bilinen değil veya henüz 
atanmamış. 


StudentlD 

Özelliği olduğundan yabancı anahtar ve karşılık gelen gezinme özelliğini student . Bir 

Enrollment 

varlıktır biriyle ilişkili student tek bir özellik içerecek şekilde varlık 

student varlık. 

student Varlık farklıdır student. Enrollments içeren birden çok gezinti özelliği 

Enrollment varlıklar. 


CourselD Özelliği olduğundan yabancı anahtar ve karşılık gelen gezinme özelliğini course . Bir 
Enrollment varlıktır biriyle ilişkili course varlık. 

EF Core adlandırılmışsa, bu özellik bir yabancı anahtar olarak yorumlar 


cnavigation property namexprimary key property 

name> 

. Örneğin, StudentlD için student gezinti 

özelliği bu yana student varlığın birincil anahtarı 

ID . 

Yabancı anahtar özellikleri de adı 

eprimary key property name> . Örneğin, CourselD 

beri 

course varlığın birincil anahtarı CourselD 


Kurs varlık 


Course 


Properties 
y? CourselD 
> Title 
f* Credits 

Navigation Properties 
Enrollments 


içinde modelleri klasör oluşturma Course.cs aşağıdaki kod ile: 





























using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 
{ 

public class Course 
{ 

[DatabaseGenerated(DatabaseGeneratedOption.None)] 
public int CourselD { get; set; } 
public stning Title { get; set; } 
public int Credits { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 

Enrollments Özelliktir bir gezinme özelliği. A course varlık dilediğiniz sayıda ilgili olabileceğini 
Enroiiment varlıklar. 

DatabaseGenerated DB sahip, oluşturmak, yerine özniteliği birincil anahtarı belirtmek için uygulamayı 
sağlar. 

İskele Öğrenci modeli 

Bu bölümde, Öğrenci modeli iskele kurulmuş. Diğer bir deyişle, yapı iskelesi aracı sayfaları için 
oluşturma, okuma, güncelleştirme ve silme (CRUD) işlemlerine yönelik Öğrenci modeli oluşturur. 

• Projeyi oluşturun. 

• Oluşturma sayfa Lan/Öğrenciler klasör. 

• Visual Studio 

• Visual Studio Code 

• içinde Çözüm Gezgini, sağ tıklayın sayfaları/Öğrenciler klasör > Ekle > yeni iskele kurulmuş 
öğe. 

• İçinde İskele Ekle iletişim kutusunda Entity Framevvork (CRU D) kullanarak Razor sayfaları > 
ekleme. 

Tamamlamak ekleme Razor sayfaları (CRUD) Entity Framevvork kullanarak iletişim: 

• İçinde Model sınıfı açılan listesinde, select Öğrenci (ContosoUniversity.Models). 

• İçinde veri bağlamı sınıfının satır, select + (artı) oturum açın ve oluşturulan bir adla değiştirin 
ContosoUniversity.Models.SchoolContext. 

• içinde veri bağlamı sınıfının açılan listesinde, select 
ContosoUniversity.Models.SchoolContext 

• Add (Ekle) seçeneğini belirleyin. 




Add Razor Pages using Entity Framevvork (CRUD) 


X 


Generates Razor Pages using Entity Framevvork for; Create, Delete, Details, Edit and List operationsforthe 
selected model. 


Model elass: 

Student (ContosoUniversity.Models) 

V j 




Data context elass: 

ContosoUniversity.Models.SchoolContext 

□ E 


Options: 

Create as a partial view 
R1 Reference script libraries 
R1 Use a layout page: 


(Leave empty if it is set in a Razor _viewstart file) 


Add 


Cancel 


Bkz: film modeli iskelesini önceki adımı ile ilgili bir sorun varsa, 
iskele işlem oluşturulur ve aşağıdaki dosya değişti: 

Oluşturulan dosyalar 

• Sayfa/Öğrenciler oluşturma, silme, Ayrıntılar, düzenleme, dizin. 

• Data/SchoolContext.cs 

Dosya güncelleştirmeleri 

• Startup.es : Bu dosyada yapılan değişiklikler sonraki bölümde ayrıntılı. 

• appSettings.JSON : yerel bir veritabanına bağlanmak için kullanılan bağlantı dizesi eklenir. 

Bağımlılık ekleme ile kayıtlı bağlamını İnceleme 

ASP.NET Core ile oluşturulmuş bağımlılık ekleme. Hizmetler (örneğin, EF Core DB bağlamı), 
uygulama başlatma sırasında bağımlılık ekleme ile kaydedilir. Bu hizmetler (örneğin, Razor sayfaları) 
gerektiren bileşenler bu hizmetler Oluşturucu parametresi üzerinden sağlanır. Bir db bağlamı örneği 
alır Oluşturucu kodu öğreticinin ilerleyen bölümlerinde gösterilmektedir. 

Yapı iskelesi aracı otomatik olarak oluşturulmuş bir veritabanı bağlamını ve bağımlılık ekleme 
kapsayıcısını ile kayıtlı. 

inceleme configureServices yönteminde Startup.es. Vurgulanan satırı iskele kurucu tarafından 
eklendi: 
















public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

// This lambda determines whether user consent for 
//non -essential cookies is needed for a given request. 
options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_l); 

Services.AddDbContext<SchoolContext>(options => 

options.UseSqlServer(Configuration.GetConnectionString("SchoolContext"))); 

} 


Bağlantı dizesi adı için bağlam üzerinde bir yöntemi çağırarak geçirilen bir DbContextOptions nesne. 
Yerel geliştirme için AS P.N ET Core yapılandırma sistemi bağlantı dizesinden okur appsettings.jsorı 
dosya. 

Ana güncelleştir 

içinde Program.es, değişiklik Main yöntemi aşağıdakileri yapmak için: 

• Bir DB bağlamı örneği bağımlılık ekleme kapsayıcısını alın. 

• Çağrı EnsureCreated. 

• Bağlam dispose olduğunda EnsureCreated yöntemi tamamlar. 

Aşağıdaki kod güncelleştirilmiş gösterir Program.es dosya. 





using ContosoUniversity.Models; 
using Microsoft.AspNetCore; 
using Microsoft.AspNetCore.Hoşting; 
using Microsoft.Extensions.DependencyInjection; 
using Microsoft.Extensions.Logging; 
using System; 

namespace ContosoUniversity 

{ 

public class Program 

{ 

public static void Main(string[] args) 

{ 

var hoşt = CreateWebHostBuilder(args).Build(); 

using (var scope = hoşt.Services.CreateScope()) 

{ 

var Services = scope.ServiceProvider; 


// SchoolContext 


// CreateScope 


try 

{ 

var context = Services.GetRequiredService<SchoolContext>(); 
context.Database.EnsureCreated(); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<ILogger<Program>>(); 
logger.LogError(eXj "An error occurred creating the DB."); 

} 


host.Run(); 

} 


} 


public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 
1/JebHost .CreateDefaultBuilder(args) 

.UseStartup<Startup>(); 


} 


EnsureCreated Veritabanı bağlamının var olmasını sağlar.Varsa, hiçbir işlem yapılmaz. Yoksa, 
veritabanı ve tüm şema oluşturulur. EnsureCreated veritabanı oluşturmaya geçişleri kullanmaz, ile 
oluşturulmuş bir veritabanı EnsureCreated daha sonra geçişleri kullanılarak güncelleştirilemez. 


EnsureCreated Aşağıdaki iş akışı sağlayan uygulama Başlat menüsünde çağrılır: 


• DB silin. 

• DB şema değiştirme (örneğin, bir EmailAddress alan). 

• Uygulamayı çalıştırın. 



geçişler kullanılır. 


Uygulamayı test etme 

Uygulamayı çalıştırın ve tanımlama bilgisi ilkesini kabul edin. Bu uygulama, kişisel bilgileri tutmak 
değil. Tanımlama bilgisi ilkesi hakkında bilgi edinebilirsiniz AB genel veri koruma yönetmeliği (GDPR) 
Destek. 


• Seçin Öğrenciler bağlantısını ve ardından Yeni Oluştur. 

• Ayrıntılar, düzenleme, test edin ve bağlantılarını silin. 









SchoolContext DB bağlamını İnceleme 

Verilen veri modeli için EF Core işlevselliği koordine eden ana DB bağlamı sınıfının sınıftır. Veri 
bağlamı türetilir Microsoft.EntityFrameworkCore.DbContext. Veri bağlamı, hangi varlıkları veri 
modelinde yer alan belirtir. Bu projede adlı sınıfı schooicontext . 

Güncelleştirme SchoolContext.cs aşağıdaki kod ile: 

using Microsoft.EntityFrameworkCore; 

namespace ContosoUniversity.Models 
{ 

public class SchoolContext : DbContext 
{ 

public SchoolContext(DbContextOptions<SchoolContext> options) 

: base(options) 

{ 

} 

public DbSet<Student> Student { get; set; } 
public DbSet<Enrollment> Enrollment { get; set; } 
public DbSet<Course> Course { get; set; } 

} 

} 

Vurgulanan kod oluşturur bir olan DB<TEntity > her varlık kümesi özelliği. EF Core terminolojisinde: 


• Bir varlık kümesini genellikle DB tabloya karşılık gelir. 

• Bir varlık tablosunda bir satıra karşılık gelir. 


DbSet<Enrollment> 

ve 

DbSet<Course> 

atlanmış. EF Core içeren bunları örtük olarak çünkü 

Student 


varlık başvuruları Enrollment varlığı ve Enrollment varlık başvuruları course varlık. Bu öğretici için 
tutmak DbSet<Enrollment> ve DbSet<Course> içinde SchoolContext . 

SQL Server Express LocalDB 

Bağlantı dizesini belirtir SQL Server LocalDB. LocalDB, SQL Server Express veritabanı Motoru'nu 
hafif bir sürümüdür ve uygulama geliştirme, üretim kullanımı için tasarlanmıştır. LocalDB, isteğe bağlı 
olarak başlar ve karmaşık yapılandırma olduğundan kullanıcı modunda çalışır. Varsayılan olarak 
LocalDB oluşturur .mdf DB dosyaları c:/ıisers/<user> dizin. 

Bir veritabanı test verileri ile başlatmak için kod ekleyin 

EF Core boş bir veritabanı oluşturur. Bu bölümde, bir initialize yöntemi test verileriyle doldurma 
işlemine yazılır. 

içinde veri klasöründe adlı yeni bir sınıf dosyası oluşturma Dblnitializer.es ve aşağıdaki kodu ekleyin: 

using ContosoUniversity.Models; 
using System; 
using System.Linq; 

namespace ContosoUniversity.Models 
{ 

public static class Dblnitializer 
{ 

public static void Initialize(SchoolContext context) 

{ 

context.Database.EnsureCreated(); 


// Look for any students. 












if (context.Student.Any()) 

{ 

return; // DB has been seeded 

} 

var students = new Student[] 

{ 

new 

Student{FirstMidName="Carson",LastName="Alexander",EnrollmentDate=DateTime.Parse("2005-09-01")}, 
new 

Student{FirstMidName="Meredith", LastName="Alonso", EnrollmentDate=DateTime.Parse("2002-09-01")}, 
new 

Student{FirstMidName="Arturo",LastName="Anand",EnrollmentDate=DateTime.Parse("2003-09-01")}, 
new 

Student{FirstMidName="Gytis", LastName="Barzdukas", EnrollmentDate=DateTime.Parse("2002-09-01")}, 
new Student{FirstMidName="Yan", LastName="Li", EnrollmentDate=DateTime. Parse("2002-09- 

01")}, 

new 

Student{FirstMidName="Peggy", LastName="lustice",EnrollmentDate=DateTime.Parse("2001-09-01")}, 
new 

Student{FirstMidName="Laura",LastName="Norman",EnrollmentDate=DateTime.Parse("2003-09-01")}, 
new 

Student{FirstMidName="Nino",LastName="01ivetto",EnrollmentDate=DateTime.Parse("2005-09-01")} 

}; 

foreach (Student s in students) 

{ 

context.Student.Add(s); 

} 

context.SaveChanges(); 

var courses = new Course[] 

{ 

new Course{CourseID=1050,Title="Chemistry",Credits=3}, 
new Course{CourseID=4022,Title="Microeconomics",Credits=3}, 
new Course{CourseID=4041,Title="Macroeconomics",Credits=3}, 
new Course{CourseID=1045,Title="Calculus",Credits=4}, 
new Course{CourseID=3141,Title="Trigonometry",Credits=4}, 
new Course{CourseID=2021,Title="Composition",Credits=3}, 
new Course{CourseID=2042,Title="Literatüre",Credits=4} 

}; 

foreach (Course c in courses) 

{ 

context.Course.Add(c); 

} 

context.SaveChanges(); 

var enrollments = new Enrollment[] 

{ 

new Enrollment{StudentID=l,CourseID=1050,Grade=Grade.A}, 
new Enrollment{StudentID=l,CourseID=4022,Grade=Grade.C}, 
new Enrollment{StudentID=l,CourseID=4041,Grade=Grade.B}, 
new Enrollment{StudentID=2,CourseID=1045,Grade=Grade.B}, 
new Enrollment{StudentID=2,CourseID=3141,Grade=Grade.F}, 
new Enrollment{StudentID=2,CourseID=2021,Grade=Grade.F}, 
new Enrollment{StudentID=3,CourseID=1050}, 
new Enrollment{StudentID=4,CourseID=1050}, 
new Enrollment{StudentID=4,CourseID=4022,Grade=Grade.F}, 
new Enrollment{StudentID=5,CourseID=4041,Grade=Grade.C}, 
new Enrollment{StudentID=6,CourseID=1045}, 
new Enrollment{StudentID=7,CourseID=3141,Grade=Grade.A}, 

}; 

foreach (Enrollment e in enrollments) 

{ 

context.Enrollment.Add(e); 

} 

context.SaveChanges(); 

} 


} 


} 


Note: Yukarıdaki kod Data yerine ad alanı ( namespace ContosoUniversity.Models ) için Models kullanır. 
Models , scaffolder tarafından oluşturulan kodla tutarlıdır. Daha fazla bilgi için bkz. GitHub yapı 
iskelesi sorunu. 

Kod DB'de tüm Öğrenciler olup olmadığını denetler. DB'de Öğrenci varsa, bir veritabanı test verileri 
ile başlatılır. Diziye test verileri yükler yerine List<T> performansını iyileştirmek için koleksiyonları. 

EnsureCreated Yöntemi DB bağlamı için bir veritabanı otomatik olarak oluşturur.Veritabanı varsa, 
EnsureCreated DB değiştirmeden döndürür. 

içinde Program.es, değişiklik Main çağrılacak yöntem initialize : 

public elass Program 
{ 

public static void Main(string[] args) 

{ 

var hoşt = CreateWebHostBuilder(args).Build(); 

using (var scope = hoşt.Services.CreateScope()) 

{ 

var Services = scope.ServiceProvider; 

try 

{ 

var context = Services.GetRequiredService<SchoolContext>(); 

// using ContosoUniversity.Data; 

Dblnitializer.Initialize(context); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<ILogger<Program>>(); 
logger.LogError(eXj "An error occurred creating the DB."); 

} 

} 

host.Run(); 

} 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 

UebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>(); 

} 


• Visual Studio 

• Visual Studio Code 


Çalışıyorsa uygulamayı durdurun ve Paket Yöneticisi konsolunda (PMC) aşağıdaki komutu 
çalıştırın: 


Drop-Database 


DB görüntüleyin 

Veritabanı adı, daha önce belirttiğiniz bağlam adından ve bir tire ve bir GUID ile oluşturulur. Bu 
nedenle, veritabanı adı "SchoolContext-{GUID}" olacaktır. GUID her kullanıcı için farklı olacaktır.Açık 
SQL Server Nesne Gezgini (SSOX) öğesinden görünümü Visual Studio'daki menü. SSOX 'te, 

(LocalDB) \MSSQLLocalDB > veritabanları > SchoolContext-{GUID} 1 a tıklayın. 








Genişletin tabloları düğümü. 

Sağ Öğrenci tablosu ve'ı tıklatın görünüm verilerini oluşturulan sütunları ve tabloya eklenen 
satırları görebilirsiniz. 

Zaman uyumsuz kod 

Zaman uyumsuz programlama, ASP.NET Core ve EF Core için varsayılan moddur. 

Sınırlı sayıda iş parçacığı kullanılabilir bir web sunucusuna sahip ve yüksek yük durumlarda tüm 
kullanılabilir iş parçacıklarının kullanımda olabilir. Bu durum oluştuğunda, sunucunun iş 
parçacıklarının serbest bırakılana kadar yeni istekleri işleyemiyor. G/ç tamamlanması bekleniyor 
çünkü bunlar herhangi bir iş gerçekten yapmamanız sırasında eş zamanlı kod ile birçok iş parçacığı 
bağlanması, işlemi tamamlamak, g/ç için beklerken zaman uyumsuz kod ile diğer istekleri işlemek 
için kullanılacak sunucuyu için kendi iş parçacığı serbest bırakılır. Sonuç olarak, sunucu kaynaklarının 
daha etkin kullanılması zaman uyumsuz kod sağlar ve sunucu gecikmeler olmadan daha fazla trafik 
işlemek için etkinleştirilir. 

Zaman uyumsuz kod, çalışma zamanında az miktarda bir ek yükü sunar. Düşük trafiğe durumlar, 
performans düşüşüne yüksek trafik durumlar için göz ardı edilebilir, çalışırken, olası performans 
geliştirmesi önemli. 

Aşağıdaki kodda, zaman uyumsuz anahtar sözcüğü, Task<T> dönüş değeri, await anahtar sözcüğü 
ve ToListAsync yöntemi zaman uyumsuz yürütülen kod olun. 

public async Task OnGetAsync() 

{ 

Student = await _context.Student.ToListAsyncQ; 

} 

• async Anahtar sözcüğü, derleyiciye bildirir: 

o Yöntem gövdesini bölümleri için geri çağırmaları oluşturur. 

o Otomatik olarak oluşturmasını görev döndürülen nesne. Daha fazla bilgi için görev dönüş 
türü. 

• Örtük dönüş türü Task devam eden çalışmayı temsil eder. 

• await Anahtar sözcüğü, derleyicinin yöntemin iki parçalara bölmek neden olur.İlk bölüm ile 
zaman uyumsuz olarak başlatıldığında işlemi sonlandırır. ikinci bölümü, işlemi tamamlandıktan 
sonra çağrılan bir geri çağırma yöntemi yerleştirilir. 

• ToListAsync zaman uyumsuz sürümüdür ToList genişletme yöntemi. 

EF Core kullanan zaman uyumsuz kodu yazarken dikkat edilmesi gereken bazı noktalar şunlardır: 

• Sorguları veya Veritabanına gönderilecek komutları neden deyimleri zaman uyumsuz olarak 
yürütülür, içeren, ToListAsync , SingleOnDefaultAsync , FirstOrDefaultAsync , ve SaveChangesAsync . 
Yalnızca değiştirmek deyimleri içermeyen bir ıçueryable , gibi 

var students = context.Students.Where(s => s.LastName == "Davolio") . 

• EF Core bağlam iş parçacığı güvenli olmayan: paralel birden çok işlem yapmak yeniden 
denemeyin. 

• Zaman uyumsuz kodun performans avantajlarından yararlanmak için bunlar için bir veritabanı 
sorguları göndermek EF Core yöntemleri çağırırsanız kitaplığı paketlerinin (disk belleği 
sunamıyoruz gibi) zaman uyumsuz kullandığını doğrulayın. 

. N ET'te zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. zaman uyumsuz genel 

















bakış ve zaman uyumsuz programlama ile async ve avvait. 


Sonraki öğreticide, temel CRUD (oluşturma, okuma, güncelleştirme ve silme) işlemleri incelenir. 

Ek kaynaklar 

• Bu öğreticinin YouTube sürümü 
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, Tom Dykstra, Jon P Smithve Rick Anderson 

Contoso Üniversitesi vveb uygulaması, EF Core ve Visual Studio kullanarak Razor Pages Web uygulamaları 
oluşturmayı gösterir. Öğretici serisi hakkında daha fazla bilgi için ilk öğreticiyebakın. 

Çözemediğiniz sorunlarla karşılaşırsanız, Tamamlanmış uygulamayı indirin ve öğreticiyi izleyerek bu kodu 
oluşturduğunuz şekilde karşılaştırın. 

Bu öğreticide, scafkatan CRUD (oluşturma, okuma, güncelleştirme, silme) kodu incelenir ve özelleştirilir. 

Depo yok 

Bazı geliştiriciler, Kullanıcı arabirimi (Razor Pages) ve veri erişim katmanı arasında bir soyutlama katmanı 
oluşturmak için bir hizmet katmanı veya depo deseninin kullanılmasını sağlar. Bu öğretici bunu yapmaz. 
Karmaşıklığı en aza indirmek ve öğreticiyi EF Core odaklanmasını sağlamak için EF Core kodu doğrudan sayfa 
modeli sınıflarına eklenir. 

Ayrıntılar sayfasını Güncelleştir 

Öğrenciler sayfaları için yapı iskelesi kodu kayıt verilerini içermez. Bu bölümde, ayrıntılar sayfasına kayıtları 
eklersiniz. 

Kayıtları oku 

Sayfada öğrenciye ait kayıt verilerini göstermek için, onu okumanız gerekir. Pages/öğrenciler/detaiis. cshtml. cs 
içindeki scafkatlama kodu, kayıt verileri olmadan yalnızca öğrenci verilerini okur: 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Student = await _context.Students.FirstOrDefaultAsync(m => m.ID == id); 

if (Student == null) 

{ 

return NotFound(); 

} 

return Page(); 

} 

onGetAsync Yöntemi, seçili öğrenci için kayıt verilerini okumak üzere aşağıdaki kodla değiştirin. Değişiklikler 
vurgulanır. 




public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Student = await _context.Students 
.Include(s => s. Ennollments) 

.Thenlnclude(e => e.Course) 

.AsNoTracking() 

.FirstOrDefaultAsync(m => m.ID == id); 

if (Student == null) 

{ 

return NotFound(); 

} 

return Page(); 

} 

Include ve thenınclude yöntemleri, içeriğin student. Enroiiments gezinti özelliğini yüklemesine ve her 
Enroiiment.course kaydın gezinti özelliği içine olmasına neden olur. Bu yöntemler, okuma ilgili verileri 
öğreticisinde ayrıntılı olarak incelendi. 

Asnotracking yöntemi, döndürülen varlıkların geçerli bağlamda güncelleştirilmediği senaryolarda performansı 
geliştirir. AsNoTracking Bu öğreticinin ilerleyen kısımlarında ele alınmıştır. 

Kayıtları görüntüle 

Sayfalar/öğrenciier/details. cshtml içindeki kodu aşağıdaki kodla değiştirin ve kayıtlar listesini görüntüleyin. 
Değişiklikler vurgulanır. 






@page 

@model ContosoUniversity.Pages.Students.DetailsModel 

@{ 

Vİ 0 wData["Title"] = "Details"; 

} 

<hl>Details</hl> 

<div> 

<h4>Student</h4> 

<hr /> 

<dl class="row"> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Student.LastName) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Student.LastName) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Student.FirstMidName) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Student.FirstMidName) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Student.EnrollmentDate) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Student.EnrollmentDate) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Student.Enrollments) 

</dt> 

<dd class="col-sm-10"> 

<table class="table"> 

<tr> 

<th>Course Title</th> 

<th>Grade</th> 

</tr> 

@foreach (var item in Model.Student.Enrollments) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Course.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Grade) 

</td> 

</tr> 

} 

</table> 

</dd> 

</dl> 

</div> 

<div> 

<a asp-page="./Edit" asp-route-id="@Model.Student.ID">Edit</a> | 

<a asp-page="./Index">Back to List</a> 

</div> 

Yukarıdaki kod, Enrollments Gezinti özelliğindeki varlıklar aracılığıyla döngü başlatır. Her kayıt için kurs 
başlığını ve sınıfı görüntüler. Kurs başlığı, kayıt varlığının course gezinti özelliğinde depolanan kurs varlığından 
alınır. 


Uygulamayı çalıştırın, öğrenciler sekmesini seçin ve bir öğrenci için Ayrıntılar bağlantısına tıklayın. Seçili 





öğrenci için Kurslar ve notlar listesi görüntülenir. 

Bir varlığı okuma yolları 

Oluşturulan kod, bir varlığı okumak için Firstordefaultasync kullanır. Bu yöntem, hiçbir şey bulunamazsa null 
değerini döndürür; Aksi takdirde, sorgu filtresi ölçütlerine uyan bulunan ilk satırı döndürür. FirstorDefaultAsync 
genellikle aşağıdaki alternatiflere göre daha iyi bir seçimdir: 

• Singleordefaultasync -sorgu filtresini karşılayan birden fazla varlık varsa bir özel durum oluşturur.Sorgu 
tarafından birden fazla satır döndürülüp döndürülmeyeceğini anlamak için birden çok satır getirmeyi 

singleOrDefaultAsync dener. Sorgu yalnızca bir varlık döndürebiliyorsanız ve benzersiz bir anahtarda arama 
yaptığında bu ek çalışma gereksizdir. 

• Findadsync -birincil ANAHTARLA (PK) bir varlık bulur. PK 'ye sahip bir varlık bağlam tarafından izleniyorsa, 
veritabanına bir istek olmadan döndürülür. Bu yöntem tek bir varlık aramak için en iyi duruma getirilmiştir, 
ancak ile inciude FindAsync çağrılamaz. Bu nedenle, ilgili veriler gerekliyse, FirstorDefaultAsync daha iyi bir 
seçimdir. 

Veri yönlendirme ve sorgu dizesi karşılaştırması 

Ayrıntılar sayfasının https://iocaihost:<port>/students/Detaiis?id=ı URL 'si. Varlığın birincil anahtar değeri, 
sorgu dizesinde bulunur. Bazı geliştiriciler anahtar değerini rota verilerinde geçirmeye tercih eder: 
https://localhost:<port>/students/Detaiis/ı . Daha fazla bilgi için bkz. oluşturulan kodu güncelleştirme. 

Oluştur sayfasını Güncelleştir 

Oluşturma sayfası için yapı onPostAsync iskelesi kodu, aşırı nakmeaçıktır. Pages/öğrenciler/Create. cshtml. cs 
içindeki yöntemiaşağıdakikodladeğiştirin. OnPostAsync 

public async Task<IActionResult> OnPostAsync() 

{ 

var emptyStudent = new Student(); 

if (await TryUpdateModelAsync<Student>( 
emptyStudent, 

"student", // Prefix for form value. 

s => s.FirstMidName, s => s.LastName, s => s.EnrollmentDate)) 

{ 

_context.Students.Add(emptyStudent); 
await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

return Page(); 

} 

TryUpdateModelAsync 

Yukarıdaki kod bir öğrenci nesnesi oluşturur ve ardından, öğrenci nesnesinin özelliklerini güncelleştirmek için, 
postalanan form alanlarını kullanır. Tryupdatemodelasync yöntemi: 

• Pagemodellçindeki pagecontext özelliğinden gönderilen form değerlerini kullanır. 

• Yalnızca listelenen ( s => s.FirstMidName, s => s.LastName, s => s.EnrollmentDate ) özellikleri güncelleştirir. 

• "Öğrenci" ön ekine sahip form alanlarını arar.Örneğin: student.FirstMidName . Büyük/küçük harfe duyarlı 
değildir. 

• , Dizelerdeki form değerlerini student modeldeki türlere dönüştürmek için model bağlama sistemini kullanır. 
Örneğin, EnrollmentDate DateTime 'a dönüştürülmesi gerekir. 

Uygulamayı çalıştırın ve oluştur sayfasını test etmek için bir öğrenci varlığı oluşturun. 















Fazla nakil 


Deftere TryupdateModei nakledilen değerler içeren alanları güncelleştirmek için kullanmak, aşırı nakletmeyi 
önlediği için en iyi güvenlik yöntemidir. Örneğin, öğrenci varlığının bu Web sayfasının güncelleştirmesi veya 
secret eklemesi gereken bir özelliği içerdiğini varsayalım: 

public class Student 

{ 

public int ID { get; set; } 
public string LastIMame { get; set; } 
public string FirstMidName { get; set; } 
public DateTime EnrollmentDate { get; set; } 
public string Secret { get; set; } 

} 

Uygulama, oluşturma veya güncelleştirme Razor sayfasında secret bir alana sahip olmasa da, bir korsan 
secret değeri aşırı nakme ile ayarlayabilir. Bir korsan, Fiddler gibi bir araç kullanabilir veya bir secret form 
değeri göndermek için bazı JavaScript yazabilir. Özgün kod, bir öğrenci örneği oluştururken model cildin 
kullandığı alanları sınırlamaz. 

secret Form alanı için belirtilen korsanın hangi değeri veritabanında güncelleştirildiği. Aşağıdaki görüntüde, 
alanı ("overpost" değeri ile secret ), postalanan form değerlerine ekleyen Fiddler aracı gösterilmektedir. 
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POST 

V 

http://localhost: 1236/Student/Create 

V 

HTTP/1.1 

V 


ReguestHeaders 


[ Upload file... ] 

Help... 


Hoşt localhost: 1236 

User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64; rv:22.0) Gecko/20100101 Firefox/22.0 

Accept: teyt/html.applîcation^htm^mkapplicationAmljg^.Oj'/'jg^.S 

Accept-Language: en-US,en;q=0.5 

Accept-Encoding: gzip, deflate 

Referer: http://localhost: 1236/Student/Create 

Cookie: RequestVerificafionToken=-OqMEtdNIwFGDdjHUS_-XDoOSCqS 1515g7ASzrFKwQPjpxRT2hN_tm6pDZbS0HVVTGMr 

Connecfion: keep-alive 

Content-Type: application/x-www-fbrnn-urlencoded 
Content-Length: 227 


< > 


RequestBody _ 

slSLastName=SmlthaFirstMidName=Joe8EnrollmentDate=7%2F31%2F2013+4%3A58%3A234PFfeSecret=OverPost 


"Overpost" değeri eklenen satırın secret özelliğine başarıyla eklendi. Bu durum, Uygulama Tasarımcısı hiçbir 
şekilde secret özelliği oluştur sayfasıyla ayarlamaya yönelik değildir. 

Modeli görüntüle 

Model görüntüleme, fazla nakletmeyi önlemenin alternatif bir yolunu sağlar. 

Uygulama modeli genellikle etki alanı modeli olarak adlandırılır. Etki alanı modeli genellikle veritabanında ilgili 
varlık için gereken tüm özellikleri içerir. Görünüm modeli yalnızca için kullanılan Kullanıcı arabirimi için gereken 
özellikleri içerir (örneğin, oluşturma sayfası). 

Görünüm modeline ek olarak, bazı uygulamalar Razor Pages sayfa modeli sınıfı ve tarayıcı arasında veri 
geçirmek için bir bağlama modeli veya giriş modeli kullanır. 

Aşağıdaki student görünüm modelini göz önünde bulundurun: 


































using System; 


namespace ContosoUniversity.Models 

{ 

public class StudentvM 

{ 

public int ID { get; set; } 
public string LastName { get; set; } 
public string FirstMidName { get; set; } 
public DateTime EnrollmentDate { get; set; } 

} 


Aşağıdaki kod, yeni bir studentvM öğrenci oluşturmak için görünüm modelini kullanır: 

[BindProperty] 

public StudentvM StudentvM { get; set; } 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var entry = _context.Add(new Student()); 
entry.CurrentValues.SetValues(StudentvM); 
await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 


SetValues yöntemi, başka bir PropertyValues nesnesinden değerleri okuyarak bu nesnenin değerlerini ayarlar. 
Setvalues Özellik adı eşleştirme kullanır.Görünüm modeli türünün model türüyle ilgili olması gerekmez, 
yalnızca eşleşen özellikleri olması gerekir. 

Kullanılması studentvM için studentvM Create . cshtml kullanılması gerekir, student 

Güncelleştirme düzenleme sayfası 

Sayfalar/öğrenciler/Edit. cshtml. cs' de, onGetAsync ve onPostAsync yöntemlerini aşağıdaki kodla değiştirin. 














public async Task<IActionResult> OnGetAsync(int? id) 
{ 

if (id == null) 

{ 

return NotFound(); 

} 

Student = await _context.Students.FindAsync(id); 

if (Student == null) 

{ 

retunn NotFound(); 

} 

return Page(); 


public async Task<IActionResult> OnPostAsync(int id) 

{ 

var studentToUpdate = await _context.Students.FindAsync(id); 

if (studentToUpdate == null) 

{ 

return NotFound(); 

} 

if (await TryUpdateModelAsync<Student>( 
studentToUpdate, 

"student", 

s => s.FirstMidName, s => s.LastName, s => s.EnrollmentDate)) 

{ 

await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

return Page(); 

} 


Kod değişiklikleri, birkaç özel durum dışında oluşturma sayfasına benzerdir: 

• FirstorDefaultAsync , Findadsy nci le değiştirilmiştir. İlgili verileri dahil etmeniz gerekmiyorsa, FindAsync daha 
etkilidir. 

• onPostAsync bir id parametreye sahiptir. 

• Geçerli öğrenci boş bir öğrenci oluşturmak yerine veritabanından getirilir. 

Uygulamayı çalıştırın ve bir öğrenci oluşturup düzenleyerek test edin. 

Varlık durumları 

Veritabanı bağlamı, bellekteki varlıkların veritabanında karşılık gelen satırlarıyla eşitlenmiş olup olmadığını izler. 
Bu izleme bilgileri, Savechangesasync çağrıldığında ne olacağını belirler. Örneğin, yeni bir varlık Addadsync 
yöntemine geçirildiğinde, bu varlığın durumu eklendiolarak ayarlanır. saveChangesAsync Çağrıldığında, 
veritabanı bağlamı bir SQL INSERT komutu yayınlar. 

Bir varlık aşağıdaki durumlardanbirinde olabilir: 

• Added : Varlık veritabanında henüz yok. Savechanges Yöntemi bir INSERT ifadesini yayınlar. 

• unchanged : Bu varlıkla birlikte hiçbir değişiklik kaydedilmesi gerekmiyor. Bir varlık veritabanından 
okurken bu durumu içerir. 

• Modified : Varlığın özellik değerlerinin bazıları veya tümü değiştirildi. Savechanges Yöntemi bir Update 
ifadesini yayınlar. 











• Deleted : Varlık silinmek üzere işaretlendi. Savechanges Yöntemi bir DELETE ifadesini yayınlar. 

• Detached : Varlık, veritabanı bağlamı tarafından izlenmiyor. 

Bir masaüstü uygulamasında durum değişiklikleri genellikle otomatik olarak ayarlanır. Bir varlık okundu, 
değişiklikler yapılır ve varlık durumu otomatik olarak olarak değiştirilir Modified .Çağıran Savechanges yalnızca 
değiştirilen özellikleri güncelleştiren bir SQL Update bildirisi oluşturur. 

Bir Web uygulamasında, DbContext bir varlığı okur ve bir sayfa işlendikten sonra verileri görüntüler. Bir sayfanın 
onPostAsync yöntemi çağrıldığında, yeni bir Web isteği oluşturulur ve yeni bir örneğine DbContext sahiptir. 
Okuyarak bu yeni bağlamdaki varlığı, masaüstü işlemesini benzetir. 

Silme sayfası 

Bu bölümde, çağrısı Savechanges başarısız olduğunda özel bir hata iletisi uygulayacağınızı görürsünüz. 

Pages/öğrendler/delete. cshtml. cs dosyasındaki kodu aşağıdaki kodla değiştirin. Değişiklikler vurgulanır ( 
using deyimler temizliği dışında). 

using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.EntityFrameworkCore; 
using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Students 

{ 

public class DeleteModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public DeleteModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Student Student { get; set; } 
public string ErrorMessage { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id, bool? saveChangesError = false) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Student = await _context.Students 
.AsNoTracking() 

.FirstOrDefaultAsync(m => m.ID == id); 

if (Student == null) 

{ 

return NotFound(); 

} 

if (saveChangesError.GetValueOrDefault()) 

{ 

ErrorMessage = "Delete failed. Try again"; 

} 

return Page(); 

} 
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{ 

if (id == null) 

{ 

return NotFound(); 

} 

var student = await _context.Students.FindAsync(id); 

if (student == null) 

{ 

retunn NotFound(); 

} 


} 


} 


} 


try 

{ 


_context.Students.Remove(student); 
await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

catch (DbUpdateException /* ex */) 

{ 

//Log the error (uncomment ex variable name and write a log.) 
return RedirectToAction("./Delete", 

new { id, saveChangesError = true })j 


} 


Yukarıdaki kod, isteğe bağlı parametresini saveChangesError onGetAsync Yöntem imzasına ekler. 
saveChangesError öğrenci nesnesini silme hatasından sonra yöntemin çağrılıp çağrılmadığını gösterir. Geçici ağ 
sorunları nedeniyle silme işlemi başarısız olabilir. Geçici ağ hataları, veritabanı bulutta olduğunda daha olasıdır. 
Sil sayfası OnGetAsync kullanıcı arabiriminden çağrıldığında parametrefalse'tur. saveChangesError Tarafından 
çağrıldığında ( silme saveChangesError işlemi başarısız olduğundan), parametresi true olur. OnGetAsync 
OnPostAsync 


Yöntemi seçili varlığı alır, ardından varlığın durumunu olarak Deleted ayarlamak için Remove yöntemini çağırır. 
OnPostAsync Savechanges Çağrıldığında, bir SQL DELETE komutu oluşturulur. Remove Başarısız olursa: 


• Veritabanı özel durumu yakalandı. 

• Sayfaları OnGetAsync Sil yöntemi ile saveChangesError=true çağırılır. 


Razor silme sayfasına bir hata iletisi ekleyin ( Sayfalar/öğrenciler/delete. cshtml): 












@page 

@model ContosoUniversity.Pages.Students.DeleteModel 

@{ 

Vİ 0 wData["Title"] = "Delete"; 

} 

<hl>Delete</hl> 

<p class="text-dangen">@Model.ErrorMessage</p> 

<h3>Are you sure you want to delete this?</h3> 

<div> 

<h4>Student</h4> 

<hr /> 

<dl class="row"> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Student.LastName) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Student.LastName) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Student.FirstMidName) 
</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Student.FirstMidName) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Student.EnrollmentDate) 
</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Student.EnrollmentDate) 
</dd> 

</dl> 

<form method="post"> 

<input type="hidden" asp-for="Student.ID" /> 

<input type="submit" value="Delete" class="btn btn-danger" /> | 
<a asp-page="./Index">Back to List</a> 

</form> 

</div> 


Uygulamayı çalıştırın ve Sil sayfasını test etmek için bir öğrenci silin. 

Sonraki adımlar 


ÖNCEKİ ■ SONRAKİ 

ÖĞRETİCİ ■ ÖĞRETİCİ 


Bu öğreticide, scafkatan CRUD (oluşturma, okuma, güncelleştirme, silme) kodu incelenir ve özelleştirilir. 

Karmaşıklığı en aza indirmek ve bu öğreticilerin EF Core odaklanmasını sağlamak için, EF Core kod sayfa 
modellerinde kullanılır. Bazı geliştiriciler, Kullanıcı arabirimi (Razor Pages) ve veri erişim katmanı arasında bir 
soyutlama katmanı oluşturmak için bir hizmet katmanını veya depo modelini kullanır. 

Bu öğreticide, öğrenciler klasöründeki oluşturma, düzenleme, silme ve Ayrıntılar Razor Pages incelenir. 

Scafkatlanmış kod, sayfa oluşturma, düzenleme ve silme için aşağıdaki kalıbı kullanır: 

• HTTP GET yöntemiyle onGetAsync istenen verileri alın ve görüntüleyin. 






• HTTP POST yöntemiyle onPostAsync verilerde yapılan değişiklikleri kaydedin. 


Dizin ve ayrıntı sayfaları, HTTP GET yöntemiyle istenen verileri alır ve görüntüler onGetAsync 

SingleOrDefaultAsync ile FirstOrDefaultAsync 

Oluşturulan kod, genellikle Singleordefaultasyncüzerinden tercih edilen firstordefaultasynckullanır. 
FirstOrDefaultAsync , bir varlık getirenden SingleOrDefaultAsync daha verimlidir: 

• Kodun sorgudan döndürülen birden fazla varlık olmadığını doğrulaması gerekmiyorsa. 

• SingleOrDefaultAsync daha fazla veri getirir ve gereksiz işler. 

• SingleOrDefaultAsync Filtre bölümüne uyan birden fazla varlık varsa bir özel durum oluşturur. 

• FirstOrDefaultAsync Filtre bölümüne uyan birden fazla varlık varsa oluşturmaz. 

Findadsync 

Yapı iskelesi kodunun büyük bir kısmında, yerine Findadsync kullanılabilir FirstOrDefaultAsync . 

FindAsync : 

• Birincil anahtarla (PK) bir varlık bulur. PK 'ye sahip bir varlık bağlam tarafından izleniyorsa, VERITABANıNA 
bir istek olmadan döndürülür. 

• Basittir ve kısadır. 

• Tek bir varlığı aramak için iyileştirilmiştir. 

• Bazı durumlarda performans avantajlarına sahip olabilir, ancak tipik Web uygulamaları için nadiren meydana 
gelir. 

• , Maleasyncyerine dolaylı olarak firstasync kullanır. 

Ancak inciude başka varlıklar FindAsync istiyorsanız artık uygun değildir. Bu, uygulamanız ilerledikçe bir 
sorguyu iptal FindAsync etmeniz ve bir sorguya taşımanız gerekebileceği anlamına gelir. 

Ayrıntılar sayfasını özelleştirme 


Pages/students Sayfaya gidin. Düzenle, Ayrıntılarve Sil bağlantıları, Sayfalar/öğrenciler/lndex. cshtml 
dosyasındaki tutturucu etiketi Yardımcısı tarafından oluşturulur. 


<td> 



<a 

asp-page=" 

./Edit" asp-route-id="@item.ID">Edit</a> | 

<a 

asp-page=" 

./Details" asp-route-id="@item.ID">Details</a> | 

<a 

asp-page=" 

./Delete" asp-route-id="@item.ID">Delete</a> 

</td> 




Uygulamayı çalıştırın ve bir Ayrıntılar bağlantısı seçin. URL, formundadır 

http://iocaihost:5000/students/Detaiis?id=2 . Öğrenci KİMLİĞİ bir sorgu dizesi ( ?id =2 ) kullanılarak geçirilir. 

"(id:int}" Yol şablonunu kullanmak için düzenleme, Ayrıntılar ve silme Razor Pages güncelleştirin. Bu 
sayfaların her biri için Page yönergesini 1 den @page 'e @page "{id:int}" değiştirin. 

Bir tamsayı yol değeri içermeyen "{id: İnt}" yol şablonuna sahip sayfaya yönelik bir İstek, HTTP 404 
(bulunamadı) hatası döndürüyor. Örneğin, http://iocaihost:5000/students/Detaiis 404 hatası döndürür. Kimliği 
isteğe bağlı yapmak için yol kısıtlamasına ? ekleyin: 

@page "{id:int?}" 

Uygulamayı çalıştırın, Ayrıntılar bağlantısına tıklayın ve URL ’nin KİMLİĞİ yönlendirme verileri ( 


















http://iocaihost:50@0/students/Detaiis/2 ) olarak geçirdiğini doğrulayın. 

1 I genel @page olarak değiştirmeyin, bunu yaparak giriş bağlantılarını keser ve sayfa oluşturabilirsiniz. 

@page "{id:int}" 

İlgili verileri ekleme 

Öğrenciler dizin sayfasının yapı iskelesi kodu Enroiiments özelliği içermez. Bu bölümde, Enroiiments 
koleksiyonun içeriği ayrıntılar sayfasında görüntülenir. 

Pages/ öğrenciler/details. cshtml. FirstorDefaultAsync CS yöntemi, tek student bir varlığı almak için yöntemini 
kullanır. onGetAsync Aşağıdaki vurgulanmış kodu ekleyin: 

public async Task<IActionR 0 sult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Student = await _context.Student 

.Include(s => s.Enrollments) 

.Thenlnclude(e => e.Course) 

.AsNoTnacking() 

.FirstorDefaultAsync(m => m.ID == id); 

if (Student == null) 

{ 

return NotFound(); 

} 

return Page(); 

} 

Include ve thenınclude yöntemleri, içeriğin student.Enrollments gezinti özelliğini yüklemesine ve her 
Enroiiment.course kaydın gezinti özelliği içine olmasına neden olur. Bu yöntemler, okuma ile ilgili veri 
öğreticisinde ayrıntılı olarak incelenmelidir. 

Asnotracking yöntemi, döndürülen varlıkların geçerli bağlamda güncelleştirilmediği durumlarda, senaryolarda 
performansı geliştirir. AsNoTracking Bu öğreticinin ilerleyen kısımlarında ele alınmıştır. 

Ayrıntılar sayfasında ilgili kayıtları görüntüleme 

SayfalarL/öğrencileri/ayrıntılarL. cshtml'yl açın. Kayıtlar listesini göstermek için aşağıdaki vurgulanmış kodu 
ekleyin: 












@page "{id:int}" 

@model ContosoUniversity. Pages.Students. DetailsModel 

@{ 

ViewData["Title"] = "Details"; 

} 

<h2>Details</h2> 

<div> 

<h4>Student</h4> 

<hr /> 

<dl class="dl-horizontal"> 

<dt> 

@Html.DisplayNameFor(model => model.Student.LastName) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Student.LastName) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Student.FirstMidName) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Student.FirstMidName) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Student.EnnollmentDate) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Student.EnrollmentDate) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Student.Enrollments) 

</dt> 

<dd> 

<table class="table"> 

<tn> 

<th>Course Title</th> 

<th>Grade</th> 

</tr> 

@foreach (var item in Model.Student.Enrollments) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Course.Title) 
</td> 

<td> 

@Html.DisplayFor(modelItem => item.Grade) 

</td> 

</tr> 

} 

</table> 

</dd> 

</dl> 

</div> 

<div> 

<a asp-page="./Edlt" asp-route-id="@Model.Student.ID">Edit</a> | 

<a asp-page="./Index">Back to List</a> 

</div> 


Kod yapıştırıldıktan sonra kod girintisi yanlışsa, düzeltmek için CTRL-K-D 1 a basın. 

Yukarıdaki kod, Enrollments Gezinti özelliğindeki varlıklar aracılığıyla döngü başlatır. Her kayıt için kurs 
başlığını ve sınıfı görüntüler. Kurs başlığı, kayıt varlığının course gezinti özelliğinde depolanan kurs varlığından 
alınır. 





Uygulamayı çalıştırın, öğrenciler sekmesini seçin ve bir öğrenci için Ayrıntılar bağlantısına tıklayın. Seçili 
öğrenci için Kurslar ve notlar listesi görüntülenir. 

Oluştur sayfasını Güncelleştir 

Pages/öğrendler/Create. cshtml. cs dosyasındaki yöntemiaşağıdakikodlagüncelleştirin: onPostAsync 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var emptyStudent = new Student(); 

if (await TryUpdateModelAsync<Student>( 
emptyStudent, 

"student", // Prefix for form value. 

s => s.FirstMidName, s => s.LastName, s => s.EnrollmentDate)) 

{ 

_context.Student.Add(emptyStudent); 
await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

return null; 

} 

TryUpdateModelAsync 

Tryupdatemodelasync kodunu inceleyin: 

var emptyStudent = new Student(); 

if (await TryUpdateModelAsync<Student>( 
emptyStudent, 

"student", // Prefix for form value. 

s => s.FirstMidName, s => s.LastName, s => s.EnrollmentDate)) 

{ 

TryiipdateModeiAsync<student> Önceki kodda, pagemodeliçindeki pagecontext özelliğinden emptyStudent 
gönderilen form değerlerini kullanarak nesneyi güncelleştirmeye çalışır. TryUpdateModelAsync yalnızca listelenen ( 
s => s.FirstMidName, s => s.LastName, s => s. EnrollmentDate ) Özellikleri güncelleştirir. 

Yukarıdaki örnekte: 

• ikinci bağımsız değişken ( "student", // Prefix ), ön ek değerleri aramak için kullanılır. Büyük/küçük harfe 
duyarlı değildir. 

• Postalanan form değerleri model student bağlamakullanılarak modeldeki türlere dönüştürülür. 

Fazla nakil 

Deftere TryupdateModei nakledilen değerler içeren alanları güncelleştirmek için kullanmak, aşırı nakletmeyi 
önlediği için en iyi güvenlik yöntemidir. Örneğin, öğrenci varlığının bu Web sayfasının güncelleştirmesi veya 
secret eklemesi gereken bir özelliği içerdiğini varsayalım: 











public class Student 

{ 

public int ID { get; set; } 
public string LastIMame { get; set; } 
public string FirstMidName { get; set; } 
public DateTime EnrollmentDate { get; set; } 
public string Secret { get; set; } 

} 

Uygulama, oluşturma/güncelleştirme Razor sayfasında secret bir alana sahip olmasa da, bir korsan secret 
değeri aşırı nakme ile ayarlayabilir. Bir korsan, Fiddler gibi bir araç kullanabilir veya bir secret form değeri 
göndermek için bazı JavaScript yazabilir. Özgün kod, bir öğrenci örneği oluştururken model cildin kullandığı 
alanları sınırlamaz. 

secret Form alanı için belirtilen korsanın hangi değeri veritabanında güncelleştirildiği. Aşağıdaki görüntüde, 
alanı ("overpost" değeri ile secret ), postalanan form değerlerine ekleyen Fiddler aracı gösterilmektedir. 


(£) Statisfics m Inspectors / AutoResponder Composer Q Rlters | İH Log — Tımeline 


Usethis pageto composea Request. Youcan done a priorrequestby dragglng and dropplng a sessionfrom the 1 
WebSessionslist. 
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POST 

V 

http://localhost: 1236/Student/Create 

V 

HTTP/1.1 

V 


RequestHeaders 


[ Upload file... ] 

Help... 


Hoşt: localhost: 1236 

User-Agent: Mozilla/5.0 CWindows MT 6.2; W0W64; rv:22.0) Gecko/20100101 Firefox/22.0 

Accept: text/html,appllcation/xhtml+xml,applicaton/xml;q=0.9,*/*;q=0.8 

Accept-language: en-US,en;q=0.5 

Accept-Encoding: gzîp, deflate 

Referer: http://localhost: 1236/Student/Create 

Cookie:_RequestVerıficat)onToken=-OqMEtdNIwFGDdjHUS_-XDoOSCqS1515g7ASzrFKwQPjpxRT2hN_tm6pDZbSOHWTGMr 

Connection: keep-alive 

Content-Type: application/x-www-fbrm-urlencoded 
Content-length: 227 


< > 


RequestBody 

sl&LastName=SmlthaFirstMidName=Joe8EnrollmentDate=7%2F31%2F2013+4%3A58%3A234PF4secret=OverPost 


"Overpost" değeri eklenen satırın secret özelliğine başarıyla eklendi. Uygulama Tasarımcısı hiçbir şekilde hiçbir 
secret özelliği oluştur sayfasıyla ayarlamaya yönelik değildir. 

Modeli görüntüle 

Bir görünüm modeli, genellikle uygulama tarafından kullanılan modelde bulunan özelliklerin bir alt kümesini 
içerir. Uygulama modeli genellikle etki alanı modeli olarak adlandırılır. Etki alanı modeli genellikle 
VERITABANıN DAKI karşılık gelen varlık için gereken tüm özellikleri içerir. Görünüm modeli yalnızca Ul katmanı 
için gereken özellikleri içerir (örneğin, Oluştur sayfası). Görünüm modeline ek olarak, bazı uygulamalar Razor 
Pages sayfa modeli sınıfı ve tarayıcı arasında veri geçirmek için bir bağlama modeli veya giriş modeli kullanır. 
Aşağıdaki student görünüm modelini göz önünde bulundurun: 


































using System; 


namespace ContosoUnivensity.Models 
{ 

public class StudentvM 
{ 

public int ID { get; set; } 
public string LastName { get; set; } 
public string FirstMidName { get; set; } 
public DateTime EnrollmentDate { get; set; } 

} 


} 


Model görüntüleme, fazla nakletmeyi önlemenin alternatif bir yolunu sağlar.Görünüm modeli yalnızca 
görüntüleme (görüntüleme) veya güncelleştirme özelliklerini içerir. 

Aşağıdaki kod, yeni bir studentvM öğrenci oluşturmak için görünüm modelini kullanır: 

[BindProperty] 

public StudentvM StudentvM { get; set; } 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var entry = _context.Add(new Student()); 
entry.CurrentValues.SetValues(StudentvM); 
await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 


SetValues yöntemi, başka bir PropertyValues nesnesinden değerleri okuyarak bu nesnenin değerlerini ayarlar. 
Setvalues Özellik adı eşleştirme kullanır.Görünüm modeli türünün model türüyle ilgili olması gerekmez, 
yalnızca eşleşen özellikleri olması gerekir. 

Kullanmak studentvM için createvm gerekir, cshtml , yerine kullanılmak studentvM üzere güncelleştirilir. 
Student 

Razor Pages, PageModei türetilmiş sınıf görünüm modelidir. 

Güncelleştirme düzenleme sayfası 

Düzenleme sayfasının sayfa modelini güncelleştirin. Büyük değişiklikler vurgulanır: 















public class EditModel : PageModel 

{ 

private readonly SchoolContext _context; 

public EditModel(SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Student Student { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Student = await _context.Student.FindAsync(id); 

if (Student == null) 

{ 

netunn NotFound(); 

} 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int? id) 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var studentToUpdate = await _context.Student.FindAsync(id); 

if (await TryUpdateModelAsync<Student>( 
studentToUpdate, 

"student", 

s => s.FirstMidName, s => s.LastName, s => s.EnrollmentDate)) 

{ 

await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

return Page(); 

} 

} 


Kod değişiklikleri, birkaç özel durum dışında oluşturma sayfasına benzerdir: 

• onPostAsync isteğe bağlı id bir parametreye sahiptir. 

• Geçerli öğrenci boş bir öğrenci oluşturmak yerine DB 'den getirilir. 

• FirstorDefaultAsync , Findadsyncile değiştirilmiştir. FindAsync birincil anahtardan bir varlık seçerken iyi bir 
seçimdir. Daha fazla bilgi için bkz. Findadsync . 

Düzenleme ve oluşturma sayfalarını test etme 

Birkaç öğrenci varlığı oluşturun ve düzenleyin. 

Varlık durumları 

DB bağlamı, bellekteki varlıkların VERITABANıN DA karşılık gelen satırlarıyla eşitlenmiş olup olmadığını izler. 






VERITABANı bağlamı eşitleme bilgileri, Savechangesasync çağrıldığında ne olacağını belirler. Örneğin, yeni bir 
varlık Addadsync yöntemine geçirildiğinde, bu varlığın durumu eklendiolarak ayarlanır. saveChangesAsync 
Çağrıldığında, DB bağlamı bir SQL INSERT komutu yayınlar. 

Bir varlık aşağıdaki durumlardanbirinde olabilir: 

• Added : Varlık, VERITABANıNDA henüzyok. Savechanges Yöntemi bir INSERT ifadesini yayınlar. 

• Unchanged : Bu varlıkla birlikte hiçbir değişiklik kaydedilmesi gerekmiyor. Bir varlık, DB 'den okurken bu 
duruma sahip olur. 

• Modified : Varlığın özellik değerlerinin bazıları veya tümü değiştirildi. Savechanges Yöntemi bir Update 
ifadesini yayınlar. 

• Deleted : Varlık silinmek üzere işaretlendi. Savechanges Yöntemi bir DELETE ifadesini yayınlar. 

• Detached : Varlık DB bağlamı tarafından izlenmiyor. 

Bir masaüstü uygulamasında durum değişiklikleri genellikle otomatik olarak ayarlanır. Bir varlık okundu, 
değişiklikler yapılır ve varlık durumu otomatik olarak olarak değiştirilecek Modified . Çağıran Savechanges 
yalnızca değiştirilen özellikleri güncelleştiren bir SQL Update bildirisi oluşturur. 

Bir Web uygulamasında, DbContext bir varlığı okur ve bir sayfa işlendikten sonra verileri görüntüler. Bir sayfanın 
onPostAsync yöntemi çağrıldığında, yeni bir Web isteği oluşturulur ve yeni bir örneğine DbContext sahiptir. Yeni 
bağlamdaki varlığı yeniden okumak masaüstü işlemesini benzetir. 

Silme sayfası 

Bu bölümde, çağrı Savechanges başarısız olduğunda özel bir hata iletisi uygulamak için kod eklenir. Olası hata 
iletilerini içeren bir dize ekleyin: 

public class DeleteModel : PageModel 
{ 

private readonly SchoolContext _context; 

public DeleteModel(SchoolContext context) 

{ 

_context = context; 

} 

[BindPnopenty] 

public Student Student { get; set; } 
public string ErrorMessage { get; set; } 


onGetAsync Yöntemini aşağıdaki kodla değiştirin: 














public async Task<IActionResult> OnGetAsync(int? id, bool? saveChangesError = false) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Student = await _context.Student 
.AsNoTracking() 

.FirstOrDefaultAsync(m => m.ID == id); 

if (Student == null) 

{ 

return NotFound(); 

} 

if (saveChangesError.GetValueOrDefault()) 

{ 

ErrorMessage = "Delete failed. Try again"; 

} 

return Page(); 

} 

Önceki kod isteğe bağlı parametresini saveChangesError içerir. saveChangesError öğrenci nesnesini silme 
hatasından sonra yöntemin çağrılıp çağrılmadığını gösterir. Geçici ağ sorunları nedeniyle silme işlemi başarısız 
olabilir. Geçici ağ hataları, bulutta daha olasıdır. saveChangesError , silme sayfası onGetAsync kullanıcı 
arabiriminden çağrıldığında false 'tur. Tarafından çağrıldığında ( silme saveChangesError işlemi başarısız 
olduğundan), parametresi true olur. OnGetAsync onPostAsync 


Sayfaları sil OnPostAsync yöntemi 

OnPostAsync Öğesini aşağıdaki kodla değiştirin: 


public async Task<IActionResult> OnPostAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var student = await _context.Student 
.AsNoTracking() 

.FirstOrDefaultAsync(m => m.ID == id); 

if (student == null) 

{ 

return NotFound(); 

} 


} 


try 

{ 

_context.Student.Remove(student); 
await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

catch (DbUpdateException /* ex */) 

{ 

//Log the error (uncomment ex variable name and write a log.) 
return RedirectToAction("./Delete", 

new { id, saveChangesError = true }); 


} 







Önceki kod seçili varlığı alır, ardından varlığın durumunu olarak Deleted ayarlamak için Remove yöntemini 
çağırır. Savechanges Çağrıldığında, bir SQL DELETE komutu oluşturulur. Remove Başarısız olursa: 

• DB özel durumu yakalandı. 

• Sayfaları OnGetAsync Sil yöntemi ile saveChangesError=true çağırılır. 

Razor Sil sayfasını Güncelleştir 

Aşağıdaki Vurgulanan hata iletisini Razor Sil sayfasına ekleyin. 

@page "{id:int}" 

@model ContosoUniversity.Pages.Students.DeleteModel 
@{ 

ViewData["Title"] = "Delete"; 

} 

<h2>Delete</h2> 

<p class="text-danger">@Model.ErrorMessage</p> 

<h3>Are you sure you want to delete this?</h3> 

<div> 

Test silme. 

Sık karşılaşılan hatalar 

Öğrenciler/dizin veya diğer bağlantılar çalışmaz: 

Razor sayfasının doğru @page yönergeyi içerdiğini doğrulayın. Örneğin, öğrenciler/Dizin Razor sayfası bir yol 
şablonu içermemelidir: 

@page "{id:int}" 

Her Razor sayfası @page yönergesini içermelidir. 

Ek kaynaklar 

• Bu öğreticinin YouTube sürümü 
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ASPNET Core sıralama, filtrelerine, sayfalama-3/8 1 
de EF Core Razor Pages 

20.08.2019 • 44 minutes to read ı Edit Online 


By Tom Dykstra, Rick Andersonve Jon P Smith 

Contoso Üniversitesi vveb uygulaması, EF Core ve Visual Studio kullanarak Razor Pages Web uygulamaları 
oluşturmayı gösterir. Öğretici serisi hakkında daha fazla bilgi için ilk öğreticiyebakın. 

Çözemediğiniz sorunlarla karşılaşırsanız, Tamamlanmış uygulamayı indirin ve öğreticiyi izleyerek bu kodu 
oluşturduğunuz şekilde karşılaştırın. 

Bu öğretici, öğrenciler sayfalarına sıralama, filtreleme ve sayfalama işlevselliği ekler. 

Aşağıdaki çizimde tamamlanmış bir sayfa gösterilmektedir.Sütun başlıkları sütunu sıralamak için tıklatılabilir 
bağlantılardır. Artan ve azalan sıralama düzeni arasında geçiş yapmak için bir sütun başlığına tekrar tekrar 
tıklayın. 
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Sıralama Ekle 

Pages/öğrerıciler/lndex. cshtml. cs içindeki kodu, sıralama eklemek için aşağıdaki kodla değiştirin. 










using ContosolIniversity.Data; 
using Contosollniversity.Models; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.EntityFrameworkCore; 
using System; 

using System.Collections.Generic; 

using System.Linq; 

using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Students 

{ 

public class IndexModel : PageModel 

{ 

private readonly SchoolContext _context; 

public IndexModel(SchoolContext context) 

{ 

_context = context; 

} 

public string NameSort { get; set; } 
public string DateSort { get; set; } 
public string CurrentFilter { get; set; } 
public string CurrentSort { get; set; } 

public IList<Student> Students { get; set; } 

public async Task OnGetAsync(string sortOrder) 

{ 

NameSort = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 

DateSort = sortOrder == "Date" ? "date_desc" : "Date"; 

IQueryable<Student> studentsIQ = from s in _context.Students 

select s; 

switch (sortOrder) 

{ 

case "name_desc": 

studentsIQ = studentsIQ.OrderByDescending(s => s.LastName); 
break; 

case "Date": 

studentsIQ = studentsIQ.OrderBy(s => s.EnrollmentDate); 
break; 

case "date_desc": 

studentsIQ = studentsIQ.OrderByDescending(s => s.EnrollmentDate); 
break; 
default: 

studentsIQ = studentsIQ.OrderBy(s => s.LastName); 
break; 

} 

Students = await studentsIQ.AsNoîracking().ToListAsync(); 

} 

} 

} 


Yukarıdaki kod: 

• Sıralama parametrelerini içeren özellikleri ekler. 

• student Özelliğin adını olarak students değiştirir. 

• onGetAsync Yöntemindeki kodu değiştirir. 

Yöntemi, URL 'deki sortOrder sorgu dizesinden bir parametre alır. OnGetAsync URL (sorgu dizesi dahil), 
tutturucu etiketi Yardımcısıtarafından oluşturulur. 





sortorder Parametre "ad" ya da "Tarih" dır. Parametre sortorder , isteğe bağlı olarak azalan sıra belirtmek için 
"_DESC" tarafından izlenir. Varsayılan sıralama düzeni artan. 

Öğrenciler bağlantısından Dizin sayfası istendiğinde sorgu dizesi yoktur.Öğrenciler, son ada göre artan sırada 
görüntülenir. Son ada göre artan sıralama, switch deyimindeki varsayılan (gelen durumdur). Kullanıcı bir 
sütun başlığı bağlantısına tıkladığında, sorgu dizesi değerinde uygun sortorder değer sağlanır. 

NameSort ve DateSort Razor sayfası tarafından sütun başlığı köprülerini uygun sorgu dizesi değerleriyle 
yapılandırmak için kullanılır: 

NameSort = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 

DateSort = sortorder == "Date" ? "date_desc" : "Date"; 

Kod, C# koşullu işleci kullanıyor ?:. ?: işleci üçlü bir işleçtir (üç işlenen alır), ilk satır, null veya boş sortorder 
olduğunu belirtir, NameSort "name_desc" olarak ayarlanır. Null veya boş değilseboşbirdizeolarak NameSort 
ayarlanır, sortorder 

Bu iki deyim, sayfanın sütun başlığı köprülerini şu şekilde ayarlamanızı sağlar: 


GEÇERLİ SIRALAMA DÜZENİ 

SON AD KÖPRÜSÜ 

TARİH KÖPRÜSÜ 

Artan son ad 

descending 

ascending 

Azalan son ad 

ascending 

ascending 

Artan Tarih 

ascending 

descending 

Azalan Tarih 

ascending 

ascending 


Yöntemi, sıralama yapılacak sütunu belirtmek için LINQ to Entities kullanır. Kod, Switch ifadesinden 
iQueryabie<student> önce bir başlatır ve Svvitch ifadesinde onu değiştirir: 

IQueryable<Student> studentsIQ = from s in _context.Students 

select s; 

switch (sortorder) 

{ 

case "name_desc": 

studentsIQ = studentsIQ.OrderByDescending(s => s.LastName); 
break; 

case "Date": 

studentsIQ = studentsIQ.OrderBy(s => s.EnrollmentDate); 
break; 

case "date_desc": 

studentsIQ = studentsIQ.OrderByDescending(s => s.EnrollmentDate); 
break; 
default: 

studentsIQ = studentsIQ.OrderBy(s => s.LastName); 
break; 

} 

Students = await studentsIQ.AsNoTracking().ToListAsync(); 

Bir ıçueryabie oluşturulduğunda veya değiştirildiğinde, veritabanına hiçbir sorgu gönderilmez. ıçueryable 
Nesne bir koleksiyona dönüştürülene kadar sorgu yürütülmez. iQueryabie , gibi bir yöntemi ToListAsync 
çağırarak bir koleksiyona dönüştürülür. Bu nedenle, iQueryabie kod, aşağıdaki deyime kadar yürütülemeyen 
tek bir sorgu ile sonuçlanır: 






















Students = await studentsIQ.AsNoTracking().ToListAsync(); 

onGetAsync çok sayıda sıralanabilir sütunla ayrıntı alabilir. Bu işlevi kodun alternatif bir yolu hakkında daha fazla 
bilgi için, bu öğretici serisinin MVC sürümünde kodu basitleştirmek için dinamik LINQ kullanma konusuna 
bakın. 

Öğrenci dizini sayfasına sütun başlığı köprüleri ekleme 

Öğrerıciler/lndex. cshfm/içindeki kodu aşağıdaki kodla değiştirin. Değişiklikler vurgulanır. 

@page 

@model ContosoUniversity.Pages.Students.IndexModel 

@{ 

ViewData["Title"] = "Students"; 

} 

<h2>Students</h2> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<table class="table"> 

<thead> 

<tn> 

<th> 

<a asp-page="./Index" asp-route-sortOrder="@Model.NameSort"> 

@Html.DisplayNameFor(model => model.Students[0].LastName) 

</a> 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Students[0].FirstMidName) 

</th> 

<th> 

<a asp-page="./Index" asp-route-sortOrder="@Model.DateSort"> 

@Html.DisplayNameFon(model => model.Students[0].EnrollmentDate) 

</a> 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

(Şforeach (van item in Model.Students) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.LastName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.FirstMidName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.EnrollmentDate) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID">Details</a> | 

<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 



Yukarıdaki kod: 


• LastName Ve EnroiimentDate sütun başlıklarına köprüler ekler. 

• , Ve NameSort DateSort içindeki bilgileri kullanarak geçerli sıralama düzeni değerleriyle köprüler ayarlar. 

• Sayfa başlığını dizinden öğrencilerle değiştirir. 

• Üzerinde yapılan değişiklikler Model.student . Model.students 

Sıralamanın çalıştığını doğrulamak için: 

• Uygulamayı çalıştırın ve öğrenciler sekmesini seçin. 

• Sütun başlıklarına tıklayın. 

Filtre ekleme 

Öğrenciler dizin sayfasına filtre eklemek için: 

• Razor sayfasına bir metin kutusu ve bir Gönder düğmesi eklenir. Metin kutusu, ad veya soyadı üzerinde bir 
arama dizesi sağlar. 

• Sayfa modeli metin kutusu değerini kullanacak şekilde güncelleştirilir. 

OnGetAsync yöntemini güncelleştirme 

Öğrenciler/lndex. cshtml. cs dosyasındaki kodu, filtreleme eklemek için aşağıdaki kodla değiştirin: 






using ContosoUniversity.Data; 
using Contosollniversity.Models; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.EntityFrameworkCore; 
using System; 

using System.Collections.Generic; 

using System.Linq; 

using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Students 

{ 

public class IndexModel : PageModel 

{ 

private readonly SchoolContext _context; 

public IndexModel(SchoolContext context) 

{ 

_context = context; 

} 

public string NameSort { get; set; } 
public string DateSort { get; set; } 
public string CurrentFilter { get; set; } 
public string CurrentSort { get; set; } 

public IList<Student> Students { get; set; } 

public async Task OnGetAsync(string sortOrder, string searchString) 

{ 

NameSort = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 
DateSort = sortOrder == "Date" ? "date_desc" : "Date"; 


CurrentFilter = searchString; 


IQueryable<Student> studentsIQ = from s in _context.Students 

select s; 

if (!String.IsNullOrEmpty(searchString)) 

{ 


} 


studentsIQ = studentsIQ.Where(s => s.LastName.Contains(searchString) 
| s.FirstMidName.Contains(searchString)); 


switch (sortOrder) 

{ 

case "name_desc": 

studentsIQ = studentsIQ.OrderByDescending(s => s.LastName); 
break; 

case "Date": 

studentsIQ = studentsIQ.OrderBy(s => s.EnrollmentDate); 
break; 

case "date_desc": 

studentsIQ = studentsIQ.OrderByDescending(s => s.EnrollmentDate); 
break; 
default: 

studentsIQ = studentsIQ.OrderBy(s => s.LastName); 
break; 


} 


} 


Students = await studentsIQ.AsNoTracking().ToListAsync(); 

} 


Yukarıdaki kod: 


• Yöntemine parametresini ekler ve parametre değerini CurrentFilter özelliğine kaydeder. searchString 





onGetAsync Arama dizesi değeri bir sonraki bölüme eklenen bir metin kutusundan alınır. 

• LINQ deyimi a where yan tümcesine ekler. where Yan tümce yalnızca adı veya soyadı arama dizesini içeren 
öğrencileri seçer. LINQ deyimleri yalnızca aranacak bir değer varsa yürütülür. 

IQueryable vs. lEnumerable 

Kod, where yöntemi bir iQueryabie nesne üzerinde çağırır ve filtre sunucuda işlenir. Bazı senaryolarda, 
uygulama bir bellek içi koleksiyonda bir genişletme where yöntemi olarak yöntemi çağırıyor olabilir. Örneğin, 
EF Core Dbset 'den _context.students bir lEnumerable koleksiyonu döndüren bir depo yöntemine yapılan 
değişiklikleri varsayın. Sonuç normalde aynı olur, ancak bazı durumlarda farklı olabilir. 

Örneğin, uygulamasının contains .N ET Framevvork uygulanması varsayılan olarak büyük/küçük harfe duyarlı 
bir karşılaştırma gerçekleştirir. SÖL Server, contains büyük/küçük harf duyarlılığı SQL Server örneğinin 
harmanlama ayarına göre belirlenir. SOL Server varsayılan olarak büyük/küçük harfe duyarlı değildir.SQLİte, 
büyük/küçük harfe duyarlı olur. Toupper testi açık büyük/küçük harfe duyarsız hale getirmek için çağrılabilir: 

Where(s => s. LastName.ToUpper().Contains(searchString.ToLIpper())' 

Yukarıdaki kod, where yöntemin bir veya bir lEnumerable SQLİte üzerinde çağrılması durumunda bile filtrenin 
büyük/küçük harf duyarsız olmasını güvence altına alır. 

contains Bir lEnumerable koleksiyon üzerinde çağrıldığında .N ET Core uygulamasını kullanır, contains Bir 
ıçueryabie nesne üzerinde çağrıldığında, veritabanı uygulamasını kullanır. 

contains Bir ıçueryabie üzerinde çağırmak, genellikle performans nedenleriyle tercih edilir, ile ıçueryabie , 
filtreleme veritabanı sunucusu tarafından yapılır. Önce bir lEnumerable oluşturulduysa, tüm satırların veritabanı 
sunucusundan döndürülmesi gerekir. 

Çağırmak Toupper için bir performans cezası vardır. Toupper Kod, TSQL SELECT ifadesinin VVHERE yan 
tümcesine bir işlev ekler. Eklenen işlev, iyileştiricinin bir dizin kullanmasını önler.SOL, büyük/küçük harfe 
duyarsız olarak yüklendiği için, gerekli olmadığında Toupper çağrının önüne geçmek en iyisidir. 

Daha fazla bilgi için bkz. SOLİte sağlayıcı ile büyük/küçük harfe duyarsız sorgu kullanma. 

Razor sayfasını güncelleştirme 

Sayfalar/öğrenciler/lndex. cshtml içindeki kodu, bir arama düğmesi ve assıralanan Chrome oluşturmak için 
değiştirin. 


























@page 

@model Contosollniversity. Pages. Students. IndexModel 

@{ 

Vİ 0 wData["Title"] = "Students"; 

} 

<h2>Students</h2> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<form asp-page="./Index" method="get"> 

<div class="form-actions no-colon"> 

<P> 

Find by name: 

<input type="text" name="SearchString" value="@Model.CurrentFilter" /> 
<input type="submit" value="Search" class="btn btn-primary" /> | 

<a asp-page="./Index">Back to full List</a> 

</p> 

</div> 

</fonm> 

<table class="table"> 

<thead> 

<tn> 

<th> 

<a asp-page="./Index" asp-route-sortOrder="@Model.NameSort"> 
@Html.DisplayNameFor(model => model .Students[0]. LastName) 

</a> 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Students[0]. FirstMidName) 

</th> 

<th> 

<a asp-page="./Index" asp-route-sortOrder="@Model.DateSort"> 

@Html.DisplayNameFor(model => model.Students[0].EnrollmentDate) 

</a> 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model.Students) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.LastName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.FirstMidName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.EnrollmentDate) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID">Details</a> | 

<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 



Yukarıdaki kod, arama metin <form> kutusu ve düğme eklemek için etiket yardımcısını kullanır. Varsayılan 
olarak, <form> etiket Yardımcısı form verilerini bir gönderiyle gönderir. POST ile parametreler, URL 'de değil 
HTTP ileti gövdesine geçirilir. HTTP GET kullanıldığında, form verileri URL 'ye sorgu dizeleri olarak geçirilir. 
Verilerin sorgu dizelerine geçirilmesi, kullanıcıların URL 'Yİ yer işaretine eklemesini sağlar.W3C yönergeleri , 
eylem bir güncelleştirme ile SONUÇLANMAZSA, Get 'in kullanılması önerilir. 

Uygulamayı test edin: 

• Öğrenciler sekmesini seçin ve bir arama dizesi girin. SQLİte kullanıyorsanız, filtre yalnızca daha önce 
gösterilen isteğe bağlı Toupper kodu uyguladıysanız, büyük/küçük harfe duyarlıdır. 

• Ara' yı seçin. 

URL ’nin arama dizesini içerdiğine dikkat edin. Örneğin: 
https://localhost:<port>/Students?SearchString=an 

Sayfa yer işaretiyle, yer işareti sayfanın URL 'sini ve searchstring sorgu dizesini içerir. method="get" 

Etiketi,sorgu form dizesinin oluşturulmasına neden oldu. 

Şu anda, bir sütun başlığı sıralama bağlantısı seçildiğinde, arama kutusundaki filtre değeri kaybedilir. Kayıp 
filtre değeri bir sonraki bölümde düzeltilir. 

Sayfalama Ekle 

Bu bölümde, sayfalama desteği PaginatedList için bir sınıf oluşturulur. Sınıfı, tablodaki tüm Take satırları 
almak yerine, sunucudaki verileri filtrelemek için ve deyimlerini kullanır skip . PaginatedList Aşağıdaki 
çizimde sayfalama düğmeleri gösterilmektedir. 
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Sayfalı liste sınıfını oluşturma 

Proje klasöründe aşağıdaki kodla oluşturun PaginatedList.es : 


















using System; 

using System.Collections.Generic; 
using System.Linq; 
using System.Threading.Tasks; 
using Microsoft.EntityFrameworkCore; 

namespace ContosoUniversity 

{ 

public class PaginatedList<T> : List<T> 

{ 

public int Pagelndex { get; private set; } 
public int TotalPages { get; private set; } 

public PaginatedList(List<T> items, int count, int pagelndex, int pageSize) 

{ 

Pagelndex = pagelndex; 

TotalPages = (int)Math.Ceiling(count / (double)pageSize); 
this.AddRange(items); 

} 

public bool HasPreviousPage 

{ 

get 

{ 

return (Pagelndex > 1); 

} 

} 

public bool HasNextPage 

{ 

get 

{ 

return (Pagelndex < TotalPages); 

} 

} 

public static async Task<PaginatedList<T>> CreateAsync( 

IQueryable<T> source, int pagelndex, int pageSize) 

{ 

var count = await source.CountAsync(); 
var items = await source.Skip( 

(pagelndex - 1) * pageSize) 

.Take(pageSize).ToListAsync(); 

return new PaginatedList<T>(itemSj count, pagelndex, pageSize); 

} 

} 

} 


Yukarıdaki koddaki 

skip 

Take 

ıçueryable yöntemi sayfa boyutunu ve sayfa numarasını alır ve 1 a uygun ve 

deyimlerini uygular. 

CreateAsync 

ToListAsync 

Üzerindeçağrıldığında,yalnızcaistenensayfayı ıçueryable içeren 


bir liste döndürür. Özellikler HasPreviousPage ve HasNextPage önceki ve sonraki sayfalama düğmelerini 
etkinleştirmek veya devre dışı bırakmak için kullanılır. 

Yöntemi oluşturmak için kullanılır. PaginatedList<T> createAsync Oluşturucu PaginatedList<T> nesneyi 
oluşturamıyor; oluşturucular zaman uyumsuz kod çalıştıramıyor. 

PageModel sınıfına sayfalama ekleme 

Öğrerıciler/lndex. cshtml. cs ' deki kodu, sayfalama eklemek için değiştirin. 

using ContosoUniversity.Data; 
using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.EntityFrameworkCore; 









using System; 

using System.Collections.Generic; 

using System.Linq; 

using System.Threading.Tasks; 

namespace ContosoUnivensity.Pages.Students 

{ 

public class IndexModel : PageModel 

{ 

private readonly SchoolContext _context; 

public IndexModel(SchoolContext context) 

{ 

_context = context; 

} 

public string NameSont { get; set; } 
public string DateSort { get; set; } 
public string CurrentFilter { get; set; } 
public string CurrentSort { get; set; } 

public PaginatedList<Student> Students { get; set; } 

public async Task OnGetAsync(string sortOrder, 

string CurrentFilter, string searchString, int? pagelndex) 

{ 

CurrentSort = sortOrder; 

NameSort = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 

DateSort = sortOrder == "Date" ? "date_desc" : "Date"; 
if (searchString ! = null) 

{ 

pagelndex = 1; 

} 

else 

{ 

searchString = CurrentFilter; 

} 

CurrentFilter = searchString; 

IQueryable<Student> studentsIQ = from s in _context.Students 

select s; 

if (!String.IsNullOrEmpty(searchString)) 

{ 

studentsIQ = studentsIQ.Where(s => s.LastName.Contains(searchString) 
| s.FirstMidName.Contains(searchString)); 

} 

switch (sortOrder) 

{ 

case "name_desc": 

studentsIQ = studentsIQ.OrderByDescending(s => s.LastName); 
break; 

case "Date": 

studentsIQ = studentsIQ.OrderBy(s => s.EnrollmentDate); 
break; 

case "date_desc": 

studentsIQ = studentsIQ.OrderByDescending(s => s.EnrollmentDate) 
break; 
default: 

studentsIQ = studentsIQ.OrderBy(s => s.LastName); 
break; 

} 

int pageSize = 3; 

Students = await PaginatedList<Student>.CreateAsync( 

studentsIQ.AsNoTracking(), pagelndex ?? 1, pageSize); 


} 


Yukarıdaki kod: 


• Students Özelliğinin türünü PaginatedList<Student> olarak değiştirir. IList<Student> 

• Sayfa dizinini, geçerli sortorder currentFilter ve onGetAsync öğesini Yöntem imzasına ekler. 

• Sıralama düzenini CurrentSort özelliğine kaydeder. 

• Yeni bir arama dizesi olduğunda sayfa dizinini 1 olarak sıfırlar. 

• Öğrenci varlıklarını almak için sınıfınıkullanır PaginatedList 

Şu durumlarda OnGetAsync alan tüm parametreler null: 

• Sayfa öğrenciler bağlantısından çağrılır. 

• Kullanıcı bir sayfalama veya sıralama bağlantısına tıklamadı. 

Bir sayfalama bağlantısına tıklandığında, sayfa dizin değişkeni görüntülenecek sayfa numarasını içerir. 

CurrentSort Özelliği, geçerli sıralama düzeni ile Razor sayfasını sağlar.Disk belleği sırasında sıralama düzenin 
korumak için geçerli sıralama düzeni, sayfalama bağlantılarına eklenmelidir. 

CurrentFilter Özelliği, Razor sayfasını geçerli filtre dizesiyle birlikte sağlar. CurrentFilter Değer: 

• Disk belleği sırasında filtre ayarlarını korumak için disk belleği bağlantılarına eklenmelidir. 

• Sayfa yeniden görüntülendiğinde metin kutusuna geri yüklenmelidir. 

Sayfalama sırasında arama dizesi değiştirilirse sayfa 1 ' e sıfırlanır. Yeni filtre farklı verilerin görüntülenmesini 
sağladığından sayfanın 1 olarak sıfırlanması. Bir arama değeri girildiğinde ve Gönder seçildiğinde: 

• Arama dizesi değiştirildi. 

• searchstring Parametre null değil. 

Yöntemi PaginatedList.CreateAsync , öğrenci sorgusunu, sayfalama destekleyen bir koleksiyon türündeki tek 
bir öğrenci sayfasına dönüştürür. Bu tek öğrenci sayfası Razor sayfasına geçirilir. 

Çağrıdan PaginatedList.CreateAsync sonraki pageindex iki soru işareti, null birleşim işlecinitemsil eder. Null 
birleşim işleci, null yapılabilir bir tür için varsayılan değeri tanımlar, ifade (pageindex ?? ı) , bir değer 
pageindex içeriyorsa değerini döndürür anlamına gelir. pageindex Değer yoksa 1 döndürün. 

Razor sayfasına sayfalama bağlantıları ekleme 

Öğrenciler/lndex. cshtml içindeki kodu aşağıdaki kodla değiştirin. Değişiklikler vurgulanır: 

@page 

@model ContosoUniversity.Pages.Students.IndexModel 
@{ 

ViewData["Title"] = "Students"; 

} 

<h2>Students</h2> 

<P> 

<a asp-page="Cneate">Cneate New</a> 

</p> 

<form asp-page="./Index" method="get"> 

<div class="form-actions no-colon"> 

<P> 

Find by name: 

<input type="text" name="SearchString" value="@Model.CurrentFilter" /> 

<input type="submit" value="Search" class="btn btn-primary" /> | 


cp p<;n-npap= n ./TnrİPY M ^Rprk tn -Fiili I 

















</p> 

</div> 

</form> 

<table class="table"> 

<thead> 

<tr> 

<th> 

<a asp-page="./Index" asp-route-sortOrder="@Model.NameSort" 
asp-route-currentFilter="@Model.CurrentFilter"» 
@Fltml.DisplayNameFor(model => model.Students[0].LastName) 

</a> 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Students[0]. FirstMidName) 

</th> 

<th> 

<a asp-page="./Index" asp-route-sortOrder="@Model.DateSort" 
asp-route-currentFilter="@Model.CurrentFilter"» 
@Html.DisplayNameFor(model => model.Students[0].EnrollmentDate) 

</a> 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model.Students) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.LastName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.FirstMidName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.EnrollmentDate) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.ID"»Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID"»Details</a> | 

<a asp-page="./Delete" asp-route-id="@item.ID"»Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 

var prevDisabled = IModel.Students.FlasPreviousPage ? "disabled" : 
var nextDisabled = !Model.Students.HasNextPage ? "disabled" : 

} 

<a asp-page="./Index" 

asp-route-sortOrder="@Model.CurrentSort" 
asp-route-pageIndex="@(Model.Students.Pagelndex - 1)" 
asp-route-currentFilter="@Model.CurrentFilter" 
class="btn btn-primary @prevDisabled"> 

Previous 

</a> 

<a asp-page="./Index" 

asp-route-sortOrder="@Model.CurrentSort" 
asp-route-pageIndex="@(Model.Students.Pagelndex + 1)" 
asp-route-currentFilter="@Model.CurrentFilter" 
class="btn btn-primary @nextDisabled"> 

Next 


</a> 


Sütun üst bilgisi bağlantıları, geçerli arama dizesini onGetAsync yönteme geçirmek için sorgu dizesini kullanır: 


<a asp-page="./Index" asp-route-sortOrder="@Model.NameSort" 
asp-route-currentFilter="@Model.CurrentFilter"> 
@Html.DisplayNameFor(model => model.Students[0].LastName) 

</a> 


Sayfalama düğmeleri etiket yardımcıları tarafından görüntülenir: 


<a asp-page="./Index" 

asp-route-sortOrder="@Model.CurrentSort" 
asp-route-pageIndex="@(Model.Students.PageIndex - 1)" 
asp-route-currentFilter="@Model.CurrentFilter" 
class="btn btn-primary @prevDisabled"> 

Previous 

</a> 

<a asp-page="./Index" 

asp-route-sortOrder="@Model.CurrentSort" 
asp-route-pageIndex="@(Model.Students.PageIndex + 1)" 
asp-route-currentFilter="@Model .CurrentFllter'" 
class="btn btn-primary @nextDisabled"> 

Next 

</a> 


Uygulamayı çalıştırın ve öğrenciler sayfasına gidin. 

• Sayfalama ’nin çalıştığından emin olmak için, farklı sıralama emirlerindeki disk belleği bağlantılarına tıklayın. 

• Disk belleğinin sıralama ve filtreleme ile düzgün çalıştığını doğrulamak için bir arama dizesi girin ve 
sayfalama yapmayı deneyin. 

Contoso University 

Students 


Create New 


Find by name: 


1 1 Back to full List 

LastName 

FirstMidName 

EnrolImentDate 


Alexander 

Carson 

9/1/2019 12:00:00 AM 

Edit | Details | Delete 

Alonso 

Meredith 

9/1/2017 12:00:00 AM 

Edit | Details | Delete 

Anand 

Arturo 

9/1/2018 12:00:00 AM 

Edit | Details | Delete 


Next 
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Gruplandırma Ekle 








Bu bölüm, her kayıt tarihi için kaç öğrenciye kaydolduğunu görüntüleyen bir hakkında sayfası oluşturur. 
Güncelleştirme gruplamayı kullanır ve aşağıdaki adımları içerir: 

• Hakkında sayfasında kullanılan veriler için bir görünüm modeli oluşturun. 

• Görünüm modelini kullanmak için hakkında sayfasını güncelleştirin. 

Görünüm modeli oluşturma 

Modeller/SchoolVievvModels klasörü oluşturun. 

Aşağıdaki kodla SchoolViewModels/kayıtlarmı Mentdategroup. cs oluşturun: 

using System; 

using System.ComponentModel.DataAnnotations; 

namespace ContosoUniversity.Models.SchoolViewModels 

{ 

public class EnrollmentDateGroup 

{ 

[DataType(DataType.Date)] 

public DateTime? EnrollmentDate { get; set; } 
public int StudentCount { get; set; } 

} 

} 


Razor sayfasını oluşturma 

Aşağıdaki kodla bir Pages/about. cshtml dosyası oluşturun: 

@page 

@model ContosoUniversity.Pages.AboutModel 

@{ 

ViewData["Title"] = "Student Body Statistics"; 

} 

<h2>Student Body Statistics</h2> 

<table> 

<tr> 

<th> 

Enrollment Date 
</th> 

<th> 

Students 

</th> 

</tr> 

(Şforeach (var item in Model.Students) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.EnrollmentDate) 
</td> 

<td> 

@item.StudentCount 
</td> 

</tr> 

} 

</table> 


Sayfa modelini oluşturma 

Aşağıdaki kodla bir Pages/about. cshtml. cs dosyası oluşturun: 







using Contosollniversity .Models .SchoolViewModels; 

using Contosollniversity.Data; 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using Microsoft.EntityFrameworkCore; 

using System.Collections.Generic; 

using System.Linq; 

using System.Threading.Tasks; 

using Contosollniversity.Models; 

namespace ContosoUniversity.Pages 

{ 

public class AboutModel : PageModel 

{ 

private readonly SchoolContext _context; 

public AboutModel(SchoolContext context) 

{ 

_context = context; 

} 

public IList<EnrollmentDateGroup> Students { get; set; } 

public async Task OnGetAsync() 

{ 

IQueryable<EnrollmentDateGroup> data = 
from student in _context.Students 

group student by student.EnrollmentDate into dateGroup 
select new EnrollmentDateGroup() 

{ 

EnrollmentDate = dateGroup.Key, 

StudentCount = dateGroup.Count() 

}; 

Students = await data.AsNoîrackingO.ToListAsync(); 

} 

} 

} 


LINQ beyanı, öğrenci varlıklarını kayıt tarihine göre gruplandırır, her bir gruptaki varlıkların sayısını hesaplar ve 
sonuçları bir EnroiimentDateGroup görünüm modeli nesneleri koleksiyonunda depolar. 

Uygulamayı çalıştırın ve hakkında sayfasına gidin. Her kayıt tarihi için öğrenci sayısı bir tabloda görüntülenir. 

Contoso University 

Student Body Statistics 

Enrollment Date Students 

9/1/2016 1 

9/1/2017 3 

9/1/2018 2 

9/1/2019 2 
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Sonraki adımlar 

Sonraki öğreticide, uygulama, veri modelini güncelleştirmek için geçişleri kullanır. 



Bu öğreticide sıralama, filtreleme, gruplama ve sayfalama işlevleri eklenmiştir. 

Aşağıdaki çizimde tamamlanmış bir sayfa gösterilmektedir.Sütun başlıkları sütunu sıralamak için tıklatılabilir 
bağlantılardır. Sütun başlığına tıklanması, artan ve azalan sıralama düzeni arasında sürekli olarak geçiş yapar. 


E3 lndex - Contoso Univen X 

|+ 


X 

□ 

1 

<- 

localhost 5313/! 

☆ — 

Contoso University 



— 

lndex 

Create New 





Find by name: 


Search 

| Back to Full List 

Last Name 

First Name 

Enrollment Date 


Alexander 

Carson 

9/1/2005 12:00:00 AM 

Edit | Details | Delete 

Alonso 

Meredith 

9/1/2002 12:00:00 AM 

Edit | Details | Delete 

Anand 

Arturo 

9/1/2003 12:00:00 AM 

Edit | Details | Delete 

Previous 

Next 










Çözemediğiniz sorunlarla karşılaşırsanız, Tamamlanmış uygulamayıindirin. 


Dizin sayfasına sıralama Ekle 

Sıralama parametrelerini içerecek şekilde öğrenciler/tndex. cshtml. cs PageModei öğesine dizeler ekleyin: 

public class IndexModel : PageModei 
{ 

private readonly SchoolContext _context; 

public IndexModel(SchoolContext context) 

{ 

_context = context; 

} 

public string NameSort { get; set; } 
public string DateSort { get; set; } 
public string CurrentFilter { get; set; } 
public string CurrentSort { get; set; } 


Öğrerıciler/lndex. cshtml. cs onGetAsync ' i aşağıdaki kodla güncelleştirin: 














public async Task OnGetAsync(string sortOrder) 

{ 

NameSort = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 

DateSort = sortOrder == "Date" ? "date_desc" : "Date"; 

IQueryable<Student> studentIQ = from s in _context.Student 

select s; 

switch (sortOrder) 

{ 

case "name_desc": 

studentIQ = studentIQ.OrderByDescending(s => s.LastName); 
break; 

case "Date": 

studentIQ = studentIQ.OrderBy(s => s.EnrollmentDate); 
break; 

case "date_desc": 

studentIQ = studentIQ.OrderByDescending(s => s.EnrollmentDate); 
break; 
default: 

studentIQ = studentIQ.OrderBy(s => s.LastName); 
break; 

} 

Student = await studentIQ.AsNoTracking().ToListAsync(); 

} 

Yukarıdaki kod, URL 'deki sortOrder sorgu dizesinden bir parametre alır. URL (sorgu dizesi dahil), tutturucu 
etiketi Yardımcısı tarafından oluşturulur 

sortOrder Parametre "ad" ya da "Tarih" dır. Parametre sortOrder , isteğe bağlı olarak azalan sıra belirtmek için 
"_DESC" tarafından izlenir. Varsayılan sıralama düzeni artan. 

Öğrenciler bağlantısından Dizin sayfası istendiğinde sorgu dizesi yoktur.Öğrenciler, son ada göre artan sırada 
görüntülenir. Son ada göre artan sıralama, switch deyimindeki varsayılan (gelen durumdur). Kullanıcı bir 
sütun başlığı bağlantısına tıkladığında, sorgu dizesi değerinde uygun sortOrder değer sağlanır. 

NameSort ve DateSort Razor sayfası tarafından sütun başlığı köprülerini uygun sorgu dizesi değerleriyle 
yapılandırmak için kullanılır: 








public async Task OnGetAsync(string sortOrder) 

{ 

NameSort = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 

DateSort = sortOrder == "Date" ? "date_desc" : "Date"; 

IQueryable<Student> studentIQ = from s in _context.Student 

select s; 

switch (sortOrder) 

{ 

case "name_desc": 

studentIQ = studentIQ.OrderByDescending(s => s.LastName); 
break; 

case "Date": 

studentIQ = studentIQ.OrderBy(s => s.EnrollmentDate); 
break; 

case "date_desc": 

studentIQ = studentIQ.OrderByDescending(s => s.EnrollmentDate); 
break; 
default: 

studentIQ = studentIQ.OrderBy(s => s.LastName); 
break; 

} 


Student = await studentIQ.AsNoTracking().ToListAsync(); 

} 


Aşağıdaki kod, C# koşullu ?: işleciniiçerir: 


NameSort = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 
DateSort = sortOrder == "Date" ? "date_desc" : "Date"; 

J 


ilk satır, null veya boş sortOrder olduğunu belirtir, NameSort "name_desc" olarak ayarlanır. Null veya boş 


, ?: operatör Üçlü işleç olarak da bilinir. 


değilseboşbirdizeolarak NameSort ayarlanır. sortOrder 


Bu iki deyim, sayfanın sütun başlığı köprülerini şu şekilde ayarlamanızı sağlar: 


GEÇERLİ SIRALAMA DÜZENİ 

SON AD KÖPRÜSÜ 

TARİH KÖPRÜSÜ 

Artan son ad 

descending 

ascending 

Azalan son ad 

ascending 

ascending 

Artan Tarih 

ascending 

descending 

Azalan Tarih 

ascending 

ascending 


Yöntemi, sıralama yapılacak sütunu belirtmek için LINQ to Entities kullanır. Kod, Switch ifadesinden 
iQueryabie<student> önce bir başlatır ve Switch ifadesinde onu değiştirir: 









public async Task OnGetAsync(string sortOrder) 

{ 

NameSont = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 

DateSort = sortOrder == "Date" ? "date_desc" : "Date"; 

IQueryable<Student> studentIQ = from s in _context.Student 

select s; 

switch (sortOrder) 

{ 

case "name_desc": 

studentIQ = studentIQ.OrderByDescending(s => s.LastName); 
break; 

case "Date": 

studentIQ = studentIQ.OrderBy(s => s.EnrollmentDate); 
break; 

case "date_desc": 

studentIQ = studentIQ.OrderByDescending(s => s.EnrollmentDate); 
break; 
default: 

studentIQ = studentIQ.OrderBy(s => s.LastName); 
break; 

} 

Student = await studentIQ.AsNoTracking().ToListAsync(); 


Bir iQueryabie oluşturulduğunda veya değiştirildiğinde, veritabanına hiçbir sorgu gönderilmez. ıçiueryabie 
Nesne bir koleksiyona dönüştürülene kadar sorgu yürütülmez. ıçiueryabie , gibi bir yöntemi ToListAsync 
çağırarak bir koleksiyona dönüştürülür. Bu nedenle, ıçueryable kod, aşağıdaki deyime kadar yürütülemeyen 
tek bir sorgu ile sonuçlanır: 

Student = await studentIQ.AsNoTracking().ToListAsync(); 

onGetAsync çok sayıda sıralanabilir sütunla ayrıntı alabilir. 

Öğrenci dizini sayfasına sütun başlığı köprüleri ekleme 

Öğrenciler/lndex. cs/ıfm/içindeki kodu aşağıdaki vurgulanmış kodla değiştirin: 











@page 

@model ContosoUniversity. Pages. Students. IndexModel 

@{ 

ViewData["Title"] = "Index"; 

} 

<h2>Index</h2> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<table class="table"> 

<thead> 

<tr> 

<th> 

<a asp-page="./Index" asp-route-sortOrder="@Model.NameSort"> 
@Html.DisplayNameFor(model => model.Student[0].LastName) 

</a> 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Student[0].FirstMidName) 

</th> 

<th> 

<a asp-page="./Index" asp-route-sortOrder="@Model.DateSort"> 

@Html.DisplayNameFon(model => model.Student[0].EnrollmentDate) 

</a> 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model.Student) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.LastName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.FirstMldName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.EnrollmentDate) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID">Details</a> | 
<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 


Yukarıdaki kod: 

• LastName Ve EnrollmentDate sütun başlıklarına köprüler ekler. 

• , Ve NameSort DateSort içindeki bilgileri kullanarak geçerli sıralama düzeni değerleriyle köprüler ayarlar. 
Sıralamanın çalıştığını doğrulamak için: 

• Uygulamayı çalıştırın ve öğrenciler sekmesini seçin. 

• Son ad 1 a tıklayın. 

• Kayıt tarihi 1 ne tıklayın. 





Kodu daha iyi anlamak için: 


• Öğrenciler/lndex. cshtml. csdosyasında, üzerinde switch (sortorder) bir kesme noktası ayarlayın. 

• NameSort Ve DateSort için bir izleme ekleyin. 

• Öğrenciler/lndex. cshtml'de, üzerinde @Html.DisplayNameFor(model => model.Student[0] .LastName) bir kesme 
noktası ayarlayın. 

Hata ayıklayıcıda adım adım. 


Öğrenciler dizin sayfasına bir arama kutusu ekleyin 

Öğrenciler dizin sayfasına filtre eklemek için: 


• Razor sayfasına bir metin kutusu ve bir Gönder düğmesi eklenir. Metin kutusu, ad veya soyadı üzerinde bir 
arama dizesi sağlar. 

• Sayfa modeli metin kutusu değerini kullanacak şekilde güncelleştirilir. 


Dizin yöntemine filtreleme işlevi ekleme 

Öğrenciler/lndex. cshtml. cs onGetAsync 1 i aşağıdaki kodla güncelleştirin: 


public async Task OnGetAsync(string sortorder, string searchString) 

{ 

NameSort = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 
DateSort = sortOrder == "Date" ? "date_desc" : "Date"; 
CurrentFilter = searchString; 


IQueryable<Student> studentIQ = from s in _context.Student 

select s; 

if (I String.IsNullOrEmpty(searchString)) 

{ 


} 


studentIQ = studentIQ.Where(s => s.LastName.Contains(searchString) 
| s.FirstMidName.Contains(searchString)); 


switch (sortorder) 

{ 

case "name_desc": 

studentIQ = studentIQ.OrderByDescending(s => s.LastName); 
break; 

case "Date": 

studentIQ = studentIQ.OrderBy(s => s.EnrollmentDate); 
break; 

case "date_desc": 

studentIQ = studentIQ.OrderByDescending(s => s.EnrollmentDate); 
break; 
default: 

studentIQ = studentIQ.OrderBy(s => s.LastName); 
break; 


Student = await studentIQ.AsNoTracking().ToListAsync(); 

} 


Yukarıdaki kod: 

• OnGetAsync Yöntemine searchString parametresini ekler. Arama dizesi değeri bir sonraki bölüme eklenen 
bir metin kutusundan alınır. 

• LINQ deyimi bir where yan tümcesine eklendi. where Yan tümce yalnızca adı veya soyadı arama dizesini 
içeren öğrencileri seçer. LINQ deyimleri yalnızca aranacak bir değer varsa yürütülür. 

Not: Yukarıdaki kod, where metodu bir ıçueryable nesne üzerinde çağırır ve filtre sunucuda işlenir. Bazı 














senaryolarda, uygulama bir bellek içi koleksiyonda bir genişletme where yöntemi olarak yöntemi çağırıyor 
olabilir. Örneğin, EF Core DbSet 'den _context.students bir iEnumerabie koleksiyonu döndüren bir depo 
yöntemine yapılan değişiklikleri varsayın. Sonuç normalde aynı olur, ancak bazı durumlarda farklı olabilir. 

Örneğin, uygulamasının contains .NET Framevvork uygulanması varsayılan olarak büyük/küçük harfe duyarlı 
bir karşılaştırma gerçekleştirir. SÖL Server, contains büyük/küçük harf duyarlılığı SÖL Server örneğinin 
harmanlama ayarına göre belirlenir. SQL Server varsayılan olarak büyük/küçük harfe duyarlı değildir. Toupper 
testi açık büyük/küçük harfe duyarsız hale getirmek için çağrılabilir: 

Where(s => s.LastName.ToUpper().Contains(searchString.ToUpper()) 

Yukarıdaki kod, kodun kullanım iEnumerabie için değişiklik yaptığı durumlarda sonuçların büyük/küçük harf 
duyarsız olmasını sağlar, contains Bir iEnumerabie koleksiyon üzerinde çağrıldığında .NET Core uygulamasını 
kullanır, contains Bir ıçueryable nesne üzerinde çağrıldığında, veritabanı uygulamasını kullanır. iEnumerabie 
Bir depodan döndürmek önemli bir performans cezasına sahip olabilir: 

1. Tüm satırlar DB sunucusundan döndürülür. 

2. Filtre, uygulamadaki tüm döndürülen satırlara uygulanır. 

Çağırmak Toupper için bir performans cezası vardır. Toupper Kod, TSÖL SELECT ifadesinin VVHERE yan 
tümcesine bir işlev ekler. Eklenen işlev, iyileştiricinin bir dizin kullanmasını önler.SÖL, büyük/küçük harfe 
duyarsız olarak yüklendiği için, gerekli olmadığında Toupper çağrının önüne geçmek en iyisidir. 

Öğrenci dizin sayfasına bir arama kutusu ekleyin 

Sayfalar/öğrenciler/lndex. cshtml' de, bir arama düğmesi ve asi grafik Chrome oluşturmak için aşağıdaki 
vurgulanmış kodu ekleyin. 

@page 

@model ContosoUniversity.Pages.Students.IndexModel 

@{ 

ViewData["Title"] = "Index"; 

} 

<h2>Index</h2> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<form asp-page="./Index" method="get"> 

<div class="form-actions no-color"> 

<P> 

Find by name: 

«cinput type="text" name="SearchString" value="@Model.CurrentFilter" /> 

<input type="submit" value="Search" class="btn btn-default" /> | 

<a asp-page="./Index">Back to full List</a> 

</p> 

</div> 

</form> 

<table class="table"> 

Yukarıdaki kod, arama metin <fonm> kutusu ve düğme eklemek için etiket yardımcısını kullanır. Varsayılan 
olarak, <form> etiket Yardımcısı form verilerini bir gönderiyle gönderir. POST ile parametreler, URL 'de değil 
HTTP ileti gövdesine geçirilir. HTTP GET kullanıldığında, form verileri URL 'ye sorgu dizeleri olarak geçirilir. 
Verilerin sorgu dizelerine geçirilmesi, kullanıcıların URL 'Yİ yer işaretine eklemesini sağlar. W3C yönergeleri , 
eylem bir güncelleştirme ile SONUÇLANMAZSA, Get 'in kullanılması önerilir. 


Uygulamayı test edin: 























• Öğrenciler sekmesini seçin ve bir arama dizesi girin. 

• Ara' yı seçin. 

URL 'nin arama dizesini içerdiğine dikkat edin. 

http://localhost:5000/Students?SearchString=an 

Sayfa yer işaretiyle, yer işareti sayfanın URL 'sini ve searchstring sorgu dizesini içerir. method="get" 

Etiketi,sorgu form dizesinin oluşturulmasına neden oldu. 

Şu anda, bir sütun başlığı sıralama bağlantısı seçildiğinde, arama kutusundaki filtre değeri kaybedilir. Kayıp 
filtre değeri bir sonraki bölümde düzeltilir. 

Öğrenciler dizin sayfasına sayfalama işlevselliği ekleme 

Bu bölümde, sayfalama desteği PaginatedList için bir sınıf oluşturulur. Sınıfı, tablodaki tüm Take satırları 
almak yerine, sunucudaki verileri filtrelemek için ve deyimlerini kullanır skip . PaginatedList Aşağıdaki 
çizimde sayfalama düğmeleri gösterilmektedir. 
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Find by name: 


Search 

| Back to Full List 

Last Name 

First Name 
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Alexander 

Carson 

9/1/2005 12:00:00 AM 

Edit | Details | Delete 

Alonso 

Meredith 
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Proje klasöründe aşağıdaki kodla oluşturun PaginatedList.es : 













using System; 

using System.Collections.Generic; 
using System.Linq; 
using System.Threading.Tasks; 
using Microsoft.EntityFrameworkCore; 

namespace ContosoUniversity 

{ 

public class PaginatedList<T> : List<T> 

{ 

public int Pagelndex { get; private set; } 
public int TotalPages { get; private set; } 

public PaginatedList(List<T> items, int count, int pagelndex, int pageSize) 

{ 

Pagelndex = pagelndex; 

TotalPages = (int)Math.Ceiling(count / (double)pageSize); 
this.AddRange(items); 

} 

public bool HasPreviousPage 

{ 

get 

{ 

return (Pagelndex > 1); 

} 

} 

public bool HasNextPage 

{ 

get 

{ 

return (Pagelndex < TotalPages); 

} 

} 

public static async Task<PaginatedList<T>> CreateAsync( 

IQueryable<T> source, int pageIndeXj int pageSize) 

{ 

var count = await source.CountAsync(); 
var items = await source.Skip( 

(pagelndex - 1) * pageSize) 

.Take(pageSize).ToListAsync(); 

return new PaginatedList<T>(itemSj countj pagelndex, pageSize); 

} 

} 

} 


Yukarıdaki koddaki 

skip 

Take 

ıçueryable yöntemi sayfa boyutunu ve sayfa numarasını alır ve 1 a uygun ve 

deyimlerini uygular. 

CreateAsync 

ToListAsync 

Üzerindeçağrıldığında,yalnızcaistenensayfayı ıçueryable içeren 


bir liste döndürür. Özellikler HasPreviousPage ve HasNextPage önceki ve sonraki sayfalama düğmelerini 
etkinleştirmek veya devre dışı bırakmak için kullanılır. 

Yöntemi oluşturmak için kullanılır. PaginatedList<T> CreateAsync Bir Oluşturucu PaginatedList<T> nesneyi 
oluşturamaz, oluşturucular zaman uyumsuz kod çalıştıramıyorum. 

Dizin yöntemine sayfalama işlevselliği ekleme 

Öğrenciler/lndex. cshtml. csdosyasında, türünü student ile PaginatedList<student> arasında nist<student> 
güncelleştirin: 













public PaginatedList<Student> Student { get; set; } 

Öğrerıciler/lndex. cshtml. cs 

OnGetAsync 

' i aşağıdaki kodla güncelleştirin: 


public async Task OnGetAsync(string sortOrder, 

string currentFilter, string searchString, int? pagelndex) 

{ 

CurrentSort = sortOrder; 

NameSort = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 

DateSort = sortOrder == "Date" ? "date_desc" : "Date"; 
if (searchString != null) 

{ 

pagelndex = 1; 

} 

else 

{ 

searchString = currentFilter; 

} 

CurrentFilter = searchString; 

IQueryable<Student> studentIQ = from s in _context.Student 

select s; 

if (!String.IsNullOrEmpty(searchString)) 

{ 

studentIQ = studentIQ.Where(s = > s.LastName.Contains(searchString) 

| s.FirstMidName.Contains(searchString)); 

} 

switch (sortOrder) 

{ 

case "name_desc": 

studentIQ = studentIQ.OrderByDescending(s => s.LastName); 
break; 

case "Date": 

studentIQ = studentIQ.OrderBy(s => s.EnrollmentDate); 
break; 

case "date_desc": 

studentIQ = studentIQ.OrderByDescending(s => s.EnrollmentDate); 
break; 
default: 

studentIQ = studentIQ.OrderBy(s => s.LastName); 
break; 

} 

int pageSize = 3; 

Student = await PaginatedList<Student>.CreateAsync( 

studentIQ.AsNoTracking(), pagelndex ?? 1 , pageSize); 


Yukarıdaki kod, sayfa dizinini, geçerli sortOrder currentFilter ve öğesini Yöntem imzasına ekler. 

public async Task OnGetAsync(string sortOrder., 

string currentFilter, string searchString, int? pagelndex) 


Şu durumlarda tüm parametreler null: 

• Sayfa öğrenciler bağlantısından çağrılır. 

• Kullanıcı bir sayfalama veya sıralama bağlantısına tıklamadı. 

Bir sayfalama bağlantısına tıklandığında, sayfa dizin değişkeni görüntülenecek sayfa numarasını içerir. 
Currentsort geçerli sıralama düzeninde Razor sayfası sağlar. Disk belleği sırasında sıralama düzenini korumak 








için geçerli sıralama düzeni, sayfalama bağlantılarına eklenmelidir. 

CurrentFilter geçerli filtre dizesiyle Razor sayfasını sağlar. CurrentFilter Değer: 

• Disk belleği sırasında filtre ayarlarını korumak için disk belleği bağlantılarına eklenmelidir. 

• Sayfa yeniden görüntülendiğinde metin kutusuna geri yüklenmelidir. 

Sayfalama sırasında arama dizesi değiştirilirse sayfa 1 ' e sıfırlanır. Yeni filtre farklı verilerin görüntülenmesini 
sağladığından sayfanın 1 olarak sıfırlanması. Bir arama değeri girildiğinde ve Gönder seçildiğinde: 

• Arama dizesi değiştirildi. 

• searchstring Parametre null değil. 

if (searchstring != null) 

{ 

pagelndex = 1; 

} 

else 

{ 

searchstring = currentFilter; 

} 

Yöntemi PaginatedList.createAsync , öğrenci sorgusunu, sayfalama destekleyen bir koleksiyon türündeki tek 
bir öğrenci sayfasına dönüştürür. Bu tek öğrenci sayfası Razor sayfasına geçirilir. 

Student = await PaginatedList<Student>.CreateAsync( 

studentIQ.AsNoTracking(), pagelndex ?? 1 , pageSize); 

içindeki PaginatedList.createAsync iki soru işareti, null birleşim işlecinitemsil eder. Null birleşim işleci, null 
yapılabilir bir tür için varsayılan değeri tanımlar, ifade (pageindex ?? i) , bir değer pageindex içeriyorsa 
değerini döndürür anlamına gelir. pageindex Değer yoksa 1 döndürün. 

Öğrenci Razor sayfasına sayfalama bağlantıları ekleme 

Öğrenciler/lndex. cshtml'de biçimlendirmeyi güncelleştirin. Değişiklikler vurgulanır: 

@page 

@model Contosollniversity. Pages. Students. IndexModel 
@{ 

ViewData["Title"] = "Index"; 

} 

<h2>Index</h2> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<form asp-page="./Index" method="get"> 

<div class="form-actions no-color"> 

<P> 

Find by name: cinput type="text" name="SearchString" value="@Model.CurrentFilter" /> 

<input type="submit" value="Search" class="btn btn-default" /> | 

<a asp-page="./Index">Back to full List</a> 

</p> 

</div> 

</fonm> 


<table class="table"> 












<thead> 

<tr> 

<th> 

<a asp-page="./Index" asp-route-sortOrder="@Model.NameSort" 
asp-route-currentFilter="@Model.CurrentFilter"> 
@Html.DisplayNameFor(model => model.Student[0].LastName) 

</a> 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Student[0].FirstMidName) 

</th> 

<th> 

<a asp-page="./Index" asp-route-sortOrder="@Model.DateSort" 
asp-route-currentFilter="@Model.CurrentFilter"> 
@Html.DisplayNameFor(model => model.Student[0].EnrollmentDate) 

</a> 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model.Student) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.LastName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.FirstMidName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.EnrollmentDate) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID">Details</a> | 
<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 

var prevDisabled = IModel.Student.HasPreviousPage ? "disabled" : 
var nextDisabled = !Model.Student.HasNextPage ? "disabled" : 

} 

<a asp-page="./Index" 

asp-route-sortOrder="@Model.CurrentSort" 
asp-route-pageIndex="@(Model.Student.Pagelndex - 1)" 
asp-route-currentFilter="@Model.CurrentFilter" 
class="btn btn-default @prevDisabled"> 

Previous 

</a> 

<a asp-page="./Index" 

asp-route-sortOrder="@Model.CurrentSort" 
asp-route-pageIndex="@(Model.Student.Pagelndex + 1)" 
asp-route-currentFilter="@Model.CurrentFilter" 
class="btn btn-default @nextDisabled"> 

Next 

</a> 


Sütun üst bilgisi bağlantıları, kullanıcının filtre sonuçları içinde sıralama yapabilmesi için geçerli arama dizesini 
onGetAsync yöntemine geçirmek üzere sorgu dizesini kullanır: 



<a asp-page="./Index" asp-route-sortOrder="@Model.NameSort" 
asp-route-currentFilter="@Model.CurrentFilter"> 
@Html.DisplayNameFor(model => model.Student[0].LastName) 

</a> 


Sayfalama düğmeleri etiket yardımcıları tarafından görüntülenir: 


<a asp-page="./Index" 

asp-route-sortOrder="@Model.CurrentSort" 
asp-route-pageIndex="(5)(Model.Student.PageIndex - 1)" 
asp-route-currentFilter="@Model.CurrentFilter" 
class="btn btn-default @prevDisabled"> 

Previous 

</a> 

<a asp-page="./Index" 

asp-route-sortOrder="@Model.CurrentSort" 
asp-route-pageIndex="@(Model.Student.PageIndex + 1)" 
asp-route-currentFilter="@Model.CurrentFilter" 
class="btn btn-default @nextDisabled"> 

Next 

</a> 


Uygulamayı çalıştırın ve öğrenciler sayfasına gidin. 

• Sayfalama 1 nin çalıştığından emin olmak için, farklı sıralama emirlerindeki disk belleği bağlantılarına tıklayı 

• Disk belleğinin sıralama ve filtreleme ile düzgün çalıştığını doğrulamak için bir arama dizesi girin ve 
sayfalama yapmayı deneyin. 
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Kodu daha iyi anlamak için: 

• Öğrenciler/lndex. cshtml. csdosyasında, üzerinde switch (sortorder) bir kesme noktası ayarlayın. 


NameSort 

, Ve 

DateSort 

CurrentSort için birizlemeekleyin. 

Model.Student.Pagelndex 


• Öğrenciler/lndex. cshtml'de, üzerinde @Htmi.DispiayNameFor(modei => model.student[0].LastName) bir kesme 
noktası ayarlayın. 
















Hata ayıklayıcıda adım adım. 


Öğrenci istatistiklerini göstermek için hakkında sayfasını 
güncelleştirin 

Bu adımda, Sayfalar/about. cshtml, her bir kayıt tarihi için kaç öğrenciye kaydolduğunu görüntüleyecek şekilde 
güncelleştirilir. Güncelleştirme gruplamayı kullanır ve aşağıdaki adımları içerir: 

• Hakkında sayfasında kullanılan veriler için bir görünüm modeli oluşturun. 

• Görünüm modelini kullanmak için hakkında sayfasını güncelleştirin. 

Görünüm modeli oluşturma 

Modeller klasöründe bir SchoolVievvModels klasörü oluşturun. 

SchoolVievvModels klasöründe aşağıdaki kodla bir EnrollmentDateGroup.es ekleyin: 

using System; 

using System.ComponentModel.DataAnnotations; 

namespace Contosollniversity .Models .SchoolViewModels 
{ 

public elass EnrollmentDateGroup 
{ 

[DataType(DataType.Date)] 

public DateTime? EnrollmentDate { get; set; } 
public int StudentCount { get; set; } 

} 

} 

Hakkında sayfa modelini Güncelleştir 

ASP.NET Core 2,2 1 deki Web şablonları hakkında sayfasını içermez. ASP.NET Core 2,2 kullanıyorsanız, Razor 
hakkında sayfasını oluşturun. 

Pages/about. cshtml. cs dosyasını aşağıdaki kodla güncelleştirin: 






using Contosollniversity .Models .SchoolViewModels; 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using Microsoft.EntityFrameworkCore; 

using System.Collections.Generic; 

using System.Linq; 

using System.Threading.Tasks; 

using Contosollniversity.Models; 

namespace ContosoUniversity.Pages 

{ 

public class AboutModel : PageModel 

{ 

private readonly SchoolContext _context; 

public AboutModel(SchoolContext context) 

{ 

_context = context; 

} 

public IList<EnrollmentDateGroup> Student { get; set; } 

public async Task OnGetAsync() 

{ 

IQueryable<EnrollmentDateGroup> data = 
from student in _context.Student 

group student by student.EnrollmentDate into dateGroup 
select new EnrollmentDateGroup() 

{ 

EnrollmentDate = dateGroup.Key, 

StudentCount = dateGroup.Count() 

}; 

Student = await data.AsNoTracking().ToListAsync(); 

} 

} 

} 


LINQ beyanı, öğrenci varlıklarını kayıt tarihine göre gruplandırır, her bir gruptaki varlıkların sayısını hesaplar ve 
sonuçları bir EnroiimentDateGroup görünüm modeli nesneleri koleksiyonunda depolar. 

Razor hakkında sayfasında değişiklik yapma 

Pages/about. cshtml dosyasındaki kodu aşağıdaki kodla değiştirin: 





@page 

@model ContosoUniversity.Pages.AboutModel 


Vİ 0 wData["Title"] = "Student Body Statistics"; 

} 

<h2>Student Body Statistics</h2> 

<table> 

<tr> 

<th> 

Enrollment Date 
</th> 

<th> 

Students 

</th> 

</tr> 

@foreach (var item in Model.Student) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.EnrollmentDate) 

</td> 

<td> 

@item.StudentCount 
</td> 

</tr> 

} 

</table> 

Uygulamayı çalıştırın ve hakkında sayfasına gidin. Her kayıt tarihi için öğrenci sayısı bir tabloda görüntülenir. 
Çözemediğiniz sorunlarla karşılaşırsanız, Bu aşama için tamamlanmış uygulamayıindirin. 
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Enrollment Date Students 
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1 

3 

2 

1 

1 



Ek kaynaklar 


• 2. x kaynağı ASP.NET Core hata ayıklaması 

• Bu öğreticinin YouTube sürümü 


Sonraki öğreticide, uygulama, veri modelini güncelleştirmek için geçişleri kullanır. 
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ASRNET Core geçişleri ile EF Core Razor Pages-4/8 

23.11.2019 • 18 minutes to read ı Edit Online 


, Tom Dykstra, Jon P Smithve Rick Anderson 

Contoso Üniversitesi web uygulaması, EF Core ve Visual Studio kullanarak Razor Pages Web uygulamaları 
oluşturmayı gösterir. Öğretici serisi hakkında daha fazla bilgi için ilk öğreticiyebakın. 

Çözemediğiniz sorunlarla karşılaşırsanız, Tamamlanmış uygulamayı indirin ve öğreticiyi izleyerek bu kodu 
oluşturduğunuz şekilde karşılaştırın. 

Bu öğreticide, veri modeli değişikliklerini yönetmek için EF Core geçişleri özelliği tanıtılmıştır. 

Yeni bir uygulama geliştirildiğinde, veri modeli sıklıkla değişir. Modelin her değiştirilişinde, model veritabanıyla 
eşitlenmemiş olur. Bu öğretici serisi, mevcut değilse veritabanını oluşturmak için Entity Framevvork 
yapılandırılarak başlatılır. Veri modelinin her değiştirilişinde veritabanını bırakmalısınız. Uygulamanın bir 
sonraki çalıştırışında, EnsureCreated çağrısı yeni veri modeliyle eşleşecek şekilde veritabanını yeniden 
oluşturur. Dbinitializer sınıfı, yeni veritabanını temel alarak çalışır. 

Veritabanını veri modeliyle eşitlenmiş halde tutmaya yönelik bu yaklaşım, uygulamayı üretime dağıtana kadar 
iyi çalışır. Uygulama üretimde çalıştığında genellikle saklanması gereken verileri depolar. Uygulama her 
değişiklik yapıldığında (yeni sütun ekleme gibi) bir test veritabanıyla başlayamaz. EF Core geçişleri özelliği, 
yeni bir veritabanı oluşturmak yerine EF Core veritabanı şemasını güncelleştirmesine olanak sağlayarak bu 
sorunu çözer. 

Veri modeli değiştiğinde veritabanını bırakıp yeniden oluşturmak yerine, geçişler şemayı güncelleştirir ve var 
olan verileri korur. 


NOTE 

SQLite sınırlamaları 

Bu öğretici, mümkün olduğunda Entity Framevvork Core geçişleri özelliğini kullanır. Geçişler, veritabanı şemasını veri 
modelindeki değişikliklerle eşleşecek şekilde güncelleştirir. Bununla birlikte, geçişler yalnızca veritabanı altyapısının 
desteklediği değişiklik türlerini ve SQLİte 'un şema değiştirme özellikleri sınırlıdır. Örneğin, bir sütun ekleme desteklenir, 
ancak bir sütunu kaldırmak desteklenmez. Bir sütunu kaldırmak için bir geçiş oluşturulduysa, ef migrations add 
komut başarılı olur ef database update ancak komut başarısız olur. 

SQLİte sınırlamalarına yönelik geçici çözüm, tablodaki bir şeyler değiştiğinde tablo yeniden oluşturmak için geçiş kodunu 
el ile yazmak için kullanılır. Kod, up bir geçiş için ve Down yöntemlerine gidip şunları içerir: 

• Yeni bir tablo oluşturuluyor. 

• Eski tablodaki veriler yeni tabloya kopyalanıyor. 

• Eski tablo bırakılıyor. 

• Yeni tablo yeniden adlandırılıyor. 

Bu türün veritabanına özgü kodu yazma, Bu öğreticinin kapsamı dışındadır. Bunun yerine, bu öğretici bir geçiş uygulama 
girişimi başarısız olduğunda veritabanını bırakır ve yeniden oluşturur. Daha fazla bilgi için aşağıdaki kaynaklara bakın: 

• SQLİte EF Core veritabanı sağlayıcısı sınırlamaları 

• Geçiş kodunu özelleştirme 

• Veri dengeli dağıtımı 

• SQLİte ALTER TABLE ifadesi 







Veritabanını bırak 


• Visuai Studio 

• Visuai Studio Code 

Veritabanını silmek için SQL Server Nesne Gezgini (ssox) kullanın veya Paket Yöneticisi konsolunda 

(PMC) şu komutu çalıştırın: 

Drop-Database 


İlk geçiş oluşturma 

• Visuai Studio 

• Visuai Studio Code 

PMC 'de şu komutları çalıştırın: 

Add-Migration InitialCreate 
Update-Database 


Yukarı ve aşağı Yöntemler 

EF Core migrations add komut, veritabanını oluşturmak için kodu oluşturdu. Bu geçiş kodu geçişleri<zaman 
damgasında _lnitialCreate. cs dosyasında > . InitialCreate sınıfının up yöntemi, veri modeli varlık 
kümelerine karşılık gelen veritabanı tablolarını oluşturur. Down yöntemi, aşağıdaki örnekte gösterildiği gibi 
onları siler: 


using System; 

using Microsoft.EntityFrameworkCore.Metadata; 
using Microsoft.EntityFrameworkCore.Migrations; 

namespace ContosoUniversity.Migrations 

{ 

public partial class InitialCreate : Migration 

{ 

protected override void Up(MigrationBuilder migrationBuilder) 

{ 

migrationBuilder.CreateTable( 
name: "Course", 
columns: table => new 
{ 

CourselD = table.Column<int>(nullable: false), 

Title = table.Column<string>(nullable: true), 

Credits = table.Column<int>(nullable: false) 

}, 

constraints: table => 

{ 

table.PrimaryKey("PK_Course", x => x.CourselD); 

}); 

migrationBuilder.CreateTable( 
name: "Student", 
columns: table => new 
{ 

ID = table.Column<int>(nullable: false) 

.Annotation("SqlServer:ValueGenerationStrategy", 
SqlServerValueGenerationStrategy.IdentityColumn), 

LastName = table.Column<string>(nullable: true), 
FirstMidName = table.Column<string>(nullable: true). 







EnrollmentDate = table.Column<DateTime>(nullable: false) 

}, 

constraints: table => 

{ 

table.PrimaryKey("PK_Student", x => x.ID); 

}); 

migrationBuilder.CreateTable( 
name: "Enrollment", 
columns: table => new 
{ 

EnrollmentlD = table.Column<int>(nullable: false) 

.Annotation("SqlServer:ValueGenerationStrategy", 
SqlServerValueGenerationStrategy. IdentityColumn), 

CourselD = table.Column<int>(nullable: false), 

StudentlD = table.Column<int>(nullable: false), 

Grade = table.Column<int>(nullable: true) 

}, 

constraints: table => 

{ 

table.PrimaryKey("PK_Enrollment", x => x.EnrollmentlD); 
table.ForeignKey( 

name: "FK_Enrollment_Course_CourseID", 
column: x => x.CourselD, 
principalTable: "Course", 
principalColumn: "CourselD", 
onDelete: ReferentialAction.Cascade); 
table.ForeignKey( 

name: "FK_Enrollment_Student_StudentID", 
column: x => x.StudentlD, 
principalTable: "Student", 
principalColumn: "ID", 
onDelete: ReferentialAction.Cascade); 

}); 

migrationBuilder.Createlndex( 

name: "IX_Enrollment_CourseID", 
table: "Enrollment", 
column: "CourselD"); 

migrationBuilder.Createlndex( 

name: "IX_Enrollment_StudentID", 
table: "Enrollment", 
column: "StudentlD"); 

} 

protected override void Down(MigrationBuilder migrationBuilder) 

{ 

migrationBuilder.DropTable( 
name: "Enrollment"); 

migrationBuilder.DropTable( 
name: "Course"); 


} 


} 


} 


migrationBuilder.DropTable( 
name: "Student"); 


Önceki kod ilk geçişe yöneliktir. Kod: 

• migrations add initiaicreate komutu tarafından oluşturuldu. 

• database update komutu tarafından yürütülür. 

• Veritabanı bağlamı sınıfı tarafından belirtilen veri modeli için bir veritabanı oluşturur. 



Dosya adı için geçiş adı parametresi (örnekteki "ınitialcreate") kullanılır.Geçiş adı herhangi bir geçerli dosya adı 
olabilir. Geçiş sırasında nelerin yapıldığını özetleyen bir sözcük veya tümcecik seçmek en iyisidir.Örneğin, bir 
departman tablosu ekleyen bir geçişe "AddDepartmentTable" adı verilir. 

Geçişler geçmiş tablosu 

• Veritabanını incelemek için SSOX veya SQLİte aracınızı kullanın. 

• _EFMigrationsHistory tablo ekleme hakkında dikkat edin. _ EFMigrationsHistory tablo, hangi geçişlerin 

veritabanına uygulandığını izler. 

• _EFMigrationsHistory tablosundaki verileri görüntüleyin, ilk geçiş için bir satır gösterir. 

Veri modeli anlık görüntüsü 

Geçişler, geçiş/SchoolContextModelSnapshot. csiçindeki geçerli veri modelinin anlık görüntüsünü oluşturur. Bir 
geçiş eklediğinizde, EF geçerli veri modelini Snapshot dosyası ile karşılaştırarak nelerin değiştirildiğini belirler. 

Anlık görüntü dosyası veri modelinin durumunu izlediğinden, <timestamp>_<migrationname>.cs dosyasını 
silerek bir geçişi silemezsiniz. En son geçişi geri yüklemek için mignations remove komutunu kullanmanız 
gerekir. Bu komut, geçişi siler ve anlık görüntünün doğru şekilde sıfırlanmasını sağlar. Daha fazla bilgi için bkz. 

DotNet EF geçişleri kaldır. 

Yeniden oluşturulmasını kaldır 

Bu öğretici serisi EnsureCreated kullanılarak başlatıldı. EnsureCreated geçişler geçmişi tablosu oluşturmaz ve 
geçişle birlikte kullanılamaz. Bu, veritabanının düşürülme ve sıklıkla yeniden oluşturulduğu test veya hızlı 
prototip oluşturma için tasarlanmıştır. 

Bu noktadan sonra öğreticiler, geçişleri kullanacaktır. 

Data/Dbmmitializer. csdosyasında aşağıdaki satırı açıklama olarak inceleyin: 

context.Database.EnsureCreated(); 

Uygulamayı çalıştırın ve veritabanının çalıştığını doğrulayın. 

Üretimde geçişleri uygulama 

Uygulama başlangıcında, üretim uygulamalarının Database. Migrate olarak çağırmalarını öneririz, sunucu 
grubuna dağıtılan bir uygulamadan Migrate çağrılmamalıdır. Uygulama birden çok sunucu örneğine 
ölçekleniyorsa, veritabanı şeması güncelleştirmelerinin birden çok sunucudan oluşmaması veya okuma/yazma 
erişimiyle çakışmamasını sağlamak zordur. 

Veritabanı geçişi, dağıtımın bir parçası olarak ve denetimli bir şekilde yapılmalıdır. Üretim veritabanı geçiş 
yaklaşımları şunları içerir: 

• SQL betikleri oluşturmak ve dağıtımda SQL betikleri kullanmak için geçişleri kullanma. 

• Denetlenen bir ortamdan dotnet ef database update çalıştırılıyor. 

Sorun giderme 

Uygulama SQL Server LocalDB kullanıyorsa ve aşağıdaki özel durumu görüntülüyorsa: 













SqlException: Cannot öpen database "Contosollniversity" requested by the login. 

The login failed. 

Login failed for user 'user name'. 

Çözüm, bir komut isteminde dotnet ef database update çalıştırmak olabilir. 

Ek kaynaklar 

• Clı EF Core. 

• Paket Yöneticisi Konsolu (Visual Studio) 

Sonraki adımlar 

Sonraki öğreticide, veri modeli, varlık özellikleri ve yeni varlıklar eklenerek oluşturulur. 


ÖNCEKİ ■ SONRAKİ 

ÖĞRETİCİ ■ ÖĞRETİCİ 


Bu öğreticide, veri modeli değişikliklerini yönetmek için EF Core geçişleri özelliği kullanılır. 

Çözemediğiniz sorunlarla karşılaşırsanız, Tamamlanmış uygulamayıindirin. 

Yeni bir uygulama geliştirildiğinde, veri modeli sıklıkla değişir. Modelin her değiştirilişinde, model veritabanıyla 
eşitlenmemiş olur. Bu öğretici, mevcut değilse veritabanını oluşturmak için Entity Framework yapılandırılarak 
başlatılır. Veri modelinin her değiştirilişinde: 

• DB bırakılır. 

• EF, modelle eşleşen yeni bir tane oluşturur. 

• Uygulama, DB 'yi test verileriyle birlikte oluşturur. 

Bu yaklaşım, VERITABANıNı veri modeliyle eşitlenmiş halde tutmak, uygulamayı üretime dağıtana kadar iyi 
çalışır. Uygulama üretimde çalıştığında genellikle saklanması gereken verileri depolar. Uygulama her değişiklik 
yapıldığında (yeni sütun ekleme gibi) bir test DB ile başlayamaz. EF Core geçişleri özelliği, yeni bir 
VERITABANı oluşturmak yerine EF Core DB şemasını güncelleştirmesine olanak sağlayarak bu sorunu çözer. 

Veri modeli değiştiğinde VERITABANıNı bırakıp yeniden oluşturmak yerine, geçişler şemayı güncelleştirir ve 
mevcut verileri korur. 

Veritabanını bırak 

SQL Server Nesne Gezgini (ssox) veya database drop komutunu kullanın: 

• Visual Studio 

• Visual Studio Code 

Paket Yöneticisi konsolunda (PMC), aşağıdaki komutu çalıştırın: 

Drop-Database 

Yardım bilgileri almak için PMC'ten Get-Help about_EntıtyFrameworkCore çalıştırın. 

İlk geçiş oluşturma ve VERITABANıNı güncelleştirme 

Projeyi derleyin ve ilk geçişi oluşturun. 










• Visual Studio 

• Visual Studio Code 


Add-Migration InitialCreate 
Update-Database 


Yukarı ve aşağı yöntemlerini inceleyin 

EF Core migrations add komutu VERITABANıNı oluşturmak için kodu oluşturdu. Bu geçiş kodu 
geçişleri<zaman damgasında _lnitialCreate. cs dosyasında > . InitialCreate sınıfının up yöntemi, veri 
modeli varlık kümelerine karşılık gelen VERITABANı tablolarını oluşturur. Down yöntemi, aşağıdaki örnekte 
gösterildiği gibi onları siler: 

public partial class InitialCreate : Migration 
{ 

protected override void Up(MigrationBuilder migrationBuilder) 

{ 

migrationBuilder.CreateTable( 
name: "Course", 
columns: table => new 
{ 

CourselD = table.Column<int>(nullable: false), 

Title = table.Column<string>(nullable: true), 

Credits = table.Column<int>(nullable: false) 

}, 

constraints: table => 

{ 

table.PrimaryKey("PK_Course"j x => x.CourselD); 

}); 

migrationBuilder.CreateTable( 

protected override void Down(MigrationBuilder migrationBuilder) 

{ 

migrationBuilder.DropTable( 
name: "Enrollment"); 

migrationBuilder.DropTable( 
name: "Course"); 

migrationBuilder.DropTable( 
name: "Student"); 

} 

} 

Geçişler, bir geçiş için veri modeli değişikliklerini uygulamak üzere up yöntemini çağırır. Güncelleştirmeyi geri 
almak için bir komut girdiğinizde, geçişler Down yöntemini çağırır. 

Önceki kod ilk geçişe yöneliktir. Bu kod, migrations add InitialCreate komutu çalıştırıldığında 
oluşturulmuştur. Dosya adı için geçiş adı parametresi (örnekteki "ınitialcreate") kullanılır.Geçiş adı herhangi bir 
geçerli dosya adı olabilir. Geçiş sırasında nelerin yapıldığını özetleyen bir sözcük veya tümcecik seçmek en 
iyisidir. Örneğin, bir departman tablosu ekleyen bir geçişe "AddDepartmentTable" adı verilir. 

ilk geçiş oluşturulur ve VERITABANı varsa: 

• DB oluşturma kodu oluşturulur. 

• DB, veri modeliyle zaten eşleştiğinden, DB oluşturma kodunun çalıştırılması gerekmiyor. DB oluşturma 
kodu çalıştırılsa, VERITABANı veri modeliyle zaten eşleştiğinden hiçbir değişiklik yapmaz. 

Uygulama yeni bir ortama dağıtıldığında, DB oluşturmak için DB oluşturma kodunun çalıştırılması gerekir. 

Daha önce VERITABANı bırakılmıştı ve mevcut olmadığından geçişler yeni DB 'yi oluşturur. 











Veri modeli anlık görüntüsü 

Geçişler geçişlerde/SchoolContextModelSnapshot. cs' de geçerli veritabanı şemasının anUk görüntüsünü 
oluşturur. Bir geçiş eklediğinizde EF, veri modeli Snapshot dosyası ile karşılaştırılarak nelerin değiştirildiğini 
belirler. 

Bir geçişi silmek için aşağıdaki komutu kullanın: 

• Visual Studio 

• Visual Studio Code 

Geçişi Kaldır 

Geçişleri Kaldır komutu geçişi siler ve anlık görüntünün doğru şekilde sıfırlanmasını sağlar. 

Uygulamayı kaldırın ve uygulamayı test edin 

Erken geliştirme için EnsureCreated kullanıldı. Bu öğreticide geçişler kullanılır. EnsureCreated aşağıdaki 
sınırlamalara sahiptir: 

• Geçişleri atlar ve DB ve şema oluşturur. 

• Geçişler tablosu oluşturmaz. 

• Geçişlerle kullandamaz. 

• , DB 'nin bıraktığı ve sıklıkla yeniden oluşturulduğu test veya hızlı prototipleme için tasarlanmıştır. 



Veritabanını inceleyin 

DB 'yi denetlemek için SQL Server Nesne Gezgini kullanın. _ EFMigrationsHistory tablo ekleme hakkında 

dikkat edin. _ EFMigrationsHistory tablo, hangi geçişlerin VERITABANıNA uygulandığını izler. 

tablosundaki verileri görüntüleyin, ilk geçiş için bir satır gösterir. Önceki CLı çıkış 
oturum, bu satırı oluşturan INSERT ifadesini gösterir. 

Uygulamayı çalıştırın ve her şeyin çalıştığını doğrulayın. 

Üretimde geçişleri uygulama 

Uygulama başlangıcında, üretim uygulamalarının Database. Migrate çağrısını yapmanızı öneririz, sunucu 
grubundaki bir uygulamadan Migrate çağrılmamalıdır. Örneğin, uygulama bulutu genişleme ile dağıtılmışsa 
(uygulamanın birden çok örneği çalışır). 

Veritabanı geçişi, dağıtımın bir parçası olarak ve denetimli bir şekilde yapılmalıdır. Üretim veritabanı geçiş 
yaklaşımları şunları içerir: 

• SOL betikleri oluşturmak ve dağıtımda SOL betikleri kullanmak için geçişleri kullanma. 

• Denetlenen bir ortamdan dotnet ef database update çalıştırılıyor. 

EF Core, herhangi bir geçişin çalıştırılması gerektiğini görmek için _ MigrationsHistory tablosunu kullanır. DB 

güncel değilse, hiçbir geçiş çalıştırılmaz. 

Sorun giderme 


_EFMigrationsHistory 

örneğinde yer alan son 


Tamamlanmış uygulamayıindirin. 












Uygulama aşağıdaki özel durumu oluşturur: 


SqlException: Cannot öpen database "ContosoUniversity" requested by the login. 
The login failed. 

Login failed for user 'user name'. 

ÇÖZÜm: dotnet ef database update Çalıştır 

Ek kaynaklar 

• Bu öğreticinin YouTube sürümü 

• .NETCoreCU. 

• Paket Yöneticisi Konsolu (Visual Studio) 


ÖNCEKİ ■ İLERİ 







ASRNET Core veri modelinde EF Core ile Razor 
Pages-5/8 

23.11.2019 * 86 minutes to read ı Edit Online 


Tarafından Tom Dykstra ve Rick Anderson 

Contoso Üniversitesi web uygulaması, EF Core ve Visual Studio kullanarak Razor Pages Web uygulamaları 
oluşturmayı gösterir. Öğretici serisi hakkında daha fazla bilgi için ilk öğreticiyebakın. 

Çözemediğiniz sorunlarla karşılaşırsanız, Tamamlanmış uygulamayı indirin ve öğreticiyi izleyerek bu kodu 
oluşturduğunuz şekilde karşılaştırın. 

Önceki öğreticiler, üç varlıktan oluşan temel bir veri modeliyle çalışmıştır.Bu öğreticide: 

• Daha fazla varlık ve ilişki eklenmiştir. 

• Veri modeli biçimlendirme, doğrulama ve veritabanı eşleme kuralları belirtilerek özelleştirilir. 
Tamamlanan veri modeli aşağıdaki çizimde gösterilmiştir: 
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Öğrenci varlık 
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Modeller/öğrenci, cs dosyasındaki kodu aşağıdaki kodla değiştirin: 

using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUnivensity.Models 

{ 

public class Student 

{ 

public int ID { get; set; } 

[Required] 

[StringLength(50)] 

[Display(Name = "Last Name")] 
public string LastName { get; set; } 

[Required] 

[StringLength(50, ErrorMessage = "First name cannot be longer than 50 characters.")] 
[Column("FirstName")] 

[Display(Name = "First Name")] 

public string FirstMidName { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 

[Display(Name = "Enrollment Date")] 

public DateTime EnrolImentDate { get; set; } 

[Display(Name = "Full Name")] 
public string FullName 
{ 

get 

{ 

return LastName + ", " + FirstMidName; 

} 

} 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 

Yukarıdaki kod, bir FullName özelliği ekler ve var olan özelliklere aşağıdaki öznitelikleri ekler: 


• [DataType] 

• [DisplayFormat] 

• [StringLength] 

• [Column] 

• [Required] 

• [Display] 


FullName hesaplanmış özelliği 

FullName , diğer iki özelliği birleştirerek oluşturulmuş bir değer döndüren hesaplanmış bir özelliktir. FullName 












ayarlanamaz, bu nedenle yalnızca bir get erişimcisi vardır. Veritabanında FuliName sütunu oluşturulmaz. 

DataType özniteiiği 

[DataType(DataType.Date)] 

Öğrenci kayıt tarihleri için, tüm sayfalar şu anda tarihle birlikte tarih ile görüntülenir, ancak yalnızca tarihin ilgili 
olması gerekir. Veri ek açıklaması özniteliklerini kullanarak, verileri gösteren her sayfada görüntü biçimini 
giderecek bir kod değişikliği yapabilirsiniz. 

DataType özniteiiği, veritabanı iç türünden daha belirgin bir veri türünü belirtir. Bu durumda, tarih ve saat değil 
yalnızca tarih görüntülenmelidir. Veri türü numaralandırması, tarih, saat, PhoneNumber, para birimi, emaadresi 
vb. gibi birçok veri türü sağlar. DataType özniteiiği Ayrıca uygulamanın türe özgü özellikleri otomatik olarak 
sağlamasını da sağlayabilir. Örneğin: 

• mailto: bağlantısı DataType.EmailAddress için otomatik olarak oluşturulur. 

• Tarih Seçici çoğu tarayıcıda DataType.Date için sağlanır. 

DataType özniteiiği HTM L 5 data- (bir veri Dash) öznitelikleri yayar. DataType öznitelikleri doğrulama 
sağlamaz. 

DisplayFormat özniteiiği 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 

DataType.Date görüntülenen tarihin biçimini belirtmiyor. Varsayılan olarak, Tarih alanı sunucunun 
Culturelnfoöğesine göre varsayılan biçimlere göre görüntülenir. 

DisplayFormat özniteiiği, açıkça tarih biçimini belirtmek için kullanılır. ApplyFormatlnEditMode ayarı, 
biçimlendirmenin düzenleme kullanıcı arabirimine de uygulanacağını belirtir. Bazı alanlar 
ApplyFormatlnEditMode kullanmamalıdır. Örneğin, para birimi simgesi genellikle bir düzenleme metin kutusunda 
gösterilmemelidir. 

DisplayFormat özniteiiği kendisi tarafından kullanılabilir. DataType özniteliğini DisplayFormat özniteliğiyle 
kullanmak genellikle iyi bir fikirdir. DataType özniteiiği, verilerin semantiğini bir ekranda nasıl işleneceğini 
tersine alır. DataType özniteiiği, DisplayFormat kullanılamayan aşağıdaki avantajları sağlar: 

• Tarayıcı HTML5 özelliklerini etkinleştirebilir.Örneğin, bir Takvim denetimini, yerel ayara uygun para birimi 
sembolünü, e-posta bağlantılarını ve istemci tarafı giriş doğrulamasını gösterin. 

• Varsayılan olarak tarayıcı, verileri yerel ayara göre doğru biçimi kullanarak işler. 

Daha fazla bilgi için bkz. giriş > etiketi Yardımcısı belgeleri< . 

StringLength özniteiiği 

[StringLength(50, ErrorMessage = "First name cannot be longer than 50 characters.")] 

Veri doğrulama kuralları ve doğrulama hatası iletileri özniteliklerle belirtilebilir. StringLength özniteiiği, bir veri 
alanında izin verilen en düşük ve en fazla karakter uzunluğunu belirtir. Gösterilen kod, adları 50 karakterden 
fazla olmayacak şekilde sınırlar. En küçük dize uzunluğunu ayarlayan bir örnek daha sonragösterilmiştir. 

StringLength özniteiiği de istemci tarafı ve sunucu tarafı doğrulaması sağlar. En küçük değerin veritabanı 
şeması üzerinde hiçbir etkisi yoktur. 

StringLength özniteiiği, kullanıcının bir ad için boşluk girmesini engellemez. Cevap içerisinde 
RegularExpression özniteiiği, girişe kısıtlamalar uygulamak için kullanılabilir. Örneğin, aşağıdaki kod ilk 
















karakterin büyük küçük harf olmasını ve geri kalan karakterlerin alfabetik olmasını gerektirir: 


[RegularExpression(@" A [A-Z]+[a-zA-Z""'\s- ]*$")] 


• Visual Studio 

• Visual Studio Code 

SQL Server Nesne Gezgini (ssox) içinde öğrenci tablosuna çift tıklayarak öğrenci tablosu tasarımcısını açın. 



Önceki görüntüde student tablo şeması gösterilmektedir. Ad alanlarında tür nvarchar(MAX) vardır. Bu 
öğreticide daha sonra bir geçiş oluşturulup uygulandığında, ad alanları dize uzunluğu özniteliklerinin bir 
sonucu olarak nvarchar(50) olur. 

Column özniteliği 

[Column("FirstName")] 

public string FirstMidName { get; set; } 

Öznitelikler sınıfların ve özelliklerin veritabanına nasıl eşlenildiğini denetleyebilir, student modelinde, column 
özniteliği, FirstMidName özelliğinin adını veritabanında "FirstName" olarak eşlemek için kullanılır. 

Veritabanı oluşturulduğunda, model üzerindeki özellik adları sütun adları için kullanılır ( column özniteliği 
kullanıldığı durumlar dışında), student modeli ilk ad alanı için FirstMidName kullanır, çünkü alan de bir orta ad 
içerebilir. 

[Column] Özn itel İğiyle, veri modelindeki Student. FirstMidName Student tablonun FirstName sütunuyla eşlenir, 
column özn itel iği n i n eklenmesi modeli schooicontext yedekleyen şekilde değiştirir. schooicontext yedekleyen 
model artık veritabanıyla eşleşmez. Bu tutarsızlık, daha sonra bu öğreticide bir geçiş eklenerek çözümlenir. 

Gerekli öznitelik 

[Required] 

Required özniteliği, ad özellikleri gereken alanları sağlar. Değer türleri gibi null yapılamayan türler için 
Required özniteliği gerekmez (örneğin, DateHme , int ve double ). Null olmayan türler otomatik olarak 
gerekli alanlar olarak değerlendirilir. 

























MinimumLength zorlanmak için Required özniteliği MinimumLength ile birlikte kullanılmalıdır. 

[Display(Name = "Last Name")] 

[Required] 

[StringLength(50, MinimumLength=2)] 
public string LastName { get; set; } 

MinimumLength ve Required , doğrulamanın doğrulanmasını yerine getirmek için boşluk kullanılmasına izin 
verir. Dize üzerinde tam denetim için ReguiarExpression özniteliğini kullanın. 

Display özniteliği 

[Display(Name = "Last Name")] 

Display özniteliği, metin kutularının açıklamalı alt yazısının "ad", "soyadı", "tam ad" ve "kayıt tarihi" olması 
gerektiğini belirtir. Varsayılan açıklamalı alt yazıların sözcükleri bölen bir boşluk yoktu, örneğin "LastName". 

Geçiş oluşturma 

Uygulamayı çalıştırın ve öğrenciler sayfasına gidin. Bir özel durum oluşturulur. [Column] özniteliği, EF 'in 
FirstName adlı bir sütun bulmasını beklemesine neden olur, ancak veritabanındaki sütun adı hala FirstMidName . 

• Visual Studio 

• Visual Studio Code 

Hata iletisi aşağıdaki örneğe benzer: 

SqlException: Invalid column name 'FirstName'. 


• PMC 'de yeni bir geçiş oluşturmak ve veritabanını güncelleştirmek için aşağıdaki komutları girin: 

Add-Migration ColumnFirstName 
Update-Database 


Bu komutlardan ilki aşağıdaki uyarı iletisini oluşturur: 


An operation was scaffolded that may result in the loss of data. 
Please review the migration for accuracy. 


Ad alanları artık 50 karakterle sınırlı olduğundan uyarı oluşturulur. Veritabanındaki bir ad 50 
karakterden fazlasına sahipse, son karakter 51 ' i kaybedersiniz. 

• Öğrenci tablosunu SSOX içinde açın: 









ContosoUniversity 

□ 


□ X 


Update Script File: 

dbo.Students.sql 

—— 


Name 

Data Type 

Allow Nulls 

a Keys (1) 


İD 

EnrollmentDate 

int 

datetime2(7) 

□ 

□ 

PK_Students (Primary Key, CIl 

Check Constraints (0) 
lndexes (0) 

Foreign Keys (0) 


FirstName 

nvarchar(50) 

0 


LastName 

nvarchar(50) 

0 

Triggers (0) 


CJ Design^ ti g j-SQL [_ 

1 CREATE TABLE [dbo].[Students] ( 


[ID] INT IDENTITY (1, 1) NOT NULL, 

[EnrollmentDate] DATETIME2 (7) NOT NULL, 

[FirstName] NVARCHAR (50) NULL, 

[LastName] NVARCHAR (50) NULL, 

CONSTRAINT [PK_Students] PRIMARY KEY CLUSTERED ([ID] ASC) 


); 


100 % 


Geçiş uygulanmadan önce ad sütunları nvarchar (max)türünde idi. Ad sütunları artık nvarchar(5e) . 
Sütun adı, FirstMidName FirstName olarak değiştirildi. 

• Uygulamayı çalıştırın ve öğrenciler sayfasına gidin. 

• Saatin giriş veya tarih ile birlikte görüntülenmediğine dikkat edin. 

• Yeni oluştur' u seçin ve 50 karakterden daha uzun bir ad girmeyi deneyin. 


NOTE 

Aşağıdaki bölümlerde, uygulamanın bazı aşamalardan oluşturulması derleyici hataları oluşturur. Yönergeler uygulamanın 
ne zaman derbir olduğunu belirtir. 


Eğitmen varlığı 


Instructor 


Properties 
VÎ İD 

A* LastName 
A* FirstMidName 
A HireDate 
Navigation Properties 
CourseAssiqnments 
OfficeAssignmerıt 


Aşağıdaki kodla modeiier/eğitmen. cs oluşturun: 



















using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace Contosollniversity .Models 

{ 

public class Instructor 

{ 

public int ID { get; set; } 

[Required] 

[Display(Name = "Last Name")] 

[StringLength(50)] 

public string LastName { get; set; } 

[Required] 

[Column("FirstName")] 

[Display(Name = "First Name")] 

[StringLength(50)] 

public string FirstMidName { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 

[Display(Name = "Hire Date")] 
public DateTime HireDate { get; set; } 

[Display(Name = "Full Name")] 
public string FullName 
{ 

get { return LastName + ", " + FirstMidName; } 

} 

public ICollection<CourseAssignment> CourseAssignments { get; set; } 
public OfficeAssignment OfficeAssignment { get; set; } 

} 

} 

Birden çok öznitelik tek bir satırda olabilir. HireDate öznitelikleri aşağıdaki gibi yazılabilir: 

[DataType(DataType.Date),Display(Name = "Hire Date"),DisplayFormat(DataFormatString = "{0:yyyy-MM-dd }", 
ApplyFormatlnEditMode = true)] 


Gezinti özellikleri 

CourseAssignments ve OfficeAssignment özellikleri gezinti özellikleridir. 

Bir eğitmen herhangi bir sayıda kurs öğretebilir, bu nedenle CourseAssignments bir koleksiyon olarak tanımlanır. 


public ICollection<CourseAssignment> CourseAssignments { get; set; } 

Bir eğitmenin en fazla bir ofisi olabilir, bu nedenle OfficeAssignment 
içerir. Office atanmamışsa OfficeAssignment null olur. 

özelliği tek bir 

OfficeAssignment 

varlık 

public OfficeAssignment OfficeAssignment { get 

; set; } 





OfficeAssignment varlığı 













OfficeAssıgn... 



using System.ComponentModel.DataAnnotations; 
using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 
{ 

public class OfficeAssignment 
{ 

[Key] 

public int InstructonlD { get; set; } 
[StringLength(50)] 

[Display(Name = "Office Location")] 
public string Location { get; set; } 

public Instructor Instnuctor { get; set; } 

} 

} 


Anahtar özniteliği 

Özellik adı Classnameıd veya İD dışında bir şey olduğunda, bir özelliği birincil anahtar (PK) olarak tanımlamak 
için [Key] özniteliği kullanılır. 

Instructor ve OfficeAssignment varlıkları arasında bire sıfır veya arasında bir ilişki vardır. Office ataması, 
atandığı eğitmenle ilişkili olarak yalnızca vardır. OfficeAssignment PK Ayrıca, ınstructor varlığa ait yabancı 
anahtarıdır (FK). 


EF Core, instructoriD İD veya Classnameıd adlandırma kuralını izlemediği için, instructoriD 
OfficeAssignment PK olarak otomatik olarak tanıyamaz. Bu nedenle, Key özniteliği, instructoriD PK olarak 
tanımlamak için kullanılır: 

[Key] 

public int İnstructoriD { get; set; } 

Varsayılan olarak, EF Core, sütun tanımlayıcı bir ilişki için olduğundan, anahtarı veritabanı olmayan bir şekilde 
değerlendirir. 


Eğitmen gezintisi özelliği 

ınstructor.OfficeAssignment gezinti özelliği null olabilir çünkü belirli bir eğitmen için bir OfficeAssignment 
satırı olmayabilir. Bir eğitmenin Office ataması olmayabilir. 


OfficeAssignment.Instructor gezinti özelliği her zaman bir eğitmen varlığına sahip olur çünkü yabancı anahtar 



diğer birine bir başvurusu vardır. 


Kurs varlığı 
























Course 



using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUnivensity.Models 

{ 

public class Counse 

{ 

[DatabaseGenerated(DatabaseGeneratedOption.None)] 

[Display(Name = "Number")] 
public int CounselD { get; set; } 

[StringLength(50, MinimumLength = 3)] 
public string Title { get; set; } 

[Range(0, 5)] 

public int Credits { get; set; } 

public int DepartmentlD { get; set; } 

public Department Department { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

public ICollection<CourseAssignment> CourseAssignments { get; set; } 

} 

} 


varlığın bir yabancı anahtar (FK) özelliği 

DepartmentlD vardır. 

DepartmentlD 

ilgili 

Department 


işaret eder, course varlığın bir Department gezinti özelliği vardır. 


EF Core, modelin ilgili bir varlık için gezinti özelliği olduğunda bir veri modeli için yabancı anahtar özelliği 
gerektirmez. EF Core, gerektiği yerde otomatik olarak veritabanında FKs 'ler oluşturur.EF Core otomatik olarak 
oluşturulan FKs 1er için gölge Özellikler oluşturur. Ancak, doğrudan veri modelinde FK dahil edilmesi, 
güncelleştirmelerin daha basit ve daha verimli olmasını sağlayabilir. Örneğin, FK özelliğinin DepartmentlD dahil 
olmadığı bir model düşünün. Bir kurs varlığı düzenlemek üzere getirilirken: 

• Department özelliği açıkça yüklenmediyse null olur. 

• Kurs varlığını güncelleştirmek için öncelikle Department varlığın getirilmesi gerekir. 

FK özelliği DepartmentlD veri modeline dahil edildiğinde, güncelleştirmeden önce Department varlığını 
getirmeye gerek yoktur. 


DatabaseGenerated özniteliği 

[DatabaseGenerated(DatabaseGeneratedOption.None) ] Özniteliği, PK 'nin veritabam tarafından oluşturulması 
yerine uygulama tarafından sağlandığını belirtir. 



















[DatabaseGenerated(DatabaseGeneratedOption.None)] 
[Display(Name = "Number")] 
public int CourselD { get; set; } 


Varsayılan olarak, EF Core PK değerlerinin veritabanı tarafından oluşturulduğunu varsayar. Veritabanı 
tarafından oluşturulan genellikle en iyi yaklaşım vardır, course varlıklar için Kullanıcı PK 'yi belirtir. Örneğin, 
matematik departmanı için 1000 serisi, İngilizce departmanı için 2000 serisi gibi bir kurs numarası. 

DatabaseGenerated özniteliği varsayılan değerler oluşturmak için de kullanılabilir. Örneğin, veritabanı bir satırın 
oluşturulduğu veya güncelleştirildiği tarihi kaydetmek için otomatik olarak bir tarih alanı oluşturabilir. Daha 
fazla bilgi için bkz. üretilen Özellikler. 

Yabancı anahtar ve gezinti özellikleri 

course varlığındaki yabancı anahtar (FK) özellikleri ve gezinti özellikleri aşağıdaki ilişkileri yansıtır: 

Bir kurs bir departmana atanır, bu nedenle bir DepartmentiD FKve Department gezinti özelliği vardır. 

public int DepartmentiD { get; set; } 
public Department Department { get; set; } 

Bir kurs, kayıtlı sayıda öğrenciye sahip olabilir, bu nedenle Enroiiments gezinti özelliği bir koleksiyondur: 

public ICollection<Enrollment> Enrollments { get; set; } 

Bir kurs birden fazla eğitmen tarafından tada olabilir, bu nedenle courseAssignments gezinti özelliği bir 
koleksiyondur: 

public ICollection<CourseAssignment> CourseAssignments { get; set; } 

courseAssignment daha sonraaçıklanmaktadır. 

Departman varlığı 


Department 


Properties 
vî DepartmentiD 
A Name 
A Budget 
A StartDate 
A InstructorlD 
Navigation Properties 
Administrator 
Courses 


Aşağıdaki kodla modeller/departman, cs oluşturun: 
















using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Department 

{ 

public int DepartmentlD { get; set; } 

[Stringl_ength(50, MinimumLength = 3)] 
public string Name { get; set; } 

[DataType(DataType.Currency)] 

[Column(TypeName = "money")] 
public decimal Budget { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}"j ApplyFormatlnEditMode = true)] 

[Display(Name = "Start Date")] 

public DateTime StartDate { get; set; } 

public int? InstructorlD { get; set; } 

public Instructor Administrator { get; set; } 
public ICollection<Course> Courses { get; set; } 

} 

} 


Column özniteliği 

Daha önce column özniteliği sütun adı eşlemesini değiştirmek için kullanılmıştır. Department varlığın kodunda, 
SQL veri türü eşlemesini değiştirmek için column özniteliği kullanılır. Budget sütunu, veritabanında SQL 
Server para türü kullanılarak tanımlanır: 

[Column(TypeName="money") ] 
public decimal Budget { get; set; } 

Sütun eşlemesi genellikle gerekli değildir. EF Core, özelliğin CLR türüne göre uygun SQL Server veri türünü 
seçer. CLR decimal türü bir SQL Server decimal türüne eşlenir. Budget para birimi için ve para veri türü para 
birimi için daha uygundur. 

Yabancı anahtar ve gezinti özellikleri 

FK ve gezinti özellikleri aşağıdaki ilişkileri yansıtır: 

• Bir departman yönetici olabilir veya olmayabilir. 

• Yönetici her zaman bir eğitmendir. Bu nedenle InstructorlD özelliği, ınstructor varlığa FK olarak eklenir. 
Gezinti özelliği Administrator olarak adlandırılır ancak bir ınstructor varlığı tutar: 

public int? InstructorlD { get; set; } 
public Instructor Administrator { get; set; } 

Önceki koddaki soru işareti (?) özelliği null yapılabilir olduğunu belirtiyor. 

Bir departmanın birçok kursu olabilir, bu nedenle bir kurs gezintisi özelliği vardır: 
















public ICollection<Course> Courses { get; set; } 


Kural gereği EF Core, null yapılamayan ve çok-çok ilişkiler için basamaklı silme imkanı sağlar.Bu varsayılan 
davranış, dairesel basamaklı silme kurallarına neden olabilir. Bir geçiş eklendiğinde dairesel basamaklı silme 
kuralları bir özel duruma neden olur. 

Örneğin, Department.instructoriD özelliği null yapılamayan olarak tanımlanmışsa EF Core bir basamaklı silme 
kuralı yapılandırır. Bu durumda, yönetici olarak atanan eğitmen silindiğinde departman silinir. Bu senaryoda 
kısıtlama kuralı daha anlamlı hale getirir. Aşağıdaki Fluent API bir kısıtlama kuralı ayarlar ve art arda silmeyi 
devre dışı bırakır. 

modelBuilder.Entity<Department>() 

.HasOne(d => d.Administrator) 

.WithMany() 

.OnDelete(DeleteBehavior.Restrict) 


Kayıt varlık 

Kayıt kaydı, tek bir öğrenci tarafından gerçekleştirilen bir kurs içindir. 


Enrollment 



using System.ComponentModel.DataAnnotations; 
using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUnivensity.Models 
{ 

public enum Grade 
{ 

A, B, C, D, F 

} 

public class Enrollment 
{ 

public int EnrollmentlD { get; set; } 
public int CourselD { get; set; } 
public int StudentlD { get; set; } 
[DisplayFormat(NullDisplayText = "No grade")] 
public Grade? Grade { get; set; } 

public Course Course { get; set; } 
public Student Student { get; set; } 

} 

} 


Yabancı anahtar ve gezinti özellikleri 

FK özellikleri ve gezinti özellikleri aşağıdaki ilişkileri yansıtır: 












Kayıt kaydı tek bir kursa yöneliktir, bu nedenle bir courseiD FK özelliği ve course gezinti özelliği vardır: 


public int CourseiD { get; set; } 
public Course Course { get; set; } 


Kayıt kaydı bir öğrenci içindir, bu nedenle bir studentiD FK özelliği ve student gezinti özelliği vardır: 

public int StudentiD { get; set; } 
public Student Student { get; set; } 


Çoktan çoğa İlişkiler 

student ve Course varlıkları arasında çok-çok ilişkisi vardır. Enroiiment varlık, veritabanında Yük ile çoktan 
çoğa bir JOIN tablosu olarak çalışır. "Yükle", Enroiiment tablosunun birleştirilmiş tablolar (Bu durumda, PK ve 
Grade ) gibi ek verileri içerdiği anlamına gelir. 

Aşağıdaki çizimde bu ilişkilerin bir varlık diyagramında nasıl göründüğünü gösterilmektedir.(Bu diyagram EF 6. 
x için EF güç araçları kullanılarak oluşturulmuştur. Diyagram oluşturmak öğreticinin bir parçası değildir.) 


Student 


Properties 
yî İD 

/* LastName 
A FirstMidName 
A EnrolImentDate 
Navigation Properties 
Enrollments 



Enrollment ^ 


Course 

Properties 

Properties 

Y? EnrolImentlD 

A CourseiD 

A StudentiD 

A Grade 

/V_ ■ A 

ıfl CourseiD 

A Title 

A Credits 

A DepartmentlD 

1 1 - 

* 1 

Navigation Properties 

Navigation Properties 

ySl Course 
ySİ Student 


Department 

Y^ Enrollments 
ySl CourseAssignments 



Her ilişki ucu ve bir yıldız işareti (*) 1 diğer sırasında bir-çok ilişkisi belirten bulunur. 

Ennoliment tablo, sınıf bilgilerini içermiyorsa, yalnızca iki FKs ( CourseiD ve studentiD ) içermesi gerekir.Yük 
olmadan çoktan çoğa bir JOIN tablosu bazen saf JOIN tablosu (PJT) olarak adlandırılır. 

instructor ve Course varlıkların, saf bir JOIN tablosu kullanılarak çoktan çoğa bir ilişkisi vardır. 

Note: EF 6. x, çoktan çoğa ilişkiler için örtük birleştirmeyi destekler, ancak EF Core değildir.Daha fazla bilgi için 

EF Core 2,0 1 de çoktan çoğa ilişkilerbölümüne bakın. 


Courseatama varlığı 
































Co u rse Assig n men t 



{ 

public class CourseAssignment 
{ 

public int InstructorlD { get; set; } 
public int CounselD { get; set; } 
public Instructor Instnuctor { get; set; } 
public Course Course { get; set; } 

} 


Eğitmenden çok-çok ilişkisi için bir JOIN tablosu gerekir ve bu ekleme tablosu için varlık kurs atamasıdır. 


Instructor 


Properties 
yî İD 

A* LastName 
A* FirstMidName 
A HireDate 
Navigation Properties 
İp] CourseAssiqnments 
y3 OfficeAssignment 

VI 


CourseAssignment 


Properties 
A* CourselD 
A" InstructorlD 


Course 
y3 Instructor 



Course 

>-0 

Properties 

s V 

* 1 

yî CourselD 

Title 

A' Credits 

A* DepartmentlD 


Navigation Properties 

Department 
Enrollments 
y3 CourseAssignments 


EntityNameiEntityName 2 bir JOIN varlığı adı yaygın olarak vardır.Örneğin, bu model kullanılarak eğitmen- 
kurslar JOIN tablosu Courseinstructor . Ancak, ilişkiyi açıklayan bir ad kullanmanızı öneririz. 

Veri modelleri basit ve büyümeye başlar. Yük (PJTs) olmayan ekleme tabloları genellikle yükü içerecek şekilde 
gelişmektedir. Açıklayıcı bir varlık adıyla başlayarak, ekleme tablosu değiştiğinde adın değiştirilmesi gerekmez, 
ideal olarak, JOIN varlığının iş etki alanında kendi doğal (muhtemelen tek bir kelime) adına sahip olması 
gerekir. Örneğin, kitaplar ve müşteriler, derecelendirmeler adlı bir JOIN varlığıyla bağlantı kurulabilir.Eğitmenin 
kursa çok-çok ilişkisi için Courseinstructor" CourseAssignment tercih edilir. 



























Bileşik anahtar 



bileşik bir PK olarak çalışır. EF Core bileşik PKs 'leri belirtmenin tek yolu FluentAPI' dir. Sonraki bölümde, 
bileşik PK 'nin nasıl yapılandırılacağı gösterilmektedir. 

Bileşik anahtar şunları sağlar: 

• Tek bir kurs için birden çok satıra izin verilir. 

• Birden çok satıra bir eğitmen için izin verilir. 

• Aynı eğitmen ve kurs için birden çok satıra izin verilmez. 

Enroiiment JOIN varlığı kendi PK 'yi tanımlar, bu nedenle bu sıralamanın yinelemeleri mümkündür.Bu tür 
yinelemeleri engellemek için: 

• FK alanlara benzersiz bir dizin ekleyin veya 

• courseAssignment benzer bir birincil bileşik anahtarla Enroiiment yapılandırın. Daha fazla bilgi için bkz. 

dizinler. 


Veritabanı bağlamını güncelleştirme 


Data/SchoolContext. cs öğesini şu kodla güncelleştirin: 


using ContosolIniversity.Models; 
using Microsoft.EntityFrameworkCore; 


namespace ContosoUniversity.Data 

{ 

public class SchoolContext : DbContext 

{ 

public SchoolContext(DbContextOptions<SchoolContext> options) : base(options) 

{ 

} 

public DbSet<Course> Courses { get; set; } 

public DbSet<Enrollment> Enrollments { get; set; } 

public DbSet<Student> Students { get; set; } 

public DbSet<Department> Departments { get; set; } 

public DbSet<Instructor> Instructors { get; set; } 

public DbSet<OfficeAssignment> OfficeAssignments { get; set; } 

public DbSet<CourseAssignment> CourseAssignments { get; set; } 

protected override void OnModelCreating(ModelBuilder modelBuilder) 

{ 

modelBuilder.Entity<Course>().ToTable("Course"); 
modelBuilder.Entity<Enrollment>().ToTable("Enrollment"); 
modelBuilder.Entity<Student>().ToTable("Student"); 
modelBuilder.Entity<Department>().ToTable("Department"); 
modelBuilder.Entity<Instructor>().ToTable("Instructor"); 
modelBuilder.Entity<OfficeAssignment>() .ToTable("OfficeAssignment"); 
modelBuilder.Entity<CourseAssignment>().ToTable("CourseAssignment"); 


} 


} 


} 


modelBuilder.Entity<CourseAssignment>() 

.HasKey(c => new { c.CourselD, c.InstructorlD }); 


Yukarıdaki kod, yeni varlıkları ekler ve CourseAssignment varlığın bileşik PK öğesini yapılandırır. 













Tutarlı API 'nin özniteliklere alternatif 


Önceki koddaki onModeicreating yöntemi EF Core davranışını yapılandırmak için FluerıtAPI kullanır. Genellikle 
tek bir bildirimde bir dizi yöntem çağrısı olan dize olarak kullanıldığından, API "akıcı" olarak adlandırılır. 
Aşağıdaki kod FluentAPI bir örneğidir: 

protected override void OnModelCreating(ModelBuilder modelBuilder) 

{ 

modelBuilder.Entity<Blog>() 

.Property(b => b.Url) 

.IsRequired(); 

} 

Bu öğreticide, FluentAPI yalnızca özniteliklerle yapılamadığını veritabanı eşlemesi için kullanılır. Ancak Fluent 
API, özniteliklerle yapılabilecek biçimlendirme, doğrulama ve eşleme kurallarının çoğunu belirtebilir. 

MinimumLength gibi bazı öznitelikler FluentAPI uygulanamaz. MinimumLength şemayı değiştirmez, yalnızca bir 
minimum uzunluk doğrulama kuralı uygular. 

Bazı geliştiriciler, varlık sınıflarının "temiz" olmasını sağlamak için Fluent API özel olarak kullanmayı tercih eder. 
Öznitelikler ve Fluent API karışık olabilir.Yalnızca Fluent API (bileşik bir PK belirterek) yapılabilecek bazı 
konfigürasyonlar vardır. Yalnızca özniteliklerle ( MinimumLength ) yapılabilecek bazı konfigürasyonlar vardır. 
FluentAPI veya özniteliklerini kullanmak için önerilen uygulama: 

• Bu iki yaklaşımdan birini seçin. 

• Seçilen yaklaşımı mümkün olduğunca düzenli olarak kullanın. 

Bu öğreticide kullanılan özniteliklerin bazıları için kullanılır: 

• Yalnızca doğrulama (örneğin, MinimumLength ). 

• Yalnızca yapılandırma EF Core (örneğin, HasKey ). 

• Doğrulama ve EF Core yapılandırma (örneğin, [stringLength(se)] ). 

Öznitelikler ile Fluent API hakkında daha fazla bilgi için bkz. yapılandırma yöntemleri. 

Varlık diyagramı 

Aşağıdaki çizimde, tamamlanmış okul modeli için EF Power Tools 'un oluştura diyagramı gösterilmektedir. 









OfficeAssignment 


Properties 
yi InstructorlD 
A Location 
Navigation Properties 
y3 Instructor 
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Student 


Instructor 


Department 

Properties 
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Properties 
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yî İD 


yi DepartmentlD 

A LastName 


A LastName 


A Name 
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A FirstMidName 

0 - 0 
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A Budget 

A EnrolImentDate 


A HireDate 


A StartDate 

Navigation Properties 


Navigation Properties 


A InstructorlD 

y3 Enrollments 


y3 CourseAssiqnments 


Navigation Properties 



y3 OfficeAssignment 
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Courses 


Course Assignment 




Enrollment 


Properties 
yi EnrolImentlD 
A CourselD 
A StudentlD 
A Grade 
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A CourselD 
A InstructorlD 
Navigation Properties 
y3 Course 
y3 Instructor 
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Properties 
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yi CourselD 


A Title 


A Credits 


A DepartmentlD 
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Navigation Properties 


& Department 


Enrollments 


y3 CourseAssignments 


Önceki diyagramda şunları gösterir: 
• Birkaç bire çok ilişki satırı (*1). 


• 

Instructor 

ve 

OfficeAssignment 

varlıkları arasında bire sıfır veya-bir ilişki çizgisi (1 ila 0.. 1), 

• 

Instructor 

ve 

Department 

varlıkları arasında sıfır veya-bire çok ilişki çizgisi (0.. 1 -*). 


Veritabanının çekirdeğini oluşturma 

Data/Dbmizer. csdosyasındaki kodu güncelleştirin: 


using System; 
using System.Linq; 

using Microsoft.EntityFrameworkCore; 

using Microsoft. Extensions .Dependencylnjection; 

using ContosolIniversity.Models; 

namespace ContosoUniversity.Data 

{ 

public static class Dblnitializer 

{ 

public static void Initialize(SchoolContext context) 

{ 

//context.Database.EnsureCreated(); 










































// Look for any students. 
if (context.Students.Any()) 

{ 

netunn; // DB has been seeded 

} 


van students = new Student[] 

{ 

new Student { FinstMidName = "Canson", LastName 
EnnollmentDate = DateTime.Parse("2016-09-01") 
new Student { FinstMidName = "Menedith", LastName 
EnnollmentDate = DateTime.Panse("2018-09-01") 
new Student { FinstMidName = "Antuno", LastName 
EnnollmentDate = DateTime.Panse("2019-09-01") 
new Student { FinstMidName = "Gytis", LastName 
EnnollmentDate = DateTime.Panse("2018-09-01") 
new Student { FinstMidName = "Yan", LastName 

EnnollmentDate = DateTime.Panse("2018-09-01") 
new Student { FinstMidName = "Peggy", LastName 
EnnollmentDate = DateTime.Panse("2017-09-01") 
new Student { FinstMidName = "Launa", LastName 
EnnollmentDate = DateTime.Panse("2019-09-01") 
new Student { FinstMidName = "Nino", LastName 
EnnollmentDate = DateTime.Panse("2011-09-01") 

}; 

foneach (Student s in students) 

{ 

context.Students.Add(s); 

} 

context.SaveChanges(); 


= "Alexanden", 

L 

= "Alonso", 

L 

= "Anand", 

L 

= "Banzdukas", 

L 

= "Lİ", 

L 

= "lustice", 

L 

= "Nonman", 

= "Olivetto", 

} 


van instnuctons = new Instnucton[] 

{ 

new Instnucton { FinstMidName = "Kim", LastName = "Abencnombie", 
HineDate = DateTime.Panse("1995-03-ll") }, 
new Instnucton { FinstMidName = "Fadi", LastName = "Fakhouni", 
HineDate = DateTime.Panse("2002-07-06") }, 
new Instnucton { FinstMidName = "Rogen", LastName = "Hanui", 
HineDate = DateTime.Panse("1998-07-01") }, 
new Instnucton { FinstMidName = "Candace", LastName = "Kapoon", 
HineDate = DateTime.Panse("2001-01-15") }, 
new Instnucton { FinstMidName = "Rogen", LastName = "Zheng", 
HineDate = DateTime.Panse("2004-02-12") } 


}; 


foneach (Instnucton i in instnuctons) 

{ 

context.Instnuctons.Add(i); 

} 

context.SaveChanges(); 


van depantments = new Depantment[] 

{ 

new Depantment { Name = "English", Budget = 350000, 
StantDate = DateTime.Panse("2007-09-01"), 
InstnuctonlD = instnuctons.Single( i => i.LastName 
new Depantment { Name = "Mathematics", Budget = 100000, 
StantDate = DateTime.Panse("2007-09-01"), 
InstnuctonlD = instnuctons.Single( i => i.LastName 
new Depantment { Name = "Engineening", Budget = 350000, 
StantDate = DateTime.Panse("2007-09-01"), 
InstnuctonlD = instnuctons.Single( i => i.LastName 
new Depantment { Name = "Economics", Budget = 100000, 
StantDate = DateTime.Panse("2007-09-01"), 
InstnuctonlD = instnuctons.Single( i => i.LastName 

}; 


"Abencnombie").ID }, 


"Fakhouni").ID }, 


"Hanui").ID }, 


"Kapoon").ID } 


foneach (Depantment d in depantments) 


{ 

context.Depa rtments.Add(d); 

} 

context.SaveChanges(); 

var courses = new Course[] 

{ 

new Course {CourselD = 1050., Title = "Chemistry", Credlts = 3, 

DepartmentlD = departments.Single( s => s.Name == "Engineering").DepartmentlD 

}, 

new Course {CourselD = 4022, Title = "Microeconomics", Credits = 3, 

DepartmentlD = departments.Single( s => s.Name == "Economics").DepartmentlD 

}, 

new Course {CourselD = 4041, Title = "Macroeconomics", Credits = 3, 

DepartmentlD = departments.Single( s => s.Name == "Economics").DepartmentlD 

}, 

new Course {CourselD = 1045, Title = "Calculus", Credits = 4, 

DepartmentlD = departments.Single( s => s.Name == "Mathematics").DepartmentlD 

}, 

new Course {CourselD = 3141, Title = "Trigonometry", Credits = 4, 

DepartmentlD = departments.Single( s => s.Name == "Mathematics").DepartmentlD 

}, 

new Course {CourselD = 2021, Title = "Composition", Credits = 3, 

DepartmentlD = departments.Single( s => s.Name == "English").DepartmentlD 

L 

new Course {CourselD = 2042, Title = "Literatüre", Credits = 4, 

DepartmentlD = departments.Single( s => s.Name == "English").DepartmentlD 

L 

}; 

foreach (Course c in courses) 

{ 

context.Courses.Add(c); 

} 

context.SaveChanges(); 

var officeAssignments = new OfficeAssignmentf] 

{ 

new OfficeAssignment { 

InstructorlD = instructors.Single( i => i.LastName == "Fakhouri").İD, 

Location = "Smith 17" }, 
new OfficeAssignment { 

InstructorlD = instructors.Single( i => i.LastName == "Harui").ID, 

Location = "Gowan 27" }, 
new OfficeAssignment { 

InstructorlD = instructors.Single( i => i.LastName == "Kapoor").İD, 

Location = "Thompson 304" }, 

}; 

foreach (OfficeAssignment o in officeAssignments) 

{ 

context. OfficeAssignments .Add(o); 

} 

context.SaveChanges (); 


var courselnstructors = new CourseAssignmentf] 

{ 


new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 


== "Chemistry" ).CourselD, 
İ.LastName == "Kapoor").ID 


== "Chemistry" ).CourselD, 
İ.LastName == "Harui").ID 


== "Microeconomics" ).CourselD, 
İ.LastName == "Zheng").ID 


T. 


}; 


new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 

b 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 

b 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 

b 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 

b 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 

b 


== "Macroeconomics" ).CourselD, 
i.LastName == "Zheng").ID 


== "Calculus" ).CourselD, 
İ.LastName == "Fakhouri").ID 


== "Trigonometry" ).CourselD, 
İ.LastName == "Harui").ID 


== "Composition" ).CourselD, 
İ.LastName == "Abercrombie").ID 


== "Literatüre" ).CourselD, 
İ.LastName == "Abercrombie").ID 


foreach (CourseAssignment ci in courselnstructors) 

{ 

context.CourseAssignments.Add(ci); 

} 

context.SaveChanges(); 


var enrollments = new Enrollment[] 

{ 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Alexander").ID, 
CourselD = courses.Single(c => c.Title == "Chemistry" ).CourselD, 

Grade = Grade.A 

b 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Alexander").ID, 
CourselD = courses.Single(c => c.Title == "Microeconomics" ).CourselD, 
Grade = Grade.C 

b 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Alexander").ID, 
CourselD = courses.Single(c => c.Title == "Macroeconomics" ).CourselD, 
Grade = Grade.B 

b 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Alonso").ID, 
CourselD = courses.Single(c => c.Title == "Calculus" ).CourselD, 

Grade = Grade.B 

b 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Alonso").ID, 
CourselD = courses.Single(c => c.Title == "Trigonometry" ).CourselD, 
Grade = Grade.B 

b 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Alonso").ID, 

CourselD = courses.Single(c => c.Title == "Composition" ).CourselD, 
Grade = Grade.B 

b 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Anand").ID, 

CourselD = courses.Single(c => c.Title == "Chemistry" ).CourselD 

b 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Anand").ID, 

CourselD = courses.Single(c => c.Title == "Microeconomics").CourselD, 
Grade = Grade.B 


new Enrollment { 

StudentlD = students.Single(s => s.LastIMame == "Barzdukas").IDj 
CourselD = courses.Single(c => c.Title == "Chemistry").CourselD, 
Grade = Grade.B 
}, 

new Ennollment { 

StudentlD = students.Single(s => s.LastIMame == "Li").ID, 

CourselD = counses.Single(c => c.Title == "Composition").CourselD, 
Grade = Grade.B 
}, 

new Enrollment { 

StudentlD = students.Single(s => s.LastIMame == "Dustice").İD, 
CourselD = courses.Single(c => c.Title == "Literatüre") .CourselD., 
Grade = Grade.B 
} 

}; 


foreach (Enrollment e in enrollments) 

{ 

var enrollmentlnDataBase = context.Enrollments.Where( 
s => 

s.Student.ID == e.StudentlD && 

s.Course.CourselD == e.CourselD).SingleOrDefault(); 
if (enrollmentlnDataBase == null) 

{ 

context.Enrollments.Add(e); 

} 

} 

context.SaveChanges(); 

} 

} 

} 

Yukarıdaki kod, yeni varlıklar için tohum verileri sağlar. Bu kodun çoğu yeni varlık nesneleri oluşturur ve örnek 
verileri yükler. Örnek veriler test için kullanılır.Çoktan çoğa ekleme tablolarının nasıl çalıştırılabilir olduğunu 
gösteren örnekler için Enrollments ve CourseAssignments bakın. 

Geçiş Ekle 

Projeyi oluşturun. 

• Visual Studio 

• Visual Studio Code 

PMC 'de aşağıdaki komutu çalıştırın. 

Add-Migration ComplexDataModel 


Yukarıdaki komut, olası veri kaybı hakkında bir uyarı görüntüler. 

An operation was scaffolded that may result in the loss of data. 

Please review the migration for accuracy. 

To undo this action, use ' ef migrations remove' 

database update komutu çalıştır 1 1dıysanız aşağıdaki hata oluşturulur: 

The ALTER TABLE statement conflicted with the FOREIGN KEY constraint 
"FK_dbo.Course_dbo.Department_DepartmentID". The conflict occurred in 
database "ContosoUniversity ", table "dbo.Department", column 'DepartmentlD'. 





Sonraki bölümde, bu hatayla ilgili ne yapılacağını görürsünüz. 


Geçişi uygulayın veya bırakıp yeniden oluşturun 

Artık var olan bir veritabanınız olduğuna göre, değişikliklere nasıl uygulanacağını düşünmeniz gerekir. Bu 
öğreticide iki alternatif gösterilmektedir: 

• Veritabanını bırakıp yeniden oluşturun. SQLİte kullanıyorsanız bu bölümü seçin. 

• Geçişi mevcut veritabanına uygulayın. Bu bölümdeki yönergeler yalnızca SQL Server için geçerlidir,SQLite 

için değildir. 

Her iki seçenek de SQL Server için geçerlidir.Appiy-Migration yöntemi daha karmaşıktır ve zaman alabilir. Bu, 
gerçek dünyada üretim ortamları için tercih edilen yaklaşımdır. 

Veritabanını bırakıp yeniden oluşturun 

SQL Server kullanıyorsanız ve aşağıdaki bölümde uygulanacak geçiş yaklaşımını yapmak istiyorsanız Bu 

bölümü atlayın . 

Yeni bir veritabanı oluşturmak için EF Core zorlamak için veritabanını bırakıp güncelleştirin: 

• Visual Studio 

• Visual Studio Code 

• Paket Yöneticisi konsolunda (PMC), aşağıdaki komutu çalıştırın: 

Drop-Database 

• Geçişler klasörünü silin, ardından aşağıdaki komutu çalıştırın: 

Add-Migration InitialCreate 
Update-Database 

Uygulamayı çalıştırın. Uygulamayı çalıştırmak Dbinitializer.initialize yöntemini çalıştırır. 
Dbinitiaiizer.initiaüze yeni veritabanını doldurur. 

• Visual Studio 

• Visual Studio Code 

Veritabanını SSOX içinde açın: 

• Daha önce SSOX açıldıysa Yenile düğmesine tıklayın. 

• Genişletin tabloları düğümü. Oluşturulan tablolar görüntülenir. 
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• Courseatama tablosunu inceleyin: 

o Courseatama tablosuna sağ tıklayın ve verileri görüntüle 1 yi seçin, 
o Courseatama tablosunun veri içerdiğini doğrulayın. 



Geçişi Uygula 

Bu bölüm isteğe bağlıdır. Bu adımlar yalnızca SQL Server LocalDB için çalışır ve yalnızca önceki bırakma ve 
veritabanını yeniden oluştur bölümünü atladıktan sonra. 

Geçişler mevcut verilerle çalıştırıldığında, mevcut verilerin karşılanmadığı FK kısıtlamalar olabilir. Üretim 
verileriyle, mevcut verilerin geçirilmesi için adımların alınması gerekir. Bu bölüm, FK kısıtlama ihlallerinin 
düzeltilmesiyle bir örnek sağlar. Bu kod değişikliklerini yedekleme olmadan yapmayın. Önceki bırakmayı 
tamamlayıp veritabanını yeniden oluşturduktan sonra Bu kod değişikliklerini yapmayın. 

{Timestamp}_ComplexDataModel. cs dosyası aşağıdaki kodu içerir: 

migrationBuilder.AddColumn<int>( 
name: "DepartmentlD ", 
table: "Course", 
type: "int", 
nullable: false, 
defaultValue: 0); 


Yukarıdaki kod course tabloya null atanamaz DepartmentlD FK ekler.Önceki öğreticideki veritabanı course 
























satırları içerir, böylece tablo geçişler tarafından güncelleştirilemez. 


compiexDataModei geçişinin mevcut verilerle çalışmasını sağlamak için: 

• Yeni sütuna ( DepartmentiD ) varsayılan değer vermek için kodu değiştirin. 

• Varsayılan departman olarak davranacak "Temp" adlı sahte bir departman oluşturun. 

Yabancı anahtar kısıtlamalarını çözme 

compiexDataModei geçiş sınıfında up yöntemini güncelleştirin: 

• {Timestamp}_ComplexDataModel, cs dosyasını açın. 

• DepartmentiD sütununu Course tablosuna ekleyen kod satırını açıklama satırı yapın. 

migrationBuilder.AlterColumn<string>( 
name: "Title", 
table: "Course", 
maxLength: 50, 
nullable: true, 
oldClrType: typeof(string), 
oldNullable: true); 

//migrationBuilder.AddColumn<int>( 

// name: "DepartmentiD", 

// table: "Course", 

// nullable: false, 

// defaultValue: 0); 

Aşağıdaki vurgulanmış kodu ekleyin. Yeni kod .createTabie( name: "Department" bloğundan sonra geçer: 

migrationBuilder.CreateTable( 
name: "Department", 
columns: table => new 
{ 

DepartmentiD = table.Column<int>(type: "int", nullable: false) 

.Annotation("SqlServer:ValueGenerationStrategy", 

SqlServerValueGenerationStrategy.IdentityColumn), 

Budget = table.Column<decimal>(type: "money", nullable: false), 

InstructorlD = table.Column<int>(type: "int", nullable: true). 

Name = table.Column<string>(type: "nvarchar(50)", maxLength: 50, nullable: true), 

StartDate = table.Column<DateTime>(type: "datetime2", nullable: false) 

}, 

constraints: table => 

{ 

table.PrimaryKey("PK_Department", x => x.DepartmentiD); 
table.ForeignKey( 

name: "FK_Department_Instructor_InstructorID", 
column: x => x.InstructorlD, 
principalTable: "Instructor", 
principalColumn: "ID", 
onDelete: ReferentialAction.Restrict); 

}); 

migrationBuilder.Sql("INSERT INTO dbo.Department (Name, Budget, StartDate) VALUES ('Temp', 0.00, 
GETDATE())"); 

// Default value for FK points to department created above, with 
// defaultValue changed to 1 in following AddColumn statement. 

migrationBuilder.AddColumn<int>( 
name: "DepartmentiD", 
table: "Course", 
nullable: false, 
defaultValue: 1); 








Önceki değişikliklerle, compiexDataModei.up yöntemi çalıştıktan sonra mevcut course satırları "Temp" 
departmanı ile ilişkilendirilir. 

Burada gösterilen durumu işlemenin yolu, bu öğretici için basitleştirilmiştir. Bir üretim uygulaması şöyle 
olacaktır: 

• Yeni Department satırlarına Department satırları ve ilgili course satırlarını eklemek için kod veya komut 
dosyaları ekleyin. 

• "Geçici" Departmanı veya course.DepartmentiD için varsayılan değeri kullanmayın. 

• Visual Studio 

• Visual Studio Code 

• Paket Yöneticisi konsolunda (PMC), aşağıdaki komutu çalıştırın: 

Update-Database 

Dbinitiaüzer.initiaüze yöntemi yalnızca boş bir veritabanıyla çalışacak şekilde tasarlandığından, öğrenci ve 
kurs tablolarındaki tüm satırları silmek için SSOX kullanın. (Cascade silme, kayıt tablosundan işlem 
gerçekleştirir.) 

Uygulamayı çalıştırın. Uygulamayı çalıştırmak Dbinitializer.initialize yöntemini çalıştırır. 

Dbinitializer.initialize yeni veritabanını doldurur. 

Sonraki adımlar 

Sonraki iki öğretici ilgili verilerin nasıl okunacağını ve güncelleştirilmesini gösterir. 


ÖNCEKİ ■ SONRAKİ 

ÖĞRETİCİ ■ ÖĞRETİCİ 


Önceki öğreticiler, üç varlıktan oluşan temel bir veri modeliyle çalışmıştır.Bu öğreticide: 

• Daha fazla varlık ve ilişki eklenmiştir. 

• Veri modeli biçimlendirme, doğrulama ve veritabanı eşleme kuralları belirtilerek özelleştirilir. 
Tamamlanan veri modeli için varlık sınıfları aşağıdaki çizimde gösterilmiştir: 
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Çözemediğiniz sorunlarla karşılaşırsanız, Tamamlanmış uygulamayıindirin. 

Veri modelini özniteliklerle özelleştirme 

Bu bölümde, veri modeli öznitelikler kullanılarak özelleştirilir. 

DataType özniteliği 

Öğrenci sayfaları Şu anda kayıt tarihinin saatini görüntüler.Genellikle, tarih alanları saati değil yalnızca tarihi 
gösterir. 

Modelleri/öğrenci, cs 'yi aşağıdaki vurgulanmış kodla güncelleştirin: 









































using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

namespace Contosollniversity .Models 
{ 

public class Student 
{ 

public int ID { get; set; } 

public string LastName { get; set; } 

public string FirstMidName { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 
public DateTime EnrollmentDate { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 

DataType özniteliği, veritabanı iç türünden daha belirgin bir veri türünü belirtir. Bu durumda, tarih ve saat değil 
yalnızca tarih görüntülenmelidir. Veri türü numaralandırması, tarih, saat, PhoneNumber, para birimi, emaadresi 
vb. gibi birçok veri türü sağlar. DataType özniteliği Ayrıca uygulamanın türe özgü özellikleri otomatik olarak 
sağlamasını da sağlayabilir. Örneğin: 

• mailto: bağlantısı DataType.EmailAddress için otomatik olarak oluşturulur. 

• Tarih Seçici çoğu tarayıcıda DataType.Date için sağlanır. 

DataType özniteliği HTM L 5 tarayıcıların kullandığı HTML 5 data- (bir veri Dash) özniteliklerini yayar. 

DataType öznitelikleri doğrulama sağlamaz. 

DataType.Date görüntülenen tarihin biçimini belirtmiyor. Varsayılan olarak, Tarih alanı sunucunun 
Culturelnfoöğesine göre varsayılan biçimlere göre görüntülenir. 

DisplayFormat özniteliği, açıkça tarih biçimini belirtmek için kullanılır: 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 

ApplyFormatlnEditMode ayarı, biçimlendirmenin düzenleme kullanıcı arabirimine de uygulanacağını belirtir. Bazı 
alanlar ApplyFormatlnEditMode kullanmamalıdır. Örneğin, para birimi simgesi genellikle bir düzenleme metin 
kutusunda gösterilmemelidir. 

DisplayFormat özniteliği kendisi tarafından kullanılabilir. DataType özniteliğini DisplayFormat özniteliğiyle 
kullanmak genellikle iyi bir fikirdir. DataType özniteliği, verilerin semantiğini bir ekranda nasıl işleneceğini 
tersine alır. DataType özniteliği, DisplayFormat kullanılamayan aşağıdaki avantajları sağlar: 

• Tarayıcı HTML5 özelliklerini etkinleştirebilir.Örneğin, bir Takvim denetimini, yerel ayara uygun para birimi 
sembolünü, e-posta bağlantılarını, istemci tarafı giriş doğrulamasını vb. göster 

• Varsayılan olarak tarayıcı, verileri yerel ayara göre doğru biçimi kullanarak işler. 

Daha fazla bilgi için bkz. giriş > etiketi Yardımcısı belgeleri< . 

Uygulamayı çalıştırın. Öğrenciler dizin sayfasına gidin. Süreler artık görüntülenmiyor, student modelini 
kullanan her görünüm, tarihi zaman içinde görüntüler. 


















E3 lndex - Contoso Univen X -f- 

- 

□ X 

^ localhost 8 

☆ 

... 

Contoso University 


— 


Index 


Create New 


Find by name: 



Search | Back to Full List 

Last Name 

First Name 

Enrollment Date 


Alexander 

Carson 

2005-09-01 

Edit | Details 

Delete 

Alonso 

Meredith 

2002-09-01 

Edit | Details 

Delete 

Anand 

Arturo 

2003-09-01 

Edit | Details 

Delete 

Previous 

Next 






StringLength özniteliği 

Veri doğrulama kuralları ve doğrulama hatası iletileri özniteliklerle belirtilebilir. StringLength özniteliği, bir veri 
alanında izin verilen en düşük ve en fazla karakter uzunluğunu belirtir. StringLength özniteliği de istemci tarafı 
ve sunucu tarafı doğrulaması sağlar. En küçük değerin veritabanı şeması üzerinde hiçbir etkisi yoktur. 

student modelini aşağıdaki kodla güncelleştirin: 

using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

namespace ContosoUniversity.Models 

{ 

public class Student 

{ 

public int ID { get; set; } 

[StringLength(50)] 

public string LastName { get; set; } 

[StringLength(50, ErrorMessage = "First name cannot be longer than 50 characters.")] 
public string FirstMidName { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 
public DateTime EnrollmentDate { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 

Yukarıdaki kod, adları 50 karakterden fazla olmayacak şekilde sınırlandırır. StringLength özniteliği, kullanıcının 
bir ad için boşluk girmesini engellemez. Cevap içerisinde RegularExpression özniteliği, girişe kısıtlamalar 
uygulamak için kullanılır. Örneğin, aşağıdaki kod ilk karakterin büyük küçük harf olmasını ve geri kalan 
karakterlerin alfabetik olmasını gerektirir: 

[RegularExpression(@" A [A-Z] + [a-zA-Z""'\s-]*$") ] 














Uygulamayı çalıştırın: 

• Öğrenciler sayfasına gidin. 

• Yeni oluştur' u seçin ve 50 karakterden daha uzun bir ad girin. 

• Oluştur' u seçin, istemci tarafı doğrulama bir hata iletisi gösterir. 


B Create - Contoso Unive X 

+ - 1 

□ X 

<- -> ü 

localhost:5313/Student "fa 

... 

Contoso University 


— 


Create 


Student 


LastName 

Davolio very long last name longer than l 
The field LastName must be a string with a maximum length of 50. 

FirstMidName 

Nancy very long first name longer than 5 
First name cannot be longer than 50 characters. 

EnrolImentDate 

2/15/2017 


Create 



SQL Server Nesne Gezgini (ssox) içinde öğrenci tablosuna çift tıklayarak öğrenci tablosu tasarımcısını açın. 



Önceki görüntüde student tablo şeması gösterilmektedir. VERITABANı üzerinde geçişler çalıştırılmadığından, 
ad alanlarının türü nvarchar(MAX) vardır. Bu öğreticide daha sonra geçişler çalıştırıldığında, ad alanları 
nvarchar(50) olur. 


Column özniteliği 





























Öznitelikler sınıfların ve özelliklerin veritabanına nasıl eşlenildiğini denetleyebilir. Bu bölümde, column 
özniteliği, FirstMidName özelliğinin adını VERITABANıNDA "FirstName" olarak eşlemek için kullanılır. 

DB oluşturulduğunda, model üzerindeki özellik adları sütun adları için kullanılır ( column özniteliği kullanıldığı 
durumlar dışında). 

student modeli ilk ad alanı için FirstMidName kullanır, çünkü alan de bir orta ad içerebilir. 

Student.es dosyasını aşağıdaki vurgulanmış kodla güncelleştirin: 

using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public elass Student 

{ 

public int ID { get; set; } 

[StringLength(50)] 

public string LastName { get; set; } 

[StringLength(50, ErrorMessage = "First name cannot be longer than 50 characters.")] 

[Column("FirstName")] 

public string FirstMidName { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 
public DateTime EnrollmentDate { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 

Yukarıdaki değişiklik ile uygulamadaki student.FirstMidName , student tablosunun FirstName sütunuyla 
eşlenir. 

column özniteliğinin eklenmesi modeli schooicontext yedekleyen şekilde değiştirir. schooicontext yedekleyen 
model artık veritabanıyla eşleşmez. Geçiş uygulamadan önce uygulama çalışıyorsa aşağıdaki özel durum 
oluşturulur: 

SqlException: Invalid column name 'FirstName'. 


DB 'yi güncelleştirmek için: 

• Projeyi oluşturun. 

• Proje klasöründe bir komut penceresi açın. Yeni bir geçiş oluşturmak ve DB 'yi güncelleştirmek için 
aşağıdaki komutları girin: 

• Visual Studio 

• Visual Studio Code 


Add-Migration ColumnFirstName 
Update-Database 


migrations add ColumnFirstName komutu aşağıdaki uyarı iletisini üretir: 













An operation was scaffolded that may result in the loss of data. 
Please review the migration for accunacy. 


Ad alanları artık 50 karakterle sınırlı olduğundan uyarı oluşturulur. VERITABANıNDAKI bir ad 50 karakterden 
fazlasına sahipse, son karakter 51 1 i kaybedersiniz. 

• Uygulamayı test edin. 

Öğrenci tablosunu SSOX içinde açın: 


Contosollniversity 


□ X 

dbo.Students [Design] < x| 


▼ 

♦ Update Script File: dbo.Students.sql 




Name 

Data Type 

Allow Nulls 

İD 

int 

□ 

EnrollmentDate 

datetime2(7) 

□ 

FirstName 

nvarchar(50) 

0 

LastName 

nvarchar(50) 

0 


Keys (1) 

PK_Students (Primary Key, CIl 

Check Constraints (0) 
lndexe§ (0) 

Foreign Keys (0) 

Triggers (0) 


C1 Design 

1 

2 

3 

4 

5 

6 

7 

8 

100% - i 


ti S T-SQL 1 ___ 

CREATE TABLE [dbo].[Students] ( 

[ID] INT IDENTITY (1, 1) NOT NULL, 

[EnrollmentDate] DATETIME2 (7) NOT NULL, 

[FirstName] NVARCHAR (50) NULL, 

[LastName] NVARCHAR (50) NULL, 

CONSTRAINT [PK_Students] PRİMARY KEY CLUSTERED ([ID] ASC) 

)î 


tu B U] 


Geçiş uygulanmadan önce ad sütunları nvarchar (max)türünde idi. Ad sütunları artık nvarchar(5e) . Sütun adı, 
FirstMidName FirstName olarak değiştirildi. 


NOTE 

Aşağıdaki bölümde, uygulamanın bazı aşamalardan oluşturulması derleyici hataları oluşturur. Yönergeler uygulamanın ne 
zaman derbir olduğunu belirtir. 


Öğrenci varlık güncelleştirmesi 


Student 


Properties 
V? İD 

A LastName 
A FirstMidName 
A* EnrollmentDate 
Navigation Properties 
Enrollments 


Modelleri/öğrerıci. cs 'yi aşağıdaki kodla güncelleştirin: 
















using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Student 

{ 

public int ID { get; set; } 

[Required] 

[StringLength(50)] 

[Display(Name = "Last Name")] 
public string LastName { get; set; } 

[Required] 

[StringLength(50, ErrorMessage = "First name cannot be longer than 50 characters.")] 
[Column("FirstName")] 

[Display(Name = "First Name")] 

public string FirstMidName { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 

[Display(Name = "Enrollment Date")] 

public DateTime EnrollmentDate { get; set; } 

[Display(Name = "Full Name")] 
public string FullName 
{ 

get 

{ 

return LastName + ", " + FirstMidName; 

} 

} 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 


Gerekli öznitelik 

Required özniteliği, ad özellikleri gereken alanları sağlar. Değer türleri ( DateTime , int , double , vb.) gibi null 
yapılamayan türler için Required özniteliği gerekli değildir. Null olmayan türler otomatik olarak gerekli alanlar 
olarak değerlendirilir. 


Required özniteliği stringLength özniteliğinde minimum length parametresiyle değiştirilebilir: 

[Display(Name = "Last Name")] 

[StringLength(50, MinimumLength=l)] 
public string LastName { get; set; } 


Display özniteliği 

Display özniteliği, metin kutularının açıklamalı alt yazısının "ad", "soyadı", "tam ad" ve "kayıt tarihi" olması 
gerektiğini belirtir. Varsayılan açıklamalı alt yazıların sözcükleri bölen bir boşluk yoktu, örneğin "LastName". 

FullName hesaplanmış özelliği 

FullName , diğer iki özelliği birleştirerek oluşturulmuş bir değer döndüren hesaplanmış bir özelliktir. FullName 
ayarlanamaz, yalnızca bir get erişimcisi vardır. Veritabanında FullName sütunu oluşturulmaz. 


Eğitmen varlığı oluşturma 











Instnıctor 



using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUnivensity.Models 

{ 

public class Instructor 

{ 

public int ID { get; set; } 

[Required] 

[Display(Name = "Last Name")] 

[StringLength(50)] 

public string LastName { get; set; } 

[Required] 

[Column("FirstName")] 

[Display(Name = "First Name")] 

[StringLength(50)] 

public string FirstMidName { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 

[Display(Name = "Hire Date")] 
public DateTime HireDate { get; set; } 

[Display(Name = "Full Name")] 
public string FullName 
{ 

get { return LastName + ", " + FirstMidName; } 

} 

public ICollection<CourseAssignment> CourseAssignments { get; set; } 
public OfficeAssignment OfficeAssignment { get; set; } 

} 

} 

Birden çok öznitelik tek bir satırda olabilir. HireDate öznitelikleri aşağıdaki gibi yazılabilir: 

[DataType(DataType.Date),Display(Name = "Hire Date")jDisplayFormat(DataFormatString = "{0:yyyy-MM-dd }", 
ApplyFormatlnEditMode = true)] 


Courseatamalar ve OfficeAssignment gezinti özellikleri 

CourseAssignments ve OfficeAssignment özellikleri gezinti özellikleridir. 

Bir eğitmen herhangi bir sayıda kurs öğretebilir, bu nedenle CourseAssignments bir koleksiyon olarak tanımlanır. 












public ICollection<CourseAssignment> CourseAssignments { get; set; } 

Bir gezinti özelliği birden çok varlık tutuyorsa: 

• Girişlerin eklenebileceği, silinebileceği ve güncelleştirilebileceği bir liste türü olmalıdır. 

Gezinti özelliği türleri şunları içerir: 

• ICollection<T> 

• List<T> 

• HashSet<T > 

ıcoiiection<T> belirtilirse EF Core varsayılan olarak bir HashSet<T> koleksiyonu oluşturur. 
courseAssignment varlığı, çoktan çoğa ilişkilerin bölümünde açıklanmaktadır. 

Contoso Üniversitesi iş kuralları, bir eğitmenin en fazla bir ofisiniz olabilir. officeAssignment özelliği tek bir 
officeAssignment varlığı barındırır. Office atanmamışsa OfficeAssignment null olur. 

public OfficeAssignment OfficeAssignment { get; set; } 


OfficeAssignment varlığını oluşturma 


OfficeAssign... 



using System.ComponentModel.DataAnnotations; 
using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUnivensity.Models 

{ 

public class OfficeAssignment 

{ 

[Key] 

public int InstructorlD { get; set; } 
[Stringl_ength(50) ] 

[Display(Name = "Office Location")] 
public string Location { get; set; } 

public Instructon Instnuctor { get; set; } 

} 

} 


Anahtar özniteliği 

Özellik adı Classnameıd veya İD dışında bir şey olduğunda, bir özelliği birincil anahtar (PK) olarak tanımlamak 
için [Key] özniteliği kullanılır. 

instructor ve officeAssignment varlıkları arasında bire sıfır veya arasında bir ilişki vardır. Office ataması, 
atandığı eğitmenle ilişkili olarak yalnızca vardır. OfficeAssignment PK Ayrıca, instructor varlığa ait yabancı 

















anahtarıdır (FK). EF Core, şu nedenle instructoriD otomatik olarak officeAssignment PK olarak tanıyamaz: 

• instructoriD , İD veya Classnameıd adlandırma kuralını takip etmez. 

Bu nedenle, Key özniteliği, instructoriD PK olarak tanımlamak için kullanılır: 

[Key] 

public int İnstructoriD { get; set; } 

Varsayılan olarak, EF Core, sütun tanımlayıcı bir ilişki için olduğundan, anahtarı veritabanı olmayan bir şekilde 
değerlendirir. 

Eğitmen gezintisi özelliği 

instructor varlık için OfficeAssignment gezinti özelliği null yapılabilir, çünkü: 

• Başvuru türleri (örneğin, sınıflar Nullable). 

• Bir eğitmenin Office ataması olmayabilir. 

OfficeAssignment varlık null atanamaz instructor bir gezinti özelliğine sahiptir çünkü: 

• instructoriD null değer atanamaz. 

• Bir Office ataması, bir eğitmen olmadan bulunamaz. 

bir varlık ilişkili bir OfficeAssignment varlığına sahip olduğunda, her varlığın gezinti özelliğinde 
bir başvurusu vardır. 

[Required] özniteliği instructor gezinti özelliğine uygulanabilir: 

[Required] 

public instructor instructor { get; set; } 

Yukarıdaki kod, ilgili bir eğitmen olması gerektiğini belirtir. instructoriD yabancı anahtar (aynı zamanda PK) 
null değer atanamaz olduğundan, yukarıdaki kod gereksizdir. 

değiştirme 


Kurs varlığını 


Course 


Properties 
y? CourselD 
A Tîtle 
A Credits 
A DepartmentlD 
Navigation Properties 
y3 Department 
y3 Enrollments 
yH CourseAssignments 


instructor 
diğer birine 


Modelleri/kursu. cs aşağıdaki kodla güncelleştirin: 





















using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Counse 

{ 

[DatabaseGenerated(DatabaseGeneratedOption.None)] 

[Display(Name = "Numben")] 
public int CounselD { get; set; } 

[StringLength(50, MinimumLength = 3)] 
public string Title { get; set; } 

[Range(0, 5)] 

public int Credits { get; set; } 

public int DepartmentlD { get; set; } 

public Department Department { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

public ICollection<CourseAssignment> CourseAssignments { get; set; } 

} 

} 


Course 


varlığın bir yabancı anahtar (FK) özelliği 

DepartmentlD vardır. 

DepartmentlD 

ilgili 

Department 


işaret eder, course varlığın bir Department gezinti özelliği vardır. 


EF Core, modelin ilgili bir varlık için gezinti özelliği olduğunda bir veri modeli için FK özelliği gerektirmez. 


EF Core, gerektiği yerde otomatik olarak veritabanında FKs 'ler oluşturur.EF Core otomatik olarak oluşturulan 
FKs 1er için gölge Özellikler oluşturur. FK 'in veri modelinde olması, güncelleştirmeleri daha basit ve daha 
verimli hale getirir. Örneğin, FK özelliğinin DepartmentlD dahil olmadığı bir model düşünün. Bir kurs varlığı 
düzenlemek üzere getirilirken: 

• Department varlığı açık bir şekilde yüklenmediyse null olur. 

• Kurs varlığını güncelleştirmek için öncelikle Department varlığın getirilmesi gerekir. 

FK özelliği DepartmentlD veri modeline dahil edildiğinde, güncelleştirmeden önce Department varlığını 
getirmeye gerek yoktur. 


DatabaseGenerated özniteliği 

[DatabaseGenerated(DatabaseGeneratedOption.None) ] Özniteliği, PK 'nin veritabam tarafından oluşturulması 
yerine uygulama tarafından sağlandığını belirtir. 


[DatabaseGenerated(DatabaseGeneratedOption.None)] 
[Display(Name = "Number")] 
public int CourselD { get; set; } 


Varsayılan olarak, EF Core PK değerlerinin DB tarafından oluşturulduğunu varsayar. VERITABANı tarafından 
oluşturulan PK değerleri genellikle en iyi yaklaşımdır, course varlıklar için Kullanıcı PK 'yi belirtir. Örneğin, 
matematik departmanı için 1000 serisi, İngilizce departmanı için 2000 serisi gibi bir kurs numarası. 

DatabaseGenerated özniteliği varsayılan değerler oluşturmak için de kullanılabilir. Örneğin, VERITABANı bir 
satırın oluşturulduğu veya güncelleştirildiği tarihi kaydetmek için otomatik olarak bir tarih alanı oluşturabilir. 
Daha fazla bilgi için bkz. üretilen Özellikler. 


Yabancı anahtar ve gezinti özellikleri 















Course varlığındaki yabancı anahtar (FK) özellikleri ve gezinti özellikleri aşağıdaki ilişkileri yansıtır: 

Bir kurs bir departmana atanır, bu nedenle bir DepartmentiD FKve Department gezinti özelliği vardır. 

public int DepartmentiD { get; set; } 
public Department Department { get; set; } 

Bir kurs, kayıtlı sayıda öğrenciye sahip olabilir, bu nedenle Enroiiments gezinti özelliği bir koleksiyondur 

public ICollection<Enrollment> Enrollments { get; set; } 

Bir kurs birden fazla eğitmen tarafından tada olabilir, bu nedenle courseAssignments gezinti özelliği bir 
koleksiyondur: 

public ICollection<CourseAssignment> CourseAssignments { get; set; } 

courseAssignment daha sonraaçıklanmaktadır. 

Departman varlığı oluşturma 


Department 


Properties 
Y? DepartmentiD 
A Name 
A Budget 
A StartDate 
A InstructorlD 
Navigation Properties 
Y^l Administrator 
Y^ Courses 


Aşağıdaki kodla modeller/departman, cs oluşturun: 














using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Department 

{ 

public int DepartmentlD { get; set; } 

[Stringl_ength(50, MinimumLength = 3)] 
public string Name { get; set; } 

[DataType(DataType.Currency)] 

[Column(TypeName = "money")] 
public decimal Budget { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}"j ApplyFormatlnEditMode = true)] 

[Display(Name = "Start Date")] 

public DateTime StartDate { get; set; } 

public int? InstructorlD { get; set; } 

public Instructor Administrator { get; set; } 
public ICollection<Course> Courses { get; set; } 

} 

} 


Column özniteliği 

Daha önce column özniteliği sütun adı eşlemesini değiştirmek için kullanılmıştır. Department varlığın kodunda, 
SQL veri türü eşlemesini değiştirmek için column özniteliği kullanılır. Budget sütunu, VERITABANıNDA SQL 
Server para türü kullanılarak tanımlanır: 

[Column(TypeName="money") ] 
public decimal Budget { get; set; } 

Sütun eşlemesi genellikle gerekli değildir. EF Core genellikle özelliğin CLR türüne göre uygun SQL Server veri 
türünü seçer. CLR decimal türü bir SQL Server decimal türüne eşlenir. Budget para birimi için ve para veri 
türü para birimi için daha uygundur. 

Yabancı anahtar ve gezinti özellikleri 

FK ve gezinti özellikleri aşağıdaki ilişkileri yansıtır: 

• Bir departman yönetici olabilir veya olmayabilir. 

• Yönetici her zaman bir eğitmendir. Bu nedenle InstructorlD özelliği, ınstructor varlığa FK olarak eklenir. 
Gezinti özelliği Administrator olarak adlandırılır ancak bir ınstructor varlığı tutar: 

public int? InstructorlD { get; set; } 
public Instructor Administrator { get; set; } 

Önceki koddaki soru işareti (?) özelliği null yapılabilir olduğunu belirtiyor. 

Bir departmanın birçok kursu olabilir, bu nedenle bir kurs gezintisi özelliği vardır: 
















public ICollection<Counse> Counses { get; set; } 


Note: kurala göre EF Core, null yapılamayan ve çoktan çoğa ilişkiler için art arda silme imkanı sağlar. Basamaklı 
silme, dairesel basamaklı silme kurallarına neden olabilir. Döngüsel basamaklı silme kuralları, bir geçiş 
eklendiğinde özel duruma neden olur. 

Örneğin, Department.instructoriD özelliği null yapılamayan olarak tanımlanmışsa: 

• EF Core, eğitmen silindiğinde departmanı silmek için bir basamakla silme kuralı yapılandırır. 

• Eğitmen silindiğinde departmanı silmek amaçlanan davranış değildir. 

• Aşağıdaki Fluent API Cascade yerine bir kısıtlama kuralı ayarlar. 

modelBuilder.Entity<Department>() 

.HasOne(d => d.Administrator) 

.WithMany() 

.OnDelete(DeleteBehavior.Restrict) 


Yukarıdaki kod, departman-eğitmen ilişkisindeki basamaklı silmeyi devre dışı bırakır. 

Kayıt varlığını güncelleştirme 

Kayıt kaydı, tek bir öğrenci tarafından gerçekleştirilen bir kurs içindir. 


Enrollment 


Propertîes 
y? EnrolImentlD 
A CourselD 
A StudentlD 
A Grade 

Navigation Properties 
Course 
y3 Student 


Modelleri/kaydı. cs 'yi aşağıdaki kodla güncelleştirin: 










using System.ComponentModel.DataAnnotations; 
using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 
{ 

public enum Grade 
{ 

Aj B, C, D, F 

} 

public class Enrollment 
{ 

public int EnrollmentlD { get; set; } 
public int CounselD { get; set; } 
public int StudentlD { get; set; } 
[DisplayFormat(NullDisplayText = "No grade")] 
public Grade? Grade { get; set; } 

public Course Course { get; set; } 
public Student Student { get; set; } 

} 

} 


Yabancı anahtar ve gezinti özellikleri 

FK özellikleri ve gezinti özellikleri aşağıdaki ilişkileri yansıtır: 

Kayıt kaydı tek bir kursa yöneliktir, bu nedenle bir courseiD FK özelliği ve course gezinti özelliği vardır: 

public int CourseiD { get; set; } 
public Course Course { get; set; } 

Kayıt kaydı bir öğrenci içindir, bu nedenle bir studentiD FK özelliği ve student gezinti özelliği vardır: 

public int StudentlD { get; set; } 
public Student Student { get; set; } 


Çoktan çoğa İlişkiler 

student ve Course varlıkları arasında çok-çok ilişkisi vardır. Enrollment varlık, veritabanında Yük ile çoktan 
çoğa bir JOIN tablosu olarak çalışır. "Yükle", Enrollment tablosunun birleştirilmiş tablolar (Bu durumda, PK ve 
Grade ) gibi ek verileri içerdiği anlamına gelir. 

Aşağıdaki çizimde bu ilişkilerin bir varlık diyagramında nasıl göründüğünü gösterilmektedir.(Bu diyagram EF 6. 
x için EF güç araçları kullanılarak oluşturulmuştur. Diyagram oluşturmak öğreticinin bir parçası değildir.) 
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Her ilişki ucu ve bir yıldız işareti (*) 1 diğer sırasında bir-çok ilişkisi belirten bulunur. 

Enroiiment tablo, sınıf bilgilerini içermiyorsa, yalnızca iki FKs ( CourseiD ve studentiD ) içermesi gerekir.Yük 
olmadan çoktan çoğa bir JOIN tablosu bazen saf JOIN tablosu (PJT) olarak adlandırılır. 

instructor ve Course varlıkların, saf bir JOIN tablosu kullanılarak çoktan çoğa bir ilişkisi vardır. 

Note: EF 6. x, çoktan çoğa ilişkiler için örtük birleştirmeyi destekler, ancak EF Core değildir.Daha fazla bilgi için 

EF Core 2,0 1 de çoktan çoğa ilişkilerbölümüne bakın. 

Courseatama varlığı 
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Aşağıdaki kodla modeUer/Courseatama. cs oluşturun: 



























using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class CounseAssignment 

{ 

public int InstructorlD { get; set; } 
public int CounselD { get; set; } 
public Instructor Instnuctor { get; set; } 
public Course Course { get; set; } 

} 

} 


Eğitmenden kurslar 
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Eğitmenin kurslardan çok-çok ilişkisi: 

• Bir varlık kümesiyle temsil etmelidir bir JOIN tablosu gerektirir. 

• , Saf bir JOIN tablosu (yük içermeyen tablo). 

EntityNameiEntityName 2 bir JOIN varlığı adı yaygın olarak vardır.Örneğin, bu model kullanılarak eğitmen- 
kurslar JOIN tablosu Courseinstructor . Ancak, ilişkiyi açıklayan bir ad kullanmanızı öneririz. 

Veri modelleri basit ve büyümeye başlar. Yük yükü dahil olmak üzere genellikle yük-yük birleştirmeleri (PJTs) 
gelişmektedir. Açıklayıcı bir varlık adıyla başlayarak, ekleme tablosu değiştiğinde adın değiştirilmesi gerekmez, 
ideal olarak, JOIN varlığının iş etki alanında kendi doğal (muhtemelen tek bir kelime) adına sahip olması 
gerekir. Örneğin, kitaplar ve müşteriler, derecelendirmeler adlı bir JOIN varlığıyla bağlantı kurulabilir.Eğitmenin 
kursa çok-çok ilişkisi için Courseinstructor" CourseAssignment tercih edilir. 


Bileşik anahtar 






















FKs null değer atanamaz. CourseAssignment ( InstructorlD ve CourselD ) içindeki iki FKs, CourseAssignment 
tablosunun her satırını benzersiz olarak tanımlar. CourseAssignment adanmış bir PK gerektirmez. InstructorlD 
ve CourselD özellikleri bileşik bir PK olarak çalışır. EF Core bileşik PKs 'leri belirtmenin tek yolu FluentAPI' dir. 
Sonraki bölümde, bileşik PK 'nin nasıl yapılandırılacağı gösterilmektedir. 

Bileşik anahtar şunları sağlar: 

• Tek bir kurs için birden çok satıra izin verilir. 

• Birden çok satıra bir eğitmen için izin verilir. 

• Aynı eğitmen ve kurs için birden çok satıra izin verilmez. 

Enroiiment JOIN varlığı kendi PK 'yi tanımlar, bu nedenle bu sıralamanın yinelemeleri mümkündür.Bu tür 
yinelemeleri engellemek için: 

• FK alanlara benzersiz bir dizin ekleyin veya 

• CourseAssignment benzer bir birincil bileşik anahtarla Enroiiment yapılandırın. Daha fazla bilgi için bkz. 

dizinler. 


DB bağlamını güncelleştirme 


Data/SchoolContext. cs' ye aşağıdaki vurgulanmış kodu ekleyin: 


using ContosoUniversity.Models; 
using Microsoft.EntityFrameworkCore; 

namespace ContosoUniversity.Models 

{ 

public class SchoolContext : DbContext 

{ 

public SchoolContext(DbContextOptions<SchoolContext> options) : base(options) 

{ 

} 

public DbSet<Course> Courses { get; set; } 

public DbSet<Enrollment> Enrollment { get; set; } 

public DbSet<Student> Student { get; set; } 

public DbSet<Department> Departments { get; set; } 

public DbSet<Instructor> Instructors { get; set; } 

public DbSet<OfficeAssignment> OfficeAssignments { get; set; } 

public DbSet<CourseAssignment> CourseAssignments { get; set; } 

protected override void OnModelCreating(ModelBuilder modelBuilder) 

{ 

modelBuilder.Entity<Course>().ToTable("Course"); 
modelBuilder.Entity<Enrollment>().ToTable("Enrollment"); 
modelBuilder.Entity<Student>().ToTable("Student"); 
modelBuilder.Entity<Department>().ToTable("Department"); 
modelBuilder.Entity<Instructor>().ToTable("Instructor"); 
modelBuilder.Entity<OfficeAssignment>().ToTable("OfficeAssignment"); 
modelBuilder.Entity<CourseAssignment>().ToTable("CourseAssignment"); 


} 


} 


} 


modelBuilder.Entity<CourseAssignment>() 

.HasKey(c => new { c.CourselD, c.InstructorlD }); 


Yukarıdaki kod, yeni varlıkları ekler ve CourseAssignment varlığın bileşik PK öğesini yapılandırır. 


Tutarlı API 'nin özniteliklere alternatif 













Önceki koddaki onModeicreating yöntemi EF Core davranışını yapılandırmak için FluentAPI kullanır. Genellikle 
tek bir bildirimde bir dizi yöntem çağrısı olan dize olarak kullanıldığından, API "akıcı" olarak adlandırılır. 
Aşağıdaki kod FluentAPI bir örneğidir: 

protected override void OnModelCreating(ModelBuilder modelBuilder) 

{ 

modelBuilder.Entity<Blog>() 

.Property(b => b.Url) 

.IsRequired(); 

} 

Bu öğreticide, FluentAPI yalnızca özniteliklerle yapılamadığını DB eşlemesi için kullanılır. Ancak FluentAPI, 
özniteliklerle yapılabilecek biçimlendirme, doğrulama ve eşleme kurallarının çoğunu belirtebilir. 

MinimumLength gibi bazı öznitelikler FluentAPI uygulanamaz. MinimumLength şemayı değiştirmez, yalnızca bir 
minimum uzunluk doğrulama kuralı uygular. 

Bazı geliştiriciler, varlık sınıflarının "temiz" olmasını sağlamak için Fluent API özel olarak kullanmayı tercih eder. 
Öznitelikler ve Fluent API karışık olabilir.Yalnızca Fluent API (bileşik bir PK belirterek) yapılabilecek bazı 
konfigürasyonlar vardır. Yalnızca özniteliklerle ( MinimumLength ) yapılabilecek bazı konfigürasyonlar vardır. 
Fluent API veya özniteliklerini kullanmak için önerilen uygulama: 

• Bu iki yaklaşımdan birini seçin. 

• Seçilen yaklaşımı mümkün olduğunca düzenli olarak kullanın. 

Bu öğreticide kullanılan özniteliklerin bazıları için kullanılır: 

• Yalnızca doğrulama (örneğin, MinimumLength ). 

• Yalnızca yapılandırma EF Core (örneğin, HasKey ). 

• Doğrulama ve EF Core yapılandırma (örneğin, [stringLength(se)] ). 

Öznitelikler ile Fluent API hakkında daha fazla bilgi için bkz. yapılandırma yöntemleri. 

İlişkileri gösteren varlık diyagramı 

Aşağıdaki çizimde, tamamlanmış okul modeli için EF Power Tools 'un oluştura diyagramı gösterilmektedir. 
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Önceki diyagramda şunları gösterir: 
• Birkaç bire çok ilişki satırı (*1). 


• 

Instructor 

ve 

OfficeAssignment 

varlıkları arasında bire sıfır veya-bir ilişki çizgisi (1 ila 0.. 1), 

• 

Instructor 

ve 

Department 

varlıkları arasında sıfır veya-bire çok ilişki çizgisi (0.. 1 -*). 


VERITABANıNı test verileriyle çekirdek olarak 

Data/Dbmizer. csdosyasındaki kodu güncelleştirin: 


using System; 
using System.Linq; 

using Microsoft.EntityFrameworkCore; 

using Microsoft. Extensions .Dependencylnjection; 

using ContosolIniversity.Models; 

namespace ContosoUniversity.Data 

{ 

public static class Dblnitializer 

{ 

public static void Initialize(SchoolContext context) 

{ 

//context.Database.EnsureCreated(); 










































// Look for any students. 
if (context.Student.Any()) 

{ 

netunn; // DB has been seeded 

} 


van students = new Student[] 

{ 

new Student { FinstMidName = "Canson", LastName 
EnnollmentDate = DateTime.Parse("2010-09-01") 
new Student { FinstMidName = "Menedith", LastName 
EnnollmentDate = DateTime.Panse("2012-09-01") 
new Student { FinstMidName = "Antuno", LastName 
EnnollmentDate = DateTime.Panse("2013-09-01") 
new Student { FinstMidName = "Gytis", LastName 
EnnollmentDate = DateTime.Panse("2012-09-01") 
new Student { FinstMidName = "Yan", LastName 

EnnollmentDate = DateTime.Panse("2012-09-01") 
new Student { FinstMidName = "Peggy", LastName 
EnnollmentDate = DateTime.Panse("2011-09-01") 
new Student { FinstMidName = "Launa", LastName 
EnnollmentDate = DateTime.Panse("2013-09-01") 
new Student { FinstMidName = "Nino", LastName 
EnnollmentDate = DateTime.Panse("2005-09-01") 

}; 

foneach (Student s in students) 

{ 

context.Student.Add(s); 

} 

context.SaveChanges(); 


= "Alexanden", 

L 

= "Alonso", 

L 

= "Anand", 

L 

= "Banzdukas", 

L 

= "Lİ", 

L 

= "lustice", 

L 

= "Nonman", 

L 

= "Olivetto", 

} 


van instnuctons = new Instnucton[] 

{ 

new Instnucton { FinstMidName = "Kim", LastName = "Abencnombie", 
HineDate = DateTime.Panse("1995-03-ll") }, 
new Instnucton { FinstMidName = "Fadi", LastName = "Fakhouni", 
HineDate = DateTime.Panse("2002-07-06") }, 
new Instnucton { FinstMidName = "Rogen", LastName = "Hanui", 
HineDate = DateTime.Panse("1998-07-01") }, 
new Instnucton { FinstMidName = "Candace", LastName = "Kapoon", 
HineDate = DateTime.Panse("2001-01-15") }, 
new Instnucton { FinstMidName = "Rogen", LastName = "Zheng", 
HineDate = DateTime.Panse("2004-02-12") } 


}; 


foneach (Instnucton i in instnuctons) 

{ 

context.Instnuctons.Add(i); 

} 

context.SaveChanges(); 


van depantments = new Depantment[] 

{ 

new Depantment { Name = "English", Budget = 350000, 
StantDate = DateTime.Panse("2007-09-01"), 
InstnuctonlD = instnuctons.Single( i => i.LastName 
new Depantment { Name = "Mathematics", Budget = 100000, 
StantDate = DateTime.Panse("2007-09-01"), 
InstnuctonlD = instnuctons.Single( i => i.LastName 
new Depantment { Name = "Engineening", Budget = 350000, 
StantDate = DateTime.Panse("2007-09-01"), 
InstnuctonlD = instnuctons.Single( i => i.LastName 
new Depantment { Name = "Economics", Budget = 100000, 
StantDate = DateTime.Panse("2007-09-01"), 
InstnuctonlD = instnuctons.Single( i => i.LastName 

}; 


"Abencnombie").ID }, 


"Fakhouni").ID }, 


"Hanui").ID }, 


"Kapoon").ID } 


foneach (Depantment d in depantments) 


{ 

context.Depa rtments.Add(d); 

} 

context.SaveChanges(); 

var courses = new Course[] 

{ 

new Course {CourselD = 1050., Title = "Chemistry", Credlts = 3, 

DepartmentlD = departments.Single( s => s.Name == "Engineering").DepartmentlD 

}, 

new Course {CourselD = 4022, Title = "Microeconomics", Credits = 3, 

DepartmentlD = departments.Single( s => s.Name == "Economics").DepartmentlD 

}, 

new Course {CourselD = 4041, Title = "Macroeconomics", Credits = 3, 

DepartmentlD = departments.Single( s => s.Name == "Economics").DepartmentlD 

}, 

new Course {CourselD = 1045, Title = "Calculus", Credits = 4, 

DepartmentlD = departments.Single( s => s.Name == "Mathematics").DepartmentlD 

}, 

new Course {CourselD = 3141, Title = "Trigonometry", Credits = 4, 

DepartmentlD = departments.Single( s => s.Name == "Mathematics").DepartmentlD 

}, 

new Course {CourselD = 2021, Title = "Composition", Credits = 3, 

DepartmentlD = departments.Single( s => s.Name == "English").DepartmentlD 

L 

new Course {CourselD = 2042, Title = "Literatüre", Credits = 4, 

DepartmentlD = departments.Single( s => s.Name == "English").DepartmentlD 

L 

}; 

foreach (Course c in courses) 

{ 

context.Courses.Add(c); 

} 

context.SaveChanges(); 

var officeAssignments = new OfficeAssignmentf] 

{ 

new OfficeAssignment { 

InstructorlD = instructors.Single( i => i.LastName == "Fakhouri").İD, 

Location = "Smith 17" }, 
new OfficeAssignment { 

InstructorlD = instructors.Single( i => i.LastName == "Harui").ID, 

Location = "Gowan 27" }, 
new OfficeAssignment { 

InstructorlD = instructors.Single( i => i.LastName == "Kapoor").İD, 

Location = "Thompson 304" }, 

}; 

foreach (OfficeAssignment o in officeAssignments) 

{ 

context. OfficeAssignments .Add(o); 

} 

context.SaveChanges (); 


var courselnstructors = new CourseAssignmentf] 

{ 


new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 


== "Chemistry" ).CourselD, 
İ.LastName == "Kapoor").ID 


== "Chemistry" ).CourselD, 
İ.LastName == "Harui").ID 


== "Microeconomics" ).CourselD, 
İ.LastName == "Zheng").ID 


T. 


}; 


new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 

b 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 

b 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 

b 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 

b 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 

b 


== "Macroeconomics" ).CourselD, 
i.LastName == "Zheng").ID 


== "Calculus" ).CourselD, 
İ.LastName == "Fakhouri").ID 


== "Trigonometry" ).CourselD, 
İ.LastName == "Harui").ID 


== "Composition" ).CourselD, 
İ.LastName == "Abercrombie").ID 


== "Literatüre" ).CourselD, 
İ.LastName == "Abercrombie").ID 


foreach (CourseAssignment ci in courselnstructors) 

{ 

context.CourseAssignments.Add(ci); 

} 

context.SaveChanges(); 


var enrollments = new Enrollment[] 

{ 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Alexander").ID, 
CourselD = courses.Single(c => c.Title == "Chemistry" ).CourselD, 

Grade = Grade.A 

b 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Alexander").ID, 
CourselD = courses.Single(c => c.Title == "Microeconomics" ).CourselD, 
Grade = Grade.C 

b 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Alexander").ID, 
CourselD = courses.Single(c => c.Title == "Macroeconomics" ).CourselD, 
Grade = Grade.B 

b 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Alonso").ID, 
CourselD = courses.Single(c => c.Title == "Calculus" ).CourselD, 

Grade = Grade.B 

b 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Alonso").ID, 
CourselD = courses.Single(c => c.Title == "Trigonometry" ).CourselD, 
Grade = Grade.B 

b 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Alonso").ID, 

CourselD = courses.Single(c => c.Title == "Composition" ).CourselD, 
Grade = Grade.B 

b 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Anand").ID, 

CourselD = courses.Single(c => c.Title == "Chemistry" ).CourselD 

b 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Anand").ID, 

CourselD = courses.Single(c => c.Title == "Microeconomics").CourselD, 
Grade = Grade.B 


new Enrollment { 

StudentlD = students.Single(s => s.LastIMame == "Barzdukas").IDj 
CourselD = courses.Single(c => c.Title == "Chemistry").CourselD, 
Grade = Grade.B 
}, 

new Ennollment { 

StudentlD = students.Single(s => s.LastIMame == "Li").ID, 

CourselD = counses.Single(c => c.Title == "Composition").CourselD, 
Grade = Grade.B 
}, 

new Enrollment { 

StudentlD = students.Single(s => s.LastIMame == "Dustice").İD, 
CourselD = courses.Single(c => c.Title == "Literatüre") .CourselD., 
Grade = Grade.B 
} 

}; 


foreach (Enrollment e in enrollments) 

{ 

var enrollmentlnDataBase = context.Enrollment.Where( 
s => 

s.Student.ID == e.StudentlD && 

s.Course.CourselD == e.CourselD).SingleOrDefault(); 
if (enrollmentlnDataBase == null) 

{ 

context.Enrollment.Add(e); 

} 

} 

context.SaveChanges(); 

} 

} 

} 

Yukarıdaki kod, yeni varlıklar için tohum verileri sağlar. Bu kodun çoğu yeni varlık nesneleri oluşturur ve örnek 
verileri yükler. Örnek veriler test için kullanılır.Çoktan çoğa ekleme tablolarının nasıl çalıştırılabilir olduğunu 
gösteren örnekler için Enrollments ve CourseAssignments bakın. 

Geçiş Ekle 

Projeyi oluşturun. 

• Visual Studio 

• Visual Studio Code 


Add-Migration ComplexDataModel 


Yukarıdaki komut, olası veri kaybı hakkında bir uyarı görüntüler. 

An operation was scaffolded that may result in the loss of data. 

Please review the migration for accuracy. 

Done. To undo this action, use 'ef migrations remove' 

database update komutu çalıştır 1 1dıysanız aşağıdaki hata oluşturulur: 

The ALTER TABLE statement conflicted with the FOREIGN KEY constraint 
"FK_dbo.Course_dbo.Department_DepartmentID". The conflict occurred in 
database "ContosoUniversity", table "dbo.Department", column 'DepartmentlD'. 





Geçişi Uygula 

Artık var olan bir veritabanınız olduğuna göre, bundan sonraki değişikliklere nasıl uygulanacağını düşünmeniz 
gerekir. Bu öğreticide iki yaklaşım gösterilmektedir: 

• Veritabanını bırakıp yeniden oluşturun 

• Geçişi mevcut veritabanına uygulayın. Bu yöntem daha karmaşıktır ve zaman alabilir. Bu, gerçek dünyada 
üretim ortamları için tercih edilen yaklaşımdır. Note: Bu, öğreticinin isteğe bağlı bir bölümüdür.Bırakma ve 
yeniden oluşturma adımlarını gerçekleştirebilir ve bu bölümü atlayabilirsiniz. Bu bölümdeki adımları 
izlemek isterseniz, bırakma ve yeniden oluşturma adımlarını yapmayın. 

Veritabanını bırakıp yeniden oluşturun 

Güncelleştirilmiş Dbinitializer kod, yeni varlıklar için tohum verileri ekler. Yeni bir VERITABANı oluşturmak 
için EF Core zorlamak için DB 'yi bırakıp güncelleştirin: 

• Visual Studio 

• Visual Studio Code 

Paket Yöneticisi konsolunda (PMC), aşağıdaki komutu çalıştırın: 

Drop-Database 

Update-Database 

Yardım bilgileri almak için PMC'ten Get-Help about_EntityFrameworkCore çalıştırın. 

Uygulamayı çalıştırın. Uygulamayı çalıştırmak Dbinitializer.initialize yöntemini çalıştırır. 

Dbinitializer.initialize yeni DB 'yi doldurur. 

VERITABANıNı SSOX içinde açın: 

• Daha önce SSOX açıldıysa Yenile düğmesine tıklayın. 

• Genişletin tabloları düğümü. Oluşturulan tablolar görüntülenir. 
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Courseatama tablosunu inceleyin: 

• Courseatama tablosuna sağ tıklayın ve verileri görüntüle 1 yi seçin. 

• Courseatama tablosunun veri içerdiğini doğrulayın. 
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Geçişi mevcut veritabanına Uygula 

Bu bölüm isteğe bağlıdır. Bu adımlar yalnızca önceki bırakma ve veritabanını yeniden oluşturma bölümünü 
atladıysanız çalışır. 

Geçişler mevcut verilerle çalıştırıldığında, mevcut verilerin karşılanmadığı FK kısıtlamalar olabilir. Üretim 
verileriyle, mevcut verilerin geçirilmesi için adımların alınması gerekir. Bu bölüm, FK kısıtlama ihlallerinin 
düzeltilmesiyle bir örnek sağlar. Bu kod değişikliklerini yedekleme olmadan yapmayın. Önceki bölümü 
tamamlayıp veritabanını güncelleştirdiyseniz, bu kod değişikliklerini yapmayın. 

{Timestamp}_ComplexDataModel. cs dosyası aşağıdaki kodu içerir: 

migrationBuilder.AddColumn<int>( 
name: "DepartmentiD", 
table: "Course", 
type: "int", 
nullable: false, 
defaultValue: 0); 

Yukarıdaki kod course tabloya null atanamaz DepartmentiD FK ekler.Önceki öğreticideki VERITABANı 
Course satırları içerir, böylece tablo geçişler tarafından güncelleştirilemez. 

compiexDataModei geçişinin mevcut verilerle çalışmasını sağlamak için: 

• Yeni sütuna ( DepartmentiD ) varsayılan değer vermek için kodu değiştirin. 

• Varsayılan departman olarak davranacak "Temp" adlı sahte bir departman oluşturun. 

Yabancı anahtar kısıtlamalarını çözme 

compiexDataModei sınıfları up yöntemini güncelleştirin: 

• {Timestamp}_ComplexDataModel, cs dosyasını açın. 

• DepartmentiD sütununu Course tablosuna ekleyen kod satırını açıklama satırı yapın. 
















migrationBuilder.AlterColumn<string>( 
name: "Title", 
table: "Course", 
maxLength: 50, 
nullable: true, 
oldClrType: typeof(string), 
oldNullable: true); 

//migrationBuilder.AddColumn<int>( 

// name: "DepartmentlD", 

// table: "Course", 

// nullable: false, 

// defaultValue: 0); 

Aşağıdaki vurgulanmış kodu ekleyin. Yeni kod .createTabie( name: "Department" bloğundan sonra geçer: 

migrationBuilder.CreateTable( 
name: "Department", 
columns: table => new 
{ 

DepartmentlD = table.Column<int>(type: "int", nullable: false) 

.Annotation("SqlServer:ValueGenerationStrategy", 

SqlServerValueGenerationStrategy.IdentityColumn), 

Budget = table.Column<decimal>(type: "money", nullable: false), 

InstructorlD = table.Column<int>(type: "int", nullable: true). 

Name = table.Column<string>(type: "nvarchar(50)", maxLength: 50, nullable: true), 

StartDate = table.Column<DateTime>(type: "datetime2", nullable: false) 

}, 

constraints: table => 

{ 

table.PrimaryKey("PK_Department", x => x.DepartmentlD); 
table.ForeignKey( 

name: "FK_Department_Instructor_InstructorID", 
column: x = > x.InstructorlD, 
principalTable: "Instructor", 
principalColumn: "ID", 
onDelete: ReferentialAction.Restrict); 

}); 

migrationBuilder.Sql("INSERT INTO dbo.Department (Name, Budget, StartDate) VALUES ('Temp', 0.00, 
GETDATE())"); 

// Default value for FK points to department created above, with 
// defaultValue changed to 1 in following AddColumn statement. 

migrationBuilder.AddColumn<int>( 
name: "DepartmentlD", 
table: "Course", 
nullable: false, 
defaultValue: 1); 

Önceki değişikliklerle, compiexDataModei up yöntemi çalıştıktan sonra mevcut course satırları "geçici" 
departmanıyla ilişkilendirilir. 

Bir üretim uygulaması şöyle olacaktır: 

• Yeni Department satırlarına Department satırları ve ilgili course satırlarını eklemek için kod veya komut 
dosyaları ekleyin. 

• "Geçici" Departmanı veya course.DepartmentlD için varsayılan değeri kullanmayın. 

Sonraki öğreticide ilgili veriler ele alınmaktadır. 


Ek kaynaklar 











• Bu öğreticinin YouTube sürümü (Bölüm 1) 

• Bu öğreticinin YouTube sürümü (Bölüm 2) 


ÖNCEKİ 


İLERİ 






ASRNET Core EF Core ile Razor Pages-llgili verileri 
oku-6/8 

23.11.2019 * 42 minutes to read ı Edit Online 


, Tom Dykstra, Jon P Smithve Rick Anderson 

Contoso Üniversitesi web uygulaması, EF Core ve Visual Studio kullanarak Razor Pages Web uygulamaları 
oluşturmayı gösterir. Öğretici serisi hakkında daha fazla bilgi için ilk öğreticiyebakın. 

Çözemediğiniz sorunlarla karşılaşırsanız, Tamamlanmış uygulamayı indirin ve öğreticiyi izleyerek bu kodu 
oluşturduğunuz şekilde karşılaştırın. 

Bu öğreticide, ilgili verilerin nasıl okunacağı ve görüntüleneceği gösterilmektedir.ilgili veriler, EF Core gezinti 
özelliklerine yüklediği veri. 

Aşağıdaki çizimler, Bu öğreticinin tamamlanan sayfalarını göstermektedir: 
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Eager, açık ve yavaş yükleme 

EF Core bir varlığın gezinti özelliklerine ilgili verileri yükleyebilmenin birkaç yolu vardır: 


• Eager yükleniyor. Ekip yükleme, bir varlık türü için bir sorgu aynı zamanda ilgili varlıkları de 

yüklediğinde oluşur. Bir varlık okunmadığınızda ilgili veriler alınır. Bu, genellikle gereken tüm verileri 
alan tek bir JOIN sorgusuna neden olur. EF Core, bazı Eager yükleme türleri için birden çok sorgu 
sorgu verme, çok büyük paketlerini tek sorgusundan daha verimli olabilir, 
yöntemleriyle Eager yüklemesi belirtildi. 


yayımlayacak. Birden çok 
Include ve Thenlnclude 


var departments = _context.Departments.Include(d => d.Courses); 
foreach (Department d in departments) 

foreach(course c in d.courses) Query: ali Department entıties 


courseList.Add(d. 


ucpaı ııncuıa j 

.Courses) C 

Name + c.Title); 


and related Course entities 


J 


Bir koleksiyon gezintisi eklendiğinde Eager yüklemesi birden çok sorgu gönderir: 
o Ana sorgu için bir sorgu 

o Yükleme ağacındaki her koleksiyon "Edge" için bir sorgu. 

• Sorguları Load ile ayırın: veriler ayrı sorgularda alınabilir ve EF Core "düzeltmeler"' i "düzeltir". 








"Düzeltmeler", EF Core gezinti özelliklerini otomatik olarak dolduran anlamına gelir. Load ile ayrı 
sorgular, ek yükleme Eager 'dan daha da benzer. 


var departments = _context.Departments; 
foreach (Department d in departments)- 
{ 


r 


Query: ali Department rows 




- c 




_context.Courses.Where(c => c.DepartmentlD == d.DepartmentlD).Load(); 
foreach (Course c in d.Courses) 

{ 

courseList.Add(d.Name + c.Title); 

} 


Query: Course rows related to Department d 


J 


Note: EF Core, daha önce bağlam örneğine yüklenmiş olan diğer varlıklar için gezinti özelliklerini 
otomatik olarak düzeltir. Bir gezinti özelliği için veriler açıkça dahil edilmese bile, ilgili varlıkların bazıları 
veya tümü daha önce yüklenmişse Özellik yine de doldurulabilir. 

• Açık yükleme. Varlık ilk kez okunmadıysa ilgili veriler alınmadı. Gerektiğinde ilgili verileri almak için 
kodun yazılması gerekir. Ayrı sorgularla açık yükleme, veritabanına birden çok sorgu gönderilmesine 
neden olur. Açık yükleme ile kod, yüklenecek gezinti özelliklerini belirtir. Açık yükleme yapmak için 

Load yöntemini kullanın. Örneğin: 

var departments = _context.Departments; 

foreach (Department d in departments)— ÛUery: ali Department TOWS 

_context.Entry(d).Collection(p => p.Courses).Load(); 
foreach (Course c in d.Courses) 

{ f Query: Course rows related to Department 

courseList.Add(d.Name + c.Title); 

} 

} 

• Yavaş yükleme. Sürüm 2,1 1 de EF Core geç yükleme eklendi. Varlık ilk kez okunmadıysa ilgili veriler 
alınmadı. Gezinti özelliğine ilk kez erişildiğinde, bu gezinti özelliği için gereken veriler otomatik olarak 
alınır. Bir gezinti özelliğine ilk kez erişildiğinde bir sorgu veritabanına gönderilir. 




Kurs sayfaları oluşturma 

course varlığı, ilgili Department varlığını içeren bir gezinti özelliği içerir. 
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Bir kurs için atanan departmanın adını göstermek için: 

• ilgili Department varlığını Course.Department gezinti özelliğine yükleyin. 

• Department varlığın Name özelliğinden adı alın. 

Yapı iskelesi kurs sayfaları 

• Visual Studio 

• Visual Studio Code 

• Aşağıdaki özel durumlarla birlikte Yapı Fkatlama öğrenci sayfalarındaki yönergeleri izleyin: 

o Bir Sayfalar/kurslar klasörü oluşturun, 
o Model sınıfı için course kullanın. 

o Yeni bir tane oluşturmak yerine var olan bağlam sınıfını kullanın. 

• Pages/kurslar/lndex. cshtml. cs dosyasını açın ve onGetAsync metodunu inceleyin. Yapı iskelesi altyapısı, 

Department gezinti özelliği için bir yükleme belirtti, inciude yöntemi Eager yüklemeyi belirtir. 

• Uygulamayı çalıştırın ve Kurslar bağlantısını seçin. Departman sütunu, yararlı olmayan DepartmentlD 
görüntüler. 

Departmanın adını görüntüleme 

Pages/kurslar/lndex. cshtml. cs dosyasını aşağıdaki kodla güncelleştirin: 

















using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.EntityFrameworkCore; 
using System.Collections.Generic; 
using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Courses 

{ 

public class IndexModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public IndexModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

public IList<Course> Courses { get; set; } 

public async Task OnGetAsync() 

{ 

Courses = await _context.Courses 
.Include(c => c.Department) 

.AsNoTracking() 

.ToListAsync(); 

} 

} 

} 

Yukarıdaki kod course özelliğini courses olarak değiştirir ve AsNoTracking ekler. AsNoTracking , döndürülen 
varlıklar izlenmediğinden performansı geliştirir. Varlıkların geçerli bağlamda güncelleştirilmediği için izlenmesi 
gerekmez. 

Pages/kurslar/lndex. cshtml 'yi aşağıdaki kodla güncelleştirin. 






@page 

@model ContosoUniversity. Pages.Courses.IndexModel 

@{ 

ViewData["Title"] = "Courses"; 

} 

<hl>Courses</hl> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<table class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model => model.Courses[0].CourselD) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Courses[0].Title) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Courses[0].Credlts) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Courses[0].Department) 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model.Courses) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.CourselD) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Credits) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Department.Name) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.CourseID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.CourseID">Details</a> | 

<a asp-page="./Delete" asp-route-id="@item.CourselD">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 


Yapı iskelesi kodunda aşağıdaki değişiklikler yapılmıştır: 

• Course Özellik adı courses olarak değiştirildi. 

• CourselD özellik değerini gösteren bir sayı sütunu eklendi. Birincil anahtarlar, genellikle son 
kullanıcılara anlamlı olduklarından, varsayılan olarak yapı iskelesi göstermemektedir. Ancak, bu 
durumda birincil anahtar anlamlı olur. 


• Departman adını göstermek için Departman sütunu değiştirildi. Kod, Department gezinti özelliğine 







yüklenen Department varlığının Name özelliğini görüntüler: 

@Html.DisplayFor(modelItem => item.Department.Name) 


Uygulamayı çalıştırın ve bölüm adlarıyla listeyi görmek için Kurslar sekmesini seçin. 
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4 

Mathematics 

Edit | Details | 

Delete 

1050 

Chemistry 

3 
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Edit | Details | 

Delete 

2021 

Composition 

3 

English 

Edit | Details | 

Delete 


Select ile ilgili verileri yükleme 

onGetAsync yöntemi, inciude yöntemiyle ilgili verileri yükler, select yöntemi, yalnızca gerekli ilgili verileri 
yükleyen bir alternatiftir. Tek öğeler için, Department.Name gibi bir SQL İç BİRLEŞİMİ kullanır.Koleksiyonlar 
için, başka bir veritabanı erişimi kullanır, ancak koleksiyonlar üzerinde inciude işleci olur. 


Aşağıdaki kod select yöntemiyle ilgili verileri yükler: 

public IList<CourseViewModel> CourseVM { get; set; } 

public async Task OnGetAsync() 

{ 

CourseVM = await _context.Courses 

.Select(p => new CourseViewModel 
{ 

CourselD = p.CourselD, 

Title = p.Title, 

Credits = p.Credits, 

DepartmentName = p.Department.Name 
}).ToListAsync(); 

} 


CourseViewModel : 


public class CourseViewModel 
{ 

public int CourselD { get; set; } 
public string Title { get; set; } 
public int Credits { get; set; } 
public string DepartmentName { get; set; } 

} 


Tüm örnek için bkz. ındexselect. cshtml ve lndexSelect.cshtml.cs . 


Eğitmen sayfaları oluşturma 












Bu bölüm, eğitmen sayfalarını derler ve ilgili Kurslar ve kayıtları eğitmenler dizin sayfasına ekler. 
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Bu sayfa aşağıdaki yollarla ilgili verileri okur ve görüntüler: 

• Eğitmenler listesi OfficeAssignment varlığındaki ilgili verileri (önceki görüntüde Office) görüntüler. 

Instructor ve officeAssignment varlıkları bire sıfır veya-bir ilişkidir. OfficeAssignment varlıkları için Eager 
yüklemesi kullanılır. Eager yüklemesi, ilgili verilerin görüntülenmesi gerektiğinde genellikle daha etkilidir. 
Bu durumda, Eğitmenler için Office atamaları görüntülenir. 

• Kullanıcı bir eğitmen seçtiğinde ilgili course varlıkları görüntülenir. ınstructor ve course varlıkları 
çoktan çoğa bir ilişkidir. Eager yüklemesi, course varlıkları ve ilgili Department varlıkları için kullanılır. Bu 
durumda, yalnızca seçili eğitmen için kurslar gerektiğinden ayrı sorgular daha verimli olabilir. Bu örnek, 
gezinti özelliklerinde olan varlıklarda gezinti özellikleri için Eager yükleme 'nin nasıl kullanılacağını gösterir. 

• Kullanıcı bir kurs seçtiğinde Enroiiments varlığındaki ilgili veriler görüntülenir. Önceki görüntüde öğrenci 
adı ve sınıf görüntülenir, course ve Enroiiment varlıkları bire çok ilişkidir. 

Görünüm modeli oluşturma 

Eğitmenler sayfasında, üç farklı tablodan alınan veriler gösterilir. Üç tabloyu temsil eden üç özellik içeren bir 

görünüm modeli gerekir. 

Aşağıdaki kodla SchoolViewModels/ıncpctormdexdata. cs oluşturun: 

















using System; 

using System.Collections.Generic; 

using System.Linq; 

using System.Threading.Tasks; 


namespace ContosoUniversity.Models.SchoolViewModels 
{ 

public class InstructorIndexData 
{ 

public IEnumerable<Instructor> Instructors { get; set; } 
public IEnumerable<Course> Counses { get; set; } 
public IEnumerable<Enrollment> Enrollments { get; set; } 

} 


Yapı iskelesi eğitmeni sayfaları 

• Visual Studio 

• Visual Studio Code 

• Öğrenci sayfalarını aşağıdaki özel durumlarla birlikte Scaffold içindeki yönergeleri izleyin: 

o Bir sayfa/eğitmenler klasörü oluşturun, 
o Model sınıfı için instructor kullanın. 

o Yeni bir tane oluşturmak yerine var olan bağlam sınıfını kullanın. 

Yapı iskelesi sayfasının güncelleştirmeden önce nasıl göründüğünü görmek için, uygulamayı çalıştırın ve 
eğitmenler sayfasına gidin. 

Pages/eğitmenler/lndex. cshtml. cs dosyasını aşağıdaki kodla güncelleştirin: 





using ContosoUniversity.Models; 

using ContosoUniversity.Models.SchoolViewModels; // Add VM 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using Microsoft.EntityFrameworkCore; 

using System.Linq; 

using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Instructors 

{ 

public class IndexModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public IndexModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

public InstructorIndexData InstructorData { get; set; } 
public int InstructorlD { get; set; } 
public int CourselD { get; set; } 

public async Task OnGetAsync(int? id, int? courselD) 

{ 

InstructorData = new InstructorIndexData(); 

InstructorData.Instructors = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Department) 

.Include(i => İ.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Enrollments) 

.Thenlnclude(i => i.Student) 

.AsNoTracking() 

.OrderBy(i => i.LastName) 

.ToListAsync(); 

if (id != null) 

{ 

InstructorlD = id.Value; 

Instructor instructor = InstructorData.Instructors 
.Where(i => i.ID == id.Value).Single(); 

InstructorData.Courses = instructor.CourseAssignments.Select(s => s.Course); 

} 

if (courselD != null) 

{ 

CourselD = courselD.Value; 

var selectedCourse = InstructorData.Courses 

.Where(x => x.CourselD == courselD).Single(); 

InstructorData.Enrollments = selectedCourse.Enrollments; 

} 

} 

} 

} 

onGetAsync yöntemi, seçilen eğitmenin KİMLİĞİ için isteğe bağlı rota verilerini kabul eder. 
Pages/eğitmenler/!ndex. cshtml. cs dosyasındaki sorguyu inceleyin: 


InstructorData.Instructors = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Department) 

.Include(i => İ.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Enrollments) 
.Thenlnclude(i => i.Student) 

.AsNoTracking() 

.OrderBy(i => i.LastName) 

.ToListAsync(); 


Kod, aşağıdaki gezinti özellikleri için Eager yüklemeyi belirtir: 


• Instructor.OfficeAssignment 

• Instructor.CourseAssignments 
o CourseAssignments.Course 

o Course.Department 
o Course.Enrollments 
o Enrollment.Student 

courseAssignments ve Course için inciude ve Theninciude yöntemlerinin yinelendiğine dikkat edin. Bu 
yineleme, course varlığının iki gezinti özelliği için Eager yüklemesi belirtmek için gereklidir. 

Aşağıdaki kod, bir eğitmen seçildiğinde (id ! = nuiı ) yürütülür. 

if (id != null) 

{ 

InstructorlD = id.Value; 

Instructor instructor = InstructorData.Instructors 
.Where(i => i.ID == id.Value).Single(); 

InstructorData.Courses = instructor.CourseAssignments.Select(s => s.Course); 

} 

Seçilen eğitmen, görünüm modelindeki eğitmenler listesinden alınır.Görünüm modelinin courses özelliği, bu 
eğitmenin CourseAssignments gezinti özelliğinden course varlıklarla birlikte yüklenir. 

where yöntemi bir koleksiyon döndürür. Ancak bu durumda filtre tek bir varlık seçer. Bu nedenle, koleksiyonu 
tek bir instructor varlığına dönüştürmek için single yöntemi çağırılır, instructor varlığı 
CourseAssignments özelliğine erişim sağlar. CourseAssignments ilgili Course varlıklarına erişim sağlar. 
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Koleksiyonda yalnızca bir öğe olduğunda single yöntemi bir koleksiyonda kullanılır. Koleksiyon boşsa veya 
birden fazla öğe varsa single yöntemi bir özel durum oluşturur. Bir alternatif, koleksiyon boşsa varsayılan bir 
değer (Bu durumda null) döndüren singleOnDefault . 

Aşağıdaki kod, bir kurs seçildiğinde görünüm modelinin Enrollments özelliğini doldurur: 

if (courselD != null) 

{ 

CourselD = courselD.Value; 

var selectedCourse = InstructorData.Courses 

.Where(x => x.CourselD == courselD).Single(); 

InstructorData.Enrollments = selectedCourse.Enrollments; 

} 


Eğitmenler Dizin sayfasını Güncelleştir 

Pages/eğitmenler/lndex. cshtml dosyasını aşağıdaki kodla güncelleştirin. 

@page "{id:int?}" 

@model Contosollniversity. Pages. Instructors. IndexModel 

@{ 

ViewData["Title"] = "Instructors"; 

} 

<h2>Instructors</h2> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

ctable class="table"> 

<thead> 

<tr> 

<th>Last Name</th> 

<th>First Name</th> 























<th>Hire Date</th> 

<th>Office</th> 

<th>Courses</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model.InstructorData.Instructors) 

{ 

string selectedRow = 

if (item.ID == Model.InstructorlD) 

{ 

selectedRow = "table-success"; 

} 

<tn class="@selectedRow"> 

<td> 

@Html.DisplayFor(modelItem => item.LastName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.FirstMidName) 

</td> 

<td> 

@Fltml.DisplayFor(modelItem => item.FlireDate) 

</td> 

<td> 

@if (item.OfficeAssignment != null) 

{ 

@item.OfficeAssignment.Location 

} 

</td> 

<td> 

@{ 

foreach (var course in item.CourseAssignments) 

{ 

@course.Course.CourselD (Şcourse.Course.Title <br /> 

} 

} 

</td> 

<td> 

<a asp-page="./Index" asp-route-id="@item.ID">Select</a> | 

<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID">Details</a> | 

<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 

@if (Model.InstructorData.Courses != null) 

{ 

<h3>Courses Taught by Selected Instructor</h3> 

<table class="table"> 

<tr> 

<thx/th> 

<th>Number</th> 

<th>Title</th> 

<th>Department</th> 

</tr> 

@foreach (var item in Model.InstructorData.Courses) 

{ 

string selectedRow = 

if (item.CourselD == Model.CourselD) 

{ 

selectedRow = "table-success "; 

} 

<tr class="@selectedRow"> 

<td> 


<a asp-page="./Index" asp-route-courseID="@item.CourseID">Select</a> 
</td> 

<td> 

@item.CourseID 

</td> 

<td> 

@item.Title 

</td> 

<td> 

@item.Department.Name 

</td> 

</tr> 

} 

</table> 


@if (Model.InstructorData.Enrollments != null) 

{ 

<h3> 

Students Enrolled in Selected Course 
</h3> 

<table class="table"> 

<tr> 

<th>Name</th> 

<th>Grade</th> 

</tr> 

(Şforeach (var item in Model.InstructorData.Enrollments) 

{ 

<tr> 

<td> 

@item.Student.FullName 
</td> 

<td> 

@Html.DisplayFor(modelItem => item.Grade) 
</td> 

</tr> 

} 

</table> 


Yukarıdaki kod aşağıdaki değişiklikleri yapar: 

• Güncelleştirmeleri page gelen yönerge @page için @page "{id:int?}" . "{id:int?}" bir rota 
şablonudur. Yol şablonu, verileri yönlendirmek için URL 'deki tamsayı Sorgu dizelerini değiştirir. 
Örneğin, yalnızca @page yönergesine sahip bir eğitmenin Select bağlantısına tıkladığınızda 
aşağıdakiler gibi bir URL üretilir: 


https://localhost:5001/Instructors?id=2 

Sayfa yönergesi @page "{id:int?}" olduğunda URL şu şekilde olur: 
https://localhost:5001/Instructors/2 

• Yalnızca item.OfficeAssignment null olmaması durumunda item.OfficeAssignment.Location 

görüntüleyen bir Office sütunu ekler. Bu bire sıfır veya-bir ilişki olduğundan ilgili bir OfficeAssignment 
varlığı bulunmayabilir. 

@if (İtem.OfficeAssignment != null) 

{ 

@item.OfficeAssignment.Location 

} 












• Her bir eğitmen tarafından taders kurslarını görüntüleyen bir Kurslar sütunu ekler. Bu Razor sözdizimi 
hakkında daha fazla bilgi için bkz. açık hat geçişi . 

• Seçilen eğitmenin ve kursun tr öğesine dinamik olarak ciass="success" ekleyen kodu ekler. Bu, bir 
önyükleme sınıfı kullanarak seçili satır için bir arka plan rengi ayarlar. 

string selectedRow = 
if (item.CourselD == Model.CourselD) 

{ 

selectedRow = "success"; 

} 

<tr class="@selectedRow"> 


Selectetiketli yeni bir köprü ekler. Bu bağlantı, seçilen eğitmenin KİMLİĞİNİ 
gönderir ve bir arka plan rengi ayarlar. 

Index 

yöntemine 

<a asp-action="Index" asp-route-id="@item.ID">Select</a> | 


• Seçili eğitmen için bir kurs tablosu ekler. 

• Seçili kurs için bir öğrenci kayıtları tablosu ekler. 

Uygulamayı çalıştırın ve eğitmenler sekmesini seçin. Sayfada ilgili officeAssignment varlığındaki Location 
(Office) görüntülenir. officeAssignment null ise boş bir tablo hücresi görüntülenir. 

Bir eğitmenin Seç bağlantısına tıklayın. Bu eğitmenin atandığı satır stili değişiklikleri ve kurslar görüntülenir. 
Kayıtlı öğrenciler ve bunların onların listesini görmek için bir kurs seçin. 
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Kim 
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Courses Taught by Selected Instructor 



Number 

Title 

Department 


2021 

Composition 

English 

Select 

2042 

Literatüre 

English 

Students Enrolled in Selected Course 


Name 



Grade 

Alonso, Meredith 


B 

Li, Yan 



B 


Tek kullanımı 


single yöntemi, where yöntemini ayrı çağırmak yerine where koşulunu geçirebilir: 







public async Task OnGetAsync(int? id, int? courselD) 

{ 

InstructorData = new InstructorIndexData(); 

InstructorData.Instructors = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Department) 

.Include(i => İ.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Enrollments) 

.Thenlnclude(i => i.Student) 

.AsNoTracking() 

.OrderBy(i => i.LastName) 

.ToListAsync(); 

if (id != null) 

{ 

InstructorlD = id.Value; 

Instructor instructor = InstructorData.Instructors.Single( 
i => i.ID == id.Value); 

InstructorData.Courses = instructor.CourseAssignments.Select( 
s => s.Course); 

} 

if (courselD != null) 

{ 

CourselD = courselD.Value; 

InstructorData.Enrollments = InstructorData.Courses.Single( 
x => x.CourselD == courselD).Enrollments; 

} 

} 

VVhere koşulunun kişisel tercihle ilgili olduğu single kullanımı. where yöntemi kullanılarak herhangi bir 
avantaj sağlamaz. 


Açık yükleme 



Kullanıcıların bir kursa kayıtları nadiren görmek istediğini varsayalım. Bu durumda, bir iyileştirme yalnızca 
isteniyorsa kayıt verilerini yüklemek olacaktır. Bu bölümde onGetAsync , Enrollments ve students açık 
yüklemesini kullanacak şekilde güncelleştirilir. 

Pages/eğitmenler/lndex. cshtml. cs dosyasını aşağıdaki kodla güncelleştirin. 










using ContosoUniversity.Models; 

using ContosoUniversity.Models.SchoolViewModels; // Add VM 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using Microsoft.EntityFrameworkCore; 

using System.Linq; 

using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Instructors 

{ 

public class IndexModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public IndexModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

public InstructorIndexData InstructorData { get; set; } 
public int InstructorlD { get; set; } 
public int CourselD { get; set; } 

public async Task OnGetAsync(int? id, int? courselD) 

{ 

InstructorData = new InstructorIndexData(); 

InstructorData.Instructors = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Department) 

//.Include(i => İ.CourseAssignments) 

// .Thenlnclude(i => i.Course) 

// .Thenlnclude(i => i.Enrollments) 

// .Thenlnclude(i => i.Student) 

//.AsNoTracking() 

.OrderBy(i => i.LastName) 

.ToListAsync(); 

if (id != null) 

{ 

InstructorlD = id.Value; 

Instructor instructor = InstructorData.Instructors 
.Where(i => i.ID == id.Value).Single(); 

InstructorData.Courses = instructor.CourseAssignments.Select(s => s.Course); 

} 

if (courselD != null) 

{ 

CourselD = courselD.Value; 

var selectedCourse = InstructorData.Courses 

.Where(x => x.CourselD == courselD).Single(); 
await _context.Entry(selectedCourse).Collection(x => x.Enrollments).LoadAsync(); 
foreach (Enrollment enrollment in selectedCourse.Enrollments) 

{ 

await _context.Entry(enrollment).Reference(x => x.Student).LoadAsync(); 

} 

InstructorData.Enrollments = selectedCourse.Enrollments; 

} 

} 

} 

} 


Yukarıdaki kod, kayıt ve öğrenci verileri için Thenmclude Yöntem çağrılarını bırakır. Bir kurs seçilirse, açık 
yükleme kodu alır: 


• Seçili kurs için Enrollment varlıkları. 




• Her bir Enroiiment için student varlıkları. 


Yukarıdaki kod yorumlarının .AsNoTrackingO dikkat edin. Gezinti özellikleri yalnızca izlenen varlıklar için açık 
bir şekilde yüklenebilir. 

Uygulamayı test edin. Bir kullanıcının perspektifinden, uygulama önceki sürümle aynı şekilde davranır. 

Sonraki adımlar 

Sonraki öğreticide ilgili verileri güncelleştirme gösterilmektedir. 


ÖNCEKİ ■ SONRAKİ 

ÖĞRETİCİ ■ ÖĞRETİCİ 


Bu öğreticide ilgili veriler okundu ve görüntülenir, ilgili veriler, EF Core gezinti özelliklerine yüklediği veri. 

Olamaz çözmenize, sorunlarla karşılaşırsanız, indirin veya tamamlanmış uygulamayı görüntüleyin. Yükleme 
yönergeleri. 

Aşağıdaki çizimler, Bu öğreticinin tamamlanan sayfalarını göstermektedir: 
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Courses Taught by Selected Instructor 
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Department 
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1050 
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Students Enrolled in Selected Course 


Name 
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No grade 
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B 
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İlgili verilerin Eager, açık ve geç yüklemesi 

EF Core bir varlığın gezinti özelliklerine ilgili verileri yükleyebilmenin birkaç yolu vardır: 

• Eager yükleniyor. Ekip yükleme, bir varlık türü için bir sorgu aynı zamanda ilgili varlıkları de 

yüklediğinde oluşur. Varlık okunmadığınızda ilgili veriler alınır. Bu, genellikle gereken tüm verileri alan 
tek bir JOIN sorgusuna neden olur. EF Core, bazı Eager yükleme türleri için birden çok sorgu 
yayımlayacak. Birden çok sorgu verilmesi, EF6 içindeki bazı sorgular için tek bir sorgunun bulunduğu 
















durumda daha verimli olabilir, inciude ve Theninciude yöntemleriyle Eager yüklemesi belirtildi. 


var departments = _context.Departments.Include(d => d.courses); 
foreach (Department d in departments), 

foreach(course c in d.courses) Query: ali Department entities 


{ 


courseList.Add(d.Name + c.Title); 


le); V. 


and related Course entities 



> 


Bir koleksiyon gezintisi eklendiğinde Eager yüklemesi birden çok sorgu gönderir: 


o Ana sorgu için bir sorgu 

o Yükleme ağacındaki her koleksiyon "Edge" için bir sorgu. 

• Sorguları Load ile ayırın: veriler ayrı sorgularda alınabilir ve EF Core "düzeltmeler"' i "düzeltir", 
"düzeltmeler", EF Core gezinti özelliklerini otomatik olarak dolduran anlamına gelir. Load ile ayrı 
sorgular, ek yükleme Eager 'dan daha da benzer. 


var departments = _context.Departments; 
foreach (Department d in departments)- 
{ 




Query: ali Department rows 


J 


-C 


Lo^d(); 


_context.Courses.Where(c => c.DepartmentlD == d.DepartmentlD). Lojd(); 
foreach (Course c in d.Courses) 

{ 

courseList.Add(d.Name + c.Title); 

} 


Query: Course rows related to Department d 


J 


Note: EF Core, daha önce bağlam örneğine yüklenmiş olan diğer varlıklar için gezinti özelliklerini 
otomatik olarak düzeltir. Bir gezinti özelliği için veriler açıkça dahil edilmese bile, ilgili varlıkların bazıları 
veya tümü daha önce yüklenmişse Özellik yine de doldurulabilir. 


• Açık yükleme. Varlık ilk kez okunmadıysa ilgili veriler alınmadı. Gerektiğinde ilgili verileri almak için 
kodun yazılması gerekir. Ayrı sorgularla açık yükleme, VERITABANıNA birden çok sorgu 
gönderilmesine neden olur. Açık yükleme ile kod, yüklenecek gezinti özelliklerini belirtir. Açık yükleme 
yapmak için Load yöntemini kullanın. Örneğin: 


var departments = _context.Departments; 
foreach (Department d in departments) 

{ 


Query: ali Department rows 


J 


_context.Entry(d).Collection(p => p.Courses).Load(); 

foreach (Course c in d.courses) ^^ mmmm _ 

{ I Query: Course rows related to Department 

_ 


courseList.Add(d.Name + c.Title); 


} 



• Yavaş yükleme. Sürüm 2,1 ' de EF Core geç yükleme eklendi. Varlık ilk kez okunmadıysa ilgili veriler 
alınmadı. Gezinti özelliğine ilk kez erişildiğinde, bu gezinti özelliği için gereken veriler otomatik olarak 
alınır. Bir gezinti özelliğine ilk kez erişildiğinde bir sorgu VERITABANıNA gönderilir. 

• Select işleci yalnızca gerekli ilgili verileri yükler. 


Bölüm adını görüntüleyen bir kurs sayfası oluşturma 

Kurs varlığı, Department varlığını içeren bir gezinti özelliği içerir. Department varlığı, kursun atandığı 
departmanı içerir. 

Bir kurs listesinde atanan departmanın adını göstermek için: 
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Kurs modelini temklesi 

• Visual Studio 

• Visual Studio Code 

Bölümündeki yönergeleri Öğrenci modeli iskelesini ve course model sınıfı için. 

Önceki komut iskelesini kurar course modeli. Projeyi Visual Studio'da açın. 

Pages/kurslar/lndex. cshtml. cs dosyasını açın ve onGetAsync metodunu inceleyin. Yapı iskelesi altyapısı, 
Department gezinti özelliği için bir yükleme belirtti, inciude yöntemi Eager yüklemeyi belirtir. 

Uygulamayı çalıştırın ve Kurslar bağlantısını seçin. Departman sütunu, yararlı olmayan DepartmentlD 
görüntüler. 

OnGetAsync yöntemini aşağıdaki kodla güncelleştirin: 

public async Task OnGetAsync() 

{ 

Course = await _context.Courses 
.Include(c => c.Department) 

.AsNoTracking() 

.ToListAsync(); 

} 

Yukarıdaki kod AsNoTracking ekler. AsNoTracking , döndürülen varlıklar izlenmediğinden performansı geliştirir. 
Geçerli bağlamda güncelleştirilmemiş oldukları için varlıklar izlenmiyor. 

Pages/kurslar/lndex. cshtml 'yi aşağıdaki vurgulanmış işaretlerle güncelleştirin: 



















@page 

@model ContosoUniversity. Pages.Courses.IndexModel 

@{ 

ViewData["Title"] = "Courses"; 

} 

<h2>Courses</h2> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<table class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model => model.Course[0].CourselD) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Course[0].Title) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Course[0].Credits) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Course[0].Department) 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model.Course) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.CourselD) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Credits) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Department.Name) 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.CourseID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.CourseID">Details</a> | 
<a asp-page="./Delete" asp-route-id="@item.CourselD">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 


Yapı iskelesi kodunda aşağıdaki değişiklikler yapılmıştır: 

• Başlık dizinden kurslar olarak değiştirildi. 

• CourselD özellik değerini gösteren bir sayı sütunu eklendi. Birincil anahtarlar, genellikle son 
kullanıcılara anlamlı olduklarından, varsayılan olarak yapı iskelesi göstermemektedir. Ancak, bu 
durumda birincil anahtar anlamlı olur. 

• Departman adını göstermek için Departman sütunu değiştirildi. Kod, Department gezinti özelliğine 
yüklenen Department varlığının Name özelliğini görüntüler: 







@Html.DisplayFor(modelItem => item.Department.Name) 


Uygulamayı çalıştırın ve bölüm adlarıyla listeyi görmek için Kurslar sekmesini seçin. 


H Courses - Contoso Univ X + 


□ X 

^ I localhost: 5813/1 

☆ 

=- m 

■••••■ 

Contoso University 


— 


Courses 


Create New 


Number 

Title 

Credits 

Department 


1045 

Calculus 

4 

Mathematics 

Edit | Details | Delete 

1050 

Chemistry 

3 

Engineering 

Edit | Details | Delete 

2021 

Composition 

3 

English 

Edit | Details | Delete 







Select ile ilgili verileri yükleme 

onGetAsync yöntemi inciude yöntemiyle ilgili verileri yükler: 

public async Task OnGetAsync() 

{ 

Course = await _context.Courses 
.Include(c => c.Department) 

.AsNoTracking() 

.ToListAsync(); 

} 

Select işleci yalnızca gerekli ilgili verileri yükler. Tek öğeler için, Department.Name gibi bir SQL İç BİRLEŞİMİ 
kullanır. Koleksiyonlar için, başka bir veritabanı erişimi kullanır, ancak koleksiyonlar üzerinde inciude işleci 
olur. 

Aşağıdaki kod select yöntemiyle ilgili verileri yükler: 

public IList<CourseViewModel> CourseVM { get; set; } 

public async Task OnGetAsync() 

{ 

CourseVM = await _context.Courses 

.Select(p => new CourseViewModel 

{ 

CourselD = p.CourselD, 

Title = p.Title, 

Credits = p.Credits, 

DepartmentName = p.Department.Name 
}).ToListAsync(); 

} 


CourseViewModel : 













public class CourseViewModel 
{ 

public int CourselD { get; set; } 
public string Title { get; set; } 
public int Credits { get; set; } 
public string DepartmentName { get; set; } 

} 


Tüm örnek için bkz. ındexselect. cshtml ve lndexSelectcshtml.cs . 

Kurslar ve kayıtları gösteren bir eğitmenler sayfası oluşturun 

Bu bölümde, Eğitmenler sayfası oluşturulur. 




(Svrsfî — 

□ 

X 

Instructors - Contoso U- X 


<r -> C 

© localhost:1234/lnstructors/3?courselD=1050&action=OnGetAsync 


Contoso University 

- 

- 


Instructors 


Create New 


Last Name 

First 

Name 

Hire 

Date 

Office 

Courses 


APercrombie 

Kim 

1995-03- 

11 


2021 Composition 
2042 Literatüre 

Select | Edit | Details | 
Delete 

Fakhouri 

Fadi 

2002-07- 

06 

Smith 17 

1045 Calculus 

Select | Edit | Details | 
Delete 

Hami 

Roger 

1998-07- 

01 

Govvan 27 

1050 Chemistry 
3141 Trigonometry 

1 1 1 Edit I Details I 

Delete 

Kapoor 

Candace 

2001-01- 

15 

Thompson 

304 

1050 Chemistry 

Select | Edit | Details | 

Delete 

Zheng 

Roger 

2004-02- 

12 


4022 

Microeconomics 

4041 

Macroeconomics 

Select | Edit | Details | 
Delete 


Courses Taught by Selected Instructor 



Number 

Title 

Department 

Select 

1050 

Chemistry 

Engineering 

Select 

3141 

Trigonometry 

Mathematics 


Students Enrolled in Selected Course 


Name 

Grade 

Alexander, Carson 

A 

Anand, Arturo 

No grade 

Barzdukas, Gytis 

B 
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Bu sayfa aşağıdaki yollarla ilgili verileri okur ve görüntüler: 



yüklemesi kullanılır. Eager yüklemesi, ilgili verilerin görüntülenmesi gerektiğinde genellikle daha etkilidir. 
Bu durumda, Eğitmenler için Office atamaları görüntülenir. 

• Kullanıcı bir eğitmen (önceki görüntüde Haruı) seçtiğinde ilgili course varlıkları görüntülenir. Instructor 


Course 

varlıkları çoktan çoğa bir ilişkidir. Eager yüklemesi, 

Course 

varlıkları ve ilgili 

Department 
























varlıkları için kullanılır. Bu durumda, yalnızca seçili eğitmen için kurslar gerektiğinden ayrı sorgular daha 
verimli olabilir. Bu örnek, gezinti özelliklerinde olan varlıklarda gezinti özellikleri için Eager yükleme 'nin 
nasıl kullanılacağını gösterir. 


• Kullanıcı bir kurs seçtiğinde (önceki görüntüde kimsiz deneme), 

Enrollments 

varlığındaki ilgili veriler 

görüntülenir. Önceki görüntüde öğrenci adı ve sınıf görüntülenir. 

. Course 

ve 

Enrollment 

varlıkları bire çok 


ilişkidir. 

Eğitmen dizini görünümü için bir görünüm modeli oluşturun 

Eğitmenler sayfasında, üç farklı tablodan alınan veriler gösterilir. Üç tabloyu temsil eden üç varlığı içeren bir 
görünüm modeli oluşturulur. 

SchoolVievvModels klasöründe, aşağıdaki kodla lnstructorlndexData.cs oluşturun: 

using System; 

using System.Collections.Generic; 

using System.Linq; 

using System.Threading.Tasks; 

namespace ContosoUniversity.Models.SchoolViewModels 
{ 

public class InstructorIndexData 
{ 

public IEnumerable<Instructor> Instructors { get; set; } 
public IEnumerable<Course> Courses { get; set; } 
public IEnumerable<Enrollment> Enrollments { get; set; } 

} 

} 

Eğitmen modelini scafkatlama 

• Visual Studio 

• Visual Studio Code 

Bölümündeki yönergeleri Öğrenci modeli iskelesini ve instructor model sınıfı için. 

Önceki komut iskelesini kurar instructor modeli. Uygulamayı çalıştırın ve eğitmenler sayfasına gidin. 
Pages/eğitmenler/lndex. cshtml. cs öğesini şu kodla değiştirin: 









using ContosoUniversity.Models; 

using ContosoUniversity.Models.SchoolViewModels; // Add VM 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using Microsoft.EntityFrameworkCore; 

using System.Linq; 

using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Instructors 

{ 

public class IndexModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public IndexModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

public InstructorIndexData Instructor { get; set; } 
public int InstructorlD { get; set; } 

public async Task OnGetAsync(int? id) 

{ 

Instructor = new InstructorIndexData(); 

Instructor.Instructors = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.AsNoTrackingO 
.OrderBy(i => i.LastName) 

.ToListAsync(); 

if (id != null) 

{ 

InstructorlD = id.Value; 

} 

} 

} 

} 

onGetAsync yöntemi, seçilen eğitmenin KİMLİĞİ için isteğe bağlı rota verilerini kabul eder. 
Pages/eğitmerıler/lndex. cshtml. cs dosyasındaki sorguyu inceleyin: 

Instructor.Instructors = await _context.Instructors 
.Include(i => İ.OfficeAssignment) 

.Include(i => İ.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.AsNoTrackingO 
.OrderBy(i => İ.LastName) 

.ToListAsync(); 


Sorgunun iki içerme vardır: 

• officeAssignment : eğitmenler görünümündegörüntülenir. 

• courseAssignments : kurslar taöğretme. 

Eğitmenler Dizin sayfasını Güncelleştir 

Sayfalan/eğitmenler/!ndex. cshtml 'yi şu biçimlendirmeyle güncelleştirin: 




@page "{id:int?}" 

@model Contosollniversity.Pages.Instructors.IndexModel 

@{ 

ViewData["Title"] = "Instructors"; 

} 

<h2>Instructors</h2> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

ctable class="table"> 

<thead> 

<tr> 

<th>Last Name</th> 

<th>First Name</th> 

<th>Hire Date</th> 

<th>Office</th> 

<th>Courses</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model.Instructor.Instructors) 

{ 

string selectedRow = 

if (item.ID == Model.InstructorlD) 

{ 

selectedRow = "success"; 

} 

<tr class="@selectedRow"> 

<td> 

@Html.DisplayFor(modelItem => item.LastName) 

</td> 

<td> 

@Fltml.DisplayFor(modelItem => item.FirstMidName) 

</td> 

<td> 

@Fltml.DisplayFor(modelItem => item.FlireDate) 

</td> 

<td> 

@if (item.OfficeAssignment != null) 

{ 

(Şitem.OfficeAssignment. Location 

} 

</td> 

<td> 

foreach (var course in item.CourseAssignments) 

{ 

@course.Course.CourselD @course.Course.Title <br /> 

} 

} 

</td> 

<td> 

<a asp-page="./Index" asp-route-id="@item.ID">Select</a> | 

<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.ID">Details</a> | 

<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 



Önceki biçimlendirme, aşağıdaki değişiklikleri yapar: 


• Güncelleştirmeleri page gelen yönerge @page için @page "{id:int?}" . "{id:int?}" bir rota 
şablonudur. Yol şablonu, verileri yönlendirmek için URL 'deki tamsayı Sorgu dizelerini değiştirir. 
Örneğin, yalnızca @page yönergesine sahip bir eğitmenin Select bağlantısına tıkladığınızda 
aşağıdakiler gibi bir URL üretilir: 

http://localhost:1234/Instructors?id=2 

Sayfa yönergesi @page "{id:int?}" olduğunda, önceki URL şu şekilde olur: 
http://localhost:1234/Instructors/2 

• Sayfa başlığı eğitmenler 1 dir. 

• Yalnızca item.OfficeAssignment null olmaması durumunda item.OfficeAssignment.Location 
görüntüleyen bir Office sütunu eklendi. Bu bire sıfır veya-bir ilişki olduğundan ilgili bir 
OfficeAssignment varlığı bulunmayabilir. 

@if (item.OfficeAssignment != null) 

{ 

@item.OfficeAssignment.Location 

} 

• Her bir eğitmen tarafından taders kurslarını görüntüleyen bir Kurslar sütunu eklendi. Bu Razor 
sözdizimi hakkında daha fazla bilgi için bkz. açık hat geçişi. 

• Seçilen eğitmenin tr öğesine dinamik olarak ciass="success" ekleyen kod eklendi. Bu, bir önyükleme 
sınıfı kullanarak seçili satır için bir arka plan rengi ayarlar. 

stning selectedRow = 
if (item.CounselD == Model.CounselD) 

{ 

selectedRow = "success"; 

} 

<tr class="@selectedRow"> 


Selectetiketli yeni bir köprü eklendi. Bu bağlantı, seçilen eğitmenin KİMLİĞİNİ 
gönderir ve bir arka plan rengi ayarlar. 

Index 

yöntemine 

<a asp-action="Index" asp-route-id="@item.ID">Select</a> | 


Uygulamayı çalıştırın ve eğitmenler sekmesini seçin. Sayfada ilgili OfficeAssignment varlığındaki Location 
(Office) görüntülenir. Eğer OfficeAssignment 1 null ise boş bir tablo hücresi görüntülenir. 

Seç bağlantısına tıklayın. Satır stili değişir. 

Seçili eğitmen 'e göre kurslar ekleyin 

Pages/eğitmenler/!ndex. cshtml. cs dosyasındaki onGetAsync yöntemini aşağıdaki kodla güncelleştirin: 

















public async Task OnGetAsync(int? id, int? courselD) 

{ 

instructor = new InstructorIndexData(); 
instructor.Instructors = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Department) 

.AsNoTrackingO 
.OrderBy(i => i.LastName) 

.ToListAsync(); 

if (id != null) 

{ 

InstructorlD = id.Value; 

Instructor instructor = Instructor.Instructors.Where( 
i => i.ID == id.Value).Single(); 
instructor.Courses = instructor.CourseAssignments.Select(s => 


if (courselD != null) 

{ 

CourselD = courselD.Value; 

instructor.Enrollments = instructor.Courses.Where( 

x => x.CourselD == courselD).Single().Enrollments; 

} 

} 

public int CourselD { get; set; } Ekle 


s.Course); 


public class IndexModel : PageModel 

{ 

private readonly Contosollniversity.Data.SchoolContext _context; 

public IndexModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

public InstructorIndexData instructor { get; set; } 
public int InstructorlD { get; set; } 
public int CounselD { get; set; } 

public async Task OnGetAsync(int? id, int? courselD) 

{ 

Instructor = new InstructorIndexData(); 

Instructor.Instructors = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Department) 

.AsNoTrackingO 
.OrderBy(i => i.LastName) 

.ToListAsync(); 

if (id != null) 

{ 

InstructorlD = id.Value; 

Instructor instructor = instructor.Instructors.Where( 
i => i.ID == id.Value).Single(); 

instructor.Courses = instructor.CourseAssignments.Select(s => s.Course); 

} 

if (courselD != null) 

{ 

CourselD = courselD.Value; 

instructor.Enrollments = instructor.Courses.Where( 

x => x.CourselD == courselD).Single().Enrollments; 

} 

} 


Güncelleştirilmiş sorguyu inceleyin: 

Instructor.Instructors = await _context.Instructors 
.Include(i => İ.OfficeAssignment) 

.Include(i => İ.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Department) 

.AsNoTrackingO 
.OrderBy(i => i.LastName) 

.ToListAsync(); 

Yukarıdaki sorgu Department varlıklarını ekler. 

Aşağıdaki kod, bir eğitmen seçildiğinde (id ! = null ) yürütülür.Seçilen eğitmen, görünüm modelindeki 
eğitmenler listesinden alınır. Görünüm modelinin courses özelliği, bu eğitmenin courseAssignments gezinti 
özelliğinden course varlıklarla birlikte yüklenir. 











if (id != null) 

{ 

InstructorlD = id.Value; 

instructor instructor = instructor.Instructors.Where( 
i => i.ID == id.Value).Single(); 

Instnuctor.Courses = instructor.CourseAssignments.Select(s => s.Course); 

} 


where yöntemi bir koleksiyon döndürür. Önceki 

where yönteminde yalnızca tek bir 

instructor 

varlığı 

döndürülür, single 

yöntemi, koleksiyonu tek bir 

instructor 

varlığına dönüştürür. 

instructor 

varlığı 

CourseAssignments 

özelliğine erişim sağlar. CourseAssignments 

ilgili course varlıklarına erişim sağlar. 


İnstructor 


Properties 
yî İD 

A LastName 
A FirstMidName 
A HireDate 
Navigation Properties 
y3 CourseAssignments 
y3 OfficeAssignment 

fi 

_ 1 *_ 


CourseAssignment 


Properties 
A CourselD 
A InstructorlD 


Navigation Properties 
y3 Course 
y3 İnstructor 


Course 


Properties 
1 yt CourselD 
A Title 
A Credits 
A DepartmentlD 
Navigation Properties 
y3 Department 
y3 Enrollments 
yll CourseAssignments 


Koleksiyonda yalnızca bir öğe olduğunda single yöntemi bir koleksiyonda kullanılır. Koleksiyon boşsa veya 
birden fazla öğe varsa single yöntemi bir özel durum oluşturur. Bir alternatif, koleksiyon boşsa varsayılan bir 
değer (Bu durumda null) döndüren singleOrDefault . Boş bir koleksiyonda singleOrDefault kullanma: 

• Bir özel durumla sonuçlanır (null başvuru üzerinde courses özelliği bulmaya çalışırken). 

• Özel durum iletisi sorunun nedenini daha az gösterir. 

Aşağıdaki kod, bir kurs seçildiğinde görünüm modelinin Enrollments özelliğini doldurur: 

if (courselD != null) 

{ 

CourselD = courselD.Value; 

instructor.Enrollments = instructor.Courses.Where( 

x => x.CourselD == courselD).Single().Enrollments; 

} 

Pages/eğitmenler/lndex. cshtml Razor sayfasının sonuna aşağıdaki biçimlendirmeyi ekleyin: 

































<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 

@if (Model.Instructor.Courses != null) 

{ 

<h3>Courses Taught by Selected Instructor</h3> 

<table class="table"> 

<tr> 

<thx/th> 

<th>Number</th> 

<th>Title</th> 

<th>Department</th> 

</tr> 

@foreach (var item in Model.Instructor.Courses) 

{ 

string selectedRow = 
if (item.CourselD == Model.CourselD) 

{ 

selectedRow = "success"; 

} 

<tr class="@selectedRow"> 

<td> 

<a asp-page="./Index" asp-route-courseID="@item.CourselD">Select</a> 
</td> 

<td> 

@item.CourselD 
</td> 

<td> 

@item.Title 

</td> 

<td> 

@item.Department.Name 

</td> 

</tr> 

} 

</table> 

} 


Yukarıdaki biçimlendirme, bir eğitmen seçildiğinde bir eğitmenin ilgili kursların bir listesini görüntüler. 
Uygulamayı test edin. Eğitmenler sayfasında bir seçme bağlantısına tıklayın. 

Öğrenci verilerini göster 

Bu bölümde, uygulama seçili bir kurs için öğrenci verilerini gösterecek şekilde güncelleştirilir. 

Pages/eğitmenler/lndex. cshtml. cs içindeki onGetAsync yönteminde bulunan sorguyu aşağıdaki kodla 
güncelleştirin: 




Instructor.Instructors = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 
.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Department) 
.Include(i => İ.CourseAssignments) 
.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Enrollments) 
.Thenlnclude(i => i.Student) 

.AsNoTracking() 

.OrderBy(i => i.LastName) 

.ToListAsyncO; 


Güncelleştirme sayfalart/eğitmenler/lndex. cshtmi. Aşağıdaki biçimlendirmeyi dosyanın sonuna ekleyin: 


@if (Model.Instructor.Enrollments != null) 

{ 

<h3> 

Students Enrolled in Selected Course 
</h3> 

<table class="table"> 

<tr> 

<th>Name</th> 

<th>Grade</th> 

</tr> 

@foreach (var item in Model.Instructor.Enrollments) 

{ 

<tr> 

<td> 

@item.Student.FullName 
</td> 

<td> 

@Html.DisplayFor(modelItem => item.Grade) 
</td> 

</tr> 

} 

</table> 


Yukarıdaki biçimlendirme, seçili kursa kayıtlı öğrencilerin bir listesini görüntüler. 

Sayfayı yenileyin ve bir eğitmen seçin. Kayıtlı öğrenciler ve bunların onların listesini görmek için bir kurs seçin. 





□ 

X 

Instructors - Contoso U- X 



<r -> C 

© localhost:1234/lnstructors/3?courselD=1050&action=OnGetAsync 


Contoso University 

- 

- 


Instructors 


Create New 


Last Name 

First 

Name 

Hire 

Date 

Office 

Courses 


Abercrombie 

Kim 

1995-03- 

11 


2021 Composition 
2042 Literatüre 

Select | Edit | Details | 
Delete 

Fakhouri 

Fadi 

2002-07- 

06 

Smith 17 

1045 Calculus 

Select | Edit | Details | 
Delete 

Hami 

Roger 

1998-07- 

01 

Govvan 27 

1050 Chemistry 
3141 Trigonometry 

1 1 1 Edit I Details I 

Delete 

Kapoor 

Candace 

2001-01- 

15 

Thompson 

304 

1050 Chemistry 

Select | Edit | Details | 

Delete 

Zheng 

Roger 

2004-02- 

12 


4022 

Microeconomics 

4041 

Macroeconomics 

Select | Edit | Details | 
Delete 


Courses Taught by Selected Instructor 




Number 

Title 

Department 

Select 


1050 

Chemistry 

Engineering 

Select 


3141 

Trigonometry 

Mathematics 


Students Enrolled in Selected Course 


Name 

Grade 

Aiexander, Carson 

A 

Anand, Arturo 

No grade 

Barzdukas, Gytis 

B 
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Tek kullanımı 


single yöntemi, where yöntemini ayrı çağırmak yerine where koşulunu geçirebilir: 



















public async Task OnGetAsync(int? id, int? courselD) 

{ 

instructor = new InstructorIndexData(); 

Instructor.Instructors = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Department) 

.Include(i => İ.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Enrollments) 

.Thenlnclude(i => i.Student) 

.AsNoTracking() 

.OrderBy(i => i.LastName) 

.ToListAsync(); 

if (id != null) 

{ 

InstructorlD = id.Value; 

Instructor instructor = Instructor.Instructors.Single( 
i => i.ID == id.Value); 

instructor.Courses = instructor.CourseAssignments.Select( 
s => s.Course); 

} 

if (courselD != null) 

{ 

CourselD = courselD.Value; 

instructor.Enrollments = instructor.Courses.Single( 
x => x.CourselD == courselD).Enrollments; 

} 

} 

Yukarıdaki single yaklaşım, where kullanmaktan faydalanır. Bazı geliştiriciler single yaklaşım stilini tercih 
eder. 


Açık yükleme 



Kullanıcıların bir kursa kayıtları nadiren görmek istediğini varsayalım. Bu durumda, bir iyileştirme yalnızca 
isteniyorsa kayıt verilerini yüklemek olacaktır. Bu bölümde onGetAsync , Enrollments ve students açık 
yüklemesini kullanacak şekilde güncelleştirilir. 


OnGetAsync aşağıdaki kodla güncelleştirin: 











public async Task OnGetAsync(int? id, int? courselD) 

{ 

Instructor = new InstructorIndexData(); 
instructor.Instructors = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 
.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Department) 
//.Include(i => İ.CourseAssignments) 

// .Thenlnclude(i => i.Course) 

// .Thenlnclude(i => i.Enrollments) 

// .Thenlnclude(i => i.Student) 

// .AsNoTracking() 

.OrderBy(i => i.LastName) 

.ToListAsync(); 


if (id != null) 

{ 

InstructorlD = id.Value; 

Instructor instructor = instructor.Instructors.Where( 
i => i.ID == id.Value).Single(); 

instructor.Courses = instructor.CourseAssignments.Select(s => s.Course); 


if (courselD != null) 

{ 

CourselD = courselD.Value; 

var selectedCourse = instructor.Courses.Where(x => x.CourselD == courselD).Single(); 
await _context.Entry(selectedCourse).Collection(x => x.Enrollments).LoadAsync(); 
foreach (Enrollment enrollment in selectedCourse.Enrollments) 

{ 

await _context.Entry(enrollment).Reference(x => x.Student).LoadAsync(); 

} 

instructor.Enrollments = selectedCourse.Enrollments; 

} 


Yukarıdaki kod, kayıt ve öğrenci verileri için Thenınclude Yöntem çağrılarını bırakır. Bir kurs seçilirse 
vurgulanan kod şunu alır: 



Yukarıdaki kod açıklamalarının .AsNoTrackingO dikkat edin. Gezinti özellikleri yalnızca izlenen varlıklar için 
açık bir şekilde yüklenebilir. 

Uygulamayı test edin. Bir kullanıcının perspektifinden, uygulama önceki sürümle aynı şekilde davranır. 
Sonraki öğreticide ilgili verileri güncelleştirme gösterilmektedir. 

Ek kaynaklar 

• Bu öğreticinin YouTube sürümü (parti) 

• Bu öğreticinin YouTube sürümü (part2) 


ÖNCEKİ 


İLERİ 









ASRNET Core ile EF Core Razor Pages-llgili verileri 
güncelleştirme-7/8 

20.08.2019 • 43 minutes to read ı Edit Online 


, Tom Dykstrave Rick Anderson 

Contoso Üniversitesi web uygulaması, EF Core ve Visual Studio kullanarak Razor Pages Web uygulamaları 
oluşturmayı gösterir. Öğretici serisi hakkında daha fazla bilgi için ilk öğreticiyebakın. 

Çözemediğiniz sorunlarla karşılaşırsanız, Tamamlanmış uygulamayı indirin ve öğreticiyi izleyerek bu kodu 
oluşturduğunuz şekilde karşılaştırın. 

Bu öğreticide ilgili verileri güncelleştirme gösterilmektedir. Aşağıdaki çizimler tamamlanan sayfalardan bazılarını 
göstermektedir. 
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Kurs oluşturma ve düzenleme sayfalarını güncelleştirme 

Kurs oluşturma ve düzenleme sayfaları için yapı iskelesi kodu, departman KİMLİĞİ (tamsayı) gösteren bir 
departman açılan listesi içerir. Açılan listede bölüm adı gösterilmeli, bu nedenle her iki sayfanın da bir 
departman adları listesi olması gerekir. Bu listeyi sağlamak için, oluşturma ve düzenleme sayfaları için bir temel 
sınıf kullanın. 

Kurs oluşturma ve düzenleme için bir temel sınıf oluşturun 

Aşağıdaki kodla bir Pages/kurslar/DepartmentNamePageModel. cs dosyası oluşturun: 




using ContosoUniversity.Data; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.AspNetCore.Mvc.Rendering; 
using Microsoft.EntityFrameworkCore; 
using System.Linq; 

namespace ContosoUniversity.Pages.Courses 

{ 

public class DepartmentNamePageModel : PageModel 

{ 

public SelectList DepartmentNameSL { get; set; } 

public void PopulateDepartmentsDropDownList(SchoolContext _context, 
object selectedDepartment = null) 

{ 

var departmentsQuery = from d in _context.Departments 
orderby d.Name // Şort by name, 
select d; 


} 


} 


} 


DepartmentNameSL = new SelectList(departmentsQuery.AsNoTracking (), 
"DepartmentlD ", "Name", selectedDepartment); 


Yukarıdaki kod, bölüm adlarının listesini içeren bir SelectList oluşturur. Belirtilmişse, bu departman SelectList 
Öğesinde seçilir. selectedDepartment 


Oluşturma ve düzenleme sayfa modeli sınıfları öğesinden DepartmentNamePageModel türetilir. 


Kursu güncelleştirme sayfa modeli oluşturma 

Bir kurs bir departmana atanır. Oluşturma ve düzenleme sayfaları için temel sınıf, departmanı seçmek için 


SelectList 

bir sağlar. Yabancı anahtar (FK) özelliğini kullanan 

SelectList 

açılan liste. 

Course.DepartmentID 


Core, course.DepartmentlD Department gezinti özelliğini yüklemek için FK kullanır. 










Contoso University 

Create 

Course 

Number 

Title 

Credits 

Department 



Mathematics 


Sayfaları/kursları/oluşturma. cshtml. cs dosyasını şu kodla güncelleştirin: 









using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc; 
using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Courses 

{ 

public class CreateModel : DepartmentNamePageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public CreateModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

public IActionResult OnGet() 

{ 

PopulateDepartmentsDropDownList(_context); 
return Page(); 

} 

[BindProperty] 

public Course Course { get; set; } 

public async Task<IActionResult> OnPostAsync() 

{ 

var emptyCourse = new Course(); 

if (await TryUpdateModelAsync<Course>( 
emptyCourse, 

"course", // Prefix for form value. 

s => s.CourselD, s => s.DepartmentlD, s => s.Title, s => s.Credits)) 

{ 

_context.Courses.Add(emptyCourse); 
await _context. SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

// Select DepartmentlD if TryUpdateModelAsync fails. 
PopulateDepartmentsDropDownList(_context, emptyCourse.DepartmentlD); 
return Page(); 

} 

} 

} 


Yukarıdaki kod: 

• Türetiliyor DepartmentNamePageModel . 

• TryUpdateModelAsync Aşırı nakletmeyiengellemek için kullanır. 

• Kaldırır viewData["DepartmentiD"] . DepartmentNameSL temel sınıftan türü kesin belirlenmiş bir modeldir ve 
Razor sayfası tarafından kullanılır. Kesin olarak belirlenmiş modeller, kesin olarak yazılan zayıf bir şekilde 
tercih edilir. Daha fazla bilgi için bkz. zayıf yazılmış veriler (VievvData ve VievvBag). 

Kursu güncelleştirme Razor oluşturma sayfası 

Sayfalan/kurslarL/Create. cshtml 'yi aşağıdaki kodla güncelleştirin: 






@page 

@model Contosollniversity. Pages.Courses.CreateModel 

@{ 

ViewData["Title"] = "Create Course"; 

} 

<h2>Create</h2> 

<h4>Course</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<div class="form-group"> 

clabel asp-for="Course.CourseID" class="control-label"x/label> 

<input asp-for="Course.CourseID" class="form-control" /> 

<span asp-validation-for="Course.CourseID" class="text-danger"x/span> 
</div> 

<div class="form-group"> 

•clabel asp-for="Course.Title" class="control-label"x/label> 

<input asp-for="Course.Title" class="form-control" /> 

<span asp-validation-for="Course.Title" class="text-danger"x/span> 
</div> 

<div class="form-group"> 

<label asp-for="Course.Credits" class="control-label"x/label> 

<input asp-for="Course.Credits" class="form-contnol" /> 

<span asp-validation-for="Counse.Credits" class="text-danger"x/span> 
</div> 

<div class="form-group"> 

<label asp-for="Course.Department" class="control-label"x/label> 
<select asp-for="Course.DepartmentID" class="form-control" 
asp-items="@Model.DepartmentNameSL"> 
coption value="">-- Select Department --</option> 

</select> 

<span asp-validation-for="Course.DepartmentID" class="text-danger" /> 
</div> 

<div class="form-group"> 

<input type="submit" value="Create" class="btn btn-primary" /> 

</div> 

</form> 

</div> 

</div> 

<div> 

<a asp-page="Index">Back to List</a> 

</div> 

@section Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 


Yukarıdaki kod aşağıdaki değişiklikleri yapar: 

• DepartmentlD etiketini departmanadönüştürür. 

• "ViewBag.DepartmentlD" ile DepartmentNameSL değiştirir (taban sınıfından). 

• "Departmanı Seç" seçeneğini ekler. Bu değişiklik, ilk departman yerine henüz bir departman seçilmedikçe 
açılan kutuda "departmanı Seç" i işler. 

• Departman seçili olmadığında bir doğrulama iletisi ekler. 

Razor sayfası seçme etiketi yardımcısınıkullanır: 





<div class="form-group"> 

<label asp-for="Course.Department" class="control-label"x/label> 

<select asp-for="Course.DepartmentID" class="form-control" 
asp-items="@Model.DepartmentNameSL"> 

<option value="">-- Select Department --</option> 

</select> 

<span asp-validation-for="Course.DepartmentID" class="text-danger" /> 

</div> 

Oluştur sayfasını test edin. Oluştur sayfası departman KİMLİĞİ yerine departman adını görüntül 

Kurs düzenleme sayfası modelini güncelleştirme 

Pages/kurslar/Edit. cshtml. cs dosyasını aşağıdaki kodla güncelleştirin: 

using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc; 
using Microsoft.EntityFrameworkCore; 
using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Courses 

{ 

public class EditModel : DepartmentNamePageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public EditModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Course Course { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Course = await _context.Courses 

.Include(c => c.Department).FirstOrDefaultAsync(m => m.CourselD == id); 

if (Course == null) 

{ 

return NotFound(); 

} 

// Select current DepartmentID. 

PopulateDepartmentsDropDownList(_contextj Course.DepartmentID); 
return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var courseToUpdate = await _context.Courses.FindAsync(id); 

if (courseToUpdate == null) 

{ 

return NotFound(); 



i 


if (await TryUpdateModelAsync<Course>( 
courseTolIpdate, 

"course"j // Prefix for form value. 

c => c.Credits, c => c. DepartmentlD., c => c.Title)) 

{ 

await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

// Select DepartmentlD if TryUpdateModelAsync fails. 

PopulateDepartmentsDropDownList(_contextj courseToUpdate.DepartmentlD); 
return Page(); 

} 

} 

} 

Değişiklikler, oluşturma sayfası modelinde yapılanlarla benzerdir.Yukarıdaki kodda, 
PopuiateDepartmentsDropDownList bu departmanı açılan listede seçen departman kimliği' nde geçirilir. 

Kurs düzenleme Razor sayfasını güncelleştirme 

Pages/kurslar/Edit. cshtml dosyasını aşağıdaki kodla güncelleştirin: 



@page 

@model Contosollniversity. Pages.Counses. EditModel 

@{ 

ViewData["Title"] = "Edit"; 

} 

<h2>Edit</h2> 

<h4>Course</h4> 
chr /> 

<div class="row"> 

<div class="col-md-4"> 

<form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<input type="hidden" asp-for="Course.CourseID" /> 

<div class="form-group"> 

clabel asp-for="Course.CourseID" class="control-label"x/label> 
cdiv>@Html.DisplayFor(model => model.Course.CourseID)c/div> 

</div> 

<div class="form-group"> 

<label asp-for="Course.Title" class="control-label"x/label> 
cinput asp-for="Course.Title" class="form-control" /> 

<span asp-validation-for="Course.Title" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

clabel asp-for="Course.Credlts" class="control-label"x/label> 

<input asp-for="Course.Credlts" class="form-contnol" /> 

<span asp-validation-for="Course.Cnedlts" class="text-danger"x/span> 
</div> 

<div class="form-group"> 

<label asp-for="Course.Department" class="control-label"x/label> 

<select asp-for="Course.DepartmentID" class="form-control" 
asp-items="@Model .DepartmentNameSL"x/select> 

<span asp-validation-for="Course.DepartmentID" class="text-danger"x/span> 
</div> 

<div class="form-group"> 

<input type="submit" value="Save" class="btn btn-primary" /> 

</div> 

</form> 

</div> 

</div> 

<div> 

<a asp-page="./Index">Back to List</a> 

</div> 

@section Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 


Yukarıdaki kod aşağıdaki değişiklikleri yapar: 

• Kurs KİMLİĞİNİ görüntüler.Genellikle bir varlığın birincil anahtarı (PK) gösterilmez. PKs 1 ler genellikle 
kullanıcılara daha az anlamlı olur. Bu durumda, PK kurs numarasıdır. 

• Bölüm açılan başlığını DepartmentlD ' dan departmanadönüştürür. 

• "ViewBag.DepartmentlD" ile DepartmentNameSL değiştirir (taban sınıfından). 


Sayfa, kurs numarası için gizli bir 

cinput type="hidden"> 

alan 0 içerir. 

clabel> 

Etiket 

asp-for="Course.CourseID" 

Yardımcısı ekleme, gizli alan gereksinimini ortadan kaldırmaz. 

cinput type="hidden"> 

Kullanıcı Kaydet 1 e 


tıkladığında, gönderilen veriler için kurs numarasının dahil olması gerekir. 


Kurs ayrıntılarını güncelleştirme ve sayfaları silme 








Anotracking , izleme gerekli olmadığında performansı iyileştirebilir. 

Kurs sayfası modellerini güncelleştirme 

Sayfa/kursiar/deiete. cshtml. cs öğesini aşağıdaki kodla AsNoTracking güncelleştirin: 

using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.EntityFrameworkCore; 
using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Courses 

{ 

public class DeleteModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public DeleteModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Course Course { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Course = await _context.Courses 
.AsNoTrackingO 
.Include(c => c.Department) 

.FirstOrDefaultAsync(m => m.CourselD == id); 

if (Course == null) 

{ 

return NotFound(); 

} 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Course = await _context.Courses.FindAsync(id); 

if (Course != null) 

{ 

_context.Courses.Remove(Course); 
await _context.SaveChangesAsync(); 

} 

return RedirectToPage("./Index"); 

} 

} 

} 


Sayfalar/kurslar/details. cshtml. cs dosyasında aynı değişikliği yapın: 




using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.EntityFrameworkCore; 
using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Courses 

{ 

public class DetailsModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public DetailsModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

public Course Course { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Course = await _context.Courses 
.AsNoTracking() 

.Include(c => c.Department) 

.FirstOrDefaultAsync(m => m.CourselD == id); 

if (Course == null) 

{ 

return NotFound(); 

} 

return Page(); 

} 

} 

} 


Kurs Razor sayfalarını güncelleştirme 

Pages/kurslar/delete. cshtml dosyasını aşağıdaki kodla güncelleştirin: 



@page 

@model Contosollniversity. Pages.Courses.DeleteModel 

@{ 

ViewData["Title"] = "Delete"; 

} 

<h2>Delete</h2> 

<h3>Are you sure you want to delete this?</h3> 

<div> 

<h4>Course</h4> 

<hr /> 

<dl class="row"> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Course.CourselD) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Course.CourselD) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Course.Title) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Course.Title) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Course.Credits) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Course.Credits) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Course.Department) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Course.Department.Name) 
</dd> 

</dl> 

<form method="post"> 

<input type="hidden" asp-for="Course.CourseID" /> 

<input type="submit" value="Delete" class="btn btn-danger" /> | 
<a asp-page="./Index">Back to List</a> 

</form> 

</div> 


Ayrıntılar sayfasında aynı değişiklikleri yapın. 



@page 

@model Contosollniversity. Pages.Courses.DetailsModel 

@{ 

ViewData["Title"] = "Details"; 

} 

<h2>Details</h2> 

<div> 

<h4>Course</h4> 

<hr /> 

<dl class="row"> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Course.CourselD) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Course.CourselD) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Course.Title) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Course.Title) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Course.Credlts) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Course.Credlts) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Course.Department) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Course.Department.Name) 

</dd> 

</dl> 

</div> 

<div> 

<a asp-page="./Edit" asp-route-id="@Model.Course.CourseID">Edit</a> | 
<a asp-page="./Index">Back to List</a> 

</div> 


Kurs sayfalarını test etme 

Oluşturma, düzenleme, ayrıntıları ve silme sayfalarını test edin. 

Eğitmen oluşturma ve düzenleme sayfalarını güncelleştirme 

Eğitmenler, istediğiniz sayıda kurs öğretebilir.Aşağıdaki görüntüde, bir dizi kurs onay kutusu ile eğitmen 
düzenleme sayfası gösterilmektedir. 



Contoso University 


Edit 

Instructor 

last Name 
Fakhouri 

First Name 
Fadi 

Fi i re Date 
07/06/2002 

Office Location 
Smith 17 

K 1045 Calculus O 1050 Chemistry 0 2021 Composition 

0 2042 Literatüre O 3141 O 4022 

Trigorıometry Microeconomics 

0 4041 

Macroeconomics 


Save 


Onay kutuları, bir eğitmenin atandığı kurslara değişiklikler sağlar.Veritabanındaki her kurs için bir onay kutusu 
görüntülenir. Eğitmenin atandığı kurslar seçilidir. Kullanıcı kurs atamalarını değiştirmek için onay kutularını 
seçebilir veya temizleyebilir. Kurs sayısı çok büyükse, farklı bir kullanıcı arabirimi daha iyi çalışabilir. Ancak 
burada gösterilen çoktan çoğa ilişkiyi yönetme yöntemi değişmez, ilişki oluşturmak veya silmek için bir JOIN 
varlığını işlersiniz. 

Atanan kurslar verileri için bir sınıf oluşturma 

Aşağıdaki kodla SchoolVievvModels/AssignedCourseData. cs oluşturun: 

namespace ContosoUniversity.Models.SchoolViewModels 

{ 

public class AssignedCourseData 

{ 

public int CourselD { get; set; } 
public string Title { get; set; } 
public bool Assigned { get; set; } 

} 

} 

Sınıfı AssignedCourseData , bir eğitmene atanan kurslar için onay kutularını oluşturmak üzere verileri içerir. 

Bir eğitmen sayfa modeli temel sınıfı oluşturma 

Pages/eğitmenler/Komutctorcoursespagemodel. cs temel sınıfını oluşturun: 

using ContosoUniversity.Data; 
using ContosoUniversity.Models; 
using ContosoUniversity.Models.SchoolViewModels; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using System.Collections.Generic; 






using System.Linq; 


namespace ContosoUniversity.Pages.Instructors 

{ 

public class InstructorCoursesPageModel : PageModel 

{ 


public List<AssignedCourseData> AssignedCourseDataList; 

public void PopulateAssignedCourseData(SchoolContext context, 

Instructor instructor) 

{ 

var allCourses = context.Courses; 

var instructorCourses = new HashSet<int>( 

instructor.CourseAssignments.Select(c => c.CourselD)); 
AssignedCourseDataList = new List<AssignedCourseData>(); 
foreach (var course in allCourses) 

{ 

AssignedCourseDataList.Add(new AssignedCourseData 

{ 

CourselD = course.CourselD, 

Title = course.Title, 

Assigned = instructorCourses.Contains(course.CourselD) 

}); 

} 

} 

public void UpdateInstructorCourses(SchoolContext context, 
string[] selectedCourses, instructor instructorToUpdate) 

{ 

if (selectedCourses == null) 

{ 

İnstructorToUpdate.CourseAssignments = new List<CourseAssignment>(); 
return; 

} 

var selectedCoursesHS = new HashSet<string>(selectedCourses); 
var İnstructorCourses = new HashSet<int> 

(instructorToUpdate.CourseAssignments.Select(c => c.Course.CourselD)); 
foreach (var course in context.Courses) 

{ 

if (selectedCoursesHS.Contains(course.CourseID.ToString())) 

{ 

if (!instructorCourses.Contains(course.CourselD)) 

{ 

İnstructorToUpdate.CourseAssignments.Add( 
new CourseAssignment 
{ 

InstructorlD = İnstructorToUpdate.İD, 

CourselD = course.CourselD 

}); 

} 

} 

else 

{ 

if (İnstructorCourses.Contains(course.CourselD)) 

{ 

CourseAssignment courseToRemove 
= İnstructorToUpdate 
.CourseAssignments 

•SingleOrDefault(i => i.CourselD == course.CourselD); 
context.Remove(courseToRemove); 

} 

} 

} 

} 


} 


} 


, instructorCoursesPageModei Düzenleme ve oluşturma sayfa modelleri için kullanacağınız temel sınıftır. 
PopuiateAssignedCourseData''Course doldurmak AssignedCourseDataList için tüm varlıkları okur. Her kurs için 
kod, başlığı ve eğitmenin courseiD kursa atanıp atanmadığını belirler. Bir diyez kümesi etkili aramalar için 
kullanılır. 

Razor sayfasında bir kurs varlıkları koleksiyonu olmadığından, model Bağlayıcısı courseAssignments gezinti 
özelliğini otomatik olarak güncelleştiremez. CourseAssignments Gezinti özelliğini güncelleştirmek için model cildi 
kullanmak yerine, bunu yeni updateinstructorCourses yöntemde yapmanız gerekir. Bu nedenle, 

CourseAssignments özelliği model bağlamadan hariç bırakmanız gerekir. Bu, beyaz liste aşırı yüklemesini 
kullandığınız ve TryupdateModei CourseAssignments içerme listesinde olmadığı için çağıran kodda herhangi bir 
değişiklik yapılmasını gerektirmez. 

Hiçbir onay kutusu seçili değilse, içindeki updateinstructorCourses kod CourseAssignments gezinti özelliğini boş 
bir koleksiyonla başlatır ve döndürür: 

if (selectedCourses == null) 

{ 

instructorToUpdate.CourseAssignments = new List<CourseAssignment>(); 
return; 

} 

Kod daha sonra, veritabanındaki tüm kurslardan geçer ve bu her kursu, sayfada seçili olanlar ile ilgili olarak, 
eğitmene atanmış olanlara karşı denetler. Etkili aramaları kolaylaştırmak için, ikinci iki koleksiyon HashSet 
nesnelerde depolanır. 

Kurs onay kutusu seçilmişse ancak kurs, instructor.CourseAssignments gezinti özelliğinde değilse kurs, Gezinti 
özelliğindeki koleksiyona eklenir. 

if (selectedCoursesHS.Contains(course.CourseID.ToString())) 

{ 

if (linstructorCourses.Contains(course.CourselD)) 

{ 

İnstructorToUpdate.CourseAssignments.Add( 
new CourseAssignment 
{ 

InstructorlD = İnstructorToUpdate.İD, 

CourseiD = course.CourseiD 
})J 

} 

} 

Kurs onay kutusu seçili değilse, ancak kurs instructor.CourseAssignments gezinti özelliği ise, kurs, gezinti 
özelliğinden kaldırılır. 

else 

{ 

if (instructorCourses.Contains(course.CourseiD)) 

{ 

CourseAssignment courseToRemove 
= İnstructorToUpdate 
.CourseAssignments 

•SingleOrDefault(i => i.CourseiD == course.CourseiD); 
context.Remove(courseToRemove); 

} 

} 


Office konumunu işle 


















Düzenleme sayfasının işlemesi gereken başka bir ilişki ise, eğitmen varlığının officeAssignment varlığa sahip 
olduğu bire sıfır veya-bir ilişkidir. Eğitmen düzenleme kodu aşağıdaki senaryoları işlemelidir: 

• Kullanıcı Office atamasını temizlediğinde OfficeAssignment varlığı silin. 

• Kullanıcı bir Office ataması girerse ve boşsa, yeni OfficeAssignment bir varlık oluşturun. 

• Kullanıcı Office atamasını değiştirirse OfficeAssignment varlığı güncelleştirin. 

Eğitmen düzenleme sayfası modelini güncelleştirme 

Pages/eğitmenler/Edit. cshtml. cs dosyasını aşağıdaki kodla güncelleştirin: 

using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc; 
using Microsoft.EntityFrameworkCore; 
using System; 

using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Instructors 

{ 

public class EditModel : InstructorCoursesPageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public EditModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Instructor Instructor { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Instructor = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments).Thenlnclude(i => i.Course) 

.AsNoTrackingO 

.FirstOrDefaultAsync(m => m.ID == id); 

if (Instructor == null) 

{ 

return NotFound(); 

} 

PopulateAssignedCourseData(_context, Instructor); 
return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int? id, string[] selectedCourses) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var instructorToUpdate = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => İ.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.FirstOrDefaultAsync(s => s.ID == id); 

if (İnstructorToUpdate == null) 






I 

return NotFound(); 

> 

if (await TryUpdateModelAsync<Instructor>( 
instructorToUpdate, 

"instructor ", 

i => i.FirstMidNamej i => i.LastName, 
i = > i.HireDate, i => i.OfficeAssignment)) 

{ 

if (String.IsNullOrWhiteSpace( 

instructorToUpdate.OfficeAssignment?.Location)) 

{ 

instructorToUpdate.OfficeAssignment = null; 

} 

UpdateInstructorCourses(_context, selectedCourses, İnstructorToUpdate); 
await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

UpdateInstructorCourses(_context, selectedCourses, İnstructorToUpdate); 
PopulateAssignedCourseData(_context , İnstructorTolIpdate); 
return Page(); 

} 

} 

} 


Yukarıdaki kod: 


• officeAssignment , instructor ,Ve courseAssignment.course gezinme özellikleri için Eager yükleme 
kullanarak geçerli varlığı veritabanından alır. courseAssignment 

• Alınan instructor varlığı model Ciltçideki değerlerle güncelleştirir. TryUpdateModei fazla nakletmeyiönler. 

• Office konumu boşsa, null olarak ayarlar instructor.OfficeAssignment .Null instructor.OfficeAssignment 
olduğunda, OfficeAssignment tablodaki ilgili satır silinir. 

• Görüntüleme modeli onGetAsync sınıfını kullanarak onay kutuları PopulateAssignedCourseData için bilgi 
sağlamak üzere 1 de çağırır. AssignedCourseData 

• Onay updateinstructorCourses kutularından onPostAsync düzenlenmekte olan eğitmen varlığına bilgi 
uygulamak için ' de çağırır. 

• Başarısız olursa UpdateinstructorCourses , OnPostAsync ve ' de PopulateAssignedCourseData çağırır. 
TryUpdateModei Bu yöntem çağrıları, bir hata iletisiyle yeniden görüntülendiğinde sayfaya girilen atanan kurs 

verilerini geri yükler. 

Eğitmen düzenleme Razor sayfasını güncelleştirme 

Pages/eğitmenler/Edit. cshtml dosyasını aşağıdaki kodla güncelleştirin: 

@page 

@model ContosoUniversity.Pages.Instructors.EditModel 

@{ 

ViewData["Title"] = "Edit"; 

} 

<h2>Edit</h2> 

<h4>Instructor</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<input type="hidden" asp-for="Instructor.ID" /> 

<div class="form-group"> 

<label asp-for="Instructor. LastName" class="control-label"x/label> 

<input asp-for="Instructor.LastName" class="form-control" /> 

<span asp-validation-for="Instructor. LastName" class="text-danger"x/span> 

</div> 

















<div class="form-group"> 

clabel asp-for="Instructor. FirstMidName" class="control-label"x/label> 

<input asp-for="Instructor.FirstMidName" class="form-control" /> 

<span asp-validation-for="Instructor. FirstMidName" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Instructor.FlireDate" class="control-label"x/label> 
cinput asp-for="Instructor.FlireDate" class="form-control" /> 

<span asp-validation-for="Instructor.FlireDate" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

clabel asp-for="Instructor.OfficeAssignment. Location" class="control-label"x/label> 
cinput asp-for="Instructor.OfficeAssignment.Location" class="form-control" /> 
cspan asp-validation-for="Instructor.OfficeAssignment.Location" class="text-danger" /> 
</div> 

cdiv class="form-group"> 
cdiv class="table"> 

<table> 

<tr> 

int cnt = 0; 

foreach (var course in Model.AssignedCourseDataList) 

{ 

if (cnt++ % 3 == 0) 

{ 

@:</trxtr> 

} 

<td> 

cinput type="checkbox" 

name="selectedCourses" 

value="@course.CourseID" 

@(Html.Raw(course.Assigned ? "checked=\"checked\"" : "")) /> 
@course.CourseID (Şcourse.Title 

c/td> 

} 

@:c/tr> 

} 

c/table> 

c/div> 

c/div> 

cdiv class="form-group"> 

cinput type="submit" value="Save" class="btn btn-primary" /> 
c/div> 
c/form> 
c/div> 
c/div> 

cdiv> 

ca asp-page="./Index">Back to Listc/a> 
c/div> 

@section Scripts { 

@{await Fltml. RenderPartialAsync( "_ValidationScriptsPartial");} 

} 


Yukarıdaki kod, üç sütun içeren bir HTML tablosu oluşturur.Her sütunda, kurs numarasını ve başlığını içeren bir 
CheckBox ve bir açıklamalı altyazı vardır. Onay kutularının hepsi aynı ada ("Selectedkurslar") sahiptir.Aynı adı 
kullanmak model cildi bir grup olarak kabul etmek üzere bilgilendirir. Her onay kutusunun değer özniteliği 
olarak courseiD ayarlanır. Sayfa gönderildiğinde, model Ciltçi yalnızca seçili onay kutularının counseiD 
değerlerinden oluşan bir dizi geçirir. 

Onay kutuları başlangıçta işlendiğinde, eğitmen 'e atanan kurslar seçilir. 

Not: Eğitim kursu verilerini düzenlemek için buradaki yaklaşım, sınırlı sayıda kurs olduğunda iyi bir şekilde 
gerçekleştirilir. Çok daha büyük olan koleksiyonlar için, farklı bir kullanıcı arabirimi ve farklı bir güncelleştirme 




yöntemi daha erişilebilir ve verimli olacaktır. 

Uygulamayı çalıştırın ve güncelleştirilmiş eğitmenler düzenleme sayfasını test edin. Bazı kurs atamalarını 
değiştirin. Değişiklikler Dizin sayfasında yansıtılır. 

Eğitmen oluştur sayfasını güncelleştirme 

, Düzenleme sayfasına benzer kodla, bir sayfa modeli ve Razor sayfası oluşturma adlı eğitmeni güncelleştirin: 



using ContosolIniversity.Models; 
using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using System.Threading.Tasks; 

namespace ContosoUnivensity.Pages.Instructors 

{ 

public class CreateModel : InstructorCoursesPageModel 

{ 

private readonly Contosollniversity.Data.SchoolContext _context; 

public CreateModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

public IActionResult OnGet() 

{ 

van instructor = new Instructor(); 

instructor.CourseAssignments = new List<CourseAssignment>(); 

// Provides an empty collection for the foreach loop 
// foreach (var course in Model.AssignedCourseDataList) 

// in the Create Razor page. 

PopulateAssignedCourseData(_context , instructor); 
return Page(); 

} 

[BindProperty] 

public instructor instructor { get; set; } 

public async Task<IActionResult> OnPostAsync(string[] selectedCourses) 

{ 

var newInstructor = new Instructor(); 
if (selectedCourses != null) 

{ 

newInstructor.CourseAssignments = new List<CourseAssignment>(); 
foreach (var course in selectedCourses) 

{ 

var courseToAdd = new CourseAssignment 

{ 

CourselD = int.Parse(course) 

}; 

newInstructor.CourseAssignments.Add(courseToAdd); 

} 

} 

if (await TryUpdateModelAsync<Instructor>( 
newInstructorj 
"instructor ", 

i => i.FirstMidNamej i => i.LastNamej 
i => i.HireDate, i => i.OfficeAssignment)) 

{ 

_context.Instructors.Add(newInstructor); 
await _context. SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

PopulateAssignedCourseData(_context, newInstructor); 
return Page(); 

} 

} 

} 


@page 

@model Contosollniversity. Pages. Instructors. CreateModel 




ViewData["Title"] = "Create"; 

} 

<h2>Create</h2> 

ch4>Instructorc/h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<div class="form-group"> 

clabel asp-for="Instructor. LastName" class="control-label"x/label> 

<input asp-for="Instructor.LastName" class="form-control" /> 

<span asp-validation-for="Instructor. LastName" class="text-danger"x/span> 

</div> 

cdiv class="form-group"> 

clabel asp-for="Instructor.FirstMldName" class="contnol-label"x/label> 

cinput asp-for="Instructor.FirstMldName" class="form-control" /> 

cspan asp-validation-for="Instructor. FirstMldName" class="text-danger"x/span> 

</div> 

cdiv class="form-group"> 

clabel asp-for="Instructor.HireDate" class="control-label">c/label> 
cinput asp-for="Instructor.HireDate" class="form-control" /> 
cspan asp-validation-for="Instructor.HireDate" class="text-danger">c/span> 
c/div> 

cdiv class="form-group"> 

clabel asp-for="Instructor.OfficeAssignment.Location" class="control-label">c/label> 
cinput asp-for="Instructor.OfficeAssignment.Location" class="form-control" /> 
cspan asp-validation-for="Instructor.OfficeAssignment.Location" class="text-danger" /> 
c/div> 

cdiv class="form-group"> 
cdiv class="table"> 
ctable> 
ctr> 

@{ 

int cnt = 0; 

foreach (var course in Model.AssignedCourseDataList) 

{ 

if (cnt++ % 3 == 0) 

{ 

@:c/trxtr> 

} 

ctd> 

cinput type="checkbox" 

name="selectedCourses" 

value="@course.CourseID" 

@(Html.Raw(course.Assigned ? "checked=\"checked\"" : "")) /> 
@course.CourseID @course.Title 

c/td> 

} 

c/tr> 

} 

c/table> 

c/div> 

c/div> 

cdiv class="form-group"> 

cinput type="submit" value="Create" class="btn btn-primary" /> 
c/div> 
c/form> 
c/div> 
c/div> 

cdiv> 

ca asp-page="Index">Back to Listc/a> 
c/div> 


@section Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 


Eğitmen oluşturma sayfasını test edin. 

Eğitmen silme sayfasını Güncelleştir 


Sayfaları/eğitmenler/delete. cshtml. cs dosyasını şu kodla güncelleştirin 


using ContosoUniversity.Models; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using Microsoft.EntityFrameworkCore; 

using System.Linq; 

using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Instructors 

{ 

public class DeleteModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public DeleteModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Instructor Instructor { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Instructor = await _context.Instructors.FirstOrDefaultAsync(m => m.ID == id); 

if (Instructor == null) 

{ 

return NotFound(); 

} 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Instructor instructor = await _context.Instructors 
.Include(i => i.CourseAssignments) 

•SingleAsync(i => i.ID == id); 

if (instructor == null) 

{ 

return RedirectToPage("./Index"); 

} 

var departments = await _context.Departments 
.Where(d => d.InstructorlD == id) 

.ToListAsync(); 

departments.ForEach(d => d.InstructorlD = null); 

_context.Instructors.Remove(instructor); 

await _context. SaveChangesAsync (); 
return RedirectToPage("./Index"); 

} 

} 

} 



Yukarıdaki kod aşağıdaki değişiklikleri yapar: 


• courseAssignments Gezinti özelliği için Eager yüklemesi kullanır. CourseAssignments eğitmen silindiğinde, 
dahil edilmiş veya silinmemelidir. Bunları okumaktan kaçınmak için, veritabanında basamaklı silme 'yı 
yapılandırın. 

• Silinecek eğitmen herhangi bir departmanların Yöneticisi olarak atanırsa, bu departmanlardan eğitmen 
atamasını kaldırır. 

Uygulamayı çalıştırın ve silme sayfasını test edin. 

Sonraki adımlar 


ÖNCEKİ ■ SONRAKİ 

ÖĞRETİCİ ■ ÖĞRETİCİ 


Bu öğreticide ilgili verilerin güncelleştirilmesi gösterilmektedir.Olamaz çözmenize, sorunlarla karşılaşırsanız, 

indirin veya tamamlanmış uygulamayı görüntüleyin. Yükleme yönergeleri. 

Aşağıdaki çizimler tamamlanan sayfalardan bazılarını göstermektedir. 
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Kurs oluşturma ve düzenleme sayfalarını inceleyin ve test edin. Yeni bir kurs oluşturun. Departman, adı değil, 
birincil anahtarı (bir tamsayı) tarafından seçilir. Yeni kursu düzenleyin. Sınamayı bitirdiğinizde yeni kursu silin. 

Ortak kod paylaşmak için bir temel sınıf oluşturun 

Kurslar/oluştur ve kurslar/Düzenle sayfalan, her birinin departman adları listesine ihtiyacı vardır. Oluşturma ve 
düzenleme sayfalan için Pages/kurslar/DepartmentNamePageModel. cshtml. cs temel sınıfını oluşturun: 














using ContosoUniversity.Data; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.AspNetCore.Mvc.Rendering; 
using Microsoft.EntityFrameworkCore; 
using System.Linq; 

namespace ContosoUniversity.Pages.Courses 

{ 

public class DepartmentNamePageModel : PageModel 

{ 

public SelectList DepartmentNameSL { get; set; } 

public void PopulateDepartmentsDropDownList(SchoolContext _context, 
object selectedDepartment = null) 

{ 

var departmentsQuery = from d in _context.Departments 
orderby d.Name // Şort by name, 
select d; 


} 


} 


} 


DepartmentNameSL = new SelectList(departmentsQuery.AsNoTracking (), 
"DepartmentlD ", "Name", selectedDepartment); 


Yukarıdaki kod, bölüm adlarının listesini içeren bir SelectList oluşturur. Belirtilmişse, bu departman SelectList 
Öğesinde seçilir. selectedDepartment 


Oluşturma ve düzenleme sayfa modeli sınıfları öğesinden DepartmentNamePageModel türetilir. 


Kurslar sayfalarını özelleştirme 

Yeni bir kurs varlığı oluşturulduğunda, mevcut bir departmanla bir ilişkisi olmalıdır. Bir kurs oluştururken bir 
departman eklemek için, oluşturma ve düzenleme için temel sınıf, departmanı seçmeye yönelik bir açılan liste 
içerir. Açılan liste, course.DepartmentlD yabancı anahtar (FK) özelliğini ayarlar.EF Core, course.DepartmentlD 
Department gezinti özelliğini yüklemek için FK kullanır. 
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Oluşturma sayfası modelini aşağıdaki kodla güncelleştirin: 





















using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc; 
using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Courses 

{ 

public class CreateModel : DepartmentNamePageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public CreateModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

public IActionResult OnGet() 

{ 

PopulateDepartmentsDropDownList(_context); 
return Page(); 

} 

[BindProperty] 

public Course Course { get; set; } 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var emptyCourse = new Course(); 

if (await TryUpdateModelAsync<Course>( 
emptyCourse, 

"course", // Prefix for form value. 

s => s.CourselD, s => s.DepartmentlD, s => s.Title, s => s.Credits)) 

{ 

_context.Courses.Add(emptyCourse); 
await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

// Select DepartmentlD if TryUpdateModelAsync fails. 
PopulateDepartmentsDropDownList(_context, emptyCourse.DepartmentlD); 
return Page(); 

} 

} 

} 


Yukarıdaki kod: 

• Türetiliyor DepartmentNamePageModel . 

• TryUpdateModelAsync Aşırı nakletmeyiengellemek için kullanır. 

• ViewData["DepartmentlD"] ile DepartmentNameSL değiştirir (taban sınıfından). 

viewData["DepartmentlD"] , türü kesin belirlenmiş DepartmentNameSL olan ile değiştirilmiştir. Kesin olarak 
belirlenmiş modeller, kesin olarak yazılan zayıf bir şekilde tercih edilir. Daha fazla bilgi için bkz. zayıf yazılmış 
veriler (VievvData ve VievvBag). 

Kurslar oluşturma sayfasını güncelleştirme 

Sayfalan/kurslan/Create. cshtml 'yi aşağıdaki kodla güncelleştirin: 







@page 

@model Contosollniversity. Pages.Courses.CreateModel 

@{ 

ViewData["Title"] = "Create Course"; 

} 

<h2>Create</h2> 

<h4>Course</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<div class="form-group"> 

<label asp-for="Course.CourseID" class="control-label"x/label> 

<input asp-for="Course.CourseID" class="form-control" /> 

<span asp-validation-for="Course.CourseID" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Course.Title" class="control-label"x/label> 

<input asp-for="Course.Title" class="form-control" /> 

<span asp-validation-for="Course.Title" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Course.Credits" class="control-label"x/label> 

<input asp-for="Course.Credits" class="form-control" /> 

<span asp-validation-for="Course.Credits" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Course.Department" class="control-label"x/label> 

<select asp-for="Course.DepartmentlD" class="form-control" 
asp-items="@Model.DepartmentNameSL"> 
coption value="">-- Select Department --</option> 

</select> 

<span asp-validation-for="Course.DepartmentlD" class="text-danger" /> 

</div> 

<div class="form-group"> 

<input type="submit" value="Create" class="btn btn-default" /> 

</div> 

</form> 

</div> 

</div> 

<div> 

<a asp-page="Index">Back to List</a> 

</div> 

@section Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 

Önceki biçimlendirme, aşağıdaki değişiklikleri yapar: 

• DepartmentlD etiketini departmanadönüştürür. 

• "ViewBag.DepartmentlD" ile DepartmentNameSL değiştirir (taban sınıfından). 

• "Departmanı Seç" seçeneğini ekler. Bu değişiklik, ilk departman yerine "departmanı Seç" i işler. 

• Departman seçili olmadığında bir doğrulama iletisi ekler. 

Razor sayfası seçme etiketi yardımcısınıkullanır: 





<div class="form-group"> 

<label asp-for="Course.Department" class="contnol-label"x/label> 

<select asp-for="Course.DepartmentID" class="form-control" 
asp-items="@Model.DepartmentNameSL"> 

<option value="">-- Select Department --</option> 

</select> 

<span asp-validation-for="Course.DepartmentID" class="text-danger" /> 

</div> 

Oluştur sayfasını test edin. Oluştur sayfası departman KİMLİĞİ yerine departman adını görüntüler. 

Kurslar düzenleme sayfasını güncelleştirin. 

Pages/kurslar/Edit. cshtml. cs dosyasındaki kodu aşağıdaki kodla değiştirin: 



using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc; 
using Microsoft.EntityFrameworkCore; 
using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Courses 

{ 

public class EditModel : DepartmentNamePageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public EditModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Course Course { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Course = await _context.Courses 

.Include(c => c.Department).FirstOrDefaultAsync(m => m.CourselD == id); 

if (Course == null) 

{ 

return NotFound(); 

} 

// Select current DepartmentID. 

PopulateDepartmentsDropDownList(_context,Course.DepartmentID); 
return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int? id) 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var courseToUpdate = await _context.Courses.FindAsync(id); 

if (await TryUpdateModelAsync<Course>( 
courseToUpdate, 

"course", // Prefix for form value. 

c => c.Credits, c => c.DepartmentID, c => c.Title)) 

{ 

await _context. SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

// Select DepartmentID if TryUpdateModelAsync fails. 

PopulateDepartmentsDropDownList(_context, courseToUpdate.DepartmentID); 
return Page(); 

} 

} 

} 


Değişiklikler, oluşturma sayfası modelinde yapılanlarla benzerdir. Yukarıdaki kodda 
PopuiateDepartmentsDropDownList , açılan listede belirtilen departmanı belirleyen departman kimliği 1 nde 




geçirilir. 


Pages/kurslar/Edit. cshtml 'yi şu biçimlendirmeyle güncelleştirin: 

@page 

@model ContosoUniversity.Pages.Courses.EditModel 

@{ 

ViewData["Title"] = "Edit"; 

} 

<h2>Edit</h2> 

<h4>Course</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<input type="hidden" asp-for="Course.CourseID" /> 

<div class="form-group"> 

<label asp-for="Course.CourseID" class="control-label"x/label> 
<div>@Html.DisplayFor(model => model.Course.CourseID)</div> 

</div> 

<div class="form-group"> 

<label asp-for="Course.Title" class="control-label"x/label> 

<input asp-for="Course.Title" class="form-control" /> 

<span asp-validation-for="Course.Title" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Course.Credits" class="control-label"x/label> 

<input asp-for="Course.Credlts" class="form-control" /> 

<span asp-validation-for="Course.Credits" class="text-danger"x/span> 
</div> 

<div class="form-group"> 

clabel asp-for="Course.Department" class="control-label"x/label> 

<select asp-for="Course.DepartmentlD" class="form-control" 
asp-items="@Model .DepartmentNameSL"x/select> 

<span asp-validation-for="Course.Department 10" class="text-danger"x/span> 
</div> 

<div class="form-group"> 

<input type="submit" value="Save" class="btn btn-default" /> 

</div> 

</form> 

</div> 

</div> 

<div> 

<a asp-page="./Index">Back to List</a> 

</div> 

@sectlon Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 


Önceki biçimlendirme, aşağıdaki değişiklikleri yapar: 

• Kurs KİMLİĞİNİ görüntüler.Genellikle bir varlığın birincil anahtarı (PK) gösterilmez. PKs 1 ler genellikle 
kullanıcılara daha az anlamlı olur. Bu durumda, PK kurs numarasıdır. 

• DepartmentlD etiketini departmanadönüştürür. 

• "ViewBag.DepartmentlD" ile DepartmentNameSL değiştirir (taban sınıfından). 


Sayfa, kurs numarası için gizli bir 

<input type="hidden"> 

alan () içerir. 

<label> 

Etiket 

asp-for="Course.CourseID" 

Yardımcısı ekleme, gizli alan gereksinimini ortadan kaldırmaz. 

•cinput type="hidden"> 

Kullanıcı Kaydet 1 e 









tıkladığında, gönderilen veriler için kurs numarasının dahil olması gerekir. 

Güncelleştirilmiş kodu test edin. Kurs oluşturun, düzenleyin ve silin. 

Ayrıntılara AsNoTracking ekleme ve sayfa modellerini silme 

Anotracking , izleme gerekli olmadığında performansı iyileştirebilir. Sil AsNoTracking ve Ayrıntılar sayfa 
modeline ekleyin. Aşağıdaki kod, güncelleştirilmiş silme sayfası modelini göstermektedir: 

public class DeleteModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public DeleteModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Course Course { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Course = await _context.Courses 
.AsNoTracking() 

.Include(c => c.Department) 

.FirstOrDefaultAsync(m => m.CourselD == id); 

if (Course == null) 

{ 

return NotFound(); 

} 

return Page(); 


public async Task<IActionResult> OnPostAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Course = await _context.Courses 
.AsNoTrackingO 

.FirstOrDefaultAsync(m => m.CourselD == id); 

if (Course != null) 

{ 

_context.Courses.Remove(Course); 
await _context. SaveChangesAsync (); 

} 

return RedirectToPage("./Index"); 

} 

} 


Pages/kurslar/details. cshtml. cs dosyasındaki yöntemigüncelleştirin: onGetAsync 





public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Course = await _context.Courses 
.AsNoTracking() 

.Include(c => c.Department) 

.FirstOrDefaultAsync(m => m.CourselD == id); 

if (Course == null) 

{ 

return NotFound(); 

} 

return Page(); 


Silme ve Ayrıntılar sayfalarını değiştirme 

Razor Sil sayfasını aşağıdaki biçimlendirmeyle güncelleştirin: 



@page 

@model Contosollniversity. Pages.Counses.DeleteModel 

@{ 

ViewData["Title"] = "Delete"; 

} 

<h2>Delete</h2> 

<h3>Are you sure you want to delete this?</h3> 

<div> 

<h4>Course</h4> 

<hr /> 

<dl class="dl-horizontal"> 

<dt> 

@Html.DisplayNameFor(model => model.Course.CourselD) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Course.CourselD) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Course.Title) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Course.Title) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Course.Credits) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Course.Credits) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Course.Department) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Course.Department.DepartmentlD) 
</dd> 

</dl> 

<form method="post"> 

<input type="hidden" asp-for="Course.CourseID" /> 

<input type="submit" value="Delete" class="btn btn-default" /> | 

<a asp-page="./Index">Back to List</a> 

</form> 

</div> 


Ayrıntılar sayfasında aynı değişiklikleri yapın. 

Kurs sayfalarını test etme 

Test oluşturma, düzenleme, Ayrıntılar ve silme. 

Eğitmen sayfalarını güncelleştirme 

Aşağıdaki bölümlerde, eğitmen sayfaları günceldir. 

Office konumu Ekle 

Bir eğitmen kaydını düzenlediğinizde, eğitmenin Office atamasını güncelleştirmek isteyebilirsiniz, instructor 
Varlığın officeAssignment varlıkla bire sıfır veya-bir ilişkisi vardır. Eğitmen kodu şu şekilde olmalıdır: 

• Kullanıcı Office atamasını temizlediğinde OfficeAssignment varlığı silin. 

• Kullanıcı bir Office ataması girerse ve boşsa, yeni OfficeAssignment bir varlık oluşturun. 







• Kullanıcı Office atamasını değiştirirse officeAssignment varlığı güncelleştirin. 
Eğitmenler düzenleme sayfası modelini aşağıdaki kodla güncelleştirin: 

public class EditModel : PageModel 

{ 

private readonly Contosollniversity.Data.SchoolContext _context; 

public EditModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Instructor Instructor { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Instructor = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.AsNoTracking() 

.FirstOrDefaultAsync(m => m.ID == id); 

if (Instructor == null) 

{ 

return NotFound(); 

} 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int? id) 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var instructorToUpdate = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.FirstOrDefaultAsync(s => s.ID == id); 

if (await TryUpdateModelAsync<Instructor>( 

İnstructorToUpdate, 

"Instructor", 

i => i.FirstMidName, i => i.LastName, 
i = > i.HireDate, i => i.OfficeAssignment)) 

{ 

if (String.IsNullOrWhiteSpace( 

İnstructorToUpdate.OfficeAssignment?.Location)) 

{ 

İnstructorToUpdate.OfficeAssignment = null; 

} 

await _context.SaveChangesAsync(); 

} 

return RedirectToPage("./Index"); 

} 

} 


Yukarıdaki kod: 




• Gezinti officeAssignment özelliği için instructor Eager yüklemesini kullanarak geçerli varlığı veritabanından 
alır. 

• Alınan instructor varlığı model Ciltçideki değerlerle güncelleştirir. TryUpdateModei fazla nakletmeyiönler. 

• Office konumu boşsa, null olarak ayarlar instructor.OfficeAssignment . Null instructor.OfficeAssignment 
olduğunda, OfficeAssignment tablodaki ilgili satır silinir. 

Eğitmen düzenleme sayfasını güncelleştirme 

SayfalarL/eğltmenler/Edit. cshtml dosyasını Office konumuyla güncelleştirin: 

@page 

@model ContosoUniversity.Pages.Instructors.EditModel 

@{ 

ViewData["Title"] = "Edit"; 

} 

<h2>Edit</h2> 

<h4>Instructor</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<input type="hidden" asp-for="Instructor.ID" /> 

<div class="form-group"> 

<label asp-for="Instructor. LastName" class="control-label"x/label> 

<input asp-for="Instructor.LastName" class="form-control" /> 

<span asp-validation-for="Instructor. LastName" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Instructor. FirstMidName" class="control-label"x/label> 

<input asp-for="Instructor.FirstMidName" class="form-control" /> 

<span asp-validation-for="Instructor. FirstMidName" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Instructor.HireDate" class="control-label"x/label> 

<input asp-for="Instructor.HireDate" class="form-control" /> 

<span asp-validation-for="Instructor.HireDate" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Instructor.OfficeAssignment. Location" class="control-label"x/label> 

<input asp-for="Instructor.OfficeAssignment.Location" class="form-control" /> 

<span asp-validation-for="Instructor.OfficeAssignment.Location" class="text-danger" /> 
</div> 

<div class="form-group"> 

<input type="submit" value="Save" class="btn btn-default" /> 

</div> 

</form> 

</div> 

</div> 

<div> 

<a asp-page="./Index">Back to List</a> 

</div> 

@section Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 


Bir eğitmenler ofis konumunu değiştirebildiğinizi doğrulayın. 

Eğitmen düzenleme sayfasına kurs atamaları ekleme 

Eğitmenler, istediğiniz sayıda kurs öğretebilir. Bu bölümde kurs atamalarını değiştirme olanağını eklersiniz. 
Aşağıdaki görüntüde güncelleştirilmiş eğitmen düzenleme sayfası gösterilmektedir: 
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course ve ınstructor çoktan çoğa ilişkisine sahiptir, ilişki eklemek ve kaldırmak için, courseAssignments JOIN 
varlık kümesinden varlık ekleyin ve kaldırın. 

Onay kutuları, bir eğitmenin atandığı kurslara değişiklikler sağlar.Veritabanındaki her kurs için bir onay kutusu 
görüntülenir. Eğitmenin atandığı kurslar denetlenir. Kullanıcı kurs atamalarını değiştirmek için onay kutularını 
seçebilir veya temizleyebilir. Kurs sayısı çok fazlaysa: 


• Kursları göstermek için büyük olasılıkla farklı bir kullanıcı arabirimi kullanıyorsunuz. 

• ilişki oluşturmak veya silmek için bir JOIN varlığını düzenleme yöntemi değişmez. 

Eğitmen sayfaları oluşturma ve düzenleme desteğini desteklemek için sınıflar ekleme 

Aşağıdaki kodla SchoolVievvModels/AssignedCourseData. cs oluşturun: 

namespace ContosoUniversity.Models.SchoolViewModels 
{ 

public class AssignedCourseData 
{ 

public int CourselD { get; set; } 
public string Title { get; set; } 
public bool Assigned { get; set; } 

} 

} 

Sınıfı AssignedCourseData , bir eğitmen tarafından atanan kurslar için onay kutularını oluşturacak verileri içerir. 
Pages/eğitmenler/Komutctorcoursespagemodel. cshtml. cs temel sınıfını oluşturun: 


















using ContosoUniversity.Data; 

using ContosoUniversity.Models; 

using ContosoUniversity.Models.SchoolViewModels; 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using System.Collections.Generic; 

using System.Linq; 

namespace ContosoUniversity.Pages.Instructors 

{ 

public class InstructorCoursesPageModel : PageModel 

{ 


public List<AssignedCourseData> AssignedCourseDataList; 

public void PopulateAssignedCourseData(SchoolContext context, 

Instructor instructor) 

{ 

var allCourses = context.Courses; 

var instructorCourses = new HashSet<int>( 

instructor.CourseAssignments.Select(c => c.CourselD)); 
AssignedCourseDataList = new List<AssignedCourseData>(); 
foreach (var course in allCourses) 

{ 

AssignedCourseDataList.Add(new AssignedCourseData 

{ 

CourselD = course.CourselD, 

Title = course.Title, 

Assigned = instructorCourses.Contains(course.CourselD) 

}); 

} 

} 

public void UpdateInstructorCourses(SchoolContext context, 
string[] selectedCourses, instructor instructorToUpdate) 

{ 

if (selectedCourses == null) 

{ 

İnstructorToUpdate.CourseAssignments = new List<CourseAssignment>(); 
return; 

} 

var selectedCoursesHS = new HashSet<string>(selectedCourses); 
var İnstructorCourses = new HashSet<int> 

(İnstructorToUpdate.CourseAssignments.Select(c => c.Course.CourselD)) 
foreach (var course in context.Courses) 

{ 

if (selectedCoursesHS.Contains(course.CourseID.ToString())) 

{ 

if (!instructorCourses.Contains(course.CourselD)) 

{ 

İnstructorToUpdate.CourseAssignments.Add( 
new CourseAssignment 
{ 

InstructorlD = İnstructorToUpdate.ID, 

CourselD = course.CourselD 

}); 

} 

} 

else 

{ 

if (İnstructorCourses.Contains(course.CourselD)) 

{ 

CourseAssignment courseToRemove 
= İnstructorToUpdate 
.CourseAssignments 

•SingleOrDefault(i => i.CourselD == course.CourselD); 
context.Remove(courseToRemove); 


} 


} 


} 


} 

} 

} 

, instructorCoursesPageModei Düzenleme ve oluşturma sayfa modelleri için kullanacağınız temel sınıftır. 
PopulateAssignedCourseData''Course doldurmak AssignedCourseDataList için tüm varlıkları okur. Her kurs için 
kod, başlığı ve eğitmenin courseiD kursa atanıp atanmadığını belirler. Bir diyez kümesi , verimli aramalar 
oluşturmak için kullanılır. 

Eğitmenler sayfa modelini Düzenle 

Eğitmen düzenleme sayfası modelini aşağıdaki kodla güncelleştirin: 





public class EditModel : InstructorCoursesPageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public EditModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Instructor Instructor { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Instructor = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments).Thenlnclude(i => i.Course) 
.AsNoTrackingO 

.FirstOrDefaultAsync(m => m.ID == id); 

if (Instructor == null) 

{ 

return NotFound(); 

} 

PopulateAssignedCourseData(_context, Instructor); 
return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int? id, string[] selectedCourses) 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var instructorToUpdate = await _context.Instructors 
.Include(i => İ.OfficeAssignment) 

.Include(i => İ.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.FirstOrDefaultAsync(s => s.ID == id); 

if (await TryUpdateModelAsync<Instructor>( 

İnstructorToUpdate, 

"Instructor", 

i => i.FirstMidName, i => i.LastName, 
i => i.HireDate, i => İ.OfficeAssignment)) 

{ 

if (String.IsNullOrWhiteSpace( 

İnstructorToUpdate.OfficeAssignment?.Location)) 

{ 

İnstructorToUpdate.OfficeAssignment = null; 

} 

UpdateInstructorCourses(_context, selectedCourses, İnstructorToUpdate); 
await _context. SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

UpdateInstructorCourses(_context, selectedCourses, İnstructorToUpdate); 
PopulateAssignedCourseData(_context, İnstructorToUpdate); 
return Page(); 

} 

} 



Yukarıdaki kod, Office atama değişikliklerini işler. 


Eğitmen Razor görünümünü güncelleştirin: 

@page 

@model ContosoUniversity.Pages.Instructors.EditModel 

@{ 

ViewData["Title"] = "Edit"; 

} 

<h2>Edit</h2> 

<h4>Instructor</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<input type="hidden" asp-for="Instructor.ID" /> 

<div class="form-group"> 

«clabel asp-for="Instructor. LastName" class="control-label"x/label> 

<input asp-for="Instructor.LastName" class="form-control" /> 

<span asp-validation-for="Instructor. LastName" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Instructor. FirstMidName" class="control-label"x/label> 

<input asp-for="Instructor.FirstMidName" class="form-control" /> 

<span asp-validation-for="Instructor. FirstMidName" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Instructor.HireDate" class="control-label"x/label> 

<input asp-for="Instructor.HireDate" class="form-control" /> 

<span asp-validation-for="Instructor.HireDate" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Instructor.OfficeAssignment. Location" class="control-label"x/label> 

<input asp-for="Instructor.OfficeAssignment.Location" class="form-control" /> 

<span asp-validation-for="Instructor.OfficeAssignment.Location" class="text-danger" /> 
</div> 

<div class="form-group"> 

<div class="col-md-offset-2 col-md-10"> 

<table> 

<tr> 

int cnt = 0; 

foreach (var course in Model.AssignedCourseDataList) 

{ 

if (cnt++ % 3 == 0) 

{ 

@:</trxtr> 

} 

<td> 

<input type="checkbox" 

name="selectedCourses" 

value="@course.CourseID" 

@(Html.Raw(course.Assigned ? "checked=\"checked\"" : "")) /> 
@course.CourseID @course.Title 

</td> 

} 

@:</tr> 

} 

</table> 

</div> 

</div> 

<div class="form-group"> 

<input type="submit" value="Save" class="btn btn-default" /> 

</div> 

</form> 

</div> 



</div> 


<div> 

<a asp-page="./Index">Back to List</a> 

</div> 

@section Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 


NOTE 

Kodu Visual Studio 'Ya yapıştırdığınızda, satır sonları kodu kesen bir şekilde değiştirilir. Otomatik biçimlendirmeyi geri 
almak için CTRL + Z bir kez tuşuna basın. CTRL + Z, burada gördüğünüz gibi görünmeleri için satır sonlarını düzeltir. 
Girintide kusursuz </trxtr> olması gerekmez, ancak @:<td> @:</td>„ve @:</tr> çizgilerinin her biri gösterildiği 

gibi tek bir satırda olması gerekir. Yeni kod bloğu seçiliyken, yeni kodu mevcut kodla hizalamak için üç kez Tab tuşuna 
basın. Bu bağlantı ilebu hatanın durumunu oylayın veya gözden geçirin. 


Yukarıdaki kod, üç sütun içeren bir HTML tablosu oluşturur.Her sütunda bir onay kutusu ve kurs numarasını ve 
başlığını içeren bir açıklamalı alt yazı vardır. Onay kutularının hepsi aynı ada ("Selectedkurslar") sahiptir. Aynı adı 
kullanmak model cildi bir grup olarak kabul etmek üzere bilgilendirir. Her onay kutusunun değer özniteliği 
olarak courseiD ayarlanır. Sayfa gönderildiğinde, model Ciltçi yalnızca seçili onay kutularının courseiD 
değerlerinden oluşan bir dizi geçirir. 

Onay kutuları başlangıçta işlendiğinde, eğitmenin atandığı kursların denetlenen öznitelikleri vardır. 

Uygulamayı çalıştırın ve güncelleştirilmiş eğitmenler düzenleme sayfasını test edin. Bazı kurs atamalarını 
değiştirin. Değişiklikler Dizin sayfasında yansıtılır. 

Not: Eğitim kursu verilerini düzenlemek için buradaki yaklaşım, sınırlı sayıda kurs olduğunda iyi bir şekilde 
gerçekleştirilir. Çok daha büyük olan koleksiyonlar için, farklı bir kullanıcı arabirimi ve farklı bir güncelleştirme 
yöntemi daha erişilebilir ve verimli olacaktır. 

Eğitmenler oluştur sayfasını güncelleştirme 

Aşağıdaki kodla, eğitmen sayfa modeli oluştur sayfasını güncelleştirin: 

using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Instructors 

{ 

public class CreateModel : InstructorCoursesPageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public CreateModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

public IActionResult OnGet() 

{ 

var instructor = new Instructor(); 

instructor.CourseAssignments = new List<CourseAssignment>(); 

// Provides an empty collection for the foreach loop 
// foreach (var course in Model.AssignedCourseDataList) 

// in the Create Razor page. 

PoDulateAssignedCourseData( context. instructort: 





} 


return Page(); 


[BindProperty] 

public Instructor Instructor { get; set; } 

public async Task<IActionResult> OnPostAsync(string[] selectedCourses) 

{ 

if (IModelState.IsValid) 

{ 

retunn Page(); 

} 

var newInstructor = new Instructor(); 
if (selectedCourses != null) 

{ 

newInstructor.CourseAssignments = new List<CourseAssignment>(); 
foreach (var course in selectedCourses) 

{ 

var courseToAdd = new CourseAssignment 

{ 

CourselD = int.Parse(course) 

}; 

newlnstructor.CourseAssignments.Add(courseToAdd); 

} 

} 

if (await TryUpdateModelAsync<Instructor>( 
newInstructor, 

"Instructor ", 

i => i.FirstMidName, i => i.LastName, 
i = > i.HireDate, i => i.OfficeAssignment)) 

{ 

_context.Instructors.Add(newlnstructor); 
await _context. SaveChangesAsync (); 
return RedirectToPage("./Index"); 

} 

PopulateAssignedCourseData(_context , newlnstructor); 
return Page(); 

} 

} 

} 

Yukarıdaki kod, Pages/eğitmenler/Edit. cshtml. cs koduna benzerdir. 

Eğitmen oluşturma Razor sayfasını aşağıdaki biçimlendirmeyle güncelleştirin: 

@page 

@model ContosoUniversity.Pages.Instructors.CreateModel 

@{ 

ViewData["Title"] = "Create"; 

} 

<h2>Create</h2> 

<h4>Instructor</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<div class="form-group"> 

<label asp-for="Instructor. LastName" class="control-label"x/label> 

<input asp-for="Instructor.LastName" class="form-control" /> 

<span asp-validation-for="Instructor. LastName" class="text-danger"x/span> 
</div> 


cdiv class="form-group"> 

<label asp-for="Instructor. FirstMidName" class="control-label"x/label> 

<input asp-for="Instructor.FirstMidName" class="form-control" /> 

<span asp-validation-for="Instructor. FirstMidName" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Instructor.HireDate" class="control-label"x/label> 
cinput asp-for="Instructor.HireDate" class="form-control" /> 

<span asp-validation-for="Instructor.FlireDate" class="text-danger"x/span> 

</div> 

cdiv class="form-group"> 

clabel asp-for="Instructor.OfficeAssignment. Location" class="control-label"x/label> 
cinput asp-for="Instructor.OfficeAssignment.Location" class="form-control" /> 
cspan asp-validation-for="Instructor.OfficeAssignment.Location" class="text-danger" /> 
</div> 

cdiv class="form-group"> 

cdiv class="col-md-offset-2 col-md-10"> 

<table> 

<tr> 

int cnt = 0; 

foreach (var course in Model.AssignedCourseDataList) 

{ 

if (cnt++ % 3 == 0) 

{ 

@:</trxtr> 

} 

<td> 

cinput type="checkbox" 

name="selectedCourses" 

value="@course.CourseID" 

@(Fltml.Raw(course.Assigned ? "checked=\"checked\"" : "")) /> 
@course.CourseID @course.Title 

c/td> 

} 

@:c/tr> 

} 

c/table> 

c/div> 

c/div> 

cdiv class="form-group"> 

cinput type="submit" value="Create" class="btn btn-default" /> 
c/div> 
c/form> 
c/div> 
c/div> 

cdiv> 

ca asp-page="Index">Back to Listc/a> 
c/div> 

@section Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 


Eğitmen oluşturma sayfasını test edin. 

Silme sayfası 


Delete sayfa modeli aşağıdaki kodla güncelleştirin: 


using ContosoUniversity.Models; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using Microsoft.EntityFrameworkCore; 

using System.Linq; 

using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Instructors 

{ 

public class DeleteModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public DeleteModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Instructor Instructor { get; set; } 

public async Task<IActionResult> OnGetAsync(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

Instructor = await _context.Instructors.SingleAsync(m => m.ID == id); 

if (Instructor == null) 

{ 

return NotFound(); 

} 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int id) 

{ 

Instructor instructor = await _context.Instructors 
.Include(i => i.CourseAssignments) 

•SingleAsync(i => i.ID == id); 

var departments = await _context.Departments 
.Where(d => d.InstructorlD == id) 

.ToListAsync(); 

departments.ForEach(d => d.InstructorlD = null); 

_context.Instructors.Remove(instructor); 

await _context. SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

} 

} 


Yukarıdaki kod aşağıdaki değişiklikleri yapar: 

• courseAssignments Gezinti özelliği için Eager yüklemesi kullanır. courseAssignments eğitmen silindiğinde, 
dahil edilmiş veya silinmemelidir. Bunları okumaktan kaçınmak için, veritabanında basamaklı silme 'yı 
yapılandırın. 

• Silinecek eğitmen herhangi bir departmanların Yöneticisi olarak atanırsa, bu departmanlardan eğitmen 
atamasını kaldırır. 





Ek kaynaklar 

• Bu öğreticinin YouTube sürümü (Bölüm 1) 

• Bu öğreticinin YouTube sürümü (Bölüm 2) 


ÖNCEKİ 
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ASP.NET CORE'DA - EŞZAMANLILIK - 8 8 EF ÇEKİRDEKLİ RAZOR 



SAYFALARI 






ASRNET core'da - eşzamanlılık - 8 8 EF çekirdekli 
Razor sayfaları 

23.11.2019 • 51 minutes to read ı Edit Online 


Tarafından Rick Anderson, Tom Dykstra, ve Jon P Smith 

Contoso Üniversitesi web uygulaması, EF Core ve Visual Studio kullanarak Razor Pages Web uygulamaları 
oluşturmayı gösterir. Öğretici serisi hakkında daha fazla bilgi için ilk öğreticiyebakın. 

Çözemediğiniz sorunlarla karşılaşırsanız, Tamamlanmış uygulamayı indirin ve öğreticiyi izleyerek bu kodu 
oluşturduğunuz şekilde karşılaştırın. 

Bu öğreticide, birden çok kullanıcı aynı anda (aynı anda) bir varlık güncelleştirdiğinizde çakışmalarına 
gösterilmektedir. 

Eşzamanlılık çakışmaları 

Bir eşzamanlılık çakışması ortaya olduğunda: 

• Bir kullanıcı bir varlığın düzenleme sayfasına götürür. 

• ilk kullanıcının değişikliği veritabanına yazılmadan önce, başka bir kullanıcı aynı varlığı güncelleştirir. 

Eşzamanlılık algılama etkinleştirilmemişse, veritabanını güncelleştirme son olarak diğer kullanıcının 
değişikliklerinin üzerine yazılır. Bu risk kabul edilebilir ise, eşzamanlılık için programlama maliyeti avantaja 
aykırı bir ücret verebilir. 

Kötümser eşzamanlılık (kilitleme) 

Eşzamanlılık çakışmalarını önlemenin bir yolu veritabanı kilitlerini kullanmaktır. Bu, Kötümser eşzamanlılık 
olarak adlandırılır. Uygulama, güncelleştirmeyi amaçladığı bir veritabanı satırını okumadan önce bir kilit ister. 
Bir satır, güncelleştirme erişimi için kilitlendiğinde, ilk kilit yayımlanıncaya kadar başka hiçbir kullanıcının satırı 
kilitlemesine izin verilmez. 

Kilitleri yönetmek dezavantajlara sahiptir. Program, karmaşık olabilir ve Kullanıcı sayısı arttıkça performans 
sorunlarına neden olabilir. Entity Framevvork Core, BT için yerleşik destek sağlamaz ve bu öğretici Bu 
öğreticinin nasıl uygulanacağını göstermez. 

İyimser eşzamanlılık 

İyimser eşzamanlılık eşzamanlılık çakışmalarını olmasını sağlar ve tepki verdiğini uygun olduğunda bunlar 
yapın. Örneğin, Jane departmanı Düzen sayfasını ziyaret ve İngilizce departmanı için bütçe 350,000.00 $0,00 
değiştirir. 
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Gamze önce Kaydet 1 i tıklatır ve değişiklik etkin duruma geçer çünkü tarayıcı Dizin sayfasını bütçe miktarı 
olarak sıfır ile görüntülüyor. 

John tıkladığında Kaydet yine de bir bütçe $350,000.00 birini gösteren bir Düzenle sayfasında. Sonraki durum 
eşzamanlılık çakışmalarını nasıl işleydiğinize göre belirlenir: 

• Bir kullanıcının hangi özelliği değiştirdiği ve yalnızca ilgili sütunları veritabanında güncelleştirdiğinden 
haberdar olabilirsiniz. 

Bu senaryoda, veri kaybolacak. Farklı özellikler iki kullanıcı tarafından güncelleştirildi. Biri İngilizce, 
departman gözatar sonraki açışınızda Gamze'nin hem Çan'ın değişiklikleri görürler. Bu güncelleştirme 
yöntemini, veri kaybına neden olabilecek çakışmaları sayısını azaltabilirsiniz. Bu yaklaşım bazı 
dezavantajlara sahiptir: 

o Aynı özelliğe rakip bir değişiklik yaptıysanız, veri kaybını önlemek olamaz, 
o Genellikle bir web uygulaması pratik değildir.Tüm getirilen ve yeni değerleri izlemek için önemli 
durum koruma gerektiriyor. Büyük miktarlarda durumu bakımını yapma, uygulama performansını 
etkileyebilir. 

o Bir varlıkta eşzamanlılık algılama ile karşılaştırıldığında app karmaşıklığı artırabilirsiniz. 

• Gamze'nin değişikliğinin üzerine Çan'ın değişiklik sağlayabilirsiniz. 

Sonraki biri İngilizce departmanı gözatar, 1/9/2013 görürler ve getirilen $350,000.00 değeri. Bu 
yaklaşım olarak adlandırılan bir istemci WINS veya VVINS'te son senaryo, (istemciden gelen tüm 
değerler veri deposunda yer alacak şekilde önceliklidir.) Eşzamanlılık işleme için herhangi bir kodlama 
yapmazsanız, İstemci WINS otomatik olarak gerçekleşir. 

• John 'un değişikliğini veritabanında güncelleştirilmesini engelleyebilirsiniz. Genellikle, bir uygulamayı 
atadığınız: 

o Bir hata iletisi görüntüler, 
o Verilerin geçerli durumunu gösterir, 
o Değişiklikleri uygulamak verin. 

Bu adlı bir Store WINS senaryo. (Veri deposu değerleri, istemci tarafından gönderilen değerlere göre 
önceliklidir.) Bu öğreticide mağaza WINS senaryosunu uygulamanız gerekir. Bu yöntem, hiçbir 
değişiklik uyarı bir kullanıcı kılınmamasını sağlar. 

EF Core çakışma algılama 

EF Core, çakışmalar algıladığında DbConcurrencyException özel durum oluşturur. Çakışma algılamayı 
etkinleştirmek için veri modeli yapılandırılmalıdır. Çakışma algılamayı etkinleştirme seçenekleri şunlardır: 

• EF Core, Update ve DELETE komutlarının VVFIERE yan tümcesinde eşzamanlılık belirteçleri olarak 
yapılandırılan sütunların özgün değerlerini içerecek şekilde yapılandırın. 

Savechanges çağrıldığında VVHERE yan tümcesi ConcurrencyCheck özniteliğiyle açıklama eklenmiş 
herhangi bir özelliğin özgün değerlerini arar. Update deyimleri, satır ilk okunduğundan bu yana 
eşzamanlılık belirteci özelliklerinden herhangi biri değiştiyse güncelleştirilecek bir satır bulmayacaktır. 

EF Core eşzamanlılık çakışması olarak yorumlar. Birçok sütunu olan veritabanı tablolarında bu yaklaşım 
çok büyük VVHERE yan tümceleriyle sonuçlanabilir ve büyük miktarlarda durum gerektirebilir. Bu 
nedenle bu yaklaşım genellikle önerilmez ve bu öğreticide kullanılan yöntem değildir. 

• Veritabanı tablosunda, bir satırın ne zaman değiştirildiğini belirlemede kullanılabilecek bir izleme sütunu 
ekleyin. 

SQL Server veritabanında, izleme sütununun veri türü rowversion . rowversion değeri, satır her 
güncelleştirildiği zaman artılan sıralı bir sayıdır. Bir Update veya delete komutunda VVHERE yan 







tümcesi, izleme sütununun (orijinal satır sürüm numarası) orijinal değerini içerir. Güncelleştirilmekte 
olan satır başka bir kullanıcı tarafından değiştirilmişse, rowversion sütunundaki değer özgün değerden 
farklıdır. Bu durumda, Update veya DELETE deyimi VVHERE yan tümcesi nedeniyle güncelleştirilecek 
satırı bulamıyor. Bir Update veya delete komutundan hiçbir satır etkilenmeden EF Core eşzamanlılık 
özel durumu oluşturur. 

İzleme özelliği Ekle 

içinde Models/Department.cs, RovvVersion adlı izleme özelliği ekleyin: 

using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUnivensity.Models 

{ 

public class Department 

{ 

public int DepartmentlD { get; set; } 

[StringLength(50, MinimumLength = 3)] 
public string Name { get; set; } 

[DataType(DataType.Currency)] 

[Column(TypeName = "money")] 
public decimal Budget { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}"j ApplyFormatlnEditMode = true)] 

[Display(Name = "Start Date")] 

public DateTime StartDate { get; set; } 

public int? InstructorlD { get; set; } 

[Timestamp] 

public byte[] RowVersion { get; set; } 

public Instructor Administrator { get; set; } 
public ICollection<Course> Courses { get; set; } 

} 

} 


Timestamp özniteliği sütunu eşzamanlılık izleme sütunu olarak tanımlar. Fluent API, izleme özelliğini 
belirtmenin alternatif bir yoludur: 

modelBuilder.Entity<Department>() 

.Property<byte[]>("RowVersion") 

.IsRowVersion(); 


• Visual Studio 

• Visual Studio Code 

Bir SQL Server veritabanı için, bayt dizisi olarak tanımlanan bir varlık özelliğindeki [Timestamp] özniteliği: 

• Sütunun VVHERE yan tümceleri DELETE ve UPDATE 'e dahil edilmesini sağlar. 

• Veritabanındaki sütun türünü rovvversionolarak ayarlar. 

Veritabanı, satır her güncelleştirildiği zaman artılan sıralı bir satır sürüm numarası oluşturur. Bir update veya 
Delete komutunda, where yan tümcesi getirilen satır sürümü değerini içerir. Güncelleştirilmekte olan satır 









getirilmesinden sonra değiştiyse: 


Geçerli satır sürümü değeri getirilen değerle eşleşmiyor. 

where yan tümcesi getirilen satır sürümü değerini aradığı için update veya Delete komutları bir satır 
bulamaz. 

A DbUpdateConcurrencyException oluşturulur. 


Aşağıdaki kod, T-SQL bölüm adını güncelleştirildiğinde EF Core tarafından oluşturulan bir bölümü 
gösterilmektedir: 


SET NOCOUNT ON; 

UPDATE [Department] SET [Name] = @p0 

UIHERE [DepartmentlD] = @pl AND [RowVersion] = @p2; 

SELECT [RowVersion] 

FROM [Department] 

WHERE @@ROWCOUNT = 1 AND [DepartmentlD] = @pl; 

Önceki kodun gösterdiği vurgulanmış where yan tümcesi içeren Rowversion . Veritabanı Rowversion 
Rowversion parametresine eşit değilse ( @p2 ), hiçbir satır güncellenmez. 


Aşağıdaki vurgulanmış kodu tam olarak bir satır güncellenmedi doğrular T-SQL gösterir: 

SET NOCOUNT ON; 

UPDATE [Department] SET [Name] = @p0 

UIHERE [DepartmentlD] = @pl AND [RowVersion] = @p2; 

SELECT [RowVersion] 

FROM [Department] 

WHERE @@ROWCOUNT = 1 AND [DepartmentlD] = @pl; 


@@ROWCOUNT son deyiminden etkilenen satır sayısını döndürür. Hiçbir satır güncellenmemişse, EF Core bir 
DbUpdateConcurrencyException oluşturur. 

Veritabanını güncelleştirme 

Rowversion özelliği eklendiğinde geçiş gerektiren veri modeli değişir. 

Projeyi oluşturun. 

• Visual Studio 

• Visual Studio Code 

• PMC'de şu komutu çalıştırın: 

Add-Migration RowVersion 


Bu komut: 

• Geçişieri/izaman damgası}_RowVersion. cs geçiş dosyasını oluşturur. 

• Güncelleştirmeleri Migrations/SchoolCorıtextModelSnapshot.cs dosya. Bu güncelleştirme aşağıdaki 
vurgulanmış kodu ekler BuiidModei yöntemi: 















modelBuilder.Entity("ContosoUniversity.Models.Department ", b => 

{ 

b.Property<int>("DepartmentID") 

. ValueGeneratedOnAdd() 

.HasAnnotation("SqlServer:ValueGenerationStrategy", 
SqlServerValueGenerationStrategy.IdentityColumn); 

b.Property<decimal>("Budget") 

.HasColumnType("money"); 

b.Property<int?>("InstructorlD"); 

b.Property<string>("Name") 

.HasMaxl_ength(50); 

b.Property<byte[]>("RowVersion") 

.IsConcurrencyToken() 

. ValueGeneratedOnAddOrllpdate(); 

b.Property<DateTime>("StartDate"); 

b.HasKey("DepartmentlD"); 

b.Haslndex("InstructorlD"); 

b.ToTable("Department"); 

}); 


• Visual Studio 

• Visual Studio Code 

• PMC'de şu komutu çalıştırın: 


Update-Database 


Yapı iskelesi departmanı sayfaları 

• Visual Studio 

• Visual Studio Code 

• Aşağıdaki özel durumlarla birlikte Yapı Fkatlama öğrenci sayfalarındaki yönergeleri izleyin: 

• Sayfalar/departmanlar klasörü oluşturun. 

• Model sınıfı için Department kullanın. 

o Yeni bir tane oluşturmak yerine var olan bağlam sınıfını kullanın. 

Projeyi oluşturun. 

Dizin sayfasını Güncelleştir 

Scafkatlama aracı Dizin sayfası için bir Rowversion sütunu oluşturdu, ancak bu alan bir üretim uygulamasında 
gösterilmemelidir. Bu öğreticide, eşzamanlılık işlemenin nasıl çalıştığını göstermeye yardımcı olmak için 
Rowversion son baytı görüntülenir. Son baytın kendi kendine benzersiz olması garanti edilmez. 

Pages\Departmerıts\lndex.cshtml sayfasını güncelleştir: 


• Dizin bölümlerine değiştirin. 






• Yalnızca bayt dizisinin son baytını göstermek için Rowversion içeren kodu değiştirin. 

• FirstMidName tam adı ile değiştirin. 

Aşağıdaki kod, güncelleştirilmiş sayfayı gösterir: 

@page 

@model Contosollniversity.Pages.Departments.IndexModel 

@{ 

ViewData["Title"] = "Departments"; 

} 

<h2>Departments</h2> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<table class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model => model.Department[0].Name) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Department[0].Budget) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Department[0].StartDate) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Department[0].Administrator) 

</th> 

<th> 

RowVersion 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

(Şforeach (var item in Model.Department) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Name) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Budget) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.StartDate) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Administrator.FullName) 

</td> 

<td> 

@item.RowVersion[7] 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.DepartmentID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.DepartmentID">Details</a> | 
<a asp-page="./Delete" asp-route-id="@item.DepartmentID">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 




Düzenleme sayfa modeli güncelleştirme 

Aşağıdaki kodla Pages\Departments\Edit.cshtml.cs güncelleştirin: 

using ContosoUniversity.Data; 

using ContosoUniversity.Models; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using Microsoft.AspNetCore.Mvc.Rendering; 

using Microsoft.EntityFrameworkCore; 

using System.Linq; 

using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Departments 

{ 

public class EditModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public EditModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Department Department { get; set; } 

// Replace ViewData["InstructorID"] 

public SelectList InstructorNameSL { get; set; } 

public async Task<IActionResult> OnGetAsync(int id) 

{ 

Department = await _context.Departments 

.Include(d => d.Administrator) // eager loading 
.AsNoTracking() // tracking not required 

.FirstOrDefaultAsync(m => m.DepartmentlD == id); 

if (Department == null) 

{ 

return NotFound(); 

} 

// Use strongly typed data rather than ViewData. 

InstructorNameSL = new SelectList(_context.Instructors, 

"ID", "FirstMidName"); 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int id) 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var departmentToUpdate = await _context.Departments 
.Include(i => i.Administrator) 

.FirstOrDefaultAsync(m => m.DepartmentlD == id); 

if (departmentToUpdate == null) 

{ 

return HandleDeletedDepartment(); 

} 

_context.Entry(departmentToUpdate) 

.Property("RowVersion").OriginalValue = Department.RowVersion; 


it (await TryUpdateModelAsync<Department>( 
departmentToUpdate, 

"Department", 

s => s.Name, s => s.StartDate, s => s.Budget, s => s.InstructorlD)) 

{ 

try 

{ 

await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

catch (DbUpdateConcurrencyException ex) 

{ 

var exceptionEntry = ex.Entries.Single(); 
var clientValues = (Department)exceptionEntry.Entity; 
var databaseEntry = exceptionEntry.GetDatabaseValues(); 
if (databaseEntry == null) 

{ 

ModelState.AddModelError(string.Empty, "Unable to save. " + 
"The department was deleted by another user."); 
return Page(); 

} 

var dbValues = (Department)databaseEntry.ToObject(); 
await setDbErrorMessage(dbValues, clientValues, _context); 

// Save the current RowVersion so next postback 
// matches unless an new concurrency issue happens. 

Department.RowVersion = (byte[])dbValues.RowVersion; 

// Clear the model error for the next postback. 

ModelState.Remove("Department.RowVersion"); 

} 

} 

InstructorNameSL = new SelectList(_context.Instructors, 

"ID", "FullName", departmentToUpdate.InstructorlD); 

return Page(); 


private IActionResult HandleDeletedDepartment() 

{ 

var deletedDepartment = new Department(); 

// ModelState contains the posted data because of the deletion error 
// and will overide the Department instance values when displaying Page(). 
ModelState.AddModelError(string.Empty, 

"Unable to save. The department was deleted by another user."); 
InstructorNameSL = new SelectList(_context.Instructors, "ID", "FullName", 
Department.InstructorlD); 

return Page(); 

} 

private async Task setDbErrorMessage(Department dbValues, 

Department clientValues, SchoolContext context) 

{ 

if (dbValues.Name != clientValues.Name) 

{ 

ModelState.AddModelError("Department.Name", 

$"Current value: (dbValues.Name}"); 

} 

if (dbValues.Budget != clientValues.Budget) 

{ 

ModelState.AddModelError("Department.Budget", 

$"Current value: (dbValues.Budgetrc}"); 

} 

if (dbValues.StartDate != clientValues.StartDate) 

{ 

ModelState.AddModelError("Department.StartDate", 

$"Current value: (dbValues.StartDate:d}"); 


} 

if (dbValues.InstructorlD != clientValues.InstructorlD) 

{ 

Instructor dblnstructor = await _context.Instructors 
.FindAsync(dbValues.InstructorlD); 

ModelState.AddModelError("Department.InstructorlD", 

$"Current value: {dblnstructor?.FullName}"); 

} 

ModelState.AddModelError(string.Empty, 

"The record you attempted to edlt " 

+ "was modified by another user after you. The " 

+ "edit operation was canceled and the current values in the database " 
+ "have been displayed. If you stili want to edit this record., click " 

+ "the Save button again."); 

} 

} 

} 


OriginalValue , onGet yönteminde alındığı sırada varlıktaki rowversion değeriyle güncelleştirilir. EF Core 
özgün içeren bir VVHERE yan tümcesi ile SQL güncelleştirme komut oluşturur Rowversion değeri. Hiçbir satır 
güncelleştirme komutu tarafından etkileniyorsanız (hiçbir satır özgün sahip Rowversion değer), 
DbUpdateConcurrencyException Özel durumu oluşturulur. 


public async Task<IActionResult> OnPostAsync(int id) 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var departmentToUpdate = await _context.Departments 
.Include(i => i.Administrator) 

.FirstOrDefaultAsync(m => m.DepartmentlD == id); 

if (departmentToUpdate == null) 

{ 

return HandleDeletedDepartment(); 

} 

_context.Entry(departmentToUpdate) 

.Property("RowVersion").OriginalValue = Department.RowVersion; 


Vurgulanan kodda: 

• Department.Rowversion değeri, ilk olarak düzenleme sayfasına yönelik GET isteğine getirilen varlıkta yer alır. 
Değer, düzenlenecek varlığı görüntüleyen Razor sayfasındaki gizli bir alan tarafından onPost yöntemine 
sağlanır. Gizli alan değeri model cildi tarafından Department.Rowversion 1 a kopyalanır. 

• OriginalValue VVHERE yan tümcesinde kullanılacak EF Core. Vurgulanan kod satırı çalıştırılmadan önce, 

FirstorDefaultAsync Bu yöntemde çağrıldığında, düzenleme sayfasında görüntülendiklerden farklı olabilen 
OriginalValue veritabanında bulunan değeri vardır. 

• Vurgulanan kod, EF Core SQL UPDATE ifadesinin VVHERE yan tümcesindeki görüntülenen Department 
varlığındaki özgün Rowversion değerini kullandığından emin olur. 

Bir eşzamanlılık hatası oluştuğunda, aşağıdaki vurgulanmış kod istemci değerlerini (Bu yönteme gönderilen 
değerler) ve veritabanı değerlerini alır. 











if (await TryUpdateModelAsync<Department>( 
departmentTolIpdate, 

"Department", 

s => s.Name, s => s.StartDate, s => s.Budget, s => s.InstructorlD)) 

{ 

try 

{ 

await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

catch (DbUpdateConcurrencyException ex) 

{ 

var exceptionEntry = ex.Entries.Single(); 
var clientValues = (Department)exceptionEntry.Entity; 
var databaseEntry = exceptionEntry.GetDatabaseValues(); 
if (databaseEntry == null) 

{ 

ModelState.AddModelError(string.Empty, "Unable to save. " + 
"The department was deleted by another user."); 
return Page(); 

} 

var dbValues = (Department)databaseEntry.ToObject(); 
await setDbErrorMessage(dbValues, clientValues, _context); 

// Save the current RowVersion so next postback 
// matches unless an new concurrency issue happens. 

Department.RowVersion = (byte[])dbValues.RowVersion; 

// Clear the model error for the next postback. 

ModelState.Remove("Department.RowVersion"); 


Aşağıdaki kod, onPostAsync gönderilen değerden farklı veritabanı değerleri olan her bir sütun için özel bir hata 
iletisi ekler: 




private async Task setDbErrorMessage(Department dbValues, 

Department clientValues, SchoolContext context) 

{ 

if (dbValues.Name != clientValues.Name) 

{ 

ModelState.AddModelError("Department.Name", 

$"Current value: {dbValues.Name}"); 

} 

if (dbValues.Budget != clientValues.Budget) 

{ 

ModelState.AddModelError("Department.Budget", 

$"Current value: {dbValues.Budget:c}"); 

} 

if (dbValues.StartDate != clientValues.StartDate) 

{ 

ModelState.AddModelError("Department.StartDate", 

$"Current value: {dbValues.StartDate:d}"); 

} 

if (dbValues.InstructorlD != clientValues.InstructorlD) 

{ 

Instructor dblnstructor = await _context.Instructors 
.FindAsync(dbValues.InstructorlD); 

ModelState.AddModelError("Department.InstructorlD", 

$"Current value: {dblnstructor?.FullName}"); 

} 

ModelState. AddModelError(string. Empty, 

"The record you attempted to edit " 

+ "was modified by another user after you. The " 

+ "edit operation was canceled and the current values in the database " 

+ "have been displayed. If you stili want to edit this record, click " 

+ "the Save button again."); 

} 

Aşağıdaki vurgulanan kod, Rowversion değerini veritabanından alınan yeni değer olarak ayarlar. Kullanıcının 
bir sonraki tıklayışında Kaydet, düzenleme sayfası son görüntülenmesini yakalandı beri gerçekleşen 
eşzamanlılık hataları. 




if (await TryUpdateModelAsync<Department>( 
departmentToUpdate, 

"Department ", 

s => s.Name, s => s.StartDate, s => s.Budget, s => s.InstructorlD)) 

{ 

try 

{ 

await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

catch (DbUpdateConcurrencyException ex) 

{ 

var exceptionEntry = ex.Entries.Single(); 
var clientValues = (Department)exceptionEntry.Entityj 
var databaseEntry = exceptionEntry.GetDatabaseValues(); 
if (databaseEntry == null) 

{ 

ModelState.AddModelError(string.Empty, "Unable to save. " + 

"The department was deleted by another user."); 
return Page(); 

} 

var dbValues = (Department)databaseEntry.ToObject(); 
await setDbErrorMessage(dbValues, clientValues, _context); 

// Save the current RowVersion so next postback 
// matches unless an new concurrency issue happens. 

Department.RowVersion = (byte[])dbValues.RowVersion; 

// Clear the model error for the next postback. 

ModelState.Remove("Department.RowVersion"); 

} 

ModelState.Remove Deyimi, çünkü gereklidir ModelState eski olan Rowversion değeri. Razor Sayfası'nda 
ModelState değerinin ikisi de mevcut olduğunda alan üzerinde model özellik değerlerini öncelik kazanır. 


Razor sayfasını güncelleştirme 

Sayfaları/departmanian/Düzenie. cshtml 'yi aşağıdaki kodla güncelleştirin: 




@page "{id:int}" 

@model ContosoUniversity.Pages.Departments.EditModel 

@{ 

ViewData["Title"] = "Edit"; 

} 

<h2>Edit</h2> 
ch4>Departmentc/h4> 
chr /> 

<div class="row"> 

<div class="col-md-4"> 
cform method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<input type="hidden" asp-for="Department.DepartmentID" /> 

<input type="hidden" asp-for="Department.RowVersion" /> 

<div class="form-group"> 

<label>RowVersion</label> 

@Model.Department.RowVersion[7] 

</div> 

<div class="form-group"> 

<label asp-for="Department.Name" class="control-label"x/label> 

«cinput asp-for="Department.Name" class="form-control" /> 

<span asp-validation-for=" Department .Name" class="text-danger"x/span> 
</div> 

<div class="form-group"> 

clabel asp-for="Department. Budget" class="control-label"x/label> 
cinput asp-for="Department.Budget" class="form-control" /> 
cspan asp-validation-for="Department.Budget" class="text-danger"x/span> 
</div> 

cdiv class="form-group"> 

clabel asp-for="Department.StartDate" class="control-label">c/label> 
cinput asp-for="Department.StartDate" class="form-control" /> 
cspan asp-validation-for="Department.StartDate" class="text-danger"> 
c/span> 
c/div> 

cdiv class="form-group"> 

clabel class="control-label">Instructorc/label> 
cselect asp-for="Department.InstructorlD" class="form-control" 
asp-items="@Model. InstructorNameSL"x/select> 
cspan asp-validation-for="Department.InstructorlD" class="text-danger"> 
c/span> 
c/div> 

cdiv class="form-group"> 

cinput type="submit" value="Save" class="btn btn-primary" /> 
c/div> 
c/form> 
c/div> 
c/div> 
cdiv> 

ca asp-page="./Index">Back to Listc/a> 
c/div> 

@section Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 


Yukarıdaki kod: 

• Güncelleştirmeleri page gelen yönerge @page için @page "{id:int}" . 

• Gizli satır sürümü ekler. RowVersion POST geri değere bağlar, böylece eklenmesi gerekir. 

• Son baytı görüntüler Rowversion hata ayıklama amacıyla. 

• Değiştirir viewData türü kesin belirlenmiş ile instructorNameSL . 

Eşzamanlılık çakışmalarını düzenleme sayfası ile test 

iki tarayıcılar örneklerinde düzenleme İngilizce departmanı açın: 









• Uygulamayı çalıştırın ve bölümleri seçin. 

• Sağ Düzenle seçin ve İngilizce departmanı için köprü yeni sekmede aç. 

• Birinci sekmede tıklayın Düzenle İngilizce departmanı için köprü. 

Aynı bilgilerin iki tarayıcı sekmeleri görüntüleyin. 

' A tıklayın ve ilk tarayıcı sekmesine adını değiştirmek Kaydet. 

Contoso University 

Edit 

Department 

RovvVersion 201 

Name 

Languages 

Budget 

350000.00 

Start Date 
09/01/2013 

Instructor 

Kim * 


Save 


Tarayıcı değiştirilen değer ve güncelleştirilmiş rowVersion göstergesi ile dizin sayfası gösterilir. 
Güncelleştirilmiş rovvVersion göstergesi, Not, ikinci geri göndermenin diğer sekmesinde görüntülen 

ikinci bir tarayıcı sekmesinde farklı bir alana değiştirin. 












Contoso University 

Edit 

Department 

RovvVersion 201 

Name 

English 

Budget 

50000C| 

Start Date 
09/01/2013 

Instructor 

Kim 


Save 


Kaydet'e tıklayın. Veritabanı değerleriyle eşleşmeyen tüm alanlar için hata iletileri görürsünüz: 

Contoso University 

Edit 

Department 

• The record you attempted to edit was modified by another user 
after you. The edit operation was canceled and the current values 
in the database have been displayed. If you stili want to edit this 
record, click the Save button again. 

RovvVersion 229 

Name 

English 

Current value: Languages 
Budget 
500000 

Current value: $350,000.00 
Start Date 
09/01/2013 















Ad alanı değiştirmek bu tarayıcı penceresini düşünmediğiniz. Kopyalama ve geçerli değerin (dil) adı alanına 
yapıştırın. Sekme genişletme. İstemci tarafı doğrulaması hata iletisini kaldırır. 

Tıklayın Kaydet yeniden, ikinci tarayıcı sekmesinde girdiğiniz değer kaydedilir. Dizin sayfasında kaydedilen 
değerler görürsünüz. 

Silme sayfası 

Sayfaları/departmanlan/delete. cshtml. cs öğesini aşağıdaki kodla güncelleştirin: 

using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.EntityFrameworkCore; 
using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Departments 

{ 

public class DeleteModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public DeleteModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Department Department { get; set; } 
public string ConcurrencyErrorMessage { get; set; } 

public async Task<IActionResult> OnGetAsync(int id, bool? concurrencyError) 

{ 

Department = await _context.Departments 
.Include(d => d.Administrator) 

.AsNoTracking() 

.FirstOrDefaultAsync(m => m.DepartmentlD == id); 

if (Department == null) 

{ 

return NotFound(); 

} 

if (concurrencyError.GetValueOrDefault()) 

{ 

ConcurrencyErrorMessage = "The record you attempted to delete " 

+ "was modified by another user after you selected delete. " 

+ "The delete operation was canceled and the current values in the " 

+ "database have been displayed. If you stili want to delete this " 

+ "record, click the Delete button again."; 

} 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int id) 

{ 

try 

{ 

if (await _context.Departments.AnyAsync( 
m => m.DepartmentlD == id)) 

{ 

// Department.rowVersion value is from when the entity 
// was fetched. If it doesn't match the DB, a 
// DbUpdateConcurrencyException exception is thrown. 

_context.Departments.Remove(Department); 
await _context.SaveChangesAsync(); 


} 


} 


} 


} 

return RedirectToPage("./Index"); 

} 

catch (DbllpdateConcurrencyException) 

{ 

retunn RedirectToPage("./Delete", 

new { concurrencyError = true, id = id }); 

} 


Varlık getirildi sonra değiştiğinde silme sayfası eşzamanlılık çakışmalarını algılar. Department.Rowversion Varlık 
getirildi satır sürümü andır. EF Core SQL DELETE komutu oluşturduğunda, VVHERE yan tümcesi ile içerdiği 
Rowversion . Sıfır satır SQL DELETE komutu sonuçları etkileniyorsa: 


• SQL DELETE komutundaki Rowversion veritabanındaki Rowversion eşleşmiyor. 

• DbUpdateConcurrencyException özel durum oluşturulur. 

• OnGetAsync çağrılır concurrencyError . 


Razor Sil sayfasını Güncelleştir 

Güncelleştirme Pages/Departments/Delete.cshtml aşağıdaki kod ile: 








@page "{id:int}" 

@model ContosoUniversity.Pages.Departments.DeleteModel 

@{ 

Vİ 0 wData["Title"] = "Delete"; 

} 

<h2>Delete</h2> 

<p class="text-danger">@Model.ConcurrencyErrorl' / lessage</p> 

<h3>Are you sure you want to delete this?</h3> 

<div> 

<h4>Department</h4> 

<hr /> 

<dl class="dl-horizontal"> 

<dt> 

@Html.DisplayNameFor(model => model.Department.Name) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Department.Name) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Department.Budget) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Department.Budget) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Department.StartDate) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Department.StartDate) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Department.RowVersion) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Department.RowVersion[7]) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Department.Administrator) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Department.Administrator.FullName) 
</dd> 

</dl> 

<form method="post"> 

<input type="hidden" asp-for="Department.DepartmentID" /> 

<input type="hidden" asp-for="Department.RowVersion" /> 

<div class="form-actions no-color"> 

<input type="submit" value="Delete" class="btn btn-danger" /> | 

<a asp-page="./Index">Back to List</a> 

</div> 

</form> 

</div> 


Yukarıdaki kod aşağıdaki değişiklikleri yapar: 

• Güncelleştirmeleri page gelen yönerge @page için @page "{id:int}" . 

• Bir hata iletisi ekler. 

• FullName FirstMidName değiştirir yönetici alan. 

• Değişiklikleri RowVersion son bayt görüntülenecek. 







• Gizli satır sürümü ekler. RowVersion eklenmesi gerekir, çünkü postgit ekleme geri eklemesi değeri bağlar. 

Eşzamanlılık çakışmalarını test et 

Test bölümü oluşturun. 

iki tarayıcılar örneklerinde DELETE test departmanı açın: 

• Uygulamayı çalıştırın ve bölümleri seçin. 

• Sağ Sil seçin ve test departmanı için köprü yeni sekmede aç. 

• Tıklayın Düzenle köprü test bölümü için. 

Aynı bilgilerin iki tarayıcı sekmeleri görüntüleyin, 
ilk tarayıcı sekmesine bütçede değiştirip'ı Kaydet. 

Tarayıcı değiştirilen değer ve güncelleştirilmiş rowVersion göstergesi ile dizin sayfası gösterilir. 
Güncelleştirilmiş rovvVersion göstergesi, Not, ikinci geri göndermenin diğer sekmesinde görüntülenir. 

ikinci sekmeden test departmanını silin. Veritabanında geçerli değerlerle birlikte bir eşzamanlılık hatası 
görüntülenir. Tıklayarak Sil sürece varlığını siler Rowversion updated.department silinmiş olmuştur. 

Ek kaynaklar 

• EF Core eşzamanlılık belirteçleri 

• EF Core eşzamanlılık işleme 

• 2.x kaynağı AS P.N ET Core hata ayıklaması 

Sonraki adımlar 

Bu, serideki son öğreticidir. Bu öğretici serisinin MVC sürümündeek konular ele alınmıştır. 


ÖNCEKİ 

ÖĞRETİCİ 


Bu öğreticide, birden çok kullanıcı aynı anda (aynı anda) bir varlık güncelleştirdiğinizde çakışmalarına 
gösterilmektedir. Olamaz çözmenize, sorunlarla karşılaşırsanız, indirin veya tamamlanmış uygulamayı 
görüntüleyin. Yükleme yönergeleri. 

Eşzamanlılık çakışmaları 

Bir eşzamanlılık çakışması ortaya olduğunda: 

• Bir kullanıcı bir varlığın düzenleme sayfasına götürür. 

• ilk kullanıcının değişiklik DB'ye yazılmadan önce başka bir kullanıcı aynı varlık güncelleştirir. 

Eşzamanlılık algılama etkin değil, eş zamanlı güncelleştirmeler olduğunda: 

• Son güncelleştirme WINS. Diğer bir deyişle, son güncelleştirme değerleri Veritabanına kaydedilir. 

• Geçerli güncelleştirme ilk kaybolur. 

İyimser eşzamanlılık 

iyimser eşzamanlılık eşzamanlılık çakışmalarını olmasını sağlar ve tepki verdiğini uygun olduğunda bunlar 
yapın. Örneğin, Jane departmanı Düzen sayfasını ziyaret ve İngilizce departmanı için bütçe 350,000.00 $0,00 
değiştirir. 






H Edit-Conl X + 

- □ X 

localhost:53 

EQ ☆ | 

Contoso University 

— 


Edit 

Department 


Administrator 

Abercrombie, Kim 

Name 

English 

Start Date 

9/1/2007 

Save 





Jane tıkladığında önce Kaydet, John aynı sayfayı ziyaret eder ve alanın başlangıç tarihi 1/9/2013 
1/9/2007'deki değiştirir. 














O Edit-Conl X + 

- □ X 

localhost:53 

EQ1 ☆ | ••• 

Contoso University 

— 


Edit 

Department 

Budget 

350000.00 

Administrator 

Abercrombie, Kim 

Name 

English 


Start Date 

9/1/2013 


Save 


^-4 


Jane tıkladığında Kaydet ilk ve her tarayıcı dizin sayfası görüntülendiğinde değiştirme görür. 


H Departments - Contoso X + 


□ X 

CJ) localhost:5813/Depart 

☆ 

- m & - 

Contoso University 


_ j 


Departments 


Create New 

Name Budget Administrator Start Date 

English $0.00 Abercrombie, Kim 2007-09-01 Edit | Details | Delete 



John tıkladığında Kaydet yine de bir bütçe $350,000.00 birini gösteren bir Düzenle sayfasında. Sonraki 
işlemin ne eşzamanlılık çakışmalarını nasıl ele tarafından belirlenir. 

iyimser eşzamanlılık aşağıdaki seçenekleri içerir: 

• Bir kullanıcı değiştirmiş hangi özelliğinin kaydını ve yalnızca ilgili sütunları DB'de güncelleştirin. 

Bu senaryoda, veri kaybolacak. Farklı özellikler iki kullanıcı tarafından güncelleştirildi. Biri İngilizce, 
departman gözatar sonraki açışınızda Gamze'nin hem Çan'ın değişiklikleri görürler. Bu güncelleştirme 
yöntemini, veri kaybına neden olabilecek çakışmaları sayısını azaltabilirsiniz. Bu yaklaşım: 


o Aynı özelliğe rakip bir değişiklik yaptıysanız, veri kaybını önlemek olamaz. 



















o Genellikle bir web uygulaması pratik değildir.Tüm getirilen ve yeni değerleri izlemek için önemli 
durum koruma gerektiriyor. Büyük miktarlarda durumu bakımını yapma, uygulama performansını 
etkileyebilir. 

o Bir varlıkta eşzamanlılık algılama ile karşılaştırıldığında app karmaşıklığı artırabilirsiniz. 

• Gamze'nin değişikliğinin üzerine Çan'ın değişiklik sağlayabilirsiniz. 

Sonraki biri İngilizce departmanı gözatar, 1/9/2013 görürler ve getirilen $350,000.00 değeri. Bu 
yaklaşım olarak adlandırılan bir istemci WINS veya VVINS'te son senaryo, (istemciden gelen tüm 
değerler veri deposunda yer alacak şekilde önceliklidir.) Eşzamanlılık işleme için herhangi bir kodlama 
yapmazsanız, İstemci WINS otomatik olarak gerçekleşir. 

• Çan'ın değişiklik DB'de güncelleştirilmesini engelleyebilir.Genellikle, bir uygulamayı atadığınız: 

o Bir hata iletisi görüntüler, 
o Verilerin geçerli durumunu gösterir, 
o Değişiklikleri uygulamak verin. 

Bu adlı bir Store WINS senaryo. (Veri deposu değerleri, istemci tarafından gönderilen değerlere göre 
önceliklidir.) Bu öğreticide mağaza WINS senaryosunu uygulamanız gerekir. Bu yöntem, hiçbir 
değişiklik uyarı bir kullanıcı kılınmamasını sağlar. 

Eşzamanlılığı işleme 

Ne zaman bir özellik olarak yapılandırıldığında bir eşzamanlılık belirteci: 

• EF Core getirildi sonra'nın özellik değiştirilmedi doğrular.Onay gerçekleşir, SaveChanges veya 
SaveChangesAsync çağrılır. 

• Özelliği, getirildikten sonra değiştirilmişse, bir DbllpdateConcurrencyException oluşturulur. 

DB ve veri modeli oluşturma destekleyecek şekilde yapılandırılması gerekir DbupdateConcurrencyException . 

Bir özellik eşzamanlılık çakışmaları algılama 

Eşzamanlılık çakışmaları ile özellik düzeyinde algılanamıyor ConcurrencyCheck özniteliği. Öznitelik, birden çok 
modelin özellikleri için uygulanabilir. Daha fazla bilgi için veri ek açıklamaları-ConcurrencyCheck. 

[ConcurrencyCheck] Özniteliği, bu öğreticide kullanılmaz. 

Bir satırda eşzamanlılık çakışmaları algılama 

Eşzamanlılık çakışmalarını algılamak için bir rovvversion sütun izleme modele eklenir. rowversion : 

• SOL Server özeldir.Diğer veritabanlarının benzer bir özellik sağlamayabilir. 

• Veritabanından getirildikten sonra'nın bir varlık değiştirilmediğinden belirlemek için kullanılır. 

Bir sıralı bir veritabanı oluşturur rowversion her zaman satır artan sayısı güncelleştirilir, içinde bir update 
veya Delete komutu where yan tümcesi içeren getirilen değeri rowversion . Güncelleştirilen satır değiştiyse: 

• rowversion getirilen değeri ile eşleşmiyor. 

• update Veya Delete olduğundan, komut satır Bul yok where yan tümcesi içeren getirilen rowversion . 

• A DbUpdateConcurrencyException oluşturulur. 

EF Core tarafından hiçbir satır güncelleştirildiğinde içinde bir update veya Delete komutu, bir eşzamanlılık 
özel durumu oluşturulur. 

Departman varlığa izleme özelliği ekleme 

içinde Models/Department.cs, RovvVersion adlı izleme özelliği ekleyin: 
















using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Department 

{ 

public int DepartmentlD { get; set; } 

[StringLength(50, MinimumLength = 3)] 
public string Name { get; set; } 

[DataType(DataType.Currency)] 

[Column(TypeName = "money")] 
public decimal Budget { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}"j ApplyFormatlnEditMode = true)] 

[Display(Name = "Start Date")] 
public DateTime StartDate { get; set; } 

public int? InstructorlD { get; set; } 

[Timestamp] 

public byte[] RowVersion { get; set; } 

public Instructor Administrator { get; set; } 
public ICollection<Course> Courses { get; set; } 

} 

} 

Zaman damgası özniteliği, bu sütunda yer belirtir where yan tümcesi update ve Delete komutları. 
Adlandırılan öznitelik Timestamp bir SQL SQL Server'ın önceki sürümlerinde kullanılan çünkü timestamp veri 
türü SQL önce rowversion türü değiştirildi. 

Fluent API'si izleme özelliği de belirtebilirsiniz: 

modelBuilder.Entity<Department>() 

.Property<byte[]>("RowVersion") 

.IsRowVersion(); 


Aşağıdaki kod, T-SQL bölüm adını güncelleştirildiğinde EF Core tarafından oluşturulan bir bölümü 
gösterilmektedir: 


SET NOCOUNT ON; 

UPDATE [Department] SET [Name] = @p0 

WHERE [DepartmentlD] = @pl AND [RowVersion] = @p2; 

SELECT [RowVersion] 

FROM [Department] 

WHERE @@ROWCOUNT = 1 AND [DepartmentlD] = @pl; 


Önceki kodun gösterdiği vurgulanmış where yan tümcesi içeren RowVersion . Varsa DB Rowversion eşit 
değildir Rowversion parametre ( @p2 ), satır güncelleştirilir. 


Aşağıdaki vurgulanmış kodu tam olarak bir satır güncellenmedi doğrular T-SQL gösterir: 















SET NOCOUNT ON; 

UPDATE [Department] SET [Name] = @p@ 

UIHERE [DepartmentlD] = @pl AND [RowVersion] = @p2; 

SELECT [RowVersion] 

FROM [Department] 

WHERE @@ROWCOUNT = 1 AND [DepartmentlD] = @pl; 

@@ROWCOUNT son deyiminden etkilenen satır sayısını döndürür. Hayır, satır güncelleştirilir, EF Core 
oluşturur bir DbUpdateConcurrencyException . 

T-SQL EF Core oluşturur Visual Studio çıktı penceresinde görebilirsiniz. 

DB update 

Ekleme Rowversion geçiş gerektiren DB modeli özelliğini değiştirir. 

Projeyi oluşturun. Bir komut penceresinde aşağıdakileri girin: 

dotnet ef migrations add RowVension 
dotnet ef database update 

Yukarıdaki komutlar: 

• Ekler geçişleri/{zaman stamp}_RowVersion.cs geçiş dosyası. 

• Güncelleştirmeleri Migrations/SchoolContextModelSnapshot.cs dosya. Bu güncelleştirme aşağıdaki 
vurgulanmış kodu ekler BuiidModei yöntemi: 

• DB güncelleştirilemedi geçişlerini çalıştırır. 

İskele Departmanlar modeli 

• Visual Studio 

• Visual Studio Code 

Bölümündeki yönergeleri Öğrenci modeli iskelesini ve Department model sınıfı için. 

Önceki komut iskelesini kurar Department modeli. Projeyi Visual Studio'da açın. 

Projeyi oluşturun. 

Departmanlar dizin sayfası 

Oluşturulan yapı iskelesi altyapısı bir Rowversion sütunu için dizin sayfasını, ancak bu alanı olmamalıdır 
görüntülenecek. Bu öğreticide, son baytı Rowversion eşzamanlılık anlamanıza yardımcı olması için 
görüntülenir. Son bayta kalan benzersiz olması garanti yoktur.Gerçek bir uygulamada görüntüleyemiyordu 
RowVersion veya son baytı RowVersion . 

Dizin Sayfası güncelleştirin: 

• Dizin bölümlerine değiştirin. 

• Biçimlendirme içeren değiştirin Rowversion son baytı ile Rowversion . 

• FirstMidName tam adı ile değiştirin. 

Güncelleştirilen sayfaya aşağıdaki işaretlemeyi gösterir: 














@page 

@model ContosoUniversity.Pages.Departments.IndexModel 

@{ 

ViewData["Title"] = "Departments"; 

} 

<h2>Departments</h2> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

ctable class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model => model.Department[0].Name) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Department[0].Budget) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Department[0].StartDate) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Department[0].Administrator) 

</th> 

<th> 

RowVersion 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

(Şforeach (var item in Model.Department) { 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Name) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Budget) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.StartDate) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Administrator.FullName) 

</td> 

<td> 

@item.RowVersion[7] 

</td> 

<td> 

<a asp-page="./Edit" asp-route-id="@item.DepartmentID">Edit</a> | 

<a asp-page="./Details" asp-route-id="@item.DepartmentID">Details</a> | 
<a asp-page="./Delete" asp-route-id="@item.DepartmentID">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 


Düzenleme sayfa modeli güncelleştirme 

Aşağıdaki kodla Pages\Departments\Edit.cshtml.cs güncelleştirin: 

using ContosoUniversity.Data; 




using ContosoUniversity.Models; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.RazorPages; 

using Microsoft .AspNetCore.Mvc. Rendering; 

using Microsoft.EntityFrameworkCore; 

using System.Linq; 

using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Departments 

{ 

public class EditModel : PageModel 

{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 

public EditModel(ContosoUniversity.Data.SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Department Department { get; set; } 

// Replace ViewData["InstructorID"] 

public SelectList InstructorNameSL { get; set; } 

public async Task<IActionResult> OnGetAsync(int id) 

{ 

Department = await _context.Departments 

.Include(d => d.Administrator) // eager loading 
.AsNoTracking() // tracking not required 

.FirstOrDefaultAsync(m => m.DepartmentlD == id); 

if (Department == null) 

{ 

return NotFound(); 

} 

// Use strongly typed data rather than ViewData. 

InstructorNameSL = new SelectList(_context.Instructors, 

"ID", "FirstMidName"); 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int id) 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var departmentToUpdate = await _context.Departments 
.Include(i => i.Administrator) 

.FirstOrDefaultAsync(m => m.DepartmentlD == id); 

// null means Department was deleted by another user. 
if (departmentToUpdate == null) 

{ 

return HandleDeletedDepartment(); 

} 

// Update the RowVersion to the value when this entity was 
// fetched. If the entity has been updated after it was 
// fetched, RowVersion won't match the DB RowVersion and 
// a DbUpdateConcurrencyException is thrown. 

// A second postback will make them match, unless a new 
// concurrency issue happens. 

_context.Entry(departmentToUpdate) 

.Property("RowVersion").OriginalValue = Department.RowVersion; 


if (await TryUpdateModelAsync<Department>( 
departmentToUpdate, 

"Department", 

s => s.Name, s => s.StartDate, s => s.Budget, s => s.InstructorlD)) 

{ 

try 

{ 

await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

catch (DbUpdateConcurrencyException ex) 

{ 

var exceptionEntry = ex.Entries.Single(); 
var clientValues = (Department)exceptionEntry.Entity; 
var databaseEntry = exceptionEntry.GetDatabaseValues(); 
if (databaseEntry == null) 

{ 

ModelState.AddModelError(string.Empty, "Unable to save. " + 
"The department was deleted by another user."); 
return Page(); 

} 

var dbValues = (Department)databaseEntry.ToObject(); 
await setDbErrorMessage(dbValues, clientValues, _context); 

// Save the current RowVersion so next postback 
// matches unless an new concurrency issue happens. 

Department.RowVersion = (byte[])dbValues.RowVersion; 

// Must clear the model error for the next postback. 

ModelState.Remove("Department.RowVersion"); 

} 

} 

InstructorNameSL = new SelectList(_context.Instructors, 

"ID", "FullName", departmentToUpdate.InstructorlD); 

return Page(); 


private IActionResult HandleDeletedDepartment() 

{ 

var deletedDepartment = new Department(); 

// ModelState contains the posted data because of the deletion error and will overide the 
Department instance values when displaying Page(). 

ModelState. AddModelError( st ring. Empty, 

"Unable to save. The department was deleted by another user."); 

InstructorNameSL = new SelectList(_context.Instructors, "ID", "FullName", 

Department.InstructorlD); 

return Page(); 


private async Task setDbErrorMessage(Department dbValues, 
Department clientValues, SchoolContext context) 

{ 

if (dbValues.Name != clientValues.Name) 

{ 

ModelState.AddModelError("Department.Name", 
$"Current value: (dbValues.Name}"); 

} 

if (dbValues.Budget != clientValues.Budget) 

{ 

ModelState.AddModelError("Department.Budget", 
$"Current value: (dbValues.Budget:c}"); 

} 

if (dbValues.StartDate != clientValues.StartDate) 

{ 

ModelState.AddModelError("Department.StartDate", 
$"Current value: (dbValues.StartDate:d}"); 


} 

if (dbValues.InstructorlD != clientValues.InstructorlD) 

{ 

Instructor dblnstructor = await _context.Instructors 
.FindAsync(dbValues.InstructorlD); 

ModelState.AddModelError("Department.InstructorlD", 

$"Current value: {dblnstructor?.FullName}"); 

} 

ModelState.AddModelError(string.Empty, 

"The record you attempted to edit " 

+ "was modified by another user after you. The " 

+ "edit operation was canceled and the current values in the database " 

+ "have been displayed. If you stili want to edit this record, click " 

+ "the Save button again."); 

} 

} 

} 

Bir eşzamanlılık algılanması OriginalValue güncelleştirilmesi rowversion alınan varlık değeri. EF Core özgün 
içeren bir VVHERE yan tümcesi ile SQL güncelleştirme komut oluşturur Rowversion değeri. Hiçbir satır 
güncelleştirme komutu tarafından etkileniyorsanız (hiçbir satır özgün sahip Rowversion değer), 
DbUpdateConcurrencyException Özel durumu oluşturulur. 

public async Task<IActionResult> OnPostAsync(int id) 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var departmentToUpdate = await _context.Departments 
.Include(i => i.Administrator) 

.FirstOrDefaultAsync(m => m.DepartmentlD == id); 

// null means Department was deleted by another user. 
if (departmentToUpdate == null) 

{ 

return HandleDeletedDepartment(); 

} 

// Update the RowVersion to the value when this entity was 
// fetched. If the entity has been updated after it was 
// fetched, RowVersion won't match the DB RowVersion and 
// a DbUpdateConcurrencyException is thrown. 

// A second postback will make them match, unless a new 
// concurrency issue happens. 

_context.Entry(departmentToUpdate) 

.Property("RowVersion").OriginalValue = Department.RowVersion; 



DB değer olduğunda 


Aşağıdaki kod, istemci değerler (Bu yönteme gönderilen değerler) ve DB değerleri alır: 








try 

{ 

await _context. SaveChangesAsync (); 
return RedirectToPage("./Index"); 

} 

catch (DbUpdateConcurrencyException ex) 

{ 

var exceptionEntry = ex.Entries.Single(); 
var clientValues = (Department)exceptionEntry.Entity; 
var databaseEntry = exceptionEntry.GetDatabaseValues(); 
if (databaseEntry == null) 

{ 

ModelState.AddModelError(string.Empty, "Unable to save. " + 

"The department was deleted by another user."); 
return Page(); 

} 

var dbValues = (Department)databaseEntry.ToObject(); 
await setDbErrorMessage(dbValues, clientValues, _context); 

// Save the current RowVersion so next postback 
// matches unless an new concurrency issue happens. 

Department.RowVersion = (byte[])dbValues.RowVersion; 

// Must clear the model error for the next postback. 

ModelState.Remove("Department.RowVersion"); 

} 

Aşağıdaki kod, onPostAsync gönderilen değerden farklı olan DB değerleri olan her bir sütun için özel bir hata 
iletisi ekler: 


private async Task setDbErrorMessage(Department dbValues, 

Department clientValues, SchoolContext context) 

{ 

if (dbValues.Name != clientValues.Name) 

{ 

ModelState.AddModelError("Department.Name", 

$"Current value: {dbValues.Name}"); 

} 

if (dbValues.Budget != clientValues.Budget) 

{ 

ModelState.AddModelError("Department.Budget", 

$"Current value: {dbValues.Budget:c}"); 

} 

if (dbValues.StartDate != clientValues.StartDate) 

{ 

ModelState.AddModelError("Department.StartDate", 

$"Current value: {dbValues.StartDate:d}"); 

} 

if (dbValues.InstructorlD != clientValues.InstructorlD) 

{ 

Instructor dblnstructor = await _context.Instructors 
.FindAsync(dbValues.InstructorlD); 

ModelState.AddModelError("Department.InstructorlD", 

$"Current value: {dblnstructor?.FullName}"); 

} 

ModelState. AddModelError(string. Empty, 

"The record you attempted to edit " 

+ "was modified by another user after you. The " 

+ "edit operation was canceled and the current values in the database " 
+ "have been displayed. If you stili want to edit this record, click " 

+ "the Save button again."); 





Aşağıdaki vurgulanmış kodu kümeleri RowVersion değerden yeni değere Veritabanından alınır. Kullanıcının bir 
sonraki tıklayışında Kaydet, düzenleme sayfası son görüntülenmesini yakalandı beri gerçekleşen eşzamanlılık 
hataları. 


try 

{ 

await _context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

catch (DbllpdateConcurrencyException ex) 

{ 

var exceptionEntry = ex.Entries.Single(); 
var clientValues = (Department)exceptionEntry.Entity; 
var databaseEntry = exceptionEntry.GetDatabaseValues(); 
if (databaseEntry == null) 

{ 

ModelState.AddModelError(string.Empty, "Unable to save. " + 

"The department was deleted by another user."); 
return Page(); 

} 

var dbValues = (Department)databaseEntry.ToObject(); 
await setDbErrorMessage(dbValues, clientValues, _context); 

// Save the current RowVersion so next postback 
// matches unless an new concurrency issue happens. 

Department.RowVersion = (byte[])dbValues.RowVersion; 

// Must clear the model error for the next postback. 

ModelState.Remove("Department.RowVersion"); 

} 

ModelState.Remove Deyimi, çünkü gereklidir ModelState eski olan Rowversion değeri. Razor Sayfası'nda 
ModelState değerinin ikisi de mevcut olduğunda alan üzerinde model özellik değerlerini öncelik kazanır. 

Güncelleştirme düzenleme sayfası 

Güncelleştirme Pages/Departments/Edit.cshtml aşağıdaki işaretlemeyle: 





@page "{id:int}" 

@model Contosollniversity. Pages. Departments. EditModel 

@{ 

ViewData["Title"] = "Edit"; 

} 

<h2>Edit</h2> 

<h4>Department</h4> 

■chr /> 

<div class="row"> 

<div class="col-md-4"> 

<form method="post"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<input type="hidden" asp-for="Department.DepartmentID" /> 

<input type="hidden" asp-for="Department.RowVersion" /> 

<div class="form-group"> 

<label>RowVersion</label> 

@Model.Department.RowVersion[7] 

</div> 

<div class="form-group"> 

<label asp-for="Department.Name" class="control-label"x/label> 

■cinput asp-for="Department.Name" class="form-control" /> 

<span asp-validation-for=" Department .Name" class="text-danger"x/span> 
</div> 

<div class="form-group"> 

«clabel asp-for="Department. Budget" class="control-label"x/label> 

■cinput asp-for="Department.Budget" class="form-control" /> 

<span asp-validation-for= "Department.Budget" class="text-danger"x/span> 
</div> 

<div class="form-group"> 

<label asp-for="Department.StartDate" class="control-label"x/label> 
■cinput asp-for="Department.StartDate" class="form-control" /> 

<span asp-validation-for="Department.StartDate" class="text-danger"> 
</span> 

</div> 

<div class="form-group"> 

<label class="control-label">Instructor</label> 

<select asp-for="Department.InstructorlD" class="form-control" 
asp-items="@Model. InstructorNameSL"x/select> 

<span asp-validation-for="Department.InstructorlD" class="text-danger"> 
</span> 

</div> 

<div class="form-group"> 

<input type="submit" value="Save" class="btn btn-default" /> 

</div> 

</form> 

</div> 

</div> 

<div> 

<a asp-page="./Index">Back to List</a> 

</div> 

@section Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 

Önceki işaretlemesi: 

• Güncelleştirmeleri page gelen yönerge @page için @page "{idcint}" . 

• Gizli satır sürümü ekler. RowVersion POST geri değere bağlar, böylece eklenmesi gerekir. 

• Son baytı görüntüler Rowversion hata ayıklama amacıyla. 

• Değiştirir viewData türü kesin belirlenmiş ile instructorNameSL . 

Eşzamanlılık çakışmalarını düzenleme sayfası ile test 

iki tarayıcılar örneklerinde düzenleme İngilizce departmanı açın: 









• Uygulamayı çalıştırın ve bölümleri seçin. 

• Sağ Düzenle seçin ve İngilizce departmanı için köprü yeni sekmede aç. 

• Birinci sekmede tıklayın Düzenle İngilizce departmanı için köprü. 

Aynı bilgilerin iki tarayıcı sekmeleri görüntüleyin. 

' A tıklayın ve ilk tarayıcı sekmesine adını değiştirmek Kaydet. 
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Save 
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© 2017 - Contoso University 

Tarayıcı değiştirilen değer ve güncelleştirilmiş rowVersion göstergesi ile dizin sayfası gösterilir. 
Güncelleştirilmiş rovvVersion göstergesi, Not, ikinci geri göndermenin diğer sekmesinde görüntülen 

ikinci bir tarayıcı sekmesinde farklı bir alana değiştirin. 
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Save 
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Kaydet'e tıklayın. DB değerleri eşleşmeyen tüm alanlar için hata iletileri görürsünüz: 
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• The record you attempted to edit was moditied by another 
user after you. The edit operation was canceled and the 
current values in the database have been displayed. If you stili 
want to edit this record, click the Save button again. 

RovvVersion 21 

Name 

English 

Current value: Languages 

Budget 

5000000 

Current value: $350,000.00 

Start Date 

09/01/2007 

Instructor 

Abercrombie, Kim * 

Save 

Back to List 
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Ad alanı değiştirmek bu tarayıcı penceresini düşünmediğiniz. Kopyalama ve geçerli değerin (dil) adı alanına 
yapıştırın. Sekme genişletme. İstemci tarafı doğrulaması hata iletisini kaldırır. 

















- □ x 


Departmer- X , 

| Edit - Cont; X 


<- O 

© loca 

host:1 234/Departm 

ants/Edit/1 


Contoso University 


Edit 

Department 

• The record you attempted to edit was moditied by another 
user afler you. The edit operation was canceled and the 
current values in the database have been displayed. If you stili 
want to edit this record. click the Save button again. 

RovvVersion 21 
Name 

ı -1 

Languages 

Budget 

5000000 

Start Date 

09/01/2007 

Instructor 

Abercrombie, Kim ▼ 

Save 

Back to List 

© 2017 - Contoso University 


Tıklayın Kaydet yeniden, ikinci tarayıcı sekmesinde girdiğiniz değer kaydedilir. Dizin sayfasında kaydedilen 
değerler görürsünüz. 

Silme sayfası 

Delete sayfa modeli aşağıdaki kodla güncelleştirin: 

using ContosoUniversity.Models; 
using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.EntityFrameworkCore; 
using System.Threading.Tasks; 

namespace ContosoUniversity.Pages.Departments 
{ 

public class DeleteModel : PageModel 
{ 

private readonly ContosoUniversity.Data.SchoolContext _context; 



























public DeleteModel(ContosoUniversity. Data. SchoolContext context) 

{ 

_context = context; 

} 

[BindProperty] 

public Department Department { get; set; } 
public string ConcurrencyErrorMessage { get; set; } 

public async Task<IActionResult> OnGetAsync(int id, bool? concurrencyError) 

{ 

Department = await _context.Departments 
.Include(d => d.Administrator) 

.AsNoTracking() 

.FirstOrDefaultAsync(m => m.DepartmentlD == id); 

if (Department == null) 

{ 

return NotFound(); 

} 

if (concurrencyError.GetValueOrDefault()) 

{ 

ConcurrencyErrorMessage = "The record you attempted to delete " 

+ "was modified by another user after you selected delete. " 

+ "The delete operation was canceled and the current values in the " 

+ "database have been displayed. If you stili want to delete this " 

+ "recordj click the Delete button again."; 

} 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int id) 

{ 

try 

{ 

if (await _context.Departments.AnyAsync( 
m => m.DepartmentlD == id)) 

{ 

// Department.rowVersion value is from when the entity 
// was fetched. If it doesn't match the DB, a 
// DbUpdateConcurrencyException exception is thrown. 

_context.Departments.Remove(Department); 
await _context.SaveChangesAsync(); 

} 

return RedirectToPage("./Index"); 

} 

catch (DbUpdateConcurrencyException) 

{ 

return RedirectToPage("./Delete", 

new { concurrencyError = true, id = id }); 

} 

} 

} 

} 

Varlık getirildi sonra değiştiğinde silme sayfası eşzamanlılık çakışmalarını algılar. Department.Rowversion Varlık 
getirildi satır sürümü andır. EF Core SQL DELETE komutu oluşturduğunda, VVHERE yan tümcesi ile içerdiği 
Rowversion . Sıfır satır SQL DELETE komutu sonuçları etkileniyorsa: 

• Rowversion SQL DELETE komutu eşleşmiyor Rowversion DB'de. 

• DbUpdateConcurrencyException özel durum oluşturulur. 

• OnGetAsync çağrılır concurrencyError . 


Silme sayfası 








Güncelleştirme Pages/Departments/Delete.cshtmi aşağıdaki kod ile: 


@page "{id:int}" 

@model ContosoUniversity.Pages.Departments.DeleteModel 

@{ 

ViewData["Title"] = "Delete"; 

} 

<h2>Delete</h2> 

<p class="text-danger">@Model.ConcurrencyErrorMessage</p> 

<h3>Are you sure you want to delete this?</h3> 

<div> 

<h4>Department</h4> 

<hr /> 

<dl class="dl-horizontal"> 

<dt> 

@Html.DisplayNameFor(model => model.Department.Name) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Department.Name) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Department.Budget) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Department.Budget) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Department.StartDate) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Department.StartDate) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Department.RowVersion) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Department.RowVersion[7]) 

</dd> 

<dt> 

@Html.DisplayNameFor(model => model.Department.Administrator) 

</dt> 

<dd> 

@Html.DisplayFor(model => model.Department.Administrator.FullName) 
</dd> 

</dl> 

<form method="post"> 

<input type="hidden" asp-for="Department.DepartmentID" /> 

«cinput type="hidden" asp-for="Department.RowVersion" /> 

<div class="form-actions no-color"> 

<input type="submit" value="Delete" class="btn btn-default" /> | 

<a asp-page="./Index">Back to List</a> 

</div> 

</form> 

</div> 


Yukarıdaki kod aşağıdaki değişiklikleri yapar: 

• Güncelleştirmeleri page gelen yönerge @page için @page "{id:int}" . 

• Bir hata iletisi ekler. 

• FullName FirstMidName değiştirir yönetici alan. 






• Değişiklikleri RowVersion son bayt görüntülenecek. 

• Gizli satır sürümü ekler. RowVersion POST geri değere bağlar, böylece eklenmesi gerekir. 

Eşzamanlılık çakışmalarını silme sayfası ile test 

Test bölümü oluşturun. 

iki tarayıcılar örneklerinde DELETE test departmanı açın: 

• Uygulamayı çalıştırın ve bölümleri seçin. 

• Sağ Sil seçin ve test departmanı için köprü yeni sekmede aç. 

• Tıklayın Düzenle köprü test bölümü için. 

Aynı bilgilerin iki tarayıcı sekmeleri görüntüleyin, 
ilk tarayıcı sekmesine bütçede değiştirip'ı Kaydet. 

Tarayıcı değiştirilen değer ve güncelleştirilmiş rowVersion göstergesi ile dizin sayfası gösterilir. 
Güncelleştirilmiş rovvVersion göstergesi, Not, ikinci geri göndermenin diğer sekmesinde görüntülenir. 

ikinci sekmeden test departmanını silin. Bir eşzamanlılık hatası, VERITABANıNDAKI geçerli değerlerle birlikte 
görüntülenir. Tıklayarak Sil sürece varlığını siler Rowversion updated.department silinmiş olmuştur. 

Bkz: devralma nasıl bir veri modeli devralır. 

Ek kaynaklar 

• EF Core eşzamanlılık belirteçler 

• EF Core eşzamanlılık işleme 

• Bu öğreticinin YouTube sürümü (eşzamanlılık çakışmalarını İşleme) 

• Bu öğreticinin YouTube sürümü (Bölüm 2) 

• Bu öğreticinin YouTube sürümü (Bölüm 3) 


ÖNCEKİ 





EF Core öğreticisi serisi ile MVC ASRNET Core 

13.11.2019 *2 minutes to read ı Edjt Online 


Bu öğretici 3,0 AS P.N ET Core güncelleştirilmedi. Razor Pages sürümü güncelleştirildi. Bunun ne zaman 
güncelleştirilemeyebilir hakkında bilgi edinmek için Bu GitHub sorununabakın. 

Bu öğretici, ASP.NET Core MVC ve denetleyiciler ve görünümlerle Entity Framevvork Core öğretir. Razor Pages , 
AS P.N ET Core 2,0 1 de tanıtılan alternatif bir programlama modelidir. Yeni geliştirme için, denetleyiciler ve 
görünümlerle MVC üzerinde Razor Pages önerilir. Bu öğreticinin Razor Pages bir sürümü bulunmaktadır. Her 
öğreticide diğer malzemeler ele alınmaktadır: 

Bu MVC öğreticisine bazı şeyler Razor Pages öğreticiye sahip değildir: 

• Veri modelinde devralma uygulama 

• Ham SQL sorguları gerçekleştirme 

• Kodu basitleştirmek için dinamik LINQ kullanma 

Razor Pages öğreticide şunları gerçekleştirmeyen şeyler: 

• İlgili verileri yüklemek için Select metodunu kullanın 

• ASP.NET Core 3,0 için kullanılabilen bir sürüm 

1. Kullanmaya başlama 

2. işlem Oluşturma, Okuma, Güncelleştirme ve Silme 

3. Sıralama, filtreleme, disk belleği ve gruplandırma 

4. Geçişler 

5. Karmaşık veri modeli oluşturma 

6. ilgili verileri okuma 

7. ilgili verileri güncelleştirme 

8. Eşzamanlılık çakışmalarını işleme 

9. Devralma 

10. Gelişmiş konular 






Öğretici: bir ASPNET MVC web uygulamasında EF 
Core kullanmaya başlama 

23.11.2019 * 34 minutes to read ı Edit Online 


Bu öğretici 3,0 ASP.NET Core güncelleştirilmedi. Razor Pages sürümü güncelleştirildi. Bunun ne zaman 
güncelleştirilemeyebilir hakkında bilgi edinmek için Bu GitHub sorununabakın. 

Bu öğretici, ASP.NET Core MVC ve denetleyiciler ve görünümlerle Entity Framevvork Core öğretir. Razor Pages , 
AS P.N ET Core 2,0 1 de tanıtılan alternatif bir programlama modelidir. Yeni geliştirme için, denetleyiciler ve 
görünümlerle MVC üzerinde Razor Pages önerilir. Bu öğreticinin Razor Pages bir sürümü bulunmaktadır. Her 
öğreticide diğer malzemeler ele alınmaktadır: 

Bu MVC öğreticisine bazı şeyler Razor Pages öğreticiye sahip değildir: 

• Veri modelinde devralma uygulama 

• Ham SQL sorguları gerçekleştirme 

• Kodu basitleştirmek için dinamik LINQ kullanma 

Razor Pages öğreticide şunları gerçekleştirmeyen şeyler: 

• ilgili verileri yüklemek için Select metodunu kullanın 

• ASP.NET Core 3,0 için kullanılabilen bir sürüm 

Contoso Üniversitesi örnek Web uygulaması, Entity Framevvork (EF) Core 2,2 ve Visual Studio 2017 veya 2019 
kullanarak ASP.NET Core 2,2 MVC vveb uygulamalarının nasıl oluşturulacağını gösterir. 

Örnek uygulama, kurgusal bir Contoso Üniversitesi için bir Web sitesidir.Öğrenci giriş, kurs oluşturma ve 
Eğitmen atamaları gibi işlevleri içerir. Bu, Contoso Üniversitesi örnek uygulamasının sıfırdan nasıl 
oluşturulacağını açıklayan bir öğretici serisinin ilkisidir. 

Bu öğreticide şunları yaptınız: 

• ASP.NET Core MVC vveb uygulaması oluşturma 

• Site stili Ayarla 

• EF Core NuGet paketleri hakkında bilgi edinin 

• Veri modeli oluşturma 

• Veritabanı bağlamını oluşturma 

• Bağımlılık ekleme için bağlamı kaydetme 

• Test verileriyle veritabanını başlatma 

• Denetleyici ve görünüm oluşturma 

• Veritabanını görüntüleme 

Önkoşullar 

• .NET Core SDK 2,2 

• Aşağıdaki iş yükleriyle Visual Studio 2019: 

o ASP.net ve Web geliştirme iş yükü 
o .N ET Core platformlar arası geliştirme iş yükü 






Sorun giderme 

Bir sorunla karşılaşırsanız, çözümleyemiyor çalıştırırsanız, genel olarak çözüm kodunuzda karşılaştırarak 
bulabilirsiniz projeyi. Yaygın hataların bir listesi ve bunların nasıl çözüleceği için, serideki son öğreticinin sorun 
giderme bölümünebakın. ihtiyacınız olanları bulamazsanız, ASP.NET Core veya EF Coreiçin bir soru 
gönderebilirsiniz. 


TIP 

Bu, her biri daha önceki öğreticilerde gerçekleştirilen bir dizi 10 öğreticisidir. Her başarılı öğreticinin tamamlanmasından 
sonra projenin bir kopyasını kaydetmeyi göz önünde bulundurun. Daha sonra sorunlarla karşılaşırsanız, tüm serinin 
başlangıcına dönmek yerine önceki öğreticiden baştan başlayabilirsiniz. 


Contoso Üniversitesi web uygulaması 

Bu öğreticilerde oluşturacağınız uygulama basit bir üniversite web sitesidir. 

Kullanıcılar görüntüleyebilir ve Öğrenci, kurs ve Eğitmen bilgileri güncelleştirin. Oluşturacağınız ekranların 
bazıları aşağıda verilmiştir. 


E3 lndex - Contoso Univen X 
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X 

<- 

£3 localhost:50202/Studer "fa 
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Contoso University 
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Create New 





LastName 

FirstMidName 

EnrolImentDate 



Alexander 

Carson 

9/1/2005 12:00:00 AM 

Edit 

| Details | Delete 

Alonso 

Meredith 

9/1/2002 12:00:00 AM 

Edit 

| Details | Delete 

Anand 

Arturo 

9/1/2003 12:00:00 AM 

Edit 

| Details | Delete 


Barzdukas Gytis 


9/1/2002 12:00:00 AM Edit | Details | Deletç 










O Edit - Contoso Uni' X + — □ X 

(J) localhost:5813/Studer ■jîj' 


Contoso University 


Edit 

Student 

EnrolImentDate 

2005-09-01100:00:00.000 

FirstMidName 

Carson 

LastName 

Alexander 

Save 



Web uygulaması oluşturma 

• Visual Studio'yu açın. 

• Dosya menüsünden Yeni > proje' yi seçin. 

• Sol bölmeden, Visual C# > Web > yüklü 1 i seçin. 

• ASP.NET Core Web uygulaması proje şablonunu seçin. 

• Ad olarak Contosouniversity yazın ve Tamam' a tıklayın. 



• Yeni ASP.NET Core Web uygulaması iletişim kutusunun görünmesini bekleyin. 

• .NET Core, ASP.NET Core 2,2 ve Web uygulaması (Model-View-Controller) şablonu ' nu seçin. 































• Kimlik doğrulamanın kimlik doğrulaması yokolarak ayarlandığından emin olun. 

• Tamam 'ı seçin 


New ASP.NET Core Web Application - ContosoUniversity 


? 


X 



more 


n 

0 

sn 

El 

Empty 

API 

Web 

Application 

Web 

Application 

(Model-View- 

Controller) 
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Angular 

Reactjs 

Reactjs and 
Redux 




Razor Class 
Library 


Get additional nroiect temnlates 

□ Enable Docker Support (Requires Docker for Windowsl 
OS: Windows 
0 Confîgure for HTTPS 


A project template for creating an ASP.NET Core 
application with example ASP.NET Core MVC Views 
and Controllers. This template can also be used for 
RESTful HTTP Services. 

Learn more 


Author: 

Source: 


Authentication: 


Microsoft 
SDK 2.2.100 


No Authentication 


Change Authentication 


OK 


Cancel 


Site stili Ayarla 

Birkaç basit değişiklik, site menüsünü, düzeni ve giriş sayfasını ayarlar. 

Görüınümler/paylaşılan/_Layout. cshtml dosyasını açın ve aşağıdaki değişiklikleri yapın: 

• "Contoso Üniversitesi" için "ContosoUniversity" her örneğini değiştirin. Üç örnekleri vardır. 

• Hakkında, öğrenciler, Kurslar, eğitmenlerve Departmanlariçin menü girişleri ekleyin ve Gizlilik menü 
girişini silin. 

Değişiklikler vurgulanır. 

<IDOCTYPE html> 

<html> 

<head> 

<meta charset="utf-8" /> 

<meta name="viewport" content="width=device-width, initial-scale=1.0" /> 

<title>@ViewData["Title"] - Contoso Universityc/title> 

cenvironment include="Development"> 

clink rel="stylesheet" href="~/lib/bootstnap/dist/css/bootstnap.css" /> 

</environment> 

cenvironment exclude="Development"> 

clink rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter- 
bootstrap/4.1.3/css/bootstrap.min.css" 

asp-fallback-href="~/lib/bootstrap/dist/css/bootstrap.min.css" 

asp-fallback-test-class="sr-only" asp-fallback-test-property="position" asp-fallback-test- 
value="absolute" 

crossorigin="anonymous" 

integrity="sha256-eSilq2PG617g7ibl7yAaWMcrr5GrtohYChqibrV7PBE="/> 

</environment> 

clink rel="stylesheet" href="~/css/site.css" /> 
c/head> 








































<body> 

<header> 

<nav class="navbar navbar-expand-sm navbar-toggleable-sm navbar-light bg-white border-bottom box- 
shadow mb-3"> 

<div class="container"> 

<a class="navbar-brand" asp-anea="" asp-contr'oller="Home" asp-action="Index">Contoso 

University</a> 

<button class="navbar-toggler" type="button" data-toggle="collapse" data-target=".navbar- 
collapse" aria-controls="navbarSupportedContent" 

aria-expanded="false" aria-label="Toggle navigation"> 

<span class="navbar-toggler-icon"x/span> 

</button> 

<div class="navbar-collapse collapse d-sm-inline-flex flex-sm-row-reverse"> 

<ul class="navbar-nav flex-grow-l"> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-anea="" asp-controller="Home" asp- 

action="Index">Home</a> 

</li> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-area="" asp-controller="Home" asp- 

action="About">About</a> 

</li> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-area="" asp-controller="Students" asp- 

action="Index">Students</a> 

</li> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-area="" asp-controller="Courses" asp- 

action="Index">Courses</a> 

</li> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-area="" asp-controller="Instructors" asp- 
action="Index">Instructors</a> 

</li> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-area="" asp-controller="Departments" asp- 
action="Index">Departments</a> 

</li> 

</ul> 

</div> 

</div> 

</nav> 

</header> 

<div class="container"> 

<partial name="_CookieConsentPartial" /> 

<main role="main" class="pb-3"> 

@RenderBody() 

</main> 

</div> 

<footer class="border-top footer text-muted"> 

<div class="container"> 

Scopy; 2019 - Contoso University - <a asp-area="" asp-controller="Home" asp- 
action="Privacy">Privacy</a> 

</div> 

</footer> 

<environment include="Development"> 

<script src="~/üb/jquery/dist/jquery. js"x/script> 

<script src="~/lib/bootstrap/dist/js/bootstrap. bundle. js"x/script> 

</environment> 

<environment exclude="Development"> 

<script src=" https://cdnjs.cloudflare.eom/ajax/libs/jquery/3.3.l/jquery.min. js" 
asp-fallback-src="~/lib/jquery/dist/jquery.min.js" 
asp-fallback-test="window.jQuery" 
crossorigin="anonymous" 

integrity="sha256-FgpCb/K3QlLNfOu91ta32o/NMZxltwRo8QtmkMRdAu8="> 

</script> 


/crni r>+" err-'^ftne • / /rHm'c rlnııH-fl ano 


/ai 


/1 i he /tiiii+ton. 


-*■ K '■ 


L l-fJ-3 . / / 


'J J . 


a j 


./ J_L U J / LnXL L1 


bootstrap/4.1.3/js/bootstrap.bundle.min.j s" 

asp-fallback-src="~/lib/bootstrap/dist/js/bootstrap.bundle.min.js" 
asp-fallback-test="window.jQuery && window.jQuery.fn && window.jQuery.fn.modal" 
crossorigin="anonymous" 

integrity="sha256-E/V4cWE4qvAe05M0hjtGtqDzPndR01LBk813/PR7CA4="> 

</script> 

</environment> 

<script src="~/js/site,js" asp-append-version="true"x/script> 

@RenderSection("Scripts", required: false) 

</body> 

</html> 


Görünümler/Home/lndex. cshtml'de, ASP.net ve MVC hakkındaki metni bu uygulamayla ilgili metinle 
değiştirmek için dosyanın içeriğini aşağıdaki kodla değiştirin: 

ViewData["Title"] = "Home Page"; 

} 

<div class="jumbotron"> 

<hl>Contoso University</hl> 

</div> 

<div class="row"> 

<div class="col-md-4"> 

<h2>Welcome to Contoso University</h2> 

<P> 

Contoso University is a sample application that 
demonstnates how to use Entity Framework Cone in an 
ASP.NET Core MVC web application. 

</p> 

</div> 

<div class="col-md-4"> 

<h2>Build it from scnatch</h2> 

<p>You can build the application by following the steps in a series of tutorials.</p> 

<pxa class="btn btn-default" hnef="https://docs.asp.net/en/latest/data/ef-mvc/intro.html">See the 
tutorial &raquo; </ax/p> 

</div> 

<div class="col-md-4"> 

<h2>Download İt</h2> 

<p>You can download the completed pnoject from GitHub.</p> 

<pxa class="btn btn-default" 

href="https://github.com/aspnet/AspNetCore.Docs/tree/master/aspnetcore/data/ef-mvc/intro/samples/cu- 
final">See project source code &raquo;</ax/p> 

</div> 

</div> 


Projeyi çalıştırmak için CTRL + F5 tuşlarına basın veya menüden hata ayıklama > Başlat 1 ı seçin. Bu 
öğreticilerde oluşturacağınız sayfaların sekmelerini içeren giriş sayfasını görürsünüz. 




E3 Home Page - Contoso IX + 
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Contoso University Home About Students Courses 

Instructors 

Departments 


Contoso University 

VVelcome to Contoso University 

Contoso University is a sample application that demonstrates how to use Entity Framework Core 1.0 in an ASP.NET 
Core MVC 1.0 web application. 

Build it from scratch 

You can build the application by follovving the steps in a series of tutorials. 

See the tutonal» 

Dovvnload it 

You can dovvnload the completed projectfrom GitHub. 

See project source code » 

© 2016 - Contoso University 


NuGet paketleri EF Core hakkında 

Bir projeye EF Core destek eklemek için hedeflemek istediğiniz veritabanı sağlayıcısını yükleyebilirsiniz. Bu 
öğretici SQL Server kullanır ve sağlayıcı paketi Microsoft. EntityFramevvorkCore. SqlServer' dır. Bu paket 
Microsoft. AspNetCore. app metapackageiçinde bulunur, bu nedenle pakete başvurmanız gerekmez. 

EF SQL Server paketi ve bağımlılıkları ( Microsoft.EntityFrameworkCore ve 

Microsoft.EntityFrameworkCore.Reiationai ) EF için çalışma zamanı desteği sağlar. Geçiş öğreticisinde daha sonra 
bir araç paketi ekleyeceksiniz. 

Entity Framevvork Core için kullanılabilen diğer veritabanı sağlayıcıları hakkında daha fazla bilgi için bkz. 

veritabanı sağlayıcıları. 

Veri modeli oluşturma 

Daha sonra Contoso Üniversitesi uygulaması için varlık sınıfları oluşturacaksınız. Aşağıdaki üç varlıkla 
başlayacaksınız. 












Course 


Enrollment 


Student 




Properties 
y$ EnrolImentlD 

A CourselD 

A StudentlD 

A Grade 

0-0 

* 1 

Properties 
yî İD 

A LastName 

A FirstMidName 

A EnrolImentDate 

Properties 
y? CourselD 

A Title 

A Credits 

1 

Navigation Properties 
y51 Enrollments 

Navigation Properties 

Navigation Properties 


Course 

Student 


y3 Enrollments 





student ve Enrollment varlıkları arasında bire çok ilişki vardır ve course ile Enrollment varlıkları arasında bire 
çok bir ilişki vardır. Diğer bir deyişle, bir öğrenci herhangi bir sayıda kursa kaydedilebilir ve bir kurs, kayıtlı sayıda 
öğrenciye sahip olabilir. 

Aşağıdaki bölümlerde, bu varlıkların her biri için bir sınıf oluşturacaksınız. 

Öğrenci varlık 


Student 


Properties 
y? İD 

A LastName 
A FirstMidName 
A EnrolImentDate 
Navigation Properties 
Enrollments 


Modeller klasöründe, Student.es adlı bir sınıf dosyası oluşturun ve şablon kodunu aşağıdaki kodla değiştirin, 
using System; 

using System.Collections.Generic; 

namespace ContosoUniversity.Models 
{ 

public elass Student 
{ 

public int ID { get; set; } 
public stning LastName { get; set; } 
public stning FirstMidName { get; set; } 
public DateTime EnrolImentDate { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 

id özelliği, bu sınıfa karşılık gelen veritabanı tablosunun birincil anahtar sütunu olacak. Varsayılan olarak, Entity 
Framevvork id veya ciassnameiD adında bir özelliği birincil anahtar olarak yorumlar. 


Enrollments Özelliği bir gezinti özelliği. Gezinti özellikleri, bu varlıkla ilgili diğer varlıkları tutar. Bu durumda, bir 
student entity Enrollments özelliği, bu student varlıkla ilgili Enrollment varlıkların tümünü tutacaktır. Diğer 
bir deyişle, veritabanında verilen bir öğrenci satırı, iki ilişkili kayıt satırına (bu öğrencinin birincil anahtar değerini 
kendi StudentlD yabancı anahtar sütununda içeren satırlar) sahipse, student varlığın Enrollments gezinti özelliği 
bu iki Enrollment varlığını içerir. 


Bir gezinti özelliği birden çok varlığı tutabileceiyorsa (çok-çok veya bire çok ilişkilerde olduğu gibi), türü 
ıcoiiection<T> gibi girişlerin eklenebileceği, silinebileceği ve güncelleştirilemeyebilir bir liste olmalıdır. 
ıcoiiection<T> veya List<T > veya HashSet<T> gibi bir tür belirtebilirsiniz. ıcoiiection<T> belirtirseniz, EF 
varsayılan olarak bir HashSet<T> koleksiyonu oluşturur. 







































Kayıt varlık 



{ 

public enum Grade 
{ 


A, Bj C, D, F 

} 

public class Enrollment 

{ 

public int EnrollmentlD { get; set; } 
public int CourselD { get; set; } 
public int StudentlD { get; set; } 
public Grade? Grade { get; set; } 

public Course Course { get; set; } 
public Student Student { get; set; } 

} 

} 

EnrollmentlD özelliği birincil anahtar olacaktır; Bu varlık, student varlığında gördüğünüz gibi kendisini id 
yerine ciassnameiD modelini kullanır. Normalde tek bir model seçip veri modeliniz genelinde kullanabilirsiniz. 
Burada, değişim, her iki stili de kullanabileceğinizi gösterir. Daha sonraki bir öğreticide, İD 'yi ClassName 
olmadan kullanarak, veri modelinde devralma uygulamayı daha kolay hale getirir. 

Grade Özelliği bir enum . Sonra soru işareti Grade türü bildirimi gösterir Grade özelliği boş değer atanabilir. Boş 
bir sınıf bir sıfır sınıf farklı—null anlamına gelir bir sınıf bilinen değil veya henüz atanmamış. 


StudentlD 

Özelliği olduğundan yabancı anahtar ve karşılık gelen gezinme özelliğini 

Student . 

Enrollment 


varlık bir student varlığıyla ilişkilendirilir, bu nedenle özellik yalnızca tek bir student varlığı tutabilir (daha önce 


gördüğünüz student.Enroiiments gezinti özelliğinden farklı olarak, birden çok Enrollment varlığı tutabilir). 


CourselD 

Özelliği olduğundan yabancı anahtar ve karşılık gelen gezinme özelliğini 

Course 

. Bir 

Enrollment 


varlıktır biriyle ilişkili course varlık. 

Entity Framevvork, cnavigation property namexprimary ı<ey property name> adında bir özelliği yabancı anahtar 
özelliği olarak Yorumlar (örneğin, student varlığının birincil anahtarı id olduğundan student gezinti özelliği 


StudentlD 

). Yabancı anahtar özelliklerine de yalnızca 

cprimary key property name> 

(örneğin 

CourselD , 


course varlığının birincil anahtarı CourselD olduğundan) adlandırılmış olabilir. 


Kurs varlık 


































Course 



using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations.Schema; 


namespace ContosoUniversity.Models 
{ 

public class Course 
{ 

[DatabaseGenerated(DatabaseGeneratedOption.None)] 
public int CourselD { get; set; } 
public string Title { get; set; } 
public int Credits { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 

Enrollments Özelliktir bir gezinme özelliği. A course varlık dilediğiniz sayıda ilgili olabileceğini Enroiiment 
varlıklar. 

Bu serinin sonraki bir öğreticide DatabaseGenerated özniteliği hakkında daha fazla bilgi edineceksiniz. Temel 
olarak bu öznitelik, veritabanının oluşturması yerine kursa ait birincil anahtarı girmenize olanak sağlar. 

Veritabanı bağlamını oluşturma 

Belirli bir veri modeli için Entity Framevvork işlevselliğini koordine eden ana sınıf veritabanı bağlamı sınıfıdır. Bu 
sınıfı, Microsoft.EntityFrameworkCore.DbContext sınıfından türeterek oluşturursunuz. Kodunuzda, veri modeline 
hangi varlıkların ekleneceğini belirtirsiniz. Ayrıca, belirli Entity Framevvork davranışlarını özelleştirebilirsiniz. Bu 
projede adlı sınıfı schooicontext . 

Proje klasöründe, venadlı bir klasör oluşturun. 

Veri klasöründe, SchoolContext.csad\\ yeni bir sınıf dosyası oluşturun ve şablon kodunu şu kodla değiştirin: 

using ContosoUniversity.Models; 
using Microsoft.EntityFrameworkCore; 

namespace ContosoUniversity.Data 
{ 

public class SchoolContext : DbContext 
{ 

public SchoolContext(DbContextOptions<SchoolContext> options) : base(options) 

{ 

} 

public DbSet<Course> Courses { get; set; } 
public DbSet<Enrollment> Enrollments { get; set; } 
public DbSet<Student> Students { get; set; } 

} 

} 












Bu kod, her varlık kümesi için bir DbSet özelliği oluşturur. Entity Framework terimlerinde, genellikle bir varlık 
kümesi bir veritabanı tablosuna karşılık gelir ve bir varlık tablodaki bir satıra karşılık gelir. 



bunları örtülü olarak içerebilir. 

Veritabanı oluşturulduğunda EF, DbSet Özellik adlarıyla aynı adlara sahip tablolar oluşturur. Koleksiyonlar için 
özellik adları genellikle plural (öğrenci yerine öğrenciler), ancak geliştiriciler tablo adlarının plurulululmasını kabul 
etmez. Bu öğreticiler için DbContext içinde tekil tablo adları belirterek varsayılan davranışı geçersiz kılarsınız. 
Bunu yapmak için, son DbSet özelliğinden sonra aşağıdaki vurgulanmış kodu ekleyin. 

using ContosoUniversity.Models; 
using Microsoft.EntityFrameworkCore; 

namespace ContosoUniversity.Data 
{ 

public class SchoolContext : DbContext 
{ 

public SchoolContext(DbContextOptions<SchoolContext> options) : base(options) 

{ 

} 

public DbSet<Course> Courses { get; set; } 
public DbSet<Enrollment> Enrollments { get; set; } 
public DbSet<Student> Students { get; set; } 

protected override void OnModelCreating(ModelBuilder modelBuilder) 

{ 

modelBuilder.Entity<Course>().ToTable("Course"); 
modelBuilder.Entity<Enrollment>().ToTable("Enrollment"); 
modelBuilder.Entity<Student>().ToTable("Student"); 

} 

} 

} 


SchoolContext kaydetme 

ASP.NET Core, varsayılan olarak bağımlılık ekleme işlemini uygular. Hizmetler (EF veritabanı bağlamı gibi) 
uygulama başlatma sırasında bağımlılık ekleme ile kaydedilir. Bu hizmetleri gerektiren bileşenler (MVC 
denetleyicileri gibi) bu hizmetleri Oluşturucu parametreleri aracılığıyla sağlamaktadır. Bu öğreticide daha sonra 
bir bağlam örneği alan denetleyici Oluşturucu kodunu görürsünüz. 

schooicontext bir hizmet olarak kaydetmek için Startup.csaç\r\ ve vurgulanan satırları configureServices 
yöntemine ekleyin. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 

Services.AddDbContext<SchoolContext>(options => 

options. UseSqlServer(Conf iguration .GetConnectionSt ring ("Def aultConnection"))); 

Services. AddMvc(); 

} 












Bağlantı dizesinin adı, DbContextoptionsBuiider nesnesi üzerinde bir yöntem çağırarak bağlama geçirilir. Yerel 
geliştirme için AS P.N ET Core yapılandırma sistemi bağlantı dizesinden okur appsettings.json dosya. 

ContosoUniversity.Data ve Microsoft.EntityFrameworkCore ad alanları için using deyimleri ekleyin ve ardından 
projeyi derleyin. 

using ContosoUniversity.Data; 
using Microsoft.EntityFrameworkCore; 
using Microsoft.AspNetCore.Http; 

AppSettings. JSON dosyasını açın ve aşağıdaki örnekte gösterildiği gibi bir bağlantı dizesi ekleyin. 

{ 

"ConnectionStrings": { 

"DefaultConnection": "Server= 

(localdb)\\mssqllocaldb;Database=ContosoUniversityl;Trusted_Connection=True;MultipleActiveResultSets=true" 

b 

"Logging": { 

"IncludeScopes": false, 

"LogLevel": { 

"Default": "Warning" 

} 

} 

} 

SQL Server Express LocalDB 

Bağlantı dizesi bir SQL Server LocalDB veritabanı belirtir. LocalDB, SQL Server Express veritabanı altyapısının 
hafif bir sürümüdür ve üretim kullanımı için değil uygulama geliştirmeye yöneliktir. LocalDB, isteğe bağlı olarak 
başlar ve karmaşık yapılandırma olduğundan kullanıcı modunda çalışır. Varsayılan olarak, LocalDB 
c:/users/<user> dizininde. mdf veritabanı dosyaları oluşturur. 

Test verileriyle VERITABANıNı başlatma 

Entity Framevvork, sizin için boş bir veritabanı oluşturacaktır. Bu bölümde, test verileriyle doldurmak için 
veritabanı oluşturulduktan sonra çağrılan bir yöntem yazarsınız. 

Burada, veritabanını otomatik olarak oluşturmak için EnsureCreated yöntemini kullanacaksınız. Sonraki bir 
öğreticide , veritabanını bırakıp yeniden oluşturmak yerine veritabanı şemasını değiştirmek için Code First 
Migrations kullanarak model değişikliklerini nasıl işleyeceğinizi göreceksiniz. 

Veri klasöründe, Dblnitializer.es adlı yeni bir sınıf dosyası oluşturun ve şablon kodunu, gerektiğinde bir 
veritabanının oluşturulmasına neden olan aşağıdaki kodla değiştirin ve test verilerini yeni veritabanına yükler. 

using ContosoUniversity.Models; 
using System; 
using System.Linq; 

namespace ContosoUniversity.Data 
{ 

public static elass Dblnitializer 
{ 

public static void Initialize(SchoolContext context) 

{ 

context.Database.EnsureCreated(); 

// Look for any students. 
if (context.Students.Any()) 

{ 

return; // DB has been seeded 










} 


var students = new Student[] 

{ 

new Student{FirstMidName="Carson",LastName="Alexander",EnrollmentDate=DateTime.Parse("2005-09- 

01 ")}, 

new Student{FirstMidName="Meredith",LastName="Alonso",EnrollmentDate=DateTime.Parse("2002-09- 

01 ")}, 

new Student{FirstMidName="Arturo",LastName="Anand",EnrollmentDate=DateTime.Parse("2003-09-01")}, 
new Student{FirstMidName="Gytis",LastName="Barzdukas",EnrollmentDate=DateTime.Parse("2002-09- 

01 ")}, 

new Student{FirstMidName="Yan",LastName="Li",EnrollmentDate=DateTime.Parse("2002-09-01")}, 
new Student{FirstMidName="P8ggy",LastName="lustice",EnrollmentDate=DateTime.Parse("2001-09-01")}, 
new Student{FirstMidName="Laura",LastName="Norman",EnrollmentDate=DateTlme.Parse("2003-09-01")}, 
new Student{FirstMidName="Nino",LastName="01ivetto",EnrollmentDate=DateTime.Parse("2005-09-01")} 
}; 

foreach (Student s in students) 

{ 

context.Students.Add(s); 

} 

context.SaveChanges(); 

var courses = new Course[] 

{ 

new Course{CourseID=1050,Title="Chemistry",Credits=3}, 
new Course{CourseID=4022,Title="Microeconomics",Credits=3}, 
new Course{CourseID=4041,Title="Macroeconomics",Credits=3}, 
new Course{CourseID=1045,Title="Calculus",Credits=4}, 
new Course{CourseID=3141,Title="Trigonometry",Credits=4}, 
new Course{CourseID=2021,Title="Composition",Credits=3}, 
new Course{CourseID=2042,Title="Literature",Credits=4} 

}; 

foreach (Course c in courses) 

{ 

context.Courses.Add(c); 

} 

context.SaveChanges(); 

var enrollments = new Enrollment[] 

{ 

new Enrollment{StudentID=l,CourseID=1050,Grade=Grade.A}, 
new Enrollment{StudentID=l,CourseID=4022,Grade=Grade.C}, 
new Enrollment{StudentID=l,CourseID=4041,Grade=Grade.B}, 
new Enrollment{StudentID=2,CourseID=1045,Grade=Grade.B}, 
new Enrollment{StudentID=2,CourseID=3141,Grade=Grade.F}, 
new Enrollment{StudentID=2,CourseID=2021,Grade=Grade.F}, 
new Enrollment{StudentID=3,CourseID=1050}, 
new Enrollment{StudentID=4,CourseID=1050}, 
new Enrollment{StudentID=4,CourseID=4022,Grade=Grade.F}, 
new Enrollment{StudentID=5,CourseID=4041,Grade=Grade.C}, 
new Enrollment{StudentID=6,CourseID=1045}, 
new Enrollment{StudentID=7,CourseID=3141,Grade=Grade.A}, 

}J 

foreach (Enrollment e in enrollments) 

{ 

context.Enrollments.Add (e); 

} 

context.SaveChanges(); 

} 

} 

} 

Kod, veritabanında herhangi bir öğrenci olup olmadığını denetler ve yoksa, veritabanının yeni olduğunu ve test 
verileriyle hazırlanması gerektiğini varsayar. Diziye test verileri yükler yerine List<T> performansını iyileştirmek 
için koleksiyonları. 


Program.es' de, uygulama başlangıcında aşağıdakini yapmak için Main yöntemini değiştirin: 




• Bağımlılık ekleme kapsayıcısından bir veritabanı bağlamı örneği alın. 

• Temel yöntemi çağırın ve bu yönteme geçerek bağlamı geçer. 

• Çekirdek yöntemi tamamlandığında bağlamı atın. 

public static void Main(string[] args) 

{ 

var hoşt = CreateWebHostBuilder(args).Build(); 

using (var scope = hoşt.Services.CreateScope()) 

{ 

var Services = scope.ServiceProvider; 
try 
{ 

var context = Services.GetRequiredService<SchoolContext>(); 

Dblnitializer.Initialize(context); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<ILogger<Program>>(); 
logger.LogError(ex, "An error occurred while seeding the database."); 

} 

} 

host.Run(); 

} 

using deyimleri ekle: 

using Microsoft.Extensions.DependencyInjection; 
using ContosoUniversity.Data; 

Daha eski öğreticilerde, Sfortup.csiçinde configure yönteminde benzer bir kod görebilirsiniz. Yalnızca istek 
ardışık düzenini ayarlamak için configure yöntemini kullanmanızı öneririz. Uygulama başlangıç kodu Main 
yöntemine aittir. 

Uygulamayı ilk kez çalıştırdığınızda veritabanı oluşturulur ve test verileriyle birlikte gösterilir. Veri modelinizi her 
değiştirdiğinizde, veritabanını silebilir, çekirdek yönteminizi güncelleştirebilir ve yeni bir veritabanıyla aynı şekilde 
bir baştan başlatabilirsiniz. Sonraki öğreticilerde, veri modeli değiştiğinde ve yeniden oluşturmadan veritabanını 
nasıl değiştireceğiniz hakkında bilgi edineceksiniz. 

Denetleyici ve görünüm oluşturma 

Daha sonra, verileri sorgulamak ve kaydetmek için EF 'i kullanacak bir MVC denetleyicisi ve görünümleri 
eklemek üzere Visual Studio 'da scafkatlama altyapısını kullanacaksınız. 

CRUD eylem yöntemlerinin ve görünümlerinin otomatik olarak oluşturulması, yapı iskelesi olarak bilinir.Yapı 
iskelesi, yapı oluşturma işleminden farklı olarak, kendi gereksinimlerinize uyacak şekilde değiştirebileceğiniz bir 
başlangıç noktası ve genellikle oluşturulan kodu değiştirmezsiniz. Oluşturulan kodu özelleştirmeniz gerektiğinde, 
kısmi sınıfları kullanırsınız veya işlemler değiştiğinde kodu yeniden oluşturmanız gerekir. 

• Çözüm Gezgini 1 de denetleyiciler klasörüne sağ tıklayın ve > yeni iskele öğe Ekle' yi seçin. 

• Yapı İskelesi Ekle iletişim kutusunda: 

o Entity Framevvork kullanarak, görünümlerle MVC denetleyicisi ' niseçin. 

o Ekle'ye tıklayın. Görünümler İle MVC denetleyicisi ekleme, Entity Framevvork kullanma 

iletişim kutusu görüntülenir. 







Add MVC Controller with views, using Entity Framework X 


Model elass: 


Student (ContosoUniversity.Models) 
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Data context elass: 


SchoolContext (ContosoUniversity.Data) 
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0 Generate vievvs 
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0 Use a layout page: 
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(Leave empty if it is set in a Razor _viewstart file) 


Controller name: 


Studentscontroller 





Add 


Cancel 


o Model sınıfı ' nda öğrenci' yi seçin, 
o Veri bağlamı sınıfında SchoolContextöğesini seçin, 
o Varsayılan Studentscontroller adını olarak kabul edin, 
o Ekle'ye tıklayın. 

Ekle' ye tıkladığınızda, Visual Studio yapı iskelesi altyapısı, denetleyicisiyle birlikte çalışan bir 
StudentsController.es dosyası ve bir dizi görünüm (. cshtml dosyası) oluşturur. 

(Yapı iskelesi altyapısı, daha önce Bu öğreticide yaptığınız gibi, daha önce el ile oluşturmazsanız, sizin için 
veritabanı bağlamını de oluşturabilir. Veri bağlam sımfınmsağ tarafındaki artı İşaretine tıklayarak Denetleyici 
Ekle kutusunda yeni bir bağlam sınıfı belirtebilirsiniz. Daha sonra Visual Studio, DbContext sınıfınızın yanı sıra 
denetleyiciyi ve görünümleri de oluşturacaktır.) 

Denetleyicinin bir schooicontext Oluşturucu parametresi olarak aldığını fark edeceksiniz. 

namespace ContosoUniversity.Controllers 
{ 

public elass StudentsController : Controller 
{ 

private readonly SchoolContext _context; 

public StudentsController(SchoolContext context) 

{ 

_context = context; 

} 

ASP.NET Core bağımlılığı ekleme, denetleyiciye schooicontext bir örneği geçirmekten yararlanır. Bunu 
Startup.es dosyasında daha önce yapılandırdınız. 

Denetleyici, veritabanındaki tüm öğrencileri görüntüleyen bir index Action yöntemi içerir. Yöntemi, veritabanı 
bağlamı örneğinin students özelliğini okuyarak öğrenciler varlık kümesinden öğrencilerin bir listesini alır: 












































public async Task<IActionResult> Index() 

{ 

return View(await _context.Students.ToListAsync()); 

} 


Öğreticide daha sonra bu kodda zaman uyumsuz programlama öğeleri hakkında bilgi edineceksiniz. 
Views/öğrenciler/lndex. cshtml görünümü bu listeyi bir tabloda görüntüler: 

@model IEnumerablecContosoUniversity.Models.Student> 

@{ 

ViewData["Title"] = "Index"; 

} 

<h2>Index</h2> 

<P> 

<a asp-action="Create">Create New</a> 

</p> 

<table class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model => model.LastName) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.FirstMidName) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.EnrollmentDate) 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

(Şforeach (var item in Model) { 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.LastName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.FirstMidName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.EnrollmentDate) 

</td> 

<td> 

<a asp-action="Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-action="Details" asp-route-id="@item.ID">Details</a> | 

<a asp-action="Delete" asp-route-id="@item.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 


Projeyi çalıştırmak için CTRL + F5 tuşlarına basın veya menüden hata ayıklama > Başlat 1 ı seçin. 

Dbinitializer. initialize yönteminin eklendiği test verilerini görmek için öğrenciler sekmesine tıklayın. Tarayıcı 
pencerenizin ne kadar dar olduğuna bağlı olarak, sayfanın üst kısmında students Tab bağlantısını görürsünüz 
veya bağlantıyı görmek için sağ üst köşedeki gezinti simgesine tıklamanız gerekir. 






H Home Page - Contoso IX + 

□ 

X 

localhost:5313 

O ☆ 

... 

Contoso üniversity 


— 


Home 

About 

Students 

Courses 

İnstructors 

Departments 



B lndex - Contoso Univen X -(- 


- □ X 

^ ^3 localhost 

☆ 

= m 

Contoso Üniversity 


— 


lndex 


Create New 


LastName 

FirstMidName 

EnrolImentDate 



Alexander 

Carson 

9/1/2005 12:00:00 AM 

İD 

LU 

| Details | Delete 

Alonso 

Meredith 

9/1/2002 12:00:00 AM 

LU 

| Details | Delete 

Anand 

Arturo 

9/1/2003 12:00:00 AM 

B 

LU 

| Details | Delete 

Barzdukas Gytis 

9/1/2002 12:00:00 AM 

Edit | Details | Delet^^ 

jh , > ^ 


Veritabanını görüntüleme 

Uygulamayı başlattığınızda, Dbinitializer.initialize yöntemi EnsureCreated çağırır. EF, bir veritabanı 
olmadığını ve bu nedenle bir tane oluşturduğunu gördük, initialize yöntemi kodunun geri kalanı veritabanını 
verilerle doldurmuş. Visual Studio 'da veritabanını görüntülemek için SQL Server Nesne Gezgini (ssox) 
kullanabilirsiniz. 

Tarayıcıyı kapatın. 

SSOX penceresi henüz açık değilse, Visual Studio 'daki Görünüm menüsünden bunu seçin. 

SSOX 'te (LocalDB) \MSSQLLocalDB > veritabanları' na tıklayın ve ardından appSettings. JSON 
dosyanızdaki bağlantı dizesinde bulunan veritabanı adı için girişe tıklayın. 

Veritabanınızdaki tabloları görmek için Tablolar düğümünü genişletin. 












SQL Server Object Explorer 

6 | *i *& 

A 8* SQL Server 

a Ş (localdb)\MSSQLLocalDB (SQL S 
' a Databases 

> Ü System Databases 

> Q aspnet-ContactManager- 

alfffliTOÜffSüinfflHS 

a Tables 


System Tables 
External Tables 


dbo.Course 

dbo.EnrolIment 

dbo.Student 


Oluşturulan sütunları ve tabloya eklenmiş satırları görmek için öğrenci tablosuna sağ tıklayın ve verileri 
görüntüle 1 ye tıklayın. 


* ContosoUniversity 


dbo.Students [Data] -o X | 

C/ İ0 T > MaxRows: 1000 


n n 


İD 


EnrolImentDate FirstMidName LastName 


► JB 

_ 2 

3 




9/1/200512:00:... Carson 
9/1/200212:00:... Meredith 
9/1/200312:00:... Arturo 
9/1/200212:00:... Gytis 
9/1/200212:00:... Yan 


Alexander 

Alonso 

Anand 

Barzdukas 


. Mc/fve. /df veritabanı dosyaları, C:\Users\<YourUserName > klasöründedir. 

Uygulama başlatma sırasında çalışan Başlatıcı yönteminde EnsureCreated çağırırken, artık student sınıfında bir 
değişiklik yapabilir, veritabanını silebilir, uygulamayı yeniden çalıştırabilirsiniz ve veritabanı, değişikliklerinizi 
eşleştirmek için otomatik olarak yeniden oluşturulur. Örneğin, student sınıfına bir EmailAddress özelliği 
eklerseniz, yeniden oluşturulan tabloda yeni bir EmailAddress sütunu görürsünüz. 

Kurallar 

Entity Framevvork, kuralların kullanımı veya Entity Framework varsayımlarıyla ilgili olarak en az bir veritabanı 
oluşturabilmesini sağlamak için yazmanız gereken kod miktarı. 

• DbSet özelliklerinin adları tablo adı olarak kullanılır. DbSet özelliği tarafından başvurulmayan varlıklar 
için, varlık sınıfı adları tablo adı olarak kullanılır. 

• Varlık özelliği adları, sütun adları için kullanılır. 

• İD veya Classnameıd olarak adlandırılan varlık özellikleri, birincil anahtar özellikleri olarak tanınır. 

• Bir özellik, bir yabancı anahtar özelliği olarak yorumlanır <gezinti özelliği adi ><birirıcil anahtar özellik adi 
> (örneğin, studentiD , birincil anahtarı student olduğundan student gezinti özelliği için id ). Yabancı 
anahtar özellikleri, <birirıcil anahtar özellik adı > olarak da adlandırılabilir (örneğin, Enroiiment varlığının 
birincil anahtarı EnrollmentlD olduğundan EnrollmentlD ). 

Geleneksel davranış geçersiz kılınabilir.Örneğin, bu öğreticide daha önce gördüğünüz gibi tablo adlarını açıkça 
belirtebilirsiniz. Ayrıca, bu serinin sonraki bir öğreticide göreceğiniz gibi, sütun adlarını ayarlayabilir ve herhangi 
bir özelliği birincil anahtar veya yabancı anahtar olarak ayarlayabilirsiniz. 


Zaman uyumsuz kod 






























Zaman uyumsuz programlama, ASP.NET Core ve EF Core için varsayılan moddur. 

Sınırlı sayıda iş parçacığı kullanılabilir bir vveb sunucusuna sahip ve yüksek yük durumlarda tüm kullanılabilir iş 
parçacıklarının kullanımda olabilir. Bu durum oluştuğunda, sunucunun iş parçacıklarının serbest bırakılana kadar 
yeni istekleri işleyemiyor. G/ç tamamlanması bekleniyor çünkü bunlar herhangi bir iş gerçekten yapmamanız 
sırasında eş zamanlı kod ile birçok iş parçacığı bağlanması, işlemi tamamlamak, g/ç için beklerken zaman 
uyumsuz kod ile diğer istekleri işlemek için kullanılacak sunucuyu için kendi iş parçacığı serbest bırakılır. Sonuç 
olarak, sunucu kaynaklarının daha etkin kullanılması zaman uyumsuz kod sağlar ve sunucu gecikmeler olmadan 
daha fazla trafik işlemek için etkinleştirilir. 

Zaman uyumsuz kod, çalışma zamanında az miktarda yük getirir, ancak düşük trafik durumlarında performans 
artışı göz ardı edilebilir, ancak yüksek trafik durumları için olası performans iyileştirmesi oldukça önemlidir. 

Aşağıdaki kodda async anahtar sözcüğü, Task<T> dönüş değeri, await anahtar sözcüğü ve ToListAsync 
metodu kodu zaman uyumsuz olarak yürütür. 

public async Task<IActionResult> Index() 

{ 

return View(await _context.Students.ToListAsync()); 

} 

• async anahtar sözcüğü, derleyiciye Yöntem gövdesinin parçaları için geri çağrılar oluşturmasını ve 
döndürülen Task<iActionResuit> nesnesini otomatik olarak oluşturmasını söyler. 

• Task<iActionResuit> dönüş türü, iActionResuit türünde bir sonuçla devam eden işi temsil eder. 

• await Anahtar sözcüğü, derleyicinin yöntemin iki parçalara bölmek neden olur. İlk bölüm ile zaman 
uyumsuz olarak başlatıldığında işlemi sonlandırır. ikinci bölümü, işlemi tamamlandıktan sonra çağrılan bir 
geri çağırma yöntemi yerleştirilir. 

• ToListAsync zaman uyumsuz sürümüdür ToList genişletme yöntemi. 

Entity Framevvork kullanan zaman uyumsuz kod yazarken dikkat edilmesi gereken bazı şeyler: 

• Yalnızca sorguları veya komutlarının veritabanına gönderilmesine neden olan deyimler zaman uyumsuz 
olarak yürütülür. Bu, örneğin, ToListAsync , singleOnDefaultAsync ve saveChangesAsync içerir. Örneğin, 

var students = context.Students.Where(s => s.LastName == "Davolio") gibi yalnızca bir IÇueryable 
değiştiren deyimler dahil değildir. 

• EF bağlamı iş parçacığı açısından güvenli değildir: paralel olarak birden çok işlem yapmayı denemeyin. 
Flerhangi bir zaman uyumsuz EF yöntemini çağırdığınızda her zaman await anahtar sözcüğünü kullanın. 

• Zaman uyumsuz kodun performans avantajlarından yararlanmak isterseniz, kullanmakta olduğunuz tüm 
kitaplık paketlerinin (örneğin, sayfalama için), sorguların veritabanına gönderilmesine neden olan herhangi 
bir Entity Framevvork yöntemini çağırıyorsa, zaman uyumsuz olarak da kullanılmasını sağlayın. 

.N ET ' te zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. Async Overvievv. 

Kodu alın 

Tamamlanmış uygulamayı indirin veya görüntüleyin. 

Sonraki adımlar 

Bu öğreticide şunları yaptınız: 

• ASP.NET Core MVC vveb uygulaması oluşturuldu 


















• Site stili Ayarla 

• EF Core NuGet paketleri hakkında bilgi edinildi 

• Veri modeli oluşturuldu 

• Veritabanı bağlamı oluşturuldu 

• SchoolContext kaydedildi 

• Test verileriyle VERITABANı başlatıldı 

• Denetleyici ve görünümler oluşturuldu 

• Veritabanı görüntüleniyor 

Aşağıdaki öğreticide, temel CRUD (oluşturma, okuma, güncelleştirme, silme) işlemlerini nasıl 
gerçekleştireceğinizi öğreneceksiniz. 

Temel CRUD (oluşturma, okuma, güncelleştirme, silme) işlemlerini nasıl gerçekleştireceğinizi öğrenmek için 
sonraki öğreticiye ilerleyin. 

Temel CRUD işlevlerini uygulama 



Öğretici: EF Core ile CRUD İşlevselliği uygulama- 
ASPNET MVC 

11.10.2019 • 32 minutes to readı Edit Online 


Önceki öğreticide, Entity Framevvork ve LocalDB SQL Server kullanarak verileri depolayan ve görüntüleyen bir 
MVC uygulaması oluşturdunuz. Bu öğreticide, bu CRUD (oluşturma, okuma, güncelleştirme, silme) kodunu 
inceleyerek, MVC yapı iskelesi denetleyiciler ve görünümlerde sizin için otomatik olarak oluşturulur. 


NOTE 

Denetleyiciniz ve veri erişim katmanı arasında bir soyutlama katmanı oluşturmak için depo deseninin uygulanması yaygın 
bir uygulamadır Bu öğreticileri basit tutmak ve Entity Framevvork kendisini nasıl kullanacağınızı öğretmeniz için, depoları 
kullanmaz. EF olan depolar hakkında daha fazla bilgi için Bu serideki son öğreticiyebakın. 


Bu öğreticide şunları yaptınız: 

• Ayrıntılar sayfasını özelleştirme 

• Oluştur sayfasını Güncelleştir 

• Düzenleme sayfasını Güncelleştir 

• Silme sayfasını Güncelleştir 

• Veritabanı bağlantılarını kapat 

Önkoşullar 

• EF Core ve ASP.NET Core MVC ile çalışmaya başlama 

Ayrıntılar sayfasını özelleştirme 

Bu özellik bir koleksiyon içerdiğinden, öğrenciler dizin sayfasına yönelik scafkatlanmış kod Enroiiments 
özelliğini bıraktı. Ayrıntılar sayfasında, koleksiyonun İÇERİĞİNİ bir HTML tablosunda görüntüleyeceksiniz. 

Controllers/StudentsController. csdosyasında, Ayrıntılar görünümü için eylem yöntemi tek bir student varlığı 
almak için singleOrDefaultAsync yöntemini kullanır. @No__t-0 çağıran kodu ekleyin. Aşağıdaki Vurgulanan 
kodda gösterildiği gibi, Theninciude ve AsNoTracking yöntemleri. 










public async Task<IActionResult> Details(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var student = await _context.Students 
.Include(s => s.Enrollments) 

.Thenlnclude(e => e.Course) 

.AsNoTracking() 

.FirstOrDefaultAsync(m => m.ID == id); 

if (student == null) 

{ 

return NotFound(); 

} 

return View(student); 

} 

@No__t-0ve Theninciude yöntemleri, bağlamın student.Enrollments gezinti özelliğini yüklemesine ve her 
kayıt için Enroiiment.course gezinti özelliğine neden olur, ilgili verileri oku öğreticisinde bu yöntemler hakkında 
daha fazla bilgi edineceksiniz. 

@No__t-0 yöntemi, döndürülen varlıkların geçerli bağlamın ömrü içinde güncellenmeyeceği senaryolarda 
performansı geliştirir. Bu öğreticinin sonunda AsNoTracking hakkında daha fazla bilgi edineceksiniz. 

Veri yönlendirme 

@No__t-0 yöntemine geçirilen anahtar değeri Rota verilerinden gelir. Rota verileri, model cildin URL 'nin bir 
kesiminde bulduğu veriler olur. Örneğin, varsayılan yol denetleyiciyi, eylemi ve kimlik segmentlerini belirtir: 

app.UseMvc(routes => 

{ 

routes.MapRoute( 

name: "default"., 

template: "{controller=Home}/{action=Index}/{id?}"); 

}); 

Aşağıdaki URL 'de, varsayılan yol eğitmeni denetleyici olarak eşler, eylem olarak dizin ve kimlik olarak 1; Bunlar 
rota veri değerleridir. 

http://localhost:1230/Instructor/Index/l?courseID=2021 

URL 'nin son bölümü ("? CourselD = 2021") bir sorgu dizesi değeridir.Model Ciltçi Ayrıca KİMLİK değerini bir 
sorgu dizesi değeri olarak geçirdiğinizde index yöntemine id parametresine geçicektir: 

http://localhost:1230/Instructor/Index?id=l&CourseID=2021 

Dizin sayfasında, bağ URL 'Leri Razor görünümündeki Tag Helper deyimleri tarafından oluşturulur.Aşağıdaki 
Razor kodunda, id parametresi varsayılan yol ile eşleşir, bu nedenle yol verilerine id eklenir. 

<a asp-action="Edit" asp-route-id="@item.ID">Edit</a> 


Bu, item.iD 6 olduğunda aşağıdaki HTML 'yi oluşturur: 
















<a href="/Students/Edit/6">Edit</a> 

Aşağıdaki Razor kodunda, studentiD varsayılan rotadaki bir parametreyle eşleşmez, bu nedenle bir sorgu 
dizesi olarak eklenir. 


<a asp-action="Edit" asp-route-studentID="@item.ID">Edit</a> 


Bu, item.iD 6 olduğunda aşağıdaki HTML 'yi oluşturur: 


<a href="/Students/Edit?studentID=6">Edit</a> 


Etiket Yardımcıları hakkında daha fazla bilgi için bkz. AS P.N ET Core etiket yardımcıları. 

Ayrıntılar görünümüne kayıtları ekleyin 

Görünümleri/öğrencileri/details. cshfm/dosyasını açın. Her alan, aşağıdaki örnekte gösterildiği gibi 
DisplayNameFor ve DisplayFor yardımcıları kullanılarak görüntülenir: 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model = > model.LastName) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model = > model.LastName) 

</dd> 

Son alandan sonra ve kapanış </di> etiketinden hemen önce, kayıt listesini göstermek için aşağıdaki kodu 
ekleyin: 

<dt class="col-sm-2"> 

@Html.Displayl\lameFor(model => model.Enrollments) 

</dt> 

<dd class="col-sm-10"> 
ctable class="table"> 

<tr> 

<th>Course Title</th> 

<th>Grade</th> 

</tr> 

(Şforeach (var item in Model.Enrollments) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => İtem.Course.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => İtem.Grade) 

</td> 

</tr> 

} 

</table> 

</dd> 


Kodu yapıştırdıktan sonra kod girintileme yanlış ise, düzeltmek için CTRL-K-D tuşlarına basın. 

Bu kod Enrollments Gezinti özelliğindeki varlıklar aracılığıyla döngü başlatır. Her kayıt için kurs başlığını ve 
sınıfı görüntüler. Kurs başlığı, kayıt varlığının course gezinti özelliğinde depolanan kurs varlığından alınır. 

Uygulamayı çalıştırın, öğrenciler sekmesini seçin ve bir öğrenci için Ayrıntılar bağlantısına tıklayın. Seçili 
öğrenci için Kurslar ve notlar listesini görürsünüz: 














Oluştur sayfasını Güncelleştir 

StudentsController.es' de, birtry-catch bloğu ekleyerek ve Bind özniteliğinden kimliği kaldırarak httppost 
create yöntemini değiştirin. 

[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Create( 

[Bind("EnrollmentDate,FirstMidName, LastName")] Student student) 

{ 

try 

{ 

if (ModelState.IsValid) 

{ 

_context.Add(student); 

await _context.SaveChangesAsync(); 

return RedirectToAction(nameof(Index)); 

} 

} 

catch (DbUpdateException /* ex */) 

{ 

//Log the error (uncomment ex variable name and write a log. 

ModelState.AddModelError("", "Unable to save changes. " + 

"Try again, and if the problem persists " + 

"see your system administrator."); 

} 

return View(student); 


Bu kod, AS P.N ET Core MVC model Ciltçi tarafından oluşturulan öğrenci varlığını öğrenciler varlık kümesine 
ekler ve değişiklikleri veritabanına kaydeder. (Model Ciltçi, bir form tarafından gönderilen verilerle çalışmanıza 
daha kolay hale getiren AS P.N ET Core MVC işlevselliğine başvurur; bir model Bağlayıcısı, postalanan form 
değerlerini CLR türlerine dönüştürür ve parametreleri parametreler' de eylem yöntemine geçirir. Bu durumda 
model Ciltçi, form koleksiyonundaki özellik değerlerini kullanarak sizin için bir öğrenci varlığı oluşturur.) 

"Satır eklendiğinde SQL Server otomatik olarak ayarlanacak birincil anahtar değeri olduğundan, Bind 











özniteliğinden id 1 yı kaldırmış olursunuz. Kullanıcı girişi, KİMLİK değerini ayarladı. 

@No__t-0 özniteliği dışında, try-catch bloğu, scafkatlanmış kodda yapmış olduğunuz tek değişikdir. Değişiklikler 
kaydedilirken DbupdateException 1 dan türetilen bir özel durum yakalanmışsa, genel bir hata iletisi görüntülenir. 
DbupdateException özel durumlar bazen bir programlama hatası yerine uygulamanın harici bir şeydir, bu 
nedenle, kullanıcının yeniden denemek tavsiye edilir. Bu örnekte uygulanmamış olsa da, bir üretim kalitesi 
uygulaması özel durumu günlüğe kaydeder. Daha fazla bilgi için bkz. İzleme ve telemetri bölümünde 
Öngörüler İçin günlük (Azure İle gerçek bulut uygulamaları oluşturma). 

@No__t-0 özniteliği, siteler arası istek sahteciliği (CSRF) saldırılarını önlemeye yardımcı olur. Belirteç, 
Formtaghelper tarafından otomatik olarak görünüme eklenir ve form kullanıcı tarafından gönderildiğinde dahil 
edilir. Belirteç validateAntiForgeryToken özniteliği tarafından onaylanır. CSRF hakkında daha fazla bilgi için bkz. 
İstek önleyicigüvenlik. 

Fazla nakil hakkında güvenlik notunda 

iskele eklenen kodun create yöntemine dahil olduğu Bind özniteliği, oluşturma senaryolarında çok fazla 
gönderim için bir yoldur. Örneğin, öğrenci varlığının bu Web sayfasının ayarlamak istemediğiniz bir secret 
özelliği içerdiğini varsayalım. 

public class Student 

{ 

public int ID { get; set; } 
public string LastName { get; set; } 
public string FirstMidName { get; set; } 
public DateTime EnrollmentDate { get; set; } 
public string Secret { get; set; } 

} 

Web sayfasında secret alanı olmasa bile, bir korsan Fiddler gibi bir araç kullanabilir veya bir secret form 
değeri göndermek için bazı JavaScript'ler yazabilir. @No__t-0 özniteliği olmadan model cildin bir öğrenci 
örneği oluşturduğunda kullandığı alanları sınırlayarak model Ciltçi, bu secret form değerini seçer ve öğrenci 
varlık örneğini oluşturmak için onu kullanır. Daha sonra, secret form alanı için belirtilen korsanın hangi değeri 
veritabanınızda güncelleştirilemeyebilir. Aşağıdaki görüntüde, secret alanı ("OverPost" değeri ile), postalanan 
form değerlerine eklenirken Fiddler aracı gösterilmektedir. 



Parsed Ravv Scratdıpad Opfions 


POST 


v http://localhost: 1236/Student/Create 


v HTTP/1.1 


ReguestFIeaders 


[ Upload file... ] Help.. 


Hoşt: localhost: 1236 

User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64; rv:22.0) Gecko/20100101 Firefox/22.0 

Accept: text/html,applicatjon/xhtml+xml,applicaton/xml;q=0.9,*/' , ;q=0.8 

Accept-Language: en-US,en;q=0.5 

Accept-Encodlng: gzip, deflate 

Referer: http://localhost: 1236/Student/Create 

Cookie:_RequestVerificatîonToken=-OqMEtdNIwFGDdjFIUS_-XDoOSCqS1515g7ASzrFKwQPjpxRT2hN_tm6pDZbSOHVVTGMr 

Connection: keep-alive 

Content-Type: application/x-www-fbrm-urlencoded 
Content-Length: 227 


RequestBody 


4Pr^s ı 


sl8d.astName=Smith&FirstMidName=Joe&EnrollmentDate=7%2F31%2F2013+4%3A58%3A23 


ecret=OverPost 


Daha sonra "OverPost" değeri, eklenen satırın secret özelliğine başarıyla eklenir, ancak hiçbir şekilde Web 








































sayfasının bu özelliği ayarlayabilmesini amaçlayamazsınız. 

Önce veritabanından varlığı okuyup daha sonra açıkça izin verilen bir Özellikler listesine geçirerek 
TryupdateModei ' ı çağırarak düzenleme senaryolarında fazla nakletmeyi engelleyebilirsiniz. Bu, bu öğreticilerde 
kullanılan yöntemidir. 

Birçok geliştirici tarafından tercih edilen aşırı nakletmeyi önlemenin alternatif bir yolu, model bağlamasıyla 
varlık sınıfları yerine görüntüleme modellerini kullanmaktır. Yalnızca görünüm modelinde güncelleştirmek 
istediğiniz özellikleri ekleyin. MVC model Bağlayıcısı tamamlandıktan sonra, görünüm modeli özelliklerini, 
isteğe bağlı olarak, Automaber gibi bir araç kullanarak varlık örneğine kopyalayın. Varlık örneğindeki 
_context. Entry ' ı kullanarak durumunu unchanged olarak ayarlayın ve ardından Görünüm modelinde bulunan 
her bir varlık özelliğinde Property("PropertyName") .isModified 1 yi true olarak ayarlayın. Bu yöntem hem 
düzenleme hem de oluşturma senaryolarında çalışmaktadır. 

Oluştur sayfasını test etme 

Vlews/öğrenciler/Create. cshtml içindeki kod, her alan için label , input ve span (doğrulama iletileri için) 
etiket yardımcıları kullanır. 

Uygulamayı çalıştırın, öğrenciler sekmesini seçin ve Yeni oluştur 1 a tıklayın. 

Ad ve tarih girin. Tarayıcınız bunu yapmanızı sağlar, geçersiz bir tarih girmeyi deneyin.(Bazı tarayıcılar bir tarih 
seçici kullanmanıza zorlar.) Hata iletisini görmek için Oluştur 1 a tıklayın. 



Bu, varsayılan olarak aldığınız sunucu tarafı doğrulamadır; sonraki bir öğreticide, istemci tarafı doğrulama için 
kod oluşturacak özniteliklerin nasıl ekleneceğini görürsünüz. Aşağıdaki Vurgulanan kodda, create yönteminde 
model doğrulama denetimi gösterilmektedir. 






















[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Create( 

[Bind("EnrollmentDate,FirstMidName,LastName")] Student student) 

{ 

try 

{ 

if (ModelState.IsValid) 

{ 

_context.Add(student); 

await _context.SaveChangesAsync(); 

return RedirectToAction(nameof(Index)); 

} 

} 

catch (DbUpdateException /* ex */) 

{ 

//Log the error (uncomment ex variable name and write a log. 
ModelState.AddModelError("", "Unable to save changes. " + 
"Try again, and if the problem persists " + 

"see your system administrator."); 

} 

return View(student); 


Tarihi geçerli bir değer olarak değiştirin ve yeni öğrencinin Dizin sayfasında göründüğünü görmek için Oluştur 
' a tıklayın. 


Düzenleme sayfasını Güncelleştir 

StudentController.es' de, httpget Edit yöntemi ( HttpPost özniteliği olmayan), Details yönteminde 
gördüğünüz gibi seçili öğrenci varlığını almak için singleOrDefaultAsync yöntemini kullanır. Bu yöntemi 
değiştirmeniz gerekmez. 

Önerilen HttpPost düzenleme kodu: okuma ve güncelleştirme 

HttpPost düzenleme eylemi yöntemini aşağıdaki kodla değiştirin. 









[HttpPost, ActionlMame("Edit")] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> EditPost(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var studentToUpdate = await _context.Students.FirstOrDefaultAsync(s => s.ID == id); 
if (await TryUpdateModelAsync<Student>( 
studentToUpdate, 

i 

s => s.FirstMidName, s => s.LastName, s => s.EnrollmentDate)) 

{ 

try 

{ 

await _context.SaveChangesAsync(); 
return RedirectToAction(nameof(Index)); 

} 

catch (DbUpdateException /* ex */) 

{ 

//Log the error (uncomment ex variable name and write a log.) 

ModelState.AddModelError("", "Unable to save changes. " + 

"Try again, and if the problem persists, " + 

"see your system administrator."); 

} 

} 

return View(studentToUpdate); 

} 

Bu değişiklikler, aşırı nakletmeyi engellemek için en iyi güvenlik uygulamasını uygular.Desteği bir Bind 
özniteliği üretti ve model Ciltçi tarafından oluşturulan varlığı bir Modified bayrağıyla ekledi. Bu kod pek çok 
senaryo için önerilmez çünkü Bind özniteliği inciude parametresinde listelenmeyen alanlarda önceden var 
olan verileri temizler. 

Yeni kod, mevcut varlığı okur ve alınan varlıktaki alanları, postalanan form verilerinde Kullanıcı girişine 
göregüncelleştirmek için TryupdateModei çağırır. Entity Framevvork otomatik değişiklik izleme, form girişi 
tarafından değiştirilen alanlarda Modified bayrağını ayarlar. @No__t-0 yöntemi çağrıldığında, Entity 
Framevvork veritabanı satırını güncelleştirmek için SQL deyimleri oluşturur. Eşzamanlılık çakışmaları yok sayılır 
ve yalnızca Kullanıcı tarafından güncellenen tablo sütunları veritabanında güncelleştirilir. (Sonraki bir öğretici 
eşzamanlılık çakışmalarının nasıl işleneceğini gösterir.) 

Fazla nakletmeyi önleyen en iyi yöntem olarak, düzenleme sayfası tarafından güncelleştirilemek istediğiniz 
alanlar TryupdateModei parametrelerinde beyaz listeye alınır. (Parametre listesindeki alanlar listesinden önceki 
boş dize, form alanları adlarıyla kullanılacak bir ön ek içindir.) Şu anda koruduğunuz ek alan yok, ancak model 
cildin bağlamasını istediğiniz alanları listelemek, gelecekte veri modeline alanlar eklerseniz, bunları buraya 
açıkça eklemeene kadar otomatik olarak korunur. 

Bu değişikliklerin sonucu olarak, HttpPost Edit yönteminin yöntem imzası, HttpGet Edit yöntemiyle aynıdır; 
Bu nedenle, EditPost metodunu yeniden adlandırdınız. 

Alternatif HttpPost düzenleme kodu: oluşturma ve iliştirme 

Önerilen HttpPost düzenleme kodu yalnızca değiştirilen sütunların güncelleştirilmesini sağlar ve model 
bağlama dahil etmek istemediğiniz özelliklerde verileri korur. Ancak, ilk okuma yaklaşımı, fazladan bir veritabanı 
okuması gerektirir ve eşzamanlılık çakışmalarını işlemek için daha karmaşık kod oluşmasına neden olabilir. 
Diğer bir seçenek de model cildi tarafından oluşturulan bir varlığı EF bağlamına eklemektir ve değiştirildi olarak 
işaretler. (Projenizi bu kodla güncelleştirmeyin, yalnızca isteğe bağlı bir yaklaşımı göstermek için gösterilir.) 












public async Task<IActionResult> Edit(int id, [Bind("ID,EnrollmentDate,FirstMidName,LastName")] Student 
student) 

{ 

if (id != student.ID) 

{ 

return NotFound(); 

} 

if (ModelState.IsValid) 

{ 

tny 

{ 

_context.Update(student); 

await _context.SaveChangesAsync(); 

return RedirectToAction(nameof(Index)); 

} 

catch (DbUpdateException /* ex */) 

{ 

//Log the error (uncomment ex variable name and write a log.) 

ModelState.AddModelError("", "Unable to save changes. " + 

"Try again, and if the problem persists, " + 

"see your system administrator."); 

} 

} 

return View(student); 

} 

Web sayfası kullanıcı arabirimi varlıktaki tüm alanları içerdiğinde ve bunlardan herhangi birini 
güncelleştirebilmeniz durumunda bu yaklaşımı kullanabilirsiniz. 

Scafkatlanmış kod, oluşturma ve iliştirme yaklaşımını kullanır, ancak yalnızca DbupdateConcurrencyException özel 
durumlarını yakalar ve 404 hata kodları döndürür. Gösterilen örnek herhangi bir veritabanı güncelleştirme özel 
durumunu yakalar ve bir hata iletisi görüntüler. 

Varlık durumları 

Veritabanı bağlamı, bellekteki varlıkların veritabanında karşılık gelen satırlarıyla eşitlenmiş olup olmadığını izler 
ve bu bilgiler Savechanges yöntemini çağırdığınızda ne olacağını belirler. Örneğin, Add yöntemine yeni bir 
varlık geçirdiğinizde, bu varlığın durumu Added olarak ayarlanır. Sonra, Savechanges yöntemini çağırdığınızda 
veritabanı bağlamı bir SQL INSERT komutu yayınlar. 

Bir varlık aşağıdaki durumlardan birinde olabilir: 

• Added . Varlık veritabanında henüz yok. @No__t-0 yöntemi bir INSERT ifadesini yayınlar. 

• unchanged . @No__t-0 yöntemiyle bu varlıkla hiçbir şeyin yapılması gerekmez. Veritabanından bir varlık 
okuduğunuzda, varlık bu durumla başlar. 

• Modified . Varlığın özellik değerlerinin bazıları veya tümü değiştirildi. @No__t-0 yöntemi bir UPDATE 
ifadesini yayınlar. 

• Deleted . Varlık silinmek üzere işaretlendi. @No__t-0 yöntemi bir DELETE ifadesini yayınlar. 

• Detached . Varlık, veritabanı bağlamı tarafından izlenmiyor. 

Bir masaüstü uygulamasında durum değişiklikleri genellikle otomatik olarak ayarlanır. Bir varlığı okur ve bazı 
özellik değerlerinde değişiklik yaparsınız. Bu, varlık durumunun otomatik olarak Modified olarak 
değiştirilmesine neden olur. @No__t-0 ' ı çağırdığınızda, Entity Framework yalnızca değiştirdiğiniz gerçek 
özellikleri güncelleştiren bir SQL UPDATE bildirisi oluşturur. 

Bir Web uygulamasında, ilk olarak bir varlığı okuyan DbContext ve bir sayfa işlendikten sonra düzenlenecek 
verilerini görüntüler. HttpPost Edit eylem yöntemi çağrıldığında yeni bir Web isteği yapılır ve DbContext 1 in 
yeni bir örneğine sahip olursunuz. Varlığı bu yeni bağlamda yeniden okuduğunuzda masaüstü işleme benzetimi 














yapılır. 


Ancak, fazladan okuma işlemi yapmak istemiyorsanız, model Ciltçi tarafından oluşturulan varlık nesnesini 
kullanmanız gerekir. Bunu yapmanın en kolay yolu, daha önce gösterilen diğer HttpPost düzenleme kodunda 
yapıldığı gibi varlık durumunun değiştirilme olarak ayarlanmanız olur. Sonra, Savechanges ' ı çağırdığınızda, 
bağlam hangi özelliklerden hangilerinin değiştirildiğini bilen bir yolu olmadığından, Entity Framework 
veritabanı satırının tüm sütunlarını günceller. 

ilk okuma yaklaşımına engel olmak istiyorsanız, ancak SQL UPDATE bildiriminin yalnızca kullanıcının gerçekten 
değiştirdiği alanları güncelleştirmesini istiyorsanız, kod daha karmaşıktır. HttpPost Edit yöntemi çağrıldığında 
kullanılabilir olmaları için özgün değerleri bir şekilde (örneğin, gizli alanları kullanarak) kaydetmeniz gerekir. 
Ardından özgün değerleri kullanarak bir öğrenci varlığı oluşturabilir, Attach yöntemini varlığın orijinal 
sürümüyle çağırabilir, varlığın değerlerini yeni değerlerle güncelleştirebilir ve ardından Savechanges 1 i 
çağırabilirsiniz. 

Düzenleme sayfasını test etme 

Uygulamayı çalıştırın, öğrenciler sekmesini seçin ve köprü Düzenle 1 ye tıklayın. 



Bazı verileri değiştirin ve Kaydet' e tıklayın. Dizin sayfası açılır ve değiştirilen verileri görürsünüz. 

Silme sayfasını Güncelleştir 

StudentController.es' de, httpget Delete yöntemi için şablon kodu, Ayrıntılar ve düzenleme yöntemlerinde 
gördüğünüz gibi seçili öğrenci varlığını almak için singleOrDefaultAsync yöntemini kullanır. Ancak, Savechanges 
' a yapılan çağrı başarısız olduğunda özel bir hata iletisi uygulamak için, bu yönteme ve buna karşılık gelen 
görünüme bazı işlevler eklersiniz. 

Güncelleştirme ve oluşturma işlemleri için gördüğünüz gibi silme işlemleri için iki eylem yöntemi gerekir.GET 
isteğine yanıt olarak çağrılan yöntem, kullanıcıya silme işlemini onaylama veya iptal etme şansı veren bir 
görünüm görüntüler. Kullanıcı onu onayladığında, bir POST isteği oluşturulur. Bu durumda, HttpPost Delete 
yöntemi çağrılır ve bu yöntem aslında silme işlemini gerçekleştirir. 























Veritabanı güncelleştirilirken oluşabilecek hataları işlemek için HttpPost Delete yöntemine bir try-catch bloğu 
ekleyeceksiniz. Bir hata oluşursa, HttpPost Delete yöntemi bir hata oluştuğunu gösteren bir parametre geçirerek 
HttpGet Delete yöntemini çağırır. HttpGet Delete yöntemi daha sonra hata iletisiyle birlikte onay sayfasını 
yeniden görüntüler ve kullanıcıya iptal etmek veya yeniden denemek için bir fırsat verir. 

HttpGet Delete eylem yöntemini aşağıdaki kodla değiştirin, bu hata raporlamayı yönetir. 

public async Task<IActionResult> Delete(int? id, bool? saveChangesError = false) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var student = await _context.Students 
.AsNoTracking() 

.FirstOrDefaultAsync(m => m.ID == id); 
if (student == null) 

{ 

return NotFound(); 

} 

if (saveChangesError.GetValueOrDefault()) 

{ 

ViewData["ErrorMessage"] = 

"Delete failed. Try again., and if the problem persists " + 

"see your system administrator. 

} 

return View(student); 

} 

Bu kod, bir yöntemin değişiklikleri kaydetme hatasından sonra döndürülüp çağrılmadığını belirten isteğe bağlı 
bir parametresini kabul eder. HttpGet Delete yöntemi önceki bir hata olmadan çağrıldığında bu parametre 
false 'tur. Bir veritabanı güncelleştirme hatasına yanıt olarak HttpPost Delete yöntemi tarafından çağrıldığında, 
parametresi true olur ve görünüme bir hata mesajı geçirilir. 

HttpPost silme için ilk okuma yaklaşımı 

HttpPost Delete eylem yöntemini ( DeleteConfirmed adlı), gerçek silme işlemini gerçekleştiren ve tüm 
veritabanı güncelleştirme hatalarını yakalayan aşağıdaki kodla değiştirin. 









[HttpPost, ActionlMame( "Delete") ] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> DeleteConfirmed(int id) 

{ 

var student = await _context.Students.FindAsync(id); 
if (student == null) 

{ 

return RedirectToAction(nameof(Index)); 

} 

try 

{ 

_context.Students.Remove(student); 
await _context.SaveChangesAsync(); 
return RedirectToAction(nameof(Index)); 

} 

catch (DbUpdateException /* ex */) 

{ 

//Log the error (uncomment ex variable name and write a log.) 

return RedirectToAction(nameof(Delete), new { id = id, saveChangesError = true }); 

} 

} 

Bu kod seçili varlığı alır, ardından varlığın durumunu Deleted olarak ayarlamak için Remove yöntemini çağırır. 
@No__t-0 çağrıldığında, bir SQL DELETE komutu oluşturulur. 

HttpPost silme için Oluştur ve Ekle yaklaşımı 

Yüksek hacimli bir uygulamadaki performansı artırmak bir önceliktir, yalnızca birincil anahtar değerini 
kullanarak bir öğrenci varlığı oluşturarak ve ardından varlık durumunu Deleted olarak ayarlayarak gereksiz bir 
SQL sorgusundan kaçınabilirsiniz. Bu, Entity Framevvork varlığı silmek için ihtiyaç duymaktadır.(Bu kodu 
projenize yerleştirmeyin; bir alternatif göstermek de yeterlidir.) 

[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> DeleteConfirmed(int id) 

{ 

try 

{ 

Student studentToDelete = new Student() { ID = id }; 

_context.Entry(studentToDelete).State = EntityState.Deleted; 
await _context.SaveChangesAsync(); 
return RedirectToAction(nameof(Index)); 

} 

catch (DbUpdateException /* ex */) 

{ 

//Log the error (uncomment ex variable name and write a log.) 

return RedirectToAction(nameof(Delete), new { id = id, saveChangesError = true }); 

} 

} 


Varlığın de silinmesi gereken ilgili veriler varsa, veritabanında Cascade silmenin yapılandırıldığından emin olun. 
Varlık silme yaklaşımıyla EF, silinecek ilgili varlıkların olduğunu fark etmeyebilir. 

Silme görünümünü Güncelleştir 

Görüınümler/öğrenci/delete. cshtml' de, aşağıdaki örnekte gösterildiği gibi, H2 başlığı ve H3 başlığı arasına bir 
hata iletisi ekleyin: 








<h2>Delete</h2> 

<p class="text-danger">(5)ViewData["ErrorMessage"]</p> 
<hB>Are you sure you want to delete this?</h3> 


Uygulamayı çalıştırın, öğrenciler sekmesini seçin ve bir Delete köprüsüne tıklayın: 



Contoso University 


Delete 

Are you sure you want to 
delete this? 

Student 

LastName 

Alexander 

FirstMidName 

Carson 

EnrolImentDate 

9/2/2005 12:00:00 AM 


Delete | Back to List 



Sil'e tıklayın. Dizin sayfası, silinen öğrenci olmadan görüntülenir.(Eşzamanlılık öğreticisinde işlem içinde kodu 
işleme hatası hakkında bir örnek görürsünüz.) 

Veritabanı bağlantılarını kapat 

Bir veritabanı bağlantısının tuttuğu kaynakları boşaltmak için bağlam örneği, bununla işiniz bittiğinde en kısa 
sürede atılmalıdır. AS P.N ET Core yerleşik bağımlılık ekleme , sizin için bu görevi gerçekleştirir. 

Startup.es, DbContext SıNıFıNı ASP.NET Coredı kapsayıcısında sağlamak İçin adddbcontext genişletme 
yöntemini çağırın. Bu yöntem, hizmet ömrünü varsayılan olarak scoped olarak ayarlar, scoped , Web isteği 
yaşam süresi ile saatle çakışan bağlam nesnesi ömrünü gösterir ve Web isteğinin sonunda Dispose yöntemi 
otomatik olarak çağrılır. 

İşlemleri işle 

Entity Framevvork, varsayılan olarak işlemleri örtülü olarak uygular. Birden çok satır veya tabloda değişiklik 
yaptığınız ve sonra Savechanges 1 ı çağıran senaryolarda, Entity Framework otomatik olarak tüm 
değişikliklerinizin başarılı olduğundan veya tümünün başarısız olduğundan emin olur. Önce bazı değişiklikler 
yapıldıktan sonra bir hata oluşursa, bu değişiklikler otomatik olarak geri alınır. Daha fazla denetime ihtiyacınız 
olan senaryolar için—örneğin, işlem içinde Entity Framevvork dışında yapılan işlemleri eklemek istiyorsanız, bkz. 
işlemler. 

İzleme sorguları yok 

Bir veritabanı bağlamı tablo satırları aldığında ve bunları temsil eden varlık nesneleri oluşturduğunda, varsayılan 
















olarak, bellekteki varlıkların veritabanında bulunan verilerle eşitlenmiş olup olmadığını izler. Bellekteki veriler 
önbellek olarak davranır ve bir varlığı güncelleştirdiğinizde kullanılır. Bağlam örnekleri genellikle kısa süreli 
olduğundan (her istek için yeni bir tane oluşturulup bırakıldığı) ve bir varlığı okuyan bağlam genellikle bu varlık 
yeniden kullanılmadan önce atıldığından, bu önbelleğe alma işlemi bir Web uygulamasında genellikle 
gereksizdir. 

@No__t-0 yöntemini çağırarak bellekte varlık nesnelerinin izlenmesini devre dışı bırakabilirsiniz. Bunu yapmak 
isteyebileceğiniz tipik senaryolar şunlardır: 

• Bağlam ömrü boyunca herhangi bir varlığı güncelleştirmeniz gerekmez ve ayrı sorgular tarafından alınan 
varlıklarla birlikte gezinti özelliklerini otomatik olarak yüklemekiçin EF 'e ihtiyacınız yoktur. Bu koşullar 
genellikle denetleyicinin FlttpGet eylem yöntemlerinde karşılanır. 

• Büyük miktarda veri alan bir sorgu çalıştırıyorsunuz ve döndürülen verilerin yalnızca küçük bir kısmı 
güncelleştiriliyor. Büyük sorgu için izlemeyi devre dışı bırakmak ve daha sonra güncellenmesi gereken 
birkaç varlık için bir sorgu çalıştırmak daha verimli olabilir. 

• Bir varlığı güncelleştirmek için eklemek istiyorsunuz, ancak daha önce farklı bir amaç için aynı varlığı elde 
edersiniz. Varlık veritabanı bağlamı tarafından zaten izlenmekte olduğundan, değiştirmek istediğiniz 
varlığı iliştiremiyoruz. Bu durumu işlemenin bir yolu, önceki sorgudaki AsNoTracking öğesini çağırmanız 
olur. 

Daha fazla bilgi için bkz. izleme vs. 

Kodu edinin 

Tamamlanmış uygulamayı indirin veya görüntüleyin. 

Sonraki adımlar 

Bu öğreticide şunları yaptınız: 

• Ayrıntılar sayfası özelleştirildi 

• Oluşturma sayfası güncelleştirildi 

• Düzenleme sayfası güncelleştirildi 

• Silme sayfası güncelleştirildi 

• Kapalı veritabanı bağlantıları 

Sıralama, filtreleme ve sayfalama ekleyerek Dizin sayfasının işlevselliğini genişletmeyi öğrenmek için sonraki 
öğreticiye ilerleyin. 

Sonraki: sıralama, filtreleme ve sayfalama 



Öğretici: EF Core sıralama, filtreleme ve sayfalama- 
ASPNET MVC ekleme 

23.11.2019 • 21 minutes to read ı Edit Online 


Önceki öğreticide, öğrenci varlıkları için temel CRUD işlemleri için bir dizi Web sayfası uyguladık. Bu öğreticide, 
öğrenciler dizin sayfasına sıralama, filtreleme ve sayfalama işlevselliği ekleyeceksiniz. Ayrıca basit gruplandırma 
yapan bir sayfa oluşturacaksınız. 

Aşağıdaki çizimde, işiniz bittiğinde sayfanın nasıl görüneceği gösterilmektedir. S ütün başlıkları, kullanıcının 
sütuna göre sıralamak için tıkladığı bağlantılardır. Sütun başlığına tıklanması artan ve azalan sıralama düzeni 
arasında sürekli olarak geçiş yapar. 



Bu öğreticide şunları yaptınız: 

• Sütun sıralama bağlantıları Ekle 

• Arama kutusu ekleme 

• Öğrenciler dizinine sayfalama ekleme 

• Dizin yöntemine sayfalama ekleme 

• Sayfalama bağlantıları Ekle 

• Hakkında bir sayfa oluşturun 

Önkoşullar 

• CRUD İşlevlerini uygulama 

Sütun sıralama bağlantıları Ekle 

Öğrenci dizini sayfasına sıralama eklemek için, öğrenciler denetleyicisinin index yöntemini değiştirecek ve 












öğrenci dizini görünümüne kod ekleyeceksiniz. 


Dizin yöntemine sıralama İşlevi ekleme 

StudentsController.es' de index yöntemini aşağıdaki kodla değiştirin: 

public async Task<IActionResult> Index(string sortOrder) 

{ 

ViewData["NameSortParm"] = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 

ViewData["DateSortParm"] = sortOrder == "Date" ? "date_desc" : "Date"; 
var students = from s in _context.Students 
select s; 

switch (sortOrder) 

{ 

case "name_desc": 

students = students.OrderByDescending(s => s.LastName); 
break; 

case "Date": 

students = students.OrderBy(s => s.EnrollmentDate); 
break; 

case "date_desc": 

students = students.OrderByDescending(s => s.EnrollmentDate); 
break; 
default: 

students = students.OrderBy(s => s.LastName); 
break; 

} 

return View(await students.AsNoTrackingO.ToListAsync()); 

} 

Bu kod, URL 'deki sorgu dizesinden bir sortOrder parametresi alır. Sorgu dizesi değeri, ASP.NET Core MVC 
tarafından eylem yöntemine bir parametre olarak sağlanır. Parametresi, "Name" veya "Date" adlı bir dize, isteğe 
bağlı olarak bir alt çizgi ve azalan sıralama belirtmek için "dese" dizesi olacaktır. Varsayılan sıralama düzeni artan. 

Dizin sayfası ilk kez istendiğinde sorgu dizesi yoktur.Öğrenciler, son ada göre artan sırada görüntülenir, bu, 
switch deyimindeki karşı bir durum tarafından kurulduğu varsayılan değer olan addır. Kullanıcı bir sütun başlığı 
köprüsüne tıkladığında, sorgu dizesinde uygun sortOrder değeri sağlanır. 

iki viewData öğesi (Namesortpara ve Datesortpard), sütun başlığı köprülerini uygun sorgu dizesi değerleriyle 
yapılandırmak için görünüm tarafından kullanılır. 









public async Task<IActionResult> Index(string sortOrder) 

{ 

ViewData["NameSortParm"] = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 

ViewData["DateSor'tParm"] = sortOrder == "Date" ? "date_desc" : "Date"; 
var students = from s in _context.Students 
select s; 

switch (sortOrder) 

{ 

case "name_desc": 

students = students.OrderByDescending(s => s.LastName); 
break; 

case "Date": 

students = students.OrderBy(s => s.EnrollmentDate); 
break; 

case "date_desc": 

students = students.OrderByDescending(s => s.EnrollmentDate); 
break; 
default: 

students = students.OrderBy(s => s.LastName); 
break; 

} 

return View(await students.AsNoTrackingO.ToListAsync()); 

} 

Bunlar Üçlü ifadelerdir.ilki sortOrder parametresi null veya boş ise, Namesortparı 'nin "name_desc" olarak 
ayarlanması gerektiğini belirtir; Aksi takdirde, boş bir dizeye ayarlanmalıdır. Bu iki deyim, görünümün sütun 
başlığı köprülerini şu şekilde ayarlamaya olanak tanır: 


GEÇERLİ SIRALAMA DÜZENİ 

SON AD KÖPRÜSÜ 

TARİH KÖPRÜSÜ 

Artan son ad 

descending 

ascending 

Azalan son ad 

ascending 

ascending 

Artan Tarih 

ascending 

descending 

Azalan Tarih 

ascending 

ascending 


Yöntemi, sıralama yapılacak sütunu belirtmek için LINQ to Entities kullanır. Kod, Svvitch ifadesinden önce bir 

değişkeni oluşturur, Svvitch ifadesinde değiştirir ve switch deyimden sonra ToListAsync yöntemini 
ryable değişkenleri oluşturup değiştirirken veritabanına hiçbir sorgu gönderilmez. Sorgu, 
gibi bir yöntemi çağırarak ıçueryable nesnesini bir koleksiyona dönüştürene kadar yürütülmez. Bu 
kod return view ifadeye kadar Yürütülmeyen tek bir sorgu ile sonuçlanır. 

Bu kod çok sayıda sütunla ayrıntı alabilir. Bu serideki son öğretici , bir dize değişkeninde orderBy sütununun 
adını geçirmenize olanak sağlayan kodun nasıl yazılacağını gösterir. 

Öğrenci dizini görünümüne sütun başlığı köprüleri ekleme 

Görünümler/öğrerıciler/lndex. cshfm/içindeki kodu, sütun başlığı köprüleri eklemek için aşağıdaki kodla 
değiştirin. Değiştirilen çizgiler vurgulanır. 


IQueryable 
çağırır. iQue 
ToListAsync 
nedenle, bu 














@model IEnumerable<Contosollniversity .Models .Student> 

@{ 

ViewData["Title"] = "Index"; 

} 

<h2>Index</h2> 

<P> 

<a asp-action="Create">Create New</a> 

</p> 

<table class="table"> 

<thead> 

<tr> 

<th> 

<a asp-action="Index" asp-route- 

sortOrder="@ViewData["NameSortParm" ] ">@Html.DisplayNameFor(model => model. LastName)</a> 

</th> 

<th> 

@Html.DisplayNameFor(model => model.FirstMidName) 

</th> 

<th> 

<a asp-action="Index" asp-route- 

sortOrder="@ViewData["DateSortParm"]">@Html.DisplayNameFor(model => model.EnrollmentDate)</a> 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

(Şforeach (var item in Model) { 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.LastName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.FirstMidName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.EnrollmentDate) 

</td> 

<td> 

<a asp-action="Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-action="Details" asp-route-id="@item.ID">Details</a> | 

<a asp-action="Delete" asp-route-id="@item.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 

Bu kod, uygun sorgu dizesi değerleriyle köprüler ayarlamak için viewData özelliklerindeki bilgileri kullanır. 

Uygulamayı çalıştırın, öğrenciler sekmesini seçin ve sıralamanın çalıştığını doğrulamak İçin son ad ve kayıt 
tarihi sütun başlıklarına tıklayın. 
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LastName 

FirstMidName 

EnrolImentDate 



Alexander 

Carson 

9/2/2005 12:00:00 AM 
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Alonso 

Meredith 

9/1/2002 12:00:00 AM 

Edit | Details | 

Delete 

Anand 

Arturo 

9/1/2003 12:00:00 AM 

Edit | Details | 

Delete 

Barzdukas 

Gytis 

9/1/2002 12:00:00 AM 

Edit | Details | Delete 







Arama kutusu ekleme 

Öğrenciler dizin sayfasına filtre eklemek için, görünüme bir metin kutusu ve Gönder düğmesi ekleyeceksiniz ve 
index yönteminde ilgili değişiklikleri yapmanız gerekir. Metin kutusu, ilk adı ve soyadı alanlarını aramak için bir 
dize girmenizi sağlar. 

Dizin yöntemine filtreleme işlevi ekleme 

StudentsController.es' de index yöntemini aşağıdaki kodla değiştirin (değişiklikler vurgulanır). 

public async Task<IActionResult> Index(string sortOrder, string searchString) 

{ 

ViewData["NameSortParm"] = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 

ViewData["DateSortParm"] = sortOrder == "Date" ? "date_desc" : "Date"; 

ViewData["CurrentFilter"] = searchString; 

var students = from s in _context.Students 
select s; 

if (!String.IsNullOrEmpty(searchString)) 

{ 

students = students.Where(s => s. Lastl\lame.Contains(searchString) 

| s.FirstMidName.Contains(searchString)); 

} 

switch (sortOrder) 

{ 

case "name_desc": 

students = students.OrderByDescending(s => s.LastName); 
break; 

case "Date": 

students = students.OrderBy(s => s.EnrollmentDate); 
break; 

case "date_desc": 

students = students.OrderByDescending(s => s.EnrollmentDate); 
break; 
default: 

students = students.OrderBy(s => s.LastName); 
break; 

} 

return View(await students.AsNoTrackingO.ToListAsync()); 

} 












index yöntemine bir searchstring parametresi eklediniz. Arama dizesi değeri, dizin görünümüne ekleyeceğiniz 
bir metin kutusundan alınır. Ayrıca, yalnızca adı veya soyadı arama dizesini içeren öğrencileri seçen bir vvhere yan 
tümcesine LINQ deyimi de eklediniz. VVHERE yan tümcesini ekleyen deyimi, yalnızca aranacak bir değer varsa 
yürütülür. 


NOTE 

Burada where yöntemi bir ıçueryable nesnesi üzerinde arıyorsanız ve filtrenin sunucuda işlenmesi gerekir. Bazı 
senaryolarda, bellek içi bir koleksiyonda where yöntemini genişletme yöntemi olarak çağırma olabilirsiniz. (Örneğin, 
_context.students başvurusunu, bir Dbset EF yerine bir iEnumerable koleksiyonu döndüren bir depo yöntemine 
başvurduğu gibi) değiştirdiğinizi varsayın.) Sonuç normalde aynı olur, ancak bazı durumlarda farklı olabilir. 

Örneğin, contains yönteminin .NET Framevvork uygulanması, varsayılan olarak büyük/küçük harfe duyarlı bir 
karşılaştırma gerçekleştirir, ancak SQL Server' de SQL Server örneğinin harmanlama ayarı tarafından belirlenir. Bu ayar 
varsayılan olarak büyük/küçük harfe duyarsız olur. Testi açıkça büyük/küçük harfe duyarsız hale getirmek için ToUpper 
yöntemini çağırabilirsiniz: burada (s = > s. LastName. ToUpper 0 . Contains (searchstring. ToUpper 0) . Bu, kodu daha 
sonra bir ıçueryable nesnesi yerine iEnumerable koleksiyonu döndüren bir depoyu kullanacak şekilde değiştirirseniz 
sonuçların aynı kalmasını sağlar. (Bir iEnumerable koleksiyonunda contains yöntemini çağırdığınızda .NET Framevvork 
uygulamasını alırsınız; bunu bir ıçuenyable nesnesi üzerinde çağırdığınızda, veritabanı sağlayıcısı uygulamasını alırsınız.) 
Ancak, bu çözüm için bir performans cezası vardır. ToUpper kodu, TSQL SELECT ifadesinin VVHERE yan tümcesine bir işlev 
koyar. Bu, iyileştiricinin bir dizin kullanmasını engelleyecek. SQL 'in çoğu büyük küçük harfe duyarsız olarak yüklendiği için, 
büyük/küçük harfe duyarlı bir veri deposuna geçiş yapılıncaya kadar ToUpper koddan kaçınmak en iyisidir. 


Öğrenci dizini görünümüne arama kutusu ekleme 

Görünümler/öğrenci/lndex. cshtml'de, bir başlık, metin kutusu ve bir arama düğmesi oluşturmak için, açılan 
tablo etiketinden hemen önce vurgulanan kodu ekleyin. 

<P> 

<a asp-action="Create">Create New</a> 

</p> 

<form asp-action="Index" method="get"> 

<div class="form-actions no-color"> 

<P> 

Find by name: <input type="text" name="SearchString" value="@ViewData["currentFilter"]" /> 
<input type="submit" value="Search" class="btn btn-default" /> | 

<a asp-action="Index">Back to Full List</a> 

</p> 

</div> 

</form> 

<table class="table"> 

Bu kod, arama metin kutusu ve düğmesini eklemek için <form> Tag yardımcısını kullanır. Varsayılan olarak, 
<form> etiketi Yardımcısı, form verilerini bir GÖNDERİYLE gönderir, yani Parametreler, URL 'de sorgu dizeleri 
olarak değil, HTTP ileti gövdesinde geçirilir. HTTP GET belirttiğinizde, form verileri URL 'ye sorgu dizeleri olarak 
geçirilir ve bu da kullanıcıların URL 'ye yer işareti eklemesini sağlar. W3C yönergeleri, eylem bir güncelleştirme 
ile sonuçlanmazsa Al 1 ın kullanılması önerilir. 

Uygulamayı çalıştırın, öğrenciler sekmesini seçin, bir arama dizesi girin ve filtreleme 'nin çalıştığını doğrulamak 
için ara ' ya tıklayın. 
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URL 'nin arama dizesini içerdiğine dikkat edin. 

http://localhost:5813/Students?SearchString=an 

Bu sayfaya yer işareti eklerseniz, yer işaretini kullandığınızda filtrelenmiş listeyi alırsınız, form etiketine 
method="get" eklemek, sorgu dizesinin oluşturulmasına neden olur. 

Bu aşamada, bir sütun başlığı sıralama bağlantısını tıklatırsanız, arama kutusuna girdiğiniz filtre değerini 
kaybedersiniz. Sonraki bölümde bunu çözeceksiniz. 


Öğrenciler dizinine sayfalama ekleme 

Öğrenciler dizin sayfasına sayfalama eklemek için, skip ve Take deyimlerini kullanan bir PaginatedList 
sınıfını, tablodaki verileri her zaman almak yerine, sunucuda filtrelemek için oluşturacaksınız. Daha sonra index 
yönteminde ek değişiklikler yapar ve index görünümüne sayfalama düğmeleri eklersiniz. Aşağıdaki çizimde 
sayfalama düğmeleri gösterilmektedir. 











E3 lndex - Contoso Univen X 

+ 


X 

□ 

1 

<- 

localhost 5313/Student 

☆ — 

Contoso University 



— 

lndex 

Create New 





Find by name: 


Search 

| Back to Full List 

Last Name 

First Name 

Enrollment Date 


Alexander 

Carson 

9/1/2005 12:00:00 AM 

Edit | Details | Deiete 

Alonso 

Meredith 

9/1/2002 12:00:00 AM 

Edit | Details | Deiete 

Anand 

Arturo 

9/1/2003 12:00:00 AM 

Edit | Details | Deiete 

Previous 

Next 





_ 


, , r 



Proje klasöründe PaginatedList.es oluşturun ve ardından şablon kodunu aşağıdaki kodla değiştirin. 











using System; 

using System.Collections.Generic; 
using System.Linq; 
using System.Threading.Tasks; 
using Microsoft.EntityFrameworkCore; 

namespace ContosoUniversity 

{ 

public class PaginatedList<T> : List<T> 

{ 

public int Pagelndex { get; private set; } 
public int TotalPages { get; private set; } 

public PaginatedList(List<T> items, int count, int pagelndex, int pageSize) 

{ 

Pagelndex = pagelndex; 

TotalPages = (int)Math.Ceiling(count / (double)pageSize); 
this.AddRange(items); 

} 

public bool HasPreviousPage 

{ 

get 

{ 

return (Pagelndex > 1); 

} 

} 

public bool HasNextPage 

{ 

get 

{ 

return (Pagelndex < TotalPages); 

} 

} 

public static async Task<PaginatedList<T>> CreateAsync(IQueryable<T> source, int pagelndex, int 
pageSize) 

{ 

var count = await source.CountAsync(); 

var items = await source.Skip((pagelndex - 1) * pageSize).Take(pageSize).ToListAsync(); 
return new PaginatedList<T>(items, count, pagelndex, pageSize); 

} 

} 

} 

Bu koddaki createAsync yöntemi sayfa boyutunu ve sayfa numarasını alır ve uygun skip ve Take deyimlerini 
iQueryabie uygular. iQueryabie"ToListAsync çağrıldığında, yalnızca istenen sayfayı içeren bir liste döndürür. 
HasPreviousPage ve HasNextPage özellikleri, önceki ve sonraki sayfalama düğmelerini etkinleştirmek veya 
devre dışı bırakmak için kullanılabilir. 

Oluşturucular zaman uyumsuz kod çalıştıramadığından PaginatedList<T> nesnesini oluşturmak için bir 
Oluşturucu yerine bir CreateAsync yöntemi kullanılır. 

Dizin yöntemine sayfalama ekleme 

StudentsController.es' de index yöntemini aşağıdaki kodla değiştirin. 







public async Task<IActionResult> Index( 
string sortOrder, 
string currentFilter, 
stning searchString, 
int? pageNumben) 

{ 

ViewData["CurrentSort"] = sortOrder; 

ViewData["NameSortParm"] = String.IsNullOrEmpty(sortOrder) ? "name_desc" : 
ViewData["DateSontParm"] = sortOrder == "Date" ? "date_desc" : "Date"; 

if (searchString != null) 

{ 

pageNumben = 1; 

} 

else 

{ 

seanchStning = currentFilter; 

} 

ViewData["CunnentFilten"] = seanchStning; 

van students = fnom s in _context.Students 
select s; 

if (!Stning.IsNullOnEmpty(seanchStning)) 

{ 

students = students.Whene(s => s.LastName.Contains(seanchStning) 

| s.FinstMidName.Contains(seanchStning)); 

} 

switch (sontOnden) 

{ 

case "name_desc": 

students = students.OndenByDescending(s => s.LastName); 
break; 

case "Date": 

students = students.OndenBy(s => s.EnrollmentDate); 
bneak; 

case "date_desc": 

students = students.OndenByDescending(s => s.EnnollmentDate); 
bneak; 
default: 

students = students.OndenBy(s => s.LastName); 
bneak; 

} 

int pageSize = 3; 

netunn View(await PaginatedList<Student>.CneateAsync(students.AsNoTnacking(), pageNumben ?? 1 , 
pageSize)); 

} 


Bu kod, bir sayfa numarası parametresi, geçerli bir sıralama düzeni parametresi ve Yöntem imzasına geçerli bir 
filtre parametresi ekler. 

public async Task<IActionResult> Index( 
stning sontOnden, 
stning cunnentFilten, 
stning seanchStning, 
int? pageNumben) 


Sayfa ilk kez görüntülenirken veya Kullanıcı bir sayfalama veya sıralama bağlantısına tıklamamışsa, tüm 
parametreler null olur. Bir sayfalama bağlantısına tıklandıysanız, sayfa değişkeni görüntülenecek sayfa numarasını 
içerir. 

CurrentSort adlı viewData öğesi, sayfalama bağlantılarına dahil edilmesi gerektiğinden, bu sıralama düzeni 





geçerli sıralama düzeni ile birlikte sağlar. 

CurrentFilter adlı viewData öğesi, geçerli filtre dizesiyle görünüm sağlar. Bu değer, disk belleği sırasında filtre 
ayarlarını korumak için disk belleği bağlantılarına dahil olmalıdır ve sayfa yeniden görüntülenirken metin 
kutusuna geri yüklenmesi gerekir. 

Arama dizesi sayfalama sırasında değiştirilmişse, yeni filtre farklı verilerin görüntülenmesini sağladığından 
sayfanın 1 olarak sıfırlanması gerekir. Metin kutusuna bir değer girildiğinde ve Gönder düğmesine basıldığında 
arama dizesi değişir. Bu durumda searchstring parametresi null değildir. 

if (searchstring != null) 

{ 

pagelMumber = 1 ; 

} 

else 

{ 

searchstring = CurrentFilter; 

} 

index yönteminin sonunda, PaginatedList.createAsync yöntemi öğrenci sorgusunu, sayfalama destekleyen bir 
koleksiyon türünde tek bir öğrenciye dönüştürür. Bu tek bir öğrenci sayfası daha sonra görünüme geçirilir. 

return View(await PaginatedList<Student>.CreateAsync(students.AsNoTracking(), pageNumber ?? 1 , pageSize)); 

PaginatedList.createAsync yöntemi bir sayfa numarası alır, iki soru işareti, null birleşim işlecini temsil eder.Null 
birleşim işleci, Nullable bir tür için varsayılan değeri tanımlar; (pageNumber ?? i) ifadesi bir değere sahipse 
pageNumber değerini döndürür veya pageNumber null ise 1 döndürür. 

Sayfalama bağlantıları Ekle 

Görünümler/öğrerıciler/lndex. cshtml'de, mevcut kodu aşağıdaki kodla değiştirin. Değişiklikler vurgulanır. 

@model PaginatedListcContosoUniversity.Models.Student> 

@{ 

ViewData["Title"] = "Index"; 

} 

<h2>Index</h2> 

<P> 

<a asp-action="Create">Create New</a> 

</p> 

<form asp-action="Index" method="get"> 

<div class="form-actions no-color"> 

<p> 

Find by name: <input type="text" name="SearchString" value="@ViewData["CurrentFilter"]" /> 
«cinput type="submit" value="Search" class="btn btn-default" /> | 

<a asp-action="Index">Back to Full List</a> 

</p> 

</div> 

</form> 

<table class="table"> 

<thead> 

<tr> 

<th> 

<a asp-action="Index" asp-route-sortOrder="@ViewData["NameSortParm"]" asp-route- 
currentFilter="@ViewData["CurrentFilter"]">Last Name</a> 


^/ths 









<th> 

First Name 
</th> 

<th> 

<a asp-action="Index" asp-route-sortOrder="@ViewData["DateSortParm"]" asp-route- 
currentFilter="@ViewData["CurrentFilter"]">Enrollment Date</a> 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.LastName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item. FirstMidName) 

</td> 

<td> 

@Fltml.DisplayFor(modelItem => item. EnrollmentDate) 

</td> 

<td> 

<a asp-action="Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-action="Details" asp-route-id="@item.ID">Details</a> | 

<a asp-action="Delete" asp-route-id="@item.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 

var prevDisabled = !Model.HasPreviousPage ? "disabled" : 
var nextDisabled = !Model.HasNextPage ? "disabled" : 

} 

<a asp-action="Index" 

asp-route-sortOrder="@ViewData["CurrentSort"]" 
asp-route-pageNumber="@(Model.PageIndex - 1)" 
asp-route-currentFilter="@ViewData["CurrentFilter"]" 
class="btn btn-default @prevDisabled"> 

Previous 

</a> 

<a asp-action="Index" 

asp-route-sortOrder="@ViewData["CurrentSort"]" 
asp-route-pageNumber="@(Model.PageIndex + 1)" 
asp-route-currentFilter="@ViewData["CurrentFilter"]" 
class="btn btn-default @nextDisabled"> 

Next 

</a> 

Sayfanın üst kısmındaki @modei ifade, görünümün artık List<T> nesnesi yerine PaginatedList<T> bir nesne 
aldığından emin olarak belirtir. 

Sütun üst bilgisi bağlantıları, kullanıcının filtre sonuçları içinde sıralama yapabilmesi için geçerli arama dizesini 
denetleyiciye geçirmek için sorgu dizesini kullanır: 

<a asp-action="Index" asp-route-sortOrder="@ViewData["DateSortParm"]" asp-route-currentFilter 
="@ViewData["CurrentFilter"]">Enrollment Date</a> 


Sayfalama düğmeleri etiket yardımcıları tarafından görüntülenir: 






<a asp-action="Index" 

asp-route-sortOrder="@ViewData["CurrentSort" ]" 
asp-route-pageNumber="@(Model.PageIndex - 1)" 
asp-route-currentFilter="@ViewData["CurrentFilter"]" 
class="btn btn-default @prevDisabled"> 

Pnevious 

</a> 

Uygulamayı çalıştırın ve öğrenciler sayfasına gidin. 



Disk belleğinin çalıştığından emin olmak için farklı sıralama emirlerindeki disk belleği bağlantılarına tıklayın. 
Daha sonra bir arama dizesi girin ve sayfalama ve filtreleme ile doğru şekilde çalıştığını doğrulamak için 
sayfalama işlemi yeniden deneyin. 

Hakkında bir sayfa oluşturun 

Contoso Üniversitesi web sitesinin hakkında sayfasında, her bir kayıt tarihi için kaç öğrenciye kaydolduğunu 
görüntüleyeceksiniz. Bu, gruplar üzerinde gruplandırma ve basit hesaplamalar gerektirir. Bunu gerçekleştirmek 
için aşağıdakileri yapmanız gerekir: 

• Görünüme geçirmeniz gereken veriler için bir görünüm modeli sınıfı oluşturun. 

• Giriş denetleyicisinde hakkında yöntemini oluşturun. 

• Hakkında görünümünü oluşturun. 

Görünüm modeli oluşturma 

Modeller klasöründe bir SchoolVievvModels klasörü oluşturun. 

Yeni klasörde, EnrollmentDateGroup.es bir sınıf dosyası ekleyin ve şablon kodunu şu kodla değiştirin: 














using System; 

using System.ComponentModel.DataAnnotations; 

namespace Contosollniversity.Models.SchoolViewModels 

{ 

public class EnrollmentDateGroup 

{ 

[DataType(DataType.Date)] 

public DateTime? EnrollmentDate { get; set; } 
public int StudentCount { get; set; } 

} 

} 


Ana denetleyiciyi değiştirme 

HomeController.es' de, aşağıdaki using deyimlerini dosyanın en üstüne ekleyin: 

using Microsoft.EntityFrameworkCore; 
using ContosoUniversity.Data; 

using Contosollniversity .Models .SchoolViewModels; 


Sınıf için açma küme ayracından hemen sonra veritabanı bağlamı için bir sınıf değişkeni ekleyin ve ASP.N ET 
Core Dİ 'den bağlamın bir örneğini alın: 

public class HomeController : Contnoller 

{ 

private readonly SchoolContext _context; 

public HomeController(SchoolContext context) 

{ 

_context = context; 

} 

Aşağıdaki kodla bir About yöntemi ekleyin: 

public async Task<ActionResult> About() 

{ 

IQueryable<EnrollmentDateGroup> data = 
from student in _context.Students 

group student by student.EnrollmentDate into dateGroup 
select new EnrollmentDateGroup() 

{ 

EnrollmentDate = dateGroup.Key, 

StudentCount = dateGroup.Count() 

}; 

return View(await data.AsNoTracking().ToListAsync()); 

} 


LINQ deyimleri, öğrenci varlıklarını kayıt tarihine göre gruplandırır, her bir gruptaki varlıkların sayısını hesaplar 
ve sonuçları bir EnroiimentDateGroup View model nesneleri koleksiyonunda depolar. 

Hakkında görünüm oluştur 

Aşağıdaki kodla bir Görünümler/Home/about. cshtml dosyası ekleyin: 








@model IEnumerable<ContosoUniversity.Models.SchoolViewModels.EnrollmentDateGroup> 
@{ 

ViewData["Title"] = "Student Body Statistics"; 

} 

<h2>Student Body Statistics</h2> 

<table> 

<tn> 

<th> 

Ennollment Date 
</th> 

<th> 

Students 

</th> 

</tr> 

@foreach (var item in Model) 

{ 

<tn> 

<td> 

@Html.DisplayFor(modelItem => item.EnrollmentDate) 

</td> 

<td> 

@item.StudentCount 

</td> 

</tr> 

} 

</table> 


Uygulamayı çalıştırın ve hakkında sayfasına gidin. Her kayıt tarihi için öğrenci sayısı bir tabloda görüntülenir. 

Kodu alın 

Tamamlanmış uygulamayı indirin veya görüntüleyin. 

Sonraki adımlar 

Bu öğreticide şunları yaptınız: 

• Sütun sıralama bağlantıları eklendi 

• Arama kutusu eklendi 

• Öğrenciler dizinine sayfalama eklendi 

• Dizin oluşturma yöntemine sayfalama eklendi 

• Sayfalama bağlantıları eklendi 

• Hakkında bir sayfa oluşturuldu 

Geçiş kullanarak veri modeli değişikliklerini nasıl işleyebileceğinizi öğrenmek için sonraki öğreticiye ilerleyin. 
Sonraki: veri modeli değişikliklerini İşle 



Öğretici: EF Core ile geçiş özelliğini kullanma- 
ASPNET MVC 
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Bu öğreticide, veri modeli değişikliklerini yönetmek için EF Core geçişleri özelliğini kullanmaya 
başlayabilirsiniz. Sonraki öğreticilerde, veri modelini değiştirirken daha fazla geçiş ekleyeceksiniz. 

Bu öğreticide şunları yaptınız: 

• Geçişler hakkında bilgi edinin 

• Bağlantı dizesini değiştirme 

• ilk geçiş oluşturma 

• Yukarı ve aşağı yöntemleri inceleyin 

• Veri modeli anlık görüntüsü hakkında bilgi edinin 

• Geçişi Uygula 

Önkoşullar 

• Sıralama, filtreleme ve sayfalama 

Geçişler hakkında 

Yeni bir uygulama geliştirirken, veri modeliniz sıklıkla değişir ve model her değiştiğinde veritabanıyla 
eşitlenmemiş olur. Mevcut değilse veritabanını oluşturmak için Entity Framevvork yapılandırarak bu 
öğreticileri başlatmış olursunuz. Veri modelini her değiştirdiğinizde (varlık sınıfları ekleyin, kaldırın veya 
değiştirin ya da DbContext sınıfınızı değiştirin); veritabanını silebilir ve EF, modelle eşleşen yeni bir tane 
oluşturur ve test verileriyle birlikte olur. 

Veritabanını veri modeliyle eşitlenmiş halde tutma yöntemi, uygulamayı üretime dağıtana kadar iyi çalışır. 
Uygulama üretimde çalışırken, genellikle tutmak istediğiniz verileri saklar ve yeni sütun ekleme gibi her 
değişiklik yaptığınızda her şeyi kaybetmek istemezsiniz. EF Core geçişleri özelliği, yeni bir veritabanı 
oluşturmak yerine EF 'in veritabanı şemasını güncelleştirmesine olanak sağlayarak bu sorunu çözer. 

Geçişlerle çalışmak için Paket Yöneticisi konsolu 'nu (PMC) veya komut satırı ARABİRİMİNİ (CLI) 
kullanabilirsiniz. Bu öğreticiler CLı komutlarının nasıl kullanılacağını göstermektedir.PMC hakkındaki 
bilgiler Bu öğreticinin sonunda. 

Bağlantı dizesini değiştirme 

AppSettings. JSON dosyasında, bağlantı dizesindeki veritabanının adını ContosoUniversity2 veya 
kullandığınız bilgisayarda kullanmadığınız başka bir ad olarak değiştirin. 

{ 

"ConnectionStrings": { 

"DefaultConnection": "Server= 

(localdb)\\mssqllocaldb;Database=ContosoUniversity2;Trusted_Connection=True;MultipleActiveResultSets=t 

nue" 

L 

Bu değişiklik projeyi ilk geçişin yeni bir veritabanı oluşturacak şekilde ayarlar. Bu, geçişleri kullanmaya 





başlamak için gerekli değildir, ancak daha sonra iyi bir fikir olduğunu göreceksiniz. 


NOTE 

Veritabanı adını değiştirmeye alternatif olarak, veritabanını silebilirsiniz. SQL Server Nesne Gezgini (ssox) veya 
database drop CLI komutunu kullanın: 

dotnet ef database drop 

Aşağıdaki bölümde CLı komutlarının nasıl çalıştırılacağı açıklanmaktadır. 


İlk geçiş oluşturma 

Değişikliklerinizi kaydedin ve projeyi derleyin. Sonra bir komut penceresi açın ve proje klasörüne gidin. 
Bunu yapmanın hızlı bir yolu aşağıda verilmiştir: 


• Çözüm Gezgini' de projeye sağ tıklayın ve bağlam menüsünden klasörü dosya Gezgini ’nde aç 1 
ı seçin. 
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Komut penceresine aşağıdaki komutu girin: 































dotnet ef migrations add InitialCreate 


Komut penceresinde aşağıdakine benzer bir çıktı görürsünüz: 

info: Microsoft.EntityFrameworkCore.Infrastructure[10403] 

Entity Framework Core 2.2.0-rtm-35687 initialized 'SchoolContext' using provider 
'Microsoft.EntityFrameworkCore.SqlServer' with options: None 
Done. To undo this actiom use 'ef migrations remove' 


NOTE 

"DotNet-EF" komutuyla eşleşen yürütülebilir dosya bulunamadıhata iletisi görürseniz, sorun giderme konusunda 
yardım için Bu blog gönderisine bakın. 


Bir hata iletisi görürseniz "dosyaya erişilemiyor... ContosoUniversity. dil başka bir işlem tarafından 
kullanıldığı için. ", Windows sistem tepsisinde MS Express simgesini bulun ve sağ tıklayın, sonra da 

contosouniversity > siteyi durdur 1 a tıklayın. 

Yukarı ve aşağı yöntemleri inceleyin 

migrations add komutunu çalıştırdığınızda EF, veritabanını sıfırdan oluşturacak kodu oluşturdu. Bu kod, 
_lnitialCreate. cs ><zaman damgasıadU dosyada geçişler klasöründedir. InitialCreate sınıfının up 
yöntemi, veri modeli varlık kümelerine karşılık gelen veritabanı tablolarını oluşturur ve aşağıdaki örnekte 
gösterildiği gibi Down yöntemi onları siler. 

public partial class InitialCreate : Migration 

{ 

protected override void Up(MigrationBuilder migrationBuilder) 

{ 

migrationBuilder.CreateTable( 
name: "Course", 
columns: table => new 
{ 

CourselD = table.Column<int>(nullable: false), 

Credits = table.Column<int>(nullable: false), 

Title = table.Column<string>(nullable: true) 

}, 

constraints: table => 

{ 

table.PrimaryKey("PK_Course", x => x.CourselD); 

}); 

// Additional code not shown 

} 

protected override void Down(MigrationBuilder migrationBuilder) 

{ 

migrationBuilder.DropTable( 
name: "Enrollment"); 

// Additional code not shown 

} 

} 

Geçişler, bir geçiş için veri modeli değişikliklerini uygulamak üzere up yöntemini çağırır. Güncelleştirmeyi 
geri almak için bir komut girdiğinizde, geçişler Down yöntemini çağırır. 


Bu kod, migrations add InitialCreate komutunu girdiğinizde oluşturulan ilk geçişe yöneliktir. Geçiş adı 














parametresi (örnekteki "ınitialcreate") dosya adı için kullanılır ve istediğiniz her şey olabilir. Geçiş sırasında 
nelerin yapıldığını özetleyen bir sözcük veya tümcecik seçmek en iyisidir. Örneğin, "AddDepartmentTable" 
adlı bir geçişe daha sonra ad yazabilirsiniz. 

Veritabanı zaten mevcut olduğunda ilk geçişi oluşturduysanız veritabanı oluşturma kodu oluşturulur, ancak 
veritabanı veri modeliyle zaten eşleştiğinden çalıştırması gerekmez. Uygulamayı, veritabanının mevcut 
olmadığı başka bir ortama dağıttığınızda, bu kod veritabanınızı oluşturmak için çalışır, bu nedenle ilk önce 
test etmek iyi bir fikirdir. Bu nedenle, bağlantı dizesinde veritabanının adını daha önce değiştirmiş 
olursunuz, böylece geçişler sıfırdan yeni bir tane oluşturabilir. 

Veri modeli anlık görüntüsü 

Geçişler, geçiş/SchoolContextModelSnapshot. csiçinde geçerli veritabanı şemasının bir arıUk görüntüsünü 
oluşturur. Bir geçiş eklediğinizde EF, veri modeli Snapshot dosyası ile karşılaştırılarak nelerin 
değiştirildiğini belirler. 

Bir geçişi silerken DotNet EF geçişleri kaldır komutunu kullanın, dotnet ef migrations remove geçişi siler 
ve anlık görüntünün doğru şekilde sıfırlanmasını sağlar. 

Anlık görüntü dosyasının nasıl kullanıldığı hakkında daha fazla bilgi için bkz. Takım ortamlarında EF Core 
geçişleri . 

Geçişi Uygula 

Komut penceresinde, veritabanı ve tabloları oluşturmak için aşağıdaki komutu girin. 

dotnet ef database update 

Komutun çıktısı, veritabanının ayarlandığı SQL komutlarının günlüklerini görmeniz dışında 
migrations add komutuna benzerdir. Günlüklerin çoğu aşağıdaki örnek çıktıda atlanır.Günlük iletilerinde 
bu ayrıntı düzeyini görmemeyi tercih ediyorsanız, appSettings 'de günlük düzeyini değiştirebilirsiniz. 
Development. JSON dosyası. Daha fazla bilgi için bkz. .N ET Core ve ASP.NET Core oturum açma. 







info: Microsoft.EntityFrameworkCore.Infrastructure[10403] 

Entity Framework Core 2.2.0-rtm-35687 initialized 'SchoolContext' using provider 
'Microsoft.EntityFrameworkCore.SqlServer' with options: None 
info: Microsoft.EntityFrameworkCore.Database.Command[20101] 

Executed DbCommand (274ms) [Parameters =[], CommandType='Text ', CommandTimeout='60'] 

CREATE DATABASE [Contosollniversity2]; 
info: Microsoft.EntityFrameworkCore.Database.Command[20101] 

Executed DbCommand (60ms) [Parameters =[], CommandType='Text ', CommandTimeout='60'] 

IF SERVERPROPERTY('EngineEdition') o 5 
BEGIN 

ALTER DATABASE [ContosoUniversity2] SET READ_COMMITTED_SNAPSHOT ON; 

END; 

info: Microsoft.EntityFrameworkCore.Database.Command[20101] 

Executed DbCommand (15ms) [Parameters =[], CommandType='Text ', CommandTimeout='30'] 

CREATE TABLE [_EFMigrationsHistory] ( 

[Migrationld] nvarchar(150) NOT NULL, 

[ProductVersion] nvarchar(32) NOT NULL, 

CONSTRAINT [PK_EFMİgrationsFIistory] PRIMARY KEY ([Migrationld]) 

); 

<logs omitted for brevity> 

info: Microsoft.EntityFrameworkCore.Database.Command[20101] 

Executed DbCommand (3ms) [Parameters =[], CommandType='Text ', CommandTimeout='30'] 

INSERT INTO [_EFMİgrationsFIistory] ([Migrationld ], [ProductVersion]) 

VALUES (N'20190327172701_InitialCreate ', N'2.2.0-rtm-35687'); 

Done. 

ilk öğreticide yaptığınız gibi veritabanını incelemek için SQL Server Nesne Gezgini kullanın. Hangi 
geçişlerin veritabanına uygulandığını izleyen bir __EFMİgrationsHistory tablosunun eklenmesini fark 
edeceksiniz. Bu tablodaki verileri görüntüleyin ve ilk geçiş için bir satır görürsünüz. (Önceki CLı çıkış 
örneğinde son oturum, bu satırı oluşturan INSERT ifadesini gösterir.) 

Her şeyin daha önce olduğu gibi çalıştığını doğrulamak için uygulamayı çalıştırın. 



CLı ve PMC karşılaştırması 













Geçişleri yönetmek için EF araçları, .N ET Core CLI komutlardan veya Visual Studio Paket Yöneticisi 
konsolu (PMC) penceresindeki PovverShell cmdlet 'lerinde bulunabilir.Bu öğreticide, CLı ’nın nasıl 
kullanılacağı gösterilmektedir, ancak isterseniz PMC 'yi kullanabilirsiniz. 

PMC komutlarına yönelik EF komutları Microsoft. EntityFramevvorkCore. Tools paketidir. Bu paket 
Microsoft. AspNetCore. app metapackageiçinde bulunur, bu nedenle uygulamanızın 
Microsoft.AspNetcore.App için bir paket başvurusu varsa bir paket başvurusu eklemeniz gerekmez. 

csproj dosyasını düzenleyerek CLI için yüklediğiniz paket ile aynı değildir. Bu adın adı, 
biten CLı paketi adından farklı olarak Tools biter. 

CLı komutları hakkında daha fazla bilgi için bkz. .NET Core CLI. 

PMC komutları hakkında daha fazla bilgi için bkz. Paket Yöneticisi Konsolu (Visual Studio). 

Kodu alın 

Tamamlanmış uygulamayı indirin veya görüntüleyin. 

Sonraki adım 

Bu öğreticide şunları yaptınız: 

• Geçişler hakkında öğrenildi 

• NuGet geçiş paketleri hakkında bilgi edinildi 

• Bağlantı dizesi değiştirildi 

• ilk geçiş oluşturuldu 

• Yukarı ve aşağı yöntemleri İnceleme 

• Veri modeli anlık görüntüsü hakkında bilgi edinildi 

• Geçiş uygulandı 

Veri modelini genişletme hakkında daha gelişmiş konulara bakmak için sonraki öğreticiye ilerleyin. Ek 
geçişler oluşturma ve uygulama gibi. 


Önemli: Bu,. 

Tools.DotNet 


Ek geçişler oluşturma ve uygulama 




Öğretici: EF Core ile karmaşık veri modeli 
oluşturma-ASRNET MVC 
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Önceki öğreticilerde, üç varlıktan oluşan basit bir veri modeliyle çalıştık. Bu öğreticide, daha fazla varlık ve ilişki 
ekleyeceksiniz ve biçimlendirme, doğrulama ve veritabanı eşleme kurallarını belirterek veri modelini 
özelleştireceksiniz. 

işiniz bittiğinde, varlık sınıfları aşağıdaki çizimde gösterilen tamamlanmış veri modelini oluşturacak: 
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Bu öğreticide şunları yaptınız: 

• Veri modelini özelleştirme 

• Öğrenci varlığında değişiklik yap 

• Eğitmen varlığı oluşturma 

• OfficeAssignment varlığı oluştur 

• Kurs varlığını değiştirme 










































• Departman varlığı oluştur 

• Kayıt varlığını değiştirme 

• Veritabanı bağlamını güncelleştirme 

• Test verileriyle çekirdek veritabanı 

• Geçiş Ekle 

• Bağlantı dizesini değiştirme 

• Veritabanını güncelleştirme 

Önkoşullar 

• EF Core geçişleri kullanma 

Veri modelini özelleştirme 

Bu bölümde, biçimlendirme, doğrulama ve veritabanı eşleme kurallarını belirten öznitelikleri kullanarak veri 
modelini nasıl özelleştireceğinizi göreceksiniz. Ardından, aşağıdaki bölümlerde, zaten oluşturduğunuz sınıflara 
öznitelikler ekleyerek ve modeldeki kalan varlık türleri için yeni sınıflar oluşturarak tüm okul veri modelini 
oluşturacaksınız. 

DataType özniteliği 

Öğrenci kayıt tarihleri için tüm Web sayfaları Şu anda tarihle birlikte görüntülenir, ancak bu alan için tüm 
önemli bir tarih olması gerekir. Veri ek açıklaması özniteliklerini kullanarak, verileri gösteren her görünümde 
görüntü biçimini giderecek bir kod değişikliği yapabilirsiniz. Bunun nasıl yapılacağını gösteren bir örnek 
görmek için, student sınıfındaki EnroiimentDate özelliğine bir öznitelik ekleyeceksiniz. 

Modeller/öğrenci, cs' de, System.componentModei.DataAnnotations ad alanı için using bir ifade ekleyin ve 
aşağıdaki örnekte gösterildiği gibi EnroiimentDate özelliğine DataType ve DisplayFormat özniteliklerini ekleyin: 

using System; 

using System.Collections.Genenic; 

using System.ComponentModel.DataAnnotations; 

namespace ContosoUniversity.Models 
{ 

public class Student 
{ 

public int ID { get; set; } 

public stning LastName { get; set; } 

public stning FirstMidName { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{Öıyyyy-MM-dd}", ApplyFormatlnEditMode = true)] 
public DateTime EnrollmentDate { get; set; } 

public ICollection<Ennollment> Enrollments { get; set; } 

} 

} 

DataType özniteliği, veritabanı iç türünden daha özel bir veri türü belirtmek için kullanılır. Bu durumda, tarihi ve 
saati değil yalnızca tarihi izlemek istiyoruz. DataType numaralandırması, tarih, saat, PhoneNumber, para birimi, 
Emaadresi ve daha fazlası gibi birçok veri türü sağlar. DataType özniteliği Ayrıca uygulamanın türe özgü 
özellikleri otomatik olarak sağlamasını da sağlayabilir. Örneğin, DataType.EmailAddress için mailto: bir bağlantı 
oluşturulabilir ve HTML5 'i destekleyen tarayıcılarda DataType.Date için bir tarih seçici sağlaneklenebilir. 
DataType özniteliği HTML 5 tarayıcıların anlayabilmesi için HTML 5 data- (bir veri Dash) öznitelikleri yayar. 
DataType öznitelikleri herhangi bir doğrulama sağlamaz. 

DataType.Date görüntülenen tarihin biçimini belirtmiyor. Varsayılan olarak, veri alanı sunucunun Culturelnfo 



















öğesine göre varsayılan biçimlere göre görüntülenir. 


DisplayFormat özniteliği, açıkça tarih biçimini belirtmek için kullanılır: 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}"j ApplyFormatlnEditMode = true)] 

AppiyFormatinEditMode ayarı, bir metin kutusunda değer görüntülenmek üzere görüntülendiğinde 
biçimlendirmenin de uygulanacağını belirtir. (Bazı alanlar için bunu istemiyor olabilirsiniz; örneğin, para birimi 
değerleri için metin kutusundaki para birimi sembolünü düzenlemenin değiştirilmesini istemeyebilirsiniz.) 

DisplayFormat özniteliğini kendisi kullanabilirsiniz, ancak DataType özniteliğini de kullanmak genellikle iyi bir 
fikirdir. DataType özniteliği, verilerin semantiğini bir ekranda nasıl işleneceğini değil, DisplayFormat ile elde 
olmadığınız avantajları sağlar: 

• Tarayıcı HTML5 özelliklerini etkinleştirebilir (örneğin, bir Takvim denetimini, yerel ayara uygun para 
birimi sembolünü, e-posta bağlantılarını, bazı istemci tarafı giriş doğrulamasını vb. göstermek için). 

• Varsayılan olarak tarayıcı, verileri yerel ayarınızı temel alarak doğru biçimi kullanarak işleyebilir. 


Daha fazla bilgi için bkz. giriş > etiketi Yardımcısı belgeleri<. 

Uygulamayı çalıştırın, öğrenciler dizin sayfasına gidin ve kayıt tarihleri için saatlerin artık gösterilmediğine 
dikkat edin. Aynı değer öğrenci modelini kullanan herhangi bir görünüm için de geçerli olacaktır. 


1 E3 lndex - Contoso Univer; X + 

□ X 1 

<- 

(J) localhost 5313/Student ^ 

Contoso University 

— 

lndex 



Create New 



Find by name: 


Search | Back to Full List 


Last Name 

First Name 

Enrollment Date 


Alexander 

Carson 

2005-09-01 

Edit | Details | Delete 

Alonso 

Meredith 

2002-09-01 

Edit | Details | Delete 

Anand 

Arturo 

2003-09-01 

Edit | Details | Delete 

Previous 

Next 




StringLength özniteliği 

Ayrıca, öznitelikleri kullanarak veri doğrulama kuralları ve doğrulama hata iletileri de belirtebilirsiniz. 
StringLength özniteliği, veritabanında en fazla uzunluğu ayarlar ve AS P.N ET Core MVC için istemci tarafı ve 
sunucu tarafı doğrulaması sağlar. Bu öznitelikte en küçük dize uzunluğunu da belirtebilirsiniz, ancak en küçük 
değerin veritabanı şemasında hiçbir etkisi yoktur. 

Kullanıcıların bir ad için 50 1 den fazla karakter girmemesini istediğinizi varsayalım. Bu kısıtlamayı eklemek için, 
aşağıdaki örnekte gösterildiği gibi, LastName ve FirstMidName özelliklerine StringLength öznitelikleri ekleyin: 




















using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

namespace Contosollniversity .Models 

{ 

public class Student 

{ 

public int ID { get; set; } 

[StringLength(50)] 

public stning LastName { get; set; } 

[StringLength(50)] 

public stning FirstMidName { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 
public DateTime EnrollmentDate { get; set; } 

public ICollection<Ennollment> Enrollments { get; set; } 

} 

} 

stringLength özniteliği bir kullanıcının ad için boşluk girmesini engellemez. Girişe kısıtlama uygulamak için 
ReguiarExpression özniteliğini kullanabilirsiniz. Örneğin, aşağıdaki kod ilk karakterin büyük küçük harf 
olmasını ve geri kalan karakterlerin alfabetik olmasını gerektirir: 

[RegularExpression(@" A [A-Z]+[a-zA-Z \s-]*$")] 

MaxLength özniteliği, stringLength özniteliğe benzer ancak istemci tarafı doğrulaması sağlamayan işlevselliği 
sağlar. 

Veritabanı modeli, veritabanı şemasında değişiklik yapılmasını gerektiren bir şekilde değiştirildi. Uygulama 
kullanıcı arabirimini kullanarak, veritabanına eklemiş olduğunuz herhangi bir veriyi kaybetmeden Şemayı 
güncelleştirmek için geçişleri kullanacaksınız. 

Değişikliklerinizi kaydedin ve projeyi derleyin. Ardından proje klasöründe komut penceresini açın ve aşağıdaki 
komutları girin: 

dotnet ef migrations add MaxLengthOnNames 

dotnet ef database update 

migrations add komutu, bu değişiklik, iki sütun için en fazla uzunluğu daha kısa hale yaptığından, veri kaybının 
gerçekleşebileceğini uyarır. Geçişler _MaxLengthOnNames. cs ><zaman damgasıad\\ bir dosya oluşturur. Bu 
dosya, veritabanını geçerli veri modeliyle eşleşecek şekilde güncelleştirecek up yönteminde kod içerir, 
database update komutu bu kodu çalıştırdı. 

Geçiş dosyası adının ön eki olan zaman damgası, geçişleri sıralamak için Entity Framework tarafından kullanılır. 
Update-database komutunu çalıştırmadan önce birden çok geçiş oluşturabilirsiniz ve sonra tüm geçişler 
oluşturuldukları sırada uygulanır. 


Uygulamayı çalıştırın, öğrenciler sekmesini seçin, Yeni oluştur' a tıklayın ve 50 karakterden daha uzun bir ad 
girmeyi deneyin. Uygulamanın bunu yapmasını önleyebilmelidir. 


Column özniteliği 


Ayrıca, sınıflarınızın ve özelliklerinin veritabanına nasıl eşlenildiğini denetlemek için özniteliklerini de 
kullanabilirsiniz. Alan aynı zamanda bir orta ad içerebileceğinden, ilk ad alanı için FirstMidName adı 


FirstMidName 







kullandığınızı varsayalım. Ancak veritabanına karşı geçici sorgular yazmayacak olan kullanıcılar bu ada alışkın 
olduğundan, veritabanı sütununun FirstName adlandırılmış olmasını isteyebilirsiniz. Bu eşlemeyi yapmak için, 
Column özniteliğini kullanabilirsiniz. 

Column özniteliği, veritabanı oluşturulduğunda, FirstMidName özelliğine eşlenen student tablosunun 
sütununun FirstName adlandırılacağını belirtir. Diğer bir deyişle, kodunuz student.FirstMidName 
başvurduğunda, veriler student tablosunun FirstName sütununda gönderilir veya güncelleştirilir. Sütun adları 
belirtmezseniz, bunlar Özellik adı ile aynı ada verilir. 

Student.es dosyasında, System.ComponentModel.DataAnnotations.sehema için using bir ifade ekleyin ve sütun adı 
özniteliğini aşağıdaki vurgulanmış kodda gösterildiği gibi FirstMidName özelliğine ekleyin: 

using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public elass Student 

{ 

public int ID { get; set; } 

[StringLength(50)] 

public string LastName { get; set; } 

[StringLength(50)] 

[Column("FirstName")] 

public string FirstMidName { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 
public DateTime EnrollmentDate { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 

Column özniteliği ekleme modeli, schooicontext yedekleyen, bu nedenle veritabanıyla eşleşmez. 

Değişikliklerinizi kaydedin ve projeyi derleyin. Ardından proje klasöründe komut penceresini açın ve başka bir 
geçiş oluşturmak için aşağıdaki komutları girin: 

dotnet ef migrations add ColumnFirstName 

dotnet ef database update 


SQL Server Nesne Gezgini, öğrenci tablosuna çift tıklayarak öğrenci tablosu tasarımcısını açın. 


















0^ ContosoUniversity 
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n x 
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Update Script File: 

dbo.Students.sql 



Name 

Data Type 

Allovv Nulls 

a Keys (1) 


-o İD 

EnrollmentDate 

int 

datetime2(7) 

□ 

□ 

PK_Students (Primary Key, CIl 

Check Constraints (0) 
lndexes (0) 

Foreign Keys (0) 


FirstName 

nvarchar(50) 

0 


LastName 

nvarchar(50) 

0 

Triggers (0) 


d Design fi a T-SQL ___ IH □ S 


1 CREATE TABLE [dbo].[Students] ( 

2 [ID] INT IDENTITY (1, 1) NOT NULL, 

3 [EnrollmentDate] DATETIME2 (7) NOT NULL, 

4 [FirstName] NVARCHAR (50) NULL, 

5 [LastName] NVARCHAR (50) NULL, 

CONSTRAINT [PK_Students] PRIHARY KEY CLUSTERED ([ID] ASC) 

7 ); 

s 

100 % - < ► 


ilk iki geçişi uygulamadan önce ad sütunları nvarchar (MAX) türünde. Artık nvarchar (50) ve sütun adı 
FirstMidName iken FirstName olarak değiştirilmiştir. 


NOTE 

Aşağıdaki bölümlerde tüm varlık sınıflarını oluşturmayı bitirmeden önce derlemeyi denerseniz Derleyici hataları alabilirsiniz. 


Öğrenci varlığındaki değişiklikler 


Student 


Properties 
y? İD 

f* LastName 
}'* FirstMidName 
A EnrollmentDate 
Navigation Properties 
P Enrollments 


Modeller/öğrenci, cs' de, daha önce eklediğiniz kodu aşağıdaki kodla değiştirin. Değişiklikler vurgulanır. 















using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace Contosollniversity .Models 

{ 

public class Student 

{ 

public int ID { get; set; } 

[Required] 

[StningLength(50)] 

[Display(Name = "Last Name")] 
public stning LastName { get; set; } 

[Required] 

[StningLength(50)] 

[Column("FirstName")] 

[Display(Name = "First Name")] 

public string FirstMidName { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 

[Display(Name = "Enrollment Date")] 

public DateTime EnrollmentDate { get; set; } 

[Display(Name = "Full Name")] 
public string FullName 
{ 

get 

{ 

return LastName + ", " + FirstMidName; 

} 

} 

public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 


Gerekli öznitelik 

Required özniteliği, ad özellikleri gereken alanları sağlar. Değer türleri (DateTime, int, Double, float, vb.) gibi 
null yapılamayan türler için Required özniteliği gerekli değildir. Null olmayan türler otomatik olarak gerekli 
alanlar olarak değerlendirilir. 


MinimumLength zorlanmak için Required özniteliği MinimumLength ile birlikte kullanılmalıdır. 


[Display(Name = "Last Name")] 
[Required] 

[StringLength(50j MinimumLength=2)] 
public string LastName { get; set; } 


Display özniteliği 

Display özniteliği, metin kutularının açıklamalı alt yazısının her örnekteki Özellik adı yerine "İlk ad", "soyadı", 
"tam ad" ve "kayıt tarihi" olması gerektiğini belirtir (kelimeleri bir boşluk yoktur). 

FullName hesaplanmış özelliği 

FullName , diğer iki özelliği birleştirerek oluşturulmuş bir değer döndüren hesaplanmış bir özelliktir. Bu nedenle, 
yalnızca bir get erişimcisine sahiptir ve veritabanında FullName sütunu oluşturulmaz. 


Eğitmen varlığı oluşturma 










Instmctor 


Properties 
Y? İD 

A LastName 
f* FirstMidName 
A HireDate 
Navigation Properties 
y3 CourseAssıqnments 
P OfficeAssignmerıt 


Şablon kodunu aşağıdaki kodla değiştirerek modeller/eğitmen. csoluşturun: 

using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Instructor 

{ 

public int ID { get; set; } 

[Required] 

[Display(Name = "Last Name")] 

[StringLength(50)] 

public stning LastName { get; set; } 

[Required] 

[Column("FinstName")] 

[Display(Name = "First Name")] 

[StringLength(50)] 

public string FirstMidName { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 

[Display(Name = "Hire Date")] 
public DateTime HireDate { get; set; } 

[Display(Name = "Full Name")] 
public string FullName 
{ 

get { return LastName + ", " + FirstMidName; } 

} 

public ICollection<CourseAssignment> CourseAssignments { get; set; } 
public OfficeAssignment OfficeAssignment { get; set; } 

} 

} 

Öğrenci ve eğitmen varlıklarında birçok özellik aynı olduğuna dikkat edin. Devralma öğreticisini bu serinin 
ilerleyen kısımlarında uyguladığınızda , artıklığı ortadan kaldırmak için bu kodu yeniden düzenlemelisiniz. 

Birden çok özniteliği tek bir satıra koyabilirsiniz, bu nedenle HireDate özniteliklerini aşağıdaki gibi 
yazabilirsiniz: 

[DataType(DataType.Date)jDisplay(Name = "Hire Date"),DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}”, 
ApplyFormatlnEditMode = true)] 


Courseatamalar ve OfficeAssignment gezinti özellikleri 


CourseAssignments ve OfficeAssignment Özellikleri gezinti Özellikleridir. 











Bir eğitmen herhangi bir sayıda kurs öğretebilir, bu nedenle courseAssignments bir koleksiyon olarak tanımlanır. 


public ICollection<CourseAssignment> CourseAssignments { get; set; } 

Bir gezinti özelliği birden çok varlık tukiyorsa, türü girişlerin eklenebileceği, silinebileceği ve 
güncelleştirilemeyebilir bir liste olmalıdır. ıcoiiection<T> veya List<T> veya HashSet<T> gibi bir tür 
belirtebilirsiniz. ıcoiiection<T> belirtirseniz, EF varsayılan olarak bir HashSet<T> koleksiyonu oluşturur. 

Bunların courseAssignment varlıkların nedenleri, çoktan çoğa ilişkiler hakkında bölümünde aşağıda 
açıklanmıştır. 

Contoso Üniversitesi iş kuralları, bir eğitmenin yalnızca en fazla bir ofise sahip olabileceğini, bu nedenle 
OfficeAssignment özelliği tek bir OfficeAssignment varlığı (Office atanmamışsa null olabilir) bulundurmasıdır. 

public OfficeAssignment OfficeAssignment { get; set; } 


OfficeAssignment varlığı oluştur 


OffîceAssign... 



using System.ComponentModel.DataAnnotations; 
using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 
{ 

public class OfficeAssignment 
{ 

[Key] 

public int InstructorlD { get; set; } 
[StningLength(50)] 

[Display(Name = "Office Location")] 
public stning Location { get; set; } 

public Instnuctor Instructor { get; set; } 

} 

} 


Anahtar özniteliği 

Eğitmen ve OfficeAssignment varlıkları arasında bire sıfır veya-bir ilişki vardır. Office ataması, atandığı 
eğitmenle ilişkili olarak yalnızca kendi birincil anahtarı da eğitmen varlığına ait yabancı anahtarıdır. Ancak Entity 
Framevvork, adı İD veya Classnameıd adlandırma kuralını izlemediği için bu varlığın birincil anahtarı olarak 
Komutctorıd 'yi otomatik olarak tanıyamaz. Bu nedenle, Key özniteliği onu anahtar olarak tanımlamak için 
kullanılır: 

[Key] 

public int InstructorlD { get; set; } 
















Varlık kendi birincil anahtarına sahip olsa da, özelliği Classnameıd veya İD dışında bir şekilde adlandırmak 
istiyorsanız Key özniteliğini de kullanabilirsiniz. 

Varsayılan olarak, tam olarak, sütun tanımlayıcı bir ilişki için olduğundan EF, anahtarı veritabanı olmayan bir 
şekilde değerlendirir. 

Eğitmen gezintisi özelliği 

Eğitmen varlığı, null yapılabilir bir officeAssignment gezinti özelliğine sahiptir (bir eğitmenin bir Office ataması 
olmayabilir) ve OfficeAssignment varlığı null atanamaz instructor bir gezinti özelliğine sahiptir (bir Office 
ataması bir eğitmen olmadan mevcut olamaz— instructoriD null değer atanamaz). Bir eğitmen varlığı ilgili bir 
OfficeAssignment varlığına sahip olduğunda, her varlığın gezinti özelliğinde diğer birine bir başvurusu olur. 

ilgili bir eğitmen olması gerektiğini belirtmek için, eğitmen gezinti özelliğine bir [Required] özniteliği 
koyabilirsiniz, ancak bunu yapmak zorunda kalmazsınız çünkü bu, instructoriD yabancı anahtar (aynı 
zamanda bu tablodaki anahtar) null atanamaz. 


Kurs varlığını değiştirme 



using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Course 

{ 

[DatabaseGenerated(DatabaseGeneratedOption.None)] 

[Display(Name = "Number")] 
public int CourselD { get; set; } 

[StringLength(50j MinimumLength = 3)] 
public string Title { get; set; } 

[Range(0, S)] 

public int Credits { get; set; } 

public int DepartmentlD { get; set; } 

public Department Department { get; set; } 

public ICollection<Enrollment> Enrollments { get; set; } 

public ICollection<CourseAssignment> CourseAssignments { get; set; } 

} 

} 

Kurs varlığının, ilgili departman varlığına işaret eden ve Department bir gezinti özelliği olan DepartmentlD 
yabancı anahtar özelliği vardır. 













Entity Framevvork, ilgili varlık için bir gezinti özelliği olduğunda, veri modelinize yabancı anahtar özelliği 
eklemenizi gerektirmez. EF, gerektiğinde otomatik olarak yabancı anahtarlar oluşturur ve bunlar için gölge 
Özellikler oluşturur. Ancak veri modelinde yabancı anahtar olması, güncelleştirmeleri daha basit ve daha verimli 
hale getirir. Örneğin, düzenlemek üzere bir kurs varlığı aldığınızda, bunu yüklemezseniz departman varlığı null 
olur, bu nedenle kurs varlığını güncelleştirdiğinizde öncelikle departman varlığını almanız gerekir. Yabancı 
anahtar özelliği DepartmentiD veri modeline dahil edildiğinde, güncelleştirmeden önce bölüm varlığını almanız 
gerekmez. 

DatabaseGenerated özniteliği 

CourseiD özelliğindeki None parametresine sahip DatabaseGenerated özniteliği, birincil anahtar değerlerinin 
veritabanı tarafından oluşturulması yerine Kullanıcı tarafından sağlandığını belirtir. 

[DatabaseGenerated(DatabaseGeneratedOption.None)] 

[Display(Name = "Number")] 
public int CourseiD { get; set; } 

Varsayılan olarak, Entity Framevvork birincil anahtar değerlerinin veritabanı tarafından oluşturulduğunu 
varsayar. Bu, Çoğu senaryoda istediğiniz şeydir. Ancak, kurs varlıkları için bir departman için 1000 serisi, başka 
bir departman için 2000 serisi vb. gibi kullanıcı tarafından belirtilen bir kurs numarası kullanırsınız. 

DatabaseGenerated özniteliği, bir satırın oluşturulduğu veya güncelleştirildiği tarihi kaydetmek için kullanılan 
veritabanı sütunları durumunda olduğu gibi varsayılan değerleri oluşturmak için de kullanılabilir. Daha fazla 
bilgi için bkz. üretilen Özellikler. 

Yabancı anahtar ve gezinti özellikleri 

Kurs varlığındaki yabancı anahtar özellikleri ve gezinti özellikleri aşağıdaki ilişkileri yansıtır: 

Bir kurs bir departmana atanır, bu nedenle yukarıda bahsedilen nedenlerle DepartmentiD yabancı anahtar ve 
Department gezinti özelliği vardır. 

public int DepartmentiD { get; set; } 
public Department Department { get; set; } 

Bir kurs, kayıtlı sayıda öğrenciye sahip olabilir, bu nedenle Enroiiments gezinti özelliği bir koleksiyondur: 

public ICollection<Enrollment> Enrollments { get; set; } 

Bir kurs birden fazla eğitmen tarafından tada olabilir, bu nedenle courseAssignments gezinti özelliği bir 
koleksiyon olur ( courseAssignment türü daha sonraaçıklanmıştır): 

public ICollection<CourseAssignment> CourseAssignments { get; set; } 


Departman varlığı oluştur 












Department 


Properties 
yî DepartmentlD 
f* Name 
b Budget 
A StartDate 
A* InstructorlD 
Navigation Properties 
Administrator 
Courses 


Aşağıdaki kodla modeller/departman, cs oluşturun: 

using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Department 

{ 

public int DepartmentlD { get; set; } 

[Stringl_ength(50, MinimumLength = 3)] 
public string Name { get; set; } 

[DataType(DataType.Currency)] 

[Column(TypeName = "money")] 
public decimal Budget { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 

[Display(Name = "Start Date")] 

public DateTime StartDate { get; set; } 

public int? InstructorlD { get; set; } 

public Instructor Administrator { get; set; } 
public ICollection<Course> Courses { get; set; } 

} 

} 


Column özniteliği 

Daha önce, sütun adı eşlemesini değiştirmek için column özniteliğini kullandınız. Bölüm varlığının kodunda, 
sütunun veritabanındaki SQL Server para türü kullanılarak tanımlanması için SQL veri türü eşlemesini 
değiştirmek üzere column özniteliği kullanılır: 

[Column(TypeName="money")] 
public decimal Budget { get; set; } 

Entity Framevvork, özellik için tanımladığınız CLR türüne göre uygun SQL Server veri türünü seçtiği için sütun 
eşlemesi genellikle gerekli değildir. CLR decimal türü bir SQL Server decimal türüne eşlenir. Ancak bu 
durumda, sütunun para birimi tutarlarını tutuını ve para veri türü bunun için daha uygun olduğunu bilirsiniz. 

Yabancı anahtar ve gezinti özellikleri 

Yabancı anahtar ve gezinti özellikleri aşağıdaki ilişkileri yansıtır: 

Bir departman yönetici olabilir veya olmayabilir ve yönetici her zaman bir eğitmendir. Bu nedenle InstructorlD 















özelliği, eğitmen varlığına yabancı anahtar olarak dahil edilir ve özelliği null yapılabilir olarak işaretlemek için 
int tür atamadan sonra bir soru işareti eklenir. Gezinti özelliği Administrator olarak adlandırılır ancak bir 
eğitmen varlığı tutar: 

public int? InstructorlD { get; set; } 
public Instructor Administrator { get; set; } 


Bir departmanın birçok kursu olabilir, bu nedenle bir kurs gezintisi özelliği vardır: 


public ICollection<Course> Courses { get; set; } 


NOTE 

Kurala göre Entity Framevvork, null olamayan yabancı anahtarlar ve çoktan çoğa ilişkiler için art arda silme imkanı sağlar. 
Bu, bir geçiş eklemeye çalıştığınızda bir özel duruma neden olacak dairesel basamaklı silme kurallarına neden olabilir. 
Örneğin, Department. Komutctorıd özelliğini null yapılabilir olarak tanımlamadıysanız, bu, bir basamak silme kuralını, 
eğitmeni sildiğinizde, ne yapmak istediğinize ilişkin olmayan bir şeyi silmek için yapılandırır, iş kurallarınız InstructorlD 
özelliğini null atanamaz olarak gerektiriyorsa, ilişkide basamaklı silmeyi devre dışı bırakmak için aşağıdaki Fluent API 
ifadesini kullanmanız gerekir: 

modelBulider.Entity<Department>() 

.HasOne(d => d.Administrator) 

.WithMany() 

.OnDelete(DeleteBehavior.Restrict) 


Kayıt varlığını değiştirme 


Enrollment 


Properties 
y? EnrolImentlD 
A CourselD 
A StudentlD 
A Grade 

Navigation Properties 
Course 
y3 Student 


Modeller/kayit. cs' de, daha önce eklediğiniz kodu aşağıdaki kodla değiştirin: 












using System.ComponentModel.DataAnnotations ; 
using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 
{ 

public enum Grade 
{ 

A, B, C, D, F 

} 

public class Ennollment 
{ 

public int EnnollmentlD { get; set; } 
public int CourselD { get; set; } 
public int StudentlD { get; set; } 
[DisplayFormat(NullDisplayText = "No grade")] 
public Grade? Grade { get; set; } 

public Course Course { get; set; } 
public Student Student { get; set; } 

} 

} 


Yabancı anahtar ve gezinti özellikleri 

Yabancı anahtar özellikleri ve gezinti özellikleri aşağıdaki ilişkileri yansıtır: 

Kayıt kaydı tek bir kurs için olduğundan CourselD yabancı anahtar özelliği ve course gezinti özelliği vardır: 

public int CourselD { get; set; } 
public Course Course { get; set; } 

Kayıt kaydı tek bir öğrenci içindir, bu nedenle StudentlD yabancı anahtar özelliği ve student gezinti özelliği 
vardır: 


public int StudentlD { get; set; } 
public Student Student { get; set; } 


Çoktan çoğa ilişkiler 

Öğrenci ve kurs varlıkları arasında çok-çok ilişkisi vardır ve kayıt varlığı, veritabanında Yük içeren çoktan çoğa 
bir JOIN tablosu gibi çalışır. "Yük ile", kayıt tablosunun birleştirilmiş tablolar için yabancı anahtarlar (Bu 
durumda bir birincil anahtar ve bir sınıf özelliği) yanında ek veriler içerdiği anlamına gelir. 

Aşağıdaki çizimde bu ilişkilerin bir varlık diyagramında nasıl göründüğünü gösterilmektedir.(Bu diyagram EF 6. 
x için Entity Framevvork güç araçları kullanılarak oluşturulmuştur; diyagramı oluşturmak öğreticinin bir parçası 
değildir, burada yalnızca bir çizim olarak kullanılmaktadır.) 










Student 


Properties 
yî İD 

A* LastName 
A" FirstMidName 
A* EnrolImentDate 
Navigation Properties 
Enrollments 

T, 


' 


Enrollment ^ 


Course 

Properties 


Properties 

yî EnrolImentlD 

A* CourselD 

M StudentlD 

A< Grade 

A. .A 

yî CourselD 
f> Title 

A* Credits 

A* DepartmentlD 

.......T. ^ 

* 1 

Navigation Properties 


Navigation Properties 

y3 Course 
y3 Student 


y3 Department 
y3 Enrollments 

CourseAssignments 




Her ilişki ucu ve bir yıldız işareti (*) 1 diğer sırasında bir-çok ilişkisi belirten bulunur. 

Kayıt tablosu, sınıf bilgilerini içermiyorsa, yalnızca iki yabancı anahtar olan CourselD ve Studentitıd 'yi 
içermelidir. Bu durumda, veritabanına yük (veya saf bir JOIN tablosu) olmadan çok-çok arasında bir JOIN 
tablosu olacaktır. Eğitmen ve kurs varlıklarının bu tür çok-çok ilişkisi vardır ve bir sonraki adımınız, yük olmadan 
bir JOIN tablosu olarak çalışacak bir varlık sınıfı oluşturmaktır. 

(EF 6. x, çoktan çoğa ilişkiler için örtük birleştirmeyi destekler, ancak EF Core. Daha fazla bilgi için, EF Core 
GitHub deposundaki tartışmayabakın.) 

Courseatama varlığı 


Co u rse Assig nmen t 


Properties 
A* CourselD 
A» InstructorlD 
Navigation Properties 
y3 Course 
y3 Instructor 


Aşağıdaki kodla modeller/Courseatama. cs oluşturun: 























using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace Contosollniversity .Models 
{ 

public class CourseAssignment 
{ 

public int InstructorlD { get; set; } 
public int CourselD { get; set; } 
public Instructor Instructor { get; set; } 
public Course Counse { get; set; } 

} 

} 

Varlık adlarını Birleştir 

Eğitim—çok ilişkisi için veritabanında bir JOIN tablosu gereklidir ve bir varlık kümesi tarafından temsil edilir. Bu 
örnekte Courseinstnuctor'' EntityNameiEntityName 2 bir JOIN varlığının adı yaygın olarak kullanılır.Ancak, ilişkiyi 
açıklayan bir ad seçmenizi öneririz. Veri modelleri, daha sonra yükleri daha sonra almak için, yük olmayan 
birleşimler olmadan basit ve büyümeye başlar. Açıklayıcı bir varlık adıyla başladıysanız, daha sonra adı 
değiştirmeniz gerekmez, ideal olarak, JOIN varlığının iş etki alanında kendi doğal (muhtemelen tek bir kelime) 
adına sahip olması gerekir. Örneğin, kitaplar ve müşteriler derecelendirmeler aracılığıyla bağlanabilir. Bu ilişki 
için CourseAssignment Courseinstructor daha iyi bir seçenektir. 

Bileşik anahtar 

Yabancı anahtarlar null değer atanmadığından ve tablodaki her satırı benzersiz bir şekilde tanımladığından, ayrı 
bir birincil anahtar gerekmez. Komutctorıd ve CourselD özellikleri bir bileşik birincil anahtar olarak çalışır. EF 
için bileşik birincil anahtarları tanımlamanın tek yolu FluerıtAPI kullanmaktır (öznitelikleri kullanılarak 
gerçekleştirilemez). Bir sonraki bölümde bileşik birincil anahtarı nasıl yapılandıracağınızı göreceksiniz. 

Bileşik anahtar, tek bir kurs için birden çok satır ve bir eğitmen için birden fazla satır, aynı eğitmen ve kurs için 
birden çok satıra sahip olmanızı sağlar. Enroiiment JOIN varlığı kendi birincil anahtarını tanımlar, bu nedenle 
bu sıralamanın yinelemeleri mümkündür. Bu tür yinelemeleri engellemek için yabancı anahtar alanlarına 
benzersiz bir dizin ekleyebilir veya CourseAssignment benzer bir birincil bileşik anahtarla Enroiiment 
yapılandırabilirsiniz. Daha fazla bilgi için bkz. dizinler. 

Veritabanı bağlamını güncelleştirme 

Data/SchoolContext. cs dosyasına aşağıdaki vurgulanmış kodu ekleyin: 







using ContosoUniversity.Models; 
using Microsoft.EntityFrameworkCore; 

namespace ContosoUniversity.Data 

{ 

public class SchoolContext : DbContext 

{ 

public SchoolContext(DbContextOptions<SchoolContext> options) : base(options) 

{ 

} 


public DbSet<Course> Courses { get; set; } 

public DbSet<Enrollment> Enrollments { get; set; } 

public DbSet<Student> Students { get; set; } 

public DbSet<Department> Departments { get; set; } 

public DbSet<Instructor> Instructors { get; set; } 

public DbSet<OfficeAssignment> OfficeAssignments { get; set; } 

public DbSet<CourseAssignment> CourseAssignments { get; set; } 

protected override void OnModelCreating(ModelBuilder modelBuilder) 

{ 

modelBuilder.Entity<Course>().ToTable("Course"); 
modelBuilder.Entity<Enrollment>().ToTable("Enrollment"); 
modelBuilder.Entity<Student>().ToTable("Student"); 
modelBuilder.Entity<Department>().ToTable("Department"); 
modelBuilder.Entity<Instructor>().ToTable("Instructor"); 
modelBuilder.Entity<OfficeAssignment>().ToTable("OfficeAssignment"); 
modelBuilder.Entity<CourseAssignment>().ToTable("CourseAssignment"); 


} 


} 


modelBuilder.Entity<CourseAssignment>() 

.HasKey(c => new { c.CourselDj c.InstructorlD }); 


} 


Bu kod yeni varlıkları ekler ve Courseatama varlığının bileşik birincil anahtarını yapılandırır. 

Fluent API alternatifi hakkında 

DbContext sınıfının onModeicreating yöntemindeki kod, EF davranışını yapılandırmak için Fluent API kullanır. 
Bu örnekte, EF Core belgelerindenfarklı olarak, bir dizi yöntemi çağıran tek bir bildirimde dize tarafından 
KULLANıLDıĞıNDAN, API "floent" olarak adlandırılır: 


protected override void OnModelCreating(ModelBuilder modelBuilder) 

{ 

modelBuilder.Entity<Blog>() 

.Property(b => b.Url) 

.IsRequired(); 

} 


Bu öğreticide, yalnızca öznitelikleri ile yapaamıyoruz veritabanı eşlemesi için Fluent API kullanıyorsunuz. Ancak, 
özniteliklerini kullanarak yapabileceğiniz biçimlendirme, doğrulama ve eşleme kurallarının çoğunu belirtmek 
için Fluent API de kullanabilirsiniz. MinimumLength gibi bazı öznitelikler Fluent API uygulanamaz. Daha önce 
belirtildiği gibi, MinimumLength şemayı değiştirmez, yalnızca bir istemci ve sunucu tarafı doğrulama kuralı 
uygular. 

Bazı geliştiriciler, varlık sınıflarının "temiz" olmasını sağlamak için Fluent API özel olarak kullanmayı tercih eder, 
isterseniz öznitelikleri ve Fluent API karıştırabilir ve yalnızca Fluent API kullanılarak gerçekleştirilebilecek bazı 
özelleştirmeler de vardır ancak genel olarak önerilen uygulama, bu iki yaklaşımdan birini seçmek ve bunları 
mümkün olduğunca tutarlı bir şekilde kullanmaktır. Her ikisini de kullanırsanız, bir çakışma olduğunda, akıcı 








API 'nin öznitelikleri geçersiz kıldığını unutmayın. 

Öznitelikler ile Fluent API hakkında daha fazla bilgi için bkz. yapılandırma yöntemleri. 


İlişkileri gösteren varlık diyagramı 


Aşağıdaki çizimde, Entity Framework Povver Tools 'un tamamlanmış okul modeli için kullandığı diyagram 
gösterilmektedir. 
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Bire çok ilişki çizgilerinin yanı sıra (1 1 den *), eğitmen ve OfficeAssignment varlıkları arasında (1 ila 0.. 1) ve 
eğitmen ve departman varlıkları arasında sıfır veya-bire çok ilişki satırı (0.. 1 ile *) arasında bir tek-sıfır veya-bir 
ilişki satırını görebilirsiniz. 

Test verileriyle çekirdek veritabanı 

Veri/Dbınınitializer. cs dosyasındaki kodu, oluşturduğunuz yeni varlıklar için çekirdek verileri sağlamak üzere 
aşağıdaki kodla değiştirin. 

using System; 
using System.Linq; 

using Microsoft.EntityFrameworkCore; 

using Microsoft.Extensions.DependencyInjection; 

using ContosoUniversity.Models; 









































namespace ContosoUniversity.Data 

{ 

public static class Dblnitializer 

{ 

public static void Initialize(SchoolContext context) 

{ 

//context.Database.EnsureCreated(); 


// Look for any students. 
if (context.Students.Any()) 

{ 

return; // DB has been seeded 

} 

var students = new Studentf] 

{ 

new Student { FirstMidName = "Carson", LastName 
EnrollmentDate = DateTime.Parse("2010-09-01") 
new Student { FirstMidName = "Meredith", LastName 
EnrollmentDate = DateTime.Parse("2012-09-01") 
new Student { FirstMidName = "Arturo", LastName 
EnrollmentDate = DateTime.Parse("2013-09-01") 
new Student { FirstMidName = "Gytis", LastName 
EnrollmentDate = DateTime.Parse("2012-09-01") 
new Student { FirstMidName = "Yan", LastName 

EnrollmentDate = DateTime.Parse("2012-09-01") 
new Student { FirstMidName = "Peggy", LastName 
EnrollmentDate = DateTime.Parse("2011-09-01") 
new Student { FirstMidName = "Laura", LastName 
EnrollmentDate = DateTime.Parse("2013-09-01") 
new Student { FirstMidName = "Nino", LastName 
EnrollmentDate = DateTime.Parse("2005-09-01") 

}; 

foreach (Student s in students) 

{ 

context.Students.Add(s); 

} 

context.SaveChanges(); 


= "Alexander", 

= "Alonso", 

= "Anand", 

= "Barzdukas", 

}, 

= "Lİ", 

}, 

= "Dustice", 

}, 

= "Norman", 

= "Olivetto", 

} 


var instructors = new Instructor[] 

{ 

new Instructor { FirstMidName = "Kim", LastName = "Abercrombie", 
HireDate = DateTime.Parse("1995-03-ll") }, 
new Instructor { FirstMidName = "Fadi", LastName = "Fakhouri", 
HireDate = DateTime.Parse("2002-07-06") }, 
new Instructor { FirstMidName = "Roger", LastName = "Harui", 
HireDate = DateTime.Parse("1998-07-01") }, 
new Instructor { FirstMidName = "Candace", LastName = "Kapoor", 
HireDate = DateTime.Parse("2001-01-15") }, 
new Instructor { FirstMidName = "Roger", LastName = "Zheng", 
HireDate = DateTime.Parse("2004-02-12") } 


}; 


foreach (Instructor i in instructors) 

{ 

context.instructors.Add(i); 

} 

context.SaveChanges(); 


var departments = new Departmentf] 

{ 

new Department { Name = "English", Budget = 350000, 

StartDate = DateTime.Parse("2007-09-01"), 

InstructorlD = instructors.Single( i => i.LastName == "Abercrombie").ID }, 
new Department { Name = "Mathematics", Budget = 100000, 

StartDate = DateTime.Parse("2007-09-01"), 
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new Department { Name = "Engineering", Budget = 350000, 

StartDate = DateTime.Parse("2007-09-01"), 

InstructorlD = instructors.Single( i => i.LastName == "Harui").ID }, 
new Department { Name = "Economics", Budget = 100000, 

StartDate = DateTime.Parse("2007-09-01"), 

InstructorlD = instructors.Single( i => i.LastName == "Kapoor").ID } 

b 


foreach (Department d in departments) 

{ 

context.Departments.Add(d); 

} 

context.SaveChanges(); 


var courses = new Course[] 


{ 


}; 


new Course {CourselD = 1050, Title = "Chemistry", Credits = 3, 

DepartmentlD = departments.Single( s => s.Name == "Engineering").DepartmentlD 

b 

new Course {CourselD = 4022, Title = "Microeconomics", Credits = 3, 

DepartmentlD = departments.Single( s => s.Name == "Economics").DepartmentlD 

b 


new Course {CourselD = 4041, Title = "Macroeconomics", Credits = 3, 

DepartmentlD = departments.Single( s => s.Name == "Economics").DepartmentlD 

b 

new Course {CourselD = 1045, Title = "Calculus", Credits = 4, 

DepartmentlD = departments.Single( s => s.Name == "Mathematics").DepartmentlD 


b 

new Course {CourselD = 3141, Title = "Trigonometry", 
DepartmentlD = departments.Single( s => s.Name == 

b 

new Course {CourselD = 2021, Title = "Composition", 
DepartmentlD = departments.Single( s => s.Name == 

b 

new Course {CourselD = 2042, Title = "Literatüre", 
DepartmentlD = departments.Single( s => s.Name == 

b 


Credits = A, 

"Mathematics").DepartmentlD 

Credits = 3, 

"English").DepartmentlD 

Credits = A, 

"English").DepartmentlD 


foreach (Course c in courses) 

{ 

context.Courses.Add(c); 

} 

context.SaveChanges(); 


var officeAssignments = new OfficeAssignment[] 

{ 

new OfficeAssignment { 

InstructorlD = instructors.Single( i => İ.LastName == "Fakhouri").ID, 
Location = "Smith 17" }, 
new OfficeAssignment { 

InstructorlD = instructors.Single( i => İ.LastName == "Harui").IDj 
Location = "Gowan 27" }, 
new OfficeAssignment { 

InstructorlD = instructors.Single( i => İ.LastName == "Kapoor").ID, 
Location = "Thompson 304" }, 

}; 

foreach (OfficeAssignment o in officeAssignments) 

{ 

context.OfficeAssignments.Add(o); 

} 

context.SaveChanges(); 


var courselnstructors = new CourseAssignment[] 

{ 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title == "Chemistry" ).CourselD, 
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}; 


}, 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 
}, 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 
}, 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 
}, 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 
}, 

new CourseAssignment { 

CourselD = courses.Single(c => c.Title 
InstructorlD = instructors.Single(i => 


== "Chemistry" ).CourselD, 
i.LastName == "Harui").ID 


== "Microeconomics" ).CourseIDj 
i.LastName == "Zheng").ID 


== "Macroeconomics" ).CourseIDj 
i.LastName == "Zheng").ID 


== "Calculus" ).CourselD., 
i.LastName == "Fakhouri").ID 


== "Trigonometry" ).CourselD, 
i.LastName == "Harui").ID 

== "Composition" ).CourselD, 
i.LastName == "Abercrombie").ID 


== "Literatüre" ).CourselD, 
i.LastName == "Abercrombie").ID 


foreach (CourseAssignment ci in courselnstructors) 

{ 

context.CourseAssignments.Add(ci); 

} 

context.SaveChanges(); 


var enrollments = new Enrollmentf] 

{ 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Alexander").ID, 
CourselD = courses.Single(c => c.Title == "Chemistry" ).CourselD, 

Grade = Grade.A 

}, 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Alexander").ID, 
CourselD = courses.Single(c => c.Title == "Microeconomics" ).CourselD, 
Grade = Grade.C 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Alexander").ID, 
CourselD = courses.Single(c => c.Title == "Macroeconomics" ).CourselD, 
Grade = Grade.B 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Alonso").ID, 
CourselD = courses.Single(c => c.Title == "Calculus" ).CourselD, 

Grade = Grade.B 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Alonso").ID, 
CourselD = courses.Single(c => c.Title == "Trigonometry" ).CourselD, 
Grade = Grade.B 
}, 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Alonso").ID, 

CourselD = courses.Single(c => c.Title == "Composition" ).CourselD, 
Grade = Grade.B 


i, 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Anand").İD, 

CourselD = courses.Single(c => c.Title == "Chemistry" ).CourseID 

b 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Anand").IDj 
CourselD = courses.Single(c => c.Title == "Microeconomics").CourselDj 
Grade = Grade.B 

b 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Barzdukas").IDj 
CourselD = courses.Single(c => c.Title == "Chemistry") .CourselD., 

Grade = Grade.B 

b 

new Enrollment { 

StudentlD = students.Single(s => s.LastName == "Li").ID, 

CourselD = courses.Single(c => c.Title == "Composition").CourselDj 
Grade = Grade.B 

b 

new Enrollment { 

StudentlD = students.Slngle(s => s.LastName == "Tustice").IDj 
CourselD = courses.Single(c => c.Title == "Literatüre").CourselDj 
Grade = Grade.B 
} 

b 

foreach (Enrollment e in enrollments) 

{ 

var enrollmentlnDataBase = context.Enrollments.Where( 
s => 

s.Student.ID == e.StudentlD && 

s.Course.CourselD == e.CourselD).SingleOrDefault(); 
if (enrollmentlnDataBase == null) 

{ 

context.Enrollments.Add (e); 

} 

} 

context.SaveChanges(); 

} 

} 

} 

ilk öğreticide gördüğünüz gibi, bu kodun çoğu yalnızca yeni varlık nesneleri oluşturur ve test için gereken 
şekilde, örnek verileri özelliklere yükler. Çoktan çoğa ilişkilerin nasıl işlendiği hakkında dikkat edin: kod, 
Enrollments varlıklar oluşturup courseAssignment varlık kümelerine katmak yoluyla ilişkiler oluşturur. 

Geçiş Ekle 


Değişikliklerinizi kaydedin ve projeyi derleyin. Ardından proje klasöründe komut penceresini açın ve 
migrations add komutunu girin (henüz Update-database komutunu yapmayın): 



An operation was scaffolded that may result in the loss of data. Please review the migration for accuracy. 
Done. To undo this action, use 'ef migrations remove' 


database update komutunu bu noktada çalıştırmayı denediyseniz (henüz yapmayın), şu hatayı alırsınız: 


ALTER TABLE ifadesi, "FK_dbo yabancı anahtar kısıtlaması ile çakışıyor. Course_dbo. 





Department_DepartmentlD "Contosollniversity" veritabanında, "dbo" tablosunda çakışma oluştu. Bölüm 
", sütun 1 DepartmentlD 


Bazı durumlarda, mevcut verilerle geçişleri yürüttüğünüzde, yabancı anahtar kısıtlamalarını karşılamak için 
saplama verilerini veritabanına eklemeniz gerekir, up yönteminde oluşturulan kod, kurs tablosuna null 
yapılamayan bir DepartmentlD yabancı anahtarı ekler. Kurs tablosunda kod çalıştırıldığında zaten satırlar varsa, 
SQL Server null olmayan sütuna hangi değerin yerleştirileceğini bilmediği için Addcolumn işlemi başarısız olur. 
Bu öğreticide, geçişi yeni bir veritabanında çalıştıracaksınız, ancak bir üretim uygulamasında geçiş, mevcut 
verileri işleyeceğinizden, bu sayede bunun nasıl yapılacağını gösteren bir örnek gösterilmektedir. 

Bu geçişi mevcut verilerle birlikte çalışarak, yeni sütuna varsayılan bir değer vermek için kodu değiştirmeniz ve 
varsayılan departman görevi gören "Temp" adlı bir saplama departmanı oluşturmanız gerekir. Sonuç olarak, 
mevcut kurs satırları up yöntemi çalıştıktan sonra "geçici" departmanla ilgili olacaktır. 

• {Timestamp}_ComplexDataModel. cs dosyasını açın. 

• DepartmentlD sütununu kurs tablosuna ekleyen kod satırını açıklama satırı yapın. 

migrationBuilder.AlterColumn<string>( 
name: "Title", 
table: "Course", 
maxLength: 50, 
nullable: true, 
oldClrType: typeof(stning), 
oldNullable: true); 

//migrationBuilder.AddColumn<int>( 

// name: "DepartmentlD", 

// table: "Course", 

// nullable: false, 

// defaultValue: 0); 


• Departman tablosunu oluşturan koddan sonra aşağıdaki vurgulanmış kodu ekleyin: 






migrationBuilder.CreateTable( 
name: "Department", 
columns: table => new 
{ 

DepartmentlD = table.Column<int>(nullable: false) 

.Annotation("SqlServer:ValueGenerationStrategy", 

SqlServerValueGenerationStrategy.IdentityColumn), 

Budget = table.Column<decimal>(type: "money", nullable: false), 

InstructorlD = table.Column<lnt>(nullable: true). 

Name = table.Column<string>(maxLength: 50, nullable: true), 

StartDate = table.Column<DateTime>(nullable: false) 

b 

constraints: table => 

{ 

table.PrimaryKey("PK_Department", x => x.DepartmentlD); 
table.ForeignKey( 

name: "FK_Department_Instructor_InstructorID", 
column: x => x.InstructorlD, 
principalTable: "Instructor", 
principalColumn: "ID", 
onDelete: ReferentialAction.Restrict); 

}); 

migrationBuilder.Sql("INSERT INTO dbo.Department (Name, Budget, StartDate) VALUES ('Temp', 0.00, 
GETDATE())"); 

// Default value for FK points to department created above, with 
// defaultValue changed to 1 in following AddColumn statement. 

migrationBuilder.AddColumn<int>( 
name: "DepartmentlD", 
table: "Course", 
nullable: false, 
defaultValue: 1); 


Bir üretim uygulamasında, departman satırları eklemek ve kurs satırlarını yeni departman satırlarıyla 
ilişkilendirmek için kod veya komut dosyaları yazın. Bundan sonra "geçici" Departmanı veya kurs. 
DepartmentlD sütununda Varsayılan değer gerekmez. 

Değişikliklerinizi kaydedin ve projeyi derleyin. 

Bağlantı dizesini değiştirme 

Artık, yeni varlıkların temel verilerini boş bir veritabanına ekleyen Dbinitializer sınıfında yeni kodunuz var. EF 
'in yeni boş bir veritabanı oluşturmasını sağlamak için appSettings. JSON içindeki bağlantı dizesinde 
veritabanının adını ContosoUniversity3 veya kullandığınız bilgisayarda kullanmadığınız başka bir adla 
değiştirin. 

{ 

"ConnectlonStrings": { 

"DefaultConnection": "Server= 

(localdb)\\mssqllocaldb;Database=ContosoUniversity3;Trusted_Connection=True;MultlpleActiveResultSets=true" 

b 


Değişiklerinizi appSettings. JSON' da kaydedin. 





NOTE 

Veritabanı adını değiştirmeye alternatif olarak, veritabanını silebilirsiniz. SQL Server Nesne Gezgini (ssox) veya 
database drop CLI komutunu kullanın: 

dotnet ef database drop 


Veritabanını güncelleştirme 

Veritabanı adını değiştirdikten veya veritabanını sildikten sonra, geçişleri yürütmek için komut penceresinde 
database update komutunu çalıştırın. 

dotnet ef database update 

Dbinitializer.initialize yönteminin çalışmasına ve yeni veritabanını doldurmasına neden olmak için 
uygulamayı çalıştırın. 

Veritabanını daha önce yaptığınız gibi SSOX içinde açın ve tabloların tümünün oluşturulduğunu görmek için 
Tables düğümünü genişletin. (Yine de bir daha önceki zamanda SSOX açıksa Yenile düğmesine tıklayın.) 

SQL Server Object Explorer * n X 

û | + a * 

A yî SQL Server 

a E (localdb)\MSSQLLocalDB(SQL Server 13.0. 

■< a üatabases 

> 0 System Databases 

a ijf aspnet-ContosoUniversity20160816 
a O Tables 

> 0 System Tables 

> El External Tables 

> 11 dbo._EFMİgrationsHistory 

> B dbo.Course 

> B dbo.CourseAssignment 

> B dbo.Department 

> B dbo.EnrolIment 

> B dbo.lnstructors 

> B dbo.OfficeAssignment 

> B dbo.Student 



Veritabanını gösteren Başlatıcı kodunu tetiklemek için uygulamayı çalıştırın. 

Courseatama tablosuna sağ tıklayın ve verileri görüntüle ' yi seçerek veri içerdiğinden emin olun. 


*4 

lontosoUniversity 

□ X 

1 dbo.CourseAssignment [Data] -0 X | 

c 

i | T. T 1 % 



CourselD 

InstructorlD 

► 

m 

1 


2042 

1 


1045 

2 


1050 

3 


3141 

3 


1050 

4 


4022 

5 


4041 

5 

• 

NULL 

NULL 












Kodu alın 

Tamamlanmış uygulamayı indirin veya görüntüleyin. 

Sonraki adımlar 

Bu öğreticide şunları yaptınız: 

• Veri modeli özelleştirildi 

• Öğrenci varlığında değişiklikler yapıldı 

• Eğitmen varlığı oluşturuldu 

• OfficeAssignment varlığı oluşturuldu 

• Değiştirilen kurs varlığı 

• Departman varlığı oluşturuldu 

• Değiştirilen kayıt varlığı 

• Veritabanı bağlamı güncelleştirildi 

• Test verileriyle birlikte sağlanan veritabanı 

• Geçiş eklendi 

• Bağlantı dizesi değiştirildi 

• Veritabanı güncelleştirildi 

ilgili verilere erişme hakkında daha fazla bilgi edinmek için sonraki öğreticiye ilerleyin. 
Sonraki: ilgili verilere erişin 


Öğretici: EF Core ile ilgili verileri okuma-ASRNET 
MVC 

23.11.2019 • 22 minutes to read ı Edit Online 


Önceki öğreticide, okul veri modelini tamamladınız. Bu öğreticide ilgili verileri okur ve görüntüleriz. Bu, Entity 
Framevvork, gezinti özelliklerine yüklediği veriler. 

Aşağıdaki çizimlerde, birlikte çalışacağımız sayfalar gösterilmektedir. 


E3 Courses - Contoso Univ X + 


□ X 

^ localhost:58 

☆ 

— 

■••••■ 

Contoso University 


— 


Courses 

Create New 

Number Title 

1045 Calculus 

1050 Chemistry 

2021 Composition 



Credits Department 

4 Mathematics Edit | Details | Delete 

3 Engineering Edit | Details | Delete 

3 English Edit | Details | Delete 










H Instructors - Contoso Uı X 

+ 

- □ X 

<" "> ü 

localhost5813/lnstructors/lndex/1? ^ 

- m & - 


Instructors 

Create New 



First 

Hire 




Last Name 

Name 

Date 

Office 

Courses 


Abercrombie 

Kim 

1995- 


2021 Composition 

Select | Edit | 



03-11 


2042 Literatüre 

Details | Delete 

Fakhouri 

Fadi 

2002- 

Smith 17 

1045 Calculus 

Select | Edit | 



07-06 



Details | Delete 

Harui 

Roger 

1998- 

Gowan 27 

1050 Chemistry 

Select | Edit | 



07-01 


3141 Trigonometry 

Details | Delete 



Contoso University 



Courses Taught by Selected İnstructor 



Number 

Title 

Department 

Select 

2021 

Composition 

English 

Select 

2042 

Literatüre 

English 


Students Enrolled in Selected Course 


Name 

Grade 

Alonso, Meredith 

B 

Li, Yan 

B 



Bu öğreticide şunları yaptınız: 

• ilgili verileri yüklemeyi öğrenin 

• Kurslar sayfası oluşturma 

• Eğitmenler sayfası oluşturma 

• Açık yükleme hakkında bilgi edinin 

Önkoşullar 

• Karmaşık veri modeli oluşturma 

İlgili verileri yüklemeyi öğrenin 

Entity Framevvork gibi nesne İlişkisel eşleme (ORM) yazılımının bir varlığın gezinti özelliklerine ilgili verileri 
yükleyebilmesinin birkaç yolu vardır: 

• Eager yükleniyor. Varlık okurken ilgili veriler onunla birlikte alınır. Bu, genellikle gereken tüm verileri alan 












tek bir JOIN sorgusuna neden olur, inciude ve Theninciude yöntemlerini kullanarak Entity Framevvork 
Core 1 de bir Eager yüklemesi belirlersiniz. 


var departments = _context.Departments.Include(d => d.Courses); 
foreach (Department d in departments) 

foreach(course c in d.Courses) Query: ali Department entities 


{ 


courseList.Add(d.Name + c.Title); 


le); V. 


and related Course entities 


J 


Bazı verileri ayrı sorgularda alabilir ve "düzeltmeler" i "düzeltir" seçeneğini kullanabilirsiniz. Diğer bir 
deyişle, EF, daha önce alınan varlıkların gezinti özelliklerine ait oldukları ayrı alınan varlıkları otomatik 
olarak ekler, ilgili verileri alan sorgu için, ToList veya single gibi bir liste veya nesne döndüren bir 
yöntem yerine Load yöntemini kullanabilirsiniz. 


var departments = _context.Departments; 
foreach (Department d in departments) 

{ 


Query: ali Department rows 




_context.Courses.Where(c => c.DepartmentlD == d.DepartmentlD).Load(); 
foreach (Course c in d.Courses) 

{ 

courseList.Add(d.Name + c.Title); 

> 


-G 


Query: Course rows related to Department d 



• Açık yükleme. Varlık ilk kez okunmadıysa ilgili veriler alınmadı. Gerekirse ilgili verileri alan kodu 
yazarsınız. Ayrı sorgularla yükleme durumunda olduğu gibi, açıkça yükleme, veritabanına gönderilen 
birden çok sorgu ile sonuçlanır. Fark, açık yükleme ile kod, yüklenecek gezinti özelliklerini belirtir. Entity 
Framevvork Core 1,1 ' de, açık yükleme yapmak için Load yöntemini kullanabilirsiniz. Örneğin: 

var departments = _context.Departments; 

foreach (Department d in departments)— Query: ali Department TOVVS 

_context.Entry(d).Collection(p => p. 
foreach (Course c in d.Courses) 

{ 

courseList.Add(d.Name + c.Title) 

} 

} 


Courses).Load(); 


Ûuery: Course rows related to Department d 


D 


• Yavaş yükleme. Varlık ilk kez okunmadıysa ilgili veriler alınmadı. Ancak, bir gezinti özelliğine ilk kez 
erişmeye çalıştığınızda, bu gezinti özelliği için gereken veriler otomatik olarak alınır. Bir gezinti 
özelliğinden ilk kez veri almaya çalıştığınızda veritabanına bir sorgu gönderilir. Entity Framevvork Core 
1,0, yavaş yüklemeyi desteklemez. 

Performans değerlendirmeleri 

Alınan her varlık için ilgili verilerin gerekli olduğunu biliyorsanız, tek bir sorgu genellikle en iyi performansı 
sunar, çünkü veritabanına gönderilen tek bir sorgu genellikle alınan her varlık için ayrı sorgulardan daha 
etkilidir. Örneğin, her departmanın on ile ilgili kurs olduğunu varsayalım. Tüm ilgili verilerin bir şekilde 
yüklenmesi, tek bir (JOIN) sorgusuna ve veritabanına yönelik tek gidiş dönüş oluşmasına neden olur. Her 
bölüme yönelik kurslar için ayrı bir sorgu, veritabanı üzerinde on bir gidiş dönüş oluşmasına neden olur. 
Gecikme süresi yüksek olduğunda veritabanına yönelik ek gidiş dönüşler özellikle performansa neden olur. 

Öte yandan, bazı senaryolarda ayrı sorgular daha etkilidir. Tek bir sorgudaki ilgili verilerin tümünü yükleme, 
SOL Server verimli bir şekilde bir birleştirmenin oluşturulmasına neden olabilir ve bu da etkili bir şekilde 
işleyemez. Ya da bir varlığın gezinti özelliklerine yalnızca işlemekte olduğunuz varlıkların kümesinin bir alt 
kümesi için erişmeniz gerekiyorsa, her şeyin en baştan yüklenmesi gerekenden fazla veri alacağından ayrı 
sorgular daha iyi çalışabilir. Performans önemliyse, en iyi seçimi yapmak için her iki şekilde de performansı test 
etmek en iyisidir. 


Kurslar sayfası oluşturma 





















Kurs varlığı, kursun atandığı departmanın departman varlığını içeren bir gezinti özelliği içerir. Bir kurs listesinde 
atanan departmanın adını göstermek için, course.Department Gezinti özelliğindeki departman varlığındaki 
Name özelliğini almanız gerekir. 


Aşağıdaki çizimde gösterildiği gibi, daha önce öğrenciler denetleyicisi için yaptığınız Entity Framevvork desteği 1 
ı kullanarak, M VC denetleyicisi için, görünümler ile aynı seçenekleri kullanarak kurs varlık türü için 
coursescontroller adlı bir denetleyici oluşturun: 


Add Controller X 


Model elass: 

Course (ContosoUniversity.Models) 


V 

Data context elass: 

SchoolContext (ContosoUniversity.Data) 

0 

> 


Views: 

0 Generate views 
0 Reference script libraries 
0 Use a layout page: 

ı ı n 

(Leave empty if it is set in a Razor _viewstart file) 


Controller name: 


CoursesController 


Add 


Cancel 


CoursesController.es 'i açın ve index metodunu inceleyin. Otomatik yapı iskelesi, Department gezinti özelliği 
için inelude yöntemi kullanılarak bir Eager yüklemesi belirtti. 

index yöntemini, kurs varlıklarını döndüren ıçiueryabie için daha uygun bir ad kullanan aşağıdaki kodla 
değiştirin ( schooicontext yerine courses ): 

public async Task<IActionResult> Index() 

{ 

var courses = _context.Courses 
.Include(c => c.Department) 

.AsNoTracking(); 

return View(await courses.ToListAsync()); 


Views/kurslar/lndex. cshtml dosyasını açın ve şablon kodunu aşağıdaki kodla değiştirin. Değişiklikler 
vurgulanır: 












































@model IEnumerablecContosolIniversity .Models .Course> 

@{ 

ViewData["Title"] = "Courses"; 

} 

<h2>Courses</h2> 

<P> 

<a asp-action="Create">Create New</a> 

</p> 

ctable class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model => model.CourselD) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Title) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Credlts) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Department) 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

(Şforeach (var item in Model) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.CourselD) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Title) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Credits) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Department.Name) 

</td> 

<td> 

<a asp-action="Edit" asp-route-id="@item.CourseID">Edit</a> | 

<a asp-action="Details" asp-route-id="@item.CourseID">Details</a> | 
<a asp-action="Delete" asp-route-id="@item.CourseID">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 


Yapı iskelesi kodunda aşağıdaki değişiklikleri yaptınız: 

• Başlık dizinden kurslar olarak değiştirildi. 

• CourselD özellik değerini gösteren bir sayı sütunu eklendi. Birincil anahtarlar, genellikle son kullanıcılara 
anlamlı olduklarından, varsayılan olarak yapı iskelesi göstermemektedir. Ancak, bu durumda birincil 
anahtar anlamlı olur ve göstermek istersiniz. 

• Departman adını göstermek için Departman sütunu değiştirildi. Kod, Department gezinti özelliğine 
yüklenen departman varlığının Name özelliğini görüntüler: 






@Html.DisplayFor(modelItem => item.Department.Name) 


Uygulamayı çalıştırın ve bölüm adlarıyla listeyi görmek için Kurslar sekmesini seçin. 


E3 Courses - Contoso Univ X -)- 


□ X 

^ localhost 58 

☆ 

=- m 

■••••■ 

Contoso University 


— 


Courses 

Create New 


Number Title Credits Department 


1045 

Calculus 

4 

Mathematics 

Edît | Details | Delete 

1050 

Chemistry 

3 

Engineering 

Edit | Details | Delete 

2021 

Composition 

3 

English 

Edit | Details | Delete 


^ 1Q^ ~ Ifcı ıü*~ 4 f i I" ." unu 4 1 0" 

Eğitmenler sayfası oluşturma 

Bu bölümde, Eğitmenler sayfasını görüntülemek için eğitmen varlığı için bir denetleyici ve görünüm 
oluşturacaksınız: 










H Instructors - Contoso Uı X -(- 


- □ X 

—• (J) localhost:5813/lnstructors/lndex/1? 

☆ 

- m û - 

Contoso University 


_ j 


Instructors 


Create New 



First 

Hire 




Last Name 

Name 

Date 

Office 

Courses 


Abercrombie 

Kim 

1995- 


2021 Composition 

Select | Edit | 



03-11 


2042 Literatüre 

Details | Delete 

Fakhouri 

Fadi 

2002- 

Smith 17 

1045 Calculus 

Select | Edit | 



07-06 



Details | Delete 

Harui 

Roger 

1998- 

Gowan 27 

1050 Chemistry 

Select | Edit | 



07-01 


3141 Trigonometry 

Details | Delete 



Courses Taught by Selected İnstructor 



Number 

Title 

Department 

Select 

2021 

Composition 

English 

Select 

2042 

Literatüre 

English 


Students Enrolled in Selected Course 


Name 

Grade 

Alonso, Meredith 

B 

Li, Yan 

B 

t ^ - 

11 1 1 ^ 40 ^^ 


Bu sayfa aşağıdaki yollarla ilgili verileri okur ve görüntüler: 

• Eğitmenler listesi, OfficeAssignment varlığındaki ilgili verileri görüntüler. Eğitmen ve OfficeAssignment 
varlıkları bire sıfır veya-bir ilişkidir. OfficeAssignment varlıkları için Eager yükleme kullanacaksınız. Daha 
önce açıklandığı gibi, birincil tablonun alınan tüm satırları için ilgili verilere ihtiyacınız olduğunda Eager 
yüklemesi genellikle daha etkilidir. Bu durumda, tüm görüntülenen Eğitmenler için Office atamalarını 
göstermek istersiniz. 

• Kullanıcı bir eğitmen seçtiğinde ilgili kurs varlıkları görüntülenir. Eğitmen ve kurs varlıkları çoktan çoğa 
bir ilişkidir. Kurs varlıkları ve ilgili departman varlıkları için Eager yükleme kullanacaksınız. Bu durumda, 
yalnızca seçili eğitmen için kurslar gerektiğinden ayrı sorgular daha verimli olabilir. Ancak, bu örnek, 
gezinti özellikleri' nde olan varlıkların içindeki gezinti özellikleri için Eager yükleme 'nin nasıl 
kullanılacağını gösterir. 

• Kullanıcı bir kurs seçtiğinde, kayıt varlığı kümesindeki ilgili veriler görüntülenir. Kurs ve kayıt varlıkları 
bire çok ilişkisinde. Kayıt varlıkları ve ilgili öğrenci varlıkları için ayrı sorgular kullanacaksınız. 

Eğitmen dizini görünümü için bir görünüm modeli oluşturun 











Eğitmenler sayfasında, üç farklı tablodan alınan veriler gösterilir. Bu nedenle, her biri tablolardan birine ait 
verileri tutan üç özellik içeren bir görünüm modeli oluşturacaksınız. 


SchoolVievvModels klasöründe lnstructorlndexData.cs oluşturun ve mevcut kodu şu kodla değiştirin: 

using System; 

using System.Collections.Generic; 

using System.Linq; 

using System.Threading.Tasks; 

namespace ContosoUniversity.Models.SchoolViewModels 

{ 

public class InstructorIndexData 

{ 

public IEnumerable<Instructor> Instructors { get; set; } 
public IEnumerable<Course> Courses { get; set; } 
public IEnumerable<Enrollment> Enrollments { get; set; } 

} 


Eğitmen denetleyicisi ve görünümleri oluşturma 

Aşağıdaki çizimde gösterildiği gibi EF okuma/yazma eylemleri ile bir eğitmenler denetleyicisi oluşturun: 


Add Controller X 

Model class: v 

Data context class: j^çhööîcönt^^cöntösöÜ^^sîtyDâtâ^ v + 

Views: 

0 Generate views 

F71 Reference script libraries 

0 Use a layout page: 

ı ı n 

(Leave empty if it is set in a Razor _viewstart file) 


Controller name: 


InstructorsController 


Add 


Cancel 


lnstructorsController.es açın ve VievvModel ad alanı için bir using ifadesini ekleyin: 

using ContosoUniversity.Models.SchoolViewModels; 


ilişkili verilerin yüklenmesini ve görünüm modeline koymak için Dizin yöntemini aşağıdaki kodla değiştirin. 






































public async Task<IActionResult> Index(int? id, int? courselD) 

{ 

var viewModel = new InstructorIndexData(); 
viewModel.Instructors = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Enrollments) 

.Thenlnclude(i = > i.Student) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Department) 

.AsNoTracking() 

.OrderBy(i => i.LastName) 

.ToListAsync(); 

if (id != null) 

{ 

ViewData["InstructorID"] = id.Value; 

Instructor instructor = viewModel.Instructors.Where( 
i => i.ID == id.Value).Single(); 

viewModel.Courses = instructor.CourseAssignments.Select(s => s.Course); 

} 

if (courselD != null) 

{ 

ViewData["CourselD"] = courselD.Value; 
viewModel.Enrollments = viewModel.Courses.Where( 

x => x.CourselD == courselD).Single().Enrollments; 

} 

return View(viewModel); 

} 

Yöntemi, seçilen eğitmenin ve seçili kursun KİMLİK değerlerini sağlayan isteğe bağlı yol verilerini ( id ) ve bir 
sorgu dizesi parametresini ( courselD ) kabul eder. Parametreler, sayfadaki Köprü seçme ile sağlanır. 

Kod, görünüm modelinin bir örneğini oluşturarak ve bu örneğe eğitmen listesine yerleştirilerek başlar. Kod, 
instructor.OfficeAssignment ve instructor.courseAssignments gezinti özellikleri için Eager yüklemeyi belirtir. 
CourseAssignments Özelliği içinde, Course Özelliği yüklenir ve bunun içinde, Enrollments ve Department 
özellikleri yüklenir ve her Enroiiment varlığı içinde student özelliği yüklenir. 

viewModel.Instructors = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Enrollments) 

.Thenlnclude(i => i.Student) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Department) 

.AsNoTracking() 

.OrderBy(i => i.LastName) 

.ToListAsync(); 


Görünüm her zaman OfficeAssignment varlığını gerektirdiğinden, bunu aynı sorguda getirmek daha etkilidir. 
Web sayfasında bir eğitmen seçildiğinde kurs varlıkları gereklidir, bu yüzden tek bir sorgu birden çok sorgudan 
daha iyidir, bu nedenle yalnızca sayfa, hiçbir zaman tarafından seçilen bir kurs ile daha sık görüntüleniyorsa. 


course iki özelliği gerektiğinden, kod CourseAssignments yinelenir ve course. Theninciude çağrılarının ilk 
dizesi CourseAssignment.Course , Course.Enrollments ve Enrollment.Student alır. 















vieiA/Model. Instructors = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i = > i.Course) 

.Thenlnclude(i = > i.Enrollments) 

.Thenlnclude(i = > i.Student) 

.Include(i => i.CounseAssignments) 

.Thenlnclude(i => i.Counse) 

.Thenlnclude(i => i.Depantment) 

.AsNoTnacking() 

.OndenBy(i => i.LastName) 

.ToListAsync(); 

Kodun bu noktasında, başka bir Theninciude , gerekli student gezinti özellikleri için olacaktır. Ancak inciude 
çağrılması instnucton özellikleriyle çalışmaya başlar, bu kez, bu kez counse.Ennoliments yerine 
Counse.Department belirterek zinciri yeniden gitmeniz gerekir. 

viewModel.Instructors = await _context.Instnuctons 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i = > i.Ennollments) 

.Thenlnclude(i = > i.Student) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i = > i.Course) 

.Thenlnclude(i => i.Department) 

.AsNoTracking() 

.OrderBy(i => i.LastName) 

.ToListAsync(); 


Aşağıdaki kod, bir eğitmen seçildiğinde yürütülür.Seçilen eğitmen, görünüm modelindeki eğitmenler 
listesinden alınır. Görünüm modelinin courses özelliği daha sonra bu eğitmenin courseAssignments gezinti 
özelliğinden kurs varlıklarıyla yüklenir. 

if (id != null) 

{ 

ViewData["InstructorID"] = id.Value; 

Instructor instructor = viewModel.Instructors.Where( 
i => i.ID == id.Value).Single(); 

viewModel.Courses = instructor.CourseAssignments.Select(s => s.Course); 

} 

where yöntemi bir koleksiyon döndürür, ancak bu yönteme geçirilen kriterler yalnızca tek bir eğitmen varlığının 
döndürüldüğünden sonuçlanır, single yöntemi, koleksiyonu tek bir eğitmen varlığına dönüştürür, bu da o 


CourseAssignments 

özelliğine erişmenizi sağlar. 

CourseAssignments 

özelliği, yalnızca ilgili 

Course 


varlıklarını istediğiniz courseAssignment varlıkları içerir. 

Koleksiyonun yalnızca bir öğesi olacağını bildiğiniz durumlarda single yöntemini bir koleksiyonda 
kullanırsınız. Tek yöntem, koleksiyon boş veya birden fazla öğe varsa bir özel durum oluşturur. Bir alternatif, 
koleksiyon boşsa varsayılan bir değer (Bu durumda null) döndüren singleOrDefault . Bununla birlikte, bu 
durumda yine de bir özel durumla sonuçlanacaktır (null başvuru üzerinde courses özelliği bulmaya çalışırken) 
ve özel durum iletisi sorunun nedenini daha az gösterir, single yöntemini çağırdığınızda, ayrıca where 
yöntemini ayrı çağırmak yerine WHERE koşulunu da geçirebilirsiniz: 

•Single(i => i.ID == id.Value) 


Onun yerine: 























.Where(i => i.ID == id.Value).Single() 


Ardından, bir kurs seçilmişse, seçilen kurs, görünüm modelindeki kurslar listesinden alınır.Ardından, görünüm 
modelinin Enroiiments özelliği, bu kursun Enroiiments gezinti özelliğinden kayıt varlıklarıyla yüklenir. 


if (courselD != null) 

{ 

ViewData["CourselD"] = courselD.Value; 
viewModel.Enrollments = viewModel.Courses.Where( 

x => x.CourselD == courselD).Single().Enrollments; 

} 


Eğitmen dizini görünümünü değiştirme 

Views/eğitmenler/lndex. cs/ıfm/içinde, şablon kodunu aşağıdaki kodla değiştirin. Değişiklikler vurgulanır. 







@model ContosoUniversity.Models.SchoolViewModels.InstructorIndexData 

@{ 

ViewData["Title"] = "Instructors"; 

} 

<h2>Instructors</h2> 

<P> 

<a asp-action="Create">Create New</a> 

</p> 

<table class="table"> 

<thead> 

<tr> 

<th>Last Name</th> 

<th>First Name</th> 

<th>Hire Date</th> 

<th>Office</th> 

<th>Courses</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

Şforeach (var item in Model.Instructors) 

{ 

string selectedRow = 

if (item.ID == (int?)ViewData["InstructorlD"]) 

{ 

selectedRow = "success"; 

} 

<tr class="@selectedRow"> 

<td> 

@Html.DisplayFor(modelItem => item.LastName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.FirstMidName) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.HireDate) 

</td> 

<td> 

Şif (item.OfficeAssignment != null) 

{ 

(Şitem.OfficeAssignment. Location 

} 

</td> 

<td> 

foreach (var course in item.CourseAssignments) 

{ 

Şcourse.Course.CourselD Şcourse.Course.Title <br /> 

} 

} 

</td> 

<td> 

<a asp-action="Index" asp-route-id="@item.ID">Select</a> | 

<a asp-action="Edit" asp-route-id="@item.ID">Edit</a> | 

<a asp-action="Details" asp-route-id="@item.ID">Details</a> | 

<a asp-action="Delete" asp-route-id="@item.ID">Delete</a> 

</td> 

</tr> 

} 

</tbody> 

</table> 


Varolan koda aşağıdaki değişiklikleri yaptınız: 



• Model sınıfı InstructorIndexData olarak değiştirildi. 


• Sayfa başlığı dizinden eğitmenlerolarak değiştirildi. 

• Yalnızca item.OfficeAssignment null olmaması durumunda item.OfficeAssignment.Location 
görüntüleyen bir Office sütunu eklendi. (Bu bire sıfır veya-bir ilişki olduğundan ilgili bir 
OfficeAssignment varlığı bulunmayabilir.) 

@if (İtem.OfficeAssignment != null) 

{ 

@item.OfficeAssignment.Location 

} 

• Her bir eğitmen tarafından taders kurslarını görüntüleyen bir Kurslar sütunu eklendi. Daha fazla bilgi 
için Razor söz dizimi makalesinin Açık çizgi geçişi bölümüne bakın. 

• Seçilen eğitmenin tr öğesine dinamik olarak ciass="success" ekleyen kod eklendi. Bu, bir önyükleme 
sınıfı kullanarak seçili satır için bir arka plan rengi ayarlar. 

string selectedRow = 

if (item.ID == (int?)ViewData["InstructorID"]) 

{ 

selectedRow = "success"; 

} 

<tr class="@selectedRow"> 

• Her satırdaki diğer bağlantılardan hemen önce Seç etiketli yeni bir köprü eklendiğinde, SEÇİLEN 
eğitmenin kimliğinin index yöntemine gönderilmesine neden olur. 

<a asp-action="Index" asp-route-id="@item.ID">Select</a> | 

Uygulamayı çalıştırın ve eğitmenler sekmesini seçin. Sayfa ilgili OfficeAssignment varlıklarının Location 

özelliğini ve ilişkili OfficeAssignment varlığı olmadığında boş bir tablo hücresini görüntüler. 
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Abercrombie 

Kim 
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2021 Composition 

Select | Edit | 



11 


2042 Literatüre 

Details | Delete 

Fakhouri 

Fadi 

2002-07- 

Smith 17 

1045 Calculus 

Select | Edit | 



06 



Details | Delete 



Views/eğitmenler/lndex. cshtml dosyasında, Kapanış tablosu öğesinden sonra (dosyanın sonunda) aşağıdaki 
kodu ekleyin. Bu kod, bir eğitmen seçildiğinde bir eğitmenin ilgili kursların bir listesini görüntüler. 















@if (Model.Courses != null) 

{ 

<h3>Courses Taught by Selected Instructor</h3> 
ctable class="table"> 

<tr> 

<thx/th> 

<th>Number</th> 

<th>Title</th> 

<th>Department</th> 

</tr> 

@foreach (var item in Model.Courses) 

{ 

string selectedRow = 

if (item.CourselD == (int?)ViewData["CourseID"]) 

{ 

selectedRow = "success"; 

} 

<tr class="@selectedRow"> 

<td> 

@Html.ActionLink("Select", "Index", new { courselD = item.CourselD }) 

</td> 

<td> 

@item.CourselD 
</td> 

<td> 

(Şitem.Title 

</td> 

<td> 

@item.Department.Name 
</td> 

</tr> 

} 

</table> 

} 

Bu kod, kurs listesini görüntülemek için görünüm modelinin courses özelliğini okur. Ayrıca, seçilen kursun 
KİMLİĞİNİ index Action yöntemine gönderen bir seçme Köprüsü de sağlar. 

Sayfayı yenileyin ve bir eğitmen seçin. Artık Seçili eğitmenin atandığı kursları görüntüleyen bir kılavuz 
görürsünüz ve her kurs için atanan departmanın adını görürsünüz. 
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Yeni eklediğiniz kod bloğundan sonra aşağıdaki kodu ekleyin. Bu, kurs seçildiğinde bir kursa kaydedilen 
öğrencilerin listesini görüntüler. 

@if (Model.Enrollments != null) 

{ 

<h3> 

Students Enrolled in Selected Course 
</h3> 

<table class="table"> 

<tr> 

<th>Name</th> 

<th>Grade</th> 

</tn> 

(Sforeach (var item in Model.Enrollments) 

{ 

<tr> 

<td> 

(Şitem.Student.FullName 
</td> 

<td> 

@Html.DisplayFor(modelItem => item.Grade) 

</td> 

</tr> 

} 

</table> 


Bu kod, kursa kayıtlı öğrencilerin listesini görüntülemek için görünüm modelinin kayıtları özelliğini okur. 

Sayfayı yeniden yenileyip bir eğitmen seçin. Ardından, kayıtlı öğrenciler ve bunların onların listesini görmek için 
bir kurs seçin. 
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Courses Taught by Selected İnstructor 



Number 

Title 

Department 

Select 

2021 

Composition 

English 

Select 

2042 

Literatüre 

English 


Contoso University 


Students Enrolled in Selected Course 

Name 

Grade 

Alonso, Meredith 

B 

Li, Yan 

B 



Açık yükleme hakkında 

lnstructorsController.es' de eğitmenler listesini aldığınızda, courseAssignments gezinti özelliği için bir Eager 
yüklemesi belirttiniz. 

Kullanıcılardan yalnızca, seçili bir eğitmenin ve kursla kayıtlarını yalnızca nadiren görmek istediğini varsayalı 
Bu durumda, kayıt verilerini yalnızca istenirse yüklemek isteyebilirsiniz. Açık yüklemenin nasıl yapılacağını 
gösteren bir örnek görmek için index yöntemini aşağıdaki kodla değiştirin, bu da kayıtları için Eager 
yüklemesini kaldırır ve bu özelliği açıkça yükler. Kod değişiklikleri vurgulanır. 












public async Task<IActionResult> Index(int? id, int? courselD) 

{ 

var viewModel = new InstructorIndexData(); 
viewModel.Instructors = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.Thenlnclude(i => i.Department) 

.OrderBy(i => i.LastName) 

.ToListAsync(); 

if (id != null) 

{ 

ViewData["InstructorID"] = id.Value; 

Instructor instructor = viewModel.Instructors.Where( 
i => i.ID == id.Value).Single(); 

viewModel.Courses = instructor.CourseAssignments.Select(s => s.Course); 


if (courselD != null) 

{ 

ViewData["CourselD"] = courselD.Value; 

var selectedCourse = viewModel.Courses.Where(x => x.CourselD == courselD) .Single(); 
await _context.Entry(selectedCourse).Collection(x => x.Enrollments).LoadAsync(); 
foreach (Enrollment enrollment in selectedCourse.Enrollments) 

{ 

await _context.Entry(enrollment).Reference(x => x.Student).LoadAsync(); 

} 

viewModel.Enrollments = selectedCourse.Enrollments; 

} 

return View(viewModel); 


Yeni kod, eğitmen varlıklarını alan koddan kayıt verileri için Thenmclude Yöntem çağrılarını bırakır. Ayrıca 
AsNoTracking bırakır. Bir eğitmen ve kurs seçilirse, vurgulanan kod seçili kurs için kayıt varlıklarını ve her kayıt 
için öğrenci varlıklarını alır. 

Uygulamayı çalıştırın, şimdi eğitmenler dizin sayfasına gidin ve sayfada görüntülendikleriyle ilgili hiçbir fark 
görmezsiniz; ancak verilerin nasıl alındığını değiştirmiş olursunuz. 

Kodu alın 

Tamamlanmış uygulamayı indirin veya görüntüleyin. 

Sonraki adımlar 

Bu öğreticide şunları yaptınız: 

• ilgili verileri yükleme hakkında öğrenilen 

• Bir kurslar sayfası oluşturuldu 

• Bir eğitmenler sayfası oluşturuldu 

• Açık yükleme hakkında bilgi edinildi 

ilgili verileri güncelleştirme hakkında bilgi edinmek için sonraki öğreticiye ilerleyin, 
ilgili verileri güncelleştirme 



Öğretici: ilgili verileri güncelleştirme-ASRNET MVC 
EF Core 

11.10.2019 • 27 minutes to read ı Edit Online 


Önceki öğreticide ilgili verileri görüntülediyseniz; Bu öğreticide, yabancı anahtar alanlarını ve gezinti özellikleri 
güncelleştirerek ilgili verileri güncelleştireceksiniz. 


Aşağıdaki çizimlerde, üzerinde çalıştığınız sayfaların bazıları gösterilmektedir. 
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Bu öğreticide şunları yaptınız: 

• Kurslar sayfalarını özelleştirme 

• Eğitmenler düzenleme sayfası ekle 

• Düzenleme sayfasına kurslar ekleyin 

• Güncelleştirme silme sayfası 

• Sayfa oluşturmak için Office konumu ve kurslar ekleme 

Önkoşullar 

• ilgili verileri okuma 

Kurslar sayfalarını özelleştirme 

Yeni bir kurs varlığı oluşturulduğunda, mevcut bir departmanla bir ilişkisi olmalıdır. Bunu kolaylaştırmak için, yapı 
iskelesi kodu denetleyici yöntemlerini içerir ve departmanı seçmeye yönelik bir açılan liste içeren görünümler 
oluşturup düzenleyebilir. Açılır liste course.DepartmentiD yabancı anahtar özelliğini ayarlar ve ilgili departman 
varlığıyla Department gezinti özelliğini yüklemek için tüm Entity Framework ihtiyacı vardır.Scafkatmış kodu 
kullanacaksınız, ancak hata işleme eklemek ve açılan listeyi sıralamak için biraz değişiklik yapacaksınız. 

CoursesController.es' de, dört oluşturma ve düzenleme yöntemini silin ve bunları şu kodla değiştirin: 















public IActionResult Create() 

{ 

PopulateDepartmentsDropDownList(); 
return View(); 

} 


[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Create([BindC'CourselDjCreditSjDepartmentIDjTitle")] Course course) 

{ 

if (ModelState.IsValid) 

{ 

_context.Add(course); 

await _context.SaveChangesAsync(); 

return RedirectToAction(nameof(Index)); 

} 

PopulateDepartmentsDropDownList(course.DepartmentID); 
return View(course); 


public async Task<IActionResult> Edit(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var course = await _context.Courses 
.AsNoTracking() 

.FirstOrDefaultAsync(m => m.CourselD == id); 
if (course == null) 

{ 

return NotFound(); 

} 

PopulateDepartmentsDropDownList(course.DepartmentID); 
return View(course); 







[HttpPost, ActionName("Edit")] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> EditPost(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var courseToUpdate = await _context.Courses 

.FirstOrDefaultAsync(c => c.CourselD == id); 

if (await TryUpdateModelAsync<Course>(courseToUpdate, 

i 

c => c.Credits, c => c.DepartmentlD, c => c.Title)) 

{ 

try 

{ 

await _context. SaveChangesAsync(); 

} 

catch (DbUpdateException /* ex */) 

{ 

//Log the error (uncomment ex variable name and write a log.) 
ModelState.AddModelError("", "Unable to save changes. " + 

"Try again, and if the problem persists, " + 

"see your system administrator."); 

} 

return RedirectToAction(nameof(Index)); 

} 

PopulateDepartmentsDropDownList(courseToUpdate.DepartmentID); 
return View(courseToUpdate); 


@No__t-0 HttpPost yönteminden sonra, açılan liste için departman bilgisini yükleyen yeni bir yöntem oluşturun. 

private void PopulateDepartmentsDropDownList(object selectedDepartment = null) 

{ 

var departmentsQuery = from d in _context.Departments 
orderby d.Name 
select d; 

ViewBag.DepartmentID = new SelectList(departmentsQuery.AsNoTrackingO, "DepartmentlD", "Name", 
selectedDepartment); 

} 

@No__t-0 yöntemi, ada göre sıralanmış tüm bölümlerin bir listesini alır, açılan liste için bir selectList 
koleksiyonu oluşturur ve koleksiyonu viewBag ' deki görünüme geçirir. Yöntemi, çağıran kodun, açılan liste 
işlendiğinde seçilecek öğeyi belirtmesini sağlayan isteğe bağlı selectedDepartment parametresini kabul eder. 
Görünüm, "DepartmentlD" adını <seiect> etiketi yardımcısından geçireceğini ve yardımcı sonra, 
"DepartmentlD" adlı bir SelectList için viewBag nesnesine baktığınızın bilmesini sağlar. 

HttpGet Create yöntemi, bölüm henüz kurulmadığı için, yeni bir kurs için seçili öğeyi ayarlamadan 
PopulateDepartmentsDropDownList yöntemini çağırır: 

public IActionResult Create() 

{ 

PopulateDepartmentsDropDownList(); 
return View(); 

} 


HttpGet Edit yöntemi, düzenlenen kursa zaten atanmış departmanın KIMLIğINE bağlı olarak seçili öğeyi 














ayarlar: 


public async Task<IActionResult> Edit(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var course = await _context.Courses 
.AsNoTracking() 

.FirstOrDefaultAsync(m => m.CourselD == id); 
if (course == null) 

{ 

return NotFound(); 

} 

PopulateDepartmentsDropDownList(course.DepartmentID); 
return View(course); 

} 

Hem Create hem de Edit için HttpPost yöntemleri, bir hatadan sonra sayfayı yeniden görüntülerken seçili 
öğeyi ayarlayan kodu da içerir. Bu, sayfa hata iletisini göstermek için yeniden görüntülendiğinde, seçilen 
departmanın seçili kalır olduğunu sağlar. 

Ekleyemiyorum. Ayrıntı ve silme yöntemlerine AsNoTracking 

Kurs ayrıntılarının ve sayfa silmenin performansını iyileştirmek için, Details ve HttpGet Delete yöntemlerine 
AsNoTracking çağrıları ekleyin. 

public async Task<IActionResult> Details(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var course = await _context.Courses 
.Include(c => c.Department) 

.AsNoTracking() 

.FirstOrDefaultAsync(m => m.CourselD == id); 
if (course == null) 

{ 

return NotFound(); 

} 

return View(course); 

} 







public async Task<IActionResult> Delete(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var course = await _context.Courses 
.Include(c => c.Department) 

.AsNoTracking() 

.FirstOrDefaultAsync(m => m.CourselD == id); 
if (course == null) 

{ 

return NotFound(); 

} 

return View(course); 

} 


Kurs görünümlerini değiştirme 

Görünümler/kurslar/oluşturma, cshtml'de, Departman açılan listesine bir "Departman Seç" seçeneği ekleyin, 
DepartmentlD etiketini bölümolarak değiştirin ve bir doğrulama iletisi ekleyin. 

<div class="form-group"> 

clabel asp-for="Department" class="control-label"x/label> 

<select asp-for="DepartmentID" class="form-control" asp-items="ViewBag.DepartmentID"> 

<option value="">-- Select Department --</option> 

</select> 

<span asp-validation-for="DepartmentID" class="text-danger" /> 


Görünümler/kurslar/Düzenle. cshtml'de, Create. cshfm/içinde yaptığınız departman alanı için aynı değişikliği 
yapın. 

Ayrıca, Görünümler/kurslar/Düzenle. cshtml'de başlık alanından önce bir kurs numarası alanı ekleyin. Kurs 
numarası birincil anahtar olduğundan, görüntülenir, ancak değiştirilemez. 

<div class="form-group"> 

<label asp-for="CourseID" class="control-label"x/label> 

<div>@Html.DisplayFor(model => model.CourseID)</div> 

</div> 

Düzenleme görünümündeki kurs numarası için gizli bir alan ( <input type="hidden"> ) zaten var.@No__t-0 etiketi 
Yardımcısı eklemek, Kullanıcı düzenleme sayfasında Kaydet 1 i tıklattığında, kurs numarasının gönderilen 
verilere dahil edilmesini neden olmadığı için gizli alanın gereksinimini ortadan kaldırmaz. 

Görünümler/kurslar/delete. cshtml'de, üst kısımdaki bir kurs numarası alanı ekleyin ve bölüm kimliğini bölüm adı 
olarak değiştirin. 










@model Contosollniversity.Models.Course 

@{ 

ViewData["Title"] = "Delete"; 

} 

<h2>Delete</h2> 

<h3>Are you sure you want to delete this?</h3> 

<div> 

<h4>Course</h4> 

<hr /> 

<dl class="row"> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.CourselD) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.CourselD) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Title) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Title) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Credits) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Credits) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Department) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Department.Name) 

</dd> 

</dl> 

<form asp-action="Delete"> 

<div class="form-actions no-color"> 

<input type="submit" value="Delete" class="btn btn-default" /> | 
<a asp-action="Index">Back to List</a> 

</div> 

</form> 

</div> 


Görünümler/kurslar/ayrıntılar. cshtml'de, delete. cshtmllçm yaptığınız aynı değişikliği yapın. 

Kurs sayfalarını test etme 

Uygulamayı çalıştırın, Kurslar sekmesini seçin, Yeni oluştur' a tıklayın ve yeni bir kurs için veri girin: 




H Create - C< X + 

Ç_) localhost:581 


Contoso University 


Create 

Course 

Number 

1000 

Tîtle 

Algebra 

Credits 

5 

Department 

Mathematics 


X 


☆ 


Create 


Oluştur'a tıklayın. Kurslar Dizin sayfası, listeye eklenen yeni kursla birlikte görüntülenir. Dizin sayfası listesindeki 
departman adı, ilişkinin doğru şekilde oluşturulduğunu gösteren gezinti özelliğinden gelir. 

Kurslar Dizin sayfasında bir kursa Düzenle 1 ye tıklayın. 

















H Edit-Coı X 

+ - □ X 

<- o | 

localhost ■şüf 

Contoso University = 


Edit 

Course 

Number 

1000 

Title 

Algebra 2| 

Credits 

5 

Department 

Mathematics 

Save 


Sayfadaki verileri değiştirin ve Kaydet' e tıklayın. Kurslar Dizin sayfası, güncelleştirilmiş kurs verileriyle birlikte 
görüntülenir. 

Eğitmenler düzenleme sayfası ekle 

Bir eğitmen kaydını düzenlediğinizde, eğitmenin Office atamasını güncelleştirebilmek istersiniz. Eğitmen varlığı, 
OfficeAssignment varlığıyla bire sıfır veya-arasında bir ilişkiye sahiptir; bu, kodunuzun aşağıdaki durumları 
işlemesi gerektiği anlamına gelir: 

• Kullanıcı Office atamasını temizlediğinde ve başlangıçta bir değere sahipse, OfficeAssignment varlığını 
silin. 

• Kullanıcı bir Office atama değeri girerse ve başlangıçta boşsa, yeni bir OfficeAssignment varlığı oluşturun. 

• Kullanıcı bir Office atamasının değerini değiştirirse, var olan bir OfficeAssignment varlığındaki değeri 
değiştirin. 

Eğitmenler denetleyicisini güncelleştirme 

lnstructorsController.es' de, httpget Edit yöntemindeki kodu değiştirerek eğitmen varlığının OfficeAssignment 
gezinti özelliğini yükler ve AsNoTnacking ' i çağırır: 














public async Task<IActionResult> Edit(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var instructor = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.AsNoTracking() 

.FirstOrDefaultAsync(m => m.ID == id); 
if (instructor == null) 

{ 

return NotFound(); 

} 

return View(instructor); 


Office atama güncelleştirmelerini işlemek için HttpPost Edit yöntemini aşağıdaki kodla değiştirin: 

[HttpPost, ActionName("Edit")] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> EditPost(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var instructorToUpdate = await _context.Instructors 
.Include(i => İ.OfficeAssignment) 

.FirstOrDefaultAsync(s => s.ID == id); 

if (await TryUpdateModelAsync<Instructor>( 

İnstructorToUpdate, 

i 

i => i.FirstMidName, i => i.LastName, i => i.HireDate, i => i.OfficeAssignment)) 

{ 

if (String.IsNullOrWhiteSpace(İnstructorToUpdate.OfficeAssignment?.Location)) 

{ 

İnstructorToUpdate.OfficeAssignment = null; 

} 

try 

{ 

await _context.SaveChangesAsync(); 

} 

catch (DbUpdateException /* ex */) 

{ 

//Log the error (uncomment ex variable name and write a log.) 
ModelState.AddModelError("", "Unable to save changes. " + 

"Try again, and if the problem persists, " + 

"see your system administrator."); 

} 

return RedirectToAction(nameof(Index)); 

} 

return View(instructorToUpdate); 


Kod şunları yapar: 

• imza artık HttpGet Edit yöntemiyle aynı olduğundan ( ActionName özniteliği /Edit/ URL'sinin hala 
kullanıldığını belirten), yöntem adını EditPost olarak değiştirir. 

• @No__t-0 gezinti özelliği için Eager yükleme kullanarak geçerli eğitmen varlığını veritabanından alır.Bu, 








HttpGet Edit yönteminde yaptığınız şeydir. 

• Alınan eğitmen varlığını model Ciltçideki değerlerle güncelleştirir.@No__t-0 aşırı yüklemesi, dahil etmek 
istediğiniz özellikleri beyaz listelemenize olanak sağlar. Bu, ikinci öğreticideaçıklandığı gibi, daha fazla 
nakletmeyi önler. 

if (await TryUpdateModelAsync<Instructor>( 
instructorToUpdate, 

3 

i => i.FirstMidName, i => i.LastName, i => i.HireDate, i => i.OfficeAssignment)) 


• Office konumu boşsa, OfficeAssignment tablosundaki ilgili satırın silinebilmesi için eğitmen. 
OfficeAssignment özelliğini null olarak ayarlar. 

if (String.IsNullOrWhiteSpace(instructorToUpdate.OfficeAssignment?.Location)) 

{ 

instructorToUpdate.OfficeAssignment = nullj 

} 


• Değişiklikleri veritabanına kaydeder. 

Eğitmen düzenleme görünümünü güncelleştirme 

Görünümler/eğitmenler/Edit. cshtml' de, Kaydet düğmesinin sonundaki Office konumunu düzenlemek için yeni 
bir alan ekleyin: 

<div class="form-group"> 

clabel asp-for="OfficeAssignment. Location" class="control-label"x/label> 
cinput asp-for="OfficeAssignment. Location" class="form-contr'ol" /> 

<span asp-validation-for="OfficeAssignment.Location" class="text-danger" /> 

</div> 


Uygulamayı çalıştırın, eğitmenler sekmesini seçin ve ardından bir eğitmende Düzenle 1 ye tıklayın. Office 
konumunu değiştirin ve Kaydet 1 e tıklayın. 







B Edit - 1 X 

+ - □ X 

<- O 

localhost 

Contoso University — 


Edit 

Instructor 

Last Name 

Abercrombîe 

First Name 

Kim 

Hire Date 

3/11/1995 

Office Location 

44/3 P| 

Save 


Düzenleme sayfasına kurslar ekleyin 

Eğitmenler, istediğiniz sayıda kurs öğretebil ir. Artık, aşağıdaki ekran görüntüsünde gösterildiği gibi, bir grup onay 
kutusu kullanarak kurs atamalarını değiştirme özelliğini ekleyerek eğitmen düzenleme sayfasını geliştirirsiniz: 














B Edit - Contoso Universit X 

+ 

□ X 

<r -> O 

localhost:5813/l şif 

=- 

Contoso University 


— 


Edit 


Instructor 

Last Name 

Abercrombie 

First Name 

Kim 

Hire Date 

3/11/1995 

Office Location 

44/3P 

□ 1000 Algebra 2 □ 1045 Calculus □ 1050 Chemistry 

0 2021 Composition 0 2042 Literatüre 03141 Trigonometry 

□ 4022 MicroeconomicsD 4041 Macroeconomics 

Save 



Kurs ve eğitmen varlıkları arasındaki ilişki çoktan çoğa olur, ilişki eklemek ve kaldırmak için, kurs ekleme ve kurs, 
katılımcı varlık kümesine ekleme ve kaldırma. 

Bir eğitmenin hangi kurslara atandığını değiştirmenize olanak sağlayan kullanıcı arabirimi bir grup onay kutusu 
olur. Veritabanındaki her kurs için bir onay kutusu görüntülenir ve eğitmenin Şu anda atanmış olduğu yer seçilidir. 
Kullanıcı kurs atamalarını değiştirmek için onay kutularını seçebilir veya temizleyebilir. Kurs sayısı çok fazlaysa, 
büyük olasılıkla görünümde verileri göstermek için farklı bir yöntem kullanmak isteyeceksiniz, ancak ilişkiler 
oluşturmak veya silmek için bir JOIN varlığını işlemek için aynı yöntemi kullanmanız gerekir. 

Eğitmenler denetleyicisini güncelleştirme 

Onay kutuları listesinin görünümüne veri sağlamak için bir görünüm modeli sınıfı kullanacaksınız. 
SchoolVievvModels klasöründe AssignedCourseData.es oluşturun ve mevcut kodu şu kodla değiştirin: 














using System; 

using System.Collections.Generic; 

using System.Linq; 

using System.Threading.Tasks; 

namespace ContosoUniversity.Models.SchoolViewModels 

{ 

public class AssignedCounseData 

{ 

public int CourselD { get; set; } 
public string Title { get; set; } 
public bool Assigned { get; set; } 

} 

} 

lnstructorsController.es' de, httpget Edit yöntemini aşağıdaki kodla değiştirin. Değişiklikler vurgulanır. 

public async Task<IActionResult> Edit(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var instructor = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments).Thenlnclude(i => i.Course) 

.AsNoTracking() 

.FirstOrDefaultAsync(m => m.ID == id); 
if (instructor == null) 

{ 

return NotFound(); 

} 

PopulateAssignedCourseData(instructor); 
return View(instructor); 

} 

private void PopulateAssignedCourseData(Instructor instructor) 

{ 

var allCourses = _context.Courses; 

var instructorCourses = new HashSet<int>(instructor.CourseAssignments.Select(c => c.CourselD)); 
var viewModel = new List<AssignedCourseData>(); 
foreach (var course in allCourses) 

{ 

viewModel.Add(new AssignedCourseData 

{ 

CourselD = course.CourselD, 

Title = course.Title, 

Assigned = instructorCourses.Contains(course.CourselD) 

}); 

} 

ViewData["Courses"] = viewModel; 

} 

Kod, Courses gezinti özelliği için Eager yüklemesi ekler ve AssignedCourseData View model sınıfını kullanarak 
onay kutusu dizisine bilgi sağlamak için yeni PopulateAssignedCourseData yöntemini çağırır. 

@No__t-0 yöntemindeki kod, görünüm modeli sınıfını kullanarak bir kurs listesi yüklemek için tüm kurs 
varlıklarını okur. Kod, her kurs için, kursun courses gezinti özelliğinde mevcut olup olmadığını denetler. 
Eğitmenin bir kurs atanıp atanmadığını denetlerken etkili arama oluşturmak için, eğitmene atanan kurslar 
HashSet koleksiyonuna konur. @No__t-0 özelliği, eğitmenin atandığı kurslar için true olarak ayarlanır.Görünüm, 
hangi onay kutularının seçili olarak gösterileceğini belirlemede bu özelliği kullanır. Son olarak, liste viewData 1 














daki görünüme geçirilir. 


Sonra, Kullanıcı Kaydet' i tıklattığında yürütülen kodu ekleyin. @No__t-0 yöntemini aşağıdaki kodla değiştirin ve 
eğitmen varlığının courses gezinti özelliğini güncelleştiren yeni bir yöntem ekleyin. 

[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Edit(int? id, string[] selectedCourses) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var İnstructorToUpdate = await _context.Instructors 
.Include(i => i.OfficeAssignment) 

.Include(i => i.CourseAssignments) 

.Thenlnclude(i => i.Course) 

.FirstOrDefaultAsync(m => m.ID == id); 

if (await TryUpdateModelAsync<Instructor>( 

İnstructorToUpdate, 

i 

i => i.FirstMidName, i => i.LastName, i => i.HireDate, i => i.OfficeAssignment)) 

{ 

if (String.IsNullOrWhiteSpace(İnstructorToUpdate.OfficeAssignment?.Location)) 

{ 

İnstructorToUpdate.OfficeAssignment = null; 

} 

UpdatelnstructorCourses(selectedCourses, İnstructorToUpdate); 
try 
{ 

await _context.SaveChangesAsync(); 

} 

catch (DbUpdateException /* ex */) 

{ 

//Log the error (uncomment ex variable name and write a log.) 

ModelState.AddModelError("", "Unable to save changes. " + 

"Try again, and if the problem persists, " + 

"see your system administrator."); 

} 

return RedirectToAction(nameof(Index)); 

} 

UpdatelnstructorCourses(selectedCourses, İnstructorToUpdate); 

PopulateAssignedCourseData(İnstructorToUpdate); 
return View(instructorToUpdate); 






private void UpdateInstructorCourses(string[] selectedCourses, Instructor instructorTolIpdate) 

{ 

if (selectedCourses == null) 

{ 

instructorToUpdate.CourseAssignments = new List<CourseAssignment>(); 
return; 

} 

var selectedCoursesHS = new HashSet<string>(selectedCourses); 
var İnstructorCourses = new HashSet<int> 

(instructorToUpdate.CourseAssignments.Select(c => c.Course.CourselD)); 
foreach (var course in _context.Courses) 

{ 

if (selectedCoursesHS.Contains(course.CourseID.ToString())) 

{ 

if (!instructorCourses.Contains(course.CourselD)) 

{ 

İnstructorTolIpdate.CourseAssignments.Add(new CourseAssignment { InstructorlD = 
İnstructorTolIpdate.IDj CourselD = course.CourselD }); 

} 

} 

else 

{ 

if (instructorCourses.Contains(course.CourselD)) 

{ 

CourseAssignment courseToRemove = İnstructorTolIpdate.CourseAssignments.FirstOrDefault(i => 
i.CourselD == course.CourselD); 

_context.Remove(courseToRemove); 

} 

} 

} 

} 

Yöntem imzası artık HttpGet Edit yönteminden farklıdır, bu nedenle Yöntem adı EditPost 'den Edit 1 ye geri 
değişir. 

Görünüm bir kurs varlıkları koleksiyonuna sahip olmadığından, model Bağlayıcısı CourseAssignments gezinti 
özelliğini otomatik olarak güncelleştiremez. @No__t-0 gezinti özelliğini güncelleştirmek için model cildi 
kullanmak yerine, bunu yeni updateinstructorCourses yönteminde yapmanız gerekir. Bu nedenle, 
CourseAssignments özelliğini model bağlamadan hariç bırakmanız gerekir. Bu, TryupdateModei ' i çağıran kodda 
herhangi bir değişiklik yapılmasını gerektirmez ve bu nedenle, beyaz liste aşırı yüklemesini kullandığınızdan ve 
CourseAssignments ekleme listesinde yer almayız. 

Hiçbir onay kutusu seçilmediyse, updateinstructorCourses 1 daki kod, CourseAssignments gezinti özelliğini boş bir 
koleksiyonla başlatır ve döndürür: 














private void UpdateInstructorCourses(string[] selectedCourses, Instructor instructorToUpdate) 

{ 

if (selectedCourses == null) 

{ 

İnstructorToUpdate.CourseAssignments = new List<CourseAssignment>(); 
return; 

} 

var selectedCoursesHS = new HashSet<string>(selectedCourses); 
var instructorCourses = new HashSet<int> 

(instructorTollpdate.CourseAssignments.Select(c => c.Course.CourselD)); 
foreach (var course in _context.Courses) 

{ 

if (selectedCoursesHS.Contains(course.CourseID.ToString())) 

{ 

if (!instructorCourses.Contains(course.CourselD)) 

{ 

İnstructorToUpdate.CourseAssignments.Add(new CourseAssignment { InstructorlD = 
İnstructorToUpdate.ID, CourselD = course.CourselD }); 

} 

} 

else 

{ 

if (instructorCourses.Contains(course.CourselD)) 

{ 

CourseAssignment courseToRemove = İnstructorToUpdate.CourseAssignments.FirstOrDefault(i => 
i.CourselD == course.CourselD); 

_context.Remove(courseToRemove); 

} 

} 

} 

} 


Kod daha sonra, veritabanındaki tüm kurslardan geçer ve bu her kursu, görünümde seçili olanlar ile ilgili olarak 
eğitmenin atandığı her bir kursa karşı denetler. Etkili aramaları kolaylaştırmak için, ikinci iki koleksiyon HashSet 
nesnelerinde depolanır. 

Kurs onay kutusu seçilmişse ancak kurs ınstructor.CourseAssignments gezinti özelliğinde değilse kurs, Gezinti 
özelliğindeki koleksiyona eklenir. 





private void UpdateInstructorCourses(string[] selectedCourses, Instructor instructorToUpdate) 

{ 

if (selectedCourses == null) 

{ 

İnstructorToUpdate.CourseAssignments = new List<CourseAssignment>(); 
return; 

} 

var selectedCoursesHS = new HashSet<string>(selectedCourses); 
var İnstructorCourses = new HashSet<int> 

(instructorToUpdate.CourseAssignments.Select(c => c.Course.CourselD)); 
foreach (var course in _context.Courses) 

{ 

if (selectedCoursesHS.Contains(course.CourselD.ToStringO)) 

{ 

if (!instructorCourses.Contains(course.CourselD)) 

{ 

İnstructorToUpdate.CourseAssignments.Add(new CourseAssignment { InstructorlD = 
İnstructorToUpdate.İD, CourselD = course.CourselD }); 

} 

} 

else 

{ 

if (instructorCourses.Contains(course.CourselD)) 

{ 

CourseAssignment courseToRemove = İnstructorToUpdate.CourseAssignments.FirstOrDefault(i => 
i.CourselD == course.CourselD); 

_context.Remove(courseToRemove); 

} 

} 

} 

} 

Kurs onay kutusu seçilmemişse, ancak kurs ınstructor.CourseAssignments gezinti özelliği ise, kurs, gezinti 
özelliğinden kaldırılır. 




private void UpdateInstructorCourses(string[] selectedCourses, Instructor instructorToUpdate) 

{ 

if (selectedCourses == null) 

{ 

instructorToUpdate.CourseAssignments = new List<CourseAssignment>(); 
return; 

} 

var selectedCoursesHS = new HashSet<string>(selectedCourses); 
var instructorCourses = new HashSet<int> 

(instructorTollpdate.CourseAssignments.Select(c => c.Course.CourselD)); 
foreach (var course in _context.Courses) 

{ 

if (selectedCoursesHS.Contains(course.CourseID.ToString())) 

{ 

if (!instructorCourses.Contains(course.CourselD)) 

{ 

İnstructorToUpdate.CourseAssignments.Add(new CourseAssignment { InstructorlD = 
İnstructorToUpdate.ID, CourselD = course.CourselD }); 

} 

} 

else 

{ 

if (instructorCourses.Contains(course.CourselD)) 

{ 

CourseAssignment courseToRemove = İnstructorToUpdate.CourseAssignments.FirstOrDefault(i => 
i.CourselD == course.CourselD); 

_context.Remove(courseToRemove); 

} 

} 

} 

} 


Eğitmen görünümlerini güncelleştirme 

Görünümler/eğitmenler/Edit. cshtmllçlnde, Office alanı için div öğelerinden hemen sonra ve Kaydet için div 
öğesinden önce aşağıdaki kodu ekleyerek bir dizi onay kutusu içeren bir Kurslar alanı ekleyin Bu. 


NOTE 

Kodu Visual Studio 'Ya yapıştırdığınızda, satır sonları kodu kesen bir şekilde değiştirilebilir. Kod yapıştırdıktan sonra farklı 
görünüyorsa, otomatik biçimlendirmeyi geri almak için CTRL + Z bir kez tuşuna basın. Bu işlem satır sonlarını, burada 
gördüğünüz gibi görünmeleri için düzeltir. Girintide kusursuz olması gerekmez, ancak @</trxtr> , @:<td>, @:</td> ve 
</tr> çizgilerinin her biri gösterildiği gibi tek bir satırda olması gerekir, aksi halde bir çalışma zamanı hatası alırsınız. Yeni 
kod bloğu seçiliyken, yeni kodu mevcut kodla hizalamak için üç kez Tab tuşuna basın. Bu sorun Visual Studio 2019 ' de 
düzeltilmiştir. 








<div class="form-group"> 

<div class="col-md-offset-2 col-md-10"> 

<table> 

<tn> 

@{ 

int cnt = 0; 

List<ContosoUniversity.Models.SchoolViewModels.AssignedCourseData> courses = 

ViewBag.Courses; 

foreach (var course in courses) 

{ 

if (cnt++ % 3 == 0) 

{ 

</trxtr> 

} 

<td> 

<input type="checkbox" 

name="selectedCourses" 
value="@course.CourseiD" 

@(Html.Raw(course.Assigned ? "checked=\"checked\"" : "")) /> 
@course.CourseiD (Şcourse.Title 

</td> 

} 

</tr> 

} 

</table> 

</div> 

</div> 


Bu kod, üç sütun içeren bir HTML tablosu oluşturur. Her sütunda, bir onay kutusu ve ardından kurs numarası ve 
başlığından oluşan bir açıklamalı alt yazı bulunur. Onay kutularının hepsi aynı ada ("Selectedkurslar") sahiptir, bu 
da model cilde bir grup olarak değerlendirilme bildirir. Her onay kutusunun değer özniteliği courseiD değerine 
ayarlanır. Sayfa gönderildiğinde, model Ciltçi yalnızca seçili onay kutuları için CourseiD değerlerinden oluşan 
denetleyiciye bir dizi geçirir. 

Onay kutuları başlangıçta işlendiğinde, eğitmenin atandığı kurslara yönelik olanlar, işaretlenmiş özniteliklere 
sahiptir ve bunları seçer (denetlenen görüntüler). 

Uygulamayı çalıştırın, eğitmenler sekmesini seçin ve ardından düzenleme sayfasını görmek İçin bir eğitmende 
Düzenle ' ye tıklayın. 





B Edit - Contoso Universit X 

+ 

□ X 

<r -> O 

localhost:5813/l ■jüj’ 

=- 

Contoso University 


— 


Edit 


Instructor 

Last Name 

Abercrombie 

First Name 

Kim 

Hire Date 

3/11/1995 

Office Location 

44/3P 

□ 1000 Algebra 2 □ 1045 Calculus □ 1050 Chemistry 

0 2021 Composition 0 2042 Literatüre 03141 Trigonometry 

□ 4022 MicroeconomicsD 4041 Macroeconomics 

Save 



Bazı kurs atamalarını değiştirin ve Kaydet 1 e tıklayın. Yaptığınız değişiklikler Dizin sayfasında yansıtılır. 


NOTE 

Eğitim kursu verilerini düzenlemek için buradaki yaklaşım, sınırlı sayıda kurs olduğunda iyi bir şekilde gerçekleştirilir.Çok 
daha büyük olan koleksiyonlar için, farklı bir kullanıcı arabirimi ve farklı bir güncelleştirme yöntemi gerekir. 


Güncelleştirme silme sayfası 


lnstructorsController.es' de DeieteConfinmed yöntemini silin ve yerine aşağıdaki kodu ekleyin. 














[HttpPost , ActionName("Delete")] 
[ValidateAntiForgeryToken] 

public async Task<IActionResult> DeleteConfirmed(int id) 

{ 

Instructor instructor = await _context.Instructors 
.Include(i => i.CourseAssignments) 

•SingleAsync(i => i.ID == id); 

var departments = await _context.D 0 partments 
.Where(d => d.InstructorlD == id) 

.Tol_istAsync(); 

departments.ForEach(d => d.InstructorlD = null); 

_context.Instructors.Remove(instructor); 

await _context.SaveChangesAsync(); 
return RedirectToAction(nameof(Index)); 


Bu kod aşağıdaki değişiklikleri yapar: 

• @No__t-0 gezinti özelliği için Eager yüklemesi yapar. Bunu eklemeniz gerekir, ilgili courseAssignment 
varlıkları hakkında bilgi sahibi olmaz ve onları silmez. Bunları okumaktan kaçınmak için, veritabanında art 
arda silme yapılandırabilirsiniz. 

• Silinecek eğitmen herhangi bir departmanların Yöneticisi olarak atanırsa, bu departmanlardan eğitmen 
atamasını kaldırır. 

Sayfa oluşturmak için Office konumu ve kurslar ekleme 

lnstructorsController.es' de, HttpGet ve httppost create yöntemlerini silin ve ardından aşağıdaki kodu kendi 

yerine ekleyin: 





public IActionResult Create() 

{ 

var instructor = new Instructor(); 

instructor.CourseAssignments = new List<CourseAssignment>(); 

PopulateAssignedCourseData(instructor); 
return View(); 

} 

// POST: Instructors/Create 
[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Create([Bind("FirstMidName,HireDate,LastName,OfficeAssignment")] instructor 
instructor, string[] selectedCourses) 

{ 

if (selectedCourses != null) 

{ 

instructor.CourseAssignments = new List<CourseAssignment>(); 
foreach (var course in selectedCourses) 

{ 

var courseToAdd = new CourseAssignment { InstructorlD = instructor.ID, CourselD = 
int.Parse(course) }; 

instructor.CourseAssignments.Add(courseToAdd); 

} 

} 

if (ModelState.IsValid) 

{ 

_context.Add(instructor); 

await _context.SaveChangesAsync (); 

return RedirectToAction(nameof(Index)); 

} 

PopulateAssignedCourseData(instructor); 
return View(instructor); 

} 

Bu kod, başlangıçta hiçbir kurs seçilmemiş olması dışında Edit yöntemleri için gördüğünüz gibi benzerdir. 
@No__t, ancak görünümde foreach döngüsü için boş bir koleksiyon sağlamak üzere, HttpGet-0 yöntemi 
PopulateAssignedCourseData yöntemini çağırır. Aksi takdirde görünüm kodu bir null başvuru özel durumu 
oluşturur. 

HttpPost Create yöntemi, seçili her kursu doğrulama hatalarını kontrol etmeden önce CourseAssignments gezinti 
özelliğine ekler ve yeni eğitmeni veritabanına ekler. Model hataları olduğunda (örneğin, Kullanıcı geçersiz bir tarih 
anahtarlanır) ve sayfa bir hata iletisiyle yeniden görüntülenirken, yapılan kurs seçimleri otomatik olarak geri 
yüklenir. 

@No__t-0 gezinti özelliğine kurslar ekleyebilmesinin, özelliği boş bir koleksiyon olarak başlatmak için sahip 
olmanız gerektiğini unutmayın: 

instructor.CourseAssignments = new List<CourseAssignment>(); 


Bunu denetleyici kodunda yapmanın bir alternatifi olarak, aşağıdaki örnekte gösterildiği gibi, özellik alıcısının, 
koleksiyonu otomatik olarak oluşturmak üzere değiştirerek, bunu eğitmen modelinde yapabilirsiniz: 









private ICollection<CourseAssignment> _courseAssignments; 
public ICollection<CourseAssignment> CourseAssignments 
{ 

get 

{ 

return _courseAssignments ?? (_courseAssignments = new List<CourseAssignment>()); 

} 

set 

{ 

_courseAssignments = value; 

} 


@No__t-0 özelliğini bu şekilde değiştirirseniz, denetleyicideki açık özellik başlatma kodunu kaldırabilirsiniz. 

Görünümler/eğitmen/oluşturma, cshtml'de, gönder düğmesinden önce kurslar için bir Office konum metin 
kutusu ve onay kutuları ekleyin. Düzenleme sayfasında olduğu gibi, dosyayı yapıştırdığınızda Visual Studio kodu 
yeniden biçimlendirdiğinden biçimlendirmeyi onarın. 

<div class="form-group"> 

<label asp-for="OfficeAssignment. Location" class="control-label"x/label> 
cinput asp-for="OfficeAssignment.Location" class="form-control" /> 

<span asp-validation-for="OfficeAssignment.Location" class="text-danger" /> 

</div> 

<div class="form-group"> 

<div class="col-md-offset-2 col-md-10"> 

<table> 

ctr> 

@{ 

int cnt = 0; 

ListcContosoUniversity.Models.SchoolViewModels.AssignedCourseData> courses = 

ViewBag.Courses; 

foreach (var course in courses) 

{ 

if (cnt++ % 3 == 0) 

{ 

</trxtr> 

} 

<td> 

cinput type="checkbox" 

name="selectedCourses" 

value="@course.CourseID" 

@(Html.Raw(course.Assigned ? "checked=\"checked\"" : "")) /> 
(Şcourse.CourselD @course.Title 

</td> 

} 

</tr> 

} 

</table> 

</div> 

</div> 


Uygulamayı çalıştırıp bir eğitmen oluşturarak test edin. 

İşlemleri işleme 

CRUD öğreticisindeaçıklandığı gibi Entity Framevvork, işlemleri örtük olarak uygular. Daha fazla denetime 
ihtiyacınız olan senaryolar için—örneğin, işlem içinde Entity Framevvork dışında yapılan işlemleri eklemek 
istiyorsanız, bkz. işlemler. 




Kodu edinin 

Tamamlanmış uygulamayı indirin veya görüntüleyin. 


Sonraki adımlar 

Bu öğreticide şunları yaptınız: 

• Özelleştirilmiş Kurslar sayfaları 

• Eklenen eğitmenler düzenleme sayfası 

• Düzenleme sayfasına kurslar eklendi 

• Silme sayfası güncelleştirildi 

• Sayfa oluşturmak için Office konumu ve kurslar eklendi 

Eşzamanlılık çakışmalarını nasıl işleyeceğinizi öğrenmek için sonraki öğreticiye ilerleyin. 
Eşzamanlılık çakışmalarını işle 



Önceki öğreticilerde, verileri güncelleştirme hakkında daha fazla öğrendiniz. Bu öğreticide, birden çok kullanıcı 
aynı anda aynı varlık güncelleştirdiğinizde çakışmalarına gösterilmektedir. 

Departman varlığıyla çalışan ve eşzamanlılık hatalarını işleyecek Web sayfaları oluşturacaksınız. Aşağıdaki 
çizimler, bir eşzamanlılık çakışması oluşursa görüntülenen bazı iletiler dahil olmak üzere, düzenleme ve silme 
sayfalarını gösterir. 

B Departmer X B Edit - Cont X + — □ X 

^ localhost 813/Departr -fa 



Edit 


Department 

• The record you attempted to edit was modifîed by another user 
after you got the origînal value. The edit operation was canceled 
and the current values in the database have been displayed. If 
you stili want to edit this record, click the Save button again. 
Othervvise click the Back to List hyperlink. 

Name 

English 

Budget 

200000.00 

Current value: $50,000.00 

Start Date 

9/1/2007 

InstructorlD 

Abercrombie, Kim v 


Save 















E3 Departments - 

H Delete - Co X 

+ 

□ X 

<- -> O 


localhost:5313/Departr 'jüf 

... 

Contoso University 


— 


Delete 

The record you attempted to delete was modified by another user after 
you got the original values. The delete operatlon was canceled and the 
current values in the database have been displayed. If you stili want to 
delete this record, click the Delete button again. Otherwise click the 
Back to List hyperlink. 

Are you sure you want to delete this? 

Department 

Name 

English 
Budget 
$200,000.00 
Start Date 
2017-02-16 
Administrator 
Abercrombie, Kim 

Delete | Back to List 


Bu öğreticide şunları yaptınız: 

• Eşzamanlılık çakışmaları hakkında bilgi edinin 

• izleme özelliği Ekle 

• Departmanlar denetleyicisi ve görünümleri oluşturma 

• Dizin görünümünü Güncelleştir 

• Düzenleme yöntemlerini Güncelleştir 

• Güncelleştirme düzenleme görünümü 

• Eşzamanlılık çakışmalarını test et 

• Silme sayfası 

• Güncelleştirme ayrıntıları ve görünüm oluşturma 

Önkoşullar 

• ilgili verileri güncelleştirme 

Eşzamanlılık çakışmaları 

Bir Kullanıcı bir varlığın verilerini düzenlemek için bir varlık verileri görüntülediğinde bir eşzamanlılık çakışması 
oluşur ve sonra, ilk kullanıcının değişikliği veritabanına yazılmadan önce diğer Kullanıcı aynı varlığın verilerini 
günceller. Bu tür çakışmaların algılanmasını etkinleştirmezseniz, veritabanını güncelleştirme son olarak diğer 
kullanıcının değişikliklerinin üzerine yazar. Birçok uygulamada, bu risk kabul edilebilir: birkaç Kullanıcı veya birkaç 
güncelleştirme varsa veya bazı değişikliklerin üzerine yazılırsa gerçekten önemli değilse, eşzamanlılık için 
programlama maliyeti avantajdan yararlanabilir. Bu durumda, uygulamayı eşzamanlılık çakışmalarını işleyecek 
şekilde yapılandırmanız gerekmez. 













Kötümser eşzamanlılık (kilitleme) 

Uygulamanızın eşzamanlılık senaryolarında yanlışlıkla veri kaybını önlemesi gerekiyorsa, bunu yapmanın bir yolu 
veritabanı kilitlerini kullanmaktır. Bu, Kötümser eşzamanlılık olarak adlandırılır.Örneğin, bir veritabanından bir 
satırı okuyabilmeniz için, salt okunurdur veya güncelleştirme erişimi için bir kilit isteyin. Bir satırı güncelleştirme 
erişimi için kilitlerseniz, başka hiçbir kullanıcının satırı değiştirme sürecinde olan verilerin bir kopyasını alması için 
salt okunurdur veya güncelleştirme erişimi için bu satırı kilitlemesine izin verilmez. Bir satırı salt okuma erişimi 
için kilitlerseniz, diğerleri dosyayı salt okuma erişimi için de kilitleyip güncelleştirme için de kilitleyebilirler. 

Kilitleri yönetmek dezavantajlara sahiptir. Program, karmaşık olabilir.Önemli veritabanı yönetim kaynakları 
gerektirir ve bir uygulamanın kullanıcı sayısı arttıkça performans sorunlarına neden olabilir. Bu nedenlerden 
dolayı, tüm veritabanı yönetim sistemleri Kötümser eşzamanlılık 'yi desteklemez. Entity Framevvork Core, BT için 
yerleşik destek sağlamaz ve bu öğretici bunu nasıl uygulayacağınızı göstermez. 

İyimser Eşzamanlılık 

Kötümser eşzamanlılık yerine iyimser eşzamanlılık yapılır, iyimser eşzamanlılık, eşzamanlılık çakışmalarının 
gerçekleşmesine ve sonra uygun şekilde yeniden davranmasını sağlar. Örneğin, Gamze departman düzenleme 
sayfasını ziyaret ettiğinde, İngilizce departmanı $350.000,00 olan bütçe tutarını $0,00 olarak değiştirir. 


B Edit-Conl X + 

□ X 

localhost:53 

ü ☆ | ••• 

Contoso University 

— 


Edit 

Department 


Budget 

0 x 

Administrator 

Abercrombie, Kim v 

Name 

English 

Start Date 

9/1/2007 


Save 



Jane tıkladığında önce Kaydet, John aynı sayfayı ziyaret eder ve alanın başlangıç tarihi 1/9/2013 1/9/2007'deki 
değiştirir. 
















Contoso University 


Edit 

Department 

Budget 

350000.00 

Administrator 

Abercrombie, Kim 

Name 

English 

Start Date 


9/1/2013 



Gamze önce Kaydet 1 i tıklatır ve tarayıcı dizin sayfasına döndüğünde değişikliği görür. 


n Departments - Contoso X -(- 


- □ X 

ÇJ) localhost 

O ☆ | 

- m û - 

Contoso University 


— 

A 

Departments 

Create New 




Name Budget Administrator 

Start Date 



English $0.00 Abercrombie, Kim 

2007-09-01 

Edit | Details | Delete 




Ardından John, hala $350.000,00 bütçesini gösteren bir düzenleme sayfasında Kaydet 1 e tıklamakta. Sonraki 
işlemin ne eşzamanlılık çakışmalarını nasıl ele tarafından belirlenir. 

Bazı seçenekler şunlardır: 

• Bir kullanıcının hangi özelliği değiştirdiği ve yalnızca ilgili sütunları veritabanında güncelleştirdiğinden 
haberdar olabilirsiniz. 

Örnek senaryoda, iki kullanıcı tarafından farklı özellikler güncelleştirildiğinden hiçbir veri kaybolmaz. 
İngilizce bölüme bir dahaki sefer ilk kez gözattığında, hem gamze 'nin hem de John 'un değişikliklerini 
görür; başlangıç tarihi 9/1/2013 ve sıfır dolar bir bütçe olur. Bu güncelleştirme yöntemi, veri kaybına neden 
olabilecek çakışmaların sayısını azaltabilir, ancak bir varlığın aynı özelliğinde rekabet değişiklikleri yapılırsa 


















veri kaybını önleyebilir. Entity Framevvork bu şekilde çalışıp çalışmadığını, güncelleştirme kodunuzu nasıl 
uygulayadığınıza bağlıdır. Genellikle bir Web uygulamasında pratik değildir, çünkü bir varlığın tüm özgün 
özellik değerlerini ve yeni değerleri izlemek için büyük miktarlarda durum tutmanızı gerektirebilir. Büyük 
miktarlarda durum bulundurma, uygulama performansını etkileyebilir çünkü sunucu kaynakları gerektirir 
ya da Web sayfasının kendisine (örneğin, gizli alanlarda) veya bir tanımlama bilgisinde yer almalıdır. 

• Gamze'nin değişikliğinin üzerine Çan'ın değişiklik sağlayabilirsiniz. 

İngilizce bölüme bir dahaki sefer gözattığında, 9/1/2013 ve geri yüklenen $350.000,00 değerini görür.Bu, 
İstemci WINS veya son WINS senaryosu olarak adlandırılır, (istemciden gelen tüm değerler veri 
deposunda yer alacak şekilde önceliklidir.) Bu bölümün giriş bölümünde belirtildiği gibi, eşzamanlılık 
işleme için herhangi bir kodlama yapmazsanız, bu otomatik olarak gerçekleşir. 

• John 'un değişikliğini veritabanında güncelleştirilmesini engelleyebilirsiniz. 

Genellikle bir hata iletisi görüntüler, verilerin geçerli durumunu gösterir ve yine de bunu yapmak istiyorsa, 
yaptığı değişiklikleri yeniden uygular. Bu adlı bir Store WINS senaryo. (Veri deposu değerleri, istemci 
tarafından gönderilen değerlere göre önceliklidir.) Bu öğreticide mağaza WINS senaryosunu 
uygulayacaksınız. Bu yöntem, bir kullanıcının neler olduğunu bildirmeden önce hiçbir değişikliğin üzerine 
yazılmamasını sağlar. 

Eşzamanlılık çakışmalarını algılama 

Entity Framevvork oluşturduğu DbConcurrencyException özel durumları işleyerek çakışmaları çözebilirsiniz. Bu 
özel durumların ne zaman throvv hakkında bilgi edinmek için Entity Framevvork çakışmaları algılayabilmelidir. Bu 
nedenle, veritabanını ve veri modelini uygun şekilde yapılandırmanız gerekir. Çakışma algılamayı etkinleştirmeye 
yönelik bazı seçenekler şunlardır: 

• Veritabanı tablosunda, bir satırın ne zaman değiştirildiğini belirlemede kullanılabilecek bir izleme sütunu 
ekleyin. Daha sonra Entity Framevvork SQL Update veya delete komutlarının VVHERE yan tümcesinde bu 
sütunu içerecek şekilde yapılandırabilirsiniz. 

izleme sütununun veri türü genellikle rowversion . rowversion değeri, satır her güncelleştirildiği zaman 
artılan sıralı bir sayıdır. Bir Update veya delete komutunda VVHERE yan tümcesi, izleme sütununun (orijinal 
satır sürümü) orijinal değerini içerir. Güncelleştirilmekte olan satır başka bir kullanıcı tarafından 
değiştirilmişse, rowversion sütunundaki değer özgün değerden farklıdır, bu nedenle Update veya DELETE 
deyimi VVHERE yan tümcesi nedeniyle güncelleştirilecek satırı bulamaz. Entity Framevvork, Update veya 
delete komutuyla hiçbir satır güncelleştirilmediğini bulduğunda (yani, etkilenen satır sayısı sıfır 
olduğunda), bunu bir eşzamanlılık çakışması olarak yorumlar. 

• Entity Framevvork, Update ve DELETE komutlarının VVHERE yan tümcesindeki tablodaki her sütunun 
özgün değerlerini içerecek şekilde yapılandırın. 

ilk seçenekte olduğu gibi, satırdaki herhangi bir şey satırın ilk okuduğundan beri değiştiyse VVHERE yan 
tümcesi güncelleştirilecek bir satır döndürmez, bu da Entity Framevvork eşzamanlılık çakışması olarak 
yorumlar. Birçok sütunu olan veritabanı tablolarında, bu yaklaşım çok büyük VVHERE yan tümceleriyle 
sonuçlanabilir ve büyük miktarlarda durum bulundurmasını gerektirebilir. Daha önce belirtildiği gibi, 
büyük miktarlarda durumu korumak uygulama performansını etkileyebilir. Bu nedenle bu yaklaşım 
genellikle önerilmez ve bu öğreticide kullanılan yöntem değildir. 

Bu yaklaşımı eşzamanlılık 'e uygulamak istiyorsanız, Concurrencycheck özniteliğini bunlara ekleyerek 
eşzamanlılık izlemek istediğiniz varlıktaki tüm birincil anahtar olmayan Özellikleri işaretlemeniz gerekir. Bu 
değişiklik Entity Framevvork, tüm sütunları Update ve DELETE deyimlerinin SQL VVHERE yan tümcesinde 
içermesini sağlar. 

Bu öğreticinin geri kalanında, departman varlığına bir rowversion izleme özelliği ekleyecek, bir denetleyici ve 
görünümler oluşturacak ve her şeyin doğru şekilde çalıştığını doğrulamak için test edeceksiniz. 












İzleme özelliği Ekle 

içinde Models/Department.cs, RovvVersion adlı izleme özelliği ekleyin: 

using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public class Department 

{ 

public int DepartmentlD { get; set; } 

[StringLength(50, MinimumLength = 3)] 
public string Name { get; set; } 

[DataType(DataType.Currency)] 

[Column(TypeName = "money")] 
public decimal Budget { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}"j ApplyFormatlnEditMode = true)] 

[Display(Name = "Start Date")] 
public DateTime StartDate { get; set; } 

public int? InstructorlD { get; set; } 

[Timestamp] 

public byte[] RowVersion { get; set; } 

public Instructor Administrator { get; set; } 
public ICollection<Course> Courses { get; set; } 

} 

} 

Timestamp özniteliği, bu sütunun veritabanına gönderilen VVHERE yan tümcesine ve DELETE komutlarına dahil 
edileceğini belirtir. Önceki SQL Server sürümleri, SQL rowversion değiştirilmeden önce bir SQL timestamp veri 
türü kullandığından özniteliğe Timestamp denir. rowversion için .NET türü bir bayt dizisidir. 

Fluent API kullanmayı tercih ediyorsanız, aşağıdaki örnekte gösterildiği gibi izleme özelliğini belirtmek için 
isConcurrencyToken yöntemini ( Data/SchoolContext. cs) kullanabilirsiniz: 

modelBuilder.Entity<Department>() 

.Property(p => p.RowVersion).IsConcurrencyToken(); 


Bir özellik ekleyerek, veritabanı modelini değiştirdiğiniz için başka bir geçiş yapmanız gerekir. 
Değişikliklerinizi kaydedin ve projeyi derleyin ve ardından komut penceresine aşağıdaki komutları girin: 

dotnet ef migrations add RowVersion 

dotnet ef database update 


Departmanlar denetleyicisi ve görünümleri oluşturma 


Daha önce öğrenciler, Kurslar ve Eğitmenler için yaptığınız gibi bir departman denetleyicisini ve görünümlerini 









derden katlayın. 


Add Controller 

Model class: 

Data context class: 

Vievvs: 

E/l Generate vievvs 
0 Reference script libraries 
0 Use a layout page: 


X 


Department (ContosoUniversity . Models) 


SchoolContext (ContosoUniversity.Data) 

V 

E 


GD 


(Leave empty if it is set in a Razor_viewstartfile) 


Controller name: 


DepartmentsController 


Add 


Cancel 


DepartmentsController.es dosyasında, "FirstMidName" sözcüğünün dört yinelemesini "FulIName" olarak 
değiştirin, böylece Departman Yöneticisi açılan listeleri yalnızca soyadı yerine eğitmenin tam adını içerecektir. 

ViewData["InstructorID"] = new SelectList(_context.Instructors, "ID", "FullName", department. InstructorlD); 


Dizin görünümünü Güncelleştir 

Yapı iskelesi altyapısı dizin görünümünde bir ROVVVERSION sütunu oluşturdu, ancak bu alan gösterilmemelidir. 
Views/departmanlar/tndex. cshtml içindeki kodu aşağıdaki kodla değiştirin. 





































@model IEnumerablecContosolIniversity .Models.Department> 

@{ 

ViewData["Title"] = "Departments"; 

} 

<h2>Departments</h2> 

<p> 

<a asp-action="Create">Create New</a> 

</p> 

«ctable class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model => model.Name) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Budget) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.StartDate) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Administrator) 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

(Şforeach (var item in Model) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Name) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Budget) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.StartDate) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Administrator.FullName) 

</td> 

<td> 

<a asp-action="Edit" asp-route-id="@item.DepartmentID">Edit</a> | 

<a asp-action="Details" asp-route-id="@item.DepartmentID">Details</a> | 
<a asp-action="Delete" asp-route-id="@item.DepartmentID">Delete</a> 
</td> 

</tr> 

} 

</tbody> 

</table> 


Bu, başlığı "departmanlar" olarak değiştirir, RovvVersion sütununu siler ve yöneticinin adı yerine tam adı gösterir. 

Düzenleme yöntemlerini Güncelleştir 

Hem HttpGet Edit yönteminde hem de Details yönteminde AsNoTracking ekleyin. HttpGet Edit yönteminde, 
yönetici için Eager yüklemesi ekleyin. 







var department = await _context.Departments 
.Include(i => i.Administrator) 

.AsNoTracking() 

.FirstOrDefaultAsync(m => m.DepartmentlD == id); 

HttpPost Edit yöntemi için mevcut kodu şu kodla değiştirin: 

[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Edit(int? id, byte[] rowVersion) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var departmentToUpdate = await _context.Departments.Include(i => i.Administrator).FirstOrDefaultAsync(m 
=> m.DepartmentlD == id); 

if (departmentToUpdate == null) 

{ 

Department deletedDepartment = new Department(); 
await TryUpdateModelAsync(deletedDepartment); 

ModelState.AddModelError(string.Empty, 

"Unable to save changes. The department was deleted by another user."); 

ViewData["InstructorID"] = new SelectList(_context.Instructors, "ID", "FullName", 
deletedDepartment.InstructorID); 

return View(deletedDepartment); 

} 

_context.Entry(departmentToUpdate).Property("RowVersion").OriginalValue = rowVersion; 

if (await TryUpdateModelAsync<Department>( 
departmentToUpdate, 

i 

s => s.Name, s => s.StartDate, s => s.Budget, s => s.InstructorlD)) 

{ 

try 

{ 

await _context.SaveChangesAsync(); 
return RedirectToAction(nameof(Index)); 

} 

catch (DbUpdateConcurrencyException ex) 

{ 

var exceptionEntry = ex.Entries.Single(); 
var clientValues = (Department)exceptionEntry.Entity; 
var databaseEntry = exceptionEntry.GetDatabaseValues(); 
if (databaseEntry == null) 

{ 

ModelState.AddModelError(string.Empty, 

"Unable to save changes. The department was deleted by another user."); 

} 

else 

{ 

var databaseValues = (Department)databaseEntry.ToObject(); 

if (databaseValues.Name != clientValues.Name) 

{ 

ModelState.AddModelError("Name", $"Current value: {databaseValues.Name}"); 

} 

if (databaseValues.Budget != clientValues.Budget) 

{ 

ModelState.AddModelError("Budget", $"Current value: {databaseValues.Budgetıc}"); 

} 

if (databaseValues.StartDate != clientValues.StartDate) 

{ 




ModelState.AddModelError("StartDate", $"Current value: {databaseValues.StartDaterd}"); 

} 

if (databaseValues.InstructorlD != clientValues.InstructorlD) 

{ 

Instructor databaselnstructor = await _context.Instructors.FirstOrDefaultAsync(i = > i.ID 
== databaseValues.InstructorlD); 

ModelState.AddModelError("InstructorID", $"Current value: 

{databaselnstructor?.FullName}"); 

} 

ModelState.AddModelError(string.Empty, "The record you attempted to edit " 

+ "was modified by another user after you got the original value. The " 

+ "edit operation was canceled and the current values in the database " 

+ "have been displayed. If you stili want to edit this record, click " 

+ "the Save button again. Otherwise click the Back to List hyperlink."); 
departmentToUpdate.RowVersion = (byte[])databaseValues.RowVersion; 

ModelState. Remove (" RowVers ion"); 

} 

} 

} 

ViewData["InstructorID"] = new SelectList(_context.Instructors, "ID", "FullName", 
departmentToUpdate.InstructorlD); 
return View(departmentToUpdate); 

} 

Kod, güncellenen departmanı okumaya çalışırken başlar. FirstorDefaultAsync yöntemi null döndürürse, 
departman başka bir kullanıcı tarafından silindi. Bu durumda, kod, düzenleme sayfasının bir hata iletisiyle yeniden 
görüntülenebilmesi için bir departman varlığı oluşturmak üzere postalanan form değerlerini kullanır. Alternatif 
olarak, departman alanlarını yeniden görüntülemeden yalnızca bir hata iletisi görüntülediğinizde, departman 
varlığını yeniden oluşturmanız gerekmez. 

Görünüm özgün Rowversion değerini gizli bir alana depolar ve bu yöntem, rowVersion parametresindeki bu 
değeri alır. Savechanges çağırmadan önce, bu özgün Rowversion özellik değerini varlık için Originaivaiues 
koleksiyonuna koymanız gerekir. 

_context.Entry(departmentToUpdate).Property("RowVersion").OriginalValue = rowVersion; 

Entity Framevvork bir SQL UPDATE komutu oluşturduğunda, bu komut özgün RowVersion değerine sahip bir 
satırı aramak için bir VVHERE yan tümcesi içerecektir. GÜNCELLEŞTİRME komutundan hiçbir satır 
etkilenmiyorsa (özgün Rowversion değerine sahip satır yoksa) Entity Framevvork bir 
DbUpdateConcurrencyException Özel durumu oluşturur. 

Bu özel durum için catch bloğundaki kod, özel durum nesnesindeki Entries özelliğinden güncelleştirilmiş 
değerlere sahip etkilenen departman varlığını alır. 

var exceptionEntry = ex.Entries.Single(); 

Entries koleksiyonu yalnızca bir EntityEntry nesnesine sahip olur. Kullanıcı tarafından girilen yeni değerleri ve 
geçerli veritabanı değerlerini almak için bu nesneyi kullanabilirsiniz. 

var clientValues = (Department)exceptionEntry.Entity; 
var databaseEntry = exceptionEntry.GetDatabaseValues(); 


Kod, kullanıcının düzenleme sayfasına girdikten farklı veritabanı değerleri olan her bir sütun için özel bir hata 
iletisi ekler (yalnızca bir alan, kısaltma için burada gösterilir). 















var databaseValues = (Department)databaseEntry.ToObject(); 

if (databaseValues.Name != clientValues.Name) 

{ 

Modeistate.AddModelError("Name ", $"Current value: {databaseValues.Name}"); 

Son olarak kod, departmentToupdate Rowversion değerini veritabanından alınan yeni değere ayarlar. Bu yeni 
RowVersion değeri, düzenleme sayfası yeniden görüntülenirken gizli alanda saklanır ve Kullanıcı Kaydet' i 
tıkladığında, düzenleme sayfasının yeniden görüntülenmesinden bu yana yalnızca gerçekleşen eşzamanlılık 
hataları yakalanacaktır. 

departmentToupdate.RowVersion = (byte[])databaseValues.RowVersion; 

ModelState.Remove("RowVersion"); 

Modeistate.Remove Deyimi, çünkü gereklidir Modeistate eski olan Rowversion değeri. Görünümde, bir alan için 
Modeistate değeri, her ikisi de varsa Model özelliği değerlerinin üzerine gelir. 

Güncelleştirme düzenleme görünümü 

Görünümler/departmanlar/Düzenle. cshtml'de aşağıdaki değişiklikleri yapın: 

• Rowversion özellik değerini kaydetmek için, DepartmentiD özelliğinin gizli alanından hemen sonra bir gizli 
alan ekleyin. 

• Açılan listeye "Yönetici Seç" seçeneği ekleyin. 









@model Contosollniversity.Models.Department 

@{ 

ViewData["Title"] = "Edit"; 

} 

<h2>Edit</h2> 

<h4>Department</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form asp-action="Edit"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<input type="hidden" asp-for="DepartmentID" /> 

<input type="hidden" asp-for="RowVersion" /> 

<div class="form-group"> 

<label asp-for="Name" class="control-label"x/label> 

<input asp-for="Name" class="form-control" /> 

<span asp-validation-for="Name" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Budget" class="control-label"x/label> 
cinput asp-for="Budget" class="form-control" /> 

<span asp-validation-for="Budget" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

clabel asp-for="StartDate" class="control-label"x/label> 

<input asp-for="StartDate" class="form-control" /> 

<span asp-validation-for="StartDate" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="InstructorID" class="control-label"x/label> 

<select asp-for="InstructorID" class="form-control" asp-items="ViewBag.InstructorID"> 
coption value="">-- Select Administrator --</option> 

</select> 

<span asp-validation-for="InstructorID" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<input type="submit" value="Save" class="btn btn-default" /> 

</div> 

</form> 

</div> 

</div> 

<div> 

<a asp-action="Index">Back to List</a> 

</div> 

@section Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 


Eşzamanlılık çakışmalarını test et 

Uygulamayı çalıştırın ve departmanlar dizini sayfasına gidin. İngilizce departman için düzenleme köprüsüne sağ 
tıklayın ve Yeni sekmesinde aç' ı seçin ve ardından İngilizce bölümünün düzenleme Köprüsü ' ne tıklayın, iki 
tarayıcı sekmesi artık aynı bilgileri görüntüler. 

ilk tarayıcı sekmesinde bir alanı değiştirin ve Kaydet 1 e tıklayın. 
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Name 

English 

Budget 
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Start Date 
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InstructorlD 
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Tarayıcı, değiştirilen değeri olan dizin sayfasını gösterir, 
ikinci tarayıcı sekmesinden bir alanı değiştirin. 
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Kaydet'e tıklayın. Bir hata iletisi görürsünüz: 
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Department 


• The record you attempted to edit was modifîed by another user 

after you got the original value. The edit operation was canceled 

and the current values in the database have been displayed. If 

you stili want to edit this record, click the Save button again. 

Othervvise click the Back to List hyperlink. 


Name 


English 


Budget 


200000.00 


Cunent value: $50,000.00 


Start Date 


9/1/2007 


InstructorlD 


Abercrombie, Kim v 


Save 


f* 4 ** jlı.» ^ 



Tıklayın Kaydet yeniden, ikinci tarayıcı sekmesinde girdiğiniz değer kaydedilir. Dizin sayfası göründüğünde 
kaydedilen değerleri görürsünüz. 

Silme sayfası 

Silme sayfası için Entity Framevvork, başka birinin departmanı benzer bir şekilde düzenlemesinden kaynaklanan 
eşzamanlılık çakışmalarını algılar. HttpGet Delete yöntemi onay görünümünü görüntülediğinde, görünüm, gizli 
bir alanda özgün RowVersion değerini içerir. Bu değer daha sonra Kullanıcı silmeyi onayladığında çağrılan 
HttpPost Delete yöntemi için kullanılabilir. Entity Framework, SQL DELETE komutunu oluşturduğunda, özgün 
RowVersion değerine sahip bir VVFIERE yan tümcesi içerir.Komut, sıfır satır etkilenirse (satır silme onayı sayfası 
görüntülendikten sonra değiştirildiğinde), bir eşzamanlılık özel durumu oluşturulur ve onay sayfasını bir hata 
iletisiyle yeniden görüntülemek için FittpGet Delete yöntemi bir hata bayrağı true olarak çağırılır. Satır başka bir 
kullanıcı tarafından silindiğinden, bu durumda herhangi bir hata iletisi görüntülenmediğinden sıfır satırların 
etkilenmesi de mümkündür. 

Departmanlar denetleyicisindeki silme yöntemlerini güncelleştirme 

DepartmentsController.es' de, httpget Delete yöntemini aşağıdaki kodla değiştirin: 


















public async Task<IActionResult> Delete(int? id, bool? concurrencyError) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

var department = await _context.Departments 
.Include(d => d.Administrator) 

.AsNoTracking() 

.FirstOrDefaultAsync(m => m.DepartmentlD == id); 
if (department == null) 

{ 

if (concurrencyError.GetValueOrDefault()) 

{ 

return RedirectToAction(nameof(Index)); 

} 

return NotFound(); 

} 

if (concurrencyError.GetValueOrDefault()) 

{ 

ViewData["ConcurrencyErrorMessage"] = "The record you attempted to delete " 
+ "was modified by another user after you got the original values. " 

+ "The delete operation was canceled and the current values in the " 

+ "database have been displayed. If you stili want to delete this " 

+ "recordj click the Delete button again. Otherwise " 

+ "click the Back to List hyperlink."; 

} 

return View(department); 


Yöntemi, sayfanın bir eşzamanlılık hatasından sonra yeniden görüntülenip görüntülenmeyeceğini belirten isteğe 
bağlı bir parametresini kabul eder. Bu bayrak true ise ve belirtilen departman artık mevcut değilse, başka bir 
kullanıcı tarafından silindi. Bu durumda, kod dizin sayfasına yeniden yönlendirir. Bu bayrak true ise ve departman 
varsa, başka bir kullanıcı tarafından değiştirilmiştir. Bu durumda, kod viewData kullanarak görünüme bir hata 
mesajı gönderir. 

HttpPost Delete yöntemindeki ( DeleteConfirmed adlı) kodu şu kodla değiştirin: 

[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> Delete(Department department) 

{ 

try 

{ 

if (await _context.Departments.AnyAsync(m => m.DepartmentlD == department.DepartmentlD)) 

{ 

_context.Departments.Remove(department); 
await _context.SaveChangesAsync(); 

} 

return RedirectToAction(nameof(Index)); 

} 

catch (DbUpdateConcurrencyException /* ex */) 

{ 

//Log the error (uncomment ex variable name and write a log.) 

return RedirectToAction(nameof(Delete), new { concurrencyError = true, id = department.DepartmentlD 

}); 

} 

} 

Az önce değiştirdiğiniz scafkatlanmış kodda, bu yöntem yalnızca bir kayıt KİMLİĞİ kabul etti: 







public async Task<IActionResult> DeieteConfirmed(int id) 

Bu parametreyi model Ciltçi tarafından oluşturulan bir departman varlığı örneğine değiştirdiniz. Bu, kayıt 
anahtarına ek olarak ROVVVERSION özellik değerine EF erişimi verir. 

public async Task<IActionResult> Delete(Department department) 

Ayrıca DeieteConfirmed eylem yöntemi adını Delete olarak değiştirdiniz. Yapı iskelesi kodu, HttpPost yöntemine 
benzersiz bir imza vermek için DeieteConfirmed adı kullandı. (CLR aşırı yüklenmiş yöntemlerin farklı yöntem 
parametrelerine sahip olmasını gerektirir.) imzalar benzersiz olduğuna göre, MVC kuralını seçebilir ve HttpPost 
ve HttpGet silme yöntemleri için aynı adı kullanabilirsiniz. 

Departman zaten silinirse, AnyAsync yöntemi false döndürür ve uygulama yalnızca dizin yöntemine geri döner. 

Bir eşzamanlılık hatası yakalanmışsa, kod silme onayı sayfasını yeniden görüntüler ve bir eşzamanlılık hata mesajı 
görüntülemesi gerektiğini belirten bir bayrak sağlar. 

Silme görünümünü Güncelleştir 

Views/departmanlar/delete. cs/ıfm/içinde, scafkatkli kodunu, DepartmentlD ve rovvversion özellikleri için bir hata 
iletisi alanı ve gizli alanları ekleyen aşağıdaki kodla değiştirin. Değişiklikler vurgulanır. 








@model Contosollniversity.Models.Department 

@{ 

ViewData["Title"] = "Delete"; 

} 

<h2>Delete</h2> 

<p class="text-danger">@ViewData["ConcurrencyErrorMessage"]</p> 

<h3>Are you sure you want to delete this?</h3> 

<div> 

<h4>Department</h4> 

<hr /> 

<dl class="row"> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Name) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Name) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Budget) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Budget) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.StartDate) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.StartDate) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Administrator) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Administrator.FullName) 

</dd> 

</dl> 

<form asp-action="Delete"> 

<input type="hidden" asp-for="DepartmentID" /> 

<input type="hidden" asp-for="RowVersion" /> 

<div class="form-actions no-color"> 

<input type="submit" value="Delete" class="btn btn-default" /> | 
<a asp-action="Index">Back to List</a> 

</div> 

</form> 

</div> 


Bu, aşağıdaki değişiklikleri yapar: 

• h2 ve h3 başlıkları arasında bir hata iletisi ekler. 

• FullName FirstMidName değiştirir yönetici alan. 

• RovvVersion alanını kaldırır. 

• Rowversion özelliği için gizli bir alan ekler. 

Uygulamayı çalıştırın ve departmanlar dizini sayfasına gidin. İngilizce departman için Sil köprüsünü sağ tıklayın 
ve Yeni sekmede aç' ı seçin ve ardından ilk sekmede İngilizce departman için düzenleme Köprüsü 1 ne tıklayın. 

ilk pencerede, değerlerden birini değiştirin ve Kaydet 1 e tıklayın: 








ikinci sekmede Sil' e tıklayın. Eşzamanlılık hata iletisini görürsünüz ve departman değerleri şu anda veritabanında 
olan ile yenilenir. 















E3 Departments - H Delete - Co X + 


□ X 


^ Ç_) localhost:5813/Departr ■jîf 



Delete 


The record you attempted to delete was modified by another user after 
you got the original values The delete operatlon was canceled and the 
current values in the database have been displayed. If you stili want to 
delete this record, click the Delete button again Otherwise click the 
Back to List hyperlink. 

Are you sure you want to delete this? 

Department 


Name 

English 
Budget 
$200,000.00 
Start Date 
2017-02-16 
Administrator 
Abercrombie, Kim 

Delete | Back to List 



Yeniden Sil ' e tıklarsanız, departmanın silindiğini gösteren dizin sayfasına yönlendirilirsiniz. 


Güncelleştirme ayrıntıları ve görünüm oluşturma 


isteğe bağlı olarak ayrıntılarda bulunan kodu temizleyebilir ve görünümler oluşturabilirsiniz. 


RovvVersion sütununu silmek ve yöneticinin tam adını göstermek için views/departmanlar/details. cshtml içindeki 
kodu değiştirin. 










@model Contosollniversity.Models.Department 

@{ 

ViewData["Title"] = "Details"; 

} 

<h2>Details</h2> 

<div> 

<h4>Department</h4> 

<hr /> 

<dl class="row"> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Name) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Name) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Budget) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Budget) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.StartDate) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.StartDate) 

</dd> 

<dt class="col-sm-2"> 

@Html.DisplayNameFor(model => model.Administrator) 

</dt> 

<dd class="col-sm-10"> 

@Html.DisplayFor(model => model.Administrator.FullName) 
</dd> 

</dl> 

</div> 

<div> 

<a asp-action="Edit" asp-route-id="@Model.DepartmentID">Edit</a> | 
<a asp-action="Index">Back to List</a> 

</div> 


Açılan listeye bir SELECT seçeneği eklemek için vlews/departmanlar/Create. cshtml içindeki kodu değiştirin. 



@model Contosollniversity.Models.Department 

@{ 

ViewData["Title"] = "Create"; 

} 

<h2>Create</h2> 

<h4>Department</h4> 

<hr /> 

<div class="row"> 

<div class="col-md-4"> 

<form asp-action="Create"> 

<div asp-validation-summary="ModelOnly" class="text-danger"x/div> 

<div class="form-group"> 

<label asp-for="Name" class="control-label"x/label> 

<input asp-for="Name" class="form-control" /> 

<span asp-validation-for="Name" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Budget" class="control-label"x/label> 

<input asp-for="Budget" class="form-control" /> 

<span asp-validation-for="Budget" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="StartDate" class="control-label"x/label> 
cinput asp-for="StartDate" class="form-control" /> 

<span asp-validation-for="StartDate" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="InstructorID" class="control-label"x/label> 

<select asp-for="InstructorID" class="form-control" asp-items="ViewBag.InstructorID"> 
<option value="">-- Select Administrator --</option> 

</select> 

</div> 

<div class="form-group"> 

<input type="submit" value="Create" class="btn btn-default" /> 

</div> 

</form> 

</div> 

</div> 

<div> 

<a asp-action="Index">Back to List</a> 

</div> 

@section Scripts { 

@{await Html.RenderPartialAsync("_ValidationScriptsPartial");} 

} 


Kodu alın 

Tamamlanmış uygulamayı indirin veya görüntüleyin. 

Ek kaynaklar 

EF Core eşzamanlılık işleme hakkında daha fazla bilgi için bkz. eşzamanlılık çakışmaları. 

Sonraki adımlar 

Bu öğreticide şunları yaptınız: 

• Eşzamanlılık çakışmaları hakkında öğrenildi 



• izleme özelliği eklendi 

• Oluşturulan departmanlar denetleyicisi ve görünümleri 

• Güncelleştirilmiş dizin görünümü 

• Güncelleştirilmiş düzenleme yöntemleri 

• Güncelleştirilmiş düzenleme görünümü 

• Test edilen eşzamanlılık çakışmaları 

• Silme sayfası güncelleştirildi 

• Güncelleştirilmiş Ayrıntılar ve görünüm oluşturma 

Eğitmen ve öğrenci varlıkları için tablo başına devralma devralmayı nasıl uygulayacağınızı öğrenmek için sonraki 
öğreticiye ilerleyin. 

Sonraki: tablo-hiyerarşi devralmayı Uygula 





Öğretici: EF Core devralma-ASPNET MVC 
uygulama 

11.10.2019 • 12 minutes to read^ Edit Online 


Önceki öğreticide eşzamanlılık özel durumlarını ele alırsınız. Bu öğretici, veri modelinde devralmayı nasıl 
uygulayacağınızı gösterir. 

Nesne odaklı programlamada, kod yeniden kullanımını kolaylaştırmak için devralmayı kullanabilirsiniz. Bu 
öğreticide, instructor ve student sınıflarını, hem Eğitmenler hem de öğrenciler için ortak olan LastName 
gibi özellikleri içeren Person taban sınıfından türetireceğiz olacak şekilde değiştireceksiniz. Herhangi bir Web 
sayfası eklemez veya değiştirmezsiniz, ancak koddan bazılarını değiştireceksiniz ve bu değişiklikler otomatik 
olarak veritabanına yansıtılacaktır. 

Bu öğreticide şunları yaptınız: 

• Devralmayı veritabanına eşle 

• Kişi sınıfını oluşturma 

• Eğitmeni ve öğrenci 'yi güncelleştirme 

• Modele kişi ekleme 

• Geçişleri oluşturma ve güncelleştirme 

• Uygulamayı test etme 


Önkoşullar 

• Eşzamanlılık işle 


Devralmayı veritabanına eşle 

Okul veri modelindeki instructor ve student sınıflarının özdeş birkaç özelliği vardır: 


e 

Student 

Class 

S Properties 

ifj* EnrolImentDate: DateTime? 

jŞf Enrollments:ICollection <Enrollment> 

2? FirstMidName : string 
2? FulIName : string 
^?_LastNamej_strinc^^_ 

jff IDıint 

V_/ 


S 


instructor 

(D 

Class 



S Properties 

_^?Coursesj_ICoHection<Cou rseAssiq n ment > 
FirstMidName : string 
f_FullNamej_strin^_ 

^^HİreDate : DateTime? 

2? ID : int 

| LastName : string 
23* OfficeAssignment: OfficeAssignment 

V___/ 


@No__t-0 ve student varlıkları tarafından paylaşılan özellikler için gereksiz kodu ortadan kaldırmak 
istediğinizi varsayalım. Ya da adın bir eğitmenden veya bir öğrenciye ait olup olmadığına bakılmaksızın adları 
biçimlendirmeden bir hizmet yazmak isteyebilirsiniz. Yalnızca bu paylaşılan özellikleri içeren bir Person taban 
sınıfı oluşturabilirsiniz, ardından aşağıdaki çizimde gösterildiği gibi, instructor ve student sınıflarının bu 
temel sınıftan devralmasını sağlayabilirsiniz: 



























Bu devralma yapısının veritabanında temsil edilebilmesi için birkaç yol vardır.Tek bir tabloda hem öğrenciler 
hem de eğitmenler hakkında bilgi içeren bir kişi tablonuz olabilir. Bazı sütunlar yalnızca Eğitmenler (HireDate), 
bazıları yalnızca öğrencilerle (kayıttarihi), bazıları ise (soyadı, adı) için geçerlidir. Genellikle, her bir satırın temsil 
ettiği türü belirtmek için bir Ayrıştırıcı sütunu vardır. Örneğin, ayrıştırıcı sütununda, Eğitmenler için "eğitmen" 
ve öğrenciler için "öğrenci" bulunabilir. 



Both 

Instructors only 
Students only 


Tek bir veritabanı tablosundan bir varlık devralma yapısı oluşturmanın bu düzeni, hiyerarşi başına tablo (TPH) 
devralma olarak adlandırılır. 

Alternatif olarak, veritabanının devralma yapısına benzer bir şekilde görünmesini sağlayabilirsiniz. Örneğin, 
kişi tablosunda yalnızca ad alanları olabilir ve Tarih alanlarıyla ayrı eğitmen ve öğrenci tabloları vardır. 


Person 

? İD 

LastName 

FirstIMame 





Instructor 


Student 

9 ID 

HireDate 

* id 

EnrolImentDate 



Her varlık sınıfı için bir veritabanı tablosu yapmanın bu düzeni, tür başına tablo (TPT) devralma olarak 
adlandırılır. 





































Başka bir seçenek de Özet olmayan tüm türleri tek tek tablolarla eşlemenize olanak sağlar. Devralınan 
özellikler de dahil olmak üzere bir sınıfın tüm özellikleri karşılık gelen tablonun sütunlarına eşlenir. Bu düzene, 
tablo başına somut sınıf (TPC) devralma adı verilir. Daha önce gösterildiği gibi, kişi, öğrenci ve eğitmen sınıfları 
için TPC devralmayı uyguladıysanız, öğrenci ve eğitmen tabloları, devralındıktan sonra, devralma 
uygulandıktan sonra farklı şekilde görünür. 

TPC ve TPH devralma desenleri genellikle TPT devralma desenlerinden daha iyi performans sağlar, çünkü TPT 
desenleri karmaşık JOIN sorgularına yol açabilir. 

Bu öğreticide, TPH devralmanın nasıl uygulanacağı gösterilmektedir.TPH Entity Framevrork Core desteklediği 
tek devralma modelidir. @No__t-0 sınıfı oluşturmak, Person ' ten türetmek için instructor ve student 
sınıflarını değiştirin, yeni sınıfı DbContext ' e ekleyin ve bir geçiş oluşturun. 


TIP 

Aşağıdaki değişiklikleri yapmadan önce projenin bir kopyasını kaydetmeyi göz önünde bulundurun. Daha sonra 
sorunlarla karşılaşırsanız ve baştan başlamak gerekirse, bu öğretici için yapılan adımları tersine çevirme veya tüm serinin 
başlangıcına geri dönme yerine kaydedilen projeden başlamak daha kolay olacaktır. 


Kişi sınıfını oluşturma 

Modeller klasöründe Person.cs oluşturun ve şablon kodunu şu kodla değiştirin: 

using System.ComponentModel.DataAnnotations; 
using System.ComponentModel.DataAnnotations.Schema; 

namespace ContosoUniversity.Models 

{ 

public abstract class Person 

{ 

public int ID { get; set; } 

[Required] 

[StringLength(50)] 

[Display(Name = "Last Name")] 
public string LastName { get; set; } 

[Required] 

[StringLength(50, ErrorMessage = "First name cannot be longer than 50 characters.")] 
[Column("FirstName")] 

[Display(Name = "First Name")] 

public string FirstMidName { get; set; } 

[Display(Name = "Full Name")] 
public string FullName 
{ 

get 

{ 

return LastName + ", " + FirstMidName; 

} 

} 

} 

} 


Eğitmeni ve öğrenci 'yi güncelleştirme 

lnstructor.cs' de, kişi sınıfından eğitmen sınıfını türetirsiniz ve anahtar ve ad alanlarını kaldırın. Kod aşağıdaki 
örneğe benzer şekilde görünür: 










using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace Contosollniversity .Models 

{ 

public class Instnuctor : Person 

{ 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 

[Display(Name = "Hire Date")] 

public DateTime HireDate { get; set; } 

public ICollection<CourseAssignment> CourseAssignments { get; set; } 
public OfficeAssignment OfficeAssignment { get; set; } 

} 

} 


Student.es' de aynı değişiklikleri yapın. 

using System; 

using System.Collections.Generic; 

using System.ComponentModel.DataAnnotations; 

using System.ComponentModel.DataAnnotations.Schema; 

namespace Contosollniversity .Models 

{ 

public class Student : Person 

{ 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode = true)] 

[Display(Name = "Enrollment Date")] 

public DateTime EnrollmentDate { get; set; } 


public ICollection<Enrollment> Enrollments { get; set; } 

} 

} 


Modele kişi ekleme 

Kişi varlık türünü SchoolContext.csöğes\r\e ekleyin. Yeni satırlar vurgulanır. 





using Contosollniversity.Models; 
using Microsoft.EntityFrameworkCore; 

namespace Contosollniversity .Data 

{ 

public class SchoolContext : DbContext 

{ 

public SchoolContext(DbContextOptions<SchoolContext> options) : base(options) 

{ 

} 


public DbSet<Course> Courses { get; set; } 

public DbSet<Enrollment> Enrollments { get; set; } 

public DbSet<Student> Students { get; set; } 

public DbSet<Department> Departments { get; set; } 

public DbSet<Instructor> Instructors { get; set; } 

public DbSet<OfficeAssignment> OfficeAssignments { get; set; } 

public DbSet<CourseAssignment> CourseAssignments { get; set; } 

public DbSet<Person> People { get; set; } 

protected override void OnModelCreating(ModelBuilder modelBuilder) 

{ 

modelBuilder.Entity<Course>().ToTable("Course"); 
modelBuilder.Entity<Enrollment>().ToTable("Enrollment"); 
modelBuilder.Entity<Student>().ToTable("Student"); 
modelBuilder.Entity<Department>().ToTable("Department"); 
modelBuilder.Entity<Instructor>().ToTable("Instructor"); 
modelBuilder.Entity<OfficeAssignment>().ToTable("OfficeAssignment"); 
modelBuilder.Entity<CourseAssignment>().ToTable("CourseAssignment"); 
modelBuilder.Entity<Person>().ToTable("Person"); 


} 


} 


} 


modelBuilder.Entity<CourseAssignment>() 

.HasKey(c => new { c.CourselD, c.InstructorlD }); 


Bu, Entity Framevvork hiyerarşinin devralma devralınmasını yapılandırmak için gereklidir.Gördüğünüz gibi, 
veritabanı güncelleştirdiği sırada öğrenci ve eğitmen tablolarının yerine bir kişi tablosu olacaktır. 

Geçişleri oluşturma ve güncelleştirme 

Değişikliklerinizi kaydedin ve projeyi derleyin. Ardından proje klasöründe komut penceresini açın ve aşağıdaki 
komutu girin: 

dotnet ef migrations add Inheritance 


@No__t-0 komutunu henüz çalıştırmayın. Bu komut, eğitmen tablosunu bırakacak ve öğrenci tablosunu kişi 
olarak yeniden adlandırdığı için kayıp veri oluşmasına neden olur. Varolan verileri korumak için özel kod 
sağlamanız gerekir. 

Geçişleri/<timestamp > _Devralma. cs ' i açın ve up yöntemini aşağıdaki kodla değiştirin: 





protected override void Up(MigrationBuilder migrationBuilder) 

{ 

migrationBuilder.DropForeignKey( 

name: "FK_Enrollment_Student_StudentID", 
table: "Enrollment"); 

migrationBuilder.DropIndex(name: "IX_Enrollment_StudentID", table: "Enrollment"); 

migrationBuilder.RenameTable(name: "Instructor", newName: "Person"); 

migrationBuilder.AddColumn<DateTime>(name: "EnrollmentDate", table: "Person", nullable: true); 

migrationBuilder.AddColumn<string>(name: "Discriminator", table: "Person", nullable: false, maxLength 
128, defaultValue: "Instructor"); 

migrationBuilder.AlterColumn<DateTime>(name: "FlireDate", table: "Person", nullable: true); 

migrationBuilder.AddColumn<int>(name: "Oldld", table: "Person", nullable: true); 

// Copy existing Student data into new Person table. 

migrationBuilder.Sql("INSERT INTO dbo.Person (LastName, FirstName, HireDate, EnrollmentDate, 
Discriminator, Oldld) SELECT LastName, FirstName, null AS FlireDate, EnrollmentDate, 'Student' AS 
Discriminator, ID AS Oldld FROM dbo.Student"); 

// Fix up existing relationships to match new PK's. 

migrationBuilder. Sql( "UPDATE dbo. Enrollment SET Studentld = (SELECT ID FROM dbo. Person IaIHERE Oldld = 
Enrollment.Studentld AND Discriminator = 'Student')"); 

// Remove temporary key 

migrationBuilder.DropColumn(name: "OldlD", table: "Person"); 

migrationBuilder.DropTable( 
name: "Student"); 

migrationBuilder.Createlndex( 

name: "IX_Enrollment_StudentID", 
table: "Enrollment", 
column: "StudentlD"); 

migrationBuilder.AddForeignKey( 

name: "FK_Enrollment_Person_StudentID", 

table: "Enrollment", 

column: "StudentlD", 

principalTable: "Person", 

principalColumn: "ID", 

onDelete: ReferentialAction.Cascade); 


Bu kod aşağıdaki veritabanı güncelleştirme görevlerini gerçekleştirir: 

• Yabancı anahtar kısıtlamalarını ve öğrenci tablosuna işaret eden dizinleri kaldırır. 

• Eğitmen tablosunu kişi olarak yeniden adlandırır ve öğrenci verilerini depolamak için gerekli 
değişiklikleri yapar: 

• Öğrenciler için Nullable kayıt tarihi ekler. 

• Bir satırın bir öğrenci mi yoksa bir eğitmen mi olduğunu göstermek için ayrıştırıcı sütunu ekler. 

• Öğrenci satırlarında işe alma tarihleri olmadığından, HireDate null yapılabilir hale gelir. 

• Öğrencilere işaret eden yabancı anahtarları güncelleştirmek için kullanılacak geçici bir alan ekler. 
Öğrencileri kişi tablosuna kopyaladığınızda, yeni birincil anahtar değerleri alırlar. 

• Öğrenci tablosundaki verileri kişi tablosuna kopyalar. Bu, öğrencilerden yeni birincil anahtar değerleri 
atanmasını sağlar. 

• Öğrencilere işaret eden yabancı anahtar değerlerini düzeltir. 


• Yabancı anahtar kısıtlamalarını ve dizinleri yeniden oluşturur, şimdi bunları kişi tablosuna işaret eder. 



(Birincil anahtar türü olarak tamsayı yerine GUID kullandıysanız, öğrenci birincil anahtar değerlerinin 
değiştirilmesi gerekmez ve bu adımların bazıları atlanamaz.) 

@No__t-0 komutunu çalıştırın: 

dotnet ef database update 

(Bir üretim sisteminde, önceki veritabanı sürümüne geri dönmek için bunu kullanmanız durumunda Down 
yönteminde ilgili değişiklikleri yaparsınız. Bu öğreticide Down yöntemini kullanmayacağız.) 


NOTE 

Varolan verileri içeren bir veritabanında şema değişiklikleri yaparken başka hatalar almak mümkündür. Çözemiyoruz geçiş 
hataları alırsanız, bağlantı dizesindeki veritabanı adını değiştirebilir veya veritabanını silebilirsiniz. Yeni bir veritabanı ile 
geçirilecek veri yoktur ve Update-Database komutunun hatasız tamamlanabilmesi daha olasıdır. Veritabanını silmek için, 
SSOX kullanın veya database drop CLı komutunu çalıştırın. 


Uygulamayı test etme 

Uygulamayı çalıştırın ve çeşitli sayfaları deneyin. Her şey, daha önce olduğu gibi çalışmaktadır. 

SQL Server Nesne Gezgini, veri bağlantıları/SchoolContext ve ardından Tablolar 1 ı genişletin ve öğrenci 
ve eğitmen tablolarının bir kişi tablosu ile değiştirildiğini görürsünüz. Kişi tablosu tasarımcısını açın ve 
öğrencinin ve eğitmen tablolarında kullanılan tüm sütunları olduğunu görürsünüz. 


ContosoUniversity 
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Update Script File: 

dbo. Person. sql 


* 


Name 

Data Type 

Allow Nulls 

Default A Keys (1) 


-« İD 

int 

□ 

PKJnstructor (Primary K 





Check Constraints (0) 


FirstName 

nvarchar(50) 

□ 

|nı|ptfpc 1 


HireDate 

datetime2(7) 

0 

IIIUCAC3 \y) 

Foreign Keys (0) 


LastName 

nvarchar(50) 

□ 

Triggers (0) 


EnrollmentDate 

datetime2(7) 

0 



Discriminator 

nvarchar(128) 

□ 

(N'Instructor') 


Q Design 14- ST-SQL 

1 BCREATE TABLE [dbo]. [Person] ( 

[ID] INT 

[FirstName] NVARCHAR (50) 

[HireDate] DATETIME2 (7) 

[LastName] NVARCHAR (50) 

[EnrollmentDate] DATETIME2 (7) 
[Discriminator] 


EBE 


2 

3 

4 

5 

e 

7 

8 
9 

10 

100 % - 4 


IDENTITY (1, 1) NOT NULL, 

NOT NULL, 

NULL, 

NOT NULL, 

NULL, 

NVARCHAR (128) DEFAULT (N'Instructor' ) NOT NULL, 
CONSTRAINT [PK_Instructor] PRIMARY KEY CLUSTERED ([ID] ASC) 


); 


Çİj) Connection Ready 


(localdb)\MSSQLLocalDB REDMOND\tdykstra aspnet-ContosoUniversi.. 


Kişi tablosuna sağ tıklayın ve ardından tablo verilerini göster 1 e tıklayarak ayrıştırıcı sütununu görüntüleyin. 















0^ ContosoUniversity 




a 

< 

▼ 

6 | T 0 T % Max Rows: 
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İD 

FirstName 

HireDate 

LastName 

Enrollme... 

Discriminator 


► 

0 

Kim 

3/11/1995. 

Abercrombie 

NULL 

Instructor 


2 

Fadi 

7/6/2002 .. 

Fakhouri 

NULL 

Instructor 


3 

Roger 

7/1/1998 .. 

Harui 

NULL 

Instructor 


4 

Candace 

1/15/2001. 

Kapoor 

NULL 

Instructor 


5 

Roger 

2/12/2004. 

Zheng 

NULL 

Instructor 


7 

Nancy 

8/17/2016. 

Davolio 

NULL 

Instructor 


8 

Carson 

NULL 

Alexander 

9/1/2010 ... 

Student 


9 

Meredith 

NULL 

Alonso 

9/1/2012... 

Student 


10 

Arturo 

NULL 

Anand 

9/1/2013... 

Student 


11 

Gytis 

NULL 

Barzdukas 

9/1/2012... 

Student 



Kodu edinin 

Tamamlanmış uygulamayı indirin veya görüntüleyin. 

Ek kaynaklar 

Entity Framevvork Core devralma hakkında daha fazla bilgi için bkz. Devralma. 

Sonraki adımlar 

Bu öğreticide şunları yaptınız: 

• Veritabanına devralma eşlenmiş 

• Kişi sınıfı oluşturuldu 

• Güncelleştirilmiş eğitmen ve öğrenci 

• Modele kişi eklendi 

• Geçişleri oluşturma ve güncelleştirme 

• Uygulama test edildi 

Çeşitli görece gelişmiş Entity Framevvork senaryolarını nasıl işleyeceğinizi öğrenmek için sonraki öğreticiye 
ilerleyin. 


ileri: gelişmiş konular 






















Öğretici: Gelişmiş senaryolar hakkında bilgi edinin- 
EF Core ASRNET MVC 

11.10.2019 • 22 minutes to readı Edit Online 


Önceki öğreticide, tablo başına devralma devralmayı uyguladık. Bu öğreticide, Entity Framevvork Core kullanan 
ASP.NET Core Web uygulamaları geliştirme hakkında temel bilgileri aşdığınızda dikkat etmeniz yararlı olan 
birkaç konu sunulmaktadır. 

Bu öğreticide şunları yaptınız: 

• Ham SQL sorguları gerçekleştirme 

• Varlıkları döndürmek için bir sorgu çağırın 

• Başka türler döndürmek için bir sorgu çağırın 

• Güncelleştirme sorgusu çağırma 

• SQL sorgularını inceleyin 

• Soyutlama katmanı oluşturma 

• Otomatik değişiklik algılama hakkında bilgi edinin 

• EF Core kaynak kodu ve geliştirme planları hakkında bilgi edinin 

• Kodu basitleştirmek için dinamik LINQ kullanmayı öğrenin 

Önkoşullar 

• Devralmayı Uygula 

Ham SQL sorguları gerçekleştirme 

Entity Framevvork kullanmanın avantajlarından biri, kodunuzun veri depolarken belirli bir yönteme çok 
benzemesidir. Bunu sizin için SQL sorguları ve komutları oluşturarak yapar, bu da sizi kendiniz yazmak zorunda 
kalmaktan kurtarır. Ancak el ile oluşturduğunuz belirli SQL sorgularını çalıştırmanız gerektiğinde olağanüstü 
senaryolar vardır. Bu senaryolar için Entity Framevvork Code First API 'SI, SQL komutlarını doğrudan 
veritabanına geçirmenize olanak sağlayan yöntemleri içerir. EF Core 1,0 ' de aşağıdaki seçenekleriniz vardır: 

• Varlık türleri döndüren sorgular için DbSet.FromSqi yöntemini kullanın. Döndürülen nesneler DbSet 
nesnesi tarafından beklenen türde olmalıdır ve izlemeyikapatmadığınız takdirde veritabanı bağlamı 
tarafından otomatik olarak izlenir. 

• Sorgu olmayan komutlar için Database.ExecuteSqlCommand kullanın. 

Varlık olmayan türleri döndüren bir sorgu çalıştırmanız gerekiyorsa, EF tarafından sunulan veritabanı 
bağlantısıyla ADO.NET kullanabilirsiniz. Döndürülen veriler, varlık türlerini almak için bu yöntemi kullanıyor 
olsanız bile veritabanı bağlamı tarafından izlenmez. 

Her zaman doğru olduğu gibi, bir Web uygulamasında SQL komutları yürüttüğünüzde, sitenizi SQL ekleme 
saldırılarına karşı korumak için önlemler almalısınız. Bunu yapmanın bir yolu, bir Web sayfası tarafından 
gönderilen dizelerin SQL komutları olarak yorumlanamadığından emin olmak için parametreli sorgular 
kullanmaktır. Bu öğreticide Kullanıcı girişini bir sorguyla tümleştirdiğinizde parametreli sorgular kullanacaksınız. 

Varlıkları döndürmek için bir sorgu çağırın 

@No__t-0 sınıfı, TEntity türünde bir varlık döndüren bir sorgu yürütmek için kullanabileceğiniz bir yöntem 









sağlar. Bunun nasıl çalıştığını görmek için, Bölüm denetleyicisinin Details yönteminde kodu değiştirirsiniz. 

DepartmentsController.es' de, Details yönteminde, aşağıdaki vurgulanmış kodda gösterildiği gibi bir 
departmanı alan kodu FromSqi yöntem çağrısıyla değiştirin: 

public async Task<IActionResult> Details(int? id) 

{ 

if (id == null) 

{ 

return NotFound(); 

} 

string query = "SELECT * FROM Department IaIHERE DepartmentlD = {0}"j 
var department = await _context.Departments 
.FromSql(query, id) 

.Include(d => d.Administrator) 

.AsNoTracking() 

.FirstOrDefaultAsync(); 

if (department == null) 

{ 

return NotFound(); 

} 

return View(department); 

} 


Yeni kodun doğru şekilde çalıştığını doğrulamak için Departmanlar sekmesini seçin ve sonra departmanlardan 
birine ilişkin ayrıntıları izleyin. 


B Details - Contoso Unive X -(- 

^ Ç3 localhost:' 313/Deps- 


Contoso University 


x 


☆ 


Details 

Department 


Budget 

$ 200 , 000.00 

Name 

English 

Administrator 

Abercrombie, Kim 

Start Date 

2016 - 12-31 


-AA 




Başka türler döndürmek için bir sorgu çağırın 

Daha önce, yaklaşık bir kayıt tarihi için öğrenci sayısını gösteren hakkında sayfasında bir öğrenci istatistikleri 
Kılavuzu oluşturdunuz. Öğrenciler varlık kümesindeki ( _context.students ) verileri aldınız ve LINQ ’ı, sonuçları 
bir EnroiimentDateGroup görünüm modeli nesneleri listesine eklemek için kullandınız. LINQ kullanmak yerine 
SQL 'in kendisini yazmak istediğinizi varsayalım. Bunu yapmak için, varlık nesnelerinden başka bir şey döndüren 
bir SQL sorgusu çalıştırmanız gerekir. EF Core 1,0 ' de, bunu yapmanın bir yolu ADO.NET kodunu yazıp EF 'ten 
veritabanı bağlantısı almanızı sağlar. 















HomeController.es' de About yöntemini aşağıdaki kodla değiştirin: 


public async Task<ActionResult> About() 

{ 

List<EnrollmentDateGroup> groups = new List<EnrollmentDateGroup>(); 
var conn = _context.Database.GetDbConnection(); 
try 
{ 

await conn.OpenAsync(); 

using (var command = conn.CreateCommand()) 

{ 

string query = "SELECT EnrollmentDate, COUNT(*) AS StudentCount " 

+ "FROM Person " 

+ "WHERE Discriminator = 'Student' " 

+ "GROUP BY EnrollmentDate"; 
command.CommandText = query; 

DbDataReader reader = await command.ExecuteReaderAsync(); 

if (reader.HasRows) 

{ 

while (await reader.ReadAsync()) 

{ 

var row = new EnrollmentDateGroup { EnrollmentDate = reader.GetDateTime(0), StudentCount 
= reader.Getlnt32(l) }; 

groups.Add(row); 

} 

} 

reader.Dispose(); 

} 

} 

finally 

{ 

conn.Close(); 

} 

return View(groups); 


Using deyimleri ekleme: 


using System.Data.Common; 


Uygulamayı çalıştırın ve hakkında sayfasına gidin. Daha önce yaptığımız verileri görüntüler. 
localhost:5313/ 'fo 


Contoso University 


Student Body Statistics 

Enrollment DateStudents 


9 / 1/2005 1 

9 / 1/2010 1 

9 / 1/2011 1 



Güncelleştirme sorgusu çağırma 

Contoso Üniversitesi yöneticilerinin veritabanında, her kurs için kredi sayısını değiştirme gibi genel değişiklikleri 
gerçekleştirmesini istediğini varsayalım. Üniversitenin çok sayıda kursu varsa, bunların tümünü varlıklar olarak 
almak ve tek tek değiştirmek verimsiz olur. Bu bölümde, kullanıcının tüm kurslar için kredi sayısını değiştirecek 








bir faktör belirtmesini sağlayan bir Web sayfası uygulayacaksınız ve bir SQL UPDATE ifadesini yürüterek 
değişikliği yaparsınız. Web sayfası aşağıdaki çizimde gösterildiği gibi görünür: 


H UpdateCourseCredits - X + 


□ X 


o 

■••••■ 

Ilı 

-IX 

Contoso University 


— 

Update Course Credits 



Enter a rıumber to multiply every course's credits by: 

El 

X 


Update 








CoursesController.es' de, HttpGet ve HttpPost için UpdateCourseCredits yöntemleri ekleyin: 

public IActionResult UpdateCourseCredits() 

{ 

return View(); 

} 


[HttpPost] 

public async Task<IActionResult> UpdateCourseCredits(int? multiplier) 

{ 

if (multiplier != null) 

{ 

ViewData["RowsAffected"] = 

await _context.Database.ExecuteSqlCommandAsync( 

"UPDATE Course SET Credits = Credits * {0}", 
parameters: multiplier); 

} 

return View(); 

} 

Denetleyici bir HttpGet isteğini işlediğinde, viewData["RowsAffected"] 1 a hiçbir şey döndürülmez ve görünüm, 
önceki çizimde gösterildiği gibi boş bir metin kutusu ve bir Gönder düğmesi görüntüler. 

Update düğmesine tıklandığında, HttpPost yöntemi çağırılır ve Multiplier metin kutusuna girilen değer vardır. 
Kod daha sonra, bu güncelleştirmeleri güncelleştiren SQL 'i yürütür ve etkilenen satırların sayısını viewData ' da 
görünümüne döndürür. Görünüm bir RowsAffected değeri aldığında, güncelleştirilmiş satır sayısını görüntüler. 

Çözüm Gezgini, Görünümler/kurslar klasörüne sağ tıklayın ve ardından > yeni öğe Ekle 1 ye tıklayın. 

Yeni öğe Ekle iletişim kutusunda sol bölmede yüklü ASP.NET Core ' a tıklayın, Razor görünümü' ne tıklayın 
ve yeni görünüm UpdateCourseCredits. cs/ıfm/olarak adlandırın. 

Views/kurslar/UpdateCourseCredits. cshfm/içinde, şablon kodunu şu kodla değiştirin: 




















@{ 

ViewBag.Title = "UpdateCourseCredits"; 

} 

<h2>Update Course Credits</h2> 

Şif (ViewData["RowsAffected"] == null) 

{ 

<form asp-action="UpdateCourseCredits"> 

<div class="form-actions no-color"> 

<P> 

Enter a number to multiply every course's credits by: ŞHtml.TextBox("multiplier") 

</p> 

<P> 

<input type="submit" value="Update" class="btn btn-default" /> 

</p> 

</div> 

</form> 

} 

Şif (ViewData["RowsAffected"] != null) 

{ 

<P> 

Number of rows updated: ŞViewData["RowsAffected"] 

</p> 

} 

<div> 

ŞHtml.ActionLink("Back to List", "Index") 

</div> 


@No__t-0 yöntemini, Kurslar sekmesini seçerek çalıştırın, sonra tarayıcının adres çubuğundaki URL 'nin sonuna 
"/UpdateCourseCredits" ekleyin (örneğin: http://iocaihost:58i3/courses/updateCourseCredits ). Metin kutusuna 
bir sayı girin: 


H UpdateCourseCredits - X + 


- □ X 

^ Q ^ 

m & - 

Contoso University 


— 

Update Course Credits 



Enter a number to multiply every course's credits by: 

2 



Update 



Güncel leşti re tıklayın. Etkilenen satır sayısını görürsünüz: 


H UpdateCourseCredits - X + 


□ X 

^ /Courses/UpdateCourseCredits 

☆ 

o 

■••••■ 

Ilı 

Contoso University 


— 


Update Course Credits 


Number of rows updated: 7 























Düzeltilen kredi sayısına sahip kurslar listesini görmek için listeye geri ' ye tıklayın. 

Üretim kodunun güncelleştirmelerin her zaman geçerli verilerle sonuçlandığına emin olun. Burada gösterilen 
kod, 5 ' ten fazla sayı ile sonuçlanacak kredilerin sayısını çarpamaz. (@No__t-0 özelliği bir 
özniteliğine sahiptir.) Güncelleştirme sorgusu çalışır, ancak geçersiz veriler sistemin diğer 
bölümlerinde, kredi sayısının 5 veya daha az olduğunu varsayacak beklenmedik sonuçlara neden olabilir. 

Ham SQL sorguları hakkında daha fazla bilgi için bkz. Ham SQL sorguları. 

SQL sorgularını inceleyin 

Bazen veritabanına gönderilen gerçek SQL sorgularını görmeniz yararlı olabilir.ASP.NET Core için yerleşik 
günlük işlevselliği, sorgular ve güncelleştirmeler için SQL içeren günlükleri yazmak üzere EF Core tarafından 
otomatik olarak kullanılır. Bu bölümde, SQL günlüğe kaydetme işleminin bazı örneklerini görürsünüz. 

StudentsController.es ' i açın Details yöntemi if (student == nuii) ifadesinde bir kesme noktası ayarlayın. 

Uygulamayı hata ayıklama modunda çalıştırın ve bir öğrenci için ayrıntılar sayfasına gidin. 

Hata ayıklama çıkışını gösteren Çıkış penceresine gidin ve sorguyu görürsünüz: 

Microsoft.EntityFrameworkCore.Database.Command:Information: Executed DbCommand (56ms) [Parameters= 

[@_id_0='?']j CommandType='Text ’, CommandTimeout='30'] 

SELECT T0P(2) [s].[ID], [s]. [Discriminator][s].[FirstName ], [s].[LastName ], [s].[EnrollmentDate] 

FROM [Person] AS [s] 

IaIHERE ([s]. [Discriminator] = N'Student') AND ([s].[ID] = @_id_0) 

ORDER BY [s].[ID] 

Microsoft.EntityFrameiA/orkCore.Database.Command:Information: Executed DbCommand (122ms) [Parameters= 

[@_id_0='?']j CommandType='Text’, CommandTimeout='30'] 

SELECT [s.Enrollments].[EnrollmentlD], [s.Enrollments].[CourselD], [s.Enrollments].[Grade ], [s.Enrollments]. 
[StudentlD], [e.Course].[CourselD], [e.Course].[Credits ], [e.Course].[DepartmentlD], [e.Course].[Title] 

FROM [Enrollment] AS [s.Enrollments] 

INNER 10IN [Course] AS [e.Course] ON [s.Enrollments]. [CourselD] = [e.Course]. [CourselD] 

INNER JOIN ( 

SELECT TOP(l) [s0].[ID] 

FROM [Person] AS [s0] 

IaIHERE ([s0]. [Discriminator] = N'Student') AND ([s0].[ID] = @_id_0) 

ORDER BY [s0].[ID] 

) AS [t] ON [s.Enrollments].[StudentlD] = [t].[ID] 

ORDER BY [t].[ID] 


basitleştirilmiş 
[Range(0j 5)] 


Size beklenmedik bir şekilde bir sorun olduğunu fark edeceksiniz: SQL, kişi tablosundan 2 1 ye kadar satır ( 
top( 2 ) ) seçer. @No__t-0 yöntemi sunucuda 1 satıra çözümlenmiyor. İşte şunları yapın: 

• Sorgu birden çok satır döndürürse, yöntemi null döndürür. 

• Sorgunun birden çok satır döndürüp döndürmeyeceğini anlamak için EF 'in en az 2 değerini döndürüp 
döndürmediğini denetlemesi gerekir. 

Ç 1 kış penceresinde günlüğe kaydetme çıktısını almak için hata ayıklama modunu kullanmanız ve bir kesme 
noktasında durdurmanız gerekmediğini unutmayın. Bu, çıkışa bakmak istediğiniz noktada günlüğe kaydetmeyi 
durdurmak için kullanışlı bir yoldur. Bunu yapmazsanız, günlüğe kaydetme devam eder ve ilgilendiğiniz parçaları 
bulmak için geri kaydırmanız gerekir. 

Soyutlama katmanı oluşturma 

Birçok geliştirici, Entity Framevvork ile çalışan kodun etrafında bir sarmalayıcı olarak depo ve iş birimi düzenlerini 
uygulamak için kod yazar. Bu desenler, veri erişim katmanı ve bir uygulamanın iş mantığı katmanı arasında bir 
soyutlama katmanı oluşturmak için tasarlanmıştır. Bu desenleri uygulamak, uygulamanızın veri deposundaki 
değişikliklerden yalıtılmış hale getirmenize yardımcı olabilir ve otomatik birim testi veya test odaklı geliştirmeyi 





(TDD) kolaylaştırabilir. Ancak, bu desenleri uygulamak için ek kod yazmak, birkaç nedenden dolayı EF kullanan 
uygulamalar için her zaman en iyi seçimdir: 

• EF bağlam sınıfının kendisi, veri deposuna özgü koddan kodunuzun kendisini uygular. 

• EF bağlam sınıfı, EF kullanarak yaptığınız veritabanı güncelleştirmeleri için bir iş birimi sınıfı işlevi 
görebilir. 

• EF, depo kodu yazmadan TDD uygulamaya yönelik özellikler içerir. 

Deponun ve iş düzeni birimlerinin nasıl uygulanacağı hakkında bilgi için, Bu öğretici serisinin Entity Framevvork 
5 sürümünebakın. 

Entity Framevvork Core, test için kullanılabilecek bir bellek içi veritabanı sağlayıcısı uygular. Daha fazla bilgi için 
bkz. InMemory lietestetme. 

Otomatik değişiklik algılama 

Entity Framevvork bir varlığın geçerli değerlerini özgün değerlerle karşılaştırarak bir varlığın nasıl değiştiğini (ve 
bu nedenle veritabanına gönderilmesi gereken güncelleştirmeleri) belirler. Özgün değerler, varlık 
sorgulandığında veya eklendiğinde saklanır. Otomatik değişiklik algılamaya neden olan yöntemlerin bazıları 
şunlardır: 

• DbContext. SaveChanges 

• DbContext. Entry 

• ChangeTracker. Entries 

Çok sayıda varlığı izliyorsanız ve bu yöntemlerden birini bir döngüde birçok kez çağırırsanız, 

ChangeTracker.AutoDetectchangesEnabled özelliğini kullanarak otomatik değişikliği algılamayı geçici olarak 
kapatarak önemli performans iyileştirmeleri alabilirsiniz. Örnek: 

_context.ChangeTracker.AutoDetectchangesEnabled = false; 


EF Core kaynak kodu ve geliştirme planları 

Entity Framevvork Core kaynağı https://github.com/aspnet/EntityFrameworkCore' dir. EF Core deposu gecelik 
derlemeler, sorun izleme, özellik özellikleri, tasarım toplantısı notları ve ileride geliştirmeye yönelik yol 
haritasınıiçerir. Hataları dosyalayabilirsiniz veya bulabilir ve katkıda bulunabilirsiniz. 

Kaynak kodu açık olsa da Entity Framework Core, Microsoft ürünü olarak tam olarak desteklenmektedir. 
Microsoft Entity Framework ekibi, her bir yayının kalitesini sağlamak için, hangi katkıların kabul edildiğini 
denetler ve tüm kod değişikliklerini sınar. 

Mevcut veritabanından ters mühendislik 

Mevcut bir veritabanından varlık sınıfları dahil bir veri modeline ters mühendislik uygulamak için Scaffold- 
DbContext komutunu kullanın. Bkz. Başlangıç öğreticisi. 

Kodu basitleştirmek için dinamik LINQ kullanma 

Bu serideki üçüncü öğreticide , switch ifadesinde sabit kodlama sütun adları aracılığıyla LINQ kodunun nasıl 
yazılacağı gösterilmektedir. Arasından seçim yapabileceğiniz iki sütun varsa, bu sorunsuz bir şekilde yapılır, ancak 
çok sayıda sütununuzla karşılaşırsanız, kod ayrıntılı alabilir. Bu sorunu çözmek için, özelliğin adını dize olarak 
belirtmek üzere EF.Property yöntemini kullanabilirsiniz. Bu yaklaşımı denemek için, studentscontroiler 'deki 








index yöntemini aşağıdaki kodla değiştirin. 


public async Task<IActionResult> Index( 
string sortOrder, 
string currentFilter, 
string searchString, 
int? pageNumber) 

{ 

ViewData["CurrentSort"] = sortOrder; 

ViewData["NameSortParm"] = 

String.IsNullOrEmpty(sortOrder) ? "LastName_desc" : 
ViewData["DateSortParm"] = 

sortOrder == "EnrollmentDate" ? "EnrollmentDate_desc" : "EnrollmentDate"; 

if (searchString != null) 

{ 

pageNumber = 1; 

} 

else 

{ 

searchString = currentFilter; 

} 

ViewData["CurrentFilter"] = searchString; 

var students = from s in _context.Students 
select s; 


if (!String.IsNullOrEmpty(searchString)) 

{ 


students = students.Where(s => s.LastName.Contains(searchString) 

| s.FirstMidName.Contains(searchString)); 


} 

if (string.IsNullOrEmpty(sortOrder)) 

{ 


sortOrder = "LastName"; 


} 


bool descending = false; 
if (sortOrder.EndsWith("_desc")) 

{ 

sortOrder = sortOrder.Substring(0, sortOrder.Length - 5); 
descending = true; 

} 

if (descending) 

{ 

students = students.OrderByDescending(e => EF.Property<object>(e, sortOrder)); 

} 

else 

{ 

students = students.OrderBy(e => EF.Property<object>(e, sortOrder)); 

} 


int pageSize = 3; 

return View(await PaginatedList<Student>.CreateAsync(students.AsNoTracking() 3 
pageNumber ?? 1 , pageSize)); 


Bilgilendirme 

Tom Dykstra ve Rick Anderson (Tvvitter @RickAndMSFT) bu öğreticiyi yazdı. ROWA Miller, Diego Vega ve kod 
incelemeleri ile Entity Framevvork ekip yardımlı diğer üyeleri ve öğreticiler için kod yazarken oluşan sorunları 
ayıkladık. John Parente ve Paul Goldman, 2,2 ASP.NET Core öğreticisini güncelleştirmeye çalıştı. 


Sık karşılaşılan hataları giderme 

Başka bir işlem tarafından kullanılan Contosollniversity. dil 

Hata iletisi: 

Açılamıyor Bin\debug\netcoreapp1.0\contosoijniversity.dll ' yazma için—' başka bir işlem tarafından 
kullanıldığından, işlem ..\Bin\debug\netcoreapp1 .O\contosoijniversi.dll ' dosyasına erişemiyor. 

Çözümden 

IIS Express sitesini durdurun. Windows sistemi tepsisine 11S Express bulun ve simgesine sağ tıklayın, Contoso 
Üniversitesi sitesini seçin ve ardından siteyi durdur 1 a tıklayın. 

Yukarı ve aşağı metotlarda kod olmadan geçiş yapı iskelesi 

Olası neden: 

EF CLı komutları, kod dosyalarını otomatik olarak kapatmaz ve kaydetmez. @No__t-0 komutunu çalıştırdığınızda 
hiçbir değişiklik yaptıysanız, EF değişiklikleri bulamaz. 

Çözümden 

@No__t-0 komutunu çalıştırın, kod değişikliklerinizi kaydedin ve migrations add komutunu yeniden çalıştırın. 

Veritabanı güncelleştirmesi çalıştırılırken hatalar oluştu 

Varolan verileri içeren bir veritabanında şema değişiklikleri yaparken başka hatalar almak mümkündür. 
Çözümleyemez geçiş hataları alırsanız, bağlantı dizesindeki veritabanı adını değiştirebilir veya veritabanını 
silebilirsiniz. Yeni bir veritabanı ile geçirilecek veri yoktur ve Update-Database komutunun hatasız 
tamamlanabilmesi çok daha yüksektir. 

En basit yaklaşım, appSettings. VSOA/içindeki veritabanını yeniden adlandırmanın bir veritabanıdır. @No__t-0 ' ı 
bir sonraki sefer çalıştırdığınızda yeni bir veritabanı oluşturulur. 

SSOX 'te bir veritabanını silmek için veritabanına sağ tıklayın, Sil' e tıklayın ve ardından veritabanını sil İletişim 
kutusunda varolan bağlantıları kapat ' ı seçin ve Tamam' a tıklayın. 

CLı kullanarak bir veritabanını silmek için database drop CLı komutunu çalıştırın: 

dotnet ef database drop 

SQL Server örneği bulunurken hata oluştu 

Hata İletisi: 

SQL Server ile bağlantı kurulmaya çalışılırken ağ ile ilişkili veya örneğe özgü bir hata oluştu. Sunucu 
bulunamadı veya erişilebilir değildi. Örnek adının doğru olduğundan ve SQL Server uzak bağlantılara izin 
verecek şekilde yapılandırıldığından emin olun, (sağlayıcı: SQL ağ arabirimleri, hata: 26-belirtilen 
sunucu/örnek bulunurken hata oluştu) 

Çözümden 

Bağlantı dizesini denetleyin. Veritabanı dosyasını el ile şildiyseniz, oluşturma dizesindeki veritabanının adını yeni 
bir veritabanı ile başlatılacak şekilde değiştirin. 

Kodu edinin 

Tamamlanmış uygulamayı indirin veya görüntüleyin. 





Ek kaynaklar 

EF Core hakkında daha fazla bilgi için Entity Framevvork Core belgelerinebakın. Bir kitap da kullanılabilir: Entity 
Framework Core eylem. 

Bir Web uygulamasını dağıtma hakkında daha fazla bilgi için bkz. ASP.N ET Core barındırma ve dağıtma. 

Kimlik doğrulama ve yetkilendirme gibi ASP.N ET Core MVC ile ilgili diğer konular hakkında daha fazla bilgi için 
bkz.ASP.NET Core'a Giriş. 

Sonraki adımlar 

Bu öğreticide şunları yaptınız: 

• Ham SQL sorguları gerçekleştiriliyor 

• Varlıkları döndürmek için sorgu çağrıldı 

• Diğer türleri döndürmek için sorgu çağrıldı 

• Bir güncelleştirme sorgusu çağrıldı 

• incelenen SQL sorguları 

• Soyutlama katmanı oluşturma 

• Otomatik değişiklik algılama hakkında bilgi edinildi 

• EF Core kaynak kodu ve geliştirme planları hakkında bilgi edinildi 

• Kodu basitleştirmek için dinamik LINQ kullanımı öğrenildi 

Bu, ASP.NET Core MVC uygulamasında Entity Framework Core kullanımı hakkında bu öğretici serisini 
tamamlar. Bu seri yeni bir veritabanıyla çalıştı; bir alternatif, mevcut bir veritabanından bir modele tersine 
mühendislik kullanmaktır. 

Öğretici: MVC ile EF Core, var olan veritabanı 
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By Pavvet Grudzieh, Davmien Pontıexve Tom Dykstra 

Bu makalede, Entity Framevvork 6 ' nın ASP.NET Core bir uygulamada nasıl kullanılacağı gösterilmektedir. 

Genel Bakış 

Entity Framevvork 6 1 yı kullanmak için, Entity Framevvork 6 ' nın .NET Core 'u desteklemediği için, projenizin .NET 
Framevvork karşı derlenmesi gerekir. Platformlar arası özelliklere ihtiyacınız varsa Entity Framevvork 
Coreyükseltmeniz gerekir. 

ASP.NET Core uygulamasında 6 Entity Framevvork kullanmanın önerilen yolu, tam Framevvork 'ü hedefleyen bir 
sınıf kitaplığı projesine EF6 bağlamını ve model sınıflarını koykullanmaktır. ASP.NET Core projesinden sınıf 
kitaplığına bir başvuru ekleyin. Örnek Visual Studio çözümüne EF6 ve ASP.NET Core projelerinebakın. 

.NET Core projeleri, Enable-geçişler gibi EF6 komutlarının tüm işlevlerini desteklemediğinden, bir ASP.NET Core 
projesine EF6 bağlamı koyamazsınız. 

EF6 bağlamını bulmakta olduğunuz proje türünden bağımsız olarak, yalnızca EF6 komut satırı araçları bir EF6 
bağlamıyla çalışır. Örneğin, scaffoid-DbContext yalnızca Entity Framevvork Core kullanılabilir.Bir veritabanının EF6 
modeline ters mühendislik uygulamanız gerekiyorsa bkz. var olan bir veritabanına Code First. 

ASP.NET Core projesindeki tam Framevvork ve EF6 başvurusu 

ASP.NET Core projenizin .NET Framevvork ve EF6 'e başvurması gerekiyor.Örneğin, ASP.NET Core projenizin . 
csproj dosyası aşağıdaki örneğe benzer olacaktır (yalnızca dosyanın ilgili bölümleri gösterilir). 

<PropertyGroup> 

<TargetFramework>net452</TargetFramework> 

<PreserveCompilationContext>true</PreserveCompilationContext> 

<AssemblyName>MVCCore</AssemblyName> 

<OutputType>Exe</OutputType> 

<PackageId>MVCCore</PackageId> 

</PropertyGroup> 


Yeni bir proje oluştururken ASP.NET Core Web uygulaması (.NET Framevvork) şablonunu kullanın. 

Bağlantı dizelerini işle 

EF6 sınıf kitaplığı projesinde kullanacağınız EF6 komut satırı araçları, bağlamı örneklenebilen bir varsayılan 
Oluşturucu gerektirir. Ancak büyük olasılıkla, AS P.N ET Core projesinde kullanılacak bağlantı dizesini belirtmek 
isteyeceksiniz. Bu durumda, bağlam oluşturucunun bağlantı dizesinde geçiş yapmanızı sağlayan bir parametreye 
sahip olması gerekir, işte bir örnek. 






public class SchoolContext : DbContext 
{ 

public SchoolContext(string connString) : base(connString) 

{ 

} 

EF6 içeriğiniz parametresiz bir oluşturucuya sahip olmadığından, EF6 projenizin bir ıdbcontextfactoryuygulamasını 
sağlaması gerekir. EF6 komut satırı araçları, bağlamı örneklebilmeleri için bu uygulamayı bulup kullanacaktır. İşte 
bir örnek. 

public class SchoolContextFactory : IDbContextFactory<SchoolContext> 

{ 

public SchoolContext Create() 

{ 

return new EF6.SchoolContext("Server= 

(localdb)\\mssqllocaldb;Database=EF6l' / lVCCorejTrusted_Connection=True;MultipleActiveResultSets=true"); 

} 

} 

Bu örnek kodda, iDbContextFactory uygulama sabit kodlanmış bir bağlantı dizesinde geçirilir. Bu, komut satırı 
araçlarının kullanacağı bağlantı dizesidir. Sınıf kitaplığının çağıran uygulamanın kullandığı bağlantı dizesini 
kullandığından emin olmak için bir strateji uygulamak isteyeceksiniz. Örneğin, her iki projedeki bir ortam 
değişkeninden değeri alabilirsiniz. 

ASP.NET Core projesine bağımlılık ekleme işlemini ayarlama 

Çekirdek projenin Startup.es dosyasında, içindeki configureServices bağımlılık ekleme (dı) için EF6 bağlamını 
ayarlayın. EF bağlam nesneleri, istek başına ömür için kapsamı belirlenmiş olmalıdır. 

public void ConfigureServices(IServiceCollection Services) 

{ 

// Add framework Services. 

Services. AddMvc(); 

Services.AddScoped<SchoolContext>(_ => new 
SchoolContext(Configuration.GetConnectionString("DefaultConnection"))); 

} 

Daha sonra, Dİ kullanarak denetleyicilerinizdeki bağlamın bir örneğini alabilirsiniz. Kod, EF Core bağlamı için 
yazdıklarınız ile benzerdir: 

public class StudentsController : Controller 
{ 

private readonly SchoolContext _context; 

public StudentsController(SchoolContext context) 

{ 

_context = context; 

} 


Örnek uygulama 

Çalışan bir örnek uygulama için, bu makaleye eşlik eden örnek Visual Studio çözümü 1 ne bakın. 
Bu örnek, Visual Studio 'da aşağıdaki adımlarla sıfırdan oluşturulabilir: 


• Bir çözüm oluşturun. 









• > Yeni ProjectVVebASP.NETCore > Web uygulaması Ekle > 

o Proje şablonu seçimi iletişim kutusunda, açılan menüde API ve .NET Framevvork seçin 

• > Yeni projeEkleWindows > Masaüstüsınıf kitaplığı (.NET Framevvork) > 

• Her iki proje için de Paket Yöneticisi konsolunda (PMC) komutunu instaiı-Package Entityframework 
çalıştırın. 

• Sınıf kitaplığı projesinde, veri modeli sınıfları ve bağlam sınıfı ve uygulamasını iDbContextFactory oluşturun. 

• Sınıf kitaplığı projesi için PMC'de, ve Enable-Migrations Add-Migration initial komutlarını çalıştırın. 

AS P.N ET Core projesini başlangıç projesi olarak ayarladıysanız, bu komutlara ekleyin 

-StartupProjectName EF6 . 

• Çekirdek projede, sınıf kitaplığı projesine bir proje başvurusu ekleyin. 

• Çekirdek projede, Sfortup.csIÇINDE, dı için bağlamını kaydedin. 

• Core projesinde, appSettings. JSONlçmde bağlantı dizesini ekleyin. 

• Temel projede, verileri okuyabildiğinizi ve yazabildiğinizi doğrulamak için bir denetleyici ve görünüm ekleyin. 
(ASP.NET Core MVC yapı iskelesi, sınıf kitaplığından başvurulan EF6 bağlamıyla çalışmaz.) 

Özet 

Bu makale, bir ASP.NET Core uygulamasında 6 Entity Framework kullanmak için temel rehberlik sağlamıştır. 

Ek kaynaklar 

• Kod tabanlı Entity Framevvork yapılandırma 
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Genel olarak, bir ASP.NET Core uygulamasını barındırma ortamına dağıtmak için: 

• Yayımlanan uygulamayı barındırma sunucusundaki bir klasöre dağıtın. 

• istekler ulaştığında uygulamayı başlatan bir işlem yöneticisi ayarlayın ve kilitlendikten sonra veya sunucu 
yeniden başlatıldıktan sonra uygulamayı yeniden başlatır. 

• Ters bir ara sunucu yapılandırması için istekleri uygulamaya iletmek üzere ters bir ara sunucu ayarlayın. 

Bir klasöre yayımlama 

DotNet Publish komutu uygulama kodunu derler ve uygulamayı bir Publish klasöründe çalıştırmak için 
gereken dosyaları kopyalar. Visual Studio 'dan dağıtım yaparken, dosyalar dağıtım hedefine kopyalanmadan 
önce dotnet publish adımı otomatik olarak gerçekleşir. 

Klasör içeriği 

Yayımla klasörü bir veya daha fazla uygulama derleme dosyası, bağımlılık ve isteğe bağlı olarak .N ET çalışma 
zamanı içerir. 

.N ET Core uygulaması, kendi içinde veya çerçeveye bağımlı dağıtım olarak yayımlanabilir. Uygulama kendi 
kendine dahil ise, .NET çalışma zamanını içeren derleme dosyaları Yayımla klasörüne dahil edilir. Uygulama 
çerçeveye bağımlıysa, .N ET çalışma zamanı dosyaları dahil değildir çünkü uygulamanın, sunucuda yüklü bir 
.N ET sürümüne başvurusu vardır. Varsayılan dağıtım modeli çerçeveye bağımlıdır. Daha fazla bilgi için bkz. 

.NET Core uygulama dağıtımı. 

. Exe ve. dil dosyalarına ek olarak, bir AS P.N ET Core uygulamasının Yayımla klasörü genellikle yapılandırma 
dosyalarını, statik varlıkları ve MVC görünümlerini içerir. Daha fazla bilgi için bkz. AS P.N ET Core dizin yapısı. 

İşlem Yöneticisi ayarlama 

ASP.NET Core uygulaması, bir sunucu önyüklendiğinde ve kilitlenirse yeniden başlatıldığında başlatılması 
gereken bir konsol uygulamasıdır. Otomatik hale getirmek ve yeniden başlatmaları otomatikleştirmek için bir 
işlem Yöneticisi gereklidir. AS P.N ET Core için en yaygın işlem yöneticileri şunlardır: 

• Linux 

o NGINX 
o Apache 

• Windows 
o MS 

o VVİndovvs Hizmeti 

Ters proxy ayarlama 

Uygulama Kestrel sunucusunu kullanıyorsa, NGINX, Apacheveya IIS bir ters proxy sunucusu olarak 
kullanılabilir. Ters proxy sunucusu, Internet 'ten gelen HTTP isteklerini alır ve Kestrel 'e iletir. 

Ters proxy sunucu—sahip veya olmayan yapılandırma—, desteklenen bir barındırma yapılandırması. Daha 
fazla bilgi için bkz. Kestrel to Use a ters proxy. 






Ara sunucu ve yük dengeleyici senaryoları 

Proxy sunucularının ve yük dengeleyiciler arkasında barındırılan uygulamalar için ek yapılandırma gerekebilir. 
Ek yapılandırma olmadan, bir uygulamanın, bir isteğin kaynaklandığı uzak İP adresine (HTTP/HTTPS) ve bu 
şemaya erişimi olmayabilir. Daha fazla bilgi için proxy sunucuları ile çalışma ve yük Dengeleyiciler için 
ASP.NET Coreyapılandırma. 

Dağıtımları otomatik hale getirmek için Visual Studio ve MSBuild 'i 
kullanma 

Dağıtım genellikle çıktıyı DotNet Publish bir sunucuya kopyalamanın yanı sıra ek görevler gerektirir. Örneğin, 
daha fazla dosya gerekli olabilir veya Yayimla klasöründen dışlanamaz. Visual Studio Web dağıtımı için 
MSBuild 'i kullanır ve MSBuild, dağıtım sırasında birçok diğer görevi yapmak için özelleştirilebilir. Daha fazla 
bilgi için bkz. ASP.NET Core uygulama dağıtımı için Visual Studio yayımlama profilleri (. pubxml) ve MSBuild 
ve Team Foundation Yapı kitabı kullanma . 

Web 'i Yayımla özelliğini veya yerleşik git desteğinikullanarak, uygulamalar doğrudan Visual Studio 'dan Azure 
App Service dağıtılabilir. Azure DevOps Services Azure App Service için sürekli dağıtımıdestekler. Daha fazla 
bilgi için bkz. ASP.NET Core ve Azure İle DevOps. 

Azure'a Yayımlama 

Visual Studio kullanarak Azure 'da uygulama yayımlama hakkında yönergeler için bkz. Visual Studio ile 
Azure'a bir ASP.NET Core uygulaması yayımlama. Azure 'da bir ASP.NET Core Web uygulamasıoluşturarak 
ek bir örnek sağlanır. 

Windows 'ta MSDeploy ile Yayımla 

Bir Windows komut isteminden DotNet MSBuild komutunu kullanarak bir uygulamayı Visual Studio 
yayımlama profiliyle yayımlama hakkında yönergeler için bkz. ASP.NET Core uygulama dağıtımı için Visual 
Studio yayımlama profilleri (. pubxml). 

Internet Information Services (IIS) 

Web. config dosyası tarafından sunulan yapılandırmaya sahip Internet INFORMATION SERVICES (IIS) 
dağıtımları için, IIS ile Windows üzerinde ASP.NET Core barındırmaaltındaki makalelere bakın. 

Web grubunda barındırma 

Bir Web grubu ortamında uygulamaları ASP.NET Core barındırmak için yapılandırma hakkında bilgi için 
(örneğin, ölçeklenebilirlik için uygulamanızın birden çok örneğinin dağıtılması), bkz. Web çiftliğinde ASP.NET 
Core ana bilgisayar. 

Sistem durumu denetimleri gerçekleştirme 

Bir uygulamada ve bağımlılıklarında sistem durumu denetimleri gerçekleştirmek için sistem durumu denetimi 
ara yazılımı kullanın. Daha fazla bilgi için bkz. ASP.N ET Core durum denetimleri. 

Ek kaynaklar 

• DockerkapsayicilarmdakonakASP.NET Core 

• ASP.NET Core projeleri sorunlarını giderme 

• ASP.NET barındırma 
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Azure App Service , Web uygulamalarını barındırmak için ASP.NET Core dahil olmak üzere bir Microsoft bulut 
bilgi işlem platformu hizmetidir . 

Faydalı kaynaklar 

App Service belge, Azure Apps belgelerinin, öğreticilerin, örneklerin, nasıl yapılır kılavuzlarının ve diğer 
kaynakların ana adresidir. Barındırma ASP.NET Core uygulamaları ile ilgili iki önemli öğretici şunlardır: 

Azure 'da ASP.NET Core Web uygulaması oluşturma 

AS P.N ET Core bir Web uygulamasını VVİndovvs üzerinde Azure App Service oluşturmak ve dağıtmak için Visual 
Studio 'Yu kullanın. 

Linux üzerinde App Service AS P.N ET Core uygulama oluşturma 

Linux üzerinde Azure App Service için bir AS P.N ET Core Web uygulaması oluşturup dağıtmak üzere komut 
satırını kullanın. 

Azure App Service 'te bulunan ASP.NET Core sürümü için App Service panosundaki ASP.NET Core bakın. 

App Service Duyurular deposuna abone olun ve sorunları izleyin. App Service takım, App Service gelen 
duyuruları ve senaryoları düzenli olarak gönderir. 

Aşağıdaki makaleler ASP.NET Core belgelerinde sunulmaktadır: 

Visual Studio ile Azure'a bir ASP.NET Core uygulaması yayımlama 

Visual Studio kullanarak Azure App Service'e bir AS P.N ET Core uygulaması yayımlama hakkında bilgi edinin. 
AS P.N ET Core ile Visual Studio ve Git kullanarak Azure'a sürekli dağıtım 

Visual Studio kullanarak AS P.N ET Core bir Web uygulaması oluşturmayı ve sürekli dağıtım için git 'i kullanarak 
Azure App Service nasıl dağıtacağınızı öğrenin. 

ilk işlem hattınızı oluşturma 

ASP.NET Core bir uygulama için Cl derlemesi ayarlayın ve Azure App Service için sürekli bir dağıtım sürümü 
oluşturun. 

Azure Web uygulaması korumalı alanı 

Azure Apps platformu tarafından zorlanan Azure App Service çalışma zamanı yürütme sınırlamalarını bulun. 
ASP.NET Core projeleri sorunlarını giderme 

ASP.NET Core projelerle uyarıları ve hataları anlayın ve sorun giderin. 

Uygulama yapılandırması 

Platform 

Bir App Services uygulamasının platform mimarisi (x86/x64), A serisi bir işlem (temel) veya daha yüksek bir 
barındırma katmanında barındırılan uygulamalar için Azure portalında uygulama ayarlarında ayarlanır. 
Uygulamanın yayımlama ayarlarının (örneğin, Visual Studio Publish profile (. pubxml)) Azure portalındaki 
uygulamanın hizmet yapılandırmasındaki ayarla eşleştiğinden emin olun. 

64-bit (x64) ve 32-bit (x86) uygulamalarının çalışma zamanları Azure App Service vardır. App Service 




kullanılabilir .NET Core SDK 32 bittir, ancak kudu konsolunu veya Visual Studio 'daki Yayımla işlemini kullanarak 
yerel olarak oluşturulan 64 bit uygulamaları dağıtabilirsiniz. Daha fazla bilgi için, uygulamayı yayımlama ve 
dağıtma bölümüne bakın. 

Yerel bağımlılıklara sahip uygulamalar için, 32-bit (x86) uygulamalarının çalışma zamanları Azure App Service 
vardır. App Service kullanılabilir .NET Core SDK 32 bitlik bir değer. 

.NET Core Framevvork bileşenleri ve dağıtım yöntemleri hakkında daha fazla bilgi için, .NET Core çalışma zamanı 
ve .NET Core SDK hakkında bilgi gibi bkz. .NET Core: bileşim hakkında. 

Paketler 

Azure App Service dağıtılan uygulamalar için otomatik günlük oluşturma özellikleri sağlamak üzere aşağıdaki 
NuGet paketlerini ekleyin: 

• Microsoft. AspNetCore. AzureAppServices. hostingstartup , Azure App Service ile ASP.NET Core hafif 
tümleştirme sağlamak İçin ıhostingstartup kullanır. Eklenen günlük özellikleri 

Microsoft.AspNetCore.AzureAppServicesIntegration paketi tarafından sağlanır. 

• Microsoft. AspNetCore. AzureAppServicesIntegration , Microsoft.Extensions.Logging.AzureAppServices 
paketine Azure App Service tanılama günlüğü sağlayıcıları eklemek İçin Addavzurevvebappdiagnostics ' i 
yürütür. 

• Microsoft. Extensions. Logging. AzureAppServices , Azure App Service tanılama günlüklerini ve günlük akışı 
özelliklerini desteklemek için günlükçü uygulamaları sağlar. 

Önceki paketlere Microsoft. AspNetCore. app metapackagetarafından ulaşılabilir. Microsoft.AspNetCore.App 
metapackage.NET Framevvork veya başvurusunu hedefleyen uygulamalar, uygulamanın proje dosyasındaki ayrı 
paketlere açık olarak başvurmalıdır. 

Azure portalını kullanarak uygulama yapılandırmasını geçersiz kılma 

Azure portalındaki uygulama ayarları, uygulamanın ortam değişkenlerini ayarlamanıza olanak sağlar. Ortam 
değişkenleri, ortam değişkenleri yapılandırma sağlayıcısıtarafından tüketilebilir. 

Azure portalında bir uygulama ayarı oluşturulduğunda veya değiştirildiğinde ve Kaydet düğmesi seçildiğinde, 
Azure uygulaması yeniden başlatılır. Ortam değişkeni, hizmet yeniden başlatıldıktan sonra uygulama için 
kullanılabilir. 

Bir uygulama genel ana bilgisayarıkul landığında, ortam değişkenleri varsayılan olarak bir uygulamanın 
yapılandırmasına yüklenmez ve yapılandırma sağlayıcısı geliştirici tarafından eklenmelidir. Geliştirici, 
yapılandırma sağlayıcısı eklendiğinde ortam değişkeni önekini belirler. Daha fazla bilgi için bkz. NET genel ana 

bilgisayar ve ortam değişkenleri yapılandırma sağlayıcısı. 

Bir uygulama, VVebhost. CreateDefaultBuilderkullanarak Konağı oluşturduğunda, Konağı yapılandıran ortam 
değişkenleri aspnetcore_ önekini kullanır. Daha fazla bilgi için bkz. ASP.NET Core Web ana bilgisayarı ve ortam 
değişkenleri yapılandırma sağlayıcısı. 

Ara sunucu ve yük dengeleyici senaryoları 

işlem dışıbarındırma sırasında İletilen üstbilgiler ara yazılımını yapılandıran ve ASP.NET Core modülü DÜZENİ 
(http/https) ve isteğin KAYNAKLAN DıĞı uzak İP adresini iletecek şekilde yapılandırılmış I IS tümleştirme ara 
yazılımı. Ek Ara sunucuları ve yük dengeleyici barındırılan uygulamalar için ek yapılandırma gerekebilir. Daha 
fazla bilgi için bkz. proxy sunucularıyla ve yük dengeleyicilerle çalışacak AS P.N ET Core yapılandırma. 

İzleme ve günlüğe kaydetme 

App Service dağıtılan ASP.NET Core uygulamalar, bir App Service uzantisiASP.NET Core günlüğe kaydetme 







tümleşti rmesiotomatik olarak alır. Uzantı, Azure App Service AS P.N ET Core uygulamalar için günlüğe kaydetme 
tümleştirmesi imkanı sunar. 

App Service dağıtılan ASP.NET Core uygulamalar, bir App Service uzantisiASP.NET Core günlüğe kaydetme 
uzantısıotomatik olarak alır. Uzantı, Azure App Service ASP.NET Core uygulamalar için günlüğe kaydetme 
tümleştirmesi imkanı sunar. 

izleme, günlüğe kaydetme ve sorun giderme bilgileri için aşağıdaki makalelere bakın: 

Azure App Service uygulamaları izleme 

Uygulamalar ve App Service planları için kotaları ve ölçümleri incelemeyi öğrenin. 

Azure App Service uygulamalar için tanılama günlüğünü etkinleştirme 

HTTP durum kodları, başarısız istekler ve Web sunucusu etkinliği için tanılama günlüğü 'nün nasıl 
etkinleştirileceğini ve erişebileceğini öğrenin. 

ASP.NET Core hataları işleme 

ASP.NET Core uygulamalarında hataları işlemeye yönelik yaygın yaklaşımları anlayın. 

Azure App Service ve 11S 'de AS P.N ET Core sorunlarını giderme 

ASP.NET Core uygulamalarla Azure App Service dağıtımlarla ilgili sorunları tanılamayı öğrenin. 

AS P.N ET Core ile Azure App Service ve IIS için ortak hatalar başvurusu 

Sorun giderme önerisi ile Azure App Service/IIS tarafından barındırılan uygulamalar için ortak dağıtım 
yapılandırma hatalarına bakın. 

Veri koruma anahtar halkası ve dağıtım Yuvaları 

Veri koruma anahtarları %Home%\ASP.NET\DataProtection-Keys klasöründe kalıcı hale getirilir. Bu klasör, ağ 
depolama tarafından desteklenir ve uygulamayı barındıran tüm makinelerde eşitlenir. Anahtarlar bekleyen bir 
şekilde korunmuyor. Bu klasör, bir uygulamanın tüm örneklerine tek bir dağıtım yuvasında anahtar halkasını 
sağlar. Hazırlama ve üretim gibi ayrı dağıtım yuvaları, anahtar halkasını paylaşmaz. 

Dağıtım yuvaları arasında takas edildiğinde, veri koruma kullanan tüm sistem, önceki yuva içindeki anahtar 
halkasını kullanarak depolanan verilerin şifresini çözemeyecektir. ASP.NET tanımlama bilgisi ara yazılımı, 
tanımlama bilgilerini korumak için veri koruma kullanır. Bu, kullanıcılara standart ASP.NET tanımlama bilgisi ara 
yazılımı kullanan bir uygulamanın oturumunu kapatmakta olduğunu gösterir. Yuvada bağımsız bir anahtar halka 
çözümü için, bir dış anahtar halka sağlayıcısı kullanın, örneğin: 

• Azure Blob Depolama 

• Azure anahtar kasası 

• SQL Mağazası 

• Redsıs önbelleği 

Daha fazla bilgi için bkz. AS P.N ET core'da anahtar depolama sağlayıcıları. 

Azure App Service ASP.NET Core 3,0 dağıtma 

AS P.N ET Core 3,0 Azure App Service desteklenir..NET Core 3,0 ' den sonraki bir .NET Core sürümünün 
önizleme sürümünü dağıtmak için, aşağıdaki tekniklerden birini kullanın. Bu yaklaşımlar, çalışma zamanı 
kullanılabilir ancak SDK Azure App Service üzerine yüklenmemişse de kullanılır. 

• Azure Pipelines kullanarak .NET Core SDK sürümünü belirtin 

• Kendi kendine içerilen bir önizleme uygulaması dağıtın. 

• Kapsayıcılar için Web Apps Docker kullanın. 

• Önizleme sitesi uzantısını yükler. 



Azure Pipelines kullanarak.NET Core SDK sürümünü belirtin 

Azure DevOps ile sürekli tümleştirme derlemesi ayarlamak için Azure App SERVİCE CI/CD senaryoları kullanın. 
Azure DevOps derlemesi oluşturulduktan sonra, isteğe bağlı olarak derlemeyi belirli bir SDK sürümünü 
kullanacak şekilde yapılandırın. 

.NET Core SDK sürümünü belirtin 

Azure DevOps derlemesi oluşturmak için App Service dağıtım merkezini kullanırken, varsayılan derleme işlem 
hattı Restore, Buiid , Test ve Pubüsh için adımlar içerir. S DK sürümünü belirtmek için, yeni bir adım eklemek 
üzere aracı iş listesindeki Ekle (+) düğmesini seçin. Arama çubuğunda .N ET Core SDK arayın. 


Tasks Variables Triggers Options Retention History 


Pipeline 

Buiid pipeline 


Get sources 

O bradygaster/AspNetCore30App 


Agent job 1 


S 5 master 


Run on agent 
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Restore 

.NET Core 


Buiid 

.NET Core 

Test 

.NET Core 

Publish 


E Save & queue v ^ Disc< 

1 ;= Summary ••• 


Add tasks o Refresh 

^^ne^oı^dlj 
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Use .NET Core 


Acquires a specific version of the .NET Core 
SDK from the internet or the local cache and 
adds it to the PATH. Use this task to change 
the version of .NET Core used in subsequent 
tasks. Additionally provides proxy support. 


Add 


by Microsoft Corporation Q Learn more 


Aşağıdaki adımların .NET Core SDK belirtilen sürümünü kullanmasını sağlamak için adımı derlemedeki ilk 
konuma taşıyın. .NET Core SDK sürümünü belirtin. Bu örnekte, SDK 3.0.100 olarak ayarlanmıştır. 


Tasks Variables Triggers Options Retention History El Save&queue v Discard := Summary 
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version 
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Od Link settings [J View YAML |fj Remove 

Use .Net Core SDK 3.0.100 | 


Package to install © 

SDK (contains runtime) 

N/ 

O Use global json © 

Version © 
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O Include Previevv Versions Q 
Advanced /\ 



Kendi kendine içerilen bir dağıtımı (SCD)yayımlamak için Publish adımında SCD 1 yi yapılandırın ve çalışma 
zamanı tanımlayıcısını (RID)sağlayın. 
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Discard i= Summary 
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Agent job 1 
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B Restore 
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Publish 

.NET Core 

O İİ 


Publish 

Command * ® 

publish 


Q Publish Web Projects © 

Arguments © 


1 --self-contained true -r win-x86 

-configuration $(BuildConfiguration) — 
b.t.P.ry.)" 

uui p ui ^ v^«iy»aı.'Jj.9.v.w.ssiilj. , a.vJjJ 


Q Zip Published Projects © 

Q Add project name to publish path © 

Advanced v 
Control Options v 
Output Variables 


Kendi içinde bir önizleme uygulaması dağıtma 

Bir önizleme çalışma zamanını hedefleyen kendinden bağımsız bir dağıtım (SCD) , dağıtımdaki Önizleme çalışma 
zamanını taşır. 


Kendi kendine içerilen bir uygulama dağıtımında: 

• Azure App Service sitesi, Önizleme sitesi uzantısınıgerektirmez. 

• Uygulamanın, çerçeveye bağımlı dağıtım (FDD)için yayımlarken farklı bir yaklaşımdan sonra yayımlanması 
gerekir. 


Uygulamanın kendi İçinde dağıtımı bölümünde yer alan yönergeleri izleyin. 

Kapsayıcılar için Web Apps Docker kullanma 

Docker Hub , en son önizleme Docker görüntülerini içerir.Görüntüler, temel görüntü olarak kullanılabilir. 
Görüntüyü kullanın ve kapsayıcılar için normal olarak Web Apps için dağıtın. 

Önizleme sitesi uzantısını yükler 

Önizleme sitesi uzantısı kullanılarak bir sorun oluşursa, bir ASPNET/AspNetCore sorunuaçın. 

1. Azure portalından App Service gidin. 

2. Web uygulamasını seçin. 

3. "Uzantıları" filtrelemek için arama kutusuna "Ex" yazın veya yönetim araçları listesini aşağı kaydırın. 

4. Uzantılarıseçin. 

5. Ekle' yi seçin. 

6. Listeden {x.y} ASP.NET Core önizleme sürümü olduğu ve {x64|x86} platformu belirten ASP.NET Core {X. 
Y} ({x64 | x86}) çalışma zamanı uzantısını seçin. 

7. Yasal koşulları kabul etmek için Tamam ' ı seçin. 

8 . Uzantıyı yüklemek için Tamam 1 ı seçin. 

işlem tamamlandığında, en son .N ET Core önizlemesi yüklenir.Yüklemeyi doğrulayın: 

1. Gelişmiş Araçlar' ı seçin. 

2. Gelişmiş araçlarda Git ' i seçin. 

3. Hata ayıklama konsolu > PovverShell menü öğesini seçin. 

4. PovverShell komut isteminde aşağıdaki komutu yürütün. {x.y} için ASP.NET Core çalışma zamanı 





















sürümünü ve komutuna {platform} platformunu değiştirin: 


Test-Path D: \home\SiteExtensions\AspNetCoreRunt ime.{X.Y}.{PLATFORM}} 
X64 Önizleme çalışma zamanı yüklendiğinde komut True döndürür. 


NOTE 

Bir App Services uygulamasının platform mimarisi (x86/x64), A serisi bir işlem (temel) veya daha yüksek bir barındırma 
katmanında barındırılan uygulamalar için Azure portalında uygulama ayarlarında ayarlanır. Uygulamanın yayımlama 
ayarlarının (örneğin, Visual Studio Publish profile (. pubxml)) Azure Portal uygulamanın hizmet yapılandırmasındaki ayarla 
eşleştiğini doğrulayın. 

Uygulama, işlem içi modda çalışıyorsa ve platform mimarisi 64-bit (x64) için yapılandırılmışsa ASP.NET Core modülü, varsa 
64 bit önizleme çalışma zamanını kullanır. Azure portalını kullanarak ASP.NET Core {X. Y} (x64) çalışma zamanı uzantısını 
yükler. 

X64 Önizleme çalışma zamanını yükledikten sonra, yüklemeyi doğrulamak için Azure kudu PovverShell komut penceresinde 
aşağıdaki komutu çalıştırın. Aşağıdaki komutta {x.y} için ASP.NET Core çalışma zamanı sürümünü değiştirin: 

Test-Path D: \home\SiteExtensions\AspNetCoreRuntime .{X.Y}.x64\ 

X64 Önizleme çalışma zamanı yüklendiğinde komut True döndürür. 


NOTE 

ASP.NET Core uzantıları , Azure Uygulama Hizmetleri 'nde Azure günlük kaydı etkinleştirme gibi ek ASP.NET Core işlevler 
sunar. Uzantı Visual Studio 'dan dağıtıldığında otomatik olarak yüklenir. Uzantı yüklü değilse, uygulama için bu uygulamayı 
yükleme. 


Bir ARM şablonuyla önizleme sitesi uzantısını kullanma 

Uygulamaları oluşturmak ve dağıtmak için bir ARM şablonu kullanılıyorsa, siteextensions kaynak türü, site 
uzantısını bir Web uygulamasına eklemek için kullanılabilir. Örneğin: 

{ 

"type": "siteextensions", 

"name": "AspNetCoreRuntime", 

"apiVersion": "2015-04-01", 

"location" : " [resourceGroupO .location]", 

"properties": { 

"version": "[parameters('aspnetcoreVersion')]" 

}, 

"dependsOn": [ 

"[nesourceId('Microsoft.Web/Sites', parameters('siteName'))]" 

] 

} 


Uygulamayı yayımlama ve dağıtma 

64 bitlik bir dağıtım için: 

• 64 bit uygulama derlemek için 64 bit .NET Core SDK kullanın. 

• App Service yapılandırma > genel ayarları'nda platformu 64 bit olarak ayarlayın. Uygulamanın, platform 
bit özelliğini tercih etmek için temel veya daha yüksek bir hizmet planı kullanması gerekir. 










Uygulama çerçevesine bağımlı dağıtım 

• Visual Studio 

• .NETCoreCLI 

1. Visual Studio araç çubuğundan derleme > {Application Name} Yayımla 1 yı seçin veya Çözüm Gezgini 

projeye sağ tıklayıp Yayımla 1 yı seçin. 

2. Bir yayımlama hedefi seç iletişim kutusunda App Service seçili olduğunu onaylayın. 

3. Gelişmiş' i seçin. Yayımla iletişim kutusu açılır. 

4. Yayımla iletişim kutusunda: 

• Yayın yapılandırmasının seçili olduğunu doğrulayın. 

• Dağıtım modu açılır listesini açın ve çerçeveye bağımlı' ı seçin. 

• Hedef çalışma zamamolarak Taşınabilir öğesini seçin. 

• Dağıtımdan sonra ek dosyaları kaldırmanız gerekiyorsa, dosya yayımlama seçenekleri ' ni açın ve 
hedefteki ek dosyaları kaldırmak için onay kutusunu işaretleyin. 

• Kaydet' i seçin. 

5. Yayımla sihirbazının kalan istemlerini izleyerek yeni bir site oluşturun veya var olan bir siteyi güncelleştirin. 

Uygulamayı kendi içinde dağıtma 

Kendi içinde dağıtım için Visual Studio 'Yu veya komut satırı arabirimi (CLı) araçlarını kullanın (SCD). 

• Visual Studio 

• .NETCoreCLI 

1. Visual Studio araç çubuğundan derleme > {Application Name} Yayımla ' yı seçin veya Çözüm Gezgini 

projeye sağ tıklayıp Yayımla' yı seçin. 

2. Bir yayımlama hedefi seç iletişim kutusunda App Service seçili olduğunu onaylayın. 

3. Gelişmiş' i seçin. Yayımla iletişim kutusu açılır. 

4. Yayımla iletişim kutusunda: 

• Yayın yapılandırmasının seçili olduğunu doğrulayın. 

• Dağıtım modu açılır listesini açın ve kendinden bağımsız' i seçin. 

• Hedef çalışma zamanı açılır listesinden hedef çalışma zamanını seçin. Varsayılan, win-x86 değeridir. 

• Dağıtımdan sonra ek dosyaları kaldırmanız gerekiyorsa, dosya yayımlama seçenekleri ' ni açın ve 
hedefteki ek dosyaları kaldırmak için onay kutusunu işaretleyin. 

• Kaydet' i seçin. 

5. Yayımla sihirbazının kalan istemlerini izleyerek yeni bir site oluşturun veya var olan bir siteyi güncelleştirin. 

Protokol ayarları (HTTPS) 

Güvenli Protokol bağlamaları, HTTPS üzerinden isteklere yanıt verme sırasında kullanılacak bir sertifika 
belirtmenize olanak tanır. Bağlama, belirli bir ana bilgisayar adı için verilen geçerli bir özel sertifika (. pfx ) 
gerektirir. Daha fazla bilgi için bkz. öğretici: var olan bir özel SSL sertifikasını Azure App Service bağlama. 

VVeb.config'i dönüştürme 

Yayımlama sırasında Web. config ' i dönüştürmeniz gerekiyorsa (örneğin, yapılandırma, profil veya ortama göre 
ortam değişkenlerini ayarlayın), bkz. VVeb.config'i dönüştürme. 

Ek kaynaklar 

• App Service Genel Bakış 

• Azure App Service: .NET uygulamalarınızı barındırmak için En İyi yer (55 dakikalık genel bakış videosu) 




• Azure Cuma: Azure App Service tanılama ve sorun giderme deneyimi (12 dakikalık video) 

• Azure App Service tanılamada genel bakış 

• Web çiftliğinde AS P.N ET Core ana bilgisayar 

Windows Server 'da Azure App Service, Internet Information Services (llS)kullanır. Aşağıdaki konular, temel 
alınan MS teknolojisine yöneliktir: 

• MS ile VVİndovvs üzerinde ASP.NET Core barındırma 

• ASP.NET Core Modülü 

• ASP.NET Core içeren MS modülleri 

• VVİndovvs Server-geçerli ve önceki sürümler için BT Yöneticisi içeriği 


Visual Studio ile Azure'a bir ASPNET Core 
uygulaması yayımlama 

4.09.2019 • 6 minutes to read ı Edit Online 


Tarafından Rick Anderson 


IMPORTANT 

Azure App Service ile Önizleme sürümlerini ASP.NET Core 

ASP.NET Core önizleme sürümleri varsayılan olarak Azure App Service dağıtılır. ASP.NET Core Previevv sürümü kullanan bir 
uygulamayı barındırmak için, bkz. Azure App Service için ASP.NET Core Previevv sürümünü dağıtma. 


Bkz: Mac için Visual Studio'dan azure'a Yayımla macOS üzerinde çalışıyorsanız ve o. 

App Service dağıtım sorun gidermek için bkz: Azure App Service ve 11S 'de ASP.NET Core sorunlarını giderme. 

Ayarlama 

• Açık bir ücretsiz Azure hesabı tane yoksa. 

Web uygulaması oluşturma 

Visual Studio Başlangıç sayfasında, seçin Dosya > Yeni > Proje... 
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Share Ul Code in any İOS and 
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Tamamlamak yeni proje iletişim: 

• Sol bölmede seçin .N ET Core. 

• Orta bölmede seçin ASP.NET Core Web uygulaması. 



















• Tamam'ı seçin. 



içinde yeni ASP.N ET Core Web uygulaması iletişim: 

• Seçin Web uygulaması. 

• Seçin kimlik doğrulamayı Değiştir. 


New ASP.NET Core Web Application - VVebApplicationl 
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A project template for creating an ASP.NET Core 
applkation with example ASP.NET Core Razor Pages 
content. 
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Authentication No Authentication 


I I Enable Oocker Support 

OS: Windows 

Requires Docker for Window«. 

Docker support can also be enabled later I e.v n more 


OK 


Cancel 


Kimlik doğrulamayı Değiştir iletişim kutusu görüntülenir. 
• Seçin bireysel kullanıcı hesapları. 

































Seçin Tamam dönmek için yeni ASP.NET Core Web uygulaması, ardından Tamam yeniden. 


.NET Core v ASP.NET Core 2.0 v ı earn more 



A project template for creating an ASP.NET Core 
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Change Authentication 


O No Authentication 
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Store user accounts in-app v Learn more 

Select this option to create a project that indudes a local user accounts store. 


® Individual User Accounts 


O Work or School Accounts 
O Windows Authentication 


Learn more about third-partv öpen source authentication options 
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Docker support can also be enabled later Learn more 



Cancel 


OK 
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Visual Studio çözüm oluşturur. 


Uygulamayı çalıştırma 


• Projeyi çalıştırmak için CTRL + F5 tuşlarına basın. 

• Test hakkında ve kişi bağlantıları. 
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How to 


Overview 


Sample pages using 
ASP.NET Core Razor 
Pages 

Bower for managing ckent- 

sıde libraries 

Themmg using Bootstrap 


VVorking with Razor Pages. 
Manage User Secrets 
using Secret Manager. 

Use !oggir>g to log a 
message. 

Add packages using 
NuGet. 

Add dient packages using 
Bower. 

Target development, 
staging or production 
environment. 


Conceptual overview of 
what is ASP.NET Core 
Fundamentals of ASP.NET 
Core such as Startup and 
middleware. 

Working with Data 
Security 

Client side development 
Develop on different 
platforms 
Read more on the 
documentation site 


Run & Deploy 

• Run your app 

• Run tools sucfı as EF 
migrations and more 

• PuMish to Microsoft Azure 
App Service 


Bir kullanıcı kayd 




































• Seçin kaydetme ve yeni bir kullanıcı kaydı. Kurgusal bir e-posta adresini kullanabilirsiniz. 
Gönderdiğinizde, sayfa şu iletiyi görüntüler: 

"İç sunucu hatası: istek işlenirken bir veritabanı işlemi başarısız oldu. SQL özel durumu: Veritabanı 
açılamıyor. Uygulama DB bağlamı için mevcut geçişler uygulama bu sorunu çözebilir." 

• Seçin geçerli geçişleri ve Sayfa güncelleştirmelerini yenileyin sonra sayfa. 


B Irıtemal Server Error X + — □ X 

^ localhost:16841/Account/Register "jjf 

A database operation failed while processing the request. 

SqlException: Cannot öpen database "aspnet-WebApplication1-3caf68c5-2764-4579-a54b-15b98365379b" requested 
by the login. The login failed. Login failed for user 'D\user'. 

Applying existing migrations for ApplicationDbContext may resolve this issue 

There are migrations for ApplicationDbContext that have not been applied to the database 
• 00000000000000_CreateldentitySchema 


İn Visual Studio, you can use the Package Manager Console to apply pending migrations to the database: 
PM> Update-Database 

Alternatively, you can apply pending migrations from a command prompt at your project directory: 

> dotnet ef database update 


Yeni kullanıcı kaydetmek için kullanılan e-posta uygulaması görüntüler ve oturumunuzu bağlantı. 
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Application uses 


Sample pages using ASP.NET Core Razor Pages 
Theming using Bootstrap 


How to 


• VVorking with Razor Pages 

• Manage User Secrets using Secret Manager 

• Use logging to log a message 
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Uygulamayı Azure'a dağıtma 

Çözüm Gezgini'nde projeye sağ tıklayıp Yayımla., 
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Debug 

► 

% 

Cut 

Ctrl+X 

X 

Remove 

Del 

□ 

Rename 



Unload Project 


c* 

Öpen Folder in File Explorer 


> 

Properties 

Alt+Enter 





îcted Services 

ıdencies 

rties 

o ot 

Dİlers 

iions 


ttings.json 

econfig.json 

»m.cs 

p.cs 


0 ut put 


n Ready 

t* Add to Source Control 


içinde Yayımla iletişim: 


• Seçin Microsoft Azure App Service'te. 

• Dişli simgesini seçin ve ardından profili oluştur. 

• Seçin profili oluşturma. 



















WebApplication1 - Microsoft Visual Studio Quick Launch ı Ctıl + Q 

File Edit View Project Build Debug Team Tools Test Analyze Window Help 

Select Startup Item * _ 


P - n x 

rick - kij 


WebApplication1 X | 

Overview 

Connected Services 


Publish 

Publish your app to Azure or another hoşt. Learn more 


(§) Create New 
O Select Existing 


Publish 


Continuous De 


Publish Immediately 


Create Profile 


ıvery 


Automatically publish your application to Azure with 
continuous delivery 


Start 


w Solution Explorer 


(2t S5 


nn 

m 


D 



IIS, FTP, ete 

App Service 





r® >0 


Search Solution Explorer (Ctrl+;) 

Solution 'VVebApplicationl 1 (1 project) 
a WebApplication1 

Connected Services 

> «V Dependencies 

> p Properties 

> ® wwwroot 

> A Controllers 

> fi Data 

> fi Extensions 

> fi Pages 

> fi Services 

> appsettings.json 
oT bundleconfig.json 

> c* Program.es 

> c* Startup.es 


Output 


I~1 Ready 

-t* Add to Source Control ^ 


Azure kaynakları oluşturma 

App Service Oluştur iletişim kutusu görüntülenir: 

• Aboneliğinizi girin. 

• Uygulama adı, kaynak grubu, ve App Service planı giriş alanları doldurulur. Bu adlar tutun veya bunları 
değiştirme. 





























Create App Service 

Hoşt your web and mobile applications, REST APIs, and more in Azure 


Microsoft account 

a.rickaOO@gmail.com 


Hosting (T) 


Services 


App Name 


ChangeType^ 


WebApplication120171215025005 


Subscription 



MSDN 

V 


Resource Group 



WebApplication120171215025005ResourceGroup* 

V 

New... 

App Service Plan 

WebApplication120171215025005Plan* 

V 

New... 


Clicking the Create button will create the following Azure resources 

Explore additional Azure Services 

App Service - WebApplication120171215025005 
App Service Plan - WebApplication120171215025005Plan 


If you have removed your spending limit or you are using Pay as You Go, there may be monetary impact if you provision additional resources. 

Learn More 


Export... 


Create 


Cancel 


• Seçin Hizmetleri yeni bir veritabanı oluşturmak için sekmesinde. 

• Yeşili + simgesini yeni SQL veritabanı oluşturma 


x 


Create App Service 

Hoşt your web and mobile applications, REST APIs, and more in Azure 


■ H Microsoft account v 

a.riclcaOO@gmail.com 


Hosting O 



Select any additional Azure resources your app will need 


Resource Type 


fil 


SQL Database 

Scalable and managed database service for modern business-class apps 


Show: 


Recommended v 



Resources you've selected and configured 


Resource Type 


] WebApplication120171215025005Plan 

LjJ App Service Plan 

o X 


If you have removed your spending limit or you are using Pay as You Go, there may be monetary impact if you provision additional resources. 

Learn More 


Export... 


Create 


Cancel 


• Seçin yeni... üzerinde SQL veritabanını Yapılandır yeni bir veritabanı oluşturma iletişim kutusu. 











































































X 

Configure SQL Database 

Create a SQL Database in your subscription for storing data used by 
your application. 


SQL Server 


vvebapplicationl dbserver* 


New... 


Administrator Usemame 

sqladmin 

Administrator Password 


Database Name 


VVebApplicationl -123 db 


Connection String Name 
DefaultConnection 


OK 


Cancel 


SQL Server'ı Yapılandır iletişim kutusu görüntülenir. 

• Bir yönetici kullanıcı adı ve parola girin ve ardından Tamam. Varsayılan koruyabilirsiniz sunucu adı. 


NOTE 

Yönetici kullanıcı adı olarak "admin" izin verilmiyor. 




























• Tamam ı seçin. 

Visual Studio döner App Service Oluştur iletişim. 

• Seçin Oluştur üzerinde App Service Oluştur iletişim. 


x 


Create App Service 

Hoşt your web and mobile applications, REST APIs, and more in Azure 


■■ Microsoft account v 

| user@mıcrosoftcom 


Hosting 



Select any additional Azure resources your app vvill need 

Resource Type 


Show: Recommended v 


e 


SQL Database 

Scalable and managed database service for modern business-dass apps 


+ 


Resources you've selected and configured 


Resource Type 



K VVebApplicationlPlan 

LjlJ App Service Plan 

O 

X 

M webapplication1dbserver 

SQL Server 

o 

X 

iğ WebApplication1 db 

** SQL Database 

o 

X 


If you have removed your spending limit or you are using Pay as You Go, there may be monetary impact if you provision additional resources. 

Learn More 


Export... 


Create 


Cancel 


Visual Studio, Azure üzerinde SQL Server ve Web uygulaması oluşturur.Bu adım birkaç dakika sürebilir. 
Oluşturulan kaynakları hakkında daha fazla bilgi için bkz: ek kaynaklar. 






































Dağıtım tamamlandığında, seçin ayarları: 


WebApplication8 - Microsoft Visual Studio 
File Edit View Project Build Debug 

î O 8 ' ^ Select Startup Item » _ 


T fi' 3 Quick Launch (Ctrl+Q) 


Team Tools Test Analyze Window Help 


fi _ □ X 

rick * il 


WebApplication8 -o X | 

Overview 

Connected Services 


Fİ Ready 


Publish 

[Jİ? Azure successfully configured: How was your experience? 


SS WebApp91 - Web Deploy 


Publish 


Create new profile 


Summary 


Site URL 
Resource Group 
Configuration 
Username 
Password 


http://webapp91.azurewebsites.net [5 

WebApp91RG 


Release 

SWebApp91 


Continuous Delivery 


Automatically publish your application to Azure with continuous delivery 
Start 


Preview... 
Rename p 
Delete prc 


T Add to Source Control 


Üzerinde ayarları sayfasının Yayımla iletişim: 

• Genişletin veritabanları ve çalışma zamanında Bu bağlantı dizesini kullan. 

• Genişletin varlık çerçevesi geçişleriyle ve bu geçişi yayımlama Uygula. 

• Kaydet i seçin. Visual Studio döner Yayımla iletişim. 


















Tıklayın yayımlama. Visual Studio, uygulamanızı Azure'a yayımlar. Dağıtım tamamlandığında, uygulamayı bir 
tarayıcıda açılır. 

Azure'da uygulamanızı test etme 
• Test hakkında ve kişi bağlantıları 


• Yeni bir kullanıcı kaydı 




























Uygulamayı güncelleştirme 

• Düzen Pages/About.cshtml Razor sayfasını ve içeriğini değiştirin. Örneğin, paragrafı "Merhaba ASP.NET 
Corel" olacak şekilde değiştirebilirsiniz: 

@page 

@model AboutModel 
@{ 

ViewData["Title"] = "About"; 

} 

<h2>@ViewData["Title"]</h2> 

<hB>@Model.Message</h3> 

<p>Hello ASP.NET Core!</p> 


• Sağ tıklatın ve proje Yayımla... yeniden. 

















WebApplication1 - Microsoft Visual Studio 
File Edit View Project Build Debug Team Tools Test Analyze Window Help 

~ jji Select Startup Item * _ 


WebApplication1 X 


^ Sp Quick Launch (Ctrl+Q) 


P _ n x 

rick ~ i 


Connected Services 
Publish 


ASP.NET Core 

Learn about the .NET platform^ 13 * 0 
application and extend it to the ^ 


</> <â 




Build Your 
App 

Get started 
with 

ASP.NET 

Core 

Browse 

docs, 

samples, 

and 

tutorials 

ASP.NET 

Core 

Authentication 


Connect t| 
Azure 


Sign up fo 
free 

Publish 

your 

website tc 
Azure 

Set up 
continuou 
delivery 

Azure 

Publish 

Ouickstart 


mı ı r firrt- 

Build 

Rebuild 

Clean 



View 

► 


Pack 


«t 

Publish... 



Overview 



Scope to This 

New Solution Explorer View 


c* 

Edit VVebApplicationl .csproj 



Add 

► 

i 

Manage NuGet Packages... 

Manage Bower Packages... 

Manage User Secrets 


O 

Set as StartUp Project 

Debug 

► 

& 

Cut 

Ctrl+X 

X 

Remove 

Del 

D 

Rename 



Unload Project 


C» 

Öpen Folder in File Explorer 


> 

Properties 

Alt+Enter 





| Solution Explorer ^ ? X 

(îı B! - I T © - ti s 1 ® 

| Search Solution Explorer (Ctrl+;) P * 

d Solution 'WebApplication1' (1 project) 


icted Services 

ıdencies 

rties 

o ot 

Dİlers 


t:- 

ttingsjson 

ıconfig.json 

ım.cs 

p.cs 


0 ut put 


f~l Ready 

T* Add to Source Control ^ 


• Uygulamayı yayımladıktan sonra yaptığınız değişiklikleri Azure üzerinde kullanılabilir olduğunu doğrulayın. 


















Temizleme 

Uygulamayı test etme işlemini tamamladığınızda, Git Azure portalında ve uygulamayı silin. 
• Seçin kaynak grupları, ardından oluşturduğunuz kaynak grubunu seçin. 


Resource groups - Micn X 

+ 



- □ X 

<r O | â 

porta 1 azure.eom/#blade/Hu bsExtensi 

☆ 

o 

■••••■ 

Ilı 

Microsoft Azure v 

« / 

p 0 ^ ® © 

© 


New 


Resource groups 



A Resource groups 


+ ss 0 

Add Columns Refresh 



■■i Ali resources 

1 

Subscriptions: 



^ Recent 

m 

Fi/ter items... 

| Ali subscriptions 

^ App Services 


NAME 



•* SQL databases 

Kİ \/ırfıi3İ marhınoc frlaccırt 


(İjf) WebApplication120160701041926 



• içinde kaynak grupları sayfasında Sil. 



















• Kaynak grubu adını girin ve seçin Sil. Artık uygulamanız ve Bu öğreticide oluşturulan tüm kaynakları 
Azure'dan silinecektir. 

Sonraki adımlar 

• ASP.NET Core ile Visual Studio ve Git kullanarak Azure'a sürekli dağıtım 

Ek kaynaklar 

• Visual Studio Code için bkz. Yayımlama profilleri. 

• Azure uygulama hizmeti 

• Azure kaynak grupları 

• Azure SQL Veritabanı 

• ASP.NET Core uygulama dağıtımı için Visual Studio yayımlama profilleri (. pubxml) 

• Azure App Service ve MS 'de ASP.NET Core sorunlarını giderme 















ASPNET Core ile Visual Studio ve Git kullanarak 
Azure'a sürekli dağıtım 

10.05.2019 • 12 minutes to readı Edit Online 


tarafından Erik Reitan 


IMPORTANT 

Azure App Service ile Önizleme sürümlerini ASP.NET Core 

ASP.NET Core önizleme sürümleri varsayılan olarak Azure App Service dağıtılır.ASP.NET Core Previevv sürümü kullanan bir 
uygulamayı barındırmak için, bkz. Azure App Service için ASP.NET Core Previevv sürümünü dağıtma. 


Bu öğreticide, sürekli dağıtım kullanarak, Visual Studio kullanarak ASP.NET Core web uygulaması oluşturma ve 
bunu Visual Studio'dan Azure App Service'e dağıtma gösterilir. 

Ayrıca bkz: Azure işlem hattı ile ilk işlem hattınızı oluşturma, nasıl bir sürekli teslim (CD) iş akışı yapılandırma 
Azure App Service Azure DevOps Hizmetleri'ni kullanarak. Azure işlem hatları (Azure DevOps Hizmetleri 
hizmeti), Azure App Service'te barındırılan uygulamalar için güncelleştirmeleri yayımlamak için sağlam bir dağıtım 
işlem hattı ayarlamayı basitleştirir, işlem hattı, Azure portalından oluşturmak, testleri çalıştırmak, hazırlama 
yuvasına dağıtın ve sonra üretim ortamına dağıtmak için yapılandırılabilir. 


NOTE 

Bu öğreticiyi tamamlamak için Microsoft Azure hesabı gereklidir. Bir hesap almak için MSDN abone Avantajlarınızı 
etkinleştirebilir veya ücretsiz deneme için kaydolun. 


Önkoşullar 

Bu öğreticide, aşağıdaki yazılımın yüklü olduğu varsayılır: 

• Visual Studio 

• .NET core SDK 2.0 veya üzeri 

• Git VVİndovvs için 

Bir ASP.NET Core web uygulaması oluşturma 

1. Visual Studio'yu çalıştırın. 

2. Gelen dosya menüsünde yeni > proje. 

3. Seçin ASP.N ET Core Web uygulaması proje şablonu. Altında göründüğü yüklü > şablonları > Visual 

C# > .N ET Core. Projeyi adlandırın sampiewebAppDemo .Seçin yeni Git deposu Oluştur seçeneğini ve 
tıklayın Tamam. 







New Project 


? 


X 


> Recent 
A Instalied 

d Visual C# 

Windows Unıversal 
Windows Classic Desktop 
Web 

r> Office/SharePoint 
.NET Core 
.NET Standard 
Android 
Cloud 

Cross-Platform 
Extensibility 
t> İOS 
Test 
t> tvOS 
WCF 

VVorkflovv 
t> Visual Basic 
t- Visual C++ 
t* Visual F# 

SQL Server 
R 


.NET Framevvork 4.6.1 * Şort by: Default 

- [5=1 

Search (Ctrl+E) fi 

§a 

Console App (.NET Core) 

Visual C# 

Type: Visual C# 

V 



Project templates for creating ASP.NET 

ü 

Class Library (.NET Core) 

Visual C# 

Core applications for VVindovvs, Linux and 
macOS using .NET Core or .NET 




Framevvork. 


5J 

Unit Test Project (.NET Core) 

Visual C# 


xl)nit Test Project (.NET Core) 

Visual C# 


ASP.NET Core Web Application 

Visual C* 


Not finding what you are looking for? 

Öpen Visual Studio Installer 


Name: 
Location: 
Solution name: 


[ SampleWebAppDemo| 
C:\Users\lsaac\Desktop 
SampleWebAppDemo 


J 


Brovvse... 

Create directory for solution 
Create new Git repository 


OK Cancel 


4. içinde yeni ASP.N ET Core projesi iletişim kutusunda, ASP.NET Core seçin boş şablonu, ardından 

Tamam. 


New ASP.NET Core Web Application - SampleVVebAppDemo 


? X 


.NET Core 


v İASP.NET Core 2.0 ~ | Learn more 



n 

s 

Web API 

il 

Web 

Application 

S 

Web 

Application 

(Model-View- 

Controller) 

0 

Angular 

React.js 

React.js and 
Redux 





An empty project template for creating an ASP.NET 
Core application. This template does not have any 
content in it. 

Learn more 


Change Authentication 


Authentication No Authentication 


_1 Enable Docker Support 

OS: Windows 

Requires Docker for VVindovvs 

Docker support can also be enabled later Learn more 


OK 


Cancel 


NOTE 

En son .NET Core 2.0 sürümüdür. 


Web uygulamasını yerel olarak çalıştırma 

1. Visual Studio uygulamayı oluşturmayı tamamladığında, uygulamayı seçerek çalıştırma hata ayıklama > 
hata ayıklamayı Başlat. Alternatif olarak, basın F5. 


































Bu, Visual Studio ve yeni uygulamayı başlatmak için zaman alabilir.Tamamlandığında, tarayıcıyı çalışmakta 
olan uygulamayla gösterir. 


S localhost 

<- -> Ü 

Hello World! 


X + 
localhost 


□ 

☆ i =- 


X 


2. Çalışan Web uygulamasına inceledikten sonra Tarayıcıyı kapatın ve uygulamanın durdurmak için Visual 
Studio araç çubuğunda "Hata ayıklamayı Durdur" simgesini seçin. 

Azure Portalfnda bir web uygulaması oluşturma 

Aşağıdaki adımlar, Azure Portalı'nda bir web uygulaması oluşturur: 

1. Oturum Azure portalında. 

2. Seçin yeni en sol üst köşesindeki portal arabirimi. 


3. Seçin Web + mobil > Web uygulaması. 



Microsoft Azure v New > Web + Mobile > VVebApp 


_ □ X 


_ □ X 


New 


** Resource groups 


::: Ali resources 


A Recent 


App Services 


D SQL databases 
El Virtual machines (classic) 


Search the marketplace 


MARKETPLACE 


Compute 


Web + Mobile 


Data + Storage 
Data + Analytics 


Internet of Things 


Web + Mobile 


FEATURED APPS 


Web App 

Enjoy secure and flexible 
development, deployment, and 
scaling options for your web app. 

Mobile App 

A scalable and secure backend that 
can be used to povver apps on any 
platform - ÎOS, Android, Windows or 


Virtual machines 


Cloud Services (classic) 


? Subscriptions 


" Application Insights 


^ App Service plans 
IS App Service Environme... 
S Storage accounts (class... 
SQL servers 


Brovvse > 


Netvvorlöng 


Media + CDN 


Hybrid Integration 
Securıty + Identity 
Developer Services 
Management 
Container Apps 


Web App 

Microsoft 


Ubuntu Server 15.04 


API App 

scalable RESTful API with enterprise 
grade securıty. simple access control 
I and auto SDK generation 

Logic App (preview) 

Automate the access and use of 
I data across douds wrthout writing 
PREVIEW code 


App Service Environment 

gp Deploy Azure App Services in your 
m Virtual Network with greater scaling 
options 

API Management 13 

Ensure a successful API program 
through developer engagement, 

I analytics, securıty, and protection. 

Mobile Engagement E 

İH Azure Mobile Engagement is a SaaS- 

iliil delivered, data-driven user 

engagement platform that enables 


4. içinde Web uygulaması dikey penceresinde için benzersiz bir değer girin uygulama hizmeti adı. 



Web App 


n x 


* App Service Name 


| SampleWebAppDemo 

✓ 

.azurewebsites.net 

* Subscription 


Visual Studio Ultimate with MSDN 

V 


* Resource Group 


Default-Web-WestUS 

> 

Nevv 


* App Service plan/Location 

> 

DefaultO(West US) 


>/ Pin to dashboard 


Create 


NOTE 

Uygulama hizmeti adı adı benzersiz olmalıdır. Adı sağlandığında portal bu kuralı uygular. Bu değer her oluşumu için 
farklı bir değer sağlayan, yerine SampleVVebAppDemo bu öğreticideki. 


Ayrıca Web uygulaması dikey penceresinde, mevcut bir seçin App Service planı/konumu veya yeni bir 
tane oluşturun. Yeni bir plan oluşturuyorsanız, fiyatlandırma katmanını, konum ve diğer seçenekleri'ni seçin. 
App Service planları hakkında daha fazla bilgi için bkz. Azure App Service planlarına ayrıntılı genel bakış. 

5. Oluştur' u seçin. Azure, sağlama ve vveb uygulaması başlatın. 












Microsoft Azure v SampleVVebAppDemoOI 


New 

<V Resource groups 
::: Ali resources 
O Recent 
9 App Services 
^ SQL databases 
«Ü Virtual machines (classic) 
H Virtual machines 


_ n x 


SampleWebAppDemo01 


Web app 


O X 

Settings Tools 

E 

Browse 

■ 

Stop 

** 0 > 

Swap Restart Oelete 

± 

Get Mor e 

publish„. commanc... 

Essentials ^ 




O 

Resource group 



URL 


Defau İt-Web-West 

Status 

Running 

Location 

West US 

Subscription name 

ıate wıth MS 


App Service plan/pricing tier 

FTP/Deployment username 

SampleWebAppDemo01\erikre01 

FTP hostname 

ftD://waws-Drod-bav-005.ftD.azurewebsites... 

Subscription id 



FTPS hostname 


ftps://waws-prod-bay-005.ftp.azurewebsite... 


4 


Yeni web uygulaması için Git yayımlamayı etkinleştirme 

Git, bir Azure App Service web uygulaması dağıtmak için kullanılan bir dağıtılmış sürüm denetim sistemidir.Web 
uygulama kodu yerel bir Git deposunda depolanır ve kodu uzak depoya ileterek Azure'a dağıtılır. 

1. Oturum Azure portalında. 

2. Seçin uygulama hizmetleri Azure aboneliği ile ilişkili uygulama hizmetlerin bir listesini görüntülemek 
için. 

3. Bu öğreticinin önceki bölümünde oluşturduğunuz web uygulamasını seçin. 

4. içinde dağıtım dikey penceresinde dağıtım seçenekleri > Kaynağı Seç > yerel Git deposu. 


DEPLOYMENT 

Deployment option 

Set up deployment option 

X 

Choose source □ X 

Quickstart 

* Choose Source 

> 

Visual Studio Team Services 

By Microsoft 

El Deployment credentials 

Configure reguired settings 


III Deployment slots 


Deployment options 
Continuous Delivery (Previevv) 


OneDrive 
By Microsoft 


□ 


Local Git Repository 
By Git 


GitHub 

® ™ By GitHub 


Bitbucket 
By Atlassian 


Dropbox 
By Dropbox 


^ External Repository 


5. Tamam ı seçin. 

6. Dağıtım kimlik bilgileri, bir web uygulaması veya diğer App Service uygulaması yayımlamak için önceden 
kurulmuş yüklemediyseniz, bunları şimdi ayarlayın: 

• Seçin ayarları > dağıtım kimlik bilgileri. Dağıtım kimlik bilgilerini ayarla dikey penceresi 
görüntülenir. 

• Bir kullanıcı adı ve parola oluşturun. Git'i kurma ayarlarken daha sonra kullanmak için parola kaydedin. 








• Kaydet i seçin. 

7. içinde Web uygulaması dikey penceresinde ayarları > özellikleri. Dağıtmak için Uzak Git deposunun 
URL'sini altında gösterilen GİT URL'si. 

8. Kopyalama GİT URL'si öğreticide daha sonra kullanmak için değer. 


_ n 

Properties 

samplevvebappdemoOI 


STATUS 

Running 

URL 

İŞâm£lewebap^deıjıo01.azurewebsit^ 

VIRTUAL İP ADDRESS 

No IP-based SSL binding is configured 

MODE 

Free 


OUTBOUND İP ADDRESSES 


23.99.3.91,23.99.3.100,23.993.101,23.99.3 


Ifi 


FTP/DEPLOYMENT USER 


SampleWebAppDemo01\erikre01 


k 


GİT URL 


https://erikre01 @samplewebappdemo01 


İB 


FTP HOŞT NAME 


ftpy/waws-prod-bay-005.ftp.azurewebsit' 


1 


FTP DIAGNOSTIC LOGS 


ftp://waws-prod-bay-005.ftp.azurewebsir 


1 


FTPS HOŞT NAME 


ftps://waws-prod-bay-005.ftp.azurewebsi 


k 


FTPS DIAGNOSTIC LOGS 


ftpsı//waws-prod-bay-005.ftp.azurewebsr 


k 


Web uygulamasını Azure App Service'e yayımlama 

Bu bölümde, Visual Studio ve anında iletme bu depodan web uygulamasına dağıtmak için Azure'da kullanarak 
yerel bir Git deposu oluşturun. Adımlar şunlardır: 

• GİT URL değeri, yerel depoya Azure'a dağıtılacak şekilde kullanarak uzak depo ayarı ekleyin. 



































• Proje değişiklikleri uygulayın. 

• Proje değişiklikleri yerel depodan Azure'da uzak depoya gönderin. 

1. içinde Çözüm Gezgini sağ çözüm 'SampleVVebAppDemo' seçip işleme. Takım Gezgini görüntülenir. 


Team Explorer - Connect 


f£) T 6 earchWoricİte fi- 

Connect Offiine -r 


Manage Connections 

■a Hosted Service Providers 



Visual Studio Online 

Microsoft Corporation 


Services to help you ship high quality software. On time, 
everytime. Focus on your code. We'll simplify the rest. 

Connect... Get started for free @ 


O GitHub 

GitHub, İne. 

Powerful collaboration, code review, and code 
managementfor öpen source and private projeets. 

Connect... Sign up @ 


\a Local Git Repositories 

New ■» J Add | Cİone ▼ [ View Öptions ■» 

Add or elone a Git repository to get started. 


Solution Explorer Team Explorer ClassView 


2. içinde Takım Gezginiseçin giriş (giriş simgesi) > ayarları > depo ayarları. 

3. İçinde uzaktan kumandalar bölümünü depo ayarlarıseçin Ekle. Ekleme uzak iletişim kutusu 
görüntülenir. 


4. Ayarlama adı için uzaktan Azure örnek uygulaması. 

5. Değerini Fetch için Git URL'si Bu öğreticide daha önce Azure'dan kopyalanır.ile biten URL olduğunu 
unutmayın .git. 


Edit Remote Azure- SampleApp 


Name: 

Fetch: 


Azure-SampleApp 


https://erikre01©samplewebappdemo1.scm.azurewebsites.net:443/SampleJ 


Push: https://erıkre01 ©samplewebappdemo1 .scm.azure\vebsıtes.net:443/Sample\ 

0 Push matehes fetch 


[“TT- 

Cancel 




NOTE 

Alternatif olarak, uzak depodan belirtin komut penceresi açarak komut penceresi, proje dizinine değiştirme ve 
komutunu girerek. Örnek: 

git remote add Azure-SampleApp https://me@sampleapp.sem.azurewebsites.net:443/SampleApp.git 


6. Seçin giriş (giriş simgesi) > ayarları > genel ayarlar. Ad ve e-posta adresinin ayarlandığını onaylayın. 
Seçin güncelleştirme gerekirse. 

7. Seçin giriş > değişiklikleri dönmek için değişiklikleri görünümü. 























8. Bir işleme iletisi girin ilk anında iletme #1 seçip işleme. Bu eylem, oluşturur bir işleme yerel olarak. 


1 Team Explorer - Changes 


- n x 

O (2 T 6 [ Search Woı 

rk Items (Ctrl-*- 

fi- j 

Changes WebApplication3 



Branch: master 



| Initial push #1 | 


Commit I» Actions 


A Included Changes (62) 

Exclude Ali | View Options 

I c:\users\erikre\documents\visual studio 2015\Projec... 

A Excluded Changes 

Include Ali | View Options 

Drag changes here to exclude from the commit. 

> Untracked Fileş 

Solution Explorer Team Explorer Server Explorer 


NOTE 

Alternatif olarak, işleme değişir komut penceresi açarak komut penceresi, proje dizinine değiştirme ve git 
komutları girerek. Örnek: 

git add . 

git commit -am "Initial Push #1" 


9. Seçin giriş > eşitleme > eylemleri > komut istemi açın. Komut istemi proje dizinine açılır. 
10. Komut penceresinde aşağıdaki komutu girin: 


git push -u Azure-SampleApp master 


11. Azure girin dağıtım kimlik bilgileri Azure'da daha önce oluşturulan parola. 

Bu komut, yerel proje dosyalarını Azure'a gönderme işlemini başlatır. Yukarıdaki komut çıktısı, dağıtım 
başarılı bir ileti ile sona erer. 

remote: Finished successfully. 

remote: Running post deployment command(s)... 

remote: Deployment successful. 

To https://username@samplewebappdemo01.scm.azurewebsites.net:443/SampleWebAppDemo01.git 
* [new branch] master -> master 

Branch master set up to track remote branch master from Azure-SampleApp. 



Etkin dağıtımı doğrulama 

Azure web app aktarımı yerel bir ortamdan başarılı olduğunu doğrulayın. 

içinde Azure portalı, web uygulamasını seçin. Seçin dağıtım > dağıtım seçenekleri. 












l S? Overvievv 
B Activity log 
•Û Access control (IAM) 

# Tags 

X Diagnose and solve problems 


TUE 10/31 


Initial push #1 
y ilevin 

Active 

12:25 PM 





DEPLOYMENT 
41 Quickstart 
ti Deployment credentials 
İli Deployment slots 
Deployment options 

l'- C nntînımııç neli\/erv fPrpvıpw/l 



Uygulamayı Azure'da çalıştırın 

Web uygulamasını Azure'a dağıtıldığına göre uygulamayı çalıştırın. 

Bu iki şekilde gerçekleştirilebilir: 

• Azure Portalı'nda web uygulaması için web uygulaması dikey bulun. Seçin Gözat uygulamayı varsayılan 
tarayıcıda görüntülemek için. 

• Bir tarayıcı açın ve web uygulamasının URL'sini girin. Örnek: http://sampiewebAppDemo.azurewebsites.net 

Web uygulamasını güncelleştirme ve yeniden yayımlama 

Yerel koda değişiklikleri yaptıktan sonra yeniden yayımlayın: 

1. İçinde Çözüm Gezgini Visual Studio açık Startup.es dosya. 

2. içinde configure yöntemini, değiştirme Response.writeAsync şekilde aşağıdaki gibi görünecek şekilde 
yöntemi: 

await context.Response.WriteAsync("Hello World! Deploy to Azure."); 

3. Değişiklikleri kaydetmek Startup.es. 

4. İçinde Çözüm Gezgini, sağ çözüm , SampleWebAppDemo' seçip işleme. Takım Gezgini görüntülenir. 

5. Bir işleme iletisi girin update #2 . 

6. Tuşuna işleme proje değişiklikleri kaydetmek için düğme. 

7. Seçin giriş > eşitleme > eylemleri > anında iletme. 

NOTE 

Alternatif olarak, değişiklikleri anında iletme komut penceresi açarak komut penceresi, proje dizinine değiştirmeye bir git 
komutu girmeyi. Örnek: 

git push -u Azure-SampleApp master 























Güncelleştirilen web uygulamasını Azure'da görüntüleme 

Güncelleştirilen web uygulamasını seçerek görüntüleme Gözat bir tarayıcıyı açarak ve web uygulaması için URL 
girilerek veya Azure Portal'da vveb uygulaması dikey penceresinden. Örnek: 
http://Samplel/debAppDemo.azurewebsites.net 


Ek kaynaklar 

• Azure işlem hattı ile ilk işlem hattımzı oluşturun 

• Kudu projesi 

• ASP.NET Core uygulama dağıtımı için Visual Studio yayımlama profilleri (. pubxml) 



ASRNET Core Modülü 

8.11.2019 * 70 minutes to read ı Edit Online 


, Tom Dykstra, Rick Strahl, ChrisNo, Rick Anderson, Sourabh Shirhatti, adatın kotalikve Luke Latham tarafından 
ASP.NET Core modülü, 11S ardışık düzenine şu şekilde takılan yerel bir 11S modülüdür: 

• işlem içi barındırma modeliolarak adlandırılan MS çalışan işleminin ( w3wp.exe ) içinde bir ASP.NET Core 
uygulaması barındırın. 

• Web isteklerini, işlem dışı barındırma modeliolarak adlandırılan Kestrel sunucusunuçalıştıran bir arka uç 
ASP.NET Core uygulamasına iletin. 

Desteklenen Windows sürümleri: 

• Windows 7 veya üzeri 

• Windows Server 2008 R2 veya üzeri 

İşlem içi barındırma sırasında, modül 11S HTTP sunucusu ( nsHttpServer ) adlı 11S için işlem içi sunucu 
uygulamasını kullanır. 

işlem dışı barındırma sırasında modül yalnızca Kestrel ile birlikte kullanılabilir. Modül, http. sysile çalışmıyor. 

Barındırma modelleri 

İşlem içi barındırma modeli 

Uygulamalar, işlem içi barındırma modelinde varsayılan olarak ASP.NET Core. 
işlem içi barındırma sırasında aşağıdaki özellikler geçerlidir: 

• Kestrel Server yerine 11S HTTP sunucusu ( nsHttpServer ) kullanılır, işlem içi, Createdefaultbuilder Usel IS ' i 
çağırır: 

o nsHttpServer kaydedin. 

o ASP.NET Core modülünün arkasında çalışırken sunucunun dinlemesi gereken bağlantı noktasını ve temel 
yolu yapılandırın. 

o Konağı, başlatma hatalarını yakalamak üzere yapılandırın. 

• RequestTimeout özniteliği işlem içi barındırma için uygulanmaz. 

• Uygulama havuzunu uygulamalar arasında paylaşma desteklenmez. Uygulama başına bir uygulama havuzu 
kullanın. 

• Web dağıtımı kullanırken veya dağıtımda el ile bir app_offline. htm dosyasıyerleştirilirken, açık bir bağlantı 
varsa uygulama hemen kapanmayabilir. Örneğin, bir VVebSocket bağlantısı, uygulamanın kapatılmasını 
erteleyebilir. 

• Uygulamanın mimarisi (bit genişliği) ve yüklü çalışma zamanının (x64 veya x86) uygulama havuzunun 
mimarisiyle eşleşmesi gerekir. 

• istemci bağlantısı kesiliyor algılandı, istemci bağlantısı kesildiğinde HttpContext. RequestAborted iptal 
belirteci iptal edilir. 

• ASP.NET Core 2.2.1 veya önceki sürümlerde, GetCurrentDirectory, uygulamanın dizini yerine 11S tarafından 
başlatılan işlemin çalışan dizinini döndürür (örneğin, W3wp. exeiçin c:\Windows\System32\inetsrv). 







Uygulamanın geçerli dizinini ayarlayan örnek kod için bkz. Currentdirectoryyardımcıları sınıfı. 
setcurrentDirectory yöntemini çağırın. GetCurrentDirectory sonraki çağrılar, uygulamanın dizinini sağlar. 

• işlem sırasında barındırırken, bir kullanıcıyı başlatmak için AuthenticateAsync iç olarak çağrılmaz. Bu 

nedenle, her kimlik doğrulamasından sonra talepleri dönüştürmek için kullanılan IClaimsTransformation bir 
uygulama varsayılan olarak etkinleştirilmez. Talepler IClaimsTransformation uygulamasıyla dönüştürülürken, 
kimlik doğrulama hizmetleri eklemek için AddAuthentication çağırın: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddTransient<IClaimsTransformation, ClaimsTransformer>(); 

Services.AddAuthentication(IISServerDefaults.AuthenticationScheme); 

} 

public void Configure(IApplicationBuilder app) 

{ 

app.UseAuthentication(); 

} 

o Web paketi (tek dosya) dağıtımları desteklenmez. 

İşlem dışı barındırma modeli 

Bir uygulamayı işlem dışı barındırmak üzere yapılandırmak için, <AspNetcoreHostingModei> özelliğinin değerini proje 
dosyasında (. csproj) outofProcess olarak ayarlayın: 

<PropertyGroup> 

<AspNetCoreHostingModel>OutOfProcess</AspNetCoreHostingModel> 

</PropertyGroup> 


işlem içi barındırma, varsayılan değer olan inProcess ile ayarlanır. 


<AspNetCoreHostingModel> 

değeri büyük/küçük harfe duyarlıdır, bu nedenle 

inprocess 

ve outofprocess 


değerlerdir. 

Kestrel sunucusu MS HTTP sunucusu yerine kullanılır ( ııSHttpServer ). 
İşlem dışı için Createdefaultbuilder UselISIntegration ' i çağırır: 


• ASP.NET Core modülünün arkasında çalışırken sunucunun dinlemesi gereken bağlantı noktasını ve temel yolu 
yapılandırın. 

• Konağı, başlatma hatalarını yakalamak üzere yapılandırın. 

Barındırma modeli değişiklikleri 

hostingModei ayarı Web. config dosyasında değiştirilirse ( Web. config ile yapılandırma bölümünde 
AÇ 1 KLANM 1 ŞT 1 R), modül 11S için çalışan işlemini geri dönüştürür. 


US Express için modül çalışan işlemini geri dönüştürmez, bunun yerine geçerli US Express işleminin düzgün bir 
şekilde kapatılmasını tetikler. Uygulamaya yönelik bir sonraki istek, yeni bir US Express işlem olarak çoğaltılır. 


İşlem adı 

Process .GetCurrentProcess(). ProcessName rapor w3wp / iisexpress (işlem İÇİ) veya dotnet (işlem dişi). 

Windows kimlik doğrulaması gibi birçok yerel modül etkin kalir.ASP.NET Core modülüyle etkin US modülleri 
hakkında daha fazla bilgi için, bkz.ASP.NET Core içeren US modülleri. 


ASP.NET Core modülü de şunları yapabilir: 


• Çalışan işlem için ortam değişkenlerini ayarlayın. 




















• Başlatma sorunlarını gidermek için stdout çıkışını dosya depolama alanına kaydedin. 

• Windows kimlik doğrulama belirteçlerini ilet. 

ASP.NET Core modülünü yüklemek ve kullanmak 

ASP.NET Core modülünün nasıl yükleneceğine ilişkin yönergeler için bkz. .NET Core barındırma paketi 'Ni 
yüklemek. 

Web. config ile yapılandırma 

ASP.NET Core modülü, sitenin Web. config dosyasındaki system.webserver düğümünün aspNetcore bölümü ile 
yapılandırılır. 

Aşağıdaki Web. config dosyası, çerçeveye bağlı bir dağıtım İçin yayımlanır ve ASP.NET Core modülünü site 
isteklerini işleyecek şekilde yapılandırır: 

<?xml version="1.0" encoding="utf-8"?> 

<configuration> 

docation path="." inheritInChildApplications="false"> 

<system.webServer> 

<handlers> 

<add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" /> 
</handlers> 

<aspNetCore processPath="dotnet" 

arguments=". \MyApp .dil" 
stdoutLogEnabled="false" 
stdoutLogFile=". \logs\stdout" 
hostingModel="inprocess" /> 

</system.webServer> 

</location> 

</configuration> 


Aşağıdaki Web. config , kendinden bağımsız bir dağıtım için yayımlanır: 

<?xml version="1.0" encoding="utf-8"?> 

<configuration> 

<location path="." inheritInChildApplications="false"> 

<system.webServer> 

<handlers> 

<add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" /> 
</handlers> 

<aspNetCore processPath=". \MyApp.exe" 
stdoutLogEnabled="false" 
stdoutLogFile=". \logs\stdout" 
hostingModel="inprocess" /> 

</system.webServer> 

</location> 

</configuration> 


InheritlnChildApplications özelliği, <location > öğesi içinde belirtilen ayarların uygulamanın bir alt dizininde 
bulunan uygulamalar tarafından devralınmadığını göstermek için faise olarak ayarlanır. 

Bir uygulama Azure App S ervicedağıtıIdığında stdoutLogFile yolu \\?\%home%\LogFiies\stdout olarak ayarlanır. Yol, 
stdout günlüklerini hizmet tarafından otomatik olarak oluşturulan bir konum olan LogFiles klasörüne kaydeder. 

IIS alt uygulama yapılandırması hakkında bilgi için bkz. 11S ile Windows üzerinde ASP.NET Core barındırma. 


AspNetCore öğesinin öznitelikleri 










OZNITELIK 


AÇIKLAMA 


VARSAYILAN 


arguments 


disableStartUpErrorPage 


forwar'dWindowsAuthToken 


hostingModel 


processesPerApplication 


ppocessPath 


isteğe bağlı dize özniteliği. 

ProcessPathiçinde belirtilen 
yürütülebilir dosya için bağımsız 
değişkenler. 


isteğe bağlı Boolean özniteliği. 

Doğru ise, 502,5-lşlem hatası 

sayfası bastırılır ve Web. config 
dosyasında yapılandırılan 502 
durum kodu sayfası önceliklidir. 


f alse 


isteğe bağlı Boolean özniteliği. 

True ise belirteç istek başına ' MS- 
ASPNETCORE-VVıNAUTHTOKEN ' 
üst bilgisi olarak% 
ASPNETCORE_PORT% üzerinde 
dinleme yapan alt işleme iletilir. Bu, 
istek başına bu belirteçte 
CloseHandle çağırma işleminin 
sorumluluğundadır. 


isteğe bağlı dize özniteliği. 

Barındırma modelini işlem içi ( 
InPpocess / inprocess ) veya 
işlem dişi ( OutOfProcess / 
outofprocess ) olarak belirtir. 


InProcess 

inprocess 


isteğe bağlı tamsayı özniteliği. 

ProcessPath ayarında belirtilen 
işlemin örnek sayısını, uygulama 
başına bir şekilde işleyecek şekilde 
belirtir. 

tlşlem içi barındırma İçin, değer ı 
ile sınırlıdır. 

processesPerApplication 
ayarlama önerilmez. Bu öznitelik 
gelecek bir sürümde kaldırılacak. 


Varsayılan: ı 


Min: 

1 


En fazla: 

100 ' 


Gerekli dize özniteliği. 

HTTP isteklerini dinleyen bir işlemi 
başlatan yürütülebilir dosyanın yolu. 
Göreli yollar desteklenir. Yol . ile 
başlıyorsa, yol site köküne göreli 
olarak kabul edilir. 















OZNITELIK 


AÇIKLAMA 


VARSAYILAN 


rapidFailsPerMinute 


requestTimeout 


shutdownTime Limit 


startupTimeLimit 


isteğe bağlı tamsayı özniteliği. 

ProcessPath içinde belirtilen işleme 
dakika başına kilitlenme için izin 
verilen sayıyı belirtir. Bu sınır aşılırsa 
modül, dakika geri kalanı için işlemi 
başlatmayı durduruyor. 

işlem içi barındırma ile 
desteklenmez. 


Varsayılan: 10 


Min: 

0 


En fazla: 

100 


isteğe bağlı TimeSpan özniteliği. 

ASP.NET Core modülünün,% 
ASPNETCORE_PORT% üzerinde 
dinleme işleminden yanıt beklediği 
süreyi belirtir. 

ASP.NET Core 2,1 veya üzeri 
sürümü ile birlikte gelen ASP.NET 
Core modülünün sürümlerinde, 
requestTimeout saat, dakika ve 
saniye olarak belirtilir. 

işlem içi barındırma için 
uygulanmaz, işlem içi barındırma 
için modül, uygulamanın isteği 
işlemesini bekler. 

Dizenin dakika ve saniye kesimleri 
için geçerli değerler 0-59 
aralığındadır. Dakika veya saniye 
değerindeki 60 kullanımı, 500-iç 
sunucu hatasına neden olur. 


Varsayılan: 00 : 02:00 
Min: 00 : 00:00 
En fazla: 360 : 00:00 


isteğe bağlı tamsayı özniteliği. 

App_offline. htm dosyası 
algılandığında, modülün 
yürütülebilir dosyanın düzgün 
şekilde kapatılmasını beklediği 
saniye cinsinden süre. 


Varsayılan: 10 


Min: 

0 


En fazla: 

600 


isteğe bağlı tamsayı özniteliği. 

Modülün, bağlantı noktasında 
dinleme yapan bir işlemin 
başlamasını bekleyeceği saniye 
cinsinden süre. Bu süre sınırı aşılırsa, 
modül işlemi bu işlemden sonra da 
bir kez gider. Modül, yeni bir istek 
aldığında işlemi yeniden başlatmayı 
dener ve uygulamanın son geçen 
dakikada rapidFailsPerMinute kez 
başlayamadığı sürece sonraki gelen 
isteklerde işlemi yeniden başlatmayı 
dener. 


Varsayılan: 120 


Min: 

0 


En fazla: 

3600 


0 (sıfır) değeri sonsuz bir zaman 
aşımı olarak kabul edilmez . 












OZNITELIK 


AÇIKLAMA 


VARSAYILAN 


stdoutLogEnabled 


İsteğe bağlı Boolean özniteliği. 

True ise, processPath içinde 
belirtilen işlem için stdout ve stderr 
, stdoutLogFileiçinde belirtilen 
dosyaya yeniden yönlendirilir. 


f alse 


stdoutLogFile isteğe bağlı dize Özniteliği. aspnetcore-stdout 

ProcessPath içinde belirtilen 
işlemden stdout ve stderr 'in 
günlüğe kaydedildiği göreli veya 
mutlak dosya yolunu belirtir. Göreli 
yollar, sitenin köküne göredir. . 
başlayan tüm yollar site köküne 
göredir ve diğer tüm yollar mutlak 
yollar olarak değerlendirilir. Yolda 
sunulan klasörler, günlük dosyası 
oluşturulduğunda modül tarafından 
oluşturulur. Alt çizgi sınırlayıcılarını 
kullanma, bir zaman damgası, işlem 
KİMLİĞİ ve dosya uzantısı (. log) 
stdoutLogFile yolunun son 
kesimine eklenir. . \logs\stdout 
bir değer olarak sağlandıysa, 

2/5/2018 işlem 1934 KİMLİĞİ ile 
19:41:32 ' de tarihinde 
kaydedildiğinde Günlükler 
klasöründe 

stdout_20180205194132_ 1934. 
log dosyasına bir örnek stdout 
günlüğü kaydedilir. 


Ortam değişkenlerini ayarlama 

processPath özniteliğinde işlem için ortam değişkenleri belirtilebilir. Bir <environmentvariabies> koleksiyon 
öğesinin <environmentvariabie> alt öğesiyle bir ortam değişkeni belirtin. Bu bölümde ayarlanan ortam 
değişkenleri, sistem ortamı değişkenlerine göre önceliklidir. 

Aşağıdaki örnek, Web. corıfig dosyasında iki ortam değişkenini ayarlar. aspnetcore_environment , uygulamanın 
ortamını Development olarak yapılandırır. Bir geliştirici, uygulama özel durumunda hata ayıklarken Geliştirici özel 










durum sayfasını yüklemeye zorlamak için bu değeri geçici olarak Web. config dosyasında ayarlayabilir. config_dir , 
geliştiricinin, uygulamanın yapılandırma dosyasını yüklemek için bir yol oluşturmak üzere başlangıçta değeri 
okuyan kodu yazdığı Kullanıcı tanımlı ortam değişkenine bir örnektir. 

<aspNetCore processPath="dotnet" 
arguments=". \MyApp.dll" 
stdoutLogEnabled="false" 
stdoutLogFile=". \logs\stdout" 
hostingModel="inprocess"> 

<environmentVariables> 

<environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" /> 

<environmentVariable name="CONFIG_DIR" value="f: \application_config" /> 

</environmentVariables> 

</aspNetCore> 



app_offline. htm 

Bir uygulamanın kök dizininde app_offline. htm adlı bir dosya algılanırsa, AS P.N ET Core modülü uygulamayı 
düzgün bir şekilde kapatmaya ve gelen istekleri işlemeyi durdurmaya çalışır. Uygulama, shutdownTimeLimit 1 da 
tanımlanan saniye sayısından sonra hala çalışıyorsa, ASP.NET Core modülü çalışan işlemi de yok eder. 

App_offline. htm dosyası mevcut olsa da AS P.N ET Core modülü, istekleri, app_offline. htm dosyasının içeriğini geri 
göndererek yanıtlar. App_offline. htm dosyası kaldırıldığında, sonraki istek uygulamayı başlatır. 

işlem dışı barındırma modeli kullanılırken, açık bir bağlantı varsa uygulama hemen kapanmayabilir.Örneğin, bir 
VVebSocket bağlantısı, uygulamanın kapatılmasını erteleyebilir. 

Başlatma hatası sayfası 

Hem işlem içi hem de işlem dışı barındırma, uygulamayı başlatamadıklarında özel hata sayfaları üretir. 

ASP.NET Core modülü işlem içi veya işlem dışı istek işleyicisini bulamazsa, 500,0-işlem içi/işlem dışı Işleyici 
yükleme hatası durum kodu sayfası görüntülenir. 

ASP.NET Core modülü uygulamayı başlatamadığında işlem içi barındırma için, 500,30-başlatma hatası durum 
kodu sayfası görüntülenir. 

ASP.NET Core modülü arka uç işlemini başlatamadığında veya arka uç işlemi başlatılırsa ancak yapılandırılmış 
bağlantı noktasında dinleyemediğinde, işlem dışı barındırma için 502,5-lşlem hatası durum kodu sayfası 
görüntülenir. 










Bu sayfayı bastırın ve varsayılan MS 5xx durum kodu sayfasına dönmek için disabiestartupErrorPage özniteliğini 
kullanın. Özel hata iletilerini yapılandırma hakkında daha fazla bilgi için bkz. http hataları <httpErrors >. 

Günlük oluşturma ve yeniden yönlendirme 

aspNetcore öğesinin stdoutLogEnabled ve stdoutLogFile öznitelikleri ayarlandıysa AS P.N ET Core modülü stdout 
ve stderr konsol çıkışını diske yönlendirir. stdoutLogFile yolundaki klasörler, günlük dosyası oluşturulduğunda 
modül tarafından oluşturulur. Uygulama havuzunun, günlüklerin yazıldığı konuma yazma erişimi olması gerekir 
(yazma izni sağlamak için us AppPooi\<app_pooi_name> kullanın). 

işlem geri dönüştürme/yeniden başlatma gerçekleşmediği sürece Günlükler döndürülemez. Bu, günlüklerin 
tükettiği disk alanını sınırlamak için barındırıcının sorumluluğundadır. 

Stdout günlüğünün kullanılması yalnızca MS 'de barındırırken veya Visual Studio İle MS için geliştirme zamanı 
desteğikullanılırken değil, yerel olarak hata ayıklarken ve uygulamayı MS Express ile çalıştırırken yalnızca uygulama 
başlatma sorunlarını gidermek için önerilir. 

Genel uygulama günlüğü amaçları için stdout günlüğünü kullanmayın. ASP.NET Core uygulamasında rutin günlük 
kaydı için, günlük dosyası boyutunu sınırlayan ve günlükleri döndüren bir günlüğe kaydetme kitaplığı kullanın. 
Daha fazla bilgi için bkz. üçüncü taraf günlüğü sağlayıcıları. 

Günlük dosyası oluşturulduğunda zaman damgası ve dosya uzantısı otomatik olarak eklenir.Günlük dosyası adı, alt 
çizgi ile ayrılmış stdoutLogFile yolunun (genellikle stdout) son kesimine zaman damgası, işlem kimliği ve dosya 
uzantısı (. log ) eklenerek oluşur. stdoutLogFile yolu stdout\\e sonlanıyorsa, 1934 ' de 19:42:32 2/5/2018 1 de 
oluşturulan Pl D 'sine sahip bir uygulama için bir günlük dosyası stdout_20180205194132_ 1934. log dosya adına 
sahiptir. 

stdoutLogEnabled false ise, uygulama başlangıcında oluşan hatalar yakalanır ve 30 KB 'a kadar olay günlüğüne 
yayınlanır. Başlangıçtan sonra tüm ek Günlükler atılır. 

Aşağıdaki örnek aspNetcore öğesi, bir göreli yol .\iog\ stdout günlüğünü yapılandırır. AppPool Kullanıcı 
kimliğinin, belirtilen yola yazma izni olduğunu doğrulayın. 

<aspNetcore processPath="dotnet" 
arguments=". \MyApp.dll" 
stdoutLogEnabled="true" 
stdoutLogFile=". \logs\stdout" 
hostingModel="inprocess"> 

</aspNetCore> 

Azure App Service dağıtım için bir uygulama yayımlarken, Web SDK stdoutLogFile değerini 
\\?\%home%\LogFiies\stdout olarak ayarlar. %home ortam değişkeni, Azure App Service tarafından barındırılan 
uygulamalar için önceden tanımlanmıştır. 

Günlüğe kaydetme filtresi kuralları oluşturmak için AS P.N ET Core günlük belgelerinin yapılandırma ve günlük 
filtreleme bölümlerine bakın. 

Yol biçimleri hakkında daha fazla bilgi için bkz. VVİndovvs sistemlerinde dosya yolu biçimleri. 

Gelişmiş tanılama günlükleri 

ASP.NET Core modülü, gelişmiş tanılama günlükleri sağlamak için yapılandırılabilir. <handierSettings> öğesini 
Web. con/igiçindeki <aspNetcore> öğesine ekleyin. debugLevel trace olarak ayarlamak, tanılama bilgilerini daha 
yüksek bir şekilde kullanıma sunar: 






















<aspNetCone processPath="dotnet" 
arguments=". \MyApp .dil" 
stdoutl_ogEnabled="false" 
stdoutLogFile="\\?\%home%\LogFiles\stdout" 
hostingModel="inpnocess"> 

<handlerSettings> 

<handlerSetting name="debugFlle" value=". \logs\aspnetcore-debug. log" /> 
<handlerSetting name="debugLevel" value="FILEjTRACE" /> 
</handlerSettings> 

</aspNetCore> 


Yoldaki tüm klasörler (önceki örnekteki Günlükler ), günlük dosyası oluşturulduğunda modül tarafından oluşturulur. 
Uygulama havuzunun, günlüklerin yazıldığı konuma yazma erişimi olması gerekir (yazma izni sağlamak için 
IIS AppPool\<app_pool_name> kullanın). 

Hata ayıklama düzeyi ( debugLevel ) değerleri hem düzeyi hem de konumu içerebilir. 

Düzeyler (en az ayrıntıdan en fazla ayrıntı sırasına göre): 

• HATAYLA 

• VVARNING 

• BİLGİSİNE 

• TRACE 

Konumlar (birden çok konuma izin verilir): 

• KONSOLA 

• EVENTLOG 

• DOSYASYNY 

işleyici ayarları, ortam değişkenleri aracılığıyla da kullanılabilir: 

• hata ayıklama günlük dosyasının - yolunu aspnetcore_module_debug_file . (Varsayılan: aspnetcore-Debug. log) 

• Hata ayıklama düzeyi ayarını - aspnetcore_module_debug . 


VVARNING 

Bir sorunu gidermek için dağıtımda hata ayıklama günlüğü 'nün gerekenden uzun süre etkin bırakmayın. Günlüğün boyutu 
sınırlı değil. Hata ayıklama günlüğünün etkin bırakılması, kullanılabilir disk alanını tüketebilir ve sunucu veya App Service 'i 
kilitlemez. 


Web. config dosyasındaki aspNetcore öğesinin bir örneği için bkz. Web. config ile yapılandırma . 

Yığın boyutunu değiştirme 

Yalnızca işlem içi barındırma modeli kullanılırken geçerlidir. 

Yönetilen yığın boyutunu, Web. config dosyasında bayt cinsinden stacksize ayarını kullanarak yapılandırın. 
Varsayılan boyut 1048576 bayttır (1 MB). 










<aspNetCone pnocessPath="dotnet" 
arguments=". \MyApp .dil" 
stdoutl_ogEnabled="false" 
stdoutLogFile="\\?\%home%\LogFiles\stdout" 
hostingModel="inpnocess"> 

<handlerSettings> 

<handlerSetting name="stackSize" value="2097152" /> 
</handlerSettings> 

</aspNetCore> 


Proxy yapılandırması HTTP protokolünü ve eşleştirme belirtecini kullanır 

Yalnızca işlem dışı barındırma için geçerlidir. 

ASP.NET Core modülü ve Kestrel arasında oluşturulan ara sunucu HTTP protokolünü kullanır. Modül ve Kestrel 
arasındaki trafiği sunucu dışı bir konumdan bırakırken gizlice dinleme riski yoktur. 

Eşleştirme belirteci, Kestrel tarafından alınan isteklerin MS tarafından proxy aldığından ve başka bir kaynaktan 
gelmediğinden emin olmak için kullanılır. Eşleştirme belirteci oluşturulur ve modül tarafından bir ortam 
değişkenine ( aspnetcore_token ) ayarlanır. Eşleştirme belirteci, her proxy isteğinde de bir üst bilgi ( 
ms-aspnetcore-token ) olarak ayarlanır.MS ara yazılımı, eşleştirme belirteci üstbilgi değerinin ortam değişkeni 
değeriyle eşleşip eşleşmediğini doğrulamak için aldığı her isteği denetler. Belirteç değerleri uyuşmadıysa, istek 
günlüğe kaydedilir ve reddedilir. Eşleştirme belirteci ortam değişkeni ve modülle Kestrel arasındaki trafik, sunucu 
dışında bir konumdan erişilebilir değildir. Eşleştirme belirteç değerini bilmeden, bir saldırgan MS ara yazılımı 'ndaki 
denetimi atlayan istekleri gönderemez. 

IIS paylaşılan yapılandırmasıyla ASP.NET Core modülü 

ASP.NET Core modülü yükleyicisi, Trustedlnstaller hesabının ayrıcalıklarıyla çalışır. Yerel sistem hesabı, MS 
paylaşılan Yapılandırması tarafından kullanılan paylaşım yolu için değiştirme iznine sahip olmadığından, yükleyici,' 
deki ApplicationHost. config dosyasında modül ayarlarını yapılandırmaya çalışırken bir erişim reddedildi hatası atar, 
paylaşma. 

MS yüklemesiyle aynı makinede bir IIS paylaşılan yapılandırması kullanırken, opt_no_shared_config_check 
parametresi ı olarak ayarlanan ASP.NET Core barındırma paketi yükleyicisini çalıştırın: 

dotnet-hosting-{VERSION}.exe 0PT_N0_SHARED_C0NFIG_CHECK=1 

Paylaşılan yapılandırmanın yolu IIS yüklemesiyle aynı makinede olmadığında, şu adımları izleyin: 

1 . MS paylaşılan yapılandırmasını devre dışı bırakın. 

2. Yükleyiciyi çalıştırın. 

3. Güncelleştirilmiş ApplicationHost config dosyasını paylaşıma dışarı aktarın. 

4. MS paylaşılan yapılandırmasını yeniden etkinleştirin. 

Modül sürümü ve barındırma paketi yükleyici günlükleri 

Yüklü ASP.NET Core modülünün sürümünü öğrenmek için: 

1. Barındırma sisteminde %windir%\system32\inetsrv dizininegldın. 

2. Aspnetcore. dil dosyasını bulun. 

3. Dosyaya sağ tıklayın ve bağlam menüsünden Özellikler ' i seçin. 

4. Ayrıntılar sekmesini seçin. Dosya sürümü ve ürün sürümü , modülün yüklü sürümünü temsil eder. 







Modülün barındırma paketi yükleyici günlükleri, C:\kuUanicdar\% username%\AppData\yerel\Tempkonumunda 
bulunur. Dosya, dd_DotNetCoreWınSvrHostıng__<zaman damgası > _000_Aspnetcoremodupa_x64. log olarak 
adlandırılmıştır. 

Modül, şema ve yapılandırma dosyası konumları 

Modül 

MS (X86/AMD64): 

• %windir%\System32\inetsrv\aspnetcore.dll 

• %windir%\SysWOW64\inetsrv\aspnetcore.dll 

• %ProgramFiles%\IIS\Asp.Net Core Module\v2\aspnetcorev2,dll 

• % ProgramFiles (x86)% \ ııs\ ASP.NET Core Module\v2\aspnetcorev2,dll 
MS Express (X86/AMD64): 

• %ProgramFiles%\IIS Express\aspnetcore.dll 

• % ProgramFiles (x86)% \ IIS Express\aspnetcore.dll 

• %ProgramFiles%\IIS Express\Asp.Net Core Module\v2\aspnetcorev2,dll 

• % ProgramFiles (x86)% \ IIS Express\Asp.Net Core Module\v2\aspnetcorev2,dll 

Şema 

ISS 

• %windir%\System32\inetsrv\config\schema\aspnetcore_schema.xml 

• %windir%\System32\inetsrv\config\schema\aspnetcore_schema_v2.xml 

MS Express 

• %ProgramFiles%\IIS Express\config\schema\aspnetcore_schema.xml 

• %ProgramFiles%\IIS Express\config\schema\aspnetcore_schema_v2.xml 

Yapılandırma 

ISS 

• %Windir%\System32\inetsrv\config\applicationPlost,config 

MS Express 

• Visual Studio: {APPLICATION ROOT} \. Vs\config\applicationhost,config 

• ıısexpress. exe CLI:%USERPROFILE%\Documents\IISExpress\config\applicationhost.config 
Dosyalar, ApplicationHost. config dosyasında aspnetcore ' u arayarak bulunabilir. 

ASP.NET Core modülü, IIS ardışık düzenine şu şekilde takılan yerel bir IIS modülüdür: 

• işlem içi barındırma modeliolarak adlandırılan IIS çalışan işleminin ( w3wp.exe ) içinde bir ASP.NET Core 
uygulaması barındırın. 

• Web isteklerini, işlem dışı barındırma modeliolarak adlandırılan Kestrel sunucusunuçalıştıran bir arka uç 
ASP.NET Core uygulamasına iletin. 


Desteklenen Windows sürümleri: 



• Windows 7 veya üzeri 

• Windows Server 2008 R2 veya üzeri 


işlem içi barındırma sırasında, modül 11S HTTP sunucusu ( nsHttpServer ) adlı 11S için işlem içi sunucu 
uygulamasını kullanır. 

işlem dışı barındırma sırasında modül yalnızca Kestrel ile birlikte kullanılabilir. Modül, http. sysile çalışmıyor. 

Barındırma modelleri 

İşlem içi barındırma modeli 

Bir uygulamayı işlem içi barındırma için yapılandırmak için, <Aspi\ietcoreHostingModei> özelliğini uygulamanın proje 
dosyasına inProcess (işlem dışı barındırma outofProcess ile ayarlanır) ile birlikte ekleyin: 

<PropertyGroup> 

<AspNetCoreHostingModel>InProcess</AspNetCoreHostingModel> 

</PropertyGroup> 


işlem içi barındırma modeli, .NET Framevvork hedefASP.NET Core uygulamalar için desteklenmez. 


<AspNetCoreHostingModel> 

değeri büyük/küçük harfe duyarlıdır, bu nedenle 

inprocess 

ve 

outofprocess 


değerlerdir. 

Dosyada <AspNetcoreHostingModei> özelliği yoksa, varsayılan değer OutofProcess ' dir. 
işlem içi barındırma sırasında aşağıdaki özellikler geçerlidir: 

• Kestrel Server yerine 11S HTTP sunucusu ( nsHttpServer ) kullanılır, işlem içi, Createdefaultbuilder Usel IS 1 i 
çağırır: 

o nsHttpServer kaydedin. 

o ASP.NET Core modülünün arkasında çalışırken sunucunun dinlemesi gereken bağlantı noktasını ve temel 
yolu yapılandırın. 

o Konağı, başlatma hatalarını yakalamak üzere yapılandırın. 

• RequestTimeout özniteliği işlem içi barındırma için uygulanmaz. 

• Uygulama havuzunu uygulamalar arasında paylaşma desteklenmez. Uygulama başına bir uygulama havuzu 
kullanın. 

• Web dağıtımı kullanırken veya dağıtımda el ile bir app_offline. htm dosyasıyerleştirilirken, açık bir bağlantı 
varsa uygulama hemen kapanmayabilir. Örneğin, bir VVebSocket bağlantısı, uygulamanın kapatılmasını 
erteleyebilir. 

• Uygulamanın mimarisi (bit genişliği) ve yüklü çalışma zamanının (x64 veya x86) uygulama havuzunun 
mimarisiyle eşleşmesi gerekir. 

• istemci bağlantısı kesiliyor algılandı. İstemci bağlantısı kesildiğinde HttpContext. RequestAborted iptal 
belirteci iptal edilir. 

• ASP.NET Core 2.2.1 veya önceki sürümlerde, GetCurrentDirectory, uygulamanın dizini yerine IIS tarafından 
başlatılan işlemin çalışan dizinini döndürür (örneğin, W3wp. exeiçır\ c:\Windows\System32\inetsrv). 

Uygulamanın geçerli dizinini ayarlayan örnek kod için bkz. Currentdirectoryyardımcıları sınıfı. 
setcurrentDirectory yöntemini çağırın. GetCurrentDirectory sonraki çağrılar, uygulamanın dizinini sağlar. 

• İşlem sırasında barındırırken, bir kullanıcıyı başlatmak için AuthenticateAsync iç olarak çağrılmaz. Bu 
nedenle, her kimlik doğrulamasından sonra talepleri dönüştürmek için kullanılan IClaimsTransformation bir 

















uygulama varsayılan olarak etkileştirilmez. Talepler IClaimsTransformation uygulamasıyla dönüştürülürken, 
kimlik doğrulama hizmetleri eklemek için AddAuthentication çağırın: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddTransientc IClaimsTransformation., ClaimsTransformer>(); 

Services.AddAuthentication(IISServerDefaults.AuthenticationScheme); 

} 

public void Configure(IApplicationBuilder app) 

{ 

app.UseAuthentication(); 

} 

İşlem dışı barındırma modeli 

Bir uygulamayı işlem dışı barındırmak üzere yapılandırmak için, proje dosyasında aşağıdaki yaklaşımlardan birini 
kullanın: 


• <AspNetcoreHostingModei> özelliğini belirtmeyin. Dosyada <AspNetcoreHostingModei> özelliği yoksa, varsayılan 
değer outofProcess 1 dir. 

• <AspNetcoreHostingModei> özelliğinin değerini OutofProcess olarak ayarlayın (işlem içi barındırma, inProcess ile 
ayarlanır): 



İşlem dışı için Createdefaultbuilder UselISIntegration ' i çağırır: 


• ASP.NET Core modülünün arkasında çalışırken sunucunun dinlemesi gereken bağlantı noktasını ve temel yolu 
yapılandırın. 

• Konağı, başlatma hatalarını yakalamak üzere yapılandırın. 


Barındırma modeli değişiklikleri 

hostingModei ayarı Web. config dosyasında değiştirilirse ( Web. config ile yapılandırma bölümünde 
AÇ 1 KLANM 1 ŞT 1 R), modül 11S için çalışan işlemini geri dönüştürür. 


11S Express için modül çalışan işlemini geri dönüştürmez, bunun yerine geçerli 11S Express işleminin düzgün bir 
şekilde kapatılmasını tetikler. Uygulamaya yönelik bir sonraki istek, yeni bir 11S Express işlem olarak çoğaltılır. 


İşlem adı 


Process .GetCurrentProcess(). ProcessName rapor w3wp / iisexpress (işlem İÇİ) veya dotnet (işlem dişi). 


Windows kimlik doğrulaması gibi birçok yerel modül etkin kalir.ASP.NET Core modülüyle etkin IIS modülleri 
hakkında daha fazla bilgi için, bkz.ASP.NET Core içeren IIS modülleri. 


ASP.NET Core modülü de şunları yapabilir: 

• Çalışan işlem için ortam değişkenlerini ayarlayın. 

• Başlatma sorunlarını gidermek için stdout çıkışını dosya depolama alanına kaydedin. 

• Windows kimlik doğrulama belirteçlerini ilet. 


















ASP.NET Core modülünü yüklemek ve kullanmak 

ASP.NET Core modülünün nasıl yükleneceğine ilişkin yönergeler için bkz. .NET Core barındırma paketi 1 Ni 
yüklemek. 

Web. config ile yapılandırma 

ASP.NET Core modülü, sitenin Web. config dosyasındaki system.webserver düğümünün aspNetcore bölümü ile 
yapılandırılır. 

Aşağıdaki Web. config dosyası, çerçeveye bağlı bir dağıtım İçin yayımlanır ve ASP.NET Core modülünü site 
isteklerini işleyecek şekilde yapılandırır: 

<?xml version="1.0" encoding="utf-8"?> 

<configuration> 

docation path="." inheritInChildApplications="false"> 

<system.webServer> 

<handlers> 

<add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModjleV2" resourceType="Unspecified" /> 
</handlers> 

<aspNetCore processPath="dotnet" 

arguments=". \MyApp .dil" 
stdoutLogEnabled="false" 
stdoutLogFile=". \logs\stdout" 
hostingModel="inprocess" /> 

</system.webServer> 

</location> 

</configuration> 


Aşağıdaki Web. config , kendinden bağımsız bir dağıtım için yayımlanır: 

<?xml version="1.0" encoding="utf-8"?> 

<configuration> 

<location path="." inheritInChildApplications="false"> 

<system.webServer> 

<handlers> 

<add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" /> 
</handlers> 

<aspNetCore processPath=". \MyApp.exe" 
stdoutLogEnabled="false" 
stdoutLogFile=". \logs\stdout" 
hostingModel="inprocess" /> 

</system.webServer> 

</location> 

</configuration> 


InheritlnChildApplications özelliği, <location > öğesi içinde belirtilen ayarların uygulamanın bir alt dizininde 
bulunan uygulamalar tarafından devralınmadığını göstermek için faise olarak ayarlanır. 

Bir uygulama Azure App S ervicedağıtıIdığında stdoutLogFiie yolu \\?\%home%\LogFiies\stdout olarak ayarlanır. Yol, 
stdout günlüklerini hizmet tarafından otomatik olarak oluşturulan bir konum olan LogFiles klasörüne kaydeder. 

IIS alt uygulama yapılandırması hakkında bilgi için bkz. 11S ile VVİndovvs üzerinde ASP.NET Core barındırma. 

AspNetCore öğesinin öznitelikleri 


ÖZNITELIK 


AÇIKLAMA 


VARSAYILAN 










OZNITELIK 


AÇIKLAMA 


VARSAYILAN 


arguments 


disableStartUpErrorPage 


forwar'dWindowsAuthToken 


hostingModel 


processesPerApplication 


processPath 


isteğe bağlı dize özniteliği. 

ProcessPathiçinde belirtilen 
yürütülebilir dosya için bağımsız 
değişkenler. 


isteğe bağlı Boolean özniteliği. 

Doğru ise, 502,5-lşlem hatası 

sayfası bastırılır ve Web. config 
dosyasında yapılandırılan 502 
durum kodu sayfası önceliklidir. 


f alse 


isteğe bağlı Boolean özniteliği. 

True ise belirteç istek başına ' MS- 
ASPNETCORE-VVıNAUTHTOKEN ' 
üst bilgisi olarak% 
ASPNETCORE_PORT% üzerinde 
dinleme yapan alt işleme iletilir. Bu, 
istek başına bu belirteçte 
CloseHandle çağırma işleminin 
sorumluluğundadır. 


isteğe bağlı dize özniteliği. 

Barındırma modelini işlem içi ( 
InProcess / inprocess ) veya 
işlem dişi ( Outofprocess / 
outofprocess ) olarak belirtir. 


OutOfProcess 

outofprocess 


isteğe bağlı tamsayı özniteliği. 

ProcessPath ayarında belirtilen 
işlemin örnek sayısını, uygulama 
başına bir şekilde işleyecek şekilde 
belirtir. 

tlşlem içi barındırma İçin, değer ı 
ile sınırlıdır. 

processesPerApplication 
ayarlama önerilmez. Bu öznitelik 
gelecek bir sürümde kaldırılacak. 


Varsayılan: ı 


Min: 

1 


En fazla: 

100 ■ 


Gerekli dize özniteliği. 

HTTP isteklerini dinleyen bir işlemi 
başlatan yürütülebilir dosyanın yolu. 
Göreli yollar desteklenir. Yol . ile 
başlıyorsa, yol site köküne göreli 
olarak kabul edilir. 















OZNITELIK 


AÇIKLAMA 


VARSAYILAN 


rapidFailsPerMinute 


requestTimeout 


shutdownTime Limit 


startupTimeLimit 


isteğe bağlı tamsayı özniteliği. 

ProcessPath içinde belirtilen işleme 
dakika başına kilitlenme için izin 
verilen sayıyı belirtir. Bu sınır aşılırsa 
modül, dakika geri kalanı için işlemi 
başlatmayı durduruyor. 

işlem içi barındırma ile 
desteklenmez. 


Varsayılan: 10 


Min: 

0 


En fazla: 

100 


isteğe bağlı TimeSpan özniteliği. 

ASP.NET Core modülünün,% 
ASPNETCORE_PORT% üzerinde 
dinleme işleminden yanıt beklediği 
süreyi belirtir. 

ASP.NET Core 2,1 veya üzeri 
sürümü ile birlikte gelen ASP.NET 
Core modülünün sürümlerinde, 
requestTimeout saat, dakika ve 
saniye olarak belirtilir. 

işlem içi barındırma için 
uygulanmaz, işlem içi barındırma 
için modül, uygulamanın isteği 
işlemesini bekler. 

Dizenin dakika ve saniye kesimleri 
için geçerli değerler 0-59 
aralığındadır. Dakika veya saniye 
değerindeki 60 kullanımı, 500-iç 
sunucu hatasmar\eder\ olur. 


Varsayılan: 00 : 02:00 
Min: 00 : 00:00 
En fazla: 360 : 00:00 


isteğe bağlı tamsayı özniteliği. 

App_offline. htm dosyası 
algılandığında, modülün 
yürütülebilir dosyanın düzgün 
şekilde kapatılmasını beklediği 
saniye cinsinden süre. 


Varsayılan: 10 


Min: 

0 


En fazla: 

600 


isteğe bağlı tamsayı özniteliği. 

Modülün, bağlantı noktasında 
dinleme yapan bir işlemin 
başlamasını bekleyeceği saniye 
cinsinden süre. Bu süre sınırı aşılırsa, 
modül işlemi bu işlemden sonra da 
bir kez gider. Modül, yeni bir istek 
aldığında işlemi yeniden başlatmayı 
dener ve uygulamanın son geçen 
dakikada rapidFailsPerMinute kez 
başlayamadığı sürece sonraki gelen 
isteklerde işlemi yeniden başlatmayı 
dener. 


Varsayılan: 120 


Min: 

0 


En fazla: 

3600 


0 (sıfır) değeri sonsuz bir zaman 
aşımı olarak kabul edilmez . 












OZNITELIK 


AÇIKLAMA 


VARSAYILAN 


stdoutLogEnabled 


İsteğe bağlı Boolean özniteliği. 

True ise, processPath içinde 
belirtilen işlem için stdout ve stderr 
, stdoutLogFileiçinde belirtilen 
dosyaya yeniden yönlendirilir. 


f alse 


stdoutLogFile isteğe bağlı dize Özniteliği. aspnetcore-stdout 

ProcessPath içinde belirtilen 
işlemden stdout ve stderr 'in 
günlüğe kaydedildiği göreli veya 
mutlak dosya yolunu belirtir. Göreli 
yollar, sitenin köküne göredir. . 
başlayan tüm yollar site köküne 
göredir ve diğer tüm yollar mutlak 
yollar olarak değerlendirilir. Yolda 
sunulan klasörler, günlük dosyası 
oluşturulduğunda modül tarafından 
oluşturulur. Alt çizgi sınırlayıcılarını 
kullanma, bir zaman damgası, işlem 
KİMLİĞİ ve dosya uzantısı (. log ) 
stdoutLogFile yolunun son 
kesimine eklenir. . \logs\stdout 
bir değer olarak sağlandıysa, 

2/5/2018 işlem 1934 KİMLİĞİ ile 
19:41:32 ' de tarihinde 
kaydedildiğinde Günlükler 
klasöründe 

stdout_20180205194132_ 1934. 
log dosyasına bir örnek stdout 
günlüğü kaydedilir. 


Ortam değişkenlerini ayarlama 

processPath özniteliğinde işlem için ortam değişkenleri belirtilebilir. Bir <environmentvariabies> koleksiyon 
öğesinin <environmentvariabie> alt öğesiyle bir ortam değişkeni belirtin. Bu bölümde ayarlanan ortam 
değişkenleri, sistem ortamı değişkenlerine göre önceliklidir. 

Aşağıdaki örnek iki ortam değişkenini ayarlar. aspnetcore_environment , uygulamanın ortamını Development olarak 
yapılandırır. Bir geliştirici, uygulama özel durumunda hata ayıklarken Geliştirici özel durum sayfasını yüklemeye 
zorlamak için bu değeri geçici olarak Web. config dosyasında ayarlayabilir. config_dir , geliştiricinin, uygulamanın 
yapılandırma dosyasını yüklemek için bir yol oluşturmak üzere başlangıçta değeri okuyan kodu yazdığı Kullanıcı 
tanımlı ortam değişkenine bir örnektir. 

<aspNetCore processPath="dotnet" 
arguments=". \MyApp.dll" 
stdoutLogEnabled="false" 
stdoutl_ogFile=". \logs\stdout" 
hostingModel="inprocess"> 

<environmentVariables> 

<environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" /> 

<environmentVariable name="CONFIG_DIR" value="f: \application_config" /> 

</environmentVariables> 

</aspNetCore> 












NOTE 

Ortamı doğrudan Web. config içinde ayarlamaya alternatif olarak, <EnvironmentName> özelliği Publish profile (. pubxml) veya 
proje dosyasına dahil edilir. Bu yaklaşım, proje yayımlandığında Web. config içinde ortamı ayarlar: 


<Pr'oper'tyGroup> 

<EnvironmentName>Development</Envir'onmentName> 

</PropertyGroup> 


VVARNING 

Yalnızca aspnetcore_environment ortam değişkenini, Internet gibi güvenilmeyen ağlarla erişilemeyen hazırlama ve test 
sunucularında Development olarak ayarlayın. 


app_offline. htm 

Bir uygulamanın kök dizininde app_offline. htm adlı bir dosya algılanırsa, AS P.N ET Core modülü uygulamayı 
düzgün bir şekilde kapatmaya ve gelen istekleri işlemeyi durdurmaya çalışır. Uygulama, shutdownTimeLimit 1 da 
tanımlanan saniye sayısından sonra hala çalışıyorsa, ASP.NET Core modülü çalışan işlemi de yok eder. 

App_offline. htm dosyası mevcut olsa da ASP.NET Core modülü, istekleri, app_offline. htm dosyasının içeriğini geri 
göndererek yanıtlar. App_offline. htm dosyası kaldırıldığında, sonraki istek uygulamayı başlatır. 

işlem dışı barındırma modeli kullanılırken, açık bir bağlantı varsa uygulama hemen kapanmayabilir.Örneğin, bir 
VVebSocket bağlantısı, uygulamanın kapatılmasını erteleyebilir. 

Başlatma hatası sayfası 

Hem işlem içi hem de işlem dışı barındırma, uygulamayı başlatamadıklarında özel hata sayfaları üretir. 

ASP.NET Core modülü işlem içi veya işlem dışı istek işleyicisini bulamazsa, 500,0-işlem içi/işlem dışı Işleyici 
yükleme hatası durum kodu sayfası görüntülenir. 

ASP.NET Core modülü uygulamayı başlatamadığında işlem içi barındırma için, 500,30-başlatma hatası durum 
kodu sayfası görüntülenir. 

ASP.NET Core modülü arka uç işlemini başlatamadığında veya arka uç işlemi başlatılırsa ancak yapılandırılmış 
bağlantı noktasında dinleyemediğinde, işlem dışı barındırma için 502,5-lşlem hatası durum kodu sayfası 
görüntülenir. 

Bu sayfayı bastırın ve varsayılan MS 5xx durum kodu sayfasına dönmek için disablestartupErrorPage özniteliğini 
kullanın. Özel hata iletilerini yapılandırma hakkında daha fazla bilgi için bkz. http hataları chttpErrors >. 

Günlük oluşturma ve yeniden yönlendirme 

aspNetcore öğesinin stdoutLogEnabied ve stdoutLogFiie öznitelikleri ayarlandıysa AS P.N ET Core modülü stdout 
ve stderr konsol çıkışını diske yönlendirir. stdoutLogFile yolundaki klasörler, günlük dosyası oluşturulduğunda 
modül tarafından oluşturulur. Uygulama havuzunun, günlüklerin yazıldığı konuma yazma erişimi olması gerekir 
(yazma izni sağlamak için us AppPooi\<app_pooi_name> kullanın). 

İşlem geri dönüştürme/yeniden başlatma gerçekleşmediği sürece Günlükler döndürülemez. Bu, günlüklerin 
tükettiği disk alanını sınırlamak için barındırıcının sorumluluğundadır. 

Stdout günlüğünün kullanılması yalnızca MS 'de barındırırken veya Visual Studio İle MS için geliştirme zamanı 















desteğikullanılırken değil, yerel olarak hata ayıklarken ve uygulamayı 11S Express ile çalıştırırken yalnızca uygulama 
başlatma sorunlarını gidermek için önerilir. 

Genel uygulama günlüğü amaçları için stdout günlüğünü kullanmayın. ASP.NET Core uygulamasında rutin günlük 
kaydı için, günlük dosyası boyutunu sınırlayan ve günlükleri döndüren bir günlüğe kaydetme kitaplığı kullanın. 
Daha fazla bilgi için bkz. üçüncü taraf günlüğü sağlayıcıları. 

Günlük dosyası oluşturulduğunda zaman damgası ve dosya uzantısı otomatik olarak eklenir.Günlük dosyası adı, alt 
çizgi ile ayrılmış stdoutLogFile yolunun (genellikle stdout ) son kesimine zaman damgası, işlem kimliği ve dosya 
uzantısı (. log) eklenerek oluşur. stdoutLogFile yolu stdout\\e sonlanıyorsa, 1934 ' de 19:42:32 2/5/2018 1 de 
oluşturulan PID 'sine sahip bir uygulama için bir günlük dosyası stdout_20180205194132_1934. log dosya adına 
sahiptir. 

stdoutLogEnabled false ise, uygulama başlangıcında oluşan hatalar yakalanır ve 30 KB 'a kadar olay günlüğüne 
yayınlanır. Başlangıçtan sonra tüm ek Günlükler atılır. 

Aşağıdaki örnek aspNetcore öğesi, bir göreli yol .\iog\ stdout günlüğünü yapılandırır. AppPool Kullanıcı 
kimliğinin, belirtilen yola yazma izni olduğunu doğrulayın. 

<aspNetCore processPath="dotnet" 
arguments=". \HyApp.dll" 
stdoutLogEnabled="true" 
stdoutLogFile=". \logs\stdout" 
hostingModel="inprocess"> 

</aspNetCore> 

Azure App Service dağıtım için bir uygulama yayımlarken, Web SDK stdoutLogFile değerini 
\\?\%home%\LogFiies\stdout olarak ayarlar. %home ortam değişkeni, Azure App Service tarafından barındırılan 
uygulamalar için önceden tanımlanmıştır. 

Yol biçimleri hakkında daha fazla bilgi için bkz. VVİndovvs sistemlerinde dosya yolu biçimleri. 

Gelişmiş tanılama günlükleri 

ASP.NET Core modülü, gelişmiş tanılama günlükleri sağlamak için yapılandırılabilir. <handierSettings> öğesini 
Web. con/igiçindeki <aspNetcore> öğesine ekleyin. debugLevel trace olarak ayarlamak, tanılama bilgilerini daha 
yüksek bir şekilde kullanıma sunar: 

<aspNetcore processPath="dotnet" 
arguments=". \MyApp.dll" 
stdoutLogEnabled="false" 
stdoutLogFile="\\?\%home%\LogFiles\stdout" 
hostingModel="inprocess"> 

<handlerSettings> 

<handlerSetting name="debugFile" value=". \logs\aspnetcore-debug. log" /> 

<handlerSetting name="debugLevel" value="FILE,TRACE" /> 

</handlerSettings> 

</aspNetCore> 

<handierSetting> değerine (önceki ömektekiGün/ük/er) belirtilen yoldaki klasörler, otomatik olarak modül 
tarafından oluşturulmaz ve dağıtımda önceden var olmalıdır. Uygulama havuzunun, günlüklerin yazıldığı konuma 
yazma erişimi olması gerekir (yazma izni sağlamak için us AppPooi\<app_pooi_name> kullanın). 

Hata ayıklama düzeyi ( debugLevel ) değerleri hem düzeyi hem de konumu içerebilir. 

Düzeyler (en az ayrıntıdan en fazla ayrıntı sırasına göre): 


• HATAYLA 

















• VVARNING 

• BİLGİSİNE 

• TRACE 


Konumlar (birden çok konuma izin verilir): 

• KONSOLA 

• EVENTLOG 

• DOSYASYNY 

İşleyici ayarları, ortam değişkenleri aracılığıyla da kullanılabilir: 

• hata ayıklama günlük dosyasının - yolunu aspnetcore_module_debug_file . (Varsayılan: aspnetcore-Debug. log) 

• Hata ayıklama düzeyi ayarını - aspnetcore_module_debug . 


VVARNING 

Bir sorunu gidermek için dağıtımda hata ayıklama günlüğü 'nün gerekenden uzun süre etkin bırakmayın. Günlüğün boyutu 
sınırlı değil. Hata ayıklama günlüğünün etkin bırakılması, kullanılabilir disk alanını tüketebilir ve sunucu veya App Service 'i 
kilitlemez. 


Web. config dosyasındaki aspNetcore öğesinin bir örneği için bkz. Web. config ile yapılandırma . 

Proxy yapılandırması HTTP protokolünü ve eşleştirme belirtecini kullanır 

Yalnızca işlem dışı barındırma için geçerlidir. 

ASP.NET Core modülü ve Kestrel arasında oluşturulan ara sunucu HTTP protokolünü kullanır. Modül ve Kestrel 
arasındaki trafiği sunucu dışı bir konumdan bırakırken gizlice dinleme riski yoktur. 

Eşleştirme belirteci, Kestrel tarafından alınan isteklerin MS tarafından proxy aldığından ve başka bir kaynaktan 
gelmediğinden emin olmak için kullanılır. Eşleştirme belirteci oluşturulur ve modül tarafından bir ortam 
değişkenine ( aspnetcore_token ) ayarlanır. Eşleştirme belirteci, her proxy isteğinde de bir üst bilgi ( 
ms-aspnetcore-token ) olarak ayarlanır. MS ara yazılımı, eşleştirme belirteci üstbilgi değerinin ortam değişkeni 
değeriyle eşleşip eşleşmediğini doğrulamak için aldığı her isteği denetler. Belirteç değerleri uyuşmadıysa, istek 
günlüğe kaydedilir ve reddedilir. Eşleştirme belirteci ortam değişkeni ve modülle Kestrel arasındaki trafik, sunucu 
dışında bir konumdan erişilebilir değildir. Eşleştirme belirteç değerini bilmeden, bir saldırgan MS ara yazılımı ’ndaki 
denetimi atlayan istekleri gönderemez. 

IIS paylaşılan yapılandırmasıyla ASP.NET Core modülü 

ASP.NET Core modülü yükleyicisi, Trustedlnstaller hesabının ayrıcalıklarıyla çalışır. Yerel sistem hesabı, MS 
paylaşılan Yapılandırması tarafından kullanılan paylaşım yolu için değiştirme iznine sahip olmadığından, yükleyici, 1 
deki ApplicationHost. config dosyasında modül ayarlarını yapılandırmaya çalışırken bir erişim reddedildi hatası atar, 
paylaşma. 

MS yüklemesiyle aynı makinede bir IIS paylaşılan yapılandırması kullanırken, opt_no_shared_config_check 
parametresi ı olarak ayarlanan AS P.N ET Core barındırma paketi yükleyicisini çalıştırın: 

dotnet-hosting-{VERSION}.exe 0PT_N0_SHARED_C0NFIG_CHECK=1 

Paylaşılan yapılandırmanın yolu IIS yüklemesiyle aynı makinede olmadığında, şu adımları izleyin: 

1. MS paylaşılan yapılandırmasını devre dışı bırakın. 











2. Yükleyiciyi çalıştırın. 

3. Güncelleştirilmiş ApplicationHost. config dosyasını paylaşıma dışarı aktarın. 

4. 11S paylaşılan yapılandırmasını yeniden etkinleştirin. 

Modül sürümü ve barındırma paketi yükleyici günlükleri 

Yüklü ASP.NET Core modülünün sürümünü öğrenmek için: 

1. Barındırma sisteminde %windir%\system32\inetsrv dizinine gidin. 

2. Aspnetcore. dil dosyasını bulun. 

3. Dosyaya sağ tıklayın ve bağlam menüsünden Özellikler ' i seçin. 

4. Ayrıntılar sekmesini seçin. Dosya sürümü ve ürün sürümü , modülün yüklü sürümünü temsil eder. 

Modülün barındırma paketi yükleyici günlükleri, C:\kullcinialar\% username%\AppData\yerel\Tempkor\umur\da 
bulunur. Dosya, dd_DotNetCoreWinSvrHosting__<zaman damgasi > _000_Aspnetcoremodupa_x64. log olarak 
adlandırılmıştır. 

Modül, şema ve yapılandırma dosyası konumları 

Modül 

MS (X86/AMD64): 

• %windir%\System32\inetsrv\aspnetcore.dll 

• %windir%\SysWOW64\inetsrv\aspnetcore.dll 

• %ProgramFiles%\IIS\Asp. Net Core Module\v2\aspnetcorev2,dll 

• % ProgramFiles (x86)% \ ııs\ ASP.NET Core Module\v2\aspnetcorev2,dll 
MS Express (X86/AMD64): 

• %ProgramFiles%\IIS Express\aspnetcore.dll 

• % ProgramFiles (x86)% \ MS Express\aspnetcore.dll 

• %ProgramFiles%\IIS Express\Asp.Net Core Module\v2\aspnetcorev2,dll 

• % ProgramFiles (x86)% \ MS Express\Asp.Net Core Module\v2\aspnetcorev2,dll 

Şema 

ISS 

• %windir%\System32\inetsrv\config\schema\aspnetcore_schema.xml 

• %windir%\System32\inetsrv\config\schema\aspnetcore_schema_v2.xml 

MS Express 

• %ProgramFiles%\IIS Express\config\schema\aspnetcore_schema.xml 

• %ProgramFiles%\IIS Express\config\schema\aspnetcore_schema_v2.xml 

Yapılandırma 

ISS 

• %Windir%\System32\inetsrv\config\application Hoşt, config 


MS Express 



• Visual Studio: {APPLICATION ROOT} \. Vs\config\applicationhost,config 

• usexpress. exe CLI:%USERPROFILE%\Documents\IISExpress\config\applicationhostconfig 
Dosyalar , ApplicationHost. config dosyasında aspnetcore ' u arayarak bulunabilir. 

ASP.NET Core modülü, Web isteklerini arka uca ASP.NET Core uygulamalarına iletmek için 11S ardışık düzenine 
takılan yerel bir MS modülüdür. 

Desteklenen Windows sürümleri: 

• Windows 7 veya üzeri 

• Windows Server 2008 R2 veya üzeri 

Modül yalnızca Kestrel ile birlikte kullanılabilir. Modül, http. sysile uyumsuzdur. 

ASP.NET Core uygulamalar 11S çalışan işleminden ayrı bir işlemde çalıştığından, modül işlem yönetimini de işler. 
Modül, ilk istek ulaştığında ASP.N ET Core App işlemini başlatır ve kilitlenirse uygulamayı yeniden başlatır. Bu 
aslında, VVİndovvs İşlem etkinleştirme hizmeti (vvas)tarafından yönetilen 11S 'de işlem içinde çalışan ASP.NET 4. x 
uygulamaları ile görüldüğü aynı davranıştır. 

Aşağıdaki diyagramda MS, ASP.NET Core modülü ve bir uygulama arasındaki ilişki gösterilmektedir: 



IIS 

ASP.NET Core application 

Internet 

(w3wp.exe) 

(dotnetexe) 

/V HTTp 

ASP.NET Core Modüle HTTP 

Kestrel HttpContext Application code 


GD * 

© * * 03 


http://contoso.com 

httpy/localhost 1234 


İstekler Web 'den çekirdek modu HTTP, sys sürücüsüne ulaşır.Sürücü, istekleri Web sitesinin yapılandırılmış 
bağlantı noktasında IIS 'ye yönlendirir, genellikle 80 (HTTP) veya 443 (HTTPS). Modül, 80 veya 443 numaralı 
bağlantı noktası olmayan uygulama için rastgele bir bağlantı noktasında istekleri Kestrel 'e iletir. 

Modül, başlangıç sırasında bir ortam değişkeni aracılığıyla bağlantı noktasını belirtir ve MS tümleştirme ara 
sunucusu, http://iocaihost:{port} ' i dinlemek için sunucuyu yapılandırır. Ek denetimler gerçekleştirilir ve 
modülünden kaynaklanmayan istekler reddedilir. Modül HTTPS iletmeyi desteklemez, bu nedenle istekler HTTPS 
üzerinden MS tarafından alınsa bile HTTP üzerinden iletilir. 

Kestrel, isteği modülden başlattıktan sonra, istek ASP.NET Core ara yazılım ardışık düzenine gönderilir.Ara yazılım 
ardışık düzeni isteği işler ve uygulamanın mantığına HttpContext örneği olarak geçirir. MS tümleştirmesi tarafından 
eklenen ara yazılım, isteği Kestrel iletmek için düzen, uzak İP ve pathbase 'i hesaba göre güncelleştirir. Uygulamanın 
yanıtı IIS 'e geri geçirilir ve bu, isteği başlatan HTTP istemcisine geri gönderilir. 

VVİndovvs kimlik doğrulaması gibi birçok yerel modül etkin kalir.ASP.NET Core modülüyle etkin MS modülleri 
hakkında daha fazla bilgi için, bkz.ASP.NET Core içeren MS modülleri. 

ASP.NET Core modülü de şunları yapabilir: 

• Çalışan işlem için ortam değişkenlerini ayarlayın. 

• Başlatma sorunlarını gidermek için stdout çıkışını dosya depolama alanına kaydedin. 

• VVİndovvs kimlik doğrulama belirteçlerini ilet. 

ASP.NET Core modülünü yüklemek ve kullanmak 

ASP.NET Core modülünün nasıl yükleneceğine ilişkin yönergeler için bkz. .NET Core barındırma paketi 'Ni 
yüklemek. 


Web. config ile yapılandırma 












ASP.NET Core modülü, sitenin Web. config dosyasındaki system.webserver düğümünün aspNetcore bölümü ile 
yapılandırılır. 


Aşağıdaki Web. config dosyası, çerçeveye bağlı bir dağıtım İçin yayımlanır ve ASP.NET Core modülünü site 
isteklerini işleyecek şekilde yapılandırır: 

<?xml version="1.0" encoding="utf-8"?> 

<configuration> 

<system.webServer> 

<handlers> 

<add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModjle" resourceType="Unspecified" /> 
</handlers> 

<aspNetCore processPath="dotnet" 

arguments=". \MyApp .dil" 
stdoutLogEnabled="false" 
stdoutLogFile=". \logs\stdout" /> 

</system.webServer> 

</configunation> 


Aşağıdaki Web. config , kendinden bağımsız bir dağıtım için yayımlanır: 

<?xml version="1.0" encoding="utf-8"?> 

<configuration> 

<system.webServer> 

<handlers> 

<add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModjle" resourceType="Unspecified" /> 
</handlers> 

<aspNetCone pnocessPath=". \MyApp.exe" 
stdoutLogEnabled="false" 
stdoutLogFile=". \logs\stdout" /> 

</system.webServen> 

</configuration> 

Bir uygulama Azure App S ervicedağıtıIdığında stdoutLogFiie yolu \\?\%home%\LogFiies\stdout olarak ayarlanır. Yol, 
stdout günlüklerini hizmet tarafından otomatik olarak oluşturulan bir konum olan LogFiles klasörüne kaydeder. 

IIS alt uygulama yapılandırması hakkında bilgi için bkz. 11S ile VVİndovvs üzerinde ASP.NET Core barındırma. 

AspNetCore öğesinin öznitelikleri 

ÖZNİTELIK AÇIKLAMA VARSAYILAN 


arguments isteğe bağlı dize özniteliği. 

ProcessPathiçinde belirtilen 
yürütülebilir dosya için bağımsız 
değişkenler. 


disableStartUpErrorPage 


isteğe bağlı Boolean özniteliği. 

Doğru ise, 502,5-lşlem hatası 

sayfası bastırılır ve Web. config 
dosyasında yapılandırılan 502 
durum kodu sayfası önceliklidir. 


f alse 












OZNITELIK 


AÇIKLAMA 


VARSAYILAN 


forwar'dWindowsAuthToken 


processesPerApplication 


pr'ocessPath 


rapidFailsPerMinute 


requestTimeout 


isteğe bağlı Boolean özniteliği. 

True ise belirteç istek başına ' MS- 
ASPNETCORE-VVıNAUTHTOKEN ' 
üst bilgisi olarak% 
ASPNETCORE_PORT% üzerinde 
dinleme yapan alt işleme iletilir. Bu, 
istek başına bu belirteçte 
CloseHandle çağırma işleminin 
sorumluluğundadır. 


isteğe bağlı tamsayı özniteliği. 

ProcessPath ayarında belirtilen 
işlemin örnek sayısını, uygulama 
başına bir şekilde işleyecek şekilde 
belirtir. 

processesPerApplication 
ayarlama önerilmez. Bu öznitelik 
gelecek bir sürümde kaldırılacak. 


Varsayılan: ı 


Min: 

1 


En fazla: 

100 


Gerekli dize özniteliği. 

HTTP isteklerini dinleyen bir işlemi 
başlatan yürütülebilir dosyanın yolu. 
Göreli yollar desteklenir. Yol . ile 
başlıyorsa, yol site köküne göreli 
olarak kabul edilir. 


isteğe bağlı tamsayı özniteliği. 

ProcessPath içinde belirtilen işleme 
dakika başına kilitlenme için izin 
verilen sayıyı belirtir. Bu sınır aşılırsa 
modül, dakika geri kalanı için işlemi 
başlatmayı durduruyor. 


Varsayılan: 10 


Min: 

0 


En fazla: 

100 


isteğe bağlı TimeSpan özniteliği. 

ASP.NET Core modülünün,% 
ASPNETCORE_PORT% üzerinde 
dinleme işleminden yanıt beklediği 
süreyi belirtir. 

ASP.NET Core 2,1 veya üzeri 
sürümü ile birlikte gelen ASP.NET 
Core modülünün sürümlerinde, 
requestTimeout saat, dakika ve 
saniye olarak belirtilir. 


Varsayılan: 00:02:00 
Min: 00:00:00 
En fazla: 360:00:00 













OZNITELIK 


AÇIKLAMA 


VARSAYILAN 


shutdownTime Limit 


isteğe bağlı tamsayı özniteliği. 

App_offline. htm dosyası 
algılandığında, modülün 
yürütülebilir dosyanın düzgün 
şekilde kapatılmasını beklediği 
saniye cinsinden süre. 


Varsayılan: 10 


Min: 

0 


En fazla: 

600 


startupTimeLimit 


isteğe bağlı tamsayı özniteliği. 

Modülün, bağlantı noktasında 
dinleme yapan bir işlemin 
başlamasını bekleyeceği saniye 
cinsinden süre. Bu süre sınırı aşılırsa, 
modül işlemi bu işlemden sonra da 
bir kez gider. Modül, yeni bir istek 
aldığında işlemi yeniden başlatmayı 
dener ve uygulamanın son geçen 
dakikada rapidFailsPerMinute kez 
başlayamadığı sürece sonraki gelen 
isteklerde işlemi yeniden başlatmayı 
dener. 

0 (sıfır) değeri sonsuz bir zaman 
aşımı olarak kabul edilmez . 


Varsayılan: 120 
Min: 0 

En fazla: 3600 


stdoutLogEnabled 


isteğe bağlı Boolean özniteliği. 

True ise, processPath içinde 
belirtilen işlem için stdout ve stderr 
, stdoutLogFileiçinde belirtilen 
dosyaya yeniden yönlendirilir. 


f alse 


stdoutLogFile isteğe bağlı dize özniteliği. aspnetcore-stdout 

ProcessPath içinde belirtilen 
işlemden stdout ve stderr 'in 
günlüğe kaydedildiği göreli veya 
mutlak dosya yolunu belirtir Göreli 
yollar, sitenin köküne göredir . 
başlayan tüm yollar site köküne 
göredir ve diğer tüm yollar mutlak 
yollar olarak değerlendirilir. Modülün 
günlük dosyasını oluşturması için 
yolda sunulan klasörlerin bulunması 
gerekir Alt çizgi sınırlayıcılarını 
kullanma, bir zaman damgası, işlem 
KİMLİĞİ ve dosya uzantısı (. log ) 
stdoutLogFile yolunun son 
kesimine eklenir. . \logs\stdout 
bir değer olarak sağlandıysa, 

2/5/2018 işlem 1934 KİMLİĞİ ile 
19:41:32 ' de tarihinde 
kaydedildiğinde Günlükler 
klasöründe 

stdout_20180205194132_ 1934. 
log dosyasına bir örnek stdout 
günlüğü kaydedilir 













Ortam değişkenlerini ayarlama 

pnocessPath özniteliğinde işlem için ortam değişkenleri belirtilebilir. Bir <environmentvariabies> koleksiyon 
öğesinin <environmentvariabie> alt öğesiyle bir ortam değişkeni belirtin. 


VVARNING 

Bu bölümde ayarlanan ortam değişkenleri, aynı ada sahip sistem ortam değişkenleri ile çakışıyor. Bir ortam değişkeni hem 
Web. config dosyasında hem de VVİndovvs 'un sistem düzeyinde ayarlandıysa, Web. config dosyasındaki değer sistem ortam 
değişkeni değerine (örneğin, aspnetcore_environment: Development; Development ) eklenerek uygulamanın şunlar. 


Aşağıdaki örnek iki ortam değişkenini ayarlar. aspnetcore_environment , uygulamanın ortamını Development olarak 
yapılandırır. Bir geliştirici, uygulama özel durumunda hata ayıklarken Geliştirici özel durum sayfasını yüklemeye 
zorlamak için bu değeri geçici olarak Web. config dosyasında ayarlayabilir. config_dir , geliştiricinin, uygulamanın 
yapılandırma dosyasını yüklemek için bir yol oluşturmak üzere başlangıçta değeri okuyan kodu yazdığı Kullanıcı 
tanımlı ortam değişkenine bir örnektir. 

<aspNetCore processPath="dotnet" 
arguments=". \MyApp.dll" 
stdoutLogEnabled="false" 

stdoutLogFile="\\?\%home%\LogFiles\stdout"> 

<environmentVariables> 

<environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" /> 

<environmentVariable name="CONFIG_DIR" value="f: \application_config" /> 

</environmentVariables> 

</aspNetCore> 


WARNING 

Yalnızca aspnetcore_environment ortam değişkenini, Internet gibi güvenilmeyen ağlarla erişilemeyen hazırlama ve test 
sunucularında Development olarak ayarlayın. 


app_offline. htm 

Bir uygulamanın kök dizininde app_offline. htm adlı bir dosya algılanırsa, AS P.N ET Core modülü uygulamayı 
düzgün bir şekilde kapatmaya ve gelen istekleri işlemeyi durdurmaya çalışır. Uygulama, shutdownTimeLimit 1 da 
tanımlanan saniye sayısından sonra hala çalışıyorsa, ASP.NET Core modülü çalışan işlemi de yok eder. 

App_offline. htm dosyası mevcut olsa da ASP.NET Core modülü, istekleri, app_offline. htm dosyasının içeriğini geri 
göndererek yanıtlar. App_offline. htm dosyası kaldırıldığında, sonraki istek uygulamayı başlatır. 

Başlatma hatası sayfası 

ASP.NET Core modülü arka uç işlemini başlatamaz veya arka uç işlemi başlatılır, ancak yapılandırılmış bağlantı 
noktasında dinleme başarısız olursa, 502,5-lşlem hatası durum kodu sayfası görüntülenir. Bu sayfayı bastırın ve 
varsayılan 11S 502 durum kodu sayfasına dönmek için disablestartupErrorPage özniteliğini kullanın. Özel hata 
iletilerini yapılandırma hakkında daha fazla bilgi için bkz. http hataları <httpErrors >. 















B IIS 502.5 Error X + 


□ X 

O (üt localhost:90C 

☆ 

- m & - 

HTTP Error 502.5 - Process Failure 




Commoıı causes of this issue: 

• The application process failed to start 

• The application process started but then stopped 

• The application process started but failed to listen on the configured port 


Troubleshooting steps: 

• Check the system event log for error messages 

• Enable logging the application process’ stdout messages 

• Attach a debugger to the application process and inspect 


For more information visit: http://go.microsoft.com/fwlink./?LinkID=808681 


Günlük oluşturma ve yeniden yönlendirme 

aspNetcore öğesinin stdoutLogEnabled ve stdoutLogFiie öznitelikleri ayarlandıysa AS P.N ET Core modülü stdout 
ve stderr konsol çıkışını diske yönlendirir. stdoutLogFile yolundaki klasörler, günlük dosyası oluşturulduğunda 
modül tarafından oluşturulur. Uygulama havuzunun, günlüklerin yazıldığı konuma yazma erişimi olması gerekir 
(yazma izni sağlamak için us AppPooi\<app_pooi_name> kullanın). 

işlem geri dönüştürme/yeniden başlatma gerçekleşmediği sürece Günlükler döndürülemez. Bu, günlüklerin 
tükettiği disk alanını sınırlamak için barındırıcının sorumluluğundadır. 

Stdout günlüğünün kullanılması yalnızca MS 'de barındırırken veya Visual Studio İle 11S için geliştirme zamanı 
desteğiku İlamlırken değil, yerel olarak hata ayıklarken ve uygulamayı 11S Express ile çalıştırırken yalnızca uygulama 
başlatma sorunlarını gidermek için önerilir. 

Genel uygulama günlüğü amaçları için stdout günlüğünü kullanmayın. ASP.NET Core uygulamasında rutin günlük 
kaydı için, günlük dosyası boyutunu sınırlayan ve günlükleri döndüren bir günlüğe kaydetme kitaplığı kullanın. 
Daha fazla bilgi için bkz. üçüncü taraf günlüğü sağlayıcıları. 

Günlük dosyası oluşturulduğunda zaman damgası ve dosya uzantısı otomatik olarak eklenir.Günlük dosyası adı, alt 
çizgi ile ayrılmış stdoutLogFile yolunun (genellikle stdout) son kesimine zaman damgası, işlem kimliği ve dosya 
uzantısı (. log) eklenerek oluşur. stdoutLogFile yolu stdout\\e sonlanıyorsa, 1934 ' de 19:42:32 2/5/2018 ' de 
oluşturulan Pl D 'sine sahip bir uygulama için bir günlük dosyası stdout_20180205194132_ 1934. log dosya adına 
sahiptir. 

Aşağıdaki örnek aspNetcore öğesi, bir göreli yol .\iog\ stdout günlüğünü yapılandırır. AppPool Kullanıcı 
kimliğinin, belirtilen yola yazma izni olduğunu doğrulayın. 

<aspNetcore processPath="dotnet" 
arguments=". \MyApp.dll" 
stdoutLogEnabled="true" 
stdoutLogFile=".\logs\stdout"> 

</aspNetCore> 

Azure App Service dağıtım için bir uygulama yayımlarken, Web SDK stdoutLogFile değerini 





















\\?\%home%\LogFiies\stdout olarak ayarlar. %home ortam değişkeni, Azure App Service tarafından barındırılan 
uygulamalar için önceden tanımlanmıştır. 

Günlüğe kaydetme filtresi kuralları oluşturmak için ASP.N ET Core günlük belgelerinin yapılandırma ve günlük 
filtreleme bölümlerine bakın. 

Yol biçimleri hakkında daha fazla bilgi için bkz. VVİndovvs sistemlerinde dosya yolu biçimleri. 

Proxy yapılandırması HTTP protokolünü ve eşleştirme belirtecini kullanır 

ASP.NET Core modülü ve Kestrel arasında oluşturulan ara sunucu HTTP protokolünü kullanır. Modül ve Kestrel 
arasındaki trafiği sunucu dışı bir konumdan bırakırken gizlice dinleme riski yoktur. 

Eşleştirme belirteci, Kestrel tarafından alınan isteklerin IIS tarafından proxy aldığından ve başka bir kaynaktan 
gelmediğinden emin olmak için kullanılır. Eşleştirme belirteci oluşturulur ve modül tarafından bir ortam 
değişkenine ( aspnetcore_token ) ayarlanır. Eşleştirme belirteci, her proxy isteğinde de bir üst bilgi ( 
ms-aspnetcore-token ) olarak ayarlanır.IIS ara yazılımı, eşleştirme belirteci üstbilgi değerinin ortam değişkeni 
değeriyle eşleşip eşleşmediğini doğrulamak için aldığı her isteği denetler. Belirteç değerleri uyuşmadıysa, istek 
günlüğe kaydedilir ve reddedilir. Eşleştirme belirteci ortam değişkeni ve modülle Kestrel arasındaki trafik, sunucu 
dışında bir konumdan erişilebilir değildir. Eşleştirme belirteç değerini bilmeden, bir saldırgan IIS ara yazılımı 'ndaki 
denetimi atlayan istekleri gönderemez. 

IIS paylaşılan yapılandırmasıyla ASP.NET Core modülü 

ASP.NET Core modülü yükleyicisi, Trustedlnstaller hesabının ayrıcalıklarıyla çalışır. Yerel sistem hesabı, IIS 
paylaşılan Yapılandırması tarafından kullanılan paylaşım yolu için değiştirme iznine sahip olmadığından, yükleyici, 1 
deki ApplicationHost. config dosyasında modül ayarlarını yapılandırmaya çalışırken bir erişim reddedildi hatası atar, 
paylaşma. 

IIS paylaşılan yapılandırması kullanırken, şu adımları izleyin: 

1. IIS paylaşılan yapılandırmasını devre dışı bırakın. 

2. Yükleyiciyi çalıştırın. 

3. Güncelleştirilmiş ApplicationHost. config dosyasını paylaşıma dışarı aktarın. 

4. IIS paylaşılan yapılandırmasını yeniden etkinleştirin. 

Modül sürümü ve barındırma paketi yükleyici günlükleri 

Yüklü ASP.NET Core modülünün sürümünü öğrenmek için: 

1. Barındırma sisteminde %windir%\system32\inetsrv dizinine gidin. 

2. Aspnetcore. dil dosyasını bulun. 

3. Dosyaya sağ tıklayın ve bağlam menüsünden Özellikler ' i seçin. 

4. Ayrıntılar sekmesini seçin. Dosya sürümü ve ürün sürümü , modülün yüklü sürümünü temsil eder. 

Modülün barındırma paketi yükleyici günlükleri, C:\kullanialar\% username%\AppData\yerel\Tempkor\umur\da 
bulunur. Dosya, dd_DotNetCoreWinSvrHosting__<zaman damgası > _000_Aspnetcoremodupa_x64. log olarak 
adlandırılmıştır. 

Modül, şema ve yapılandırma dosyası konumları 

Modül 

IIS (X86/AMD64): 


• %windir%\System32\inetsrv\aspnetcore.dll 








• %windir%\SysWOW64\inetsrv\aspnetcore.dll 
MS Express (X86/AMD64): 

• %ProgramFiles%\IIS Express\aspnetcore.dll 

• % ProgramFiles (x86)% \ MS Express\aspnetcore.dll 

Şema 

ISS 

• %windir%\System32\inetsrv\config\schema\aspnetcore_schema.xml 

MS Express 

• %ProgramFiles%\IIS Express\config\schema\aspnetcore_schema.xml 

Yapılandırma 

ISS 

• %Windir%\System32\inetsrv\config\applicationPlost,config 

MS Express 

• Visual Studio: {APPLICATION ROOT} \. Vs\config\applicationhost,config 

• usexpress. exe CLI:%USERPROFILE%\Documents\IISExpress\config\applicationhost.config 
Dosyalar , ApplicationHost. config dosyasında aspnetcore ' u arayarak bulunabilir. 

Ek kaynaklar 

• 11S ile Windows üzerinde ASP.NET Core barındırma 

• ASP.NET Core Modüle GitHub deposu (başvuru kaynağı) 

• ASP.NET Core içeren MS modülleri 


Azure App Service ve MS 'de ASPNET Core 
sorunlarını giderme 
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, Luke Latham ve, kotalik tarafından 

Bu makalede, bir uygulama Azure App Service veya 11S 'ye dağıtıldığında hataların nasıl tanılanacağı hakkında 
genel uygulama başlatma hataları ve yönergeleri hakkında bilgi verilmektedir: 

Uygulama başlatma hataları 

Ortak Başlangıç HTTP durum kodu senaryolarını açıklar. 

Azure App Service sorunlarını giderme 

Azure App Service dağıtılan uygulamalar için sorun giderme önerisi sağlar. 

11S üzerinde sorun giderme 

IIS 'ye dağıtılan veya 11S Express yerel olarak çalışan uygulamalar için sorun giderme önerisi sağlar.Bu kılavuz hem 
Windows Server hem de Windows masaüstü dağıtımları için geçerlidir. 

Paket önbelleklerini temizle 

Önemli güncelleştirmeler gerçekleştirirken veya paket sürümlerini değiştirirken ne yapmanız gerektiğini açıklar. 

Ek kaynaklar 

Ek sorun giderme konularını listeler. 

Uygulama başlatma hataları 

Visual Studio 'da bir ASP.NET Core projesi, hata ayıklama sırasında IIS Express barındırmak için varsayılan 
değerdir. 502,5-lşlem hatasL veya yerel olarak hata ayıklarken oluşan 500,30-başlatma hatası , bu konudaki öneri 
kullanılarak tamlanabilir. 

Visual Studio 'da bir ASP.NET Core projesi, hata ayıklama sırasında IIS Express barındırmak için varsayılan 
değerdir. Yerel olarak hata ayıklamada oluşan 502,5 İşlem hatası , bu konudaki öneri kullanılarak tamlanabilir. 

403,14 yasak 

Uygulama başlatılamıyor.Aşağıdaki hata günlüğe kaydedilir: 

The Web server is configured to not list the contents of this directory. 

Hata genellikle barındırma sisteminde, aşağıdaki senaryolardan birini içeren bozuk bir dağıtım nedeniyle oluşur: 

• Uygulama, barındırma sisteminde yanlış klasöre dağıtılır. 

• Dağıtım işlemi, uygulamanın tüm dosyalarını ve klasörlerini barındırma sistemindeki dağıtım klasörüne 
taşıyamadı. 

• W eh. config dosyası dağıtımda yok veya Web. config dosyası içerikleri hatalı biçimlendirilmiş. 

Aşağıdaki adımları uygulayın: 

1. Tüm dosya ve klasörleri barındırma sistemindeki dağıtım klasöründen silin. 

2. Visual Studio, PovverShell veya el ile dağıtım gibi normal dağıtım yönteminizi kullanarak, uygulamanın 
Yayımlama klasörünün içeriğini barındırma sistemine yeniden dağıtın: 

• Web. config dosyasının dağıtımda mevcut olduğunu ve içeriğinin doğru olduğunu doğrulayın. 





• Azure App Service barındırırken, uygulamanın D:\home\site\wwwroot klasörüne dağıtıldığını doğrulayın. 

• Uygulama 11S tarafından barındırıliyorsa, uygulamanın 11S yöneticisinin temel ayarlarındagösterilen 
11S fiziksel yoluna dağıtıldığını doğrulayın. 

3. Barındırma sistemindeki dağıtımı projenin Yayımla klasörünün içeriğiyle karşılaştırarak uygulamanın tüm dosya 
ve klasörlerinin dağıtıldığını doğrulayın. 

Yayımlanan ASP.NET Core uygulamasının düzeni hakkında daha fazla bilgi için bkz. ASP.NET Core dizin yapısı. 

W eh. config dosyası hakkında daha fazla bilgi için bkz. AS P.N ET Core Modülü. 

500 İç sunucu hatası 

Uygulamayı başlatır, ancak bir hata sunucu isteği yerine getirmesini önler. 

Bu hata, başlatma sırasında veya bir yanıt oluşturulurken uygulamanın kod içinde oluşur. Yanıtta içerik yok olabilir 
veya Yanıt, tarayıcıda 500 İç sunucu hatası olarak görünebilir. Uygulama olay günlüğü, genellikle uygulama normal 
şekilde çalışmaya belirtir. Sunucunun açısından bakıldığında, doğru olmasıdır.Uygulama başladı, ancak geçerli bir 
yanıt oluşturulamıyor. Uygulamayı sunucuda bir komut isteminde çalıştırın veya sorunu gidermek için ASP.N ET 
Core modülü stdout günlüğünü etkinleştirin. 

500.0 işlem içi işleyici yükleme hatası 

Çalışan işlemi başarısız olur. Uygulama başlamaz. 

ASP.NET Core modülü .NET Core CLR 'yi bulamıyor ve işlem içi istek işleyicisini (aspnetcorev2Jnprocess. dil) 
bulamıyor. Kontrol edin: 

• Uygulama Microsoft. AspNetCore. Server. MS NuGet paketini ya da Microsoft. Aspnetcore. app metapackage'i 
hedefler. 

• AS P.N ET Core paylaşılan framevvork'ün hedefliyorsa hedef makinede yüklü sürümü. 

500.0 giden işlem işleyicisi yükleme hatası 

Çalışan işlemi başarısız olur. Uygulama başlamaz. 

AS P.N ET Core modülü işlem dışı barındırma isteği işleyicisini bulamıyor. Aspnetcorev2_outofprocess. dil' nin 
aspnetcorev2. dil' nin yanındaki bir alt klasörde bulunduğundan emin olun. 

500.0 işlem içi işleyici yükleme hatası 

Çalışan işlemi başarısız olur. Uygulama başlamaz. 

ASP.NET Core Modüle bileşenleri yüklenirken bilinmeyen bir hata oluştu. Aşağıdaki eylemlerden birini 
gerçekleştirin: 

• Microsoft desteğ iletişim kurun (Geliştirici Araçları ve ASP.NET Core 1 i seçin). 

• Stack Overflovv soru sorun. 

• GitHub deponuzdabir sorun yapın. 

500.30 işlemdeki başlatma hatası 

Çalışan işlemi başarısız olur. Uygulama başlamaz. 

ASP.NET Core modülü .NET Core CLR 'yi işlem içi başlatmaya çalışır, ancak başlatılamıyor.İşlem başlatma 
hatasının nedeni genellikle uygulama olay günlüğündeki girişlerden ve ASP.NET Core modülü stdout günlüğünde 
belirlenebilir. 

Ortak bir hata durumu, uygulamanın mevcut olmayan AS P.N ET Core paylaşılan framevvork sürümü hedefleme 
nedeniyle yanlış yapılandırılmış ' dir. Hangi sürümlerinin bir ASP.NET Core paylaşılan çerçeve hedef makinede 
yüklü olduğunu denetleyin. 

500.31 ANCM yerel bağımlılıklar bulunamadı 



Çalışan işlemi başarısız olur. Uygulama başlamaz. 

ASP.NET Core modülü , .NET Core çalışma zamanını işlem içinde başlatmaya çalışır, ancak başlatılamıyor.Bu 
başlatma hatasının en yaygın nedeni, Microsoft.NETCore.App veya Microsoft.AspNetcore.App çalışma zamanının 
yüklenmemesine neden olur. Uygulama, hedef AS P.N ET Core 3,0 1 ye dağıtılmışsa ve bu sürüm makinede yoksa, bu 
hata oluşur. Örnek bir hata iletisi aşağıda verilmiştir: 

The specified framework 'Microsoft.NETCore.App', version '3.0.0' was not found. 

- The following frameworks were found: 

2.2.1 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App] 

3.0.0-preview5-27626-15 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App] 
3.0.0-preview6-27713-13 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App] 
3.0.0-preview6-27714-15 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App] 
3.0.0-preview6-27723-08 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App] 


Hata iletisi, yüklü tüm .N ET Core sürümlerini ve uygulama tarafından istenen sürümü listeler. Bu hatayı onarmak 
için aşağıdakilerden birini yapın: 

• Uygun .NET Core sürümünü makineye yükler. 

• Uygulamayı, makinede bulunan .NET Core 'un bir sürümünü hedefleyecek şekilde değiştirin. 

• Uygulamayı kendi kendine kapsanan bir dağıtımolarak yayımlayın. 

Geliştirme aşamasında çalışırken ( aspnetcore_environment ortam değişkeni Development olarak ayarlandığında), 
HTTP yanıtına belirli bir hata yazılır, işlem başlatma hatasının nedeni uygulama olay günlüğünde de bulunur. 

500.32 ANCM dil yüklenemedi 

Çalışan işlemi başarısız olur. Uygulama başlamaz. 

Bu hatanın en yaygın nedeni, uygulamanın uyumsuz bir işlemci mimarisi için yayımlanmakta olması olabilir.Çalışan 
işlemi 32 bitlik bir uygulama olarak çalışıyorsa ve uygulama 64 bit hedef için yayımlandıysa, bu hata oluşur. 

Bu hatayı onarmak için aşağıdakilerden birini yapın: 

• Çalışan işlemle aynı işlemci mimarisi için uygulamayı yeniden yayımlayın. 

• Uygulamayı çerçeveye bağlı bir dağıtımolarak yayımlayın. 

500.33 ANCM İstek Işleyicisi yükleme hatası 

Çalışan işlemi başarısız olur. Uygulama başlamaz. 

Uygulama Microsoft.AspNetcore.App çerçevesine başvurmadı. Yalnızca Microsoft.AspNetcore.App çerçevesini 
hedefleyen uygulamalar AS P.N ET Core modülütarafından barındırılabilir. 

Bu hatayı düzeltemedi, uygulamanın Microsoft.AspNetcore.App çerçevesini hedeflediğinden emin olun. 
Uygulamanın hedeflediği çerçeveyi doğrulamak için .runtimeconfig. json denetleyin. 

500.34 ANCM karışık barındırma modelleri desteklenmez 

Çalışan işlem, aynı işlemde hem işlem içi uygulama hem de işlem dışı bir uygulama çalıştırılamaz. 

Bu hatayı onarmak için uygulamaları ayrı 11S uygulama havuzlarında çalıştırın. 

500.35 ANCM birden çok işlem İçi uygulama aynı İşlemde 

Çalışan işlemi aynı işlemde birden çok işlem içi uygulama çalıştıramıyor. 

Bu hatayı onarmak için uygulamaları ayrı 11S uygulama havuzlarında çalıştırın. 

500.36 ANCM İşlem dışı Işleyici yükleme hatası 

işlem dışı istek işleyicisi, aspnetcorev2_outofprocess. dil, aspnetcorev2. dil dosyasının yanında değildir. Bu, ASP.NET 
Core modülününbozuk bir yüklemesini gösterir. 











Bu hatayı gidermek için .NET Core barındırma paketi (US için) veya Visual Studio (IIS Express için) yüklemesini 
onarın. 

500,37 ANCM başlangıç zamanı sınırı İçinde başlatılamadı 

ANCM, kısımları başlangıç süresi sınırı içinde başlatılamadı. Varsayılan olarak, zaman aşımı 120 saniyedir. 

Aynı makinede çok sayıda uygulama başlatılırken bu hata oluşabilir.Başlangıç sırasında sunucuda CPU/bellek 
kullanımı artışlarını denetleyin. Birden çok uygulamanın başlatma işlemini şaşırtmayı yapmanız gerekebilir. 

502.5 işlem hatası 

Çalışan işlemi başarısız olur. Uygulama başlamaz. 

ASP.NET Core modülü çalışan işlemini başlatmaya çalışır, ancak başlatılamıyor. işlem başlatma hatasının nedeni 
genellikle uygulama olay günlüğündeki girişlerden ve ASP.NET Core modülü stdout günlüğünde belirlenebilir. 

Ortak bir hata durumu, uygulamanın mevcut olmayan AS P.N ET Core paylaşılan framevvork sürümü hedefleme 
nedeniyle yanlış yapılandırılmış ' dir. Hangi sürümlerinin bir ASP.NET Core paylaşılan çerçeve hedef makinede 
yüklü olduğunu denetleyin. Paylaşdan çerçeve , makinede yüklü olan ve Microsoft.AspNetCore.App gibi bir 
metapackage tarafından başvurulan derleme (. dil dosyaları) kümesidir. Metapackage başvurusu, gerekli en düşük 
sürümü belirtebilir. Daha fazla bilgi için bkz. paylaşılan çerçeve. 

Bir barındırma veya uygulamanın yanlış yapılandırılması, çalışan işleminin başarısız olmasına neden olduğunda, 

502.5 İşlem hata hatası sayfası döndürülür: 

Uygulama (hata kodu: '0x800700c1') başlatılamadı. 

EventlD: 1010 

Source: IIS AspNetCore Modüle V2 

Failed to start application '/LM/W3SVC/6/R00T/', ErrorCode '0x800700cl'. 

Uygulamanın derlemesi (. dil) yüklenemediğinden uygulama başlatılamadı. 

W3wp/ıısexpress işlemi ile yayımlanan uygulama arasındaki bir bit genişliği uyuşmazlığı olduğunda bu hata oluşur. 
Uygulama havuzunun 32-bit ayarının doğru olduğundan emin olun: 

1. IIS yöneticisinin uygulama havuzlarındauygulama havuzunu seçin. 

2. Eylemler panelinde uygulama havuzunu Düzenle altında Gelişmiş ayarlar ' ı seçin. 

3. Enable 32 bit uygulamalarmıayarla: 

• 32-bit (x86) bir uygulama dağıtıyorsanız, değeri True olarak ayarlayın. 

• 64 bit (x64) uygulaması dağıtıyorsanız, değeri Faise olarak ayarlayın. 

Proje dosyasındaki <Piatform> MSBuild özelliği ile uygulamanın yayınlanan bit durumuyla ilgili bir çakışma 
olmadığını doğrulayın. 

Bağlantı sıfırlama 

Üstbilgiler gönderildikten sonra bir hata oluşursa, bir hata oluştuğunda sunucunun 500 İç sunucu hatası 
gönderebilmesi için çok geç olur. Bu durum, genellikle bir yanıt için karmaşık nesne serileştirme sırasında bir hata 
oluştuğunda gerçekleşir. Bu tür bir hata, istemcide bir bağlanti sıfirlama hatası olarak görüntülenir. Uygulama 
günlüğü bu tür hataların giderilmesine yardımcı olabilir. 

Varsayılan başlangıç sınırları 

AS P.N ET Core modülü varsayılan bir StartupTimeLlmlt 120 saniye ile yapılandırılır. Varsayılan değer olarak sol 
uygulama modülü bir işlem hatası oturum önce başlatmak için iki dakika sürebilir. Modülü yapılandırma hakkında 
daha fazla bilgi için bkz. aspNetCore öğesinin öznitelikleri. 






Azure App Service sorunlarını giderme 


IMPORTANT 

Azure App Service ile Önizleme sürümlerini ASP.NET Core 

ASP.NET Core önizleme sürümleri varsayılan olarak Azure App Service dağıtılır. ASP.NET Core Previevv sürümü kullanan bir 
uygulamayı barındırmak için, bkz. Azure App Service için ASP.NET Core Previevv sürümünü dağıtma. 


Uygulama olay günlüğü (Azure App Service) 

Uygulama olay günlüğüne erişmek için Azure portal sorunları Tanıla ve çöz dikey penceresini kullanın: 

1. Azure portal uygulama Hizmetleri' nde uygulamayı açın. 

2. Tanıla ve sorunları çöz ' ü seçin. 

3. Tanılama araçları başlığını seçin. 

4. Destek Araçları' nın altında, uygulama olayları düğmesini seçin. 

5. Kaynak sütununda IIS AspNetCoreModule veya IIS Aspnetcoremodule v2 girişi tarafından belirtilen en son 
hatayı inceleyin. 

Sorunları Tanıla ve çöz dikey penceresini kullanmanın bir alternatifi, uygulama olay günlüğü dosyasını doğrudan 
kudukullanarak incelemektir: 

1 . Gelişmiş araçları geliştirme araçları alanında açın. Git-> düğmesini seçin. Kudu konsolu yeni bir tarayıcı 
sekmesi veya penceresinde açılır. 

2. Sayfanın üst kısmındaki gezinti çubuğunu kullanarak hata ayıklama konsolu 'nu açın ve cmd' yi seçin. 

3. LogFiles klasörünü açın. 

4. EverıtLog. xml dosyasının yanındaki kurşun kalem simgesini seçin. 

5. Günlüğü inceleyin. En son olayları görmek için günlüğün en altına gidin. 

Uygulamayı kudu konsolunda çalıştırma 

Başlatma hataları birçok yararlı bilgiler uygulama olay günlüğü'ndeki üretmediği. Bu hatayı saptamak için, 
uygulamayı kudu uzaktan yürütme konsolu 'nda çalıştırabilirsiniz: 

1 . Gelişmiş araçları geliştirme araçları alanında açın. Git^ düğmesini seçin. Kudu konsolu yeni bir tarayıcı 
sekmesi veya penceresinde açılır. 

2. Sayfanın üst kısmındaki gezinti çubuğunu kullanarak hata ayıklama konsolu 'nu açın ve cmd' yi seçin. 

32 bit (x86) uygulamayı test etme 
Geçerli yayın 

1. cd d:\home\site\wwwroot 

2. Uygulamayı çalıştırın: 

• Uygulama, çerçeveye bağımlı bir dağıtımise: 

dotnet .\{ASSEMBLY NAME}.dil 

• Uygulama, kendinden bağımsız bir dağıtımise: 

{ASSEMBLY NAME}.exe 

Uygulamadan alınan konsol çıktısı, tüm hataları gösteren kudu konsoluna gönderilir. 

Önizleme sürümünde çalışan çerçeveye bağımlı dağıtım 








ASP.NET Core {VERSION} (x86) çalışma zamanı site uzantısının yüklenmesini gerektirir. 

1. cd D:\home\SiteExtensions\AspNetCoreRuntime. {X.Y}.x32 ( {X.Y} çalışma Zamanı Sürümüdür) 

2 . Uygulamayı çalıştırın: dotnet \home\site\wwwroot\{ASSEMBLY NAME}.dil 

Uygulamadan alınan konsol çıktısı, tüm hataları gösteren kudu konsoluna gönderilir. 

64 bit (x64) uygulamayı test etme 
Geçerli yayın 

• Uygulama 64 bit (x64) çerçeveye bağımlı bir dağıtımise: 

1. cd D:\Program Files\dotnet 

2 . Uygulamayı çalıştırın: dotnet \home\site\wwwroot\{ASSEMBLY NAME} . dil 

• Uygulama, kendinden bağımsız bir dağıtımise: 

1. cd D:\home\site\wwwnoot 

2 . Uygulamayı çalıştırın: {assembly NAME}.exe 

Uygulamadan alınan konsol çıktısı, tüm hataları gösteren kudu konsoluna gönderilir. 

Önizleme sürümünde çalışan çerçeveye bağımlı dağıtım 

ASP.NET Core {VERSION} (x64) çalışma zamanı site uzantısını yüklemeyi gerektirir. 

1. cd D:\home\SiteExtensions\AspNetCoreRuntime. {X.Y}.x64 ( {X.Y} çalışma Zamanı Sürümüdür) 

2 . Uygulamayı çalıştırın: dotnet \home\site\wwwroot\{ASSEMBLY NAME}.dil 

Uygulamadan alınan konsol çıktısı, tüm hataları gösteren kudu konsoluna gönderilir. 

ASP.NET Core modülü stdout günlüğü (Azure App Service) 

ASP.NET Core Modüle stdout günlüğü genellikle uygulama olay günlüğünde bulunmayan yararlı hata iletilerini 
kaydeder. Stdout günlükleri görüntülemek ve etkinleştirmek için: 

1. Azure portal sorunları Tanıla ve çöz dikey penceresine gidin. 

2 . Sorun kategorisini seçinaltında Web uygulaması aşağı düğmesini seçin. 

3. Önerilen çözümler ' de stdout günlük yeniden yönlendirmeyi etkinleştirmek > , Web. config dosyasını 
düzenlemek için kudu konsolunu açmaküzere düğmeyi seçin. 

4. Kudu Tanılama konsolunda, dosyaları Wwwroot > yol sitesine açın. Listenin altındaki Web. config dosyasını 
açığa çıkarmak için aşağı kaydırın. 

5. Web. config dosyasının yanındaki kurşun kalem simgesine tıklayın. 

6. StdoutLogEnabled olarak ayarlayın ve stdoutLogFile yolunu true olarak değiştirin: 

\\?\%home%\LogFiles\stdout . 

7. Güncelleştirilmiş Web. config dosyasını kaydetmek için Kaydet ' i seçin. 

8. Uygulamaya bir istek oluşturun. 

9. Azure portal dönün. GELİŞTİRME araçları alanında Gelişmiş Araçlar dikey penceresini seçin. Git-* 
düğmesini seçin. Kudu konsolu yeni bir tarayıcı sekmesi veya penceresinde açılır. 

10. Sayfanın üst kısmındaki gezinti çubuğunu kullanarak hata ayıklama konsolu 'nu açın ve cmd' yi seçin. 

11. LogFiles klasörünü seçin. 

12. Değiştirilen sütunu inceleyin ve son değiştirilme tarihiyle stdout günlüğünü düzenlemek için kalem simgesini 
seçin. 

13. Günlük dosyası açıldığında hata görüntülenir. 

Sorun giderme tamamlandığında stdout günlüğünü devre dışı bırak: 

1. Kudu Tanılama konsolunda, 14/efe. config dosyasını açığa çıkarmak için Wwwroot > yolu sitesine dönün. 
Kalem simgesini seçerek Web. config dosyasını tekrar açın. 












2. faise için stdoutLogEnabled ayarlayın. 

3. Dosyayı kaydetmek için Kaydet 1 i seçin. 

Daha fazla bilgi için bkz. ASP.NET Core Modülü. 


VVARNING 

Uygulama veya sunucu başarısızlığı için hata stdout günlüğünü devre dışı bırakmak için yol açabilir. Günlük dosyası boyutunu 
sınırlama yok veya oluşturulan günlük dosyası sayısı yoktur. Yalnızca uygulama başlatma sorunlarını gidermek için stdout 
günlüğünü kullanın. 

Başlangıçtan sonra ASP.NET Core bir uygulamada genel günlüğe kaydetme için, günlük dosyası boyutunu sınırlayan ve 
günlükleri döndüren bir günlüğe kaydetme kitaplığı kullanın. Daha fazla bilgi için bkz. üçüncü taraf günlüğü sağlayıcıları. 


ASP.NET Core modülü hata ayıklama günlüğü (Azure App Service) 

ASP.NET Core Modüle hata ayıklama günlüğü, ASP.NET Core modülünden daha ayrıntılı günlük kaydı sağlar. 
Stdout günlükleri görüntülemek ve etkinleştirmek için: 

1. Gelişmiş tanılama günlüğünü etkinleştirmek için aşağıdakilerden birini yapın: 

• Uygulamayı gelişmiş tanılama günlüğü için yapılandırmak üzere Gelişmiş tanılama günlükleri 
bölümündeki yönergeleri izleyin. Uygulamayı yeniden dağıtın. 

• Gelişmiş tanılama günlüklerinde gösterilen <handierSettings> kudu konsolunu kullanarak canlı 
uygulamanın Web. config dosyasına ekleyin: 

a. Gelişmiş araçları geliştirme araçları alanında açın. Git^ düğmesini seçin. Kudu konsolu yeni bir 
tarayıcı sekmesi veya penceresinde açılır. 

b. Sayfanın üst kısmındaki gezinti çubuğunu kullanarak hata ayıklama konsolu 'nu açın ve cmd' yi 
seçin. 

c. Dosyaları wwwroot > yol sitesine açın. Web. config dosyasını, kurşun kalem düğmesini seçerek 
düzenleyin. <handierSettings> bölümünü, Gelişmiş tanılama günlüklerindegösterildiği gibi 
ekleyin. Kaydet düğmesini seçin. 

2. Gelişmiş araçları geliştirme araçları alanında açın. Git-> düğmesini seçin. Kudu konsolu yeni bir tarayıcı 
sekmesi veya penceresinde açılır. 

3. Sayfanın üst kısmındaki gezinti çubuğunu kullanarak hata ayıklama konsolu 'nu açın ve cmd' yi seçin. 

4. Dosyaları wwwroot > yol sitesine açın. Aspnetcore-Debug. log dosyası için bir yol sağlamadıysanız dosya 
listede görüntülenir. Bir yol sağladıysanız, günlük dosyasının konumuna gidin. 

5. Dosya adının yanındaki kurşun kalem düğmesiyle günlük dosyasını açın. 

Sorun giderme tamamlandığında hata ayıklama günlüğünü devre dışı bırak: 

Gelişmiş hata ayıklama günlüğünü devre dışı bırakmak için aşağıdakilerden birini yapın: 

• Web. config dosyasından <handierSettings> yerel olarak kaldırın ve uygulamayı yeniden dağıtın. 

• Web. config dosyasını düzenlemek ve <handierSettings> bölümünü kaldırmak İçin kudu konsolunu kullanın. 
Dosyayı kaydedin. 


Daha fazla bilgi için bkz. ASP.NET Core Modülü. 











VVARNING 

Hata ayıklama günlüğünü devre dışı bırakma hatası, uygulama veya sunucu hatasına yol açabilir. Günlük dosyası boyutunda 
sınır yoktur. Yalnızca uygulama başlatma sorunlarını gidermek için hata ayıklama günlüğünü kullanın. 

Başlangıçtan sonra ASP.NET Core bir uygulamada genel günlüğe kaydetme için, günlük dosyası boyutunu sınırlayan ve 
günlükleri döndüren bir günlüğe kaydetme kitaplığı kullanın. Daha fazla bilgi için bkz. üçüncü taraf günlüğü sağlayıcıları. 

Yavaş veya askıda olan uygulama (Azure App Service) 

Bir uygulama bir istek üzerinde yavaş bir şekilde yanıt verdiğinde veya Kilitlenmelerinde, aşağıdaki makalelere 
bakın: 

• Azure App Service 'de yavaş Web uygulaması performans sorunlarını giderme 

• Azure Web uygulamasında aralıklı özel durum sorunları veya performans sorunları için döküm yakalamak üzere 
kilitlenme tamlayıcı site uzantısı 'nı kullanın 

İzleme kanatları 

izleme dikey pencereleri, konusunda daha önce açıklanan yöntemlere alternatif bir sorun giderme deneyimi sağlar. 
Bu kanatlar 500 serisi hataları tanılamak için kullanılabilir. 

ASP.NET Core uzantılarının yüklü olduğunu doğrulayın. Uzantılar yüklü değilse, bunları el ile yükleyebilirsiniz: 

1 . GELİŞTİRME araçları dikey penceresinde Uzantılar dikey penceresini seçin. 

2. ASP.NET Core uzantıları listede görünmelidir. 

3. Uzantılar yüklü değilse, Ekle düğmesini seçin. 

4. Listeden ASP.N ET Core uzantılarını seçin. 

5. Yasal koşulları kabul etmek için Tamam 1 1 seçin. 

6. Uzantı Ekle dikey penceresinde Tamam ' ı seçin. 

7. Bilgilendirici bir açılan ileti, uzantıların başarıyla yüklenip yüklenmediğini gösterir. 

Stdout günlüğü etkinleştirilmemişse, şu adımları izleyin: 

1. Azure portal, GELİŞTİRME araçları alanındaki Gelişmiş Araçlar dikey penceresini seçin. Git-> düğmesini 
seçin. Kudu konsolu yeni bir tarayıcı sekmesi veya penceresinde açılır. 

2. Sayfanın üst kısmındaki gezinti çubuğunu kullanarak hata ayıklama konsolu 'nu açın ve cmd' yi seçin. 

3. Dosya yolu > sitesindeki klasörleri açın ve listenin altındaki Web. config dosyasını açığa çıkarmak için aşağı 
kaydırın. 

4. Web. config dosyasının yanındaki kurşun kalem simgesine tıklayın. 

5. StdoutLogEnabled olarak ayarlayın ve stdoutLogFile yolunu true olarak değiştirin: 

\\?\%home%\LogFiles\stdout . 

6. Güncelleştirilmiş Web. config dosyasını kaydetmek için Kaydet 1 i seçin. 

Tanılama günlüğünü etkinleştirmek için ilerleyin: 

1. Azure portal tanılama günlükleri dikey penceresini seçin. 

2. Uygulama günlüğü (dosya sistemi) ve ayrıntılı hata iletileriiçin bir anahtar seçin . Dikey pencerenin üst 
kısmındaki Kaydet düğmesini seçin. 

3. Başarısız istek izlemeyi, başarısız İstek olayı arabelleğe alma (FREB) günlüğü olarak da bilinen bir şekilde 
eklemek için , başarısız istek izlemeanahtarını seçin. 

4. Portalda tanılama günlükleri dikey penceresinde hemen listelenen günlük akışı dikey penceresini seçin. 

5. Uygulamaya bir istek oluşturun. 

6. Günlük akışı verileri içinde hatanın nedeni belirtilir. 







Sorun giderme tamamlandığında stdout günlüğünü devre dışı bıraktığınızdan emin olun. 

Başarısız istek izleme günlüklerini görüntülemek için (FREB günlükleri): 

1. Azure portal sorunları Tanıla ve çöz dikey penceresine gidin. 

2. Kenar çubuğunun Destek Araçları alanından başarısız istek izleme günlüklerini seçin. 

Azure App Service konusundaki Web uygulamaları için tanılama günlüğünü etkinleştirme ve Azure 'Daki Web 
Apps İçin uygulama performansı SSS bölümündeki başarısız istek izlemeleri bölümüne bakın: daha fazla bilgi için 
nasıl yaparım? başarısız istek izlemeyi açın. 

Daha fazla bilgi için bkz. Azure App Service Web Apps için tanılama günlüğünü etkinleştirme. 


VVARNING 

Uygulama veya sunucu başarısızlığı için hata stdout günlüğünü devre dışı bırakmak için yol açabilir. Günlük dosyası boyutunu 
sınırlama yok veya oluşturulan günlük dosyası sayısı yoktur. 

ASP.NET Core uygulamanızı rutin günlüğü için günlük dosyası boyutunu sınırlar ve günlükleri döndürür bir günlük kitaplığını 
kullanın. Daha fazla bilgi için bkz. üçüncü taraf günlüğü sağlayıcıları. 


IIS 'de sorun giderme 

Uygulama olay günlüğü (IIS) 

Uygulama olay günlüğüne erişemedi: 

1. Başlat menüsünü açın, Olay Görüntüleyicisiaraması yapın ve ardından Olay Görüntüleyicisi uygulamasını 
seçin. 

2. Olay Görüntüleyicisi, Windows günlükleri düğümünü açın. 

3. Uygulama olay günlüğünü açmak için uygulama 1 yı seçin. 

4. Başarısız olan uygulama ile ilişkili hataları arayın. Hataların, kaynak sütununda IIS aspnetcore modülünün veya 
IIS Express aspnetcore modülünün bir değeri vardır. 

Uygulamayı bir komut isteminde aşağıdakini çalıştırın 

Başlatma hataları birçok yararlı bilgiler uygulama olay günlüğü'ndeki üretmediği. Bazı hataların nedeni, barındıran 

sistemde bir komut isteminde uygulamayı çalıştırarak bulabilirsiniz. 

Framevvork bağımlı dağıtım 

Uygulama, çerçeveye bağımlı bir dağıtımise: 

1. Bir komut isteminde, dağıtım klasörüne gidin ve uygulamanın derlemesini DotNet. exe\\e yürüterek uygulamayı 
çalıştırın. Aşağıdaki komutta, <assembly_name >: dotnet .\<assembiy_name>.diı için uygulama derlemesinin 
adını yerine koyun. 

2. Konsol çıkışını herhangi bir hata gösteren uygulamadan konsol penceresine yazılır. 

3. Uygulamaya bir istek yaparken, hataları meydana gelirse, burada Kestrel dinlediği bağlantı noktası ve ana 
bilgisayar için istekte bulunmak. Varsayılan konak ve gönderi kullanarak http://iocaihost:50@0/ bir istek yapın. 
Uygulamayı, normalde Kestrel uç nokta adresindeki yanıt verirse, sorun barındırma yapılandırmasında ve büyük 
olasılıkla daha az uygulama içinde ilgili daha yüksektir. 

Kendi içinde dağıtım 

Uygulama, kendinden bağımsız bir dağıtımise: 

1. Bir komut isteminde dağıtım klasörüne gidin ve uygulamanın yürütülebilir dosyayı çalıştırın. Aşağıdaki komutta, 
<assembly_name >: <assembiy_name>.exe için uygulama derlemesinin adını yerine koyun. 

2. Konsol çıkışını herhangi bir hata gösteren uygulamadan konsol penceresine yazılır. 











3. Uygulamaya bir istek yaparken, hataları meydana gelirse, burada Kestrel dinlediği bağlantı noktası ve ana 
bilgisayar için istekte bulunmak. Varsayılan konak ve gönderi kullanarak http://iocaihost 15000 / bir istek yapın. 
Uygulamayı, normalde Kestrel uç nokta adresindeki yanıt verirse, sorun barındırma yapılandırmasında ve büyük 
olasılıkla daha az uygulama içinde ilgili daha yüksektir. 

ASP.NET Core Modüle stdout günlüğü (IIS) 

Stdout günlükleri görüntülemek ve etkinleştirmek için: 

1. Barındıran sistemde sitenin dağıtım klasörüne gidin. 

2. Günlükler klasörü yoksa, klasörü oluşturun. MSBuild 'in dağıtımdaki Günlükler klasörünü otomatik olarak 
oluşturmak üzere nasıl etkinleştirileceği hakkında yönergeler için, bkz. Dizin yapısı konusu. 

3. Web. config dosyasını düzenleyin. StdoutLogEnabled öğesini true olarak ayarlayın ve stdoutLogFile yolunu 
Günlükler klasörünü işaret etmek üzere değiştirin (örneğin, .\iogs\stdout ). yoldaki stdout günlük dosyası adı 
önekidir. Oturum oluşturulduğunda bir zaman damgası, işlem kimliği ve dosya uzantısı otomatik olarak eklenir. 
Dosya adı ön eki olarak stdout kullanarak, tipik bir günlük dosyası, stdout_20180205184032_5412. log olarak 
adlandırılır. 

4. Uygulama havuzunuzun kimliğinin Günlükler klasörü için yazma izinlerine sahip olduğundan emin olun. 

5. Güncelleştirilmiş Web. config dosyasını kaydedin. 

6. Uygulamaya bir istek oluşturun. 

7. Günlükler klasörüne gidin. Bulun ve en son stdout günlüğü'nü açın. 

8. Hatalar için günlüğü inceleyin. 

Sorun giderme tamamlandığında stdout günlüğünü devre dışı bırak: 

1. Web. config dosyasını düzenleyin. 

2. faise için StdoutLogEnabled ayarlayın. 

3. Dosyayı kaydedin. 

Daha fazla bilgi için bkz. ASP.NET Core Modülü. 


WARNING 

Uygulama veya sunucu başarısızlığı için hata stdout günlüğünü devre dışı bırakmak için yol açabilir. Günlük dosyası boyutunu 
sınırlama yok veya oluşturulan günlük dosyası sayısı yoktur. 

ASP.NET Core uygulamanızı rutin günlüğü için günlük dosyası boyutunu sınırlar ve günlükleri döndürür bir günlük kitaplığını 
kullanın. Daha fazla bilgi için bkz. üçüncü taraf günlüğü sağlayıcıları. 


ASP.NET Core modülü hata ayıklama günlüğü (IIS) 

ASP.NET Core modülü hata ayıklama günlüğünü etkinleştirmek için aşağıdaki işleyici ayarlarını uygulamanın Web. 
config dosyasına ekleyin: 

<aspNetCore ...> 

<handlenSettings> 

<handlenSetting name="debugLevel" value="file" /> 

<handlenSetting name="debugFile" value="c: \temp\ancm. log" /> 

</handlerSettings> 

</aspNetCore> 

Günlüğü için belirtilen yolun var olduğundan ve uygulama havuzu kimliğinin konumuna yazma izinlerine sahip 
olduğunu doğrulayın. 

Daha fazla bilgi için bkz. ASP.NET Core Modülü. 


Geliştirici özel durumu sayfasını etkinleştir 













aspnetcore_environment ortam değişkeni, uygulamayı geliştirme ortamında çalıştırmak için Web. config dosyasına 
eklenebilir. Ortam, ana bilgisayar tasarımcısında useEnvironment tarafından uygulama başlangıcında geçersiz 
kılınmadığı sürece, ortam değişkenini ayarlamak, uygulama çalıştırıldığında Geliştirici özel durum sayfasının 
görünmesine izin verir. 

<aspNetCore processPath="dotnet" 
arguments=". \MyApp.dll" 
stdoutLogEnabled="false" 
stdoutLogFile=". \logs\stdout" 
hostingModel="InProcess"> 

<environmentVariables> 

<environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" /> 

</environmentVariables> 

</aspNetCore> 

<aspNetCore processPath="dotnet" 
arguments=". \MyApp.dll" 
stdoutLogEnabled="false" 
stdoutLogFile=".\logs\stdout"> 

<environmentVariables> 

<environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" /> 

</environmentVariables> 

</aspNetCore> 

aspnetcore_environment için ortam değişkenini ayarlamak yalnızca Internet 'e açık olmayan hazırlama ve test etme 
sunucularında kullanılması önerilir. Sorun giderme işleminden sonra Web. config dosyasından ortam değişkenini 
kaldırın. Web. config 'de ortam değişkenlerini ayarlama hakkında daha fazla bilgi İçin, Aspnetcore 'un 
EnvironmentVariables alt öğesibölümüne bakın. 

Bir uygulamadan veri alın 

Bir uygulama isteklerini yanıtlayabileceği ise, istek, bağlantı ve ek veri terminal satır içi ara yazılımın kullanılması 
uygulamayı edinin. Daha fazla bilgi ve örnek kod için bkz. ASP.NET Core projeleri sorunlarını giderme. 

Yavaş veya askıda olan uygulama (IIS) 

Kilitlenme dökümü , sistem belleğinin bir anlık görüntüsüdür ve uygulama kilitlenmesinin, başlatma hatasının veya 
yavaş uygulamanın nedenini belirlemenize yardımcı olabilir. 

Uygulama kilitleniyor veya bir özel durumla karşılaşırsa 

Windows Hata Bildirimi bir döküm edinin ve çözümleyin (WER): 

1. Kilitlenme döküm dosyalarını c:\dumps tutmak için bir klasör oluşturun. Uygulama havuzunun klasöre 
yazma erişimi olmalıdır. 

2. Enabledökümler PovverShell betiğiniçalıştırın: 

• Uygulama, işlem içi barındırma modelinikullanıyorsa, W3wp. exeiçin betiği çalıştırın: 

.\EnableDumps w3wp.exe c:\dumps 


• Uygulama işlem dışı barındırma modelinikullanıyorsa, DotNet. exeiçin betiği çalıştırın: 

.\EnableDumps dotnet.exe c:\dumps 


3. Uygulamayı kilitlenmenin oluşmasına neden olan koşullar altında çalıştırın. 

4. Kilitlenme gerçekleştirildikten sonra, Disabledökümler PovverShell betiğiniçalıştırın: 






• Uygulama, işlem içi barındırma modelinikullanıyorsa, W3wp. exeiçin betiği çalıştırın: 


. \DisableDumps w3wp.exe 

• Uygulama işlem dışı barındırma modelinikullanıyorsa, DotNet. exeiçin betiği çalıştırın: 

.\DisableDumps dotnet.exe 

Uygulama kilitlenmeleri ve döküm koleksiyonu tamamlandıktan sonra, uygulamanın normal olarak 
sonlandırılmasına izin verilir. PovverShell betiği, WER 'i uygulama başına en fazla beş döküm toplayacak şekilde 
yapılandırır. 


VVARNING 

Kilitlenme dökümleri büyük miktarda disk alanı kaplar (her birine kadar çok gigabayt kadar). 


Uygulama askıda kalıyor, başlatma sırasında başarısız oluyor veya normal şekilde çalışıyor 

Bir uygulama askLda kaldığında (yanıt vermeyi keser ancak kilitlenmez), başlatma sırasında başarısız olur veya 
normal şekilde çalışır. Kullanıcı modu döküm dosyaları: döküm oluşturmak için uygun bir aracı seçmek üzere en iyi 
aracı seçme. 

Dökümü çözümle 

Bir döküm çeşitli yaklaşımlar kullanılarak analiz edilebilir. Daha fazla bilgi için bkz. Kullanıcı modu döküm dosyasını 
çözümleme. 

Paket önbelleklerini temizle 

Bazen, geliştirme makinesindeki .N ET Core SDK yükseltmeden ya da uygulamadaki paket sürümlerini değiştirirken 
çalışan bir uygulama hemen başarısız olur. Bazı durumlarda, ana yükseltme yaparken, bir uygulama tutarsız 
paketleri kesilebilir. Bu sorunların çoğu, bu yönergeleri izleyerek düzeltilebilir: 

1. Bin ve obj klasörlerini silin. 

2 . Bir komut kabuğundan dotnet nuget locals ali --ciear yürüterek paket önbelleklerini temizleyin. 

Paket önbelleklerini Temizleme, NuGet. exe aracı ile de gerçekleştirilebilir ve komut nuget locals ali -ciear 
yürütülebilir. NuGet. exe , Windows masaüstü işletim sistemiyle birlikte paketlenmiş bir yüklemedir ve 
NuGet Web sitesindenayrı olarak alınmalıdır. 

3. Geri yükle ve projeyi yeniden derleyin. 

4. Uygulamayı yeniden dağıtmadan önce sunucusundaki dağıtım klasöründeki tüm dosyaları silin. 

Ek kaynaklar 

• ASP.NET Core projeleri sorunlarını giderme 

• ASP.NET Core ile Azure App Service ve 11S için ortak hatalar başvurusu 

• ASP.NET Core hataları işleme 

• ASP.NET Core Modülü 

Azure belgeleri 

• ASP.NET Core için Application Insights 

• Visual Studio 'Yu kullanarak Azure App Service Web uygulamasının sorunlarını giderme bölümünde uzaktan 
hata ayıklama Web Apps bölümü 










• Azure App Service tanılamada genel bakış 

• Nasıl yapılır: Azure App Service uygulamaları İzleme 

• Visual Studio 'Yu kullanarak Azure App Service bir Web uygulamasının sorunlarını giderme 

• Azure Web uygulamalarınızda "502 hatalı Ağ Geçidi" ve "503 hizmeti kullanılamıyor" HTTP hatalarında sorun 
giderme 

• Azure App Service 'de yavaş Web uygulaması performans sorunlarını giderme 

• Azure 'da Web Apps için uygulama performansı SSS 

• Azure Web uygulaması korumalı alanı (App Service çalışma zamanı yürütme sınırlamaları) 

• Azure Cuma: Azure App Service tanılama ve sorun giderme deneyimi (12 dakikalık video) 

Visual Studio belgeleri 

• Visual Studio 2017 ' de Azure 'da 11S 'de uzaktan hata ayıklama ASP.NET Core 

• Visual Studio 2017 ' de uzak MS bilgisayarında uzaktan hata ayıklama ASP.NET Core 

• Visual Studio kullanarak hata ayıklamayı öğrenin 

Visual Studio Code belgeleri 

• Visual Studio Code ile hata ayıklama 


ASRNET Core ile Azure App Service ve IIS için ortak 
hatalar başvurusu 

23.11.2019 * 26 minutes to read ı Edit Online 


Tarafından Luke Latham 

Bu konuda yaygın hatalar açıklanmakta ve Azure Apps hizmetinde ve IIS 'de ASP.NET Core uygulamalar 
barındırırken belirli hatalar için sorun giderme önerileri sunulmaktadır. 

Genel sorun giderme kılavuzu için bkz. Azure App Service ve IIS 'de ASP.NET Core sorunlarını giderme. 
Aşağıdaki bilgileri toplayın: 

• Tarayıcı davranışı (durum kodu ve hata iletisi) 

• Uygulama olay günlüğü girdileri 

o Azure App Service - Azure App Service ve IIS 'de ASP.NET Core sorunlarını gidermebakın. 
o IIS 

1. Windows menüsünde Başlat ' ı seçin, Olay Görüntüleyicisiyazm ve ENTERtuşuna basın. 

2. Olay Görüntüleyicisi açıldıktan sonra, kenar çubuğundan VVindovvs günlükleri > uygulaması ' 

nı genişletin. 

• ASP.NET Core modülü stdout ve hata ayıklama günlüğü girdileri 

o Azure App Service - Azure App Service ve IIS 'de ASP.NET Core sorunlarını gidermebakın. 
o IIS-ASP.NET Core modülü konusunun günlük oluşturma ve yeniden yönlendirme ve Gelişmiş tanılama 
günlükleri bölümlerindeki yönergeleri izleyin. 

Hata bilgilerini aşağıdaki yaygın hatalarla karşılaştırın. Bir eşleşme bulunursa, sorun giderme talimatını izleyin. 

Bu konudaki hataların listesi ayrıntılı değildir.Burada listelenmeyen bir hatayla karşılaşırsanız, bu konunun en 
altındaki içerik geri bildirim düğmesini kullanarak yeni bir sorun açın ve hatayı yeniden oluşturma hakkında 
ayrıntılı yönergeler kullanın. 


IMPORTANT 

Azure App Service ile Önizleme sürümlerini ASP.NET Core 

ASP.NET Core önizleme sürümleri varsayılan olarak Azure App Service dağıtılır. ASP.NET Core Previevv sürümü kullanan bir 
uygulamayı barındırmak için, bkz. Azure App Service için ASP.NET Core Previevv sürümünü dağıtma. 


İşletim sistemi yükseltmesi 32-bit ASP.NET Core modülünü kaldırdı 

Uygulama günlüğü: C:\windows\system32\inetsrv\aspnetcore.dll modül dil si yüklenemedi. Veriler hatadır. 
Sorun Giderme: 

Bir işletim sistemi yükseltmesi sırasında C:\Windows\SysWOW64\inetsrv dizininde işletim sistemi olmayan 
dosyalar korunmaz. AS P.N ET Core modülü bir işletim sistemi yükseltmesinden önce yüklendiyse ve sonra 
herhangi bir uygulama havuzu bir işletim sistemi yükseltmesinden sonra 32 bit modda çalıştıktan sonra bu sorunla 
karşılaşılmıştır. Bir işletim sistemi yükseltmesinden sonra ASP.NET Core modülünü onarın. Bkz. .NET Core 
barındırma paketi 'Ni yüklemeyi. Yükleyici çalıştırıldığında Onar ' ı seçin. 






Eksik site uzantısı, 32-bit (x86) ve 64-bit (x64) site uzantıları yüklü veya 
yanlış işlem bit genişliği ayarlanmış 

Azure Uygulama Hizmetleri tarafından barındırılan uygulamalar için geçerlidir. 

• Tarayıcı: HTTP hatası 500,0-lşlem İçi Işleyici yükleme hatası 

• Uygulama günlüğü: InProcess istek işleyicisini bulmak için hostfxr çağırma hiçbir yerel bağımlılığı 
bulamamadan başarısız oldu. InProcess istek işleyicisi bulunamadı. Hostfxr çağırmadan yakalanan çıkış: 
herhangi bir uyumlu çerçeve sürümü bulmak mümkün değildi. Belirtilen ' Microsoft. AspNetCore. App 1 
çerçevesi,' {VERSION}-Preview-*' sürümü bulunamadı. '/LM/W3SVC/1416782824/ROOT ' uygulaması 
başlatılamadı, hata kodu ' 0x8000FFFF '. 

• ASP.NET Core modülü stdout günlüğü: Uyumlu bir çerçeve sürümü bulmak mümkün değildi. Belirtilen 1 
Microsoft. AspNetCore. App ' çerçevesi, 1 {VERSION}-Preview-*‘ sürümü bulunamadı. 

• ASP.NET Core modülü hata ayıklama günlüğü: InProcess istek işleyicisini bulmak için hostfxr çağırma 
hiçbir yerel bağımlılığı bulamamadan başarısız oldu. Büyük olasılıkla uygulamanın yanlış yapılandırılmış olduğu 
anlamına gelir, lütfen uygulamanın hedeflediği ve makinede yüklü olduğu Microsoft. NetCore. App ve Microsoft. 
AspNetCore. app sürümlerini denetleyin. Başarısız HRESULT döndürüldü: 0x8000FFFF. InProcess istek işleyicisi 
bulunamadı. Uyumlu bir çerçeve sürümü bulmak mümkün değildi. Belirtilen 1 Microsoft. AspNetCore. App ' 
çerçevesi,' {VERSION}-Preview-*' sürümü bulunamadı. 

Sorun Giderme: 

• Uygulamayı bir önizleme çalışma zamanı üzerinde çal işti rıyorsanız, uygulamanın ve uygulamanın çalışma 
zamanının bit durumuyla eşleşen 32-bit (x86) veya 64 bit (x64) site uzantısını da yükler. Uzantı veya 
birden çok çalışma zamanı sürümünü yüklemeyin. 

o ASP.NET Core {RUNTIME VERSION} (x86) çalışma zamanı 
o ASP.NET Core {RUNTIME VERSION} (x64) çalışma zamanı 

Uygulamayı yeniden başlatın. Uygulamanın yeniden başlatılması için birkaç saniye bekleyin. 

• Uygulamayı bir önizleme çalışma zamanında çalıştırmak ve 32-bit (x86) ve 64 bit (x64) site uzantıları 
yüklüyse, uygulamanın bit durumuyla eşleşmeyen site uzantısını kaldırın. Site uzantısını kaldırdıktan sonra 
uygulamayı yeniden başlatın. Uygulamanın yeniden başlatılması için birkaç saniye bekleyin. 

• Uygulamayı bir önizleme çalışma zamanında çalıştırmak ve site uzantısının bit kullanımı uygulamayla 
eşleşiyorsa, önizleme sitesi uzantısının çalışma zamanı sürümünün uygulamanın çalışma zamanı sürümüyle 
eşleştiğini doğrulayın. 

• Uygulamanın uygulama ayarlarındaki platformunun uygulamanın bit durumuyla eşleştiğinden emin 
olun. 

Daha fazla bilgi için bkz. ASP.NET Core uygulamalarını Azure App Service dağıtma. 

X86 uygulaması dağıtıldı, ancak uygulama havuzu 32-bit uygulamalar 
için etkinleştirilmemiş 

• Tarayıcı: HTTP hatası 500,30-lşlem İçi İşlem başlatma hatası 

• Uygulama günlüğü: 1 {PATH} 1 fiziksel köküne sahip '/LM/VV3SVC/5/ROOT ' uygulaması beklenmeyen 
yönetilen özel duruma ulaştı, özel durum kodu = 1 0xe0434352 '. Daha fazla bilgi için lütfen stderr 
günlüklerine bakın. 1 {PATH} 1 fiziksel köküne sahip '/LM/W3SVC/5/ROOT 1 uygulaması clr ve yönetilen 
uygulamayı yükleyemedi. CLR VVorker iş parçacığından erken çıkıldı 

• ASP.NET Core modülü stdout günlüğü: Günlük dosyası oluşturulur ancak boştur. 


• ASP.NET Core modülü hata ayıklama günlüğü: Başarısız HRESULT döndürüldü: 0x8007023e 

Bu senaryo, kendi içinde bulunan bir uygulama yayımlanırken SDK tarafından yakalanarak yapılır. RID platform 
hedefi ile eşleşmezse SDK bir hata üretir (örneğin, proje dosyasında <piatformTarget>x86</piatformTarget> ile RID 
winl0-x64 ). 

Sorun Giderme: 

X86 çerçevesine bağımlı bir dağıtım ( <PiatformTarget>x86</piatformTarget> ) için 11S uygulama havuzunu 32 bitlik 
uygulamalar için etkinleştirin. 11S Yöneticisi 'nde, uygulama havuzunun Gelişmiş ayarlarını açın ve 32 bitlik 
uygulamaları doğruolarak etkinleştir ayarını yapın. 

Platform RID ile çakışıyor 

• Tarayıcı: HTTP hatası 502,5-lşlem hatası 

• Uygulama günlüğü:' C:{PATH}' fiziksel köküne sahip 1 MACHıNE/WEBROOT/APPHOST/{ASSEMBLY}' 
uygulaması,' 1 "C:{PATH} {ASSEMBLY} komut satırı ile işleme başlatamadı. {exe | dil}ErrorCode = 1 
0x80004005: ff. 

• ASP.NET Core modülü stdout günlüğü: işlenmeyen özel durum: System. BadlmageFormatException:' 
{ASSEMBLY}. dil ' dosyası veya bütünleştirilmiş kodu yüklenemedi. Bir programı hatalı biçimde yükleme 
girişiminde bulunuldu. 

Sorun Giderme: 

• Uygulamanın Kestrel üzerinde yerel olarak çalıştığını doğrulayın, işlem hatası, uygulamanın içindeki bir 
sorunun sonucu olabilir. Daha fazla bilgi için bkz. Azure App Service ve 11S 'de ASP.NET Core sorunlarını 
giderme. 

• Bu özel durum, bir uygulamayı yükseltirken ve daha yeni derlemeler dağıtıldığında bir Azure Apps dağıtımı 
için oluşursa, önceki dağıtımdan tüm dosyaları el ile silin. Kalan uyumsuz derlemeler, yükseltilen bir 
uygulama dağıtıldığında System.BadimageFormatException özel durumuyla sonuçlanabilir. 

URI uç noktası yanlış veya durdurulmuş Web sitesi 

• Tarayıcı: ERR_CONNECTION_REFUSED —veya— bağlantı kurulamıyor 

• Uygulama günlüğü: Giriş yok 

• ASP.NET Core modülü stdout günlüğü: Günlük dosyası oluşturulmaz. 

• ASP.NET Core modülü hata ayıklama günlüğü: Günlük dosyası oluşturulmaz. 

Sorun Giderme: 

• Uygulamanın kullanımda olduğu doğru URI uç noktasını onaylayın. Bağlamaları denetleyin. 

• 11S Web sitesinin durdurulmuş durumda olmadığını doğrulayın. 

CoreVVebEngine veya VV3SVC sunucu özellikleri devre dışı 

İşletim sistemi özel durumu: ASP.NET Core modülünü kullanmak için 11S 7,0 CoreVVebEngine ve W3SVC 
özelliklerinin yüklü olması gerekir. 

Sorun Giderme: 


Uygun rol ve özelliklerin etkinleştirildiğini doğrulayın. Bkz. 11 S yapılandırması. 





Yanlış web sitesi fiziksel yolu veya uygulaması eksik 

• Tarayıcı: 403 Yasak-erişim reddedildi -veya-- 403,14 yasak-Web sunucusu bu dizinin içeriğini listebir 
şekilde yapılandırılmıştır. 

• Uygulama günlüğü: Giriş yok 

• ASP.NET Core modülü stdout günlüğü: Günlük dosyası oluşturulmaz. 

• ASP.NET Core modülü hata ayıklama günlüğü: Günlük dosyası oluşturulmaz. 

Sorun Giderme: 

IIS Web sitesi temel ayarları ve fiziksel uygulama klasörü 1 ne bakın. Uygulamanın 11S Web sitesi fiziksel 
yolundakiklasörde olduğunu doğrulayın. 

Yanlış rol, ASP.NET Core modülü yüklü değil veya yanlış izinler 

• Tarayıcı: 500,19 İç sunucu hatası-sayfanın ilgili yapılandırma verileri geçersiz olduğundan istenen sayfaya 
erişilemiyor. --Veya— Bu sayfa görüntülenemiyor 

• Uygulama günlüğü: Giriş yok 

• ASP.NET Core modülü stdout günlüğü: Günlük dosyası oluşturulmaz. 

• ASP.NET Core modülü hata ayıklama günlüğü: Günlük dosyası oluşturulmaz. 

Sorun Giderme: 

• Doğru rolün etkin olduğunu onaylayın. Bkz. IIS yapılandırması. 

• Programlar & Özellikler veya uygulamalar & özellikleri açın ve VVindovvs Server barındırma nın 

yüklü olduğunu doğrulayın. Yüklü programlar listesinde VVindovvs Server barındırma yoksa, .NET Core 
barındırma paketi ' ni indirip yükleyin. 

Geçerli .NET Core barındırma Paket Yükleyici (doğrudan indirme) 

Daha fazla bilgi için bkz. .NET Core barındırma paketini yüklemeye. 

• Uygulama havuzunun > İşlem modeli > kimliğinin applicationpokaydentity olarak ayarlandığından 
emin olun veya özel kimliğin uygulamanın dağıtım klasörüne erişmek için doğru izinlere sahip olduğundan 
emin olun. 

• ASP.NET Core barındırma paketini kaldırdıysanız ve barındırma paketinin önceki bir sürümünü 
yüklediyseniz ApplicationHost. config dosyası ASP.NET Core modülü için bir bölüm içermez. 

Application Hoşt, config dosyasını % windir%/system32/inetsrv/config konumunda açın ve 

<configurationxconfigSectionsxsectionGroup name="system.webServer"> bölüm grubunu bulun. Bölüm 
grubunda ASP.NET Core modülünün bölümü eksikse, Bölüm öğesini ekleyin: 

<section name="aspNetCore" overrideModeDefault="Allow" /> 

Alternatif olarak, AS P.N ET Core barındıran paketin en son sürümünü de yüklersiniz. En son sürüm, 
desteklenen AS P.N ET Core uygulamalarla geriye dönük olarak uyumludur. 


Hatalı processPath, eksik yol değişkeni, barındırma paketi yüklü değil, 
sistem/IIS yeniden başlatılmadı, VC + + yeniden dağıtılabilir yüklü değil 
veya DotNet. exe erişim ihlali 




• Tarayıcı: HTTP hatası 500,0-lşlem İçi Işleyici yükleme hatası 

• Uygulama günlüğü: ' C:{PATH}' fiziksel köküne sahip 1 MACHıNE/WEBROOT/APPHOST/{ASSEMBLY}' 
uygulaması,' 1 komut satırı ile işlem başlatamadıErrorCode = ' 0x80070002:0. 1 {PATH} 1 uygulaması 
başlatılamadı. 1 {PATH}' konumunda yürütülebilir dosya bulunamadı. '/LM/W3SVC/2/ROOT 1 uygulaması 
başlatılamadı, hata kodu ' 0x8007023e '. 

• ASP.NET Core modülü stdout günlüğü: Günlük dosyası oluşturulmaz. 

• ASP.NET Core modülü hata ayıklama günlüğü: Olay günlüğü:' {PATH}' uygulaması başlatılamadı. 1 
{PATH} 1 konumunda yürütülebilir dosya bulunamadı. Başarısız HRESULT döndürüldü: 0x8007023e 

• Tarayıcı: HTTP hatası 502,5-lşlem hatası 

• Uygulama günlüğü: ' C:{PATH}' fiziksel köküne sahip 1 MACHıNE/WEBROOT/APPHOST/{ASSEMBLY}' 
uygulaması,' ' "{...}" komut satırı ile işlem başlatamadı ', ErrorCode = ' 0x80070002:0. 

• ASP.NET Core modülü stdout günlüğü: Günlük dosyası oluşturulur ancak boştur. 

Sorun Giderme: 

• Uygulamanın Kestrel üzerinde yerel olarak çalıştığını doğrulayın, işlem hatası, uygulamanın içindeki bir 
sorunun sonucu olabilir. Daha fazla bilgi için bkz. Azure App Service ve IIS 'de ASP.NET Core sorunlarını 
giderme. 

• Çerçeveye bağlı bir dağıtım (FDD) veya kendi kendine dahil olan bir dağıtım için . \{assembly}. exe dotnet 
olduğunu doğrulamak için Web. config 'deki <aspNetcore> öğesindeki processPath ÖZNITELIĞINI kontrol 
edin (SCD). 

• FDD için, DotNet. exe ' nin yol ayarları aracılığıyla erişilebilir olmayabilir. C:\Program Files\dotnet\ sistem 
yolu ayarlarında bulunduğunu onaylayın. 

• FDD için, DotNet. exe ' yi uygulama havuzunun Kullanıcı kimliği için erişilebilir olmayabilir.Uygulama 
havuzu Kullanıcı kimliğinin C:\Program Files\dotnet dizinine erişimi olduğunu doğrulayın. C:\Program 
Files\dotnet\/e uygulama dizinlerindeki uygulama havuzu Kullanıcı kimliği için yapılandırılmış reddetme 
kuralı olmadığını doğrulayın. 

• Bir FDD dağıtılmış ve IIS 'nin yeniden başlatılmasına gerek kalmadan .NET Core yüklenmiş olabilir. Bir 
komut isteminden net stop was/y ve ardından net start w3svc ' i yürüterek sunucuyu YENİDEN başlatın ya 
da IIS 'yi yeniden başlatın. 

• Bir FDD, barındırma sistemine .NET Core çalışma zamanı yüklenmeden dağıtılmış olabilir..NET Core çalışma 
zamanı yüklenmemişse, sistemde .N ET Core barındırma paketi yükleyicisini çalıştırın. 

Geçerli .NET Core barındırma Paket Yükleyici (doğrudan indirme) 

Daha fazla bilgi için bkz. .NET Core barındırma paketini yüklemeye. 

Belirli bir çalışma zamanı gerekliyse, .net dovvnload arşivleri ' nden çalışma zamanını indirin ve sisteme 
yükleyin. Bir komut isteminden net stop idi ve ardından net start w3svc ' i yürüterek SİSTEMİ yeniden 
başlatarak veya IIS 'yi yeniden başlatarak yüklemeyi doldurun. 

<aspNetCore > öğesinin bağımsız değişkenleri yanlış 

• Tarayıcı: HTTP hatası 500,0-lşlem İçi Işleyici yükleme hatası 

• Uygulama günlüğü: InProcess istek işleyicisini bulmak için hostfxr çağırma hiçbir yerel bağımlılığı 
bulamamadan başarısız oldu. Büyük olasılıkla uygulamanın yanlış yapılandırılmış olduğu anlamına gelir, 
lütfen uygulamanın hedeflediği ve makinede yüklü olduğu Microsoft. NetCore. App ve Microsoft. 






AspNetCore. app sürümlerini denetleyin. InProcess istek işleyicisi bulunamadı. Hostfxr çağırmadan 
yakalanan çıkış: DotNet SDK komutlarını çalıştırmak mı istediniz? Lütfen 7LM/W3SVC/3/ROOT 1 
uygulaması başlatılamadı, hata kodu 1 0x8000FFFF https://go.microsoft.com/fwlink/? 

Linki D = 798306&cicid = 0x409. 

• ASP.NET Core modülü stdout günlüğü: DotNet SDK komutlarını çalıştırmak mı istediniz? Lütfen ' dan 
DotNet SDK 'Yı yükledikten sonra: https://go.microsoft.com/fwlink/?LinklD = 798306&clcid=0x409 

• ASP.NET Core modülü hata ayıklama günlüğü: InProcess istek işleyicisini bulmak için hostfxr çağırma 
hiçbir yerel bağımlılığı bulamamadan başarısız oldu. Büyük olasılıkla uygulamanın yanlış yapılandırılmış 
olduğu anlamına gelir, lütfen uygulamanın hedeflediği ve makinede yüklü olduğu Microsoft. NetCore. App 
ve Microsoft. AspNetCore. app sürümlerini denetleyin. Başarısız HRESULT döndürüldü: 0x8000FFFF, 
InProcess istek işleyicisi bulamadı. Hostfxr çağırmadan yakalanan çıkış: DotNet SDK komutlarını çalıştırmak 
mı istediniz? Lütfen şu kaynaktan DotNet SDK 'Yı yüklersiniz: https://go.microsoft.com/fwlink/? 

LinklD = 798306&clcid = 0x409 başarısız HRESULT döndürüldü: 0x8000FFFF 

• Tarayıcı: HTTP hatası 502,5-lşlem hatası 

• Uygulama günlüğü: ' C:{PATH)' fiziksel köküne sahip 1 MACHıNE/WEBROOT/APPHOST/{ASSEMBLY}' 
uygulaması'' "DotNet" komut satırı ile işleme başlatılamadı.iASSEMBLY}. dilErrorCode = ' 
0x80004005:80008081. 

• ASP.NET Core modülü stdout günlüğü: Yürütülecek uygulama yok: 1 yolfDERLEMESI). dil' 

Sorun Giderme: 

• Uygulamanın Kestrel üzerinde yerel olarak çalıştığını doğrulayın, işlem hatası, uygulamanın içindeki bir 
sorunun sonucu olabilir. Daha fazla bilgi için bkz. Azure App Service ve 11S 'de ASP.NET Core sorunlarını 
giderme. 

• Framework'e bağımlı bir dağıtım (FDD) için .\{ASSEMBLY}.diı (a) olduğunu doğrulamak üzere Web. config 
içindeki <aspNetcore> öğesindeki argumerıts özniteliğini inceleyin; ya da (b) yok, boş bir dize ( arguments="" 
veya bağımsız bir dağıtım için ( arguments="{ARGUMENT_i} J {argumen^}, ... {argument_x}" ) uygulamanın 
bağımsız değişkenlerinin bir listesi (SCD). 

Eksik .NET Core paylaşılan çerçevesi 

• Tarayıcı: HTTP hatası 500,0-lşlem İçi Işleyici yükleme hatası 

• Uygulama günlüğü: InProcess istek işleyicisini bulmak için hostfxr çağırma hiçbir yerel bağımlılığı 
bulamamadan başarısız oldu. Büyük olasılıkla uygulamanın yanlış yapılandırılmış olduğu anlamına gelir, 
lütfen uygulamanın hedeflediği ve makinede yüklü olduğu Microsoft. NetCore. App ve Microsoft. 
AspNetCore. app sürümlerini denetleyin. InProcess istek işleyicisi bulunamadı. Hostfxr çağırmadan 
yakalanan çıkış: herhangi bir uyumlu çerçeve sürümü bulmak mümkün değildi. Belirtilen 1 Microsoft. 
AspNetCore. App 1 çerçevesi, 1 {VERSION} 1 sürümü bulunamadı. 

'/LM/W3SVC/5/ROOT 1 uygulaması başlatılamadı, hata kodu ' 0x8000FFFF '. 

• ASP.NET Core modülü stdout günlüğü: Uyumlu bir çerçeve sürümü bulmak mümkün değildi. Belirtilen ' 
Microsoft. AspNetCore. App ' çerçevesi,' {VERSION}' sürümü bulunamadı. 

• ASP.NET Core modülü hata ayıklama günlüğü: Başarısız HRESULT döndürüldü: 0x8000FFFF 

Sorun Giderme: 

Çerçeveye bağımlı bir dağıtım (FDD) için, sistemde doğru çalışma zamanının yüklü olduğunu doğrulayın. 




Uygulama havuzu durduruldu 

• Tarayıcı: 503 Hizmet kullanılamıyor 

• Uygulama günlüğü: Giriş yok 

• ASP.NET Core modülü stdout günlüğü: Günlük dosyası oluşturulmaz. 

• ASP.NET Core modülü hata ayıklama günlüğü: Günlük dosyası oluşturulmaz. 

Sorun Giderme: 

Uygulama havuzunun durdurulmuş durumda olmadığını onaylayın. 

Alt uygulama bir <işleyicileri içerir > Bölüm 

• Tarayıcı: HTTP hatası 500,19-lç sunucu hatası 

• Uygulama günlüğü: Giriş yok 

• ASP.NET Core modülü stdout günlüğü: Kök uygulamanın günlük dosyası oluşturulur ve normal işlemi 
gösterir. Alt uygulamanın günlük dosyası oluşturulmaz. 

• ASP.NET Core modülü hata ayıklama günlüğü: Kök uygulamanın günlük dosyası oluşturulur ve normal 
işlemi gösterir. Alt uygulamanın günlük dosyası oluşturulmaz. 

Sorun Giderme: 

Alt uygulamanın Web. corıfig dosyasının <handiers> bir bölüm içermediğinden veya alt uygulamanın üst 
uygulamanın işleyicilerini almadığından emin olun. 

Web. config dosyasının üst uygulamanın <system.webServer> bölümü bir <iocation> öğesinin içine yerleştirilir. 
InheritlnChildApplications özelliği, clocation > öğesi içinde belirtilen ayarların üst uygulamanın bir alt dizininde 
bulunan uygulamalar tarafından devralınmadığını göstermek için faise olarak ayarlanır. Daha fazla bilgi için bkz. 
ASP.NET Core Modülü. 

Alt uygulamanın Web. config dosyasının <handiers> bir bölüm içermediğinden emin olun. 

stdout günlük yolu yanlış 

• Tarayıcı: Uygulama normal olarak yanıt verir. 

• Uygulama günlüğü: C:\Program Files\IIS\Asp.Net Core Module\v2\aspnetcorev2.dll' de stdout yeniden 
yönlendirmesi başlatılamadı. Özel durum iletisi: {PATH} 

\aspnetcoremodulev2\commonlib\fileoutputmanager.cpp: 84 konumunda HRESULT 0x80070005 
döndürüldü. C:\Program Files\IIS\Asp.Net Core Module\v2\aspnetcorev2.dll' de stdout yeniden 
yönlendirmesi durdurulamadı. Özel durum iletisi: HRESULT 0x80070002 {PATH} konumunda döndürüldü. 
{PATH} \ aspnetcorev2_inprocess. dil içinde stdout yeniden yönlendirmesi başlatılamadı. 

• ASP.NET Core modülü stdout günlüğü: Günlük dosyası oluşturulmaz. 

• ASP.NET Core modülü hata ayıklama günlüğü: C:\Program Files\IIS\Asp.Net Core 
Module\v2\aspnetcorev2.dll 1 de stdout yeniden yönlendirmesi başlatılamadı. Özel durum iletisi: {PATH} 
\aspnetcoremodulev2\commonlib\fileoutputmanager.cpp: 84 konumunda HRESULT 0x80070005 
döndürüldü. C:\Program Files\IIS\Asp.Net Core Module\v2\aspnetcorev2.dll' de stdout yeniden 
yönlendirmesi durdurulamadı. Özel durum iletisi: HRESULT 0x80070002 {PATH} konumunda döndürüldü. 
{PATH} \ aspnetcorev2_inprocess. dil içinde stdout yeniden yönlendirmesi başlatılamadı. 

• Uygulama günlüğü: Uyarı: stdoutLogFile \oluşturulamadı?{yol} \ path_doesnt_exist \ stdout_ {İşlem 






KİMLİĞİ} _ {zaman DAMGASı}. günlük, hata kodu =-2147024893. 

• ASP.NET Core modülü stdout günlüğü: Günlük dosyası oluşturulmaz. 

Sorun Giderme: 

• Web. config dosyasının <aspNetcore> öğesinde belirtilen stdoutLogFile yolu yok. Daha fazla bilgi için bkz. 
ASP.NET Core modülü: günlük oluşturma ve yeniden yönlendirme. 

• Uygulama havuzu kullanıcısının stdout günlük yoluna yazma erişimi yok. 

Uygulama yapılandırması genel sorunu 

• Tarayıcı: HTTP hatası 500,0-lşlem İçi Işleyici yükleme hatası —veya— HTTP hatası 500,30-Ancm İşlem İçi 
başlatma hatası 

• Uygulama günlüğü: Değişken 

• ASP.NET Core modülü stdout günlüğü: Günlük dosyası oluşturulur ancak boş veya, uygulamanın noktası 
başarısız olana kadar normal girdilerle oluşturulur. 

• ASP.NET Core modülü hata ayıklama günlüğü: Değişken 

• Tarayıcı: HTTP hatası 502,5-lşlem hatası 

• Uygulama günlüğü: ' C:{PATH} fiziksel köküne sahip 1 MACHıNE/WEBROOT/APPHOST/{ASSEMBLY}' 
uygulaması' ' "C:{PATH}{ASSEMBLY} komut satırı ile oluşturulan işlem oluşturdu. {exe | dil}ancak 
belirtilen ' {PORT}' bağlantı noktasında kilitlenen veya yanıt vermeyen ya da bu bağlantı noktası üzerinde 
dinleme yapamadı, ErrorCode = 1 {ERROR CODE}' 

• ASP.NET Core modülü stdout günlüğü: Günlük dosyası oluşturulur ancak boştur. 

Sorun Giderme: 

Büyük olasılıkla uygulama yapılandırması veya programlama sorunu nedeniyle işlem başlatılamadı. 

Daha fazla bilgi için aşağıdaki konulara bakın: 

• Azure App Service ve MS 'de ASP.NET Core sorunlarını giderme 

• ASP.NET Core projeleri sorunlarını giderme 
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Hoş Geldiniz 

.NET için Azure geliştirme yaşam döngüsü kılavuzuna Hoş Geldiniz! Bu kılavuzda, .NET araçları ve işlemleri 
kullanarak Azure'da geçici bir geliştirme yaşam döngüsü oluşturmanın temel kavramları tanıtır. Bu kılavuzu 
tamamladıktan sonra olgun bir DevOps araç zincirinde avantajlarını yararlanabileceksiniz. 

Bu kılavuz için olan 

Deneyimli bir ASP.NET Core geliştirici (200-300 düzeyi) olmalıdır. Biz, bu bölümde ele alacağız gibi Azure 
hakkında her şeyi bilmeniz gerekmez. Bu kılavuz, ayrıca geliştirme işlemleri daha fazla odaklanan DevOps 
mühendisleri için yararlı olabilir. 














Bu kılavuz, Windows geliştiricileri hedefler.Ancak, Linux ve Macos'ta .NET Core tarafından tam olarak desteklenir. 
Linux/macOS farklar için çağrılar için bu kılavuzu Linux/macOS için uyarlamak üzere izleyin. 

Bu kılavuzda ele alınmamıştır 

Bu kılavuzda, .NET geliştiricileri için bir uçtan uca sürekli dağıtım deneyimi üzerinde odaklanmıştır.Her şey Azure 
için ayrıntılı bir kılavuz değildir ve, kapsamlı bir şekilde .N ET API'leri Azure Hizmetleri için odak değil. Vurgu tüm 
sürekli tümleştirme, dağıtım, izleme ve hata ayıklama 1 dir. Kılavuzu sonuna, sonraki adımlar için öneriler sunulur. 
Öneri, AS P.N ET Core geliştiricileri için yararlı olan bir Azure platform hizmetlerini içerir. 

Bu kılavuzda nedir 

Araçlar ve indirmeler 

Bu kılavuzda kullanılan araçları almayı öğrenin. 

App Service'e dağıtma 

Azure App Service'e bir AS P.N ET Core uygulaması dağıtmak için çeşitli yöntemler hakkında bilgi edinin. 

Sürekli tümleştirme ve dağıtım 

Bir uçtan uca sürekli tümleştirme ve dağıtım çözümü için GitHub, Azure DevOps Services ve Azure ile ASP.NET 
Core uygulamanızı oluşturun. 

İzleme ve hata ayıklama 

izleme, sorun giderme ve uygulamanızı ayarlamak için Azure'nın araçlarını kullanın. 

Sonraki adımlar 

Azure Öğrenme ASP.NET Core Geliştirici diğer öğrenme yolları. 

Ek giriş okuma 

Bu bulut için ilk maruz kalma riskinizi ise, bu makaleler temellerini açıklar. 

• Bulut bilgi işlem nedir? 

• Örnekler bulut bilgi işlem 

• laas nedir? 

• PaaS nedir? 



Araçlar ve indirmeler 
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Azure, sağlama ve kaynaklan gibi yönetmek için çeşitli arabirimlerin sahip Azure portalında, Azure CLI, Azure 
PovverShell, Azure bulut Kabukve Visual Studio. Bu kılavuz, minimalist bir yaklaşım ve Azure Cloud Shell'i 
mümkün olduğunca azaltmak gerekli adımlar kullanır. Ancak, Azure portalında bazı kısımları için kullanılmalıdır. 

Önkoşullar 

Aşağıdaki abonelikler gereklidir: 

• Azure — bir hesabınız yoksa, ücretsiz bir deneme sürümü edinin. 

• Azure DevOps hizmetleriyle — Azure DevOps aboneliğiniz ve kuruluş bölüm 4'te oluşturulur. 

• GitHub — bir hesabınız yoksa, ücretsiz olarak kaydolun. 

Aşağıdaki araçları gereklidir: 

• Git— Git temel bir anlayış, bu kılavuz için önerilir.Gözden geçirme Git belgeleri, özellikle git uzak ve git 
gönderimi. 

• ,N ET core SDK'sı — 2.1.300 sürümü veya üzeri derlemek ve örnek uygulamayı çalıştırmak için gereklidir. 
Visual Studio ile yüklü değilse .NET Core çoklu platform geliştirme iş yükü, .NET Core SDK'sı zaten 
yüklü. 

.NET Core SDK'yı yüklemenizi doğrulayın. Bir komut kabuğunu açın ve aşağıdaki komutu çalıştırın: 

dotnet --version 


Önerilen Araçlar (yalnızca VVindovvs) 

• Visual Studiokullanıcının güçlü Azure araçları sağlar bir GUI için bu kılavuzda açıklanan işlevselliğinin büyük 
kısmını. Ücretsiz Visual Studio Community sürümü dahil olmak üzere herhangi bir Visual Studio sürümünü 
çalışır. Öğreticiler, geliştirme, dağıtma ve DevOps hem ile hem de Visual Studio olmadan göstermek için 
yazılır. 

Aşağıdaki Visual Studio onaylayın iş yükleri yüklü: 

o ASP.NET ve web geliştirme 
o Azure geliştirme 

o .N ET core platformlar arası geliştirme 





Bir uygulamayı App Service'e dağıtma 
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Azure App Service olan Azure'nın web barındırma platformu. Web uygulamasını Azure App Service'e dağıtma el 
ile veya otomatik bir işlem yapılabilir. Kılavuzu'nun bu bölümünde, el ile veya komut satırını kullanarak bir komut 
dosyası tarafından tetiklenebilir veya Visual Studio kullanarak el ile tetiklenen dağıtım yöntemlerini açıklar. 

Bu bölümde, aşağıdaki görevleri yerine getirmek: 

• indirin ve örnek uygulamayı derleyin. 

• Azure Cloud Shell'i kullanarak Azure App Service Web uygulaması oluşturun. 

• Örnek uygulamayı Git kullanarak Azure'a dağıtın. 

• Bir değişiklik, Visual Studio kullanarak uygulamayı dağıtın. 

• Hazırlama yuvası web uygulamasına ekleyin. 

• Bir güncelleştirme hazırlama yuvasına dağıtın. 

• Hazırlama ve üretim yuvalarını Değiştir. 

İndirin ve uygulamayı test etme 

Bu kılavuzda kullanılan önceden oluşturulmuş bir ASP.N ET Core uygulaması uygulamadır basit akış okuyucu. 
Kullanan Razor sayfaları uygulaması olan Microsoft.syndicationFeed.Readerwriter API, bir RSS/Atom akışı alma 
ve haber öğelerinin bir listede görüntüler. 

Kodu gözden çekinmeyin, ancak bu uygulama hakkında özel bir şey olduğunu anlamak önemlidir. Bu sadece basit 
bir ASP.NET Core uygulaması yalnızca tanım amaçlıdır. 

Bir komut kabuğundan, kodu indirmek, projeyi oluşturun ve aşağıdaki gibi çalıştırın. 

Not: Linux/MacOS kullanıcıları, ters /'' \ eğik çizgi () yerine eğik çizgi () kullanarak yollar için uygun 
değişiklikleri yapmalıdır. 

1. Kodu yerel makinenizde bir klasöre kopyalayın. 

git clone https://github.com/Azure-Samples/simple-feed-reader/ 

2. Çalışma klasörünüzde değiştirme basit akış okuyucu oluşturulduğu klasör. 

cd . \simple-feed-reader\SimpleFeedReader 

3. Paketleri geri yükle ve Çözümü derleyin. 

dotnet build 

4. Uygulamayı çalıştırın. 

dotnet run 










« I Command Prompt - dotnet run 


C:\Src\simple-feed-reader\SimpleFeedReader>dotnet run 
Hosting environment: Production 

Content noot path: C:\Src\simple-feed-reader\SimpleFeedReader 
Now listening on: http://localhost:5000 
Application started. Press Ctrl+C to shut down. 


5. Bir tarayıcı açın ve gidin http://iocaihost:50@0 . Uygulama yazın veya bir dağıtım akış URL'sini yapıştırın 
olanak tanır ve haber öğelerinin bir listesini görüntüleyin. 


O cı 

Home page - SimpleFee X 

+ ^ 
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X 

<- 

> O trî» O localhost:5000/?FeedUrl=http%3A%2F%2F 
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L & 



Simple Feed Reader 

Enter a feed URL: 
http://feeds.hanselman.c 

Retrieve Feed 

Title Published 


Penny Pinching in the Cloud: Deploying Containers cheaply to Azure 

6/15/2018 11:50:21 PM 

+00:00 

EarTrumpet 2.0 makes Windows 10's audio subsystem even better. ..and it's free! 

6/13/2018 7:34:00 AM 

+00:00 

ASP.NET Core Architect David Fowler's hidden gems in 2.1 

6/11/2018 5:15:24 AM 

+00:00 

Carriage Retums and Line Feeds will ultimately bite you - Some Git Tips 

6/5/2018 11:37:47 PM 

+00:00 



SimpleFeedReader 


6. Memnun kaldıktan sonra uygulamanın düzgün çalıştığından, tuşlarına basarak kapatma Ctrl + C komut 
kabuğunda. 

Azure App Service Web uygulaması oluşturma 

Uygulamayı dağıtmak için bir App Service oluşturma gerekecektir Web uygulaması. Web uygulamasının 
oluşturulduktan sonra ona Git kullanarak yerel makinenizde dağıtacaksınız. 

1. Oturum Azure Cloud Shell'i. Not: ilk kez oturum açtığınızda, Cloud Shell yapılandırma dosyaları için bir 
depolama hesabı oluşturmak isteyip istemediğinizi sorar. Varsayılanları kabul edin veya benzersiz bir ad 
belirtin. 

2. Cloud Shell için aşağıdaki adımları kullanın. 

a. Web uygulamanızın adı depolamak için bir değişken bildirir.Adı, varsayılan URL'de kullanılacak benzersiz 
olmalıdır. Kullanarak şrandom adı oluşturmak üzere Bash işlevi benzersizliği garanti eder ve sonuçları 
biçiminde webappname99999 . 

















webappname=mywebapp$RANDOM 

b. Bir kaynak grubu oluşturun. Kaynak grupları, grup olarak yönetilen Azure kaynaklarını toplamak için bir 
yol sağlar. 

az group create --location centralus --name AzureTutorial 

az Komutu çağırır Azure CLI. CU'yi yerel olarak çalıştırabilirsiniz, ancak zaman ve yapılandırma Cloud 
Shell'de kullanarak kaydeder. 

c. SI katmanında bir App Service planı oluşturun. Bir App Service planı, aynı fiyatlandırma katmanını 
paylaşan web apps gruplandırmasıdır. SI katmanı ücretsiz olarak değil, ancak hazırlama yuvaları özellik için 
zorunludur. 

az appservice plan create --name $webappname --resource-group AzureTutorial --sku Sİ 

d. App Service planı aynı kaynak grubunda kullanarak web uygulama kaynağını oluşturun. 

az webapp create --name $webappname --resource-group AzureTutorial --plan $webappname 

e. Dağıtım kimlik bilgilerini ayarlayın. Bu dağıtım kimlik bilgileri, aboneliğinizdeki tüm web uygulamaları için 
geçerlidir. Kullanıcı adı özel karakterler kullanmayın. 

az webapp deployment user set --user-name REPLACE_WITH_USER_NAME --password REPLACE_WITH_PASSWORD 

f. Yerel Git ve görüntü dağıtımları kabul etmek için web uygulaması yapılandırma Git dağdım URL'si. Daha 
sonra başvuru için bu URL'yi Not. 

echo Git deployment URL: $(az webapp deployment source config-local-git --name $webappname --resource- 
group AzureTutorial --query url --output tsv) 

g. Görüntü web app URL'si. Boş bir web uygulamasını görmek için bu URL'sine gidin. Daha sonra başvuru 
için bu URL'yi Not. 

echo Web app URL: http://$webappname. azurewebsites.net 

3. Yerel makinenizde bir komut kabuğu'nu kullanarak, web uygulamanızın proje klasörüne gidin (örneğin, 

. \simpie-feed-reader\simpieFeedReader ). Dağıtım URL'sine göndermeye Git'i kurma ayarlamak için 
aşağıdaki komutları yürütün: 

a. Uzak URL yerel depoya ekleyin. 

git remote add azure-prod GIT_DEPLOYMENT_URL 

b. Yerel anında iletme ana dala azure ürün uzaktan'ın ana dal. 

git push azure-prod master 


Daha önce oluşturduğunuz dağıtım kimlik bilgileri istenir. Komut kabuğu'ndaki bir çıkış gözlemleyin. Azure 











uzaktan ASP.NET Core uygulaması oluşturur. 


4. Bir tarayıcıda gidin Web uygulaması URL'si ve uygulama oluşturulan ve dağıtılan not edin. Ek değişiklikleri 
yerel Git deposu ile hassastır olabilir git commit . Bu değişiklikler, önceki ile Azure'a itilir git push komutu. 

Visual Studio ile dağıtım 

Not: Bu bölüm yalnızca Windows için geçerlidir. Llnux ve Macos'ta kullanıcılar, 2. adım açıklanan değişikliği 
yapmanız gerekir. Dosyayı kaydedin ve değişikliği ile yerel deponuza işleyin git commit . Son olarak, değişiklik 
ile anında iletme git push , ilk bölümde gibi. 


Uygulamayı komut kabuğu'ndan zaten dağıtıldı. Bir güncelleştirme uygulamasına dağıtmak için Visual Studio'nun 
tümleşik araçları kullanalım. Arka planda, Visual Studio Araçları komut satırı, ancak Visual Studio'nun alışık 
olduğunuz kullanıcı Arabirimi içinde aynı şeyi gerçekleştirir. 

1. Açık SimpleFeedReader.sln Visual Studio'da. 

2. Çözüm Gezgini'nde açın Pages\lndex.cshtml. Değişiklik <h 2 >simpie Feed Reader</h 2 > için 

<h2>Simple Feed Reader - V2</h2> . 

3. Tuşuna Ctrl + Shift+B uygulamayı oluşturun. 

4. Çözüm Gezgini'nde projeye sağ tıklayın ve Yayımla. 












5. Visual Studio, yeni bir App Service kaynak oluşturabilirsiniz, ancak bu güncelleştirme, var olan dağıtım 
yayımlanacak, içinde yayımlama hedefi seçin iletişim kutusunda App Service sol taraftaki listeden seçip 

var olanı Seç. Tıklayın yayımlama. 

6. içinde App Service iletişim kutusunda, Microsoft veya Azure aboneliğinizi oluşturmak için kullanılan 
Kurumsal hesap, sağ üst köşede görüntülendiğinden emin olun. Yüklü değilse, açılan tıklayın ve bunu 
ekleyin. 


7. Onaylayın doğru Azure abonelik seçilir. İçin görünümüseçin kaynak grubu. Genişletin AzureTutorial 
kaynak grubunu ve mevcut web uygulamasını seçin. Tamam ı tıklatın. 


x 

App Service 

Hoşt your web and mobile applications, REST APIs, and more in Azure 


# 


Microsoft 

casoper@microsoft.com 


Subscription 



Visual Studio, derleme ve uygulamayı Azure'a dağıtır.Web uygulaması URL'sine gidin. Doğrulamak <h 2 > öğesi 
değişiklik Canlı. 































Dağıtım yuvaları 

Dağıtım yuvalan, üretimde çalışan uygulama etkilemeden hazırlama değişiklikleri destekler. Kalite güvencesi ekibi 
tarafından hazırlanan sürümünü doğrulandıktan sonra üretim ve hazırlama yuvası takas edilebilir. Uygulamayı 
hazırlama aşamasından üretime yalnızca bu şekilde yükseltilir. Aşağıdaki adımları bir hazırlama yuvası oluşturma, 
bazı değişiklikler dağıtma ve hazırlama yuvasını üretim sonra doğrulama ile. 

1. Oturum Azure Cloud Shell, henüz oturum. 

2. Hazırlama yuvası oluşturur. 

a. Adıyla bir dağıtım yuvası Oluştur hazırlama. 

az webapp deployment slot create --name $webappname --resource-group AzureTutorial --slot staging 

b. Yerel Git ve get dağıtımı kullanmak için hazırlama yuvasına yapılandırma hazırlama dağıtım U RL'si. 

Daha sonra başvuru için bu URL'yi Not. 

echo Git deployment URL for staging: $(az webapp deployment source config-local-git --name $webappname - 
-resource-group AzureTutorial --slot staging --query url --output tsv) 

c. Hazırlama yuvanın URL'si görüntüler.Boş hazırlama yuvasına görmek için URL'sine gidin. Daha sonra 
başvuru için bu URL'yi Not. 

echo Staging web app URL: http://$webappname-staging. azurewebsites.net 

3. Bir metin düzenleyicisi veya Visual Studio değiştirme Pages/lndex.cshtmlyer\'\der\ böylece <h 2 > öğesi okur 

<h2>simpie Feed Reader - V3</h2> ve dosyayı kaydedin. 

4. Dosya kullanarak yerel Git deponuza işleyin değişiklikleri Visual Studio'nun sayfasında Takım Gezgini 
sekmesinde veya girerek aşağıdaki yerel makinenin komut kabuğu'nu kullanarak: 

git commit -a -m "upgraded to V3" 










5. Yerel makinenin komut kabuğunu kullanma, hazırlık dağıtım URL'si Git remote olarak ekleyip Kaydettiğim 
değişiklikleri gönderin: 

a. Hazırlama için Uzak URL yerel Git deposuna ekleyin. 

git remote add azure-staging <Git_staging_deployment_URL> 

b. Yerel anında iletme ana dala azure hazırlama uzaktan'ın ana dal. 

— 

git push azure-staging master 

Bekleme sırasında Azure derler ve uygulamayı dağıtır. 

6. Hazırlama yuvasını v3 dağıtıldığını doğrulamak için iki tarayıcı penceresi açın. Tek bir pencerede, özgün web 
uygulaması URL'sine gidin. Diğer pencere hazırlama web uygulaması URL'sine gidin. Üretim URL'si V2 
uygulama hizmetverir. Hazırlama URL'si uygulamanın V3 işlevi görür. 





7. Cloud Shell'de doğrulandı/vvarmed'li hazırlama yuvasını üretime taşır. 

az webapp deployment slot swap --name $webappname --resource-group AzureTutorial --slot staging 


8. Takas iki tarayıcı pencerelerini yenileyerek yapıldığını doğrulayın. 
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Özet 

Bu bölümde, aşağıdaki görevleri tamamlandı: 

• indirilen ve örnek uygulama yerleşik. 

• Azure Cloud Shell'i kullanarak Azure App Service Web uygulaması oluşturdunuz. 

• Örnek uygulamayı Git kullanarak Azure'a dağıtılabilir. 

• Bir değişiklik, Visual Studio kullanarak uygulamaya dağıtılan. 

• Hazırlama yuvası web uygulamasına eklendi. 

• Bir güncelleştirme hazırlama yuvasına dağıtılır. 

• Hazırlama ve üretim yuvası takas. 

Sonraki bölümde, Azure işlem hatları ile bir DevOps işlem hattı oluşturmayı öğreneceksiniz. 





















Ek okuma 

• Web Apps'e genel bakış 

• Azure App Service'te .N ET Core ve SQL veritabanı web uygulaması derleme 

• Azure App Service için dağıtım kimlik bilgilerini yapılandırma 

• Azure App Service ortamlarında hazırlık ayarlama 


Sürekli tümleştirme ve dağıtım 
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Önceki bölümde, basit akış Reader uygulaması için yerel bir Git deposu oluşturuldu. Bu bölümde, bir GitHub 
deposuna kod yayımlamak ve Azure işlem hatları kullanarak bir Azure DevOps Hizmetleri işlem hattı oluşturun. 
İşlem hattı, sürekli oluşturma ve uygulama dağıtımlarını sağlar.Herhangi bir kaydetme için GitHub deposunu bir 
derleme ve Azure Web uygulamasının hazırlık yuvasına dağıtım tetikler. 

Bu bölümde, aşağıdaki görevleri tamamlamanız: 

• Uygulamanın kodu Github'a yayımlayın 

• Yerel Git dağıtımı bağlantısını kes 

• Azure DevOps kuruluş oluştur 

• Azure DevOps Hizmetleri'ndeki bir takım projesi oluşturma 

• Bir yapı tanımı oluşturun 

• Yayın işlem hattı oluşturma 

• Değişiklikleri Github'a işleyin ve otomatik olarak Azure'a dağıtma 

• Azure işlem hatları işlem hattı inceleyin 

Uygulamanın kodu Github'a yayımlayın 

1. Bir tarayıcı penceresi açın ve gidin https://github.com. 

2. Tıklayın + açılan üst bilgisinde ve seçin yeni depo: 



Import repository 
New gist 

New organization 


3. Hesabınızı seçin sahibi açılır ve girin basit akış okuyucu içinde depo adı metin. 

4. Tıklayın Oluştur depo düğmesi. 

5. Yerel makinenin komut kabuğunu açın. Dizin gidin basit akış okuyucu Git deposunda depolanır. 

6. Var olan Yeniden Adlandır kaynak uzak Yukarı Akış. Aşağıdaki komutu yürütün: 

git remote rename origin upstream 

7. Yeni bir kaynak github'da depo kopyanızı uzak işaret eden. Aşağıdaki komutu yürütün: 

git remote add origin https://github.com/<GitHub_username>/simple-feed-reader/ 

8. Yerel Git deponuza yeni oluşturulan GitHub deposuna yayımlayın. Aşağıdaki komutu yürütün: 











git push -u origin master 

9. Bir tarayıcı penceresi açın ve gidin https://github.com/<GitHub_username>/simpie-feed-reader/ . Kodunuz 
GitHub deposunda göründüğünü doğrulayın. 

Yerel Git dağıtımı bağlantısını kes 

Aşağıdaki adımlarla yerel Git dağıtımını kaldırın. Azure işlem hatları (Azure DevOps hizmeti) hem değiştirir ve bu 
işlevselliği artırmaktadır. 

1. Açık Azure portalındagidin hazırlama (myvvebapp şeklindedir<unique_number>/hazırlama) Web 
uygulaması. Web uygulamasını hızlıca girerek konumlandırılabilir hazırlama portal'ın arama kutusunda: 


/O Search resources, Services, and docs X 

d* 

>_ 

© 

© 

© 



2. Tıklayın Dağıtım Merkezi. Yeni bir panel açılır.Tıklayın Bağlantıyı Kes önceki bölümde eklenmiş olan 
yerel Git kaynak denetimi yapılandırması kaldırılamadı. Kaldırma işlemi onaylamak Evet düğmesi. 

3. Gidin myvvebapp şeklindedir < unique_number > App Service. App Service hızlıca bulmak için portal'ın 
arama kutusuna bir anımsatıcı kullanılabilir. 

4. Tıklayın Dağıtım Merkezi. Yeni bir panel açılır.Tıklayın Bağlantıyı Kes önceki bölümde eklenmiş olan 
yerel Git kaynak denetimi yapılandırması kaldırılamadı. Kaldırma işlemi onaylamak Evet düğmesi. 


Azure DevOps kuruluş oluştur 

1. Bir tarayıcı açın ve gidin Azure DevOps kuruluş oluşturma sayfası. 

2. Benzersiz bir ad yazın hatırlayabileceğiniz bir ad seçin Azure DevOps kuruluşunuz erişim U RL'si 
oluşturmak için metin kutusu. 


3. Seçin Git kodu bir GitHub deposunda barındırıldığından radyo düğmesi. 

4. Tıklayın devam düğmesi. Kısa bir beklemeden, bir hesap ve bir takım projesi sonra adlı MyFirstProject, 
oluşturulur. 


Hoşt my projects at: 


Pick a memorable name 


.vlsualstudio.com 


Manage code using: 

® O Git 

PT Team Foundation Version Control 

We will hoşt your projects in Central US location. 
You can share vvork vvith other Microsoft users. 

Change details 


Continue 


5. Azure DevOps kuruluşa ve proje kullanıma hazır olduğunu gösteren onay e-posta açın. Tıklayın projenizi 
başlatın düğmesi: 













Start your project 


Plan, share code, collaborate, track progress, build, test, and 
deploy applications more efficiently, using Visual Studio, or 
your own tools 


Start your project 


Öpen in Visual Studio > 


6. Bir tarayıcı açılır <account_name>. visualstudio.com. Tıklayın MyFirstProject projenin DevOps işlem hattı 
yapılandırmaya başlamak için bağlantı. 


Azure işlem hatları ardışık düzenini yapılandırın 

Tamamlamak için üç ayrı adımlar vardır. Aşağıdaki üç bölüm sonuçları operasyonel bir DevOps işlem hattı'ndaki 
adımları tamamlanıyor. 

GitHub deposunu verme Azure DevOps erişimi 

1. Genişletin veya kodu dış depodan derleyin accordion. Tıklayın Kurulum yapı düğmesi: 


/\ 

or build code from an external repository 


Setup Build 



2. Seçin GitHub seçeneğini bir kaynak seçin bölümü: 


Select a source 


* 

O 

O s: O O 

VSTS Git 

GitHub 

GitHub Enterprise Subversion Bitbucket® Cloud External Git 


3. Azure DevOps GitHub deponuza erişebilmeniz için önce yetkilendirme gereklidir.Girin < G'ıtHub_username 
> GitHub bağlantısı içinde bağlantı adı metin. Örneğin: 


O 


We need your authorization to access your repositories 



Connection name * 



scottaddie GitHub connection 



Authorize using OAuth 


Or Authorize with a GitHub personal access token 


4. GitHub hesabınızda iki öğeli kimlik doğrulaması etkinleştirilirse, kişisel erişim belirteci gereklidir. Bu 
durumda, tıklayın Authorize GitHub kişisel erişim belirteci ile bağlantı. Bkz: resmi GitHub kişisel erişim 
belirteci oluşturma yönergeleri Yardım. Yalnızca depo izinlerin kapsamı gereklidir. 1 A tıklayıp OAuth 
kullanarak Yetkilendir düğmesi. 

5. istendiğinde GitHub hesabınızla oturum açın. Azure DevOps kuruluşunuz erişimi vermek için yetki ver 
ardından seçin. Başarılı olursa, yeni bir hizmet uç noktası oluşturulur. 

6. Yanındaki üç nokta düğmesini tıklayın depo düğmesi. Seçin < GitHub_username >/basit akış okuyucu 







































listeden depo. Tıklayın seçin düğmesi. 

7. Seçin ana gelen dal el ile ve zamanlanan derlemeler için varsayılan dal açılır. Tıklayın devam düğmesi. 
Şablon seçimi sayfası görüntülenir. 


Derleme tanımını oluşturun 

1. Şablon Seçimi sayfasından girin ASP.NET Core arama kutusuna: 


Select a template 

Or start with an ^ Empty pipeline 


ASP.NET Corel X 


Others 


> 

dotnet 


ASP.NET Core 

Buîld and test an ASP.NET Core web application. 



ASP.NET Core (.NET Framevvork) 

Buîld an ASP.NET Core vveb application that targets the 
full .NET Framevvorlc 


2. Şablon arama sonuçları görüntülenir. Üzerine ASP.N ET Core şablon seçeneğine tıklayıp Uygula düğmesi. 

3. Görevleri derleme tanımının sekmesi görünür. Tetikleyiciler sekmesini tıklatın. 

4. Denetleme sürekli tümleştirmeyi etkinleştir kutusu. Altında dal filtreleri bölümünde, onaylayın türü 
açılan ayarlandığında INCLUDE. Ayarlama dal belirtimi açılan ana. 


\ Enable continuous integration 

Batch changes while a build is in progress 


Branch filters 


Type 

Branch specification 

Indude 

master v 


-I - Add 


Bir derleme herhangi bir değişiklik gönderildiğinde tetiklemek bu ayarları neden ana GitHub deposunun 
dal. Sürekli Tümleştirme test değişiklikleri Github'a ve otomatik olarak Azure'a dağıtma bölümü. 

5. Tıklayın Kaydet ve kuyruğa düğmesini ve Kaydet seçeneği: 

İE Save & queue v 
0 Save & queue 

Save 


6. Aşağıdaki kalıcı iletişim kutusu görüntülenir: 





























Save build definition 


x 


Select folder * 


Comment 


Cancel 


Varsayılan klasörünü kullanın \, tıklatıp Kaydet düğmesi. 

Yayın işlem hattı oluşturma 

1. Tıklayın yayınlartakım projenizin sekmesi. Tıklayın yeni işlem hattı düğmesi. 




MyFirstProject 


Releases 


Library 


Dashboards d 


Task Groups Deploy 



Release Management t 
your softvvare in multip 
delivery of your sofh\ 
automated processes wi 

Start by creating a new ı 


+ New pipeline 


Şablon seçim bölmesi görünür. 

2. Şablon Seçimi sayfasından girin App Service arama kutusuna: 


Select a Template 

> J App Service 

X 

Or start with an Empty pipeline 



3. Şablon arama sonuçları görüntülenir. Üzerine yuva ile Azure App Service dağıtımı şablon seçeneğine 
tıklayıp Uygula düğmesi. İşlem hattı sürüm ardışık düzeninin sekmesi görünür. 




































Ali definitions > T New Release Definition 

Pipeline ©Tasksv Variables Retention Options History 


Artifacts I + Add 


Environments I *f- Add 



& Environment 1 

^ © 1 phase, 2 tasks 


A 


/•a Schedule 
^ not set 


4. Tıklayın Ekle düğmesine Yapıtları kutusu. Yapıt ekleme paneli görüntülenir: 

Add artifact 

Source type 

❖ 

Git 

3 more artifact types v 

Project * © 

MyFirstProject v 

Source (Build definition) * © 

v 

© This setting is required. 

Add 

5. Seçin derleme gelen döşeme kaynak türünü bölümü. Bu tür, derleme tanımı için yayın işlem hattı 
bağlamak için sağlar. 

6. Seçin MyFirstProject gelen proje açılır. 

7. Yapı tanımı adı seçin MyFirstProject ASP.NET Core-CI, gelen kaynak (derleme tanımı) açılır. 

8. Seçin son gelen varsayılan sürüm açılır. Bu seçenek, derleme tanımının en son çalışma tarafından üretilen 
yapıtları oluşturur. 

9. Metni Değiştir kaynak diğer adı textbox ile birak. 

10. Ekle düğmesine tıklayın. Yapıtları değişiklikleri görüntülemek için güncelleştirmeleri bölümü. 

11. Sürekli dağıtımı etkinleştirmek için Şimşek simgesi tıklayın: 



O K 

GitHub Team Found... 























Artifacts | + Add 



Drop 


,-j\ Schedule 
^ not set 


Bu seçenek etkinleştirildiğinde, her seferinde yeni bir derleme kullanılabilir bir dağıtım gerçekleşir. 

12. A sürekli dağıtım tetikleyicisi paneli sağ tarafta görüntülenir. Özelliği etkinleştirmek için iki durumlu 
düğmeye tıklayın. Etkinleştirmek gerekli değildir çekme isteği tetikleyicisi. 

13. Tıklayın Ekle açılan menü derleme dalı filtreleri bölümü. Seçin derleme tanımının varsayılan dalı 

seçeneği. Bu filtre yalnızca GitHub deposundan ait bir derleme için tetiklemek yayın neden ana dal. 


14. Kaydet düğmesine tıklayın. Tıklayın Tamam sonuç düğmesine Kaydet kalıcı iletişim kutusu. 


15. Tıklayın ortam 1 kutusu. Bir ortam paneli sağ tarafta görüntülenir. Değişiklik ortam 7 metinde ortam adı 
TextBox'a üretim. 


X 


Environments I ~\~ Add ^ 


1 -;- 1 

fc Environmerıt 1 

© 1 phase, 2 tasks 


Environmerıt ® Delete 0 Move v ... 

Environment 1 

ılı Properties /n 

Name and ovvners of the environment 


Environment name 


Environment 1 


Environment ovvner 


16. Tıklayın Aşama 1, 2 görevler bağlantısını üretim kutusunda: 


Environments I t Add 


r 


& 

Production 

A 

1© 1 phase, 2 tasks| 


I 



Görevleri ortamın sekmesi görünür. 

17. Tıklayın yuvası Azure App Service'e dağıtma görev. Sağ paneldeki ayarlarına görünür. 

18. App Service'ten ile ilişkili Azure aboneliği seçin Azure aboneliği açılır. Seçildikten sonra tıklayın Authorize 
düğmesi. 





















19. Seçin Web uygulaması gelen uygulama türü açılır. 

20. Seçin mywebapp şeklindedir/ < unique_number/ > gelen uygulama hizmeti adı açılır. 

21. Seçin AzureTutorial gelen kaynak grubu açılır. 

22. Seçin hazırlama gelen yuvası açılır. 

23. Kaydet düğmesine tıklayın. 

24. Varsayılan yayın işlem hattı adının üzerine gelin. Düzenlemek için Kalem simgesine tıklayın. Kullanım 
MyFirstProject ASP.NET Core-CD adı. 



25. Kaydet düğmesine tıklayın. 

Değişiklikleri Github'a işleyin ve otomatik olarak Azure'a dağıtma 

1. Açık SimpleFeedReader.sln Visual Studio'da. 

2. Çözüm Gezgini'nde açın Pages\lndex.cshtml. Değişiklik <h2>simpie Feed Reader - V3</h2> için 

<h2>Simple Feed Reader - V4</h2> . 

3. Tuşuna Ctrl + Shift+B uygulamayı oluşturun. 

4. Dosyanın GitHub deposuna kaydedin. Hangisini değişiklikleri Visual Studio'nun sayfasında Takım Gezgini 
sekmesinde veya aşağıdakileri yürütün yerel makinenin komut kabuğu'nu kullanarak: 

git commit -a -m "upgraded to V4" 

5. Değişiklik itin ana dala kaynak GitHub deponuzun uzak: 

git push origin master 

GitHub depo işleme görünür ana dal: 



Sürekli Tümleştirme derleme tanımının ping'i derlemenin tetiklenmesinin Tetikleyicileri sekmesinde: 


Tasks Variables Triggers Options Retention History 


Continuous integration 

scottaddie/simple-feed-reader 

^ * Enabled 

O scottaddie/simple-feed-reader 

\ Enable continuous integration 


6. Gidin sıraya alman sekmesinde Azure işlem hatları > yapılar Azure DevOps Hizmetleri sayfasında. 
Sıraya alınan yapı, dal ve derleme tetiklendi işleme gösterir: 




















Queued or running 






& 

O Name 

Definition name 

Queue name 

Source 

Source version 

Date queued 

♦ 

► 20180614.1 

MyFirstProject-ASP.NET Core-CI 

Hosted VS2017 

master 

$ bb0d47d 

a minute ago 


7. Derleme başarılı olduktan sonra azure'a dağıtım gerçekleşir.Uygulamayı tarayıcıda gidin. Başlıkta "V4" 
metin göründüğüne dikkat edin: 


SimpleFeedReader 


Simple Feed Reader - V4 


Enter a feed URL: 


Retıieve Feed 


© 2017 - SimpleFeedReader 

Azure işlem hatları işlem hattı inceleyin 

Derleme tanımı 

Bir yapı tanımı adı ile oluşturulmuş MyFirstProjectASP.NET Core-CI. Derleme tamamlandıktan sonra üreten bir 
.z/p yayımlanacak varlıkları içeren dosya. Sürüm ardışık bu varlıkları Azure'a dağıtır. 

Yapı tanımının görevleri sekmesi, kullanılan tek tek adımları listeler. Beş yapı görevleri vardır. 



1. Geri yükleme — yürütür dotnet restore uygulamanın NuGet paketlerini geri yüklemek için komutu. 
Varsayılan paket akışı kullanılan nuget.org olan. 

2. Derleme — yürütür dotnet buiid --configuration release uygulamanın Kodu derlemek için komutu. Bu 















--configuration seçeneği, bir üretim ortamına dağıtım için uygun olan kod en iyi duruma getirilmiş bir 
sürümünü oluşturmak için kullanılır. Değiştirme BuildConfiguration yapı tanımının üzerinde değişken 
değişkenleri Örneğin, bir hata ayıklama yapılandırmasının gerekli olmadığını sekmesi. 

3. Test — yürütür 

dotnet test --configuration release --logger trx --results-directory <local_path_on_build_agent> 
uygulamanın birim testleri çalıştırmak için komutu. Birim testleri, C# projesi eşleşen içinde yürütülen 
**/*tests/*. cspnoj glob deseni. Test sonuçları kaydedilir bir ,trx dosya tarafından belirtilen konumda 
--results-directory seçeneği. Herhangi bir test başarısız olursa, derleme başarısız oluyor ve dağıtılabilir 
değil. 


NOTE 

Birim testleri iş doğrulamak için değiştirme SimpleFeedReader.Tests\Services\NewsServiceTests.cs 
kullanılamıyor.%n%nÇözüm testleri birini ayırmak için. Örneğin, değiştirme Assert.True(result.count > 0 ); için 
Assert. False(result.Count > 0); içinde Returns_News_Stories_Given_Valid_Uri yöntemi. Kaydedin ve 
Github'a bir değişiklik gönderin. Derleme tetiklenir ve başarısız olur. Derleme işlem hattı durumu değişerek başarısız. 
Değişiklik, işleme ve gönderme yeniden döndürün. Derleme başarılı olur. 


4. Yayımlama —yürütür dotnet publish --configuration release --output <local_path_on_build_agent> 
üretmek için komutu bir .zip dağıtılacak yapıtlar içeren dosya, --output Seçeneği Yayımla konumunu 
belirleyen .zip dosya. Konum geçirerek belirtilen bir önceden tanımlanmış değişken adlı 

$(buiid.artifactstagingdirectory) . Bu değişken gibi yerel bir yola genişletir c:\agent_work\1\a, yapı 
aracısında. 

5. Yapıt yayımlama — Publishes .zip dosya tarafından üretilen Yayımla görev. Görevi kabul .zip dosya 
konumu önceden tanımlanmış bir değişkendir bir parametre olarak $(buiid.artifactstagingdirectory) . .Zip 
dosya adlı bir klasör yayımlanan bırak. 


Yapı tanımının tıklayın özeti bağlantı tanımı yapılarla geçmişini görüntülemek için: 


Tasks Variables Triggers Options Retention History 

- 


t> Queue 


Sonuçta elde edilen sayfanın benzersiz derleme numarasına karşılık gelen bağlantıya tıklayın: 


Summary History Deleted 


Details 

Repository 
Default queue 
Queue statü s 
Last updated by 


Q scottaddie/simple-feed-reader 
Hosted VS2017 | Marıage 
Enabled 

Scott Addie | Friday, May 25, 2018 3:23 PM 


Queued & ruııning 

No buîlds gueued or running at the moment 


Recently completed 


#20180525.1 


s/ succeeded 


Analytics 


|s> master 


Scott Addie 


Numberof builds 


Success rate 


O 100.00% 


Bu belirli derleme özeti görüntülenir.Tıklayın Yapıtları sekmesini tıklatıp dikkat edin bırak derleme tarafından 
üretilen klasör listelenir: 





















Build succeeded 


Build 20180525.1 

* Ran for 2.1 minutes (Hosted VS2017), completed 7 days ago 


Summary Timeline 

Name T 

Artifacts 

Code coverage' Tests 

! m drop Dovvnload Explore 


Kullanım indirme ve Araştır yayımlanan yapıtlar incelemek için bağlantılar. 

Yayın ardışık düzeni 

Yayın işlem hattı adı ile oluşturulmuş MyFirstProject ASP.NET Core-CD: 
Pipeline Tasks v Variables Retention Optîons History 


Artifacts I f- Add 


Environments I + Add 



& 


İKİ 

& 

Production 

Drop 

A 

1 phase, 2 tasks 


/-Cv Schedule 
not set 


Sürüm ardışık düzeninin iki ana bileşenleri Yapıtları ve ortamları. Kutuya tıkladığınızda Yapıtları bölümü 
aşağıdaki paneli gösterir: 


Pipeline Tasks ^ Variables Retention Options History 


Artifact 

Artifacts I + Add Environme Build ' Dro P 


X 

® Delete 


ı£ı 

Drop 


Project * © 

MyFirstProject 

Source (Build definition) * © 

MyFirstProject-ASP.NET Core-CI 


Schedule 
^ not set 


Defauİt version * © 

Latest 


Source alias © 
Drop 


Kaynak (derleme tanımı) değeri bu yayın ardışık düzeni bağlantılı yapı tanımını temsil eder. .Zip bir derleme 
tanımının başarılı çalışma tarafından üretilen dosya sağlanan üretim azure'a dağıtım ortamı. Tıklayın Aşama 7, 2 
görevler bağlantısını üretim ortam kutusu yayın işlem hattı görevleri görüntülemek için: 





















Pipelîne Tasks ^ Variables Retention 


Production 

Deployment process 


Phasel 

3 Run on agent 


Deploy Azure App Service to Slot 

Fö Azure App Service Deploy 


Options h 


+ 


Manage Azure App Service - Slo... 

Azure App Service Manage 


Sürüm ardışık iki görevden oluşur: Azure App Service'e yuvasına dağıtım veyuvası takas Azure App Service - 
Yönetim, ilk görev tıklayarak aşağıdaki görev yapılandırmasını gösterir: 

Azure App Service Deploy © 

P 3 Version 3* v 

Display name * 

Deploy Azure App Service to Slot 
Azure subscription * © | Manage Lî 

Visual Studio Enterprise v © 

App type * © 


Web App 



App Service name * 

© 


mywebapp11857 


^ ü 

] Deploy to slot 

© 


Resource group * 

O 


AzureTutorial 


- ü 

Slot * © 

staging 


- ü 


Azure aboneliği, hizmet türü, web uygulaması adı, kaynak grubu ve dağıtım yuvası dağıtımı görevinin tanımlanır. 
Paket veya klasör textbox tutan .zip ayıklanır ve dağıtılan için dosya yolu hazırlama yuvasını myvvebapp 
şeklindedir<benzersiz_son> web uygulaması. 

Yuvası takas görev tıklayarak aşağıdaki görev yapılandırmasını gösterir: 

















Azure App Service Manage © 

Version 0.* v 

Display name * 

Manage Azure App Service - Slot Swap 
Azure subscription * © | Manage 12 

Visual Studio Enterprise v ÇJ) 

Action © 

Swap Slots v 


App Service name * © 


mywebapp11857 

V 

ü 

Resource group * © 



AzureTutorial 

V 

ü 

Source Slot * © 



staging 

V 

ü 


3| Swap with Production © 

] Preserve Vnet © 

Abonelik, kaynak grubu, hizmet türü, web uygulaması adı ve dağıtım yuvası Ayrıntılar sağlanır. Üretim ile takas 
onay kutusunun işaretli. BITS sonuç olarak, dağıtılan hazırlama yuvası üretim ortamına takas. 

Ek okuma 

• Azure işlem hattı ile ilk işlem hattınızı oluşturun 

• Derleme ve .NET Core projesi 

• Azure işlem hatları ile bir web uygulaması dağıtma 










İzleme ve hata ayıklama 

18.07.2019 • 8 minutes to read ı Edit Online 


Uygulamanın dağıtılan ve yerleşik olarak DevOps işlem hattı, izleme ve sorun giderme uygulama anlamak 
önemlidir. 

Bu bölümde, aşağıdaki görevleri tamamlamanız: 

• Temel izleme ve sorun giderme Azure portalında veri Bul 

• Azure izleyici ölçümleri daha ayrıntılı göz tüm Azure Hizmetleri genelinde nasıl sağladığını öğrenin 

• Uygulama profil oluşturma için Application Insights ile web uygulamasına bağlama 

• Günlük özelliğini açar ve günlükleri indirmek öğrenin 

• Stream gerçek zamanlı olarak günlüğe kaydeder. 

• Uyarıları ayarlamak öğrenin 

• Uzaktan hata ayıklama Azure App Service vveb apps hakkında bilgi edinin. 


Temel izleme ve sorun giderme 

App Service vveb uygulamalarını kolayca gerçek zamanlı olarak izlenir. Azure portal, ölçümleri anlaşılması kolay 
grafikler ve graflar, işler. 

1. Açık Azure portalındave ardından gidin myv/ebapp şekimdedir<unique_number> App Service. 

2. Genel bakış sekmesi son ölçümleri gösteren grafikler de dahil olmak üzere faydalı "bir bakışta" bilgiler 
görüntüler. 


mywebapp21816 


| fi Search (Ctrt*/) 

Overview 
H Activity log 
iSı Access control (IAM) 

# Tags 

% Diagnose and solve problems 

DEPLOYMENT 

4i Quickstart 
Eİ Deployment credentials 
ııi Deployment slots 
0 Deployment options 
ĞJ Continuous Delıvery (Previevv) 

SETTINGS 

Sî Application settings 
T Authentication / Authorization 
9 Application Insights 
Ü Managed service identity (Pr... 
£ Backups 
£9 Cııstom domains 
O SSL settings 
«*•> Networking 

Scale up (App Service plan) 
Scale out (App Service plan) 
WebJobs 
P Push 
6, MySQL İn App 
' -' Properties 
A Locks 


« Browse ■ Stop Swap Q Restart |D Delete ^ Get publish profile 

Resource group (change) 

AzureTutorial 
Status 
Running 
I Location 
1 Central US 

Subscription (change) 
vs-beta 

Subscription İD 

dfl 1f062-9277-40f1-a559-888e4c82c4db 


O Reset publish profile 
URL 

https://mywebapp21816.azurewebsites.net 
App Service plan/pricing tier 
mywebapp21816 (Standard: 1 Small) 

Git/Deployment username 

camsoper 

Git done url 

httpsv7camsoper@mywebapp21816.scm.azurewebsites.nefc443/mywebapp21816-git 
FTP hostname 

ftp://waws-prod-dm1-089.ftp.azurewebsites.windows.net 


Diagnose and solve problems A Application Insights A App Service Advisor 

Ourself-service diagnostic and troubleshooting expehence _ Application Insights helps you detect and diagnose quality ^ App Service Advisor provides Insights for improving app 

helps you identıfy and resolve issues with your web app. issues in ya ur apps, and helps you understand what your experience on the App Service platform. Recommendations 

users actually do wittı it a re sorted by freshness. priority and impact to your app. 


S:1S PM 530 PM 5:45 PM 

REOUESTS O 




5:15 PM 530 PM 545 Pt 
DATA İN O 

17.6 kB 


Average Response Time 


5:15 PM 530 PM 545 P1 

AVERAGE RESPONS... O 

243.52 ms 


X 


JUL 


î 


530 PM 545 Ph 


I DATA OUT O 

12.94 kB 


























• Http 5xx: Sunucu tarafı hatalarının sayısı, genellikle ASP.NET Core kodundaki özel durumlar. 

• Veri: Web uygulamanıza gelen veri girişi. 

• Giden veri: Web uygulamanızdan istemcilere giden veri çıkışı. 

• İstek sayısı: HTTP isteklerinin sayısı. 

• Ortalama yanıt süresi: Web uygulamasının HTTP isteklerine yanıt vermesi için geçen ortalama süre. 
Sorun giderme ve en iyi duruma getirme için Self Servis çeşitli araçlar Ayrıca bu sayfada bulunur. 


I mywebapp21816 


Activity log 

ı Access control (IAM) 


Diagnose and solve problems 


DEPLOYMENT 

Quickstart 

'.d Deployment credentials 
III Deployment slots 
0 Deployment options 

Continuous Delivery (Preview) 

SETTİNGS 

Application settings 
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O Application Insights 
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a Custom domains 
0 SSL settings 
Networking 

m Scale up (App Service plan) 
jlfj' Scale out (App Service plan) 
& WebJobs 
U Push 
C, MySQL İn App 
' i' Properties 
A Locks 


03 Browse ■ Stop *Sl Swap Çj Restart Delete Get publish profile ÇJ Reset publish profile 


Status 
Running 
Location 
Central US 


URL 

httpsy/mywebapp21816.azurewebsites.net 
App Service plan/pricing tier 
mywebapp21816 (Standard: 1 Small) 

Gıt/Deployment username 

camsoper 

Git done url 

httpsy/camsoper@mywebapp21816.scm.azurewebsites.net:443/mywebapp21816.git 
FTP hostname 

ftp://waws-prod-dm1-089.ftp.azurewebsites.windows.net 


Diagnose and sotve problems 

Our seff-service diagnostic and troubleshooting exper 
helps yoy identify and resolve issues vvith your web ap 
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Application Insights 

ısights helps you derect and diagnose quality 
s in your apps. and helps you understand whac your 
; actually do with it 


App Semce Advisor 

App Service Advisor provides insights for improving app 
experience on The App Service platform. Recommendalion 
are sorted by freshness. priority and impact co your app. 
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• Sorunları tanılama ve çözme olan bir Self Servis sorun giderici. 

• Application İnsights performans ve uygulama davranışını profil oluşturma için olan ve daha sonra bu 
bölümde ele alınmıştır. 

• App Service Danışmanı uygulama deneyiminizi ayarlamak için öneriler sağlar. 

Gelişmiş izleme 

Azure izleyici tüm ölçümleri izleme ve Azure Hizmetleri genelinde uyarılar ayarlanması için merkezi hizmetidir. 
Azure izleyici'içinde yöneticileri hedefle performansını izleyebilir ve eğilimleri belirleyin. Her bir Azure hizmeti, 
kendi sunar ölçüm kümesini Azure izleyicisi. 

Application İnsights ile profili 

Application İnsights web uygulamaları ve kullanıcıların bunları nasıl kullanılacağını kararlılığı ve performansı analiz 
etmek için bir Azure hizmetidir. Application İnsights verilerini, daha geniş ve Azure izleyici'den daha derin. Veriler, 
geliştiricilerin ve yöneticilerin uygulamaları geliştirmek için anahtar bilgilerini sağlayabilir. Application ınsights'ı bir 
Azure App Service kaynak kod değişikliği yapmadan eklenebilir. 

1. Açık Azure portalındave ardından gidin myv/ebapp şeklindedir<unique_number> App Service. 

2. Gelen genel bakış sekmesinde Application İnsights Döşe. 
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Application Insights 

Application Insights helps you detect and diagnose quality 
issues in your apps. and helps you understand w hat your 
users actually do vvith it 


3. Seçin yeni kaynak Oluştur radyo düğmesi. Varsayılan kaynak adı kullanın ve Application Insights kaynağı 
için konum seçin. Konum, web uygulamanızın eşleşmesi gerekmez. 


Application Insights 

Application Insights helps you detect and diagnose quality issues in your web apps and web Services, and helps yo 
^ually do with it 

Getting started with Application Insights monitoring 



Link your application to Application Insights 
O Select existing resource 

O my-blog my-blog South Central US 


* Location 


East US 


® Create new resource 
* New resource name 


mywebapp21816 


Instrument your application 


* Runtıme/Framework 

ASP.NET Core v 


Code level diagnostics 

Identify code that slowed down your web app and debug runtime exceptions vvith local variables 


Off 


^ Advanced Settings 



4. İçin çalışma zamanı/Framevvorkseçin ASP.N ET Core. Varsayılan ayarları kabul edin. 

5. Tamam'ı seçin. Onaylamanız istendiğinde belirleyin devam. 

6. Kaynak oluşturulduktan sonra Application Insights sayfasına doğrudan gitmek için Application Insights 
kaynağı adına tıklayın. 

^^^ebapp^^6|Application Insights resource is connected Change 
Troubleshooting information 


Uygulama kullanıldıkça, verileri toplanır. Seçin Yenile dikey penceresinde yeni verilerle yeniden yüklemek için. 
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Application ınsights'ı hiçbir ek yapılandırma yararlı sunucu tarafı bilgiler sağlar. Uygulama anlayışlarımdan en fazla 
değeri elde etmek uygulamanızı Application Insights SDK'sı ile izleme. Düzgün bir şekilde yapılandırıldığında, 
istemci tarafında performans dahil olmak üzere, tarayıcı ve vveb sunucusu arasında uçtan uca izleme hizmetidir. 
Daha fazla bilgi için Application Insights belgeleri. 

Günlüğe Kaydetme 

Web sunucusu ve uygulama günlüklerini Azure App Service'te varsayılan olarak devre dışı bırakılır.Aşağıdaki 
adımlarla günlüklerini etkinleştirin: 


1. Açık Azure portalındagidin myv/ebapp şeklindedir<unique_number> App Service. 
























2. Sol menüde, aşağı kaydırarak izleme bölümü. Seçin tanılama günlükleri. 


MONITORING 
</ Alerts (Classic) 

Q Diagnostics logs 
Q Log stream 
^ Process explorer 

3. Açma uygulama günlüğü (dosya sistemi) . istenirse, web uygulamasında oturum uygulamasını 
etkinleştirmek için uzantıları yüklemek için kutusuna tıklayın. 

4. Ayarlama Web sunucusu günlüğü için dosya sistemi. 

5. Girin saklama süresi gün. Örneğin, 30. 

6. Kaydet'e tıklayın. 

Web uygulaması için ASP.NET Core ve web sunucusu (App Service) günlükleri üretilir.Görüntülenen bilgileri 
FTP/FTPS kullanarak yüklenebilir. Parola, bu kılavuzda daha önce oluşturduğunuz dağıtım kimlik bilgileri ile 
aynıdır. Günlükleri olabilir PovverShell veya Azure CU ile yerel makinenize doğrudan akışla. Günlükleri de olabil 
uygulama anlayışları 1 nda görüntülenen. 

Günlük akışı 

Uygulama ve vveb sunucusu günlükleri, portal üzerinden gerçek zamanlı aktarılabilir. 

1. Açık Azure portalındagidin myvvebapp şeklindedir<unique_number> App Service. 

2. Sol menüde, aşağı kaydırarak izleme seçin ve bölüm günlük akışı. 



Günlükleri de olabilir Azure CU veya Azure PovverShelIde dahil olmak üzere Cloud Shell aracılığıyla. 

Uyarılar 

Azure izleyici ayrıca sağlar gerçek zamanlı uyarılar ölçümleri, yönetim olayları ve diğer ölçütlere göre. 

Not: Web uygulamasL ölçümlerinde Şu anda uyan verme yalnızca uyarılar (klasik) hizmetinde kullanılabilir. 

Uyarılar (Klasik) hizmeti Azure izleyicisinde veya altında bulunabilir izleme App Service ayarları bölümü. 















MONITORING 


s/ Alerts (Classic) 

Q Diagnostics logs 
Q Log stream 
•İ* Process explorer 


Canlı hata ayıklama 

Azure App Service olabilir ile Visual Studio uzaktan hata ayıklama zaman günlükleri sağlamadığınızdan yeterli 
bilgi. Ancak, uzaktan hata ayıklama, hata ayıklama sembolleriyle derlenmiş uygulamanın gerektirir. Hata ayıklama 
üretimde dışında son çare olarak yapılması gerekir. 

Sonuç 

Bu bölümde, aşağıdaki görevleri tamamlandı: 

• Temel izleme ve sorun giderme Azure portalında veri Bul 

• Azure izleyici ölçümleri daha ayrıntılı göz tüm Azure Hizmetleri genelinde nasıl sağladığını öğrenin 

• Uygulama profil oluşturma için Application Insights ile web uygulamasına bağlama 

• Günlük özelliğini açar ve günlükleri indirmek öğrenin 

• Stream gerçek zamanlı olarak günlüğe kaydeder. 

• Uyarıları ayarlamak öğrenin 

• Uzaktan hata ayıklama Azure App Service web apps hakkında bilgi edinin. 

Ek okuma 

• Azure App Service ve IIS 'de ASP.NET Core sorunlarını giderme 

• ASP.NET Core ile Azure App Service ve IIS için ortak hatalar başvurusu 

• Application Insights ile Azure web uygulaması performansını izleme 

• Azure App Service'te web apps için tanılama günlüğünü etkinleştirme 

• Visual Studio kullanarak Azure App Service'te bir web uygulaması sorunlarını giderme 

• Klasik ölçüm uyarıları, Azure izleyici'de Azure Hizmetleri için - oluşturun. Azure portalı 







Sonraki adımlar 
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Bu kılavuzda, örnek ASP.N ET Core uygulaması için bir DevOps işlem hattı oluşturdunuz. Tebrikler! ASP.NET Core 
web uygulamaları, Azure App Service'e yayımlama ve değişiklikler için sürekli tümleştirme otomatikleştirmek 
öğrenme keyif umuyoruz. 

Web barındırma ve DevOps, Azure platformu-olarak-hizmet (PaaS) Hizmetleri ASP.NET Core geliştiricileri için 
kullanışlı bir çeşit vardır. Bu bölümde bazı sık kullanılan hizmetler kısa bir genel bakış sağlar. 

Depolama ve veritabanları 

Redis cache yüksek performanslı, düşük gecikme süreli veri önbelleğe alma bir hizmet olarak kullanılabilir. Sayfa 
çıktısını önbelleğe alma, veritabanı istekleri azaltma ve bir uygulama birden çok örneği üzerinde ASP.NET Core 
oturum durumu sağlamak için kullanılabilir. 

Azure depolama Azure'nın yüksek düzeyde ölçeklenebilir bulut depolamadır.Geliştiriciler yararlanabilir kuyruk 
depolama güvenilir message queuing için ve tablo depolama olan, muazzam, yarı yapılandırılmış veri kümeleri 
aracılığıyla hızlı geliştirmeye yönelik olarak tasarlanan NoSQL anahtar-değer deposu. 

Azure SQL veritabanı Microsoft SQL Server altyapısını kullanan bir hizmet olarak bilinen ilişkisel veritabanı 
işlevlerini sağlar. 

Cosmos DB Global olarak dağıtılmış, çok modelli bir NoSQL veritabanı hizmeti. Birden çok API'ları (eski adıyla 
DocumentDB olarak adlandırılır) SQL API'si, Cassandra ve MongoDB gibi kullanılabilir. 

Kimlik 

Azure Active Directory ve Azure Active Directory B2C her iki kimlik hizmetleridir. Azure Active Directory kuruluş 
senaryoları için tasarlanmıştır ve Azure AD B2B (işletmeler arası) işbirliği, sosyal ağ oturum açma dahil olmak 
üzere, amaçlanan iş müşteri senaryoları olsa da Azure Active Directory B2C'yi etkinleştirir. 

Mobil 

Bildirim hub'ları hızlıca çeşitli cihaz türleri üzerinde çalışan uygulamalara milyonlarca mesaj göndermek için çok 
platformlu, ölçeklenebilir anında iletme bildirimi altyapısı. 

Web altyapısı 

Azure Container Service hızla ve kolayca kapsayıcı düzenleme uzmanlığı gerektirmeden kapsayıcıya alınmış 
uygulamaları dağıtma ve yönetme, barındırılan Kubernetes ortamınızı yönetir. 

Azure Search'ü özel ve heterojen içerikler üzerinde kurumsal arama çözümü oluşturmak için kullanılır. 

Service Fabric kolaylaştıran paketlemek, dağıtmak ve yönetmek ölçeklenebilir bir dağıtılmış sistemler platformudur 
ve güvenilir mikro Hizmetleri ve kapsayıcıları. 




IIS ile Windows üzerinde ASRNET Core barındırma 
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Luke Latham tarafından 

ASP.NET Core uygulamasını bir IIS sunucusuna yayımlamaya yönelik bir öğretici deneyimi için, bkz. IIS 'de 
ASP.NET Core uygulaması yayımlama. 

.NET Core barındırma paketi 'ni yükler 

Supported operating systems 

Aşağıdaki işletim sistemleri desteklenir: 

• VVİndovvs 7 veya üzeri 

• VVİndovvs Server 2008 R2 veya üzeri 

Http. sys sunucusu (eskiden vvebListener olarak adlandırılır), IIS ile ters proxy yapılandırmasında çalışmaz. 
Kestrel sunucusunukullanın. 

Azure 'da barındırma hakkında bilgi için bkz. ASP.NET Core uygulamalarını Azure App Service dağıtma. 
Sorun giderme kılavuzu için bkz. AS P.N ET Core projeleri sorunlarını giderme. 

Desteklenen platformlar 

32-bit (x86) veya 64 bit (x64) dağıtımı için yayımlanan uygulamalar desteklenir. Uygulama dışında 32 bitlik bir 
uygulamayı 32 bit (x86) .NET Core SDK dağıtma: 

• 64 bitlik bir uygulama için kullanılabilir daha büyük sanal bellek adres alanını gerektirir. 

• Daha büyük IIS yığın boyutunu gerektirir. 

• 64 bitlik yerel bağımlılıklara sahiptir. 

64 bit uygulama yayımlamak için 64 bit (x64) .NET Core SDK kullanın. Ana bilgisayar sisteminde 64 bit 
çalışma zamanı bulunmalıdır. 

Barındırma modelleri 

İşlem içi barındırma modeli 

ASP.NET Core bir uygulama, işlem içi barındırma kullanarak IIS çalışan işlemiyle aynı işlemde çalışır.İşlem içi 
barındırma, istek dışı barındırmak için gelişmiş performans sağlar çünkü istekler, giden ağ trafiği ile aynı 
makineye geri döndürülen bir ağ arabirimidir. IIS, VVİndovvs İşlem etkinleştirme hizmeti (was)ile işlem 
yönetimini işler. 

ASP.NET Core modülü: 

• Uygulama başlatmayı gerçekleştirir, 
o CoreCLR'yi yükler. 

o Program.Main çağırır. 

• IIS yerel isteğinin ömrünü işler. 

İşlem içi barındırma modeli, .NET Framevvork hedefASP.NET Core uygulamalar için desteklenmez. 

Aşağıdaki diyagramda IIS, ASP.NET Core modülü ve süreçte barındırılan bir uygulama arasındaki ilişki 





gösterilmektedir: 


Internet 
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HTTP 


IIS 
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(w3wp.exe) 

ASP.NET Core Modüle 

IISHttpServer HttpContext Application code 
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http://contoso.com 


Web 'den çekirdek modu HTTP, sys sürücüsüne bir istek ulaşır.Sürücü, yerel isteği Web sitesinin 
yapılandırılmış bağlantı noktasında 11S 'ye yönlendirir, genellikle 80 (HTTP) veya 443 (HTTPS). ASP.NET Core 
modülü yerel isteği alır ve IIS HTTP sunucusuna ( nsHttpServer ) geçirir.MS HTTP sunucusu, isteği yerelden 
yönetilene dönüştüren bir IIS için işlem içi sunucu uygulamasıdır. 


IIS HTTP sunucusu isteği işlediğinde, istek ASP.N ET Core ara yazılım ardışık düzenine gönderilir.Ara yazılım 
ardışık düzeni isteği işler ve uygulamanın mantığına bir Httpcontext örneği olarak geçirir. Uygulamanın yanıtı 
IIS HTTP sunucusu aracılığıyla IIS 'e geri geçirilir. IIS yanıtı, isteği başlatan istemciye gönderir. 

İşlem içi barındırma, mevcut uygulamalar için kabul ediyor, ancak tüm IIS ve IIS Express senaryoları için 
varsayılan DotNetyeni şablonlar, işlem içi barındırma modeli için varsayılan olarak kullanılır. 

createDefaultBuiider , CoreCLR 'yi önyüklemek ve uygulamayı IIS çalışan işleminin ( W3wp. exe veya 
iisexpress. exe) içinde barındırmak için UselIS metodunu çağırarak bir IServer örneği ekler. Performans testleri, 
bir .NET Core uygulamasını işlem içinde barındıran uygulamanın, uygulamayı işlem dışı ve Kestrel 
sunucusuna proxy alma isteklerinin barındırılmasına kıyasla önemli ölçüde daha yüksek istek aktarım hızı 
sağladığını gösterir. 


NOTE 

Tek bir dosya yürütülebilir dosyası olarak yayınlanan uygulamalar, işlem içi barındırma modeliyle yüklenemez. 


İşlem dışı barındırma modeli 

ASP.NET Core uygulamalar IIS çalışan işleminden ayrı bir işlemde çalıştığından, ASP.NET Core modülü işlem 
yönetimini işler. Modül, ilk istek ulaştığında ASP.NET Core uygulama için işlemi başlatır ve kapanırsa veya 
kilitlenirse uygulamayı yeniden başlatır. Bu aslında, VVİndovvs İşlem etkinleştirme hizmeti (vvas)tarafından 
yönetilen işlem içi uygulamalarla birlikte görülen davranışdır. 


Aşağıdaki diyagramda IIS, ASP.NET Core modülü ve işlem dışı barındırılan bir uygulama arasındaki ilişki 
gösterilmektedir: 


Internet 

Û 



İstekler Web 'den çekirdek modu HTTP, sys sürücüsüne ulaşır.Sürücü, istekleri Web sitesinin yapılandırılmış 
bağlantı noktasında IIS 'ye yönlendirir, genellikle 80 (HTTP) veya 443 (HTTPS). Modül, 80 veya 443 numaralı 
bağlantı noktası olmayan uygulama için rastgele bir bağlantı noktasında istekleri Kestrel 'e iletir. 

Modül, başlangıç sırasında bir ortam değişkeni aracılığıyla bağlantı noktasını belirtir ve UselISIntegration 
uzantısı sunucuyu http://iocaihost:{PORT} dinlemek üzere yapılandırır. Ek denetimler gerçekleştirilir ve 
modülünden kaynaklanmayan istekler reddedilir. Modül HTTPS iletmeyi desteklemez, bu nedenle istekler 
HTTPS üzerinden IIS tarafından alınsa bile HTTP üzerinden iletilir. 

Kestrel, isteği modülden başlattıktan sonra, istek ASP.NET Core ara yazılım ardışık düzenine gönderilir. Ara 
yazılım ardışık düzeni isteği işler ve uygulamanın mantığına bir Httpcontext örneği olarak geçirir. IIS 
tümleştirmesi tarafından eklenen ara yazılım, isteği Kestrel iletmek için düzen, uzak İP ve pathbase 'i hesaba 
göre güncelleştirir. Uygulamanın yanıtı IIS 'e geri geçirilir ve bu, isteği başlatan HTTP istemcisine geri 
















gönderilir. 


ASP.NET Core, varsayılan, platformlar arası bir HTTP sunucusu olan Kestrel Serverile birlikte gönderilir. 

11S veya 11S Expresskullanırken, uygulama 11S çalışan işleminden (işlem dişi) Kestrel sunucusuile ayrı bir 
işlemde çalışır. 

ASP.NET Core uygulamalar MS çalışan işleminden ayrı bir işlemde çalıştığından, modül işlem yönetimini işler. 
Modül, ilk istek ulaştığında AS P.N ET Core uygulama için işlemi başlatır ve kapanırsa veya kilitlenirse 
uygulamayı yeniden başlatır. Bu aslında, Windows İşlem etkinleştirme hizmeti (vvas)tarafından yönetilen işlem 
içi uygulamalarla birlikte görülen davranışdır. 

Aşağıdaki diyagramda MS, ASP.NET Core modülü ve işlem dışı barındırılan bir uygulama arasındaki ilişki 
gösterilmektedir: 


HTTP 



IIS 
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(w3wp.exe) 

HTTP h 

ASP.NET Core Modüle 
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http://contoso.com 


ASP.NET Core application 
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Kestrel HttpContext Application code 

+ GD *-* 

http^/loca Ihost 1234 


İstekler Web 'den çekirdek modu HTTP, sys sürücüsüne ulaşır.Sürücü, istekleri Web sitesinin yapılandırılmış 
bağlantı noktasında 11S 'ye yönlendirir, genellikle 80 (HTTP) veya 443 (HTTPS). Modül, 80 veya 443 numaralı 
bağlantı noktası olmayan uygulama için rastgele bir bağlantı noktasında istekleri Kestrel 'e iletir. 

Modül, başlangıç sırasında bir ortam değişkeni aracılığıyla bağlantı noktasını belirtir ve 1 1S tümleştirme ara 
yazılımı sunucuyu http://iocaihost:{port} dinlemek üzere yapılandırır. Ek denetimler gerçekleştirilir ve 
modülünden kaynaklanmayan istekler reddedilir. Modül HTTPS iletmeyi desteklemez, bu nedenle istekler 
HTTPS üzerinden 11S tarafından alınsa bile HTTP üzerinden iletilir. 

Kestrel, isteği modülden başlattıktan sonra, istek ASP.NET Core ara yazılım ardışık düzenine gönderilir. Ara 
yazılım ardışık düzeni isteği işler ve uygulamanın mantığına bir Httpcontext örneği olarak geçirir. 11S 
tümleştirmesi tarafından eklenen ara yazılım, isteği Kestrel iletmek için düzen, uzak İP ve pathbase 'i hesaba 
göre güncelleştirir. Uygulamanın yanıtı MS 'e geri geçirilir ve bu, isteği başlatan HTTP istemcisine geri 
gönderilir. 

createDefaultBuiider , Web sunucusu olarak Kestrel sunucusunu yapılandırır ve AS P.N ET Core modülüiçin 
temel yolu ve bağlantı noktasını yapılandırarak MS tümleştirmesini mümkün yapar. 

ASP.NET Core modülü, arka uç işlemine atanacak dinamik bir bağlantı noktası oluşturur. 

CreateDefaultBuiider UsellSIntegration yöntemini çağırır. ıiseiısintegration , Kestrel 'yi localhost İP 
adresinde ( 127.0.0.1 ) dinamik bağlantı noktasında dinleyecek şekilde yapılandırır. Dinamik bağlantı noktası 
1234 ise, Kestrel 127.0.0.1:1234 dinler. Bu yapılandırma tarafından belirtilen diğer URL yapılandırmalarının 
yerini alır: 

• UseUrls 

• Kestrel'in dinleme API'SI 

• Yapılandırma (veya komut satırı—URL seçeneği) 

Modül kullanılırken useuris veya Kestrel'un Listen API'sine yapılan çağrılar gerekli değildir, useuris veya 
üsten çağrılırsa, Kestrel yalnızca uygulamayı IIS olmadan çalıştırırken belirtilen bağlantı noktasını dinler. 

ASP.NET Core modülü yapılandırma kılavuzu için bkz. ASP.NET Core Modülü. 

Barındırma hakkında daha fazla bilgi için bkz. ASP.NET Core ana bilgisayar. 

Uygulama yapılandırması 

lısıntegration bileşenlerini etkinleştirin 
















Tipik bir program.es , IIS ile tümleştirmeyi sağlayan bir konak ayarlamaya başlamak için CreateDefaultBuilder 
çağırır: 

public static IVdebHostBuilder CreateWebHostBuilder(string[] args) => 

VdebHost .CreateDefaultBuilder(args) 

IIS seçenekleri 

İşlem içi barındırma modeli 

IIS sunucu seçeneklerini yapılandırmak için ConfigureServicesllSServerOptions için bir hizmet yapılandırması 
ekleyin. Aşağıdaki örnek, Automatıcauthentication 'ı devre dışı bırakır: 

Services.Configure<IISServerOptions>(options => 

{ 

options .AutomaticAuthentication = false; 

}); 


SEÇENEK 


VARSAYILAN 


AYAR 


AutomaticAuthentication true true , IIS sunucusu, Windows kimlik 

doğrulamasıtarafından kimliği 
doğrulanmış HttpContext.User 
ayarlar, false , sunucu yalnızca 
HttpContext.User için bir kimlik 


sağlar ve AuthenticationScheme 
tarafından açıkça istendiğinde 
güçlüklere yanıt verir. 
AutomaticAuthentication çalışması 


için IIS 'de Windows kimlik 
doğrulamasının etkinleştirilmesi 
gerekir. Daha fazla bilgi için bkz. 
Windows kimlik doğrulaması. 


AuthenticationDisplayName null 


Oturum açma sayfalarındaki 
kullanıcılara gösterilen görünen adı 
ayarlar. 


AllowSynchronousIO 


false 


HttpContext.Request 

ve 



HttpContext.Response 

için zaman 


uyumlu GÇ izin verilip verilmeyeceğini 
belirtir. 











SEÇENEK 


VARSAYILAN 


AYAR 


MaxRequestBodySize 30000000 HttpRequest için en büyük istek 

gövdesi boyutunu alır veya ayarlar. IIS 
nin 

IlSServerOptions''MaxRequestBodySize 
ayarlamadan önce işlenecek sınır 
maxAllowedContentLength sahip 
olduğunu unutmayın. 

MaxRequestBodySize değiştirmek 
maxAllowedContentLength etkilemez. 
maxAllowedContentLength artırmak 
için, VVeb. config dosyasına daha 
yüksek bir değere 
maxAllowedContentLength 
ayarlamak üzere bir giriş ekleyin. Daha 
fazla ayrıntı için bkz. yapılandırma. 


İşlem dışı barındırma modeli 

SEÇENEK VARSAYILAN AYAR 


AutomaticAuthentication true true , 11S sunucusu, Windows kimlik 

doğrulamasıtarafından kimliği 
doğrulanmış HttpContext.User 
ayarlar, faise , sunucu yalnızca 
HttpContext. User için bir kimlik 


sağlar ve AuthenticationScheme 
tarafından açıkça istendiğinde 
güçlüklere yanıt verir. 
AutomaticAuthentication çalışması 


için IIS 'de Windows kimlik 
doğrulamasının etkinleştirilmesi 
gerekir. Daha fazla bilgi için bkz. 
Windows kimlik doğrulaması. 


AuthenticationDisplayName null 


Oturum açma sayfalarındaki 
kullanıcılara gösterilen görünen adı 
ayarlar. 


İşlem dışı barındırma modeli 

MS seçeneklerini yapılandırmak için ConfigureServicesIlSOptions için bir hizmet yapılandırması ekleyin. 
Aşağıdaki örnek, uygulamanın Httpcontext.connection.ciientcertificate doldurmasını engeller: 

Services.Configure<IISOptions>(options => 

{ 

options.ForwardClientCertificate = faise; 

}); 


SEÇENEK 


VARSAYILAN 


AYAR 















SEÇENEK 


VARSAYILAN 


AYAR 


Automatic Aut hentica t ion true true , IIS tümleştirme ara yazılımı 

Windows kimlik 
doğrulamasıtarafından kimliği 
doğrulanmış HttpContext.User 
ayarlar, faise , ara yazılım yalnızca 
HttpContext.User bir kimlik sağlar 


ve AuthenticationScheme tarafından 
açıkça istendiğinde güçlüklere yanıt 
verir. AutomaticAuthentication 
çalışması için IIS 'de Windows kimlik 
doğrulamasının etkinleştirilmesi 
gerekir. Daha fazla bilgi için Windows 
kimlik doğrulaması konusuna bakın. 


AuthenticationDisplayName null 


Oturum açma sayfalarındaki 
kullanıcılara gösterilen görünen adı 
ayarlar. 


ForwardClientCertificate 


true 


true 


MS-ASPNETCORE-CLIENTCERT istek 


üst bilgisi varsa 

HttpContext.Connection.ClientCertificat6 
doldurulur 


Proxy sunucusu ve yük dengeleyici senaryoları 

İletilen üstbilgiler ara yazılımını yapılandıran IIS tümleştirme ara yazılımıve ASP.NET Core modülü, DÜZENİ 
(http/https) ve isteğin KAYNAKLANDıĞı uzak İP adresini iletecek şekilde yapılandırılmıştır. Ek proxy 
sunucularının ve yük dengeleyiciler arkasında barındırılan uygulamalar için ek yapılandırma gerekebilir. Daha 
fazla bilgi için bkz. proxy sunucularıyla ve yük dengeleyicilerle çalışacak ASP.NET Core yapılandırma. 

Web. config dosyası 

Web. config dosyası ASP.NET Core modülünüyapılandırır. Web. config dosyası oluşturma, dönüştürme ve 
yayımlama, proje yayımlandığında bir MSBuild hedefi ( _Transformwebconfig ) tarafından işlenir.Bu hedef, Web 
SDK hedeflerinde ( Microsoft. net. sdk.web ) bulunur.SDK proje dosyasının en üstünde ayarlanır: 

<Project Sdk="Microsoft.NET.Sdk.Web"> 

Bir Web. config dosyası projede yoksa, dosya ASP.NET Core modülünü yapılandırmak İçin doğru processPath 
ve bağımsız değişkenlerle oluşturulur ve yayımlanan çıktıyataşınır. 

Projede bir Web. config dosyası varsa, dosya AS P.N ET Core modülünü yapılandırmak ve yayımlanan çıktıya 
taşınmak İçin doğru processPath ve bağımsız değişkenlerle birlikte dönüştürülür. Dönüştürme, dosyadaki IIS 
yapılandırma ayarlarını değiştirmez. 

Web. config dosyası, etkin IIS modüllerini DENETLEYEN ek IIS yapılandırma ayarları verebilir.ASP.NET Core 
uygulamalarla istekleri işleyebilen IIS modülleri hakkında daha fazla bilgi için bkz. IIS modules konusu. 

Web SDK 'sının Web. config dosyasını dönüştürmasını engellemek için, proje dosyasında 

•cıstransformvvebconfigdisabled > özelliğini kullanın: 

<PropertyGroup> 

<IsTransformWebConfigDisabled>true</IsTransformWebConfigDisabled> 

</PropertyGroup> 













Web SDK 'sının dosyayı dönüştürmesiyle devre dışı bırakıldığında , processPath ve bağımsız değişkenler 
geliştirici tarafından el ile ayarlanmalıdır. Daha fazla bilgi için bkz. AS P.N ET Core Modülü. 

Web. config dosyası konumu 

ASP.NET Core modülünü doğru bir şekilde ayarlamak için, Web. config dosyası dağıtılan uygulamanın içerik 
kök yolunda (genellikle uygulama temel yolu) bulunmalıdır. Bu, 11S 'ye sunulan Web sitesi fiziksel yoluyla aynı 
konumdadır. Web Dağıtımı kullanarak birden çok uygulama yayımlamayı etkinleştirmek için uygulamanın 
kökünde Web. config dosyası gereklidir. 

Uygulamanın fiziksel yolunda ( <derlemesi >. runtimeconfig. JSON, <bütünleştirilmiş kod >. xml (XML belge 
açıklamaları) ve <derlemesi >. Deps. JSONglbi hassas dosyalar bulunur. Web. config dosyası mevcut 
olduğunda ve site normal olarak başlatıldığında, istenirse 11S bu hassas dosyaları sunmaz. Web. config dosyası 
eksikse, yanlış şekilde adlandırılmış veya site normal başlatma için YAP 1 LAND 1 R 1 M 1 ŞSA 11S hassas dosyalara 
genel olarak sunabilir. 

Web. config dosyasının her zaman dağıtımda mevcut olması, doğru şekilde adlandırılması ve siteyi 
normal başlangıç için yapılandırabiliyor olması gerekir. Web. config dosyasını bir üretim 
dağıtımından hiçbir şekilde kaldırmayın. 

VVeb.config'i dönüştürme 

Yayımlama sırasında Web. config ' i dönüştürmeniz gerekiyorsa (örneğin, yapılandırma, profil veya ortama 
göre ortam değişkenlerini ayarlayın), bkz. VVeb.config'i dönüştürme. 


IIS yapılandırması 

Windows Server işletim sistemleri 

Web sunucusu (IIS) sunucu rolünü etkinleştirin ve rol hizmetleri oluşturun. 

1 . Yönet menüsündeki rol ve özellik ekleme sihirbazı ' nı veya Sunucu Yöneticisibağlantısındaki 
bağlantıyı kullanın. Sunucu rolleri adımında, Web sunucusu (IIS) kutusunu işaretleyin. 


Add Roles and Features VVizard 


□ X 


Select server roles 


DESTİNATION SERVER 


Before You Begir 


Select one or more roles to install on the selected server. 


Installation Type Roles 


Description 


Server Selection 


Server Roles 


Features 

Web Server Role (IIS) 
Role Services 
Confirmation 


|_| Active Directory Lightweight Directory Services 

I I Active Directory Rights Management Services 
I I Device Health Attestation 
I I DHCP Server 

□ DNS Server 
1 I Fax Server 

W File and Storage Services (1 of 12 installed) 

I I Hoşt Guardian Service 

□ Hyper-V 

I I MultiPoint Services 
I I Netvvork Controller 
I I Netvvork Policy and Access Services 
I I Print and Document Services 
I I Remote Access 
I I Remote Desktop Services 
n Volu ne Activatio n Services 


eb Server (IIS 


w SZ 

_| Windows Deployment Services 
I I Windows Server Essentials Experience 
I I Windows Server Update Services 


Web Server (IIS) provides a reliable, 
manageable, and scalabie Web 
application infrastructure. 


< Previous 


Next > 


İnstall 


Cancel 


2. Özellikler adımından sonra, Web sunucusu (IIS) için rol hizmetleri adımı yüklenir, istenen IIS rol 
hizmetlerini seçin veya varsayılan rol hizmetlerini kabul edin. 





















İL Add Roles and Features VVizard 


□ X 


Select role Services 


DESTİNATION SERVER 


Befcre You Begin 
Installatîon Type 
Server Selection 
Server Roles 


Select the role Services to install for Web Server (IIS) 


Role Services 


Description 


•* 0 MJ-nm 


^ 0 Common HTTP Features 
0 Default Document 
0 Directory Browsing 
0 HTTP Errors 
0 Static Content 
I I HTTP Redirection 
I I VVebDAV Publishing 


A 


Web Server provides support for 
HTML Web sites and opbonal 
support for ASP.NET, ASP, and Web 


Features 


server extensions. You can use the 
Web Server to hoşt an internal or 
extemal Web site or to provide an 
environment for developers to 


Web Server Role (IIS) 




a |7] Health and Diagnostics 
171 HTTP Loggîng 
I I Custom Logging 
I I Logging Tools 
I I ODBC Logging 
I I Request Monitor 
I I Tracing 


* [7] Performance 

71 Static Content Compression 
I I Dynamic Content Compression 


* 7 Securitv 


| < Previous | Next >*^ İnstall | Cancel 


Windows kimlik doğrulaması (İsteğe bağlı) 

Windows kimlik doğrulamasını etkinleştirmek için şu düğümleri genişletin: Web sunucusu > 
güvenliği. Windows kimlik doğrulama özelliğini seçin. Daha fazla bilgi için bkz. Windows kimlik 
doğrulaması <windowsAuthentication > veVVİndovvs kimlik doğrulamasını yapılandırma. 

WebSockets (İsteğe bağlı) 

VVebSockets ASP.NET Core 1,1 veya üzeri bir sürümde desteklenir.VVebSockets etkinleştirmek için şu 
düğümleri genişletin: Web sunucusu > uygulama geliştirme. VVebSocket protokolü özelliğini 
seçin. Daha fazla bilgi için bkz. VVebSockets. 

3. VVeb sunucusu rolü ve hizmetlerini yüklemek için onay adımına ilerleyin. Web sunucusu (IIS) rolü 
yüklendikten sonra sunucu/IIS yeniden başlatması gerekli değildir. 

Windows masaüstü işletim sistemleri 

IIS Yönetim Konsolu ve World Wide VVeb hizmetlerinietkinleştirin. 

1. > programlar ve Özellikler > Programlar ve Özellikler \*e gidin >\* Windows özelliklerini açın 
veya kapatın (ekranın sol tarafında). 

2. Internet Information Services düğümünü açın. VVeb yönetimi araçları düğümünü açın. 

3. IIS Yönetim Konsolukutusunu işaretleyin. 

4. VVorld VVide VVeb Hizmetlerikutusunu işaretleyin. 

5. VVorld VVide VVeb Hizmetleri için varsayılan özellikleri kabul edin veya IIS özelliklerini özelleştirin. 

VVindovvs kimlik doğrulaması (İsteğe bağlı) 

VVİndovvs kimlik doğrulamasını etkinleştirmek için şu düğümleri genişletin: VVorld VVide VVeb 
hizmetleri > güvenlik. VVindovvs kimlik doğrulama özelliğini seçin. Daha fazla bilgi için bkz. 

VVindovvs kimlik doğrulaması <windowsAuthentication > veVVİndovvs kimlik doğrulamasını 
yapılandırma. 


VVebSockets (İsteğe bağlı) 

VVebSockets ASP.NET Core 1,1 veya üzeri bir sürümde desteklenir.VVebSockets etkinleştirmek için şu 


















düğümleri genişletin: World Wide Web hizmetleri > uygulama geliştirme özellikleri. VVebSocket 
protokolü özelliğini seçin. Daha fazla bilgi için bkz. VVebSockets. 

6. 11S yüklemesi için yeniden başlatma gerekiyorsa, sistemi yeniden başlatın. 


Windows Features 


Turn Windows features on or off 


□ 


X 


To turn a feature on, select its check box. To turn a feature off, clear its 
check box. A filled box means that only part of the feature is turned on. 


.NET Framevvork 3.5 (includes .NET 2.0 and 3.( 


El H 

0 ® .NET Framevvork 4.6 Advanced Services 

I~1 Active Directory Lightweight Directory Services 
□ □ Embedded Shell Launcher 
+ □ Hyper-V 
03 Internet Explorer 11 
B ® Internet Information Services 
0 O FTP Server 
0 ® Web Management Tools 

El, NS 6 Manacjement_Com£atibility 
|0^^ll£Management^ConsoleJ 
I I , IIS Management Scripts and Tools 
^^^__IIŞ_Mana2ementŞemce 

0 ® Application Development Features 
0 SU Common HTTP Features 

0 ® Health and Diagnostics 

0 ® Performance Features 

0 ® Security 

nrı Internet Information Servires Ho«;tahle Weh fore 


.NET Core barındırma paketi 'ni yükler 

.NET Core barmchrma paketi 'ni barındırma sistemine yükler. Paket, .N ET Core çalışma zamanı, .N ET Core 
kitaplığı veASP.NET Core modülünüde yüklüyor. Modül ASP.NET Core uygulamaların IIS 'nin arkasında 
çalışmasına izin verir. 


IMPORTANT 

Barındırma paketi IIS 'den önce yüklendiyse, paket yüklemesi onarılması gerekir. IIS yükledikten sonra barındırma paketi 
yükleyicisini yeniden çalıştırın. 

.NET Core 'un 64 bit (x64) sürümünü yükledikten sonra barındırma paketi yüklenirse, SDK 'lar eksik gibi görünebilir 
(hiçbir .NET Core SDK 'sı algılanmadı). Sorunu çözmek için bkz. ASP.NET Core projeleri sorunlarını giderme. 


Doğrudan indirme (geçerli sürüm) 

Aşağıdaki bağlantıyı kullanarak yükleyiciyi indirin: 

Geçerli .NET Core barındırma paketi yükleyicisi (doğrudan indirme) 

Yükleyicinin önceki sürümleri 

Yükleyicinin önceki bir sürümünü elde etmek için: 

1. .Net indirme arşivleri' ne gidin. 

2. .N ET Corealtında .N ET Core sürümünü seçin. 

3. Uygulamaları Çalıştmçalışma zamanı sütununda, İstenen .NET Core çalışma zamanı sürümünün 
satırını bulun. 

4. Çalışma zamanı & barındırma paketi bağlantısını kullanarak yükleyiciyi indirin. 



















VVARNING 

Bazı yükleyicilerle yaşam süresi (EOL) gelmiş olan ve artık Microsoft tarafından desteklenmeyen yayın sürümlerini içerir. 
Daha fazla bilgi için bkz. destek ilkesi. 


Barındırma paketini yükler 

1. Yükleyiciyi sunucuda çalıştırın. Aşağıdaki parametreler, yükleyiciyi yönetici komut kabuğu 'ndan 
çalıştırırken kullanılabilir: 

• ASP.NET Core modülünü yüklemeyi opt_no_ancm=i -atlayın. 

• .NET Core çalışma zamanını yüklemeyi opt_no_runtime=i - atlayın. Sunucu yalnızca kendi kendine 
içerilen dağıtımları (SCD)barındırdığınızda kullanılır. 

• ASP.NET paylaşılan çerçevesini yüklemeyi opt_no_sharedfx=i - atlayın (ASP.N ET Runtime). 

Sunucu yalnızca kendi kendine içerilen dağıtımları (SCD)barındırdığınızda kullanılır. 

• opt_no_x86=i - x86 çalışma zamanları yüklemeyi atlayın. 32 bitlik uygulamalar 
barındırmayabildiğinizi bildiğiniz durumlarda bu parametreyi kullanın. Gelecekte 32-bit ve 64 bit 
uygulamaları barındırabilmeniz gereken herhangi bir şansınız varsa, bu parametreyi kullanmayın ve 
her iki çalışma zamanını da yüklemeyin. 

• opt_imo_shared_config_check=i -, paylaşılan yapılandırma ( ApplicationHost. config) 11S yüklemesiyle 
aynı MAKİNELİ olduğunda MS paylaşılan yapılandırması kullanma denetimini devre dışı bırakır. 

Yalnızca ASP.NET Core 2,2 veya sonraki bir sürümü Paketcisiyükleyicilerini barındırmak için 
kullanılabilir. Daha fazla bilgi için bkz.ASP.NET Core Modülü. 

2. Sistemi yeniden başlatın veya komut kabuğu 'nda aşağıdaki komutları yürütün: 

net stop was /y 
net start w3svc 

11S 'nin yeniden başlatılması, yükleyici tarafından oluşturulan bir ortam değişkeni olan sistem yolunda 
bir değişiklik seçer. 

ASP.NET Core, paylaşılan çerçeve paketlerinin yama sürümleri için geri iletme davranışını benimsemez. Yeni 
bir barındırma paketi yükleyerek paylaşılan çerçeveyi yükselttikten sonra, sistemi yeniden başlatın veya komut 
kabuğu 'nda aşağıdaki komutları yürütün: 

net stop was /y 
net start w3svc 

Barındırma paketini yüklerken IIS 'deki bireysel siteleri el ile durdurmanız gerekli değildir.Barındırılan 
uygulamalar (IIS siteleri) IIS yeniden başlatıldığında yeniden başlatılır. Uygulamalar, uygulama başlatma 
modülündenda dahil olmak üzere ilk isteklerini alırken yeniden başlatılır. 

ASP.NET Core, paylaşılan çerçeve paketlerinin yama sürümleri için ileri sarma davranışını benimseme. IIS ile 
IIS tarafından barındırılan uygulamalar IIS ile yeniden başlatıldığında, ilk isteklerini alırken başvurulan 
paketlerinin en son düzeltme eki sürümleriyle yüklenir. IIS yeniden başlatılırsa, uygulamalar yeniden başlatılır 
ve çalışan işlemlerine geri dönüştürüldüğünde geri alma davranışını gösterir ve ilk isteklerini alırlar. 


NOTE 

IIS paylaşılan Yapılandırması hakkında bilgi için bkz. IIS paylaşılan yapılandırması ile ASP.NET Core modülü. 


Visual Studio ile yayımlarken Web Dağıtımı yüklemesi 













Uygulamaları Web dağıtımıolan sunuculara dağıttığınızda, en son Web dağıtımı sürümünü sunucuya 
yüklersiniz. Web Dağıtımı yüklemek için Web Platformu Yükleyicisi'ni (VVebPI) kullanın veya doğrudan 
Microsoft indirme Merkezi'nden bir yükleyici edinin. Tercih edilen yöntem, VVebPI kullanmaktır. VVebPI, 
barındırma sağlayıcıları için tek başına kurulum ve yapılandırma sağlar. 


IIS sitesini oluşturma 

1. Barındırma sisteminde, uygulamanın yayımlanan klasörlerini ve dosyalarını içeren bir klasör oluşturun. 
Aşağıdaki adımda, klasörün yolu, uygulamanın fiziksel yolu olarak IIS 'ye sağlanır.Uygulamanın 
dağıtım klasörü ve dosya düzeni hakkında daha fazla bilgi için bkz. ASP.NET Core dizin yapısı. 

2. IIS Yöneticisi 'nde, Bağlantılar panelinde sunucunun düğümünü açın. Siteler klasörüne sağ tıklayın. 
Bağlamsal menüden Web sitesi Ekle ' yi seçin. 


3. Bir site adı belirtin ve fiziksel yolu uygulamanın dağıtım klasörüne ayarlayın. Bağlama 
yapılandırmasını sağlayın ve Tamam' ı seçerek VVeb sitesini oluşturun: 


Add VVebsite 


? X 


Site name: 


www mysite com 


www_mysite_com 


Select... 


Content Directory 
Physical path: 
F:\www_mysite_com 
Pass-through authentication 


Connect as... 


Test Settings... 


Binding 

Type: İP address: Porfc 


http 


V 


Ali Unassigned 


V 


80 


Hoşt name: 
www.mysite.com 


Example: www.contoso.com or marketing.contoso.com 


0 Start VVebsite immediately 


OK 


Cancel 


VVARNING 

Üst düzey joker karakter bağlamaları ( http://*: 80 / ve http ://+:80 ) kullanılmamalıdır. Üst düzey joker 
karakter bağlamaları, uygulamanızı güvenlik açıklarına açabilir. Bu hem güçlü hem de zayıf Joker karakterlere 
yöneliktir. Joker karakterler yerine açık ana bilgisayar adları kullanın. Alt etki alanı joker karakteri bağlama 
(örneğin, *. mysub.com ), tüm üst etki alanını (güvenlik açığı olan *.com aksine) kontrol ediyorsanız bu güvenlik 
riskine sahip değildir. Daha fazla bilgi için bkz. rfc7230 Section-5,4 . 


4. Sunucu düğümünün altında uygulama havuzları' nı seçin. 

5. Sitenin uygulama havuzuna sağ tıklayın ve bağlam menüsünden temel ayarlar ' ı seçin. 

6. Uygulama havuzunu Düzenle penceresinde, .N ET CLR sürümünü yönetilen kod 

olmadanayarlayın: 






















































Edit Application Pool 


? X 


www_mysite_com 
■NET CLR version: 

No Managed Code v 


Managed pipeline mode: 
Integrated v 


1^1 Start application pool immediately 


OK 


Cancel 


ASP.NET Core ayrı bir işlemde çalışır ve çalışma zamanını yönetir.ASP.N ET Core, masaüstü CLR 'nin 
(.NET CLR) yüklenmemesine—.NET Core için çekirdek ortak dil çalışma zamanı (CoreCLR), 
uygulamayı çalışan işlemde barındırmak için önyüklenir. .NET CLR sürümünün yönetilen kod 
olmadan ayarlanması isteğe bağlıdır, ancak önerilir. 

7. ASP.NET Core 2,2 veya üzeri: işlem içi barındırma modelinikullanan 64 bit (x64) tabanlı bir dağıtım için, 
32-bit (x86) işlemleri için uygulama havuzunu devre dışı bırakın. 

11S Yöneticisi > uygulama havuzlarının Eylemler kenar çubuğunda, uygulama havuzu 
varsayılanlarını veya Gelişmiş ayarlarıayarla ' yı seçin. 32 bitlik uygulamaları etkinleştir ' i bulun 
ve değeri Faise olarak ayarlayın. Bu ayar, işlem dışı barındırmaiçin dağıtılan uygulamaları etkilemez. 

8. işlem modeli kimliğinin uygun izinlere sahip olduğunu doğrulayın. 

Uygulama havuzunun varsayılan kimliği (İşlem modeli > kimliği), applicationpokaydentity 'den 
başka bir kimliğe değiştiyse, yeni kimliğin uygulamanın klasörüne, veritabanına ve diğer gerekli 
kaynaklara erişmek için gerekli izinlere sahip olduğunu doğrulayın. Örneğin, uygulama havuzu, 
uygulamanın dosyaları okuduğu ve yazdığı klasörlere okuma ve yazma erişimi gerektirir. 

Windows kimlik doğrulama yapılandırması (İsteğe bağlı) 

Daha fazla bilgi için bkz. Windows kimlik doğrulamasını yapılandırma. 

Uygulamayı dağıtma 

Uygulamayı 11S sitesi oluşturma bölümünde oluşturulan IIS fiziksel yol klasörüne dağıtın. Web dağıtımı 
dağıtım için önerilen mekanizmadır, ancak uygulamayı projenin Publish klasöründen barındırma sisteminin 
dağıtım klasörüne taşımak için çeşitli seçenekler mevcuttur. 

Visual Studio ile Web Dağıtımı 

Web Dağıtımı kullanılacak bir yayımlama profili oluşturma hakkında bilgi edinmek için bkz. AS P.N ET Core 
App Deployment İçin Visual Studio yayımlama profilleri konusuna bakın. Barındırma sağlayıcısı, bir 
yayımlama profili veya oluşturma desteği sağlıyorsa, profilini indirin ve Visual Studio Yayımlama iletişim 
kutusunu kullanarak içeri aktarın: 
























Overvievv 


Publish 


Connected Services 


Publish 


Publish your app to Azure or another hoşt. Learn more 


< 


D m 

ti 

IIS, FTP, ete Folder 

Import profile i 

Publish 


> 


Visual Studio dışında Web Dağıtımı 

Web dağıtımı , komut satırından Visual Studio dışında da kullanılabilir. Daha fazla bilgi için bkz. Web Dağıtım 
aracı. 

Web Dağıtımı alternatifleri 

Uygulamayı barındırma sistemine taşımak için el ile kopyalama, xcopy, Robocopyveya PovverShelIgibi çeşitli 
yöntemlerden birini kullanın. 

IIS 'y e dağıtım ASP.NET Core hakkında daha fazla bilgi için, 1 1S yöneticileri İçin dağıtım kaynakları bölümüne 
bakın. 

Web sitesine gidin 

Uygulama barındırma sistemine dağıtıldıktan sonra, uygulamanın genel uç noktalarından birine bir istek 
oluşturun. 

bağlantı noktası se www.mysite.com IIS ana bilgisayar adına bağlıdır, 
bir istek yapıldı: 


Aşağıdaki örnekte site, 
http://www.mysite.com 



















Kilitli dağıtım dosyaları 

Dağıtım klasöründeki dosyalar, uygulama çalışırken kilitlenir.Dağıtım sırasında kilitli dosyaların üzerine 
yazılamaz. Kilitli dosyaları bir dağıtımda serbest bırakmak için aşağıdaki yaklaşımlardan birini kullanarak 
uygulama havuzunu durdurun: 

• Proje dosyasında Web Dağıtımı ve başvuru Microsoft. net. sdk.web kullanın. Bir app_offline.htm 
dosyası Web uygulaması dizininin köküne yerleştirilir. Dosya olduğunda, AS P.N ET Core modülü 
uygulamayı düzgün bir şekilde kapatır ve dağıtım sırasında app_offline. htm dosyasına hizmet verir. 
Daha fazla bilgi için ASP.NET Core modülü yapılandırma başvurusunabakın. 

• Sunucu üzerindeki 11S Yöneticisi 'nde uygulama havuzunu el ile durdurun. 

• App_offline. htm dosyasını bırakmak için PovverShell kullanın (PovverShell 5 veya üzerini gerektirir): 

JpathToApp = ’PATH_TO_APP' 

# Stop the AppPool 

New-Item -Pattı ŞpathToApp app_offline.htm 

# Provide script commands here to deploy the app 

# Restart the AppPool 

Remove-Item -Path JpathToApp app_offline.htm 


Veri koruma 

ASP.NET Core veri koruma yığını , kimlik doğrulamasında kullanılan ara yazılımlar dahil olmak üzere birkaç 
ASP.NET Core middlevvarestarafından kullanılır. Veri koruma API 'Leri Kullanıcı kodu tarafından çağrılmasa 
bile, kalıcı bir şifreleme anahtarı deposuoluşturmak için veri koruma bir dağıtım betiği veya Kullanıcı kodu ile 








yapılandırılmalıdır. Veri koruması yapılandırılmamışsa, anahtarlar bellekte tutulur ve uygulama yeniden 
başlatıldığında atılır. 

Uygulama yeniden başlatıldığında anahtar halkası bellekte depolanıyorsa: 

• Tüm tanımlama bilgisi tabanlı kimlik doğrulama belirteçleri geçersiz kılınır. 

• Kullanıcıların bir sonraki isteğinde yeniden oturum açması gerekir. 

• Anahtar halkası ile korunan tüm veriler artık çözülemez. Bu, CSRF belirteçlerini ve ASP.NET Core MVC 
TempData tanımlama bilgileriniiçerebilir. 

Anahtar halkasını sürdürmek için 11S altındaki veri korumasını yapılandırmak için aşağıdaki yaklaşımlardan 
birini kullanın: 

• Veri koruma kayıt defteri anahtarları oluşturma 

AS P.N ET Core uygulamalar tarafından kullanılan veri koruma anahtarları, uygulamaların dış kayıt 
defterinde saklanır. Belirli bir uygulamanın anahtarlarını kalıcı hale getirmek için, uygulama havuzu için 
kayıt defteri anahtarları oluşturun. 

Tek başına, Web grubu olmayan 11S yüklemeleri için Data Protection provision-AutoGenKeys. psl 
PovverShell betiği , bir ASP.NET Core uygulamasıyla kullanılan her uygulama havuzu için kullanılabilir. 
Bu betik, yalnızca uygulamanın uygulama havuzunun çalışan işlem hesabına erişilebilen HKLM Kayıt 
defterinde bir kayıt defteri anahtarı oluşturur. Anahtarlar, makine genelindeki bir anahtarla DPAPI 
kullanılarak şifrelenir. 

Web grubu senaryolarında bir uygulama, veri koruma anahtar halkasını depolamak için bir UNC yolu 
kullanacak şekilde yapılandırılabilir. Varsayılan olarak, veri koruma anahtarları şifrelenmez. Ağ 
paylaşımının dosya izinlerinin, uygulamanın çalıştırıldığı Windows hesabıyla sınırlı olduğundan emin 
olun. Bir x509 sertifikası, bekleyen anahtarları korumak için kullanılabilir. Kullanıcıların sertifikaları 
karşıya yüklemesine izin vermek için bir mekanizma düşünün: sertifikaları kullanıcının güvenilen 
sertifika deposuna yerleştir ve kullanıcının uygulamasının çalıştığı tüm makinelerde kullanılabilir 
olduklarından emin olun. Ayrıntılar için bkz. ASP.NET Core veri korumasını yapılandırma . 

• Kullanıcı profilini yüklemek için IIS uygulama havuzunu yapılandırma 

Bu ayar, uygulama havuzunun Gelişmiş ayarları altındaki işlem modeli bölümünde bulunur. 
Kullanıcı profilini True için Yükle ' ye ayarlayın. True olarak ayarlandığında anahtarlar Kullanıcı 
profili dizininde depolanır ve Kullanıcı hesabına özgü bir anahtarla DPAPI kullanılarak korunur. 
Anahtarlar % LocalAppData%/ASP.exe. net/DataProtection-Keys klasörüne kalıcıdır. 

Uygulama havuzunun Setprofileenvironment özniteliğinin de etkinleştirilmesi gerekir, 
set Prof ileEnvironment varsayılan değeri true . Bazı senaryolarda (örneğin, Windows işletim sistemi), 
set Prof ileEnvironment faise olarak ayarlanır. Anahtarlar beklenen şekilde Kullanıcı profili dizininde 
depolanmıyorsa: 

1. % Windir%/system32/inetsrv/config klasörüne gidin. 

2. ApplicationHost. config dosyasını açın. 


3. 

<system.applicationHostxapplicationPoolsxapplicationPoolDefaultsxprocessModel> 

öğesini bulun. 

4. 

setProfileEnvironment 

özniteliğinin mevcut olmadığını, bu değerin varsayılan olarak 

true veya 


özniteliğin değerini true olarak ayarlamış olduğunu doğrulayın. 


• Dosya sistemini anahtar halka deposu olarak kullanma 

Dosya sistemini anahtar halka deposu olarak kullanmakiçin uygulama kodunu ayarlayın. Anahtar 
halkasını korumak ve sertifikanın güvenilen bir sertifika olduğundan emin olmak için bir x509 
sertifikası kullanın. Sertifika kendinden imzalı ise, sertifikayı güvenilen kök depoya yerleştirin. 


IIS 'yi bir Web grubunda kullanırken: 




o Tüm makinelerin erişebileceği bir dosya paylaşma kullanın, 
o Her makineye bir x509 sertifikası dağıtın. Kodda veri korumasınıyapılandırın. 

• Veri koruma için makineye özel bir ilke ayarlama 

Veri koruma sistemi, veri koruma API 'Lerini kullanan tüm uygulamalar için varsayılan makine 
genelinde bir ilke ayarlamak için sınırlı destek içerir. Daha fazla bilgi için bkz. AS P.N ET Core veri 
koruması. 

Sanal dizinler 

11S sanal dizinleri ASP.NET Core uygulamalarla desteklenmez. Bir uygulama, bir alt uygulamaolarak 
barındırılabilir. 

Alt uygulamalar 

ASP.NET Core bir uygulama, bir 11S alt uygulaması (alt uygulama)olarak barındırılabilir. Alt uygulamanın yolu, 
kök uygulamanın URL 'sinin bir parçası haline gelir. 

Bir alt uygulama işleyici olarak ASP.NET Core modülünü içermemelidir. Modül bir alt uygulamanın Web. 
config dosyasına bir işleyici olarak eklenirse, alt uygulamaya gözatmaya çalışılırken hatalı yapılandırma 
dosyasına başvuran 500,19 iç sunucu hatasi alınır. 

Aşağıdaki örnek, bir ASP.NET Core alt uygulaması için yayımlanmış bir Web. config dosyası gösterir: 

<?xml version="1.0" encoding="utf-8"?> 

<configuration> 

<system.webServer> 

<aspNetCore processPath="dotnet" 
arguments=". \MyApp.dll" 
stdoutl_ogEnabled="false" 
stdoutLogFile=". \logs\stdout" /> 

</system.webServer> 

</configuration> 


Bir ASP.NET Core uygulamasının altında bir non-ASP.NET Core alt uygulaması barındırırken, alt 
uygulamanın Web. config dosyasında devralınan işleyiciyi açıkça kaldırın: 

<?xml version="1.0" encoding="utf-8"?> 

<configuration> 

<system.webServer> 

<handlers> 

cremove name="aspNetCore" /> 

</handlers> 

<aspNetCore processPath="dotnet" 
arguments=". \MyApp.dll" 
stdoutLogEnabled="false" 
stdoutLogFile=". \logs\stdout" /> 

</system.webServer> 

</configuration> 

Alt uygulama içindeki statik varlık bağlantıları, tilde işareti ( -/ ) gösterimini kullanmalıdır.Tilde işareti 
gösterimi, alt uygulamanın pathbase 'i işlenmiş göreli bağlantıya eklemek için bir etiket yardımcısını tetikler. 


/subapp_path bir alt uygulama için, 

src="~/image.png" 

ile bağlantılı bir görüntü 

src="/subapp_path/image.png" 


olarak işlenir. Kök uygulamanın statik dosya ara yazılımı statik dosya isteğini işlemez, istek, alt uygulamanın 
statik dosya ara yazılımı tarafından işlenir. 

Statik bir varlığın src özniteliği mutlak bir yola ayarlandıysa (örneğin, src="/image.png" ), bağlantı alt 
uygulamanın pathbase olmadan işlenir. Kök uygulamanın statik dosya ara yazılımı, statik varlık kök 








uygulamadan kullanılabilir olmadığı takdirde 404-buiunamayan bir Yanıt ile sonuçlanır. Bu, kök uygulamanın 
Web kökündenvarlık sunmaya çalışır. 

Bir ASP.NET Core uygulamasını başka bir ASP.NET Core uygulaması altında alt uygulama olarak 
barındırmak için: 

1. Alt uygulama için bir uygulama havuzu oluşturun. .N ET Core için çekirdek ortak dil çalışma zamanı 
(CoreCLR), uygulamayı masaüstü CLR (.NET CLR) değil, çalışan işlemde barındırmak için 
önyüklenirken .NET CLR sürümünü yönetilen kod olmadan ayarlayın. 

2. Kök siteyi, kök sitenin altındaki bir klasörde bulunan alt uygulamayla 11S Yöneticisi 'ne ekleyin. 

3. 11 S Yöneticisi 'ndeki alt uygulama klasörüne sağ tıklayın ve uygulamaya Dönüştür 1 ü seçin. 

4. Uygulama Ekle iletişim kutusunda, alt uygulama için oluşturduğunuz uygulama havuzunu atamak 
üzere uygulama havuzunun Seç düğmesini kullanın. Tamam ' ıseçin. 

Ayrı bir uygulama havuzunun alt uygulamaya atanması, işlem içi barındırma modelinin kullanıldığı bir 
gereksinimdir. 

işlem içi barındırma modeli ve ASP.NET Core modülünü yapılandırma hakkında daha fazla bilgi için bkz. 
ASP.NET Core Modülü. 

Web. config ile IIS yapılandırması 

MS yapılandırması, ASP.NET Core modüllü ASP.NET Core uygulamalar için işlevsel olan IIS senaryoları için 
Web. config 'in <system.webServer> bölümünden etkilenir. Örneğin, IIS yapılandırması dinamik sıkıştırma için 
işlevseldir. IIS sunucu düzeyinde dinamik sıkıştırma kullanmak üzere yapılandırıldıysa, uygulamanın Web. 
config dosyasındaki <uricompression> öğesi, ASP.NET Core bir uygulama için devre dışı bırakabilir. 

Daha fazla bilgi için aşağıdaki konulara bakın: 

• <System. vvebServer > için yapılandırma başvurusu 

• ASP.NET Core Modülü 

• ASP.NET Core içeren IIS modülleri 

Yalıtılmış uygulama havuzlarında çalışan ayrı uygulamalara yönelik ortam değişkenlerini ayarlamak için (IIS 
10,0 veya üzeri için desteklenir), IIS başvuru belgelerindeki ortam değişkenleri <environmentVariables > 
konusunun Appcmd. exe komut bölümüne bakın. 

Web. config 'in yapılandırma bölümleri 

Web. config dosyasındaki AS P.N ET 4. x uygulamalarının yapılandırma bölümleri yapılandırma için AS P.N ET 
Core uygulamalar tarafından kullanılmaz: 

• <system.web> 

• <appSettings> 

• <connectionStrings> 

• <location> 

ASP.NET Core uygulamalar diğer yapılandırma sağlayıcıları kullanılarak yapılandırılır.Daha fazla bilgi için bkz. 
yapılandırma. 

Uygulama Havuzları 

Uygulama havuzu yalıtımı, barındırma modeliyle belirlenir: 

• işlem içi barındırma - uygulamalar ayrı uygulama havuzlarında çalıştırmak için gereklidir. 



• işlem dışı barındırma her uygulamayı kendi uygulama havuzunda çalıştırarak uygulamaları birbirinden 
yalıtmayı öneririz. 

MS Web sitesi ekleme iletişim kutusu varsayılan olarak uygulama başına tek bir uygulama havuzu olur. Bir 
site adı sağlandığında, metin otomatik olarak uygulama havuzu metin kutusuna aktarılır. Site eklendiğinde 
site adı kullanılarak yeni bir uygulama havuzu oluşturulur. 

Bir sunucuda birden çok Web sitesi barındırırken, her uygulamayı kendi uygulama havuzunda çalıştırarak 
uygulamaları birbirinden yalıtmayı öneririz. MS Web sitesi ekleme iletişim kutusu varsayılan olarak bu 
yapılandırmaya sahiptir. Bir site adı sağlandığında, metin otomatik olarak uygulama havuzu metin kutusuna 
aktarılır. Site eklendiğinde site adı kullanılarak yeni bir uygulama havuzu oluşturulur. 

Uygulama Havuzu Kimliği 

Bir uygulama havuzu kimliği hesabı, bir uygulamanın etki alanı veya yerel hesap oluşturmak ve yönetmek 
zorunda kalmadan benzersiz bir hesap altında çalışmasına izin verir. MS 8,0 veya sonraki sürümlerde, MS 
Yönetici çalışan İşlemi (WAS), yeni uygulama havuzunun adıyla bir sanal hesap oluşturur ve varsayılan olarak 
bu hesap altında uygulama havuzunun çalışan işlemlerini çalıştırır. Uygulama havuzunun Gelişmiş ayarlar 
altındaki MS Yönetim Konsolu 'Nda, kimliğin applicationpokaydentitykullanılacak şekilde ayarlandığından 
emin olun: 


Advanced Settings 


? X 


V 

(General) 


A 


■NET CLRVersion 

No Managed Code 



Enable 32-Bit Applications 

False 



Managed Pipeline Mode 

Integrated 



Name 

DefaultAppPool 



Queue Length 

1000 



Start Mode 

OnDemand 


V 

CPU 




Limit (percent) 

0 


Limit Action 

NoAction 


Limit Interval (minutes) 

5 


Processor Affinity Enabled 

False 


Processor Affinity Mask 

4294967295 


Processor Affinity Mask (64-bit c 4294967295 

V 

Process Model 


> 

Generate Process Model Event L 



Identity 

ApplicationPool Identity 


İdle Time-out (minutes) 

20 


İdle Time-out Action 

Terminate 

V 

Identity 


[identityType, username, passvvord] Configures the application poolto run 
as built-in account, i.e. Application Pool Identity (recommended), Netvvork 
Service, Local System, Local Service, or as a specific user identity. 


OK 


Cancel 


MS Yönetim işlemi, VVİndovvs güvenlik sisteminde uygulama havuzunun adıyla güvenli bir tanımlayıcı 
oluşturur. Bu kimlik kullanılarak kaynakların güvenliği sağlanmış olabilir. Ancak, bu kimlik gerçek bir kullanıcı 
hesabı değildir ve VVİndovvs Kullanıcı Yönetimi konsolunda gösterilmez. 

MS çalışan işlemi uygulamaya yükseltilmiş erişim gerektiriyorsa, uygulamayı içeren dizinin Access Control 
listesini (ACL) değiştirin: 

1. VVİndovvs Gezgini'ni açın ve dizine gidin. 

2. Dizine sağ tıklayıp Özellikler 1 i seçin. 

3. Güvenlik sekmesinde, Düzenle düğmesini ve ardından Ekle düğmesini seçin. 


















4. Konumlar düğmesini seçin ve sistemin seçili olduğundan emin olun. 


5. MS AppPool\< app pool name > Seçilecek nesne adlarını girin alanına girin. Adları denetle 

düğmesini seçin. DefaultAppPool için IIS APPPOOL\DefaultAppPoolkullanarak adları denetleyin. 
Adları denetle düğmesi seçildiğinde, nesne adları alanında bir DefaultAppPool değeri gösterilir. 
Uygulama havuzu adının doğrudan nesne adları alanına girilmesi mümkün değildir.Nesne adı 
denetlenirken app_pool_name > biçim\< IIS AppPool ı kullanın. 


Select Users or Groups X 


Select this object type: 


Useıs. Groups. or Built-in security principals 

Object Types... 

From this location: 

CONTOSO-SERVEFt 

Locations... 


Biter the object names to select fexamples): 



Advanced.. 


OK 


Cancel 


Tamam ' ıseçin. 

Select Users or Groups 

X 


Select this object type: 




Users. Groups. or Built-in security principals 

Object Types... 



: rom this location: 




CONTOSO-SERVER 

Locations... 



Erıterthe obiect names to select (examples): 




PefaultADDPool 


Check Names 


Advanced.. 


OK 


Cancel 


7. Okuma & yürütme izinleri varsayılan olarak verilmelidir.Gerektiğinde ek izinler sağlayın. 

Erişim, lacl ’ler Aracı kullanılarak bir komut isteminde de verilebilir.Örnek olarak DefaultAppPool kullanarak, 
aşağıdaki komut kullanılır: 

ICACLS C:\sites\MyWebApp /grant "IIS AppPool\DefaultAppPool":F 

Daha fazla bilgi için ıcacl 'ler konusuna bakın. 

HTTP/2 desteği 

Http/2 aşağıdaki IIS dağıtım senaryolarında ASP.NET Core desteklenir: 

• İşlem içi 

o Windows Server 2016/Windows 10 veya üzeri; IIS 10 veya üzeri 
o TLS 1,2 veya üzeri bağlantı 

• işlem dışı 

o Windows Server 2016/Windows 10 veya üzeri; IIS 10 veya üzeri 

o Herkese açık uç sunucu bağlantıları HTTP/2 kullanır, ancak Kestrel sunucusuyla ters proxy bağlantısı 
http/1.1 kullanır, 
o TLS 1,2 veya üzeri bağlantı 



























































Bir HTTP/2 bağlantısı oluşturulduğunda, bir işlem içi dağıtım için, HttpRequest. Protocol Reports http/2 . Bir 
HTTP/2 bağlantısı oluşturulduğunda, bir işlem dışı dağıtımı için, HttpRequest. Protocol Reports http/i.i . 

İşlem içi ve işlem dışı barındırma modelleri hakkında daha fazla bilgi için bkz. AS P.N ET Core Modülü. 

Http/2 , aşağıdaki temel gereksinimleri karşılayan işlem dışı dağıtımlar için desteklenir: 

• VVİndovvs Server 2016/Windows 10 veya üzeri; IIS 10 veya üzeri 

• Herkese açık uç sunucu bağlantıları HTTP/2 kullanır, ancak Kestrel sunucusuyla ters proxy bağlantısı 
http/1.1 kullanır. 

• Hedef Framevvork: HTTP/2 bağlantısı tamamen IIS tarafından işlendiğinden, işlem dışı dağıtımlar için 
geçerli değildir. 

• TLS 1,2 veya üzeri bağlantı 

Bir HTTP/2 bağlantısı kurulduysa, HttpRequest. Protocol Reports http/i.i . 

HTTP/2 varsayılan olarak etkindir.HTTP/2 bağlantısı kurulmadıysa bağlantılar HTTP/1.1 'ye geri döner.IIS 
dağıtımları ile HTTP/2 yapılandırması hakkında daha fazla bilgi için bkz. IIS 'de http/2. 

CORS ön denetim istekleri 

Bu bölüm, yalnızca .NET Framevvork hedefleyen ASP.NET Core uygulamalar için geçerlidir. 

.NET Framevvork hedefleyen ASP.NET Core bir uygulama için, Seçenekler istekleri uygulamaya varsayılan 
olarak IIS 'de aktarılmaz. Web. config DOSYASINDAKİ uygulama IIS işleyicilerini seçenek isteklerini geçecek 
şekilde yapılandırma hakkında bilgi edinmek için bkz.ASP.NET Web API 2 ' de çapraz kaynak İSTEKLERİNİ 
etkinleştirme: CORS 'nin nasıl çalıştığı. 

Uygulama başlatma modülü ve boşta kalma zaman aşımı 

ASP.NET Core modülü sürüm 2 tarafından IIS 'de barındırıldığında: 

• Uygulama başlatma modülü - uygulamanın barındırılan veya işlem dışı bir çalışan işlem yeniden başlatma 
veya sunucu yeniden başlatma üzerinde otomatik olarak başlayacak şekilde yapılandırılabilir. 

• Boşta kalma zaman aşımı - uygulamanın barındırılan, işlem yapılmayan dönemler sırasında zaman 
aşımına uğramaması için yapılandırılabilir. 

Uygulama başlatma modülü 

işlem içi ve işlem dışı barındırılan uygulamalar için geçerlidir. 

IIS uygulaması başlatma , uygulama havuzu başlatıldığında veya geri DÖNÜŞTÜRÜLDÜĞÜNDE 
uygulamaya http isteği gönderen bir IIS özelliğidir. İstek, uygulamayı başlatmak üzere tetikler. Varsayılan 
olarak IIS, uygulamayı başlatmak için uygulamanın kök URL 'SI ( / ) için bir istek yayınlar (yapılandırma 
hakkında daha fazla bilgi için ek kaynaklara bakın). 

IIS uygulama başlatma rolü özelliğinin etkin olduğunu doğrulayın: 

IIS 'yi yerel olarak kullanırken VVİndovvs 7 veya üzeri masaüstü sistemlerinde: 

1. > programlar ve Özellikler > Programlar ve Özellikler' e gidin > VVİndovvs özelliklerini açın veya 
kapatın (ekranın sol tarafında). 

2. Uygulama geliştirme özellikleri> Internet Information Services > VVorld VVide VVeb Hizmetleri ni 

açın. 

3. Uygulama başlatmaonay kutusunu seçin. 

VVİndovvs Server 2008 R2 veya sonraki sürümlerde: 

1. Rol ve Özellik Ekleme Sihirbazı 'maçın. 




2. Rol hizmetlerini Seç panelinde, uygulama geliştirme düğümünü açın. 

3. Uygulama başlatmaonay kutusunu seçin. 

Site için uygulama başlatma modülünü etkinleştirmek üzere aşağıdaki yaklaşımlardan birini kullanın: 

• 11S Yöneticisi'Ni kullanma: 

1. Bağlantılar panelinde uygulama havuzları ' nı seçin. 

2. Listedeki uygulamanın uygulama havuzuna sağ tıklayın ve Gelişmiş ayarlar 1 ı seçin. 

3. Varsayılan Başlangıç modu OnDemand' dir. Başlangıç modunu AlvvaysRunningolarak 

ayarlayın. Tamam ' ıseçin. 

4. Bağlantılar panelinde siteler düğümünü açın. 

5. Uygulamaya sağ tıklayın ve Gelişmiş ayarlar> Web sitesini Yönet ' i seçin. 

6. Varsayılan önyükleme etkin ayarı falseşeklindedir. Önyükleme etkin ' i trueolarak ayarlayın. 

Tamam ' ıseçin. 

• Web. conf/gkullanarak, uygulamanın Web. config dosyasındaki <system.webserver> öğelerine true 
doAppinitAfterRestart ayarlanmış <appiicationinitiaiization> öğesini ekleyin: 

<?xml version="1.0" encoding="utf-8"?> 

<configuration> 

clocation path="." inheritInChildApplications="false"> 

<system.webServer> 

<applicationInitialization doAppInitAfterRestart="true" /> 

</system.webServer> 

</location> 

</configuration> 

Boşta kalma zaman aşımı 

Yalnızca işlem sırasında barındırılan uygulamalar için geçerlidir. 

Uygulamanın çalışmasını engellemek için, 11S Yöneticisi'Ni kullanarak uygulama havuzunun boşta kalma 
zaman aşımını ayarlayın: 

1. Bağlantılar panelinde uygulama havuzları 1 nı seçin. 

2. Listedeki uygulamanın uygulama havuzuna sağ tıklayın ve Gelişmiş ayarlar 1 ı seçin. 

3. Varsayılan boşta kalma süresi (dakika) 20 dakikadır. Boşta kalma zaman aşımını (dakika) 0 (sıfır) 
olarak ayarlayın. Tamam ' ıseçin. 

4. Çalışan işlemini geri dönüştür. 

işlem dışı barındırılan uygulamaların zaman aşımına uğramasını engellemek için aşağıdaki yaklaşımlardan 
birini kullanın: 

• Uygulamayı çalışır durumda tutmak için bir dış hizmetten ping yapın. 

• Uygulama yalnızca arka plan hizmetleri barındırıyorsa, IIS barındırmaktan kaçının ve ASP.NET Core 
uygulamasını barındırmak için bir VVİndovvs hizmetikullanın. 

Uygulama başlatma modülü ve boşta kalma zaman aşımı ek kaynakları 

• IIS 8,0 uygulama başlatma 

• Uygulama başlatma <applicationınitialization >. 

• Bir uygulama havuzu İçin İşlem modeli ayarlan <processModel >. 

IIS yöneticileri için dağıtım kaynaklan 

IIS belgelerinde IIS hakkında ayrıntılı bilgi edinin. 

IIS belgeleri 






.NET Core uygulama dağıtım modelleri hakkında bilgi edinin. 

.NET Core uygulama dağıtımı 

Yapılandırma kılavuzu dahil ASP.NET Core modülü hakkında bilgi edinin. 

ASP.NET Core Modülü 

Yayımlanan ASP.NET Core uygulamalarının dizin yapısı hakkında bilgi edinin. 

Dizin yapısı 

ASP.NET Core uygulamalar için etkin ve etkin olmayan 11S modüllerini ve 11S modüllerinin naşı 
yönetileceğini bulun. 

11S modülleri 

ASP.NET Core uygulamaların MS dağıtımları ile ilgili sorunları tanılamayı öğrenin. 

Sorun giderme 

11S 'de ASP.N ET Core uygulamalar barındırırken sık karşılaşılan hataları ayırt edin. 

Azure App Service ve 11S için sık karşılaşılan hatalar başvurusu 

Ek kaynaklar 

• ASP.NET Core projeleri sorunlarını giderme 

• ASP.NET Core giriş 

• Resmi Microsoft 11S sitesi 

• VVİndovvs Server teknik içerik kitaplığı 

• 11S üzerinde HTTP/2 

• VVeb.config’i dönüştürme 


IIS 'de ASPNET Core uygulaması yayımlama 

4.10.2019 • 8 minutes to read ı Edit Online 


Tarafından Luke Latham 

Bu öğreticide bir IIS sunucusunda ASP.NET Core uygulamasının nasıl barındırılacağını gösterilmektedir. 

Bu öğreticide aşağıdaki konular ele alınmaktadır: 

• .N ET Core barındırma paketi 'ni Windows Server 'a yükler. 

• IIS Yöneticisi 'nde bir IIS sitesi oluşturun. 

• ASP.NET Core uygulamasını dağıtın. 

Önkoşullar 

• Geliştirme makinesinde yüklü .NET Core SDK . 

• Web sunucusu (IIS) sunucu rolüyle yapılandırılmış Windows Server. Sunucunuz Web sitelerini IIS ile 
barındırmak üzere yapılandırılmamışsa, IIS ile Windows üzerinde ASP.NET Core barındırma makalenin IIS 
yapdandırmasL bölümündeki yönergeleri izleyin ve ardından Bu öğreticiye geri dönün. 


VVARNING 

IIS yapılandırması ve Web sitesi güvenliği, bu öğretici kapsamında olmayan kavramları içerir. IIS 'de üretim 
uygulamalarını barındırmadan önce, MICROSOFT IIS BELGELERİNDEKİ IIS KıLAVUZUNA ve IIS ile barındırma hakkında 
ASP.NET Core makalesine başvurun. 

Bu öğreticide kapsanmayan IIS barındırması için önemli senaryolar şunlardır: 

• ASP.NET Core veri koruması için bir kayıt defteri kovanı oluşturma 

• Uygulama havuzunun Access Control listesi (ACL) yapılandırması 

• IIS dağıtım kavramlarına odaklanmak için bu öğretici, IIS 'de FITTPS güvenliği olmayan bir uygulama dağıtır. HTTPS 
protokolü için etkinleştirilmiş bir uygulamayı barındırma hakkında daha fazla bilgi için, bu makalenin ek kaynaklar 
bölümündeki güvenlik konularına bakın. ASP.NET Core uygulamalar barındırılmasına yönelik daha fazla rehberlik IIS ile 
VVİndovvs üzerinde ASP.NET Core barındırma makalesinde sunulmaktadır. 


Paket barındırma .NET Core'u yükleme 

.NET Core barmdırma paketi 'ni IIS sunucusuna yükler..NET Core çalışma zamanı, .NET Core kitaplığı paketi 
yükler ve ASP.NET Core Modülü. Modül IIS çalıştırılacak uygulamaları ASP.NET Core sağlar. 

Aşağıdaki bağlantıyı kullanarak yükleyiciyi indirin: 

Geçerli .NET Core barındırma Paket Yükleyici (doğrudan indirme) 

1. Yükleyiciyi IIS sunucusunda çalıştırın. 

2. Sunucuyu yeniden başlatın ya da net stop idi ' i ve ardından bir komut kabuğu 'ndan net start w3svc ' ı 
çalıştırın. 

IIS sitesi oluştur 

1. IIS sunucusunda, uygulamanın yayımlanan klasörlerini ve dosyalarını içeren bir klasör oluşturun. Aşağıdaki 
adımda, klasörün yolu, uygulamanın fiziksel yolu olarak IIS 'ye sağlanır. 






2. 11S Yöneticisi 'nde, Bağlantılar panelinde sunucunun düğümünü açın. Sağ siteleri klasör. Seçin Web sitesi 
Ekle bağlam menüsünde. 

3. Bir site adı belirtin ve fiziksel yolu , oluşturduğunuz uygulamanın dağıtım klasörüne ayarlayın. Bağlama 
yapılandırmasını sağlayın ve Tamam' ı seçerek Web sitesini oluşturun. 

ASP.NET Core Razor Pages uygulaması oluşturma 

Razor Pages uygulaması oluşturmak için öğreticiyiizleyin.ASP.NET Core kullanmaya başlayın 

Uygulamayı yayımlama ve dağıtma 

Uygulama yayımlama , bir sunucu tarafından barındırabilecek derlenmiş bir uygulama oluşturmak anlamına 
gelir. Uygulama dağıtma , yayımlanan uygulamayı bir barındırma sistemine taşımak anlamına gelir. Yayımla adı 
.NET Core SDKtarafından işlenir, ancak dağıtım adımı çeşitli yaklaşımlar tarafından işlenebilir. Bu öğretici, şu 
konumda klasör dağıtım yaklaşımını benimsemektedir: 

• Uygulama bir klasöre yayımlanır. 

• Klasörün içeriği 11S sitesinin klasörüne taşınır (MS Yöneticisi 'nde sitenin fiziksel yolu ). 

• Visual Studio 

• .NET Core CLI 

• Mac için Visual Studio 

1. Çözüm Gezgini projede projeye sağ tıklayın ve Yayımla' yı seçin. 

2. Bir yayımlama hedefi seç iletişim kutusunda, klasörü Yayımla seçeneğini belirleyin. 

3. Klasör veya dosya paylaşma yolunu ayarlayın. 

• Geliştirme makinesinde bir ağ paylaşımında bulunan 11S sitesi için bir klasör oluşturduysanız, paylaşımın 
yolunu belirtin. Geçerli kullanıcının paylaşıma yayımlamak için yazma erişimi olmalıdır. 

• 11S sunucusunda 11S site klasörüne doğrudan dağıtım yapadıysanız, kaldırılabilir medyada bir klasöre 
yayımlayın ve yayımlanan uygulamayı sunucuda, sitenin fiziksel yolu olan sunucudaki 11S site 
klasörüne fiziksel olarak taşıyın. B'ın/Release/{Target Framework}/Publlsh klasörünün İÇERİĞİNİ 
sunucusundaki 11S site klasörüne taşıyın, bu site, sitenin 11S Yöneticisi 'ndeki fiziksel yoludur. 

Web sitesine Gözat 

Uygulamanın ilk isteği aldıktan sonra tarayıcıda erişilebilir olması gerekir.Site için 11S Yöneticisi 'nde 
oluşturduğunuz uç nokta bağlamasındaki uygulamaya bir istek oluşturun. 

Sonraki adımlar 

Bu öğreticide, şunların nasıl yapıldığını öğrendiniz: 

• .N ET Core barındırma paketi 'ni VVİndovvs Server 'a yükler. 

• 11S Yöneticisi 'nde bir 11S sitesi oluşturun. 

• ASP.NET Core uygulamasını dağıtın. 

IIS 'de ASP.NET Core uygulamaları barındırma hakkında daha fazla bilgi için bkz. 11S genel bakış makalesi: 

IIS ile VVİndovvs üzerinde ASP.NET Core barındırma 

Ek kaynaklar 

ASP.NET Core belge kümesi makaleleri 



• ASP.NET Core Modülü 

• ASP.NET Core dizin yapısı 

• Azure App Service ve MS 'de ASP.NET Core sorunlarını giderme 

• ASP.NET Core'de HTTPS'yi zorla 

ASP.NET Core Uygulama dağıtımıyla ilgili makaleler 

• Visual Studio ile Azure'a bir ASP.NET Core uygulaması yayımlama 

• Visual Studio Code ile Azure 'da ASP.NET Core uygulaması yayımlama 

• ASP.NET Core uygulama dağıtımı için Visual Studio yayımlama profilleri (. pubxml) 

• Mac için Visual Studio kullanarak bir Web uygulamasını bir klasöre yayımlama 

İIS HTTPS yapılandırması makaleleri 

• İIS Yöneticisi 'nde SSL 'yi yapılandırma 

• İIS 'de SSL ayarlama 

İIS ve Windows Server makaleleri 

• Resmi Microsoft İIS sitesi 

• Windows Server Teknik içerik Kitaplığı 


ASRNET Core Modülü 

8.11.2019 * 70 minutes to read ^ Edit Online 


, Tom Dykstra, Rick Strahl, ChrisNo, Rick Anderson, Sourabh Shirhatti, adatın kotalikve 
Luke Latham tarafından 

ASP.N ET Core modülü, 11S ardışık düzenine şu şekilde takılan yerel bir IIS modülüdür: 

• işlem içi barındırma modeliolarak adlandırılan 11S çalışan işleminin ( w3wp.exe ) 
içinde bir ASP.NET Core uygulaması barındırın. 

• Web isteklerini, işlem dışı barındırma modeliolarak adlandırılan Kestrel 
sunucusunuçalıştıran bir arka uç ASP.NET Core uygulamasına iletin. 

Desteklenen Windows sürümleri: 

• VVİndovvs 7 veya üzeri 

• VVİndovvs Server 2008 R2 veya üzeri 

işlem içi barındırma sırasında, modül 11S HTTP sunucusu ( nsHttpServer ) adlı IIS için 
işlem içi sunucu uygulamasını kullanır. 

İşlem dışı barındırma sırasında modül yalnızca Kestrel ile birlikte kullanılabilir.Modül, 
http. sysile çalışmıyor. 

Barındırma modelleri 

İşlem içi barındırma modeli 

Uygulamalar, işlem içi barındırma modelinde varsayılan olarak ASP.NET Core. 
işlem içi barındırma sırasında aşağıdaki özellikler geçerlidir: 

• Kestrel Server yerine IIS HTTP sunucusu ( nsHttpServer ) kullanılır.işlem içi, 
Createdefaultbuilder UselIS ' i çağırır: 

o nsHttpServer kaydedin. 

o ASP.NET Core modülünün arkasında çalışırken sunucunun dinlemesi 
gereken bağlantı noktasını ve temel yolu yapılandırın, 
o Konağı, başlatma hatalarını yakalamak üzere yapılandırın. 

• RequestTimeout özniteliği işlem içi barındırma için uygulanmaz. 

• Uygulama havuzunu uygulamalar arasında paylaşma desteklenmez. Uygulama 
başına bir uygulama havuzu kullanın. 

• VVeb dağıtımı kullanırken veya dağıtımda el ile bir app_offline. htm 
dosyasıyerleştirilirken, açık bir bağlantı varsa uygulama hemen kapanmayabilir. 
Örneğin, bir VVebSocket bağlantısı, uygulamanın kapatılmasını erteleyebilir. 

• Uygulamanın mimarisi (bit genişliği) ve yüklü çalışma zamanının (x64 veya x86) 
uygulama havuzunun mimarisiyle eşleşmesi gerekir. 

• istemci bağlantısı kesiliyor algılandı, istemci bağlantısı kesildiğinde HttpContext. 
ReguestAborted iptal belirteci iptal edilir. 





• ASP.NET Core 2.2.1 veya önceki sürümlerde, GetCurrentDirectory, uygulamanın 
dizini yerine MS tarafından başlatılan işlemin çalışan dizinini döndürür (örneğin, 
W3wp. exeiçin c:\Windows\System32\inetsrv ). 

Uygulamanın geçerli dizinini ayarlayan örnek kod için bkz. 
Currentdirectoryyardımcıları sınıfı. setcurrentDirectory yöntemini çağırın. 
GetCurrentDirectory sonraki çağrılar, uygulamanın dizinini sağlar. 

• işlem sırasında barındırırken, bir kullanıcıyı başlatmak için AuthenticateAsync iç 
olarak çağrılmaz. Bu nedenle, her kimlik doğrulamasından sonra talepleri 
dönüştürmek için kullanılan IClaimsTransformation bir uygulama varsayılan 
olarak etkin leşti rilmez. Talepler IClaimsTransformation uygulamasıyla 
dönüştürülürken, kimlik doğrulama hizmetleri eklemek için AddAuthentication 
çağırın: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services .AddTransientcIClaimsTransformatiorij ClaimsTransformer>(); 

Services.AddAuthentication(IISServerDefaults.AuthenticationScheme); 

} 

public void Configure(IApplicationBuilder app) 

{ 

app.UseAuthentication(); 

} 

o Web paketi (tek dosya) dağıtımları desteklenmez. 

İşlem dışı barındırma modeli 

Bir uygulamayı işlem dışı barındırmak üzere yapılandırmak için, 

<AspNetcoreHostingModei> özelliğinin değerini proje dosyasında (. csproj) outofProcess 
olarak ayarlayın: 

<PropertyGroup> 

<AspNetCoreHostingModel>OutOfProcess</AspNetCoreHostingModel> 

</PropertyGroup> 

işlem içi barındırma, varsayılan değer olan inProcess ile ayarlanır. 

<AspNetcoreHostingModei> değeri büyük/küçük harfe duyarlıdır, bu nedenle inprocess 
ve outofprocess geçerli değerlerdir. 

Kestrel sunucusu 11S HTTP sunucusu yerine kullanılır ( nsHttpSenver ). 

İşlem dışı için Createdefaultbuilder UselISIntegration 1 i çağırır: 

• ASP.NET Core modülünün arkasında çalışırken sunucunun dinlemesi gereken 
bağlantı noktasını ve temel yolu yapılandırın. 

• Konağı, başlatma hatalarını yakalamak üzere yapılandırın. 

Barındırma modeli değişiklikleri 

hostingModei ayarı Web. config dosyasında değiştirilirse ( Web. config ile yapılandırma 
bölümünde AÇ 1 KLANM 1 ŞT 1 R), modül 11S için çalışan işlemini geri dönüştürür. 

11S Express için modül çalışan işlemini geri dönüştürmez, bunun yerine geçerli MS 
Express işleminin düzgün bir şekilde kapatılmasını tetikler. Uygulamaya yönelik bir 
sonraki istek, yeni bir MS Express işlem olarak çoğaltılır. 
















İşlem adı 


Process.GetCurrentProcess() .ProcessName rapor w3wp / iisexpress (işlem İÇİ) veya 
dotnet (işlem dışı). 


VVİndovvs kimlik doğrulaması gibi birçok yerel modül etkin kahr.ASP.NET Core 
modülüyle etkin IIS modülleri hakkında daha fazla bilgi için, bkz. ASP.NET Core içeren 
IIS modülleri. 

ASP.NET Core modülü de şunları yapabilir: 

• Çalışan işlem için ortam değişkenlerini ayarlayın. 

• Başlatma sorunlarını gidermek için stdout çıkışını dosya depolama alanına kaydedin. 

• VVİndovvs kimlik doğrulama belirteçlerini ilet. 

ASP.NET Core modülünü yüklemek ve kullanmak 

AS P.N ET Core modülünün nasıl yükleneceğine ilişkin yönergeler için bkz. .N ET Core 
barındırma paketi 'Ni yüklemek. 

Web. config ile yapılandırma 

ASP.NET Core modülü, sitenin Web. config dosyasındaki system.webserver 
düğümünün aspNetcore bölümü ile yapılandırılır. 

Aşağıdaki Web. config dosyası, çerçeveye bağlı bir dağıtım İçin yayımlanır ve AS P.N ET 
Core modülünü site isteklerini işleyecek şekilde yapılandırır: 

<?xml version="1.0" encoding="utf-8"?> 

<configuration> 

clocation path="." inheritInChildApplications="false"> 

<system.webServer> 

<handlers> 

<add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" 
resourceType="Unspecified" /> 

</handlers> 

<aspNetCore processPath="dotnet" 

arguments=". \MyApp.dll" 
stdoutLogEnabled="false" 
stdoutLogFile=". \logs\stdout" 
hostingModel="inprocess" /> 

</system.webServer> 

</location> 

</configuration> 


Aşağıdaki Web. config , kendinden bağımsız bir dağıtımiçin yayımlanır: 






<?xml version="1.0" encoding="utf-8"?> 

<configuration> 

<location path="." inheritInChildApplications="false"> 

<system.webServer> 

<handlers> 

<add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" 
resourceType="Unspecified" /> 

</handlens> 

<aspNetCore processPath=". \MyApp.exe" 
stdoutLogEnabled="false" 
stdoutLogFile=". \logs\stdout" 
hostingModel="inprocess" /> 

</system.webServer> 

</location> 

</configuration> 


InheritlnChiIdApplications özelliği, <location > öğesi içinde belirtilen ayarların 
uygulamanın bir alt dizininde bulunan uygulamalar tarafından devralınmadığını 
göstermek için faise olarak ayarlanır. 

Bir uygulama Azure App Servicedağıtıldığında stdoutLogFile yolu 
\\?\%home%\LogFiies\stdout olarak ayarlanır. Yol, stdout günlüklerini hizmet tarafından 
otomatik olarak oluşturulan bir konum olan LogFiles klasörüne kaydeder. 

IIS alt uygulama yapılandırması hakkında bilgi için bkz. 1 1S ile Windows üzerinde 
ASP.NET Core barındırma. 

AspNetCore öğesinin öznitelikleri 

ÖZNITELIK AÇIKLAMA VARSAYILAN 


arguments isteğe bağlı dize 

özniteliği. 

ProcessPathiçinde 

belirtilen yürütülebilir 
dosya için bağımsız 
değişkenler. 


disableStartllpErrorPage isteğe bağlı Boolean false 

özniteliği. 

Doğru ise, 502,5-lşlem 

hatası sayfası bastırılır ve 
Web. config dosyasında 
yapılandırılan 502 durum 
kodu sayfası önceliklidir. 









OZNITELIK 


AÇIKLAMA 


VARSAYILAN 


forwardWindowsAuthToken 


hostingModel 


processesPerApplication 


processPath 


isteğe bağlı Boolean 
özniteliği. 

True ise belirteç, istek 
başına 1 MS- 
ASPNETCORE- 
WıNAUTHTOKEN 1 üst 
bilgisi olarak% 
ASPNETCORE_PORT% 
üzerinde dinleme yapan 
alt işleme iletilir. Bu, istek 
başına bu belirteçte 
CloseHandle çağırma 
işleminin 

sorumluluğundadır. 


isteğe bağlı dize 
özniteliği. 

Barındırma modelini işlem 
içi ( InProcess / 


inprocess 

) veya işlem 

dışı ( OutOf P 

'rocess / 

outofprocess ) olarak 


belirtir. 


InProcess 

inprocess 


isteğe bağlı tamsayı 
özniteliği. 

ProcessPath ayarında 
belirtilen işlemin örnek 
sayısını, uygulama başına 
bir şekilde işleyecek 
şekilde belirtir. 

tlşlem içi barındırma İçin, 
değer ı ile sınırlıdır. 

processesPerApplication 
ayarlama önerilmez. Bu 
öznitelik gelecek bir 
sürümde kaldırılacak. 


Varsayılan: ı 


Min: 

1 


En fazla: 

100 ■ 


Gerekli dize özniteliği. 

HTTP isteklerini dinleyen 
bir işlemi başlatan 
yürütülebilir dosyanın 
yolu. Göreli yollar 
desteklenir. Yol . ile 
başlıyorsa, yol site 
köküne göreli olarak 
kabul edilir. 











OZNITELIK 


AÇIKLAMA 


VARSAYILAN 


r'apidFailsPer'Minute 


r'equestT imeout 


shutdownTimeLimit 


isteğe bağlı tamsayı 
özniteliği. 

ProcessPath içinde 
belirtilen işleme dakika 
başına kilitlenme için izin 
verilen sayıyı belirtir. Bu 
sınır aşılırsa modül, 
dakika geri kalanı için 
işlemi başlatmayı 
durduruyor. 

işlem içi barındırma ile 
desteklenmez. 


Varsayılan: 10 


Min: 

0 


En fazla: 

100 


isteğe bağlı TimeSpan 
özniteliği. 

ASP.NET Core 

modülünün,% 
ASPNETCORE_PORT% 

üzerinde dinleme 
işleminden yanıt beklediği 
süreyi belirtir. 

Varsayılan: 00:02:00 

Min: 00:00:00 

En fazla: 360:00:00 

ASP.NET Core 2,1 veya 
üzeri sürümü ile birlikte 
gelen ASP.NET Core 
modülünün 

sürümlerinde, 
requestTimeout saat, 

dakika ve saniye olarak 
belirtilir. 


işlem içi barındırma için 
uygulanmaz, işlem içi 
barındırma için modül, 
uygulamanın isteği 
işlemesini bekler. 


Dizenin dakika ve saniye 
kesimleri için geçerli 
değerler 0-59 
aralığındadır. Dakika veya 
saniye değerindeki 60 
kullanımı, 500 -iç sunucu 
hatasınaneden olur. 



isteğe bağlı tamsayı 

Varsayılan: 10 

özniteliği. 

Min: 0 

App_offline. htm dosyası 
algılandığında, modülün 
yürütülebilir dosyanın 
düzgün şekilde 
kapatılmasını beklediği 
saniye cinsinden süre. 

En fazla: 600 










OZNITELIK 


AÇIKLAMA 


VARSAYILAN 


startupTimeLimit 


stdoutLogEnabled 


isteğe bağlı tamsayı 
özniteliği. 

Modülün, bağlantı 
noktasında dinleme 
yapan bir işlemin 
başlamasını bekleyeceği 
saniye cinsinden süre. Bu 
süre sınırı aşılırsa, modül 
işlemi bu işlemden sonra 
da bir kez gider. Modül, 
yeni bir istek aldığında 
işlemi yeniden başlatmayı 
dener ve uygulamanın 
son geçen dakikada 
rapidFailsPerMinute 
kez başlayamadığı sürece 
sonraki gelen isteklerde 
işlemi yeniden başlatmayı 
dener. 

0 (sıfır) değeri sonsuz bir 
zaman aşımı olarak kabul 

edilmez . 


Varsayılan: 120 


Min: 

0 


En fazla: 

3600 


isteğe bağlı Boolean 
özniteliği. 

True ise, processPath 
içinde belirtilen işlem için 
stdout ve stderr, 
stdoutLogFileiçinde 

belirtilen dosyaya 
yeniden yönlendirilir. 


f alse 







OZNITELIK 


AÇIKLAMA 


VARSAYILAN 


stdoutLogFile isteğe bağlı dize aspnetcore-stdout 

özniteliği. 

ProcessPath içinde 
belirtilen işlemden stdout 
ve stderr 'in günlüğe 
kaydedildiği göreli veya 
mutlak dosya yolunu 
belirtir. Göreli yollar, 
sitenin köküne göredir. 

. başlayan tüm yollar 
site köküne göredir ve 
diğer tüm yollar mutlak 
yollar olarak 
değerlendirilir. Yolda 
sunulan klasörler, günlük 
dosyası 

oluşturulduğunda modül 
tarafından oluşturulur. Alt 
çizgi sınırlayıcılarını 
kullanma, bir zaman 
damgası, işlem KİMLİĞİ 
ve dosya uzantısı (. log) 
stdoutLogFile yolunun 
son kesimine eklenir. 

. \logs\stdout bir 
değer olarak sağlandıysa, 

2/5/2018 işlem 1934 
KİMLİĞİ ile 19:41:32 ' de 
tarihinde kaydedildiğinde 
Günlükler klasöründe 
stdout_2018020519413 
2_ 1934. log dosyasına 
bir örnek stdout günlüğü 
kaydedilir. 


Ortam değişkenlerini ayarlama 

processPath özniteliğinde işlem için ortam değişkenleri belirtilebilir. Bir 
<environmentVariables> koleksiyon Öğesinin <environmentVariable> alt Öğesiyle bir 
ortam değişkeni belirtin. Bu bölümde ayarlanan ortam değişkenleri, sistem ortamı 
değişkenlerine göre önceliklidir. 

Aşağıdaki örnek, Web. config dosyasında iki ortam değişkenini ayarlar. 
aspnetcore_environment , uygulamanın ortamını Development olarak yapılandırır. Bir 
geliştirici, uygulama özel durumunda hata ayıklarken Geliştirici özel durum sayfasını 
yüklemeye zorlamak için bu değeri geçici olarak Web. config dosyasında ayarlayabili 
config_dir , geliştiricinin, uygulamanın yapılandırma dosyasını yüklemek için bir yol 
oluşturmak üzere başlangıçta değeri okuyan kodu yazdığı Kullanıcı tanımlı ortam 
değişkenine bir örnektir. 











<aspNetCore processPath="dotnet" 
arguments=". \MyApp.dll" 
stdoutl_ogEnabled="false" 
stdoutLogFile=". \logs\stdout" 
hostingModel="inprocess"> 

<environmentVariables> 

<environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" /> 
<environmentVariable name="CONFIG_DIR" value="f: \application_config" /> 
</environmentVariables> 

</aspNetCore> 


NOTE 

Ortamı doğrudan Web. config içinde ayarlamaya alternatif olarak, <EnvironmentName> 
özelliği Publish profile (. pubxml) veya proje dosyasına dahil edilir. Bu yaklaşım, proje 
yayımlandığında Web. config içinde ortamı ayarlar: 

<PropertyGroup> 

<EnvironmentName>Development</EnvironmentName> 

</Pr'oper'tyGroup> 


WARNING 

Yalnızca aspnetcore environment ortam değişkenini, Internet gibi güvenilmeyen ağlarla 
erişilemeyen hazırlama ve test sunucularında Development olarak ayarlayın. 


app_offline. htm 

Bir uygulamanın kök dizininde app_offime. htm adlı bir dosya algılanırsa, ASP.N ET 
Core modülü uygulamayı düzgün bir şekilde kapatmaya ve gelen istekleri işlemeyi 
durdurmaya çalışır. Uygulama, shutdownTimeLimit 1 da tanımlanan saniye sayısından 
sonra hala çalışıyorsa, AS P.N ET Core modülü çalışan işlemi de yok eder. 

App_offline. htm dosyası mevcut olsa da ASP.NET Core modülü, istekleri, app_offline. 
htm dosyasının içeriğini geri göndererek yanıtlar. App_offiıne. htm dosyası 
kaldırıldığında, sonraki istek uygulamayı başlatır. 

işlem dışı barındırma modeli kullanılırken, açık bir bağlantı varsa uygulama hemen 
kapanmayabilir. Örneğin, bir VVebSocket bağlantısı, uygulamanın kapatılmasını 
erteleyebilir. 

Başlatma hatası sayfası 

Hem işlem içi hem de işlem dışı barındırma, uygulamayı başlatamadıklarında özel hata 
sayfaları üretir. 

ASP.NET Core modülü işlem içi veya işlem dışı istek işleyicisini bulamazsa, 500,0-işlem 
içi/işlem dışı Işleyiciyükleme hatası durum kodu sayfası görüntülenir. 

ASP.NET Core modülü uygulamayı başlatamadığında işlem içi barındırma için, 500,30- 
başlatma hatası durum kodu sayfası görüntülenir. 

ASP.NET Core modülü arka uç işlemini başlatamadığında veya arka uç işlemi 
başlatılırsa ancak yapılandırılmış bağlantı noktasında dinleyemediğinde, işlem dışı 
barındırma için 502,5-lşlem hatası durum kodu sayfası görüntülenir. 








Bu sayfayı bastırın ve varsayılan 11S 5xx durum kodu sayfasına dönmek için 
disablestartupErrorPage özniteliğini kullanın. Özel hata iletilerini yapılandırma 
hakkında daha fazla bilgi için bkz. http hataları <httpErrors >. 

Günlük oluşturma ve yeniden yönlendirme 

aspNetcore öğesinin stdoutLogEnabled ve stdoutLogFile öznitelikleri ayarlandıysa 
ASP.NET Core modülü stdout ve stderr konsol çıkışını diske yönlendirir. stdoutLogFile 
yolundaki klasörler, günlük dosyası oluşturulduğunda modül tarafından oluşturulur. 
Uygulama havuzunun, günlüklerin yazıldığı konuma yazma erişimi olması gerekir 
(yazma izni sağlamak için us AppPooi\<app_pooi_name> kullanın). 

İşlem geri dönüştürme/yeniden başlatma gerçekleşmediği sürece Günlükler 
döndürülemez. Bu, günlüklerin tükettiği disk alanını sınırlamak için barındırıcının 
sorumluluğundadır. 

Stdout günlüğünün kullanılması yalnızca 11S 'de barındırırken veya Visual Studio İle IIS 
için geliştirme zamanı desteğikullanılırken değil, yerel olarak hata ayıklarken ve 
uygulamayı IIS Express ile çalıştırırken yalnızca uygulama başlatma sorunlarını 
gidermek için önerilir. 

Genel uygulama günlüğü amaçları için stdout günlüğünü kullanmayın. ASP.NET Core 
uygulamasında rutin günlük kaydı için, günlük dosyası boyutunu sınırlayan ve 
günlükleri döndüren bir günlüğe kaydetme kitaplığı kullanın. Daha fazla bilgi için bkz. 

üçüncü taraf günlüğü sağlayıcıları. 

Günlük dosyası oluşturulduğunda zaman damgası ve dosya uzantısı otomatik olarak 
eklenir. Günlük dosyası adı, alt çizgi ile ayrılmış stdoutLogFile yolunun (genellikle 
stdout) son kesimine zaman damgası, işlem kimliği ve dosya uzantısı (. log) eklenerek 
oluşur. stdoutLogFile yolu stdout\\e sonlanıyorsa, 1934 ' de 19:42:32 2/5/2018 ' de 
oluşturulan PID 'sine sahip bir uygulama için bir günlük dosyası 
stdout_20180205194132_1934. /ogdosya adına sahiptir. 

stdoutLogEnabled false ise, uygulama başlangıcında oluşan hatalar yakalanır ve 30 KB 
'a kadar olay günlüğüne yayınlanır. Başlangıçtan sonra tüm ek Günlükler atılır. 

Aşağıdaki örnek aspNetcore öğesi, bir göreli yol .\iog\ stdout günlüğünü yapılandırır. 
AppPool Kullanıcı kimliğinin, belirtilen yola yazma izni olduğunu doğrulayın. 

<aspNetCore processPath="dotnet" 
arguments=" .\MyApp.dll" 
stdoutLogEnabled="true" 
stdoutLogFile=". \logs\stdout" 
hostingModel="inprocess"> 

</aspNetCore> 

Azure App Service dağıtım için bir uygulama yayımlarken, Web SDK stdoutLogFile 
değerini \\?\%home%\LogFiies\stdout olarak ayarlar. %home ortam değişkeni, Azure App 
Service tarafından barındırılan uygulamalar için önceden tanımlanmıştır. 

Günlüğe kaydetme filtresi kuralları oluşturmak için ASP.NET Core günlük belgelerinin 

yapılandırma ve günlük filtreleme bölümlerine bakın. 

Yol biçimleri hakkında daha fazla bilgi için bkz. Windows sistemlerinde dosya yolu 
biçimleri. 
















Gelişmiş tanılama günlükleri 

ASP.NET Core modülü, gelişmiş tanılama günlükleri sağlamak için yapılandırılabilir. 
<handierSettings> öğesini Web. config'\çr\dek\ <aspNetcore> öğesine ekleyin. 
debugLevel trace olarak ayarlamak, tanılama bilgilerini daha yüksek bir şekilde 
kullanıma sunar: 


<aspNetCore processPath="dotnet" 
arguments=" .\MyApp.dll" 
stdoutLogEnabled="false" 
stdoutLogFile="\\?\%home%\LogFiles\stdout" 
hostingModel="inprocess"> 

<handlerSettings> 

<handlerSetting name="debugFile" value=". \logs\aspnetcore-debug. log" /> 
chandlerSetting name="debugLevel" value="FILEjTRACE" /> 
</handlerSettings> 

</aspNetCore> 


Yoldaki tüm klasörler (önceki örnekteki Günlükler ), günlük dosyası oluşturulduğunda 
modül tarafından oluşturulur. Uygulama havuzunun, günlüklerin yazıldığı konuma 
yazma erişimi olması gerekir (yazma izni sağlamak için us AppPooi\<app_pooi_name> 
kullanın). 

Hata ayıklama düzeyi ( debugLevel ) değerleri hem düzeyi hem de konumu içerebilir. 
Düzeyler (en az ayrıntıdan en fazla ayrıntı sırasına göre): 

• HATAYLA 

• VVARNING 

• BİLGİSİNE 

• TRACE 

Konumlar (birden çok konuma izin verilir): 

• KONSOLA 

• EVENTLOG 

• DOSYASYNY 

İşleyici ayarları, ortam değişkenleri aracılığıyla da kullanılabilir: 

• hata ayıklama günlük dosyasının - yolunu aspnetcore_module_debug_file . 
(Varsayılan: aspnetcore-Debug. log ) 

• Hata ayıklama düzeyi ayarını - aspnetcore_module_debug . 


VVARNING 

Bir sorunu gidermek için dağıtımda hata ayıklama günlüğü 'nün gerekenden uzun süre etkin 
bırakmayın. Günlüğün boyutu sınırlı değil. Hata ayıklama günlüğünün etkin bırakılması, 
kullanılabilir disk alanını tüketebilir ve sunucu veya App Service 'i kilitlemez. 


Web. config dosyasındaki aspNetcore öğesinin bir örneği için bkz. Web. config ile 
yapılandırma . 

Yığın boyutunu değiştirme 

Yalnızca işlem içi barındırma modeli kullanılırken geçerlidir. 










Yönetilen yığın boyutunu, Web. config dosyasında bayt cinsinden stacksize ayarını 
kullanarak yapılandırın. Varsayılan boyut 1048576 bayttır (1 M B). 

<aspNetCore processPath="dotnet" 
arguments=" .\MyApp.dll" 
stdoutLogEnabled="false" 
stdoutLogFile="\\?\%home%\LogFiles\stdout" 
hostingModel="inprocess"> 

<handlerSettings> 

•chandlerSetting name="stackSize" value="2097152" /> 

</handlerSettings> 

</aspNetCore> 


Proxy yapılandırması HTTP protokolünü ve eşleştirme 
belirtecini kullanır 

Yalnızca işlem dışı barındırma için geçerlidir. 

ASP.NET Core modülü ve Kestrel arasında oluşturulan ara sunucu HTTP protokolünü 
kullanır. Modül ve Kestrel arasındaki trafiği sunucu dışı bir konumdan bırakırken gizlice 
dinleme riski yoktur. 

Eşleştirme belirteci, Kestrel tarafından alınan isteklerin 11S tarafından proxy aldığından 
ve başka bir kaynaktan gelmediğinden emin olmak için kullanılır. Eşleştirme belirteci 
oluşturulur ve modül tarafından bir ortam değişkenine ( aspnetcore_token ) ayarlanır. 
Eşleştirme belirteci, her proxy isteğinde de bir üst bilgi ( ms-aspnetcore-token ) olarak 
ayarlanır. 11S ara yazılımı, eşleştirme belirteci üstbilgi değerinin ortam değişkeni 
değeriyle eşleşip eşleşmediğini doğrulamak için aldığı her isteği denetler. Belirteç 
değerleri uyuşmadıysa, istek günlüğe kaydedilir ve reddedilir. Eşleştirme belirteci ortam 
değişkeni ve modülle Kestrel arasındaki trafik, sunucu dışında bir konumdan erişilebilir 
değildir. Eşleştirme belirteç değerini bilmeden, bir saldırgan US ara yazılımı 'ndaki 
denetimi atlayan istekleri gönderemez. 

IIS paylaşılan yapılandırmasıyla ASP.NET Core modülü 

ASP.NET Core modülü yükleyicisi, Trustedlnstaller hesabının ayrıcalıklarıyla çalışır. 

Yerel sistem hesabı, IIS paylaşılan Yapılandırması tarafından kullanılan paylaşım yolu 
için değiştirme iznine sahip olmadığından, yükleyici,' deki ApplicationHost. config 
dosyasında modül ayarlarını yapılandırmaya çalışırken bir erişim reddedildi hatası atar, 
paylaşma. 

IIS yüklemesiyle aynı makinede bir IIS paylaşılan yapılandırması kullanırken, 
opt_no_shared_config_check parametresi ı olarakayarlananASP.NET Core 
barındırma paketi yükleyicisini çalıştırın: 

dotnet- hoşting-{VE RSIONj.exe 0PT_N0_SHARED_C0NFIG_CHECK=1 

Paylaşılan yapılandırmanın yolu IIS yüklemesiyle aynı makinede olmadığında, şu 
adımları izleyin: 

1. IIS paylaşılan yapılandırmasını devre dışı bırakın. 

2. Yükleyiciyi çalıştırın. 

3. Güncelleştirilmiş ApplicationHost. config dosyasını paylaşıma dışarı aktarın. 

4. IIS paylaşılan yapılandırmasını yeniden etkinleştirin. 







Modül sürümü ve barındırma paketi yükleyici 
günlükleri 

Yüklü ASP.NET Core modülünün sürümünü öğrenmek için: 

1. Barındırma sisteminde %windir%\system32\inetsrv dizinine gidin. 

2. Aspnetcore. dil dosyasını bulun. 

3. Dosyaya sağ tıklayın ve bağlam menüsünden Özellikler 1 i seçin. 

4. Ayrıntılar sekmesini seçin. Dosya sürümü ve ürün sürümü , modülün yüklü 
sürümünü temsil eder. 

Modülün barındırma paketi yükleyici günlükleri, C:\kullamcilar\% 
username%\AppData\yerel\Tempkor\umur\da bulunur. Dosya, 
dd_DotNetCoreWinSvrHosting__<zaman damgası > _000_Aspnetcoremodupa_x64. 
log olarak adlandırılmıştır. 

Modül, şema ve yapılandırma dosyası konumları 

Modül 

MS (X86/AMD64): 

• %windir%\System32\inetsrv\aspnetcore.dll 

• %windir%\SysWOW64\inetsrv\aspnetcore.dll 

• %ProgramFiles%\IIS\Asp. Net Core Module\v2\aspnetcorev2,dll 

• % Program Fileş (x86)% \ ııs\ ASP.NET Core Module\v2\aspnetcorev2,dll 
MS Express (X86/AMD64): 

• %ProgramFiles%\IIS Express\aspnetcore.dll 

• % ProgramFiles (x86)%\ 11S Express\aspnetcore.dll 

• %ProgramFiles%\IIS Express\Asp.Net Core Module\v2\aspnetcorev2,dl! 

• % ProgramFiles (x86)%\ 11S Express\Asp.Net Core Module\v2\aspnetcorev2,dll 

Şema 

ISS 

• %windir%\System32\inetsrv\config\schema\aspnetcore_schema.xml 

• %windir%\System32\inetsrv\config\schema\aspnetcore_schema_v2.xml 

MS Express 

• %ProgramFiles%\IIS Express\config\schema\aspnetcore_schema.xml 

• %ProgramFiles%\IIS Express\config\schema\aspnetcore_schema_v2.xmi 

Yapılandırma 

ISS 

• %Windir%\System32\inetsrv\config\applicationHost,config 

MS Express 

• Visual Studio: {APPLICATION ROOT} \. Vs\config\applicationhost,config 



• usexpress. exe 

CU:%USERPROFILE%\Documents\IISExpress\config\applicationhost.config 
Dosyalar, ApplicationHost. config dosyasında aspnetcore ' u arayarak bulunabilir. 
ASP.NET Core modülü, 11S ardışık düzenine şu şekilde takılan yerel bir 11S modülüdür: 

• işlem içi barındırma modeliolarak adlandırılan 11S çalışan işleminin ( w3wp.exe ) 
içinde bir ASP.NET Core uygulaması barındırın. 

• Web isteklerini, işlem dışı barındırma modeliolarak adlandırılan Kestrel 
sunucusunuçalıştıran bir arka uç ASP.NET Core uygulamasına iletin. 

Desteklenen Windows sürümleri: 

• VVİndovvs 7 veya üzeri 

• VVİndovvs Server 2008 R2 veya üzeri 

İşlem içi barındırma sırasında, modül 11S HTTP sunucusu ( nsHttpServer ) adlı 11S için 
işlem içi sunucu uygulamasını kullanır. 

işlem dışı barındırma sırasında modül yalnızca Kestrel ile birlikte kullanılabilir.Modül, 
http. sysile çalışmıyor. 

Barındırma modelleri 

İşlem içi barındırma modeli 

Bir uygulamayı işlem içi barındırma için yapılandırmak için, <AspNetcoreHostingModei> 
özelliğini uygulamanın proje dosyasına inProcess (işlem dışı barındırma outofProcess 
ile ayarlanır) ile birlikte ekleyin: 

<PropertyGroup> 

<AspNetCoreHostingModel>InProcess</AspNetCoreHostingModel> 

</PropertyGroup> 

işlem içi barındırma modeli, .NET Framevvork hedef ASP.NET Core uygulamalar için 
desteklenmez. 

<AspNetcoreHostingModei> değeri büyük/küçük harfe duyarlıdır, bu nedenle inprocess 
ve outofprocess geçerli değerlerdir. 

Dosyada <AspNetcoreHostingModei> özelliği yoksa, varsayılan değer Outofprocess 1 dir. 
İşlem içi barındırma sırasında aşağıdaki özellikler geçerlidir: 

• Kestrel Server yerine MS HTTP sunucusu ( nsHttpServer ) kullanılır, işlem içi, 
Createdefauitbuilder UselIS ' i çağırır: 

o nsHttpServer kaydedin. 

o ASP.NET Core modülünün arkasında çalışırken sunucunun dinlemesi 
gereken bağlantı noktasını ve temel yolu yapılandırın, 
o Konağı, başlatma hatalarını yakalamak üzere yapılandırın. 

• RequestTimeout özniteliği işlem içi barındırma için uygulanmaz. 

• Uygulama havuzunu uygulamalar arasında paylaşma desteklenmez. Uygulama 
başına bir uygulama havuzu kullanın. 

• VVeb dağıtımı kullanırken veya dağıtımda el ile bir app_offline. htm 













dosyasıyerleştirilirken, açık bir bağlantı varsa uygulama hemen kapanmayabilir. 
Örneğin, bir WebSocket bağlantısı, uygulamanın kapatılmasını erteleyebilir. 

• Uygulamanın mimarisi (bit genişliği) ve yüklü çalışma zamanının (x64 veya x86) 
uygulama havuzunun mimarisiyle eşleşmesi gerekir. 

• istemci bağlantısı kesiliyor algılandı, istemci bağlantısı kesildiğinde HttpContext. 
RequestAborted iptal belirteci iptal edilir. 

• ASP.NET Core 2.2.1 veya önceki sürümlerde, GetCurrentDirectory, uygulamanın 
dizini yerine MS tarafından başlatılan işlemin çalışan dizinini döndürür (örneğin, 
W3wp. exeiçin c:\Windows\System32\inetsrv ). 

Uygulamanın geçerli dizinini ayarlayan örnek kod için bkz. 
Currentdirectoryyardımcıları sınıfı. setcurrentDirectory yöntemini çağırın. 
GetCurrentDirectory sonraki çağrılar, uygulamanın dizinini sağlar. 

• işlem sırasında barındırırken, bir kullanıcıyı başlatmak için AuthenticateAsync iç 
olarak çağrılmaz. Bu nedenle, her kimlik doğrulamasından sonra talepleri 
dönüştürmek için kullanılan IClaimsTransformation bir uygulama varsayılan 
olarak etkin leşti rilmez. Talepler IClaimsTransformation uygulamasıyla 
dönüştürülürken, kimlik doğrulama hizmetleri eklemek için AddAuthentication 
çağırın: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddTransientCEClaimsTransformation, ClaimsTransformer>(); 

Services.AddAuthentication(IISServerDefaults.AuthenticationScheme); 

} 

public void Configure(IApplicationBuilder app) 

{ 

app.UseAuthentication(); 

} 

İşlem dışı barındırma modeli 

Bir uygulamayı işlem dışı barındırmak üzere yapılandırmak için, proje dosyasında 
aşağıdaki yaklaşımlardan birini kullanın: 

• <AspNetCoreHostingModel> Özelliğini belirtmeyin. Dosyada <AspNetCoreHostingModel> 
özelliği yoksa, varsayılan değer outofProcess ' dir. 

• <AspNetcoreHostingModei> özelliğinin değerini OutofProcess olarak ayarlayın (işlem 
içi barındırma, inProcess ile ayarlanır): 



değerlerdir. 

Kestrel sunucusu 11S HTTP sunucusu yerine kullanılır ( ııSHttpServer ). 

işlem dışı için Createdefaultbuilder UselISIntegration 1 i çağırır: 

• ASP.NET Core modülünün arkasında çalışırken sunucunun dinlemesi gereken 
bağlantı noktasını ve temel yolu yapılandırın. 














• Konağı, başlatma hatalarını yakalamak üzere yapılandırın. 

Barındırma modeli değişiklikleri 

hostingModei ayarı Web. config dosyasında değiştirilirse ( Web. config ile yapılandırma 
bölümünde AÇ 1 KLANM 1 ŞT 1 R), modül 11S için çalışan işlemini geri dönüştürür. 


MS Express için modül çalışan işlemini geri dönüştürmez, bunun yerine geçerli MS 
Express işleminin düzgün bir şekilde kapatılmasını tetikler. Uygulamaya yönelik bir 
sonraki istek, yeni bir MS Express işlem olarak çoğaltılır. 


İşlem adı 


Process 

.GetCurrentProcess().ProcessName 

dotnet 

(işlem dışı). 


rapor w3wp / iisexpress (işlem içi) veya 


VVİndovvs kimlik doğrulaması gibi birçok yerel modül etkin kahr.ASP.NET Core 
modülüyle etkin MS modülleri hakkında daha fazla bilgi için, bkz. ASP.NET Core içeren 
MS modülleri. 


ASP.NET Core modülü de şunları yapabilir: 

• Çalışan işlem için ortam değişkenlerini ayarlayın. 

• Başlatma sorunlarını gidermek için stdout çıkışını dosya depolama alanına kaydedin. 

• VVİndovvs kimlik doğrulama belirteçlerini ilet. 


ASP.NET Core modülünü yüklemek ve kullanmak 

AS P.N ET Core modülünün nasıl yükleneceğine ilişkin yönergeler için bkz. .N ET Core 
barındırma paketi 'Ni yüklemek. 

Web. config ile yapılandırma 

ASP.NET Core modülü, sitenin Web. config dosyasındaki system.webserver 
düğümünün aspNetcore bölümü ile yapılandırılır. 

Aşağıdaki Web. config dosyası, çerçeveye bağlı bir dağıtım İçin yayımlanır ve AS P.N ET 
Core modülünü site isteklerini işleyecek şekilde yapılandırır: 

<?xml version="1.0" encoding="utf-8"?> 

<configuration> 

clocation path="." inheritInChildApplications="false"> 

<system.webServer> 

<handlers> 

<add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" 
resourceType="Unspecified" /> 

</handlers> 

<aspNetCore processPath="dotnet" 

arguments=". \MyApp.dll" 
stdoutLogEnabled="false" 
stdoutLogFile=". \logs\stdout" 
hostingModel="inprocess" /> 

</system.webSenver> 

</location> 

</configuration> 


Aşağıdaki V/eb. config , kendinden bağımsız bir dağıtımiçin yayımlanır: 









<?xml version="1.0" encoding="utf-8"?> 

<configuration> 

<location path="." inheritInChildApplications="false"> 

<system.webServer> 

<handlers> 

<add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" 
resourceType="Unspecified" /> 

</handlens> 

<aspNetCore processPath=". \MyApp.exe" 
stdoutLogEnabled="false" 
stdoutLogFile=". \logs\stdout" 
hostingModel="inprocess" /> 

</system.webServer> 

</location> 

</configuration> 


InheritlnChiIdApplications özelliği, <location > öğesi içinde belirtilen ayarların 
uygulamanın bir alt dizininde bulunan uygulamalar tarafından devralınmadığını 
göstermek için faise olarak ayarlanır. 

Bir uygulama Azure App Servicedağıtıldığında stdoutLogFile yolu 
\\?\%home%\LogFiies\stdout olarak ayarlanır. Yol, stdout günlüklerini hizmet tarafından 
otomatik olarak oluşturulan bir konum olan LogFiles klasörüne kaydeder. 

IIS alt uygulama yapılandırması hakkında bilgi için bkz. 1 1S ile Windows üzerinde 
ASP.NET Core barındırma. 

AspNetCore öğesinin öznitelikleri 

ÖZNITELIK AÇIKLAMA VARSAYILAN 


arguments isteğe bağlı dize 

özniteliği. 

ProcessPathiçinde 

belirtilen yürütülebilir 
dosya için bağımsız 
değişkenler. 


disableStartllpErrorPage isteğe bağlı Boolean false 

özniteliği. 

Doğru ise, 502,5-lşlem 

hatası sayfası bastırılır ve 
Web. config dosyasında 
yapılandırılan 502 durum 
kodu sayfası önceliklidir. 









OZNITELIK 


AÇIKLAMA 


VARSAYILAN 


forwardWindowsAuthToken isteğe bağlı Boolean true 

özniteliği. 

True ise belirteç, istek 
başına 1 MS- 
ASPNETCORE- 
WıNAUTHTOKEN 1 üst 
bilgisi olarak% 

ASPNETCORE_PORT% 
üzerinde dinleme yapan 
alt işleme iletilir. Bu, istek 
başına bu belirteçte 
CloseHandle çağırma 
işleminin 

sorumluluğundadır. 


hostingModel 

isteğe bağlı dize 

OutOfProcess 


özniteliği. 

outofprocess 


Barındırma modelini işlem 
içi ( InProcess / 
inprocess ) veya işlem 
dişi ( OutOfProcess / 
outofprocess ) olarak 

belirtir. 


processesPerApplication 

isteğe bağlı tamsayı 
özniteliği. 

ProcessPath ayarında 
belirtilen işlemin örnek 
sayısını, uygulama başına 
bir şekilde işleyecek 
şekilde belirtir. 

Varsayılan: ı 

Min: ı 

En fazla: 100 + 


tlşlem içi barındırma İçin, 
değer ı ile sınırlıdır. 

processesPerApplication 

ayarlama önerilmez. Bu 
öznitelik gelecek bir 
sürümde kaldırılacak. 


processPath 

Gerekli dize özniteliği. 



HTTP isteklerini dinleyen 
bir işlemi başlatan 
yürütülebilir dosyanın 
yolu. Göreli yollar 
desteklenir. Yol . ile 
başlıyorsa, yol site 
köküne göreli olarak 
kabul edilir. 











OZNITELIK 


AÇIKLAMA 


VARSAYILAN 


r'apidFailsPer'Minute 


r'equestT imeout 


shutdownTimeLimit 


isteğe bağlı tamsayı 
özniteliği. 

ProcessPath içinde 
belirtilen işleme dakika 
başına kilitlenme için izin 
verilen sayıyı belirtir. Bu 
sınır aşılırsa modül, 
dakika geri kalanı için 
işlemi başlatmayı 
durduruyor. 

işlem içi barındırma ile 
desteklenmez. 


Varsayılan: 10 


Min: 

0 


En fazla: 

100 


isteğe bağlı TimeSpan 
özniteliği. 

ASP.NET Core 

modülünün,% 
ASPNETCORE_PORT% 

üzerinde dinleme 
işleminden yanıt beklediği 
süreyi belirtir. 

Varsayılan: 00:02:00 

Min: 00:00:00 

En fazla: 360:00:00 

ASP.NET Core 2,1 veya 
üzeri sürümü ile birlikte 
gelen ASP.NET Core 
modülünün 

sürümlerinde, 
requestTimeout saat, 

dakika ve saniye olarak 
belirtilir. 


işlem içi barındırma için 
uygulanmaz, işlem içi 
barındırma için modül, 
uygulamanın isteği 
işlemesini bekler. 


Dizenin dakika ve saniye 
kesimleri için geçerli 
değerler 0-59 
aralığındadır. Dakika veya 
saniye değerindeki 60 
kullanımı, 500 -iç sunucu 
hatasınaneden olur. 



isteğe bağlı tamsayı 

Varsayılan: 10 

özniteliği. 

Min: 0 

App_offline. htm dosyası 
algılandığında, modülün 
yürütülebilir dosyanın 
düzgün şekilde 
kapatılmasını beklediği 
saniye cinsinden süre. 

En fazla: 600 










OZNITELIK 


AÇIKLAMA 


VARSAYILAN 


startupTimeLimit 


stdoutLogEnabled 


isteğe bağlı tamsayı 
özniteliği. 

Modülün, bağlantı 
noktasında dinleme 
yapan bir işlemin 
başlamasını bekleyeceği 
saniye cinsinden süre. Bu 
süre sınırı aşılırsa, modül 
işlemi bu işlemden sonra 
da bir kez gider. Modül, 
yeni bir istek aldığında 
işlemi yeniden başlatmayı 
dener ve uygulamanın 
son geçen dakikada 
rapidFailsPerMinute 
kez başlayamadığı sürece 
sonraki gelen isteklerde 
işlemi yeniden başlatmayı 
dener. 

0 (sıfır) değeri sonsuz bir 
zaman aşımı olarak kabul 

edilmez . 


Varsayılan: 120 


Min: 

0 


En fazla: 

3600 


isteğe bağlı Boolean 
özniteliği. 

True ise, processPath 
içinde belirtilen işlem için 
stdout ve stderr, 
stdoutLogFileiçinde 

belirtilen dosyaya 
yeniden yönlendirilir. 


f alse 







OZNITELIK 


AÇIKLAMA 


VARSAYILAN 


stdoutLogFile isteğe bağlı dize aspnetcore-stdout 

özniteliği. 

ProcessPath içinde 
belirtilen işlemden stdout 
ve stderr 'in günlüğe 
kaydedildiği göreli veya 
mutlak dosya yolunu 
belirtir. Göreli yollar, 
sitenin köküne göredir. 

. başlayan tüm yollar 
site köküne göredir ve 
diğer tüm yollar mutlak 
yollar olarak 
değerlendirilir. Yolda 
sunulan klasörler, günlük 
dosyası 

oluşturulduğunda modül 
tarafından oluşturulur. Alt 
çizgi sınırlayıcılarını 
kullanma, bir zaman 
damgası, işlem KİMLİĞİ 
ve dosya uzantısı (. log) 
stdoutLogFile yolunun 
son kesimine eklenir. 

. \logs\stdout bir 
değer olarak sağlandıysa, 

2/5/2018 işlem 1934 
KİMLİĞİ ile 19:41:32 ' de 
tarihinde kaydedildiğinde 
Günlükler klasöründe 
stdout_2018020519413 
2_ 1934. log dosyasına 
bir örnek stdout günlüğü 
kaydedilir. 


Ortam değişkenlerini ayarlama 

processPath özniteliğinde işlem için ortam değişkenleri belirtilebilir. Bir 

<environmentVariables> koleksiyon Öğesinin <environmentVariable> alt Öğesiyle bir 
ortam değişkeni belirtin. Bu bölümde ayarlanan ortam değişkenleri, sistem ortamı 
değişkenlerine göre önceliklidir. 

Aşağıdaki örnek iki ortam değişkenini ayarlar. aspnetcore_environment , uygulamanın 
ortamını Development olarak yapılandırır. Bir geliştirici, uygulama özel durumunda hata 
ayıklarken Geliştirici özel durum sayfasını yüklemeye zorlamak için bu değeri geçici 
olarak Web. corıfig dosyasında ayarlayabilir. config_dir , geliştiricinin, uygulamanın 
yapılandırma dosyasını yüklemek için bir yol oluşturmak üzere başlangıçta değeri 
okuyan kodu yazdığı Kullanıcı tanımlı ortam değişkenine bir örnektir. 









<aspNetCore processPath="dotnet" 
arguments=". \MyApp.dll" 
stdoutl_ogEnabled="false" 
stdoutLogFile=". \logs\stdout" 
hostingModel="inprocess"> 

<environmentVariables> 

<environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" /> 
<environmentVariable name="CONFIG_DIR" value="f: \application_config" /> 
</environmentVariables> 

</aspNetCore> 


NOTE 

Ortamı doğrudan Web. config içinde ayarlamaya alternatif olarak, <EnvironmentName> 
özelliği Publish profile (. pubxml) veya proje dosyasına dahil edilir. Bu yaklaşım, proje 
yayımlandığında Web. config içinde ortamı ayarlar: 

<PropertyGroup> 

<EnvironmentName>Development</EnvironmentName> 

</Pr'oper'tyGroup> 


WARNING 

Yalnızca aspnetcore environment ortam değişkenini, Internet gibi güvenilmeyen ağlarla 
erişilemeyen hazırlama ve test sunucularında Development olarak ayarlayın. 


app_offline. htm 

Bir uygulamanın kök dizininde app_offime. htm adlı bir dosya algılanırsa, ASP.N ET 
Core modülü uygulamayı düzgün bir şekilde kapatmaya ve gelen istekleri işlemeyi 
durdurmaya çalışır. Uygulama, shutdownTimeLimit 1 da tanımlanan saniye sayısından 
sonra hala çalışıyorsa, AS P.N ET Core modülü çalışan işlemi de yok eder. 

App_offline. htm dosyası mevcut olsa da ASP.NET Core modülü, istekleri, app_offline. 
htm dosyasının içeriğini geri göndererek yanıtlar. App_offiıne. htm dosyası 
kaldırıldığında, sonraki istek uygulamayı başlatır. 

işlem dışı barındırma modeli kullanılırken, açık bir bağlantı varsa uygulama hemen 
kapanmayabilir. Örneğin, bir VVebSocket bağlantısı, uygulamanın kapatılmasını 
erteleyebilir. 

Başlatma hatası sayfası 

Hem işlem içi hem de işlem dışı barındırma, uygulamayı başlatamadıklarında özel hata 
sayfaları üretir. 

ASP.NET Core modülü işlem içi veya işlem dışı istek işleyicisini bulamazsa, 500,0-işlem 
içi/işlem dışı Işleyiciyükleme hatası durum kodu sayfası görüntülenir. 

ASP.NET Core modülü uygulamayı başlatamadığında işlem içi barındırma için, 500,30- 
başlatma hatası durum kodu sayfası görüntülenir. 

ASP.NET Core modülü arka uç işlemini başlatamadığında veya arka uç işlemi 
başlatılırsa ancak yapılandırılmış bağlantı noktasında dinleyemediğinde, işlem dışı 
barındırma için 502,5-lşlem hatası durum kodu sayfası görüntülenir. 








Bu sayfayı bastırın ve varsayılan 11S 5xx durum kodu sayfasına dönmek için 
disablestartupErrorPage özniteliğini kullanın. Özel hata iletilerini yapılandırma 
hakkında daha fazla bilgi için bkz. http hataları <httpErrors >. 

Günlük oluşturma ve yeniden yönlendirme 

aspNetcore öğesinin stdoutLogEnabled ve stdoutLogFile öznitelikleri ayarlandıysa 
ASP.NET Core modülü stdout ve stderr konsol çıkışını diske yönlendirir. stdoutLogFile 
yolundaki klasörler, günlük dosyası oluşturulduğunda modül tarafından oluşturulur. 
Uygulama havuzunun, günlüklerin yazıldığı konuma yazma erişimi olması gerekir 
(yazma izni sağlamak için us AppPooi\<app_pooi_name> kullanın). 

İşlem geri dönüştürme/yeniden başlatma gerçekleşmediği sürece Günlükler 
döndürülemez. Bu, günlüklerin tükettiği disk alanını sınırlamak için barındırıcının 
sorumluluğundadır. 

Stdout günlüğünün kullanılması yalnızca 11S 'de barındırırken veya Visual Studio İle IIS 
için geliştirme zamanı desteğikullanılırken değil, yerel olarak hata ayıklarken ve 
uygulamayı IIS Express ile çalıştırırken yalnızca uygulama başlatma sorunlarını 
gidermek için önerilir. 

Genel uygulama günlüğü amaçları için stdout günlüğünü kullanmayın. ASP.NET Core 
uygulamasında rutin günlük kaydı için, günlük dosyası boyutunu sınırlayan ve 
günlükleri döndüren bir günlüğe kaydetme kitaplığı kullanın. Daha fazla bilgi için bkz. 

üçüncü taraf günlüğü sağlayıcıları. 

Günlük dosyası oluşturulduğunda zaman damgası ve dosya uzantısı otomatik olarak 
eklenir. Günlük dosyası adı, alt çizgi ile ayrılmış stdoutLogFile yolunun (genellikle 
stdout) son kesimine zaman damgası, işlem kimliği ve dosya uzantısı (. log) eklenerek 
oluşur. stdoutLogFile yolu stdout\\e sonlanıyorsa, 1934 ' de 19:42:32 2/5/2018 ' de 
oluşturulan PID 'sine sahip bir uygulama için bir günlük dosyası 
stdout_20180205194132_1934. /ogdosya adına sahiptir. 

stdoutLogEnabled false ise, uygulama başlangıcında oluşan hatalar yakalanır ve 30 KB 
'a kadar olay günlüğüne yayınlanır. Başlangıçtan sonra tüm ek Günlükler atılır. 

Aşağıdaki örnek aspNetcore öğesi, bir göreli yol .\iog\ stdout günlüğünü yapılandırır. 
AppPool Kullanıcı kimliğinin, belirtilen yola yazma izni olduğunu doğrulayın. 

<aspNetCore processPath="dotnet" 
arguments=" .\MyApp.dll" 
stdoutLogEnabled="true" 
stdoutLogFile=". \logs\stdout" 
hostingModel="inprocess"> 

</aspNetCore> 

Azure App Service dağıtım için bir uygulama yayımlarken, Web SDK stdoutLogFile 
değerini \\?\%home%\LogFiies\stdout olarak ayarlar. %home ortam değişkeni, Azure App 
Service tarafından barındırılan uygulamalar için önceden tanımlanmıştır. 

Yol biçimleri hakkında daha fazla bilgi için bkz. Windows sistemlerinde dosya yolu 
biçimleri. 


Gelişmiş tanılama günlükleri 















ASP.NET Core modülü, gelişmiş tanılama günlükleri sağlamak için yapılandırılabilir. 
<handierSettings> öğesini Web. config\çr\dek\ <aspNetcore> öğesine ekleyin. 
debugLevel trace olarak ayarlamak, tanılama bilgilerini daha yüksek bir şekilde 
kullanıma sunar: 

<aspNetCore processPath="dotnet" 
arguments=" .\MyApp.dll" 
stdoutLogEnabled="false" 
stdoutLogFile="\\?\%home%\LogFiles\stdout" 
hostingModel="inprocess"> 

<handlerSettings> 

■chandlerSetting name="debugFile" value=". \logs\aspnetcore-debug. log" /> 
<handlerSetting name="debugLevel" value="FILE,TRACE" /> 

</handlerSettings> 

</aspNetCore> 

<handierSetting> değerine (önceki örnekteki Günlükler) belirtilen yoldaki klasörler, 
otomatik olarak modül tarafından oluşturulmaz ve dağıtımda önceden var olmalıdır. 
Uygulama havuzunun, günlüklerin yazıldığı konuma yazma erişimi olması gerekir 
(yazma izni sağlamak için us AppPooi\<app_pooi_name> kullanın). 

Hata ayıklama düzeyi ( debugLevel ) değerleri hem düzeyi hem de konumu içerebilir. 

Düzeyler (en az ayrıntıdan en fazla ayrıntı sırasına göre): 

• HATAYLA 

• VVARNING 

• BİLGİSİNE 

• TRACE 

Konumlar (birden çok konuma izin verilir): 

• KONSOLA 

• EVENTLOG 

• DOSYASYNY 

İşleyici ayarları, ortam değişkenleri aracılığıyla da kullanılabilir: 

• hata ayıklama günlük dosyasının - yolunu aspnetcore_module_debug_file . 
(Varsayılan: aspnetcore-Debug. log) 

• Hata ayıklama düzeyi ayarını - aspnetcore_module_debug . 


VVARNING 

Bir sorunu gidermek için dağıtımda hata ayıklama günlüğü 'nün gerekenden uzun süre etkin 
bırakmayın. Günlüğün boyutu sınırlı değil. Hata ayıklama günlüğünün etkin bırakılması, 
kullanılabilir disk alanını tüketebilir ve sunucu veya App Service 'i kilitlemez. 


Web. config dosyasındaki aspNetcore öğesinin bir örneği için bkz. Web. config ile 
yapılandırma . 

Proxy yapılandırması HTTP protokolünü ve eşleştirme 
belirtecini kullanır 

Yalnızca işlem dışı barındırma için geçerlidir. 











ASP.NET Core modülü ve Kestrel arasında oluşturulan ara sunucu HTTP protokolünü 
kullanır. Modül ve Kestrel arasındaki trafiği sunucu dışı bir konumdan bırakırken gizlice 
dinleme riski yoktur. 

Eşleştirme belirteci, Kestrel tarafından alınan isteklerin 11S tarafından proxy aldığından 
ve başka bir kaynaktan gelmediğinden emin olmak için kullanılır. Eşleştirme belirteci 
oluşturulur ve modül tarafından bir ortam değişkenine ( aspnetcore_token ) ayarlanır. 
Eşleştirme belirteci, her proxy isteğinde de bir üst bilgi ( ms-aspnetcore-token ) olarak 
ayarlanır. MS ara yazılımı, eşleştirme belirteci üstbilgi değerinin ortam değişkeni 
değeriyle eşleşip eşleşmediğini doğrulamak için aldığı her isteği denetler. Belirteç 
değerleri uyuşmadıysa, istek günlüğe kaydedilir ve reddedilir. Eşleştirme belirteci ortam 
değişkeni ve modülle Kestrel arasındaki trafik, sunucu dışında bir konumdan erişilebilir 
değildir. Eşleştirme belirteç değerini bilmeden, bir saldırgan IIS ara yazılımı 'ndaki 
denetimi atlayan istekleri gönderemez. 

IIS paylaşılan yapılandırmasıyla ASP.NET Core modülü 

ASP.NET Core modülü yükleyicisi, Trustedlnstaller hesabının ayrıcalıklarıyla çalışır. 

Yerel sistem hesabı, IIS paylaşılan Yapılandırması tarafından kullanılan paylaşım yolu 
için değiştirme iznine sahip olmadığından, yükleyici,' deki ApplicationHost. config 
dosyasında modül ayarlarını yapılandırmaya çalışırken bir erişim reddedildi hatası atar, 
paylaşma. 

IIS yüklemesiyle aynı makinede bir IIS paylaşılan yapılandırması kullanırken, 
opt_no_shared_config_check parametresi ı olarakayarlananASP.NET Core 
barındırma paketi yükleyicisini çalıştırın: 

dotnet- hoşting-{VE RSIONj.exe 0PT_N0_SHARED_C0NFIG_CHECK=1 

Paylaşılan yapılandırmanın yolu IIS yüklemesiyle aynı makinede olmadığında, şu 
adımları izleyin: 

1. IIS paylaşılan yapılandırmasını devre dışı bırakın. 

2. Yükleyiciyi çalıştırın. 

3. Güncelleştirilmiş ApplicationHost. config dosyasını paylaşıma dışarı aktarın. 

4. IIS paylaşılan yapılandırmasını yeniden etkinleştirin. 

Modül sürümü ve barındırma paketi yükleyici 
günlükleri 

Yüklü ASP.NET Core modülünün sürümünü öğrenmek için: 

1. Barındırma sisteminde %windir%\system32\inetsrv dizinine gidin. 

2. Aspnetcore. dil dosyasını bulun. 

3. Dosyaya sağ tıklayın ve bağlam menüsünden Özellikler 1 i seçin. 

4. Ayrıntılar sekmesini seçin. Dosya sürümü ve ürün sürümü , modülün yüklü 
sürümünü temsil eder. 

Modülün barındırma paketi yükleyici günlükleri, C:\kullanicilar\% 
username%\AppData\yerel\Tempkor\umur\da bulunur. Dosya, 
dd_DotNetCoreWinSvrHosting__<zaman damgasi > _000_Aspnetcoremodupa_x64. 
log olarak adlandırılmıştır. 






Modül, şema ve yapılandırma dosyası konumları 

Modül 

IIS (X86/AMD64): 

• %windir%\System32\inetsrv\aspnetcore.dll 

• %windir%\SysWOW64\inetsrv\aspnetcore.dll 

• %ProgramFiles%\IIS\Asp. Net Core Module\v2\aspnetcorev2,dll 

• % ProgramFiles (x86)%\ ııs\ ASP.NET Core Module\v2\aspnetcorev2,dll 
IIS Express (X86/AMD64): 

• %ProgramFiles%\IIS Express\aspnetcore.dll 

• % ProgramFiles (x86)%\ IIS Express\aspnetcore.dll 

• %ProgramFiles%\IIS Express\Asp.Net Core Module\v2\aspnetcorev2,dll 

• % ProgramFiles (x86)%\ IIS Express\Asp.Net Core Module\v2\aspnetcorev2,dll 

Şema 

ISS 

• %windir%\System32\inetsrv\config\schema\aspnetcore_schema.xml 

• %windir%\System32\inetsrv\config\schema\aspnetcore_schema_v2.xml 

IIS Express 

• %ProgramFiles%\IIS Express\config\schema\aspnetcore_schema.xml 

• %ProgramFiles%\IIS Express\config\schema\aspnetcore_schema_v2.xml 

Yapılandırma 

ISS 

• %Windir%\System32\inetsrv\config\applicationHost,config 

IIS Express 

• Visual Studio: {APPLICATION ROOT} \. Vs\config\applicationhost,config 

• usexpress. exe 

CLI:%USERPROFILE%\Documents\IISExpress\config\applicationhost.config 

Dosyalar, ApplicationHost. config dosyasında aspnetcore ' u arayarak bulunabilir. 

ASP.NET Core modülü, Web isteklerini arka uca ASP.NET Core uygulamalarına 
iletmek için IIS ardışık düzenine takılan yerel bir IIS modülüdür. 

Desteklenen Windows sürümleri: 

• VVİndovvs 7 veya üzeri 

• VVİndovvs Server 2008 R2 veya üzeri 

Modül yalnızca Kestrel ile birlikte kullanılabilir. Modül, http. sysile uyumsuzdur. 

ASP.NET Core uygulamalar IIS çalışan işleminden ayrı bir işlemde çalıştığından, modül 
işlem yönetimini de işler. Modül, ilk istek ulaştığında ASP.NET Core App işlemini 


başlatır ve kilitlenirse uygulamayı yeniden başlatır. Bu aslında, VVİndovvs İşlem 
etkinleştirme hizmeti (vvas)tarafından yönetilen US 'de işlem içinde çalışan ASP.NET 4. 
x uygulamaları ile görüldüğü aynı davranıştır. 

Aşağıdaki diyagramda US, ASP.NET Core modülü ve bir uygulama arasındaki ilişki 
gösterilmektedir: 

HTTP 



US 

Internet 

(w3wp.exe) 

/~^\ HTTP 

ASP.NET Core Modüle 

C_3* * 

0 


http://contoso.com 


ASP.NET Core application 

(dotnetexe) 


Kestrel 

HttpContext Application code 

* 0 

« * © 


httpv'/Iocalhost 1234 


İstekler Web 'den çekirdek modu HTTP, sys sürücüsüne ulaşır.Sürücü, istekleri Web 
sitesinin yapılandırılmış bağlantı noktasında US 'ye yönlendirir, genellikle 80 (HTTP) 
veya 443 (HTTPS). Modül, 80 veya 443 numaralı bağlantı noktası olmayan uygulama 
için rastgele bir bağlantı noktasında istekleri Kestrel 'e iletir. 

Modül, başlangıç sırasında bir ortam değişkeni aracılığıyla bağlantı noktasını belirtir ve 
US tümleştirme ara sunucusu, http://iocaihost:{port} 1 i dinlemek için sunucuyu 
yapılandırır. Ek denetimler gerçekleştirilir ve modülünden kaynaklanmayan istekler 
reddedilir. Modül HTTPS iletmeyi desteklemez, bu nedenle istekler HTTPS üzerinden 
US tarafından alınsa bile HTTP üzerinden iletilir. 

Kestrel, isteği modülden başlattıktan sonra, istek AS P.N ET Core ara yazılım ardışık 
düzenine gönderilir. Ara yazılım ardışık düzeni isteği işler ve uygulamanın mantığına 
HttpContext örneği olarak geçirir. US tümleştirmesi tarafından eklenen ara yazılım, 
isteği Kestrel iletmek için düzen, uzak İP ve pathbase 'i hesaba göre güncelleştirir. 
Uygulamanın yanıtı US 'e geri geçirilir ve bu, isteği başlatan HTTP istemcisine geri 
gönderilir. 

VVİndovvs kimlik doğrulaması gibi birçok yerel modül etkin kahr.ASP.NET Core 
modülüyle etkin US modülleri hakkında daha fazla bilgi için, bkz. ASP.NET Core içeren 
US modülleri. 

ASP.NET Core modülü de şunları yapabilir: 

• Çalışan işlem için ortam değişkenlerini ayarlayın. 

• Başlatma sorunlarını gidermek için stdout çıkışını dosya depolama alanına kaydedin. 

• VVİndovvs kimlik doğrulama belirteçlerini ilet. 

ASP.NET Core modülünü yüklemek ve kullanmak 

AS P.N ET Core modülünün nasıl yükleneceğine ilişkin yönergeler için bkz. .N ET Core 
barındırma paketi 'Ni yüklemek. 

Web. config ile yapılandırma 

ASP.NET Core modülü, sitenin Web. config dosyasındaki system.webserver 
düğümünün aspNetcore bölümü ile yapılandırılır. 

Aşağıdaki Web. config dosyası, çerçeveye bağlı bir dağıtım İçin yayımlanır ve AS P.N ET 
Core modülünü site isteklerini işleyecek şekilde yapılandırır: 













<?xml version="1.0" encoding="utf-8"?> 

<configuration> 

<system.webServer> 

<handlers> 

<add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModule" 
resourceType="Unspecified" /> 

</handlens> 

<aspNetCore processPath="dotnet" 

arguments=". \MyApp.dll" 
stdoutLogEnabled="false" 
stdoutLogFile=". \logs\stdout" /> 

</system.webServer> 

</configuration> 


Aşağıdaki V/eb. config , kendinden bağımsız bir dağıtımiçin yayımlanır: 

<?xml version="1.0" encoding="utf-8"?> 

<configunation> 

<system.webServer> 

<handlers> 

<add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModule" 
resourceType="Unspecified" /> 

</handlers> 

<aspNetCore processPath=". \MyApp.exe" 
stdoutLogEnabled="false" 
stdoutLogFile=". \logs\stdout" /> 

</system.webServer> 

</configuration> 

Bir uygulama Azure App S ervicedağıtıIdığında stdoutLogFile yolu 
\\?\%home%\LogFiies\stdout olarak ayarlanır. Yol, stdout günlüklerini hizmet tarafından 
otomatik olarak oluşturulan bir konum olan LogFiles klasörüne kaydeder. 

IIS alt uygulama yapılandırması hakkında bilgi için bkz. 11 S ile Windows üzerinde 
ASP.NET Core barındırma. 

AspNetCore öğesinin öznitelikleri 

ÖZNITELIK AÇIKLAMA VARSAYILAN 


arguments isteğe bağlı dize 

özniteliği. 

ProcessPathiçinde 

belirtilen yürütülebilir 
dosya için bağımsız 
değişkenler. 


disableStartllpErrorPage isteğe bağlı Boolean false 

özniteliği. 

Doğru ise, 502,5-lşlem 
hatası sayfası bastırılır ve 
Web. config dosyasında 
yapılandırılan 502 durum 
kodu sayfası önceliklidir. 









OZNITELIK 


AÇIKLAMA 


VARSAYILAN 


f or'wardWindowsAuthToken 


processesPerApplication 


processPath 


rapidFailsPerMinute 


isteğe bağlı Boolean 
özniteliği. 

True ise belirteç, istek 
başına 1 MS- 
ASPNETCORE- 
WıNAUTHTOKEN 1 üst 
bilgisi olarak% 
ASPNETCORE_PORT% 
üzerinde dinleme yapan 
alt işleme iletilir. Bu, istek 
başına bu belirteçte 
CloseHandle çağırma 
işleminin 

sorumluluğundadır. 


isteğe bağlı tamsayı 
özniteliği. 

ProcessPath ayarında 
belirtilen işlemin örnek 
sayısını, uygulama başına 
bir şekilde işleyecek 
şekilde belirtir. 

processesPerApplication 
ayarlama önerilmez. Bu 
öznitelik gelecek bir 
sürümde kaldırılacak. 


Varsayılan: ı 


Min: 

1 


En fazla: 

100 


Gerekli dize özniteliği. 

HTTP isteklerini dinleyen 
bir işlemi başlatan 
yürütülebilir dosyanın 
yolu. Göreli yollar 
desteklenir. Yol . ile 
başlıyorsa, yol site 
köküne göreli olarak 
kabul edilir. 


isteğe bağlı tamsayı 

Varsayılan: 10 

özniteliği. 

Min: 0 

ProcessPath içinde 
belirtilen işleme dakika 
başına kilitlenme için izin 
verilen sayıyı belirtir. Bu 
sınır aşılırsa modül, 
dakika geri kalanı için 
işlemi başlatmayı 
durduruyor. 

En fazla: 100 











OZNITELIK 


AÇIKLAMA 


VARSAYILAN 


r'equestT imeout 


shutdownTimeLimit 


startupTimeLimit 


isteğe bağlı TimeSpan 
özniteliği. 

ASP.NET Core 
modülünün,% 
ASPNETCORE_PORT% 
üzerinde dinleme 
işleminden yanıt beklediği 
süreyi belirtir. 

ASP.NET Core 2,1 veya 
üzeri sürümü ile birlikte 
gelen ASP.NET Core 
modülünün 
sürümlerinde, 
requestTimeout saat, 
dakika ve saniye olarak 
belirtilir. 


isteğe bağlı tamsayı 
özniteliği. 

App_offline. htm dosyası 
algılandığında, modülün 
yürütülebilir dosyanın 
düzgün şekilde 
kapatılmasını beklediği 
saniye cinsinden süre. 


isteğe bağlı tamsayı 
özniteliği. 

Modülün, bağlantı 
noktasında dinleme 
yapan bir işlemin 
başlamasını bekleyeceği 
saniye cinsinden süre. Bu 
süre sınırı aşılırsa, modül 
işlemi bu işlemden sonra 
da bir kez gider. Modül, 
yeni bir istek aldığında 
işlemi yeniden başlatmayı 
dener ve uygulamanın 
son geçen dakikada 
rapidFailsPerMinute 
kez başlayamadığı sürece 
sonraki gelen isteklerde 
işlemi yeniden başlatmayı 
dener. 

0 (sıfır) değeri sonsuz bir 
zaman aşımı olarak kabul 

edilmez . 


Varsayılan: 00:02:00 
Min: 00:00:00 
En fazla: 360:00:00 


Varsayılan: 10 
Min: 0 
En fazla: 600 


Varsayılan: 120 
Min: 0 

En fazla: 3600 











OZNITELIK 


AÇIKLAMA 


VARSAYILAN 


stdoutLogEnabled 


isteğe bağlı Boolean 
özniteliği. 

True ise, processPath 
içinde belirtilen işlem için 
stdout ve stderr, 
stdoutLogFileiçinde 

belirtilen dosyaya 
yeniden yönlendirilir. 


f alse 


stdoutLogFile isteğe bağlı dize aspnetcore-stdout 

özniteliği. 

ProcessPath içinde 
belirtilen işlemden stdout 
ve stderr 'in günlüğe 
kaydedildiği göreli veya 
mutlak dosya yolunu 
belirtir. Göreli yollar, 
sitenin köküne göredir. 

. başlayan tüm yollar 
site köküne göredir ve 
diğer tüm yollar mutlak 
yollar olarak 
değerlendirilir. Modülün 
günlük dosyasını 
oluşturması için yolda 
sunulan klasörlerin 
bulunması gerekir. Alt 
çizgi sınırlayıcılarını 
kullanma, bir zaman 
damgası, işlem KİMLİĞİ 
ve dosya uzantısı (. log) 
stdoutLogFile yolunun 
son kesimine eklenir. 

. \logs\stdout bir 
değer olarak sağlandıysa, 

2/5/2018 işlem 1934 
KİMLİĞİ ile 19:41:32 ' de 
tarihinde kaydedildiğinde 
Günlükler klasöründe 
stdout_2018020519413 
2_1934. log dosyasına 
bir örnek stdout günlüğü 
kaydedilir. 


Ortam değişkenlerini ayarlama 

processPath özniteliğinde işlem için ortam değişkenleri belirtilebilir. Bir 
<environmentVariables> koleksiyon Öğesinin <environmentVariable> alt Öğesiyle bir 
ortam değişkeni belirtin. 









VVARNING 

Bu bölümde ayarlanan ortam değişkenleri, aynı ada sahip sistem ortam değişkenleri ile 
çakışıyor. Bir ortam değişkeni hem Web. config dosyasında hem de Windows 'un sistem 
düzeyinde ayarlandıysa, Web. config dosyasındaki değer sistem ortam değişkeni değerine 
(örneğin, aspnetcore_environment: Development;Development ) eklenerek uygulamanın 
şunlar. 


Aşağıdaki örnek iki ortam değişkenini ayarlar. aspnetcore_environment , uygulamanın 
ortamını Development olarak yapılandırır. Bir geliştirici, uygulama özel durumunda hata 
ayıklarken Geliştirici özel durum sayfasını yüklemeye zorlamak için bu değeri geçici 
olarak Web. config dosyasında ayarlayabilir. config_dir , geliştiricinin, uygulamanın 
yapılandırma dosyasını yüklemek için bir yol oluşturmak üzere başlangıçta değeri 
okuyan kodu yazdığı Kullanıcı tanımlı ortam değişkenine bir örnektir. 

<aspNetCore processPath="dotnet" 
arguments=". \MyApp.dll" 
stdoutLogEnabled="false" 

stdoutLogFile="\\?\%home%\LogFiles\stdout"> 

<environmentVariables> 

<environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" /> 
<environmentVariable name="CONFIG_DIR" value="f: \application_config" /> 
</environmentVariables> 

</aspNetCore> 


VVARNING 

Yalnızca aspnetcore environment ortam değişkenini, Internet gibi güvenilmeyen ağlarla 
erişilemeyen hazırlama ve test sunucularında Development olarak ayarlayın. 


app_offline. htm 

Bir uygulamanın kök dizininde app_offline. htm adlı bir dosya algılanırsa, ASP.N ET 
Core modülü uygulamayı düzgün bir şekilde kapatmaya ve gelen istekleri işlemeyi 
durdurmaya çalışır. Uygulama, shutdownTimeLimit 1 da tanımlanan saniye sayısından 
sonra hala çalışıyorsa, AS P.N ET Core modülü çalışan işlemi de yok eder. 

App_offline. htm dosyası mevcut olsa da ASP.NET Core modülü, istekleri, app_offline. 
htm dosyasının içeriğini geri göndererek yanıtlar. App_offline. htm dosyası 
kaldırıldığında, sonraki istek uygulamayı başlatır. 

Başlatma hatası sayfası 

AS P.N ET Core modülü arka uç işlemini başlatamaz veya arka uç işlemi başlatılır, ancak 
yapılandırılmış bağlantı noktasında dinleme başarısız olursa, 502,5-lşlem hatasL durum 
kodu sayfası görüntülenir. Bu sayfayı bastırın ve varsayılan 11S 502 durum kodu 
sayfasına dönmek için disablestartupErrorPage özniteliğini kullanın. Özel hata 
iletilerini yapılandırma hakkında daha fazla bilgi için bkz. http hataları <httpErrors >. 













- □ X 
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Common causes of this issue: 

• The application process failed to start 

• The application process started but then stopped 

• The application process started but failed to listen on the configured port 


Troubleshooting steps: 

• Check the system event log for error messages 

• Enable logging the application process 1 stdout messages 

• Attach a debugger to the application process and ınspect 


For more information visit: http:// go.microsoft.com/ fwlink/?LinkID=808681 


B IIS 502.5 Error X + 

O (nî I localhost:900i 

HTTP Error 502.5 - Process Failure 


Günlük oluşturma ve yeniden yönlendirme 

aspNetcone öğesinin stdoutLogEnabled ve stdoutLogFile öznitelikleri ayarlandıysa 
ASP.NET Core modülü stdout ve stderr konsol çıkışını diske yönlendirir. stdoutLogFile 
yolundaki klasörler, günlük dosyası oluşturulduğunda modül tarafından oluşturulur. 
Uygulama havuzunun, günlüklerin yazıldığı konuma yazma erişimi olması gerekir 
(yazma izni sağlamak için us AppPooi\<app_pooi_name> kullanın). 

İşlem geri dönüştürme/yeniden başlatma gerçekleşmediği sürece Günlükler 
döndürülemez. Bu, günlüklerin tükettiği disk alanını sınırlamak için barındırıcının 
sorumluluğundadır. 

Stdout günlüğünün kullanılması yalnızca IIS 'de barındırırken veya Visual Studio İle IIS 
için geliştirme zamanı desteğikullanılırken değil, yerel olarak hata ayıklarken ve 
uygulamayı IIS Express ile çalıştırırken yalnızca uygulama başlatma sorunlarını 
gidermek için önerilir. 

Genel uygulama günlüğü amaçları için stdout günlüğünü kullanmayın. ASP.NET Core 
uygulamasında rutin günlük kaydı için, günlük dosyası boyutunu sınırlayan ve 
günlükleri döndüren bir günlüğe kaydetme kitaplığı kullanın. Daha fazla bilgi için bkz. 

üçüncü taraf günlüğü sağlayıcıları. 

Günlük dosyası oluşturulduğunda zaman damgası ve dosya uzantısı otomatik olarak 
eklenir. Günlük dosyası adı, alt çizgi ile ayrılmış stdoutLogFile yolunun (genellikle 
stdout) son kesimine zaman damgası, işlem kimliği ve dosya uzantısı (. log ) eklenerek 
oluşur. stdoutLogFile yolu stdout\\e sonlanıyorsa, 1934 ' de 19:42:32 2/5/2018 ' de 
oluşturulan PID 'sine sahip bir uygulama için bir günlük dosyası 
stdout_20180205194132_1934. /ogdosya adına sahiptir. 

Aşağıdaki örnek aspNetcore öğesi, bir göreli yol .\iog\ stdout günlüğünü yapılandırır. 
AppPool Kullanıcı kimliğinin, belirtilen yola yazma izni olduğunu doğrulayın. 

<aspNetCore processPath="dotnet" 
arguments=" .\MyApp.dll" 
stdoutLogEnabled="true" 
stdoutLogFile=". \logs\stdout" > 

</aspNetCore> 


Azure App Service dağıtım için bir uygulama yayımlarken, Web SDK stdoutLogFile 






















değerini \\?\%home%\LogFiies\stdout olarak ayarlar. %home ortam değişkeni, Azure App 
Service tarafından barındırılan uygulamalar için önceden tanımlanmıştır. 

Günlüğe kaydetme filtresi kuralları oluşturmak için ASP.NET Core günlük belgelerinin 

yapılandırma ve günlük filtreleme bölümlerine bakın. 

Yol biçimleri hakkında daha fazla bilgi için bkz. Windows sistemlerinde dosya yolu 
biçimleri. 

Proxy yapılandırması HTTP protokolünü ve eşleştirme 
belirtecini kullanır 

ASP.NET Core modülü ve Kestrel arasında oluşturulan ara sunucu HTTP protokolünü 
kullanır. Modül ve Kestrel arasındaki trafiği sunucu dışı bir konumdan bırakırken gizlice 
dinleme riski yoktur. 

Eşleştirme belirteci, Kestrel tarafından alınan isteklerin 11S tarafından proxy aldığından 
ve başka bir kaynaktan gelmediğinden emin olmak için kullanılır. Eşleştirme belirteci 
oluşturulur ve modül tarafından bir ortam değişkenine ( aspnetcore_token ) ayarlanır. 
Eşleştirme belirteci, her proxy isteğinde de bir üst bilgi ( ms-aspnetcore-token ) olarak 
ayarlanır. 11S ara yazılımı, eşleştirme belirteci üstbilgi değerinin ortam değişkeni 
değeriyle eşleşip eşleşmediğini doğrulamak için aldığı her isteği denetler. Belirteç 
değerleri uyuşmadıysa, istek günlüğe kaydedilir ve reddedilir. Eşleştirme belirteci ortam 
değişkeni ve modülle Kestrel arasındaki trafik, sunucu dışında bir konumdan erişilebilir 
değildir. Eşleştirme belirteç değerini bilmeden, bir saldırgan 11S ara yazılımı 'ndaki 
denetimi atlayan istekleri gönderemez. 

IIS paylaşılan yapılandırmasıyla ASP.NET Core modülü 

ASP.NET Core modülü yükleyicisi, Trustedlnstaller hesabının ayrıcalıklarıyla çalışır. 

Yerel sistem hesabı, IIS paylaşılan Yapılandırması tarafından kullanılan paylaşım yolu 
için değiştirme iznine sahip olmadığından, yükleyici,' deki ApplicationHost. config 
dosyasında modül ayarlarını yapılandırmaya çalışırken bir erişim reddedildi hatası atar, 
paylaşma. 

IIS paylaşılan yapılandırması kullanırken, şu adımları izleyin: 

1. IIS paylaşılan yapılandırmasını devre dışı bırakın. 

2. Yükleyiciyi çalıştırın. 

3. Güncelleştirilmiş ApplicationHost. config dosyasını paylaşıma dışarı aktarın. 

4. IIS paylaşılan yapılandırmasını yeniden etkinleştirin. 

Modül sürümü ve barındırma paketi yükleyici 
günlükleri 

Yüklü ASP.NET Core modülünün sürümünü öğrenmek için: 

1. Barındırma sisteminde %windir%\system32\inetsrv dizinineg\d\r\. 

2. Aspnetcore. dil dosyasını bulun. 

3. Dosyaya sağ tıklayın ve bağlam menüsünden Özellikler 1 i seçin. 

4. Ayrıntılar sekmesini seçin. Dosya sürümü ve ürün sürümü , modülün yüklü 
sürümünü temsil eder. 


Modülün barındırma paketi yükleyici günlükleri, C:\kullamalar\% 





username%\AppData\yerel\Tempkorujmur\da bulunur. Dosya, 
dd_DotNetCoreW'ınSvrHost'mg__<zaman damgasi > _000_Aspnetcoremodupa_x64. 
log olarak adlandırılmıştır. 

Modül, şema ve yapılandırma dosyası konumları 

Modül 

IIS (X86/AMD64): 

• %windir%\System32\inetsrv\aspnetcore.dll 

• %windir%\SysWOW64\inetsrv\aspnetcore.dll 
IIS Express (X86/AMD64): 

• %ProgramFiles%\IIS Express\aspnetcore.dll 

• % ProgramFiles (x86)%\ IIS Express\aspnetcore.dll 

Şema 

ISS 

• %windir%\System32\inetsrv\config\schema\aspnetcore_schema.xml 

IIS Express 

• %ProgramFiles%\IIS Express\config\schema\aspnetcore_schema.xml 

Yapılandırma 

ISS 

• %Windir%\System32\inetsrv\config\applicationHost,config 

IIS Express 

• Visual Studio: {APPLICATION ROOT} \. Vs\config\applicationhost,config 

• ıısexpress. exe 

CU:%USERPROFILE%\Documents\IISExpress\config\applicationhost.config 
Dosyalar, ApplicationHost. config dosyasında aspnetcore 1 u arayarak bulunabilir. 

Ek kaynaklar 

• IIS ile VVİndovvs üzerinde ASP.NET Core barındırma 

• ASP.NET Core Modüle GitHub deposu (başvuru kaynağı) 

• ASP.NET Core içeren IIS modülleri 


ASPNET Core için Visual Studio 'da geliştirme 
zamanı MS desteği 

29.10.2019 • 10 minutes to read ı Edit Online 


, Sourabh Shirhatti ve Luke Latham tarafından 

Bu makalede, Windows Server 'da MS ile çalışan ASP.NET Core hata ayıklama için Visual Studio desteği 
açıklanmaktadır. Bu konu başlığı altında, bu senaryonun etkinleştirilmesi ve bir projenin kurulması 
anlatılmaktadır. 

Prerequisites 

• VVİndovvs için Visual Studio 

• ASP.net ve Web geliştirme iş yükü 

• .N ET Core platformlar arası geliştirme iş yükü 

• X. 509.440 güvenlik sertifikası (HTTPS desteği için) 

11S 'yi etkinleştirme 

1. VVİndovvs da, Denetim masası > Programlar > Programlar ve Özellikler > VVİndovvs özelliklerini aç 
veya kapat (ekranın sol tarafında)' ya gidin. 

2. Internet Information Services onay kutusunu seçin. Tamam ' ıseçin. 

IIS yüklemesi için sistemin yeniden başlatılması gerekebilir. 

11S 'yi yapılandırma 

IIS 'nin aşağıdaki ile yapılandırılmış bir VVeb sitesine sahip olması gerekir: 

• Ana bilgisayar adı - genellikle, varsayılan VVeb sitesi localhost ana bilgisayar adıyla kullanılır. Ancak, 
benzersiz bir ana bilgisayar adına sahip geçerli bir IIS VVeb sitesi çalışmaktadır. 

• Site bağlama 

o HTTPS gerektiren uygulamalar için, sertifika ile 443 numaralı bağlantı noktasına bir bağlama 

oluşturun. Genellikle IIS Express geliştirme sertifikası kullanılır, ancak geçerli bir sertifika çalışıyor 
olur. 

o HTTP kullanan uygulamalar için, 80 veya yeni bir site için bağlantı noktası 80 1 e bir bağlama 
oluşturmak için bir bağlamanın mevcut olduğunu onaylayın, 
o HTTP veya HTTPS için tek bir bağlama kullanın. Aynı anda hem HTTP hem de HTTPS bağlantı 
noktalarına bağlama desteklenmez. 

Visual Studio 'da geliştirme zamanı IIS desteğini etkinleştirme 

1. Visual Studio yükleyicisi'ni başlatın. 

2. IIS geliştirme zamanı desteği için kullanmayı planladığınız Visual Studio yüklemesi için Değiştir ' i seçin. 

3. ASP.net ve VVeb geliştirme iş yükü için geliştirme zamanı IIS destek bileşeni' ni bulun ve yükler. 

Bileşen, iş yüklerinin sağındaki Yükleme ayrıntıları panelinde, geliştirme zamanı IIS desteği altındaki 
isteğe bağlı bölümde listelenmiştir. Bileşen, IIS ile ASP.NET Core uygulamaları çalıştırmak için gerekli 





yerel bir 11S modülü olan ASP.NET Core modülünüyüklüyor. 

Projeyi yapılandırma 

HTTPS yönlendirmesi 

HTTPS gerektiren yeni bir proje için yeni ASP.NET Core Web uygulaması oluşturma penceresinde https 
için yapılandırmak üzere onay kutusunu seçin. Onay kutusunun belirlenmesi, uygulama oluşturulduğunda 
https yeniden yönlendirme ve HSTS ara yazılımı ekler. 

HTTPS gerektiren mevcut bir proje için, startup.configure ' da HTTPS yeniden yönlendirme ve HSTS ara 
yazılımı kullanın. Daha fazla bilgi için bkz. ASP.NET Core 'de HTTPS 'yi zorla. 

HTTP kullanan bir proje için, https yeniden yönlendirme ve HSTS ara yazılımı uygulamaya eklenmez. Uygulama 
yapılandırması gerekli değildir. 

IIS başlatma profili 

Geliştirme zamanı IIS desteği eklemek için yeni bir başlatma profili oluşturun: 

1. Çözüm Gezginiprojeye sağ tıklayın. Özellikler' i seçin. Hata Ayıkla sekmesini açın. 

2. Profiliçin Yeni düğmesini seçin. Profili, açılan pencerede "IIS" olarak adlandırın. Profili oluşturmak için 
Tamam ' ı seçin. 

3. Başlatma ayarı İçin listeden IIS 'yi seçin. 

4. Başlat tarayıcısı onay kutusunu seçin ve uç nokta URL 'sini sağlayın. 

Uygulama HTTPS gerektirdiğinde, bir HTTPS uç noktası ( https:// ) kullanın. HTTP için bir HTTP ( 
http:// ) uç noktası kullanın. 

Daha önce belirtilen IIS yapılandırmasıylaaynı ana bilgisayar adını ve bağlantı noktasını, genellikle 
localhost olarak belirtin. 

URL 'nin sonundaki uygulamanın adını belirtin. 

Örneğin, https://localhost/WebApplicationl (HTTPS) veya http : //localhost/UebApplicationl (HTTP) 
geçerli uç nokta URL 'Lardır. 

5. Ortam değişkenleri bölümünde Ekle düğmesini seçin. aspnetcore_environment adı ve Development 
değeri olan bir ortam değişkeni sağlayın. 

6. Web sunucusu ayarları alanında, Uygulama URL sini başlatma tarayıcısı uç noktası URL si için 
kullanılan aynı değere ayarlayın. 

7. Visual Studio 2019 veya sonraki sürümlerde barındırma modeli ayarı için, proje tarafından kullanılan 
barındırma modelini kullanmak üzere varsayılan ' ı seçin. Proje, proje dosyasında 

<AspNetcoreHostingModei> özelliğini ayarlarsa, özelliğin değeri ( inProcess veya outofProcess ) kullanılır. 
Özellik mevcut değilse, uygulamanın varsayılan barındırma modeli, işlem içi kullanılır. Uygulama, 
uygulamanın normal barındırma modelinden farklı bir açık barındırma modeli ayarı gerektiriyorsa, 
barındırma modelini gerektiği gibi in Process veya OutofProcess olarak ayarlayın. 

8. Profili kaydedin. 

1. Çözüm Gezginiprojeye sağ tıklayın. Özellikler' i seçin. Hata Ayıkla sekmesini açın. 

2. Profiliçin Yeni düğmesini seçin. Profili, açılan pencerede "IIS" olarak adlandırın. Profili oluşturmak için 
Tamam ' ı seçin. 


3. Başlatma ayarı İçin listeden IIS ' yi seçin. 










4. Başlat tarayıcısı onay kutusunu seçin ve uç nokta URL 'sini sağlayın. 

Uygulama HTTPS gerektirdiğinde, bir HTTPS uç noktası ( https:// ) kullanın. HTTP için bir HTTP ( 
http:// ) uç noktası kullanın. 

Daha önce belirtilen 11S yapılandırmasıylaaynı ana bilgisayar adını ve bağlantı noktasını, genellikle 
localhost olarak belirtin. 

URL 'nin sonundaki uygulamanın adını belirtin. 

Örneğin, https://localhost/WebApplicationl (HTTPS) veya http : //localhost/UebApplicationl (HTTP) 
geçerli uç nokta URL 'Lardır. 

5. Ortam değişkenleri bölümünde Ekle düğmesini seçin. aspnetcore_environment adı ve Development 
değeri olan bir ortam değişkeni sağlayın. 

6. Web sunucusu ayarları alanında, Uygulama URL sini başlatma tarayıcısı uç noktası URL si için 
kullanılan aynı değere ayarlayın. 

7. Visual Studio 2019 veya sonraki sürümlerde barındırma modeli ayarı için, proje tarafından kullanılan 
barındırma modelini kullanmak üzere varsayılan ' ı seçin. Proje, proje dosyasında 

<AspNetcoreHostingModei> özelliğini ayarlarsa, özelliğin değeri ( inProcess veya outofProcess ) kullanılır. 
Özellik mevcut değilse, uygulamanın varsayılan barındırma modeli kullanılır ve bu işlem, işlem dışı olur. 
Uygulama, uygulamanın normal barındırma modelinden farklı bir açık barındırma modeli ayarı 
gerektiriyorsa, barındırma modelini gerektiği gibi in Process veya out of Process olarak ayarlayın. 

8. Profili kaydedin. 

Visual Studio kullanmadığınız durumlarda, Özellikler klasöründeki launchsettings. JSON dosyasına el ile bir 
başlatma profili ekleyin. Aşağıdaki örnek, HTTPS protokolünü kullanmak için profili yapılandırır: 

{ 

"iisSettings": { 

"windowsAuthentication": false, 

"anonymousAuthentication": true, 

"iis": { 

"applicationUrl": "https://localhost/WebApplicationl", 

"sslPort": 0 

} 

}, 

"profiles": { 

"IIS": { 

"commandName": "IIS", 

"launchBrowser": true, 

"launchUrl": "https://localhost/WebApplicationl", 

"environmentVariables": { 

"ASPNETCORE_ENVIRONMENT": "Development" 

} 

} 

} 

} 

applicationUrl ve launchuri uç noktalarının eşleştiğini ve IIS bağlama yapılandırmasıyla aynı Protokolü 
(HTTP veya HTTPS) kullandığını doğrulayın. 

Projeyi Çalıştır 

Visual Studio 'Yu yönetici olarak çalıştırın: 

• Derleme yapılandırması açılır listesinin hata ayıklamaolarak ayarlandığını onaylayın. 













• Hata ayıklamayı Başlat düğmesini IIS profiline ayarlayın ve uygulamayı başlatmak için düğmeyi seçin. 

Visual Studio, yönetici olarak çalışmıyorsa bir yeniden başlatma isteyebilir, istenirse, Visual Studio 'Yu yeniden 
başlatın. 

Güvenilmeyen bir geliştirme sertifikası kullanılırsa, tarayıcı güvenilmeyen sertifika için bir özel durum 
oluşturmanız gerekebilir. 


NOTE 

Yalnızca kendi kodum ve derleyici İyileştirmeleriyle yayın derleme yapılandırması hata ayıklaması, düzeyi düşürülmüş bir 
deneyimle sonuçlanır. Örneğin, kesme noktaları isabet edilmez. 


Ek kaynaklar 

• IIS 'de IIS Yöneticisi 'Ni kullanmaya başlama 

• IIS ile Windows üzerinde ASP.NET Core barındırma 

• ASP.NET Core Modülü 

• ASP.NET Core'de HTTPS'yi zorla 




ASRNET Core içeren IIS modülleri 

22.05.2019 • 10 minutes to read ı Edit Online 


Tarafından Luke Latham 

Bazı yerel IIS modülleri ve tüm yönetilen IIS modüllerini ASP.NET Core uygulamaları için istekleri işlemesini 
mümkün değildir. Çoğu durumda, ASP.NET Core IIS yerel ve yönetilen modülleri tarafından ele alınan 
senaryolar için bir alternatif sunar. 

Yerel modülleri 

ASP.NET Core uygulamaları ile işlevsel yerel IIS modülleri ve ASP.NET Core modülü tabloyu belirtir. 


MODÜL 

ASP.NET CORE UYGULAMALARI İLE İŞLEV 

ASP.NET CORE SEÇENEĞİ 

Anonim kimlik doğrulaması 

AnonymousAuthent icat ionModule 

Evet 


Temel Kimlik Doğrulaması 

BasicAuthenticationModule 

Evet 


İstemci sertifika eşlemesi kimlik 
doğrulaması 

Evet 


CertificateMappingAuthenticationModule 


CGI 

CgiModule 

Hayır 


Yapılandırmayı doğrulama 

ConfigurationValidationModule 

Evet 


HTTP Hataları 

CustomErrorModule 

Hayır 

Durum kodu sayfa ara yazılımı 

Özel günlük 

CustomLoggingModule 

Evet 


Varsayılan Belge 

DefaultDocumentModule 

Hayır 

Varsayılan dosya ara yazılımı 

Özet kimlik doğrulaması 

DigestAuthenticationModule 

Evet 


Dizin Tarama 

DirectoryListingModule 

Hayır 

Dizin tarama ara yazılımı 

Dinamik sıkıştırma 

DynamicCompressionModule 

Evet 

Yanıt Sıkıştırma Ara Yazılımı 

Başarısız istek izleme 

FailedRequestsTracingModule 

Evet 

ASP.NET Core günlüğe kaydetme 
















MODÜL 

ASP.NET CORE UYGULAMALARI İLE İŞLEV 

ASP.NET CORE SEÇENEĞİ 

Dosyayı önbelleğe alma 

FileCacheModule 

Hayır 

Yanıtları Önbelleğe Alma Ara Yazılımı 

HTTP önbelleğe alma 

HttpCacheModule 

Hayır 

Yanıtları Önbelleğe Alma Ara Yazılımı 

HTTP Günlüğü 

HttpLoggingModule 

Evet 

ASP.NET Core günlüğe kaydetme 

HTTP Yeniden Yönlendirmesi 

HttpRedirectionModule 

Evet 

URL Yeniden Yazma Ara Yazılımı 

HTTP izleme 

T racingModule 

Evet 


IIS istemci sertifika eşlemesi kimlik 
doğrulaması 

Evet 


IlSCertificateMappingAuthenticationModule 


İP ve Etki Alanı Kısıtlamaları 

IpRestnictionModule 

Evet 


ISAPI Filtreleri 

IsapiFiltenModule 

Evet 

Ara Yazılım 

ISAPI 

IsapiModule 

Evet 

Ara Yazılım 

Protokol desteği 

ProtocolSupportModule 

Evet 


İstek Filtreleme 

RepuestFilteringModule 

Evet 

URL yeniden yazma ara yazılımı 

IRule 




İstek İzleyicisi 

RequestMonitorModule 

Evet 


URL yeniden yazmat 

RewriteModule 

Evet 

URL Yeniden Yazma Ara Yazılımı 

Sunucu Tarafı İçermeler 

SenverSidelncludeModule 

Hayır 


Statik sıkıştırma 

StaticCompressionModule 

Hayır 

Yanıt Sıkıştırma Ara Yazılımı 

Statik İçerik 

StaticFileModule 

Hayır 

Statik dosya ara yazılımlarını 

Belirteç önbelleğe alma 

Evet 



TokenCacheModule 



















MODÜL 


ASP.NET CORE UYGULAMALARI İLE İŞLEV 


ASP.NET CORE SEÇENEĞİ 


URI önbelleği Evet 

UriCacheModule 


URL Yetkilendirmesi Evet ASP.NET Core kimliği 

UrlAuthorizationModule 


Windows kimlik doğrulaması 

WindowsAuthenticationModule 


Evet 


+URL yeniden yazma modülü's isFile ve isDirectory eşleşme türleri ile ASP.N ET Core uygulamaları 
yapılan değişiklikler nedeniyle çalışmıyor dizin yapısı. 


Yönetilen modüller 

Yönetilen modüller değil uygulama havuzunun .NET CLR sürümü ayarlandığında barındırılan ASP.NET Core 
uygulamaları ile işlevsel yönetilen kod yok. AS P.N ET Core, bazı durumlarda ara yazılımı seçenekleri sunar. 

MODÜL ASP.NET CORE SEÇENEĞİ 


Anonymousldentification 


DefaultAuthentication 


FileAuthorization 

FormsAuthentication Tanımlama bilgisi kimlik doğrulaması ara yazılımı 

outputCache Yanıtları Önbelleğe Alma Ara Yazılımı 

Profil 


RoleManager 


ScriptModule 4.0 

Oturum Oturum ara yazılımı 


UrlAuthorization 


UrlMappingsModule URL Yeniden Yazma Ara Yazılımı 

UrlRoutingModule 4.0 ASP.NET Core kimliği 

WindowsAuthentication 

IIS Yöneticisi'ni uygulama değişiklikleri 

Ayarları yapılandırmak için IIS Yöneticisi'ni kullanırken web.config uygulamanın dosya değiştirilir. Uygulama 
dağıtımı ve dahil olmak üzere v/eb.config, IIS Yöneticisi ile yapılan değişikliklerin üzerine tarafından dağıtılan 
vveb.config dosya. Sunucunun değişiklikler yaptıysanız web.config dosya, güncelleştirilmiş Kopyala web.config 
hemen yerel proje sunucudaki dosya. 







IIS modüllerini devre dışı bırakma 

Ek olarak, uygulamanın bir uygulama için devre dışı bırakılması gereken sunucu düzeyinde bir IIS Modülü 
yapılandırılıp yapılandırılmadığını web.config dosya modül devre dışı bırakabilirsiniz. Modül yerinde bırakın 
ve bir yapılandırma ayarı (varsa) kullanarak devre dışı bırakın veya modül uygulamadan kaldırın. 

Modül devre dışı bırakma 

Fazla modül, modül uygulamadan kaldırmadan devre dışı bırakılmasına olanak veren bir yapılandırma ayarı 
sağlar. Bir modül devre dışı bırakmak için basit ve hızlı bir yolu budur. Örneğin, HTTP yeniden yönlendirme 
modülü ile devre dışı bırakılabilir <httpRedirect> öğesinde vveb.config: 

<configuration> 

<system.webServer> 

chttpRedirect enabled="false" /> 

</system.webServer> 

</configuration> 

Yapılandırma ayarlarıyla modülleri devre dışı bırakma hakkında daha fazla bilgi için bağlantıları izleyin alt 
öğeleri bölümünü IIS <system.webServer >. 

Modül kaldırma 

Bir ayar modülü kaldırmak için kabul edilirse, v/eb.config, modülün kilidini açmak ve kilidini <moduies> 
bölümünü web.config ilk: 

1. Sunucu düzeyinde modülün kilidini açın. IIS Yöneticisi'nde IIS sunucusu bağlantıları kenar çubuğu. 
Açık modülleri içinde IIS alan. Modül listesinde seçin, içinde eylemleri sağ kenar seçin kilidini. 

Modül için eylem girişi olarak görünüyorsa kilit, modül zaten açılmış ve Eylem gerekmiyor. Kilidini 
kaldırmak planlarken kadar modülleri web.config daha sonra. 

2. Gerekmeden uygulamayı dağıtma bir <moduies> konusundaki vveb.config. Bir uygulama ile dağıtılırsa 
bir web.corıfig içeren <moduies> bölüm bölüm Configuration Manager IIS Yöneticisi'nde ilk kilidi 
kalmadan, bölümün kilidini açmak çalışırken bir özel durum oluşturur. Bu nedenle, gerekmeden 
uygulamayı dağıtma bir <moduies> bölümü. 

3. Kilit açma <moduies> bölümünü vveb.config. içinde bağlantıları kenar, Web sitesi seçin siteleri, içinde 
Yönetim alanında açık yapılandırma Düzenleyicisi. Gezinti denetimlerinin seçmek için kullanın 

system.webServer/moduies bölümü, içinde eylemleri sağ kenar Seç kilidini bölümü. Modül bölümü 
için eylem girişi olarak görünüp görünmeyeceğini bölümü kilitlemodülü bölüm kilidi zaten açılmış ve 
Eylem gerekmiyor. 

4. Ekleme bir <moduies> uygulama bölümüne yerel vveb.config ile dosya bir <remove> uygulamadan 
modülünü kaldırmak için öğesi. Birden çok ekleme <remove> öğeleri birden çok modül kaldırmak için. 
Varsa vveb.config sunucu üzerinde yapılan değişiklikler, hemen aynı projenin değişiklik vveb.config 
dosyasını yerel. Bu yaklaşımı kullanarak bir modülü kaldırma, sunucudaki diğer uygulamalarla modülü 
kullanımını etkilemez. 

<configuration> 

<system.webServer> 

<modules> 

cremove name="MODULE_NAME" /> 

</modules> 

</system.webServer> 

</configuration> 


Eklemek veya kaldırmak için IIS Express kullanarak modüller için vveb.config, değ\ş\k\\kapplicationHost.config 















kilidini açmak için <moduies> bölümü: 


1. Açık {uygulama KÖKÜ}\.vs\config\applicationhost.corıfig. 

2. Bulun <section> öğesi IIS modüllerini ve değişiklik overrideModeDefault gelen Deny için Aiiow : 

<section name="modules" 

allowDefinition="MachineToApplication" 
overrideModeDefault="Allow" /> 

3. Bulun docation path="" overrideMode="Allow"><system.webServer><modules> bölümü. Kaldırmak 
istediğiniz tüm modüller için ayarlanmış lockıtem gelen true için faise . Aşağıdaki örnekte, kilitli 
olduğundan CGI Modülü: 

<add name="CgiModule" lockItem="false" /> 

4. Sonra <moduies> eklemek veya uygulamanın kullanarak IIS modülleri kaldırmak ücretsiz, bölüm ve tek 
tek modüllerinin kilidi web.config IIS Express'te uygulamayı çalıştırmak için dosya. 


Bir IIS modülü ile de kaldırılabilir Appcmd.exe. Sağlamak modulejjame ve applicationjmame komutta: 


Appcmd.exe delete modüle MODULE_NAME /app 

.name:APPLICATION_NAME 

Örneğin, kaldırma 

DynamicCompressionModule 

varsayılan Web sitesinden: 

%windir%\system32\inetsrv\appcmd.exe delete modüle DynamicCompressionModule /app.name:"Default Web Site" 


En az modül yapılandırma 

ASP.NET Core uygulaması çalıştırmak için gereken yalnızca Anonim kimlik doğrulama modülünü ve 
ASP.NET Core modülü modüllerdir. 

URI önbelleği Modülü ( uriCacheModule ) IIS URL düzeyinde önbellek Web sitesi yapılandırmasını sağlar.Bu 
modül IIS okuyun ve hatta aynı URL'yi art arda istendiğinde her istekte yapılandırmasını ayrıştırmamasıyla 
gerekir. Yapılandırma ayrıştırılırken her istek bir önemli bir performans düşüşüyle sonuçlanır. URI önbelleği 
modülü çalıştLrmak barındırılan bir ASP.NET Core uygulaması için kesinlikle gerekli olmasa da, tüm ASP.NET 
Core dağıtımları için URI önbelleğe alma modülü etkin olmasını öneririz. 

HTTP önbelleğe alma Modülü ( HttpCacheModule ) IIS çıktı önbelleğini ve ayrıca HTTP.sys önbelleğini öğeleri 
önbelleğe alma mantığını uygular. Bu modül olmadan içeriği artık çekirdek modunda önbelleğe alınır ve 
önbellek profilleri göz ardı edilir. HTTP önbelleğe alma modülü genellikle kaldırma, performans ve kaynak 
kullanımını olumsuz etkileri vardır. HTTP önbelleğe alma modülü çalıştırmak barındırılan bir ASP.NET Core 
uygulaması için kesinlikle gerekli olmasa da, tüm ASP.NET Core dağıtımları için önbelleğe alma HTTP 
modülü etkin olmasını öneririz. 

Ek kaynaklar 

• IIS ile VVİndovvs üzerinde ASP.NET Core barındırma 

• IIS mimarileri giriş: IIS modülleri 

• IIS modülleri genel bakış 

• IIS 7.0 rolleri ve modülleri özelleştirme 

• IIS <system.webServer> 























Azure App Service ve MS 'de ASRNET Core 
sorunlarını giderme 
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, Luke Latham ve, kotalik tarafından 

Bu makalede, bir uygulama Azure App Service veya 11S 'ye dağıtıldığında hataların nasıl tanılanacağı 
hakkında genel uygulama başlatma hataları ve yönergeleri hakkında bilgi verilmektedir: 

Uygulama başlatma hataları 

Ortak Başlangıç HTTP durum kodu senaryolarını açıklar. 

Azure App Service sorunlarını giderme 

Azure App Service dağıtılan uygulamalar için sorun giderme önerisi sağlar. 

11S üzerinde sorun giderme 

11S 'ye dağıtılan veya MS Express yerel olarak çalışan uygulamalar için sorun giderme önerisi sağlar. 
Bu kılavuz hem VVİndovvs Server hem de Windows masaüstü dağıtımları için geçerlidir. 

Paket önbelleklerini temizle 

Önemli güncelleştirmeler gerçekleştirirken veya paket sürümlerini değiştirirken ne yapmanız 
gerektiğini açıklar. 

Ek kaynaklar 

Ek sorun giderme konularını listeler. 

Uygulama başlatma hataları 

Visual Studio 'da bir ASP.NET Core projesi, hata ayıklama sırasında IIS Express barındırmak için 
varsayılan değerdir. 502,5-lşlem hatası veya yerel olarak hata ayıklarken oluşan 500,30-başlatma 
hatası , bu konudaki öneri kullanılarak tamlanabilir. 

Visual Studio 'da bir ASP.NET Core projesi, hata ayıklama sırasında 11S Express barındırmak için 
varsayılan değerdir. Yerel olarak hata ayıklamada oluşan 502,5 İşlem hatası , bu konudaki öneri 
kullanılarak tamlanabilir. 

403,14 yasak 

Uygulama başlatılamıyor.Aşağıdaki hata günlüğe kaydedilir: 

The Web server is configured to not list the contents of this directory. 

Hata genellikle barındırma sisteminde, aşağıdaki senaryolardan birini içeren bozuk bir dağıtım 
nedeniyle oluşur: 

• Uygulama, barındırma sisteminde yanlış klasöre dağıtılır. 

• Dağıtım işlemi, uygulamanın tüm dosyalarını ve klasörlerini barındırma sistemindeki dağıtım 
klasörüne taşıyamadı. 

• Web. conf'ıg dosyası dağıtımda yok veya Web. config dosyası içerikleri hatalı biçimlendirilmiş. 
Aşağıdaki adımları uygulayın: 

1. Tüm dosya ve klasörleri barındırma sistemindeki dağıtım klasöründen silin. 





2. Visual Studio, PovverShell veya el ile dağıtım gibi normal dağıtım yönteminizi kullanarak, 
uygulamanın Yayımlama klasörünün içeriğini barındırma sistemine yeniden dağıtın: 

• Web. config dosyasının dağıtımda mevcut olduğunu ve içeriğinin doğru olduğunu 
doğrulayın. 

• Azure App Service barındırırken, uygulamanın D:\home\site\wwwroot klasörüne 
dağıtıldığını doğrulayın. 

• Uygulama 11S tarafından barındırılıyorsa, uygulamanın IIS yöneticisinin temel 
ayarlarındagösterilen IIS fiziksel yoluna dağıtıldığını doğrulayın. 

3. Barındırma sistemindeki dağıtımı projenin Yayımla klasörünün içeriğiyle karşılaştırarak 
uygulamanın tüm dosya ve klasörlerinin dağıtıldığını doğrulayın. 

Yayımlanan ASP.NET Core uygulamasının düzeni hakkında daha fazla bilgi için bkz. ASP.NET Core 
dizin yapısı. Web. config dosyası hakkında daha fazla bilgi için bkz. ASP.NET Core Modülü. 

500 İç sunucu hatası 

Uygulamayı başlatır, ancak bir hata sunucu isteği yerine getirmesini önler. 

Bu hata, başlatma sırasında veya bir yanıt oluşturulurken uygulamanın kod içinde oluşur.Yanıtta 
içerik yok olabilir veya Yanıt, tarayıcıda 500 İç sunucu hatası olarak görünebilir. Uygulama olay 
günlüğü, genellikle uygulama normal şekilde çalışmaya belirtir. Sunucunun açısından bakıldığında, 
doğru olmasıdır. Uygulama başladı, ancak geçerli bir yanıt oluşturulamıyor. Uygulamayı sunucuda bir 
komut isteminde çalıştırın veya sorunu gidermek için ASP.NET Core modülü stdout günlüğünü 
etkinleştirin. 

500.0 işlem içi işleyici yükleme hatası 

Çalışan işlemi başarısız olur. Uygulama başlamaz. 

ASP.N ET Core modülü .N ET Core CLR 'yi bulamıyor ve işlem içi istek işleyiçişini 
(ı aspnetcorev2_inprocess. dil) bulamıyor. Kontrol edin: 

• Uygulama Microsoft. AspNetCore. Server. IIS NuGet paketini ya da Microsoft. Aspnetcore. app 
metapackage'i hedefler. 

• AS P.N ET Core paylaşılan framevrork'ün hedefliyorsa hedef makinede yüklü sürümü. 

500.0 giden işlem işleyicisi yükleme hatası 

Çalışan işlemi başarısız olur. Uygulama başlamaz. 

ASP.NET Core modülü işlem dışı barındırma isteği işleyicisini bulamıyor. Aspnetcorev2_outofprocess. 
dil ' nin aspnetcorev2. dil' nin yanındaki bir alt klasörde bulunduğundan emin olun. 

500.0 işlem içi işleyici yükleme hatası 

Çalışan işlemi başarısız olur. Uygulama başlamaz. 

AS P.N ET Core Modüle bileşenleri yüklenirken bilinmeyen bir hata oluştu. Aşağıdaki eylemlerden 
birini gerçekleştirin: 

• Microsoft desteği iletişim kurun ( Geliştirici Araçları ve ASP.NET Core' i seçin). 

• Stack Overflovv soru sorun. 

• GitHub deponuzdabir sorun yapın. 

500.30 işlemdeki başlatma hatası 

Çalışan işlemi başarısız olur. Uygulama başlamaz. 

ASP.NET Core modülü .NET Core CLR 'yi işlem içi başlatmaya çalışır, ancak başlatılamıyor.işlem 
başlatma hatasının nedeni genellikle uygulama olay günlüğündeki girişlerden ve ASP.NET Core 
modülü stdout günlüğünde belirlenebilir. 




Ortak bir hata durumu, uygulamanın mevcut olmayan ASP.NET Core paylaşılan framevvork sürümü 
hedefleme nedeniyle yanlış yapılandırılmış ' dir. Hangi sürümlerinin bir ASP.NET Core paylaşılan 
çerçeve hedef makinede yüklü olduğunu denetleyin. 

500.31 ANCM yerel bağımlılıklar bulunamadı 

Çalışan işlemi başarısız olur. Uygulama başlamaz. 

ASP.NET Core modülü , .NET Core çalışma zamanını işlem içinde başlatmaya çalışır, ancak 
başlatılamıyor. Bu başlatma hatasının en yaygın nedeni, Microsoft.NETCore.App veya 
Microsoft.AspNetcore.App çalışma zamanının yüklenmemesine neden olur. Uygulama, hedef 
ASP.N ET Core 3,0 ' ye dağıtılmışsa ve bu sürüm makinede yoksa, bu hata oluşur. Örnek bir hata 
iletisi aşağıda verilmiştir: 

The specified framework 'Microsoft.NETCore.App', version '3.0.0' was not found. 

- The following frameworks were found: 

2.2.1 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App] 

3.0.0-preview5-27626-15 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App] 
3.0.0-preview6-27713-13 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App] 
3.0.0-preview6-27714-15 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App] 
3.0.0-preview6-27723-08 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App] 

Hata iletisi, yüklü tüm .N ET Core sürümlerini ve uygulama tarafından istenen sürümü listeler. Bu 
hatayı onarmak için aşağıdakilerden birini yapın: 

• Uygun .N ET Core sürümünü makineye yükler. 

• Uygulamayı, makinede bulunan .NET Core 'un bir sürümünü hedefleyecek şekilde değiştirin. 

• Uygulamayı kendi kendine kapsanan bir dağıtımolarak yayımlayın. 

Geliştirme aşamasında çalışırken ( aspnetcore_environment ortam değişkeni Development olarak 
ayarlandığında), HTTP yanıtına belirli bir hata yazılır, işlem başlatma hatasının nedeni uygulama olay 
günlüğünde de bulunur. 

500.32 ANCM dil yüklenemedi 

Çalışan işlemi başarısız olur. Uygulama başlamaz. 

Bu hatanın en yaygın nedeni, uygulamanın uyumsuz bir işlemci mimarisi için yayımlanmakta olması 
olabilir. Çalışan işlemi 32 bitlik bir uygulama olarak çalışıyorsa ve uygulama 64 bit hedef için 
yayımlandıysa, bu hata oluşur. 

Bu hatayı onarmak için aşağıdakilerden birini yapın: 

• Çalışan işlemle aynı işlemci mimarisi için uygulamayı yeniden yayımlayın. 

• Uygulamayı çerçeveye bağlı bir dağıtımolarak yayımlayın. 

500.33 ANCM İstek Işleyicisi yükleme hatası 

Çalışan işlemi başarısız olur. Uygulama başlamaz. 

Uygulama Microsoft.AspNetcore.App çerçevesine başvurmadı. Yalnızca Microsoft.AspNetcore.App 
çerçevesini hedefleyen uygulamalarASP.NET Core modülütarafından barındırılabilir. 

Bu hatayı düzeltemedi, uygulamanın Microsoft.AspNetcore.App çerçevesini hedeflediğinden emin 
olun. Uygulamanın hedeflediği çerçeveyi doğrulamak için .runtimeconfig. json denetleyin. 

500.34 ANCM karışık barındırma modelleri desteklenmez 

Çalışan işlem, aynı işlemde hem işlem içi uygulama hem de işlem dışı bir uygulama çalıştırılamaz. 

Bu hatayı onarmak için uygulamaları ayrı 11S uygulama havuzlarında çalıştırın. 









500.35 ANCM birden çok işlem İçi uygulama aynı İşlemde 

Çalışan işlemi aynı işlemde birden çok işlem içi uygulama çalıştıramıyor. 

Bu hatayı onarmak için uygulamaları ayrı 11S uygulama havuzlarında çalıştırın. 

500.36 ANCM İşlem dışı Işleyici yükleme hatası 

İşlem dışı istek işleyicisi, aspnetcorev2_outofprocess. dil, aspnetcorev2. dil dosyasının yanında 
değildir. Bu, AS P.N ET Core modülününbozuk bir yüklemesini gösterir. 

Bu hatayı gidermek için .NET Core barındırma paketi (IIS için) veya Visual Studio (US Express için) 
yüklemesini onarın. 

500.37 ANCM başlangıç zamanı sınırı İçinde başlatılamadı 

ANCM, kısımları başlangıç süresi sınırı içinde başlatılamadı. Varsayılan olarak, zaman aşımı 120 
saniyedir. 

Aynı makinede çok sayıda uygulama başlatılırken bu hata oluşabilir. Başlangıç sırasında sunucuda 
CPU/bellek kullanımı artışlarını denetleyin. Birden çok uygulamanın başlatma işlemini şaşırtmayı 
yapmanız gerekebilir. 

502.5 işlem hatası 

Çalışan işlemi başarısız olur. Uygulama başlamaz. 

ASP.NET Core modülü çalışan işlemini başlatmaya çalışır, ancak başlatılamıyor. işlem başlatma 
hatasının nedeni genellikle uygulama olay günlüğündeki girişlerden ve ASP.NET Core modülü 
stdout günlüğünde belirlenebilir. 

Ortak bir hata durumu, uygulamanın mevcut olmayan ASP.NET Core paylaşılan framevvork sürümü 
hedefleme nedeniyle yanlış yapılandırılmış 1 dir. Hangi sürümlerinin bir ASP.NET Core paylaşılan 
çerçeve hedef makinede yüklü olduğunu denetleyin. Paylaşılan çerçeve , makinede yüklü olan ve 
Microsoft.AspNetcore.App gibi bir metapackage tarafından başvurulan derleme (. dil dosyaları) 
kümesidir. Metapackage başvurusu, gerekli en düşük sürümü belirtebilir. Daha fazla bilgi için bkz. 
paylaşılan çerçeve. 

Bir barındırma veya uygulamanın yanlış yapılandırılması, çalışan işleminin başarısız olmasına neden 
olduğunda, 502,5 İşlem hata hatası sayfası döndürülür: 

Uygulama (hata kodu: '0x800700c1') başlatılamadı. 

EventlD: 1010 

Source: IIS AspNetCore Modüle V2 

Failed to start application '/LM/W3SVC/6/R00T/', ErrorCode '0x800700cl'. 

Uygulamanın derlemesi (. dil) yüklenemediğinden uygulama başlatılamadı. 

W3wp/ıısexpress işlemi ile yayımlanan uygulama arasındaki bir bit genişliği uyuşmazlığı olduğunda 
bu hata oluşur. 

Uygulama havuzunun 32-bit ayarının doğru olduğundan emin olun: 

1. IIS yöneticisinin uygulama havuzlarındauygulama havuzunu seçin. 

2. Eylemler panelinde uygulama havuzunu Düzenle altında Gelişmiş ayarlar ' ı seçin. 

3. Enable 32 bit uygulamalarımayarla: 

• 32-bit (x86) bir uygulama dağıtıyorsanız, değeri True olarak ayarlayın. 

• 64 bit (x64) uygulaması dağıtıyorsanız, değeri Faise olarak ayarlayın. 


Proje dosyasındaki <piatform> MSBuild özelliği ile uygulamanın yayınlanan bit durumuyla ilgili bir 







çakışma olmadığını doğrulayın. 

Bağlantı sıfırlama 

Üstbilgiler gönderildikten sonra bir hata oluşursa, bir hata oluştuğunda sunucunun 500 İç sunucu 
hatası gönderebilmesi için çok geç olur. Bu durum, genellikle bir yanıt için karmaşık nesne 
serileştirme sırasında bir hata oluştuğunda gerçekleşir. Bu tür bir hata, istemcide bir bağlantı 
sıfırlama hatası olarak görüntülenir. Uygulama günlüğü bu tür hataların giderilmesine yardımcı 
olabilir. 

Varsayılan başlangıç sınırları 

ASP.NET Core modülü varsayılan bir StartupTimeLimit 120 saniye ile yapılandırılır. Varsayılan değer 
olarak sol uygulama modülü bir işlem hatası oturum önce başlatmak için iki dakika sürebilir. Modülü 
yapılandırma hakkında daha fazla bilgi için bkz. aspNetCore öğesinin öznitelikleri. 

Azure App Service sorunlarını giderme 


IMPORTANT 

Azure App Service ile Önizleme sürümlerini ASP.NET Core 

ASP.NET Core önizleme sürümleri varsayılan olarak Azure App Service dağıtılır. ASP.NET Core Previevv sürümü 
kullanan bir uygulamayı barındırmak için, bkz. Azure App Service için ASP.NET Core Previevv sürümünü 
dağıtma. 


Uygulama olay günlüğü (Azure App Service) 

Uygulama olay günlüğüne erişmek için Azure portal sorunları Tanıla ve çöz dikey penceresini 
kullanın: 

1. Azure portal uygulama Hizmetleri' nde uygulamayı açın. 

2. Tanıla ve sorunları çöz ' ü seçin. 

3. Tanılama araçları başlığını seçin. 

4. Destek Araçları 1 2 nın altında, uygulama olayları düğmesini seçin. 

5. Kaynak sütununda IIS AspNetCoreModule veya IIS Aspnetcoremodule v2 girişi tarafından 
belirtilen en son hatayı inceleyin. 

Sorunları Tanıla ve çöz dikey penceresini kullanmanın bir alternatifi, uygulama olay günlüğü 
dosyasını doğrudan kudukullanarak incelemektir: 

1 . Gelişmiş araçları geliştirme araçları alanında açın. Git-* düğmesini seçin. Kudu konsolu yeni 
bir tarayıcı sekmesi veya penceresinde açılır. 

2. Sayfanın üst kısmındaki gezinti çubuğunu kullanarak hata ayıklama konsolu 'nu açın ve cmd 
yi seçin. 

3. LogFiles klasörünü açın. 

4. EventLog. xml dosyasının yanındaki kurşun kalem simgesini seçin. 

5. Günlüğü inceleyin. En son olayları görmek için günlüğün en altına gidin. 

Uygulamayı kudu konsolunda çalıştırma 

Başlatma hataları birçok yararlı bilgiler uygulama olay günlüğü'ndeki üretmediği. Bu hatayı saptamak 
için, uygulamayı kudu uzaktan yürütme konsolu 'nda çalıştırabilirsiniz: 

1. Gelişmiş araçları geliştirme araçları alanında açın. Git-* düğmesini seçin. Kudu konsolu yeni 
bir tarayıcı sekmesi veya penceresinde açılır. 

2. Sayfanın üst kısmındaki gezinti çubuğunu kullanarak hata ayıklama konsolu 'nu açın ve cmd' 
yi seçin. 






32 bit (x86) uygulamayı test etme 
Geçerli yayın 

1. cd d:\home\site\wwwroot 

2. Uygulamayı çalıştırın: 

• Uygulama, çerçeveye bağımlı bir dağıtımise: 

dotnet .\{ASSEMBLY NAME}.dil 

• Uygulama, kendinden bağımsız bir dağıtımise: 

{ASSEMBLY NAME}.exe 

Uygulamadan alınan konsol çıktısı, tüm hataları gösteren kudu konsoluna gönderilir. 

Önizleme sürümünde çalışan çerçeveye bağımlı dağıtım 

ASP.NET Core {VERSION} (x86) çalışma zamanı site uzantısının yüklenmesini gerektirir. 

1. cd D:\home\SiteExtensions\AspNetCoreRuntime. {X.Y}.x32 ( {X.Y} çalışma Zamanı Sürümüdür) 

2. Uygulamayı çalıştırın: dotnet \home\slte\wwwnoot\{ASSEMBLY NAME}.dil 

Uygulamadan alınan konsol çıktısı, tüm hataları gösteren kudu konsoluna gönderilir. 

64 bit (x64) uygulamayı test etme 
Geçerli yayın 

• Uygulama 64 bit (x64) çerçeveye bağımlı bir dağıtımise: 

1. cd D:\Program Files\dotnet 

2. Uygulamayı çalıştırın: dotnet \home\site\wwwroot\{ASSEMBLY NAME}.dil 

• Uygulama, kendinden bağımsız bir dağıtımise: 

1. cd D:\home\site\wwwroot 

2. Uygulamayı çalıştırın: {assembly name}. exe 

Uygulamadan alınan konsol çıktısı, tüm hataları gösteren kudu konsoluna gönderilir. 

Önizleme sürümünde çalışan çerçeveye bağımlı dağıtım 

ASP.NET Core {VERSION} (x64) çalışma zamanı site uzantısını yüklemeyi gerektirir. 



Uygulamadan alınan konsol çıktısı, tüm hataları gösteren kudu konsoluna gönderilir. 

ASP.NET Core modülü stdout günlüğü (Azure App Service) 

ASP.NET Core Modüle stdout günlüğü genellikle uygulama olay günlüğünde bulunmayan yararlı 
hata iletilerini kaydeder. Stdout günlükleri görüntülemek ve etkinleştirmek için: 

1. Azure portal sorunları Tanıla ve çöz dikey penceresine gidin. 

2. Sorun kategorisini seçinaltında Web uygulaması aşağı düğmesini seçin. 

3. Önerilen çözümler ' de stdout günlük yeniden yönlendirmeyi etkinleştirmek > , Web. 
config dosyasını düzenlemek için kudu konsolunu açmaküzere düğmeyi seçin. 

4. Kudu Tanılama konsolunda, dosyaları Wwwroot > yol sitesine açın. Listenin altındaki Web. 










config dosyasını açığa çıkarmak için aşağı kaydırın. 

5. Web. config dosyasının yanındaki kurşun kalem simgesine tıklayın. 

6. StdoutLogEnabled olarak ayarlayın ve stdoutLogFile yolunu true olarak değiştirin: 

\\?\%home%\LogFiles\stdout . 

7. Güncelleştirilmiş Web. config dosyasını kaydetmek için Kaydet ' i seçin. 

8. Uygulamaya bir istek oluşturun. 

9. Azure portal dönün. GELİŞTİRME araçları alanında Gelişmiş Araçlar dikey penceresini seçin. 
Git-* düğmesini seçin. Kudu konsolu yeni bir tarayıcı sekmesi veya penceresinde açılır. 

10. Sayfanın üst kısmındaki gezinti çubuğunu kullanarak hata ayıklama konsolu 'nu açın ve cmd' 
yi seçin. 

11. LogFiles klasörünü seçin. 

12. Değiştirilen sütunu inceleyin ve son değiştirilme tarihiyle stdout günlüğünü düzenlemek için 
kalem simgesini seçin. 

13. Günlük dosyası açıldığında hata görüntülenir. 

Sorun giderme tamamlandığında stdout günlüğünü devre dışı bırak: 

1. Kudu Tanılama konsolunda, Web. config dosyasını açığa çıkarmak için Wwwroot > yolu 
sitesine dönün. Kalem simgesini seçerek Web. config dosyasını tekrar açın. 

2. faise için StdoutLogEnabled ayarlayın. 

3. Dosyayı kaydetmek için Kaydet ' i seçin. 

Daha fazla bilgi için bkz. AS P.N ET Core Modülü. 


VVARNING 

Uygulama veya sunucu başarısızlığı için hata stdout günlüğünü devre dışı bırakmak için yol açabilir.Günlük 
dosyası boyutunu sınırlama yok veya oluşturulan günlük dosyası sayısı yoktur. Yalnızca uygulama başlatma 
sorunlarını gidermek için stdout günlüğünü kullanın. 

Başlangıçtan sonra ASP.NET Core bir uygulamada genel günlüğe kaydetme için, günlük dosyası boyutunu 
sınırlayan ve günlükleri döndüren bir günlüğe kaydetme kitaplığı kullanın. Daha fazla bilgi için bkz. üçüncü 
taraf günlüğü sağlayıcıları. 


ASP.NET Core modülü hata ayıklama günlüğü (Azure App Service) 

ASP.NET Core Modüle hata ayıklama günlüğü, ASP.NET Core modülünden daha ayrıntılı günlük 

kaydı sağlar. Stdout günlükleri görüntülemek ve etkinleştirmek için: 

1. Gelişmiş tanılama günlüğünü etkinleştirmek için aşağıdakilerden birini yapın: 

• Uygulamayı gelişmiş tanılama günlüğü için yapılandırmak üzere Gelişmiş tanılama 
günlükleri bölümündeki yönergeleri izleyin. Uygulamayı yeniden dağıtın. 

• Gelişmiş tanılama günlüklerinde gösterilen <handierSettings> kudu konsolunu kullanarak 
canlı uygulamanın Web. config dosyasına ekleyin: 

a. Gelişmiş araçları geliştirme araçları alanında açın. Git-* düğmesini seçin. Kudu 
konsolu yeni bir tarayıcı sekmesi veya penceresinde açılır. 

b. Sayfanın üst kısmındaki gezinti çubuğunu kullanarak hata ayıklama konsolu 'nu 
açın ve cmd' yi seçin. 

c. Dosyaları wwwroot > yol sitesine açın. Web. config dosyasını, kurşun kalem 
düğmesini seçerek düzenleyin. <handierSettings> bölümünü, Gelişmiş tanılama 
günlüklerindegösterildiği gibi ekleyin. Kaydet düğmesini seçin. 

2. Gelişmiş araçları geliştirme araçları alanında açın. Git-* düğmesini seçin. Kudu konsolu yeni 
bir tarayıcı sekmesi veya penceresinde açılır. 











3. Sayfanın üst kısmındaki gezinti çubuğunu kullanarak hata ayıklama konsolu 'nu açın ve cmd 
yi seçin. 

4. Dosyalan wwwroot > yol sitesine açın. Aspnetcore-Debug. log dosyası için bir yol 
sağlamadıysanız dosya listede görüntülenir. Bir yol sağladıysanız, günlük dosyasının konumuna 
gidin. 

5. Dosya adının yanındaki kurşun kalem düğmesiyle günlük dosyasını açın. 

Sorun giderme tamamlandığında hata ayıklama günlüğünü devre dışı bırak: 

Gelişmiş hata ayıklama günlüğünü devre dışı bırakmak için aşağıdakilerden birini yapın: 

• Web. config dosyasından <handierSettings> yerel olarak kaldırın ve uygulamayı yeniden dağıtın. 

• Web. config dosyasını düzenlemek ve <handierSettings> bölümünü kaldırmak İçin kudu 
konsolunu kullanın. Dosyayı kaydedin. 

Daha fazla bilgi için bkz. ASP.N ET Core Modülü. 

VVARNING 

Hata ayıklama günlüğünü devre dışı bırakma hatası, uygulama veya sunucu hatasına yol açabilir.Günlük 
dosyası boyutunda sınır yoktur. Yalnızca uygulama başlatma sorunlarını gidermek için hata ayıklama 
günlüğünü kullanın. 

Başlangıçtan sonra ASP.NET Core bir uygulamada genel günlüğe kaydetme için, günlük dosyası boyutunu 
sınırlayan ve günlükleri döndüren bir günlüğe kaydetme kitaplığı kullanın. Daha fazla bilgi için bkz. üçüncü 
taraf günlüğü sağlayıcıları. 


Yavaş veya askıda olan uygulama (Azure App Service) 

Bir uygulama bir istek üzerinde yavaş bir şekilde yanıt verdiğinde veya Kilitlenmelerinde, aşağıdaki 
makalelere bakın: 

• Azure App Service 'de yavaş Web uygulaması performans sorunlarını giderme 

• Azure Web uygulamasında aralıklı özel durum sorunları veya performans sorunları için döküm 
yakalamak üzere kilitlenme tamlayıcı site uzantısı 'nı kullanın 

İzleme kanatları 

izleme dikey pencereleri, konusunda daha önce açıklanan yöntemlere alternatif bir sorun giderme 
deneyimi sağlar. Bu kanatlar 500 serisi hataları tanılamak için kullanılabilir. 

ASP.NET Core uzantılarının yüklü olduğunu doğrulayın. Uzantılar yüklü değilse, bunları el ile 
yükleyebilirsiniz: 

1. GELİŞTİRME araçları dikey penceresinde Uzantılar dikey penceresini seçin. 

2. ASP.NET Core uzantıları listede görünmelidir. 

3. Uzantılar yüklü değilse, Ekle düğmesini seçin. 

4. Listeden ASP.NET Core uzantılarını seçin. 

5. Yasal koşulları kabul etmek için Tamam ' ı seçin. 

6. Uzantı Ekle dikey penceresinde Tamam ' ı seçin. 

7. Bilgilendirici bir açılan ileti, uzantıların başarıyla yüklenip yüklenmediğini gösterir. 

Stdout günlüğü etkinleştirilmemişse, şu adımları izleyin: 

1. Azure portal, GELİŞTİRME araçları alanındaki Gelişmiş Araçlar dikey penceresini seçin. Git^ 
düğmesini seçin. Kudu konsolu yeni bir tarayıcı sekmesi veya penceresinde açılır. 

2. Sayfanın üst kısmındaki gezinti çubuğunu kullanarak hata ayıklama konsolu 'nu açın ve cmd' 







yı seçin. 


3. Dosya yolu > sitesindeki klasörleri açın ve listenin altındaki Web. config dosyasını açığa 
çıkarmak için aşağı kaydırın. 

4. Web. config dosyasının yanındaki kurşun kalem simgesine tıklayın. 

5. StdoutLogEnabled olarak ayarlayın ve stdoutLogFile yolunu true olarak değiştirin: 

\\?\%home%\LogFiles\stdout . 

6. Güncelleştirilmiş Web. config dosyasını kaydetmek için Kaydet ' i seçin. 

Tanılama günlüğünü etkinleştirmek için ilerleyin: 

1. Azure portal tanılama günlükleri dikey penceresini seçin. 

2. Uygulama günlüğü (dosya sistemi) ve ayrıntılı hata iletileriiçin bir anahtar seçin . Dikey 
pencerenin üst kısmındaki Kaydet düğmesini seçin. 

3. Başarısız istek izlemeyi, başarısız İstek olayı arabelleğe alma (FREB) günlüğü olarak da bilinen bir 
şekilde eklemek için , başarısız istek izlemeanahtarını seçin. 

4. Portalda tanılama günlükleri dikey penceresinde hemen listelenen günlük akışı dikey 
penceresini seçin. 

5. Uygulamaya bir istek oluşturun. 

6. Günlük akışı verileri içinde hatanın nedeni belirtilir. 

Sorun giderme tamamlandığında stdout günlüğünü devre dışı bıraktığınızdan emin olun. 

Başarısız istek izleme günlüklerini görüntülemek için (FREB günlükleri): 

1. Azure portal sorunları Tanıla ve çöz dikey penceresine gidin. 

2. Kenar çubuğunun Destek Araçları alanından başarısız istek izleme günlüklerini seçin. 

Azure App Service konusundaki Web uygulamaları için tanılama günlüğünü etkinleştirme ve Azure 
'Daki Web Apps İçin uygulama performansı SSS bölümündeki başarısız istek izlemeleri bölümüne 
bakın: daha fazla bilgi için nasıl yaparım? başarısız istek izlemeyi açın. 

Daha fazla bilgi için bkz. Azure App Service Web Apps için tanılama günlüğünü etkinleştirme. 


VVARNING 

Uygulama veya sunucu başarısızlığı için hata stdout günlüğünü devre dışı bırakmak için yol açabilir.Günlük 
dosyası boyutunu sınırlama yok veya oluşturulan günlük dosyası sayısı yoktur. 

ASP.NET Core uygulamanızı rutin günlüğü için günlük dosyası boyutunu sınırlar ve günlükleri döndürür bir 
günlük kitaplığını kullanın. Daha fazla bilgi için bkz. üçüncü taraf günlüğü sağlayıcıları. 


11S 'de sorun giderme 

Uygulama olay günlüğü (IIS) 

Uygulama olay günlüğüne erişemedi: 

1. Başlat menüsünü açın, Olay Görüntüleyicisiaraması yapın ve ardından Olay Görüntüleyicisi 
uygulamasını seçin. 

2. Olay Görüntüleyicisi, Windows günlükleri düğümünü açın. 

3. Uygulama olay günlüğünü açmak için uygulama 1 yı seçin. 

4. Başarısız olan uygulama ile ilişkili hataları arayın. Hataların, kaynak sütununda IIS aspnetcore 
modülünün veya IIS Express aspnetcore modülünün bir değeri vardır. 

Uygulamayı bir komut isteminde aşağıdakini çalıştırın 












Başlatma hataları birçok yararlı bilgiler uygulama olay günlüğü'ndeki üretmediği. Bazı hataların 

nedeni, barındıran sistemde bir komut isteminde uygulamayı çalıştırarak bulabilirsiniz. 

Framevvork bağımlı dağıtım 

Uygulama, çerçeveye bağımlı bir dağıtımise: 

1. Bir komut isteminde, dağıtım klasörüne gidin ve uygulamanın derlemesini DotNet. exeile 
yürüterek uygulamayı çalıştırın. Aşağıdaki komutta, <assembly_name >: 

dotnet .\<assembiy_name>.diı için uygulama derlemesinin adını yerine koyun. 

2. Konsol çıkışını herhangi bir hata gösteren uygulamadan konsol penceresine yazılır. 

3. Uygulamaya bir istek yaparken, hataları meydana gelirse, burada Kestrel dinlediği bağlantı noktası 
ve ana bilgisayar için istekte bulunmak. Varsayılan konak ve gönderi kullanarak 

http://iocaihost:5000/ bir istek yapın. Uygulamayı, normalde Kestrel uç nokta adresindeki yanıt 
verirse, sorun barındırma yapılandırmasında ve büyük olasılıkla daha az uygulama içinde ilgili 
daha yüksektir. 

Kendi içinde dağıtım 

Uygulama, kendinden bağımsız bir dağıtımise: 

1. Bir komut isteminde dağıtım klasörüne gidin ve uygulamanın yürütülebilir dosyayı çalıştırın. 
Aşağıdaki komutta, <assembly_name >: <assembiy_name>.exe için uygulama derlemesinin adını 
yerine koyun. 

2. Konsol çıkışını herhangi bir hata gösteren uygulamadan konsol penceresine yazılır. 

3. Uygulamaya bir istek yaparken, hataları meydana gelirse, burada Kestrel dinlediği bağlantı noktası 
ve ana bilgisayar için istekte bulunmak. Varsayılan konak ve gönderi kullanarak 

http : //localhost: 5000 / bir istek yapın. Uygulamayı, normalde Kestrel uç nokta adresindeki yanıt 
verirse, sorun barındırma yapılandırmasında ve büyük olasılıkla daha az uygulama içinde ilgili 
daha yüksektir. 

ASP.NET Core Modüle stdout günlüğü (IIS) 

Stdout günlükleri görüntülemek ve etkinleştirmek için: 

1. Barındıran sistemde sitenin dağıtım klasörüne gidin. 

2. Günlükler klasörü yoksa, klasörü oluşturun. MSBuild 'in dağıtımdaki Günlükler klasörünü 
otomatik olarak oluşturmak üzere nasıl etkinleştirileceği hakkında yönergeler için, bkz. Dizin yapısı 
konusu. 

3. Web. conflg dosyasını düzenleyin. StdoutLogEnabled öğesini true olarak ayarlayın ve 
stdoutLogFile yolunu Günlükler klasörünü işaret etmek üzere değiştirin (örneğin, .\iogs\stdout 
). yoldaki stdout günlük dosyası adı önekidir. Oturum oluşturulduğunda bir zaman damgası, 
işlem kimliği ve dosya uzantısı otomatik olarak eklenir. Dosya adı ön eki olarak stdout 
kullanarak, tipik bir günlük dosyası, stdout_20180205184032_5412. /ogolarak adlandırılır. 

4. Uygulama havuzunuzun kimliğinin Günlükler klasörü için yazma izinlerine sahip olduğundan 
emin olun. 

5. Güncelleştirilmiş Web. conflg dosyasını kaydedin. 

6. Uygulamaya bir istek oluşturun. 

7. Günlükler klasörüne gidin. Bulun ve en son stdout günlüğü'nü açın. 

8. Hatalar için günlüğü inceleyin. 

Sorun giderme tamamlandığında stdout günlüğünü devre dışı bırak: 

1. Web. conflg dosyasını düzenleyin. 

2. faise için StdoutLogEnabled ayarlayın. 

3. Dosyayı kaydedin. 










Daha fazla bilgi için bkz. ASP.N ET Core Modülü. 


VVARNING 

Uygulama veya sunucu başarısızlığı için hata stdout günlüğünü devre dışı bırakmak için yol açabilir.Günlük 
dosyası boyutunu sınırlama yok veya oluşturulan günlük dosyası sayısı yoktur. 

ASP.NET Core uygulamanızı rutin günlüğü için günlük dosyası boyutunu sınırlar ve günlükleri döndürür bir 
günlük kitaplığını kullanın. Daha fazla bilgi için bkz. üçüncü taraf günlüğü sağlayıcıları. 


ASP.NET Core modülü hata ayıklama günlüğü (MS) 

AS P.N ET Core modülü hata ayıklama günlüğünü etkinleştirmek için aşağıdaki işleyici ayarlarını 
uygulamanın Web. config dosyasına ekleyin: 

<aspNetCore ...> 

<handlerSettings> 

«chandlerSetting name="debugl_evel" value="file" /> 

<handlerSetting name="debugFile" value="c: \temp\ancm. log" /> 

</handlerSettings> 

</aspNetCore> 


Günlüğü için belirtilen yolun var olduğundan ve uygulama havuzu kimliğinin konumuna yazma 
izinlerine sahip olduğunu doğrulayın. 

Daha fazla bilgi için bkz. ASP.N ET Core Modülü. 

sayfasını etkinleştir 

ortam değişkeni, uygulamayı geliştirme ortamında çalıştırmak için Web. 
config dosyasına eklenebilir . Ortam, ana bilgisayar tasarımcısında useEnvironment tarafından 
uygulama başlangıcında geçersiz kılınmadığı sürece, ortam değişkenini ayarlamak, uygulama 
çalıştırıldığında Geliştirici özel durum sayfasının görünmesine izin verir. 

<aspNetCore processPath="dotnet" 
arguments=". \MyApp.dll" 
stdoutLogEnabled="false" 
stdoutLogFile=". \logs\stdout" 
hostingModel="InProcess"> 

<environmentVariables> 

<environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" /> 
</environmentVariables> 

</aspNetCore> 

<aspNetCore processPath="dotnet" 
arguments=". \MyApp.dll" 
stdoutLogEnabled="false" 
stdoutLogFile=".\logs\stdout"> 

<environmentVariables> 

<environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" /> 
</environmentVariables> 

</aspNetCore> 

aspnetcore_environment için ortam değişkenini ayarlamak yalnızca Internet 'e açık olmayan 
hazırlama ve test etme sunucularında kullanılması önerilir. Sorun giderme işleminden sonra Web. 
config dosyasından ortam değişkenini kaldırın. Web. config 'de ortam değişkenlerini ayarlama 
hakkında daha fazla bilgi İçin, Aspnetcore 'un EnvironmentVariables alt öğesibölümüne bakın. 


Geliştirici özel durumu 

ASPNETCORE ENVIRONMENT 


Bir uygulamadan veri alın 








Bir uygulama isteklerini yanıtlayabileceği ise, istek, bağlantı ve ek veri terminal satır içi ara yazılımın 
kullanılması uygulamayı edinin. Daha fazla bilgi ve örnek kod için bkz. AS P.N ET Core projeleri 
sorunlarını giderme. 

Yavaş veya askıda olan uygulama (IIS) 

Kilitlenme dökümü , sistem belleğinin bir anlık görüntüsüdür ve uygulama kilitlenmesinin, başlatma 
hatasının veya yavaş uygulamanın nedenini belirlemenize yardımcı olabilir. 

Uygulama kilitleniyor veya bir özel durumla karşılaşırsa 

Windows Hata Bildirimi bir döküm edinin ve çözümleyin (WER): 

1. Kilitlenme döküm dosyalarını c:\dumps tutmak için bir klasör oluşturun. Uygulama havuzunun 
klasöre yazma erişimi olmalıdır. 

2. Enabledökümler PovverShell betiğiniçalıştırın: 

• Uygulama, işlem içi barındırma modelinikullanıyorsa, W3wp. exeiçir\ betiği çalıştırın: 

. \EnableDumps w3wp.exe c:\dumps 

• Uygulama işlem dışı barındırma modelinikullanıyorsa, DotNet. exeiçin betiği çalıştırın: 

. \EnableDumps dotnet.exe c:\dumps 

3. Uygulamayı kilitlenmenin oluşmasına neden olan koşullar altında çalıştırın. 

4. Kilitlenme gerçekleştirildikten sonra, Disabledökümler PovverShell betiğiniçalıştırın: 

• Uygulama, işlem içi barındırma modelinikullanıyorsa, W3wp. exeiçin betiği çalıştırın: 

. \DisableDumps w3wp.exe 

• Uygulama işlem dışı barındırma modelinikullanıyorsa, DotNet. exeiçin betiği çalıştırın: 

. \DisableDumps dotnet.exe 

Uygulama kilitlenmeleri ve döküm koleksiyonu tamamlandıktan sonra, uygulamanın normal olarak 
sonlandırılmasına izin verilir. PovverShell betiği, WER 'i uygulama başına en fazla beş döküm 
toplayacak şekilde yapılandırır. 


VVARNING 

Kilitlenme dökümleri büyük miktarda disk alanı kaplar (her birine kadar çok gigabayt kadar). 


Uygulama askıda kalıyor, başlatma sırasında başarısız oluyor veya normal şekilde çalışıyor 

Bir uygulama askıda kaldığında (yanıt vermeyi keser ancak kilitlenmez), başlatma sırasında başarısız 
olur veya normal şekilde çalışır. Kullanıcı modu döküm dosyaları: döküm oluşturmak için uygun bir 
aracı seçmek üzere en iyi aracı seçme. 

Dökümü çözümle 

Bir döküm çeşitli yaklaşımlar kullanılarak analiz edilebilir.Daha fazla bilgi için bkz. Kullanıcı modu 
döküm dosyasını çözümleme. 











Paket önbelleklerini temizle 


Bazen, geliştirme makinesindeki .NET Core SDK yükseltmeden ya da uygulamadaki paket 
sürümlerini değiştirirken çalışan bir uygulama hemen başarısız olur. Bazı durumlarda, ana yükseltme 
yaparken, bir uygulama tutarsız paketleri kesilebilir. Bu sorunların çoğu, bu yönergeleri izleyerek 
düzeltilebilir: 

1. Bin ve obj klasörlerini silin. 

2. Bir komut kabuğundan dotnet nuget locals ali --ciear yürüterek paket önbelleklerini 
temizleyin. 

Paket önbelleklerini Temizleme, NuGet. exe aracı ile de gerçekleştirilebilir ve komut 
nuget locals ali -ciear yürütülebilir. NuGet. exe , VVİndovvs masaüstü işletim sistemiyle 
birlikte paketlenmiş bir yüklemedir ve NuGet Web sitesindenayrı olarak alınmalıdır. 

3. Geri yükle ve projeyi yeniden derleyin. 

4. Uygulamayı yeniden dağıtmadan önce sunucusundaki dağıtım klasöründeki tüm dosyaları 
silin. 

Ek kaynaklar 

• ASP.NET Core projeleri sorunlarını giderme 

• ASP.N ET Core ile Azure App Service ve IIS için ortak hatalar başvurusu 

• ASP.NET Core hataları işleme 

• ASP.NET Core Modülü 

Azure belgeleri 

• ASP.NET Core için Application Insights 

• Visual Studio 'Yu kullanarak Azure App Service Web uygulamasının sorunlarını giderme 
bölümünde uzaktan hata ayıklama Web Apps bölümü 

• Azure App Service tanılamada genel bakış 

• Nasıl yapılır: Azure App Service uygulamaları İzleme 

• Visual Studio 'Yu kullanarak Azure App Service bir Web uygulamasının sorunlarını giderme 

• Azure Web uygulamalarınızda "502 hatalı Ağ Geçidi" ve "503 hizmeti kullanılamıyor” HTTP 
hatalarında sorun giderme 

• Azure App Service 'de yavaş Web uygulaması performans sorunlarını giderme 

• Azure 'da Web Apps için uygulama performansı SSS 

• Azure Web uygulaması korumalı alanı (App Service çalışma zamanı yürütme sınırlamaları) 

• Azure Cuma: Azure App Service tanılama ve sorun giderme deneyimi (12 dakikalık video) 

Visual Studio belgeleri 

• Visual Studio 2017 ' de Azure 'da IIS 'de uzaktan hata ayıklama ASP.NET Core 

• Visual Studio 2017 ' de uzak IIS bilgisayarında uzaktan hata ayıklama ASP.NET Core 

• Visual Studio kullanarak hata ayıklamayı öğrenin 

Visual Studio Code belgeleri 

• Visual Studio Code ile hata ayıklama 




ASRNET Core ile Azure App Service ve IIS için ortak 
hatalar başvurusu 
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Tarafından Luke Latham 

Bu konuda yaygın hatalar açıklanmakta ve Azure Apps hizmetinde ve 11S 'de ASP.NET Core uygulamalar 
barındırırken belirli hatalar için sorun giderme önerileri sunulmaktadır. 

Genel sorun giderme kılavuzu için bkz. Azure App Service ve 11S 'de ASP.NET Core sorunlarını giderme. 
Aşağıdaki bilgileri toplayın: 

• Tarayıcı davranışı (durum kodu ve hata iletisi) 

• Uygulama olay günlüğü girdileri 

o Azure App Service - Azure App Service ve MS 'de ASP.NET Core sorunlarını gidermebakın. 
o MS 

1. Windows menüsünde Başlat ' ı seçin, Olay Görüntüleyicisiyaz\n ve ENTERtuşuna basın. 

2. Olay Görüntüleyicisi açıldıktan sonra, kenar çubuğundan Windows günlükleri > 

uygulaması ' nı genişletin. 

• AS P.N ET Core modülü stdout ve hata ayıklama günlüğü girdileri 

o Azure App Service - Azure App Service ve MS 'de ASP.NET Core sorunlarını gidermebakın. 
o MS - AS P.N ET Core modülü konusunun günlük oluşturma ve yeniden yönlendirme ve Gelişmiş 
tanılama günlükleri bölümlerindeki yönergeleri izleyin. 

Hata bilgilerini aşağıdaki yaygın hatalarla karşılaştırın. Bir eşleşme bulunursa, sorun giderme talimatını izleyin. 

Bu konudaki hataların listesi ayrıntılı değildir. Burada listelenmeyen bir hatayla karşılaşırsanız, bu konunun en 
altındaki içerik geri bildirim düğmesini kullanarak yeni bir sorun açın ve hatayı yeniden oluşturma hakkında 
ayrıntılı yönergeler kullanın. 


IMPORTANT 

Azure App Service ile Önizleme sürümlerini ASP.NET Core 

ASP.NET Core önizleme sürümleri varsayılan olarak Azure App Service dağıtılır. ASP.NET Core Previevv sürümü kullanan bir 
uygulamayı barındırmak için, bkz. Azure App Service için ASP.NET Core Previevv sürümünü dağıtma. 


İşletim sistemi yükseltmesi 32-bit ASP.NET Core modülünü kaldırdı 

Uygulama günlüğü: C:\windows\system32\inetsrv\aspnetcore.dll modül dil si yüklenemedi. Veriler 
hatadır. 

Sorun Giderme: 

Bir işletim sistemi yükseltmesi sırasında C:\Windows\SysWOW64\inetsrv dizininde işletim sistemi olmayan 
dosyalar korunmaz. AS P.N ET Core modülü bir işletim sistemi yükseltmesinden önce yüklendiyse ve sonra 
herhangi bir uygulama havuzu bir işletim sistemi yükseltmesinden sonra 32 bit modda çalıştıktan sonra bu 
sorunla karşılaşılmıştır. Bir işletim sistemi yükseltmesinden sonra ASP.NET Core modülünü onarın. Bkz. .NET 
Core barındırma paketi'Ni yüklemeyi. Yükleyici çalıştırıldığında Onar ' ı seçin. 






Eksik site uzantısı, 32-bit (x86) ve 64-bit (x64) site uzantıları yüklü veya 
yanlış işlem bit genişliği ayarlanmış 

Azure Uygulama Hizmetleri tarafından barındırılan uygulamalar için geçerlidir. 

• Tarayıcı: HTTP hatası 500,0-lşlem İçi Işleyici yükleme hatası 

• Uygulama günlüğü: InProcess istek işleyicisini bulmak için hostfxr çağırma hiçbir yerel bağımlılığı 
bulamamadan başarısız oldu. InProcess istek işleyicisi bulunamadı. Hostfxr çağırmadan yakalanan çıkış: 
herhangi bir uyumlu çerçeve sürümü bulmak mümkün değildi. Belirtilen 1 Microsoft. AspNetCore. App ' 
çerçevesi, 1 {VERSION}-Preview-*' sürümü bulunamadı. '/LM/VV3SVC/1416782824/ROOT 1 uygulaması 
başlatılamadı, hata kodu 1 0x8000FFFF '. 

• ASP.N ET Core modülü stdout günlüğü: Uyumlu bir çerçeve sürümü bulmak mümkün değildi. 

Belirtilen 1 Microsoft. AspNetCore. App ' çerçevesi, 1 {VERSION}-Preview-*' sürümü bulunamadı. 

• ASP.N ET Core modülü hata ayıklama günlüğü: InProcess istek işleyicisini bulmak için hostfxr çağırma 
hiçbir yerel bağımlılığı bulamamadan başarısız oldu. Büyük olasılıkla uygulamanın yanlış yapılandırılmış 
olduğu anlamına gelir, lütfen uygulamanın hedeflediği ve makinede yüklü olduğu Microsoft. NetCore. App ve 
Microsoft. AspNetCore. app sürümlerini denetleyin. Başarısız HRESULT döndürüldü: 0x8000FFFF. InProcess 
istek işleyicisi bulunamadı. Uyumlu bir çerçeve sürümü bulmak mümkün değildi. Belirtilen 1 Microsoft. 
AspNetCore. App 1 çerçevesi,' {VERSION}-Preview-*' sürümü bulunamadı. 

Sorun Giderme: 

• Uygulamayı bir önizleme çalışma zamanı üzerinde çalıştırıyorsanız, uygulamanın ve uygulamanın çalışma 
zamanının bit durumuyla eşleşen 32-bit (x86) veya 64 bit (x64) site uzantısını da yükler. Uzantı veya 
birden çok çalışma zamanı sürümünü yüklemeyin. 

O ASP.NET Core {RUNTIME VERSION} (x86) çalışma zamanı 
o ASP.NET Core {RUNTIME VERSION} (x64) çalışma zamanı 

Uygulamayı yeniden başlatın. Uygulamanın yeniden başlatılması için birkaç saniye bekleyin. 

• Uygulamayı bir önizleme çalışma zamanında çalıştırmak ve 32-bit (x86) ve 64 bit (x64) site uzantıları 
yüklüyse, uygulamanın bit durumuyla eşleşmeyen site uzantısını kaldırın. Site uzantısını kaldırdıktan 
sonra uygulamayı yeniden başlatın. Uygulamanın yeniden başlatılması için birkaç saniye bekleyin. 

• Uygulamayı bir önizleme çalışma zamanında çalıştırmak ve site uzantısının bit kullanımı uygulamayla 
eşleşiyorsa, önizleme sitesi uzantısının çalışma zamanı sürümünün uygulamanın çalışma zamanı 
sürümüyle eşleştiğini doğrulayın. 

• Uygulamanın uygulama ayarlarındaki platformunun uygulamanın bit durumuyla eşleştiğinden 
emin olun. 

Daha fazla bilgi için bkz. AS P.N ET Core uygulamalarını Azure App Service dağıtma. 

X86 uygulaması dağıtıldı, ancak uygulama havuzu 32-bit uygulamalar 
için etkinleştirilmemiş 

• Tarayıcı: HTTP hatası 500,30-lşlem İçi İşlem başlatma hatası 

• Uygulama günlüğü: ' {PATH} 1 fiziksel köküne sahip '/LM/VV3SVC/5/ROOT 1 uygulaması beklenmeyen 
yönetilen özel duruma ulaştı, özel durum kodu = ' 0xe0434352 '. Daha fazla bilgi için lütfen stderr 
günlüklerine bakın. 1 {PATH} 1 fiziksel köküne sahip '/LM/VV3SVC/5/ROOT ' uygulaması clr ve yönetilen 
uygulamayı yükleyemedi. CLR VVorker iş parçacığından erken çıkıldı 

• ASP.N ET Core modülü stdout günlüğü: Günlük dosyası oluşturulur ancak boştur. 


• ASP.N ET Core modülü hata ayıklama günlüğü: Başarısız HRESULT döndürüldü: 0x8007023e 


Bu senaryo, kendi içinde bulunan bir uygulama yayımlanırken SDK tarafından yakalanarak yapılır. RID platform 
hedefi ile eşleşmezse SDK bir hata üretir (örneğin, proje dosyasında <piatformTarget>x86</piatformTarget> ile 
RID winl0-x64 ). 

Sorun Giderme: 

X86 çerçevesine bağımlı bir dağıtım ( <piatformTarget>x86</piatformTarget> ) için 11S uygulama havuzunu 32 
bitlik uygulamalar için etkinleştirin. 11S Yöneticisi 'nde, uygulama havuzunun Gelişmiş ayarlarını açın ve 32 
bitlik uygulamaları doğruolarak etkinleştir ayarını yapın. 

Platform RID ile çakışıyor 

• Tarayıcı: HTTP hatası 502,5-lşlem hatası 

• Uygulama günlüğü: 1 C:{PATH} 1 fiziksel köküne sahip 1 

MACHıN E/WEBROOT/APPHOST/{ASSEMBLY} 1 uygulaması,' ' "C:{PATH} {ASSEMBLY} komut satırı ile 
işleme başlatamadı. {exe | dil}ErrorCode = 1 0x80004005: ff. 

• ASP.N ET Core modülü stdout günlüğü: işlenmeyen özel durum: System. BadlmageFormatException:' 
{ASSEMBLY}. dil 1 dosyası veya bütünleştirilmiş kodu yüklenemedi. Bir programı hatalı biçimde yükleme 
girişiminde bulunuldu. 

Sorun Giderme: 

• Uygulamanın Kestrel üzerinde yerel olarak çalıştığını doğrulayın, işlem hatası, uygulamanın içindeki bir 
sorunun sonucu olabilir. Daha fazla bilgi için bkz. Azure App Service ve 11S 'de ASP.NET Core sorunlarını 
giderme. 

• Bu özel durum, bir uygulamayı yükseltirken ve daha yeni derlemeler dağıtıldığında bir Azure Apps 
dağıtımı için oluşursa, önceki dağıtımdan tüm dosyaları el ile silin. Kalan uyumsuz derlemeler, yükseltilen 
bir uygulama dağıtıldığında System.BadimageFormatException özel durumuyla sonuçlanabilir. 

URI uç noktası yanlış veya durdurulmuş Web sitesi 

• Tarayıcı: ERR_CONNECTION_REFUSED —veya— bağlantı kurulamıyor 

• Uygulama günlüğü: Giriş yok 

• ASP.N ET Core modülü stdout günlüğü: Günlük dosyası oluşturulmaz. 

• ASP.N ET Core modülü hata ayıklama günlüğü: Günlük dosyası oluşturulmaz. 

Sorun Giderme: 

• Uygulamanın kullanımda olduğu doğru URI uç noktasını onaylayın. Bağlamaları denetleyin. 

• MS Web sitesinin durdurulmuş durumda olmadığını doğrulayın. 

CoreVVebEngine veya VV3SVC sunucu özellikleri devre dışı 

İşletim sistemi özel durumu: ASP.N ET Core modülünü kullanmak için 11S 7,0 CoreVVebEngine ve VV3SVC 
özelliklerinin yüklü olması gerekir. 

Sorun Giderme: 

Uygun rol ve özelliklerin etkinleştirildiğini doğrulayın. Bkz. IIS yapılandırması. 





Yanlış web sitesi fiziksel yolu veya uygulaması eksik 

• Tarayıcı: 403 Yasak-erişim reddedildi -veya-- 403,14 yasak-Web sunucusu bu dizinin içeriğini listebir 
şekilde yapılandırılmıştır. 

• Uygulama günlüğü: Giriş yok 

• ASP.N ET Core modülü stdout günlüğü: Günlük dosyası oluşturulmaz. 

• ASP.N ET Core modülü hata ayıklama günlüğü: Günlük dosyası oluşturulmaz. 

Sorun Giderme: 

IIS Web sitesi temel ayarları ve fiziksel uygulama klasörü ' ne bakın. Uygulamanın IIS Web sitesi fiziksel 
yolundakiklasörde olduğunu doğrulayın. 

Yanlış rol, ASP.NET Core modülü yüklü değil veya yanlış izinler 

• Tarayıcı: 500,19 İç sunucu hatası-sayfanın ilgili yapılandırma verileri geçersiz olduğundan istenen sayfaya 
erişilemiyor. —Veya— Bu sayfa görüntülenemiyor 

• Uygulama günlüğü: Giriş yok 

• ASP.N ET Core modülü stdout günlüğü: Günlük dosyası oluşturulmaz. 

• ASP.N ET Core modülü hata ayıklama günlüğü: Günlük dosyası oluşturulmaz. 

Sorun Giderme: 

• Doğru rolün etkin olduğunu onaylayın. Bkz. IIS yapılandırması. 

• Programlar & Özellikler veya uygulamalar & özellikleri açın ve Windows Server barındırma nın 

yüklü olduğunu doğrulayın. Yüklü programlar listesinde Windows Server barındırma yoksa, .NET Core 
barındırma paketi 1 ni indirip yükleyin. 

Geçerli .N ET Core barındırma Paket Yükleyici (doğrudan indirme) 

Daha fazla bilgi için bkz. .NET Core barındırma paketini yüklemeye. 

• Uygulama havuzunun > İşlem modeli > kimliğinin applicationpokaydentity olarak 
ayarlandığından emin olun veya özel kimliğin uygulamanın dağıtım klasörüne erişmek için doğru izinlere 
sahip olduğundan emin olun. 

• ASP.N ET Core barındırma paketini kaldırdıysanız ve barındırma paketinin önceki bir sürümünü 
yüklediyseniz ApplicationHost. config dosyası ASP.NET Core modülü için bir bölüm içermez. 
ApplicationHost. config dosyasını % windir%/system32/inetsrv/config konumunda açın ve 

<configurationxconfigSectionsxsectionGroup name="system.webServer"> bölüm grubunu bulun. Bölüm 
grubunda ASP.NET Core modülünün bölümü eksikse, Bölüm öğesini ekleyin: 

<section name="aspNetCore" overrideModeDefault="Allow" /> 

Alternatif olarak, AS P.N ET Core barındıran paketin en son sürümünü de yüklersiniz. En son sürüm, 
desteklenen ASP.NET Core uygulamalarla geriye dönük olarak uyumludur. 


Hatalı processPath, eksik yol değişkeni, barındırma paketi yüklü değil, 
sistem/IIS yeniden başlatılmadı, VC + + yeniden dağıtılabilir yüklü 
değil veya DotNet. exe erişim ihlali 




• Tarayıcı: HTTP hatası 500,0-lşlem İçi Işleyici yükleme hatası 

• Uygulama günlüğü: ' C:{PATH} 1 fiziksel köküne sahip 1 
MACHıNE/WEBROOT/APPHOST/{ASSEMBLY} 1 uygulaması,' ' komut satırı ile işlem başlatamadı 
ErrorCode = 1 0x80070002:0.' {PATH} 1 uygulaması başlatılamadı.' {PATH}' konumunda yürütülebilir 
dosya bulunamadı. 7LM/W3SVC/2/ROOT ' uygulaması başlatılamadı, hata kodu ' 0x8007023e '. 

• ASP.N ET Core modülü stdout günlüğü: Günlük dosyası oluşturulmaz. 

• ASP.NET Core modülü hata ayıklama günlüğü: Olay günlüğü: 1 {PATH} 1 uygulaması başlatılamadı. 1 
{PATH} 1 konumunda yürütülebilir dosya bulunamadı. Başarısız HRESULT döndürüldü: 0x8007023e 

• Tarayıcı: HTTP hatası 502,5-lşlem hatası 

• Uygulama günlüğü: 1 C:{PATH} 1 fiziksel köküne sahip ' 

MACHıNE/WEBROOT/APPHOST/{ASSEMBLY} 1 uygulaması,' ' "{...}" komut satırı ile işlem başlatamadı ', 
ErrorCode = ' 0x80070002:0. 

• ASP.N ET Core modülü stdout günlüğü: Günlük dosyası oluşturulur ancak boştur. 

Sorun Giderme: 

• Uygulamanın Kestrel üzerinde yerel olarak çalıştığını doğrulayın, işlem hatası, uygulamanın içindeki bir 
sorunun sonucu olabilir. Daha fazla bilgi için bkz. Azure App Service ve 11S 'de ASP.NET Core sorunlarını 
giderme. 

• Çerçeveye bağlı bir dağıtım (FDD) veya kendi kendine dahil olan bir dağıtım için . \{assembly} .exe 

dotnet olduğunu doğrulamak için Web. config 'deki <aspNetcore> öğesindeki processPath 
ÖZNITELIĞINI kontrol edin (SCD). 

• FDD için, DotNet. exe ' nin yol ayarları aracılığıyla erişilebilir olmayabilir. C:\Program Files\dotnet\ sistem 
yolu ayarlarında bulunduğunu onaylayın. 

• FDD için, DotNet. exe ' yi uygulama havuzunun Kullanıcı kimliği için erişilebilir olmayabilir.Uygulama 
havuzu Kullanıcı kimliğinin C:\Program Files\dotrıet d\z\r\\r\e erişimi olduğunu doğrulayın. C:\Program 
Files\dotnet\ıe uygulama dizinlerindeki uygulama havuzu Kullanıcı kimliği için yapılandırılmış reddetme 
kuralı olmadığını doğrulayın. 

• Bir FDD dağıtılmış ve 11S 'nin yeniden başlatılmasına gerek kalmadan .NET Core yüklenmiş olabilir.Bir 
komut isteminden net stop was/y ve ardından net start w3svc ' i yürüterek sunucuyu YENİDEN başlatın 
ya da 11S 'yi yeniden başlatın. 

• Bir FDD, barındırma sistemine .NET Core çalışma zamanı yüklenmeden dağıtılmış olabilir..NET Core 
çalışma zamanı yüklenmemişse, sistemde .NET Core barındırma paketi yükleyicisini çalıştırın. 

Geçerli .NET Core barındırma Paket Yükleyici (doğrudan indirme) 

Daha fazla bilgi için bkz. .NET Core barındırma paketini yüklemeye. 

Belirli bir çalışma zamanı gerekliyse, .net dovvnload arşivleri ' nden çalışma zamanını indirin ve sisteme 
yükleyin. Bir komut isteminden net stop idi ve ardından net start w3svc ' i yürüterek SİSTEMİ yeniden 
başlatarak veya 11S 'yi yeniden başlatarak yüklemeyi doldurun. 

<aspNetCore > öğesinin bağımsız değişkenleri yanlış 

• Tarayıcı: HTTP hatası 500,0-lşlem İçi Işleyici yükleme hatası 

• Uygulama günlüğü: InProcess istek işleyicisini bulmak için hostfxr çağırma hiçbir yerel bağımlılığı 
bulamamadan başarısız oldu. Büyük olasılıkla uygulamanın yanlış yapılandırılmış olduğu anlamına gelir, 







lütfen uygulamanın hedeflediği ve makinede yüklü olduğu Microsoft. NetCore. App ve Microsoft. 
AspNetCore. app sürümlerini denetleyin. InProcess istek işleyicisi bulunamadı. Hostfxr çağırmadan 
yakalanan çıkış: DotNet SDK komutlarını çalıştırmak mı istediniz? Lütfen 7LM/W3SVC/3/ROOT ' 
uygulaması başlatılamadı, hata kodu 1 0x8000FFFF https://go.microsoft.com/fwlink/? 

Linki D = 798306&clcid = 0x409. 

• ASP.N ET Core modülü stdout günlüğü: DotNet SDK komutlarını çalıştırmak mı istediniz? Lütfen 1 dan 
DotNet SDK 'Yı yükledikten sonra: https://go.microsoft.com/fwlink/?LinklD=798306&clcid = 0x409 

• ASP.N ET Core modülü hata ayıklama günlüğü: InProcess istek işleyicisini bulmak için hostfxr 
çağırma hiçbir yerel bağımlılığı bulamamadan başarısız oldu. Büyük olasılıkla uygulamanın yanlış 
yapılandırılmış olduğu anlamına gelir, lütfen uygulamanın hedeflediği ve makinede yüklü olduğu 
Microsoft. NetCore. App ve Microsoft. AspNetCore. app sürümlerini denetleyin. Başarısız HRESULT 
döndürüldü: 0x8000FFFF, InProcess istek işleyicisi bulamadı. Hostfxr çağırmadan yakalanan çıkış: DotNet 
SDK komutlarını çalıştırmak mı istediniz? Lütfen şu kaynaktan DotNet SDK 'Yı yüklersiniz: 
https://go.microsoft.com/fwlink/?LinklD=798306&clcid = 0x409 başarısız HRESULT döndürüldü: 
0x8000FFFF 

• Tarayıcı: HTTP hatası 502,5-lşlem hatası 

• Uygulama günlüğü: ' C:{PATH} 1 fiziksel köküne sahip 1 

MACHıN E/WEBROOT/APPHOST/{ASSEMBLY} 1 uygulaması' 1 "DotNet" komut satırı ile işleme 
başlatılamadı.{ASSEM BLYj.dll ErrorCode = 1 0x80004005:80008081. 

• ASP.N ET Core modülü stdout günlüğü: Yürütülecek uygulama yok:' yoKDERLEMESI}. dil' 

Sorun Giderme: 

• Uygulamanın Kestrel üzerinde yerel olarak çalıştığını doğrulayın, işlem hatası, uygulamanın içindeki bir 
sorunun sonucu olabilir. Daha fazla bilgi için bkz. Azure App Service ve 11S 'de ASP.NET Core sorunlarını 
giderme. 

• Framework 'e bağımlı bir dağıtım (FDD) için .\{assembly}.cI11 (a) olduğunu doğrulamak üzere Web. 
config içindeki <aspNetcore> öğesindeki arguments özniteliğini inceleyin; ya da (b) yok, boş bir dize ( 

arguments="" ) veya bağlITISIZ bir dağıtım için ( arguments="{ARGUMENT_l} J {ARGUMEN^}, ... {ARGUMENT_X}" ) 
uygulamanın bağımsız değişkenlerinin bir listesi (SCD). 

Eksik .NET Core paylaşılan çerçevesi 

• Tarayıcı: HTTP hatası 500,0-lşlem İçi Işleyici yükleme hatası 

• Uygulama günlüğü: InProcess istek işleyicisini bulmak için hostfxr çağırma hiçbir yerel bağımlılığı 
bulamamadan başarısız oldu. Büyük olasılıkla uygulamanın yanlış yapılandırılmış olduğu anlamına gelir, 
lütfen uygulamanın hedeflediği ve makinede yüklü olduğu Microsoft. NetCore. App ve Microsoft. 
AspNetCore. app sürümlerini denetleyin. InProcess istek işleyicisi bulunamadı. Hostfxr çağırmadan 
yakalanan çıkış: herhangi bir uyumlu çerçeve sürümü bulmak mümkün değildi. Belirtilen ' Microsoft. 
AspNetCore. App ' çerçevesi,' {VERSION}' sürümü bulunamadı. 

'/LM/W3SVC/5/ROOT ' uygulaması başlatılamadı, hata kodu ' 0x8000FFFF '. 

• ASP.N ET Core modülü stdout günlüğü: Uyumlu bir çerçeve sürümü bulmak mümkün değildi. 
Belirtilen ' Microsoft. AspNetCore. App ' çerçevesi,' {VERSION}' sürümü bulunamadı. 

• ASP.NET Core modülü hata ayıklama günlüğü: Başarısız HRESULT döndürüldü: 0x8000FFFF 

Sorun Giderme: 

Çerçeveye bağımlı bir dağıtım (FDD) için, sistemde doğru çalışma zamanının yüklü olduğunu doğrulayın. 





Uygulama havuzu durduruldu 

• Tarayıcı: 503 Hizmet kullanılamıyor 

• Uygulama günlüğü: Giriş yok 

• ASP.N ET Core modülü stdout günlüğü: Günlük dosyası oluşturulmaz. 

• ASP.N ET Core modülü hata ayıklama günlüğü: Günlük dosyası oluşturulmaz. 

Sorun Giderme: 

Uygulama havuzunun durdurulmuş durumda olmadığını onaylayın. 

Alt uygulama bir <işleyicileri içerir > Bölüm 

• Tarayıcı: HTTP hatası 500,19-lç sunucu hatası 

• Uygulama günlüğü: Giriş yok 

• ASP.N ET Core modülü stdout günlüğü: Kök uygulamanın günlük dosyası oluşturulur ve normal işlemi 
gösterir. Alt uygulamanın günlük dosyası oluşturulmaz. 

• ASP.N ET Core modülü hata ayıklama günlüğü: Kök uygulamanın günlük dosyası oluşturulur ve normal 
işlemi gösterir. Alt uygulamanın günlük dosyası oluşturulmaz. 

Sorun Giderme: 

Alt uygulamanın Web. corıfig dosyasının <handiers> bir bölüm içermediğinden veya alt uygulamanın üst 

uygulamanın işleyicilerini almadığından emin olun. 

Web. corıfig dosyasının üst uygulamanın <system.webServer> bölümü bir <iocation> öğesinin içine yerleştirilir. 

InheritlnChiIdApplications özelliği, <location > öğesi içinde belirtilen ayarların üst uygulamanın bir alt dizininde 

bulunan uygulamalar tarafından devralınmadığını göstermek için faise olarak ayarlanır. Daha fazla bilgi için 

bkz. ASP.NET Core Modülü. 

Alt uygulamanın Web. corıfig dosyasının <handiers> bir bölüm içermediğinden emin olun. 

stdout günlük yolu yanlış 

• Tarayıcı: Uygulama normal olarak yanıt verir. 

• Uygulama günlüğü: C:\Program Files\lIS\Asp.Net Core Module\v2\aspnetcorev2.dll 1 de stdout 
yeniden yönlendirmesi başlatılamadı. Özel durum iletisi: {PATH} 

\aspnetcoremodulev2\commonlib\fileoutputmanager.cpp: 84 konumunda HRESULT 0x80070005 
döndürüldü. C:\Program Files\lIS\Asp.Net Core Module\v2\aspnetcorev2.dll' de stdout yeniden 
yönlendirmesi durdurulamadı. Özel durum iletisi: HRESULT 0x80070002 {PATH} konumunda 
döndürüldü. {PATH} \ aspnetcorev2_inprocess. dil içinde stdout yeniden yönlendirmesi başlatılamadı. 

• ASP.N ET Core modülü stdout günlüğü: Günlük dosyası oluşturulmaz. 

• ASP.N ET Core modülü hata ayıklama günlüğü: C:\Program Files\IIS\Asp.Net Core 
Module\v2\aspnetcorev2.dll' de stdout yeniden yönlendirmesi başlatılamadı. Özel durum iletisi: {PATH} 
\aspnetcoremodulev2\commonlib\fileoutputmanager.cpp: 84 konumunda HRESULT 0x80070005 
döndürüldü. C:\Program Files\lIS\Asp.Net Core Module\v2\aspnetcorev2.dll' de stdout yeniden 
yönlendirmesi durdurulamadı. Özel durum iletisi: HRESULT 0x80070002 {PATH} konumunda 
döndürüldü. {PATH} \ aspnetcorev2_inprocess. dil içinde stdout yeniden yönlendirmesi başlatılamadı. 

• Uygulama günlüğü: Uyarı: stdoutLogFile \oluşturulamadı?{yol} \ path_doesnt_exist \ stdout_ {İşlem 







KİMLİĞİ} _ {zaman DAMGASı}. günlük, hata kodu =-2147024893. 

• ASP.N ET Core modülü stdout günlüğü: Günlük dosyası oluşturulmaz. 

Sorun Giderme: 

• Web. config dosyasının <aspNetcore> öğesinde belirtilen stdoutLogFile yolu yok. Daha fazla bilgi için 
bkz. AS P.N ET Core modülü: günlük oluşturma ve yeniden yönlendirme. 

• Uygulama havuzu kullanıcısının stdout günlük yoluna yazma erişimi yok. 

Uygulama yapılandırması genel sorunu 

• Tarayıcı: HTTP hatası 500,0-lşlem İçi Işleyici yükleme hatası --veya— HTTP hatası 500,30-Ancm İşlem İçi 
başlatma hatası 

• Uygulama günlüğü: Değişken 

• ASP.N ET Core modülü stdout günlüğü: Günlük dosyası oluşturulur ancak boş veya, uygulamanın 
noktası başarısız olana kadar normal girdilerle oluşturulur. 

• ASP.NET Core modülü hata ayıklama günlüğü: Değişken 

• Tarayıcı: HTTP hatası 502,5-lşlem hatası 

• Uygulama günlüğü: ' C:{PATH} fiziksel köküne sahip ' MACHıNE/WEBROOT/APPHOST/{ASSEMBLY} 

1 uygulaması' 1 "C:{PATH}{ASSEMBLY} komut satırı ile oluşturulan işlem oluşturdu. {exe | dil}ancak 
belirtilen 1 {PORT}' bağlantı noktasında kilitlenen veya yanıt vermeyen ya da bu bağlantı noktası üzerinde 
dinleme yapamadı, ErrorCode = ' {ERROR CODE}' 

• ASP.N ET Core modülü stdout günlüğü: Günlük dosyası oluşturulur ancak boştur. 

Sorun Giderme: 

Büyük olasılıkla uygulama yapılandırması veya programlama sorunu nedeniyle işlem başlatılamadı. 

Daha fazla bilgi için aşağıdaki konulara bakın: 

• Azure App Service ve 11S 'de ASP.N ET Core sorunlarını giderme 

• ASP.NET Core projeleri sorunlarını giderme 




VVeb.config'i dönüştürme 
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Tarafından Vijay Kmakrishnan ve Luke Latham 

Web. config dosyasına dönüşümler, bir uygulama temel alınarak yayımlandığında otomatik olarak uygulanabilir: 

• Derleme yapılandırması 

• Profilinizi 

• Ortam 

• Özel 

Bu dönüşümler aşağıdaki Web. config oluşturma senaryolarından biri için oluşur: 

• @No__t-0 SDK tarafından otomatik olarak oluşturulur. 

• Uygulamanın içerik kökünde geliştirici tarafından sağlanmaktadır. 

Yapı yapılandırması 

Derleme yapılandırma dönüştürmeleri önce çalıştırılır. 

Bir Web ekleyin. { Her derlemeyapılandırmasi için CONFIGURATION}. config dosyası (Hata Ayıkla | Yayın) bir 
Web. config dönüştürmesi gerektirir. 

Aşağıdaki örnekte, Web 'de yapılandırmaya özgü bir ortam değişkeni ayarlanır. Release. config: 

<?xml version="1.0"?> 

cconfiguration xmlns:xdt=" http://schemas.microsoft.com/XML-Document-Transform"> 

<location> 

<system.webServer> 

<aspNetCore> 

<environmentVariables xdt:Transform="InsertIfMissing"> 

<environmentVariable name="Configuration_Specific" 

value="Configuration_Specific_Value" 

xdt:Locator="Match(name)" 

xdt :Tr'ansfonm="InsentIfMissing" /> 

</environmentVariables> 

</aspNetCore> 

</system.webServer> 

</location> 

</configuration> 


Yapılandırmayoyınolarak ayarlandığında dönüşüm uygulanır: 

dotnet publish --configunation Release 

Yapılandırma için MSBuild özelliği $(Configuration) 'dır. 

Profil 

Profil dönüştürmeleri, Derleme yapılandırması dönüşümlerinden sonra ikinci çalıştırılır. 

Bir Web ekleyin. { Bir Web. config dönüşümü gerektiren her PROFİL yapılandırması için profile}, config dosyası. 












Aşağıdaki örnekte, Web 'de profile özgü bir ortam değişkeni ayarlanır. Bir klasör yayımlama profili İçin 
folderprofile. config: 


<?xml version="1.0"?> 

<configuration xmlns:xdt=" http://schemas.microsoft.com/XML-Document-Transform"> 
<location> 

csystem.webServer> 

<aspNetCore> 

cenvironmentVariables xdt:Transform="InsertIfMissing"> 
cenvironmentVariable name="Profile_Specific" 

value="Profile_Specific_Value" 

xdt:Locator="Match(name)" 

xdt:Transform="InsertIfMissing" /> 

</environmentVariables> 

</aspNetCore> 

</system.webServer> 

</location> 

</configuration> 


Profil Folderprofile olduğunda dönüştürme uygulanır: 

dotnet publish --configuration Release /p:PublishProfile=FolderProfile 

Profil adı için MSBuild özelliği $(PubüshProfiie) ' dır. 

Hiçbir profil geçirilmemişse, varsayılan profil adı dosya sistemi ve Web olur. Dosya uygulamanın içerik kökünde 
mevcutsa FileSystem. config uygulanır. 

Ortam 

Ortam dönüştürmeleri, Derleme yapılandırması ve profil dönüşümleri sonrasında üçüncü olarak çalıştırılır. 

Bir Web ekleyin. { Bir Web. config dönüştürmesi gerektiren her ortam için Environment}. config dosyası. 
Aşağıdaki örnekte, ortama özgü bir ortam değişkeni Web 'de ayarlanır . Üretim ortamı için Production. config : 

<?xml version="1.0"?> 

cconfiguration xmlns:xdt=" http://schemas.microsoft.com/XML-Document-Transform"> 

<location> 

csystem.webServer> 

<aspNetCore> 

cenvironmentVariables xdt:Transform="InsertIfMissing"> 
cenvironmentVariable name="Environment_Specific" 

value="Environment_Specific_Value" 

xdt:Locator="Match(name)" 

xdt:Transform="InsertlfMissing" /> 

</environmentVariables> 

</aspNetCore> 

</system.webServer> 

</location> 

</configuration> 

Dönüşüm, ortam E/reftmolduğunda uygulanır: 

dotnet publish --configuration Release /p:EnvironmentName=Production 

Ortamın MSBuild Özelliği $(EnvironmentName) ' dlr. 

Visual Studio 'dan yayımlama ve bir yayımlama profili kullanma sırasında, bkz. ASP.NET Core uygulama dağıtımı 













için Visual Studio yayımlama profilleri (. pubxml). 


@No__t-0 ortam değişkeni, ortam adı belirtildiğinde Web. config dosyasına otomatik olarak eklenir. 

Özel 

Özel dönüştürmeler son olarak, Derleme yapılandırması, profilve ortam dönüşümlerinden sonra çalıştırılır. 

Bir Web. config dönüştürmesi gerektiren her özel yapılandırma için bir {CUSTOM_NAME}. Transform dosyası 
ekleyin. 

Aşağıdaki örnekte, özel bir Transform ortam değişkeni Custom. Transform olarak ayarlanır: 

<?xml version="1.0"?> 

cconfiguration xmlns:xdt=" http://schemas.microsoft.com/XML-Document-Transform"> 

<location> 

<system.webServer> 

<aspNetCore> 

<environmentVariables xdt:Transform="InsertIfMissing"> 

<environmentVariable name="Custom_Specific" 

value="Custom_Specific_Value" 

xdt:Locator="Match(name)" 

xdt:Transform="InsertlfMissing" /> 

</environmentVariables> 

</aspNetCore> 

</system.webServer> 

</location> 

</configuration> 

Dönüşüm, customTransformFileName özelliği DotNet Publish komutuna geçirildiğinde uygulanır: 

dotnet publish --configuration Release /p:CustomTransformFileName=custom.transform 

Profil adı için MSBuild Özelliği $(CustomTransformFileName) ' dır. 

Web. config dönüşümünü engelle 

Web. config dosyasının dönüştürmelerini engellemek için $(iswebConfigTransformDisabied) MSBuild özelliğini 
ayarlayın: 

dotnet publish /p:IsWebConfigTnansfonmDisabled=true 


Ek kaynaklar 

• Web uygulaması proje dağıtımı için Web. config dönüştürme sözdizimi 

• Visual Studio kullanarak Web proje dağıtımı için Web. config dönüştürme sözdizimi 
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Tom Dykstra, ChrisNo, Stephen halterve Luke Latham tarafından 

Kestrel, ASP.NET Core için platformlar arası Web sunucusudur. Kestrel, ASP.NET Core 
proje şablonlarında varsayılan olarak bulunan Web sunucusudur. 

Kestrel aşağıdaki senaryoları destekler: 

• HTTPS 

• VVebSockets 'i etkinleştirmek için kullanılan donuk yükseltme 

• NGINX 'in arkasında yüksek performans için UNIX Yuvaları 

• HTTP/2 (macOS+hariç) 

+HTTP/2, gelecek sürümlerde macOS 'ta desteklenecektir. 

Kestrel, .NET Core 'un desteklediği tüm platformlarda ve sürümlerde desteklenir. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

HTTP/2 desteği 

Aşağıdaki temel gereksinimler karşılanıyorsa, http/2 ASP.NET Core uygulamalar için 
kullanılabilir: 

• İşletim sistemit 

o Windows Server 2016/Windows 10 veya üzeri* 

o OpenSSL 1.0.2 veya üzerini içeren Linux (örneğin, Ubuntu 16,04 veya üzeri) 

• Hedef Framevvork: .N ET Core 2,2 veya üzeri 

• Uygulama katmanı protokol anlaşması (ALPN) bağlantısı 

• TLS 1.2 veya sonraki bir bağlantı 

+HTTP/2, gelecek sürümlerde macOS 'ta desteklenecektir.tKestrel VVİndovvs Server 
2012 R2 ve Windows 8.1 üzerinde HTTP/2 için sınırlı destek içerir. Bu işletim 
sistemlerinde kullanılabilir olan desteklenen TLS şifre paketlerinin listesi sınırlı 
olduğundan destek sınırlıdır. TLS bağlantılarının güvenliğini sağlamak için Eliptik Eğri 
dijital İmza algoritması (ECDSA) kullanılarak oluşturulan bir sertifika gerekli olabilir. 

Bir HTTP/2 bağlantısı kurulduysa, HttpRequest. Protocol Reports http/2 . 

HTTP/2 varsayılan olarak devre dışıdır. Yapılandırma hakkında daha fazla bilgi için 

Kestrel Options ve Listenoptions. Protocols bölümlerine bakın. 

Ters ara sunucu ile Kestrel ne zaman kullanılır? 

Kestrel, kendisi veya Internet Information Services (IIS), NGINXveya Apachegibi bir 
ters ara sunucu ile kullanılabilir. Ters proxy sunucusu, ağdan gelen HTTP isteklerini alır 
ve Kestrel 'e iletir. 

Sınır (Internet 'e yönelik) Web sunucusu olarak kullanılan Kestrel: 




Internet 

HTTP 

◄- 


Ters Proxy yapılandırmasında kullanılan Kestrel: 

HTTP 

4 - 

iki yapılandırma de, ters ara sunucu sunucusuyla veya olmadan, desteklenen bir 
barındırma yapılandırması. 

Ters proxy sunucusu olmayan bir uç sunucu olarak kullanılan Kestrel, aynı İP ve 
bağlantı noktasının birden çok işlem arasında paylaşılmasını desteklemez. Kestrel bir 
bağlantı noktasını dinlemek üzere yapılandırıldığında, Kestrel Hoşt ' den bağımsız 
olarak bu bağlantı noktası için tüm trafiği işler. Bağlantı noktalarını paylaşabilen bir 
ters proxy, istekleri benzersiz bir İP ve bağlantı noktası üzerinde Kestrel 'e iletme 
yeteneğine sahiptir. 

Ters proxy sunucusu gerekli olmasa bile, ters proxy sunucu kullanılması iyi bir seçim 
olabilir. 

Ters proxy: 

• , Barındırdığı uygulamaların açığa çıkarılan genel yüzey alanını sınırlayabilir. 

• Ek bir yapılandırma ve savunma katmanı sağlayın. 

• , Mevcut altyapıyla daha iyi tümleşebilir. 

• Yük dengelemeyi ve güvenli iletişim (HTTPS) yapılandırmasını kolaylaştırın. 
Yalnızca ters proxy sunucusu bir X. 509.440 sertifikası gerektirir ve bu sunucu, düz 
HTTP kullanarak, iç ağdaki uygulamanın sunucularıyla iletişim kurabilir. 


VVARNING 

Ters Proxy yapılandırmasında barındırma, konak filtrelemeyigerektirir. 
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ASP.NET Core uygulamalarda Kestrel 

ASP.NET Core proje şablonları varsayılan olarak Kestrel kullanır.Program.csiçinde 
ConfigureVVebHostDefaults yöntemi UseKestrelçağırır: 

public static void Main(string[] args) 

{ 

CreateHostBuilder(args).Build().Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

})J 

Konak oluşturma hakkında daha fazla bilgi için .NET genel ana bilgisayaıono 
bilgisayar ve Varsayılan Oluşturucu ayarlarını ayarlama bölümüne bakın. 















configurewebHostDefauits çağrıldıktan sonra ek yapılandırma sağlamak için 
ConfigureKestrel kullanın: 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.ConfigureKestrel(serverOptions => 

{ 

// Set properties and cali methods on optlons 

}) 

.UseStartup<Startup>(); 


Kestrel seçenekleri 

Kestrel Web sunucusu, Internet 'e yönelik dağıtımlarda özellikle yararlı olan kısıtlama 
yapılandırma seçeneklerine sahiptir. 

KestrelServerOptions sınıfının Limits özelliğindeki kısıtlamaları ayarlayın. Limits 
özelliği KestrelServerLimits sınıfının bir örneğini barındırır. 

Aşağıdaki örnekler Microsoft.AspNetCore.Server.Kestrel.Core ad alanını kullanır: 

using Microsoft.AspNetCore.Server.Kestrel.Core; 

Aşağıdaki örneklerde C# kodda yapılandırılan Kestrel seçenekleri de bir yapılandırma 
sağlayıcısıkullanılarak ayarlanabilir. Örneğin, dosya yapılandırma sağlayıcısı bir 
appSettings. JSON veya appSettings 'ten Kestrel yapılandırmasını yükleyebilir. { 
Environment}. JSON dosyası: 

{ 

"Kestrel": { 

"Limits": { 

"MaxConcurrentConnections": 100, 

"MaxConcurrentUpgradedConnections": 100 

}, 

"DisableStringReuse": true 

} 

} 

Aşağıdaki yaklaşımlardan birini kullanın: 

• startup.configureServices 'de Kestrel yapılandırma: 

1. startup sınıfına bir ıconfiguration örneği ekleyin. Aşağıdaki örnek, 
eklenen yapılandırmanın configuration özelliğine atandığını varsayar. 

2. Startup.configureServices , yapılandırmanın Kestrel bölümünü Kestrel 
'in yapılandırmasına yükleyin. 











// using Microsoft.Extensions.Configuration 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<KestrelServerOptions>( 

Configuration.GetSection("Kestrel")); 

} 


• Ana bilgisayarı oluştururken Kestrel yapılandırma: 

Program.es' de, yapılandırmanın Kestrel bölümünü Kestrel yapılandırmasına 
yükleyin: 

// using Microsoft. Extensions .Dependencylnjection; 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureServices((context, Services) => 

{ 

Services.Configure<KestrelServerOptions>( 

context.Configuration.GetSection("Kestrel")); 

}) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 


Yukarıdaki yaklaşımların her ikisi de herhangi bir yapılandırma sağlayıcısıylaçalışır. 

Etkin tut zaman aşımı 

KeepAliveTimeout 

Etkin tutma zaman aşımınıalır veya ayarlar. Varsayılan olarak 2 dakikadır. 

webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.Limits.MaxConcurrentConnections = 100; 
serverOptions.Limits.MaxConcurrentUpgradedConnections = 100; 
serverOptions.Limits.MaxRequestBodySize = 10 * 1024; 
serverOptions.Limits.MinRequestBodyDataRate = 
new MinDataRate(bytesPerSecond: 100, 

gracePeriod: TimeSpan.FromSeconds(10)); 
serverOptions.Limits.MinResponseDataRate = 
new MinDataRate(bytesPerSecond: 100, 

gracePeriod: TimeSpan.FromSeconds(10)); 
serverOptions.Listen(IPAddress.Loopback, 5000); 
serverOptions.Listen(IPAddress.Loopback, 5001, 
listenOptions => 

{ 

listenOptions.UseHttps("testCert.pfx", 

"testPassword"); 

})J 

serverOptions.Limits.KeepAliveTimeout = 

TimeSpan.FromMinutes(2); 
serverOptions.Limits.RequestHeadersTimeout = 

TimeSpan.FromMinutes(l); 


İstemci bağlantıları üst sınırı 

MaxConcurrentConnections MaxConcurrentUpgradedConnections 






En fazla eş zamanlı açık TCP bağlantısı sayısı tüm uygulama için aşağıdaki kodla 
ayarlanabilir: 

webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.Limits.MaxConcurrentConnections = 100; 
serverOptions.Limlts.MaxConcurrentUpgradedConnections = 100; 
serverOptions.Limits.MaxRequestBodySize = 10 * 1024; 
serverOptions.Limits.MinRequestBodyDataRate = 
new MinDataRate(bytesPerSecond: 100, 

gracePeriod: TimeSpan.FromSeconds(10)); 
serverOptions.Limits.MinResponseDataRate = 
new MinDataRate(bytesPerSecond: 100, 

gracePeriod: TimeSpan.FromSeconds(10)); 
serverOptions.Listen(IPAddress.Loopback, 5000); 
serverOptions.Listen(IPAddress.Loopback, 5001, 
listenOptions => 

{ 

listenOptions.UseHttps("testCert.pfx", 

"testPassword"); 

})J 

serverOptions.Limits.KeepAliveTimeout = 

TimeSpan.FromMinutes(2); 
serverOptions.Limits.RequestHeadersTimeout = 

TimeSpan.FromMinutes(l); 


HTTP veya HTTPS 'den başka bir protokole (örneğin, bir VVebSockets isteğinde) 
yükseltilen bağlantılara yönelik ayrı bir sınır vardır. Bir bağlantı yükseltildikten sonra, 
MaxConcurrentconnections sınırına göre sayılmaz. 

webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.Limits.MaxConcurrentConnections = 100; 
serverOptions.Limits.MaxConcurrentUpgradedConnections = 100; 
serverOptions.Limits.MaxRequestBodySize = 10 * 1024; 
serverOptions.Limits.MinRequestBodyDataRate = 
new MinDataRate(bytesPerSecond: 100, 

gracePeriod: TimeSpan.FromSeconds(10)); 
serverOptions.Limits.MinResponseDataRate = 
new MinDataRate(bytesPerSecond: 100, 

gracePeriod: TimeSpan.FromSeconds(10)); 
serverOptions.Listen(IPAddress.Loopback, 5000); 
serverOptions.Listen(IPAddress.Loopback, 5001, 
listenOptions => 

{ 

listenOptions.UseHttps("testCert.pfx", 

"testPassword"); 

})J 

serverOptions.Limits.KeepAliveTimeout = 

TimeSpan.FromMinutes(2); 
serverOptions.Limits.RequestHeadersTimeout = 

TimeSpan.FromMinutes(l); 

}) 


En fazla bağlantı sayısı, varsayılan olarak sınırsız (null). 

En büyük istek gövdesi boyutu 

MaxRequestBodySize 

Varsayılan en büyük istek gövdesi boyutu 30.000.000 bayttır ve bu değer yaklaşık 28,6 
MB 'tır. 



ASP.NET Core MVC uygulamasında sınırı geçersiz kılmak için önerilen yaklaşım, bir 
eylem yönteminde RequestSizeLimitAttribute özniteliğini kullanmaktır: 

[RequestSizeLimit(100000000)] 
public IActionResult MyActionMethod() 


Her istekte uygulama için kısıtlamanın nasıl yapılandırılacağını gösteren bir örnek 
aşağıda verilmiştir: 

webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.Limits.MaxConcurrentConnections = 100; 
serverOptions.Limits.MaxConcurrentUpgradedConnections = 100; 
serverOptions.Limits.MaxRequestBodySize = 10 * 1024; 
serverOptions.Limits.MinRequestBodyDataRate = 
new MinDataRate(bytesPerSecond: 100, 

gracePeriod: TimeSpan.FromSeconds(10)); 
serverOptions.Limits.MinResponseDataRate = 
new MinDataRate(bytesPerSecond: 100, 

gracePeriod: TimeSpan.FromSeconds(10)); 
serverOptions.Listen(IPAddress.Loopback, 5000); 
serverOptions.Listen(IPAddress.Loopback, 5001, 
listenOptions => 

{ 

listenOptions.UseHttps("testCert.pfx", 

"testPassword"); 

}); 

serverOptions.Limits.KeepAliveTimeout = 

TimeSpan.FromMinutes(2); 
serverOptions.Limits.RequestHeadersTimeout = 

TimeSpan.FromMinutes(l); 


Ara yazılım içindeki belirli bir istek üzerindeki ayarı geçersiz kılın: 

app.Run(async (context) => 

{ 

context.Features.Get<IHttpMaxRequestBodySizeFeature>() 

.MaxRequestBodySize = 10 * 1024; 

var minRequestRateFeature = 

context.Features.Get<IHttpMinRequestBodyOataRateFeature>(); 
var minResponseRateFeature = 

context.Features.Get<IHttpMinResponseDataRateFeature>(); 

if (minRequestRateFeature != null) 

{ 

minRequestRateFeature.MinDataRate = new MinDataRate( 

bytesPerSecond: 100, gracePeriod: TimeSpan.FromSeconds(10)); 

} 

if (minResponseRateFeature != null) 

{ 

minResponseRateFeature.MinDataRate = new MinDataRate( 

bytesPerSecond: 100, gracePeriod: TimeSpan.FromSeconds(10)); 

} 

Uygulama isteği okumaya başladıktan sonra bir istek üzerindeki sınırı yapılandırırsa, 
bir özel durum oluşturulur. MaxRequestBodySize özelliğinin salt okuma durumunda 
olup olmadığını belirten isReadOniy bir özellik vardır. Bu, sınırı yapılandırmanın çok 
geç olduğunu gösterir. 






Bir uygulama ASP.NET Core modülününarkasında çalıştırıldığında , 11S sınırı zaten 
ayarladığı için Kestrel ’nin istek gövdesi boyut sınırı devre dışı bırakılır. 

En az istek gövdesi veri hızı 

MinRequestBodyDataRate MinResponseDataRate 

Kestrel bayt/saniye cinsinden belirtilen fiyata ulaşan her saniye sonra denetler. Oran en 
düşük değerin altına düşerse bağlantı zaman aşımına uğrar. Yetkisiz kullanım süresi, 
Kestrel 'in istemciye gönderme oranını en düşük süreye kadar artırabilme Bu süre 
boyunca fiyat denetlenmez. Yetkisiz kullanım süresi, TCP yavaş başlatma nedeniyle 
başlangıçta verileri yavaş bir hızda gönderen bağlantıların bırakılmasını önlemeye 
yardımcı olur. 

Varsayılan en düşük oran, 5 saniyelik bir yetkisiz kullanım süresi ile 240 bayt/saniye 
olur. 

Yanıt için bir minimum oran da geçerlidir. istek sınırını ayarlamaya yönelik kod ve yanıt 
sınırı, özellik ve arabirim adlarında RequestBody veya Response sahip olma dışında 
aynıdır. 

Program .csiçinde en düşük veri hızlarının nasıl yapılandırılacağını gösteren bir örnek 
aşağıda verilmiştir: 

webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.Limits.MaxConcurrentConnections = 100; 
serverOptions.Limits.MaxConcurrentUpgradedConnections = 100; 
serverOptions.Limits.MaxRequestBodySize = 10 * 1024; 
serverOptions.Limits.MinRequestBodyDataRate = 
new MinDataRate(bytesPerSecond: 100, 

gracePeriod: TimeSpan.FromSeconds(10)); 
serverOptions.Limits.MinResponseDataRate = 
new MinDataRate(bytesPerSecond: 100, 

gracePeriod: TimeSpan.FromSeconds(10)); 
serverOptions.Listen(IPAddress.Loopback, 5000); 
serverOptions.Listen(IPAddress.Loopback, 5001, 
listenOptions => 

{ 

listenOptions. UseFIttps ("testCert. pf x", 

"testPassword"); 

})J 

serverOptions.Limits.KeepAliveTimeout = 

TimeSpan.FromMinutes(2); 
serverOptions.Limits.RequestHeadersTimeout = 

TimeSpan.FromMinutes(l); 

}) 


Ara yazılım içindeki istek başına düşen minimum hız sınırlarını geçersiz kılın: 





app.Run(async (context) => 

{ 

context.Features.Get<IHttpMaxRequestBodySizeFeature>() 

.MaxRequestBodySize = 10 * 1024; 

var minRequestRateFeature = 

context.Features.Get<IHttpMinRequestBodyDataRateFeature>(); 
var minResponseRateFeature = 

context.Features.Get<IHttpMinResponseDataRateFeature>(); 

if (minRequestRateFeature != null) 

{ 

minRequestRateFeature.MinDataRate = new MinDataRate( 

bytesPerSecond: 100, gracePeriod: TlmeSpan.FromSeconds(10)); 

} 

if (minResponseRateFeature != null) 

{ 

minResponseRateFeature.MinDataRate = new MinDataRate( 

bytesPerSecond: 100, gracePeriod: TimeSpan.FromSeconds(10)); 

} 

Önceki örnekte başvurulan IHttpMinResponseDataRateFeature HTTP/2 istekleri için 
HttpContext. Features mevcut değildir, çünkü bir istek temelli olarak hız sınırlarını 
değiştirmek, protokolün istek çoğullama desteği nedeniyle HTTP/2 için genel olarak 
desteklenmez. Ancak, IHttpMinRequestBodyDataRateFeature HTTP/2 istekleri için 
HttpContext.Features olmaya devam eder, çünkü okuma hızı sınırı, bir HTTP/2 isteği 
için bile IHttpMinRequestBodyDataRateFeature.MinDataRate null olarak ayarlanarak 
tamamen istek temelli olarak devre dışı bırakılabilir. 

IHttpMinRequestBodyDataRateFeature.MinDataRate okumaya veya null dışında bir 
değere ayarlamaya çalışırken, bir HTTP/2 isteği verilen bir NotsupportedException 
atılmaya neden olur. 

KestreiserverOptions. Limits aracılığıyla yapılandırılan sunucu genelindeki hız sınırları 
hem HTTP/1. x hem de HTTP/2 bağlantıları için geçerlidir. 

İstek üst bilgileri zaman aşımı 

RequestHeadersTimeout 

Sunucunun istek üst bilgilerini alması için harcadığı en uzun süreyi alır veya ayarlar. 
Varsayılan değer 30 saniyedir. 










webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.Limits.MaxConcurrentConnections = 100; 
serverOptions.Limits.MaxConcurrentUpgradedConnections = 100; 
serverOptions.Limits.MaxRequestBodySize = 10 * 1024; 
serverOptions.Limits.MinRequestBodyDataRate = 
new MinDataRate(bytesPerSecond: 100., 

gracePeriod: TimeSpan.FromSeconds(10)); 
serverOptions.Limits.MinResponseDataRate = 
new MinDataRate(bytesPerSecond: 100, 

gracePeriod: TimeSpan.FromSeconds(10)); 
serverOptions.Listen(IPAddress.Loopback, 5000); 
serverOptions.Listen(IPAddress.Loopback, 5001, 
listenOptions => 

{ 

listenOptions.UseHttps("testCert.pfx", 
"testPassword"); 

})J 

serverOptions.Limits.KeepAliveTimeout = 

TimeSpan.FromMinutes(2); 
serverOptions.Limits.RequestHeadersTimeout = 

TimeSpan.FromMinutes(l); 


Bağlantı başına en fazla akış 

Http2.MaxstreamsPerConnection , HTTP/2 bağlantısı başına eşzamanlı istek akışı sayısını 
sınırlar. Fazlalık akışlar reddedildi. 

webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.Limits.Http2.MaxStreamsPerConnection = 100; 

}); 

Varsayılan değer 100'dür. 

Üst bilgi tablosu boyutu 

HPACK kod çözücüsü HTTP/2 bağlantıları için HTTP üstbilgilerini açar. 

Http2 . HeaderTableSize , HPACK kod çözücüsünün kullandığı üst bilgi sıkıştırma 
tablosunun boyutunu sınırlar. Değer sekizli cinsinden sağlanır ve sıfırdan büyük 
olmalıdır (0). 


webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.Limits.Http2.HeaderTableSize = 4096; 

}); 


Varsayılan değer 4096 1 dir. 

En büyük çerçeve boyutu 

Http2.MaxFrameSize , sunucu tarafından alınan veya gönderilen HTTP/2 bağlantı 
çerçevesi yükünün izin verilen en büyük boyutunu belirtir. Değer sekizli cinsinden 
sağlanır ve 2 A 14 (16.384) ile 2 A 24-1 (16.777.215) arasında olmalıdır. 

webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.Limits.Http2.MaxFrameSize = 16384; 

})J 










Varsayılan değer 2 A 14 1 dir (16.384). 

En fazla istek üst bilgi boyutu 

Http2.MaxRequestHeaderFieidSize , istek üst bilgisi değerlerinin sekizlisi cinsinden izin 
verilen en büyük boyutu gösterir. Bu sınır, sıkıştırılmış ve sıkıştırılmamış temsillerinde 
hem ad hem de değer için geçerlidir. Değer sıfırdan büyük (0) olmalıdır. 

webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.Limits.Http2.MaxRequestHeaderFieldSize = 8192; 

}); 

Varsayılan değer 8.192 1 dir. 

İlk bağlantı pencere boyutu 

Http2.initiaiconnectionwindowSize , bağlantı başına tüm istekler (akışlar) genelinde 
toplanan tek seferde sunucunun arabelleğe aldığı en fazla istek gövde verilerini bayt 
cinsinden gösterir, istekler aynı zamanda Http2.initiaistreamwindowSize ile sınırlıdır. 
Değer, 65.535 değerinden büyük veya buna eşit ve 2 A 31 (2.147.483.648) değerinden 
küçük olmalıdır. 

webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.Limits.Http2.InitialConnectionWindowSize = 131072; 

})J 

Varsayılan değer 128 KB 'tır (131.072). 

İlk akış pencere boyutu 

Http2.initiaistreamwindowSize , istek (Stream) başına bir seferde sunucu 
arabelleklerinin bayt cinsinden en yüksek istek gövde verilerini gösterir, istekler aynı 
zamanda Http2.initiaiconnectionwindowSize ile sınırlıdır. Değer, 65.535 değerinden 
büyük veya buna eşit ve 2 A 31 (2.147.483.648) değerinden küçük olmalıdır. 

webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.Limits.Http2.InitialStreamWindowSize = 98304; 

}); 

Varsayılan değer 96 KB 'tır (98.304). 

Zaman uyumlu GÇ 

AllovvSynchronouslO, istek ve yanıt için zaman uyumlu GÇ 'ye izin verilip 
verilmediğini denetler. Varsayılan değer faise şeklindedir. 


VVARNING 

Çok sayıda engelleme zaman uyumlu GÇ işlemi, iş parçacığı havuzuna neden olabilir ve bu da 
uygulamanın yanıt vermemesine neden olur. Yalnızca zaman uyumsuz GÇ desteklemeyen bir 
kitaplık kullanırken AllowSynchronousio etkinleştirin. 


Aşağıdaki örnek, zaman uyumlu GÇ 'yi sunar: 











webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.AllowSynchronousIO = true; 

}) 

Diğer Kestrel seçenekleri ve limitleri hakkında daha fazla bilgi için bkz.: 

• KestrelServerOptions 

• KestrelServerLimits 

• ListenOptions 

Uç nokta yapılandırması 

Varsayılan olarak, ASP.NET Core bağlar: 

• http://localhost:5000 

• https://localhost :5001 (yerel bir geliştirme sertifikası mevcut olduğunda) 
Kullanarak URL 'Leri belirtin: 

• ortam değişkeni aspnetcorejjrls . 

• --urls komut satırı bağımsız değişkeni. 

• urls ana bilgisayar yapılandırma anahtarı. 

• useuris genişletme yöntemi. 

Bu yaklaşımlar kullanılarak sağlanan değer bir veya daha fazla HTTP ve HTTPS uç 
noktası olabilir (varsayılan bir sertifika varsa HTTPS). Değeri noktalı virgülle ayrılmış 
bir liste olarak yapılandırın (örneğin, 

"Urls": "http://localhost:8000j http://localhost:8001" ). 

Bu yaklaşımlar hakkında daha fazla bilgi için sunucu URL 'leri ve geçersiz kılma 
yapılandırmasıbölümüne bakın. 

Geliştirme sertifikası oluşturuldu: 

• .NET Core SDK yüklendiği zaman. 

• Geliştirme-CERT aracı bir sertifika oluşturmak için kullanılır. 

Bazı tarayıcılarda yerel geliştirme sertifikasına güvenmek için açık izin verilmesi 
gerekir. 

Proje şablonları, uygulamaları HTTPS üzerinde varsayılan olarak çalışacak şekilde 
yapılandırır ve https yeniden yönlendirme ve HSTS desteğiiçerir. 

Kestrel için URL öneklerini ve bağlantı noktalarını yapılandırmak üzere 
KestrelServerOptions Listen veya ListenUnixSocket yöntemlerini çağırın. 

useuris , --urls komut satırı bağımsız değişkeni, urls ana bilgisayar yapılandırma 
anahtarı ve aspnetcorejjrls ortam değişkeni de çalışır, ancak bu bölümün ilerleyen 
kısımlarında belirtilen sınırlamalara sahiptir (HTTPS uç noktası yapılandırması için 
varsayılan sertifika kullanılabilir olmalıdır). 

KestrelServerOptions yapılandırması: 

ConfigureEndpointDefaults Varsayılanları (eylem<ListenOptions >) 

Belirtilen her bitiş noktası için çalıştırılacak bir yapılandırma Action belirtir. 








configureEndpointDefaults birden çok kez çağrılması, önceki Action s'in belirtilen son 
Action yerini alır. 

webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.ConfigureEndpointDefaults(listenOptions => 

{ 

// Configure endpoint defaults 

}); 

}); 


NOTE 

Listen çağrılmadan oluşturulan bitiş noktaları, ConfigureEndpointDefaults çağrılmadan önce , 
varsayılan olarak uygulanmaz. 


ConfigureHttpsDefaults (eylemcHttpsConnectionAdapterOptions >) 


Her HTTPS uç noktası için çalıştırılacak bir yapılandırma 

Action 

belirtir. 

ConfigureHttpsDefaults 

birden çok kez çağrılması, önceki 

Action 

s 'in belirtilen son 


Action yerini alır. 

webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.ConfigureHttpsDefaults(listenOptions => 

{ 

// certificate is an X509Certificate2 
listenOptions.ServerCertificate = certificate; 

}); 

}); 


NOTE 

Listen çağrılmadan oluşturulan bitiş noktaları, ConfigureHttpsDefaults çağrılmadan önce , 
varsayılan olarak uygulanmaz. 


Yapılandırma (Iconation) 

Giriş olarak bir IConfiguration alan Kestrel ayarlamak için bir yapılandırma yükleyicisi 
oluşturur. Yapılandırma, Kestrel için yapılandırma bölümünün kapsamına alınmalıdır. 

ListenOptions. UseHttps 

Kestrel'i HTTPS kullanacak şekilde yapılandırın. 

ListenOptions.UseHttps uzantıları: 

• UseHttps -varsayılan sertifikayla HTTPS kullanacak şekilde yapılandırın. 
Varsayılan sertifika yapılandırılmamışsa bir özel durum oluşturur. 

• UseHttps(string fileName) 


UseHttps(string fileName, string password) 


UseHttps(string fileName, string password, 
configureOptions) 

Action<HttpsConnectionAdapterOptions> 


• UseHttps(StoreName storeName, string subject) 


UseHttps(StoreName storeName, string subject, bool allowInvalid) 


UseHttps(StoreName storeName, string subject, bool allowInvalid, 
location) 

StoreLocation 









UseHttps(StoreName storeName, stning subject, bool allowInvalid, StoreLocation 

• location, Action<HttpsConnectionAdapterOptions> configureOptions) 

• UseHttps(X509Certificate2 serverCertificate) 

UseHttps(X509Certificate2 senverCertificate , 

• Action<HttpsConnectionAdapterOptions> configureOptions) 

• UseHttps(Action<HttpsConnectionAdapterOptions> configureOptions) 

ListenOptions.useHttps parametreleri: 

• filename , uygulamanın içerik dosyalarını içeren dizine göre bir sertifika dosyasının 
yolu ve dosya adıdır. 

• X. 509.440 sertifika verilerine erişmek için gereken parola password . 

• configureOptions , HttpsConnectionAdapterOptions yapılandırmak için Action . 
ListenOptions döndürür. 

• storeName , sertifikanın yükleneceği sertifika deposudur. 

• subject , sertifikanın konu adıdır. 

• aiiowinvaüd , otomatik olarak imzalanan sertifikalar gibi geçersiz sertifikaların 
dikkate alınıp alınmayacağını gösterir. 

• location , sertifikanın yükleneceği mağaza konumudur. 

• serverCertificate X. 509.440 sertifikasıdır. 

Üretimde HTTPS 'nin açıkça yapılandırılması gerekir.En azından, varsayılan bir 
sertifika sağlanmalıdır. 

Daha sonra açıklanan desteklenen yapılandırma: 

• Yapılandırma yok 

• Varsayılan sertifikayı yapılandırmadan Değiştir 

• Koddaki varsayılanları değiştirme 

Yapılandırma yok 

Kestrel http://iocaihost 15000 ve https://localhost : 5001 dinler (varsayılan bir 
sertifika varsa). 

Varsayılan sertifikayı yapılandırmadan Değiştir 
Kestrel yapılandırmasını yüklemek için varsayılan olarak 

Configure(context.Configuration.GetSection("Kestrel") ) CreateDefaultBuilder çağırır. 
Varsayılan bir HTTPS uygulama ayarları yapılandırma şeması Kestrel için kullanılabilir. 
Disk üzerindeki bir dosyadan ya da bir sertifika deposundan kullanılacak URL 'Ler ve 
Sertifikalar dahil olmak üzere birden çok uç nokta yapılandırın. 

Aşağıdaki appSettings. JSON örneğinde: 

• Geçersiz sertifikaların (örneğin, otomatik olarak imzalanan sertifikalar) 
kullanılmasına izin vermek için, Allowwınvalid öğesini true olarak ayarlayın. 

• Bir sertifika belirtmeyen herhangi bir HTTPS uç noktası (aşağıdaki örnekte 

bulunanHttpsdefaultcert ), varsayılan veya geliştirme sertifikası > Sertifikalar 

altında tanımlanan sertifikaya geri döner. 












{ 

"Kestrel": { 

"Endpoints": { 

"Http": { 

"Url": "http://localhost:5000" 

L 

"HttpsInlineCertFile": { 

"Unl": "https://localhost:5001", 

"Certificate": { 

"Path": "<path to .pfx file>", 

"Passwond": "<certificate password>" 

} 

}, 

"HttpsInlineCentStore": { 

"Url": "https://localhost:5002", 

"Certificate": { 

"Subject": "<subject; required>", 

"Stone": "«ccertificate store; required>", 

"Location": "clocation; defaults to CunrentUsen >", 
"AllowInvalid": "<true on false; defaults to false>" 

} 

}, 

"HttpsDefaultCent": { 

"Url": "https://localhost:5003" 

}, 

"Https": { 

"Url": "https://*:5004", 

"Certificate": { 

"Path": "<path to .pfx file>", 

"Password": "<certificate password>" 

} 

} 

b 

"Certificates": { 

"Default": { 

"Path": "<path to .pfx file>", 

"Password": "<certificate password>" 

} 

} 

} 

} 


Herhangi bir sertifika düğümü için yol ve parola kullanmanın alternatifi sertifika 
deposu alanlarını kullanarak sertifikayı belirtmektir. Örneğin, sertifikalar > 
varsayılan sertifika şöyle belirlenebilir: 

"Default": { 

"Subject": "<subject; required>", 

"Store": "ccert store; required>"j 

"Location": "«clocation; defaults to CurrentUser >", 

"AllowInvalid": "<true or false; defaults to false>" 

} 


Şema notları: 

• Uç nokta adları büyük/küçük harfe duyarlıdır.Örneğin, https ve Https geçerlidir. 

• Her uç nokta için url parametresi gereklidir. Bu parametrenin biçimi, en üst düzey 
urls yapılandırma parametresiyle aynıdır, ancak tek bir değerle sınırlı olur. 







• Bu uç noktalar, üst düzey urls yapılandırmasında tanımlananlara eklemek yerine 
bunların yerini alır. Listen aracılığıyla kodda tanımlanan uç noktalar yapılandırma 
bölümünde tanımlanan uç noktalar ile birikimlidir. 

• Certificate bölümü isteğe bağlıdır. Certificate bölümü belirtilmemişse, önceki 
senaryolarda tanımlanan varsayılanlar kullanılır. Kullanılabilir varsayılan değer 
yoksa, sunucu bir özel durum oluşturur ve başlayamaz. 

• Certificate bölümü, hem yol-parolasını hem de Konu-Mağaza sertifikalarını 
destekler. 

• Herhangi bir sayıda uç nokta, bağlantı noktası çakışmalarına neden olmadıkları 
sürece bu şekilde tanımlanabilir. 

• options.Configure(context.Configuration.GetSection("{SECTION}")) , yapılandırılmış 

bir uç noktanın ayarlarını tamamlamak için kullanılabilecek 
.Endpoint(string name, listenOptions => { }) yöntemi ile bir 
KestrelConfigurationLoader döndürür: 

webBuilder.UseKestrel((context, serverOptions) => 

{ 

serverOptions.Configure(context.Configuration.GetSection("Kestrel")) 
.Endpoint("HTTPS", listenOptions => 

{ 

listenOptions.HttpsOptions.SslProtocols = SslProtocols.Tlsl2; 

})J 

}); 

KestreiServerOptions.ConfigurationLoader , CreateDefaultBuildertarafından sağlana 
gibi var olan yükleyicisindeki yinelenmeye devam etmek için doğrudan erişilebilir. 

• Her uç noktanın yapılandırma bölümü, özel ayarların okunabilmesi için Endpoint 
yöntemindeki seçeneklerde kullanılabilir. 

• options.Configure(context.Configuration.GetSection("{SECTION}")) başka bir 
bölümle yeniden çağırarak birden çok yapılandırma yüklenebilir. Load önceki 
örneklerde açıkça çağrılmamışsa yalnızca son yapılandırma kullanılır. Metapackage, 
varsayılan yapılandırma bölümünün değiştirilebilmesi için Load çağırmaz. 

• KestrelConfigurationLoader , API 'lerin Listen ailesini KestreiServerOptions 
Endpoint aşırı yükleme olarak yansıtır, bu nedenle kod ve yapılandırma uç 

noktaları aynı yerde yapılandırılabilir. Bu aşırı yüklemeler adları kullanmaz ve 
yalnızca yapılandırmadan varsayılan ayarları kullanır. 

Koddaki varsayılanları değiştirme 

configureEndpointDefaults ve configureHttpsDefaults , önceki senaryoda belirtilen 
varsayılan sertifikayı geçersiz kılma da dahil olmak üzere ListenOptions ve 
HttpsConnectionAdapterOptions için varsayılan ayarları değiştirmek üzere kullanılabilir. 
ConfigureEndpointDefaults ve ConfigureHttpsDefaults herhangi bir UÇ nokta 
yapılandırılmadan önce çağrılmalıdır. 


















webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.ConfigureEndpointDefaults(listenOptions => 

{ 

// Configure endpoint defaults 
})J 

serverOptions.ConfigureHttpsDefaults(listenOptions => 

{ 

listenOptions.SslProtocols = SslProtocols.TİSİ2; 

}); 

}); 

SNı için Kestrel desteği 

Sunucu adı belirtme (SNı) , aynı İP adresi ve bağlantı noktası üzerinde birden fazla etki 
alanını barındırmak için kullanılabilir. SNı 'nin çalışması için, istemci, TLS el sıkışması 
sırasında güvenli oturum ana bilgisayar adını, sunucunun doğru sertifikayı 
sağlayabilmesi için gönderir, istemci, TLS anlaşmasını izleyen güvenli oturum sırasında 
sunucuyla şifreli iletişim için bulunan sertifikayı kullanır. 

Kestrel serverCertificateSelector geri çağırma aracılığıyla SNı destekler.Geri 
çağırma, uygulamanın ana bilgisayar adını incelemesine ve uygun sertifikayı seçmesini 
sağlamak için bağlantı başına bir kez çağrılır. 

SNı desteği şunları gerektirir: 

• Hedef Framevvork netcoreapp2.ı veya sonraki sürümlerde çalışıyor. net46i veya 
sonraki sürümlerde, geri çağırma çağrılır, ancak name her zaman nuiı . Ayrıca, 
istemci, TLS el sıkışmasının ana bilgisayar adı parametresini sağlamıyorsa da nuiı 

name . 

• Tüm Web siteleri aynı Kestrel örneğinde çalışır.Kestrel, bir İP adresi ve bağlantı 
noktasının bir ters proxy olmadan birden çok örnek arasında paylaşılmasını 
desteklemez. 










webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.ListenAnyIP(5005, listenOptions => 

{ 

listenOptions.UseHttps(httpsOptions => 

{ 

var localhostCert = CertificateLoader.LoadFromStoreCert( 

"localhost", "My", StoreLocation.CurrentUser, 
allowInvalid: true); 

var exampleCert = CertificateLoader.LoadFromStoreCert( 

"example.com" , "My", StoreLocation.CurrentUser, 
allowInvalid: true); 

var subExampleCert = CertificateLoader.LoadFromStoreCert( 
"sub.example.com", "My", StoreLocation.CurrentUser, 
allowInvalid: true); 

var certs = new Dictionarycstring, X509Certificate2>( 
StringComparer.OrdinalIgnoreCase); 
certs["localhost"] = localhostCert; 
certs ["example.com"] = exampleCert; 
certs["sub. example.com"] = subExampleCert; 

httpsOptions.ServerCertificateSelector = (connectionContext, name) => 

{ 

if (name != null && certs.TryGetValue(name, out var cert)) 

{ 

return cert; 

} 

return exampleCert; 

}; 

}); 

}); 

}); 


Bağlantı günlüğü 

Bir bağlantıda bayt düzeyinde iletişim için hata ayıklama düzeyi günlüklerini yayma 
UseConnectionLogging çağırın. Bağlantı günlüğü, TLS şifreleme ve proxy 'nin 
arkasındaki gibi alt düzey iletişimde sorunları gidermeye yardımcı olur. 
UseConnectionLogging useHttps önce yerleştirilmişse, şifrelenmiş trafik günlüğe 
kaydedilir. UseConnectionLogging UseHttps sonra yerleştirilmişse, şifresi çözülmüş 
trafik günlüğe kaydedilir. 

webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.Listen(IPAddress.Any, 8000, listenOptions => 

{ 

listenOptions.UseConnectionLogging]); 

}); 

}); 


TCP yuvasına bağlama 

Listen yöntemi bir TCP yuvasına bağlanır ve bir seçenek lambda X. 509.440 sertifika 
yapılandırmasına izin verir: 





public static void Main(string[] angs) 

{ 

CreateHostBuilder(args).Build().Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.Listen(IPAddress.Loopback, 5000); 
serverOptions.Listen(IPAddress.Loopback, 5001 , 
listenOptions => 

{ 

listenOptions.UseHttps("testCert.pfx ", 

"testPassword "); 

}); 

}) 

.UseStartup<Startup>(); 

}); 

Örnek, ListenOptionsolan bir uç nokta için HTTPS 'yi yapılandırır. Belirli uç noktalar 
için diğer Kestrel ayarlarını yapılandırmak üzere aynı API 'yi kullanın. 

Windows üzerinde otomatik olarak imzalanan sertifikalar kullanılarak oluşturulabilir 
New-SelfSignedCertificate PovverShell cmdlet'i. Desteklenmeyen bir örnek için bkz 
U pdatel IS ExpressS S L ForC hrome.ps 1 . 

MacOS, Linux ve Windows, sertifikalar kullanılarak oluşturulabilir OpenSSL. 

UNIX yuvasına bağlama 

Aşağıdaki örnekte gösterildiği gibi NGINX ile daha iyi performans için 
ListenllnixSocket bir UNIX yuvası dinleyin: 

webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.ListenUnixSocket("/tmp/kestrel-test.sock"); 
serverOptions.ListenUnixSocket("/tmp/kestrel-test.sock ", 
listenOptions => 

{ 

listenOptions.UseHttps("testCert.pfx ", 

"testpassword "); 

}); 

}) 


Bağlantı noktası 0 

0 bağlantı noktası numarası belirtildiğinde, Kestrel dinamik olarak kullanılabilir bir 
bağlantı noktasına bağlanır. Aşağıdaki örnek, çalışma zamanında Kestrel gerçekte 
hangi bağlantı noktasının gerçekten bağlandığını nasıl belirleyeceğini göstermektedir 



public void Configure(IApplicationBuilder app) 

{ 

var serverAddressesFeature = 

app.ServerFeatures.Get<IServerAddressesFeature>(); 

app.UseStaticFiles(); 

app.Run(async (context) => 

{ 

context.Response.ContentType = "text/html"; 
await context.Response 

.WriteAsync("< IDOCTYPE htmlxhtml lang=\"en\"xhead>" + 

"<titlex/titlex/headxbodyxp>Flosted by Kestrel</p>"); 

if (serverAddressesFeature != null) 

{ 

await context.Response 

.WriteAsync("<p>Listening on the following addresses: " + 
string.Doin("j ", serverAddressesFeature.Addresses) + 

"</p>"); 

} 

await context.Response.WriteAsync("<p>Request URL: " + 
$"{context.Request.GetDisplayUrl()}<p>"); 

}); 

} 

Uygulama çalıştırıldığında konsol penceresi çıkışı, uygulamanın erişilebileceği dinamik 
bağlantı noktasını gösterir: 

Listening on the following addresses: http://127.0.0.1:48508 

Sınırlamalar 

Aşağıdaki yaklaşımlar ile uç noktaları yapılandırın: 

• UseUrls 

• --urls komut satırı bağımsız değişkeni 

• urls ana bilgisayar yapılandırma anahtarı 

• aspnetcore_urls ortam değişkeni 

Bu yöntemler, kodun Kestrel dışındaki sunucularla çalışmasını sağlamak için yararlıdır. 
Ancak, aşağıdaki sınırlamalara dikkat edin: 

• HTTPS uç noktası yapılandırmasında varsayılan bir sertifika sağlanmadığı sürece 
(örneğin, bu konuda daha önce gösterildiği gibi KestreiserverOptions 
yapılandırması veya yapılandırma dosyası kullanılarak), HTTPS bu yaklaşımlar ile 
kullanılamaz. 


Listen 

ve 

UseUrls 

yaklaşımlarının her ikisi de aynı anda kullanıldığında 

Listen 

uç noktaları 

UseUrls 

uç noktaları geçersiz kılar. 


IIS uç nokta yapılandırması 

IIS kullanırken, IIS geçersiz kılma bağlamaları için URL bağlamaları Listen veya 
useuris tarafından ayarlanır. Daha fazla bilgi için ASP.NET Core modülü konusuna 
bakın. 

ListenOptions. Protocols 

Protocols özelliği, bir bağlantı uç noktasında veya sunucu için etkin HTTP 












protokollerini ( HttpProtocols ) belirler. HttpProtocols numaralandırmasından 
Protocols özelliğine bir değer atayın. 

HTTPPROTOCOLS ENUM DEĞERİ BAĞLANTI PROTOKOLÜ İZİN VERİLDİ 

Httpi Yalnızca HTTP/1.1., TLS olmadan veya ile 

kullanılabilir. 


Http2 Yalnızca HTTP/2. Yalnızca istemci önceki bir 

bilgi modunuDESTEKLIYORSA, TLS olmadan 
kullanılabilir. 


HttpiAndHttp2 HTTP/1.1 ve HTTP/2. HTTP/2, istemcinin TLS 

uygulama katmanı protokol anlaşması (ALPN) 
el sıkışmasında http/2 seçmesini gerektirir; 
Aksi takdirde, bağlantı varsayılan olarak 
HTTP/1.1 ’dir. 


Herhangi bir uç nokta için varsayılan ListenOptions.Protocols değeri 
HttpProtocols.HttplAndHttp2 . 

HTTP/2 için TLS kısıtlamaları: 

• TLS sürüm 1,2 veya üzeri 

• Yeniden anlaşma devre dışı 

• Sıkıştırma devre dışı 

• En az kısa ömürlü anahtar değişim boyutları: 

o Eliptik Eğri Diffie-Hellman (ECDHE) [RFC4492] - 224 bit minimum 
o Sınırlı alan Diffie-Hellman (DHE) [ TLS12 ] - 2048 bit minimum 

• Şifre paketi kara listede değil 

TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 [] TLS-ECDHE , P"256 eliptik eğrisi [ FIPS186 ] 
varsayılan olarak desteklenir. 

Aşağıdaki örnek, 8000 numaralı bağlantı noktasında HTTP/1.1 ve HTTP/2 
bağlantılarına izin verir. Bağlantılar, sağlanan bir sertifikayla TLS ile güvenlidir: 

webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.Listen(IPAddress.Any, 8000, listenOptions => 

{ 

listenOptions.UseHttps("testCert.pfx", "testPassword"); 

})J 

}); 

Gerektiğinde belirli şifrelemeler için TLS el sıkışmaları için bağlantı temelinde filtre 
uygulamak üzere bağlantı ara yazılımı kullanın. 

Aşağıdaki örnek, uygulamanın desteklemediği tüm şifre algoritmaların 
NotSupportedException oluşturur. Alternatif olarak, ılshandshakefeature. 
CipherAlgorithm öğesini kabul edilebilir şifreleme paketleri listesi ile tanımlayın ve 
karşılaştırın. 

CipherAlgorithmType. null şifre algoritması ile hiçbir şifreleme kullanılmaz. 











// using System.Net; 

// using Microsoft.AspNetCore.Connections; 

webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.Listen(IPAddress.Any, 8000 , listenOptions => 

{ 

listenOptions.UseHttps("testCert.pfx ", "testPassword"); 
listenOptions.UseTlsFilter(); 

}); 

}); 


using System; 

using System.Security.Authentication; 

using Microsoft.AspNetCore.Connections.Features; 

namespace Microsoft.AspNetCore.Connections 

{ 

public static class TlsFilterConnectionMiddlewareExtensions 

{ 

public static IConnectionBuilder UseTlsFilter( 
this IConnectionBuilder builder) 

{ 

return builder.Use( (connection., next) => 

{ 

var tlsFeature = connection.Features.Get<ITlsFlandshakeFeature>() 

if (tlsFeature.CipherAlgorithm == CipherAlgorithmType.Null) 

{ 

throw new NotSupportedException("Prohibited cipher: " + 
tlsFeature.CipherAlgorithm); 

} 

return next(); 

}); 

} 

} 

} 


Bağlantı filtrelemesi, bir IConnectionBuilder lambda aracılığıyla da yapılandırılabilir: 



// using System; 

// using System.Net; 

// using System.Security.Authentication; 

// using Microsoft.AspNetCore.Connections; 

// using Microsoft.AspNetCore.Connections.Features; 

webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.Listen(IPAddress.Any, 8080 , listenOptions => 

{ 

listenOptions.UseHttps("testCert.pfx ", "testPassword"); 
listenOptions.Use((contextj next) => 

{ 

var tlsFeature = context.Features.Get<ITlsHandshakeFeature>(); 

if (tlsFeature.CipherAlgorithm == CipherAlgorithmType.Null) 

{ 

throw new NotSupportedException( 

$"Prohibited cipher: {tlsFeature.CipherAlgorithm}"); 

} 

return next(); 

})J 

}); 

}); 


Linux 'ta CipherSuitesPolicy, TLS el sıkışmaları her bağlantı temelinde filtrelemek için 
kullanılabilir: 


// using System.Net.Security; 

// using Microsoft.AspNetCore.Hosting; 

// using Microsoft.AspNetCore.Server.Kestrel.Core; 

// using Microsoft.Extensions.Dependencylnjection; 

// using Microsoft. Extensions .Hosting; 

webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.ConfigureHttpsDefaults(listenOptions => 

{ 

listenOptions.OnAuthenticate = (context, sslOptions) => 

{ 

sslOptions.CipherSuitesPolicy = new CipherSuitesPolicy( 
new[] 

{ 

TlsCipherSuite.TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256, 
TlsCipherSuite.TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384, 
// ... 

}); 

}; 

}); 

}); 


Protokolü yapdandırmadarı ayarla 

Kestrel yapılandırmasını yüklemek için varsayılan olarak 
serverOptions.Configure(context.Configuration.GetSection("Kestrel")) 
CreateDefaultBuilder çağırır. 

Aşağıdaki appSettlngs. JSON örneği, tüm uç noktalar için varsayılan bağlantı 
protokolü olarak http/1.1 oluşturur: 




{ 

"Kestrel": { 

"EndpointDefaults": { 
"Protocols": "Httpl" 

} 

} 


Aşağıdaki appSettings. JSON örneği, belirli bir uç nokta için http/1.1 bağlantı 
protokolünü belirler: 

{ 

"Kestrel": { 

"Endpoints": { 

"HttpsDefaultCert": { 

"Url": "https://localhost:5001", 

"Protocols": "Httpl" 

} 

} 

} 

} 


Yapılandırma tarafından ayarlanan kod geçersiz kılma değerlerinde belirtilen 
protokoller. 

Aktarım yapılandırması 

Libuv (UseLibuv) kullanımını gerektiren projeler için: 

• Uygulamanın proje dosyasına Microsoft. AspNetCore. Server. Kestrel. 
Transport. libuv paketi için bir bağımlılık ekleyin: 

<PackageReference 

Include="Microsoft.AspNetCore.Server.Kestrel.T ransport.Libuv" 
Version="{VERSION}" /> 

• ıwebHostBuiider UseLibuv çağırın: 

public class Program 

{ 

public static void Main(string[] args) 

{ 

CreateHostBuilder(args).Build().Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 
Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseLibuv(); 
webBuilder.UseStartup<Startup>(); 

}); 

} 


URL önekleri 

useuris , --urls komut satırı bağımsız değişkenini, urls ana bilgisayar 
yapılandırma anahtarını veya aspnetcore_urls ortam değişkenini kullanırken, URL 
önekleri aşağıdaki biçimlerden birinde olabilir. 







Yalnızca HTTP URL ön ekleri geçerlidir.Kestrel, useuris kullanılarak URL bağlamaları 
yapılandırırken HTTPS 'Yİ desteklemez. 

• Bağlantı noktası numarası olan IPv4 adresi 

http://65.55. 39.10:80/ 

0 . 0 . 0.0 , tüm IPv4 adreslerine bağlanan özel bir durumdur. 

• Bağlantı noktası numarasına sahip IPv6 adresi 

http://[0:0:0:0:0:ffff:4137:270a]:80/ 

[::] , IPv4 0 . 0 . 0.0 IPv6 eşdeğeridir. 

• Bağlantı noktası numarası olan ana bilgisayar adı 

http://contoso.com:80/ 
http://*:80/ 

Ana bilgisayar adları, * ve + özel değildir. Geçerli bir İP adresi olarak 
tanınmayan bir şey veya localhost tüm IPv4 ve IPv6 İP 'lerine bağlanır.Farklı 
ana bilgisayar adlarını aynı bağlantı noktasında farklı ASP.NET Core 
uygulamalarına bağlamak için, http. sys veya IIS, NGINX veya Apache gibi bir 
ters proxy sunucusu kullanın. 


VVARNING 

Ters Proxy yapılandırmasında barındırma, konak filtrelemeyigerektirir. 


• Port numarası veya bağlantı noktası numarası ile geri döngü İP 'si localhost 
ana bilgisayar adı 

http://localhost:5000/ 
http://127.0- 0.1:5000/ 
http://[::1]:5000/ 

localhost belirtildiğinde, Kestrel hem IPv4 hem de IPv6 geri döngü 
arabirimlerini bağlamaya çalışır, istenen bağlantı noktası, herhangi bir geri 
döngü arabiriminde başka bir hizmet tarafından kullanılıyorsa, Kestrel 
başlatılamaz. Herhangi bir geri döngü arabirimi başka bir nedenle 
kullanılamıyorsa (genellikle IPv6 desteklenmediği için), Kestrel bir uyarı 
kaydeder. 

Konak filtreleme 

Kestrel, http://exampie.com : 5000 gibi önekleri temel alarak yapılandırmayı desteklese 
de, büyük ölçüde ana bilgisayar adını yoksayar. Ana bilgisayar localhost , geri döngü 
adreslerine bağlama için kullanılan özel bir durumdur. Açık İP adresi dışındaki tüm ana 
bilgisayar tüm genel İP adreslerine bağlanır. Hoşt üstbilgileri doğrulanmadı. 

Geçici bir çözüm olarak, ana bilgisayar filtreleme ara yazılımı kullanın. Ana bilgisayar 











filtreleme ara yazılımı, ASP.NET Core uygulamaları için örtük olarak sunulan 
Microsoft. AspNetCore. HostFiltering paketi tarafından sağlanır. Ara yazılım, 
AddHostFilteringçağıran CreateDefaultBuildertarafından eklenir: 


public class Program 
{ 

public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build().Run(); 

} 


} 


public static IklebHostBuilder CreateWebHostBuilder(string[] args) => 
WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>(); 


Ana bilgisayar filtreleme ara yazılımı varsayılan olarak devre dışıdır. Ara yazılımı 
etkinleştirmek için appSettirıgs.json/appSettings içinde bir AiiowedHosts anahtarı 
tanımlayın ,<environmentname >. JSON. Değer, bağlantı noktası numaraları olmayan 
ana bilgisayar adlarının noktalı virgülle ayrılmış listesidir: 


appSettings. JSON: 

{ 

"AllowedHosts": "example.comjlocalhost" 

} 


NOTE 

İletilen üstbilgiler ara yazılımı ayrıca bir AllovvedFlosts seçeneği de vardır, iletilen üstbilgiler ara 
yazılımı ve ana bilgisayar filtreleme ara yazılımı, farklı senaryolar için benzer işlevlere sahiptir. 
İletilen üst bilgi ara sunucusu ile AilowedHosts ayarlama, istekleri bir ters ara sunucu veya 
yük dengeleyici ile iletirken, Hoşt üst bilgisi korunurken uygun olur. Kestrel genel kullanıma 
açık bir uç sunucu olarak veya Hoşt üstbilgisi doğrudan iletildiğinde, ana bilgisayar 
filtreleme ara yazılımı ile AilowedHosts ayarlama uygundur. 

İletilen üstbilgiler ara yazılımı hakkında daha fazla bilgi için bkz. Proxy sunucularıyla ve yük 
dengeleyicilerle çalışacak ASP.NET Core yapılandırma. 


Kestrel, ASP.NET Core için platformlar arası Web sunucusudur. Kestrel, ASP.NET Core 
proje şablonlarında varsayılan olarak bulunan Web sunucusudur. 

Kestrel aşağıdaki senaryoları destekler: 

• HTTPS 

• VVebSockets 'i etkinleştirmek için kullanılan donuk yükseltme 

• NGINX 'in arkasında yüksek performans için UNIX Yuvaları 

• HTTP/2 (macOS+hariç) 

+HTTP/2, gelecek sürümlerde macOS 'ta desteklenecektir. 

Kestrel, .NET Core 'un desteklediği tüm platformlarda ve sürümlerde desteklenir. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 


HTTP/2 desteği 




Aşağıdaki temel gereksinimler karşılanıyorsa, http/2 ASP.NET Core uygulamalar için 
kullanılabilir: 

• İşletim sistemit 

o VVİndovvs Server 2016/Windows 10 veya üzeri* 

o OpenSSL 1.0.2 veya üzerini içeren Linux (örneğin, Ubuntu 16,04 veya üzeri) 

• Hedef Framevvork: .N ET Core 2,2 veya üzeri 

• Uygulama katmanı protokol anlaşması (ALPN) bağlantısı 

• TLS 1.2 veya sonraki bir bağlantı 

+HTTP/2, gelecek sürümlerde macOS 'ta desteklenecektir.*Kestrel VVİndovvs Server 
2012 R2 ve VVİndovvs 8.1 üzerinde HTTP/2 için sınırlı destek içerir. Bu işletim 
sistemlerinde kullanılabilir olan desteklenen TLS şifre paketlerinin listesi sınırlı 
olduğundan destek sınırlıdır. TLS bağlantılarının güvenliğini sağlamak için Eliptik Eğri 
dijital İmza algoritması (ECDSA) kullanılarak oluşturulan bir sertifika gerekli olabilir. 

Bir HTTP/2 bağlantısı kurulduysa, HttpRequest. Protocol Reports http/2 . 

HTTP/2 varsayılan olarak devre dışıdır. Yapılandırma hakkında daha fazla bilgi için 
Kestrel Options ve Listenoptions. Protocols bölümlerine bakın. 

Ters ara sunucu ile Kestrel ne zaman kullanılır? 

Kestrel, kendisi veya Internet Information Services (IIS), NGINXveya Apachegibi bir 
ters ara sunucu ile kullanılabilir. Ters proxy sunucusu, ağdan gelen HTTP isteklerini alır 
ve Kestrel 'e iletir. 

Sınır (Internet 'e yönelik) Web sunucusu olarak kullanılan Kestrel: 

Internet 

HTTP 

◄- 


Ters Proxy yapılandırmasında kullanılan Kestrel: 

HTTP 

4 - 

iki yapılandırma de, ters ara sunucu sunucusuyla veya olmadan, desteklenen bir 
barındırma yapılandırması. 

Ters proxy sunucusu olmayan bir uç sunucu olarak kullanılan Kestrel, aynı İP ve 
bağlantı noktasının birden çok işlem arasında paylaşılmasını desteklemez. Kestrel bir 
bağlantı noktasını dinlemek üzere yapılandırıldığında, Kestrel Hoşt ' den bağımsız 
olarak bu bağlantı noktası için tüm trafiği işler. Bağlantı noktalarını paylaşabilen bir 
ters proxy, istekleri benzersiz bir İP ve bağlantı noktası üzerinde Kestrel 'e iletme 
yeteneğine sahiptir. 

Ters proxy sunucusu gerekli olmasa bile, ters proxy sunucu kullanılması iyi bir seçim 
olabilir. 

Ters proxy: 

• , Barındırdığı uygulamaların açığa çıkarılan genel yüzey alanını sınırlayabilir. 

• Ek bir yapılandırma ve savunma katmanı sağlayın. 


Internet 

o. 


HTTP 


Reverse proxy server: 

IIS, Nginx, Apache 
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• , Mevcut altyapıyla daha iyi tümleşebilir. 

• Yük dengelemeyi ve güvenli iletişim (HTTPS) yapılandırmasını kolaylaştırın. 
Yalnızca ters proxy sunucusu bir X. 509.440 sertifikası gerektirir ve bu sunucu, düz 
HTTP kullanarak, iç ağdaki uygulamanın sunucularıyla iletişim kurabilir. 


VVARNING 

Ters Proxy yapılandırmasında barındırma, konak filtrelemeyigerektirir. 


ASP.NET Core uygulamalarında Kestrel kullanma 

Microsoft. AspNetCore. Server. Kestrel paketi Microsoft. Aspnetcore. app 
metapackageiçinde bulunur. 

ASP.NET Core proje şablonları varsayılan olarak Kestrel kullanır. Program.es' de, 
şablon kodu, arka planda UseKestrel çağıran CreateDefaultBuilderçağırır. 

public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build().Run(); 

} 

public static IUebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>(); 

createDefaultBuiider ve konak oluşturma hakkında daha fazla bilgi için, ASP.N ET 
Core Web ana bilgisayarı bir konak ayarlama bölümüne bakın. 

CreateDefaultBuiider çağrıldıktan sonra ek yapılandırma sağlamak için 
ConfigureKestrel kullanın: 

public static IUebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuiider(args) 

.UseStartup<Startup>() 

.ConfigureKestrel((context, serverOptions) => 

{ 

// Set properties and cali methods on serverOptions 

}); 

Uygulama, Konağı kurmak için CreateDefaultBuiider çağırmazsa, ConfigureKestrel 
çağrılmadan önce UseKestrel çağırın: 






public static void Main(string[] angs) 

{ 

var hoşt = new WebHostBuilder() 

.UseContentRoot(Directory .GetCurrentDirectoryO) 
.UseKestrel() 

.UseIISIntegration() 

.UseStartup<Startup>() 

.ConfigureKestrel((context, serverOptions) => 

{ 

// Set properties and cali methods on serverOptions 

}) 

.Build(); 

host.Run(); 

} 


Kestrel seçenekleri 

Kestrel Web sunucusu, Internet 'e yönelik dağıtımlarda özellikle yararlı olan kısıtlama 
yapılandırma seçeneklerine sahiptir. 

KestrelServerOptions sınıfının Limits özelliğindeki kısıtlamaları ayarlayın. Limits 
özelliği KestrelServerLimits sınıfının bir örneğini barındırır. 

Aşağıdaki örnekler Microsoft.AspNetCore.Server.Kestrel.Core ad alanını kullanır: 

using Microsoft.AspNetCore.Server.Kestrel.Core; 

Aşağıdaki örneklerde C# kodda yapılandırılan Kestrel seçenekleri de bir yapılandırma 
sağlayıcısı kullanılarak ayarlanabilir. Örneğin, dosya yapılandırma sağlayıcısı bir 
appSettings. JSON veya appSettings 'ten Kestrel yapılandırmasını yükleyebilir. { 
Environmerıt}. JSON dosyası: 

{ 

"Kestrel": { 

"Limits": { 

"MaxConcurrentConnections": 100, 

"MaxConcurrentUpgradedConnections": 100 

} 

} 

} 

Aşağıdaki yaklaşımlardan birini kullanın: 

• startup.configureServices 'de Kestrel yapılandırma: 

1. startup sınıfına bir ıconfiguration örneği ekleyin. Aşağıdaki örnek, 
eklenen yapılandırmanın configuration özelliğine atandığını varsayar. 

2. startup.ConfigureServices , yapılandırmanın Kestrel bölümünü Kestrel 
'in yapılandırmasına yükleyin. 












// using Microsoft.Extensions.Configuration 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<KestrelServerOptions>( 

Configuration.GetSection("Kestrel")); 

} 


• Ana bilgisayarı oluştururken Kestrel yapılandırma: 

Program.es' de, yapılandırmanın Kestrel bölümünü Kestrel yapılandırmasına 
yükleyin: 

// using Microsoft. Extensions .Dependencylnjection; 

public static IklebHostBuilder CreateWebHostBuilder(string[] args) => 
WebHost.CreateDefaultBuilder(args) 

.ConfigureServices((context, Services) => 

{ 

Services.Configure<KestrelServerOptions>( 

context.Configuration.GetSection("Kestrel")); 

}) 

.UseStartup<Startup>(); 


Yukarıdaki yaklaşımların her ikisi de herhangi bir yapılandırma sağlayıcısıylaçalışır. 

Etkin tut zaman aşımı 

KeepAliveTimeout 

Etkin tutma zaman aşımınıalır veya ayarlar. Varsayılan olarak 2 dakikadır. 

.ConfigureKestrel((context, serverOptions) => 

{ 

serverOptions.Limits.MaxConcurrentConnections = 100; 
serverOptions.Limits.MaxConcurrentUpgradedConnections = 100; 
serverOptions.Limits.MaxRequestBodySize = 10 * 1024; 
serverOptions.Limits.MinRequestBodyDataRate = 

new MinDataRate(bytesPerSecond: 100, gracePeriod: 

TimeSpan.FromSeconds(10)); 

serverOptions.Limits.MinResponseDataRate = 

new MinDataRate(bytesPerSecond: 100, gracePeriod: 
TimeSpan.FromSeconds(10)); 

serverOptions.Listen(IPAddress.Loopback, 5000); 

serverOptions.Listen(IPAddress.Loopback, 5001, listenOptions => 

{ 

listenOptions. UseFIttps ("testCert. pfx", "testPassword"); 

})J 

serverOptions.Limits.KeepAliveTimeout = TimeSpan.FromMinutes(2); 
serverOptions.Limits.RequestHeadersTimeout = TimeSpan.FromMinutes(l); 

}); 


İstemci bağlantıları üst sınırı 

MaxConcurrentConnections MaxConcurrentUpgradedConnections 

En fazla eş zamanlı açık TCP bağlantısı sayısı tüm uygulama için aşağıdaki kodla 
ayarlanabilir: 





.ConfigureKestrel((context, serverOptions) => 

{ 

serverOptions.Limits.MaxConcurrentConnections = 100; 
serverOptions.Limits.MaxConcurrentUpgradedConnections = 100; 
serverOptions.Limits.MaxRequestBodySize = 10 * 1024; 
serverOptions.Limits.MinRequestBodyDataRate = 

new MinDataRate(bytesPerSecond: 100, gracePeriod: 
TimeSpan.FromSeconds(10)); 

serverOptions.Limits.MinResponseDataRate = 

new MinDataRate(bytesPerSecond: 100, gracePeriod: 
TimeSpan.FromSeconds(10)); 

serverOptions.Listen(IPAddress.Loopback, 5000); 

serverOptions.Listen(IPAddress.Loopback, 5001, listenOptions => 

{ 

listenOptions. UseFIttps ("testCert. pfx", "testPassword"); 

}); 

serverOptions.Limits.KeepAliveTimeout = TimeSpan.FromMinutes(2); 
serverOptions.Limits.RequestHeadersTimeout = TimeSpan.FromMinutes(l); 

}); 


HTTP veya HTTPS 'den başka bir protokole (örneğin, bir VVebSockets isteğinde) 
yükseltilen bağlantılara yönelik ayrı bir sınır vardır. Bir bağlantı yükseltildikten sonra, 
MaxConcurrentconnections sınırına göre sayılmaz. 

.ConfigureKestrel((context, serverOptions) => 

{ 

serverOptions.Limits.MaxConcurrentConnections = 100; 
serverOptions.Limits.MaxConcurrentUpgradedConnections = 100; 
serverOptions.Limits.MaxRequestBodySize = 10 * 1024; 
serverOptions.Limits.MinRequestBodyDataRate = 

new MinDataRate(bytesPerSecond: 100, gracePeriod: 

TimeSpan.FromSeconds(10)); 

serverOptions.Limits.MinResponseDataRate = 

new MinDataRate(bytesPerSecond: 100, gracePeriod: 

TimeSpan.FromSeconds(10)); 

serverOptions.Listen(IPAddress.Loopback, 5000); 

serverOptions.Listen(IPAddress.Loopback, 5001, listenOptions => 

{ 

listenOptions.UseHttps("testCert.pfx", "testPassword"); 

}); 

serverOptions.Limits.KeepAliveTimeout = TimeSpan.FromMinutes(2); 
serverOptions.Limits.RequestHeadersTimeout = TimeSpan.FromMinutes(l); 

}); 


En fazla bağlantı sayısı, varsayılan olarak sınırsız (null). 

En büyük istek gövdesi boyutu 

MaxRequestBodySize 

Varsayılan en büyük istek gövdesi boyutu 30.000.000 bayttır ve bu değer yaklaşık 28,6 
MB 'tır. 

ASP.NET Core MVC uygulamasında sınırı geçersiz kılmak için önerilen yaklaşım, bir 
eylem yönteminde RequestSizeLimitAttribute özniteliğini kullanmaktır: 

[RequestSizeLimit(100000000)] 
public IActionResult MyActionMethod() 


Her istekte uygulama için kısıtlamanın nasıl yapılandırılacağını gösteren bir örnek 
aşağıda verilmiştir: 




.ConfigureKestrel((context, serverOptions) => 

{ 

serverOptions.Limits.MaxConcurrentConnections = 100; 
serverOptions.Limits.MaxConcurrentUpgradedConnections = 100; 
serverOptions.Limits.MaxRequestBodySize = 10 * 1024; 
serverOptions.Limits.MinRequestBodyDataRate = 

new MinDataRate(bytesPerSecond: 100, gracePeriod: 
TimeSpan.FromSeconds(10)); 

serverOptions.Limits.MinResponseDataRate = 

new MinDataRate(bytesPerSecond: 100, gracePeriod: 
TimeSpan.FromSeconds(10)); 

serverOptions.Listen(IPAddress.Loopback, 5000); 

serverOptions.Listen(IPAddress.Loopback, 5001, listenOptions => 

{ 

listenOptions. UseFIttps ("testCert. pfx", "testPassword"); 

}); 

serverOptions.Limits.KeepAliveTimeout = TimeSpan.FromMinutes(2); 
serverOptions.Limits.RequestHeadersTimeout = TimeSpan.FromMinutes(l); 

}); 


Ara yazılım içindeki belirli bir istek üzerindeki ayarı geçersiz kılın: 

app.Run(async (context) => 

{ 

context.Features.Get<IHttpMaxRequestBodySizeFeature>() 
.MaxRequestBodySize = 10 * 1024; 

var minRequestRateFeature = 

context.Features.Get<IHttpMinRequestBodyDataRateFeature>(); 
var minResponseRateFeature = 

context.Features.Get<IHttpMinResponseDataRateFeature>(); 

if (minRequestRateFeature != null) 

{ 

minRequestRateFeature.MinDataRate = new MinDataRate( 

bytesPerSecond: 100, gracePeriod: TimeSpan.FromSeconds(10)); 

} 

if (minResponseRateFeature != null) 

{ 

minResponseRateFeature.MinDataRate = new MinDataRate( 

bytesPerSecond: 100, gracePeriod: TimeSpan.FromSeconds(10)); 

} 


Uygulama isteği okumaya başladıktan sonra bir istek üzerindeki sınırı yapılandırırsa, 
bir özel durum oluşturulur. MaxRequestBodySize özelliğinin salt okuma durumunda 
olup olmadığını belirten isReadOniy bir özellik vardır. Bu, sınırı yapılandırmanın çok 
geç olduğunu gösterir. 

Bir uygulama ASP.NET Core modülününarkasında çalıştırıldığında , 11S sınırı zaten 
ayarladığı için Kestrel 'nin istek gövdesi boyut sınırı devre dışı bırakılır. 

En az istek gövdesi veri hızı 

MinRequestBodyDataRate MinResponseDataRate 

Kestrel bayt/saniye cinsinden belirtilen fiyata ulaşan her saniye sonra denetler. Oran en 
düşük değerin altına düşerse bağlantı zaman aşımına uğrar. Yetkisiz kullanım süresi, 
Kestrel 'in istemciye gönderme oranını en düşük süreye kadar artırabilme Bu süre 
boyunca fiyat denetlenmez. Yetkisiz kullanım süresi, TCP yavaş başlatma nedeniyle 
başlangıçta verileri yavaş bir hızda gönderen bağlantıların bırakılmasını önlemeye 
yardımcı olur. 






Varsayılan en düşük oran, 5 saniyelik bir yetkisiz kullanım süresi ile 240 bayt/saniye 
olur. 

Yanıt için bir minimum oran da geçerlidir. istek sınırını ayarlamaya yönelik kod ve yanıt 
sınırı, özellik ve arabirim adlarında RequestBody veya Response sahip olma dışında 
aynıdır. 

Program .csiçinde en düşük veri hızlarının nasıl yapılandırılacağını gösteren bir örnek 
aşağıda verilmiştir: 

.ConfigureKestrel((context, serverOptions) => 

{ 

serverOptions.Limits.MaxConcurrentConnections = 100; 
serverOptions.Limits.MaxConcurrentUpgradedConnections = 100; 
serverOptions.Limits.MaxRequestBodySize = 10 * 1024; 
serverOptions.Limits.MinRequestBodyDataRate = 

new MinDataRate(bytesPerSecond: 100, gracePeriod: 

TimeSpan.FromSeconds(10)); 

serverOptions.Limits.MinResponseDataRate = 

new MinDataRate(bytesPerSecond: 100, gracePeriod: 

TimeSpan.FromSeconds(10)); 

serverOptions.Listen(IPAddress.Loopback, 5000); 

serverOptions.Listen(IPAddress.Loopback, 5001, listenOptions => 

{ 

listenOptions.UseHttps("testCert.pfx", "testPassword"); 

})J 

serverOptions.Limits.KeepAliveTimeout = TimeSpan.FromMinutes(2); 
serverOptions.Limits.RequestHeadersTimeout = TimeSpan.FromMinutes(l); 

}); 


Ara yazılım içindeki istek başına düşen minimum hız sınırlarını geçersiz kılın: 

app.Run(async (context) => 

{ 

context.Features.Get<IHttpMaxRequestBodySizeFeature>() 

.MaxRequestBodySize = 10 * 1024; 

var minRequestRateFeature = 

context.Features.Get<IHttpMinRequestBodyDataRateFeature>(); 
var minResponseRateFeature = 

context.Features.Get<IHttpMinResponseDataRateFeature>(); 

if (minRequestRateFeature != null) 

{ 

minRequestRateFeature.MinDataRate = new MinDataRate( 

bytesPerSecond: 100, gracePeriod: TimeSpan.FromSeconds(10)); 

} 

if (minResponseRateFeature != null) 

{ 

minResponseRateFeature.MinDataRate = new MinDataRate( 

bytesPerSecond: 100, gracePeriod: TimeSpan.FromSeconds(10)); 

} 

istek çoğullama için protokol desteğinin desteklenmediği için, önceki örnekte 
başvurulan oran özelliği http/2 istekleri için HttpContext.Features , HTTP/2 için de hız 
sınırlarını değiştirmek için desteklenmez. KestreiserverOptions. Limits aracılığıyla 
yapılandırılan sunucu genelindeki hız sınırları hem HTTP/1. x hem de HTTP/2 
bağlantıları için geçerlidir. 


İstek üst bilgileri zaman aşımı 








ReguestHeadersTimeout 


Sunucunun istek üst bilgilerini alması için harcadığı en uzun süreyi alır veya ayarlar. 
Varsayılan değer 30 saniyedir. 

.ConfigureKestrel((context, serverOptions) => 

{ 

serverOptions.Limits.MaxConcurrentConnections = 100; 
serverOptions.Limits.MaxConcurrentUpgradedConnections = 100; 
serverOptions.Limits.MaxRequestBodySize = 10 * 1024; 
serverOptions.Limits.MinRequestBodyDataRate = 

new MinDataRate(bytesPerSecond: 100, gracePeriod: 

TimeSpan.FromSeconds(10)); 

serverOptions.Limits.MinResponseDataRate = 

new MinDataRate(bytesPerSecond: 100, gracePeriod: 

TimeSpan.FromSeconds(10)); 

serverOptions.Listen(IPAddress.Loopback, 5000); 

serverOptions.Listen(IPAddress.Loopback, 5001, listenOptions => 

{ 

listenOptions. UseFIttps ("testCert. pfx", "testPassword"); 

}); 

serverOptions.Limits.KeepAliveTimeout = TimeSpan.FromMinutes(2); 
serverOptions.Limits.RequestHeadersTimeout = TimeSpan.FromMinutes(l); 

}); 


Bağlantı başına en fazla akış 

Http2.MaxstreamsPerConnection , HTTP/2 bağlantısı başına eşzamanlı istek akışı sayısını 
sınırlar. Fazlalık akışlar reddedildi. 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.ConfigureKestrel((context, serverOptions) => 

{ 

serverOptions.Limits.Http2.MaxStreamsPerConnection = 100; 

})J 

Varsayılan değer 100'dür. 

Üst bilgi tablosu boyutu 

HPACK kod çözücüsü HTTP/2 bağlantıları için HTTP üstbilgilerini açar. 

Http2 . HeaderTableSize , HPACK kod çözücüsünün kullandığı üst bilgi sıkıştırma 
tablosunun boyutunu sınırlar. Değer sekizli cinsinden sağlanır ve sıfırdan büyük 
olmalıdır (0). 


public static IklebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.ConfigureKestrel((context, serverOptions) => 

{ 

serverOptions.Limits.Http2.HeaderTableSize = 4096; 

}); 

Varsayılan değer 4096 1 dir. 

En büyük çerçeve boyutu 

Http2.MaxFrameSize , alacak HTTP/2 bağlantı çerçevesi yükünün en büyük boyutunu 
belirtir. Değer sekizli cinsinden sağlanır ve 2 A 14 (16.384) ile 2 A 24-1 (16.777.215) 









arasında olmalıdır. 


public static IWebHostBuilder CreateWebFlostBuilder(string[] args) => 

WebHost.CreateOefaultBuilder(args) 

.UseStartup<Startup>() 

.ConfigureKestrel((contextj serverOptions) => 

{ 

serverOptions.Limits.Http2.MaxFrameSize = 16384; 

}); 

Varsayılan değer 2 A 14 1 dir (16.384). 

En fazla istek üst bilgi boyutu 

Http2.MaxRequestHeaderFieidSize , istek üst bilgisi değerlerinin sekizlisi cinsinden izin 
verilen en büyük boyutu gösterir. Bu sınır, hem sıkıştırılmış hem de sıkıştırılmamış 
temsillerinde birlikte hem ad hem de değer için geçerlidir. Değer sıfırdan büyük (0) 
olmalıdır. 

public static IklebHostBuilder CreateWebFlostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.ConfigureKestrel((context, serverOptions) => 

{ 

serverOptions. Limits .FIttp2.MaxRequestFleaderFieldSize = 8192; 

}); 

Varsayılan değer 8.192 1 dir. 

İlk bağlantı pencere boyutu 

Http2.initiaiconnectionwindowSize , bağlantı başına tüm istekler (akışlar) genelinde 
toplanan tek seferde sunucunun arabelleğe aldığı en fazla istek gövde verilerini bayt 
cinsinden gösterir, istekler aynı zamanda Http2.initiaistreamwindowSize ile sınırlıdır. 
Değer, 65.535 değerinden büyük veya buna eşit ve 2 A 31 (2.147.483.648) değerinden 
küçük olmalıdır. 

public static IWebHostBuilder CreateWebFlostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.ConfigureKestrel((context, serverOptions) => 

{ 

serverOptions. Limits .Flttp2. InitialConnectionWindowSize = 131072; 

}); 

Varsayılan değer 128 KB 'tır (131.072). 

İlk akış pencere boyutu 

Http2.initiaistreamwindowSize , istek (Stream) başına bir seferde sunucu 
arabelleklerinin bayt cinsinden en yüksek istek gövde verilerini gösterir, istekler aynı 
zamanda Http2.initiaistreamwindowSize ile sınırlıdır. Değer, 65.535 değerinden büyük 
veya buna eşit ve 2 A 31 (2.147.483.648) değerinden küçük olmalıdır. 









public static IklebHostBuilder CreateWebHostBuilder(string[] args) => 
WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.ConfigureKestrel((context, serverOptions) => 

{ 

serverOptions.Limits.Http2.InitialStreamWindowSize = 98304; 

}); 

Varsayılan değer 96 KB 'tır (98.304). 

Zaman uyumlu GÇ 

AllovvSynchronouslO, istek ve yanıt için zaman uyumlu GÇ 'ye izin verilip 
verilmediğini denetler. Varsayılan değer true . 


VVARNING 

Çok sayıda engelleme zaman uyumlu GÇ işlemi, iş parçacığı havuzuna neden olabilir ve bu da 
uygulamanın yanıt vermemesine neden olur. Yalnızca zaman uyumsuz GÇ desteklemeyen bir 
kitaplık kullanırken AiiowSynchronousio etkinleştirin. 


Aşağıdaki örnek, zaman uyumlu GÇ 'yi sunar: 

.ConfigureKestrel((context, serverOptions) => 

{ 

serverOptions.AllowSynchronousIO = true; 

}); 

Diğer Kestrel seçenekleri ve limitleri hakkında daha fazla bilgi için bkz.: 

• KestrelServerOptions 

• KestrelServerLimits 

• ListenOptions 

Uç nokta yapılandırması 

Varsayılan olarak, ASP.NET Core bağlar: 

• http://localhost:5000 

• https://localhost :5001 (yerel bir geliştirme sertifikası mevcut olduğunda) 
Kullanarak URL 'Leri belirtin: 

• ortam değişkeni aspnetcorejjrls . 

• --urls komut satırı bağımsız değişkeni. 

• urls ana bilgisayar yapılandırma anahtarı. 

• useuris genişletme yöntemi. 

Bu yaklaşımlar kullanılarak sağlanan değer bir veya daha fazla HTTP ve HTTPS uç 
noktası olabilir (varsayılan bir sertifika varsa HTTPS). Değeri noktalı virgülle ayrılmış 
bir liste olarak yapılandırın (örneğin, 

"Urls": "http://localhost:8000; http://localhost:8001" ). 

Bu yaklaşımlar hakkında daha fazla bilgi için sunucu URL 'leri ve geçersiz kılma 
yapılandırmasıbölümüne bakın. 









Geliştirme sertifikası oluşturuldu: 

• .NET Core SDK yüklendiği zaman. 

• Geliştirme-CERT aracı bir sertifika oluşturmak için kullanılır. 

Bazı tarayıcılarda yerel geliştirme sertifikasına güvenmek için açık izin verilmesi 
gerekir. 

Proje şablonları, uygulamaları HTTPS üzerinde varsayılan olarak çalışacak şekilde 
yapılandırır ve https yeniden yönlendirme ve HSTS desteğiiçerir. 

Kestrel için URL öneklerini ve bağlantı noktalarını yapılandırmak üzere 
KestrelServerOptions Listen veya ListenUnixSocket yöntemlerini çağırın. 

useuris , --urls komut satırı bağımsız değişkeni, urls ana bilgisayar yapılandırma 
anahtarı ve aspnetcorejjrls ortam değişkeni de çalışır, ancak bu bölümün ilerleyen 
kısımlarında belirtilen sınırlamalara sahiptir (HTTPS uç noktası yapılandırması için 
varsayılan sertifika kullanılabilir olmalıdır). 

KestrelServerOptions yapılandırması: 

ConfigureEndpointDefaults Varsayılanları (eylem<ListenOptions >) 

Belirtilen her bitiş noktası için çalıştırılacak bir yapılandırma Action belirtir. 
ConfigureEndpointDefaults birden çok kez çağrılması, önceki Action s 'in belirtilen son 
Action yerini alır. 

public static IklebHostBuilder CreateWebHostBuilder(string[] args) => 

1/debHost .CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.ConfigureKestrel((contextj serverOptions) => 

{ 

serverOptions.ConfigureEndpointDefaults(listenOptions => 

{ 

// Configure endpoint defaults 

}); 

}); 


NOTE 

Listen çağrılmadan oluşturulan bitiş noktaları, ConfigureEndpointDefaults çağrılmadan önce , 
varsayılan olarak uygulanmaz. 


ConfigureHttpsDefaults (eylemcHttpsConnectionAdapterOptions >) 


Her HTTPS uç noktası için çalıştırılacak bir yapılandırma 

Action 

belirtir. 

ConfigureHttpsDefaults 

birden çok kez çağrılması, önceki 

Action 

s 'in belirtilen son 


Action yerini alır. 









public static IUebHostBuilder CreateWebHostBuilder(string[] args) => 
WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.ConfigureKestrel((context, serverOptions) => 

{ 

serverOptions.ConfigureHttpsDefaults(listenOptions => 

{ 

// certificate is an X509Certificate2 
listenOptions.ServerCertificate = certificate; 

}); 

}); 


NOTE 

Listen çağrılmadan oluşturulan bitiş noktalan, ConfigureHttpsDefaults çağrılmadan önce , 
varsayılan olarak uygulanmaz. 

Yapılandırma (Iconation) 

Giriş olarak bir IConfiguration alan Kestrel ayarlamak için bir yapılandırma yükleyicisi 
oluşturur. Yapılandırma, Kestrel için yapılandırma bölümünün kapsamına alınmalıdır. 

ListenOptions. UseHttps 

Kestrel ’i HTTPS kullanacak şekilde yapılandırın. 

ListenOptions.UseHttps uzantıları: 

• UseHttps -varsayılan sertifikayla HTTPS kullanacak şekilde yapılandırın. 
Varsayılan sertifika yapılandırılmamışsa bir özel durum oluşturur. 

• UseHttps(string fileName) 


UseHttps(string fileName, string password) 


UseHttps(string fileName, string password, 
configureOptions) 

Action<HttpsConnectionAdapterOptions> 

UseHttps(StoreName storeName, string subject) 



UseHttps(StoreName storeName, string subject, bool allowInvalid) 


UseHttps(StoreName storeName, string subject, bool allowInvalid, 
location) 

StoreLocation 

UseHttps(StoreName storeName, string subject, bool allowInvalid, 
location, Action<HttpsConnectionAdapterOptions> configureOptions) 

StoreLocation 


UseHttps(X509Certificate2 ServerCertificate) 

UseHttps(X509Certificate2 ServerCertificate, 

Action<HttpsConnectionAdapterOptions> configureOptions) 

UseHttps(Action<HttpsConnectionAdapterOptions> configureOptions) 

ListenOptions.UseHttps parametreleri: 

filename , uygulamanın içerik dosyalarını içeren dizine göre bir sertifika dosyasının 
yolu ve dosya adıdır. 

X. 509.440 sertifika verilerine erişmek için gereken parola password . 
configureOptions , HttpsConnectionAdapterOptions yapılandırmak için Action . 
ListenOptions döndürür. 

storeName , sertifikanın yükleneceği sertifika deposudur, 
subject , sertifikanın konu adıdır. 

aiiowinvaiid , otomatik olarak imzalanan sertifikalar gibi geçersiz sertifikaların 
dikkate alınıp alınmayacağını gösterir. 











• location , sertifikanın yükleneceği mağaza konumudur. 

• serverCertificate X. 509.440 sertifikasıdır. 

Üretimde HTTPS 'nin açıkça yapılandırılması gerekir.En azından, varsayılan bir 
sertifika sağlanmalıdır. 

Daha sonra açıklanan desteklenen yapılandırma: 

• Yapılandırma yok 

• Varsayılan sertifikayı yapılandırmadan Değiştir 

• Koddaki varsayılanları değiştirme 

Yapılandırma yok 

Kestrel http://iocaihost: 500 e ve https://localhost :5001 dinler (varsayılan bir 
sertifika varsa). 

Varsayılan sertifikayı yapılandırmadan Değiştir 
Kestrel yapılandırmasını yüklemek için varsayılan olarak 

Configure(context.Configuration.GetSection("Kestrel")) CreateDefaultBuilder çağırır. 
Varsayılan bir HTTPS uygulama ayarları yapılandırma şeması Kestrel için kullanılabilir. 
Disk üzerindeki bir dosyadan ya da bir sertifika deposundan kullanılacak URL 'Ler ve 
Sertifikalar dahil olmak üzere birden çok uç nokta yapılandırın. 

Aşağıdaki appSettings. JSON örneğinde: 

• Geçersiz sertifikaların (örneğin, otomatik olarak imzalanan sertifikalar) 
kullanılmasına izin vermek için, Allovvvvınvalid öğesini true olarak ayarlayın. 

• Bir sertifika belirtmeyen herhangi bir HTTPS uç noktası (aşağıdaki örnekte 

bulunanHttpsdefaultcert), varsayılan veya geliştirme sertifikası > Sertifikalar 

altında tanımlanan sertifikaya geri döner. 







{ 

"Kestrel": { 

"Endpoints": { 

"Http": { 

"Url": "http://localhost:5000" 

L 

"HttpsInlineCertFile": { 

"Unl": "https://localhost:5001", 

"Certificate": { 

"Path": "<path to .pfx file>", 

"Passwond": "<certificate password>" 

} 

}, 

"HttpsInlineCentStore": { 

"Url": "https://localhost:5002", 

"Certificate": { 

"Subject": "<subject; required>", 

"Stone": "«ccertificate store; required>", 

"Location": "clocation; defaults to CunrentUsen >", 
"AllowInvalid": "<true on false; defaults to false>" 

} 

}, 

"HttpsDefaultCent": { 

"Url": "https://localhost:5003" 

}, 

"Https": { 

"Url": "https://*:5004", 

"Certificate": { 

"Path": "<path to .pfx file>", 

"Password": "<certificate password>" 

} 

} 

b 

"Certificates": { 

"Default": { 

"Path": "<path to .pfx file>", 

"Password": "<certificate password>" 

} 

} 

} 

} 


Herhangi bir sertifika düğümü için yol ve parola kullanmanın alternatifi sertifika 
deposu alanlarını kullanarak sertifikayı belirtmektir. Örneğin, sertifikalar > 
varsayılan sertifika şöyle belirlenebilir: 

"Default": { 

"Subject": "<subject; required>", 

"Store": "ccert store; required>"j 

"Location": "«clocation; defaults to CurrentUser >", 

"AllowInvalid": "<true or false; defaults to false>" 

} 


Şema notları: 

• Uç nokta adları büyük/küçük harfe duyarlıdır.Örneğin, https ve Https geçerlidir. 

• Her uç nokta için url parametresi gereklidir. Bu parametrenin biçimi, en üst düzey 
urls yapılandırma parametresiyle aynıdır, ancak tek bir değerle sınırlı olur. 







• Bu uç noktalar, üst düzey urls yapılandırmasında tanımlananlara eklemek yerine 
bunların yerini alır. Listen aracılığıyla kodda tanımlanan uç noktalar yapılandırma 
bölümünde tanımlanan uç noktalar ile birikimlidir. 

• Certificate bölümü isteğe bağlıdır. Certificate bölümü belirtilmemişse, önceki 
senaryolarda tanımlanan varsayılanlar kullanılır. Kullanılabilir varsayılan değer 
yoksa, sunucu bir özel durum oluşturur ve başlayamaz. 

• Certificate bölümü, hem yol-parolasını hem de Konu-Mağaza sertifikalarını 
destekler. 

• Herhangi bir sayıda uç nokta, bağlantı noktası çakışmalarına neden olmadıkları 
sürece bu şekilde tanımlanabilir. 

• options.Configure(context.Configuration.GetSection("{SECTION}")) , yapılandırılmış 

bir uç noktanın ayarlarını tamamlamak için kullanılabilecek 
.Endpoint(string name, listenOptions => { }) yöntemi ile bir 
KestrelConfigurationLoader döndürür: 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.UseKestrel((context, serverOptions) => 

{ 

serverOptions.Configure(context.Configuration.GetSection("Kestrel")) 

.Endpoint("HTTPS", listenOptions => 

{ 

listenOptions.HttpsOptions.SslProtocols = SslProtocols.Tlsl2; 

}); 

})j 

KestreiServerOptions.ConfigurationLoader , CreateDefaultBuildertarafından sağlana 
gibi var olan yükleyicisindeki yinelenmeye devam etmek için doğrudan erişilebilir. 

• Her uç noktanın yapılandırma bölümü, özel ayarların okunabilmesi için Endpoint 
yöntemindeki seçeneklerde kullanılabilir. 

• options.Configure(context.Configuration.GetSection("{SECTION}")) başka bir 
bölümle yeniden çağırarak birden çok yapılandırma yüklenebilir. Load önceki 
örneklerde açıkça çağrılmamışsa yalnızca son yapılandırma kullanılır. Metapackage, 
varsayılan yapılandırma bölümünün değiştirilebilmesi için Load çağırmaz. 

• KestrelConfigurationLoader , API 'lerin Listen ailesini KestreiServerOptions 
Endpoint aşırı yükleme olarak yansıtır, bu nedenle kod ve yapılandırma uç 

noktaları aynı yerde yapılandırılabilir. Bu aşırı yüklemeler adları kullanmaz ve 
yalnızca yapılandırmadan varsayılan ayarları kullanır. 

Koddaki varsayılanları değiştirme 

configureEndpointDefaults ve configureHttpsDefaults , önceki senaryoda belirtilen 
varsayılan sertifikayı geçersiz kılma da dahil olmak üzere ListenOptions ve 
HttpsConnectionAdapterOptions için varsayılan ayarları değiştirmek üzere kullanılabilir. 
ConfigureEndpointDefaults ve ConfigureHttpsDefaults herhangi bir UÇ nokta 
yapılandırılmadan önce çağrılmalıdır. 


















public static IklebHostBuilder CreateWebHostBuilder(str'ing[] args) => 

WebHost.CreateOefaultBuilder(args) 

.UseStartup<Startup>() 

.UseKestnel((contextj serverOptions) => 

{ 

serverOptions.ConfigureEndpointDefaults(listenOptions => 

{ 

// Configure endpoint defaults 

}); 

serverOptions.ConfigureHttpsDefaults(listenOptions => 

{ 

listenOptions.SslProtocols = SslProtocols.TİSİ2; 

}); 

}); 

SNı için Kestrel desteği 

Sunucu adı belirtme (SNı) , aynı İP adresi ve bağlantı noktası üzerinde birden fazla etki 
alanını barındırmak için kullanılabilir. SNı ’nin çalışması için, istemci, TLS el sıkışması 
sırasında güvenli oturum ana bilgisayar adını, sunucunun doğru sertifikayı 
sağlayabilmesi için gönderir, istemci, TLS anlaşmasını izleyen güvenli oturum sırasında 
sunucuyla şifreli iletişim için bulunan sertifikayı kullanır. 

Kestrel serverCertificateSelector geri çağırma aracılığıyla SNı destekler.Geri 
çağırma, uygulamanın ana bilgisayar adını incelemesine ve uygun sertifikayı seçmesini 
sağlamak için bağlantı başına bir kez çağrılır. 

SNı desteği şunları gerektirir: 

• Hedef Framevvork netcoreapp2.ı veya sonraki sürümlerde çalışıyor. net46i veya 
sonraki sürümlerde, geri çağırma çağrılır, ancak name her zaman nuiı . Ayrıca, 
istemci, TLS el sıkışmasının ana bilgisayar adı parametresini sağlamıyorsa da nuiı 

name . 

• Tüm Web siteleri aynı Kestrel örneğinde çalışır.Kestrel, bir İP adresi ve bağlantı 
noktasının bir ters proxy olmadan birden çok örnek arasında paylaşılmasını 
desteklemez. 










public static IklebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.ConfigureKestrel((context, serverOptions) => 

{ 

serverOptions.ListenAnyIP(5005, listenOptions => 

{ 

listenOptions.UseHttps(httpsOptions => 

{ 

var localhostCert = CertificateLoader.LoadFromStoreCert( 
"localhost", "My", StoreLocation.CurrentUser, 
allowInvalid: true); 

var exampleCert = CertificateLoader.LoadFromStoreCert( 
"example.com", "My", StoreLocation.CurrentUser, 
allowInvalid: true); 

var subExampleCert = CertificateLoader.LoadFromStoreCert( 
"sub.example.com", "My", StoreLocation.CurrentUser, 
allowInvalid: true); 

var certs = new Dictionary<string, X509Certificate2>( 
StringComparer.OrdinalIgnoreCase); 
certs["localhost"] = localhostCert; 
certs ["example.com"] = exampleCert; 
certs["sub. example.com"] = subExampleCert; 

httpsOptions.ServerCertificateSelector = (connectionContext, 

name) => 

{ 

if (name != null && certs.TryGetValue(name, out var cert)) 

{ 

return cert; 

} 

return exampleCert; 

}J 

}); 

}); 

}); 


Bağlantı günlüğü 

Bir bağlantıda bayt düzeyinde iletişim için hata ayıklama düzeyi günlüklerini yayma 
UseConnectionLogging çağırın. Bağlantı günlüğü, TLS şifreleme ve proxy ’nin 
arkasındaki gibi alt düzey iletişimde sorunları gidermeye yardımcı olur. 
UseConnectionLogging useHttps önce yerleştirilmişse, şifrelenmiş trafik günlüğe 
kaydedilir. UseConnectionLogging UseHttps sonra yerleştirilmişse, şifresi çözülmüş 
trafik günlüğe kaydedilir. 

webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.Listen(IPAddress.Any, 8000, listenOptions => 

{ 

listenOptions.UseConnectionLogging(); 

}); 

}); 

TCP yuvasına bağlama 

Listen yöntemi bir TCP yuvasına bağlanır ve bir seçenek lambda X. 509.440 sertifika 
yapılandırmasına izin verir: 



public static void Main(string[] angs) 

{ 

CreateWebHostBuilder(args).Build().Run(); 

} 

public static IklebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.ConfigureKestrel((context, serverOptions) => 

{ 

serverOptions.Listen(IPAddress.Loopback, 5000); 

serverOptions.Listen(IPAddress.Loopback, 5001, listenOptions => 

{ 

listenOptions.UseHttps("testCert.pfx", "testPassword"); 

}); 

}); 

Örnek, ListenOptionsolan bir uç nokta için HTTPS 'yi yapılandırır. Belirli uç noktalar 
için diğer Kestrel ayarlarını yapılandırmak üzere aynı API 'yi kullanın. 

Windows üzerinde otomatik olarak imzalanan sertifikalar kullanılarak oluşturulabilir 
Nevv-SelfSignedCertificate PovverShell cmdlet'i. Desteklenmeyen bir örnek için bkz 
U pdatel IS ExpressS S L ForC hrome.ps 1 . 

MacOS, Linux ve Windows, sertifikalar kullanılarak oluşturulabilir OpenSSL. 

UNIX yuvasına bağlama 

Aşağıdaki örnekte gösterildiği gibi NGINX ile daha iyi performans için 
ListenllnixSocket bir UNIX yuvası dinleyin: 

.ConfigureKestrel((context, serverOptions) => 

{ 

serverOptions.ListenUnixSocket("/tmp/kestrel-test.sock"); 

serverOptions.ListenUnixSocket("/tmp/kestrel-test.sock", listenOptions => 

{ 

listenOptions.UseHttps("testCert.pfx", "testpassword"); 

}); 

}); 

Bağlantı noktası 0 

0 bağlantı noktası numarası belirtildiğinde, Kestrel dinamik olarak kullanılabilir bir 
bağlantı noktasına bağlanır. Aşağıdaki örnek, çalışma zamanında Kestrel gerçekte 
hangi bağlantı noktasının gerçekten bağlandığını nasıl belirleyeceğini göstermektedir 




public void Configure(IApplicationBuilder app) 

{ 

var serverAddressesFeature = 

app.ServerFeatures.Get<IServerAddressesFeature>(); 

app.UseStaticFiles(); 

app.Run(async (context) => 

{ 

context.Response.ContentType = "text/html"; 
await context.Response 

.WriteAsync("< IDOCTYPE htmlxhtml lang=\"en\"xhead>" + 

"<titlex/titlex/headxbodyxp>Flosted by Kestrel</p>"); 

if (serverAddressesFeature != null) 

{ 

await context.Response 

.WriteAsync("<p>Listening on the following addresses: " + 
string.Doin("j ", serverAddressesFeature.Addresses) + 

"</p>"); 

} 

await context.Response.WriteAsync("<p>Request URL: " + 
$"{context.Request.GetDisplayUrl()}<p>"); 

}); 

} 

Uygulama çalıştırıldığında konsol penceresi çıkışı, uygulamanın erişilebileceği dinamik 
bağlantı noktasını gösterir: 

Listening on the following addresses: http://127.0.0.1:48508 

Sınırlamalar 

Aşağıdaki yaklaşımlar ile uç noktaları yapılandırın: 

• UseUrls 

• --urls komut satırı bağımsız değişkeni 

• urls ana bilgisayar yapılandırma anahtarı 

• aspnetcore_urls ortam değişkeni 

Bu yöntemler, kodun Kestrel dışındaki sunucularla çalışmasını sağlamak için yararlıdır. 
Ancak, aşağıdaki sınırlamalara dikkat edin: 

• HTTPS uç noktası yapılandırmasında varsayılan bir sertifika sağlanmadığı sürece 
(örneğin, bu konuda daha önce gösterildiği gibi KestreiserverOptions 
yapılandırması veya yapılandırma dosyası kullanılarak), HTTPS bu yaklaşımlar ile 
kullanılamaz. 


Listen 

ve 

UseUrls 

yaklaşımlarının her ikisi de aynı anda kullanıldığında 

Listen 

uç noktaları 

UseUrls 

uç noktaları geçersiz kılar. 


IIS uç nokta yapılandırması 

IIS kullanırken, IIS geçersiz kılma bağlamaları için URL bağlamaları Listen veya 
useuris tarafından ayarlanır. Daha fazla bilgi için ASP.NET Core modülü konusuna 
bakın. 

ListenOptions. Protocols 

Protocols özelliği, bir bağlantı uç noktasında veya sunucu için etkin HTTP 












protokollerini ( HttpProtocols ) belirler. HttpProtocols numaralandırmasından 
Protocols özelliğine bir değer atayın. 

HTTPPROTOCOLS ENUM DEĞERİ BAĞLANTI PROTOKOLÜ İZİN VERİLDİ 

Httpi Yalnızca HTTP/1.1., TLS olmadan veya ile 

kullanılabilir. 


Http 2 Yalnızca HTTP/2. Yalnızca istemci önceki bir 

bilgi modunuDESTEKLIYORSA, TLS olmadan 
kullanılabilir. 


HttplAndHttp 2 HTTP/1 .1 ve HTTP/2. HTTP/2 bir TLS ve 

uygulama katmanı protokol anlaşması (ALPN) 
bağlantısı gerektirir; Aksi takdirde, bağlantı 
varsayılan olarak HTTP/1.1 ' dir. 


Varsayılan protokol HTTP/1.1 ' dir. 

HTTP/2 için TLS kısıtlamaları: 

• TLS sürüm 1,2 veya üzeri 

• Yeniden anlaşma devre dışı 

• Sıkıştırma devre dışı 

• En az kısa ömürlü anahtar değişim boyutları: 

o Eliptik Eğri Diffie-Hellman (ECDHE) [RFC4492] - 224 bit minimum 
o Sınırlı alan Diffie-Hellman (DHE) [ tlsi 2 ] - 2048 bit minimum 

• Şifre paketi kara listede değil 

TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 [] TLS-ECDHE , P"256 eliptik eğrisi [ FIPS186 ] 
varsayılan olarak desteklenir. 

Aşağıdaki örnek, 8000 numaralı bağlantı noktasında HTTP/1.1 ve HTTP/2 
bağlantılarına izin verir. Bağlantılar, sağlanan bir sertifikayla TLS ile güvenlidir: 

.ConfigureKestrel((context, serverOptions) => 

{ 

serverOptions.Listen(IPAddress.Any, 8000, listenOptions => 

{ 

listenOptions.Protocols = HttpProtocols.HttplAndHttp2; 
listenOptions.UseHttps("testCert.pfx", "testPassword"); 

})J 

}); 

İsteğe bağlı olarak, belirli şifrelemeler için bağlantı başına TLS el sıkışmaları 
filtrelemek üzere ıconnectionAdapter bir uygulama oluşturun: 

.ConfigureKestrel((context, serverOptions) => 

{ 

serverOptions.Listen(IPAddress.Any, 8000, listenOptions => 

{ 

listenOptions.Protocols = HttpProtocols.HttplAndHttp2; 
listenOptions.UseHttps("testCert.pfx", "testPassword"); 
listenOptions.ConnectionAdapters.Add(new TlsFilterAdapter()); 

}); 

})j 











private class TlsFilterAdapter : IConnectionAdapter 

{ 

public bool IsHttps => false; 

public Task<IAdaptedConnection> OnConnectionAsync(ConnectionAdapterContext 
context) 

{ 

var tlsFeature = context.Features.Get<ITlsHandshakeFeature>(); 

// Throw NotSupportedException for any cipher algorithm that the app 

doesn't 

// wish to support. Alternatively, define and compare 
// ITlsFIandshakeFeatjre.CipherAlgorithrn to a üst of acceptable cipher 
// suites. 

// 

// No encryption is used with a CipherAlgorithmType.Null cipher algorithm. 
if (tlsFeature.CipherAlgorithm == CipherAlgorithmType.Null) 

{ 

throw new NotSupportedException("Prohibited cipher: " + 
tlsFeature.CipherAlgorithm); 

} 

return Task.FromResult<IAdaptedConnection>(new 
AdaptedConnection(context.ConnectionStream)); 

} 

private class AdaptedConnection : IAdaptedConnection 

{ 

public AdaptedConnection(Stream adaptedStream) 

{ 

ConnectionStream = adaptedStream; 

} 

public Stream ConnectionStream { get; } 

public void Dispose() 

{ 

} 

} 

} 


Protokolü yapdandırmadarı ayarla 

Kestrel yapılandırmasını yüklemek için varsayılan olarak 
serverOptions.Configure(context.Configuration.GetSection("Kestrel")) 
CreateDefaultBuilder çağırır. 

Aşağıdaki appSettings. JSON örneğinde, tüm Kestrel uç noktaları için varsayılan bir 
bağlantı protokolü (http/1.1 ve http/2) oluşturulur: 

{ 

"Kestrel": { 

"EndpointDefaults": { 

"Protocols": "HttplAndHttp2" 

} 

} 

} 


Aşağıdaki yapılandırma dosyası örneği, belirli bir uç nokta için bağlantı protokolü 
oluşturur: 





{ 

"Kestrel": { 

"Endpoints": { 

"HttpsDefaultCert": { 

"Url": "https://localhost:5001", 
"Protocols": "HttplAndHttp2" 

} 

} 

} 

} 


Yapılandırma tarafından ayarlanan kod geçersiz kılma değerlerinde belirtilen 
protokoller. 

Aktarım yapılandırması 

AS P.N ET Core 2,1 sürümü ile Kestrel 'in varsayılan taşıması artık libuv 1 d i temel 
değildir ancak bunun yerine yönetilen yuvaları temel alır. Bu, UseLibuv çağıran ve 
aşağıdaki paketlerden birine bağlı olan 2,1 1 ye yükselten AS P.N ET Core 2,0 
uygulamaları için bir son değişiklik değildir: 

• Microsoft. AspNetCore. Server. Kestrel (doğrudan paket başvurusu) 

• Microsoft. AspNetCore. app 

Libuv kullanımını gerektiren projeler için: 

• Uygulamanın proje dosyasına Microsoft. AspNetCore. Server. Kestrel. 
Transport. libuv paketi için bir bağımlılık ekleyin: 

<PackageReference 

Include="Microsoft.AspNetCore.Server.Kestrel.T ransport.Libuv" 
Version="{VERSION}" /> 


• UseLibuvçağrısı: 

public class Program 
{ 

public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build().Run(); 

} 

public static IklebHostBuilder CreateWebHostBuilder(string[] args) => 
WebHost.CreateDefaultBuilder(args) 

.UseLibuv() 

.UseStartup<Startup>(); 

} 


URL önekleri 

useuris , --urls komut satırı bağımsız değişkenini, urls ana bilgisayar 
yapılandırma anahtarını veya aspnetcore_urls ortam değişkenini kullanırken, URL 
önekleri aşağıdaki biçimlerden birinde olabilir. 

Yalnızca HTTP URL ön ekleri geçerlidir.Kestrel, useuris kullanılarak URL bağlamaları 
yapılandırırken HTTPS 'Yİ desteklemez. 

• Bağlantı noktası numarası olan IPv4 adresi 









http://65.55. 39.10:80/ 

id.id.id.^ , tüm IPv4 adreslerine bağlanan özel bir durumdur. 

• Bağlantı noktası numarasına sahip IPv6 adresi 

http://[0:0:0:0:0:ffff:4137:270a]:80/ 

[::] , IPv4 0 . 0 . 0.0 IPv6 eşdeğeridir. 

• Bağlantı noktası numarası olan ana bilgisayar adı 

http://contoso.com:80/ 
http://*:80/ 

Ana bilgisayar adları, * ve + özel değildir. Geçerli bir İP adresi olarak 
tanınmayan bir şey veya localhost tüm IPv4 ve IPv6 İP 'lerine bağlanır.Farklı 
ana bilgisayar adlarını aynı bağlantı noktasında farklı ASP.NET Core 
uygulamalarına bağlamak için, http. sys veya 11S, NGINX veya Apache gibi bir 
ters proxy sunucusu kullanın. 
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• Port numarası veya bağlantı noktası numarası ile geri döngü İP 'si localhost 
ana bilgisayar adı 

http://localhost:5000/ 
http://127.0.0.1:5000/ 
http://[::1]:5000/ 

localhost belirtildiğinde, Kestrel hem IPv4 hem de IPv6 geri döngü 
arabirimlerini bağlamaya çalışır, istenen bağlantı noktası, herhangi bir geri 
döngü arabiriminde başka bir hizmet tarafından kullanılıyorsa, Kestrel 
başlatılamaz. Herhangi bir geri döngü arabirimi başka bir nedenle 
kullanılamıyorsa (genellikle IPv6 desteklenmediği için), Kestrel bir uyarı 
kaydeder. 

Konak filtreleme 

Kestrel, http://exampie.com : 5000 gibi önekleri temel alarak yapılandırmayı desteklese 
de, büyük ölçüde ana bilgisayar adını yoksayar. Ana bilgisayar localhost , geri döngü 
adreslerine bağlama için kullanılan özel bir durumdur. Açık İP adresi dışındaki tüm ana 
bilgisayar tüm genel İP adreslerine bağlanır. Hoşt üstbilgileri doğrulanmadı. 

Geçici bir çözüm olarak, ana bilgisayar filtreleme ara yazılımı kullanın. Ana bilgisayar 
filtreleme ara yazılımı, Microsoft, aspnetcore. app metapackage (ASP.NET Core 2,1 
veya 2,2)' de yer alan Microsoft. Aspnetcore. hostfiltering paketi tarafından sağlanır. 
Ara yazılım, AddHostFilteringçağıran CreateDefaultBuildertarafından eklenir: 









public class Program 
{ 

public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build().Run(); 

} 


} 


public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 
WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>(); 


Ana bilgisayar filtreleme ara yazılımı varsayılan olarak devre dışıdır.Ara yazılımı 
etkinleştirmek için appSettings.json/appSettings içinde bir AiiowedHosts anahtarı 
tanımlayın ,<environmentname >. JSON. Değer, bağlantı noktası numaraları olmayan 
ana bilgisayar adlarının noktalı virgülle ayrılmış listesidir: 


appSettings. JSON: 

{ 

"AllowedHosts": "example.com; localhost" 

} 


NOTE 

İletilen üstbilgiler ara yazılımı ayrıca bir AllovvedHosts seçeneği de vardır, iletilen üstbilgiler ara 
yazılımı ve ana bilgisayar filtreleme ara yazılımı, farklı senaryolar için benzer işlevlere sahiptir. 
İletilen üst bilgi ara sunucusu ile AilowedHosts ayarlama, istekleri bir ters ara sunucu veya 
yük dengeleyici ile iletirken, Hoşt üst bilgisi korunurken uygun olur. Kestrel genel kullanıma 
açık bir uç sunucu olarak veya Hoşt üstbilgisi doğrudan iletildiğinde, ana bilgisayar 
filtreleme ara yazılımı ile AilowedHosts ayarlama uygundur. 

İletilen üstbilgiler ara yazılımı hakkında daha fazla bilgi için bkz. Proxy sunucularıyla ve yük 
dengeleyicilerle çalışacak ASP.NET Core yapılandırma. 


Kestrel, ASP.NET Core için platformlar arası Web sunucusudur. Kestrel, ASP.NET Core 
proje şablonlarında varsayılan olarak bulunan Web sunucusudur. 

Kestrel aşağıdaki senaryoları destekler: 

• HTTPS 

• VVebSockets 'i etkinleştirmek için kullanılan donuk yükseltme 

• NGINX 'in arkasında yüksek performans için UNIX Yuvaları 

Kestrel, .NET Core 'un desteklediği tüm platformlarda ve sürümlerde desteklenir. 
Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Ters ara sunucu ile Kestrel ne zaman kullanılır? 

Kestrel, kendisi veya Internet Information Services (IIS), NGINXveya Apachegibi bir 
ters ara sunucu ile kullanılabilir. Ters proxy sunucusu, ağdan gelen HTTP isteklerini alır 
ve Kestrel 'e iletir. 

Sınır (Internet 'e yönelik) Web sunucusu olarak kullanılan Kestrel: 






Internet 

HTTP 

◄- 


Ters Proxy yapılandırmasında kullanılan Kestrel: 

HTTP 

4 - 

iki yapılandırma de, ters ara sunucu sunucusuyla veya olmadan, desteklenen bir 
barındırma yapılandırması. 

Ters proxy sunucusu olmayan bir uç sunucu olarak kullanılan Kestrel, aynı İP ve 
bağlantı noktasının birden çok işlem arasında paylaşılmasını desteklemez. Kestrel bir 
bağlantı noktasını dinlemek üzere yapılandırıldığında, Kestrel Hoşt ' den bağımsız 
olarak bu bağlantı noktası için tüm trafiği işler. Bağlantı noktalarını paylaşabilen bir 
ters proxy, istekleri benzersiz bir İP ve bağlantı noktası üzerinde Kestrel 'e iletme 
yeteneğine sahiptir. 

Ters proxy sunucusu gerekli olmasa bile, ters proxy sunucu kullanılması iyi bir seçim 
olabilir. 

Ters proxy: 

• , Barındırdığı uygulamaların açığa çıkarılan genel yüzey alanını sınırlayabilir. 

• Ek bir yapılandırma ve savunma katmanı sağlayın. 

• , Mevcut altyapıyla daha iyi tümleşebilir. 

• Yük dengelemeyi ve güvenli iletişim (HTTPS) yapılandırmasını kolaylaştırın. 
Yalnızca ters proxy sunucusu bir X. 509.440 sertifikası gerektirir ve bu sunucu, düz 
HTTP kullanarak, iç ağdaki uygulamanın sunucularıyla iletişim kurabilir. 
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ASP.NET Core uygulamalarında Kestrel kullanma 

Microsoft. AspNetCore. Server. Kestrel paketi Microsoft. Aspnetcore. app 
metapackageiçinde bulunur. 

ASP.NET Core proje şablonları varsayılan olarak Kestrel kullanır. Program.es' de, 
şablon kodu, arka planda UseKestrel çağıran CreateDefaultBuilderçağırır. 

createDefaultBuiider çağrıldıktan sonra ek yapılandırma sağlamak için, 

UseKestrelçağırın: 

public static IklebHostBuilder Createl/JebHostBuildertstringf] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.UseKestrel(serverOptions => 

{ 

// Set properties and cali methods on senverOptlons 

}); 















createDefaultBuiider ve konak oluşturma hakkında daha fazla bilgi için, ASP.N ET 
Core Web ana bilgisayarıdır konak ayarlama bölümüne bakın. 

Kestrel seçenekleri 

Kestrel Web sunucusu, Internet 'e yönelik dağıtımlarda özellikle yararlı olan kısıtlama 
yapılandırma seçeneklerine sahiptir. 

KestrelServerOptions sınıfının Limits özelliğindeki kısıtlamaları ayarlayın. Limits 
özelliği KestrelServerLimits sınıfının bir örneğini barındırır. 

Aşağıdaki örnekler Microsoft.AspNetCore.Server.Kestrel.Core ad alanını kullanır: 

using Microsoft.AspNetCore.Server.Kestrel.Core; 

Aşağıdaki örneklerde C# kodda yapılandırılan Kestrel seçenekleri de bir yapılandırma 
sağlayıcısıkullanılarak ayarlanabilir. Örneğin, dosya yapılandırma sağlayıcısı bir 
appSettings. JSON veya appSettings 'ten Kestrel yapılandırmasını yükleyebilir. { 
Environment}. JSON dosyası: 

{ 

"Kestrel": { 

"Limits": { 

"MaxConcurrentConnections": 100, 

"MaxConcurrentUpgradedConnections": 100 

} 

} 

} 

Aşağıdaki yaklaşımlardan birini kullanın: 

• startup.configureServices 'de Kestrel yapılandırma: 

1. startup sınıfına bir ıconfiguration örneği ekleyin. Aşağıdaki örnek, 
eklenen yapılandırmanın configuration özelliğine atandığını varsayar. 

2. Startup.configureServices , yapılandırmanın Kestrel bölümünü Kestrel 
'in yapılandırmasına yükleyin. 

// using Microsoft.Extensions.Configuration 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<KestrelServerOptions>( 

Configuration.GetSection("Kestrel")); 

} 

• Ana bilgisayarı oluştururken Kestrel yapılandırma: 

Program.es' de, yapılandırmanın Kestrel bölümünü Kestrel yapılandırmasına 
yükleyin: 













// using Microsoft.Extensions.Dependencylnjection; 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 
1/JebHost .CreateDefaultBuilder(args) 

.ConfigureServices((context, Services) => 

{ 

Services.Configure<KestrelServerOptions>( 

context.Configuration.GetSection("Kestrel")); 

}) 

.UseStartup<Startup>(); 


Yukarıdaki yaklaşımların her ikisi de herhangi bir yapılandırma sağlayıcısıy laçalışır. 

Etkin tut zaman aşımı 

KeepAiiveTimeout 

Etkin tutma zaman aşımınıalır veya ayarlar. Varsayılan olarak 2 dakikadır. 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.UseKestrel(serverOptions => 

{ 

serverOptions.Limits.KeepAiiveTimeout = TimeSpan.FromMinutes(2); 

}); 


İstemci bağlantıları üst sınırı 

MaxConcurrentConnections MaxConcurrentUpgradedConnections 

En fazla eş zamanlı açık TCP bağlantısı sayısı tüm uygulama için aşağıdaki kodla 
ayarlanabilir: 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.UseKestrel(serverOptions => 

{ 

serverOptions.Limits.MaxConcurrentConnections = 100; 

}); 


HTTP veya HTTPS 'den başka bir protokole (örneğin, bir VVebSockets isteğinde) 
yükseltilen bağlantılara yönelik ayrı bir sınır vardır. Bir bağlantı yükseltildikten sonra, 
MaxConcurrentconnections sınırına göre sayılmaz. 

public static IUebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateOefaultBuilder(args) 

.UseStartup<Startup>() 

.UseKestrel(serverOptions => 

{ 

serverOptions.Limits.MaxConcurrentUpgradedConnections = 100; 

}); 


En fazla bağlantı sayısı, varsayılan olarak sınırsız (null). 

En büyük istek gövdesi boyutu 

MaxRequestBodySize 


Varsayılan en büyük istek gövdesi boyutu 30.000.000 bayttır ve bu değer yaklaşık 28,6 





MB 'tır. 


ASP.NET Core MVC uygulamasında sınırı geçersiz kılmak için önerilen yaklaşım, bir 
eylem yönteminde RequestSizeLimitAttribute özniteliğini kullanmaktır: 

[RequestSizeLimit(100000000)] 
public IActionResult MyActionMethod() 


Her istekte uygulama için kısıtlamanın nasıl yapılandırılacağını gösteren bir örnek 
aşağıda verilmiştir: 

public static IklebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.UseKestrel(serverOptions => 

{ 

serverOptions.Limits.MaxRequestBodySize = 10 * 1024; 

}); 


Ara yazılım içindeki belirli bir istek üzerindeki ayarı geçersiz kılın: 

app.Run(async (context) => 

{ 

context.Features.Get<IHttpMaxRequestBodySizeFeature>() 
.MaxRequestBodySize = 10 * 1024; 

var minRequestRateFeature = 

context.Features.Get<IHttpMinRequestBodyOataRateFeature>(); 
var minResponseRateFeature = 

context.Features.Get<IHttpMinResponseDataRateFeature>(); 

if (minRequestRateFeature != null) 

{ 

minRequestRateFeature.MinDataRate = new MinDataRate( 

bytesPerSecond: 100, gracePeriod: TimeSpan.FromSeconds(10)); 

} 

if (minResponseRateFeature != null) 

{ 

minResponseRateFeature.MinDataRate = new MinDataRate( 

bytesPerSecond: 100, gracePeriod: TimeSpan.FromSeconds(10)); 

} 


Uygulama isteği okumaya başladıktan sonra bir istek üzerindeki sınırı yapılandırırsa, 
bir özel durum oluşturulur. MaxRequestBodySize özelliğinin salt okuma durumunda 
olup olmadığını belirten isReadOniy bir özellik vardır. Bu, sınırı yapılandırmanın çok 
geç olduğunu gösterir. 

Bir uygulama ASP.NET Core modülününarkasında çalıştırıldığında , 11S sınırı zaten 
ayarladığı için Kestrel ’nin istek gövdesi boyut sınırı devre dışı bırakılır. 

En az istek gövdesi veri hızı 

MinRequestBodyDataRate MinResponseDataRate 

Kestrel bayt/saniye cinsinden belirtilen fiyata ulaşan her saniye sonra denetler. Oran en 
düşük değerin altına düşerse bağlantı zaman aşımına uğrar. Yetkisiz kullanım süresi, 
Kestrel 'in istemciye gönderme oranını en düşük süreye kadar artırabilme Bu süre 
boyunca fiyat denetlenmez. Yetkisiz kullanım süresi, TCP yavaş başlatma nedeniyle 
başlangıçta verileri yavaş bir hızda gönderen bağlantıların bırakılmasını önlemeye 







yardımcı olur. 

Varsayılan en düşük oran, 5 saniyelik bir yetkisiz kullanım süresi ile 240 bayt/saniye 
olur. 

Yanıt için bir minimum oran da geçerlidir. istek sınırını ayarlamaya yönelik kod ve yanıt 
sınırı, özellik ve arabirim adlarında RequestBody veya Response sahip olma dışında 
aynıdır. 

Program .csiçinde en düşük veri hızlarının nasıl yapılandırılacağını gösteren bir örnek 
aşağıda verilmiştir: 

public static IklebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.UseKestrel(serverOptions => 

{ 

serverOptions.Limits.MinRequestBodyDataRate = 

new MinDataRate(bytesPerSecond: 100, gracePeriod: 

TimeSpan.FromSeconds(10)); 

serverOptions.Limits.MinResponseDataRate = 

new MinDataRate(bytesPerSecond: 100, gracePeriod: 

TimeSpan.FromSeconds(10)); 

}); 


İstek üst bilgileri zaman aşımı 

RequestHeadersTimeout 

Sunucunun istek üst bilgilerini alması için harcadığı en uzun süreyi alır veya ayarlar. 
Varsayılan değer 30 saniyedir. 

public static IklebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.UseKestrel(serverOptions => 

{ 

serverOptions.Limits.RequestHeadersTimeout = TimeSpan.FromMinutes(l); 

}); 


Zaman uyumlu GÇ 

AllovvSynchronouslO, istek ve yanıt için zaman uyumlu GÇ 'ye izin verilip 
verilmediğini denetler. Varsayılan değer true . 


VVARNING 

Çok sayıda engelleme zaman uyumlu GÇ işlemi, iş parçacığı havuzuna neden olabilir ve bu da 
uygulamanın yanıt vermemesine neden olur. Yalnızca zaman uyumsuz GÇ desteklemeyen bir 
kitaplık kullanırken AllowSynchronousio etkinleştirin. 


Aşağıdaki örnek, zaman uyumlu GÇ 'yi devre dışı bırakır: 






public static IklebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateOefaultBuilder(args) 

.UseStartup<Startup>() 

.UseKestrel(serverOptions => 

{ 

serverOptions.AllowSynchronousIO = false; 

}); 

Diğer Kestrel seçenekleri ve limitleri hakkında daha fazla bilgi için bkz.: 

• KestrelServerOptions 

• KestrelServerLimits 

• ListenOptions 

Uç nokta yapılandırması 

Varsayılan olarak, ASP.NET Core bağlar: 

• http://localhost:5000 

• https: //localhost : 5001 (yerel bir geliştirme sertifikası mevcut olduğunda) 
Kullanarak URL ’Leri belirtin: 

• ortam değişkeni aspnetcorejjrls . 

• --urls komut satırı bağımsız değişkeni. 

• urls ana bilgisayar yapılandırma anahtarı. 

• useiiris genişletme yöntemi. 

Bu yaklaşımlar kullanılarak sağlanan değer bir veya daha fazla HTTP ve HTTPS uç 
noktası olabilir (varsayılan bir sertifika varsa HTTPS). Değeri noktalı virgülle ayrılmış 
bir liste olarak yapılandırın (örneğin, 

"Urls": "http://localhost:8000j http://localhost:8001" ). 

Bu yaklaşımlar hakkında daha fazla bilgi için sunucu URL Teri ve geçersiz kılma 
yapılandırmasıbölümüne bakın. 

Geliştirme sertifikası oluşturuldu: 

• .NET Core SDK yüklendiği zaman. 

• Geliştirme-CERT aracı bir sertifika oluşturmak için kullanılır. 

Bazı tarayıcılarda yerel geliştirme sertifikasına güvenmek için açık izin verilmesi 
gerekir. 

Proje şablonları, uygulamaları HTTPS üzerinde varsayılan olarak çalışacak şekilde 
yapılandırır ve https yeniden yönlendirme ve HSTS desteğiiçerir. 

Kestrel için URL öneklerini ve bağlantı noktalarını yapılandırmak üzere 
KestrelServerOptions Listen veya ListenUnixSocket yöntemlerini çağırın. 

useuris , --urls komut satırı bağımsız değişkeni, urls ana bilgisayar yapılandırma 
anahtarı ve aspnetcorejjrls ortam değişkeni de çalışır, ancak bu bölümün ilerleyen 
kısımlarında belirtilen sınırlamalara sahiptir (HTTPS uç noktası yapılandırması için 
varsayılan sertifika kullanılabilir olmalıdır). 


KestrelServerOptions yapılandırması: 









ConfigureEndpointDefaults Varsayılanları (eylem<ListenOptions >) 


Belirtilen her bitiş noktası için çalıştırılacak bir yapılandırma Action belirtir. 


ConfigureEndpointDefaults birden çok kez çağrılması, önceki Action s'in belirtilen son 


Action yerini alır. 


public static IklebHostBuilder CreateWebHostBuilder(string[] args) => 
WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.ConfigureKestrel((context, serverOptions) => 

{ 

serverOptions.ConfigureEndpointDefaults(listenOptions => 

{ 

// Configure endpoint defaults 

}); 

}); 


NOTE 

Listen çağrılmadan oluşturulan bitiş noktaları, ConfigureEndpointDefaults çağrılmadan önce , 
varsayılan olarak uygulanmaz. 


ConfigureHttpsDefaults (eylemcHttpsConnectionAdapterOptions >) 


Her HTTPS uç noktası için çalıştırılacak bir yapılandırma 

Action 

belirtir. 

ConfigureHttpsDefaults 

birden çok kez çağrılması, önceki 

Action 

s 'in belirtilen son 


Action yerini alır. 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 
UlebHost .CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.ConfigureKestrel((context J serverOptions) => 

{ 

serverOptions.ConfigureHttpsDefaults(listenOptions => 

{ 

// certificate is an X509Certificate2 
listenOptions.ServerCertificate = certificate; 

}); 

}); 



Yapılandırma (Iconation) 

Giriş olarak bir IConfiguration alan Kestrel ayarlamak için bir yapılandırma yükleyicisi 
oluşturur. Yapılandırma, Kestrel için yapılandırma bölümünün kapsamına alınmalıdır. 

ListenOptions. UseHttps 

Kestrel'i HTTPS kullanacak şekilde yapılandırın. 

ListenOptions.UseHttps uzantıları: 

• UseHttps -varsayılan sertifikayla HTTPS kullanacak şekilde yapılandırın. 
Varsayılan sertifika yapılandırılmamışsa bir özel durum oluşturur. 

• UseHttps(string fileName) 










UseHttps(string fileName, string password) 


UseHttps(string fileName, string password, 
configureOptions) 

Action<HttpsConnectionAdapterOptions> 


UseHttps(StoreName storeName, string subject) 


UseHttps(StoreName storeName, string subject, bool allowInvalid) 


UseHttps(StoreName storeName, string subject, bool allowInvalid, 
location) 

StoreLocation 

UseHttps(StoreName storeName, string subject, bool allowInvalid, 
location, Action<HttpsConnectionAdapterOptions> configureOptions) 

StoreLocation 


• UseHttps(X509Certificate2 serverCertificate) 

UseHttps(X509Certificate2 senverCertificate, 

• Action<HttpsConnectionAdapterOptions> configureOptions) 

• UseHttps(Action<HttpsConnectionAdapterOptions> configureOptions) 
ListenOptions.useHttps parametreleri: 

• filename , uygulamanın içerik dosyalarını içeren dizine göre bir sertifika dosyasının 
yolu ve dosya adıdır. 

• X. 509.440 sertifika verilerine erişmek için gereken parola password . 

• configureOptions , HttpsConnectionAdapterOptions yapılandırmak için Action . 
ListenOptions döndürür. 

• storeName , sertifikanın yükleneceği sertifika deposudur. 

• subject , sertifikanın konu adıdır. 

• aiiowinvaiid , otomatik olarak imzalanan sertifikalar gibi geçersiz sertifikaların 
dikkate alınıp alınmayacağını gösterir. 

• location , sertifikanın yükleneceği mağaza konumudur. 

• serverCertificate X. 509.440 sertifikasıdır. 

Üretimde HTTPS 'nin açıkça yapılandırılması gerekir.En azından, varsayılan bir 
sertifika sağlanmalıdır. 

Daha sonra açıklanan desteklenen yapılandırma: 

• Yapılandırma yok 

• Varsayılan sertifikayı yapılandırmadan Değiştir 

• Koddaki varsayılanları değiştirme 

Yapılandırma yok 

Kestrel http://iocaihost 15000 ve https://localhost:5001 dinler (varsayılan bir 
sertifika varsa). 

Varsayılan sertifikayı yapılandırmadan Değiştir 
Kestrel yapılandırmasını yüklemek için varsayılan olarak 

Configure(context.Configuration.GetSection("Kestrel")) CreateDefaultBuilder çağırır. 
Varsayılan bir HTTPS uygulama ayarları yapılandırma şeması Kestrel için kullanılabilir. 
Disk üzerindeki bir dosyadan ya da bir sertifika deposundan kullanılacak URL 'Ler ve 
Sertifikalar dahil olmak üzere birden çok uç nokta yapılandırın. 

Aşağıdaki appSettings. JSON örneğinde: 

• Geçersiz sertifikaların (örneğin, otomatik olarak imzalanan sertifikalar) 
kullanılmasına izin vermek için, Allowwınvalid öğesini true olarak ayarlayın. 

• Bir sertifika belirtmeyen herhangi bir HTTPS uç noktası (aşağıdaki örnekte 












bulunanHttpsdefaultcert), varsayılan veya geliştirme sertifikası > Sertifikalar 

altında tanımlanan sertifikaya geri döner. 


{ 

"Kestrel": { 

"Endpoints": { 

"Http": { 

"Url": "http://localhost:5000" 

}, 

"HttpsInlineCertFile": { 

"Url": "https://localhost:5001", 

"Certificate": { 

"Path": "<path to .pfx file>", 

"Password": "<certificate password>" 

} 

}, 

"HttpsInllneCertStore": { 

"Url": "https://localhost:5002", 

"Certificate": { 

"Subject": "csubject; required>", 

"Store": "<certificate store; required>", 

"Location": "clocation; defaults to CurrentUser >", 
"AllowInvalid": "<true or false; defaults to false>" 

} 

}, 

"HttpsDefaultCert": { 

"Url": "https://localhost:5003" 

}, 

"Https": { 

"Url": "https://*:5004", 

"Certificate": { 

"Path": "<path to .pfx file>", 

"Password": "ccertificate password>" 

} 

} 

b 

"Certificates": { 

"Default": { 

"Path": "<path to .pfx file>", 

"Password": "ccertificate password>" 

} 

} 

} 

} 


Herhangi bir sertifika düğümü için yol ve parola kullanmanın alternatifi sertifika 
deposu alanlarını kullanarak sertifikayı belirtmektir. Örneğin, sertifikalar > 
varsayılan sertifika şöyle belirlenebilir: 

"Default": { 

"Subject": "csubject; required>", 

"Store": "ccert store; required>"j 

"Location": "clocation; defaults to CurrentUser >", 

"AllowInvalid": "ctrue or false; defaults to false>" 

} 


Şema notları: 

• Uç nokta adları büyük/küçük harfe duyarlıdır.Örneğin, https ve Https geçerlidir. 






• Her üç nokta için url parametresi gereklidir. Bu parametrenin biçimi, en üst düzey 
urls yapılandırma parametresiyle aynıdır, ancak tek bir değerle sınırlı olur. 

• Bu uç noktalar, üst düzey urls yapılandırmasında tanımlananlara eklemek yerine 
bunların yerini alır. Listen aracılığıyla kodda tanımlanan uç noktalar yapılandırma 
bölümünde tanımlanan uç noktalar ile birikimlidir. 

• Centificate bölümü isteğe bağlıdır. Centificate bölümü belirtilmemişse, önceki 
senaryolarda tanımlanan varsayılanlar kullanılır. Kullanılabilir varsayılan değer 
yoksa, sunucu bir özel durum oluşturur ve başlayamaz. 

• Centificate bölümü, hem yol-parolasını hem de Konu-Mağaza sertifikalarını 
destekler. 

• Herhangi bir sayıda uç nokta, bağlantı noktası çakışmalarına neden olmadıkları 
sürece bu şekilde tanımlanabilir. 

• options.Configure(context.Configuration.GetSection("{SECTIOI\l}")) , yapılandırılmış 

bir uç noktanın ayarlarını tamamlamak için kullanılabilecek 
.Endpoint(string name, listenOptions => { }) yöntemi ile bir 
KestrelConfigurationLoader döndürür: 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.UseKestnel((context, serverOptions) => 

{ 

serverOptions.Configure(context.Configuration.GetSection("Kestrel")) 

.Endpoint("HTTPS", listenOptions => 

{ 

listenOptions.HttpsOptions.SslProtocols = SslProtocols.Tlsl2; 

}); 

})j 

KestreiServerOptions.ConfigurationLoader , CreateDefaultBuildertarafından sağlana 
gibi var olan yükleyicisindeki yinelenmeye devam etmek için doğrudan erişilebilir. 

• Her uç noktanın yapılandırma bölümü, özel ayarların okunabilmesi için Endpoint 
yöntemindeki seçeneklerde kullanılabilir. 

• options.Configure(context.Configuration.GetSection("{SECTIOI\l}")) başka bir 
bölümle yeniden çağırarak birden çok yapılandırma yüklenebilir. Load önceki 
örneklerde açıkça çağrılmamışsa yalnızca son yapılandırma kullanılır. Metapackage, 
varsayılan yapılandırma bölümünün değiştirilebilmesi için Load çağırmaz. 

• KestrelConfigurationLoader , API 'lerin Listen ailesini KestreiServerOptions 
Endpoint aşırı yükleme olarak yansıtır, bu nedenle kod ve yapılandırma uç 

noktaları aynı yerde yapılandırılabilir. Bu aşırı yüklemeler adları kullanmaz ve 
yalnızca yapılandırmadan varsayılan ayarları kullanır. 


Koddaki varsaydanları değiştirme 



yapılandırılmadan önce çağrılmalıdır. 




















public static IklebHostBuilder CreateWebHostBuilder(str'ing[] args) => 

WebHost.CreateOefaultBuilder(args) 

.UseStartup<Startup>() 

.UseKestnel((contextj serverOptions) => 

{ 

serverOptions.ConfigureEndpointDefaults(listenOptions => 

{ 

// Configure endpoint defaults 

}); 

serverOptions.ConfigureHttpsDefaults(listenOptions => 

{ 

listenOptions.SslProtocols = SslProtocols.TİSİ2; 

}); 

}); 

SNı için Kestrel desteği 

Sunucu adı belirtme (SNı) , aynı İP adresi ve bağlantı noktası üzerinde birden fazla etki 
alanını barındırmak için kullanılabilir. SNı ’nin çalışması için, istemci, TLS el sıkışması 
sırasında güvenli oturum ana bilgisayar adını, sunucunun doğru sertifikayı 
sağlayabilmesi için gönderir, istemci, TLS anlaşmasını izleyen güvenli oturum sırasında 
sunucuyla şifreli iletişim için bulunan sertifikayı kullanır. 

Kestrel serverCertificateSelector geri çağırma aracılığıyla SNı destekler.Geri 
çağırma, uygulamanın ana bilgisayar adını incelemesine ve uygun sertifikayı seçmesini 
sağlamak için bağlantı başına bir kez çağrılır. 

SNı desteği şunları gerektirir: 

• Hedef Framevvork netcoreapp2.ı veya sonraki sürümlerde çalışıyor. net46i veya 
sonraki sürümlerde, geri çağırma çağrılır, ancak name her zaman nuiı . Ayrıca, 
istemci, TLS el sıkışmasının ana bilgisayar adı parametresini sağlamıyorsa da nuiı 

name . 

• Tüm Web siteleri aynı Kestrel örneğinde çalışır.Kestrel, bir İP adresi ve bağlantı 
noktasının bir ters proxy olmadan birden çok örnek arasında paylaşılmasını 
desteklemez. 










public static IklebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.UseKestrel((context, serverOptions) => 

{ 

serverOptions.ListenAnyIP(5005, listenOptions => 

{ 

listenOptions.UseHttps(httpsOptions => 

{ 

var localhostCert = CertificateLoader.LoadFromStoreCert( 
"localhost", "My", StoreLocation.CurrentUser, 
allowInvalid: true); 

var exampleCert = CertificateLoader.LoadFromStoreCert( 
"example.com", "My", StoreLocation.CurrentUser, 
allowInvalid: true); 

var subExampleCert = CertificateLoader.LoadFromStoreCert( 
"sub.example.com", "My", StoreLocation.CurrentUser, 
allowInvalid: true); 

var certs = new Dictionary<string, X509Certificate2>( 
StringComparer.OrdinalIgnoreCase); 
certs["localhost"] = localhostCert; 
certs ["example.com"] = exampleCert; 
certs["sub. example.com"] = subExampleCert; 

httpsOptions.ServerCertificateSelector = (connectionContext, 

name) => 

{ 

if (name != null && certs.TryGetValue(name, out var cert)) 

{ 

return cert; 

} 

return exampleCert; 

}J 

}); 

}); 

}) 

.Build(); 


Bağlantı günlüğü 

Bir bağlantıda bayt düzeyinde iletişim için hata ayıklama düzeyi günlüklerini yayma 
UseConnectionLogging çağırın. Bağlantı günlüğü, TLS şifreleme ve proxy 'nin 
arkasındaki gibi alt düzey iletişimde sorunları gidermeye yardımcı olur. 
UseConnectionLogging useHttps önce yerleştirilmişse, şifrelenmiş trafik günlüğe 
kaydedilir. UseConnectionLogging UseHttps sonra yerleştirilmişse, şifresi çözülmüş 
trafik günlüğe kaydedilir. 

webBuilder.ConfigureKestrel(serverOptions => 

{ 

serverOptions.Listen(IPAddress.Any, 8000, listenOptions => 

{ 

listenOptions.UseConnectionLogging(); 

}); 

}); 


TCP yuvasına bağlama 

Listen yöntemi bir TCP yuvasına bağlanır ve bir seçenek lambda X. 509.440 sertifika 
yapılandırmasına izin verir: 





public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build().Run(); 

} 

public static IklebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.UseKestrel(serverOptions => 

{ 

serverOptions.Listen(IPAddress.Loopback, 5000); 
serverOptions.Listen(IPAddress.Loopback, 5001, listenOptions => 
{ 

listenOptions.UseHttps("testCert.pfx", "testPassword"); 

}); 

}); 


public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build().Run(); 

} 

public static IklebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateOefaultBuilder(args) 

.UseStartup<Startup>() 

.UseKestrel(serverOptions => 

{ 

serverOptions.Listen(IPAddress.Loopback, 5000)j 

serverOptions.Listen(IPAddress.Loopback, 5001, listenOptions => 

{ 

listenOptions.UseHttps("testCert.pfx", "testPassword"); 

}); 

}); 

Örnek, ListenOptionsolan bir uç nokta için HTTPS 'yi yapılandırır. Belirli uç noktalar 
için diğer Kestrel ayarlarını yapılandırmak üzere aynı API 'yi kullanın. 

Windows üzerinde otomatik olarak imzalanan sertifikalar kullanılarak oluşturulabilir 
New-SelfSignedCertificate PovverShell cmdlet'i. Desteklenmeyen bir örnek için bkz 
U pdatel IS ExpressS S L ForC hrome.ps 1 . 

MacOS, Linux ve Windows, sertifikalar kullanılarak oluşturulabilir OpenSSL. 

UNIX yuvasına bağlama 

Aşağıdaki örnekte gösterildiği gibi NGINX ile daha iyi performans için 
ListenUnixSocket bir UNIX yuvası dinleyin: 

public static IklebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.UseKestrel(serverOptions => 

{ 

serverOptions.ListenUnixSocket("/tmp/kestrel-test.sock"); 
serverOptions.ListenUnixSocket("/tmp/kestrel-test.sock", listenOptions 

= > 

{ 

listenOptions.UseHttps("testCert.pfx", "testpassword"); 

}); 

}); 


Bağlantı noktası 0 




0 bağlantı noktası numarası belirtildiğinde, Kestrel dinamik olarak kullanılabilir bir 
bağlantı noktasına bağlanır. Aşağıdaki örnek, çalışma zamanında Kestrel gerçekte 
hangi bağlantı noktasının gerçekten bağlandığını nasıl belirleyeceğini göstermektedir: 

public void Configure(IApplicationBuilder app) 

{ 

var serverAddressesFeature = 

app.ServerFeatures.Get<IServerAddressesFeature>(); 

app.UseStaticFiles(); 

app.Run(async (context) => 

{ 

context.Response.ContentType = "text/html"; 
await context.Response 

.WriteAsync("<IDOCTYPE htmlxhtml lang=\"en\"xhead>" + 

"<titlex/titlex/headxbodyxp>Hosted by Kestrel</p>"); 

if (serverAddressesFeature != null) 

{ 

await context.Response 

.WriteAsync("<p>Listening on the following addresses: " + 
string.Zloin(", ", serverAddressesFeature.Addresses) + 

"</p>")j 

} 

await context.Response.WriteAsync("<p>Request URL: " + 
$"{context.Request.GetDisplayUrl()}<p>"); 

})J 

} 

Uygulama çalıştırıldığında konsol penceresi çıkışı, uygulamanın erişilebileceği dinamik 
bağlantı noktasını gösterir: 

Listening on the following addresses: http://127.0.0.1:48508 

Sınırlamalar 

Aşağıdaki yaklaşımlar ile uç noktaları yapılandırın: 

• UseUrls 

• --urls komut satırı bağımsız değişkeni 

• urls ana bilgisayar yapılandırma anahtarı 

• aspnetcorejjrls ortam değişkeni 

Bu yöntemler, kodun Kestrel dışındaki sunucularla çalışmasını sağlamak için yararlıdır. 
Ancak, aşağıdaki sınırlamalara dikkat edin: 

• HTTPS uç noktası yapılandırmasında varsayılan bir sertifika sağlanmadığı sürece 
(örneğin, bu konuda daha önce gösterildiği gibi KestreiserverOptions 
yapılandırması veya yapılandırma dosyası kullanılarak), HTTPS bu yaklaşımlar ile 
kullanılamaz. 


• 

Listen 

ve 

UseUrls 

yaklaşımlarının her ikisi de aynı anda kullanıldığında 

Listen 


uç noktaları 

UseUrls 

uç noktaları geçersiz kılar. 



MS uç nokta yapılandırması 

MS kullanırken, IIS geçersiz kılma bağlamaları için URL bağlamaları Listen veya 
useuris tarafından ayarlanır. Daha fazla bilgi için ASP.NET Core modülü konusuna 











bakın. 


Aktarım yapılandırması 

AS P.N ET Core 2,1 sürümü ile Kestrel 'in varsayılan taşıması artık libuv 1 d i temel 
değildir ancak bunun yerine yönetilen yuvaları temel alır. Bu, UseLibuv çağıran ve 
aşağıdaki paketlerden birine bağlı olan 2,1 ' ye yükselten AS P.N ET Core 2,0 
uygulamaları için bir son değişiklik değildir: 

• Microsoft. AspNetCore. Server. Kestrel (doğrudan paket başvurusu) 

• Microsoft. AspNetCore. app 

Libuv kullanımını gerektiren projeler için: 

• Uygulamanın proje dosyasına Microsoft. AspNetCore. Server. Kestrel. 

Transport. libuv paketi için bir bağımlılık ekleyin: 

<PackageReference 

Include="Microsoft.AspNetCore.Server.Kestrel.T ransport.Libuv" 
Version="{VERSION}" /> 

• UseLibuvçağrısı: 

public class Program 
{ 

public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build().Run(); 

} 

public static IklebHostBuilder CreateWebHostBuilder(string[] args) => 
WebHost.CreateDefaultBuilder(args) 

.UseLibuv() 

.UseStartup<Startup>(); 

} 

URL önekleri 

useuris , --urls komut satırı bağımsız değişkenini, urls ana bilgisayar 
yapılandırma anahtarını veya aspnetcorejjrls ortam değişkenini kullanırken, URL 
önekleri aşağıdaki biçimlerden birinde olabilir. 

Yalnızca HTTP URL ön ekleri geçerlidir.Kestrel, useuris kullanılarak URL bağlamaları 
yapılandırırken HTTPS 'Yİ desteklemez. 

• Bağlantı noktası numarası olan IPv4 adresi 

http://65.55. 39.10:80/ 

0 . 0 . 0.0 , tüm IPv4 adreslerine bağlanan özel bir durumdur. 

• Bağlantı noktası numarasına sahip IPv6 adresi 

http://[0:0:0:0:0:ffff:4137:270a]:80/ 


[::] , IPv4 0 . 0 . 0.0 IPv6 eşdeğeridir. 







• Bağlantı noktası numarası olan ana bilgisayar adı 

http://contoso.com:80/ 
http://*:80/ 

Ana bilgisayar adları, * ve + özel değildir. Geçerli bir İP adresi olarak 
tanınmayan bir şey veya localhost tüm IPv4 ve IPv6 İP 'lerine bağlanır.Farklı 
ana bilgisayar adlarını aynı bağlantı noktasında farklı ASP.NET Core 
uygulamalarına bağlamak için, http. sys veya 11S, NGINX veya Apache gibi bir 
ters proxy sunucusu kullanın. 


VVARNING 

Ters Proxy yapılandırmasında barındırma, konak filtrelemeyigerektirir. 


• Port numarası veya bağlantı noktası numarası ile geri döngü İP 'si localhost 
ana bilgisayar adı 

http://localhost:5000/ 
http://127.0- 0.1:5000/ 
http://[::1]:5000/ 

localhost belirtildiğinde, Kestrel hem IPv4 hem de IPv6 geri döngü 
arabirimlerini bağlamaya çalışır, istenen bağlantı noktası, herhangi bir geri 
döngü arabiriminde başka bir hizmet tarafından kullanılıyorsa, Kestrel 
başlatılamaz. Herhangi bir geri döngü arabirimi başka bir nedenle 
kullanılamıyorsa (genellikle IPv6 desteklenmediği için), Kestrel bir uyarı 
kaydeder. 


Konak filtreleme 

Kestrel, http://exampie.com : 5000 gibi önekleri temel alarak yapılandırmayı desteklese 
de, büyük ölçüde ana bilgisayar adını yoksayar. Ana bilgisayar localhost , geri döngü 
adreslerine bağlama için kullanılan özel bir durumdur. Açık İP adresi dışındaki tüm ana 
bilgisayar tüm genel İP adreslerine bağlanır. Hoşt üstbilgileri doğrulanmadı. 


Geçici bir çözüm olarak, ana bilgisayar filtreleme ara yazılımı kullanın. Ana bilgisayar 
filtreleme ara yazılımı, Microsoft, aspnetcore. app metapackage (ASP.NET Core 2,1 
veya 2,2)' de yer alan Microsoft. Aspnetcore. hostfiltering paketi tarafından sağlanır. 
Ara yazılım, AddHostFilteringçağıran CreateDefaultBuildertarafından eklenir: 


public class Program 
{ 

public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build().Run(); 

} 


} 


public static IUebHostBuilder CreateWebHostBuilder(string[] args) => 
WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>(); 


Ana bilgisayar filtreleme ara yazılımı varsayılan olarak devre dışıdır. Ara yazılımı 











etkinleştirmek için appSettings.jsorı/appSettlngs içinde bir AiiowedHosts anahtarı 
tanımlayın ,<environmentname >. JSON. Değer, bağlantı noktası numaraları olmayan 
ana bilgisayar adlarının noktalı virgülle ayrılmış listesidir: 

appSettings. JSON: 


{ 

"AllowedHosts": "example.comjlocalhost" 

} 


NOTE 

İletilen üstbilgiler ara yazılımı ayrıca bir AllovvedHosts seçeneği de vardır, iletilen üstbilgiler ara 
yazılımı ve ana bilgisayar filtreleme ara yazılımı, farklı senaryolar için benzer işlevlere sahiptir. 
İletilen üst bilgi ara sunucusu ile AilowedHosts ayarlama, istekleri bir ters ara sunucu veya 
yük dengeleyici ile iletirken, Hoşt üst bilgisi korunurken uygun olur. Kestrel genel kullanıma 
açık bir uç sunucu olarak veya Hoşt üstbilgisi doğrudan iletildiğinde, ana bilgisayar 
filtreleme ara yazılımı ile AilowedHosts ayarlama uygundur. 

İletilen üstbilgiler ara yazılımı hakkında daha fazla bilgi için bkz. Proxy sunucularıyla ve yük 
dengeleyicilerle çalışacak ASP.NET Core yapılandırma. 


Ek kaynaklar 

• ASP.NET Core projeleri sorunlarını giderme 

• ASP.NET Core 'de HTTPS 'yi zorla 

• Proxy sunucularıyla ve yük dengeleyicilerle çalışacak ASP.NET Core yapılandırma 

• RFC 7230: İleti sözdizimi ve yönlendirme (Bölüm 5,4: Ana bilgisayar) 






ASPNET Core 'de HTTP sys Web sunucusu 
uygulama 

23.11.2019 * 23 minutes to read ı Edit Online 


Tom Dykstra, Chris, ve Luke Latham tarafından 

Http. sys , yalnızca Windows üzerinde çalışan AS P.N ET Core için bir Web sunucusudur. HTTP, sys, 
Kestrel Server için bir alternatiftir ve Kestrel tarafından sağlamayan bazı özellikler sunar. 

IMPORTANT 

HTTP, sys ASP.NET Core modülüyle uyumlu DEĞİLDİR ve us veya 11S Express ile kullanılamaz. 

HTTP, sys aşağıdaki özellikleri destekler: 

• Windows kimlik doğrulaması 

• Bağlantı noktası Paylaşımı 

• SNı ile HTTPS 

• TLS üzerinden HTTP/2 (Windows 10 veya üzeri) 

• Doğrudan dosya iletimi 

• Yanıtları Önbelleğe Alma 

• VVebSockets (VVİndovvs 8 veya üzeri) 

Desteklenen VVİndovvs sürümleri: 

• VVİndovvs 7 veya üzeri 

• VVİndovvs Server 2008 R2 veya üzeri 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 


HTTP, sys ne zaman kullanılır 

HTTP, sys, şu durumlarda olduğu dağıtımlar için yararlıdır: 

• Sunucuyu 11S kullanmadan doğrudan Internet 'e sunmaya gerek vardır. 

Internet 

HTTP 

< - 



ASP.NET Core application 


HttpSys 

0 

HttpContext 

Application code 

0 







• iç dağıtım, VVİndovvs kimlik doğrulamasıgibi Kestrel 'de kullanılamayan bir özelliği gerektirir. 

ASP.NET Core application 


Internal 

Netvvork 


HTTP 

HttpSys 

HttpContext Application code 


0 

■* * GD 


HTTP, sys pek çok tür saldırılara karşı koruyan ve tam özellikli bir Web sunucusu için sağlamlık, 
güvenlik ve ölçeklenebilirlik sağlayan çok sayıda teknolojiden oluşur. IIS, HTTP, sys 1 nin üstünde 
HTTP dinleyicisi olarak çalışır. 













HTTP/2 desteği 

Aşağıdaki temel gereksinimler karşılanıyorsa ASP.NET Core uygulamalar için http/2 etkinleştirilir: 


• Windows Server 2016/Windows 10 veya üzeri 

• Uygulama katmanı protokol anlaşması (ALPN) bağlantısı 

• TLS 1.2 veya sonraki bir bağlantı 


Bir HTTP/2 bağlantı kurulur, HttpRequest.Protocol raporları http /2 . 
Bir HTTP/2 bağlantı kurulur, HttpReguest.Protocol raporları http/i.i . 


HTTP/2 varsayılan olarak etkindir. HTTP/2 bağlantısı kurulmadıysa, bağlantı HTTP/1.1 'ye geri döner. 
Windows 'un gelecek bir sürümünde http/2 yapılandırma bayrakları http/2 ' yi HTTP, sys ile devre dışı 
bırakma özelliği de dahil olmak üzere kullanılabilir olacaktır. 


Kerberos ile çekirdek modu kimlik doğrulaması 

Çekirdek modu kimlik doğrulaması Kerberos kimlik doğrulama protokolü HTTP.sys temsil eder. 
Kullanıcı modu kimlik doğrulaması, Kerberos ve HTTP.sys ile desteklenmez. Makine hesabı Kerberos 
belirteci/Active Directory'den elde edilen anahtar şifresini çözmek için kullanılan ve kullanıcının 
kimliğini doğrulamak için istemcinin sunucuya iletilir. Hizmet asıl adı (SPN) konak için değil 
uygulamanın kullanıcı kaydedin. 

HTTP, sys kullanma 

ASP.NET Core uygulamasını HTTP, sys kullanacak şekilde yapılandırma 

Microsoft. AspNetCore. app metapackage (NuGet.org) kullanılırken proje dosyasındaki bir paket 
başvurusu gerekli değildir. Microsoft.AspNetCore.App metapackage kullanmadığınız durumlarda 
Microsoft. AspNetCore. Server. HttpSysöğesine bir paket başvurusu ekleyin. 

Konak oluştururken UseHttpSys uzantı yöntemini çağırın, gerekli HttpSysOptionsbelirtin. Aşağıdaki 
örnek, seçeneklerini varsayılan değerlerine ayarlar: 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureUebHostDefaults(webBuilder => 

{ 

webBuilder.UseHttpSys(options => 

{ 

options.AllowSynchronousIO = true; 

options.Authentication.Schemes = AuthenticationSchemes.None; 

options.Authentication.AllowAnonymous = true; 

options.MaxConnections = null; 

options.MaxRequestBodySize = 30000000; 

options.UrlPrefixes.Add("http://localhost:5005"); 

}); 

webBuilder.UseStartup<Startup>(); 

}); 






public static IWebHostBuilder CreateWebHostBuilder(string[] angs) => 
WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.UseHttpSys(options => 

{ 

options.AllowSynchronousIO = true; 

options.Authentication.Schemes = AuthenticationSchemes.None; 

options.Authentication. AllowAnonymous = true; 

options.MaxConnections = null; 

options.MaxRequestBodySize = 30000000; 

options.UrlPrefixes.Add("http://localhost:5000"); 

}); 


Ek HTTP, sys yapılandırması, kayıt defteri ayarlarıaracı Iığıyla işlenir. 

HTTP, sys seçenekleri 

ÖZELLİK AÇIKLAMA VARSAYILAN 


AllovvSynchronouslO 

HttpContext.Request.Body ve 

f alse 


HttpContext.Response.Body İçin 



zaman uyumlu giriş/çıkışa izin 
verilip verilmeyeceğini denetleyin. 


Authentication. AllovvAnonymous 

Anonim isteklere izin verin. 

true 

Authentication. düzenleri 

izin verilen kimlik doğrulama 
düzenlerini belirtin. Dinleyici elden 
atılırken önce herhangi bir 
zamanda değiştirilebilir. Değerler 

Authenticationdüzenlerinin 

numaralandırmasıtarafından 
sağlanır: Basic , Kerberos , 

Negotiate , None ve NTLM . 

None 

EnableResponseCaching 

Uygun üst bilgileri içeren yanıtlar 
için çekirdek modu önbelleğe 
almayı deneyin. Yanıt set-cookie 
, vary veya Pragma üst bilgilerini 
içeremez. Bu, public bir 

shared-max-age veya max-age 

değeri ya da bir Expires üst 
bilgisi içermelidir Cache-Control . 

true 

MaxAccepts 

En fazla eşzamanlı kabul sayısı. 

5 x Environment. 

ProcessorCount 

MaxConnections 

Kabul edilecek eşzamanlı bağlantı 
sayısı üst sınırı. Sonsuz için -ı 
kullanın. Kayıt defterinin makine 
genelindeki ayarını kullanmak için 
null kullanın. 

null 

(makine genelinde 
ayarlanmasını 

MaxRequestBodySize 

MaxRequestBodySize bölümüne 
bakın. 

30000000 bayt 
(~ 28,6 MB) 

RequestQueueLimit 

Sıraya alınabilen en fazla istek 
sayısı. 

1000 













ÖZELLİK 


AÇIKLAMA 


VARSAYILAN 


RequestQueueMode 


RequestQueueName 

ThrowWriteExceptions 


Timeouts 


Bu, sunucunun istek kuyruğunu 
oluşturma ve yapılandırmadan 
sorumlu olup olmadığını veya 
mevcut bir kuyruğa iliştirilmesinin 
gerekip gerekmediğini belirtir. 
Mevcut bir kuyruğa eklenirken, 
mevcut yapılandırma seçeneklerinin 
çoğu geçerli değildir. 


HTTP, sys istek kuyruğunun adı. 


istemci bağlantısının kesilmesinden 
kaynaklanan yanıt gövdesi 
yazmasının, özel durumlar 
oluşturması veya normal şekilde 
tamamlanması gerektiğini belirtin. 


Kayıt defterinde da 
yapılandırılabilen HTTP, sys 
TimeoutManager yapılandırmasını 
kullanıma sunun. Varsayılan 
değerler de dahil olmak üzere her 
bir ayar hakkında daha fazla bilgi 
edinmek için API bağlantılarını 
izleyin: 

• HTTP Sunucusu API 'sinin 
varlık gövdesini etkin tut 
bağlantısıyla boşaltmasına 
izin verilen 

TimeoutManager. 
DrainEntityBody - zaman. 

• TimeoutManager. 
entitybody - istek varlığı 
gövdesinin gelmesi için İzin 
verilen süre. 

• HTTP Sunucusu API 'sinin 
istek üst bilgisini 
ayrıştırması için 
TimeoutManager. 

HeaderVVait - süresi. 

• TimeoutManager. 
ıdleconnection - boştaki bir 
bağlantı için izin verilir. 

• TimeoutManager. 
MinSendBytesPerSecond , 
yanıt için en düşük 
gönderme oranını 

• Zaman TimeoutManager. 
RequestQueue - isteğin, 
uygulama onu seçmeden 
önce istek kuyruğunda 
kalmasına izin verilir. 


RequestQueueMode.Create 


null (anonim kuyruk) 

f alse 

(normal olarak) 







ÖZELLİK 


AÇIKLAMA 


VARSAYILAN 


UrlPrefixes 

ÖZELLİK 

HTTP, sys ile kaydolmak için 
UrlPrefixCollection belirtin. En 
yararlı olan UrlPrefixCollection. 

Add, koleksiyona bir ön ek eklemek 
için kullanılır. Bunlar, dinleyici elden 
atılıyor öncesinde herhangi bir 
zamanda değiştirilebilir. 

AÇIKLAMA 

VARSAYILAN 

AllovvSynchronouslO 

HttpContext.Request.Body ve 

HttpContext.Response.Body için 
zaman uyumlu giriş/çıkışa izin 
verilip verilmeyeceğini denetleyin. 

f alse 

Authentication. AllovvAnonymous 

Anonim isteklere izin verin. 

true 

Authentication. düzenleri 

izin verilen kimlik doğrulama 
düzenlerini belirtin. Dinleyici elden 
atılırken önce herhangi bir 
zamanda değiştirilebilir. Değerler 

Authenticationdüzenlerinin 

numaralandırmasıtarafından 
sağlanır: Basic , Kerberos , 

Negotiate , None ve NTLM . 

None 

EnableResponseCaching 

Uygun üst bilgileri içeren yanıtlar 
için çekirdek modu önbelleğe 
almayı deneyin. Yanıt set-cookie 
, vary veya Pragma üst bilgilerini 
içeremez. Bu, public bir 

shared-max-age veya max-age 

değeri ya da bir Expires üst 
bilgisi içermelidir Cache-Control . 

true 

MaxAccepts 

En fazla eşzamanlı kabul sayısı. 

5 x Environment. 

ProcessorCount 

MaxConnections 

Kabul edilecek eşzamanlı bağlantı 
sayısı üst sınırı. Sonsuz için -ı 
kullanın. Kayıt defterinin makine 
genelindeki ayarını kullanmak için 
null kullanın. 

null 

(makine genelinde 
ayarlanmasını 

MaxRequest BodySize 

MaxRequestBodySize bölümüne 
bakın. 

30000000 bayt 
(~ 28,6 MB) 

RequestQueueLimit 

Sıraya alınabilen en fazla istek 
sayısı. 

1000 

ThrowWriteExceptions 

istemci bağlantısının kesilmesinden 
kaynaklanan yanıt gövdesi 
yazmasının, özel durumlar 
oluşturması veya normal şekilde 
tamamlanması gerektiğini belirtin. 

f alse 

(normal olarak) 











ÖZELLİK 


AÇIKLAMA 


VARSAYILAN 


Timeouts 


UrlPrefixes 


ÖZELLİK 

AllovvSynchronouslO 


Kayıt defterinde da 
yapılandırılabilen HTTP, sys 
TimeoutManager yapılandırmasını 
kullanıma sunun. Varsayılan 
değerler de dahil olmak üzere her 
bir ayar hakkında daha fazla bilgi 
edinmek için API bağlantılarını 
izleyin: 

• HTTP Sunucusu API 'sinin 
varlık gövdesini etkin tut 
bağlantısıyla boşaltmasına 
izin verilen 

TimeoutManager. 
DrainEntityBody - zaman. 

• TimeoutManager. 
entitybody - istek varlığı 
gövdesinin gelmesi için İzin 
verilen süre. 

• HTTP Sunucusu API 'sinin 
istek üst bilgisini 
ayrıştırması için 
TimeoutManager. 

HeaderVVait - süresi. 

• TimeoutManager. 
ıdleconnection - boştaki bir 
bağlantı için izin verilir. 

• TimeoutManager. 
MinSendBytesPerSecond , 
yanıt için en düşük 
gönderme oranını -. 

• Zaman TimeoutManager. 
RequestQueue - isteğin, 
uygulama onu seçmeden 
önce istek kuyruğunda 
kalmasına izin verilir. 


HTTP, sys ile kaydolmak için 
UrlPrefixCollection belirtin. En 
yararlı olan UrlPrefixCollection. 

Add, koleksiyona bir ön ek eklemek 
için kullanılır. Bunlar, dinleyici elden 
atılıyor öncesinde herhangi bir 
zamanda değiştirilebilir. 


AÇIKLAMA 


VARSAYILAN 


ve true 

için 

verilip verilmeyeceğini denetleyin. 


HttpContext.Request.Body 
HttpContext.Response.Body 
zaman uyumlu giriş/çıkışa izin 


true 


Authentication. AllovvAnonymous 


Anonim isteklere izin verin. 




ÖZELLİK 


AÇIKLAMA 


VARSAYILAN 


Authentication. düzenleri 


EnableResponseCaching 


MaxAccepts 


MaxConnections 


MaxRequestBodySize 


RequestQueueLimit 


ThrowWriteExceptions 


izin verilen kimlik doğrulama 
düzenlerini belirtin. Dinleyici elden 
atılırken önce herhangi bir 
zamanda değiştirilebilir. Değerler 

Authenticationdüzenlerinin 
numaralandırmasıtarafından 
sağlanır: Basic , Kerberos , 
Negotiate , None ve NTLM . 

Uygun üst bilgileri içeren yanıtlar 
için çekirdek modu önbelleğe 
almayı deneyin. Yanıt set-cookie 
, vary veya Pragma üst bilgilerini 
içeremez. Bu, public bir 
shared-max-age veya max-age 
değeri ya da bir Expires üst 
bilgisi içermelidir caehe-control . 


En fazla eşzamanlı kabul sayısı. 


Kabul edilecek eşzamanlı bağlantı 
sayısı üst sınırı. Sonsuz için -ı 
kullanın. Kayıt defterinin makine 
genelindeki ayarını kullanmak için 
null kullanın. 


MaxRequestBodySize bölümüne 
bakın. 


Sıraya alınabilen en fazla istek 
sayısı. 


istemci bağlantısının kesilmesinden 
kaynaklanan yanıt gövdesi 
yazmasının, özel durumlar 
oluşturması veya normal şekilde 
tamamlanması gerektiğini belirtin. 


None 


true 


5 x Environment. 
ProcessorCount 

null 

(makine genelinde 
ayarlanmasını 


30000000 bayt 
(~ 28,6 MB) 

1000 


f alse 

(normal olarak) 







ÖZELLİK 


AÇIKLAMA 


VARSAYILAN 


Timeouts Kayıt defterinde da 

yapılandırılabilen HTTP, sys 
TimeoutManager yapılandırmasını 
kullanıma sunun. Varsayılan 
değerler de dahil olmak üzere her 
bir ayar hakkında daha fazla bilgi 
edinmek için API bağlantılarını 
izleyin: 

• HTTP Sunucusu API 'sinin 
varlık gövdesini etkin tut 
bağlantısıyla boşaltmasına 
izin verilen 

TimeoutManager. 
DrainEntityBody - zaman. 

• TimeoutManager. 
entitybody - istek varlığı 
gövdesinin gelmesi için İzin 
verilen süre. 

• HTTP Sunucusu API 'sinin 
istek üst bilgisini 
ayrıştırması için 
TimeoutManager. 

HeaderVVait - süresi. 

• TimeoutManager. 
ıdleconnection - boştaki bir 
bağlantı için izin verilir. 

• TimeoutManager. 
MinSendBytesPerSecond , 
yanıt için en düşük 
gönderme oranını -. 

• Zaman TimeoutManager. 
RequestQueue - isteğin, 
uygulama onu seçmeden 
önce istek kuyruğunda 
kalmasına izin verilir. 


UrlPrefixes HTTP, sys ile kaydolmak için 

UrlPrefixCollection belirtin. En 
yararlı olan UrlPrefixCollection. 

Add, koleksiyona bir ön ek eklemek 
için kullanılır. Bunlar, dinleyici elden 
atılıyor öncesinde herhangi bir 
zamanda değiştirilebilir. 


MaxRequestBodySize 

Herhangi bir istek gövdesinin bayt olarak izin verilen en büyük boyutu, nuiı olarak ayarlandığında, en 
büyük istek gövdesi boyutu sınırsızdır. Bu sınırın, her zaman sınırsız olan yükseltilmiş bağlantıları 
üzerinde hiçbir etkisi yoktur. 

Tek bir iActionResuit için ASP.NET Core MVC uygulamasında sınırı geçersiz kılmak için önerilen 
yöntem, bir eylem yönteminde RequestSizeLimitAttribute özniteliğini kullanmaktır: 

[RequestSizeLimit(100000000)] 
public IActionResult MyActionMethod() 


Uygulama isteği okumayı başlattıktan sonra bir istek üzerindeki sınırı yapılandırmayı denerse bir özel 





durum oluşur. isReadOniy özelliği, MaxRequestBodySize özelliğinin salt okuma durumunda olup 
olmadığını göstermek için kullanılabilir, yani sınırı yapılandırmak için çok geç. 

Uygulamanın istek başına MaxRequestBodySize geçersiz kılması gerekiyorsa, 
IHttpMaxRequestBodySizeFeaturekul lanın: 

public void Configure(IApplicationBuilder app, IklebHostEnvironment env, 

ILogger<Startup> logger, IServer server) 

{ 

app.Use(async (context, next) => 

{ 

context.Features.Get<IHttpMaxRequestBodySizeFeature>() 

.MaxRequestBodySize = 10 * 1024; 

var serverAddressesFeature = 

app.ServerFeatures.Get<IServerAddressesFeature>(); 
var addresses = string.]oin(", ", serverAddressesFeature?.Addresses); 

logger.LogInformation("Addresses: {Addresses}", addresses); 

await next.Invoke(); 

»; 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

} 

app.UseStaticFiles(); 

app.UseRoutingO; 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapRazorPages(); 

}); 

} 





public void Configure(IApplicationBuilder app, IHostingEnvironment env, 
ILogger<Stantup> logger, IServer server) 

{ 

app.Use(async (context, next) => 

{ 

context.Features.Get<IHttpMaxRequestBodySizeFeature>() 

.MaxRequestBodySize = 10 * 1024; 

var serverAddressesFeature = 

app.ServerFeatures.Get<IServerAddressesFeature>(); 
var addresses = string.Doin(", ", serverAddressesFeature?.Addresses); 

logger.LogInformation("Addresses: {Addresses }", addresses); 

await next.Invoke(); 

»; 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

app.UseHsts(); 

} 

// Enable FITTPS Redirection Middleware when hosting the app securely. 

//app.UseHttpsRedirection(); 

app.UseStaticFiles(); 

app.UseCookiePolicy(); 

app.UseMvc(); 


Visual Studio kullanıyorsanız, uygulamanın 11S veya 11S Express çalıştıracak şekilde 
yapılandırılmadığından emin olun. 


Visual Studio 'da varsayılan başlatma profili 11S Express içindir. Projeyi konsol uygulaması olarak 
çalıştırmak için, aşağıdaki ekran görüntüsünde gösterildiği gibi seçili profili el ile değiştirin: 
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1. Uygulamanın açmak için bağlantı noktalarını belirleme ve VVİndovvs Güvenlik Duvarı 1 N ı veya 
New-NetFirewallRule PovverShell CMDLET 'ini kullanarak trafiğin http. sys ' ye ulaşmasını 
sağlamak için güvenlik duvarı bağlantı noktalarını açın. Aşağıdaki komutlarda ve uygulama 
yapılandırmasında, 443 numaralı bağlantı noktası kullanılır. 

2. Bir Azure sanal makinesine dağıtım yaparken, ağ güvenlik grubundakibağlantı noktalarını açın. 
Aşağıdaki komutlarda ve uygulama yapılandırmasında, 443 numaralı bağlantı noktası kullanılır. 

3. Gerekirse, X. 509.440 sertifikalarını edinin ve yükler. 

VVİndovvs 'da, New-SelfSignedCertificate PovverShell cmdlet 'inikullanarak otomatik olarak 
imzalanan sertifikalar oluşturun. Desteklenmeyen bir örnek için bkz 










UpdatellSExpressSSLForChrome. psl. 


Kişisel mağaza > sunucunun Yerel makinesine OTOMATİK olarak imzalanan veya CA imzalı 
sertifikalar yükler. 

4. Uygulama çerçeveye bağımlı bir dağıtımise, .netcore, .NET Framevvork veya her ikisini de 
(uygulama .NET Framevvork hedefleyen bir .NET Core uygulaması ise) yükler. 

• .Net core - uygulama .NET Core gerektiriyorsa .NET Core İndirmelerinde .NET Core 
çalışma zamanı yükleyicisini edinip çalıştırın. Tam SDK 'Yı sunucuya yüklemeyin. 

• .NET Framevvork - uygulama .NET Framevvork gerektiriyorsa, .NET Framevvork yükleme 
kılavuzunabakın. Gerekli .NET Framevvork yüklemesi. En son .NET Framevvork yükleyicisi 
.NET Core indirmeleri sayfasından edinilebilir. 

Uygulama, kendi içinde bir dağıtımise, uygulama çalışma zamanını dağıtımda içerir. Sunucuda 
çerçeve yüklemesi gerekmez. 

5. Uygulamada URL 'Leri ve bağlantı noktalarını yapılandırın. 

Varsayılan olarak, ASP.NET Core http://iocaihost : 500 e bağlar. URL öneklerini ve bağlantı 
noktalarını yapılandırmak için seçenekler şunları içerir: 

• UseUrls 

• urls komut satırı bağımsız değişkeni 

• aspnetcore_urls ortam değişkeni 

• UrlPrefixes 

Aşağıdaki kod örneği, UrlPrefixes bağlantı noktası 443 1 de sunucunun yerel İP adresi 
10 . 0 . 0.4 nasıl kullanılacağını gösterir: 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

. Conf igurel/JebHostDef aults (webBuilder => 

{ 

webBuilder.UseHttpSys(options => 

{ 

options.UrlPrefixes.Add("https://10.0.0.4:443"); 

}); 

webBuilder.UseStartup<Startup>(); 

}); 

public static IWebHostBuilder CreateWebHostBuilder(string[] angs) => 

1/JebHost .CreateDefaultBuilder(args) 

.UseStantup<Stantup>() 

.UseHttpSys(options => 

{ 

options.UrlPrefixes.Add("https://10.0.0.4:443"); 

}); 

uriPrefixes avantajı, hatalı biçimlendirilen ön ekler için hemen bir hata iletisi oluşturulmasından 
oluşur. 

uniPnefixes geçersiz kılma UseUrls / urls /ayarları, aspnetcorejjrls Bu nedenle, UseUrls , urls ve 
aspnetcore_urls ortam değişkeninin bir avantajı, Kestrel ve HTTP, sys arasında geçiş yapmak daha 
kolay olabilir. 

HTTP, sys, http sunucusu API UrlPrefix dize biçimlerinikullanır. 





VVARNING 

Üst düzey joker bağlamaları ( http://*: 80 / ve http ://+:80 ) gereken değil kullanılır. Üst düzey joker 
karakter bağlamaları uygulama güvenliği güvenlik açıklarını oluşturur. Bu, güçlü ve zayıf joker karakterler için 
geçerlidir. Joker karakterler yerine açık konak adlarını veya İP adreslerini kullanın. Alt etki alanı joker bağlantısı 
(örneğin, ».mysub.com ), tüm üst etki alanını (güvenlik açığı olan *.com aksine) kontrol ediyorsanız bir 
güvenlik riski değildir. Daha fazla bilgi için bkz. RFC 7230: bölüm 5,4: Hoşt. 


1. Ön ek, sunucudaki URL öneklerini ister. 

HTTP, sys 1 yi yapılandırmaya yönelik yerleşik araç netsh. exe‘ dir. netsh. exe , URL öneklerini 
ayırmak ve X. 509.440 sertifikaları atamak için kullanılır. Araç, yönetici ayrıcalıkları gerektirir. 

Uygulamanın URL 'Lerini kaydettirmek için netsh. exe aracını kullanın: 

netsh http add urlacl url=<URL> user=<USER> 

• tam nitelikli Tekdüzen Kaynak Konumlandırıcı (URL) - <url> .Joker karakter bağlama 
kullanmayın. Geçerli bir ana bilgisayar adı veya yerel İP adresi kullanın. URL, sondaki eğik 
çizgi içermelidir. 

• <user> - Kullanıcı veya Kullanıcı grubu adını belirtir. 

Aşağıdaki örnekte, sunucusunun yerel İP adresi 10.0.0.4 : 

netsh http add urlacl url=https://10.0.0.4:443/ user=Users 

Bir URL kaydedildiğinde, araç url reservation successfuliy added ile yanıt verir. 

Kayıtlı bir URL 'yi silmek için delete urlacl komutunu kullanın: 

netsh http delete urlacl url=<URL> 

2. X. 509.440 sertifikalarını sunucusuna kaydedin. 

Uygulamanın sertifikalarını kaydetmek için netsh. exe aracını kullanın: 

netsh http add sslcert ipport=<IP>:<PORT> certhash=<THUMBPRINT> appid="{<GUID>}" 

• <ip> bağlamanın yerel İP adresini belirtir. Joker karakter bağlama kullanmayın. Geçerli 
bir İP adresi kullanın. 

• <port> - bağlama yönelik bağlantı noktasını belirtir. 

• X. 509.440 sertifikası parmak izini - <thumbprint> . 

• <guid> , uygulamayı bilgilendirme amacıyla temsil eden bir geliştirici tarafından üretilen 
GUID-. 

Başvuru amacıyla, GUID 'yi uygulamada bir paket etiketi olarak depolayın: 

• Visual Studio'da: 

o Çözüm Gezgini ' de uygulamaya sağ tıklayıp Özellikler' i seçerek uygulamanın 
proje özelliklerini açın, 
o Paket sekmesini seçin. 

o Etiketler alanında oluşturduğunuz GUID 'yi girin. 

• Visual Studio kullanmadığınız durumlarda: 















o Uygulamanın proje dosyasını açın. 


o Oluşturduğunuz GUID ile yeni veya mevcut bir <PropertyGroup> <PackageTags> 
özelliği ekleyin: 

<PropertyGroup> 

<PackageTags>9412ee86-c21b-4eb8-bd89-f650fbf44931</PackageTags> 

</PropertyGroup> 

Aşağıdaki örnekte: 

• Sunucunun yerel İP adresi 10.0.0.4. 

• Çevrimiçi rastgele bir GUID Oluşturucusu appid değeri sağlar. 

netsh http add sslcert 
ipport=10.0.0.4:443 

Certhash=b66ee04419d4ee37464ab8785ff02449980eael0 
appid="{9412ee86-c21b-4eb8-bd89-f650fbf44931}" 

Bir sertifika kaydedildiğinde, araç ssl Certificate successfuliy added ile yanıt verir. 

Bir sertifika kaydını silmek için delete sslcert komutunu kullanın: 

netsh http delete sslcert ipport=<IP>:<PORT> 

Netsh. exeiçin başvuru belgeleri: 

• Köprü Metni Aktarım Protokolü (HTTP) için Netsh komutları 

• UrlPrefix dizeleri 
3 . Uygulamayı çalıştırın. 

1024 'den büyük bir bağlantı noktası numarası ile HTTP (HTTPS değil) kullanarak localhost 'a 
bağlanırken uygulamayı çalıştırmak için yönetici ayrıcalıklarına gerek yoktur. Diğer 
yapılandırmalarda (örneğin, yerel bir İP adresi veya 443 numaralı bağlantı noktasına bağlama), 
uygulamayı yönetici ayrıcalıklarıyla çalıştırın. 

Uygulama, sunucunun genel İP adresinde yanıt verir. Bu örnekte, sunucuya 104.214.79.47 
genel İP adresinde İnternete ulaşıldı. 

Bu örnekte bir geliştirme sertifikası kullanılır. Tarayıcının güvenilmeyen sertifika uyarısı 
atlandıktan sonra sayfa güvenli bir şekilde yüklenir. 
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Server Addresses 


Hello VVorld from the HTTP.sys Demo! 


HTTP.sys Demo 
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Ara sunucu ve yük dengeleyici senaryoları 


Internet veya şirket ağından gelen isteklerle etkileşime geçen HTTP, sys tarafından barındırılan 
uygulamalar için, proxy sunucularının ve yük dengeleyiciler ’nin arkasında barındırılırken ek 
yapılandırma gerekebilir. Daha fazla bilgi için proxy sunucuları ile çalışma ve yük Dengeleyiciler için 
ASP.NET Coreyapılandırma. 


Ek kaynaklar 


• HTTP, sys ile VVİndovvs kimlik doğrulamasını etkinleştirme 

• HTTP Sunucusu API 'SI 

• ASPNET/HttpSysServer GitHub deposu (kaynak kodu) 

• Ana bilgisayar 

• ASP.NET Core projeleri sorunlarını giderme 











VVindovvs hizmetinde konak ASPNET Core 

6.11.2019 • 17 minutes to read ı Edit Online 


Luke Latham tarafından 

Bir ASP.NET Core uygulaması, 11S kullanmadan VVindovvs hizmeti olarak VVindovvs üzerinde barındırılabilir. 
VVindovvs hizmeti olarak barındırıldığı zaman, uygulama otomatik olarak sunucu yeniden başlatıldıktan sonra 
başlatılır. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Prerequisites 

• ASP.NET Core SDK 2,1 veya üzeri 

• PovverShell 6,2 veya üzeri 

Çalışan hizmeti şablonu 

ASP.NET Core VVorker hizmeti şablonu, uzun süre çalışan hizmet uygulamalarını yazmak için bir başlangıç 
noktası sağlar. Şablonu bir VVindovvs Hizmeti uygulamasının temeli olarak kullanmak için: 

1. .NET Core şablonundan bir çalışan hizmeti uygulaması oluşturun. 

2. Çalışan hizmeti uygulamasını bir VVindovvs hizmeti olarak çalışacak şekilde güncelleştirmek için uygulama 
yapılandırma bölümündeki yönergeleri izleyin. 

• Visual Studio 

• Mac için Visual Studio 

• .NET Core CLI 

1. Yeni bir proje oluşturun. 

2. Çalışan hizmetiseçin. İleri ' yiseçin. 

3. Proje adı alanında bir proje adı girin veya varsayılan proje adını kabul edin. Oluştur' u seçin. 

4. Yeni çalışan hizmeti oluştur İletişim kutusunda Oluştur' u seçin. 

Uygulama yapılandırması 

Uygulama, Microsoft. Extensions. Hosting. VVİndovvsServicesiçin bir paket başvurusu gerektirir. 

iHostBuiider.useiAiindoiA/sService ana bilgisayar oluşturulurken çağrılır. Uygulama bir VVindovvs hizmeti olarak 
çalışıyorsa, yöntemi: 

• Ana bilgisayar ömrünü windowsServiceLifetime olarak ayarlar. 

• içerik kökünüayarlar. 

• Varsayılan kaynak adı olarak uygulama adı ile olay günlüğüne günlük kaydını sağlar. 

o Günlük düzeyi, appSettings 'de Logging:LogLevei:Defauit anahtarı kullanılarak yapılandırılabilir. 
Production. JSON dosyası. 

o Yeni olay kaynakları yalnızca yöneticiler tarafından oluşturulabilir. Uygulama adı kullanılarak bir olay 
kaynağı oluşturuoluşturumadığında, uygulama kaynağına bir uyarı kaydedilir ve olay günlükleri devre 
dışı bırakılır. 


Program.CS CreateHostBuilder : 







Hoşt.CreateDefaultBuilder(args) 

.UseWindowsService() 

Aşağıdaki örnek uygulamalar bu konuya eşlik eder: 

• Arka plan çalışan hizmeti örneği, arka plan görevleri için barındırılan Hizmetleri kullanan çalışan hizmeti 
şablonunu temel alan, Web olmayan bir uygulama örneğini 

• Web App Service örneği, arka plan görevleri için barındırılan hizmetlerle Windows hizmeti olarak çalışan bir 
Razor pages Web uygulaması örneği 

MVC Kılavuzu için ASP.NET Core MVC'ye Genel Bakış ve ASP.NET Core 2,2 1 den 3,0 1 e geçiş yapınaltındaki 
makalelere bakın. 

Uygulama Microsoft. AspNetCore. Hosting. WindowsServices ve Microsoft. Extensions. Logging. EventLogiçin 
paket başvuruları gerektirir. 

Bir hizmetin dışında çalışırken test ve hata ayıklamak için, uygulamanın bir hizmet olarak mı yoksa bir konsol 
uygulaması mi çalıştığını belirleme kodu ekleyin. Hata ayıklayıcının ekli olduğunu veya bir --console anahtarının 
mevcut olup olmadığını denetleyin. Her iki koşul de geçerliyse (uygulama bir hizmet olarak çalıştırıImadıysa) Run ' 
ı çağırın. Koşullar yanlışsa (uygulama bir hizmet olarak çalıştırılır): 

• SetCurrentDirectory çağırın ve uygulamanın yayımlanan konumunun yolunu kullanın. Bir Windows hizmeti 
uygulaması, GetCurrentDirectory çağrıldığında C:\windows\system32 klasörünü döndürdüğünden yolu almak 
için GetCurrentDirectory çağırmayın. Daha fazla bilgi için geçerli dizin ve içerik kökü bölümüne bakın. Bu adım, 
uygulama createwebHostBuiider ' da yapılandırılmadan önce gerçekleştirilir. 

• Uygulamayı bir hizmet olarak çalıştırmak için RunAsService çağrısı yapın. 

Komut satırı yapılandırma sağlayıcısı komut satırı bağımsız değişkenleri için ad-değer çiftleri gerektirdiğinden, 
CreateDefaultBuilder bağımsız değişkenleri almadan önce --console anahtarı bağımsız değişkenlerden kaldırılır. 

Windows olay günlüğü 'ne yazmak için, EventLog sağlayıcısını ConfigureLogging ' a ekleyin. Günlük kaydı 
düzeyini appSettings 'de Logging :LogLevei: Def auit anahtarıyla ayarlayın. Product'ıon. JSON dosyası. 

Örnek uygulamadan aşağıdaki örnekte, uygulamadaki ömür olaylarını işlemek için RunAsService yerine 
RunAsCustomService çağrılır. Daha fazla bilgi için olayları başlatma ve durdurma olaylarını inceleyin bölümüne 
bakın. 








public class Program 

{ 

public static void Main(string[] args) 

{ 

var isService = !(Debugger.IsAttached || args.Contains("--console")); 

if (isService) 

{ 

var pathToExe = Process.GetCurrentProcess().MainModule.FileName; 
var pathToContentRoot = Path.GetDirectoryName(pathToExe); 
Directory.SetCurrentDirectory(pathToContentRoot); 

} 

var builder = CreateWebHostBuilder( 

args.Where(arg => arg != "--console").ToArray()); 

var hoşt = builder.Build(); 

if (isService) 

{ 

// To run the app without the CustomWebHostService change the 
// next line to host.RunAsService(); 
hoşt.RunAsCustomService(); 

} 

else 

{ 

host.Run(); 

} 

} 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 
WebHost.CreateDefaultBuilder(args) 

.ConfigureLogging((hostingContextj logging) => 

{ 

logging.AddEventLog(); 

}) 

.ConfigureAppConfiguration((context, config) => 

{ 

// Configure the app here. 

}) 

.UseStartup<Startup>(); 


Dağıtım türü 

Dağıtım senaryoları hakkında bilgi ve öneriler için bkz. .NET Core uygulama dağıtımı. 

SDK 

Razor Pages veya MVC çerçevelerini kullanan bir Web uygulaması tabanlı hizmet için, proje dosyasında Web SDK 
'sini belirtin: 

<Project Sdk="Microsoft.NET.Sdk.Web"> 

Hizmet yalnızca arka plan görevlerini (örneğin, barındırılan hizmetler) yürütülüyorsa, proje dosyasında çalışan 
SDK 'sim belirtin: 

<Project Sdk="Microsoft.NET.Sdk.Worker"> 

Çerçeveye bağımlı dağıtım (FDD) 

Çerçeveye bağımlı dağıtım (FDD), hedef sistemde .N ET Core 'un paylaşılan sistem genelindeki bir sürümünün 






varlığına dayanır. Bu makaledeki kılavuzdan sonra FDD senaryosu benimsendiği zaman SDK, çerçeveye bağlı 
yürütülebilir c/osyoolarak adlandırılan yürütülebilir bir dosya (. exe) oluşturur. 

Web SDKkullanıyorsanız, normalde bir ASP.NET Core uygulaması yayımlarken üretilen bir Web. corıfig dosyası 
Windows Hizmetleri uygulaması için gereksizdir. Web. corıfig dosyasının oluşturulmasını devre dışı bırakmak için 
<isTransformwebConfigDisabied> özelliğini true olarak ayarlayın. 

<PropertyGroup> 

<TargetFramework>netcoreapp3.0</TargetFramework> 

<IsTransformWebConfigDisabled>true</IsTransformWebConfigDisabled> 

</PropertyGroup> 


Windows çalışma zamanı tanımlayıcısı (RID) (<runtimeıdentifier >), hedef Framevvork 'ü içerir.Aşağıdaki örnekte, 
RID win 7 -x 64 olarak ayarlanmıştır. <seifContained> özelliği faise olarak ayarlanır. Bu özellikler SDK'nın 
Windows için bir yürütülebilir (. exe) dosya ve paylaşılan .N ET Core çerçevesine bağlı bir uygulama oluşturmasını 
ister. 

Bir ASP.NET Core uygulaması yayımlandığında normalde üretilen bir Web. config dosyası, Windows Hizmetleri 
uygulaması için gereksizdir. Web. config dosyasının oluşturulmasını devre dışı bırakmak için 
<isTransformwebConfigDisabied> özelliğini true olarak ayarlayın. 

<PropertyGroup> 

<TargetFramework>netcoreapp2.2</TargetFramework> 

<RuntimeIdentifier>win7-x64</RuntimeIdentifier> 

<SelfContained>false</SelfContained> 

<IsTransformWebConfigDisabled>true</IsTransformWebConfigDisabled> 

</PropertyGroup> 


Windows çalışma zamanı tanımlayıcısı (RID) (<runtimeıdentifier >), hedef Framevvork 'ü içerir.Aşağıdaki örnekte, 
RID win 7 -x 64 olarak ayarlanmıştır. <seifContained> özelliği faise olarak ayarlanır. Bu özellikler SDK'nın 
Windows için bir yürütülebilir (. exe) dosya ve paylaşılan .N ET Core çerçevesine bağlı bir uygulama oluşturmasını 
ister. 

<useAppHost> özelliği true olarak ayarlanır. Bu özellik, bir FDD için bir etkinleştirme yolu (yürütülebilir,. exe) ile 
hizmeti sağlar. 

Bir ASP.NET Core uygulaması yayımlandığında normalde üretilen bir Web. config dosyası, Windows Hizmetleri 
uygulaması için gereksizdir. Web. config dosyasının oluşturulmasını devre dışı bırakmak için 
<isTransformwebConfigDisabied> özelliğini true olarak ayarlayın. 

<PropertyGroup> 

<TargetFramework>netcoreapp2.2</TargetFramework> 

<RuntimeIdentifier>win7-x64</RuntimeIdentifier> 

<UseAppHost>true</UseAppHost> 

<SelfContained>false</SelfContained> 

<IsTransformWebConfigDisabled>true</IsTransformWebConfigDisabled> 

</PropertyGroup> 


Kendi içinde dağıtım (SCD) 

Kendinden bağımsız dağıtım (SCD), ana bilgisayar sisteminde paylaşılan bir Framevvork varlığına güvenmez. 
Çalışma zamanı ve uygulamanın bağımlılıkları uygulamayla birlikte dağıtılır. 

Hedef Framevvork 'ü içeren <PropertyGroup> ' de bir VVİndovvs çalışma zamanı tanımlayıcısı (RID) bulunur: 

<RuntimeIdentifier>win7-x64</RuntimeIdentifier> 




















Birden çok RID için yayımlamak için: 


• RID 'leri, noktalı virgülle ayrılmış bir liste olarak belirtin. 

• <Runtimetanymlayycytanımlayıcıları > (plural) için özellik adını kullanın. 

Daha fazla bilgi için bkz. .NET Core RID katalogu. 

<seifContained> Özellik true olarak ayarlanır: 

<SelfContained>true</SelfContained> 


Hizmet Kullanıcı hesabı 

Bir hizmet için Kullanıcı hesabı oluşturmak için, bir yönetim PovverShell 6 komut kabuğundan New-LocalUser 
cmdlet 'ini kullanın. 

Windows 10 Ekim 2018 Güncelleştirmesi (sürüm 1809/Build 10.0.17763) veya sonraki sürümler: 

New-LocalUser -Name {NAME} 

Windows 10 Ekim 2018 (sürüm 1809/Build 10.0.17763) sürümünden önceki VVİndovvs İŞLETİM sistemlerinde: 

powershell -Command "New-LocalUser -Name {NAME}" 
istendiğinde güçlü bir parola sağlayın. 

-AccountExpires parametresi New-LocalUser cmdlet 'ine bir süre sonu DateTimesağlanmamışsa hesabın süresi 
dolmaz. 

Daha fazla bilgi için bkz. Microsoft. PovverShell. LocalAccounts ve hizmet Kullanıcı hesapları. 

Active Directory kullanırken kullanıcıları yönetmeye yönelik alternatif bir yaklaşım, yönetilen hizmet hesaplarını 
kullanmaktır. Daha fazla bilgi için bkz. Grup yönetilen hizmet hesaplarına genel bakış. 

Hizmet hakları olarak oturum açma 

Hizmet Kullanıcı hesabı için hizmet haklarL olarak oturum açma oluşturmak için: 

1. Yerel Güvenlik İlkesi düzenleyicisini, secpol. msc' i çalıştırarak açın. 

2. Yerel ilkeler düğümünü genişletin ve Kullanıcı hakları ataması' nı seçin. 

3. Hizmet olarak oturum açma ilkesi açın. 

4. Kullanıcı veya Grup Ekle' yi seçin. 

5. Aşağıdaki yaklaşımlardan birini kullanarak nesne adını (Kullanıcı hesabı) sağlayın: 

a. Kullanıcı hesabını ( {domain or Computer name\user} ) nesne adı alanına yazın ve kullanıcıyı ilkeye 
eklemek için Tamam ' ı seçin. 

b. Gelişmiş' i seçin. Şimdi bul' u seçin. Listeden Kullanıcı hesabını seçin. Tamam ' ıseçin. Kullanıcıyı 
ilkeye eklemek için yeniden Tamam 1 ı seçin. 

6. Değişiklikleri kabul etmek için Tamam 1 ı veya Uygula ' yı seçin. 

VVİndovvs hizmetini oluşturma ve yönetme 

Hizmet oluşturma 

Bir hizmeti kaydetmek için PovverShell komutlarını kullanın. Bir yönetim PovverShell 6 komut kabuğundan 








aşağıdaki komutları yürütün: 


$acl = Get-Acl "{EXE PATH}" 

ŞaclRuleArgs = {DOMAIN OR COMPUTER NAME\USER}, "ReadjNrite,ReadAndExecute ", "ContainerlnheritjObjectlnherit", 
"None", "Allow" 

JaccessRule = New-Object System.Security.AccessControl.FileSystemAccessRule($aclRuleArgs) 

$acl.SetAccessRule($accessRule) 

$acl | Set-Acl "(EXE PATH}" 

New-Service -Name {NAME} -BinaryPathName {EXE FİLE PATH} -Credential {DOMAIN OR COMPUTER NAME\USER} - 
Description "{DESCRIPTION}" -DisplayName "{DISPLAY NAME}" -StartupType Automatic 

• Ana bilgisayardaki uygulamanın klasörünün yolunu - {exe path} (örneğin, d:\myservice ). Uygulamanın 


yürütülebilir dosyasını yola eklemeyin. Sondaki eğik çizgi gerekli değildir. 

• {DOMAIN OR COMPUTER NAME\USER} - hizmet Kullanıcı hesabı (örneğin, Contoso\ServiceUser ). 

• {name} - hizmet adı (örneğin, MyService ). 


• 

{EXE FİLE PATH} 

- uygulamanın yürütülebilir yolu (örneğin, 

d:\myservice\myservice.exe ). Yürütülebilir 


dosyanın dosya adını uzantısına ekleyin. 


• 

{DESCRIPTION} - 

- hizmet açıklaması (örneğin, My sample service). 

• 

{DISPLAY NAME} 

- hizmet görünen adı (örneğin, My service ] 



Hizmet başlatma 

Aşağıdaki PovverShell 6 komutuyla bir hizmet başlatın: 

Start-Service -Name {NAME} 

Komutun başlatılması birkaç saniye sürer. 

Hizmetin durumunu belirleme 

Bir hizmetin durumunu denetlemek için aşağıdaki PowerShell 6 komutunu kullanın: 

Get-Service -Name {NAME} 

Durum, aşağıdaki değerlerden biri olarak bildirilir: 

• Starting 

• Running 

• Stopping 

• Stopped 

Bir hizmeti durdur 

Aşağıdaki PovverShell 6 komutuyla bir hizmeti durdurun: 

Stop-Service -Name {NAME} 

Hizmeti Kaldır 

Bir hizmeti durdurmak için kısa bir gecikmeden sonra, aşağıdaki PovverShell 6 komutuyla bir hizmeti kaldırın: 

Remove-Service -Name {NAME} 


Olayları başlatma ve durdurma olaylarını işleme 















OnStarting, OnStartedve OnStopping olaylarını işlemek için: 

1. OnStarting, OnStartedve OnStopping yöntemlerle VVebHostService türetilen bir sınıf oluşturun: 

[DesignerCategory("Code")] 

internal class Customl/debHostService : WebHostService 

{ 

private ILogger _logger; 

public CustomWebHostService(IWebHost hoşt) : base(host) 

{ 

_logger = hoşt.Services 

.GetRequiredService<ILogger<CustomWebHostService>>(); 

} 

protected override void OnStarting(string[] args) 

{ 

_logger.LogInformation("OnStarting method called."); 
base.OnStarting(args); 

} 

protected override void OnStarted() 

{ 

_logger.LogInformation("OnStarted method called."); 
base.OnStarted(); 

} 

protected override void OnStoppingO 

{ 

_logger.LogInformation("OnStopping method called."); 
base.OnStopping(); 

} 

} 

2. Run customwebHostservice ileten IWebHost için bir genişletme yöntemi oluşturun: 

public static class WebHostServiceExtensions 

{ 

public static void RunAsCustomService(this IklebHost hoşt) 

{ 

var webHostService = new CustomWebHostService(host); 

ServiceBase.Run(webHostService); 

} 

} 

3. Program.Main ' de, RunAsServiceyerine RunAsCustomService uzantısı metodunu çağırın: 

hoşt.RunAsCustomService(); 

Program.Main RunAsService konumunu görmek için, dağıtım türü bölümünde gösterilen kod örneğine 
bakın. 

Proxy sunucusu ve yük dengeleyici senaryoları 

Internet 'ten veya şirket ağından gelen isteklerle etkileşime geçen ve bir ara sunucu veya yük dengeleyicinin 
arkasındaki Hizmetler ek yapılandırma gerektirebilir. Daha fazla bilgi için bkz. Proxy sunucularıyla ve yük 
dengeleyicilerle çalışacak AS P.N ET Core yapılandırma. 


Uç noktaları yapılandırma 






Varsayılan olarak, ASP.NET Core http://iocaihost:500e 1 a bağlanır. aspnetcore_urls ortam değişkenini 
ayarlayarak URL 'Yİ ve bağlantı noktasını yapılandırın. 

Ek URL ve bağlantı noktası yapılandırma yaklaşımları için ilgili sunucu makalesine bakın: 

• ASP.NET Core Web sunucusu uygulamasını Kestrel 

• ASP.NET Core 'de HTTP, sys Web sunucusu uygulama 

Yukarıdaki kılavuz, HTTPS uç noktaları için desteği içerir.Örneğin, bir VVİndovvs hizmeti ile kimlik doğrulaması 
kullanıldığında HTTPS için uygulamayı yapılandırın. 

NOTE 

Hizmet uç noktasının güvenliğini sağlamak için ASP.NET Core HTTPS geliştirme sertifikası kullanılması desteklenmez. 


Geçerli dizin ve içerik kökü 

Bir VVİndovvs hizmeti için GetCurrentDirectory çağırarak döndürülen geçerli çalışma dizini C:\windows\system32 
klasörüdür. System32 klasörü, bir hizmetin dosyalarını (örneğin, ayarlar dosyaları) depolamak için uygun bir 
konum değildir. Bir hizmetin varlık ve ayar dosyalarını sürdürmek ve erişmek için aşağıdaki yaklaşımlardan birini 
kullanın. 

ContentRootPath veya ContentRootFileProvider kullanın 

Bir uygulamanın kaynaklarını bulmak için ıhostenvironment. ContentRootPath veya ContentRootFileProvider 
kullanın. 

Uygulamanın klasörü için içerik kök yolunu ayarla 

ContentRootPath, bir hizmet oluşturulduğunda binPath bağımsız değişkenine sunulan yoldur. Ayar dosyalarına 
yollar oluşturmak için GetCurrentDirectory çağırmak yerine, uygulamanın içerik kökününyolunu kullanarak 

SetCurrentDirectory çağırın. 

Program.Main , hizmetin yürütülebilir dosyasının yolunu belirleyin ve uygulamanın içerik kökünü oluşturmak için 
yolu kullanın: 

var pathToExe = Process.GetCurrentProcess().MainModule.FileName; 
var pathToContentRoot = Path.GetDirectoryName(pathToExe); 

Directory.SetCurrentDirectory(pathToContentRoot); 

CreateWebHostBuilder(args) 

.Build() 

.RunAsService(); 

Hizmetin dosyalarını diskte uygun bir konumda depolayın 

Dosyaları içeren klasöre IConfigurationBuilder kullanırken SetBasePath ile mutlak bir yol belirtin. 

Ek kaynaklar 

• Kestrel uç noktası yapılandırması (https yapılandırması ve SNI desteği içerir) 

• .N ET genel ana bilgisayar 

• ASP.NET Core projeleri sorunlarını giderme 

• Kestrel uç noktası yapılandırması (https yapılandırması ve SNI desteği içerir) 

• ASP.NET Core Web ana bilgisayarı 

• ASP.NET Core projeleri sorunlarını giderme 
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, Sourabh Shirhatti 

Bu kılavuzda Ubuntu 16,04 sunucusunda üretime hazır ASP.NET Core ortamı ayarlama açıklanmaktadır. Bu 
yönergeler büyük olasılıkla Ubuntu 'ın daha yeni sürümleriyle çalışır, ancak yönergeler daha yeni sürümlerle 
sınanmamıştır. 

AS P.N ET Core tarafından desteklenen diğer Linux dağıtımları hakkında daha fazla bilgi için bkz. Linux üzerinde 
.NET Core önkoşulları. 


NOTE 

Ubuntu 14,04 için, Kestrel işlemini izlemeye yönelik bir çözüm olarak supervisof önerilir, systemd , Ubuntu 14,04 ' de 
kullanılamaz. Ubuntu 14,04 yönergeleri için Bu konunun önceki sürümünebakın. 


Bu kılavuz: 

• Mevcut bir AS P.N ET Core uygulamasını bir ters proxy sunucusunun arkasına koyar. 

• istekleri Kestrel Web sunucusuna iletmek için ters proxy sunucusunu ayarlar. 

• Web uygulamasının, bir arka plan programı olarak başlangıcında çalışmasını sağlar. 

• Web uygulamasını yeniden başlatmanıza yardımcı olması için bir işlem yönetim aracı yapılandırır. 

Prerequisites 

1. Sudo ayrıcalığına sahip standart bir kullanıcı hesabı ile Ubuntu 16,04 sunucusuna erişim. 

2. .NET Core çalışma zamanını sunucuya yükler. 

a. .Net çekirdeğini indir sayfasınıziyaret edin. 

b. En son Önizleme olmayan .NET Core sürümünü seçin. 

c. Uygulama çalıştırma-çalışma zamanıaltındaki tabloda en son önizleme dışı çalışma zamanını 
indirin. 

d. Linux Paket Yöneticisi yönergeleri bağlantısını seçin ve Ubuntu sürümünüz İçin Ubuntu 
yönergelerini izleyin. 

3. MevcutbirASP.NET Core uygulaması. 

Paylaşılan Framevvork 'ü yükselttikten sonra gelecekte herhangi bir noktada, sunucu tarafından barındırılan 
ASP.NET Core uygulamaları yeniden başlatın. 

Uygulama üzerinde Yayımla ve Kopyala 

Uygulamayı çerçeveye bağımlı bir dağıtım içi n yapılandırın. 

Uygulama yerel olarak çalıştırılır ve güvenli bağlantı (HTTPS) yapmak üzere yapılandırılmamışsa aşağıdaki 
yaklaşımlardan birini benimseyin: 

• Uygulamayı güvenli yerel bağlantıları işleyecek şekilde yapılandırın. Daha fazla bilgi için https yapılandırma 
bölümüne bakın. 





• Properties/launchSettings. JSON dosyasındaki appiicationUri özelliğinden https://iocaihost :500ı (varsa) 
kaldırın. 

Bir uygulamayı sunucuda çalışabilecek bir dizine (örneğin, bin/Release/<target_framework_moniker>/Pubiish) 
paketlemek için geliştirme ortamından DotNet Publish çalıştırın: 

dotnet publish --configuration Release 

Uygulama, sunucuda .NET Core çalışma zamanının bakımını yapmayı tercih ediyorsanız, kendi kendine içerilen 
bir dağıtım olarak da yayımlanabilir. 

ASP.NET Core uygulamasını, kuruluşun iş akışını (örneğin, SCP, SFTP) tümleştiren bir aracı kullanarak sunucuya 
kopyalayın. Var dizini altında Web uygulamalarının (örneğin, var/www/HelloApp ) yerini bulmak yaygındır. 


NOTE 

Bir üretim dağıtım senaryosunda, sürekli tümleştirme iş akışı, uygulamayı yayımlama ve varlıkları sunucuya kopyalama işini 
yapar. 


Uygulamayı test etme: 

1 . Komut satırından uygulamayı çalıştırın: dotnet <app_assembiy>.diı . 

2 . Bir tarayıcıda, uygulamanın Linux 'ta yerel olarak çalıştığını doğrulamak için http://<serveraddress>:<port> 1 
a gidin. 

Ters proxy sunucu yapılandırma 

Ters proxy, dinamik Web uygulamaları sunmak için ortak bir kurulumtir.Ters proxy, HTTP isteğini sonlandırır ve 
ASP.NET Core uygulamasına iletir. 

Ters proxy sunucusu kullanma 

Kestrel, ASP.NET Core 1 den dinamik içerik sunmak için harika. Ancak, Web 'e sunma özellikleri US, Apache veya 
NGINX gibi sunucu olarak zengin özellik değildir. Ters bir ara sunucu, statik içerik sunma, istekleri önbelleğe 
alma, istekleri sıkıştırma ve HTTP sunucusundan HTTPS sonlandırması gibi işleri devreedebilir. Ters ara sunucu, 
ayrılmış bir makinede bulunabilir veya bir HTTP sunucusu ile birlikte dağıtılabilir. 

Bu kılavuzun amaçları doğrultusunda, tek bir NGINX örneği kullanılmıştır.Bu, HTTP sunucusu ile birlikte aynı 
sunucuda çalışır. Gereksinimlere bağlı olarak, farklı bir kurulum seçilebilir. 

İstekler ters proxy tarafından iletileceği için, Microsoft. AspNetCore. HttpOverrides paketindeki İletilen üstbilgiler 
ara yazılımını kullanın. Ara yazılım, x-Forwarded-Proto üst bilgisini kullanarak Request.scheme güncelleştirir, 
böyleceyeniden yönlendirme URI 'Leri ve diğer güvenlik ilkeleri doğru çalışır. 

Bir şemaya bağlı kimlik doğrulama, bağlantı oluşturma, yeniden yönlendirme ve coğrafi konum gibi herhangi bir 
bileşen, İletilen üstbilgiler ara yazılımı çağrıldıktan sonra yerleştirilmelidir. Genel bir kural olarak, İletilen 
üstbilgiler ara yazılımı, tanılama ve hata işleme ara yazılımı dışında diğer ara yazılım ile önce çalışmalıdır. Bu 
sıralama, iletilen üst bilgi bilgilerine bağlı olan ara yazılımın işleme için üst bilgi değerlerini kullanmasını sağlar. 

UseAuthentication veya benzer kimlik doğrulama düzeni ara yazılımını çağırmadan önce startup.configure 
UseForvvardedHeaders yöntemi çağırın. x-Forwarded-For ve x-Forwarded-Proto üstbilgilerini iletmek için ara 
yazılımı yapılandırın: 











app.UseForwardedHeaders(new ForwardedHeadersOptions 
{ 

ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto 

}); 

app.UseAuthentication(); 

Ara yazılım için ForwardedHeadersOptions belirtilmemişse, iletmek için varsayılan üstbilgiler None . 

Standart localhost adresi (127.0.0.1) dahil olmak üzere geri döngü adreslerinde çalışan proxy 1er (127.0.0.0/8, [:: 
1]), varsayılan olarak güvenilirdir. Kuruluş içindeki diğer güvenilir proxy 1er veya ağlar, Internet ve Web sunucusu 
arasında istekleri ele alıyorsa, bunları ForwardedHeadersOptionsKnownProxies veya KnownNetworks listesine 
ekleyin. Aşağıdaki örnek, alana 10.0.0.100 adresindeki İletilen üstbilgiler ara sunucusuna 
startup.configureServices''KnownProxies İP adresinde bir güvenilen ara sunucu ekler: 

Services.Configure<ForwardedHeadersOptions>(options => 

{ 

options.KnownProxies.Add(IPAddress.Parse("10.0.0.100")); 

}); 

Daha fazla bilgi için bkz. Proxy sunucularıyla ve yük dengeleyicilerle çalışacak ASP.NET Core yapılandırma. 

NGINX 1 yükler 

NGINX yüklemek için apt-get kullanın. Yükleyici, sistem başlangıcında arka plan programı olarak NGINX 
çalıştıran bir systemd init betiği oluşturur. NGINX: resmi deni/Ubuntu paketlerindellbuntu yükleme 
yönergelerini izleyin. 


NOTE 

İsteğe bağlı NGINX modülleri gerekliyse, kaynaktan NGINX oluşturulması gerekebilir. 


NGINX ilk kez yüklendiğinden bu yana şunu çalıştırarak açık olarak başlatın: 

sudo service nginx start 

Bir tarayıcının NGINX için varsayılan giriş sayfasını görüntülediğini doğrulayın. Giriş sayfasına 
http://<server_IP_address>/index.nginx-debian.html adresinden ulaşılabilir. 

NGINX 1 yapılandırma 

İstekleri ASP.NET Core uygulamanıza iletmek için NGINX 1 ters proxy olarak yapılandırmak için 
/etc/nginx/sites-available/clefaultdeg\şt\rin. Bu dosyayı bir metin düzenleyicisinde açın ve içeriği şu şekilde 
değiştirin: 








server { 


listen 80; 


server_name example. 

com *. example.com; 

location / { 


proxy_pass 

http://localhost:5000; 

proxy_http_version 

ı.i; 

proxy_set_header 

Upgrade $http_upgrade; 

proxy_set_header 

Connection keep-alive; 

proxy_set_header 

Hoşt $host; 

proxy_cache_bypass 

$http_upgrade; 

proxy_set_header 

X-Forwarded-For $proxy_add_x_forwarded_for; 

proxy_set_header 

X-Forwarded-Proto Şscheme; 

} 


} 



server_name eşleştiğinde NGINX varsayılan sunucuyu kullanır.Varsayılan sunucu tanımlanmazsa, yapılandırma 
dosyasındaki ilk sunucu varsayılan sunucusudur. En iyi uygulama olarak, yapılandırma dosyanızda 444 durum 
kodunu döndüren belirli bir varsayılan sunucu ekleyin. Varsayılan bir sunucu yapılandırma örneği: 

server { 

listen 80 default_server; 

# listen [::]:80 default_server deferred; 
return 444; 

} 

Önceki yapılandırma dosyası ve varsayılan sunucu ile NGINX, bağlantı noktası 80 üzerinde ana bilgisayar üst 
bilgisi exampie.com veya *. exampie.com genel trafiği kabul eder. Bu konaklarla eşleşmeyen istekler Kestrel 'e 
iletilemiyor. NGINX, eşleşen istekleri http://iocaihost:5000 adresindeki Kestrel 'e iletir.Daha fazla bilgi için 
NGINX 'in İsteği nasıl işliyorsa öğrenin . Kestrel 'in IP/bağlantı noktasını değiştirmek için bkz. Kestrel: Endpoint 
Configuration. 


VVARNING 

Uygun bir SERVER_NAM E yönergesi belirtmemesi, uygulamanızı güvenlik açıklarına karşı kullanıma sunar. Alt etki alanı joker 
karakteri bağlama (örneğin, *. example . com ), tüm üst etki alanını (güvenlik açığı olan *. com aksine) kontrol ediyorsanız 
bu güvenlik riskini ortadan yapmaz. Daha fazla bilgi için bkz. rfc7230 Section-5,4 . 


NGINX yapılandırması kurulduktan sonra yapılandırma dosyalarının söz dizimini doğrulamak için 
sudo nginx -t çalıştırın. Yapılandırma dosyası testi başarılı olursa, sudo nginx -s reload çalıştırarak NGINX 'in 
değişiklikleri seçmesini zorlar. 

Uygulamayı sunucuda doğrudan çalıştırmak için: 

1. Uygulamanın dizinine gidin. 

2. Uygulamayı çalıştırın: dotnet <app_assembiy.diı> , burada app_assembiy.dll uygulamanın derleme dosyası 
adıdır. 

Uygulama sunucuda çalışır, ancak Internet üzerinden yanıt vermezse, sunucunun güvenlik duvarını denetleyin ve 
80 bağlantı noktasının açık olduğunu doğrulayın. Azure Ubuntu VM kullanıyorsanız, gelen bağlantı noktası 80 
trafiğine izin veren bir ağ güvenlik grubu (NSG) kuralı ekleyin. Giden trafik, gelen kuralı etkinleştirildiğinde 
otomatik olarak verildiği için, giden bağlantı noktası 80 kuralını etkinleştirmeniz gerekmez. 

Uygulamayı test etmeyi tamamladıktan sonra komut isteminde ctri+c ile uygulamayı kapatın. 


Uygulamayı izleme 












Sunucu, http: //<serveraddress> :80 için yapılan istekleri http://i27.0-0. 1:5000 adresindeki Kestrel üzerinde 
çalışan ASP.N ET Core uygulamasına iletmek üzere ayarlanır. Ancak, NGINX Kestrel işlemini yönetmek için 
ayarlanmadı, systemd , temel Web uygulamasını başlatmak ve izlemek üzere bir hizmet dosyası oluşturmak için 
kullanılabilir, systemd , işlem başlatmak, durdurmak ve yönetmek için birçok güçlü özellik sağlayan bir init 
sistemidir. 

Hizmet dosyasını oluşturma 

Hizmet tanımı dosyasını oluşturun: 

sudo nano /etc/systemd/system/kestrel-helloapp.service 


Aşağıda, uygulama için örnek bir hizmet dosyası verilmiştir: 

[Unit] 

Description=Example .NET Web API App running on Ubuntu 
[Service] 

WorkingDirectory=/var/www/helloapp 

ExecStart=/usr/bin/dotnet /var/www/helloapp/helloapp.dll 
Restart=always 

# Restart service after 10 seconds if the dotnet service crashes: 

RestartSec=10 

KillSignal=SIGINT 

SyslogIdentifier=dotnet-example 

User=www-data 

Environment=ASPNETCORE_ENVIRONMENT=Production 
Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false 

[Install] 

WantedBy=multi-user.target 


Kullanıcı www-verileri yapılandırma tarafından kullanılmıyorsa, burada tanımlanan Kullanıcı önce oluşturulmalı 
ve dosyalar için uygun sahiplik verilmelidir. 

Uygulamanın ilk kesme sinyalini aldıktan sonra kapanması için bekleyeceği süreyi yapılandırmak için 
TimeoutstopSec kullanın. Uygulama bu dönemde kapanmazsa, uygulamayı sonlandırmak için SİGKıLL çıkarılır. 
Değeri unitless saniyeler (örneğin, 150 ), zaman aralığı değeri (örneğin, 2min 30s ) veya infinity zaman 
aşımını devre dışı bırakmak için girin. TimeoutstopSec varsayılan değer olan yönetici yapılandırma dosyasında 
(system d-System. conf, System, conf. d, systemd-User. conf, User. conf. d) DefauitTimeoutstopSec değerini alır. 
Çoğu dağıtım için varsayılan zaman aşımı 90 saniyedir. 

# The default value is 90 seconds for most distributions. 

TimeoutStopSec=90 


Linux, büyük/küçük harfe duyarlı bir dosya sistemine sahiptir.ASPNETCORE_ENVIRONMENT "üretim" olarak 
ayarlamak, yapılandırma dosyası appSettings 'i aramasına neden olur. Ürün. JSON, appSettings. Production. 
JSONdegû. 

Yapılandırma sağlayıcılarının ortam değişkenlerini okuyabilmesi için bazı değerler (örneğin, SQL bağlantı 
dizeleri) kaçışmalıdır. Yapılandırma dosyasında kullanılmak üzere uygun bir kaçış değeri oluşturmak için 
aşağıdaki komutu kullanın: 

systemd-escape "<value-to-escape>" 

iki nokta ( : ) ayırıcı, ortam değişkeni adlarında desteklenmez, iki nokta üst üste yerine çift alt çizgi (_) 













kullanın. Ortam değişkenleri yapılandırma sağlayıcısı , ortam değişkenleri yapılandırmaya okurken çift alt 
çizgileri iki nokta üst üste dönüştürür. Aşağıdaki örnekte, bağlantı dizesi anahtarı 

ConnectionStrings:DefaultConnection ConnectionStrings_DefaultConnection olarak hizmet tanımı dosyasına 

ayarlanır: 

Environment=ConnectionStrings_DefaultConnection={Connection String} 


Dosyayı kaydedin ve hizmeti etkinleştirin. 

sudo systemctl enable kestrel-helloapp.service 


Hizmeti başlatın ve çalıştığını doğrulayın. 

sudo systemctl start kestrel-helloapp.service 
sudo systemctl status kestrel-helloapp.service 

• kestrel-helloapp.service - Example .NET Web API App running on Ubuntu 
Loaded: loaded (/etc/systemd/system/kestrel-helloapp.service; enabled) 
Active: active (running) since Thu 2016-10-18 04:09:35 NZDT; 35s ago 
Main PID: 9021 (dotnet) 

CGroup: /system.slice/kestrel-helloapp.service 

L-9021 /usr/local/bin/dotnet /var/www/helloapp/helloapp.dll 


Ters proxy yapılandırılmış ve systemd üzerinden yönetilen Kestrel, Web uygulaması tam olarak yapılandırılır ve 
http://iocaihost adresindeki yerel makinedeki bir tarayıcıdan erişilebilir. Ayrıca, uzak bir makineden de 
erişilebilir, engelleyici olabilecek tüm güvenlik duvarını açabilir. Yanıt üst bilgilerini inceleyerek server üst bilgisi, 
Kestrel tarafından sunulan ASP.NET Core uygulamasını gösterir. 

HTTP/1.1 200 OK 

Date: Tue, 11 Oct 2016 16:22:23 GMT 
Server: Kestrel 
Keep-Alive: timeout=5, max=98 
Connection: Keep-Alive 
Transfer-Encoding: chunked 


Günlükleri görüntüle 

Kestrel kullanan Web uygulaması systemd kullanılarak yönetildiğinden, tüm olaylar ve süreçler merkezi bir 
günlüğe kaydedilir. Ancak, bu günlük systemd tarafından yönetilen tüm hizmetler ve süreçler için tüm girişleri 
içerir, kestrel-helloapp.service özgü öğeleri görüntülemek için aşağıdaki komutu kullanın: 


sudo journalctl -fu kestrel-helloapp. 

service 

Daha fazla filtreleme için --since today , 
döndürülen girdi miktarını azaltabilir. 

--until ı hour ago veya bunların bir bileşimi gibi zaman seçenekleri 

sudo journalctl -fu kestrel-helloapp. 

service --since "2016-10-18" --until "2016-10-18 04:00" 


Veri koruma 

ASP.NET Core veri koruma yığını , kimlik doğrulama ara yazılımı (örneğin, tanımlama bilgisi ara yazılımı) ve 
siteler arası istek sahteciliğini önleme (CSRF) korumaları dahil olmak üzere birkaç ASP.NET Core 
middlevvarestarafından kullanılır. Veri koruma API 'Leri Kullanıcı kodu tarafından çağrılmasa bile, veri 













korumasının kalıcı bir şifreleme anahtarı deposuoluşturacak şekilde yapılandırılması gerekir. Veri koruması 
yapılandırılmamışsa, anahtarlar bellekte tutulur ve uygulama yeniden başlatıldığında atılır. 

Uygulama yeniden başlatıldığında anahtar halkası bellekte depolanıyorsa: 

• Tüm tanımlama bilgisi tabanlı kimlik doğrulama belirteçleri geçersiz kılınır. 

• Kullanıcıların bir sonraki isteğinde yeniden oturum açması gerekir. 

• Anahtar halkası ile korunan tüm veriler artık çözülemez. Bu, CSRF belirteçlerini ve ASP.NET Core MVC 
TempData tanımlama bilgileriniiçerebilir. 

Veri korumayı, anahtar halkasını sürdürmek ve şifrelemek üzere yapılandırmak için, bkz.: 

• ASP.NET core'da anahtar depolama sağlayıcıları 

• ASP.NET core'da bekleme durumunda anahtar şifreleme 

Uzun istek üst bilgisi alanları 

Proxy sunucusu varsayılan ayarları, platforma bağlı olarak genellikle istek üst bilgisi alanlarını 4 K veya 8 K ile 
sınırlandırır. Bir uygulama, varsayılan değerden daha uzun bir süre gerektirebilir (örneğin, Azure Active 
Directorykullanan uygulamalar). Daha uzun alanlar gerekliyse, proxy sunucusunun varsayılan ayarları ayarlama 
gerektirir. Uygulanacak değerler senaryoya göre değişir. Daha fazla bilgi için sunucunuzun belgelerine bakın. 

• proxy_buffer_size 

• proxy_buffers 

• proxy_busy_buffers_size 

• large_client_header_buffers 


VVARNING 

Gerekli olmadığı takdirde proxy arabelleklerinin varsayılan değerlerini artırmaz. Bu değerlerin artırılması, kötü amaçlı 
kullanıcılar tarafından arabellek taşması (taşma) ve hizmet reddi (DoS) saldırıları riskini artırır. 


Uygulamanın güvenliğini sağlama 

AppArmor etkinleştir 

Linux güvenlik modülleri (LSM), Linux 2,6 1 den beri Linux çekirdeğinin parçası olan bir çerçevedir. LSM, güvenlik 
modüllerinin farklı uygulamalarını destekler. AppArmor , programı sınırlı bir kaynak kümesiyle sınırlandırarak 
zorunlu bir Access Control sistemi uygulayan bir LS M 'dir. AppArmor etkinleştirildiğinden ve düzgün şekilde 
yapılandırıldığından emin olun. 

Güvenlik duvarını yapılandırma 

Kullanımda olmayan tüm dış bağlantı noktalarını kapatın. Karmaşık olmayan güvenlik duvarı (UW), güvenlik 
duvarını yapılandırmak için bir komut satırı arabirimi sağlayarak iptables için bir ön uç sağlar. 


VVARNING 

Bir güvenlik duvarı, doğru yapılandırılmamışsa tüm sisteme erişimi engeller. Kendisine bağlanmak için SSH kullanıyorsanız 
doğru SSH bağlantı noktasını belirtmemesi Sistem oturumunuzu etkin bir şekilde kilitleyecek. Varsayılan bağlantı noktası 22 
' dir. Daha fazla bilgi için bkz. UFW 'ye giriş ve el ile. 


uf w yükleyip, gereken bağlantı noktalarında trafiğe izin verecek şekilde yapılandırın. 








sudo apt-get install ufw 

sudo ufw allow 22/tcp 
sudo ufw allow 80/tcp 
sudo ufw allow 443/tcp 

sudo ufw enable 

Güvenli NGINX 

NGINX yanıt adını değiştirme 

Src/http/ngx_http_header_filter_module. c'yi düzenleyin: 

static char ngx_http_server_string[] = "Server: Web Server" CRLF; 
static char ngx_http_server_full_string[] = "Server: Web Server" CRLF; 

Seçenekleri Yapılandır 

Sunucuyu gerekli olan ek modüllerle yapılandırın. Uygulamayı sağlamlaştırmak için ModSecuritygibi bir Web 
uygulaması güvenlik duvarı kullanmayı düşünün. 

HTTPS yapılandırması 

Uygulamayı güvenli (HTTPS) yerel bağlantılar için yapılandırma 

DotNet Run komutu uygulamanın Özellikler/launchsettings. JSON dosyasını kullanır, bu da uygulamayı 
appiicationUri özelliği tarafından belirtilen URL 'lerde dinlemek üzere yapılandırır (örneğin, 
https://localhost:5001; http://localhost:5000 ). 

Aşağıdaki yaklaşımlardan birini kullanarak uygulamayı dotnet run komutu veya geliştirme ortamı için 
geliştirme sırasında (F5 veya CTRL + Visual Studio Code F5) bir sertifikayı kullanacak şekilde yapılandırın: 

• Varsayılan sertifikayı yapılandırmadan Değiştir ( önerilir) 

• KestrelServerOptions. ConfigureFIttpsDefaults 

Güvenli (HTTPS) istemci bağlantıları için ters proxy 'yi yapılandırma 

• Güvenilen bir sertifika yetkilisi (CA) tarafından verilen geçerli bir sertifika belirterek, sunucu 443 bağlantı 
noktasında HTTPS trafiğini dinleyecek şekilde yapılandırın. 

• Aşağıdaki /etc/nginx/nginx.conf dosyasında gösterilen bazı uygulamalardan yararlanarak güvenliği en iyi 
şekilde yapın. Daha güçlü bir şifre seçme ve HTTP üzerinden tüm trafiği HTTPS 'ye yeniden yönlendirme 
örnekleri içerir. 

• http Strict-Transport-Security (HSTS) üstbilgisi eklemek, istemci tarafından yapılan tüm sonraki 
isteklerin HTTPS üzerinden yapılmasını sağlar. 

• Daha sonra HTTPS 'nin devre dışı bırakılacağı için HSTS üst bilgisini eklemeyin veya uygun bir max-age 
seçmeyin. 

/Etc/nginx/proxy.conf yapılandırma dosyasını ekleyin: 








proxy_redirect 

off; 

proxy_set_header 

Hoşt $host; 

proxy_set_header 

X-Real-IP $remote_addr; 

proxy_set_header 

X-Forwarded-For $proxy_add_x_forwarded_for; 

proxy_set_header 

X-Forwarded-Proto $scheme; 

client_max_body_size 

10 m; 

client_body_buffer_size 

128k; 

proxy_connect_timeout 

90; 

proxy_send_timeout 

90; 

proxy_read_timeout 

90; 

proxy_buffers 

32 4k; 


/Etc/nginx/nginx.conf yapılandırma dosyasını düzenleyin. Örnek, tek bir yapılandırma dosyasında hem http 
hem de server bölümleri içerir. 


http { 

include /etc/nginx/proxy.conf; 

limit_req_zone $binary_remote_addr zone=one:10m rate=5r/s; 
serven_tokens off; 


sendfile on; 

keepalive_timeout 29; # Adjust to the lowest possible value that makes sense fon your use case. 
client_body_timeout 10; client_header_timeout 10; send_timeout 10; 

upstream hellomvc{ 

server localhost:5000; 

} 

server { 

listen *:80; 

add_header Strict-Transport-Security max-age=15768000; 
return 301 https://$host$request_uri; 

} 


server { 
listen 
server_name 
ssl_certificate 
ssl_certificate_key 
ssl_protocols 


*:443 ssl; 
example.com; 

/etc/ssl/certs/testCert.crt; 
/etc/ssl/certs/testCert.key; 
TLSvl.l TLSvl.2; 


ssl_prefer_server_ciphers on; 


ssl_ciphers 

ssl_ecdh_curve 

ssl_session_cache 

ssl_session_tickets 

ssl_stapling 

ssl_stapling_verify 


"EECDH+AESGCM:EDH+AESGCM: AES256+EECDH: AES256+EDH"; 

secp384rl; 

shared:SSL:10m; 

off; 

on; #ensure your cert is capable 
on; #ensure your cert is capable 


add_header Strict-Transport-Security "max-age=63072000; includeSubdomains; preload"; 
add_header X-Frame-Options DENY; 
add_header X-Content-Type-Options nosniff; 


#Redirects ali traffic 
location / { 

proxy_pass http://hellomvc; 
limit_req zone=one burst=10 nodelay; 

} 

} 

} 


Tıklama mercekten NGINX 'i güvenli hale getirme 

Ul redki sa/c/yisrolarak da bilinen tıklama, bir Web sitesi ziyaretçisinin bir bağlantı veya düğmeye Şu anda ziyaret 
ettiğinden farklı bir sayfada tıklanması zor olan kötü amaçlı bir saldırıya neden olur. Siteyi güvenli hale getirmek 






için x-frame-options kullanın. 

Tıklama saldırılarını azaltmak için: 

1. NGINX. conf dosyasını düzenleyin: 

sudo nano /etc/nginx/nginx.conf 

Satiri add_header X-Fname-Options "SAMEORIGIN"; ekleyin. 

2. Dosyayı kaydedin. 

3. NGINX'i yeniden başlatın. 

MİME türü algılaması 

Bu üst bilgi, tarayıcının, yanıt içerik türünü geçersiz kılmamasını bildiren, büyük bir olasılıkla, MİME tarafından 
yapılan bir yanıtın bir yanıt olarak bildirimde bulunmasını engeller, nosniff seçeneği ile, sunucu içeriği 
"metin/html" ise, tarayıcı bunu "metin/html" olarak işler. 

NGINX. conf dosyasını düzenleyin: 
sudo nano /etc/nginx/nginx.conf 

Satırı add_header x-content-Type- 0 ptions "nosniff"; ekleyin ve dosyayı kaydedin, sonra NGINX 'i yeniden 
başlatın. 

Ek NGINX önerileri 

Sunucuda paylaşılan Framevvork 'ü yükselttikten sonra, sunucu tarafından barındırılan ASP.NET Core 
uygulamaları yeniden başlatın. 

Ek kaynaklar 

• Linux üzerinde .N ET Core önkoşulları 

• NGINX: İkili yayınlar: resmi olmayan/Ubuntu Paketleri 

• ASP.NET Core projeleri sorunlarını giderme 

• Proxy sunucularıyla ve yük dengeleyicilerle çalışacak ASP.NET Core yapılandırma 

• NGıNX: İletilen üstbilgiyi kullanma 
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Sağlayan- Shayne Boyer 

Bu kılavuzu kullanarak, HTTP trafiğinin Kestrel Server üzerinde çalışan bir ASP.NET Core Web uygulamasına 
yönlendirilmesini sağlamak İçin CentOS 7 ' de bir ters proxy sunucusu olarak Apache 'yi ayarlamayı öğrenin. 
Mod_proxy uzantısı ve ilgili Modüller sunucunun ters proxy 'sini oluşturur. 

Prerequisites 

• Sudo ayrıcalığına sahip standart bir kullanıcı hesabıyla CentOS 7 çalıştıran sunucu. 

• ,N ET Core çalışma zamanını sunucuya yükler. 

1. .Net çekirdeğini indir sayfasınıziyaret edin. 

2. En son Önizleme olmayan .NET Core sürümünü seçin. 

3. Uygulama çalıştırma-çalışma zamanıaltındaki tabloda en son önizleme dışı çalışma zamanını 
indirin. 

4. Linux Paket Yöneticisi yönergeleri bağlantısını seçin ve CentOS talimatlarını izleyin. 

• MevcutbirASP.NET Core uygulaması. 

Paylaşılan Framevvork 'ü yükselttikten sonra gelecekte herhangi bir noktada, sunucu tarafından barındırılan 
ASP.NET Core uygulamaları yeniden başlatın. 

Uygulama üzerinde Yayımla ve Kopyala 

Uygulamayı çerçeveye bağımlı bir dağıtım içi n yapılandırın. 

Uygulama yerel olarak çalıştırılır ve güvenli bağlantı (HTTPS) yapmak üzere yapılandırılmamışsa aşağıdaki 
yaklaşımlardan birini benimseyin: 

• Uygulamayı güvenli yerel bağlantıları işleyecek şekilde yapılandırın. Daha fazla bilgi için https yapılandırma 
bölümüne bakın. 

• Properties/launchSettings. JSON dosyasındaki appiicationuri özelliğinden https://iocaihost :500ı (varsa) 
kaldırın. 

Bir uygulamayı sunucuda çalışabilecek bir dizine (örneğin, bin/Release/<target_framework_moniker>/PubUsh) 
paketlemek için geliştirme ortamından DotNet Publish çalıştırın: 

dotnet publish --configuration Release 

Uygulama, sunucuda .NET Core çalışma zamanının bakımını yapmayı tercih ediyorsanız, kendi kendine içerilen 
bir dağıtım olarak da yayımlanabilir. 

ASP.NET Core uygulamasını, kuruluşun iş akışını (örneğin, SCP, SFTP) tümleştiren bir aracı kullanarak sunucuya 
kopyalayın. Var dizini altında Web uygulamalarının (örneğin, var/www/HelloApp) yerini bulmak yaygındır. 


NOTE 

Bir üretim dağıtım senaryosunda, sürekli tümleştirme iş akışı, uygulamayı yayımlama ve varlıkları sunucuya kopyalama işini 
yapar 








Proxy sunucusu yapılandırma 

Ters proxy, dinamik Web uygulamaları sunmak için ortak bir kurulumtir.Ters proxy, HTTP isteğini sonlandırır ve 
ASP.NET uygulamasına iletir. 

Proxy sunucusu, istemci isteklerini istekleri yerine başka bir sunucuya ileten bir sunucu olur.Ters proxy, genellikle 
rastgele istemciler adına sabit bir hedefe iletilir. Bu kılavuzda Apache, Kestrel 'in ASP.NET Core uygulamasına 
hizmet veren aynı sunucuda çalışan ters proxy olarak yapılandırılmıştır. 

İstekler ters proxy tarafından iletileceği için, Microsoft. AspNetCore. HttpOverrides paketindeki İletilen üstbilgiler 
ara yazılımını kullanın. Ara yazılım, x-Forwarded-Proto üst bilgisini kullanarak Request.scheme güncelleştirir, 
böylece yeniden yönlendirme URI 'Leri ve diğer güvenlik ilkeleri doğru çalışır. 

Bir şemaya bağlı kimlik doğrulama, bağlantı oluşturma, yeniden yönlendirme ve coğrafi konum gibi herhangi bir 
bileşen, İletilen üstbilgiler ara yazılımı çağrıldıktan sonra yerleştirilmelidir. Genel bir kural olarak, İletilen 
üstbilgiler ara yazılımı, tanılama ve hata işleme ara yazılımı dışında diğer ara yazılım ile önce çalışmalıdır. Bu 
sıralama, iletilen üst bilgi bilgilerine bağlı olan ara yazılımın işleme için üst bilgi değerlerini kullanmasını sağlar. 

UseAuthentication veya benzer kimlik doğrulama düzeni ara yazılımını çağırmadan önce startup.configure 
UseForvvardedHeaders yöntemi çağırın. x-Forwarded-For ve x-Forwarded-Proto üstbilgilerini iletmek için ara 
yazılımı yapılandırın: 

app.UseForwardedHeaders(new ForwardedHeadersOptions 
{ 

ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto 

}); 

app.UseAuthentication(); 

Ara yazılım için ForvvardedHeadersOptions belirtilmemişse, iletmek için varsayılan üstbilgiler None . 

Standart localhost adresi (127.0.0.1) dahil olmak üzere geri döngü adreslerinde çalışan proxy 'ler (127.0.0.0/8, [:: 
1]), varsayılan olarak güvenilirdir. Kuruluş içindeki diğer güvenilir proxy 'ler veya ağlar, Internet ve Web sunucusu 
arasında istekleri ele alıyorsa, bunları ForwardedHeadersOptionsKnownProxies veya KnownNetworks listesine 
ekleyin. Aşağıdaki örnek, alana 10.0.0.100 adresindeki İletilen üstbilgiler ara sunucusuna 
stantup.configureServices'' KnownProxn.es İP adresinde bir güvenilen ara sunucu ekler: 

Services.Configure<ForwardedHeadersOptions>(options => 

{ 

options.KnownProxies.Add(IPAddress.Parse("10.0.0.100")); 

}); 

Daha fazla bilgi için bkz. Proxy sunucularıyla ve yük dengeleyicilerle çalışacak ASP.NET Core yapılandırma. 

Apache "yi yükler 

CentOS paketlerini en son kararlı sürümlerine güncelleştirin: 

sudo yum update -y 

Tekbir yum komutuyla, CentOS'a Apache Web sunucusunu yükler: 

sudo yum -y install httpd mod_ssl 


Komutu çalıştırdıktan sonra örnek çıkış: 








Downloading packages: 

httpd-2.4.6-40.el7.centos.4.x86_64.rpm 

Running transaction check 

Running transaction test 

Transaction test succeeded 

| 2.7 MB 00:00:01 

Running transaction 

Installing : httpd-2.4.6-40.el7.centos.4.x86_64 

1/1 

Verifying : httpd-2.4.6-40.el7.centos.4.x86_64 

1/1 

Installed: 


httpd.x86_64 0:2.4.6-40.el7.centos.4 


Complete! 



NOTE 

Bu örnekte, CentOS 7 sürümü 64 bit olduğundan çıkış httpd. 86_64 ' i yansıtır. Apache 'nin yüklendiğini doğrulamak için, 
bir komut isteminden whereis httpd çalıştırın. 


Apache yapılandırma 

Apache için yapılandırma dosyaları /etc/httpd/conf.d/ dizininde bulunur.. Conf uzantısına sahip herhangi bir 
dosya, modülleri yüklemek için gereken yapılandırma dosyalarını içeren /etc/httpd/conf .modules.d/ içindeki 
modül yapılandırma dosyalarına ek olarak alfabetik sırada işlenir. 


Uygulama için HelloApp. confad\\ bir yapılandırma dosyası oluşturun: 



bkz. Kestrel: Endpoint Configuration. 


VVARNING 

VirtualHost bloğunda uygun bir ServerName yönergesi belirtmemesi, uygulamanızı güvenlik açıklarına karşı kullanıma 
sunar. Alt etki alanı joker karakteri bağlama (örneğin, *. example.com ), tüm üst etki alanını (güvenlik açığı olan *.com 
aksine) kontrol ediyorsanız bu güvenlik riskini ortadan yapmaz. Daha fazla bilgi için bkz. rfc7230 Section-5,4 . 


Günlüğe kaydetme, ErrorLog ve customLog yönergeleri kullanılarak VirtualHost başına yapılandırılabilir. 
ErrorLog , sunucunun hataları günlüğe kaydettiği konumdur ve CustomLog dosya adını ve günlük dosyasının 
biçimini ayarlar. Bu durumda istek bilgileri günlüğe kaydedilir. Her istek için bir satır vardır. 
















Dosyayı kaydedin ve yapılandırmayı test edin. Her şey geçerse yanıt syntax [ok] olmalıdır. 

sudo service httpd configtest 

Apache 'i yeniden Başlat: 

sudo systemctl restart httpd 
sudo systemctl enable httpd 


Uygulamayı izleme 

Apache, artık http://iocaihost :80 yapılan istekleri, http://i27. 0 . 0 . 1:5000 'de Kestrel üzerinde çalışan ASP.NET 
Core uygulamasına iletmek üzere kuruldu. Ancak, Kestrel işlemini yönetmek için Apache ayarlanmamış. Temel 
Web uygulamasını başlatmak ve izlemek için systemd ve hizmet dosyası oluşturma 1 yı kullanın, systemd, işlem 
başlatmak, durdurmak ve yönetmek için birçok güçlü özellik sağlayan bir init sistemidir 

Hizmet dosyasını oluşturma 

Hizmet tanımı dosyasını oluşturun: 

sudo nano /etc/systemd/system/kestrel-helloapp.service 


Uygulama için örnek bir hizmet dosyası: 

[Unit] 

Description=Example .NET Web API App running on CentOS 7 
[Service] 

WorkingDirectory=/var/www/helloapp 

ExecStart=/usr/local/bin/dotnet /var/www/helloapp/helloapp.dll 
Restart=always 

# Restart service after 10 seconds if the dotnet service crashes: 

RestartSec=10 

KillSignal=SIGINT 

SyslogIdentifier=dotnet-example 

User=apache 

Environment=ASPNETCORE_ENVIRONMENT=Production 

[Install] 

WantedBy=multi-user.target 


Kullanıcı Apache yapılandırması tarafından kullanılmıyorsa, önce kullanıcının oluşturulması ve dosyaların uygun 
sahipliğinin verilmesi gerekir. 

Uygulamanın ilk kesme sinyalini aldıktan sonra kapanması için bekleyeceği süreyi yapılandırmak için 
TimeoutstopSec kullanın. Uygulama bu dönemde kapanmazsa, uygulamayı sonlandırmak için SİGKıLL çıkarılır. 
Değeri unitless saniyeler (örneğin, 150 ), zaman aralığı değeri (örneğin, 2 min 30s ) veya infinity zaman 
aşımını devre dışı bırakmak için girin. TimeoutstopSec varsayılan değer olan yönetici yapılandırma dosyasında 
(system d-System. conf, System, conf. d, systemd-User. conf, User. conf. d) DefaultTimeoutstopSec değerini alır. 
Çoğu dağıtım için varsayılan zaman aşımı 90 saniyedir. 

# The default value is 90 seconds for most distributions. 

TimeoutStopSec=90 


Yapılandırma sağlayıcılarının ortam değişkenlerini okuyabilmesi için bazı değerler (örneğin, SQL bağlantı 












dizeleri) kaçışmalıdır. Yapılandırma dosyasında kullanılmak üzere uygun bir kaçış değeri oluşturmak için 
aşağıdaki komutu kullanın: 

systemd-escape "<value-to-escape>" 

iki nokta ( : ) ayırıcı, ortam değişkeni adlarında desteklenmez, iki nokta üst üste yerine çift alt çizgi (_) 

kullanın. Ortam değişkenleri yapılandırma sağlayıcısı , ortam değişkenleri yapılandırmaya okurken çift alt 
çizgileri iki nokta üst üste dönüştürür. Aşağıdaki örnekte, bağlantı dizesi anahtarı 

ConnectionStrings:DefaultConnection ConnectionStrings_DefaultConnection olarak hizmet tanımı dosyasına 

ayarlanır: 

Environment=ConnectionStrings_DefaultConnection={Connection String} 


Dosyayı kaydedin ve hizmeti etkinleştirin: 


sudo systemctl enable kestrel-helloapp.service 


Hizmeti başlatın ve çalıştığını doğrulayın: 

sudo systemctl start kestrel-helloapp.service 
sudo systemctl status kestrel-helloapp.service 

• kestrel-helloapp.service - Example .NET Web API App running on CentOS 7 
Loaded: loaded (/etc/systemd/system/kestrel-helloapp.service; enabled) 
Active: active (running) since Thu 2016-10-18 04:09:35 NZDT; 35s ago 
Main PID: 9021 (dotnet) 

CGroup: /system.slice/kestrel-helloapp.service 

L-9021 /usr/local/bin/dotnet /var/www/helloapp/helloapp.dll 


Ters proxy yapılandırılmış ve sysfemdüzerinden yönetilen Kestrel, Web uygulaması tam olarak yapılandırılır ve 
http://iocaihost adresindeki yerel makinedeki bir tarayıcıdan erişilebilir. Yanıt üst bilgilerini inceleyerek sunucu 
üst bilgisi, AS P.N ET Core uygulamasının Kestrel tarafından sunulduğunu belirtir: 

HTTP/1.1 200 OK 

Date: Tue, 11 Oct 2016 16:22:23 GMT 
Server: Kestrel 
Keep-Alive: timeout=5, max=98 
Connection: Keep-Alive 
Transfer-Encoding: chunked 


Günlükleri görüntüle 

Kestrel kullanan Web uygulaması sysfemc/kullanılarak yönetildiğinden, olaylar ve süreçler merkezi bir günlüğe 
kaydedilir. Ancak, bu günlük sysfemdtarafından yönetilen tüm hizmet ve işlemlere ait girişleri içerir, 
kestrel-helloapp.service özgü öğeleri görüntülemek için aşağıdaki komutu kullanın: 

sudo journalctl -fu kestrel-helloapp.service 

Zaman filtreleme için komutuyla saat seçeneklerini belirtin. Örneğin, geçerli güne filtre uygulamak veya önceki 
saatin girişlerini görmek için --until ı hour ago --since today kullanın. Daha fazla bilgi için bkz. journalctl için 
man sayfası. 







sudo journalctl -fu kestrel-helloapp.service --since "2016-10-18" --until "2016-10-18 04:00" 


Veri koruma 

ASP.NET Core veri koruma yığını , kimlik doğrulama ara yazılımı (örneğin, tanımlama bilgisi ara yazılımı) ve 
siteler arası istek sahteciliğini önleme (CSRF) korumaları dahil olmak üzere birkaç ASP.NET Core 
middlevvarestarafmdan kullanılır. Veri koruma API 'Leri Kullanıcı kodu tarafından çağrılmasa bile, veri 
korumasının kalıcı bir şifreleme anahtarı deposuoluşturacak şekilde yapılandırılması gerekir. Veri koruması 
yapılandırılmamışsa, anahtarlar bellekte tutulur ve uygulama yeniden başlatıldığında atılır. 

Uygulama yeniden başlatıldığında anahtar halkası bellekte depolanıyorsa: 

• Tüm tanımlama bilgisi tabanlı kimlik doğrulama belirteçleri geçersiz kılınır. 

• Kullanıcıların bir sonraki isteğinde yeniden oturum açması gerekir. 

• Anahtar halkası ile korunan tüm veriler artık çözülemez. Bu, CSRF belirteçlerini ve ASP.NET Core MVC 
TempData tanımlama bilgileriniiçerebilir. 

Veri korumayı, anahtar halkasını sürdürmek ve şifrelemek üzere yapılandırmak için, bkz.: 

• ASP.NET core'da anahtar depolama sağlayıcıları 

• ASP.NET core'da bekleme durumunda anahtar şifreleme 

Uygulamanın güvenliğini sağlama 

Güvenlik duvarını yapılandırma 

Firevvallld , ağ bölgeleri desteğiyle güvenlik duvarını yönetmek için dinamik bir Daemon. Bağlantı noktaları ve 
paket filtrelemesi, Iptables tarafından hala yönetilebilir. Firewalld , varsayılan olarak yüklenmelidir, yum , paketi 
yüklemek veya yüklendiğini doğrulamak için kullanılabilir. 

sudo yum install firewalld -y 

Yalnızca uygulama için gerekli olan bağlantı noktalarını açmak için firewaiid kullanın. Bu durumda, 80 ve 443 
numaralı bağlantı noktası kullanılır. Aşağıdaki komutlar şunları açmak için 80 ve 443 bağlantı noktalarını kalıcı 
olarak ayarlar: 

sudo firewall-cmd --add-port=80/tcp --permanent 
sudo firewall-cmd --add-port=443/tcp --permanent 

Güvenlik Duvarı ayarlarını yeniden yükleyin. Varsayılan bölgedeki kullanılabilir hizmetleri ve bağlantı noktalarını 
kontrol edin. Seçenekler firewaiı-cmd -h inceleyerek kullanılabilir. 

sudo firewall-cmd --reload 
sudo firewall-cmd -list-all 







public (defaultj active) 
interfaces: eth0 
sources: 

Services: dhcpv6-client 
ports: 443/tcp 80/tcp 
masquerade: no 
forward-ports: 
icmp-blocks: 
rich rules: 


HTTPS yapılandırması 

Uygulamayı güvenli (HTTPS) yerel bağlantılar için yapılandırma 

DotNet Run komutu uygulamanın Özellikler/launchsettings. JSON dosyasını kullanır, bu da uygulamayı 
appiicationuri özelliği tarafından belirtilen URL 'lerde dinlemek üzere yapılandırır (örneğin, 
https://localhost:5001; http://localhost:5000 ). 

Aşağıdaki yaklaşımlardan birini kullanarak uygulamayı dotnet run komutu veya geliştirme ortamı için 
geliştirme sırasında (F5 veya CTRL + Visual Studio Code F5) bir sertifikayı kullanacak şekilde yapılandırın: 

• Varsayılan sertifikayı yapılandırmadan Değiştir ( önerilir) 

• KestrelServerOptions. ConfigureHttpsDefaults 

Güvenli (HTTPS) istemci bağlantıları için ters proxy 'yi yapılandırma 

HTTPS için Apache 'yi yapılandırmak için mod_ssl modülü kullanılır. Httpd modülü yüklendiğinde mod_ssl 
modülü de yüklendi. Yüklenmemişse, yapılandırmaya eklemek için yum kullanın. 


sudo yum install mod_: 

ssl 


HTTPS 'yi zorlamak için 

mod_rewrite 

modülünü yükleyerek URL yeniden yazmayı etkinleştirin: 

sudo yum install mod_ı 

rewrite 



Bağlantı noktası 443 üzerinde URL yeniden yazma ve güvenli iletişim sağlamak için HelloApp. conf dosyasını 
değiştirin: 







cVirtualHost *:*> 

RequestHeader set "X-Forwarded-Proto" expr=%{REQUEST_SCHEME} 
</VirtualHost> 

<VirtualHost *:80> 

RewriteEngine On 
RewriteCond %{HTTPS} !=on 

RewriteRule A /?(.*) https://%{SERVER_NAME}/$l [R,L] 

</VirtualHost> 

<VintualHost *:443> 

PnoxyPreserveHost On 

ProxyPass / http://127.0.0.1:5000/ 

ProxyPassReverse / http://127.0.0.1:5000/ 

ErrorLog /var/log/httpd/helloapp-error.log 
CustomLog /van/log/httpd/helloapp-access.log common 
SSLEngine on 
SSLProtocol ali -SSLv2 

SSLCipherSuite ALL:!ADH:!EXPORT:!SSLv2:!RC4+RSA:+HIGH:+MEDIUM:!LOW:!RC4 
SSLCentiflcateFile /etc/pki/tls/certs/localhost.crt 
SSLCentiflcateKeyFile /etc/pki/tls/private/localhost.key 
</VirtualHost> 


NOTE 

Bu örnek, yerel olarak üretilmiş bir sertifika kullanıyor. Sslcertificatefile , etki alanı adı için birincil sertifika dosyası olmalıdır. 
Sslcertificatekeyfile , CSR oluşturulduğunda oluşturulan anahtar dosyası olmalıdır. Sslcertificatechainfile , sertifika 
yetkilisi tarafından sağlanan ara sertifika dosyası (varsa) olmalıdır. 


Dosyayı kaydedin ve yapılandırmayı test edin: 

sudo service httpd configtest 


Apache 'i yeniden Başlat: 


sudo systemctl restart httpd 


Ek Apache önerileri 

Paylaşılan çerçeve güncelleştirmeleriyle uygulamaları yeniden başlatma 

Sunucuda paylaşılan Framevvork 'ü yükselttikten sonra, sunucu tarafından barındırılan ASP.NET Core 
uygulamaları yeniden başlatın. 

Ek üstbilgiler 

Kötü amaçlı saldırılara karşı korumak için, değiştirilmesi veya eklenmesi gereken birkaç üstbilgi vardır. 
mod_headers modülünün yüklü olduğundan emin olun: 

sudo yum install mod_headers 

Tıklama ve tıklama saldırılarına karşı güvenli Apache 

Ul redki sa/c/ınsıolarak da bilinen tıklama, bir Web sitesi ziyaretçisinin bir bağlantı veya düğmeye Şu anda ziyaret 
ettiğinden farklı bir sayfada tıklanması zor olan kötü amaçlı bir saldırıya neden olur. Siteyi güvenli hale getirmek 
için x-frame-options kullanın. 


ıklama saldırılarını azaltmak için: 







1. Httpd. conf dosyasını düzenleyin: 


sudo nano /etc/httpd/conf/httpd.conf 

Satırı Header append X-FRAME-OPTIONS "SAMEORIGIN" ekleyin. 

2. Dosyayı kaydedin. 

3. Apache 'i yeniden başlatın. 

MİME türü algılaması 

X-Content-Type-Options üstbilgisi, Internet Explorer 'ın MİME algılaması (dosyanın içeriğinden bir dosyanın 
Content-Type belirleme) engeller.Sunucu Content-Type üst bilgisini nosniff seçenek kümesiyle text/htmi 
olarak ayarladıysanız, Internet Explorer içeriği dosyanın içeriğinden bağımsız olarak text/htni olarak işler. 

Httpd. conf dosyasını düzenleyin: 

sudo nano /etc/httpd/conf/httpd.conf 

Satırı Header set X-Content-Type-Options "nosniff" ekleyin. Dosyayı kaydedin. Apache 'i yeniden başlatın. 

Yük Dengelemesi 

Bu örnek, CentOS 7 ve Kestrel üzerinde Apache 'in aynı örnek makinede nasıl ayarlanacağını ve 
yapılandırılacağını gösterir. Tek bir hata noktası olmaması için; mod_proxy_balancer kullanmak ve VirtualHost 
'u değiştirmek, Apache proxy sunucusunun arkasındaki Web uygulamalarının birden çok örneğini yönetmeye 
olanak tanır. 

sudo yum install mod_proxy_balancer 

Aşağıda gösterilen yapılandırma dosyasında, helloapp ek bir örneği 5001 numaralı bağlantı noktasında 
çalışacak şekilde ayarlanır. Proxy bölümü, Yük Dengeleme isteklerilçn iki üyeli bir dengeleyici yapılandırması ile 
ayarlanır. 











cVirtualHost *:*> 

RequestHeader set "X-Forwarded-Proto" expr=%{REQUEST_SCHEME} 
</VirtualHost> 

<VirtualHost *:80> 

RewriteEngine On 
RewriteCond %{HTTPS} !=on 

RewriteRule A /?(.*) https://%{SERVER_NAME}/$l [R,L] 

</VirtualHost> 

<VintualHost *:443> 

PnoxyPass / balancer://mycluster/ 

ProxyPassReverse / http://127.0.0.1:5000/ 

PnoxyPassReverse / http://127.0.0.1:5001/ 

<Proxy balancer://mycluster> 

BalancerMember http://127.0.0.1:5000 
BalancerMember http://127.0.0.1:5001 
ProxySet lbmethod=byrequests 
</Proxy> 

cLocation /> 

SetHandler balancer 
</Location> 

ErrorLog /var/log/httpd/helloapp-erron.log 
CustomLog /var/log/httpd/helloapp-access.log common 
SSLEngine on 
SSLProtocol ali -SSLv2 

SSLCipherSııite ALL: !ADH: !EXPORT: !SSLv2: !RC4+RSA: +HIGH: +MEDIUM: !LOW: !RC4 
SSLCentificateFile /etc/pki/tls/certs/localhost.cnt 
SSLCertificateKeyFile /etc/pki/tls/private/localhost.key 
</VirtualHost> 


Oran limitleri 

Httpd modülüne eklenen mo^rafe/Zm/fkullanarak, istemcilerin bant genişliği sınırlandırılabilir: 

sudo nano /etc/httpd/conf.d/ratelimit.conf 

Örnek dosya, bant genişliğini kök konumu altında 600 KB/sn olarak sınırlandırır: 

<IfModule mod_ratelimit.c> 
cLocation /> 

SetOutputFilter RATE_LIMIT 
SetEnv nate-limit 600 
</Location> 

</IfModule> 


Uzun istek üst bilgisi alanları 

Proxy sunucusu varsayılan ayarları, istek üst bilgisi alanlarını genellikle 8.190 bayt ile sınırlar. Bir uygulama, 
varsayılan değerden daha uzun bir süre gerektirebilir (örneğin, Azure Active Directorykullanan uygulamalar). 
Daha uzun alanlar gerekliyse, proxy sunucusunun LimitRequestFieldSize yönergesi ayarlamayı gerektirir. 
Uygulanacak değer senaryoya bağlıdır. Daha fazla bilgi için sunucunuzun belgelerine bakın. 


VVARNING 

Gerekli olmadığı takdirde LimitRequestFieldsize varsayılan değerini artırmaz. Değerin artırılması, kötü amaçlı kullanıcılar 
tarafından arabellek taşması (taşma) ve hizmet reddi (DoS) saldırıları riskini artırır. 






Ek kaynaklar 

• Linux üzerinde .N ET Core önkoşulları 

• ASP.NET Core projeleri sorunlarını giderme 

• Proxy sunucularıyla ve yük dengeleyicilerle çalışacak ASP.N ET Core yapılandırma 


Docker kapsayıcılarında konak ASPNET Core 

18.07.2019 • 2 minutes to read ı Edjt Online 


Docker 'da ASP.NET Core uygulamalar barındırma hakkında bilgi edinmek için aşağıdaki makaleler 
sunulmaktadır: 

Kapsayıcılar ve Docker'a Giriş 

Kapsayıcının bir uygulama veya hizmetin, bağımlılıklarının ve yapılandırmasının bir kapsayıcı görüntüsü olarak 
birlikte paketlendiği yazılım geliştirme konusunda nasıl yaklaşım olduğunu öğrenin. Görüntü test edilebilir ve bir 
konağa dağıtılabilir. 

Docker nedir? 

Docker 'ın, bulutta veya şirket içinde çalışabilen, taşınabilir, kendi kendine yeterli kapsayıcı olarak uygulama 
dağıtımını otomatik hale getirmeye yönelik açık kaynaklı bir proje olduğunu öğrenin. 

Docker terminolojisi 

Docker teknolojisine yönelik hüküm ve tanımlar hakkında bilgi edinin. 

Docker kapsayıcıları, görüntüleri ve kayıt defterleri 

Docker kapsayıcı görüntülerinin, ortamlar genelinde tutarlı dağıtım için bir görüntü kayıt defterinde nasıl 
depolandığını öğrenin. 

ASP.NET Core için Docker görüntüleriASP.NET Core bir uygulamayı nasıl oluşturacağınızı ve kullanabileceğinizi 
öğrenin. Microsoft tarafından tutulan Docker görüntülerini araştırın ve kullanım örneklerini inceleyin. 

Visual Studio kapsayıcı araçları 

Visual Studio 'Nun Docker for Windows .NET Framework veya .NET Core 'u hedefleyen ASP.NET Core 
uygulamaları oluşturmayı, hata ayıklamayı ve çalıştırmayı nasıl desteklediğini öğrenin. Hem Windows hem de 
Linux kapsayıcıları desteklenir. 

Azure Container Registry yayımlama 

Azure 'da PovverShell kullanarak bir ASP.NET Core uygulamasını Docker konağına dağıtmak için Visual Studio 
kapsayıcı araçları uzantısı 'nın nasıl kullanılacağını öğrenin. 

Proxy sunucularıyla ve yük dengeleyicilerle çalışacak AS P.N ET Core yapılandırma 

Proxy sunucularının ve yük dengeleyiciler arkasında barındırılan uygulamalar için ek yapılandırma gerekebilir, 
isteklerin bir ara sunucu üzerinden geçirilmesi, genellikle orijinal istekle ilgili olarak düzen ve istemci İP 'si gibi 
bilgileri gizler, istekle ilgili bazı bilgilerin uygulamaya el ile iletilmesi gerekebilir. 




ASPNET Core için Docker görüntüleri 

23.11.2019 * 8 minutes to read ı Edit Online 


Bu öğreticide, Docker kapsayıcılarında ASP.NET Core uygulamasının nasıl çalıştırılacağı gösterilmektedir. 

Bu öğreticide şunları yaptınız: 

• Microsoft .NET Core Docker görüntüleri hakkında bilgi edinin 

• ASP.NET Core örnek uygulaması indirin 

• Örnek uygulamayı yerel olarak çalıştırma 

• Linux kapsayıcılarında örnek uygulamayı çalıştırma 

• Örnek uygulamayı VVİndovvs kapsayıcılarında çalıştırma 

• El ile derleyin ve dağıtın 

Docker görüntülerini ASP.NET Core 

Bu öğreticide, AS P.N ET Core örnek bir uygulama indirir ve Docker kapsayıcılarında çalıştırırsınız. Örnek, hem 
Linux hem de VVİndovvs kapsayıcılarıyla birlikte çalışmaktadır. 

Örnek Dockerfile, farklı kapsayıcılarda derlemek ve çalıştırmak için Docker Multi-Stage derleme özelliğini kullanır. 
Derleme ve çalıştırma kapsayıcıları, Docker Hub 'ında Microsoft tarafından sunulan görüntülerden oluşturulur: 

• dotnet/core/sdk 

Örnek, uygulamayı oluşturmak için bu görüntüyü kullanır.Görüntü, komut satırı araçlarını (CLı) içeren .NET 
Core SDK içerir. Görüntü yerel geliştirme, hata ayıklama ve birim testi için iyileştirilmiştir.Geliştirme ve 
derleme için yüklenen araçlar bunu görece büyük bir görüntü haline getirir. 

• dotnet/core/aspnet 

Örnek, uygulamayı çalıştırmak için bu görüntüyü kullanır.Görüntü, ASP.NET Core çalışma zamanını ve 
kitaplıklarını içerir ve üretimde uygulamaları çalıştırmak için iyileştirilmiştir. Dağıtım ve uygulama başlatma 
hızı için tasarlanan görüntü görece küçüktür, bu nedenle Docker kayıt defterinden Docker ana bilgisayarına 
ağ performansı en iyi duruma getirilmiştir. Yalnızca bir uygulamayı çalıştırmak için gereken ikili dosyalar ve 
içerikler kapsayıcıya kopyalanır, içerik çalıştırılmaya hazırlanıyor ve Docker run en hızlı süreyi uygulama 
başlatma ile etkinleştirir. Docker modelinde dinamik kod derlemesi gerekli değildir. 

Önkoşullar 

• .NET Core 2,2 SDK 

• .NET Core SDK 3,0 

• Docker Client 18,03 veya üzeri 

o Linux dağıtımları 
o CentOS 
o Debian 
o Fedora 
o Ubuntu 


o macOS 
o VVİndovvs 







• Git 


Örnek uygulamayı indirin 

• .NET Core Docker deposunukopyalayarak örneği indirin: 

git done https://github.com/dotnet/dotnet-docker 


Uygulamayı yerel olarak çalıştırma 

• DotNet-Docker/Samples/aspnetapp/aspnetappkor\urr\ur\dak\ proje klasörüne gidin. 

• Uygulamayı yerel olarak derlemek ve çalıştırmak için aşağıdaki komutu çalıştırın: 

dotnet run 

• Uygulamayı test etmek için bir tarayıcıda http://iocaihost:5000 ' a gidin. 

• Uygulamayı durdurmak için komut isteminde CTRL + C tuşlarına basın. 

Linux kapsayıcısında çalıştırma 

• Docker istemcisinde Linux kapsayıcıları ' na geçin. 

• DotNet-Docker/Samples/aspnetappkonurr\ur\dak\ Dockerfile klasörüne gidin. 

• Örneği Docker 'da derlemek ve çalıştırmak için aşağıdaki komutları çalıştırın: 

docker build -t aspnetapp . 

docker run -it --rm -p 5000:80 --name aspnetcore_sample aspnetapp 

build komutu bağımsız değişkenleri: 

o Görüntüyü aspnetapp olarak adlandırın, 
o Geçerli klasörde Dockerfile dosyasını arayın (sonundaki süre). 

Run komutu bağımsız değişkenleri: 

o Bir sözde TTY ayırın ve ekli olmasa bile açık tutun. ( --interactive --tty ile aynı etkiye sahiptir.) 
o Kapsayıcıyı çıkış sırasında otomatik olarak kaldır. 

o Yerel makinedeki 5000 numaralı bağlantı noktasını kapsayıcıda 80 numaralı bağlantı noktasına eşleyin, 
o Kapsayıcının aspnetcore_sample adı. 
o Aspnetapp görüntüsünü belirtin. 

• Uygulamayı test etmek için bir tarayıcıda http://iocaihost:5000 ' a gidin. 

Bir VVindovvs kapsayıcısında Çalıştır 

• Docker istemcisinde VVindovvs kapsayıcıları ' na geçin, 
dotnet-docker/samples/aspnetapp konumundaki Docker dosya klasörüne gidin. 

• Örneği Docker 'da derlemek ve çalıştırmak için aşağıdaki komutları çalıştırın: 







docker build -t aspnetapp . 

docker run -it --rm --name aspnetcore_sample aspnetapp 

• Windows kapsayıcıları için, kapsayıcının İP adresine ( http://iocaihost 15000 göz atma çalışmayacak) sahip 
olmanız gerekir: 

o Başka bir komut istemi açın. 

o Çalışan kapsayıcıları görmek için docker ps çalıştırın. "Aspnetcore_sample" kapsayıcısının orada 
olduğunu doğrulayın. 

o Kapsayıcının İP adresini göstermek için docker exec aspnetcore_sampie ipconfig çalıştırın. Komutun 


çıktısı şu örneğe benzer şekilde görünür: 

Ethernet adapter Ethernet: 


Connection-specific DNS Suffix 

contoso.com 

Link-local IPv6 Address . 

fe80::1967:6598:124:cfa3%4 

IPv4 Address. 

172.29.245.43 

Subnet Mask . 

255.255.240.0 

Default Gateway . 

172.29.240.1 


• Kapsayıcı I Pv4 adresini (örneğin, 172.29.245.43) kopyalayın ve uygulamayı test etmek için tarayıcı adres 
çubuğuna yapıştırın. 

El ile derleyin ve dağıtın 

Bazı senaryolarda, çalışma zamanında gerekli olan uygulama dosyalarını kopyalayarak bir kapsayıcıya uygulama 
dağıtmak isteyebilirsiniz. Bu bölümde nasıl el ile dağıtım yapılacağı gösterilmektedir. 

• DotNet-Docker/Samples/aspnetapp/aspnetappkonumundakl proje klasörüne gidin. 

• DotNet Publish komutunu çalıştırın: 

dotnet publish -c Release -o published 


Komut bağımsız değişkenleri: 

o Uygulamayı yayın modunda (varsayılan olarak hata ayıklama modu) oluşturun, 
o Yayımlanan klasörde dosyaları oluşturun. 

• Uygulamayı çalıştırın. 

o Windows: 


dotnet published\aspnetapp.dll 


o Linux: 


dotnet published/aspnetapp.dil 

• Giriş sayfasını görmek için http://iocaihost:5000 gidin. 

El ile yayınlanan uygulamayı bir Docker kapsayıcısı içinde kullanmak için yeni bir Dockerfile oluşturun ve 
kapsayıcıyı derlemek için docker build . komutunu kullanın. 

















FROM mcr.microsoft.com/dotnet/core/aspnet:2.2 AS runtime 
IaIORKDIR /app 

COPY published/aspnetapp.dll ./ 

ENTRYPOINT ["dotnet", "aspnetapp.dll"] 

Dockerfile 

Daha önce çalıştırdığınız docker buiid komutu tarafından kullanılan Dockerfile 'ı aşağıda bulabilirsiniz, 
dotnet pubiish , bu bölümde derlemek ve dağıtmak için kullandığınız şekilde aynı şekilde kullanır. 

FROM mcr.microsoft.com/dotnet/core/sdk: 2.2 AS buiid 
IaIORKDIR /app 

# copy csproj and restore as distinct layers 
COPY *.sln . 

COPY aspnetapp/*.csproj ./aspnetapp/ 

RUN dotnet restore 

# copy everything else and buiid app 
COPY aspnetapp/. ./aspnetapp/ 

IaIORKDIR /app/aspnetapp 

RUN dotnet pubiish -c Release -o out 


FROM mcr.microsoft.com/dotnet/core/aspnet: 2.2 AS runtime 
IaIORKDIR /app 

COPY --from=build /app/aspnetapp/out ./ 

ENTRYPOINT ["dotnet", "aspnetapp.dll"] 


FROM mcr.microsoft.com/dotnet/core/aspnet: 3.0 AS runtime 
IaIORKDIR /app 

COPY published/aspnetapp.dll ./ 

ENTRYPOINT ["dotnet", "aspnetapp.dll"] 


Dockerfile 

Daha önce çalıştırdığınız docker buiid komutu tarafından kullanılan Dockerfile 'ı aşağıda bulabilirsiniz, 
dotnet pubiish , bu bölümde derlemek ve dağıtmak için kullandığınız şekilde aynı şekilde kullanır. 

FROM mcr.microsoft.com/dotnet/core/sdk:3.0 AS buiid 
IaIORKDIR /app 

# copy csproj and restore as distinct layers 
COPY *.sln . 

COPY aspnetapp/*.csproj ./aspnetapp/ 

RUN dotnet restore 

# copy everything else and buiid app 
COPY aspnetapp/. ./aspnetapp/ 

IaIORKDIR /app/aspnetapp 

RUN dotnet pubiish -c Release -o out 

FROM mcr.microsoft.com/dotnet/core/aspnet: 3.0 AS runtime 
IaIORKDIR /app 

COPY --from=build /app/aspnetapp/out ./ 

ENTRYPOINT ["dotnet", "aspnetapp.dll"] 





FROM mcn.microsoft.eom/dotnet/core/aspnet:3.0 AS runtime 
l/JORKDIR /app 

COPY published/aspnetapp.dil ./ 

ENTRYPOINT ["dûtnet", "aspnetapp.dll"] 


Ek kaynaklar 

• Docker derleme komutu 

• Docker Run komutu 

• Docker örneğine AS P.N ET Core (Bu öğreticide kullanılan bir tane). 

• Proxy sunucularıyla ve yük dengeleyicilerle çalışacak ASP.NET Core yapılandırma 

• Visual Studio Docker araçlarıyla çalışma 

• Visual Studio kodu ile hata ayıklama 

Sonraki adımlar 

Örnek uygulamayı içeren git deposu, belgeleri de içerir. Depodaki kullanılabilir kaynaklara genel bir bakış için 
Readme dosyasınabakın. Özellikle, HTTPS 'yi uygulamayı öğrenin: 

HTTPS üzerinden Docker ile AS P.N ET Core uygulamaları geliştirme 



ASPNET Core ile Visual Studio kapsayıcı araçları 

26.07.2019 • 16 minutes to read ı Edit Online 


Visual Studio 2017 ve üzeri sürümleri, .NET Core 'u hedefleyen ASP.NET Core Kapsayıcılı uygulama oluşturma, 
hata ayıklama ve çalıştırma desteği sağlar. Hem VVİndovvs hem de Linux kapsayıcıları desteklenir. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Önkoşullar 

• VVİndovvs için docker 

• .NET Core platformlar arası geliştirme iş yüküyle Visual Studio 2019 


Yükleme ve kurulum 

Docker yüklemesi için öncelikle Docker for VVİndovvs bilgileri gözden geçirin: 1 i yüklemeden öncebilmeniz 
gerekenler. Ardından, VVİndovvs İçin Docker'ı yüklersiniz. 


Docker for VVİndovvs içindeki paylaşılan sürücüler , birim eşlemesini ve hata ayıklamayı destekleyecek şekilde 
yapılandırılmalıdır. Sistem tepsisinin Docker simgesine sağ tıklayın, Ayarlar' ı seçin ve paylaşılan sürücüler' i 
seçin. Docker' ı n dosyaları depoladığı sürücüyü seçin. Uygula'ya tıklayın. 


3 $ Settings 

General 
Shared Drives 
Advanced 

Netvvork 

Proxies 

Docker Daemon 
Diagnose & Feedback 
Reset 

0 Docker is running 


X 


Shared Drives 

Select the local drives you want to be available to 
your containers. 




Apply 


TIP 

Visual Studio 2017 sürümleri 1 5,6 ve sonraki sürümler, paylaşılan sürücülerin yapılandırılmadığı zaman sorar. 


Docker kapsayıcısına proje ekleme 


AS P.N ET Core bir projeyi Kapsayıcılı hale getirmek için, projenin .N ET Core 'u hedeflemesi gerekir. Hem Linux 

















hem de VVİndovvs kapsayıcıları desteklenir. 

Bir projeye Docker desteği eklerken, bir Windows veya Linux kapsayıcısı seçin. Docker ana bilgisayarı aynı 
kapsayıcı türünü çalıştırıyor olmalıdır. Çalışan Docker örneğindeki kapsayıcı türünü değiştirmek için, sistem 
tepsisinin Docker simgesine sağ tıklayın ve VVİndovvs kapsayıcılarına geç... ' i seçin veya Linux kapsayıcılarına 
geç.. 

Yeni uygulama 

ASP.NET Core VVeb uygulaması proje şablonlarıyla yeni bir uygulama oluştururken Docker desteğini 
etkinleştir onay kutusunu seçin: 

0 Enable Docker Support 

OS: VVİndovvs 

Requires Docker for VVİndovvs 

Docker support can also be enabled later Learn more 

Hedef çerçeve .NET Core ise, İşletim sistemi açılır listesi bir kapsayıcı türü seçimine izin verir. 

Mevcut uygulama 

.N ET Core 'u hedefleyen AS P.N ET Core projeleri için, araç aracılığıyla Docker desteği eklemenin iki seçeneği vardır. 
Visual Studio 'da projeyi açın ve aşağıdaki seçeneklerden birini belirleyin: 

• Proje menüsünden Docker desteği ' ni seçin. 

• Çözüm Gezgini projeye sağ tıklayın veDocker desteği Ekle > 1 yi seçin. 

Visual Studio kapsayıcı araçları, .NET Framevvork hedefleme ASP.NET Core var olan bir projeye Docker eklemeyi 
desteklemez. 

Dockerfile genel bakış 

Bir Dockerfile, son bir Docker görüntüsü oluşturmak için tarif, proje köküne eklenir.içindeki komutları anlamak için 
Dockerfile başvurusuna bakın. Bu belirli Dockerfile , dört farklı, adlandırılmış derleme aşamaları ile çok aşamalı bir 
yapı kullanır: 

FROM mcr.microsoft.com/dotnet/core/aspnet: 2.1 AS base 
IaIORKDIR /app 
EXPOSE 59518 
EXPOSE 44364 

FROM mcr.microsoft.com/dotnet/core/sdk: 2.1 AS build 
IaIORKDIR /src 

COPY HelloDockerTools/HelloDockerTools.csproj HelloDockerTools/ 

RUN dotnet restore HelloDockerTools/HelloDockerTools.csproj 
COPY . . 

IaIORKDIR /src/HelloDockerTools 

RUN dotnet build HelloDockerTools.csproj -c Release -o /app 
FROM build AS publish 

RUN dotnet publish HelloDockerTools.csproj -c Release -o /app 

FROM base AS final 
IaIORKDIR /app 

COPY --from=publish /app . 

ENTRYPOINT ["dotnet ", "HelloDockerTools.dll"] 

Yukarıdaki Dockerfile , Microsoft/DotNet görüntüsünü temel alır. Bu temel görüntü, ASP.NET Core çalışma zamanı 
ve NuGet paketlerini içerir. Paketler, başlangıç performansını geliştirmek için derlenen tek zaman (JıT). 









Yeni proje iletişim kutusunun https İçin Yapılandır onay kutusu İşaretlendiğinde, dockerfile iki bağlantı noktasını 
kullanıma sunar. HTTP trafiği için bir bağlantı noktası kullanılır; diğer bağlantı noktası HTTPS için kullanılır. Onay 
kutusu işaretli değilse, HTTP trafiği için tek bir bağlantı noktası (80) gösterilir. 

FROM microsoft/aspnetcore:2.0 AS base 
IaIORKDIR /app 
EXP0SE 80 

FROM microsoft/aspnetcore-build:2.0 AS build 
IaIORKDIR /src 

COPY HelloDockerTools/HelloDockerTools.csproj HelloDockerTools/ 

RUN dotnet restore HelloDockerTools/HelloDockerTools.csproj 
COPY . . 

IaIORKDIR /src/HelloDockerîools 

RUN dotnet build HelloDockerTools.csproj -c Release -o /app 
FROM build AS publish 

RUN dotnet publish HelloDockerTools.csproj -c Release -o /app 

FROM base AS final 
IaIORKDIR /app 

COPY --from=publish /app . 

ENTRYPOINT ["dotnet ", "HelloDockerTools.dll"] 

Yukarıdaki Dockerfile , Microsoft/aspnetcore görüntüsünü temel alır. Bu temel görüntüde, başlangıç performansını 
geliştirmek için tek seferlik (JıT) derlenen ASP.NET Core NuGet paketleri bulunur. 

Bir uygulamaya kapsayıcı Orchestrator desteği ekleme 

Visual Studio 2017, tek kapsayıcı düzenleme çözümü olarak Docker Compose 15,7 veya önceki bir sürümü 
destekler. Docker Compose yapıtlar, Docker desteği Ekle > aracılığıyla eklenir. 

Visual Studio 2017 sürümleri 15,8 veya üzeri bir düzenleme çözümünü yalnızca sorulduğunda ekleyin. Çözüm 
Gezgini 1 de projeye sağ tıklayın vekapsayıcı Orchestrator desteği Ekle > ' yi seçin, iki farklı seçenek sunulur: 

Docker Compose ve Service Fabric. 

Docker Compose 

Visual Studio kapsayıcı araçları, aşağıdaki dosyalarla çözüme bir Docker-Compose projesi ekler: 

• Docker-Compose. dcproj- projeyi temsil eden dosya. Kullanılacak işletim <DockerTargetos> sistemini belirleyen 
bir öğesi içerir. 

• . dockengnore - Derleme bağlamı oluştururken hariç tutulacak dosya ve Dizin desenlerini listeler. 

• Docker-Compose.yıml-, sırasıyla ve docker-compose build docker-compose run ile oluşturulan ve çalıştıran 
görüntülerin koleksiyonunu tanımlamak için kullanılan temel Docker Compose dosyasıdır. 

• Docker-Compose. override. yıml- isteğe bağlı bir dosya, Docker Compose tarafından okunan hizmetler için 
yapılandırma geçersiz kılmalarıyla. Visual Studio bu 

docker-compose -f "docker-compose.yml" -f "docker-compose.override.yml" dosyalan birleştirmek için yürütülür. 
Docker-Compose. yml dosyası, proje çalışırken oluşturulan görüntünün adına başvurur: 

version: '3.4' 

Services: 

hellodockertools: 

image: ${DOCKER_REGISTRY}hellodockertools 
build: 

context: . 

dockerfile: HelloDockerTools/Dockerfile 








Yukarıdaki örnekte, image: heliodockertools uygulama hata ayıklama modunda çalıştırıldığında 
heliodockertools:dev görüntüyü oluşturur. Uygulama yayın modunda çalıştığında görüntüoluşturulur. 
heliodockertools rlatest 

Görüntü kayıt defterine itilse, görüntü adını Docker Hub Kullanıcı adı dockerhubusername/heliodockertools 
(örneğin,) ile önek yapın. Alternatif olarak, yapılandırmaya bağlı olarak, görüntü adını özel kayıt defteri URL 'sini 
(örneğin privateregistry.domain.com/heiiodockertoois ,) içerecek şekilde değiştirin. 

Yapı yapılandırmasına (örneğin, hata ayıklama veya sürüm) göre farklı davranışlar istiyorsanız, yapılandırmaya 
özgü Docker-Compose dosyaları ekleyin. Dosyalar derleme yapılandırmasına göre adlandırılmalıdır (örneğin, 
Docker-Compose. vs. Debug. yıml ve Docker-Compose. vs. Release. yıml) ve Docker-Compose-override. yıml 
dosyasıyla aynı konuma yerleştirildi. 

Yapılandırmaya özgü geçersiz kılma dosyalarını kullanarak, hata ayıklama ve yayın derleme yapılandırmaları için 
farklı yapılandırma ayarları (ortam değişkenleri veya giriş noktaları gibi) belirtebilirsiniz. 

Service Fabric 

Temel önkoşullaraek olarak, Service Fabric Orchestration çözümü aşağıdaki önkoşulları ister: 

• MICROSOFT Azure SERVİCE fabric SDK sürüm 2,6 veya üzeri 

• Visual Studio 'nun Azure geliştirme iş yükü 

Service Fabric, Windows 'da yerel geliştirme kümesinde Linux kapsayıcıları çalıştırmayı desteklemez. Proje zaten 
bir Linux kapsayıcısı kullanıyorsa, Visual Studio VVİndovvs kapsayıcılarına geçiş yapmanızı ister. 

Visual Studio kapsayıcı araçları aşağıdaki görevleri yapılır: 

• Çözüme bir <Project_Name>uygulaması Service Fabric uygulama projesi ekler. 

• ASP.NET Core projesine bir dockerfile ve. dockerıgnore dosyası ekler.ASP.NET Core projesinde zaten bir 
Dockerfile varsa, dockerfile. orijinalolarak yeniden adlandırılır. Aşağıdakine benzer yeni bir 

Dockerfile oluşturulur: 

# See https://aka.ms/containenimagehelp fon infonmation on how to use Windows Senven 1709 containens 
with Senvice Fabnic. 

# FROM micnosoft/aspnetcone:2.0-nanosenven-1709 
FROM micnosoft/aspnetcone:2.0-nanosenven-sac2016 
ARG sounce 

IaIORKDIR /app 

COPY ${sounce:-obj/Docken/publish} . 

ENTRYPOINT ["dotnet", "HelloDockenTools.dll"] 


ASP.NET Core projenin 

<IsServiceFabricServiceProject> 

. csproj dosyasına bir öğe ekler: 

<IsServiceFabricServiceProject>True</IsServiceFabricServiceProject> 


• AS P.N ET Core projesine bir PackageRoot klasörü ekler. Klasör, yeni hizmet için hizmet bildirimini ve 
ayarlarını içerir. 

Daha fazla bilgi için bkz. bir VVİndovvs kapsayıcısında .N ET uygulamasını Azure Service Fabric dağıtma. 

Hata ayıklama 

Araç çubuğundaki hata ayıklama açılır listesinden Docker ' ı seçin ve uygulamada hata ayıklamayı başlatın. Çıkış 
penceresinin Docker görünümü aşağıdaki işlemleri gerçekleşirken gösterir: 

• Microsoft/DotNet çalışma zamanı görüntüsünün 2,1 -aspnetcore-Runtime etiketi elde edilir (zaten önbellekte 









değilse). Görüntüde ASP.NET Core ve ,N ET Core çalışma zamanlan ile ilişkili Kitaplıklar yüklenir.Üretimde 
ASP.NET Core uygulamaları çalıştırmak için en iyi duruma getirilmiştir. 

• Ortam değişkeni kapsayıcı içinde olarak Development ayarlanır. aspnetcore_environment 

• Dinamik olarak atanan iki bağlantı noktası sunulur: bir HTTP ve diğeri HTTPS için. Localhost 'a atanan bağlantı 
noktası docker ps komutla sorgulanabilir. 

• Uygulama kapsayıcıya kopyalanır. 

• Varsayılan tarayıcı, dinamik olarak atanan bağlantı noktası kullanılarak kapsayıcıya eklenmiş hata ayıklayıcı ile 
başlatılır. 


Uygulamanın elde edilen Docker görüntüsü devolarak etiketlendi. Görüntü, Microsoft/DotNet temel görüntüsünün 
2,1 -aspnetcore-Runtime etiketine dayalıdır. Komutunu Paket Yöneticisi Konsolu (PMC) penceresinde çalıştırın, 
docker images Makinedeki görüntüler görüntülenir: 


REPOSITORY 

TAG 

IMAGE ID 

CREATED 

SİZE 

hellodockertools 

dev 

d72ce0fldfe7 

30 seconds ago 

255MB 

microsoft/dotnet 

2.1-aspnetcore-runtime 

fcc3887985bb 

6 days ago 

255MB 


• Microsoft/aspnetcore çalışma zamanı görüntüsü alındı (zaten önbellekte yoksa). 

• Ortam değişkeni kapsayıcı içinde olarak Development ayarlanır. aspnetcore_environment 

• 80 numaralı bağlantı noktası, localhost için dinamik olarak atanmış bir bağlantı noktasıyla gösterilir ve 
eşleştirilir. Bağlantı noktası Docker ana bilgisayarı tarafından belirlenir ve docker ps komutla sorgulanabilir. 

• Uygulama kapsayıcıya kopyalanır. 

• Varsayılan tarayıcı, dinamik olarak atanan bağlantı noktası kullanılarak kapsayıcıya eklenmiş hata ayıklayıcı ile 
başlatılır. 


Uygulamanın elde edilen Docker görüntüsü devolarak etiketlendi. Görüntü, Microsoft/aspnetcore temel 
görüntüsünü temel alır. Komutunu Paket Yöneticisi Konsolu (PMC) penceresinde çalıştırın, docker images 
Makinedeki görüntüler görüntülenir: 


REPOSITORY 

TAG 

IMAGE ID 

CREATED 

SİZE 

hellodockertools 

dev 

5fafe5dlad5b 

4 minutes ago 

347MB 

microsoft/aspnetcore 

2.0 

C69d39472da9 

13 days ago 

347MB 


NOTE 

Hata ayıklama yapılandırmalarının, yinelemeli deneyim sağlamak için birim bağlama kullanması nedeniyle geliştirme 
görüntüsünde uygulama içeriği eksik. Bir görüntüyü göndermek için yayın yapılandırmasını kullanın. 


docker ps Komutu PMC 'de çalıştırın. Uygulamanın, kapsayıcıyı kullanarak çalıştığını unutmayın: 

CONTAINER ID IMAGE COMMAND CREATED STATUS 

PORTS NAMES 

baf9a678c88d hellodockertools:dev "C: \\remote_debugge. .." 21 seconds ago Up 19 seconds 

0.0.0.0:37630->80/tcp dockercompose4642749010770307127_hellodockertools_l 


Düzenle ve devam et 

Statik dosyalardaki ve Razor görünümlerindeki değişiklikler, derleme adımına gerek kalmadan otomatik olarak 
güncelleştirilir. Güncelleştirmeyi görüntülemek için değişikliği yapıp tarayıcıyı kaydedin ve yenileyin. 

Kod dosyası değişiklikleri derleme gerektirir ve kapsayıcı içinde Kestrel yeniden başlatılır. Değişikliği yaptıktan 














sonra, işlemi gerçekleştirmek ctrl+fs ve uygulamayı kapsayıcı içinde başlatmak için öğesini kullanın. Docker 
kapsayıcısı yeniden derlenmez veya durdurulmaz, docker ps Komutu PMC 'de çalıştırın. Özgün kapsayıcının 10 
dakikadan önce çalışmaya devam ettiğini fark edin: 

CONTAINER ID IMAGE COMMAND CREATED STATUS 

PORTS NAMES 

baf9a678c88d hellodockertools:dev "C: \\remote_debugge. .." 10 minutes ago Up 10 minutes 

0.0.0.0:37630->80/tcp dockercompose4642749010770307127_hellodockertools_l 


Docker görüntülerini yayımlama 

Uygulamanın geliştirme ve hata ayıklama döngüsünü tamamladıktan sonra, Visual Studio kapsayıcı araçları 
uygulamanın üretim görüntüsünü oluşturmaya yardımcı olur. Yapılandırma açılır öğesini değiştirerek uygulamayı 
serbest bırakın ve oluşturun. Araç, Docker Hub 'dan (zaten önbellekte değilse) derleme/yayımlama görüntüsünü 
alır. Bir görüntü, özel kayıt defterine veya Docker Hub 'ına gönderilebilecek en son etiketle oluşturulur. 

Görüntülerin listesini görmek için bu komutuPMC'deçalıştırın. docker images Aşağıdakine benzer bir çıktı 
görüntülenir: 


REPOSITORY 

TAG 

IMAGE ID 

CREATED 

SİZE 

hellodockertools 

latest 

e3984a64230c 

About a minute ago 

258MB 

hellodockertools 

dev 

d72ce0fldfe7 

4 minutes ago 

255MB 

microsoft/dotnet 

2.1-sdk 

9e243dbl5f91 

6 days ago 

1.7GB 

microsoft/dotnet 

2.1-aspnetcore-runtime 

fcc3887985bb 

6 days ago 

255MB 


REPOSITORY 

TAG 

IMAGE ID 

CREATED 

SİZE 

hellodockertools 

latest 

cd28f0d4abbd 

12 seconds ago 

349MB 

hellodockertools 

dev 

5fafe5dlad5b 

23 minutes ago 

347MB 

microsoft/aspnetcore-buiid 

2.0 

7fed40fbb647 

13 days ago 

2.02GB 

microsoft/aspnetcore 

2.0 

C69d39472da9 

13 days ago 

347MB 


Önceki çıktıda microsoft/aspnetcore listelenen microsoft/aspnetcore-buiid ve görüntüleri .N ET Core 2,1 ' deki 
görüntülerle değiştirilmiştir, microsoft/dotnet Daha fazla bilgi için bkz. Docker depoları geçiş duyurusu. 


NOTE 

Komut docker images , havuz adları ve etiketleri (Yukarıda listelenmeyen) < > olarak tanımlanmış (yukarıda listelenmemiş) 
bir Aracı görüntüleri döndürür. Bu adlandırılmamış görüntüler, çok aşamalı derleme docke/fdetarafından üretilir. Son 
görüntünün—oluşturulması verimliliği artırır ancak değişiklikler gerçekleştiğinde yalnızca gerekli katmanlar yeniden 
oluşturulur. Ara görüntülere artık gerek kalmadığında Docker rmi komutunu kullanarak bunları silin. 


Geliştirme görüntüsüne kıyasla üretim veya yayın görüntüsünün boyutunun daha küçük olması için bir beklentisi 
olabilir. Birim eşleme nedeniyle, hata ayıklayıcı ve uygulama, kapsayıcıda değil, yerel makineden çalıştırılıyor .En son 
görüntü, uygulamayı bir konak makinesinde çalıştırmak için gerekli uygulama kodunu paketlendi. Bu nedenle, 

Delta uygulama kodunun boyutudur. 

Ek kaynaklar 

• Visual Studio ile kapsayıcı geliştirme 

• Azure Service Fabric: Geliştirme ortamınızı hazırlama 

• Bir VVİndovvs kapsayıcısında .N ET uygulamasını Azure 'a dağıtma Service Fabric 

• Docker ile Visual Studio geliştirme sorunlarını giderme 

• Visual Studio kapsayıcı araçları GitHub deposu 















Proxy sunucularıyla ve yük dengeleyicilerle 
çalışacak ASPNET Core yapılandırma 

23.11.2019 * 23 minutes to read ı Edit Online 


Luke Latham ve Chris 'e göre 

ASP.NET Core için Önerilen yapılandırmada, uygulama IIS/ASP. NET Core modülü, NGINX veya 

Apache kullanılarak barındırılır. Proxy sunucuları, yük dengeleyiciler ve diğer ağ gereçleri, genellikle 

istek hakkında uygulamaya ulaşmadan önce bu bilgileri gizlemediğinde: 

• HTTPS istekleri HTTP üzerinden proxy olduğunda, özgün düzen (HTTPS) kaybolur ve bir üst bilgide 
iletilmesi gerekir. 

• Bir uygulama, Internet veya şirket ağında gerçek kaynağını değil, ara sunucudan bir istek aldığından, 
kaynak istemci İP adresinin de bir üst bilgide iletilmesi gerekir. 

Bu bilgiler, istek işlemede, örneğin yeniden yönlendirmeler, kimlik doğrulama, bağlantı oluşturma, ilke 

değerlendirmesi ve istemci coğrafi konum gibi önemli olabilir. 

İletilen üstbilgiler 

Kurala göre, proxy 'leri HTTP başlıklarında iletme bilgileri. 

Ü STB ILGI AÇIKLAMA 

X-lletilmiş-lçin , isteği başlatan istemciyle ilgili bilgileri ve bir proxy 

zincirinde sonraki proxy 'leri barındırır. Bu parametre İP 
adresleri (ve isteğe bağlı olarak bağlantı noktası 
numaraları) içerebilir. Bir ara sunucu zincirinde, ilk 
parametre isteğin ilk yaptığı istemciyi gösterir. Sonraki 
proxy tanımlayıcıları izler. Zincirdeki son proxy, 
Parametreler listesinde değil. Son proxy 'nin İP adresi ve 
isteğe bağlı olarak bir bağlantı noktası numarası, 
aktarım katmanında uzak İP adresi olarak kullanılabilir. 


X-lletilen-proto Kaynak düzenin değeri (HTTP/HTTPS). Bu değer, istek 

birden çok proxy 'ye geçen bir düzen listesi de olabilir. 


X-lletilen-konak Ana bilgisayar üst bilgisi alanının özgün değeri. 

Genellikle, proxy 'ler ana bilgisayar üst bilgisini 
değiştirmez. Proxy 'nin konak üstbilgilerini 
doğrulamadığı veya kısıtlayamayacağı sistemleri 
etkileyen ayrıcalık yükselmesi güvenlik açığı hakkında 
bilgi için bkz. Microsoft Güvenlik Danışmanlığı CVE- 
2018 - 0787 . 


Microsoft. AspNetCore. HttpOverrides paketindeki İletilen üstbilgiler ara yazılımı, bu üst bilgileri okur 
ve HttpContextilişkili alanları doldurur. 

Ara yazılım güncelleştirmeleri: 

• HttpContext. Connection. Remoteıpaddress - x-Forwarded-For üst bilgi değeri kullanılarak ayarlanır. 
Ek ayarlar, ara yazılımın RemoteipAddress nasıl ayarlakullandığını etkiler. Ayrıntılar için bkz. etilen 
üstbilgiler ara yazılım seçenekleri. 






• x-Forwarded-Proto üst bilgi değeri kullanılarak ayarlanan HttpContext. Request. Scheme 

• - x-Forwarded-Host üst bilgi değeri kullanılarak ayarlanan HttpContext. Request. Hoşt . 

iletilen üstbilgiler ara yazılımı varsayılan ayarları yapılandırılabilir. Varsayılan ayarlar şunlardır: 

• Uygulama ve isteklerin kaynağı arasında yalnızca bir ara sunucu vardır. 

• Bilinen proxy 'ler ve bilinen ağlar için yalnızca geri döngü adresleri yapılandırılır. 

• iletilen üst bilgiler x-Forwarded-For ve x-Forwarded-Proto olarak adlandırılır. 

Tüm ağ gereçleri, ek yapılandırma olmadan x-Forwarded-For ve x-Forwarded-Proto üst bilgilerini 
eklemez. Proxy istekler uygulamaya ulaştığında bu üst bilgileri içermiyorsa, Gereç üreticinizin 
kılavuzuna başvurun. Gereç x-Forwarded-For ve x-Forwarded-Proto farklı üstbilgi adları kullanıyorsa, 
ForvvardedForHeaderName ve ForvvardedProtoHeaderName seçeneklerini gereç tarafından kullanılan 
üstbilgi adlarıyla eşleşecek şekilde ayarlayın. Daha fazla bilgi için bkz. iletilen üstbilgiler ara yazılım 
seçenekleri ve farklı üstbilgi adları kullanan bir proxy için yapılandırma. 

11S/lIS Express ve ASP.NET Core modülü 

iletilen üstbilgiler ara yazılımı, uygulama MS 'nin arkasında ve ASP.NET Core modülünden sonra işlem 
dışı barındırıIiyorsa 11S tümleştirme ara yazılımı tarafından varsayılan olarak etkinleştirilir, iletilen 
üstbilgiler ara yazılımı, iletilen üst bilgilerle (örneğin, İP aldatmacası) güven sorunları nedeniyle 
ASP.N ET Core modülüne özgü kısıtlanmış bir yapılandırmaya sahip olan ara yazılım ardışık düzeninde 
ilk olarak çalışır. Ara yazılım, x-Forwarded-For ve x-Forwarded-Proto üst bilgilerini iletmek üzere 
yapılandırılır ve tek bir localhost proxy ile kısıtlanır. Ek yapılandırma gerekliyse, İletilen üstbilgiler ara 
yazılım seçeneklerinebakın. 

Diğer proxy sunucu ve yük dengeleyici senaryoları 

işlem dışıbarındırma sırasında 11S tümleştirmesi 'nin kullanılması dışında, iletilen üstbilgiler ara yazılımı 
varsayılan olarak etkinleştirilmemiştir. Bir uygulamanın iletilen üstbilgileri 

UseForvvardedHeadersişlemesi için iletilen üstbilgiler ara yazılımı etkinleştirilmelidir. Ara yazılım için 
ForvvardedHeadersOptions belirtilmemişse, ara yazılımı etkinleştirdikten sonra varsayılan 
Forvvardedheadersoptions. ForvvardedHeaders , Forvvardedheaders. None' dir. 

X-Forwarded-For ve X-Forwarded-Proto Üst Startup.ConfigureServices bilgilerini iletmek için 
ForvvardedFleadersOptions ile ara yazılımı yapılandırın. Diğer ara yazılım çağrılmadan önce 
startup.Configure UseForvvardedHeaders yöntemi çağırın: 













public void ConfigureServices(IServiceCollection Services) 

{ 

Services .AddMvc(); 

Services.Configure<ForwardedHeadersOptions>(options => 

{ 

options.ForwardedHeaders = 

ForwardedFleaders .XForwardedFor | ForwardedHeaders.XForwardedProto; 

})J 


public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

app.UseForwardedHeaders(); 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app. UseExceptionFlandler("/Home/Error"); 

} 

app.UseStaticFiles(); 

// In ASP.NET Core 1.x, replace the following line with: app.UseldentityO; 

app.UseAuthentication(); 

app.UseMvc(); 


NOTE 

startup. conf igureServices içinde ForvvardedHeadersOptions belirtilmemişse veya doğrudan uzantı 
yöntemine UseForvvardedHeaders, iletmek için varsayılan üstbilgiler Forvvardedheaders. None' dır. 
ForvvardedFleaders özelliği, iletmek için üst bilgilerle yapılandırılmalıdır. 


NGINX yapılandırması 

x-Forwarded-For ve x-Forwarded-Proto üstbilgilerini iletmek için bkz. NGINX ile Linux üzerinde ana 
bilgisayar ASP.NET Core. Daha fazla bilgi için bkz. NGINX: iletilen üstbilgiyi kullanma. 

Apache yapılandırması 

x-Forwarded-For otomatik olarak eklenir (bkz. Apache modülü mod_proxy: ters proxy İsteği 
üstbilgileri). x-Forwarded-Proto üst bilgisini iletme hakkında daha fazla bilgi için bkz. Apache ile Linux 
üzerinde ASP.NET Core barındırma. 

İletilen üstbilgiler ara yazılım seçenekleri 

İletilen üstbilgiler ara yazılımı davranışını kontrol ForvvardedHeadersOptions. Aşağıdaki örnek 
varsayılan değerleri değiştirir: 

• iletilen üst bilgilerdeki giriş sayısını 2 olarak sınırlandırın. 

• 127 . 0 . 10.1 bilinen bir proxy adresi ekleyin. 

• iletilen Üst bilgi adını varsayılan X-Forwarded-For X-Forwarded-For-My-Custom-Header-Name olacak 
şekilde değiştirin. 











Services.Configure<ForwardedHeadersOptions>(options => 

{ 

options.ForwardLimit = 2 ; 

options.KnownProxies.Add(IPAddress.Parse("127.0.10.1")); 

options.ForwardedForHeaderName = "X-Forwarded-For-My-Custom-Header-Name"; 

}); 


SEÇENEK AÇIKLAMA 

AllovvedHosts Ana bilgisayarları x-Forwarded-Host üst bilgisini 

belirtilen değerlerle kısıtlar. 

• Değerler, Ordinal-lgnore-Case kullanılarak 
karşılaştırılır. 

• Bağlantı noktası numaraları dışlanmalıdır. 

• Liste boşsa, tüm konaklara izin verilir. 

• Üst düzey joker karakter * boş olmayan tüm 
konaklara izin verir. 

• Alt etki alanı Joker karakterlere izin verilir ancak 
kök etki alanıyla eşleşmez. Örneğin 

* . contoso. com , kök etki alanı contoso.com 
değil, alt etki alanıyla eşleşir foo.contoso.com . 

• Unicode ana bilgisayar adlarına izin verilir, ancak 
eşleştirme için puni koduna dönüştürülür. 

• IPv6 adresleri sınırlayıcı ayraçları içermeli ve 
geleneksel biçimde olmalıdır (örneğin, 

[ABCD:EF01:2345:6789:ABCD:EF01:2345:6789] 

). IPv6 adresleri, farklı biçimler arasında mantıksal 
eşitlik denetimi için özel değildir ve hiçbir kurallı 
kullanım yapılmaz. 

• izin verilen konaklar kısıtlanamaması, bir 
saldırganın hizmet tarafından oluşturulan 
bağlantıları sızdırmasına izin verebilir. 

Varsayılan değer boş bir iList<string> . 


ForvvardedForHeaderName Bu özellik tarafından belirtilen üstbilgiyi, 

Forvvardedheadersdefaults varsayılan. 
XForwardedForHeaderNametarafından belirtilen bir 
yerine kullanın. Bu seçenek, proxy/iletici 
x-Forwarded-For üstbilgisini kullanmıyorsa ve bilgileri 
iletmek için başka bir üst bilgi kullandığında kullanılır. 

Varsayılan, x-Forwarded-For değeridir. 


ForvvardedHeaders Hangi ileticilerin işleneceğini tanımlar. Uygulanan 

alanların listesi için Forvvardedheaders numaralandırması 
1 ne bakın. Bu özelliğe atanan tipik değerler 

ForwardedHeaders.XForwardedFor | 

ForwardedHeaders.XForwardedProto 


Varsayılan değer Forvvardedheaders. None' dır. 









SEÇENEK 


AÇIKLAMA 


ForwardedHostHeaderName 

Forwardedheadersdefaults varsayılan. 
XForwardedHostHeaderNametarafından belirtilen yerine 
bu özellik tarafından belirtilen üstbilgiyi kullanın. Bu 
seçenek, proxy/iletici x-Forwarded-Host üstbilgisini 
kullanmıyorsa ve bilgileri iletmek için başka bir üst bilgi 
kullandığında kullanılır. 


Varsayılan, x-Forwarded-Host değeridir. 

ForvvardedProtoHeaderName 

Bu özellik tarafından belirtilen üstbilgiyi, 
Forvvardedheadersdefaults varsayılan. 
XForwardedProtoHeaderNametarafından belirtilen bir 
yerine kullanın. Bu seçenek, proxy/iletici 
x-Forwarded-Proto üstbilgisini kullanmıyorsa ve 
bilgileri iletmek için başka bir üst bilgi kullandığında 
kullanılır. 


Varsayılan, x-Forwarded-Proto değeridir. 

ForwardLimit 

işlenen üst bilgilerdeki giriş sayısını sınırlandırır. Limiti 
devre dışı bırakmak için nulı olarak ayarlayın, ancak 
bu yalnızca KnownProxi.es veya KnownNetworks 
yapılandırılırsa yapılmalıdır, null olmayan bir değer 
ayarlamak, yanlış yapılandırılmış proxy ferde ve ağdaki 
yan kanallardan gelen kötü amaçlı isteklere karşı 
koruma sağlamak için bir önlem (garanti değildir) olarak 
ayarlanır. 


iletilen üstbilgiler ara yazılımı, üst bilgileri sağdan sola 
doğru sırada işler. Varsayılan değer ( ı ) kullanılırsa, 
ForwardLimit değeri artmadığı müddetçe yalnızca üst 
bilgilerden en sağdaki değer işlenir. 


Varsayılan, ı değeridir. 

KnovvnNetvvorks 

iletilen üstbilgileri kabul etmek için bilinen ağların adres 
aralıkları. Sınıfsız Etki alanları arası yönlendirme (CıDR) 
gösterimini kullanarak İP aralıkları sağlayın. 


Sunucu çift modlu yuvalar kullanıyorsa, IPv 4 adresleri 
IPv 6 biçiminde sağlanır (örneğin, IPv 4 içinde, 

:: ff ff: 10.0.0. ı olarak temsil edilen 10.0.0.1). Bkz. 
IPAddress. MapTolPv 6 . HttpContext. Connection. 
Remoteıpaddressöğesine bakarak bu biçimin gerekip 
gerekmediğini saptayın. Daha fazla bilgi için, IPv 6 adresi 
olarak temsil edilen IPv 4 adresi İçin yapılandırma 
bölümüne bakın. 


Varsayılan değer, IPAddress. Loopback için tek bir giriş 
içeren bir ıı_ist <IPNetwork>. 







SEÇENEK 


AÇIKLAMA 


KnownProxies 

iletilen üstbilgileri kabul etmek için bilinen proxy ’lerin 
adresleri. Tam İP adresi eşleşmelerini belirtmek için 
KnownProxies kullanın. 


Sunucu çift modlu yuvalar kullanıyorsa, IPv 4 adresleri 
IPv 6 biçiminde sağlanır (örneğin, IPv 4 içinde, 

:: f■f f■f: 10.0.0. ı olarak temsil edilen 10.0.0.1). Bkz. 
IPAddress. MapTolPvü. HttpContext. Connection. 
Remoteıpaddressöğesine bakarak bu biçimin gerekip 
gerekmediğini saptayın. Daha fazla bilgi için, IPv 6 adresi 
olarak temsil edilen IPv 4 adresi İçin yapılandırma 
bölümüne bakın. 


Varsayılan değer, IPAddress. iPv6Loopback için tek bir 
giriş içeren bir nist <IPAddress>. 

OriginalForHeaderName 

Bu özellik tarafından belirtilen üstbilgiyi, 
Forvvardedheadersdefaults varsayılan. 
XOriginalForHeaderNametarafından belirtilen bir yerine 
kullanın. 


Varsayılan, x-original-For değeridir. 

OriginalHostPIeaderName 

Forvvardedheadersdefaults varsayılan. 
XOriginalFlostFleaderNametarafından belirtilen yerine 
bu özellik tarafından belirtilen üstbilgiyi kullanın. 


Varsayılan, x-original-Host değeridir. 

OriginalProtoFleaderName 

Bu özellik tarafından belirtilen üstbilgiyi, 
Forvvardedheadersdefaults varsayılan. 
XOriginalProtoPleaderNametarafından belirtilen bir 
yerine kullanın. 


Varsayılan, x- 0 riginal-Proto değeridir. 


RequireHeaderSymmetry Bilgi işlem sayısının, işlenmekte olan 

Forvvardedheadersoptions. ForvvardedHeaders arasında 
eşitlenmiş olmasını gerektir 

ASP.NET Core 1 . x içindeki varsayılan değer true . 
ASP.NET Core 2,0 veya sonraki sürümlerde varsayılan 
değer false . 


Senaryolar ve kullanım örnekleri 

İletilen üstbilgiler eklemek mümkün olmadığında ve tüm istekler güvenlidir 

Bazı durumlarda, iletilen üstbilgileri uygulamaya yönelik isteklere eklemek mümkün olmayabilir. Proxy 
tüm genel dış isteklerin HTTPS olduğunu zortacaktır, düzen herhangi bir tür ara yazılım kullanılmadan 
önce startup.Configure el ile ayarlanabilir: 








app.Use((context, next) => 

{ 

context.Request.Scheme = "https"; 
return next(); 

})J 

Bu kod bir geliştirme veya hazırlama ortamındaki ortam değişkeniyle veya diğer yapılandırma ayarıyla 
devre dışı bırakılabilir. 

Yol tabanı ve istek yolunu değiştiren proxy 'ler ile uğraşın 

Bazı proxy 'ler yolu bozulmadan, ancak yönlendirmenin düzgün çalışması için kaldırılması gereken bir 
uygulama temel yolu ile geçer. Usepathbaseextensions. usepathbase ara yazılımı, yolu HttpRequest. 
Path ve uygulama temeli yoluna, HttpRequest. pathbaseiçine böler. 

/foo , /foo/api/ı olarak geçirilen bir ara sunucu yolu için uygulama temel yolu ise, ara yazılım 
Request.PathBase /foo ve Request.Path aşağıdaki komutla /api/ı olarak ayarlar: 

app.UsePathBase("/foo"); 

Özgün yol ve yol tabanı, ara yazılım ters ' de çağrıldığında yeniden uygulanır. Ara yazılım sırası işleme 
hakkında daha fazla bilgi için bkz. ASP.NET Core ara yazılımı. 

Proxy, yolu kırpar (örneğin, /api/r' /foo/api/ı iletme), isteğin Pathbase özelliğini ayarlayarak yeniden 
yönlendirmeleri ve bağlantıları düzeltir: 

app.Use((contextj next) => 

{ 

context.Request.PathBase = new PathString("/foo"); 
return next(); 

}); 

Proxy yol verileri ekliyor ise, StartsWithSegments kullanarak yeniden yönlendirmeleri ve bağlantıları 
onarmak üzere yolun bir parçasını atın ve Path özelliğine atama yapın: 

app.Use((context, next) => 

{ 

if (context.Request.Path.StartsWithSegments("/foo", out var remainder)) 

{ 

context.Request.Path = remainder; 

} 

return next(); 

}); 

Farklı üstbilgi adları kullanan bir ara sunucu için yapılandırma 

Proxy, x-Forwarded-For adlı üstbiIgileri kullanmıyorsa ve proxy adresini/bağlantı noktasını ve kaynak 
düzen bilgilerini iletmek için x-Forwarded-Proto , ForvvardedForHeaderName ve 
ForvvardedProtoPleaderName seçeneklerini proxy tarafından kullanılan üstbilgi adlarıyla eşleşecek 
şekilde ayarlayın: 










Services.Configure<ForwardedHeadersOptions>(options => 

{ 

options.ForwardedForHeaderName = "Header_Name_Used_By_Proxy_For_X-Forwarded-For_Header"; 
options.ForwardedProtoHeaderName = "Header_Name_Used_By_Proxy_For_X-Forwarded-Proto_Header"; 
})J 


I Pv6 adresi olarak temsil edilen I Pv4 adresinin yapılandırması 

Sunucu çift modlu yuvalar kullanıyorsa, IPv4 adresleri IPv6 biçiminde sağlanır (örneğin, IPv4 'de 
: 0 . 0.1 veya : :ffff:a@ 0 :i olarak temsil edilen 10 . 0 . 0.1 ). Bkz. IPAddress. MapTolPv6. 

HttpContext. Connection. Remoteıpaddressöğesine bakarak bu biçimin gerekip gerekmediğini 
saptayın. 

Aşağıdaki örnekte, iletilen üstbilgileri sağlayan bir ağ adresi KnownNetworks listesine IPv6 biçiminde 
eklenir. 

IPv4 adresi: 10 . 11 . 12 . 1/8 

Dönüştürülen IPv6 adresi: : :ffff : 10 . 1 ı. 12.1 
Dönüştürülen önek uzunluğu: 104 

Ayrıca, adresi onaltılık biçimde ( 10 . 11 . 12.1 : :ffff : 0 a 0 b: 0 c@ı IPv6 olarak temsil edilir) da 

sağlayabilirsiniz. Bir IPv4 adresini IPv6 'ya dönüştürürken, ek : :ffff: IPv6 öneki (8 + 96 = 104) için 
hesaba (örnekteki 8 ) CıDR ön eki uzunluğuna 96 ekleyin. 

// To access IPNetwork and IPAddress, add the following namespaces: 

// using using System.Net; 

// using Microsoft.AspNetCore.HttpOverrides; 

Services.Configure<ForwardedHeadersOptions>(options => 

{ 

options.ForwardedHeaders = 

ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto; 
options.KnownNetworks.Add(new IPNetwork( 

IPAddress.Parse( "::ffff:10.11.12 . 1") , 104)); 

}); 


Linux ve IIS olmayan ters proxy 'ler için Düzen iletme 

UseHttpsRedirection ve UseHsts çağıran ve bir Azure Linux App Service, Azure Linux sanal makinesi 
(VM) veya IIS 'in yanı sıra diğer tüm ters proxy 'ler için dağıtılan bir siteyi sonsuz döngüye koymak için 
kullanılan uygulamalar. TLS, ters proxy tarafından sonlandırılır ve Kestrel doğru istek düzeninden 
haberdar değildir. OAuth ve OıDC yanlış yeniden yönlendirmeler oluşturduğundan bu yapılandırmada 
de başarısız olur. UselISIntegration, IIS 'nin arkasında çalışırken İletilen üstbilgiler ara yazılımını ekler 
ve yapılandırır, ancak Linux için eşleşen otomatik yapılandırma (Apache veya NGINX tümleştirmesi) 
yoktur. 

IIS olmayan senaryolarda düzeni proxy 'den iletmek için, İletilen üstbilgiler ara yazılımını ekleyin ve 
yapılandırın. startup.configureServices ' de aşağıdaki kodu kullanın: 










// using Microsoft.AspNetCore.HttpOverrides; 
if (string.Equals( 

Environment. GetEnvironmentVariable( "ASPNETCORE_FORWARDEDHEADERS_ENABLED"), 
"true", StringComparison.OrdinalIgnoreCase)) 

{ 

Services.Configure<ForwardedHeadersOptions>(options => 

{ 

options.ForwardedHeaders = ForwardedHeaders.XForwardedFor | 
ForwardedHeaders.XForwardedProto; 

// Only loopback proxies are allowed by default. 

// Clear that restriction because forwarders are enabled by explicit 
// configuration. 
options.KnownNetworks.Clear(); 
options.KnownProxies.Clear(); 

}); 

} 


Sertifika iletme 

Azure 

Sertifika iletme için Azure App Service yapılandırmak için, bkz. Azure App Service İÇİN TLS karşılıklı 
kimlik doğrulamasını yapılandırma. Aşağıdaki kılavuz ASP.NET Core uygulamasını yapılandırmaya 
aittir. 


startup.configure , app.useAuthentication(); çağrısından önce aşağıdaki kodu ekleyin: 


app.UseCertificateForwarding(); 


Sertifika İletme ara yazılımını, Azure 'un kullandığı üst bilgi adını belirtecek şekilde yapılandırın, 
startup.configureServices ' de, ara yazılımın bir sertifika oluşturmasındaki üstbilgiyi yapılandırmak için 
aşağıdaki kodu ekleyin: 

Services.AddCertificateForwarding(options => 

options.CertificateHeader = "X-ARR-ClientCert"); 


Diğer Web proxy ‘leri 

MS veya Azure App Service uygulama İsteği yönlendirme (ARR) olmayan bir ara sunucu kullanılıyorsa, 
proxy 'yi bir HTTP üst bilgisinde aldığı sertifikayı iletecek şekilde yapılandırın, startup.configure , 
app.UseAuthentication(); çağrısından önce aşağıdaki kodu ekleyin: 

app.UseCertificateForwarding(); 

Üst bilgi adını belirtmek için sertifika İletme ara yazılımını yapılandırın, startup. ConfigureServices ' de, 
ara yazılımın bir sertifika oluşturmasındaki üstbilgiyi yapılandırmak için aşağıdaki kodu ekleyin: 

Services.AddCertificateForwarding(options => 

options.CertificateHeader = "YOUR_CERTIFICATE_HEADER_NAME"); 

Ara sunucu Base64 ile kodlanmazsa (NGINX ile olduğu gibi), HeaderConverter seçeneğini ayarlayın, 
startup.ConfigureServices içinde aşağıdaki örneği göz önünde bulundurun: 










Services.AddCertificateForwarding(options => 

{ 

options.CertificateHeader = "YOUR_CÜSTOM_HEADER_NAME "; 
options.HeaderConverter = (headerValue) => 

{ 

var clientCertificate = 

/* some conversion logic to create an X509Certificate2 */ 
return clientCertificate; 

} 

})J 


Sorun giderme 

Üstbilgiler beklendiği gibi iletilemediği zaman günlüğe kaydetmeyietkinleştirin. Günlükler sorunu 
gidermek için yeterli bilgi sağlamıyorsa, sunucu tarafından alınan istek üstbilgilerini numaralandırın. Bir 
uygulama yanıtına istek üst bilgileri yazmak veya üst bilgileri günlüğe kaydetmek için satır içi ara 
yazılım kullanın. 

Üst bilgileri uygulamanın yanıtına yazmak için aşağıdaki Terminal satır içi ara yazılımları 
startup.Configure UseForvvardedHeaders çağrısından hemen sonra yerleştirin: 

app.Run(async (context) => 

{ 

context.Response.ContentType = "text/plain"; 

// Request method, scheme, and path 
await context.Response.WriteAsync( 

$"Request Method: {context. Request.Method}{Environment. Newl_ine}"); 
await context.Response.WriteAsync( 

$"Request Scheme: {context.Request.Scheme}{Environment.NewLine}"); 
await context.Response.WriteAsync( 

$"Request Path: {context.Request.Path}{Environment.Newl_ine}"); 

// Headers 

await context.Response.WriteAsync($"Request Headers:{Environment.NewLine}"); 

foreach (var header in context.Request.Headers) 

{ 

await context.Response.WriteAsync($"{header.Key}: " + 
$"{header.Value}{Environment.Newl_ine}"); 

} 

await context.Response.WriteAsync(Environment.NewLine); 

// Connection: Remotelp 

await context.Response.WriteAsync( 

$"Request Remotelp: {context.Connection.RemotelpAddress}"); 

}); 


Yanıt gövdesi yerine günlüklere yazabilirsiniz. Günlüklere yazmak, sitenin hata ayıklanırken normal 
şekilde çalışmasına olanak tanır. 

Yanıt gövdesi yerine günlükleri yazmak için: 

• iLogger<startup> Başlangıçta günlükleri oluşturmabölümünde açıklandığı gibi startup sınıfına 
ekleyin. 

• startup.configure UseForvvardedHeaders çağrısından hemen sonra aşağıdaki satır içi ara yazılımı 
yerleştirin. 






app.Use(async (context, next) = > 

{ 

// Request method, scheme, and path 

_logger.LogDebug("Request Method: {Method}", context.Request.Method); 

_logger.LogDebug("Request Scheme: {Scheme}", context.Request.Scheme); 

_logger.LogDebug("Request Path: {Path}", context.Request.Path); 

// Headers 

foneach (var header in context.Request.Headers) 

{ 

_logger.LogDebug("Header: {Key}: {Value}", header.Key, header.Value); 

} 

// Connection: Remotelp 

_logger.LogDebug("Request Remotelp: {RemotelpAddress}", 
context.Connection.RemotelpAddress); 

await next(); 

}); 

işlendiğinde x-Forwarded-{For|Proto|Host} değerler x-0riginai-{For|Proto|Host} taşınır. Belirli bir üst 
bilgide birden çok değer varsa, İletilen üstbilgiler ara yazılımı sağdan sola doğru sırada üst bilgileri işler. 
Varsayılan ForwardLimit ı (bir), bu nedenle ForwardLimit değeri artmadığı müddetçe yalnızca üst 
bilgilerden en sağdaki değer işlenir. 

iletilen üstbilgiler işlenmeden önce isteğin özgün uzak İP'si KnownProxies veya KnownNetworks 
listelerindeki bir girdiyle eşleşmelidir. Bu, güvenilmeyen proxy 'lerden ileticileri kabul etmediği için üst 
bilgi yanıltmasını kısıtlar. Bilinmeyen bir proxy algılandığında günlüğe kaydetme, proxy 'nin adresini 
gösterir: 

September 20th 2018, 15:49:44.168 Unknown proxy: 10.0.0.100:54321 


Yukarıdaki örnekte, alana 10.0.0.100 bir proxy sunucusudur.Sunucu güvenilir bir ara sunucu ise, 


startup.configureServices içindeki sunucunun İP adresini 

KnownProxies 

ekleyin (veya 

KnownNetworks 


bir güvenilen ağ ekleyin). Daha fazla bilgi için İletilen üstbilgiler ara yazılım seçenekleri bölümüne 
bakın. 


Services.Configure<ForwardedHeadersOptions>(options => 

{ 

options.KnownProxies.Add(IPAddress.Parse("10.0.0.100")); 

})J 


IMPORTANT 

Yalnızca güvenilen proxy ’lerin ve ağların üstbilgileri iletmesine izin verir. Aksi takdirde, İP sahtekarlığı saldırıları 
mümkündür. 


Ek kaynaklar 

• Web çiftliğinde AS P.N ET Core ana bilgisayar 

• Microsoft güvenlik danışmanlık CVE-2018-0787: ayrıcalık yükselmesi güvenlik açığı ASP.NET Core 














Web çiftliğinde ASPNET Core ana bilgisayar 
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Luke Latham ve Chris 'e göre 

Bir Web grubu , bir uygulamanın birden çok örneğini barındıran iki veya daha fazla Web sunucusu (veya düğüm) 
grubudur. Kullanıcılardan gelen istekler bir Web grubuna ulaştığında,yük dengeleyici istekleri Web grubunun 
düğümlerine dağıtır. Web gruplarının geliştirilmesi: 

• Güvenilirlik/kullanılabilirlik - bir veya daha fazla düğüm başarısız olursa, yük dengeleyici istekleri 
işlemeye devam etmek için istekleri diğer çalışan düğümlere yönlendirebilir. 

• Birden çok düğüm - Kapasite/performans , tek bir sunucudan daha fazla istek işleyebilir. Yük dengeleyici 
istekleri düğümlere dağıtarak iş yükünü dengeler. 

• Ölçeklenebilirlik - daha fazla veya daha az kapasite gerektiğinde, etkin düğümlerin sayısı artılarak iş yüküne 
uyacak şekilde artırılabilir veya azaltılabilir. Azure App Servicegibi Web grubu platformu teknolojileri, Sistem 
Yöneticisi isteğine otomatik olarak veya insan müdahalesi olmadan otomatik olarak düğüm ekleyebilir veya 
kaldırabilir. 

• Bakım - bir Web grubunun düğümleri, daha kolay sistem yönetimi ile sonuçlanan bir dizi paylaşılan hizmete 
bağlı olabilir. Örneğin, bir Web grubunun düğümleri tek bir veritabanı sunucusunu ve görüntüler ve 
indirilebilir dosyalar gibi statik kaynaklar için ortak bir ağ konumunu temel alabilir. 

Bu konuda, paylaşılan kaynaklara bağlı bir Web çiftliğinde barındırılan ASP.NET Core uygulamaları için 
yapılandırma ve bağımlılıklar açıklanmaktadır. 

Genel yapılandırma 

ASP.NET Core barındırma ve dağıtma 

Barındırma ortamlarını ayarlamayı ve ASP.NET Core uygulamaları dağıtmayı öğrenin. Uygulama başlatma ve 
yeniden başlatma işlemlerini otomatik hale getirmek için Web grubunun her bir düğümünde bir işlem yöneticisi 
yapılandırın. Her düğüm ASP.NET Core çalışma zamanını gerektirir.Daha fazla bilgi için, belgelerin ana 
bilgisayar ve dağıtım alanındaki konulara bakın. 

Proxy sunucularıyla ve yük dengeleyicilerle çalışacak ASP.NET Core yapılandırma 

Genellikle önemli istek bilgilerini gizleyen ara sunucu ve yük dengeleyiciler arkasında barındırılan uygulamalar 
için yapılandırma hakkında bilgi edinin. 

AS P.N ET Core uygulamalarını Azure App Service dağıtma 

Azure App Service , Web uygulamalarını barındırmak için ASP.NET Core dahil olmak üzere bir Microsoft bulut 
bilgi işlem platformu hizmetidir . App Service, otomatik ölçeklendirme, Yük Dengeleme, düzeltme eki uygulama 
ve sürekli dağıtım sağlayan, tam olarak yönetilen bir platformdur. 

Uygulama verileri 

Bir uygulama birden çok örneğe ölçeklenirse, düğümler arasında paylaşım gerektiren uygulama durumu olabilir. 
Durum geçicidir, birıdistributedcachepaylaşmayı düşünün. Paylaşılan durum kalıcılığı gerektiriyorsa, paylaşılan 
durumu bir veritabanında depolamayı göz önünde bulundurun. 

Gerekli yapılandırma 

Veri koruma ve önbelleğe alma, bir Web grubuna dağıtılan uygulamalar için yapılandırma gerektirir. 






Veri Koruma 

AS P.N ET Core Data Protection sistemi , uygulamalar tarafından verileri korumak için kullanılır. Veri koruma, 
anahtar halkamda depolanan bir şifreleme anahtarı kümesini temel alır. Veri koruma sistemi başlatıldığında, 
anahtar halkasını yerel olarak depolayan varsayılan ayarları uygular. Varsayılan yapılandırma altında, Web 
grubunun her bir düğümüne benzersiz bir anahtar halkası depolanır. Sonuç olarak, her Web grubu düğümü 
diğer düğümlerde bir uygulama tarafından şifrelenen verilerin şifresini çözemez. Varsayılan yapılandırma, 
uygulamaları bir Web grubunda barındırmak için genellikle uygun değildir. Paylaşılan anahtar halkasını 
uygulamaya bir alternatif, her zaman kullanıcı isteklerini aynı düğüme yönlendirkullanmaktır. Web grubu 
dağıtımları için veri koruma sistem yapılandırması hakkında daha fazla bilgi için bkz. ASP.NET Core veri 
korumasını yapılandırma. 

Önbelleğe Alma 

Bir Web grubu ortamında, önbelleğe alma mekanizması, önbelleğe alınmış öğeleri Web grubunun düğümleri 
arasında paylaşmalıdır. Önbelleğe alma, ortak bir Redsıs önbelleği, paylaşılan bir SQL Server veritabanı veya 
Web grubu genelinde önbelleğe alınmış öğeleri paylaşan özel bir önbelleğe alma uygulamasını kullanmalıdır. 
Daha fazla bilgi için bkz. AS P.N ET Core 'de dağıtılmış önbelleğe alma. 

Bağımlı bileşenler 

Aşağıdaki senaryolar ek yapılandırma gerektirmez, ancak Web grupları için yapılandırma gerektiren teknolojilere 
bağımlıdır. 


SENARYO 

... BAĞIMLIDIR 

Kimlik doğrulaması 

Veri koruma (bkz. ASP.NET Core veri korumasını 
yapılandırma). 

Daha fazla bilgi için bkz. ASP.NET Core kimliği olmadan 
tanımlama bilgisi kimlik doğrulaması kullanma ve ASP.NET 
uygulamaları arasında kimlik doğrulama tanımlama bilgilerini 
paylaşma. 

Kimlik 

Kimlik doğrulama ve veritabanı yapılandırması. 

Daha fazla bilgi için bkz. ASP.NET Core kimliğe giriş. 

Oturum 

Veri koruma (şifreli tanımlama bilgileri) (bkz. ASP.NET Core 
veri korumasını yapılandırma) ve önbelleğe alma (bkz. 

ASP.NET Core 'de dağıtılmış önbelleğe alma). 

Daha fazla bilgi için bkz. oturum ve uygulama durumu: 
oturum durumu. 

TempData 

Veri koruma (şifreli tanımlama bilgileri) (bkz. ASP.NET Core 
veri korumasını yapılandırma) veya oturum (bkz. oturum ve 
uygulama durumu: oturum durumu). 

Daha fazla bilgi için bkz. oturum ve uygulama durumu: 
TempData. 

Korsanlığa karşı koruma 

Veri koruma (bkz. ASP.NET Core veri korumasını 
yapılandırma). 


Daha fazla bilgi için bkz. ASP.NET Core siteler arası İstek 
sahteciliği (XSRF/CSRF) saldırılarını önle. 


Sorun giderme 

Veri koruma ve önbelleğe alma 

Veri koruma veya önbelleğe alma bir Web grubu ortamı için yapılandırılmadığında, istekler işlendiğinde aralıklı 
hatalar oluşur. Bu durum, düğümlerin aynı kaynakları paylaşmadığı ve kullanıcı isteklerinin her zaman aynı 
düğüme geri yönlendirilmediği için oluşur. 

Tanımlama bilgisi kimlik doğrulaması kullanarak uygulamada oturum açan bir kullanıcıyı göz önünde 
bulundurun. Kullanıcı uygulamada bir Web grubu düğümünde oturum açar. Bir sonraki isteği, oturum açtıkları 
aynı düğüme alınırsa, uygulama kimlik doğrulama tanımlama bilgisinin şifresini çözebilir ve uygulamanın 
kaynağına erişime izin verebilir. Sonraki istekleri farklı bir düğüme alınırsa, uygulama kimlik doğrulama 
tanımlama bilgisinin kullanıcının oturum açmış olduğu düğümden şifresini çözemez ve istenen kaynak için 
yetkilendirme başarısız olur. 

Aşağıdaki belirtilerden herhangi biri zaman zamanmeydana geldiğinde, sorun genellikle hatalı veri korumasına 
veya bir Web grubu ortamı için önbelleğe alma yapılandırmasına göre izlenmelidir: 

• Kimlik doğrulama - kimlik doğrulama tanımlama bilgisi yanlış yapılandırılmış veya şifresi çözülemiyor.OAuth 
(Facebook, Microsoft, Tvvitter) veya Openıdconnect oturumları "bağıntı başarısız oldu" hatasıyla başarısız 
oluyor. 

• Yetkilendirme kesmeleri - kimlik kayboldu. 

• Oturum durumu verileri kaybeder. 

• Önbelleğe alınan öğeler kaybolur. 

• TempData başarısız olur. 

• Gönderi başarısız-, koruma denetimi başarısız olur. 

Web grubu dağıtımları için veri koruma yapılandırması hakkında daha fazla bilgi için bkz. ASP.NET Core veri 
korumasını yapılandırma. Web grubu dağıtımları için önbelleğe alma yapılandırması hakkında daha fazla bilgi 
için bkz. ASP.NET Core 'de dağıtılmış önbelleğe alma. 

Uygulamalardan veri alma 

Web grubu uygulamalarının isteklere yanıt verme yeteneği varsa, Terminal satır içi ara yazılım kullanarak 
uygulamalardan istek, bağlantı ve ek verileri alın. Daha fazla bilgi ve örnek kod için bkz. ASP.NET Core projeleri 
sorunlarını giderme. 

Ek kaynaklar 

• VVİndovvs - İçin özel Betik uzantısı , dağıtım sonrası yapılandırma ve yazılım yüklemesi için yararlı olan Azure 
sanal makinelerinde betikleri indirir ve yürütür. 




ASRNET Core uygulama dağıtımı için Visual 
Studio yayımlama profilleri (. pubxml) 
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Sayed Ibrampahashve Rick Anderson tarafından 

Bu belge, yayımlama profillerinin oluşturulması ve kullanılması için Visual Studio 2019 veya sonraki bir 
sürümü kullanılarak odaklanmıştır. Visual Studio ile oluşturulan yayımlama profilleri MSBuild ve Visual 
Studio ile birlikte kullanılabilir. Azure 'da yayımlama yönergeleri için bkz. Visual Studio ile Azure'a bir 
ASP.NET Core uygulaması yayımlama. 

dotnet new mvc komutu, aşağıdaki kök düzeyi <projesi > öğesiniiçeren bir proje dosyası üretir: 

<Project Sdk="Microsoft.NET.Sdk.Web"> 

<!-- omitted for brevity --> 

</Project> 

Önceki <Project> öğesinin sdk özniteliği, $ (msbuildsdkspath) \Microsoftnet.SDK.Web\Sdk\Sdk.propsve $ 
(msbuildsdkspath) konumundan MSBuild özelliklerini ve hedeflerini içeri aktarır 
\Microsoft.net.SDK.Web\Sdk\ SDK. targets, sırasıyla. $(MSBuiidSDKsPath) için varsayılan konum (Visual 
Studio 2019 Enterprise ile) % ProgramFiles (x86)% \ Microsoft Visual Studio\2019\enterprise\msbuild\sdk 
klasörüdür. 

Microsoft.NET.Sdk.Web (WebSDK), Microsoft. NET. Sdk (,N ET Core S D K) ve Microsoft. NET. Sdk. Razor (RaZOr 
SDK) dahil diğer SDK 'lara bağlıdır.Her bağımlı SDK ile ilişkili MSBuild özellikleri ve hedefleri içeri aktarılır. 
Yayımlama hedefleri, kullanılan Yayımla yöntemine göre uygun hedef kümesini içeri aktarır. 

MSBuild veya Visual Studio bir projeyi yüklediğinde, aşağıdaki üst düzey eylemler gerçekleşir: 

• Projeyi oluştur 

• Yayımlanacak işlem dosyaları 

• Dosyaları hedefe Yayımla 

İşlem projesi öğeleri 

Proje yüklendiğinde, MSBuild proje öğeleri (dosyalar) hesaplanır. Öğe türü, dosyanın nasıl işlendiğini belirler. 
Varsayılan olarak,. cs dosyaları compile öğe listesine eklenir, compile öğesi listesindeki dosyalar derlenir. 

content öğe listesi, derleme çıktılarına ek olarak yayımlanan dosyaları içerir. Varsayılan olarak, wwwroot\** , 
**\*.config ve **\*. json desenleriyle eşleşen dosyalar content öğe listesine dahildir. Örneğin, 
wwwroot\** Glob deseninin Wwwroot klasörü ve alt klasörlerindeki tüm dosyalar eşleşir. 

Web SDK'Sı Razor SDK 'sınıiçeri aktarır. Sonuç olarak, **\*.cshtmi ve **\*.razor desenleriyle eşleşen 
dosyalarda content öğe listesine dahil edilmiştir. 

Web SDK'Sı Razor SDK 'sınıiçeri aktarır. Sonuç olarak, **\*.cshtmi düzeniyle eşleşen dosyalar content 
öğe listesine de dahildir. 

Yayınlama listesine açıkça bir dosya eklemek için, dosyayı, dosyaları dahil et bölümünde gösterildiği gibi 
doğrudan . csproj dosyasına ekleyin. 

Visual Studio 'da veya komut satırından yayımlarken Yayımla düğmesini seçerken: 





















• Özellikler/öğeler hesaplanır (oluşturmak için gereken dosyalar). 

• Yalnızca Visual Studio: NuGet paketleri geri yüklendi. (Geri yüklemenin CLı üzerinde kullanıcı 
tarafından açık olması gerekir.) 

• Proje oluşturulur. 

• Yayımlama öğeleri hesaplanır (yayımlamak için gereken dosyalar). 

• Proje yayımlandı (hesaplanan dosyalar yayımlama hedefine kopyalanır). 

BirASP.NET Core projesi Proje dosyasında Microsoft. net. sdk.ueb başvurduğunda, Web uygulaması 
dizininin köküne bir app_offime. htm dosyası yerleştirilir. Dosya olduğunda, ASP.NET Core modülü 
uygulamayı düzgün bir şekilde kapatır ve dağıtım sırasında app_offline. htm dosyasına hizmet verir. Daha 
fazla bilgi için ASP.NET Core modülü yapılandırma başvurusunabakın. 

Temel komut satırı yayımlama 

Komut satırı yayımlama, .N ET Core tarafından desteklenen tüm platformlarda çalışmaktadır ve Visual Studio 
'Yu gerektirmez. Aşağıdaki örneklerde .NET Core CLI DotNet Publish komutu proje dizininden çalıştırılır (. 
csproj dosyasını içerir). Proje klasörü geçerli çalışma dizini değilse, proje dosyası yolunda açıkça geçiş yapın. 
Örneğin: 

dotnet publish C:\Webs\Webl 

Bir Web uygulaması oluşturmak ve yayımlamak için aşağıdaki komutları çalıştırın: 

dotnet new mvc 
dotnet publish 

dotnet publish komutu aşağıdaki çıkışın bir çeşidini üretir: 

C:\Webs\Webl>dotnet publish 

Microsoft (R) Build Engine version {VERSION} for .NET Core 
Copyright (C) Microsoft Corporation. Ali rights reserved. 

Restore completed in 36.81 ms for C:\Webs\Webl\Webl.csproj. 

Webl -> C:\Webs\Webl\bin\Debug\-fTARGET FRAMEIaIORK MONIKER}\Webl.dil 
Webl -> C: \Webs\Webl\bin\Debug\{TARGET FRAMEIaIORK MONIKER}\Webl. Views.dil 
Webl -> C: \Webs\Webl\bin\Debug\{TARGET FRAMEIaIORK MONIKER}\publish\ 

Varsayılan yayımlama klasörü biçimi bin\Debug\{Target Framework bilinen adi} \publish\. Örneğin, 
Bin\debug\netcoreapp2,2\publish\. 

Aşağıdaki komut Release derlemesini ve yayımlama dizinini belirtir: 

dotnet publish -c Release -o C:\MyWebs\test 

dotnet publish komutu, Publish hedefini çağıran MSBuild 'i çağırır, dotnet publish geçirilen parametreler 
MSBuild 'e geçirilir, -c ve -o parametreleri, sırasıyla MSBuild'in Configuration ve outputPath 
özelliklerine eşlenir. 

MSBuild özellikleri aşağıdaki biçimlerden birini kullanarak geçirilebilir: 

• p:<NAME>=<VALUE> 

• /p:<NAME>=<VALUE> 











Örneğin, aşağıdaki komut bir ağ paylaşımında Release derlemesi yayımlar. Ağ paylaşma, eğik çizgiler 
{/saat) ile belirtilir ve tüm .N ET Core desteklenen platformlarda çalışmaktadır. 

dotnet publish -c Release /p:PublishDir=//r8/release/AdminWeb 

Dağıtım için yayımlanan uygulamanın çalışmadığından emin olun. Yayımla klasöründeki dosyalar, uygulama 
çalışırken kilitlenir. Kilitli dosyalar kopyalanamadığından dağıtım gerçekleştirilemez. 

Yayımlama profilleri 

Bu bölüm, bir yayımlama profili oluşturmak için Visual Studio 2019 veya üstünü kullanır. Profil 
oluşturulduktan sonra, Visual Studio 'dan veya komut satırından yayımlama kullanılabilir. Yayımlama 
profilleri Yayımlama sürecini basitleştirebilir ve herhangi bir sayıda profil bulunabilir. 

Aşağıdaki yollardan birini seçerek Visual Studio 'da bir yayımlama profili oluşturun: 

• Çözüm Gezgini projeye sağ tıklayın ve Yayımla' yı seçin. 

• Build menüsünden {Project Name} Yayımla ' yı seçin. 

Uygulama özellikleri sayfasının Yayımla sekmesi görüntülenir. Projenin bir yayımlama profili yoksa, bir 
yayımlama hedefi seçin sayfası görüntülenir. Aşağıdaki yayımlama hedeflerinden birini seçmeniz istenir: 

• Azure App Service 

• Linux üzerinde Azure App Service 

• Azure sanal makineleri 

• Klasör 

• MS, FTP, Web Dağıtımı (herhangi bir Web sunucusu için) 

• Profili içeri aktar 

En uygun yayımlama hedefini belirlemek için, hangi yayımlama seçeneklerinin benim içinuygun olduğunu 
öğrenin. 

Hedef Yayımla klasörü seçildiğinde, yayımlanmış varlıkları depolamak için bir klasör yolu belirtin. Varsayılan 
klasör yolu, { Project CONFIGURATION}\{Target Framework bilinen adı} \publish\\. Örneğin, 
Bin\release\netcoreapp2,2\publish\. Tamamlanacak Profil oluştur düğmesini seçin. 

Bir yayımlama profili oluşturulduktan sonra, Yayımla sekmesinin içeriği değişir. Yeni oluşturulan profil bir 
açılan listede görüntülenir. Aşağı açılan listenin altında Yeni profil oluştur' u seçerek yeni bir profil 
oluşturun. 

Visual Studio 'nun yayımlama aracı, yayımlama profilini açıklayan bir Özellikler/PublishProfiles/fPROFİLE 
Name}. pubxml MS Build dosyası oluşturuyor.. Pubxml dosyası: 

• Yayımlama yapılandırma ayarlarını içerir ve yayımlama işlemi tarafından kullanılır. 

• Derleme ve yayımlama işlemini özelleştirmek için değiştirilebilir. 

Azure hedefine yayımlarken,. pubxml dosyası Azure abonelik tanımlarınızı içerir. Bu hedef türünde, bu 
dosyayı kaynak denetimine eklemek önerilmez. Azure olmayan bir hedefe yayımlarken,. pubxml dosyasını 
denetlemek güvenlidir. 

Gizli bilgiler (yayımlama parolası gibi) Kullanıcı/makine düzeyinde şifrelenir. 

Özellikler/PublishProfiles/fPROFİLE Name}. pubxml. User dosyasında depolanır. Bu dosya hassas bilgileri 
depolayabildiğinden, kaynak denetimine denetlenmemelidir. 

ASP.NET Core Web uygulaması yayımlama hakkında genel bakış için, bkz. ASP.NET Core barındırma ve 
dağıtma. ASP.N ET Core Web uygulaması yayımlamak için gereken M S Build görevleri ve hedefleri, 



ASPNET/VVebSDK deposundaaçık kaynaktır. 


Aşağıdaki komutlar Folder, MSDeploy ve kudu yayımlama profillerini kullanabilir. MSDeploy platformlar 
arası destek olmadığından, aşağıdaki MSDeploy seçenekleri yalnızca VVİndovvs 'da desteklenir. 

Klasör (platformlar arası): 

dotnet build WebApplication.csproj /p:DeployOnBuild=true /p:PublishProfile=<FolderProfileName> 


MSDeploy 

dotnet publish UebApplication.csproj /p:PublishProfile=<MsDeployProfilel\lame> /p:Password= 
<DeploymentPassword> 


dotnet build UebApplication.csproj /p:DeployOnBuild=true /p:PublishProfile=<MsDeployProfileName> 
/p:Password=<DeploymentPassword> 


MSDeploy paketi: 


dotnet publish UebApplication.csproj /p:PublishProfile=<l' / lsDeployPackageProfileName> 


dotnet build UebApplication.csproj /p:DeployOnBuild=true /p:PublishProfile=<MsDeployPackageProfileName> 


Yukarıdaki örneklerde: 

• dotnet publish ve dotnet build , Azure 'da herhangi bir platformda yayımlamak üzere kudu API 'Lerini 
destekler. Visual Studio yayımlama, kudu API 'Lerini destekler, ancak Azure 'da platformlar arası 
yayımlama için VVebSDK tarafından desteklenir. 

• dotnet publish komutuna DeployOnBuiid iletmeyin. 

Daha fazla bilgi için bkz. Microsoft, net. SDK. Publish. 

Projenin Properties/PublishProfiles klasörüne aşağıdaki içeriğe sahip bir yayımlama profili ekleyin: 

<Project> 

<PropertyGroup> 

<PublishProtocol>Kudu</PublishProtocol> 

<PublishSiteName>nodewebapp</PublishSiteName> 

<UserName>username</UserName> 

<Password>password</Password> 

</PropertyGroup> 

</Project> 


Klasör Yayımla örneği 

Folderprofile adlı bir profille yayımlarken, aşağıdaki komutlardan birini kullanın: 

• dotnet build /p:DeployOnBuild=true /p:PublishProfile=FolderProfile 

• msbuild /p:DeployOnBuild=tnue /p:PublishProfile=FolderProfile 


.NET Core CU DotNet derleme komutu, derleme ve yayımlama işlemini çalıştırmak için msbuild ' i çağırır, 
dotnet build ve msbuild komutları, bir klasör profilinde geçirilerek eşdeğerdir, msbuild doğrudan 
VVİndovvs üzerinde çağrılırken, MSBuild 'in .NET Framevvork sürümü kullanılır. Klasör olmayan bir profilde 











dotnet buiid çağrılıyor: 


• MSDeploy kullanan msbuiid ' ı çağırır. 

• Hataya neden olur (Windows üzerinde çalışırken bile). Klasör olmayan bir profille yayımlamak için, 
doğrudan msbuiid ' ı çağırın. 

Aşağıdaki klasör yayımlama profili, Visual Studio ile oluşturulmuştur ve bir ağ paylaşımında yayımlar: 

<?xml version="1.0" encoding="utf-8"?> 

<!-- 

This file is used by the publish/package process of your Web project. 

You can customize the behavior of this process by editing this 
MSBuild file. 

--> 

<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003"> 
<PropertyGroup> 

<WebPublishMethod>FileSystem</WebPublishMethod> 

<PublishProvider>FileSystem</PublishProvider> 

<LastUsedBuildConfiguration>Release</LastUsedBuildConfiguration> 

<LastUsedPlatform>Any CPU</LastUsedPlatform> 

<SiteUrlToLaunchAfterPublish /> 

<LaunchSiteAfterPublish>True</LaunchSiteAfterPublish> 

<ExcludeApp_Data>False</ExcludeApp_Data> 

<PublishFramework>netcoreappl.l</PublishFramework> 
<ProjectGuid>c30c453c-312e-40c4-aec9-394al45dee0b</ProjectGuid> 
<publishUrl>\\r8\Release\AdminWeb</publishUrl> 
<DeleteExistingFiles>False</DeleteExistingFiles> 

</PropertyGroup> 

</Project> 


Yukarıdaki örnekte: 


• <ExciudeApp_Data> özelliği yalnızca bir XML şeması gereksinimini karşılamak için vardır. 
<ExciudeApp_Data> özelliği, proje kökünde App_Data klasörü olsa bile, yayımlama işlemi üzerinde hiçbir 

etkiye sahip değildir. App_Data klasörü, AS P.N ET 4. x projelerinde olduğu gibi özel bir işleme almaz. 

• <ı_astusedBuiidConfiguration> özelliği Release olarak ayarlanır. Visual Studio 'dan yayımlarken, 
<ı_astusedBuiidConfiguration> değeri, yayımlama işlemi başlatıldığında değeri kullanılarak ayarlanır. 
<LastusedBuiidConfiguration> özeldir ve içeri aktarılan MSBuild dosyasında geçersiz kılınmamalıdır. 

Ancak, bu özellik aşağıdaki yaklaşımlardan birini kullanarak komut satırından geçersiz kılınabilir. 

o .NET Core CLI kullanarak: 

dotnet buiid -c Release /p:DeployOnBuild=true /p:PublishProfile=FolderProfile 

o MSBuild 'i kullanma: 

msbuiid /p:Configuration=Release /p:DeployOnBuild=true /p:PublishProfile=FolderPnofile 

Daha fazla bilgi için bkz. MSBuild: yapılandırma özelliğini ayarlama. 

Komut satırından bir MSDeploy uç noktasına yayımlama 

Aşağıdaki örnek, AzureWebAppad\\ Visual Studio tarafından oluşturulan bir ASP.NET Core Web 
uygulamasını kullanır. Visual Studio ile bir Azure Apps yayımlama profili eklenir. Profil oluşturma hakkında 
daha fazla bilgi için, Yayımlama profilleri bölümüne bakın. 

Uygulamayı bir yayımlama profili kullanarak dağıtmak için, bir Visual Studio Geliştirici Komut İstemi 










msbuiid komutunu yürütün. Komut istemi, Windows görev çubuğundaki Başlat menüsünün Visual Studio 
klasöründe bulunur. Daha kolay erişim için, Visual Studio 'daki Araçlar menüsüne komut istemi 
ekleyebilirsiniz. Daha fazla bilgi için bkz. Visual Studio için geliştirici komut istemi. 

MSBuild aşağıdaki komut sözdizimini kullanır: 

msbuiid {PATH} 

/p:DeployOnBuild=true 
/p:PublishProfile={PROFİLE} 

/p:Username={USERNAME} 

/p:Password={PASSWORD} 


• {PATH} uygulamanın proje dosyasının yolunu -. 

• {PROFİLE} - yayımlama profilinin adı. 

• {USERNAME} - MSDeploy Kullanıcı adı. {USERNAME}, yayımlama profilinde bulunabilir. 

• {PASSVVORD} - MSDeploy parolası. {PROFİLE} öğesinden {PASSVVORD} öğesini edinin . 
PublishSettings dosyası. 1 Nı indirin . PublishSettings dosyası şunlardan biri: 

o Çözüm Gezgini: Görünüm > bulut Gezgini' ni seçin. Azure aboneliğinize bağlanın. Uygulama 
hizmetleri'ni açın. Uygulamaya sağ tıklayın. Yayımlama profilini indir' i seçin, 
o Azure portal: Web uygulamasının genel bakış panelinde Yayımlama profilini al ' ı seçin. 

Aşağıdaki örnek, AzureWebApp-Web dağ itim ıad\t bir yayımlama profili kullanır: 

msbuiid "AzureWebApp.csproj" 

/p:DeployOnBuild=true 

/p:PublishProfile="AzureWebApp - Web Deploy" 

/p:Username="$AzureWebApp" 

/p: Password="." 


Bir yayımlama profili, Windows komut kabuğu 'ndan .NET Core CLI DotNet MSBuild komutuyla da 
kullanılabilir: 


dotnet msbuiid "Azurel/JebApp.csproj" 
/p:DeployOnBuild=true 

/p:PublishProfile="AzureWebApp - Web Deploy" 
/p:Username="$AzureWebApp" 

/p: Password="." 



Ortamı ayarlama 

Uygulamanın ortamınıayarlamak için Publish profile (. pubxml) veya proje dosyasında <EnvironmentName> 
özelliğini dahil edin: 

<PropertyGroup> 

<EnvironmentName>Development</EnvironmentName> 

</PropertyGroup> 














Web. config dönüştürmelerine ihtiyaç duyuyorsanız (örneğin, yapılandırma, profil veya ortama göre ortam 
değişkenlerini ayarlamak), bkz. Web.config'i dönüştürme. 

Dosyaları Dışla 

ASP.NET Core Web Apps yayımlandığında, aşağıdaki varlıklar dahil edilmiştir: 

• Yapı yapıtları 

• Aşağıdaki glob desenleriyle eşleşen klasörler ve dosyalar: 
o **\*. config (örneğin, Web. config) 

o **\*. json (örneğin, appSettings. JSON) 
o wwwroot\** 

MSBuild, Glob desenlerinıdestekler. Örneğin, aşağıdaki <content> öğesi, metin (. txt) dosyalarının 
wwwroot\conterıt klasörüne ve alt klasörlerine kopyalanmasını önler: 

<ItemGroup> 

<Content Update="wwwroot/content/**/* ,txt" CopyToPublishDirectory="Never" /> 

</ItemGroup> 

Önceki biçimlendirme bir yayımlama profiline veya . csproj dosyasına eklenebilir.. Csproj dosyasına 
eklendiğinde, kural projedeki tüm yayımlama profillerine eklenir. 

Aşağıdaki <MsDepioySkipRuies> öğesi, tüm dosyaları wwwroot\conterıt klasöründen dışlar: 

<ItemGroup> 

<MsDeploySkipRules Include="CustomSkipFolder"> 

<ObjectName>dirPath</ObjectName> 

<AbsolutePath>wwwroot\\content</AbsolutePath> 

</MsDeploySkipRules> 

</ItemGroup> 

<MsDepioySkipRuies> , dağıtım sitesinden atlama hedeflerini silmez. <content> hedefli dosya ve klasörler 
dağıtım sitesinden silinir. Örneğin, dağıtılan bir Web uygulamasının aşağıdaki dosyalar olduğunu varsayalım 

• Görünümler/Home/aboutl. cshtml 

• Görünümler/Home/About2. cshtml 

• Görünümler/Home/About3. cshtml 

Aşağıdaki <MsDepioySkipRuies> öğeleri eklendiyse, bu dosyalar dağıtım sitesinde silinmez. 

<ItemGroup> 

<MsDeploySkipRules Include="CustomSkipFile"> 

<ObjectName>filePath</ObjectName> 

<AbsolutePath>Views\\Home\\Aboutl.cshtml</AbsolutePath> 

</MsDeploySkipRules> 

<MsDeploySkipRules Include="CustomSkipFile"> 

<ObjectName>filePath</ObjectName> 

<AbsolutePath>Views\\Home\\About2.cshtml</AbsolutePath> 

</MsDeploySkipRules> 

<MsDeploySkipRules Include="CustomSkipFile"> 

<0bjectName>filePath</0bjectl\lame> 

<AbsolutePath>Views\\Home\\About3.cshtml</AbsolutePath> 

</MsDeploySkipRules> 

</ItemGroup> 












Önceki <MsDepioySkipRuies> öğeleri Atlanan dosyaların dağıtılmasını engeller. Dağıtıldıktan sonra bu 
dosyaları silmez. 


Aşağıdaki <content> öğesi, dağıtım sitesindeki hedeflenen dosyaları siler: 

<ItemGroup> 

<Content Update="Views/Home/About?.cshtml" CopyToPublishDirectory="Never" /> 

</ItemGroup> 

Önceki <content> öğesiyle komut satırı dağıtımını kullanmak aşağıdaki çıkışın bir varyasyonunu verir: 
MSDeployPublish: 

Starting l/Jeb deployment task from source: manifest(C:\Webs\Webl\obj\Release\{TARGET FRAMEI/JORK 
MONIKER}\PubTmp\Webl.SourceManifest. 
xml) to Destination: auto(). 

Deleting file (Webllll2\Views\Home\Aboutl.cshtml). 

Deleting file (Webllll2\Views\Home\About2.cshtml). 

Deleting file (Webllll2\Views\Home\About3.cshtml). 

Updating file (Webllll2\web.config). 

Updating file (Webllll2\Webl.deps.json). 

Updating file (Webllll2\Webl.dll). 

Updating file (Webllll2\Webl.pdb). 

Updating file (Webllll2\Webl.runtimeconfig.json). 

Successfully executed Web deployment task. 

Publish Succeeded. 

Done Building Project "C:\Webs\Webl\Webl.cspnoj" (default targets). 


İçerme dosyaları 

Aşağıdaki bölümlerde, yayımlama zamanında dosya ekleme için farklı yaklaşımlar ana hatlarıyla verilmiştir. 
Genel dosya ekleme bölümü, Web SDK 'sında bir Yayımla hedefi dosyası tarafından belirtilen 
DotNetPubiishFiles öğesini kullanır. Seçmeli dosya ekleme bölümü, .NET Core SDK bir Yayımla hedefi 
dosyası tarafından belirtilen ResolvedFileToPubiish öğesini kullanır. Web SDK .NET Core SDK bağlı 
olduğundan, her iki öğe bir ASP.NET Core projesinde kullanılabilir. 

Genel dosya ekleme 

Aşağıdaki örnek <ıtemGroup> öğesi, proje dizininin dışında bulunan bir klasörü yayımlanmış sitenin bir 
klasörüne kopyalamayı gösterir. Aşağıdaki biçimlendirmenin <ıtemGroup> ' a eklenen dosyalar varsayılan 
olarak dahil edilir. 


<ItemGroup> 

<_CustomFiles Include="$(MSBuildProjectDirectory)/../images/**/*" /> 

<DotNetPublishFileş Include="@(_CustomFiles)"> 

<DestinationRelativePath>wwwroot/images/%(RecursiveDir)%(Filename)%(Extension) 

</DestinationRelativePath> 

</DotNetPublishFiles> 

</ItemGroup> 


Yukarıdaki biçimlendirme: 

• . Csproj dosyasına veya yayımlama profiline eklenebilir.. Csproj dosyasına eklenirse, bu, projedeki her bir 
yayımlama profiline eklenir. 

• inciude özniteliğinin glob düzeniyle eşleşen dosyaları depolamak için bir _customFiies öğesi bildirir. 
Düzende başvurulan görüntüler klasörü, proje dizininin dışında bulunur. $(MSBuiidProjectDirectory) adlı 
ayrılmış bir özellik, proje dosyasının mutlak yoluna çözümlenir. 

• DotNetPubiishFiles öğe için dosyaların bir listesini sağlar. Varsayılan olarak, öğenin 














<DestinationReiativePath> öğesi boştur. Varsayılan değer, biçimlendirmede geçersiz kılınır ve 
%(RecursiveDir) gibi iyi bilinen öğe meta verilerini kullanır, iç metin, yayımlanan sitenin 
Wwwroot/görüntüler klasörünü temsil eder. 

Seçmeli dosya ekleme 

Aşağıdaki örnekte vurgulanan biçimlendirme şunları göstermektedir: 

• Projenin dışında bulunan bir dosyayı yayınlanan sitenin Wwwroot klasörüne kopyalama. ReadMe2.MD 
dosyasının adı korunur. 

• Wwwroot\corıtent klasörü dışlanıyor. 

• Views\home\about2,cshtmlban(; tutulanıyor. 


<?xml version="1.0" encoding="utf-8"?> 

<Project ToolsVersion="4.0" 

xmlns=" http://schemas.microsoft.com/developer/msbuild/2003"> 

<PropertyGroup> 

<WebPublishMethod>FileSystem</WebPublishMethod> 

<PublishProvider>FileSystem</PublishProvider> 

<LastUsedBuildConfiguration>Release</LastUsedBuildConfiguration> 

<LastUsedPlatform>Any CPU</LastUsedPlatform> 

<SiteUrlToLaunchAfterPublish /> 

<LaunchSiteAfterPublish>True</LaunchSiteAfterPublish> 

<ExcludeApp_Data>False</ExcludeApp_Data> 

<PublishFramework /> 

<ProjectGuid>afa9f185-7ce0-4935-9dal-ab676229d68a</ProjectGuid> 
<publishUrl>bin\Release\PublishOutput</publishUrl> 

<DeleteExistingFiles>False</DeleteExistingFiles> 

</PropertyGroup> 

<ItemGroup> 

<ResolvedFileToPublish Include="..\ReadMe2.md"> 

<RelativePath>wwwroot\ReadMe2.md</RelativePath> 

</ResolvedFileToPublish> 

<Content Update="wwwroot\Content\**\*" CopyToPublishDinectory="Neven" /> 

<Content Update="Views\Home\About2.cshtml" CopyToPublishDirectory="Never" /> 

</ItemGroup> 

</Project> 

Yukarıdaki örnekte, varsayılan davranışı inciude özniteliğinde sunulan dosyaları her zaman yayımlanan 
siteye kopyalamak olan ResolvedFileToPubiish öğesini kullanır. Never veya PreserveNewest iç metniyle bir 
<copyToPubiishDirectory> alt öğesi ekleyerek varsayılan davranışı geçersiz kılın. Örneğin: 

<ResolvedFileToPublish Include="..\ReadMe2.md"> 

<RelativePath>wwwroot\ReadMe2.md</RelativePath> 

<CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory> 

</ResolvedFileToPublish> 


Daha fazla dağıtım örneği için bkz. Web SDK deposu Benioku dosyası. 

Yayımlamadan önce veya sonra bir hedef Çalıştır 

Yerleşik BeforePubüsh ve AfterPubiish hedefleri, yayımlama hedefinden önce veya sonra bir hedef yürütür. 
Aşağıdaki öğeleri yayımlama profiline, yayımlamadan önce ve sonra da konsol iletilerini günlüğe kaydetmek 
için ekleyin: 











cTarget Name="CustomActionsBeforePublish" BeforeTangets="BeforePublish"> 
<Message Text="Inside BefonePublish" Importance="high" /> 

</Target> 

<Target Name="CustomActionsAfterPublish" AfterTangets="AfterPublish"> 
<Message Text="Inside AfterPublish" Importance="high" /> 

</Target> 


Güvenilmeyen bir sertifikayı kullanarak bir sunucuya yayımlama 



Kudu hizmeti 

Azure App Service Web uygulaması dağıtımında dosyalan görüntülemek için kudu hizmetinikullanın. sem 
belirtecini Web uygulaması adına ekleyin. Örneğin: 

URL SONUÇ 


http://mysite.azunewebsites.net/ 


Web uygulaması 


http://mysite.sem.azurewebsites.net/ 


Kudu hizmeti 


Dosyaları görüntülemek, düzenlemek, silmek veya eklemek için hata ayıklama konsolu menü öğesini seçin. 

Ek kaynaklar 

• Web dağıtımı (MSDeploy), 11S sunucularına Web uygulamaları ve Web siteleri dağıtımını basitleştirir. 

• Web SDK GitHub deposu: dağıtım için dosya sorunları ve istek özellikleri. 

• Visual Studio 'dan bir Azure VM 'de ASP.NET Web uygulaması yayımlama 

• VVeb.config'i dönüştürme 











Tarafından Luke Latham 


Yayımlama dizinini içeren uygulamanın dağıtılabilir varlıklar tarafından üretilen dotnet yayımlama komutu. 
Dizini içerir: 


• Uygulama dosyaları 

• Yapılandırma dosyaları 

• Statik varlıklar 

• Paketler 

• Bir çalışma zamanı (müstakil dağıtım yalnızca) 


UYGULAMA TÜRÜ 


DİZİN YAPISI 


Framevvork bağımlı dağıtım 


• Yayımlamat 


o Görünümlerit (MVC uygulamaları; 

görünümleri önceden derlenmiş değil) 
o Sayfalarıt (sayfaları önceden derlenmiş değil, 
MVC veya Razor sayfaları uygulamaları;) 
o wwwroot+ 
o *.DLL dosyaları 
o (DERLEME adıJ.deps.JSON 
o (DERLEME adı} .dil 
o (DERLEME adı} ,pdb 
o {} DERLEME ADI. Views.dll 
o {} DERLEME ADI. Vievvs.pdb 
° (DERLEME adıfruntimeconfig.json 
° VVeb.config (IIS dağıtımlar) 


Kendi içinde dağıtım 


• Yayımlamat 


o Görünümlerit (MVC uygulamaları; 

görünümleri önceden derlenmiş değil) 
o Sayfalarıt (sayfaları önceden derlenmiş değil, 
MVC veya Razor sayfaları uygulamaları;) 
o wwwroot+ 
o *.dll dosyaları 
o (DERLEME adıJ.deps.JSON 
o (DERLEME adı} .dil 
o (DERLEME adı} ,exe 
o (DERLEME adı} .pdb 
o {} DERLEME ADI. Views.dll 
o {} DERLEME ADI. Vievvs.pdb 
o (DERLEME adıfruntimeconfig.json 
o VVeb.config (IIS dağıtımlar) 


+Bir dizini gösterir 


Yayımlama dizini temsil eder içerik kök yolu ayrıca adlı uygulama temel yolu, dağıtım. Dilediğiniz adı verilir 
yayımlama dizin sunucusuna dağıtılan uygulamanın konumuna barındırılan uygulamasının fiziksel yolu 
sunucunun görür. 





Wwwroot dizini varsa yalnızca içeren statik varlıklar. 

Oluşturma bir günlükleri klasördür yararlı ASP.NET Core modülü Gelişmiş hata ayıklama günlüğü. Sağlanan 
yolda <handierSetting> değer modülü tarafından otomatik olarak oluşturulmaz ve dağıtım hata ayıklama 
günlüğünü yazılacak modülüne izin verecek şekilde önceden mevcut olmalıdır. 

A günlükleri aşağıdaki iki yaklaşımdan birini kullanarak dağıtım için dizin oluşturulabilir: 

• Aşağıdaki <Target> proje dosyasına öğe: 

«cTarget Name="CreateLogsFolder" AfterTargets="Publish"> 

<MakeDir Directories="$(PublishDir)Logs" 

Condition="!Exists('$(PublishDir)Logs')" /> 

<WriteLinesToFile File="$(PublishDir)Logs\.log" 

Lines="Generated file" 

Overwrite="True" 

Condition=" I Exists( ’$(PublishDir) Logs\. log')" /> 

</Target> 

<MakeDir> Öğesi boş bir oluşturur günlükleri yayımlanan çıkış klasöründe. Öğesini kullanan 
PubiishDir özelliği klasörü oluşturmak için hedef konumu belirlenemiyor. Web dağıtımı gibi çeşitli 
dağıtım yöntemleri, dağıtım sırasında boş klasörler atlayın. <writeLinesToFiie> Öğesi bir dosya 
oluşturur günlükleri klasörü, sunucu klasörünün dağıtım garanti eder. Çalışan işlemi, hedef klasöre 
yazma erişimi yoksa, bu yaklaşımı kullanarak klasör oluşturma başarısız olur. 

• Fiziksel olarak oluşturma günlükleri dağıtım sunucusunda dizin. 

Dağıtım dizini okuma/Yürütme izinleri gerektirir. Günlükleri dizin okuma/yazma izinleri gerektirir. Dosyaları 
yazılacağı ek dizinleri okuma/yazma izinleri gerektirir. 

Ek kaynaklar 

• dotnet publish 

• .NET core uygulama dağıtımı 

• Hedef çerçeveler 

• .NET core RID Kataloğu 







ASPNET Core durum denetimleri 
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Luke Latham ve Glenn CONDRON tarafından 

ASP.NET Core, uygulama altyapısı bileşenlerinin sistem durumunu raporlamak için sistem durumu denetimleri 
ve kitaplıkları sunar. 

Sistem durumu denetimleri, bir uygulama tarafından HTTP uç noktaları olarak gösterilir. Durum denetimi uç 
noktaları, çeşitli gerçek zamanlı izleme senaryoları için yapılandırılabilir: 

• Sistem durumu araştırmaları, kapsayıcı yöneticileri ve yük dengeleyiciler tarafından bir uygulamanın 
durumunu denetlemek için kullanılabilir. Örneğin, bir kapsayıcı Orchestrator, sıralı bir dağıtımı kaldırarak veya 
kapsayıcıyı yeniden başlatarak başarısız olan bir sistem durumu denetimine yanıt verebilir. Yük dengeleyici, 
trafiği başarısız olan örnekten sağlıklı bir örneğe yönlendirerek sağlıklı olmayan bir uygulamaya tepki 
verebilir. 

• Bellek, disk ve diğer fiziksel sunucu kaynaklarının kullanımı sağlıklı bir durum için izlenebilir. 

• Sistem durumu denetimleri, kullanılabilirliği ve normal çalışmayı onaylamak için bir uygulamanın 
veritabanları ve dış hizmet uç noktaları gibi bağımlılıklarını test edebilir. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Örnek uygulama, bu konuda açıklanan senaryoların örneklerini içerir. Örnek uygulamayı belirli bir senaryo için 
çalıştırmak için, bir komut kabuğunda projenin klasöründen DotNet Run komutunu kullanın. Örnek uygulamayı 
kullanma hakkında ayrıntılı bilgi için bu konudaki örnek uygulamanın README.MD dosyasına ve senaryo 
açıklamalarına bakın. 

Prerequisites 

Durum denetimleri, genellikle bir uygulamanın durumunu denetlemek için bir dış izleme hizmeti veya kapsayıcı 
Orchestrator ile birlikte kullanılır. Bir uygulamaya sistem durumu denetimleri eklemeden önce, hangi izleme 
sisteminin kullanılacağını belirleyin. İzleme sistemi ne tür bir sistem durumu denetimi oluşturulacağını ve 
bunların uç noktalarını nasıl yapılandıracağınızı belirler. 

Microsoft. AspNetCore. Diagnostics. Healthdenetimlerin paketine ASP.NET Core uygulamaları için örtük olarak 
başvurulur. Entity Framework Core kullanarak sistem durumu denetimleri gerçekleştirmek için, Microsoft. 
Extensions. Diagnostics. Healthdenetimleri. EntityFramevvorkCore paketine bir paket başvurusu ekleyin. 

Örnek uygulama, çeşitli senaryolar için sistem durumu denetimlerini göstermek üzere başlangıç kodu sağlar. 
Veritabanı araştırma senaryosu, Aspnetcore. Diagnostics. healthdenetimlerikullanarak bir veritabanı bağlantısının 
sistem durumunu denetler. DbContext araştırma senaryosu, bir EF Core DbContext kullanarak bir veritabanını 
denetler. Örnek uygulama olan veritabanı senaryolarını araştırmak için: 

• Bir veritabanı oluşturur ve bunun bağlantı dizesini appSettings. JSON dosyasında sağlar. 

• , Proje dosyasında aşağıdaki paket başvurularına sahiptir: 

o AspNetCore. Healthdenetimleri. SqlServer 

o Microsoft. Extensions. Diagnostics. Healthdenetimleri. EntityFramevvorkCore 


NOTE 

Aspnetcore. Diagnostics. Healthdenetimleri Microsoft tarafından korunmaz veya desteklenmez. 





Başka bir sistem durumu denetimi senaryosunda, sistem durumu denetimlerinin bir yönetim bağlantı noktasına 
nasıl filtreleneceği gösterilir. Örnek uygulama, Yönetim URL 'sini ve yönetim bağlantı noktasını içeren bir 
Özellikler/launchSettings. JSON dosyası oluşturmanızı gerektirir. Daha fazla bilgi için, bağlantı noktasına göre 
filtrele bölümüne bakın. 

Temel sistem durumu araştırması 

Birçok uygulama için, uygulamanın istekleri işleme için kullanılabilirliğini raporlayan temel bir durum araştırma 
yapılandırması, uygulamanın durumunu öğrenmekiçin yeterlidir. 

Temel yapılandırma, sistem durumu denetimi hizmetlerini kaydeder ve sistem durumu denetimleri ara yazılımını 
çağırarak bir URL uç noktasında bir sistem durumu yanıtı ile yanıt verir. Varsayılan olarak, belirli bir bağımlılığı 
veya alt sistemi test etmek için belirli bir sistem durumu denetimi kayıtlı değildir. Sistem durumu uç nokta URL 
'sinde yanıt veriyorsa, uygulama sağlıklı olarak değerlendirilir. Varsayılan yanıt yazıcı, durumu (HealthStatus) 
istemciye geri düz metin yanıtı olarak yazar . sağlıklıdurum, sistem sağlığı durumu . düşürülmüş veya 
HealthStatus. sağlıksız durum. 

Sistem durumu denetimi hizmetlerini startup.configureServices AddHealthChecks ile kaydedin, 
startup.configure''MapHealthchecks çağırarak bir sistem durumu denetimi uç noktası oluşturun. 

Örnek uygulamada, durum denetimi uç noktası /health oluşturulur ( BasicStartup.es ): 

public elass BasicStartup 
{ 

public void ConfigureSer'vices(IServiceCollection Services) 

{ 

Services.AddHealthChecks(); 

} 

public void Configure(IApplicationBuilder app) 

{ 

app.UseRoutingO; 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapHealthchecks("/health"); 

}); 

} 

} 

Örnek uygulamayı kullanarak temel yapılandırma senaryosunu çalıştırmak için, komut kabuğunda projenin 
klasöründen aşağıdaki komutu yürütün: 

dotnet run --scenario basic 

Docker örneği 

Docker , temel sistem durumu denetimi yapılandırmasını kullanan bir uygulamanın durumunu denetlemek için 
kullanılabilen yerleşik bir healthcheck yönergesi sunar: 

HEALTHCHECK CMD curl --fail http://localhost:5000/health || exit 


Durum denetimleri oluşturma 

Durum denetimleri I HealthCheck arabirimi uygulayarak oluşturulur. CheckHealthAsync yöntemi, sistem 
durumunu Healthy , Degraded veya unhealthy olarak belirten bir HealthCheckResult döndürür. Sonuç 











yapılandırılabilir bir durum kodu ile düz metin yanıtı olarak yazılır (yapılandırma, sistem durumu denetimi 
seçenekleri bölümünde açıklanmıştır). HealthCheckResult, isteğe bağlı anahtar-değer çiftleri de döndürebilir. 


Aşağıdaki ExampieHeaithCheck sınıfı, bir sistem durumu denetiminin yerleşimini gösterir. Durum denetimleri 
mantığı checkHealthAsync yöntemine yerleştirilir. Aşağıdaki örnek, true için healthCheckResuitHealthy bir kukla 
değişken ayarlar. healthCheckResuitHealthy değeri faise olarak ayarlanırsa Healthcheckresult. sağlıksız durum 
döndürülür. 


public class ExampleHealthCheck : IHealthCheck 
{ 

public Task<HealthCheckResult> CheckHealthAsync( 

HealthCheckContext context, 

CancellationToken cancellationToken = default(CancellationToken)) 

{ 

var healthCheckResuitHealthy = true; 

if (healthCheckResuitHealthy) 

{ 

return Task.FromResult( 

HealthCheckResult.Healthy("A healthy result.")); 

} 


} 


return Task.FromResult( 

HealthCheckResult.Unhealthy("An unhealthy result.")); 


} 


Sistem durumu denetimi hizmetlerini Kaydet 

ExampieHeaithCheck türü, startup.configureServices AddCheck sistem durumu denetimi hizmetlerine eklenir: 


Services.AddHealthChecks() 

.AddCheck<ExampleHealthCheck>("example_health_check"); 


Aşağıdaki örnekte gösterilen AddCheck aşırı yüklemesi, sistem durumu denetimi bir hata bildirdiğinde hata 
durumunu (HealthStatus) ayarlar. Hata durumu nuiı (varsayılan) olarak ayarlandıysa, HealthStatus. sağlıksız 
olarak bildirilir. Bu aşırı yükleme, kitaplık yazarları için yararlı bir senaryodur, burada, sistem durumu denetimi 
uygulaması ayarı varsa, bir sistem durumu denetimi hatası oluştuğunda, kitaplık tarafından belirtilen başarısızlık 
durumu uygulama tarafından zorlanır. 

Etiketler , sistem durumu denetimlerini filtrelemek için kullanılabilir ( durum denetimleri filtreleme bölümünde 
daha ayrıntılı olarak açıklanmıştır). 

Services.AddHealthChecks() 

.AddCheck<ExampleHealthCheck>( 

"example_health_check ", 
failureStatus: HealthStatus.Degraded , 
tags: new[] { "example" }); 

AddCheck bir Lambda işlevi de yürütebilir. Aşağıdaki örnekte, sistem durumu denetim adı Exampie olarak 
belirtilir ve denetim her zaman sağlıklı bir durum döndürür: 

Services.AddHealthChecks() 

.AddCheck("Example" J () => 

HealthCheckResult.Healthy("Example is OKI"), tags: new[] { "example" }); 















Bir sistem durumu denetimi uygulamasına daha fazla geçiş yapmak için AddTypeActivatedCheck çağırın. 
Aşağıdaki örnekte, TestHeaithcheckWithArgs bir tamsayıyı ve CheckHealthAsync çağrıldığında kullanılacak dizeyi 
kabul eder: 


private class TestHealthCheckl/dithArgs : IHealthCheck 
{ 

public TestHealthCheckWithArgs(int i, string s) 

{ 

I = i; 

S = s; 


public int I { get; set; } 
public string S { get; set; } 

public Task<HealthCheckResult> CheckHealthAsync(HealthCheckContext context, 

CancellationToken cancellationToken = default) 

{ 

} 

} 

TestHealthCheckl/dithArgs , uygulamaya geçirilen tamsayı ve dize ile AddTypeActivatedCheck çağırarak kaydedilir: 

Services.AddHealthChecks() 

.AddTypeActivatedCheck<TestHealthCheckWithArgs>( 

"test ", 

failureStatus: HealthStatus.Degraded, 

tags: new[] { "example" }, 

args: new objectf] { S, "string" }); 


Sistem durumu denetimleri yönlendirmeyi kullanma 

startup.configure , uç nokta URL 'SI veya göreli yol ile Endpoint Builder üzerinde MapHealthChecks çağırın: 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapHealthChecks("/health"); 

}); 

Konak gerektir 

Sistem durumu denetimi uç noktası için bir veya daha fazla izin verilen Konakları belirtmek üzere RequireHost 
çağrısı yapın. Konaklar, puni kodu yerine Unicode olmalıdır ve bir bağlantı noktası içerebilir.Bir koleksiyon 
sağlanmazsa, herhangi bir konak kabul edilir. 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapHealthChecks("/health").RequireHost("www.contoso.com:5001"); 

}); 

Daha fazla bilgi için, bağlantı noktasına göre filtrele bölümüne bakın. 

Yetkilendirme gerektir 

Sistem durumu denetimi istek uç noktasında yetkilendirme ara yazılımını çalıştırmak için RequireAuthorization 
çağırın. RequireAuthorization aşırı yükleme bir veya daha fazla yetkilendirme ilkesini kabul eder. Bir ilke 









sağlanmazsa, varsayılan yetkilendirme ilkesi kullanılır. 


app.UseEndpoints(endpoints => 

{ 

endpoints.MapHealthChecks("/health").RequireAuthorization(); 

}); 

Kaynaklar Arası İstekleri (CORS) etkinleştirme 

Bir tarayıcıdan el ile sistem durumu denetimleri gerçekleştirmek yaygın kullanım senaryosu olmamasına karşın, 
CORS ara yazılımı RequireCors sistem durumu denetimleri uç noktalarında çağırarak etkinleştirilebilir. 
RequireCors aşırı yüklemesi CORS ilke Oluşturucu temsilcisini ( corsPolicyBuiider ) veya bir ilke adını kabul 
eder. Bir ilke sağlanmazsa varsayılan CORS ilkesi kullanılır.Daha fazla bilgi için bkz. ASP.NET Core 'de çıkış 
noktaları arası İstekleri (CORS) etkinleştirme. 

Sistem durumu denetimi seçenekleri 

HealthCheckOptions sistem durumu denetimi davranışını özelleştirmek için bir fırsat sağlayın: 

• Durum denetimlerini filtrele 

• HTTP durum kodunu özelleştirme 

• Önbellek üstbilgilerini gösterme 

• Çıktıyı özelleştirme 

Durum denetimlerini filtrele 

Varsayılan olarak, sistem durumu denetimleri ara yazılımı tüm kayıtlı sistem durumu denetimlerini çalıştırır. Bir 
sistem durumu denetimleri alt kümesini çalıştırmak için Predicate seçeneğine Boole değeri döndüren bir işlev 
sağlayın. Aşağıdaki örnekte, Bar sistem durumu denetimi, işlevin koşullu deyimindeki etiketiyle ( bar_tag ) 
filtrelenerek true yalnızca sistem durumu denetiminin Tags özelliği foo_tag veya baz_tag eşleşiyorsa 
döndürülür: 

Startup.ConfigureServices : 

Services.AddHealthChecks() 

.AddCheck("Foo", () => 

HealthCheckResult.Healthy("Foo is OK!")) tags: new[] { "foo_tag" }) 

.AddCheck("Bar"j () => 

HealthCheckResult.Unhealthy("Bar is unhealthy !"), tags: new[] { "bar_tag" }) 

.AddCheck("Baz"j () => 

HealthCheckResult.Healthy("Baz is OK!")j tags: new[] { "baz_tag" }); 

startup.configure , Predicate ' Bar' sistem durumu denetimini filtreler.Yalnızca Foo ve baz Execute.: 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapHealthChecks("/health", new HealthCheckOptions() 

{ 

Predicate = (check) => check.Tags.Contains("foo_tag") | 
check.Tags.Contains("baz_tag") 

}); 

}); 

HTTP durum kodunu özelleştirme 

Sistem durumunun HTTP durum kodlarına eşlenmesini özelleştirmek için ResultStatusCodes kullanın. Aşağıdaki 
StatusCodes atamaları, ara yazılım tarafından kullanılan varsayılan değerlerdir. Durum kodu değerlerini 
gereksinimlerinize uyacak şekilde değiştirin. 











Startup.Configure : 

app.UseEndpoints(endpoints = > 

{ 

endpoints.MapHealthChecks("/health" J new HealthCheckOptions() 

{ 

ResultStatusCodes = 

{ 

[HealthStatus.Healthy] = StatusCodes.Status200OK, 

[HealthStatus.Degraded] = StatusCodes.Status200OKj 

[HealthStatus.Unhealthy] = StatusCodes.Status503ServiceUnavailable 

} 

}); 

}); 

Önbellek üstbilgilerini gösterme 

AllovvCachingResponses, yanıt önbelleğini engellemek için sistem durumu denetimlerinin ara yazılım tarafından 
araştırma yanıtına HTTP üstbilgileri ekleyip eklemediğini denetler. Değer faise (varsayılan) ise, ara yazılım, yanıt 
önbelleğe almayı engellemek için Cache-Control , Expires ve Pragma üst bilgilerini ayarlar veya geçersiz kılar. 
Değer true ise, ara yazılım yanıtın önbellek üstbilgilerini değiştirmez. 

Startup.Configure : 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapHealthChecks("/health", new HealthCheckOptions() 

{ 

AllowCachingResponses = faise 

}); 

}); 


Çıktıyı özelleştirme 

ResponseWriter seçeneği, yanıtı yazmak için kullanılan bir temsilciyi alır veya ayarlar. 

Startup.Configure : 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapHealthChecks("/health", new HealthCheckOptions() 

{ 

ResponseWriter = WriteResponse 

}); 

}); 

Varsayılan temsilci, HealthReport. Statusdize değerine sahip en az bir düz metin yanıtı yazar. Aşağıdaki özel 
temsilci, writeResponse özel bir JSON yanıtı verir: 







private static Task WriteResponse(HttpContext httpContextj HealthReport result) 

{ 

httpContext.Response.ContentType = "application/json"; 
var json = new TObject( 

new DProperty("status ", result.Status.ToStringO), 
new DProperty("results"j new 10bject(result.Entrles.Select(pair => 
new TPropertyfpair.Key, new DObjectf 

new lProperty("status ", palr.Value.Status.ToStringO), 
new DProperty("descriptlon"j pair.Value.Description ), 
new lProperty("data ", new 10bject(palr.Value.Data.Select( 
p => new ]Property(p.Keyj p.Value)))))))))); 
return httpContext.Response.WriteAsync( 
json.ToString(Formatting.Indented)); 

} 


Durum denetimleri sistemi, karmaşık JSON dönüş biçimleri için yerleşik destek sağlamaz çünkü biçim, sizin 
tercih ettiğiniz izleme sistemine özgüdür. Gereksinimlerinizi karşılamak için gereken önceki örnekteki DObject 
özelleştirebilirsiniz. 

Veritabanı araştırması 

Bir sistem durumu denetimi, veritabanının normal olarak yanıt verip vermediğini göstermek üzere Boole testi 
olarak çalışacak bir veritabanı sorgusu belirtebilir. 

Örnek uygulama, SQL Server veritabanında bir sistem durumu denetimi gerçekleştirmek için ASP.NET Core 
uygulamalar için bir sistem durumu denetim kitaplığı olan Aspnetcore. Diagnostics. healthcheckkullanır. 
AspNetcore.Diagnostics.Healthchecks veritabanı bağlantısının sağlıklı olduğundan emin olmak için veritabanında 
select ı bir sorgu yürütür. 


WARNING 

Bir sorgu ile bir veritabanı bağlantısı denetlerken, hızlı bir şekilde dönen bir sorgu seçin. Sorgu yaklaşımı, veritabanını aşırı 
yükleme ve performansını düşürmeye yönelik riski çalıştırır. Çoğu durumda, test sorgusunun çalıştırılması gerekli değildir. 
Yalnızca veritabanına başarılı bir bağlantı oluşturmak yeterlidir. Bir sorgu çalıştırmak için gerekli olduğunu fark ederseniz, 
select ı gibi basit bir seçme sorgusu seçin. 


Aspnetcore. Healthdenetimlerin. SqlServeröğesine bir paket başvurusu ekleyin. 

Örnek uygulamanın appSettings. JSON dosyasında geçerli bir veritabanı bağlantı dizesi sağlayın. Uygulama, 
HealthcheckSample adında bir SOL Server veritabanı kullanır: 








{ 

"ConnectionStrings": { 

"DefaultConnection": "Server= 

(localdb)\\MSSQLLocalDB;Database=HealthCheckSample;Trusted_Connection=True;MultipleActiveResultSets=true;Conn 

ectRetryCount=0" 

}, 

"Logging": { 

"LogLevel": { 

"Default": "Information ", 

"Microsoft": "Warning", 

"Microsoft.Hosting.Lifetime": "Information" 

b 

"Console": { 

"IncludeScopes": "true" 

} 

b 

"AllowedHosts": "*" 

} 

Sistem durumu denetimi hizmetlerini startup.configureServices AddHealthChecks ile kaydedin. Örnek 
uygulama, veritabanının bağlantı dizesiyle Addsqiserver yöntemini çağırır ( DbHealthStartup.es ): 

Services.AddHealthChecks() 

.AddSqlServer(Configuration["ConnectionStrings:DefaultConnection"]); 

startup.configure''MapHealthehecks çağırarak bir sistem durumu denetim uç noktası oluşturulur: 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapHealthehecks("/health"); 

} 


Örnek uygulamayı kullanarak veritabanı araştırma senaryosunu çalıştırmak için, bir komut kabuğunda projenin 
klasöründen aşağıdaki komutu yürütün: 



DbContext araştırması Entity Framevvork Core 

DbContext denetimi, uygulamanın bir EF Core DbContext için yapılandırılmış veritabanıyla iletişim kurabildiğini 
onaylar. DbContext denetimi şu uygulamalar için desteklenir: 

• Entity Framevvork (EF) Corekullanın. 

• Microsoft. Extensions. Diagnostics. Healthdenetimleri. EntityFramevvorkCore'a bir paket başvurusu ekleyin. 


AddDbContextCheck<TContext> 

bir 

DbContext sistem durumu denetimi kaydeder. 

DbContext 

, metoduna 

TContext 


olarak sağlanır. Flata durumu, Etiketler ve özel bir test sorgusunu yapılandırmak için aşırı yükleme kullanılabilir. 
Varsayılan olarak: 


DbContextHeaithCheck EF Core canConnectAsync yöntemini çağırır. AddDbContextcheck yöntemi aşırı yüklerini 
















kullanarak sistem durumunu denetlerken hangi işlemin çalıştırılacağını özelleştirebilirsiniz. 



( DbContextHealthStartup.cs ) olarak kaydedilir. 

Services.AddHealthChecks() 

.AddDbContextCheck<AppDbContext>(); 

Services.AddDbContext<AppDbContext>(options => 

{ 

options.UseSqlServer( 

Configuration["ConnectionStrings:DefaultConnection"]); 

}); 

startup.configure''MapHealthchecks çağırarak bir sistem durumu denetim uç noktası oluşturulur: 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapHealthchecks("/health"); 

} 

Örnek uygulamayı kullanarak DbContext araştırma senaryosunu çalıştırmak için, bağlantı dizesi tarafından 
belirtilen veritabanının SQL Server örneğinde mevcut olmadığından emin olun. Veritabanı varsa, silin. 

Komut kabuğunda projenin klasöründen aşağıdaki komutu yürütün: 

dotnet run --scenario dbcontext 

Uygulama çalıştırıldıktan sonra, bir tarayıcıda /health uç noktasına bir istek yaparak sistem durumunu 
denetleyin. Veritabanı ve AppDbContext olmadığından, uygulama aşağıdaki yanıtı sağlar: 

Unhealthy 

Veritabanını oluşturmak için örnek uygulamayı tetikleyin. /createdatabase için bir istek oluşturun. Uygulama 
yanıt veriyor: 

Creating the database... 

Done! 

Navigate to /health to see the health status. 

/health uç noktasına bir istek oluşturun. Veritabanı ve bağlam var, bu nedenle uygulama yanıt veriyor: 

Healthy 

Veritabanını silmek için örnek uygulamayı tetikleyin. /deletedatabase için bir istek oluşturun. Uygulama yanıt 
veriyor: 

Deleting the database... 

Done! 

Navigate to /health to see the health status. 


/health uç noktasına bir istek oluşturun. Uygulama sağlıksız bir yanıt sağlar: 












Unhealthy 


Ayrı hazırlık ve lizlilik araştırmaları 

Bazı barındırma senaryolarında iki uygulama durumunu ayırt eden bir çift sistem durumu denetimi kullanılır: 

• Uygulama çalışıyor ancak henüz istekleri almaya hazırlanma. Bu durum, uygulamanın hazır o/modurumu. 

• Uygulama çalışır ve isteklere yanıt verir. Bu durum, uygulamanın kullanım koşullarına göre yapılır. 

Hazırlık denetimi genellikle uygulamanın tüm alt sistemlerinin ve kaynaklarının kullanılabilir olup olmadığını 
belirlemede daha kapsamlı ve zaman alıcı denetim kümesi gerçekleştirir. Bir onay işareti yalnızca uygulamanın 
istekleri işlemek için kullanılabilir olup olmadığını belirlemede hızlı bir denetim gerçekleştirir. Uygulama, hazırlık 
denetimini geçirdikten sonra, yüksek hazırlık denetimleri kümesi ile uygulamayı daha fazla yüklemeye gerek 
yoktur—daha fazla denetim için yalnızca lileme denetimi gerektirir. 

Örnek uygulama, barındırılan bir hizmetteuzun süre çalışan başlatma görevinin tamamlandığını raporlamak için 
bir sistem durumu denetimi içerir. startupHostedServiceHealtheheck , barındırılan hizmetin uzun süre çalışan 
görevi bittiğinde true olarak ayarlayabilmesini StartupTaskCompleted bir özelliği kullanıma sunar 
( StartupHostedServiceHealthCheck.es ): 

public elass StartupHostedServiceHealthCheck : IHealthCheck 
{ 

private volatile bool _startupTaskCompleted = false; 

public string Name => "slow_dependency_check"; 

public bool StartupTaskCompleted 
{ 

get => _startupTaskCompleted; 

set => _startupTaskCompleted = value; 

} 

public Task<HealthCheckResult> CheckHealthAsync( 

HealthCheckContext context, 

CancellationToken cancellationToken = default(CancellationToken)) 

{ 

if (StartupTaskCompleted) 

{ 

return Task.FromResult( 

HealthCheckResult.Healthy("The startup task is finished.")); 

} 

return Task.FromResult( 

HealthCheckResult.Unhealthy("The startup task is stili running.")); 

} 

} 

Uzun süre çalışan arka plan görevi bir barındırılan hizmet ( Hizmetler/startuphostedservice ) tarafından başlatılır. 
Görevin sonunda, StartupHostedServiceHealthCheck.StartupTaskCompleted true olarak ayarlanır: 






public class StartupHostedService : IHostedService, IDisposable 

{ 

private readonly int _delaySeconds = 15; 
private readonly ILogger _logger; 

private readonly StartupHostedServiceHealthCheck _startupHostedServiceHealthCheck; 

public StartupHostedService(ILogger<StartupHostedService> logger, 

StartupHostedServiceHealthCheck startupHostedServiceHealthCheck) 

{ 

_logger = logger; 

_startupHostedServiceHealthCheck = startupHostedServiceHealthCheck; 

} 

public Task StartAsync(CancellationToken cancellationToken) 

{ 

_logger.LogInformation("Startup Background Service is starting."); 

// Simulate the effect of a long-running startup task. 

Task.Run(async () => 

{ 

await Task.Delay(_delaySeconds * 1000); 

_startupHostedServiceHealthCheck.StartupTaskCompleted = true; 

_logger.LogInformation("Startup Background Service has started."); 

}); 

return Task.CompletedTask; 

} 

public Task StopAsync(CancellationToken cancellationToken) 

{ 

_logger.LogInformation("Startup Background Service is stopping."); 
return Task.CompletedTask; 

} 

public void Dispose() 

{ 

} 

} 

Sistem durumu denetimi, barındırılan hizmetle birlikte startup. configureServices AddCheck kaydedilir. 
Barındırılan hizmetin, sistem durumu denetiminde özelliği ayarlaması gerektiğinden, sistem durumu denetimi de 
hizmet kapsayıcısına kaydedilir ( LivenessProbeStartup.es ): 

Services.AddHostedService<StartupHostedService>(); 

Services.AddSingleton<StartupHostedServiceHealthCheck>(); 

Services.AddHealthChecks() 

.AddCheck<StartupHostedServiceHealthCheck>( 

"hosted_service_startup ", 
failureStatus: HealthStatus.Degraded , 
tags: new[] { "ready" }); 

Services.Configure<HealthCheckPublisherOptions>(options => 

{ 

options.Delay = TimeSpan.FromSeconds(2); 

options.Predicate = (check) => check.Tags.Contains("ready"); 

}); 

Services.AddSingletoncIHealthCheckPublisher, ReadinessPublisher>(); 


startup.configure''MapHealthehecks çağırarak bir sistem durumu denetim uç noktası oluşturulur. Örnek 



uygulamada, sistem durumu denetimi uç noktalan şu konumda oluşturulur: 

• Hazırlık denetimi için /health/ready . Hazırlık denetimi, durum denetimini ready etiketiyle durum denetimi 
olarak denetler. 

• libir denetim için /health/live . Libu denetim, Healthcheckoptions. koşula faise döndürerek 

startupHostedServiceHealtheheck filtreler (daha fazla bilgi için bkz. durum denetimlerini filtrele) 

Aşağıdaki örnek kodda: 

• Hazır olma denetimi ' hazır' etiketiyle tüm kayıtlı denetimleri kullanır. 

• Predicate tüm denetimleri dışladığı ve 200-Tamam döndürüyor. 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapHealthChecks("/health/ready", new HealthCheckOptions() 

{ 

Predicate = (check) => check.Tags.Contains("ready")j 

}); 

endpoints.MapHealthChecks("/health/live ", new Healthcheckoptions() 

{ 

Predicate = (_) => faise 

}); 

} 

Örnek uygulamayı kullanarak hazırlık/lizlilik yapılandırma senaryosunu çalıştırmak için, aşağıdaki komutu 
projenin klasöründen bir komut kabuğu 'ndan yürütün: 

dotnet run --scenario liveness 

Bir tarayıcıda, 15 saniye geçtikten sonra /health/ready birkaç kez ziyaret edin. Sistem durumu denetimi ilk 15 
saniye boyunca sağlıksız durum bildiriyor. 15 saniye sonra, uç nokta, barındırılan hizmet tarafından uzun süre 
çalışan görevin tamamlandığını yansıtan sağlıklışe kilde raporlar. 

Bu örnek ayrıca, iki saniyelik bir gecikmeyle ilk hazırlık denetimini çalıştıran bir sistem durumu denetimi 
yayımcısı (IHealthCheckPublisher uygulaması) oluşturur.Daha fazla bilgi için bkz. sistem durumu denetimi 
yayımcısı bölümü. 

Kubernetes örneği 

Ayrı hazır olma ve Ezlilik denetimleri kullanmak, Kubernetesgibi bir ortamda yararlıdır. Kubernetes 'te, temel 
veritabanı kullanılabilirliğinin bir testi gibi istekleri kabul etmeden önce, zaman alan Başlangıç işlerini 
gerçekleştirmek için bir uygulamanın olması gerekebilir. Ayrı denetimlerin kullanılması, Orchestrator 1 1 n 
uygulamanın çalışıp çalışmadığını, ancak henüz hazırlanmadığını ya da uygulamanın başlayamadığını ayırt 
etmesine olanak tanır. Kubernetes 'te hazır olma ve Elanma araştırmaları hakkında daha fazla bilgi için bkz. 
Kubernetes belgelerindeki limize ve hazırlık araştırmalarını yapılandırma . 

Aşağıdaki örnekte bir Kubernetes Readiness araştırma yapılandırması gösterilmektedir: 











spec: 

template: 
spec: 

readinessProbe: 

# an http probe 
httpGet: 

path: /health/ready 
port: 80 

# length of time to wait for a pod to initialize 

# after pod startup, befone applying health checking 
initialDelaySeconds: 30 

timeoutSeconds: 1 
ports: 

- containerPort: 80 


Özel bir yanıt yazıcı ile ölçüm tabanlı araştırma 

Örnek uygulama, özel bir yanıt yazıcısı ile bir bellek durumu denetimini gösterir. 

uygulama, belirli bir bellek eşiğine (örnek uygulamada 1 GB) daha fazlasını kullanıyorsa MemoryHealthCheck . 
HealthCheckResult, uygulama için çöp toplayıcı (GC) bilgilerini içerir ( MemoryHealthCheck.es ): 

public elass MemoryHealthCheck : IHealthCheck 

{ 

private readonly IOptionsMonitor<MemoryCheckOptions> _options; 

public MemoryHealthCheck(IOptionsMonitor<MemoryCheckOptions> options) 

{ 

_options = options; 

} 

public string Name => "memory_check"; 

public Task<HealthCheckResult> CheckHealthAsync( 

HealthCheckContext context, 

CancellationToken cancellationToken = default(CancellationToken)) 

{ 

var options = _options.Get(context.Registration.Name); 

// Include GC information in the reported diagnostics. 

var allocated = GC.GetTotalMemory(forceFullCollection: false); 

var data = new Dictionarycstring, object>() 

{ 

{ "AllocatedBytes", allocated }, 

{ "Gen0Collections", GC.CollectionCount(0) }, 

{ "GenlCollections", GC.CollectionCount(l) }, 

{ "Gen2Collections", GC.CollectionCount(2) }, 

}; 

var status = (allocated < options.Threshold) ? 

HealthStatus.Healthy : context.Registration.FailureStatus; 

return Task.FromResult(new HealthCheckResult( 
status, 

deseription: "Reports degraded status if allocated bytes " + 

$">= {options.Threshold} bytes.", 
exception: null, 
data: data)); 

} 

} 

Sistem durumu denetimi hizmetlerini startup.configureServices AddHealthChecks ile kaydedin. Durum 
denetimini AddCheckgeçirerek etkinleştirmek yerine, MemoryHealthCheck bir hizmet olarak kaydedilir. Tüm kayıtlı 







IHealthCheck Hizmetleri sistem durumu denetimi Hizmetleri ve ara yazılım tarafından kullanılabilir.Sistem 
durumu denetimi hizmetlerini tek hizmet olarak kaydetmeyi öneririz. 

Örnek uygulamada ( CustomWriterStartup.cs ): 

Services.AddHealthChecks() 

.AddMemoryHealthCheck("memory"); 

startup.configure''MapHealthchecks çağırarak bir sistem durumu denetim uç noktası oluşturulur. Bir 
writeResponse temsilcisi, sistem durumu denetimi yürütüldüğünde özel bir JSON yanıtının çıkışı için 
Responsewriter özelliğine sağlanır: 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapHealthChecks("/health"., new HealthCheckOptions() 

{ 

ResponseWriter = WriteResponse 

}); 

} 

writeResponse yöntemi bir JSON nesnesine compositeHealthCheckResuit biçimlendirir ve sistem durumu 
denetimi yanıtı için JSON çıktısı verir: 

private static Task WriteResponse(HttpContext httpContext, 

HealthReport result) 

{ 

httpContext.Response.ContentType = "application/json"; 
var json = new 10bject( 

new ]Property("status ", result.Status.ToStringO), 
new DProperty("results"j new 10bject(result.Entries.Select(pair => 
new DProperty(pair.Key, new D0bject( 

new DProperty("status ", palr.Value.Status.ToStringO), 
new IPropertyC’description", pair.Value.Descriptlon ), 
new DProperty("data", new 10bject(palr.Value.Data.Select( 
p => new 3Property(p.Keyj p.Value)))))))))); 
return httpContext.Response.WriteAsync( 
json.ToString(Formatting.Indented)); 

} 


Örnek uygulamayı kullanarak özel yanıt yazıcı çıkışıyla ölçüm tabanlı araştırmayı çalıştırmak için, komut kabuğu 
’ndaki projenin klasöründen aşağıdaki komutu yürütün: 



Bağlantı noktasına göre filtrele 

Belirtilen bağlantı noktasına sistem durumu denetim isteklerini kısıtlamak için bir bağlantı noktası belirten bir 
URL düzeniyle MapHealthchecks RequireHost çağırın. Bu genellikle bir kapsayıcı ortamında, izleme hizmetleri 








için bir bağlantı noktası oluşturmak için kullanılır. 


Örnek uygulama, ortam değişkeni yapılandırma sağlayıcısınıkullanarak bağlantı noktasını yapılandırır. Bağlantı 
noktası, Laurıchsettings. JSON dosyasında ayarlanır ve bir ortam değişkeni aracılığıyla yapılandırma sağlayıcısına 
geçirilir. Ayrıca, sunucuyu Yönetim bağlantı noktasındaki istekleri dinleyecek şekilde yapılandırmanız gerekir. 

Yönetim bağlantı noktası yapılandırmasını göstermek üzere örnek uygulamayı kullanmak için, bir Özellikler 
klasöründe laurıchsettings. JSON dosyasını oluşturun. 

Örnek uygulamadaki aşağıdaki Özellikler/launchSettings. JSON dosyası, örnek uygulamanın proje dosyalarına 
dahil değildir ve el ile oluşturulması gerekir: 

{ 

"profiles": { 

"SampleApp": { 

"commandName": "Project", 

"commandLineArgs": 

"launchBrowser": true, 

"environmentVariables": { 

"ASPNETCORE_ENVIRONMENT": "Development", 

"ASPNETCORE_URLS": "http://localhost:5000/;http://localhost:5001/", 

"ASPNETCORE_MANAGEMENTPORT" : "5001" 

}, 

"applicationllrl": "http://localhost:5000/" 

} 

} 

} 

Sistem durumu denetimi hizmetlerini startup.configureservices AddHealthChecks ile kaydedin, 
startup.configure''MapHealthehecks çağırarak bir sistem durumu denetimi uç noktası oluşturun. 

Örnek uygulamada, startup.configure uç noktasındaki RequireHost çağrısı, yapılandırmadan yönetim bağlantı 
noktasını belirtir: 


endpoints.MapHealthehecks("/health") 

.RequireHost($"*:{Configuration["ManagementPort"]}"); 

Uç noktalar startup.configure örnek uygulamada oluşturulur. Aşağıdaki örnek kodda: 

• Hazır olma denetimi ' hazır' etiketiyle tüm kayıtlı denetimleri kullanır. 

• Predicate tüm denetimleri dışladığı ve 200-Tamam döndürüyor. 


app.UseEndpoints(endpoints => 

{ 

endpoints.MapHealthChecks("/health/ready", new HealthCheckOptions() 

{ 

Predicate = (check) => check.Tags.Contains("ready"), 

}); 

endpoints.MapHealthChecks("/health/live", new HealthCheckOptions() 

{ 

Predicate = (_) => false 

}); 









NOTE 

Yönetim bağlantı noktasını kodda açıkça ayarlayarak, örnek uygulamada Launchsettings. JSON dosyasını oluşturmaktan 
kaçınabilirsiniz. HostBuilder oluşturulduğu program.es içinde, ListenAnylP için bir çağrı ekleyin ve uygulamanın yönetim 
bağlantı noktası uç noktasını sağlayın. ManagementPortStartup.es configure RequireHost ile yönetim bağlantı noktasını 
belirtin: 

Program.es: 

return new HostBuilder() 

. Conf igur'eWebHostDefaults(webBuilder => 

{ 

webBuilder.UseKestr'el() 

.ConfigureKestrel(serverOptions => 

{ 

serverOptions.ListenAnylP(5001)j 

}) 

.UseStartup(startupType); 

}) 

.Build(); 


ManagementPortStartup.es: 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapHealthChecks("/health").RequireHost("*:5001"); 

}); 


Yönetim bağlantı noktası yapılandırma senaryosunu örnek uygulamayı kullanarak çalıştırmak için, aşağıdaki 
komutu projenin klasöründen bir komut kabuğu ’ndan yürütün: 

dotnet run --scenario port 


Bir sistem durumu denetim kitaplığı dağıtma 

Bir sistem durumu denetimini kitaplık olarak dağıtmak için: 

1. IHealthCheck arabirimini tek başına bir sınıf olarak uygulayan bir sistem durumu denetimi yazın. Sınıf, 
yapılandırma verilerine erişmek için bağımlılık ekleme (dı), tür etkinleştirme ve adlandırılmış seçenekleri 
kullanabilir. 

checkHealthAsync sistem durumu denetim mantığındaki: 

• datai ve data 2 , araştırmanın sistem durumu denetimi mantığını çalıştırmak için yönteminde 
kullanılır. 

• AccessViolationException işlenir. 

Bir AccessViolationException gerçekleştiğinde, kullanıcıların sistem durumu denetimleri hata durumunu 
yapılandırmasına izin veren HealthCheckResult ile FailureStatus döndürülür. 











using System; 

using System.Threading; 

using System.Threading.Tasks; 

using Microsoft.Extensions.Diagnostics.HealthChecks; 

namespace SampleApp 

{ 

public class ExampleHealthCheck : IHealthCheck 

{ 

private readonly string _datal; 
private readonly int? _data2; 

public ExampleHealthCheck(string datal, int? data2) 

{ 

_datal = datal ?? throw new ArgumentNullException(nameof(datal)); 

_data2 = data2 ?? throw new ArgumentNullException(nameof(data2)); 

} 

public async Task<HealthCheckResult> CheckHealthAsync( 

HealthCheckContext context, CancellationToken cancellationToken) 

{ 

try 

{ 

return HealthCheckResult.Healthy(); 

} 

catch (AccessViolationException ex) 

{ 

return new HealthCheckResult( 

context.Registration.FailureStatus, 

description: "An access violation occurred during the check.", 
exception: ex, 
data: null); 

} 

} 

} 

} 

2. Kullanan uygulamanın startup.configure yönteminde çağırdığı parametrelere sahip bir genişletme 
yöntemi yazın. Aşağıdaki örnekte, aşağıdaki sistem durumu denetim yöntemi imzasını varsayın: 

ExampleHealthCheck(string, string, int ) 

Yukarıdaki imza, ExampieHeaithCheck sistem durumu denetimi araştırma mantığını işlemek için ek veri 
gerektirdiğini gösterir. Veriler, sistem durumu denetimi bir genişletme yöntemiyle kaydedildiğinde sistem 
durumu denetim örneğini oluşturmak için kullanılan temsilciye sağlanır. Aşağıdaki örnekte, çağıran isteğe 
bağlı olarak şunları belirtir: 

• sistem durumu denetim adı ( name ). null , exampie_heaith_check kullanılır. 

• sistem durumu denetimi için dize veri noktası ( datal ). 

• sistem durumu denetimi için tamsayı veri noktası ( data 2 ). null , ı kullanılır. 

• hata durumu (HealthStatus). Varsayılan, null değeridir, null , bir hata durumu için HealthStatus. 
sağlıksız durum bildirilir. 

• Etiketler ( IEnumerable<string> ). 












using System.Collections.Generic; 

using Microsoft.Extensions.Diagnostics.HealthChecks; 

public static class ExampleHealthCheckBuilderExtensions 
{ 

const string DefaultName = "example_health_check"; 

public static IElealthChecksBuilder AddExampleHealthCheck( 
this IElealthChecksBuilder builder, 
string name = default, 
string datal, 
int data2 = 1, 

HealthStatus? failureStatus = default, 
IEnumerable<string> tags = default) 

{ 

return builder.Add(new HealthCheckRegistration( 
name ?? DefaultName, 

sp => new ExampleHealthCheck(datal, data2), 

failureStatus, 

tags)); 

} 

} 


Sistem durumu denetimi yayımcısı 

Hizmet kapsayıcısına bir IHealthCheckPublisher eklendiğinde, sistem durumu denetimi sistemi düzenli olarak 
sistem durumu kontrollerinizi yürütür ve sonuçla PubiishAsync çağırır. Bu, her bir işlemin sistem durumunu 
belirlemede düzenli aralıklarla izleme sistemini çağırmasını bekleyen, gönderim tabanlı bir sistem durumu izleme 
sistemi senaryosunda yararlıdır. 

IHealthCheckPublisher arabirimi tek bir yönteme sahiptir: 

Task PublishAsync(HealthReport report, CancellationToken cancellationToken); 

HealthCheckPublisherOptions şunları ayarlamanıza izin verir: 

• Delay, IHealthCheckPublisher örnekleri yürütülmeden önce uygulama başladıktan sonra uygulanan ilk 
gecikmeyi -. Gecikme başlangıçta bir kez uygulanır ve sonraki yinelemelere uygulanmaz. Varsayılan değer beş 
saniyedir. 

• IHealthCheckPublisher yürütme dönemi - Period. Varsayılan değer 30 saniyedir. 

• Predicate- Predicate nuiı (varsayılan), sistem durumu denetimi yayımcı hizmeti tüm kayıtlı sistem durumu 
denetimlerini çalıştırır. Bir sistem durumu denetimleri alt kümesini çalıştırmak için denetim kümesini 
filtreleyen bir işlev sağlayın. Koşul her dönem değerlendirilir. 

• Tüm IHealthCheckPublisher örnekleri için sistem durumu denetimlerinin yürütülmesi için zaman aşımını - 
Timeout. Zaman aşımı olmadan yürütmek için InfiniteTimeSpan kullanın. Varsayılan değer 30 saniyedir. 

Örnek uygulamada, ReadinessPubiisher bir IHealthCheckPublisher uygulamasıdır. Sistem durumu denetimi 
durumu her denetim için günlük düzeyinde günlüğe kaydedilir: 

• Durum denetim durumu Healthyise bilgi (Loglnformation). 

• Durum Degraded veya Unhealthyise hata (LogError). 








public class ReadinessPublisher : IHealthCheckPublisher 

{ 

private readonly ILogger _logger; 

public ReadinessPublisher(ILogger<ReadinessPublisher> logger) 

{ 

_logger = logger; 

} 

// The following example is for demonstration purposes only. Health Checks 
// Middleware already logs health checks results. A real-world readiness 
// check in a production app might perform a set of more expensive or 
// time-consuming checks to determine if other resources are responding 
// properly. 

public Task PublishAsync(HealthReport report, 

CancellationToken cancellationToken) 

{ 

if (report.Status == HealthStatus.Healthy) 

{ 

_logger.LogInformation("{Timestamp} Readiness Probe Status: {Result}", 

DateTime.UtcNow, report.Status); 

} 

else 

{ 

_logger.LogError("{Timestamp} Readiness Probe Status: {Result}", 

DateTime.UtcNow, report.Status); 

} 

cancellationToken.ThrowIfCancellationRequested(); 
return Task.CompletedTask; 

} 

} 

Örnek uygulamanın LivenessProbestartup örneğinde, startupHostedService hazırlık denetimi iki saniyelik bir 
başlangıç gecikmesine sahiptir ve denetimi her 30 saniyede bir çalıştırır. IHealthCheckPublisher uygulamasını 
etkinleştirmek için örnek, bağımlılık ekleme (dı) kapsayıcısında tek bir hizmet olarak ReadinessPublisher 
kaydeder: 

Services.AddHostedService<StartupHostedService>(); 

Services.AddSingleton<StartupHostedServiceHealthCheck>(); 

Services.AddHealthChecks() 

.AddCheck<StartupHostedServiceHealthCheck>( 

"hosted_service_startup ", 
failureStatus: HealthStatus.Degraded , 
tags: new[] { "ready" }); 

Services.Configure<HealthCheckPublisherOptions>(options => 

{ 

options.Delay = TimeSpan.FromSeconds(2); 

options.Predicate = (check) => check.Tags.Contains("ready"); 

}); 

Services.AddSingletoncIHealthCheckPublisher, ReadinessPublisher>(); 


NOTE 

Aspnetcore. Diagnostics. Healthdenetimleri , Application Insightsdahil olmak üzere çeşitli sistemler için yayımcılar içerir. 
Aspnetcore. Diagnostics. Healthdenetimleri Microsoft tarafından korunmaz veya desteklenmez. 








Durum denetimlerini Mapperne zaman kısıtla 

Durum denetimi uç noktalan için istek ardışık düzenini koşullu olarak dallandırmak için MapVVhen kullanın. 

Aşağıdaki örnekte, api/Healthcheck uç noktası için bir GET isteği alındığında durum denetimleri ara yazılımını 
etkinleştirmek üzere istek ardışık düzenini Mapuhen dallandırır: 

app.MapWhen( 

context => context.Request.Method == HttpMethod.Get.Method && 
context.Request.Path.StartsWith("/api/HealthCheck"), 
builder => builder.UseHealthChecks()); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapRazorPages(); 

}); 

Daha fazla bilgi için bkz. ASP.NET Core ara yazılımı. 

ASP.NET Core, uygulama altyapısı bileşenlerinin sistem durumunu raporlamak için sistem durumu denetimleri 
ve kitaplıkları sunar. 

Sistem durumu denetimleri, bir uygulama tarafından HTTP uç noktaları olarak gösterilir. Durum denetimi uç 
noktaları, çeşitli gerçek zamanlı izleme senaryoları için yapılandırılabilir: 

• Sistem durumu araştırmaları, kapsayıcı yöneticileri ve yük dengeleyiciler tarafından bir uygulamanın 
durumunu denetlemek için kullanılabilir. Örneğin, bir kapsayıcı Orchestrator, sıralı bir dağıtımı kaldırarak veya 
kapsayıcıyı yeniden başlatarak başarısız olan bir sistem durumu denetimine yanıt verebilir. Yük dengeleyici, 
trafiği başarısız olan örnekten sağlıklı bir örneğe yönlendirerek sağlıklı olmayan bir uygulamaya tepki 
verebilir. 

• Bellek, disk ve diğer fiziksel sunucu kaynaklarının kullanımı sağlıklı bir durum için izlenebilir. 

• Sistem durumu denetimleri, kullanılabilirliği ve normal çalışmayı onaylamak için bir uygulamanın 
veritabanları ve dış hizmet uç noktaları gibi bağımlılıklarını test edebilir. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Örnek uygulama, bu konuda açıklanan senaryoların örneklerini içerir. Örnek uygulamayı belirli bir senaryo için 
çalıştırmak için, bir komut kabuğunda projenin klasöründen DotNet Run komutunu kullanın. Örnek uygulamayı 
kullanma hakkında ayrıntılı bilgi için bu konudaki örnek uygulamanın README.MD dosyasına ve senaryo 
açıklamalarına bakın. 

Prerequisites 

Durum denetimleri, genellikle bir uygulamanın durumunu denetlemek için bir dış izleme hizmeti veya kapsayıcı 
Orchestrator ile birlikte kullanılır. Bir uygulamaya sistem durumu denetimleri eklemeden önce, hangi izleme 
sisteminin kullanılacağını belirleyin, izleme sistemi ne tür bir sistem durumu denetimi oluşturulacağını ve 
bunların uç noktalarını nasıl yapılandıracağınızı belirler. 

Microsoft, aspnetcore . app metapackage 'e başvurun veya Microsoft. Aspnetcore. Diagnostics. 
healthdenetimlerin paketine bir paket başvurusu ekleyin. 

Örnek uygulama, çeşitli senaryolar için sistem durumu denetimlerini göstermek üzere başlangıç kodu sağlar. 
Veritabanı araştırma senaryosu, Aspnetcore. Diagnostics. healthdenetimlerikullanarak bir veritabanı bağlantısının 
sistem durumunu denetler. DbContext araştırma senaryosu, bir EF Core DbContext kullanarak bir veritabanını 
denetler. Örnek uygulama olan veritabanı senaryolarını araştırmak için: 

• Bir veritabanı oluşturur ve bunun bağlantı dizesini appSettings. JSON dosyasında sağlar. 





• , Proje dosyasında aşağıdaki paket başvurularına sahiptir: 
o AspNetCore. Healthdenetimleri. SqlServer 

o Microsoft. Extensions. Diagnostics. Healthdenetimleri. EntityFramevvorkCore 


NOTE 

Aspnetcore. Diagnostics. Healthdenetimleri Microsoft tarafından korunmaz veya desteklenmez. 


Başka bir sistem durumu denetimi senaryosunda, sistem durumu denetimlerinin bir yönetim bağlantı noktasına 
nasıl filtreleneceği gösterilir. Örnek uygulama, Yönetim URL 'sini ve yönetim bağlantı noktasını içeren bir 
Özellikler/launchSettings. JSON dosyası oluşturmanızı gerektirir. Daha fazla bilgi için, bağlantı noktasına göre 
filtrele bölümüne bakın. 

Temel sistem durumu araştırması 

Birçok uygulama için, uygulamanın istekleri işleme için kullanılabilirliğini raporlayan temel bir durum araştırma 
yapılandırması, uygulamanın durumunu öğrenmekiçin yeterlidir. 

Temel yapılandırma, sistem durumu denetimi hizmetlerini kaydeder ve sistem durumu denetimleri ara yazılımını 
çağırarak bir URL uç noktasında bir sistem durumu yanıtı ile yanıt verir. Varsayılan olarak, belirli bir bağımlılığı 
veya alt sistemi test etmek için belirli bir sistem durumu denetimi kayıtlı değildir. Sistem durumu uç nokta URL 
'sinde yanıt veriyorsa, uygulama sağlıklı olarak değerlendirilir. Varsayılan yanıt yazıcı, durumu (HealthStatus) 
istemciye geri düz metin yanıtı olarak yazar . sağlıklıdurum, sistem sağlığı durumu . düşürülmüş veya 
HealthStatus. sağlıksız durum. 

Sistem durumu denetimi hizmetlerini startup.configureServices AddHealthChecks ile kaydedin, 
startup.configure istek işleme ardışık düzeninde UseHealthChecks olan sistem durumu denetimleri ara yazılımı 
için bir uç nokta ekleyin. 

Örnek uygulamada, durum denetimi uç noktası /health oluşturulur [BasicStartup.es ): 

public elass BasicStartup 
{ 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddHealthChecks(); 

} 

public void Configure(IApplicationBuilder app) 

{ 

app.UseHealthChecks("/health"); 

} 

} 

Örnek uygulamayı kullanarak temel yapılandırma senaryosunu çalıştırmak için, komut kabuğunda projenin 
klasöründen aşağıdaki komutu yürütün: 

dotnet run --scenario basic 

Docker örneği 

Docker , temel sistem durumu denetimi yapılandırmasını kullanan bir uygulamanın durumunu denetlemek için 
kullanılabilen yerleşik bir healthcheck yönergesi sunar: 










HEALTHCHECK CMD curl --fail http://localhost:5000/health || exit 


Durum denetimleri oluşturma 

Durum denetimleri IHealthCheck arabirimi uygulayarak oluşturulur. CheckHealthAsync yöntemi, sistem 
durumunu Healthy , Degraded veya unhealthy olarak belirten bir HealthCheckResult döndürür. Sonuç 
yapılandırılabilir bir durum kodu ile düz metin yanıtı olarak yazılır (yapılandırma, sistem durumu denetimi 
seçenekleri bölümünde açıklanmıştır). HealthCheckResult, isteğe bağlı anahtar-değer çiftleri de döndürebilir. 

Örnek sistem durumu denetimi 

Aşağıdaki ExampieHeaithCheck sınıfı, bir sistem durumu denetiminin yerleşimini gösterir. Durum denetimleri 
mantığı CheckHealthAsync yöntemine yerleştirilir. Aşağıdaki örnek, true için healthCheckResuitHealthy bir kukla 
değişken ayarlar. healthCheckResuitHealthy değeri faise olarak ayarlanırsa Healthcheckresult. sağlıksız durum 
döndürülür. 

public class ExampleHealthCheck : IHealthCheck 
{ 

public Task<HealthCheckResult> CheckHealthAsync( 

HealthCheckContext context, 

CancellationToken cancellationToken = default(CancellationToken)) 

{ 

var healthCheckResuitHealthy = true; 

if (healthCheckResuitHealthy) 

{ 

return Task.FromResult( 

HealthCheckResult.Healthy("The check indicates a healthy result.")); 

} 

return Task.FromResult( 

HealthCheckResult.UnhealthyC'The check indicates an unhealthy result.")); 

} 

} 


Sistem durumu denetimi hizmetlerini Kaydet 

ExampieHeaithCheck türü AddCheckile startup.configureServices sistem durumu denetimi hizmetlerine eklenir: 

Services.AddHealthChecks() 

.AddCheck<ExampleHealthCheck>("example_health_check"); 


Aşağıdaki örnekte gösterilen AddCheck aşırı yüklemesi, sistem durumu denetimi bir hata bildirdiğinde hata 
durumunu (HealthStatus) ayarlar. Hata durumu nuiı (varsayılan) olarak ayarlandıysa, HealthStatus. sağlıksız 
olarak bildirilir. Bu aşırı yükleme, kitaplık yazarları için yararlı bir senaryodur, burada, sistem durumu denetimi 
uygulaması ayarı varsa, bir sistem durumu denetimi hatası oluştuğunda, kitaplık tarafından belirtilen başarısızlık 
durumu uygulama tarafından zorlanır. 

Etiketler , sistem durumu denetimlerini filtrelemek için kullanılabilir ( durum denetimleri filtreleme bölümünde 
daha ayrıntılı olarak açıklanmıştır). 

Services.AddHealthChecks() 

.AddCheck<ExampleHealthCheck>( 

"example_health_check ", 
failureStatus: HealthStatus.Degraded , 
tags: new[] { "example" }); 
















AddCheck bir Lambda işlevi de yürütebilir.Aşağıdaki startup.configureServices örnekte, sistem durumu 
denetim adı Exampie olarak belirtilir ve denetim her zaman sağlıklı bir durum döndürür: 

Services.AddHealthChecks() 

.AddCheck("Example"j () => 

HealthCheckResıılt.Healthy("Example is OKI"), tags: new[] { "example" }); 


Sistem durumu denetimleri ara yazılımı kullan 

startup.configure , işlem hattının uç nokta URL 'SI veya göreli yolu ile UseHealthChecks çağırın: 

app.UseHealthChecks("/health"); 


Durum denetimlerinin belirli bir bağlantı noktasını dinlemesi gerekiyorsa, bağlantı noktasını ayarlamak için 
UseHealthChecks aşırı yüklemesini kullanın ( bağlantı noktasına göre filtrele bölümünde anlatılmıştır): 

app.UseHealthChecks("/health", port: 8000); 


Sistem durumu denetimi seçenekleri 

HealthCheckOptions sistem durumu denetimi davranışını özelleştirmek için bir fırsat sağlayın: 

• Durum denetimlerini filtrele 

• HTTP durum kodunu özelleştirme 

• Önbellek üstbilgiierini gösterme 

• Çıktıyı özelleştirme 

Durum denetimlerini filtrele 

Varsayılan olarak, sistem durumu denetimleri ara yazılımı tüm kayıtlı sistem durumu denetimlerini çalıştırır. Bir 
sistem durumu denetimleri alt kümesini çalıştırmak için Predicate seçeneğine Boole değeri döndüren bir işlev 
sağlayın. Aşağıdaki örnekte, Bar sistem durumu denetimi, işlevin koşullu deyimindeki etiketiyle ( bar_tag ) 
filtrelenerek true yalnızca sistem durumu denetiminin Tags özelliği foo_tag veya baz_tag eşleşiyorsa 
döndürülür: 











using System.Threading.Tasks; 

using Microsoft.AspNetCore.Diagnostics.HealthChecks; 
using Microsoft.Extensions.Diagnostics.HealthChecks; 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddHealthChecks() 

.AddCheck("Foo", () => 

HealthCheckResult.Healthy("Foo is OK!"), tags: new[] { "foo_tag" }) 
.AddCheck("Bar", () => 

HealthCheckResult.UnhealthyC'Bar is unhealthy!"), 
tags: new[] { "bar_tag" }) 

.AddCheck("Baz", () => 

HealthCheckResult.Healthy("Baz is OK!"), tags: new[] { "baz_tag" }); 

} 

public void Configure(IApplicationBuilder app) 

{ 

app.UseHealthChecks("/health", new HealthCheckOptions() 

{ 

Predicate = (check) => check.Tags.Contains("foo_tag") | 
check.Tags.Contains("baz_tag") 

}); 

} 


HTTP durum kodunu özelleştirme 

Sistem durumunun HTTP durum kodlarına eşlenmesini özelleştirmek için ResultStatusCodes kullanın. Aşağıdaki 
StatusCodes atamaları, ara yazılım tarafından kullanılan varsayılan değerlerdir. Durum kodu değerlerini 
gereksinimlerinize uyacak şekilde değiştirin. 


Startup.Configure : 

//using Microsoft.AspNetCore.Diagnostics.HealthChecks; 

//using Microsoft.Extensions.Diagnostics.HealthChecks; 

app.UseHealthChecks("/health", new HealthCheckOptions() 

{ 

ResultStatusCodes = 

{ 

[HealthStatus.Healthy] = StatusCodes.Status200OK, 
[HealthStatus.Degraded] = StatusCodes.Status200OK, 

[HealthStatus.Unhealthy] = StatusCodes.Status503ServiceUnavailable 

} 

}); 


Önbellek üstbilgilerini gösterme 

AllovvCachingResponses, yanıt önbelleğini engellemek için sistem durumu denetimlerinin ara yazılım tarafından 
araştırma yanıtına HTTP üstbilgileri ekleyip eklemediğini denetler. Değer faise (varsayılan) ise, ara yazılım, yanıt 
önbelleğe almayı engellemek için Cache-Control , Expires ve Pragma üst bilgilerini ayarlar veya geçersiz kılar. 
Değer true ise, ara yazılım yanıtın önbellek üstbilgilerini değiştirmez. 

Startup.Configure : 








//using Microsoft.AspNetCore.Diagnostics.HealthChecks; 
//using Microsoft.Extensions.Diagnostics.HealthChecks; 

app.UseHealthChecks("/health", new HealthCheckOptions() 

{ 

AllowCachingResponses = false 

}); 


Çıktıyı özelleştirme 

ResponseWriter seçeneği, yanıtı yazmak için kullanılan bir temsilciyi alır veya ayarlar. Varsayılan temsilci, 
HealthReport. Statusdize değerine sahip en az bir düz metin yanıtı yazar. 


Startup.Configure : 

// using Microsoft.AspNetCore.Diagnostics.HealthChecks; 
// using Microsoft. Extensions .Diagnostics .HealthChecks; 

app.UseHealthChecks("/health"j new HealthCheckOptions() 

{ 

ResponseWriter = WriteResponse 

}); 


Varsayılan temsilci, HealthReport. Statusdize değerine sahip en az bir düz metin yanıtı yazar. Aşağıdaki özel 
temsilci, NriteResponse özel bir JSON yanıtı verir: 

private static Task WriteResponse(HttpContext httpContext, HealthReport result) 

{ 

httpContext.Response.ContentType = "application/json"; 
var json = new JObject( 

new DPropertyC’status ", result.Status.ToStringO), 
new lProperty("results"j new 30bject(result.Entries.Select(pair => 
new DProperty(pair.Key, new 10bject( 

new DProperty("status"j pair.Value.Status.ToStringO), 
new lProperty("description", pair.Value.Description ), 
new lProperty("data ", new 10bject(pair.Value.Data.Select( 
p => new 3Property(p.Key, p.Value)))))))))); 
return httpContext.Response.WriteAsync( 
json.ToString(Formatting.Indented)); 

} 


Durum denetimleri sistemi, karmaşık JSON dönüş biçimleri için yerleşik destek sağlamaz çünkü biçim, sizin 
tercih ettiğiniz izleme sistemine özgüdür. Gereksinimlerinizi karşılamak için gereken önceki örnekteki lObject 
özelleştirebilirsiniz. 

Veritabanı araştırması 

Bir sistem durumu denetimi, veritabanının normal olarak yanıt verip vermediğini göstermek üzere Boole testi 
olarak çalışacak bir veritabanı sorgusu belirtebilir. 

Örnek uygulama, SQL Server veritabanında bir sistem durumu denetimi gerçekleştirmek için ASP.NET Core 
uygulamalar için bir sistem durumu denetim kitaplığı olan Aspnetcore. Diagnostics. healthcheckkullanır. 
AspNetCore.Diagnostics.HealthChecks veritabanı bağlantısının sağlıklı olduğundan emin olmak için veritabanında 
select ı bir sorgu yürütür. 







VVARNING 

Bir sorgu ile bir veritabanı bağlantısı denetlerken, hızlı bir şekilde dönen bir sorgu seçin. Sorgu yaklaşımı, veritabanını aşırı 
yükleme ve performansını düşürmeye yönelik riski çalıştırır. Çoğu durumda, test sorgusunun çalıştırılması gerekli değildir. 
Yalnızca veritabanına başarılı bir bağlantı oluşturmak yeterlidir. Bir sorgu çalıştırmak için gerekli olduğunu fark ederseniz, 
select ı gibi basit bir seçme sorgusu seçin. 


Aspnetcore. Healthdenetimlerin. SqlServeröğesine bir paket başvurusu ekleyin. 

Örnek uygulamanın appSettings. JSON dosyasında geçerli bir veritabanı bağlantı dizesi sağlayın. Uygulama, 
HealthcheckSample adında bir SQL Server veritabanı kullanır: 

{ 

"ConnectionStrings": { 

"DefaultConnection": "Server= 

(localdb)\\MSSQLLocalDB;Database=HealthCheckSample;Trusted_Connection=True;MııltipleActiveResultSets=truejConn 

ectRetryCount=0" 

b 

"Logging": { 

"LogLevel": { 

"Default": "Debug" 

b 

"Console": { 

"IncludeScopes": "true" 

} 

} 

} 

Sistem durumu denetimi hizmetlerini startup.configureServices AddHealthChecks ile kaydedin. Örnek 
uygulama, veritabanının bağlantı dizesiyle Addsqiserver yöntemini çağırır ( DbHealthStartup.es ): 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddHealthChecks() 

.AddSqlServer(Configuration["ConnectionStrings:DefaultConnection"]); 

} 

Uygulama işleme işlem hattının startup.configure içindeki sistem durumu denetimleri ara yazılımını çağır: 

app.UseHealthChecks("/health"); 


Örnek uygulamayı kullanarak veritabanı araştırma senaryosunu çalıştırmak için, bir komut kabuğunda projenin 
klasöründen aşağıdaki komutu yürütün: 



DbContext araştırması Entity Framevvork Core 

DbContext denetimi, uygulamanın bir EF Core DbContext için yapılandırılmış veritabanıyla iletişim kurabildiğini 
onaylar. DbContext denetimi şu uygulamalar için desteklenir: 













• Entity Framevvork (EF) Corekullanın. 

• Microsoft. Extensions. Diagnostics. Healthdenetimleri. EntityFramevvorkCore'a bir paket başvurusu ekleyin. 


AddDbContextCheck<TContext> 

bir 

DbContext sistem durumu denetimi kaydeder. 

DbContext , metoduna 

TContext 


olarak sağlanır. Hata durumu, Etiketler ve özel bir test sorgusunu yapılandırmak için aşırı yükleme kullanılabilir. 
Varsayılan olarak: 

• DbContextHeaithCheck EF Core canConnectAsync yöntemini çağırır. AddDbContextched< yöntemi aşırı yüklerini 
kullanarak sistem durumunu denetlerken hangi işlemin çalıştırılacağını özelleştirebilirsiniz. 

• Sistem durumu denetiminin adı TContext türünün adıdır. 

Örnek uygulamada, AppDbContext AddDbContextCheck ve hizmet olarak Startup.ConfigureServices 
( DbContextHealthStartup.cs ) olarak kaydedilir. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddHealthChecks() 

.AddDbContextCheck<AppDbContext>(); 

Services.AddDbContext<AppDbContext>(options => 

{ 

options.UseSqlServer( 

Configuration["ConnectionStrings:DefaultConnection"]); 

}); 

} 

Örnek uygulamada, useHealthChecks sistem durumu denetimleri ara yazılımını startup.configure ekler. 
app.UseHealthChecks("/health"); 

Örnek uygulamayı kullanarak DbContext araştırma senaryosunu çalıştırmak için, bağlantı dizesi tarafından 
belirtilen veritabanının SÖL Server örneğinde mevcut olmadığından emin olun. Veritabanı varsa, silin. 

Komut kabuğunda projenin klasöründen aşağıdaki komutu yürütün: 

dotnet run --scenario dbcontext 

Uygulama çalıştırıldıktan sonra, bir tarayıcıda /health uç noktasına bir istek yaparak sistem durumunu 
denetleyin. Veritabanı ve AppDbContext olmadığından, uygulama aşağıdaki yanıtı sağlar: 

Unhealthy 

Veritabanını oluşturmak için örnek uygulamayı tetikleyin. /createdatabase için bir istek oluşturun. Uygulama 
yanıt veriyor: 

Creating the database... 

Done! 

Navigate to /health to see the health status. 

/health uç noktasına bir istek oluşturun. Veritabanı ve bağlam var, bu nedenle uygulama yanıt veriyor: 

Healthy 























Veritabanını silmek için örnek uygulamayı tetikleyin. /deletedatabase için bir istek oluşturun. Uygulama yanıt 
veriyor: 


Deleting the database... 

Done! 

Navigate to /health to see the health status. 


/health uç noktasına bir istek oluşturun. Uygulama sağlıksız bir yanıt sağlar: 

Unhealthy 


Ayrı hazırlık ve lizlilik araştırmaları 

Bazı barındırma senaryolarında iki uygulama durumunu ayırt eden bir çift sistem durumu denetimi kullanılır: 

• Uygulama çalışıyor ancak henüz istekleri almaya hazırlanma. Bu durum, uygulamanın hazır o/modurumu. 

• Uygulama çalışır ve isteklere yanıt verir. Bu durum, uygulamanın kullanım koşu Har majöre yapılır. 

Hazırlık denetimi genellikle uygulamanın tüm alt sistemlerinin ve kaynaklarının kullanılabilir olup olmadığını 
belirlemede daha kapsamlı ve zaman alıcı denetim kümesi gerçekleştirir. Bir onay işareti yalnızca uygulamanın 
istekleri işlemek için kullanılabilir olup olmadığını belirlemede hızlı bir denetim gerçekleştirir. Uygulama, hazırlık 
denetimini geçirdikten sonra, yüksek hazırlık denetimleri kümesi ile uygulamayı daha fazla yüklemeye gerek 
yoktur—daha fazla denetim için yalnızca lileme denetimi gerektirir. 

Örnek uygulama, barındırılan bir hizmetteuzun süre çalışan başlatma görevinin tamamlandığını raporlamak için 
bir sistem durumu denetimi içerir. startupHostedServiceHealthCheck , barındırılan hizmetin uzun süre çalışan 
görevi bittiğinde true olarak ayarlayabilmesini startupTaskCompleted bir özelliği kullanıma sunar 
( StartupHostedServiceHealthCheck.es ): 

public elass StartupHostedServiceHealthCheck : IHealthCheck 
{ 

private volatile bool _startupTaskCompleted = false; 

public string Name => "slow_dependency_check"; 

public bool StartupTaskCompleted 
{ 

get => _startupTaskCompleted; 

set => _startupTaskCompleted = value; 

} 

public Task<HealthCheckResult> CheckHealthAsync( 

HealthCheckContext context, 

CancellationToken cancellationToken = default(CancellationToken)) 

{ 

if (StartupTaskCompleted) 

{ 

return Task.FromResult( 

HealthCheckResult.Healthy("The startup task is finished.")); 

} 

return Task.FromResult( 

HealthCheckResult.Unhealthy("The startup task is stili running.")); 

} 

} 

Uzun süre çalışan arka plan görevi bir barındırılan hizmet ( Hizmetler/startuphostedservice ) tarafından başlatılır. 
Görevin sonunda, StartupHostedServiceHealthCheck.StartupTaskCompleted true olarak ayarlanır: 








public class StartupHostedService : IHostedService, IDisposable 

{ 

private readonly int _delaySeconds = 15; 
private readonly ILogger _logger; 

private readonly StartupHostedServiceHealthCheck _startupHostedServiceHealthCheck; 

public StartupHostedService(ILogger<StartupHostedService> logger, 

StartupHostedServiceHealthCheck startupHostedServiceHealthCheck) 

{ 

_logger = logger; 

_startupHostedServiceHealthCheck = startupHostedServiceHealthCheck; 

} 

public Task StartAsync(CancellationToken cancellationToken) 

{ 

_logger.LogInformation("Startup Background Service is starting."); 

// Simulate the effect of a long-running startup task. 

Task.Run(async () => 

{ 

await Task.Delay(_delaySeconds * 1000); 

_startupHostedServiceHealthCheck.StartupTaskCompleted = true; 

_logger.LogInformation("Startup Background Service has started."); 

}); 

return Task.CompletedTask; 

} 

public Task StopAsync(CancellationToken cancellationToken) 

{ 

_logger.LogInformation("Startup Background Service is stopping."); 
return Task.CompletedTask; 

} 

public void Dispose() 

{ 

} 

} 

Sistem durumu denetimi, barındırılan hizmetle birlikte startup. configureServices AddCheck kaydedilir. 
Barındırılan hizmetin, sistem durumu denetiminde özelliği ayarlaması gerektiğinden, sistem durumu denetimi de 
hizmet kapsayıcısına kaydedilir ( LivenessProbeStartup.es ): 



public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddHostedService<StartupHostedService>(); 

Services.AddSingleton<StartupHostedServiceHealthCheck>(); 

Services.AddHealthChecks() 

.AddCheck<StartupHostedServiceHealthCheck>( 

"hosted_service_startup ", 
failureStatus: HealthStatus.Degraded, 
tags: new[] { "ready" }); 

Services.Configure<HealthCheckPublisherOptions>(options => 

{ 

options.Delay = TimeSpan.FromSeconds(2 ); 

options.Predicate = (check) => check.Tags.Contains("ready"); 

}); 

// The following workaround permits adding an IHealthCheckPublisher 
// instance to the service Container when one or more other hosted 
// Services have already been added to the app. This workaround 
// won't be required with the release of ASP.NET Core 3.0. For more 
// information, see: https://github.com/aspnet/Extensions/issues/639. 

Services.TryAddEnumerable( 

ServiceDescriptor .Singleton(typeof (IFlostedService ), 
typeof(HealthCheckPublisherOptions).Assembly 
.GetType(HealthCheckServiceAssembly))); 

Services.AddSingletoncIHealthCheckPublisher, ReadinessPublisher>(); 

} 

startup.configure 'de uygulama işleme ardışık düzeninde sistem durumu denetimleri ara yazılımı. Örnek 
uygulamada, sistem durumu denetimi uç noktaları, hazır olma denetimi için /health/ready oluşturulur ve libir 
denetim için /health/live . Hazırlık denetimi, durum denetimini ready etiketiyle durum denetimi olarak 
denetler. Libu denetim, Healthcheckoptions. koşula faise döndürerek startupHostedServiceHealthCheck filtreler 
(daha fazla bilgi için bkz. durum denetimlerini filtrele): 

app.UseHealthChecks("/health/ready", new HealthCheckOptions() 

{ 

Predicate = (check) => check.Tags.Contains("ready"), 

}); 

app.UseHealthChecks("/health/live ", new HealthCheckOptions() 

{ 

Predicate = (_) => faise 

}); 

Örnek uygulamayı kullanarak hazırlık/lizlilik yapılandırma senaryosunu çalıştırmak için, aşağıdaki komutu 
projenin klasöründen bir komut kabuğu 'ndan yürütün: 

dotnet run --scenario liveness 

Bir tarayıcıda, 15 saniye geçtikten sonra /health/ready birkaç kez ziyaret edin. Sistem durumu denetimi ilk 15 
saniye boyunca sağlıksız durum bildiriyor. 15 saniye sonra, uç nokta, barındırılan hizmet tarafından uzun süre 
çalışan görevin tamamlandığını yansıtan sağlıklışe kilde raporlar. 

Bu örnek ayrıca, iki saniyelik bir gecikmeyle ilk hazırlık denetimini çalıştıran bir sistem durumu denetimi 
yayımcısı (IHealthCheckPublisher uygulaması) oluşturur.Daha fazla bilgi için bkz. sistem durumu denetimi 
yayımcısı bölümü. 


Kubernetes örneği 











Ayrı hazır olma ve Ezlilik denetimleri kullanmak, Kubernetesgibi bir ortamda yararlıdır. Kubernetes 'te, temel 
veritabanı kullanılabilirliğinin bir testi gibi istekleri kabul etmeden önce, zaman alan Başlangıç işlerini 
gerçekleştirmek için bir uygulamanın olması gerekebilir. Ayrı denetimlerin kullanılması, Orchestrator 1 1 n 
uygulamanın çalışıp çalışmadığını, ancak henüz hazırlanmadığını ya da uygulamanın başlayamadığını ayırt 
etmesine olanak tanır. Kubernetes 'te hazır olma ve Elanma araştırmaları hakkında daha fazla bilgi için bkz. 
Kubernetes belgelerindeki limize ve hazırlık araştırmalarını yapılandırma . 

Aşağıdaki örnekte bir Kubernetes Readiness araştırma yapılandırması gösterilmektedir: 

spec: 

template: 
spec: 

readinessProbe: 

# an http probe 
httpGet: 

path: /health/ready 
port: 80 

# length of time to wait for a pod to initialize 

# after pod startup, before applying health checking 
initialDelaySeconds: 30 

timeoutSeconds: 1 
ports: 

- containerPort: 80 


Özel bir yanıt yazıcı ile ölçüm tabanlı araştırma 

Örnek uygulama, özel bir yanıt yazıcısı ile bir bellek durumu denetimini gösterir. 

uygulama, belirli bir bellek eşiğini (örnek uygulamada 1 GB) kullanıyorsa, sağlıksız bir durumu raporlar 
MemoryHealthcheck . HealthCheckResult, uygulama için çöp toplayıcı (GC) bilgilerini içerir 
( MemoryHealthCheck.es ): 




public class MemoryHealthCheck : IHealthCheck 

{ 

private readonly IOptionsMonitor<MemoryCheckOptions> _options; 

public MemoryHealthCheck(IOptionsMonitor<MemoryCheckOptions> options) 

{ 

_options = options; 

} 

public string Name => "memory_check"; 

public Task<HealthCheckResult> CheckHealthAsync( 

HealthCheckContext contextj 

CancellationToken cancellationToken = default(CancellationToken)) 

{ 

var options = _options.Get(context.Registration.Name); 

// Include GC information in the reported diagnostics. 

var allocated = GC.GetTotalMemory(forceFullCollection: false); 

var data = new Dictionarycstring, object>() 

{ 

{ "AllocatedBytes ", allocated }, 

{ "GenGCollections", GC.CollectionCount(0) }, 

{ "GenlCollections"j GC.CollectionCount(l) }, 

{ "Gen2Collections"j GC.CollectionCount(2) }, 

}; 

var status = (allocated < options.Threshold) ? 

HealthStatus.Healthy : HealthStatus.Unhealthy; 

return Task.FromResult(new HealthCheckResult( 
status, 

description: "Reports degraded status if allocated bytes " + 

$">= {options.Threshold} bytes .", 
exception: nullj 
data: data)); 

} 

} 

Sistem durumu denetimi hizmetlerini startup.configureServices AddHealthChecks ile kaydedin. Durum 
denetimini AddCheckgeçirerek etkinleştirmek yerine, MemoryHealthCheck bir hizmet olarak kaydedilir. Tüm kayıtlı 
IHealthCheck Hizmetleri sistem durumu denetimi Hizmetleri ve ara yazılım tarafından kullanılabilir.Sistem 
durumu denetimi hizmetlerini tek hizmet olarak kaydetmeyi öneririz. 

Örnek uygulamada ( CustomWriterStartup.cs ): 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddHealthChecks() 

.AddMemoryHealthCheck("memory"); 

} 

startup.configure 'de uygulama işleme ardışık düzeninde sistem durumu denetimleri ara yazılımı. Bir 
writeResponse temsilcisi, sistem durumu denetimi yürütüldüğünde özel bir JSON yanıtının çıkışı için 
Responsewriter özelliğine sağlanır: 





public void Configure(IApplicationBuilder app., IHostingEnvironment env) 

{ 

app.UseHealthChecks("/health", new HealthCheckOptions() 

{ 

// This custom writer formats the detailed status as 3S0N. 

Responsel/Jriter = WriteResponse 

}); 

} 

writeResponse yöntemi bir JSON nesnesine compositeHealthCheckResuit biçimlendirir ve sistem durumu 
denetimi yanıtı için JSON çıktısı verir: 

private static Task WriteResponse(HttpContext httpContext, 

HealthReport result) 

{ 

httpContext.Response.ContentType = "application/json"; 
var json = new JObject( 

new DProperty("status ", result.Status.ToStringO), 
new DProperty("results"j new 10bject(result.Entrles.Select(pair => 
new DPropertytpair.Key, new DObject( 

new lProperty("status ", palr.Value.Status.ToStringO), 
new DProperty("description", pair.Value.Descriptlon ), 
new DProperty("data ", new DObject(palr.Value.Data.Select( 
p => new 3Property(p.Keyj p.Value)))))))))); 
return httpContext.Response.WriteAsync( 
json.ToString(Formatting.Indented)); 

} 


Örnek uygulamayı kullanarak özel yanıt yazıcı çıkışıyla ölçüm tabanlı araştırmayı çalıştırmak için, komut kabuğu 
'ndaki projenin klasöründen aşağıdaki komutu yürütün: 



Bağlantı noktasına göre filtrele 

UseHealthChecks bir bağlantı noktası ile çağırmak, belirtilen bağlantı noktasına durum denetimi isteklerini 
kısıtlar. Bu genellikle bir kapsayıcı ortamında, izleme hizmetleri için bir bağlantı noktası oluşturmak için kullanılır. 

Örnek uygulama, ortam değişkeni yapılandırma sağlayıcısınıkullanarak bağlantı noktasını yapılandırır. Bağlantı 
noktası, Launchsettings. JSON dosyasında ayarlanır ve bir ortam değişkeni aracılığıyla yapılandırma sağlayıcısına 
geçirilir. Ayrıca, sunucuyu Yönetim bağlantı noktasındaki istekleri dinleyecek şekilde yapılandırmanız gerekir. 

Yönetim bağlantı noktası yapılandırmasını göstermek üzere örnek uygulamayı kullanmak için, bir Özellikler 
klasöründe launchsettings. JSON dosyasını oluşturun. 

Örnek uygulamadaki aşağıdaki Özellikler/launchSettings. JSON dosyası, örnek uygulamanın proje dosyalarına 
dahil değildir ve el ile oluşturulması gerekir: 







{ 

"profiles": { 

"SampleApp": { 

"commandName": "Project", 

"commandLineArgs": 

"launchBrowser": true, 

"environmentVariables": { 

"ASPNETCORE_ENVIRONMENT": "Development", 

"ASPNETCORE_URLS": "http://localhost:5000/;http://localhost:5001/", 
"ASPNETCORE_MANAGEMENTPORT" : "5001" 

}, 

"applicationllrl": "http://localhost:5000/" 

} 

} 

} 

Sistem durumu denetimi hizmetlerini startup.configureServices AddHealthChecks ile kaydedin. 
UseHealthChecks çağrısı, yönetim bağlantı noktasını belirtir ( ManagementPortStartup.es ): 

public elass ManagementPortStartup 

{ 

public ManagementPortStartup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddHealthChecks(); 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

app.UseHealthChecks("/health", port: Configuration["ManagementPort"]); 

app.Run(async (context) => 

{ 

await context.Response.WriteAsync( 

"Navigate to " + 

$"http://localhost:{Configuration["ManagementPort"]}/health " + 

"to see the health status."); 

}); 

} 

} 




NOTE 

Kod içinde açıkça URL 'Leri ve yönetim bağlantı noktasını ayarlayarak Lounchsettings. JSON dosyasını örnek uygulamada 
oluşturmaktan kaçınabilirsiniz. VVebHostBuilder oluşturulduğu progrom.es içinde, UseUrls için bir çağrı ekleyin ve 
uygulamanın normal yanıt uç noktasını ve yönetim bağlantı noktası uç noktasını sağlayın. UseHealthChecks çağrıldığında, 
yönetim bağlantı noktasını açıkça belirtin. 

Progrom.es : 

return new WebHostBuilder() 

.UseConfiguration(config) 

.UseUrls("http://localhost:5000/;http://localhost:5001/") 

.ConfigureLogging(builder => 

{ 

builder. SetMinimumLevel(Logl_evel .Trace); 
buiİder.AddConfiguration(config); 
builder.AddConsole(); 

}) 

.UseKestrel() 

.UseStartup(startupType) 

.Build(); 

MonogementPortStortup.es: 

app.UseHealthChecksC'/health", port: 5001); 


Yönetim bağlantı noktası yapılandırma senaryosunu örnek uygulamayı kullanarak çalıştırmak için, aşağıdaki 
komutu projenin klasöründen bir komut kabuğu 'ndan yürütün: 

dotnet run --scenario port 


Bir sistem durumu denetim kitaplığı dağıtma 

Bir sistem durumu denetimini kitaplık olarak dağıtmak için: 

1. IHealthCheck arabirimini tek başına bir sınıf olarak uygulayan bir sistem durumu denetimi yazın. Sınıf, 
yapılandırma verilerine erişmek için bağımlılık ekleme (dı), tür etkinleştirme ve adlandırılmış seçenekleri 
kullanabilir. 

checkHealthAsync sistem durumu denetim mantığındaki: 

• datai ve data 2 , araştırmanın sistem durumu denetimi mantığını çalıştırmak için yönteminde 
kullanılır. 

• AccessViolationException işlenir. 

Bir AccessViolationException gerçekleştiğinde, kullanıcıların sistem durumu denetimleri hata durumunu 
yapılandırmasına izin veren HealthCheckResult ile FailureStatus döndürülür. 










using System; 

using System.Threading; 

using System.Threading.Tasks; 

using Microsoft.Extensions.Diagnostics.HealthChecks; 

public class ExampleHealthCheck : IHealthCheck 

{ 

private readonly string _datal; 
private readonly int? _data2; 

public ExampleHealthCheck(string datal, int? data2) 

{ 

_datal = datal ?? throw new ArgumentNullException(nameof(datal)); 

_data2 = data2 ?? throw new ArgumentNullException(nameof(data2)); 

} 

public async Task<HealthCheckResult> CheckHealthAsync( 

HealthCheckContext context, CancellationToken cancellationToken) 

{ 

try 

{ 

return HealthCheckResult.HealthyO; 

} 

catch (AccessViolationException ex) 

{ 

return new HealthCheckResult( 

context.Registration.FailureStatus, 

description: "An access violation occurred during the check.", 
exception: ex, 
data: null); 

} 

} 

} 

2. Kullanan uygulamanın startup.configure yönteminde çağırdığı parametrelere sahip bir genişletme 
yöntemi yazın. Aşağıdaki örnekte, aşağıdaki sistem durumu denetim yöntemi imzasını varsayın: 

ExampleHealthCheck(string, string, int ) 

Yukarıdaki imza, ExampieHeaithCheck sistem durumu denetimi araştırma mantığını işlemek için ek veri 
gerektirdiğini gösterir. Veriler, sistem durumu denetimi bir genişletme yöntemiyle kaydedildiğinde sistem 
durumu denetim örneğini oluşturmak için kullanılan temsilciye sağlanır. Aşağıdaki örnekte, çağıran isteğe 
bağlı olarak şunları belirtir: 

• sistem durumu denetim adı ( name ). null , exampie_heaith_check kullanılır. 

• sistem durumu denetimi için dize veri noktası ( datal ). 

• sistem durumu denetimi için tamsayı veri noktası ( data 2 ). null , ı kullanılır. 

• hata durumu (HealthStatus). Varsayılan, null değeridir, null , bir hata durumu için HealthStatus. 
sağlıksız durum bildirilir. 

• Etiketler ( IEnumerable<string> ). 











using System.Collections.Generic; 

using Microsoft.Extensions.Diagnostics.HealthChecks; 

public static class ExampleHealthCheckBuilderExtensions 
{ 

const string DefaultName = "example_health_check"; 

public static IElealthChecksBuilder AddExampleHealthCheck( 
this IElealthChecksBuilder builder, 
string name = default, 
string datal, 
int data2 = 1, 

HealthStatus? failureStatus = default, 
IEnumerable<string> tags = default) 

{ 

return builder.Add(new HealthCheckRegistration( 
name ?? DefaultName, 

sp => new ExampleHealthCheck(datal, data2), 

failureStatus, 

tags)); 

} 

} 


Sistem durumu denetimi yayımcısı 

Hizmet kapsayıcısına bir IHealthCheckPublisher eklendiğinde, sistem durumu denetimi sistemi düzenli olarak 
sistem durumu kontrollerinizi yürütür ve sonuçla PubiishAsync çağırır. Bu, her bir işlemin sistem durumunu 
belirlemede düzenli aralıklarla izleme sistemini çağırmasını bekleyen, gönderim tabanlı bir sistem durumu izleme 
sistemi senaryosunda yararlıdır. 

IHealthCheckPublisher arabirimi tek bir yönteme sahiptir: 

Task PublishAsync(HealthReport report, CancellationToken cancellationToken); 

HealthCheckPublisherOptions şunları ayarlamanıza izin verir: 

• Delay, IHealthCheckPublisher örnekleri yürütülmeden önce uygulama başladıktan sonra uygulanan ilk 
gecikmeyi -. Gecikme başlangıçta bir kez uygulanır ve sonraki yinelemelere uygulanmaz. Varsayılan değer beş 
saniyedir. 

• IHealthCheckPublisher yürütme dönemi - Period. Varsayılan değer 30 saniyedir. 

• Predicate- Predicate nuiı (varsayılan), sistem durumu denetimi yayımcı hizmeti tüm kayıtlı sistem durumu 
denetimlerini çalıştırır. Bir sistem durumu denetimleri alt kümesini çalıştırmak için denetim kümesini 
filtreleyen bir işlev sağlayın. Koşul her dönem değerlendirilir. 

• Tüm IHealthCheckPublisher örnekleri için sistem durumu denetimlerinin yürütülmesi için zaman aşımını - 
Timeout. Zaman aşımı olmadan yürütmek için InfiniteTimeSpan kullanın. Varsayılan değer 30 saniyedir. 


VVARNING 

ASP.NET Core 2,2 sürümünde, Period ayarı IHealthCheckPublisher uygulama tarafından kabul edilemez; Delaydeğerini 
ayarlar. Bu sorun ASP.NET Core 3,0 ' de giderilmiştir. 


Örnek uygulamada, ReadinessPubüsher bir IHealthCheckPublisher uygulamasıdır. Durum denetimi durumu her 
denetim için şu şekilde günlüğe kaydedilir: 

• Durum denetim durumu Healthyise bilgi (Loglnformation). 

• Durum Degraded veya Unhealthyise hata (LogError). 










public class ReadinessPublisher : IHealthCheckPublisher 

{ 

private readonly ILogger _logger; 

public ReadinessPublisher(ILogger<ReadinessPublisher> logger) 

{ 

_logger = logger; 

} 

// The following example is for demonstration purposes only. Health Checks 
// Middleware already logs health checks results. A real-world readiness 
// check in a production app might perform a set of more expensive or 
// time-consuming checks to determine if other resources are responding 
// properly. 

public Task PublishAsync(HealthReport report, 

CancellationToken cancellationToken) 

{ 

if (report.Status == HealthStatus.Healthy) 

{ 

_logger.LogInformation("{Timestamp} Readiness Probe Status: {Result}", 

DateTime.UtcNow, report.Status); 

} 

else 

{ 

_logger.LogError("{Timestamp} Readiness Probe Status: {Result}", 

DateTime.UtcNow, report.Status); 

} 

cancellationToken.ThrowIfCancellationRequested(); 
return Task.CompletedTask; 

} 

} 

Örnek uygulamanın LivenessProbestartup örneğinde, startupHostedService hazırlık denetimi iki saniyelik bir 
başlangıç gecikmesine sahiptir ve denetimi her 30 saniyede bir çalıştırır. IHealthCheckPublisher uygulamasını 
etkinleştirmek için örnek, bağımlılık ekleme (dı) kapsayıcısında tek bir hizmet olarak ReadinessPublisher 
kaydeder: 






public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddHostedService<StartupHostedService>(); 

Services.AddSingleton<StartupHostedServiceHealthCheck>(); 

Services.AddHealthChecks() 

.AddCheck<StartupHostedServiceHealthCheck>( 
"hosted_service_startup ", 
failureStatus: HealthStatus.Degraded, 
tags: new[] { "ready" }); 

Services.Configure<HealthCheckPublisherOptions>(options => 

{ 

options.Delay = TimeSpan.FromSeconds(2); 

options.Predicate = (check) => check.Tags.Contains("ready"); 

}); 

// The following workaround permits adding an IHealthCheckPublisher 
// instance to the service Container when one or more other hosted 
// Services have already been added to the app. This workaround 
// won't be required with the release of ASP.NET Core 3.0. For more 
// information, see: https://github.com/aspnet/Extensions/issues/639. 
Services.TryAddEnumerable( 

ServiceDescriptor .Singleton(typeof (IFlostedService ), 
typeof(HealthCheckPublisherOptions).Assembly 
.GetType(FlealthCheckServiceAssembly))); 

Services. AddSingletoncIFlealthCheckPublisher, ReadinessPublisher>(); 

} 


NOTE 

Aşağıdaki geçici çözüm, uygulamaya bir veya daha fazla barındırılan hizmet zaten eklendiyse, hizmet kapsayıcısına 
IHealthCheckPublisher bir örnek eklenmesine izin verir. Bu geçici çözüm ASP.NET Core 3,0 ' de gerekli değildir. 

private const string HealthCheckServiceAssembly = 

"Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckPublisherHostedService"; 

Services.T ryAddEnumerable( 

ServiceDescriptor.Singleton(typeof(IHostedService ), 
typeof(HealthCheckPublisherOptions).Assembly 
.GetType(HealthCheckServiceAssembly))); 


NOTE 

Aspnetcore. Diagnostics. Healthdenetimleri , Application Insightsdahil olmak üzere çeşitli sistemler için yayımcılar içerir. 
Aspnetcore. Diagnostics. Healthdenetimleri Microsoft tarafından korunmaz veya desteklenmez. 


Durum denetimlerini Mapperne zaman kısıtla 

Durum denetimi uç noktaları için istek ardışık düzenini koşullu olarak dallandırmak için MapVVhen kullanın. 

Aşağıdaki örnekte, api/HealthCheck uç noktası için bir GET isteği alındığında durum denetimleri ara yazılımını 
etkinleştirmek üzere istek ardışık düzenini Mapwhen dallandırır: 








app.MapWhen( 

context => context.Request.Method == HttpMethod.Get.Method && 
context.Request.Path.StartsWith("/api/HealthCheck"), 
builder => builder.UseHealthChecks()); 


app.UseMvc(); 


Daha fazla bilgi için bkz. ASP.NET Core ara yazılımı. 
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IMPORTANT 

Önizlemede Blazor VVeelsembly 

Blazor sunucusu ASP.NET Core 3,0 ' de desteklenir. Blazor VVebAssembly ASP.NET Core 3,1 için önizlemededir. 


Uygulamayı yayımlama 

Uygulamalar yayın yapılandırmasında dağıtım için yayımlanır. 

• Visual Studio 

• .NET Core CLI 

1. Gezinti çubuğundan derleme > {APPLICATION} Yayımla 1 yı seçin. 

2. Yayımla hedefirılseçn. Yerel olarak yayımlamak için klasör' ü seçin. 

3. Klasör seçin alanında varsayılan konumu kabul edin veya farklı bir konum belirtin. Yayımla düğmesini seçin. 

Uygulamanın yayımlanması, projenin bağımlılıklarını geri yüklemeyi tetikler ve dağıtım için varlıkları oluşturmadan 
önce projeyi oluşturur . Yapı işleminin bir parçası olarak, uygulama indirme boyutunu ve yükleme sürelerini 
azaltmak için kullanılmayan Yöntemler ve derlemeler kaldırılır. 

Blazor VVebAssembly uygulaması /BIN/Release/{Target Framework}/publish/{ASSEMBLY Name}/Dist klasörüne 
yayımlanır. Bir Blazor sunucusu uygulaması /BIN/Release/{Target Framework}/Publish klasörüne yayımlanır. 

Klasördeki varlıklar Web sunucusuna dağıtılır. Dağıtım, kullanımdaki geliştirme araçlarına bağlı olarak el ile veya 
otomatik bir süreç olabilir. 

Uygulama temel yolu 

Uygulama temelyolu , UYGULAMANIN kök URL yoludur.Aşağıdaki ASP.NET Core uygulamayı ve Blazor alt 
uygulamayı göz önünde bulundurun: 

• ASP.NET Core uygulamasının adı MyApp : 

o Uygulama fiziksel olarak d./MyAppkonumunda bulunur, 
o istekler https://www.contoso.com/tMYAPP RESOURCE} alindi. 

• coolApp adlı bir Blazor uygulaması, MyApp alt uygulamasıdır: 

o Alt uygulama fiziksel olarak c/:/MyApp/Coo/Appkonumunda bulunur, 
o istekler https://www.contoso.com/CoolApp/{COOLAPP RESOURCE} alindi. 

CoolApp için ek yapılandırma belirtmeden, Bu senaryodaki alt uygulama, sunucuda nerede bulunduğu konusunda 
bilgi sahibi değildir. Örneğin, uygulama, /CoolApp/ göreli URL yolunda bulunduğunu bilmeden kaynaklarına doğru 
göreli URL 'Ler oluşturamıyoruz. 

Blazor uygulamasının temel https://www.contoso.com/cooiApp/ yolu için yapılandırma sağlamak üzere <base> 
etiketinin href özniteliği Pages/_Host. cshtml dosyasında (Blazor Server) veya wwwrootAndex.html dosyasında 
(Blazor vvebassembly) göreli kök yolu olarak ayarlanır: 












<base href="/CoolApp/"> 

Blazor sunucu uygulamaları, uygulamanın startup.configure istek ardışık düzeninde UsePathBase çağırarak 
sunucu tarafı taban yolunu da ayarlar: 

app.UsePathBase("/CoolApp"); 

Göreli URL yolunu sağlayarak, kök dizinde olmayan bir bileşen, uygulamanın kök yoluna göre URL ’Ler 
oluşturabilir. Farklı dizin yapısı düzeylerindeki bileşenler, uygulama genelinde konumlardaki diğer kaynakların 
bağlantılarını oluşturabilir. Uygulama temel yolu Ayrıca, bağlantının href hedefinin uygulama temel yolu URI 
alanı içinde olduğu seçili köprüleri ele almak için de kullanılır. Blazor yönlendirici iç gezintiyi işler. 

Birçok barındırma senaryosunda, uygulamanın göreli URL yolu uygulamanın köküdür. Bu durumlarda, 
i URL taban yolu bir Blazor uygulamasının varsayılan yapılandırması olan eğik çizgi ( 

) olur.GitHub sayfaları ve 11S alt uygulamaları gibi diğer barındırma senaryolarında, uygulama 
temel yolu, sunucunun uygulamanın göreli URL 'SI yolu olarak ayarlanmalıdır. 

Uygulamanın temel yolunu ayarlamak için, Pages/_Host. cshtml dosyasının (Blazor Server) veya 
wwwrootAndex.html dosyasının (Blazor vvebassembly) <head> etiketi öğeleri içindeki <base> etiketini 
güncelleştirin, href öznitelik değerini /{relative url path}/ olarak ayarlayın (sondaki eğik çizgi gereklidir), 
burada {relative url path} uygulamanın tam göreli URL yoludur. 

Kök olmayan göreli URL yolu (örneğin, <base href="/cooiApp/"> ) olan bir Blazor VVebAssembly uygulaması için, 
uygulama yerel olarak çaUştırıldığında kaynaklarını bulamaz. Yerel geliştirmeye test sırasında bu sorunu aşmak 
için, çalışma zamanında <base> etiketinin href değeriyle eşleşen biryo/ temel bağımsız değişkeni 
sağlayabilirsiniz. Sondaki eğik çizgi eklemeyin. Uygulamayı yerel olarak çalıştırırken yol temel bağımsız değişkenini 
geçirmek için, --pathbase seçeneğiyle uygulamanın dizininden dotnet run komutunu yürütün: 

dotnet run --pathbase=/{RELATIVE URL PATH (no trailing slash)} 

Göreli URL yolu /coolApp/ ( <base href="/cooiApp/"> ) olan bir Blazor VVebAssembly uygulaması için, komut şu 
şekilde olur: 

dotnet run --pathbase=/CoolApp 

Blazor VVebAssembly uygulaması, http://iocaihost:port/cooiApp yerel olarak yanıt verir. 

Dağıtım 

Dağıtım Kılavuzu için aşağıdaki konulara bakın: 

• ASP.NET Core Blazor VVebAssembly 'ı barındırma ve dağıtma 

• ASP.NET Core Blazor sunucusu barındırma ve dağıtma 


uygulamanın görel 
cbase href="/" /> 





















ASPNET Core Blazor VVebAssembly 'ı barındırma ve 
dağıtma 

13.11.2019 • 17 minutes to read^ Edit Online 


, Luke Latham, Rainer Stropekve Daniel Roth tarafından 


IMPORTANT 

Önizlemede Blazor VVeelsembly 

Blazor sunucusu ASP.NET Core 3,0 ' de desteklenir. Blazor VVebAssembly ASP.NET Core 3,1 için önizlemededir. 


Blazor VVebAssembly barındırma modeliyle: 

• Blazor uygulaması, bağımlılıkları ve .NET çalışma zamanı tarayıcıya indirilir. 

• Uygulama doğrudan tarayıcı kullanıcı arabirimi iş parçacığında yürütülür. 

Aşağıdaki dağıtım stratejileri desteklenir: 

• Blazor uygulama ASP.NET Core bir uygulama tarafından sunulur.Bu strateji ASP.NET Core bölümünde 
barındırılan dağıtımda ele alınmıştır. 

• Blazor uygulaması, .NET Blazor uygulamasına hizmet vermek için kullanılmayan bir statik barındırma VVeb 
sunucusuna veya hizmetine yerleştirilir. Bu strateji tek başına dağıtım bölümünde ele alınmıştır. Bu, bir Blazor 
VVebAssembly UYGULAMASıNı bir IIS alt uygulaması olarak barındırma hakkında bilgiler içerir. 

Doğru yönlendirme için URL 1 Leri yeniden yazın 

Blazor VVebAssembly uygulamasındaki sayfa bileşenlerine yönelik yönlendirme istekleri, Blazor sunucusu, 
barındırılan bir uygulamada yönlendirme istekleri kadar basittir, iki bileşeni olan bir Blazor VVebAssembly 
uygulaması düşünün: 

• Main. razor- uygulamanın köküne yüklenir ve About bileşenine bir bağlantı içerir ( href="About" ). 

• .Razor- About bileşeni hakkında. 

Uygulamanın varsayılan belgesi, tarayıcının adres çubuğu kullanılarak istendiğinde (örneğin, 
https://www.contoso.com/ ): 

1. Tarayıcı bir istek yapar. 

2. Varsayılan sayfa döndürülür, bu genelliklerde* html'dır. 

3. uygulamanın index. html önyükleme. 

4. Blazoryönlendirici yükleri ve Razor Main bileşeni işlenir. 

Ana sayfada, Blazor yönlendirici tarayıcının About için www.contoso.com için bir istek yapmasını durdurduğundan 
ve işlenmiş About bileşeninin kendisini hizmet ettiğinden, About bileşene olan bağlantıyı seçmek istemcide çalışır. 
Blazor VVebAssembly uygulamasL içindeki iç uç noktalara yönelik tüm istekler aynı şekilde çalışır: istekler tarayıcı 
tabanlı istekleri Internet 'teki sunucu tarafından barındırılan kaynaklara tetiklemez. Yönlendirici istekleri dahili 
olarak işler. 

www.contoso.com/About için tarayıcının adres çubuğu kullanılarak bir istek yapılırsa, istek başarısız olur. 

Uygulamanın Internet ana bilgisayarında böyle bir kaynak yok, bu nedenle 404-bulunamayan bir yanıt 
döndürülür. 
















Tarayıcılar, istemci tarafı sayfaları için Internet tabanlı konaklara istek yaptığından, Web sunucuları ve barındırma 
hizmetleri, fiziksel olarak sunucu üzerinde olmayan kaynakların tüm isteklerini Dizin, htmi sayfasına yeniden 
yazmalıdır. index. html döndürüldüğünde, uygulamanın Blazor yönlendiricisi, doğru kaynakla yararlanır ve yanıt 
verir. 

Bir 11S sunucusuna dağıtım yaparken, URL yeniden yazma modülünü uygulamanın yayınlanan Web. config 
dosyasıyla birlikte kullanabilirsiniz. Daha fazla bilgi için IIS bölümüne bakın. 

ASP.NET Core ile barındırılan dağıtım 

Barındırılan bir dağıtım , bir Web sunucusu üzerinde çalışan bir ASP.NET Core uygulamasındaki tarayıcılara 
Blazor vvebassembly uygulamasını sunar. 

Blazor uygulaması, yayımlanan çıktıda ASP.NET Core uygulamasına dahildir, böylece iki uygulama birlikte dağıtılır. 
ASP.NET Core uygulamasını barındırabilen bir Web sunucusu gereklidir.Barındırılan bir dağıtım için Visual 
Studio, barındırılan seçeneği belirlenmiş olarak, Blazor VVebassembly uygulama projesi şablonunu ( DotNet 
New komutu kullanılırken biazorwasm şablonu) içerir. 

Uygulama barındırma ve dağıtım ASP.NET Core hakkında daha fazla bilgi için bkz. ASP.NET Core barındırma ve 
dağıtma. 

Azure App Service dağıtma hakkında daha fazla bilgi için bkz. Visual Studio ile Azure'a bir ASP.N ET Core 
uygulaması yayımlama. 

Tek başına dağıtım 

Tek başına dağıtım , istemci tarafından doğrudan istenen statik dosyalar kümesi olarak Blazor VVebAssembly 
uygulamasına hizmet verir. Herhangi bir statik dosya sunucusu Blazor uygulamasına sunabilir. 

Tek başına dağıtım varlıkları bin/Reiease/{Target Framework}/pubiish/{ASSEMBLY Name}/Dist klasöründe 
yayımlanır. 

IIS 

IIS, Blazor uygulamalar için özellikli bir statik dosya sunucusudur. IIS 'yi Blazorbarındıracak şekilde yapılandırmak 
için bkz. IIS 'de statik Web sitesi oluşturma. 

Yayımlanan varlıklar /BIN/Release/{Target Framework}/Pubiish klasöründe oluşturulur. Web sunucusunda veya 
barındırma hizmetinde Yayımlama klasörünün içeriğini barındırın. 

Web. config 

Bir Blazor projesi yayımlandığında, aşağıdaki IIS yapılandırmasıyla bir Web. config dosyası oluşturulur: 

• MİME türleri aşağıdaki dosya uzantıları için ayarlanır: 
o .dil— application/octet-stream 

o .json - application/json 
o . — application/wasm 
o . WOFF ~ application/font-woff 
o . woff2 — application/font-woff 

• Aşağıdaki MİME türleri için HTTP sıkıştırması etkindir: 


application/octet 

-stream 

application/wasm 



• URL yeniden yazma modülü kuralları oluşturuldu: 

o Uygulamanın statik varlıklarının bulunduğu alt dizini ( {Assembly Name}/dist/{PATFI istenen} ) sunar, 
o Dosya olmayan varlıklar için isteklerin statik varlıklar klasöründe ( {Assembly Name}/Dist/index.html) 









uygulamanın varsayılan belgesine yeniden YÖNLENDİRİLMESİ için Spa geri dönüş yönlendirmesi 
oluşturun. 

URL yeniden yazma modülünü yükler 

URL yeniden yazma modülü , URL 'leri yeniden yazmak için gereklidir. Modül varsayılan olarak yüklenmez ve bir 
Web sunucusu (MS) rol hizmeti özelliği olarak yükleme için kullanılamaz. Modül 11S Web sitesinden indirilmelidir. 
Modülünü yüklemek için Web Platformu Yükleyicisi'ni kullanın: 

1. Yerel olarak, URL yeniden yazma modülü indirmeleri sayfasınagidin. İngilizce sürümünde, VVebPI yükleyicisini 
indirmek için VVebPI 1 ı seçin. Diğer diller için, yükleyiciyi indirmek üzere sunucu için uygun mimariyi (x86/x64) 
seçin. 

2. Yükleyiciyi sunucuya kopyalayın. Yükleyiciyi çalıştırın., Iusta11 düğmesini seçin ve lisans koşullarını kabul edin. 
Yüklemesi tamamlandıktan sonra sunucu yeniden başlatması gerekli değildir. 

Web sitesini yapılandırma 

Web sitesinin fiziksel yolunu uygulamanın klasörüne ayarlayın. Klasör şunları içerir: 

• Gerekli yeniden yönlendirme kuralları ve dosya içerik türleri dahil olmak üzere US 'nin Web sitesini 
yapılandırmak için kullandığı Web. config dosyası. 

• Uygulamanın statik varlık klasörü. 

MS alt uygulaması olarak barındırma 

Tek başına bir uygulama bir US alt uygulaması olarak barındırılıyorsa, aşağıdakilerden birini yapın: 

• Devralınan ASP.NET Core modülü işleyicisini devre dışı bırakın. 

Dosyaya bir <handiers> bölümü ekleyerek Blazor uygulamasının yayınlanan Web. config dosyasındaki 
işleyiciyi kaldırın: 

<handlers> 

cremove name="aspNetCore" /> 

</handlers> 

• inheritinChildAppiications faise olarak ayarlanan <iocation> bir öğesi kullanarak kök (üst) 
uygulamanın <system.webServer> bölümünü devralmayı devre dışı bırakın: 

<?xml version="1.0" encoding="utf-8"?> 

<configuration> 

clocation path="." inheritInChildApplications="false"> 

<system.webServer> 

<handlers> 

<add name="aspNetCore" ... /> 

</handlers> 

<aspNetCore ... /> 

</system.webServen> 

</location> 

</configuration> 


işleyicinin kaldırılması veya devralma devre dışı bırakılması, uygulamanın temel yolunun yapılandırılmasınaek 
olarak gerçekleştirilir. Uygulamanın index. html dosyasındaki uygulama temel yolunu, US 'de alt uygulamayı 
YAPıLAN DıRıRKEN kullanılan MS diğer adına ayarlayın. 

Sorun giderme 

500-lç sunucu hatası ALıNMıŞSA ve MS Yöneticisi Web sitesinin yapılandırmasına erişmeye çalışırken hatalar 
OLUŞTURURSA, URL yeniden yazma modülünün yüklü olduğunu doğrulayın. Modül yüklü olmadığında, Web. 
config dosyası US tarafından ayrıştırılamaz. Bu, IIS yöneticisinin Web sitesinin yapılandırmasını ve Web sitesinin 
Blazorstatik dosyalarına hizmet etmesini engeller. 








IIS ile dağıtım sorunlarını giderme hakkında daha fazla bilgi için bkz. Azure App Service ve IIS 'de ASP.NET Core 
sorunlarını giderme. 

Azure Depolama 

Azure depolama statik dosya barındırma, sunucusuz Blazor uygulama barındırılmasına olanak sağlar.Özel etki 
alanı adları, Azure Content Delivery Netvvork (CDN) ve HTTPS desteklenir. 

Biob hizmeti bir depolama hesabında barındırılan statik Web sitesi için etkinleştirildiğinde: 

• Dizin belgesi adını index.html olarak ayarlayın. 

• Hata belge yolunu index.html olarak ayarlayın. Razor bileşenleri ve diğer dosya olmayan uç noktaları, blob 
hizmeti tarafından depolanan statik içerikte fiziksel yollarda yer vermez. Blazor yönlendiricisinin işlemesi 
gereken bu kaynaklardan birine yönelik bir istek alındığında, blob hizmeti tarafından oluşturulan 404- 
bulunamayarı hata, isteği hata belge yolunayönlendirir. index. html blobu döndürülür ve Blazor yönlendirici 
yolu yükler ve işler. 

Daha fazla bilgi için bkz. Azure Storage 'Da statik Web sitesi barındırma. 

NGINX 

Aşağıdaki NGINX. conf dosyası, NGINX 'in, disk üzerinde karşılık gelen bir dosyayı bulamadığı her seferinde 
index. html dosyasını göndermek üzere nasıl yapılandırılacağını gösterecek şekilde basitleştirilmiştir. 

events { } 
http { 

server { 

listen 80; 

location / { 

root /usr/share/nginx/html; 
try_files $uri $uri/ /index.html =404; 

} 

} 

} 

Üretim NGINX web sunucusu yapılandırması hakkında daha fazla bilgi için bkz. NGINX Plus ve NGINX 
yapılandırma dosyaları oluşturma. 

Docker'da NGINX 

Docker 'da NGINX kullanarak Blazor barındırmak için Dockerfile 'ı alp tabanlı NGINX görüntüsünü kullanacak 
şekilde ayarlayın. Dockerfile dosyasını, NGINX. config dosyasını kapsayıcıya kopyalamak için güncelleştirin. 

Aşağıdaki örnekte gösterildiği gibi Dockerfile dosyasına bir satır ekleyin: 

FROM nginx:alpine 

COPY ./bin/Release/netstandard2.0/publish /usr/share/nginx/html/ 

COPY nginx.conf /etc/nginx/nginx.conf 

Apache 

CentOS 7 veya üzeri bir Blazor VVebAssembly uygulaması dağıtmak için: 

1. Apache yapılandırma dosyasını oluşturun. Aşağıdaki örnek basitleştirilmiş bir yapılandırma dosyasıdır 
( blazorapp. config ): 








cVirtualHost *:80> 

ServerName www.example.com 
ServenAlias *. example.com 

DocumentRoot "/var/www/blazorapp" 

ErrorDocument 404 /index.html 

AddType apllcation/wasm ,wasm 
AddType application/octet-stream .dil 

<Directory "/var/www/blazorapp"> 

Options -Indexes 
AllowOverride None 
</Directony> 

dfModule mod_deflate.c> 

AddOutputFilterByType DEFLATE text/css 
AddOutputFilterByType DEFLATE applicatlon/javascript 
AddOutputFilterByType DEFLATE text/html 
AddOutputFilterByType DEFLATE application/octet-stream 
AddOutputFilterByType DEFLATE application/wasm 
dfModule mod_setenvif. c> 

BrowserMatch A Mozilla/4 gzip-only-text/html 
BrowserMatch A Mozilla/4.0[678] no-gzip 
BrowserMatch bMSIE !no-gzip !gzip-only-text/html 
</IfModule> 

</IfModule> 

ErrorLog /var/log/httpd/blazorapp-error.log 
CustomLog /var/log/httpd/blazorapp-access.log common 
</VirtualFlost> 


2. Apache yapılandırma dosyasını, CentOS 7 1 de varsayılan Apache yapılandırma dizini olan 

/etc/httpd/conf .d/ dizinine yerleştirin. 

3. Uygulamanın dosyalarını /var/www/biazorapp dizinine yerleştirin (yapılandırma dosyasına DocumentRoot 
için belirtilen konum). 

4. Apache hizmetini yeniden başlatın. 

Daha fazla bilgi için bkz. mod_mime ve mod_deflate. 

GitHub sayfaları 

URL yeniden işlemesini işlemek için, isteği index. html sayfasına yönlendirmeyi işleyen bir betiği olan bir 404. html 
dosyası ekleyin. Topluluk tarafından sunulan örnek bir uygulama için bkz. GitHub sayfaları İçin tek sayfalı 
uygulamalar (GitHub üzerinde rafrex/Spa-GitHub-Pages). Topluluk yaklaşımını kullanan bir örnek, GitHub (canlı 
site) üzerinde blazor-demo/blazor-demo. GitHub. 10 adresinde görülebilir. 

Bir kuruluş sitesi yerine bir proje sitesi kullanırken, index. hfm/dosyasına <base> etiketi ekleyin veya güncelleştirin, 
href öznitelik değerini, sondaki eğik çizgiyle (örneğin, my-repository/ ) GitHub depo adına ayarlayın. 

Ana bilgisayar yapılandırma değerleri 

Blazor VVebAssembly Apps , geliştirme ortamındaki çalışma zamanında aşağıdaki ana bilgisayar yapılandırma 
değerlerini komut satırı bağımsız değişkenleri olarak kabul edebilir. 

İçerik kökü 

--contentroot bağımsız değişkeni, uygulamanın içerik dosyalarını (içerik kökü) içeren dizinin mutlak yolunu 
ayarlar. Aşağıdaki örneklerde, /content-root-path , uygulamanın içerik kök yoludur. 

• Uygulamayı bir komut isteminde yerel olarak çalıştırırken bağımsız değişkenini geçirin. Uygulamanın 











dizininden şunu yürütün: 


dotnet run --contentroot=/content-root-path 

• 11S Express profilindeki uygulamanın iaunchsettings. JSON dosyasına bir giriş ekleyin. Bu ayar, uygulama 
Visual Studio hata ayıklayıcıyla ve dotnet run ile bir komut isteminden çalıştırıldığında kullanılır. 

"commandLineArgs": "--contentroot=/content-root-path" 

• Visual Studio da > hata ayıklama > uygulama bağımsız değişkenlerinin Özelliklerbölümünde 

bağımsız değişkenini belirtin. Visual Studio özellik sayfasında bağımsız değişkeni ayarlama, bağımsız 
değişkenini Laurıchsettings. JSON dosyasına ekler. 

--contentroot=/content-root-path 

Yol tabanı 

--pathbase bağımsız değişkeni, kök olmayan göreli URL yoluyla yerel olarak çalıştırılan bir uygulamanın 
uygulama temel yolunu ayarlar ( <base> etiketi href , hazırlama ve üretim için / dışında bir yola ayarlanır). 
Aşağıdaki örneklerde, /relative-URL-path , uygulamanın yol tabanı olur. Daha fazla bilgi için bkz. uygulama temel 
yolu. 


IMPORTANT 

<base> etiketinin href olarak belirtilen yolun aksine, --pathbase bağımsız değişken değeri geçirilirken sondaki eğik çizgi 
(/) eklemeyin. Uygulama temel yolu <base> etiketinde <base href="/coolApp/"> (sondaki eğik çizgi içeriyorsa) olarak 
sağlanmışsa, komut satırı bağımsız değişken değerini --pathbase=/coolApp (sondaki eğik çizgi olmadan) olarak geçirin. 


• Uygulamayı bir komut isteminde yerel olarak çalıştırırken bağımsız değişkenini geçirin. Uygulamanın 
dizininden şunu yürütün: 

dotnet run --pathbase=/relative-URL-path 

• 11S Express profilindeki uygulamanın iaunchsettings. JSON dosyasına bir giriş ekleyin. Bu ayar, uygulamayı 
Visual Studio hata ayıklayıcıyla ve dotnet run ile bir komut isteminden çalıştırırken kullanılır. 

"commandLineArgs": "--pathbase=/relative-URL-path" 

• Visual Studio da > hata ayıklama > uygulama bağımsız değişkenlerinin Özelliklerbölümünde 

bağımsız değişkenini belirtin. Visual Studio özellik sayfasında bağımsız değişkeni ayarlama, bağımsız 
değişkenini Launchsettings. JSON dosyasına ekler. 

--pathbase=/relative-URL-path 

URL'ler 

--urls bağımsız değişkeni, istekler için dinlemek üzere bağlantı noktaları ve protokollerle İP adreslerini veya 
konak adreslerini ayarlar. 

• Uygulamayı bir komut isteminde yerel olarak çalıştırırken bağımsız değişkenini geçirin. Uygulamanın 
dizininden şunu yürütün: 

















dotnet run --urls=http://127.0.0.1:0 

• IIS Express profilindeki uygulamanın launchsettings. JSON dosyasına bir giriş ekleyin. Bu ayar, uygulamayı 
Visual Studio hata ayıklayıcıyla ve dotnet run ile bir komut isteminden çalıştırırken kullanılır. 

"commandLineArgs": "--urls=http://127.0.0.1:0" 

• Visual Studio da > hata ayıklama > uygulama bağımsız değişkenlerinin Özelliklerbölümünde 

bağımsız değişkenini belirtin. Visual Studio özellik sayfasında bağımsız değişkeni ayarlama, bağımsız 
değişkenini Laurıchsettings. JSON dosyasına ekler. 

- -urls=http://127.0.0.1:0 


Bağlayıcıyı yapılandırma 

Blazor, çıkış derlemelerinden gereksiz II 'yi kaldırmak için her bir derlemede ara dil (İL) bağlamayı gerçekleştirir. 
Derleme bağlama, derleme üzerinde denetlenebilir.Daha fazla bilgi için bkz. ASP.NET Core Blazor için bağlayıcı 
yapılandırma. 
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Ana bilgisayar yapılandırma değerleri 

Blazor Server uygulamaları genel ana bilgisayar yapılandırma değerlerinikabul edebilir. 

Dağıtım 

Blazor sunucusu barındırma modelinikullanarak, Blazor sunucuda bir ASP.NET Core uygulaması içinden 
yürütülür. Kullanıcı Arabirimi güncelleştirmeleri, olay işleme ve JavaScript çağrıları SignalR bir bağlantı üzerinden 
işlenir. 

ASP.NET Core uygulaması barındırabilen bir Web sunucusu gerekiyor. Visual Studio, DotNet New komutu 
kullanılırken Blazor Server uygulaması proje şablonunu ( biazorserverside şablonu) içerir. 

Ölçeklenebilirlik 

Bir Blazor sunucusu uygulaması için kullanılabilir altyapıyı en iyi şekilde kullanmasını sağlamak üzere bir dağıtım 
planlayın. Blazor Server uygulama ölçeklenebilirliğini karşılamak için aşağıdaki kaynaklara bakın: 

• Blazor Server uygulamalarının temelleri 

• Güvenli ASP.NET Core Blazor Server uygulamaları 

Dağıtım sunucusu 

Tek bir sunucunun ölçeklenebilirliğini değerlendirirken (ölçeği büyütme), bir uygulama için kullanılabilir olan 
bellek büyük olasılıkla uygulamanın kullanıcı talebi arttıkça arttırabileceği ilk kaynaktır. Sunucudaki kullanılabilir 
bellek şunları etkiler: 

• Bir sunucunun destekleyebileceği etkin devre sayısı. 

• istemcide Ul gecikme süresi. 

Güvenli ve ölçeklenebilir Blazor sunucu uygulamaları oluşturma hakkında yönergeler için bkz. Güvenli ASP.NET 
Core Blazor Server uygulamaları. 

Her bağlantı hattı en düşük Merhaba Dünya stilinde bir uygulama için YAKLAŞıK 250 KB bellek kullanır.Bir 
devrenin boyutu, uygulamanın koduna ve her bileşenle ilişkili durum bakım gereksinimlerine bağlıdır. Uygulama 
ve altyapınız için geliştirme sırasında kaynak taleplerini ölçmenizi öneririz, ancak aşağıdaki taban çizgisi, dağıtım 
hedefini planlamada bir başlangıç noktası olabilir: uygulamanızın 5.000 eşzamanlı kullanıcı desteklemesini 
istiyorsanız, şu adreste bütçeleme yapmayı düşünün: uygulamaya en az 1,3 GB sunucu belleği (veya Kullanıcı 
başına ~ 273 KB). 

SignalR yapılandırması 

Blazor sunucu uygulamaları tarayıcıyla iletişim kurmak için ASP.NET Core SignalR kullanır. SignalRbarındırma ve 
ölçeklendirme koşulları Blazor sunucu uygulamaları için geçerlidir. 

daha düşük gecikme süresi, güvenilirlik ve güvenliknedeniyle SignalR taşıma olarak VVebSockets kullanırken 
Blazor en iyi şekilde işe yarar. Uzun yoklama, VVebSockets kullanılamadığında veya uygulama açıkça uzun 
yoklamayı kullanacak şekilde yapılandırıldığında SignalR tarafından kullanılır. Azure App Service dağıtım 
sırasında, uygulamayı hizmetin Azure portal ayarları içinde kullanmak üzere yapılandırın. Azure App Service için 








uygulamayı yapılandırma hakkında ayrıntılı bilgi için bkz. SignalR yayımlama yönergeleri. 

Azure SignalR hizmeti 

Blazor Server uygulamaları için Azure SignalR hizmetini kullanmanızı öneririz. Hizmet, Blazor sunucu 
uygulamasının ölçeğini çok sayıda eşzamanlı SignalR bağlantı ile ölçeklendirmeye olanak tanır. Ayrıca, SignalR 
hizmetin küresel erişim ve yüksek performanslı veri merkezleri Coğrafya nedeniyle gecikme süresini azaltmaya 
önemli ölçüde yardımcı olur. Azure SignalR hizmetini bir uygulamayı yapılandırmak (ve isteğe bağlı olarak 
sağlamak) için: 

1. Prerendering sırasında istemciler aynı sunucuya geri yönlendirildiği yapışkan ofurum/ondesteklemek için 
hizmeti etkinleştirin. serverstickyMode seçeneğini veya yapılandırma değerini Required olarak ayarlayın. 
Genellikle, bir uygulama aşağıdaki yaklaşımlardan birini kullanarak yapılandırmayı oluşturur: 

• Startup.ConfigureServices : 

Services.AddSignalR().AddAzureSignalR(options => 

{ 

options.ServerstickyMode = 

Microsoft.Azure.SignalR.ServerstickyMode.Requiredj 

}); 

• Yapılandırma (aşağıdaki yaklaşımlardan birini kullanın): 
o appSettings. JSON: 

"Azure:SignalR:ServerStickyMode": "Required" 


o App Service in yapılandırma Azure Portal uygulama ayarları > (ad: 

Azure:SignalR:ServerstickyMode , değer Required ). 

2. Blazor Server uygulaması için Visual Studio 'da bir Azure Apps yayımlama profili oluşturun. 

3. Azure SignalR hizmeti bağımlılığını profile ekleyin. Azure aboneliğinin uygulamaya atanacak önceden 
mevcut bir Azure SignalR hizmeti örneği yoksa, yeni bir hizmet örneği sağlamak için Yeni bir azure 
SignalR hizmet örneği oluştur ' u seçin. 

4. Uygulamayı Azure'da yayımlama. 

IIS 

11S kullanırken, yapışkan oturumlar uygulama İsteği yönlendirme ile etkinleştirilir. Daha fazla bilgi için bkz. 
uygulama İsteği yönlendirme kullanarak HTTP yük dengelemesi. 

Kubernetes 

Yapışkan oturumlar için aşağıdaki Kubernetes ek açıklamalarınıiçeren bir giriş tanımı oluşturun: 

apiVersion: extensions/vlbetal 
kind: Ingress 
metadata: 

name: <ingress-name> 
annotations: 

nginx.ingness.kubernetes.io/affinity: "cookie" 
nginx.ingress.kubernetes.io/session-cookie-name: "affinity" 
nginx.ingress.kubernetes.io/session-cookie-expires: "14400" 
nginx.ingress.kubernetes.io/session-cookie-max-age: "14400" 


Ölçü ağı gecikmesi 

Aşağıdaki örnekte gösterildiği gibi, js birlikte çalışması ağ gecikmesini ölçmek için kullanılabilir: 







Şinject IISRuntime TS 

Şif (latency is null) 

{ 

<span>Calculating...</span> 

} 

else 

{ 

<span>@(latency.Value.TotalMilliseconds)ms</span> 

} 

Şcode 

{ 

private DateTime startTime; 
private TimeSpan? latency; 

protected override async Task OnInitializedAsync() 

{ 

startTime = DateTime.UtcNow; 

var _ = await DS.InvokeAsync<string>("toString"); 
latency = DateTime.UtcNow - startTime; 

} 


Makul bir kullanıcı arabirimi deneyimi için, 250ms veya daha az sayıda sürekli Kullanıcı arabirimi gecikme süresi 
önerilir. 
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IMPORTANT 

Önizlemede Blazor VVeelsembly 

Blazor sunucusu ASP.NET Core 3,0 ' de desteklenir. Blazor WebAssembly ASP.NET Core 3,1 için önizlemededir. 


Blazor, uygulamanın çıkış derlemelerinden gereksiz II 'yi kaldırmak için bir derleme sırasında ara dil (İL) 
bağlamayı gerçekleştirir. 

Aşağıdaki yaklaşımlardan birini kullanarak derleme bağlamayı kontrol edin: 

• MSBuild özelliğiile genel olarak bağlamayı devre dışı bırakın. 

• Yapılandırma dosyasıile derleme temelinde bağlama denetimi. 

MSBuild özelliği ile bağlamayı devre dışı bırak 

Bir uygulama oluşturulduğunda, yayımlama de dahil olmak üzere varsayılan olarak bağlama etkindir.Tüm 
derlemeler için bağlamayı devre dışı bırakmak için BiazorLinkOnBuiid MSBuild özelliğini proje dosyasında 
faise olarak ayarlayın: 

<PropertyGroup> 

<BlazorLinkOnBuild>false</BiazorLinkOnBuiid> 

</PropertyGroup> 


Yapılandırma dosyası ile bağlamayı denetleme 

Bir XML yapılandırma dosyası sağlayarak ve dosyayı proje dosyasında MSBuild öğesi olarak belirterek, derleme 
başına temelinde bağlamayı denetleyin: 

<ItemGroup> 

<Blazorl_inkerDescriptor Include="Linker.xml" /> 

</ItemGroup> 


Bağlayicı. xml : 








<?xml version="1.0" encoding="UTF-8" ?> 

<!-- 

This file specifies which parts of the BCL or Blazon packages must not be 
stripped by the IL Linker even if they aren't referenced by user code. 

--> 

<linker> 

cassembly fullname="mscorlib"> 

<!-- 

Pneserve the methods in WasmRuntime because its methods are called by 
JavaScript client-side code to implement timers. 

Fixes: https://github.com/aspnet/Blazor/issues/239 

--> 

ctype fullname="System.Threading.WasmRuntime" /> 

</assembly> 

cassembly fullname="System.Core"> 

<!-- 

System.Linq.Expressions* is required by Json.NET and any 
expression.Compile caller. The assembly isn't stripped. 

--> 

ctype fullname="System.Linq.Expressions*" /> 

</assembly> 

<!-- 

In this example, the app's entry point assembly is listed. The assembly 
isn't stripped by the IL Linker. 

--> 

cassembly fullname="MyCoolBlazorApp" /> 

</linker> 


Daha fazla bilgi için bkz. II Bağlayıcısı: XML tanımlayıcısının sözdizimi. 

Bağlayıcıyı uluslararası duruma getirme için yapılandırma 

Varsayılan olarak, Blazor VVebAssembly uygulamaları için Blazorbağlayıcı yapılandırması, açıkça istenen yerel 
ayarlar dışında uluslararası duruma getirme bilgilerini kaldırır. Bu derlemelerin kaldırılması uygulamanın 
boyutunu en aza indirir. 

Hangi 118N derlemelerinin korunacağını denetlemek için, proje dosyasında <MonoLinkerii8NAssembiies> MSBuild 
özelliğini ayarlayın: 


cPropertyGroup> 

<MonoLinkerI18NAssemblies>{all|none|REGIONİ,REGI0N2,. 
</PropertyGroup> 

..}</MonoLinkenI18NAssemblies> 

BÖLGE DEĞERİ 

MONO BÖLGESİ DERLEMESİ 

ali 

Tüm derlemeler dahil 

cjk 

11 8N. CJK. dil 

mideast 

I18N. MİDEAST dil 

none (varsayılan) 

Yok. 

other 

118N. Diğer, dil 

rare 

I18N. Nadir, dil 


west 


118N. Batı, dil 












Birden çok değeri ayırmak için virgül kullanın (örneğin, mideast,west ). 

Daha fazla bilgi için bkz. 118N: Pnetlib uluslararası duruma getirme çerçeve Libary (Mono/Mono GitHub deposu). 
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23.08.2019 • 2 minutes to read ı Edit Online 


AS P.N ET Core, geliştiricilerin uygulamaları için güvenliği kolayca yapılandırıp yönetmesine olanak sağlar. 

AS P.N ET Core, kimlik doğrulama, yetkilendirme, veri koruma, HTTPS zorlaması, uygulama parolaları, istek 
önleyici koruma ve CORS yönetimi yönetimi için özellikler içerir. Bu güvenlik özellikleri, güçlü ancak güvenli 
ASP.NET Core uygulamalar oluşturmanıza olanak tanır. 

ASP.NET Core güvenlik özellikleri 

ASP.NET Core, uygulamalarınızı güvenli hale getirmek için yerleşik kimlik sağlayıcıları da dahil olmak üzere 
birçok araç ve kitaplık sağlar, ancak Facebook, Tvvitter veya Linkedln gibi üçüncü taraf kimlik hizmetlerini de 
kullanabilirsiniz. ASP.NET Core ile, uygulama gizli dizilerini kolayca yönetebilirsiniz. Bu, özel bilgileri kodda 
kullanıma sunmak zorunda kalmadan depolamanın ve kullanmanın bir yoludur. 

Kimlik doğrulaması ile Yetkilendirme 

Kimlik doğrulaması, bir kullanıcının bir işletim sistemi, veritabanı, uygulama veya kaynakta depolananlara kıyasla 
kimlik bilgileri sağladığı bir işlemdir. Eşleşiyorsa, kullanıcılar başarıyla kimlik doğrular ve yetkilendirme işlemi 
sırasında, için yetkilendirildiği eylemleri gerçekleştirebilir. Yetkilendirme, bir kullanıcının ne yapmasına izin 
verileceğini belirleyen işlemi ifade eder. 

Kimlik doğrulamayı düşünmenin bir diğer yolu da, bir sunucu, veritabanı, uygulama veya kaynak gibi bir boşluk 
girmek için bir yöntem olarak göz önünde bulundurmaktır, yetkilendirme sırasında kullanıcının bu alanın içindeki 
hangi nesneleri gerçekleştirebileceği (sunucu, veritabanı veya uygulama) eylemleri. 

Yazılımda yaygın olarak karşılaşılan güvenlik açıkları 

ASP.NET Core ve EF, uygulamalarınızın güvenliğini sağlamanıza ve güvenlik ihlallerinin engellenmesine yardımcı 
olan özellikler içerir. Aşağıdaki bağlantı listesi, Web Apps 'teki en yaygın güvenlik açıklarını önlemenize yönelik 
teknik bilgi için sizi belgeler halinde yönlendirir: 

• Siteler arası betik saldırıları 

• SQL ekleme saldırıları 

• Çapraz site İsteği forgery (CSRF) 

• Yeniden yönlendirme saldırılarını aç 

Bilmeniz gereken daha fazla güvenlik açığı vardır. Daha fazla bilgi için içindekiler tablosunun güvenlik ve kimlik 
bölümündeki diğer makalelere bakın. 
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Kimlik doğrulaması, bir kullanıcının kimliğini belirleme işlemidir. Yetkilendirme , bir kullanıcının bir kaynağa erişip 
erişemeyeceğini belirleme işlemidir. ASP.NET Core, kimlik doğrulaması, kimlik doğrulama ara yazılımıtarafından 
kullanılan iAuthenticationService tarafından işlenir. Kimlik doğrulama hizmeti, kimlik doğrulama ile ilgili eylemleri 
tamamlamaya yönelik kayıtlı kimlik doğrulama işleyicilerini kullanır. Kimlik doğrulaması ile ilgili eylemlere örnek 
olarak şunlar verilebilir: 

• Kullanıcı kimlik doğrulaması. 

• Kimliği doğrulanmamış bir Kullanıcı kısıtlı bir kaynağa erişmeyi denediğinde yanıt verir. 

Kayıtlı kimlik doğrulama işleyicileri ve yapılandırma seçenekleri "şemalar" olarak adlandırılır. 

Kimlik doğrulama düzenleri startup.configureServices kimlik doğrulama hizmetleri kaydedilerek belirtilir: 


Bir 

Services.AddAuthentication 

çağrısından sonra düzene özgü bir genişletme yöntemini çağırarak (örneğin 

AddDwtBearer 

veya 

AddCookie ( 

gibi). Bu uzantı yöntemleri, uygun ayarlarla şemaları kaydetmek için 


Authenticationbuilder. AddScheme kullanır. 

• Daha seyrek, Authenticationbuilder. AddScheme doğrudan çağırarak. 

Örneğin, aşağıdaki kod, tanımlama bilgisi ve JWT taşıyıcı kimlik doğrulama şemaları için kimlik doğrulama 
hizmetlerini ve işleyicileri kaydeder: 

Services.AddAuthentication(JwtBearerDefaults.AuthenticatİonScheme) 

.AddiwtBearer(DwtBearerDefaults.Aut hent icat ionScheme, options => Configuration.Bind("3wtSettings", 
options)) 

.AddCookie(CookieAuthenticationDefaults.AuthenticationScheme, options => 

Configuration.Bind("CookieSettings", options)); 

AddAuthentication parametresi DwtBearerDefauit s .Aut hent icat ionScheme , belirli bir düzen istenmediğinde 
varsayılan olarak kullanılacak düzenin adıdır. 

Birden çok düzen kullanılırsa, yetkilendirme ilkeleri (veya yetkilendirme öznitelikleri) kullanıcının kimliğini 
doğrulamak için bağımlı oldukları kimlik doğrulama düzenini (veya düzenleri) belirtebilir . Yukarıdaki örnekte, 
tanımlama bilgisi kimlik doğrulama düzeni adı belirtilerek kullanılabilir (varsayılan olarak 
cookieAuthenticationDefault s. Aut hent icat ionScheme , ancak AddCookie çağrılırken farklı bir ad sağlandıysa). 

Bazı durumlarda AddAuthentication çağrısı diğer uzantı yöntemleri tarafından otomatik olarak yapılır. Örneğin, 
ASP.NET Core kimliğikullanılırken, AddAuthentication dahili olarak çağrılır. 

Kimlik doğrulama ara yazılımı, uygulamanın iAppiicationBuiider UseAuthentication uzantısı yöntemi çağırarak 
startup.configure eklenir. UseAuthentication çağırmak, daha önce kayıtlı kimlik doğrulama düzenlerini kullanan 
ara yazılımı kaydeder. Kimliği doğrulanan kullanıcılara bağlı olan tüm ara yazılımlar için UseAuthentication çağırın. 
Endpoint Routing kullanılırken, UseAuthentication çağrısı şu şekilde olmalıdır: 

• useRouting sonra, kimlik doğrulama kararlarında yol bilgileri kullanılabilir. 

• useEndpoints önce, kullanıcıların, uç noktalara erişmeden önce kimlik doğrulaması yapılır. 


Kimlik doğrulama kavramları 



















Kimlik doğrulama düzeni 

Kimlik doğrulama düzeni, öğesine karşılık gelen bir addır: 

• Bir kimlik doğrulama işleyicisi. 

• İşleyicinin belirli bir örneğini yapılandırma seçenekleri. 

Şemaları, ilişkili işleyicinin kimlik doğrulama, sınama ve fordeklarasyonu davranışlarına başvurma mekanizması 
olarak faydalıdır. Örneğin, bir yetkilendirme ilkesi, kullanıcının kimliğini doğrulamak için hangi kimlik doğrulama 
şemasının (veya düzenlerinin) kullanılması gerektiğini belirtmek için şema adlarını kullanabilir. Kimlik 
doğrulamasını yapılandırırken, varsayılan kimlik doğrulama düzenini belirlemek yaygın bir hale gelir. Varsayılan 
şema, bir kaynak belirli bir düzeni istemediği takdirde kullanılır. Şunları da mümkündür: 

• Kimlik doğrulama, sınama ve fordeklarasyon eylemleri için kullanılacak farklı varsayılan şemaları belirtin. 

• Birden çok düzeni ilke düzenlerinikullanarak bir tek birleştirme. 

Kimlik doğrulama işleyicisi 

Kimlik doğrulama işleyicisi: 

• , Bir düzenin davranışını uygulayan bir türdür. 

• lAuthenticationHandler veya AuthenticationHandler<TOptions>türetilir. 

• , Kullanıcıların kimliğini doğrulamak için Birincil sorumluluğa sahiptir. 

Kimlik doğrulama düzeninin yapılandırmasına ve gelen istek bağlamına göre, kimlik doğrulama işleyicileri: 

• Kimlik doğrulaması başarılı olursa kullanıcının kimliğini temsil eden AuthenticationTicket nesneleri oluşturun. 

• Kimlik doğrulaması başarısız olursa ' No Result' veya ' Failure 1 döndürün. 

• Kullanıcıların kaynaklara erişmeyi deneyeceği işlemler ve yasaklamaya yönelik yöntemlere sahiptir: 
o Bunlara erişim yetkisi yoktur (fordeklarasyon). 

o Kimliği doğrulanmamış olduğunda (zorluk). 

Kimlik doğrulama 

Kimlik doğrulama düzeninin kimlik doğrulama eylemi, kullanıcının kimliğini istek bağlamına göre oluşturmaktan 
sorumludur. Kimlik doğrulamanın başarılı olup olmadığını ve bu durumda kullanıcının kimlik doğrulama biletinde 
kimliğini belirten bir AuthenticateResult döndürür. Bkz. HttpContext.AuthenticateAsync . Kimlik doğrulama örnekleri 
şunları içerir: 

• Tanımlama bilgisi kimlik doğrulama şeması kullanıcının kimlik bilgilerinden kimliğini oluşturan. 

• Bir JWT taşıyıcı şeması, kullanıcının kimliğini oluşturmak için bir JWT taşıyıcı belirtecini seri durumdan çıkarma 
ve doğrulama. 

Sınama 

Kimliği doğrulanmamış bir kullanıcı kimlik doğrulaması gerektiren bir uç nokta istediğinde yetkilendirme ile kimlik 
doğrulama sınaması çağrılır. Örneğin, anonim bir Kullanıcı kısıtlı bir kaynak istediğinde veya bir oturum açma 
bağlantısına tıkladığı zaman bir kimlik doğrulama sınaması verilir. Yetkilendirme, belirtilen kimlik doğrulama 
düzenlerini kullanarak bir zorluk çağırır ya da hiçbiri belirtilmemişse varsayılan değer. Bkz. 

HttpContext.chailengeAsync . Kimlik doğrulama sınaması örnekleri şunları içerir: 

• Bir tanımlama bilgisi kimlik doğrulama şeması kullanıcıyı bir oturum açma sayfasına yönlendiriyor. 

• Bir www-authenticate: bearer üst bilgisiyle 401 sonucu döndüren JWT taşıyıcı şeması. 

Bir sınama eylemi, kullanıcının istenen kaynağa erişmek için hangi kimlik doğrulama mekanizmasını kullanacağınızı 
bilmesine izin verir. 

Yasaklamaz 

Kimliği doğrulanmış bir kullanıcı erişimine izin verilmeyen bir kaynağa erişmeyi denediğinde kimlik doğrulama 





düzeninin fordeklarasyon eylemi yetkilendirme tarafından çağrılır. Bkz. HttpContext.ForbidAsync . Kimlik doğrulama 
fordeklarasyon örnekleri şunları içerir: 

• Bir tanımlama bilgisi kimlik doğrulama şeması, kullanıcıyı erişim yasak bir sayfaya yönlendirdi. 

• 403 sonucunu döndüren bir JWT taşıyıcı şeması. 

• Özel bir kimlik doğrulama şeması, kullanıcının kaynağa erişim isteyebileceği bir sayfaya yeniden yönlendiriliyor. 
Bir fordeklarasyon eylemi, kullanıcının şunları bilmesini sağlayabilir: 

• Bunlar doğrulanır. 

• istenen kaynağa erişmelerine izin verilmez. 

Challenge ve fordeklarasyon arasındaki farklılıklar için aşağıdaki bağlantılara bakın: 

• işletimsel kaynak Işleyicisiyle Challenge ve fordeklarasyonu. 

• Çekişme ve fordeklarasyon arasındaki farklar. 

Ek kaynaklar 

• ASP.NET Core belirli bir şemayla yetkilendir 

• ASP.NET Core'de ilke şemaları 

• Kullanıcı verilerinin yetkilendirme tarafından korunduğu ile bir ASP.NET Core uygulaması oluşturma 



ASPNET Core kimliğe giriş 
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Tarafından RickAnderson 

ASP.NET Core kimliği: 

• , Kullanıcı arabirimi (Ul) oturum açma işlevselliğini destekleyen bir API 'dir. 

• Kullanıcıları, parolaları, profil verilerini, rolleri, talepleri, belirteçleri, e-posta onayını ve daha fazlasını 
yönetir. 

Kullanıcılar, kimlik içinde depolanan oturum açma bilgilerini içeren bir hesap oluşturabilir veya bir dış 
oturum açma sağlayıcısı kullanabilirler. Desteklenen dış oturum açma sağlayıcıları Facebook, Google, 
Microsoft hesabı ve Tvvitteriçerir. 

Kimlik kaynak kodu GitHub ' da kullanılabilir. Kimlik ile şablon etkileşimini gözden geçirmek için, 
kimliği iskele geçirin ve oluşturulan dosyaları görüntüleyin. 

Kimlik genellikle kullanıcı adlarını, parolaları ve profil verilerini depolamak için bir SQL Server 
veritabanı kullanılarak yapılandırılır. Alternatif olarak, başka bir kalıcı mağaza da kullanılabilir, örneğin 
Azure Tablo depolaması. 

Bu konu başlığında, bir kullanıcıyı kaydetmek, oturum açmak ve oturumu kapatmak için kimlik 
kullanmayı öğrenirsiniz. Kimlik kullanan uygulamalar oluşturma hakkında daha ayrıntılı yönergeler için, 
bu makalenin sonundaki sonraki adımlar bölümüne bakın. 

Microsoft Identity platform : 

• Azure Active Directory (Azure AD) geliştirici platformunun bir evrimi. 

• ASP.NET Core kimlikle ilgisi yoktur. 

ASP.NET Core kimlik, ASP.NET Core Web uygulamalarına Kullanıcı arabirimi (Ul) oturum açma 
işlevselliği ekler. Web API 'Leri ve maça 'ları güvenli hale getirmek için aşağıdakilerden birini kullanın: 

• Azure Active Directory 

• Azure Active Directory B2C (Azure AD B2C)] 

• Identityserver4 

Identityserver4, ASP.NET Core 3,0 için bir OpenlD Connect ve OAuth 2,0 çerçevesidir.Identityserver4 
aşağıdaki güvenlik özelliklerini sunar: 

• Hizmet olarak kimlik doğrulaması (AaaS) 

• Birden çok uygulama türü üzerinde çoklu oturum açma/kapatma (SSO) 

• API 'Ler için erişim denetimi 

• Federasyon ağ geçidi 

Daha fazla bilgi için bkz. ıdentityserver4 to VVelcome. 

Örnek kodu (indirme) görüntüleyin veya indirin . 

Kimlik doğrulamasıyla bir Web uygulaması oluşturma 

Bireysel kullanıcı hesaplarıyla bir ASP.NET Core Web uygulaması projesi oluşturun. 





• Visual Studio 

• .NETCoreCLI 

• Dosya > Yeni > Proje' yi seçin. 

• Seçin ASP.NET Core Web uygulaması. Projeyi Proje VVebAppl aynı ad alanına sahip olacak 
şekilde adlandırın. Tamam'a tıklayın. 

• Bir AS P.N ET Core Web uygulamasıseçip kimlik doğrulamasını Değiştir' i seçin. 

• Bireysel kullanıcı hesapları 1 nı seçip Tamam' a tıklayın. 

Oluşturulan proje, Razor sınıf kitaplığıolarak ASP.NET Core kimliği sağlar. Identity Razor sınıfı kitaplığı, 
identity alanı ile uç noktaları kullanıma sunar. Örneğin: 

• /Identity/Account/Login 

• /Identity/Account/Logout 

• /Identity/Account/Manage 

Geçişleri Uygula 

Veritabanını başlatmak için geçişleri uygulayın. 

• Visual Studio 

• .NETCoreCLI 

Paket Yöneticisi konsolunda aşağıdaki komutu çalıştırın (PMC): 

PM> Update-Database 

Test kaydı ve oturum açma 

Uygulamayı çalıştırın ve bir Kullanıcı kaydedin. Ekran boyutunuza bağlı olarak, kayıt ve oturum açma 
bağlantılarını görmek için gezinti geçiş düğmesini seçmeniz gerekebilir. 

Kimlik veritabanı görünümü 

• Visual Studio 

• .NETCoreCLI 

• Gelen görünümü menüsünde SQL Server Nesne Gezgini (SSOX). 

• Gidin (localdb) (SQL Server 13) ifadesini MSSQLLocalDB. Sağ dbo. AspNetUsers > verileri 
görüntüleme: 




SQL Server Object Explorer » f X 

6 + İ 

A gi SQL Server 

a E (localdb)\MSSQLLocalDB (SQL Server 13.0.1601 - I 
^ a Databases 

> El System Databases 
a aspnet-WebApp1 
a O Tables 

> M System Tables 

> M Bdernal Tables 

> m dbo._EFMİgrationsHistory 

> B dbo.AspNetRoleClaims 

> B dbo.AspNetRoles 

> B dbo.AspNetUserCIaims 

> B dbo.AspNetüserLogins 

> B dbo.AspNetUserRoles 


> M dbo.AspNetUsers 
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Kimlik hizmetlerini yapılandırma 

Hizmetler configureServices eklenir. Tipik model, tüm Add{Service} yöntemlerini çağırmak ve sonra 
tüm Services.configure{Service} yöntemlerini çağırmalıdır. 











public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 

Services.AddDefaultIdentity<IdentityUser>(options => options.Signln.RequireConfirmedAccount 
true) 

.AddEntityFrameworkStores<ApplicationDbContext>(); 

Services.AddRazorPages(); 

Services.Configure<IdentityOptions>(options => 

{ 

// Password settings. 
options.Password.RequireDigit = true; 
options.Password.RequireLowercase = true; 
options.Password.RequireNonAlphanumeric = true; 
options.Password.RequireUppercase = true; 
options.Password.RequiredLength = 6; 
options.Password.RequiredUniqueChars = 1; 

// Lockout settings. 

options.Lockout.DefaultLockoutTimeSpan = TimeSpan.FromMinutes(5); 
options.Lockout.MaxFailedAccessAttempts = 5; 
options.Lockout.AllowedForNewUsers = true; 

// User settings. 

options.User.AllowedUserNameCharacters = 

"abcdefghijklmnopqrstuvwxyzABCDEFGHIİKLMNOPQRSTUVWXYZ0123456789-._@+"; 
options.User.RequireUniqueEmail = false; 

}); 

Services.ConfigureApplicationCookie(options => 

{ 

// Cookie settings 

options.Cookie.HttpOnly = true; 

options.ExpireTimeSpan = TimeSpan.FromMinutes(5); 

options.LoginPath = "/Identity/Account/Login"; 

options.AccessDeniedPath = "/Identity/Account/AccessDenied"; 

options.SlidingExpiration = true; 

}); 

} 

Önceki vurgulanan kod, varsayılan seçenek değerleriyle kimliği yapılandırır.Hizmetler, bağımlılık 
eklemeyoluyla uygulama için kullanılabilir hale getirilir. 

Kimlik, UseAuthenticationçağırarak etkinleştirilir. useAuthentication , istek ardışık düzenine kimlik 
doğrulama ara yazılımı ekler. 




public void Configure(IApplicationBuilder appj IklebHostEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 
app.UseDatabaseErrorPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 

app.UseRoutingO; 

app.UseAuthentication(); 
app.UseAuthorization(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapRazorPages(); 

}); 

} 

Şablon tarafından oluşturulan uygulama Yetkilendirmekullanmaz. app.useAuthorization , uygulamanın 
yetkilendirme eklemesi için doğru sırada eklendiğinden emin olmak için eklenmiştir. useRouting , 
useAuthentication , useAuthorization ve useEndpolnts önceki kodda gösterilen sırada çağrılmalıdır. 

identityOptions ve startup hakkında daha fazla bilgi için bkz. IdentityOptions ve uygulama başlatma. 

Yapı iskelesi kaydı, oturum açma ve oturum kapatma 

• Visual Studio 

• .NETCoreCLI 

Kayıt, oturum açma ve oturum kapatma dosyalarını ekleyin. Bu bölümde gösterilen kodu oluşturmak 
için, yetkilendirme yönergeleriyle birlikte bir Razor projesinde yapı iskelesi kimliğini izleyin. 

Kaydı İncele 

Kullanıcı Kaydet bağlantısına tıkladığında RegisterModei.onPostAsync eylemi çağrılır. Kullanıcı, 
_userManager nesnesi üzerinde Createasync tarafından oluşturulur. _userManager bağımlılık ekleme 
tarafından sağlanır): 












public async Task<IActionResult> OnPostAsync(string returnllrl = null) 

{ 

returnllrl = returnllrl ?? Url.Content("~/"); 

ExternalLogins = (await _signInManager.GetExternalAuthenticationSchemesAsync()) 

.ToList(); 

if (ModelState.IsValid) 

{ 

var user = new Identityllser { UserName = Input.Email, Email = Input.Email }; 
var result = await _userManager.CreateAsync(user, Input.Password); 
if (result.Succeeded) 

{ 

_logger.LogInformation("üser created a new account with password."); 

var code = await _userManager.GenerateEmailConfirmationTokenAsync(user); 
code = WebEncoders.Base64UrlEncode(Encoding.UTF8.GetBytes(code)); 
var callbackUrl = Url.Page( 

"/Account/ConfirmEmail", 
pageHandler: null., 

values: new { area = "Identity", userld = user.id, code = code }, 
protocol: Request.Scheme); 

await _emailSender.SendEmailAsync(Input.Email, "Confirm your email", 
$"Please confirm your account by <a 
href='{HtmlEncoder.Default.Encode(callbackUrl)}'>clicking here</a>."); 


} 


if (_userManager.Options.Signln.RequireConfirmedAccount) 

{ 


} 


return RedirectToPage("RegisterConfirmation", 

new { email = Input.Email }); 


else 

{ 

await _signInManager.SignInAsync(user, isPersistent: false); 
return LocalRedirect(returnUrl); 

} 

} 

foreach (var error in result.Errors) 

{ 

ModelState.AddModelError(string.Empty, error.Deseription); 

} 


// If we got this far, something failed, redisplay form 
return Page(); 


Kullanıcı başarıyla oluşturulduysa, Kullanıcı _signinManager.signinAsync çağrısıyla oturum açar. 


Kayıt sırasında anında oturum açmayı önlemeye yönelik adımlar için bkz. Hesap onayı . 


Oturum aç 

Oturum açma formu şu durumlarda görüntülenir: 


• Oturum aç bağlantısı seçilidir. 

• Kullanıcı, erişim yetkisi olmayan veya sistem tarafından kimliği doğrulanmamış olan sınırlı bir 
sayfaya erişmeyi dener. 

Oturum açma sayfasındaki form gönderildiğinde onPostAsync eylemi çağrılır. PasswordSigninAsync , 
_signinManager nesnesi üzerinde çağrılır (bağımlılık ekleme tarafından sağlanır). 







public async Task<IActionResult> OnPostAsync(string returnUrl = null) 

{ 

returnUrl = returnUrl ?? Url.Content("~/"); 

if (ModelState.IsValid) 

{ 

// This doesn't count login failures towards account lockout 
// To enable password failures to trigger account lockout, 

// set lockoutOnFailure: true 

var result = await _signInManager.PasswordSignInAsync(Input.Email, 

Input.Password, Input.RememberMe, lockoutOnFailure: true); 
if (result.Succeeded) 

{ 

_logger.LogInformation("User logged in."); 
return LocalRedirect(returnUrl); 

} 

if (result.RequiresTwoFactor) 

{ 

return RedirectToPage("./LoginWith2fa", new 

{ 

ReturnUrl = returnUrl., 

RememberMe = Input.RememberMe 

}); 

} 

if (result.IsLockedOut) 

{ 

_logger.LogWarning("User account locked out."); 
return RedirectToPage("./Lockout"); 

} 

else 

{ 

ModelState.AddModelError(string.Empty, "Invalid login attempt."); 
return Page(); 

} 

} 

// If we got this far, something failed, redisplay form 
return Page(); 

} 

Temel controiler sınıfı, denetleyici yöntemlerinden erişilebilen bir User özelliğini kullanıma sunar. 
Örneğin, user.ciaims numaralandırmanızı ve yetkilendirme kararları almanızı sağlayabilirsiniz. Daha 
fazla bilgi için bkz. AS P.N ET Core yetkilendirme giriş. 

Oturumu kapat 

Oturum çıkış bağlantısı LogoutModei.onPost eylemini çağırır. 







using Microsoft.AspNetCore.Authorization; 
using Microsoft.AspNetCore.Identity; 
using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.Extensions.Logging; 
using System.Threading.Tasks; 

namespace 1/JebAppl. Areas. Identity. Pages .Account 

{ 

[AllowAnonymous] 

public class LogoutModel : PageModel 

{ 

private readonly SignInManager<IdentityUser> _signInManager; 
private readonly ILogger<LogoutModel> _logger; 

public LogoutModel(SignInManager<IdentityUser> signlnManager, ILogger<LogoutModel> logger) 

{ 

_signInManager = signlnManager; 

_logger = logger; 

} 

public void OnGet() 

{ 

} 

public async Task<IActionResult> OnPost(string returnUrl = null) 

{ 

await _signInManager.SignOutAsync(); 

_logger.LogInformation("User logged out."); 
if (returnUrl != null) 

{ 

return LocalRedirect(returnUrl); 

} 

else 

{ 

return RedirectToPage(); 

} 

} 

} 

} 

Önceki kodda, tarayıcının yeni bir istek yapması ve Kullanıcı kimliğinin güncelleştirilmesini sağlamak 
için kod return RedirectToPage(); yeniden yönlendirme olması gerekir. 

Signoutasync , kullanıcının tanımlama bilgisinde depolanan taleplerini temizler. 

Sayfa/paylaşılan/_LoginPartial. cshtml'de gönderi belirtildi: 




(Şusing Microsoft.AspNetCore. Identity 

(Şinject SignInManager<IdentityUser> SignlnManager 

(Şinject UserManager<IdentityUser> UserManager 

<ul class="navbar-nav"> 

@if (SignlnManager.IsSignedln(User)) 

{ 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-area="Identity" asp-page="/Account/Manage/Index" 

title="Manage">Hello @User.Identity.Name!</a> 

</li> 

<li class="nav-item"> 

<form class="form-inline" asp-area="Identity" asp-page="/Account/Logout" 

asp-route-returnUrl="@Url.Page("/"j new { area = "" })" 
method="post" > 

<button type="submit" class="nav-link btn btn-link text-dark">Logout</button> 

</form> 

</li> 

} 

else 

{ 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-area="Identity" asp-page="/Account/Register">Register</a> 
</li> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-area="Identity" asp-page="/Account/Login">Login</a> 

</li> 

} 

</ul> 


Test kimliği 

Varsayılan Web projesi şablonları, giriş sayfalarına anonim erişime izin verir. Kimliği test etmek için 

[Authorize] ekleyin: 

using Microsoft.AspNetCore.Authorization; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.Extensions.Logging; 

namespace 1/JebAppl.Pages 

{ 

[Authorize] 

public class PrivacyModel : PageModel 

{ 

private readonly ILogger<PrivacyModel> _logger; 

public PrivacyModel(ILogger<PrivacyModel> logger) 

{ 

_logger = logger; 

} 

public void OnGet() 

{ 

} 

} 

} 

Oturumunuz açık ise oturumu kapatın. Uygulamayı çalıştırın ve Gizlilik bağlantısını seçin. Oturum 
açma sayfasına yönlendirilirsiniz. 

Kimliği keşfet 

Kimliği daha ayrıntılı incelemek için: 



• Tam kimlik Ul kaynağı oluşturma 

• Her sayfanın kaynağını inceleyin ve hata ayıklayıcıda ilerleyin. 

Kimlik bileşenleri 

Tüm kimlik bağımlı NuGet paketleri ASP.NET Core paylaşılan çerçevesinedahildir. 

Kimliğin birincil paketi Microsoft. AspNetCore. Identity' dır. Bu paket, ASP.NET Core kimliği için 
çekirdek arabirim kümesini içerir ve Microsoft.AspNetCore.ıdentity.EntityFrameworkCore tarafından 
dahildir. 

ASP.NET Core kimliğe geçiriliyor 

Mevcut kimlik deponuzu geçirme hakkında daha fazla bilgi ve yönergeler için bkz. kimlik doğrulama ve 
kimlik geçişi. 

Parola gücünü ayarlama 

Minimum parola gereksinimlerini ayarlayan bir örnek için bkz. yapılandırma . 

Adddefaultıdentity ve AddEntity 

AddDefaultldentity ASP.NET Core 2,1 ' de tanıtılmıştı. AddDefaultidentity çağırmak, aşağıdakileri 
çağırmaya benzer: 

• Addldentity 

• AddDefaultUl 

• AddDefaultTokenProviders 

Daha fazla bilgi için bkz. Adddefaultıdentity kaynağı . 

Sonraki Adımlar 

• Kimliği Yapılandırma 

• Kullanıcı verilerinin yetkilendirme tarafından korunduğu ile bir ASP.NET Core uygulaması 
oluşturma 

• Ekleme, indirmek ve bir ASP.NET Core projesi kimliği için kullanıcı verilerini silme 

• ASP.NET core'da TOTP authenticator uygulamaları için QR kodu oluşturmayı etkinleştirme 

• Kimlik doğrulaması ve kimliği ASP.NET Core geçir 

• ASP.NET Core hesap onaylama ve parola kurtarma 

• ASP.NET Core SMS ile iki öğeli kimlik doğrulama 

• Web çiftliğinde AS P.N ET Core ana bilgisayar 

Tarafından RickAnderson 

ASP.NET Core kimlik, ASP.NET Core uygulamalara oturum açma işlevselliği ekleyen bir üyelik 
sistemidir. Kullanıcılar, kimlik içinde depolanan oturum açma bilgilerini içeren bir hesap oluşturabilir 
veya bir dış oturum açma sağlayıcısı kullanabilirler. Desteklenen dış oturum açma sağlayıcıları 
Facebook, Google, Microsoft hesabı ve Tvvitteriçerir. 

Kimlik, Kullanıcı adlarını, parolaları ve profil verilerini depolamak için bir SQL Server veritabanı 
kullanılarak yapılandırılabilir. Alternatif olarak, başka bir kalıcı mağaza da kullanılabilir, örneğin Azure 
Tablo depolaması. 

Örnek kodu (indirme) görüntüleyin veya indirin . 





Bu konu başlığında, bir kullanıcıyı kaydetmek, oturum açmak ve oturumu kapatmak için kimlik 
kullanmayı öğrenirsiniz. Kimlik kullanan uygulamalar oluşturma hakkında daha ayrıntılı yönergeler için, 
bu makalenin sonundaki sonraki adımlar bölümüne bakın. 

Adddefaultıdentity ve AddEntity 

AddDefaultldentity ASP.NET Core 2,1 ' de tanıtılmıştı. AddDefaultidentity çağırmak, aşağıdakileri 
çağırmaya benzer: 

• Addldentity 

• AddDefaultUl 

• AddDefaultTokenProviders 

Daha fazla bilgi için bkz. Adddefaultıdentity kaynağı . 

Kimlik doğrulamasıyla bir Web uygulaması oluşturma 

Bireysel kullanıcı hesaplarıyla bir ASP.NET Core Web uygulaması projesi oluşturun. 

• Visual Studio 

• .NET Core CLI 

• Dosya > Yeni > Proje' yi seçin. 

• Seçin ASP.NET Core Web uygulaması. Projeyi Proje VVebAppl aynı ad alanına sahip olacak 
şekilde adlandırın. Tamam'a tıklayın. 

• Bir AS P.N ET Core Web uygulamasıseçip kimlik doğrulamasını Değiştir' i seçin. 

• Bireysel kullanıcı hesapları ' nı seçip Tamam' a tıklayın. 

Oluşturulan proje, Razor sınıf kitaplığıolarak ASP.NET Core kimliği sağlar. Identity Razor sınıfı kitaplığı, 
identity alanı ile uç noktaları kullanıma sunar. Örneğin: 

• /Identity/Account/Login 

• /Identity/Account/Logout 

• /Identity/Account/Manage 

Geçişleri Uygula 

Veritabanını başlatmak için geçişleri uygulayın. 

• Visual Studio 

• .NET Core CLI 

Paket Yöneticisi konsolunda aşağıdaki komutu çalıştırın (PMC): 

PM> Update-Database 

Test kaydı ve oturum açma 

Uygulamayı çalıştırın ve bir Kullanıcı kaydedin. Ekran boyutunuza bağlı olarak, kayıt ve oturum açma 
bağlantılarını görmek için gezinti geçiş düğmesini seçmeniz gerekebilir. 

Kimlik veritabanı görünümü 

• Visual Studio 

• .NET Core CLI 

• Gelen görünümü menüsünde SQL Server Nesne Gezgini (SSOX). 

• Gidin (localdb) (SQL Server 13) ifadesini MSSQLLocalDB. Sağ dbo. AspNetUsers > verileri 





görüntüleme: 


SQL Server Object Explorer ? X 

6 *İ 

A yî SQL Server 

a E (localdb)\MSSQLLocalDB(SQL Server 13.0.1601-1 
' a Databases 

> 0 System Databases 

A Q aspnet-WebApp1 
a Tables 

> ■ System Tables 

> M Bdernal Tables 

> ffl dbo._EFMİgrationsHistory 

> §1 dbo.AspNetRoleClaims 

> H dbo.AspNetRoles 

> H dbo.AspNetUserCIaims 

> H dbo.AspNetUserLogins 

> H dbo.AspNetUserRoles 


> JeeeI dboAspNetUsers 
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Script As 
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View Code 
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View Designer 
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View Permissions 
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Del 
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> E (loca 

M Projects ^ 

Rename 


Refresh 
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EDI 


Kimlik hizmetlerini yapılandırma 

Hizmetler configureServices eklenir. Tipik model, tüm Add{Service} yöntemlerini çağırmak ve sonra 
tüm Services.configure{Service} yöntemlerini çağırmalıdır. 











public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 

Services.AddDefaultIdentity<IdentityUser>() 

.AddDefaultUI(UIFramework.Bootstrap4) 

.AddEntityFrameworkStores<ApplicationDbContext>(); 

Services.Configure<IdentityOptions>(options => 

{ 

// Password settings. 
options.Password.RequireDigit = true; 
options.Password.RequireLowercase = true; 
options.Password.RequireNonAlphanumeric = true; 
options.Password.RequireUppercase = true; 
options.Password.RequiredLength = 6; 
options.Password.RequiredUniqueChars = 1; 

// Lockout settings. 

options.Lockout.DefaultLockoutTimeSpan = TimeSpan.FromMinutes(5); 
options.Lockout.MaxFailedAccessAttempts = 5; 
options.Lockout.AllowedForNewUsers = true; 

// User settings. 

options.User.AllowedUserNameCharacters = 

"abcdefghijklmnopqrstuvwxyzABCDEFGHIİKLMNOPQRSTUVWXYZ0123456789-._@+"; 
options.User.RequireUniqueEmail = false; 

}); 

Services.ConfigureApplicationCookie(options => 

{ 

// Cookie settings 

options.Cookie.HttpOnly = true; 

options.ExpireTimeSpan = TimeSpan.FromMinutes(5); 

options.LoginPath = "/Identity/Account/Login"; 

options.AccessDeniedPath = "/Identity/Account/AccessDenied"; 

options.SlidingExpiration = true; 

}); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


Yukarıdaki kod, varsayılan seçenek değerleriyle kimliği yapılandırır.Hizmetler, bağımlılık eklemeyoluyla 
uygulama için kullanılabilir hale getirilir. 

Kimlik, UseAuthenticationçağırarak etkinleştirilir. useAuthentication , istek ardışık düzenine kimlik 
doğrulama ara yazılımı ekler. 




public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 
app.UseDatabaseErrorPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 
app.UseCookiePolicy(); 

app.UseAuthentication(); 

app.UseMvc(); 

} 

Daha fazla bilgi için bkz. ıdentityoptions sınıfı ve uygulama başlatma. 

Yapı iskelesi kaydı, oturum açma ve oturum kapatma 

Bu bölümde gösterilen kodu oluşturmak için, yetkilendirme yönergeleriyle birlikte bir Razor projesinde 
yapı iskelesi kimliğini izleyin. 

• Visual Studio 

• .NETCoreCLI 

Kayıt, oturum açma ve oturum kapatma dosyalarını ekleyin. 

Kaydı İncele 

Kullanıcı Kaydet bağlantısına tıkladığında RegisterModei.onPostAsync eylemi çağrılır. Kullanıcı, 
_userManager nesnesi üzerinde Createasync tarafından oluşturulur. _userManager bağımlılık ekleme 
tarafından sağlanır): 






public async Task<IActionResult> OnPostAsync(string returnUrl = null) 

{ 

returnUrl = returnUrl ?? Url.Content("~/"); 
if (ModelState.IsValid) 

{ 

var user = new IdentityUser { UserName = Input.Email, Email = Input.Email }; 
var result = await _userManager.CreateAsync(user, Input.Password); 
if (result.Succeeded) 

{ 

_logger.LogInformation("User created a new account with password."); 

var code = await _userManager.GenerateEmailConfirmatlonTokenAsync(user); 
var callbackUrl = Url.Page( 

"/Account/ConfirmEmail", 
pageHandler: null, 

values: new { userld = user.id, code = code }, 
protocol: Request.Scheme); 

await _emailSender.SendEmailAsync(Input.Email, "Confirm your email", 

$"Please confirm your account by <a 
href='{HtmlEncoder.Default.Encode(callbackUrl)}'>clicking here</a>."); 

await _signInManager.SignInAsync(user, isPersistent: false); 
return LocalRedirect(returnUrl); 

} 

foreach (var error in result.Errors) 

{ 

ModelState.AddModelError(string.Empty, error.Deseription); 

} 

} 

// If we got this far, something failed, redisplay form 
return Page(); 

} 

Kullanıcı başarıyla oluşturulduysa, Kullanıcı _signinManager.signinAsync çağrısıyla oturum açar. 
Note: Kayıt sırasında anında oturum açmayı önlemeye yönelik adımlar için bkz. Hesap onayı . 

Oturum aç 

Oturum açma formu şu durumlarda görüntülenir: 

• Oturum aç bağlantısı seçilidir. 

• Kullanıcı, erişim yetkisi olmayan veya sistem tarafından kimliği doğrulanmamış olan sınırlı bir 
sayfaya erişmeyi dener. 

Oturum açma sayfasındaki form gönderildiğinde onPostAsync eylemi çağrılır. PasswordSigninAsync , 
_signinManagen nesnesi üzerinde çağrılır (bağımlılık ekleme tarafından sağlanır). 







public async Task<IActionResult> OnPostAsync(string returnUrl = null) 

{ 

returnUrl = returnUrl ?? Url.Content("~/"); 

if (ModelState.IsValid) 

{ 

// This doesn't count login failures towards account lockout 
// To enable password failures to trigger account lockout, 

// set lockoutOnFailure: true 

var result = await _signInManager.PasswordSignInAsync(Input.Email, 

Input.Password, Input.RememberMe, lockoutOnFailure: true); 
if (result.Succeeded) 

{ 

_logger.LogInformation("User logged in."); 
return LocalRedirect(returnUrl); 

} 

if (result.RequiresTwoFactor) 

{ 

return RedirectToPage("./LoginWith2fa", new { ReturnUrl = returnUrl., RememberMe = 
Input.RememberMe }); 

} 

if (result.IsLockedOut) 

{ 

_logger.LogWarning("User account locked out."); 
return RedirectToPage("./Lockout"); 

} 

else 

{ 

ModelState.AddModelError(string.Empty, "Invalid login attempt."); 
return Page(); 

} 

} 

// If we got this far, something failed, redisplay form 
return Page(); 

} 

Temel controiler sınıfı, denetleyici yöntemlerinden erişebileceğiniz bir User özelliğini kullanıma 
sunar. Örneğin, user.ciaims numaralandırmanızı ve yetkilendirme kararları almanızı sağlayabilirsiniz. 
Daha fazla bilgi için bkz. AS P.N ET Core yetkilendirme giriş. 

Oturumu kapat 

Oturum çıkış bağlantısı LogoutModei.onPost eylemini çağırır. 







using Microsoft.AspNetCore.Authorization; 
using Microsoft.AspNetCore.Identity; 
using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.Extensions.Logging; 
using System.Threading.Tasks; 

namespace 1/JebAppl. Areas. Identity. Pages. Account 

{ 

[AllowAnonymous] 

public class LogoutModel : PageModel 

{ 

private readonly SignInManager<IdentityUser> _signInManager; 
private readonly ILogger<LogoutModel> _logger; 

public LogoutModel(SignInManager<IdentityUser> signlnManager, ILogger<LogoutModel> logger) 

{ 

_signInManager = signlnManager; 

_logger = logger; 

} 

public void OnGet() 

{ 

} 

public async Task<IActionResult> OnPost(string returnUrl = null) 

{ 

await _signInManager.SignOutAsync(); 

_logger.LogInformation("User logged out."); 
if (returnUrl != null) 

{ 

return LocalRedirect(returnUrl); 

} 

else 

{ 

// This needs to be a redirect so that the browser performs a new 
// request and the identity for the user gets updated. 
return RedirectToPage(); 

} 

} 

} 

} 


Signoutasync , kullanıcının tanımlama bilgisinde depolanan taleplerini temizler. 
Sayfa/paylaşılan/_LoginPartial. cshtml'de gönderi belirtildi: 



(Şusing Microsoft.AspNetCore. Identity 

@inject SignInManager<IdentityUser> SignlnManager 

(Şinject UserManager<IdentityUser> UserManager 

<ul class="navbar-nav"> 

@if (SignlnManager.IsSignedln(User)) 

{ 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-area="Identity" 
asp-page="/Account/Manage/Index" 
title="Manage">Hello@User.Identity.Name!</a> 

</li> 

<li class="nav-item"> 

<form class="form-inline" asp-area="Identity" asp-page="/Account/Logout" 
asp-route-returnUrl="@Url.Page("/"> new { area = "" })" 
method="post"> 

<button type="submit" class="nav-link btn btn-link text-dark">Logout</button> 
</form> 

</li> 

} 

else 

{ 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-area="Identity" asp- 
page="/Account/Register">Register</a> 

</li> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-area="Identity" asp-page="/Account/Login">Login</a> 
</li> 

} 

</ul> 


Test kimliği 

Varsayılan Web projesi şablonları, giriş sayfalarına anonim erişime izin verir. Kimliği test etmek için 
Gizlilik sayfasına [Authorize] ekleyin. 

using Microsoft.AspNetCore.Authorization; 
using Microsoft.AspNetCore.Mvc.RazorPages; 

namespace 1/JebAppl.Pages 

{ 

[Authorize] 

public class PrivacyModel : PageModel 

{ 

public void OnGet() 

{ 

} 

} 

} 

Oturumunuz açık ise oturumu kapatın. Uygulamayı çalıştırın ve Gizlilik bağlantısını seçin. Oturum 
açma sayfasına yönlendirilirsiniz. 

Kimliği keşfet 

Kimliği daha ayrıntılı incelemek için: 

• Tam kimlik Ul kaynağı oluşturma 

• Her sayfanın kaynağını inceleyin ve hata ayıklayıcıda ilerleyin. 




Kimlik bileşenleri 

Tüm kimlik bağımlı NuGet paketleri Microsoft. AspNetCore. app metapackage'e dahildir. 

Kimliğin birincil paketi Microsoft. AspNetCore. Identity' dır. Bu paket, ASP.NET Core kimliği için 
çekirdek arabirim kümesini içerir ve Microsoft.AspNetCore.ıdentity.EntityFrameworkCore tarafından 
dahildir. 

ASP.NET Core kimliğe geçiriliyor 

Mevcut kimlik deponuzu geçirme hakkında daha fazla bilgi ve yönergeler için bkz. kimlik doğrulama ve 
kimlik geçişi. 

Parola gücünü ayarlama 

Minimum parola gereksinimlerini ayarlayan bir örnek için bkz. yapılandırma . 

Sonraki Adımlar 

• Kimliği Yapılandırma 

• Kullanıcı verilerinin yetkilendirme tarafından korunduğu ile bir ASP.NET Core uygulaması 
oluşturma 

• Ekleme, indirmek ve bir ASP.NET Core projesi kimliği için kullanıcı verilerini silme 

• ASP.NET core'da TOTP authenticator uygulamaları için QR kodu oluşturmayı etkinleştirme 

• Kimlik doğrulaması ve kimliği ASP.NET Core geçir 

• ASP.NET Core hesap onaylama ve parola kurtarma 

• ASP.NET Core SMS ile iki öğeli kimlik doğrulama 

• Web çiftliğinde AS P.N ET Core ana bilgisayar 




Maça kimlik doğrulaması ve yetkilendirme 
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ASP.NET Core 3,0 veya üzeri, API yetkilendirmesi desteğini kullanarak tek sayfalı uygulamalarda (Spaon) kimlik 
doğrulaması sunmaktadır. Kimlik doğrulama ve depolama için ASP.NET Core kimliği, açık KİMLİK Connect 
uygulama için IdentityServer ile birleştirilir. 

Web uygulamasındaki kimlik doğrulama parametresine benzer bir kimlik doğrulama parametresi ( Model-View- 
Controller) (MVC ) ve Web uygulaması (Razor Pages) Proje şablonları, izin verilen parametre değerleri none 
ve bireysel. Tepki, js ve Redux proje şablonu şu anda kimlik doğrulama parametresini desteklemiyor. 

API yetkilendirme desteğiyle uygulama oluşturma 

Kullanıcı kimlik doğrulaması ve yetkilendirme, hem angular ile hem de maça 'Ları ile kullanılabilir. Bir komut 
kabuğu açın ve şu komutu çalıştırın: 

Angular: 

dotnet new angular -o <output_directory_name> -au Individual 

Tepkiverme: 

dotnet new react -o <output_directory_name> -au Individual 

Yukarıdaki komut, SPA 'yı içeren clierıtapp dizinine sahip bir ASP.NET Core uygulaması oluşturur. 

Uygulamanın ASP.NET Core bileşenlerinin genel açıklaması 

Aşağıdaki bölümlerde, kimlik doğrulama desteği dahil edildiğinde projenin eklemeleri açıklanır: 

Başlangıç sınıfı 

startup sınıfı aşağıdaki eklemelere sahiptir: 

• startup.configureServices yönteminin içinde: 
o Varsayılan Kullanıcı arabirimine sahip kimlik: 

Services.AddDbContext<ApplicationDbContext>(options => 

options.UseSqlite(Configuration.GetConnectionString("DefaultConnection"))); 

Services.AddDefaultIdentity<ApplicatlonUser>() 

.AddDefaultUI(UIFramework.Bootstrap4) 

.AddEntityFrameworkStores<ApplicationDbContext>(); 

o IdentityServer 1 1 n en üstünde yer alan bazı varsayılan ASP.NET Core kurallarını yükleyen ek bir 
AddApiAuthorization Yardımcısı yöntemi olan IdentityServer: 

Services.AddIdentityServer() 

.AddApiAuthorizatiorKApplicationUser, ApplicationDbContext>(); 

o Kimliği, IdentityServer tarafından üretilen JWT belirteçlerini doğrulamak üzere uygulamayı 








yapılandıran ek bir AddidentityServerDwt Yardımcısı yöntemiyle kimlik doğrulaması: 


Services.AddAuthentication() 

.AddIdentityServerDwt(); 

• startup.Configure yönteminin içinde: 

o İstek kimlik bilgilerini doğrulamadan ve Kullanıcı istek bağlamında ayarlamaktan sorumlu kimlik 
doğrulama ara yazılımı: 

app.UseAuthentication(); 

o Açık KİMLİK bağlantı noktalarını kullanıma sunan IdentityServer ara yazılımı: 
app.UseIdentityServer(); 

Addadpiauthorization 

Bu yardımcı yöntemi, IdentityServer 'ı desteklenen yapılandırmamızı kullanacak şekilde yapılandırır. 
IdentityServer, uygulama güvenliği sorunlarını işlemeye yönelik güçlü ve genişletilebilir bir çerçevedir. Aynı 
zamanda, en yaygın senaryolar için gereksiz karmaşıklık sunan. Sonuç olarak, size iyi bir başlangıç noktası olarak 
kabul edilen bir dizi kural ve yapılandırma seçeneği sağlanır. Kimlik doğrulama gereksinimleriniz değiştikçe, 
IdentityServer ’ın tam gücü, kimlik doğrulamasını gereksinimlerinize uyacak şekilde özelleştirmek için hala 
kullanılabilir. 

Addentityserverjvvt 

Bu yardımcı yöntemi, varsayılan kimlik doğrulama işleyicisi olarak uygulama için bir ilke düzeni yapılandırır.ilke, 
kimlik URL 'SI alanı "/Identity" içindeki herhangi bir alt yol için tüm isteklerin kimlik işlemesini sağlamak üzere 
yapılandırılır. DwtBearerHandier diğer tüm istekleri işler. Ayrıca, bu yöntem, IdentityServer 'a 
<<Appiicationi\iame>>APi varsayılan kapsamına sahip bir <<AppiicationName>>APi API kaynağı kaydeder ve JWT 
taşıyıcı belirteç ara yazılımını, bu uygulama için IdentityServer tarafından verilen belirteçleri doğrulamak için 
yapılandırır. 

Dalgalı bir denetleyici 

Corıtrollers\dalgalı therforeroi Controller.es dosyasında, kullanıcıya kaynağa erişim için varsayılan ilkeye göre 
yetkilendirileceğini belirten sınıfa uygulanan [Authorize] özniteliğine dikkat edin. Varsayılan yetkilendirme ilkesi, 
yukarıda belirtilen ilke şemasına AddidentityServer]wt tarafından ayarlanan varsayılan kimlik doğrulama 
şemasını kullanacak şekilde yapılandırılmıştır. Bu, bu tür yardımcı yöntemi tarafından yapılandırılan 
DwtBearerHandier istekleri için varsayılan işleyicidir uygulama. 

ApplicationDbContext 

Data\applicationdbcontext.cs dosyasında, DbContext ( identityDbContext 1 den daha fazla türetilmiş bir sınıf), 
IdentityServer şemasını dahil etmek için ApiAuthorizationDbContext genişlettiği özel durum ile kimliğin aynı 
kullanıldığını görürsünüz. 



şekilde yapılandırma. 

Oıdcconfigurationcontroller 

Controllers\oLdcconfigurationcontroller.cs dosyasında, istemcinin kullanması gereken OIDC parametrelerine 
hizmeti sağlaması için sağlanan uç noktaya dikkat edin. 


















appSettings. JSON 

Proje kökünün appSettings. JSON dosyasında, yapılandırılmış istemciler listesini açıklayan yeni bir 
identityServer bölümü vardır. Aşağıdaki örnekte, tek bir istemci vardır.istemci adı, uygulama adına karşılık gelir 
ve bir kural tarafından OAuth ciientid parametresine eşlenir. Profil, yapılandırılan uygulama türünü gösterir. 
Sunucu için yapılandırma işlemini basitleştiren kuralları yönlendirmek için dahili olarak kullanılır. Uygulama 
profilleri bölümünde açıklandığı gibi çeşitli profiller mevcuttur. 

"IdentityServer": { 

"Clients": { 

"angularindividualpreview3final": { 

"Profile": "IdentityServerSPA" 

} 

} 

} 

appSettings. Development. JSON 

, AppSettings 'de. Proje kökünün geliştirme. JSON dosyası, belirteçleri imzalamak için kullanılan anahtarı açıklayan 
bir IdentityServer bölümü vardır. Üretime dağıtım yaparken, üretime dağıtma bölümünde açıklandığı gibi bir 
anahtarın uygulamayla birlikte sağlanması ve dağıtılması gerekir. 

"IdentityServer": { 

"Key": { 

"Type": "Development" 

} 

} 


Angular uygulamasının genel açıklaması 

Angular şablonundaki kimlik doğrulama ve API yetkilendirme desteği Clientapp\src\api-Authorization dizinindeki 
kendi angular modülünde yer alır. Modül aşağıdaki öğelerden oluşur: 

• 3 bileşen: 

o login. Component. TS: uygulamanın oturum açma akışını işler, 
o Logout. Component. TS: uygulamanın oturum kapatma akışını işler. 

o login-Menu. Component. TS: aşağıdaki bağlantı kümelerinden birini görüntüleyen pencere öğesi: 
o Kullanıcı profili yönetimi ve kullanıcının kimlik doğrulaması yapıldığında oturum kapatma 
bağlantıları. 

o Kullanıcının kimlik doğrulaması olmadığında kayıt ve oturum açma bağlantıları. 

• Rotalara eklenebilen ve yolu ziyaret etmeden önce kullanıcının kimliğinin doğrulanmasını gerektiren bir Route 
Guard AuthorizeGuard . 

• Kullanıcının kimlik doğrulaması yapıldığında API 'Yİ hedefleyen giden HTTP isteklerine erişim belirtecini 
ekleyen bir HTTP yakalayıcısı Authorizeinterceptor . 

• Kimlik doğrulama işleminin alt düzey ayrıntılarını işleyen ve kimliği doğrulanmış kullanıcı hakkındaki bilgileri, 
tüketim için uygulamanın geri kalanına getiren bir hizmet AuthorizeService . 

• Uygulamanın kimlik doğrulama bölümleriyle ilişkili yolları tanımlayan angular modülü. Oturum açma menü 
bileşeni, yakalayıcısı, koruyucu ve uygulamanın geri kalanından tüketim için hizmeti sunar. 

Tepki verme uygulamasının genel açıklaması 

Yanıt verme şablonunda kimlik doğrulama ve API yetkilendirmesi desteği Clientapp\src\disk api-Authorization 
dizininde bulunur. Şu öğelerden oluşur: 


• 4 bileşen: 












o Login.js: uygulamanın oturum açma akışını işler, 
o Logout.js: uygulamanın oturum kapatma akışını işler. 

o Loginmenu.js: aşağıdaki bağlantı kümelerinden birini görüntüleyen pencere öğesi: 

o Kullanıcı profili yönetimi ve kullanıcının kimlik doğrulaması yapıldığında oturum kapatma 
bağlantıları. 

o Kullanıcının kimlik doğrulaması olmadığında kayıt ve oturum açma bağlantıları, 
o Authorizeroute.js: component parametresinde belirtilen bileşeni işlemeden önce kullanıcının kimliğinin 
doğrulanmasını gerektiren bir rota bileşeni. 

• Bir AuthorizeService sınıfının dışa, kimlik doğrulama işleminin alt düzey ayrıntılarını işleyen ve kimliği 
doğrulanmış kullanıcı hakkında bilgileri, tüketim için uygulamanın geri kalanına getiren bir authservice 
örneği. 

Artık çözümün ana bileşenlerini gördüğünüze göre, uygulama için ayrı senaryolara daha ayrıntılı bir şekilde göz 
atabilirsiniz. 

Yeni bir API 'de yetkilendirme gerektir 

Varsayılan olarak, sistem yeni API 'Ler için kolayca yetkilendirme gerektirecek şekilde yapılandırılmıştır. Bunu 
yapmak için yeni bir denetleyici oluşturun ve denetleyici sınıfına veya denetleyici içindeki herhangi bir eyleme 
[Authorize] özniteliğini ekleyin. 

API kimlik doğrulama işleyicisini özelleştirme 

API 'nin JWT işleyicisinin yapılandırmasını özelleştirmek için JvvtBearerOptions örneğini yapılandırın: 

Services.AddAuthentication() 

.AddIdentityServerDwt(); 

Services.Configure<DwtBearerOptions>( 

IdentityServerivjtConstants. IdentityServeriwtBearerScheme , 
options => 

{ 

}); 

API 1 nin JWT işleyicisi, DwtBearerEvents kullanarak kimlik doğrulama işlemi üzerinde denetimi etkinleştiren olaylar 
oluşturur. API yetkilendirmesi için destek sağlamak üzere AddidentityServeriwt kendi olay işleyicilerini kaydeder. 

Bir olayın işlenmesini özelleştirmek için, var olan olay işleyicisini gereken ek mantığla sarın. Örneğin: 

Services. Configure<JwtBearerOptions>( 

IdentityServeriwtConstants. IdentityServer]wtBearerScheme, 
options => 

{ 

var onTokenValidated = options.Events.OnTokenValidated; 

options.Events.OnTokenValidated = async context => 

{ 

await onTokenValidated(context); 

} 

}); 

Önceki kodda, OnTokenValidated olay işleyicisi özel bir uygulamayla değiştirilmiştir. Bu uygulama: 

1. API yetkilendirme desteği tarafından sunulan özgün uygulamayı çağırır. 











2. Kendi özel mantığını çalıştırın. 


İstemci tarafı yolunu koruma (angular) 

istemci tarafı bir yolu korumak, yetkilendirme koruyucusu bir rota yapılandırırken çalıştırılacak korumalara 
listesine eklenerek yapılır. Örnek olarak, fetch-data yolun ana uygulama angular modülünde nasıl 
yapılandırıldığını görebilirsiniz: 

RouterModule.forRoot([ 

II ... 

{ path: 'fetch-data', component: FetchDataComponent, canActivate: [AuthorizeGuard] }, 

]) 

Bir yolu korumanın gerçek uç noktayı korumadığını (yine de buna uygulanan bir [Authorize] özniteliği 
gerektirdiğini), ancak kullanıcının kimlik doğrulaması olmadığında yalnızca belirtilen istemci tarafı rotasında 
gezinmelerini önlediği bahsetmek önemlidir. 


API isteklerinin kimliğini doğrulama (angular) 

Uygulama ile barındırılan API 'lere yönelik kimlik doğrulama istekleri, uygulama tarafından tanımlanan HTTP 
istemci yakalayıcısı kullanılarak otomatik olarak yapılır. 


İstemci tarafı yolunu koruma (tepki verme) 


Düz Route bileşeni yerine AuthorizeRoute bileşenini kullanarak bir istemci tarafı yolunu koruyun. Örneğin, 
fetch-data yolunun App bileşeni içinde nasıl yapılandırıldığı hakkında dikkat edin: 


<AuthorizeRoute path='/fetch-data' component={FetchData} /> 


Bir yolu koruma: 

• Gerçek uç noktayı korumaz (hala buna uygulanan bir [Authorize] özniteliği gerektirir). 

• Yalnızca kullanıcının kimlik doğrulaması olmadığında verilen istemci tarafı rotasında gezinmelerini engeller. 

API isteklerinin kimliğini doğrulama (tepki) 

Yanıt vererek istekleri doğrulamak, öncelikle authservice örneği AuthorizeService içeri aktararak yapılır. Erişim 
belirteci authservice alınır ve aşağıda gösterildiği gibi isteğe iliştirilir. Yanıt verme bileşenlerinde, bu iş genellikle 
componentDidMount yaşam döngüsü yönteminde veya bazı Kullanıcı etkileşiminden elde edilen sonuç olarak yapılı 

AuthService 'i bileşeninizdeki içeri aktarın 

import authservice from ’./api-authorization/AuthorizeService' 


Erişim belirtecini alma ve yanıta iliştirme 

async populateWeatherData() { 

const token = await authservice.getAccessToken(); 
const response = await fetch('api/SampleData/WeatherForecasts ', { 
headers: Itoken ? {} : { 'Authorization': 'Bearer ${token}' } 
}); 

const data = await response.json(); 
this.setState({ forecasts: data, loading: false }); 














Liretime dağıtma 

Uygulamayı üretime dağıtmak için aşağıdaki kaynakların sağlanması gerekir: 

• Kimliği kullanıcı hesaplarının ve IdentityServer 'ın verdiği bir veritabanı. 

• Belirteçleri imzalamak için kullanılacak bir üretim sertifikası. 

o Bu sertifika için belirli bir gereksinim yoktur; otomatik olarak imzalanan bir sertifika veya bir CA yetkilisi 
tarafından sağlanan bir sertifika olabilir, 
o PovverShell veya OpenSSL gibi standart araçlarla oluşturulabilir. 

o Hedef makinelerdeki sertifika deposuna yüklenebilir veya güçlü bir parolayla bir. pfx dosyası olarak 
dağıtılabilir. 

Örnek: Azure Web sitelerine dağıtma 

Bu bölümde, sertifika deposunda depolanan bir sertifika kullanılarak uygulamanın Azure Web sitelerine dağıtımı 
açıklanmaktadır. Uygulamayı sertifika deposundan bir sertifika yükleyecek şekilde değiştirmek için, daha sonraki 
bir adımda yapılandırdığınızda App Service planının en azından Standart katmanda olması gerekir. Uygulamanın 
appSettings. JSON dosyasında, IdentityServer bölümünü, anahtar ayrıntılarını içerecek şekilde değiştirin: 

"IdentityServer": { 

"Key": { 

"Type": "Store", 

"StoreName": "My'U 
"StoreLocation": "CurrentUser ", 

"Name": "CN=MyApplication" 

} 

} 

• Sertifikadaki ad özelliği, sertifikanın ayırt edici konusuna karşılık gelir. 

• Depolama konumu, sertifikanın nereden yükleneceğini ( CurrentUser veya LocaiMachine ) temsil eder. 

• Mağaza adı, sertifikanın depolandığı sertifika deposunun adını temsil eder. Bu durumda, kişisel Kullanıcı 
deposuna işaret eder. 

Azure Web siteleri 'ne dağıtmak için, gerekli Azure kaynaklarını oluşturmak ve uygulamayı üretime dağıtmak 
üzere uygulamayı Azure 'A dağıtma bölümündeki adımları izleyerek uygulamayı dağıtın. 

Yukarıdaki yönergeleri uyguladıktan sonra, uygulama Azure 'a dağıtılır ancak henüz işlevsel değildir. Uygulama 
tarafından kullanılan sertifikanın hala ayarlanması gerekiyor. Kullanılacak sertifika için parmak izini bulun ve 
sertifikalarınızı yüklemebölümünde açıklanan adımları izleyin. 

Bu adımlar SSL 'den bahsetirken portalda, uygulama ile kullanmak üzere sağlanan sertifikayı karşıya 
yükleyebileceğiniz özel sertifikalar bölümü vardır. 

Bu adımdan sonra uygulamayı yeniden başlatın ve çalışır olması gerekir. 

Diğer yapılandırma seçenekleri 

API yetkilendirmesi desteği, IdentityServer 'm en üstünde bir dizi kural, varsayılan değer ve, maça deneyimini 
basitleştirecek geliştirmeler oluşturur. Daha az ki, AS P.N ET Core tümleştirmeler senaryonuzu kapsamadıysanız, 
IdentityServer ’ın tam gücü arka planda kullanılabilir. ASP.NET Core desteği, tüm uygulamaların kuruluşumuza 
göre oluşturulduğu ve dağıtıldığı "birinci taraf" uygulamalara odaklanır. Bu nedenle, izin veya Federasyon gibi 
şeyler için destek sunulmaz. Bu senaryolar için IdentityServer kullanın ve belgelerini izleyin. 

Uygulama profilleri 

Uygulama profilleri, parametrelerini daha fazla tanımlayan uygulamalar için önceden tanımlanmış yapılandırlardır. 
Şu anda, aşağıdaki profiller desteklenir: 





• identityServerSPA : IdentityServer 1 1 n yanı sıra tek bir birim olarak barındırılan bir SPA 'yı temsil eder, 
o redirect_uri varsayılan olarak /authentication/login-callback . 

o post_logout_redirect_uri varsayılan olarak /authentication/logout-callback . 
o Kapsam kümesi, uygulamadaki API 'Ler için tanımlanan openid , profile ve tüm kapsamları içerir, 
o İzin verilen OıDC yanıt türleri kümesi tek tek id_token token veya her biri ( id_token , token ). 
o İzin verilen yanıt modu fragment . 

• spa : IdentityServer ile barındırılmayan bir SPA 'yı temsil eder. 

o Kapsam kümesi, uygulamadaki API 'Ler için tanımlanan openid , profile ve tüm kapsamları içerir, 
o İzin verilen OıDC yanıt türleri kümesi tek tek id_token token veya her biri ( id_token , token ). 
o İzin verilen yanıt modu fragment. 

• identityServeriwt : IdentityServer ile birlikte barındırılan bir API 'Yİ temsil eder. 

o Uygulama, uygulama adı için varsayılan olarak kullanılan tek bir kapsama sahip olacak şekilde 
yapılandırılmıştır. 

• api : IdentityServer ile barındırılmayan bir API 'Yİ temsil eder. 

o Uygulama, uygulama adı için varsayılan olarak kullanılan tek bir kapsama sahip olacak şekilde 
yapılandırılmıştır. 

AppSettings aracılığıyla yapılandırma 

Uygulamaları ciients veya Resources listesine ekleyerek yapılandırma sistemi aracılığıyla yapılandırın. 

Aşağıdaki örnekte gösterildiği gibi, her bir istemcinin redirect_uri ve post_iogout_redirect_uri özelliğini 
yapılandırın: 

"IdentityServer": { 

"Clients": { 

"MySPA": { 

"Profile": "SPA", 

"RedirectUri": "https://www.example.com/authentication/login-callback", 

"LogoutUri": "https://www.example.com/authentication/logout-callback" 

} 

} 

} 

Kaynakları yapılandırırken, kaynak için kapsamları aşağıda gösterildiği gibi yapılandırabilirsiniz: 

"IdentityServer": { 

"Resources": { 

"MyExternalApi": { 

"Profile": "API", 

"Scopes": "a b c" 

} 

} 

} 

Kod aracılığıyla yapılandırma 

Ayrıca, seçenekleri yapılandırmak için bir eylem alan AddApiAuthorization aşırı yüklemesini kullanarak, istemcileri 
ve kaynakları kod aracılığıyla da yapılandırabilirsiniz. 



















AddApiAuthorization<ApplicationUser, ApplicationDbContext>(options => 

{ 

options.Clients.AddSPA( 

"My SPA", spa => 

spa.WithRedirectUri(" http://www.example.com/authentication/login-callback") 
.WithLogoutRedirectUri( 

"http://www.example.com/authentication/logout-callback")); 

options.ApiResources.AddApiResource("MyExternalApi", nesounce => 
resource.WithScopes("a", "b", "c")); 

}); 


Ek kaynaklar 

• Angular proje şablonunu ASP.NET Core ile kullanma 

• ASP.NET Core ile tepki verme proje şablonunu kullanın 

• AS P.N ET Core projelerinde yapı iskelesi kimliği 



ASRNET Core projelerinde yapı iskelesi kimliği 
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Rick Anderson tarafından 

ASP.N ET Core 2,1 ve üzeri, Razor sınıf kitaplığı olarak ASP.NET Core kimliği sağlar. Kimlik içeren uygulamalar, 
Identity Razor sınıf kitaplığı ’nda (RCL) bulunan kaynak kodu seçmeli olarak eklemek için desteği 'ı 
uygulayabilir. Kodu değiştirebilmeniz ve davranışı değiştirebilmek için kaynak kodu oluşturmak isteyebilirsiniz. 
Örneğin, kayıt sırasında kullanılan kodu oluşturmak için desteği 1 ı söyleyebilirsiniz. Oluşturulan kod, RCL 
kimliği içindeki aynı koddan önceliklidir. Kullanıcı arabirimine tam denetim sağlamak ve varsayılan RCL 'yi 
kullanmak için, tam KİMLİK Ul kaynağı oluşturmabölümüne bakın. 

Kimlik doğrulaması içermeyen uygulamalar , RCL kimlik paketini eklemek için desteği uygulayabilir. 
Oluşturulacak kimlik kodunu seçme seçeneğiniz vardır. 

Desteği gerekli kodların çoğunu üretse de, işlemi gerçekleştirmek için projenizi güncelleştirmeniz gerekir. Bu 
belgede, bir kimlik yapı iskelesi güncelleştirmesini tamamlaması için gereken adımlar açıklanmaktadır. 

Identity desteği çalıştırıldığında, proje dizininde bir scaffoldingreadme. txt dosyası oluşturulur. 
Scaffoldingreadme. txt dosyası, kimlik yapı iskelesi güncelleştirmesinin tamamlanabilmesi için gerekli olan 
genel yönergeleri içerir. Bu belge, Scaffoldingreadme. txt dosyasından daha eksiksiz yönergeler içerir. 

Dosya farklılıklarını gösteren ve değişikliklerden geri dönüş yapmanızı sağlayan bir kaynak denetimi sistemi 
kullanmanızı öneririz. Kimlik scaffolder T çalıştırdıktan sonra değişiklikleri inceleyin. 


NOTE 

İki öğeli kimlik doğrulaması, Hesap onaylama ve parola kurtarmave kimlik ile diğer güvenlik özellikleri kullanılırken 
hizmetler gereklidir. Hizmet veya hizmet saplamaları, kimliğe iskele oluştururken oluşturulmaz. Bu özelliklerin 
etkinleştirilmesi için hizmetlerin el ile eklenmesi gerekir. Örneğin, bkz. e-posta onayı gerektir. 


Boş bir projede yapı iskelesi kimliği 

Identity scaffolder öğesini çalıştırın: 

• Visual Studio 

• .NET Core CLI 

• Gelen Çözüm Gezgini, projeye sağ tıklayın > Ekle > yeni iskele kurulmuş öğe. 

• Sol bölmeden İskele Ekle iletişim kutusunda kimlik > ekleme. 

• Kimlik Ekle iletişim kutusunda istediğiniz seçenekleri belirleyin. 

o Var olan düzen sayfanızı seçin veya Düzen dosyanızın üzerine yanlış biçimlendirme uygulanır. 
Örneğin ~/Pages/Shared/_Layout.cshtml , MVC projeleri ~/Views/Shared/_Layout.cshtml için Razor 
Pages 

o Seçin + yeni bir düğme veri bağlamı sınıfının. 

• Seçin ekleme. 

Aşağıdaki Vurgulanan çağrıları startup sınıfına ekleyin: 







public class Startup 
{ 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services .AddMvc(); 

} 

// This method gets called by the runtime. Use this method to configure the HTTP request pipeline. 
public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 
app.UseAuthentication(); 
app.UseMvc(); 

} 

} 

useHsts önerilir ancak gerekli değildir. Bkz: HTTP katı Aktarım güvenlik protokolü daha fazla bilgi için. 

Oluşturulan kimlik veritabanı kodu Entity Framevvork Core geçişlerigerektirir. Bir geçiş oluşturmak ve 
veritabanı güncelleştirin. Örneğin, aşağıdaki komutları çalıştırın: 

• Visual Studio 

• .NET Core CU 

Visual Studio Paket Yöneticisi Konsolu: 

Add-Migration CreateldentitySchema 
Update-Database 

Add-Migration Komut için "createıdentityschema" ad parametresi rastgele. "CreateldentitySchema" geçişi 
açıklar. 

Mevcut yetkilendirme olmadan bir Razor projesinde kimlik oluşturma 
kimliği 

Identity scaffolder öğesini çalıştırın: 

• Visual Studio 

• .NET Core CLI 

• Gelen Çözüm Gezgini, projeye sağ tıklayın > Ekle > yeni iskele kurulmuş öğe. 

• Sol bölmeden İskele Ekle iletişim kutusunda kimlik > ekleme. 

• Kimlik Ekle iletişim kutusunda istediğiniz seçenekleri belirleyin. 

o Var olan düzen sayfanızı seçin veya Düzen dosyanızın üzerine yanlış biçimlendirme uygulanır. 

Örneğin ~/Pages/Shared/_Layout.cshtml , MVC projeleri ~/Views/Shared/_Layout.cshtml için Razor 
Pages 

o Seçin + yeni bir düğme veri bağlamı sınıfının. 

• Seçin ekleme. 




Kimlik, /kimlik/Ldentityhostingstartup. cs o/an/orındoyapılandırılır. daha fazla bilgi için bkz. ıhostingstartup. 

Geçişler, UseAuthentication ve düzen 

Oluşturulan kimlik veritabanı kodu Entity Framevvork Core geçişlerigerektirir. Bir geçiş oluşturmak ve 
veritabanı güncelleştirin. Örneğin, aşağıdaki komutları çalıştırın: 

• Visual Studio 

• .NET Core CU 

Visual Studio Paket Yöneticisi Konsolu: 


Add-Migration CreateldentitySchema 
Update-Database 


Add-Migration Komut için "createıdentityschema" ad parametresi rastgele. "CreateldentitySchema" geçişi 
açıklar. 

Kimlik doğrulamasını etkinleştir 

startup sınıfının configure yönteminde usestaticFiles sonra UseAuthentication ' ı çağırın: 


public class Startup 
{ 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services .AddMvc(); 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 
{ 

if (env.IsDevelopmentO) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 
app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 
app.UseAuthentication(); 

app.UseMvc(); 

} 

} 


useHsts önerilir ancak gerekli değildir. Bkz: HTTP katı Aktarım güvenlik protokolü daha fazla bilgi için. 

Düzen değişiklikleri 

İsteğe bağlı: ( _LoginPartiai ) oturum açma bölümünü düzen dosyasına ekleyin: 

<!DOCTYPE html> 

<html> 






<head> 


<meta charset="utf-8" /> 

<meta name="viewport" content="width=device-width., initial-scale=1.0" /> 

<title>@ViewData["Title"] - RazorNoAuth8</title> 

<environment include="Development"> 

<link rel="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.css" /> 

<link rel="stylesheet" href="~/css/site.css" /> 

</environment> 

<environment exclude="Development"> 
clink rel="stylesheet" 

href=" https://ajax.aspnetcdn.eom/ajax/bootstnap/3.3.7/css/bootstnap.min.es s" 
asp-fallback-href="~/lib/bootstrap/dist/css/bootstrap.min.css" 

asp-fallback-test-class="sr-only" asp-fallback-test-property="position" asp-fallback-test- 
value="absolute" /> 

<link rel="stylesheet" href="~/css/site.min.css" asp-append-version="true" /> 

</environment> 

</head> 

<body> 

<nav class="navbar navbar-inverse navbar-fixed-top"> 

<div class="container"> 

<div class="navbar-header"> 

<button type=''button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar- 

collapse"> 

<span class="sr-only">Toggle navigation</span> 

<span class="icon-bar"x/span> 

<span class="icon-bar"x/span> 

<span class="icon-bar"x/span> 

</button> 

<a asp-page="/Index" class="navbar-brand">RazorNoAuth8</a> 

</div> 

<div class="navbar-collapse collapse"> 

<ul class="nav navbar-nav"> 

<lixa asp-page="/Index">Home</ax/li> 

<lixa asp-page="/About">About</ax/li> 

<lixa asp-page="/Contact">Contact</ax/li> 

</ul> 

<partial name="_LoginPartial" /> 

</div> 

</div> 

</nav> 

<partial name="_CookieConsentPartial" /> 

<div class="container body-content"> 

@RenderBody() 

<hr /> 

<footer> 

<p>&copy; 2018 - RazorNoAuth8</p> 

</footer> 

</div> 

<environment include="Development"> 

<script src="~/lib/jquery/dist/jquery. js"x/script> 

<script src="~/lib/bootstrap/dİst/ js/bootstrap. js"x/script> 

<script src="~/js/site,js" asp-append-version="true"x/script> 

</environment> 

<environment exclude="Development"> 

<script src=" https://ajax.aspnetcdn.eom/ajax/jquery/jquery-3.3.l.min.j s" 
asp-fallback-src="~/lib/jquery/dist/jquery.min.js" 
asp-fallback-test="window.jQuery" 
crossorigin="anonymous" 

integrity="sha384-K+ctZQ+LL8q6tP7I94W+qzQsfRV2a+AfHIi9k8z819ggpc8X+Ytst4yBo/hH+8Fk"> 

</script> 

<script src=" https://ajax.aspnetcdn.eom/ajax/bootstrap/3.3.7/bootstrap.min.j s" 
asp-fallback-src="~/lib/bootstrap/dist/js/bootstrap.min.js" 

asp-fallback-test="window.jQuery && window.jQuery.fn && window.jQuery.fn.modal" 
crossorigin="anonymous" 

ı _TVSTni hC07rn/\/H CM-fUl HflMa I L--f=ı ıl.l\/v7vl IDn( I A"71 OmCUlM T n^Ûm^mSı.ı^MT rDn7Tva"\ 




v_ııyıuu^f bj v y j 




</script> 

cscript src="~/js/site.min.js" asp-append-vension="true"x/script> 
</environment> 

@RenderSection("Scripts", required: false) 

</body> 

</html> 


Yetkilendirmeyi içeren bir Razor projesinde kimlik oluşturma kimliği 

Identity scaffolder öğesini çalıştırın: 

• Visuai Studio 

• .NETCoreCLI 

• Çözüm Gezgini, projeye sağ tıklayıp Yeni > I ski i öğe ekleyin >. 

• Yapı İskelesi Ekle iletişim kutusunun sol bölmesinde kimlik > Ekle' yi seçin. 

• Kimlik Ekle iletişim kutusunda istediğiniz seçenekleri belirleyin. 

o Var olan düzen sayfanızı seçin veya Düzen dosyanızın üzerine yanlış biçimlendirme uygulanır. 

Varolan bir _Layout. cshtml dosyası seçildiğinde, üzerine yazılmaz. 

Örneğin: MVC projeleri için Razor Pages ~/Views/Shared/_Layout.cshtml ~/Pages/Shared/_layout.cshtml 

• Mevcut veri bağlamınızı kullanmak için, geçersiz kılmak üzere en az bir dosya seçin. Veri bağlamınızı 
eklemek için en az bir dosya seçmeniz gerekir. 

o Veri bağlamı sınıfınızı seçin, 
o Ekle' yi seçin. 

• Yeni bir kullanıcı bağlamı oluşturmak ve muhtemelen kimlik için özel bir Kullanıcı sınıfı oluşturmak için: 
o Yeni bir veri bağlamı sımfıoluşturmak için + düğmesini seçin. 

o Ekle' yi seçin. 

Note: yeni bir kullanıcı bağlamı oluşturuyorsanız, geçersiz kılmak için bir dosya seçmeniz gerekmez. 

Bazı kimlik seçenekleri /Identity/Ldentityhostingstartup. cs alanlarmda yapılandırılır, daha fazla bilgi için bkz. 
ıhostingstartup. 

Var olan yetkilendirme olmadan bir MVC projesinde kimlik oluşturma 
kimliği 

Identity scaffolder öğesini çalıştırın: 

• Visuai Studio 

• .NETCoreCLI 

• Gelen Çözüm Gezgini, projeye sağ tıklayın > Ekle > yeni iskele kurulmuş öğe. 

• Sol bölmeden İskele Ekle iletişim kutusunda kimlik > ekleme. 

• Kimlik Ekle iletişim kutusunda istediğiniz seçenekleri belirleyin. 

o Var olan düzen sayfanızı seçin veya Düzen dosyanızın üzerine yanlış biçimlendirme uygulanır. 

Örneğin ~/Pages/Shared/_Layout.cshtml , MVC projeleri ~/Views/Shared/_Layout.cshtml için Razor 
Pages 

o Seçin + yeni bir düğme veri bağlamı sınıfının. 

• Seçin ekleme. 

İsteğe bağlı: görünümleri/paylaşdan/_Layout. cshtml dosyasına ( _LoginPartiai ) oturum açma kısmını ekleyin: 







<!DOCTYPE html> 

<html> 

<head> 

<meta charset="utf-8" /> 

<meta name="viewport" content="width=device-width., initial-scale=1.0" /> 

<title>@ViewData["Title"] - MvcNoAuth3</title> 

<environment include="Development"> 

<link rel="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.css" /> 

<link rel="stylesheet" href="~/css/site.css" /> 

</environment> 

<environment exclude="Development"> 
clink rel="stylesheet" 

href=" https://ajax.aspnetcdn.eom/ajax/bootstnap/3.3.7/css/bootstnap.min.es s" 
asp-fallback-href="~/lib/bootstrap/dist/css/bootstrap.min.css" 

asp-fallback-test-class="sn-only" asp-fallback-test-property="position" asp-fallback-test 
value="absolute" /> 

<link nel="stylesheet" href="~/css/site.min.css" asp-append-vension="true" /> 

</envinonment> 

</head> 

<body> 

<nav class="navbar navbar-inverse navbar-fixed-top"> 

<div class="container"> 

<div class="navbar-header"> 

<button type="button" class="navban-toggle" data-toggle="collapse" data-target=".navbar 

collapse"> 

<span class="sr-only">Toggle navigation</span> 

<span class="icon-bar"x/span> 

<span class="icon-bar"x/span> 

<span class="icon-ban"x/span> 

</button> 

<a asp-area="" asp-controller="Home" asp-action="Index" class="navban- 
brand">MvcNoAuth3</a> 

</div> 

<div class="navbar-collapse collapse"> 

<ul class="nav navbar-nav"> 

<lixa asp-area="" asp-controller="Home" asp-action="Index">Home</ax/li> 

<lixa asp-area="" asp-controller="Home" asp-action="About">About</ax/li> 

<lixa asp-area="" asp-controller="Home" asp-action="Contact">Contact</ax/li> 

</ul> 

<partial name="_LoginPartial" /> 

</div> 

</div> 

</nav> 

<partial name="_CookieConsentPartial" /> 

<div class="container body-content"> 

@RenderBody() 

<hr /> 

<footen> 

<p>&copy; 2018 - MvcNoAuth3</p> 

</footer> 

</div> 

<environment include="Development"> 

<script src="~/lib/jquery/dist/jquery. js"x/script> 

<script src="~/lib/bootst rap/d İst/ js/bootstrap. js"x/script> 

<script src="~/js/site.js" asp-append-version="true"x/script> 

</envinonment> 

<environment exclude="Development"> 

<script src=" https://ajax.aspnetcdn.eom/ajax/jquery/jqueny-3.3.l.min.j s" 
asp-fallback-src="~/lib/jquery/dist/jquery.min.js" 
asp-fallback-test="window.jQuery" 
crossorigin="anonymous" 

integrity="sha384-K+ctZQ+LL8q6tP7I94W+qzQsfRV2a+AfHIi9k8z819ggpc8X+Ytst4yBo/hH+8Fk"> 
</script> 

<script src=" https://ajax.aspnetcdn.eom/ajax/bootstrap/3.3.7/bootstrap.min.j s" 


asp-fallback-src="~/lib/bootstrap/dist/js/bootstrap.min.js" 

asp-fallback-test="window.jQuery && window.jQuery.fn && window.jQuery.fn.modal" 
crossorigin="anonymous" 

integrity="sha384-Tc5IQİb027qvyjSMfHjOMaLkfuWVxZxUPnCDA712mCWNIpG9mGCD8wGNIcPD7Txa"> 
</script> 

<script src="~/js/site.min.js" asp-append-version="true"x/script> 

</environment> 

@RenderSection("Scripts", required: false) 

</body> 

</html> 


• Pages/Shared/_LoginPartial. cshtml dosyasını views/Shared/_loginpartial. cshtml dosyasına taşıyın 

Kimlik, /kimlik/Ldentityhostingstartup. cs o/an/orındoyapılandırılır. Daha fazla bilgi için bkz. ıhostingstartup. 

Oluşturulan kimlik veritabanı kodu Entity Framevvork Core geçişlerigerektirir. Bir geçiş oluşturmak ve 
veritabanı güncelleştirin. Örneğin, aşağıdaki komutları çalıştırın: 

• Visual Studio 

• .NET Core CU 

Visual Studio Paket Yöneticisi Konsolu: 


Add-Migration CreateldentitySchema 
Update-Database 

Add-Migration Komut için "createıdentityschema" ad parametresi rastgele. "CreateldentitySchema" geçişi 
açıklar. 

usestaticFiles sonra UseAuthentication ’ı çağır: 

public class Startup 

{ 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddMvc(); 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopmentO) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Home/Error"); 
app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 
app.UseAuthentication(); 
app.UseMvcWithDefaultRoute(); 

} 

} 


useHsts önerilir ancak gerekli değildir. Bkz: HTTP katı Aktarım güvenlik protokolü daha fazla bilgi için. 


Yetkilendirmeyi içeren bir MVC projesinde kimlik oluşturma kimliği 

Identity scaffolder öğesini çalıştırın: 

• Visual Studio 

• .NETCoreCLI 

• Çözüm Gezgini, projeye sağ tıklayıp Yeni > I ski i öğe ekleyin >. 

• Yapı İskelesi Ekle iletişim kutusunun sol bölmesinde kimlik > Ekle' yi seçin. 

• Kimlik Ekle iletişim kutusunda istediğiniz seçenekleri belirleyin. 

o Var olan düzen sayfanızı seçin veya Düzen dosyanızın üzerine yanlış biçimlendirme uygulanır. 

Varolan bir _Layout. cshtml dosyası seçildiğinde, üzerine yazılmaz. 

Örneğin: MVC projeleri için Razor Pages ~/Views/Shared/_Layout.cshtml ~/Pages/Shared/_Layout.cshtml 

• Mevcut veri bağlamınızı kullanmak için, geçersiz kılmak üzere en az bir dosya seçin. Veri bağlamınızı 
eklemek için en az bir dosya seçmeniz gerekir. 

o Veri bağlamı sınıfınızı seçin, 
o Ekle' yi seçin. 

• Yeni bir kullanıcı bağlamı oluşturmak ve muhtemelen kimlik için özel bir Kullanıcı sınıfı oluşturmak için: 
o Yeni bir veri bağlamı sımfıoluşturmak için + düğmesini seçin. 

o Ekle' yi seçin. 

Note: yeni bir kullanıcı bağlamı oluşturuyorsanız, geçersiz kılmak için bir dosya seçmeniz gerekmez. 
SayfalarL/paylaşılan klasörünü ve bu klasördeki dosyaları silin. 

Tam kimlik Ul kaynağı oluşturma 

Kimlik Kullanıcı arabirimine tam denetim sağlamak için, Identity desteği 1 1 çalıştırın ve tüm dosyaları 
geçersiz kıl 1 ı seçin. 

Aşağıdaki Vurgulanan kodda, varsayılan kimlik Kullanıcı arabirimini ASP.NET Core 2,1 Web uygulamasındaki 
kimlikle değiştirme değişiklikleri gösterilmektedir. Bunu, kimlik Kullanıcı arabirimine tam denetim sağlamak 
için yapmak isteyebilirsiniz. 




public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 

Services.AddldentitycIdentityUser, IdentityRole>() 

// Services.AddDefaultIdentity<IdentityUser>() 

.AddEntityFrameworkStores<ApplicationDbContext>() 

.AddDefaultTokenProviders(); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_l) 

.AddRazorPagesOptions(options => 

{ 

options.AllowAreas = true; 

options.Conventions.AuthorizeAreaFolder("Identity", "/Account/Manage") 
options.Conventions.AuthorizeAreaPage("Identity", "/Account/Logout"); 

}); 

Services .ConfigureApplicationCookie(options => 

{ 

options.LoginPath = $"/Identity/Account/Login"; 

options.LogoutPath = $"/Identity/Account/Logout"; 

options.AccessDeniedPath = $"/Identity/Account/AccessDenied"; 

}); 

// using Microsoft.AspNetCore.Identity.UI.Services; 

Services.AddSingleton<IEmailSender, EmailSender>(); 


Varsayılan kimlik aşağıdaki kodda değiştirilmiştir: 

Services.Addldentitycldentityllser, IdentityRole>() 

// Services.AddDefaultIdentity<IdentityUser>() 

.AddEntityFrameworkStores<ApplicationDbContext>() 
.AddDefaultTokenProviders(); 


Aşağıdaki kod, Loginpath, Logoutpathve AccessDeniedPathöğesini ayarlar: 

Services.ConfigureApplicationCookie(options => 

{ 

options.LoginPath = $"/Identity/Account/Login"; 

options.LogoutPath = $"/Identity/Account/Logout"; 

options.AccessDeniedPath = $"/Identity/Account/AccessDenied"; 

}); 

Bir iEmaiisender uygulamasını kaydedin, örneğin: 


// using Microsoft.AspNetCore.Identity.UI.Services; 
Services.AddSingleton<IEmailSender, EmailSender>(); 







public class EmailSender : IEmailSender 

{ 

public Task SendEmailAsync(string email, string subject, string message) 

{ 

return Task.CompletedTask; 

} 

} 


Kayıt sayfasını devre dışı bırak 

Kullanıcı kaydını devre dışı bırakmak için: 

• Yapı iskelesi kimliği. Account. Register, Account Login ve account. RegisterConfirmation bilgilerini 
ekleyin. Örneğin: 

dotnet aspnet-codegenerator identity -dc RPauth.Data.ApplicationDbContext --fileş 
"Account.Register;Account.Login;Account.RegisterConfirmation" 

• Kullanıcıları bu uç noktadan kaydedememesi için alan/kimlik/sayfa/hesap/kayıt. cshtml. cs 'yi 
güncelleştirin: 

public class RegisterModel : PageModel 

{ 

public IActionResult OnGet() 

{ 

return RedirectToPage("Login"); 

} 

public IActionResult OnPost() 

{ 

return RedirectToPage("Login"); 

} 

} 

• Önceki değişikliklerle tutarlı olması için alan/kimlik/sayfa/hesap/kayıt. cshtml 'yi güncelleştirin: 

@page 

@model RegisterModel 

@{ 

ViewData["Title"] = "Go to Login"; 

} 

<hl>@ViewData["Title"]</hl> 

<li class="nav-item"> 

<a class="nav-link text-dark" asp-area="Identity" asp-page="/Account/Login">Login</a> 
</li> 


• Alan/kimlik/sayfa/hesap/Login. cshtml 'den kayıt bağlantısını açıklama veya kaldırma 




<p> 

<a asp-page="./Register" asp-route-returnUrl="@Model.ReturnUrl">Register as a new user</a> 

</p> 


• Bölgeler/kimlik/sayfalar/hesap/RegisterConfirmation sayfasını güncelleştirin. 







o Cshtml dosyasındaki kodu ve bağlantıları kaldırın, 
o pageModei onay kodunu kaldırın: 

[AllowAnonymous] 

public class RegisterConfirmationModel : PageModei 
{ 

public IActionResult OnGet() 

{ 

return Page(); 

} 

} 

Kullanıcıları eklemek için başka bir uygulama kullanma 

Web uygulaması dışındaki kullanıcıları eklemek için bir mekanizma sağlar. Kullanıcı ekleme seçenekleri 
şunlardır: 

• Adanmış bir yönetim Web uygulaması. 

• Bir konsol uygulaması. 

Aşağıdaki kod, kullanıcı eklemeye yönelik bir yaklaşımı özetler: 

• Kullanıcıların listesi belleği okur. 

• Her Kullanıcı için güçlü bir benzersiz parola oluşturulur. 

• Kullanıcı, kimlik veritabanına eklenir. 

• Kullanıcıya bildirilir ve parolayı değiştirmesi bildirilir. 




public class Program 

{ 

public static void Main(string[] args) 

{ 

var hoşt = CreateHostBuilder(args).Build(); 

using (var scope = hoşt.Services.CreateScope()) 

{ 

var Services = scope.ServiceProvider; 

try 

{ 

var context = Services.GetRequiredService<AppDbCntx>(); 
context.Database.Migrate(); 

var config = hoşt.Services.GetRequiredService<IConfiguration>(); 
var userList = config.GetSection("userList").Get<List<string>>() 

SeedData.Initialize(services, userList).Wait(); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<ILogger<Program>>(); 
logger.LogError(ex, "An error occurred adding users."); 

} 

} 

host.Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 


Aşağıdaki kod, bir kullanıcı ekleme ana hatlarıyla verilmiştir: 



public static async Task Initialize(IServiceProvider serviceProvider, 

List<string> userList) 


{ 

var userManager = serviceProvider.GetService<UserManager<Identityllser>>(); 


foreach (var userName in userList) 

{ 

var userPassword = GenerateSecurePassword(); 

var userld = await Ensurellser(userManager, userName, userPassword); 


} 


Notifyllser(userName, userPassword); 

} 


private static async Task<string> EnsureUser(UserManager<Identityllser> userManager, 

string userName, string userPassword) 


{ 


var user = await userManager.FindByNameAsync(userName); 


if (user == null) 

{ 

user = new IdentityUser(userName) 

{ 

EmailConfirmed = true 

}; 

await userManager.CreateAsync(user, userPassword); 


return user.Id; 

} 


Üretim senaryolarında de benzer bir yaklaşım izlenebilir. 


Ek kaynaklar 

• ASP.NET Core 2,1 ve üzeri kimlik doğrulama kodundaki değişiklikler 



Ekleme, indirmek ve kimlik için bir ASPNET Core 
projesi özel kullanıcı verilerini silme 

6.12.2019 • 15 minutes to read^ Edit Online 


Tarafından Rick Anderson 

Bu makale nasıl yapılır: 

• AS P.N ET Core web uygulaması için özel kullanıcı verilerini ekleyin. 

• Özel Kullanıcı veri modelini PersonalDataAttribute özniteliğiyle işaretleyin, bu nedenle otomatik olarak 
indirilebilir ve silinirler. Verileri silinir ve indirilen mümkün hale yardımcı karşılamak GDPR gereksinimleri. 

Bir Razor sayfaları web uygulaması proje örneği oluşturulur, ancak yönergeleri AS P.N ET Core M VC web 
uygulaması için benzerdir. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Prerequisites 

.NET Core 3,0 SDK veya üzeri 
.NET core 2.2 SDK veya üzeri 

Razor web uygulaması oluşturma 

• Visual Studio 

• .NET Core CLI 

• Visual Studio'dan dosya menüsünde yeni > proje. Projeyi adlandırın VVebAppl için istiyorsanız ad alanı 
eşleşen örneği indirin kod. 

• ASP.NET Core Web uygulaması > Tamam ‘ı seçin 

• Açılan listede ASP.NET Core 3,0 1 i seçin 

• Web uygulaması > Tamam 'ı seçin 

• Derleme ve projeyi çalıştırın. 

• Visual Studio'dan dosya menüsünde yeni > proje. Projeyi adlandırın VVebAppl için istiyorsanız ad alanı 
eşleşen örneği indirin kod. 

• ASP.NET Core VVeb uygulaması > Tamam ’ı seçin 

• Açılan listedeASP.NET Core 2,2 1 i seçin 

• VVeb uygulaması > Tamam 'ı seçin 

• Derleme ve projeyi çalıştırın. 

Kimlik iskele kurucu çalıştırın 

• Visual Studio 

• .NET Core CLI 

• Gelen Çözüm Gezgini, projeye sağ tıklayın > Ekle > yeni iskele kurulmuş öğe. 

• Sol bölmeden İskele Ekle iletişim kutusunda kimlik > ekleme. 

• içinde ADD kimliğini iletişim kutusunda, aşağıdaki seçenekleri: 




o Varolan bir düzen dosyası seçin ~/Pages/Shared/_Layout.cshtml 
o Aşağıdaki dosyalar geçersiz kılmak için seçin: 

o Hesabı/kaydı 
o Hesabı/yönetmek/dizin 

o Seçin + yeni bir düğme veri bağlamı sınıfının. Tür kabul et (WebApp1.Models.WebApp1Context 

proje adlandırılmışsa VVebAppl). 

o Seçin + yeni bir düğme kullanıcı sınıfı. Tür kabul et (VVebApplUser proje adlandırılmışsa VVebAppl) 
> Ekle. 

• Seçin ekleme. 

Verilen yönergeleri izleyin düzeni geçişleri ve UseAuthentication aşağıdaki adımları gerçekleştirmek için: 


• Bir geçiş oluşturmak ve veritabanı güncelleştirin. 



• Uygulamayı test edin: 
o Bir kullanıcı kaydı 

o Yeni kullanıcı adını seçin (yanındaki oturum kapatma bağlantı). Penceresini genişletin veya kullanıcı adı 
ve diğer bağlantıları göstermek için gezinti çubuğu simgesini gerekebilir, 
o Seçin kişisel verileri sekmesi. 

o Seçin indirme düğmesine tıklayın ve denetlenen PersonalData.json dosya, 
o Test Sil düğmesi, oturum açmış kullanıcıyı siler. 

Özel kullanıcı verilerini kimlik Veritabanına Ekle 

Güncelleştirme identityuser türetilmiş sınıf özel özelliklere sahip.' % S'proje VVebAppl adlı, dosyanın nasıl 
adlandırıldığı Areas/lderıtity/Data/WebApp1 User.cs. Dosya, aşağıdaki kod ile güncelleştirin: 

using System; 

using Microsoft.AspNetCore.Identity; 

namespace WebAppl.Areas.Identity.Data 
{ 

public class NebApplUser : Identityllser 
{ 

[PersonalData] 

public string Name { get; set; } 

[PersonalData] 

public DateTime DOB { get; set; } 

} 

} 


using Microsoft.AspNetCore.Identity; 
using System; 

namespace WebAppl.Areas.Identity.Data 
{ 

public class NebApplUser : Identityllser 
{ 

[PersonalData] 

public string Name { get; set; } 
[PersonalData] 

public DateTime DOB { get; set; } 

} 

} 







Personal Data özniteliğiyle birlikte bulunan özellikler şunlardır: 


• Ne zaman silinmiş Areas/ldentity/Pages/Account/Manage/DeletePersorıalData.cshtml Razor sayfası çağırır 

UserManager.Delete . 

• Tarafından yüklenen veriler dahil Areas/ldentity/Pages/Account/Manage/DownloadPersonalData.cshtml 
Razor sayfası. 

Account/Manage/lndex.cshtml sayfası 

Güncelleştirme inputModei içinde Areas/ldentity/Pages/Account/Manage/lrıdex.cshtml.cs aşağıdaki vurgulanmış 
kodu: 


public partial class IndexModel : PageModel 

{ 

private readonly UserManager<WebApplUser> _userManager; 
private readonly SignInManager<WebApplUser> _signInManager; 

public IndexModel( 

UserManager<WebApplUser> userManager, 

SignInManager<WebApplUser> signlnManager) 

{ 

_userManager = userManager; 

_signInManager = signlnManager; 

} 

public string Username { get; set; } 

[TempData] 

public string StatusMessage { get; set; } 

[BindProperty] 

public InputModel Input { get; set; } 

public class InputModel 

{ 

[Required] 

[DataType(DataType.Text)] 

[Display(Name = "Full name")] 
public string Name { get; set; } 

[Required] 

[Display(Name = "Birth Date")] 

[DataType(DataType.Date)] 
public DateTime DOB { get; set; } 

[Phone] 

[Display(Name = "Phone number")] 
public string PhoneNumber { get; set; } 

} 

private async Task LoadAsync(WebApplUser user) 

{ 

var userName = await _userManager.GetUserNameAsync(user); 
var phoneNumber = await _userManager.GetPhoneNumberAsync(user); 

Username = userName; 

Input = new InputModel 

{ 

Name = user.Name, 

DOB = user.DOB, 

PhoneNumber = phoneNumber 

}; 

} 

public async Task<IActionResult> OnGetAsync() 




var user = await _userManager.GetUserAsync(User); 
if (user == null) 

{ 

return NotFound( 

$"Unable to load user with ID '{_userManager.GetUserId(User)}'."); 

} 

await LoadAsync(user); 
return Page(); 

} 

public async Task<IActionResult> OnPostAsync() 

{ 

var user = await _userManager.GetUserAsync(User); 
if (user == null) 

{ 

return NotFound( 

$"Unable to load user with ID '{_userManager.GetUserId(User)}'."); 

} 

if (IModelState.IsValid) 

{ 

await LoadAsync(user); 
return Page(); 

} 

var phoneNumber = await _userManager.GetPhoneNumberAsync(user); 
if (Input.PhoneNumber != phoneNumber) 

{ 

var setPhoneResult = await _userManager.SetPhoneNumberAsync(user, 

Input.PhoneNumber); 

if (!setPhoneResult.Succeeded) 

{ 

var userld = await _userManager.GetUserIdAsync(user); 
throw new InvalidOperationException( 

$"Unexpected error occurred setting phone number for user with ID '{userld}'."); 

} 

} 

if (Input.Name != user.Name) 

{ 

user.Name = Input.Name; 

} 

if (Input.DOB != user.DOB) 

{ 

user.DOB = Input.DOB; 

} 

await _userManager.UpdateAsync(user); 

await _signInManager.RefreshSignlnAsync(user); 

StatusMessage = "Your profile has been updated"; 
return RedirectToPage(); 

} 

} 


Güncelleştirme Areas/ldentity/Pages/Account/Manage/lrıdex.cshtml aşağıdaki vurgulanmış biçimlendirmeye 
sahip: 


@page 

@model IndexModel 

@{ 

ViewData["Title"] = "Profile"; 

ViewData["ActivePage"] = ManageNavPages.Index; 

} 

ch4>@ViewData["Title"]c/h4> 

<partial name="_StatusMessage" model="Model.StatusMessage" /> 

<div class="row"> 

<div class="col-md-6"> 

<form id="profile-form" method="post"> 

<div asp-validation-summary="All" class="text-danger"x/div> 
<div class="form-group"> 

<label asp-for="Username"x/label> 

cinput asp-for="Username" class="form-control" disabled /> 
</div> 

<div class="form-group"> 

<label asp-for="Input. Name"x/label> 

<input asp-for="Input.Name" class="form-control" /> 

</div> 

<div class="form-group"> 

<label asp-for="Input .DOB"x/label> 

cinput asp-for="Input.DOB" class="form-control" /> 

</div> 

cdiv class="form-group"> 

clabel asp-for="Input. Phonel\lumber"x/label> 
cinput asp-for="Input.PhoneNumber" class="form-control" /> 
cspan asp-validation-for="Input.PhoneNumber" 
class="text-danger"x/span> 

c/div> 

cbutton id="update-profile-button" type="submit" 
class="btn btn-primary">Savec/button> 

c/form> 

c/div> 

c/div> 

@section Scripts { 

cpartial name="_ValidationScriptsPartial" /> 

} 


public partial class IndexModel : PageModel 

{ 

private readonly UserManagercWebApplUser> _userManager; 
private readonly SignInManagercWebApplUser> _signInManager; 
private readonly IEmailSender _emailSender; 

public IndexModel( 

UserManagercWebApplUser> userManager, 
SignInManagercWebApplUser> signlnManager, 

IEmailSender emailSender) 

{ 

_userManager = userManager; 

_signInManager = signlnManager; 

_emailSender = emailSender; 

} 

public string Username { get; set; } 
public bool IsEmailConfirmed { get; set; } 

[TempData] 

public string StatusMessage { get; set; } 

[BindProperty] 

public InputModel Input { get; set; } 


public class InputModel 

{ 

[Required] 

[DataType(DataType.Text)] 

[Display(Name = "Full name")] 
public string Name { get; set; } 

[Required] 

[Display(Name = "Birth Date")] 

[DataType(DataType.Date)] 
public DateTime DOB { get; set; } 

[Required] 

[EmailAddress] 

public string Email { get; set; } 

[Phone] 

[Display(Name = "Phone number")] 
public string PhoneNumber { get; set; } 

} 

public async Task<IActionResult> OnGetAsync() 

{ 

var user = await _userManager.GetUserAsync(User); 
if (user == null) 

{ 

return NotFound(î"Unable to load user with ID '(_userManager.GetUserId(User)}'."); 

} 

var userName = await _userManager.GetUserNameAsync(user); 

var email = await _userManager.GetEmailAsync(user); 

var phoneNumber = await _userManager.GetPhoneNumberAsync(user); 

Username = userName; 

Input = new InputModel 

{ 

Name = user.Name, 

DOB = user.DOB, 

Email = email, 

PhoneNumber = phoneNumber 

}; 


IsEmailConfirmed = await _userManager.IsEmailConfirmedAsync(user); 
return Page(); 

} 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var user = await _userManager.GetUserAsync(User); 
if (user == null) 

{ 

return NotFound($"Unable to load user with ID '(_userManager.GetUserId(User)}'."); 

} 

var email = await _userManager.GetEmailAsync(user); 
if (Input.Email != email) 

{ 

var setEmailResult = await _userManager.SetEmailAsync(user, Input.Email); 
if (! setEmailResult.Succeeded) 

{ 

var userld = await _userManager.GetUserIdAsync(user); 

throw new InvalidOperationException($"Unexpected error occurred setting email for user with ID 


'{userld}'."); 

} 

} 

if (Input.Name != user.Name) 

{ 

user.Name = Input.Name; 

} 

if (Input.DOB != user.DOB) 

{ 

user.DOB = Input.DOB; 

} 

var phoneNumber = await _userManager.GetPhoneNumberAsync(user); 
if (Input.PhoneNumber != phoneNumber) 

{ 

var setPhoneResult = await _userManager.SetPhoneNumberAsync(user, Input.PhoneNumber); 
if (IsetPhoneResult.Succeeded) 

{ 

var userld = await _userManager.GetUserIdAsync(user); 

throw new InvalidOperationException($"Unexpected error occurred setting phone number for user 
with ID '{userld}'."); 

} 

} 

await _userManager.UpdateAsync(user); 

await _signInManager.RefreshSignlnAsync(user); 

StatusMessage = "Your profile has been updated"; 
return RedirectToPage(); 

} 

public async Task<IActionResult> OnPostSendVerificationEmailAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

var user = await _userManager.GetUserAsync(User); 
if (user == null) 

{ 

return NotFound($"Unable to load user with ID '{_userManager.GetUserId(User)}'."); 

} 


var userld = await _userManager.GetUserIdAsync(user); 
var email = await _userManager.GetEmailAsync(user); 

var code = await _userManager.GenerateEmailConfirmationTokenAsync(user); 
var callbackUrl = Url.Page( 

"/Account/ConfirmEmail ", 
pageHandler: null, 

values: new { userld = userld, code = code }, 
protocol: Request.Scheme); 
await _emailSender.SendEmailAsync( 
email, 

"Confirm your email", 

$"Please confirm your account by <a href='{HtmlEncoder.Default.Encode(callbackUrl)}'>clicking 

here</a>."); 


StatusMessage = "Verification email sent. Please check your email."; 
return RedirectToPage(); 

} 

} 


Güncelleştirme Areas/ldentity/Pages/Account/Manage/tndex.cshtml aşağıdaki vurgulanmış biçimlendirmeye 


sahip: 


@page 

@model IndexModel 

@{ 

ViewData["Title"] = "Profile"; 

ViewData["ActivePage"] = ManageNavPages.Index; 

} 

<h4>@ViewData["Title"]</h4> 

<partial name="_StatusMessage" for="StatusMessage" /> 

<div class="row"> 

<div class="col-md-6"> 

<form id="profile-form" method="post"> 

<div asp-validation-summary="All" class="text-danger"x/div> 

<div class="form-group"> 

<label asp-for="Username"x/label> 

<input asp-for="Username" class="form-control" disabled /> 

</div> 

<div class="form-group"> 

<label asp-for="Input. Email"x/label> 

@if (Model.IsEmailConfirmed) 

{ 

<div class="input-group"> 

<input asp-for="Input.Email" class="form-control" /> 

<span class="input-group-addon" aria-hidden="true"xspan class="glyphicon glyphicon-ok 
text-success"x/spanx/span> 

</div> 

} 

else 

{ 

<input asp-for="Input.Email" class="form-control" /> 

<button id="email-verification" type="submit" asp-page-handler="SendVerificationEmail" 
class="btn btn-link">Send verification email</button> 

} 

<span asp-validation-for="Input.Email" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Input. Name"x/label> 

<input asp-for="Input.Name" class="form-control" /> 

</div> 

<div class="form-group"> 

<label asp-for="Input ,DOB"x/label> 

<input asp-for="Input.DOB" class="form-control" /> 

</div> 

<div class="form-group"> 

<label asp-for="Input. PhoneNumber"x/label> 

<input asp-for="Input.PhoneNumber" class="form-control" /> 

<span asp-validation-for="Input .PhoneNumber" class="text-danger"x/span> 

</div> 

<button id="update-profile-button" type="submit" class="btn btn-primary">Save</button> 

</form> 

</div> 

</div> 

@section Scripts { 

<partial name="_ValidationScriptsPartial" /> 

} 


Account/Register.cshtml sayfası 

Güncelleştirme inputModei içinde Areas/lderıtity/Pages/Account/Register.cshtml.cs aşağıdaki vurgulanmış kodu: 


[AllowAnonymous] 

public class RegisterModel : PageModel 

{ 




private readonly SignInManager<WebApplUser> _signInManager; 
private readonly UserManager<WebApplUser> _userManager; 
private readonly ILogger<RegisterModel> _logger; 
private readonly IEmailSender _emailSender; 

public RegisterModel( 

UserManager<WebApplUser> userManager, 

SignInManager<WebApplUser> signlnManager, 

ILogger<RegisterModel> logger, 

IEmailSender emailSender) 

{ 

_userManager = userManager; 

_signInManager = signlnManager; 

_logger = logger; 

_emailSender = emailSender; 

} 

[BindProperty] 

public InputModel Input { get; set; } 
public string ReturnUrl { get; set; } 

public IList<AuthenticationScheme> ExternalLogins { get; set; } 

public class InputModel 

{ 

[Required] 

[DataType(DataType.Text)] 

[Display(Name = "Full name")] 
public string Name { get; set; } 

[Required] 

[Display(Name = "Birth Date")] 

[DataType(DataType.Date)] 
public DateTime DOB { get; set; } 

[Required] 

[EmailAddress] 

[Display(Name = "Email")] 
public string Email { get; set; } 

[Required] 

[StringLength(100j ErrorMessage = "The {0} must be at least {2} and at max {1} characters long. 
MinimumLength = 6)] 

[DataType(DataType.Password)] 

[Display(Name = "Password")] 
public string Password { get; set; } 

[DataType(DataType.Password)] 

[Display(Name = "Confirm password")] 

[Compare("Password ", ErrorMessage = "The password and confirmation password do not match.")] 
public string ConfirmPassword { get; set; } 

} 

public async Task OnGetAsync(string returnUrl = null) 

{ 

ReturnUrl = returnUrl; 

ExternalLogins = (await _signInManager.GetExternalAuthenticationSchemesAsync()).ToList(); 

} 

public async Task<IActionResult> OnPostAsync(string returnUrl = null) 

{ 

returnUrl = returnUrl ?? Url.Content("~/"); 

ExternalLogins = (await _signInManager.GetExternalAuthenticationSchemesAsync()).ToList(); 
if (ModelState.IsValid) 

{ 

var user = new NebApplUser { 

Name = Input.Namej 
DOB = Input.DOBj 


UserName = Input.Email 
Email = Input.Email 


}; 

var result = await _userManager.CreateAsync(user, Input.Password); 
if (result.Succeeded) 

{ 

_logger.LogInformation("User created a new account with password."); 

var code = await _userManager.GenerateEmailConfirmationTokenAsync(user); 
code = WebEncoders.Base64UrlEncode(Encoding.UTF8.GetBytes(code)); 
var callbackUrl = Url.Page( 

"/Account/ConfirmEmail", 
pageHandler: null, 

values: new { area = "Identity", userld = user.Id, code = code }, 
protocol: Request.Scheme); 

await _emailSender.SendEmailAsync(Input.Email, 

"Confirm your email", 

$"Please confirm your account by <a 
href='{HtmlEncoder.Default.Encode(callbackUrl)}’>clicking here</a>."); 

if (_userManager.Options.Signln.RequireConfirmedAccount) 

{ 

return RedirectToPage("RegisterConfirmation", new { email = Input.Email }); 

} 

else 

{ 

await _signInManager.SignInAsync(user, isPersistent: false); 
return LocalRedirect(returnUrl); 

} 

} 

foreach (var error in result.Errors) 

{ 

ModelState.AddModelError(string.Empty, error.Description); 

} 

} 

// If we got this far, something failed, redisplay form 
return Page(); 

} 

} 

Güncelleştirme Areas/ldentity/Pages/Account/Register.cshtml aşağıdaki vurgulanmış biçimlendirmeye sahip: 

@page 

@model RegisterModel 

@{ 

ViewData["Title"] = "Register"; 

} 

<hl>@ViewData["Title"]</hl> 

<div class="row"> 

<div class="col-md-4"> 

<form asp-route-returnUrl="@Model.ReturnUrl" method="post"> 

<h4>Create a new account.</h4> 

<hr /> 

<div asp-validation-summary="All" class="text-danger"x/div> 

<div class="form-group"> 

<label asp-for="Input. Name"x/label> 

<input asp-for="Input.Name" class="form-control" /> 

<span asp-validation-for="Input.Name" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Input .DOB"x/label> 

<input asp-for="Input.DOB" class="form-control" /> 


<span asp-validation-for="Input .DOB" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Input. Email"x/label> 

cinput asp-for="Input.Email" class="form-control" /> 

<span asp-validation-for="Input.Email" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Input. Password"x/label> 

<input asp-for="Input.Password" class="form-control" /> 

<span asp-validation-for="Input.Password" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Input .ConfinmPassword"x/label> 

<input asp-for="Input.ConfinmPassword" class="form-control" /> 

<span asp-validation-for="Input.ConfirmPassword" class="text-danger"x/span> 

</div> 

<button type="submit" class="btn btn-primary">Register</button> 

</fonm> 

</div> 

<div class="col-md-6 col-md-offset-2"> 

<section> 

<h4>Use another service to register.</h4> 

<hr /> 

@{ 

if ((Model.ExternalLogins?.Count ?? 0) == 0) 

{ 

<div> 

<P> 

There are no external authentication Services configured. See 
<a href="https://go.microsoft.com/fwlink/?LinkID=532715">this article</a> 
for details on setting up this ASP.NET application to support 
logging in via external Services. 

</p> 

</div> 

} 

else 

{ 

<form id="external-account" asp-page="./ExternalLogin" 
asp-route-returnllrl="@Model.ReturnLIrl" method="post" 
class="form-horizontal"> 

<div> 

<P> 

@foreach (var provider in Model.ExternalLogins) 

{ 

<button type="submit" class="btn btn-primary" name="provider" 
value="@provider.Name" 

title="Log in using your @provider.DisplayName account"> 
@provider.DisplayName</button> 

} 

</p> 

</div> 

</form> 

} 

} 

</section> 

</div> 

</div> 

@section Scripts { 

<partial name="_ValidationScriptsPartial" /> 

} 


[AllowAnonymous] 

public class RegisterModel : PageModel 

{ 




private readonly SignInManager<WebApplUser> _signInManager; 
private readonly UserManager<WebApplUser> _userManager; 
private readonly ILogger<RegisterModel> _logger; 
private readonly IEmailSender _emailSender; 

public RegisterModel( 

UserManager<WebApplUser> userManager, 

SignInManager<WebApplUser> signlnManager, 

ILogger<RegisterModel> logger, 

IEmailSender emailSender) 

{ 

_userManager = userManager; 

_signInManager = signlnManager; 

_logger = logger; 

_emailSender = emailSender; 

} 

[BindProperty] 

public InputModel Input { get; set; } 

public string ReturnUrl { get; set; } 

public class InputModel 

{ 

[Required] 

[DataType(DataType.Text)] 

[Display(Name = "Full name")] 
public string Name { get; set; } 

[Required] 

[Display(Name = "Birth Date")] 

[DataType(DataType.Date)] 
public DateTime DOB { get; set; } 

[Required] 

[EmailAddress] 

[Display(Name = "Email")] 
public string Email { get; set; } 

[Required] 

[StringLength(100, ErrorMessage = "The {0} must be at least {2} and at max {1} characters long. 
MinimumLength = 6)] 

[DataType(DataType.Password)] 

[Display(Name = "Password")] 
public string Password { get; set; } 

[DataType(DataType.Password)] 

[Display(Name = "Confirm password")] 

[Compare("Password ", ErrorMessage = "The password and confirmation password do not match.")] 
public string ConfirmPassword { get; set; } 

} 

public void OnGet(string returnUrl = null) 

{ 

ReturnUrl = returnUrl; 

} 

public async Task<IActionResult> OnPostAsync(string returnUrl = null) 

{ 

returnUrl = returnUrl ?? Url.Content("~/"); 
if (ModelState.IsValid) 

{ 

var user = new WebApplUser { 

Name = Input.Namej 
DOB = Input.DOBj 
UserName = Input.Email, 

Email = Input.Email 

}; 

var result = await _userManager.CreateAsync(user, Input.Password); 


if (result.Succeeded) 

{ 

_logger.LogInformation("User created a new account with password."); 

var code = await _userManager.GenerateEmailConfirmationTokenAsync(user ); 
var callbackllrl = Url.Page( 

"/Account/ConfirmEmail ", 
pageHandler: null, 

values: new { userld = user.Id, code = code }, 
protocol: Request.Scheme); 

await _emailSender.SendEmailAsync(Input.Email, "Confirm your email", 
$"Please confirm your account by <a 
href= ' {HtmlEncoder .Default. Encode(callbackllrl)} ' >clicking here</a>. "); 

await _signInManager.SignInAsync(userj isPersistent: false); 
return LocalRedirect(returnllrl); 

} 

foreach (var error in result.Errors) 

{ 

ModelState.AddModelError(string.Empty, error.Description); 

} 

} 

// If we got this far, something failed, redisplay form 
return Page(); 

} 

} 


Güncelleştirme Areas/ldentity/Pages/Accourıt/Register.cshtml aşağıdaki vurgulanmış biçimlendirmeye sahip: 


@page 

@model RegisterModel 

@{ 

ViewData["Title"] = "Register"; 

} 

<hl>@ViewData["Title"]</hl> 

<div class="row"> 

<div class="col-md-4"> 

<form asp-route-returnUrl="@Model.ReturnUrl" method="post"> 

<h4>Create a new account.</h4> 

<hr /> 

<div asp-validation-summary="All" class="text-danger"x/div> 

<div class="form-group"> 

<label asp-for="Input. Name"x/label> 

<input asp-for="Input.Name" class="form-contnol" /> 

<span asp-validation-for="Input. Name" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Input .DOB"x/label> 

<input asp-for="Input.DOB" class="form-control" /> 

<span asp-validation-for="Input .DOB" class="text-dangen"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Input. Email"x/label> 

<input asp-for="Input.Email" class="form-control" /> 

<span asp-validation-for="Input.Email" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Input. Password"x/label> 

<input asp-for="Input.Password" class="form-control" /> 

<span asp-validation-for="Input .Passwond" class="text-danger"x/span> 

</div> 

<div class="form-group"> 

<label asp-for="Input .ConfirmPassword"x/label> 

<input asp-for="Input.ConfirmPassword" class="form-contnol" /> 

<span asp-validation-for="Input .ConfirmPassword" class="text-danger"x/span> 
</div> 

<button type="submit" class="btn btn-primany">Register</button> 

</form> 

</div> 

</div> 

@section Scripts { 

<partial name="_ValidationScriptsPartial" /> 

} 


Projeyi oluşturun. 

Özel kullanıcı verileri için bir geçiş ekleyin 

• Visual Studio 

• .NETCoreCLI 

Visual Studio Paket Yöneticisi Konsolu: 


Add-Migration CustomUserData 
Update-Database 


Test oluşturun, görüntüleyin, indirin, özel kullanıcı verilerini sil 




Uygulamayı test edin: 

• Yeni bir kullanıcı kaydedin. 

• Özel kullanıcı veri görünümünde /identity/Account/Manage sayfası. 

• indirme ve görüntüleme kullanıcıların kişisel verilerden /identity/Account/Manage/PersonaiData sayfası. 





ASPNET Core için kimlik doğrulama örnekleri 

23.09.2019 • 2 minutes to read ı Edit Online 


Tarafından RickAnderson 

AS P.N ET Core deposu , aspnetcore/src/Security/Samples klasöründe aşağıdaki kimlik doğrulama örneklerini 
içerir: 

• Talep dönüştürme 

• Tanımlama bilgisi kimlik doğrulaması 

• Özel ilke sağlayıcısı-ıauthorizationpoiicyprovider 

• Dinamik kimlik doğrulama şemaları ve seçenekleri 

• Dış talepler 

• isteğe bağlı tanımlama bilgisi ve başka bir kimlik doğrulama düzeni arasında seçim yapma 

• Statik dosyalara erişimi kısıtlar 

Örnekleri çalıştırın 

• Bir dalseçin. Örneğin, Tag:v3.0.e 

• ASP.NET Core deposunukopyalayın veya indirin. 

• ASP.NET Core deposunun kopyası ile eşleşen .NET Core SDK sürümünü yüklediğinizi doğrulayın. 

• Aspnetcore/src/Security/Samples içindeki bir örneğe gidin ve örneği ile dotnet run çalıştırın. 

ASP.NET Core deposu , aspnetcore/src/Security/Samples klasöründe aşağıdaki kimlik doğrulama örneklerini 
içerir: 

• Talep dönüştürme 

• Tanımlama bilgisi kimlik doğrulaması 

• Özel ilke sağlayıcısı-ıauthorizationpolicyprovider 

• Dinamik kimlik doğrulama şemaları ve seçenekleri 

• Dış talepler 

• İsteğe bağlı tanımlama bilgisi ve başka bir kimlik doğrulama düzeni arasında seçim yapma 

• Statik dosyalara erişimi kısıtlar 

Örnekleri çalıştırın 

• Bir dalseçin. Örneğin, reiease/ 2.2 

• ASP.NET Core deposunukopyalayın veya indirin. 

• ASP.NET Core deposunun kopyası ile eşleşen .NET Core SDK sürümünü yüklediğinizi doğrulayın. 

• Aspnetcore/src/Security/Samples içindeki bir örneğe gidin ve örneği ile dotnet run çalıştırın. 









ASPNET core'da kimlik modeli özelleştirme 

2.07.2019 • 26 minutes to read ı Edit Online 


Tarafından Arthur Vickers 

ASP.NET Core kimlik yönetimi ve ASP.NET Core uygulamalarında kullanıcı hesaplarını depolamak için bir çerçeve 
sunar. Kimlik, projenize eklenir, bireysel kullanıcı hesapları kimlik doğrulama mekanizması olarak seçilir. 
Varsayılan olarak, kimlik bir Entity Framevvork (EF), yararlanır çekirdek veri modeli. Bu makalede, kimlik modeli 
özelleştirmeyi açıklar. 

Kimlik ve EF Core geçişleri 

Model inceleme önce kimlik'ile nasıl çalıştığını anlamak kullanışlıdır EF Core geçişleri bir veritabanı oluşturmak 
için. En üst düzeyinde bir işlemdir: 

1. Tanımlayın veya güncelleştirme bir kod veri modelinde. 

2. Bu model, veritabanına uygulanabilir değişiklikleri küçültmesini bir geçiş ekleyin. 

3. Onay geçiş amacınızı doğru şekilde temsil eder. 

4. Geçiş modeli ile eşitlenmiş olmasını veritabanını güncellemek için geçerlidir. 

5. 1 ile daha fazla model iyileştirmek ve veritabanı eşitlenmiş halde tutun için 4 arasındaki adımları yineleyin. 
Ekleme ve geçiş uygulamak için aşağıdaki yaklaşımlardan birini kullanın: 

• Paket Yöneticisi Konsolu Visual Studio kullanıyorsanız (PMC) penceresi. Daha fazla bilgi için EF Core PMC 
Araçları. 

• .NET Core komut satırı kullanılarak, CLI. Daha fazla bilgi için EF Core .NET komut satırı araçları. 

• Tıklayarak geçerli geçişleri düğmesi uygulamayı çalıştırdığınızda hata sayfasında. 

AS P.N ET Core geliştirme zamanı hata sayfası işleyicisine sahiptir. Uygulamayı çalıştırdığınızda, işleyici geçişler 
uygulayabilirsiniz. Üretim uygulamaları, genellikle geçişleri SQL komut dosyaları üret ve denetlenen uygulama ve 
dağıtım veritabanı kapsamında veritabanı değişiklikleri dağıtın. 

Kimlik kullanarak yeni bir uygulama oluşturduğunuzda, 1 ve 2 numaralı adımları zaten tamamlanmış. Diğer bir 
deyişle, ilk veri modelini zaten var ve ilk geçiş projeye eklendi, ilk geçişten hala veritabanına uygulanması gerekiyor, 
ilk geçişten aşağıdaki yaklaşımlardan birini uygulanabilir: 

• Çalıştırma Update-Database PMC içinde. 

• Çalıştırma dotnet ef database update komut kabuğu'nda. 

• Tıklayın geçerli geçişleri düğmesi uygulamayı çalıştırdığınızda hata sayfasında. 

Modelde değişiklikler yapıldıkça önceki adımları yineleyin. 

Kimlik modeli 

Varlık türleri 

Aşağıdaki varlık türlerini kimlik modeli oluşur. 

VARLIK TÜRÜ AÇIKLAMA 

User Kullanıcıyı temsil eder. 





VARLIK TURU 


AÇIKLAMA 


Role 

Bir rolü temsil eder. 

UsenClaim 

Bir kullanıcının sahip olduğu bir talebi temsil eder. 

UsenToken 

Bir kullanıcı için bir kimlik doğrulama belirteci temsil eder. 

UserLogin 

Bir kullanıcı bir oturum açma ile ilişkilendirir. 

RoleClaim 

Bir roldeki tüm kullanıcılara verilen talebi temsil eder. 

UserRole 

Kullanıcılar ve roller ilişkilendirir birleştirme varlık. 


Varlık türü ilişkileri 

Varlık türleri aşağıdaki şekillerde birbirleriyle ilişkili: 

• Her User birçok sahip UserClaims . 

• Her User birçok sahip UserLogins . 

• Her User birçok sahip UserTokens . 

• Her Role olabilir birçok ilişkili Roieciaims . 

• Her User olabilir birçok ilişkili Roles ve her Role çoğu ile ilişkili olabilir users . Bu veritabanında bir birleşim 

tablosunu gerektiren bir çoktan çoğa bir ilişkidir. Birleşim tablosu tarafından temsil edilen userRole varlık. 

Varsayılan model yapılandırma 

Kimlik birçok tanımlar bağlamı sınıfları türünden devralınır DbContext yapılandırıp modelini kullanın. Bu 
yapılandırma yapılır kullanarak EF Core kod ilk Fluent API'si içinde OnModelCreating bağlamı sınıfının yöntemi. 
Varsayılan yapılandırma verilmiştir: 

builder.Entity<TUser>(b => 

{ 

// Primary key 
b.HasKey(u => u.Id); 

// Indexes for "normalized" username and email, to allow efficlent lookups 
b.HasIndex(u => u.NormalizedUserName).HasName("UserNameIndex").IsUnique(); 
b.HasIndex(u => u .NormalizedEmail).HasName("EmailIndex"); 

// Maps to the AspNetUsers table 
b.ToTable("AspNetUsers"); 

// A concurrency token for use with the optimistle concurrency checking 
b.Property(u = > u.ConcurrencyStamp).IsConcurrencyToken(); 

// Limit the size of columns to use efficient database types 
b.Property(u => u.UserName).HasMaxLength(256); 
b.Property(u => u.NormalizedUserName).HasMaxLength(256); 
b.Property(u => u.Email).HasMaxLength(256); 
b.Property(u => u.NormalizedEmail).HasMaxLength(256); 

// The relationships between User and other entity types 

// Note that these relationships are configured with no navigation properties 
// Each User can have many UserClaims 

b.HasMany<TUserClaim>().WithOne().HasForeignKey(uc => uc.Userld).IsRequired(); 

// Each User can have many UserLogins 

b.HasMany<TUserLogin>().WithOne().HasForeignKey(ul => ul.Userld).IsRequired(); 













// Each User can have many UserTokens 

b.HasMany<TUserToken>().WithOne().HasForeignKey(ut => ut.Userld).IsRequired() 

// Each User can have many entries in the UserRole join table 
b.HasMany<TUserRole>().WithOne().HasForeignKey(ur => ur.Userld).IsRequired(); 

}); 

builder.Entity<TUserClaim>(b => 

{ 

// Primary key 
b.HasKey(uc => uc.Id); 

// Maps to the AspNetUserClaims table 
b.ToTable("AspNetUserClaims"); 

}); 

builder.Entity<TUserLogin>(b => 

{ 

// Composite primary key consisting of the LoginProvider and the key to use 
// with that provider 

b.HasKey(l => new { 1.LoginProvider, l.ProviderKey }); 

// Limit the size of the composite key columns due to common DB restrictions 
b.Property(l => 1.LoginProvider).HasMaxLength(128); 
b.Property(l => 1.ProviderKey).HasMaxLength(128); 

// Maps to the AspNetUserLogins table 
b.ToTable("AspNetUserLogins"); 

}); 

builder.Entity<TUserToken>(b => 

{ 

// Composite primary key consisting of the Userld, LoginProvider and Name 
b.HasKey(t => new { t.Userld, t.LoginProvider, t.Name }); 

// Limit the size of the composite key columns due to common DB restrictions 
b.Property(t => t.LoginProvider).HasMaxLength(maxKeyLength); 
b.Property(t => t.Name).HasMaxLength(maxKeyLength); 

// Maps to the AspNetUserTokens table 
b.ToTable("AspNetUserTokens"); 

}); 

builder.Entity<TRole>(b => 

{ 

// Primary key 
b.HasKey(r => r.Id)j 

// Index for "normalized" role name to allow efficient lookups 
b.HasIndex(r => r.NormalizedName).HasName("RoleNameIndex").IsUnique(); 

// Maps to the AspNetRoles table 
b.ToTable("AspNetRoles"); 

// A concurrency token for use with the optimistle concurrency checking 
b.Property(r => r.ConcurrencyStamp).IsConcurrencyToken(); 

// Limit the size of columns to use efficient database types 
b.Property(u => u.Name).HasMaxLength(256); 
b.Property(u => u.NormalizedName).HasMaxLength(256); 

// The relationships between Role and other entity types 

// Note that these relationships are configured with no navigation properties 

// Each Role can have many entries in the UserRole join table 
b.HasMany<TUserRole>().WithOne().HasForeignKey(ur => ur.Roleld).IsRequired(); 


// Each Role can have many associated RoleClaims 


b.HasMany<TRoleClaim>().WithOne().HasForeignKey(rc => rc.Roleld).IsRequired(); 


}); 

builder.Entity<TRoleClaim>(b => 

{ 

// Primary key 
b.HasKey(rc => rc.Id); 

// Maps to the AspNetRoleClaims table 
b.ToTable("AspNetRoleClaims"); 

}); 

builder.Entity<TUserRole>(b => 

{ 

// Primary key 

b.HasKey(r => new { r.Userld, r.Roleld }); 

// Maps to the AspNetUserRoles table 
b.ToTable("AspNetUserRoles"); 

}); 


Model genel türler 

Varsayılan kimlik tanımlar ortak dil çalışma zamanı yukarıda listelenen her bir varlık türü için (CLR) türleri. Bu tür 
tüm ön eki kimlik'. 

• IdentityUser 

• IdentityRole 

• IdentityUserClaim 

• IdentityUserToken 

• IdentityUserLogin 

• IdentityRoleClaim 

• IdentityUserRole 

Bu tür doğrudan kullanmak yerine türleri temel sınıf olarak uygulamanın kendi türleri için kullanılabilir. DbContext 
Farklı CLR türleri için bir veya daha fazla varlık türleri modelinde kullanılabilir olacak şekilde kimlik tarafından 
tanımlanan sınıflara genel,. Bu genel türler de izin User değiştirilmesi için birincil anahtar (PK) veri türü. 

Kimlik desteğiyle rolleri için kullanılırken bir ldentityDbContext sınıfı kullanılmalıdır. Örneğin: 





// Uses ali the built-in Identity types 
// Uses 'string' as the key type 
public class IdentityDbContext 

: IdentityDbContext<IdentityUser, IdentityRole, string> 

{ 

} 

// Uses the built-in Identity types except with a custom User type 
// Uses 'string' as the key type 
public class IdentityDbContext<TUser> 

: IdentityDbContext<TUser, IdentityRole, string> 
where TUser : IdentityUser 

{ 

} 

// Uses the built-in Identity types except with custom User and Role types 
// The key type is defined by TKey 

public class IdentityDbContext<TUser, TRole, TKey> : IdentityDbContext< 

TUser, TRole, TKey, IdentityUserClaim<TKey>, IdentityUserRole<TKey>, 
IdentityUserLogin<TKey>, IdentityRoleClaim<TKey>, IdentityUserToken<TKey>> 
where TUser : IdentityUser<TKey> 
where TRole : IdentityRole<TKey> 
where TKey : IEquatable<TKey> 

{ 

} 

// No built-in Identity types are used; ali are specified by generic arguments 
// The key type is defined by TKey 
public abstract class IdentityDbContext< 

TUser, TRole, TKey, TUserClaim, TUserRole, TUserLogin, TRoleClaim, TUserToken> 
: IdentityUserContext<TUser, TKey, TUserClaim, TUserLogin, TUserToken> 
where TUser : IdentityUser<TKey> 
where TRole : IdentityRole<TKey> 
where TKey : IEquatable<TKey> 
where TUserClaim : IdentityUserClaim<TKey> 
where TUserRole : IdentityUserRole<TKey> 
where TUserLogin : IdentityUserLogin<TKey> 
where TRoleClaim : IdentityRoleClaim<TKey> 
where TUserToken : IdentityUserToken<TKey> 


(Yalnızca talep) rol, bu durumda kimlik kullanmak da mümkündür bir ldentityUserContext<TUser> sınıfı 
kullanılmalıdır: 




// Uses the built-in non-role Identity types except with a custom User type 
// Uses 'string' as the key type 
public class IdentityUserContext<TUser> 

: IdentityUserContext<TUser, string> 
where TUser : IdentityUser 

{ 

} 

// Uses the built-in non-role Identity types except with a custom User type 
// The key type is defined by TKey 

public class IdentityUserContext<TUser, TKey> : IdentityUserContext< 

TUser, TKey, IdentityUserClaim<TKey>, IdentityUserLogin<TKey>, 

IdentityUserToken<TKey>> 

where TUser : IdentityUser<TKey> 
where TKey : IEquatable<TKey> 

{ 

} 

// No built-in Identity types are used; ali are specified by generic arguments, with no roles 

// The key type is defined by TKey 

public abstract class IdentityUserContext< 

TUser, TKey, TUserClaim, TUserLogin, TUserToken> : DbContext 
where TUser : IdentityUser<TKey> 
where TKey : IEquatable<TKey> 
where TUserClaim : IdentityUserClaim<TKey> 
where TUserLogin : IdentityUserLogin<TKey> 
where TUserToken : IdentityUserToken<TKey> 

{ 

} 


Model özelleştirme 

Model özelleştirme için başlangıç noktası uygun içerik türünden türetilmesi sağlamaktır. Bkz: Model genel türler 
bölümü. Bu bağlam türü özel olarak adlandırılır AppiicationDbContext ve AS P.N ET Core şablonları tarafından 
oluşturulur. 

Bağlam model iki şekilde yapılandırmak için kullanılır: 

• Varlık ve genel tür parametreleri için anahtar türleri sağlama. 

• Geçersiz kılma onModeicneating bu tür eşlemesini değiştirmek için. 

Geçersiz kılarken onModeicreating , base.onModeicreating ilk kez çağrılması gerekir; geçersiz kılma 
yapılandırmasını sonra çağrılmalıdır. EF Core genel yapılandırma için bir son bir WINS ilkesi vardır.Örneğin, varsa 
ToTable yöntemi bir varlık türü için bir tablo adıyla önce çağrılır ve daha sonra tekrar farklı bir tablo adı ile ikinci 
çağrıda tablo adı daha sonra kullanılır. 

Özel kullanıcı verileri 

Özel kullanıcı verilerini devralarak desteklenen IdentityUser . Bu tür adı uygulamadır Appiicationuser : 

public class Appiicationuser : IdentityUser 

{ 

public string CustomTag { get; set; } 

} 


Kullanım Appiicationuser bağlamı için genel bir bağımsız değişken türü: 











public class ApplicationDbContext : IdentityDbContext<ApplicationUser> 

{ 

public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options) 

: base(options) 

{ 

} 

protected override void OnModelCreating(ModelBuilder builder) 

{ 

base.OnModelCreating(builder); 

} 

} 

Geçersiz kılmak için gerek yoktur onModeicreating içinde AppiicationDbContext sınıfı. EF Core eşler customTag 
gereği özelliği. Ancak, veritabanını yeni bir güncelleştirilmesi gerekiyor CustomTag sütun. Sütun oluşturmak için bir 
geçiş ekleyin ve ardından veritabanını açıklandığı gibi güncelleştirin kimlik ve EF Core geçişleri. 

Güncelleştirme Pages/Shared/_LoginPartial.cshtml değiştirin identıtyUser ile AppiicationUser : 

@using Microsoft.AspNetCore.Identity 
@using WebAppl.Areas.Identity.Data 
(Şinject SignInManager<ApplicationUser> SignlnManager 
(Şinject UserManager<ApplicationUser> UserManager 

Güncelleştirme Areas/ldentity/lderıtityHostingStartup.cs veya startup.configureServices değiştirin identityuser 
ile AppiicationUser . 

Services.AddDefaultIdentity<ApplicationUser>() 

.AddEntityFrameworkStores<ApplicationDbContext>() 

.AddDefaultUI(); 

ASP.NET Core 2.1 veya daha sonra kimlik Razor sınıf kitaplığı sağlanır.Daha fazla bilgi için bkz. ASP.NET Core 
projelerinde yapı iskelesi kimliği. Sonuç olarak, önceki kod yapılan bir çağrı gerektirir. AddDefaultUl. Kimlik iskele 
kurucu kimlik dosyalar projeye eklemek için kullanıldıysa çağrısını kaldırın AddDefauituı . Daha fazla bilgi için bkz.: 

• İskele Kimliği 

• Ekleme, indirmek ve kimlik için özel kullanıcı verilerini sil 

Birincil anahtar türünü değiştirme 

Veritabanı oluşturulduktan sonra PK sütunun veri türü için çok sayıda veritabanı sistemlerinde sorunlu farklıdır.PK 
değiştirilmesi genellikle, bırakarak ve tabloyu yeniden oluşturmayı içerir. Bu nedenle, veritabanı oluşturulurken 
anahtar türleri ilk geçiş belirtilmelidir. 

PK türünü değiştirmek için aşağıdaki adımları izleyin: 

1. Veritabanı oluşturduysanız çalıştırarak PK değişiklikten önce Drop-oatabase (PMC)veya 

dotnet ef database drop (CLI silmek için .NET Core). 

2. Veritabanının silinmesi, onayladıktan sonra ilk geçiş işlemine kaldırmak Remove-Migration (PMC) veya 

dotnet ef migrations remove (.NET CoreCLI). 

3. Güncelleştirme AppiicationDbContext öğesinden türetilen sınıfın ldentityDbContext<TUser,TRole,TKey>. 

Yeni anahtar türü için belirtin TKey . Örneğin, kullanılacak bir Guid anahtar türü: 




















public class ApplicationDbContext 

: IdentityDbContext<IdentityUsen<Guid> J IdentityRole<Guid>, Guid> 

{ 

public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options) 

: base(options) 

{ 

} 

} 

Önceki kodda, Genel sınıflar ldentityllser<TKey> ve ldentityRole<TKey> yeni anahtar türü kullanmak için 
belirtilmelidir. 

Önceki kodda, Genel sınıflar ldentityllser<TKey> ve ldentityRole<TKey> yeni anahtar türü kullanmak için 
belirtilmelidir. 

startup.configureServices Genel kullanıcı kullanacak şekilde güncelleştirilmesi gerekir: 

Services. AddDefaultIdentity<Identityllser<Guid>>() 

.AddEntityFrameworkStores<ApplicationDbContext>() 

.AddDefaultTokenProviders(); 


Services.AddIdentity<IdentityUser<Guid>j IdentityRole>() 

.AddEntityFrameworkStores<ApplicationDbContext>() 
.AddDefaultTokenProviders(); 


Services.AddIdentity<Identityllser<Guid>, IdentityRole>() 

.AddEntityFrameworkStores<ApplicationDbContext , Guid>() 

.AddDefaultTokenProviders(); 

4. Özel durumunda AppücationUser sınıfı kullanılıyor, devralınacak sınıfını güncelleştirme identityuser . 
Örneğin: 

using System; 

using Microsoft.AspNetCore.Identity.EntityFrameworkCore; 

public class ApplicationLIser : Identityllser<Guid> 

{ 

public string CustomTag { get; set; } 

} 


using System; 

using Microsoft.AspNetCore.Identity; 

public class ApplicationLIser : IdentityUser<Guid> 

{ 

public string CustomTag { get; set; } 

} 


Güncelleştirme AppiicationDbContext özel başvurmak için ApplicationLIser sınıfı: 







public class ApplicationDbContext 

: IdentityDbContext<ApplicationUser, IdentityRole<Guid>, Guid> 

{ 

public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options) 

: base(options) 

{ 

} 

} 

Özel bir veritabanı bağlamı sınıfının kimlik hizmeti eklerken kaydetme startup.configureServices : 

Services. AddDefaultIdentity<Applicationllser'> () 

. AddEntityFrameworkStores<AppücationDbContext>() 

.AddDefaultUI() 

.AddDefaultTokenProviders(); 


Birincil anahtarın veri türü analiz ederek algılanır DbContext nesne. 

ASP.NET Core 2.1 veya daha sonra kimlik Razor sınıf kitaplığı sağlanır.Daha fazla bilgi için bkz. ASP.NET 
Core projelerinde yapı iskelesi kimliği. Sonuç olarak, önceki kod yapılan bir çağrı gerektirir. AddDefaultUl. 
Kimlik iskele kurucu kimlik dosyalar projeye eklemek için kullanıldıysa çağrısını kaldırın AddDefauituı . 

Services.AddldentitycAppllcatlonUser, IdentityRole>() 

. AddEntityFrameworkStores<AppücationDbContext>() 

.AddDefaultTokenProviders(); 


Birincil anahtarın veri türü analiz ederek algılanır DbContext nesne. 

Services. AddldentitycAppücationUser, IdentityRole>() 

.AddEntityFrameworkStores<ApplicationDbContext , Guid>() 

.AddDefaultTokenProviders(); 

AddEntityFramevvorkStores Yöntemi kabul bir TKey birincil anahtarın veri türünü gösteren tür. 

5. Özel durumunda AppücationRoie sınıfı kullanılıyor, devralınacak sınıfını güncelleştirme identityRoie<TKey> 
Örneğin: 

using System; 

using Microsoft.AspNetCore.Identity; 

public class AppücationRoie : IdentityRole<Guid> 

{ 

public string Description { get; set; } 

} 

Güncelleştirme AppiicationDbContext özel başvurmak için AppücationRoie sınıfı. Örneğin, aşağıdaki sınıf 
özel başvuran ApplicationUser ve özel bir AppücationRoie: 
















using System; 

using Microsoft.AspNetCore.Identity.EntityFrameworkCore; 
using Microsoft.EntityFrameworkCore; 

public class ApplicationDbContext : 

IdentityDbContext<ApplicationUser, ApplicationRole, Guid> 

{ 

public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options) 
: base(options) 

{ 

} 

} 


Özel bir veritabanı bağlamı sınıfının kimlik hizmeti eklerken kaydetme startup.configureServices : 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 

Services.AddIdentity<Applicationllser, ApplicationRole>() 

.AddEntityFrameworkStores<ApplicationDbContext>() 

.AddDefaultUI() 

.AddDefaultTokenProviders(); 


} 


Services. AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_l); 


Birincil anahtarın veri türü analiz ederek algılanır DbContext nesne. 

ASP.NET Core 2.1 veya daha sonra kimlik Razor sınıf kitaplığı sağlanır.Daha fazla bilgi için bkz. ASP.NET 
Core projelerinde yapı iskelesi kimliği. Sonuç olarak, önceki kod yapılan bir çağrı gerektirir. AddDefaultUl. 
Kimlik iskele kurucu kimlik dosyalar projeye eklemek için kullanıldıysa çağrısını kaldırın Addoefauituı . 

using System; 

using Microsoft.AspNetCore.Identity.EntityFrameworkCore; 
using Microsoft.EntityFrameworkCore; 

public class ApplicationDbContext : 

IdentityDbContext<ApplicationUser, ApplicationRole, Guid> 

{ 

public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options) 

: base(options) 

{ 

} 

} 

Özel bir veritabanı bağlamı sınıfının kimlik hizmeti eklerken kaydetme Startup.configureServices : 








public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 

Services.AddIdentity<Applicationllser, ApplicationRole>() 

.AddEntityFrameworkStores<ApplicationDbContext>() 

.AddDefaultTokenProviders(); 

Services. AddMvc() 

.AddRazorPagesOptions(options => 

{ 

options.Conventions.AuthorizeFolder("/Account/Manage"); 
options.Conventions.AuthorizePage("/Account/Logout"); 

}); 

Services.AddSingletoncIEmailSender, EmailSender>(); 

} 


Birincil anahtarın veri türü analiz ederek algılanır DbContext nesne. 

using System; 

using Microsoft.AspNetCore.Identity.EntityFrameworkCore; 
using Microsoft.EntityFrameworkCore; 

public class ApplicationDbContext : 

IdentityDbContext<ApplicationUser, ApplicationRole, Guid> 

{ 

public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options) 

: base(options) 

{ 

} 

} 

Özel bir veritabanı bağlamı sınıfının kimlik hizmeti eklerken kaydetme startup.configureServices : 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 

Services.AddIdentity<ApplicationUserj ApplicationRole>() 

.AddEntityFrameworkStores<ApplicationDbContext , Guid>() 

.AddDefaultTokenProviders(); 

Services. AddMvc(); 

Services,AddTransient<IEmailSenderj AuthMessageSender>(); 

Services.AddTransient<ISmsSenderj AuthMessageSender>(); 

} 

AddEntityFramevvorkStores Yöntemi kabul bir TKey birincil anahtarın veri türünü gösteren tür. 

Gezinti özellikleri ekleyin 

ilişkiler için model yapılandırmasını değiştirme başka değişiklikler yaparak değerinden daha zor olabilir. Var olan 
ilişkileri değiştirmek yerine yeni, ek ilişkiler oluşturmak için dikkatli olunması gerekir. Özellikle, değiştirilen ilişki 
aynı yabancı anahtar (FK) özelliği var olan ilişkiyi belirtmeniz gerekir. Örneğin, arasındaki ilişkiyi users ve 
userciaims , varsayılan olarak, aşağıda belirtilen ise: 









builder.Entity<TUser>(b => 

{ 

// Each User can have many UserClaims 
b.HasMany<TUserClaim>() 

.WithOne() 

.HasForeignKey(uc = > uc.Userld) 
.IsRequired(); 

}); 


FK bu ilişki için belirtilen userciaim.userid özelliği. HasMany ve withOne Gezinti özellikleri olmayan bir ilişki 
oluşturmak için bağımsız değişkenler olmadan verilir. 


Bir gezinme özelliği için ekleme Appiicationuser sağlayan ilişkili UserClaims kullanıcıdan başvurulmak üzere: 

public class Appiicationuser : IdentityUser 
{ 

public Virtual ICollection<IdentityUserClaim<string>> Claims { get; set; } 

} 

TKey için IdentityUserClaim<TKey> PK kullanıcı için belirtilen bir tür. Bu durumda, TKey olduğu string 
Varsayılanları kullanıldığından. Sahip değil PKtürü Userciaim varlık türü. 

Gezinti özelliği var, bunu yapılandırılmalıdır OnModeicreating : 

public class ApplicationDbContext : IdentityDbContext<ApplicationUser> 

{ 

public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options) 

: base(options) 

{ 

} 

protected override void OnModelCreating(ModelBuilder modelBuilder) 

{ 

base.OnModeicreating(modelBuilder); 

modelBuilder.Entity<ApplicationUser>(b => 

{ 

// Each User can have many UserClaims 
b.HasMany(e => e.Claims) 

.WithOne() 

.HasForeignKey(uc => uc.Userld) 

.IsRequired(); 

}); 

} 

} 

ilişki, daha önce yalnızca yapılan çağrıda belirtilen Gezinti özelliğine sahip olduğu gibi yapılandırıldığını fark 
HasMany . 


Gezinme özelliklerini EF modeli, veritabanı değil yalnızca mevcut, ilişki için FK değişmediği için güncelleştirilecek 
veritabanı bu tür bir model değişikliği gerektirmez. Bu değişikliği yaptıktan sonra geçiş ekleyerek denetlenebilir, up 
Ve Down yöntemlerdir boş. 

Tüm kullanıcı Gezinti özellikleri ekleyin 

Yukarıdaki bölüme kılavuz kullanarak, aşağıdaki örnekte, kullanıcı tüm ilişkiler tek yönlü bir gezinti özelliklerini 
yapılandırır: 

















public class ApplicationUser : IdentityLIser 

{ 

public Virtual ICollection<IdentityUserClaim<string>> Claims { get; set; } 

public Virtual ICollection<IdentityUserLogin<string>> Logins { get; set; } 

public Virtual ICollection<IdentityUserToken<string>> Tokens { get; set; } 

public Virtual ICollection<IdentityUserRole<string>> UserRoles { get; set; } 

} 


public class ApplicationDbContext : IdentityDbContext<ApplicationUser> 

{ 

public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options) 
: base(options) 

{ 

} 

protected override void OnModelCreating(ModelBuilder modelBuilder) 

{ 

base.OnModelCreating(modelBuilder); 

modelBuilder.Entity<ApplicationUser>(b => 

{ 

// Each User can have many UserClaims 
b.HasMany(e => e.Claims) 

.WithOne() 

.HasForeignKey(uc => uc.Userld) 

.IsRequired(); 

// Each User can have many UserLogins 
b.HasMany(e => e.Logins) 

.WithOne() 

.HasForeignKey(ul => ul.Userld) 

.IsRequired(); 

// Each User can have many UserTokens 
b.HasMany(e => e.Tokens) 

.WithOne() 

.HasForeignKey(ut => ut.Userld) 

.IsRequired(); 

// Each User can have many entries in the UserRole join table 
b.FlasMany(e => e.UserRoles) 

.WithOne() 

.HasForeignKey(ur => ur.Userld) 

.IsRequired(); 

}); 

} 

} 


Kullanıcı ve rol Gezinti özellikleri ekleyin 

Yukarıdaki bölüme kılavuz kullanarak, aşağıdaki örnekte tüm ilişkiler için gezinme özelliklerinin kullanıcı ve rol 
yapılandırır: 



public class ApplicationUser : IdentityLIser 

{ 

public Virtual ICollection<IdentityUserClaim<string>> Claims { get; set; } 

public Virtual ICollection<IdentityUserLogin<string>> Logins { get; set; } 

public Virtual ICollection<IdentityUserToken<string>> Tokens { get; set; } 

public Virtual ICollection<ApplicationUserRole> UserRoles { get; set; } 

} 

public class ApplicationRole : IdentityRole 

{ 

public Virtual ICollection<ApplicationUserRole> UserRoles { get; set; } 

} 

public class ApplicationUserRole : IdentityUserRole<string> 

{ 

public Virtual ApplicationUser User { get; set; } 
public Virtual ApplicationRole Role { get; set; } 

} 



public class ApplicationDbContext 
: IdentityDbContext< 

ApplicationUser, ApplicationRolej string, 

IdentityUserClaim<string>j ApplicationUserRole, IdentityUserLogirKstring:», 
IdentityRoleClaim<string>j IdentityUserToken<string>> 

{ 

public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options) 

: base(options) 

{ 

} 

protected override void OnModelCreating(ModelBuilder modelBuilder) 

{ 

base.OnModelCreating(modelBuilder); 

modelBuilder.Entity<ApplicationUser>(b => 

{ 

// Each User can have many UserClaims 
b.HasMany(e => e.Claims) 

.WithOne() 

.HasForeignKey(uc => uc.Userld) 

.IsRequired(); 

// Each User can have many UserLogins 
b.HasMany(e => e.Logins) 

.WithOne() 

.HasForeignKey(ul => ul.Userld) 

.IsRequired(); 

// Each User can have many UserTokens 
b.HasMany(e => e.Tokens) 

.WithOne() 

.HasForeignKey(ut => ut.Userld) 

.IsRequired(); 

// Each User can have many entries in the UserRole join table 
b.HasMany(e => e.UserRoles) 

.WithOne(e => e.User) 

.HasForeignKey(ur => ur.Userld) 

.IsRequired(); 

}); 

modelBuilder.Entity<ApplicationRole>(b => 

{ 

// Each Role can have many entries in the UserRole join table 
b.HasMany(e => e.UserRoles) 

.WithOne(e => e.Role) 

.HasForeignKey(ur => ur.Roleld) 

.IsRequired(); 

}); 

} 

} 


Notlar: 

• Bu örnek ayrıca içerir UserRole katılma, kullanıcıların çok-çok ilişkisi rollerine gitmek için gerekli olan varlık. 

• Gezinti özellikleri, değişimi yansıtmak için tür değiştirmeyi unutmayın AppiicationXxx türleri artık kullanıldığı 
yerine identityXxx türleri. 

• Kullanmayı unutmayın AppiicationXxx genel olarak AppiicationContext tanımı. 

Tüm gezinti özellikleri ekleyin 

Yukarıdaki bölüme kılavuz kullanarak, aşağıdaki örnekte tüm varlık türleri üzerinde tüm ilişkiler için Gezinti 
özellikleri yapılandırır: 








public class ApplicationUser : IdentityLIser 

{ 

public Virtual ICollection<ApplicationUserClaim> Claims { get; set; } 

public Virtual ICollection<ApplicationUserLogin> Logins { get; set; } 

public Virtual ICollection<ApplicationUserToken> Tokens { get; set; } 

public Virtual ICollection<ApplicationUserRole> UserRoles { get; set; } 

} 

public class ApplicationRole : IdentityRole 

{ 

public Virtual ICollection<ApplicationUserRole> UserRoles { get; set; } 
public Virtual ICollection<ApplicationRoleClaim> RoleClaims { get; set; 

} 

public class ApplicationUserRole : IdentityUserRole<string> 

{ 

public Virtual ApplicationUser User { get; set; } 
public Virtual ApplicationRole Role { get; set; } 

} 

public class ApplicationUserClaim : IdentityUserClaim<string> 

{ 

public Virtual ApplicationUser User { get; set; } 

} 

public class ApplicationUserLogin : IdentityUserLogin<string> 

{ 

public Virtual ApplicationUser User { get; set; } 

} 

public class ApplicationRoleClaim : IdentityRoleClaim<string> 

{ 

public Virtual ApplicationRole Role { get; set; } 

} 

public class ApplicationUserToken : IdentityUserToken<string> 

{ 

public Virtual ApplicationUser User { get; set; } 

} 



public class ApplicationDbContext 
: IdentityDbContext< 

ApplicationUser, ApplicationRole, string, 

ApplicationUserClaim, ApplicationUserRole, ApplicationUserLogin, 
ApplicationRoleClaittij ApplicationllserToken> 

{ 

public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options) 
: base(options) 

{ 

} 

protected override void OnModelCreating(ModelBuilder modelBuilder) 

{ 

base.OnModelCreating(modelBuilder); 

modelBuilder.Entity<ApplicationUser>(b => 

{ 

// Each User can have many UserClaims 
b.HasMany(e => e.Claims) 

.WithOne(e => e.User) 

.HasForeignKey(uc => uc.Userld) 

.IsRequired(); 

// Each User can have many UserLogins 
b.HasMany(e => e.Logins) 

.WithOne(e => e.User) 

.HasForeignKey(ul => ul.Userld) 

.IsRequired(); 

// Each User can have many UserTokens 
b.HasMany(e => e.Tokens) 

.WithOne(e => e.User) 

.HasForeignKey(ut => ut.Userld) 

.IsRequired(); 

// Each User can have many entries in the UserRole join table 
b.HasMany(e => e.UserRoles) 

.WithOne(e => e.User) 

.HasForeignKey(ur => ur.Userld) 

.IsRequired(); 

}); 

modelBuilder.Entity<ApplicationRole>(b => 

{ 

// Each Role can have many entries in the UserRole join table 
b.HasMany(e => e.UserRoles) 

.WithOne(e => e.Role) 

.HasForeignKey(ur => ur.Roleld) 

.IsRequired(); 

// Each Role can have many associated RoleClaims 
b.HasMany(e => e.RoleClaims) 

.WithOne(e => e.Role) 

.HasForeignKey(rc => rc.Roleld) 

.IsRequired(); 

}); 

} 

} 


Bileşik anahtarlar kullanın 

Kimlik modelinde kullanılan anahtar türünü değiştirerek önceki bölümlerde gösterilmiştir. Bileşik anahtarlar 
kullanılacak kimlik anahtar modelini değiştirme, önerilen desteklenen veya değil. Bir bileşik anahtarı ile kimlik 
kullanarak, Identity manager kod modeli ile nasıl etkileştiğini değiştirilmesini kapsar. Bu belgenin kapsamı 
dışındadır özelleştirmedir. 







Tablo/sütun adlarını ve modeller 

Tablo ve sütun adlarını değiştirmek için çağrı base.onModeicreating . Ardından, tüm varsayılanları geçersiz kılmak 
için yapılandırma ekleyin. Örneğin, tüm kimlik tabloları adını değiştirmek için şunu yazın: 

protected override void OnModelCreating(ModelBuilder modelBuilder) 

{ 

base.OnModelCreating(modelBuilder); 

modelBuilder.Entity<IdentityUser>(b => 

{ 

b.ToTable("MyUsers"); 

}); 

modelBuilder.Entity<IdentityUserClaim<string>>(b => 

{ 

b.ToTable("MyUserClaims"); 

}); 

modelBuilder. Entity<IdentityUserl_ogin<string>>(b => 

{ 

b.ToTable("MyUserLogins"); 

}); 

modelBuilder.Entity<IdentityUserToken<string>>(b => 

{ 

b.ToTable("MyUserTokens"); 

}); 

modelBuilder.Entity<IdentityRole>(b => 

{ 

b.ToTable("MyRoles"); 

}); 

modelBuilder.Entity<IdentityRoleClaim<string>>(b => 

{ 

b.ToTable("MyRoleClaims"); 

}); 

modelBuilder.Entity<IdentityUserRole<string>>(b => 

{ 

b.ToTable("MyUserRoles"); 

}); 

} 

Bu örnekler, varsayılan kimlik türlerini kullanın. Bir uygulama türü gibi kullanıyorsanız Appiicationuser , varsayılan 
türü yerine bu tür yapılandırın. 


Aşağıdaki örnek, bazı sütun adlarını değiştirir: 





protected override void OnModelCreating(ModelBuilder modelBuilder) 

{ 

base.OnModelCreating(modelBuilder); 

modelBuilder.Entity<IdentityUser>(b => 

{ 

b.Property(e => e.Email).HasColumnName("EMail"); 

}); 

modelBuilder.Entity<IdentityUserClaim<string>>(b => 

{ 

b.Property(e => e.ClaimType).HasColumnName("CType"); 
b.Property(e => e.ClaimValue).HasColumnName("CValue"); 

}); 

} 

Veritabanı sütunlarının bazı türleri belirli ile yapılandırılabilir modelleri (örneğin, maksimum string izin verilen 
uzunluk). Aşağıdaki örnekte en çok uzunlukları sütun için çeşitli ayarlar string modelinde özellikleri: 

protected override void OnModelCreating(ModelBuilder modelBuilder) 

{ 

base.OnModelCreating(modelBuilder); 

modelBuilder.Entity<IdentityUser>(b => 

{ 

b.Property(u => u.UserName).HasMaxLength(128); 
b.Property(u => u.NormalizedUserName) .HasMaxl_ength(128); 
b.Property(u => u. Email) .HasMaxl_ength(128); 
b.Property(u => u.NormalizedEmail).HasMaxLength(128); 

}); 

modelBuilder.Entity<IdentityUserToken<string>>(b => 

{ 

b.Property(t => t.LoginProvider).HasMaxLength(128); 
b.Property(t => t.Name).HasMaxLength(128); 

}); 

} 

Farklı bir şemaya eşleme 

Şemalar, veritabanı sağlayıcıları arasında farklı şekilde davranabilir.SQL Server için varsayılan olarak tüm tabloları 
oluşturmaktır dbo şema. Tablolar farklı bir şema oluşturulabilir.Örneğin: 

protected override void OnModelCreating(ModelBuilder modelBuilder) 

{ 

base.OnModelCreating(modelBuilder); 
modelBuilder.HasDefaultSchema("notdbo"); 

} 

Yavaş yükleniyor 

Bu bölümde, yavaş yükleniyor proxy'si kimlik modeli için destek eklendi. Gezinti özellikleri, yüklenen ilk sağlamaya 
gerek kalmadan kullanılacak olanak tanıdığından Lazy yüklenirken kullanışlıdır. 

Varlık türleri yapılabilir uygun çeşitli yollarla yavaş yükleniyor açıklandığı EF Core belgeleri. Kolaylık olması için 
Gecikmeli yükleme proxy'leri gerektiren kullanın: 

• Yüklenmesini Microsoft.EntityFrameworkCore.Proxies paket. 

• Bir çağrı UseLazyLoadingProxies içinde AddDbContext<TContext >. 

• Genel varlık türleri ile pubiic Virtual Gezinti özellikleri. 








Aşağıdaki örnek, arama gösterir UseLazyLoadingPnoxies içinde Startup.ConfigureServices 


Services 

.AddDbContext<ApplicationDbContext>( 

b => b.UseSqlSenver(connectionString) 

.UseLazyLoadingProxies()) 

.AddDefaultIdentity<ApplicationUser>() 

.AddEntityFrameworkStores<ApplicationDbContext>(); 

Önceki örneklerde varlık türlerine Gezinti özellikleri ekleme Kılavuzu'na bakın. 

Ek kaynaklar 

• ASP.NET Core projelerinde yapı iskelesi kimliği 




ASPNET Core için topluluk OSS kimlik doğrulama 
seçenekleri 

29.10.2019 • 2 minutes to read ı Edit Online 


Bu sayfa AS P.N ET Core için topluluk tarafından sunulan, açık kaynaklı kimlik doğrulama seçeneklerini içerir.Yeni 
sağlayıcılar kullanılabilir hale geldiğinde Bu sayfa düzenli olarak güncelleştirilir. 

OSS kimlik doğrulama sağlayıcıları 

Aşağıdaki liste alfabetik olarak sıralanır. 


NAME 

AÇIKLAMA 

AspNet. Security. Openıdconnect. Server (ASOS) 

ASOS, ASP.NET Core ve OVVıN/Katana için düşük düzey, 
protokol-ilk OpenlD Connect sunucu çerçevesidir. 

Gluu sunucusu 

Kimlik, erişim yönetimi (lAM) ve çoklu oturum açma (SSO) için 
kurumsal özellikli, açık kaynaklı yazılım. Daha fazla bilgi için bkz. 

Gluu ürün belgeleri. 

IdentityServer 

IdentityServer, ASP.NET Core için bir OpenlD Connect ve 
OAuth 2,0 çerçevesidir, OpenlD Foundation ve .NET 
Foundation yönetimi altında. Daha fazla bilgi için bkz. 

ıdentityserver4 to VVelcome (belgeler). 

Openıddict 

Openıddict, ASP.NET Core için kullanımı kolay bir OpenlD 
Connect sunucusudur. 


Bir sağlayıcı eklemek için Bu sayfayı düzenleyin. 




ASPNET Core kimliği yapılandırma 

10.05.2019 • 8 minutes to read ı Edit Online 


ASP.NET Core kimliği, parola ilkesi ve kilitleme tanımlama bilgisi yapılandırması gibi ayarları için varsayılan 
değerleri kullanır. Bu ayarlar kılınabilir startup sınıfı. 

Kimlik seçenekleri 

IdentityOptions sınıf kimlik sistemi yapılandırmak için kullanılabilir seçenekleri temsil eder. identityOptions 
ayarlanmalıdır sonra çağırma Addidentity veya AddDefaultidentity . 

Talep Kimliği 

IdentityOptions.Claimsldentity belirtir ClaimsIdentityOptions aşağıdaki tabloda gösterilen özelliklere sahip. 


ÖZELLİK 

AÇIKLAMA 

VARSAYILAN 

RoleClaimType 

Alır veya bir rolü talep için kullanılan 
talep türünü ayarlar. 

ClaimTypes.Role 

SecurityStampClaimType 

Alır veya güvenlik damgası talep için 
kullanılan talep türünü ayarlar. 

AspNet.Identity.SecurityStamp 

UserldCIaimType 

Alır veya kullanıcı tanımlayıcısı talebi için 
kullanılan talep türünü ayarlar. 

ClaimTypes.Nameldentifier 

UserNameClaimType 

Alır veya kullanıcı adı talebi için 
kullanılan talep türünü ayarlar. 

ClaimTypes.Name 


Kilitleme 

Kilitleme kümesinde PassvvordSignlnAsync yöntemi: 









public async Task<IActionResult> OnPostAsync(string returnUrl = null) 

{ 

returnllrl = returnllrl ?? Url.Content("~/"); 

if (ModelState.IsValid) 

{ 

var result = await _signInManager.PasswordSignInAsync(Input.Email, 

Input.Password, Input.RememberMe, 
lockoutOnFailure: false); 
if (result.Succeeded) 

{ 

_logger.LogInformation("User logged in."); 
return LocalRedirect(returnllrl); 

} 

if (result.RequiresTwoFactor) 

{ 

return RedirectToPage(" ./LoginWith2fa", new { Returnllrl = returnllrl., 
Input.RememberMe }); 

} 

if (result.IsLockedOut) 

{ 

_logger.LogWarning("User account locked out."); 
return RedirectToPage("./Lockout"); 

} 

else 

{ 

ModelState.AddModelError(string.Empty, "Invalid login attempt."); 
return Page(); 

} 

} 

// If we got this far, something failed, redisplay form 
return Page(); 


Yukarıdaki kod dayanır Login kimlik şablonu. 

Kilitleme seçenekleri ayarlanır startup.configureServices : 


Services.Configure<IdentityOptions>(options => 

{ 

// Default Lockout settings. 

options.Lockout.DefaultLockoutTimeSpan = TimeSpan.FromMinutes(5); 
options.Lockout.MaxFailedAccessAttempts = 5; 
options.Lockout.AllowedForNewUsers = true; 

}); 


Önceki kod kümeleri IdentityOptions LockoutOptions varsayılan değerlere sahip. 

Başarılı bir kimlik doğrulaması başarısız erişim denemesi sayısını sıfırlar ve saatini sıfırlar. 
IdentityOptions.Lockout belirtir LockoutOptions tabloda gösterilen özelliklere sahip. 


ÖZELLİK 

AÇIKLAMA 

VARSAYILAN 

AllowedForNewUsers 

Yeni bir kullanıcı, kilitlenir belirler. 

true 


DefaultLockoutTimeSpan 


Bir kilitlenme oluştuğunda süreyi 
kullanıcı kilitlidir. 


5 dakika 







ÖZELLİK 


AÇIKLAMA 


VARSAYILAN 


MaxFailedAccessAttempts Kilitleme etkinse, bir kullanıcı kilitli kadar 5 

başarısız erişim denemesi sayısı. 


Parola 

Varsayılan olarak parola bir büyük harf, küçük harf, rakam ve alfasayısal olmayan karakter içerdiğini kimlik 
gerektirir. Parola en az altı karakter uzunluğunda olmalıdır. PassvvordOptions ayarlanabilir 
Startup.ConfigureServices . 


Services.Configure<IdentityOptions>(options => 

{ 

// Default Password settings. 
options.Password.RequireDigit = true; 
options.Password.RequireLowercase = true; 
options.Password.RequireNonAlphanumeric = true; 
options.Password.RequireUppercase = true; 
options.Password.RequiredLength = 6; 
options.Password.RequiredUniqueChars = 1; 

}); 


Services.AddldentitysApplicationUser, IdentityRole>(options => 

{ 

// Password settings 
options.Password.RequireDigit = true; 
options.Password.RequiredLength = 8; 
options.Password.RequiredUniqueChars = 2; 
options.Password.RequireLowercase = true; 
options.Password.RequireNonAlphanumeric = true; 
options.Password.RequireUppercase = true; 

}) 

.AddEntityFrameworkStores<ApplicationDbContext>() 

.AddDefaultTokenProviders(); 


Services.Configure<IdentityOptions>(options => 

{ 

// Password settings 
options.Password.RequireDigit = true; 
options.Password.RequiredLength = 8; 
options.Password.RequireNonAlphanumeric = false; 
options.Password.Requirellppercase = true; 
options.Password.RequireLowercase = false; 

}); 


ldentityOptions.Password belirtir PassvvordOptions tabloda gösterilen özelliklere sahip. 

ÖZELLİK AÇIKLAMA VARSAYILAN 

ReguireDigit Parolayı 0-9 arasında bir sayı gerektirir. true 


RequiredLength 

Minimum parola uzunluğu. 

6 

RequireLowercase 

Parola küçük harf karakter gerektirir. 

true 

RequireNonAlphanumeric 

Paroladaki alfasayısal olmayan bir 

true 


karakter gerektirir. 







ÖZELLİK 

AÇIKLAMA 

VARSAYILAN 

RequiredUniqueChars 

Yalnızca ASP.NET Core 2.0 ve üzeri için 
geçerlidir. 

Parola ayrı karakter sayısı gerektirir. 

1 . 

Requirellppercase 

Parola bir büyük harf karakteri gerektirir. 

true 

ÖZELLİK 

AÇIKLAMA 

VARSAYILAN 

RequireDigit 

Parolayı 0-9 arasında bir sayı gerektirir. 

true 

RequiredLength 

Minimum parola uzunluğu. 

6 

RequireLowercase 

Parola küçük harf karakter gerektirir. 

true 

ReguireNonAlphanumeric 

Paroladaki alfasayısal olmayan bir 
karakter gerektirir. 

true 


Requirellppercase Parola bir büyük harf karakteri gerektirir. true 

Oturum açma 

Aşağıdaki kod kümeleri signin ayarlarına (varsayılan değer): 

Services.Configure<IdentityOptions>(options => 

{ 

// Default Signin settings. 

options.Signin.RequireConfirmedEmail = false; 

options.Signin.RequireConfirmedPhoneNumber = false; 


Services.AddIdentity<ApplicationUser J IdentityRole>(options => 

{ 

// Signin settings 

options.Signin.RequireConfirmedEmail = true; 
options.Signin.RequireConfirmedPhoneNumber = false; 

}) 

.AddEntityFrameworkStores<ApplicationDbContext>() 

.AddDefaultTokenProviders(); 


IdentityOptions.Signin belirtir SignlnOptions tabloda gösterilen özelliklere sahip. 


ÖZELLİK 

AÇIKLAMA 

VARSAYILAN 

RequireConfirmedEmail 

Oturum açmak için bir onaylanan e- 

false 


posta gerektirir. 


ReguireConfirmedPhoneNumber 

Oturum açmak onaylanan telefon 

false 


numarası gerektirir. 



Belirteçler 

IdentityOptions.Tokens belirtir TokenOptions tabloda gösterilen özelliklere sahip. 











ÖZELLİK 


AÇIKLAMA 


AuthenticatorTokenProvider 

Alır veya ayarlar AuthenticatorTokenProvider iki Öğeli bir 
kimlik doğrulayıcı ile oturum açma işlemleri doğrulamak için 
kullanılır. 

ChangeEmailTokenProvider 

Alır veya ayarlar ChangeEmailTokenProvider e-posta 
değişikliği onay e-postalarda kullanılan belirteçleri oluşturmak 
için kullanılır. 

ChangePhoneNumberTokenProvider 

Alır veya ayarlar ChangePhoneNumberTokenProvider telefon 
numaralarını değiştirirken kullanılan belirteçleri oluşturmak için 
kullanılır. 

EmailConfirmationTokenProvider 

Alır veya hesap doğrulama e-postalarda kullanılan belirteçleri 
oluşturmak için kullanılan belirteç sağlayıcısı ayarlar. 

PasswordResetTokenProvider 

Alır veya ayarlar IUserTwoFactorTokenProvider<TUser > 

parola sıfırlama e-postalarda kullanılan belirteçleri oluşturmak 
için kullanılır. 

ProviderMap 

Oluşturmak için kullanılan bir kullanıcı belirteci sağlayıcısı 
anahtarla sağlayıcının adı olarak kullanılır. 

Kullanıcı 



Services.Configure<IdentityOptions>(options => 

{ 

// Default User settings. 

options.User.AllowedUserNameCharacters = 

"abcdefghijklmnopqrstuvwxyzABCDEFGHIDKLMNOPQRSTUVWXYZ0123456789-._@+"; 
options.User.RequireUniqueEmail = falsej 

}); 

IdentityOptions.User belirtir UserOptions tabloda gösterilen özelliklere sahip. 


ÖZELLİK 

AÇIKLAMA VARSAYILAN 

AllovvedUserNameCharacters 

Kullanıcı adı izin verilen karakter. abcdefghijklmnopqrstuvwxyz 

ABCDEFGHIJKLMNOPQRSTUVWXYZ 

0123456789 

-,_@+ 

RequireUniqueEmail 

Fler kullanıcının benzersiz bir e-posta false 

olmasını gerektirir. 

Tanımlama bilgisi ayarları 



Uygulamanın tanımlama bilgisini yapılandırın startup.configureServices . ConfigureApplicationCookie 
çağrılmalıdır sonra çağırma Addidentity veya AddDefaultidentity . 









Services.ConfigureApplicatİonCookie(options => 

{ 

options.AccessDeniedPath = "/Identity/Account/AccessDenied"; 
options.Cookie.Name = "YourAppCookieName"; 
options.Cookie.HttpOnly = true; 

options.ExpireTimeSpan = TimeSpan.FromMinutes(60); 
options.LoginPath = "/Identity/Account/Login"; 

// ReturnllrlParameter requires 

//using Microsoft.AspNetCore.Authentication.Cookies; 

options. ReturnllrlParameter = CookieAuthenticationDef aults. ReturnllrlParameter; 
options.SlidingExpiration = true; 

}); 


Services.ConfigureApplicationCookie(options => 

{ 

options.AccessDeniedPath = "/Account/AccessDenied"; 
options.Cookie.Name = "YourAppCookieName"; 
options.Cookie.HttpOnly = true; 

options.ExpireTimeSpan = TimeSpan.FromMinutes(60); 
options.LoginPath = "/Account/Login"; 

// ReturnllrlParameter requires 'using Microsoft.AspNetCore.Authentication.Cookies;' 
options. ReturnllrlParameter = CookieAuthenticationDef aults. ReturnllrlParameter; 
options.SlidingExpiration = true; 

}); 


Services.Configure<IdentityOptions>(options => 

{ 

// Cookie settings 

options.Cookies.ApplicationCookie.CookieName = "YourAppCookieName"; 
options.Cookies.ApplicationCookie.ExpireTimeSpan = TimeSpan.FromDays(150); 
options.Cookies.ApplicationCookie.LoginPath = "/Account/Login"; 
options.Cookies.ApplicatİonCookie.AccessDeniedPath = "/Account/AccessDenied"; 
options.Cookies.ApplicationCookie.AutomaticAuthenticate = true; 

// Requires using Microsoft.AspNetCore.Authentication.Cookies;' 
options .Cookies .ApplicationCookie. Aut hent icat ionScheme = 

CookieAuthenticationDef aults. Aut hent icat ionScheme; 

options. Cookies .ApplicationCookie. ReturnllrlParameter = CookieAuthenticationDef aults. ReturnllrlParameter; 

}); 


Daha fazla bilgi için CookieAuthenticationOptions. 

Parola karma değeri Oluşturucusu seçenekleri 

PassvvordHasherOptions parola karma seçeneklerini ayarlar ve alır. 

SEÇENEK AÇIKLAMA 


CompatibilityMode Yeni parola kararken kullanılan uyumluluk modu. Varsayılan 

olarak ldentityV3. Adlı bir karma hale getirilen parolayla ilk 
baytına bir biçimi işaret, parola karması için kullanılan karma 
algoritması sürümünü belirtir. Parola Karması karşı 
doğrulanırken VerifyHashedPassvvord yöntemi ilk baytın 
üzerinde göre doğru algoritmayı seçer. Bir istemci 
bakılmaksızın kimlik doğrulaması için parola karma hale hangi 
algoritmanın sürümü kullanıldı. Uyumluluk modu ayarını 
etkiler, karma yeni parolalar. 



SEÇENEK 


AÇIKLAMA 


IterationCount Parolaları PBKDF2 kullanarak kararken kullanılan yineleme 

sayısı. Bu değer, yalnızca kullanılan zaman CompatibilityMode 
ayarlanır ldentityV3. Değer pozitif bir tamsayı ve varsayılan 
olarak olmalıdır 10000 . 

Aşağıdaki örnekte, IterationCount ayarlanır 12000 içinde startup.configureServices : 


// using Microsoft.AspNetCore.Identity; 

Services.Configure<PasswordHasherOptions>(option => 

{ 

option.IterationCount = 12000; 

}); 





ASRNET Core VVindovvs kimlik doğrulamasını 
yapılandırma 
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Tarafından Scott Addieve Luke Latham 

VVindovvs kimlik doğrulaması (anlaşma, Kerberos veya NTLM kimlik olarak da bilinir) ile barındırılan 
ASP.NET Core uygulamaları için yapılandırılabilir IIS, Kestrel, veya HTTP.sys . 

VVindovvs kimlik doğrulaması (anlaşma, Kerberos veya NTLM kimlik olarak da bilinir) ile barındırılan 
ASP.NET Core uygulamaları için yapılandırılabilir IIS veya HTTP.sys. 

VVindovvs kimlik doğrulaması, ASP.NET Core uygulamaları, kullanıcıların kimliklerini doğrulamak için 
işletim sistemi kullanır. Sunucunuz, kullanıcıları tanımlamak için Active Directory etki alanı kimlikleri veya 
VVindovvs hesaplarını kullanarak bir şirket ağında çalıştığında, VVindovvs kimlik doğrulaması kullanabilirsiniz. 
VVindovvs kimlik doğrulaması nerede kullanıcılar, istemci uygulamaları ve web sunucuları aynı VVindovvs etki 
alanına ait intranet ortamları için idealdir. 


NOTE 

VVindovvs kimlik doğrulaması, HTTP/2 ile desteklenmiyor. Kimlik doğrulama sınaması, HTTP/2 yanıtları gönderilebilir, 
ancak önce kimlik doğrulaması, istemci HTTP/1.1 düşürme gerekir. 


IIS/l IS Express 

Kimlik doğrulama hizmetleri çağırarak ekleme AddAuthentication 

(Microsoft.AspNetCore.Server.llSIntegration ad alanı) içinde startup.configureServices : 

Services.AddAuthentication(IISDefaults.AuthenticationScheme); 

Başlatma ayarları (hata ayıklayıcı) 

Başlatma ayarları yapılandırması yalnızca etkiler Properties/launchSettings.jsorı dosya için IIS Express ve IIS 
için VVindovvs kimlik doğrulaması yapılandırmaz. Sunucu Yapılandırması içinde açıklanan IIS bölümü. 

Web uygulaması şablonu Visual Studio veya .N ET Core CLI aracılığıyla kullanılabilir, VVindovvs kimlik 
doğrulamasını güncelleştiren destekleyecek şekilde yapılandırılabilir Properties/launchSettings.jsorı dosyası 
otomatik olarak. 

• Visual Studio 

• Visual Studio Code / .N ET Core CLI 

Yeni Proje 

1. Yeni bir proje oluşturun. 

2. Seçin ASP.N ET Core Web uygulaması. İleri yi seçin. 

3. Bir ad sağlayın proje adı alan. Onayla konumu giriş doğru olduğundan veya proje için bir konum 
sağlayın. Oluştur'u seçin. 

4. Seçin değişiklik altında kimlik doğrulaması. 

5. içinde kimlik doğrulamayı Değiştir penceresinde VVindovvs kimlik doğrulaması. Tamam ı seçin. 






6. Seçin Web uygulaması. 

7. Oluştur'u seçin. 

Uygulamayı çalıştırın. Kullanıcı işlenen uygulamanın kullanıcı arabiriminde görüntülenir. 

Mevcut proje 

Projenin özelliklerini VVİndovvs kimlik doğrulamasını etkinleştirmek ve anonim kimlik doğrulamasını devre 
dışı bırakın: 

1. Projeye sağ Çözüm Gezgini seçip özellikleri. 

2. Seçin hata ayıklama sekmesi 

3. Onay kutusunu temizleyin anonim kimlik doğrulamasını etkinleştir. 

4. Onay kutusunu seçin VVİndovvs kimlik doğrulamasını etkinleştir. 

5. Kaydet ve özellik sayfasını kapatın. 

Alternatif olarak, özellikler, yapılandırılabilir iisSettings düğümünün launchSettings.jsorı dosyası: 

"iisSettings": { 

"windowsAuthentication": true, 

"anonymousAuthentication": false, 

"iisExpress": { 

"applicationUrl": "http://localhost:52171 /", 

"sslPort": 44308 

} 

} 

Mevcut bir projeyi değiştirirken, proje dosyası için bir paket başvurusu içerdiğini onaylamak 
Microsoft.AspNetCore.App metapackage veya Microsoft.AspNetCore.Authentication NuGet paketi. 

IIS 

11S kullanan ASP.NET Core Modülü konak ASP.NET Core uygulamaları için. VVİndovvs kimlik doğrulaması 
için IIS yapılandırılır web.config dosya. Aşağıdaki bölümlerde show nasıl yapılır: 

• Yerel bir sağlamak web.config dosya uygulama dağıtıldığında, sunucu üzerinde VVİndovvs kimlik 
doğrulamasını etkinleştirir. 

• IIS Yöneticisini yapılandırmak için kullanın web.conflg dosyası sunucuda zaten dağıtılmış bir ASP.NET 
Core uygulaması. 

Zaten yapmadıysanız, IIS için ASP.NET Core uygulamaları barındırın etkinleştirin. Daha fazla bilgi için bkz. 
IIS ile VVİndovvs üzerinde ASP.NET Core barındırma. 

VVİndovvs kimlik doğrulaması için IIS rolü hizmetini etkinleştirin. Daha fazla bilgi için IIS rol hizmetlerini 
(bkz. 2. adım), VVİndovvs kimlik doğrulamasını etkinleştir. 

IIS tümleştirme ara yazılımı otomatik olarak isteklerinin kimliğini doğrulamak için varsayılan olarak 
yapılandırılır. Daha fazla bilgi için ana bilgisayar VVİndovvs IIS üzerinde ASP.NET Core: IIS seçeneklerini 
(AutomaticAuthentication). 

AS P.N ET Core modülü varsayılan olarak, varsayılan olarak VVİndovvs kimlik doğrulaması belirteci 
uygulamaya iletmek için yapılandırılır. Daha fazla bilgi için ASP.NET Core Modüle yapılandırma başvurusu 
AspNetCore öğenin öznitelikleri. 

Kullanım ya da aşağıdaki yaklaşımlardan biri: 

• Projeyi dağıtma ve yayımlama önce aşağıdaki v/eb.config proje kök dosya: 




<?xml version="1.0" encoding="utf-8"?> 

<configuration> 

<location path="." inheritInChildApplications="false"> 
<system.webServen> 

<security> 

<authentication> 

<anonymousAuthentication enabled="false" /> 
<windowsAuthentication enabled="true" /> 

</authentication> 

</security> 

</system.webServer> 

</location> 

</configuration> 


Proje .NET Core SDK'sı tarafından yayımlanmıştır ne zaman (olmadan 

<isTnansfonmwebConfigDisabied> özelliğini true proje dosyasında), yayımlanan web.config dosyasını 
içeren <locationxsystem.webServerxsecurityxauthentication> bölümü. Daha fazla bilgi için 
<isTransformwebConfigDisabied> özelliği bkz 1 1S ile VVİndovvs üzerinde ASP.NET Core barındırma. 

• Sonra projeyi dağıtma ve yayımlama sunucu tarafı yapılandırması 11S Yöneticisi ile gerçekleştirin: 

1. 11S Yöneticisinde 11S sitesi altında seçin siteleri düğümünün bağlantıları kenar çubuğu. 

2. Çift kimlik doğrulaması içinde 11S alan. 

3. Seçin anonim kimlik doğrulaması. Seçin devre dışı içinde eylemleri kenar çubuğu. 

4. Seçin VVİndovvs kimlik doğrulaması. Seçin etkinleştirme içinde eylemleri kenar çubuğu. 

Bu eylemler gerçekleştirildikçe, MS Yöneticisi'ni uygulamanın değiştirir v/eb.config dosya. A 
<system. webServer'><securityxaut hent icat ion> düğümü için güncelleştirilmiş ayarlarla eklenir 
anonymousAuthentication ve windowsAuthentication : 

<system.webServen> 

<security> 

<authentication> 

<anonymousAuthentication enabled="false" /> 

<windowsAuthentication enabled="true" /> 

</authentication> 

</security> 

</system.webServer> 

<system.webServen> Bölümüne eklenen web.config dosyasıdır US Yöneticisi tarafından uygulamanın 
dışında <iocation> uygulama yayımlandığında, .NET Core SDK'sı tarafından eklenen bölümü. 
Bölümün dışında eklendiğinden <iocation> düğümünü ayarları tarafından devralınır alt 
uygulamaları geçerli uygulama. Devralma önlemek için ek taşıma <security> içine bölümünde 
<iocationxsystem.webServer> .NET Core SDK'sını sağlanan bölüm. 

MS Yöneticisi, MS yapılandırması eklemek için kullanıldığında, uygulamanın yalnızca etkiler 
v/eb.config dosya sunucusunda. Uygulamanın bir sonraki dağıtım sunucudaki ayarları varsa üzerine 
yazabilir sunucunun kopyasını v/eb.config projenin tarafından değiştirilir v/eb.config dosya. Kullanım 
ya da ayarlarını yönetmek için aşağıdaki yaklaşımlardan biri: 

o Ayarlar sıfırlamak için MS Yöneticisi'ni kullanın v/eb.config dağıtımı dosyanın üzerine yazılır sonra 
dosya. 

o Ekleme bir v/eb.config dosyasını uygulamada yerel olarak ayarlar. 

Kestrel 

Microsoft.AspNetCore.Authentication.Negotiate NuGet paketi ile kullanılabilir Kestrel VVİndovvs VVİndovvs, 












Linux ve Macos'ta anlaşma, Kerberos ve NTLM kullanarak kimlik doğrulamasını desteklemek için. 


VVARNING 

Kimlik bilgileri bağlantı istekleri arasında kalıcı. Anlaşma kimlik doğrulaması değil kullanılmalıdır proxy'leriyle sürece 
proxy Kestrel ile 7:7 bağlantı benzeşimi (kalıcı bir bağlantı) korur. 


NOTE 

Görüşme işleyicisi, temel alınan sunucusunda yerel olarak Windows kimlik doğrulamayı destekliyorsa ve etkin 
olduğunda algılar. Sunucusu Windows kimlik doğrulamasını destekliyor, ancak devre dışı sunucusu uygulaması 
etkinleştirmek isteyen bir hata oluşturulur. Sunucuda Windows kimlik doğrulaması etkinleştirildiğinde, Negotiate 
işleyici şeffaf bir şekilde kendisine iletir. 


Kimlik doğrulama hizmetleri çağırarak ekleme AddAuthentication ( 


Microsoft.AspNetCore.Authentication.Negotiate 

ad alanı) ve 

AddNegotitate 

( 

Microsoft.AspNetCore.Authentication.Negotiate 

ad alanı) içinde 

Startup.ConfigureServices : 


Services.AddAuthentication(NegotiateDefaults.AuthenticationScheme) 

.AddNegotiate (); 

Kimlik doğrulaması ara yazılımı çağırarak ekleme UseAuthentication içinde startup.configure : 

app.UseAuthentication(); 
app.UseMvc(); 

Ara yazılım hakkında daha fazla bilgi için bkz. AS P.N ET Core ara yazılımı. 

Anonim isteklere izin verilir. Kullanım ASP.NET Core yetkilendirme kimlik doğrulaması için anonim 
isteklere meydan okuyun. 

Windows ortamını yapılandırma 

Microsoft.AspNetCore.Authentication.Negotiate bileşeni kullanıcı modu kimlik doğrulaması gerçekleştirir. 
Hizmet asıl adları (SPN) makine hesabı değil hizmetini çalıştıran kullanıcı hesabına eklenmelidir.Yürütme 
setspn -S HTTP/mysrevername. mydomain.com myuser bir yönetim komut kabuğu nda. 

Linux ve Macos'ta ortamı yapılandırma 

Bir Linux veya Macos'ta makine bir VVİndovvs etki alanına katmak için yönergeler kullanılabilir Azure veri 
Studio VVİndovvs kimlik doğrulaması - Kerberos kullanarak SQL sunucunuza bağlanmak makalesi. 
Yönergeleri Linux makinesi için bir makine hesabı etki alanında oluşturun. Bu makine hesabı için SPN 
eklenmesi gerekir. 


NOTE 

' Deki yönergeleri takip ederken Azure veri Studio VVİndovvs kimlik doğrulaması - Kerberos kullanarak SQL 
sunucunuza bağlanmak makalesi, yerine python-software-properties ile python3-software-properties 
gerekirse. 


Linux veya Macos'ta makine etki alanına katılmış sonra sağlamak için ek adımlar gereklidir bir anahtar 
tablosu dosya SPN'ler ile: 

• Etki alanı denetleyicisinde makine hesabı için yeni bir vveb hizmeti SPN'ler ekleyin: 










o setspn -S HTTP/mywebservice. mydomain.com mymachine 
o setspn -S HTTP/mywebservice@MYDOMAIN.COM mymachine 

• Kullanım ktpass anahtar tablosu dosyası oluşturmak için: 

ktpass -princ HTTP/mywebservice. mydomain.com@MYDOMAIN.COM -pass myKeyTabFilePassword -mapuser 
MYDOMAIN\mymachine$ -pType KRB5_NT_PRINCIPAL -out c:\temp\mymachine.HTTP.keytab -cnypto AES256- 
o SHAİ 

o Bazı alanları belirtilmelidir gösterildiği gibi büyük. 

• Anahtar tablosu dosyasını Linux veya Macos'ta makineye kopyalayın. 

• Bir ortam değişkeni aracılığıyla anahtar tablosu dosyayı seçin: 

export KRB5_KTNAME=/tmp/mymachine.HTTP.keytab 

• Çağırma klist şu anda kullanılabilir SPN'ler gösterilecek. 


NOTE 

Bir anahtar tablosu dosyası, etki alanı erişim kimlik bilgileri içeriyor ve uygun şekilde korunması gerekir. 


HTTP.sys 

HTTP.sys çekirdek modu VVİndovvs Negotiate, NTLM veya temel kimlik doğrulamasını kullanarak kimlik 
doğrulaması destekler. 

Kimlik doğrulama hizmetleri çağırarak ekleme AddAuthentication (Microsoft.AspNetCore.Server.HttpSys 
ad alanı) içinde Startup.ConfigureServices : 

Services.AddAuthent icat ion(HttpSysDef ault s. Authent icat ionScheme); 


Uygulamanın web ana HTTP.sys VVİndovvs kimlik doğrulaması için yapılandırma ( Program.es ). UseHttpSys 
içinde Microsoft.AspNetCore.Server.HttpSys ad alanı. 

public elass Program 

{ 

public static void Main(string[] args) 

{ 

CreateHostBuilder(args).Build().Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>() 

.UseHttpSys(options => 

{ 

options.Authentication.Schemes = 

AuthenticationSchemes.NTLM | 

AuthenticationSchemes.Negotiate; 
options.Authentication.AllowAnonymous = false; 

}); 

}); 

} 










public class Program 

{ 

public static void Main(string[] args) => 
BuildWebHost(args).Run(); 

public static II/JebHost BuildWebHost(string[] args) => 
WebHost.CreateDefaultBuilder(args) 
.UseStartup<Startup>() 

.UseHttpSys(options = > 

{ 

options.Authentication.Schemes = 
AuthenticationSchemes.NTLM | 

AuthenticationSchemes.Negotiate; 
options.Authentication.AllouıAnonymous = false; 

}) 

.Build(); 

} 


NOTE 

Çekirdek modu kimlik doğrulaması Kerberos kimlik doğrulama protokolü HTTP.sys temsil eder. Kullanıcı modu kimlik 
doğrulaması, Kerberos ve HTTP.sys ile desteklenmez. Makine hesabı Kerberos belirteci/Active Directory'den elde 
edilen anahtar şifresini çözmek için kullanılan ve kullanıcının kimliğini doğrulamak için istemcinin sunucuya iletilir. 
Hizmet asıl adı (SPN) konak için değil uygulamanın kullanıcı kaydedin. 


NOTE 

HTTP.sys sürüm 1709 veya üzeri Nano Sunucu'da desteklenmemektedir. Windows kimlik doğrulaması ve HTTP.sys 
Nano Server ile kullanmak için bir (microsoft/vvindovvsservercore) Server Core kapsayıcı. Sunucu Çekirdeği hakkında 
daha fazla bilgi için bkz. Windows Server'da Sunucu Çekirdeği yükleme seçeneği nedir?. 


Kullanıcıları yetkilendirme 

Anonim erişim yapılandırma durumunu yolla belirler [Authorize] ve [AiiowAnonymous] öznitelikleri, 
uygulamada kullanılır. Aşağıdaki iki bölümü anonim erişime izin verilmeyen ve izin verilen yapılandırma 
durumunu nasıl ele alınacağını açıklar. 

Anonim erişime izin verme 

VVİndovvs kimlik doğrulaması etkinleştirildiğinde ve adsız erişim devre dışıysa, [Authorize] ve 
[AiiowAnonymous] özniteliklerinin etkisi yoktur. İstek, hiçbir zaman bir 11S sitesi anonim erişime izin 
vermeyecek şekilde yapılandırılmışsa, uygulama ulaşır. Bu nedenle, [AiiowAnonymous] özniteliği geçerli değil. 

Anonim erişime izin ver 

VVİndovvs kimlik doğrulaması hem anonim erişim etkin olduğunda, kullanmak [Authorize] ve 
[AiiowAnonymous] öznitelikleri. [Authorize] Özniteliği güvenli kimlik doğrulaması gerektiren uygulama uç 
olanak tanır. [AiiowAnonymous] Öznitelik geçersiz kılmalarını [Authorize] anonim erişime izin veren 
uygulamalarında öznitelik. Öznitelik kullanım ayrıntıları için bkz. AS P.N ET core'da basit yetkilendirme. 


NOTE 

Varsayılan olarak, yetersiz bir sayfaya erişmek için yetkilendirme kullanıcılar ile boş bir HTTP 403 yanıtı sunulur. 
StatusCodePages ara yazılım kullanıcılar daha iyi bir "Erişim engellendi" deneyimi sunmak için yapılandırılabilir. 















Kimliğe bürünme 

ASP.NET Core, kimliğe bürünme uygulamaz. Uygulamalar, uygulama havuzu veya işlem kimliğini 
kullanarak, tüm istekler için uygulamanın kimlik ile çalıştırın. Uygulamanın kullanıcı adına bir eylem 
gerçekleştirmeniz gereken kullanırsanız Windowsldentity.Runlmpersonated içinde bir terminal satır içi ara 
yazılım içinde startup.configure . Bu bağlamda tek bir eylem çalıştırın ve ardından bağlam kapatın. 

app.Run(async (context) => 

{ 

try 

{ 

var user = (WindowsIdentity)context.User.Identity; 
await context.Response 

.WriteAsync($"User: {user.Name}\tState: {user.ImpersonationLevel}\n")j 

WindowsIdentity.RunImpersonated(user.AccessToken, () => 

{ 

var impersonatedUser = WindowsIdentity.GetCurrent(); 
var message = 

$"User: {impersonatedUser.Name}\t" + 

$"State: {İmpersonatedUser.ImpersonationLevel}"; 

var bytes = Encoding.UTF8.GetBytes(message); 
context.Response.Body.Write(byteSj 0 , bytes.Length); 

}); 

} 

catch (Exception e) 

{ 

await context.Response.WriteAsync(e.ToString()); 

} 

}); 

Runimpersonated zaman uyumsuz işlemleri desteklemeyen ve karmaşık senaryolar için kullanılmamalıdır. 
Örneğin, tüm istekleri veya bir ara yazılım zincirleri sarmalama desteklenen önerilen veya değil. 

Sırada Microsoft.AspNetCore.Authentication.Negotiate paket, Windows kimlik doğrulamasını etkinleştirir, 
Linux ve Macos'ta kimliğe bürünme yalnızca VVİndovvs üzerinde desteklenir. 

Talep dönüştürmeleri 

IIS ile barındırırken AuthenticateAsync dahili olarak bir kullanıcı başlatmak için çağırılır değil. Bu nedenle, 
bir IClaimsTransformation her kimlik doğrulaması varsayılan olarak etkinleştirilmez sonra talepleri 
dönüştürmek için kullanılan uygulama. Daha fazla bilgi ve talep dönüştürmeleri etkinleştiren bir kod örneği 
için bkz: ASP.NET Core Modülü. 

IIS işlem içi moduyla barındırırken AuthenticateAsync dahili olarak bir kullanıcı başlatmak için çağırılır değil. 
Bu nedenle, bir IClaimsTransformation her kimlik doğrulaması varsayılan olarak etkinleştirilmez sonra 
talepleri dönüştürmek için kullanılan uygulama. Daha fazla bilgi ve barındırma işlemi içinde talep 
dönüştürmeleri etkinleştiren bir kod örneği için bkz: ASP.NET Core Modülü. 

Ek kaynaklar 

• dotnet publish 

• IIS ile VVİndovvs üzerinde ASP.NET Core barındırma 

• ASP.NET Core Modülü 

• ASP.NET Core uygulama dağıtımı için Visual Studio yayımlama profilleri (. pubxml) 





ASPNET Core kimlik için özel depolama sağlayıcıları 
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Steve Smith tarafından 

ASP.NET Core kimlik, özel bir depolama sağlayıcısı oluşturup uygulamanıza bağlayabilmenizi sağlayan 
genişletilebilir bir sistemdir. Bu konu, ASP.NET Core kimlik için özelleştirilmiş bir depolama sağlayıcısının nasıl 
oluşturulacağını açıklamaktadır. Kendi depolama sağlayıcınızı oluşturmaya yönelik önemli kavramları ele alır, ancak 
adım adım bir adım adım değildir. 

GitHub 'dan örnek görüntüleyin veya indirin. 

Giriş 

Varsayılan olarak ASP.NET Core kimlik sistemi, Kullanıcı bilgilerini Entity Framework Core kullanarak SQL Server 
veritabanında depolar. Birçok uygulama için bu yaklaşım iyi bir sonuç verir. Ancak, farklı bir Kalıcılık mekanizması 
veya veri şeması kullanmayı tercih edebilirsiniz. Örneğin: 

• Azure Tablo depolama veya başka bir veri deposu kullanıyorsunuz. 

• Veritabanı tablolarınız farklı bir yapıya sahip. 

• Kabergibi farklı bir veri erişimi yaklaşımı kullanmak isteyebilirsiniz. 

Bu durumların her birinde, depolama mekanizmanız için özelleştirilmiş bir sağlayıcı yazabilir ve bu sağlayıcıyı 
uygulamanıza takabilirsiniz. 

ASP.NET Core kimlik, Visual Studio 'daki proje şablonlarına "bireysel kullanıcı hesaplan" seçeneği ile dahildir. 

.NET CoreCLI kullanırken -an individual ekleyin: 

dotnet new mvc -au individual 


ASP.NET Core Identity mimarisi 

AS P.N ET Core kimlik, Yöneticiler ve depolar adlı sınıflardan oluşur. Yöneticiler , bir uygulama geliştiricisinin bir 
kimlik kullanıcısı oluşturma gibi işlemleri gerçekleştirmek için kullandığı üst düzey sınıflardır. Depolar , kullanıcılar 
ve roller gibi varlıkların nasıl kalıcı olduğunu belirten alt düzey sınıflardır. Depolar depo modelini izler ve kalıcılık 
mekanizmasıyla yakından ilişkilidir. Yöneticiler mağazalardan ayrılır, bu da uygulama kodunuzu değiştirmeden 
(yapılandırma dışında) Kalıcılık mekanizmasını değiştirebilirsiniz. 

Aşağıdaki diyagramda, bir Web uygulamasının yöneticileriyle nasıl etkileşim kurduğu, mağazalarda veri erişim 
katmanıyla etkileşim kurma yöntemi gösterilmektedir. 






ASP.NET Core 
App 


Identity Manager 



Identity Store 



Data Access 
Layer 



Data Source 


Example: User Manager, RoleManager 


Example: UserStore, RoleStore 


Example: SQL Server Database, Azure Table Storage 


Özel bir depolama sağlayıcısı oluşturmak için veri kaynağını, veri erişim katmanını ve bu veri erişim katmanıyla 
etkileşime geçen mağaza sınıflarını oluşturun (Yukarıdaki diyagramda yeşil ve gri kutular). Yöneticileri veya 
bunlarla etkileşim kuran uygulama kodunuzu özelleştirmeniz gerekmez (Yukarıdaki mavi kutular). 

userManager veya RoleManager yeni bir örneğini oluştururken Kullanıcı sınıfının türünü sağlarsınız ve depo sınıfının 
bir örneğini bir bağımsız değişken olarak geçitirsiniz. Bu yaklaşım özelleştirilmiş sınıflarınızı ASP.NET Core 
eklemenize olanak sağlar. 

Yeni depolama sağlayıcısını kullanmak için uygulamayı yeniden yapılandırma UserManager ve RoleManager 
özelleştirilmiş bir depolamayla nasıl örneklendirilemeyeceğini gösterir. 

ASP.NET Core kimlik veri türlerini depolar 

AS P.N ET Core Identity veri türleri aşağıdaki bölümlerde ayrıntılı olarak verilmiştir: 

Kullanıcılarına 

Web sitenizin kayıtlı kullanıcıları. Identityuser türü, kendi özel türü için bir örnek olarak genişletilebilir veya 
kullanılıyor olabilir. Kendi özel kimlik depolama çözümünüzü uygulamak için belirli bir türden devralma gerekmez. 

Kullanıcı talepleri 

Kullanıcının kimliğini temsil eden kullanıcı hakkındaki deyimler (veya talepler) kümesi. Kullanıcı kimliğinin, roller 
aracılığıyla elde edilebileceğinden daha fazla ifadesini etkinleştirebilir. 

Kullanıcı oturumu açma 

Bir kullanıcıya oturum açarken kullanmak üzere dış kimlik doğrulama sağlayıcısı (Facebook veya bir Microsoft 
hesabı gibi) hakkında bilgiler. Örnek 

Lerdir 

Sitenizin yetkilendirme grupları. Rol kimliği ve rol adı ("admin" veya "Employee" gibi) içerir.Örnek 














Veri erişim katmanı 

Bu konuda, kullanacağınız Kalıcılık mekanizması hakkında bilgi sahibi olduğunuz ve bu mekanizma için nasıl varlık 
oluşturacağınız varsayılmaktadır. Bu konu, depoları veya veri erişim sınıflarını oluşturma hakkında ayrıntılı bilgi 
sağlamaz; ASP.NET Core kimlikle çalışırken tasarım kararları hakkında bazı öneriler sağlar. 

Özelleştirilmiş bir mağaza sağlayıcısı için veri erişim katmanını tasarlarken çok fazla özgürlük vardır. Yalnızca 
uygulamanızda kullanmayı düşündüğünüz özellikler için kalıcılık mekanizmaları oluşturmanız gerekir. Örneğin, 
uygulamanızda roller kullanmıyorsanız, roller veya Kullanıcı rolü ilişkilendirmeleri için depolama alanı oluşturmanız 
gerekmez. Teknolojiniz ve mevcut altyapınız, AS P.N ET Core kimliğin varsayılan uygulamasından çok farklı bir yapı 
gerektirebilir. Veri erişim katmanınızdaki depolama uygulamanızın yapısıyla çalışma mantığını sağlarsınız. 

Veri erişim katmanı, verileri AS P.N ET Core kimliğinden bir veri kaynağına kaydetme mantığını sağlar. 
Özelleştirilmiş depolama sağlayıcınızla ilgili veri erişim katmanı, Kullanıcı ve rol bilgilerini depolamak için aşağıdaki 
sınıfları içerebilir. 

Bağlam sınıfı 

Kalıcılık mekanizmanıza bağlanmak ve sorguları yürütmek için bilgileri kapsüller. Birçok veri sınıfı, genellikle 
bağımlılık ekleme yoluyla sağlanmış olan bu sınıfın bir örneğini gerektirir. Örnek. 

Kullanıcı depolaması 

Kullanıcı bilgilerini depolar ve alır (Kullanıcı adı ve parola karması gibi). Örnek 

Rol depolama 

Rol bilgilerini depolar ve alır (rol adı gibi). Örnek 

Userclaim depolaması 

Kullanıcı talep bilgilerini depolar ve alır (talep türü ve değeri gibi). Örnek 

UserLogins depolaması 

Kullanıcı oturum açma bilgilerini depolar ve alır (örneğin, bir dış kimlik doğrulama sağlayıcısı). Örnek 

UserRole depolaması 

Hangi rollerin hangi kullanıcılara atandığını depolar ve alır. Örnek 

İpucu: Yalnızca uygulamanızda kullanmayı düşündüğünüz sınıfları uygulayın. 

Veri erişim sınıflarında, kalıcılık mekanizmanız için veri işlemlerini gerçekleştirmek üzere kod sağlayın. Örneğin, 
özel bir sağlayıcı içinde, Mağaza sınıfında yeni bir kullanıcı oluşturmak için aşağıdaki koda sahip olabilirsiniz: 

public async Task<IdentityResult> CreateAsync(ApplicationUser user, 

CancellationToken cancellationToken = default(CancellationToken)) 

{ 

cancellationToken.ThrowIfCancellationRequested(); 

if (user == null) throw new ArgumentNullException(nameof(user)); 

return await _usersTable.CreateAsync(user); 

} 

Kullanıcı oluşturmaya yönelik uygulama mantığı aşağıda gösterilen _usersTabie.createAsync yöntemidir. 

Kullanıcı sınıfını özelleştirme 

Bir depolama sağlayıcısı uygularken, ıdentityuser sınıfınaeşdeğer bir Kullanıcı sınıfı oluşturun. 

En azından, Kullanıcı sınıfınız bir id ve userName özelliği içermelidir. 








identityuser sınıfı, istenen işlemleri gerçekleştirirken userManager çağırdığı özellikleri tanımlar, id özelliğinin 
varsayılan türü bir dizedir, ancak IdentityUser-cTKey, TUserClaim, TUserRole, TUserLogin, TUserToken> Öğesinden 
kalıtımla alabilir ve farklı bir tür belirtebilirsiniz. Çerçeve, depolama uygulamasının veri türü dönüştürmelerini 
işlemesini bekler. 

Kullanıcı deposunu özelleştirme 

Kullanıcı üzerindeki tüm veri işlemlerine yönelik yöntemleri sağlayan bir Userstore sınıfı oluşturun. Bu sınıf, 
userStore<TUser> sınıfına eşdeğerdir, userstore sınıfınıza ıuserstore<TUser> ve gerekli olan isteğe bağlı 
arabirimleri uygulayın. Uygulamanızda belirtilen işlevlere göre hangi isteğe bağlı arabirimlerin uygulanacağını 
seçersiniz. 

İsteğe bağlı arabirimler 

• luserrolestore 

• luserclaimstore 

• luserpassvvordstore 

• lusersecuritystampstore 

• luseremailstore 

• luserphonenumberstore 

• lqueryab!euserstore 

• luserloginstore 

• lusertvvofactorstore 

• luserlockoutstore 

isteğe bağlı arabirimler ıuserstore<TUser> devralınır. Örnek uygulamadakısmen uygulanmış bir örnek kullanıcı 
deposu görebilirsiniz. 

userstore sınıfı içinde, işlemleri gerçekleştirmek için oluşturduğunuz veri erişim sınıflarını kullanırsınız. Bunlar 
bağımlılık ekleme kullanılarak geçirilir. Örneğin, kaber uygulamasıyla SOL Server, Userstore sınıfı yeni bir kayıt 
eklemek için DapperusersTable örneğini kullanan createAsync yöntemine sahiptir: 

public async Task<IdentityResult> CreateAsync(ApplicationUser user) 

{ 

string sql = "INSERT INTO dbo.CustomUser " + 

"VALUES (@id, @Email, @EmailConfirmedj @PasswordHash, @UserName)"; 

int rows = await _connection.ExecuteAsync(sqlj new { user.Id, user.Email, user.EmailConfirmed, 
user.PasswordHash, user.UserName }); 

if(rows >0) 

{ 

return IdentityResult.Success; 

} 

return IdentityResult.Failed(new IdentityError { Description = $"Could not insert user {user.Email}." }); 

} 

Kullanıcı deposunu özelleştirirken uygulanacak arabirimler 

• I userstore 

luserstore<tuser> arabirimi, kullanıcı deposunda uygulamanız gereken tek arabirimdir. Kullanıcıları oluşturma, 
güncelleştirme, silme ve alma yöntemlerini tanımlar. 

• luserclaimstore 

luserclaimstore<TUser> arabirimi, Kullanıcı taleplerini etkinleştirmek için uyguladığınız yöntemleri tanımlar. 
Kullanıcı taleplerini ekleme, kaldırma ve alma yöntemlerini içerir. 

• luserloginstore 











luserloginstore<TUser> , dış kimlik doğrulama sağlayıcılarını etkinleştirmek için uyguladığınız yöntemleri 
tanımlar. Kullanıcı oturum açma bilgilerini ekleme, kaldırma ve alma ve oturum açma bilgilerine göre Kullanıcı 
alma yöntemi gibi yöntemleri içerir. 

• luserrolestore 

luserrolestore<TUser> arabirimi, bir kullanıcıyı bir rolle eşlemek için uyguladığınız yöntemleri tanımlar. Bir 
kullanıcının rollerini ekleme, kaldırma ve alma yöntemlerini ve bir rolün bir rolün atanıp atanmadığını 
denetlemek için bir yöntem içerir. 

• luserpassvvordstore 

luserpasswordstore<TUser> arabirimi, Karma parolaları kalıcı hale getirmek için uyguladığınız yöntemleri 
tanımlar. Karma parolanın alınması ve ayarlanması için yöntemler ve kullanıcının bir parola ayarlayıp 
ayarlamadığını belirten bir yöntem içerir. 

• lusersecuritystampstore 

lusersecuritystampstore<tuser> arabirimi, kullanıcının hesap bilgilerinin değişip değişmediğini belirten bir 
güvenlik damgası kullanmak için uyguladığınız yöntemleri tanımlar. Bu damga, Kullanıcı parolayı değiştirdiğinde 
veya oturum açma ekler veya kaldırdığında güncelleştirilir. Güvenlik damgasını alma ve ayarlama yöntemlerini 
içerir. 

• lusertvvofactorstore 

lusertwofactorstore<TUser> arabirimi iki öğeli kimlik doğrulamayı desteklemek için uyguladığınız yöntemleri 
tanımlar. Bir kullanıcı için iki öğeli kimlik doğrulamasının etkin olup olmadığını alma ve ayarlama yöntemlerini 
içerir. 

• luserphonenumberstore 

luserphonenumberstore<tuser> arabirimi, Kullanıcı telefon numaralarını depolamak için uyguladığınız 
yöntemleri tanımlar. Telefon numarasını alma ve ayarlama ve telefon numarasının onaylanıp onaylanmayacağı 
yöntemlerini içerir. 

• luseremailstore 

luseremailstore<tuser> arabirimi, kullanıcı e-posta adreslerini depolamak için uyguladığınız yöntemleri 
tanımlar. E-posta adresini alma ve ayarlama yöntemlerini ve e-postanın onaylanıp onaylanmadığını içerir. 

• luserlockoutstore 

luserlockoutstore<TUser> arabirimi, bir hesabı kilitleme hakkındaki bilgileri depolamak için uyguladığınız 
yöntemleri tanımlar. Başarısız erişim girişimlerini ve kilitleme işlemleri izlemek için yöntemler içerir. 

• lqueryableuserstore 

lqueryableuserstore<TUser> arabirimi, bir sorgulanabilir kullanıcı deposu sağlamak için uyguladığınız üyeleri 
tanımlar. 

Yalnızca uygulamanızda gerekli olan arabirimleri uygulayabilirsiniz. Örneğin: 

public class UserStore : IUserStore<IdentityUser>, 

IUserClaimStore<IdentityUser>j 

IUserLoginStorecIdentityUseo, 

IUserRoleStore<IdentityUser>, 

IUserPasswordStore<IdentityUser>, 

IUserSecurityStampStore<Identityllser> 

{ 

// interface implementations not shown 

} 

Identityuserclaim, ıdentityuserlogin ve ıdentityuserrole 

Microsoft.AspNet.identity.EntityFnamewonk ad alanı ıdentityuserclaim, ıdentityuserloginve ıdentityuserrole 

sınıflarının uygulamalarını içerir. Bu özellikleri kullanıyorsanız, bu sınıfların kendi sürümlerinizi oluşturmak ve 
uygulamanızın özelliklerini tanımlamak isteyebilirsiniz. Ancak bazen, temel işlemleri gerçekleştirirken bu varlıkların 
belleğe yüklenmemesinin (örneğin, bir kullanıcının talebini ekleme veya kaldırma) daha etkilidir. Bunun yerine, arka 
uç deposu sınıfları bu işlemleri doğrudan veri kaynağında yürütebilir. Örneğin UserStore.GetciaimsAsync yöntemi, 




doğrudan bu tabloda bir sorgu yürütmek ve talepler listesini döndürmek için userciaimTabie.FindByuserid(user.id) 
metodunu çağırabilir. 

Rol sınıfını özelleştirme 

Rol depolama sağlayıcısı uygularken özel bir rol türü oluşturabilirsiniz. Belirli bir arabirim gerçekleştirmemelidir, 
ancak bir id olmalıdır ve genellikle bir Name özelliğine sahip olur. 

Aşağıda örnek bir rol sınıfı verilmiştir: 

using System; 

namespace CustomldentityProviderSample.CustomProvider 
{ 

public class ApplicationRole 
{ 

public Guid Id { get; set; } = Guid.NewGuid(); 
public string Name { get; set; } 

} 

} 


Rol deposunu özelleştirme 

Rollerdeki tüm veri işlemlerine yönelik yöntemleri sağlayan bir Rolestore sınıfı oluşturabilirsiniz. Bu sınıf 
Rolestore<TRole> sınıfına eşdeğerdir. Rolestore sınıfında, iRoiestore<TRoie> ve isteğe bağlı olarak 
iQueryabieRoiestore<TRoie> arabirimini uygulayacağınızı görürsünüz. 

• lrolestore<TRole> 

lrolestore<TRole> arabirimi, rol deposu sınıfında uygulanacak yöntemleri tanımlar. Rol oluşturma, 
güncelleştirme, silme ve alma yöntemlerini içerir. 

• RoleStore<TRole> 

Rolestore özelleştirmek için iRoiestore<TRoie> arabirimini uygulayan bir sınıf oluşturun. 

Yeni bir depolama sağlayıcısını kullanmak için uygulamayı yeniden 
yapılandırın 

Bir depolama sağlayıcısı uygulandıktan sonra uygulamanızı kullanacak şekilde yapılandırırsınız. Uygulamanız 
varsayılan sağlayıcıyı kullandıysanız, bunu özel sağlayıcınızla değiştirin. 

1. Microsoft.AspNetCore.EntityFramework.Identity N uGet paketini kaldırın. 

2. Depolama sağlayıcısı ayrı bir projede veya pakette bulunuyorsa buna bir başvuru ekleyin. 

3. Microsoft.AspNetCore.EntityFramework.identity tüm başvuruları, depolama sağlayıcınızın ad alanı için bir using 
ifadesiyle değiştirin. 

4. configureServices yönteminde, Addidentity yöntemini özel türlerinizi kullanacak şekilde değiştirin. Bu amaçla 
kendi genişletme yöntemlerinizi oluşturabilirsiniz. Bir örnek için bkz. ldentityServiceCollectionExtensions . 

5. Rolleri kullanıyorsanız, RoleManager Rolestore sınıfınızı kullanacak şekilde güncelleştirin. 

6. Bağlantı dizesini ve kimlik bilgilerini uygulamanızın yapılandırmasına güncelleştirin. 


Örnek: 















public void ConfigureServices(IServiceCollection Services) 

{ 

// Add identity types 

Services.AddldentitycApplicationUser, ApplicationRole>() 

. AddDefaultTokenProviders(); 

// identity Services 

Services.AddTransient<IUserStore<ApplicationUser>j CustomUserStore>(); 

Services.AddTransient<IRoleStore<ApplicationRole>, CustomRoleStore>(); 
string connectionString = Configuration.GetConnectionString("DefaultConnection"); 
Services.AddTransient<SqlConnection>(e => new SqlConnection(connectionString)); 
Services.AddTransient<DapperUsersTable>(); 

// additional configuration 

} 


Referanslar 

• ASP.NET 4. x kimliği için özel depolama sağlayıcıları 

• Bu depo - kimlik ASP.NET Core , topluluk tarafından tutulan depo sağlayıcılarının bağlantılarını içerir. 



ASRNET Core Facebook, Google ve dış sağlayıcı 
kimlik doğrulaması 
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Tarafından Valeriy Novyıtskyy ve Rick Anderson 

Bu öğreticide, kullanıcıların dış kimlik doğrulama sağlayıcılarından kimlik bilgileriyle OAuth 2,0 kullanarak 
oturum açmasını sağlayan ASP.NET Core 3,0 uygulamasının nasıl oluşturulacağı gösterilmektedir. 

Facebook, Tvvitter, Googleve Microsoft sağlayıcıları aşağıdaki bölümlerde ele alınmıştır ve bu makalede 
oluşturulan Başlatıcı projesini kullanır. Diğer sağlayıcılar, Aspnet. Security. OAuth. Providers ve Aspnet. 
Security. OpenID. Providersgibi üçüncü taraf paketlerinde kullanılabilir. 

Kullanıcıların mevcut kimlik bilgileriyle oturum açmasını sağlama: 

• Kullanıcılar için kullanışlıdır. 

• Oturum açma işlemini üçüncü bir tarafa yönetmenin karmaşıklıklarını birçok kaydırır. 

Sosyal oturumların trafik ve müşteri dönüştürmelerini nasıl ve ne şekilde, Facebook ve Tvvittertarafından 
örnek olay incelemeleri hakkında örnekler için bkz. 

Yeni birASP.NET Core projesi oluştur 

• Visual Studio 

• Visual Studio Code/Mac için Visual Studio 

• Yeni bir proje oluşturun. 

• ASP.N ET Core Web uygulaması ' nı ve İleri ' yiseçin. 

• Bir Proje adı girin ve konumuonaylayın veya değiştirin. Oluştur 1 u seçin. 

• Açılan kutuda ASP.NET Core 3,0 1 i seçin ve ardından Web uygulaması' nı seçin. 

• Kimlik doğrulamasıaltında Değiştir 1 i seçin ve kimlik doğrulamasını bireysel kullanıcı hesaplarıolarak 

ayarlayın. Tamam 1 ıseçin. 

• Yeni ASP.NET Core Web uygulaması oluştur penceresinde Oluştur' u seçin. 

Geçişleri Uygula 

• Uygulamayı çalıştırın ve Kaydet bağlantısını seçin. 

• Yeni hesap için e-posta ve parolayı girip Kaydet' i seçin. 

• Geçişleri uygulamak için yönergeleri izleyin. 

İleri bir proxy ile ilgili bilgi isteyin veya yük dengeleyici 

Uygulamayı bir ara sunucu veya yük dengeleyici arkasında dağıtılırsa, özgün istek bilgilerden bazılarını istek 
üst bilgileri uygulamada iletilmesi. Bu bilgiler genellikle güvenli istek düzeni içerir ( https ), konak ve istemci 
İP adresi. Uygulamaları otomatik olarak bulmak ve özgün istek bilgileri kullanmak için bu istek üst bilgilerini 
okuma yok. 

Düzeni, dış sağlayıcıları ile kimlik doğrulaması akışı etkiler bağlantı oluşturmada kullanılır.Güvenli düzeni 
kaybetme ( https ) yanlış güvenli olmayan yeniden yönlendirme URL'ler oluşturulurken uygulamada 
sonuçlanır. 






iletilen üstbilgileri ara yazılım, özgün istek bilgileri uygulama isteği işleme için kullanılabilir hale getirmek için 
kullanın. 

Daha fazla bilgi için bkz. Proxy sunucularıyla ve yük dengeleyicilerle çalışacak AS P.N ET Core yapılandırma. 

Oturum açma sağlayıcıları tarafından atanan belirteçleri depolamak 
için SecretManager kullanın 

Sosyal oturum açma sağlayıcıları, kayıt işlemi sırasında uygulama kimliği ve uygulama gizli belirteçleri 
atar. Tam belirteç adları sağlayıcıya göre farklılık gösterir. Bu belirteçler, uygulamanızın API 'lerine erişmek için 
kullandığı kimlik bilgilerini temsil eder. Belirteçler, gizli yöneticininyardımıyla uygulama yapılandırmanızla 
bağlantılı olabilecek "gizli dizileri" oluşturur. Gizli dizi, belirteçleri appSettlngs. JSONgM bir yapılandırma 
dosyasında depolamanın daha güvenli bir alternatifidir. 


IMPORTANT 

Gizli yönetici yalnızca geliştirme amaçlıdır. Azure Key Vault yapılandırma sağlayıcısıylaAzure test ve üretim gizli dizilerini 
saklayabilir ve koruyabilirsiniz. 


Aşağıdaki her bir oturum açma sağlayıcısı tarafından atanan belirteçleri depolamak için ASP.NET Core 
konusundaki geliştirme sırasında uygulama gizli dizileri İçin güvenli depolama bölümündeki adımları izleyin. 

Uygulamanız için gereken oturum açma sağlayıcılarını ayarlama 

Uygulamanızı ilgili sağlayıcıları kullanacak şekilde yapılandırmak için aşağıdaki konuları kullanın: 

• Facebook yönergeleri 

• Tvvitter yönergeleri 

• Google yönergeleri 

• Microsoft yönergeleri 

• Diğer sağlayıcı yönergeleri 

Birden çok kimlik doğrulama sağlayıcıları 

Uygulama birden çok sağlayıcı gerektirdiğinde arkasında sağlayıcısı genişletme yöntemleri zincir 

AddAuthentication: 


Services.AddAuthentication() 

.AddMicrosoftAccount(microsoftOptions => { .. 

» 

.AddGoogle(googleOptions => { ... }) 

.AddTwitter(twitterOptions => { ... }) 

.AddFacebook(facebookOptions => { ... }); 



İsteğe bağlı olarak parola ayarla 

Bir dış oturum açma sağlayıcısına kaydolduysanız, uygulamaya kayıtlı bir parolanız yok demektir. Bu, site için 
bir parola oluşturup hatırlamanızı konuma almayı azaltır, ancak aynı zamanda dış oturum açma sağlayıcısına 
bağımlı hale getirir. Dış oturum açma sağlayıcısı kullanılamıyorsa, Web sitesinde oturum açamazsınız. 

Bir parola oluşturmak ve dış sağlayıcılar ile oturum açma işlemi sırasında ayarladığınız e-postanızı kullanarak 
oturum açmak için: 

• Yönet görünümüne gitmek için sağ üst köşedeki Merhaba <e-posta diğer adı > bağlantısını seçin. 






WebApplİcatİon224 Home About Contact 


Hello raspranav@gmail.com! 


Log off 


Manage your account. 

Change your account settings 


Password: 
External Logins: 
Phone Number: 


[ Create ] 

1 [Manage] 

Phone Numbers can used as a second factor of verifıcation in two-factor authentication. See this article for details on setting up this ASP.NET application 
to support two-factor authentication using SMS. 


Two-Factor Authentic... There are no two-factor authentication providers configured. See this article for setting up this application to support two-factor authentication. 


• Oluştur 1 u seçin 


WebAppNcatİ0n224 Home About Contact 


You do not have a local username/password for this site. Add a local account so you can log in vvithout an external login. 

Set your passvvord 

New passvvord 



Confirm new passvvord 



© 2015 - WebApplication224 

Set passvvord j 



• Geçerli bir parola ayarlayın ve bunu kullanarak e-postalarınız ile oturum açabilirsiniz. 

Sonraki adımlar 

• Bu makalede dış kimlik doğrulaması tanıtılmıştır ve ASP.NET Core uygulamanıza dış oturum açma 
bilgileri eklemek için gereken önkoşullar açıklanacaktır. 

• Uygulamanız için gereken sağlayıcıları için oturum açma işlemlerini yapılandırmak üzere sağlayıcıya 
özgü sayfalara başvurun. 

• Kullanıcı ve bunların erişim ve yenileme belirteçleriyle ilgili ek verileri kalıcı hale getirmek 
isteyebilirsiniz. Daha fazla bilgi için bkz. ASP.NET Core dış sağlayıcılardan ek talepler ve belirteçler 
kalıcı hale getirme. 




















ASRNET Core 'de Google dış oturum açma 
kurulumu 

31.10.2019 • 6 minutes to read^ Edit Online 


Tarafından Valeriy Novyıtskyy ve Rick Anderson 

Bu öğreticide, kullanıcıların önceki sayfadaoluşturulan ASP.NET Core 3,0 projesini kullanarak Google hesabıyla 
oturum açmasını nasıl etkinleştireceğinizi gösterilmektedir. 

Google API konsol projesi ve istemci KİMLİĞİ oluşturma 

• Microsoft. AspNetCore. Authentication. Google'ı yükler. 

• Google oturum açma ile Web uygulamanızı tümleştirme ve Proje yapılandırma' yı seçme bölümüne gidin. 

• OAuth İstemcinizi yapılandırın İletişim kutusunda Web sunucusu' nu seçin. 

• Yetkili yeniden yönlendirme URI ’leri metin girişi kutusunda, YENİDEN yönlendirme URI 'sini ayarlayın. 
Örneğin, https://localhost:44312/signin-google 

• İSTEMCİ kimliğini ve istemci parolasınıkaydedin. 

• Siteyi dağıttığınızda, Google konsolundanyeni ortak URL 'yi kaydedin. 

Google ClientlD ve ClientSecret 'i depola 

Google Client id ve ClientSecret gibi hassas ayarları gizli yöneticiile depolayın. Bu öğreticinin amaçları 
doğrultusunda belirteçleri Authentication:Google:ClientId ve Authentication:Google:ClientSecret olarak 
adlandırın: 

dotnet user-secrets set "Authentication:Google:ClientId" "<client id>" 
dotnet user-secrets set "Authentication:Google:ClientSecret" "«cclient secret>" 

Ortam değişkenlerinde hiyerarşik anahtarlarla çalışırken, bir iki nokta ayırıcı ( : ) tüm platformlarda 

çalışmayabilir (örneğin, Bash). Çift alt çizgi (_) tüm platformlar tarafından desteklenir ve otomatik olarak iki 

nokta ile değiştirilmiştir. 

API konsolunuzunAPI kimlik bilgilerini ve kullanımını yönetebilirsiniz. 

Google kimlik doğrulamasını yapılandırma 

Google Service 'i startup.configureServices ekleyin: 










public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 
Services.AddDefaultIdentity<IdentityUser>(options => 
options.SignIn.RequireConfirmedAccount = true) 

.AddEntityFrameworkStores<ApplicationDbContext>(); 

Services.AddRazorPages(); 

Services.AddAuthentication() 

.AddGoogle(options => 

{ 

IConfigurationSection googleAuthNSection = 

Configuration.GetSection("Authentication:Google"); 

options.Clientld = googleAuthNSection["ClientId "]; 
options.ClientSecret = googleAuthNSection["ClientSecret "]; 

}); 

} 


Çağrı Addldentity varsayılan düzen ayarlarını yapılandırır. AddAuthentication(String) kümeleri aşırı 
DefaultScheme özelliği. AddAuthentication (Eylem<AuthenticationOptions>) aşırı yükleme, farklı amaçlar için 
varsayılan kimlik doğrulama düzeni 1 ayarlamak için kullanılan kimlik doğrulama seçeneklerini yapılandırma 
sağlar. Yapılan sonraki çağrılar AddAuthentication önceden yapılandırılmış bir geçersiz kılma 
AuthenticationOptions özellikleri. 

AuthenticationBuilder bir kimlik doğrulama işleyicisi kaydetme genişletme yöntemleri yalnızca çağrılabilir kez 
kimlik doğrulama düzeni. Aşırı yüklemeler yapılandırma düzeni özellikleri, Düzen adı verin ve görünen adı yok. 

Google ile oturum açın 

• Uygulamayı çalıştırın ve oturum aç' a tıklayın. Google ile oturum açma seçeneği görüntülenir. 

• Kimlik doğrulaması için Google 'a yönlendiren Google düğmesine tıklayın. 

• Google kimlik bilgilerinizi girdikten sonra, Web sitesine geri yönlendirilirsiniz. 

İleri bir proxy ile ilgili bilgi isteyin veya yük dengeleyici 

Uygulamayı bir ara sunucu veya yük dengeleyici arkasında dağıtılırsa, özgün istek bilgilerden bazılarını istek üst 
bilgileri uygulamada iletilmesi. Bu bilgiler genellikle güvenli istek düzeni içerir ( https ), konak ve istemci IP 
adresi. Uygulamaları otomatik olarak bulmak ve özgün istek bilgileri kullanmak için bu istek üst bilgilerini 
okuma yok. 

Düzeni, dış sağlayıcıları ile kimlik doğrulaması akışı etkiler bağlantı oluşturmada kullanılır.Güvenli düzeni 
kaybetme ( https ) yanlış güvenli olmayan yeniden yönlendirme URL'ler oluşturulurken uygulamada sonuçlanır. 

iletilen üstbilgileri ara yazılım, özgün istek bilgileri uygulama isteği işleme için kullanılabilir hale getirmek için 
kullanın. 

Daha fazla bilgi için bkz. Proxy sunucularıyla ve yük dengeleyicilerle çalışacak AS P.N ET Core yapılandırma. 

Birden çok kimlik doğrulama sağlayıcıları 

Uygulama birden çok sağlayıcı gerektirdiğinde arkasında sağlayıcısı genişletme yöntemleri zincir 

AddAuthentication: 





Services.AddAuthentication() 

.AddMicrosoftAccount(microsoftOptions => { .. 

» 

.AddGoogle(googleOptions => { ... }) 

.AddTwitter(twitterOptions => { ... }) 

.AddFacebook(facebookOptions => { ... }); 



Google kimlik doğrulaması tarafından desteklenen yapılandırma seçenekleri hakkında daha fazla bilgi için 
GoogleOptions API başvurusuna bakın. Bu, Kullanıcı hakkında farklı bilgiler istemek için kullanılabilir. 


Varsayılan geri çağırma URI 'sini değiştirme 

/signin-google URI segmenti, Google kimlik doğrulama sağlayıcısı 'nın varsayılan geri çağırması olarak 

ayarlanır. GoogleOptions sınıfının devralınmış remoteauthenticationoptions. callbackpath özelliği aracılığıyla 

Google kimlik doğrulama ara yazılımını YAP 1 LAND 1 R 1 RKEN varsayılan geri çağırma URI 'sini değiştirebilirsiniz. 

Sorun giderme 

• Oturum açma işe yaramazsa ve herhangi bir hata alamıyorsanız, sorunu ayıklamanın daha kolay olması için 
geliştirme moduna geçin. 

• Kimlik configureServices"Services.Addidentity çağırarak, ArgumentException 'de sonuçların doğrulanması 
denenerek, 1 Signmscheme 1 seçeneğinin sağlanması gerekir. Bu öğreticide kullanılan proje şablonu bunun 
yapılmasını sağlar. 

• Site veritabanı ilk geçiş uygulanarak oluşturulmadıysa, istek hatasını İşlerken bir ver'ıtabanı işlemi başarısız 
oldu . Veritabanını oluşturmak için geçişleri Uygula 1 yı seçin ve hatanın ötesinde devam etmek için sayfayı 
yenileyin. 

Sonraki adımlar 

• Bu makalede, Google ile kimlik doğrulaması yapabilirsiniz. Önceki sayfadalistelenen diğer sağlayıcılarla 
kimlik doğrulaması yapmak için benzer bir yaklaşımı izleyebilirsiniz. 

• Uygulamayı Azure'da yayımladıktan sonra, Google API konsolundaki ciientsecret sıfırlayın. 

• Authentication:Google:ClientId ve Authentication:Google:ClientSecret Azure portal uygulama ayarlan 
olarak ayarlayın. Yapılandırma sistemi, ortam değişkenlerinden anahtarları okumak üzere ayarlanır. 







ASPNET Core 'da Facebook dış oturum açma 
kurulumu 

3.12.2019 • 8 minutes to read ı Edit Online 


Tarafından Valeriy Novyıtskyy ve Rick Anderson 

Kod örnekleri ile bu öğreticide, kullanıcılarınızın önceki sayfadaoluşturulmuş bir örnek ASP.NET Core 3,0 projesi 
kullanarak Facebook hesabıyla oturum açmasını nasıl etkinleştireceğinizi gösterilmektedir. Resmi 
adımlarılzleyerek Facebook uygulama kimliği oluşturarak başladık. 


Facebook 'ta uygulama oluşturma 

• Projeye Microsoft. AspNetCore. Authentication. Facebook NuGet paketini ekleyin. 


• Facebook geliştiricileri uygulama sayfasına gidin ve oturum açın. Henüz bir Facebook hesabınız yoksa, bir 
tane oluşturmak için oturum açma sayfasındaki Facebook 'A kaydolun bağlantısını kullanın. Facebook 
hesabınız olduğunda, Facebook geliştiricisi olarak kaydolmak için yönergeleri izleyin. 


• Yeni bir uygulama KİMLİĞİ oluşturmak için uygulamalarım menüsünde uygulama oluştur ' u seçin. 


O û https://developers.facebook.com/apps/ 

facebook for developers Docs Toois support 

My Apps | 

Search apps 

o. 1 



■& tfe 


Search developer documentation 


Create App 


• Formu doldurun ve uygulama kimliği oluştur düğmesine dokunun. 


Create a New App İD 

Get started integrating Facebook into your app or website 
Display Name 

The name you want to associate with this App İD 
Contact Email 

Used for important communication about your app 


By proceeding, you agree to the Facebook Platform Policies 


Cancel 


Create App İD 


• Yeni uygulama kartında Ürün Ekle' yi seçin. Facebook oturum açma kartında Ayarla 1 ya tıklayın. 




















facebook for developers 


Docs 


Tools 


Support 


My Apps 


Dashboard 
{Jj Settings 
Pj Roles 
£ Alerts 
^ App Review 

PRODUCTS © 


Q Search developer documentation 


3^j WebApplication3 ▼ 

Q Status: İn Development 

** Vievv Analytics 



©Help 


Add a Product 


O 


Account Kit 


Seamless account creation. No more passwords. 


O 


Facebook Login 

The vvorld's number one social login product. 


Set Up Read Docs 


Set Up 


Hızlı başlangıç Sihirbazı, ilk sayfa olarak bir platform Seç ile başlatılır. Sol alt taraftaki menüdeki 
Facebook oturum açma ayarları bağlantısına tıklayarak Sihirbazı Şimdi atlayın: 

PRODUCTS © 

© Facebook Login ▼ 

Settings 

Ouickstart 


İstemci OAuth ayarları sayfası görüntülenir: 


Client OAuth Settings 



Client OAuth Login 

Enables the Standard OAuth Client token flow. Secure your application and prevent abuse by locking down 
which token redirect URls are allowed with the options below. Disable globally if not used. [?] 

Web OAuth Login Enforce HTTPS 

Enables web-based Client OAuth Login. I?1 I_I_I Enforce the use of HTTPS for Redirect URls 

and the JavaScript SDK. Strongly 
recommended. i?l 

Force Web OAuth Reauthentication Embedded Brovvser OAuth Login 

No 

When on, prompts people to entertheir l_ J Enable webview Redirect URls for Client 

Facebook passvvord in order to log in on the OAuth Login. I?1 

web. I?I 

Use Strict Mode for Redirect URls 

Only allow redirects that use the Facebook SDK or that exactly match the Valid OAuth Redirect URls. Strongly 
recommended. I?1 


Valid OAuth Redirect URls 

https://localhost:44366//signin-facebook 


Login from Devices 

Enables the OAuth Client login flow for 

devices like a smart TV I?] 


































• Geçerli OAuth yeniden yönlendirme URI 'leri alanına /Signln-Facebook eklenmiş olan geliştirme URI 
'nizi girin (örneğin: https://iocaihost:44320/signin-facebook ). Bu öğreticide daha sonra yapılandırılan 
Facebook kimlik doğrulaması, OAuth akışını uygulamak için /Signln-Facebook rotasındaki istekleri 
otomatik olarak işleymeyecektir. 


NOTE 

URİ /Signln-Facebook , Facebook kimlik doğrulama sağlayıcısı ’nın varsayılan geri çağırması olarak ayarlanır. Facebook 
kimlik doğrulama ara yazılımını, çok yönlü önyükleme sınıfının devralınan remoteauthenticationoptions. callbackpath özelliği 
aracılığıyla YAP 1 LAND 1 R 1 RKEN varsayılan geri çağırma URI 'sini değiştirebilirsiniz. 


• Değişiklikleri Kaydet 1 e tıklayın. 

• Sol gezinti bölmesinde ayarlar > temel bağlantı 1 ya tıklayın. 

Bu sayfada, App id ve App secret bir kopyasını alın. Bir sonraki bölümde ASP.NET Core uygulamanıza 
her ikisini de ekleyeceksiniz: 

• Siteyi dağıttığınızda Facebook oturum açma kurulumu sayfasını yeniden ziyaret etmeniz ve yeni BİR 
ortak URI kaydetmeniz gerekir. 

Facebook uygulama KİMLİĞİ ve uygulama gizli anahtarını depolayın 

Gizli ayarları, Facebook App id ve App secret gibi hassas ayarları, uygulama yapılandırmanıza gizli 
yöneticikullanarak bağlayın. Bu öğreticinin amaçları doğrultusunda belirteçleri Authentication:Facebook:Appid ve 
Authentication: Facebook: AppSecret adlandırın. 


Ortam değişkenlerinde hiyerarşik anahtarlarla çalışırken, bir iki nokta ayırıcı ( : ) tüm platformlarda 

çalışmayabilir (örneğin, Bash). Çift alt çizgi (_) tüm platformlar tarafından desteklenir ve otomatik olarak iki 

nokta ile değiştirilmiştir. 



Facebook kimlik doğrulamasını yapılandırma 

Facebook hizmetini Startup.es dosyasındaki configureServices yöntemine ekleyin: 

Services.AddAuthentication().AddFacebook(facebookOptions => 

{ 

facebookOptions.Appld = Configuration["Authentication:Facebook:Appld "]; 
facebookOptions.AppSecret = Configuration["Authentication:Facebook:AppSecret"]; 

}); 

Addaduthentication (dize) aşırı yüklemesi defaultseheme özelliğini ayarlar. Addaduthentication 
(Action<AuthenticationOptions>) aşırı yüklemesi, farklı amaçlarla varsayılan kimlik doğrulama düzenlerini 
ayarlamak için kullanılabilen kimlik doğrulama seçeneklerinin yapılandırılmasını sağlar. AddAuthentication için 
sonraki çağrılar önceden yapılandırılmış Authenticationoptions özelliklerini geçersiz kılar. 

Kimlik doğrulama işleyicisi kaydeden Authenticationbuilder genişletme metotları, kimlik doğrulama düzeni 
başına yalnızca bir kez çağrılabilir. Düzen özellikleri, Düzen adı ve görünen ad yapılandırmasına izin veren aşırı 
yüklemeler var. 













Birden çok kimlik doğrulama sağlayıcıları 

Uygulama birden çok sağlayıcı gerektirdiğinde arkasında sağlayıcısı genişletme yöntemleri zincir 

AddAuthentication: 


Services.AddAuthentication() 

.AddMicrosoftAccount(microsoftOptions => { ... }) 
.AddGoogle(googleOptions => { ... }) 

.AddTwitter(twitterOptions => { ... }) 

.AddFacebook(facebookOptions => { ... }); 


Facebook kimlik doğrulaması tarafından desteklenen yapılandırma seçenekleri hakkında daha fazla bilgi için bkz. 
çok yönlü Bookoptions API başvurusu. Yapılandırma seçenekleri şu şekilde kullanılabilir: 

• Kullanıcı hakkında farklı bilgiler isteyin. 

• Oturum açma deneyimini özelleştirmek için sorgu dizesi bağımsız değişkenleri ekleyin. 

Facebook ile oturum açma 

Uygulamanızı çalıştırın ve oturum aç' a tıklayın. Facebook ile oturum açma seçeneği görürsünüz. 


Log in 

Use a local account Use another service to log in. 
to log in. 


Facebook 


Email 

Password 

□ Remember me? 


Log in 


Forgot your passvvord? 
Register as a new user 


Facebook'a tıkladığınızda, kimlik doğrulama için Facebook 'a yönlendirilirsiniz: 








facebook 


Sign Up 


Log into Facebook 



Create New Account 


Forgot account? 

Not now 


Facebook kimlik doğrulaması, varsayılan olarak genel profil ve e-posta adresini ister: 



SocialLogins will receive: 
your public profile and email address. O 

[?\ Edit This 


Continue as 


Cancel 

A This doesn't let the app post to Facebook 












Facebook kimlik bilgilerinizi girdikten sonra, e-postanızı ayarlayabileceğiniz sitenize geri yönlendirilirsiniz. 


Artık Facebook kimlik bilgilerinizi kullanarak oturumunuz açıldı: 


WebApplİcatİon224 Home About Contact 



Hello raspranav@gmail.com! Log off 

Microsoft Azure 

üs 

4” 

DB = == = 


İleri bir proxy ile ilgili bilgi isteyin veya yük dengeleyici 

Uygulamayı bir ara sunucu veya yük dengeleyici arkasında dağıtılırsa, özgün istek bilgilerden bazılarını istek üst 
bilgileri uygulamada iletilmesi. Bu bilgiler genellikle güvenli istek düzeni içerir ( https ), konak ve istemci İP 
adresi. Uygulamaları otomatik olarak bulmak ve özgün istek bilgileri kullanmak için bu istek üst bilgilerini okuma 
yok. 

Düzeni, dış sağlayıcıları ile kimlik doğrulaması akışı etkiler bağlantı oluşturmada kullanılır.Güvenli düzeni 
kaybetme ( https ) yanlış güvenli olmayan yeniden yönlendirme URL'ler oluşturulurken uygulamada sonuçlanır. 

iletilen üstbilgileri ara yazılım, özgün istek bilgileri uygulama isteği işleme için kullanılabilir hale getirmek için 
kullanın. 

Daha fazla bilgi için bkz. Proxy sunucularıyla ve yük dengeleyicilerle çalışacak ASP.NET Core yapılandırma. 

Sorun giderme 

• Yalnızca 2. x ASP.N ET Core: Ki mlik, ConfigureServices''Services.Addldentity çağırarak 
yapılandırılmamışsa, kimlik doğrulamaya çalışmak ArgumentException ile sonuçlanır:' Signınscheme ' 
seçeneği sağlanmalıdır. Bu öğreticide kullanılan proje şablonu bunun yapılmasını sağlar. 

• Site veritabanı ilk geçiş uygulanarak oluşturulmadıysa, istek hatasını İşlerken bir veritabanı işlemi başarısız 
oldu . Veritabanını oluşturmak için geçişleri Uygula ' ya dokunun ve hatanın ötesinde devam etmek için 
yenileyin. 

Sonraki adımlar 

• Bu makalede Facebook ile kimlik doğrulaması yapabilirsiniz. Önceki sayfadalistelenen diğer sağlayıcılarla 
kimlik doğrulaması yapmak için benzer bir yaklaşımı izleyebilirsiniz. 

• Web sitenizi Azure Web App 'e yayımladığınızda, Facebook Geliştirici portalındaki AppSecret sıfırlamanız 
gerekir. 

• Authentication: Facebook: Appld ve Authentication: Facebook: AppSecret Azure portal uygulama ayarlan 
olarak ayarlayın. Yapılandırma sistemi, ortam değişkenlerinden anahtarları okumak üzere ayarlanır. 






ASPNET Core ile Microsoft hesabı dış oturum açma 
kurulumu 

5.12.2019 • 7 minutes to read ı Edit Online 


Tarafından Valeriy Novytskyy ve Rick Anderson 

Bu örnekte, kullanıcıların önceki sayfadaoluşturulan ASP.NET Core 3,0 projesini kullanarak Microsoft hesabı 
oturum açmasını nasıl etkinleştireceğinizi gösterilmektedir. 

Uygulamayı Microsoft Geliştirici Portalında oluşturma 

• Projeye Microsoft. AspNetCore. Authentication. MicrosoftAccount NuGet paketini ekleyin. 

• Azure portal uygulama kayıtları sayfasına gidin ve bir Microsoft hesabı oluşturun veya oturum açın: 

Microsoft hesabı yoksa bir tane oluştur' u seçin. Oturum açtıktan sonra, uygulama kayıtları sayfasına 
yönlendirilirsiniz: 

• Yeni kayıt Seç 

• Biradgirin. 

• Desteklenen hesap türleriiçin bir seçenek belirleyin. 

• Yeniden yönlendirme URI ’sialtında /signin-microsoft eklenen geliştirme URL 'nizi girin. Örneğin: 

https://localhost:5001/signin-microsoft . Bu örnekte daha sonra yapılandırılan Microsoft kimlik doğrulama 
şeması, OAuth akışını uygulamak için /signin-microsoft rotadaki istekleri otomatik olarak işleymeyecektir. 

• Kaydol ' u seçin 

İstemci parolası oluştur 

• Sol bölmede sertifikalar & gizlilikler' ı seçin. 

• İstemci gizlidizileri altında yeni istemci parolası ' nı seçin. 

o İstemci parolası için bir açıklama ekleyin, 
o Ekle düğmesini seçin. 

• İstemcigizli dizileri altında, istemci parolasının değerini kopyalayın. 


NOTE 

/signin-microsoft URI segmenti, Microsoft kimlik doğrulama sağlayıcısı 'nın varsayılan geri çağırması olarak ayarlanır. 
Microsoft kimlik doğrulama ara yazılımını, Microsoftaccountoptions sınıfının devralınmış remoteauthenticationoptions. 
callbackpath özelliği aracılığıyla YAPıLANDıRıRKEN varsayılan geri çağırma URI 'sini değiştirebilirsiniz. 


Microsoft istemci KİMLİĞİNİ ve istemci gizli anahtarını depolayın 

ciientid ve ciientsecret gizli Yöneticisikullanarak güvenli bir şekilde depolamak için aşağıdaki komutları 
çalıştırın: 

dotnet user-secrets set Authentication:Microsoft:ClientId <Client-Id> 
dotnet user-secrets set Authentication:Microsoft:ClientSecret <Client-Secret> 


Gizliayarları kullanarak Microsoft ciientid ve ciientsecret gibi hassas ayarları uygulama yapılandırmanıza 













bağlayın. Bu örneğin amaçları doğrultusunda belirteçleri Authentication:Microsoft:ciientid ve 


Authentication:Microsoft:ClientSecret olarak adlandırın. 


Ortam değişkenlerinde hiyerarşik anahtarlarla çalışırken, bir iki nokta ayırıcı ( : ) tüm platformlarda 

çalışmayabilir (örneğin, Bash). Çift alt çizgi (_) tüm platformlar tarafından desteklenir ve otomatik olarak iki 

nokta ile değiştirilmiştir. 

Microsoft hesabı kimlik doğrulamasını yapılandırma 

Microsoft hesabı hizmetini startup.configureServices ekleyin: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 

Services.AddDefaultIdentity<IdentityUser>(options => options.SignIn.RequireConfirmedAccount = true) 

.AddEntityFrameworkStores<ApplicationDbContext>(); 

Services.AddRazorPages(); 

Services.AddAuthentication().AddMicrosoftAccount(microsoftOptions => 

{ 

microsoftOptions.ClientId = Configuration["Authentication:Microsoft:ClientId"]; 
microsoftOptions.ClientSecret = Configuration["Authentication:Microsoft:ClientSecret"]; 

}); 

} 


Addaduthentication (dize) aşırı yüklemesi defaultscheme özelliğini ayarlar. Addaduthentication 
(Action<AuthenticationOptions>) aşırı yüklemesi, farklı amaçlarla varsayılan kimlik doğrulama düzenlerini 
ayarlamak için kullanılabilen kimlik doğrulama seçeneklerinin yapılandırılmasını sağlar. AddAuthentication için 
sonraki çağrılar önceden yapılandırılmış Authenticationoptions özelliklerini geçersiz kılar. 

Kimlik doğrulama işleyicisi kaydeden Authenticationbuilder genişletme metotları, kimlik doğrulama düzeni 
başına yalnızca bir kez çağrılabilir. Düzen özellikleri, Düzen adı ve görünen ad yapılandırmasına izin veren aşırı 
yüklemeler var. 

Birden çok kimlik doğrulama sağlayıcıları 

Uygulama birden çok sağlayıcı gerektirdiğinde arkasında sağlayıcısı genişletme yöntemleri zincir 

AddAuthentication: 


Services.AddAuthentication() 

.AddMicrosoftAccount(microsoftOptions => { ., 

•• » 

.AddGoogle(googleOptions => { ... }) 

.AddTwitter(twitterOptions => { ... }) 

.AddFacebook(facebookOptions => { ... }); 



Microsoft hesabı kimlik doğrulaması tarafından desteklenen yapılandırma seçenekleri hakkında daha fazla bilgi 
için bkz. Microsoftaccountoptions API başvurusu. Bu kullanıcı ile ilgili farklı bilgi istemek için kullanılabilir. 

Microsoft hesabıyla oturum açın hesabı 

Uygulamayı çalıştırın ve oturum aç' a tıklayın. Microsoft ile oturum açma seçeneği görüntülenir.Microsoft 'a 
tıkladığınızda, kimlik doğrulaması için Microsoft 'a yönlendirilirsiniz. Microsoft hesabınızla oturum açtıktan sonra 
uygulamanın bilgilerinize erişmesine izin vermek isteyip istemediğiniz sorulur: 

Evet ' e dokunduktan sonra, e-postanızı ayarlayabileceğiniz Web sitesine geri yönlendirilirsiniz. 







Şu anda Microsoft kimlik bilgilerinizi kullanarak oturum açtınız: 


İleri bir proxy ile ilgili bilgi isteyin veya yük dengeleyici 

Uygulamayı bir ara sunucu veya yük dengeleyici arkasında dağıtılırsa, özgün istek bilgilerden bazılarını istek üst 
bilgileri uygulamada iletilmesi. Bu bilgiler genellikle güvenli istek düzeni içerir ( https ), konak ve istemci İP 
adresi. Uygulamaları otomatik olarak bulmak ve özgün istek bilgileri kullanmak için bu istek üst bilgilerini okuma 
yok. 

Düzeni, dış sağlayıcıları ile kimlik doğrulaması akışı etkiler bağlantı oluşturmada kullanılır.Güvenli düzeni 
kaybetme ( https ) yanlış güvenli olmayan yeniden yönlendirme URL'ler oluşturulurken uygulamada sonuçlanır. 

iletilen üstbilgileri ara yazılım, özgün istek bilgileri uygulama isteği işleme için kullanılabilir hale getirmek için 
kullanın. 

Daha fazla bilgi için bkz. Proxy sunucularıyla ve yük dengeleyicilerle çalışacak ASP.NET Core yapılandırma. 

Sorun giderme 

• Microsoft hesabı sağlayıcısı sizi bir oturum açma hatası sayfasına yönlendirirse, URl'deki # (hashtag) 
doğrudan hata başlığına ve açıklama sorgu dizesi parametrelerine göz önüne alın. 

Hata iletisi Microsoft kimlik doğrulamasıyla ilgili bir sorun olduğunu gösteriyorsa, en sık karşılaşılan 
neden, uygulama URI 'niz Web platformu İçin belirtilen yeniden yönlendirme URI 'lerinden hiçbiriyle 
eşleşmemedir. 

• Kimlik, configureServices'' Services.Addidentity çağırarak yapılandırılmamışsa, kimlik doğrulamaya 
çalışmak ArgumentException ile sonuçlanır:' Signınscheme ' seçeneği sağlanmalıdır. Bu örnekte 
kullanılan proje şablonu bunun yapılmasını sağlar. 

• Site veritabanı, ilk geçiş uygulayarak oluşturulmamış alırsa bir veritabanı işlemi başarısız istek işlenirken 
hata. Dokunun geçerli geçişleri veritabanı oluşturma ve hata devam etmek için yenilemek için. 

Sonraki adımlar 

• Bu makale, Microsoft ile nasıl kimlik doğrulayacağınızı gösterdi. Listelenen diğer sağlayıcıları ile kimlik 
doğrulaması için benzer bir yaklaşım izleyerek önceki sayfaya. 

• Web sitenizi Azure Web App 'e yayımladığınızda, Microsoft Geliştirici Portalında yeni bir istemci gizli 
dizileri oluşturun. 

• Ayarlama Authentication:Microsoft:Clientld ve Authentication:Microsoft:ClientSecret Azure portalında 
uygulama ayarları olarak. Yapılandırma sistemi ortam değişkenlerinden anahtarları okumak için ayarlanır. 







ASPNET Core ile Tvvitter dışarıdan oturum açma 
kurulumu 

9.12.2019 • 6 minutes to read ı Edit Online 


Tarafından Valeriy Novytskyy ve Rick Anderson 

Bu örnek, önceki sayfadaoluşturulmuş bir örnek ASP.NET Core 3,0 projesi kullanarak kullanıcıların Tvvitter 
hesabıyla oturum açmasını nasıl olanaklı hale kullanabileceğinizi gösterir. 

Uygulamayı Tvvitter 'da oluşturma 

• Projeye Microsoft. AspNetCore. Authentication. Tvvitter NuGet paketini ekleyin. 

• Gidin https://apps.twitter.com/ ve oturum açın. Zaten bir Twitter hesabınız yoksa, oluşturmak için Şimdi 
kaydolun bağlantısını kullanın. 


• Uygulama oluştur'u seçin. Uygulama adı, uygulama açıklaması ve genel Web sitesi URI sini 
doldurun (etki alanı adı kaydoluncaya kadar geçici olabilir): 



işleymeyecektir. 


NOTE 

/signin-twitter' URI segmenti Twitter kimlik doğrulama sağlayıcısının varsayılan geri çağırması olarak ayarlanır. 
Twitter kimlik doğrulama ara yazılımını, 1 ın devralınan remoteauthenticationoptions. callbackpath özelliğini 
kullanarak YAPıLANDıRıRKEN varsayılan geri çağırma URI 'sini değiştirebilirsiniz. 


• Formun geri kalanını doldurun ve Oluştur 1 u seçin. Yeni uygulama ayrıntıları görüntülenir: 

Tvvitter tüketici API anahtarı ve gizli dizisi depolanıyor 


ciientid ve ciientsecret gizli Yöneticisikullanarak güvenli bir şekilde depolamak için aşağıdaki komutları 
çalıştırın: 



Bu belirteçler, yeni bir Twitter uygulaması oluşturduktan sonra anahtarlar ve erişim belirteçleri sekmesinde 
bulunabilir: 

Tvvitter kimlik doğrulamasını yapılandırma 

Twitter hizmetini Startup.es dosyasındaki configureServices yöntemine ekleyin: 

















Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 

Services.AddDefaultIdentity<IdentityUser>(options => 
options.SignIn.RequireConfirmedAccount = true) 

.AddEntityFrameworkStores<ApplicationDbContext>(); 

Services.AddRazorPages(); 

Services.AddAuthentication().AddTwitter(twitterOptions => 

{ 

twitterOptions.ConsumerKey = Configuration["Authentication:Twitter:ConsumerAPIKey"]; 
twitterOptions.ConsumerSecret = Configuration["Authentication:Twitter:ConsumerSecret"]; 

}); 


Addaduthentication (dize) aşırı yüklemesi defaultscheme özelliğini ayarlar. Addaduthentication 
(Action<AuthenticationOptions>) aşırı yüklemesi, farklı amaçlarla varsayılan kimlik doğrulama düzenlerini 
ayarlamak için kullanılabilen kimlik doğrulama seçeneklerinin yapılandırılmasını sağlar. AddAuthentication için 
sonraki çağrılar önceden yapılandırılmış Authenticationoptions özelliklerini geçersiz kılar. 

Kimlik doğrulama işleyicisi kaydeden Authenticationbuilder genişletme metotları, kimlik doğrulama düzeni 
başına yalnızca bir kez çağrılabilir. Düzen özellikleri, Düzen adı ve görünen ad yapılandırmasına izin veren aşırı 
yüklemeler var. 

Birden çok kimlik doğrulama sağlayıcıları 

Uygulama birden çok sağlayıcı gerektirdiğinde arkasında sağlayıcısı genişletme yöntemleri zincir 

AddAuthentication: 


Services.AddAuthentication() 

.AddMicrosoftAccount(microsoftOptions => { ., 

■■ }) 

.AddGoogle(googleOptions => { ... }) 

.AddTwitter(twitterOptions => { ... }) 

.AddFacebook(facebookOptions => { ... }); 



Tvvitter kimlik doğrulaması tarafından desteklenen yapılandırma seçenekleri hakkında daha fazla bilgi için, bkz. 
dallı ve seçenekleri API başvurusu. Bu kullanıcı ile ilgili farklı bilgi istemek için kullanılabilir. 

Tvvitter ile oturum açma 

Uygulamayı çalıştırın ve oturum aç ' ı seçin. Tvvitter ile oturum açma seçeneği görünür: 

Tvvitter 'ya tıkladığınızda, kimlik doğrulaması için Tvvitter 'a yeniden yönlendirme yapılır: 

Tvvitter kimlik bilgilerinizi girdikten sonra, e-postanızı ayarlayabileceğiniz Web sitesine geri yönlendirilirsiniz. 
Tvvitter kimlik bilgilerinizi kullanarak oturumunuz açıldı: 

İleri bir proxy ile ilgili bilgi isteyin veya yük dengeleyici 

Uygulamayı bir ara sunucu veya yük dengeleyici arkasında dağıtılırsa, özgün istek bilgilerden bazılarını istek üst 
bilgileri uygulamada iletilmesi. Bu bilgiler genellikle güvenli istek düzeni içerir ( https ), konak ve istemci İP 
adresi. Uygulamaları otomatik olarak bulmak ve özgün istek bilgileri kullanmak için bu istek üst bilgilerini okuma 
yok. 

Düzeni, dış sağlayıcıları ile kimlik doğrulaması akışı etkiler bağlantı oluşturmada kullanılır.Güvenli düzeni 







kaybetme ( https ) yanlış güvenli olmayan yeniden yönlendirme URL'ler oluşturulurken uygulamada sonuçlanır. 

iletilen üstbilgileri ara yazılım, özgün istek bilgileri uygulama isteği işleme için kullanılabilir hale getirmek için 
kullanın. 

Daha fazla bilgi için bkz. Proxy sunucularıyla ve yük dengeleyicilerle çalışacak ASP.NET Core yapılandırma. 

Sorun giderme 

• ASP.NET Core 2.x yalnızca: , kimlik, çağırarak yapılandırılmamış Services. Addidentity içinde 

configureServices , kimlik doğrulaması yapmaya sonuçlanır ArgumentExceptiorı: 'SignlnScheme' seçeneği 
belirtilmelidir. Bu örnekte kullanılan proje şablonu bunun yapılmasını sağlar. 

• Site veritabanı, ilk geçiş uygulayarak oluşturulmamış alırsa bir veritabanı işlemi başarısız istek işlenirken hata. 
Dokunun geçerli geçişleri veritabanı oluşturma ve hata devam etmek için yenilemek için. 

Sonraki adımlar 

• Bu makalede Tvvitter ile kimlik doğrulaması yapabilirsiniz. Listelenen diğer sağlayıcıları ile kimlik 
doğrulaması için benzer bir yaklaşım izleyerek önceki sayfaya. 

• Web sitenizi Azure Web App 'e yayımladığınızda, Tvvitter geliştirici portalındaki consumerSecret 
sıfırlamanız gerekir. 

• Ayarlama Authentication:Twitter:ConsumerKey ve Authentication:Twitter:ConsumerSecret Azure portalinda 
uygulama ayarları olarak. Yapılandırma sistemi ortam değişkenlerinden anahtarları okumak için ayarlanır. 






Dış OAuth kimlik doğrulama sağlayıcıları 

11.07.2019 • 2 minutes to read ı Edjt Online 


Tarafından Rick Anderson, Pranav Rastogi'nin, ve Valeriy Novytskyy 

Aşağıdaki liste, ASP.N ET Core uygulamaları ile çalışan yaygın dış OAuth kimlik doğrulama sağlayıcılarını içerir. 
Tarafından korunan olanlar gibi üçüncü taraf NuGet paketlerini aspnet contrib, ASP.NET Core ekibi tarafından 
gerçekleştirilen kimlik doğrulama sağlayıcıları tamamlamak için kullanılabilir. 

• Linkedln (yönergeleri) 

• Instagram (yönergeleri) 

• Reddit (yönergeleri) 

• Github (yönergeleri) 

• Yahoo (yönergeleri) 

• Tumblr (yönergeleri) 

• Pinterest (yönergeleri) 

• Pocket (yönergeleri) 

• Flickr (yönergeleri) 

• Dribble (yönergeleri) 

• Vimeo (yönergeleri) 

• SoundCIoud (yönergeleri) 

• VK (yönergeleri) 


Birden çok kimlik doğrulama sağlayıcıları 

Uygulama birden çok sağlayıcı gerektirdiğinde arkasında sağlayıcısı genişletme yöntemleri zincir 

AddAuthentication: 


Services.AddAuthentication() 

.AddMicrosoftAccount(microsoftOptions => { ., 

» 

.AddGoogle(googleOptions => { ... }) 

.AddTwitter(twitterOptions => { ... }) 

.AddFacebook(facebookOptions => { ... }); 



İleri bir proxy ile ilgili bilgi isteyin veya yük dengeleyici 

Uygulamayı bir ara sunucu veya yük dengeleyici arkasında dağıtılırsa, özgün istek bilgilerden bazılarını istek üst 
bilgileri uygulamada iletilmesi. Bu bilgiler genellikle güvenli istek düzeni içerir ( https ), konak ve istemci İP adresi. 
Uygulamaları otomatik olarak bulmak ve özgün istek bilgileri kullanmak için bu istek üst bilgilerini okuma yok. 

Düzeni, dış sağlayıcıları ile kimlik doğrulaması akışı etkiler bağlantı oluşturmada kullanılır.Güvenli düzeni 
kaybetme ( https ) yanlış güvenli olmayan yeniden yönlendirme URL'ler oluşturulurken uygulamada sonuçlanır. 

iletilen üstbilgileri ara yazılım, özgün istek bilgileri uygulama isteği işleme için kullanılabilir hale getirmek için 






kullanın. 


Daha fazla bilgi için bkz. Proxy sunucularıyla ve yük dengeleyicilerle çalışacak ASP.NET Core yapılandırma. 


ASRNET Core dış sağlayıcılardan ek talepler ve 
belirteçler kalıcı hale getirme 

23.11.2019 • 23 minutes to read ı Edit Online 


Tarafından Luke Latham 

ASP.NET Core bir uygulama, Facebook, Google, Microsoft ve Tvvitter gibi dış kimlik doğrulama sağlayıcılarından ek 
talepler ve belirteçler oluşturabilir. Her sağlayıcı, platformdaki kullanıcılar hakkında farklı bilgiler ortaya koyar, ancak 
kullanıcı verilerini alma ve ek taleplere dönüştürme için olan model aynı olur. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Önkoşullar 

Uygulamada hangi dış kimlik doğrulama sağlayıcılarının destekileceğine karar verin. Her sağlayıcı için, uygulamayı 
kaydedin ve bir istemci KİMLİĞİ ve istemci parolası alın. Daha fazla bilgi için bkz. ASP.NET Core Facebook, Google 
ve dış sağlayıcı kimlik doğrulaması. Örnek uygulama Google kimlik doğrulama sağlayıcısınıkullanır. 

İstemci KİMLİĞİNİ ve gizli anahtarı ayarlama 

OAuth kimlik doğrulama sağlayıcısı, istemci KİMLİĞİ ve istemci parolası kullanarak bir uygulamayla güven ilişkisi 
kurar. Uygulama sağlayıcıya kaydedildiğinde dış kimlik doğrulama sağlayıcısı tarafından uygulama için istemci 
KİMLİĞİ ve istemci gizli anahtarı değerleri oluşturulur. Uygulamanın kullandığı her bir dış sağlayıcı, sağlayıcının 
istemci KİMLİĞİ ve istemci parolası ile bağımsız olarak yapılandırılmalıdır. Daha fazla bilgi için, senaryonuza 
uygulanan dış kimlik doğrulama sağlayıcısı konularına bakın: 

• Facebook kimlik doğrulaması 

• Google kimlik doğrulaması 

• Microsoft kimlik doğrulaması 

• Tvvitter kimlik doğrulaması 

• Diğer kimlik doğrulama sağlayıcıları 

• Openıdconnect 

Örnek uygulama Google kimlik doğrulama sağlayıcısını Google tarafından sağlanmış istemci KİMLİĞİ ve istemci 
gizli anahtarı ile yapılandırır: 




Services .AddAuthentication().AddGoogle(options => 

{ 

// Provide the Google Client ID 

options.Clientld = "XXXXXXXXXXXXXXX.apps.googleusercontent.com"; 

// Register with User Secrets using: 

// dotnet user-secrets set "Authentication:Google:ClientId" "{Client ID}" 

// Provide the Google Client Secret 
options.ClientSecret = "{Client Secret}"; 

// Register with User Secrets using: 

// dotnet user-secrets set "Authentication:Google:ClientSecret" "{Client Secret}" 

options.ClaimActions.MapDsonKeyC'urn:google:picture", "picture", "url"); 
options.ClaimActions.MapDsonKeyC'urn:google:locale", "locale", "string"); 
options.SaveTokens = true; 

options.Events.OnCreatingTicket = ctx => 

{ 

List<AuthenticationToken> tokens = ctx.Properties.GetTokens().ToList(); 

tokens.Add(new AuthenticationToken() 

{ 

Name = "TicketCreated", 

Value = DateTime.UtcNow.ToString() 

}); 

ctx.Properties.StoreTokens(tokens); 
return Task.CompletedTask; 

}; 

}); 


Kimlik doğrulama kapsamını oluşturma 

Scopebelirterek sağlayıcıdan alma izinlerinin listesini belirtin. Ortak dış sağlayıcılar için kimlik doğrulama kapsamları 
aşağıdaki tabloda görüntülenir. 


SAĞLAYICI 

KAPSAM 

Facebook 

https://www.facebook.com/dialog/oauth 

Google 

https://www.googleapis.com/auth/userinfo.profile 

Microsoft 

https://login.microsoftonline.com/common/oauth2/v2.0/authorize 

Tvvitter 

https://api. twitter.com/oauth/authenticate 


Örnek uygulamada, AuthenticationBuilderAddGoogle çağrıldığında, Google 'ın userinfo.profile kapsamı 
Framevvork tarafından otomatik olarak eklenir. Uygulama ek kapsamlar gerektiriyorsa, bunları seçeneklere ekleyin. 
Aşağıdaki örnekte, bir kullanıcının Doğum gününü almak için Google 
https://www.googleapis.com/auth/user.birthday.read kapsamı eklenmiştir: 

options.Scope.Add("https://www.googleapis.com/auth/user.birthday.read"); 


Kullanıcı veri anahtarlarını eşleme ve talepler oluşturma 

Sağlayıcının seçeneklerinde, oturum açma sırasında okunacak uygulama kimliği için dış sağlayıcının JSON Kullanıcı 
verilerinde her anahtar/alt anahtar için bir MapJsonKey veya MapJsonSubKey belirtin. Talep türleri hakkında daha 








fazla bilgi için bkz. ClaimTypes. 


Örnek uygulama, Google user Data'daki locale ve picture anahtarlarından yerel ayar ( urn:googie:iocaie ) ve 
resim ( urn:google:picture ) talepleri oluşturur: 

Services.AddAuthentication().AddGoogle(options => 

{ 

// Provide the Google Client ID 

options.Clientld = "XXXXXXXXXXXXXXX.apps.googleusercontent.com"; 

// Register with User Secrets using: 

// dotnet user-secrets set "Authentication:Google:ClientId" "{Client ID}" 

// Provide the Google Client Secret 
options.ClientSecret = "{Client Secret}"; 

// Register with User Secrets using: 

// dotnet user-secrets set "Authentication:Google:ClientSecret" "{Client Secret}" 

options.ClaimActions.MaplsonKeyCurn:google:picture", "picture", "url"); 
options.ClaimActions.MaplsonKey("urn:google:locale", "locale", "string"); 
options.SaveTokens = true; 

options.Events.OnCreatingTicket = ctx => 

{ 

List<AuthenticationToken> tokens = ctx.Properties.GetTokens().ToList(); 

tokens.Add(new AuthenticationToken() 

{ 

Name = "TicketCreated", 

Value = DateTime.UtcNow.ToString() 

}); 

ctx.Properties.StoreTokens(tokens); 
return Task.CompletedTask; 

}; 

}); 

Microsoft.AspNetCore.Identity.UI.Pages.Account.Internal.ExternalLoginModel.OnPostConfirmationAsync , bir 
Identityllser ( Appiicationuser ) SignlnAsyncile uygulamada oturum açtı. Oturum açma işlemi sırasında 
UserManager<TUser>, PrincipalKullanıcı verileri için Appiicationuser taleplerini depolayabilirler. 

Örnek uygulamada onPostconfirmationAsync ( Account/ExternalLogln. cshtml. cs), GivenNameiçin bir talep da dahil 
olmak Üzere Oturum açmış Appiicationuser için yerel ayar ( urn:google:locale ) ve resim ( urn:google:picture ) 
taleplerini belirler: 

public async Task<IActionResult> OnPostConfirmationAsync(string returnUrl = null) 

{ 

returnUrl = returnUrl ?? Url.Content("~/"); 

// Get the information about the user from the external login provider 
var info = await _signInManager.GetExternalLoginInfoAsync(); 

if (info == null) 

{ 

ErrorMessage = 

"Error loading external login information during confirmation."; 
return RedirectToPage("./Login", new { ReturnUrl = returnUrl }); 

} 

if (ModelState.IsValid) 

{ 

var user = new IdentityUser 

{ 

UserName = Input.Email, 

Email = Input.Email 










}; 

var result = await _userManager.CreateAsync(user); 

if (result.Succeeded) 

{ 

result = await _userManager.AddLoginAsync(user, info); 

if (result.Succeeded) 

{ 

// If they exist, add claims to the user for: 

// Given (first) name 

// Locale 

// Picture 

İf (info.Principal.HasClaim(c => c.Type == ClaimTypes.GivenName)) 

{ 

await _userManager.AddClaimAsync(userj 

info.Principal.FindFirst(ClaimTypes.GivenName)); 

} 

if (info.Principal.HasClaim(c => c.Type == "urn:google:locale")) 

{ 

await _userManager.AddClaimAsync(userj 

info. Principal.FindFirst("urn:google:locale")); 

} 

if (info.Principal.HasClaim(c => c.Type == "urn:google:picture")) 

{ 

await _userManager.AddClaimAsync(userj 

info.Principal.FindFirst("urn rgoogle:picture")); 

} 

// Include the access token in the properties 
var props = new AuthenticationProperties(); 
props.StoreTokens(info.AuthenticationTokens); 
props.IsPersistent = true; 

await _signInManager.SignInAsync(userj props); 

_logger.Loglnformation( 

"User created an account using {Name} provider.", 
info.LoginProvider); 

return LocalRedirect(returnUrl); 

} 

} 

foreach (var error in result.Errors) 

{ 

ModelState.AddModelError(string.Empty, error.Description); 

} 

} 

LoginProvider = info.LoginProvider; 

ReturnUrl = returnUrl; 
return Page(); 


Varsayılan olarak, bir kullanıcının talepleri kimlik doğrulama tanımlama bilgisinde depolanır. Kimlik doğrulama 
tanımlama bilgisi çok büyükse, bunun nedeni uygulamanın başarısız olmasına neden olabilir: 

• Tarayıcı, tanımlama bilgisi üstbilgisinin çok uzun olduğunu algılar. 

• İsteğin genel boyutu çok büyük. 

Kullanıcı isteklerini işlemek için büyük miktarda Kullanıcı verisi gerekliyse: 

• İstek işleme için Kullanıcı taleplerinin sayısını ve boyutunu yalnızca uygulamanın gerektirdiği şekilde sınırlayın. 


• Kimlik bilgisi kimlik doğrulaması ara yazılımı için özel bir ITİcketStore kullanın, kimlik istekleri arasında depolama 
SessionStore Yalnızca istemciye küçük bir oturum tanımlayıcı anahtarı gönderilirken sunucuda büyük miktarlarda 
kimlik bilgilerini koruyun. 

Erişim belirtecini Kaydet 

SaveTokens, başarılı bir yetkilendirmeden sonra erişim ve yenileme belirteçlerinin AuthenticationProperties 
depolanması gerekip gerekmediğini tanımlar. Son kimlik doğrulama tanımlama bilgisinin boyutunu azaltmak için 
SaveTokens varsayılan olarak faise ayarlanır. 

Örnek uygulama, SaveTokens değerini GoogleOptions true olarak ayarlar: 

Services.AddAuthentication().AddGoogle(options => 

{ 

// Provide the Google Client ID 

options.Clientld = "XXXXXXXXXXXXXXX.apps.googleusercontent.com"; 

// Register with User Secrets using: 

// dotnet user-secrets set "Authentication:Google:ClientId" "{Client ID}" 

// Provide the Google Client Secret 
options.ClientSecret = "{Client Secret}"; 

// Register with User Secrets using: 

// dotnet user-secrets set "Authentication:Google:ClientSecret" "{Client Secret}" 

options.ClaimActions.MapDsonKeyC'urn:google:picture", "picture", "url"); 
options.ClaimActions.MaplsonKeyC'urn:google:locale", "locale", "string"); 
options.SaveTokens = true; 

options.Events.OnCreatingTicket = ctx => 

{ 

List<AuthenticationToken> tokens = ctx.Properties.GetTokens().ToList(); 

tokens.Add(new AuthenticationToken() 

{ 

Name = "TicketCreated", 

Value = DateTime.UtcNow.ToString() 

}); 

ctx.Properties.StoreTokens(tokens); 
return Task.CompletedTask; 

}; 

}); 

onPostconfirmationAsync yürütüldüğünde, erişim belirtecini (Externalloginınfo. AuthenticationTokens) 
ApplicationUser' 'AuthenticationProperties diş sağlayıcıdan depolayın. 

Örnek uygulama, erişim belirtecini Hesap/ExternaiLogin. cshtml. csiçinde OnPostconfirmationAsync (Yeni Kullanıcı 
kaydı) ve onGetcaiibackAsync (önceden kaydedilmiş Kullanıcı) olarak kaydeder: 

public async Task<IActionResult> OnPostConfirmationAsync(string returnUrl = null) 

{ 

returnUrl = returnUrl ?? Url.Content("~/"); 

// Get the information about the user from the external login provider 
var info = await _signInManager.GetExternalLoginInfoAsync(); 

if (info == null) 

{ 

ErrorMessage = 

"Error loading external login information during confirmation."; 
return RedirectToPage("./Login", new { ReturnUrl = returnUrl }); 

} 









if (ModelState.IsValid) 

{ 

var user = new Identityüser 

{ 

UserName = Input.Emailj 
Email = Input.Email 

}; 

var result = await _userManager.CreateAsync(user); 

if (result.Succeeded) 

{ 

result = await _userManager.AddLoginAsync(userj info); 

if (result.Succeeded) 

{ 

// If they exist, add claims to the user for: 

// Given (first) name 

// Locale 

// Picture 

if (info.Principal.HasClaim(c => c.Type == ClaimTypes.GivenName)) 

{ 

await _userManager.AddClaimAsync(userj 

info.Principal.FindFirst(ClaimTypes.GivenName)); 

} 

if (info.Principal.HasClaim(c => c.Type == "urn:google:locale")) 

{ 

await _userManager.AddClaimAsync(userj 

info. Principal.FindFirst("urn:google:locale")); 

} 

if (info.Principal.HasClaim(c => c.Type == "urn:google:picture")) 

{ 

await _userManager.AddClaimAsync(userj 

info.Principal.FindFirst("urn:google:picture")); 

} 

// Include the access token in the properties 
var props = new AuthenticationProperties(); 
props.StoreTokens(info.AuthenticationTokens); 
props.IsPersistent = true; 

await _signInManager.SignInAsync(user, props); 

_logger.LogInformation( 

"User created an account using {Name} provider."., 
info.LoginProvider); 

return LocalRedirect(returnUrl); 

} 

} 

foreach (var error in result.Errors) 

{ 

ModelState.AddModelError(string.Empty, error.Deseription); 

} 

} 

LoginProvider = info.LoginProvider; 

ReturnUrl = returnUrl; 
return Page(); 


Ek özel belirteçler ekleme 


saveTokens bir parçası olarak depolanan özel bir belirtecin nasıl ekleneceğini göstermek için, örnek uygulama, 


Ticketcneated AuthenticationToken.Name geçerli DateTime ile bir AuthenticationToken ekler: 

Services. AddAuthentication(). AddGoogle(options => 

{ 

// Provide the Google Client ID 

options.Clientld = "XXXXXXXXXXXXXXX.apps.googleusercontent.com"; 

// Register with User Secrets using: 

// dotnet user-secrets set "Authentication:Google:ClientId" "{Client ID}" 

// Provide the Google Client Secret 
options.ClientSecret = "{Client Secret}"; 

// Register with User Secrets using: 

// dotnet user-secrets set "Authentication:Google:ClientSecret" "{Client Secret}" 

options.ClaimActions.MaplsonKeyC'urn:google:picture", "picture", "url"); 
options.ClaimActions.MaplsonKey("urn:google:locale", "locale", "string"); 
options.SaveTokens = true; 

options.Events.OnCreatingTicket = ctx = > 

{ 

List<AuthenticationToken> tokens = ctx.Properties.GetTokens().ToList(); 

tokens.Add(new AuthenticationToken() 

{ 

Name = "TicketCreated", 

Value = DateTime.UtcNow.ToString() 

}); 

ctx.Properties.StoreTokens(tokens); 
return Task.CompletedTask; 

}; 

}); 


Talepler oluşturma ve ekleme 

Framework, koleksiyona talepler oluşturmak ve eklemek için ortak eylemler ve genişletme yöntemleri sağlar. Daha 
fazla bilgi için ClaimActionCollectionMapExtensions ve ClaimActionCollectionUniqueExtensionsbakın. 

Kullanıcılar, ClaimAction türeterek ve soyut Run metodunu uygulayarak özel eylemleri tanımlayabilir. 

Daha fazla bilgi için bkz. Microsoft.AspNetCore.Authentication.OAuth.Claims. 

Talep eylemlerinin ve taleplerin kaldırılması 

Claimactioncollection. Remove (dize) , verilen ClaimType için tüm talep eylemlerini koleksiyondan kaldırır. 
Claimactioncollectionmapextensions. DeleteClaim (ClaimActionCollection, String) , kimliğin verilen ClaimType 
talebini siler. DeleteClaim, öncelikle protokol tarafından oluşturulan talepleri kaldırmak için OpenlD Connect (OıDC) 
ile kullanılır. 


Örnek uygulama çıkışı 


User Claims 

http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier 
9b342344f-7aab-43c2-lacl-ba75912ca999 
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name 
someone@gmail.com 
AspNet.Identity.SecurityStamp 

7D4312MOWRYYBFIlKXRPHGOSTBVWSFDE 
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname 
3udy 

urn:google:locale 
en 

urn:google:picture 

https://lh4.googleusercontent.com/-XXXXXX/XXXXXX/XXXXXX/XXXXXX/photo.jpg 

Authentication Properties 

.Token.access_token 

yc23.AlvoZqz56...llxltXV7D-ZWP9 
.Token.token_type 
Bearer 

.Token.expires_at 

2019-04-11T22:14:51.0000000+00:00 
.Token.TicketCreated 

4/11/2019 9:14:52 PM 
.TokenNames 

access_token;token_type;expires_at;TicketCreated 
.persistent 
.issued 

Thu, 11 Apr 2019 20:51:06 GMT 
.expires 

Thu, 25 Apr 2019 20:51:06 GMT 


İleri bir proxy ile ilgili bilgi isteyin veya yük dengeleyici 

Uygulamayı bir ara sunucu veya yük dengeleyici arkasında dağıtılırsa, özgün istek bilgilerden bazılarını istek üst 
bilgileri uygulamada iletilmesi. Bu bilgiler genellikle güvenli istek düzeni içerir ( https ), konak ve istemci IP adresi. 
Uygulamaları otomatik olarak bulmak ve özgün istek bilgileri kullanmak için bu istek üst bilgilerini okuma yok. 

Düzeni, dış sağlayıcıları ile kimlik doğrulaması akışı etkiler bağlantı oluşturmada kullanılır.Güvenli düzeni kaybetme 
( https ) yanlış güvenli olmayan yeniden yönlendirme URL'ler oluşturulurken uygulamada sonuçlanır. 

iletilen üstbilgileri ara yazılım, özgün istek bilgileri uygulama isteği işleme için kullanılabilir hale getirmek için 
kullanın. 

Daha fazla bilgi için bkz. Proxy sunucularıyla ve yük dengeleyicilerle çalışacak ASP.NET Core yapılandırma. 

ASP.NET Core bir uygulama, Facebook, Google, Microsoft ve Tvvitter gibi dış kimlik doğrulama sağlayıcılarından ek 
talepler ve belirteçler oluşturabilir. Her sağlayıcı, platformdaki kullanıcılar hakkında farklı bilgiler ortaya koyar, ancak 
kullanıcı verilerini alma ve ek taleplere dönüştürme için olan model aynı olur. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Önkoşullar 

Uygulamada hangi dış kimlik doğrulama sağlayıcılarının destekileceğine karar verin. Her sağlayıcı için, uygulamayı 
kaydedin ve bir istemci KİMLİĞİ ve istemci parolası alın. Daha fazla bilgi için bkz. ASP.NET Core Facebook, Google 
ve dış sağlayıcı kimlik doğrulaması. Örnek uygulama Google kimlik doğrulama sağlayıcısınıkullanır. 


İstemci KİMLİĞİNİ ve gizli anahtarı ayarlama 




OAuth kimlik doğrulama sağlayıcısı, istemci KİMLİĞİ ve istemci parolası kullanarak bir uygulamayla güven ilişkisi 
kurar. Uygulama sağlayıcıya kaydedildiğinde dış kimlik doğrulama sağlayıcısı tarafından uygulama için istemci 
KİMLİĞİ ve istemci gizli anahtarı değerleri oluşturulur. Uygulamanın kullandığı her bir dış sağlayıcı, sağlayıcının 
istemci KİMLİĞİ ve istemci parolası ile bağımsız olarak yapılandırılmalıdır. Daha fazla bilgi için, senaryonuza 
uygulanan dış kimlik doğrulama sağlayıcısı konularına bakın: 

• Facebook kimlik doğrulaması 

• Google kimlik doğrulaması 

• Microsoft kimlik doğrulaması 

• Tvvitter kimlik doğrulaması 

• Diğer kimlik doğrulama sağlayıcıları 

• Openıdconnect 

Örnek uygulama Google kimlik doğrulama sağlayıcısını Google tarafından sağlanmış istemci KİMLİĞİ ve istemci 
gizli anahtarı ile yapılandırır: 

Services.AddAuthentication().AddGoogle(options => 

{ 

// Provide the Google Client ID 

options.Clientld = "XXXXXXXXXXXXXXX.apps.googleusercontent.com"; 

// Register with User Secrets using: 

// dotnet user-secrets set "Authentication:Google:ClientId" "{Client ID}" 

// Provide the Google Client Secret 
options.ClientSecret = "{Client Secret}"; 

// Register with User Secrets using: 

// dotnet user-secrets set "Authentication:Google:ClientSecret" "{Client Secret}" 

options.ClaimActions.MapDsonKeyC'urn:google:picture", "picture", "url"); 
options.ClaimActions.MapIsonKey("urn:googleılocale", "locale", "string"); 
options.SaveTokens = true; 

options.Events.OnCreatingTicket = ctx => 

{ 

List<AuthenticationToken> tokens = ctx.Properties.GetTokens().ToList(); 

tokens.Add(new AuthenticationToken() 

{ 

Name = "TicketCreated", 

Value = DateTime.UtcNow.ToString() 

}); 

ctx.Properties.StoreTokens(tokens); 
return Task.CompletedTask; 

}; 

}); 


Kimlik doğrulama kapsamını oluşturma 

Scopebelirterek sağlayıcıdan alma izinlerinin listesini belirtin. Ortak dış sağlayıcılar için kimlik doğrulama kapsamları 
aşağıdaki tabloda görüntülenir. 

SAĞLAYICI KAPSAM 


Facebook 


https://www.facebook.com/dialog/oauth 


Google 


https://www.googleapis.com/auth/userinfo.profile 





SAĞLAYICI 


KAPSAM 


Microsoft 


https://login.microsoftonline.com/common/oauth2/v2.0/authorize 


Tvvitter https : //api. twitter.com/oauth/authenticate 

Örnek uygulamada, AuthenticationBuilderAddGoogle çağrıldığında, Google ' ın userinfo.profile kapsamı 
Framevvork tarafından otomatik olarak eklenir. Uygulama ek kapsamlar gerektiriyorsa, bunları seçeneklere ekleyin. 
Aşağıdaki örnekte, bir kullanıcının Doğum gününü almak için Google 
https://www.googleapis.com/auth/user.birthday.read kapsamı eklenmiştir: 

options.Scope.Add("https://www.googleapis.com/auth/user.birthday.read"); 


Kullanıcı veri anahtarlarını eşleme ve talepler oluşturma 

Sağlayıcının seçeneklerinde, oturum açma sırasında okunacak uygulama kimliği için dış sağlayıcının JSON Kullanıcı 
verilerinde her anahtar/alt anahtar için bir MapJsonKey veya MapJsonSubKey belirtin. Talep türleri hakkında daha 
fazla bilgi için bkz. ClaimTypes. 

Örnek uygulama, Google user Data'daki locale ve picture anahtarlarından yerel ayar ( urn:google:iocaie ) ve 
resim ( urn:google:picture ) talepleri oluşturur: 

Services.AddAuthentication().AddGoogle(options => 

{ 

// Provide the Google Client ID 

options.Clientld = "XXXXXXXXXXXXXXX.apps.googleusercontent.com"; 

// Register with User Secrets using: 

// dotnet user-secrets set "Authentication:Google:ClientId" "{Client ID}" 

// Provide the Google Client Secret 
options.ClientSecret = "{Client Secret}"; 

// Register with User Secrets using: 

// dotnet user-secrets set "Authentication:Google:ClientSecret" "{Client Secret}" 

options.ClaimActions.MaplsonKeyCurn:google:picture", "picture", "url"); 
options.ClaimActions.MaplsonKeyCurn:google:locale", "locale", "string"); 
options.SaveTokens = true; 

options.Events.OnCreatingTicket = ctx => 

{ 

List<AuthenticationToken> tokens = ctx.Properties.GetTokens().ToList(); 

tokens.Add(new AuthenticationToken() 

{ 

Name = "TicketCreated", 

Value = DateTime.UtcNow.ToString() 

}); 

ctx.Properties.StoreTokens(tokens); 
return Task.CompletedTask; 

}; 

}); 

Microsoft.AspNetCore.Identity.UI.Pages.Account.Internal.ExternalLoginModel.OnPostConfirmationAsync , bir 
IdentityUser ( Appiicationuser ) SignlnAsyncile uygulamada oturum açtı. Oturum açma işlemi sırasında 
UserManager<TUser>, PrincipalKullanıcı verileri için Appiicationuser taleplerini depolayabilirler. 

Örnek uygulamada onPostconfirmationAsync ( Account/ExternalLogin. cshtml. cs), GivenNameiçin bir talep da dahil 









olmak Üzere Oturum açmış ApplicationUser için yerel ayar ( urn:google:locale ) ve resim ( urnrgoogle:picture ) 
taleplerini belirler: 

public async Task<IActionResult> OnPostConfirmationAsync(string returnUrl = null) 

{ 

returnUrl = returnUrl ?? Url.Content("~/"); 

// Get the information about the user from the external login provider 
var info = await _signInManager.GetExternall_oginInfoAsync(); 

if (info == null) 

{ 

ErrorMessage = 

"Error loading external login information during confirmation."; 
return RedirectToPage("./Login"j new { ReturnUrl = returnUrl }); 

} 

if (ModelState.IsValid) 

{ 

var user = new IdentityUser 

{ 

UserName = Input.Emailj 
Email = Input.Email 

}; 

var result = await _userManager.CreateAsync(user); 

if (result.Succeeded) 

{ 

result = await _userManager.AddLoginAsync(user, info); 

if (result.Succeeded) 

{ 

// If they exist, add claims to the user for: 

// Given (first) name 

// Locale 

// Picture 

if (info.Principal.HasClaim(c => c.Type == ClaimTypes.GivenName)) 

{ 

await _userManager.AddClaimAsync(userj 

info. Principal.FindFirst(ClaimTypes.GivenName)); 

} 

if (info.Principal.HasClaim(c => c.Type == "urn:google:locale")) 

{ 

await _userManager.AddClaimAsync(userj 

info.Principal.FindFirst("urnıgoogle:locale")); 

} 

if (info.Principal.HasClaim(c => c.Type == "urn:google:picture")) 

{ 

await _userManager.AddClaimAsync(userj 

info.Principal.FindFirst("urn rgoogle:picture")); 

} 

// Include the access token in the properties 
var props = new AuthenticationProperties(); 
props.StoreTokens(info.AuthenticationTokens); 
props.IsPersistent = true; 

await _signInManager.SignInAsync(user, props); 

_logger.Loglnformation( 

"User created an account using {Name} provider .", 
info.LoginProvider); 

return LocalRedirect(returnUrl); 

} 

T 


foreach (var error in result.Errors) 

{ 

ModelState.AddModelError(string.Empty, error.Description); 

} 

} 

LoginProvider = info.LoginProvider; 

ReturnUrl = returnllrl; 
return Page(); 

} 

Varsayılan olarak, bir kullanıcının talepleri kimlik doğrulama tanımlama bilgisinde depolanır. Kimlik doğrulama 
tanımlama bilgisi çok büyükse, bunun nedeni uygulamanın başarısız olmasına neden olabilir: 

• Tarayıcı, tanımlama bilgisi üstbilgisinin çok uzun olduğunu algılar. 

• İsteğin genel boyutu çok büyük. 

Kullanıcı isteklerini işlemek için büyük miktarda Kullanıcı verisi gerekliyse: 

• istek işleme için Kullanıcı taleplerinin sayısını ve boyutunu yalnızca uygulamanın gerektirdiği şekilde sınırlayın. 

• Kimlik bilgisi kimlik doğrulaması ara yazılımı için özel bir ITİcketStore kullanın, kimlik istekleri arasında depolama 
SessionStore Yalnızca istemciye küçük bir oturum tanımlayıcı anahtarı gönderilirken sunucuda büyük miktarlarda 
kimlik bilgilerini koruyun. 

Erişim belirtecini Kaydet 

SaveTokens, başarılı bir yetkilendirmeden sonra erişim ve yenileme belirteçlerinin AuthenticationProperties 
depolanması gerekip gerekmediğini tanımlar. Son kimlik doğrulama tanımlama bilgisinin boyutunu azaltmak için 
SaveTokens varsayılan olarak faise ayarlanır. 

Örnek uygulama, SaveTokens değerini GoogleOptions true olarak ayarlar: 






Services.AddAuthentication().AddGoogle(options => 

{ 

// Provide the Google Client ID 

options.Clientld = "XXXXXXXXXXXXXXX.apps.googleusercontent.com"; 

// Register with User Secrets using: 

// dotnet user-secrets set "Authentication:Google:ClientId" "{Client ID}" 

// Provide the Google Client Secret 
options.ClientSecret = "{Client Secret}"; 

// Register with User Secrets using: 

// dotnet user-secrets set "Authentication:Google:ClientSecret" "{Client Secret}" 

options.ClaimActions.MapDsonKeyC'urn:google:picture", "picture", "url"); 
options.ClaimActions.MaplsonKey("urn:google:locale"j "locale", "string"); 
options.SaveTokens = true; 

options.Events.OnCreatingTicket = ctx => 

{ 

List<AuthenticationToken> tokens = ctx.Properties.GetTokens().ToList(); 

tokens.Add(new AuthenticationToken() 

{ 

Name = "TicketCreated", 

Value = DateTime.UtcNow.ToString() 

}); 

ctx.Properties.StoreTokens(tokens); 
return Task.CompletedTask; 

}; 

}); 

onPostconfirmationAsync yürütüldüğünde, erişim belirtecini (Externalloginınfo. AuthenticationTokens) 
ApplicationUser'' AuthenticationProperties diş sağlayıcıdan depolayın. 

Örnek uygulama, erişim belirtecini Hesap/ExternalLogin. cshtml. csiçinde OnPostconfirmationAsync (Yeni Kullanıcı 
kaydı) ve onGetcaiibackAsync (önceden kaydedilmiş Kullanıcı) olarak kaydeder: 

public async Task<IActionResult> OnPostConfirmationAsync(string returnUrl = null) 

{ 

returnUrl = returnUrl ?? Url.Content("~/"); 

// Get the information about the user from the external login provider 
var info = await _signInManager.GetExternalLoginInfoAsync(); 

if (info == null) 

{ 

ErrorMessage = 

"Error loading external login information during confirmation."; 
return RedirectToPage("./Login"j new { ReturnUrl = returnUrl }); 

} 

if (ModelState.IsValid) 

{ 

var user = new IdentityUser 

{ 

UserName = Input.Email, 

Email = Input.Email 

}; 

var result = await _userManager.CreateAsync(user); 

if (result.Succeeded) 

{ 

result = await _userManager.AddLoginAsync(user, info); 





ıf (result.Succeeded) 

{ 

// If they exist, add claims to the user for: 

// Given (first) name 

// Locale 

// Picture 

if (info.Principal.HasClaim(c => c.Type == ClaimTypes.GivenName)) 

{ 

await _userManager.AddClaimAsync(userj 

info. Principal.FindFirst(ClaimTypes.GivenName)); 

} 

if (info.Principal.HasClaim(c => c.Type == "urn:google:locale")) 

{ 

await _userManager.AddClaimAsync(userj 

info.Principal.FindFirst("urn:google:locale")); 

} 

if (info.Principal.FlasClaim(c => c.Type == "urn:google:picture")) 

{ 

await _userManager.AddClaimAsync(userj 

info.Principal.FindFirst("urn:google:picture")); 

} 

// Include the access token in the properties 
var props = new AuthenticationProperties(); 
props.StoreTokens(info.AuthenticationTokens); 
props.IsPersistent = true; 

await _signInManager.SignInAsync(user, props); 

_logger.LogInformation( 

"User created an account using {Name} provider."., 
info.LoginProvider); 

return LocalRedirect(returnUrl); 

} 

} 

foreach (var error in result.Errors) 

{ 

ModelState.AddModelError(string.Empty, error.Description); 

} 


LoginProvider = info.LoginProvider; 
ReturnUrl = returnUrl; 
return Page(); 


Ek özel belirteçler ekleme 

saveTokens bir parçası olarak depolanan özel bir belirtecin nasıl ekleneceğini göstermek için, örnek uygulama, 
Ticketcreated AuthenticationToken.Name geçerli DateTime ile bir AuthenticationToken ekler: 


Services.AddAuthentication().AddGoogle(options => 

{ 

// Provide the Google Client ID 

options.Clientld = "XXXXXXXXXXXXXXX.apps.googleusercontent.com"; 

// Register with User Secrets using: 

// dotnet user-secrets set "Authentication:Google:ClientId" "{Client ID}" 

// Provide the Google Client Secret 
options.ClientSecret = "{Client Secret}"; 

// Register with User Secrets using: 

// dotnet user-secrets set "Authentication:Google:ClientSecret" "{Client Secret}" 

options.ClaimActions.MapDsonKeyC'urn:google:picture", "picture", "url"); 
options.ClaimActions.MapDsonKeyC'urn:google:locale", "locale", "string"); 
options.SaveTokens = true; 

options.Events.OnCreatingTicket = ctx => 

{ 

List<AuthenticationToken> tokens = ctx.Properties.GetTokens().ToList(); 

tokens.Add(new AuthenticationToken() 

{ 

Name = "TicketCreated", 

Value = DateTime.UtcNow.ToString() 

}); 

ctx.Properties.StoreTokens(tokens); 
return Task.CompletedTask; 

}; 

}); 


Talepler oluşturma ve ekleme 

Framework, koleksiyona talepler oluşturmak ve eklemek için ortak eylemler ve genişletme yöntemleri sağlar. Daha 
fazla bilgi için ClaimActionCollectionMapExtensions ve ClaimActionCollectionUniqueExtensionsbakın. 

Kullanıcılar, ClaimAction türeterek ve soyut Run metodunu uygulayarak özel eylemleri tanımlayabilir. 

Daha fazla bilgi için bkz. Microsoft.AspNetCore.Authentication.OAuth.Claims. 

Talep eylemlerinin ve taleplerin kaldırılması 

Claimactioncollection. Remove (dize) , verilen ClaimType için tüm talep eylemlerini koleksiyondan kaldırır. 
Claimactioncollectionmapextensions. DeleteClaim (ClaimActionCollection, String) , kimliğin verilen ClaimType 
talebini siler. DeleteClaim, öncelikle protokol tarafından oluşturulan talepleri kaldırmak için OpenlD Connect (OıDC) 
ile kullanılır. 


Örnek uygulama çıkışı 



User Claims 

http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier 
9b342344f-7aab-43c2-lacl-ba75912ca999 
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name 
someone@gmail.com 
AspNet.Identity.SecurityStamp 

7D4312MOWRYYBFIlKXRPHGOSTBVWSFDE 
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname 
3udy 

urn:google:locale 
en 

urn:google:picture 

https://lh4.googleusercontent.com/-XXXXXX/XXXXXX/XXXXXX/XXXXXX/photo.jpg 

Authentication Properties 

.Token.access_token 

yc23.AlvoZqz56...llxltXV7D-ZWP9 
.Token.token_type 
Bearer 

.Token.expires_at 

2019-04-11T22:14:51.0000000+00:00 
.Token.TicketCreated 

4/11/2019 9:14:52 PM 
.TokenNames 

access_token;token_type;expires_at;TicketCreated 
.persistent 
.issued 

Thu, 11 Apr 2019 20:51:06 GMT 
.expires 

Thu, 25 Apr 2019 20:51:06 GMT 


İleri bir proxy ile ilgili bilgi isteyin veya yük dengeleyici 

Uygulamayı bir ara sunucu veya yük dengeleyici arkasında dağıtılırsa, özgün istek bilgilerden bazılarını istek üst 
bilgileri uygulamada iletilmesi. Bu bilgiler genellikle güvenli istek düzeni içerir ( https ), konak ve istemci IP adresi. 
Uygulamaları otomatik olarak bulmak ve özgün istek bilgileri kullanmak için bu istek üst bilgilerini okuma yok. 

Düzeni, dış sağlayıcıları ile kimlik doğrulaması akışı etkiler bağlantı oluşturmada kullanılır.Güvenli düzeni kaybetme 
( https ) yanlış güvenli olmayan yeniden yönlendirme URL'ler oluşturulurken uygulamada sonuçlanır. 

iletilen üstbilgileri ara yazılım, özgün istek bilgileri uygulama isteği işleme için kullanılabilir hale getirmek için 
kullanın. 

Daha fazla bilgi için bkz. Proxy sunucularıyla ve yük dengeleyicilerle çalışacak ASP.NET Core yapılandırma. 

Ek kaynaklar 

• ASPNET/aspnetcore mühendislik SocialSample uygulaması - bağlantılı örnek uygulama, ASPNET/aspnetcore 
GitHub deposunun master mühendislik dalında bulunur, master dalı, ASP.NET Core sonraki sürümü için etkin 
geliştirme kapsamındaki kodu içerir. Yayınlanmış bir ASP.NET Core sürümü için örnek uygulamanın bir 
sürümünü görmek için, dal açılan listesini kullanarak bir yayın dalı seçin (örneğin reiease/{x.Y} ). 







ASPNET Core 'de ilke şemaları 
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Kimlik doğrulama ilkesi şemaları, tek bir mantıksal kimlik doğrulama düzeninin birden çok yaklaşım kullanmasına 
daha kolay olmasını sağlar. Örneğin, bir ilke şeması, sorunlar için Google kimlik doğrulaması ve diğer her şey için 
tanımlama bilgisi kimlik doğrulaması kullanabilir. Kimlik doğrulama ilkesi şemaları şunları yapar: 

• Herhangi bir kimlik doğrulama eylemini başka bir düzene iletmek kolay. 

• isteğe göre dinamik olarak ilet. 

Türetilmiş AuthenticationSchemeOptions ve ilişkili Authenticationhandler<TOptions >kullanan tüm kimlik 
doğrulama şemaları: 

• ASP.NET Core 2,1 ve sonraki sürümlerde otomatik olarak ilke düzenleridir. 

• Düzenin seçenekleri yapılandırılarak etkinleştirilebilir. 


public class AuthenticationSchemeOptions 

{ 

/// <summary> 

/// If set, this specifies a default scheme that authentication handlers should 
III forward ali authentication operations to, by default. The default forwarding 
III logic checks in this order: 

III 1. The most specific ForwardAuthenticate/Challenge/Forbid/SignIn/SignOut 
III 2. The ForwardDefaultSelector 
III 3. ForwardDefault 

III The first non null result is used as the tanget scheme to forwand to. 

III </summany> 

public stning ForwardDefault { get; set; } 

III <summary> 

III If set, this specifies the target scheme that this scheme should forward 
III AuthenticateAsync calls to. For example: 

III Context.AuthenticateAsync("ThisScheme") => 

III Context.AuthenticateAsync("ForwardAuthenticateValue"); 

III Set the target to the current scheme to disable forwarding and allow 
III normal Processing. 

III </summary> 

public string ForwardAuthenticate { get; set; } 

III <summary> 

III If set, this specifies the target scheme that this scheme should forward 
III ChallengeAsync calls to. For example: 

III Context.ChallengeAsync("ThisScheme") => 

III Context.ChallengeAsync("ForwardChallengeValue"); 

III Set the target to the current scheme to disable forwarding and allow normal 
III Processing. 

III </summary> 

public string ForwardChallenge { get; set; } 

III <summary> 

III If set, this specifies the target scheme that this scheme should forward 
III ForbidAsync calls to.For example: 

III Context.ForbidAsync("ThisScheme") 

III => Context.ForbidAsync("ForwardForbidValue"); 

III Set the target to the current scheme to disable forwarding and allow normal 
III Processing. 

III </summary> 

public string ForwardForbid { get; set; } 


III <summary> 




/// If set, this specifies the target scheme that this scheme should forward 
/// SignlnAsync calls to. For example: 

III Context.SignlnAsync("ThisScheme") => 

III Context.SignlnAsync("ForwardSignInValue"); 

III Set the target to the current scheme to disable forwarding and allow normal 
III Processing. 

III </summary> 

public string ForwardSignIn { get; set; } 

III <summary> 

III If set, this specifies the target scheme that this scheme should forward 
III SignOutAsync calls to. For example: 

III Context.SignOutAsync("ThisScheme") => 

III Context.SignOutAsync("ForwardSignOutValue"); 

III Set the target to the current scheme to disable forwarding and allow normal 
III Processing. 

III </summary> 

public string ForwardSignOut { get; set; } 

III <summary> 

III Used to select a default scheme for the current request that authentication 
III handlers should forward ali authentication operations to by default. The 
III default forwarding checks in this order: 

III 1. The most specific ForwardAuthenticate/Challenge/Forbid/SignIn/SignOut 
III 2. The ForwardDefaultSelector 
III 3. ForwardDefault. 

III The first non null result will be used as the target scheme to forward to. 
III </summary> 

public Func<HttpContext, string> ForwardDefaultSelector { get; set; } 


Örnekler 

Aşağıdaki örnek, alt düzey şemaları birleştiren daha yüksek düzey bir düzeni gösterir. Google kimlik doğrulaması, 
sorunlar için kullanılır ve diğer her şey için tanımlama bilgisi kimlik doğrulaması kullanılır: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme) 

.AddCookie(options => options.ForwardChallenge = "Google") 

.AddGoogle(options => { }); 


Aşağıdaki örnek, istek temelinde dinamik düzen seçimini mümkün bir şekilde sunar. Diğer bir deyişle, tanımlama 
bilgilerini ve API kimlik doğrulamasını karıştırma: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddAuthentication(CookieAuthenticatİonDefaults.AuthenticationScheme) 

.AddCookie(options => 

{ 

// For example, can foward any requests that start with /api 

// to the api scheme. 

options.ForwardDefaultSelector = ctx => 

ctx.Request.Path.StartsWithSegments("/api") ? "Api" : null; 

}) 

.AddYourApiAuth("Api"); 

} 




ASPNET core'da WS-Federasyon ile kullanıcıların 
kimlik doğrulaması 
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Bu öğreticide, kullanıcıların Active Directory Federasyon Hizmetleri (ADFS) gibi bir WS-Federasyon kimlik 
doğrulama sağlayıcısı ile oturum açmak gösterilmektedir veya Azure Active Directory (AAD). Açıklanan ASP.NET 
Core 2.0 örnek uygulamanın kullandığı Facebook, Google ve dış sağlayıcı kimlik doğrulaması. 

ASP.NET Core 2.0 uygulamaları için WS-Federasyon desteği tarafından sağlanan 
Microsoft.AspNetCore.Authentication.VVsFederation. Bu bileşen öğesinden alınır 

Microsoft.Ovvin.Security.VVsFederation ve bileşenin mechanics çoğunu paylaşır. Ancak, bileşenlerin önemli şekilde 
birkaç içinde farklılık gösterir. 

Varsayılan olarak, yeni bir ara yazılım: 

• İstenmeyen oturumları izin vermez. Bu özellik WS-Federation Protokolü XSRF saldırılarına karşı savunmasız 
durumdadır. Ancak, bunu ile etkin hale getirilebilir AiiowunsoiicitedLogins seçeneği. 

• Her oturum açma iletileri için form post denetlemez. Yalnızca ister caiibackPath oturum hedefleyecek için 
denetlenir CaiibackPath varsayılan olarak /signin-wsfed ancak değiştirilebilir devralınan aracılığıyla 
RemoteAuthenticationOptions.CalIbackPath özelliği VVsFederationOptions sınıfı. Bu yol sağlayarak diğer kimlik 
doğrulama sağlayıcıları ile paylaşılabilen SkipUnrecognizedReguests seçeneği. 


Active Directory ile uygulamayı kaydetme 

Active Directory Federasyon Hizmetleri 

• Sunucunun açık ekleme bağlı olan taraf güveni Sihirbazı AD FS yönetim konsolundan: 


V. 


File Action \[ 




Q 


3 AD FS 


] Service 
) Trust Relatior 
j Authenticatic 


% 


VVelcome 

Step s 

O Welcome 

O Select Data Source 

ı Configure Multi-factor 
Authentication Now? 

ı Choose Issuance 
Authorization Rules 

ı Ready to Add Trust 

ı Finish 


AD FS 


Add Relying Party Trust VVİzard 


Wdcome to t he Add Relying Party Trust Wizard 

This wizard will help you add a new relying party trust to the AD FS configuration database. Relying parties 
consume daims in security tokens that are issued bythis Federation Service to make authentication and 
authorization dedsions. 

The relying party trust that this wizard creates defines how this Federation Service recognizes the relying 
party and issues daims to it. You can define issuance transform rules for issuing daims to the relying party 
afteryou complete the wizard. 


I l-M*; 


perties... 



• Verileri el ile girmek bu seçeneği seçin: 




































• Bağlı olan taraf için bir görünen ad girin. ASP.NET Core uygulaması için önemli adı değil. 

• Microsoft.AspNetCore.Authentication.WsFederation lacks support for token encryption, so don't configure a 
token encryption certificate: 

Sİ2 Add Relying Party Trust VVİzard x 

Configure Certificate 

^ e * >S Spedfy an optlonal token encıyptlon certificate. The token encryption certificate is used to encrypt the 

9 Welcome daims that are sent to this nefying party. The relying party vali use the private key of this certificate to 

decrypt the daims that are sent to it. To specify the certificate. dick Browse.. 

9 Select Data Soıırce 

• Specrfy Display Name 

• Choose Profile 

e Configure Certificate 

e Configure URL 

Q Configure Identifiers 

I e Configure Multi-fador 
Authentication Now? 

e Choose Issuance 
Authorization Rules 

e Ready to Add Trust 

e Finish 


Issuer: 

Subject: 
Effedive date: 
Expiration date: 


Vıevv. 


Btovvse . 


Remove 
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Next > 


Cancel 
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• Uygulamanın URL'sini kullanan, WS-Federasyon Edilgen Protokolü desteğini etkinleştirin. Bağlantı noktası 
uygulama için doğru olduğunu doğrulayın: 



NOTE 

Bu, bir HTTPS URL'si olması gerekir. IIS Express otomatik olarak imzalanan bir sertifika uygulama geliştirme sırasında 
barındırırken sağlayabilir. Kestrel'i el ile sertifika yapılandırma gerektirir. Bkz: Kestrel belgeleri daha fazla ayrıntı için. 


• Tıklayın sonraki sihirbazın geri kalanını aracılığıyla ve Kapat sonunda. 

• ASP.NET Core kimliği gerektiren bir ad kimliği talep. Bir ekleme talep kurallarını Düzenle iletişim: 






























• içinde dönüştürme Kuralı Ekleme Sihirbazı, varsayılan değeri bırakın LDAP özniteliklerini talep olarak 
Gönder şablonu seçili seçeneğine tıklayıp sonraki. Bir kural eklemesi SAM-Account-Name LDAP özniteliği 
ad kimliği giden talep: 
































• Tıklayın son > Tamam içinde talep kurallarını Düzenle penceresi. 


Azure Active Directory 

• AAD kiracısının uygulama kayıtları dikey penceresine gidin. Tıklayın yeni uygulama kaydı: 


Home > vvsfedsample - App registrations 

vvsfedsample - App registrations 

Azure Active Directory 


O 

Overview 


r.* 

Vi 

Quick start 


MANAGE 


• 

M 

Users 


• 

İM 

Groups 


!« 

Enterprise applications 


□ 

Devices 


:Ş 

App registrations 


S 

Application proxy 



^ New application registration I*— Endpoints ^ Troubleshoot 


To view and manage your registrations for converged applications, please visit the Microsoft Application 
Console. 


Search by name orApplD 


My apps 


DISPLAY NAME 


No results. 


APPLICATION TYPE APPLICATION İD 


• Uygulama kaydı için bir ad girin. Bu, ASP.NET Core uygulaması için önemli değildir. 

• Uygulama dinlediği olarak URL'sini oturum açma URL'si: 










































Create 


□ x 


* Name0 


vvsfedsample 

V 

Application type O 

Web app / API 


* Sign-on URL 6 

https://localhost:44307 

V 


Create 


• Tıklayın uç noktaları ve Not Federasyon meta veri belgesi URL'si. Bu WS-Federation Ara, MetadataAddress : 


t" New application registration 


•— Endpoints 


X 


Troubleshoot 


lo view and manage your registrations for converged applications, please visit the Microsoft 
\pplication Console. 



Search by name or ApplD 


Ali apps 


v 


DISPLAY NAME 


APPLICATION TYPE APPLICATION İD 


WS-FEDERATION SIGN-ON ENDPOINT 
https://login.microsoftonline.com/39af... ]ia 


| wsfedsample 


Web app / API adc50fba-9ac5-43cd-9d40-bb7... 


SAML-P SIGN-ON ENDPOINT 


• Yeni uygulama kaydı için gidin. Tıklayın ayarları > özellikleri ve Not uygulama kimliği URl'si. Bu WS- 
Federation Ara, wtreaim : 




























Home > wsfedsample - App registrations > vvsfedsample > Settings > Properties 

vvsfedsample 

* X 

Settings 

X 

Properties 

□ X 

Registered app 







|<> : ncs j ,/ Mani 

Display name 
wsfedsample 
Application type 
Web app / API 
Home page 
https://localhost:44307 


Application İD 

adc50fba-9ac5-43cd-9d40-bb7b2615a396 
Object İD 

6b955e14-eac9-45c1 -9a83-c8389872ca0d 
Managed applicatîon in local directory 
vvsfedsample 


| P Filter settings 


GENERAL 

1 - 1 Properties 

> 

ÎE Reply URLs 

> 

îm Ovvners 

> 

API ACCESS 

rfjb Required permissions 

> 

t Keys 

> 

TROUBLESHOOTING + SUPPORT 

% Troubleshoot 

> 

Nevv support reguest 
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Save X Discard 

* Name O 


vvsfedsample 


6b955e 14-eac9-45c 1 -9a83-c8389872ca0d 


adc50fba-9ac5-43cd-9d40-bb7b2615a396 


https://wsfedsample.onmicrosoft.com/bf0e7e( 


Logo 



Upload nevv logo € 


Home page URL © 


https://loca I host:44307 


WS-Federation, ASP.NET Core kimliği için bir dış oturum açma 
sağlayıcısı Ekle 

• Üzerinde bir bağımlılık ekleme Microsoft.AspNetCore.Authentication.VVsFederation projeye. 

• VVS-Federasyon ekleme startup.configureServices : 

Services.AddldentitycIdentityUser, IdentityRole>() 

.AddEntityFrameworkStores<ApplicationDbContext>() 

.AddDefaultTokenProviders(); 

Services.AddAuthentication() 

.AddWsFederation(options => 

{ 

// MetadataAddress represents the Active Directory instance used to authenticate users. 
options.MetadataAddress = "https://<ADFS FQDN or AAD tenant>/FederationMetadata/2007- 
06/FederationMetadata.xml"; 

// lAİtrealm is the app's identifier in the Active Directory instance. 

// For ADFS, use the relying party's identifier, its WS-Federation Passive protocol URL: 
options.Wtrealm = "https://localhost:44307/"; 

// For AADj use the App ID URI from the app registration's Properties blade: 

options .lAİtrealm = "https: //wsfedsample.onmicrosoft. Com/bf0e7e6d-056e-4e37-b9a6-2c36797b9f01"; 

}); 

Services.AddMvc() 

// ... 


Addaduthentication (dize) aşırı yüklemesi defaultscheme özelliğini ayarlar. Addaduthentication 
(Action<AuthenticationOptions>) aşırı yüklemesi, farklı amaçlarla varsayılan kimlik doğrulama düzenlerini 
ayarlamak için kullanılabilen kimlik doğrulama seçeneklerinin yapılandırılmasını sağlar. AddAuthentication için 
sonraki çağrılar önceden yapılandırılmış Authenticationoptions özelliklerini geçersiz kılar. 

Kimlik doğrulama işleyicisi kaydeden Authenticationbuilder genişletme metotları, kimlik doğrulama düzeni başına 
yalnızca bir kez çağrılabilir. Düzen özellikleri, Düzen adı ve görünen ad yapılandırmasına izin veren aşırı yüklemeler 
var. 

WS-Federasyon ile oturum açın 

Gözat'a tıklayın ve uygulama için oturum Gezinti üst bilgisindeki bağlantı. VVsFederation ile oturum açmak için bir 

































seçenek vardır: 


WebAppliCatİ0n5 Home About Contact Register Log in 


Log in 

Use a local account to log in. Use another service to log in. 


Email 



Forgot your passvrord? 
Register as a new user 


VVsFederation 


Log in using your WsFederation account | 


Sağlayıcı olarak AD FS ile düğme ADFS oturum açma sayfasına yönlendirir: 


my domain 


Sign in with your organizational account 


someone@example.com 


Passvvord 


Sign in 


© 2013 Microsoft 


Azure Active Directory ile sağlayıcı olarak, düğmeyi AAD oturum açma sayfasına yönlendirir: 

























Bir başarılı oturum açma için yeni bir kullanıcı uygulamanın kullanıcı kayıt sayfasına yönlendirir: 


WebApplİcatİon5 Home About Contact Register Log in 


Register 

Associate your VVsFederation account. 


You've successfully authenticated with WsFederation. Please enter an email address for this site below and click the Register button to finish logging 
in. 

Email 

Register 


WS-Federation ASP.NET Core kimliği olmadan kullanın 


WS-Federation ara yazılım kimlik kullanılabilir.Örneğin: 








public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddAuthentication(sharedOptions => 

{ 

sharedOptions.DefaultScheme = CookieAuthenticationDefaults .AuthenticationScheme; 
sharedOptions.DefaultSignlnScheme = CookieAuthenticationDefaults.AuthenticationScheme 
sharedOptions.DefaultChallengeScheme = WsFederationDefaults.AuthenticationScheme; 

}) 

.AddWsFederation(options => 

{ 

options .l/Jtrealm = Configuration["wsfed:realm"]; 

options.MetadataAddress = Configuration["wsfed:metadata"]; 

}) 

.AddCookie(); 

} 

public void Configure(IApplicationBuilder app) 

{ 

app.UseAuthentication(); 

// ... 



ASRNET Core hesap onaylama ve parola kurtarma 
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By Rick Anderson, Ponantve ali Audette 

Bu öğreticide, e-posta onayı ve parola sıfırlama ile bir ASP.NET Core uygulamasının nasıl oluşturulacağı 
gösterilmektedir. Bu öğretici bir başlangıç konusu değildir . Sahibi olmalısınız: 

• ASP.NET Core 

• Kimlik Doğrulaması 

• Entity Framevvork Core 

ASP.NET Core 1,1 sürümü için Bu PDF dosyasına bakın. 

Prerequisites 

.NET Core 3,0 SDK veya üzeri 

Kimlik doğrulamasıyla bir Web uygulaması oluşturma ve test etme 

Kimlik doğrulamasıyla bir Web uygulaması oluşturmak için aşağıdaki komutları çalıştırın. 

dotnet new webapp -au Individual -uld -o WebPWrecover 
cd WebPWrecover 
dotnet run 

Uygulamayı çalıştırın, Kaydet bağlantısını seçin ve bir Kullanıcı kaydedin. Kaydolduktan sonra, e-posta onayı 
benzetimi için bir bağlantı içeren /identity/Account/RegisterConfirmation 'e yönlendirilirsiniz: 

• Click here to confirm your account bağlantısını seçin. 

• Oturum açma bağlantısını seçin ve aynı kimlik bilgileriyle oturum açın. 

• SİZİ /Identity/Account/Manage/PersonalData sayfasına yönlendiren HelloYourEmail@provider.com! bağlantısını 
seçin. 

• Sol taraftaki kişisel veri sekmesini seçin ve Sil' i seçin. 

E-posta sağlayıcısı yapılandırma 

Bu öğreticide, SendGrid e-posta göndermek için kullanılır. E-posta göndermek için bir SendGrid hesabına ve 
anahtarına ihtiyacınız vardır. Diğer e-posta sağlayıcılarını kullanabilirsiniz. E-posta göndermek için SendGrid veya 
başka bir e-posta hizmeti kullanmanızı öneririz. Güvenli hale getirmek ve düzgün şekilde ayarlamak zordur. 

Güvenli e-posta anahtarını getirmek için bir sınıf oluşturun. Bu örnek için Hizmetler/Authiletienderoptiorıs. 
csoluşturun: 

public class AuthMessageSenderOptions 
{ 

public string SendGridUser { get; set; } 
public string SendGridKey { get; set; } 

} 

SendGrid Kullanıcı gizli dizilerini yapılandırma 

SendGridUser ve SendGridKey gizli-Manager aracıile ayarlayın. Örneğin: 











dotnet user-secrets set SendGridllser RickAndMSFT 
dotnet user-secrets set SendGridKey <key> 

Successfully saved SendGridUser = RickAndMSFT to the secret store. 

Windows 'da, gizli dizi Anahtarlar/değer çiftlerini %APPDATA%/Microsoft/UserSecrets/<WebAppName-userSecretsId> 
dizininde bir gizlilikler. JSON dosyasında depolar. 

Gizli dizileri. JSON dosyasının içeriği şifrelenmez. Aşağıdaki biçimlendirme, gizlilikler. JSON dosyasını gösterir. 
SendGridKey değeri kaldırıldı. 

{ 

"SendGridUser": "RickAndMSFT", 

"SendGridKey": "<key removed>" 

} 

Daha fazla bilgi için bkz. Options model ve yapılandırma. 

SendGrid 'i yükler 

Bu öğretici, SendGridaracılığıyla e-posta bildirimlerinin nasıl ekleneceğini gösterir, ancak SMTP ve diğer 
mekanizmaları kullanarak e-posta gönderebilirsiniz. 

SendGrid NuGet paketini yükler: 

• Visual Studio 

• .NETCoreCLI 

Paket Yöneticisi konsolundan, aşağıdaki komutu girin: 

Install-Package SendGrid 

Ücretsiz SendGrid hesabına kaydolmak için bkz. SendGrid İle çalışmaya başlayın . 

lemailsender uygulama 

iEmaiisender uygulamak için, aşağıdakine benzer bir kodla Hizmetler/EmailSender. cs oluşturun: 







using Microsoft.AspNetCore.Identity.UI.Services; 

using Microsoft.Extensions.Options; 

using SendGrid; 

using SendGrid.Helpers.Mail; 

using System.Threading.Tasks; 

namespace WebPWrecover.Services 

{ 

public class EmailSender : IEmailSender 

{ 

public EmailSender(IOptions<AuthMessageSenderOptions> optionsAccessor) 

{ 

Options = optionsAccessor.Value; 

} 

public AuthMessageSenderOptions Options { get; } //set only via Secret Manager 

public Task SendEmailAsync(string email, string subject, string message) 

{ 

return Execute(Options.SendGridKey, subject, message, email); 

} 

public Task Execute(string apiKey, string subject, string message, string email) 

{ 

var Client = new SendGridClient(apiKey); 
var msg = new SendGridMessage() 

{ 

From = new EmailAddress("loe@contoso.com", Options.SendGridUser), 

Subject = subject, 

PlainTextContent = message, 

HtmlContent = message 

}; 

msg.AddTo(new EmailAddress(email)); 

// Disable click tracking. 

// See https://sendgrid.com/docs/User_Guide/Settings/tracking.html 
msg.SetClickTracking(false, false); 

return Client.SendEmailAsync(msg); 

} 

} 

} 


Başlat ’ı e-postayı destekleyecek şekilde yapılandırma 

Aşağıdaki kodu Startup.es dosyasındaki configureServices yöntemine ekleyin: 

• Geçici hizmet olarak EmailSender ekleyin. 

• AuthMessageSenderOptions yapılandırma örneğini kaydedin. 






public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 
Services.AddDefaultIdentity<IdentityUser>( 

options => options.SignIn.RequireConfirmedAccount = true) 
.AddEntityFrameworkStores<ApplicationDbContext>(); 

// requires 

// using Microsoft.AspNetCore.Identity.III.Services; 

// using WebPWrecover.Services; 

Services.AddTransient<IEmailSender, EmailSender>(); 

Services.ConfigurecAuthMessageSenderOptions>(Configuration); 

Services.AddRazorPages(); 

} 


Kaydolun, e-postayı onaylayın ve parolayı sıfırlayın 

Web uygulamasını çalıştırın ve hesap onaylama ve parola kurtarma akışını test edin. 

• Uygulamayı çalıştırın ve yeni bir kullanıcı kaydı 

• Hesap onay bağlantısı için e-postanızı kontrol edin. E-postayı alamazsanız hata ayıklama e-postasına bakın. 

• E-postanızı onaylamak için bağlantıya tıklayın. 

• E-postanız ve parolanızla oturum açın. 

• Signout. 

Sınama parolası sıfırlama 

• Oturum açtıysanız Oturumu Kapat 1 ı seçin. 

• Oturum aç bağlantısını seçin ve parolanızı unuttum? bağlantısını seçin. 

• Hesabı kaydettirmek için kullandığınız e-postayı girin. 

• Parolanızı sıfırlamaya yönelik bağlantı içeren bir e-posta gönderilir. E-postanızı kontrol edin ve parolanızı 
sıfırlamak için bağlantıya tıklayın. Parolanız başarıyla sıfırlandıktan sonra, e-posta ve yeni parolanızla oturum 
açabilirsiniz. 

E-posta ve etkinlik zaman aşımını değiştirme 

Varsayılan eylemsizlik zaman aşımı 14 gündür.Aşağıdaki kod, etkinlik dışı zaman aşımını 5 güne ayarlar: 

Services.ConfigureApplicationCookie(o => { 
o.ExpireTimeSpan = TimeSpan.FromDays(5); 
o.SlidingExpiration = true; 

}); 

Tüm veri koruma belirteci kullanım alanlarını Değiştir 

Aşağıdaki kod tüm veri koruma belirteçleri zaman aşımı süresini 3 saate değiştirir: 




public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 
Services.AddDefaultIdentity<IdentityUser>( 

options => options.SignIn.RequireConfirmedAccount = true) 
.AddEntityFrameworkStores<ApplicationDbContext>(); 

Services.Configure<DataProtectionTokenProviderOptions>(o => 
o.TokenLifespan = TimeSpan.FromHours(B)); 

Services.AddTransient<IEmailSender, EmailSender>(); 

Services.ConfigurecAuthMessageSenderOptions>(Configuration); 

Services.AddRazorPages(); 


Yerleşik kimlik Kullanıcı belirteçleri (bkz . Aspnetcore/src/ldentity/Extensions. Core/src/TokenOptions. cs ) bir gün 
zaman aşımı. 


E-posta belirtecini değiştir kullanım ömrü 

Kimlik Kullanıcı belirteçlerinin varsayılan belirteç kullanım ömrü bir gündür. Bu bölümde, eespan e-posta 
belirtecinin nasıl değiştirileceği gösterilmektedir. 


Özel bir Datakorunabilir<TUser > ve DataProtectionTokenProviderOptionsekleyin: 


public class CustomEmailConfirmationTokenProvider<TUser> 

: DataProtectorTokenProvider<TUser> where TUser : class 


{ 


public CustomEmailConfirmationTokenProvider(IDataProtectionProvider dataProtectionProvider, 
IOptions<EmailConfirmationTokenProviderOptions> options, 
ILogger<DataProtectorTokenProvider<TUser>> logger) 

: base(dataProtectionProvider, options, logger) 


{ 

} 


} 

public class EmailConfirmationTokenProviderOptions : DataProtectionTokenProviderOptions 

{ 


public EmailConfirmationTokenProviderOptions() 

{ 


Name = "EmailDataProtectorTokenProvider"; 
TokenLifespan = TimeSpan.FromHours(4); 

} 

} 


Özel sağlayıcıyı hizmet kapsayıcısına ekleyin: 




public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 

Services.AddDefaultIdentity<IdentityUser>(config => 

{ 

config.SignIn.RequireConfirmedEmail = true; 
config.Tokens.ProviderMap.Add("CustomEmailConfirmation ", 
new TokenProviderDescriptor( 

typeof(CustomEmailConfirmationTokenProvider<IdentityUser>))); 
config.Tokens.EmailConfirmationTokenProvider = "CustomEmailConfirmation"; 
}).AddEntityFrameworkStores<ApplicationDbContext>(); 

Services.AddTransient<CustomEmailConfirmationTokenProvider<IdentityUser>>(); 

Services.AddTransient<IEmailSender, EmailSender>(); 

Services.ConfigurecAuthMessageSenderOptions>(Configuration); 

Services.AddRazorPages(); 

} 


E-posta onayını yeniden gönder 

Bu GitHub sorununabakın. 

Hata ayıklama e-postası 

E-posta ile çalışmayı alamazsanız: 

• sendGridciient .sendEmailAsync çağrıldığını doğrulamak için EmailSender.Execute bir kesme noktası ayarlayın. 

• EmailSender.Execute benzer kodu kullanarak e-posta göndermek için bir konsol uygulaması oluşturun. 

• E-posta etkinlik sayfasını gözden geçirin. 

• İstenmeyen posta klasörünüzü kontrol edin. 

• Farklı bir e-posta sağlayıcısında (Microsoft, Yahoo, Gmail vb.) başka bir e-posta diğer adı deneyin 

• Farklı e-posta hesaplarına göndermeyi deneyin. 

En iyi güvenlik uygulaması , test ve geliştirmede üretim sırlarını kullanmamalıdır . Uygulamayı Azure 'a 
yayımlarsanız, SendGrid gizli dizilerini Azure Web App Portal 'da uygulama ayarları olarak ayarlayın. 
Yapılandırma sistemi ortam değişkenlerinden anahtarları okumak için ayarlanır. 

Sosyal ve yerel oturum açma hesaplarını birleştirme 

Bu bölümü gerçekleştirmek için önce bir dış kimlik doğrulama sağlayıcısı etkinleştirmeniz gerekir. Bkz. Facebook, 
Google ve dış sağlayıcı kimlik doğrulaması. 

E-posta bağlantısına tıklayarak Yerel ve sosyal hesapları birleştirebilirsiniz. Aşağıdaki dizide, 
"RickAndMSFT@gmail.com" ilk olarak yerel bir oturum açma olarak oluşturulur; Bununla birlikte, önce hesabı 
önce sosyal oturum açma olarak oluşturabilir, ardından yerel bir oturum açma ekleyebilirsiniz. 
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iki hesap birleştirildi. Her iki hesapla oturum açabiliyor olabilirsiniz. Kullanıcılarınızın sosyal oturum açma kimlik 
doğrulama hizmeti kapatılmış veya sosyal hesaplarına erişimi kaybettikleri olasılığına karşı yerel hesaplar 
eklemesini isteyebilirsiniz. 

Bir sitede kullanıcılar varsa hesap onayını etkinleştir 

Kullanıcılara bir sitede hesap onayını etkinleştirmek, mevcut tüm kullanıcıları kilitler. Mevcut kullanıcılar, hesapları 
onaylanmadığı için kilitlenir. Mevcut Kullanıcı kilitlemesini geçici olarak çözmek için aşağıdaki yaklaşımlardan 
birini kullanın: 

• Tüm mevcut kullanıcıları onaylanmış olarak işaretlemek için veritabanını güncelleştirin. 

• Mevcut kullanıcıları onaylayın. Örneğin, Batch-e-postaları onay bağlantılarıyla gönderin. 

Prerequisites 

.NET Core 2,2 SDK veya üzeri 

Web uygulaması ve yapı iskelesi kimliği oluşturma 

Kimlik doğrulamasıyla bir Web uygulaması oluşturmak için aşağıdaki komutları çalıştırın. 

dotnet new webapp -au Individual -uld -o WebPWrecover 
cd lAİebPİAİrecover 

dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design 
dotnet tool install -g dotnet-aspnet-codegenerator 

dotnet aspnet-codegeneraton identity -dc WebPWrecover.Data.ApplicationDbContext --fileş 

"Account. Register;Account. Login;Account. LogoutjAccount.ConfirmEmail" 

dotnet ef database drop -f 

dotnet ef database update 

dotnet run 


Yeni Kullanıcı kaydını sına 

Uygulamayı çalıştırın, Kaydet bağlantısını seçin ve bir Kullanıcı kaydedin. Bu noktada, e-postadaki tek doğrulama 
[EmailAddress] özniteliğidir. Kayıt gönderildikten sonra uygulamada oturum açarsınız. Daha sonra öğreticide, 
yeni kullanıcıların e-postaları doğrulanmadan oturum açması için kod güncellenir. 

Kimlik veritabanı görünümü 

• Visual Studio 

• .NET Core CLI 

• Gelen görünümü menüsünde SQL Server Nesne Gezgini (SSOX). 

• Gidin (localdb) (SQL Server 13) ifadesini MSSQLLocalDB. Sağ dbo. AspNetUsers > verileri 
görüntüleme: 
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Tablonun EmailConfirmed alanı False . 

Uygulama bir onay e-postası gönderdiğinde bir sonraki adımda bu e-postayı yeniden kullanmak isteyebilirsiniz. 
Satıra sağ tıklayın ve Sil' i seçin. E-posta diğer adını silmek aşağıdaki adımlarda daha kolay hale gelir. 

E-posta onayı gerektir 

Yeni bir Kullanıcı kaydının e-postasını onaylamak en iyi uygulamadır. E-posta onayı, başkalarının taklit 
etmeyeceğinden emin olmaya yardımcı olur (diğer bir deyişle, başka birinin e-postasına kaydolmamaları). Bir 
tartışma forumu olduğunu ve "yli@example.com" ın "nolivetto@contoso.com" olarak kaydolmasını engellemek 
istediğinizi varsayalım. E-posta onayı olmadan, "nolivetto@contoso.com" uygulamanızdan istenmeyen e-posta 
alabilir. Kullanıcının yanlışlıkla "ylo@example.com" olarak kaydolduğunu ve "yıllı" hatası olduğunu fark edelim. 
Uygulamanın doğru e-postası olmadığından parola kurtarma kullanamayacak. E-posta onayı, robotlardan sınırlı 
koruma sağlar. E-posta onayı çok sayıda e-posta hesabına sahip kötü amaçlı kullanıcılardan koruma sağlamaz. 

Genellikle yeni kullanıcıların, onaylanan bir e-posta almadan önce Web sitenize veri almasını engellemek 
istersiniz. 


Onaylanan bir e-posta gerektirecek startup.configureServices güncelleştirin: 













public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 

Services.AddDefaultIdentity<IdentityUser>(config => 

{ 

config.SignIn.RequireConfirmedEmail = true; 

}) 

.AddDefaultUI(UIFramework.Bootstrap4) 

.AddEntityFrameworkStores<ApplicationDbContext>(); 

// requires 

// using Microsoft.AspNetCore.Identity.UI.Services; 

// using 1/JebPİAİrecover.Services; 

Services.AddTransientcIEmailSender, EmailSender>(); 

Services.ConfigurecAuthMessageSenderOptions>(Configuration); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

} 

config.signin.RequireConfirmedEmail = true; , e-postaları onaylanana kadar kayıtlı kullanıcıların oturum açmasını 
önler. 

E-posta sağlayıcısını Yapılandır 

Bu öğreticide, SendGrid e-posta göndermek için kullanılır. E-posta göndermek için bir SendGrid hesabına ve 
anahtarına ihtiyacınız vardır. Diğer e-posta sağlayıcılarını kullanabilirsiniz. ASP.NET Core 2. x, uygulamanızdan e- 
posta göndermenizi sağlayan System.Net.Mail içerir. E-posta göndermek için SendGrid veya başka bir e-posta 
hizmeti kullanmanızı öneririz. Güvenli hale getirmek ve düzgün şekilde ayarlamak zordur. 

Güvenli e-posta anahtarını getirmek için bir sınıf oluşturun. Bu örnek için Hizmetler/Authiletienderoptiorıs. 
csoluşturun: 

public class AuthMessageSenderOptions 

{ 

public string SendGridUser { get; set; } 
public string SendGridKey { get; set; } 

} 

SendGrid Kullanıcı gizli dizilerini yapılandırma 

SendGridUser ve SendGridKey gizli-Manager aracıile ayarlayın. Örneğin: 

C:/WebAppl>dotnet user-secrets set SendGridUser RickAndMSFT 

info: Successfully saved SendGridUser = RickAndMSFT to the secret store. 

VVİndovvs 'da, gizli dizi Anahtarlar/değer çiftlerini %APPDATA%/Microsoft/UserSecrets/<WebAppName-userSecretsId> 
dizininde bir gizlilikler. JSON dosyasında depolar. 

Gizli dizileri. JSON dosyasının içeriği şifrelenmez. Aşağıdaki biçimlendirme, gizlilikler JSON dosyasını gösterir. 
SendGridKey değeri kaldırıldı. 

{ 

"SendGridUser": "RickAndMSFT ", 

"SendGridKey": "<key removed>" 

} 





Daha fazla bilgi için bkz. Options model ve yapılandırma. 

SendGrid 'i yükler 

Bu öğretici, SendGridaracılığıyla e-posta bildirimlerinin nasıl ekleneceğini gösterir, ancak SMTP ve diğer 
mekanizmaları kullanarak e-posta gönderebilirsiniz. 

SendGrid NuGet paketini yükler: 

• Visual Studio 

• .NETCoreCLI 

Paket Yöneticisi konsolundan, aşağıdaki komutu girin: 

Install-Package SendGrid 

Ücretsiz SendGrid hesabına kaydolmak için bkz. SendGrid İle çalışmaya başlayın . 

lemailsender uygulama 

iEmaiisender uygulamak için, aşağıdakine benzer bir kodla Hizmetier/EmaiiSender. cs oluşturun: 

using Microsoft.AspNetCore.Identity.UI.Services; 

using Microsoft.Extensions.Options; 

using SendGrid; 

using SendGrid.Helpers.Mail; 

using System.Threading.Tasks; 

namespace WebPWrecover.Services 

{ 

public class EmailSender : IEmailSender 

{ 

public EmailSender(IOptions<AuthMessageSenderOptions> optionsAccessor) 

{ 

Options = optionsAccessor.Value; 

} 

public AuthMessageSenderOptions Options { get; } //set only via Secret Manager 

public Task SendEmailAsync(string email, string subject, string message) 

{ 

return Execute(Options.SendGridKey, subject, message, email); 

} 

public Task Execute(string apiKey, string subject, string message, string email) 

{ 

var Client = new SendGridClient(apiKey); 
var msg = new SendGridMessage() 

{ 

From = new EmailAddress("loe@contoso.com", "Doe Smith"), 

Subject = subject, 

PlainTextContent = message, 

HtmlContent = message 

}; 

msg.AddTo(new EmailAddress(email)); 

// Disable click tracking. 

// See https://sendgrid.com/docs/User_Guide/Settings/tracking.html 
msg.SetClickTracking(false, false); 

return Client.SendEmailAsync(msg); 

} 

} 

} 




Başlat ’ı e-postayı destekleyecek şekilde yapılandırma 

Aşağıdaki kodu Startup.es dosyasındaki configureServices yöntemine ekleyin: 

• Geçici hizmet olarak Emaiisender ekleyin. 

• AuthMessageSenderOptions yapılandırma örneğini kaydedin. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuratiorı. GetConnectionString( "DefaultConnection"))); 

Services.AddDefaultIdentity<IdentityUser>(config => 

{ 

config.SignIn.RequireConfirmedEmail = true; 

}) 

.AddDefaultUI(UIFramework.Bootstrap4) 

.AddEntityFrameworkStores<ApplicationDbContext>(); 

// requires 

// using Microsoft.AspNetCore.Identity.III.Services; 

// using WebPWrecover.Services; 

Services.AddTransientcIEmailSender, EmailSender>(); 

Services.ConfigurecAuthMessageSenderOptions>(Configuration); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


Hesap onaylama ve parola kurtarmayı etkinleştirme 

Şablonda hesap onaylama ve parola kurtarma için kod bulunur. Areas/kimlik/sayfa/hesap/kayıt. cshtml. esiçinde 
onPostAsync yöntemi bulun. 

Yeni kayıtlı kullanıcıların aşağıdaki satırı açıklama ekleyerek otomatik olarak oturum açmasını engelleyin: 

await _sign!nManager.SignInAsync(userj isPersistent: false); 


Tüm Yöntem vurgulanmış olan değiştirilen çizgi ile gösterilir: 





public async Task<IActionResult> OnPostAsync(string returnUrl = null) 

{ 

returnUrl = returnUrl ?? Url.Content("~/"); 
if (ModelState.IsValid) 

{ 

var user = new IdentityUser { UserName = Input.Email, Emall = Input.Email }; 
var result = await _userManager.CreateAsync(user, Input.Password); 
if (result.Succeeded) 

{ 

_logger.LogInformation("User created a new account with password."); 

var code = await _userManager.GenerateEmailConfirmationTokenAsync(user); 
var callbackUrl = Url.Page( 

"/Account/ConfirmEmail ", 
pageHandler: null, 

values: new { userld = user.Id, code = code }, 
protocol: Request.Scheme); 

await _emailSender.SendEmailAsync(Input.Email, "Confirm your email", 

$"Please confirm your account by <a href='{HtmlEncoder.Default.Encode(callbackUrl)}'>clicking 

here</a>."); 

//await _signInManager.SignInAsync(user J isPersistent: false); 
return LocalRedirect(returnUrl); 

} 

foreach (var error in result.Errors) 

{ 

ModelState.AddModelError(string.Empty^ error.Description); 

} 

} 

// If we got this far, something failed, redisplay form 
return Page(); 


Kaydolun, e-postayı onaylayın ve parolayı sıfırlayın 

Web uygulamasını çalıştırın ve hesap onaylama ve parola kurtarma akışını test edin. 

• Uygulamayı çalıştırın ve yeni bir kullanıcı kaydı 

• Hesap onay bağlantısı için e-postanızı kontrol edin. E-postayı alamazsanız hata ayıklama e-postasına bakın. 

• E-postanızı onaylamak için bağlantıya tıklayın. 

• E-postanız ve parolanızla oturum açın. 

• Signout. 

Yönet sayfasını görüntüle 

Tarayıcıda Kullanıcı adınızı seçin: Kullanıcı adı ile tarayıcı penceresinde 
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Yönet sayfası, profil sekmesi seçili olarak görüntülenir. E -postada, e-postanın onaylandığını belirten bir onay 
kutusu gösterilir. 

Sınama parolası sıfırlama 

• Oturum açtıysanız Oturumu Kapat' ı seçin. 

• Oturum aç bağlantısını seçin ve parolanızı unuttum? bağlantısını seçin. 

• Hesabı kaydettirmek için kullandığınız e-postayı girin. 

• Parolanızı sıfırlamaya yönelik bağlantı içeren bir e-posta gönderilir. E-postanızı kontrol edin ve parolanızı 
sıfırlamak için bağlantıya tıklayın. Parolanız başarıyla sıfırlandıktan sonra, e-posta ve yeni parolanızla oturum 
açabilirsiniz. 

E-posta ve etkinlik zaman aşımını değiştirme 

Varsayılan eylemsizlik zaman aşımı 14 gündür.Aşağıdaki kod, etkinlik dışı zaman aşımını 5 güne ayarlar: 

Services.ConfigureApplicationCookie(o => { 
o.ExpireTimeSpan = TimeSpan.FromDays(5); 
o.SlidingExpiration = true; 

}); 

Tüm veri koruma belirteci kullanım alanlarını Değiştir 

Aşağıdaki kod tüm veri koruma belirteçleri zaman aşımı süresini 3 saate değiştirir: 








public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 

Services.AddDefaultIdentity<IdentityUser>(config => 

{ 

config.SignIn.RequireConfirmedEmail = true; 

}) 

.AddDefaultUI(UIFramework.Bootstrap4) 

.AddEntityFrameworkStores<ApplicationDbContext>(); 

Services.Configure<DataProtectionTokenProviderOptions>(o => 
o.TokenLifespan = TimeSpan.FromHours(3)); 

Services.AddTransient<IEmailSender, EmailSender>(); 

Services.ConfigurecAuthMessageSenderOptions>(Configuration); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

} 


Yerleşik kimlik Kullanıcı belirteçleri (bkz . Aspnetcore/src/ldentity/Extensions. Core/src/TokenOptions. cs ) bir gün 
zaman aşımı. 


E-posta belirtecini değiştir kullanım ömrü 

Kimlik Kullanıcı belirteçlerinin varsayılan belirteç kullanım ömrü bir gündür. Bu bölümde, eespan e-posta 
belirtecinin nasıl değiştirileceği gösterilmektedir. 


Özel bir Datakorunabilir<TUser > ve DataProtectionTokenProviderOptionsekleyin: 


public class CustomEmailConfirmationTokenProvider<TUser> 

: DataProtectorTokenProvider<TUser> where TUser : class 


{ 


public CustomEmailConfirmationTokenProvider(IDataProtectionProvider dataProtectionProvider, 
IOptions<EmailConfirmationTokenProviderOptions> options) 

: base(dataProtectionProvider, options) 


{ 

} 


} 

public class EmailConfirmationTokenProviderOptions : DataProtectionTokenProviderOptions 

{ 

public EmailConfirmationTokenProviderOptions() 

{ 


Name = "EmailDataProtectorTokenProvider"; 
TokenLifespan = TimeSpan.FromHours(4); 


} 


Özel sağlayıcıyı hizmet kapsayıcısına ekleyin: 




public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 

Services.AddDefaultIdentity<IdentityUser>(config => 

{ 

config.SignIn.RequireConfirmedEmail = true; 
config.Tokens.ProviderMap.Add("CustomEmailConfirmation ", 
new TokenProviderDescriptor( 

typeof(CustomEmailConfirmationTokenProvider<IdentityUser>))); 
config.Tokens.EmailConfirmationTokenProvider = "CustomEmailConfirmation"; 

}) 

.AddDefaultUI(UIFramework.Bootstrap4) 

.AddEntityFrameworkStores<ApplicationDbContext>(); 

Services.AddTransient<CustomEmailConfirmationTokenProvider<IdentityUser>>(); 
Services.AddTransient<IEmailSender, EmailSender>(); 

Services.Configure<AuthMessageSenderOptions>(Configuration); // For SendGrid key. 
Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

} 


E-posta onayını yeniden gönder 

Bu GitHub sorununabakın. 

Hata ayıklama e-postası 

E-posta ile çalışmayı alamazsanız: 

• sendGridciient .sendEmailAsync çağrıldığını doğrulamak için EmailSender.Execute bir kesme noktası ayarlayın. 

• EmailSender. Execute benzer kodu kullanarak e-posta göndermek için bir konsol uygulaması oluşturun. 

• E-posta etkinlik sayfasını gözden geçirin. 

• İstenmeyen posta klasörünüzü kontrol edin. 

• Farklı bir e-posta sağlayıcısında (Microsoft, Yahoo, Gmail vb.) başka bir e-posta diğer adı deneyin 

• Farklı e-posta hesaplarına göndermeyi deneyin. 

En iyi güvenlik uygulaması , test ve geliştirmede üretim sırlarını kullanmamalıdır . Uygulamayı Azure 'a 
yayımlarsanız, SendGrid gizli dizilerini Azure Web App Portal 'da uygulama ayarları olarak ayarlayabilirsiniz. 
Yapılandırma sistemi ortam değişkenlerinden anahtarları okumak için ayarlanır. 

Sosyal ve yerel oturum açma hesaplarını birleştirme 

Bu bölümü gerçekleştirmek için önce bir dış kimlik doğrulama sağlayıcısı etkinleştirmeniz gerekir. Bkz. Facebook, 
Google ve dış sağlayıcı kimlik doğrulaması. 

E-posta bağlantısına tıklayarak Yerel ve sosyal hesapları birleştirebilirsiniz. Aşağıdaki dizide, 
"RickAndMSFT@gmail.com" ilk olarak yerel bir oturum açma olarak oluşturulur; Bununla birlikte, önce hesabı 
önce sosyal oturum açma olarak oluşturabilir, ardından yerel bir oturum açma ekleyebilirsiniz. 
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Başka bir oturum açma hizmeti bağlantısına tıklayın ve uygulama isteklerini kabul edin. Aşağıdaki görüntüde 
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iki hesap birleştirildi. Her iki hesapla oturum açabiliyor olabilirsiniz. Kullanıcılarınızın sosyal oturum açma kimlik 
doğrulama hizmeti kapatılmış veya sosyal hesaplarına erişimi kaybettikleri olasılığına karşı yerel hesaplar 
eklemesini isteyebilirsiniz. 


Bir sitede kullanıcılar varsa hesap onayını etkinleştir 

Kullanıcılara bir sitede hesap onayını etkinleştirmek, mevcut tüm kullanıcıları kilitler. Mevcut kullanıcılar, hesapları 
onaylanmadığı için kilitlenir. Mevcut Kullanıcı kilitlemesini geçici olarak çözmek için aşağıdaki yaklaşımlardan 
birini kullanın: 

• Tüm mevcut kullanıcıları onaylanmış olarak işaretlemek için veritabanını güncelleştirin. 

• Mevcut kullanıcıları onaylayın. Örneğin, Batch-e-postaları onay bağlantılarıyla gönderin. 



ASPNET core'da TOTP authenticator uygulamaları 
için QR kodu oluşturmayı etkinleştirme 

10.05.2019 • 5 minutes to read ı Edit Online 


QR kodları, AS P.N ET Core 2.0 veya sonraki sürümünü gerektirir. 

ASP.NET Core, bireysel kimlik doğrulaması için Doğrulayıcı uygulamalar için destek ile birlikte gelir.Kullanarak 
bir zamana bağlı kerelik parola algoritması (TOTP), iki öğeli kimlik doğrulamayı (2FA) kimlik doğrulayıcısı 
uygulamalarını önerilen yaklaşımı 2FA için sektöre var. 2fa'yı kullanarak TOTP SMS 2FA için tercih edilir. 
Authenticator uygulaması, kullanıcı adı ve parola onayladıktan sonra hangi kullanıcıların girmelisiniz 8 6 rakamlı 
bir kod sağlar. Genellikle bir kimlik doğrulayıcı uygulaması, bir akıllı telefonda yüklenir. 

ASP.NET Core web uygulaması şablonları kimlik doğrulayıcılar destekler, ancak QRCode oluşturulması için 
destek sağlaması gerekmez. QRCode oluşturucuları 2FA kurulumu kolaylaştırır. Bu belgede eklerken size yol 
gösterecek QR kodunu 2fa'yı yapılandırma sayfasına oluşturma. 

iki Etmenli kimlik doğrulamasının olmayacak gibi bir dış kimlik doğrulama sağlayıcısı kullanarak Google veya 
Facebook. Harici oturum açmaları korunmasını dış oturum açma sağlayıcısı tarafından herhangi bir mekanizma 
sağlar. Örneğin, düşünün Microsoft kimlik doğrulama sağlayıcısı, donanım anahtarı veya başka bir 2FA yaklaşım 
gerektirir. "Yerel" 2fa'yı varsayılan şablonlar zorunlu, kullanıcıların yaygın olarak kullanılan bir senaryo değildir iki 
2FA yaklaşım karşılamak için duyacaktır. 

QR kodları 2fa'yı yapılandırma sayfasına ekleme 

Bu yönergeleri kullanın qrcode.js gelen https://davidshimjs.github.io/qrcodejs/depo. 

• indirme qrcode.js javascript Kitaplığı için wwwroot\üb projenizdeki klasör. 

• Bölümündeki yönergeleri iskele kimlik oluşturulacak 
/Areas/ldentity/Pages/Account/Manage/EnableAuthenticator.cshtml. 

• içinde /Areas/ldentity/Pages/Account/Manage/EnableAuthenticator.cshtml, bulun Scripts dosyanın 
sonunda bölüm: 

• içinde Pages/Account/Manage/EnableAuthenticator.cshtml (Razor sayfaları) veya 
Views/Manage/EnableAuthenticator.cshtml (MVC) bulun Scripts dosyanın sonunda bölüm: 

(Şsection Scripts { 

@await Html.PartialAsync("_ValidationScriptsPartial") 

} 

• Güncelleştirme Scripts bir başvuru eklemek için bölüm qrcodejs kitaplığı eklediğiniz ve QR kodunu 
oluşturmak için bir çağrı. Şu şekilde görünmelidir: 











(Şsection Scripts { 

@await Html.PartialAsync("_ValidationScriptsPartial") 

<script type="text/javascript" src="~/lib/qrcode. js"x/script> 
<script type="text/javascript"> 

new QRCode(document.getElementById("qrCode "), 

{ 

text: "@Html.Raw(Model.AuthenticatorUri)", 
width: 150, 
height: 150 

}); 

</script> 

} 


• Bu yönergeleri için bağlantıları paragraf silin. 

Uygulamanızı çalıştırın ve QR kodunu tarayın ve Doğrulayıcı kanıtlar doğrulanması emin olun. 

Site adı QR kodunu değiştirin 

QR kodunu site adı, başlangıçta, projeyi oluştururken seçtiğiniz proje adından alınır. Bakarak değiştirebilirsiniz 
GenerateQrCodellri(string email, string unformattedKey) yönteminde 
/Areas/ldentity/Pages/Account/Manage/E nableAuthenticator.cshtml.es. 

QR kodunu site adı, başlangıçta, projeyi oluştururken seçtiğiniz proje adından alınır. Bakarak değiştirebilirsiniz 
GenerateQrCodeUri(string email, string unformattedKey) yönteminde 
Pages/Account/Manage/EnableAuthenticator.cshtml.cs (Razor sayfaları) dosya veya 
ControUers/ManageCorıtroller.cs (MVC) dosyası. 

Şablondan varsayılan kod şu şekilde görünür: 

private string GenerateQrCodeUri(string email, string unformattedKey) 

{ 

return string.Format( 

AuthenticatorUriFormat, 

_urlEncoder.Encode("Razor Pages"), 

_urlEncoder.Encode(email), 
unformattedKey ); 

} 

ikinci parametre çağrısında string.Format , çözüm adı geçen, site adı kullanılır. Herhangi bir değere 
değiştirilebilir, ancak her zaman URL olarak kodlanmış olmalıdır. 

Farklı bir QR kodu kitaplığı kullanma 

QR kodu kitaplığı ile tercih edilen kitaplığınızı değiştirebilirsiniz. HTML'yi içeren bir qrCode kitaplığınızı öğesi 
içine yerleştirebileceğiniz bir QR kodu tarafından ne olursa olsun mekanizması sağlar. 

Doğru biçimlendirilmiş bir URL için QR kodunu kullanılabilir: 


AuthenticatorUri model Özelliği, 
data-url bir Özellik qrCodeData Öğesi. 


TOTP istemci ve sunucu zaman eğimi 

TOTP (zamana bağlı kerelik parola) kimlik doğrulaması doğru bir zaman hem sunucu hem de authenticator 
cihazda bağlıdır. Belirteçleri, 30 saniye için yalnızca en son. TOTP 2FA oturum açma başarısız oluyorsa, sunucu 
saatinin doğru ve doğru bir NTP hizmetine tercihen eşitlenmiş olduğunu denetleyin. 











ASPNET Core SMS ile iki öğeli kimlik doğrulama 
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Tarafından Rick Anderson ve İsviçre geliştiriciler 


W ARNING 

Kullanarak bir zamana bağlı kerelik parola algoritması (TOTP), iki öğeli kimlik doğrulamayı (2FA) kimlik doğrulayıcısı 
uygulamalarını önerilen yaklaşımı 2FA için sektöre var. 2fa'yı kullanarak TOTP SMS 2FA için tercih edilir. Daha fazla bilgi için 
ASP.NET core'da TOTP authenticator uygulamaları için etkinleştirme QR kodu oluşturmayı ASP.NET Core 2.0 ve üzeri. 


Bu öğreticide, SMS kullanarak iki öğeli kimlik doğrulamasını (2FA) ayarlama işlemi gösterilmektedir.Yönergeler 
için verilir tvvilio ve ASPSMS, ancak herhangi bir SMS Sağlayıcısı kullanabilirsiniz. Tamamlamanız önerilir hesap 
onaylama ve parola kurtarma bu öğreticiye başlamadan önce. 

Görüntüleme veya indirme örnek kodu. Karşıdan yükleme. 

Yeni birASP.NET Core projesi oluşturma 

Adlı yeni bir AS P.N ET Core web uygulaması oluşturma web 2 FA bireysel kullanıcı hesapları ile. HTTPS 'yi 
ayarlamak ve AS P.N ET Core 'de HTTPS 'yi zorla istemek için içindeki yönergeleri izleyin. 

SMS hesap oluşturma 

Örneğin, bir SMS hesap oluşturma tvvilio veya ASPSMS. Kimlik doğrulama bilgilerini kaydedin (Tvvilio: Accountsıd 
ve authToken için, ASPSMS için: UserKey ve Passvvord). 

SMS Sağlayıcısı kimlik bilgilerini başarınızda 
Tvvilio 

Tvvilio hesabınızın Pano sekmesinden Hesap SID 'Sini ve kimlik doğrulama belirtecinikopyalayın. 

ASPSMS: 

Hesap ayarlarınızda userKey ' e gidin ve parolamzlabirlikte kopyalayın. 

Daha sonra bu değerleri gizli dizi Yöneticisi Aracı anahtarları içinde oturum depolarız SMSAccountidentification ve 
SMSAccountPassword . 

Senderıd belirtme / Düzenleyicisi 

Tvvilio Sayılar sekmesinden Tvvilio telefon numaranızıkopyalayın. 

ASPSMS: Kilit açma/kaldırma menüsünde, bir veya daha fazla kaynaktan yararlanın veya alfasayısal bir kaynağı 
(tüm ağlar tarafından desteklenmez) seçin. 

Gizli dizi Yöneticisi Aracı anahtarı içinde bu değer daha sonra depolarız SMSAccountFrom . 

SMS hizmet için kimlik bilgilerini sağlayın 

Kullanacağız seçenekleri deseni kullanıcı hesabı ve anahtarı ayarlarına erişmek için. 

• Güvenli SMS anahtarını getirmek için bir sınıf oluşturun. Bu örnek için SMSoptions sınıf oluşturulduğu 
Services/SMSoptions.cs dosya. 











namespace Web2FA.Services 

{ 

public class SMSoptions 

{ 

public string SMSAccountldentification { get; set; } 
public string SMSAccountPassword { get; set; } 
public string SMSAccountFrom { get; set; } 

} 

} 

Ayarlama SMSAccountldentification, SMSAccountPassword ve SMSAccountFrom ile gizli dizi Yöneticisi aracım. 
Örneğin: 

C:/Web2FA/src/WebAppl>dotnet user-secrets set SMSAccountldentification 12345 
info: Successfully saved SMSAccountldentification = 12345 to the secret store. 


• SMS Sağlayıcısı için NuGet paketini ekleyin. Paket Yöneticisi Konsolu (çalıştırma PMC'yi gelen): 

Tvvilio 


Install-Package Twilio 


ASPSMS: 


Install-Package ASPSMS 


• Kodda Services/MessageServices.cs SMS etkinleştirmek için dosya. Tvvilio veya ASPSMS bölüm kullanın 


Tvvilio 








using Microsoft.Extensions.Options; 
using System.Threading.Tasks; 
using Twilio; 

using Twilio. Rest.Api .V2010.Account; 
using Twilio.Types; 

namespace Web2FA.Services 

{ 

// This class is used by the application to send Email and SMS 
// when you turn on two-factor authentication in ASP.NET Identity. 

// For more details see this link https://go.microsoft.com/fwlink/?LinkID=532713 
public class AuthMessageSender : IEmailSender, ISmsSender 
{ 

public AuthMessageSender(IOptions<SMSoptions> optionsAccessor) 

{ 

Options = optionsAccessor.Value; 

} 

public SMSoptions Options { get; } // set only via Secret Manager 

public Task SendEmailAsync(string email, string subject, string message) 

{ 

// Plug in your email service here to send an email. 
return Task.FromResult(0); 

} 

public Task SendSmsAsync(string number, string message) 

{ 

// Plug in your SMS service here to send a text message. 

// Your Account SID from twilio.com/console 
var accountSid = Options.SMSAccountldentificationj 
// Your Auth Token from twilio.com/console 
var authToken = Options.SMSAccountPassword; 

TwilioClient.Init(accountSid, authToken); 

return MessageResource.CreateAsync( 
to: new PhoneNumber(number), 
from: new PhoneNumber(Options.SMSAccountFrom), 
body: message); 

} 

} 

} 


ASPSMS: 



using Microsoft.Extensions.Options; 
using System.Threading.Tasks; 

namespace Web2FA.Services 

{ 

// This class is used by the application to send Email and SMS 
// when you turn on two-factor authentication in ASP.NET Identity. 

// For more details see this link https://go.microsoft.com/fwlink/?LinkID=532713 
public class AuthMessageSender : IEmailSender, ISmsSender 
{ 

public AuthMessageSender(IOptions<SMSoptions> optionsAccessor) 

{ 

Options = optionsAccessor.Value; 

} 

public SMSoptions Options { get; } // set only via Secret Manager 

public Task SendEmailAsync(string email, string subject, string message) 

{ 

// Plug in your email service here to send an email. 
return Task.FromResult(0); 

} 

public Task SendSmsAsync(string number, string message) 

{ 

ASPSMS.SMS SMSSender = new ASPSMS.SMS(); 

SMSSender.Userkey = Options.SMSAccountldentification; 

SMSSender.Password = Options.SMSAccountPassword; 

SMSSender.Originator = Options.SMSAccountFrom; 

SMSSender.AddRecipient(number); 

SMSSender.MessageData = message; 

SMSSender.SendTextSMS(); 

return Task.FromResult(0); 

} 

} 

} 


Başlangıç kullanmak için yapılandırma SMSoptions 

Ekleme SMSoptions hizmet kapsayıcısını configureServices yönteminde Startup.es: 

// Add application Services. 

Services.AddTransient<IEmailSender, AuthMessageSender>(); 

Services.AddTransient<ISmsSender, AuthMessageSender>(); 

Services.Configure<SMSoptions>(Configuration); 


İki öğeli kimlik doğrulamayı etkinleştirme 

Views/Manage/lndex. cshtml Razor görünüm dosyasını açın ve açıklama karakterlerini kaldırın (Bu nedenle 
biçimlendirme yok). 

İki öğeli kimlik bilgilerinizle oturum açın 


• Uygulamayı çalıştırın ve yeni bir kullanıcı kaydı 
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• Etkinleştirir, kullanıcı adına dokunun index Yönet denetleyicideki eylem yöntemi. Telefon numarası'e dokunun 
Ekle bağlantı. 



VVebApplicationl Home Aboııt Contact Hei<|joe@contoso com! | Log off 


Manage your account. 

Change your account settîngs 


Password: 
Extemal Logins: 
Phone Number: 


Two-Factor Authentic... 


[ Change] 

O [Manage] 

Phone Numbers can used as a second factor of verification in tv/o-factor 
authentication See this article for details on setting up this ASP.NET application to 
support tv/o-factor authentication using SMS 


Nanen 

Disabled Enabte 


© 2015 - VVebApplicationl 


• Doğrulama kodu almak ve dokunun telefon numarası ekleme doğrulama kodu Gönder. 
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• Doğrulama kodunu içeren bir kısa mesaj alırsınız. Girin ve dokunun Gönder 
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Kısa mesaj alamazsanız, t w i I i o günlüğü sayfasında bakın. 

• Telefon numaranızı başarıyla eklendi yönet görünümü gösterir. 























• Dokunun etkinleştirme iki öğeli kimlik doğrulamasını etkinleştirmek için. 
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İki öğeli kimlik doğrulamasını Sına 

• Oturumunuzu kapatın. 

• Oturum aç. 

• Kullanıcı hesabı, iki öğeli kimlik doğrulama, ikinci faktör kimlik doğrulaması sağlamak zorunda etkinleştirdi. 
Bu öğreticide, telefon doğrulama etkinleştirmiş olmanız gerekir. Yerleşik şablonlar, e-posta ikinci öğe olarak 
ayarlamanıza olanak sağlar. QR kodları gibi kimlik doğrulaması için ek ikinci faktör ayarlayabilirsiniz. 






















Dokunun gönderme. 



• Mesajla aldığınız kodu girin. 

• Tıklayarak bu tarayıcı Hatırlansın onay kutusunu muaf, 2FA aynı cihaz ve tarayıcı kullanarak oturum 
açmak için kullandığınız gerek. 2fa'yı etkinleştirme ve tıklayarak bu tarayıcı Hatırlansın cihazınıza 
erişiminiz yoksa sürece, hesabınıza erişmeye çalışırken kötü niyetli kullanıcıların güçlü 2FA koruma 
sağlayacaktır. Düzenli olarak kullandığınız özel cihaz üzerinde bunu yapabilirsiniz. Ayarlayarak bu tarayıcı 
Hatırlansın, düzenli olarak kullanmadığınız cihazlardan 2FA eklenen güvenliğini size ve kendi cihazlarında 
2FA gitmek zorunda değil üzerinde kolaylık alın. 
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Deneme yanılma saldırılarına karşı korumak için hesap kilitleme 

Hesap kilitleme 2FA ile önerilir. Bir kullanıcı bir yerel hesap veya sosyal hesap ile oturum açtıktan sonra başarısız 
girişimleri 2FA'konumunda depolanır. En fazla başarısız erişim denemesine ulaşıldığında, Kullanıcı kilitlenir 
(varsayılan: 5 başarısız erişim denemesinden sonra 5 dakikalık kilitleme). Başarılı bir kimlik doğrulaması başarısız 
erişim denemesi sayısını sıfırlar ve saatini sıfırlar. En fazla erişim denemesi başarısız oldu ve kilitleme süresi ile 
ayarlanabilir MaxFailedAccessAttempts ve DefaultLockoutTimeSpan. Aşağıdaki hesap kilitleme 10 erişim 
denemesi başarısız olduktan sonra 10 dakika için yapılandırır: 

public void ConfigureServices(IServiceCollection Services) 

{ 

// Add framework Services. 

Services.AddDbContext<ApplicationDbContext>(options => 

options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection"))); 

Services.Addldentity< Appl icationUser, IdentityRole>() 

.AddEntityFrameworkStores<ApplicationDbContext>() 

.AddDefaultTokenProviders(); 

Services. AddMvc(); 

Services. Configure<IdentityOptions>(options => 

{ 

options.Lockout.MaxFailedAccessAttempts = 10; 

options.Lockout.DefaultLockoutTimeSpan = TimeSpan.FromMinutes(10); 

}); 

// Add application Services. 

Services.AddTransient<IEmailSenderj AuthMessageSender>(); 

Services.AddTransient<ISmsSenderj AuthMessageSender>(); 

Services.Configure<SMSoptions>(Configuration); 

} 

Onaylayın PassvvordSignlnAsync ayarlar lockoutonFailure için true : 

var result = await _signInManager.PasswordSignInAsync( 

Input.Email, Input.Password, Input.RememberMe, lockoutonFailure: true); 






ASPNET Core kimliği olmadan tanımlama bilgisi 
kimlik doğrulaması kullanma 
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Tarafından Rick Anderson ve Luke Latham 

ASP.NET Core kimlik, oturum açma işlemleri oluşturmaya ve korumaya yönelik eksiksiz, tam özellikli bir kimlik 
doğrulama sağlayıcısıdır. Ancak, ASP.NET Core kimliği olmayan tanımlama bilgisi tabanlı bir kimlik doğrulama 
sağlayıcısı kullanılabilir. Daha fazla bilgi için bkz. ASP.NET Core kimliğe giriş. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Örnek uygulamadaki tanıtım amacıyla, Maria Rodriguez olan kuramsal kullanıcının Kullanıcı hesabı, uygulamaya 
sabit olarak kodlanmıştır. Kullanıcı oturumu açmak için e-posta adresi maria.rodriguez@contoso.com ve herhangi 
bir parolayı kullanın. Kullanıcının kimliği, Sayfalar/Account/Login. cshtml. cs dosyasındaki Authenticateuser 
yönteminde doğrulanır. Gerçek dünyada bir örnekte, kullanıcının kimliği bir veritabanında doğrulanır. 

Yapılandırma 

Uygulama Microsoft AspNetCore. app metapackagekullanmıyorsa, Microsoft. Aspnetcore. Authentication. 
Cookies paketi için proje dosyasında bir paket başvurusu oluşturun. 

startup.configureServices yönteminde, AddAuthentication ve AddCookie yöntemleriyle kimlik doğrulama ara 
yazılım hizmetleri oluşturun: 

Services. AddAut hentication(CookieAuthent icat ionDefault s .Aut hent icat ionScheme) 

.AddCookie(); 

AddAuthentication geçirilen AuthenticationScheme, uygulamanın varsayılan kimlik doğrulama şemasını ayarlar. 
AuthenticationScheme , tanımlama bilgisi kimlik doğrulamasının birden çok örneği olduğunda ve belirli bir 
şemayla yetkilendirmekistediğiniz durumlarda kullanışlıdır. AuthenticationScheme , leauthenticationdefaults. 
AuthenticationScheme olarak ayarlanması, düzen İçin "tanımlama bilgileri" değeri sağlar. Düzeni ayıran herhangi 
bir dize değeri sağlayabilirsiniz. 

Uygulamanın kimlik doğrulama düzeni, uygulamanın tanımlama bilgisi kimlik doğrulama düzeninden farklıdır. 
AddCookieiçin bir tanımlama bilgisi kimlik doğrulama düzeni sağlanmamışsa, 

CookieAuthenticationDefaults.AuthenticationScheme ("Cookies") kullanır. 

Kimlik doğrulama tanımlama bilgisinin IsEssential özelliği varsayılan olarak true olarak ayarlanır. Bir site 
ziyaretçisi veri toplamaya onay vermemişse kimlik doğrulama tanımlama bilgilerine izin verilir. Daha fazla bilgi 
için bkz. ASP.NET Core Genel Veri Koruma Yönetmeliği (GDPR) desteği. 

stantup.configune , HttpContext.user özelliğini ayarlamak ve istekler için yetkilendirme ara yazılımını çalıştırmak 


UseAuthentication 

ve 

UseAuthorization 

çağırın. 

useEndpoints çağrılmadan önce 

UseAuthentication 


useAuthorization yöntemlerini çağırın: 















app.UseAuthentication(); 
app.UseAuthorization(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapControllers(); 
endpoints.MapRazorPages(); 

}); 


CookieAuthenticationOptions sınıfı, kimlik doğrulama sağlayıcısı seçeneklerini yapılandırmak için kullanılır. 

startup.configureServices yönteminde kimlik doğrulaması için hizmet yapılandırmasında 
CookieAuthenticationOptions ayarlayın: 

Services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme) 

.AddCookie(options => 

{ 

}); 


Tanımlama bilgisi İlkesi ara yazılımı 

Tanımlama bilgisi İlkesi ara yazılımı , tanımlama bilgisi ilkesi yeteneklerini sunar.Ara yazılımı uygulama işleme 
işlem hattına eklemek—, yalnızca işlem hattına kayıtlı aşağı akış bileşenlerini etkiler. 

app.UseCookiePolicy(cookiePolicyOptions); 

Tanımlama bilgisi işlemenin genel özelliklerini denetlemek için tanımlama bilgisi İlkesi ara yazılımı ' nı 
CookiePolicyOptions kullanın ve tanımlama bilgileri eklenmiş veya silinmiş olduğunda tanımlama bilgisi işleme 
işleyicilerine kanca ekleyin. 

Varsayılan MinimumSameSitePolicy değeri, OAuth2 kimlik doğrulamasına izin verecek şekilde SameSiteMode.Lax . 
SameSiteMode. st rict aynı site ilkesini kesinlikle zorlamak için MinimumSameSitePolicy ayarlayın. Bu ayar, OAuth2 ve 
diğer çapraz kaynak kimlik doğrulama düzenlerini kesse de, çıkış noktaları arası istek işlemeye bağlı olmayan 
diğer uygulama türleri için tanımlama bilgisi güvenlik düzeyini yükseltir. 

var cookiePolicyOptions = new CookiePolicyOptions 
{ 

MinimumSameSitePolicy = SameSiteMode.Strict, 

}; 

MinimumSameSitePolicy için tanımlama bilgisi İlkesi ara yazılım ayarı, aşağıdaki matriye göre 
CookieAuthenticationOptions ayarlarındaki Cookie.samesite ayarını etkileyebilir. 


MİNİMUMSAMESİTEPOLİCY 


COOKIE. SAMESITE 


SONUÇ TANIMLAMA BİLGİSİ. SAMESITE 
AYARI 


SameSiteMode. None 


SameSiteMode. None 
SameSiteMode. LAX 
SameSiteMode. Strict 


SameSiteMode. None 
SameSiteMode. LAX 
SameSiteMode. Strict 


SameSiteMode. LAX 


SameSiteMode. None 
SameSiteMode. LAX 
SameSiteMode. Strict 


SameSiteMode. LAX 
SameSiteMode. LAX 
SameSiteMode. Strict 






MINIMUMSAMESITEPOLICY 

COOKIE. SAMESITE 

SONUÇ TANIMLAMA BİLGİSİ. SAMESITE 
AYARI 

SameSiteMode. Strict 

SameSiteMode. None 

SameSiteMode. LAX 

SameSiteMode. Strict 

SameSiteMode. Strict 

SameSiteMode. Strict 

SameSiteMode. Strict 


Kimlik doğrulama tanımlama bilgisi oluşturma 

Kullanıcı bilgilerini tutan bir tanımlama bilgisi oluşturmak için bir ClaimsPrincipaloluşturun. Kullanıcı bilgileri 
serileştirilir ve tanımlama bilgisinde depolanır. 

Gerekli Claims Claimsldentity oluşturun ve Kullanıcı oturumu açmak için SignlnAsync çağırın: 

var claims = new List<Claim> 

{ 

new Claim(ClaimTypes.Name, user.Email), 

new Claim("FullName", user.FullName), 

new Claim(ClaimTypes.Role, "Administrator"), 

}; 

var claimsldentity = new Claimsldentity( 

claims, CookieAuthenticationDefaults.AuthenticationScheme); 

var authProperties = new AuthenticationProperties 

{ 

//AllowRefresh = <bool>, 

// Refreshing the authentication session should be allowed. 

//ExpiresUtc = DateTimeOffset.UtcNow.AddMinutes(10), 

// The time at which the authentication ticket expires. A 
// value set here overrides the ExpireTimeSpan option of 
// CookieAuthenticationOptions set with AddCookie. 

//IsPersistent = true, 

// Whether the authentication session is persisted across 
// multiple requests. When used with cookies, Controls 
// whether the cookie's lifetime is absolute (matching the 
// lifetime of the authentication ticket) or session-based. 

//IssuedUtc = <DateTimeOffset>, 

// The time at which the authentication ticket was issued. 

//RedirectUri = <string> 

// The full path or absolute URI to be used as an http 
// redirect response value. 

}; 

await HttpContext.SignInAsync( 

CookieAuthenticationDefaults.AuthenticationScheme, 
new ClaimsPrincipal(claimsldentity), 
authProperties); 

SignlnAsync şifreli bir tanımlama bilgisi oluşturur ve geçerli yanıta ekler. AuthenticationScheme belirtilmemişse, 
varsayılan düzen kullanılır. 

ASP.NET Core veri koruma sistemi şifreleme için kullanılır. Birden çok makinede barındırılan bir uygulama, 
uygulamalar arasında yük dengeleme veya bir Web grubu kullanma için, veri korumayı aynı anahtar halkasını ve 
uygulama tanımlayıcısını kullanacak şekilde yapılandırın. 


Oturumu Kapat 



Geçerli kullanıcının oturumunu kapatmak ve tanımlama bilgilerini silmek için SignOutAsyncçağırın: 

await HttpContext.SignOutAsync( 

CookieAuthenticationDefaults .Aut hent icat ionScheme); 

cookieAuthenticationDefaults.AuthenticationScheme (veya "Cookies"), düzen olarak (örneğin, "ContosoCookie") 
kullanılmazsa, kimlik doğrulama sağlayıcısını yapılandırırken kullanılan düzeni sağlayın. Aksi takdirde, varsayılan 
düzen kullanılır. 

Arka uç değişikliklerine tepki verme 

Tanımlama bilgisi oluşturulduktan sonra tanımlama bilgisi tek kimlik kaynağıdır.Arka uç sistemlerinde bir 
kullanıcı hesabı devre dışı bırakılmışsa: 

• Uygulamanın tanımlama bilgisi kimlik doğrulama sistemi, kimlik doğrulama tanımlama bilgisine göre istekleri 
işlemeye devam eder. 

• Kimlik doğrulama tanımlama bilgisi geçerli olduğu sürece kullanıcı uygulamada oturum açmış durumda kalır. 

ValidatePrincipa olayı, tanımlama bilgisi kimliğinin doğrulanmasını ve geçersiz kılınması için kullanılabilir. Her 
istekte tanımlama bilgisinin doğrulanması, uygulamaya erişen kullanıcıların iptal edilmesinin riskini azaltır. 

Tanımlama bilgisi doğrulamasına yönelik bir yaklaşım, kullanıcı veritabanının değiştiği zaman izlemenin 
izlenmesine bağlıdır. Kullanıcının tanımlama bilgisi verildikten sonra veritabanı değiştirilmediyse, tanımlama 
bilgisi hala geçerliyse kullanıcının kimliğini yeniden doğrulamaya gerek yoktur. Örnek uygulamada, veritabanı 
ıuserRepository uygulanır ve bir Lastchanged değeri depolar. Veritabanında bir Kullanıcı güncelleştirildiği 
zaman, Lastchanged değeri geçerli saate ayarlanır. 

Veritabanı Lastchanged değerine göre değiştiğinde bir tanımlama bilgisini geçersiz kılmak için, veritabanından 
geçerli Lastchanged değerini içeren bir Lastchanged talep ile tanımlama bilgisini oluşturun: 

var claims = new List<Claim> 

{ 

new Claim(ClaimTypes.Name, user.Email), 
new Claim("LastChanged", {Database Value}) 

}; 

var claimsldentity = new Claimsldentity( 
claims, 

CookieAuthenticationDefaults .Aut hent icat İonScheme); 

await HttpContext.SignInAsync( 

CookieAuthenticationDefaults.AuthenticatİonScheme, 
new ClaimsPrincipal(claimsldentity)); 

validatePrincipai olayına bir geçersiz kılma uygulamak için, CookieAuthenticationEventstüretilen bir sınıfa 
aşağıdaki imzaya sahip bir yöntem yazın: 

ValidatePrincipai(CookieValidatePrincipalContext) 


Aşağıda cookieAuthenticationEvents örnek bir uygulamasıdır: 








using System.Linq; 

using System.Threading.Tasks; 

using Microsoft.AspNetCore.Authentication; 

using Microsoft. AspNetCore. Aut hent icat ion. Cookies; 

public class CustomCookieAuthenticationEvents : CookieAuthenticationEvents 

{ 

private readonly IUserRepository _userRepository; 

public CustomCookieAuthenticationEvents(IUserRepository userRepository) 

{ 

// Get the database from registered DI Services. 

_userRepository = userRepository; 

} 

public override async Task ValidatePrincipal(CookieValidatePrincipalContext context) 

{ 

var userPrincipal = context.Principal; 


// Look for the LastChanged daim, 
var lastChanged = (from c in userPrincipal.Claims 
where c.Type == "LastChanged" 
select c.Value).FirstOrDefault(); 

if (string.IsNullOrEmpty(lastChanged) | 

!_userRepository.ValidateLastChanged(lastChanged)) 

{ 

context.RejectPrincipal(); 


} 


} 


} 


await context.HttpContext.SignOutAsync( 

CookieAuthenticationDefaults.AuthenticationScheme); 


startup.configureServices yönteminde tanımlama bilgisi hizmeti kaydı sırasında olay örneğini kaydedin. 
customCookieAuthenticationEvents sınıfınız için kapsamlı bir hizmet kaydı sağlayın: 

Services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme) 

.AddCookie(options => 

{ 

options.EventsType = typeof(CustomCookieAuthenticationEvents); 

}); 

Services.AddScoped<CustomCookieAuthenticationEvents>(); 


Kullanıcı adının güncelleştirildiği bir durumu, güvenliği hiçbir şekilde etkilemeyen bir kararı—göz önünde 
bulundurun. Kullanıcı sorumlusunu kalıcı olarak güncelleştirmek istiyorsanız, context.RepiacePrincipai çağırın ve 
context.shouidRenew özelliğini true olarak ayarlayın. 


VVARNING 

Burada açıklanan yaklaşım her istekte tetiklenir. Her istekteki tüm kullanıcılar için kimlik doğrulama tanımlama bilgilerinin 
doğrulanması, uygulama için büyük bir performans cezası oluşmasına neden olabilir. 


Kalıcı tanımlama bilgileri 

Tanımlama bilgisinin tarayıcı oturumları arasında kalıcı olmasını isteyebilirsiniz. Bu Kalıcılık yalnızca oturum açma 
veya benzer bir mekanizmanın "Beni anımsa" onay kutusu ile açık kullanıcı onayı ile etkinleştirilmelidir. 








Aşağıdaki kod parçacığı, tarayıcı kapanışları aracılığıyla Herlikli bir kimlik ve ilgili tanımlama bilgisi oluşturur. Daha 
önce yapılandırılmış tüm Kayan süre sonu ayarları kabul edilir. Tarayıcı kapalıyken tanımlama bilgisinin süresi 
dolarsa tarayıcı, yeniden başlatıldıktan sonra tanımlama bilgisini temizler. 

IsPersistent AuthenticationProperties true olarak ayarlayın: 

// using Microsoft.AspNetCore.Authentication; 

await HttpContext.SignInAsync( 

CookieAuthenticationDefaults.AuthenticationScheme, 
new ClaimsPrincipal(claimsIdentity), 
new AuthenticationProperties 
{ 

IsPersistent = true 

}); 


Mutlak tanımlama bilgisi süre sonu 

Mutlak bir süre sonu, Expireslltcile ayarlanabilir. Kalıcı bir tanımlama bilgisi oluşturmak için, IsPersistent de 
ayarlanması gerekir. Aksi takdirde, tanımlama bilgisi oturum tabanlı bir yaşam süresi ile oluşturulur ve bu kimlik 
doğrulama biletinden önce ya da sonra zaman alabilir. Expiresutc ayarlandığında, ayarlandıysa, 
CookieAuthenticationOptionsExpireTimeSpan seçeneğinin değerini geçersiz kılar. 

Aşağıdaki kod parçacığı, 20 dakika boyunca bir kimlik ve karşılık gelen tanımlama bilgisi oluşturur. Bu, daha önce 
yapılandırılmış olan tüm Kayan süre sonu ayarlarını yoksayar. 

// using Microsoft.AspNetCore.Authentication; 

await HttpContext.SignInAsync( 

CookieAuthenticationDefaults.AuthenticatİonScheme, 
new ClaimsPrincipal(claimsIdentity), 
new AuthenticationProperties 
{ 

IsPersistent = true, 

ExpiresUtc = DateTime.UtcNow.AddMinutes(20) 

}); 

ASP.NET Core kimlik, oturum açma işlemleri oluşturmaya ve korumaya yönelik eksiksiz, tam özellikli bir kimlik 
doğrulama sağlayıcısıdır. Ancak, ASP.NET Core kimliği olmayan tanımlama bilgisi tabanlı kimlik doğrulama 
sağlayıcısı kullanılabilir. Daha fazla bilgi için bkz. ASP.NET Core kimliğe giriş. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Örnek uygulamadaki tanıtım amacıyla, Maria Rodriguez olan kuramsal kullanıcının Kullanıcı hesabı, uygulamaya 
sabit olarak kodlanmıştır. Kullanıcı oturumu açmak için e-posta adresi maria.rodriguez@contoso.com ve herhangi 
bir parolayı kullanın. Kullanıcının kimliği, Sayfalar/Account/Login. cshtml. cs dosyasındaki Authenticateuser 
yönteminde doğrulanır. Gerçek dünyada bir örnekte, kullanıcının kimliği bir veritabanında doğrulanır. 

Yapılandırma 

Uygulama Microsoft. AspNetCore. app metapackagekullanmıyorsa, Microsoft. Aspnetcore. Authentication. 
Cookies paketi için proje dosyasında bir paket başvurusu oluşturun. 

startup.configureServices yönteminde, kimlik doğrulama ara yazılım hizmetini AddAuthentication ve 
AddCookie yöntemlerle oluşturun: 








Services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme) 

.AddCookie(); 

AddAuthentication geçirilen AuthenticationScheme, uygulamanın varsayılan kimlik doğrulama şemasını ayarlar. 
AuthenticationScheme , tanımlama bilgisi kimlik doğrulamasının birden çok örneği olduğunda ve belirli bir 
şemayla yetkilendirmekistediğiniz durumlarda kullanışlıdır. AuthenticationScheme , leauthenticationdefaults. 
AuthenticationScheme olarak ayarlanması, düzen İçin "tanımlama bilgileri" değeri sağlar. Düzeni ayıran herhangi 
bir dize değeri sağlayabilirsiniz. 


Uygulamanın kimlik doğrulama düzeni, uygulamanın tanımlama bilgisi kimlik doğrulama düzeninden farklıdır. 
AddCookieiçin bir tanımlama bilgisi kimlik doğrulama düzeni sağlanmamışsa, 

CookieAuthenticationDefaults.AuthenticationScheme ("Cookies") kullanır. 

Kimlik doğrulama tanımlama bilgisinin IsEssential özelliği varsayılan olarak true olarak ayarlanır. Bir site 
ziyaretçisi veri toplamaya onay vermemişse kimlik doğrulama tanımlama bilgilerine izin verilir. Daha fazla bilgi 
için bkz.ASP.NET Core Genel Veri Koruma Yönetmeliği (GDPR) desteği. 


stantup.Configune yönteminde, HttpContext.User özelliğini ayarlayan kimlik doğrulama ara yazılımını çağırmak 
için useAuthentication yöntemini çağırın. useMvcwithDefauitRoute veya useMvc çağrılmadan önce 
useAuthentication yöntemi çağırın: 


app.UseAuthentication(); 


CookieAuthenticationOptions sınıfı, kimlik doğrulama sağlayıcısı seçeneklerini yapılandırmak için kullanılır. 

startup.configureServices yönteminde kimlik doğrulaması için hizmet yapılandırmasında 
CookieAuthenticationOptions ayarlayın: 

Services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme) 

.AddCookie(options => 

{ 

}); 


Tanımlama bilgisi İlkesi ara yazılımı 

Tanımlama bilgisi İlkesi ara yazılımı , tanımlama bilgisi ilkesi yeteneklerini sunar.Ara yazılımı uygulama işleme 
işlem hattına eklemek—, yalnızca işlem hattına kayıtlı aşağı akış bileşenlerini etkiler. 

app.UseCookiePolicy(cookiePolicyOptions); 

Tanımlama bilgisi işlemenin genel özelliklerini denetlemek için tanımlama bilgisi İlkesi ara yazılımı ' nı 
CookiePolicyOptions kullanın ve tanımlama bilgileri eklenmiş veya silinmiş olduğunda tanımlama bilgisi işleme 
işleyicilerine kanca ekleyin. 

Varsayılan MinimumSameSitePolicy değeri, OAuth2 kimlik doğrulamasına izin verecek şekilde sameSiteMode.Lax . 
sameSiteMode.strict aynı site ilkesini kesinlikle zorlamak için MinimumSameSitePolicy ayarlayın. Bu ayar, OAuth2 ve 
diğer çapraz kaynak kimlik doğrulama düzenlerini kesse de, çıkış noktaları arası istek işlemeye bağlı olmayan 
diğer uygulama türleri için tanımlama bilgisi güvenlik düzeyini yükseltir. 











var cookiePolicyOptions = new CookiePolicyOptions 

{ 

MinimumSameSitePolicy = SameSiteMode.Strict, 

}; 


MinimumSameSitePolicy için tanımlama bilgisi İlkesi ara yazılım ayarı, aşağıdaki matriye göre 
cookieAuthenticationOptions ayarlarındaki Cookie.samesite ayarını etkileyebilir. 


MİNİMUMSAMESİTEPOLİCY 

COOKIE. SAMESITE 

SONUÇ TANIMLAMA BİLGİSİ. SAMESITE 
AYARI 

SameSiteMode. None 

SameSiteMode. None 

SameSiteMode. LAX 

SameSiteMode. Strict 

SameSiteMode. None 

SameSiteMode. LAX 

SameSiteMode. Strict 

SameSiteMode. LAX 

SameSiteMode. None 

SameSiteMode. LAX 

SameSiteMode. Strict 

SameSiteMode. LAX 

SameSiteMode. LAX 

SameSiteMode. Strict 

SameSiteMode. Strict 

SameSiteMode. None 

SameSiteMode. LAX 

SameSiteMode. Strict 

SameSiteMode. Strict 

SameSiteMode. Strict 

SameSiteMode. Strict 


Kimlik doğrulama tanımlama bilgisi oluşturma 

Kullanıcı bilgilerini tutan bir tanımlama bilgisi oluşturmak için bir ClaimsPrincipaloluşturun. Kullanıcı bilgileri 
serileştirilir ve tanımlama bilgisinde depolanır. 

Gerekli Claims Claimsldentity oluşturun ve Kullanıcı oturumu açmak için SignlnAsync çağırın: 



var claims = new List<Claim> 

{ 

new Claim(ClaimTypes.Name, user.Email), 

new Claim("FullName", user. FullName), 

new Claim(ClaimTypes.Role, "Administrator"), 

}J 

var claimsldentity = new Claimsldentity( 

claims, CookieAuthenticationDefaults.AuthenticationScheme); 

var authProperties = new AuthenticationProperties 

{ 

//AllowRefresh = <bool>, 

// Refreshing the authentication session should be allowed. 

//ExpiresUtc = DateTimeOffset.UtcNow.AddMinutes(10), 

// The time at which the authentication ticket expires. A 
// value set here overrides the ExpireTimeSpan option of 
// CookieAuthenticationOptions set with AddCookie. 

//IsPersistent = true, 

// Whether the authentication session is persisted across 
// multiple requests. When used with cookies, Controls 
// whether the cookie's lifetime is absolute (matching the 
// lifetime of the authentication ticket) or session-based. 

//IssuedUtc = <DateTimeOffset>, 

// The time at which the authentication ticket was issued. 

//RedirectUri = <string> 

// The full path or absolute URI to be used as an http 
// redirect response value. 

}; 

await HttpContext.SignInAsync( 

CookieAuthenticationDefaults .Aut hent icat İonScheme, 
new ClaimsPrincipal(claimsldentity), 
authProperties); 

signinAsync şifreli bir tanımlama bilgisi oluşturur ve geçerli yanıta ekler. AuthenticationScheme belirtilmemişse, 
varsayılan düzen kullanılır. 

ASP.NET Core veri koruma sistemi şifreleme için kullanılır. Birden çok makinede barındırılan bir uygulama, 
uygulamalar arasında yük dengeleme veya bir Web grubu kullanma için, veri korumayı aynı anahtar halkasını ve 
uygulama tanımlayıcısını kullanacak şekilde yapılandırın. 

Oturumu Kapat 

Geçerli kullanıcının oturumunu kapatmak ve tanımlama bilgilerini silmek için SignOutAsyncçağırın: 

await HttpContext.SignOutAsync( 

CookieAuthenticationDefaults.AuthenticationScheme); 

CookieAuthenticationDefaults.AuthenticationScheme (veya "Cookies"), düzen olarak (örneğin, "ContosoCookie") 
kullanılmazsa, kimlik doğrulama sağlayıcısını yapılandırırken kullanılan düzeni sağlayın. Aksi takdirde, varsayılan 
düzen kullanılır. 

Arka uç değişikliklerine tepki verme 

Tanımlama bilgisi oluşturulduktan sonra tanımlama bilgisi tek kimlik kaynağıdır.Arka uç sistemlerinde bir 
kullanıcı hesabı devre dışı bırakılmışsa: 



• Uygulamanın tanımlama bilgisi kimlik doğrulama sistemi, kimlik doğrulama tanımlama bilgisine göre istekleri 
işlemeye devam eder. 

• Kimlik doğrulama tanımlama bilgisi geçerli olduğu sürece kullanıcı uygulamada oturum açmış durumda kalır. 

ValidatePrincipa olayı, tanımlama bilgisi kimliğinin doğrulanmasını ve geçersiz kılınması için kullanılabilir. Her 
istekte tanımlama bilgisinin doğrulanması, uygulamaya erişen kullanıcıların iptal edilmesinin riskini azaltır. 

Tanımlama bilgisi doğrulamasına yönelik bir yaklaşım, kullanıcı veritabanının değiştiği zaman izlemenin 
izlenmesine bağlıdır. Kullanıcının tanımlama bilgisi verildikten sonra veritabanı değiştirilmediyse, tanımlama 
bilgisi hala geçerliyse kullanıcının kimliğini yeniden doğrulamaya gerek yoktur. Örnek uygulamada, veritabanı 
ıuserRepository uygulanır ve bir Lastchanged değeri depolar. Veritabanında bir Kullanıcı güncelleştirildiği 
zaman, Lastchanged değeri geçerli saate ayarlanır. 

Veritabanı Lastchanged değerine göre değiştiğinde bir tanımlama bilgisini geçersiz kılmak için, veritabanından 
geçerli Lastchanged değerini içeren bir Lastchanged talep ile tanımlama bilgisini oluşturun: 

var claims = new List<Claim> 

{ 

new Claim(ClaimTypes.Name, user.Email), 
new Claim("LastChanged", {Database Value}) 

}; 

var claimsldentity = new Claimsldentity( 
claims, 

CookieAuthenticationDefaults .Aut hent icat ionScheme); 

await HttpContext.SignInAsync( 

CookieAuthenticationDefaults.AuthenticationScheme, 
new ClaimsPrincipal(claimsldentity)); 

validatePrincipai olayına bir geçersiz kılma uygulamak için, CookieAuthenticationEventstüretilen bir sınıfa 
aşağıdaki imzaya sahip bir yöntem yazın: 

ValidatePrincipai(CookieValidatePrincipalContext) 


Aşağıda cookieAuthenticationEvents örnek bir uygulamasıdır: 









using System.Linq; 

using System.Threading.Tasks; 

using Microsoft.AspNetCore.Authentication; 

using Microsoft. AspNetCore. Aut hent icat ion. Cookies; 

public class CustomCookieAuthenticationEvents : CookieAuthenticationEvents 

{ 

private readonly IUserRepository _userRepository; 

public CustomCookieAuthenticationEvents(IUserRepository userRepository) 

{ 

// Get the database from registered DI Services. 

_userRepository = userRepository; 

} 

public override async Task ValidatePrincipal(CookieValidatePrincipalContext context) 

{ 

var userPrincipal = context.Principal; 


// Look for the LastChanged daim, 
var lastChanged = (from c in userPrincipal.Claims 
where c.Type == "LastChanged" 
select c.Value).FirstOrDefault(); 

if (string.IsNullOrEmpty(lastChanged) | 

!_userRepository.ValidateLastChanged(lastChanged)) 

{ 

context.RejectPrincipal(); 


} 


} 


} 


await context.HttpContext.SignOutAsync( 

CookieAuthenticationDefaults.AuthenticationScheme); 


startup.configureServices yönteminde tanımlama bilgisi hizmeti kaydı sırasında olay örneğini kaydedin. 
customCookieAuthenticationEvents sınıfınız için kapsamlı bir hizmet kaydı sağlayın: 

Services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme) 

.AddCookie(options => 

{ 

options.EventsType = typeof(CustomCookieAuthenticationEvents); 

}); 

Services.AddScoped<CustomCookieAuthenticationEvents>(); 


Kullanıcı adının güncelleştirildiği bir durumu, güvenliği hiçbir şekilde etkilemeyen bir kararı—göz önünde 
bulundurun. Kullanıcı sorumlusunu kalıcı olarak güncelleştirmek istiyorsanız, context.RepiacePrincipai çağırın ve 
context.shouidRenew özelliğini true olarak ayarlayın. 


VVARNING 

Burada açıklanan yaklaşım her istekte tetiklenir. Her istekteki tüm kullanıcılar için kimlik doğrulama tanımlama bilgilerinin 
doğrulanması, uygulama için büyük bir performans cezası oluşmasına neden olabilir. 


Kalıcı tanımlama bilgileri 

Tanımlama bilgisinin tarayıcı oturumları arasında kalıcı olmasını isteyebilirsiniz. Bu Kalıcılık yalnızca oturum açma 
veya benzer bir mekanizmanın "Beni anımsa" onay kutusu ile açık kullanıcı onayı ile etkinleştirilmelidir. 








Aşağıdaki kod parçacığı, tarayıcı kapanışları aracılığıyla Herlikli bir kimlik ve ilgili tanımlama bilgisi oluşturur. Daha 
önce yapılandırılmış tüm Kayan süre sonu ayarları kabul edilir. Tarayıcı kapalıyken tanımlama bilgisinin süresi 
dolarsa tarayıcı, yeniden başlatıldıktan sonra tanımlama bilgisini temizler. 

IsPersistent AuthenticationProperties true olarak ayarlayın: 

// using Microsoft.AspNetCore.Authentication; 

await HttpContext.SignInAsync( 

CookieAuthenticationDefaults.AuthenticationScheme, 
new ClaimsPrincipal(claimsIdentity), 
new AuthenticationProperties 
{ 

IsPersistent = true 

}); 


Mutlak tanımlama bilgisi süre sonu 

Mutlak bir süre sonu, Expireslltcile ayarlanabilir. Kalıcı bir tanımlama bilgisi oluşturmak için, IsPersistent de 
ayarlanması gerekir. Aksi takdirde, tanımlama bilgisi oturum tabanlı bir yaşam süresi ile oluşturulur ve bu kimlik 
doğrulama biletinden önce ya da sonra zaman alabilir. Expiresutc ayarlandığında, ayarlandıysa, 
CookieAuthenticationOptionsExpireTimeSpan seçeneğinin değerini geçersiz kılar. 

Aşağıdaki kod parçacığı, 20 dakika boyunca bir kimlik ve karşılık gelen tanımlama bilgisi oluşturur. Bu, daha önce 
yapılandırılmış olan tüm Kayan süre sonu ayarlarını yoksayar. 

// using Microsoft.AspNetCore.Authentication; 

await HttpContext.SignInAsync( 

CookieAuthenticationDefaults.AuthenticatİonScheme, 
new ClaimsPrincipal(claimsIdentity), 
new AuthenticationProperties 
{ 

IsPersistent = true, 

ExpiresUtc = DateTime.UtcNow.AddMinutes(20) 

}); 


Ek kaynaklar 

• ASP.NET Core belirli bir şemayla yetkilendir 

• ASP.NET Core 'de talep tabanlı yetkilendirme 

• ilke tabanlı rol denetimleri 

• Web çiftliğinde ASP.NET Core ana bilgisayar 





ASPNET Core kimlik olmadan sosyal oturum açma 
sağlayıcısı kimlik doğrulamasını kullanma 
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ASP.NET Core Facebook, Google ve dış sağlayıcı kimlik doğrulaması, kullanıcıların dış kimlik doğrulama 
sağlayıcılarının kimlik bilgileriyle OAuth 2,0 kullanarak oturum açmasını nasıl sağladığını açıklar. Bu konuda 
açıklanan yaklaşım kimlik doğrulama sağlayıcısı olarak ASP.NET Core kimliğini içerir. 

Bu örnek, ASP.NET Core kimliği olmadan bir dış kimlik doğrulama sağlayıcısının nasıl kullanılacağını gösterir. Bu, 
ASP.NET Core kimliğin tüm özelliklerini gerektirmeyen, ancak yine de güvenilen bir dış kimlik doğrulama 
sağlayıcısıyla tümleştirme gerektiren uygulamalar için yararlıdır. 

Bu örnek, kullanıcıların kimliğini doğrulamak için Google kimlik doğrulamasını kullanır. Google kimlik 
doğrulamasını kullanmak, oturum açma işlemini Google 'a yönetmenin karmaşıklıklarından çoğunu kaydırır. Farklı 
bir dış kimlik doğrulama sağlayıcısıyla tümleştirme için aşağıdaki konulara bakın: 

• Facebook kimlik doğrulaması 

• Microsoft kimlik doğrulaması 

• Tvvitter kimlik doğrulaması 

• Diğer sağlayıcılar 

Yapılandırma 

configureServices yönteminde, uygulamanın kimlik doğrulama düzenlerini AddAuthentication, AddCookieve 
AddGoogle yöntemleriyle yapılandırın: 

public void ConfigureServices(IServiceCollection Services) 

{ 

// requires 

// using Microsoft.AspNetCore.Authentication.Cookies; 

// using Microsoft.AspNetCore.Authentication.Google; 

// NuGet package Microsoft.AspNetCore.Authentication.Google 
Services 

.AddAuthentication(options => 

{ 

options.DefaultScheme = CookieAuthenticationDefaults.AuthenticationScheme; 
options.DefaultChallengeScheme = GoogleDefaults.AuthenticationScheme; 

}) 

.AddCookie() 

.AddGoogle(options => 

{ 

options.Clientld = Configuration["Authentication:Google:ClientId"]; 
options.ClientSecret = Configuration["Authentication:Google:ClientSecret"]; 

}); 

Services.AddRazorPages(); 

} 

AddAuthentication çağrısı, uygulamanın DefaultSchemeayarlar. DefaultScheme , aşağıdaki HttpContext kimlik 
doğrulama uzantısı yöntemleri tarafından kullanılan varsayılan şemadır: 

• AuthenticateAsync 

• ChallengeAsync 








• ForbidAsync 

• SignlnAsync 

• SignOutAsync 

Uygulamanın Defaultscheme , leauthenticationdefaults. AuthenticationScheme ("Cookies") olarak ayarlanması, 
uygulamayı bu uzantı yöntemlerinin varsayılan şeması olarak tanımlama bilgilerini kullanacak şekilde yapılandırır. 
Uygulamanın DefaultChallengeScheme GoogleDefaults. AuthenticationScheme ("Google") olarak ayarlanması, 
uygulamayı, chailengeAsync çağrıları için varsayılan düzen olarak Google 'ı kullanacak şekilde yapılandırır. 
DefaultChallengeScheme geçersiz kılmaları Defaultscheme . Ayarlandığında Defaultscheme geçersiz kılan ek 
özellikler için AuthenticationOptions bakın. 


Startup.Configure 

' de, çağırma 

UseRouting 

ve 

useEndpoints arasında 

UseAuthentication 

ve 

UseAuthorization 


çağırın. Bu, HttpContext.user özelliğini ayarlar ve istekler için yetkilendirme ara yazılımını çalıştırır: 

app.UseRouting(); 

app.UseAuthentication(); 
app.UseAuthorization(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapRazorPages(); 

}); 

Kimlik doğrulama şemaları ve tanımlama bilgisi kimlik doğrulaması hakkında daha fazla bilgi için bkz. ASP.NET 
Core kimliği olmadan tanımlama bilgisi kimlik doğrulaması kullanma. 

Yetkilendirmeyi uygula 

Bir denetleyiciye, eyleme veya sayfaya AuthorizeAttribute özniteliğini uygulayarak uygulamanın kimlik doğrulama 
yapılandırmasını test edin. Aşağıdaki kod, Gizlilik sayfasına erişimi doğrulanan kullanıcılarla sınırlandırır: 

[Authorlze] 

public class PrivacyModel : PageModel 
{ 

} 


Oturumu kapat 

Geçerli kullanıcının oturumunu kapatmak ve tanımlama bilgilerini silmek için Signoutasyncçağırın. Aşağıdaki kod, 
Dizin sayfasına bir Logout sayfa işleyicisi ekler: 

public class IndexModel : PageModel 
{ 

public async Task<IActionResult> OnPostLogoutAsync() 

{ 

await HttpContext.SignOutAsync(); 
return RedirectToPage(); 

} 

} 

SignOutAsync çağrısının bir kimlik doğrulama düzeni belirtmediğine dikkat edin. Uygulamanın 
CookieAuthenticationDefaults.AuthenticationScheme Defaultscheme geri dönüş olarak kullanılır. 
















Ek kaynaklar 

• ASP.NET core'da basit yetkilendirme 

• AS P.N ET Core dış sağlayıcılardan ek talepler ve belirteçler kalıcı hale getirme 

ASP.NET Core Facebook, Google ve dış sağlayıcı kimlik doğrulaması, kullanıcıların dış kimlik doğrulama 
sağlayıcılarının kimlik bilgileriyle OAuth 2,0 kullanarak oturum açmasını nasıl sağladığını açıklar. Bu konuda 
açıklanan yaklaşım kimlik doğrulama sağlayıcısı olarak ASP.NET Core kimliğini içerir. 

Bu örnek, ASP.NET Core kimliği olmadan bir dış kimlik doğrulama sağlayıcısının nasıl kullanılacağını gösterir. Bu, 
ASP.NET Core kimliğin tüm özelliklerini gerektirmeyen, ancak yine de güvenilen bir dış kimlik doğrulama 
sağlayıcısıyla tümleştirme gerektiren uygulamalar için yararlıdır. 

Bu örnek, kullanıcıların kimliğini doğrulamak için Google kimlik doğrulamasını kullanır. Google kimlik 
doğrulamasını kullanmak, oturum açma işlemini Google 'a yönetmenin karmaşıklıklarından çoğunu kaydırır. Farklı 
bir dış kimlik doğrulama sağlayıcısıyla tümleştirme için aşağıdaki konulara bakın: 

• Facebook kimlik doğrulaması 

• Microsoft kimlik doğrulaması 

• Tvvitter kimlik doğrulaması 

• Diğer sağlayıcılar 

Yapılandırma 

configureServices yönteminde, uygulamanın kimlik doğrulama düzenlerini AddAuthentication , AddCookie ve 
AddGoogle yöntemleriyle yapılandırın: 

Services 

.AddAuthentication(options => 

{ 

options.DefaultScheme = CookieAuthenticationDefaults.AuthenticationScheme; 
options.DefaultChallengeScheme = GoogleDefaults.AuthenticationScheme; 

}) 

.AddCookie() 

.AddGoogle(options => 

{ 

opt ions. Client Id = Configuration [" Aut hent icat ion: Google :ClientId"]; 
options.ClientSecret = Configuration["Authentication:Google:ClientSecret"]; 

}); 

Addaduthentication çağrısı, uygulamanın defaultschemedeğerini ayarlar. DefaultScheme , aşağıdaki HttpContext 
kimlik doğrulama uzantısı yöntemleri tarafından kullanılan varsayılan şemadır: 

• AuthenticateAsync 

• ChallengeAsync 

• ForbidAsync 

• SignlnAsync 

• SignOutAsync 

Uygulamanın DefaultScheme , leauthenticationdefaults. AuthenticationScheme ("Cookies") olarak ayarlanması, 
uygulamayı bu uzantı yöntemlerinin varsayılan şeması olarak tanımlama bilgilerini kullanacak şekilde yapılandırır. 
Uygulamanın DefaultChallengeScheme GoogleDefaults. AuthenticationScheme ("Google") olarak ayarlanması, 
uygulamayı, ChallengeAsync çağrıları için varsayılan düzen olarak Google 'ı kullanacak şekilde yapılandırır. 
DefaultChallengeScheme geçersiz kılmaları DefaultScheme . Ayarlandığında DefaultScheme geçersiz kılan ek 
özellikler için AuthenticationOptions bakın. 









configune yönteminde, HttpContext.user özelliğini ayarlayan kimlik doğrulama ara yazılımını çağırmak için 
UseAuthentication yöntemini çağırın. UseMvcI/dithDefaultRoute veya UseMvc çağrılmadan önce UseAuthentication 
yöntemi çağırın: 

app.UseAuthentication(); 

Kimlik doğrulama şemaları ve tanımlama bilgisi kimlik doğrulaması hakkında daha fazla bilgi için bkz. ASP.NET 
Core kimliği olmadan tanımlama bilgisi kimlik doğrulaması kullanma. 

Yetkilendirmeyi uygula 

Bir denetleyiciye, eyleme veya sayfaya AuthorizeAttribute özniteliğini uygulayarak uygulamanın kimlik doğrulama 
yapılandırmasını test edin. Aşağıdaki kod, Gizlilik sayfasına erişimi doğrulanan kullanıcılarla sınırlandırır: 

[Authorize] 

public class PrivacyModel : PageModel 
{ 

} 


Oturumu kapat 

Geçerli kullanıcının oturumunu kapatmak ve tanımlama bilgilerini silmek için Signoutasyncçağırın. Aşağıdaki kod, 
Dizin sayfasına bir Logout sayfa işleyicisi ekler: 

public class IndexModel : PageModel 
{ 

public async Task<IActionResult> OnPostLogoutAsync() 

{ 

await HttpContext.SignOutAsync(); 
return RedirectToPage(); 

} 

} 

SignOutAsync çağrısının bir kimlik doğrulama düzeni belirtmediğine dikkat edin. Uygulamanın 
CookieAuthenticationDefaults.AuthenticationScheme DefaultScheme geri dönüş olarak kullanılır. 


Ek kaynaklar 

• ASP.NET core'da basit yetkilendirme 

• AS P.N ET Core dış sağlayıcılardan ek talepler ve belirteçler kalıcı hale getirme 








ASPNET Core Azure Active Directory 

18.10.2019 • 2 minutes to read ı Edjt Online 


Azure AD vl örnekleri 

Aşağıdaki örneklerde, kullanıcıların iş ve okul hesabıyla oturum açmasını sağlamak için Azure AD vl 'nin nasıl 
tüm leştirileceği gösterilmektedir: 

• Azure AD'yi Bir ASP.NET Core Web Uygulamasıyla Tümleştirme 

• Azure AD kullanarak bir WPF Uygulamasından ASP.NET Core Web API'sini Çağırma 

• ASP.NET Core Web Uygulamasında Azure AD Kullanarak Web API'si Çağırma 

Azure AD v2 örnekleri 

Aşağıdaki örneklerde, kullanıcıların iş ve okul hesabıyla veya Microsoft kişisel hesabıyla (eski adıyla canlı hesap) 
oturum açmalarına olanak tanıyan Azure AD v2 tümleştirme gösterilmektedir: 

• Azure AD v2 'yi bir AS P.N ET Core 2,0 Web uygulamasıyla tümleştirme: 
o Bu ilişkili videoya bakın 

• Azure AD v2 kullanarak BİR WPF uygulamasından ASP.NET Core 2,0 Web API 'Sini çağırma: 
o Bu ilişkili videoya bakın 

Azure AD B2C örneği 

Bu örnek, kullanıcıların sosyal kimliklerle (Facebook, Google,...) oturum açmasını sağlayan Azure AD B2C nasıl 
tümleştirileceğini gösterir. 


• Azure AD B2C birASP.NET Core Web API 'SI 




Azure Active Directory B2C'de ASRNET Core ile 
bulut kimlik doğrulaması 
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Tarafından Cam Soper 

Azure Active Directory B2C (Azure AD B2C) olan bir bulut kimlik yönetimi çözümü, web ve mobil uygulamaları 
için. Hizmet, bulutta ve şirket içinde barındırılan uygulamalar için kimlik doğrulaması sağlar.Kimlik doğrulama 
türleri bireysel hesaplar, sosyal ağ hesabı, içerir ve kurumsal hesaplarda Federasyon. Ayrıca, Azure AD B2C 
minimal yapılandırma ile çok faktörlü kimlik doğrulaması sağlar. 


TIP 

Azure Active Directory (Azure AD) ve Azure AD B2C olan ayrı bir ürün teklifleri. Azure AD kiracısı, Azure AD B2C kiracısı ile 
bağlı olan taraf uygulamaları kullanılacak kimlikleri koleksiyonunu temsil ederken, bir kuruluşun temsil eder. Daha fazla bilgi 
için bkz: Azure AD B2C: Sık sorulan sorular (SSS). 


Bu öğreticide, bilgi nasıl yapılır: 

• Azure Active Directory B2C kiracısı oluşturma 

• Azure AD B2C'de bir uygulamayı kaydetme 

• Kimlik doğrulaması için Azure AD B2C kiracınızı kullanacak şekilde yapılandırılmış bir ASP.NET Core web 
uygulaması oluşturmak için Visual Studio'yu kullanın. 

• Azure AD B2C kiracısı davranışını denetleme ilkelerini yapılandırma 

Önkoşullar 

Bu kılavuz için aşağıdakiler gereklidir: 

• Microsoft Azure aboneliği 

• Visual Studio 2019 

Azure Active Directory B2C kiracısı oluşturma 

Bir Azure Active Directory B2C kiracısı oluşturmayı belgelerinde açıklanan şekilde, istendiğinde, Kiracı bir Azure 
aboneliğiyle ilişkilendirme Bu öğretici için isteğe bağlıdır. 

Azure AD B2C'de uygulamayı kaydetme 

Kullanıp uygulamanızın yeni oluşturulan Azure AD B2C kiracısında kaydetme belgelerindeki adımları altında bir 

web uygulaması kaydetme bölümü. Adresindeki Durdur web uygulama gizli anahtarı oluşturma bölümü. 
Bir istemci parolası, Bu öğretici için gerekli değildir. 

Aşağıdaki değerleri kullanın: 


AYAR 

DEĞER 

NOTLAR 

Ad 

< Uygulama adı > 

Girin bir adı uygulamanızı müşterilere 



açıklayan bir uygulama için. 






AYAR 


DEĞER 


NOTLAR 


/ Web API'si Web uygulaması Ekle 

Evet 


Örtük akışa izin ver 

Evet 


Yanıt URL'si 

https://localhost:44300/signin- 
oidc 

Yanıt URL'leri, Azure AD B2C, 
uygulamanız tarafından istenen 
belirteçleri döndürdüğü uç noktalardır. 
Visual Studio kullanmak için bu yanıt 
URL'si sağlar. Şimdilik girin 

https://localhost:44300/signin- 
oldc 

formu doldurun. 

Uygulama Kimliği URl'si 

Boş bırakın 

Bu öğretici için gerekli değildir. 

Yerel istemci Ekle 

Hayır 
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Localhost olmayan yanıt URL'si ayarı farkında olmanız durumunda yanıt URL'si listede izin verilen üzerindeki kısıtlamaları. 


Uygulama kaydedildikten sonra kiracıdaki uygulamalar listesinde görüntülenir. Yalnızca kayıtlı uygulamayı seçin. 
Seçin kopyalama simgesinin sağındaki uygulama kimliği panoya kopyalamak için alana. 

Hiçbir şey daha şu anda Azure AD B2C kiracısında yapılandırılabilir, ancak tarayıcı penceresini açık bırakın. 
ASP.NET Core uygulaması oluşturduktan sonra daha fazla yapılandırma yoktur. 

Visual Studio'da ASP.NET Core uygulaması oluşturma 

Visual Studio Web uygulama şablonu, kimlik doğrulaması için Azure AD B2C kiracınızı kullanacak şekilde 
yapılandırılabilir. 

Visual Studio'da: 

1. Yeni bir ASP.NET Core Web uygulaması oluşturun. 

2. Seçin Web uygulaması şablonları listesinden. 


3. Seçin kimlik doğrulamayı Değiştir düğmesi. 






New ASP.NET Core Web Application - AspNetStuff 


X 


.NET Core 

* | ASP.NET Core 2.1 

v Learn more 


sn 

[^] 


S 

âî 

A project template for creating an ASP.NET Core 
application with example ASP.NET Core Razor Pages 
content. 

Empty 

API 

Web 

Application 

Web 

Application 

(Model-Vievv- 

Controller) 

Razor Class 

Library 

Learn more 

® 

Angular 

«S» 

React.js 

# 

React.js and 
Redux 



Authon Microsoft 

Source: SDK 2.1.401 


I I Enable Docker Support 

OS: Windows 

Requires Docker for Windows 

Docker support can also be enabled later Learn more 

0 Configurefor HTTPS 


Authentication: No Authentication 


Change Authentication 


OK 


Cancel 


4. içinde kimlik doğrulamayı Değiştir iletişim kutusunda bireysel kullanıcı hesaplarıve ardından 
bulutta varolan bir kullanıcı deposuna bağlanın açılır. 



5. Formu aşağıdaki değerlerle izleyin: 

AYAR DEĞER 


Etki alanı adı 


<B2Ckiracınızın etki alanı adı> 


Uygulama Kimliği 


< Panodan uygulama Kimliğini yapıştırın > 
























































AYAR 


DEĞER 


Geri arama yolu 

< Varsayılan değeri kullanın> 

Kaydolma veya oturum açma ilkesi 

B2C_l_SiUpIn 

Parola sıfırlama İlkesi 

B2C_1_SSPR 

Profil ilkesini Düzenle 

< Boş bırakın > 


Seçin kopyalama yanındaki bağlantı yanıt URl'si yanıt URl'si panoya kopyalamak için. Seçin Tamam 
kapatmak için kimlik doğrulamayı Değiştir iletişim. Seçin Tamam web uygulaması oluşturma. 

B2C uygulaması kaydı tamamlamak 

B2C uygulaması özelliklerde hala açık tarayıcı penceresine dönün. Geçici değiştirme yanıt U RL'si belirtilen 
değere önceki Visual Studio'dan kopyalanır. Seçin Kaydet pencerenin üst kısmındaki. 


TIP 

Yanıt URL'si kopyalarsanız yaramadı web proje özelliklerinde hata ayıklama sekmesinden HTTPS adresi kullanın ve ekleme 
CalIbackPath değerini appsettings.jsorı. 


ilkeleri yapılandırma 

Adımlar için Azure AD B2C belgeleri kullanmak kaydolma veya oturum açma ilkesi oluşturmave ardından bir 
parola sıfırlama ilkesi oluşturma. Belgeler için sağlanan örnek değerleri kullanın kimlik sağlayıcıları, kaydolma 
özniteliklerini, ve uygulama taleplerini. Kullanarak Şimdi Çalıştır ilkeleri belgelerinde açıklanan şekilde test 
etmek için düğmeyi, isteğe bağlıdır. 


VVARNING 

ilke adları belgelerinde açıklandığı gibi tam olarak bu ilkeleri de kullanılan gibi emin kimlik doğrulamayı Değiştir Visual 
Studio'da iletişim kutusu. İlke adları içinde doğrulanabilir appsettings.json. 


Temel alınan OpenldConnectOptions/JvvtBearer/tanımlama bilgisi 
seçeneklerini yapılandırın 


Doğrudan temel alınan seçeneklerini yapılandırmak için uygun düzeni sabiti kullanın startup.configureservices 









Services.Configure<OpenIdConnectOptions>( 

AzureAD[B2C]Defaults.0penIdScheme, options => 

{ 

// Omitted for brevity 

}); 

Services.ConfigurecCookieAuthenticationOptions>( 
AzureAD[B2C]Defaults.CookieSchemej options => 

{ 

// Omitted for brevity 

}); 

Services.Configure<OwtBearerOptions>( 

AzureAD[B2C]Defaults.3wtBearerAuthenticationScheme, options => 
{ 

// Omitted for brevity 

}); 


Uygulamayı çalıştırma 

Visual Studio'da F5 oluşturun ve uygulamayı çalıştırın. Web uygulamasını başlattıktan sonra seçin kabul 
(istenirse) tanımlama bilgilerinin kullanımını kabul etmek ve ardından oturum. 



Azure AD B2C kiracısı için tarayıcı yeniden yönlendirir.(Bir ilkelerini sınama oluşturulduysa) var olan bir hesapla 
oturum oturum ya da seçin şimdi kaydolun yeni bir hesap oluşturmak için. Parolanızı mı unuttunuz? bağlantı 
unutulmuş parola sıfırlama için kullanılır. 











Başarıyla oturum açtıktan sonra tarayıcının, web uygulamasına yeniden yönlendirir. 


O *3 E3 Home page - AzureB2C X + v 

^ (_) O https:/ ; localhost:44394/ 


AzureB2CTutorial Home About Contact 


☆ 


- □ X 

i= L \Ğ ••• 


Hello Tutorial User! Sign out 


* Visual Studio 


There are povverful new features in Visual Studio 
for building modern web apps. 




Leam More 


o#o O 


Application uses 

• Sample pages using ASP.NET Core Razor Pages 

• Theming using Bootstrap 

How to 

• Working with Razor Pages. 

• Manage User Secrets using Secret Manager 

• Use logging to log a message 

• Add packages using NuGet. 


Sonraki adımlar 
































Bu öğreticide, şunların nasıl yapıldığını öğrendiniz: 

• AzureActive Directory B2C kiracısı oluşturma 

• Azure AD B2C'de bir uygulamayı kaydetme 

• Kimlik doğrulaması için Azure AD B2C kiracınızı kullanacak şekilde yapılandırılmış bir ASP.NET Core Web 
uygulaması oluşturmak için Visual Studio'yıı kullanın. 

• Azure AD B2C kiracısı davranışını denetleme ilkelerini yapılandırma 

ASP.NET Core uygulaması Azure AD B2C kimlik doğrulaması için kullanmak üzere yapılandırılmış göre 
Authorize özniteliği uygulamanızı güvenli hale getirmek için kullanılabilir. Öğrenme için uygulamanızı 
geliştirmeye devam edin: 

• Azure AD B2C’yi kullanıcı arabirimini özelleştirme. 

• Parola karmaşıklık gereksinimlerini yapılandırabilirsiniz. 

• Çok faktörlü kimlik doğrulamasını etkinleştirme. 

• Gibi ek kimlik sağlayıcılarını yapılandırma Microsoft, Facebook, Google, Amazon, Tvvitter ve diğerleri. 

• Azure AD Graph API'sini Azure AD B2C kiracısı grup üyeliği gibi ek kullanıcı bilgileri alınamıyor. 

• Bir ASP.NET Core web API'si Azure AD B2C kullanarak güvenli. 

• Azure AD B2C kullanarak .N ET web uygulamasından bir .NET web API'si çağırma. 


Web API ASPNET Core, Azure Active Directory B2C 
ile kimlik doğrulaması 

6.12.2019 • 15 minutes to read ı Edit Online 


Tarafından Cam Soper 

Azure Active Directory B2C (Azure AD B2C) olan bir bulut kimlik yönetimi çözümü, web ve mobil uygulamaları 
için. Hizmet, bulutta ve şirket içinde barındırılan uygulamalar için kimlik doğrulaması sağlar.Kimlik doğrulama 
türleri bireysel hesaplar, sosyal ağ hesabı, içerir ve kurumsal hesaplarda Federasyon. Azure AD B2C, ayrıca 
minimal yapılandırma ile çok faktörlü kimlik doğrulaması sağlar. 

Azure Active Directory (Azure AD) ve Azure AD B2C olan ayrı bir ürün teklifleri. Azure AD kiracısı, Azure AD B2C 
kiracısı ile bağlı olan taraf uygulamaları kullanılacak kimlikleri koleksiyonunu temsil ederken, bir kuruluşun temsil 
eder. Daha fazla bilgi için bkz. Azure AD B2C: sık sorulan sorular (SSS). 

Kullanıcı arabirimi olmadan Web API olduğundan, kullanıcı bir güvenli belirteç hizmeti gibi Azure AD B2C'yi 
yeniden yönlendirmek yüklenemiyor. Bunun yerine, API, bir taşıyıcı belirteç zaten Azure AD B2C ile kullanıcı 
kimliğini doğrulamasından çağıran uygulama üzerinden geçirilir. API, daha sonra doğrudan kullanıcı etkileşimi 
olmadan belirteci doğrular. 

Bu öğreticide, bilgi nasıl yapılır: 

• Azure Active Directory B2C kiracısı oluşturun. 

• Azure AD B2C'de Web API'si kaydetme. 

• Kimlik doğrulaması için Azure AD B2C kiracınızı kullanacak şekilde yapılandırılmış bir Web API'si oluşturmak 
için Visual Studio'yu kullanın. 

• Azure AD B2C kiracısı davranışını denetleyen ilkeler yapılandırın. 

• Bir oturum açma iletişim sunan bir vveb uygulaması benzetimini yapmak için kullanım Postman bir belirteç alır 
ve bir vveb API isteği yapmak için kullanır. 

Prerequisites 

Bu kılavuz için aşağıdakiler gereklidir: 

• Microsoft Azure aboneliği 

• Visual Studio 2019 

• Postman 

Azure Active Directory B2C kiracısı oluşturma 

Bir Azure AD B2C kiracısı oluşturmayı belgelerinde açıklanan şekilde, istendiğinde, Kiracı bir Azure aboneliğiyle 
ilişkilendirme Bu öğretici için isteğe bağlıdır. 

Kaydolma veya oturum açma ilkesi yapılandırma 

Adımlar için Azure AD B2C belgeleri kullanmak kaydolma veya oturum açma ilkesi oluşturma, ilke adı Sillpln. 
Belgeler için sağlanan örnek değerleri kullanın kimlik sağlayıcıları, kaydolma özniteliklerini, ve uygulama 

taleplerini. Kullanarak Şimdi Çalıştır belgelerinde açıklanan ilkeyi test etmek için düğmeyi, isteğe bağlıdır. 


Azure AD B2C'de API 'sini kaydetme 




API'yi kullanarak yeni oluşturulan Azure AD B2C kiracısında kaydetme belgelerindeki adımları altında web API'si 
kaydetme bölümü. 

Aşağıdaki değerleri kullanın: 


AYAR 

DEĞER 

NOTLAR 

Ad 

(API adt} 

Girin bir adı uygulamanızı müşterilere 
açıklayan bir uygulama için. 

/ Web API'si Web uygulaması Ekle 

Evet 


Örtük akışa izin ver 

Evet 


Yanıt URL'si 

https://localhost 

Yanıt URL'leri, Azure AD B2C, 
uygulamanız tarafından istenen 
belirteçleri döndürdüğü uç noktalardır. 

Uygulama Kimliği URl'si 

API 

URI, bir fiziksel adresine gerekmez. 

Yalnızca benzersiz olması gerekir. 

Yerel istemci Ekle 

Hayır 



API kaydedildikten sonra Kiracı uygulamaları ve API'leri listesinde görüntülenir.Daha önce kaydedilen API'yi 
seçin. Seçin kopyalama simgesinin sağındaki uygulama kimliği panoya kopyalamak için alana. Seçin 
yayımlanan kapsamlar ve varsayılan doğrulama userjmpersonat'ıon kapsam. 

Visual Studio 'da ASP.NET Core uygulaması oluşturma 

Visual Studio Web uygulama şablonu, kimlik doğrulaması için Azure AD B2C kiracınızı kullanacak şekilde 
yapılandırılabilir. 

Visual Studio'da: 

1. Yeni bir ASP.NET Core Web uygulaması oluşturun. 

2. Seçin Web API şablonları listesinden. 


3. Seçin kimlik doğrulamayı Değiştir düğmesi. 



New ASP.NET Core Web Application - AzureAdB2CWebApi 


X 


■NET Core 

ASP.NET Core 2.0 



Learn more 


n 

0 



o 

Empty 

Web API 

Web 

Application 

Web 

Application 

(Model-Vievv- 

Controller) 

Angular 

<$£> 

LXJ 

# 




React.js 

React.js and 
Redux 





I I Enable Docker Support 

OS: Windows 

Requires Docker for Windows 

Docker support can also be enabled later Learn more 


A project template for creating an ASP.NET Core 
application with an example Controller for a RESTful 
HTTP service. This template can also be used for 
ASP.NET Core MVC Views and Controllers. 

Learn more 


Change Authentication 


Authentication No Authentication 


b 


OK Cancel 


4. içinde kimlik doğrulamayı Değiştir iletişim kutusunda bireysel kullanıcı hesapları > bulutta varolan 
bir kullanıcı deposuna bağlanın. 



5. Formu aşağıdaki değerlerle izleyin: 

AYAR DEĞER 

Etki alanı adı {B2C kiracıruzırı etki atam adi} 

Uygulama Kimliği {Panodan uygulama Kimliğini yapiştinn} 

Kaydolma veya oturum açma ilkesi B2c_1_siupın 

Seçin Tamam kapatmak için kimlik doğrulamayı Değiştir iletişim. Seçin Tamam web uygulaması 
oluşturma. 

Visual Studio, web API'si adlı bir denetleyiciyle oluşturur ValuesController.es GET istekleri için sabit kodlu değer 
döndürür. Sınıfı Yetkilendir özniteliğiyle işaretlenir, bu nedenle tüm istekler kimlik doğrulaması gerektirir. 






















































Web API'sini çalıştırma 

Visual Studio'da API çalıştırın. Visual Studio API'nin kök URL'de işaret eden bir tarayıcı başlatır.Adres 
çubuğundaki URL'yi not edin ve arka planda çalışan API bırakın. 


NOTE 

Tarayıcı, kök URL'si için tanımlanan denetleyicisi olmaması olduğundan, 404 (bulunamadı sayfası) hatası gösteriyor olabilir. Bu 
beklenen bir davranıştır. 


API 'yi test etme ve bir belirteç almak için Postman'ı kullanın 

Postman olduğunu test etmek için bir aracı vveb API'leri. Bu öğretici için kullanıcının adına web API'sine erişen bir 
vveb uygulaması Postman benzetimini yapar. 

Postman vveb uygulaması kaydetme 

Azure AD B2C kiracısından belirteç alır bir vveb uygulaması Postman benzetim olduğundan, bir vveb uygulaması 
olarak kiracıda kaydedilmelidir. Postman kullanarak kayıt belgelerindeki adımları altında bir vveb uygulaması 
kaydetme bölümü. Adresindeki Durdur vveb uygulama gizli anahtarı oluşturma bölümü. Bir istemci parolası, 
Bu öğretici için gerekli değildir. 

Aşağıdaki değerleri kullanın: 


AYAR 

DEĞER 

NOTLAR 

Ad 

Postman 


/ Web API'si Web uygulaması Ekle 

Evet 


Örtük akışa izin ver 

Evet 


Yanıt URL'si 

https://getpostman.com/postman 


Uygulama Kimliği URl'si 

{boş bırakın) 

Bu öğretici için gerekli değildir. 

Yerel istemci Ekle 

Hayır 



Yeni kaydettiğiniz vveb uygulaması, kullanıcının adına vveb API'sine erişim izni gerekir. 

1. Seçin Postman uygulamaları ve ardından listesinde API erişimi sol taraftaki menüden. 

2. + Ekle öğesini seçin. 

3. içinde API seçin açılır listesinde, vveb API'si adını seçin. 

4. içinde kapsamları seçin açılır listesinde, tüm kapsamlar seçili emin olun. 

5. Tamam ı seçin. 

Taşıyıcı belirteç almak için gerekli Postman uygulamanın uygulama Kimliğini not alın. 

Postman isteği oluştur 

Postman'ı başlatın. Varsayılan olarak, Postman görüntüler Yeni Oluştur başlatma sırasında iletişim, iletişim 
kutusunda görüntülenmediğinde seçin + yeni sol üst tarafında düğmesi. 

Gelen Yeni Oluştur iletişim: 


1. Seçin istek. 





2. Girin değerleri alma içinde istek adı kutusu. 

3. Seçin + koleksiyon Oluştur istek depolamak için yeni bir koleksiyon oluşturmak için. Koleksiyonu 
adlandırın ASP.NET Core öğreticilerini ve ardından onay işaretini seçin. 














SAVE REQUEST 


Requests in Postman are saved in collections (a group of requests). 
Leam more about creating collections 

Reguesc name _ 


Get Values 


Request description (Optional) 


Select a collection orfolder to save to: 


Ali Collections 


ASP.NET Core tutorials) 


ASP.NET Core tutorials 
Postman Echo 


+ Create Collection 


Cancel 


4. Seçin kaydetmek için ASP.N ET Core öğreticilerini düğmesi. 

Kimlik doğrulaması olmadan web API'sini test etme 

Web API'si kimlik doğrulaması gerektiren doğrulamak için ilk kimlik doğrulaması olmadan bir istek olun. 

1. içinde istek URL'sini girin kutusunda, URL girin valuesControiler . URL ile bir tarayıcıda görüntülenen 
aynıdır API/değerleri eklenir. Örneğin: https://iocaihost:44375/api/vaiues . 

2. Seçin Gönder düğmesi. 

3. Yanıt durumu Not 407 Yetkisiz. 

























IMPORTANT 

"Herhangi bir yanıt alınamadı" hatası alırsanız, Postman AYARLARıNDAKISSL sertifikası doğrulamasını devre dışı bırakmanız 
gerekebilir. 


Taşıyıcı belirteç edinme 

Web API'sine kimliği doğrulanmış bir isteği yapmak için bir taşıyıcı belirteç gereklidir. Postman, Azure AD B2C 
kiracısı için oturum açın ve bir belirteç almak kolaylaştırır. 


1. Üzerinde yetkilendirme sekmesinde türü açılır menüsünde, select OAuth 2.0. içinde eklemek için 
yetkilendirme verileri açılır menüsünde, select istek üstbilgileri. Seçin yeni erişim belirteci alın. 


Authorization • Headers (1) 


Pre-request Script 


Cookıes Code 


TYPE 


OAuth 2.0 

V 


Access Token 


The authorization data vvill be 
automatically generated when you 
send the request. Leam more about 
authorization 


Add authorization data to 


Request Headers 

V 


Previevv Request 


Access Token Available Tokens v 


Get New Access Token 




2. Tamamlamak yeni erişim BELİRTECİ Al aşağıdaki gibi iletişim: 

AYAR DEĞER NOTLAR 

Belirteç adı {belirteç adı) Belirteç için açıklayıcı bir ad girin. 

İzin verme türü Örtük 


Geri çağırma URL'si 


https://getpostman.com/postman 


Kimlik doğrulama URL'si https ://login.microsoftonline.com/{titeğiştirin {Kiracı etki alanı adı} 

domain name}/oauth2/v2.0/authorize? kiraclnln e tkİ alanı adına sahip. 
p=B2C_l_SillpIn » 

Önemli: Bu URL içinde bulunan 
olmalıdır 
Web 

API'SİNİN appsettings.jsorı dosya. 
Bkz. Not+. 


olarak aynı etki alanı adı 
AzureAdB2C.Instance 


İstemci kimliği 


{Postman uygulamama girin 

uygulama kimliği} 


Kapsam 


https://{tenant domain 
name}/{api}/user_impersonation 
openid offline_access 


Değiştirin (Kiracı etki alanı adı} 
kiracının etki alanı adına sahip. 

Değiştirin {API} ilk kaydettiğinizde 
uygulama kimliği URl'si ile web API'si 
verdiğiniz (Bu durumda, api ). URL 
için Desen: 

https://{tenant}.onmicrosoft.com/{api- 
id-uri}/{scope name} 
























AYAR 


DEĞER 


NOTLAR 


State {boş bırakın) 

İstemci kimlik doğrulaması istemci kimlik bilgileri gövdesinde 

Gönder 


NOTE 

t Azure Active Directory B2C Portalı'nda ilke ayarları iletişim iki olası URL'lerini görüntüler: bir biçimde 
https://login.microsoftonline.com/ {Kiracı etki alanı adı} / {ek yol bilgileri) ve diğer biçimde 
https://{tenant name}. b 2 clogin. com/ {Kiracı etki alanı adı} / {ek yol bilgileri}. Sahip kritik etki alanı içinde bulunan 
Azure Ad B 2 C.instance Web API'SİNİN appsettings.json dosya web uygulama kullandığınızla eşleştiğinden 
appsettings.json dosya. Postman kimlik doğrulama URL'si alanında için kullanılan aynı etki alanında budur.Visual 
Studio portalında görüntülenen değerinden biraz daha farklı bir URL biçimi kullandığına dikkat edin. Etki alanları aynı 
olduğu sürece, URL çalışır. 


3. Seçin isteği belirteci düğmesi. 

4. Postman, Azure AD B2C kiracısının oturum açma iletişim kutusu içeren yeni bir pencere açılır.(Bir ilkelerini 
sınama oluşturulduysa) var olan bir hesapla oturum oturum ya da seçin şimdi kaydolun yeni bir hesap 
oluşturmak için. Parolanızı mı unuttunuz? bağlantı unutulmuş parola sıfırlama için kullanılır. 

5. Başarıyla oturum açtıktan sonra pencereyi kapatır ve yönetme erişim BELİRTEÇLERİ iletişim kutusu 
görüntülenir. Ekranı seçin ve altındaki aşağı kaydırarak kullanım belirteci düğmesi. 



Kimlik doğrulaması ile web API'sini test etme 

Seçin Gönder düğmesini isteği yeniden gönderin. Bu kez, yanıt durumu olan 200 Tamam JSON yükü yanıtta 
görünür ve gövdesi sekmesi. 


Body Cookies Header 

(6) Test Results 

Status: 200 OK 

Time: 111 ms Size: 287 B 

Pretry Raw Preview 

json v r5 

[Q Q Save Response 

11 t 

2 "valuel", 

"value2” 

4 ] 























Sonraki adımlar 

Bu öğreticide, şunların nasıl yapıldığını öğrendiniz: 

• AzureActive Directory B2C kiracısı oluşturun. 

• Azure AD B2C'de Web API'si kaydetme. 

• Kimlik doğrulaması için Azure AD B2C kiracınızı kullanacak şekilde yapılandırılmış bir Web API'si oluşturmak 
için Visual Studio'yu kullanın. 

• Azure AD B2C kiracısı davranışını denetleyen ilkeler yapılandırın. 

• Bir oturum açma iletişim sunan bir web uygulaması benzetimini yapmak için kullanım Postman bir belirteç alır 
ve bir web API isteği yapmak için kullanır. 

Öğrenme için API'nizi geliştirmeye devam edin: 

• Bir ASP.NET Core web uygulamasını Azure AD B2C kullanarak güvenli. 

• Azure AD B2C kullanarak .NET vveb uygulamasından bir .NET web API'si çağırma. 

• Azure AD B2C'yi kullanıcı arabirimini özelleştirme. 

• Parola karmaşıklık gereksinimlerini yapılandırabilirsiniz. 

• Çok faktörlü kimlik doğrulamasını etkinleştirme. 

• Gibi ek kimlik sağlayıcılarını yapılandırma Microsoft, Facebook, Google, Amazon, Tvvitter ve diğerleri. 

• Azure AD Graph API'sini Azure AD B2C kiracısı grup üyeliği gibi ek kullanıcı bilgileri alınamıyor. 


Bireysel kullanıcı hesaplarıyla oluşturulan ASRNET 
Core projelerine dayalı makaleler 
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ASP.NET Core kimlik, Visual Studio 'daki proje şablonlarına "bireysel kullanıcı hesapları" seçeneği ile dahildir. 
Kimlik doğrulama şablonları -au individual ile.NET CoreCLI kullanılabilir: 

dotnet new mvc -au individual 
dotnet new webapp -au individual 


dotnet new mvc -au individual 
dotnet new razor -au individual 

Web API kimlik doğrulaması için Bu GitHub sorununa bakın. 

Kimlik doğrulaması yok 

Kimlik doğrulaması, .N ET Core CLI -au seçeneği ile belirtilir. Visual Studio 'da kimlik doğrulaması Değiştir 
iletişim kutusu yeni Web uygulamaları için kullanılabilir. Visual Studio 'da yeni Web uygulamaları için varsayılan 
değer kimlik doğrulamasıdeğildir. 

Kimlik doğrulaması olmadan oluşturulan projeler: 

• Oturum açmak ve oturumu kapatmak için Web sayfalarını ve Kullanıcı arabirimini bulundurmayın. 

• Kimlik doğrulama kodu içermiyor. 

Windows Kimlik Doğrulaması 

-au windows seçeneğiyle .NET Core CLI yeni Web uygulamaları için VVİndovvs kimlik doğrulaması belirtilir. Visual 
Studio da kimlik doğrulaması Değiştir İletişim kutusu VVİndovvs kimlik doğrulama seçeneklerini sağlar. 

VVİndovvs kimlik doğrulaması seçilirse, uygulama VVİndovvs kimlik doğrulama 11S modülünükullanacak şekilde 
yapılandırılır. VVİndovvs kimlik doğrulaması, Intranet vveb sitelerine yöneliktir. 

Ek kaynaklar 

Aşağıdaki makalelerde, bireysel kullanıcı hesapları kullanan ASP.NET Core şablonlarda oluşturulan kodun nasıl 
kullanılacağı gösterilmektedir: 

• AS P.N ET Core hesap onaylama ve parola kurtarma 

• Yetkilendirme ile korunan kullanıcı verileriyle ASP.NET Core uygulama oluşturma 







ASPNET Core sertifika kimlik doğrulamasını 
yapılandırma 
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Microsoft.AspNetcore.Authentication.certificate , ASP.NET Core için sertifika kimlik doğrulamasına benzer bir 
uygulama içerir. Sertifika kimlik doğrulaması TLS düzeyinde gerçekleşir ve bu süre ASP.NET Core. Daha doğru, 
bu, sertifikayı doğrulayan bir kimlik doğrulama işleyicisidir ve bu sertifikayı bir ciaimsPrincipai 
çözümleyebileceğiniz bir olay verir. 

Ana bilgisayarınızı sertifika kimlik doğrulaması için yapılandırın, BT 11S, Kestrel, Azure Web Apps veya 
kullandığınız başka herhangi bir şeydir. 

Proxy ve yük dengeleyici senaryoları 

Sertifika kimlik doğrulaması, genellikle bir ara sunucu veya yük dengeleyicinin istemciler ve sunucular arasındaki 
trafiği işleyememesi durumunda kullanılan, durum bilgisi olan bir senaryodur Bir ara sunucu veya yük 
dengeleyici kullanılıyorsa, sertifika kimlik doğrulaması yalnızca proxy veya yük dengeleyici için geçerlidir: 

• Kimlik doğrulamasını işler. 

• Kullanıcı kimlik doğrulama bilgilerini uygulamaya geçirir (örneğin, bir istek üstbilgisinde), kimlik doğrulama 
bilgileri üzerinde davranır. 

Proxy 'lerin ve yük dengeleyicilerin kullanıldığı ortamlarda sertifika kimlik doğrulamasına alternatif olarak, 

Öpeni D Connect (OıDC) ile Federasyon Hizmetleri (ADFS) Active Directory. 

Kullanmaya başlayın 

Bir HTTPS sertifikası alın, uygulayın ve ana bilgisayarınızı sertifika gerektirecek şekilde yapılandırın. 

Web uygulamanızda Microsoft.AspNetcore.Authentication.certificate paketine bir başvuru ekleyin. Daha sonra 
Startup.ConfigureServices yönteminde, 

Services.AddAuthentication(CertificateAuthenticationDefaults.AuthenticationScheme).AddCertificate(...); , 
isteklerle gönderilen istemci sertifikası üzerinde herhangi bir ek doğrulama yapmak üzere 
onCertificateVaüdated için bir temsilci sağlayarak seçeneklerinizi çağırın. Bu bilgileri bir ciaimsPrincipai açın 
ve context.Principal özelliğinde ayarlayın. 

Kimlik doğrulaması başarısız olursa, bu işleyici, bekleneceğiniz gibi bir 401 (Unauthorized) yerine 
403 (Forbidden) yanıtı döndürür. Bu durum, kimlik doğrulamanın ilk TLS bağlantısı sırasında gerçekleşme 
nedendir. İşleyiciye ulaştığında, çok geç olur. Anonim bir bağlantıyla bir sertifikayla bir bağlantıyı yükseltmenin bir 
yolu yoktur. 


Startup.Configure 

yöntemine 

app.UseAuthentication(); 

ekleyin. Aksi takdirde 

HttpContext.User , 


sertifikadan oluşturulan ciaimsPrincipai olarak ayarlanmayacak. Örneğin: 















public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddAuthentication( 

CertificateAuthenticationDefaults.AuthenticationScheme) 

.AddCertificate(); 

// Ali the other service configuration. 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

app.UseAuthentication(); 

// Ali the other app configuration. 

} 

Önceki örnekte sertifika kimlik doğrulaması eklemenin varsayılan yolu gösterilmektedir. İşleyici, ortak sertifika 
özelliklerini kullanarak bir Kullanıcı sorumlusu oluşturur. 

Sertifika doğrulamasını yapılandırma 

certificateAuthenticationOptions işleyicisinde, bir sertifikada gerçekleştirmeniz gereken en düşük doğrulamalar 
olan yerleşik doğrulamalar vardır. Bu ayarların her biri varsayılan olarak etkindir. 

AllovvedCertificateTypes = zincirleme, SelfSigned veya Ali (zincirleme | SelfSigned) 

Bu denetim yalnızca uygun sertifika türüne izin verildiğini doğrular. 

ValidateCertificateUse 

Bu denetim, istemci tarafından sunulan sertifikanın İstemci kimlik doğrulaması genişletilmiş anahtar kullanımı 
(EKU) olduğunu veya hiç EKU olmadığını doğrular. Belirtimlerde bir EKU belirtilmemişse, tüm EKU 1ar geçerli 
kabul edilir. 

ValidateValidityPeriod 

Bu denetim, sertifikanın geçerlilik süresi içinde olduğunu doğrular. Her istekte işleyici, geçerli oturumu sırasında 
sunulmadığı zaman geçerli olmayan bir sertifikanın süresinin dolmamasını sağlar. 

Revocationbayrağı 

Zincirdeki hangi sertifikaların iptal için denetleneceğini belirten bayrak. 

iptal denetimleri yalnızca sertifika bir kök sertifikaya zincirleme yapıldığında gerçekleştirilir. 

Revocationmodu 

iptal denetimlerinin nasıl gerçekleştirileceğini belirten bayrak. 

Bir çevrimiçi denetim belirtildiğinde, sertifika yetkilisi ile bağlantı kurulduğunda uzun bir gecikmeyle 
sonuçlanabilir. 

iptal denetimleri yalnızca sertifika bir kök sertifikaya zincirleme yapıldığında gerçekleştirilir. 

Uygulamamı yalnızca belirli yollarda sertifika gerektirecek şekilde yapılandırabilir miyim? 

Bu mümkün değildir.Sertifika değişimi 'nin HTTPS konuşması başlangıcı olduğunu unutmayın, bu bağlantı 
üzerinde ilk istek alınmadan önce sunucu tarafından gerçekleştirilir, böylece herhangi bir istek alanı temelinde 
kapsam yapılamaz. 

İşleyici olayları 

İşleyicinin iki olayı vardır: 


OnAuthenticationFailed 


-, kimlik doğrulaması sırasında bir özel durum oluşursa çağrılır ve yanıt vermenize 






olanak tanır. 


• Sertifika doğrulandıktan sonra OnCertificatevalidated - çağrıldı, doğrulama geçildi ve bir varsayılan asıl 
oluşturulur. Bu olay kendi doğrulamayı gerçekleştirmenize ve sorumluyu artırabilir veya değiştirmenize olanak 
sağlar. Örnekler için şunları içerir: 

o Sertifikanın hizmetlerinize göre bilinip tanınmadığını belirleme. 

o Kendi sorumlunuzu oluşturma, startup.configureservices içinde aşağıdaki örneği göz önünde 
bulundurun: 


Services.AddAuthentication( 

CertificateAuthenticationDefaults. Aut hent icat ionScheme) 

.AddCertificate(options => 

{ 

options.Events = new CertificateAuthenticationEvents 

{ 

OnCertificatevalidated = context => 

{ 

var claims = new[] 

{ 

new Claim( 

ClaimTypes.Nameldentifier, 
context.ClientCertificate.Subject, 

ClaimValueTypes.String, 
context.Options.Claimslssuer), 
new Claim(ClaimTypes.Name, 

context.ClientCertificate.Subjectj 
ClaimValueTypes.String, 
context.Options.Claimslssuer) 

}; 

context.Principal = new ClaimsPrincipal( 

new Claimsldentity(claims, context.Scheme.Name)); 
context.Success(); 

return Task.CompletedTask; 

} 

}; 

}); 

Gelen sertifikayı, ek doğrulamadan uymadığını fark ederseniz bir hata nedeniyle context.Faii("faiiure reason") 
çağırın. 

Gerçek işlevsellik için muhtemelen bir veritabanına veya diğer Kullanıcı Mağazası türüne bağlanan bağımlılık 
ekleme bölümünde kayıtlı bir hizmeti çağırmak isteyeceksiniz. Temsilciniz 'e geçirilen bağlamı kullanarak 
hizmetinize erişin, startup.configureservices içinde aşağıdaki örneği göz önünde bulundurun: 








Services.AddAuthentication( 

CertificateAuthenticationDefaults. Aut hent icat ionScheme) 

.AddCertificate(options => 

{ 

options.Events = new CertificateAuthenticationEvents 

{ 

OnCertificateValidated = context => 

{ 

var validationService = 

context.HttpContext.RequestServices 

.GetService<ICertificateValidationService>(); 

if (validationService.ValidateCertificate( 
context.ClientCertificate)) 

{ 

var claims = new[] 

{ 

new Claim( 

ClaimTypes.Nameldentifier, 
context.ClientCertificate.Subjectj 
ClaimValueTypes.String, 
context.Options.Claimslssuer), 
new Claim( 

ClaimTypes.Name, 

context.ClientCertificate.Subjectj 
ClaimValueTypes.Stringj 
context.Options.Claimslssuer) 

}; 

context.Principal = new ClaimsPrincipal( 

new ClaimsIdentity(claimSj context.Scheme.Name)); 
context.Success(); 

} 

return Task.CompletedTask; 

} 

}; 

}); 

Kavramsal olarak, sertifikanın doğrulanması bir yetkilendirme konusudur. OnCertificateValidated içinde değil, 
yetkilendirme ilkesindeki bir veren veya parmak izi gibi bir denetim eklemek, kusursuz kabul edilebilir. 

Ana bilgisayarınızı sertifika gerektirecek şekilde yapılandırma 

Kestrel 

Program.es' de, Kestrel 1 yi aşağıdaki şekilde yapılandırın: 




public static void Main(string[] args) 

{ 

CreateHostBuilder(args).Build().Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) 

{ 

return Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 
webBuilder.ConfigureKestrel(o => 

{ 

o.ConfigureHttpsDefaults(o => 
o.ClientCertificateMode = 

ClientCertificateMode.RequireCertificate); 

}); 

}); 

} 


NOTE 

Listen çağrılmadan oluşturulan bitiş noktaları, ConfigureHttpsDefaults çağrılmadan önce , varsayılan olarak uygulanmaz. 


IIS 

11S Yöneticisi 'nde aşağıdaki adımları uygulayın: 

1 . Bağlantılar sekmesinden sitenizi seçin. 

2. Özellikler Görünümü penceresinde SSL ayarları seçeneğine çift tıklayın. 

3. SSL gerektir onay kutusunu İşaretleyin ve istemci sertifikaları bölümünde radyo iste düğmesini seçin. 

SSLSettings 

This page letsyou modify the SSL settingsforthe content of a vvebsite or application. 

0 Require SSL 

Client certificates: 

O Ignore 
O Accept 
® Reguire 


Azure ve özel Web proxy 'leri 

Sertifika iletme ara yazılımını yapılandırma hakkında bilgi için bkz. konak ve dağıtım belgeleri . 

Azure Web Apps sertifika kimlik doğrulamasını kullanma 

AddCertificateForwarding yöntemi şunu belirtmek için kullanılır: 

• istemci üst bilgi adı. 

• Sertifika nasıl yüklenir ( HeaderConverter özelliği kullanılarak). 

Azure Web Apps, sertifika, x-ARR-ciientcert adlı özel bir istek üst bilgisi olarak geçirilir. Bunu kullanmak için 
startup.configureServices sertifika iletmeyi yapılandırın: 







public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddCertificateForwarding(options => 

{ 

options.CertificateHeader = "X-ARR-ClientCert"; 
options.HeaderConverter = (headerValue) => 

{ 

X509Certificate2 clientCertificate = null; 

if(!string.IsNullOrWhiteSpace(headerValue)) 

{ 

byte[] bytes = StringToByteArray(headerValue); 
clientCertificate = new X509Certificate2(bytes); 

} 

return clientCertificate; 

}; 

}); 

} 

private static byte[] StringToByteArray(string hex) 

{ 

int NumberChars = hex.Length; 

byte[] bytes = new byte[NumberChars / 2]; 

for (int i = 0; i < NumberChars; i += 2) 

{ 

bytes[i / 2] = Convert.ToByte(hex.Substring(i J 2 ), 16); 

} 

return bytes; 

} 

Startup.Configure yöntemi daha sonra ara yazılımı ekler. UseCertificateForwarding , UseAuthentication ve 
useAuthorization çağrılarından önce çağrılır: 

public void Configure(IApplicationBuilder app, IVJebHostEnvironment env) 

{ 


app.UseRouting(); 

app.UseCertificateForwarding(); 
app.UseAuthentication(); 
app.UseAuthorization(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapControllers(); 

}); 

} 

Ayrı bir sınıf, doğrulama mantığını uygulamak için kullanılabilir.Bu örnekte otomatik olarak imzalanan sertifika 
kullanıldığından, yalnızca sertifikanızın kullanılabildiğinden emin olun. İstemci sertifikasının ve sunucu 
sertifikasının parmak izlerinin eşleştiğinden emin olun, aksi takdirde herhangi bir sertifika kullanılabilir ve kimlik 
doğrulaması için yeterli olacaktır. Bu, AddCertificate yöntemi içinde kullanılacaktır. Ara veya alt sertifikalar 
kullanıyorsanız konuyu veya sertifikayı vereni de doğrulayabilirsiniz. 




using System.10; 

using System.Security.Cryptography,X509Certificates; 

namespace AspNetCoreCertificateAuthApi 

{ 

public class MyCertificateValidationService 

{ 

public bool ValidateCertificate(X509Certificate2 clientCertificate) 

{ 

// Do not hardcode passwords in production code 
// Use thumbpnint on key vault 
var cert = new X509Certificate2( 

Path.Combine("sts_dev_cert.pfx "), "1234"); 

if (clientCertificate.Thumbprint == cert.Thumbprint) 

{ 

return true; 

} 

return false; 

} 

} 

} 

Sertifika kullanarak bir HttpClient uygulama 

Web API istemcisi, bir iHttpciientFactory örneği kullanılarak oluşturulan bir HttpClient kullanır. Bu, HttpClient 
için bir işleyici tanımlamak için bir yol sağlamaz, bu nedenle sertifikayı x-ARR-ciientcert istek başlığına eklemek 
için bir HttpRequestMessage kullanın. Sertifika, GetRawCertDatastring yöntemi kullanılarak bir dize olarak eklenir. 








private async Task<3sonDocument> GetApiDataAsync() 

{ 

try 

{ 

// Do not hardcode passwords in production code 
// Use thumbprint on key vault 
var cert = new X509Certificate2( 

Path.Combine(_environment.ContentRootPath, 

"sts_dev_cent.pfx "), "1234"); 
var Client = _clientFactory.CreateClient(); 
var request = new HttpRequestMessage() 

{ 

RequestUri = new Uri("https://localhost:44379/api/values"), 

Method = HttpMethod.Get, 

}; 

request.Headers.Add("X-ARR-ClientCert ", cert.GetRawCertDataString()); 
var response = await Client.SendAsync(request); 

if (response.IsSuccessStatusCode) 

{ 

var responseContent = await response.Content.ReadAsStringAsync(); 
var data = DsonDocument.Parse(responseContent); 

return data; 

} 

throw new ApplicationException( 

$"Status code: {response.StatusCode}^ " + 

$"Error: {response.ReasonPhrase}"); 

} 

catch (Exception e) 

{ 

throw new ApplicationException($"Exception {e}"); 

} 

} 


Sunucuya doğru sertifika gönderiliyorsa, veriler döndürülür. Sertifika yoksa veya yanlış sertifika gönderilmezse 
bir HTTP 403 durum kodu döndürülür. 

PovverShell 'de sertifika oluşturma 

Sertifikaların oluşturulması, bu akışı ayarlamanın en zor bölümüdür. Bir kök sertifika New-seifSignedCertificate 
PovverShell cmdlet 'i kullanılarak oluşturulabilir. Sertifikayı oluştururken güçlü bir parola kullanın. 
KeyusageProperty parametresini ve Keyusage parametresini gösterildiği gibi eklemek önemlidir. 

Kök CA oluştur 

New-SelfSignedCertificate -DnsName "root_ca_dev_damienbod.com", "root_ca_dev_damienbod.com" - 
CertStoreLocation "cert:\LocalMachine\My" -NotAfter (Get-Date).AddYears(20) -FriendlyName 
"root_ca_dev_damienbod.com" -KeyusageProperty Ali -KeyUsage CertSign, CRLSign, DigitalSignature 

$mypwd = ConvertTo-SecureString -String "1234" -Force -AsPlainText 

Get-Childltem -Path cert:\localMachine\my\"The thumbprint..." | Export-PfxCertificate -FilePath 
C:\git\root_ca_dev_damienbod.pfx -Password $mypwd 

Export-Certificate -Cert cert:\localMachine\my\"The thumbprint..." -FilePath root_ca_dev_damienbod.crt 

Güvenilen köke yüklensin 

Kök sertifikanın ana bilgisayar sisteminizde güvenilir olması gerekir. Sertifika yetkilisi tarafından oluşturulmamış 
bir kök sertifikaya varsayılan olarak güvenilmez. Aşağıdaki bağlantıda bunun VVİndovvs 'da nasıl 
gerçekleştirebileceği açıklanmaktadır: 









https://social.msdn.microsoft.com/Forums/SqlServer/5ed1 19ef-1704-4be4-8a4f-ef11 de7c8f34/a-certificate- 
chain-processed-but-terminated-in-a-root-certificate-which-is-not-trusted-by-the 

Ara sertifika 

Artık kök sertifikadan bir ara sertifika oluşturulabilir. Bu, tüm kullanım durumları için gerekli değildir, ancak birçok 
sertifika oluşturmanız veya sertifika gruplarını etkinleştirmeniz veya devre dışı bırakmanız gerekebilir. Sertifikanın 
temel kısıtlamalarında yol uzunluğunu ayarlamak için TextExtension parametresi gereklidir. 

Ara sertifika daha sonra Windows ana bilgisayar sistemindeki güvenilen ara sertifikaya eklenebilir. 

$mypwd = ConvertTo-SecureString -String "1234" -Force -AsPlainText 

Şparentcert = ( Get-Childltem -Path cert:\LocalMachine\My\"The thumbprint of the root..." ) 

New-SelfSignedCertificate -certstorelocation cert: \localmachine\my -dnsname "intermediate_dev_damienbod.com" 
-Signer Şparentcert -NotAfter (Get-Date).AddYears(20) -FriendlyName "intermediate_dev_damienbod.com" - 
KeyUsageProperty Ali -KeyUsage CertSign., CRLSign, DigitalSignature -TextExtension @("2.5.29.19= 
{text}CA=l&pathlength=l") 

Get-Childltem -Path cert:\localMachine\my\"The thumbprint..." | Export-PfxCertificate -FilePath 
C:\git\AspNetCoreCertificateAuth\Certs\intermediate_dev_damienbod.pfx -Password $mypwd 

Export-Certificate -Cert cert:\localMachine\my\"The thumbprint..." -FilePath intermediate_dev_damienbod.crt 

Ara sertifikadan alt sertifika oluştur 

Ara sertifikadan bir alt sertifika oluşturulabilir. Bu, son varlıktır ve daha fazla alt sertifika oluşturmak zorunda 
değildir. 

Şparentcert = ( Get-Childltem -Path cert:\LocalMachine\My\"The thumbprint from the Intermediate 
certificate..." ) 

New-SelfSignedCertificate -certstorelocation cert: \localmachine\my -dnsname "child_a_dev_damienbod.com" - 
Signer Şparentcert -NotAfter (Get-Date).AddYears(20) -FriendlyName "child_a_dev_damienbod.com" 

$mypwd = ConvertTo-SecureString -String "1234" -Force -AsPlainText 

Get-Childltem -Path cert:\localMachine\my\"The thumbprint..." | Export-PfxCertificate -FilePath 
C:\git\AspNetCoreCertificateAuth\Certs\child_a_dev_damienbod.pfx -Password $mypwd 

Export-Certificate -Cert cert:\localMachine\my\"The thumbprint..." -FilePath child_a_dev_damienbod.crt 

Kök sertifikadan alt sertifika oluştur 

Kök sertifikadan doğrudan bir alt sertifika da oluşturulabilir. 

Jrootcert = ( Get-Childltem -Path cert:\LocalMachine\My\"The thumbprint from the root cert..." ) 

New-SelfSignedCertificate -certstorelocation cert: \localmachine\my -dnsname "child_a_dev_damienbod.com" - 
Signer Şrootcert -NotAfter (Get-Date).AddYears(20) -FriendlyName "child_a_dev_damienbod.com" 

$mypwd = ConvertTo-SecureString -String "1234" -Force -AsPlainText 

Get-Childltem -Path cert:\localMachine\my\"The thumbprint..." | Export-PfxCertificate -FilePath 
C:\git\AspNetCoreCertificateAuth\Certs\child_a_dev_damienbod.pfx -Password $mypwd 

Export-Certificate -Cert cert:\localMachine\my\"The thumbprint..." -FilePath child_a_dev_damienbod.crt 


Örnek kök-ara sertifika-sertifika 





$mypwdroot = ConvertTo-SecureString -String "1234" -Force -AsPlainText 
$mypwd = ConvertTo-SecureString -String "1234" -Force -AsPlainText 

New-SelfSignedCertificate -DnsName "root_ca_dev_damienbod.com"j "root_ca_dev_damienbod.com" - 
CertStoreLocation "cert: \LocalMachine\My" -NotAfter (Get-Date).AddYears(20) -FriendlyName 
"root_ca_dev_damienbod.com" -KeyUsageProperty Ali -KeyUsage CertSign^ CRLSign, DigitalSignature 

Get-Childltem -Path cert: \localMachine\my\0C89639E4E2998A93E423F919B36D4009A0F9991 | Export-PfxCertificate - 
FilePath C:\git\root_ca_dev_damienbod.pfx -Password $mypwdroot 

Export-Certificate -Cert cert: \localMachine\my\0C89639E4E2998A93E423F919B36D4009A0F9991 -FilePath 
root_ca_dev_damienbod.crt 

$rootcert = ( Get-Childltem -Path cert: \LocalMachine\My\0C89639E4E2998A93E423F919B36D4009A0F9991 ) 

New-SelfSignedCertificate -certstorelocation cert:\localmachine\my -dnsname "child_a_dev_damienbod.com" - 
Signer $rootcert -NotAfter (Get-Date).AddYears(20) -FriendlyName "child_a_dev_damienbod.com" - 
KeyUsageProperty Ali -KeyUsage CertSign., CRLSignj DigitalSignature -TextExtension @("2.5.29.19= 
{text}CA=l&pathlength=l") 

Get-Childltem -Path cert: \localMachine\my\BA9BF91ED35538A01375EFC212A2F46104B33A44 ] Export-PfxCertificate - 
FilePath C:\git\AspNetCoreCertificateAuth\Certs\child_a_dev_damienbod.pfx -Password $mypwd 

Export-Certificate -Cert cert: \localMachine\my\BA9BF91ED35538A01375EFC212A2F46104B33A44 -FilePath 
child_a_dev_damienbod.crt 

Jparentcert = ( Get-Childltem -Path cert: \LocalMachine\My\BA9BF91ED35538A01375EFC212A2F46104B33A44 ) 
New-SelfSignedCertificate -certstorelocation cert:\localmachine\my -dnsname 

"child_b_from_a_dev_damienbod.com" -Signer $parentcert -NotAfter (Get-Date).AddYears(20) -FriendlyName 
"child_b_from_a_dev_damienbod.com" 

Get-Childltem -Path cert: \localMachine\my\141594A0AE38CBBECED7AF680F7945CD51D8F28A | Export-PfxCertificate - 
FilePath C: \git\AspNetCoreCertificateAuth\Certs\child_b_from_a_dev_damienbod .pfx -Password $mypwd 

Export-Certificate -Cert cert: \localMachine\my\141594A0AE38CBBECED7AF680F7945CD51D8F28A -FilePath 
child b from a dev damienbod.crt 


Kök, ara veya alt sertifikalan kullanırken, sertifikalar, Parmak İzi veya PublicKey kullanılarak gerektiği şekilde 
doğrulanabilir. 



using System.Collections.Generic; 
using System.10; 

using System.Security.Cryptography.X509Certificates; 

namespace AspNetCoreCertificateAuthApi 

{ 

public class MyCertificateValidationService 

{ 

public bool ValidateCertificate(X509Certificate2 clientCertificate) 

{ 

return CheckIfThumbprintIsValid(clientCertificate); 

} 

private bool CheckIfThumbprintIsValid(X509Certificate2 clientCertificate) 

{ 

var listOfValidîhumbprints = new List<string> 

{ 

"141594A0AE38CBBECED7AF680F7945CD51D8F28A ", 
"0C89639E4E2998A93E423F919B36D4009A0F9991 ", 
"BA9BF91ED35538A01375EFC212A2F46104B33A44" 

}; 

if (listOfValidThumbprints.Contains(clientCertificate.Thumbprint)) 

{ 

return true; 

} 

return false; 

} 

} 

} 



ASPNET Core yetkilendirme giriş 

10.05.2019 • 2 minutes to read ı Edit Online 


Yetkilendirme ne belirleyen işleme başvuran bir kullanıcı işlemleri gerçekleştirebilirsiniz. Örneğin, bir belge 
kitaplığı oluşturma, belgelere ekleme, belgeleri düzenlemeye ve silmek için bir yönetici kullanıcı izin. Kitaplıkla 
çalışırken yönetici olmayan bir kullanıcı yalnızca belgeleri okumak için yetkili. 

Yetkilendirme, dikey ve kimlik doğrulaması'dan bağımsız gerçekleşir. Ancak, bir kimlik doğrulama mekanizması 
yetkilendirme gerektirir. Kimlik doğrulaması kullanan bir kullanıcıdır ascertaining işlemidir. Kimlik doğrulaması, 
geçerli kullanıcı için bir veya daha fazla kimlikleri oluşturabilir. 

Yetkilendirme türleri 

AS P.N ET Core yetkilendirme sağlayan basit, bildirim temelli rol ve zengin ilke tabanlı modeli. Yetkilendirme 
gereksinimleri ifade edilir ve işleyicileri bir kullanıcının talebi gereksinimleriyle karşılaştırarak değerlendirmek. 
Kesinlik temelli denetimleri basit ilkeleri veya kullanıcı kimliği ve kullanıcının erişmeye çalıştığı kaynak 
özelliklerini değerlendirmek ilkeleri temel alabilir. 


Ad Alanları 


Yetkilendirme bileşenlerine dahil AuthorizeAttribute ve AiiowAnonymousAttribute öznitelikleri içinde bulunan 
Microsoft.AspNetCore.Authorization ad alanı. 


Üzerinde belgelerine basit yetkilendirme. 







Kullanıcı verilerinin yetkilendirme tarafından 
korunduğu ile bir ASPNET Core uygulaması 
oluşturma 

26.11.2019 * 52 minutes to read ı Edit Online 


By Rick Anderson ve ali Audette 

ASP.NET Core MVC sürümü için Bu PDF 'ye bakın. Bu öğreticinin ASP.NET Core 1,1 sürümü Bu klasöründedir. 
1,1 ASP.NET Core örnek örnekleri. 

Bu PDF 'ye bakın 

Bu öğretici, kullanıcı verilerinin yetkilendirme tarafından korunduğu ile ASP.NET Core web uygulaması 
oluşturma işlemi gösterilmektedir. Kimlik doğrulaması (kayıtlı) kullanıcılar kişiler listesi görüntüler oluşturdunuz. 
Üç güvenlik grubu vardır: 

• Kayıtlı kullanıcılar tüm onaylanan verileri görüntüleyebilir ve kendi verilerini düzenleyebilir/silebilir. 

• Yöneticiler , kişi verilerini onaylayabilir veya reddedebilir. Yalnızca onaylanan kişilere, kullanıcılar tarafından 
görülebilir. 

• Yöneticiler , verileri onaylayabilir/reddedebilir ve düzenleyebilir/silebilir. 

Bu belgedeki görüntüler en son şablonlarla tam olarak eşleşmez. 

Aşağıdaki görüntüde, User Rick ( rick@exampie.com ) oturum açtı. Rick, onaylanan kişileri görüntüleyebilir ve 
kişiler için yeni bağlantılar oluşturmak//silebilir ve düzenleyebilir . Yalnızca Rick tarafından oluşturulan son 
kayıt, Düzenle ve Sil bağlantılarını görüntüler. Bir yöneticinin "Onaylandı" durum olana kadar diğer kullanıcılar 
en son kaydını görmez. 
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Aşağıdaki görüntüde manager@contoso.com , ve yöneticisinin rolünde oturum açtı: 
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Aşağıdaki resimde, bir kişi ayrıntıları görünümünü yöneticileri gösterilmektedir: 




























Onaylama ve reddetme düğmeleri yalnızca Yöneticiler ve yöneticiler için görüntülenir. 
Aşağıdaki görüntüde admin@contoso.com , ve yönetici rolünde oturum açtı: 
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Yöneticisinin tüm ayrıcalıklara sahip değil. Okuma/düzenleme/silme herhangi iletişime geçebiliriz ve kişiler 
birinin durumunu değiştirin. 





















Uygulama, aşağıdaki Contact modeli için Yapı iskelesi tarafından oluşturulmuştur: 


public class Contact 
{ 

public int Contactld { get; set; } 
public string Name { get; set; } 
public string Address { get; set; } 
public string City { get; set; } 
public string State { get; set; } 
public string Zip { get; set; } 

[DataType(DataType.EmailAddress)] 
public string Email { get; set; } 

} 

Örnek aşağıdaki yetkilendirme işleyicilerini içerir: 

• contactisOwnerAuthorizationHandier : kullanıcının yalnızca verilerini düzenleyebilmesini sağlar. 

• contaetManagerAuthorizationHandler : yöneticilerin kişileri onaylamasını veya reddetmesini sağlar. 

• ContactAdministratorsAuthorizationHandler : yöneticilerin kişileri onaylamasını veya reddetmesini ve kişileri 
düzenlemesini/silmesini sağlar. 

Önkoşullar 

Bu öğreticide gelişmiştir.Sahibi olmalısınız: 

• ASP.NET Core 

• Kimlik doğrulaması 

• Hesap Onaylama ve Parola Kurtarma 

• Yetkilendirme 

• Entity Framevvork Core 

Tamamlanmış uygulama ve başlangıç 

Tamamlanmış uygulamayı indirin . Tamamlanmış uygulamayı Test edin, böylece güvenlik özellikleri hakkında bilgi 

sahibi olun. 

Başlangıç uygulaması 

Başlangıç uygulamasını indirin . 

Uygulamayı çalıştırın, ContactManager bağlantısına dokunun ve bir kişi oluşturup silemdiğinizi doğrulayın. 

Kullanıcı verilerinin güvenliğini sağlama 

Aşağıdaki bölümlerde, güvenli kullanıcı veri uygulaması oluşturmak için ana tüm adımları tamamladınız. 

Tamamlanan projeye başvuran daha yararlı olabilir. 

Kullanıcı kişi verilerini bağlayın 

Kullanıcıların verilerini düzenleyebilmeleri, ancak diğer kullanıcıların verilerini düzenleyebilmeleri için ASP.NET 

Identity Kullanıcı kimliğini kullanın. Contact modeline 0 wneriD ve Contactstatus ekleyin: 







public class Contact 

{ 

public int Contactld { get; set; } 

// user ID from AspNetUser table. 
public string OwnerID { get; set; } 

public string Name { get; set; } 
public string Address { get; set; } 
public string City { get; set; } 
public string State { get; set; } 
public string Zip { get; set; } 

[DataType(DataType.EmailAddress)] 
public string Email { get; set; } 

public ContactStatus Status { get; set; } 

} 

public enum ContactStatus 

{ 

Submitted, 

Approvedj 

Rejected 

} 

kimlik veritabanındaki AspNetUser TABLOSUNDAN kullanıcının kimliği 0wneriD . status alanı, bir kişinin genel 
kullanıcılar tarafından görüntülenebilir olup olmadığını belirler. 

Yeni geçiş oluştur ve veritabanını güncelleştir: 

dotnet ef migrations add userID_Status 
dotnet ef database update 


Kimlik için rol hizmetleri Ekle 

Rol hizmetleri eklemek için Addroles ekleyin: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 
Services.AddDefaultIdentity<IdentityUser>( 

options => options.Signln.RequireConfirmedAccount = true) 

.AddRoles<IdentityRole>() 

.AddEntityFrameworkStores<ApplicationDbContext>(); 


Kimliği doğrulanmış kullanıcılar gerektirir 

Kullanıcıların kimliklerinin doğrulanmasını istemek için varsayılan kimlik doğrulama ilkesi ayarlayın: 







public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 

Services. AddDefaultIdentity<Identityllser>( 

options => options.SignIn.RequireConfirmedAccount = true) 

.AddRoles<IdentityRole>() 

.AddEntityFrameworkStores<ApplicationDbContext>(); 

Services.AddRazorPages(); 

Services.AddControllers(config => 

{ 

// using Microsoft.AspNetCore.Mvc.Authorization; 

// using Microsoft.AspNetCore.Authorization; 
var policy = new AuthorizationPolicyBuilder() 

.RequireAuthenticatedUser() 

.Build(); 

config.Filters.Add(new AuthorizeFilter(policy)); 

}); 

[AiiowAnonymous] özniteliğiyle Razor sayfasında, denetleyicide veya eylem yöntemi düzeyinde kimlik 
doğrulamasının devre dışı bırakabilirsiniz. Kullanıcıların kimliklerinin doğrulanmasını istemek için varsayılan 
kimlik doğrulama ilkesi ayarı, yeni eklenen Razor sayfaları ve denetleyicileri korur. Varsayılan olarak kimlik 
doğrulamanın gerekli olması, yeni denetleyicilere bağlı olandan daha güvenlidir ve [Authorize] özniteliğini 
eklemek Razor Pages. 

Anonim kullanıcıların, kaydolmadan önce site hakkında bilgi alması için dizin ve gizlilik sayfalarına 

AllovvAnonymous ekleyin. 

using Microsoft.AspNetCore.Authorization; 
using Microsoft.AspNetCore.Mvc.RazorPages; 
using Microsoft.Extensions.Logging; 

namespace ContactManager.Pages 

{ 

[AllowAnonymous] 

public class IndexModel : PageModel 

{ 

private readonly ILogger<IndexModel> _logger; 

public IndexModel(ILogger<IndexModel> logger) 

{ 

_logger = logger; 

} 

public void OnGet() 

{ 

} 

} 

} 


Test hesabı yapılandırın 

seedData sınıfı iki hesap oluşturur: yönetici ve yönetici. Bu hesaplara bir parola ayarlamak için gizli dizi Yöneticisi 
aracını kullanın. Parolayı proje dizininden ayarlayın ( program .csiçeren dizin): 

dotnet user-secrets set SeedUserPW <PW> 






Güçlü bir parola belirtilmemişse seedData.initialize çağrıldığında bir özel durum oluşturulur. 


Sınama parolasını kullanmak için Main güncelleştirin: 

public class Program 

{ 

public static void Main(string[] args) 

{ 

var hoşt = CreateHostBuilder(args).Build(); 

using (var scope = hoşt.Services.CreateScope()) 

{ 

var Services = scope.ServiceProvider; 

try 

{ 

var context = Services.GetRequiredService<ApplicationDbContext>(); 
context.Database.Migrate(); 

// requires using Microsoft.Extensions.Configuration; 

var config = hoşt.Services.GetRequiredService<IConfiguration>(); 

// Set password with the Secret Manager tool. 

// dotnet user-secrets set SeedUserPkl <pw> 

var testUserPw = config["SeedüserPW"]; 

SeedData.Initialize(Servicesj testUserPw).Wait(); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<ILogger<Program>>(); 
logger.LogError(ex J "An error occurred seeding the DB."); 

} 

} 

host.Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 


Test hesapları oluşturabilir ve kişilerini güncelleştirme 

Test hesapları oluşturmak için seedData sınıfındaki initialize yöntemi güncelleştirin: 

public static async Task Initialize(IServiceProvider ServiceProvider., string testUserPw) 

{ 

using (var context = new ApplicationDbContext( 

ServiceProvider.GetRequiredService<DbContextOptions<ApplicationDbContext>>())) 

{ 

// For sample purposes seed both with the same password. 

// Password is set with the following: 

// dotnet user-secrets set SeedUserPW <pw> 

// The admin user can do anything 

var adminlD = await EnsureUser(serviceProvider., testUserPw J "admin@contoso.com"); 
await EnsureRole(serviceProviderj adminIDj Constants.ContactAdministratorsRole); 

// allowed user can create and edit contacts that they create 

var managerlD = await EnsureUser(serviceProviderj testUserPWj "manager@contoso.com") 
await EnsureRole(serviceProviderj managerID 3 Constants.ContactManagersRole); 






SeedDB(context, adminlD); 

} 

} 

private static async Task<string> EnsureUser(IServiceProvider serviceProvider, 

string testUserPw, string UserName) 

{ 

var userManager = serviceProvider.GetService<UserManager<IdentityUser>>(); 

var user = await userManager.FindByNameAsync(UserName); 
if (user == null) 

{ 

user = new IdentityUser { 

UserName = UserName, 

EmailConfirmed = true 

}; 

await userManager.CreateAsync(user, testUserPw); 

} 

if (user == null) 

{ 

throw new Exception("The password is probably not strong enough!"); 

} 

return user.Id; 

} 

private static async Task<IdentityResult> EnsureRole(IServiceProvider serviceProvider, 

string uid, string role) 

{ 

IdentityResult IR = null; 

var roleManager = serviceProvider.GetService<RoleManager<IdentityRole>>(); 

if (roleManager == null) 

{ 

throw new Exception("roleManager null"); 

} 

if (!await roleManager.RoleExistsAsync(role)) 

{ 

IR = await roleManager.CreateAsync(new IdentityRole(role)); 

} 

var userManager = serviceProvider.GetService<UserManager<IdentityUser>>(); 

var user = await userManager.FindByldAsync(uid); 

if(user == null) 

{ 

throw new Exception("The testUserPw password was probably not strong enough!"); 

} 

IR = await userManager.AddToRoleAsync(user, role); 
return IR; 

} 

Yönetici kullanıcı KİMLİĞİNİ ve Contactstatus kişilere ekleyin. "Gönderileli" ve "Reddedildi" bir kişilerden biri 
olun. Kullanıcı kimliği ve durumu tüm kişileri ekleyin. Tek bir kişi gösterilmektedir: 



public static void SeedDB(ApplicationDbContext context, string adminlD) 

{ 

if (context.Contact.Any()) 

{ 

return; // DB has been seeded 

} 

context.Contact.AddRange( 
new Contact 
{ 

Name = "Debra Garcia", 

Addness = "1234 Main St", 

City = "Redmond", 

State = "WA", 

Zip = "10999", 

Email = "debra@example.com", 

Status = ContactStatus.Approved, 

OwnerID = adminlD 


Sahip, yönetici ve yönetici yetkilendirme işleyicileri oluşturma 

Yetkilendirme klasöründe bir ContactIsOwnerAuthorizationHandler sınıfı oluşturun. 
contactisOwnerAuthorizationHandier , bir kaynağın kaynak üzerinde davranan kullanıcının kaynağın sahip 
olduğunu doğrular. 





using ContactManager.Models; 

using Microsoft.AspNetCore.Authorization; 

using Microsoft.AspNetCore.Authorization.Infrastructure; 

using Microsoft.AspNetCore.Identity; 

using System.Threading.Tasks; 

namespace ContactManager.Authorization 

{ 

public class ContactIsOwnerAuthorizationHandler 

: AuthorizationHandler<OperationAuthorizationRequirement , Contact> 

{ 

UserManager<IdentityUser> _userManager; 

public ContactIsOwnerAuthorizationHandler(UserManager<IdentityUser> 
userManager) 

{ 

_userManager = userManager; 

} 

protected override Task 

HandleRequirementAsync(AuthorizationHandlerContext context , 

OperationAuthorizationRequirement requirement , 

Contact resource) 

{ 

if (context.User == null || resource == null) 

{ 

return Task.CompletedTask; 

} 

// If not asking for CRUD permission, return. 

if (requirement.Name != Constants.CreateOperationName && 
requirement.Name != Constants.ReadOperationName && 
requirement.Name != Constants.UpdateOperationName && 
requirement.Name != Constants.DeleteOperationName ) 

{ 

return Task.CompletedTask; 

} 

if (resource.OwnerID == _userManager.GetUserId(context.User)) 

{ 

context.Succeed(requirement); 

} 

return Task.CompletedTask; 

} 

} 

} 

contactisOwnerAuthorizationHandier bağlamını çağırır Kimliği doğrulanmış geçerli kullanıcı kişi sahibsiyse 
başarılı olur. Yetkilendirme işleyicileri genellikle: 

• Gereksinimler karşılandığında context.succeed döndürün. 

• Gereksinimler karşılanmazsa Task.CompletedTask döndürün. Task.CompletedTask , diğer yetkilendirme 
işleyicilerinin çalışmasına izin veren—başarılı veya başarısız değildir. 

Açıkça başarısız olması gerekiyorsa, bağlamı döndürün. Başarısız oldu. 

Düzenleme/silme/oluşturma iletişim sahiplere kendi verilerini verir. contactisOwnerAuthorizationHandier 
gereksinim parametresine geçirilen işlemi denetlemesi gerekmez. 

Bir yönetici yetkilendirme işleyici oluşturun 

Yetkilendirme klasöründe bir contaetManagerAuthorizationHandler sınıfı oluşturun. 







contaetManagerAuthorizationHandler , kaynak üzerinde davranan kullanıcının bir yönetici olduğunu doğrular. 
Yalnızca Yöneticiler onaylayabileceğiniz veya reddedebileceğiniz içerik değişiklikleri (yeni veya değiştirilmiş). 

using System.Threading.Tasks; 

using ContactManager.Models; 

using Microsoft.AspNetCore.Authorization; 

using Microsoft.AspNetCore.Authorization.Infrastructure; 

using Microsoft.AspNetCore.Identity; 

namespace ContactManager.Authorization 

{ 

public class ContactManagerAuthorizationHandler : 

AuthorizationHandler<OperationAuthorizationRequirement , Contact> 

{ 

protected override Task 

HandleRequirementAsync(AuthorizationHandlerContext context, 

OperationAuthorizationRequirement requirement , 

Contact resource) 

{ 

if (context.User == null || resource == null) 

{ 

return Task.CompletedTask; 

} 

// If not asking for approval/reject , return. 
if (requirement.Name != Constants.ApproveOperationName && 
requirement.Name != Constants.RejectOperationName) 

{ 

return Task.CompletedTask; 

} 

// Managers can approve or reject. 

if (context.User.IsInRole(Constants.ContactManagersRole)) 

{ 

context.Succeed(requirement); 

} 

return Task.CompletedTask; 

} 

} 

} 


Bir yönetici yetkilendirme işleyicisi oluşturun 

Yetkilendirme klasöründe bir contaetAdministratorsAuthorizationHandler sınıfı oluşturun. 

ContactAdministratorsAuthorizationHandler , kaynak üzerinde davranan kullanıcının bir yönetici olduğunu 
doğrular. Yönetici, tüm işlemleri yapabilir. 






using System.Threading.Tasks; 

using ContactManager.Models; 

using Microsoft.AspNetCore.Authorization; 

using Microsoft.AspNetCore.Authorization.Infrastructure; 

namespace ContactManager.Authorization 

{ 

public class ContactAdministratorsAuthorizationHandler 

: AuthorizationHandler<OperationAuthorizationRequirement , Contact> 

{ 

protected override Task HandleRequirementAsync( 

AuthorizationHandlerContext context, 
OperationAuthorizationRequirement requirementj 
Contact resource) 

{ 

if (context.User == null) 

{ 

return Task.CompletedTask; 

} 

// Administrators can do anything. 

if (context.User.IsInRole(Constants.ContactAdministratorsRole)) 

{ 

context.Succeed(requirement); 

} 

return Task.CompletedTask; 

} 

} 

} 


Yetkilendirme işleyicilerini kaydedin 

Entity Framevvork Core kullanan hizmetlerin, Addkapsamlıdırkullanılarak bağımlılık ekleme için kayıtlı olması 
gerekir. contactisOwnerAuthorizationHandier , Entity Framework Core oluşturulan ASP.NET Core kimliğinikullanır. 
işleyicileri, bağımlılık eklemeyoluyla contactsControiler için kullanılabilir olmaları için hizmet koleksiyonuyla 
kaydedin. configureServices sonuna aşağıdaki kodu ekleyin: 






public void ConfigureServices(IServiceCollection Services) 

{ 


Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 
Services.AddDefaultIdentity<IdentityUser>( 

options => options.SignIn.RequireConfirmedAccount = true) 

.AddRoles<IdentityRole>() 

.AddEntityFrameworkStores<ApplicationDbContext>(); 

Services.AddRazorPages(); 

Services.AddControllers(config => 

{ 

// using Microsoft.AspNetCore.Mvc.Authorization; 

// using Microsoft.AspNetCore.Authorization; 
var policy = new AuthorizationPolicyBuilder() 

.RequireAuthenticatedUser() 

.Build(); 

config.Filters.Add(new AuthorizeFilter(policy)); 

}); 

// Authorization handlers. 

Services. AddScoped<IAuthorizationFland ler , 

ContactIsOwnerAuthorizationHandler>(); 

Services.AddSingleton<IAuthorizationHandlerj 

ContactAdministratorsAuthorizationHandler>(); 


} 


Services.AddSingleton<IAuthorizationHandlerj 

ContactManagerAuthorizationHandler>(); 



olduğundan tektonlar vardır. 


Destek yetkilendirme 

Bu bölümde, Razor sayfaları güncelleştirmeniz ve bir işlem gereksinimleri sınıfı ekleyin. 

Gözden geçirme kişi işlem gereksinimleri sınıfı 

Contactoperations sınıfını gözden geçirin. Bu sınıf gereksinimleri içeren uygulama destekler: 






using Microsoft.AspNetCore.Authorization.Infrastructure; 

namespace ContactManager.Authorization 

{ 

public static class ContactOperations 

{ 

public static OperationAuthorizationRequirement Create = 

new OperationAuthorizationRequirement {Name=Constants.CreateOperationName}; 
public static OperationAuthorizationRequirement Read = 

new OperationAuthorizationRequirement {Name=Constants.ReadOperationName}; 
public static OperationAuthorizationRequirement Update = 

new OperationAuthorizationRequirement {Name=Constants.UpdateOperationName}; 
public static OperationAuthorizationRequirement Delete = 

new OperationAuthorizationRequirement {Name=Constants.DeleteOperationName}; 
public static OperationAuthorizationRequirement Approve = 

new OperationAuthorizationRequirement {Name=Constants.ApproveOperationName}; 
public static OperationAuthorizationRequirement Reject = 

new OperationAuthorizationRequirement {Name=Constants.RejectOperationName}; 


public class Constants 

{ 


public static 
public static 
public static 
public static 
public static 
public static 


readonly 

readonly 

readonly 

readonly 

readonly 

readonly 


string CreateOperationName = "Create"; 
string ReadOperationName = "Read"; 
string UpdateOperationName = "Update"; 
string DeleteOperationName = "Delete"; 
string ApproveOperationName = "Approve"; 
string RejectOperationName = "Reject"; 


public static readonly string ContactAdministratorsRole = 

"ContactAdministrators"; 

public static readonly string ContactManagersRole = "ContactManagers"; 

} 

} 


Kişiler Razor sayfaları için bir temel sınıf oluşturma 

Razor sayfalan kişiler kullanılan hizmetler içeren temel bir sınıf oluşturun. Temel sınıf başlatma kodunu tek bir 
yerde getirir: 

using ContactManager.Data; 
using Microsoft.AspNetCore.Authorization; 
using Microsoft.AspNetCore.Identity; 
using Microsoft.AspNetCore.Mvc.RazorPages; 

namespace ContactManager.Pages.Contacts 

{ 

public class DI_BasePageModel : PageModel 

{ 

protected ApplicationDbContext Context { get; } 

protected IAuthorizationService AuthorizationService { get; } 

protected UserManager<IdentityUser> UserManager { get; } 

public DI_BasePageModel( 

ApplicationDbContext context, 

IAuthorizationService authorizationService, 

UserManager<IdentityUser> userManager) : base() 

{ 

Context = context; 

UserManager = userManager; 

AuthorizationService = authorizationService; 

} 

} 

} 




Yukarıdaki kod: 


• Yetkilendirme işleyicilerine erişim için iAuthorizationService hizmetini ekler. 

• Kimlik userManager hizmetini ekler. 

• ApplicationDbContext ekleyin. 

Güncelleştirme CreateModel 

Create Page model oluşturucusunu Di_BasePageModei temel sınıfını kullanacak şekilde güncelleştirin 

public class CreateModel : DI_BasePageModel 

{ 

public CreateModel( 

ApplicationDbContext contextj 
IAuthorizationService authorizationService, 

UserManager<IdentityUser> userManager) 

: base(context , authorizationService, userManager) 

{ 

} 

CreateModel.onPostAsync yöntemini şu şekilde güncelleştirin: 

• Kullanıcı KİMLİĞİNİ Contact modeline ekleyin. 

• Kullanıcının Kişiler oluşturma iznine sahip doğrulamak için yetkilendirme işleyici çağırın. 


public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

Contact.OwnerID = UserManager.GetUserld(User); 

// requires using ContactManager.Authorization; 

var isAuthorized = await AuthorizationService.AuthorizeAsync( 

User, Contact, 
ContactOperations.Create); 

if (lisAuthorized.Succeeded) 

{ 

return Forbid(); 

} 

Context.Contact.Add(Contact); 
await Context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 


Güncelleştirme lndexModel 


onGetAsync yöntemini yalnızca onaylanan kişilerin genel kullanıcılara gösterilmesi için güncelleştirin 








public class IndexModel : DI_BasePageModel 

{ 

public IndexModel( 

ApplicationDbContext context, 

IAuthorizationService authorizationService, 

UserManager<IdentityUser> userManager) 

: base(context , authorizationService, userManager) 

{ 

} 

public IList<Contact> Contact { get; set; } 

public async Task OnGetAsync() 

{ 

var contacts = from c in Context.Contact 
select c; 

var isAuthorized = User.IsInRole(Constants.ContactManagersRole) | 

User.IsInRole(Constants.ContactAdministratorsRole); 

var currentUserld = UserManager.GetUserld(User); 


// Only approved contacts are shown UNLESS you're authorized to see them 
// or you are the owner. 
if (!İsAuthorized) 

{ 

contacts = contacts.Where(c => c.Status == ContactStatus.Approved 

| c.OwnerID == currentUserld); 


} 


} 


Contact = await contacts.ToListAsync(); 

} 


Güncelleştirme EditModel 

Kullanıcının sahip olduğu kişi doğrulamak için bir yetkilendirme işleyicisi ekleyin. Kaynak yetkilendirmesi 
doğrulanamadığından [Authorize] özniteliği yeterli değildir. Öznitelikleri değerlendirildiğinde uygulama 
kaynağa erişimi yok. Kaynak tabanlı yetkilendirme kesinlik temelli olması gerekir. Uygulama sayfası modele 
yükleniyor ya da işleyicisinin içerisinde yükleme kaynağına erişimi olduğunda denetimleri gerçekleştirilmesi 
gerekir. Sık sık geçirerek kaynak anahtarı kaynağa erişir. 

public class EditModel : DI_BasePageModel 

{ 

public EditModel( 

ApplicationDbContext context, 

IAuthorizationService authorizationService, 

UserManager<IdentityUser> userManager) 

: base(context , authorizationService, userManager) 

{ 

} 

[BindProperty] 

public Contact Contact { get; set; } 

public async Task<IActionResult> OnGetAsync(int id) 

{ 

Contact = await Context.Contact.FirstOrDefaultAsync( 

m => m.Contactld == id); 

if (Contact == null) 

{ 

return NotFound(); 

} 




var isAuthorized = await AuthorizationService.AuthorizeAsync( 

User, Contactj 
ContactOperations.Update); 

if (lisAuthorized.Succeeded) 

{ 

return Forbid(); 

} 

return Page(); 


public async Task<IActionResult> OnPostAsync(int id) 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

// Fetch Contact from DB to get OwnerID. 
var contact = await Context 
.Contact.AsNoTracking() 

.FirstOrDefaultAsync(m => m.Contactld == id); 

if (contact == null) 

{ 

return NotFound(); 

} 

var isAuthorized = await AuthorizationService.AuthorizeAsync( 

User, contactj 
ContactOperations.Update); 

if (lisAuthorized.Succeeded) 

{ 

return Forbid(); 

} 

Contact.OwnerID = contact.OwnerID; 

Context.Attach(Contact).State = EntityState.Modified; 

if (Contact.Status == ContactStatus.Approved) 

{ 

// If the contact is updated after approvalj 
// and the user cannot approvej 

// set the status back to submitted so the update can be 
// checked and approved. 

var canApprove = await AuthorizationService.AuthorizeAsync(Userj 
Contactj 

ContactOperations.Approve); 

if (IcanApprove.Succeeded) 

{ 

Contact.Status = ContactStatus.Submitted; 

} 

} 

await Context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

} 


Güncelleştirme DeleteModel 

Delete sayfa modeli, kişi hakkında kullanıcıyı silme izni doğrulamak için yetkilendirme işleyicisi kullanacak şekilde 
güncelleştirin. 


public class DeleteModel : DI_BasePageModel 

{ 

public DeleteModel( 

ApplicationDbContext context, 

IAuthorizationService authorizationService, 
UserManager<IdentityUser> userManager) 

: base(context, authorizationService, userManager) 

{ 

} 

[BindProperty] 

public Contact Contact { get; set; } 

public async Task<IActionResult> OnGetAsync(int id) 

{ 

Contact = await Context.Contact.FirstOrDefaultAsync( 

m => m.Contactld == id); 

if (Contact == null) 

{ 

return NotFound(); 

} 

var isAuthorized = await AuthorizationService.AuthorizeAsync( 

User, Contact, 
ContactOperations.Delete); 

if (üsAuthorized.Succeeded) 

{ 

return Forbid(); 

} 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int id) 

{ 

var contact = await Context 
.Contact.AsNoTracking() 

.FirstOrDefaultAsync(m => m.Contactld == id); 

if (contact == null) 

{ 

return NotFound(); 

} 

var İsAuthorized = await AuthorizationService.AuthorizeAsync( 

User, contact, 
ContactOperations.Delete); 

if (ÜsAuthorized.Succeeded) 

{ 

return Forbid(); 

} 

Context.Contact.Remove(contact); 
await Context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 

} 


Kimlik doğrulama servisi görünümlere ekleme 

Şu anda kullanıcı Arabirimi gösterir düzenleyin ve kişiler kullanıcı değiştiremez bağlantılarını silin. 


Yetkilendirme hizmetini Sayfalar/_V'ıewlmports. cshtml dosyasına ekleme, bu nedenle tüm görünümlerde 




kullanılabilir hale gelir: 


@using Microsoft.AspNetCore.Identity 
@using ContactManager 
@using ContactManager.Data 
@namespace ContactManager.Pages 

@addîagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 
@using ContactManager.Authorization; 

@using Microsoft.AspNetCore.Authorization 
@using ContactManager.Models 

(Şinject IAuthorizationService AuthorizationService 

Yukarıdaki biçimlendirme birkaç using deyimi ekler. 

Sayfaiar/kişiler/lndex. cshtml 'deki Düzenle ve Sil bağlantılarını yalnızca uygun izinlere sahip kullanıcılar için 
işlendikleri şekilde güncelleştirin: 

@page 

@model ContactManager.Pages.Contacts.IndexModel 

@{ 

ViewData["Title"] = "Index"; 

} 

<h2>Index</h2> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

<table class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model => model.Contact[0].Name) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Contact[0].Address) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Contact[0].City) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Contact[0].State) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Contact[0].Zip) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Contact[0].Email) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Contact[0].Status) 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model.Contact) 

{ 

<tr> 

<td> 

@Html.DisplayFor(modelItem => item.Name) 

</td> 

<td> 

@Html.DisplayFor(modelItem => item.Address) 

<• /frt'* 




<td> 

ŞHtml.DisplayFor(modelItem => item.City) 

</td> 

<td> 

ŞHtml.DisplayFor(modelItem => item.State) 

</td> 

<td> 

ŞHtml.DisplayFor(modelItem => item.Zip) 

</td> 

<td> 

ŞHtml.DisplayFor(modelItem => item.Email) 

</td> 

<td> 

ŞHtml.DisplayFor(modelItem => item.Status) 

</td> 

<td> 

Şif ((await Author'izationService.AuthonizeAsync( 

User, item, 

ContactOperations.Update)).Succeeded) 

{ 

<a asp-page="./Edit" asp-route-id="@item.ContactId">Edit</a> 

<text> | </text> 

} 

<a asp-page="./Details" asp-route-id="Şitem.ContactId">Details</a> 

Şif ((await AuthorizationService.AuthorizeAsync( 

User, item, 

ContactOperations.Delete)).Succeeded) 

{ 

<text> | </text> 

<a asp-page="./Delete" asp-route-id="Şitem.ContactId">Delete</a> 

} 

</td> 

</tr> 

} 

</tbody> 

</table> 


WARNING 

Bağlantıları veri değiştirme iznine sahip olmayan kullanıcılardan gizleyerek uygulama güvenli değildir. Bağlantıları gizleme 
uygulamayı daha kullanıcı dostu yalnızca geçerli bağlantıları görüntüleyerek yapar. Kullanıcıları düzenleme çağırmak ve silme 
işlemleri ait olmayan veriler üzerinde oluşturulan URL'leri hack. Razor sayfası veya denetleyici verileri korumak için erişim 
denetimleri zorlamalıdır. 


Güncelleştirme ayrıntıları 

Ayrıntılar görünümü yöneticileri onaylayabilir veya reddedebilir kişiler güncelleştirin: 





Ş*Precedng markup omitted for brevity.*Ş 
<dt> 

ŞHtml.DisplayNameFor(model => model.Contact.Email) 

</dt> 

<dd> 

ŞHtml.DisplayFor(model => model.Contact.Email) 

</dd> 

<dt> 

ŞHtml.DisplayNameFor(model => model.Contact.Status) 

</dt> 

<dd> 

ŞHtml.DisplayFor(model => model.Contact.Status) 

</dd> 

</dl> 

</div> 

Şif (Model.Contact.Status != ContactStatus.Approved) 

{ 

Şif ((await AuthonizationService.AuthorizeAsync( 

User, Model.Contact, ContactOperations.Approve)).Succeeded) 

{ 

<form style="display:inline;" method="post"> 

<input type="hidden" name="id" value="ŞModel.Contact.Contactld" /> 
cinput type="hidden" name="status" value="ŞContactStatus.Approved" /> 
cbutton type="submit" class="btn btn-xs btn-success">Approve</button> 
</form> 

} 

} 

Şif (Model.Contact.Status != ContactStatus.Rejected) 

{ 

Şif ((await AuthorizationService.AuthorizeAsync( 

User, Model.Contact, ContactOperations.Reject)).Succeeded) 

{ 

<form style="display:inline;" method="post"> 

<input type="hidden" name="id" value="ŞModel.Contact.Contactld" /> 
cinput type="hidden" name="status" value="ŞContactStatus.Rejected" /> 
cbutton type="submit" class="btn btn-xs btn-danger">Rejectc/button> 
c/form> 

} 

} 

cdiv> 

Şif ((await AuthorizationService.AuthorizeAsync( 

User, Model.Contact, 

ContactOperations.Update)).Succeeded) 

{ 

ca asp-page="./Edit" asp-route-id="ŞModel.Contact.ContactId">Editc/a> 
ctext> | c/text> 

} 

ca asp-page="./Index">Back to Listc/a> 
c/div> 


Güncelleştirme ayrıntıları sayfa modeli: 



public class DetailsModel : DI_BasePageModel 

{ 

public DetailsModel( 

ApplicationDbContext context, 

IAuthorizationService authorizationService, 

UserManager<IdentityUser> userManager) 

: base(context , authorizationService, userManager) 

{ 

} 

public Contact Contact { get; set; } 

public async Task<IActionResult> OnGetAsync(int id) 

{ 

Contact = await Context.Contact.FirstOrDefaultAsync(m => m.Contactld == id); 

if (Contact == null) 

{ 

return NotFound(); 

} 

var isAuthorized = User.IsInRole(Constants.ContactManagersRole) | 

User.IsInRole(Constants.ContactAdministratorsRole); 

var currentUserld = UserManager.GetUserld(User); 

if (!İsAuthorized 

&& currentUserld != Contact.OwnerID 
&& Contact.Status != ContactStatus.Approved) 

{ 

return Forbid(); 

} 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int id, ContactStatus status) 

{ 

var contact = await Context.Contact.FirstOrDefaultAsync( 

m => m.Contactld == id); 

if (contact == null) 

{ 

return NotFound(); 

} 

var contactOperation = (status == ContactStatus.Approved) 

? ContactOperations.Approve 
: ContactOperations.Reject; 

var İsAuthorized = await AuthorizationService.AuthorizeAsync(User, contact, 

contactOperation); 

if (lisAuthorized.Succeeded) 

{ 

return Forbid(); 

} 

contact.Status = status; 

Context.Contact.Update(contact); 
await Context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 

} 


Ekleme veya bir rolü için bir kullanıcıyı kaldırma 



Hakkında bilgi için Bu soruna bakın: 

• Bir kullanıcıdan ayrıcalıklarının kaldırılması. Örneğin, bir sohbet uygulamasındaki kullanıcıyı kapatma. 

• Bir kullanıcı ayrıcalıkları ekleniyor. 

Challenge ve Fordeklarasyon arasındaki farklar 

Bu uygulama, varsayılan ilkeyi kimliği doğrulanmış kullanıcıları gerektirecekşekilde ayarlar. Aşağıdaki kod anonim 
kullanıcılara izin verir. Anonim kullanıcılara, çekişme ile Fordeklarasyon arasındaki farkları gösterme izni verilir. 

[AllowAnonymous] 

public class Details2Model : DI_BasePageModel 

{ 

public Details2Model( 

ApplicationDbContext context, 

IAuthorizationService authorizationService, 

UserManager<IdentityUser> userManager) 

: base(context, authorizationService, userManager) 

{ 

} 

public Contact Contact { get; set; } 

public async Task<IActionResult> OnGetAsync(int id) 

{ 

Contact = await Context.Contact.FirstOrDefaultAsync(m => m.Contactld == id); 

if (Contact == null) 

{ 

return NotFound(); 

} 

if (lUser.Identity.IsAuthenticated) 

{ 

return Challenge(); 

} 

var isAuthorized = User.IsInRole(Constants.ContactManagersRole) | 

User.IsInRole(Constants.ContactAdministratorsRole); 

var currentUserld = UserManager.GetUserld(User); 

if (!İsAuthorized 

&& currentUserld != Contact.OwnerID 
&& Contact.Status != ContactStatus.Approved) 

{ 

return Forbid(); 

} 

return Page(); 

} 

} 

Önceki kodda: 

• Kullanıcının kimliği doğrulanmadığı zaman, bir chailengeResuit döndürülür. Bir chailengeResuit 
döndürüldüğünde, Kullanıcı oturum açma sayfasına yönlendirilir. 

• Kullanıcının kimliği doğrulandığında, ancak yetkilendirilmediğinde, bir ForbidResuit döndürülür. Bir 
ForbidResuit döndürüldüğünde, Kullanıcı erişim reddedildi sayfasına yönlendirilir. 


Tamamlanmış uygulamayı test etme 









Önceden oluşturulmuş kullanıcı hesaplan için bir parola ayarlamadıysanız, parola ayarlamak için gizli dizi 
Yöneticisi aracını kullanın: 

• Güçlü bir parola seçin: kullanım sekiz veya daha fazla karakter ve en az bir büyük harf karakter, sayı ve 
simge. Örneğin, Passw0rd! güçlü parola gereksinimlerini karşılar. 

• Projenin klasöründen aşağıdaki komutu yürütün, burada <pw> paroladır: 

dotnet user-secrets set SeedUserPI/d <PW> 


Uygulamanın, kişiler varsa: 

• Contact tablosundaki tüm kayıtları silin. 

• Veritabanının çekirdeğini oluşturma için uygulamayı yeniden başlatın. 

Tamamlanmış uygulamayı test etmek için kolay bir yolu, üç farklı tarayıcılar (veya ıncognito/InPrivate oturumları) 
başlatılmasıdır. Tek bir tarayıcıda yeni bir Kullanıcı kaydedin (örneğin, test@exampie.com ). Her bir tarayıcıya farklı 
bir kullanıcı ile oturum açın. Aşağıdaki işlemleri doğrulayın: 

• Kayıtlı kullanıcılar tüm onaylanmış kişi verilerini görüntüleyebilir. 

• Kayıtlı kullanıcıların kendi verilerini düzenleme/silebilir. 

• Yöneticileri Onayla/kişi verilerini reddet. Details görünümü onaylama ve reddetme düğmelerini gösterir. 

• Yöneticiler Onayla/Reddet ve tüm verileri düzenleme/silme. 


KULLANICI 

UYGULAMA TARAFINDAN SAĞLANMIŞ 

SEÇENEKLER 

test@example.com 

Hayır 

Kendi veri düzenleme veya silme. 

manager@contoso.com 

Evet 

Onayla/Reddet ve kendi veri 



düzenleme/silme. 

admin@contoso.com 

Evet 

Onayla/Reddet ve tüm verileri 



düzenleme/silme. 


Bir kişi, yöneticinin tarayıcıda oluşturur.Silme için URL'yi kopyalayın ve yönetici kişiden düzenleyin. Bu 
bağlantıları test kullanıcı bu işlemleri gerçekleştiremezsiniz doğrulamak için test kullanıcının tarayıcısına 
yapıştırın. 

Başlangıç uygulaması oluşturun 

• "ContactManager" adlı bir Razor sayfaları uygulaması oluşturma 

o Ayrı kullanıcı hesaplarıylauygulamayı oluşturun. 

o Örnekte kullanılan ad alanı ad alanı eşleşecek şekilde "ContactManager" adlandırın, 
o -uid , SOLİte yerine LocalDB belirtir 

dotnet new webapp -o ContactManager -au Individual -uld 


• Modeller/llglli kişi ekle, cs: 











public class Contact 

{ 

public int Contactld { get; set; } 
public string Name { get; set; } 
public stning Address { get; set; } 
public stning City { get; set; } 
public stning State { get; set; } 
public stning Zip { get; set; } 
[DataType(DataType.EmailAddness)] 
public stning Email { get; set; } 

} 

• Contact modeli için yapı iskelesi yapın. 

• İlk geçiş oluşturun ve veritabanını güncelleştir: 


dotnet add package Microsoft.VisualStudio.kleb.CodeGeneration.Design 
dotnet tool install -g dotnet-aspnet-codegenenaton 

dotnet aspnet-codegenenaton nazonpage -m Contact -udi -dc ApplicationDbContext -outDin Pages\Contacts -- 

nefenenceScniptLibnanies 

dotnet ef database dnop -f 

dotnet ef mignations add initial 

dotnet ef database update 

dotnet aspnet-codegenenaton nazonpage komutuyla bir hata yaşarsanız, Bu GitHub sorununabakın. 

• Pages/Shared/_Layout. cshtml dosyasındaki ContactManager bağlayıcısını güncelleştirin: 


<a class="navban-bnand" asp-anea="" asp-page="/Contacts/Index">ContactManagen</a> 


• Oluşturma, düzenleme ve silme kişi uygulamayı test etme 

Veritabanının çekirdeğini oluşturma 

Veri klasörüne seeddata sınıfını ekleyin: 

using ContactManager.Models; 

using Microsoft.EntityFrameworkCore; 

using Microsoft.Extensions.DependencyInjection; 

using System; 

using System.Linq; 

using System.Threading.Tasks; 

// dotnet aspnet-codegenerator razorpage -m Contact -dc ApplicationDbContext -udi -outDir Pages\Contacts 
referenceScriptLibraries 

namespace ContactManager.Data 

{ 

public static class SeedData 

{ 

public static async Task Initialize(IServiceProvider serviceProvider, stning testUserPw) 

{ 

using (var context = new ApplicationDbContext( 

serviceProvider.GetRequiredService<DbContextOptions<ApplicationDbContext>>())) 

{ 

SeedDB(context, "0"); 

} 

} 

public static void SeedDB(ApplicationDbContext context, stning adminlD) 

{ 


if (context.Contact.Any()) 





return; // DB has been seeded 

} 

context.Contact.AddRange( 
new Contact 
{ 

Name = "Debra Garcia", 

Addness = "1234 Main St", 

City = "Redmond", 

State = "WA", 

Zip = "10999", 

Email = "debra@example.com" 

L 

new Contact 

{ 

Name = "Thorsten Weinrich", 
Address = "5678 İst Ave W", 

City = "Redmond", 

State = "WA", 

Zip = "10999", 

Email = "thorsten@example.com" 

}, 

new Contact 

{ 

Name = "Yuhong Li", 

Address = "9012 State st", 

City = "Redmond", 

State = "WA", 

Zip = "10999", 

Email = "yuhong@example.com" 

}, 

new Contact 

{ 

Name = "3on Orton", 

Address = "3456 Maple St", 

City = "Redmond", 

State = "WA", 

Zip = "10999", 

Email = "jon@example.com" 

}, 

new Contact 

{ 

Name = "Diliana Alexieva-Bosseva", 
Address = "7890 2nd Ave E", 

City = "Redmond", 

State = "WA", 

Zip = "10999", 

Email = "diliana@example.com" 

} 

); 

context.SaveChanges(); 


} 


} 


Main' 'SeedData.Initialize çağrısı: 


using ContactManager.Data; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.EntityFrameworkCore; 

using Microsoft.Extensions.DependencyInjection; 

using Microsoft.Extensions.Hosting; 

using Microsoft.Extensions.Logging; 

using System; 

namespace ContactManager 

{ 

public class Program 

{ 

public static void Main(string[] args) 

{ 

var hoşt = CreateHostBuilder(args).Build(); 

using (var scope = hoşt.Services.CreateScope()) 

{ 

var Services = scope.ServiceProvider; 

try 

{ 

var context = Services.GetRequiredService<ApplicationDbContext>(); 
context.Database.Migrate(); 

SeedData.Initialize(serviceSj "not used"); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<ILogger<Program>>(); 
logger.LogError(ex, "An error occurred seeding the DB."); 

} 

} 

host.Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

. Conf igurel/JebHostDef aults (webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 

} 

} 


Test, uygulama veritabanını sağlanmış. DB ilgili herhangi bir satır varsa, seed yöntemi çalıştırılmaz. 

Bu öğretici, kullanıcı verilerinin yetkilendirme tarafından korunduğu ile ASP.NET Core web uygulaması 
oluşturma işlemi gösterilmektedir. Kimlik doğrulaması (kayıtlı) kullanıcılar kişiler listesi görüntüler oluşturdunuz. 
Üç güvenlik grubu vardır: 

• Kayıtlı kullanıcılar tüm onaylanan verileri görüntüleyebilir ve kendi verilerini düzenleyebilir/silebilir. 

• Yöneticiler , kişi verilerini onaylayabilir veya reddedebilir. Yalnızca onaylanan kişilere, kullanıcılar tarafından 
görülebilir. 

• Yöneticiler , verileri onaylayabilir/reddedebilir ve düzenleyebilir/silebilir. 

Aşağıdaki görüntüde, User Rick ( rick@exampie.com ) oturum açtı. Rick, onaylanan kişileri görüntüleyebilir ve 
kişiler için yeni bağlantılar oluşturmak//silebilir ve düzenleyebilir . Yalnızca Rick tarafından oluşturulan son 
kayıt, Düzenle ve Sil bağlantılarını görüntüler. Bir yöneticinin "Onaylandı" durum olana kadar diğer kullanıcılar 
en son kaydını görmez. 
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Aşağıdaki görüntüde manager@contoso.com , ve yöneticisinin rolünde oturum açtı: 
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Aşağıdaki resimde, bir kişi ayrıntıları görünümünü yöneticileri gösterilmektedir: 




























Onaylama ve reddetme düğmeleri yalnızca Yöneticiler ve yöneticiler için görüntülenir. 
Aşağıdaki görüntüde admin@contoso.com , ve yönetici rolünde oturum açtı: 
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Yöneticisinin tüm ayrıcalıklara sahip değil. Okuma/düzenleme/silme herhangi iletişime geçebiliriz ve kişiler 
birinin durumunu değiştirin. 





















Uygulama, aşağıdaki Contact modeli için Yapı iskelesi tarafından oluşturulmuştur: 


public class Contact 
{ 

public int Contactld { get; set; } 
public string Name { get; set; } 
public string Address { get; set; } 
public string City { get; set; } 
public string State { get; set; } 
public string Zip { get; set; } 

[DataType(DataType.EmailAddress)] 
public string Email { get; set; } 

} 

Örnek aşağıdaki yetkilendirme işleyicilerini içerir: 

• contactisOwnerAuthorizationHandier : kullanıcının yalnızca verilerini düzenleyebilmesini sağlar. 

• contaetManagerAuthorizationHandler : yöneticilerin kişileri onaylamasını veya reddetmesini sağlar. 

• ContactAdministratorsAuthorizationHandler : yöneticilerin kişileri onaylamasını veya reddetmesini ve kişileri 
düzenlemesini/silmesini sağlar. 

Önkoşullar 

Bu öğreticide gelişmiştir.Sahibi olmalısınız: 

• ASP.NET Core 

• Kimlik doğrulaması 

• Hesap Onaylama ve Parola Kurtarma 

• Yetkilendirme 

• Entity Framevvork Core 

Tamamlanmış uygulama ve başlangıç 

Tamamlanmış uygulamayı indirin . Tamamlanmış uygulamayı Test edin, böylece güvenlik özellikleri hakkında bilgi 

sahibi olun. 

Başlangıç uygulaması 

Başlangıç uygulamasını indirin . 

Uygulamayı çalıştırın, ContactManager bağlantısına dokunun ve bir kişi oluşturup silemdiğinizi doğrulayın. 

Kullanıcı verilerinin güvenliğini sağlama 

Aşağıdaki bölümlerde, güvenli kullanıcı veri uygulaması oluşturmak için ana tüm adımları tamamladınız. 

Tamamlanan projeye başvuran daha yararlı olabilir. 

Kullanıcı kişi verilerini bağlayın 

Kullanıcıların verilerini düzenleyebilmeleri, ancak diğer kullanıcıların verilerini düzenleyebilmeleri için ASP.NET 

Identity Kullanıcı kimliğini kullanın. Contact modeline 0wneriD ve Contactstatus ekleyin: 







public class Contact 

{ 

public int Contactld { get; set; } 

// user ID from AspNetUser table. 
public string OwnerID { get; set; } 

public string Name { get; set; } 
public string Address { get; set; } 
public string City { get; set; } 
public string State { get; set; } 
public string Zip { get; set; } 

[DataType(DataType.EmailAddress)] 
public string Email { get; set; } 

public ContactStatus Status { get; set; } 

} 

public enum ContactStatus 

{ 

Submitted, 

Approvedj 

Rejected 

} 

kimlik veritabanındaki AspNetUser TABLOSUNDAN kullanıcının kimliği 0 wneriD . status alanı, bir kişinin genel 
kullanıcılar tarafından görüntülenebilir olup olmadığını belirler. 

Yeni geçiş oluştur ve veritabanını güncelleştir: 

dotnet ef migrations add userID_Status 
dotnet ef database update 


Kimlik için rol hizmetleri Ekle 

Rol hizmetleri eklemek için Addroles ekleyin: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 
Services.AddDefaultIdentity<IdentityUser>().AddRoles<IdentityRole>() 
.AddEntityFrameworkStores<ApplicationDbContext>(); 


Kimliği doğrulanmış kullanıcılar gerektirir 

Kullanıcıların kimliklerinin doğrulanmasını istemek için varsayılan kimlik doğrulama ilkesi ayarlayın: 







public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.Nonej 

}); 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 

Services. AddDefaultldentity<ldentityllser>(). AddRoles<IdentityRole>() 

.AddEntityFrameworkStores<ApplicationDbContext>(); 

Services.AddMvc(config => 

{ 

// using Microsoft.AspNetCore.Mvc.Authorization; 

// using Microsoft.AspNetCore.Authorization; 
var policy = new AuthorizationPolicyBuilder() 

.RequireAuthenticatedUser() 

.Build(); 

config.Filters.Add(new AuthorizeFilter(policy)); 

}) 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_l); 

[AiiowAnonymous] özniteliğiyle Razor sayfasında, denetleyicide veya eylem yöntemi düzeyinde kimlik 
doğrulamasının devre dışı bırakabilirsiniz. Kullanıcıların kimliklerinin doğrulanmasını istemek için varsayılan 
kimlik doğrulama ilkesi ayarı, yeni eklenen Razor sayfaları ve denetleyicileri korur. Varsayılan olarak kimlik 
doğrulamanın gerekli olması, yeni denetleyicilere bağlı olandan daha güvenlidir ve [Authorize] özniteliğini 
eklemek Razor Pages. 

Anonim kullanıcıların, kayıt yaptırmadan önce site hakkında bilgi alması için dizine, hakkında ve İletişim 
sayfalarına AllovvAnonymous ekleyin. 

using Microsoft.AspNetCore.Authorization; 
using Microsoft.AspNetCore.Mvc.RazorPages; 

namespace ContactManager.Pages 

{ 

[AllowAnonymous] 

public class IndexModel : PageModel 

{ 

public void OnGet() 

{ 

} 

} 

} 


Test hesabı yapılandırın 

seedData sınıfı iki hesap oluşturur: yönetici ve yönetici. Bu hesaplara bir parola ayarlamak için gizli dizi Yöneticisi 
aracını kullanın. Parolayı proje dizininden ayarlayın ( program .csiçeren dizin): 

dotnet user-secrets set SeedUserPW <PW> 

Güçlü bir parola belirtilmemişse SeedData.initialize çağrıldığında bir özel durum oluşturulur. 


Sınama parolasını kullanmak için Main güncelleştirin: 








public class Program 

{ 

public static void Main(string[] args) 

{ 

var hoşt = CreateWebHostBuilder(args). Build(); 

using (var scope = hoşt.Services.CreateScope()) 

{ 

var Services = scope.ServiceProvider; 

var context = Services.GetRequiredService<ApplicationDbContext>(); 
context.Database.Migrate(); 

// requires using Microsoft.Extensions.Configuration; 

var config = hoşt.Services.GetRequiredService<IConfiguration>(); 

// Set password with the Secret Manager tool. 

// dotnet user-secrets set SeedUserPkl <pw> 

var testUserPw = config["SeedUserPW"]; 
try 
{ 

SeedData.Initialize(Servicesj testUserPw).Wait(); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<ILogger<Program>>(); 
logger.LogError(ex.Messagej "An error occurred seeding the DB."); 

} 

} 

host.Run(); 

} 


} 


public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 
1/JebHost .CreateDefaultBuilder(args) 

.UseStartup<Startup>(); 


Test hesapları oluşturabilir ve kişilerini güncelleştirme 

Test hesapları oluşturmak için seedData sınıfındaki initialize yöntemi güncelleştirin: 





public static async Task Initialize(IServiceProvider serviceProvider, string testUserPw) 

{ 

using (var context = new ApplicationDbContext( 

serviceProvider.GetRequiredService<DbContextOptions<ApplicationDbContext>>())) 

{ 

// For sample purposes seed both with the same password. 

// Password is set with the following: 

// dotnet user-secrets set SeedUserPW <pw> 

// The admin user can do anything 

var adminlD = await EnsureUser(serviceProvider, testUserPw, "admin@contoso.com") ; 
await EnsureRole(serviceProvider, adminlD, Constants.ContactAdministratorsRole); 

// allowed user can create and edit contacts that they create 

var managerlD = await EnsureUserCserviceProvider, testUserPw, "manager@contoso.com"); 
await EnsureRole(serviceProviderj managerlD^ Constants.ContactManagersRole); 

SeedDB(context, adminlD); 

} 

} 

private static async Task<string> Ensurellser(IServiceProvider serviceProvider, 

string testUserPw, string UserName) 

{ 

var userManager = serviceProvider.GetService<UserManager<IdentityUser>>(); 

var user = await userManager.FindByNameAsync(UserName); 
if (user == null) 

{ 

user = new IdentityUser { UserName = UserName }; 
await userManager.CreateAsync(user, testUserPw); 

} 

return user.Id; 

} 

private static async Task<IdentityResult> EnsureRole(IServiceProvider serviceProvider, 

string uid, string role) 

{ 

IdentityResult IR = null; 

var roleManager = serviceProvider.GetService<RoleManager<IdentityRole>>(); 

if (roleManager == null) 

{ 

throw new Exception("roleManager null"); 

} 

if (!await roleManager.RoleExistsAsync(role)) 

{ 

IR = await roleManager.CreateAsync(new IdentityRole(role)); 

} 

var userManager = serviceProvider.GetService<UserManager<IdentityUser>>(); 

var user = await userManager.FindByldAsync(uid); 

if(user == null) 

{ 

throw new Exception("The testUserPw password was probably not strong enough!"); 

} 

IR = await userManager.AddToRoleAsync(user, role); 
return IR; 

} 



Yönetici kullanıcı KİMLİĞİNİ ve Contactstatus kişilere ekleyin. "Gönderildi" ve "Reddedildi" bir kişilerden biri 
olun. Kullanıcı kimliği ve durumu tüm kişileri ekleyin. Tek bir kişi gösterilmektedir: 

public static void SeedDB(ApplicationDbContext context, string adminlD) 

{ 

if (context.Contact.Any()) 

{ 

return; // DB has been seeded 

} 

context.Contact.AddRange( 
new Contact 
{ 

Name = "Debra Garcia", 

Addness = "1234 Main St", 

City = "Redmond", 

State = "WA", 

Zip = "10999", 

Email = "debra@example.com", 

Status = Contactstatus.Approved, 

OwnerID = adminlD 

}, 


Sahip, yönetici ve yönetici yetkilendirme işleyicileri oluşturma 

Bir Yetkilendirme klasörü oluşturun ve içinde bir contactisOwnerAuthorizationHandier sınıfı oluşturun. 
contactisOwnerAuthorizationHandier , bir kaynağın kaynak üzerinde davranan kullanıcının kaynağın sahip 
olduğunu doğrular. 






using System.Threading.Tasks; 

using ContactManager.Data; 

using ContactManager.Models; 

using Microsoft.AspNetCore.Authorization; 

using Microsoft.AspNetCore.Authorization.Infrastructure; 

using Microsoft.AspNetCore.Identity; 

namespace ContactManager.Authorization 

{ 

public class ContactIsOwnerAuthorizationHandler 

: AuthorizationHandler<OperationAuthorizationRequirement , Contact> 

{ 

UserManager<IdentityUser> _userManager; 

public ContactIsOwnerAuthorizationHandler(UserManager<IdentityUser> 
userManager) 

{ 

_userManager = userManager; 

} 

protected override Task 

HandleRequirementAsync(AuthorizationHandlerContext context, 

OperationAuthorizationRequirement requirement , 

Contact resource) 

{ 

if (context.User == null || resource == null) 

{ 

// Return Task.FromResult(0) if targeting a version of 
// .NET Framework older than 4.6: 
return Task.CompletedTask; 

} 

// If we're not asking for CRUD permission, return. 

if (requirement.Name != Constants.CreateOperationName && 
requirement.Name != Constants.ReadOperationName && 
requirement.Name != Constants.UpdateOperationName && 
requirement.Name != Constants.DeleteOperationName ) 

{ 

return Task.CompletedTask; 

} 

if (resource.OwnerID == _userManager.GetUserId(context.User)) 

{ 

context.Succeed(requirement); 

} 

return Task.CompletedTask; 

} 

} 

} 

contactisOwnerAuthorizationHandier bağlamını çağırır Kimliği doğrulanmış geçerli kullanıcı kişi sahibsiyse 
başarılı olur. Yetkilendirme işleyicileri genellikle: 

• Gereksinimler karşılandığında context.succeed döndürün. 

• Gereksinimler karşılanmazsa Task.CompletedTask döndürün. Task.CompletedTask , diğer yetkilendirme 
işleyicilerinin çalışmasına izin veren—başarılı veya başarısız değildir. 

Açıkça başarısız olması gerekiyorsa, bağlamı döndürün. Başarısız oldu. 

Düzenleme/silme/oluşturma iletişim sahiplere kendi verilerini verir. contactisOwnenAuthorizationHandier 
gereksinim parametresine geçirilen işlemi denetlemesi gerekmez. 







Bir yönetici yetkilendirme işleyici oluşturun 

Yetkilendirme klasöründe bir contaetManagerAuthorizationHandler sınıfı oluşturun. 

contaetManagerAuthorizationHandler , kaynak üzerinde davranan kullanıcının bir yönetici olduğunu doğrular. 
Yalnızca Yöneticiler onaylayabileceğiniz veya reddedebileceğiniz içerik değişiklikleri (yeni veya değiştirilmiş). 

using System.Threading.Tasks; 

using ContactManager.Models; 

using Microsoft.AspNetCore.Authorization; 

using Microsoft.AspNetCore.Authorization.Infrastructure; 

using Microsoft.AspNetCore.Identity; 

namespace ContactManager.Authorization 

{ 

public class ContactManagerAuthorizationHandler : 

AuthorizationHandler<OperationAuthorizationRequirement , Contact> 

{ 

protected override Task 

HandleRequirementAsync(AuthorizationHandlerContext context , 

OperationAuthorizationRequirement requirement , 

Contact resource) 

{ 

if (context.User == null || resource == null) 

{ 

return Task.CompletedTask; 

} 

// If not asking for approval/reject , return. 
if (requirement.Name != Constants.ApproveOperationName && 
requirement.Name != Constants.RejectOperationName) 

{ 

return Task.CompletedTask; 

} 

// Managers can approve or reject. 

if (context.User.IsInRole(Constants.ContactManagersRole)) 

{ 

context.Succeed(requirement); 

} 

return Task.CompletedTask; 

} 

} 

} 


Bir yönetici yetkilendirme işleyicisi oluşturun 

Yetkilendirme klasöründe bir contaetAdministratorsAuthorizationHandler sınıfı oluşturun. 

ContactAdministratorsAuthorizationHandler , kaynak üzerinde davranan kullanıcının bir yönetici olduğunu 
doğrular. Yönetici, tüm işlemleri yapabilir. 







using System.Threading.Tasks; 

using ContactManager.Models; 

using Microsoft.AspNetCore.Authorization; 

using Microsoft.AspNetCore.Authorization.Infrastructure; 

namespace ContactManager.Authorization 

{ 

public class ContactAdministratorsAuthorizationHandler 

: AuthorizationHandler<OperationAuthorizationRequirement , Contact> 

{ 

protected override Task HandleRequirementAsync( 

AuthorizationHandlerContext context, 
OperationAuthorizationRequirement requirementj 
Contact resource) 

{ 

if (context.User == null) 

{ 

return Task.CompletedTask; 

} 

// Administrators can do anything. 

if (context.User.IsInRole(Constants.ContactAdministratorsRole)) 

{ 

context.Succeed(requirement); 

} 

return Task.CompletedTask; 

} 

} 

} 


Yetkilendirme işleyicilerini kaydedin 

Entity Framevvork Core kullanan hizmetlerin, Addkapsamlıdırkullanılarak bağımlılık ekleme için kayıtlı olması 
gerekir. contactisOwnerAuthorizationHandier , Entity Framework Core oluşturulan ASP.NET Core kimliğinikullanır. 
işleyicileri, bağımlılık eklemeyoluyla contactsControiler için kullanılabilir olmaları için hizmet koleksiyonuyla 
kaydedin. configureServices sonuna aşağıdaki kodu ekleyin: 






public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.Nonej 

}); 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 
Services.AddDefaultIdentity<Identityllser>().AddRoles<IdentityRole>() 
.AddEntityFrameworkStores<ApplicationDbContext>(); 

Services.AddMvc(config => 

{ 

// using Microsoft.AspNetCore.Mvc.Authorizationj 
// using Microsoft.AspNetCore.Authorization; 
var policy = new AuthorizationPolicyBuilder() 

.RequireAuthenticatedUser() 

.Build(); 

config.Filters.Add(new AuthorizeFilter(policy)); 

}) 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_l); 

// Authorization handlers. 

Services. AddScoped<IAut horizationFland ler , 

ContactIsOwnerAuthorizationHandler>(); 

Services.AddSingletoncIAuthorizationHandlerj 

ContactAdministratorsAuthorizationHandler>(); 


} 


Services.AddSingleton<IAuthorizationHandlerj 

ContactManagerAuthorizationFlandler>(); 



olduğundan tektonlar vardır. 


Destek yetkilendirme 

Bu bölümde, Razor sayfaları güncelleştirmeniz ve bir işlem gereksinimleri sınıfı ekleyin. 

Gözden geçirme kişi işlem gereksinimleri sınıfı 

Contactoperations sınıfını gözden geçirin. Bu sınıf gereksinimleri içeren uygulama destekler: 






using Microsoft.AspNetCore.Authorization.Infrastructure; 

namespace ContactManager.Authorization 

{ 

public static class ContactOperations 

{ 

public static OperationAuthorizationRequirement Create = 

new OperationAuthorizationRequirement {Name=Constants.CreateOperationName}; 
public static OperationAuthorizationRequirement Read = 

new OperationAuthorizationRequirement {Name=Constants.ReadOperationName}; 
public static OperationAuthorizationRequirement Update = 

new OperationAuthorizationRequirement {Name=Constants.UpdateOperationName}; 
public static OperationAuthorizationRequirement Delete = 

new OperationAuthorizationRequirement {Name=Constants.DeleteOperationName}; 
public static OperationAuthorizationRequirement Approve = 

new OperationAuthorizationRequirement {Name=Constants.ApproveOperationName}; 
public static OperationAuthorizationRequirement Reject = 

new OperationAuthorizationRequirement {Name=Constants.RejectOperationName}; 


public class Constants 

{ 


public static 
public static 
public static 
public static 
public static 
public static 


readonly 

readonly 

readonly 

readonly 

readonly 

readonly 


string CreateOperationName = "Create"; 
string ReadOperationName = "Read"; 
string UpdateOperationName = "Update"; 
string DeleteOperationName = "Delete"; 
string ApproveOperationName = "Approve"; 
string RejectOperationName = "Reject"; 


public static readonly string ContactAdministratorsRole = 

"ContactAdministrators"; 

public static readonly string ContactManagersRole = "ContactManagers"; 

} 

} 


Kişiler Razor sayfaları için bir temel sınıf oluşturma 

Razor sayfalan kişiler kullanılan hizmetler içeren temel bir sınıf oluşturun. Temel sınıf başlatma kodunu tek bir 
yerde getirir: 

using ContactManager.Data; 
using Microsoft.AspNetCore.Authorization; 
using Microsoft.AspNetCore.Identity; 
using Microsoft.AspNetCore.Mvc.RazorPages; 

namespace ContactManager.Pages.Contacts 

{ 

public class DI_BasePageModel : PageModel 

{ 

protected ApplicationDbContext Context { get; } 

protected IAuthorizationService AuthorizationService { get; } 

protected UserManager<IdentityUser> UserManager { get; } 

public DI_BasePageModel( 

ApplicationDbContext context, 

IAuthorizationService authorizationService, 

UserManager<IdentityUser> userManager) : base() 

{ 

Context = context; 

UserManager = userManager; 

AuthorizationService = authorizationService; 

} 

} 

} 




Yukarıdaki kod: 


• Yetkilendirme işleyicilerine erişim için iAuthorizationService hizmetini ekler. 

• Kimlik userManager hizmetini ekler. 

• ApplicationDbContext ekleyin. 

Güncelleştirme CreateModel 

Create Page model oluşturucusunu Di_BasePageModei temel sınıfını kullanacak şekilde güncelleştirin 

public class CreateModel : DI_BasePageModel 

{ 

public CreateModel( 

ApplicationDbContext contextj 
IAuthorizationService authorizationService, 

UserManager<IdentityUser> userManager) 

: base(context , authorizationService, userManager) 

{ 

} 

CreateModel.onPostAsync yöntemini şu şekilde güncelleştirin: 

• Kullanıcı KİMLİĞİNİ Contact modeline ekleyin. 

• Kullanıcının Kişiler oluşturma iznine sahip doğrulamak için yetkilendirme işleyici çağırın. 


public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

Contact.OwnerID = UserManager.GetUserld(User); 

// requires using ContactManager.Authorization; 

var isAuthorized = await AuthorizationService.AuthorizeAsync( 

User, Contact, 
ContactOperations.Create); 

if (lisAuthorized.Succeeded) 

{ 

return new ChallengeResult(); 

} 

Context.Contact.Add(Contact); 
await Context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 


Güncelleştirme lndexModel 


onGetAsync yöntemini yalnızca onaylanan kişilerin genel kullanıcılara gösterilmesi için güncelleştirin 








public class IndexModel : DI_BasePageModel 

{ 

public IndexModel( 

ApplicationDbContext context, 

IAuthorizationService authorizationService, 

UserManager<IdentityUser> userManager) 

: base(context , authorizationService, userManager) 

{ 

} 

public IList<Contact> Contact { get; set; } 

public async Task OnGetAsync() 

{ 

var contacts = from c in Context.Contact 
select c; 

var isAuthorized = User.IsInRole(Constants.ContactManagersRole) | 

User.IsInRole(Constants.ContactAdministratorsRole); 

var currentUserld = UserManager.GetUserld(User); 


// Only approved contacts are shown UNLESS you're authorized to see them 
// or you are the owner. 
if (!İsAuthorized) 

{ 

contacts = contacts.Where(c => c.Status == ContactStatus.Approved 

| c.OwnerID == currentUserld); 


} 


} 


Contact = await contacts.ToListAsync(); 

} 


Güncelleştirme EditModel 

Kullanıcının sahip olduğu kişi doğrulamak için bir yetkilendirme işleyicisi ekleyin. Kaynak yetkilendirmesi 
doğrulanamadığından [Authorize] özniteliği yeterli değildir. Öznitelikleri değerlendirildiğinde uygulama 
kaynağa erişimi yok. Kaynak tabanlı yetkilendirme kesinlik temelli olması gerekir. Uygulama sayfası modele 
yükleniyor ya da işleyicisinin içerisinde yükleme kaynağına erişimi olduğunda denetimleri gerçekleştirilmesi 
gerekir. Sık sık geçirerek kaynak anahtarı kaynağa erişir. 

public class EditModel : DI_BasePageModel 

{ 

public EditModel( 

ApplicationDbContext context, 

IAuthorizationService authorizationService, 

UserManager<IdentityUser> userManager) 

: base(context , authorizationService, userManager) 

{ 

} 

[BindProperty] 

public Contact Contact { get; set; } 

public async Task<IActionResult> OnGetAsync(int id) 

{ 

Contact = await Context.Contact.FirstOrDefaultAsync( 

m => m.Contactld == id); 

if (Contact == null) 

{ 

return NotFound(); 

} 




var isAuthorized = await AuthorizationService.AuthorizeAsync( 

User, Contact, 
ContactOperations.Update) 

if (lisAuthorized.Succeeded) 

{ 

return new ChallengeResult(); 

} 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int id) 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

// Fetch Contact from DB to get OwnerID. 
var contact = await Context 
.Contact.AsNoTracking() 

.FirstOrDefaultAsync(m => m.Contactld == id); 

if (contact == null) 

{ 

return NotFound(); 

} 

var isAuthorized = await AuthorizationService.AuthorizeAsync( 

User, contact, 
ContactOperations.Update); 

if (lisAuthorized.Succeeded) 

{ 

return new ChallengeResult(); 

} 

Contact.OwnerID = contact.OwnerID; 

Context.Attach(Contact).State = EntityState.Modified; 

if (contact.Status == ContactStatus.Approved) 

{ 

// If the contact is updated after approval, 

// and the user cannot approve, 

// set the status back to submitted so the update can be 
// checked and approved. 

var canApprove = await AuthorizationService.AuthorizeAsync(User 
contact, 

ContactOperations.Approve); 

if (IcanApprove.Succeeded) 

{ 

contact.Status = ContactStatus.Submitted; 

} 

} 

await Context.SaveChangesAsync(); 
return RedirectToPage("./Index"); 

} 

private bool ContactExists(int id) 

{ 

return Context.Contact.Any(e => e.Contactld == id); 

} 


Güncelleştirme DeleteModel 

Delete sayfa modeli, kişi hakkında kullanıcıyı silme izni doğrulamak için yetkilendirme işleyicisi kullanacak şekilde 
güncelleştirin. 


public class DeleteModel : DI_BasePageModel 

{ 

public DeleteModel( 

ApplicationDbContext context, 

IAuthorizationService authorizationService, 
UserManager<Identityllser> userManager) 

: base(context, authorizationService, userManager) 

{ 

} 

[BindProperty] 

public Contact Contact { get; set; } 

public async Task<IActionResult> OnGetAsync(int id) 

{ 

Contact = await Context.Contact.FirstOrDefaultAsync( 

m => m.Contactld == id); 

if (Contact == null) 

{ 

return NotFound(); 

} 

var isAuthorized = await AuthorizationService.AuthorizeAsync( 

User, Contact, 
ContactOperations.Delete); 

if (üsAuthorized.Succeeded) 

{ 

return new ChallengeResult(); 

} 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int id) 

{ 

Contact = await Context.Contact.FindAsync(id); 

var contact = await Context 
.Contact.AsNoTracking() 

.FirstOrDefaultAsync(m => m.Contactld == id); 

if (contact == null) 

{ 

return NotFound(); 

} 

var isAuthorized = await AuthorizationService.AuthorizeAsync( 

User, contact, 
ContactOperations.Delete); 

if (ÜsAuthorized.Succeeded) 

{ 

return new ChallengeResult(); 

} 

Context.Contact.Remove(Contact); 
await Context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 

} 



Kimlik doğrulama servisi görünümlere ekleme 

Şu anda kullanıcı Arabirimi gösterir düzenleyin ve kişiler kullanıcı değiştiremez bağlantılarını silin. 

Yetkilendirme hizmetini Görünümler/_Viewlmports. cshtml dosyasında, tüm görünümlerde kullanılabilir olacak 
şekilde ekleme: 

@using Microsoft.AspNetCore.Identity 
@using ContactManager 
@using ContactManager.Data 
@namespace ContactManager.Pages 

@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 
@using ContactManager.Authorization; 

@using Microsoft.AspNetCore.Authorization 
@using ContactManager.Models 

(Şinject IAuthorizationService AuthorizationService 

Yukarıdaki biçimlendirme birkaç using deyimi ekler. 

Sayfalar/kişiler/lndex. cshtml 'deki Düzenle ve Sil bağlantılarını yalnızca uygun izinlere sahip kullanıcılar için 
işlendikleri şekilde güncelleştirin: 

@page 

@model ContactManager.Pages.Contacts.IndexModel 

@{ 

ViewData["Title"] = "Index"; 

} 

<h2>Index</h2> 

<P> 

<a asp-page="Create">Create New</a> 

</p> 

ctable class="table"> 

<thead> 

<tr> 

<th> 

@Html.DisplayNameFor(model => model.Contact[0].Name) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Contact[0].Address) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Contact[0].City) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Contact[0].State) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Contact[0].Zip) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Contact[0].Email) 

</th> 

<th> 

@Html.DisplayNameFor(model => model.Contact[0].Status) 

</th> 

<thx/th> 

</tr> 

</thead> 

<tbody> 

@foreach (var item in Model.Contact) 

{ 

<tr> 






<td> 

ŞHtml.DisplayFor(modelItem => item.Name) 

</td> 

<td> 

@Html.DisplayFon(modelItem => item.Address) 

</td> 

<td> 

ŞFItml.DisplayFor(modelItem => item.City) 

</td> 

<td> 

ŞHtml.DisplayFor(modelItem => item.State) 

</td> 

<td> 

ŞHtml.DisplayFor(modelItem => item.Zip) 

</td> 

<td> 

ŞFItml.DisplayFor(modelItem => item.Email) 

</td> 

<td> 

ŞHtml.DisplayFor(modelItem => item.Status) 

</td> 

<td> 

Şif ((await AuthorizationServn.ee. AuthorizeAsync( 

User, item, 

ContactOperations.Update)).Succeeded) 

{ 

<a asp-page="./Edit" asp-route-id="@item.ContactId">Edit</a> 

<text> | </text> 

} 

<a asp-page="./Details" asp-route-id="Şitem.ContactId">Details</a> 

Şif ((await AuthorizationService.AuthorizeAsync( 

User, item, 

ContactOperations.Delete)).Succeeded) 

{ 

<text> | </text> 

<a asp-page="./Delete" asp-route-id="Şitem.ContactId">Delete</a> 

} 

</td> 

</tr> 

} 

</tbody> 

</table> 


WARNING 

Bağlantıları veri değiştirme iznine sahip olmayan kullanıcılardan gizleyerek uygulama güvenli değildir. Bağlantıları gizleme 
uygulamayı daha kullanıcı dostu yalnızca geçerli bağlantıları görüntüleyerek yapar. Kullanıcıları düzenleme çağırmak ve silme 
işlemleri ait olmayan veriler üzerinde oluşturulan URL'leri hack. Razor sayfası veya denetleyici verileri korumak için erişim 
denetimleri zorlamalıdır. 


Güncelleştirme ayrıntıları 

Ayrıntılar görünümü yöneticileri onaylayabilir veya reddedebilir kişiler güncelleştirin: 





Ş*Precedng markup omitted for brevity.*Ş 
<dt> 

ŞHtml.DisplayNameFor(model => model.Contact.Email) 

</dt> 

<dd> 

ŞHtml.DisplayFor(model => model.Contact.Email) 

</dd> 

<dt> 

ŞHtml.DisplayNameFor(model => model.Contact.Status) 

</dt> 

<dd> 

ŞHtml.DisplayFor(model => model.Contact.Status) 

</dd> 

</dl> 

</div> 

Şif (Model.Contact.Status != ContactStatus.Approved) 

{ 

Şif ((await AuthonizationService.AuthorizeAsync( 

User, Model.Contact, ContactOperations.Approve)).Succeeded) 

{ 

<form style="display:inline;" method="post"> 

<input type="hidden" name="id" value="ŞModel.Contact.Contactld" /> 
cinput type="hidden" name="status" value="ŞContactStatus.Approved" /> 
cbutton type="submit" class="btn btn-xs btn-success">Approve</button> 
</form> 

} 

} 

Şif (Model.Contact.Status != ContactStatus.Rejected) 

{ 

Şif ((await AuthorizationService.AuthorizeAsync( 

User, Model.Contact, ContactOperations.Reject)).Succeeded) 

{ 

<form style="display:inline;" method="post"> 

<input type="hidden" name="id" value="ŞModel.Contact.Contactld" /> 
cinput type="hidden" name="status" value="ŞContactStatus.Rejected" /> 
cbutton type="submit" class="btn btn-xs btn-success">Rejectc/button> 
c/form> 

} 

} 

cdiv> 

Şif ((await AuthorizationService.AuthorizeAsync( 

User, Model.Contact, 

ContactOperations.Update)).Succeeded) 

{ 

ca asp-page="./Edit" asp-route-id="ŞModel.Contact.ContactId">Editc/a> 
ctext> | c/text> 

} 

ca asp-page="./Index">Back to Listc/a> 
c/div> 


Güncelleştirme ayrıntıları sayfa modeli: 



public class DetailsModel : DI_BasePageModel 

{ 

public DetailsModel( 

ApplicationDbContext context, 

IAuthorizationService authorizationService, 

UserManager<IdentityUser> userManager) 

: base(context , authorizationService, userManager) 

{ 

} 

public Contact Contact { get; set; } 

public async Task<IActionResult> OnGetAsync(int id) 

{ 

Contact = await Context.Contact.FirstOrDefaultAsync(m => m.Contactld == id); 

if (Contact == null) 

{ 

return NotFound(); 

} 

var isAuthorized = User.IsInRole(Constants.ContactManagersRole) | 

User.IsInRole(Constants.ContactAdministratorsRole); 

var currentUserld = UserManager.GetUserld(User); 

if (!İsAuthorized 

&& currentUserld != Contact.OwnerID 
&& Contact.Status != ContactStatus.Approved) 

{ 

return new ChallengeResult(); 

} 

return Page(); 

} 

public async Task<IActionResult> OnPostAsync(int id, ContactStatus status) 

{ 

var contact = await Context.Contact.FirstOrDefaultAsync( 

m => m.Contactld == id); 

if (contact == null) 

{ 

return NotFound(); 

} 

var contactOperation = (status == ContactStatus.Approved) 

? ContactOperations.Approve 
: ContactOperations.Reject; 

var İsAuthorized = await AuthorizationService.AuthorizeAsync(User, contact, 

contactOperation); 

if (lisAuthorized.Succeeded) 

{ 

return new ChallengeResult(); 

} 

contact.Status = status; 

Context.Contact.Update(contact); 
await Context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 

} 


Ekleme veya bir rolü için bir kullanıcıyı kaldırma 



Hakkında bilgi için Bu soruna bakın: 


• Bir kullanıcıdan ayrıcalıklarının kaldırılması. Örneğin, bir sohbet uygulamasındaki kullanıcıyı kapatma. 

• Bir kullanıcı ayrıcalıkları ekleniyor. 

Tamamlanmış uygulamayı test etme 

Önceden oluşturulmuş kullanıcı hesapları için bir parola ayarlamadıysanız, parola ayarlamak için gizli dizi 
Yöneticisi aracını kullanın: 

• Güçlü bir parola seçin: kullanım sekiz veya daha fazla karakter ve en az bir büyük harf karakter, sayı ve 
simge. Örneğin, Passwerd! güçlü parola gereksinimlerini karşılar. 

• Projenin klasöründen aşağıdaki komutu yürütün, burada <pw> paroladır: 

dotnet user-secrets set SeedUserPW <PW> 

• Veritabanını bırakma ve güncelleştirme 

dotnet ef database drop -f 
dotnet ef database update 

• Veritabanının çekirdeğini oluşturma için uygulamayı yeniden başlatın. 

Tamamlanmış uygulamayı test etmek için kolay bir yolu, üç farklı tarayıcılar (veya ıncognito/InPrivate oturumları) 
başlatılmasıdır. Tek bir tarayıcıda yeni bir Kullanıcı kaydedin (örneğin, test@exampie.com ). Her bir tarayıcıya farklı 
bir kullanıcı ile oturum açın. Aşağıdaki işlemleri doğrulayın: 

• Kayıtlı kullanıcılar tüm onaylanmış kişi verilerini görüntüleyebilir. 

• Kayıtlı kullanıcıların kendi verilerini düzenleme/silebilir. 

• Yöneticileri Onayla/kişi verilerini reddet. Detaiis görünümü onaylama ve reddetme düğmelerini gösterir. 

• Yöneticiler Onayla/Reddet ve tüm verileri düzenleme/silme. 


KULLANICI 

UYGULAMA TARAFINDAN SAĞLANMIŞ 

SEÇENEKLER 

test @exa m ple.com 

Hayır 

Kendi veri düzenleme veya silme. 

manager@contoso.com 

Evet 

Onayla/Reddet ve kendi veri 



düzenleme/silme. 

admin@contoso.com 

Evet 

Onayla/Reddet ve tüm verileri 



düzenleme/silme. 


Bir kişi, yöneticinin tarayıcıda oluşturur.Silme için URL'yi kopyalayın ve yönetici kişiden düzenleyin. Bu 
bağlantıları test kullanıcı bu işlemleri gerçekleştiremezsiniz doğrulamak için test kullanıcının tarayıcısına 
yapıştırın. 

Başlangıç uygulaması oluşturun 

• "ContactManager" adlı bir Razor sayfaları uygulaması oluşturma 

o Ayrı kullanıcı hesaplarıylauygulamayı oluşturun. 

o Örnekte kullanılan ad alanı ad alanı eşleşecek şekilde "ContactManager" adlandırın, 
o -uid , SOLİte yerine LocalDB belirtir 










dotnet new webapp -o ContactManager -au Individual -uld 


• M o d e ile r/l lg ili kişi ekle, cs: 

public class Contact 

{ 

public int Contactld { get; set; } 
public string Name { get; set; } 
public stning Addness { get; set; } 
public stning City { get; set; } 
public stning State { get; set; } 
public stning Zip { get; set; } 

[DataType(DataType.EmailAddness)] 
public stning Email { get; set; } 

} 

• Contact modeli için yapı iskelesi yapın. 

• İlk geçiş oluşturun ve veritabanını güncelleştir: 

dotnet aspnet-codegenenaton nazonpage -m Contact -udi -dc ApplicationDbContext -outDin Pages\Contacts 

--referenceScriptLibraries 

dotnet ef database dnop -f 

dotnet ef mignations add initial 

dotnet ef database update 


• Pages/_Layout. cshtml dosyasındaki ContactManager bağlayıcısını güncelleştirin: 


<a asp-page="/Contacts/Index" class="navbar-brand">ContactManager</a> 


• Oluşturma, düzenleme ve silme kişi uygulamayı test etme 

Veritabanının çekirdeğini oluşturma 

Veri klasörüne seeddata sınıfını ekleyin. 


Main' 'SeedData.Initialize çağrısı: 






public class Program 

{ 

public static void Main(string[] args) 

{ 

var hoşt = CreateWebHostBuilder(args). Build(); 

using (var scope = hoşt.Services.CreateScope()) 

{ 

var Services = scope.ServiceProvider; 

try 

{ 

var context = Services.GetRequiredService<ApplicationDbContext>(); 
context.Database.Migrate(); 

SeedData.Initialize(serviceSj "not used"); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<ILogger<Program>>(); 
logger.LogError(ex, "An error occurred seeding the DB."); 

} 

} 

host.Run(); 

} 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 

1/JebHost .CreateDefaultBuilder(args) 

.UseStartup<Startup>(); 

} 


Test, uygulama veritabanını sağlanmış. DB ilgili herhangi bir satır varsa, seed yöntemi çalıştırılmaz. 

Ek kaynaklar 

• Azure App Service bir .NET Core ve SQL veritabanı Web uygulaması oluşturun 

• AS P.N ET Core yetkilendirme Laboratuvarı. Bu Laboratuvar, bu öğreticide sunulan güvenlik özellikleri 
hakkında daha fazla ayrıntıya gider. 

• ASP.NET Core yetkilendirme giriş 

• Özel ilke tabanlı yetkilendirme 



ASPNET Core Razor Pages yetkilendirme kuralları 

14.08.2019 • 9 minutes to read • Edit Online 


Tarafından Luke Latham 

Razor Pages uygulamanızda erişimi denetlemeye yönelik bir yol, başlangıçta yetkilendirme kurallarını 
kullanmaktır. Bu kurallar, kullanıcıları yetkilendirmeniz ve anonim kullanıcıların ayrı sayfalara veya sayfa 
klasörlerine erişmesine izin verir. Bu konu başlığı altında açıklanan kurallar, erişimi denetlemek için otomatik 
olarak Yetkilendirme filtreleri uygular. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Örnek uygulama ASP.NET Core kimliği olmadan tanımlama bilgisi kimlik doğrulamasınıkullanır. Bu konu 
başlığında gösterilen kavramlar ve örnekler ASP.NET Core kimliği kullanan uygulamalar için eşit oranda 
geçerlidir. ASP.NET Core kimliği kullanmak için içindeki ASP.NET Core kimliğe girişyönergeleri izleyin. 

Bir sayfaya erişmek için yetkilendirme gerektir 

Belirtilen yoldaki sayfaya bir AddRazorPagesOptions AuthorizeFilter eklemek için aracılığıyla 
kuralınıkullanın:AuthorizePage 

Services.AddRazorPages() 

.AddRazorPagesOptions(options => 

{ 

options.Conventions.AuthorizePage("/Contact"); 
options.Conventions.AuthorizeFolder("/Private"); 
options .Conventions. AllowAnonymousToPage("/Private/PublicPage"); 
options .Conventions. AllowAnonymousToFolder("/Private/PublicPages") j 

}); 

Belirtilen yol, uzantısı olmayan ve yalnızca eğik çizgi içeren Razor Pages kök göreli yolu olan görünüm altyapısı 
yoludur. 


Bir Yetkilendirme ilkesibelirtmek İçin bir authorizepage aşırı yüklemesikullanın: 



Bir sayfa klasörüne erişmek için yetkilendirme gerektir 

Belirtilen yoldaki bir klasördeki AddRazorPagesOptions tüm sayfalara eklemek AuthorizeFilter için aracılığıyla 
kuralınıkullanın:AuthorizeFolder 







Services.AddRazorPages() 

.AddRazorPagesOptions(options => 

{ 

options.Conventions.AuthorizePage("/Contact"); 

options.Conventions.AuthorizeFolder("/Private"); 

options. Conventions. AllowAnonymousToPage( "/Private/PublicPage"); 

options .Conventions.AllowAnonymousToFolder("/Private/PublicPages"); 

}); 


Belirtilen yol Razor Pages kök göreli yolu olan görüntüleme altyapısı yoludur. 

Bir Yetkilendirme ilkesibelirtmek için, bir authorizefolder aşırı yüklemesikullanın: 

options.Conventions.AuthorizeFolder("/Private", "AtLeast21"); 


Alan sayfasına erişmek için yetkilendirme gerektir 

Belirtilen yoldaki alan sayfasına AddRazorPagesOptions eklemek AuthorizeFilter için aracılığıyla 
kuralınıkullanın:AuthorizeAreaPage 

options.Conventions.AuthorizeAreaPage("Identity", "/Manage/Accounts"); 

Sayfa adı, belirtilen alanın sayfalar kök dizinine göre uzantısı olmayan dosyanın yoludur. Örneğin, dosya 
alanı/ldentlty/Pages/Manage/accounts. cshtml için sayfa adı /Manage/accountso\ur. 

Bir Yetkilendirme ilkesibelirtmek için, bir Authorizeareapage aşırı yüklemesikullanın: 
options.Conventions.AuthorizeAreaPage("Identity", "/Manage/Accounts", "AtLeast21"); 


Bir alan klasörüne erişmek için yetkilendirme gerektir 

Belirtilen yoldaki bir klasördeki AddRazorPagesOptions tüm alanlara bir AuthorizeFilter eklemek için aracılığıyla 
kuralınıkullanın:AuthorizeAreaFolder 

options.Conventions.AuthorizeAreaFolder("Identity", "/Manage "); 

Klasör yolu, belirtilen alanın sayfalar kök dizinine göre klasörün yoludur. Örneğin, bölgeler/kimiik/sayfalar/Yönet/ 
\ Yönefaltındaki dosyalar için klasör yolu. 

Bir Yetkilendirme ilkesibelirtmek için, bir Authorizeareafolder aşırı yüklemesikullanın: 
options.Conventions.AuthorizeAreaFolder("Identity", "/Manage", "AtLeast21"); 

Bir sayfaya anonim erişime izin ver 

Belirtilen yoldaki bir sayfaya AddRazorPagesOptions bir AllovvAnonymousFilter eklemek için aracılığıyla 
kuralınıkullanın:AllowAnonymousToPage 






Services.AddRazorPages() 

.AddRazorPagesOptions(options => 

{ 

options.Conventions.AuthorizePage("/Contact"); 

options.Conventions.AuthorizeFolder("/Private"); 

options. Conventions. AllowAnonymousToPage( "/Private/PublicPage"); 

options.Conventions.AllowAnonymousToFolder("/Private/PublicPages"); 

}); 


Belirtilen yol, uzantısı olmayan ve yalnızca eğik çizgi içeren Razor Pages kök göreli yolu olan görünüm altyapısı 
yoludur. 

Bir sayfa klasörüne anonim erişime izin ver 

Belirtilen yoldaki bir klasördeki AddRazorPagesOptions tüm sayfalara eklemek AllovvAnonymousFilter için 
aracılığıyla kuralını kul lan ın:AllowAnonymousToFolder 

Services.AddRazorPages() 

.AddRazorPagesOptions(options => 

{ 

options.Conventions.AuthorizePage("/Contact"); 
options.Conventions.AuthorizeFolder("/Private"); 
options .Conventions. AllowAnonymousToPage("/Private/PublicPage"); 
options .Conventions. AllowAnonymousToFolder("/Private/PublicPages") j 

}); 


Belirtilen yol Razor Pages kök göreli yolu olan görüntüleme altyapısı yoludur. 

Yetkili ve anonim erişimi birleştirme hakkında 

Yetkilendirme gerektiren bir sayfa klasörünün ve bu klasörün içindeki bir sayfanın adsız erişime izin verdiğini 
belirtmek için geçerlidir: 

// This works. 

.AuthorizeFolder("/Private").AllowAnonymousToPage("/Private/Public") 

Ancak, tersi de geçerlidir. Anonim erişim için bir sayfa klasörü bildiremezsiniz ve ardından bu klasör içinde 
yetkilendirme gerektiren bir sayfa belirtemezsiniz: 

// This doesn't work! 

.AllowAnonymousToFolder("/Public").AuthorizePage("/Public/Private") 

Özel sayfada yetkilendirme gerektirme başarısız olur. AllovvAnonymousFilter AllovvAnonymousFilter Ve 
sayfayaherikisideuygulandığında„öncelikalırveerişimidenetler.AuthorizeFilter 

Ek kaynaklar 

• ASP.NET Core Razor Pages yol ve uygulama kuralları 

• PageConventionCollection 

Razor Pages uygulamanızda erişimi denetlemeye yönelik bir yol, başlangıçta yetkilendirme kurallarını 
kullanmaktır. Bu kurallar, kullanıcıları yetkilendirmeniz ve anonim kullanıcıların ayrı sayfalara veya sayfa 
klasörlerine erişmesine izin verir. Bu konu başlığı altında açıklanan kurallar, erişimi denetlemek için otomatik 
olarak Yetkilendirme filtreleri uygular. 






Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Örnek uygulama ASP.NET Core kimliği olmadan tanımlama bilgisi kimlik doğrulamasınıkullanır. Bu konu 
başlığında gösterilen kavramlar ve örnekler ASP.NET Core kimliği kullanan uygulamalar için eşit oranda 
geçerlidir. ASP.NET Core kimliği kullanmak için içindeki ASP.NET Core kimliğe girişyönergeleri izleyin. 

Bir sayfaya erişmek için yetkilendirme gerektir 

Belirtilen yoldaki sayfaya bir AddRazorPagesOptions AuthorizeFilter eklemek için aracılığıyla 
kuralınıkullanın:AuthorizePage 

Services. AddMvc() 

.AddRazorPagesOptions(options => 

{ 

options.Conventions.AuthorizePage("/Contact"); 
options.Conventions.AuthorizeFolder("/Private"); 
options .Conventions. AllowAnonymousToPage("/Private/PublicPage"); 
options .Conventions.AllowAnonymousToFolder("/Private/PublicPages"); 

}) 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


Belirtilen yol, uzantısı olmayan ve yalnızca eğik çizgi içeren Razor Pages kök göreli yolu olan görünüm altyapısı 
yoludur. 

Bir Yetkilendirme ilkesibelirtmek İçin bir authorizepage aşırı yüklemesikullanın: 



Bir sayfa klasörüne erişmek için yetkilendirme gerektir 

Belirtilen yoldaki bir klasördeki AddRazorPagesOptions tüm sayfalara eklemek AuthorizeFilter için aracılığıyla 
kuralınıkullanın:AuthorizeFolder 


Services. AddMvc() 

.AddRazorPagesOptions(options => 

{ 

options.Conventions.Authorizepage("/Contact"); 

options.Conventions.AuthorizeFolder("/Private"); 

options.Conventions.AllowAnonymousToPage("/Private/PublicPage"); 

options.Conventions. AllowAnonymousToFolder("/Private/PublicPages"); 

}) 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


Belirtilen yol Razor Pages kök göreli yolu olan görüntüleme altyapısı yoludur. 

Bir Yetkilendirme ilkesibelirtmek için, bir authorizefolder aşırı yüklemesikullanın: 

options.Conventions.AuthorizeFolder("/Private"j "AtLeast21"); 







Alan sayfasına erişmek için yetkilendirme gerektir 

Belirtilen yoldaki alan sayfasına AddRazorPagesOptions eklemek AuthorizeFilter için aracılığıyla 
kuralınıkullanın:AuthorizeAreaPage 

options.Conventions.AuthorizeAreaPage("Identity ", "/Manage/Accounts"); 

Sayfa adı, belirtilen alanın sayfalar kök dizinine göre uzantısı olmayan dosyanın yoludur. Örneğin, dosya 
alanı/ldentity/Pages/Manage/accounts. cshtml için sayfa adı /Manage/accountso\uy. 

Bir Yetkilendirme ilkesibelirtmek için, bir Authorizeareapage aşırı yüklemesikullanın: 
options.Conventions.AuthorizeAreaPage("Identity", "/Manage/Accounts ", "AtLeast21"); 


Bir alan klasörüne erişmek için yetkilendirme gerektir 

Belirtilen yoldaki bir klasördeki AddRazorPagesOptions tüm alanlara bir AuthorizeFilter eklemek için aracılığıyla 
kuralınıkullanın:AuthorizeAreaFolder 

options.Conventions.AuthorizeAreaFolder("Identity", "/Manage"); 

Klasör yolu, belirtilen alanın sayfalar kök dizinine göre klasörün yoludur. Örneğin, bölgeler/kimlik/sayfalar/Yönet/ 
\ Yönefaltındaki dosyalar için klasör yolu. 

Bir Yetkilendirme ilkesibelirtmek için, bir Authorizeareafolder aşırı yüklemesikullanın: 
options.Conventions.AuthorizeAreaFolder("Identity", "/Manage", "AtLeast21"); 


Bir sayfaya anonim erişime izin ver 

Belirtilen yoldaki bir sayfaya AddRazorPagesOptions bir AllovvAnonymousFilter eklemek için aracılığıyla 
kuralınıkullanın:AllowAnonymousToPage 

Services. AddMvc() 

. AddRazorPagesOptions(options => 

{ 

options.Conventions.AuthorizePage("/Contact"); 
options.Conventions.AuthorizeFolder("/Private"); 
options .Conventions. AllowAnonymousToPage("/Private/PublicPage"); 
options .Conventions. AllowAnonymousToFolder("/Private/PublicPages"); 

}) 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


Belirtilen yol, uzantısı olmayan ve yalnızca eğik çizgi içeren Razor Pages kök göreli yolu olan görünüm altyapısı 
yoludur. 

Bir sayfa klasörüne anonim erişime izin ver 

Belirtilen yoldaki bir klasördeki AddRazorPagesOptions tüm sayfalara eklemek AllovvAnonymousFilter için 
aracılığıyla kuralınıkullanın:AllowAnonymousToFolder 







Services. AddMvc() 

. AddRazorPagesOptions(options => 

{ 

options.Conventions.AuthorizePage("/Contact"); 

options.Conventions.AuthorizeFolder("/Private"); 

options. Conventions. AllowAnonymousToPage( "/Private/PublicPage"); 

options.Conventions.AllowAnonymousToFolder("/Private/PublicPages"); 

}) 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


Belirtilen yol Razor Pages kök göreli yolu olan görüntüleme altyapısı yoludur. 

Yetkili ve anonim erişimi birleştirme hakkında 

Yetkilendirme gerektiren bir sayfa klasörünün ve bu klasörün içindeki bir sayfanın adsız erişime izin verdiğini 
belirtmek için geçerlidir: 

// This works. 

. AııthorizeFolder("/Private"). AllowAnonymousToPage("/Private/Public") 


Ancak, tersi de geçerlidir.Anonim erişim için bir sayfa klasörü bildiremezsiniz ve ardından bu klasör içinde 
yetkilendirme gerektiren bir sayfa belirtemezsiniz: 

// This doesn't work! 

. AllowAnonymousToFolder( "/Public") .AuthorizePage("/Public/Private") 

Özel sayfada yetkilendirme gerektirme başarısız olur.AllovvAnonymousFilter AllovvAnonymousFilter Ve 
sayfayaherikisideuygulandığında„öncelikalırveerişimidenetler.AuthorizeFilter 

Ek kaynaklar 

• ASP.NET Core Razor Pages yol ve uygulama kuralları 

• PageConventionCollection 






ASRNET core'da basit yetkilendirme 
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Yetkilendirme mvc'de aracılığıyla denetlenebilir AuthorizeAttribute özniteliği ve çeşitli parametreleri. En basit 
şekliyle, uygulama AuthorizeAttribute denetleyici veya eylem erişimi denetleyiciye veya eylem kimliği 
doğrulanan kullanıcı için özniteliği. 

Örneğin, aşağıdaki kod erişimi sınırlar Accountcontroiler herhangi bir kimliği doğrulanmış kullanıcı için. 
[Authorize] 

public class AccountController : Controller 
{ 

public ActionResult Login() 

{ 

} 

public ActionResult Logout() 

{ 

} 

} 

Yetkilendirme denetleyicisi yerine bir eylemi uygulamak istiyorsanız, geçerli AuthorizeAttribute özniteliği eylem 
için: 

public class AccountController : Controller 
{ 

public ActionResult Login() 

{ 

} 

[Authorize] 

public ActionResult Logout() 

{ 

} 

} 

Yalnızca kimliği doğrulanmış kullanıcıların artık Logout işlevi. 

Ayrıca AiiowAnonymous bireysel işlemlere doğrulanmamış kullanıcılar tarafından erişime izin vermek için 
özniteliği. Örneğin: 

[Authorize] 

public class AccountController : Controller 
{ 

[AllowAnonymous] 

public ActionResult Login() 

{ 

} 

public ActionResult Logout() 

{ 

} 

} 


Bu yalnızca kimliği doğrulanmış kullanıcılara izin AccountController 


dışında Login kimliği doğrulanmış veya 














kimliği doğrulanmamış / anonim durumlarını bağımsız olarak herkes tarafından erişilebilir olan bir eylem. 


VVARNING 

[AllowAnonymous ] Tüm Yetkilendirme deyimleri atlar. Birleştirirseniz [AllowAnonymous] ve tüm [Authorize] özniteliği 
[Authorize] öznitelikleri yoksayılır. Örneğin, uygulamanızı [AllowAnonymous] denetleyid düzeyinde herhangi 
[Authorize] öznitelikleri aynı denetleyidsine (veya içindeki herhangi bir eylem) göz ardı edilir. 




ASPNET Core rol tabanlı yetkilendirme 
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Bir kimlik oluşturulduğunda, bir veya daha fazla role ait olabilir.Örneğin, Tracy yönetici 'y e ait olabilir ve IHOST 
Scott yalnızca kullanıcı rolüne ait olabilir. Bu rollerin oluşturulması ve yönetilmesi, yetkilendirme işleminin 
yedekleme deposuna bağlıdır. Roller, ClaimsPrincipal sınıfındaki ıınrole yöntemi aracılığıyla geliştiriciye sunulur. 

Rol denetimleri ekleme 

Rol tabanlı yetkilendirme denetimleri bildirime dayalı—geliştirici, bu dosyaları bir denetleyiciye veya denetleyici 
içindeki bir eyleme karşı, geçerli kullanıcının istenen kaynağa erişmek için üyesi olması gereken rolleri belirterek 
kod içinde katıştırır. 

Örneğin, aşağıdaki kod, Administrator rolünün bir üyesi olan kullanıcılar için AdministrationControiler tüm 
eylemlere erişimi kısıtlar: 

[Authorize(Roles = "Administrator")] 

public class AdministrationControiler : Controller 

{ 

} 


Birden çok rolü, virgülle ayrılmış bir liste olarak belirtebilirsiniz: 



Birden çok öznitelik uygularsanız, bir erişen kullanıcının belirtilen tüm rollerin üyesi olması gerekir; Aşağıdaki 



işlem düzeyinde ek rol yetkilendirme öznitelikleri uygulayarak erişimi daha da sınırlayabilirsiniz: 












[Authorize(Roles = "Administrator, PowerUser")] 
public class ControlPanelController : Controller 
{ 

public ActionResult SetTime() 

{ 

} 

[Authorize(Roles = "Administrator")] 
public ActionResult ShutDown() 

{ 

} 

} 

Administrator rolün önceki kod parçacığı üyeleri veya PowerUser rolü denetleyiciye ve setTime eylemine 
erişebilir, ancak yalnızca Administrator rolünün üyeleri shutDown eylemine erişebilir. 


Ayrıca, bir denetleyiciyi kilitleyebilir, ancak tek tek eylemlere anonim, kimliği doğrulanmamış erişime izin 
verebilirsiniz. 


[Authorize] 

public class ControlPanelController : Controller 
{ 

public ActionResult SetTime() 

{ 

} 

[AllowAnonymous] 

public ActionResult Login() 

{ 

} 

} 

Razor Pages için AuthorizeAttribute şu şekilde uygulanabilir: 

• Bir kuralkullanma veya 

• AuthorizeAttribute PageModei örneğine uygulanıyor: 

[Authorize(Policy = "RequireAdministratorRole")] 
public class UpdateModel : PageModei 
{ 

public ActionResult OnPost() 

{ 

} 

} 



İlke tabanlı rol denetimleri 

Rol gereksinimleri, bir geliştiricinin bir ilkeyi yetkilendirme hizmeti yapılandırmasının bir parçası olarak bir ilke 
kaydettiğinde yeni İlke sözdizimi kullanılarak da ifade edilebilir. Bu, normal olarak Startup.es dosyanızdaki 
ConfigureServices( ) oluşur. 













public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddControllersWithViews(); 

Services.AddRazorPages(); 

Services.AddAuthorization(options => 

{ 

options.AddPolicy("RequireAdministratorRole ", 

policy => policy.RequireRole("Administrator")); 

}); 

} 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services. AddMvc(); 

Services.AddAuthorization(options => 

{ 

options.AddPolicy("RequireAdministratorRole", 

policy => policy.RequireRole("Administrator")); 

}); 

} 

ilkeler, AuthorizeAttribute özniteliğinde Policy özelliği kullanılarak uygulanır: 

[Authorize(Policy = "RequireAdministratorRole")] 
public IActionResult Shutdown() 

{ 

return View(); 

} 


Bir gereksinimde birden fazla izin verilen rol belirtmek istiyorsanız, bunları 

olarak belirtebilirsiniz: 

RequireRole 

yöntemine parametre 

options.AddPolicy("ElevatedRights"j policy => 

policy.RequireRole("Administrator ", "PowerUser ", "BackupAdministrator")); 


Bu örnek, Administrator , Poweruser veya BackupAdministrator rollerine ait olan kullanıcıları yetkilendirir. 

Kimliğe rol hizmetleri Ekle 

Rol hizmetleri eklemek için Addroles ekleyin: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 

Services.AddDefaultIdentity<IdentityUser>() 

.AddRoles<IdentityRole>() 

.AddEntityFrameworkStores<ApplicationDbContext>(); 

Services.AddControllersWithViews(); 

Services.AddRazorPages(); 

} 










public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 

Services.AddDefaultIdentity<IdentityUser>() 

.AddRoles<IdentityRole>() 

.AddDefaultUI(UIFramework.Bootstrap4) 

.AddEntityFrameworkStores<ApplicationDbContext>(); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2) 



ASPNET Core 'de talep tabanlı yetkilendirme 
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Bir kimlik oluşturulduğunda, güvenilen bir taraf tarafından verilen bir veya daha fazla talep atanabilir.Talep, 
konunun ne yapabileceğini temsil eden bir ad değer çiftidir. Örneğin, bir yerel bir itici lisans yetkilisi tarafından 
verilen bir sürücü lisansına sahip olabilirsiniz. Sürücünüzün lisansının, bu tarihte Doğum tarihi vardır.Bu durumda, 
talep adı DateOfBirth olabilir, örneğin, talep değeri Doğum tarihiniz olur, örneğin 8 th lune 1970 ve veren lisans 
yetkilisi olur. Talep tabanlı yetkilendirme, en basit, bir talebin değerini denetler ve bu değere göre bir kaynağa 
erişim sağlar. Örneğin, gece kulübünün erişim istiyorsanız yetkilendirme süreci şu olabilir: 

Kapılı güvenlik müdürü, Doğum talepinizin tarihini ve erişim izni vermeden önce veren (itici lisans yetkilisi) 
tarafından güvenip güvenmeyeceğini değerlendirir. 

Bir kimlik birden çok değer içeren birden fazla talep içerebilir ve aynı türde birden fazla talep içerebilir. 

Talep denetimleri ekleme 

Talep tabanlı yetkilendirme denetimleri bildirime dayalı-geliştirici, bunları kendi kodlarında bir denetleyiciye veya 
denetleyici içindeki bir eyleme göre, geçerli kullanıcının sahip olması gereken talepleri belirterek ve isteğe bağlı 
olarak, talebin bu değere erişmesi için tutması gereken değeri istenen kaynak. Talep gereksinimleri ilke tabanlıdır, 
geliştiricilerin talep gereksinimlerini ifade eden bir ilke oluşturması ve kaydetmesi gerekir. 

En basit talep ilkesi türü bir talep olup olmadığını arar ve değeri denetlemez. 

Önce ilkeyi oluşturmanız ve kaydetmeniz gerekir. Bu, normalde Startup.es dosyanızdaki configureServices() bir 
parçasını alan yetkilendirme hizmeti yapılandırmasının bir parçası olarak gerçekleşir. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddControllersWithViews(); 

Services.AddRazorPages(); 

Services.AddAuthorization(options => 

{ 

options.AddPolicyC'EmployeeOnly", policy => policy.RequireClaim("EmployeeNumber")); 

}); 

} 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services. AddMvc(); 

Services.AddAuthorization(options => 

{ 

options.AddPolicy("EmployeeOnly"j policy => policy.RequireClaim("EmployeeNumber")); 

}); 

} 

Bu durumda EmployeeOniy ilkesi geçerli kimlik üzerinde bir EmployeeNumber talebi olup olmadığını denetler, 
ilke adını belirtmek için AuthorizeAttribute özniteliğinde Policy özelliğini kullanarak ilkeyi uygularsınız; 

















[Authorize(Policy = "EmployeeOnly")] 
public IActionResult VacationBalance() 

{ 

return View(); 

} 

AuthonizeAttribute özniteliği denetleyicinin tamamına uygulanabilir, bu örnekte yalnızca ilkeyle eşleşen kimlikler 
denetleyicideki herhangi bir eyleme erişime izin verilir. 

[Authorize(Policy = "EmployeeOnly")] 

public class VacationContnoller : Controller 

{ 

public ActionResult VacationBalance() 

{ 

} 

} 

AuthonizeAttribute özniteliğiyle korunan bir denetleyiciniz varsa, ancak belirli eylemlere anonim erişime izin 
vermek istiyorsanız AiiowAnonymousAttribute özniteliğini uygularsınız. 

[Authorize(Policy = "EmployeeOnly")] 

public class VacationContnoller : Controller 

{ 

public ActionResult VacationBalance() 

{ 

} 

[AllowAnonymous] 

public ActionResult VacationPolicy() 

{ 

} 

} 

Çoğu talep bir değerle gelir.ilke oluştururken izin verilen değerlerin bir listesini belirtebilirsiniz. Aşağıdaki örnek 
yalnızca çalışan numarası 1, 2, 3,4 veya 5 olan çalışanlar için başarılı olur. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services .AddCont rollersWithviews( ); 

Services.AddRazorPages(); 

Services.AddAuthorization(options => 

{ 

options.AddPolicyC'Founders", policy => 

policy.RequireClaim("EmployeeNumber", " 1 ", ” 2 ", "3", "4", "5")); 

}); 

} 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services. AddMvc(); 

Services. AddAuthorization(options => 

{ 

options.AddPolicyC'Founders", policy => 

policy.RequireClaim("EmployeeNumber", "1", " 2 ", "3", " 4 ", "5")); 

}); 

} 



Genel talep denetimi ekleme 

Talep değeri tek bir değer değilse veya bir dönüşüm gerekliyse, Requireassertionkullanın. Daha fazla bilgi için bkz. 
bir ilkeyi yerine getirmek için bir Func kullanma. 

Birden çok İlke değerlendirmesi 

Bir denetleyiciye veya eyleme birden çok ilke uygularsanız, erişim verilmeden önce tüm ilkelerin geçmesi gerekir. 
Örneğin: 

[Authorize(Policy = "EmployeeOnly")] 
public class SalaryController : Controller 
{ 

public ActionResult Payslip() 

{ 

} 

[Authorize(Policy = "HumanResources")] 
public ActionResult UpdateSalary() 

{ 

} 

} 

Yukarıdaki örnekte EmployeeOnly ilkesini karşılayan herhangi bir kimlik, denetleyicide ilke zorlandığında Payslip 
eyleme erişebilir. Ancak updateSalary eylemini çağırmak için kimlik hem EmployeeOnly ilkesini hem de 
HumanResources ilkesini yerine getirmelidir. 

Doğum talebinde bulunmak gibi daha karmaşık ilkeler isterseniz, bu tarihten itibaren bir yaşı hesaplamak, daha 
sonra yaşı 21 veya daha eski bir tarihte denetlemek için özel ilke işleyicileriyazmanız gerekir. 








ASPNET Core ilke tabanlı yetkilendirme 
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Kapakların altında rol tabanlı yetkilendirme ve talep tabanlı yetkilendirme , bir gereksinim, gereksinim 
işleyicisi ve önceden yapılandırılmış bir ilke kullanır. Bu yapı taşları, koddaki yetkilendirme 
değerlendirmeleri ifadesini destekler. Sonuç daha zengin, yeniden kullanılabilir ve test edilebilir bir 
yetkilendirme yapısıdır. 

Yetkilendirme ilkesi bir veya daha fazla gereksinimden oluşur. startup.configureServices yönteminde 
yetkilendirme hizmeti yapılandırmasının bir parçası olarak kaydedilir: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddControllersWithViews(); 

Services.AddRazorPages(); 

Services.AddAuthorization(options => 

{ 

options.AddPolicy("AtLeast21", policy => 

policy.Requirements.Add(new MinimumAgeRequirement(21))); 

}); 

} 


Yukarıdaki örnekte, "AtLeast21" ilkesi oluşturulur.Gereksinime bir parametre olarak sağlanan minimum 
yaş—tek bir gereksinime sahiptir. 

lAuthorizationService 

Yetkilendirmenin başarılı olup olmadığını belirleyen birincil hizmet lAuthorizationService: 






/// <summary> 

III Checks policy based permissions for a user 
III </summary> 

public interface IAuthorizationService 

{ 

III <summary> 

III Checks if a user meets a specific set of requirements for the specified resource 
III </summary> 

III <param name="user">The user to evaluate the requirements against.</param> 

III <param name="resource"> 

III An optional resource the policy should be checked with. 

III If a resource is not required for policy evaluation you may pass null as the value 
III </param> 

III <param name="requirements">The requirements to evaluate.</param> 

III <returns> 

III A flag indicating whether authorization has succeeded. 

III This value is <value>true</value> when the user fulfills the policy; 

III otherwise <value>false</value>. 

III </returns> 

III <remarks> 

III Resource is an optional parameter and may be null. Please ensure that you check 
III it is not null before acting upon it. 

III </remarks> 

Task<AuthorizationResult> AuthorizeAsync(ClaimsPrincipal user, object resource, 

IEnumerable<IAuthorizationRequirement> requirements); 


} 


III <summary> 

III Checks if a user meets a specific authorization policy 
III </summary> 

III <param name="user">The user to check the policy against.</param> 

III <param name="resource"> 

III An optional resource the policy should be checked with. 

III If a resource is not required for policy evaluation you may pass null as the value 
III </param> 

III <param name="policyl\lame">The name of the policy to check against a specific 
III context.</param> 

III <returns> 

III A flag indicating whether authorization has succeeded. 

III Returns a flag indicating whether the user, and optional resource has fulfilled 
III the policy. 

III <value>true</value> when the policy has been fulfilled; 

III otherwise <value>false</value>. 

III </returns> 

III <remarks> 

III Resource is an optional parameter and may be null. Please ensure that you check 
III it is not null before acting upon it. 

III </remarks> 

Task<AuthorizationResult> AuthorizeAsync( 

ClaimsPrincipal user, object resource, string policyName); 


Yukarıdaki kod, lAuthorizationService'in iki yöntemini vurgular. 

IAuthorizationRequirement, yöntemi olmayan bir işaret hizmetidir ve yetkilendirme işleminin başarılı olup 
olmadığını izlemeye yönelik mekanizmaya yöneliktir. 

Her bir lAuthorizationHandler gereksinimlerin karşılanıp karşılanmadığını denetmaktan sorumludur: 






/// <summary> 

III Classes implementing this interface are able to make a decision if authorization 
III is allowed. 

III </summary> 

public interface IAuthorizationHandler 

{ 

III <summary> 

III Makes a decision if authorization is allowed. 

III </summary> 

III <param name="context">The authorization information.</param> 

Task HandleAsync(AuthorizationHandlerContext context); 

} 


AuthorizationHandlerContext sınıfı, işleyicinin gereksinimlerin karşılanıp karşılanmadığını işaretlemek için 
kullandığı şeydir: 

context.Succeed(requirement) 


Aşağıdaki kod, yetkilendirme hizmetinin Basitleştirilmiş (ve açıklamalar ile açıklamalı) varsayılan 
uygulamasını gösterir: 

public async Task<AuthorizationResult> AuthorizeAsync(ClaimsPrincipal üşer, 

object resource, IEnumerable<IAuthorizationRequirement> requirements) 

{ 

// Create a tracking context from the authorization inputs. 

var authContext = _contextFactory.CreateContext(requirements, user, resource); 

// By default this returns an IEnumerable<IAuthorizationHandlers> from DI. 
var handlers = await _handlers.GetHandlersAsync(authContext); 

// Invoke ali handlers. 
foreach (var handler in handlers) 

{ 

await handler.HandleAsync(authContext); 

} 

// Check the context, by default success is when ali requirements have been met. 
return _evaluator.Evaluate(authContext); 


Aşağıdaki kod tipik bir configureServices gösterir: 

public void ConfigureServices(IServiceCollection Services) 

{ 

// Add ali of your handlers to DI. 

Services.AddSingleton<IAuthorizationHandler, MyHandlerl>(); 

// MyHandler2, ... 

Services.AddSingleton<IAuthorizationHandler, MyHandlerN>(); 

// Configure your policies 
Services.AddAuthorization(options => 
options. AddPolicyC’Something", 

policy => policy.RequireClaim("Permission", "CanViewPage", "CanViewAnything"))); 

Services.AddControllersWithViews(); 

Services.AddRazorPages(); 







Yetkilendirme için lAuthorizationService veya [Authorize(Poiicy = "Something")] kullanın. 


MVC denetleyicilerine ilke uygulama 

Razor Pages kullanıyorsanız, bkz. bu belgedeki Razor Pages İlkeleri uygulama . 
ilkeler, ilke adı ile [Authorize] özniteliği kullanılarak denetleyicilere uygulanır. Örneğin: 

using Microsoft.AspNetCore.Authorization; 
using Microsoft.AspNetCore.Mvc; 

[Authorize(Policy = "AtLeast21")] 

public class AlcoholPurchaseController : Controller 
{ 

public IActionResult Index() => View(); 

} 


Razor Pages ilke uygulanıyor 

ilkeler, ilke adı ile [Authorize] özniteliği kullanılarak Razor Pages uygulanır.Örneğin: 

using Microsoft.AspNetCore.Authorization; 
using Microsoft.AspNetCore.Mvc.RazorPages; 

[Authorize(Policy = "AtLeast21")] 

public class AlcoholPurchaseModel : PageModel 

{ 

} 

ilkeler, Yetkilendirme kuralıkullanılarak Razor Pages da uygulanabilir. 

Gereksinimler 

Yetkilendirme gereksinimi, bir ilkenin geçerli kullanıcı sorumlusunu değerlendirmek için kullanabileceği 
veri parametreleri koleksiyonudur. "AtLeast21" ilkenizde, gereksinim minimum yaş—tek bir parametredir. 
Bir gereksinim, boş bir işaret arabirimi olan ıauthorizationrequirement'ı uygular. Parametreli en düşük yaş 
gereksinimi aşağıdaki gibi uygulanabilir: 

using Microsoft.AspNetCore.Authorization; 

public class MinimumAgeRequirement : IAuthorizationRequirement 
{ 

public int MinimumAge { get; } 

public MinimumAgeRequirement(int minimumAge) 

{ 

MinimumAge = minimumAge; 

} 

} 

Yetkilendirme ilkesi birden çok yetkilendirme gereksinimi içeriyorsa, ilke değerlendirmesinin başarılı 
olması için tüm gereksinimlerin geçmesi gerekir. Diğer bir deyişle, tek bir yetkilendirme ilkesine eklenen 
birden çok yetkilendirme gereksinimi bir ve temelinde değerlendirilir. 







NOTE 

Bir gereksinimin veri veya özellikleri olması gerekmez. 


Yetkilendirme işleyicileri 

Bir yetkilendirme işleyicisi, bir gereksinimin özelliklerinin değerlendirilmesinden sorumludur. Yetkilendirme 
işleyicisi, erişim izni verilip verilmediğini belirlemede, gereksinimleri belirtilen Authorizationhandlercontext 
'e göre değerlendirir. 

Bir gereksinimin birden çok işleyicisiolabilir. Bir işleyici, TRequirement işlenmesi gereken <TRequirement > 
authorizationhandler'ı devralınabilir. Alternatif olarak, bir işleyici birden fazla gereksinim türünü işlemek 
için lauthorizationhandler uygulayabilir. 

Bir gereksinim için bir işleyici kullanın 

Aşağıda, en az bir yaş işleyicisinin tek bir gereksinimin kullanıldığı bire bir ilişkiye örnek verilmiştir: 

using System; 

using System.Security.Claims; 
using System.Threading.Tasks; 
using Microsoft.AspNetCore.Authorization; 
using PoliciesAuthAppl.Services.Requirements; 

public class MinimumAgeHandler : AuthorizationHandler<MinimumAgeRequirement> 

{ 

protected override Task HandleRequirementAsync(AuthorizationHandlerContext context, 

MinimumAgeRequirement requirement) 

{ 

if (!context.User.HasClaim(c => c.Type == ClaimTypes.DateOfBirth && 

c.Issuer == "http://contoso.com")) 

{ 

//TODO: Use the following if targeting a version of 
//.NET Framework older than 4.6: 

// return Task.FromResult(0); 

return Task.CompletedTask; 

} 

var dateOfBirth = Convert.ToDateTime( 

context.User.FindFirst(c => c.Type == ClaimTypes.DateOfBirth && 

c.Issuer == "http://contoso.com").Value); 

int calculatedAge = DateTime.Today.Year - dateOfBirth.Year; 
if (dateOfBirth > DateTime.Today.AddYears(-calculatedAge)) 

{ 

calculatedAge--; 

} 

if (calculatedAge >= requirement.MinimumAge) 

{ 

context.Succeed(requirement); 

} 

//TODO: Use the following if targeting a version of 
//.NET Framework older than 4.6: 

// return Task.FromResult(0); 

return Task.CompletedTask; 

} 

} 

Önceki kod, geçerli kullanıcı sorumlusunun bilinen ve güvenilir bir veren tarafından verilen bir Doğum 
talebi tarihi olup olmadığını belirler. Talep eksik olduğunda yetkilendirme gerçekleşemez, bu durumda 






tamamlanan bir görev döndürülür. Bir talep bulunduğunda, kullanıcının yaşı hesaplanır. Kullanıcı 
gereksinim tarafından tanımlanan en düşük yaşı karşılıyorsa, Yetkilendirme başarılı olur. Yetkilendirme 
başarılı olduğunda, context.succeed tek parametresi olarak tatmin eden gereksinimle çağrılır. 

Birden çok gereksinim için bir işleyici kullanın 

Aşağıda, bir izin işleyicisinin üç farklı gereksinim türünü işleyebileceği bir çoktan çoğa ilişkiye örnek 
verilmiştir: 

using System.Linq; 

using System.Security.Claims; 

using System.Threading.Tasks; 

using Microsoft.AspNetCore.Authorization; 

using PoliciesAuthAppl.Services.Requirements; 

public class PermissionHandler : IAuthorizationHandler 

{ 

public Task HandleAsync(AuthorizationHandlerContext context) 

{ 

var pendingRequirements = context.PendingRequirements.ToList(); 

foreach (var requirement in pendingRequirements) 

{ 

if (requirement is ReadPermission) 

{ 

if (IsOwner(context.Userj context.Resource) | 

IsSponsor(context.User, context.Resource)) 

{ 

context.Succeed(requirement); 

} 

} 

else if (requirement is EditPermission ] 
requirement is DeletePermission) 

{ 

if (IsOwner(context.User, context.Resource)) 

{ 

context.Succeed(requirement); 

} 

} 

} 

//TODO: Use the following if targeting a version of 
//.NET Framework older than 4.6: 

// return Task.FromResult(0); 

return Task.CompletedTask; 

} 

private bool IsOwner(ClaimsPrincipal user, object resource) 

{ 

// Code omitted for brevity 
return true; 

} 

private bool IsSponsor(ClaimsPrincipal user, object resource) 

{ 

// Code omitted for brevity 
return true; 

} 

} 


Yukarıdaki kod, başarılı olarak işaretlenmemiş gereksinimleri içeren bir özellik— Pendingrequirements 'e 
geçer. ReadPermission gereksinim için, kullanıcı istenen kaynağa erişmek için bir sahip veya sponsor 
olmalıdır. Bir EditPermission veya DeletePermission gereksinimi söz konusu olduğunda, istenen kaynağa 









erişmek için sahip olması gerekir. 

İşleyici kaydı 

işleyiciler, yapılandırma sırasında hizmetler koleksiyonuna kaydedilir.Örneğin: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddControllersWithViews (); 

Services.AddRazorPages(); 

Services.AddAuthorization(options => 

{ 

options.AddPolicy("AtLeast21", policy => 

policy.Requirements.Add(new MinimumAgeRequirement(21))); 

}); 

Services.AddSingleton<IAuthorizationHandlerj MinimumAgeHandler>(); 

} 

Yukarıdaki kod, Services.AddSingleton<IAuthorizationHandlerj MinimumAgeHandler>(); çağırarak tek bir 
MinimumAgeHandler olarak kaydedilir. İşleyiciler, yerleşik hizmet yaşam sürelerininherhangi biri kullanılarak 
kaydedilebilir. 

İşleyici ne döndürmelidir? 

işleyici örnekteki Handie yönteminin hiçbir değer döndürmediğini unutmayın. Başarı ya da hatanın 
durumu nasıl belirtilir? 

• işleyici, başarıyla doğrulanan gereksinimi geçirerek 

context.Succeed(IAuthorizationRequirement requirement) çağırarak başarıyı gösterir. 

• Aynı gereksinim için diğer işleyiciler başarılı olabileceğinden, işleyicinin sorunları genellikle işlemesi 
gerekmez. 

• Diğer gereksinim işleyicileri başarılı olsa bile hatayı güvence altına almak için context.Faii çağırın. 

Bir işleyici context.succeed veya context.Fail çağırırsa, diğer tüm işleyiciler yine de çağırılır. Bu, başka bir 
işleyicinin bir gereksinimi başarıyla doğrulayan veya başarısız olsa bile, gereksinimlerin günlüğe kaydetme 
gibi yan etkileri üretmesine olanak tanır, faise olarak ayarlandığında, ınvokehandlersafterfailure özelliği 
(ASP.NET Core 1,1 ve üzeri sürümlerde bulunur) context.Faii çağrıldığında işleyicilerin yürütülmesi kısa 
devre dışı olur, true varsayılan olarak invokeHandiersAfterFailure , bu durumda tüm işleyiciler çağrılır. 


NOTE 

Yetkilendirme işleyicileri, kimlik doğrulama başarısız olsa bile çağrılır. 


Bir gereksinim için neden birden çok işleyici istiyorum? 

Değerlendirmenin bir veya temelinde olmasını istediğiniz durumlarda, tek bir gereksinim için birden çok 
işleyici uygulayın. Örneğin, Microsoft yalnızca ana kartlarla açık olan kapılara sahiptir. Ana kartınızı evden 
bırakırsanız, alıcı geçici bir etiket yazdırır ve kapıyı sizin için açar. Bu senaryoda, tek bir gereksinimi 
incelerken tek bir gereksinimin, Buildlngentry, ancak birden çok işleyici vardır. 


BuildingEntryRequirement.cs 













using Microsoft.AspNetCore.Authorization; 

public class BuildingEntryRequirement : IAuthorizationRequirement 

{ 

} 


BadgeEntryHandler.es 

using System.Security.Claims; 
using System.Threading.Tasks; 
using Microsoft.AspNetCore.Authorization; 
using PoliciesAuthAppl.Services.Requirements; 

public class BadgeEntryHandler : AuthorizationHandler<BuildingEntryRequirement> 

{ 

proteeted override Task HandleRequirementAsync(AuthorizationHandlerContext context, 

BuildingEntryRequirement requirement) 

{ 

if (context.User.HasClaim(c => c.Type == "Badgeld" && 

c.Issuer == "http://microsoftsecurity")) 

{ 

context.Succeed(requirement); 

} 

//TODO: Use the following if targeting a version of 
//.NET Framework older than 4.6: 

// return Task.FromResult(0); 

return Task.CompletedTask; 

} 

} 


TemporaryStickerHandler.es 

using System.Security.Claims; 
using System.Threading.Tasks; 
using Microsoft.AspNetCore.Authorization; 
using PoliciesAuthAppl.Services.Requirements; 

public class TemporaryStickerHandler : AuthorizationElandler<BuildingEntryRequirement> 

{ 

proteeted override Task HandleRequirementAsync(AuthorizationHandlerContext context, 

BuildingEntryRequirement requirement) 

{ 

if (context.User.HasClaim(c => c.Type == "TemporaryBadgeld" && 

c.Issuer == "https://microsoftsecurity")) 

{ 

// We'd also check the expiration date on the sticker. 
context.Succeed(requirement); 

} 

//TODO: Use the following if targeting a version of 
//.NET Framework older than 4.6: 

// return Task.FromResult(0); 

return Task.CompletedTask; 

} 

} 

Her iki işleyicinin de kaydedildiğindenemin olun. Bir ilke BuiidingEntryRequirement değerlendirdiğinde 
işleyicinin her ikisi de başarılı olursa, ilke değerlendirmesi başarılı olur. 


İlkeyi yerine getirmek için bir Func kullanma 






Kodun kodda hızlı bir şekilde kullanılması için bir ilkeyi karşıladığı durumlar olabilir, ilkenizi 
RequireAssertion ilkesi Oluşturucusu ile yapılandırırken bir Func<AuthorizationHandlerContext, bool> 
sağlamak mümkündür. 

Örneğin, önceki BadgeEntryHandler şu şekilde yeniden yazılabilir: 

Services. AddAuthorization(options => 

{ 

options.AddPolicy("BadgeEntry", policy => 
policy.RequireAssertion(context => 
context.User.HasClaim(c => 

(c.Type == "Badgeld" | 
c.Type == "TemporaryBadgeld") && 
c.Issuer == "https://microsoftsecurity"))); 

}); 


İşleyicilerde MVC istek bağlamına erişme 

Bir yetkilendirme işleyicisinde uyguladığınız HandieRequirementAsync yöntemi iki parametreye sahiptir: bir 
AuthorizationHandierContext ve işlemekte olduğunuz TRequirement . MVC veya Jabbr gibi çerçeveler, ek 
bilgi iletmek için AuthorizationHandierContext Resource özelliğine herhangi bir nesne eklemek ücretsizdir. 

Örneğin, MVC Resource özelliğinde Authorizationfiltercontext örneğini geçirir. Bu özellik HttpContext , 
RouteData ve MVC ve Razor Pages tarafından sağlanan diğer her şeye erişim sağlar. 

Resource özelliğinin kullanımı Framevvork 'e özgüdür. Resource özelliğindeki bilgilerin kullanılması, 
yetkilendirme ilkelerinizi belirli çerçeveler ile sınırlandırır, is anahtar sözcüğünü kullanarak Resource 
özelliğini atamaksınız ve sonra, kodunuzun diğer çerçeveler üzerinde çalıştırıldığında bir 
invaiidCastException kilitlenmediğinden emin olmak için dönüştürme başarılı olduğunu doğrulayın: 

// Requires the following import: 

// using Microsoft.AspNetCore.Mvc.Filters; 

if (context.Resource is AuthorizationFilterContext mvcContext) 

{ 

// Examine MVC-specific things like routing data. 

} 

Kapakların altında rol tabanlı yetkilendirme ve talep tabanlı yetkilendirme , bir gereksinim, gereksinim 
işleyicisi ve önceden yapılandırılmış bir ilke kullanır. Bu yapı taşları, koddaki yetkilendirme 
değerlendirmeleri ifadesini destekler. Sonuç daha zengin, yeniden kullanılabilir ve test edilebilir bir 
yetkilendirme yapısıdır. 

Yetkilendirme ilkesi bir veya daha fazla gereksinimden oluşur, startup.configureservices yönteminde 
yetkilendirme hizmeti yapılandırmasının bir parçası olarak kaydedilir: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

Services.AddAuthorization(options => 

{ 

options.AddPolicy("Atl_east21", policy => 

policy.Requirements.Add(new MinimumAgeRequirement(21))); 

}); 

} 


Yukarıdaki örnekte, "AtLeast21" ilkesi oluşturulur.Gereksinime bir parametre olarak sağlanan minimum 





















yaş—tek bir gereksinime sahiptir. 


lAuthorizationService 


Yetkilendirmenin başarılı olup olmadığını belirleyen birincil hizmet lAuthorizationService: 


/// <summary> 

III Checks policy based permissions for a user 
III </summary> 

public interface lAuthorizationService 

{ 

III <summary> 

III Checks if a user meets a specific set of requirements for the specified resource 
III </summary> 

III <param name="user">The user to evaluate the requirements against.</param> 

III <param name="resource"> 

III An optional resource the policy should be checked with. 

III If a resource is not required for policy evaluation you may pass null as the value 
III </param> 

III <param name="requirements">The requirements to evaluate.</param> 

III <returns> 

III A flag indicating whether authorization has succeeded. 

III This value is <value>true</value> when the user fulfills the policy; 

III otherwise <value>false</value>. 

III </returns> 

III <remarks> 

III Resource is an optional parameter and may be null. Please ensure that you check 
III it is not null before acting upon it. 

III </remarks> 

Task<AuthorizationResult> AuthorizeAsync(ClaimsPrincipal user, object resource, 

IEnumerable<IAuthorizationRequirement> requirements); 


} 


III <summary> 

III Checks if a user meets a specific authorization policy 
III </summary> 

III <param name="user">The user to check the policy against.</param> 

III <param name="resource"> 

III An optional resource the policy should be checked with. 

III If a resource is not required for policy evaluation you may pass null as the value 
III </param> 

III <param name="policyl\lame">The name of the policy to check against a specific 
III context.</param> 

III <returns> 

III A flag indicating whether authorization has succeeded. 

III Returns a flag indicating whether the user, and optional resource has fulfilled 
III the policy. 

III <value>true</value> when the policy has been fulfilled; 

III otherwise <value>false</value>. 

III </returns> 

III <remarks> 

III Resource is an optional parameter and may be null. Please ensure that you check 
III it is not null before acting upon it. 

III </remarks> 

Task<AuthorizationResult> AuthorizeAsync( 

ClaimsPrincipal user, object resource, string policyName); 


Yukarıdaki kod, lAuthorizationService'in iki yöntemini vurgular. 

IAuthorizationRequirement, yöntemi olmayan bir işaret hizmetidir ve yetkilendirme işleminin başarılı olup 
olmadığını izlemeye yönelik mekanizmaya yöneliktir. 

Her bir lAuthorizationHandler gereksinimlerin karşılanıp karşılanmadığını denetmaktan sorumludur: 



/// <summary> 

III Classes implementing this interface are able to make a decision if authorization 
III is allowed. 

III </summary> 

public interface IAuthorizationHandler 

{ 

III <summary> 

III Makes a decision if authorization is allowed. 

III </summary> 

III <param name="context">The authorization information.</param> 

Task HandleAsync(AuthorizationHandlerContext context); 

} 


AuthorizationHandlerContext sınıfı, işleyicinin gereksinimlerin karşılanıp karşılanmadığını işaretlemek için 
kullandığı şeydir: 

context.Succeed(requirement) 


Aşağıdaki kod, yetkilendirme hizmetinin Basitleştirilmiş (ve açıklamalar ile açıklamalı) varsayılan 
uygulamasını gösterir: 


public async Task<AuthorizationResult> AuthorizeAsync(ClaimsPrincipal üşer, 

object resource, IEnumerable<IAuthorizationRequirement> requirements) 

{ 

// Create a tracking context from the authorization inputs. 

var authContext = _contextFactory.CreateContext(requirements, user, resource); 

// By default this returns an IEnumerable<IAuthorizationHandlers> from DI. 
var handlers = await _handlers.GetHandlersAsync(authContext); 

// Invoke ali handlers. 
foreach (var handler in handlers) 

{ 

await handler.HandleAsync(authContext); 

} 

// Check the context, by default success is when ali requirements have been met. 
return _evaluator.Evaluate(authContext); 


Aşağıdaki kod tipik bir configureServices gösterir: 

public void ConfigureServices(IServiceCollection Services) 

{ 

// Add ali of your handlers to DI. 

Services.AddSingleton<IAuthorizationHandler, MyHandlerl>(); 

// MyHandler2, ... 

Services.AddSingleton<IAuthorizationHandler, MyHandlerN>(); 

// Configure your policies 
Services.AddAuthorization(options => 
options. AddPolicyC’Something", 

policy => policy.RequireClaim("Permission", "CanViewPage", "CanViewAnything"))); 


Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

} 


Yetkilendirme için lAuthorizationService veya [Authorize(Poiicy = "Something")] kullanın. 








MVC denetleyicilerine ilke uygulama 

Razor Pages kullanıyorsanız, bkz. bu belgedeki Razor Pages İlkeleri uygulama . 
ilkeler, ilke adı ile [Authorize] özniteliği kullanılarak denetleyicilere uygulanır. Örneğin: 

using Microsoft.AspNetCore.Authorization; 
using Microsoft.AspNetCore.Mvc; 

[Authorize(Policy = "AtLeast21")] 

public class AlcoholPurchaseController : Controller 
{ 

public IActionResult Index() = > View(); 

} 


Razor Pages ilke uygulanıyor 

ilkeler, ilke adı ile [Authorize] özniteliği kullanılarak Razor Pages uygulanır.Örneğin: 

using Microsoft.AspNetCore.Authorization; 
using Microsoft.AspNetCore.Mvc.RazorPages; 

[Authorize(Policy = "AtLeast21")] 

public class AlcoholPurchaseModel : PageModel 

{ 

} 

ilkeler, Yetkilendirme kuralıkullanılarak Razor Pages da uygulanabilir. 

Gereksinimler 

Yetkilendirme gereksinimi, bir ilkenin geçerli kullanıcı sorumlusunu değerlendirmek için kullanabileceği 
veri parametreleri koleksiyonudur. "AtLeast21" ilkenizde, gereksinim minimum yaş—tek bir parametredir. 
Bir gereksinim, boş bir işaret arabirimi olan ıauthorizationrequirement'ı uygular. Parametreli en düşük yaş 
gereksinimi aşağıdaki gibi uygulanabilir: 

using Microsoft.AspNetCore.Authorization; 

public class MinimumAgeRequirement : IAuthorizationRequirement 
{ 

public int MinimumAge { get; } 

public MinimumAgeRequirement(int minimutnAge) 

{ 

MinimumAge = minimumAge; 

} 

} 

Yetkilendirme ilkesi birden çok yetkilendirme gereksinimi içeriyorsa, ilke değerlendirmesinin başarılı 
olması için tüm gereksinimlerin geçmesi gerekir. Diğer bir deyişle, tek bir yetkilendirme ilkesine eklenen 
birden çok yetkilendirme gereksinimi bir ve temelinde değerlendirilir. 


NOTE 

Bir gereksinimin veri veya özellikleri olması gerekmez. 







Yetkilendirme işleyicileri 

Bir yetkilendirme işleyicisi, bir gereksinimin özelliklerinin değerlendirilmesinden sorumludur. Yetkilendirme 
işleyicisi, erişim izni verilip verilmediğini belirlemede, gereksinimleri belirtilen Authorizationhandlercontext 
'e göre değerlendirir. 

Bir gereksinimin birden çok işleyicisiolabilir. Bir işleyici, TRequirement işlenmesi gereken <TRequirement > 
authorizationhandler'ı devralınabilir. Alternatif olarak, bir işleyici birden fazla gereksinim türünü işlemek 
için lauthorizationhandler uygulayabilir. 

Bir gereksinim için bir işleyici kullanın 

Aşağıda, en az bir yaş işleyicisinin tek bir gereksinimin kullanıldığı bire bir ilişkiye örnek verilmiştir: 

using System; 

using System.Security.Claims; 
using System.Threading.Tasks; 
using Microsoft.AspNetCore.Authorization; 
using PoliciesAuthAppl.Services.Requirements; 

public class MinimumAgeHandler : AuthorizationHandler<MinimumAgeRequirement> 

{ 

protected override Task HandleRequirementAsync(AuthorizationHandlerContext context, 

MinimumAgeRequirement requirement) 

{ 

if (!context.User.HasClaim(c => c.Type == ClaimTypes.DateOfBirth && 

c.Issuer == "http://contoso.com")) 

{ 

//TODO: Use the following if targeting a version of 
//.NET Framework older than 4.6: 

// return Task.FromResult(0); 

return Task.CompletedTask; 

} 

var dateOfBirth = Convert.ToDateTime( 

context.User.FindFirst(c => c.Type == ClaimTypes.DateOfBirth && 

c.Issuer == "http://contoso.com").Value); 

int calculatedAge = DateTime.Today.Year - dateOfBirth.Year; 
if (dateOfBirth > DateTime.Today.AddYears(-calculatedAge)) 

{ 

calculatedAge--; 

} 

if (calculatedAge >= requirement.MinimumAge) 

{ 

context.Succeed(requirement); 

} 

//TODO: Use the following if targeting a version of 
//.NET Framework older than 4.6: 

// return Task.FromResult(0); 

return Task.CompletedTask; 

} 

} 

Önceki kod, geçerli kullanıcı sorumlusunun bilinen ve güvenilir bir veren tarafından verilen bir Doğum 
talebi tarihi olup olmadığını belirler. Talep eksik olduğunda yetkilendirme gerçekleşemez, bu durumda 
tamamlanan bir görev döndürülür. Bir talep bulunduğunda, kullanıcının yaşı hesaplanır. Kullanıcı 
gereksinim tarafından tanımlanan en düşük yaşı karşılıyorsa, Yetkilendirme başarılı olur. Yetkilendirme 
başarılı olduğunda, context.succeed tek parametresi olarak tatmin eden gereksinimle çağrılır. 

Birden çok gereksinim için bir işleyici kullanın 







Aşağıda, bir izin işleyicisinin üç farklı gereksinim türünü işleyebileceği bir çoktan çoğa ilişkiye örnek 
verilmiştir: 

using System.Linq; 

using System.Security.Claims; 

using System.Threading.Tasks; 

using Microsoft.AspNetCore.Authorization; 

using PoliciesAuthAppl.Services.Requirements; 

public class PermissionHandler : IAuthorizationHandler 

{ 

public Task HandleAsync(AuthorizationHandlerContext context) 

{ 

var pendingRequirements = context.PendingRequirements.ToList(); 

foreach (var requirement in pendingRequirements) 

{ 

if (requirement is ReadPermission) 

{ 

if (IsOwner(context.Userj context.Resource) | 

IsSponsor(context.User, context.Resource)) 

{ 

context.Succeed(requirement); 

} 

} 

else if (requirement is EditPermission | 
requirement is DeletePermission) 

{ 

if (IsOwner(context.User, context.Resource)) 

{ 

context.Succeed(requirement); 

} 

} 

} 

//TODO: Use the following if targeting a version of 
//.NET Framework older than 4.6: 

// return Task.FromResult(0); 

return Task.CompletedTask; 

} 

private bool IsOwner(ClaimsPrincipal user, object resource) 

{ 

// Code omitted for brevity 
return true; 

} 

private bool IsSponsor(ClaimsPrincipal user, object resource) 

{ 

// Code omitted for brevity 
return true; 

} 

} 


Yukarıdaki kod, başarılı olarak işaretlenmemiş gereksinimleri içeren bir özellik— Pendingrequirements 'e 
geçer. ReadPermission gereksinim için, kullanıcı istenen kaynağa erişmek için bir sahip veya sponsor 
olmalıdır. Bir EditPermission veya DeletePermission gereksinimi söz konusu olduğunda, istenen kaynağa 
erişmek için sahip olması gerekir. 

İşleyici kaydı 

işleyiciler, yapılandırma sırasında hizmetler koleksiyonuna kaydedilir.Örneğin: 






public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

Services.AddAuthorization(options => 

{ 

options.AddPolicy("Atl_east21", policy => 

policy.Requirements.Add(new MinimumAgeRequirement(21))); 

}); 

Services .AddSingletoiKlAuthorizationHandler, MinimumAgeHandler>(); 

} 

Yukarıdaki kod, Services. AddSingletorKlAuthorizationHandler., MinimumAgeHandler>(); çağırarak tek bir 
MinimumAgeHandler olarak kaydedilir, işleyiciler, yerleşik hizmet yaşam sürelerininherhangi biri kullanılarak 
kaydedilebilir. 

İşleyici ne döndürmelidir? 

işleyici örnekteki Handie yönteminin hiçbir değer döndürmediğini unutmayın. Başarı ya da hatanın 
durumu nasıl belirtilir? 

• İşleyici, başarıyla doğrulanan gereksinimi geçirerek 

context.Succeed(IAuthorizationRequirement requirement) çağırarak başarıyı gösterir. 

• Aynı gereksinim için diğer işleyiciler başarılı olabileceğinden, işleyicinin sorunları genellikle işlemesi 
gerekmez. 

• Diğer gereksinim işleyicileri başarılı olsa bile hatayı güvence altına almak için context.Faii çağırın. 

Bir işleyici context.succeed veya context.Fail çağırırsa, diğer tüm işleyiciler yine de çağırılır. Bu, başka bir 
işleyicinin bir gereksinimi başarıyla doğrulayan veya başarısız olsa bile, gereksinimlerin günlüğe kaydetme 
gibi yan etkileri üretmesine olanak tanır, faise olarak ayarlandığında, ınvokehandlersafterfailure özelliği 
(ASP.NET Corel.l ve üzeri sürümlerde bulunur) context.Faii çağrıldığında işleyicilerin yürütülmesi kısa 
devre dışı olur, true varsayılan olarak invokeHandiersAfterFailure , bu durumda tüm işleyiciler çağrılır. 


NOTE 

Yetkilendirme işleyicileri, kimlik doğrulama başarısız olsa bile çağrılır. 


Bir gereksinim için neden birden çok işleyici istiyorum? 

Değerlendirmenin bir veya temelinde olmasını istediğiniz durumlarda, tek bir gereksinim için birden çok 
işleyici uygulayın. Örneğin, Microsoft yalnızca ana kartlarla açık olan kapılara sahiptir. Ana kartınızı evden 
bırakırsanız, alıcı geçici bir etiket yazdırır ve kapıyı sizin için açar. Bu senaryoda, tek bir gereksinimi 
incelerken tek bir gereksinimin, Buildingentry, ancak birden çok işleyici vardır. 

B uild ing E ntryReq uirement.es 

using Microsoft.AspNetCore.Authorization; 

public elass BuildingEntryRequirement : IAuthorizationRequirement 
{ 

} 


BadgeEntryHandler.es 












using System.Security.Claims; 
using System.Threading.Tasks; 
using Microsoft.AspNetCore.Authorization; 
using PoliciesAuthAppl.Services.Requirements; 

public class BadgeEntryHandler : AuthorizationHandler<BuildingEntryRequirement> 

{ 

protected override Task HandleRequirementAsync(AuthorizationHandlerContext context, 

BuildingEntryRequirement requirement) 

{ 

if (context.User.HasClaim(c => c.Type == "Badgeld" && 

c.Issuer == "http://microsoftsecurity")) 

{ 

context.Succeed(requirement); 

} 

//TODO: Use the following if targeting a version of 
//.NET Framework older than 4.6: 

// return Task.FromResult(0); 

return Task.CompletedTask; 

} 

} 


TemporaryStickerHandler.es 

using System.Security.Claims; 
using System.Threading.Tasks; 
using Microsoft.AspNetCore.Authorization; 
using PoliciesAuthAppl.Services.Requirements; 

public class TemporaryStickerHandler : AuthorizationHandler<BuildingEntryRequirement> 

{ 

protected override Task HandleRequirementAsync(AuthorizationHandlerContext context, 

BuildingEntryRequirement requirement) 

{ 

if (context.User.HasClaim(c => c.Type == "TemporaryBadgeld" && 

c.Issuer == "https://microsoftsecurity")) 

{ 

// We'd also check the expiration date on the sticker. 
context.Succeed(requirement); 

} 

//TODO: Use the following if targeting a version of 
//.NET Framework older than 4.6: 

// return Task.FromResult(0); 

return Task.CompletedTask; 

} 

} 

Her iki işleyicinin de kaydedildiğindenemin olun. Bir ilke BuiidingEntryRequirement değerlendirdiğinde 
işleyicinin her ikisi de başarılı olursa, ilke değerlendirmesi başarılı olur. 

İlkeyi yerine getirmek için bir Func kullanma 

Kodun kodda hızlı bir şekilde kullanılması için bir ilkeyi karşıladığı durumlar olabilir, ilkenizi 
RequireAssertion ilkesi Oluşturucusu ile yapılandırırken bir Func<AuthorizationHandlerContext., bool> 
sağlamak mümkündür. 

Örneğin, önceki BadgeEntryHandler şu şekilde yeniden yazılabilir: 








Services.AddAuthorization(options => 

{ 

options.AddPolicy("BadgeEntry", policy => 
policy.RequireAssertion(context => 
context.User.HasClaim(c => 

(c.Type == "Badgeld" | 
c.Type == "TemporaryBadgeld") && 
c.Issuer == "https://microsoftsecurity"))); 

}); 


İşleyicilerde MVC istek bağlamına erişme 

Bir yetkilendirme işleyicisinde uyguladığınız HandieRequirementAsync yöntemi iki parametreye sahiptir: bir 
AuthorizationHandierContext ve işlemekte olduğunuz TRequirement . MVC veya Jabbr gibi çerçeveler, ek 
bilgi iletmek için AuthorizationHandierContext Resource özelliğine herhangi bir nesne eklemek ücretsizdir. 

Örneğin, MVC Resource özelliğinde Authorizationfiltercontext örneğini geçirir. Bu özellik HttpContext , 
RouteData ve MVC ve Razor Pages tarafından sağlanan diğer her şeye erişim sağlar. 

Resource özelliğinin kullanımı Framevvork 'e özgüdür. Resource özelliğindeki bilgilerin kullanılması, 
yetkilendirme ilkelerinizi belirli çerçeveler ile sınırlandırır, is anahtar sözcüğünü kullanarak Resource 
özelliğini atamaksınız ve sonra, kodunuzun diğer çerçeveler üzerinde çalıştırıldığında bir 
invaiidCastException kilitlenmediğinden emin olmak için dönüştürme başarılı olduğunu doğrulayın: 

// Requires the following import: 

// using Microsoft.AspNetCore.Mvc.Filters; 

if (context.Resource is AuthorizationFilterContext mvcContext) 

{ 

// Examine MVC-specific things like routing data. 

} 
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, Mike Rousos tarafından 

Genellikle ilke tabanlı yetkilendirmekullanılırken, ilkeler, yetkilendirme hizmeti yapılandırmasının bir parçası olarak 
AuthorizationOptions.AddPolicy çağırarak kaydedilir. Bazı senaryolarda, tüm yetkilendirme ilkelerini bu şekilde 
kaydetmek mümkün olmayabilir (veya istenebilir). Bu durumlarda, yetkilendirme ilkelerinin nasıl sağlanmış 
olduğunu denetlemek için özel bir iAuthorizationPoiicyProvider kullanabilirsiniz. 

Özel bir lauthorizationpolicyprovider yararlı olabilecek senaryolara örnek olarak şunlar verilebilir: 

• ilke değerlendirmesi sağlamak için bir dış hizmet kullanma. 

• Büyük bir ilke yelpazesi (örneğin, farklı oda numaraları veya yaşlar için) kullanarak, her bireysel yetkilendirme 
ilkesini bir AuthorizationOptions.AddPolicy çağrısıyla eklemek mantıklı değildir. 

• Dış veri kaynağındaki bilgilere (bir veritabanı gibi) göre veya başka bir mekanizmaya göre yetkilendirme 
gereksinimlerini dinamik olarak belirleyerek çalışma zamanında ilkeler oluşturma. 

Aspnetcore GitHub deposundan örnek kodu görüntüleyin veya indirin . ASPNET/AspNetCore depo ZIP dosyasını 
indirin. Dosyayı sıkıştırmayı açın. Src/Security/Samples/CustomPolicyProvider proje klasörüne gidin. 

İlke almayı özelleştirme 

ASP.NET Core uygulamalar, yetkilendirme ilkelerini almak için iAuthorizationPoiicyProvider arabiriminin bir 
uygulamasını kullanır. Varsayılan olarak, Defaultauthorizationpolicyprovider kaydedilir ve kullanılır. 
DefaultAuthorizationPolicyProvider , IServiceCollection.AddAuthorization çağrısında sunulan 
AuthorizationOptions ilkeleri döndürür. 

Uygulamanın bağımlılık ekleme kapsayıcısına farklı bir iAuthorizationPoiicyProvider uygulaması kaydederek bu 
davranışı özelleştirin. 

iAuthorizationPoiicyProvider arabirimi üçAPI içerir: 

• Getpolicyasync , belirli bir ad için yetkilendirme ilkesi döndürüyor. 

• Getdefaultpolicyasync varsayılan yetkilendirme ilkesini döndürür (ilke belirtilmeden [Authorize] öznitelikleri 
için kullanılan ilke). 

• Getfallbackpolicyasync , geri dönüş yetkilendirme ilkesini döndürür (İlke belirtilmediğinde yetkilendirme ara 
yazılımı tarafından kullanılan ilke). 

Bu API 'Leri uygulayarak, yetkilendirme ilkelerinin nasıl sağlandığını özelleştirebilirsiniz. 

Parametreli yetkilendirme özniteliği örneği 

iAuthorizationPoiicyPnovider yararlı olduğu bir senaryo, gereksinimleri bir parametreye bağlı olan özel 
[Authorize] özniteliklerinin etkinleştirilmesini sağlar. Örneğin, ilke tabanlı yetkilendirme belgelerinde, örnek olarak 
yaş tabanlı ("AtLeast21") ilkesi kullanılmıştır. Bir uygulamadaki farklı denetleyici eylemleri farkU yaştaki kullanıcılar 
için kullanılabilir hale getirilse, çok sayıda farklı yaş tabanlı ilke olması faydalı olabilir. Uygulamanın 
AuthorizationOptions ihtiyaç duyduğu tüm farklı yaş tabanlı ilkeleri kaydetmek yerine, ilkeleri özel bir 
iAuthorizationPoiicyProvider dinamik olarak oluşturabilirsiniz, ilkeleri kullanmak daha kolay hale getirmek için 











[MinimumAgeAuthorize(2@) ] gibi özel yetkilendirme özniteliğiyle eylemlere not ekleyebilirsiniz. 


Özel yetkilendirme öznitelikleri 

Yetkilendirme ilkeleri adlarıyla tanımlanır. Daha önce açıklanan özel MinimumAgeAuthorizeAttribute bağımsız 
değişkenlerin, ilgili yetkilendirme ilkesini almak için kullanılabilecek bir dizeye eşlenmesi gerekir. Bunu, 
AuthorizeAttribute türeterekve Age özelliğinin AuthorizeAttribute.Policy özelliğini sarmasını sağlayarak 
yapabilirsiniz. 

internal class MinimumAgeAuthorizeAttribute : AuthorizeAttribute 
{ 

const string POLICY_PREFIX = "MinimumAge"; 

public MinimumAgeAuthorizeAttribute(int age) => Age = age; 

// Get or set the Age property by manipulating the underlying Policy property 
public int Age 
{ 

get 

{ 

if (int.TryParse(Policy.Substring(POLICY_PREFIX.Length), out var age)) 

{ 

return age; 

} 

return default(int); 

} 

set 

{ 

Policy = $"{POLICY_PREFIX}{value.ToString()}"; 

} 

} 

} 

Bu öznitelik türü, sabit kodlanmış ön eki ( "MinimumAge" ) ve Oluşturucu aracılığıyla geçirilen bir tamsayıyı temel 
alan bir Policy dizesine sahiptir. 

Bir parametre olarak bir tamsayı almak dışında diğer Authorize öznitelikleriyle aynı şekilde eylemlere 
uygulayabilirsiniz. 

[MinimumAgeAuthorize(10)] 

public IActionResult RequiresMinimumAge!0() 


Özel lauthorizationpolicyprovider 

Özel MinimumAgeAuthorizeAttribute , istenen en düşük yaş için yetkilendirme ilkeleri istemeyi kolaylaştırır. Çözecek 
bir sonraki sorun, yetkilendirme ilkelerinin tüm bu farklı yaşlar için kullanılabilir olduğundan emin olmanızı sağlar. 
Burada iAuthorizationPoiicyProvider yararlı olur. 

MinimumAgeAuthorizationAttribute kullanırken, yetkilendirme ilkesi adları "MinimumAge" + Age , bu nedenle özel 
iAuthorizationPoiicyProvider yetkilendirme ilkeleri oluşturması gerekir: 

• ilke adından yaş ayrıştırılıyor. 

• Yeni bir AuthorizationPoücy oluşturmak için AuthorizationPolicyBuiider kullanma 

• Bu ve aşağıdaki örneklerde, kullanıcının kimliğinin bir tanımlama bilgisi aracılığıyla doğrulandığını varsayacaktır. 
AuthorizationPolicyBuiider , en az bir yetkilendirme düzeni adıyla oluşturulmalıdır veya her zaman başarılı olur. 

Aksi takdirde, kullanıcıya nasıl bir sınama sağlayacaksınız ve bir özel durum oluşturulur. 

• AuthorizationPolicyBuiider.AddRequirements yaş temelinde ilkeye gereksinimler ekleme. Diğer senaryolarda, 

















bunun yerine RequireClaim , RequireRole veya RequireUserName kullanabilirsiniz. 

internal class MinimumAgePolicyProvider : IAuthorizationPolicyProvider 

{ 

const string POLICY_PREFIX = "MinimumAge"; 

// Policies are looked up by string name, so expect 'parameters' (like age) 

// to be embedded in the policy names. This is abstracted away from developers 
// by the more strongly-typed attributes derived from AuthorizeAttribute 
// (like [MinimumAgeAuthorize()] in this sample) 
public Task<AuthorizationPolicy> GetPolicyAsync(string policyName) 

{ 

if (policyName.StartsWith(POLICY_PREFIX, StringComparison.OrdinalIgnoreCase) && 
int.TryParse(policyName.Substring(POLICY_PREFIX.Length ), out var age)) 

{ 

var policy = new AuthorizationPolicyBuilder(CookieAuthenticationDefaults.AuthenticationScheme); 
policy.AddRequirements(new MinimumAgeRequirement(age)); 
return Task.FromResult(policy.Build()); 

} 

return Task.FromResult<AuthorizationPolicy>(null); 

} 

} 


Birden çok yetkilendirme ilkesi sağlayıcısı 

Özel IAuthorizationPolicyProvider uygulamalarını kullanırken, ASP.N ET Core yalnızca bir 
IAuthorizationPolicyProvider örneği kullandığını aklınızda bulundurun. Özel bir sağlayıcı kullanılacak tüm ilke 
adları için yetkilendirme ilkeleri sağlayamıyorsa, bu, bir yedekleme sağlayıcısına ertelemelidir. 

Örneğin, özel yaş ilkelerine ve daha geleneksel rol tabanlı ilke almaya ihtiyacı olan bir uygulamayı düşünün. Bu tür 
bir uygulama, özel bir yetkilendirme ilkesi sağlayıcısını şu şekilde kullanabilir: 

• ilke adlarını ayrıştırmaya çalışır. 

• ilke adı bir yaş içermiyorsa farklı bir ilke sağlayıcısına ( DefaultAuthorizationPolicyProvider gibi) çağırır. 

Yukarıda gösterilen örnek IAuthorizationPolicyProvider uygulama, oluşturucusunda bir yedekleme ilkesi 
sağlayıcısı oluşturarak DefaultAuthorizationPolicyProvider kullanacak şekilde güncelleştirilemeyebilir (ilke adı, 
beklenen 1 MinimumAge 1 + Age 1 i ile eşleşmediği durumlarda kullanılmak üzere). 

private DefaultAuthorizationPolicyProvider BackupPolicyProvider { get; } 

public MinimumAgePolicyProvider(IOptions<AuthorizationOptions> options) 

{ 

// ASP.NET Core only uses one authorization policy provider, so if the custom implementation 
// doesn’t handle ali policies it should fail back to an alternate provider. 

BackupPolicyProvider = new DefaultAuthorizationPolicyProvider(options); 

} 

Daha sonra, GetPolicyAsync yöntemi null döndürmek yerine BackupPolicyProvider kullanacak şekilde 
yapılandırılabilir: 

return BackupPolicyProvider.GetPolicyAsync(policyName); 


Varsayılan ilke 


Adlandırılmış Yetkilendirme ilkeleri sağlamaya ek olarak, bir ilke adı belirtmeden [Authorize] özniteliklerine bir 















yetkilendirme ilkesi sağlamak için özel bir iAuthorizationPoiicyProvider GetDefaultPolicyAsync uygulaması 
gerekir. 

Çoğu durumda, bu yetkilendirme özniteliği yalnızca kimliği doğrulanmış bir kullanıcı gerektirir, bu nedenle gerekli 
ilkeyi RequireAuthenticateduser çağrısı yapabilirsiniz: 

public Task<AuthorizationPolicy> GetDefaultPolicyAsync() => 

Task.FromResult(new 

AuthorizationPolicyBuilder(CookieAuthenticationDefaults.AuthenticationScheme).RequireAuthenticatedUser().Build( 
)); 

Özel bir iAuthorizationPoiicyProvider tüm yönleriyle olduğu gibi, bunu gerektiği şekilde özelleştirebilirsiniz. Bazı 
durumlarda, varsayılan ilkenin geri dönüş iAuthorizationPoiicyProvider alınması istenebilir. 

Geri dönüş ilkesi 

Özel bir iAuthorizationPoiicyProvider , ilkeler birleştirirken ve hiçbir ilke belirtilmediğinde kullanılan bir ilke 
sağlamak için isteğe bağlı olarak GetFaiibackPolicyAsync uygulayabilir. GetFaiibackPolicyAsync null olmayan bir 
ilke döndürürse, istek için hiçbir ilke belirtilmediğinde, döndürülen ilke yetkilendirme ara yazılımı tarafından 
kullanılır. 

Geri dönüş ilkesi gerekmiyorsa, sağlayıcı null döndürebilir veya geri dönüş sağlayıcısına erteleyebilirsiniz: 

public Task<AuthorizationPolicy> GetFallbackPolicyAsync() => 

Task.FromResultcAuthorizationPolicy>(null); 


Özel bir lauthorizationpolicyprovider kullanın 

Bir iAuthorizationPoiicyProvider özel ilkeleri kullanmak için şunları yapmanız gerekir: 

• Uygun AuthorizationHandler türlerini, tüm ilke tabanlı yetkilendirme senaryolarında olduğu gibi bağımlılık 
ekleme ( ilke tabanlı yetkilendirmebölümünde açıklanmıştır) ile kaydedin. 

• Varsayılan ilke sağlayıcısını değiştirmek için, özel iAuthorizationPoiicyProvider türünü uygulamanın bağımlılık 
ekleme hizmeti koleksiyonuna kaydedin ( startup.configureServices ). 

Services.AddSingletoncIAuthorizationPolicyProvider, MinimumAgePolicyProvider>(); 

Tüm özel iAuthorizationPoiicyProvider örnekleri, ASPNET/AuthSamples GitHub deposundabulunur. 















ASPNET core'da gereksinim işleyicilerine bağımlılık 
ekleme 
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Yetkilendirme işleyicileri kaydedilmelidir yapılandırma sırasında hizmet koleksiyondaki (kullanarak bağımlılık 
ekleme). 

Bir yetkilendirme işleyicisi değerlendirilecek istiyordu kurallarının bir depo olan varsayalım ve bu depo hizmeti 
koleksiyonda kaydedildi. Yetkilendirme çözümleyin ve bu, oluşturucuya ekleme. 

Örneğin, AS P kullanmakistiyorsamz.NET eklemesine isteyeceğiniz altyapı günlüğü iLoggerFactory işleyicinizi 
içine. Böyle bir işleyici aşağıdaki gibi görünmelidir: 

public class LoggingAuthorizationHandler : AuthorizationHandler<MyRequirement> 

{ 

ILogger _logger; 

public LoggingAuthorizationHandler(ILoggerFactory loggerFactory) 

{ 

_logger = loggerFactory.CreateLogger(this.GetType().FullName); 

} 

protected override Task HandleRequirementAsync(AuthorizationHandlerContext context, MyRequirement 
requirement) 

{ 

_logger.LogInformation("Inside my handler"); 

// Check if the requirement is fulfilled. 
return Task.CompletedTask; 

} 

} 

işleyici ile kaydetmek Services. AddSingletonO : 

Services.AddSingletoncIAuthorizationHandler, LoggingAuthorizationHandler>(); 
işleyici, uygulamanız başlatıldığında oluşturulması örneğini ve kayıtlı ekleme Dİ ILoggerFactory atladığından içine. 


NOTE 

Entity Framevvork kullanan işleyicileri teklileri kayıtlı olması gerekir. 
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Yetkilendirme stratejisi erişilmekte olan kaynağa bağlıdır. Yazar özelliği olan bir belge düşünün. Yalnızca yazarın 
belgeyi güncelleştirmesine izin verilir. Sonuç olarak, yetkilendirme değerlendirmesi gerçekleşebilmesi için belgenin 
veri deposundan alınması gerekir. 

Öznitelik değerlendirmesi, veri bağlamadan önce ve belgeyi yükleyen sayfa işleyicisinin veya eylemin yürütmeden 
önce oluşur. Bu nedenlerden dolayı, bir [Authorize] özniteliği ile bildirime dayalı yetkilendirme yok olacaktır. 
Bunun yerine, zorunlu Yetkilendirmeolarak bilinen —a stili özel bir yetkilendirme yöntemi çağırabilirsiniz. 

Örnek kodu görüntüleyin veya indirin (nasıl indirilir). 

Örnek kodu görüntüleyin veya indirin (nasıl indirilir). 

Örnek kodu görüntüleyin veya indirin (nasıl indirilir). 

Yetkilendirme ile korunan kullanıcı verileriyle ASP.NET Core uygulama oluşturma kaynak tabanlı yetkilendirme 
kullanan bir örnek uygulama içerir. 

Kesinlik temelli yetkilendirme kullan 

Yetkilendirme bir lAuthorizationService hizmeti olarak uygulanır ve startup sınıfı içindeki hizmet koleksiyonuna 
kaydedilir. Hizmet, sayfa işleyicilere veya eylemlere bağımlılık ekleme yoluyla kullanılabilir hale getirilir. 

public class DocumentController : Controller 
{ 

private readonly lAuthorizationService _authorizationService; 
private readonly IDocumentRepository _documentRepository; 

public DocumentController (lAuthorizationService authorizationService, 

IDocumentRepository documentRepository) 

{ 

_authorizationService = authorizationService; 

_documentRepository = documentRepository; 

} 

lAuthorizationService iki AuthorizeAsync yöntemi aşırı yüklemesi vardır: kaynağın ve ilke adının yanı sıra kaynağı 
kabul eden diğeri, değerlendirmek için gereksinimlerin bir listesi. 

Task<AuthorizationResult> AuthorizeAsync(ClaimsPrincipal user, 

object resource, 

IEnumerable<IAuthorizationRequirement> requirements); 

Task<AuthorizationResult> AuthorizeAsync(ClaimsPrincipal user, 

object resource, 
string policyName); 


Task<bool> AuthorizeAsync(ClaimsPrincipal üşer, 

object resource, 

IEnumerable<IAuthorizationRequirement> requirements); 
Task<bool> AuthorizeAsync(ClaimsPrincipal user, 

object resource, 
string policyName); 









Aşağıdaki örnekte, güvenli hale getirilme kaynağı özel bir Document nesnesine yüklenir. Geçerli kullanıcının 
belirtilen belgeyi düzenlemesine izin verilip verilmeyeceğini belirlemekte bir AuthorizeAsync aşırı yüklemesi 
çağrılır. Özel bir "EditPolicy" yetkilendirme ilkesi karara göre belirlenir. Yetkilendirme ilkeleri oluşturma hakkında 
daha fazla bilgi için bkz. özel ilke tabanlı yetkilendirme . 


NOTE 

Aşağıdaki kod örnekleri, kimlik doğrulamasının çalıştırıldığını varsayar ve User özelliğini ayarlar. 


public async Task<IActionResult> OnGetAsync(Guid documentld) 

{ 

Document = _documentRepository.Find(documentld); 

if (Document == null) 

{ 

return new NotFoundResult(); 

} 


var authorizationResult = await _authorizationService 
.AuthorizeAsync(User, Document, "EditPolicy"); 


} 


if (authorizationResult.Succeeded) 

{ 

return Page(); 

} 

else if (User.Identity.IsAuthenticated) 

{ 


return new ForbidResult(); 

} 


else 

{ 

return new ChallengeResult(); 

} 


[HttpGet] 

public async Task<IActionResult> Edit(Guid documentld) 

{ 

Document document = _documentRepository.Find(documentld); 

if (document == null) 

{ 

return new NotFoundResult(); 

} 

if (await _authorizationService 

.AuthorizeAsync(User, document, "EditPolicy")) 

{ 

return View(document); 

} 

else 

{ 

return new ChallengeResult(); 

} 


Kaynak tabanlı işleyici yazma 

Kaynak tabanlı yetkilendirme için bir işleyici yazmak, düz gereksinimler işleyicisi yazmaktançok farklı değildir. Özel 
bir gereksinim sınıfı oluşturun ve bir gereksinim işleyicisi sınıfı uygulayın. Gereksinim sınıfı oluşturma hakkında 






daha fazla bilgi için bkz. Reguirements. 


Handler sınıfı hem gereksinim hem de kaynak türünü belirtir. Örneğin, bir sameAuthorRequirement ve Document 
kaynağı kullanan bir işleyici aşağıdaki gibidir: 

public class DocumentAuthorizationHandler : 

AuthorizationHandler<SameAuthorRequirement, Document> 

{ 

protected override Task HandleRequirementAsync(Author'izationHandlerContext context, 

SameAuthorRequirement requirement , 

Document resource) 

{ 

if (context.User.Identity?.Name == resource.Author) 

{ 

context.Succeed(requirement); 

} 

return Task.CompletedTask; 

} 

} 

public class SameAuthorRequirement : IAuthorizationRequirement { } 


public class DocumentAuthorizationHandler : 

AuthorizationHandler<SameAuthorRequirement, Document> 

{ 

protected override Task HandleRequirementAsync(AuthorizationHandlerContext context, 

SameAuthorRequirement requirement, 
Document resource) 

{ 

if (context.User.Identity?.Name == resource.Author) 

{ 

context.Succeed(requirement); 

} 

//TODO: Use the following if targeting a version of 
//.NET Framework older than 4.6: 

// return Task.FromResult(0); 

return Task.CompletedTask; 

} 

} 

public class SameAuthorRequirement : IAuthorizationRequirement { } 


Yukarıdaki örnekte, sameAuthorRequirement daha genel specificAuthorRequirement sınıfının özel bir durumu 
olduğunu düşünün. specificAuthorRequirement sınıfı (gösterilmez) yazarın adını temsil eden bir Name özelliği içerir. 
Name özelliği geçerli kullanıcıya ayarlanabilir. 

Gereksinimi ve işleyiciyi startup.configureservices Kaydet: 











Services.AddControllersWithViews(); 

Services.AddRazorPages(); 

Services.AddAuthorization(options => 

{ 

options.AddPolicy("EditPolicy", policy => 

policy.Requirements.Add(new SameAuthorRequirement())); 

}); 

Services.AddSingletoncIAuthorizationHandler, DocumentAuthorizationHandler>(); 
Services.AddSingleton<IAuthorizationHandler, DocumentAuthorizationCrudHandler>(); 
Services.AddScopedcIDocumentRepository, DocumentRepository>(); 


Services. AddMvc(); 

Services.AddAuthorization(options => 

{ 

options.AddPolicyC'EditPolicy", policy => 

policy.Requirements.Add(new SameAuthorRequirement())); 

}); 

Services.AddSingleton<IAuthorizationHandler, DocumentAuthorizationHandler>(); 
Services.AddSingletoncIAuthorizationHandler, DocumentAuthorizationCrudHandler>(); 
Services.AddScoped<IDocumentRepository, DocumentRepository>(); 


Services.AddAuthorization(options => 

{ 

options.AddPolicy("EditPolicy", policy => 

policy.Requirements.Add(new SameAuthorRequirement())); 

}); 

Services.AddSingletoncIAuthorizationHandler, DocumentAuthorizationHandler>(); 
Services.AddSingletoncIAuthorizationHandlerj DocumentAuthorizationCrudHandler>(); 
Services.AddScopedcIDocumentRepositoryj DocumentRepository>(); 


İşletimsel gereksinimler 

CRUD (oluşturma, okuma, güncelleştirme, silme) işlemlerinin sonuçlarını temel alan kararlar verirken 
Operationauthorizationrequirement yardımcı sınıfını kullanın. Bu sınıf her işlem türü için tek bir sınıf yerine tek bir 
işleyici yazmanızı sağlar. Kullanmak için, bazı işlem adlarını sağlayın: 

public static class Operations 

{ 

public static OperationAuthorizationRequirement Create = 

new OperationAuthorizationRequirement { Name = nameof(Create) }; 
public static OperationAuthorizationRequirement Read = 

new OperationAuthorizationRequirement { Name = nameof(Read) }; 
public static OperationAuthorizationRequirement Update = 

new OperationAuthorizationRequirement { Name = nameof(Update) }; 
public static OperationAuthorizationRequirement Delete = 

new OperationAuthorizationRequirement { Name = nameof(Delete) }; 

} 

işleyici, bir 0perationAuthorizationRequirement gereksinimi ve Document kaynağı kullanılarak aşağıdaki gibi 
uygulanır: 






public class DocumentAuthorizationCrudHandler : 

Author'izationHandlen<OperationAuthorizationRequirement, Document> 

{ 

protected override Task HandleRequirementAsync(AuthorizationHandlerContext context, 

OperationAuthorizationRequirement requirement, 
Document resource) 

{ 

if (context.User.Identity?.Name == resource.Author && 
requirement.Name == Operations.Read.Name) 

{ 

context.Succeed(requirement); 

} 

return Task.CompletedTask; 

} 

} 


public class DocumentAuthorizationCrudHandler : 

AuthorizationHandler<OperationAuthorizationRequirement, Document> 

{ 

protected override Task HandleRequirementAsync(AuthorizationHandlerContext context, 

OperationAuthorizationRequirement requirement, 

Document resource) 

{ 

if (context.User.Identity?.Name == resource.Author && 
requirement.Name == Operations.Read.Name) 

{ 

context.Succeed(requirement); 

} 

//TODO: Use the following if targeting a version of 
//.NET Framework older than 4.6: 

// return Task.FromResult(0); 

return Task.CompletedTask; 

} 

} 

Önceki işleyici, kaynağı, kullanıcının kimliğini ve gereksinimin Name özelliğini kullanarak işlemi doğrular. 

İşletimsel kaynak işleyicisiyle Challenge ve fordeklarasyon 

Bu bölümde, Challenge ve fordeklarasyon eylem sonuçlarının nasıl işlendiği ve çekişme ve fordeklarasyonu ’nin 
nasıl farklı olduğu gösterilmektedir. 

İşletimsel bir kaynak işleyicisini çağırmak için, sayfa işleyicinizde veya eylemde AuthorizeAsync çağırırken işlemi 
belirtin. Aşağıdaki örnek, kimliği doğrulanmış kullanıcının belirtilen belgeyi görüntülemesine izin verilip 
verilmeyeceğini belirler. 


NOTE 

Aşağıdaki kod örnekleri, kimlik doğrulamasının çalıştırıldığını varsayar ve User özelliğini ayarlar. 






public async Task<IActionResult> OnGetAsync(Guid documentld) 
{ 

Document = _documentRepository.Find(documentld); 

if (Document == null) 

{ 

return new NotFoundResult(); 

} 


var authorizationResult = await _authorizationService 

.AuthorizeAsync(User, Document, Operations.Read); 


} 


if (authorizationResult.Succeeded) 

{ 

return Page(); 

} 

else if (User.Identity.IsAuthenticated) 
{ 


return new ForbidResult(); 

} 


else 

{ 


return new ChallengeResult(); 

} 


Yetkilendirme başarılı olursa belgeyi görüntüleme sayfası döndürülür.Yetkilendirme başarısız olursa, ancak 
kullanıcının kimliği doğrulanırsa, ForbidResuit döndürülüyor, yetkilendirme başarısız olan tüm kimlik doğrulama 
ara yazılımını bilgilendirir. Kimlik doğrulaması gerçekleştirilmesi gerektiğinde bir chailengeResuit döndürülür. 
Etkileşimli tarayıcı istemcileri için, kullanıcıyı bir oturum açma sayfasına yönlendirmek uygun olabilir. 


[HttpGet] 

public async Task<IActionResult> View(Guid documentld) 

{ 

Document document = _documentRepository.Find(documentld); 

if (document == null) 

{ 

return new NotFoundResult(); 

} 

if (await _authorizationService 

.AuthorizeAsync(User, document, Operations.Read)) 

{ 

return View(document); 

} 

else 

{ 

return new ChallengeResult(); 

} 


Yetkilendirme başarılı olursa belge görünümü döndürülür. Yetkilendirme başarısız olursa, döndüren 
chailengeResuit kimlik doğrulama ara yazılımı yetkilendirme başarısız olur ve ara yazılım uygun yanıtı alabilir. 
Uygun bir yanıt 401 veya 403 durum kodu döndürüyor olabilir. Etkileşimli tarayıcı istemcileri için kullanıcıyı bir 
oturum açma sayfasına yeniden yönlendirmek anlamına gelebilir. 
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Geliştirici genellikle geçerli kullanıcı kimliğine göre Kullanıcı arabirimini göstermek, gizlemek veya değiştirmek 
ister. Bağımlılık eklemeyoluyla MVC görünümleri içindeki yetkilendirme hizmetine erişebilirsiniz. Yetkilendirme 
hizmetini Razor görünümüne eklemek için @inject yönergesini kullanın: 

@using Microsoft.AspNetCore.Authorization 
(Şinject IAuthorizationService AuthorizationService 

Her görünümde yetkilendirme hizmeti istiyorsanız, @inject yönergesini Görünümler dizininin _Viewlmports. 
cshtml dosyasına yerleştirin. Daha fazla bilgi için bkz. görünümlere bağımlılık ekleme. 

Kaynak tabanlı yetkilendirmesırasında kontrol yaptığınız şekilde AuthorizeAsync çağırmak için eklenen 
yetkilendirme hizmetini kullanın: 

@if ((await AuthorizationService.AuthorizeAsync(User, "PolicyName")).Succeeded) 

{ 

<p>This paragraph is displayed because you fulfilled PolicyName.</p> 

} 

Bazı durumlarda, kaynak görünüm modeliniz olur. Kaynak tabanlı yetkilendirmesırasında AuthorizeAsync tam 
olarak kontrol ettiğiniz şekilde çağırın: 

@if ((await AuthorizationService. AuthorizeAsync (User., Model, Operations. Edit)) .Succeeded) 

{ 

<pxa class="btn btn-default" role="button" 

href="@Url.Action("Edit", "Document", new { id = Model.Id })">Edit</ax/p> 

} 

Yukarıdaki kodda, model, ilke değerlendirmesinin dikkate alınması gereken bir kaynak olarak geçirilir. 


VVARNING 

Tek yetkilendirme denetimi olarak uygulamanızın kullanıcı arabirimi öğelerinin görünürlüğünü değiştirmeye güvenmeyin. Bir 
kullanıcı arabirimi öğesini gizlemek, ilişkili denetleyici eylemine erişimi tamamen engellemeyebilir. Örneğin, önceki kod 
parçacığındaki düğmesini göz önünde bulundurun. Göreli kaynak URL 'SI /Document/Edit/1 olduğunu biliyorsa, Kullanıcı 
Edit Action metodunu çağırabilir. Bu nedenle Edit Action yöntemi kendi yetkilendirme denetimini gerçekleştirmelidir. 
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Tek sayfalı uygulamalar (maça 'Lar) gibi bazı senaryolarda, birden çok kimlik doğrulama yöntemi kullanılması 
yaygındır. Örneğin, uygulama, JavaScript istekleri için oturum açma ve JWT taşıyıcı kimlik doğrulaması için 
tanımlama bilgisi tabanlı kimlik doğrulaması kullanabilir. Bazı durumlarda, uygulamanın bir kimlik doğrulama 
işleyicisinin birden çok örneği olabilir. Örneğin, biri temel kimlik içeren ve bir Multi-Factor Authentication (MFA) 
tetiklendiğinde bir tane olan iki tanımlama bilgisi işleyicisi oluşturulur. Kullanıcı ek güvenlik gerektiren bir işlem 
istediği için MFA tetiklenebilir. 

Kimlik doğrulaması sırasında kimlik doğrulama hizmeti yapılandırıldığında bir kimlik doğrulama düzeni 
adlandırılır. Örneğin: 

public void ConfigureServices(IServiceCollection Services) 

{ 

// Code omitted for brevity 

Services.AddAuthentication() 

.AddCookie(options => { 

options.LoginPath = "/Account/Unauthorized /"; 
options.AccessDeniedPath = "/Account/Forbidden/"; 

}) 

.AddJwtBearer(options => { 

options.Audience = "http://localhost:5001/"; 
options.Authority = "http://localhost:5000/"j 

}); 


Yukarıdaki kodda iki kimlik doğrulama işleyicisi eklenmiştir: biri tanımlama bilgileri ve bir taşıyıcı için bir tane. 


NOTE 

Varsayılan düzeni belirtmek HttpContext.user özelliğinin bu kimliğe ayarlandığı sonuçları elde ediyor. Bu davranış 
istenmiyorsa, AddAuthentication parametresiz biçimini çağırarak devre dışı bırakın. 


Yetkilendir özniteliğiyle düzeni seçme 

Uygulama, yetkilendirme noktasında kullanılacak işleyiciyi gösterir. [Authorize] için virgülle ayrılmış bir kimlik 
doğrulama düzeni listesi geçirerek uygulamanın yetkilendirdiği işleyiciyi seçin. [Authorize] özniteliği, varsayılan 
olarak yapılandırılıp yapılandırılmadığını ne olursa olsun, kullanılacak kimlik doğrulama düzenini veya 
düzenlerini belirtir. Örneğin: 

[Authorize(AuthenticationSchemes = AuthSchemes)] 
public class MixedController : Controller 
// Requires the following imports: 

// using Microsoft.AspNetCore.Authentication.Cookies; 

// using Microsoft.AspNetCore.Authentication.HwtBearer; 
private const string AuthSchemes = 

CookieAuthenticationDefaults.AuthenticationScheme + + 

DwtBearerDefaults.AuthenticationScheme; 


Yukarıdaki örnekte, hem tanımlama bilgisi hem de taşıyıcı işleyiciler çalışır ve geçerli kullanıcı için bir kimlik 
oluşturma ve ekleme şansı vardır. Yalnızca tek bir düzen belirterek, karşılık gelen işleyici çalışır. 









[Authorize(AuthenticationSchemes = 

BwtBearerDefaults. AuthenticationScheme) ] 
public class MixedController : Controller 


Yukarıdaki kodda yalnızca "taşıyıcı" düzenine sahip işleyici çalışır.Tanımlama bilgisi tabanlı kimlikler yok sayılır. 

İlkeleri olan düzeni seçme 

ilkedeistenen şemaları belirtmeyi tercih ediyorsanız, ilkenizi eklerken AuthenticationSchemes koleksiyonu 
ayarlayabilirsiniz: 

Services.AddAuthorization(options => 

{ 

options.AddPolicy("0verl8", policy => 

{ 

policy.AuthenticationSchemes.Add(lwtBearerDefaults.AuthenticationScheme); 
policy.RequireAuthenticatedUser(); 

policy. Requirements.Add(new l' / linimumAgeRequirement()); 

}); 

}); 


Yukarıdaki örnekte, "Överi 8" ilkesi yalnızca "taşıyıcı" işleyicisi tarafından oluşturulan kimliğe göre çalışır. 
[Authorize] özniteliğinin Policy özelliğini ayarlayarak ilkeyi kullanın: 

[Authorize(Policy = "0verl8")] 

public class RegistrationController : Controller 


Birden çok kimlik doğrulama şeması kullanma 

Bazı uygulamaların birden çok tür kimlik doğrulamasını desteklemesi gerekebilir.Örneğin, uygulamanız Azure 
Active Directory kullanıcıların kimliğini ve bir kullanıcılar veritabanından kimlik doğrulaması yapabilir. Diğer bir 
örnek, hem Active Directory Federasyon Hizmetleri (AD FS) hem de Azure Active Directory B2C kullanıcıların 
kimliğini doğrulayan bir uygulamadır. Bu durumda, uygulamanın birkaç verenler tarafından bir JWT taşıyıcı 
belirtecini kabul etmesi gerekir. 

Kabul etmek istediğiniz tüm kimlik doğrulama düzenlerini ekleyin. Örneğin, startup.configureServices aşağıdaki 
kod farklı verenler ile iki JWT taşıyıcı kimlik doğrulama şeması ekler: 

public void ConfigureServices(IServiceCollection Services) 

{ 

// Code omitted for brevity 

Services.AddAuthentication(lwtBearerDefaults.AuthenticationScheme) 

.AddlwtBearer(options => 

{ 

options.Audience = "https://localhost:5000/"; 

options.Authority = "https://localhost:5000/identity/"; 

}) 

.AddlwtBearer("AzureAD", options => 

{ 

options.Audience = "https://localhost:5000/"; 

options.Authority = "https://login.microsoftonline.com/eb971100-6f99-4bdc-8611-lbc8edd7f4B6/"; 

}); 

} 








NOTE 

Varsayılan kimlik doğrulama düzenine iwtBearerDefaults. AuthenticationScheme yalnızca bir JWT taşıyıcı kimlik 
doğrulaması kaydedilir. Ek kimlik doğrulaması, benzersiz bir kimlik doğrulama şemasına kaydedilmelidir. 


Bir sonraki adım, varsayılan yetkilendirme ilkesini her iki kimlik doğrulama şemasını kabul edecek şekilde 
güncelleştirmesidir. Örneğin: 

public void ConfigureServices(IServiceCollection Services) 

{ 

// Code omitted for brevity 

Services.AddAuthorization(options => 

{ 

var defaultAuthorizationPolicyBuilder = new AuthorizationPolicyBuilder( 
iwtBearerDefaults. AuthenticationScheme., 

"AzureAD"); 

defaultAuthorizationPolicyBuilder = 

defaultAuthorizationPolicyBuilder. RequireAuthenticatedUser(); 
options .DefaultPolicy = defaultAuthorizationPolicyBuilder. Build(); 

}); 

} 

Varsayılan yetkilendirme ilkesi geçersiz kılındığından, denetleyicilerde [Authorize] özniteliğini kullanmak 
mümkündür. Denetleyici daha sonra ilk veya ikinci veren tarafından JWT veren istekleri kabul eder. 
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Web uygulamaları, genellikle güvenlik bakımından hassas verileri depolamak gerekir. VVİndovvs için 
masaüstü uygulamalarının DPAPI sağlar, ancak bu web uygulamaları için uygun değildir. ASP.NET Coreveri 
koruma yığınından bir geliştirici, anahtar yönetimi ve döndürme gibi verileri korumak için kullanabileceğiniz 
basit, kullanımı kolay bir şifreleme API'si sağlar. 

ASP.NET Coreveri koruma yığın uzun vadeli ardılı olarak hizmet vermek için tasarlanmış <machineKey> 

AS P.N ET öğesinde 1 .x - 4.x. Eski şifreleme yığın eksikliklerini birçoğu Çoğu modern uygulamalar 
karşılaşabileceğiniz olası kullanım durumu için kullanıma hazır çözüm sağlarken yönelik olarak 
tasarlanmıştır. 

Sorun bildirimi 

Genel Sorun bildirimi temellerini tek bir cümlede belirtilebilir: Sonraki alma için güvenilen bilgilerini kalıcı 
hale gerekir, ancak Kalıcılık mekanizması güven yok. "Güvenilmeyen bir istemci aracılığıyla güvenilen gidiş 
dönüş durumu istiyorum."olarak web bağlamında, bu yazılı olabilir 

Kurallı örnek bir kimlik doğrulama tanımlama bilgisi taşıyıcı mi belirteci. Sunucu oluşturur bir "I Groot am 
ve xyz izinlere sahip" belirtecini ve istemciye uygulamalı. İleriki bir tarihte istemci sunucuya geri belirtecini 
sunar ancak sunucu istemci belirteci sahte taşınmadığından güvencesi tür gerekiyor. Bu nedenle ilk 
gereksinim: Orijinallik Sertifikası (yani) bütünlüğü, kurcalamaya sağlama). 

Kalıcı durum sunucusu tarafından güvenilir olduğundan, bu durum için işletim sistemi ortamında özel 
bilgiler içerebilir beklenir. Bu, bir dosya yolu, bir izin, bir tanıtıcı ya da diğer dolaylı başvuru biçiminde veya 
bazı bir sunucuya özgü veri parçası olabilir. Bu bilgiler genellikle güvenilmeyen bir istemciye açıklanmaması 
gereken. Böylece ikinci gereksinime: gizliliği. 

Modern uygulamalar bileşenlerden, son olarak, hangi gördük tek tek bileşenler sistemdeki diğer bileşenlere 
bakılmaksızın bu sistem yararlanmak isteyeceksiniz olduğu. Örneğin, bir taşıyıcı belirteç bileşeni bu yığın 
kullanıyorsanız, de aynı yığınına kullanıyor olabilecek bir anti-CSRF mekanizması girişime olmadan 
çalışması. Bu nedenle son gereksinimi: yalıtım. 

Size daha fazla tutmamız kapsamını daraltmak için kısıtlamalar sağlayabilir.Cryptosystem içinde çalışan tüm 
hizmetlerin eşit oranda güvenilir ve veri oluşturulan ya da hizmetler doğrudan denetimimiz dışında 
kullanılan gerektirmeyeceği varsayıyoruz. Ayrıca, her web hizmeti isteğine bir veya daha fazla kez 
cryptosystem geçebilir beri operations mümkün olduğunca hızlı olmalarını gerektirir. Bu simetrik şifreleme 
senaryomuz için ideal hale getirir ve biz asimetrik şifreleme gibi kadar gerekli olan bir zaman indirim. 

Tasarımı felsefesi 

Var olan yığın sorunları tanımlayarak Başladık. Vardı, sonra biz varolan çözümleri yatay Uzmanı ile 
görüşmeler ve varolan bir çözümü oldukça biz Aranan özelliklerine sahip tamamlanmış. Biz ardından, bazı 
temel kurallara göre bir çözüm de tasarlanmıştır. 

• Sistem Yapılandırması basitliğinin sunmalıdır, ideal olarak, sistem, sıfır yapılandırmalı olacaktır ve 
geliştiriciler kubernetes'i oluşabilir. Geliştiriciler (örneğin, anahtar deposu) belirli bir yönüne 
yapılandırmak için gereken yere durumlarda, bu belirli yapılandırmaları basit hale getirmek için göz 
önünde bulundurarak verilmelidir. 

• Basit bir tüketiciye yönelik API sunar.API'leri, doğru bir şekilde kullanmak kolay ve yanlış kullanmak 




zor olmalıdır. 


• Geliştiriciler, anahtar yönetimi ilkelerini öğrenin olmamalıdır. Sistem seçimi algoritması ve anahtar 
yaşam süresi geliştiricinin adınıza işlemelidir, ideal olarak Geliştirici hiçbir zaman bile ham anahtar 
malzemesi erişiminiz olması. 

• Mümkün olduğunda bekleyen korumalı anahtarlar.Bir uygun varsayılan koruma mekanizması şekil 
ve otomatik olarak uygulama gerekir. 

Bu ilkeleri göz önünde ile basit, biz geliştirilen kullanımı kolay veri koruma yığını. 

ASP.NET Core veri koruma API'lerini öncelikle amaçlanmayan gizli yükü belirsiz kalıcılığını. Diğer 
teknolojiler ister Windows CNG DPAPI ve Azure Rights Management belirsiz depolama senaryosu için 
daha uygundur ve bunlar gelenlere güçlü anahtar yönetim olanaklarına sahip olursunuz. Bu, gizli verilerin 
uzun dönem koruma için ASP.NET Core veri koruma API'lerini kullanarak bir geliştirici yasaklanması bir 
şey yoktur söylenir. 

Hedef Kitle 

Veri koruma sisteminde beş ana paketler bölünmüştür. Bu API'ler çeşitli yönlerini üç ana olarak Hedef 
Kitleleri belirlemenizi; 

1. Tüketici API'lerine genel bakış hedef uygulama ve framevrork geliştiriciler. 

"Nasıl yapılandırıldığı hakkında veya yığın nasıl çalıştığı hakkında bilgi edinmek istemiyorum. 

Yalnızca bazı işlemde olarak basit bir şekilde mümkün olduğunca başarıyla API'leri kullanarak yüksek 
olasılık ile gerçekleştirmek istiyorum." 

2. Yapılandırma API'leri hedef uygulama geliştiriciler ve sistem yöneticileri. 

"Veri koruma sisteminde ortamımın varsayılan olmayan yollar veya ayarları gerektirdiğini bildirmek 
ihtiyacım var." 

3. Genişletilebilirlik API'leri hedef özel ilke uygulama sorumlu geliştiriciler. Bu API'lerin kullanımını bazı 
nadir durumlar için sınırlı ve yaşadı, güvenlik kullanan geliştiriciler. 

"I davranış gerçekten benzersiz gereksinimleri çünkü sistem içindeki tüm bir bileşen değiştirmeniz 
gerekiyor. My gereksinimleri karşılayan bir eklenti oluşturmak için bir API yüzeyi uncommonly 
kullanılan bölümlerini öğrenmek istiyorum." 

Paket düzeni 

Veri koruma yığın beş paketlerini oluşur. 

• Microsoft.AspNetCore.DataProtection.Abstractions içeren IDataProtectionProvider ve 
IDataProtector veri koruma hizmetleri oluşturmak için gereken arabirimler. Ayrıca, bu türleriyle 
çalışmak için yararlı genişletme yöntemleri içerir (örneğin, IDataProtector.Protect). Veri koruma 
sisteminde başka bir örneği ve API kullanan, başvuru 

Microsoft.AspNetCore.DataProtection.Abstractions . 

• Microsoft.AspNetCore.DataProtection çekirdek şifreleme işlemleri, anahtar yönetimi, yapılandırma 
ve genişletilebilirlik gibi veri koruma sisteminde çekirdek uygulamasını içerir. Veri koruma sisteminde 
örneklemek için (örneğin, eklemeden bir IServiceCollection) veya değiştirme veya davranışını 
genişletme, başvuru Microsoft.AspNetCore.DataProtection . 

• Microsoft.AspNetCore.DataProtection.Extensions geliştiricilerin yararlı olabilir ancak çekirdek pakete 
ait olmayan ek API'ler içerir. Örneğin, bu paket bağımlılık ekleme olmadan dosya sistemindeki bir 
konumda anahtarları depolamak için veri koruma sisteminde örneklemek için Fabrika yöntemleri 




içerir (bkz DataProtectionProvider). Ayrıca, korumalı yüklerin ömrünü sınırlama için genişletme 
yöntemleri içerir (bkz ITİmeLimitedDataProtector). 

• Microsoft.AspNetCore.DataProtection.SystemVVeb yönlendirileceği varolan ASP.NET 4.x 
uygulamaya yüklenebilir, <machineKey> işlemlerinin yeni ASP.NET Core veri koruma yığını kullanın. 
Daha fazla bilgi için bkz. AS P.N ET core'da AS P.N ET machineKey değiştirin. 

• Microsoft.AspNetCore.Cryptography.KeyDerivation PBKDF2 parola yordamı karma uygulaması 
sağlar ve kullanıcı parolalarını güvenli bir şekilde işlemelidir sistemleri tarafından kullanılabilir. Daha 
fazla bilgi için bkz. AS P.N ET Core 'de karma parolalar. 

Ek kaynaklar 

Web çiftliğinde ASP.NET Core ana bilgisayar 



ASPNET Core 'de veri koruma API 'Lerini kullanmaya 
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En basit olan verileri korumak aşağıdaki adımlardan oluşur: 

1. Bir veri koruma sağlayıcısından veri koruyucusu oluşturun. 

2. Protect yöntemini korumak istediğiniz verilerle çağırın. 

3. unprotect yöntemini, düz metin haline döndürmek istediğiniz verilerle çağırın. 

ASP.NET Core veya SignalRgibi çoğu çerçeve ve uygulama modelleri, veri koruma sistemini zaten yapılandırıp 
bağımlılık ekleme yoluyla erişenbir hizmet kapsayıcısına ekler. Aşağıdaki örnek, bağımlılık ekleme ve veri koruma 
yığınını kaydetme, veri koruma sağlayıcısını dı aracılığıyla alma, bir koruyucu oluşturma ve verilerin korumasını 
kaldırma için bir hizmet kapsayıcısını yapılandırmayı gösterir. 






using System; 

using Microsoft. AspNetCore.DataProtection; 
using Microsoft.Extensions.DependencyInjection; 

public class Program 

{ 

public static void Main(string[] args) 

{ 

// add data protection Services 

var serviceCollection = new ServiceCollection(); 

serviceCollection.AddDataProtection(); 

var Services = serviceCollection.BuildServiceProvider(); 

// create an instance of MyClass using the service provider 

var instance = ActivatorUtilities.CreateInstance<MyClass>(services); 

instance.RunSample(); 

} 

public class MyClass 

{ 

IDataProtector _protector; 

// the 'provider' parameter is provided by DI 
public MyClass(IDataProtectionProvider provider) 

{ 

_protector = provider.CreateProtector("Contoso.MyClass.vl"); 

} 

public void RunSample() 

{ 

Console.Write("Enter input: "); 
string input = Console.ReadLine(); 

// protect the payload 

string protectedPayload = _protector.Protect(input); 

Console.Writel_ine($"Protect returned: {protectedPayload}"); 

// unprotect the payload 

string unprotectedPayload = _protector.Unprotect(protectedPayload); 
Console.WriteLine($"Unprotect returned: {unprotectedPayload}"); 

} 

} 

} 

/* 

* SAMPLE OUTPUT 

* 

* Enter input: Hello world! 

* Protect returned: CfD18ICcgQwZZhlAlTZT...0dfH66ilPnGmpCR5e441xQ 

* Unprotect returned: Hello world! 

*/ 


Bir koruyucu oluşturduğunuzda bir veya daha fazla Amaç dizesisağlamanız gerekir. Amaç dizesi, tüketiciler 
arasında yalıtım sağlar. Örneğin, "yeşil" bir amaç dizesiyle oluşturulan bir koruyucu, "mor" amacını taşıyan bir 
koruyucu tarafından belirtilen verilerin korumasını yapamaz. 



TIP 

iDataProtectionProvider ve iDataProtector örnekleri, birden çok çağıranlar için iş parçacığı güvenlidir. Bir bileşen 
CreateProtector çağrısı aracılığıyla bir İDataProtector başvuru aldığında, bu başvuruyu Protect ve Unprotect 
birden çok çağrı için kullanacaktır. 

Korunan yük doğrulanamazsa veya çözülemez bir unprotect çağrısı CryptographicException oluşturur. Bazı bileşenler, 
kaldırma işlemleri sırasında hataları yoksaymak isteyebilir; kimlik doğrulama tanımlama bilgilerini okuyan bir bileşen bu 
hatayı işleyebilir ve isteği, isteğin hemen başarısız olması yerine hiç bir tanımlama bilgisine sahip olmamış gibi değerlendirir. 
Bu davranışın, tüm özel durumlara izin vermek yerine CryptographicException özel olarak yakalamalı bileşenler. 





kullanır. Bulunan Microsoft.AspNetCore.DataProtection.Abstractions paket. 

I Data P rotection P rovider 

Sağlayıcı arabirimi, veri koruma sisteminin kökünü temsil eder. Doğrudan dosya korumak veya veri korumasını 
kaldırmak için de kullanılamaz. Bunun yerine, tüketici bir başvuru almak gerekir bir iDataProtector çağırarak 
iDataProtectionProvider.createProtector(purpose) amaçlı tüketici hedeflenen kullanım örneğini tanımlayan bir dize 
olduğu. Bkz: amaç dizeleri amaç çok daha fazla bilgi bu parametre ve uygun bir değer seçin. 

İDataProtector 

Koruyucu arabirimi için bir çağrı tarafından döndürülen createProtector ve tüketiciler gerçekleştirmek için 
kullanabileceğiniz bu arabirimi korumak ve korumasını operations. 

Bir veri parçasını korumak için verileri geçirmek Protect yöntemi. Hangi dönüştürür byte [] -> byte [] bir yöntem 
temel bir arabirim tanımlar, ancak var olan dize dönüştürür (bir genişletme yöntemi sağlanan) bir aşırı dize ayrıca - 
>. iki yöntem tarafından sunulan güvenlik aynıdır; Geliştirici, hangi aşırı kullanım örnekleri için en uygun seçmeniz 
gerekir. Seçilen, aşırı yükleme koruma tarafından döndürülen değer bakılmaksızın yöntemi artık (enciphered ve 
kurcalamaya haricindeki) korunur ve uygulama güvenilmeyen bir istemciye göndermek için. 

Daha önce korunan bir veri korumasını kaldırmak için korunan verileri geçirmek unprotect yöntemi. (Byte [] 
vardır-tabanlı ve dize tabanlı aşırı geliştiriciye kolaylık sağlamak için.) Korumalı yükü daha önceki bir çağrı 
tarafından oluşturulmuşsa Protect bu aynı üzerinde iDataProtector, unprotect özgün korumasız yükü yöntemi 
döndürür. Korumalı yükü oynanmış veya farklı bir tarafından üretilen iDataProtector , unprotect 
CryptographicException yöntemi oluşturur. 

Aynı kavram farklı karşılaştırması İDataProtector TIES amaçlı kavramını yedekleme, iki iDataProtector örnekleri 
aynı kökünden oluşturuldu İDataProtectionProvider ancak farklı bir amaç dizeleri çağrısında aracılığıyla 
İDataProtectionProvider.CreateProtector , kabul edilmeleri sonra farklı koruyucuları, ve bir olmayacaktır 
korumasını kaldırmak için tarafından oluşturulan yükler. 

Bu arabirimler kullanma 

Dİ algılayan bir bileşen için bileşen aldığını hedeflenen kullanım olduğu bir İDataProtectionProvider 
oluşturucusuna parametre ve bileşen örneği oluşturulduğunda Dİ sistemi bu hizmeti otomatik olarak sağlar. 


NOTE 

Bazı uygulamalar (örneğin konsol uygulamaları veya ASP.NET 4.x uygulamaları) Dİ burada açıklanan mekanizması 
kullanamazlar uyumlu olmayabilir. Bu senaryolar doldurulamayabilir olmayan dı kullanmayan senaryolar belge örneği alma 
hakkında daha fazla bilgi için bir iDataProtection Dİ giderek olmadan sağlayıcısı. 


Aşağıdaki örnek, üç kavramı gösterir: 

1. Veri koruma sisteminde ekleme hizmet kapsayıcısı 


2. Dİ örneğini almak üzere kullanarak bir İDataProtectionProvider , ve 




















3. Oluşturma bir İDataProtector gelen bir İDataProtectionProvider ve korumaya ve veri korumasını 
kaldırmak için kullanma. 


using System; 

using Microsoft. AspNetCore.DataProtection; 
using Microsoft.Extensions.DependencyInjection; 

public class Program 

{ 

public static void Main(string[] args) 

{ 

// add data protection Services 

var serviceCollection = new ServiceCollection(); 

serviceCollection.AddDataProtection(); 

var Services = serviceCollection.BuildServiceProvider(); 

// create an instance of MyClass using the service provider 

var instance = ActivatorUtilities.CreateInstance<MyClass>(services); 

instance.RunSample(); 

} 

public class MyClass 

{ 

İDataProtector _protector; 

// the 'provider' parameter is provided by DI 
public MyClass(IDataProtectionProvider provider) 

{ 

_protector = provider.CreateProtector("Contoso.MyClass.vl"); 

} 

public void RunSample() 

{ 

Console.Write("Enter input: "); 
string input = Console.ReadLine(); 

// protect the payload 

string protectedPayload = _protector.Protect(input); 

Console.WriteLine($"Protect returned: {protectedPayload}"); 

// unprotect the payload 

string unprotectedPayload = _protector.Unprotect(protectedPayload); 
Console.WriteLine($"Unprotect returned: {unprotectedPayload}"); 

} 

} 

} 

/* 

* SAMPLE OUTPUT 

* 

* Enter input: Hello world! 

* Protect returned: CfD18ICcgQwZZhlAlTZT..,0dfH66ilPnGmpCR5e441xQ 

* Unprotect returned: Hello world! 

V 


' % S'paketi Microsoft.AspNetCore.DataProtection.Abstractions bir genişletme yöntemi içeren 
ıserviceProvider.GetDataProtector Geliştirici kolaylık. Hem bir alma tek bir işlem olarak kapsülleyen bir 
İDataProtectionProvider hizmet sağlayıcısı ve arama İDataProtectionProvider.CreateProtector .Aşağıdaki Örnek, 
kullanımını gösterir. 






using System; 

using Microsoft.AspNetCore.DataProtection; 
using Microsoft.Extensions.Dependencylnjection; 

public class Program 

{ 

public static void Main(string[] args) 

{ 

// add data protection Services 

var serviceCollection = new ServiceCollection(); 

serviceCollection.AddDataProtection(); 

var Services = serviceCollection.BuildServiceProvider(); 

// get an IDataProtector from the IServiceProvider 
var protector = Services.GetDataProtector("Contoso.Example.v2"); 
Console.Write("Enter input: "); 
string input = Console.ReadLine(); 

// protect the payload 

string protectedPayload = protector.Protect(input); 

Console.WriteLine($"Protect returned: {protectedPayload}"); 

// unprotect the payload 

string unprotectedPayload = protector.Unprotect(protectedPayload); 
Console.WriteLine($"Unprotect returned: {unprotectedPayload}"); 

} 

} 


TIP 

Örneklerini iDataProtectionProvider ve IDataProtector olan birden çok arayanlar için iş parçacığı açısından güvenli. Bir 
bileşen için bir başvuru alır, sonra istemiş bir IDataProtector çağrısıyla createProtector , birden çok çağrı için bu 
başvuru kullanacağı Protect ve unprotect . Bir çağrı unprotect korumalı yükü doğrulandı veya yararlanılarak 
CryptographicException oluşturmaz. Bazı bileşenler hataları yoksayma isteyebilirsiniz sırasında işlemleri; Korumasını Kaldır 
kimlik doğrulaması tanımlama bilgileri okuyan bir bileşen bu hatayı işlemek ve isteği, tanımlama bilgisi hiç varmış gibi davran 
yerine yükseltebilir istek başarısız. Bu davranış istediğiniz bileşenleri, tüm özel durumları swallowing yerine 
CryptographicException özel olarak yakalamalısınız. 





ASPNET core'da amaç dizeleri 
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Tükettikleri bileşenleri İDataProtectionProvider benzersiz bir geçmelidir amacıyla parametresi createProtector 
yöntemi. Amacıyla parametre kök şifreleme anahtarları aynı olsa bile, şifreleme tüketicileri arasında yalıtım 
sağlar, veri koruma sisteminde Security'ye devralınan aynıdır. 


Bir tüketici bir amaç belirtir, amacı dize şifreleme alt anahtarlarının benzersiz, tüketiciye türetmek için kök 
şifreleme anahtarları ile birlikte kullanılır. Bu uygulama tüm diğer şifreleme tüketicilerinizin tüketiciden yalıtır: 
başka bir bileşen kendi yüklerini okuyabilir ve tüm diğer bileşenin yüklerini okunamıyor. Bu yalıtım ayrıca bileşen 
saldırısı blokunu tüm kategorileri işler. 


CreateProtector("Auth ticket") 



Application master 
İDataProtectionProvider 


- 1 


CreateProtector("View state") 





Child IDataProtector A 



Child IDataProtector B 


Yukarıdaki diyagramda IDataProtector örnekleri A ve B olamaz birbirlerinin yüklerini yalnızca okuma kendi. 

Amaç dize gizli olması gerekmez. Yalnızca anlamda iyi çalışan başka bir bileşen aynı amaca dize hiç olmadığı 
kadar sağlayacak benzersiz olmalıdır. 


TIP 

Veri koruma API'lerini kullanan bileşen ad alanı ve tür adını kullanarak bir iyi, uygulama bu bilgileri hiçbir zaman çakışacak 
olduğu gibi udur. 

Taşıyıcı belirteçleri minting için sorumlu olan Contoso tarafından yazılan bir bileşen Contoso.Security.BearerToken kendi 
amacı dize olarak kullanabilirsiniz. Veya, kendi amacı dize olarak Contoso.Security.BearerToken.vl - daha da iyi - 
kullanabilirsiniz. Sürüm numarası ekleme Contoso.Security.BearerToken.v2 amacı kullanılacak bir sonraki sürümünde sağlar 
ve yükü Git kadar farklı sürümleri birbirlerinden tamamen yalıtılmış olacaktır. 


Amacıyla parametresi beri CreateProtector bir dize dizisidir yukarıdaki yerine olarak belirtilmiş 
[ "Contoso.Security.BearerToken", "vi" ] . Bu amacıyla hiyerarşisi oluşturma sağlar ve veri koruma sisteminde 
ile çok kiracılı senaryolarda olasılığım'kurmak açılır. 














VVARNING 

Bileşenleri giriş amacıyla zinciri için tek kaynak olmasını güvenilir olmayan kullanıcı girişlerinden izin vermemelisiniz. 

Örneğin, bir bileşen güvenli iletileri depolamak için sorumlu Contoso.Messaging.SecureMessage göz önünde bulundurun. 
Güvenli ileti sistemi bileşeni çağırıyorsa createProtector( [ username ]) , kötü niyetli bir kullanıcı bir hesap kullanıcı adı 
"Contoso.Security.BearerToken" ile çağırmak için bileşen alma denemesi oluşturabilir sonra 

createProtector-([ "Contoso.Security.BearerToken" ]) , bu nedenle yanlışlıkla güvenli Mesajlaşma neden Sistem için 
kimlik doğrulama belirteçleri algılanan Naneli yükler. 

ileti sistemi bileşeni için daha iyi bir amacıyla zinciri olur 

CreateProtector( [ "Contoso.Messaging.SecureMessage ", "User: username" ]) , uygun yalıtım sağlar. 

Tarafından sağlanan yalıtım ve davranışlarını iDataProtectionProvider , iDataProtector , ve amacıyla aşağıdaki 
gibidir: 

• için bir verilen İDataProtectionProvider nesnesi CreateProtector yöntemi oluşturur bir İDataProtector 
nesneyi benzersiz şekilde bağlı hem de İDataProtectionProvider ve metodun Metoda geçilen amacıyla 
parametresini oluşturulan nesne. 

• Amacı parametre null olmamalıdır.(Amacıyla bir dizi olarak belirtilirse, bu dizinin sıfır uzunluğunda 
olmalıdır ve null olmayan bir dizinin tüm öğelerinin olmalıdır anlamına gelir.) Boş dize amacı, teknik 
olarak izin verilir, ancak önerilmez. 

• (Sıralı bir karşılaştırıcı kullanılarak) aynı sırada aynı dizeler içerdikleri ve yalnızca, iki amaca bağımsız 
değişkenleri eşdeğerdir. Tek amaçlı bir bağımsız değişken karşılık gelen tek öğeli amacıyla diziye 
eşdeğerdir. 

• iki iDataProtector eşdeğerini oluşturuldukları ve yalnızca, nesneleri eşdeğer İDataProtectionProvider 
nesneleri eşdeğer amacıyla parametrelere sahip. 

• için bir verilen iDataProtector nesnesi, bir çağrı unprotect(protectedData) özgün döndüreceği 


unprotectedData 

ve yalnızca, 

protectedData := Protect(unprotectedData) 

eşdeğer için 

İDataProtector 


nesne. 


NOTE 

Burada bazı bileşeni ile başka bir bileşen çakışma bilinen bir amaç dize kasıtlı olarak seçer çalışması düşündüğümüz değil. 
Böyle bir bileşene temelde kötü amaçlı olarak kabul edilir ve bu sistem, kötü amaçlı kod içinde çalışan işlemi zaten çalışıyor 
durumunda, güvenlik Güvenceleri sağlamaya yönelik değildir. 
















Amaç hiyerarşisi ve ASPNET Core, çok kiracılılık 
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Bu yana bir iDataProtector de örtülü olarak başvuruluyor bir iDataProtectionProvider , amacıyla zincirleme 
yapılabilir birlikte. Bu bağlamdaki provider.createProtector([ "purposei", "purpose2" ]) eşdeğerdir 
provider.CreateProtector("purposel"). CreateProtector("purpose2") . 

Bu bazı ilginç hiyerarşik ilişkiler veri koruma sistemi aracılığıyla sağlar.Önceki örnekte 
Contoso.Messaging.SecureMessage, SecureMessage bileşen çağırabilirsiniz 

provider.CreateProtectorC'Contoso.Messaging.SecureMessage") kez Ön ve sonucu Özel bir Önbelleğe _myProvider 
alan. Gelecekteki koruyucuları ardından oluşturulabilir çağrılar aracılığıyla 

_myProvider.CreateProtector("User: username") , ve bu koruyucuları, tek bir ileti güvenliğini sağlamak için 
kullanılacaktır. 

Bu ayrıca çevrilebilir.Tek bir mantıksal uygulama birden fazla Kiracı (makuldür bir CMS) ve her kiracının kendi 
kimlik doğrulama ve durumu yönetimi sistemi ile yapılandırılabilir hangi konakların göz önünde bulundurun. Genel 
Uygulama tek bir ana sağlayıcısı vardır ve çağrı yaptığı provider.createProtector("Tenant i") ve 
provider.CreateProtector("Tenant 2") her kiracının kendi veri koruma sisteminde yalıtılmış dilimin vermek için. 
Kiracılar, kendi ihtiyaçlarına göre tek tek kendi koruyucuları ardından türetilen, ancak nasıl sabit çalıştıklarında ne 
olursa olsun, birbiriyle çakışır koruyucuları başka hiçbir kiracıyla sistemde oluşturamaz. Grafik, bu gibi aşağıda 
gösterilir. 
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VVARNING 

Bu, uygulama denetimleri hangi API'ler ayrı kiracıların kullanımına sunulur ve kiracılar rastgele kod sunucu üzerinde 
yürütülemiyor terimdir varsayar. Bir kiracı rastgele kod yürütebilir, yalıtım garanti ayırmak için özel yansıma işlemini 
gerçekleştiremedi veya bunlar yalnızca ana malzemesinin doğrudan okunabilir ve tüm alt anahtarlarını türetilen, istenen. 


Veri koruma sisteminde gerçekten çok kiracılı, varsayılan kullanıma hazır yapılandırmasında kavramını kullanır. 
Varsayılan olarak ana anahtar malzemesini çalışan işlemi hesabın kullanıcı profili klasörü (veya IIS uygulama 
havuzu kimlikleri için kayıt defteri) depolanır. Ancak tek bir hesapta birden çok uygulama çalıştırmak için gerçekten 
oldukça yaygındır ve malzemesinin asıl paylaşımını ayarlarken bu uygulamalar bu nedenle sonlandırır. Bunu 
çözmek için veri koruma sisteminde otomatik olarak her uygulamanın benzersiz tanımlayıcısı olarak genel amaçlı 
zinciri içindeki ilk öğeyi ekler. Örtük bu amaç için hizmet bireysel uygulamalarını yalıtmak diğerinden sistem ve 
koruyucu oluşturma işlemi içinde benzersiz bir kiracı aynı yukarıdaki resimde göründüğü gibi her bir uygulama 
etkili bir şekilde değerlendirmesini tarafından. 
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Veri koruma kodu tabanı, şifreleme anahtar türetme işlevlerini içeren Microsoft AspNetCore. Cryptography. 
Keytüretme paketini içerir. Bu paket tek başına bir bileşendir ve veri koruma sisteminin geri kalanı üzerinde hiçbir 
bağımlılığı yoktur. Tamamen bağımsız olarak kullanılabilir. Kaynak, bir kolaylık olarak veri koruma kodu tabanının 
yanında bulunur. 

Paket şu anda PBKDF2 algoritmasınıkullanarak KeyDerivation.Pbkdf2 bir parolayı karma olarak sağlayan bir 
yöntem sunmaktadır. Bu API .N ET Framevvork var olan Rfc2898DeriveBytes türüneçok benzer, ancak üç önemli 
ayrımlar vardır: 


HMACSHA512 

HMACSHAİ 

HMACSHAİ 

Rfc2898DeriveBytes 


kullanmayı destekler, ancak tür yalnızca destekler. KeyDerivation.Pbkdf2 


2. KeyDerivation.Pbkdf2 Yöntemi, geçerli işletim sistemini algılar ve yordamın en iyi duruma getirilmiş 
uygulamasını seçme girişimlerini, belirli durumlarda çok daha iyi performans sağlar. (Windows 8 ' de, 10 ' 
un Rfc2898DeriveBytes aktarım hızını yaklaşık olarak sunar.) 


3. KeyDerivation. Pbkdf2 Yöntemi, çağıranın tüm parametreleri (anahtar, prf ve yineleme sayısı) belirtmesini 
gerektirir. Rfc2898DeriveBytes Türü bunlar için varsayılan değerleri sağlar. 










using System; 

using System.Security.Cryptography; 

using Microsoft.AspNetCore.Cryptography.KeyDerivation; 

public class Program 

{ 

public static void Main(string[] args) 

{ 

Console.Write("Enter a password: "); 
string password = Console.ReadLine(); 

// generate a 128-bit salt using a secure PRNG 

byte[] salt = new byte[128 / 8]; 

using (var rng = RandomNumberGenerator.Create()) 

{ 

rng.GetBytes(salt); 

} 

Console.WriteLine($"Salt: {Convert.ToBase64String(salt)}"); 

// derive a 256-bit subkey (use HMACSHAİ with 10,000 iterations) 
string hashed = Convert.ToBase64String(KeyDerivation.Pbkdf2( 
password: password, 
salt: salt, 

prf: KeyDerivationPrf.HMACSHAİ, 
iterationCount: 10000, 
numBytesRequested: 256 / 8)); 

Console.WriteLine($"Hashed: {hashed}"); 

} 

} 

/* 

* SAMPLE OUTPUT 

* 

* Enter a password: Xtw9NMgx 

* Salt: NZsP6NnmfBuYelrrAKNuVQ== 

* Hashed: /OOoOerl0+tGwTRDTrQSoeCxVTFr6dtYly7d0cPxIak= 

*/ 


Gerçek dünya kullanım örneği için AS P.N ET Core kimliğin PasswordHasher türü için kaynak koda bakın. 
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Burada, belirlenen bir süre sonra süresi dolan bir korumalı yükü oluşturmak için uygulama geliştiricisinin istediği 
senaryoları vardır. Örneğin, korumalı yükü yalnızca bir saat için geçerli olacak bir parola sıfırlama belirteci temsil 
edebilir. Bir katıştırılmış sona erme tarihi içeren, kendi yük biçiminde oluşturmak geliştirici için kesinlikle 
mümkündür ve ileri düzey geliştiriciler bunu yapmak isteyebilirsiniz ancak bu süre sonu yönetme geliştiricilerin 
çoğu için tedious büyüyebilir. 

Geliştirici hedef için paket kolaylaştırmak için Microsoft.AspNetCore.DataProtection.Extensions otomatik olarak 
ayarlanmış bir süre sonunda süresi dolacak yükü oluşturmak için yardımcı programı API'lerini içerir. Bu API'leri 
kapatıp askıda ITimeLimitedDataProtector türü. 

API kullanımı 

ITimeLimitedDataProtector Koruması kaldırıldıktan süre sınırlı / şirket içinde süresi dolan yükler ve koruma için 
çekirdek arabirimi arabirimidir. Bir örneğini oluşturmak için bir ITimeLimitedDataProtector , önce normal örneği 
gerekir Idataprotector belirli bir amaç ile oluşturulmuş. Bir kez iDataProtector örneği kullanılabilir, çağrı 
iDataProtector.ToTimeLimitedDataProtector bir koruyucu yerleşik bir sona erme özellikleriyle geri almak için 
genişletme yöntemi. 

ITimeLimitedDataProtector Aşağıdaki API yüzeyi ve uzantı yöntemleri sunar: 

• CreateProtector (dize amaçlı): ITimeLimitedDataProtector - bu API, varolan benzerdir 

iDataProtectionProvider.createProtector oluşturmak için kullanılabilir olduğunu amaç zincirleri kök süre 
sınırlı koruyucu öğesinden. 

• (Bayt [] düz metin, DateTimeOffset sona erme) koruma: byte] 

• Koruma (bayt [] düz metin, TimeSpan yaşam süresi): byte] 

• (Bayt [] düz) korumak: byte] 

• (Düz dize, DateTimeOffset sona erme) koruma: dize 

• Koruma (dizesi düz metin, TimeSpan yaşam süresi): dize 

• (String düz) korumak: dize 

Çekirdek yanı sıra Protect yalnızca düz metin, alan yöntemleri yükü'nın son kullanma tarihini belirterek izin veren 
yeni aşırı yüklemeleri vardır. Süre sonu mutlak bir tarih belirtilebilir (aracılığıyla bir DateTimeOffset ) veya göreli 
zaman olarak (geçerli sisteminden zaman aracılığıyla bir TimeSpan ). Bir süre sonu verdiği hızlı tepkilerden 
faydalanamamış aşırı çağrılırsa, yükü süresiz olarak kabul edilir. 

• (Bayt [] protectedData, DateTimeOffset sona erme kullanıma) korumasını: byte] 

• (Bayt [] protectedData) korumasını: byte] 

• (DateTimeOffset sona erme çıkış dizesi protectedData) korumasını: dize 

• (String protectedData) korumasını: dize 

unpnotect Yöntemleri özgün korumasız veri döndürür. Yükü henüz süresi dolmadığından, mutlak out parametresi 
özgün korumasız verileriyle birlikte isteğe bağlı olarak döndürülür. Yük süresi dolmuşsa, Unprotect yöntemin tüm 
aşırı yüklemeler CryptographicException durum oluşturur. 


















VVARNING 

Bu uzun vadeli veya belirsiz Kalıcılık gerektiren yüklerini korumak için bu API'leri kullanmak için önerilir değil. "I için bir ay sonra 
kalıcı olarak kurtarılamaz olarak korumalı yüklerin destekleyebilir?" bir iyi kural karşısında hizmet verebilen; yanıt yok sonra 
geliştiriciler alternatif API'leri düşünmelisiniz. 


Örnek kullanımlar aşağıda Dİ olmayan kod yollarını veri koruma sisteminde örnekleme için. Bu örneği çalıştırmak 
için önce Microsoft.AspNetCore.DataProtection.Extensions paketine bir başvuru eklediğinizden emin olun. 

using System; 

using System.10; 

using System.Threading; 

using Microsoft.AspNetCore.DataProtection; 

public class Program 

{ 

public static void Main(string[] args) 

{ 

// create a protector for my application 

var provider = DataProtectionProvider.Create(new DirectoryInfo(@"c:\myapp-keys\")); 
var baseProtector = provider.CreateProtector("Contoso.TimeLimitedSample"); 

// convert the normal protector into a time-limited protector 

var timeLimitedProtector = baseProtector.ToTimeLimitedDataProtector(); 

// get some input and protect it for five seconds 
Console.Write("Enter input: "); 
string input = Console.ReadLine(); 

string protectedData = timeLimitedProtector.Protect(input, lifetime: TimeSpan.FromSeconds(5)); 
Console.WriteLine($"Protected data: {protectedData}"); 

// unprotect it to demonstrate that round-tripping works properly 
string roundtripped = timeLimitedProtector.Unprotect(protectedData); 

Console.WriteLine($"Round-tripped data: {roundtripped}"); 

// wait 6 seconds and perform another unprotect, demonstrating that the payload self-expires 
Console.WriteLine("Waiting 6 seconds..."); 

Thread.Sleep(6000); 

timeLimitedProtector.Unprotect(protectedData); 

} 

} 

/* 

* SAMPLE OUTPUT 

* 

* Enter input: Hello! 

* Protected data: CfD18Hu5z0zwxn...nLk70k 

* Round-tripped data: Hello! 

* Waiting 6 seconds... 

* <<throws CryptographicException with message 'The payload expired at ...’>> 

*/ 
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ASP.NET Core veri koruma API'lerini öncelikle amaçlanmayan gizli yükü belirsiz kalıcılığını. Diğer teknolojiler ister 
Windows CNG DPAPI ve Azure Rights Management belirsiz depolama senaryosu için daha uygundur ve bunlar 
gelenlere güçlü anahtar yönetim olanaklarına sahip olursunuz. Bu, gizli verilerin uzun dönem koruma için ASP.NET 
Core veri koruma API'lerini kullanarak bir geliştirici yasaklanması bir şey yoktur söylenir. Anahtarları asla kaldırılır 
anahtar halka dışında bu nedenle iDataProtector.unprotect anahtarlar kullanılabilir ve geçerli olduğu sürece her 
zaman var olan yükü kurtarabilirsiniz. 

Ancak, geliştirici olarak iptal edilen bir anahtar ile korunan verilerin korumasını çalıştığında bir sorun ortaya çıkar 
İDataProtector.unprotect bu durumda bir özel durum oluşturur. Sistem tarafından bu tür yüklerini kolayca yeniden 
oluşturulabilir ve en kötü olasılıkla ziyaretçi yeniden oturum açmak için gerekli olabilir, bu bağlantı için (örneğin, 
kimlik doğrulama belirteçlerinizi), kısa süreli veya geçici yükü olabilir. Ancak sahip kalıcı yüklerini unprotect throvv 
kabul edilebilir veri kaybına neden olabilir. 

I Persisted Data P rotector 

iptal edilen anahtarları karşılaşıldığında bile korumasız olacak şekilde yüklerini zorlu senaryoyu desteklemek için 
veri koruma sisteminde içeren bir iPersistedDataProtector türü. Bir kopyasını almak için IPersistedDataProtector , 
yalnızca bir örneğini almak İDataProtector normal bir biçimde ve deneyin atama iDataProtector için 
IPersistedDataProtector . 


NOTE 

Tüm İDataProtector örnekleri yayımlanabilir IPersistedDataProtector . Geliştiricilerin kullanması gereken C# işleci olarak 
ya da benzeri çalışma zamanı özel durumları engellemek için neden tarafından geçersiz yayınları ve hata durumunda uygun 
şekilde işlemeye hazırlıklı olmalıdır. 


IPersistedDataProtector Aşağıdaki API yüzeyi kullanıma sunar: 

DangerousUnprotect(byte[] protectedData, bool ignoreRevocationErrors, 
out bool requiresMigration, out bool wasRevoked) : byte[] 

Bu API, korumalı Yükü (olarak, bir bayt dizisi) alır ve korumasız yükü döndürür. Hiçbir dize tabanlı aşırı yüklemesi 
vardır, iki out parametreleri aşağıdaki gibidir. 

• requiresMigration : Bu yükü korumak için kullanılan anahtarı artık etkin varsayılan anahtardır, örneğin, bu 
yükü korumak için kullanılan anahtarı eski ve işlem çalışırken bir anahtar beri varsa true olarak ayarlanırsa, 
gerçekleştirilen. Çağıran, yükü işletme gereksinimlerine bağlı olarak bulunmayı dikkate alınması gereken 
isteyebilir. 

• wasRevoked : Bu yükü korumak için kullanılan anahtarı iptal edildi durumunda true olarak ayarlayın. 













VVARNING 

Dikkatli aşırı geçerken ignoreRevocationErrors: true için DangerousUnprotect yöntemi. Bu yöntemi çağrıldıktan sonra 
eğer wasRevoked değeri true ise daha sonra bu yükü korumak için kullanılan anahtarı iptal edildi ve yükü'nın kimlik 
doğrulaması şüpheli olarak değerlendirilmelidir. Bu durumda, yalnızca korumasız yükünü, örneğin gerçek, olduğundan bazı 
ayrı güvencesi varsa çalışan bir güvenilmeyen web istemcisi tarafından gönderilen yerine güvenli bir veritabanında geldiğinden 
emin devam edin. 


using System; 
using System.10; 
using System.Text; 

using Microsoft.AspNetCore.DataProtection; 

using Microsoft.AspNetCore.DataProtection.KeyManagement; 

using Microsoft.Extensions.DependencyInjection; 

public class Program 

{ 

public static void Main(string[] args) 

{ 

var serviceCollection = new ServiceCollection(); 
serviceCollection.AddDataProtection() 

// point at a specific folder and use DPAPI to encrypt keys 
.PersistKeysToFileSystem(new DirectoryInfo(@"c: \temp-keys")) 

.ProtectKeysWithDpapi(); 

var Services = serviceCollection.BuildServiceProvider(); 

// get a protector and perform a protect operation 

var protector = Services.GetDataProtector("Sample.DangerousUnprotect"); 

Console.Write("Input: "); 

byte[] input = Encoding.UTF8.GetBytes(Console.ReadLine()); 
var protectedData = protector.Protect(input); 

Console.WriteLine($"Protected payload: {Convert.ToBase64String(protectedData)}"); 

// demonstrate that the payload round-trips properly 
var roundTripped = protector.Unprotect(protectedData); 

Console.WriteLine($"Round-tripped payload: {Encoding.UTF8.GetString(roundTripped)}"); 

// get a reference to the key manager and revoke ali keys in the key ring 
var keyManager = Services.GetService<IKeyManager>(); 

Console.WriteLine("Revoking ali keys in the key ring..."); 
keyManager.RevokeAllKeys(DateTimeOffset.NoWj "Sample revocation."); 

// try calling Protect - this should throw 
Console.WriteLine("Calling Unprotect..."); 
try 
{ 

var unprotectedPayload = protector.Unprotect(protectedData); 

Console.WriteLine($"Unprotected payload: {Encoding.UTF8.GetString(unprotectedPayload)}"); 

} 

catch (Exception ex) 

{ 

Console.WriteLine($"{ex.GetType().Name}: {ex.Message}"); 

} 

// try calling DangerousUnprotect 
Console.WriteLine("Calling DangerousUnprotect..."); 
try 
{ 

IPersistedDataProtector persistedProtector = protector as IPersistedDataProtector; 
if (persistedProtector == null) 

{ 

throw new Exception("Can’t cali DangerousUnprotect."); 

} 


bool requiresMigration, wasRevoked; 





var unprotectedPayload = persistedProtector.DangerousUnprotect( 
protectedData: protectedData, 
ignoreRevocationErrors: true, 
requiresMigration: out requiresMigration, 
wasRevoked: out wasRevoked); 

Console.WriteLine($"Unprotected payload: {Encoding.UTF8.GetString(unprotectedPayload)}"); 

Console.Writel_ine($"Requires migration = {requiresMigration}, was revoked = {wasRevoked}"); 

} 

catch (Exception ex) 

{ 

Console.WriteLine($"{ex.GetType().Name}: {ex.Message}"); 

} 

} 


SAMPLE OUTPUT 
Input: Hello! 

Protected payload: CfDJ8LHIzUCXlZVBn2BZ... 

Round-tripped payload: Hello! 

Revoking ali keys in the key ring... 

Calling Unprotect... 

CryptographicException: The key {...} has been revoked. 
Calling DangerousUnprotect... 

Unprotected payload: Hello! 

Requires migration = Truej was revoked = True 
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ASP.NET core'da veri koruma yapılandırması hakkında bilgi edinmek için bu konuları ziyaret edin: 

• ASP.NET Core veri korumasını yapılandırma 

ASP.NET Core veri korumayı yapılandırma genel bir bakış. 

• Veri koruma anahtar yönetimi ve yaşam süresi 

Veri koruma anahtar yönetimi ve yaşam süresi hakkında bilgiler. 

• Veri koruma makine geneli ilke desteği 

Veri koruma kullanan tüm uygulamalar için varsayılan bir makineye ilkesini ayarlama hakkında ayrıntılar. 

• ASP.NET core'da veri koruma için dı kullanmayan senaryolar 

Nasıl kullanılacağını DataProtectionProvider somut Dİ özgü kod yollarını olmadan veri korumayı kullanması 
için türü. 
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Veri koruma sistemi başlatıldığında, işletimsel ortama göre varsayılan ayarları uygular. Bu ayarlar, 
genellikle tek bir makinede çalışan uygulamalar için uygundur. Bir geliştiricinin varsayılan ayarları 
değiştirmek isteyebileceğiniz durumlar vardır: 

• Uygulama birden çok makineye yayılır. 

• Uyumluluk nedenleriyle. 

Bu senaryolar için veri koruma sistemi, zengin bir yapılandırma API 'SI sunar. 


VVARNING 

Yapılandırma dosyalarına benzer şekilde, veri koruma anahtarı halkası uygun izinler kullanılarak korunmalıdır. Rest 'de 
anahtarları şifrelemeyi seçebilirsiniz, ancak bu, saldırganların yeni anahtar oluşturmasını engellemez. Sonuç olarak, 
uygulamanızın güvenliği etkilenir. Veri koruma ile yapılandırılan depolama konumu, yapılandırma dosyalarını 
korumanıza benzer şekilde uygulamanın kendisiyle sınırlı olmalıdır. Örneğin, anahtar halkasını diskte depolamayı 
seçerseniz, dosya sistemi izinleri 1 ni kullanın. Yalnızca Web uygulamanızın çalıştırıldığı kimliğin bu dizine okuma, 
yazma ve oluşturma erişimi olduğundan emin olun. Azure Blob depolama kullanırsanız, yalnızca Web uygulaması 
Blob deposunda, vb. için yeni girişler okuma, yazma veya oluşturma yeteneğine sahip olmalıdır. 

Adddataprotection genişletme yöntemi bir ıdataprotectionbuilderdöndürür. iDataProtectionBuilder , veri koruma 
seçeneklerini yapılandırmak için birlikte zincirleyebilirsiniz uzantı yöntemleri sunar. 


P rotect KeysVVit h Azu re Key Vau İt 

Anahtarları Azure Key Vaultiçinde depolamak için, stantup sınıfında sistemi 
ProtectKeysVVİthAzureKeyVault ile yapılandırın: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDataProtection() 

.PersistKeysToAzureBlobStorage(new Uri("<blobUriWithSasToken>")) 

.ProtectKeysWithAzureKeyVault("<keyldentifier>", "<ClientId >", "<clientSecret>"); 

} 

Anahtar halka depolama konumunu ayarlayın (örneğin, PersistKeysToAzureBlobStorage). Çağırma 
ProtectKeyswithAzureKeyvauit , anahtar halka depolama konumu da dahil olmak üzere otomatik veri 
koruma ayarlarını devre dışı bırakan bir ıxmlencryptor uyguladığından, konum ayarlanmalıdır. Yukarıdaki 
örnek, anahtar halkasını sürdürmek için Azure Blob depolamayı kullanır. Daha fazla bilgi için bkz. anahtar 
depolama sağlayıcıları: Azure Storage. Ayrıca, Persistkeystofilesystemile anahtar halkasını yerel olarak kalıcı 
hale getirebilirsiniz. 

keyidentifier , anahtar şifreleme için kullanılan Anahtar Kasası anahtar tanımlayıcısıdır.Örneğin, 
contosokeyvault dataprotection adlı anahtar kasasında oluşturulan bir anahtarın anahtar tanımlayıcısı 
https://contosokeyvault.vault.azure.net/keys/datapnotection/ vardır. Anahtar Kasası için anahtar 
sarmalama ve sarmalama anahtarı izinlerini içeren uygulamayı belirtin. 

ProtectKeysl/dithAzureKeyVault Aş I r I Yüklemeler: 

• ProtectKeysVVİthAzureKeyVault (ıdataprotectionbuilder, keyvaultclient, String) , veri koruma sisteminin 











anahtar kasasını kullanmasını sağlamak İçin bir keyvaultclient kullanılmasına izin verir. 

• ProtectKeysVVithAzureKeyVault (ıdataprotectionbuilder, String, String, X509Certificate2) , veri koruma 
sisteminin anahtar kasasını kullanmasını sağlamak için bir ciientid ve X509Certificate kullanılmasına 
izin verir. 

• ProtectKeysVVithAzureKeyVault (ıdataprotectionbuilder, String, String, String) , veri koruma sisteminin 
anahtar kasasını kullanmasını sağlamak için bir ciientid ve ciientsecret kullanılmasına izin verir. 

PersistKeysToFileSystem 

Anahtarları % LocalAppData% varsayılan konumu yerine bir UNC paylaşımında depolamak için, sistemi 

Persistkeystofilesystemile yapılandırın: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDataProtection() 

.PersistKeysToFileSystem(new DirectoryInfo(@"\\server\share\directory\")); 

} 


VVARNING 

Anahtar Kalıcılık konumunu değiştirirseniz, DPAPI 'nın uygun bir şifreleme mekanizması olup olmadığını bilmez 
olmadığından, sistem artık, bekleyen anahtarları otomatik olarak şifreler. 


ProtectKeysVVith* 

Sistemi, ProtectKeysVVith* Yapılandırma API 'lerinden herhangi birini çağırarak, bekleyen anahtarları 
koruyacak şekilde yapılandırabiIirsiniz. Anahtarları bir UNC paylaşımında depolayan ve bu anahtarları 
belirli bir X. 509.952 sertifikasıyla bekleyen bir şekilde şifreleyen aşağıdaki örneği göz önünde bulundurun: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDataProtection() 

.PersistKeysToFileSystem(new DirectoryInfo(@"\\server\share\directory\")) 

.ProtectKeysWithCertificate("thumbprint"); 


ASP.NET Core 2,1 veya üzeri sürümlerde, bir dosyadan yüklenen sertifika gibi bir X509Certificate2 için 
ProtectKeysVVİthCertificatesağlayabi lirsiniz: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDataProtection() 

.PersistKeysToFileSystem(new DirectoryInfo(@"\\server\share\directory\")) 

.ProtectKeysWithCertificate( 

new X509Certificate2("certificate.pfx"j "password"))j 

} 


Yerleşik anahtar şifreleme mekanizmalarından daha fazla örnek ve tartışma için bkz. rest 'de anahtar 
şifreleme . 

U n protect KeysVVith AnyCertificate 

ASP.NET Core 2,1 veya sonraki sürümlerde, UnprotectKeysVVİthAnyCertificateile X509Certificate2 
sertifikaları dizisini kullanarak sertifikaları döndürebilir ve anahtarların şifrelerini çözebilirsiniz: 









public void ConfigureSenvices(IServiceCollection Services) 

{ 

Services.AddDataProtection() 

.PersistKeysToFileSystem(new DirectoryInfo(@"\\server\share\directory\")) 

.ProtectKeysWithCertificate( 

new X509Certificate2("certificate.pfx"j "password")); 

.UnprotectKeysWithAnyCertificate( 

new X509Certificate2("certificate_old_l.pfx ", "password_l "), 
new X509Certificate2("certificate_old_2.pfx ", "password_2")); 

} 


SetDefaultKeyLifetime 

Sistemi varsayılan 90 gün yerine 14 günlük bir anahtar yaşam süresi kullanacak şekilde yapılandırmak için 

S etdefaultkeylifetimeku İlanın: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDataProtection() 

.SetDefaultKeyLifetime(TimeSpan.FromDays(14)); 

} 

SetApplicationName 

Varsayılan olarak, veri koruma sistemi, aynı fiziksel anahtar deposunu paylaşsalar bile, uygulamaları içerik 
kök yollarına göre birbirinden yalıtır. Bu, uygulamaların birbirlerinin korunan yüklerini anlamasına engel 
olur. 

Korumalı yükleri uygulamalar arasında paylaşmak için: 

• Aynı değere sahip her uygulamadaki SetApplicationName yapılandırın. 

• Uygulamalar genelinde veri koruma API yığınının aynı sürümünü kullanın. Uygulamaların proje 

dosyalarında aşağıdakilerden birini yapın: 

o Microsoft. AspNetCore. app metapackagearacılığıyla aynı paylaşılan çerçeve sürümüne 
başvurun. 

o Aynı veri koruma paketi sürümüne başvurun. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDataProtection() 

.SetApplicationName("shared app name"); 

} 


DisableAutomaticKeyGeneration 

Süre sonu yaklaşımında bir uygulamanın anahtarları otomatik olarak (yeni anahtar oluştur) oluşturmasını 
istemediğiniz bir senaryoya sahip olabilirsiniz. Bunun bir örneği, birincil/ikincil ilişkide ayarlanmış 
uygulamalar olabilir; burada yalnızca birincil uygulama önemli yönetim kaygılarıyla sorumludur ve ikincil 
uygulamalar yalnızca bir anahtar halkasının Salt okunabilir bir görünümüne sahip olur, ikincil uygulamalar, 
sistemi DisableAutomaticKeyGenerationile yapılandırarak anahtar halkasını Salt okunabilir olarak işleyecek 
şekilde yapılandırılabilir: 




public void ConfigureServices(IServiceCollection Services) 
{ 

Services.AddDataProtection() 

.DisableAutomaticKeyGeneration(); 

} 


Uygulama başına yalıtım 

Veri koruma sistemi bir ASP.NET Core ana bilgisayar tarafından sağlandığında, bu uygulamalar aynı 
çalışan işlemi hesabı altında çalışıyor ve aynı ana anahtarlama malzemesini kullanıyor olsa bile, 
uygulamaları otomatik olarak birbirinden yalıtır. Bu, System. Web 'in <machineKey> öğesinden ısoteapps 
değiştiricisine biraz benzer. 

Yalıtım mekanizması, yerel makinedeki her uygulamayı benzersiz bir kiracı olarak düşünürken çalışarak, 
belirli bir uygulama için kök olan IDataProtector otomatik olarak uygulama KİMLİĞİ 1 ni Ayrıştırıcı olarak 
içerir. Uygulamanın benzersiz KİMLİĞİ uygulamanın fiziksel yoludur: 

• 11S 'de barındırılan uygulamalar için benzersiz KİMLİK, uygulamanın 11S fiziksel yoludur.Bir uygulama 
bir Web grubu ortamında dağıtılırsa, bu değer, IIS ortamlarının Web grubundaki tüm makinelerde 
benzer şekilde yapılandırıldığından kararlı bir şekilde yapılır. 

• Kestrel sunucusundaçalışan şirket içinde barındırılan uygulamalar İÇİN benzersiz kimlik, diskteki 
uygulamanın fiziksel yoludur. 

Benzersiz tanımlayıcı, her iki uygulamanın ve makinenin kendisi—sıfırlamaları için tasarlanmıştır. 

Bu yalıtım mekanizması, uygulamaların kötü amaçlı olmayan olduğunu varsayar. Kötü amaçlı bir uygulama, 
aynı çalışan işlem hesabı altında çalışan diğer uygulamaları her zaman etkileyebilir. Uygulamaların birbirini 
dışlayan bir paylaşılan barındırma ortamında, barındırma sağlayıcısı, uygulamaların temel alınan anahtar 
depolarını ayırmak dahil olmak üzere uygulamalar arasında işletim sistemi düzeyinde yalıtımlarını 
sağlamak için gerekli adımları almalıdır. 

Veri koruma sistemi bir AS P.N ET Core ana bilgisayar tarafından sağlanmazsa (örneğin, 
DataProtectionProvider somut tür aracılığıyla örneğini oluşturursanız), uygulama yalıtımı varsayılan olarak 
devre dışıdır. Uygulama yalıtımı devre dışı bırakıldığında, aynı anahtarlama malzemesi tarafından 
desteklenen tüm uygulamalar, uygun amaçlarısağladıkları sürece yükleri paylaşabilir. Bu ortamda 
uygulama yalıtımı sağlamak için, yapılandırma nesnesinde Setapplicationname metodunu çağırın ve her 
bir uygulama için benzersiz bir ad sağlayın. 

Usecryptographicalgoritmalarıyla algoritmaları değiştirme 

Veri koruma yığını, yeni oluşturulan anahtarlar tarafından kullanılan varsayılan algoritmayı değiştirmenize 
izin verir. Bunu yapmanın en kolay yolu, yapılandırma geri çağrısından Usecryptographicalgoritmaların 
çağırmasıdır: 

Services.AddDataProtection() 

.UseCryptographicAlgorithms( 

new AuthenticatedEncryptorConfiguration() 

{ 

EncryptionAlgorithm = EncryptionAlgorithm.AES_256_CBC, 

ValidationAlgorithm = ValidationAlgorithm.HMACSHA256 

}); 








Services.AddDataProtection() 

.UseCryptographicAlgorithms( 

new AuthenticatedEncryptionSettings() 

{ 

EncryptionAlgorithm = EncryptionAlgorithm.AES_256_CBC, 

ValidationAlgorithm = ValidationAlgorithm.HMACSHA256 

}); 

Varsayılan EncryptionAlgorithm AES-256-CBC, varsayılan ValidationAlgorithm ise HMACSHA256. 
Varsayılan ilke, bir sistem yöneticisi tarafından makine genelindeki bir ilkearacı lığıyla ayarlanabilir, ancak 
useCryptographicAlgorithms için açık bir çağrı varsayılan ilkeyi geçersiz kılar. 

useCryptographicAlgorithms çağırmak, önceden tanımlanmış bir yerleşik listeden istediğiniz algoritmayı 
belirtmenize olanak tanır. Algoritmanın uygulanması konusunda endişelenmeniz gerekmez. Yukarıdaki 
senaryoda, veri koruma sistemi VVİndovvs üzerinde çalışıyorsa AES 'nin CNG uygulamasını kullanmaya 
çalışır. Aksi takdirde, yönetilen System. Security. Cryptography. AES sınıfına geri döner. 

Bir uygulamayı Usecustomccryptotographicalgoritmalarınabir çağrı yoluyla el ile belirtebilirsiniz. 


TIP 

Algoritmaların değiştirilmesi, anahtar halkasının varolan anahtarlarını etkilemez. Yalnızca yeni oluşturulan anahtarları 
etkiler. 


Özel yönetilen algoritmaları belirtme 

Özel yönetilen algoritmaları belirtmek için, uygulama türlerini işaret eden bir Managedadıbir 
Catedencryptorconfiguration örneği oluşturun: 

serviceCollection.AddDataProtection() 

.UseCustomCryptographicAlgorithms( 

new ManagedAuthenticatedEncryptorConfigurationO 

{ 

// A type that subclasses SymmetricAlgorithm 
EncryptionAlgorithmType = typeof(Aes), 

// Specified in bits 
EncryptionAlgorithmKeySize = 256, 

// A type that subclasses KeyedHashAlgorithm 
ValidationAlgorithmType = typeof(HMACSHA256) 

}); 

Özel yönetilen algoritmaları belirtmek için, uygulama türlerini işaret eden bir 

Managedavılationcatedencryptionsettings örneği oluşturun: 








serviceCollection.AddDataProtection() 

.UseCustomCryptographicAlgorithms( 

new ManagedAuthenticatedEncryptionSettings() 

{ 

// A type that subclasses SymmetricAlgorithm 
EncryptionAlgorithmType = typeof(Aes), 

// Specified in bits 
EncryptionAlgorithmKeySize = 256, 

// A type that subclasses KeyedHashAlgorithm 
ValidationAlgorithmType = typeof(HMACSHA256) 


Genellikle *türü özellikleri, SymmetricAlgorithm ve KeyedHashAlgorithm' nin somut, instantiable (Ortak 
parametresiz ctor aracılığıyla), ancak sistem özel durumları için typeof(Aes) gibi bazı değerler sağlar. 


NOTE 

SymmetricAlgorithm, > 128 bitlerinin anahtar uzunluğuna ve > 64 bit blok boyutuna sahip olmalıdır ve PKCS #7 
dolgusu ile CBC modunda şifrelemeyi desteklemelidir. KeyedHashAlgorithm > = 128 bitlik bir Özet boyutuna sahip 
olmalıdır ve karma algoritmanın Özet uzunluğuna eşit olan anahtarların uzunluğunu desteklemelidir. 
KeyedHashAlgorithm, HMAC için kesinlikle gerekli değildir. 


Özel Windows CNG algoritmaları belirtme 

HMAC doğrulama ile CBC modunda şifrelemeyi kullanarak özel bir VVİndovvs CNG algoritması belirtmek 
için algoritmik bilgilerini içeren bir Cngcbcauthenticatedencryptorconfiguration örneği oluşturun: 

Services.AddDataPnotection() 

.UseCustomCryptographicAlgorithms( 

new CngCbcAuthenticatedEncryptorConfiguration() 

{ 

// Passed to BCryptOpenAlgorithmProvider 
EncryptionAlgorithm = "AES", 

EncryptionAlgorithmProvider = null, 

// Specified in bits 
EncryptionAlgorithmKeySize = 256, 

// Passed to BCryptOpenAlgorithmProvider 
HashAlgorithm = "SHA256", 

HashAlgorithmProvider = null 

}); 


HMAC doğrulama ile CBC modunda şifrelemeyi kullanarak özel bir VVİndovvs CNG algoritması belirtmek 
için algoritmik bilgilerini içeren bir Cngcbcauthenticatedencryptionsettings örneği oluşturun: 







Services.AddDataProtection() 

.UseCustomCryptographicAlgorithms( 

new CngCbcAuthenticatedEncryptionSettings() 

{ 

// Passed to BCryptOpenAlgorithmProvider 
EncryptionAlgorithm = "AES", 
EncryptionAlgorithmProvider = null, 

// Specified in bits 
EncryptionAlgorithmKeySize = 256, 

// Passed to BCryptOpenAlgorithmProvider 
HashAlgorithm = "SHA256", 
HashAlgorithmProvider = null 

}); 


NOTE 

Simetrik blok şifreleme algoritmasının anahtar uzunluğu > = 128 bit, > = 64 bit blok boyutunda olmalıdır ve PKCS 
#7 dolgusu ile CBC modunda şifrelemeyi desteklemesi gerekir. Karma algoritmasının > = 128 bitlik bir Özet boyutu 
olmalıdır ve BCRYPT_ALG_tanıtıcı_HMAC_bayrak bayrağıyla birlikte açılmakta olmaları gerekir. *sağlayıcısı özellikleri, 
belirtilen algoritma için varsayılan sağlayıcıyı kullanmak üzere null olarak ayarlanabilir. Daha fazla bilgi için 
BCryptOpenAlgorithmProvider belgelerine bakın. 


Doğrulama ile Galoa/sayaç modu şifrelemesini kullanarak özel bir VVİndovvs CNG algoritması belirtmek 
için, algoritmik bilgilerini içeren bir Cnggcmagıncatedencryptorconfiguration örneği oluşturun: 


Services.AddDataProtection() 

.UseCustomCryptographicAlgorithms( 

new CngGcmAuthenticatedEncryptorConfiguration() 

{ 

// Passed to BCryptOpenAlgorithmProvider 
EncryptionAlgorithm = "AES", 
EncryptionAlgorithmProvider = null, 

// Specified in bits 
EncryptionAlgorithmKeySize = 256 


Doğrulama ile Galoa/sayaç modu şifrelemesini kullanarak özel bir VVİndovvs CNG algoritması belirtmek 
için algoritmik bilgilerini içeren bir Cnggcmagıncatedencryptionsettings örneği oluşturun: 

Services.AddDataProtection() 

.UseCustomCryptographicAlgorithms( 

new CngGcmAuthenticatedEncryptionSettings() 

{ 

// Passed to BCryptOpenAlgorithmProvider 
EncryptionAlgorithm = "AES", 

EncryptionAlgorithmProvider = null, 

// Specified in bits 
EncryptionAlgorithmKeySize = 256 






NOTE 

Simetrik blok şifreleme algoritmasının anahtar uzunluğu > = 128 bit, tam olarak 128 bit blok boyutu ve GCM 
şifrelemesini desteklemesi gerekir. EncryptionAlgorithmProvider özelliğini, belirtilen algoritma için varsayılan 
sağlayıcıyı kullanacak şekilde null olarak ayarlayabilirsiniz. Daha fazla bilgi için BCryptOpenAlgorithmProvider 
belgelerine bakın. 


Diğer özel algoritmaları belirtme 

Birinci sınıf bir API olarak gösterilmese de, veri koruma sistemi neredeyse her türlü algoritmanın 
belirtilmesine izin verecek kadar genişletilebilir. Örneğin, bir donanım güvenlik modülü (HSM) içinde yer 
alan tüm anahtarları tutmak ve çekirdek şifreleme ve şifre çözme yordamlarının özel bir uygulamasını 
sağlamak mümkündür. Daha fazla bilgi için bkz. çekirdek şifreleme genişletilebilirliği İçindeki 

lauthenticatedencryptor . 

Docker kapsayıcısında barındırırken kalıcı anahtarlar 

Bir Docker kapsayıcısında barındırırken anahtarların şu şekilde tutulması gerekir: 

• Paylaşılan bir birim veya ana bilgisayar ile takılan bir birim gibi kapsayıcının yaşam süresinden sonra 
devam eden bir Docker birimi olan bir klasör. 

• Azure Key Vault veya redingibi bir dış sağlayıcı. 

Redsıs ile kalıcı anahtarlar 

Anahtarları depolamak için yalnızca redsıs veri kalıcılığını destekleyen redsıs sürümleri kullanılmalıdır. 
Azure Blob depolama kalıcıdır ve anahtarları depolamak için kullanılabilir. Daha fazla bilgi için bu GitHub 
sorunu. 

Ek kaynaklar 

• ASP.NET core'da veri koruma için dı kullanmayan senaryolar 

• Veri koruma makine geneli ilke içinde ASP.NET Core desteği 

• Web çiftliğinde AS P.N ET Core ana bilgisayar 

• ASP.NET core'da anahtar depolama sağlayıcıları 
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Tarafından Rick Anderson 

Anahtar yönetimi 

Uygulama, işletimsel ortamı algılamak ve kendi anahtar yapılandırması işlemek çalışır. 

1. Uygulama içinde barındırıIiyorsa Azure uygulamaları, anahtarları kaldı 

%H O M E%\AS PN ET\Data Protection-Keys klasör. Bu klasör, ağ depolaması tarafından desteklenir ve 
uygulamayı barındıran tüm makinelerde eşitlenir. 

• Anahtarlar, bekleme sırasında korunmayan. 

• Data Protection-Keys klasör anahtar halkası tek dağıtım yuvasındaki bir uygulamanın tüm örnekleri 
sağlar. 

• Hazırlama ve üretim gibi farklı dağıtım yuvaları, anahtar halkası paylaşmayın. Örneğin hazırlık-üretim 
değiştirmeyi veya kullanan bir dağıtım yuvası arasında taktığınızda / B testi, veri korumayı kullanarak 
herhangi bir uygulama anahtarı halka önceki yuvasına kullanarak depolanan verilerin şifresini çözmek 
mümkün olmayacaktır. Bu, veri koruma, tanımlama bilgilerini korumak için kullandığı standart 
ASP.NET Core tanımlama bilgisi kimlik doğrulaması kullanan bir uygulamanın oturumunu günlüğe 
kaydedilmesini kullanıcılara yol açar. Yuva bağımsız anahtar halkaları isterse, Azure Blob Depolama, 

Azure Key Vault, bir SQL depolama gibi bir dış anahtar halkası sağlayıcısı kullanma veya Redis 
önbelleği. 

2. Anahtarları kalıcı kullanıcı profili varsa, %LOCALAPPDATA%\ASPNET\DataProtection-Keys klasör. 

Windows işletim sistemi olması halinde, anahtarları DPAPI kullanılarak, bekleme sırasında şifrelenir. 

Uygulama havuzunun setProfileEnvironment özniteliği etkinleştirilmiş olması da gerekir. Varsayılan değer 
olan setProfileEnvironment olduğu true . (Örneğin, Windows işletim sistemi), bazı senaryolarda 
setProfileEnvironment ayarlanır faise . Kullanıcı profili dizinde anahtarları depolanmaz, beklenen: 

a. Gidin %windir%/system32/inetsrv/config klasör. 

b. Açık applicationHost.config dosya. 

C. Bulun <system.applicationHost><applicationPoolsxapplicationPoolDefaultsxprocessModel> Öğesi, 
d. Onaylayın setProfileEnvironment özniteliği mevcut olmadığında, bunun varsayılan değeri için true, 
veya özniteliğin değerini açık olarak true . 

3. Uygulama HS'de barı ndırı I iyorsa, anahtarları ACLed yalnızca çalışan işlem hesabı için bir özel kayıt defteri 
anahtarı 1 HKLM Kayıt defterine kalıcıdır. Anahtarları DPAPI kullanılarak, bekleme sırasında şifrelenir. 

4. Bu koşulların hiçbiri eşleşirse, anahtarları geçerli işlemin dışında kalıcı değildir, işlem oluşturulan tüm aşağı 
kapattığında anahtarları kaybolur. 

Geliştirici her zaman tam denetimi ve nasıl ve anahtarları depolandığı geçersiz kılabilirsiniz. Yukarıdaki ilk üç 
seçenekten nasıl benzer uygulamaların çoğu için varsayılan sağlamalıdır ASP.NET cmachineKey > otomatik 
üretimi yordamları çalışan geçmiş. Son, geri dönüş seçeneği belirlemek Geliştirici gerektiren yalnızca senaryodur 
yapılandırma ön anahtar kalıcılığı istediği, ancak bu geri dönüş yalnızca nadir durumlarda oluşur. 

Bir Docker kapsayıcısında barındırırken, anahtarları bir Docker birim (bir paylaşılan veya kapsayıcının ömründen 
uzun kalıcı bir ana bilgisayar bağlı biriminde) bir klasörde kalıcı veya bir dış sağlayıcı gibi Azure anahtar kasası 












veya Redis. Bir dış sağlayıcı ayrıca uygulamaları bir paylaşılan ağ birime erişememesi durumunda web grubu 
senaryolarda yararlı olur, (bkz PersistKeysToFileSystem daha fazla bilgi için). 


VVARNING 

Geliştirici yukarıda özetlenen kuralları geçersiz kılar ve veri koruma sisteminde belirli bir anahtar deposunda işaret otomatik 
şifreleme anahtarlarının bekleyen devre dışı bırakılır. Bekleyen koruma aracılığıyla yeniden etkin olabilir yapılandırma. 


Anahtar yaşam süresi 

Anahtarları, varsayılan olarak 90 günlük bir ömrü vardır. Bir anahtar geçerlilik süresi dolduğunda, uygulama, 
otomatik olarak yeni bir anahtar oluşturur ve yeni anahtar etkin anahtar ayarlar. Devre dışı bırakılan anahtarları 
sistemde kaldığı sürece, uygulamanız ile korunan tüm verileri şifresini çözebilir. Bkz: anahtar yönetimi daha fazla 
bilgi için. 

Varsayılan algoritmaları 

Kullanılan varsayılan yükü koruma algoritması AES-256-CBC, gizliliği ve HMACSHA256 kimlik doğrulaması için 
içindir. Her 90 günde değiştirilmiş bir 512 bit ana anahtar, bu algoritmalar yükü başına temelinde kullanılan iki alt 
anahtar türetme kullanılır. Bkz: alt anahtarını türetme daha fazla bilgi için. 

Ek kaynaklar 

• ASP.NET Core anahtar yönetimi genişletilebilirliği 

• Web çiftliğinde AS P.N ET Core ana bilgisayar 
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Windows üzerinde çalışırken, veri koruma sisteminde bir ASP.NET Core veri koruması kullanan tüm uygulamalar 
için varsayılan makine geneli ilke ayarlamak için destek sınırlıdır. Genel yönetici gibi kullanılan algoritmalar 
varsayılan ayarı veya anahtar kullanım süresi, her uygulama makinede el ile güncelleştirmek zorunda kalmadan 
değiştirmek isteyebileceğiniz olur. 


VVARNING 

Sistem Yöneticisi varsayılan ilkesi ayarlayabilirsiniz ancak onu zorla uygulayamaz. Uygulama geliştiricisi biriyle kendi seçerek 
herhangi bir değer her zaman geçersiz kılabilirsiniz. Varsayılan ilke, yalnızca bir ayar için açık bir değer Geliştirici burada 
belirtilen edilmemiş uygulamalar etkiler. 


Varsayılan ilke ayarını 

Varsayılan ilkesini ayarlamak için yönetici bilinen değerler sistem kayıt defterinde aşağıdaki kayıt defteri anahtarı 
altında ayarlayabilirsiniz: 

HKLM\SOFTWARE\Microsoft\DotNetPackages\Microsoft.AspNetCore.DataProtection 

Bir 64-bit işletim sisteminde yapıyorsanız ve 32-bit uygulamaları davranışını etkilemek istiyorsunuz, yukarıdaki 
anahtar Wow6432Node denk yapılandırmayı unutmayın. 

Desteklenen değerler aşağıda gösterilmektedir. 


DEĞER 

TÜR 

AÇIKLAMA 

EncryptionType 

dize 

Hangi algoritmaları veri koruma için 
kullanılması gerektiğini belirtir. Değer, 
CNG CBC, CNG GCM veya yönetilen 
olmalıdır ve aşağıda daha ayrıntılı 
olarak açıklanmıştır. 


DefaultKeyLifetime 


DVVORD 


Yeni oluşturulan anahtarları için yaşam 
süresini belirtir. Değer, gün içinde 
belirtilen ve olmalıdır > = 7. 


KeyEscrovvSinks dize Anahtar emanet için kullanılan türlerini 

belirtir. Listedeki her öğe uygulayan bir 
tür bütünleştirilmiş kodla nitelenen adı 
olduğu anahtar emanet havuzlarını 
noktalı virgülle ayrılmış listesini değerdir 
IKeyEscrovvSink. 


Şifreleme türleri 


CNG CBC EncryptionType ise sistem CBC modunda simetrik blok şifreleme gizliliği ve HMAC için kimlik 







doğrulaması için VVİndovvs CNG tarafından sağlanan hizmetleri ile kullanmak üzere yapılandırılmış (bkz özel 
Windows CNG algoritmaları belirtme için Daha fazla ayrıntı). Aşağıdaki ek değerler desteklenir, her biri 
CngCbcAuthenticatedEncryptionSettings türünde bir özelliğe karşılık gelir. 


DEĞER 

TÜR 

AÇIKLAMA 

EncryptionAlgorithm 

dize 

CNG tarafından anlaşılan bir simetrik 
blok şifreleme algoritması adı. Bu 
algoritma CBC modunda açılır. 

EncryptionAlgorithmProvider 

dize 

Algoritma EncryptionAlgorithm 
üretebilir CNG sağlayıcıyı uygulama adı. 

EncryptionAlgorithmKeySize 

DVVORD 

Blok simetrik şifreleme algoritması 


türetmek için anahtar uzunluğu (bit 
cinsinden). 


HashAlgorithm dize CNG tarafından anlaşılan bir karma 

algoritması adı. Bu algoritma HMAC 
modunda açılır. 

HashAlgorithmProvider dize Algoritma HashAlgorithm üretebilir 

CNG sağlayıcıyı uygulama adı. 

CNG GCM EncryptionType ise sistem Galois/sayacı modu simetrik blok şifreleme gizlilik ve kimlik doğrulama 
için VVİndovvs CNG tarafından sağlanan hizmetleri ile kullanmak üzere yapılandırılmış (bkz özel VVİndovvs CNG 
algoritmaları belirtme Daha fazla ayrıntı için). Aşağıdaki ek değerler desteklenir, her biri 
CngGcmAuthenticatedEncryptionSettings türünde bir özelliğe karşılık gelir. 


DEĞER 

TÜR 

AÇIKLAMA 

EncryptionAlgorithm 

dize 

CNG tarafından anlaşılan bir simetrik 


blok şifreleme algoritması adı. Bu 
algoritma Galois/sayacı modunda açılır. 


EncryptionAlgorithmProvider dize Algoritma EncryptionAlgorithm 

üretebilir CNG sağlayıcıyı uygulama adı. 

EncryptionAlgorithmKeySize DVVORD Blok simetrik şifreleme algoritması 

türetmek için anahtar uzunluğu (bit 
cinsinden). 

EncryptionType yönetiliyorsa, sistemin bir yönetilen SymmetricAlgorithm gizliliği ve KeyedHashAlgorithm için 
kimlik doğrulaması için kullanmak üzere yapılandırılmış (bkz belirtme özel yönetilen algoritmaları daha fazla 
ayrıntı için). Aşağıdaki ek değerler desteklenir, her biri ManagedAuthenticatedEncryptionSettings türünde bir 
özelliğe karşılık gelir. 


DEĞER 

TÜR 

AÇIKLAMA 

EncryptionAlgorithmType 

dize 

SymmetricAlgorithm uygulayan bir tür 
bütünleştirilmiş kodla nitelenen adı. 

EncryptionAlgorithmKeySize 

DVVORD 

Simetrik şifreleme algoritması için 
türetmek için anahtar uzunluğu (bit 
cinsinden). 


DEĞER 


TÜR 


AÇIKLAMA 


ValidationAlgorithmType dize KeyedHashAlgorithm uygulayan bir tür 

bütünleştirilmiş kodla nitelenen adı. 

EncryptionType başka bir değer null dışında ya da boş varsa, veri koruma sisteminde başlatma sırasında bir özel 
durum oluşturur. 


VVARNING 

Tür adları (EncryptionAlgorithmType, ValidationAlgorithmType, KeyEscrovvSinks) içeren bir varsayılan ilke ayarını 
yapılandırırken türleri uygulamaya kullanılabilir olması gerekir. Başka bir deyişle, Masaüstü CLR'sini üzerinde çalışan 
uygulamalar için bu türleri içeren derlemeler Genel Derleme Önbelleği'ne (GAC) mevcut olmalıdır. .NET Core üzerinde çalışan 
ASP.NET Core uygulamaları için bu türleri içeren paketleri yüklü olması gerekir. 




ASPNET core'da veri koruma için dı kullanmayan 
senaryolar 

17.06.2019 • 3 minutes to read ı Edit Online 


Tarafından RickAnderson 

AS P.N ET Core veri koruma normalde sistemidir hizmet kapsayıcıya eklenen ve bağımlılık ekleme (dı) aracılığıyla 
bağımlı bileşenler tarafından kullanılır. Ancak, burada bu değildir uygun ya da istediğiniz durumlar vardır özellikle 
sistem var olan bir uygulamayı içeri aktarılırken. 

Bu senaryoları desteklemek için Microsoft.AspNetCore.DataProtection.Extensions paket sağlar somut bir türde 
DataProtectionProvider, veri korumayı kullanması için basit bir yol sunar Dİ üzerinde bağlı olmadan. 
DataProtectionProvider Yazın uygular I DataProtectionProvider. Oluşturma DataProtectionProvider yalnızca 
sağlanmasını gerektirir, bir Directorylnfo sağlayıcıya ait şifreleme anahtarlarını depolanması gereken yere, 
aşağıdaki kod örneğinde görüldüğü gibi göstermek için örnek: 




using System; 
using System.10; 

using Microsoft.AspNetCore.DataProtection; 

public class Program 

{ 

public static void Main(string[] args) 

{ 

// Get the path to %LOCALAPPDATA%\myapp-keys 
var destFolder = Path.Combine( 

System.Environment.GetEnvironmentVariable("LOCALAPPDATA "), 

"myapp-keys"); 

// Instantiate the data protection system at this folder 
var dataProtectionProvider = DataProtectionProvider.Create( 
new Directorylnfo(destFolder)); 

var protector = dataProtectionProvider.CreateProtector("Program.No-DI"); 

Console.Write("Enter input: "); 
var input = Console.ReadLine(); 

// Protect the payload 

var protectedPayload = protector.Protect(input); 

Console.Writel_ine($"Protect returned: {protectedPayload}"); 

// Unprotect the payload 

var unprotectedPayload = protector.Unprotect(protectedPayload); 

Console. Writel_ine($"Unprotect returned: {unprotectedPayload}"); 

Console.WriteLine(); 

Console.WriteLine("Press any key..."); 

Console.ReadKey(); 

} 

} 

/* 

* SAMPLE OUTPUT 

* 

* Enter input: Flello world! 

* Protect returned: CfDD8FWbAn6...ch3hAPmlN3A 

* Unprotect returned: Hello world! 

* 

* Press any key... 

*/ 

Varsayılan olarak, DataProtectionProvider somut bir türde değil ham anahtar malzemesi şifreleme dosya sistemi 
için önce kalıcı. Burada bir ağ paylaşımı ve veri koruma sisteminde Geliştirici noktalara uygun bekleyen bir 
anahtar şifreleme mekanizması otomatik olarak çıkarılamıyor senaryolarını desteklemek üzere budur. 

Ayrıca, DataProtectionProvider somut bir türde değil Ayır uygulamalar varsayılan olarak. Anahtar ile aynı dizine 
kullanarak tüm uygulamaları yüklerini sürece paylaşabilirsiniz kendi amaç parametreleri eşleşmesi. 

DataProtectionProvider Oluşturucusu sistem davranışlarını ayarlamak için kullanılan isteğe bağlı yapılandırma 
geri çağırma kabul eder. Aşağıdaki örnekte, geri yükleme için açık çağrı yalıtımıyla gösterir SetApplicationName. 
Örnek ayrıca, sistem otomatik olarak Windows DPAPI kullanarak kalıcı anahtarlarını şifrelemek için yapılandırma 
gösterir. Dizini için bir UNC paylaşımı işaret ediyorsa, paylaşılan sertifika ilgili tüm makinelerde dağıtmak ve 
sertifika tabanlı şifreleme çağrısı ile kullanmak için sistemi yapılandırmak için hazırlandığını 
P rotect Key s W ith C ertif i cate. 






using System; 
using System.10; 

using Microsoft.AspNetCore.DataProtection; 

public class Program 

{ 

public static void Main(string[] args) 

{ 

// Get the path to %LOCALAPPDATA%\myapp-keys 
var destFolder = Path.Combine( 

System.Environment.GetEnvironmentVariable("LOCALAPPDATA "), 
"myapp-keys"); 

// Instantiate the data protection system at this folder 
var dataProtectionProvider = DataProtectionProvider.Create( 
new Directorylnfo(destFolder), 
configuration => 

{ 

configuration.SetApplicationName("my app name"); 
configuration. ProtectKeysl/dithDpapi (); 

}); 

var protector = dataProtectionProvider.CreateProtector("Program.No-DI"); 
Console.Write("Enter input: "); 
var input = Console.ReadLine(); 

// Protect the payload 

var protectedPayload = protector.Protect(input); 
Console.WriteLine($"Protect returned: {protectedPayload}"); 

// Unprotect the payload 

var unprotectedPayload = protector.Unprotect(protectedPayload); 
Console.WriteLine($"Unprotect returned: {unprotectedPayload}"); 

Console.WriteLine(); 

Console.WriteLine("Press any key...“); 

Console.ReadKey(); 

} 

} 


TIP 

Örneklerini DataProtectionProvider somut türünü oluşturmak pahalı. Bir uygulama birden çok örneğini bu tür tutar ve 
tümünü aynı dizinde anahtar depolama alanı kullanıyorsanız, uygulama performansı düşebilir. Kullanırsanız 
DataProtectionProvider türü öneririz bu tür bir kez oluşturun ve mümkün olduğunca yeniden. 
DataProtectionProvider Türü ve tüm Idataprotector oluşturulan iş parçacığı açısından güvenli örnekleridir birden çok 
arayanlar için. 
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• Çekirdek şifreleme genişletilebilirliği 

• Anahtar yönetimi genişletilebilirliği 

• Çeşitli API'ler 




ASPNET core'da çekirdek şifreleme genişletilebilirliği 

11.07.2019 • 9 minutes to read z. Edjt Online 


WARNING 

Aşağıdaki arabirimlerinden birini uygulayan türler, iş parçacığı açısından güvenli olmalıdır birden çok arayanlar için. 


lAuthenticatedEncryptor 

I AuthenticatedEncryptor şifreleme alt sistemi temel yapı bloğu arabirimidir. Genellikle anahtar başına bir 
lAuthenticatedEncryptor yoktur ve tüm şifreleme anahtar malzemesi ve şifreleme işlemleri gerçekleştirmesi için 
gerekli olan algoritmik bilgileri lAuthenticatedEncryptor örneğine sarar. 

Adından da anlaşılacağı gibi tür kimliği doğrulanmış şifreleme ve şifre çözme hizmetleri sağlamaktan sorumludur. 
Bunu, aşağıdaki iki API'lerini kullanıma sunar. 

• Decrypt(ArraySegment<byte> ciphertext, ArraySegment<byte> additionalAuthenticatedData) : byte[] 

• Encrypt(ArraySegment<byte> plaintext, ArraySegment<byte> additionalAuthenticatedData) : byte[] 

Şifreleme yöntemi enciphered düz metin ve kimlik doğrulaması etiketi içeren bir blob döndürür. AAD son yükten 
kurtarılabilir olması gerekmez ancak ek kimliği doğrulanmış veriler (AAD) kimlik doğrulaması etiketi kapsamalıdır. 
Şifre çözme yöntemi, kimlik doğrulaması etiketi doğrular ve deciphered yükü döndürür.Tüm hataları 
(ArgumentNullException dışında ve benzer) için CryptographicException homogenized. 


NOTE 

lAuthenticatedEncryptor örneği gerçekten anahtar malzemesi içermesi gerekmez. Örneğin, uygulama tüm işlemler için HSM 
temsilci seçebilecek. 


Bir lAuthenticatedEncryptor oluşturma 

• ASP.NET Core 2.x 

• ASP.NET Core 1.x 

lAuthenticatedEncryptorFactory arabirimi oluşturmak bildiği bir türü temsil eder bir lAuthenticatedEncryptor 
örneği. Kendi API aşağıdaki gibidir. 

• CreateEncryptorlnstance (IKey anahtarı): lAuthenticatedEncryptor 

Verilen tüm IKey örneği için kendi CreateEncryptorlnstance yöntemi tarafından oluşturulan tüm kimliği 
doğrulanmış encryptors eşdeğer olarak düşünülmesi gereken aşağıdaki kod örneği. 










// we have an IAuthenticatedEncryptorFactory instance and an IKey instance 
IAuthenticatedEncryptorFactory factory = . ..; 

IKey key = ...; 

// get an encryptor instance and perform an authenticated encryption operation 
ArraySegment<byte> plaintext = new ArraySegment<byte>(Encoding.UTF8.GetBytes("plaintext")); 
ArraySegment<byte> aad = new ArraySegment<byte>(Encoding.UTF8.GetBytes("AAD")); 
var encryptorl = factory.CreateEncryptorlnstance(key); 
byte[] ciphertext = encryptorl.Encrypt(plaintextj aad); 

// get another encryptor instance and perform an authenticated decryption operation 
var encryptor2 = factory.CreateEncryptorlnstance(key); 

byte[] roundTripped = encryptor2.Decrypt(new ArraySegment<byte>(ciphertext), aad); 

// the 'roundTripped' and 'plaintext' buffers should be equivalent 


lAuthenticatedEncryptorDescriptor (ASP.NET Core 2.x yalnızca) 

• ASP.NET Core 2.x 

• ASP.NET Core 1.x 

I AuthenticatedEncryptorDescriptor arabirimi kendisini XM L biçimine dışa bildiği bir türü temsil eder. Kendi 
API aşağıdaki gibidir. 

• ExportToXml(): XmlSerializedDescriptorlnfo 

XML seri hale getirme 

lAuthenticatedEncryptor lAuthenticatedEncryptorDescriptor arasındaki birincil fark tanımlayıcı Şifreleyici 
oluşturma ve geçerli bağımsız değişkenlerle tedarik bilir. Uygulaması SymmetricAlgorithm ve 
KeyedHashAlgorithm kullanır bir lAuthenticatedEncryptor göz önünde bulundurun. Bu tür tüketmeye 
Şifreleyici'nın iş, ancak uygulama yeniden başlatılırsa kendisi yeniden oluşturmak nasıl uygun açıklamasını 
gerçekten yazamaz şekilde, mutlaka, bu tür bir nereden geldiğini bilmez. Tanımlayıcı, bu üzerinde daha yüksek bir 
düzeye olarak görev yapar. Tanımlayıcı Şifreleyici örneği oluşturmak nasıl bilir olduğundan (örneğin, gerekli 
algoritmalar oluşturma Giden), böylece uygulama sıfırladıktan sonra Şifreleyici örneği yeniden oluşturulabilir, Bilgi 
Bankası XML formundaki serileştirebiliyorsa. 

Tanımlayıcı, ExportToXml yordamı seri hale getirilebilir.Bu yordam, iki özellik içeren bir 
XmlSerializedDescriptorlnfo döndürür: tanımlayıcı ve temsil eden tür XEIement temsili bir 
lAuthenticatedEncryptorDescriptorDeserializer olabilir, karşılık gelen XEIement verilen bu tanımlayıcıyı resurrect 
için kullanılır. 

Seri hale getirilmiş tanımlayıcı şifreleme anahtar malzemesi gibi hassas bilgiler içerebilir.Veri koruma sisteminde 
kalıcı depolama için önce bilgi şifreleme için yerleşik destek sunmaktadır. Bu yararlanmak için tanımlayıcı öznitelik 
adı "boşluğu requiresEncryption" ile hassas bilgiler içeren öğe işaretlemeniz gerekir (xmlns 

"http://schemas.asp.net/201 5/03/dataProtection"), değeri "true". 


TIP 

Bu öznitelik ayarlamak için bir yardımcı API yoktur. XEIement.MarkAsRequiresEncryptionO 

Microsoft.AspNetCore.DataProtection.AuthenticatedEncryption.ConfigurationModel ad alanında bulunan uzantı yöntemini 
çağırın. 


Servis taleplerini seri hale getirilmiş tanımlayıcı hassas bilgileri burada içermiyor olabilir.Tekrar bir şifreleme 
anahtarının bir HSM'de depolanan bir durum düşünün. Tanımlayıcı, HSM malzeme düz metin biçiminde 






göstermek olmaz bu yana kendisine serileştirilirken anahtar malzemesi yazılamıyor. Bunun yerine, tanımlayıcı 
(HSM bu biçimde dışa aktarma izin verirse), anahtar veya anahtar HSM'ın kendi benzersiz tanımlayıcısını anahtar 
sarmalanmış sürümünü kullanıma yazabilirsiniz. 

lAuthenticatedEncryptorDescriptorDeserializer 

IAuthenticatedEncryptorDescriptorDeserializer arabirimi bir XEIement lAuthenticatedEncryptorDescriptor 
örneğinden seri durumdan çıkarılacak bildiği bir türü temsil eder. Bu, tek bir yöntemi gösterir: 

• lmportFromXml (XEIement öğesi): lAuthenticatedEncryptorDescriptor 

lmportFromXml yöntem tarafından döndürülen XEIementalır IAuthenticatedEncryptorDescriptor.ExportToXml ve 
özgün lAuthenticatedEncryptorDescriptor eşdeğer oluşturur. 

lAuthenticatedEncryptorDescriptorDeserializer uygulayan türleri, aşağıdaki iki genel oluşturucular biri olmalıdır: 

• .ctor(IServiceProvider) 

• .ctorO 

NOTE 

Oluşturucuya geçirilen IServiceProvider null olabilir. 


Üst düzey Fabrika 

• ASP.NET Core 2.x 

• ASP.NET Core 1.x 

AlgorithmConfiguration sınıfı oluşturmak bildiği bir türü temsil eder lAuthenticatedEncryptorDescriptor 
örnekleri. Bu, tek bir API sunar. 

• CreateNewDescriptor(): lAuthenticatedEncryptorDescriptor 

Üst düzey Fabrika olarak AlgorithmConfiguration düşünün. Yapılandırma şablon olarak görev yapar. Algoritmik 
bilgi sarmalar (örneğin, bu yapılandırma bir AES-128-GCM ana anahtar ile tanımlayıcıları üretir), ancak henüz 
belirli bir anahtar ile ilişkili. 

CreateNevvDescriptor çağrılır, yeni anahtar malzemesi bu çağrı için yalnızca oluşturulduğunda ve yeni 
lAuthenticatedEncryptorDescriptor üretilir, bu anahtar malzemesi ve malzeme kullanmak için gereken bilgilerin 
algoritmik sarmalar. Anahtar malzemesi yazılımda oluşturulabilir (ve bellekte tutulan), bunu oluşturulabilir ve bir 
HSM ve benzeri tutulan. İki çağrıları CreateNevvDescriptor eşdeğer lAuthenticatedEncryptorDescriptor örnekleri 
hiçbir zaman oluşturmalısınız önemli noktasıdır. 

Gibi AlgorithmConfiguration türü anahtarı oluşturma rutinleri için giriş noktası olarak hizmet çalışırken otomatik 
anahtar. Gelecekteki tüm anahtarların uygulamasını değiştirmek için KeyManagementOptions 
AuthenticatedEncryptorConfiguration özelliğini ayarlayın. 




ASPNET Core anahtar yönetimi genişletilebilirliği 
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TIP 

Okuma anahtar yönetimi bölümden önce bu bölümü okunurken gibi bazı bu API'leri temel kavramları açıklar. 


VVARNING 

Aşağıdaki arabirimlerinden birini uygulayan türler, iş parçacığı açısından güvenli olmalıdır birden çok arayanlar için. 


Anahtar 

iKey Cryptosystem anahtarında temel gösterimini arabirimidir.Terim anahtarı burada "şifreleme anahtar 
malzemesi" değişmez değer duygusu değil, soyut anlamında kullanılmıştır. Bir anahtarı aşağıdaki özelliklere 
sahiptir: 

• Etkinleştirme, oluşturma ve sona erme tarihleri 

• iptal durumu 

• Anahtar tanımlayıcısını (GUID) 

Ayrıca, iKey sunan bir createEncryptor oluşturmak için kullanılan yöntemi bir lAuthenticatedEncryptor örneği bu 
anahtara bağlı. 

Ayrıca, iKey sunan bir createEncryptorinstance oluşturmak için kullanılan yöntemi bir lAuthenticatedEncryptor 
örneği bu anahtara bağlı. 

NOTE 

Ham şifreleme malzemesini almak için hiçbir API yoktur bir iKey örneği. 


IKeyManager 

iKeyManager Arabirimi genel anahtar depolama alanı, alma ve düzenleme için sorumlu bir nesneyi temsil eder. Bu, 
üç üst düzey işlemini kullanıma sunar: 

• Yeni bir anahtar oluşturun ve depolama için kalıcı. 

• Tüm anahtarları, depolama alanından alma. 

• Bir veya daha fazla anahtarı iptal edin ve depolama için iptal bilgilerini kalıcı hale. 

VVARNING 

Yazma bir IKeyManager çok gelişmiş bir görevdir ve geliştiricilerin çoğu, çalışmayın. Bunun yerine, çoğu geliştirici tarafından 
sunulan özellikleri yararlanmak XmlKeyManager sınıfı. 

















XmlKeyManager 

xmiKeyManager Türüdür yerleşik somut uygulamasını iKeyManager . Bu anahtar emanet ve anahtarları, bekleyen 
veri şifrelemesi gibi birçok yararlı olanakları sağlar. Bu sistemde anahtarları XM L öğeleri olarak temsil edilir 
(özellikle XEIement). 

xmiKeyManager görevleri yerine getirerek sırasında birkaç diğer bileşenlere bağlıdır: 

• AlgorithmConfiguration , yeni anahtarlar tarafından kullanılan algoritmalar belirler. 

• ıxmiRepository , burada anahtarları kalıcı depolama alanında hangi denetimleri. 

• ıxmiEncryptor [isteğe bağlı], anahtarları, bekleyen veri şifreleme sağlar. 

• iKeyEscrowSink [isteğe bağlı], anahtar emanet hizmetleri sağlar. 

• ıxmiRepository , burada anahtarları kalıcı depolama alanında hangi denetimleri. 

• ıxmiEncryptor [isteğe bağlı], anahtarları, bekleyen veri şifreleme sağlar. 

• iKeyEscrowSink [isteğe bağlı], anahtar emanet hizmetleri sağlar. 

Nasıl bu bileşenler birlikte içinde kablolu arabirimlerdir gösteren yüksek düzey şemalarını aşağıda verilmiştir 
XmlKeyManager . 



Anahtar oluşturma / CreateNevvKey 

Uygulamasında createNewKey , AlgorithmConfiguration benzersiz bir oluşturmak için kullanılan bileşen 
iAuthenticatedEncryptorDescriptor , hangi sonra serileştirilmiş XML olarak. Ham (şifrelenmemiş) XML anahtar 
emanet havuz varsa, havuz için uzun vadeli depolama için sağlanır. Şifrelenmemiş XML ardından çalıştırın bir 
ıxmiEncryptor (gerekliyse) şifrelenmiş bir XML belgesi oluşturmak için. Şifrelenmiş bu belgenin uzun vadeli 
depolama için kalıcı ıxmiRepository .(Hiçbir ıxmiEncryptor olan yapılandırılmış, şifrelenmemiş belge içinde kalıcı 
IXmlRepository .) 
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Anahtar oluşturma / CreateNewKey 


Uygulamasında createNewKey , iAuthenticatedEncryptorConfiguration benzersiz bir oluşturmak için kullanılan 
bileşen iAuthenticatedEncryptorDescriptor , hangi sonra serileştirilmiş XML olarak. Ham (şifrelenmemiş) XML 
anahtar emanet havuz varsa, havuz için uzun vadeli depolama için sağlanır. Şifrelenmemiş XML ardından çalıştırın 
bir ıxmiEncryptor (gerekliyse) şifrelenmiş bir XML belgesi oluşturmak için. Şifrelenmiş bu belgenin uzun vadeli 
depolama için kalıcı ıxmiRepository .(Hiçbir ıxmiEncryptor olan yapılandırılmış, şifrelenmemiş belge içinde kalıcı 
IXmlRepository .) 



Anahtar alma / GetAllKeys 


Uygulamasında GetAllKeys , XML belgeleri temsil eden tuşları ve geri alma işlemleri temel okunur 








































































ıxmiRepository . Bu belgeler şifrelenir, sistem otomatik olarak bunların şifresini çözer. xmiKeyManager uygun 
oluşturur iAuthenticatedEncryptorDescriptorDeseriaiizer belgeleri seri durumdan çıkarılacak örnekleri yeniden 
iAuthenticatedEncryptorDescriptor örnekleri, sonra ayrı ayrı sarmalanır iKey örnekleri. Bu koleksiyonu iKey 
örnekleri, çağırana döndürülür. 

Belirli bir XML öğeleri hakkında daha fazla bilgi bulunabilir anahtar depolama biçimi belge. 

IXmlRepository 

ıxmiRepository Arabirimi XML kalıcı hale getirmek ve yedekleme deposundan XML almak bir türü temsil eder. Bu, 
iki API'lerini kullanıma sunar: 

• GetAllElements : IReadOnlyCollection<XElement> 

• StoreEİ 0 ment(XElement element, string friendlyName) 

Uygulamaları ıxmiRepository aracılığıyla geçirme XML'İ ayrıştırmakta gerekmez. XML belgeleri donuk ele 
almanız ve belgelerini ayrıştırma ve oluşturma hakkında endişe daha yüksek katmanları olanak tanır. 

Uygulayan dört yerleşik somut tür ıxmiRepository : 

• FileSystemXmlRepository 

• RegistryXmlRepository 

• AzureStorage.AzureBlobXmlRepository 

• RedisXmlRepository 

• FileSystemXmlRepository 

• RegistryXmlRepository 

• AzureStorage.AzureBlobXmlRepository 

• RedisXmlRepository 

Bkz: anahtar depolama sağlayıcıları belge daha fazla bilgi için. 

Özel bir kayıt ıxmiRepository farklı yedekleme deposu (örneğin, Azure tablo depolama) kullanılırken uygundur. 
Varsayılan depo birçok farklı uygulama değiştirmek için özel bir kayıt ıxmiRepository örneği: 

Services.Configure<KeyManagementOptions>(options => options.XmlRepository = new MyCustomXmlRepository()); 

Services.AddSingleton<IXmlRepository>(new MyCustomXmlRepository()); 


IXmlEncryptor 

ıxmiEncryptor Arabirimi düz metin XML öğesi şifreleyebilirsiniz bir türü temsil eder.Bu, tek bir API sunar: 

• Encrypt(XEIement plaintextElement): EncryptedXmllnfo 

Seri hale getirilmiş bir, iAuthenticatedEncryptorDescriptor işaretlenmiş ardından "şifreleme gerektiren" tüm öğeleri 
içerir xmiKeyManager bu öğeleri yapılandırılan çalışacak ıxmiEncryptor 's Encrypt yöntemi ve kalıcı hale gelir 
enciphered öğe yerine düz metin öğesine ıxmiRepository . Çıkışı Encrypt yöntemi bir Encryptedxmiinfo nesne. Bu 
nesne enciphered hem sonuç içeren bir sarmalayıcı olan XEiement ve türünü temsil eden bir ıxmiDecryptor 
karşılık gelen öğe çözmek için kullanılabilir. 


Uygulayan dört yerleşik somut tür ıxmiEncryptor : 






















• CertificateXmlEncryptor 

• DpapiNGXmlEncryptor 

• DpapiXmlEncryptor 

• NullXmlEncryptor 

Bkz: rest belge, anahtar şifreleme daha fazla bilgi için. 

Varsayılan bekleyen anahtar şifreleme mekanizması birçok farklı uygulama değiştirmek için özel bir kayıt 
IXmlEncryptor Örneği: 

Services.Configure<KeyManagementOptions>(options => options.XmlEncryptor = new MyCustomXmlEncryptor()); 

Services.AddSingleton<IXmlEncryptor>(new MyCustomXmlEncryptor()); 


IXmlDecryptor 

ıxmiDecryptor Arabirimi şifresini çözmek bildiği bir türü temsil eder bir XEiement , enciphered aracılığıyla bir 
ıxmiEncryptor . Bu, tek bir API sunar: 

• Şifre çözme (XEIement encryptedElement): XEIement 

Decrypt Yöntemi tarafından gerçekleştirilen şifreleme alır ıxmiEncryptor.Encrypt . Genellikle, her somut 
ıxmiEncryptor uygulamasına karşılık gelen bir somut sahipseniz ıxmiDecryptor uygulaması. 

Türleri uygulayan ıxmiDecryptor aşağıdaki iki genel oluşturucular biri olmalıdır: 

• .ctor(IServiceProvider) 

• .ctorO 

NOTE 

ıserviceProvider Geçirilen oluşturucuya null olabilir. 


IKeyEscrovvSink 

iKeyEscrowSink Arabirimi hassas bilgilerin emanet gerçekleştirebileceği bir türü temsil eder. Seri hale getirilmiş 
tanımlayıcıları (şifreleme malzemelerini gibi) hassas bilgiler içerebilir ve ne için giriş neden budur geri çağırma 
IXmlEncryptor ilk başta yazın. Ancak, Kazalar olabilir ve anahtar halkaları silinebilir veya bozulmuş. 

Yapılandırılmış tüm tarafından dönüştürülür önce ham serileştirilmiş XML erişimine bir Acil Durum kaçış noktası, 
emanet arabirimidir IXmlEncryptor. Arabirim, tek bir API sunar: 

• Store (GUID Keyıd, XEIement öğe) 

En fazla olan iKeyEscrowSink belirtilen öğe işletme ilkesiyle uyumlu güvenli bir şekilde işlemek üzere uygulama. 
Sertifikanın özel anahtarı bir yere kalacakları XML öğesi bilinen bir kurumsal X.509 sertifikası kullanarak 
şifrelemek emanet havuz için bir olası uygulama olabilir; certificateXmiEncryptor türü bu konuda yardımcı 
olabilir. iKeyEscrowSink Uygulamasıdır ayrıca belirtilen öğe uygun şekilde kalıcı hale getirmekten sorumludur. 

Sunucu yöneticileri olabilir ancak varsayılan olarak emanet bir mekanizma, etkin bu genel yapılandırma. Ayrıca 
programlı olarak aracılığıyla yapılandırılabilir iDataProtectionBuiider.AddKeyEscrowSink aşağıdaki örnekte 
gösterildiği gibi yöntemi. AddKeyEscnowSink Yöntemi aşırı yüklemeleri yansıtma isenviceCollection.AddSingleton 
ve iserviceCollection.Addinstance aşırı olarak iKeyEscnowSink örnekleri teklileri olmasını yöneliktir. Birden çok 

















iKeyEscrowSink örnekleri kayıtlı, her biri anahtar oluşturma sırasında çağrılacak şekilde anahtarları için birden fazla 
mekanizmayı aynı anda kalacakları. 

Malzemesini okumak için hiçbir API yoktur bir iKeyEscrowSink örneği. Emanet mekanizmasının tasarım kuramsal 
ile tutarlı budur: anahtar malzemesi güvenilir bir yetkili tarafından erişilebilir kılın yönelik ve uygulamanın 
kendisini güvenilir bir yetkili olmadığından, kendi escrovved malzeme erişimi olmamalıdır. 


Aşağıdaki örnek kod oluşturma ve kaydetme işlemlerini gösterir bir iKeyEscrowSink burada anahtarları kalacakları 
sağlayacak şekilde yalnızca "CONTOSODomain Admins" üyeleri bunları kurtarabilirsiniz. 



using System; 
using System.10; 
using System.Xml.Linq; 

using Microsoft.AspNetCore.DataProtection; 
using Microsoft.AspNetCore.DataProtection.KeyManagement; 
using Microsoft.AspNetCore.DataProtection.XmlEncryption; 
using Microsoft.Extensions.DependencyInjection; 
using Microsoft.Extensions.Logging; 

public class Program 

{ 

public static void Main(string[] args) 

{ 

var serviceCollection = new ServiceCollection(); 
serviceCollection.AddDataProtection() 

.PersistKeysToFileSystem(new DirectoryInfo(@"c: \temp-keys")) 

.ProtectKeysWithDpapi() 

.AddKeyEscrowSink(sp => new MyKeyEscrowSink(sp)); 
var Services = serviceCollection.BuildServiceProvider(); 

// get a reference to the key manager and force a new key to be generated 
Console.WriteLine("Generating new key..."); 
var keyManager = Services.GetService<IKeyManager>(); 
keyManager.CreateNewKey( 

activationDate: DateTimeOffset.NoWj 
expirationDate: DateTimeOffset.Now.AddDays(7)); 

} 

// A key escrow sink where keys are escrowed such that they 
// can be read by members of the C0NT0S0\Domain Admins group. 
private class MyKeyEscrowSink : IKeyEscrowSink 
{ 

private readonly IXmlEncryptor _escrowEncryptor; 

public MyKeyEscrowSink(IServiceProvider Services) 

{ 

// Assuming I'm on a machine that's a member of the C0NT0S0 
// domainj I can use the Domain Admins SID to generate an 
// encrypted payload that only they can read. Sample SID from 
// https://technet.microsoft.com/library/cc778824(v=ws.l0).aspx. 
_escrowEncryptor = new DpapiNGXmlEncryptor( 

"SID=S-1-5-21-1004336348-1177238915-682003330-512" j 
DpapiNGProtectionDescriptorFlags.None, 
new LoggerFactoryO); 

} 

public void Store(Guid keyld, XElement element) 

{ 

// Encrypt the key element to the escrow encryptor. 






var encryptedXmlInfo = _escrowEncryptor.Encrypt(element); 


// A real implementation would save the escrowed key to a 
// write-only file share or some other stable storage, but 
// in this sample we'll just write it out to the console. 
Console.WriteLine($"Escrowing key {keyld}"); 

Console.WriteLine(eneryptedXmlInfo.EneryptedElement); 

// Note: We cannot read the escrowed key material ourselves. 
// We need to get a member of CONTOSO\Domain Admins to read 
// it for us in the event we need to recover it. 

} 

} 


SAMPLE OUTPUT 
Generating new key... 

Escrowing key 38e74534-clb8-4b43-aeal-79e856a822e5 
<encryptedKey> 

<!-- This key is encrypted with Windows DPAPI-NG. --> 

<!-- Rule: SID=S-l-5-21-1004336348-1177238915-682003330-512 --> 
<value>MIIIfAY3KoZIhvcNAQcDoIIIbTCCCGkCAQ.. .T5rA4g==</value> 
</encryptedKey> 
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VVARNING 

Aşağıdaki arabirimlerinden birini uygulayan türler, iş parçacığı açısından güvenli olmalıdır birden çok arayanlar için. 


ISecret 

ısecret Arabirimi şifreleme anahtar malzemesi gibi gizli bir değeri temsil eder.Aşağıdaki API yüzeyi aşağıdakileri 
içerir: 

• Length : int 

• Dispose() : void 

• WriteSecretIntoBuffer(ArraySegment<byte> buffer) : void 

writeSecretintoBuffer Yöntemi sağlanan arabellek ham gizli değer ile doldurur. Bu API arabellek bir parametre 
olarak alan nedeni döndürmek yerine bir byte[] doğrudan bu çağıran atık toplayıcı yönetilen gizli maruz kalma 
riskinizi sınırlama arabellek nesne sabitlemek için Fırsat vermesidir. 

secret Türüdür, somut bir uygulama ısecret işlem içi bellekte gizli değer depolandığı. VVİndovvs platformlarında, 
gizli değer aracılığıyla şifrelenmiş CryptProtectMemory. 
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Kimliği doğrulanmış şifreleme ayrıntıları 

Alt Anahtar Türetme ve Kimliği Doğrulanmış Şifreleme 

Bağlam üst bilgileri 

Anahtar Yönetimi 

Anahtar Depolama Sağlayıcıları 

Bekleme Durumunda Anahtar Şifreleme 

Anahtar değiştirilemezliği ve ayarlar 

Anahtar Depolama Biçimi 

Kısa ömürlü veri koruma sağlayıcıları 
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Kimliği doğrulanmış şifreleme IDataProtector.Protect çağrıları işlemlerdir. Bu Idataprotector örnekte kendi kök 
IDataProtectionProvider türetmek için kullanılan amaçlı zinciri bağlıdır ve koruma yöntemi hem gizliliği ve kimlik 
doğrulama sunar. 

IDataProtector.Protect bayt [] düz metin parametre alır ve aşağıda açıklanan biçimde bir bayt [] korumalı yükü 
üretir. (Var. Ayrıca bir dize düz metin parametresi alan ve bir dize korumalı yükü döndüren bir genişletme yöntemi 
aşırı yüklemesi Bu API kullanılıyorsa, korumalı yükü biçimde hala olan yapısı, aşağıda ancak olur base64url kodlu.) 


Korumalı yük biçimi 

Korumalı yük biçimi üç birincil bileşenden oluşur: 

• Veri koruma sisteminde sürümünü tanımlayan bir 32-bit Sihirli üstbilgisi. 

• Bu belirli yük korumak için kullanılan anahtarı tanımlar 128 bit anahtar kimliği. 

• Korumalı yük kalan bu anahtara göre kapsüllenmiş Şifreleyici özgü. Aşağıdaki örnekte, bir AES 256 CBC + 
HMACSHA256 Şifreleyici tuşunu temsil eder ve yükü daha ayrıntılı şekilde ayrılır: 

o 128 bit anahtar değiştiricisi, 
o Bir 128-bit başlatma vektörü, 
o AES 256 CBC çıkış 48 bayt, 
o HMACSHA256 kimlik doğrulaması etiketi. 

Bir korumalı örnek yük aşağıda gösterilmiştir. 


09 

F0 

C9 

F0 

80 

9C 

81 

0C 

19 

66 

19 

40 

95 

36 

53 

F8 

AA 

FF 

EE 

57 

57 

2F 

40 

4C 

3F 

7F 

CC 

9D 

CC 

D9 

32 

3E 

00 

17 

99 

16 

EC 

BA 

İF 

4A 

Al 

18 

45 

İF 

2D 

13 

7A 

28 

79 

6B 

86 

9C 

F8 

B7 

84 

F9 

26 

31 

FC 

B1 

86 

0 A 

Fİ 

56 

61 

CF 

14 

58 

D3 

51 

6F 

CF 

36 

50 

85 

82 

08 

2D 

3F 

73 

5F 

B0 

AD 

9E 

İA 

B2 

AE 

13 

57 

90 

C8 

F5 

7C 

95 

4E 

6A 

< 

00 

AA 

06 

EF 

43 

CA 

19 

62 

84 

7C 

11 

B2 

C8 

71 

9D 

AA 

52 

19 

2E 

5B 

4C 

İE 

54 

F0 

55 

BE 

88 

92 

12 

Cl 

4B 

5E 

52 

C9 

74 

A0 














(09 F0 C9 F0) sürümünü tanımlayan Sihirli üstbilgi ilk 32 bit veya 4 bayt yukarıda yük biçimi arasındadır 
Sonraki 128 bit ya da 16 bayt olan anahtar tanımlayıcısı (80 9C 81 0C 19 66 19 40 95 36 53 F8 AA FF E E 57) 
Kalan yükü içerir ve kullanılan biçimi özgüdür. 

VVARNING 

Belirli bir anahtarın için korunan tüm yükleri aynı 20 baytlık (Sihirli değeri, anahtar kimliği) üst bilgisi ile başlar. Yöneticiler, bir 
yük oluşturulduğunda yaklaşık olarak belirlemenizi sağlayan bu olgu tanılama amacıyla kullanabilir. Örneğin, yukarıdaki yükü 
(0c819c80-6619-4019-9536-53f8aaffee57) anahtarına karşılık gelir. Anahtar deposu denetledikten sonra bu belirli bir 
anahtarın etkinleştirme tarihine gelindiğinden 201 5-01 -01 ve 2015-03-01, sona erme tarihine gelindiğinden sonra 
varsayımında şüphelenilebilir fark ederseniz yük (değiştirilmiş değil) sağlar, pencere içinde oluşturulan veya küçük olması Her 
iki tarafında karamelli faktörü. 
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Çoğu anahtar halkası anahtarlarında entropi çeşit içerir ve algoritmik bilgiler belirten "CBC modunda şifreleme + 
HMAC doğrulama" veya "GCM şifreleme + doğrulama". Bu gibi durumlarda, katıştırılmış entropi için bu anahtar 
için ana anahtar malzemesini (veya KM) olarak diyoruz ve gerçek şifreleme işlemleri için kullanılan anahtarları 
türetmek için anahtar türetme işlevi gerçekleştiririz. 


NOTE 

Anahtarlar büyük/küçük harfe soyuttur ve özel bir uygulaması aşağıdaki gibi çalışmayabilir. Anahtar kendi uygulaması 
sağlıyorsa iAuthenticatedEncryptor bizim yerleşik fabrikaları birini kullanmak yerine, bu bölümde açıklanan mekanizması 
artık geçerlidir. 


Ek kimliği doğrulanmış veriler ve alt anahtar türetme 

iAuthenticatedEncryptor Arabirimi tüm kimliği doğrulanmış şifreleme işlemleri için temel arabirim olarak hizmet 
verir. Kendi Encrypt yöntemi iki arabelleğini alır: düz metin ve additionalAuthenticatedData (AAD). Düz metin 
içeriği akış çağrısı değişmeden iDataProtector.Protect , ancak AAD sistem tarafından oluşturulan ve üç bileşenden 
oluşur: 

1. 32-bit Sihirli üstbilgisi 09 F0 C9 FO'de, veri koruma sisteminde bu sürümünü tanımlar. 

2. 128 bit anahtar kimliği. 

3. Değişken uzunluklu bir dize oluşturan amaçlı zincirinden biçimlendirilmiş iDataProtector , bu işlemi 
gerçekleştiriyor. 

AAD üç bileşen tanımlama grubu için benzersiz olduğundan, bu yeni anahtarları KM kendisini tüm 
müşterilerimizin şifreleme işlemlerinin kullanmak yerine KM türetmek için kullanabiliriz. Yapılan her çağrı için 
iAuthenticatedEncryptor.Encrypt , aşağıdaki anahtar türetme işlem gerçekleşir: 

( K_E, K_H ) = SP800_108_CTR_HMACSHA512(K_M, AAD, contextHeader || keyModifier) 

Burada, biz sayacı modunda NIST SP800 108 KDF arıyoruz (bkz NIST SP800-108, Sec. 5.1) şu parametrelerle: 

• Anahtar türetme anahtarı (KDK) K_M = 

• PRF = HMACSHA512 

• Etiket additionalAuthenticatedData = 

• bağlam contextPleader = || keyModifier 

içerik üstbilgisi, değişken uzunluğu ve aslında bir parmak izi için biz K_E ve K_H türetme algoritmaları sunar. Her 
çağrı için rastgele oluşturulmuş bir 128-bit dize anahtar değiştiricidir Encrypt ve tüm diğer girişler için KDF sabit 
olsa bile KE ve KH bu özel kimlik doğrulama şifreleme işlemi için benzersiz olduğunu olasılık aşırı yüklenilmesini 
ile sağlamak için kullanılır. 

CBC modunda şifreleme + HMAC doğrulama işlemleri için | K_E | simetrik blok şifreleme anahtarı uzunluğu ve | 
K_H | HMAC yordamının Özet boyutudur. GCM şifreleme + doğrulama işlemleri | K_H | 0 =. 











CBC modunda şifreleme + HMAC doğrulama 

Yukarıdaki mekanizması K_E oluşturulduktan sonra size rastgele başlatma vektörü oluşturur ve düz metin 
şifreleme için simetrik blok şifreleme algoritması çalıştırın. Ciphertext ve başlatma vektörünü sonra Mac üretmek 
için K_H anahtarıyla başlatıldı HMAC yordamı aracılığıyla çalıştırılır Bu işlem ve dönüş değeri grafik aşağıda 
gösterilir. 


data 

user input 





Çıkış: keyModifier = || IV || (Veri K_E, IV) E_cbc || HMAC (K_H, IV || E_cbc (K_E, IV, veriler)) 


NOTE 

iDataProtector. Protect Uygulaması olacak Sihirli bir üst bilgi ve anahtar kimliği önüne ekleyin çağırana döndürmeden 
önce çıktı. Sihirli bir üst bilgi ve anahtar kimliği örtük olarak olduğundan parçası AAD, ve anahtar değiştiricisi KDF giriş olarak 
beslenir olduğundan, bu yük döndürülen her tek baytlık Mac tarafından doğrulanır anlamına gelir 


Galois/sayacı modu şifreleme + doğrulama 

Yukarıdaki mekanizması K_E oluşturulduktan sonra size rastgele 96 bit nonce oluşturmak ve düz metin şifrele, 128 
bit kimlik doğrulaması etiketi oluşturmak için simetrik blok şifreleme algoritması'ı çalıştırın. 


data 

user input 


AAD 

generated input 


nonce 

fromPRNG, size = 96 bits 





authTag 

size = 128 bits 


Çıkış: keyModifier = || nonce || E_gcm (K_E, nonce, veriler) || authTag 












































NOTE 

GCM yerel olarak AAD kavramını destekler olsa da, biz yine de AAD yalnızca özgün KDF GCM, AAD parametresi için boş bir 
dize geçirilecek edilmesiyle besleme. Bunun nedeni, iki Katlama, ilk olarak, çevikliği desteklemek için hiçbir zaman K_M 
doğrudan şifreleme anahtarı kullanılacak istiyoruz. Ayrıca, GCM girişleri üzerinde çok sıkı benzersizlik gereksinimleri 
karşılamalıdır. GCM şifreleme yordamı hiç olmadığı kadar çağrılan iki veya daha farklı olma olasılığını aynı (anahtar, nonce) giriş 
veri kümelerini çifti açmamalıdır 2 A 32. Biz K_E düzeltin, 2'den yerine getiremez A 32 şifreleme işlemleri biz çalıştırma afoul 2 
ve önce A -32 sınırlayın. Bu işlemlerin çok büyük bir sayı gibi görünebilir, ancak trafiği yüksek web sunucusu, 4 milyarı aşan 
istekleri aracılığıyla da bu anahtarları için normal kullanım ömrü içinde yalnızca gün içinde gidebilirsiniz. 2. uyumlu kalmak için 
A -32 olasılık sınırı devam 128 bit anahtar değiştiricisi ve herhangi belirli K_M için kullanılabilir işlem sayısını önemli ölçüde 
genişleten 96 bit nonce kullanılacak. Tasarım kolaylık olması için biz KDF kod yolu CBC ve GCM işlemleri arasında paylaşın ve 
AAD içinde KDF zaten değerlendirilir olmadığından, GCM yordamına iletme gereği yok. 




ASPNET core'da bağlam üst bilgileri 
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Arka plan ve teorik 

Veri koruma sisteminde, şifreleme hizmetleri sağlayan bir nesne kimliği doğrulanmış bir "anahtarını" anlamına 
gelir. Her anahtar benzersiz bir kimlik (GUID) tarafından tanımlanır ve onunla taşıyan algoritmik bilgi ve entropic 
malzeme. Her anahtarın benzersiz entropi taşıyan ancak sistem, zorunlu kılamaz ve ayrıca anahtar halkası, el ile 
mevcut bir anahtarı anahtar halkası, algoritmik bilgilerini değiştirerek değişebilir geliştiriciler için hesap gerekiyor 
yöneliktir. Bu gibi durumlarda verilen bizim güvenlik gereksinimlerini karşılamak için veri koruma sisteminde 
kavramı vardır şifreleme çevikliği, tek bir entropic değer arasında birden fazla şifreleme algoritmaları kullanarak 
güvenli bir şekilde izin verir. 

Şifreleme çevikliği destekleyen sistemlerinin çoğu algoritma yükü içinde ilgili bazı tanımlama bilgilerini ekleyerek 
bunu. Algoritma 's genellikle Bunun iyi bir aday oıd'dir.Ancak, aynı algoritmayı belirtmek için birden çok yolu 
vardır içine karşılaştık sorunlardan biri olan: "AES" (CNG) ve yönetilen Aes, AesManaged 

AesCryptoServiceProvider, AesCng ve RijndaelManaged (belirli parametreleri verilir) tüm aslında aynı sınıflardır 
ve tüm bunların doğru Ol D için bir eşleme sağlamak gerekir. Özel bir algoritma (veya hatta başka bir uygulama 
AES!) sağlamak bir geliştirici istediyseniz, OID bize bildirmek gerekir. Bu ek kayıt adımı sistem yapılandırması 
özellikle sorunlu hale getirir. 

Geri adım atma, biz sorun yanlış yönünden yaklaşmakta, verdik. OID, algoritma nedir bildirir, ancak biz aslında bu 
hakkında düşünmeniz gerekmez. Tek bir entropic değer güvenli bir şekilde iki farklı algoritmalar kullanmak 
ihtiyacımız olursa bize algoritmalar gerçekten ne olduğunu öğrenmek gerekli değildir. Ne biz gerçekten çok önem 
verdiğiniz davranışları olur. Herhangi bir simetrik makul bir blok şifreleme algoritmasını da güçlü bir sözde rastgele 
permütasyon (PRP) olan: (modu, IV, düz metin zincirleme anahtarı) girişleri düzeltmek ve olasılık aşırı 
yüklenilmesini ile ciphertext çıkış başka bir simetrik blok şifreleme farklı olacaktır aynı girişlere algoritması. Benzer 
şekilde, tüm makul anahtarlı karma işlev de güçlü bir sözde rastgele işlevi (PRF), ve sabit bir giriş kümesi çıktısını 
çok diğer anahtarlı karma işlevinden farklı olacaktır. 

Bir bağlam başlığını oluşturmak için bu kavramı güçlü PRPs ve PRFs kullanıyoruz. Bu bağlam üst bilgi kararlı bir 
parmak izi temelde herhangi bir işlem için kullanılan algoritmalar üzerinden çalışır ve veri koruma sistemi 
tarafından gereken şifreleme çevikliği sağlar. Bu üst bilgiyi yeniden üretilebilen ve daha sonra bir parçası olarak 
kullanılan alt anahtarını türetme işlem. Temel alınan algoritmaları işlem moduna bağlı olarak bağlam üstbilgiyi 
oluşturmak için iki farklı yolu vardır. 

CBC modunda şifreleme + HMAC kimlik doğrulaması 

İçerik üstbilgisi aşağıdaki bileşenlerden oluşur: 

• [16 bit] 1 % S'değeri 00 bir işaretçidir 00 "CBC şifreleme + HMAC kimlik doğrulama" anlamına gelir. 

• [32 bit] Blok simetrik şifreleme algoritması anahtarı uzunluğu (bayt cinsinden, büyük-endian). 

• [32 bit] Blok boyutu (bayt cinsinden, büyük-endian) blok simetrik şifreleme algoritması. 

• [32 bit] HMAC algoritmanın anahtar uzunluğu (bayt cinsinden, büyük-endian). (Şu anda anahtar boyutu her 
zaman Özet boyut eşleşir.) 

• [32 bit] HMAC algoritmasının Özet boyutu (bayt cinsinden, büyük-endian). 

• EncCBC (K_E, IV,""), çıkış boş dize girişi verilen simetrik blok şifreleme algoritması olan ve IV tüm sıfır 
vektör olduğu. K_E oluşumu aşağıda açıklanmıştır. 





• MAC (K_H,""), bir boş dize girişi verilen HMAC algoritması çıktısı gibidir. K_H oluşumu aşağıda 
açıklanmıştır. 

K_E ve K_H için tüm sıfır vektörleri ideal olarak, geçirebiliriz. Bununla birlikte, burada temel algoritma, tüm sıfır 
vektör gibi basit veya tekrarlanabilir bir deseni kullanılarak ışığının (özellikle DES ve 3DES), herhangi bir işlem 
gerçekleştirmeden önce bulunup bulunmadığını zayıf anahtarları kontrol eder önlemek istiyoruz. 

Bunun yerine, biz NIST SP800 108 KDF sayacı modunda kullanın (bkz NIST SP800-108, Sec. 5.1) sıfır uzunluklu 
anahtar, etiketve bağlam ve temel alınan PRF olarak HMACSHA512. Biz türetilen [ K_E | + | K_H | Çıktı, bayt 
ardından ayırmak sonucu K_E ve K_H kendilerini. Matematiksel olarak, bunu şu şekilde gösterilir. 

( K_E || K_H ) = SP800_108_CTR(prf = HMACSHA512, key = label = context = "") 

Örnek: AES 192 CBC + HMACSHA256 

Örneğin, burada blok simetrik şifreleme algoritması AES 192 CBC ve doğrulama algoritması HMACSHA256 bir 
durum düşünün. Sistem aşağıdaki adımları kullanarak içerik üstbilgisi oluşturur. 

ilk olarak, izin (K_E || K_H) SP800_108_CTR = (prf HMACSHA512, = key = etiketi = bağlam = burada | 
K_E | = 192 bitleri ve | K_H | Belirtilen algoritma başına 256 bit =. Bu müşteri adayları için K_E 5BB6 =... 21DD ve 
K_H A04A =... Aşağıdaki örnekte 00A9: 
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Ardından, Enc_CBC işlem (K_E, IV,"") AES-192-IV verilen CBC için = 0 * ve yukarıdaki K_E. 
Sonuç: F474B1872B3B53E4721 DE19C0841 DB6F = 

Ardından, MAC işlem (K_H,"") K_H yukarıdaki verilen HMACSHA256 için. 

Sonuç: D4791184B996092EE1202F36E8608FA8FBD98ABDFF5402F264B1 D7211 536220C = 
Bu, tam bağlam üst bilgisi oluşturur: 
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Parmak izi kimliği doğrulanmış şifreleme algoritması çifti (AES 192 CBC şifreleme + HMACSHA256 doğrulama) 
bu içeriği başlığıdır. Açıklandığı bileşenleri yukarıda şunlardır: 


• işaretin (00 00) 

• Blok şifreleme anahtarı uzunluğu (00 00 00 18) 

• Blok Şifre blok boyutu (00 00 00 10) 

• HMAC anahtar uzunluğu (00 00 00 20) 

• HMAC Özet boyut (00 00 00 20) 

• Blok şifreleme PRP çıkış (F4 74 - DB 6F) ve 


• HMAC PRF çıkış (D4 79 -bitiş). 





NOTE 

CBC modunda şifreleme + HMAC kimlik doğrulama bağlam üstbilgisi algoritmaları uygulamaları VVİndovvs CNG veya 
yönetilen SymmetricAlgorithm ve KeyedHashAlgorithm türleri tarafından sağlanan bağımsız olarak aynı şekilde oluşturulur. Bu 
algoritmalar uygulamaları işletim sistemleri arasında farklılık olsa bile güvenilir bir şekilde aynı bağlam üst bilgisi üretmek farklı 
işletim sistemlerinde çalışan uygulamalar sağlar (Uygulamada KeyedHashAlgorithm uygun bir HMAC olmak zorunda değildir. 
Herhangi bir anahtarlı karma algoritması türü olabilir.) 


Örnek: 3DES-192-CBC + HMACSHA1 

ilk olarak, izin (K_E j| K_H) SP800_108_CTR = (prf HMACSHA512, = key = etiketi = bağlam = burada | 
K_E | = 192 bitleri ve | K_H | Belirtilen algoritma başına 160 bit =. Bu müşteri adayları için K_E A219 =... E2BB ve 
K_H DC4A =... Aşağıdaki örnekte B464: 
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Ardından, Enc_CBC işlem (K_E, IV,"") 3DES-192-IV verilen CBC için = 0 * ve yukarıdaki K_E. 

Sonuç: ABB100F81E53E10E = 

Ardından, MAC işlem (K_H,"") K_H yukarıdaki verilen HMACSHA1 için, 
result := 76EB189B35CF03461 DDF877CD9F4B1 B4D63A7555 

Bu, kimliği doğrulanmış bir parmak izi olan tam içerik üstbilgisi oluşturur aşağıda gösterilen şifreleme algoritması 
çifti (3DES 192 CBC şifreleme + HMACSHA1 doğrulama): 


00 

00 

00 

00 

00 

18 

00 

00 

00 

00 

o 

00 

00 

00 

14 

00 

00 

00 

14 

AB 

B1 

00 

F8 

İE 

53 

El 

0E 

76 

EB 

18 

9B 

35 

CF 

03 

46 

İD 

DF 

87 

7C 

D9 

F4 

B1 

B4 

D6 

3A 

75 

55 




Bileşenleri gibi parçalara ayırın: 

• işaretin (00 00) 

• Blok şifreleme anahtarı uzunluğu (00 00 00 18) 

• Blok Şifre blok boyutu (00 00 00 08) 

• HMAC anahtar uzunluğu (00 00 00 14) 

• HMAC Özet boyut (00 00 00 14) 

• Blok şifreleme PRP çıkış (AB B1 - El 0E) ve 

• HMAC PRF çıkış (76 EB - bitiş). 

Galois/sayacı modu şifreleme + kimlik doğrulaması 

içerik üstbilgisi aşağıdaki bileşenlerden oluşur: 

• [16 bit] 1 % S'değeri 00 bir işaretçidir 01, "GCM şifreleme + kimlik doğrulama" anlamına gelir. 

• [32 bit] Blok simetrik şifreleme algoritması anahtarı uzunluğu (bayt cinsinden, büyük-endian). 

• [32 bit] Kimliği doğrulanmış şifreleme işlemleri sırasında kullanılan nonce boyutu (bayt cinsinden, büyük- 
endian). (Sistemimiz için bu nonce boyutunda sabit = 96 bit.) 





• [32 bit] Blok boyutu (bayt cinsinden, büyük-endian) blok simetrik şifreleme algoritması. (GCM için bu blok 
boyutunda sabit = 128 bit.) 

• [32 bit] Kimliği doğrulanmış şifreleme işleviyle üretilen kimlik doğrulaması etiketi boyutu (bayt cinsinden, 
büyük-endian). (Sistemimiz için bu etiketi boyutunda sabit = 128 bit.) 

• [128 bit] Enc_GCM etiketi (K_E nonce,""), çıkış boş dize girişi verilen simetrik blok şifreleme algoritması 
olan ve nonce 96 bit tüm sıfır vektör olduğu. 

K_E CBC şifreleme + kimlik doğrulama senaryosu HMAC olduğu gibi aynı mekanizması kullanılarak elde edilir. 
Bununla birlikte, burada oyunda hiçbir K_H olduğundan, temelde sahibiz | K_H | 0 = için algoritma daraltılır formun 
altındaki. 

K_E SP800_108_CTR = (prf HMACSHA512, = key = etiketi = bağlam = "") 

Örnek: AES-256-GCM 

ilk olarak, K_E izin SP800_108_CTR = (prf HMACSHA512, = anahtar = etiketi = bağlam = ""), burada | K_E | 

= 256 bit. 

K_E := 22BC6F1 B171C08C4AE2F27444AF8FC8B3087A90006CAEA91 FDCFB47C1 B8733B8 

Ardından, kimlik doğrulaması etiketi Enc_GCM, işlem (K_E nonce,"") AES-256-nonce verilmiş GCM için yukarıdaki 
= 096 ve K_E. 

result := E7DCCE66DF855A323A6BB7BD7A59BE45 
Bu, tam bağlam üst bilgisi oluşturur: 
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Bileşenleri gibi parçalara ayırın: 

• işaretin (00 01) 

• Blok şifreleme anahtarı uzunluğu (00 00 00 20) 

• nonce boyutu (00 00 00 0 C) 

• Blok Şifre blok boyutu (00 00 00 10) 

• kimlik doğrulaması etiket boyutu (00 00 00 10) ve 

• Blok şifreleme çalışmasını kimlik doğrulaması etiketi (DC E7 - bitiş). 
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Veri koruma sisteminde ana korumak ve yüklerin korumasını kaldırma için kullanılan anahtarları ömrünü 
otomatik olarak yönetir. Her anahtar dört aşamasını biri mevcut olabilir: 

• Oluşturulan - anahtar, anahtar halka var ancak henüz etkinleştirilmedi. Yeterli süre kadar anahtarı bu 
anahtarı kademeyi kullanan tüm makinelere yaymak için bir fırsat oluşmuş anahtarı yeni koruma işlemleri 
için kullanılmamalıdır. 

• Etkin - anahtar, anahtar halka var ve tüm yeni koruma işlemleri için kullanılmalıdır. 

• Kullanım süresi doldu - anahtar doğal ömrü çalıştırıldı ve artık yeni koruma işlemleri için kullanılmalıdır. 

• iptal edilen - anahtar tehlikeye ve yeni koruma işlemleri için kullanılmamalıdır. 

Oluşturulan, etkin ve süresi dolan anahtarlar tüm gelen yüklerin korumasını kaldırma için kullanılabilir. 
Varsayılan olarak, iptal edilen anahtarları yüklerin korumasını kaldırma için kullanılamaz, ancak uygulama 
geliştiricisi için bu davranışı geçersiz kılma gerekirse. 


VVARNING 

Geliştirici (örneğin, karşılık gelen dosyayı dosya sisteminden silerek) anahtar halka dışında bir anahtarı silme fikri size cazip 
olabilir. Bu noktada, anahtar tarafından korunan tüm verileri kalıcı olarak undecipherable ve iptal edilen anahtarlarla gibi Acil 
Durum geçersiz kılma yoktur. Bir anahtarı silme gerçekten yıkıcı davranıştır ve sonuç olarak bu işlemi gerçekleştirmek için 
veri koruma sisteminde birinci sınıf yok API sunar. 


Varsayılan anahtar seçimi 

Veri koruma sisteminde yedekleme deposundan anahtar halkası okuduğunda, bir "varsayılan" anahtar, anahtar 
halkası bulun dener. Varsayılan anahtar yeni koruma işlemleri için kullanılır. 

Veri koruma sisteminde varsayılan anahtarı olarak en son etkinleştirme tarihi anahtarla seçtiği genel buluşsal 
yöntem olur. (Küçük karamelli faktörü için sunucudan sunucuya saat eğriltme olanak yoktur.) Anahtarın süresi 
doldu veya iptal, anahtar oluşturma ve uygulama otomatik devre dışı ise durumunda yeni bir anahtar hemen 
etkinleştirme ile oluşturulan anahtar süre sonu ve sıralı aşağıdaki ilke. 

Veri koruma sisteminde neden yeni bir anahtar hemen oluşturur yerine yeni anahtar oluşturma, yeni anahtar 
önce etkinleştirilen tüm anahtarların örtük bir sona erme olarak değerlendirilip olan farklı bir anahtara geri 
dönülüyor. Genel yeni anahtarları farklı algoritmalar veya daha eski anahtarları bekleyen şifreleme 
mekanizmaları ile yapılandırılmış olabilir ve sistemin geçerli yapılandırmasını dönülüyor tercih etmelisiniz olur. 

Bir özel durum söz konusudur. Uygulama geliştiricisi varsa otomatik anahtar oluşturma devre dışı, sonra da veri 
koruma sisteminde bir varsayılan anahtar olarak seçmeniz gerekir. Geri dönüş Bu senaryoda, kümedeki diğer 
makinelere yaymak için bir süre beklendiğinden anahtarlarına öncelik ile en son etkinleştirme tarihi olmayan 
iptal anahtarla sistemi seçer. Geri dönüş sistemi, süresi dolmuş varsayılan anahtar sonucunda seçme 
sonlandırabiliriz. Geri dönüş sistemi hiçbir zaman iptal edilen bir anahtar varsayılan anahtarı olarak seçer ve 
ardından anahtar halkası boş ise veya her anahtarı iptal edilmiş sistem başlatma sırasında bir hata üretecektir. 

Anahtarı süre sonu ve sıralı 

Bir anahtar oluşturulduğunda bir etkinleştirme tarihi {now + 2 gün} ve {now + 90 gün} bir sona erme tarihi 








otomatik olarak sağlamıştır. Etkinleştirme 2 gün gecikmeyle sistem üzerinden yaymak için anahtar zaman verir. 
Diğer bir deyişle, anahtar, sonraki otomatik yenileme dönemi boyunca, böylece anahtar halka ettiğinde, 
yayılmadan olur mu etkin gerekebilecek tüm uygulamaları kullanın, büyük olasılıkla en üst düzeye gözlemlemek 
yedekleme mağazada işaret eden diğer uygulamaların izin verir. 

Varsayılan anahtar 2 gün içinde sona erecek ve anahtar halkası varsayılan anahtarı sona erdikten sonra etkin olan 
bir anahtar zaten yoksa, veri koruma sisteminde yeni bir anahtar halkası anahtarına otomatik olarak korunur. Bu 
yeni anahtar bir etkinleştirme tarihi {varsayılan anahtarının sona erme tarihi} ve {now + 90 gün} bir sona erme 
tarihi vardır. Bu anahtarlar düzenli olarak hizmet kesinti olmadan otomatik olarak geri almak sistem sağlar. 

Bir anahtar ile hemen etkinleştirme oluşturulacağı durumlar olabilir. Bir örnek uygulama için bir saat boyunca 
çalışmamışsa ve tüm anahtar halkası anahtarlarında süresi dolmuş olabilir. Bu durumda, anahtar {şimdi} normal 
2 günlük etkinleştirme gecikme olmadan bir etkinleştirme tarihi verilir. 

Varsayılan anahtar yaşam süresi 90 gün, aşağıdaki örnekte olduğu gibi yapılandırılabilir ancak. 

Services.AddDataProtection() 

// use 14-day lifetime instead of 90-day lifetime 
.SetDefaultKeyl_ifetime(TimeSpan. FromDays(14)); 

Açık bir çağrı olsa yönetici aynı zamanda varsayılan sistem genelinde değiştirebilirsiniz setDefaultKeyLifetime 
tüm sistem genelinde bir ilke geçersiz kılar. Varsayılan anahtar yaşam süresi 7 günden daha kısa olamaz. 

Otomatik anahtar halkası yenileme 

Veri koruma sisteminde başlatır, temel alınan depodan anahtar halkası okur ve bellekte önbelleğe alır.Bu 
önbellek yedekleme deposu ulaşmaktan olmadan devam etmek, koruma ve Unprotect işlemlere izin verir. Sistem 
otomatik olarak yaklaşık 24 saatte veya geçerli varsayılan anahtar süresi dolduğunda, hangisinin önce geldiğine 
bağlı değişiklikleri yedekleme deposu kontrol edecektir. 


VVARNING 

Geliştiriciler gereken çok nadir (Şimdiye kadar değilse) anahtar yönetimi API'lerini doğrudan kullanmanız gerekir. Veri 
koruma sistemi otomatik anahtar yönetimi, yukarıda açıklanan şekilde gerçekleştirir. 


Veri koruma sisteminde bir arabirimi kullanıma sunan iKeyManager incelemek için anahtar halkası değişiklikler 
yapmak için kullanılabilir. Örneğini sağlanan Dİ sistem iDataProtectionProvider örneği de sağlayabilirsiniz 
İKeyManager tüketiminiz için. Alternatif olarak, çekme iKeyManager doğrudan gelen ıserviceProvider aşağıdaki 
örnekte olduğu gibi. 

Anahtar (yeni bir anahtar açıkça oluşturma veya iptali gerçekleştirme) halkası değiştirir, herhangi bir işlem, bellek 
içi önbellek geçersiz kılar. Sonraki çağrı Protect veya unprotect anahtar halkası yeniden okuyun ve önbelleği 
yeniden oluşturmak veri koruma sisteminde neden olur. 

Aşağıdaki örneği kullanarak gösterir İKeyManager inceleyin ve belirtece anahtarları mevcut ve yeni bir anahtarı el 
ile oluşturma da dahil olmak üzere anahtar halkası işlemek için arabirim. 

using System; 

using System.10; 

using System.Threading; 

using Microsoft.AspNetCore.DataProtection; 

using Microsoft .AspNetCore. DataProtection. KeyManagement; 

using Microsoft.Extensions.DependencyInjection; 

public class Program 
{ 
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{ 

var serviceCollection = new ServiceCollection(); 
serviceCollection.AddDataProtection() 

// point at a specific folder and use DPAPI to encrypt keys 
.PersistKeysToFileSystem(new DirectoryInfo(@"c: \temp-keys") ) 

.ProtectKeysWithDpapi(); 

var Services = serviceCollection.BuildServiceProvider(); 

// perform a protect operation to force the system to put at least 
// one key in the key ring 

Services.GetDataProtector("Sample.KeyManager.vl").Protect("payload"); 
Console.WriteLine("Performed a protect operation."); 

Thread.Sleep(2000); 

// get a reference to the key manager 

var keyManager = Services.GetService<IKeyManager>(); 

// üst ali keys in the key ring 
var allKeys = keyManager.GetAÜKeys(); 

Console.WriteLine($"The key ring contains {allKeys.Count} key(s)."); 
foreach (var key in allKeys) 

{ 

Console.WriteLine($"Key {key.KeyId:B}: Created = {key.CreationDateru}, IsRevoked = 
{key.IsRevoked}"); 

} 

// revoke ali keys in the key ring 

keyManager.RevokeAllKeys(DateTimeOffset.NoWj reason: "Revocation reason here."); 
Console.WriteLine("Revoked ali existing keys."); 

// add a new key to the key ring with immediate activation and a 1-month expiration 
keyManager.CreateNewKey( 

activationDate: DateTimeOffset.Now., 
expirationDate: DateTimeOffset.Now.AddMonths(l)); 

Console.WriteLine("Added a new key."); 

// üst ali keys in the key ring 
allKeys = keyManager.GetAllKeys(); 

Console.WriteLine($"The key ring contains {allKeys.Count} key(s)."); 
foreach (var key in allKeys) 

{ 

Console.WriteLine($"Key {key.KeyldrB}: Created = {key.CreationDateru}, IsRevoked = 
{key.IsRevoked}"); 

} 

} 

} 

/* 

* SAMPLE OUTPUT 

* 

* Performed a protect operation. 

* The key ring contains 1 key(s). 

* Key {lb948618-belf-440b-b204-64ff5al52552}: Created = 2015-03-18 22:20:49Z, IsRevoked = False 

* Revoked ali existing keys. 

* Added a new key. 

* The key ring contains 2 key(s). 

* Key {lb948618-belf-440b-b204-64ff5al52552}: Created = 2015-03-18 22:20:49Z, IsRevoked = True 

* Key {2266fc40-e2fb-48c6-8ce2-5fde6bl493f7}: Created = 2015-03-18 22:20:51Z, IsRevoked = False 

*/ 


Anahtar depolama 

Veri koruma sisteminde verebileceğiniz bir uygun anahtar depolama konumu ve bekleyen şifreleme 
mekanizması otomatik olarak çıkarmaya çalışır bir buluşsal yönteme sahip. Anahtar kalıcılığı mekanizmasının 
Ayrıca uygulama geliştiricisi tarafından yapılandırılabilir. Aşağıdaki belgeler, bu mekanizmaların yerleşik 



uygulamalar açıklanmaktadır: 

• ASP.NET core'da anahtar depolama sağlayıcıları 

• ASP.NET core'da bekleme durumunda anahtar şifreleme 
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Veri koruma sisteminde bulma mekanizmasından varsayılan olarak kullandığı şifreleme anahtarları nerede 
kalıcı belirlemek için. Geliştirici, varsayılan bulma mekanizmasını geçersiz kılmak ve el ile konumu belirtin. 


VVARNING 

Bir açık anahtar kalıcılığı konum belirtirseniz, anahtarlar artık bekleme durumundayken şifrelenir, böylece veri koruma 
sisteminde rest mekanizması, varsayılan anahtar şifreleme deregisters. Bırakmanız önerilir, ayrıca açık anahtar şifreleme 
mekanizması belirtin üretim dağıtımları için. 


Dosya sistemi 

Bir dosya sistemi tabanlı anahtar deposu yapılandırmak için çağrı PersistKeysToFileSystem aşağıda gösterildiği 
gibi yapılandırma yordamı. Sağlayan bir Directorylnfo anahtarları nerede depolanmalıdır depoya işaret eden: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDataProtection() 

.PersistKeysToFileSystem(new DirectoryInfo(@"c:\temp-keys\")); 

} 

Directorylnfo Yerel makinede bir dizine işaret edebilir ya da bir ağ paylaşımındaki bir klasöre işaret edebilir. 
Yerel makinede bir dizine işaret ediyorsanız (ve yalnızca yerel makinede uygulamaları bu depo erişimi 
gerektiren senaryodur) kullanmayı düşünün Windows DPAPI (Bekleyen anahtarlarını şifrelemek için üzerinde 
Windows). Aksi takdirde kullanmayı bir X.509 sertifikası bekleyen anahtarlarını şifrelemek için. 

Azure Depolama 

Microsoft. AspNetCore. DataProtection. AzureStorage Package, veri koruma anahtarlarının Azure Blob 
depolama alanında depolanmasını sağlar. Anahtarları birden fazla örneği bir web uygulaması arasında 
paylaşılabilir. Uygulamalar, kimlik doğrulama tanımlama bilgisi veya CSRF koruması birden çok sunucu 
arasında paylaşabilirsiniz. 

Azure Blob depolama sağlayıcısını yapılandırmak için PersistKeysToAzureBlobStorage aşırı yüklemelerinin 
birini çağırın. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDataProtection() 

.PersistKeysToAzureBlobStorage(new Uri("<blob URI including SAS token>")); 

} 

Web uygulaması bir Azure hizmeti olarak çalışıyorsa, kimlik doğrulama belirteçleri Microsoft. Azure. Services. 
AppAuthenticationkullanılarak otomatik olarak oluşturulabilir. 








var tokenProvider = new AzureServiceTokenProvider(); 

var token = await tokenProvider.GetAccessTokenAsync("https://storage. azure.com/"); 
var credentials = new StorageCredentials(new TokenCredential(token)); 

var storageAccount = new CloudStorageAccount(credentials, "mystorageaccount", "core.windows.net", useHttps 
true); 

var Client = storageAccount.CreateCloudBlobClient(); 

var Container = Client.GetContainerReference("my-key-container"); 

// optional - provision the Container automatically 
await Container.CreateIfNotExistsAsync(); 

Services.AddDataProtection() 

.PersistKeysToAzureBlobStorage(Container, "keys.xml"); 


Hizmetten hizmete kimlik doğrulaması yapılandırma hakkında daha fazla ayrıntı için bkz.. 

Red is 

Microsoft. AspNetCore. DataProtection. StackExchangeRedis paketi, veri koruma anahtarlarının redsıs 
önbelleğinde depolanmasını sağlar. Anahtarları birden fazla örneği bir web uygulaması arasında paylaşılabilir. 
Uygulamalar, kimlik doğrulama tanımlama bilgisi veya CSRF koruması birden çok sunucu arasında 
paylaşabilirsiniz. 

Microsoft. AspNetCore. DataProtection. redsıs paketi, veri koruma anahtarlarının redsıs önbelleğinde 
depolanmasını sağlar. Anahtarları birden fazla örneği bir web uygulaması arasında paylaşılabilir. Uygulamalar, 
kimlik doğrulama tanımlama bilgisi veya CSRF koruması birden çok sunucu arasında paylaşabilirsiniz. 

Redis yapılandırmak için aşağıdakilerden birini çağırın PersistKeysToStackExchangeRedis aşırı yüklemeler: 

public void ConfigureServices(IServiceCollection Services) 

{ 

var redis = ConnectionMultiplexer.Connect("<URI>"); 

Services.AddDataProtection() 

.PersistKeysToStackExchangeRedis(redis, "DataProtection-Keys"); 

} 


Redis yapılandırmak için aşağıdakilerden birini çağırın PersistKeysToRedis aşırı yüklemeler: 

public void ConfigureServices(IServiceCollection Services) 

{ 

var redis = ConnectionMultiplexer.Connect("<URI>"); 

Services.AddDataProtection() 

.PersistKeysToRedis(redis, "DataProtection-Keys"); 

} 

Daha fazla bilgi için aşağıdaki konulara bakın: 

• StackExchange.Redis ConnectionMultiplexer 

• Azure Redis önbelleği 

• ASP.NET/DataProtection örnekleri 

Kayıt defteri 

Yalnızca Windows dağıtımları için geçerlidir. 

Bazen uygulama dosya sistemine yazma erişimi olmayabilir. Bir uygulamayı sanal hizmet hesabı olarak çalıştığı 
bir senaryo düşünün (gibi w3wp.exe ait uygulama havuzu kimliği). Bu durumlarda, bir yönetici hizmet hesabı 






kimliği tarafından erişilebilir bir kayıt defteri anahtarı sağlayabilirsiniz. Çağrı PersistKeysToRegistry aşağıda 
gösterildiği gibi bir genişletme yöntemi. Sağlayan bir RegistryKey şifreleme anahtarları nerede depolanmalıdır 
konumuna işaret eden: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDataProtection() 

.PersistKeysToRegistry(Registry.CurrentUser.OpenSubKey(@"SOFTWARE\Sample\keys")); 

} 


IMPORTANT 

Kullanmanızı öneririz VVİndovvs DPAPI bekleyen anahtarlarını şifrelemek için. 


Entity Framevvork Core 

Microsoft.AspNetCore.DataProtection.EntityFramevvorkCore paket Entity Framevvork Core kullanan bir 

mekanizma sağlar. 

NuGet paketini eklenmelidir proje dosyası değil 

Bu Paketle, anahtarları birden fazla örneğini bir web uygulaması arasında paylaşılabilir. 

EF Core sağlayıcıyı yapılandırmak için, Persistkeystodbcontext<TContext > metodunu çağırın: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 

// Add a DbContext to store your Database Keys 
Services.AddDbContext<MyKeysContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("MyKeysConnection"))); 

// using Microsoft.AspNetCore.DataProtection; 

Services.AddDataProtection() 

.PersistKeysToDbContext<MyKeysContext>(); 

Services.AddDefaultIdentity<IdentityUser>() 

.AddDefaultUI(UIFramework.Bootstrap4) 

.AddEntityFrameworkStores<ApplicationDbContext>(); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


veritabanı için veri koruma anahtarları depolamak için bir 
Microsoft.AspNetCore.DataProtection.EntityFrameworkCore 
parçası Microsoft.AspNetCore.App metapackage. 


TContext genel parametresi, DbContext öğesinden devralması ve ıdataprotectionkeycontextuygulamalıdır: 






using Microsoft.AspNetCore.DataProtection.EntityFrameworkCore; 
using Microsoft.EntityFrameworkCore; 
using UebAppl.Data; 

namespace WebAppl 

{ 

class MyKeysContext : DbContext, IDataProtectionKeyContext 

{ 

// A recommended constructor overload when using EF Core 
// with dependency injection. 

public MyKeysContext(DbContextOptions<MyKeysContext> options) 

: base(options) { } 

// This maps to the table that Stores keys. 

public DbSet<DataProtectionKey> DataProtectionKeys { get; set; } 

} 

} 

DataProtectionKeys tablosunu oluşturun. 


• Visual Studio 

• .NET Core CU 

Paket Yöneticisi konsolu (PMC) penceresinde aşağıdaki komutları yürütün: 

Add-Migration AddDataProtectionKeys -Context MyKeysContext 
Update-Database -Context MyKeysContext 

MyKeysContext , yukarıdaki kod örneğinde tanımlanan DbContext . Farklı bir ada sahip bir DbContext 
kullanıyorsanız, MyKeysContext için DbContext adınızı yerine koyun. 

DataProtectionKeys sınıfı/varlığı, aşağıdaki tabloda gösterilen yapıyı benimsemiştir. 

ÖZELLIK/ALAN CLRTÜRÜ SQL TÜRÜ 


Id 


int 


int , PK, null değil 


FriendlyName 


string 


nvarchar(MAX) ; null 


Xml 


stning 


nvarchar(MAX) , null 


Özel anahtar deposu 

Yerleşik mekanizmalar uygun değilse, geliştirici, kendi anahtar Kalıcılık mekanizması bir özel sağlayarak 
belirtebilirsiniz IXmlRepository. 
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Veri koruma sisteminde bulma mekanizmasından varsayılan olarak kullandığı nasıl şifreleme anahtarlarını 
belirlemek için bekleme durumundayken şifrelenir. Geliştirici, Keşif mekanizması geçersiz kılmak ve el ile nasıl 
anahtarları bekleyen şifrelenmesi gerektiğini belirtin. 


VVARNING 

Açık bir belirtirseniz anahtar Kalıcılık konumuna, veri koruma sisteminde rest mekanizması, varsayılan anahtar şifreleme 
deregisters. Sonuç olarak, anahtarlar artık bekleme durumundayken şifrelenir. Olmasını öneririz, açık anahtar şifreleme 
mekanizması belirtin üretim dağıtımları için. Bu konudaki bekleyen şifreleme mekanizması seçenekleri açıklanmaktadır. 


Azure Key Vault 

içindeki anahtarları depolamak için Azure anahtar kasası, sistemle yapılandırma 
ProtectKeysVVİthAzureKeyVault içinde startup sınıfı: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDataProtection() 

.PersistKeysToAzureBlobStorage(new Uri("<blobUriWithSasToken>")) 

.ProtectKeysWithAzureKeyVault("<keyIdentifier>", "<clientld>", "<clientSecret>"); 

} 


Daha fazla bilgi için AS P.N ET Core veri koruma yapılandırın: ProtectKeysVVİthAzureKeyVault. 

VVindovvs DPAPI 

Yalnızca VVindovvs dağıtımları için geçerlidir. 

VVindovvs DPAPI kullanıldığında, anahtar malzemesi ile şifrelenir CryptProtectData Depolama'da kalıcı hale 
önce. DPAPI geçerli makine dışında hiçbir zaman okunan veriler için bir uygun şifreleme mekanizması 
olduğunu (ancak Active Directory kadar bu anahtarları yedeklemek mümkündür; bkz DPAPI ve dolaşım 
profillerini). DPAPI anahtarı bekleyen şifreleme yapılandırmak için aşağıdakilerden birini çağırın 

ProtectKeysVVİthDpapi genişletme yöntemleri: 

public void ConfigureServices(IServiceCollection Services) 

{ 

// Only the local user account can decrypt the keys 
Services.AddDataProtection() 

.ProtectKeysWithDpapi(); 

} 

Varsa ProtectKeyswithDpapi hiçbir parametre olmadan, yalnızca geçerli VVindovvs kullanıcı hesabı kalıcı 
anahtar halkası çözülebilir çağrılır, isteğe bağlı olarak, herhangi bir kullanıcı hesabı makinedeki (yalnızca 
geçerli kullanıcı hesabı) anahtar halkası şifre çözme yapabilmek belirtebilirsiniz: 










public void ConfigureServices(IServiceCollection Services) 

{ 

// Ali user accounts on the machine can decrypt the keys 
Services.AddDataProtection() 

.ProtectKeysWithDpapi(protectToLocalMachine: true); 

} 


X.509 sertifikası 

Uygulama, birden çok makineye yayılmış, paylaşılan bir X.509 sertifikasının makinelerde dağıtmak ve 
barındırılan uygulamaları şifreleme anahtarları, bekleyen veri için sertifikayı kullanacak şekilde yapılandırmak 
kullanışlı olabilir: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDataProtection() 

. ProtectKeysl/JithCertif icate( "3BCE558E2AD3E0E34A7743EAB5AEA2A9BD2575A0"); 

} 


.N ET Framevvork sınırlamaları nedeniyle, yalnızca ÇAPI özel anahtarları olan sertifikaları desteklenir. Olası 
geçici çözümleri için bu sınırlamalar aşağıda içeriğine bakın. 

VVindovvs DPAPI-NG 

Bu mekanizma, yalnızca VVindovvs 8/Windows Server 2012 veya sonraki bir sürümü kullanılabilir. 

VVindovvs 8'le başlayarak, VVindovvs işletim sistemi DPAPI-NG (CNG DPAPI olarak da bilinir) destekler. Daha 
fazla bilgi için CNG DPAPI hakkında. 

Asıl koruma tanımlayıcısı kural olarak kodlanır.Çağıran aşağıdaki örnekte ProtectKeysVVİthDpapiNG, yalnızca 
belirtilen SID ile etki alanına katılmış kullanıcı anahtarı halka şifresini çözebilir: 

public void ConfigureServices(IServiceCollection Services) 

{ 

// Uses the descriptor rule "SID=S-l-5-21-..." 

Services.AddDataProtection() 

.ProtectKeysWithDpapiNG("SID=S-l-5-21-...", 
flags: DpapiNGProtectionDescriptorFlags.None); 

} 

Ayrıca bir parametresiz aşırı yüklemesi vardır ProtectKeyswithDpapii\iG . Bu kolaylık yöntemi, kural belirtmek 
için kullanın "SID {CURRENT_ACCOUNT_SID} =" burada CURRENT_ACCOUNT_SID geçerli VVindovvs 
kullanıcı hesabı SID'si: 


public void ConfigureServices(IServiceCollection Services) 
{ 

// Use the descriptor rule "SID={current account SID}" 
Services.AddDataProtection() 

.ProtectKeysWithDpapiNG(); 

} 


Bu senaryoda, AD etki alanı denetleyicisi DPAPI-NG işlemleri tarafından kullanılan şifreleme anahtarlarını 
dağıtmaktan sorumludur, (işlem kimliklerini altında çalışıyor olması koşuluyla) hedef kullanıcı etki alanına 
katılmış herhangi bir makineden şifreli yük çözülebilir. 







Sertifika tabanlı şifreleme ile VVindovvs DPAPI-NG 

Uygulamayı VVindovvs 8.1 / VVindovvs Server 2012 R2 çalıştıran veya daha sonra sertifika tabanlı şifreleme 
gerçekleştirmek için VVindovvs DPAPI-NG kullanabileceğiniz olur. Kural tanımlayıcısı dizesi kullan "Sertifika 
Hashld:THUMBPRINT =" burada parmak İZİ onaltılık kodlanmış SHA1 parmak izi sertifika: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDataProtection() 

. ProtectKeysl/JithDpapiNG("CERTIFICATE=HashId: 3BCE558E2. .. B5AEA2A9BD2575A0", 
flags: DpapiNGProtectionDescriptorFlags.None); 

} 

VVindovvs 8.1 / VVindovvs Server 2012 R2 veya daha sonra anahtarları çözmek için bu depoyu işaret eden 
herhangi bir uygulamayı çalıştırması gerekir. 

Özel anahtar şifreleme 

Yerleşik mekanizmalar uygun değilse, geliştirici, kendi anahtar şifreleme mekanizması bir özel sağlayarak 
belirtebilirsiniz IXmlEncryptor. 
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Yedekleme deposu için bir nesneyi kalıcı sonra gösterimine her zaman sabittir. Yeni veri yedekleme deposu için 
eklenebilir, ancak hiçbir zaman mevcut verileri dönüşür. Bu davranış birincil amacı, veri bozulması engellemektir. 

Bu davranış bir sonucu bir anahtarı yedekleme deposuna yazılır, sonra da değişmez olmasıdır.iptal ancak 
kullanarak oluşturma, etkinleştirme ve sona erme tarihleri hiçbir zaman, değiştirilebilir iKeyManager . Ayrıca, kendi 
temel alınan algoritmik bilgileri, ana anahtar malzemesini ve diğer özellikleri şifrelemeyi de sabittir. 

Geliştirici anahtar kalıcılığı etkileyen herhangi bir ayar değişirse, bu değişiklikleri bir anahtar oluşturulur, zamana 
kadar açık bir çağrı yoluyla yürürlüğe olmaz İKeyManager.createNewKey veya veri koruma sisteminin kendi 
aracılığıyla otomatik anahtar nesil davranışı. Anahtar kalıcılığı etkileyen ayarlar aşağıdaki gibidir: 

• Varsayılan anahtar yaşam süresi 

• Rest mekanizması, anahtar şifreleme 

• Anahtarı içinde yer alan algoritmik bilgileri 

Zaman çalışırken sonraki otomatik anahtarfden önceki etkisini göstermeye bu ayarlarına gereksinim duyarsanız, 
açık bir çağrı yapmayı göz önüne alın İKeyManager.createNewKey yeni bir anahtar oluşturmayı zorlamak için. Bir açık 
etkinleştirme tarihi vermeyi unutmayın ({artık + 2 gün} bir iyi değişiklik yayılması için zaman tanıyın için udur) ve 
çağrının sona erme tarihi. 


TIP 

Depo temas tüm uygulamalar aynı ayarlarla belirtmelidir iDataProtectionBuilder genişletme yöntemleri. Aksi durumda, 
kalıcı anahtar özelliklerini anahtar oluşturma yordamlarını çağrılan belirli uygulamasına bağımlı olur. 
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Nesneleri, bekleyen veri olarak XML gösterimi depolanır.Anahtar depolama alanı için varsayılan % 
LOCALAPPDATA%\ASP.NET\DataProtection-Keys\ dizindir. 

<Anahtarı > öğesi 

Anahtar deposu en üst düzey nesneleri olarak anahtarları mevcut. Kural gereği, dosya adı anahtarlara sahip 
anahtarı-{GUID} .xml, {GUID} anahtarının kimliğidir.Her bir dosya, tek bir anahtar içeriyor.Dosya biçimi 
aşağıdaki gibidir. 

<?xml version="1.0" encoding="utf-8"?> 

<key İd="80732141-ec8f-4b80-af9c-c4d2dlff8901" version="l"> 

<creationDate>2015-03-19T23:32:02.3949887Z</creationDate> 

<activationDate>2015-03-19T23:32:02.3839429Z</activationDate> 

<expirationDate>2015-06-17T23:32:02.3839429Z</expirationDate> 

<descriptor deserializerType="{deserializerType}"> 

<descriptor> 

<encryption algorithm="AES_256_CBC" /> 
cvalidation algorithm="HMACSHA256" /> 

<enc:encryptedSecret decryptorType="{decryptorType}" xmlns:enc="..."> 

<encryptedKey> 

<!-- This key is encrypted with Windows DPAPI. --> 

< va1ue >AQAAANCM...8/zeP81cwAg==</value> 

</encryptedKey> 

</enc:encryptedSecret» 

</descriptor> 

</descriptor> 

</key> 


<Anahtarı > öğesi, aşağıdaki öznitelikler ve alt öğeleri içerir: 

• Anahtar kimliği. Bu değer, yetkili olarak kabul edilir; yalnızca bir nicety okunabilirlik için dosya adıdır. 

• Sürümü <anahtarı > öğesinde, şu anda 1 sabit. 

• Anahtarın oluşturulması, etkinleştirme ve sona erme tarihleri. 

• A ctanımlayıcısı > Bu anahtarı içinde yer alan kimliği doğrulanmış şifreleme uygulama hakkında bilgi içeren 
öğe. 

Yukarıdaki örnekte, {80732141-ec8f-4b80-af9c-c4d2d1ff8901} anahtarının kimliğidir, onu oluşturuldu ve 19 Mart 
2015'te etkinleştirilen ve 90 gün ömrü vardır. (Bazen etkinleştirme tarihi biraz önce bu örnekte olduğu gibi 
oluşturma tarihi olabilir. Bu API'leri nasıl çalışır ve uygulamada zararsızdır bir nEtki kaynaklanır.) 

cTanımlayıcısı > öğesi 

Dış <tanımlayıcısı > öğesi lAuthenticatedEncryptorDescriptorDeserializer uygulayan bir tür bütünleştirilmiş kodla 
nitelenen adı olan bir öznitelik deserializerType içerir. Bu tür, iç okumak için sorumlu <tanımlayıcısı > öğesi ve 
içinde yer alan bilgileri ayrıştırılıyor. 

Belirli biçimi «ctanımlayıcısı > öğesi kapsüllenmiş anahtarı tarafından kimliği doğrulanmış bir Şifreleyici uygulama 
bağlıdır ve her bir seri durumdan çıkarıcının türü biraz farklı bir biçim bunun için bekliyor. Genel olarak, bu öğe 
algoritmik bilgilerini yine de içerecektir (adları, türleri, OID veya benzer) ve gizli anahtar malzemesi. Yukarıdaki 





örnekte, bu anahtarı AES 256 CBC şifreleme + HMACSHA256 doğrulama sarmalar tanımlayıcısını belirtir. 

<EncryptedSecret > öğesi 

Bir <encryptedSecret> şifrelenmiş gizli anahtar malzemesi içeren öğe mevcut olması durumunda gizli 
anahtarlarının, bekleyen veri şifrelemesi etkin. Öznitelik decryptorType uygulayan bir tür bütünleştirilmiş kodla 
nitelenen adı IXmlDecryptor. Bu tür, iç okumak için sorumlu <encryptedKey> öğesi ve özgün düz metin 
kurtarmak için şifre çözme. 

Olduğu gibi <descriptor> , belirli biçimi <encryptedsecret> öğe kullanımda bekleyen şifreleme mekanizması 
bağlıdır. Yukarıdaki örnekte, ana anahtarı açıklama Windows DPAPI kullanılarak şifrelenir. 


<İptal > öğesi 

Geri alma işlemleri, anahtar deposu en üst düzey nesneleri olarak mevcut. Kural gereği, dosya adını geri alma 
işlemleri sahip iptaKzaman damgası} .xml (için belirli bir tarihten önce tüm anahtarlar iptal) veya iptal-{GUID} 
.xml (için belirli bir anahtarı iptal etme). Her dosyada tek bir <iptaI > öğesi. 

Dosya içeriği için geri alma işlemleri ayrı ayrı anahtarların olacak şekilde aşağıda. 

<?xml version="1.0" encoding="utf-8"?> 

<revocation version="l"> 

<revocationDate>2015-03-20T22:45:30.2616742Z</r'evocationDate> 

<key id="eb4fc299-8808-409d-8a34-23fc83d026c9" /> 

<reason>human-readable reason</reason> 

</revocation> 


Bu durumda, yalnızca belirtilen anahtarı iptal edilir. Anahtar kimliği ise ancak olarak aşağıdaki örnekte, tüm 
anahtarlar, oluşturma tarihi, belirtilen iptal tarihten önce iptal edilir. 

<?xml version="1.0" encoding="utf-8"?> 

<revocation version="l"> 

<revocationDate>2015-03-20T15:45:45.7366491-07:00</revocationDate> 

<!-- Ali keys created before the revocation date are revoked. --> 

<key id="*" /> 

<reason>human-readable reason</reason> 

</revocation> 


<Neden > öğesi hiçbir zaman sistem tarafından okunur. Bu kullanıcı tarafından okunabilen bir iptal nedeni 
depolamak için yalnızca kullanışlı bir yerdir. 







ASPNET core'da kısa ömürlü veri koruma sağlayıcıları 
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Bir uygulama bir nasıl gereken yere senaryo vardır iDataProtectionProvider . Örneğin, geliştirici yalnızca bir tek 
seferlik bir konsol uygulamasında denemeler veya uygulama geçici (Bu komut dosyası veya bir birim test projesi). 
Bu senaryoları desteklemek için Microsoft.AspNetCore.DataProtection paketi içeren bir tür 

EphemeraiDataProtectionProvider . Bu tür temel bir uygulamasını sağlar İDataProtectionProvider , anahtar deposu 
yalnızca bellek içi tutulur ve herhangi bir yedekleme deposu için yazılan değil. 

Her bir örneği EphemeraiDataProtectionProvider kendi benzersiz ana anahtarı kullanır. Bu nedenle, bir 
iDataProtector köklü bir EphemeraiDataProtectionProvider korumalı bir yük oluşturur bu yükü yalnızca bir 
eşdeğeri tarafından korunmayan İDataProtector (aynı verilen amaçlı zinciri) aynı anda kökü 
EphemeralDataProtectionProvider Örneği. 

Aşağıdaki örnek, örnekleme gösterir, bir EphemeraiDataProtectionProvider ve korumaya ve veri korumasını 
kaldırmak için kullanma. 

using System; 

using Microsoft.AspNetCore.DataProtection; 

public class Program 

{ 

public static void Main(string[] args) 

{ 

const string purpose = "Ephemeral.App.vl"; 

// create an ephemeral provider and demonstrate that it can round-trip a payload 
var provider = new EphemeralDataProtectionProvider(); 
var protector = provider.CreateProtector(purpose); 

Console.Write("Enter input: "); 
string input = Console.ReadLine(); 

// protect the payload 

string protectedPayload = protector.Protect(input); 

Console.WriteLine($"Protect returned: {protectedPayload}"); 

// unprotect the payload 

string unprotectedPayload = protector.Unprotect(protectedPayload); 

Console.WriteLine($"Unprotect returned: {unprotectedPayload}"); 

// if I create a new ephemeral provider, it won't be able to unprotect existing 
// payloads, even if I specify the same purpose 
provider = new EphemeralDataProtectionProvider(); 
protector = provider.CreateProtector(purpose); 

unprotectedPayload = protector.Unprotect(protectedPayload); // THROIaIS 

} 

} 

/* 

* SAMPLE OUTPUT 

* 

* Enter input: Hello! 

* Protect returned: CfDJ8AAAAAAAAAAAAAAAAAAAAA...uGoxWLjGKtmlSkNACQ 

* Unprotect returned: Hello! 

* << throws CryptographicException >> 

*/ 












ASP.NET değiştirerek <machineKey > içinde ASP.NET Core 




ASPNET core'da ASPNET machineKey değiştirin 
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Uygulamasını <machineKey> ASP.NET öğesinde değiştirilebilen. Bu, ASP.NET şifreleme rutinleri için çoğu çağrıları 
yeni veri koruma sistemi dahil olmak üzere bir değiştirme veri koruma mekanizması yönlendirilmesini sağlar. 

Paket yüklemesi 


NOTE 

Yeni veri koruma sisteminde yalnızca .NET 4.5.1 targeting mevcut bir ASP.NET uygulamasına veya üzeri yüklenebilir. Yükleme 
uygulaması, .NET 4.5 hedefliyse başarısız veya azaltın. 


Yeni veri koruma sisteminde mevcut bir AS P.N ET 4.5.1 + projeye yüklemek için 1 % s'paketi 
Microsoft.AspNetCore.DataProtection.SystemVVeb yükleyin. Veri koruma sistemi kullanarak örneği oluşturulmaz 
varsayılan yapılandırmayı ayarları. 

Paket yükleme sırasında bir satıra ekler. 14 /eb.config AS P.N ET için kullanılacağını söyler en şifreleme işlemleriform 
kimlik doğrulaması, Görünüm durumu ve çağrılar dahil olmak üzere MachineKey.Protect. Eklenen satırın aşağıdaki 
gibidir. 


<machineKey compatibilityMode="Framework45" dataProtectorType="..." /> 



Paketi yapılandırması 

Veri koruma sisteminde varsayılan sıfır kurulum yapılandırma ile oluşturulur. Varsayılan olarak yerel dosya 
sistemine anahtarları kalıcı olduğundan, ancak bu bir sunucu grubunda dağıtılan uygulamalar için çalışmaz. Bu 
sorunu çözmek için alt DataProtectionStartup bir tür oluşturarak yapılandırması sağlayabilir ve onun 
CreateservicereplicalistenersO yöntemini geçersiz kılar. 

Burada anahtarları kalıcı hem de bekleme sırasında nasıl şifrelenmeden yapılandırılan özel veri koruma başlangıç 
türü örneği aşağıda verilmiştir. Ayrıca varsayılan uygulama yalıtımı ilkesi, kendi uygulama adı sağlayarak geçersiz 
kılar. 











using System; 
using System.10; 

using Microsoft.AspNetCore.DataProtection; 

using Microsoft.AspNetCore.DataProtection.SystemWeb; 

using Microsoft.Extensions.DependencyInjection; 

namespace DataProtectionDemo 

{ 

public class MyDataProtectionStartup : DataProtectionStartup 

{ 

public override void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDataProtection() 

.SetApplicationName("my-app") 

.PersistKeysToFileSystem(new DirectoryInfo(@"\\server\share\myapp-keys\")) 
.ProtectKeysl/JithCertificate("thumbprint"); 

} 

} 

} 


TIP 

Ayrıca <machineKey applicationName="my-app" ... /> SetApplicationName açık çağrı yerine. Tüm yapılandırma istedikleri 
ayarlanması, uygulama adı DataProtectionStartup türetilmiş bir tür oluşturmak için geliştirici zorlama önlemek için bir kolaylık 
mekanizması budur. 


Bu özel yapılandırmasını etkinleştirmek için VVeb.config dosyasına geri dönün ve Ara <appSettings> paket 
yükleme yapılandırma dosyasına eklenen öğe. Bunu, aşağıdaki biçimlendirme gibi görünür: 

<appSettings> 

<!-- 

If you want to customize the behavior of the ASP.NET Core Data Protection stack, set the 
"aspnetrdataProtectionStartupType" switch below to be the fully-qualified name of a 
type which subclasses Microsoft.AspNetCore.DataProtection.SystemUeb.DataProtectionStartup. 

--> 

<add key="aspnet:dataProtectionStartupType" value="" /> 

</appSettings> 


Yeni oluşturduğunuz DataProtectionStartup türetilen tür bütünleştirilmiş kodla nitelenen adı boş değeriyle 
doldurun. Uygulamanın adını DataProtectionDemo ise, bu gibi görünür aşağıda. 

<add key="aspnet:dataProtectionStartupType" 

value="DataProtectionDemo.MyDataProtectionStartup., DataProtectionDemo" /> 


Yeni yapılandırılmış veri koruma sisteminde artık uygulama içinde kullanılmaya hazırdır. 
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By Rick Anderson, Daniel Rothve Scott Ade 
Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Bu belgede, bir ASP.NET Core uygulamasının geliştirilmesi sırasında hassas verilerin depolanması 
ve alınması için teknikler açıklanmaktadır. Kaynak kodunda parolaları veya diğer hassas verileri 
hiçbir şekilde depolamayin. Üretim gizli dizileri geliştirme veya test için kullanılmamalıdır.Gizli 
dizileri uygulamayla birlikte dağıtılmamalıdır. Bunun yerine, ortamlar, ortam değişkenleri, Azure 
Key Vault vb. gibi denetimli bir yöntemle üretim ortamında kullanılabilir hale gelmelidir. Azure Key 
Vault yapılandırma sağlayıcısıylaAzure test ve üretim gizli dizilerini saklayabilir ve koruyabilirsiniz. 

Ortam değişkenleri 

Ortam değişkenleri, kodda veya yerel yapılandırma dosyalarında uygulama gizli dizileri 
depolanmasını önlemek için kullanılır. Ortam değişkenleri, daha önce belirtilen tüm yapılandırma 
kaynakları için yapılandırma değerlerini geçersiz kılar. 

startup oluşturucusunda AddEnvironmentVariables çağırarak ortam değişkeni değerlerinin 
okunmasını yapılandırın: 

public Startup(IHostingEnvironment env) 

{ 

var builder = new ConfigurationBuilder() 

.SetBasePath(env.ContentRootPath) 

.AddtsonFile("appsettings.json ", 
optional: false, 
reloadOnChange: true) 

.AddEnvironmentVariables(); 

if (env.IsDevelopment()) 

{ 

builder. AddUserSecrets<Startup>Q; 

} 

Configuration = builder.Build(); 

} 


Bireysel kullanıcı hesapları güvenliğinin etkinleştirildiği bir ASP.NET Core Web uygulaması 
düşünün. Varsayılan bir veritabanı bağlantı dizesi, projenin appSettings. JSON dosyasına anahtar 
Defaultconnection dahildir. Varsayılan bağlantı dizesi, kullanıcı modunda çalışan ve parola 
gerektirmeyen LocalDB içindir. Uygulama dağıtımı sırasında, Defaultconnection anahtar değeri bir 
ortam değişkeninin değeri ile geçersiz kılınabilir. Ortam değişkeni, tüm bağlantı dizesini hassas 
kimlik bilgileriyle saklayabilir. 









VVARNING 

Ortam değişkenleri genellikle düz, şifresiz metin olarak depolanır. Makinenin veya işlemin güvenliği 
tehlikeye atılırsa, ortam değişkenlerine güvenilmeyen taraflar tarafından erişilebilir. Kullanıcı gizliliklerinin 
açıklanmasını önlemeye yönelik ek ölçüler gerekebilir. 


Ortam değişkenlerinde hiyerarşik anahtarlarla çalışırken, bir iki nokta ayırıcı ( : ) tüm 

platformlarda çalışmayabilir (örneğin, Bash). Çift alt çizgi (_) tüm platformlar tarafından 

desteklenir ve otomatik olarak iki nokta ile değiştirilmiştir. 

Gizli dizi Yöneticisi 

Gizli verileri bir ASP.NET Core projesi geliştirme sırasında depolar. Bu bağlamda, önemli bir veri 
parçası bir uygulama gizli dizisi. Uygulama gizli dizileri, proje ağacından ayrı bir konumda 
depolanır. Uygulama gizli dizileri belirli bir projeyle ilişkilendirilir veya çeşitli projeler arasında 
paylaşılır. Uygulama gizli dizileri kaynak denetimine iade edilmedi. 


VVARNING 

Gizli dizi Yöneticisi aracı depolanan gizli dizileri şifrelemez ve güvenilir bir depo olarak değerlendirilmemelidir. 
Yalnızca geliştirme amaçlıdır. Anahtarlar ve değerler, Kullanıcı profili dizinindeki bir JSON yapılandırma 
dosyasında depolanır. 


Gizli dizi Yöneticisi aracı nasıl kullanılır? 

Gizli dizi Yöneticisi Aracı, değerlerin nerede ve nasıl depolandığı gibi uygulama ayrıntılarını 
soyutlar. Bu uygulama ayrıntılarını bilmeden aracı kullanabilirsiniz. Değerler, yerel makinedeki 
sistem korumalı bir kullanıcı profili klasöründe bir JSON yapılandırma dosyasında depolanır: 

• VVİndovvs 

• Linux/macOS 

Dosya sistemi yolu: 

%APPDATA%\Microsof l:\UserSec ret s\<user_sec ret s_id>\sec ret s.json 

Yukarıdaki dosya yollarında <user_secrets_id> ,. csproj dosyasında belirtilen userSecretsid 
değeri ile değiştirin. 

Gizli dizi yöneticisi aracıyla kaydedilen verilerin konumuna veya biçimine bağlı olarak kod yazma. 
Bu uygulama ayrıntıları değişebilir.Örneğin, gizli değerler şifrelenmez, ancak gelecekte olabilir. 

Gizli dizi Yöneticisi aracını yükler 

Gizli dizi Yöneticisi Aracı, .NET Core SDK 2.1.300 veya sonraki sürümlerde .NET Core CLI 
paketlenmiştir. 2.1.300 önceki .NET Core SDK sürümler için araç yüklemesi gereklidir. 


TIP 

Yüklü .NET Core SDK sürüm numarasını görmek için bir komut kabuğundan dotnet --version çalıştırın. 


Kullanılan .NET Core SDK araç içeriyorsa bir uyarı görüntülenir: 













The tool 'Microsoft.Extensions.SecretManager.Tools' is now included in the .NET Core SDK. 
Information on resolving this warning is available at (https://aka.ms/dotnetclitools-in-box). 


ASP.NET Core projenize Microsoft Extensions. SecretManager. Tools NuGet paketini yükle. 
Örneğin: 

<Project Sdk="Microsoft.NET.Sdk.Web"> 

<PropertyGroup> 

<TargetFramework>netcoreappl.1</TargetFramework> 

<UserSecretsId>1242d6d6-9df3-4031-b031-d9b27dl3c25a</UserSecretsId> 

</PropertyGroup> 

<ItemGroup> 

<PackageReference Include="Microsoft.AspNetCore" 

Version="1.1.6" /> 

<PackageReference Include="Microsoft.Extensions.Configuration.UserSecrets" 
Version="1.1.2" /> 

<PackageReference Include="System.Data.SqlClient" 

Version="4.5.0" /> 

</ItemGroup> 

<ItemGroup> 

<DotNetCliToolReference Include="Microsoft.Extensions.SecretManager.Tools" 
Version="1.0.1" /> 

</ItemGroup> 

</Project> 


Araç yüklemesini doğrulamak için bir komut kabuğu 'nda aşağıdaki komutu yürütün: 

dotnet user-secrets -h 


Gizli dizi Yöneticisi Aracı, örnek kullanım, Seçenekler ve komut yardımını görüntüler: 

Usage: dotnet user-secrets [options] [command] 

Options: 

-?|-h|--help 
--version 
-v|--verbose 
-p|--project <PR01ECT> 
directory. 

-c|--configuration <CONFIGURATION> 

--id 

Commands: 

clear Deletes ali the application secrets 

üst Lists ali the application secrets 

remove Removes the specified user secret 

set Sets the user secret to the specified value 

Use "dotnet user-secrets [command] --help" for more information about a command. 


NOTE 

. Csproj dosyasının DotNeteliToolReference öğelerinde tanımlanan araçları çalıştırmak için . csproj 
dosyasıyla aynı dizinde olmanız gerekir. 


Show help information 
Show version information 
Show verbose output 

Path to project. Defaults to searching the current 

The project configuration to use. Defaults to ’Debug’. 
The user secret ID to use. 


Gizli depolamayı etkinleştir 


Gizli dizi Yöneticisi Aracı, Kullanıcı profilinizde depolanan projeye özgü yapılandırma ayarları 








üzerinde çalışır. 


Gizli dizi Yöneticisi Aracı, .NET Core SDK 3.0.100 veya sonraki sürümlerde bir init komutu içerir. 
Kullanıcı gizli dizilerini kullanmak için, proje dizininde aşağıdaki komutu çalıştırın: 

dotnet user-secrets init 

Önceki komut,. csproj dosyasının PropertyGroup içinde userSecretsid öğesi ekler. Varsayılan 
olarak, userSecretsid iç metni bir GUID 'dir. iç metin rastgele, ancak proje için benzersizdir. 

Kullanıcı gizli dizilerini kullanmak için,. cspro/' dosyasının bir PropertyGroup içinde userSecretsid 
öğesi tanımlayın. userSecretsid iç metni rastgele, ancak proje için benzersizdir. Geliştiriciler 
genellikle userSecretsid için bir GUID oluşturur. 

<PropertyGroup> 

<TargetFramework>netcoreapp2.1</TargetFramework> 

<UserSecretsId>79a3edd0-2092-40a2-a04d-dcb46d5ca9ed</UserSecretsId> 

</PropertyGroup> 

<PropertyGroup> 

<TargetFramework>netcoreappl.1</TargetFramework> 

<UserSecretsId>1242d6d6-9df3-4031-b031-d9b27dl3c25a</UserSecretsId> 

</PropertyGroup> 


TIP 

Visual Studio 'da Çözüm Gezgini projeye sağ tıklayın ve bağlam menüsünden Kullanıcı gizli dizilerini 
Yönet ' i seçin. Bu hareket,. csproj DOSYASıNA bir GUID ile doldurulmuş bir UserSecretsid öğesi ekler. 


Gizli dizi ayarla 

Anahtar ve değerini içeren bir uygulama gizli anahtarı tanımlayın. Gizli dizi, projenin 
userSecretsid değeriyle ilişkilendirilir. Örneğin,. csproj dosyasının bulunduğu dizinden aşağıdaki 
komutu çalıştırın: 

dotnet user-secrets set "Movies:ServiceApiKey" "12345" 

Yukarıdaki örnekte, iki nokta üst üste Movies bir serviceApiKey özelliğine sahip bir nesne sabit 
değeri olduğunu gösterir. 

Gizli dizi Yöneticisi Aracı diğer dizinlerden de kullanılabilir.. Csproj dosyasının bulunduğu dosya 
sistemi yolunu sağlamak için --project seçeneğini kullanın. Örneğin: 

dotnet user-secrets set "Movies:ServiceApiKey" "12345" --project "C:\apps\WebAppl\src\WebAppl" 

Visual Studio 'da JSON yapısı düzleştirme 

Visual Studio 'nun Kullanıcı gizli dizilerini Yönet hareketi metin düzenleyicisinde bir gizli dizi. 
JSON dosyası açar. Gizlilikler. JSON içeriğini depolanacak anahtar-değer çiftleriyle değiştirin. 
Örneğin: 


















{ 

"Movies": { 

"ConnectionString": "Server=(localdb)\\mssqllocaldb;Database=Movie- 
l;Trusted_Connection=True;MultipleActiveResultSets=true", 

"ServiceApiKey": "12345" 

} 

} 

JSON yapısı, dotnet user-secnets remove veya dotnet user-secrets set aracılığıyla yapılan 
değişikliklerden sonra düzleştirilir. Örneğin, dotnet user-secrets remove "Movies:ConnectionString" 
çalıştırmak Movies nesnesinin değişmez değerini daraltır. Değiştirilen dosya şuna benzer: 

{ 

"Movies:ServiceApiKey": "12345" 

} 


Birden çok gizli dizi ayarla 

Bir toplu işlem, JSON tarafından set komutuna boru tarafından ayarlanabilir. Aşağıdaki örnekte, 
input. JSON dosyasının içeriği set komutuna yöneldir. 

• VVİndovvs 

• Linux/macOS 

Bir komut kabuğu açın ve şu komutu yürütün: 
type .\input.json | dotnet user-secrets set 


Gizli dizi erişimi 

ASP.N ET Core Configuration API 'si , gizli yönetici sırları için erişim sağlar. 

Projeniz .NET Framevvork hedefliyorsa Microsoft. Extensions. Configuration. Usergizlilikler NuGet 
paketini yükler. 

AS P.N ET Core 2,0 veya sonraki sürümlerde Kullanıcı gizli dizileri yapılandırma kaynağı, önceden 
yapılandırılmış varsayılanlar ile konağın yeni bir örneğini başlatmak için CreateDefaultBuilder 
çağırdığında geliştirme moduna otomatik olarak eklenir. CreateDefaultBuilder , EnvironmentName 
Developmentolduğunda AddUserSecrets çağırır: 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>(); 


public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 

CreateDefaultBuilder çağrılmıyorsa, startup oluşturucusunda AddUserSecrets çağırarak 
Kullanıcı gizli dizi yapılandırma kaynağını açıkça ekleyin. Aşağıdaki örnekte gösterildiği gibi, 













uygulama geliştirme ortamında çalıştırıldığında AdduserSecrets çağırın: 


public Startup(IHostingEnvironment env) 

{ 

var builder = new ConfigurationBuilder() 
.SetBasePath(env.ContentRootPath) 

.AddlsonFile("appsettings.json ", 
optional: false, 
reloadOnChange: true) 

.AddEnvironmentVariables(); 

if (env.IsDevelopment()) 

{ 

builder. AddllserSecrets<Startup>(); 

} 

Configuration = builder.Build(); 

} 


public Startup(IWebHostEnvironment env) 

{ 

var builder = new ConfigurationBuilder() 
.SetBasePath(env.ContentRootPath) 

.AddlsonFile("appsettings.json ", 
optional: false, 
reloadOnChange: true) 

.AddEnvironmentVariables(); 

if (env.IsDevelopment()) 

{ 

builder. AddllserSecrets<Startup>(); 

} 

Configuration = builder.Build(); 

} 


Microsoft. Extensions. Configuration. Usergizlilikler NuGet paketini yükler. 

startup oluşturucusunda AddUserSecrets çağrısıyla Kullanıcı gizli dizi yapılandırma kaynağını 
ekleyin: 

public Startup(IHostingEnvironment env) 

{ 

var builder = new ConfigurationBuilder() 

.SetBasePath(env.ContentRootPath) 

.Add]sonFile("appsettings.json ", 
optional: false 3 
reloadOnChange: true) 

.AddEnvironmentVariables(); 

if (env.IsDevelopment()) 

{ 

builder.AddUserSecrets<Startup>(); 

} 

Configuration = builder.Build(); 

} 


Kullanıcı gizli dizileri configuration API 'SI aracılığıyla alınabilir: 









public class Startup 

{ 

private string _moviesApiKey = null; 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

_moviesApiKey = Configuration["MoviesrServiceApiKey"]; 

} 

public void Configure(IApplicationBuilder app) 

{ 

app.Run(async (context) => 

{ 

var result = string.IsNullOrEmpty(_moviesApiKey) ? "Null" : "Not Null"; 
await context.Response.WriteAsync($"Secret is {result}"); 

}); 

} 


public class Startup 

{ 

private string _moviesApiKey = null; 

public Startup(IHostingEnvironment env) 

{ 

var builder = new ConfigurationBuilder() 

.SetBasePath(env.ContentRootPath) 

.AddlsonFile("appsettings.json", 
optional: false, 
reloadOnChange: true) 

.AddEnvironmentVariables(); 

if (env.IsDevelopment()) 

{ 

builder.AddUserSecrets<Startup>(); 

} 

Configuration = builder.Build(); 

} 

public IConfigurationRoot Configuration { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

_moviesApiKey = Configuration["MoviesrServiceApiKey"]; 

} 

public void Configure(IApplicationBuilder app) 

{ 

app.Run(async (context) => 

{ 

var result = string.IsNullOrEmpty(_moviesApiKey) ? "Null" : "Not Null"; 
await context.Response.WriteAsync($"Secret is {result}"); 

})J 

} 





Gizli dizileri bir POCO ile eşleme 

Bir nesne sabit değerinin tamamını bir POCO 'ya eşleme (özelliklerle basit bir .NET sınıfı) ilgili 
özellikleri toplamak için faydalıdır. 

Uygulamanın varsayar secrets.json dosyası aşağıdaki iki gizli dizileri içerir: 

{ 

"Movies": { 

"ServiceApiKey": "12345", 

"ConnectionString": "Server=(localdb)\\mssqllocaldb;Database=Movie- 
l;Trusted_Connection=True;MultipleActiveResultSets=true" 

} 

} 

Önceki gizli dizileri bir POCO 'ya eşlemek için configuration API 'sinin nesne grafiği bağlama 
özelliğini kullanın. Aşağıdaki kod, özel bir MovieSettings POCO'a bağlanır ve ServiceApiKey 
özellik değerine erişir: 

var moviesConfig = Configuration.GetSection("Movies") 

.Get<MovieSettings>(); 

_moviesApiKey = moviesConfig.ServiceApiKey; 


var moviesConfig = new MovieSettings(); 

Configuration.GetSection("Movies").Bind(moviesConfig); 

_moviesApiKey = moviesConfig.ServiceApiKey; 

Movies:ConnectionString ve Movies:ServiceApiKey gizli dizileri MovieSettings ilgili Özelliklerle 
eşlenir: 

public class MovieSettings 

{ 

public string ConnectionString { get; set; } 
public string ServiceApiKey { get; set; } 

} 


Gizli dizileri olan dize değiştirme 

Parolaların düz metin olarak depolanması güvenli değildir.Örneğin, appSettings. JSON içinde 
depolanan bir veritabanı bağlantı dizesi, belirtilen kullanıcı için bir parola içerebilir: 

{ 

"ConnectionStrings": { 

"Movies": "Server=(localdb)\\mssqllocaldb;Database=Movie-l;User 
Id=johndoe;Password=passl23;MultipleActiveResultSets=true" 

} 

} 

Daha güvenli bir yaklaşım, parolayı gizli olarak depolanmalıdır.Örneğin: 

dotnet user-secrets set "DbPassword" "passl23" 

Password anahtar-değer çiftini appSettings. TSOA/içindeki bağlantı dizesinden kaldırın. Örneğin 











{ 

"ConnectionStrings": { 

"Movies": "Server=(localdb)\\mssqllocaldb;Database=Movie-l;llser 
Id=johndoe;MultipleActiveResultSets=true" 

} 

} 


Gizli dizi değeri, bağlantı dizesinin tamamlanabilmesi için SqlConnectionStringBuilder nesnenin 
Passvvord özelliğinde ayarlanabilir: 

public class Startup 

{ 

private string _connection = null; 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

var builder = new SqlConnectionStringBuilder( 

Configuration.GetConnectionString("Movies")); 
builder.Password = Configurationf"DbPassword"]; 

_connection = builder.ConnectionString; 

} 

public void Configure(IApplicationBuilder app) 

{ 

app.Run(async (context) => 

{ 

await context.Response.WriteAsync($"DB Connection: {_connection}"); 

})J 

} 




public class Startup 

{ 

private string _connection = null; 

public Startup(IHostingEnvironment env) 

{ 

var builder = new ConfigurationBuilder() 
.SetBasePath(env.ContentRootPath) 

.AddlsonFile("appsettings.json", 
optional: false, 
reloadOnChange: true) 

.AddEnvironmentVariables(); 

if (env.IsDevelopment()) 

{ 

builder.AddUserSecrets<Startup>(); 

} 

Configuration = builder.Build(); 

} 

public IConfigurationRoot Configuration { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

var builder = new SqlConnectionStringBuilder( 

Configuration.GetConnectionString("Movies")); 
builder.Password = Configuration["DbPassword"]; 

_connection = builder.ConnectionString; 

} 

public void Configure(IApplicationBuilder app) 

{ 

app.Run(async (context) => 

{ 

await context.Response.WriteAsync($"DB Connection: {_connection}") 

}); 

} 


Gizli dizileri listeleyin 

Uygulamanın varsayar secrets.json dosyası aşağıdaki iki gizli dizileri içerir: 


"Movies": { 

"ServiceApiKey": "12345", 

"ConnectionString": "Server=(localdb)\\mssqllocaldb;Database=Movie- 
l;Trusted_Connection=True;MultipleActiveResultSets=true" 

} 

} 

. Csproj dosyasının bulunduğu dizinden aşağıdaki komutu çalıştırın: 

dotnet user-secrets üst 


Şu çıktı görünür: 







Movies:ConnectionString = Server=(localdb)\mssqllocaldb;Database=Movie- 

l;Trusted_Connection=True;MultipleActiveResultSets=true 

Movies:ServiceApiKey = 12345 


Yukarıdaki örnekte, anahtar adlarındaki bir iki nokta üst üste gizli dizi. VSOA/içindeki nesne 
hiyerarşisini gösterir. 

Tek bir parolayı kaldır 

Uygulamanın varsayar secrets.json dosyası aşağıdaki iki gizli dizileri içerir: 

{ 

"Movies": { 

"ServiceApiKey": "12345", 

"ConnectionString": "Server=(localdb)\\mssqllocaldb;Database=Movie- 
l;Trusted_Connection=True;MultipleActiveResultSets=true" 

} 

} 


. Csproj dosyasının bulunduğu dizinden aşağıdaki komutu çalıştırın: 


dotnet user-secrets remove "Movies:ConnectionString" 

Uygulamanın gizlilikler. JSON dosyası, 
çiftini kaldırmak için değiştirilmiştir: 

MoviesConnectionString 

anahtarıyla ilişkili anahtar-değer 


{ 

"Movies": { 

"ServiceApiKey": "12345" 

} 

} 


dotnet user-secrets list 

çalıştırmak aşağıdaki iletiyi görüntüler: 

Movies:ServiceApiKey = 

12345 


Tüm gizli dizileri kaldır 

Uygulamanın varsayar secrets.json dosyası aşağıdaki iki gizli dizileri içerir: 


{ 

"Movies": { 

"ServiceApiKey": "12345", 

"ConnectionString": "Server=(localdb)\\mssqllocaldb;Database=Movie- 
l;Trusted_Connection=True;MultipleActiveResultSets=true" 

} 

} 


. Csproj dosyasının bulunduğu dizinden aşağıdaki komutu çalıştırın: 

dotnet user-secrets clear 


Uygulamanın tüm Kullanıcı gizli dizileri, gizlilikler. JSON dosyasından silindi: 









{} 


dotnet user-secrets üst çalıştırmak aşağıdaki iletiyi görüntüler: 


No secrets configured for this application. 


Ek kaynaklar 

• ASP.NET Coreyapılandırma 

• AS P.N ET Core Azure Key Vault yapılandırma sağlayıcısı 





ASPNET Core Azure Key Vault yapılandırma 
sağlayıcısı 
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Luke Latham ve Andrevv Stanton-nurte 

Bu belgede, Azure Key Vault gizliliklerden uygulama yapılandırma değerlerini yüklemek için Microsoft Azure 
Key Vault yapılandırma sağlayıcısının nasıl kullanılacağı açıklanmaktadır. Azure Key Vault, uygulama ve 
hizmetler tarafından kullanılan şifreleme anahtarlarını ve gizli dizileri koruma konusunda yardımcı olan bulut 
tabanlı bir hizmettir. AS P.N ET Core uygulamalarla Azure Key Vault kullanmaya yönelik yaygın senaryolar 
şunlardır: 

• Hassas yapılandırma verilerine erişimi denetleme. 

• Yapılandırma verilerini depolarken FIPS 140-2 düzey 2 doğrulanan donanım güvenlik modülleri (HSM 
1er) gereksinimini karşılarsınız. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Paketler 

Microsoft. Extensions. Configuration. AzureKeyVault paketine bir paket başvurusu ekleyin. 

Örnek uygulama 

Örnek uygulama, program.es dosyasının en üstündeki #define ifadesiyle belirlenen iki moddan birinde 
çalışır: 

• Certificate Azure Key Vault depolanan gizli dizileri erişmek için Azure Key Vault İstemci KİMLİĞİ ve X. 
509.952 sertifikası kullanımını gösterir. Örneğin bu sürümü, Azure App Service dağıtılan herhangi bir 
konumdan veya ASP.NET Core uygulamasına hizmet veren herhangi bir konağa çalıştırılabilir. 

• Managed uygulamanın kodunda veya yapılandırmasında depolanan kimlik bilgileri olmadan Azure AD 
kimlik doğrulamasıyla Azure Key Vault için uygulamanın kimliğini doğrulamak üzere Azure kaynakları İçin 
yönetilen kimliklerin nasıl kullanılacağını gösterir. Kimlik doğrulaması için Yönetilen kimlikler 
kullanıldığında, bir Azure AD uygulama KİMLİĞİ ve parolası (gizli anahtar) gerekli değildir. Örneğin 
Managed sürümünün Azure 'a dağıtılması gerekir. Azure kaynakları İçin Yönetilen kimlikler bölümünü 
kullanma bölümündeki yönergeleri izleyin. 

Önişlemci yönergeleri ( #define ) kullanarak örnek bir uygulamayı yapılandırma hakkında daha fazla bilgi için 
bkz. ASP.NET Core'a Giriş. 

Geliştirme ortamında gizli dizi 

Gizli dizi Yöneticisi aracınıkullanarak gizli dizileri yerel olarak ayarlayın. Örnek uygulama, geliştirme 
ortamındaki yerel makinede çalıştığında, gizli anahtar Yöneticisi deposundan gizli diziler yüklenir. 

Gizli dizi Yöneticisi Aracı, uygulamanın proje dosyasında bir <userSecretsid> özelliği gerektirir. Özellik 
değerini ( {guid} ) herhangi bir benzersiz GUID 'ye ayarlayın: 






<PropertyGroup> 

<UserSecretsId>{GUID}</UserSecretsId> 

</PropertyGroup> 

Gizlilikler ad-değer çiftleri olarak oluşturulur.Hiyerarşik değerler (yapılandırma bölümleri) ASP.NET Core 
yapılandırma anahtar adlarında ayırıcı olarak : (iki nokta üst üste) kullanır. 

Gizli dizi, projenin içerik köküneaçılan bir komut kabuğundan kullanılır; burada {secret name} addır ve 
{secret value} değerdir: 

dotnet user-secrets set "{SECRET NAME}" "{SECRET VALUE}" 

Örnek uygulamanın gizli dizilerini ayarlamak için, projenin içerik kökünden bir komut kabuğu 'nda aşağıdaki 
komutları yürütün: 

dotnet user-secrets set "SecretName" "secret_value_l_dev" 
dotnet user-secrets set "Section:SecretName" "secret_value_2_dev" 

Bu gizlilikler, Azure Key Vault bölümü İle üretim ortamındaki gizli depolama alanında Azure Key Vault 
depolandığında _dev son eki _prod olarak değiştirilir. Sonek, uygulamanın çıktısında yapılandırma 
değerlerinin kaynağını gösteren bir görsel ipucu sağlar. 

Azure Key Vault ile üretim ortamında gizli dizi 

Hızlı başlangıç tarafından sunulan yönergeler : Azure CU kullanarak Azure Key Vault bir gizli dizi ayarlama ve 
alma , bir Azure Key Vault oluşturmak ve örnek uygulama tarafından kullanılan gizli dizileri depolamak için 
burada özetlenmiştir. Daha ayrıntılı bilgi için konusuna bakın. 

1. Azure Portalaşağıdaki yöntemlerden birini kullanarak Azure Cloud Shell 'i açın: 

• Bir kod bloğunun sağ üst köşesinde deneyin öğesini seçin. Metin kutusunda "Azure CLı" arama 
dizesini kullanın. 

• Cloud Shell Başlat düğmesini kullanarak tarayıcınızda Cloud Shell açın. 

• Azure portal sağ üst köşesindeki menüdeki Cloud Shell düğmesini seçin. 

Daha fazla bilgi için bkz. Azure komut satırı arabirimi (CU) ve Azure Cloud Shell Genel Bakış. 

2. Kimlik doğrulaması yapmadıysanız, az login komutuyla oturum açın. 

3. Aşağıdaki komutla bir kaynak grubu oluşturun; burada {resource group name} , yeni kaynak grubu için 
kaynak grubu adı ve {location} Azure bölgesidir (Datacenter): 


az group create --name "{RESOURCE GROUP NAME}" --location {LOCATİON} 

Aşağıdaki komutla kaynak grubunda bir Anahtar Kasası oluşturun; burada 
Anahtar Kasası ’nın adıdır ve {location} Azure bölgesidir (Datacenter): 

{KEY VAULT NAME} 

, Yeni 

az keyvault create --name "{KEY VAULT NAME}" --resource-group "{RESOURCE GROUP NAME}" 
{LOCATİON} 

location 


5. Anahtar kasasında ad-değer çiftleri olarak gizli diziler oluşturun. 

Azure Key Vault gizli dizi adları, alfasayısal karakterler ve tireler ile sınırlıdır. Hiyerarşik değerler 













(yapılandırma bölümleri) ayırıcı olarak -- (iki tire) kullanır.Genellikle ASP.NET Core 
yapılandırmasındakibir alt anahtardan bir bölümü sınırlandırmak için kullanılan iki nokta üst üste, 
Anahtar Kasası gizli adlarında izin verilmez. Bu nedenle, gizlilikler uygulamanın yapılandırmasına 
yüklendiğinde iki tire kullanılır ve iki nokta üst üste bulunur. 

Aşağıdaki gizlilikler örnek uygulamayla kullanım içindir. Değerler, geliştirme ortamında yüklenen _dev 
sonek değerlerinden Kullanıcı parolalarından ayırt etmek için bir _prod soneki içerir, {key vault name} , 
önceki adımda oluşturduğunuz anahtar kasasının adıyla değiştirin: 

az keyvault secret set --vault-name "{KEY VAULT NAME}" --name "SecretName" --value 
"secret_value_l_prod" 

az keyvault secret set --vault-name "{KEY VAULT NAME}" --name "Sectlon--SecretName" --value 
"secret_va1ue_2_prod" 


Azure 'da barındırılan uygulamalar için uygulama KİMLİĞİ ve X. 
509.440 sertifikası kullanın 

Uygulama Azure dışında barındırıldığı zamanbir anahtar kasasında kimlik doğrulaması yapmak İÇİN 
Azure AD, Azure Key Vault ve uygulamayı bir Azure ACTIVE DIRECTORY uygulama kimliği ve X. 509.440 
sertifikası kullanacak şekilde yapılandırın. Daha fazla bilgi için bkz. anahtarlar, gizlilikler ve sertifikalar 

hakkında. 


NOTE 

Azure 'da barındırılan uygulamalar için uygulama KİMLİĞİ ve X. 509.440 sertifikası kullanılması desteklenmekle birlikte, 
Azure 'da bir uygulama barındırılırken Azure kaynakları İçin Yönetilen kimlikler kullanmanızı öneririz. Yönetilen kimlikler, 
uygulamada veya geliştirme ortamında bir sertifikanın depolanmasını gerektirmez. 


Örnek uygulama, program.es dosyasının en üstündeki #define deyimin Certificate olarak ayarlandığı 
zaman BİR uygulama kimliği ve X. 509.440 sertifikası kullanır. 

1. PKCS # 12 Arşivi (. pfx) sertifikası oluşturun. Sertifika oluşturma seçenekleri Windows ve OpenSSL 
üzerinde MakeCert içerir. 

2. Sertifikayı geçerli kullanıcının kişisel sertifika deposuna yükler. Anahtarı verilebilir olarak işaretlemek isteğe 
bağlıdır. Sertifikanın daha sonra bu işlemde kullanılan parmak izini aklınızda bulunur. 

3. PKCS # 12 Arşivi (. pfx) sertifikasını der kodlu bir sertifika ( . cer) olarak dışarı aktarın. 

4. Uygulamayı Azure AD 'ye kaydedin (uygulama kayıtları). 

5. DER kodlu sertifikayı (. cer) Azure AD 'ye yükleyin: 

a. Azure AD'de uygulamayı seçin. 

b. Sertifikalar & gizlidizi sayfasına gidin. 

c. Ortak anahtarı içeren sertifikayı karşıya yüklemek için sertifikayı karşıya yükle 1 yi seçin.. Cer,. 
pekve ya . CRT sertifikası kabul edilebilir. 

6. Anahtar Kasası adı, uygulama KİMLİĞİ ve sertifika parmak izini uygulamanın appSettirıgs. JSON 
dosyasında depolayın. 

7. Azure portal ana kasaları ' ne gidin. 

8. Azure Key Vault bölümünde, üretim ortamındaki gizli dizi deposunda oluşturduğunuz anahtar kasasını 
seçin. 

9. Erişim ilkeleri' ni seçin. 

10. Erişim İlkesi Ekle' yi seçin. 

11 . Gizli izinleri açın ve uygulamaya Get ve list izinleri sağlayın. 

12. Sorumlu Seç ' i seçin ve kayıtlı uygulamayı ada göre seçin. Seç düğmesini seçin. 








13. Tamam ' ıseçin. 

14. Kaydet' i seçin. 

15. Uygulamayı dağıtın. 

Centificate örnek uygulama, ıconfigurationRoot yapılandırma değerlerini gizli adı ile aynı ada sahip bir adla 
edinir: 

• Hiyerarşik olmayan değerler: secretName değeri config["SecretName"] ile elde edilir. 

• Hiyerarşik değerler (bölümler): : (iki nokta üst üste) gösterimini veya Getsection genişletme yöntemini 
kullanın. Yapılandırma değerini elde etmek için şu yaklaşımlardan birini kullanın: 

o config["Section:SecretName"] 
o config.GetSection("Section")["SecretName"] 

X. 509.440 sertifikası işletim sistemi tarafından yönetiliyor. Uygulama, appSettlngs. JSON dosyası tarafından 
sağlanan değerlerle AddAzureKeyVault çağırır: 

// using System.Linq; 

// using System.Security.Cryptography.X509Certificates; 

// using Microsoft.Extensions.Configuration; 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureAppConfiguration((context, config) => 

{ 

if (context.HostingEnvironment.IsProduction()) 

{ 

var builtConfig = config.Build(); 

using (var store = new X509Store(StoreLocation.CurrentUser)) 

{ 

store. Öpen(OpenFlags.ReadOnly); 
var certs = store.Certificates 

.Find(X509FindType.FindByThumbprint , 

builtConfig["AzureADCertThumbprint"], faİse); 

config.AddAzureKeyVault( 

$"https://{builtConfig["KeyVaultName"]}.vault.azure.net /", 
builtConfig["AzureADApplicationld "], 
certs.OfType<X509Certificate2>().Single()); 

store.Close(); 

} 

} 

}) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 






// using System.Linq; 

// using System.Security.Cryptography.X509Certificates; 

// using Microsoft.Extensions.Configuration; 

public static II/JebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.ConfigureAppConfiguration((context, config) => 

{ 

if (context.HostingEnvironment.IsProduction()) 

{ 

var builtConfig = config.Build(); 

using (var store = new X509Store(StoreLocation.CurrentUser)) 

{ 

store.Öpen(OpenFlags.ReadOnly); 
var certs = store.Certificates 

.Find(X509FindType.FindByThumbprint, 

builtConfig["AzureADCertThumbprint"], false); 

config.AddAzureKeyVault( 

$"https://{builtConfig["KeyVaultName"]}.vault. azure.net/" , 
builtConfig["AzureADApplicationId"], 
certs.OfType<X509Certificate2>().Single()); 

store.Close(); 

} 

} 

}) 

.UseStartup<Startup>(); 

Örnek değerler: 

• Anahtar Kasası adı: contosovault 

• Uygulama KİMLİĞİ: 

• Sertifika parmak izi: 

appSettings. JSON: 

{ 

"KeyVaultName": "Key Vault Name", 

"AzureADApplicationld": "Azure AD Application ID", 

"AzureADCertThumbprint": "Azure AD Certificate Thumbprint" 

} 


{ 

"KeyVaultName": "Key Vault Name", 

"AzureADApplicationld": "Azure AD Application ID", 

"AzureADCertThumbprint": "Azure AD Certificate Thumbprint" 

} 

Uygulamayı çalıştırdığınızda, bir Web sayfası yüklenen gizli değerleri gösterir.Geliştirme ortamında, gizli 
değerler _dev sonekiyle yüklenir. Üretim ortamında, değerler _prod sonekiyleyüklenir. 

Azure kaynakları için Yönetilen kimlikler kullanma 

Azure 'a dağıtılan bir uygulama , Azure kaynakları için yönetilen kimliklerdenyararlanarak uygulamanın, 
KİMLİK bilgileri (uygulama kimliği ve parola/istemci gizli anahtarı) olmadan Azure AD kimlik doğrulaması 
kullanarak Azure Key Vault kimlik doğrulamasına olanak tanır. 
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Örnek uygulama, program.es dosyasının en üstündeki #define deyimin Managed olarak ayarlandığı 
durumlarda Azure kaynakları için Yönetilen kimlikler kullanır. 

Uygulamanın appSettings. JSON dosyasına kasa adını girin. Örnek uygulama, Managed sürümüne 
ayarlandığında uygulama KİMLİĞİ ve parolası (İstemci parolası) gerektirmez, bu nedenle bu yapılandırma 
girişlerini yoksayabilirsiniz. Uygulama Azure 'a dağıtılır ve Azure, yalnızca appSettings. JSON dosyasında 
depolanan kasa adını kullanarak Azure Key Vault erişmek için uygulamanın kimliğini doğrular. 

Azure App Service için örnek uygulamayı dağıtın. 

Azure App Service dağıtılan bir uygulama, hizmet oluşturulduğunda Azure AD 'y e otomatik olarak kaydedilir. 
Aşağıdaki komutta kullanılmak üzere dağıtımdan nesne KİMLİĞİNİ edinin. Nesne KİMLİĞİ, App Service 
kimlik panelinde Azure Portal gösterilir. 

Azure CLı ve uygulamanın nesne KİMLİĞİNİ kullanarak, anahtar kasasına erişmek için uygulamaya üst ve 
get izinleri sağlayın: 

az keyvault set-policy --name '{KEY VAULT NAME}' --object-id {0B1ECT ID} --secret-permissions get üst 


Azure CLı, PovverShell veya Azure portal kullanarak uygulamayı yeniden başlatın . 

Örnek uygulama: 

• Bir bağlantı dizesi olmadan AzureServiceTokenProvider sınıfının bir örneğini oluşturur. Bir bağlantı dizesi 
sağlanmazsa, sağlayıcı Azure kaynakları için yönetilen kimliklerden bir erişim belirteci almaya çalışır. 

• AzureServiceTokenProvider örnek belirteci geri çağırması ile yeni bir KeyVaultClient oluşturulur. 

• KeyVaultClient örneği, tüm gizli değerleri yükleyen ve çift tire ( -- ) anahtar adlarında iki nokta ( : ) ile 
değiştirir IKeyVaultSecretManager varsayılan uygulamasıyla kullanılır. 


// using Microsoft.Azure.KeyVault; 

// using Microsoft.Azure.Services.AppAuthentication; 

// using Microsoft.Extensions.Configuration.AzureKeyVault; 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureAppConfiguration((context, config) => 

{ 

if (context.HostingEnvironment.IsProduction()) 

{ 

var builtConfig = config.Build(); 

var azureServiceTokenProvider = new AzureServiceTokenProvider(); 
var keyVaultClient = new KeyVaultClient( 

new KeyVaultClient.AuthenticationCallback( 

azureServiceTokenProvider.KeyVaultTokenCallback)); 

config.AddAzureKeyVault( 

$"https://{builtConfig["KeyVaultName"]}.vault.azure.net/", 
keyVaultClient, 

new DefaultKeyVaultSecretManager()); 

} 

}) 

. ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

})J 









// using Microsoft.Azure.KeyVault; 

// using Microsoft.Azure.Services.AppAuthentication; 

// using Microsoft.Extensions.Configuration.AzureKeyVault; 

public static II/JebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.ConfigureAppConfiguration((context, config) => 

{ 

if (context.HostingEnvironment.IsProduction()) 

{ 

var builtConfig = config.Build(); 

var azureServiceTokenProvider = new AzureServiceTokenProvider(); 
var keyVaultClient = new KeyVaultClient( 

new KeyVaultClient.AuthenticationCallback( 

azureServiceTokenProvider.KeyVaultTokenCallback)); 

config.AddAzureKeyVault( 

$"https://{builtConfig["KeyVaultName"]}.vault.azure.net /", 
keyVaultClient., 

new DefaultKeyVaultSecretManager()); 

} 

}) 

.UseStartup<Startup>(); 

Anahtar Kasası adı örnek değeri: contosovault 
appSettings. JSON: 

{ 

"KeyVaultName": "Key Vault Name" 

} 


Uygulamayı çalıştırdığınızda, bir Web sayfası yüklenen gizli değerleri gösterir.Geliştirme ortamında, gizli 
değerler _dev sonekine sahiptir çünkü Kullanıcı gizli dizileri tarafından sağlanırlar.Üretim ortamında, Azure 
Key Vault tarafından sağlandıklarından, değerler _prod sonekiyle yüklenir. 

Access denied bir hata alırsanız, uygulamanın Azure AD 'y e kayıtlı olduğunu ve anahtar kasasına erişim 
sağladıklarını doğrulayın. Azure 'da hizmeti yeniden başlattığınızdan emin olun. 

Sağlayıcıyı yönetilen bir kimlik ve bir Azure DevOps işlem hattı ile kullanma hakkında bilgi için bkz. yönetilen 
hizmet KİMLİĞİYLE VM 'ye Azure Resource Manager hizmet bağlantısı oluşturma. 

Yapılandırma seçenekleri 

AddAzureKeyVault bir AzureKeyVaultConfigurationOptionskabul edebilir: 

config.AddAzureKeyVault( 

new AzureKeyVaultConfigurationOptions() 

{ 

}); 


ÖZELLİK 


AÇIKLAMA 


değerleri almak için kullanılacak KeyVaultClient. 


Client 










ÖZELLİK 


AÇIKLAMA 


Manager 


gizli dizi yüklemeyi denetlemek için kullanılan örnek 

I Key Va ultSecretManager. 


Reloadinterval anahtar kasasındaki değişiklikleri yoklamaya yönelik 

denemeler arasında beklenecek Timespan . Varsayılan 
değer null (yapılandırma yeniden yüklenmez). 

vault Anahtar Kasası URI 'SI. 


Anahtar adı öneki kullanın 

AddAzureKeyVault, Anahtar Kasası gizli dizilerini yapılandırma anahtarlarına nasıl dönüştürdüğünü 
denetlemenize olanak tanıyan I KeyVaultSecretManageruygulamasını kabul eden bir aşırı yükleme sağlar. 
Örneğin, uygulama başlangıcında sağladığınız önek değerine göre gizli değerleri yüklemek için arabirimini 
uygulayabilirsiniz. Bu, örneğin, uygulama sürümüne göre gizli dizileri yüklemeyi sağlar. 


VVARNING 

Birden çok uygulama için gizli dizileri aynı kasaya yerleştirmek veya çevresel gizli dizileri (örneğin, geliştirme ve Üretim 
gizlilikleri) aynı kasaya yerleştirmek için Anahtar Kasası gizli dizileri üzerinde ön ekleri kullanmayın. Farklı uygulama ve 
geliştirme/üretim ortamlarının, uygulama ortamlarını en yüksek düzeyde güvenlik için yalıtmak üzere ayrı anahtar 
kasaları kullanmasını öneririz. 


Aşağıdaki örnekte, anahtar kasasında (ve geliştirme ortamı için gizli Yönetici Aracı kullanılarak) bir gizli dizi 
5000-AppSecret (Anahtar Kasası gizli adlarında döneme izin verilmez). Bu gizli anahtar, uygulamanın 5.0.0.0 
sürümü için bir uygulama gizli anahtarı temsil eder. Uygulamanın başka bir sürümü olan 5.1.0.0, anahtar 
kasasına (ve gizli Yönetici Aracı kullanılarak) 5100-AppSecret için bir gizli dizi eklenir. Her uygulama sürümü 
sürümlenmiş gizli değerini AppSecret olarak yükler, bu, gizli anahtarı yüklerken sürümü de kapatıyor. 

AddAzureKeyVault özel bir IKeyVaultSecretManagerçağrılır: 

config.AddAzureKeyVault( 

$"https://{builtConfig["KeyVaultName"]}.vault.azure.net/", 
builtConfig["AzureADApplicationld "], 
certs.OfType<X509Certificate2>().Single (), 
new PrefixKeyVaultSecretManager(versionPrefix)); 

IKeyVaultSecretManager uygulama, doğru gizli anahtarı yapılandırmaya yüklemek için gizli dizi sürüm 
öneklerine yeniden davranır: 

• Load , adı önekiyle başladığında bir gizli dizi yükler. Diğer gizlilikler yüklenmez. 

• GetKey : 

o Gizli dizi adından öneki kaldırır. 

o Herhangi bir ada sahip iki tireyi yapılandırmada kullanılan sınırlayıcı olan KeyDeiimiter değiştirir 
(genellikle iki nokta üst üste). Azure Key Vault gizli dizi adlarında bir iki nokta üst üste izin vermez. 












public class PrefixKeyVaultSecretManager : IKeyVaultSecretManager 
{ 

private readonly string _prefix; 

public PrefixKeyVaultSecretManager(string prefix) 

{ 

_prefix = $"{prefix}-"; 

} 

public bool Load(SecretItem secret) 

{ 

return secret.Identifier.Name.StartsWith(_prefix); 

} 

public string GetKey(SecretBundle secret) 

{ 

return secret.SecretIdentifier.Name 
.Substring(_prefix.Length) 

.Replace("- -", ConfigurationPath.KeyDelimiter); 

} 

} 

Load yöntemi, sürüm ön ekine sahip olanları bulmak için kasa gizli dizileri aracılığıyla yinelenen bir sağlayıcı 
algoritması tarafından çağırılır. Load ile bir sürüm ön eki bulunduğunda, algoritma, gizli anahtar adının 
yapılandırma adını döndürmek için GetKey yöntemini kullanır. Gizlilik adından sürüm önekini kaldırır ve 
uygulamanın yapılandırma adı-değer çiftlerine yüklemek için gizli dizi adının geri kalanını döndürür. 

Bu yaklaşım uygulandığında: 

1. Uygulamanın proje dosyasında belirtilen sürümü. Aşağıdaki örnekte, uygulamanın sürümü s. 0 . 0.0 
olarak ayarlanmıştır: 

<PropertyGroup> 

<Version>5.0.0.0</Version> 

</PropertyGroup> 

2. Uygulamanın proje dosyasında, {guid} kullanıcının sağladığı GUID olduğu <userSecretsid> 
özelliğinin bulunduğunu doğrulayın: 

<PropertyGroup> 

<UserSecretsId>{GUID}</UserSecretsId> 

</PropertyGroup> 


Gizli dizi yöneticisi aracıylaaşağıdaki gizli dizileri yerel olarak kaydedin: 


dotnet user-secrets set "5000-AppSecret" "5.0.0.0_secret_value_dev" 
dotnet user-secrets set "5100-AppSecret" "5.1.0.0_secret_value_dev" 


3. Gizlilikler, aşağıdaki Azure CLı komutları kullanılarak Azure Key Vault kaydedilir: 

az keyvault secret set --vault-name "{KEY VAULT NAME}" --name "5000-AppSecret" --value 
"5.0.0.0_secret_value_prod" 

az keyvault secret set --vault-name "{KEY VAULT NAME}" --name "5100-AppSecret" --value 
"5.1.0.0_secret_value_prod" 

4. Uygulama çalıştırıldığında, Anahtar Kasası gizli dizileri yüklenir. 5000 -AppSecret dize gizli dizisi, 
uygulamanın proje dosyasında ( 5 . 0 . 0.0 ) belirtilen uygulamanın sürümüyle eşleştirilir. 











5. 5000 (Dash ile) sürümü, anahtar adından çıkarılır. Uygulamanın tamamında, anahtar AppSecret 
yapılandırmayı okumak gizli değeri yükler. 

6. Uygulamanın sürümü proje dosyasında 5. 1 . 0.0 olarak değiştirilirse ve uygulama yeniden 
çalıştırıldığında, döndürülen gizli değer geliştirme ortamında ve üretimde 5.ı.0.0_secret_vaiue_prod 

5.1.0.0 secret value dev . 


NOTE 

Ayrıca, AddAzureKeyVaultiçin kendi KeyVaultClient uygulamanızı da sağlayabilirsiniz. Özel istemci, uygulama genelinde 
istemcinin tek bir örneğini paylaşıma izin verir. 


Bir diziyi sınıfa bağlama 

Sağlayıcı, bir POCO dizisine bağlamak için yapılandırma değerlerini bir diziye okuyabilme özelliğine sahiptir. 

Anahtarların iki nokta ( : ) ayırıcısı içermesine izin veren bir yapılandırma kaynağından okurken, bir dizi 
oluşturan anahtarları ayırt etmek için bir sayısal anahtar kesimi kullanılır ( : 0 : , :i: ,... :{n}: ). Daha fazla 
bilgi için bkz. yapılandırma: diziyi bir sınıfa bağlama. 

Azure Key Vault anahtarlar ayırıcı olarak iki nokta üst üste kullanamaz. Bu konuda açıklanan yaklaşım, 
hiyerarşik değerler (bölümler) için bir ayırıcı olarak çift tire ( -- ) kullanır. Dizi anahtarları çift tireler ve sayısal 
anahtar kesimleri ( --0-- , -- 1 -- ,... --{n}-- ) ile Azure Key Vault depolanır. 

Bir JSON dosyası tarafından sunulan aşağıdaki Serilog günlük sağlayıcısı yapılandırmasını inceleyin. writeTo 
dizisinde, günlüğe kaydetme için hedefleri açıklayan iki Serilog evnıyansıtan iki nesne sabit değeri mevcuttur: 

"Serilog": { 

"WriteTo": [ 

{ 

"Name": "AzureTableStorage ", 

"Args": { 

"storageTableName": "logs"., 

"connectionString": "DefaultEnd..,ountKey=Eby8...GMGw==" 

} 

}, 

{ 

"Name": "AzureDocıımentDB ", 

"Args": { 

"endpointUrl": "https://contoso.documents.azure.com:443 ", 

"authorizationKey": "Eby8..,GMGw==" 

} 

} 

] 

} 

Önceki JSON dosyasında gösterilen yapılandırma Çift tire ( -- ) gösterimi ve sayısal kesimleri kullanarak 
Azure Key Vault depolanır: 

ANAHTAR DEĞER 


Serilog - -l/\lriteTo- -0- - Name AzureTableStorage 


Serilog--WriteTo--0--Args--storageTableName logs 


Serilog--WriteTo--0--Args--connectionString DefaultEnd...ountKey=Eby8...GMGw== 



















ANAHTAR 


DEĞER 


Serilog--WriteTo--1--Name AzureDocumentDB 


Serilog--WriteTo--1--Args--endpointUrl https://contoso.documents.azure.com:443 


Serilog--WriteTo--1--Args--authorizationKey Eby8...GMGw== 


Gizli dizileri yeniden yükleme 

Gizli dizileri ıconfigurationRoot.Reioad() olarak önbelleğe alınır. Anahtar kasasındaki zaman aşımına uğradı, 
devre dışı ve güncelleştirilmiş gizli dizileri, Reload yürütülene kadar uygulama tarafından dikkate alınmıyor. 

Configuration.Reload(); 


Devre dışı ve süre dolma parolaları 

Devre dışı ve son kullanma parolası bir KeyVaultErrorExceptionoluşturur. Uygulamanın üretilmesini 
engellemek için, farklı bir yapılandırma sağlayıcısı kullanarak yapılandırmayı sağlayın veya devre dışı ya da 
süre dolma parolasını güncelleştirin. 

Sorun giderme 

Uygulama, sağlayıcıyı kullanarak yapılandırmayı yükleyemediğinde, ASP.NET Core günlük altyapısı nabir hata 
iletisi yazılır. Aşağıdaki koşullar yapılandırmanın yüklenmesine engel olur: 

• Uygulama veya sertifika Azure Active Directory içinde doğru yapılandırılmamış. 

• Anahtar Kasası Azure Key Vault içinde yok. 

• Uygulamanın anahtar kasasına erişme yetkisi yok. 

• Erişim ilkesi Get ve List izinleri içermez. 

• Anahtar kasasında yapılandırma verileri (ad-değer çifti) yanlış olarak adlandırılmış, eksik, devre dışı veya 
zaman aşımına uğradı. 

• Uygulamanın Anahtar Kasası adı ( KeyvaultName ), Azure AD uygulama kimliği ( AzureADAppiicationid ) veya 
Azure AD sertifika parmak izi ( AzureADCertThumbprint ) vardır. 

• Yüklemeye çalıştığınız değer için uygulamada yapılandırma anahtarı (ad) yanlış. 

• Uygulama için erişim ilkesini anahtar kasasına eklerken, ilke oluşturulmuştur, ancakerişim ilkeleri 
Kullanıcı arabiriminde Kaydet düğmesi seçilmedi. 

Ek kaynaklar 

• ASP.NET Core yapılandırma 

• Microsoft Azure: Key Vault 

• Microsoft Azure: Key Vault belgeler 

• Azure Key Vault için HSM korumalı anahtarlar oluşturma ve aktarma 

• KeyVaultClient sınıfı 

• Hızlı başlangıç: .N ET Web uygulaması kullanarak Azure Key Vault bir gizli dizi ayarlama ve alma 

• Öğretici: .N ET 'te Azure VVİndovvs sanal makinesi ile Azure Key Vault kullanma 
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Tarafından Rick Anderson 

Bu belgede nasıl yapılacağı gösterilmektedir: 

• Tüm istekler için HTTPS gerektir. 

• Tüm HTTP isteklerini HTTPS 'ye yeniden yönlendirin. 

Hiçbir API, istemcinin ilk istekte hassas veri göndermesini engelleyebilir. 


VVARNING 

API projeleri 

Hassas bilgileri alan Web API ’Lerinde RequireHttpsAttribute kullanmayın. RequireHttpsAttribute , tarayıcıların 
HTTP ’den HTTPS 'ye yönlendirilmesini sağlamak için HTTP durum kodlarını kullanır. API istemcileri HTTP 'den HTTPS 
'ye yeniden yönlendirmeyi anlamayabilir veya buna uymayabilir. Bu tür istemciler, HTTP üzerinden bilgi gönderebilir. 
Web API ’Leri şunlardan biri olmalıdır: 

• HTTP üzerinde dinleme yok. 

• Durum kodu 400 olan bağlantıyı kapatın (Hatalı İstek) ve isteğe bağlı değildir. 

HSTS ve API projeleri 

Varsayılan API projeleri, genellikle yalnızca bir tarayıcı yönergesi olduğu için HSTS içermez. Telefon veya masaüstü 
uygulamaları gibi diğer çağıranlar, yönergeye uymayın. Tarayıcılar içinde bile, HTTP üzerinden bir API 'ye yapılan tek 
bir kimlik doğrulamalı çağrı, güvenli olmayan ağlarda risk içerir Güvenli yaklaşım, API projelerini yalnızca HTTPS 
dinlemesi ve HTTPS üzerinden yanıt verecek şekilde yapılandırmaktır. 


VVARNING 

API projeleri 

Hassas bilgileri alan Web API ’Lerinde RequireHttpsAttribute kullanmayın. RequireHttpsAttribute , tarayıcıların 
HTTP 'den HTTPS 'ye yönlendirilmesini sağlamak için HTTP durum kodlarını kullanır. API istemcileri HTTP 'den HTTPS 
'ye yeniden yönlendirmeyi anlamayabilir veya buna uymayabilir. Bu tür istemciler, HTTP üzerinden bilgi gönderebilir. 
Web API ’Leri şunlardan biri olmalıdır: 

• HTTP üzerinde dinleme yok. 

• Durum kodu 400 olan bağlantıyı kapatın (Hatalı İstek) ve isteğe bağlı değildir. 


HTTPS gerektir 

Üretim ASP.NET Core Web uygulamalarının kullanmasını öneririz: 

• HTTP isteklerini HTTPS 'ye yeniden yönlendirmek için HTTPS yeniden yönlendirme ara yazılımı 

(UseHttpsRedirection). 

• istemcilere HTTP katı aktarım güvenliği Protokolü (HSTS) üst bilgileri göndermek için HSTS ara yazılımı 

(Usehsts). 








NOTE 

Ters Proxy yapılandırmasında dağıtılan uygulamalar, proxy 'nin bağlantı güvenliğini (HTTPS) işlemesini sağlar. Ara 
sunucu HTTPS yeniden yönlendirmeyi de işleiyorsa, HTTPS yeniden yönlendirme ara yazılımı kullanmanız gerekmez. 
Proxy sunucusu Ayrıca, HSTS üst bilgilerini (örneğin, ııs 10,0 (1709) veya sonraki sürümlerde yerel HSTS desteği) 
yazmayı de işişişişsa, uygulama İçin HSTS ara yazılımı gerekli değildir. Daha fazla bilgi için bkz. Proje oluşturma 
SıRASıNDA https/HSTS 'nin geri çevirme. 


UseHttpsRedirection 

Aşağıdaki kod startup sınıfında UseHttpsRedirection çağırır: 

public void Configure(IApplicationBuilder app, IUebHostEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

// The default HSTS value is 30 days. You may want to change this for production scenarios, see 
https://aka.ms/aspnetcore-hsts. 
app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 

app.UseRouting(); 

app.UseAuthorization(); 

app.UseEndpointsfendpoints => 

{ 

endpoints.MapRazorPages(); 

}); 


public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 
app.UseCookiePolicy(); 

app.UseMvc(); 

} 


Vurgulanan önceki kod: 

• Varsayılan Httpsredirectionoptions. RedirectStatusCode (Status307TemporaryRedirect) kullanır. 

• aspnetcore_https_port ortam değişkeni veya ıveraddressesözelliğitarafından geçersiz kılınmadıkça 







varsayılan Httpsredirectionoptions. HttpsPort (null) kullanır. 

Kalıcı yeniden yönlendirmeler yerine geçici yeniden yönlendirmeler kullanmanızı öneririz. Bağlantıyı 
önbelleğe alma, geliştirme ortamlarında kararsız davranışa neden olabilir. Uygulama geliştirme dışı bir 
ortamda olduğunda kalıcı yeniden yönlendirme durum kodu göndermek isterseniz, üretim içindeki kalıcı 
yeniden yönlendirmeleri yapılandırma bölümüne bakın, istemcilere yalnızca güvenli kaynak isteği 
gönderilmesi gerektiğini bildirmek için HSTS kullanılması önerilir (yalnızca üretimde). 

Bağlantı noktası yapılandırması 

Ara yazılımın güvenli olmayan bir isteği HTTPS 'ye yönlendirmesi için bir bağlantı noktası kullanılabilir 
olmalıdır. Kullanılabilir bağlantı noktası yoksa: 

• HTTPS olarak yeniden yönlendirme gerçekleşmez. 

• Ara yazılım "yeniden yönlendirme için HTTPS bağlantı noktası saptanamadı" uyarısını günlüğe kaydeder. 
Aşağıdaki yaklaşımlardan herhangi birini kullanarak HTTPS bağlantı noktasını belirtin: 

• Httpsredirectionoptions. HttpsPortöğesini ayarlayın. 

• https_port ana bilgisayar ayarınıayarlayın: 
o Konak yapılandırmasında. 

o aspnetcore_https_port ortam değişkenini ayarlayarak, 
o AppSettings. USOA/içine bir üst düzey girişi ekleyerek: 

{ 

"https_port": 443, 

"Logging": { 

"LogLevel": { 

"Default": "Information", 

"Microsoft": "Warning", 

"Microsoft.Hosting.Lifetime": "Information" 

} 

"AllowedHosts": 

} 

• ASPNETCORE_URLS ortam değişkeninikullanarak güvenli düzene sahip bir bağlantı noktası belirtin. 
Ortam değişkeni sunucusunu yapılandırır.Ara yazılım, IServerAddressesFeaturearacılığıyla HTTPS 
bağlantı noktasını dolaylı olarak bulur. Bu yaklaşım, ters proxy dağıtımlarında çalışmaz. 

• https_port ana bilgisayar ayarınıayarlayın: 
o Konak yapılandırmasında. 

o aspnetcore_https_port ortam değişkenini ayarlayarak, 
o AppSettings. ÜSOA/içine bir üst düzey girişi ekleyerek: 

{ 

"https_port": 443, 

"Logging": { 

"LogLevel": { 

"Default": "Warning" 

} 

}, 

"AllowedHosts": "*" 

} 








• ASPNETCORE_URLS ortam değişkeninikullanarak güvenli düzene sahip bir bağlantı noktası belirtin. 
Ortam değişkeni sunucusunu yapılandırır.Ara yazılım, IServerAddressesFeaturearacılığıyla HTTPS 
bağlantı noktasını dolaylı olarak bulur. Bu yaklaşım, ters proxy dağıtımlarında çalışmaz. 

• Geliştirme aşamasında, laurıchsettings. _/SO/Vdosyasında bir https URL 'si ayarlayın. 11S Express 
kullanıldığında HTTPS 'yi etkinleştirin. 

• Kestrel Server veya http. sys sunucusu için genel kullanıma yönelik BİR uç dağıtımı için https URL uç 
noktası yapılandırın. Uygulama tarafından yalnızca BİR HTTPS bağlantı noktası kullanılır. Ara 
yazılım, IServerAddressesFeaturearacılığıyla bağlantı noktasını bulur. 


NOTE 

Bir uygulama ters proxy yapılandırmasında çalıştırıldığında IServerAddressesFeature kullanılamaz. Bu bölümde 
açıklanan diğer yaklaşımlardan birini kullanarak bağlantı noktasını ayarlayın. 


Edge dağıtımları 

Kestrel veya HTTP, sys, herkese açık bir uç sunucu olarak kullanıldığında, Kestrel veya HTTP, sys ' nin her 
ikisini de dinlemek üzere yapılandırılması gerekir: 

• İstemcinin yeniden yönlendirildiği güvenli bağlantı noktası (genellikle üretim ortamında 443 ve 
geliştirme sırasında 5001). 

• Güvenli olmayan bağlantı noktası (genellikle üretim ortamında 80 ve geliştirme sırasında 5000). 

Güvenli olmayan bir istek alabilmesi ve istemciyi güvenli bağlantı noktasına yeniden yönlendirebilmesi için 
güvensiz bağlantı noktasına istemci tarafından erişilebilir olması gerekir. 

Daha fazla bilgi için bkz. Kestrel Endpoint Configuration veya ASP.NET Core 'de HTTP, sys Web sunucusu 
uygulama. 

Dağıtım senaryoları 

istemci ve sunucu arasındaki herhangi bir güvenlik duvarının trafik için iletişim bağlantı noktaları açık olması 
gerekir. 

istekler ters bir ara sunucu yapılandırmasında iletilirse, HTTPS yeniden yönlendirme ara yazılımı 
çağrılmadan önce İletilen üstbilgiler ara yazılımını kullanın, iletilen üstbilgiler ara yazılımı, 
x-Forwarded-Proto üst bilgisini kullanarak Request.scheme güncelleştirir. Ara yazılım, yeniden yönlendirme 
URI 'Leri ve diğer güvenlik ilkelerinin doğru çalışmasına izin verir. İletilen üstbilgiler ara yazılımı 
kullanılmazsa, arka uç uygulaması doğru düzeni alamayabilir ve yeniden yönlendirme döngüsünde sona 
ermeyebilir. Yaygın bir son kullanıcı hata iletisi, çok fazla yeniden yönlendirme meydana geldi. 

Azure App Service dağıtım sırasında, öğreticideki yönergeleri izleyin: mevcut bir özel SSL sertifikasını Azure 
'A bağlama Web Apps. 

Seçenekler 

Aşağıdaki vurgulanan kod, ara yazılım seçeneklerini yapılandırmak için Addhttpsredirection öğesini çağırır: 




public void ConfigureServicesCIServiceCollection Services) 

{ 

Services.AddRazorPages(); 

Services. AddHsts(options => 

{ 

options.Preload = true; 

options.IncludeSubDomains = true; 

options.MaxAge = TimeSpan.FromDays(60); 

options.ExcludedHosts.Add("example.com"); 

options.ExcludedHosts.Add("www.example.com"); 

}); 

Services.AddHttpsRedirection(options => 

{ 

options.RedirectStatusCode = StatusCodes.Status307TemporaryRedirect; 
options.HttpsPort = 5001; 

}); 

} 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services. AddMvc(); 

Services. AddHsts(options => 

{ 

options.Preload = true; 

options.IncludeSubDomains = true; 

options.MaxAge = TimeSpan.FromDays(60); 

options.ExcludedHosts.Add("example.com"); 

options. ExcludedHost s. Add ("www.example.com"); 

}); 

Services.AddHttpsRedirection(options => 

{ 

options.RedirectStatusCode = StatusCodes.Status307TemporaryRedirect; 
options.HttpsPort = 5001; 

}); 

} 

AddHttpsRedirection çağırmak için yalnızca HttpsPort veya RedirectStatusCode değerlerinin değiştirilmesi 
gerekir. 

Vurgulanan önceki kod: 

• Httpsredirectionoptions. RedirectStatusCode değerini, varsayılan değer olan 
Status307TemporaryRedirectbelirler. RedirectStatusCode atamaları için StatusCodes sınıfının alanlarını 
kullanın. 

• HTTPS bağlantı noktasını 5001 olarak ayarlar. 

Üretimde kalıcı yeniden yönlendirmeleri yapılandırma 

Ara yazılım varsayılan olarak tüm yeniden yönlendirmelere bir Status307TemporaryRedirect gönderir. 
Uygulama geliştirme dışı bir ortamda olduğunda kalıcı yeniden yönlendirme durum kodu göndermek 
isterseniz, geliştirme dışı bir ortam için bir koşullu denetim içindeki ara yazılım seçenekleri yapılandırmasını 
sarın. 


Startup.cs'de Hizmetleri yapılandırırken: 




public void ConfigureServices(IServiceCollection Services) 

{ 

// IİAİebHostEnvironment (stored in _env) is injected into the Startup class. 
if (!_env.IsDevelopment()) 

{ 

Services.AddHttpsRedirection(options => 

{ 

options.RedirectStatusCode = StatusCodes.Status308PermanentRedirect; 
options.HttpsPort = 443; 

}); 

} 


Startup.cs'de Hizmetleri yapılandırırken: 

public void ConfigureServices(IServiceCollection Services) 

{ 

// IHostingEnvironment (stored in _env) is injected into the Startup class. 
if (!_env.IsDevelopment()) 

{ 

Services.AddHttpsRedirection(options => 

{ 

options.RedirectStatusCode = StatusCodes.Status308PermanentRedirect; 
options.HttpsPort = 443; 

}); 

} 


HTTPS yeniden yönlendirme ara yazılımı alternatif yaklaşımı 

HTTPS yeniden yönlendirme ara yazılımı ( useHttpsRedirection ) kullanmanın bir alternatifi URL yeniden 
yazma ara yazılımı ( AddRedirectToHttps ) kullanmaktır. AddRedirectToHttps , yeniden yönlendirme 
yürütüldüğünde durum kodunu ve bağlantı noktasını da ayarlayabilir. Daha fazla bilgi için bkz. URL yeniden 
yazma ara yazılımı. 

Ek yeniden yönlendirme kuralları gereksinimi olmadan HTTPS 'ye yönlendirilirken, bu konuda açıklanan 
HTTPS yeniden yönlendirme ara yazılımı ( UseHttpsRedirection ) kullanmanızı öneririz. 

HTTP katı aktarım güvenliği Protokolü (HSTS) 

Her OVVASPiçin, http katı aktarım güvenliği (HSTS) , yanıt üst bilgisi kullanılarak bir Web uygulaması 
tarafından belirtilen bir katılım güvenlik geliştirmedir. HSTS 'yi destekleyen bir tarayıcı bu üstbilgiyi alırsa: 

• Tarayıcı, HTTP üzerinden iletişimin gönderilmesini önleyen etki alanı için yapılandırmayı depolar.Tarayıcı, 
HTTPS üzerinden tüm iletişimi zorlar. 

• Tarayıcı, kullanıcının güvenilmeyen veya geçersiz sertifikalar kullanmasını engeller. Tarayıcı, kullanıcının 
bu sertifikaya geçici olarak güvenmesine izin veren istemleri devre dışı bırakır. 

HSTS istemci tarafından zorlandığından bazı sınırlamalar vardır: 

• istemcinin HSTS 'yi desteklemesi gerekir. 

• HSTS, HSTS ilkesini oluşturmak için en az bir başarılı HTTPS isteği gerektirir. 

• Uygulamanın her HTTP isteğini denetlemesi ve HTTP isteğini yeniden yönlendirmesi veya reddetmesi 
gerekir. 

ASP.NET Core 2,1 ve üzeri useHsts genişletme yöntemiyle HSTS uygular. Aşağıdaki kod, uygulama 
geliştirme modundaolmadığında useHsts çağırır: 









public void Configure(IApplicationBuilder app, IklebHostEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Erron"); 

// The default HSTS value is 30 days. You may want to change this for production scenanios, see 
https://aka.ms/aspnetcore-hsts. 
app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 

app.UseRouting(); 

app.UseAuthorization(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapRazorPages(); 

}); 

} 


public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 
app.UseCookiePolicy(); 

app.UseMvc(); 

} 

useHsts geliştirmede önerilmez çünkü HSTS ayarları tarayıcılar tarafından yüksek oranda önbelleğe 
alınabilir. Varsayılan olarak, useHsts yerel geri döngü adresini dışlar. 

ilk kez HTTPS 'yi uygulayan üretim ortamları için, TimeSpan yöntemlerinden birini kullanarak ilk 
HstsOptions. maxAge değerini küçük bir değere ayarlayın. HTTPS altyapısını HTTP 'ye döndürmeniz 
gerekirse, değeri saat olarak bir tek güne kadar ayarlayın. HTTPS yapılandırmasının sürdürülebilirliği 
konusunda emin olduktan sonra, HSTS maksimum yaş değerini artırın; yaygın olarak kullanılan bir değer bir 
yıldır. 


Aşağıdaki kod: 



public void ConfigureServicestlServiceCollection Services) 

{ 

Services.AddRazorPages(); 

Services. AddHsts(options => 

{ 

options.Preload = true; 

options.IncludeSubDomains = true; 

options.MaxAge = TimeSpan.FromDays(60); 

options.ExcludedHosts.Add("example.com"); 

options.ExcludedHosts.Add("www.example.com"); 

}); 

Services.AddHttpsRedirection(options => 

{ 

options.RedirectStatusCode = StatusCodes.Status307TemporaryRedirect; 
options.HttpsPort = 5001; 

}); 

} 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddMvc(); 

Services.AddHsts(options => 

{ 

options.Preload = true; 

options.IncludeSubDomains = true; 

options.MaxAge = TimeSpan.FromDays(60); 

options.ExcludedHosts.Add("example.com"); 

options. ExcludedHost s. Add ("www.example.com"); 

}); 

Services.AddHttpsRedirection(options => 

{ 

options.RedirectStatusCode = StatusCodes.Status307TemporaryRedirect; 
options.HttpsPort = 5001; 

}); 

} 

• Strict-Transport-Security üstbilgisinin preload parametresini ayarlar.Önyükleme, RFC HSTS 
belirtimininbir parçası değildir, ancak Web tarayıcıları tarafından Yeni yüklemede HSTS sitelerini önceden 
yüklemek için desteklenir. Daha fazla bilgi için bkz. https://hstspreload.org/ 

• SSTS ilkesini konak alt etki alanlarını barındıracak şekilde uygulayan ıncludealt etki alanınısağlar. 

• Strict-Transport-Security üstbilgisinin Max-Age parametresini açıkça 60 gün olarak ayarlar. 
Ayarlanmazsa, varsayılan olarak 30 gün olur. Daha fazla bilgi için bkz. Maksimum yaş yönergesi . 

• Dışlanacak konaklar listesine exampie.com ekler. 

useHsts aşağıdaki geri döngü Konakları dışlar: 


• 

localhost 

: IPv4 geri döngü adresi 

• 

127.0. 

0.1 

: IPv4 geri döngü adresi 

• 

["1] 

: IPv6 geri döngü adresi. 


Proje oluşturulurken HTTPS/HSTS ’nin katılımı 

Bağlantı güvenliğinin ağın herkese açık kenarından işlendiği bazı arka uç hizmet senaryolarında, her 
düğümde bağlantı güvenliğini yapılandırmak gerekli değildir. Visual Studio 'da veya DotNet yeni 
komutundan oluşturulan Web Apps, https yeniden yönlendirmeyi ve HSTS'yi etkinleştirir. Bu senaryoları 





gerektirmeyen dağıtımlar için, uygulama şablondan oluşturulduğunda HTTPS/HSTS 'nin devre dışı 
bırakabilirsiniz. 

HTTPS/HSTS 'yi devre dışı bırakmak için: 

• Visual Studio 

• .NETCoreCLI 

Https İçin Yapılandır onay kutusunun işaretini kaldırın. 


X 


Create a new ASP.NET Core web application 


.NET Core 


ASP.NET Core 3.0 


Empty 

An empty project template for creating an ASP.NET Core application. This template does not have any 
content in it. 



A project template for creating an ASP.NET Core application with an example Controllerfor a RESTful HTTP 
service. This template can also be used for ASP.NET Core MVC Views and Controllers. 


Web Application 

A project template for creating an ASP.NET Core application with example ASP.NET Core Razor Pages 
content. 


Web Application (Model-Vievv-Controller) 


A project template for creating an ASP.NET Core application with example ASP.NET Core MVC Vievvs and 
Controllers. This template can also be used for RESTful HTTP Services. 
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Angular 

A project template for creating an ASP.NET Core application with Angular. 


React.js 
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A project template for creating an ASP.NET Core 
application with example ASP.NET Core Razor Pages 
content. 
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VVindovvs ve macOS 'ta ASP.NET Core HTTPS geliştirme 
sertifikasına güvenin 

.N ET Core SDK bir HTTPS geliştirme sertifikası içerir. Sertifika, ilk çalıştırma deneyiminin bir parçası olarak 
yüklenir. Örneğin, dotnet --info aşağıdakine benzer bir çıktı üretir: 

ASP.NET Core 

Successfully installed the ASP.NET Core HTTPS Development Certificate. 

To trust the certificate run 'dotnet dev-certs https --trust' (Windows and macOS only). 

For establishing trust on other platforms refer to the platform specific documentation. 

For more information on configuring HTTPS see https://go.microsoft.com/fwlink/?linkid=848054. 


.NET Core SDK yükleme ASP.NET Core HTTPS geliştirme sertifikasını Yerel Kullanıcı sertifika deposuna 
yüklenir. Sertifika yüklendi, ancak güvenilir değil. Sertifikaya güvenmek için, DotNet dev-certs aracını 
çalıştırmak için tek seferlik bir adım gerçekleştirin: 


dotnet dev-certs https -- 

trust 

Aşağıdaki komut 

dev-certs 

aracında yardım sağlar: 

dotnet dev-certs https -- 

help 


Docker için Geliştirici Sertifikası ayarlama 

Bu GitHub sorununabakın. 


Linux için VVindovvs alt sistemi 'nden HTTPS sertifikasına güven 

Linux için VVindovvs alt sistemi (WSL), HTTPS otomatik olarak imzalanan bir sertifika oluşturur. VVindovvs 
sertifika deposunu, WSL sertifikasına güvenmek üzere yapılandırmak için: 

• WSL tarafından oluşturulan sertifikayı dışarı aktarmak için şu komutu çalıştırın: 

dotnet dev-certs https -ep %USERPROFILE%\.aspnet\https\aspnetapp.pfx -p <cryptic-password> 


• Bir WSL penceresinde, şu komutu çalıştırın: 

ASPNETCORE_Kestrel_Certificates_Default_Password="<cryptic-password>" 

ASPNETCORE_Kestrel_Certificates_Default_Path=/mnt/c/Users/user-name/.aspnet/https/aspnetapp.pfx 

dotnet watch run 


Yukarıdaki komut, ortam değişkenlerini, Linux 'un VVindovvs güvenilen sertifikasını kullanmasını 
sağlayacak şekilde ayarlar. 


Sertifika sorunlarını giderme 

Bu bölümde, AS P.N ET Core HTTPS geliştirme sertifikası yüklendiğinde ve güveniliyorsa, ancak hala 
sertifikaya güvenilmediğini belirten tarayıcı uyarıları varsa yardım sağlanmaktadır. ASP.NET Core HTTPS 
geliştirme sertifikası, Kestreltarafından kullanılır. 


Tüm platformlar-Sertifikaya güvenilmiyor 

Aşağıdaki komutları çalıştırın: 











dotnet dev-certs https --clean 
dotnet dev-cents https --trust 

Açık olan tüm tarayıcı örneklerini kapatın. Uygulamaya yeni bir tarayıcı penceresi açın. Sertifika güveni 
tarayıcılar tarafından önbelleğe alınır. 

Yukarıdaki komutlar çoğu tarayıcı güveni sorununu çözüyor.Tarayıcı yine de sertifikaya güvenmiyor ise, 
aşağıdaki platforma özgü önerileri izleyin. 

Docker-Sertifikaya güvenilmiyor 

• C:\Users{User} \AppData\Roamlng\ASP.NET\Https klasörünü silin. 

• Çözümü temizleyin. Silme bin ve obj klasörleri. 

• Geliştirme aracını yeniden başlatın. Örneğin, Visual Studio, Visual Studio Code veya Mac için Visual 
Studio. 

Windows-Sertifikaya güvenilmiyor 

• Sertifika deposundaki sertifikaları kontrol edin, asp.net core https development certificate kolay ada 
sahip localhost bir sertifika olması gerekir Current User > Personal > Certificates ve 

Current User > Trusted root certification authorities > Certificates 

• Yalnızca kişisel ve güvenilen kök sertifika yetkililerinden bulunan tüm sertifikaları kaldırın. 11S Express 
localhost sertifikasını kaldırmayın. 

• Aşağıdaki komutları çalıştırın: 

dotnet dev-certs https --clean 
dotnet dev-certs https --trust 

Açık olan tüm tarayıcı örneklerini kapatın. Uygulamaya yeni bir tarayıcı penceresi açın. 

OS X-Sertifikaya güvenilmiyor 

• Anahtarlık erişimini açın. 

• Sistem anahtarlığı' nı seçin. 

• Localhost sertifikası olup olmadığını denetleyin. 

• Tüm kullanıcılar için güvenilir olduğunu göstermek için simgenin üzerinde bir + simgesi içerip 
içermediğinden emin olun. 

• Sertifikayı sistem anahtarlığınızdan kaldırın. 

• Aşağıdaki komutları çalıştırın: 

dotnet dev-certs https --clean 
dotnet dev-certs https --trust 

Açık olan tüm tarayıcı örneklerini kapatın. Uygulamaya yeni bir tarayıcı penceresi açın. 

Visual Studio 'da sertifika sorunlarını gidermek için IIS Express (ASPNET/AspNetCore#16892) kullanarak 
https hatası bölümüne bakın. 

Visual Studio ile kullanılan SSL sertifikası IIS Express 

IIS Express sertifikayla ilgili sorunları gidermek için Visual Studio yükleyicisinden Onar 1 ı seçin. 

Ek bilgiler 

• Proxy sunucularıyla ve yük dengeleyicilerle çalışacak ASP.N ET Core yapılandırma 
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Tarafından RickAnderson 

AS P.N ET Core Varsayılan olarak httpskullanır. Https , güven, kimlik ve şifreleme için sertifikalara bağımlıdır. 

Bu belgede önceden oluşturulmuş kapsayıcı görüntülerinin HTTPS ile nasıl çalıştırılacağı açıklanmaktadır. 
Geliştirme senaryoları için bkz. https üzerinden Docker ile AS P.N ET Core uygulamaları geliştirme . 

Bu örnek, Docker İstemcisinin Docker 17,06 veya sonraki bir sürümünü gerektirir. 

Önkoşullar 

Bu belgedeki bazı yönergeler için .NET Core 2,2 SDK veya üzeri gereklidir. 

Sertifikalar 

Bir etki alanı için Üretim barındırma için bir sertifika yetkilisinden bir sertifika gereklidir. Şifrelemem , ücretsiz 
sertifikalar sunan bir sertifika yetkilisindir. 

Bu belge, üzerine localhost önceden oluşturulmuş görüntüleri barındırmak için otomatik olarak imzalanan 
geliştirme sertifikaları kullanır. Yönergeler, üretim sertifikalarını kullanmaya benzerdir. 

Üretim sertifikaları için: 

• dotnet dev-cents Araç gerekli değildir. 

• Sertifikaların, yönergelerde kullanılan konumda depolanması gerekmez. Herhangi bir konumun çalışması 
gerekir, ancak bu sertifikalar site dizininizde depolanarak önerilmez. 

Yönergeler birimi, sertifikaları kapsayıcılara bağlama. Dockerfile içindeki bir copy komutla kapsayıcı görüntülerine 
sertifika ekleyebilirsiniz. Sertifikaların bir görüntüye kopyalanması önerilmez: 

• Geliştirici sertifikalan ile test etmek için aynı görüntünün kullanımını zorlaştırır. 

• Üretim sertifikaları ile barındırmak için aynı görüntünün kullanımını zorlaştırır. 

• Sertifika açıklanmasının önemli bir riski vardır. 

HTTPS ile önceden oluşturulmuş kapsayıcı görüntülerini çalıştırma 

işletim sistemi yapılandırmanız için aşağıdaki yönergeleri kullanın. 

Linux kapsayıcıları kullanan Windows 

Sertifika Oluştur ve yerel makineyi Yapılandır: 

dotnet dev-certs https -ep %USERPROFILE%\.aspnet\https\aspnetapp.pfx -p { password here } 
dotnet dev-cents https --trust 

Yukarıdaki komutlarda, öğesini parolayla değiştirin { password here } . 

Kapsayıcı görüntüsünü HTTPS için yapılandırılan ASP.NET Core çalıştırın: 










docker pull mcr.microsoft.com/dotnet/core/samples:aspnetapp 

docker run --rm -it -p 8000:80 -p 8001:443 -e ASPNETCORE_URLS="https://+;http://+" -e 

ASPNETCORE_HTTPS_PORT=8001 -e ASPNETCORE_Kestrel_Certificates_Default_Password="password" -e 

ASPNETCORE_Kestrel_Certificates_Default_Path=/https/aspnetapp.pfx -v %USERPROFILE%\.aspnet\https:/https/ 

mcr.microsoft.com/dotnet/core/samples:aspnetapp 


Parolanın, sertifika için kullanılan parolayla eşleşmesi gerekir. 

macOS veya Linux 

Sertifika Oluştur ve yerel makineyi Yapılandır: 

dotnet dev-certs https -ep ${HOME}/.aspnet/https/aspnetapp.pfx -p { password here } 
dotnet dev-certs https --trust 

dotnet dev-certs https --trust yalnızca macOS ve Windows 'da desteklenir.Linux 'ta sertifikalarınızın desteklediği 
şekilde sertifika almanız gerekir. Büyük olasılıkla, tarayıcınızda sertifikaya güvenmeniz gerekir. 

Yukarıdaki komutlarda, öğesini parolayla değiştirin { password here } . 

Kapsayıcı görüntüsünü HTTPS için yapılandırılan ASP.NET Core çalıştırın: 

docker pull mcr.microsoft.com/dotnet/core/samples:aspnetapp 

docker run --rm -it -p 8000:80 -p 8001:443 -e ASPNETCORE_URLS="https://+;http://+" -e 

ASPNETCORE_HTTPS_PORT=8001 -e ASPNETCORE_Kestrel_Certificates_Default_Password="password" -e 

ASPNETCORE_Kestrel_Certificates_Default_Path=/https/aspnetapp.pfx -v ${HOME}/.aspnet/https:/https/ 

mcr.microsoft.com/dotnet/core/samples:aspnetapp 


Parolanın, sertifika için kullanılan parolayla eşleşmesi gerekir. 

Windows kapsayıcıları kullanan pencereler 

Sertifika Oluştur ve yerel makineyi Yapılandır: 

dotnet dev-certs https -ep %USERPROFILE%\.aspnet\https\aspnetapp.pfx -p { password here } 
dotnet dev-certs https --trust 

Yukarıdaki komutlarda, öğesini parolayla değiştirin { password here } . 

Kapsayıcı görüntüsünü HTTPS için yapılandırılan ASP.NET Core çalıştırın: 

docker pull mcr.microsoft.com/dotnet/core/samples:aspnetapp 

docker run --rm -it -p 8000:80 -p 8001:443 -e ASPNETCORE_URLS="https://+;http://+" -e 

ASPNETCORE_HTTPS_PORT=8001 -e ASPNETCORE_Kestrel_Certificates_Default_Password="password" -e 

ASPNETCORE_Kestrel_Certificates_Default_Path=\https\aspnetapp.pfx -v %USERPROFILE%\.aspnet\https:C:\https\ 

mcr.microsoft.com/dotnet/core/samples:aspnetapp 


Parolanın, sertifika için kullanılan parolayla eşleşmesi gerekir. 










ASRNET Core içinde AB Genel Veri Koruma 
Yönetmeliği (GDPR) desteği 

18.08.2019 • 10 minutes to read^ Edit Online 


Tarafından RickAnderson 

ASP.NET Core, bazı ab genel veri koruma yönetmeliği (GDPR) gereksinimlerini karşılamaya yardımcı 
olmak İçin API 'ler ve şablonlar sağlar: 

• Proje şablonları, gizlilik ve tanımlama bilgisi kullanım ilkenize göre değiştireceğiniz uzantı 
noktalarını ve saplaması işaretlemesini içerir. 

• Sayfalar/gizlilik, cshtml sayfası veya Görünümler/Home/privacy. cshtml görünümü sitenizin 
gizlilik ilkesini ayrıntılandırmakta olan bir sayfa sağlar. 

ASP.NET Core 3,0 şablonu tarafından oluşturulan bir uygulamada ASP.NET Core 2,2 şablonlarında 
bulunan gibi varsayılan tanımlama bilgisi onayı özelliğini etkinleştirmek için: 

• Using using Microsoft.AspNetcore.Http yönergeleri listesine ekleyin. 

• Şunları yapmak için startup.configureServices veusemapolimapolicy'eilişkinıepolicyoptions 

startup.configure ekleyin: 






public class Startup 

{ 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

// This lambda determines whether user consent for non-essential 
// cookies is needed for a given request. 
options.CheckConsentNeeded = context => true; 

// requires using Microsoft.AspNetCore.Http; 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 

Services.AddRazorPages(); 

} 

public void Configure(IApplicationBuilder app., IWebHostEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionhlandler("/Error"); 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 
app.UseCookiePolicy(); 

app.UseRouting(); 

app.UseAuthorization(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapRazorPages(); 

}); 

} 

} 

Layout. cshtml dosyasına tanımlama bilgisi onayını kısmi olarak ekleyin: 



@*Previous markup removed for brevity*@ 

</headen> 

<div class="container"> 

cpartial name="_CookieConsentPartial" /> 
cmain role="main" class="pb-3"> 

ŞRenderBody() 

</main> 

</div> 

cfooter class="border-top footer text-muted"> 

<div class="container"> 

Scopy; 2019 - RPCC - <a asp-area="" asp-page="/Privacy">Privacy</a> 
</div> 

</footer> 

<script src="~/lib/jquery/dist/jquery. js"x/script> 

<script src="~/lib/bootstrap/dist/js/bootstrap. bundle. js"x/script> 

<script src="~/js/site. js" asp-append-vension="true"x/script> 

@RenderSection("Scripts ", required: false) 

</body> 

</html> 


Bu projeye pişirme leconsentpartial. cshtml dosyasını ekleyin:_ 

@using Microsoft.AspNetCore.Http.Features 

@{ 

var consentFeature = Context.Features.Get<ITrackingConsentFeature>(); 

var showBanner = IconsentFeatureP.CanTrack ?? false; 

var cookieString = consentFeature?.CreateConsentCookie(); 

} 

Şif (showBanner) 

{ 

<div id="cookieConsent" class="alert alert-info alert-dismissible fade show" 
role="alert"> 

Use this space to summarize your privacy and cookie use policy. <a asp- 
page="/Privacy">Learn More</a>. 

cbutton type="button" class="accept-policy close" data-dismiss="alert" aria- 
label="Close" data-cookie-string="@cookieString"> 

<span aria-hidden="true">Accept</span> 

</button> 

</div> 

<script> 

(function () { 

var button = document.querySelector("#cookieConsent button[data-cookie- 

string]"); 

button.addEventListener("click"j function (event) { 
document.cookie = button.dataset.cookieString; 

}, false); 

})(); 

</script> 

} 


Tanımlama bilgisi onayı özelliği hakkında bilgi edinmek için bu makalenin ASP.NET Core 2,2 
sürümünü seçin. 

Proje şablonları, gizlilik ve tanımlama bilgisi kullanım ilkenize göre değiştireceğiniz uzantı 
noktalarını ve saplaması işaretlemesini içerir. 

Bir tanımlama bilgisi onayı özelliği, kişisel bilgileri depolamak için kullanıcılarınıza izin vermenizi 
(ve izlemenizi) sağlar. Bir kullanıcı veri toplamaya ayrılmamışsa ve uygulamada 




checkconsentgerekliyse true , temel olmayan tanımlama bilgileri tarayıcıya gönderilmez. 

• Tanımlama bilgileri, temel olarak işaretlenebilir. Kullanıcı onaylı değil ve izleme devre dışı 
bırakılmış olsa bile, temel tanımlama bilgileri tarayıcıya gönderilir. 

• izleme devre dışı bırakıldığında TempData ve oturum tanımlama bilgileri işlevsel değildir. 

• Kimlik yönetimi sayfası, Kullanıcı verilerini indirmek ve silmek için bir bağlantı sağlar. 

Örnek uygulama , ASP.NET Core 2,1 ŞABLONLARINA eklenen GDPR uzantı noktalarının ve API 

'lerin çoğunu test etmenize olanak tanır. Test yönergeleri için Benioku dosyasına bakın. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Şablon tarafından üretilen kodda ASP.NET Core GDPR desteği 

Proje Şablonlarıyla oluşturulan Razor Pages ve MVC projeleri aşağıdaki GDPR desteğini içerir: 

• Bir sınıfında, startup tanımlama, lepolicyoptions ve useınte lepolicy ayarlanır. 

• Pişirme ASP.NET Core kısmi etiket Yardımcısı leconsentpartiai. cshtml kısmi_ görünümü. Bu 
dosyaya bir kabul düğmesi dahildir. Kullanıcı kabul et düğmesine tıkladığında, tanımlama 
bilgilerini depolamak için onay sağlanır. 

• Sayfalar/gizlilik, cshtml sayfası veya Görünümler/Home/privacy. cshtml görünümü sitenizin 
gizlilik ilkesini ayrıntılandırmakta olan bir sayfa sağlar. Pişirme leconsentpartiai. cshtml dosyası 
gizlilik sayfasına bir bağlantı oluşturur._ 

• Bireysel kullanıcı hesaplarıyla oluşturulan uygulamalarda, Yönet sayfası kişisel kullanıcı 
verileriniindirmek ve silmek için bağlantılar sağlar. 

Tanımlama, lepolicyoptions ve Usepişiriepolicy 

Pişirme lepolicyoptions şu şekilde startup.configureServices başlatılır: 





public class Startup 

{ 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

// This method gets called by the runtime. Use this method to add Services 
// to the Container. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

// This lambda determines whether user consent for non-essential cookies 
// is needed for a given request. 
options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 

Services.AddDefaultIdentity<Identityüser>() 

.AddEntityFrameworkStores<ApplicationDbContext>(); 

// If the app uses session State, cali AddSession. 

// Services.AddSession(); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_l); 

} 

// This method gets called by the runtime. Use this method to configure the 
// HTTP request pipeline. 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 
app.UseDatabaseErrorPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 
app.UseCookiePolicy(); 

app.UseAuthentication(); 

// If the app uses session State, cali Session Middleware after Cookie 
// Policy Middleware and before MVC Middleware. 

// app.UseSession(); 

app.UseMvc(); 

} 

} 


Usepişiriepolicy şu şekilde startup.configure çağrılır: 




public class Startup 

{ 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

// This method gets called by the runtime. Use this method to add Services 
// to the Container. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

// This lambda determines whether user consent for non-essential cookies 
// is needed for a given request. 
options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 

Services.AddDbContext<ApplicationDbContext>(options => 
options.UseSqlServer( 

Configuration.GetConnectionString("DefaultConnection"))); 

Services.AddDefaultIdentity<Identityüser>() 

.AddEntityFrameworkStores<ApplicationDbContext>(); 

// If the app uses session State, cali AddSession. 

// Services.AddSession(); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_l); 

} 

// This method gets called by the runtime. Use this method to configure the 
// HTTP request pipeline. 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 
app.UseDatabaseErrorPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 
app.UseCookiePolicy(); 

app.UseAuthentication(); 

// If the app uses session State, cali Session Middleware after Cookie 
// Policy Middleware and before MVC Middleware. 

// app.UseSession(); 

app.UseMvc(); 

} 

} 


_Pişirme leconsentpartial. cshtml kısmi görünümü 

Pişirme leconsentpartial. cshtml kısmi görünümü:_ 



@using Microsoft.AspNetCore.Http.Features 

@{ 

var consentFeature = Context.Features.Get<ITrackingConsentFeature>(); 

var showBanner = !consentFeature?.CanTrack ?? falsej 

var cookieString = consentFeature?.CreateConsentCookie(); 


@if (showBanner) 

{ 

<nav id="cookieConsent" class="navbar navbar-default navbar-fixed-top" role="alert"> 

<div class="container"> 

<div class="navbar-header"> 

<button type="button" class="navbar-toggle" data-toggle="collapse" data- 
target="#cookieConsent .navbar-collapse"> 

<span class="sr-only">Toggle cookie consent banner</span> 

<span class="icon-bar"x/span> 

<span class="icon-bar"x/span> 

<span class="icon-bar"x/span> 

</button> 

<span class="navbar-brand"xspan class="glyphicon glyphicon-info-sign" aria- 
hidden="true"x/spanx/span> 

</div> 

<div class="collapse navbar-collapse"> 

<p class="navbar-text"> 

Use this space to summarize your privacy and cookie use policy. 

</p> 

<div class="navbar-right"> 

<a asp-page="/Privacy" class="btn btn-info navbar-btn">Learn More</a> 
<button type="button" class="btn btn-default navbar-btn" data-cookie- 
string="@cookieString">Accept</button> 

</div> 

</div> 

</div> 

</nav> 

<script> 

(function () { 

document.querySelector("#cookieConsent button[data-cookie- 
string]").addEventListener("click ", function (el) { 

document.cookie = el.target.dataset.cookieString; 

document.querySelector("#cookieConsent").classList,add("hidden"); 

}, false); 

})(); 

</script> 

} 


Bu kısmi: 

• Kullanıcı için izleme durumunu alır. Uygulama onay gerektirecek şekilde yapılandırıldıysa, 
tanımlama bilgilerinin izlenmemesi için kullanıcının onayı gerekir, izin gerekliyse, tanımlama bilgisi 
onay paneli _düzen. cshtml dosyası tarafından oluşturulan gezinti çubuğunun üstünde düzeltilir. 

• Gizlilik ve tanımlama <p> bilgisi kullanım ilkenizi özetlemek için bir HTML öğesi sağlar. 

• Gizlilik sayfasına bir bağlantı sağlar veya sitenizin gizlilik ilkesini ayrıntılandırınızın ne olduğunu 
görebilirsiniz. 

Temel tanımlama bilgileri 

Tanımlama bilgilerini depolamak için izin sağlanmazsa, tarayıcıya yalnızca temel olarak işaretlenen 

tanımlama bilgileri gönderilir. Aşağıdaki kod, bir tanımlama bilgisini temel yapar: 




public IActionResult OnPostCreateEssentialAsync() 

{ 

HttpContext.Response.Cookies.Append(Constants.EssentialSec, 

DateTime.Now. Second .ToStringO , 

new CookieOptions() { IsEssential = true }); 

ResponseCookies = Response.Headers[HeaderNames.SetCookie] .ToStringO; 

return RedirectToPage("./Index"); 

} 


TempData sağlayıcısı ve oturum durumu tanımlama bilgileri gerekli değildir 

TempData sağlayıcısı tanımlama bilgisi gerekli değildir, izleme devre dışıysa, TempData sağlayıcısı 
işlevsel değildir, izleme devre dışı bırakıldığında TempData sağlayıcısını etkinleştirmek için, TempData 
tanımlama bilgisini' de startup.configureServices gerekli olarak işaretleyin: 

// The TempData provider cookie is not essential. Make it essential 
// so TempData is functional when tracking is disabled. 

Services.Configure<CookieTempDataProviderOptions>(options => { 
options.Cookie.IsEssential = true; 

}); 

Oturum durumu tanımlama bilgileri gerekli değildir, izleme devre dışı olduğunda oturum durumu 
işlevsel değil. Aşağıdaki kod, oturum tanımlama bilgilerini temel yapar: 

Services.AddSession(options => 

{ 

options.Cookie.IsEssential = true; 

}); 


Kişisel veriler 

Bireysel kullanıcı hesaplarıyla oluşturulan ASP.NET Core uygulamalar, kişisel verileri indirmek ve 
silmek için kod içerir. 

Kullanıcı adını seçin ve kişisel veriler 1 i seçin: 






Notlar: 

• Account/Manage Kodu oluşturmak için bkz. Yapı iskelesi kimliği. 

• Silme ve indirme bağlantıları yalnızca varsayılan kimlik verilerinde işlem görür. Özel Kullanıcı 
verileri oluşturan uygulamalar, özel kullanıcı verilerini silmek/indirmek için genişletilmelidir. Daha 
fazla bilgi için bkz. Özel Kullanıcı verilerini kimlik İle ekleme, indirme ve silme. 

• Kimlik veritabanı tablosunda AspNetuserTokens depolanan kullanıcının kaydedilmiş belirteçleri, 
Kullanıcı yabancı anahtarnedeniyle basamaklı silme davranışı aracılığıyla silindiğinde silinir. 

• Facebook ve Google gibi dış sağlayıcı kimlik doğrulaması, tanımlama bilgisi ilkesi kabul 
edilmeden önce kullanılamaz. 

Bekleme sırasında şifreleme 

Bazı veritabanları ve depolama mekanizmaları, bekleyen şifreleme için izin verir. Bekleyen şifreleme: 

• Depolanan verileri otomatik olarak şifreler. 

• Veriye erişen yazılımlar için yapılandırma, programlama veya diğer çalışmasız şifreler. 

• En kolay ve en güvenli seçenektir. 

• Veritabanının anahtarları ve şifrelemeyi yönetmesine izin verir. 

Örneğin: 

• Microsoft SOL ve Azure SOL, Saydam veri şifrelemesi (tde) sağlar. 

• SOL Azure, varsayılan olarak veritabanını şifreler 

• Azure Blobları, dosyalar, tablo ve kuyruk depolaması varsayılan olarak şifrelenir. 

Bekleyen şifreleme sağlamayan veritabanları için aynı korumayı sağlamak üzere disk şifrelemeyi 

















kullanabilirsiniz. Örneğin: 

• VVİndovvs Server için BitLocker 

• Linux: 

o Eccryptotfs 
o Şifreleme. 

Ek kaynaklar 

• Microsoft.com/GDPR 

• GDPR-ASP.NET Core İzin İptali düğmesi ekleme 


ASPNET Core siteler arası İstek sahteciliği 
(XSRF/CSRF) saldırılarını önle 

6.12.2019 • 25 minutes to read ı Edit Online 


By Rick Anderson, fiyaz hasanve Steve Smith 

Siteler arası istek sahteciliği (XSRF veya CSRF olarak da bilinir), kötü amaçlı bir Web uygulamasının, 
bir istemci tarayıcısı ile bu tarayıcıya güvenen bir Web uygulaması arasındaki etkileşimi 
etkileyebilecek Web 'de barındırılan uygulamalara karşı bir saldırıdır. Web tarayıcıları her bir Web 
sitesi isteğiyle otomatik olarak bazı kimlik doğrulama belirteçleri gönderdikleri için bu saldırılar 
mümkündür. Bu güvenlik düzeyi, tek tıklamayla saldırı veya oturum adı olarak da bilinir çünkü 
saldırı, kullanıcının önceden kimliği doğrulanmış oturumunun avantajlarından yararlanır. 

CSRF saldırılarına bir örnek: 

1. Kullanıcı, Forms kimlik doğrulaması kullanarak www.good-banking-site.com oturum açar. 

Sunucu, kullanıcının kimliğini doğrular ve kimlik doğrulama tanımlama bilgisi içeren bir yanıt 
yayınlar. Site, geçerli bir kimlik doğrulama tanımlama bilgisiyle aldığı herhangi bir isteğe 
güvendiğinden saldırıya açıktır. 

2. Kullanıcı kötü amaçlı bir siteyi ziyaret www.bad-crook-site.com. 
www.bad-crook-site.com kötü amaçlı sitesi, aşağıdakine benzer bir HTML formu içerir: 

<hl>Congratulations! You’re a Winner!</hl> 

<form action="http://good -banking-site.com/api/account" method="post"> 
cinput type="hidden" name="Transaction" value="withdraw"> 
cinput type="hidden" name="Amount" value="1000000"> 
cinput type="submit" value="Click to collect your prize!"> 

</form> 

Formun action kötü amaçlı siteye değil, güvenlik açığı bulunan siteye gönderdiğine dikkat 
edin. Bu, CSRF ‘nin "siteler arası" parçasıdır. 

3. Kullanıcı Gönder düğmesini seçer.Tarayıcı, isteği yapar ve istenen etki alanı için kimlik 
doğrulama tanımlama bilgisini otomatik olarak ekler www.good-banking-site.com . 

4. istek, kullanıcının kimlik doğrulama bağlamıyla www.good-banking-site.com sunucuda çalışır 
ve kimliği doğrulanmış bir kullanıcının gerçekleştirmesine izin verilen herhangi bir eylemi 
gerçekleştirebilir. 

Kullanıcının formu göndermek için düğmeyi seçtiği senaryoya ek olarak, kötü amaçlı site şunları 
verebilir: 

• Formu otomatik olarak gönderen bir komut dosyası çalıştırın. 

• Form gönderimini bir AJAX isteği olarak gönderin. 

• Formu CSS kullanarak gizleyin. 

Bu alternatif senaryolar, ilk olarak kötü amaçlı siteyi ziyaret eden kullanıcıdan herhangi bir eylem 
veya giriş gerektirmez. 

HTTPS kullanmak CSRF saldırılarına engel olmaz. Kötü amaçlı site, güvenli olmayan bir istek 









gönderebilmesini mümkün olduğunca kolay bir https://www.good-banking-site.com/ isteği 
gönderebilir. 

Bazı saldırılar, G ET isteklerine yanıt veren uç noktaları, bu durumda eylemi gerçekleştirmek için bir 
resim etiketi kullanılabilir. Bu saldırı biçimi, görüntülere izin veren ancak JavaScript T engelleyen 
Forum sitelerinde yaygındır. Değişkenlerin veya kaynakların değiştirildiği, G ET isteklerinde durumu 
değiştiren uygulamalar kötü niyetli saldırılara açıktır. Durumu değiştirme isteklerini güvenli 
olmayan GET istekleri. Bir GET isteğindeki durumu hiçbir şekilde değiştirmemek en iyi 
uygulamadır. 

CSRF saldırıları, kimlik doğrulaması için tanımlama bilgileri kullanan Web uygulamalarına karşı şu 
nedenle mümkündür: 

• Tarayıcılar bir Web uygulaması tarafından verilen tanımlama bilgilerini depolar. 

• Depolanan tanımlama bilgileri, kimliği doğrulanmış kullanıcılar için oturum tanımlama bilgilerini 
içerir. 

• Tarayıcılar, bir etki alanı ile ilişkili tüm tanımlama bilgilerini, uygulama isteğinin tarayıcıdan 
oluşturulma şeklinden bağımsız olarak her istek için Web uygulamasına gönderir. 

Ancak, CSRF saldırıları, tanımlama bilgilerini kötüye ile sınırlı değildir.Örneğin, temel ve Özet kimlik 
doğrulaması da savunmasız olacaktır. Kullanıcı temel veya Özet kimlik doğrulamasıyla oturum 
açtıktan sonra, oturumt sona erene kadar tarayıcı kimlik bilgilerini otomatik olarak gönderir. 

Bu bağlamda +oturum , kullanıcının kimliğinin doğrulanması sırasında istemci tarafı oturum 
anlamına gelir. Sunucu tarafı oturumları veya ASP.NET Core oturum ara yazılımıile ilgisi yoktur. 

Kullanıcılar, önlemler alarak CSRF güvenlik açıklarına karşı koruma sağlayabilir: 

• Web Apps 'in kullanımı bittiğinde oturumunuzu kapatın. 

• Tarayıcı tanımlama bilgilerini düzenli aralıklarla temizleyin. 

Ancak, CSRF güvenlik açıkları son kullanıcıdan değil, Web uygulamasıyla ilgili bir sorundur. 

Kimlik doğrulama temelleri 

Tanımlama bilgisi tabanlı kimlik doğrulama, popüler bir kimlik doğrulama biçimidir. Belirteç tabanlı 
kimlik doğrulama sistemleri, özellikle tek sayfalı uygulamalar (maça 'Lar) için popülerlik olarak 
büyüyordun 

Tanımlama bilgisi tabanlı kimlik doğrulaması 

Bir Kullanıcı Kullanıcı adını ve parolasını kullanarak kimliğini doğruladığında, kimlik doğrulama ve 
yetkilendirme için kullanılabilecek bir kimlik doğrulama bileti içeren bir belirteç verilirler. Belirteç, 
istemcinin yaptığı her istekte eşlik eden bir tanımlama bilgisi olarak depolanır. Bu tanımlama 
bilgisinin oluşturulması ve doğrulanması, tanımlama bilgisi kimlik doğrulama ara yazılımı tarafından 
gerçekleştirilir. Ara yazılım , bir Kullanıcı sorumlusunu şifreli bir tanımlama bilgisine seri hale getirir. 
Sonraki isteklerde, ara yazılım tanımlama bilgisini doğrular, sorumluyu yeniden oluşturur ve 
sorumluyu HttpContext Kullanıcı özelliğine atar. 

Belirteç tabanlı kimlik doğrulaması 

Bir kullanıcının kimliği doğrulandığında, bunlar bir belirteç (antibir belirteç değil) olarak verilirler. 
Belirteç, talepler formundaki Kullanıcı bilgilerini veya uygulamayı uygulamada tutulan Kullanıcı 
durumuna işaret eden bir başvuru belirtecini içerir. Bir kullanıcı kimlik doğrulaması gerektiren bir 
kaynağa erişmeyi denediğinde, belirteç, taşıyıcı belirteç biçiminde ek bir yetkilendirme üstbilgisiyle 
uygulamaya gönderilir. Bu, uygulamanın durum bilgisiz olmasını sağlar. Sonraki her istekte, belirteç 
sunucu tarafı doğrulama isteğine geçirilir. Bu belirteç şifrelenmez', kodlandı. Sunucusunda, bilgilerine 
erişmek için belirtecin kodu çözülür. Sonraki isteklere belirteç göndermek için, belirteci tarayıcının 




yerel deposunda depolayın. Belirteç tarayıcının yerel deposunda depolanıyorsa, CSRF güvenlik 
açığıyla ilgilenmeyin. CSRF, belirteç bir tanımlama bilgisinde depolandığında sorun teşkil ediyor. 
Daha fazla bilgi için bkz. GitHub sorunu Spa kodu örneği iki tanımlama bilgisi ekler. 

Tek bir etki alanında barındırılan birden çok uygulama 

Paylaşılan barındırma ortamları, oturum ele geçirme, oturum açma CSRF ve diğer saldırılara karşı 
savunmasız kalır. 


examplel.contoso.net 

ve 

example2.contoso.net 

farklı konaklara sahip olsa da, 

*. contoso.net 


alanı altındaki konaklar arasında örtülü bir güven ilişkisi vardır. Bu örtük güven ilişkisi, 
güvenilmeyen ana bilgisayarların birbirlerinin tanımlama bilgilerini etkilemesini sağlar (AJAX 
isteklerini yöneten aynı kaynak ilkeleri HTTP tanımlama bilgilerine uygulanmaz). 

Aynı etki alanı üzerinde barındırılan uygulamalar arasında güvenilen tanımlama bilgileriyle 
faydalanan saldırılar, etki alanlarının paylaşılmasından engellenebilir. Her uygulama kendi etki 
alanında barındırıldığı zaman, açıktan yararlanılabilmesi için örtük bir tanımlama bilgisi güven ilişkisi 
yoktur. 

ASP.NET Core antiforgery yapılandırması 

VVARNING 

ASP.NET Core, ASP.NET Core veri korumasınıkullanarak antiforgery uygular Veri koruma yığınının bir sunucu 
grubunda çalışacak şekilde yapılandırılması gerekir. Daha fazla bilgi için bkz. veri korumayı yapılandırma . 


startup.configureServices içinde aşağıdaki API 'lerden biri çağrıldığında, antiforgery ara yazılımı 
bağımlılık ekleme kapsayıcısına eklenir: 

• AddMvc 

• MapRazorPages 

• MapControllerRoute 

• MapBlazorHub 

AddMvc Startup.configureServices çağrıldığında, antiforgery ara yazılımı bağımlılık ekleme 
kapsayıcısına eklenir 

ASP.NET Core 2,0 veya sonraki sürümlerde Formtaghelper , antiforgery belirteçlerini HTML form 
öğelerine çıkartır. Bir Razor dosyasında aşağıdaki biçimlendirme, antiforgery belirteçlerini otomatik 
olarak oluşturur: 

<fonn method="post"> 

</form> 

Benzer şekilde, ıhtmlhelper. BeginForm, formun yöntemi get değilse, varsayılan olarak antiforgery 
belirteçleri oluşturur. 

HTML form öğeleri için antiforgery belirteçlerinin otomatik olarak oluşturulması, <form> etiketi 
method="post" özniteliğini içerdiğinde ve aşağıdakilerden biri doğru olduğunda gerçekleşir: 

• Action özniteliği boş ( action="" ). 

• Eylem özniteliği sağlanmadı ( <form method="post"> ). 

HTML form öğeleri için antiforgery belirteçlerinin otomatik nesli devre dışı bırakılabilir: 













• asp-antiforgery özniteliğiyle antiforgery belirteçlerini açıkça devre dışı bırakın: 

<form method="post" asp-antiforgery="false"> 

</form> 

• Form öğesi etiket Yardımcısı! geri alma simgesi kullanılarak etiket yardımcılarını kabuletmedi: 

<!form method="post"> 

</!form> 

• FormTagHelper görünümden kaldırın. FormTagHelper , Razor görünümüne aşağıdaki 
yönergeyi ekleyerek bir görünümden kaldırılabilir: 

(SremoveTagHelper Microsoft.AspNetCore.Mvc.TagHelpers.FormTagHelper , 

Microsoft.AspNetCore.Mvc.TagHelpers 


NOTE 

Razor Pages , XSRF/CSRF 'den otomatik olarak korunur. Daha fazla bilgi için bkz. XSRF/CSRF ve Razor Pages. 


CSRF saldırılarına karşı savunma için en yaygın yaklaşım, Eşitleyici belirteç deseninin (STP) 
kullanılması. Kullanıcı form verileri içeren bir sayfa istediğinde STP kullanılır: 

1. Sunucu, geçerli kullanıcının kimliğiyle ilişkili bir belirteci istemciye gönderir. 

2. istemci doğrulama için belirteci sunucuya geri gönderir. 

3. Sunucu kimliği doğrulanmış kullanıcının kimliğiyle eşleşmeyen bir belirteç alırsa istek reddedilir. 

Belirteç benzersizdir ve tahmin edilemez. Belirteç Ayrıca, bir dizi isteğin doğru sıralamasını sağlamak 
için de kullanılabilir (örneğin,: sayfa 1 - sayfa 2 - sayfa 3). ASP.NET Core MVC ve Razor Pages 
şablonlarındaki tüm formlar, antiforgery belirteçleri oluşturur. Aşağıdaki görünüm örnekleri, 
antiforgery belirteçleri oluşturur: 

<form asp-controller="Manage" asp-action="ChangePassword" method="post"> 

</form> 

(Şusing (Html.BeginForm("ChangePassword", "Manage")) 

{ 

} 

FITML Yardımcısı @Htmi.AntiForgeryToken İle etiket yardımcıları kullanmadan bir <form> öğeye 
açıkça bir antiforgery belirteci ekleyin: 

<form action="/" method="post"> 

@Html.AntiForgeryToken() 

</form> 


Yukarıdaki durumların her birinde, ASP.N ET Core şuna benzer bir gizli form alanı ekler: 













cinput name="_RequestVerificationToken" type="hidden" value="CfDD8NrAkS ... s2-m9Yw"> 


AS P.N ET Core, antiforgery belirteçleriyle çalışmak için üç filtre içerir: 

• ValidateAntiForgeryToken 

• Oto Validateantiforgeryıtoken 

• Ignoreantiforgeri belirteci 


Antiforgery seçenekleri 



SEÇENEK 


AÇIKLAMA 


Bilgilerinin 


Antiforgery tanımlama bilgilerini oluşturmak için 
kullanılan ayarları belirler. 


Form alanadı Görünümlerde antiforgery belirteçlerini işlemek için 

antiforgery sistemi tarafından kullanılan gizli form 
alanının adı. 


FleaderName Antiforgery sistemi tarafından kullanılan üstbilginin 

adı. null , sistem yalnızca form verilerini dikkate alır. 


SuppressXFrameOptionsHeader x-Frame-options üst bilgisinin oluşturulup 

oluşturulmayacağım belirtir. Varsayılan olarak, üst bilgi 
"SAMEORIGIN" değeri ile oluşturulur, false değerini 
varsayılan olarak alır. 


Services.AddAntiforgery(options => 

{ 

options.CookieDomain = "contoso.com"; 

options.CookieName = "X-CSRF-TOKEN-COOKIENAME"; 

options.CookiePath = "Path"; 

options.FormFieldName = "AntiforgeryFieldname"; 
options.HeaderName = "X-CSRF-TOKEN-HEADERNAME"; 
options.RequireSsl = false; 
options.SuppressXFrameOptionsHeader = false; 


SEÇENEK 


AÇIKLAMA 


Bilgilerinin 


Antiforgery tanımlama bilgilerini oluşturmak için 
kullanılan ayarları belirler. 








SEÇENEK 


AÇIKLAMA 


Pişirme etki alanı 

Tanımlama bilgisinin etki alanı, null değerini 
varsayılan olarak alır. Bu özellik artık kullanılmıyor ve 
gelecek bir sürümde kaldırılacak. Önerilen alternatif, 
Cookie. Domain ' dir. 

CookieName 

Tanımlama bilgisinin adı. Ayarlanmamışsa, sistem 
Defaultpişirme ıeprefix ("ile başlayan benzersiz bir ad 
oluşturur. AspNetCore. Antiforgery."). Bu özellik artık 
kullanılmıyor ve gelecek bir sürümde kaldırılacak. 

Önerilen alternatif, Cookie.Name ' dir. 

CookiePath 

Tanımlama bilgisinde ayarlanan yol. Bu özellik artık 
kullanılmıyor ve gelecek bir sürümde kaldırılacak. 

Önerilen alternatif, Cookie. Path 1 dir. 

Form alanadı 

Görünümlerde antiforgery belirteçlerini işlemek için 
antiforgery sistemi tarafından kullanılan gizli form 
alanının adı. 

HeaderName 

Antiforgery sistemi tarafından kullanılan üstbilginin 
adı. null , sistem yalnızca form verilerini dikkate alır. 

ReguireSsI 

Antiforgery sistemi için HTTPS 'nin gerekli olup 
olmadığını belirtir, true , HTTPS olmayan istekler 
başarısız olur, false değerini varsayılan olarak alır. Bu 
özellik artık kullanılmıyor ve gelecek bir sürümde 
kaldırılacak. Önerilen alternatif, Cookie. SecurePolicy 1 i 
ayarlanmakta. 


SuppressXFrameOptionsHeader x-Frame-options üst bilgisinin oluşturulup 

oluşturulmayacağım belirtir. Varsayılan olarak, üst bilgi 
"SAMEORIGIN" değeri ile oluşturulur, false değerini 
varsayılan olarak alır. 

Daha fazla bilgi için bkz. tanımlama, leauthenticationoptions. 

lantiforgery ile antiforgery özelliklerini yapılandırma 

lantiforgery , antiforgery özelliklerini YAPıLANDıRMAK için API sağlar. iAntiforgery , startup 
sınıfının configure yönteminde istenebilir. Aşağıdaki örnek, bir antiforgery belirteci oluşturmak ve 
yanıtta bir tanımlama bilgisi olarak (Bu konunun ilerleyen kısımlarında açıklanan varsayılan angular 
adlandırma kuralını kullanarak) bir uygulama ana sayfasından bir ara yazılım kullanır: 







public void Configure(IApplicationBuilder app, IAntiforgery antiforgery) 

{ 

app.Use(next => context => 

{ 

string path = context.Request.Path.Value; 

if ( 

string.Equals(path, "/", StringComparison.OrdinalIgnoreCase) | 
string.Equals(path, "/index.html", StringComparison.OrdinalIgnoreCase)) 

{ 

// The request token can be sent as a iavaScript-readable cookie, 

// and Angular uses it by default. 
var tokens = antiforgery.GetAndStoreTokens(context); 
context.Response.Cookies.Append("XSRF-TOKEN", tokens.RequestToken, 
new CookieOptions() { HttpOnly = false }); 

} 

return next(context); 

}); 

} 


Antiforgery doğrulaması gerektir 

Validateantiforgeritoken , tek bir eyleme, denetleyiciye veya küresel olarak uygulanabilen bir eylem 
filtresidir. Bu filtre uygulanmış eylemlere yapılan istekler, istek geçerli bir antiforgery belirteci 
içermiyorsa engellenir. 

[HttpPost] 

[ValidateAntiForgeryToken] 

public async Task<IActionResult> RemoveLogin(RemoveLoginViewModel account) 

{ 

ManageMessageld? message = ManageMessageld.Error; 
var user = await GetCurrentUserAsync(); 

if (user != null) 

{ 

var result = 

await _userManager.RemoveLoginAsync( 

user, account.LoginProvider, account.ProviderKey); 

if (result.Succeeded) 

{ 

await _signInManager.SignInAsync(user, isPersistent: false); 
message = ManageMessageld.RemoveLoginSuccess; 

} 

} 

return RedirectToAction(nameof(ManageLogins), new { Message = message }); 

} 

ValidateAntiForgeryToken özniteliği, HTTP GET istekleri dahil olmak üzere, işaret eden eylem 
yöntemlerine yönelik bir belirteç gerektirir. ValidateAntiForgeryToken özniteliği uygulamanın 
denetleyicileri arasında uygulanırsa, ignoreAntiforgeryToken özniteliğiyle geçersiz kılınabilir. 


NOTE 

ASP.NET Core, istekleri otomatik olarak almak için antiforgery belirteçleri eklemeyi desteklemez. 


Yalnızca güvenli olmayan HTTP metotları için antiforgery belirteçlerini otomatik olarak doğrula 

ASP.NET Core uygulamalar güvenli HTTP yöntemleri (GET, HEAD, OPTIONS ve TRACE) için 






antiforgery belirteçleri oluşturmaz. validateAntiForgeryToken özniteliğini büyük bir şekilde 
uygulamak ve sonra ignoreAntiforgeryToken özniteliklerle geçersiz kılmak yerine, oto 
Validateantiforgeri belirteci özniteliği kullanılabilir. Bu öznitelik, ValidateAntiForgeryToken 
özniteliğiyle aynı şekilde çalışır, ancak aşağıdaki HTTP yöntemlerini kullanarak yapılan isteklere 
belirteç gerektirmez: 

• GET 

• BAŞ 

• SEÇENEKLER 

• TRACE 

API olmayan senaryolar için AutovalidateAntiforgeryToken kullanımı önerilmektedir. Bu, varsayılan 
olarak POST eylemlerinin korunmasını sağlar. Diğer bir deyişle, ValidateAntiForgeryToken bağımsız 
eylem yöntemlerine uygulanmamışsa, varsayılan olarak antiforgery belirteçlerini yok saymanız 
gerekir. Bu senaryoda, bir POST eylemi yönteminin korumasız olarak bırakılması, uygulamanın 
CSRF saldırılarına karşı savunmasız bırakılması daha yüksektir. Tüm gönderimler, antiforgery 
belirtecini göndermelidir. 

API 'lerin, belirtecin tanımlama bilgisi olmayan bölümünü göndermek için otomatik bir 
mekanizması yoktur. Uygulama, büyük olasılıkla istemci kodu uygulamasına bağlıdır.Bazı örnekler 
aşağıda gösterilmiştir: 

Sınıf düzeyi örnek: 

[Authorize] 

[AutovalidateAntiforgeryToken] 

public class ManageController : Controller 

{ 

Genel örnek: 

Services.AddMvc(options => 

options.Filters.Add(new AutoValidateAntiforgeryTokenAttribute())); 

Küresel veya denetleyici antiforgery özniteliklerini geçersiz kıl 

Ignoreantiforgeri Token filtresi, belirli bir eyleme (veya denetleyiciye) yönelik bir antiforgery 
belirtecinin gereksinimini ortadan kaldırmak için kullanılır. Bu filtre uygulandığında, daha yüksek 
düzeyde belirtilen ValidateAntiForgeryToken ve AutovalidateAntiforgeryToken filtrelerini geçersiz 
kılar (genel olarak veya bir denetleyicide). 

[Authorize] 

[AutovalidateAntiforgeryToken] 

public class ManageController : Controller 

{ 

[FlttpPost] 

[IgnoreAntiforgeryToken] 

public async Task<IActionResult> DoSomethingSafe(SomeViewModel model) 

{ 

// no antiforgery token required 

} 

} 


Kimlik doğrulamasından sonra belirteçleri Yenile 


Kullanıcı bir görünüm veya Razor Pages sayfasına yönlendirerek, kullanıcının kimliği doğrulandıktan 













sonra belirteçlerin yenilenmesi gerekir. 


JavaScript, AJAX ve maça 

Geleneksel HTML tabanlı uygulamalarda, antiforgery belirteçleri gizli form alanları kullanılarak 
sunucuya geçirilir. Modern JavaScript tabanlı uygulamalar ve maça 'Lar, programlama yoluyla 
birçok istek yapılır. Bu AJAX istekleri, belirteci göndermek için diğer teknikleri (istek üstbilgileri veya 
tanımlama bilgileri gibi) kullanabilir. 

Kimlik bilgileri kimlik doğrulama belirteçlerini depolamak ve sunucudaki API isteklerinin kimliğini 
doğrulamak için kullanılıyorsa, CSRF olası bir sorundur. Yerel depolama, belirteci depolamak için 
kullanılıyorsa, yerel depolama alanındaki değerler her istek ile sunucuya otomatik olarak 
gönderilmediğinden CSRF güvenlik açığı azaltılabilir. Bu nedenle, istemci üzerinde antiforgery 
belirtecini depolamak ve belirteci istek üst bilgisi olarak göndermek için yerel depolama kullanmak 
önerilen bir yaklaşımdır. 

JavaScript 

Görünümler ile JavaScript kullanarak, belirteç, görünümün içinden bir hizmet kullanılarak 
oluşturulabilir. Microsoft. AspNetCore. antiforgery. iantiforgery hizmetini görünüme ekleyin ve 
Getandstorebelirteçleriniçağırın: 




ViewData["Title"] = "ADAX Demo"; 

} 

(Şinject Microsoft.AspNetCore.Antiforgery.IAntiforgery Xsrf 
@functions{ 

public string GetAntiXsrfRequestToken() 

{ 

return Xsrf.GetAndStoreTokens(Context).RequestTokenj 

} 

} 

cinput type="hidden" id="RequestVerificationToken" 

name="RequestVerificationToken" value="@GetAntiXsrfRequestToken()"> 

<h2>@ViewData["Title"],</h2> 

<h3>@ViewData["Message"]</h3> 

<div class="row"> 

<pxinput type="button" id="antiforgery" value="Antiforgery"x/p> 

<script> 

var xhttp = new XMLHttpRequest(); 
xhttp.onreadystatechange = function() { 

if (xhttp.readyState == XMLHttpRequest.DONE) { 
if (xhttp.status == 200) { 

alert(xhttp.responseText); 

} else { 

alert('There was an error Processing the A3AX request.'); 

} 

} 

}; 


document.addEventListener('DOMContentLoaded', function() { 

document.getElementById("antiforgery").onclick = function () { 

xhttp.open('POST', '@Url.Action("Antiforgery", "Home")', true); 
xhttp.setRequestHeader("RequestVerificationToken", 

document.getElementById('RequestVerificationToken').value); 
xhttp.send()j 

} 

}); 

</script> 

</div> 


Bu yaklaşım, sunucudan tanımlama bilgilerini ayarlama veya istemciden okuma konusunda 
doğrudan anlaşma gereksinimini ortadan kaldırır. 

Önceki örnekte, AJAX GÖNDERİ üst bilgisinin gizli alan değerini okumak için JavaScript 
kullanılmaktadır. 

JavaScript, tanımlama bilgilerinde belirteçlere de erişebilir ve belirtecin değerine sahip bir üst bilgi 
oluşturmak için tanımlama bilgisinin içeriğini kullanabilir. 

context.Response.Cookies.Append("CSRF-TOKEN", tokens.RequestToken, 

new Microsoft.AspNetCore.Http.CookieOptions { HttpOnly = false }); 

Komut dosyası, belirteci x-csrf-token adlı bir üst bilgide göndermek için istek olduğunu 
varsayarsak, antiforgery hizmetini x-csrf-token üst bilgisini aramak için yapılandırın: 

Services.AddAntiforgery(options => options.HeaderName = "X-CSRF-TOKEN"); 

Aşağıdaki örnek, uygun üst bilgiyle bir AJAX isteği oluşturmak için JavaScript kullanır: 








function getCookie(cname) { 
var name = cname + 

var decodedCookie = decodeURIComponent(document.cookie); 
var ca = decodedCookie.split(';'); 
for(var i = 0; i <ca.lengthj i++) { 
var c = ca[i]; 

while (c.charAt(0) == ' ') { 
c = c.substring(l); 

} 

if (c.indexOf(name) == 0) { 

return c.substring(name.length, c.length); 

} 

} 

return 

} 

var csrfToken = getCookie("CSRF-TOKEN"); 

var xhttp = new XMLHttpRequest(); 
xhttp.onreadystatechange = function() { 

if (xhttp.readyState == XMLHttpRequest.DONE) { 
if (xhttp.status == 200) { 

alert(xhttp.responseText); 

} else { 

alert('There was an error Processing the AİAX request.'); 

} 

} 

}; 

xhttp.open('POST', '/api/password/changepassword ', true); 
xhttp.setRequestHeader("Content-type ", "application/json"); 
xhttp.setRequestHeader("X-CSRF-TOKEN ", csrfToken); 

xhttp.send(3S0N.stringify({ "newPassword": "ReallySecurePassword999$$$" })); 


AngularJS 

AngularJS, CSRF adresine yönelik bir kural kullanır.Sunucu xsrf-token ada sahip bir tanımlama 
bilgisi gönderirse, AngularJS $http hizmeti, sunucuya istek gönderdiğinde tanımlama bilgisi 
değerini bir üstbilgiye ekler. Bu işlem otomatiktir. Üstbilginin istemcide açıkça ayarlanması 
gerekmez. Üst bilgi adı x-xsrf-token . Sunucunun bu üstbilgiyi algılaması ve içeriğini doğrulaması 
gerekir. 

ASP.NET Core API ’nin uygulama başlangıcında bu kurala göre çalışması için: 

• Uygulamanızı, xsrf-token adlı bir tanımlama bilgisinde belirteç sunacak şekilde yapılandırın. 

• Antiforgery hizmetini x-xsrf-token adlı üstbilgiyi aramak üzere yapılandırın. 








public void Configure(IApplicationBuilder app, IAntiforgery antiforgery) 

{ 

app.Use(next => context => 

{ 

string path = context.Request.Path.Value; 

if ( 

string.Equals(path, StringComparison.OrdinalIgnoreCase) | 

string.Equals(path, "/index.html ", StringComparison.OrdinalIgnoreCase)) 

{ 

// The request token can be sent as a iavaScript-readable cookie, 

// and Angular uses it by default. 
var tokens = antiforgery.GetAndStoreTokens(context); 
context.Response.Cookies.Append("XSRF-TOKEN", tokens.RequestToken, 
new CookieOptions() { HttpOnly = false }); 

} 

return next(context); 

}); 

} 

public void ConfigureServices(IServiceCollection Services) 

{ 

// Angular's default header name for sending the XSRF token. 

Services.AddAntiforgery(options => options.FleaderName = "X-XSRF-TOKEN"); 

} 


Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Antiforgery 'yi uzat 

lantiforgeryadditionaldataprovider türü, geliştiricilerin her bir belirteçte ek verileri yuvarlak aşağı 
getirerek CSRF sisteminin davranışını genişletmesini sağlar. Getaddıtionaldata yöntemi, bir alan 
belirtecinin oluşturulduğu her seferinde çağrılır ve döndürülen değer oluşturulan belirtecin içine 
gömülür. Bir uygulayıcısı, bir zaman damgası, bir kerelik anahtar veya başka bir değer döndürebilir 
ve ardından, belirteç doğrulandığında bu verileri doğrulamak için Validateadditionaldata öğesini 
çağırabilir, istemcinin Kullanıcı adı, oluşturulan belirteçlere zaten eklenmiş olduğundan, bu bilgileri 
eklemeniz gerekmez. Bir belirteç ek verileri içeriyorsa ancak iAntiForgeryAdditionaiDataProvider 
yapılandırılmamışsa, ek veriler doğrulanmaz. 

Ek kaynaklar 

• Öpen Web Application Security projesinde CSRF (OVVASP). 

• Web çiftliğinde AS P.N ET Core ana bilgisayar 




ASPNET core'da açık yeniden yönlendirme 
saldırılarını önleme 
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Sorgu dizesi veya form verileri gibi isteği aracılığıyla belirtilen bir URL'ye yönlendiren bir web uygulaması büyük 
olasılıkla kullanıcıların dış, kötü amaçlı bir URL'ye yönlendirilmesini bozuabilir. Bu izinsiz bir açık yeniden 
yönlendirme saldırısı olarak adlandırılır. 

Uygulama mantığınızın bir belirtilen URL'ye yeniden yönlendirir olduğunda, yeniden yönlendirme URL'sini 
kurcalanmadığı doğrulamanız gerekir. ASP.N ET Core uygulamaları (yeniden yönlendirme açık olarak da bilinir) 
açık yeniden yönlendirme saldırılarına karşı korumaya yardımcı olmak için yerleşik bir işleve sahiptir. 

Açık yeniden yönlendirme saldırının nedir? 

Kimlik doğrulaması gerektiren kaynaklara erişirken web uygulamaları kullanıcıların sık bir oturum açma sayfasına 
yönlendirir. Yeniden yönlendirme genellikle içeren bir returnUri querystring parametresi böylece bunlar 
başarıyla oturum açtıktan sonra başta istenen URL'ye kullanıcı döndürülebilir. Kullanıcı kimlik doğrulaması 
yaptıktan sonra bunlar ilk olarak istedikleri URL'ye yönlendirilirsiniz. 

Hedef URL isteğinin sorgu dizesinde belirtildiğinden, kötü niyetli bir kullanıcı sorgu dizesini ile neden. Değiştirilen 
bir sorgu dizesi, kullanıcı bir harici, kötü amaçlı sitesine yönlendirmek site izin verebilir. Bu teknik, bir açık yeniden 
yönlendirme (veya yeniden yönlendirme) saldırısı olarak adlandırılır. 

Bir örnek saldırı 

Kötü niyetli bir kullanıcı, bir kullanıcının kimlik bilgilerine veya hassas bilgileri kötü niyetli bir kullanıcı erişime izin 
vermeye yönelik bir saldırı geliştirebilirsiniz. Kötü amaçlı kullanıcı saldırı başlatmak için sitenizin oturum açma 
sayfasına bir bağlantıya tıklayabilecekleri kullanıcı convinces bir returnuri URL'ye eklenen sorgu dizesi değeri. 
Örneğin, bir uygulamanın düşünün contoso.com içeren bir oturum açma sayfasına 
http://contoso.com/Account/LogOn?netunnUrl=/Home/About . Saldın ŞU adımlardan oluşur: 

1. Kullanıcı kötü amaçlı bir bağlantıyı tıkladığında 

http://contoso.com/Account/LogOn?neturnUrl=http://contosol.com/Account/LogOn (ikinci URL "contOSOİ.COm", 
yok "contoso.com"). 

2. Kullanıcı başarıyla oturum. 

3. (Site tarafından) yönlendireceği kullanıcı http://contosoi.com/Account/LogOn (tam olarak gerçek site gibi 
görünen bir kötü niyetli site). 

4. Kullanıcının yeniden oturum açması (kimlik bilgilerini site kötü amaçlı vererek) ve gerçek sitede yeniden 
yönlendirilir. 

Kullanıcının büyük olasılıkla, ilk oturum açma girişimi başarısız olduğunu ve bunların ikinci denemesi başarılı 
olduğunu düşündüğü. Kullanıcı, büyük olasılıkla farkında kimlik bilgilerini tehlikede olduğunu kalır. 











Öpen Redirection Attack Process 


User clicks a link to 
a trusted site 


User logs into site 
successfully 


o 



Trusted Site 

Login/Redirect Page 



301 

Redirect 


Querystring URL 
redirects user to 
malicious site 


User redirected to 
malicious site 


Malicious Site 


Oturum açma sayfalarına ek olarak bazı siteler yeniden yönlendirme sayfaları veya uç noktaları sağlar. 
Uygulamanız bir açık yeniden yönlendirme içeren bir sayfa sahip Imagine /Home/Redirect . Bir saldırgan, örneğin, 
bir bağlantı, giden e-posta oluşturabilir [yoursite]/Home/Redirect?url=http://phishingsite.com/Home/Login . Tipik 
bir kullanıcı URL'SİNDE görüneceğini ve site adınızı ile başlayan bakın. Güvenen, bunlar bağlantıya tıklayın. Açık 
yeniden yönlendirme kullanıcı sizin için aynı görünür, kimlik avı siteye gönderir ve kullanıcı büyük olasılıkla 
misiniz ne düşünüyorsanız için oturum açma bilgileri ise sitenizi. 

Açık yeniden yönlendirme saldırılarına karşı koruma 

Web uygulamaları geliştirirken, kullanıcı tarafından sağlanan tüm verileri güvenilmez olarak kabul eder. 
Uygulamanızın URL'sini içeriğine göre kullanıcı yönlendiren işlevi varsa, bu tür yeniden yönlendirmeler yalnızca 
yerel olarak uygulamanızın içinde (veya bilinen bir URL, sorgu dizesinde sağlanan değil herhangi bir URL) 
yapıldığını emin olun. 

Local Redirect 

Kullanım LocaiRedirect yardımcı yöntem tabanından controiler sınıfı: 

public IActionResult SomeAction(string redirectUrl) 

{ 

return LocaiRedirect(redirectUrl); 

} 

LocaiRedirect yerel olmayan URL'si belirtilmişse bir özel durum oluşturur. Aksi takdirde, olduğu gibi davranır 
Redirect yöntemi. 


IsLocalUrl 














Kullanım IsLocalUrl URL yeniden yönlendirme önce test etme yöntemi: 

Aşağıdaki örnek, bir URL yeniden yönlendirme önce yerel olup olmadığını denetlemek gösterilmektedir. 

private IActionResult RedirectToLocal(string returnUrl) 

{ 

if (Url.IsLocalUrl(returnUrl)) 

{ 

return Redirect(returnUrl); 

} 

else 

{ 

return RedirectToAction(nameof(HomeController.Index), "Home"); 

} 

} 

IsLocalUrl Yöntemi, kötü amaçlı bir siteye yanlışlıkla yönlendirilen kullanıcıları korur.Yerel olmayan bir URL 
yerel bir URL beklenirken bir durumda sağlandığında sağlanan URL ayrıntılarını oturum açabilirsiniz. Günlüğü 
yeniden yönlendirme URL'lerini yeniden yönlendirme saldırılarını tanılamaya yardımcı olabilir. 


Siteler arası betik kullanmayı (XSS) ASRNET core'da 
engelle 
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Tarafından RickAnderson 

Siteler arası betik (XSS), bir saldırganın istemci tarafı komut dosyalarını (genellikle JavaScript) web sayfalarına 
yerleştirmek sağlayan bir güvenlik açığı var. Diğer kullanıcıların saldırganın komut dosyası çalışma etkilenen 
sayfaları yüklediğinizde, tanımlama bilgileri ve oturum belirteçleri çalmaya saldırgan etkinleştirme DOM işlemesi 
aracılığıyla vveb sayfasının içeriğini değiştirebilir veya tarayıcıyı yeniden yönlendirmek için başka bir sayfa. Bir 
uygulamanın kullanıcı girişini alır ve doğrulama, kodlama veya, kaçış olmadan bir sayfaya çıkarır XSS Güvenlik 
Açıkları genellikle ortaya çıkar. 

Uygulamanızı XSS karşı koruma 

En temel bir düzey XSS çalışır içine ekleyerek uygulamanızı şekilde kandırma tarafından bir <script> etiketi 
ekleyerek veya işlenen sayfanız bir on* olay içine bir öğe. Geliştiriciler kendi uygulamasına XSS önlemek için 
aşağıdaki önleme adımları kullanmalısınız. 

1. Hiçbir zaman aşağıdaki adımları izlemeden sürece güvenilir olmayan verileri, HTML giriş yerleştirin. 

Güvenilir olmayan verileri kontrol edilebilir bir saldırgan, HTML form girişleri, sorgu dizeleri, HTTP 
üstbilgileri, bir saldırganın uygulamanızı ihlal edemiyor olsanız bile, veritabanınızı güvenlik ihlali 
çözebileceğiniz gibi bir veritabanından kaynaklanan bile veri herhangi bir veridir. 

2. HTML öğesi içinde güvenilir olmayan verileri geçirmeden önce kodlanmış HTML olduğundan emin olun. 
HTML kodlaması gereken karakter gibi < ve bunları gibi güvenli bir forma değişiklikleri &lt; 

3. HTML özniteliğin güvenilir olmayan verileri geçirmeden önce kodlanmış HTML olduğundan emin olun. 

HTML öznitelik kodlaması HTML kodlaması bir üst kümesidir ve ek karakterler gibi kodlar "ve 

4. JavaScript ile güvenilir olmayan verileri geçirmeden önce veri içerikleri çalışma zamanında almak bir 
HTML öğesi koyun. Bu mümkün değilse, ardından JavaScript kodlanmış verileri olduğundan emin olun. 
JavaScript kodlama için JavaScript tehlikeli karakterleri alır ve örneğin kendi onaltılık ile değiştirir < olarak 
kodlanması \ueesc . 

5. URL sorgu dizesi içinde güvenilir olmayan verileri geçirmeden önce URL kodlanmış olduğundan emin 
olun. 

Razor kullanarak HTML kodlama 

Razor altyapı MVC'de otomatik olarak kullanılan tüm kodlar gerçekten sabit, bunu önlemek için çalışmıyorsanız 
değişkenlerinden, çıkış kaynağı. Her kullandığınızda HTML öznitelik kodlama kurallarını kullanır.@ yönergesi. 
HTML öznitelik kodlaması, kendiniz, HTML kodlaması veya HTML öznitelik kodlaması kullanmanız gerekir ile 
uğraşmak zorunda olmadığınız anlamına gelir HTML kodlaması bir üst kümesidir. Yalnızca @ HTML bağlamında, 
güvenilmeyen girişler doğrudan JavaScript eklemek değil çalışırken kullanmanızı emin olmanız gerekir. Etiket 
Yardımcıları de giriş etiketi parametrelerinde kullandığınız kodlar. 


Aşağıdaki Razor görünüm uygulayın: 








var untrustedlnput = "<\"123\">"; 

} 

@untrustedlnput 


Bu görünüm içeriğini çıkarır untrustedlnput değişkeni. Bu değişken XSS saldırılarında, yani kullanılan bazı 
karakterler içeren <, "ve >. Kaynak inceleme olarak kodlanmış işlenmiş çıktı gösterir: 



Razor kullanarak JavaScript kodlama 

JavaScript görünümünüzde işlemek için bir değer eklemek istediğiniz zamanlar olabilir. Bunu yapmanın iki yolu 
vardır. Bir veri özniteliği bir etiketin değeri koyun ve, JavaScript dilinde almak için değerleri eklemek için en 
güvenli yolu var. Örneğin: 

@{ 

var untrustedlnput = "<\"123\">"; 

} 

<div 

id="injectedData" 

data-untrustedinput="@untrustedlnput" /> 

<script> 

var injectedData = document.getElementById("injectedData"); 

// Ali clients 

var clientSideUntrustedlnputOldStyle = 

İnjectedData.getAttribute("data-untrustedinput"); 

// HTML 5 clients only 

var clientSideUntrustedInputHtml5 = 

İnjectedData.dataset.untrustedinput; 

document.write(clientSideUntrustedInput01dStyle); 
document.write("<br />") 

document.write(clientSideUntrustedInputHtml5); 

</script> 


Bu aşağıdaki HTML'yi oluşturur 









<div 

id="İnjectedData" 

data-untrustedinput="&lt;&quot;123&quot;&gt;" /> 

<script> 

var injectedData = document.getElementById("injectedData"); 

var clientSidellntrustedlnputOldStyle = 

İnjectedData.getAttribute("data-untrustedinput"); 

var clientSidellntrustedInputHtml5 = 

İnjectedData.dataset.untrustedinput; 

docııment .write(clientSideUntrustedInput01dStyle); 
document.write("<br />") 

document.write(clientSideUntrustedInputHtml5); 

</script> 


Çalıştığında, aşağıdaki şekilde işlenir: 

<"123"> 

<"123"> 


JavaScript Kodlayıcı doğrudan de çağırabilirsiniz: 

@using System.Text.Encodings.Web; 

@inject tavaScriptEncoder encoder; 

@{ 

var untrustedinput = "<\"123\">"; 

} 

<script> 

document.write("@encoder.Encode(untrustedinput)"); 
</script> 


Bu tarayıcıda şu şekilde işlenir: 

<script> 

document .write("\u003C\u0022123\u@022\u003E"); 
</script> 


WARNING 

DOM öğeleri oluşturmak için JavaScript güvenilmeyen girişinde birleştirme yok. Kullanmanız gereken createElement() ve 
özellik değerlerini uygun şekilde aşağıdaki gibi atayabilirsiniz node.Textcontent= , veya element.setAttribute() / 
eiement[attribute]= Aksi takdirde, kendiniz için DOM tabanlı XSS kullanıma. 


Kod kodlayıcılara erişme 

Aracılığıyla ekleyebilir, HTML, JavaScript ve URL kodlayıcılarda kodunuzu iki şekilde kullanılabilir bağımlılık 
ekleme veya içerdiği varsayılan Kodlayıcıları kullanabilirsiniz System. Text.Encodings.web ad alanı, için uygulanan 
tüm sonra varsayılan kodlayıcılarda kullanırsanız güvenli olarak kabul edilmesi için karakter aralıkları 
uygulanmayacak - varsayılan kodlayıcılarda olası güvenli kodlama kurallarını kullanın. 

Dİ, oluşturucu kısa sürecektir aracılığıyla yapılandırılabilir kodlayıcılarda kullanmak için bir HtmlEncoder, 








JavaScriptErıcoder ve UrlErıcoder uygun şekilde parametresi. Örneğin; 

public class HomeController : Controller 
{ 

HtmlEncoder _htmlEncoder; 

JavascriptEncoder _javaScriptErıcoder; 

UrlEncoder _urlEncoder; 

public HomeController(HtmlEncoder htmlEncoder, 

JavaScriptEncoder javascriptEncoder, 
UrlEncoder urlEncoder) 

{ 

_htmlEncoder = htmlEncoder; 

_javaScriptEncoder = javascriptEncoder; 

_urlEncoder = urlEncoder; 

} 


URL parametrelerini kodlama 

URL sorgu dizesi güvenilmeyen giriş olarak bir değer kullanımı ile derlemek istiyorsanız UrlEncoder değeri 
kodlamak için. Örneğin, 

var example = "\"Quoted Value with spaces and 

var encodedValue = _urlEncoder.Encode(example); 

EncodedValue kodladıktan sonra değişken içerecektir % 22 Quoted% 20 Vaiue% 20 with% 20 spaces% 20 and% 20 % 26%22 .Alanları, 
tırnak işaretleri, noktalama işaretleri ve diğer güvenli olmayan karakterleri kendi onaltılı değerine kodlanmış 
yüzde olacaktır, örneğin bir boşluk karakteri % 20 olur. 


VVARNING 

Güvenilmeyen girişler, bir URL yolu bir parçası olarak kullanmayın. Her zaman güvenilmeyen Giriş bir sorgu dizesi değerini 
geçirin. 


Kodlayıcıları özelleştirme 

Varsayılan olarak kodlayıcılar temel Latin Unicode aralığın sınırlı güvenli bir listesini kullanın ve bu aralığın dışında 
tüm karakterleri Karakter kodu eşdeğerlerine olarak kodlayın. Dizelerinizi çıktısını almak için Kodlayıcıları kullanır 
gibi bu davranış, Razor TagHelper ve HtmlHelper işleme de etkiler. 

Bunun ardındaki mantık (önceki tarayıcı hataları İngilizce olmayan karakterleri işleme dayalı ayrıştırma yukarı 
dönüş) bilinmeyen ya da gelecekte tarayıcı hataları karşı korunmasını sağlamaktır. Web sitenizi Çince gibi Latin 
olmayan karakterler ağır olarak kullanan yaparsa Kiril veya başkalarının istediğiniz davranış budur olmayabilir. 

Kodlayıcı güvenli listeleri de aralık uygun uygulamanıza başlatma sırasında Unicode içerecek şekilde 
Özelleştirebilirsiniz ConflgureServices() . 

Örneğin, varsayılan yapılandırmayla bir Razor HtmlHelper kullanıyor olabileceğiniz gibi bunu; 

<p>This link text is in Chinese: @Html.ActionLink("'KİB/;Mln", "Index")</p> 

Kaynak web sayfası görüntülediğinizde gibi kodlanan metnin Çince ile işlendikten görürsünüz; 









<p>This link text is in Chinese: <a href="/">&#x6C49;&#x8BED;/&#x6F22j&#x8A9E;</ax/p> 

Karakter olarak kabul genişletmek için Kodlayıcı tarafından güvenli, aşağıdaki satır içine ekler 
ConfigureServices( ) yönteminde startup.es ; 

Services.AddSingleton<HtmlEncoder>( 

HtmlEncoder.Create(allowedRanges: new[] { UnicodeRanges-BasicLatin, 

UnicodeRanges.CjkUnifiedldeographs })); 

Bu örnekte, Unicode aralığı CjkUnifiedldeographs dahil etmek için güvenli listeye vvidens. işlenen çıkışı artık hale 
gelir 

<p>This link text is in Chinese: <a href="/">5KipV;EIn</ax/p> 

Güvenli listeye aralıkları Unicode kod grafikleri, değil diller belirtilir. Unicode standart listesine sahip kod grafikleri 
, karakterler içeren grafik bulmak için kullanabilirsiniz. Her Kodlayıcı, Html, JavaScript ve Url, ayrı olarak 
yapılandırılması gerekir. 


NOTE 

Güvenli listeye özelleştirmesini yalnızca Dİ kaynaklanan kodlayıcılar etkiler. Bir kodlayıcı aracılığıyla doğrudan erişirseniz 
System.Text. Encodings.web. *Encoder.Default sonra varsayılan olarak, temel Latin yalnızca güvenli liste kullanılır. 


Kodlama Al nereye yerleştirmeniz gerekir? 

Genel Uygulama kodlama çıkış noktasında gerçekleşir ve kodlanmış değerler hiçbir zaman bir veritabanında 
depolanacak kabul edilir. Çıkış noktasında kodlama kullanımı verileri, örneğin, bir sorgu dizesi değeri için HTML 
değiştirmenize izin verir. Ayrıca, arama yapmadan önce değerleri kodlamak zorunda kalmadan verilerinizi kolayca 
aramanızı sağlar ve herhangi bir değişiklik veya hata düzeltmeleri kodlayıcıya yapılan avantajlarından 
yararlanmanıza olanak tanır. 

Bir XSS önleme teknik olarak doğrulama 

Doğrulama XSS saldırılarını sınırlama yararlı bir aracı olabilir.Örneğin, yalnızca 0-9 karakterleri içeren bir sayısal 
dize XSS saldırının tetiklemez. Doğrulama, kullanıcı girişini HTML kabul ederken daha karmaşık hale gelir.HTML 
girişine ayrıştırma, imkansız, zordur. Gömülü HTML şeritler bir ayrıştırıcı ile birlikte, markdown, zengin giriş kabul 
etmek için daha güvenli bir seçenektir. Hiçbir zaman tek başına doğrulamasını kullanır. Her zaman önce hangi 
doğrulama veya temizleme gerçekleştirilen ne olursa olsun çıktı, güvenilmeyen girişler kodlayın. 






ASPNET Core 'de çıkış noktaları arası İstekleri 
(CORS) etkinleştirme 
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Bu makalede, ASP.NET Core uygulamasında CORS 'nin nasıl etkinleştirileceği gösterilmektedir. 

Tarayıcı güvenliği, bir Web sayfasının Web sayfasını sunduğundan farklı bir etki alanına istek yapmasını 
engeller. Bu kısıtlamaya ayrıı-Origin ilkesiad\ verilir. Aynı-kaynak ilkesi, kötü niyetli bir sitenin gizli verileri 
başka bir siteden okumasını engeller. Bazen diğer sitelerin uygulamanıza çapraz çıkış istekleri yapmasına izin 
vermek isteyebilirsiniz. Daha fazla bilgi için bkz. MOZILLA CORS makalesi. 

Çapraz kaynak kaynak paylaşımı (CORS): 

• , Bir sunucunun aynı kaynak ilkeyi rahat bir şekilde sağlamasına izin veren bir W3C standardıdır. 

• Güvenlik özelliği değil , CORS güvenliği. CORS 'nin izin vermesini sağlayan bir API daha güvenli değildir. 
Daha fazla bilgi için bkz. CORS çalışma. 

• Bir sunucunun bazı çapraz kaynak isteklerine, diğerlerini reddetirken açık olarak izin almasına izin verir. 

• , JSONPgibi önceki tekniklerin daha güvenli ve daha esnektir. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Aynı kaynak 

Özdeş şemaları, konakları ve bağlantı noktalarına sahip olmaları durumunda iki URL aynı kaynağa sahiptir 

(RFC 6454). 

Bu iki URL aynı kaynağa sahiptir: 

• https://example.com/foo.html 

• https://example.com/bar.html 

Bu URL 'Ler, önceki iki URL 'den farklı kaynaklardan farklıdır: 

• Farklı etki alanı — https://example.net 

• Farklı alt etki alanı — https://www.example.com/foo.html 

• Farklı — düzeni http://example.com/foo.html 

• Farklı bağlantı noktası - https://example.com:9000/foo.html 

Internet Explorer, kaynakları karşılaştırırken bağlantı noktasını dikkate almaz. 

Adlandırılmış ilke ve ara yazılım ile CORS 

CORS ara yazılımı, çıkış noktaları arası istekleri işler.Aşağıdaki kod, belirtilen kaynağa sahip tüm uygulama 
için CORS 'yi sunar: 









public class Startup 

{ 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

readonly string MyAllowSpecificOrigins = "_myAllowSpecificOrigins"; 

public IConfiguration Configuration { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddCors(options => 

{ 

options.AddPolicy(MyAllowSpecificOrigins, 
builder = > 

{ 

builder.WithOrigins(" http://example.com", 

"http://www.contoso.com"); 

})J 

})J 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseHsts(); 

} 

app.UseCors(MyAllowSpecificOrigins); 

app.UseHttpsRedirection(); 
app.UseMvc(); 

} 

} 


Yukarıdaki kod: 

• ilke adını "_Myallowspecifickaynaklarına" olarak ayarlar, ilke adı rastgele olur. 

• CORS 'yi sağlayan UseCors uzantısı yöntemini çağırır. 

• Lambda ifadesiyleAddCors çağırır. Lambda bir CorsPolicyBuilder nesnesi alır. withOrigins gibi 
yapılandırma seçenekleri, bu makalenin ilerleyen kısımlarında açıklanmıştır. 

AddCors yöntemi çağrısı, uygulamanın hizmet kapsayıcısına CORS Hizmetleri ekler: 




public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddCors(options => 

{ 

options.AddPolicy(MyAllowSpecificOrigins, 
builder => 

{ 

builder.WithOrigins(" http://example.com", 

"http://www.contoso.com "); 

}); 

}); 

Services.AddMvcO.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


Daha fazla bilgi için bu belgedeki CORS ilke seçenekleri bölümüne bakın. 

CorsPolicyBuilder yöntemi aşağıdaki kodda gösterildiği gibi yöntemleri zincirleyebilir: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddCors(options => 

{ 

options.AddPolicy(MyAllowSpecificOrigins, 
builder => 

{ 

builder.WithOrigins(" http://example.com", 

"http://www.contoso.com") 

.AllowAnyHeader() 

.AllowAnyMethod(); 

}); 

}); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

} 

Not: URL sonunda eğik çizgi ( / ) bulunmamalıdır. URL / ile sonlandığında, karşılaştırma faise döndürür 
ve üst bilgi döndürülmez. 

CORS ilkelerini tüm uç noktalara Uygula 

Aşağıdaki kod, CORS ara yazılımı aracılığıyla CORS ilkelerini tüm uygulama uç noktalarına uygular: 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

// Preceding code ommitted. 
app.UseRouting(); 

app.UseCors(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapControllers(); 

}); 

// Following code ommited. 

} 






VVARNING 

Endpoint Routing ile CORS ara yazılımı, useRouting ve useEndpoints çağrıları arasında yürütülecek şekilde 
yapılandırılmalıdır. Yanlış yapılandırma, ara yazılımın doğru çalışmayı durdurmasına neden olur. 


Aşağıdaki kod, CORS ara yazılımı aracılığıyla CORS ilkelerini tüm uygulama uç noktalarına uygular: 

public void Configure(IApplicationBııilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopmentO) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseHsts(); 

} 

app.UseCors(); 

app.UseHttpsRedirection(); 
app.UseMvc(); 

} 

Note: useMvc önce useCors çağrılmalıdır. 

Bu sayfa/denetleyici/eylem düzeyinde CORS ilkesini uygulamak için Razor Pages, denetleyiciler ve eylem 
YÖNTEMLERİNDE CORS 'Yi etkinleştirin konusuna bakın. 

Önceki kodun test edilmesine ilişkin yönergeler için bkz. Test CORS . 

Uç nokta yönlendirme ile CORS 'yi etkinleştirme 

Uç nokta yönlendirme ile CORS, RequireCors uzantı yöntemleri kullanılarak uç nokta temelinde 
etkinleştirilebilir. 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapGet("/echo", async context => context.Response.WriteAsync("echo")) 
.RequireCors("policy-name"); 

}); 


Benzer şekilde, CORS tüm denetleyiciler için de etkinleştirilebilir: 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapControllers().RequireCors("policy-name"); 

})J 


CORS 'yi özniteliklerle etkinleştir 

[enablecors] ÖZ NİTELİĞİ, CORS 'yi küresel olarak uygulamaya bir alternatif sağlar. [EnableCors] özniteliği, 
tüm bitiş noktaları yerine, seçilen bitiş noktaları için CORS 'yi mümkün. 


ilke belirtmek için varsayılan ilkeyi ve [EnabieCors("{Poiicy stning}")] belirtmek için [Enablecors] kullanın. 














[EnableCors] öznitel iği şu şekilde uygulanabilir: 


• Razor sayfası PageModei 

• Denetleyici 

• Denetleyici eylemi yöntemi 

[EnableCors] öznitel iğiyle, denetleyici/sayfa-model/eyleme farklı ilkeler uygulayabilirsiniz. [EnableCors] 
özniteliği bir denetleyiciler/sayfa modeli/eylem yöntemine uygulandığında ve bir ara yazılım içinde CORS 
etkinleştirildiğinde her iki ilke de uygulanır, ilkelerin birleştirilmesi önerilir.Aynı uygulamada değil, 
[EnableCors] özniteliği veya ara yazılımı kullanın. 

Aşağıdaki kod her bir yönteme farklı bir ilke uygular: 

[Route("api/[controller]") ] 

[ApiController] 

public class WidgetController : ControllerBase 

{ 

// GET api/values 
[EnableCors("AnotherPolicy")] 

[HttpGet] 

public ActionResult<IEnumerable<string>> Get() 

{ 

return new string[] { "green widget", "red widget" }; 

} 

// GET api/values/5 

[EnableCors] // Default policy. 

[HttpGet("{id}")] 

public ActionResult<string> Get(int id) 

{ 

switch (id) 

{ 

case 1: 

return "green widget"; 
case 2: 

return "red widget"; 
default: 

return NotFound(); 

} 

} 

} 

Aşağıdaki kod, bir CORS varsayılan ilkesi ve "AnotherPolicy" adlı bir ilke oluşturur: 








public class StartupMultiPolicy 
{ 

public StartupMultiPolicy(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

public void ConfigureServices(IServiceCollection Services) 
{ 

Services.AddCors(options => 

{ 

options.AddDefaultPolicy( 
builder => 

{ 


}); 


builder.WithOrigins(" http://example.com", 

"http://www.contoso.com"); 


options.AddPolicy("AnotherPolicy", 
builder => 

{ 

builder.WithOrigins(" http://www.contoso.com") 
.AllowAnyHeader() 

.AllowAnyMethod(); 

}); 


}); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseMvc(); 

} 

} 


CORS 'yi devre dışı bırak 

[DisableCors] özniteliği denetleyici/sayfa modeli/eylem için CORS 'yi devre dışı bırakır. 

CORS ilke seçenekleri 

Bu bölümde, bir CORS ilkesinde ayarlanmakta olabilecek çeşitli seçenekler açıklanmaktadır: 

• izin verilen kaynakları ayarla 

• izin verilen HTTP yöntemlerini ayarlama 

• izin verilen istek üst bilgilerini ayarlama 

• Gösterilen yanıt üst bilgilerini ayarlama 

• Kaynaklar arası isteklerde kimlik bilgileri 



• Ön kontrol sona erme süresini ayarlama 

AddPolicy startup.configureServices olarak çağrılır. Bazı seçenekler için, ilk olarak CORS 'Nin nasıl çalıştığı 
bölümü okumanız yararlı olabilir. 


İzin verilen kaynakları ayarla 



değildir. 


NOTE 

AllowAnyOr'igin ve AllowCredentials belirtme, güvenli olmayan bir yapılandırmadır ve siteler arası istek elde 
edilmesine yol açabilir. Bir uygulama her iki yöntemle yapılandırıldığında, CORS hizmeti geçersiz bir CORS yanıtı 
döndürür. 


NOTE 

AllowAnyOr'igin ve AllowCredentials belirtme, güvenli olmayan bir yapılandırmadır ve siteler arası istek elde 
edilmesine yol açabilir. Güvenli bir uygulama için, istemcinin sunucu kaynaklarına erişim yetkisi olması gerekiyorsa, 
kaynakların tam bir listesini belirtin. 


AiiowAnyOrigin , ön kontrol isteklerini ve Access-Controi-Aiiow-Origin üst bilgisini etkiler. Daha fazla bilgi için 
bkz. ön kontrol istekleri bölümü. 

SetlsOriginAllowedToAllowWildcardSubdomains -, kaynağın IsOriginAllovved özelliğini, kaynağa izin verilip 
verilmediğini değerlendirirken, kaynağın, yapılandırılan bir joker karakterle eşleştiğinden emin olan bir işlev 
olarak ayarlar. 

options.AddPolicy("AllowSubdomain"j 
builder => 

{ 

builder.WithOrigins("https://*. example.com") 

.SetIsOriginAllowedToAllowWildcardSubdomains(); 

}); 

İzin verilen HTTP yöntemlerini ayarlama 

AllovvAnyMethod: 

• Herhangi bir HTTP yöntemine izin verir: 

• Ön kontrol isteklerini ve Access-controi-Aiiow-Methods üst bilgisini etkiler. Daha fazla bilgi için bkz. ön 

kontrol istekleri bölümü. 

İzin verilen istek üst bilgilerini ayarlama 

Belirli başlıkların, Yazar istek üstbilgileriADL\ bir CORS isteğinde gönderilmesine izin vermek için 
VVİthHeaders çağırın ve izin verilen üst bilgileri belirtin: 












options.AddPolicy("AllowHeaders", 
builder = > 

{ 

builder.WithOrigins(" http://example.com") 

.WithHeaders(HeaderNames .ContentType., "x-custom-header")i 

}); 

Tüm yazar isteği üst bilgilerine izin vermek için AllovvAnyHeaderçağırın: 

options.AddPolicy("AllowAllHeaders"j 
builden => 

{ 

builder.WithOrigins(" http://example.com") 

.AllowAnyHeader(); 

}); 

Bu ayar, ön kontrol isteklerini ve Access-controi-Request-Headers üst bilgisini etkiler. Daha fazla bilgi için bkz. 

ön kontrol istekleri bölümü. 

withHeaders tarafından belirtilen belirli başlıklarıyla eşleşen bir CORS ara yazılım ilkesi, yalnızca 
Access-Control-Request-Headens gönderilen üstbilgiler withHeaders belirtilen üstbilgilere tam olarak 
eşleşiyorsa mümkündür. 

Örneğin, aşağıdaki gibi yapılandırılmış bir uygulamayı göz önünde bulundurun: 

app.UseCors(policy => policy.WithHeaders(HeaderNames.CacheControl)); 

CORS ara yazılımı, Content-Language (Headernames. ContentLanguage) uithHeaders listede olmadığından, şu 
istek üstbilgisiyle bir ön kontrol isteğini reddeder: 

Access-Control-Request-Headers: Cache-Control, Content-Language 

Uygulama 200 ok yanıtı DÖNDÜRÜYOR ancak CORS üst bilgilerini geri göndermez. Bu nedenle tarayıcı, 
çıkış noktaları arası isteği denemez. 

CORS ara yazılımı, CorsPolicy. Headers 1 de yapılandırılan değerlere bakılmaksızın 
Access-contnoi-Request-Headens her zaman dört üst bilgilerin gönderilmesine izin verir. Bu üst bilgi listesi 
şunları içerir: 


Accept 


Accept- 

Language 

Content 

-Language 


• Origin 

Örneğin, aşağıdaki gibi yapılandırılmış bir uygulamayı göz önünde bulundurun: 

app.UseCors(policy => policy.WithHeaders(HeaderNames.CacheControl)); 

Content-Language her zaman beyaz listeye alındığından, CORS ara yazılımı aşağıdaki istek üstbilgisiyle bir ön 
kontrol isteğine başarıyla yanıt veriyor: 

Access-Control-Request-Headers: Cache-Contnol, Content-Language 











Gösterilen yanıt üst bilgilerini ayarlama 

Varsayılan olarak tarayıcı, tüm yanıt üst bilgilerini uygulamaya sunmaz. Daha fazla bilgi için bkz. W3C çıkış 
noktaları arası kaynak paylaşımı (terminoloji): basit yanıt üst bilgisi. 

Varsayılan olarak kullanılabilen yanıt üstbilgileri şunlardır: 

• Cache-Control 

• Content-Language 

• Content-Type 

• Expires 

• Last-Modified 

• Pragma 


CORS belirtimi, bu üst bilgiler basit yanıt üst bilgileriniçağmr. Diğer üst bilgileri uygulama için kullanılabilir 
hale getirmek için WithExposedHeadersçağırın: 

options.AddPolicy("ExposeResponseHeaders ", 
builder => 

{ 

builder.WithOrigins(" http://example.com") 

.WithExposedHeaders("x-custom-header "); 

}); 


Kaynaklar arası isteklerde kimlik bilgileri 

Kimlik bilgileri CORS isteğinde özel işleme gerektirir. Varsayılan olarak tarayıcı, kimlik bilgilerini bir çapraz 
kaynak isteğiyle göndermez. Kimlik bilgileri, tanımlama bilgileri ve HTTP kimlik doğrulama düzenlerini içerir. 
Bir çapraz kaynak isteğiyle kimlik bilgilerini göndermek için, istemcisinin 
true''XMLHttpRequest.withCredentiais ayarlaması gerekir. 

XMLHttpRequest doğrudan kullanarak: 

var xhr = new XMLHttpRequest(); 

xhr.open(’get ’, ' https://www.example.com/api/test ’); 
xhr.withCredentials = true; 


JQuery kullanarak: 

$.ajax({ 

type: 'get ', 

url: 'https://www.example.com/api/test ', 
xhrFields: { 

withCredentials: true 

} 

}); 


Fetch API'sini kullanma: 


fetch(' https://www.example.com/api/test ', { 
credentials: 'include' 

}); 


Sunucu kimlik bilgilerine izin vermelidir.Çıkış noktaları arası kimlik bilgilerine izin vermek için 

AllovvCredentialsçağırın: 







options.AddPolicy("AllowCredentials", 
builder => 

{ 

builder.WithOrigins(" http://example.com") 
.AllowCredentials(); 

}); 


HTTP yanıtı, tarayıcıya sunucunun bir çapraz kaynak isteği için kimlik bilgileri verdiğini bildiren bir 
Access-Control-Allow-Credentials Üst bilgisi içerir. 

Tarayıcı kimlik bilgilerini gönderirse ancak yanıt geçerli bir Access-controi-Aiiow-credentiais üst bilgisi 
içermiyorsa, tarayıcı uygulamaya yanıtı kullanıma sunmaz ve çapraz kaynak isteği başarısız olur. 

Çıkış noktaları arası kimlik bilgilerine izin vermek bir güvenlik riskidir. Başka bir etki alanındaki Web sitesi, 
kullanıcının bilgisi olmadan kullanıcı adına, oturum açmış bir kullanıcının kimlik bilgilerini uygulamaya 
gönderebilir. 

CORS belirtimi Ayrıca, Access-controi-Aiiow-credentiais üst bilgisi varsa, "*" (tüm kaynaklar) için çıkış 
ayarının geçersiz olduğunu belirtir. 

Ön kontrol istekleri 

Bazı CORS istekleri için, tarayıcı gerçek isteği yapmadan önce ek bir istek gönderir. Bu isteğe bir ön kontrol 
ısfeğıdenir. Aşağıdaki koşullar doğruysa tarayıcı, ön kontrol isteğini atlayabilir: 

• istek yöntemi al, HEAD veya POST. 

• Uygulama Accept , Accept-Language , Content-Language , Content-Type veya Last-Event-ID dışındaki istek 
üst bilgilerini ayarlanmamış. 

• Eğer ayarlandıysa Content-Type üst bilgisi aşağıdaki değerlerden birine sahiptir: 
o application/x-www-form-urlencoded 

o multipart/form-data 
o text/plain 

İstemci isteği için ayarlanan istek üst bilgileri kuralı, XMLHttpRequest nesnesine setRequestHeader çağırarak 
uygulamanın ayarladığı üst bilgiler için geçerlidir. CORS belirtimi, bu üst bilgiler Yazar istek üst 
bilgilerini^ ağırır. Kural, tarayıcının ayarlayabilmesi için User-Agent , Hoşt veya Content-Length gibi üstbilgilere 
uygulanmaz. 

Aşağıda bir ön denetim isteğine örnek verilmiştir: 

OPTİONS https://myservice.azur 0 websites.net/api/test HTTP/1.1 
Accept: */* 

Origin: https://myClient.azurewebsites.net 
Access-Control-Request-Method: PUT 

Access-Control-Request-Headers: accept, x-my-custom-header 
Accept-Encoding: gzip, deflate 

User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 6.2; IaI0IaI 64; Trident/6.0) 

Hoşt: myservice.azurewebsites.net 
Content-Length: 0 

Uçuş öncesi isteği HTTP SEÇENEKLERİ yöntemini kullanır.İki özel üst bilgi içerir: 

• Access-Control-Request-Method : gerçek istek için kullanılacak HTTP yöntemi. 

• Access-Cont rol-Request-Headers : uygulamanın gerçek istekte ayarladığı istek üst bilgilerinin bir listesi. Daha 
önce belirtildiği gibi, bu, tarayıcının ayarladığı User-Agent gibi üst bilgileri içermez. 


CORS ön kontrol isteği, sunucuya gerçek istekle gönderilen üstbilgileri belirten bir 














Access-Control-Request-Headers Üst bilgisi içerebilir. 

Belirli üstbilgilere izin vermek için VVİthHeadersçağırın: 

options.AddPolicy("AllowHeaders ", 
builder = > 

{ 

builder.WithOrigins("http://example.com") 

. WithHeaders(HeaderNames .ContentType., "x-custom-header"); 

}); 


Tüm yazar isteği üst bilgilerine izin vermek için AllovvAnyHeaderçağırın: 

options.AddPolicy("AllowAllHeaders ", 
builder => 

{ 

builder.WithOrigins(" http://example.com") 

.AllowAnyHeader(); 

})J 

Tarayıcılar, Access-controi-Request-Headers nasıl ayarlandıklarından tamamen tutarlı değildir. Üst bilgileri 
dışında bir şeye ayarlarsanız (veya AllowAnyHeaderkullanıyorsanız), en az Accept , Content-Type ve origin , 
ayrıca desteklemek istediğiniz tüm özel üstbilgileri dahil etmelisiniz. 

Aşağıda, ön kontrol isteğine örnek bir yanıt verilmiştir (sunucunun isteğe izin verdiği varsayıldığında): 

HTTP/1.1 200 OK 
Cache-Control: no-cache 
Pragma: no-cache 
Content-Length: 0 

Access-Control-Allow-Origin: https://myclient.azurewebsites.net 
Access-Control-Allow-Headers: x-my-custom-header 
Access-Control-Allow-Methods: PUT 
Date: Wed, 20 May 2015 06:33:22 GMT 


Yanıt, izin verilen üst bilgileri listeleyen, izin verilen yöntemleri ve isteğe bağlı olarak bir 
Access-controi-Aiiow-Headers üstbilgisini listeleyen bir Access-controi-Aiiow-Methods üst bilgisi içerir. Ön 
kontrol isteği başarılı olursa, tarayıcı gerçek isteği gönderir. 

Ön kontrol isteği reddedilirse, uygulama 200 ok yanıtı döndürür ancak CORS üst bilgilerini geri göndermez. 
Bu nedenle tarayıcı, çıkış noktaları arası isteği denemez. 

Ön kontrol sona erme süresini ayarlama 

Access-controi-Max-Age üstbilgisi, ön kontrol isteğine olan yanıtın ne kadar süreyle önbelleğe alınacağını 
belirtir. Bu üstbilgiyi ayarlamak için SetPreflightMaxAgeçağırın: 

options.AddPolicy("SetPreflightExpiration", 
builder => 

{ 

builder.WithOrigins(" http://example.com") 

.SetPreflightMaxAge(TimeSpan.FromSeconds(2520)); 

}); 


CORS nasıl kullanılır? 


Bu bölümde, HTTP iletileri düzeyindeki bir CORS isteğinde ne olacağı açıklanmaktadır. 













• CORS bir güvenlik özelliği değil . CORS, bir sunucunun aynı kaynaklı ilkeyi rahat bir şekilde sağlamasına 
izin veren bir W3C standardıdır. 

o Örneğin, kötü niyetli bir aktör sitenize karşı siteler arası komut dosyalarını (XSS) engelliyor ve 
bilgileri çalmak için CORS özellikli sitesine bir siteler arası istek yürütebilir. 

• CORS 'nin izin vermesini sağlayan API 1 niz daha güvenli değildir. 

o CORS 'yi zorlamak için istemciye (tarayıcı) sahiptir.Sunucu isteği yürütür ve yanıtı döndürür. Bu, bir 
hatayı döndüren ve yanıtı engelleyen istemedir. Örneğin, aşağıdaki araçlardan herhangi birinde 
sunucu yanıtı görüntülenir: 
o Fiddler 
o Postman 
o .NET HttpClient 

o Adres çubuğuna URL girerek bir Web tarayıcısı. 

• Bir sunucu, tarayıcıların çapraz kaynak XHR veya Fetch API isteği çalıştırmasına izin vermesinin yasaktır bir 
yoludur. 

o Tarayıcılar (CORS olmadan), çapraz kaynak istekleri yapamıyor.CORS 'den önce, bu kısıtlamayı 
aşmak için JSONP kullanılmıştır. JSONP XHR kullanmaz, yanıtı almak için <script> etiketini 
kullanır. Betiklerin, çapraz kaynak olarak yüklenmesine izin verilir. 

CORS belirtimi , çıkış noktaları arası istekleri etkinleştiren birkaç yeni http üst bilgisi sunmuştur. Bir tarayıcı 
CORS 'yi destekliyorsa, bu üst bilgileri, çıkış noktaları arası istekler için otomatik olarak ayarlar. CORS 'yi 
etkinleştirmek için özel JavaScript kodu gerekli değildir. 

Aşağıda, bir çapraz kaynak isteğine bir örnek verilmiştir, origin üstbilgisi, isteği yapan sitenin etki alanını 
sağlar, origin üst bilgisi gereklidir ve konaktan farklı olmalıdır. 

GET https://myservice.azurewebsites.net/api/test HTTP/1.1 
Referer: https://myclient.azurewebsites.net/ 

Accept: */* 

Accept-Language: en-US 

Origin: https://myClient.azurewebsites.net 
Accept-Encoding: gzip, deflate 

User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 6.2; I/J0I/J64; Trident/6.0) 

Hoşt: myservice.azurewebsites.net 

Sunucu isteğe izin veriyorsa, yanıtta Access-Controi-Aiiow-Origin üst bilgisini ayarlar. Bu üstbilginin değeri, 
istekten origin üst bilgisiyle eşleşir veya joker değerdir, yani herhangi bir kaynağa izin verilir. 

HTTP/1.1 200 OK 
Cache-Control: no-cache 
Pragma: no-cache 

Content-Type: text/plain; charset=utf-8 

Access-Control-Allow-Origin: https://myclient.azurewebsites.net 
Date: Wed, 20 May 2015 06:27:30 GMT 
Content-Length: 12 

Test message 

Yanıt Access-Cont rol-Aiiow-Origin üst bilgisini içermiyorsa, çapraz kaynak isteği başarısız olur. Özellikle, 
tarayıcı isteğe izin vermez. Sunucu başarılı bir yanıt döndürse bile tarayıcı, yanıtı istemci uygulama için 
kullanılabilir hale getirir. 


Test CORS 


CORS 'yi sınamak için: 










1. BİR API projesi oluşturun. Alternatif olarak, örneği de indirebilirsiniz. 

2. Bu belgedeki yaklaşımlardan birini kullanarak CORS 'yi etkinleştirin. Örneğin: 


public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseHsts(); 

} 

// Shows UseCons with CorsPolicyBuilden. 
app.UseCors(builder => 

{ 

builder.WithOrigins(" http://example.com", 

"http://www.contoso.com", 

"https://localhost:44375", 
"https://localhost:5001"); 

}); 

app.UseHttpsRedirection(); 
app.UseMvc(); 


WARNING 

withorlgins("https://localhost:<port>"); , yalnızca indirme örnek kodunabenzer bir örnek uygulamanın test 
edilmesi için kullanılmalıdır. 


1. Web uygulaması projesi (Razor Pages veya MVC) oluşturun. Örnek Razor Pages kullanır. Web 
uygulamasını, API projesiyle aynı çözümde oluşturabilirsiniz. 

2. Aşağıdaki Vurgulanan kodu lndex. cshtml dosyasına ekleyin: 





@page 

@model IndexModel 

@{ 

ViewData["Title"] = "Home page"; 

} 

<div class="text-center"> 

<hl class="display-4">C0RS Test</hl> 

</div> 

<div> 

<input type="button" value="Test" 

onclick="requestVal('https://<web app>.azurewebsites.net/api/values')" /> 

<span id='result'></span> 

</div> 

<script> 

function requestVal(uri) { 

const resultSpan = document,getElementById('result'); 
fetch(uri) 

.then(response => response.json()) 

.then(data => resultSpan.innerText = data) 

.catch(error => resultSpan.innerText = 'See F12 Console for error'); 

} 

</script> 

1. Yukarıdaki kodda url: 'https://<web appx.azurewebsites.net/api/vaiues/!', , dağıtılan uygulamanın 
URL 'siyle değiştirin. 

2. API projesini dağıtın. Örneğin, Azure 'a dağıtın. 

3. Razor Pages veya MVC uygulamasını masaüstünden çalıştırın ve Test düğmesine tıklayın. Hata 
iletilerini gözden geçirmek için F12 araçlarını kullanın. 

4. withOrigins 'ten localhost kaynağını kaldırın ve uygulamayı dağıtın. Alternatif olarak, istemci 
uygulamasını farklı bir bağlantı noktasıyla çalıştırın. Örneğin, Visual Studio 'dan çalıştırın. 

5. istemci uygulamasıyla test edin. CORS hataları bir hata döndürüyor, ancak hata iletisi JavaScript için 
kullanılabilir değil. Hatayı görmek için Fi 2 araçlarındaki konsol sekmesini kullanın. Tarayıcıya bağlı 
olarak, aşağıdakine benzer bir hata alırsınız (F12 araçları konsolunda): 

• Microsoft Edge i kullanarak: 

SEC7120: [CORS] kaynak https://iocaihost:44375 , 

https://webapi.azurewebsites.net/api/values/ı konumundaki çapraz kaynak kaynağı için 
Access-Control-Allovv-Origin yanıt üstbilgisinde https://localhost:44375 bulamadı 

• Chrome kullanarak: 

https: //localhost:44375 kaynaktan https: //webapi.azurewebsites.net/api/values/1 

konumundaki XMLHttpRequest erişimi CORS ilkesi tarafından engellendi: İstenen 
kaynakta hiçbir ' erişim-denetim-Izin-Origin ' üst bilgisi yok. 

CORS özellikli uç noktalar Fiddler veya Postmangibi bir araçla test edilebilir. Bir araç kullanırken, origin 
üstbilgisi tarafından belirtilen isteğin kaynağı isteği alan konaktan farklı olmalıdır, istek, origin üst bilgisinin 
değerine göre Çıkış dışı değilse: 

• CORS ara yazılımı için isteği işleme gereksinimi yoktur. 

• CORS üstbilgileri yanıtta döndürülmedi. 











Ek kaynaklar 

• Çıkış noktaları arası kaynak paylaşımı (CORS) 


ASPNET uygulamaları arasında kimlik doğrulama 
tanımlama bilgilerini paylaşma 

6.09.2019 • 9 minutes to read ı Edit Online 


Tarafından Rick Anderson ve Luke Latham 

Web siteleri genellikle birlikte çalışan ayrı Web uygulamalarından oluşur.Çoklu oturum açma (SSO) deneyimi 
sağlamak için, bir site içindeki Web uygulamaları kimlik doğrulama tanımlama bilgilerini paylaşmalıdır. Bu 
senaryoyu desteklemek için, veri koruma yığını, Katana tanımlama bilgisi kimlik doğrulaması ve ASP.NET Core 
tanımlama bilgisi kimlik doğrulama biletlerinin paylaşılmasını sağlar. 

Aşağıdaki örneklerde: 

• Kimlik doğrulama tanımlama bilgisi adı, ortak bir değerine .AspNet.sharedCookie ayarlanır. 

• , AuthenticationType Açıkça ya identity.Application da varsayılan olarak ayarlanır. 

• Veri koruma sisteminin veri koruma anahtarlarını ( shanedCookieApp ) paylaşmasını sağlamak için ortak bir 
uygulama adı kullanılır. 

• identity.Application , kimlik doğrulama düzeni olarak kullanılır. Hangi düzenin kullanıldığı, her ne kadar 
paylaşılan tanımlama bilgisi uygulamalarmda, varsayılan düzen olarak, ya da açıkça ayarlanarak kullanılması 
gerekir. Şema, tanımlama bilgilerini şifrelerken ve şifresini çözerken kullanılır, bu nedenle uygulamalar arasında 
tutarlı bir düzenin kullanılması gerekir. 

• Ortak bir veri koruma anahtarı depolama konumu kullanılır. 

o ASP.NET Core uygulamalarda, PersistKeysToFileSystem anahtar depolama konumunu ayarlamak için 
kullanılır. 

o ,N ET Framevvork uygulamalarda, tanımlama bilgisi kimlik doğrulama ara yazılımı, uygulamasının 
DataProtectionProviderbir uygulamasını kullanır. Dataprotectionprovider kimlik doğrulama tanımlama 
bilgisi yük verilerinin şifrelenmesi ve şifresinin çözülmesi için veri koruma hizmetleri sağlar. 
DataProtectionProvider Örnek, uygulamanın diğer bölümleri tarafından kullanılan veri koruma 
sisteminden yalıtılmıştır. Dataprotectionprovider. Create (System. 10. Directorylnfo, 
Action<ıdataprotectionbuilder >), veri Directorylnfo koruma anahtarı depolamanın konumunu 
belirtmek için bir değerini kabul eder. 

• Dataprotectionprovider Microsoft. AspNetCore. DataProtection. Extensions NuGet paketini gerektirir: 
o ASP.NET Core 2. x uygulamalarında Microsoft. AspNetCore. app metapackageöğesine başvurun, 
o .NET Framevvork uygulamalar 1 da Microsoft. AspNetCore. DataProtection. Extensions'a bir paket 

başvurusu ekleyin. 

• SetApplicationNameortak uygulama adını ayarlar. 

Kimlik doğrulama tanımlama bilgilerini ASP.NET Core kimlikle paylaşma 

ASP.NET Core kimliği kullanılırken: 

• Veri koruma anahtarlarının ve uygulama adının uygulamalar arasında paylaşılması gerekir. Aşağıdaki 
örneklerde PersistKeysToFileSystem yöntemine ortak bir anahtar depolama konumu verilmiştir. Ortak 
SetApplicationName bir paylaşılan uygulama adı yapılandırmak için kullanın ( sharedCookieApp aşağıdaki 
örneklerde). Daha fazla bilgi için bkz. AS P.N ET Core veri korumasını yapılandırma. 

• Tanımlama bilgileri için veri koruma hizmetini ayarlamak üzere 
genişletmeyönteminikullanm.ConfigureApplicationCookie 

• Varsayılan kimlik doğrulama türü identity.Application . 












İçinde Startup.ConfigureServices 


Services. AddDataProtection() 

.PersistKeysToFileSystem("{PATH TO COMMON KEY RİNG FOLDER}") 
.SetApplicationName("SharedCookieApp"); 

Services.ConfigureApplicationCookie(options => { 
options.Cookie.Name = ".AspNet.SharedCookie"; 

}); 


Kimlik doğrulama tanımlama bilgilerini ASP.NET Core kimlik olmadan 
paylaşma 

Tanımlama bilgilerini ASP.NET Core kimlik olmadan doğrudan kullanırken,' de Startup.ConfigureServices veri 
korumayı ve kimlik doğrulamasını yapılandırın. Aşağıdaki örnekte, kimlik doğrulama türü olarak 
identity.Application ayarlanır: 

Services.AddDataProtection() 

.PersistKeysToFileSystem("{PATH TO COMMON KEY RİNG FOLDER}") 

.SetApplicationName("SharedCookieApp"); 

Services.AddAuthentication("Identity.Application") 

.AddCookie("Identity.Application", options => 

{ 

options.Cookie.Name = ".AspNet.SharedCookie"; 

}); 


Farklı temel yollarda tanımlama bilgilerini paylaşma 

Bir kimlik doğrulama tanımlama bilgisi, HttpRequest. PathBase öğesini varsayılan Cookie. Patholarak kullanır. 
Uygulamanın tanımlama bilgisinin farklı temel yollarda paylaşılması gerekiyorsa, Path geçersiz kılınmalıdır: 

Services.AddDataProtection() 

.PersistKeysToFileSystem("{PATH TO COMMON KEY RİNG FOLDER}") 

.SetApplicationName("SharedCookieApp"); 

Services.ConfigureApplicationCookie(options => { 
options.Cookie.Name = ".AspNet.SharedCookie"; 
options.Cookie.Path = "/"; 

}); 


Alt etki alanları genelinde tanımlama bilgilerini paylaşma 

Etki alanları arasında tanımlama bilgilerini paylaşan uygulamalar barındırırken, Cookie. Domain özelliğinde ortak 
bir etki alanı belirtin, first_subdomain.contoso.com contoso.com Cookie.Domain Ve 
gibiuygulamalararasmdatammlamabilgilerinipaylaşmak second_subdomain.contoso.com için şunu belirtin: 

. contoso.com 

options.Cookie.Domain = ".contoso.com"; 


Bekleyen veri koruma anahtarlarını şifreleyin 


Üretim dağıtımları için, 1 yi DataProtectionProvider , geri kalan anahtarları DPAPI veya X509Certificate ile 









şifrelemek üzere yapılandırın. Daha fazla bilgi için bkz. AS P.N ET core'da bekleme durumunda anahtar şifreleme. 
Aşağıdaki örnekte, için ProtectKeysVVİthCertificatebir sertifika parmak izi sağlanır: 

Services.AddDataProtection() 

.ProtectKeysWithCertificate("{CERTIFICATE THUMBPRINT}"); 


ASP.NET 4. x ve ASP.NET Core uygulamaları arasında kimlik doğrulama 
tanımlama bilgilerini paylaşma 

Katana tanımlama bilgisi kimlik doğrulama ara yazılımı kullanan ASP.NET 4. x uygulamaları ASP.NET Core 
tanımlama bilgisi kimlik doğrulama ara yazılımı ile uyumlu kimlik doğrulama tanımlama bilgileri oluşturacak 
şekilde yapılandırılabilir. Bu, site genelinde sorunsuz bir SSO deneyimi sağlarken, büyük bir sitenin ayrı 
uygulamalarının çeşitli adımlarda yükseltilmesini sağlar. 

Bir uygulama, Katana tanımlama bilgisi kimlik doğrulama ara yazılımı kullandığında useCookieAuthentication , 
projenin Startup.auth.es dosyasında çağırır. Visual Studio 2013 ve sonraki sürümlerde oluşturulan ASP.NET 4. x 
Web uygulaması projeleri varsayılan olarak Katana tanımlama bilgisi kimlik doğrulama ara yazılımını kullanır. 
ASP.NET Core UseCookieAuthentication uygulamalar için artık kullanılmıyor ve desteklenmese de, 
UseCookieAuthentication Katana tanımlama bilgisi kimlik doğrulama ara yazılımı kullanan bir AS P.N ET 4. x 
uygulamasında çağırma geçerlidir. 

ASP.NET 4. x uygulaması .N ET Framevvork 4.5.1 veya üstünü hedeflemelidir.Aksi takdirde, gerekli NuGet paketleri 
yüklenemeyebilir. 

Bir ASP.NET 4. x uygulaması ve bir AS P.N ET Core uygulaması arasında kimlik doğrulama tanımlama bilgilerini 
paylaşmak için, AS P.N ET Core uygulamayı AS P.N ET Core uygulamalar arasında kimlik doğrulama tanımlama 
bilgilerini paylaşma bölümünde belirtilen şekilde yapılandırın ve ardından ASP.NET 4. x uygulamasını aşağıdaki 
şekilde yapılandırın. 

Uygulamanın paketlerinin en son sürümlere güncelleştirildiğinden emin olun. Microsoft. Ovvin. Security. Interop 
paketini her bir ASP.NET 4. x uygulamasına yükler. 

Çağrısını bulun ve değiştirin UseCookieAuthentication : 

• Tanımlama bilgisi adını ASP.NET Core tanımlama bilgisi kimlik doğrulama ara yazılımı ( .AspNet.sharedCookie 
örnekteki) tarafından kullanılan adla eşleşecek şekilde değiştirin. 

• Aşağıdaki örnekte, kimlik doğrulama türü olarak identity.Application ayarlanır. 

• Başlatılmış bir DataPnotectionPnoviden örneğini ortak veri koruma anahtarı depolama konumu olarak belirtin. 

• Uygulama adının, kimlik doğrulama tanımlama bilgilerini paylaşan tüm uygulamalar tarafından kullanılan ortak 
uygulama adına ayarlandığını onaylayın ( sharedCookieApp örnekte). 

UniqueClaimTypeldentifier Ve http://sehemas .xmisoap.org/ws/ 2005 / 05 /identity/ciaims/nameidentifier 
ayarlamadıysanız,benzersizkullanıcılarıayırtedenbir 

http://schemas.microsoft.com/accesscontrolservice/2010/07/claims/identityprovider talep olarak ayarlayın. 


App_Start/Startup. auth. cs: 











app.UseCookieAuthentication(new CookieAuthenticationOptions 

{ 

AuthenticationType = "Identity.Application", 

CookieName = ".AspNet.SharedCookie", 

LoginPath = new PathString("/Account/Login"), 

Provider = new CookieAuthenticationProvider 

{ 

OnValidateldentity = 

SecurityStampValidator 

.OnValidateldentitycApplicationUserManager, ApplicationUser'>( 
validatelnterval: TimeSpan.FromMinutes(30), 
regenerateldentity: (manager, user) => 

user.GenerateUserldentityAsync(manager)) 

b 

TicketDataFormat = new AspNetTicketDataFormat( 
new DataPnotectorShim( 

DataProtectionProviden.Create("{PATH TO COMMON KEY RİNG FOLDER}", 
(builder) => { builder.SetApplicationName("SharedCookieApp"); }) 
.CreateProtector( 

"Microsoft. AspNetCore. Authentication .Cookies. " + 
"CookieAuthenticationMiddleware", 

"Identity.Application", 

"v2"))), 

CookieManager = new ChunkingCookieManager() 


System.Web.Helpers.AntiForgeryConfig.UniqueClaimTypeIdentifier = 
"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name"; 

Bir kullanıcı kimliği oluştururken, kimlik doğrulama türü ıdentity.Application (), App_Start/Startup. auth. csiçinde 
ile useCookieAut hent icat ion set içinde AuthenticationType tanımlanan türle eşleşmelidir. 

Modeller/Ldentitymodeller. cs: 

public class ApplicationUser : IdentityUser 

{ 

public async Task<ClaimsIdentity> GenerateUserIdentityAsync( 

UserManager<ApplicationUser» manager) 

{ 

// The authenticationType must match the one defined in 
// CookieAuthenticationOptions.AuthenticationType 
var userldentity = 

await manager.CreateIdentityAsync(this, "Identity.Application"); 

// Add custom user claims here 
return userldentity; 

} 

} 


Ortak bir kullanıcı veritabanı kullan 

Uygulamalar aynı kimlik şemasını (kimlik sürümü) kullandıklarında, her bir uygulama için kimlik sisteminin aynı 
kullanıcı veritabanına işaret olduğunu doğrulayın. Aksi halde kimlik sistemi, kimlik doğrulama tanımlama 
bilgisindeki bilgileri veritabanındaki bilgilere göre eşleştirmeye çalıştığında çalışma zamanında hatalara neden olur. 

Kimlik şeması, uygulamalar arasında farklı olduğunda, genellikle uygulamalar farklı kimlik sürümleri 
kullandığından, en son kimlik sürümüne göre ortak bir veritabanının paylaşılması, yeniden eşleştirmeden ve diğer 
uygulamanın kimlik şemalarına sütun eklemeden mümkün değildir. Yaygın bir veritabanının uygulamalar 
tarafından paylaşılabilmesi için diğer uygulamaları en son kimlik sürümünü kullanacak şekilde yükseltmek 
genellikle daha etkilidir. 






Ek kaynaklar 

• Web çiftliğinde AS P.N ET Core ana bilgisayar 


ASPNET Core 1 de SameSite tanımlama bilgileriyle 
çalışma 

4.12.2019 • 12 minutes to read^ Edit Online 


Rick Anderson tarafından 

SameSite , siteler arası istek sahteciliği (CSRF) saldırılarına karşı bir koruma sağlamak için tasarlanmış bir IETF 
taslağının olması. SameSite 2019 taslağı: 

• Tanımlama bilgilerini varsayılan olarak sameSite=Lax olarak değerlendirir. 

• Siteler arası teslimin etkinleştirilmesi için sameSite=ı\ione açıkça onaylama tanımlama bilgileri secure olarak 
işaretlenmelidir. 

Lax çoğu uygulama tanımlama bilgisi için geçerlidir. OpenlD Connect (OIDC) ve WS-Federation gibi bazı kimlik 
doğrulama biçimlerinden biri, temel yönlendirmeye gönderi sağlar. POST tabanlı yeniden yönlendirmeler, 
SameSite tarayıcı korumalarının tetiklenmesi, bu nedenle bu bileşenler için SameSite devre dışı bırakıldı. Çoğu 
OAuth oturum açma, istek akışının farklılığı nedeniyle etkilenmez. 

None parametresi, önceki 2016 taslak standardını uygulayan istemcilerle uyumluluk sorunlarına neden olur 
(örneğin, İOS 12). Bkz. bu belgede eski tarayıcıları destekleme . 

Tanımlama bilgilerini gösteren her bir ASP.NET Core bileşeni, SameSite ' ın uygun olup olmadığına karar 
vermeniz gerekir. 

SameSite ile API kullanımı 

PlttpContext. Response. Cookies. Append varsayılan olarak unspecified , yani tanımlama bilgisine hiçbir SameSite 
özniteliği eklenmez ve istemci varsayılan davranışını kullanır (eski tarayıcılarda olmayan, yeni tarayıcılar İçin LAX). 
Aşağıdaki kod, tanımlama bilgisi SameSite değerinin sameSiteMode.Lax olarak nasıl değiştirileceğini gösterir: 

HttpContext.Response.Cookies.Append( 

"name", "value", 

new CookieOptions() { SameSite = SameSiteMode.Lax }); 

Tanımlama bilgilerini sunan tüm ASP.NET Core bileşenleri, önceki varsayılan değerleri, senaryoları için uygun 
ayarlarla geçersiz kılar. Geçersiz kılınan önceki varsayılan değerler değişmemiştir. 
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ASP.NET Core 3,1 ve üzeri, aşağıdaki SameSite desteğini sağlamaktadır: 

• sameSite=None göstermek için sameSiteMode.None davranışını tekrar tanımlar 

• SameSite özniteliğini atlamak için SameSiteMode.unspecified yeni bir değer ekler. 

• Tüm tanımlama bilgileri API 'Leri unspecified için varsayılan. Tanımlama bilgilerini kullanan bazı bileşenler, 
senaryolarına daha özel değerler ayarlar. Örnekler için yukarıdaki tabloya bakın. 

ASP.N ET Core 3,0 ' de ve sonraki sürümlerde, tutarsız istemci varsayılanlarıyla çakışmadan kaçınmak için 
SameSite Varsayılanları değiştirilmiştir. Aşağıdaki API 'Ler, bu tanımlama bilgileri için bir SameSite özniteliği 
yaymamak üzere varsayılan değer olan SameSiteMode. Lax -ı olarak değiştirmiştir: 

• CookieOptions HttpContext. Response. Cookies. Append ile kullanılır 

• CookieOptions için fabrika olarak kullanılan CookieBuilder 

• Pişirme lepolicyoptions. MinimumSameSitePolicy 

Geçmiş ve değişiklikler 

SameSite desteği ilk olarak 2016 taslak standardıkullanılarak 2,0 1 de ASP.NET Core uygulanmıştır.2016 standardı 
kabul edildi. ASP.NET Core, Lax varsayılan olarak birkaç tanımlama bilgisi ayarlayarak kabul edildi. Kimlik 
doğrulaması ile ilgili birkaç sorunla karşılaşduktan sonra, en fazla site kullanımı devre dışı bırakıldı. 

Kasım 2019 1 de 2016 standartdan 2019 standardına güncelleştirme için düzeltme ekleri yayınlandı. SameSite 
belirtiminin 2019 taslağı: 

• ,2016 taslağı ile geriye dönük olarak uyumlu değildir . Daha fazla bilgi için bu belgede eski tarayıcıları 
destekleme bölümüne bakın. 

• Tanımlama bilgilerinin varsayılan olarak sameSite=Lax olarak değerlendirilip değerlendirilmediğini belirtir. 

• Siteler arası teslimin etkinleştirilmesi için sameSite=ı\ione açıkça onaylama tanımlama bilgilerini belirtir secure 
olarak işaretlenmelidir. None , kabul etmek için yeni bir giriştir. 

• ASP.NET Core 2,1,2,2 ve 3,0 için verilen düzeltme ekleri tarafından desteklenir.ASP.NET Core 3,1, ek 
SameSite desteğine sahiptir. 

• , Şubat 2020' de varsayılan olarak Chrome tarafından etkinleştirilmek üzere zamanlanır. Tarayıcılar 2019 içinde 
bu standarda geçmeyi başlattı. 


















2016 SameSite taslak standartındaki değişiklikten etkilenen API 'Ler 
2019 taslak standardına 


• Http. SameSiteMode 

• Pişirme leoptions. SameSite 

• Pişirme lebuilder. SameSite 

• Pişirme lepolicyoptions. MinimumSameSitePolicy 

• M icrosoft.N et. Http.Headers.SameSiteMode 

• M icrosoft.N et.Http.Headers.S etC ookieHeaderValue.SameS ite 

Eski tarayıcıları destekleme 

2016 SameSite Standard uygulanan, bilinmeyen değerlerin samesite=strict değer olarak değerlendirilmelidir. 

201 6 SameSite standardını destekleyen eski tarayıcılardan erişilen uygulamalar, bir None değeri olan bir SameSite 
özelliği edindiklerinde kesintiye uğramayabilir. Web uygulamaları, eski tarayıcıları desteklemek istiyorlarsa, tarayıcı 
algılaması gerçekleştirmelidir. AS P.N ET Core tarayıcı algılamayı uygulamaz, çünkü kullanıcı aracıları değerleri 
yüksek ölçüde geçici ve sık sık değiştirilir. Microsoft.AspNetCore.CookiePolicy bir uzantı noktası, kullanıcı aracısına 
özgü mantığa göre takmayı sağlar. 

startup.configure , UseAuthentication veya tanımlama bilgilerini yazan herhangi bir yöntemi çağırmadan önce 
UseCookiePolicy çağıran kodu ekleyin: 

public void Configure(IApplicationBuilder app, IWebHostEnvironment env) 

{ 

if (env.IsDevelopmentO) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 

app.UseRoutingO; 

app.UseCookiePolicy(); 
app.UseAuthentication(); 
app.UseAuthorization(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapRazorPages(); 

})J 

} 

startup.Configureservices , aşağıdakine benzer bir kod ekleyin: 





public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

options.MinimumSameSitePolicy = SameSiteMode.Unspecified; 
options.OnAppendCookie = cookieContext => 

CheckSameSite(cookieContext.Context , cookieContext.CookieOptions); 
options.OnDeleteCookie = cookieContext => 

CheckSameSite(cookieContext.Context , cookieContext.CookieOptions); 

}); 

Services.AddRazorPages(); 

} 

private void CheckSameSite(HttpContext httpContextj CookieOptions options) 

{ 

if (options.SameSite == SameSiteMode.None) 

{ 

var userAgent = httpContext.Request.Headers["User-Agent"] .ToStringO; 
if (MyUserAgentDetectionLib.DisallowsSameSiteNone(userAgent)) 

{ 

options.SameSite = SameSiteMode.Unspecified; 

} 

} 

} 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

options.MinimumSameSitePolicy = (SameSiteMode)(-1); 
options.OnAppendCookie = cookieContext => 

CheckSameSite(cookieContext.Context , cookieContext.CookieOptions); 
options.OnDeleteCookie = cookieContext => 

CheckSameSite(cookieContext.Context , cookieContext.CookieOptions); 

}); 

Services.AddRazorPages(); 

} 

private void CheckSameSite(HttpContext httpContextj CookieOptions options) 

{ 

if (options.SameSite == SameSiteMode.None) 

{ 

var userAgent = httpContext.Request.Headers["User-Agent"] .ToStringO; 
if (MyUserAgentDetectionLib.DisallowsSameSiteNone(userAgent)) 

{ 

options.SameSite = (SameSiteMode)(-l); 

} 

} 

} 

Yukarıdaki örnekte MyUserAgentDetectionLib.DisallowsSameSiteNone , Kullanıcı aracısının SameSite None 
desteklemeymediğini algılayan Kullanıcı tarafından sağlanan bir kitaplıktır: 

if (MyUserAgentDetectionLib.DisallowsSameSiteNone(userAgent)) 

{ 

options.SameSite = SameSiteMode.Unspecified; 

} 


Aşağıdaki kod bir örnek DisaiiowsSameSiteNone yöntemi gösterir: 






VVARNING 

Aşağıdaki kod yalnızca tanıtım amaçlıdır: 

• Tamamlanmış olarak düşünülmemelidir. 

• Korunmaz veya desteklenmez. 


public static bool DisallowsSameSiteNone(string userAgent) 

{ 

// Cover ali İOS based browsers here. This includes: 

// - Safari on İOS 12 for İPhone, iPod Touch, iPad 
// - WkWebview on İOS 12 for İPhone, İPod Touch, İPad 
// - Chrome on İOS 12 for İPhone, İPod Touch, İPad 

// Ali of which are broken by SameSite=None, because they use the İOS networking 
// stack. 

if (userAgent.Contains("CPU İPhone OS 12") || 
userAgent.Contains("iPad; CPU OS 12")) 

{ 

return true; 

} 

// Cover Mac OS X based browsers that use the Mac OS networking stack. 

// This includes: 

// - Safari on Mac OS X. 

// This does not include: 

// - Chrome on Mac OS X 

// Because they do not use the Mac OS networking stack. 
if (userAgent.Contains("Macintosh; Intel Mac OS X 10_14") && 

userAgent.Contains("Version/") && userAgent.Contains("Safari")) 

{ 

return true; 

} 

// Cover Chrome 50-69, because some versions are broken by SameSite=None, 

// and none in this range require it. 

// Note: this covers some pre-Chromium Edge versions, 

// but pre-Chromium Edge does not require SameSite=None. 
if (userAgent.Contains("Chrome/5") || userAgent.Contains("Chrome/6")) 

{ 

return true; 

} 

return false; 

} 


SameSite sorunları için test uygulamaları 

Üçüncü taraf oturum açma bilgileri gibi uzak sitelerle etkileşim kuran uygulamalar şunlar gerekir: 

• Etkileşimi birden çok tarayıcıda test edin. 

• Bu belgede ele alınan lebpolicy tarayıcı algılamasını ve hafifletme işlemini uygulayın. 

Yeni SameSite davranışını kabul edebilir bir istemci sürümünü kullanarak Web uygulamalarını test edin. Chrome, 
Firefox ve Kmıum Edge tümünde test için kullanılabilecek yeni bir katılım özelliği bayrakları vardır. Uygulamanız 
SameSite düzeltme eklerini uyguladıktan sonra, daha eski istemci sürümleriyle test edin, özellikle Safari. Daha 
fazla bilgi için bu belgede eski tarayıcıları destekleme bölümüne bakın. 

Chrome ile test etme 

Chrome 78 + bir yerde geçici bir risk azaltma yaptığından yanıltıcı sonuçlar verir.Chrome 78 + geçici risk azaltma, 
iki dakikadan daha eski tanımlama bilgilerine izin verir. Uygun test bayraklarıyla etkin olan Chrome 76 veya 77 






daha doğru sonuçlar sağlar. Yeni SameSite davranışını test etmek için 

c h rome://f iags/#same - site-by-def auit-cookies etkinolarak değiştirin. Chrome 'un (75 ve üzeri) eski sürümleri, 
yeni None ayarı ile başarısız olarak bildirilir. Bkz. bu belgede eski tarayıcıları destekleme . 

Google, eski Chrome sürümlerini kullanılabilir hale getirir.Chrome 'un eski sürümlerini test etmek için Kmıum 
indirme bölümündeki yönergeleri izleyin. Chrome 'un eski sürümlerini arayarak sunulan bağlantılardan Chrome 
indirmeyin . 

• Kmıum 76 Win64 

• Kmıum 74 Win64 

Safari ile test etme 

Safari 1 2, önceki taslağı tamamen uyguladık ve yeni None değeri bir tanımlama bilgisinde olduğunda başarısız 
olur. Bu belgede eski tarayıcıları destekleyen tarayıcı algılama kodu aracılığıyla None kaçınılmaz. MSAL, ADAL 
veya kullandığınız herhangi bir kitaplığı kullanarak Safari 12, Safari 13 ve VVebKit tabanlı işletim sistemi stili 
oturum açma stilini test edin. Sorun, temel alınan işletim sistemi sürümüne bağımlıdır.OSX Mojave (10,14) ve İOS 
12 ' nin yeni SameSite davranışıyla uyumluluk sorunlarına sahip olduğu bilinmektedir, işletim sistemini OSX 
Catalina (10,15) veya İOS 13 ' e yükseltmek sorunu düzeltir. Safari 'nin şu anda yeni belirtim davranışını test 
etmek için bir katılım bayrağı yoktur. 

Firefox ile test etme 

Yeni Standart için Firefox desteği, aboutıconfig sayfasında özellik network.cookie.sameSite.laxByDefault 
bayrağıyla birlikte seçerek 68 + sürümü üzerinde test edilebilir. Daha eski Firefox sürümleriyle uyumluluk sorunları 
hakkında rapor yoktu. 

Edge tarayıcısı ile test 

Edge, eski SameSite standardını destekler.Edge sürüm 44, yeni standart ile bilinen uyumluluk sorunlarına sahip 
değildir. 

Edge ile test (Kmıum) 

edge://f iags/#same - site-by-def auit-cookies sayfasında SameSite bayrakları ayarlanır. Edge Kmıum ile hiçbir 
uyumluluk sorunu bulunmadı. 

Elektron ile test 

Elektron sürümleri, daha eski bir Kmıum sürümlerini içerir.Örneğin, takımlar tarafından kullanılan elektron 
sürümü, eski davranışı gösteren Kmıum 66 ' dir. Ürününüzün kullandığı elektron sürümüyle kendi uyumluluk 
testinizi gerçekleştirmeniz gerekir. Aşağıdaki bölümde daha eski tarayıcıları destekleme bölümüne bakın. 

Ek kaynaklar 

• Kmıum bloğu: geliştiriciler: yeni SameSite için hazırlanın = yok; Güvenli tanımlama bilgisi ayarları 

• Aynı şekilde açıklanan SameSite tanımlama bilgileri 








ASPNET Core için istemci İP SafeList 

29.10.2019 • 5 minutes to read ı Edjt Online 


By Davmıen Bowden ve Tom Dykstra 

Bu makalede bir ASP.NET Core uygulamasında bir İP SafeList (beyaz liste olarak da bilinir) uygulamanın üç yolu 
gösterilmektedir. Şunu kullanabilirsiniz: 

• Her isteğin uzak İP adresini denetlemek için ara yazılım. 

• Belirli denetleyiciler veya eylem yöntemlerine yönelik isteklerin uzak İP adresini denetlemek için eylem filtreleri. 

• Razor sayfalarına yönelik isteklerin uzak İP adresini denetlemek için filtreler Razor Pages. 

Her durumda, onaylanan istemci İP adreslerini içeren bir dize bir uygulama ayarında saklanır.Ara yazılım veya 
filtre, dizeyi bir liste olarak ayrıştırır ve uzak İP 'nin listede olup olmadığını denetler. Aksi takdirde, HTTP 403 
yasaklanmış durum kodu döndürülür. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

SafeList 

Liste appSettings. JSON dosyasında yapılandırılır. Bu, noktalı virgülle ayrılmış bir liste ve IPv4 ve IPv6 adresleri 
içerebilir. 

{ 

"AdminSafeList": "127.0.0.İJİ92.168.1.5; : -. 1 ", 

"Logging": { 

"IncludeScopes": false, 

"LogLevel": { 

"Default": "Debug", 

"System": "Information", 

"Microsoft": "Information" 

} 

} 

} 


Ara yazılım 

configure yöntemi, ara yazılımı ekler ve bir Oluşturucu parametresinde SafeList dizesini buna geçirir. 

public void Configure( 

IApplicationBuilder app, 

IHostingEnvironment env, 

ILoggerFactory loggerFactory) 

{ 

loggerFactory.AddNLog(); 
app.UseStaticFiles(); 

app. UseMiddleware<AdminSafel_istMiddlewa re >(Configu rat ion[ "AdminSafeList" ]); 
app.UseMvc(); 


Ara yazılım, dizeyi bir dizi olarak ayrıştırır ve dizideki uzak İP adresini arar.Uzak İP adresi bulunamazsa, ara yazılım 
HTTP 401 yasak değerini döndürür. Bu doğrulama işlemi HTTP GET istekleri için atlanır. 






public class AdminSafeListMiddleware 

{ 

private readonly RequestDelegate _next; 

private readonly ILogger<AdminSafeListMiddleware> _logger; 
private readonly string _adminSafeList; 

public AdminSafeListMiddleware( 

RequestDelegate next, 

ILogger<AdminSafeListMiddleware> logger, 
string adminSafeList) 

{ 

_adminSafeList = adminSafeList; 

_next = next; 

_logger = logger; 

} 

public async Task Invoke(HttpContext context) 

{ 

if (context.Request.Method != "GET") 

{ 

var remotelp = context.Connection.RemoteIpAddress; 

_logger.LogDebug("Request from Remote IP address: {Remotelp}", remotelp); 

string[] ip = _adminSafeList.Split('; ' 

var bytes = remotelp.GetAddressBytes(); 

var badlp = true; 

foreach (var address in ip) 

{ 

var testlp = IPAddress.Parse(address); 
if(testIp.GetAddressBytes().SequenceEqual(bytes)) 

{ 

badlp = false; 
break; 

} 

} 

if(badlp) 

{ 

_logger.Loglnformation( 

"Forbidden Request from Remote IP address: {Remotelp}", remotelp); 
context.Response.StatusCode = 401; 
return; 

} 

} 

await _next.Invoke(context); 

} 

} 


Eylem filtresi 

Yalnızca belirli denetleyiciler veya eylem yöntemleri için bir SafeList istiyorsanız, bir eylem filtresi kullanın. Örnek 
buradadır: 



using System.Linq; 

using System.Net; 

using System.Thneading.Tasks; 

using Microsoft.AspNetCore.Authorization; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.Authorization; 

using Microsoft.AspNetCore.Mvc.Filters; 

using Microsoft. Extensions.Configuration; 

using Microsoft.Extensions.Logging; 

namespace ClientlpAspNetCore.Filters 

{ 

public class ClientlpCheckFilter : ActionFilterAttribute 

{ 

private readonly ILogger _logger; 
private readonly string _safelist; 

public ClientlpCheckFilter 

(ILoggerFactory loggerFactory, IConfiguration configuration) 

{ 

_logger = loggerFactory .CreateLogger("ClientIdChecl<Filter"); 

_safelist = configuration["AdminSafeList"]; 

} 

public override void OnActionExecuting(ActionExecutingContext context) 

{ 

var remotelp = context.HttpContext.Connection.RemoteIpAddress; 

_logger.LogInformation( 

"Remote IpAddress: {Remotelp }", remotelp); 

string[] ip = _safelist.Split(';'); 

var badlp = true; 
foreach (var address in ip) 

{ 

if (remotelp.IsIPv4MappedToIPv6) 

{ 

remotelp = remotelp.MapToIPv4(); 

} 

var testlp = IPAddress.Parse(address); 
if (testlp.Equals(remoteIp)) 

{ 

badlp = false; 
break; 

} 

} 

if (badlp) 

{ 

_logger.LogInformation( 

"Forbidden Request from Remote IP address: {Remotelp }", remotelp) 
context.Result = new StatusCodeResult(401); 
return; 

} 

base.OnActionExecuting(context); 

} 

} 

} 


Eylem filtresi, hizmetler kapsayıcısına eklenir. 



public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddScoped<ClientIpCheckFilter>(); 

Services.AddMvc(options => 

{ 

options.Filters.Add 

(new ClientlpCheckPageFilter 

(J-OggerFactory, Configuration)); 

}).SetCompatibilityVersion(CompatibilityVersion.Version_2_l); 


Filtre daha sonra bir denetleyici veya eylem yönteminde kullanılabilir. 

[ServiceFilter(typeof(ClientlpCheckFilter))] 

[HttpGet] 

public IEnumerable<string> Get() 

Örnek uygulamada, filtre Get yöntemine uygulanır. Bu nedenle, uygulamayı bir Get API isteği göndererek test 
ettiğinizde, öznitelik istemci İP adresini doğruluyor. API 'Yİ başka bir HTTP yöntemiyle çağırarak test ettiğinizde, 
ara yazılım istemci İP 'sini doğruluyor. 

Razor Pages filtresi 

Razor Pages bir uygulama için bir SafeList istiyorsanız, bir Razor Pages filtresi kullanın. Örnek buradadır: 






using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.Filters; 

using Microsoft.Extensions.Configuration; 

using Microsoft.Extensions.Logging; 

using System; 

using System.Linq; 

using System.Net; 

namespace ClientlpAspNetCore 

{ 

public class ClientlpCheckPageFilter : IPageFilter 

{ 

private readonly ILogger _logger; 
private readonly string _safelist; 

public ClientlpCheckPageFilter 

(ILoggerFactory loggerFactory, IConfiguration configuration) 

{ 

_logger = loggerFactory.CreateLogger("ClientIdCheckPageFilter"); 

_safelist = configurationf'AdminSafeList"]; 

} 

public void OnPageHandlerExecuting(PageHandlerExecutingContext context) 

{ 

var remotelp = context.HttpContext.Connection.RemoteIpAddress; 

_logger.LogInformation( 

"Remote IpAddress: {Remotelp}", remotelp); 

string[] ip = _safelist.Split(';' 

var badlp = true; 
foreach (var address in ip) 

{ 

if (remotelp.IsIPv4MappedToIPv6) 

{ 

remotelp = remotelp.MapToIPv4(); 

} 

var testlp = IPAddress.Parse(address); 
if (testlp.Equals(remoteIp)) 

{ 

badlp = false; 
break; 

} 

} 

if (badlp) 

{ 

_logger.LogInformation( 

"Forbidden Request from Remote IP address: {Remotelp}", remotelp) 
context.Result = new StatusCodeResult(401); 
return; 

} 

} 

public void OnPageHandlerExecuted(PageFlandlerExecjtedContext context) 

{ 

} 

public void OnPageHandlerSelected(PageFlandlerSelectedContext context) 

{ 

} 

} 

} 


Bu filtre, MVC filtreleri koleksiyonuna eklenerek etkinleştirilir. 



public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddScoped<ClientIpCheckFilter>(); 

Services.AddMvc(options => 

{ 

options.Filters.Add 

(new ClientlpCheckPageFilter 

(J-OggerFactory, Configuration)); 

}).SetCompatibilityVersion(CompatibilityVersion.Version_2_l); 


Uygulamayı çalıştırıp bir Razor sayfası istediğinizde Razor Pages filtresi istemci İP 'sini doğruluyor. 

Sonraki adımlar 

ASP.NET Core ara yazılım hakkında daha fazla bilgi edinin. 



ASPNET Core Blazor kimlik doğrulaması ve 
yetkilendirme 
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Steve Sanderson tarafından 


IMPORTANT 

Önizlemede Blazor VVeelsembly 

Blazor sunucusu ASP.NET Core 3,0 ' de desteklenir. Blazor VVebAssembly ASP.NET Core 3,1 için öniziemededir. 


ASP.NET Core, Blazor uygulamalardaki güvenlik yapılandırmasını ve yönetimini destekler. 

Güvenlik senaryoları Blazor Server ve VVebAssembly Apps Blazor farklıdır. Blazor sunucu uygulamaları sunucuda 
çalıştığından, yetkilendirme denetimleri şunları tespit edebilir: 

• Kullanıcıya sunulan kullanıcı ARABİRİMİ seçenekleri (örneğin, bir kullanıcı için hangi menü girişlerinin 
kullanılabildiği). 

• Uygulama ve bileşenlerin bölgeleri için erişim kuralları. 

Blazor VVebAssembly uygulamaları istemcide çalışır.Yetkilendirmeyo/nrzco hangi kullanıcı arabirimi 
seçeneklerinin gösterileceğini belirlemede kullanılır. İstemci tarafı denetimleri bir kullanıcı tarafından 
değiştirililerek veya atlandığından, bir Blazor VVebAssembly uygulaması yetkilendirme erişim kurallarını zorunlu 
kılamaz. 

Kimlik Doğrulama 

Blazor, kullanıcının kimliğini kurmak için mevcut ASP.NET Core kimlik doğrulama mekanizmalarını kullanır.Tam 
mekanizma Blazor uygulamasının nasıl barındırıldığını, Blazor sunucunun veya Blazor VVebAssembly ' ne bağlıdır. 

Blazor sunucusu kimlik doğrulaması 

Blazor Server Apps, SignalRkullanılarak oluşturulan gerçek zamanlı bir bağlantı üzerinden çalışır. SignalRtabanlı 
uygulamalarda kimlik doğrulaması , bağlantı oluşturulduğunda işlenir. Kimlik doğrulaması, bir tanımlama bilgisine 
veya başka bir taşıyıcı belirtecine dayalı olabilir. 

Blazor sunucusu proje şablonu, proje oluşturulduğunda kimlik doğrulamasını sizin için ayarlayabilir. 

• Visual Studio 

• Visual Studio Code 

Kimlik doğrulama mekanizmasına sahipyeni bir Blazor sunucu projesi oluşturmak için ASP.NET Core Blazor 
kullanmaya başlama makalesindeki Visual Studio kılavuzunu izleyin. 

Yeni bir ASP.N ET Core Web uygulaması oluştur iletişim kutusunda Blazor sunucusu uygulama şablonunu 
seçtikten sonra, kimlik doğrulamasıaltında Değiştir' i seçin. 

Diğer ASP.NET Core projelerine yönelik aynı kimlik doğrulama mekanizması kümesini sunmak için bir iletişim 
kutusu açılır: 

• Kimlik doğrulaması yok 

• Kullanıcı hesaplarının - bireysel kullanıcı hesapları depolanabilir: 






o ASP.NET Core kimlik sistemini kullanarak uygulama içinde, 
o AzureADB2C. 

• İş veya okul hesapları 

• Windows Kimlik Doğrulaması 

Blazor VVebAssembly kimlik doğrulaması 

Blazor VVebAssembly uygulamalarında, tüm istemci tarafı kodlar kullanıcılar tarafından değiştirilemediği için 
kimlik doğrulama denetimleri atlanabilir. Aynı, JavaScript SPA çerçeveleri veya herhangi bir işletim sistemi için 
yerel uygulamalar dahil olmak üzere tüm istemci tarafı uygulama teknolojileri için de geçerlidir. 

Uygulamanın proje dosyasına Microsoft. AspNetCore. components. Authorization için bir paket başvurusu 
ekleyin. 

Blazor VVebAssembly uygulamaları için özel bir AuthenticationstateProvider hizmeti uygulaması aşağıdaki 
bölümlerde ele alınmıştır. 

AuthenticationstateProvider hizmeti 

Blazor Server uygulamaları ASP.NET Core HttpContext.user kimlik doğrulama durumu verilerini alan yerleşik bir 
AuthenticationstateProvider hizmeti içerir. Kimlik doğrulama durumu, mevcut ASP.NET Core sunucu tarafı kimlik 
doğrulama mekanizmalarıyla tümleştirilir. 

AuthenticationstateProvider , kimlik doğrulama durumunu almak için Authorizeview bileşeni ve 
cascadingAuthenticationstate bileşeni tarafından kullanılan temel hizmettir. 

Genellikle AuthenticationstateProvider doğrudan kullanmazsınız. Bu makalenin ilerleyen kısımlarında açıklanan 
Authorizevievv bileşenini veya görev yaklaşımlarını kullanın. AuthenticationstateProvider doğrudan kullanmanın 
ana dezavantajı, temeldeki kimlik doğrulama durumu verileri değişirse bileşen tarafından otomatik olarak 
bildirilmemektedir. 

AuthenticationstateProvider hizmeti, aşağıdaki örnekte gösterildiği gibi geçerli kullanıcının ClaimsPrincipal 
verilerini sağlayabilir: 

@page "/" 

@using Microsoft.AspNetCore.Components.Authorization 

(Şinject AuthenticationstateProvider AuthenticationstateProvider 

<button @onclick="@LogUsername">Write user info to console</button> 

@code { 

private async Task LogUsername() 

{ 

var authState = await AuthenticationstateProvider.GetAuthenticationStateAsync(); 
var user = authState.User; 

if (user.Identity.IsAuthenticated) 

{ 

Console.Writel_ine($"{user.Identity.Name} is authenticated."); 

} 

else 

{ 

Console.WriteLine("The user is NOT authenticated."); 

} 

} 

} 

user.Identity.IsAuthenticated true ve Kullanıcı bir ClaimsPrincipalolduğundan, talepler, değerlendirilen rollerde 
numaralandırılabilir ve üyelik yapılabilir. 











Bağımlılık ekleme (dı) ve hizmetleri hakkında daha fazla bilgi için bkz. ASP.NET Core Blazor bağımlılığı ekleme ve 
ASP.NET Core bağımlılık ekleme. 

Özel bir AuthenticationStateProvider uygulama 

Blazor VVebAssembly uygulaması oluşturuyorsanız veya uygulamanızın belirtimi kesinlikle özel bir sağlayıcı 
gerektiriyorsa, bir sağlayıcı uygulayın ve GetAuthenticationstateAsync geçersiz kılın: 

using System.Security.Claims; 
using System.Threading.Tasks; 

using Microsoft.AspNetCore.Components.Authorization; 

namespace BlazorSample.Services 

{ 

public class CustomAuthStateProvider : AuthenticationStateProvider 

{ 

public override Task<AuthenticationState> GetAuthenticationstateAsync() 

{ 

var identity = new Claimsldentity(new[] 

{ 

new Claim(ClaimTypes.Name, "mrfibuli"), 

}, "Fake authentication type"); 

var user = new ClaimsPrincipal(identity); 

return Task.FromResult(new AuthenticationState(user)); 

} 

} 

} 

CustomAuthStateProvider hizmeti Startup.ConfigureServices kaydedilir: 

// using Microsoft.AspNetCore.Components.Authorization; 

// using BlazorSample.Services; 

Services.AddScoped<AuthenticationStateProviderj CustomAuthStateProvider>(); 

CustomAuthStateProvider kullanarak, tüm kullanıcıların Kullanıcı adı mrfibuli kimlik doğrulaması yapılır. 

Kimlik doğrulama durumunu basamaklı bir parametre olarak kullanıma 
sunma 

Kullanıcı tarafından tetiklenen bir eylem gerçekleştirirken olduğu gibi, yordamsal mantık için kimlik doğrulama 
durumu verileri gerekliyse, Task<Authenticationstate> türünde bir geçişli parametre tanımlayarak kimlik 
doğrulama durumu verilerini alın: 



@page "/" 

<button @onclick="@LogUsenname">Log username</button> 

@code { 

[CascadingParameter] 

private Task<AuthenticationState> authenticationStateTask { get; set; } 

private async Task LogUsenname() 

{ 

var authState = await authenticationStateTask; 
var user = authState.User; 

if (user.Identity.IsAuthenticated) 

{ 

Console.WriteLine($"{user.Identity.Name} is authenticated."); 

} 

else 

{ 

Console.WriteLine("The user is NOT authenticated."); 

} 

} 

} 


NOTE 

Blazor VVebAssembly uygulama bileşeninde, 

Microsoft.AspNetCore.Components.Authorization 

ad alanını ( 

@using Microsoft.AspNetCore.Component 

.Authorization ) ekleyin. 




<Router AppAssembly="@typeof(Program).Assembly"> 

<Found Context="routeData"> 

<AuthorizeRouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" /> 
</Found> 

<NotFound> 

<CascadingAuthenticationState> 

<LayoutView Layout="@typeof(MainLayout)"> 

<p>Sorry, there's nothing at this address.</p> 

</LayoutView> 

</CascadingAuthenticationState> 

</NotFound> 

</Router> 


Yetkilendirme 

Bir kullanıcının kimliği doğrulandıktan sonra, kullanıcının neler yapabileceğini denetlemek için Yetkilendirme 
kuralları uygulanır. 

Erişim, genellikle aşağıdakileri yapıp verilmeksizin verilir veya reddedilir: 

• Bir kullanıcının kimliği doğrulanır (oturum açıldı). 

• Bir Kullanıcı bir roldür. 

• Bir kullanıcının fo/efaıvardır. 

• Bir t/Are karşılandı. 







Bu kavramların her biri, ASP.NET Core MVC veya Razor Pages uygulamasındaki ile aymdir.ASP.NET Core 
güvenliği hakkında daha fazla bilgi için, ASP.NET Core güvenlik ve kimlik' in altındaki makalelere bakın. 

AuthorizeVievv bileşeni 

Authorizeview bileşeni, kullanıcının onu görme yetkisine sahip olup olmadığına bağlı olarak Kullanıcı 
ARABİRİMİNİ seçmeli olarak görüntüler. Bu yaklaşım yalnızca Kullanıcı için veri görüntülemesi gerektiğinde ve 
Kullanıcı kimliğini yordamsal mantığda kullanmanıza gerek olmadığında yararlıdır. 



Kullanıcının kimliği doğrulanmadıysa, görüntülenmek üzere farklı içerikler de sağlayabilirsiniz: 



Kullanıcı arabirimi seçeneklerini veya erişimini denetleyen roller veya ilkeler gibi yetkilendirme koşulları, 
Yetkilendirme bölümünde ele alınmıştır. 

Yetkilendirme koşulları belirtilmemişse, Authorizeview varsayılan bir ilke kullanır ve şu şekilde davranır: 

• Kimliği doğrulanmış (oturum açmış) kullanıcılar yetkili olarak. 

• Kimliği doğrulanmamış (oturumu açılmış) kullanıcılar yetkilendirilmemiş. 

Rol tabanlı ve ilke tabanlı yetkilendirme 

Authorizeview bileşeni rol tabanU veya ilke tabanli yetkilendirmeyi destekler. 

Rol tabanlı yetkilendirme için Roles parametresini kullanın: 

<AuthorizeView Roles="admin., superuser"> 

<p>You can only see this if you're an admin or superuser.</p> 

</AuthorizeView> 


Daha fazla bilgi için bkz. ASP.NET Core rol tabanlı yetkilendirme, 
ilke tabanlı yetkilendirme için Poücy parametresini kullanın: 


<AuthorizeView Policy="content-editör"> 

<p>You can only see this if you satisfy the "content-editor" policy.</p> 
</AuthorizeView> 










Talep tabanlı yetkilendirme, ilke tabanlı yetkilendirme için özel bir durumdur.Örneğin, kullanıcıların belirli bir 
talebe sahip olmasını gerektiren bir ilke tanımlayabilirsiniz. Daha fazla bilgi için bkz. ASP.NET Core ilke tabanlı 
yetkilendirme. 

Bu API 'Ler Blazor sunucuda Blazor ya da VVebAssembly uygulamalarında kullanılabilir. 

Ne Roles nede Policy belirtilmemişse, Authorizeview varsayılan ilkeyi kullanır. 

Zaman uyumsuz kimlik doğrulaması sırasında görünen içerik 

Blazor, kimlik doğrulaması durumunun zaman uyumsuzolarak belirlenmesine izin verir. Bu yaklaşım için birincil 
senaryo, kimlik doğrulaması için bir dış uç noktaya istek yapan Blazor VVebAssembly Apps ' dedir. 

Kimlik doğrulaması devam ederken, Authorizeview varsayılan olarak içerik görüntülemez. Kimlik doğrulama 
gerçekleştiğinde içeriği göstermek için <Authorizing> öğesini kullanın: 

<AuthorizeView> 

<Authorized> 

<hl>Hello, @context.User.Identity.Name!</hl> 

<p>You can only see this content if you're authenticated.</p> 

</Authorized> 

<Authorizing> 

<hl>Authentication in progress</hl> 

<p>You can only see this content while authentication is in progress.</p> 

</Authorizing> 

</AuthorizeView> 


Bu yaklaşım normalde Blazor Server uygulamaları için geçerli değildir. Blazor sunucu uygulamaları, durum 
oluşturulur almaz kimlik doğrulama durumunu bilir. Authorizing içerik Blazor sunucu uygulamasının 
Authorizeview bileşeninde bulunabilir, ancak içerik hiçbir şekilde gösterilmez. 

[Yetkilendir] özniteliği 

[Authorize] özniteliği Razor bileşenlerinde kullanılabilir: 

@page "/" 

@attribute [Authorize] 

You can only see this if you're signed in. 


NOTE 

Blazor VVebAssembly uygulama bileşeninde, bu bölümdeki örneklere Microsoft.AspNetcore.Authorization ad alanını ( 
@using Microsoft. AspNetCore. Authorization ) ekleyin. 


IMPORTANT 

Yalnızca Blazor yönlendirici üzerinden ulaşılan @page bileşenlerinde [Authorize] kullanın. Yetkilendirme yalnızca, bir 
sayfada işlenen alt bileşenler için değil , yönlendirmenin bir yönü olarak gerçekleştirilir. Bir sayfa içindeki belirli parçaların 
görüntülenmesini yetkilendirmek için, bunun yerine Authorizeview kullanın. 


[Authorize] özniteliği rol tabanlı veya ilke tabanlı yetkilendirmeyi de destekler. Rol tabanlı yetkilendirme için 
Roles parametresini kullanın: 













@page "/" 

@attribute [Authorize(Roles = "admin, superuser")] 

<p>You can only see this if you're in the 'admin' or 'superuser' role.</p> 
ilke tabanlı yetkilendirme için Poücy parametresini kullanın: 

@page "/" 

@attribute [Authorize(Policy = "content-editor")] 

<p>You can only see this if you satisfy the 'content-editor' policy.</p> 

Ne Roles nede Policy belirtilmemişse, [Authorize] varsayılan ilkeyi kullanır, bu varsayılan olarak kabul edilir: 

• Kimliği doğrulanmış (oturum açmış) kullanıcılar yetkili olarak. 

• Kimliği doğrulanmamış (oturumu açılmış) kullanıcılar yetkilendirilmemiş. 

Yönlendirici bileşeniyle yetkisiz içeriği özelleştirme 

AuthorizeRouteView bileşeniyle birlikte Router bileşeni, uygulamanın şu durumlarda özel içerik belirlemesine izin 
verir: 

• içerik bulunamadı. 

• Kullanıcı, bileşene uygulanan bir [Authorize] koşulunu başarısız olur. [Authorize] özniteliği [Authorize] 
öznitelik bölümünde ele alınmıştır. 

• Zaman uyumsuz kimlik doğrulama devam ediyor. 

Varsayılan Blazor sunucusu proje şablonunda, app. Razor dosyası nasıl özel içerik ayarlanacağını gösterir: 

<Router AppAssembly="@typeof(Program).Assembly"> 

<Found Context="routeData"> 

<AuthorizeRouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)"> 

<NotAuthorized> 

<hl>Sorry</hl> 

<p>You're not authorized to reach this page.</p> 

<p>You may need to log in as a different user.</p> 

</NotAuthorized> 

<Authorizing> 

<hl>Authentication in progress</hl> 

<p>Only visible while authentication is in progress.</p> 

</Authorizing> 

</AuthorizeRouteView> 

</Found> 

<NotFound> 

<CascadingAuthenticationState> 

<LayoutView Layout="@typeof(MainLayout)"> 

<hl>Sorry</hl> 

<p>Sorryj there's nothing at this address.</p> 

</LayoutView> 

</CascadingAuthenticationState> 

</NotFound> 

</Router> 

<NotFound> , <NotAuthorized> ve <Authorizing> etiketlerinin içeriği, diğer etkileşimli bileşenler gibi rastgele öğeler 
içerebilir. 

<NotAuthorized> öğesi belirtilmemişse, AuthorizeRouteview aşağıdaki geri dönüş iletisini kullanır: 















Not authorized. 


Kimlik doğrulama durumu değişiklikleri hakkında bildirim 

Uygulama, temeldeki kimlik doğrulama durumu verilerinin değiştiğini belirlerse (örneğin, Kullanıcı oturumu 
kapattığından veya başka bir kullanıcı rollerini değiştirse), özel bir AuthenticationstateProvider isteğe bağlı olarak 
AuthenticationStateProvider temel sınıfında yöntemi NotifyAuthenticationStateChanged çağırabilir. Bu, yeni 
verileri kullanarak yeniden kimlik doğrulama durumu verilerini (örneğin, Authorizeview ) tüketicilere bildirir. 

Yordamsal mantık 

Uygulama, yordamsal mantığın bir parçası olarak yetkilendirme kurallarını denetmek için gerekliyse, kullanıcının 
ClaimsPrincipalalmak için Task<Authenticationstate> türünde basamaklı bir parametre kullanın. 
Task<Authenticationstate> , ilkeleri değerlendirmek için iAuthorizationService gibi diğer hizmetlerle 
birleştirilebilir. 

(Şinject IAuthorizationService AuthorizationService 

<button @onclick="@DoSomething">Do something important</button> 

@code { 

[CascadingParameter] 

private Task<AuthenticationState> authenticationStateTask { get; set; } 

private async Task DoSomething() 

{ 

var user = (await authenticationStateTask).User; 

if (user.Identity.IsAuthenticated) 

{ 

// Perform an action only available to authenticated (signed-in) users. 

} 

if (user.IsInRole("admin")) 

{ 

// Perform an action only available to users in the 'admin' role. 

} 

if ((await AuthorizationService.AuthorizeAsync(user, "content-editor")) 

.Succeeded) 

{ 

// Perform an action only available to users satisfying the 
// 'content-editor' policy. 

} 

} 

} 


NOTE 

Blazor VVebAssembly uygulama bileşeninde, Microsoft.AspNetcore.Authorization ve 
Microsoft .AspNetcore. components.Authorization ad alanlarını ekleyin: 

@using Microsoft.AspNetcore.Authorization 

@using Microsoft.AspNetcore.Components.Authorization 


Blazor VVebAssembly uygulamalarında yetkilendirme 












Blazor VVebAssembly uygulamalarında, tüm istemci tarafı kodlar kullanıcılar tarafından değiştirilemediği için 
yetkilendirme denetimleri atlanabilir. Aynı, JavaScript SPA çerçeveleri veya herhangi bir işletim sistemi için yerel 
uygulamalar dahil olmak üzere tüm istemci tarafı uygulama teknolojileri için de geçerlidir. 

İstemci tarafı uygulamanız tarafından erişilen tüm API uç noktalarında sunucuda her zaman 
yetkilendirme denetimleri gerçekleştirin. 

Sorun giderme hataları 

Yaygın hatalar: 

• Yetkilendirme, görev<AuthenticationState > türünde bir geçişli parametre gerektirir. Bunu 
sağlamak için basamaklı Dingauthenticationstate kullanmayı göz önünde bulundurun. 

• null değer authenticationStateTask alindi 

Projenin kimlik doğrulaması etkin bir Blazor sunucu şablonu kullanılarak oluşturulmamış olması olasıdır. 
<cascadingAuthenticationstate> Ul ağacının bir parçası etrafında sarmalayın, örneğin, app. Razor içinde aşağıdaki 
gibi: 

<CascadingAuthenticationState> 

<Router AppAssembly="typeof(Startup).Assembly"> 

</Router> 

</CascadingAuthenticationState> 

cascadingAuthenticationstate , Task<Authenticationstate> basamaklı parametresini sağlar ve bu, temel alınan 
AuthenticationStateProvider Dİ hizmetinden alır. 


Ek kaynaklar 

• ASP.NET Core güvenliğine genel bakış 

• Güvenli ASP.NET Core Blazor Server uygulamaları 

• ASP.NET Core VVİndovvs kimlik doğrulamasını yapılandırma 
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sunucu uygulamaları Blazor sunucu ve istemcinin uzun süreli bir ilişki korumasını gerektiren, durum bilgisi 
olan bir veri işleme modelini benimseyin. Kalıcı durum, büyük olasılıkla uzun süreli bağlantılara yayılabilen bir 
devretarafından korunur. 

Bir Kullanıcı Blazor sunucu sitesi ziyaret ettiğinde sunucu, sunucunun belleğinde bir devre oluşturur. Devre, 
kullanıcının Kullanıcı ARABİRİMİNDE bir düğme seçtiğinde olduğu gibi olaylara hangi içeriğin işleneceğini ve 
yanıt verdiğini tarayıcıya gösterir. Bu işlemleri gerçekleştirmek için, devre bir bağlantı, kullanıcının tarayıcısında 
ve .NET yöntemlerinde JavaScript işlevlerini çağırır. Bu iki yönlü JavaScript tabanlı etkileşim, JavaScript birlikte 
çalışma (js birlikte çalışma)olarak adlandırılır. 

JS birlikte çalışması Internet üzerinden yapıldığından ve istemci uzak bir tarayıcı kullandığından Blazor sunucu 
uygulamaları çoğu Web uygulaması güvenlik kaygılarını paylaşır. Bu konu, sunucu uygulamalarına Blazor 
yönelik yaygın tehditleri açıklar ve Internet 'e yönelik uygulamalara odaklanmış tehdit azaltma kılavuzu sağlar. 

Şirket ağları veya intranetleri gibi kısıtlı ortamlarda, azaltma yönerglarından bazıları şunlardır: 

• Kısıtlanmış ortamda uygulanmaz. 

• Güvenlik riski kısıtlı bir ortamda azaldığından, uygulama maliyeti değer değildir. 

Kaynak tükenmesi 

istemci sunucuyla etkileşime geçtiğinde kaynak tükenmesi gerçekleşebilir ve sunucunun aşırı kaynak 
kullanmasına neden olur. Aşırı kaynak tüketimi öncelikle şunları etkiler: 

• CPU 

• Bellek 

• istemci bağlantıları 

Hizmet reddi (DoS) saldırıları genellikle bir uygulamanın veya sunucunun kaynaklarını tüketme konusunda 
arama yapılır. Ancak, kaynak tükenmesi sistem üzerinde bir saldırının sonucu değildir.Örneğin, yüksek 
Kullanıcı talebi nedeniyle sınırlı kaynaklar tükenebilir. DoS, hizmet reddi (DOS) saldırıları bölümünde daha 
fazla ele alınmıştır. 

Veritabanları ve dosya tutamaçları (dosyaları okumak ve yazmak için kullanılır) gibi Blazor Framework harici 
kaynakları kaynak tükenmesi de yaşayabilir. Daha fazla bilgi için bkz. AS P.N ET Core performans En İyi 
yöntemleri. 

CPU 

Bir veya daha fazla istemci, yoğun CPU işi gerçekleştirmeye çalışan bir veya daha fazla istemci tarafından 
meydana gelebilir. 

Örneğin, Fibonnacci numarasmıhesap\ayar\ bir Blazor sunucusu uygulaması düşünün. Bir Fibonnacci 
numarası, dizideki her bir sayının önceki iki sayının toplamı olduğu bir Fibonnacci sırasından oluşturulur. 

Yanıta ulaşmak için gereken iş miktarı, sıranın uzunluğuna ve ilk değerin boyutuna bağlıdır. Uygulama bir 
istemcinin isteğine sınır yerleştirmezse, CPU yoğunluklu hesaplamalar CPU 'nun süresini ayırt edebilir ve 
diğer görevlerin performansını azalrlar. Aşırı kaynak tüketimi, kullanılabilirliği etkileyen bir güvenlik konusudur. 

CPU tükenmesi, herkese açık olan tüm uygulamalar için bir sorun teşkil etmez. Normal Web uygulamalarında, 





istekler ve bağlantılar bir güvenlik önlemi olarak zaman aşımına uğrar, ancak Blazor Server uygulamaları aynı 
korumaları sağlamaz. Blazor Server uygulamaları, CPU yoğun olabilecek işleri gerçekleştirmeden önce uygun 
denetimleri ve limitleri içermelidir. 

Bellek 

Bir veya daha fazla istemci, sunucuyu büyük miktarda bellek kullanmaya zorlmaya zorlarsanız bellek 
tükenmesi meydana gelebilir. 

Örneğin, öğelerin listesini kabul eden ve görüntüleyen bir bileşen ile Blazorsunucu tarafı uygulamasını 
düşünün. Blazor uygulama, izin verilen öğe sayısı veya istemciye geri işlenen öğe sayısı için sınır 
yerleştirmezse, bellek yoğun işleme ve işleme sunucu belleğini sunucunun performansının bulunduğu noktaya 
göre olumsuz etkileyebilir. Sunucu kilitlenmişse veya çöktüğünde göründüğü noktadan yavaş olabilir. 

Sunucuda olası bir bellek tükenmesi senaryosuna ait öğelerin listesini sürdürmek ve görüntülemek için 
aşağıdaki senaryoyu göz önünde bulundurun: 

• Bir List<Myitem> özellik veya alanındaki öğeler, sunucunun belleğini kullanır. Uygulama, öğelerin listesinin 
sınırsız olarak büyümesine izin veriyorsa, sunucunun belleği tükenmeye karşı bir risk vardır. Belleğin 
tükenmesinin geçerli oturum sonlandırmasına (kilitlenme) ve bu sunucu örneğindeki tüm eşzamanlı 
oturumlara bir bellek dışı özel durum almasına neden olur. Bu senaryonun oluşmasını önlemek için, 
uygulamanın eşzamanlı kullanıcılara bir öğe sınırı uygulayan bir veri yapısı kullanması gerekir. 

• Bir sayfalama şeması işleme için kullanılmazsa, sunucu Kullanıcı arabiriminde görünmeyen nesneler için ek 
bellek kullanır. Öğe sayısı sınırı olmadan, bellek talepleri kullanılabilir sunucu belleğini tüketebilir. Bu 
senaryoyu engellemek için aşağıdaki yaklaşımlardan birini kullanın: 

o işleme sırasında sayfalandırılmış listeler kullanın. 

o Yalnızca ilk 100 ' i 1.000 öğeyi görüntüleyin ve kullanıcının görüntülenen öğelerin ötesinde öğeleri 
bulmak için arama ölçütü girmesini gerektirir. 

o Daha gelişmiş bir işleme senaryosu için sanallaştırmayı destekleyen listeler veya kılavuzlar 

uygulayın. Sanallaştırma kullanarak, listeler yalnızca kullanıcıya şu anda görünür olan öğelerin bir alt 
kümesini işler. Kullanıcı ARABİRİMDEKİ ScrolIBar ile etkileşime geçtiğinde, bileşen yalnızca 
görüntüleme için gereken öğeleri işler. Şu anda görüntülenmek üzere gerekli olmayan öğeler, en 
ideal yaklaşım olan ikincil depolamada tutulabilir. Görüntülenmezler olmayan öğeler bellekte 
tutulabilir ve bu da daha az idealdir. 

Blazor Server Apps, WPF, VVİndovvs Forms veya Blazor VVebAssembly gibi durum bilgisi olan uygulamalar 
için diğer kullanıcı arabirimi çerçevelerine benzer bir programlama modeli sunar. Ana fark, uygulama 
tarafından tüketilen belleğin, istemciye ait olduğu ve yalnızca o tek istemciyi etkilediği bazı Kullanıcı arabirimi 
çerçevelerinden biridir. Örneğin, bir Blazor VVebAssembly uygulaması tamamen istemcide çalışır ve yalnızca 
istemci bellek kaynaklarını kullanır. Blazor sunucusu senaryosunda, uygulama tarafından tüketilen bellek 
sunucuya aittir ve sunucu örneğindeki istemciler arasında paylaşılır. 

Sunucu tarafı bellek talepleri tüm Blazor sunucu uygulamaları için bir noktadır.Ancak, çoğu VVeb uygulaması 
durum bilgisiz olur ve bir isteği işlerken kullanılan bellek, yanıt döndürüldüğünde serbest bırakılır. Genel bir 
öneri olarak, istemcilerin, istemci bağlantılarını devam eden diğer tüm sunucu tarafı uygulamalarda olduğu 
gibi ilişkisiz miktarda bellek ayırmasına izin vermez. Bir Blazor sunucusu uygulaması tarafından tüketilen 
bellek, tek bir istekten daha uzun bir süre devam ettirir. 


NOTE 

Geliştirme sırasında, bir profil oluşturucu kullanılabilir veya istemci bellek taleplerini değerlendirmek için yakalanan bir 
izleme olabilir. Profil Oluşturucu veya izleme, belirli bir istemciye ayrılan belleği yakalamaz. Geliştirme sırasında belirli bir 
istemcinin bellek kullanımını yakalamak için, bir döküm yakalayın ve Kullanıcı devresi içinde kök olan tüm nesnelerin 
bellek talebini inceleyin. 






İstemci bağlantıları 

Bir veya daha fazla istemci sunucuya çok fazla eş zamanlı bağlantı açtıklarında, diğer istemcilerin yeni bağlantı 
kurmasını engellediğinden bağlantı tükenmesi meydana gelebilir. 

Blazor istemcileri, oturum başına tek bir bağlantı kurar ve tarayıcı penceresi açık olduğu sürece bağlantıyı açık 
halde tutar. Tüm bağlantıları koruma sunucusundaki talepler Blazor uygulamalarına özgü değildir. Bağlantıların 
kalıcı doğası ve Blazor Server uygulamalarının durum bilgisi olan doğası göz önüne alındığında, bağlantı 
tükenmesi uygulamanın kullanılabilirliğine daha fazla risk taşır. 

Varsayılan olarak, bir Blazor sunucusu uygulaması için Kullanıcı başına bağlantı sayısı sınırı yoktur. Uygulama 
bir bağlantı sınırı gerektiriyorsa aşağıdaki yaklaşımlardan birini veya daha fazlasını yapın: 

• Yetkisiz kullanıcıların uygulamaya bağlanma yeteneğini doğal olarak sınırlayan kimlik doğrulaması gerektir. 
Bu senaryonun etkili olabilmesi için kullanıcıların, 1 de Yeni Kullanıcı sağlaması engellenmelidir. 

• Kullanıcı başına bağlantı sayısını sınırlayın. Bağlantıları sınırlandırma, aşağıdaki yaklaşımlar aracılığıyla 
gerçekleştirilebilir. Meşru kullanıcıların uygulamaya erişmesine izin vermeye özen gösterin (örneğin, 
istemcinin İP adresine göre bir bağlantı sınırı oluşturulduğunda). 

o Uygulama düzeyinde: 

o Uç nokta yönlendirme genişletilebilirliği. 

o Uygulamaya bağlanmak ve Kullanıcı başına etkin oturumları izlemek için kimlik doğrulaması 
gerektir. 

o Sınıra ulaştıktan sonra yeni oturumları reddedin. 

o İstemcilerden bir uygulamaya bağlantıları oluşturan Azure SignalR hizmeti gibi bir ara 
sunucu aracılığıyla uygulamaya yönelik proxy VVebSocket bağlantıları. Bu, tek bir istemcinin 
yapabileceğinden daha fazla bağlantı kapasitesine sahip bir uygulama sağlar ve istemcinin 
sunucu bağlantılarını tüketmesini önler. 

o Sunucu düzeyinde: uygulamanın önünde bir proxy/ağ geçidi kullanın. Örneğin, Azure ön kapısı , 

Web trafiğinin bir uygulamaya küresel olarak yönlendirilmesini tanımlamanıza, yönetmenize ve 
izlemenize olanak sağlar. 

Hizmet reddi (DoS) saldırıları 

Hizmet reddi (DoS) saldırıları, istemcinin bir veya daha fazla kaynağın bir veya daha fazla uygulamayı 
tüketmesine neden olan bir istemciyi içerir. Blazor Server uygulamaları, bazı varsayılan limitleri içerir ve DoS 
saldırılarına karşı koruma sağlamak için diğer ASP.N ET Core ve SignalR limitlerini kullanır: 

BLAZOR SUNUCUSU UYGULAMA SINIRI AÇIKLAMA VARSAYILAN 

CircuitOptions . DisconnectedCircuitMaxll@ltdiibff'dSUnucunun bellekte tek 100 

seferde tuttuğu bağlantı kesilen en 
fazla bağlantı sayısı. 

CircuitOptions . DisconnectedCircuitRetBağkd'rtffSIrtesilmiş bir devre dışı 3 dakika 

bırakılmadan önce bellekte tutulan en 
fazla süre. 

CircuitOptions. DSinteropDefaultcallTiZaman uyumsuz bir JavaScript işlev 1 dakika 

çağrısını zaman aşımına uğramadan 
önce sunucunun bekleyeceği en fazla 
süre. 




BLAZOR SUNUCUSU UYGULAMA SINIRI 


AÇIKLAMA 


VARSAYILAN 


Cir-cuitOptions .MaxBufferedUnacknowled6l9(fazladbHeİH'tlCt1lıeiniş işleme toplu işi 10 

sayısı sunucu, güçlü yeniden 
bağlanmayı desteklemek için belirli bir 
zamanda her bir devreye göre bellekte 
kalır. Sınıra ulaştıktan sonra sunucu, bir 
veya daha fazla toplu iş istemci 
tarafından onaylanana kadar yeni 
oluşturma toplu işleri oluşturmayı 
durduruyor. 

SIGNALR VE ASP.NET CORE SINIRI AÇIKLAMA VARSAYILAN 


CircuitOptions . MaximumReceiveMessagesTate bir ileti için ileti boyutu. 


32 KB 


Tarayıcıyla etkileşimler (istemci) 

istemci, JS birlikte çalışma olayı gönderme ve işleme tamamlama aracılığıyla sunucuyla etkileşime girer.JS 
birlikte çalışma iletişimi, JavaScript ve .NET arasında her iki yolla da geçer: 

• Tarayıcı olayları istemciden sunucuya zaman uyumsuz biçimde gönderilir. 

• Sunucu, gerektiği şekilde kullanıcı arabiriminden zaman uyumsuz olarak rerendering. 

.NET ‘ten çağrılan JavaScript işlevleri 

.NET yöntemlerinden JavaScript 'eyapılan çağrılar için: 

• Tüm etkinleştirmeleri, başarısız olduktan sonra, çağırana bir OperationCanceledException döndüren 
yapılandırılabilir bir zaman aşımı sağlar. 

o Bir dakikalık çağrılar ( circuitoptions.tsinteropDefauitcaiiTimeout ) için varsayılan bir zaman aşımı 
vardır. Bu sınırı yapılandırmak için bkz. ASP.NET Core Blazor JavaScript birlikte çalışabilirliği. 
o iptal belirtecini çağrı başına temelinde denetlemek için bir iptal belirteci sağlayabilirsiniz. Bir iptal 
belirteci sağlandıysa, mümkün olan ve istemciye yapılan tüm çağrıların zaman içinde sağlandığı 
varsayılan çağrı zaman aşımını kullanır. 

• JavaScript çağrısının sonucu güvenilir olamaz. Tarayıcıda çalışan Blazor uygulama istemcisi çağırmak için 
JavaScript işlevini arar. İşlev çağrılır ve sonuç ya da bir hata oluşturulur. Kötü amaçlı bir istemci şunları 
gerçekleştirmeye çalışabilir: 

o JavaScript işlevinden bir hata döndürerek uygulamada sorun oluşmasına neden olur, 
o JavaScript işlevinden beklenmeyen bir sonuç döndürerek sunucuda istemeden bir davranış alır. 

Yukarıdaki senaryolara karşı koruma için aşağıdaki önlemleri alın: 

• Try-catch DEYİMLERİ içindeki js birlikte çalışabilirlik çağrılarını, çağırma sırasında oluşabilecek hataları 
hesaba eklemek için kaydırın. Daha fazla bilgi için bkz. ASP.NET Core Blazor uygulamalarda hataları 
işleme. 

• Herhangi bir işlem yapmadan önce, hata iletileri de dahil olmak üzere JS birlikte çalışma çağırmaları 
tarafından döndürülen verileri doğrulayın. 

Tarayıcıdan çağrılan .NET yöntemleri 

JavaScript 'e yönelik çağrılara .NET yöntemlerine güvenmeyin. JavaScript 'e bir .NET yöntemi sunulduğunda, 
.NET yönteminin nasıl çağrılacağını göz önünde bulundurun: 

• Uygulamaya genel bir uç nokta gibi, JavaScript 'e sunulan tüm .NET metodunu değerlendirin, 
o Girişi doğrula. 



o Değerlerin beklenen aralıklar içinde olduğundan emin olun, 
o Kullanıcının istenen eylemi gerçekleştirme izni olduğundan emin olun, 
o .NET Yöntem çağırma kapsamında aşırı miktarda kaynak ayırmayın. Örneğin, denetim gerçekleştirin 
ve CPU ve bellek kullanımı için sınır koyun. 

o Statik ve örnek yöntemlerinin JavaScript istemcilerine sunutabileceğiniz hesaba sahip olun. Tasarım, 
uygun kısıtlamalarla durum paylaşma için çağrı yaptığı müddetçe, oturumlar arasında durum 
paylaşmaktan kaçının. 

o ilk olarak bağımlılık ekleme (Dİ) aracılığıyla oluşturulan DotNetReference nesneleri aracılığıyla 
kullanıma sunulan örnek yöntemleri için nesnelerin kapsamlı nesneler olarak kaydedilmesi 
gerekir. Bu, Blazor sunucu uygulamasının kullandığı tüm Dİ Hizmetleri için geçerlidir. 
o Statik yöntemler için, uygulama bir sunucu örneğindeki tüm kullanıcılar genelinde durum 
tasarımını özel olarak paylaşmadığı müddetçe, istemciye kapsamdaki durumu oluşturmaktan 
kaçının. 

o Parametrelerde Kullanıcı tarafından sağlanan verileri JavaScript çağrılarına geçirmekten kaçının. 
Parametrelerde veri geçirilmesi kesinlikle gerekliyse, JavaScript kodunun, siteler arası betik 
oluşturma (XSS) güvenlik açıklarına gerek kalmadan verileri geçirmeyi işlediğinden emin olun. 

Örneğin, bir öğenin innerHTML özelliğini ayarlayarak Belge Nesne Modeli (DOM) Kullanıcı 
tarafından sağlanan verileri yazma, evai ve diğer güvenli olmayan JavaScript temel öğelerini devre 
dışı bırakmak için İçerik güvenlik ilkesi (CSP) kullanmayı düşünün. 

• Framevvork 'ün gönderme uygulamasının en üstünde .NET etkinleştirmeleri için özel bir dağıtma 
uygulamaktan kaçının. .NET yöntemlerini tarayıcıya sunma, genel Blazor geliştirme için önerilmeyen 
gelişmiş bir senaryodur. 

Olaylar 

Olaylar Blazor sunucusu uygulamasına bir giriş noktası sağlar.Web Apps 'teki uç noktaları koruma için aynı 
kurallar, Blazor Server uygulamalarındaki olay işleme için geçerlidir. Kötü amaçlı bir istemci, istediği verileri bir 
olay için yük olarak gönderebilirler. 

Örneğin: 

• Bir <seiect> için değişiklik olayı, uygulamanın istemciye sunulan seçenekler içinde olmayan bir değer 
gönderebilir. 

• <input> , istemci tarafı doğrulamayı atlayarak herhangi bir metin verisini sunucuya gönderebilir. 

Uygulamanın, uygulamanın işlediği herhangi bir olay için verileri doğrulaması gerekir.Blazor Framevvork 
Forms bileşenleri temel doğrulamaları gerçekleştirir. Uygulama özel form bileşenleri kullanıyorsa, olay 
verilerinin uygun şekilde doğrulanması için özel kodun yazılması gerekir. 

Blazor sunucu olayları zaman uyumsuzdur, bu nedenle uygulamanın yeni bir işleme üreten bir işleme süresi 
geçmeden önce sunucuya birden çok olay gönderilebilir. Göz önünde bulundurulması gereken bazı güvenlik 
etkileri vardır. Uygulamadaki istemci eylemlerinin sınırlandırmasının, olay işleyicileri içinde gerçekleştirilmesi 
ve geçerli işlenen görünüm durumuna bağlı olmaması gerekir. 

Bir kullanıcının bir sayacı en fazla üç kez artmasını sağlayan bir sayaç bileşeni düşünün. Sayacı artırma 
düğmesi, count değerine göre koşullu olarak belirlenir: 











<p>Count: @count<p> 

@if (count < 3) 

{ 

cbutton @onclick="IncrementCount" value="Increment count" /> 

} 

@code 

{ 

private int count = 0 ; 

private void IncrementCount() 

{ 

count++; 

} 

} 

Bir istemci, çerçeve bu bileşenin yeni bir işlemesini oluşturmadan önce bir veya daha fazla artış olayı 
gönderebilir. Bu, düğme kullanıcı ARABİRİMİ tarafından yeterince hızlı bir şekilde kaldırılmadığı için count , 
Kullanıcı tarafından üç kez artılabildiğinden oluşur. Üç count artımlarının sınırına ulaşmak için doğru yol 
aşağıdaki örnekte gösterilmiştir: 

<p>Count: @count<p> 

@if (count < 3) 

{ 

cbutton @onclick="IncrementCount" value="Increment count" /> 

} 

@code 

{ 

private int count = 0 ; 

private void IncrementCount() 

{ 

if (count < 3) 

{ 

count++; 

} 

} 

} 

işleyicinin içindeki if (count < 3) { ... } denetimini ekleyerek, count artırma kararı geçerli uygulama 
durumuna göre belirlenir. Bu karar, önceki örnekte olduğu gibi Kullanıcı arabiriminin durumunu temel değildir 
ve bu da geçici olarak eski olabilir. 

Birden çok gönderine karşı koruma 

Bir olay geri çağırması, bir dış hizmetten veya veritabanından veri getirme gibi uzun süren bir işlemi 
çağı rai iyorsa, bir koruyucu kullanmayı düşünün. Koruyucu, bir işlem görsel geri bildirimde çalışırken, 
kullanıcının birden çok işlemi sıraya almasını önleyebilir. Aşağıdaki bileşen kodu, GetForecastAsync verileri 
sunucudan alırken tme isLoading ayarlar. isLoading true , bu düğme Kullanıcı arabiriminde devre dışı 
bırakılır: 












@page "/fetchdata" 

@using BlazorServerSample.Data 

@inject WeatherForecastService ForecastService 

<button disabled="@isLoading" @onclick="UpdateForecasts">Update</button> 
@code { 

private bool isLoading; 

private WeatherForecast[] forecasts; 

private async Task UpdateForecasts() 

{ 

if (lisLoading) 

{ 

isLoading = true; 

forecasts = await ForecastService.GetForecastAsync(DateTime.Now); 
İsLoading = false; 

} 

} 

} 


Erken iptali yapın ve bir-After-Dispose kullanmaktan kaçının 

Birden çok gönderenlere karşı koruma bölümünde açıklandığı gibi bir koruyucu kullanmanın yanı sıra, bileşen 
bırakıldığında uzun süreli işlemleri iptal etmek için bir CancellationToken kullanmayı düşünün. Bu yaklaşımda, 
bileşenlerden sonra kullanım-sonrasında Dispose özelliğinden kaçınmanın sağladığı avantaj vardır: 

@implements IDisposable 


@code { 

private readonly CancellationTokenSource TokenSource = 
new CancellationTokenSource(); 

private async Task UpdateForecasts() 

{ 

forecasts = await ForecastService.GetForecastAsync(DateTime.NoWj 
TokenSource.Token); 

if (TokenSource.Token.IsCancellationRequested) 

{ 

return; 

} 


} 

public void Dispose() 

{ 

CancellationTokenSource.Cancel(); 

} 

} 


Büyük miktarlarda veri üreten olaylardan kaçının 

oninput veya onscroiı gibi bazı DOM olayları, büyük miktarda veri üretebilir.Bu olayları Blazor Server 
uygulamalarında kullanmaktan kaçının. 


Ek güvenlik kılavuzu 







ASP.NET Core uygulamalarının güvenliğini sağlama kılavuzu Blazor sunucu uygulamalarına uygulanır ve 
aşağıdaki bölümlerde ele alınmıştır: 

• Günlüğe kaydetme ve hassas veriler 

• HTTPS ile yoldaki bilgileri koruma 

• Siteler arası betik oluşturma (XSS)) 

• Çapraz kaynak koruması 

• Tıklama-Jacking 

• Yeniden yönlendirmeleri aç 

Günlüğe kaydetme ve hassas veriler 

İstemci ve sunucu arasındaki JS birlikte çalışma etkileşimleri, ILogger örneklerle sunucu günlüklerine 
kaydedilir. Blazor, gerçek olaylar veya JS birlikte çalışma girişleri ve çıkışları gibi hassas bilgilerin günlüğe 
kaydedilmesini önler. 

Sunucuda bir hata oluştuğunda, çerçeve istemciye bildirir ve oturumu kapatır.Varsayılan olarak, istemci 
tarayıcının geliştirici araçlarında görünebileceğini belirten genel bir hata iletisi alır. 

istemci tarafı hatası, çağrı yığınını içermez ve hatanın nedeni hakkında ayrıntı sağlamaz, ancak sunucu 
günlükleri bu gibi bilgileri içerir. Geliştirme amacıyla, önemli hata bilgileri, ayrıntılı hataları etkinleştirerek 
istemciye kullanılabilir hale getirilebilir. 

ile ilgili ayrıntılı hataları etkinleştir: 

• CircuitOptions.DetailedErrors . 

• yapılandırma anahtarı DetailedErrors . Örneğin, aspnetcore_detailederrors ortam değişkenini true 
değerine ayarlayın. 


VVARNING 

Internet 'teki istemcilere hata bilgilerini ortaya çıkarmak her zaman kaçınılması gereken bir güvenlik riskidir. 


HTTPS ile yoldaki bilgileri koruma 

Blazor sunucusu, istemci ve sunucu arasındaki iletişim için SignalR kullanır. Blazor sunucusu normalde 
SignalR üzerinde görüşür, genellikle VVebSockets olan aktarımı kullanır. 

Blazor sunucusu, sunucu ve istemci arasında gönderilen verilerin bütünlüğünü ve gizliliğini garanti etmez. Her 
zaman HTTPS kullanın. 

Siteler arası betik oluşturma (XSS) 

Siteler arası betik oluşturma (XSS), yetkisiz bir tarafın tarayıcı bağlamında rastgele mantık yürütmesine olanak 
sağlar. Güvenliği aşılmış bir uygulama, istemcide rastgele kod çalıştırabilir.Güvenlik açığı, sunucuda büyük 
olasılıkla çok sayıda kötü amaçlı eylem gerçekleştirmek için kullanılabilir: 

• Sahte/geçersiz olayları sunucuya gönderme. 

• Dağıtım başarısız/geçersiz işleme tamamlama. 

• işleme tamamlamamasını gönderdikten kaçının. 

• JavaScript 'ten .NET 'e birlikte çalışma çağrıları gönderme. 

• .NET 'ten JavaScript 'e birlikte çalışma çağrılarının yanıtını değiştirme. 

• .NET ile JS birlikte çalışma sonuçlarına dağıtma kullanmaktan kaçının. 

Blazor Server Framevvork, önceki tehditlere karşı korumak için gereken adımları gerçekleştirir: 

• istemci, işleme toplu işlerini bildirmeden, yeni UI güncellemeleri oluşturmayı durduruyor. 










CircuitOptions .MaxBufferedllnacknowledgedRenderBatches ile yapılandırılır. 

• İstemciden bir yanıt almadan bir dakikadan sonra herhangi bir .NET için JavaScript çağrısı süresi. 
CircuitOptions.DSInteropDefaultCallTimeout ile yapılandırılır. 

• JS birlikte çalışması sırasında tarayıcıdan gelen tüm girişte temel doğrulama gerçekleştirir: 
o .NET başvuruları geçerli ve .NET yöntemi tarafından beklenen türde. 

o Veriler hatalı biçimlendirilmemiş. 

o Yöntem için doğru sayıda bağımsız değişken, yükte bulunur. 

o Yöntemi çağırmadan önce bağımsız değişkenler veya sonuç doğru şekilde seri durumdan çıkarılmış 
olabilir. 

• Tarayıcıdan gönderilen olaylardan gelen tüm girişte temel doğrulama gerçekleştirir: 
o Olayın geçerli bir türü vardır. 

o Olay verilerinin serisi kaldırılamaz, 
o Olayla ilişkili bir olay işleyicisi var. 

Framevvork 'ün uyguladığı korumalarına ek olarak, tehditlere karşı korumak ve uygun işlemleri 
gerçekleştirmek için uygulamanın geliştirici tarafından kodlanmış olması gerekir: 

• Olayları işlerken her zaman verileri doğrulayın. 

• Geçersiz veri aldıktan sonra uygun eylemi gerçekleştirin: 

o Verileri yoksayın ve döndürün. Bu, uygulamanın istekleri işlemeye devam etmesine izin verir, 
o Uygulama girişin meşru olduğunu belirlerse ve meşru istemci tarafından üretilemeyecek bir özel 
durum oluşturun. Bir özel durum oluşturmak devre dışı olarak oturum kapatır ve oturumu 
sonlandırır. 

• Günlüklere dahil olan işleme toplu işlemleri tarafından sağlanan hata iletisine güvenmeyin. Hata istemci 
tarafından sağlanır ve istemcinin güvenliği tehlikeye aşmış olabileceğinden genellikle güvenilemez. 

• JS birlikte çalışma çağrılarında, JavaScript ve .NET yöntemleri arasında her iki yönde de girişe güvenmeyin. 

• Bağımsız değişkenlerin veya sonuçların doğru şekilde seri durumdan çıkarılsa bile, uygulama bağımsız 
değişkenlerin ve sonuçların içeriğinin geçerli olduğunu doğrulamaktan sorumludur. 

Bir XSS Güvenlik açığının mevcut olması için, uygulamanın işlenen sayfada Kullanıcı girişini içermesi gerekir. 
Blazor Server bileşenleri, bir. Razor dosyasındaki biçimlendirmenin yordamsal C# mantığa 
dönüştürülebileceği bir derleme zamanı adımı yürütür. Çalışma zamanında, C# Logic ööeleri, metinleri ve alt 
bileşenleri açıklayan bir işleme ağacı oluşturur. Bu, tarayıcı DOM 'a bir JavaScript yönergeleri dizisi aracılığıyla 
uygulanır (veya prerendering durumunda HTML olarak serileştirilir): 

• Normal Razor söz dizimi (örneğin, @somestringvaiue ) ile işlenen Kullanıcı girişi, Razor söz dizimi DOM 'a 
yalnızca metin yazabileceğiniz komutlar aracılığıyla eklendiğinden bir XSS Güvenlik Açığı sunmaz. Değer 
HTML biçimlendirmesi içerse bile, değer statik metin olarak görüntülenir. Prerendering olduğunda çıktı 
HTML kodlamalı olur ve bu da içeriği statik metin olarak görüntüler. 

• Betik etiketlerine izin verilmez ve uygulamanın bileşen işleme ağacına dahil edilmemelidir. Bir komut 
dosyası etiketi bir bileşenin biçimlendirmesinde yer alıyorsa, derleme zamanı hatası oluşturulur. 

• Bileşen yazarları, Razor kullanmadan bileşenleri C# içinde yazar. Bileşen yazarı, çıkış yayırken doğru API 

' Leri kullanmaktan sorumludur. Örneğin, buiider.AddContentce, someuserSuppüedstring) .İkincisi bi r XS S 
Güvenlik Açığı oluşturmasından buiider.AddMarkupContentce, someuserSuppüedstring) değil' i kullanın. 

XSS saldırılarına karşı koruma kapsamında, İçerik güvenlik ilkesi (CSP)gibi XSS azaltmalarını gerçekleştirmeyi 
düşünün. 

Daha fazla bilgi için bkz. Siteler arası betik kullanmayı (XSS) ASP.NET core'da engelle. 

Çapraz kaynak koruması 

Çapraz kaynak saldırıları, sunucuya yönelik bir eylem gerçekleştiren farklı bir kaynaktan gelen bir istemciyi 









içerir. Kötü amaçlı eylem, genellikle bir GET isteği veya bir form GÖNDERİSİNİ (siteler arası İstek sahteciliği, 
CSRF), ancak kötü amaçlı bir VVebSocket açmak da mümkündür. Blazor sunucu uygulamaları, hub 
protokolünü kullanan diğer SignalR uygulamaların aynısınısunar: 

• Blazor sunucu uygulamalarına ek ölçüler alınana kadar, kaynak dışı erişilebilir. Çapraz kaynak erişimini 
devre dışı bırakmak için, işlem hattında CORS ana hattını ekleyerek ve Blazor uç nokta meta verilerine 
ekleyerek DisableCorsAttribute izin verilen çıkış noktaları kümesini, çıkış noktaları arası kaynak paylaşımı 
için SignalR yapılandırarakbir süre sonu devre dışı bırakın. 

• CORS etkinse, CORS yapılandırmasına bağlı olarak uygulamayı korumak için ek adımlar gerekebilir.CORS 
genel olarak etkinleştirilmişse, hub.MapBiazorHub() çağrıldıktan sonra uç nokta meta verilerine 

DisableCorsAttribute meta verileri eklenerek Blazor sunucu hub 'ı için CORS devre dışı bırakılabilir. 

Daha fazla bilgi için bkz. ASP.N ET Core siteler arası İstek sahteciliği (XSRF/CSRF) saldırılarını önle. 

Tıklama-Jacking 

Tıklama-Jacking, kullanıcıyı saldırı altında sitede eylemler gerçekleştirmeye ikna etmek için bir sitenin farklı bir 
kaynaktan bir <iframe> olarak işlenmesini içerir. 

Bir uygulamanın bir <iframe> içinde işlemesini korumak için İçerik güvenlik ilkesi (CSP) ve x-Frame-0ptions 
üst bilgisini kullanın. Daha fazla bilgi için bkz. MDN Web belgeleri: X-Frame-Options. 

Yeniden yönlendirmeleri aç 

Bir Blazor sunucusu uygulaması oturumu başladığında, sunucu, oturum başlatma işleminin bir parçası olarak 
gönderilen URL 'lerin temel doğrulamasını gerçekleştirir. Framework, devre oluşturmadan önce temel URL 
'nin geçerli URL 'nin bir üst olduğunu denetler. Framevvork tarafından başka denetim yapılmaz. 

Kullanıcı istemcide bir bağlantı seçtiğinde, bağlantının URL 'SI sunucuya gönderilir ve bu işlem 
gerçekleştirilecek eylemi belirler. Örneğin, uygulama bir istemci tarafı gezintisi gerçekleştirebilir veya tarayıcıya 
yeni konuma gidemeyeceğini belirtebilir. 

Bileşenler, NavigationManager kullanımı aracılığıyla program aracılığıyla gezinme isteklerini de tetikleyebilirler. 
Bu tür senaryolarda, uygulama bir istemci tarafı gezintisi gerçekleştirebilir veya tarayıcıya yeni konuma 
gidebileceğini gösterebilir. 

Bileşenler: 

• Gezinti çağrısı bağımsız değişkenlerinin bir parçası olarak Kullanıcı girişini kullanmaktan kaçının. 

• Hedefin uygulama tarafından izin verildiğinden emin olmak için bağımsız değişkenleri doğrulayın. 

Aksi takdirde, kötü niyetli bir kullanıcı tarayıcıyı saldırgan tarafından denetlenen bir siteye gitmesini 
zorlayabilir. Bu senaryoda, saldırgan uygulamayı NavigationManager.Navigate yöntemi çağrısının bir parçası 
olarak bazı kullanıcı girişlerini kullanarak 1 ye püf ediyor. 

Bu öneri, uygulamanın bir parçası olarak bağlantılar işlenirken de geçerlidir: 

• Mümkünse, göreli bağlantıları kullanın. 

• Mutlak bağlantı hedeflerinin bir sayfaya dahil etmeden önce geçerli olduğunu doğrulayın. 

Daha fazla bilgi için bkz. AS P.N ET core'da açık yeniden yönlendirme saldırılarını önleme. 

Kimlik doğrulaması ve yetkilendirme 

Kimlik doğrulama ve yetkilendirme hakkında yönergeler için bkz. ASP.NET Core Blazor kimlik doğrulaması ve 
yetkilendirme. 


Güvenlik denetim listesi 








Aşağıdaki güvenlik konulan listesi ayrıntılı değildir: 

• Etkinliklerden bağımsız değişkenleri doğrulayın. 

• Giriş ve, JS birlikte çalışma çağrılarındaki sonuçları doğrulayın. 

• .NET için JS birlikte çalışabilirlik çağrılarına yönelik kullanıcı girişini kullanmaktan (veya önceden 
doğrulama) kaçının. 

• İstemcinin ilişkisiz miktarda bellek ayırmasını engelleyin, 
o Bileşen içindeki veriler. 

o istemciye döndürülen başvuruları DotNetobject . 

• Birden çok gönderine karşı koruma. 

• Bileşen atıldığı zaman uzun süre çalışan işlemleri iptal edin. 

• Büyük miktarlarda veri üreten olaylardan kaçının. 

• NavigationManager.Navigate yapılan çağrıların bir parçası olarak Kullanıcı girişini kullanmaktan kaçının ve 
URL 'Ler için Kullanıcı girişini, bir izin verilen kaynaklar kümesine göre doğrulama, önce kaçınılmaz. 

• Kullanıcı arabiriminin durumuna göre yetkilendirme kararları yapmayın, ancak yalnızca bileşen durumudur. 

• XSS saldırılarına karşı korunmak için İçerik güvenlik ilkesi 'ni (CSP) kullanmayı düşünün. 

• Tıklama-Jacking 'e karşı korumak için CSP ve X çerçeve seçeneklerini kullanmayı düşünün. 

• CORS 'yi etkinleştirirken veya Blazor uygulamaları için doğrudan CORS 'yi devre dışı bırakrken CORS 
ayarlarının uygun olduğundan emin olun. 

• Blazor uygulamasına yönelik sunucu tarafı sınırlarının kabul edilemez bir risk düzeyi olmadan kabul 
edilebilir bir kullanıcı deneyimi sağlamasına emin olmak için test edin. 
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Bu makalede, AS P.N ET Core ile performans en iyi uygulamalarına yönelik yönergeler sunulmaktadır. 

Önbellek kararlılığı 

Önbelleğe alma, bu belgenin çeşitli bölümlerinde ele alınmıştır.Daha fazla bilgi için bkz. ASP.NET Core 'de yanıt 
önbelleğe alma. 

Etkin kod yollarını anlayın 

Bu belgede, sık kullanılan bir kod yolu , genellikle çağrılan ve yürütme süresinin çoğunun gerçekleştiği bir kod yolu 
olarak tanımlanır. Sık kullanılan kod yolları genellikle uygulama ölçeğini ve performansını sınırlar ve bu belgenin 
çeşitli bölümlerinde ele alınmıştır. 

Çağrı engellemeyi önleyin 

ASP.NET Core uygulamalar aynı anda birçok isteği işleyecek şekilde tasarlanmalıdır.Zaman uyumsuz API 'Ler, 
blok çağrılarını beklemeden binlerce eşzamanlı isteği işlemek için küçük bir iş parçacığı havuzuna izin verir. Uzun 
süre çalışan bir zaman uyumlu görevin tamamlanmasını beklemek yerine, iş parçacığı başka bir istek üzerinde 
çalışabilir. 

ASP.NET Core uygulamalarda yaygın bir performans sorunu, zaman uyumsuz olabilecek çağrıları engelliyor. 
Birçok zaman uyumlu engelleme çağrısı, İş parçacığı havuzu ve azaltılmış yanıt sürelerinin oluşmasına yol açabilir. 

Şunları yapın: 

• Task. Wait veya Task. Resultçağırarak zaman uyumsuz yürütmeyi engelleyin. 

• Ortak kod yollarındaki kilitleri alın. ASP.NET Core uygulamalar, kodu paralel olarak çalıştırmak için tasarlanmış 
olduğunda en iyi performansı sağlar. 

• Task. Run çağırın ve hemen bekler. AS P.N ET Core, uygulama kodunu normal İş parçacığı havuzu iş 
parçacıklarında zaten çalıştırıyor, bu nedenle görevi çağırıyor, yalnızca ek gereksiz İş parçacığı havuzu 
zamanlaması ile sonuçları çalıştırın. Zamanlanan kod bir iş parçacığını engelleyebilse bile, Task. Run bunu 
engellemez. 

Şunları yapın: 

• Etkin kod yollarını zaman uyumsuz yapın. 

• Zaman uyumsuz bir API kullanılabiliyorsa veri erişimi ve uzun süre çalışan işlem API 'Lerini çağrı zaman 
uyumsuz olarak çağırın. Bir kez daha, eşzamanlı bir API 'Yİ zaman uyumsuz yapmak için Task. Run 
kullanmayın. 

• Denetleyiciyi/Razor sayfası eylemlerini zaman uyumsuz yapın. Zaman uyumsuz/avvait desenlerinden 
faydalanmak için tüm çağrı yığını zaman uyumsuzdur. 

İş parçacığı havuzunasık sık eklenen iş parçacıklarını bulmak İçin PerfVievvgibi bir profil oluşturucu kullanılabilir. 
Microsoft-Windows-DotNETRuntime/ThreadPoolİAİorkerThread/Start olayı, İŞ parçacığı havuzuna eklenen bir İŞ 
parçacığını gösterir. 





Büyük nesne ayırmalarını en aza indir 

.N ET Core atık toplayıcısı, AS P.N ET Core uygulamalarda otomatik olarak bellek ayırmayı ve serbest bırakma 
işlemini yönetir. Otomatik atık toplama işlemi, geliştiricilerin belleğin nasıl veya ne zaman boşaltılana ilişkin 
endişelenmek zorunda olmadığı anlamına gelir. Ancak, başvurulmayan nesnelerin temizlenmesi CPU süresi alırsa, 
geliştiricilerin etkin kod yollarındakinesneleri ayırmayı en aza indirmeleri gerekir. Çöp toplama özellikle büyük 
nesneler üzerinde pahalıdır (> 85 K bayt). Büyük nesneler büyük nesne yığınında depolanır ve temizlemek için tam 
(2. nesil) çöp toplama gerektirir. Nesil 0 ve 1. nesil koleksiyonlarının aksine, 2. nesil bir koleksiyon, uygulama 
yürütmenin geçici olarak askıya alınmasını gerektirir. Büyük nesnelerin sık aralıklarla ayrılması ve ayrılması, 
tutarsız performansa neden olabilir. 

Öneri 

• Sık kullanılan büyük nesneleri önbelleğe almayı düşünün. Büyük nesnelerin önbelleğe alınması pahalı 
ayırmaları önler. 

• Büyük dizileri depolamak için <t > arraypool kullanarak havuz arabellekleri yapın . 

• Sık erişimli kod yollarındaçok sayıda, kısa süreli büyük nesneler ayırmayın . 

Yukarıdaki gibi bellek sorunları, PerfVievv ve İnceleme içindeki çöp toplama (GC) istatistiklerini inceleyerek 
tamlanabilir: 

• Çöp toplama duraklatma süresi. 

• Çöp toplama işlemi için işlemci zamanının yüzde kaçına harcanması. 

• Kaç çöp toplama 0,1 ve 2. nesil. 

Daha fazla bilgi için bkz. çöp toplama ve performans. 

Veri erişimini iyileştirme 

Veri deposuna ve diğer uzak hizmetlere sahip etkileşimler genellikle ASP.NET Core uygulamasının en yavaş 
parçalarından oluşur. Verileri etkili bir şekilde okumak ve yazmak iyi bir performans için önemlidir. 

Öneri 

• Tüm veri erişim API 'Lerini zaman uyumsuz olarak çağırın. 

• Gerekenden daha fazla veri alınamaz. Yalnızca geçerli HTTP isteği için gerekli olan verileri döndürmek için 
sorgular yazın. 

• Güncel olmayan veriler kabul edilebilir ise, bir veritabanından veya uzak hizmetten alınan sık erişilen verileri 
önbelleğe almayı düşünün. Senaryoya bağlı olarak, bir MemoryCache veya DistributedCachekullanın. Daha 
fazla bilgi için bkz. AS P.N ET Core 'de yanıt önbelleğe alma. 

• Ağ gidiş dönüşlerini en aza indirir. Amaç, birkaç çağrı yerine, gerekli verileri tek bir çağrıda almak olur. 

• Salt okuma amacıyla verilere erişirken Entity Framevvork Core izleme sorguları kullanmayın. EF Core, hiçbir 
izleme sorgusunun sonuçlarını daha verimli bir şekilde döndürebilir. 

• Filtrelemenin veritabanı tarafından gerçekleştirilmesi için, LINÖ sorgularını filtreleyin ve toplayın (örneğin, 

,where , .Select veya .Sum deyimleriyle). 

• EF Core, istemci üzerindeki bazı sorgu işleçlerini çözdüğünü, bu da verimsiz sorgu yürütmeye neden 
olabileceğini göz önünde bulundurun. Daha fazla bilgi için bkz. istemci değerlendirmesi performans 
sorunları. 

• Koleksiyonlar üzerinde izdüşüm sorguları kullanmayın ve bu, "N + 1" SQL sorgularının yürütülmeleriyle 
sonuçlanabilir. Daha fazla bilgi için bkz. bağıntılı alt sorguları iyileştirme. 

Yüksek ölçekli uygulamalarda performansı iyileştirebilecek yaklaşımlar için bkz. EF High Performance : 


• DbContext havuzu 






• Açıkça derlenmiş sorgular 


Kod tabanını çalıştırmadan önce, önceki yüksek performanslı yaklaşımların etkisini ölçmenizi öneririz. Derlenmiş 
sorguların ek karmaşıklığı performans iyileştirmesini engelleyebilir. 

Sorgu sorunları, Application Insights veya profil oluşturma araçlarıyla verilere erişirken harcanan süreyi 
inceleyerek algılanabilir. Çoğu veritabanı Ayrıca, sık çalıştırılan sorgularla ilgili istatistikleri de kullanılabilir hale 
getirir 

HttpClientFactory ile HTTP bağlantılarını havuz 

HttpClient iDisposable arabirimini uyguluyor olsa da, yeniden kullanım için tasarlanmıştır. Kapalı Httpciient 
örnekleri, yuvaları kısa bir süre için time_wait durumunda açık bırakır. Httpciient nesneleri oluşturan ve 
içermeyen bir kod yolu sıklıkla kullanılırsa, uygulama kullanılabilir yuvaları tüketebilir Httpclientfactory , bu soruna 
çözüm olarak AS P.N ET Core 2,1 1 de tanıtılmıştı. Performansı ve güvenilirliği iyileştirmek için havuz HTTP 
bağlantılarını işler 

Öneri 

• Httpciient örneklerini doğrudan oluşturma ve atma. 

• Httpciient örnekleri almak için Httpclientfactory kullanın. Daha fazla bilgi için bkz. Esnek http isteklerini 
uygulamak İçin HttpClientFactory kullanma. 

Ortak kod yollarını hızlı tutun 

Tüm kodunuzun hızlı olmasını istiyorsunuz, en çok kullanılan kod yolları en kritik öneme sahiptir: 

• Uygulamanın istek işleme ardışık düzeninde bulunan ara yazılım bileşenleri, özellikle de ara yazılım ardışık 
düzende çalışır. Bu bileşenlerin performansı üzerinde büyük bir etkisi vardır. 

• Her istek için veya istek başına birden çok kez yürütülen kod. Örneğin, özel günlük kaydı, yetkilendirme 
işleyicileri veya geçici Hizmetleri başlatma. 

Öneri 

• Uzun süre çalışan görevlerle özel ara yazılım bileşenleri kullanmayın. 

• Etkin kod yollarınıbelirlemek İçin, Visual Studio tanılama araçları veya PerfVievvgibi performans profil 
oluşturma araçlarını kullanın. 

Uzun süre çalışan görevleri http isteklerinin dışında Tamam 

ASP.NET Core uygulamasına yönelik çoğu istek, gerekli Hizmetleri çağıran ve HTTP yanıtı döndüren bir 
denetleyici veya sayfa modeli tarafından işlenebilir. Uzun süre çalışan görevleri içeren bazı istekler için, tüm istek- 
yanıt sürecini zaman uyumsuz hale getirmek daha iyidir. 

Öneri 

• Olağan HTTP istek işlemenin bir parçası olarak uzun süre çalışan görevlerin tamamlanmasını beklememe . 

• Arka plan hizmetleri ile uzun süreli istekleri işlemeyi veya bir Azure işleviile işlem dışı bırakmayı düşünün, 
işlem dışı iş tamamlama, özellikle CPU yoğun görevler için faydalıdır. 

• istemcilerle zaman uyumsuz iletişim kurmak için SignalRgibi gerçek zamanlı iletişim seçenekleri kullanın. 

İstemci varlıklarını küçültmeye yönelik 

Karmaşık ön uçları olan AS P.N ET Core uygulamalar sıklıkla birçok JavaScript, CSS veya görüntü dosyası sunar. İlk 
yük isteklerinin performansı şu şekilde geliştirilebilir: 









• Birden çok dosyayı bir içinde birleştiren paketleme. 

• Boşluk ve açıklamaları kaldırarak dosyaların boyutunu azaltan minifying. 

Öneri 

• AS P.N ET Core, istemci varlıklarını paketleme ve küçültmeye yönelik yerleşik desteğini kullanın. 

• Karmaşık istemci varlık yönetimi için VVebPackgibi diğer üçüncü taraf araçları göz önünde bulundurun. 

Yanıtları sıkıştır 

Yanıt boyutunu azaltmak genellikle önemli ölçüde önemli ölçüde bir uygulamanın yanıt hızını artırır. Yük 
boyutlarını azaltmanın bir yolu, uygulamanın yanıtlarını sıkıştırmaktır. Daha fazla bilgi için bkz. Yanıt sıkıştırması. 

En son ASP.NET Core sürümü kullan 

ASP.NET Core her yeni sürümü performans iyileştirmeleri içerir..NET Core ve ASP.NET Core iyileştirmeler, daha 
yeni sürümlerin genellikle eski sürümlerin genel olarak gerçekleştirdiği anlamına gelir. Örneğin, .NET Core 2,1, 
derlenmiş normal ifadeler ve benefitted <t > 1 den yayılmasınayönelik destek eklendi. ASP.NET Core 2,2 HTTP/2 
desteği eklendi. AS P.N ET Core 3,0, bellek kullanımını azaltan ve üretilen işi geliştiren birçok geliştirme ekler . 
Performans bir önceliktir, AS P.N ET Core güncel sürümüne yükseltmeyi göz önünde bulundurun. 

Özel durumları Küçült 

Özel durumlar nadir olmalıdır. Özel durumları oluşturma ve yakalama, diğer kod akışı desenlerine göre yavaş olur. 
Bu nedenle, normal program akışını denetlemek için özel durumlar kullanılmamalıdır. 

Öneri 

• Özel durumları, özellikle de sık erişimli kod yollarındanormal program akışının bir yolu olarak oluşturma veya 

yakalama kullanmayın. 

• Özel duruma neden olacak koşulları tespit etmek ve işlemek için uygulamaya mantığı dahil edin . 

• Olağan dışı veya beklenmedik koşullarda özel durumlar oluşturun veya yakalayın. 

Application Insights gibi uygulama tanılama araçları, bir uygulamadaki performansı etkileyebilecek ortak özel 
durumları belirlemesine yardımcı olabilir. 

Performans ve güvenilirlik 

Aşağıdaki bölümlerde performans ipuçları ve bilinen güvenilirlik sorunları ve çözümleri sağlanmaktadır. 

HttpRequest/HttpResponse gövdesinde zaman uyumlu okuma veya 
yazma yapmaktan kaçının 

ASP.NET Core içindeki tüm GÇ zaman uyumsuzdur.Sunucular, hem zaman uyumlu hem de zaman uyumsuz aşırı 
yüklemeleri olan stream arabirimini uygular. İş parçacığı havuzu iş parçacıklarını engellemeyi önlemek için zaman 
uyumsuz olanlar tercih edilmelidir. İş parçacıklarını engelleme, iş parçacığı havuzunda ortaya çıkmasına neden 
olabilir. 

Bunu yapın: Aşağıdaki örnek ReadToEndkullanır. Sonuç için beklemek üzere geçerli iş parçacığını engeller. Bu, 

zaman uyumsuz olarak eşitlemeörneğidir. 





public class BadStreamReaderController : Controller 

{ 

[HttpGet("/contoso")] 

public ActionResult<ContosoData> Get() 

{ 

var json = new StreamReader(Request.Body).ReadToEnd(); 
r0turn JsonSerializer.Deserialize<ContosoData>(json); 

} 

} 

Yukarıdaki kodda, G 0 t HTTP istek gövdesinin tamamını belleğe eşzamanlı olarak okur, istemci yavaş karşıya 
yüklendikten sonra, uygulama zaman uyumsuz olarak eşitlenir. Kestrel zaman uyumlu okumaları 
desteklemediğinden, uygulama zaman uyumsuz olarak eşitlenir. 

Bunu yapın: Aşağıdaki örnek ReadToEndAsync kullanır ve okurken iş parçacığını engellemez. 

public class GoodStr0amR0ad0rControlİ0r : Controller 

{ 

[HttpG0t("/contoso")] 

public async Task<ActionR0sult<ContosoData>> G0t() 

{ 

var json = await new StreamReader(Request.Body).ReadToEndAsync(); 
return IsonSerializer.D0S0rializ0<ContosoData>(json); 

} 

} 

Yukarıdaki kod, HTTP istek gövdesinin tamamını belleğe zaman uyumsuz olarak okur. 


VVARNING 

istek büyükse HTTP istek gövdesinin tamamını belleğe okumak bellek yetersiz (OOM) koşuluna yol açabilir. OOM, hizmet 
reddine neden olabilir. Daha fazla bilgi için, bu belgedeki büyük istek gövdelerini veya Yanıt gövdelerinin belleğe okunmasını 
önleyin . 


Bunu yapın: Aşağıdaki örnek, arabelleğe alınmamış bir istek gövdesi kullanılarak tamamen zaman uyumsuzdur: 

public class GoodStreamReaderController : Controller 

{ 

[HttpGet("/contoso")] 

public async Task<ActionResult<ContosoData>> Get() 

{ 

return await IsonSerializer.DeserializeAsync<ContosoData>(Request.Body); 

} 

} 

Yukarıdaki kod, istek gövdesini bir C# nesneye zaman uyumsuz olarak serileştirir. 

İstek üzerinde ReadFormAsync tercih et. form 

Kullanım HttpContext.Request. ReadFormAsync yerine HttpContext. Request. Form . HttpContext.Request.Form , yalnızca 
aşağıdaki koşullara göre güvenle okunabilir: 

• Form, ReadFormAsync çağrısıyla okundu ve 

• Önbelleğe alınmış form değeri HttpContext.Request.Form kullanılarak okunmakta 












Bunu yapın: Aşağıdaki örnek HttpContext.Request.Form kullanır. HttpContext.Request.Form , zaman uyumsuz olarak 
eşitleme kullanır ve iş parçacığı havuzuna yol açabilir. 

public class BadReadController : Controller 
{ 

[HttpPost("/form-body")] 
public IActionResult Post() 

{ 

var form = HttpContext.Request.Form; 

Process(form["id "], form["name"]); 
return Accepted(); 

} 

Bunu yapın: Aşağıdaki örnek, form gövdesini zaman uyumsuz olarak okumak için 
HttpContext. Request. ReadFormAsync kullanır. 

public class GoodReadController : Controller 
{ 

[HttpPost("/form-body")] 

public async Task<IActionResult> Post() 

{ 

var form = await HttpContext.Request.ReadFormAsync(); 

Process(form["id "], form["name"]); 
return Accepted(); 

} 


Büyük istek gövdelerini veya yanıt gövdelerini belleğe okumaktan 
kaçının 

,N ET ' te, 85 KB 'den büyük olan her nesne ayırması büyük nesne yığınında (Loh) sona erer. Büyük nesneler iki 
şekilde pahalıdır: 

• Yeni ayrılan büyük bir nesne için belleğin temizlenmesi gerektiğinden, ayırma maliyeti yüksektir.CLR, tüm yeni 
ayrılmış nesneler için belleğin temizlenmiş olmasını garanti eder. 

• LOH, yığının geri kalanı ile toplanır. LOH, tam atık toplama veya Gen2 koleksiyonugerektirir. 

Bu blog gönderisi succinctly sorununu açıklar: 

Büyük bir nesne ayrıldığında, Gen 2 nesnesi olarak işaretlenir. Küçük nesneler için Gen O değildir.Sonuçlar 
LOH 'de bellek tükeniyorsa, GC yalnızca LOH değil, yönetilen yığının tamamını temizler. Bu nedenle, LOH 
dahil olmak üzere Gen O, Gen 1 ve Gen 2 ' yi temizler. Bu, tam atık toplama olarak adlandırılır ve en çok 
kullanılan çöp toplamadır. Birçok uygulama için kabul edilebilir. Ancak, ortalama bir web isteğini işlemek için 
çok büyük bellek arabelleklerinin (bir yuvadan okunan, sıkıştırmayı açık olan JSON & daha fazla kod çözme) 
gerekli olduğu yüksek performanslı Web sunucuları için kesinlikle değildir. 

Büyük bir istek veya Yanıt gövdesini tek bir bytef] veya string olarak depolar. 

• LOH 'de hızlı bir şekilde boş alan tükenmenize neden olabilir. 

• Çalıştıran tam GC 'Ler nedeniyle uygulama için performans sorunlarına neden olabilir. 


Zaman uyumlu veri işleme API 'SI ile çalışma 







Yalnızca zaman uyumlu okuma ve yazma işlemlerini destekleyen bir serileştirici/devre dışı bırakma kullanılırken 
(örneğin, JSON.net): 

• Verileri seri hale getirici/devre dışı serileştiriciye geçirmeden önce zaman uyumsuz olarak belleğe arabelleğe ın. 


VVARNING 

İstek büyükse, bellek yetersiz (OOM) koşuluna yol açabilir. OOM, hizmet reddine neden olabilir. Daha fazla bilgi için, bu 
belgedeki büyük istek gövdelerini veya Yanıt gövdelerinin belleğe okunmasını önleyin . 


ASP.NET Core 3,0, JSON serileştirme için varsayılan olarak System.Text.Json kullanır. System.Text.Json: 

• JSON 'yi zaman uyumsuz olarak okur ve yazar. 

• UTF-8 metni için iyileştirilmiştir. 

• Genellikle Newtonsoft. 3 son kıyasla daha yüksek performans. 

Bir alanda ıhttpcontextaccessor. HttpContext depolamayın 

lhttpcontextaccessor. HttpContext , istek iş parçacığından erişildiğinde etkin isteğin HttpContext döndürür. 
mttpContextAccessor.HttpContext , bir alan veya değişkende depolanmamalıdır. 

Bunu yapın: Aşağıdaki örnek, HttpContext bir alanda depolar ve daha sonra kullanmaya çalışır. 

public class MyBadType 
{ 

private readonly HttpContext _context; 
public MyBadType(IHttpContextAccessor accessor) 

{ 

_context = accessor.HttpContext; 

} 

public void CheckAdmin() 

{ 

if (!_context.User.IsInRole("admin")) 

{ 

throw new UnauthorizedAccessException("The current user isn't an admin"); 

} 

} 

} 

Yukarıdaki kod, oluşturucuda genellikle null veya yanlış HttpContext yakalar. 

Bunu yapın: Aşağıdaki örnek: 

• IHttpContextAccessor bir alana depolar. 

• Doğru zamanda HttpContext alanını kullanır ve null denetler. 










public class MyGoodType 

{ 

private readonly IHttpContextAccessor _accessor; 
public MyGoodType(IHttpContextAccessor accessor) 

{ 

_accessor = accessor; 

> 

public void CheckAdmin() 

{ 

var context = _accessor.HttpContext; 

if (context != null && !context.User.IsInRole("admin")) 

{ 

throw new UnauthorizedAccessException("The current user isn't an admin"); 

} 

} 


Birden çok iş parçacığından HttpContext 'e erişme 

HttpContext , iş parçacığı açısından güvenli değildir . Paralel olarak birden çok iş parçacığından HttpContext 
erişilmesi, askıda kalma, kilitlenme ve veri bozulması gibi tanımsız davranışlara neden olabilir. 

Bunu yapın: Aşağıdaki örnek üç paralel istek yapar ve giden HTTP isteğinden önce ve sonra gelen istek yolunu 
günlüğe kaydeder, istek yoluna, potansiyel olarak paralel olarak birden çok iş parçacığından erişilir. 


public class AsyncBadSearchController : Controller 

{ 

[HttpGet("/search")] 

public async Task<SearchResults> Get(string query) 

{ 

var queryl = SearchAsync(SearchEngine.Google, query); 
var query 2 = SearchAsync(SearchEngine.Bing, query); 
var query 3 = SearchAsync(SearchEngine.DuckDuckGo, query); 

await Task.WhenAll(queryl, query 2 , query 3 ); 

var resultsl = await queryl; 
var results 2 = await query 2 ; 
var results 3 = await query 3 ; 

return SearchResults.Combine(resultslj results 2 , results 3 ); 

} 


private async Task<SearchResults> SearchAsync(SearchEngine engine, string query) 

{ 

var searchResults = _searchService.Empty(); 
try 
{ 

_logger.LogInformation("Starting search query from {path}.", 

HttpContext.Request.Path); 

searchResults = _searchService.Search(engine, query); 

_logger.LogInformation("Finishing search query from {path}.", 

HttpContext.Request.Path); 

} 

catch (Exception ex) 

{ 

_logger.LogError(ex, "Failed query from {path}", 

HttpContext.Request.Path); 


} 


} 


return await searchResults; 





Bunu yapın: Aşağıdaki örnek, üç paralel isteği yapmadan önce gelen istekten tüm verileri kopyalar. 

public class AsyncGoodSearchController : Controller 

{ 

[HttpGet("/search")] 

public async Task<SearchResults> Get(string query) 

{ 

string path = HttpContext.Request.Path; 
var queryl = SearchAsync(SearchEngine.Google, query, 
path); 

var query2 = SearchAsync(SearchEngine.Bing, query, path); 
var query3 = SearchAsync(SearchEngine.DuckDuckGo, query, path); 

await Task.WhenAll(queryl, query2, query3); 

var resultsl = await queryl; 

var results2 = await query2; 

var results3 = await query3; 

return SearchResults.Combine(resultsl, results2, results3); 

} 

private async Task<SearchResults> SearchAsync(SearchEngine engine, string query, 

string path) 

{ 

var searchResults = _searchService.Empty(); 
try 
{ 

_logger.LogInformation("Starting search query from {path}.", 
path); 

searchResults = await _searchService.SearchAsync(engine, query); 

_logger.LogInformation("Finishing search query from {path}.", path); 

} 

catch (Exception ex) 

{ 

_logger.LogError(ex, "Failed query from {path}", path); 

} 

return await searchResults; 

} 


İstek tamamlandıktan sonra HttpContext 'i kullanma 

HttpContext , ASP.NET Core ardışık düzeninde etkin bir HTTP isteği olduğu sürece geçerlidir.Tüm ASP.NET Core 
işlem hattı, her isteği yürüten zaman uyumsuz temsilciler zinciridir. Bu zincirden döndürülen Task 
tamamlandığında HttpContext geri dönüştürülür. 

Bunu yapın: Aşağıdaki örnek, ilk await ulaşıldığında HTTP isteğini tamamlamasını sağlayan async void 
kullanır: 

• ASP.NET Core uygulamalarda bu her zaman hatalı bir uygulamadır. 

• HTTP isteği tamamlandıktan sonra HttpResponse erişir. 

• işlemi çöker. 










public class AsyncBadVoidController : Controller 

{ 

[HttpGet("/async")] 
public async void Get() 

{ 

await Task.Delay(1000); 

// The following üne will crash the process because of writing after the 
// response has completed on a background thread. Notice async void Get() 

await Response.WriteAsync("Hello World"); 

} 

} 


Bunu yapın: Aşağıdaki örnek, işlem tamamlanana kadar HTTP isteğinin tamamlanmaması için çerçeveye bir 
Task döndürür. 

public class AsyncGoodTaskController : Controller 

{ 

[HttpGet("/async")] 
public async Task Get() 

{ 

await Task.Delay(1000); 

await Response.WriteAsync("Hello World"); 

} 

} 


Arka plan iş parçacıklarında HttpContext 'i yakalama 

Bunu yapın: Aşağıdaki örnek, bir kapanışın controller özelliğinden HttpContext yakalamadığını gösterir. Bu 
kötü bir uygulamadır çünkü iş öğesi şu şekilde olabilir: 

• İstek kapsamının dışında çalıştırın. 

• Yanlış HttpContext okuma girişimi. 

[HttpGet("/fire-and-forget-1")] 
public IActionResult BadFireAndForget() 

{ 

_ = Task.Run(async () => 

{ 

await Task.Delay(1000); 

var path = HttpContext.Request.Pathj 
Log(path); 

}); 

return Accepted(); 

} 

Bunu yapın: Aşağıdaki örnek: 

• İstek sırasında arka plan görevinde gereken verileri kopyalar. 

• Denetleyiciden hiçbir şeye başvurmuyor. 







[HttpGet("/fire-and-forget-3")] 
public IActionResult GoodFireAndForget() 

{ 

string path = FlttpContext.Request.Path; 

_ = Task.Run(async () => 

{ 

await Task.Delay(1000); 

Log(path); 

}); 

return Accepted(); 

} 

Arka plan görevleri barındırılan hizmet olarak uygulanmalıdır. Daha fazla bilgi için bkz. barındırılan hizmetlerle 
arka plan görevleri. 

Arka plan iş parçacıklarında denetleyicilere eklenen Hizmetleri 
yakalama 

Bunu yapın: Aşağıdaki örnek, bir kapanışın controiler eylem parametresinden DbContext yakalamadığını 
gösterir. Bu kötü bir uygulamadır.iş öğesi, istek kapsamı dışında çalıştırılabilir. contosoDbContext , isteğin kapsamına 
alınır ve 0bjectDisposedException sonuçlanır. 

[HttpGet("/fire-and-forget-1")] 

public IActionResult FireAndForgetl([FromServices]ContosoDbContext context) 

{ 

_ = Task.Run(async () => 

{ 

await Task.Delay(1000); 

context.Contoso.Add(new Contoso()); 
await context.SaveChangesAsync(); 

}); 

return Accepted(); 

} 

Bunu yapın: Aşağıdaki örnek: 

• Arka plan iş öğesinde kapsam oluşturmak için bir IServiceScopeFactory çıkartır. ıserviceScopeFactory tek bir. 

• Arka plan iş parçacığında yeni bir bağımlılık ekleme kapsamı oluşturur. 

• Denetleyiciden hiçbir şeye başvurmuyor. 

• Gelen istekten contosoDbContext yakalamaz. 










[HttpGet("/fire-and-forget-3")] 

public IActionResult FireAndForget3([FromServices]IServiceScopeFactory 

serviceScopeFactory) 


{ 


_ = Task.Run(async () => 

{ 


await Task.Delay(1000); 


using (var scope = serviceScopeFactory.CreateScope()) 

{ 

var context = scope.ServiceProvider.GetRequiredService<ContosoDbContext>(); 


context.Contoso.Add(new Contoso()); 


await context.SaveChangesAsync(); 

} 

}); 


return Accepted(); 

} 


Aşağıdaki vurgulanan kod: 

• Arka plan işleminin yaşam süresi boyunca bir kapsam oluşturur ve Hizmetleri bundan çözer. 

• Doğru kapsamdan contosoDbContext kullanır. 


[HttpGet("/fire-and-forget-3")] 

public IActionResult FireAndForget3([FromServices]IServiceScopeFactory 

serviceScopeFactory) 


{ 


_ = Task.Run(async () => 

{ 


await Task.Delay(1000); 


using (var scope = serviceScopeFactory.CreateScope()) 

{ 

var context = scope.ServiceProvider.GetRequiredService<ContosoDbContext>(); 


context.Contoso.Add(new Contoso ()); 


await context.SaveChangesAsync(); 

} 

}); 

return Accepted(); 


Yanıt gövdesi başlatıldıktan sonra durum kodunu veya başlıkları 
değiştirmeyin 

ASP.NET Core HTTP yanıt gövdesini arabelleğe almaz. Yanıtın ilk yazıldığı zaman: 

• Üst bilgiler, bu gövdenin öbek ile birlikte gönderilir. 

• Artık yanıt üst bilgilerini değiştirmek mümkün değildir. 


Bunu yapın: Aşağıdaki kod, yanıt önceden başlatıldıktan sonra yanıt üst bilgileri eklemeye çalışır: 





app.Use(async (context, next) => 

{ 

await next(); 

context.Response.Headers["test"] = "test value"; 

}); 

Önceki kodda, next() yanıta yazılmışsa context.Response.Headers["test"] = "test value"; bir özel durum 
oluşturur. 

Bunu yapın: Aşağıdaki örnek, üst bilgileri değiştirmeden önce HTTP yanıtının başlatılıp başlatılmadığını denetler. 

app.Use(async (context, next) => 

{ 

await next(); 

if (!context.Response.HasStarted) 

{ 

context.Response.Headers["test"] = "test value"; 

} 

}); 

Bunu yapın: Aşağıdaki örnek, yanıt üst bilgileri istemciye temizlenmeden önce üst bilgileri ayarlamak için 
HttpResponse.OnStarting kullanır. 

Yanıtın başlatılmamış olup olmadığı denetleniyor yanıt üst bilgileri yazılmadan önce çağrılacak geri aramanın 
kaydedilmesini sağlar. Yanıtın başlatılmamış olup olmadığı denetleniyor: 

• Başlıkları tam zamanında ekleme veya geçersiz kılma olanağı sağlar. 

• İşlem hattındaki bir sonraki ara yazılım hakkında bilgi gerektirmez. 

app.Use(async (context, next) => 

{ 

context.Response.OnStarting(() => 

{ 

context.Response.Headers["someheader"] = "somevalue"; 
return Task.CompletedTask; 

}); 

await next(); 

}); 


Yanıt gövdesine yazmaya başladıysanız ileri () çağrısı yapın 

Bileşenler yalnızca yanıtı işlemek ve işlemek için mümkünse çağrılabilir. 
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Bellek yönetimi, .N ET gibi yönetilen bir çerçevede bile karmaşıktır. Bellek sorunlarını analiz etmek ve anlamak zor 
olabilir. Bu makalede: 

• , Çok fazla bellek sızıntısı ve GC çalışmasız sorunlar tarafından tetiklendi. Bu sorunların çoğu, bellek tüketiminin 
.NET Core 'da nasıl çalıştığını Anlamamasından veya nasıl ölçüleceğini anlayamadığında oluşur. 

• Sorunlu bellek kullanımını gösterir ve alternatif yaklaşımlar önerir. 

Çöp toplama (GC) .NET Core 'da nasıl kullanılır 

GC, her segmentin bitişik bellek aralığı olduğu yığın kesimlerini ayırır.Yığına yerleştirilmiş nesneler 3 nesilden 
birine kategorize edilir: 0,1 veya 2. Oluşturma, GC 'nin, uygulama tarafından artık başvurulmayan yönetilen 
nesneler üzerinde bellek serbest bırakmaya yönelik sıklığı belirler. Daha düşük numaralandırılmış nesiller GC daha 
sık kullanılır. 

Nesneler, yaşam sürelerinin ömrü temelinde bir neslin diğerine taşınır. Nesneler daha uzun bir süre içinde 
yaşlılarsa daha yüksek bir oluşturmaya taşınır. Daha önce belirtildiği gibi, daha yüksek neslikler GC 'yi daha 
düşüktür. Kısa vadeli süreli nesneler her zaman nesil 0 1 da kalır.Örneğin, bir Web isteğinin ömrü boyunca 
başvurulan nesneler kısa ömürlü değildir. Uygulama düzeyi tekton genellikle 2. nesil 'e geçirilir. 

ASP.NET Core bir uygulama başlatıldığında GC: 

• ilk yığın kesimleri için bazı belleği ayırır. 

• Çalışma zamanı yüklenirken belleğin küçük bir bölümünü kaydeder. 

Önceki bellek ayırmaları performans nedenleriyle yapılır. Performans avantajı, ardışık bellekteki yığın kesimlerinden 
gelir. 

GC 'yi çağırın. Topladıktan 

GC çağrılıyor. Açıkça topla: 

• , Üretim ASP.NET Core uygulamaları tarafından yapılmamalıdır. 

• Bellek sızıntılarını araştırırken faydalıdır. 

• inceleme yaparken, GC 'nin tüm sallaştırılmış nesneleri bellekten kaldırdığını doğrular, böylece bellek 
ölçülenebilir. 

Uygulamanın bellek kullanımını analiz etme 

Adanmış araçlar bellek kullanımının analiz edilmesine yardımcı olabilir: 

• Nesne başvurularını sayma 

• GC 'nin CPU kullanımında ne kadar etkili olduğunu ölçme 

• Her nesil için kullanılan bellek alanını ölçme 

Bellek kullanımını çözümlemek için aşağıdaki araçları kullanın: 


• DotNet-Trace: üretim makinelerinde kullanılabilir. 




• Visual Studio hata ayıklayıcısı olmadan bellek kullanımını analiz etme 

• Visual Studio'da bellek kullanımının profilini oluşturma 

Bellek sorunlarını algılama 

Görev Yöneticisi, bir ASP.NET uygulamasının ne kadar bellek kullandığını gösteren bir fikir almak için kullanılabilir. 
Görev Yöneticisi bellek değeri: 

• ASP.NET işlemi tarafından kullanılan bellek miktarını temsil eder. 

• Uygulamanın oturma nesnelerini ve yerel bellek kullanımı gibi diğer bellek tüketicilerini içerir. 

Görev Yöneticisi bellek değeri sonsuza kadar artıyorsa ve hiçbir şekilde düzermez, uygulamanın bellek sızıntısı 
vardır. Aşağıdaki bölümlerde, çeşitli bellek kullanımı desenleri gösterilmektedir ve açıklanmaktadır. 

Örnek görüntüleme belleği kullanım uygulaması 

Memoryleak örnek uygulaması GitHub 1 da kullanılabilir.MemoryLeak uygulaması: 

• , Uygulamanın gerçek zamanlı bellek ve GC verilerini toplayan bir tanılama denetleyicisi içerir. 

• , Bellek ve GC verilerini görüntüleyen bir dizin sayfasına sahiptir. Dizin sayfası her saniye yenilenir. 

• Çeşitli bellek yük desenleri sağlayan bir API denetleyicisi içerir. 

• Desteklenen bir araç değildir, ancak ASP.NET Core uygulamaların bellek kullanım düzenlerini göstermek için 
kullanılabilir. 

MemoryLeak 'yi çalıştırın. Ayrılan bellek, GC gerçekleşene kadar yavaş artar. Araç, verileri yakalamak için özel 
nesne ayırdığından bellek artar. Aşağıdaki görüntüde bir gen 0 GC gerçekleştiğinde MemoryLeak Dizin sayfası 
gösterilmektedir. API denetleyicisinden API uç noktası çağrılmadığından grafik 0 RPS (saniye başına İstek) gösterir. 
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20 MB 


0 MB 
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Grafik, bellek kullanımı için iki değer görüntüler: 

• Ayrılan: yönetilen nesnelerin kapladığı bellek miktarı 

• Çalışma kümesi: Şu anda fiziksel bellekte bulunan işlemin sanal adres alanındaki sayfa kümesi. Gösterilen 
çalışma kümesi, Görev Yöneticisi 'nin görüntülediği değerdir. 

Geçici nesneler 

Aşağıdaki API 10 KB 'lik bir dize örneği oluşturur ve istemciye döndürür. Her istekte, bellekte yeni bir nesne ayrılır 





ve yanıta yazılır. Dizeler .N ET 'te UTF-16 karakter olarak depolanır, böylece her karakter bellekte 2 bayt sürer. 


[HttpGet("bigstring")] 

public ActionResult<string> GetBigString() 

{ 

return new String('x’, 10 * 1024); 

} 

Aşağıdaki grafik,' de, bellek ayırmalarının GC tarafından nasıl etkilendiğini göstermek için görece küçük bir yük ile 
oluşturulmuştur. 


Allocated 


I VVorking Set 


Gen 0 


Gen 1 


Gen 2 


CPU (12%) 


600 MB 


RPS (4K) 


500 MB 


400 MB 



Yukarıdaki grafik şunları gösterir: 

• 4K RPS (saniye başına İstek). 

• Nesil 0 GC koleksiyonları her iki saniyede bir gerçekleşir. 

• Çalışma kümesi yaklaşık 500 MB 'tan sabittir. 

• CPU %12 ' dir. 

• Bellek tüketimi ve sürümü (GC aracılığıyla) kararlı bir şekilde yapılır. 


Aşağıdaki grafik, makine tarafından işlenebilen en fazla aktarım hızı üzerinden alınır. 





I Allocated 


| VVorlring Set 


Gen 0 


Gen 1 


Gen 2 


CPU (33%) 


RPS (22 K) 


600 MB 


500 MB 


400 MB 



Yukarıdaki grafik şunları gösterir: 

• 22K RPS 

• Nesil 0 GC koleksiyonları saniye başına birkaç kez gerçekleşir. 

• 1. nesil koleksiyonlar, uygulama saniye başına önemli ölçüde daha fazla bellek ayırdığından tetiklenir. 

• Çalışma kümesi yaklaşık 500 MB 'tan sabittir. 

• CPU %33 ' dir. 

• Bellek tüketimi ve sürümü (GC aracılığıyla) kararlı bir şekilde yapılır. 

• CPU (%33) aşırı kullanılmaz, bu nedenle çöp toplama işlemi yüksek sayıda ayırma ile devam edebilir. 

VVorkstation GC vs. Server GC 

.N ET atık toplayıcısı 'nda iki farklı mod vardır: 

• İş İstasyonu GC: Masaüstü için iyileştirildi. 

• Sunucu GC. ASP.NET Core uygulamalar için varsayılan GC. Sunucu için iyileştirildi. 

GC modu proje dosyasında veya yayımlanan uygulamanın runtimeconfig. JSON dosyasında açıkça ayarlanabilir. 
Aşağıdaki biçimlendirme proje dosyasında ServerGarbageCollection ayarlamayı gösterir: 

<PropertyGroup> 

ServerGarbageCollection>true</ServerGarbageCollection> 

</PropertyGroup> 

Proje dosyasında ServerGarbageCollection değiştirmek için uygulamanın yeniden oluşturulması gerekir. 

Note: Sunucu çöp toplama, tek çekirdekli makinelerde kullanılamaz. Daha fazla bilgi için bkz. IsServerGC. 
Aşağıdaki görüntüde, VVorkstation GC kullanarak bir 5K RPS altındaki bellek profili gösterilmektedir. 
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40 MB 

30 MB 
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10 MB 

0 MB- 



Bu grafik ve sunucu sürümü arasındaki farklar önemlidir: 

• Çalışma kümesi 500 MB ile 70 MB arasında bırakılır. 

• GC, her iki saniyede yerine saniyede birden çok kez 1. nesil koleksiyonu yapar. 

• GC 300 MB 'den 10 MB 'a düşün. 

Tipik bir Web sunucusu ortamında CPU kullanımı bellekten daha önemlidir, bu nedenle sunucu GC daha iyidir. 
Bellek kullanımı yüksekse ve CPU kullanımı nispeten düşükse, İş İstasyonu GC daha iyi olabilir.Örneğin, belleğin 
scarce olduğu çeşitli Web uygulamalarını barındıran yüksek yoğunluklu. 

Kalıcı nesne başvuruları 

GC, başvurulan nesneleri serbest olamaz. Başvurulan ancak artık gerekli olmayan nesneler bellek sızıntısına neden 
olur. Uygulama genellikle nesneleri ayırırsa ve artık gerekli olmadıklarında bunları boşaltamazsa, bellek kullanımı 
zaman içinde artar. 

Aşağıdaki API 10 KB lik bir dize örneği oluşturur ve istemciye döndürür.Önceki örnekle aradaki fark, bu örneğe 
statik bir üye tarafından başvuruluyorsa, yani koleksiyon için hiçbir şekilde kullanılamaz. 

private static ConcurrentBag<string> _staticStrings = new ConcurrentBag<string>(); 

[HttpGet("staticstring") ] 

public ActionResult<string> GetStaticString() 

{ 

var bigString = new String('x', 10 * 1024); 

_staticStrings.Add(bigString); 
return bigString; 

} 

Yukarıdaki kod: 

• Tipik bir bellek sızıntısı örneğidir. 

• Sık yapılan çağrılar sayesinde, işlem bir outof Memory özel durumuyla kilitlenene kadar uygulama belleğinin 
artmasına neden olur. 







Allocated ^^B Workıng Set ^^B Gen 0 Gen 1 Gen 2 CPU (12%) RPS (4K) 


3000 MB 



0 MB- 

Önceki görüntüde: 

• Yük testi /api/staticstring uç noktası bellekte doğrusal artışa neden olur. 

• GC, bellek baskısı arttıkça 2. nesil bir koleksiyon çağırarak belleği boşaltmaya çalışır. 

• GC, sızdırılan belleği serbest olamaz. Ayrılan ve çalışma kümesi zaman ile artar. 

Önbelleğe alma gibi bazı senaryolar, bellek baskısı serbest bırakılana kadar nesne başvurularının tutulmasını 
gerektirir. VVeakReference sınıfı bu tür bir önbelleğe alma kodu için kullanılabilir. weakReference nesnesi bellek 
baskılarına altında toplanır. I MemoryCache varsayılan uygulama ueakReference kullanır. 

Yerel bellek 

Bazı .NET Core nesneleri yerel belleğe bağımlıdır.Yerel bellek GC tarafından toplanamaz. Yerel bellek kullanan 
.N ET nesnesi yerel kod kullanarak onu serbest vermelidir. 

.NET, geliştiricilerin yerel bellek yayınlamasına izin vermek için IDİsposable arabirimi sağlar. Dispose çağrılmasa 
bile, Sonlandırıcı çalıştığında doğru uygulanmış sınıflar çağrı Dispose . 

Aşağıdaki kodu inceleyin: 

[HttpGet("fileprovider")] 
public void GetFileProvider() 

{ 

var fp = new PhysicalFileProvider(TempPath); 
fp.Watch( 

} 

PhysicaFileProvider yönetilen bir sınıftır, bu nedenle isteğin sonunda herhangi bir örnek toplanacaktır. 

Aşağıdaki görüntüde fileprovider API 'sini sürekli çağırırken bellek profili gösterilmektedir. 







^^■Allocated Working Set ^^B Gen 0 ^^B Gen 1 Gen 2 _< CPU (10%) I RPS(IK) 

1600 MB 



800 MB 

600 MB 

400 MB 

200 MB 

OMB-^- 

Yukarıdaki grafikte, bu sınıfın uygulanmasıyla ilgili olarak, bellek kullanımının artmasının devam eden belirgin bir 
sorun gösterilmektedir. Bu, Bu soruniçinde izlenmekte olan bilinen bir sorundur. 

Kullanıcı kodunda, aşağıdakilerden biri ile aynı sızıntı gerçekleşecektir: 

• Sınıf doğru şekilde serbest bırakılmıyor. 

• Atılmalıdır bağımlı nesnelerin Dispose yöntemini çağırmak için. 

Büyük nesne yığını 

Sık bellek ayırma/ücretsiz döngüler, özellikle büyük bellek öbekleri ayrılırken belleği parçalara ayırıyor.Nesneler 
bitişik bellek bloklarına ayrılır. Parçalanmayı azaltmak için, GC belleği serbest bırakır.Bu işleme sıkıştırmaadı verilir. 
Sıkıştırma, nesneleri taşımayı içerir.Büyük nesnelerin taşınması, bir performans cezası getirir.Bu nedenle GC, 
büyük nesne yığını (LOH) olarak adlandırılan büyük nesneler için özel bir bellek bölgesi oluşturur. 85.000 bayttan 
(yaklaşık 83 KB) büyük olan nesneler şunlardır: 

• LOH 'yeyerleştirildi. 

• Düzenlenmedi. 

• 2. nesil oluşturma sırasında toplanır. 

LOH dolduğunda GC, 2. nesil bir koleksiyon tetikleyecektir.2. nesil Koleksiyonlar: 

• Doğal olarak yavaştır. 

• Ayrıca, diğer tüm neslerde bir koleksiyonun tetiklenmesi için de ücret uygulanır. 

Aşağıdaki kod, LOH 'yi hemen sıkıştırır: 

GCSettings.LargeObjectHeapCompactionMode = GCLargeObjectHeapCompactionMode.CompactOnce; 

GC.Collect(); 

LOH 'yi düzenleme hakkında bilgi için bkz. LargeObjectHeapCompactionMode. 

.NET Core 3,0 ve üstünü kullanan kapsayıcılarda LOH otomatik olarak sıkıştırılır. 


Bu davranışı gösteren aşağıdaki API: 






[HttpGet("loh/{size=85000}")] 

public int GetLOHl(int size) 

{ 

retunn new byte[size].Length; 

} 

Aşağıdaki grafikte, en fazla yük altında /api/ioh/84975 uç noktası çağırma bellek profili gösterilmektedir: 

Allocated Worlang Set Gen 0 Gen 1 Gen 2 CPU (64%) RPS (35K) 

450 MB 


400 MB 

350 MB 


300 MB 



Aşağıdaki grafikte /api/ioh/84976 uç noktası çağırma bellek profili gösterilmektedir veyalmzca bir bayt 
daha ayrılıyor: 


Allocated 


| Worlang Set 


Gen 0 


Gen 1 


Gen 2 


CPU (71%) : RPS (18K) 


450 MB 

400 MB 

350 MB 

300 MB 

250 MB 

200 MB 

150 MB 

100 MB 

50 MB 

0 MB 



Note: byte[] yapısının ek yük baytları vardır. Bu nedenle 84.976 bayt 85.000 limitini tetikler. 

Önceki iki grafik karşılaştırılıyor: 

• Çalışma kümesi, yaklaşık 450 M B olmak üzere her iki senaryo için de benzerdir. 

• Altındaki LOH istekleri (84.975 bayt), çoğunlukla nesil 0 koleksiyonlarını gösterir. 

• Över LOH istekleri, sabit 2. nesil koleksiyonlar üretir.2. nesil koleksiyonlar pahalıdır. Daha fazla CPU gerekir ve 
verimlilik neredeyse %50 1 a düşyordu. 













Geçici büyük nesneler özellikle sorunlu olduğundan Gen2 GCs 'ye neden olur. 

En yüksek performans için büyük nesne kullanımı küçültülmüş olmalıdır.Mümkünse, büyük nesneleri ayırın. 
Örneğin, yanıt önbelleğe alma ara yazılımı ASP.NET Core önbellek girişlerini 85.000 bayttan daha az blok halinde 
ayırır. 

Aşağıdaki bağlantılarda, LOH sınırı altına nesneleri tutma ASP.NET Core yaklaşımı gösterilmektedir: 

• ResponseCaching/Streams/Streammutilities. cs 

• ResponseCaching/MemoryResponseCache. cs 

Daha fazla bilgi için bkz. 

• Büyük nesne yığını kapsanmamış 

• Büyük nesne yığını 

HttpClient 

HttpClient kullanarak yanlış bir kaynak sızıntısına neden olabilir. Veritabanı bağlantıları, yuvalar, dosya tutamaçları 
vb. gibi sistem kaynakları: 

• , Bellekten daha fazla. 

• Bellekten sızmış olduğunda daha sorunlu sorun vardır. 

Deneyimli .NET geliştiricileri, IDİsposableuygulayan nesnelerde Dispose çağırılacağını bilir. iDisposable uygulayan 
nesneleri elden atma, genellikle sızdırılan bellek veya sızdırılan sistem kaynaklarına neden olur. 

HttpClient iDisposable uygular, ancak her çağrıdan atılmamalıdır. Bunun yerine HttpClient yeniden 
kullanılmalıdır. 

Aşağıdaki uç nokta her istekte yeni bir HttpClient örneği oluşturur ve atar: 

[HttpGet("httpclientl")] 

public async Task<int> GetHttpClientl(string url) 

{ 

using (var httpClient = new HttpClient()) 

{ 

var result = await httpClient.GetAsync(url); 
return (int)result.StatusCode; 

} 

} 


Yük altında aşağıdaki hata iletileri günlüğe kaydedilir: 

fail: Microsoft.AspNetCore.Server.Kestrel[13] 

Connection id "0HLG70PBE1CR1", Request id "0HLG70PBE1CR1:00000031": 

An unhandled exception was thrown by the application. 

System.Net.Http.HttpRequestException: Only one usage of each Socket address 
(protocol/network address/port) is normally permitted —> 

System.Net.Sockets.SocketException: Only one usage of each Socket address 
(protocol/network address/port) is normally permitted 
at System.Net.Http.ConnectHelper.ConnectAsync(String hoşt, Int32 port, 

CancellationToken cancellationToken) 

HttpClient örnekleri atılsa da, gerçek ağ bağlantısının işletim sistemi tarafından yayımlanması zaman alır. Sürekli 
olarak yeni bağlantılar oluşturarak bağlantı noktaları tükenmesi oluşur. Her istemci bağlantısı kendi istemci 
bağlantı noktasını gerektirir. 

Bağlantı noktası tükenmesi 'ni önlemenin bir yolu aynı HttpClient örneğini yeniden kullanmaktır: 









private static readonly HttpClient _httpClient = new HttpClient(); 

[HttpGet("httpclient2")] 

public async Task<int> GetHttpClient2(string url) 

{ 

var result = await _httpClient.GetAsync(url); 
return (int)result.StatusCode; 

} 

HttpClient örneği, uygulama durdurulduğunda serbest bırakılır. Bu örnek her bir atılabilir kaynağının her bir 
kullanım sonrasında atılmamalıdır. 

Bir HttpClient örneğinin ömrünü işlemenin daha iyi bir yolu için aşağıdakilere bakın: 

• HttpClient ve ömür yönetimi 

• HTTPClient Factory bloğu 

Nesne havuzu oluşturma 

Önceki örnek, HttpClient örneğinin nasıl statik hale getirilme ve tüm istekler tarafından yeniden kullanılma şeklim 
gösterdi. Yeniden kullanım, kaynak dışı çalışmayı önler. 

Nesne havuzu: 

• Yeniden kullanım modelini kullanır. 

• , Oluşturulması pahalı olan nesneler için tasarlanmıştır. 

Havuz, iş parçacıkları genelinde ayrılmaları ve yayımlanmaları önceden başlatılmış nesnelerden oluşan bir 
koleksiyondur. Havuzlar sınırlar, önceden tanımlanmış boyutlar veya büyüme oranı gibi ayırma kuralları 
tanımlayabilir. 

Microsoft. Extensions. ObjectPool NuGet paketi, bu tür havuzları yönetmeye yardımcı olan sınıflar içerir. 

Aşağıdaki API uç noktası her istekte rastgele sayılarla doldurulan bir byte arabelleği oluşturur: 

[HttpGet("array/{size}")] 
public byte[] GetArray(int size) 

{ 

var random = new RandomO; 
var array = new byte[size]; 
random.NextBytes(array); 

return array; 

} 


Aşağıdaki grafik, önceki API 'nin orta yük ile çağrılmasını gösterir: 





I Allocated 


| VVoridng Set 


Gen 0 


Gen 1 


Gen 2 


CPU (60%) 


RPS (17K) 


450 MB 

400 MB 

350 MB 



Yukarıdaki grafikte, nesil 0 toplamaları yaklaşık olarak saniyede bir kez gerçekleşir. 

Yukarıdaki kod, Arraypookt >kullanarak byte arabelleğini havuza alarak iyileştirilebilir. Bir statik örnek istekler 
arasında yeniden kullanılır. 

Bu yaklaşımla farklı olan özellikler, havuza alınmış bir nesnenin API 'den döndürüldüğü şeydir.Bunun anlamı: 

• Yöntemi, yönteminden geri döndükten hemen sonra Denetim dışındadır. 

• Nesneyi serbest bırakamıyoruz. 

Nesnenin elden çıkarılmasını ayarlamak için: 

• Havuza alınmış diziyi bir atılabilir nesnesinde yalıtma. 

• Havuza alınmış nesneyi HttpContext. Response. RegisterForDisposeile kaydedin. 

RegisterForDispose , hedef nesnede Dispose çağırma işlemini gerçekleştirir, böylece yalnızca HTTP isteği 
tamamlandığında serbest bırakılır. 







private static ArrayPool<byte> _arrayPool = ArrayPool<byte>.Create(); 

private class PooledArray : IDisposable 

{ 

public byte[] Array { get; private set; } 

public PooledArray(int size) 

{ 

Array = _arrayPool.Rent(size); 

} 

public void Dispose() 

{ 

_arrayPool.Return(Array); 

} 

} 

[HttpGet("pooledarray/{size}") ] 
public byte[] GetPooledArray(int size) 

{ 

var pooledArray = new PooledArray(size); 

var random = new Random(); 
random.NextBytes(pooledArray.Array); 

HttpContext.Response.RegisterForDispose(pooledArray); 

return pooledArray.Array; 

} 

Havuza alınmamış sürüm olarak aynı yükün uygulanması aşağıdaki grafiğe neden olur: 


Allocated VVorking Set Gen 0 Gen 1 Gen 2 |_ CPU (49%) RPS (12K) 

450 MB 


400 MB 


350 MB 



Ana fark ayrılan bayttır ve çok daha az nesil 0 koleksiyonu olarak. 

Ek kaynaklar 

• Atık Toplama 

• Eşzamanlılık görselleştiricisi ile farklı GC modlarını anlama 

• Büyük nesne yığını kapsanmamış 

• Büyük nesne yığını 







ASPNET Core 'de yanıt önbelleğe alma 

5.11.2019 • 14 minutes to read ı Edit Online 


John Luo, Rick Anderson, Steve Smithve Luke Latham tarafından 
Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Yanıt önbelleğe alma, bir istemcinin veya proxy 'nin bir Web sunucusunda yaptığı istek sayısını azaltır.Yanıt 
önbelleği Ayrıca, Web sunucusunun yanıt oluşturmak için gerçekleştirdiği iş miktarını azaltır. Yanıt önbelleğe 
alma, istemci, ara sunucu ve ara yazılım 'nin yanıtları nasıl önbellekte istediğinizi belirten üstbilgiler tarafından 
denetlenir. 

Responsecache özniteliği , yanıt önbelleği üst bilgilerini ayarlamaya katılır, istemciler ve ara proxy 'ler, HTTP 1,1 
önbelleğe alma belirtimindeyanıtları önbelleğe almak için üst bilgileri dikkate almalıdır. 

HTTP 1,1 önbelleğe alma belirtimini izleyen sunucu tarafında önbelleğe alma için yanıt önbelleğe alma ara 
yazılımı' nı kullanın. Ara yazılım, sunucu tarafı önbelleğe alma davranışını etkilemek için 
ResponseCacheAttribute özelliklerini kullanabilir. 

HTTP tabanlı yanıt önbelleğe alma 

HTTP 1,1 önbelleğe alma belirtimi , Internet önbelleklerinin nasıl davranması gerektiğini açıklar.Önbelleğe alma 
için kullanılan birincil HTTP üst bilgisi cache -Control' dır, önbellekyonerge/er/belirtmek için kullanılır. 
Yönergeler denetim önbelleği, istek olarak önbelleğe alma davranışını istemcilerden sunuculara ve yanıt olarak 
sunuculardan istemcilere geri doğru bir şekilde getirir, istekler ve yanıtlar proxy sunucuları üzerinden taşınır ve 
proxy sunucuları da HTTP 1,1 önbelleğe alma belirtimine uymalıdır. 

Ortak Cache-Control yönergeleri aşağıdaki tabloda gösterilmiştir. 


DEKİ 

EYLEM 

public 

Önbellek, yanıtı saklayabilir. 

private 

Yanıtın paylaşılan bir önbellek tarafından depolanması 
gerekir. Özel bir önbellek, yanıtı depolayıp yeniden 
kullanabilir. 

Maksimum yaş 

istemci, yaşı belirtilen saniyeden daha büyük olan bir yanıtı 
kabul etmez. Örnekler: max-age =60 (60 saniye), 
max-age=2592000 (1 ay) 

önbellek yok 

İsteklerde: bir önbellek, isteği karşılamak için depolanan bir 
yanıt kullanmamalıdır. Kaynak sunucu, istemcinin yanıtını 
yeniden oluşturur ve ara yazılım, depolanan yanıtı 
önbelleğinde güncelleştirir. 

Yanıtlar: yanıt, kaynak sunucuda doğrulamadan sonraki bir 
istek için kullanılmamalıdır. 

mağaza yok 

İstekler üzerinde: bir önbelleğin isteği depolaması gerekir. 


Yanıtlar: bir önbellek, yanıtın herhangi bir parçasını 
depolamamalıdır. 







Önbelleğe alma işleminde bir rol oynatacak diğer önbellek üstbilgileri aşağıdaki tabloda gösterilmiştir. 


Ü STB İLGİ 


İŞLEV 


Ölçerin 


Yanıt oluşturulduktan veya kaynak sunucuda başarıyla 
doğrulandıktan sonra geçen sürenin saniye cinsinden 
tahmini. 


Bitiminden 


Yanıtın eski kabul edildiği zaman. 


Prag 


no-cache davranışı ayarlamak için HTTP/1.0 önbellekler ile 
geriye dönük uyumluluk için mevcuttur. Cache-Control üst 
bilgisi varsa, Pragma üst bilgisi yok sayılır. 


Değiş 


Tüm vary üstbilgi alanları önbelleğe alınan yanıtın orijinal 
isteği ve yeni istek içinde eşleşmediğinden, önbelleğe alınmış 
bir yanıtın gönderilmemesi gerektiğini belirtir. 


HTTP tabanlı önbelleğe alma istek önbelleği-denetim yönergeleri 


Cache-Control üst bilgisi İçin HTTP 1,1 önbelleğe alma belirtiminin , istemci tarafından gönderilen geçerli bir 
Cache-Control üst bilgisini kabul etmek için önbellek gerekir, istemci, no-cache üst bilgi değeri ile istek 
yapabilir ve sunucuyu her istek için yeni bir yanıt oluşturmaya zorlayabilir. 

istemci Cache-Control istek üst bilgilerini her zaman değerlendirin, HTTP önbelleği hedefini düşünüyorsanız 
anlamlı hale gelir. Resmi belirtim altında, önbelleğe alma, istemcilerin, proxy ’lerin ve sunucuların bir ağı 
üzerinde istekleri karşılayan gecikme süresini ve ağ yükünü azaltmaya yöneliktir. Kaynak sunucu üzerindeki 
yükü denetlemek için bir yol değildir. 

Yazılım, resmi önbellek belirtimine bağlı olduğundan, yanıt önbelleğe alma ara yazılımı kullanılırken bu 
önbelleğe alma davranışının üzerinde geliştirici denetimi yoktur. Ara yazılım İçin planlı geliştirmeler , önbelleğe 
alınmış bir yanıta sunmaya karar verirken bir isteğin Cache-Control üst bilgisini yoksayacak şekilde 
yapılandırmak için bir fırsattır. Planlı geliştirmeler sunucu yükünü daha iyi denetleme olanağı sağlar. 


ASP.NET Core diğer önbelleğe alma teknolojisi 


Bellek içi önbelleğe alma 

Bellek içi önbelleğe alma, önbelleğe alınmış verileri depolamak için sunucu belleğini kullanır. Bu tür bir 
önbelleğe alma ,yapLşkan ofurum/onkullanan tek bir sunucu veya birden çok sunucu için uygundur. Yapışkan 
oturumlar, bir istemciden gelen isteklerin işlenmek üzere her zaman aynı sunucuya yönlendirildiği anlamına 
gelir. 

Daha fazla bilgi için bkz. ASP.NET Core 'de önbellek belleği. 

Dağıtılmış Önbellek 

Uygulama bir bulutta veya sunucu grubunda barındırıldığı zaman bellekte verileri depolamak için dağıtılmış 
önbellek kullanın. Önbellek, istekleri işleyen sunucular arasında paylaşılır.istemci, önbelleğe alınmış veriler 
varsa, gruptaki herhangi bir sunucu tarafından işlenen bir istek gönderebilir. ASP.NET Core, SQL Server ve 
Redsıs dağıtılmış önbellekler sunmaktadır. 

Daha fazla bilgi için bkz. ASP.NET Core 'de dağıtılmış önbelleğe alma. 

Önbellek etiketi Yardımcısı 

içeriği bir MVC görünümü veya Razor sayfasından önbellek etiketi Yardımcısı ile önbelleğe alma. Önbellek 
etiketi Yardımcısı, verileri depolamak için bellek içi önbelleğe alma kullanır. 












Daha fazla bilgi için bkz. Önbellek etiketi Yardımcısı, ASP.NET Core MVC. 

Dağıtılmış önbellek etiketi Yardımcısı 

Dağıtılmış bulut etiketi Yardımcısı ile dağıtılmış bulutta veya Web grubu senaryolarında bir MVC görünümü 
veya Razor sayfasından içerik önbelleğe alma. Dağıtılmış önbellek etiketi Yardımcısı, verileri depolamak için 
SQL Serverveya Redsıs kullanır. 

Daha fazla bilgi için bkz. Dağıtılmış önbellek etiketi Yardımcısı ASP.NET core'da. 

ResponseCache özniteliği 

ResponseCacheAttribute, yanıt önbelleğe alma işleminde uygun üst bilgileri ayarlamak için gereken 
parametreleri belirtir. 


VVARNING 

Kimliği doğrulanmış istemciler için bilgi içeren içerik için önbelleğe almayı devre dışı bırakın. Önbelleğe alma yalnızca 
kullanıcının kimliğine göre değişmeyen içerik veya bir kullanıcının oturum açmış olup olmadığı için etkinleştirilmelidir. 


VaryByQueryKeys, saklı yanıtı belirtilen sorgu anahtarları listesinin değerlerine göre değiştirir. Tek bir * değeri 
sağlandığında, ara yazılım tüm istek sorgu dizesi parametrelerine göre yanıtları değiştirir. 

VaryByQueryKeys özelliğini ayarlamak için yanıt önbelleğe alma ara yazılımı etkinleştirilmelidir. Aksi takdirde, 
çalışma zamanı özel durumu oluşturulur. VaryByQueryKeys özelliği için karşılık gelen bir HTTP üst bilgisi yok. 
Özelliği, yanıt önbelleğe alma ara yazılımı tarafından işlenen bir HTTP özelliğidir. Ara yazılım, önbelleğe alınmış 
bir yanıta hizmeti sağlamak için sorgu dizesi ve sorgu dizesi değerinin önceki bir istekle eşleşmesi gerekir. 
Örneğin, aşağıdaki tabloda gösterilen istek sırasını ve sonuçları göz önünde bulundurun. 

İSTEK SONUÇ 

http: //example. com?keyi=valuei Sunucudan döndürüldü. 

http: //example. com?keyi=valuei Ara yazılım tarafından döndürüldü. 

http: //example. com?keyi=value 2 Sunucudan döndürüldü. 

ilk istek sunucu tarafından döndürülür ve ara yazılım içinde önbelleğe alınır.Sorgu dizesi önceki istekle 
eşleştiğinden, ikinci istek ara yazılım tarafından döndürülür. Sorgu dizesi değeri önceki bir istekle 
eşleşmediğinden, üçüncü istek ara yazılım önbelleğinde değil. 

ResponseCacheAttribute, bir Microsoft.AspNetcore.Mvc.internai.ResponseCacheFilter yapılandırmak ve 
IFİlterFactoryoluşturmak için kullanılır. ResponseCacheFilter , yanıtın uygun HTTP üst bilgilerini ve özelliklerini 
güncelleştirme işini gerçekleştirir. Filtre: 

• Vary , Cache-Control ve Pragma için varolan tüm üstbilgileri kaldırır. 

• ResponseCacheAttributeayarlanan özelliklere göre uygun üstbilgileri yazar. 

• VaryByöueryKeys ayarlandıysa, yanıt önbelleğe alma HTTP özelliğini güncelleştirir. 


Değiş 

Bu üst bilgi yalnızca VaryByHeader özelliği ayarlandığında yazılır. Özelliği vary özelliğinin değerine ayarlanır. 
Aşağıdaki örnek VaryByHeader özelliğini kullanır: 














[ResponseCache(VaryByHeader = "User-Agent", Duration = 30)] 
public class CachelModel : PageModel 
{ 

Örnek uygulamayı kullanarak, tarayıcının ağ araçlarıyla yanıt üst bilgilerini görüntüleyin. Aşağıdaki yanıt üst 
bilgileri Cachel sayfa yanıtıyla gönderilir: 

Cache-Control: public,max-age=30 
Vary: User-Agent 

NoStore ve Location. None 

NoStore diğer özelliklerin çoğunu geçersiz kılar. Bu özellik true olarak ayarlandığında, Cache-Control üstbilgisi 
no-store olarak ayarlanır. Location None olarak ayarlandıysa: 


• 

Cache-Control 

nc 

ı-store, no-cache 

olarak ayarlan 

• 

Pragma 

no-cache 

olarak ayarlanır. 


NoStore faise ve Location None, Cache-Control ve Pragma no-cache olarak ayarlanır. 

NoStore genellikle hata sayfaları için true olarak ayarlanır. Örnek uygulamadaki Cache2 sayfası, istemcinin 
yanıtı depolayamamasını sağlayan yanıt üst bilgileri oluşturur. 

[ResponseCache(Duration = 0, Location = ResponseCacheLocation.None, NoStore = true)] 
public class Cache2Model : PageModel 
{ 

Örnek uygulama, aşağıdaki üst bilgileri içeren Cache2 sayfasını döndürür: 

Cache-Control: no-store,no-cache 
Pragma: no-cache 

Konum ve süre 

Önbelleğe almayı etkinleştirmek için Duration pozitif bir değere ayarlanmalıdır ve Location ' in Any (varsayılan) 
veya Client olması gerekir. Framevvork, Cache-Control üst bilgisini konum değerine ve ardından yanıtın 
max-age belirler. 

Location 1 ın Any ve Client seçenekleri sırasıyla public ve private 'in Cache-Control üst bilgi değerlerine 
dönüştürülür. NoStore ve Location. None bölümünde belirtildiği gibi, Location None olarak ayarlamak 
Cache-Control ve Pragma üst bilgilerini no-cache olarak ayarlar. 

Location.Any ( Cache-Control public olarak ayarlanır), istemci veya herhangi bir ara proxy 'Nin yanıt 
önbelleğe alma ara yazılımıdahil olmak üzere değeri önbelleğe alabilir olduğunu gösterir. 

Location.Client ( Cache-Control private olarak ayarlanan )yalnızca istemcinin değeri önbelleğe alabilir 
olduğunu gösterir. Yanıt önbelleğe alma ara yazılırımda dahil olmak üzere, bir ara önbelleğin değeri önbelleğe 
almalıdır. 

Önbellek denetim üstbilgileri, yalnızca istemcilere ve yanıt önbelleklerine ne zaman ve nasıl önbellek alınacağını 
gösteren yönergeler sağlar. İstemcilerin ve proxy 'lerin HTTP 1,1 önbelleğe alma belirtiminikabul edeceğini 
garanti etmez. Yanıt önbelleğe alma ara yazılımı her zaman belirtim tarafından düzenlendiği önbelleğe alma 
kurallarını izler. 


Aşağıdaki örnek, örnek uygulamadan Cache3 sayfa modelini ve Duration ayarlanarak oluşturulan üstbilgileri ve 




























varsayılan Location değerini bırakarak gösterir: 


[ResponseCache(Duration = 10, Location = ResponseCacheLocation.Any, NoStore = false)] 
public class CacheBModel : PageModel 
{ 

Örnek uygulama, aşağıdaki üst bilgiyle Cache3 sayfasını döndürür: 

Cache-Control: public,max-age=10 

Önbellek profilleri 

Birçok denetleyici eylem özniteliği üzerinde yanıt önbelleği ayarlarını çoğaltmak yerine, önbellek profilleri 
startup.configureServices ' da MVC/Razor Pages ayarlanırken seçenek olarak yapılandırılabilir.Başvurulan bir 
önbellek profilinde bulunan değerler ResponseCacheAttribute tarafından varsayılanlar olarak kullanılır ve 
özniteliğinde belirtilen özellikler tarafından geçersiz kılınır. 

Önbellek profili ayarlayın. Aşağıdaki örnek, örnek uygulamanın Startup.configureServices 30 saniyelik önbellek 
profilini gösterir: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddMvc(options => 

{ 

options.CacheProfiles.Add("Default30", 
new CacheProfile() 

{ 

Duration = 30 

}); 

}).SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

} 

Örnek uygulamanın Cache4 sayfa modeli Defauit30 önbellek profiline başvurur: 

[ResponseCache(CacheProfileName = "Default30")] 
public class Cache4Model : PageModel 
{ 

ResponseCacheAttribute şu şekilde uygulanabilir: 

• Razor sayfa işleyicileri (sınıflar) - öznitelikleri işleyici yöntemlerine uygulanamaz. 

• MVC denetleyicileri (sınıflar). 

• MVC eylemleri (Yöntemler) - Yöntem düzeyi öznitelikler, sınıf düzeyi özniteliklerde belirtilen ayarları geçersiz 
kılar. 

Defauit3@ önbellek profili tarafından Cache4 sayfa yanıtına uygulanan sonuç üst bilgisi: 

Cache-Control: public,max-age=30 


Ek kaynaklar 


• Yanıtları önbellekte depolama 

• Cache-Control 

• ASP.NET Core'de önbellek belleği 
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Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Önbelleğe alma temelleri 

Önbelleğe alma, içerik oluşturmak için gereken işi azaltarak bir uygulamanın performansını ve 
ölçeklenebilirliğini önemli ölçüde iyileştirebilir. Önbelleğe alma işlemi, seyrek olarak değişen ve üretime 
masraflı verilerle en iyi şekilde çalışıyor. Önbelleğe alma, kaynaktan çok daha hızlı döndürülebilecek verilerin 
bir kopyasını oluşturur. Uygulamalar, önbelleğe alınmış verilere hiçbir şekilde bağlı olmayacak şekilde 
yazılmalıdır ve test edilmelidir. 

AS P.N ET Core birçok farklı önbelleği destekler. En basit önbellek ımemorycache' i temel alır. 

Web sunucusunun belleğinde depolanan bir önbelleği temsil eder. Sunucu grubunda (birden 
çalışan uygulamalar, bellek içi önbellek kullanılırken oturumların yapışkan olmasını sağlamalıdır. Yapışkan 
oturumlar, bir istemciden gelen sonraki isteklerin aynı sunucuya gitmesini sağlar. Örneğin, Azure Web Apps, 
sonraki tüm istekleri aynı sunucuya yönlendirmek için uygulama İsteği yönlendirme (ARR) kullanır. 

Bir Web grubundaki yapışkan olmayan oturumlar, önbellek tutarlılığı sorunlarından kaçınmak için Dağıtılmış 
bir önbellek gerektirir. Bazı uygulamalarda, dağıtılmış bir önbellek, bellek içi bir önbellekten daha yüksek 
genişleme desteği sağlayabilir. Dağıtılmış bir önbellek kullanmak önbellek belleğini bir dış işleme devreder. 

Bellek içi önbellek herhangi bir nesneyi depolayabilirler. Dağıtılmış önbellek arabirimi byte[] sınırlıdır. Bellek 
içi ve dağıtılmış önbellek deposu öğeleri anahtar-değer çiftleri olarak önbelleğe alma. 

System. Runtime. Caching/MemoryCache 

System.Runtime.Caching / MemoryCache (NuGet paketi) ile birlikte kullanılabilir: 

• .NET Standard 2,0 veya üzeri. 

• .NET Standard 2,0 veya sonraki bir sürümü hedefleyen tüm .NET uygulamaları . Örneğin, 2,0 veya üzeri 
ASP.NET Core. 

• .N ET Framevvork 4,5 veya üzeri. 

Microsoft. Extensions. Caching. Memory / iMemoryCache (Bu makalede açıklanan) System.Runtime.Caching / 
MemoryCache üzerinde önerilir, çünkü AS P.N ET Core daha iyi tümleşiktir.Örneğin iMemoryCache , ASP.NET 
Core bağımlılığı eklemeile yerel olarak çalışmaktadır. 

ASP.NET Core taşıma sırasında uyumluluk Köprüsü olarak MemoryCache 
/ kullanın. 

Önbellek yönergeleri 

• Kodun, verileri getirmek için her zaman bir geri dönüş seçeneği olmalıdır ve kullanılabilir önbelleğe alınmış 
bir değere bağlı değildir. 

• Önbellek bir nadir kaynağı, bellek kullanır.Önbellek büyümesini sınırla: 
o Dış girişi önbellek anahtarları olarak kullanmayın. 

o Önbellek büyümesini sınırlamak için süre sonlarını kullanın. 


Kodu AS P.N ET 4.x'ten 

System.Runtime.Caching 


İMemoryCache , 
çok sunucu) 








o Önbellek boyutunu sınırlamak İçin SetSize, size ve SizeLimit kullanın. ASP.NET Core çalışma zamanı, 
bellek baskısı temelinde önbellek boyutunu sınırlamaz. En fazla geliştirici, önbellek boyutunu 
sınırlayacak. 

Imemorycache kullan 


VVARNING 

Ön sınır ekleme ve setsize, size veya SizeLimit ' e çağrı için bir paylaşılan bellek önbelleğinin kullanılması 
uygulamanın başarısız olmasına neden olabilir. Önbellekte bir boyut sınırı ayarlandığında, tüm girişlerin eklenmekte olan 
bir boyut belirtmesi gerekir. Bu, geliştiricilerin paylaşılan önbelleğin kullanıldığı ilgili tam denetime sahip olmaması 
nedeniyle sorunlara yol açabilir. Örneğin, Entity Framevvork Core paylaşılan önbelleği kullanır ve bir boyut belirtmez. Bir 
uygulama önbellek boyutu sınırı ayarlarsa ve EF Core kullanıyorsa, uygulama bir invalidoperationException oluşturur. 
Önbelleği sınırlandırmak için setsize , Size veya SizeLimit kullanıldığında, önbelleğe alma için bir önbellek 
oluşturun. Daha fazla bilgi ve bir örnek için bkz. önbellek boyutunu sınırlamak İçin SetSize, size ve SizeLimit kullanma. 
Paylaşılan bir önbellek, diğer çerçeveler veya kitaplıklar tarafından paylaşılır. Örneğin, EF Core paylaşılan önbelleği kullanır 
ve bir boyut belirtmez. 


Bellek içi önbelleğe alma, bağımlılık eklemekullanılarak bir uygulamadan başvurulan bir hizmettir . 
Oluşturucuda iMemoryCache örneği isteyin: 

public class HoıneController : Controller 

{ 

private İMemoryCache _cache; 

public HomeController(İMemoryCache memoryCache) 

{ 

_cache = memoryCache; 

} 


Aşağıdaki kod, bir saatin önbellekte olup olmadığını denetlemek için TryGetValue kullanır. Bir zaman önbelleğe 
alınmadıysa, yeni bir giriş oluşturulur ve Ayarlabirlikte önbelleğe eklenir, 
parçasıdır. 

public static class CacheKeys 

{ 

public static string Entry { get { return "_Entry"; } } 
public static string CallbackEntry { get { return "_Callback"; } } 
public static string CallbackMessage { get { return "_CallbackMessage"; } } 
public static string Parent { get { return "_Parent"; } } 
public static string Child { get { return "_Child"; } } 

public static string DependentMessage { get { return "_DependentMessage"; } } 
public static string DependentCTS { get { return "_DependentCTS"; } } 
public static string Ticks { get { return "_Ticks"; } } 
public static string CancelMsg { get { return "_CancelMsg"; } } 
public static string CancelTokenSource { get { return "_CancelTokenSource"; } } 

} 


CacheKeys sınıfı, indirme örneğinin bir 








public IActionResult CacheTryGetValueSet() 

{ 

DateTime cacheEntry; 

// Look fon cache key. 

if (!_cache.TryGetValue(CacheKeys.Entry, out cacheEntry)) 

{ 

// Key not in cache, so get data. 
cacheEntry = DateTime.Now; 

// Set cache options. 

var cacheEntryOptions = new MemoryCacheEntryOptions() 

// Keep in cache for this time, reset time if accessed. 
.SetSlidingExpiration(TimeSpan.FromSeconds(3)); 

// Save data in cache. 

_cache.Set(CacheKeys.Entry, cacheEntry, cacheEntryOptions); 

} 

return View("Cache", cacheEntry); 

} 


Geçerli saat ve önbelleğe alınmış saat görüntülenir: 

@model DateTime? 

<div> 

<h2>Actions</h2> 

<ul> 

<lixa asp-controller="Home" asp-action="CacheTryGetValueSet">TryGetValue and Set</ax/li> 

<lixa asp-controller="Home" asp-action="CacheGet">Get</ax/li> 

<lixa asp-controller="Home" asp-action="CacheGetOrCreate">GetOrCreate</ax/li> 

<lixa asp-controller="Home" asp- 

action="CacheGetOrCreateAsynchronous">CacheGetOrCreateAsynchronous</ax/li> 

<lixa asp-controller="Home" asp-action="CacheRemove">Remove</ax/li> 

<lixa asp-controller="Home" asp-action="CacheGetOrCreateAbs">CacheGetOrCreateAbs</ax/li> 

<lixa asp-controller="Home" asp-action="CacheGetOrCreateAbsSliding">CacheGetOrCreateAbsSliding</a> 

</li> 

</ul> 

</div> 

<h3>Current Time: @DateTime.Now.Time0fDay.ToString()</h3> 

<h3>Cached Time: @(Model == null ? "No cached entry found" : Model.Value.Time0fDay.ToString())</h3> 

Önbelleğe alınan DateTime değeri, zaman aşımı süresi içinde istekler varken önbellekte kalır. 

Aşağıdaki kod, verileri önbelleğe almak için GetOrCreate ve Getorcreateasync kullanır. 




public IActionResult CacheGetOrCreate() 

{ 

var cacheEntry = _cache.GetOrCreate(CacheKeys.Entry, entry => 

{ 

entry.SlidingExpiration = TimeSpan.FromSeconds(3); 
return DateTime.Now; 

}); 

return View("Cache", cacheEntry); 

} 

public async Task<IActionResult> CacheGetOrCreateAsynchronous() 

{ 

var cacheEntry = await 

_cache.GetOrCreateAsync(CacheKeys.Entry, entry => 

{ 

entry.SlidingExpiration = TimeSpan.FromSeconds(3); 
return Task.FromResult(DateTime.Now); 

}); 

return View("Cache", cacheEntry); 

} 

Aşağıdaki kod, önbelleğe alınmış zamanı getirmek için Al yöntemini çağırır: 

public IActionResult CacheGet() 

{ 

var cacheEntry = _cache.Get<DateTime?>(CacheKeys.Entry); 
return View("Cache", cacheEntry); 

} 

Aşağıdaki kod, mutlak süre sonu ile önbelleğe alınmış bir öğe alır veya oluşturur: 

public IActionResult CacheGetOrCreateAbs() 

{ 

var cacheEntry = _cache.GetOrCreate(CacheKeys.Entry, entry => 

{ 

entry.AbsoluteExpirationRelativeToNow = TimeSpan.FromSeconds(10); 
return DateTime.Now; 

}); 

return View("Cache", cacheEntry); 

} 

Yalnızca kayan bir süre sonu olan önbelleğe alınmış bir öğe kümesi, eski olma riski altında. Kayan süre sonu 
aralığından daha sık erişiliyorsa, öğe hiçbir zaman sona ermez. Mutlak süre sonu zamanı başarılı olduktan 
sonra öğenin süresinin dolacağını garantilemek için kayan bir süre sonu mutlak bir süre sonu ile birleştirin. 
Mutlak süre sonu, öğenin, Kayan süre sonu aralığı içinde istenmediğinde daha önce süresinin dolmasına izin 
verirken öğenin ne kadar süre önbellekte önbelleğe alınacağını belirleyen bir üst sınır ayarlar. Mutlak ve kayan 
süre sonu belirtildiğinde, süre sonları mantıksal ORed. Kayan süre sonu aralığı veya mutlak süre sonu zamanı 
başarılı olursa, öğe önbellekten çıkarıldı. 

Aşağıdaki kod hem kayan hem de mutlak süre sonu ile önbelleğe alınmış bir öğe alır veya oluşturur: 





public IActionResult CacheGetOrCreateAbsSlidingO 

{ 

var cacheEntry = _cache.GetOrCreate(CacheKeys.Entry, entry => 

{ 

entry.SetSlidingExpiration(TimeSpan.FromSeconds(3)); 

entry.AbsoluteExpirationRelativeToNow = TimeSpan.FromSeconds(20); 

return DateTime.Now; 

}); 

return View("Cache", cacheEntry); 

} 


Yukarıdaki kod, verilerin mutlak süreden daha uzun süre önbelleğe alınmamasını garanti eder. 

GetOrCreate, GetOrCreateAsync ve Get CacheExtensions sınıfında uzantı yöntemleridir. Bu yöntemler 
IMemoryCache özelliğini genişletir. 

Memorycachebir Yoptions 

Aşağıdaki örnek: 

• Kayan süre sonu zamanı ayarlar. Bu önbelleğe alınmış öğeye erişen istekler, Kayan süre sonu saatini 
sıfırlayacaktır. 

• Önbellek önceliğini Cacheitempriınıd. NeverRemoveolarak ayarlar. 

• Giriş önbellekten çıkarıldıktan sonra çağrılacak Postevictiondelegate ayarlar. Geri çağırma, öğeyi önbellekten 
kaldıran koddan farklı bir iş parçacığında çalıştırılır. 


public IActionResult CreateCallbackEntry() 

{ 

var cacheEntryOptions = new MemoryCacheEntryOptions() 

// Pin to cache. 

.SetPriority(CacheltemPriority.NeverRemove) 

// Add eviction callback 

.RegisterPostEvictionCallback(callback: EvictionCallback, State: this); 
_cache.Set(CacheKeys.CallbackEntry, DateTime.Now, cacheEntryOptions); 
return RedirectToAction("GetCallbackEntry"); 

} 

public IActionResult GetCallbackEntry() 

{ 

return View("Callback", new CallbackViewModel 

{ 

CachedTime = _cache.Get<DateTime?>(CacheKeys.CallbackEntry), 

Message = _cache.Get<string>(CacheKeys.CallbackMessage) 

})J 

} 

public IActionResult RemoveCallbackEntry() 

{ 

_cache.Remove(CacheKeys.CallbackEntry); 
return RedirectToAction("GetCallbackEntry"); 

} 

private static void EvictionCallback(object key, object value, 

EvictionReason reason, object State) 

{ 

var message = $"Entry was evicted. Reason: {reason}."; 

((HomeController)State)._cache.Set(CacheKeys.CallbackMessage, message); 

} 




Önbellek boyutunu sınırlamak için SetSize, size ve SizeLimit kullanın 

MemoryCache örnek, isteğe bağlı olarak bir boyut sınırı belirtebilir ve uygulayabilir. Önbelleğin, girdilerin 
boyutunu ölçmeye yönelik bir mekanizması olmadığından, önbellek boyutu sınırının tanımlı bir ölçü birimi yok. 
Önbellek boyutu sınırı ayarlandıysa, tüm girişlerin boyut belirtmesi gerekir.ASP.NET Core çalışma zamanı, 
bellek baskısı temelinde önbellek boyutunu sınırlamaz. En fazla geliştirici, önbellek boyutunu sınırlayacak. 
Belirtilen boyut, geliştiricinin seçtiği birimlerde bulunur. 

Örneğin: 

• Web uygulaması öncelikle dizeleri önbelleğe alıyorsa, her önbellek girdisi boyutu dize uzunluğu olabilir. 

• Uygulama tüm girdilerin boyutunu 1 olarak belirtebilir ve boyut sınırı girdi sayısıdır. 

SizeLimit ayarlanmamışsa, önbellek bağlantılı olmadan büyür. ASP.NET Core çalışma zamanı, sistem belleği 
azaldığında önbelleği kırpmaz. Uygulamalar şu şekilde tasarlanmıştır: 

• Önbellek büyümesini sınırla. 

• Kullanılabilir bellek sınırlıysa Compact veya Remove 1 i çağırın: 

Aşağıdaki kod, bağımlılık eklemetarafından erişilebilen bir unitless sabit boyut MemoryCache oluşturur: 

// using Microsoft.Extensions.Caching.Memory; 
public class MyMemoryCache 
{ 

public MemoryCache Cache { get; set; } 
public MyMemoryCache() 

{ 

Cache = new MemoryCache(new MemoryCacheOptions 
{ 

SizeLimit = 1024 

}); 

} 

} 

SizeLimit ' da birim yok. Önbellek boyutu sınırı ayarlandıysa, önbelleğe alınmış girişler, en çok ne kadar 
uygun olduğunu belirleyen birimlerde boyut belirtmelidir. Bir önbellek örneğinin tüm kullanıcıları aynı birim 
sistemini kullanmalıdır. Önbelleğe alınmış giriş boyutlarının toplamı, SizeLimit tarafından belirtilen değeri 
aşarsa bir giriş önbelleğe alınmaz. Önbellek boyutu sınırı ayarlanmamışsa, girişte ayarlanan önbellek boyutu 
yok sayılır. 

Aşağıdaki kod MyMemoryCache ' i bağımlılık ekleme kapsayıcısına kaydeder. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRazorPages(); 

Services.AddSingleton<MyMemoryCache>(); 

} 

MyMemoryCache , bu boyut sınırlı önbelleğin farkında olan bileşenler için bağımsız bir bellek önbelleği olarak 
oluşturulur ve önbellek girişi boyutunu uygun şekilde ayarlamayı öğrenin. 


Aşağıdaki kod MyMemoryCache kullanır: 






public class SetSize : PageModel 

{ 

private MemoryCache _cache; 

public static readonly string MyKey = "_MyKey"; 

public SetSize(MyMemoryCache memoryCache) 

{ 

_cache = memoryCache.Cache; 

} 

[TempData] 

public string DateTime_Now { get; set; } 

public IActionResult OnGet() 

{ 

if (!_cache.TryGetValue(MyKey, out string cacheEntry)) 

{ 

// Key not in cache, so get data. 

cacheEntry = DateTime.Now.TimeOfDay.ToString(); 

var cacheEntryOptions = new MemoryCacheEntryOptions() 

// Set cache entry size by extension method. 

.SetSize(l) 

// Keep in cache for this time, reset time if accessed. 
.SetSlidingExpiration(TimeSpan.FromSeconds(3)); 

// Set cache entry size via property. 

// cacheEntryOptions.Size = 1; 

II Save data in cache. 

_cache.Set(MyKey, cacheEntry, cacheEntryOptions); 

} 

DateTime_Now = cacheEntry; 
return RedirectToPage("./Index"); 

} 

} 


Önbellek girişinin boyutu Size veya SetSize uzantı yöntemleriyle ayarlanabilir: 



public IActionResult OnGet() 

{ 

if (!_cache.TryGetValue(MyKey, out string cacheEntry)) 

{ 

// Key not in cache, so get data. 

cacheEntry = DateTime.Now.TimeOfDay.ToString(); 

var cacheEntryOptions = new MemoryCacheEntryOptions() 

// Set cache entry size by extension method. 

.SetSize(l) 

// Keep in cache for this time, reset time if accessed. 
.SetSlidingExpiration(TimeSpan.FromSeconds(3)); 

// Set cache entry size via property. 

// cacheEntryOptions.Size = 1; 

// Save data in cache. 

_cache.Set(MyKey, cacheEntry, cacheEntryOptions); 

} 

DateTime_Now = cacheEntry; 
return RedirectToPage("./Index"); 

} 


MemoryCache. Compact 

MemoryCache.compact önbelleğin belirtilen yüzdesini aşağıdaki sırada kaldırmaya çalışır: 

• Tüm süre dolmamış öğeler. 

• Önceliğe göre öğeler.Önce en düşük öncelik öğeleri kaldırılır. 

• En son kullanılan nesneler. 

• En erken mutlak bitiş tarihi olan öğeler. 

• En erken Kayan süre sonu olan öğeler. 

Öncelik NeverRemove sabitlenmiş öğeler hiçbir şekilde kaldırılmaz. Aşağıdaki kod bir önbellek öğesini ve 
çağrıları kaldırır Compact : 

_cache.Remove(MyKey); 

// Remove 33% of cached items. 

_cache.Compact(.33); 
cache_size = _cache.Count; 

Daha fazla bilgi için bkz. GitHub 'Da Compact Source . 

Önbellek bağımlılıkları 

Aşağıdaki örnek, bağımlı bir girdinin süresi dolduğunda önbellek girişinin süresinin dolacağını gösterir. 
Önbelleğe alınmış öğeye bir CancellationChangeToken eklenir. canceiiationTokenSource"Cancei çağrıldığında, 
her iki önbellek girişi de kaldırılır. 






public IActionResult CreateDependentEntries() 

{ 

var cts = new CancellationTokenSource(); 

_cache.Set(CacheKeys.DependentCTS, cts); 

using (var entry = _cache.CreateEntry(CacheKeys.Parent)) 

{ 

// expire this entry if the dependant entry expires. 
entry.Value = DateTime.Now; 

entry.RegisterPostEvictionCallback(DependentEvictionCallbackj this); 

_cache.Set(CacheKeys.Childj 

DateTime.Now, 

new CancellationChangeToken(cts.Token)); 

} 

return RedirectToAction("GetDependentEntries"); 

} 

public IActionResult GetDependentEntries() 

{ 

return View("Dependent", new DependentViewModel 

{ 

ParentCachedTime = _cache.Get<DateTime?>(CacheKeys.Parent), 
ChildCachedTime = _cache.Get<DateTime?>(CacheKeys.Child), 

Message = _cache.Get<string>(CacheKeys.DependentMessage) 

}); 

} 

public IActionResult RemoveChildEntry() 

{ 

_cache.Get<CancellationTokenSource>(CacheKeys.DependentCTS) .Cancel(); 
return RedirectToAction("GetDependentEntries"); 

} 

private static void DependentEvictionCallback(object l<ey, object value, 
EvictionReason reason, object State) 

{ 

var message = $"Parent entry was evicted. Reason: {reason}."; 

((HomeController)State)._cache.Set(CacheKeys.DependentMessage, message); 

} 


CancellationTokenSource kullanmak birden çok önbellek girişinin bir grup olarak çıkarıyapılmasına izin verir. 

Yukarıdaki kodda using düzeniyle, using bloğunun içinde oluşturulan önbellek girdileri Tetikleyiciler ve süre 

sonu ayarlarını devralacak. 

Ek notlar 

• Süre sonu arka planda gerçekleşmez. Süre dolmakta olan öğeler için önbelleği etkin bir şekilde tarayan bir 
Zamanlayıcı yok. Önbellekteki ( Get , set , Remove ) herhangi bir etkinlik, süre sonu olmayan öğeler için bir 
arka plan taraması tetikleyebilir. CancellationTokenSource (CancelAfter) bir Zamanlayıcı girişi de kaldırır ve 
vadesi geçmiş öğeler için bir tarama tetikler. Aşağıdaki örnek, kayıtlı belirteç için CancellationTokenSource 
(TimeSpan) kullanır. Bu belirteç tetiklendiğinde, girdiyi hemen kaldırır ve çıkarma geri çağırmaları tetikler: 







public IActionResult CacheAutoExpiringTryGetValueSet() 

{ 

DateTime cacheEntry; 

if (!_cache.TryGetValue(CacheKeys.Entry, out cacheEntny)) 

{ 

cacheEntry = DateTime.Now; 

var cts = new CancellationTokenSource(TimeSpan.FromSeconds(10)); 

var cacheEntryOptions = new MemoryCacheEntryOptions() 

.AddExpirationToken(new CancellationChangeToken(cts.Token)); 

_cache.Set(CacheKeys.Entry, cacheEntry, cacheEntryOptions); 

} 

return View("Cache", cacheEntry); 

} 

• Bir önbellek öğesini yeniden doldurmak için geri çağırma kullanırken: 

o Geri arama tamamlanmadığından, birden çok istek önbelleğe alınan anahtar değeri boş olabilir, 
o Bu, birden çok iş parçacığının önbelleğe alınan öğeyi yeniden doldurma ile sonuçlanabilir. 

• Diğeri oluşturmak için bir önbellek girdisi kullanıldığında, alt öğe üst girdinin süre sonu belirteçlerini ve 
zaman tabanlı süre sonu ayarlarını kopyalar. Üst girdinin el ile kaldırılması veya güncelleştirilmesi için alt 
öğenin kullanım dışı olmaması. 

• Önbellek girdisi önbellekten çıkarıldıktan sonra uygulanacak geri çağırmaları ayarlamak için 

PostEvictionCalIbacks kullanın. 

• Çoğu uygulama için, IMemoryCache etkindir. Örneğin, ConfigureServices 'te AddMvc , 
AddControllersWithViews , AddRazorPages , AddMvcCore().AddRazorViewEngine ve diğer birçok 
Add{Service} yöntemi çağrılırken iMemoryCache etkinleştirilir. Önceki Add{Service} yöntemlerinden 
birini çağırmayan uygulamalarda, ConfigureServices 1 de AddMemoryCache ' i çağırmak gerekebilir. 

Ek kaynaklar 

• ASP.NET Core 'de dağıtılmış önbelleğe alma 

• AS P.N ET Core değişiklik belirteçleriyle değişiklikleri Algıla 

• ASP.NET Core'de yanıt önbelleğe alma 

• AS P.N ET Core 'de yanıt önbelleğe alma ara yazılımı 

• Önbellek etiketi Yardımcısı, ASP.NET Core MVC 

• Dağıtılmış önbellek etiketi Yardımcısı ASP.NET core'da 

By Rick Anderson, John Luove Steve Smith 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Önbelleğe alma temelleri 

Önbelleğe alma, içerik oluşturmak için gereken işi azaltarak bir uygulamanın performansını ve 
ölçeklenebilirliğini önemli ölçüde iyileştirebilir. Önbelleğe alma, seyrek olarak değişen verilerle en iyi şekilde 
sonuç verir. Önbelleğe alma, özgün kaynaktan çok daha hızlı döndürülebilecek verilerin bir kopyasını oluşturur. 
Kod, önbelleğe alınmış verilere hiçbir şekilde bağlı olmayacak şekilde yazılmalıdır ve test edilmelidir. 

AS P.N ET Core birçok farklı önbelleği destekler. En basit önbellek, Web sunucusunun belleğinde depolanan bir 
önbelleği temsil eden ımemorycache' i temel alır. Sunucu grubunda çalışan uygulamalar (birden çok sunucu), 









bellek içi önbellek kullanılırken oturumların yapışkan olmasını sağlamalıdır. Yapışkan oturumlar, bir istemciden 
sonraki isteklerin aynı sunucuya gitmesini sağlar. Örneğin, Azure Web Apps, bir Kullanıcı aracısından tüm 
istekleri aynı sunucuya yönlendirmek için uygulama İsteği yönlendirme (ARR) kullanır. 

Bir Web grubundaki yapışkan olmayan oturumlar, önbellek tutarlılığı sorunlarından kaçınmak için Dağıtılmış 
bir önbellek gerektirir. Bazı uygulamalarda, dağıtılmış bir önbellek, bellek içi bir önbellekten daha yüksek 
genişleme desteği sağlayabilir. Dağıtılmış bir önbellek kullanmak önbellek belleğini bir dış işleme devreder. 

Bellek içi önbellek herhangi bir nesneyi depolayabilirler. Dağıtılmış önbellek arabirimi byte[] sınırlıdır. Bellek 
içi ve dağıtılmış önbellek deposu öğeleri anahtar-değer çiftleri olarak önbelleğe alma. 

System. Runtime. Caching/MemoryCache 

System.Runtime.Caching / MemoryCache (NuGet paketi) ile birlikte kullanılabilir: 

• .NET Standard 2,0 veya üzeri. 

• .NET Standard 2,0 veya sonraki bir sürümü hedefleyen tüm .NET uygulamaları . Örneğin, 2,0 veya üzeri 
ASP.NET Core. 

• .N ET Framevvork 4,5 veya üzeri. 

Microsoft. Extensions. Caching. Memory / iMemoryCache (Bu makalede açıklanan) System.Runtime.Caching / 
üzerinde önerilir, çünkü ASP.NET Core daha iyi tümleşiktir.Örneğin iMemoryCache , ASP.NET 
lığı eklemeile yerel olarak çalışmaktadır. 

ASP.NET Core taşıma sırasında uyumluluk Köprüsü olarak MemoryCache 
/ kullanın. 

Önbellek yönergeleri 

• Kodun, verileri getirmek için her zaman bir geri dönüş seçeneği olmalıdır ve kullanılabilir önbelleğe alınmış 
bir değere bağlı değildir. 

• Önbellek bir nadir kaynağı, bellek kullanır.Önbellek büyümesini sınırla: 
o Dış girişi önbellek anahtarları olarak kullanmayın. 

o Önbellek büyümesini sınırlamak için süre sonlarını kullanın. 

o Önbellek boyutunu sınırlamak İçin SetSize, size ve SizeLimit kullanın. ASP.NET Core çalışma zamanı, 
bellek baskısı temelinde önbellek boyutunu sınırlamaz. En fazla geliştirici, önbellek boyutunu 
sınırlayacak. 

Imemorycache kullanma 


VVARNING 

Ön sınır ekleme ve setsize, size veya SizeLimit ' e çağrı için bir paylaşılan bellek önbelleğinin kullanılması 
uygulamanın başarısız olmasına neden olabilir. Önbellekte bir boyut sınırı ayarlandığında, tüm girişlerin eklenmekte olan 
bir boyut belirtmesi gerekir. Bu, geliştiricilerin paylaşılan önbelleğin kullanıldığı ilgili tam denetime sahip olmaması 
nedeniyle sorunlara yol açabilir. Örneğin, Entity Framevvork Core paylaşılan önbelleği kullanır ve bir boyut belirtmez. Bir 
uygulama önbellek boyutu sınırı ayarlarsa ve EF Core kullanıyorsa, uygulama bir invalidoperationException oluşturur. 
Önbelleği sınırlandırmak için setsize, size veya SizeLimit kullanıldığında, önbelleğe alma için bir önbellek 
oluşturun. Daha fazla bilgi ve bir örnek için bkz. önbellek boyutunu sınırlamak İçin SetSize, size ve SizeLimit kullanma. 


Kodu ASP.NET 4.x'ten 

System.Runtime.Caching 


MemoryCache 
Core bağımlı 


Bellek içi önbelleğe alma, bağımlılık eklemekullanılarak uygulamanız tarafından başvurulan bir hizmettir . 
ConfigureServices'' AddMemoryCache çağrısı: 









using Microsoft.AspNetCore.Builder; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft. Extensions.Dependencylnjection; 

public class Startup 

{ 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddMemoryCache(); 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_l); 

} 

public void Configure(IApplicationBuilder app) 

{ 

app.UseMvcWithDefaultRoute(); 

} 

} 

Oluşturucuda iMemoryCache örneği isteyin: 

public class HomeController : Controller 

{ 

private İMemoryCache _cache; 

public HomeController(İMemoryCache memoryCache) 

{ 

_cache = memoryCache; 

} 

iMemoryCache , Microsoft. AspNetCore. app metapackagelçinde bulunan Microsoft. Extensions. Caching. 
Memoryiçin NuGet paketini gerektirir. 

Aşağıdaki kod, bir saatin önbellekte olup olmadığını denetlemek için TryGetValue kullanır. Bir zaman önbelleğe 
alınmadıysa, yeni bir giriş oluşturulur ve Ayarlabirlikte önbelleğe eklenir. 

public static class CacheKeys 

{ 

public static string Entry { get { return "_Entry"; } } 

public static string CallbackEntry { get { return "_Callback"; } } 

public static string CallbackMessage { get { return "_CallbackMessage"; } } 

public static string Parent { get { return "_Parent"; } } 

public static string Child { get { return "_Child"; } } 

public static string DependentMessage { get { return "_DependentMessage"; } } 

public static string DependentCTS { get { return "_DependentCTS"; } } 

public static string Ticks { get { return "_Ticks"; } } 

public static string CancelMsg { get { return "_CancelMsg"; } } 

public static string CancelTokenSource { get { return "_CancelTokenSource"; } } 

} 





public IActionResult CacheTryGetValueSet() 

{ 

DateTime cacheEntry; 

// Look fon cache key. 

if (!_cache.TryGetValue(CacheKeys.Entry, out cacheEntry)) 

{ 

// Key not in cache, so get data. 
cacheEntry = DateTime.Now; 

// Set cache options. 

var cacheEntryOptions = new MemoryCacheEntryOptions() 

// Keep in cache for this time, reset time if accessed. 
.SetSlidingExpiration(TimeSpan.FromSeconds(3)); 

// Save data in cache. 

_cache.Set(CacheKeys.Entry, cacheEntry, cacheEntryOptions); 

} 

return View("Cache", cacheEntry); 

} 


Geçerli saat ve önbelleğe alınmış saat görüntülenir: 


@model DateTime? 


<div> 

<h2>Actions</h2> 

<ul> 


<lixa asp-controller="Home" 
<lixa asp-controller="Home" 
<lixa asp-controller="Home" 
<lixa asp-controller="Home" 
<lixa asp-controller="Home" 
</ul> 

</div> 


asp-action="CacheTryGetValueSet">TryGetValue and Set</ax/li> 

asp-action="CacheGet">Get</ax/li> 

asp-action="CacheGetOrCreate">GetOrCreate</ax/li> 

asp-action="CacheGetOrCreateAsync">GetOrCreateAsync</ax/li> 

asp-action="CacheRemove">Remove</ax/li> 


<h3>Current Time: @DateTime.Now.Time0fDay.ToString()</h3> 

<h3>Cached Time: @(Model == null ? "No cached entry found" : Model.Value.Time0fDay.ToString())</h3> 


Önbelleğe alınan DateTime değeri, zaman aşımı süresi içinde istekler varken önbellekte kalır. Aşağıdaki 
görüntüde geçerli saat ve önbellekten alınan eski bir zaman gösterilmektedir: 




E3 localhost X + 

^ Ç_) localhost1234/Home/CacheTryGetValueSet 

Scenaıios 

• Basic cache operations 

• Cache entry wıth evıctıon callback 

• Dependent cache entrıes 

Actions 


I • TrvGetValue and Set I 

- 

• GetOrCreate 

• GetOrCreateAsvnc 

• Remove 

Current Time: 17:04:01.1913080 
Cached Time: 17:03:39.9454218 


Aşağıdaki kod, verileri önbelleğe almak için GetOrCreate ve Getorcreateasync kullanır. 

public IActionResult CacheGetOrCreate() 

{ 

var cacheEntry = _cache.GetOrCreate(CacheKeys.Entry, entry => 

{ 

entry.SlidingExpiration = TimeSpan.FromSeconds(3); 
return DateTime.Now; 

}); 

return View("Cache", cacheEntry); 

} 

public async Task<IActionResult> CacheGetOrCreateAsync() 

{ 

var cacheEntry = await 

_cache.GetOrCreateAsync(CacheKeys.Entry, entry => 

{ 

entry.SlidingExpiration = TimeSpan.FromSeconds(3); 
return Task.FromResult(DateTime.Now); 

}): 

return View("Cache", cacheEntry); 

} 


Aşağıdaki kod, önbelleğe alınmış zamanı getirmek için Al yöntemini çağırır: 


public IActionResult CacheGet() 

{ 

var cacheEntry = _cache.Get<DateTime?>(CacheKeys.Entry); 
return View("Cache", cacheEntry); 

} 


GetOrCreate, GetOrCreateAsync ve Get , cacheextensions sınıfının IMemoryCache özelliğini genişleten bir 
parçası. Diğer önbellek yöntemlerinin açıklaması için bkz. ımemorycache metotları ve cacheextensions 
yöntemleri . 


Memorycachebir Yoptions 















Aşağıdaki örnek: 


• Kayan süre sonu zamanı ayarlar. Bu önbelleğe alınmış öğeye erişen istekler, Kayan süre sonu saatini 
sıfırlayacaktır. 

• Önbellek önceliğini cacheitemPriority.NeverRemove olarak ayarlar. 

• Giriş önbellekten çıkarıldıktan sonra çağrılacak Postevictiondelegate ayarlar. Geri çağırma, öğeyi önbellekten 
kaldıran koddan farklı bir iş parçacığında çalıştırılır. 


public IActionResult CreateCallbackEntry() 

{ 

var cacheEntryOptions = new MemoryCacheEntryOptions() 

// Pin to cache. 

.SetPriority(CacheltemPriority.NeverRemove) 

// Add eviction callback 

.RegisterPostEvictionCallback(callback: EvictionCallback., State: this); 
_cache.Set(CacheKeys.CallbackEntry, DateTime.NoWj cacheEntryOptions); 
return RedirectToAction("GetCallbackEntry"); 

} 

public IActionResult GetCallbackEntry() 

{ 

return View("Callback ", new CallbackViewModel 
{ 

CachedTime = _cache.Get<DateTime?>(CacheKeys.CallbackEntry)j 
Message = _cache.Get<string>(CacheKeys.CallbackMessage) 

}); 

} 

public IActionResult RemoveCallbackEntry() 

{ 

_cache.Remove(CacheKeys.CallbackEntry); 
return RedirectToAction("GetCallbackEntry"); 

} 

private static void EvictionCallback(object key, object value, 

EvictionReason reason, object State) 

{ 

var message = $"Entry was evicted. Reason: {reason}."; 

((HomeController)State)._cache.Set(CacheKeys.CallbackMessage, message); 

} 


Önbellek boyutunu sınırlamak için SetSize, size ve SizeLimit kullanın 

MemoryCache örnek, isteğe bağlı olarak bir boyut sınırı belirtebilir ve uygulayabilir. Önbelleğin, girdilerin 
boyutunu ölçmeye yönelik bir mekanizması olmadığından, önbellek boyutu sınırının tanımlı bir ölçü birimi yok. 
Önbellek boyutu sınırı ayarlandıysa, tüm girişlerin boyut belirtmesi gerekir.ASP.NET Core çalışma zamanı, 
bellek baskısı temelinde önbellek boyutunu sınırlamaz. En fazla geliştirici, önbellek boyutunu sınırlayacak. 
Belirtilen boyut, geliştiricinin seçtiği birimlerde bulunur. 

Örneğin: 

• Web uygulaması öncelikle dizeleri önbelleğe alıyorsa, her önbellek girdisi boyutu dize uzunluğu olabilir. 

• Uygulama tüm girdilerin boyutunu 1 olarak belirtebilir ve boyut sınırı girdi sayısıdır. 

SizeLimit ayarlanmamışsa, önbellek bağlantılı olmadan büyür. ASP.NET Core çalışma zamanı, sistem belleği 
azaldığında önbelleği kırpmaz. Uygulamalar şu şekilde tasarlanmıştır: 

• Önbellek büyümesini sınırla. 

• Kullanılabilir bellek sınırlıysa Compact veya Remove ' i çağırın: 






Aşağıdaki kod, bağımlılık eklemetarafından erişilebilen bir unitless sabit boyut MemoryCache oluşturur: 


// using Microsoft.Extensions.Caching.Memory; 
public class MyMemoryCache 
{ 

public MemoryCache Cache { get; set; } 
public MyMemoryCache() 

{ 

Cache = new MemoryCache(new MemoryCacheOptions 
{ 

SizeLimit = 1024 

}); 

} 

} 

SizeLimit ' da birim yok. Önbellek boyutu sınırı ayarlandıysa, önbelleğe alınmış girişler, en çok ne kadar 
uygun olduğunu belirleyen birimlerde boyut belirtmelidir. Bir önbellek örneğinin tüm kullanıcıları aynı birim 
sistemini kullanmalıdır. Önbelleğe alınmış giriş boyutlarının toplamı, SizeLimit tarafından belirtilen değeri 
aşarsa bir giriş önbelleğe alınmaz. Önbellek boyutu sınırı ayarlanmamışsa, girişte ayarlanan önbellek boyutu 
yok sayılır. 

Aşağıdaki kod MyMemoryCache ' i bağımlılık ekleme kapsayıcısına kaydeder. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_l); 

Services.AddSingleton<MyMemoryCache>(); 

} 

MyMemoryCache , bu boyut sınırlı önbelleğin farkında olan bileşenler için bağımsız bir bellek önbelleği olarak 
oluşturulur ve önbellek girişi boyutunu uygun şekilde ayarlamayı öğrenin. 

Aşağıdaki kod MyMemoryCache kullanır: 





public class AboutModel : PageModel 

{ 

private MemoryCache _cache; 

public static readonly string MyKey = "_MyKey"; 

public AboutModel(MyMemoryCache memoryCache) 

{ 

_cache = memoryCache.Cache; 

} 

[TempData] 

public string DateTime_Now { get; set; } 

public IActionResult OnGet() 

{ 

if (!_cache.TryGetValue(MyKey, out string cacheEntry)) 

{ 

// Key not in cache, so get data. 

cacheEntry = DateTime.Now.TimeOfDay.ToString(); 

var cacheEntryOptions = new MemoryCacheEntryOptions() 

// Set cache entry size by extension method. 

.SetSize(l) 

// Keep in cache for this time, reset time if accessed. 
.SetSlidingExpiration(TimeSpan.FromSeconds(3)); 

// Set cache entry size via property. 

// cacheEntryOptions.Size = 1; 

II Save data in cache. 

_cache.Set(MyKey, cacheEntry, cacheEntryOptions); 

} 

DateTime_Now = cacheEntry; 
return RedirectToPage("./Index"); 

} 

} 


Önbellek girişinin boyutu boyuta veya SetSize uzantı yöntemine göre ayarlanabilir: 



public IActionResult OnGet() 

{ 

if (!_cache.TryGetValue(MyKey, out string cacheEntry)) 

{ 

// Key not in cache, so get data. 

cacheEntry = DateTime.Now.TimeOfDay.ToString(); 

var cacheEntryOptions = new MemoryCacheEntryOptions() 

// Set cache entry size by extension method. 

.SetSize(l) 

// Keep in cache for this time, reset time if accessed. 
.SetSlidingExpiration(TimeSpan.FromSeconds(3)); 

// Set cache entry size via property. 

// cacheEntryOptions.Size = 1; 

// Save data in cache. 

_cache.Set(MyKey, cacheEntry, cacheEntryOptions); 

} 

DateTime_Now = cacheEntry; 
return RedirectToPage("./Index"); 

} 


MemoryCache. Compact 

MemoryCache.compact önbelleğin belirtilen yüzdesini aşağıdaki sırada kaldırmaya çalışır: 

• Tüm süre dolmamış öğeler. 

• Önceliğe göre öğeler.Önce en düşük öncelik öğeleri kaldırılır. 

• En son kullanılan nesneler. 

• En erken mutlak bitiş tarihi olan öğeler. 

• En erken Kayan süre sonu olan öğeler. 

Öncelik NeverRemove sabitlenmiş öğeler hiçbir şekilde kaldırılmaz. 

_cache.Remove(MyKey); 

// Remove 33% of cached items. 

_cache.Compact(.33); 
cache_size = _cache.Count; 

Daha fazla bilgi için bkz. GitHub 'Da Compact Source . 

Önbellek bağımlılıkları 

Aşağıdaki örnek, bağımlı bir girdinin süresi dolduğunda önbellek girişinin süresinin dolacağını gösterir. 
Önbelleğe alınmış öğeye bir CancellationChangeToken eklenir. canceiiationTokenSource'Cancei çağrıldığında, 
her iki önbellek girişi de kaldırılır. 





public IActionResult CreateDependentEntries() 

{ 

var cts = new CancellationTokenSource(); 

_cache.Set(CacheKeys.DependentCTS, cts); 

using (var entry = _cache.CreateEntry(CacheKeys.Parent)) 

{ 

// expire this entry if the dependant entry expires. 
entry.Value = DateTime.Now; 

entry.RegisterPostEvictionCallback(DependentEvictionCallbackj this); 

_cache.Set(CacheKeys.Childj 

DateTime.Now, 

new CancellationChangeToken(cts.Token)); 

} 

return RedirectToAction("GetDependentEntries"); 

} 

public IActionResult GetDependentEntries() 

{ 

return View("Dependent", new DependentViewModel 
{ 

ParentCachedTime = _cache.Get<DateTime?>(CacheKeys.Parent), 

ChildCachedTime = _cache.Get<DateTime?>(CacheKeys.Child), 

Message = _cache.Get<string>(CacheKeys.DependentMessage) 

})J 

} 

public IActionResult RemoveChildEntryO 
{ 

_cache.Get<CancellationTokenSource>(CacheKeys.DependentCTS).Cancel(); 
return RedirectToAction("GetDependentEntries"); 

} 

private static void DependentEvictionCallback(object key, object value, 

EvictionReason reason, object State) 

{ 

var message = $"Parent entry was evicted. Reason: {reason}."; 

((HomeController)State),_cache.Set(CacheKeys. DependentMessage, message); 

} 

Canceiiationîokensource kullanmak birden çok önbellek girişinin bir grup olarak çıkarıyapılmasına izin verir. 
Yukarıdaki kodda using düzeniyle, using bloğunun içinde oluşturulan önbellek girdileri Tetikleyiciler ve süre 
sonu ayarlarını devralacak. 

Ek notlar 

• Bir önbellek öğesini yeniden doldurmak için geri çağırma kullanırken: 

o Geri arama tamamlanmadığından, birden çok istek önbelleğe alınan anahtar değeri boş olabilir, 
o Bu, birden çok iş parçacığının önbelleğe alınan öğeyi yeniden doldurma ile sonuçlanabilir. 

• Diğeri oluşturmak için bir önbellek girdisi kullanıldığında, alt öğe üst girdinin süre sonu belirteçlerini ve 
zaman tabanlı süre sonu ayarlarını kopyalar. Üst girdinin el ile kaldırılması veya güncelleştirilmesi için alt 
öğenin kullanım dışı olmaması. 

• Önbellek girdisi önbellekten çıkarıldıktan sonra uygulanacak geri çağırmaları ayarlamak için 

Postevictioncallbacks kullanın. 

Ek kaynaklar 

• ASP.NET Core 'de dağıtılmış önbelleğe alma 



AS P.N ET Core değişiklik belirteçleriyle değişiklikleri Algıla 
ASP.NET Core 'de yanıt önbelleğe alma 
ASP.NET Core 'de yanıt önbelleğe alma ara yazılımı 
Önbellek etiketi Yardımcısı, ASP.NET Core MVC 
Dağıtılmış önbellek etiketi Yardımcısı ASP.NET core'da 


ASPNET Core 'de dağıtılmış önbelleğe alma 

19.09.2019 • 12 minutes to read ı Edit Online 


Luke Latham ve Steve Smith tarafından 

Dağıtılmış önbellek, genellikle ona erişen uygulama sunucuları için bir dış hizmet olarak tutulan birden çok 
uygulama sunucusu tarafından paylaşılan bir önbellektir. Dağıtılmış önbellek, özellikle uygulama bir bulut 
hizmeti veya sunucu grubu tarafından barındırıldığı zaman bir ASP.NET Core uygulamasının performansını 
ve ölçeklenebilirliğini iyileştirebilir. 

Dağıtılmış bir önbellek, önbelleğe alınan verilerin ayrı uygulama sunucularında depolandığı diğer önbelleğe 
alma senaryolarından daha fazla avantaj sunar. 

Önbelleğe alınan veriler dağıtıldığında, veriler: 

• Birden çok sunucuya yönelik istekler arasında tutarlı (tutarlı ). 

• Sunucu yeniden başlatmaları ve uygulama dağıtımları. 

• Yerel bellek kullanmaz. 

Dağıtılmış önbellek yapılandırması uygulamaya özgüdür. Bu makalede SQL Server ve Redsıs dağıtılmış 
önbelleklerinin nasıl yapılandırılacağı açıklanır. NCache (GitHub üzerindeki nCache) gibi üçüncü taraf 
uygulamalar da mevcuttur. Uygulama hangi uygulamanın seçildiğine bakılmaksızın, IDİstributedCache 
arabirimi kullanılarak önbellek ile etkileşime girer. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Önkoşullar 

SQL Server dağıtılmış önbellek kullanmak için Microsoft. Extensions. Caching. SqlServer paketine bir paket 
başvurusu ekleyin. 

Redsıs dağıtılmış önbelleği kullanmak için Microsoft. Extensions. Caching. StackExchangeRedis paketine bir 
paket başvurusu ekleyin. 

SQL Server dağıtılmış önbellek kullanmak için Microsoft. AspNetCore. app metapackage 'e başvurun veya 
Microsoft. Extensions. Caching. SqlServer paketine bir paket başvurusu ekleyin. 

Redsıs dağıtılmış önbellek kullanmak için Microsoft. AspNetCore. app metapackage 'e başvurun ve 
Microsoft. Extensions. Caching. StackExchangeRedis paketine bir paket başvurusu ekleyin. Redsıs paketi 
Microsoft.AspNetCore.App pakete dahil değildir, bu nedenle Redu paketine proje dosyanızda ayrı olarak 
başvurmanız gerekir. 

SQL Server dağıtılmış önbellek kullanmak için Microsoft. AspNetCore. app metapackage 'e başvurun veya 
Microsoft. Extensions. Caching. SqlServer paketine bir paket başvurusu ekleyin. 

Redsıs dağıtılmış önbellek kullanmak için Microsoft. AspNetCore. app metapackage 'e başvurun ve 
Microsoft. Extensions. Caching. redsıs paketine bir paket başvurusu ekleyin. Redsıs paketi 
Microsoft.AspNetCore.App pakete dahil değildir, bu nedenle Redu paketine proje dosyanızda ayrı olarak 
başvurmanız gerekir. 

Idistributedcache arabirimi 

I DistributedCache Arabirim, dağıtılmış önbellek uygulamasındaki öğeleri işlemek için aşağıdaki yöntemleri 







sağlar: 

• Get byte[] , GetAsync 

Birdizeanahtarınıkabulederveönbellektebulunursaönbelleğealınmışbiröğeyidiziolarakalır.- 

• Set byte[] , SetAsync Birdizeanahtarıkullanarakönbelleğebiröğe(diziolarak)ekler- 

• RefreshRefreshAsync ,- Kendi anahtarını temel alarak önbellekteki bir öğeyi yeniler, Kayan süre sonu 
zaman aşımını (varsa) sıfırlarken. 

• RemoveRemoveAsync ,- Bir önbellek öğesini dize anahtarına göre kaldırır. 

Dağıtılmış önbelleğe alma hizmetleri oluşturma 

Uygulamasına bir uygulamasını IDİstributedCache Startup.configureServices kaydetme. Bu konuda 
açıklanan Framevvork tarafından sunulan uygulamalar şunlardır: 

• Dağıtılmış bellek önbelleği 

• Dağıtılmış SQL Server önbelleği 

• Dağıtılmış Redsıs önbelleği 

Dağıtılmış bellek önbelleği 

Dağıtılmış bellek önbelleği (AddDistributedMemoryCache), öğeleri bellekte depolayan çerçeve tarafından 
sağlanmış bir IDİstributedCache uygulamasıdır. Dağıtılmış bellek önbelleği gerçek bir dağıtılmış önbellek 
değildir. Önbelleğe alınan öğeler, uygulamanın çalıştığı sunucuda uygulama örneği tarafından depolanır. 

Dağıtılmış bellek önbelleği, yararlı bir uygulama: 

• Geliştirme ve test senaryolarında. 

• Üretimde tek bir sunucu kullanıldığında ve bellek tüketimi bir sorun değildir. Dağıtılmış bellek 
önbelleğinin uygulanması, önbelleğe alınmış veri depolamayı soyutlar. Birden çok düğüm veya hata 
toleransı gerekliyse, gelecekte doğru bir dağıtılmış önbelleğe alma çözümü uygulamaya olanak sağlar. 

Örnek uygulama, uygulamasında Startup.configureServices geliştirme ortamında uygulama 
çalıştırıldığında dağıtılmış bellek önbelleğinin kullanımını sağlar: 

Services.AddDistributedMemoryCache(); 

Services.AddDistributedMemoryCache(); 

Dağıtılmış SQL Server önbelleği 

Dağıtılmış SQL Server önbellek uygulama (AddDistributedSqlServerCache) dağıtılmış önbelleğin, kendi 
yedekleme deposu olarak bir SOL Server veritabanı kullanmasına izin verir. Bir SOL Server örneğinde 
önbelleğe alınmış SOL Server bir öğe tablosu oluşturmak için sqi-cache aracını kullanabilirsiniz. Araç, 
belirttiğiniz ad ve şemaya sahip bir tablo oluşturur. 

sqi-cache create Komutunu çalıştırarak SQL Server tablo oluşturun. SQL Server örneği ( Data source ), 
veritabanı ( initial catalog ), dbo şema (örneğin,) ve tablo adı (örneğin, Testcache ) sağlayın: 

dotnet sql-cache create "Data Source=(localdb)\MSSQLLocalDB;Initial Catalog=DistCache;Integrated 
Security=True;" dbo TestCache 


Aracın başarılı olduğunu göstermek için bir ileti günlüğe kaydedilir: 










Table and index were created successfully. 

sqi-cache Araç tarafından oluşturulan tablo aşağıdaki şemaya sahiptir: 


Name 

Data Type 

Allovv Nulls 

İd 

nvarchar(449) 

□ “ 

Value 

varbinary(MAX) 

□ 

ExpiresAtTime 

datetimeoffset(7) 

□ 

SlidingExpirationlnSeconds bigint 

0 

AbsoluteExpiration 

datetimeoffset(7) 

0 


NOTE 

Bir uygulama IDİstributedCache, bir SglServerCacheörneğini kullanarak önbellek değerlerini işlemelidir. 


Örnek uygulama, içinde SqlServerCache startup.configureServices geliştirme dışı bir ortamda uygular: 

Services.AddDistributedSqlServerCache(options => 

{ 

options.ConnectionString = 

_config["DistCache_ConnectionString"]; 
options.SchemaName = "dbo"; 
options.TableName = "TestCache"; 

»J 


Services.AddDistributedSqlServerCache(options => 

{ 

options.ConnectionString = 

_config[ "DistCache_ConnectionString"]; 
options.SchemaName = "dbo"; 
options.TableName = "TestCache"; 

}); 


NOTE 

TableName SchemaName/ ASP.NET Core sürümünde geliştirme sırasında uygulama gizli dizileri güvenli depolama(Ve 
isteğe bağlı olarak, ve) genellikle kaynak denetimi dışında (örneğin, gizli yönetici veya appSettings. JSON appSettings 
içinde depolanır. { ConnectionString ENVIRONMENT}. JSON dosyaları). Bağlantı dizesinde kaynak denetim 
sistemlerinden tutulması gereken kimlik bilgileri bulunabilir. 


Dağıtılmış Redis Cache 

Redsıs , genellikle dağıtılmış önbellek olarak kullanılan açık kaynaklı bir bellek içi veri deposudur. Redsıs 'yi 
yerel olarak kullanabilir ve Azure 'da barındırılan ASP.NET Core uygulaması için bir Azure Redis Cache 
yapılandırabilirsiniz. 

Bir uygulama, içinde RedisCache Startup.configureServices geliştirme olmayan bir ortamda bir 
örnekAddStackExchangeRedisCache() kullanarak önbellek uygulamasını yapılandırır: 








Services.AddStackExchangeRedisCache(options => 

{ 

options.Configuration = "localhost"; 
options.InstanceName = "Samplelnstance"; 

}); 

Bir uygulama, içinde RedisCache startup.configureServices geliştirme olmayan bir ortamda bir 
örnekAddStackExchangeRedisCache() kullanarak önbellek uygulamasını yapılandırır: 

Services.AddStackExchangeRedisCache(options => 

{ 

options.Configuration = "localhost"; 
options.InstanceName = "Samplelnstance"; 

}); 


Bir uygulama bir RedisCache örnek (AddDistributedRedisCache) kullanarak önbellek uygulamasını 
yapılandırır: 

Services.AddDistributedRedisCache(options => 

{ 

options.Configuration = "localhost"; 
options.InstanceName = "Samplelnstance"; 

}); 


Redsıs 'i yerel makinenize yüklemek için: 

• Chocolatey redsıs paketiniyükler. 

• Komut redis-server isteminden çalıştırın. 

Dağıtılmış önbelleği kullan 

IDİstributedCache Arabirimini kullanmak için, uygulamadaki herhangi bir IDİstributedCache oluşturucudan 
bir örnek isteyin. Örnek, bağımlılık ekleme (dı)tarafından sağlanır. 

Örnek uygulama başlatıldığında IDİstributedCache öğesine startup.configure eklenir. Şu anki süre 
kullanılarak IHostApplicationLifetime önbelleğe alındı (daha fazla bilgi için bkz genel konak: 
Ihostapplicationlifetime): 

public void Configure(IApplicationBuilder app, IWebHostEnvironment env, 

IHostApplicationLifetime lifetime, IDİstributedCache cache) 

{ 

lifetime.ApplicationStarted.Register(() => 

{ 

var currentTimeUTC = DateTime.UtcNow.ToString(); 

byte[] encodedCurrentTimeUTC = Encoding.UTF8.GetBytes(currentTimeUTC); 
var options = new DistributedCacheEntryOptions() 

.SetSlidingExpiration(TimeSpan.FromSeconds(20)); 
cache.Set("cachedTimeUTC", encodedCurrentTimeUTC, options); 

}); 

Örnek uygulama başlatıldığında IDİstributedCache öğesine startup.configure eklenir. Şu anki süre 
kullanılarak lApplicationLifetime önbelleğe alındı (daha fazla bilgi için bkz . Web Hoşt: lapplicationlifetime 
arabirimi): 










public void Configure(IApplicationBuilder app, IHostingEnvinonment env, 

IApplicationLifetime lifetime, IDistributedCache cache) 

{ 

lifetime.ApplicationStarted.Register(() => 

{ 

var currentTimeUTC = DateTime.UtcNow.ToString(); 

byte[] encodedCurrentTimeUTC = Encoding.UTF8.GetBytes(currentTimeUTC); 
var options = new DistributedCacheEntryOptions() 

.SetSlidingExpiration(TimeSpan.FromSeconds(20)); 
cache.Set("cachedTimeUTC", encodedCurrentTimeUTC, options); 

}); 

Örnek uygulama, indexModei Dizin sayfası IDistributedCache tarafından kullanılmak üzere içine çıkarır. 

Dizin sayfası her yüklendiğinde, önbellek, içindeki onGetAsync önbelleğe alınmış zamana göre denetlenir. 
Önbelleğe alınmış sürenin süresi dolmamışsa, zaman görüntülenir.Önbelleğe alınan saate son erişildiği 
zamandan bu yana 20 saniye geçtikten sonra (bu sayfanın son yüklenilişinde), sayfanın önbelleğe alınma 
süresi doldu. 

Önbelleğe alınmış süreyi Sıfırla ' yı seçerek önbelleğe alınmış zamanı geçerli saate hemen güncelleştirin. 
Düğme onPostReseteachedTime işleyici metodunu tetikler. 

public class IndexModel : PageModel 

{ 

private readonly IDistributedCache _cache; 

public IndexModel(IDistributedCache cache) 

{ 

_cache = cache; 

} 

public string CachedTimeUTC { get; set; } 

public async Task OnGetAsync() 

{ 

CachedTimeUTC = "Cached Time Expired"; 

var encodedCachedTimeUTC = await _cache.GetAsync("cachedTimeUTC"); 

if (encodedCachedTimeUTC != null) 

{ 

CachedTimeUTC = Encoding.UTF8.GetString(encodedCachedTimeUTC); 

} 

} 

public async Task<IActionResult> OnPostResetCachedTime() 

{ 

var currentTimeUTC = DateTime.UtcNow.ToString(); 

byte[] encodedCurrentTimeUTC = Encoding.UTF8.GetBytes(currentTimeUTC); 
var options = new DistributedCacheEntryOptions() 

.SetSlidingExpiration(TimeSpan.FromSeconds(20)); 
await _cache.SetAsync("cachedTimeUTC", encodedCurrentTimeUTC, options); 

return RedirectToPage(); 

} 

} 







public class IndexModel : PageModel 
{ 

private readonly IDİstributedCache _cache; 

public IndexModel(IDistributedCache cache) 

{ 

_cache = cache; 

} 

public string CachedTimeUTC { get; set; } 

public async Task OnGetAsync() 

{ 

CachedTimeUTC = "Cached Time Expired"; 

var encodedCachedTimeUTC = await _cache.GetAsync("cachedTimeUTC"); 

if (encodedCachedTimeUTC != null) 

{ 

CachedTimeUTC = Encoding.UTF8.GetString(encodedCachedTimeUTC); 

} 

} 

public async Task<IActionResult> OnPostResetCachedTime() 

{ 

var currentTimeUTC = DateTime.UtcNow.ToString(); 

byte[] encodedCurrentTimeUTC = Encoding.UTF8.GetBytes(currentTimeUTC); 
var options = new DistributedCacheEntryOptions() 

.SetSlidingExpiration(TimeSpan.FromSeconds(20)); 
await _cache.SetAsync("cachedTimeUTC", encodedCurrentTimeUTC^ options); 

return RedirectToPage(); 

} 

} 


NOTE 

Örnekler için IDİstributedCache tek veya kapsamlı bir yaşam süresi kullanmanız gerekmez (en azından yerleşik 
uygulamalar için). 

Ayrıca, dı kullanmak yerine IDİstributedCache bir örnek oluşturabilirsiniz, ancak kodda bir örnek oluşturmak 
kodunuzu test etmek ve Açık bağımlılıklar ilkesiniihlal etmek için daha zor hale gelebilir. 


Öneriler 

Uygulamanız için hangi IDİstributedCache uygulamanın en iyisi olduğuna karar verirken aşağıdakileri göz 
önünde bulundurun: 

• Mevcut altyapı 

• Performans gereksinimleri 

• Maliyet 

• Ekip deneyimi 

Önbelleğe alma çözümleri genellikle önbelleğe alınmış verilerin hızlı bir şekilde alınmasını sağlamak için 
bellek içi depolamaya dayanır, ancak bellek sınırlı bir kaynaktır ve genişleyebilir. Yalnızca yaygın olarak 
kullanılan verileri bir önbellekte depolayın. 

Genellikle, Redsıs önbelleği daha yüksek aktarım hızı ve bir SQL Server önbelleğinden daha düşük gecikme 
süresi sağlar. Bununla birlikte, genellikle önbelleğe alma stratejilerinin performans özelliklerini belirlemede 
bir değerlendirme gerekir. 




SQL Server dağıtılmış önbellek yedekleme deposu olarak kullanıldığında, önbellek için aynı veritabanını 
kullanın ve uygulamanın sıradan veri depolama ve alma, her ikisinin performansını olumsuz yönde 
etkileyebilir. Dağıtılmış önbellek yedekleme deposu için adanmış bir SQL Server örneği kullanmanızı 
öneririz. 

Ek kaynaklar 

• Azure üzerinde Redis Cache 

• Azure'da SQL veritabanı 

• Web çiftlerine NCache İçin ıdistributedcache sağlayıcısını ASP.NET Core (GitHub 'Da nCache) 

• ASP.NET Core'de önbellek belleği 

• AS P.N ET Core değişiklik belirteçleriyle değişiklikleri Algıla 

• AS P.N ET Core 'de yanıt önbelleğe alma 

• AS P.N ET Core 'de yanıt önbelleğe alma ara yazılımı 

• Önbellek etiketi Yardımcısı, ASP.NET Core MVC 

• Dağıtılmış önbellek etiketi Yardımcısı ASP.NET core'da 

• Web çiftliğinde AS P.N ET Core ana bilgisayar 


ASPNET Core 'de yanıt önbelleğe alma ara 
yazılımı 

6.12.2019 • 13 minutes to read ı Edit Online 


Luke Latham ve John Luo tarafından 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Bu makalede, yanıt önbelleğe alma ara yazılımı ASP.NET Core bir uygulamada nasıl yapılandırılacağı 
açıklanmaktadır. Ara yazılım, yanıtların önbelleklenebilir olup olmadığını belirler, yanıtları depolar ve 
önbellekten yanıt verir. HTTP önbelleği ve [ResponseCache] özniteliğine giriş için bkz. Yanıt önbelleği. 

Yapılandırma 

Yanıt önbelleğe alma ara yazılımı, paylaşılan Framework aracılığıyla ASP.NET Core uygulamalar için örtülü 
olarak kullanılabilir. 

startup.configureServices , yanıt önbelleğe alma ara yazılımını hizmet koleksiyonuna ekleyin: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddResponseCaching(); 

Services.AddRazorPages(); 

} 

Uygulamayı, startup.configure içindeki istek işleme ardışık düzenine ekleyen UseResponseCaching uzantısı 
yöntemiyle ara yazılımı kullanacak şekilde yapılandırın: 





public void Configure(IApplicationBuilder app., IklebHostEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

} 

app.UseStaticFiles(); 

app.UseRoutingO; 

app.UseResponseCachingO; 

app.Use(async (context, next) => 

{ 

context.Response.GetTypedHeaders().CacheControl = 

new Microsoft.Net.Http.Headers.CacheControlHeaderValue() 

{ 

Public = true, 

MaxAge = TimeSpan.FromSeconds(10) 

}; 

context.Response.Headers[Microsoft.Net.Http.Headers.HeaderNames.Vary] = 
new string[] { "Accept-Encoding" }; 

await next(); 

}); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapRazorPages(); 

}); 

} 

Örnek uygulama, sonraki isteklerde önbelleğe almayı denetlemek için üstbilgiler ekler: 

• Cache-Control - önbelleklenebilir yanıtları 10 saniyeye kadar önbelleğe alır. 

• Değişiklik ara yazılımı yalnızca sonraki İsteklerin kabul etme-kodlama üst bilgisi özgün istekten 
eşleşiyorsa, önbelleğe alınmış bir yanıta sunacak şekilde yapılandırır. 

// using Microsoft.AspNetCore.Http; 

app.Use(async (context, next) => 

{ 

context.Response.GetTypedHeaders().CacheControl = 

new Microsoft.Net.Http.Headers.CacheControlHeaderValue() 

{ 

Public = true, 

MaxAge = TimeSpan.FromSeconds(10) 

}; 

context.Response.Headers[Microsoft.Net.Http.Headers.HeaderNames.Vary] = 
new string[] { "Accept-Encoding" }; 

await next(); 

}); 

Yanıt önbelleğe alma ara yazılımı yalnızca 200 (Tamam) durum kodu ile sonuçlanan sunucu yanıtlarını 
önbelleğe alır. Hata sayfalarıdahil diğer tüm yanıtlar, ara yazılım tarafından yok sayılır. 




VVARNING 

Kimliği doğrulanmış istemciler için içerik içeren yanıtların, ara yazılımın bu yanıtları depolamasını ve hizmet vermek için 
önbelleğe alınamaz olarak işaretlenmesi gerekir. Bir yanıtın önbelleklenmesini nasıl belirlediği hakkında bilgi için bkz. 
önbelleğe alma koşulları. 


Microsoft, aspnetcore. app metapackage kullanın veya Microsoft Aspnetcore. responsecaching paketine bir 
paket başvurusu ekleyin. 

startup.configureServices , yanıt önbelleğe alma ara yazılımını hizmet koleksiyonuna ekleyin: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddResponseCaching(); 

Services.AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

} 

Uygulamayı, startup.configure içindeki istek işleme ardışık düzenine ekleyen UseResponseCaching uzantısı 
yöntemiyle ara yazılımı kullanacak şekilde yapılandırın: 

public void Configure(IApplicationBuilder app., IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

} 

app.UseStaticFiles(); 

app.UseResponseCachingO; 

app.Use(async (context, next) => 

{ 

context.Response.GetTypedHeaders().CacheControl = 

new Microsoft.Net.Http.Headers.CacheControlHeaderValue() 

{ 

Public = true, 

MaxAge = TimeSpan.FromSeconds(10) 

}; 

context.Response.Headers[Microsoft.Net.Http.Headers.HeaderNames.Vary] = 
new string[] { "Accept-Encoding" }; 

await next(); 

}); 

app.UseMvc(); 

} 

Örnek uygulama, sonraki isteklerde önbelleğe almayı denetlemek için üstbilgiler ekler: 

• Cache-Control - önbelleklenebilir yanıtları 10 saniyeye kadar önbelleğe alır. 

• Değişiklik ara yazılımı yalnızca sonraki İsteklerin kabul etme-kodlama üst bilgisi özgün istekten 
eşleşiyorsa, önbelleğe alınmış bir yanıta sunacak şekilde yapılandırır. 





// using Microsoft.AspNetCore.Http; 

app.Use(async (context, next) => 

{ 

context.Response.GetTypedHeaders().CacheControl = 

new Microsoft.Net.Http.Headers.CacheControlHeaderValue() 

{ 

Public = true, 

MaxAge = TimeSpan.FromSeconds(10) 

}; 

context.Response.Headers[Microsoft.Net.Http.Headers.HeaderNames.Vary] = 
new string[] { "Accept-Encoding" }; 

await next(); 

}); 

Yanıt önbelleğe alma ara yazılımı yalnızca 200 (Tamam) durum kodu ile sonuçlanan sunucu yanıtlarını 
önbelleğe alır. Hata sayfalarıdahil diğer tüm yanıtlar, ara yazılım tarafından yok sayılır. 


VVARNING 

Kimliği doğrulanmış istemciler için içerik içeren yanıtların, ara yazılımın bu yanıtları depolamasını ve hizmet vermek için 
önbelleğe alınamaz olarak işaretlenmesi gerekir. Bir yanıtın önbelleklenmesini nasıl belirlediği hakkında bilgi için bkz. 
önbelleğe alma koşulları. 


Seçenekler 

Yanıt önbelleğe alma seçenekleri aşağıdaki tabloda gösterilmiştir. 

SEÇENEK AÇIKLAMA 

MaximumBodySize Yanıt gövdesi için bayt cinsinden en büyük önbelleklenebilir 

boyut. Varsayılan değer 64 * 1024 * 1024 (64 MB). 


SizeLimit 


Yanıt önbelleği ara yazılımı için bayt cinsinden boyut sınırı. 
Varsayılan değer 100 * 1024 * 1024 (100 MB). 


UseCaseSensitivePaths Yanıtların büyük/küçük harfe duyarlı yollarda önbelleğe 

alınıp alınmayacağını belirler. Varsayılan değer false 
şeklindedir. 


Aşağıdaki örnek, şu şekilde bir ara yazılım yapılandırır: 


• Gövde boyutu 1.024 bayttan küçük veya buna eşit olan önbellek yanıtları. 



VaryByQueryKeys 

MVC/web API denetleyicilerini veya Razor Pages sayfa modellerini kullanırken, [ResponseCache] özniteliği 
yanıt önbelleğe alma için uygun üst bilgileri ayarlamak için gereken parametreleri belirtir. Ara yazılımı 












kesinlikle gerektiren [ResponseCache] özniteliğinin tek parametresi, gerçek bir HTTP üst bilgisine karşılık 
gelen VaryByQueryKeys. Daha fazla bilgi için bkz. ASP.NET Core 'de yanıt önbelleğe alma. 

[ResponseCache] özniteliği kullanılırken, yanıt önbelleğe alma varyByQueryKeys değiştirilebilir. 
ResponseCachingFeature doğrudan HttpContext. Featuresiçinden kullanın: 

var responseCachingFeature = context.HttpContext.Features.Get<IResponseCachingFeature>(); 

if (responseCachingFeature != null) 

{ 

responseCachingFeature.VaryByQueryKeys = new[] { "MyKey" }; 

} 

varyByQueryKeys * eşit tek bir değer kullanmak, tüm istek sorgu parametrelerine göre önbelleği değiştirir. 

Yanıt önbelleğe alma ara yazılımı tarafından kullanılan HTTP 
üstbilgileri 

Aşağıdaki tabloda, yanıt önbelleğini etkileyen HTTP üstbilgileri hakkında bilgi verilmektedir. 


ÜSTBILGI 

AYRINTILAR 

Authorization 

Üst bilgi varsa yanıt önbelleğe alınmaz. 

Cache-Control 

Ara yazılım yalnızca public cache yönergesi ile 


işaretlenmiş önbelleğe alma yanıtlarını dikkate alır. 
Aşağıdaki parametrelerle önbelleğe alma denetimi: 

• Maksimum yaş 

• en fazla-eski+ 

• en az-yeni 

• yeniden doğrulama gerekir 

• önbellekyok 

• mağaza yok 

• yalnızca-if-önbelleğe alındı 

• private 

• {1 > public< 1} 

• s-maxage 

• ara sunucu-yeniden doğrulama* 

t max-stale için hiçbir sınır belirtilmemişse, ara yazılım 
hiçbir işlem gerçekleşmez. 

• proxy-revalidate must-revalidate ile ayni etkiye 
sahiptir. 

Daha fazla bilgi için bkz. RFC 7231 : İstek Cache-Control 
yönergeleri. 

Pragma istekteki bir Pragma: no-cache Üst bilgisi 

ile aynı etkiyi üretir. Bu üst 
üst bilgisinde ilgili yönergeler 
tarafından geçersiz kılınır. HTTP/1.0 ile geriye dönük 
uyumluluk için değerlendirilir. 


Cache-Control: no-cache 
bilgi, varsa Cache-Control 







USTBILGI 


AYRINTILAR 


Set-Cookie 

Üst bilgi varsa yanıt önbelleğe alınmaz, istek işleme ardışık 
düzeninde bir veya daha fazla tanımlama bilgisi ayarlayan 
herhangi bir ara yazılım, yanıt önbelleğe alma ara hattının 
yanıtı önbelleğe almasını önler (örneğin, tanımlama bilgisi 
tabanlı TempData sağlayıcısı). 

Vary 

vary üstbilgisi, başka bir üst bilgi tarafından önbelleğe 
alınan yanıtı değiştirmek için kullanılır. Örneğin, üst bilgileri 
Accept-Encoding: gzip ve 

Accept-Encoding: text/plain ayrı olarak istekler için 
yanıtları önbelleğe alan Vary: Accept-Encoding üst 
bilgisini ekleyerek, kodlamaya göre yanıtları önbelleğe alır. 

* üstbilgi değeri olan bir yanıt hiçbir şekilde depolanmaz. 

Expires 

Bu üst bilgi tarafından kabul edilen bir yanıt, diğer 
Cache-Control üstbilgileri tarafından geçersiz 
kılınmadıkça depolanmaz veya alınamaz. 

If-None-Match 

Tam yanıt, değerin * olmaması ve yanıtın ETag verilen 
değerlerden hiçbiriyle eşleşmezse önbellekten sunulur. Aksi 
takdirde, 304 (değiştirilmez) yanıtı sunulur. 

If-Modified-Since 

ıf-None-Match üstbilgisi yoksa, önbelleğe alınmış yanıt 
tarihi verilen değerden daha yeniyse önbellekten tam bir 
yanıt sunulur. Aksi takdirde, 304 olarak değiştirilmemiş bir 
yanıt sunulur. 

Date 

Önbellekten hizmet verirken, özgün yanıtta sağlanmadıysa 
Date üstbilgisi ara yazılım tarafından ayarlanır. 

Content-Length 

Önbellekten hizmet verirken, özgün yanıtta sağlanmadıysa 
Content-Length üstbilgisi ara yazılım tarafından ayarlanır. 

Age 

Özgün yanıtta gönderilen Age üst bilgisi yok sayılır. Ara 
yazılım, önbelleğe alınmış bir yanıta hizmet verirken yeni bir 
değeri hesaplar. 


İstekleri önbelleğe alma isteği Cache-Control yönergeleri 

Ara yazılım, HTTP 1,1 önbelleğe alma belirtiminin kurallarına uyar. Kurallar, istemci tarafından gönderilen 
geçerli bir Cache-Control üst bilgisini kabul etmek için bir önbellek gerektirir. Belirtim altında istemci, 
no-cache üst bilgi değeri ile istek yapabilir ve sunucuyu her istek için yeni bir yanıt oluşturmaya zorlayabilir. 
Şu anda, ara yazılım resmi önbelleğe alma belirtimine bağlı olduğundan, ara yazılım kullanılırken bu 
önbelleğe alma davranışı üzerinde geliştirici denetimi yoktur. 

Önbelleğe alma davranışı üzerinde daha fazla denetim için ASP.NET Core diğer önbelleğe alma özelliklerine 
göz atın. Aşağıdaki konulara bakın: 

• ASP.NET Core'de önbellek belleği 

• ASP.NET Core 'de dağıtılmış önbelleğe alma 

• Önbellek etiketi Yardımcısı, AS P.N ET Core MVC 

• Dağıtılmış önbellek etiketi Yardımcısı ASP.NET core'da 

















Sorun giderme 

Önbelleğe alma davranışı beklenmiyorsa, yanıtların önbelleklenmesini ve önbellekten sunulduğunu 
doğrulayın, isteğin gelen üst bilgilerini ve yanıtın giden üst bilgilerini inceleyin. Hata ayıklamaya yardımcı 
olmak için günlük kaydını etkinleştirin. 

Önbelleğe alma davranışını test ederken ve sorun giderirken, bir tarayıcı, istenmeyen yollarla önbelleğe 
almayı etkileyen istek üst bilgilerini ayarlayabilir. Örneğin, bir tarayıcı, bir sayfa yenilenirken Cache-Control 
üst bilgisini no-cache veya max-age=e olarak ayarlayabilir. Aşağıdaki araçlar, istek üst bilgilerini açık bir 
şekilde ayarlayabilir ve önbelleğe alma testi için tercih edilir: 

• Fiddler 

• Postman 

Önbelleğe alma koşulları 

• istek, 200 (Tamam) durum kodu ile bir sunucu yanıtı ile sonuçlanmalıdır. 

• istek yöntemi GET veya HEAD olmalıdır. 

• startup.configure , yanıt önbelleği ara yazılımı, önbelleğe alma gerektiren ara yazılımlar için 
yerleştirilmelidir. Daha fazla bilgi için bkz. ASP.NET Core ara yazılımı. 

• Authorization üst bilgisi mevcut olmamalıdır. 

• Cache-Control üst bilgi parametreleri geçerli olmalıdır ve yanıt pubiic olarak işaretlenmelidir ve 
private işaretlenmemiş olmalıdır. 

• Pragma: no-cache Üst bilgisi mevcut olmadığında, Cache-Control Üst bilgisi mevcut olduğunda Pragma 
üst bilgisini geçersiz kılıyorsa, Cache-Control üstbilgisi mevcut olmamalıdır. 

• Set-Cookie üst bilgisi mevcut olmamalıdır. 

• vary üst bilgi parametreleri geçerli ve * eşit olmalıdır. 

• Content-Length üst bilgi değeri (ayarlandıysa), yanıt gövdesinin boyutuyla aynı olmalıdır. 

• IHttpSendFileFeature kullanılmıyor. 

• Yanıt, Expires üst bilgisi ve max-age ve s-maxage önbellek yönergeleri tarafından belirtilen eski 
olmamalıdır. 

• Yanıt arabelleğe alma başarılı olmalıdır.Yanıtın boyutu yapılandırılmış veya varsayılan SizeLimitdaha 
küçük olmalıdır. Yanıtın gövde boyutu yapılandırılmış veya varsayılan MaximumBodySizeküçük olmalıdır. 

• Yanıt, RFC 7234 belirtimlerine göre önbelleklenebilir olmalıdır. Örneğin, istek veya yanıt üst bilgisi 
alanlarında no-store yönergesi bulunmamalıdır. Ayrıntılar için bkz. 3. Bölüm: RFC 7234 önbelleklerinde 
yamtlarL depolama . 


NOTE 

Siteler arası İstek sahteciliği (CSRF) saldırılarını önlemeye yönelik güvenli belirteçler oluşturmaya yönelik Antiforgery 
sistemi, Cache-Control ve Pragma üst bilgilerini no-cache olarak ayarlar ve böylece yanıtlar önbelleğe alınmaz. 
FITML form öğeleri için antiforgery belirteçlerini devre dışı bırakma hakkında daha fazla bilgi için bkz. ASP.NET Core 
siteler arası İstek sahteciliği (XSRF/CSRF) saldırılarını önle. 


Ek kaynaklar 

• ASP.NET Core'de uygulama başlatma 

• ASP.NET Core ara yazılımı 

• ASP.NET Core'de önbellek belleği 

• ASP.NET Core 'de dağıtılmış önbelleğe alma 

• ASP.NET Core değişiklik belirteçleriyle değişiklikleri Algıla 














• ASP.NET Core'de yanıt önbelleğe alma 

• Önbellek etiketi Yardımcısı, AS P.N ET Core MVC 

• Dağıtılmış önbellek etiketi Yardımcısı AS P.N ET core'da 


ASPNET core'da TransactionAffinity ile nesne yeniden 
kullanma 

11.07.2019 • 4 minutes to read ı Edit Online 


Tarafından Steve Gordon, Ryan Novvak, ve Rick Anderson 

Microsoft.Extensions.ObjectPool toplanabilir nesneler çöp yerine nesne grubu yeniden kullanım için bellekte 
tutulması destekler ASP.NET Core altyapısının bir parçasıdır. 

Yönetilen nesneleri nesne havuzu kullanmak isteyebilirsiniz: 

• Pahalı tahsis başlatılamadı. 

• Bazı sınırlı kaynak temsil eder. 

• Tahmin edilebilir bir biçimde ve sık sık kullanılır. 

Örneğin, AS P.N ET Core framevvork yeniden kullanmak için bazı yerlerde nesne havuzu kullanır StringBuilder 
örnekleri. StringBuilder ayırır ve karakter verileri tutmak için kendi duyulan arabellekleri yöneten. ASP.NET Core 
düzenli olarak kullandığı StringBuilder uygulamak için özellikleri ve bunları yeniden bir performans kazancı sağlar. 

Nesne havuzu her zaman performansı değil: 

• Bir nesnenin başlangıç maliyeti yüksek olmadığı sürece, nesne havuzdan almak genellikle daha yavaştır. 

• Havuz paylaştırılmamış olana kadar havuzu tarafından yönetilen nesnelere paylaştırılmamış değildir. 

Yalnızca uygulama veya kitaplık için gerçekçi senaryoları kullanarak performans verilerini topladıktan sonra nesne 
havuzu kullanın. 

UYARI: Objectpooi Uygulamayan iDisposable . Çıkarma gereken türleri ile kullanımı önerilmemektedir. 

NOT: TransactionAffinity, tahsis nesneleri sayısına bir sınır yerleştirmez, nesneleri, korur sayısına bir sınır 
yerleştirir. 

Kavramlar 

ObjectPoolcT> -temel nesne havuzu Özet. Alma ve nesneleri döndürmek için kullanılır. 

PooledObjectPolicy<T> -Bu nesneyi nasıl oluşturulduğunu ve nasıl özelleştirileceği uygulamak sıfirlama havuza 
geri döndürüldüğünde. Bu, doğrudan oluşturmak bir nesne havuzu geçirilebilir... VEYA 

Create Nesne havuzu oluşturmak için bir üreteci olarak görev yapar. 

Bir uygulamada birden çok yolla TransactionAffinity kullanılabilir: 

• Bir havuz örnekleme. 

• Bir havuzda kaydetme bağımlılık ekleme (dı) bir örneği olarak. 

• Kaydetme Objectpooiprovidero Dİ ve bir Fabrika kullanarak. 

TransactionAffinity kullanma 

Çağrı ObjectPookT> bir nesne almak için ve Return nesneyi döndürmek için. Her nesnenin dönüş gereksinimi 
yoktur. Bir nesne döndürmeyin, çöp olarak toplanacak olacaktır. 





TransactionAffinity örnek 

Aşağıdaki kodu: 

• Ekler objectPoolProvider için bağımlılık ekleme (dı) kapsayıcı. 

• Ekler ve yapılandırır 0 bjectPooi<stringBuiider> Dİ kapsayıcısı. 

• Ekler BirthdayMiddleware . 


public class Startup 

{ 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.TryAddSingleton<ObjectPoolProvider, DefaultObjectPoolProvider>(); 

Services.TryAddSingleton<ObjectPool<StringBuilder>>(serviceProvider => 

{ 

var provider = serviceProvider.GetRequiredService<ObjectPoolProvider>() 
var policy = new StringBuilderPooledObjectPolicyO; 
return provider.Create(policy); 

}); 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

// Test using /?firstname=Steve&lastName=Gordon&day=28&month=9 
app.UseMiddleware<BirthdayMiddleware>(); 

} 

} 


Aşağıdaki kod uygular BirthdayMiddleware 





public class BirthdayMiddleware 

{ 

private readonly RequestDelegate _next; 

public BirthdayMiddleware(RequestDelegate next) 

{ 

_next = next; 

} 

public async Task InvokeAsync(HttpContext context, 

ObjectPool<StringBuilder> builderPool) 

{ 

if (context.Request.Query.TryGetValue("firstName"j out var firstName) && 
context.Request.Query.TryGetValue("lastName", out var lastName) && 
context.Request.Query.TryGetValue("month", out var month) && 
context.Request.Query.TryGetValue("day", out var day) && 
int.TryParse(monthj out var monthOfYear) && 
int.TryParse(day, out var dayOfMonth)) 

{ 

var now = DateTime.UtcNow; // Ignoring timezones. 

// Request a StringBuilder from the pool. 
var StringBuilder = builderPool.Get(); 

try 

{ 

StringBuilder.Append("Hi ") 

.Append(firstName).Append(" ").Append(lastName).Append(". "); 

if (now.Day == dayOfMonth && now.Month == monthOfYear) 

{ 

StringBuilder.Append("Happy birthday!!!"); 

await context.Response.WriteAsync(stringBuilder.ToString()); 

} 

else 

{ 

var thisYearsBirthday = new DateTime(now.Year, monthOfYear., 

dayOfMonth); 

int daysUntilBirthday = thisYearsBirthday > now 
? (thisYearsBirthday - now).Days 
: (thisYearsBirthday.AddYears(l) - now).Days; 

StringBuilder.Append("There are ") 

.Append(daysUntilBirthday).Append(" days until your birthday!"); 

await context.Response.WriteAsync(stringBuilder.ToString()); 

} 

} 

finally // Ensure this runs even if the main code throws. 

{ 

// Return the StringBuilder to the pool. 
builderPool.Return(StringBuilder); 

} 

return; 

} 

await _next(context); 

} 

} 



ASPNET Core 'de yanıt sıkıştırması 

6.12.2019 • 19 minutes to read ı Edit Online 


Tarafından Luke Latham 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Ağ bant genişliği sınırlı bir kaynaktır.Yanıt boyutunu azaltmak genellikle önemli ölçüde önemli ölçüde bir 
uygulamanın yanıt hızını artırır. Yük boyutlarını azaltmanın bir yolu, uygulamanın yanıtlarını sıkıştırmaktır. 

Yanıt sıkıştırma ara yazılımı ne zaman kullanılır? 

IIS, Apache veya NGINX 'te sunucu tabanlı yanıt sıkıştırma teknolojilerini kullanın. Ara yazılım performansı 
büyük olasılıkla sunucu modülleriyle eşleşmemelidir. Http. sys Server Server ve Kestrel Server şu anda yerleşik 
sıkıştırma desteği sunmaz. 

Şu durumlarda yanıt sıkıştırma ara yazılımını kullanın: 

• Aşağıdaki sunucu tabanlı sıkıştırma teknolojileri kullanılamıyor: 
o IIS dinamik sıkıştırma modülü 

o Apache mod_deflate modülü 
o NGINX sıkıştırma ve açma 

• Doğrudan barındırma: 

o Http. sys sunucusu (eski adıyla vvebListener) 
o Kestrel sunucusu 

Yanıt sıkıştırma 

Genellikle, yerel olarak sıkıştırılmamış herhangi bir yanıt, yanıt sıkıştırmasından faydalanabilir. Yerel olarak 
sıkıştırılan yanıtlar genellikle şunlardır: CSS, JavaScript, HTML, XML ve JSON. PNG dosyaları gibi yerel olarak 
sıkıştırılan varlıkları sıkıştırmamanız gerekir. Yerel olarak sıkıştırılan bir yanıtı daha fazla sıkıştırmaya çalışırsanız, 
boyut ve iletim süresi bakımından küçük bir ek azaltma büyük olasılıkla sıkıştırmayı işlemek için geçen süre kadar 
fazla gölgelenir. 150-1000 bayttan daha küçük dosyaları sıkıştırmayın (dosyanın içeriğine ve sıkıştırma 
verimliliğine bağlı olarak). Küçük dosyaları sıkıştırma ek yükü sıkıştırılmamış dosyadan daha büyük bir 
sıkıştırılmış dosya üretebilir. 

Bir istemci sıkıştırılmış içeriği işleyebilişlerde, istemci, Accept-Encoding üst bilgisini istekle göndererek 
yeteneklerini bilgilendirmelidir. Bir sunucu sıkıştırılmış içerik gönderdiğinde, sıkıştırılmış yanıtın kodlanmasının 
Content-Encoding üst bilgisine bilgi içermelidir. Ara yazılım tarafından desteklenen içerik kodlama göstergeleri 
aşağıdaki tabloda gösterilmiştir. 


ÜST BİLGİ DEĞERLERİNİ accept-encoding 

DESTEKLENEN ARA YAZILIM 

AÇIKLAMA 

br 

Evet (varsayılan) 

Brotli sıkıştırılmış veri biçimi 

deflate 

Hayır 

Sıkıştırılmış veri biçimini söndür 

exi 

Hayır 

W3C verimli XML değişim 

gzip 

Evet 

Gzip dosya biçimi 










ÜST BİLGİ DEĞERLERİNİ accept-encoding 

DESTEKLENEN ARA YAZILIM 

AÇIKLAMA 

identity 

Evet 

"Kodlama yok" tanımlayıcısı: Yanıt 
kodlanmamalıdır. 

pack200-gzip 

Hayır 

Java arşivleri için ağ aktarım biçimi 

* 

Evet 

Tüm kullanılabilir içerik kodlamaları 
açıkça istenmedi 

ÜST BİLGİ DEĞERLERİNİ accept-encoding 

DESTEKLENEN ARA YAZILIM 

AÇIKLAMA 

br 

Hayır 

Brotli sıkıştırılmış veri biçimi 

deflate 

Hayır 

Sıkıştırılmış veri biçimini söndür 

exi 

Hayır 

W3C verimli XML değişim 

gzip 

Evet (varsayılan) 

Gzip dosya biçimi 

identity 

Evet 

"Kodlama yok" tanımlayıcısı: Yanıt 
kodlanmamalıdır. 

pack200-gzip 

Hayır 

Java arşivleri için ağ aktarım biçimi 

* 

Evet 

Tüm kullanılabilir içerik kodlamaları 
açıkça istenmedi 


Daha fazla bilgi için, İANA resmi İçerik kodlama listesinebakın. 

Ara yazılım, özel Accept-Encoding üst bilgi değerleri için ek sıkıştırma sağlayıcıları eklemenize olanak tanır. Daha 
fazla bilgi için aşağıdaki özel sağlayıcılar bölümüne bakın. 

Ara yazılım, sıkıştırma düzenlerini önceliklendirmek için istemci tarafından gönderildiğinde kalite değeri (qvalue, 
q ) ağırlığa yeniden davranıyor.Daha fazla bilgi için bkz. RFC 7231: Accept-Encoding. 

Sıkıştırma algoritmaları, sıkıştırma hızı ve sıkıştırmanın verimliliği arasında bir zorunluluğunu getirir tabidir. Bu 
bağlamdaki verimlilik, sıkıştırmadan sonra çıkışın boyutunu ifade eder. En en uygun sıkıştırma, en iyi boyut ile 
elde edilir. 

Sıkıştırılmış içerik isteme, gönderme, önbelleğe alma ve alma ile ilgili üstbilgiler aşağıdaki tabloda açıklanmıştır. 

Ü STB İLGİ ROL 

Accept-Encoding istemci için kabul edilebilir içerik kodlama düzenlerini 

göstermek üzere istemciden sunucusuna gönderilir. 

Content-Encoding Yük içindeki içeriğin kodlamasını göstermek için sunucudan 

istemciye gönderilir. 

content - Length Sıkıştırma gerçekleştiğinde, yanıt sıkıştırdığında gövde içeriği 

değiştiği için content-Length üst bilgisi kaldırılır. 













USTBILGI 


ROL 


Content-MD5 Sıkıştırma gerçekleştiğinde, gövde içeriği değiştiğinden ve 

karma artık geçerli olmadığından content-MD5 üst bilgisi 
kaldırılır. 

content-Type içeriğin MİME türünü belirtir. Her yanıt content-Type 

belirtmelidir. Ara yazılım, yanıtın sıkıştırılıp sıkıştırılmadığını 
belirlemede bu değeri denetler. Ara yazılım, kodlayamadığı bir 
dizi varsayılan MİME türünü belirtir, ancak MİME türlerini 
değiştirebilir veya ekleyebilirsiniz. 

vary Sunucu tarafından istemciler ve proxy ’ler için bir 

Accept-Encoding değeri ile gönderildiğinde, vary üst 
bilgisi, isteğin Accept-Encoding üst bilgisinin değerine göre 
önbelleğe alma (değişiklik) gerektiğini istemci veya ara 
sunucuya bildirir. Vary: Accept-Encoding üst bilgisiyle içerik 
döndürmesinin sonucu, hem sıkıştırılmış hem de 
sıkıştırılmamış yanıtların ayrı olarak önbelleğe alınıp 
alınmayadır. 

Örnek uygulamaylayanıt sıkıştırma ara yazılımı 'nın özelliklerini gezin. Örnek şunu gösterir: 

• Gzip ve özel sıkıştırma sağlayıcıları kullanılarak uygulama yanıtlarının sıkıştırılması. 

• Sıkıştırma için varsayılan MİME türleri listesine MİME türü ekleme. 

Paket 

Yanıt sıkıştırma ara yazılımı, ASP.NET Core uygulamalarında örtük olarak bulunan Microsoft. AspNetCore. 

ResponseCompression paketi tarafından sağlanır. 

Ara yazılımı bir projeye eklemek için Microsoft, aspnetcore. ResponseCompression paketini içeren Microsoft. 

Aspnetcore. app metapackageöğesine bir başvuru ekleyin. 

Yapılandırma 

Aşağıdaki kod, varsayılan MİME türleri ve sıkıştırma sağlayıcıları için yanıt sıkıştırma ara yazılımı 'nın nasıl 

etkinleştirileceğini gösterir (Brotli ve gzip): 

Aşağıdaki kod, varsayılan MİME türleri ve gzip sıkıştırma sağlayıcısı İçin yanıt sıkıştırma ara yazılımını nasıl 

etkinleştireceğinizi göstermektedir: 

public class Startup 

{ 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddResponseCompression(); 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

app.UseResponseCompression(); 

} 


Notlar: 


• app.UseResponseCompression , app.UseMvc Önce çağrıl m alidir. 









Accept-Encoding istek üst bilgisini ayarlamak ve yanıt üst bilgilerini, boyutunu ve gövdesini incelemek için 
Fiddler, Firebugveya Postman gibi bir araç kullanın. 


Accept-Encoding üst bilgisi olmadan örnek uygulamaya bir istek gönderir ve yanıtın sıkıştırılmamış olduğunu 
gözlemleyin. Content-Encoding ve vany üstbilgileri yanıt üzerinde yok. 

| Headers TextView WebForms HexView Auth Cookies Raw JSON XML 



User-Agent: Fiddler 
Transport 

Hoşt: localhost: 5000 


Get SyntaxView Transformer Headers TextView ImageViem HexVıe'A WebView Auth Caching Cookies |Raw 


HTTP/l.1 200 OK 

Date: wed, 11 lan 2017 18:30:11 anT 
content-Type: text/plain 
Server: Kestrel 
content-Length: 2032 


Lorem ipsum dolor sit amet, consectetur adiplscıng elit. Sed non risus. suspendisse lectus tortor, dign 
elementum uttrices diam. Maecenas ligula massa, varius a, semper congue, euismod non, mi. Proin porttit 
fermentum diam nisl sit amet erat. Duis semper. Duis arcu massa, sce1erisque vitae, consequat in, preti 
pharetra tempor. Cras vestibulum bibendum augue. Praesent egestas leo in pede. Praesent blandit odio eu 
ante ipsum primis in faucibus orci tuctus et uttrices posuere cubilia Curae; A1iquam nibh. Mauris ac ma 
non diam sodates hendrerit.Ut velit mauris, egestas sed, gravida nec, ornare ut, mi. Aenean ut orci vel 
non tempus aliquam, nunc turpis ullamcorper nibh, in tempus sapien eros vitae tiguta.Peltentesque rhonc 
diam. Integer quis metus vitae elit lobortis egestas.Lorem ipsum dolor sit amet, consectetuer adipiscin 
sapien. Integer tortor tetlus, atiquam faucibus, convatlis id, congue eu, quam.Mauris uttamcorper fetiş 
purus iaculis lectus, et tristique ligula justo vitae magna.Aliquam convallis sollicitudin purus. Praes 
nisl, ac euismod nibh nisl eu lectus. Fusce vulputate sem at sapien.vivamus leo. Aliguam euismod libero 
suscipit nulla in justo.suspendisse cursus rutrum augue. Mutla tincidunt tincidunt mi. curabitur iaculi 
ultricies lacus lorem varius purus. Curabitur eu amet. 


Accept-Encoding: br üstbilgisiyle örnek uygulamaya bir istek gönderir (Brotli Compression) ve yanıtın 
sıkıştırıldığını gözlemleyin. Content-Encoding ve vary üst bilgileri yanıtta bulunur. 


I Headers 


TextView 

SyntaxVıew 

WebForms 

HexView 

Auth 

Cookies 

Raw 

JSON 

XML 


Reguest Headers 


|GET/HTTP/1.1 

Client 


Accept-Encoding: br 


User-Agent: Fiddler 
Transport 

Hoşt: localhost: 5000 





Transformer Headers T extVıew SyntaxVlew ImageView HexVıew WebView Auth 

Caching Cookies 

| Raw 


HTTP/1.1 200 OK 

Date: wed, 03 Oct 2018 17:16:21 GMT 
content-Type: text/plain 
Server: Kestrel 
Trflnşfşr-EnÇOdİng; çhynked 
Content-Encoding: br I 

vary: Accept-Encodi ng| 
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Accept-Encoding: 

gzip 

üst bilgisiyle örnek uygulamaya bir istek gönderir ve yanıtın sıkıştırıldığını gözlemleyin. 

Content-Encoding 

ve 

Vary 

üst bilgileri yanıtta bulunur. 


| Headers TextView VVebForms HexView Aııth Cookies Raw JSON XML 



Accept-Encoding: gzip] 
User-Agent: Fiddler 
Transport 

Hoşt: localhost: 5000 


Responsebody is encoded.Clickto decode. 

Get SyntaxView Transfbrmer Headers TextView j ImageView | HexView WebView ] Auth Caching j Cookies | Raw 


HTTP/1.1 200 OK 

Date: vved, ll lan 2017 18:24:08 gmt 
C ontent-Type: text/plain 
server: Kestrel 
Transfer-Fnrnrlıng- rhııgked 


content-Encodıng: gzip 
vary: Accept-Encoding 
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Sağlayıcılar 

Brotli sıkıştırma sağlayıcısı 

Brotli sıkıştırılmış veri biçimiyleyanıtları sıkıştırmak için BrotliCompressionProvider kullanın. 
CompressionProviderCollectionhiçbir sıkıştırma sağlayıcısı açıkça eklenmemişse: 

• Brotli sıkıştırma sağlayıcısı, gzip sıkıştırma sağlayıcısıy labirlikte, varsayılan olarak sıkıştırma sağlayıcılarının 
dizisine eklenir. 

• Brotli sıkıştırılmış veri biçimi istemci tarafından desteklenerek sıkıştırma varsayılan olarak Brotli Compression. 
Brotli istemci tarafından desteklenmiyorsa, istemci gzip sıkıştırmasını destekliyorsa sıkıştırma varsayılan 
olarak gzip olur. 

public void ConfiguneServices(IServiceCollection Services) 

{ 

Services.AddResponseCompression(); 

} 

Herhangi bir sıkıştırma sağlayıcısı açıkça eklendiğinde, Brotoli sıkıştırma sağlayıcısının eklenmesi gerekir: 




























public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddResponseCompression(options => 

{ 

options.Providers.Add<BrotliCompressionProvider>(); 
options.Providers.Add<GzipCompressionProvider>(); 
options.Providers.Add<CustomCompressionProvider>(); 
options.MimeTypes = 

ResponseCompressionDefaults.MimeTypes.Concat( 
new[] { "image/svg+xml" }); 

}); 

} 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddResponseCompression(options => 

{ 

options.Providers.Add<BrotliCompressionProvider>(); 
options.Providers.Add<GzipCompressionProvider>(); 
options.Providers.Add<CustomCompressionProvider>(); 
options.MimeTypes = 

ResponseCompressionDefaults.MimeTypes.Concat( 
new[] { "image/svg+xml" }); 

}); 

} 


Sıkıştırma düzeyini BrotliCompressionProviderOptionsolarak ayarlayın. Brotli sıkıştırma sağlayıcısı, en hızlı 
sıkıştırma düzeyi (CompressionLevel. en hızlı) olarak varsayılan olarak en verimli sıkıştırmayı oluşturmayabilir. En 
verimli sıkıştırma isteniyorsa, ara yazılımı en uygun sıkıştırma için yapılandırın. 

SIKIŞTIRMA DÜZEYİ AÇIKLAMA 

CompressionLevel. en hızlı Elde edilen çıktı en iyi şekilde sıkıştırışa bile, sıkıştırma 

mümkün olduğunca hızlı tamamlanır. 


CompressionLevel. NoCompression 


Sıkıştırma gerçekleştirilmemelidir. 


CompressionLevel. optimum 


Sıkıştırmanın tamamlanmasının daha uzun sürse bile yanıtlar 
en iyi şekilde sıkıştırılır. 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddResponseCompression(); 

Services.Configure<BrotliCompressionProviderOptions>(options => 

{ 

options.Level = CompressionLevel.Fastest; 

}); 


Gzip sıkıştırma sağlayıcısı 

Gzip dosya biçimiyleyanıtları sıkıştırmak için GzipCompressionProvider kullanın. 
CompressionProviderCollectionhiçbir sıkıştırma sağlayıcısı açıkça eklenmemişse: 

• Gzip sıkıştırma sağlayıcısı varsayılan olarak, Brotli sıkıştırma sağlayıcısıylabirlikte sıkıştırma sağlayıcılarının 
dizisine eklenir. 

• Brotli sıkıştırılmış veri biçimi istemci tarafından desteklenerek sıkıştırma varsayılan olarak Brotli Compression. 





Brotli istemci tarafından desteklenmiyorsa, istemci gzip sıkıştırmasını destekliyorsa sıkıştırma varsayılan 
olarak gzip olur. 

• Gzip sıkıştırma sağlayıcısı, varsayılan olarak sıkıştırma sağlayıcılarının dizisine eklenir. 

• İstemci gzip sıkıştırmasını destekliyorsa, sıkıştırma varsayılan olarak gzip olur. 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddResponseCompression(); 

} 


Herhangi bir sıkıştırma sağlayıcısı açık olarak eklendiğinde gzip sıkıştırma sağlayıcısının eklenmesi gerekir: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddResponseCompression(options => 

{ 

options.Providers.Add<BrotliCompressionProvider>(); 
options.Providers.Add<GzipCompressionProvider>(); 
options.Providers.Add<CustomCompressionProvider>(); 
options.MimeTypes = 

ResponseCompressionDefaults.MimeTypes.Concat( 
new[] { "image/svg+xml" }); 

}); 

} 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddResponseCompression(options => 

{ 

options.Providers.Add<BrotliCompressionProvider>(); 
options.Providers.Add<GzipCompressionProvider>(); 
options.Providers.Add<CustomCompressionProvider>(); 
options.MimeTypes = 

ResponseCompressionDefaults.MimeTypes.Concat( 
new[] { "image/svg+xml" }); 

}); 

} 


Sıkıştırma düzeyini GzipCompressionProviderOptionsolarak ayarlayın. Gzip sıkıştırma sağlayıcısı, en hızlı 
sıkıştırma düzeyine (CompressionLevel. en hızlı) göre varsayılan olarak en verimli sıkıştırmayı oluşturmayabilir. 
En verimli sıkıştırma isteniyorsa, ara yazılımı en uygun sıkıştırma için yapılandırın. 

SIKIŞTIRMA DÜZEYİ AÇIKLAMA 

CompressionLevel. en hızlı Elde edilen çıktı en iyi şekilde sıkıştırışa bile, sıkıştırma 

mümkün olduğunca hızlı tamamlanır. 


CompressionLevel. NoCompression 


Sıkıştırma gerçekleştirilmemelidir. 


CompressionLevel. optimum 


Sıkıştırmanın tamamlanmasının daha uzun sürse bile yanıtlar 
en iyi şekilde sıkıştırılır. 




public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddResponseCompression(); 

Services.Configure<GzipCompressionProviderOptions>(options => 

{ 

options.Level = CompressionLevel.Fastest; 

}); 

} 


Özel sağlayıcılar 

ICompressionProviderile özel sıkıştırma uygulamaları oluşturun. EncodingName, bu ıcompressionProvider 
ürettiği içerik kodlamasını temsil eder. Ara yazılım bu bilgileri, isteğin Accept-Encoding üstbilgisinde belirtilen 
listeye göre sağlayıcıyı seçmek üzere kullanır. 

İstemci, örnek uygulamayı kullanarak Accept-Encoding: mycustomcompression üstbilgiyle bir istek gönderir. Ara 
yazılım özel sıkıştırma uygulamasını kullanır ve bir Content-Encoding: mycustomcompression üstbilgisiyle yanıtı 
döndürür. Özel bir sıkıştırma uygulamasının çalışması için istemcinin özel kodlamayı açıp açabilmesi gerekir. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddResponseCompression(options => 

{ 

options.Providers.Add<BrotliCompressionProvider>(); 
options.Providers.Add<GzipCompressionProvider>(); 
options.Providers.Add<CustomCompressionProvider>(); 
options.MimeTypes = 

ResponseCompressionDefaults.MimeTypes.Concat( 
new[] { "image/svg+xml" }); 

}); 

} 


public class CustomCompressionProvider : ICompressionProvider 

{ 

public string EncodingName => "mycustomcompression"; 
public bool SupportsFlush => true; 

public Stream CreateStream(Stream outputStream) 

{ 

// Create a custom compression stream wrapper here 
return outputStream; 

} 

} 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddResponseCompression(options => 

{ 

options.Providers.Add<BrotliCompressionProvider>(); 
options.Providers.Add<GzipCompressionProvider>(); 
options.Providers.Add<CustomCompressionProvider>(); 
options.MimeTypes = 

ResponseCompressionDefaults.MimeTypes.Concat( 
new[] { "image/svg+xml" }); 

}); 

} 








public class CustomCompressionProvider : ICompressionProvider 

{ 

public stning EncodingName => "mycustomcompression"; 
public bool SupportsFlush => true; 

public Stream CreateStream(Stream outputStream) 

{ 

// Create a custom compression stream wrapper here 
return outputStream; 

} 

} 



bir sıkıştırma algoritmasını nerede uygulayacağınızı gösterir. 


Reguest Headers 


|get/http/İT 


Client 

|Accept-Encoding: mycustomcotnpressiönl 

User-Agent: Fiddler 
Transport 

Hoşt: localhost: 5000 


Get SyntaxView Transfbrmer | Headers 


Response Headers 


I HTTP/1.1200 OK 


Cache 

Date: Thu, 19 Jan 2017 22:06:50 GMT 
|Vary: Accept-Encoding| 

Entity 

| Content-Encodirıg: mycustomcompression | 

Content-Type: text/plain 

Miscellaneous 

Server: Kestrel 

Transport 

Transfer-Encoding: chunked 


MİME türleri 

Ara yazılım, sıkıştırma için varsayılan bir MİME türleri kümesi belirtir: 

• application/javascript 

• application/json 

• application/xml 

• text/css 

• text/html 

• text/json 

• text/plain 

• text/xml 

MİME türlerini, yanıt sıkıştırma ara yazılım seçenekleriyle değiştirin veya ekleyin. text/* gibi joker karakter 
MİME türlerinin desteklenmediğini unutmayın. Örnek uygulama, image/svg+xmi için bir MİME türü ekler ve 
ASP.NET Core başlık görüntüsünü ( Banner. SVG) sıkıştırır ve sunar. 




















public void ConfigureServices(ISer'viceCollection Services) 

{ 

Services.AddResponseCompression(options => 

{ 

options.Providers.Add<BrotliCompressionProvider>(); 
options.Providers.Add<GzipCompressionProvider>(); 
options.Providers.Add<CustomCompressionProvider>(); 
options.MimeTypes = 

ResponseCompressionDefaults.MimeTypes.Concat( 
new[] { "image/svg+xml" }); 

}); 

} 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddResponseCompression(options => 

{ 

options.Providers.Add<BrotliCompressionProvider>(); 
options.Providers.Add<GzipCompressionProvider>(); 
options.Providers.Add<CustomCompressionProvider>(); 
options.MimeTypes = 

ResponseCompressionDefaults.MimeTypes.Concat( 
new[] { "image/svg+xml" }); 

}); 

} 


Güvenli protokolle sıkıştırma 

Güvenli bağlantılar üzerinden sıkıştırılan yanıtlar, varsayılan olarak devre dışı bırakılan EnableForHttps 
seçeneğiyle denetlenebilir. Dinamik olarak oluşturulan sayfalarla sıkıştırma kullanmak, SUA ve ihlal saldırıları gibi 
güvenlik sorunlarına neden olabilir. 

Vary üst bilgisi ekleniyor 

Accept-Encoding üst bilgisine göre yanıtları sıkıştırılırken, büyük olasılıkla birden çok sıkıştırılmış yanıt ve 
sıkıştırılmamış bir sürüm vardır, istemci ve proxy 'nin birden çok sürümün var olduğunu ve depolanması 
gerektiğini bildirmek için, vary üst bilgisi bir Accept-Encoding değeriyle eklenir. ASP.NET Core 2,0 veya sonraki 
bir sürümde, yanıt sıkıştırdığında ara yazılım vary üst bilgisini otomatik olarak ekler. 

NGINX ters proxy 'nin arkasında ara yazılım sorunu 

Bir istek NGINX tarafından proxy kullanılırken Accept-Encoding üst bilgisi kaldırılır. Accept-Encoding üst 
bilgisinin kaldırılması, ara yazılımın yanıtı sıkıştırmasını önler. Daha fazla bilgi için bkz. NGINX: sıkıştırma ve 
açma. Bu sorun, NGINX için doğrudan sıkıştırma (ASPNET/Basicara yazılım #123)ile izlenebilir. 

IIS dinamik sıkıştırma ile çalışma 

Bir uygulama için devre dışı bırakmak istediğiniz sunucu düzeyinde yapılandırılmış etkin bir IIS dinamik 
sıkıştırma modülünüzün varsa, modülü Web. config dosyasına ek olarak devre dışı bırakın. Daha fazla bilgi için 
bkz. IIS modüllerini devre dışı bırakma. 

Sorun giderme 

Fiddler, Firebugveya Postmangibi bir araç kullanarak Accept-Encoding istek üst bilgisini ayarlamanıza ve yanıt üst 
bilgilerini, boyutunu ve gövdesini incelemeye olanak tanır. Varsayılan olarak, yanıt sıkıştırma ara yazılımı 
aşağıdaki koşullara uyan yanıtları sıkıştırır: 










• Accept-Encoding üst bilgisi, br , gzip , * veya oluşturduğunuz özel bir sıkıştırma sağlayıcısıyla eşleşen özel 
bir kodlama değeri ile birlikte bulunur. Değer identity olmamalı ya da 0 (sıfır) olarak bir kalite değeri (qvalue, 

q ) ayarı olmalıdır. 

• MİME türü ( Content-Type ) ayarlanmalıdır ve ResponseCompressionOptionsyapılandırılmış bir MİME türüyle 
eşleşmelidir. 

• istek Content-Range üstbilgisini içermemelidir. 

• Yanıt sıkıştırma ara yazılımı seçeneklerinde güvenli Protokolü (https) yapılandırılmadığı takdirde istek güvenli 
olmayan protokol (http) kullanmalıdır. Güvenli içerik sıkıştırması etkinleştirildiğinde yukarıda açıklanan 
tehlikede göz önünde yer. 

• Accept-Encoding üst bilgisi, oluşturduğunuz özel bir sıkıştırma sağlayıcısıyla eşleşen gzip, * veya özel bir 
kodlama değeriyle birlikte bulunur. Değer identity olmamalı ya da 0 (sıfır) olarak bir kalite değeri (qvalue, q 
) ayarı olmalıdır. 

• MİME türü ( Content-Type ) ayarlanmalıdır ve ResponseCompressionOptionsyapılandırılmış bir MİME türüyle 
eşleşmelidir. 

• istek Content-Range üstbilgisini içermemelidir. 

• Yanıt sıkıştırma ara yazılımı seçeneklerinde güvenli Protokolü (https) yapılandırılmadığı takdirde istek güvenli 
olmayan protokol (http) kullanmalıdır. Güvenli içerik sıkıştırması etkinleştirildiğinde yukarıda açıklanan 
tehlikede göz önünde yer. 

Ek kaynaklar 

• ASP.NET Core'de uygulama başlatma 

• ASP.NET Core ara yazılımı 

• Mozilla Geliştirici Ağı: Accept-Encoding 

• RFC 7231 Bölüm 3.1.2.1: İçerik İşbirliği 

• RFC 7230 Section 4.2.3: gzip kodlaması 

• GZİP dosya biçimi belirtimi sürüm 4,3 















Performans Tanılama araçları 
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Tarafından Mike Rousos 

Bu makalede, ASP.NET Core performans sorunları tanılamaya yönelik araçları listeler. 

Visual Studio tanılama araçları 

Profil oluşturma ve tanılama araçları Visual Studio'da yerleşik olarak bulunan performans sorunlarını araştırma 
başlatmak için iyi bir yerdir. Bu araçlar, güçlü ve Visual Studio geliştirme ortamından kullanmak uygun. Araç, 
ASP.NET Core uygulamalarında CPU kullanımı, bellek kullanımı ve performans olayları analiz sağlar. Yerleşik olan 
kolay geliştirme zaman profil oluşturmayı kolaylaştırır. 

Daha fazla bilgi kullanılabilir Visual Studio belgeleri. 

Application Insights 

Application Insights uygulamanız için ayrıntılı performans verileri sağlar. Application Insights bilgileri otomatik 
olarak toplar yanıt hızlarını, hata oranları, bağımlılık yanıt süreleri ve daha fazlası. Application Insights, 
uygulamanızın özel olayları ve ölçümleri belirli oturum destekler. 

Azure Application Insights ınsights izlenen uygulamaları sağlamak için birden çok yol sağlar: 

• Uygulama Haritası - nokta performans sorunlarını veya sık erişimli hatası-nokta dağıtılmış uygulamaların 
tüm bileşenler genelinde yardımcı olur. 

• Azure ölçüm Gezgini grafikleri, eğilimler ve görsel olarak bağıntı çizim sağlayan Microsoft Azure portalında 
bir bileşenidir ve araştırma ani artışlar ve düşüşler ölçümleri değerleri. 

• Application Insights portalında performans dikey penceresini: 

o izlenen uygulamada farklı işlemlerin performans ayrıntılarını gösterir. 

o Tüm bölümleri/uzun bir süre için katkıda bulunan bağımlılıkları kontrol etmek için tek bir işlem araştırıp 
bulma sağlar. 

o Profiler performans izlemeleri üzerine toplamak için buradan çağrılabilir. 

• Azure Application Insights Profiler normal ve isteğe bağlı .NET uygulamaları profil oluşturma sağlar.Azure 
portal gösterir performans izlemeleri çağrı yığınları ve etkin yolları ile yakalanır, izleme dosyaları da 
PerfVievv kullanma daha ayrıntılı analiz için indirilebilir. 

Application Insights, çeşitli ortamlarda kullanılabilir: 

• Azure'da çalışması için en iyi duruma getirilmiş. 

• Üretim, geliştirme ve hazırlama çalışır. 

• Öğesinden yerel olarak çalıştığı Visual Studio veya diğer barındırma ortamlarında. 

Daha fazla bilgi için ASP.NET Core için Application Insights. 

PerfVievv 

PerfVievv .NET Performans sorunlarını tanılamak için özel olarak .NET ekibi tarafından oluşturulan bir Performans 
Analizi aracıdır. PerfVievv CPU kullanımı, bellek ve GC davranışı, performans olayları ve duvar saati süresi analizini 
sağlar. 





PerfVievv ve kullanmaya başlama hakkında daha fazla bilgi PerfVievv video öğreticiler veya Kullanıcı Kılavuzu 
Aracı'nda kullanılabilir okuyarak veya github'da. 

VVindovvs Performans Araç Seti 

Windows Performans Araç Seti (WPT) iki bileşenden oluşur: Windows Performans Kaydedicisi (WPR) ve VVindovvs 
Performans Çözümleyicisi'ni (WPA). VVindovvs işletim sistemlerinin ve uygulamalarının ayrıntılı performans Profil 
Araçları üretir. WPT veri görselleştirmenin daha kapsamlı yollar var, ancak veri toplanırken PerfVievv ait daha güçlü. 

PerfCollect 

PerfVievv bir .N ET senaryoları için faydalı performans çözümleme aracı olsa da, Linux ortamlarında çalışan 
ASP.NET Core uygulamaları izlemeleri toplamak için kullanamazsınız yalnızca VVindovvs üzerinde çalışır. 

PerfCollect profil oluşturma araçları, yerel Linux kullanan bir bash komut dosyası (Perf ve LTTng) tarafından 
PerfVievv çözümlenebilir Linux'ta izlemeleri toplamak için. PerfCollect, PerfVievv burada doğrudan kullanılamaz 
Linux ortamlarında performans sorunlarını gösterilmesi yararlıdır. Bunun yerine, PerfCollect izlemeleri ardından 
analiz .NET Core uygulamaları PerfVievv kullanan bir VVindovvs bilgisayara toplayabilirsiniz. 

Yükleme ve PerfCollect ile çalışmaya başlama hakkında daha fazla bilgi edinilebilir github'da. 

Diğer üçüncü taraf performans araçları 

.NET Core uygulamaları performans araştırmada yararlı olan bazı üçüncü taraf performans araçları listeler. 

• MiniProfiler 

• dotTrace ve dotMemory JetBrains gelen 

• Intel’inVTune 


Yük/stres testini ASPNET Core 
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Yük testi ve stres testi, Web uygulamasının performansı ve ölçeklenebilir olmasını sağlamak için önemlidir. 
Genellikle benzer testleri paylaşsalar bile hedefleri farklıdır. 

Yük testleri , uygulamanın belirli bir kullanıcı yükünü, yanıt hedefini karşılarken, belirli bir senaryo için işleyebilip 
İşleyemeyeceğini Test eder Uygulama normal koşullarda çalıştırılır. 

Stres testleri , genellikle uzun bir süre boyunca yoğun koşullarda çalışırken test uygulaması kararlılığını Testler, 
uygulamanın yoğun veya aşamalı olarak yükünü artırır ya da uygulamanın bilgi işlem kaynaklarını sınırlar. 

Stres testleri, stres kapsamındaki bir uygulamanın hatadan kurtulacağını ve düzgün biçimde beklenen davranışa 
geri döneceğini denetler. Stres altında, uygulama normal koşullarda çalıştırılmamaları. 

Visual Studio 2019, Visual Studio 'nun yük testi özellikleriyle son sürümüdür.Gelecekte yük testi araçları gerektiren 
müşteriler için Apache J Meter, Akamai CloudTest ve BlazeMeter gibi alternatif araçlar önerilir. Daha fazla bilgi için 
bkz. Visual Studio 2019 sürüm notları. 

Visual Studio Araçları 

Visual Studio, kullanıcıların Web performans ve yük testleri oluşturmalarına, geliştirmesine ve hata ayıklamasına 
olanak tanır. Bir Web tarayıcısında eylemleri kaydederek testler oluşturmak için bir seçenek mevcuttur. 

Visual Studio 2017 kullanarak yük testi projeleri oluşturma, yapılandırma ve çalıştırma hakkında daha fazla bilgi 
için bkz. hızlı başlangıç: yük testi projesi oluşturma. 

Yük testleri, şirket içinde çalışacak veya Azure DevOps kullanılarak bulutta çalıştırılacak şekilde yapılandırılabilir. 

Üçüncü taraf araçları 

Aşağıdaki listede, çeşitli özellik kümelerine sahip üçüncü taraf Web performans araçları yer almaktadır: 

• Apache J Meter 

• ApacheBench (AB) 

• Gatling 

• Locust 

• Batı rüzgar Web dalgalanma 

• Netling 

• Vegeta 






ASPNET Core Genelleştirme ve yerelleştirme 
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By Rick Anderson, Hemien Bovvden, Bart calixto, Nadeem Afana, ve fiham bin ateya 

AS P.N ET Core bir çoklu dil web sitesi oluşturmak, sitenizin daha geniş bir hedef kitleye ulaşmasını sağlar. 

AS P.N ET Core, farklı diller ve kültürlere yerelleştirme için hizmet ve ara yazılım sağlar. 

Uluslararası duruma getirme, Genelleştirme ve Yerelleştirmeiçerir. Genelleştirme, farklı kültürleri destekleyen 
uygulamalar tasarlama işlemidir. Genelleştirme, belirli coğrafi alanlarla ilgili olarak tanımlanmış bir dil betikleri 
kümesinin giriş, görüntüleme ve çıkışı için destek ekler. 

Yerelleştirme, belirli bir kültür/yerel ayara, Yerelleştirilebilirlik için zaten işlenmiş olan bir Genelleştirilmiş 
uygulamasını uyarlatma işlemidir. Daha fazla bilgi için bu belgenin sonundaki Genelleştirme ve 
yerelleştirme koşullarına bakın. 

Uygulama yerelleştirmesi şunları içerir: 

1. Uygulamanın içeriğini yerelleştirilebilir yapın 

2. Destekettiğiniz diller ve kültürler için yerelleştirilmiş kaynaklar sağlayın 

3. Her istek için dil/kültür seçmek üzere bir strateji uygulayın 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Uygulamanın içeriğini yerelleştirilebilir yapın 

ASP.NET Core tanıtılan ıstringLocaiizer ve ıstringi_ocaiizer<T> , yerelleştirilmiş uygulamalar geliştirilirken 
üretkenliği artırmak için tasarlanmıştır. ıstringLocaiizer , çalışma zamanında kültüre özgü kaynaklar 
sağlamak için ResourceManager ve ResourceReader kullanır. Basit arabirimde bir Dizin Oluşturucu ve 
yerelleştirilmiş dizeleri döndürmek için bir iEnumerabie vardır. ıstringLocaiizer , varsayılan dil dizelerini bir 
kaynak dosyasında depolamanızı gerektirmez. Yerelleştirmeye yönelik bir uygulama geliştirebilir ve 
geliştirmede erken kaynak dosyaları oluşturmaya gerek yoktur. Aşağıdaki kod, yerelleştirme için "başlık 
hakkında" dizesinin nasıl sarılacağı gösterilmektedir. 






using Microsoft.AspNetCore.Mvc; 

using Microsoft. Extensions. Localization; 

namespace Localization.Controllers 

{ 

[Route("api/[controller]")] 

public class AboutController : Controller 

{ 

private readonly IStringLocalizer<AboutController> _localizer; 

public AboutController(IStringLocalizercAboutController> localizer) 

{ 

_localizer = localizer; 

} 

[HttpGet] 

public string Get() 

{ 

return _localizer["About Title"]; 

} 

} 

} 

Yukarıdaki kodda ıstringLocaiizer<T> uygulama bağımlılık eklemeişleminden gelir. Yerelleştirilmiş "başlık 
hakkında" değeri bulunmazsa, Dizin Oluşturucu anahtarı döndürülür, diğer bir deyişle "başlık hakkında" 
dizesidir. Uygulama geliştirmeye odaklanabilmeniz için varsayılan dil değişmez dizelerini uygulamada 
bırakabilir ve Localizer' da kaydırabilirsiniz. Uygulamanızı varsayılan diliniz ile geliştirin ve öncelikle 
varsayılan bir kaynak dosyası oluşturmadan yerelleştirme adımına hazırlayın. Alternatif olarak, geleneksel 
yaklaşımı kullanabilir ve varsayılan dil dizesini almak için bir anahtar sağlayabilirsiniz. Birçok geliştirici için, 
varsayılan Language. resx dosyası olmayan yeni iş akışı ve yalnızca dize değişmez değerlerini sarmalama, bir 
uygulamayı yerelleştirme yükünü azaltabilir. Diğer geliştiriciler geleneksel iş akışını tercih eder, daha uzun dize 
sabit değerleri ile çalışmayı kolaylaştırır ve yerelleştirilmiş dizelerin güncelleştirilmesini kolaylaştırır. 

HTML içeren kaynaklar için iHtmiLocaiizer<T> uygulamasını kullanın. iHtmiLocalizer HTML, kaynak 
dizesinde biçimlendirilen, ancak kaynak dizenin kendisini kodlayan bağımsız değişkenleri kodluyor. Aşağıda 
vurgulanan örnekte yalnızca name parametresinin değeri HTML kodlamak olur. 

using System; 

using Microsoft.AspNetCore.Http; 

using Microsoft.AspNetCore.Localization; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.Localization; 

namespace Localization.Controllers 

{ 

public class BookController : Controller 

{ 

private readonly IHtmlLocalizer<BookController> _localizer; 

public BookController(IHtmlLocalizer<BookController> localizer) 

{ 

_localizer = localizer; 

} 

public IActionResult Hello(string name) 

{ 

ViewData["Message"] = _localizer["<b>Hello</bxi> {0}</i>"j name]; 
return View(); 

} 











Note: Genellikle HTML değil yalnızca metni yerelleştirmek istersiniz. 
En düşük düzeyde, bağımlılık ekleme ıstringLocalizerFactory alabilir: 


public class TestController : Controller 

{ 

private readonly IStringLocalizer _localizer; 
private readonly IStringLocalizer _localizer2; 

public TestController(IStringLocalizerFactory factory) 

{ 

var type = typeof(SharedResource); 

var assemblyName = new AssemblyName(type.GetTypeInfo().Assembly.FullName); 
_localizer = factory.Create(type); 

_localizer2 = factory.Create("SharedResource", assemblyName.Name); 

} 

public IActionResult About() 

{ 

ViewData["Message"] = _localizer["Your application description page."] 

+ " loc 2: " + _localizer2["Your application description page."]; 


Yukarıdaki kod, iki fabrika oluşturma yönteminin her birini gösterir. 

Yerelleştirilmiş dizelerinizi denetleyiciye, alana veya yalnızca bir kapsayıcıya göre bölümleyebilirsiniz. Örnek 



public class InfoController : Controller 

{ 

private readonly IStringLocalizer<InfoController> _localizer; 
private readonly IStringLocalizer<SharedResource> _sharedLocalizer; 

public InfoController(IStringLocalizer<InfoController> localizer, 
IStringLocalizer<SharedResource> sharedLocalizer) 

{ 

_localizer = localizer; 

_sharedLocalizer = sharedLocalizer; 

} 

public string TestLoc() 

{ 

string msg = "Shared resx: " + _sharedLocalizer["Hello!"] + 

" Info resx " + _localizer["Hello!"]; 

return msg; 

} 


Yerelleştirmeyi görüntüle 








ıviewLocaiizer hizmeti bir Görünümiçin yerelleştirilmiş dizeler sağlar. viewLocaiizer sınıfı bu arabirimi 
uygular ve görünüm dosyası yolundan kaynak konumunu bulur. Aşağıdaki kod, ıviewLocaiizer varsayılan 
uygulamasının nasıl kullanılacağını gösterir: 

@using Microsoft.AspNetCore.Mvc.Localization 
@inject IViewLocalizer Localizer 
@{ 

ViewData["Title"] = Localizer["About"]; 

} 

<h2>@ViewData["Title"].</h2> 

<h3>@ViewData["Message"]</h3> 

<p>@Localizer["Use this area to provide additional information."]</p> 

ıviewLocaiizer varsayılan uygulama, görünümün dosya adına göre kaynak dosyasını bulur. Genel paylaşılan 
kaynak dosyası kullanma seçeneği yoktur. viewLocaiizer , iHtmiLocalizer kullanarak yorumdur 'ı uygular, bu 
yüzden Razor, yerelleştirilmiş dizeyi HTM L olarak kodlayamıyor. Kaynak dizelerini parametreleştirebilirsiniz ve 
ıviewLocaiizer , kaynak dize değil, parametreleri HTML olarak kodlayacaksınız. Aşağıdaki Razor 
işaretlemesini göz önünde bulundurun: 

@Localizer["<i>Hello</i> <b>{0}!</b>", UserManager.GetUserName(User)] 

Bir Fransızca kaynak dosyası şunları içerebilir: 

ANAHTAR DEĞER 


<i>Hello</i> <b>{0}!</b> <i>Bonjour</i> <b>{0} !</b> 

İşlenmiş görünüm, kaynak dosyasındaki HTML işaretlemesini içerir. 

Note: Genellikle HTML değil yalnızca metni yerelleştirmek istersiniz. 

Bir görünümde paylaşılan kaynak dosyasını kullanmak için iHtmiLocaiizer<T> ekleme: 

@using Microsoft .AspNetCore.Mvc. Localization 
@using Localization. Services 

@inject IViewLocalizer Localizer 

@inject IHtmlLocalizer<SharedResource> SharedLocalizer 
@{ 

ViewData["Title"] = Localizer["About"]; 

} 

<h2>@ViewData["Title"].</h2> 

<hl>@SharedLocalizer["Hello!"]</hl> 


Dataaçıklamaların yerelleştirilmesi 

Dataaçıklamaların hata iletileri ıstringLocaiizer<T> ile yerelleştirilir. ResourcesPath = "Resources" seçeneğini 
kullanarak, RegisterviewModei içindeki hata iletileri aşağıdaki yollardan birinde depolanabilir: 

• Resources/Vievvmodeller. account. RegisterViewModel. fr. resx 

• Kaynaklar/Viewmodeller/hesap/RegisterViewModel. fr. resx 

















public class RegisterViewModel 

{ 

[Required(ErrorMessage = "The Email field is required.")] 

[EmailAddress(ErrorMessage = "The Email field is not a valid email addness.")] 

[Display(Name = "Email")] 
public string Email { get; set; } 

[Required(ErrorMessage = "The Password field is required.")] 

[Stringl_ength(8, ErrorMessage = "The {0} must be at least {2} characters long.", MinimumLength = 6)] 
[DataType(DataType.Password)] 

[Display(Name = "Password")] 
public string Password { get; set; } 

[DataType(DataType.Password)] 

[Display(Name = "Confirm password")] 

[Compare("Password"j ErrorMessage = "The password and confirmation password do not match.")] 
public string ConfirmPassword { get; set; } 

} 


ASP.NET Core MVC 1.1.0 ve üzeri, doğrulama olmayan öznitelikler yereldir.ASP.NET Core MVC 1,0, 
doğrulama olmayan öznitelikler için yerelleştirilmiş dizeleri aramaz. 


Birden çok sınıf için bir kaynak dizesi kullanma 

Aşağıdaki kod, birden çok sınıfa sahip doğrulama öznitelikleri için bir kaynak dizesinin nasıl kullanılacağını 
gösterir: 


public void ConfigureServices(IServiceCollection Services) 

{ 


Services .AddMvc() 

.AddDataAnnotationsLocalization(options => { 

options.DataAnnotationLocalizerProvider = (type, factory) => 
factory.Create(typeof(SharedResource)); 

}); 


Yukarıdaki kodda SharedResource , doğrulama iletilerinizin depolandığı resx öğesine karşılık gelen sınıftır. Bu 
yaklaşımda, veri açıklamaları her sınıf için kaynak yerine yalnızca SharedResource kullanır. 


Destekettiğiniz diller ve kültürler için yerelleştirilmiş kaynaklar 
sağlayın 

Supportedkültürleri ve SupportedUlCultures 

ASP.NET Core, Supportedcultures ve SupportedUlCultures iki kültür değeri belirtmenize olanak tanır. 
Supportedcultures için Culturelnfo nesnesi, tarih, saat, sayı ve para birimi biçimlendirme gibi kültüre bağımlı 
işlevlerin sonuçlarını belirler. Supportedcultures metin, büyük/küçük harf kuralları ve dize karşılaştırmalarının 
sıralama sırasını da belirler. Sunucunun kültürü nasıl aldığı hakkında daha fazla bilgi için bkz . Culturelnfo. 
CurrentCulture . SupportedUlCultures , hangi çeviren dizelerin (. resx dosyalarından) 
ResourceManagertarafından arandığını belirler. ResourceManager .yalnızca currentuıcuiture tarafından 
belirlenen kültüre özgü dizeleri arar. .N ET 'teki her iş parçacığında CurrentCulture ve currentuıcuiture 
nesneleri vardır. ASP.NET Core kültüre bağımlı işlevleri işlerken bu değerleri inceler.Örneğin, geçerli iş 
parçacığının kültürü "en-US" (İngilizce, Birleşik Devletler) olarak ayarlandıysa, 

DateTime.Now.Tol_ongDateString( ) "Perşembe, 1 8 Şubat 201 6" değerini görüntüler, ancak CurrentCulture "ES- 
ES" (İspanyolca, Ispanya) olarak ayarlandıysa çıkış "Jueves, 18 de febrero de 2016" olacaktır. 


Kaynak dosyalar 














Kaynak dosyası, koddan yerelleştirilebilir dizeleri ayırmak için kullanışlı bir mekanizmadır. Varsayılan olmayan 
dil için çevrilmiş dizeler yalıtılmış . resx kaynak dosyalarıdır. Örneğin, çevrilmiş dizeleri içeren Welcome. es. resx 
adlı İspanyolca kaynak dosyası oluşturmak isteyebilirsiniz, "es", İspanyolca için dil kodudur. Bu kaynak 
dosyasını Visual Studio 'da oluşturmak için: 


1 . Çözüm Gezgini' de, Yeni > öğe eklemek > kaynak dosyasını içerecek klasöre sağ tıklayı 



*□ 


Controller... 

New Item... 

Existing Item... 

New Scaffolded Item.. 
New Folder 
Class... 


Ctrl+Shift+A 

I^Shift+Alt+A 


9 x 


Solution Bcplorer 

û b - 9 r® fi — 

Search Solution Explorer (Ctrl*;) fi 

51 Solution 'WebApplication1' (1 project) 
a (kİ Solution İtems 
global.json 

a ü src 

A !|1 WebApplication1 

> fi Properties 

> References 

> @ wwwroot 

> fi Dependencies 

a Û Controllers 

c* AccountController.es 
c« HomeController.es 
c* ManageController.es 

> Migrations 

> ti Models 


& 



View in Brovvser (Microsoft Edge) 

Ctrl+Shift+W 

Brovvse With... 


Hidefrom Solution Explorer 

Add 

► 

Scopeto This 

New Solution Explorer View 

Cut 

Ctrl+X 

Copy 

Ctrl+C 

Paste 

Ctrl+V 

Del ete 

Del 

Rename 


Öpen Folder in File Bcplorer 

Öpen Command Line 

t 


2. Yüklü şablonları ara kutusuna "kaynak" yazın ve dosyayı adlandırın. 










Add New Item - VVebApplicationl 


^ Installed 


Şort by: 


Default 


Server-side 

Client-side 

Search Results 


O 


Resources File 


t> Online 



Server-side ^ Server-side 

A file for storing resources 


Name: | |Wekome.es.resx]J 


Add 

Cancel 





3. Ad sütununa anahtar değerini (yerel dize) ve değer sütununda çevrilmiş dizeyi girin. 



Visual Studio, Welcome. es. resx dosyasını gösterir. 



























Kaynak dosyası adlandırma 

Kaynaklar, sınıfının tam tür adı için derleme adı eksi olarak adlandırılır.Örneğin, ana derlemesi sınıf için 
LocalizationWebsite.Web.dll olan bir projedeki Fransızca kaynak LocalizationWebsite.Web.Startup BaşlangLÇ. 
fr. resx olarak adlandırılır. Locaiizationwebsite.web.controiiers.HomeController sınıfı için bir kaynak 
denetleyicileri. HomeController. fr. resx olarak adlandırılır. Hedeflenen sınıfınızın ad alanı, derleme adı ile aynı 
değilse, tam tür adına ihtiyacınız olur. Örneğin, örnek projede ExtraNamespace.Toois türü için bir kaynak 
ExtraNamespace. Tools. fr. resx olarak adlandırılır. 

Örnek projede configureServices yöntemi ResourcesPath "resources" olarak ayarlıyor, bu nedenle ana 
denetleyicinin Fransızca kaynak dosyasının proje göreli yolu kaynaklar/denetleyiciler. HomeController. fr. 
resx olur. Alternatif olarak, kaynak dosyalarını düzenlemek için klasörleri de kullanabilirsiniz. Ana denetleyici 
için yol kaynaklar/denetleyiciler/HomeController. fr. resx olacaktır. ResourcesPath seçeneğini kullanmazsanız,. 
resx dosyası proje temel dizinine gidecek. HomeController kaynak dosyası denetleyicileri. HomeController. fr. 
resx olarak adlandırılır. Nokta veya yol adlandırma kuralını kullanma seçeneği, kaynak dosyalarınızı nasıl 
düzenlemek istediğinize bağlıdır. 


KAYNAK ADI NOKTA VEYA YOL ADLANDIRMA 

Kaynaklar/denetleyiciler. HomeController. fr. resx Nokta 

Kaynaklar/denetleyiciler/HomeController. fr. resx Yol 


Razor görünümlerinde @inject ıviewLocaiizer kullanan kaynak dosyaları, benzer bir düzene uyar. Bir 
görünüm için kaynak dosyası, nokta adlandırması veya yol adlandırması kullanılarak adlandırılabilir. Razor 
görünümü kaynak dosyaları, ilişkili görünüm dosyalarının yolunu taklit. ResourcesPath "resources" olarak 
belirlediğimiz varsayılarak, Görünümler/Home/about. cshtml görünümüyle ilişkili Fransızca kaynak dosyası 
aşağıdakilerden biri olabilir: 

• Kaynaklar/görünümler/giriş/about. fr. resx 

• Kaynaklar/görünümler. Home, about. fr. resx 





















ResourcesPath seçeneğini kullanmazsanız, bir görünümün . resx dosyası görünümü ile aynı klasörde bulunur. 

RootNamespaceAttribute 

RootNamespace özniteliği, bir derlemenin kök ad alanı derleme adından farklı olduğunda bir derlemenin kök 
ad alanını sağlar. 


VVARNING 

Bu durum, projenin adı geçerli bir .NET tanımlayıcısı olmadığında ortaya çıkabilir. Örneğin my-project-name.csproj , 
my_project_name kök ad alanını ve derleme adını bu hataya my-project-name kullanır. 


Bir derlemenin kök ad alanı, derleme adından farklıysa: 

• Yerelleştirme varsayılan olarak çalışmaz. 

• Yerelleştirme, derleme içinde kaynakların aranacağı yol nedeniyle başarısız olur. RootNamespace , yürütme 
işlemi için kullanılamayan bir derleme zamanı değeridir. 

RootNamespace AssembiyName farklıysa, Assemblylnfo.es (parametre değerleri gerçek değerlerle değiştirilmiştir) 
içine aşağıdakini ekleyin: 

using System.Reflection; 

using Microsoft. Extensions. Localization; 

[assembly: ResourceLocation("Resource Folder Name")] 

[assembly: RootNamespace("App Root Namespace")] 

Yukarıdaki kod resx dosyalarının başarıyla çözümlenmesine izin vermez. 

Kültür geri dönüş davranışı 

Bir kaynak aranırken, yerelleştirme "kültür geri dönüş" bölümünde ilgilenir, istenen kültürden başlayarak, 
bulunamazsa bu kültürün üst kültürüne geri döner. Bir kenara de, Culturelnfo. Parent özelliği üst kültürü 
temsil eder. Bu genellikle (her zaman değil), National signifier 'in ISO 'dan kaldırılması anlamına gelir. 

Örneğin, Meksika 'da konuşulan İspanyolca diyalekt "es-MX" dir.Ana "es"—İspanyolca herhangi bir ülkeye 
özgü değildir. 

Sitenizin "fr-CA" kültürünü kullanarak "hoş geldiniz" kaynağı için bir istek aldığını düşünün. Yerelleştirme 
sistemi aşağıdaki kaynakları sırayla arar ve ilk eşleşmeyi seçer: 

• Welcome.fr-CA. resx 

• VVeicome. fr. resx 

• VVeicome. resx ( NeutralResourcesLanguage "fr-CA" ise) 

Örnek olarak,". fr" kültür göstergesini kaldırırsanız ve kültürü Fransızca olarak ayarlarsanız, varsayılan kaynak 
dosyası okunurdur ve dizeler yerelleştirilir. Kaynak Yöneticisi, istenen kültürü hiçbir şey karşılamıyorsa, için bir 
varsayılan veya geri dönüş kaynağı belirler. Yalnızca istenen kültür için bir kaynak eksik olduğunda anahtarı 
döndürmek istiyorsanız varsayılan bir kaynak dosyanız olmamalıdır. 

Visual Studio ile kaynak dosyaları oluşturma 

Dosya adında bir kültür olmadan Visual Studio 'da bir kaynak dosyası oluşturursanız (örneğin, VVeicome. resx), 
Visual Studio her bir dize için bir özelliği olan bir C# sınıf oluşturur. ASP.NET Core, genellikle istediğiniz gibi 
değildir. Genellikle Default. resx kaynak dosyanız (kültür adı olmayan bir. resx dosyası) yoktur.. Resx dosyasını 
bir kültür adı (örneğin, VVeicome. fr. resx) ile oluşturmanızı öneririz. Kültür adı ile bir. resx dosyası 
oluşturduğunuzda, Visual Studio sınıf dosyası oluşturmaz. 










Diğer kültürleri Ekle 

Her dil ve kültür bileşimi (varsayılan dil dışında), benzersiz bir kaynak dosyası gerektirir.ISO dili kodlarının 
dosya adının parçası olduğu yeni kaynak dosyaları oluşturarak farklı kültürler ve yerel ayarlar için kaynak 
dosyaları oluşturun (örneğin, en-US, fr-CAve en-GB). Bu ISO kodları, Welcome.es-MX. resx 
(Ispanyolca/Meksika) içinde olduğu gibi dosya adı ve. resx dosya uzantısı arasına yerleştirilir. 

Her istek için dil/kültür seçmek üzere bir strateji uygulayın 

Yerelleştirmeyi yapılandırma 

Yerelleştirme startup.configureServices yönteminde yapılandırılır: 

Services.AddLocalization(options => options.ResourcesPath = "Resources"); 

Services.AddMvc() 

.AddViewLocalization(LanguageViewLocationExpanderFormat.Suffix) 

.AddDataAnnotationsLocalization(); 

• AddLocalization , yerelleştirme hizmetlerini hizmetler kapsayıcısına ekler. Yukarıdaki kod, kaynakların 
yolunu da "resources" olarak ayarlar. 

• AddviewLocaiization yerelleştirilmiş görünüm dosyaları için destek ekler. Bu örnek görünümde 
yerelleştirme, görünüm dosyası sonekini temel alır. Örneğin, lndex. fr. cshtml dosyasındaki "fr". 

• AddDataAnnotationsLocalization , ıstringLocalizer soyutlamalar aracılığıyla yerelleştirilmiş 
DataAnnotations doğrulama iletileri için destek ekler. 

Yerelleştirme ara yazılımı 

Bir istekteki geçerli kültür, yerelleştirmeAraortamında ayarlanır. Yerelleştirme ara yazılımı startup.configure 
yönteminde etkinleştirilmiştir. Yerelleştirme ara yazılımı, istek kültürünü denetlemeyebilir (örneğin, 
app.us 0 MvcwithDefauitRoute() ) herhangi bir ara yazılım önce yapılandırılmalıdır. 

var supportedCultures = new[] 

{ 

new CultureInfo("en-US"), 
new CultureInfo("fr "), 

}; 

app .UseRequestl_ocalization(new RequestLocalizationOptions 
{ 

DefaultRequestCulture = new RequestCulture("en-US"), 

// Formatting numbers, dates, ete. 

SupportedCultures = supportedCultures, 

// UI strings that we have localized. 

SupportedUICultures = supportedCultures 

}); 

app.UseStaticFiles(); 

// To configure external authentication, 

// see: http://go.microsoft.com/fwlink/?LinkID=532715 

app.UseAuthentication(); 

app.UseMvcWlthDefaultRoute(); 

UseRequestLocalization bir Requestl_ocalizationOptions nesnesini başlatır. Her istekte 
RequestLocaiizationOptions RequestcuitureProvider listesi numaralandırılır ve istek kültürünü başarıyla 
belirleyebilmesi için ilk sağlayıcı kullanılır. Varsayılan sağlayıcılar RequestLocaiizationOptions sınıfından gelir: 


1. QueryStringRequestCultureProvider 














2. CookieRequestCultureProvider 

3. Acceptl_anguageHeaderRequestCultureProvider 

Varsayılan liste, en çok belirli olan en az özel. Makalenin ilerleyen kısımlarında, sırayı nasıl 
değiştirekullanabileceğinizi ve hatta özel bir kültür sağlayıcısı nasıl ekleyebileceğiniz hakkında bilgi 
edineceksiniz. Sağlayıcıların hiçbiri istek kültürünü belirleyebiliyorsanız DefauitRequestcuiture kullanılır. 

QueryStringRequestCultureProvider 

Bazı uygulamalar kültür ve Ul kültürünüayarlamak için bir sorgu dizesi kullanır. Tanımlama bilgisi veya 
Accept-Language üst bilgisi yaklaşımını kullanan uygulamalar için, URL 'ye bir sorgu dizesi eklemek hata 
ayıklama ve test kodu için yararlıdır. Varsayılan olarak, QuerystringRequestcuitureProvider 
RequestcuitureProvider listesindeki ilk yerelleştirme sağlayıcısı olarak kaydedilir. Sorgu dizesi parametrelerini 
cuiture ve ui-cuiture geçirin. Aşağıdaki örnek, belirli kültürü (dil ve bölge) Ispanyolca/Meksika olarak 
ayarlar: 

http://localhost:5000/?culture=es-MX&ui-culture=es-MX 

Yalnızca iki ( cuiture veya ui-culture ) birini geçirirseniz, sorgu dizesi sağlayıcısı, her iki değeri de geçirdiğiniz 
birini kullanarak ayarlar. Örneğin, yalnızca kültür ayarlandığında hem cuiture hem de uiculture ayarlanır: 

http://localhost:5000/?culture=es-MX 

CookieRequestCultureProvider 

Üretim uygulamaları genellikle ASP.N ET Core kültür tanımlama bilgisiyle kültürü ayarlamaya yönelik bir 
mekanizma sağlar. Bir tanımlama bilgisi oluşturmak için MakeCookievalue yöntemini kullanın. 

cookieRequestcuitureProvider DefaultcookieName , kullanıcının tercih ettiği kültür bilgilerini izlemek için 
kullanılan varsayılan tanımlama bilgisi adını döndürür. Varsayılan tanımlama bilgisi adı .AspNetcore.cuiture . 

Tanımlama bilgisi biçimi c=%langcode%|u1c=%langcode% , burada c cuiture ve uic uiculture , örneğin: 
c=en-UK[uic=en-US 

Kültür bilgisi ve Ul kültürünün yalnızca birini belirtirseniz, belirtilen kültür hem kültür bilgileri hem de Ul 
kültürü için kullanılacaktır. 

Accept-Language HTTP üstbilgisi 

Accept-Language üst bilgisi tarayıcıların çoğu tarayıcıda ayarlanabilir ve başlangıçta kullanıcının dilini 
belirtmeye yöneliktir. Bu ayar, tarayıcının temel alınan işletim sisteminden gönderme veya devralma olarak 
ayarlandığını gösterir. Bir tarayıcıdan Accept-Language HTTP üst bilgisi, kullanıcının tercih ettiği dili 
algılamaya yönelik uygun olmayan bir yoldur (bkz. bir tarayıcıda dil tercihlerini ayarlama). Bir üretim 
uygulaması, kullanıcının kültür seçimini özelleştirmenin bir yolunu içermelidir. 

IE 'de Accept-Language HTTP üstbilgisini ayarlama 

1. Dişli simgesinden Internet seçenekleri 1 ne dokunun. 


2. Diller' e dokunun. 


















Internet Options 


? X 


General Security Privacy Content Connections Programs Advanced 
Home page 



To create home page tabs, type each address on its own line. 
https://github.com/aspnet/Docs 


Use current 


Use default 


Use new tab 


Startup 

O Start vvittı tabs from the last session 
® Start with home page 
Tabs 

Change how webpages are displayed in tabs. 


Tabs 


Browsing history - 

Delete temporary fileş, history, cookies, saved passwords, and web 
form infbrmation. 


Q Delete browsing history on exit 


Delete... 


Settings 


Appearance 


Colors 

| Languages | 

Fonts 

Accessibility 


OK 



Cancel 

Apply 


3. Dil tercihlerini ayarla' ya dokunun. 

4. Dil ekle' ye dokunun. 

5. Dilini ekleyin. 

6. Dile dokunun ve ardından Yukarı taşı' ya dokunun. 

Content-Language HTTP üst bilgisi 

Content-Language varlık üst bilgisi: 

• , Hedef kitleleri için tasarlanan dilleri tanımlamakta kullanılır. 

• Kullanıcının kendi tercih ettiği dile göre ayırt etmesine izin verir. 

Varlık üstbilgileri hem HTTP isteklerinde hem de yanıtlarda kullanılır. 

Content-Language Üst bilgisi, Özellik ApplyCurrentCultureToResponseHeaders ayarlanarak eklenebilir. 
Content-Language üst bilgisi ekleniyor: 

• Requestlocalizationara yazılım Content-Language üst bilgisini currentuıcuiture ayarlamaya izin verir. 

• Yanıt üst bilgisini açıkça Content-Language ayarlama gereksinimini ortadan kaldırır. 

app.UseRequestLocalization(new RequestLocalizationOptions 
{ 

ApplyCurrentCultureToResponseHeaders = true 

}); 

Özel bir sağlayıcı kullan 

Müşterilerinizin kendi dil ve kültürünü veritabanlarınızı veritabanlarına depolamasına izin vermek istediğinizi 
varsayalım. Kullanıcı için bu değerleri aramak üzere bir sağlayıcı yazabilirsiniz. Aşağıdaki kod, özel bir 
sağlayıcının nasıl ekleneceğini göstermektedir: 



























































private const string enUSCulture = "en-US"; 

Services.Configure<RequestLocalizationOptions>(options => 

{ 

var supportedCultures = new[] 

{ 

new Culturelnfo(enUSCulture), 
new CultureInfo("fr") 

}; 

options.DefaultRequestCulture = new RequestCulture(culture: enUSCulture, uiCulture: enUSCulture); 
options.SupportedCultures = supportedCultures; 
options.SupportedUICultures = supportedCultures; 

options.RequestCultureProviders.Insert(0, new CustomRequestCultureProvider(async context = > 

{ 

// My custom request culture logic 
return new ProviderCultureResult("en"); 

})); 

})j 


private const string enUSCulture = "en-US"; 

Services.Configure<RequestLocalizationOptions>(options => 

{ 

var supportedCultures = new[] 

{ 

new Culturelnfo(enUSCulture), 
new CultureInfo("fr") 

}; 

options.DefaultRequestCulture = new RequestCulture(culture: enUSCulture, uiCulture: enUSCulture); 
options.SupportedCultures = supportedCultures; 
options.SupportedUICultures = supportedCultures; 

options.AddInitialRequestCultureProvider(new CustomRequestCultureProvider(async context => 

{ 

// My custom request culture logic 
return new ProviderCultureResult("en"); 

})); 

}); 

Yerelleştirme sağlayıcıları eklemek veya kaldırmak için RequestLocaiizationOptions kullanın. 

Kültürü program aracılığıyla ayarlama 

GitHub 'daki Bu örnek Yerelleştirme, startervveb projesi, culture ayarlamak için Kullanıcı arabirimi içerir. 
Views/Shared/_SelectLanguagePartiai cshtml dosyası desteklenen kültürler listesinden kültürü seçmenize 
olanak sağlar: 





@using Microsoft.AspNetCore.Builder 
@using Microsoft.AspNetCore.Http.Features 
@using Microsoft .AspNetCore. Localization 
@using Microsoft.AspNetCore.Mvc.Localization 
@using Microsoft.Extensions.Options 

@inject IViewLocalizer Localizer 

@inject IOptions<RequestLocalizationOptions> LocOptions 

@{ 

var requestCulture = Context.Features.Get<IRequestCultureFeature>(); 
var cultureltems = LocOptions.Value.SupportedUICultures 

.Select(c => new SelectListltem { Value = c.Name, Text = c.DisplayName }) 

.ToList(); 

var returnUrl = string.IsNullOrEmpty(Context.Request.Path) ? : $"~{Context.Request.Path.Value}"; 

} 

<div title="@Localizer["Request culture provider:"] @requestCulture?.Provider?.GetType().Name"> 

<form id="selectLanguage" asp-controller="Home" 

asp-action="SetLanguage" asp-route-returnUrl="@returnUrl" 
method="post" class="form-horizontal" role="form"> 

<label asp-for="@requestCulture.RequestCulture.UICulture.Name">@Localizer["Language:"]</label> 
<select name="culture" 

onchange="this.form.submit();" 

asp-for="@requestCulture.RequestCulture.UICulture.Name" asp-items="cultureltems"> 

</select> 

</form> 

</div> 

Görünümler/Shared/_SelectLanguagePartial. cshtml dosyası, düzen dosyasının footer bölümüne eklenir, bu 
nedenle tüm görünümlerde kullanılabilir hale gelir: 

<div class="container body-content" style="margin-top:60px"> 

@RenderBody() 

<hr> 

<footer> 

<div class="row"> 

<div class="col-md-6"> 

<p>&copy; @System.DateTime.Now.Year - Localization</p> 

</div> 

<div class="col-md-6 text-right"> 

@await Html.PartialAsync("_SelectLanguagePartial") 

</div> 

</div> 

</footer> 

</div> 

setLanguage yöntemi kültür tanımlama bilgisini ayarlar. 

[HttpPost] 

public IActionResult SetLanguage(string culture^ string returnUrl) 

{ 

Response.Cookies.Append( 

CookieRequestCultureProvider.DefaultCookieNamej 

CookieRequestCultureProvider.MakeCookieValue(new RequestCulture(culture )), 
new CookieOptions { Expires = DateTimeOffset.UtcNow.AddYears(l) } 

); 

return LocalRedirect(returnUrl); 

} 


Bu proje için örnek koda _SelectLanguagePartial. cshtml 'yi ekleyemezsiniz. GitHub 'daki Yerelleştirme. 






startervveb projesi, bağımlılığı ekleme kapsayıcısı aracılığıyla RequestLocaiizationOptions Razor kısmi 'e Flow 
koduna sahiptir. 

Model bağlama yolu verileri ve sorgu dizeleri 

Model bağlama yolu verilerinin ve sorgu dizelerinin Genelleştirme davranışınıinceleyin. 

Genelleştirme ve yerelleştirme koşulları 

Uygulamanızı yerelleştirme işlemi, modern yazılım geliştirmede yaygın olarak kullanılan ilgili karakter 
kümelerinin temel olarak anlaşılmasını ve bunlarla ilişkili sorunların anlaşılmasını gerektirir. Tüm bilgisayarlar 
metni sayı (kodlar) olarak depolayabilse de, farklı sistemler farklı sayılar kullanarak aynı metni depolar. 
Yerelleştirme süreci, belirli bir kültür/yerel ayar için uygulama kullanıcı arabirimini (Ul) çevirmeye başvurur. 

Yerelleştirilebilirlik , bir Genelleştirilmiş uygulamasının yerelleştirme için hazırlandığının doğrulanması için bir 
ara işlemdir. 

Kültür adi için RFC 4646 biçimi <languagecode2>-<country/regioncode2> , burada <languagecode2> dil kodudur 
ve <country/regioncode 2 > alt kültür kodudur. Örneğin, İspanyolca (Şili) için es-CL , İngilizce (Birleşik 
Devletler) için en-us ve İngilizce (Avustralya) için en-AU . RFC 4646 , bir dille İLİŞKİLİ bir ISO 639 2-Letter 
küçük harfli kültür kodu ve bir ülke veya bölgeyle İLİŞKİLİ bir ISO 3166 2 harfli büyük harf alt kültür kodu 
birleşimidir. Bkz. dil kültürü adı. 

Uluslararası duruma getirme genellikle "I18N" olarak kısaltılır.Kısaltma ilk ve son harfleri ve aralarındaki 
harflerin sayısını alır, bu nedenle 18 ilk "I" ve son "N" arasındaki harflerin sayısını temsil eder. Aynı 
Genelleştirme (G11N) ve yerelleştirme (L10N) için de geçerlidir. 

Larındaki 

• Genelleştirme (G11 N): bir uygulamanın farklı dil ve bölgeleri desteklemesini sağlama işlemi. 

• Yerelleştirme (L10N): belirli bir dil ve bölge için bir uygulamayı özelleştirme işlemi. 

• Uluslararası duruma getirme (I18N): hem Genelleştirme hem de yerelleştirmeyi açıklar. 

• Kültür: bir dildir ve isteğe bağlı olarak bir bölgedir. 

• Nötr kültür: belirtilen dile sahip, ancak bölge olmayan bir kültür, (örneğin, "en", "es") 

• Belirli kültür: belirtilen dile ve bölgeye sahip bir kültür, (örneğin, "en-US", "en-GB", "es-CL") 

• Üst kültür: belirli bir kültürü içeren nötr kültür, (örneğin, "tr", "en-US" ve "en-GB" öğesinin üst kültürüdür) 

• Yerel ayar: bir yerel ayar kültür ile aynıdır. 


NOTE 

Ondalık alanlara ondalık virgüller giremeyebilirsiniz. Ondalık bir nokta ve ABD İngilizcesi olmayan tarih biçimleri için 
virgül (",") kullanan İngilizce olmayan yerel ayarlarda jOuery doğrulamasını desteklemek için, uygulamanızı globalize için 
adımlar uygulamanız gerekir. Ondalık virgülden ekleme hakkında yönergeler için bkz. GitHub sorunu 4076 . 


NOTE 

ASP.NET Core 3,0 Web Apps öncesinde, istenen kültür desteklenmiyorsa istek başına LogLevel.warning türünde bir 
günlük yazar. Her istek için bir ı_ogLevel.warning günlüğe kaydetme, gereksiz bilgilerle büyük günlük dosyaları 
yapabilir. Bu davranış, ASP.NET 3,0 ' de değiştirilmiştir. @No_t-0, üretim günlüklerinin boyutunu azaltan 
LogLevel. Debug türünde bir günlük yazar. 


Ek kaynaklar 
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Tarafından Sebastien Ros ve Scott Addie 

Bu makale, bir ASP.N ET Core uygulaması ile taşınabilir nesne (SAS) dosyalarında kullanma adımları size Orchard 
Core framevvork. 

Not: Orchard Core Microsoft Ürün değildir.Sonuç olarak, Microsoft bu özellik için destek sağlar. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Bir SAS dosyası nedir? 

PO dosyaları, belirli bir dile çevrilen dizelerin bulunduğu metin dosyaları olarak dağıtılır. PO dosyaları bunun yerine 
kullanmanın bazı avantajları ,resx dosyaları içerir: 

• PO dosyaları çoğullaştırma destekler; ,resx dosyaları çoğullaştırma desteklemez. 

• PO dosyaları gibi derlenmiş olmayan ,resx dosyaları. Bu nedenle, özel araçlar ve yapılandırma adımları gerekli 
değildir. 

• PO dosyaları da işbirliğine dayalı çevrimiçi düzenleme araçları ile çalışma. 

Örnek 

Çeviri için Fransızca kendi çoğul biriyle dahil olmak üzere, iki dizeyi içeren örnek bir SAS dosyası aşağıda 
verilmiştir: 

fr.po 

#: Services/EmailService.cs:29 

msgid "Enter a comma separated list of email addresses." 
msgstr "Entrez une liste d’emails separes par une virgüle." 

#: Views/Email.cshtml:112 
msgid "The email address is \"{0}\"." 
msgid_plural "The email addresses are \"{0}\"." 
msgstr[0] "L'adresse email est \"{0}\"." 
msgstr[l] "Les adresses email sont \"{0}\"" 


Bu örnek, aşağıdaki sözdizimini kullanır: 

• #: : Çevrilecek dize bağlamında belirten bir açıklama. Burada kullanıldığı bağlı olarak farklı bu aynı dize 
çevrilmesi. 

• msgid : Çevrilmemiş dize. 

• msgstr : Çevrilmiş dize. 

Çoğullaştırmayı desteği söz konusu olduğunda, daha fazla giriş tanımlanabilir. 

• msgid_piurai : Çevrilmemiş çoğul dize. 

• msgstr[ 0 ] : 0 çalışması için çevrilmiş dize. 

• msgstr[N] : Çevrilmiş dize için büyük/küçük harfe n 







SAS dosya belirtimi bulunabilir burada. 


ASP.NET core'da yapılandırma PO dosya desteği 

Bu örnek, bir Visual Studio 2017 proje şablonundan oluşturulan bir ASP.NET Core MVC uygulaması dayanır. 

Bu paketi 

Bir başvuru ekleyin 0rchardCore.1_ocaiization.core NuGet paketi. Üzerinde kullanılabilir MyGet aşağıdaki paket 
kaynağında: https://www.myget.Org/F/orchardcore-preview/api/v 3 /index.json 


.Csproj dosyayı şimdi aşağıdakine benzer bir satır içeren (sürüm numarası değişebilir): 


<PackageReference Include="OrchardCore.Localization.Core" Version="1.0.0-betal-3187" /> 

Hizmeti kaydediliyor 

Gerekli hizmetlere ekleme 

ConfigureServices 

yöntemi Startup.es: 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services. AddMvc() 

.AddViewLocalization(LanguageViewLocationExpanderFormat.Suffix); 

Services.AddPortableObjectLocalization(); 

Services.Configure<RequestLocalizationOptions>(options => 

{ 

var supportedCultures = new List<CultureInfo> 

{ 

new CultureInfo("en-US"), 
new CultureInfo("en"), 
new CultureInfo("fr-FR "), 
new CultureInfo("fr") 

}; 

options.DefaultRequestCulture = new RequestCulture("en-US"); 
options.SupportedCultures = supportedCultures; 
options.SupportedUICultures = supportedCultures; 

}); 

} 

Eklemek için gerekli olan bir ara yazılım configure yöntemi Startup.es : 

public void Configure(IApplicationBuilder app., IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 
app.UseBrowserLink(); 

} 

else 

{ 

app.UseExceptionHandler("/Home/Error"); 

} 

app.UseStaticFiles(); 
app.UseRequestLocalization(); 
app. UseMvcİAİithDef aultRoute(); 

} 








Razor görünümünü seçim için aşağıdaki kodu ekleyin. About.cshtml Bu örnekte kullanılır. 

@using Microsoft.AspNetCore.Mvc.Localization 
(Şinject IViewl_ocalizer Localizer 

<p>@Localizer["Hello world!"]</p> 

Bir ıviewLocaiizer örneği eklenen ve "Hello world!" metni çevirmek için kullanılır. 

Bir SAS dosyası oluşturma 

Adlı bir dosya oluşturun <kültür kodu > .po uygulama kök klasörünüzde. Bu örnekte, dosya adı olan fr.po Fransızca 
Dil kullanılır çünkü: 

msgid "Hello world!" 
msgstr "Bonjour le monde!" 


Bu dosya, dize çevirmek için hem Fransızca çevrilmiş dize depolar.Çevirileri üst kültürünü gerekirse geri dönün. Bu 
örnekte, fr.po istenen kültürü ise dosya kullanılan fr-FR veya fr-CA . 

Uygulamayı test etme 

Uygulamanızı çalıştırın ve URL'ye /Home/About . Metin Merhaba Dünya! görüntülenir. 

URL'ye /Home/About?cuiture=fr-FR . Metin Bonjour le monde! görüntülenir. 

Çoğullaştırmayı 

PO dosyaları, aynı dize dönüştürülür, farklı bir kardinalite üzerinde temel gerektiğinde faydalı olan çoğullaştırma 
forms destekler. Bu görevi, her bir dilin kardinalite üzerinde kullanmak için hangi dize tabanlı seçmek için özel 
kurallar tanımlar olarak karmaşık yapılır. 

Orchard yerelleştirme paket çoğul bu farklı biçimlerin otomatik olarak çağırmak için bir API sağlar. 

Çoğullaştırmayı PO dosyaları oluşturma 

Aşağıdaki içeriği daha önce bahsedilen ekleyin fr.po dosyası: 

msgid "There is one item." 
msgid_plural "There are {0} items." 
msgstr[0] "II y a un element." 
msgstr[l] "II y a {0} elements." 

Bkz: PO dosyası nedir? ne Bu örnekte her giriş temsil açıklaması. 

Farklı çoğullaştırma formları kullanarak bir dil ekleme 

Önceki örnekte kullanılan İngilizce ve Fransızca dizeler. İngilizce ve Fransızca yalnızca iki çoğullaştırma formları ve 
aynı form kuralları paylaşın olduğu bir kardinalite birinin ilk çoğul eşlendi. Diğer bir kardinalite ikinci çoğul eşlenir. 

Tüm diller, aynı kurallara paylaşın. Bu üç çoğul forma sahip Çekçe Dil ile gösterilmiştir. 


Oluşturma cs.po aşağıdaki gibi ve nasıl çoğullaştırma üç farklı çevirilere gereken dikkat edin: 












msgid "Hello world!" 
msgstr "Ahoj svete!!" 

msgid "There is one item." 
msgid_plural "There are {0} items." 
msgstr[0] "Existuje jedna polozka." 
msgstr[l] "Existuji {0} polozky." 
msgstr[2] "Existuje {0} polozek." 

Çekçe yerelleştirmeler kabul etmek için ekleme "cs" içinde desteklenen kültürler listesine configureServices 
yöntemi: 

var supportedCultures = new List<CultureInfo> 

{ 

new CultureInfo("en-US"), 
new CultureInfo("en"), 
new CultureInfo("fr-FR"), 
new CultureInfo("fr"), 
new CultureInfo("cs") 

}; 


Düzen Views/Home/About.cshtml yerelleştirilmiş, plural dizeler için birden fazla kardinaliteleri işlenecek dosya: 

<p>@Localizer.Plural(l, "There is one item.", "There are {0} items.")</p> 

<p>@Localizer.Plural(2, "There is one item.", "There are {0} items.")</p> 

<p>@Localizer.Plural(5, "There is one item.", "There are {0} items.")</p> 


Not: Gerçek hayattaki bir senaryoda, bir değişken sayısı temsil etmek için kullanılacak. Burada, aynı kodu belirli bir 
servis talebi göstermek için üç farklı değerlerle tekrarlayın. 

Kültürler geçiş sırasında aşağıdakilere bakın: 

için /Home/About : 

There is one item. 

There are 2 items. 

There are 5 items. 

için /Home/About?culture=fr : 

II y a un element. 

II y a 2 elements. 

II y a 5 elements. 

için /Home/About?culture=cs : 

Existuje jedna polozka. 

Existujı 2 polozky. 

Existuje 5 polozek. 

Çekçe kültürü için üç çevirileri farklı olduğunu unutmayın. Fransızca ve İngilizce kültürlerini aynı yapımı için son iki 
çevrilmiş dizeleri paylaşın. 


Gelişmiş görevler 









Contextualizing dizeleri 

Uygulamalar genellikle birçok yerde çevrilemeyen dizeleri içerir. Aynı dize farklı bir çeviri (Razor görünümleri ya da 
sınıf dosyaları) bir uygulama içinde belirli bir konumda olabilir. Bir SAS dosya temsil ettiği dizeyi sınıflandırmak için 
kullanılan bir dosya bağlamı kavramını destekler. Dosya bağlamını kullanarak, bir dize farklı dosya içeriği (veya 
dosya bağlam eksikliği) bağlı olarak çevrilebilir. 

SAS yerelleştirme Hizmetleri, tam sınıf veya bir dize çevirirken kullanılan görünüm adını kullanın. Bu değeri ayarı 
gerçekleştirilir msgctxt girişi. 

Önceki bir ikincil eklemeyi göz önünde bulundurun fr.po örnek. Razor görünümü konumundaki 
Views/Home/About.cshtml ayrılmış ayarlayarak dosya bağlamı olarak tanımlanabilir msgctxt girişin değeri: 

msgctxt "Views.Home.About" 
msgid "Hello world!" 
msgstr "Bonjour le monde!" 

ile msgctxt şekilde ayarlanırsa, metin çevirisi giderek oluşur /Home/About?cuiture=fr-FR . Çeviri için gezinirken 
gerçekleşmeyeceğini /Home/contact?cuiture=fr-FR . 


Özel giriş verilen dosya bağlamı ile eşleştiğinde, Orchard Core'nın geri dönüş mekanizması bir bağlam olmadan 
uygun bir SAS dosyasını arar, için tanımlı hiçbir belirli dosya bağlam olup olmadığı varsayılarak 
Views/Home/Contact.cshtml, gezinme için /Home/contact?cuiture=fr-FR bir SAS dosya gibi yükler: 


msgid "Hello world!" 
msgstr "Bonjour le monde!" 

PO dosyaları konumunu değiştirme 

PO dosyaları varsayılan konumunu değiştirilebilir 

ConfigureServices 


Services.AddPortableObjectLocalization(options 

=> options.ResourcesPath = "Localization"); 


Bu örnekte, gelen PO dosyaları yüklenir yerelleştirme klasör. 

Yerelleştirme dosyaları bulmak için özel bir mantıksal uygulama 

PO dosyaları bulmak için daha karmaşık mantık gerektiğinde 

OrchardCore. Localization. PortableObject. ILocalizationFileLocationProvider arabirimi uygulanabilir ve hizmet 
olarak kayıtlı. Bu, SAS dosyaları farklı konumlarda depolanabilir veya dosyaları bir klasör hiyerarşisi içinde 
bulunması gerektiğinde kullanışlıdır. 

Piuralized farklı varsayılan dilini kullanma 

Paketi içeren bir Plurai iki çoğul biçimi için özel bir genişletme yöntemi. Daha fazla çoğul forms gerektiren diller 
için bir genişletme yöntemi oluşturun. Bir uzantı yönteminiz, varsayılan dil için herhangi bir yerelleştirme dosyası 
sağlamanız gerekmez — özgün dizeleri zaten doğrudan kod içinde kullanılabilir. 

Daha fazla genel kullanabileceğiniz Piurai(int count, string[] pluraiForms., params object[] arguments) çevirileri 
dize dizisi kabul eden aşırı yükleme. 
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Bu makale: 

• Yerelleştirme API 'Lerinde genişletilebilirlik noktalarını listeler. 

• ASP.NET Core uygulama yerelleştirmesini genişletme hakkında yönergeler sağlar. 

Yerelleştirme API 'Lerinde Genişletilebilir noktaları 

ASP.NET Core yerelleştirme API 'Leri genişletilebilir olacak şekilde oluşturulmuştur.Genişletilebilirlik, 
geliştiricilerin gereksinimlerine göre yerelleştirmeyi özelleştirmesini sağlar. Örneğin, Orchardcore bir 
postringLocalizer sahiptir. postringLocalizer , Yerelleştirme kaynaklarını depolamak üzere po dosyalarını 
kullanmak için Taşınabilir nesne yerelleştirmesini kullanma hakkında ayrıntılı bilgi sağlar. 

Bu makalede, yerelleştirme API 'Lerinin sağladığı iki ana genişletilebilirlik noktası listelenmektedir: 

• RequestCultureProvider 

• IStringLocalizer 

Yerelleştirme kültür sağlayıcıları 

ASP.NET Core yerelleştirme API 'Leri, yürütülen bir isteğin geçerli kültürünü belirleyebilmesi için dört varsayılan 
sağlayıcıya sahiptir: 

• QueryStringRequestCultureProvider 

• CookieRequestCultureProvider 

• AcceptLanguageHeaderRequestCultureProvider 

• CustomRequestCultureProvider 

Önceki sağlayıcılar, Yerelleştirme ara yazılımı belgelerinde ayrıntılı olarak açıklanmıştır. Varsayılan sağlayıcılar 
gereksinimlerinizi karşılamıyorsa, aşağıdaki yaklaşımlardan birini kullanarak özel bir sağlayıcı oluşturun: 

CustomRequestCultureProvider kullanma 

CustomRequestCultureProvider, geçerli yerelleştirme kültürünü belirlemede basit bir temsilci kullanan özel bir 
RequestCultureProvider sağlar: 








options.RequestCultureProviders.Insert(0, new CustomRequestCultureProvider(async context => 

{ 

var currentCulture = "en"; 

var segments = context.Request.Path.Value.Split(new char[] { '/' }j 
StringSplitOptions.RemoveEmptyEntries); 

if (segments.Length > 1 && segments[0].Length == 2) 

{ 

currentCulture = segments[0]; 

} 

var requestCulture = new ProviderCultureResult(culture); 
return Task.FromResult(requestCulture); 

})); 


options.AddInitialRequestCultureProvider(new CustomRequestCultureProvider(async context => 

{ 

var currentCulture = "en"; 

var segments = context.Request.Path.Value.Split(new char[] { '/' }j 
StringSplitOptions.RemoveEmptyEntries); 

if (segments.Length > 1 && segments[0].Length == 2) 

{ 

currentCulture = segments[0]; 

} 

var requestCulture = new ProviderCultureResult(culture); 
return Task.FromResult(requestCulture); 

})); 


RequestCultureProvider 'in yeni bir ımplemei kullanın 

Özel bir kaynaktan gelen istek kültür bilgilerini belirleyen yeni bir RequestCultureProvider uygulanması 
oluşturulabilir. Örneğin, özel kaynak bir yapılandırma dosyası veya veritabanı olabilir. 

Aşağıdaki örnekte, appSettings. JSON' dan gelen istek kültür bilgilerini belirleyen RequestCultureProvider 
genişleten AppSettingsRequestcuitureProvider gösterilmektedir: 



public class AppSettingsRequestCultureProvider : RequestCultureProvider 

{ 

public string CultureKey { get; set; } = "culture"; 
public stning UICultureKey { get; set; } = "ui-culture"; 

public override Task<ProviderCultureResult> DetermineProviderCultureResult(HttpContext httpContext) 

{ 

if (httpContext == null) 

{ 

throw new ArgumentNullException(); 

} 

var configuration = httpContext.RequestServices.GetService<IConfigurationRoot>(); 
var culture = configuration[CultureKey]; 
var uiCulture = configuration[UICultureKey]; 

if (culture == null && uiCulture == null) 

{ 

return Task.FromResult((ProviderCultureResult)null); 

} 

if (culture != null && uiCulture == null) 

{ 

uiCulture = culture; 

} 

if (culture == null && uiCulture != null) 

{ 

culture = uiCulture; 

} 

var providerResultCulture = new ProviderCultureResult(culture, uiCulture); 
return Task.FromResult(providerResultCulture); 

} 

} 


Yerelleştirme kaynakları 

AS P.N ET Core yerelleştirme ResourceManagerStringLocalizersağlar. ResourceManagerStringLocalizer, 
Yerelleştirme kaynaklarını depolamak için resx kullanan bir IStringLocalizer uygulamasıdır. 

resx dosyaları kullanma sınırlı değilsiniz. ıstringLocalized uygulayarak, herhangi bir veri kaynağı kullanılabilir. 

Aşağıdaki örnek projeler IStringLocalizeruygular: 

• EFStringLocalizer 

• JsonStringLocalizer 

• SglLocalizer 
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Bu makalede AS P.N ET Core uygulaması yerelleştirme sorunlarını tanılamaya yönelik yönergeler sağlanmaktadır. 

Yerelleştirme yapılandırma sorunları 

Yerelleştirme ara yazılım sırası 

Yerelleştirme ara yazılımı beklenen şekilde sıralandığı için uygulama yerelleştirilemeyebilir. 

Bu sorunu çözmek için, yerelleştirme ara yazılımı 'nın MVC ara yazılım öncesinde kayıtlı olduğundan emin olun. 
Aksi takdirde, yerelleştirme ara yazılımı uygulanmaz. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddLocalization(options => options.ResourcesPath = "Resources"); 

Services.AddMvc(); 

} 

Yerelleştirme kaynakları yolu bulunamadı 

RequestCultureProvider içindeki desteklenen kültürler, kayıtlı bir kez ile eşleşmiyor 

Kaynak dosyası adlandırma sorunları 

ASP.NET Core, buradaayrıntılı olarak açıklanan yerelleştirme kaynakları dosya adlandırmasına yönelik önceden 
tanımlanmış kurallara ve yönergelere sahiptir. 

Eksik kaynaklar 

Kaynakların Bulunamamasının yaygın nedenleri şunlardır: 

• Kaynak adları resx dosyasında ya da yorumdur isteğinde yanlış yazılmıştır. 

• Kaynak bazı diller için resx eksik, ancak başkaları içinde var. 

• Sorun yaşamaya devam ediyorsanız, eksik kaynaklar hakkında daha fazla ayrıntı için yerelleştirme günlüğü 
iletilerini ( Debug günlük düzeyi) kontrol edin. 

İpucu: cookieRequestcuLtureProvider kullanırken, tek tekliflerin yerelleştirme tanımlama bilgisi değeri içindeki 
kültürler ile kullanılmadığını doğrulayın. Örneğin, c='en-UK' luic='en-us’ geçersiz bir tanımlama bilgisi değeridir, 
c-en-UK / uxc-en-us geçerli olur. 

Sınıf kitaplığı sorunlarını & kaynaklar 

Varsayılan olarak ASP.NET Core, sınıf kitaplıklarının kaynak dosyalarını Resourcelocationattributearacılığıyla 
bulmasını sağlamak için bir yol sağlar. 

Sınıf kitaplıklarıyla ilgili yaygın sorunlar şunlardır: 


• Bir Sinif kitaplığındaki ResourceLocationAttribute eksik olduğunda ResGurceManagerStringLocalizerFactory 











kaynaklan bulmasını engelleyecek. 

• Kaynak dosyası adlandırma. Daha fazla bilgi için bkz. kaynak dosyası adlandırma sorunları bölümü. 

• Sınıf kitaplığının kök ad alanı değiştiriliyor. Daha fazla bilgi için bkz. kök ad alanı sorunları bölümü. 

CustomRequestCultureProvider beklendiği gibi çalışmıyor 

RequestLocaüzationOptions sınıfı üç varsayılan sağlayıcıya sahiptir: 

1. QueryStringRequestCultureProvider 

2. CookieRequestCultureProvider 

3. AcceptLanguageHeaderRequestCulturePr'ovider' 

CustomRequestCultureProvider , yerelleştirme kültürünün uygulamanızda nasıl sağlandığını özelleştirmenize 
olanak sağlar. customRequestcuitureProvider , varsayılan sağlayıcılar gereksinimlerinizi karşılamadığında kullanılır. 

• Yaygın bir nedenden dolayı özel sağlayıcı, RequestcuitureProviders listesindeki ilk sağlayıcıdır. Bu sorunu 
çözmek için: 

• Özel sağlayıcıyı RequestcuitureProviders listesinde 0 konumuna aşağıdaki gibi ekleyin: 

options.RequestCultureProviders.Insert(0, new CustomRequestCultureProvider(async context => 

{ 

// My custom request culture logic 
return new ProviderCultureResult("en"); 

})); 

options.AddInitialRequestCultureProvider(new CustomRequestCultureProvider(async context => 

{ 

// My custom request culture logic 
return new ProviderCultureResult("en"); 

})); 

• Özel sağlayıcıyı ilk sağlayıcı olarak ayarlamak için AddinitiaiRequestcuitureProvider uzantısı yöntemini 
kullanın. 

Kök ad alanı sorunları 

Bir derlemenin kök ad alanı derleme adından farklıysa, yerelleştirme varsayılan olarak çalışmaz. Bu sorundan 
kaçınmak için, burada ayrıntılı olarak açıklanan RootNamespacekullanın 


VVARNING 

Bu durum, projenin adı geçerli bir .NET tanımlayıcısı olmadığında ortaya çıkabilir. Örneğin my-project-name.csproj , 
my project name kök ad alanını ve derleme adını bu hataya my-project-name kullanır. 


Kaynak & oluşturma eylemi 

Yerelleştirme için kaynak dosyaları kullanıyorsanız, uygun bir yapı eylemi olması önemlidir. Bunlar, gömülü 
kaynakolmaları gerekir, aksi takdirde ResourcestringLocalizer bu kaynakları bulamaz. 












ASPNET Core 'de model bağlama 
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Bu makalede, model bağlamanın ne olduğu, nasıl çalıştığı ve davranışını nasıl 
özelleştireceğiniz açıklanmaktadır. 

Örnek kodu görüntüleyin veya indirin (nasıl indirilir). 

Model bağlama nedir? 

Denetleyiciler ve Razor sayfaları, HTTP isteklerinden gelen verilerle çalışır. 
Örneğin, rota verileri bir kayıt anahtarı sağlayabilir ve postalanan form alanları, 
modelin özelliklerine ilişkin değerler sağlayabilir. Bu değerlerin her birini almak 
ve bunları dizelerden .NET türlerine dönüştürmek için kod yazma sıkıcı ve hata 
durumunda olabilir. Model bağlama bu işlemi otomatikleştirir. Model bağlama 
sistemi: 

• Veri yolu, form alanları ve sorgu dizeleri gibi çeşitli kaynaklardan veri alır. 

• Yöntem parametrelerinde ve genel özelliklerde bulunan denetleyicilere ve 
Razor sayfalarına verileri sağlar. 

• Dize verilerini .N ET türlerine dönüştürür. 

• Karmaşık türlerin özelliklerini güncelleştirir. 

Örnek 

Aşağıdaki eylem yöntemine sahip olduğunuzu varsayalım: 

[HttpGet("{id}")] 

public ActionResult<Pet> GetById(int id, bool dogsOnly) 

Ve uygulama şu URL ile bir istek alıyor: 

http://contoso.com/api/pets/2 ?DogsOnly=true 

Model bağlama, yönlendirme sistemi eylem yöntemini seçtikten sonra aşağıdaki 
adımlardan geçer: 

• id adlı bir tamsayı olan GetByiD ilk parametresini bulur. 

• HTTP isteğindeki kullanılabilir kaynakları arar ve yönlendirme verilerinde id 
= "2" bulur. 

• "2" dizesini tamsayı 2 1 ye dönüştürür. 

• dogsOnly adlı bir Boole değeri olan GetByiD sonraki parametresini bulur. 

• Kaynakları arar ve sorgu dizesinde "DogsOnly = true" bulur.Ad eşleştirme, 
büyük/küçük harfe duyarlı değildir. 


• "True" dizesini Boole 

true 

dönüştürür. 

Daha sonra Framevvork, 

id 

parametresi için 2 ' ye geçerek ve dogsOnly 


parametresi için true GetByid yöntemini çağırır. 













Önceki örnekte, model bağlama hedefleri basit türler olan yöntem 
parametreleridir. Hedefler, karmaşık bir türün özellikleri de olabilir. Her bir özellik 
başarıyla bağlandıktan sonra, bu özellik için model doğrulaması oluşur. Hangi 
verilerin modele bağladığına ve tüm bağlama veya doğrulama hatalarıyla ilgili 
kayıt, ControllerBase. ModelState veya Pagemodel. ModelStateiçinde depolanır. 
Bu işlemin başarılı olup olmadığını öğrenmek için uygulama ModelState. IsValid 
bayrağını denetler. 

Hedefler 

Model bağlama, aşağıdaki tür hedeflerin değerlerini bulmayı dener: 

• Bir isteğin yönlendirildiği denetleyici eylemi yönteminin parametreleri. 

• Bir isteğin yönlendirildiği Razor Pages işleyicisi yönteminin parametreleri. 

• Bir denetleyicinin veya PageModei sınıfının öznitelikler tarafından belirtilmişse 
ortak özellikleri. 

[BindProperty] özniteliği 

Bir denetleyicinin veya PageModei sınıfın ortak özelliğine, model bağlamasının 
bu özelliği hedeflemesini sağlamak için uygulanabilir: 

public class EditModel : InstructorsPageModel 
{ 

[BindProperty] 

public Instructor Instructor { get; set; } 

[BindProperties] özniteliği 

AS P.N ET Core 2,1 ve üzeri sürümlerde kullanılabilir. Model bağlamaya, sınıfın 
tüm ortak özelliklerini hedeflemesini bildirmek için bir denetleyiciye veya 
PageModei sınıfa uygulanabilir: 

[BindProperties(SupportsGet = true)] 

public class CreateModel : InstructorsPageModel 

{ 

public Instructor Instructor { get; set; } 

HTTP GET istekleri için model bağlama 

Varsayılan olarak, Özellikler HTTP GET istekleri için bağlantılı değildir.Genellikle, 
bir GET isteği için tüm ihtiyacınız olan bir kayıt KİMLİĞİ parametresidir. Kayıt 
KİMLİĞİ, veritabanındaki öğeyi aramak için kullanılır. Bu nedenle, modelin bir 
örneğini tutan bir özelliği bağlamaya gerek yoktur. GET isteklerinden alınan 
özelliklerin verilerine bağlanmasını istediğiniz senaryolarda supportsGet 
özelliğini true olarak ayarlayın: 

[BindProperty(Name = "ai_user", SupportsGet = true)] 
public string ApplicationlnsightsCookie { get; set; } 


Kaynaklar 

Varsayılan olarak, model bağlama, bir HTTP isteğindeki aşağıdaki kaynaklardan 
gelen anahtar-değer çiftleri biçimindeki verileri alır: 







1. Form alanları 

2. İstek gövdesi ( [ApiController] özniteliğine sahip denetleyicileriçin.) 

3. Veri yönlendirme 

4. Sorgu dizesi parametreleri 

5. Karşıya yüklenen dosyalar 

Her hedef parametresi veya özelliği için kaynaklar, önceki listede belirtilen sırada 
taranır. Birkaç özel durum vardır: 

• Rota verileri ve sorgu dizesi değerleri yalnızca basit türler için kullanılır. 

• Karşıya yüklenen dosyalar yalnızca iFormFile veya iEnumerabie<iFormFiie> 
uygulayan hedef türlere bağlanır. 

Varsayılan kaynak doğru değilse, kaynağı belirtmek için aşağıdaki özniteliklerden 
birini kullanın: 

• [FromQuery] -sorgu dizesinden değerleri alır. 

• [FromRoute] -rota verilerinden değerleri alır. 

• [FromForm] -postalanan Form alanlarındaki değerleri alır. 

• [FromBody] -istek gövdesinden değerleri alır. 

• [FromHeader] -http başlıklarındaki değerleri alır. 

Bu öznitelikler: 

• Model özelliklerine tek tek eklenir (model sınıfına değil), aşağıdaki örnekte 
olduğu gibi: 

public class Instructor 
{ 

public int ID { get; set; } 

[FromQuery(Name = "Note")] 

public string NoteFromÇueryString { get; set; } 

• isteğe bağlı olarak oluşturucuda bir model adı değeri kabul edin. Bu 
seçenek, özellik adının istekteki değerle eşleşmemesi durumunda sağlanır. 
Örneğin, istekteki değer aşağıdaki örnekte olduğu gibi adında bir tire olan 
bir üstbilgi olabilir: 

public void OnGet([FromHeader(Name = "Accept-Language")] string 
language) 

[FromBody] özniteliği 

Bir HTTP isteğinin gövdesinden özelliklerini doldurmak için [FromBody] 
özniteliğini bir parametreye uygulayın. ASP.NET Core çalışma zamanı, gövdeyi 
bir giriş biçimlendirici 'y a okumaktan sorumlu olarak temsil eder. Giriş biçimleri 

Bu makalenin ilerleyen kısımlarındaaçıklanmıştır. 

Karmaşık bir tür parametresine [FromBody] uygulandığında, özelliklerine 
uygulanan herhangi bir bağlama kaynak özniteliği yok sayılır. Örneğin, aşağıdaki 
create eylemi pet parametresinin gövdeden doldurulduğunu belirtir: 

public ActionResult<Pet> Create([FromBody] Pet pet) 









Pet sınıfı, Breed özelliğinin bir sorgu dizesi parametresinden doldurulduğunu 
belirtir: 

public class Pet 
{ 

public stning Name { get; set; } 

[FromQuery] // Attribute is ignored. 
public string Breed { get; set; } 

} 

Yukarıdaki örnekte: 

• [FromQuery] özniteliği yok sayılır. 

• Breed özelliği bir sorgu dizesi parametresinden doldurulmamış. 

Giriş biçimleri yalnızca gövdeyi okur ve bağlama kaynak özniteliklerini 
anlamayın. Gövdede uygun bir değer bulunursa, bu değer Breed özelliğini 
doldurmak için kullanılır. 

Eylem yöntemi başına birden fazla parametreye [FromBody] uygulamayın, istek 
akışı bir giriş biçimlendirici tarafından okunduktan sonra, diğer [FromBody] 
parametrelerini bağlamak için artık bir daha okunamaz. 

Ek kaynaklar 

Kaynak verileri, model bağlama sistemine değer sağlayıcılara göre sağlanır. Diğer 
kaynaklardan model bağlamaya yönelik verileri alan özel değer sağlayıcıları 
yazabilir ve kaydedebilirsiniz. Örneğin, tanımlama bilgileri veya oturum durumu 
verilerini isteyebilirsiniz. Yeni bir kaynaktan veri almak için: 

• ivalueProvider uygulayan bir sınıf oluşturun. 

• ivalueProviderFactory uygulayan bir sınıf oluşturun. 

• Factory sınıfını Startup.ConfigureServices kaydedin. 

Örnek uygulama, tanımlama bilgilerinden değerler alan bir değer sağlayıcısı ve 
Factory örneği içerir. Startup.ConfigureServices kayıt kodu aşağıda verilmiştir: 

Services. AddMvc (options => 

{ 

options.ValueProviderFactories.Add(new CookieValueProviderFactoryO); 
options.ModelMetadataDetailsProviders.Add( 

new ExcludeBindingMetadataProvider(typeof(System.Version))); 
options.ModelMetadataDetailsProviders.Add( 

new SuppressChildValidationMetadataProvider(typeof(System.Guid))); 

}) 

.AddXmlSerializerFormatters() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

Gösterilen kod, tüm yerleşik değer sağlayıcılarından sonra özel değer 



Model özelliği için kaynak yok 

Varsayılan olarak, model özelliği için bir değer bulunmazsa model durumu hatası 
oluşturulmaz. Özelliği null veya varsayılan bir değer olarak ayarlanır: 













• Null yapılabilir basit türler nuiı olarak ayarlanır. 

• Null yapılamayan değer türleri defauit(T) olarak ayarlanır. Örneğin, int id 
parametresi 0 olarak ayarlanır. 

• Karmaşık türler için model bağlama, özellikleri ayarlamadan varsayılan 
oluşturucuyu kullanarak bir örnek oluşturur. 

• Diziler, byte[] dizilerinin null olarak ayarlandığı durumlar dışında 
Array.Empty<T>() olarak ayarlanır. 

Model özelliği için form alanlarında hiçbir şey bulunamadığında model 
durumunun geçersiz kılınmalıdır, [BindRequired] özniteliğini kullanın. 

Bu [BindRequired] davranışının, bir istek gövdesinde JSON veya XML verilerine 
değil, postalanan form verilerinden model bağlama için geçerli olduğunu 
unutmayın. İstek gövdesi verileri, giriş formatlayıcılarıtarafından işlenir. 

Tür dönüştürme hataları 

Bir kaynak bulunursa ancak hedef türe dönüştürülemiyorsa, model durumu 
geçersiz olarak işaretlenir. Hedef parametresi veya özelliği, önceki bölümde 
belirtildiği gibi null veya varsayılan değer olarak ayarlanır. 

[ApiControiler] özniteliğine sahip bir API denetleyicisinde, geçersiz model 
durumu otomatik HTTP 400 yanıtına neden olur. 

Razor sayfasında, sayfayı bir hata iletisiyle yeniden görüntüleyin: 

public IActionResult OnPost() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_instructorsInMemoryStore.Add(Instructor); 
return RedirectToPage("./Index")j 

} 

istemci tarafı doğrulama, aksi durumda Razor Pages bir forma gönderilemeyen 
hatalı verileri yakalar. Bu doğrulama, önceki vurgulanmış kodu tetiklemeyi 
zorlaştırır. Örnek uygulama, teslim tarihi alanına hatalı veri yerleştiren ve formu 
Gönderen Geçersiz tarih içeren bir Gönder düğmesi içerir. Bu düğme, veri 
dönüştürme hataları oluştuğunda sayfanın yeniden görüntülenmesine yönelik 
kodun nasıl çalıştığını gösterir. 

Sayfa önceki kodla yeniden görüntülendiğinde, form alanında geçersiz giriş 
gösterilmez. Bunun nedeni model özelliğinin null ya da varsayılan bir değer 
olarak ayarlanmış olmasından kaynaklanır. Geçersiz giriş bir hata iletisinde 
görüntülenir. Ancak form alanındaki hatalı verileri yeniden görüntülemek 
istiyorsanız, model özelliğini bir dize haline getirmeyi ve veri dönüştürmeyi el ile 
gerçekleştirmeyi düşünün. 

Tür dönüştürme hatalarının model durumu hatalarına neden olmasını 
istemiyorsanız aynı strateji önerilir. Bu durumda model özelliğini bir dize yapın. 


Basit türler 














Model cildin kaynak dizeleri dönüştürebileceğiniz basit türler aşağıdakileri içerir: 

• Boole değeri 

• Byte, S Byte 

• Char 

• Hem 

• Türünde 

• Kategori 

• Çift 

• Yardımının 

• 'ini 

• Int16, Int32, Int64 

• Sunuculu 

• TimeSpan 

• UIntl6, Ulnt32, Ulnt64 

• Uri 

• Sürüm 

Karmaşık türler 

Karmaşık bir türün bağlanması için ortak bir varsayılan Oluşturucusu ve ortak 
yazılabilir özellikleri olmalıdır. Model bağlama gerçekleştiğinde, sınıf ortak 
varsayılan Oluşturucu kullanılarak oluşturulur. 

Karmaşık türün her özelliği için model bağlama, ad modeli ön eki için kaynakları 
arar. property_name. Hiçbir şey bulunamazsa, ön ek olmadan yalnızca 
property_name arar. 

Bir parametreye bağlama için, önek parametre adıdır. PageModei public özelliğine 
bağlama için, önek ortak özellik adıdır. Bazı özniteliklerin, parametre veya özellik 
adının varsayılan kullanımını geçersiz kılabilmenizi sağlayan Prefix bir özelliği 
vardır. 

Örneğin, karmaşık türün aşağıdaki instructor sınıfı olduğunu varsayalım: 

public class instructor 
{ 

public int ID { get; set; } 

public string LastName { get; set; } 

public string FirstName { get; set; } 

} 

Önek = parametre adı 

Bağlanacak model instructorToUpdate adlı bir parametredir: 

public IActionResult OnPost(int? id, instructor İnstructorToUpdate) 

Model bağlama, anahtar instructorToUpdate .id kaynaklara bakarak başlar. Bu 
bulunamazsa, öneki olmayan id arar. 

Önek = Özellik adı 

Bağlanacak model, denetleyicinin veya PageModei sınıfının instructor adlı bir 











özelliktir: 


[BindProperty] 

public Instructor Instructor { get; set; } 

Model bağlama, anahtar ınstructor .id kaynaklara bakarak başlar. Bu 
bulunamazsa, öneki olmayan id arar. 

Özel ön ek 

Bağlanacak model instructorToUpdate adlı bir parametredir ve Bind özniteliği 
önek olarak ınstructor belirtir: 

public IActionResult OnPost( 

int? id, [Bind(Prefix = "Instructor")] Instructor İnstructorToUpdate) 

Model bağlama, anahtar ınstructor .id kaynaklara bakarak başlar. Bu 
bulunamazsa, öneki olmayan id arar. 

Karmaşık tür hedefleri için öznitelikler 

Karmaşık türlerin model bağlamasını denetlemek için birkaç yerleşik öznitelik 
mevcuttur: 

• [BindRequired] 

• [BindNever] 

• [Bind] 


NOTE 

Bu öznitelikler, gönderilen form verileri değer kaynağı olduğunda model bağlamayı 
etkiler. Bunlar, gönderilen JSON ve XML istek gövdelerini işleyen giriş formatlayıcıları ’nı 
etkilemez. Giriş biçimleri Bu makalenin ilerleyen kısımlarındaaçıklanmıştır. 

Ayrıca bkz. model doğrulamasında [Required] özniteliği tartışması. 


[BindRequired] özniteliği 

, Yöntem parametrelerine değil yalnızca model özelliklerine uygulanabilir. 
Modelin özelliği için bağlama gerçekleşmemişse model bağlamasının model 
durumu hatası eklemesine neden olur. Örnek buradadır: 


public class InstructorİAİithCollection 

{ 

public int ID { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatlnEditMode 
= true)] 

[Display(Name = "Hine Date")] 

[BindRequired] 

public DateTime HireDate { get; set; } 


[Bindhiç] özniteliği 

, Yöntem parametrelerine değil yalnızca model özelliklerine uygulanabilir. Model 
bağlamasının model özelliğini değiştirmesini engeller. Örnek buradadır: 













public class InstructorİAİithOictionary 
{ 

[BindNever] 

public int ID { get; set; } 

[Bind] özniteliği 

, Bir sınıfa veya yöntem parametresine uygulanabilir.Model bağlamasındaki bir 
modelin hangi özelliklerinin dahil edileceğini belirtir. 


Aşağıdaki örnekte, herhangi bir işleyici veya eylem yöntemi çağrıldığında 
yalnızca instructor modelin belirtilen özellikleri bağlanır: 


[Bind("LastName, FirstMidl\lame,HireDate") ] 
public class instructor 

Aşağıdaki örnekte, onPost yöntemi çağrıldığında yalnızca 
belirtilen özellikleri bağlanır: 

instructor 

modelin 


[HttpPost] 

public IActionResult OnPost([Bind("LastName, FirstMidName,HireDate") ] 
instructor instructor) 


[Bind] özniteliği, oluşturma senaryolarında fazla nakline karşı korumak için 
kullanılabilir. Dışlanan Özellikler null ya da boş değer olarak ayarlandığı için, 
düzenleme senaryolarında iyi çalışmaz. Fazla nakline karşı savunma için, [Bind] 
özniteliği yerine, görüntüleme modelleri önerilir. Daha fazla bilgi için bkz. fazla 

nakil hakkında güvenlik NOI. 

Koleksiyonlar 

Basit türlerin koleksiyonları olan hedefler için model bağlama, parameter_name 
veya property_name ile eşleşmeleri arar. Eşleşme bulunmazsa, ön ek olmadan 
desteklenen biçimlerden birini arar. Örneğin: 

• Bağlanacak parametrenin selectedCourses adlı bir dizi olduğunu 
varsayalım: 

public IActionResult OnPost(int? id, int[] selectedCourses) 

• Form veya sorgu dizesi verileri aşağıdaki biçimlerden birinde olabilir: 

selectedCourses=1050&selectedCourses=2000 

selectedCourses[0]=1050&selectedCourses[l]=2000 

[0]=1050&[1]=2000 

selectedCourses[a]=1050&selectedCourses[b]=2000&selectedCourses.index= 
a&selectedCourses.index=b 









[a]=1050&[b]=2000&index=a&index=b 

• Aşağıdaki biçim yalnızca form verilerinde desteklenir: 

selectedCourses[]=1050&selectedCourses[]=2000 

• Önceki örnek biçimlerinin hepsi için model bağlama iki öğe dizisini 

selectedCourses parametresine geçirir: 

o Selectedkurslar [0] = 1050 
o Selectedkurslar [1] = 2000 

Alt simge numaralarını kullanan veri biçimleri (... [0]... [1 ]...) sıfırdan 
başlayarak sıralı olarak numaralandırıldıklarından emin olmalıdır. Alt 
simge numaralandırmasında boşluk varsa, boşluklardan sonraki tüm 
öğeler yoksayılır. Örneğin, alt simgeler 0 ve 1 yerine 0 ve 2 ise ikinci öğe 
yok sayılır. 

Sözlükler 

Dictionary hedefler için, model bağlama parameter_name veya 
properfy_nameeşleşmelerini arar. Eşleşme bulunmazsa, ön ek olmadan 
desteklenen biçimlerden birini arar. Örneğin: 

• Hedef parametrenin selectedCourses adil bir Dictionary<intj string> 
olduğunu varsayalım: 

public IActionResult OnPost(int? id, Dictionary<intj string> 
selectedCourses) 

• Postalanan form veya sorgu dizesi verileri aşağıdaki örneklerden birine 
benzeyebilir: 

selectedCourses[1050]=Chemistry&selectedCourses[2000]=Economics 

[1050]=Chemistry&selectedCourses[2000]=Economics 

selectedCourses[0].Key=1050&selectedCourses[0].Value=Chemistry& 
selectedCourses[1].Key=2000&selectedCourses[l].Value=Economics 

[0].Key=1050&[0].Value=Chemistry&[l].Key=2000&[l].Value=Economics 

• Önceki örnek biçimlerinin hepsi için model bağlama iki öğenin sözlüğünü 

selectedCourses parametresine geçirir: 

o Selectedkurslar ["1050"] = "Chemistry" 
o Selectedkurslar ["2000"] = "Ekonomiks" 


Model bağlama yolu verileri ve sorgu dizeleri için 










Genelleştirme davranışı 

AS P.N ET Core yol değeri sağlayıcısı ve sorgu dizesi değer sağlayıcısı: 

• Değerleri sabit kültür olarak değerlendirin. 

• URL 'Lerin kültür sabiti olmasını bekler. 

Buna karşılık, form verilerinden gelen değerler kültüre duyarlı bir dönüştürmeye 
gider. Bu, URL 'Lerin yerel ayarlarda paylaşılabilir olması için tasarımdır. 

AS P.N ET Core yol değeri sağlayıcısını ve sorgu dizesi değeri sağlayıcısını, kültüre 
duyarlı bir dönüşüme dönüştürmek için: 

• IValueProviderFactory 'den devralma 

• QueryStringValueProviderFactory veya RouteValueValueProviderFactory 
adresinden kodu kopyalayın 

• Değer sağlayıcısı oluşturucusuna geçirilen kültür değerini Culturelnfo. 
CurrentCulture ile değiştirin 

• MVC seçeneklerinde varsayılan değer sağlayıcı fabrikasını yeni bir değerle 
değiştirin: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddControllersWithViews(options => 

{ 

var index = options.ValueProviderFactories.IndexOf( 

options.ValueProviderFactories.OfType<QueryStringValueProviderFactory> 
().Single()); 

options.ValueProviderFactories[index] = new 
CulturedQueryStringValueProviderFactory(); 

}); 

} 


public class CulturedQueryStringValueProviderFactory : IValueProviderFactory 
{ 

public Task CreateValueProviderAsync(ValueProviderFactoryContext context) 
{ 

if (context == null) 

{ 

throw new ArgumentNullException(nameof(context)); 

} 

var query = context.ActionContext.HttpContext.Request.Query; 
if (query != null && query.Count > 0) 

{ 

var valueProvider = new QueryStringValueProvider( 
BindingSource.Çuery, 
query, 

Culturelnfo.CurrentCulture); 
context.ValueProviders.Add(valueProvider); 

} 

return Task.CompletedTaskj 

} 

} 


Özel veri türleri 






Model bağlamanın işleyebileceği bazı özel veri türleri vardır. 

Iformfile ve ıformfilecollection 

HTTP isteğine eklenen karşıya yüklenen dosya. Ayrıca, birden çok dosya için 
IEnumerable<IFormFile> desteklenir. 


CancellationToken 

Zaman uyumsuz denetleyicilerde etkinliği iptal etmek için kullanılır. 

Form koleksiyonu 

Postalanan form verilerinden tüm değerleri almak için kullanılır. 

Giriş biçimleri 

istek gövdesindeki veriler JSON, XML veya başka bir biçimde olabilir.Model 
bağlama, bu verileri ayrıştırmak için belirli bir içerik türünü işlemek üzere 
yapılandırılmış bir giriş biçimlendirmişi kullanır. Varsayılan olarak, ASP.NET Core 
JSON verilerini işlemek için JSON tabanlı giriş formatlayıcıları içerir. Diğer içerik 
türleri için başka biçim ekleyebilirsiniz. 

ASP.NET Core, tüketen özniteliğine bağlı olarak giriş formatlayıcıları seçer. Hiçbir 
öznitelik yoksa, Content-Type üst bilgisinikullanır. 

Yerleşik XML girişi formatlayıcıları ’nı kullanmak için: 

• Microsoft. AspNetCore.Mvc.Formatters.Xml NuGet paketini yükler. 

• startup.configureServices AddXmlSerializerFormatters veya 
AddXmlDataContractSerializerFormattersçağırın. 

Services.AddMvc(options => 

{ 

options.ValueProviderFactories.Add(new 
CookieValueProviderFactoryO); 

options.ModelMetadataDetailsProviders.Add( 

new ExcludeBindingMetadataProvider(typeof(System.Version))); 
options.ModelMetadataDetailsProviders.Add( 
new 

SuppressChildValidationMetadataProvider(typeof(System.Guid))); 

}) 

.AddXmlSerializerFormatters() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

• Consumes özniteliğini, istek gövdesinde XM L beklemeniz gereken 
denetleyici sınıflarına veya eylem yöntemlerine uygulayın. 

[HttpPost] 

[Consumes("application/xml")] 

public ActionResult<Pet> Create(Pet pet) 


Daha fazla bilgi için bkz. XML serileştirme tanıtımı. 

Belirtilen türleri model bağlamalarından Dışla 

Model bağlama ve doğrulama sistemlerinin davranışı ModelMetadatatarafından 
yönlendiriliyor. Mvcoptions. Modelmetadatadetails sağlayıcı larınabi r ayrıntı 
sağlayıcısı ekleyerek ModeiMetadata özelleştirebilirsiniz. Yerleşik Ayrıntılar 








sağlayıcıları, belirtilen türler için model bağlamayı veya doğrulamayı devre dışı 
bırakmak üzere kullanılabilir. 

Belirtilen türdeki tüm modellerdeki model bağlamayı devre dışı bırakmak için 
Startup.configureServices bir ExcludeBindingMetadataProvider ekleyin. 
Örneğin, System.version türündeki tüm modeller üzerinde model bağlamayı 
devre dışı bırakmak için: 

Services. AddMvc (options => 

{ 

options.ValueProviderFactories.Add(new CookieValueProviderFactoryO); 
options.ModelMetadataDetailsProviders.Add( 

new ExcludeBindingMetadataProvider(typeof(System.Version))); 
options.ModelMetadataDetailsProviders.Add( 

new SuppressChildValidationMetadataProvider(typeof(System.Guid))); 

}) 

.AddXmlSerializerFormatters() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


Belirtilen türdeki özelliklerde doğrulamayı devre dışı bırakmak için 
Startup.configureServices SuppressChildValidationMetadataProvider ekleyin. 
Örneğin, System.Guid türündeki özelliklerde doğrulamayı devre dışı bırakmak 
için: 

Services. AddMvc (options => 

{ 

options.ValueProviderFactories.Add(new CookieValueProviderFactoryO )> 
options.ModelMetadataDetailsProviders.Add( 

new ExcludeBindingMetadataProvider(typeof(System.Version))); 
options.ModelMetadataDetailsProviders.Add( 

new SuppressChildValidationMetadataProvider(typeof(System.Guid))); 

}) 

.AddXmlSerializerFormatters() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


Özel model ciltleri 

Özel bir model cildi yazarak ve belirli bir hedef için seçmek üzere [ModelBinder] 
özniteliğini kullanarak model bağlamayı genişletebilirsiniz. Özel model 
bağlamahakkında daha fazla bilgi edinin. 

El ile model bağlama 

Model bağlama, TryllpdateModelAsync yöntemi kullanılarak el ile çağrılabilir. 
Yöntemi hem controiierBase hem de PageModei sınıflarında tanımlanmıştır. 
Yöntem aşırı yüklemeleri, kullanılacak öneki ve değer sağlayıcısını belirtmenizi 
sağlar. Model bağlama başarısız olursa Yöntem faise döndürür. Örnek 
buradadır: 










if (await TnyUpdateModelAsync<InstructonWithCollection>( 
newInstructor, 

"Instructor ", 

i => i.FirstMidName, i => i.LastName, i => i.HireDate)) 

{ 

_instructorsInMemoryStore.Add(newInstructor); 
return RedinectToPage("./Index"); 

} 

PopulateAssignedCourseData(newInstructor); 
return Page(); 


[FromServices] özniteliği 

Bu özniteliğin adı, bir veri kaynağı belirten model bağlama özniteliklerinin 
düzeniyle uyar. Ancak bir değer sağlayıcısından veri bağlama hakkında bilgi 
yoktur. Bağımlılık ekleme kapsayıcısından bir türün bir örneğini alır. Amacı, 
yalnızca belirli bir yöntem çağrılırsa bir hizmete ihtiyacınız olduğunda Oluşturucu 
ekleme için bir alternatif sağlamaktır. 

Ek kaynaklar 

• ASP.NET Core MVC 'de model doğrulaması 

• ASP.NET Core özel model bağlama 

Bu makalede, model bağlamanın ne olduğu, nasıl çalıştığı ve davranışını nasıl 
özelleştireceğiniz açıklanmaktadır. 

Örnek kodu görüntüleyin veya indirin (nasıl indirilir). 

Model bağlama nedir? 

Denetleyiciler ve Razor sayfaları, HTTP isteklerinden gelen verilerle çalışır. 
Örneğin, rota verileri bir kayıt anahtarı sağlayabilir ve postalanan form alanları, 
modelin özelliklerine ilişkin değerler sağlayabilir. Bu değerlerin her birini almak 
ve bunları dizelerden .NET türlerine dönüştürmek için kod yazma sıkıcı ve hata 
durumunda olabilir. Model bağlama bu işlemi otomatikleştirir. Model bağlama 
sistemi: 

• Veri yolu, form alanları ve sorgu dizeleri gibi çeşitli kaynaklardan veri alır. 

• Yöntem parametrelerinde ve genel özelliklerde bulunan denetleyicilere ve 
Razor sayfalarına verileri sağlar. 

• Dize verilerini .N ET türlerine dönüştürür. 

• Karmaşık türlerin özelliklerini güncelleştirir. 

Örnek 

Aşağıdaki eylem yöntemine sahip olduğunuzu varsayalım: 

[HttpGet("{id}")] 

public ActionResult<Pet> GetById(int id, bool dogsOnly) 


Ve uygulama şu URL ile bir istek alıyor: 





http://contoso.com/api/pets/2 ?DogsOnly=true 

Model bağlama, yönlendirme sistemi eylem yöntemini seçtikten sonra aşağıdaki 
adımlardan geçer: 

• id adlı bir tamsayı olan GetByiD ilk parametresini bulur. 

• HTTP isteğindeki kullanılabilir kaynakları arar ve yönlendirme verilerinde id 
= "2" bulur. 

• "2" dizesini tamsayı 2 1 ye dönüştürür. 

• dogsOniy adlı bir Boole değeri olan GetByiD sonraki parametresini bulur. 

• Kaynakları arar ve sorgu dizesinde "DogsOniy = true" bulur.Ad eşleştirme, 
büyük/küçük harfe duyarlı değildir. 

• "True" dizesini Boole true dönüştürür. 

Daha sonra Framevvork, id parametresi için 2 ' ye geçerek ve dogsOniy 
parametresi için true GetByid yöntemini çağırır. 

Önceki örnekte, model bağlama hedefleri basit türler olan yöntem 
parametreleridir. Hedefler, karmaşık bir türün özellikleri de olabilir. Her bir özellik 
başarıyla bağlandıktan sonra, bu özellik için model doğrulaması oluşur. Hangi 
verilerin modele bağladığına ve tüm bağlama veya doğrulama hatalarıyla ilgili 
kayıt, ControllerBase. ModelState veya Pagemodel. ModelStateiçinde depolanır. 
Bu işlemin başarılı olup olmadığını öğrenmek için uygulama ModelState. IsValid 
bayrağını denetler. 

Hedefler 

Model bağlama, aşağıdaki tür hedeflerin değerlerini bulmayı dener: 

• Bir isteğin yönlendirildiği denetleyici eylemi yönteminin parametreleri. 

• Bir isteğin yönlendirildiği Razor Pages işleyicisi yönteminin parametreleri. 

• Bir denetleyicinin veya PageModei sınıfının öznitelikler tarafından belirtilmişse 
ortak özellikleri. 

[BindProperty] özniteliği 

Bir denetleyicinin veya PageModei sınıfın ortak özelliğine, model bağlamasının 
bu özelliği hedeflemesini sağlamak için uygulanabilir: 

public class EditModel : InstructorsPageModel 
{ 

[BindProperty] 

public Instructor Instructor { get; set; } 

[BindProperties] özniteliği 

ASP.NET Core 2,1 ve üzeri sürümlerde kullanılabilir.Model bağlamaya, sınıfın 
tüm ortak özelliklerini hedeflemesini bildirmek için bir denetleyiciye veya 
PageModei sınıfa uygulanabilir: 

[BindProperties(SupportsGet = true)] 

public class CreateModel : InstructorsPageModel 

{ 

public Instructor Instructor { get; set; } 












HTTP GET istekleri için model bağlama 

Varsayılan olarak, Özellikler HTTP GET istekleri için bağlantılı değildir.Genellikle, 
bir GET isteği için tüm ihtiyacınız olan bir kayıt KİMLİĞİ parametresidir. Kayıt 
KİMLİĞİ, veritabanındaki öğeyi aramak için kullanılır. Bu nedenle, modelin bir 
örneğini tutan bir özelliği bağlamaya gerek yoktur. GET isteklerinden alınan 
özelliklerin verilerine bağlanmasını istediğiniz senaryolarda SupportsGet 
özelliğini true olarak ayarlayın: 

[BindProperty(Name = "ai_user", SupportsGet = true)] 
public string ApplicationlnsightsCookie { get; set; } 


Kaynaklar 

Varsayılan olarak, model bağlama, bir HTTP isteğindeki aşağıdaki kaynaklardan 
gelen anahtar-değer çiftleri biçimindeki verileri alır: 

1. Form alanları 

2. İstek gövdesi ( [ApiController] özniteliğine sahip denetleyicileriçin.) 

3. Veri yönlendirme 

4. Sorgu dizesi parametreleri 

5. Karşıya yüklenen dosyalar 

Her hedef parametresi veya özelliği için kaynaklar, önceki listede belirtilen sırada 
taranır. Birkaç özel durum vardır: 

• Rota verileri ve sorgu dizesi değerleri yalnızca basit türler için kullanılır. 

• Karşıya yüklenen dosyalar yalnızca iFormFile veya iEnumerabie<iFormFiie> 
uygulayan hedef türlere bağlanır. 

Varsayılan kaynak doğru değilse, kaynağı belirtmek için aşağıdaki özniteliklerden 
birini kullanın: 

• [FromQuery] -sorgu dizesinden değerleri alır. 

• [FromRoute] -rota verilerinden değerleri alır. 

• [FromForm] -postalanan Form alanlarındaki değerleri alır. 

• [FromBody] -istek gövdesinden değerleri alır. 

• [FromHeader] -http başlıklarındaki değerleri alır. 

Bu öznitelikler: 

• Model özelliklerine tek tek eklenir (model sınıfına değil), aşağıdaki örnekte 
olduğu gibi: 

public class Instructor 
{ 

public int ID { get; set; } 

[FromQuery(Name = "Note")] 

public string NoteFromQueryString { get; set; } 

• isteğe bağlı olarak oluşturucuda bir model adı değeri kabul edin. Bu 
seçenek, özellik adının istekteki değerle eşleşmemesi durumunda sağlanır. 
Örneğin, istekteki değer aşağıdaki örnekte olduğu gibi adında bir tire olan 
bir üstbilgi olabilir: 









public void OnGet([FromHeader(Name = "Accept-Language")] string 
language) 

[FromBody] özniteliği 

Bir HTTP isteğinin gövdesinden özelliklerini doldurmak için [FromBody] 
özniteliğini bir parametreye uygulayın. ASP.NET Core çalışma zamanı, gövdeyi 
bir giriş biçimlendirici 'y a okumaktan sorumlu olarak temsil eder. Giriş biçimleri 

Bu makalenin ilerleyen kısımlarındaaçıklanmıştır. 


Karmaşık bir tür parametresine [FromBody] uygulandığında, özelliklerine 
uygulanan herhangi bir bağlama kaynak özniteliği yok sayılır. Örneğin, aşağıdaki 
Create eylemi pet parametresinin gövdeden doldurulduğunu belirtir: 


public ActionResult<Pet> Create([FromBody] Pet pet) 

Pet sınıfı, 

belirtir: 

Breed 

özelliğinin bir sorgu dizesi parametresinden doldurulduğunu 


public class Pet 
{ 

public string Name { get; set; } 


[FromQuery] // Attribute is ignored. 
public string Breed { get; set; } 

} 

Yukarıdaki örnekte: 

• [FromQuery] özniteliği yok sayılır. 

• Breed özelliği bir sorgu dizesi parametresinden doldurulmamış. 

Giriş biçimleri yalnızca gövdeyi okur ve bağlama kaynak özniteliklerini 
anlamayın. Gövdede uygun bir değer bulunursa, bu değer Breed özelliğini 
doldurmak için kullanılır. 

Eylem yöntemi başına birden fazla parametreye [FromBody] uygulamayın, istek 
akışı bir giriş biçimlendirici tarafından okunduktan sonra, diğer [FromBody] 
parametrelerini bağlamak için artık bir daha okunamaz. 

Ek kaynaklar 

Kaynak verileri, model bağlama sistemine değer sağlayıcılaragöre sağlanır. Diğer 
kaynaklardan model bağlamaya yönelik verileri alan özel değer sağlayıcıları 
yazabilir ve kaydedebilirsiniz. Örneğin, tanımlama bilgileri veya oturum durumu 
verilerini isteyebilirsiniz. Yeni bir kaynaktan veri almak için: 

• ıvaiueProvider uygulayan bir sınıf oluşturun. 

• ıvaiueProviderFactory uygulayan bir sınıf oluşturun. 

• Factory sınıfını Startup.ConfigureServices kaydedin. 

Örnek uygulama, tanımlama bilgilerinden değerler alan bir değer sağlayıcısı ve 
Factory örneği içerir. Startup.ConfigureServices kayıt kodu aşağıda verilmiştir: 













Services. AddMvc (options => 

{ 

options.ValueProviderFactories.Add(new CookieValueProviderFactoryO); 
options.ModelMetadataDetailsProviders.Add( 

new ExcludeBindingMetadataProvider(typeof(System.Version))); 
options.ModelMetadataDetailsProviders.Add( 

new SuppressChildValidationMetadataProvider(typeof(System.Guid))); 

}) 


.AddXmlSerializerFormatters() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


Gösterilen kod, tüm yerleşik değer sağlayıcılarından sonra özel değer 
sağlayıcısını koyar. Listenin ilk olması için, Add yerine 
lnsert(0j new CookieValueProviderFactoryO) çağırın. 


Model özelliği için kaynak yok 

Varsayılan olarak, model özelliği için bir değer bulunmazsa model durumu hatası 
oluşturulmaz. Özelliği null veya varsayılan bir değer olarak ayarlanır: 

• Null yapılabilir basit türler null olarak ayarlanır. 

• Null yapılamayan değer türleri defauit(T) olarak ayarlanır. Örneğin, int id 
parametresi 0 olarak ayarlanır. 

• Karmaşık türler için model bağlama, özellikleri ayarlamadan varsayılan 
oluşturucuyu kullanarak bir örnek oluşturur. 

• Diziler, byte[] dizilerinin null olarak ayarlandığı durumlar dışında 
Array.Empty<T>() olarak ayarlanır. 

Model özelliği için form alanlarında hiçbir şey bulunamadığında model 
durumunun geçersiz kılınmalıdır, [BindRequired] özniteliğini kullanın. 

Bu [BindRequired] davranışının, bir istek gövdesinde JSON veya XML verilerine 
değil, postalanan form verilerinden model bağlama için geçerli olduğunu 
unutmayın, istek gövdesi verileri, giriş formatlayıcılarıtarafından işlenir. 

Tür dönüştürme hataları 

Bir kaynak bulunursa ancak hedef türe dönüştürülemiyorsa, model durumu 
geçersiz olarak işaretlenir. Hedef parametresi veya özelliği, önceki bölümde 
belirtildiği gibi null veya varsayılan değer olarak ayarlanır. 

[ApiControiler] özniteliğine sahip bir API denetleyicisinde, geçersiz model 
durumu otomatik HTTP 400 yanıtına neden olur. 

Razor sayfasında, sayfayı bir hata iletisiyle yeniden görüntüleyin: 

public IActionResult OnPost() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_instructorsInMemoryStore.Add(Instructor); 
return RedirectToPage("./Index"); 

} 















istemci tarafı doğrulama, aksi durumda Razor Pages bir forma gönderilemeyen 
hatalı verileri yakalar. Bu doğrulama, önceki vurgulanmış kodu tetiklemeyi 
zorlaştırır. Örnek uygulama, teslim tarihi alanına hatalı veri yerleştiren ve formu 
Gönderen Geçersiz tarih içeren bir Gönder düğmesi içerir. Bu düğme, veri 
dönüştürme hataları oluştuğunda sayfanın yeniden görüntülenmesine yönelik 
kodun nasıl çalıştığını gösterir. 

Sayfa önceki kodla yeniden görüntülendiğinde, form alanında geçersiz giriş 
gösterilmez. Bunun nedeni model özelliğinin null ya da varsayılan bir değer 
olarak ayarlanmış olmasından kaynaklanır. Geçersiz giriş bir hata iletisinde 
görüntülenir. Ancak form alanındaki hatalı verileri yeniden görüntülemek 
istiyorsanız, model özelliğini bir dize haline getirmeyi ve veri dönüştürmeyi el ile 
gerçekleştirmeyi düşünün. 

Tür dönüştürme hatalarının model durumu hatalarına neden olmasını 
istemiyorsanız aynı strateji önerilir. Bu durumda model özelliğini bir dize yapın. 

Basit türler 

Model cildin kaynak dizeleri dönüştürebileceğiniz basit türler aşağıdakileri içerir: 

• Boole değeri 

• Byte, S Byte 

• Char 

• Hem 

• Türünde 

• Kategori 

• Çift 

• Yardımının 

• 'ini 

• Intl 6, Int32, Int64 

• Sunuculu 

• TimeSpan 

• UIntl 6, Ulnt32, Ulnt64 

• Uri 

• Sürüm 

Karmaşık türler 

Karmaşık bir türün bağlanması için ortak bir varsayılan Oluşturucusu ve ortak 
yazılabilir özellikleri olmalıdır. Model bağlama gerçekleştiğinde, sınıf ortak 
varsayılan Oluşturucu kullanılarak oluşturulur. 

Karmaşık türün her özelliği için model bağlama, ad modeli ön eki için kaynakları 
arar. property_name. Hiçbir şey bulunamazsa, ön ek olmadan yalnızca 
property_name arar. 

Bir parametreye bağlama için, önek parametre adıdır. PageModei public özelliğine 
bağlama için, önek ortak özellik adıdır. Bazı özniteliklerin, parametre veya özellik 
adının varsayılan kullanımını geçersiz kılabilmenizi sağlayan Prefix bir özelliği 
vardır. 

Örneğin, karmaşık türün aşağıdaki instructor sınıfı olduğunu varsayalım: 









public class Instructor 

{ 

public int ID { get; set; } 

public string LastName { get; set; } 

public string FirstName { get; set; } 

} 

Önek = parametre adı 

Bağlanacak model instructorToUpdate adlı bir parametredir: 

public IActionResult OnPost(int? id, Instructor İnstructorToUpdate) 

Model bağlama, anahtar instructorToUpdate .id kaynaklara bakarak başlar. Bu 
bulunamazsa, öneki olmayan id arar. 

Önek = Özellik adı 

Bağlanacak model, denetleyicinin veya PageModei sınıfının ınstructor adlı bir 
özelliktir: 

[BindProperty] 

public Instructor Instructor { get; set; } 

Model bağlama, anahtar ınstructor .id kaynaklara bakarak başlar. Bu 
bulunamazsa, öneki olmayan id arar. 

Özel ön ek 

Bağlanacak model instructorToUpdate adlı bir parametredir ve Bind özniteliği 
önek olarak ınstructor belirtir: 

public IActionResult OnPost( 

int? id, [Bind(Prefix = "Instructor")] Instructor İnstructorToUpdate) 

Model bağlama, anahtar ınstructor .id kaynaklara bakarak başlar. Bu 
bulunamazsa, öneki olmayan id arar. 

Karmaşık tür hedefleri için öznitelikler 

Karmaşık türlerin model bağlamasını denetlemek için birkaç yerleşik öznitelik 
mevcuttur: 

• [BindRequired] 

• [BindNever] 

• [Bind] 


NOTE 

Bu öznitelikler, gönderilen form verileri değer kaynağı olduğunda model bağlamayı 
etkiler. Bunlar, gönderilen JSON ve XML istek gövdelerini işleyen giriş formatlayıcıları 'nı 
etkilemez. Giriş biçimleri Bu makalenin ilerleyen kısımlarındaaçıklanmıştır. 

Ayrıca bkz. model doğrulamasında [Required] özniteliği tartışması. 


[BindRequired] özniteliği 


















, Yöntem parametrelerine değil yalnızca model özelliklerine uygulanabilir. 

Modelin özelliği için bağlama gerçekleşmemişse model bağlamasının model 
durumu hatası eklemesine neden olur. Örnek buradadır: 

public class InstructorİAİithCollection 
{ 

public int ID { get; set; } 

[DataType(DataType.Date)] 

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}"j ApplyFormatlnEditMode 
= true)] 

[Display(Name = "Hire Date")] 

[BindRequired] 

public DateTime FlireDate { get; set; } 

[Bindhiç] özniteliği 

, Yöntem parametrelerine değil yalnızca model özelliklerine uygulanabilir. Model 
bağlamasının model özelliğini değiştirmesini engeller. Örnek buradadır: 

public class InstructorWithDictionary 
{ 

[BindNever] 

public int ID { get; set; } 

[Bind] özniteliği 

, Bir sınıfa veya yöntem parametresine uygulanabilir. Model bağlamasındaki bir 
modelin hangi özelliklerinin dahil edileceğini belirtir. 


Aşağıdaki örnekte, herhangi bir işleyici veya eylem yöntemi çağrıldığında 
yalnızca instructor modelin belirtilen özellikleri bağlanır: 


[Bind("LastName,FirstMidNamejHireDate")] 
public class instructor 

Aşağıdaki örnekte, onPost yöntemi çağrıldığında yalnızca 
belirtilen özellikleri bağlanır: 

instructor 

modelin 


[FlttpPost] 

public IActionResult OnPost([Bind("LastName,FirstMidName.,HireDate") ] 
instructor instructor) 


[Bind] özniteliği, oluşturma senaryolarında fazla nakline karşı korumak için 
kullanılabilir. Dışlanan Özellikler null ya da boş değer olarak ayarlandığı için, 
düzenleme senaryolarında iyi çalışmaz. Fazla nakline karşı savunma için, [Bind] 
özniteliği yerine, görüntüleme modelleri önerilir. Daha fazla bilgi için bkz. fazla 

nakil hakkında güvenlik NOI. 

Koleksiyonlar 

Basit türlerin koleksiyonları olan hedefler için model bağlama, parameter_name 
veya property_name ile eşleşmeleri arar. Eşleşme bulunmazsa, ön ek olmadan 
desteklenen biçimlerden birini arar. Örneğin: 

• Bağlanacak parametrenin selectedcourses adlı bir dizi olduğunu 









varsayalım: 


public IActionResult OnPost(int? id, int[] selectedCourses) 

• Form veya sorgu dizesi verileri aşağıdaki biçimlerden birinde olabilir: 

selectedCourses=1050&selectedCourses=2000 

selectedCourses[0]=1050&selectedCourses[l]=2000 

[0]=1050&[1]=2000 

selectedCourses[a]=1050&selectedCourses[b]=2000&selectedCourses.index 
a&selectedCourses.lndex=b 

[a]=1050&[b]=2000&index=a&index=b 

• Aşağıdaki biçim yalnızca form verilerinde desteklenir: 

selectedCourses[]=1050&selectedCourses[]=2000 

• Önceki örnek biçimlerinin hepsi için model bağlama iki öğe dizisini 

selectedCourses parametresine geçirir: 

o Selectedkurslar [0] = 1050 
o Selectedkurslar [1] = 2000 

Alt simge numaralarını kullanan veri biçimleri (... [0]... [1 ]...) sıfırdan 
başlayarak sıralı olarak numaralandırıldıklarından emin olmalıdır. Alt 
simge numaralandırmasında boşluk varsa, boşluklardan sonraki tüm 
öğeler yoksayılır. Örneğin, alt simgeler 0 ve 1 yerine 0 ve 2 ise ikinci öğe 
yok sayılır. 

Sözlükler 

Dictionary hedefler için, model bağlama parameter_name veya 
property_nameeş\eşrr\e\erir\\ arar. Eşleşme bulunmazsa, ön ek olmadan 
desteklenen biçimlerden birini arar. Örneğin: 

• Hedef parametrenin selectedCourses adil bir 0 ictionary<int, string> 
olduğunu varsayalım: 

public IActionResult OnPost(int? id, Dictionary<int, string> 
selectedCourses) 

• Postalanan form veya sorgu dizesi verileri aşağıdaki örneklerden birine 
benzeyebilir: 










selectedCourses[1050]=Chemistry&selectedCourses[2000]=Economics 

[1050]=Chemistry&selectedCourses[2000]=Economics 

selectedCourses[0].Key=1050&selectedCourses[0].Value=Chemistry& 
selectedCourses[l].Key=2000&selectedCourses[l].Value=Economics 

[0].Key=1050&[0].Value=Chemistry&[l].Key=2000&[l].Value=Economics 

• Önceki örnek biçimlerinin hepsi için model bağlama iki öğenin sözlüğünü 

selectedCourses parametresine geçirir: 

o Selectedkurslar ["1050"] = "Chemistry" 
o Selectedkurslar ["2000"] = "Ekonomiks" 

Model bağlama yolu verileri ve sorgu dizeleri için 
Genelleştirme davranışı 

AS P.N ET Core yol değeri sağlayıcısı ve sorgu dizesi değer sağlayıcısı: 

• Değerleri sabit kültür olarak değerlendirin. 

• URL 'Lerin kültür sabiti olmasını bekler. 

Buna karşılık, form verilerinden gelen değerler kültüre duyarlı bir dönüştürmeye 
gider. Bu, URL 'Lerin yerel ayarlarda paylaşılabilir olması için tasarımdır. 

AS P.N ET Core yol değeri sağlayıcısını ve sorgu dizesi değeri sağlayıcısını, kültüre 
duyarlı bir dönüşüme dönüştürmek için: 

• IValueProviderFactory 'den devralma 

• QueryStringValueProviderFactory veya RouteValueValueProviderFactory 
adresinden kodu kopyalayın 

• Değer sağlayıcısı oluşturucusuna geçirilen kültür değerini Culturelnfo. 
CurrentCulture ile değiştirin 

• MVC seçeneklerinde varsayılan değer sağlayıcı fabrikasını yeni bir değerle 
değiştirin: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddControllersWithViews(options => 

{ 

var index = options.ValueProviderFactories.IndexOf( 

options.ValueProviderFactories.OfType<QueryStringValueProviderFactory> 
().Single()); 

options.ValueProviderFactories[index] = new 
CulturedQueryStringValueProviderFactory(); 

}); 

} 








public class CulturedQueryStringValueProviderFactory : IValueProviderFactory 
{ 

public Task CreateValueProviderAsync(ValueProviderFactoryContext context) 
{ 

if (context == null) 

{ 

throw new ArgumentNullException(nameof(context)); 

} 

var query = context.ActionContext.HttpContext.Request.Query; 
if (query != null && query.Count > 0) 

{ 

var valueProvider = new QueryStringValueProvider( 
BindingSource.Queryj 
query, 

Culturelnfo.CurrentCulture); 
context.ValueProviders.Add(valueProvider); 

} 

return Task.CompletedTaskj 

} 

} 


Özel veri türleri 

Model bağlamanın işleyebileceği bazı özel veri türleri vardır. 

Iformfile ve ıformfilecollection 

HTTP isteğine eklenen karşıya yüklenen dosya. Ayrıca, birden çok dosya için 
IEnumerable<IFormFile> desteklenir. 

CancellationToken 

Zaman uyumsuz denetleyicilerde etkinliği iptal etmek için kullanılır. 

Form koleksiyonu 

Postalanan form verilerinden tüm değerleri almak için kullanılır. 

Giriş biçimleri 

istek gövdesindeki veriler JSON, XML veya başka bir biçimde olabilir.Model 
bağlama, bu verileri ayrıştırmak için belirli bir içerik türünü işlemek üzere 
yapılandırılmış bir giriş biçimlerıdiricisi kullanır. Varsayılan olarak, ASP.NET Core 
JSON verilerini işlemek için JSON tabanlı giriş formatlayıcıları içerir. Diğer içerik 
türleri için başka biçim ekleyebilirsiniz. 

ASP.NET Core, tüketen özniteliğine bağlı olarak giriş formatlayıcıları seçer. Hiçbir 
öznitelik yoksa, Content-Type üst bilgisinikullanır. 

Yerleşik XML girişi formatlayıcıları ’nı kullanmak için: 

• Microsoft. AspNetCore.Mvc.Formatters.Xml NuGet paketini yükler. 

• startup.configureServices AddXmlSerializerFormatters veya 
AddXmlDataContractSerializerFormattersçağırın. 






Services.AddMvc(options => 

{ 

options.ValueProviderFactories.Add(new 
CookieValueProviderFactory()); 

options.ModelMetadataDetailsProviders.Add( 

new ExcludeBindingMetadataProvider(typeof(System.Version))); 
options.ModelMetadataDetailsProviders.Add( 
new 

SuppressChildValidationMetadataProvider(typeof(System.Guid))); 

}) 

.AddXmlSerializerFormatters() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

• consumes özniteliğini, istek gövdesinde XM L beklemeniz gereken 
denetleyici sınıflarına veya eylem yöntemlerine uygulayın. 

[HttpPost] 

[Consumes("application/xml")] 

public ActionResult<Pet> Create(Pet pet) 


Daha fazla bilgi için bkz. XML serileştirme tanıtımı. 

Belirtilen türleri model bağlamalarından Dışla 

Model bağlama ve doğrulama sistemlerinin davranışı ModelMetadatatarafından 
yönlendiriliyor. Mvcoptions. Modelmetadatadetails sağlayıcı larınabi r ayrıntı 
sağlayıcısı ekleyerek ModeiMetadata özelleştirebilirsiniz. Yerleşik Ayrıntılar 
sağlayıcıları, belirtilen türler için model bağlamayı veya doğrulamayı devre dışı 
bırakmak üzere kullanılabilir. 

Belirtilen türdeki tüm modellerdeki model bağlamayı devre dışı bırakmak için 
Startup.configureServices bir ExcludeBindingMetadataProvider ekleyin. 
Örneğin, System.version türündeki tüm modeller üzerinde model bağlamayı 
devre dışı bırakmak için: 

Services.AddMvc(options => 

{ 

options.ValueProviderFactories.Add(new CookieValueProviderFactoryO); 
options.ModelMetadataDetailsProviders.Add( 

new ExcludeBindingMetadataProvider(typeof(System.Version))); 
options.ModelMetadataDetailsProviders.Add( 

new SuppressChildValidationMetadataProvider(typeof(System.Guid))); 

}) 

.AddXmlSerializerFormatters() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


Belirtilen türdeki özelliklerde doğrulamayı devre dışı bırakmak için 
Startup.configureServices SuppressChildValidationMetadataProvider ekleyin. 
Örneğin, System.Guid türündeki özelliklerde doğrulamayı devre dışı bırakmak 
için: 








Services. AddMvc (options => 

{ 

options.ValueProviderFactories.Add(new CookieValueProviderFactoryO); 
options.ModelMetadataDetailsProviders.Add( 

new ExcludeBindingMetadataProvider(typeof(System.Version))); 
options.ModelMetadataDetailsProviders.Add( 

new SuppressChildValidationMetadataProvider(typeof(System.Guid))); 

}) 


.AddXmlSerializerFormatters() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


Özel model ciltleri 

Özel bir model cildi yazarak ve belirli bir hedef için seçmek üzere [ModelBinder] 
özniteliğini kullanarak model bağlamayı genişletebilirsiniz. Özel model 
bağiamahakkında daha fazla bilgi edinin. 

El ile model bağlama 

Model bağlama, TryllpdateModelAsync yöntemi kullanılarak el ile çağrılabilir. 
Yöntemi hem controiierBase hem de PageModei sınıflarında tanımlanmıştır. 
Yöntem aşırı yüklemeleri, kullanılacak öneki ve değer sağlayıcısını belirtmenizi 
sağlar. Model bağlama başarısız olursa Yöntem faise döndürür. Örnek 
buradadır: 


if (await TryUpdateModelAsync<InstructorWithCollection>( 
newInstructor, 

"Instructor ", 

i => i.FirstMidName, i => i.LastName, i => i.HireDate)) 

{ 

_instructorsInMemoryStore.Add(newInstructor); 
return RedirectToPage("./Index")t 

} 

PopulateAssignedCourseData(newInstructor); 
return Page(); 


[FromServices] özniteliği 

Bu özniteliğin adı, bir veri kaynağı belirten model bağlama özniteliklerinin 
düzeniyle uyar. Ancak bir değer sağlayıcısından veri bağlama hakkında bilgi 
yoktur. Bağımlılık ekleme kapsayıcısından bir türün bir örneğini alır. Amacı, 
yalnızca belirli bir yöntem çağrılırsa bir hizmete ihtiyacınız olduğunda Oluşturucu 
ekleme için bir alternatif sağlamaktır. 

Ek kaynaklar 

• ASP.NET Core MVC 'de model doğrulaması 

• ASP.NET Core özel model bağlama 







ASPNET Core özel model bağlama 
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Steve Smith tarafından 

Model bağlama, denetleyici eylemlerinin HTTP istekleri yerine model türleriyle doğrudan (Yöntem bağımsız 
değişkenleri olarak geçirilir) çalışmasına izin verir. Gelen istek verileri ve uygulama modelleri arasındaki eşleme, 
model ciltleri tarafından işlenir. Geliştiriciler, özel model ciltlerinizi uygulayarak yerleşik model bağlama işlevini 
genişletebilir (genellikle kendi sağlayıcınızı yazmanız gerekmez). 

GitHub 'dan örnek görüntüleme veya indirme 

Varsayılan model Ciltçi sınırlamaları 

Varsayılan model ciltleri ortak.NET Core veri türlerinin çoğunu destekler ve çoğu geliştiricilerin ihtiyaçlarını 
karşılamaları gerekir, istek içinden doğrudan model türlerine metin tabanlı giriş bağlamayı bekler. Bağlamayı 
bağlamadan önce girişi dönüştürmeniz gerekebilir. Örneğin, model verilerini aramak için kullanılabilecek bir 
anahtarınız olduğunda. Anahtar temelinde veri getirmek için özel bir model Bağlayıcısı kullanabilirsiniz. 

Model bağlama incelemesi 

Model bağlama, üzerinde çalıştığı türler için belirli tanımları kullanır .Basit bir tür , girişte tek bir dizeden 
dönüştürülür. Karmaşık bir tür birden çok giriş değerinden dönüştürülür. Framevvork, bir TypeConverter varlığına 
göre farkı belirler. Dış kaynak gerektirmeyen basit bir string -> someType eşlemeye sahipseniz bir tür 
dönüştürücüsü oluşturmanız önerilir. 

Kendi özel model cilinkini oluşturmadan önce, mevcut model ciltçileri 'nin nasıl uygulandığını gözden geçirdik. 
Base64 ile kodlanmış dizeleri bayt dizilerine dönüştürmek için kullanılabilecek Bytearraymodelciltçi 'yi düşünün. 
Bayt dizileri genellikle dosya veya veritabanı blobu alanları olarak depolanır. 

Bytearraymodelciltçi ile çalışma 

ikili verileri temsil etmek için Base64 kodlamak dizeler kullanılabilir.Örneğin, aşağıdaki resim bir dize olarak 
kodlanabilir. 



Kodlanmış dizenin küçük bir kısmı aşağıdaki görüntüde gösterilmiştir: 










_| Base&4 Encoded Dotnet Bot.txt - Notepad — □ X 

File Edit Format View Help 

iVBORw0KGgoAAAANSUhEUgAAAQUAAAEFCAYAAADqlvKRAAAAAXNSR0IArs4c6QAAAARnQUlBAACxjwv8YQU * 
AAAA3cEhZcwAADsMAAA7DAcdvqGQAAF4vSURBVHhe7d0L0G51dSf4zLXnVjM105WSsiiLoqAwioUUlmll5Z2 
acDCbTlslIVzLV0t3VlZZKTabsYaqTRukkTroNalqaC3mIoLYhyIg3SKLQKkcNGhAvNCThEjGo5BQXD9KcN 
B4oQcyZ/dvu9bnO/p537/l+7+W7PatqlfnOd9nv3s+zlv/5r8vz7B 

+rUqVKlSpVqlSpUqVKlSpVqlSpUqVKlSpVqlSpUqVKlSpWiP/wYhWqV31j0s4+3/Y6X/U6X/c6X+Svo6f 

+b0KEFWq7DEJIAgA4Pz/aaN/o9H/rNH/oqB+RgFtoAhwqQFSpsoslnBgYBBAAgf+80f+y0f+q0f+m0f 

+20f8uqf//1436OYDwNwEOrlWBollqVXSYBBMEKgEAAAKf/8UZPaPSF11577d+6+eab39jX5mcn 

+nn3u/6mDxAltKhSZZdIZgboP0Cw6rdgcPHFF7/64YcfwTo0aN3HBsRv3Pfffdd/PM///OnNX/7NxsFKsD 

BNbGOCgxVquxw4ZycNLHDocALrP5TgKAkzz///F8Bkg4cMAfXxBoAQ 

+QbqlSpssMkAIGTBjv4cY585MiRWzn/Xkiee 

+65h4UbzXWFHoBBXkI44TMrW6hSZQd3hAxWbis4hz2BA3PkzqeXIt///vefuvP009/SXF+ 

+IUIKIFQZQ5UqO0QyIARDeMHlll//U2h/58tL13wvfefN3 

+DMQAGYUrkGCpjqFJlGyVCBjkEDKENGTCEVQICwRi6UA3jkMQES06jsoUqVbZDAhCszhwSjf 

+bqgsctvPdSfK9o88e 

+/aDjx979pnnuu9HE6H3OeecclbzuRgDtqDaUdlClSnbDAEIHBEgcMyTnnrqqa90PjtT/voHf33sz2978Nh 

l//ymY7/++t8+9tb//t0b+s5z33fsk 

+/9/LGjTz7d/faw3H///Vf43Eb7YUSVKlXWKDmPoAKgTHjS3Xff/Uudr86UP/3Mnx979//+/uOAoKS/ 

+j//5rE7b76n+6vZIkx3bAE4RXNTZQtVqqxR03xsP5ZgdeaQp45VGu761L3HLvofLjnO+f3/4r/93mPv+N 

+u2MQa/OyBL32r++vZcvvtt/9y8/lyC71/oY3ClSprFKEDx4vy40nKh32PFuW+Wx84DhAAı,K2f/ye8fu 

+FffvrYxy65ZUN/79f/zbHf 

+3mrNn7vl37q8mOPP/REd5WyHD58+HPuodEIIYBVBYUqVdYouUHpBY0ONig99Z2jbTgQjn733/3AcUBQ0nf 

9nSs3fv8jv/aJ7kplefbZZ7/b3MP33b243yEE4KrAUKXKGoSjidnlErCEF772ta99deefRfnYuz694eBYQ3 

8dlPT33/n3DWaBVYxJcx+nNhp5BYBVqxBVqqx3O3rQAUlH1190zTXXvKnzzU2i3Pgrr7m0de5/9j/ 

+q20//45PFkGgpP/Pay9r/+5t/8t7uqvNluY+7IuQV6igUKXKraoWjRRmyrTooC3a 

+uUnkEoIl/KvzPlh0/lkqn 

+DvhB5j0txHgAL2UkGhSpUlCScTq4vZOZ8Y/pS77rmg51vbpLPfPD2DVB4A^W/V3T+WTpn 

+PDiRnMFooJClSprEE7G2azEWovF8KcNgcKn3/eFDVD43bfeWHT+ksopxN 


Base64 ile kodlanmış dizeyi bir dosyaya dönüştürmek için ÖRNEĞİN Benioku dosyasındaki yönergeleri izleyin. 

ASP.NET Core MVC, Base64 kodlamak bir dize alabilir ve bir bayt dizisine dönüştürmek için bir 
ByteArrayModelBinder kullanabilir. IModelBinderProvider Maps uygulayan ByteArrayModelBinderProvider , 
byte[ ] bağımsız değişkenleri ByteArrayModelBinder: 

public IModelBinder GetBinder(ModelBinderProviderContext context) 

{ 

if (context == null) 

{ 

throw new ArgumentNullException(nameof(context)); 

} 

if (context.Metadata.Modelîype == typeof(byte[])) 

{ 

return new ByteArrayModelBinder(); 

} 

return null; 

} 

Kendi özel model cilinkini oluştururken kendi iModelBinderProvider türünü uygulayabilir veya 

M odel B i nderAttributeku kanabilirsiniz. 

Aşağıdaki örnek, Base64 kodlamak bir dizeyi bir byte[] dönüştürmek ve sonucu bir dosyaya kaydetmek için 
ByteArrayModelBinder nasıl kullanacağınızı gösterir: 










// POST: api/image 
[HttpPost] 

public void Post(byte[] file, string filename) 

{ 

// Don't trust the file name sent by the Client. Use 
// Path .GetRandomFilelMame to generate a safe random 
// file name. _targetFilePath receives a value 
// from configunation (the appsettings.json file in 
// the sample app). 

var trustedFileName = Path.GetRandomFileName(); 

var filePath = Path.Combine(_targetFilePath, trustedFileName); 

if (System. 10.File.Exists(filePath)) 

{ 

return; 

} 

System.10.File.WriteAllBytes(filePath, file); 

} 


Postmangibi bir araç kullanarak bu API yöntemine Base64 kodlamak bir dize gönderebilirsiniz: 
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Bağlayıcı, istek verilerini uygun şekilde adlandırılmış özelliklere veya bağımsız değişkenlere bağlayabildiğinden, 
model bağlama başarılı olur. Aşağıdaki örnek, ByteArrayModelBinder bir görünüm modeliyle nasıl kullanacağınızı 
gösterir: 











[HttpPost("Profile")] 

public void SaveProfile(ProfileViewModel model) 

{ 

// Don’t trust the file name sent by the Client. Use 
// Path.GetRandomFileName to generate a safe random 
// file name. _targetFilePath receives a value 
// from configuration (the appsettings.json file in 
// the sample app). 

var trustedFileName = Path.GetRandomFileName(); 

var filePath = Path.Combine(_targetFilePath, trustedFileName); 

if (System.10.File.Exists(filePath)) 

{ 

return; 

} 

System.10.File.WriteAllBytes(filePath, model.File); 

} 

public class ProfileViewModel 

{ 

public byte[] File { get; set; } 
public string FileName { get; set; } 


Özel model Ciltçi örneği 

Bu bölümde, özel bir model cildi uygulayacağız: 

• Gelen istek verilerini kesin belirlenmiş anahtar bağımsız değişkenlerine dönüştürür. 

• ilişkili varlığı getirmek için Entity Framevvork Core kullanır. 

• ilişkili varlığı eylem yöntemine bir bağımsız değişken olarak geçirir. 

Aşağıdaki örnek, Author modelinde ModelBinder özniteliğini kullanır: 

using CustomModelBindingSample.Binders; 
using Microsoft.AspNetCore.Mvc; 
using System; 

using System.Collections.Generic; 

using System.Linq; 

using System.Threading.Tasks; 

namespace CustomModelBindingSample.Data 

{ 

[ModelBinder(BinderType = typeof(AuthorEntityBinder))] 
public class Author 
{ 

public int Id { get; set; } 
public string Name { get; set; } 
public string GitHub { get; set; } 
public string Twitter { get; set; } 
public string BlogUrl { get; set; } 

} 

} 

Yukarıdaki kodda ModelBinder özniteliği, Author eylem parametrelerini bağlamak için kullanılması gereken 
iModelBinder türünü belirtir. 

Aşağıdaki AuthorEntityBinder sınıfı, Entity Framevvork Core ve authorid kullanarak bir veri kaynağından varlığı 
getirerek bir Author parametresini bağlar: 














public class AuthorEntityBinder : IModelBinder 

{ 

private readonly AppDbContext _db; 
public AuthorEntityBinder(AppDbContext db) 

{ 

_db = db; 

} 

public Task BindModelAsync(ModelBindingContext bindingContext) 

{ 

if (bindingContext == null) 

{ 

throw new ArgumentNullException(nameof(bindingContext)); 

} 

var modelName = bindingContext.ModelName; 

// Try to fetch the value of the argument by name 
var valueProviderResult = 

bindingContext.ValueProvider.GetValue(modelName); 

if (valueProviderResult == ValueProviderResult.None) 

{ 

return Task.CompletedTask; 

} 

bindingContext.ModelState.SetModelValue(modelName, 
valueProviderResult); 

var value = valueProviderResult.FirstValue; 

// Check if the argument value is null or empty 
if (string.IsNullOrEmpty(value)) 

{ 

return Task.CompletedTask; 

} 

int id = 0; 

if (!int.TryParse(value, out id)) 

{ 

// Non-integer arguments result in model State errors 
bindingContext.ModelState.TryAddModelError( 
modelName, 

"Author Id must be an integer."); 
return Task.CompletedTask; 

} 

// Model will be null if not found, including for 
// out of range id values (0, -3, ete.) 
var model = _db.Authors.Find(id); 

bindingContext.Result = ModelBindingResult.Success(model); 
return Task.CompletedTask; 

} 

} 


NOTE 

Önceki AuthorEntityBinder sınıfı özel bir model cildi göstermek için tasarlanmıştır. Sınıfı, bir arama senaryosu için en iyi 
yöntemleri göstermeye yönelik değildir. Arama için authorid bağlayın ve veritabanını bir eylem yöntemine sorgulayın. Bu 
yaklaşım, model bağlama başarısızlıklarını NotFound durumlardan ayırır. 


Aşağıdaki kod, AuthorEntityBinder bir eylem yönteminde nasıl kullanılacağını gösterir: 





[HttpGet("get/{authorId}")] 

public IActionResult Get(Author author) 

{ 

return Ok(author); 

} 

ModelBinder özniteliği, varsayılan kuralları kullanmayan parametrelere AuthorEntityBinder uygulamak için 
kullanılabilir: 

[HttpGet("{id}")] 

public IActionResult GetById([ModelBinder(Name = "id")]Author author) 

{ 

if (author == null) 

{ 

return NotFound(); 

} 

if (IModelState.IsValid) 

{ 

return BadRequest(ModelState); 

} 

return Ok(author); 

} 

Bu örnekte, bağımsız değişkenin adı varsayılan authorid olmadığından, parametresinde ModelBinder özniteliği 
kullanılarak belirtilir. Hem denetleyici hem de eylem yöntemi, eylem yöntemindeki varlığı aramaya kıyasla 
basitleştirilmiştir. Entity Framevvork Core kullanarak yazarı getirme mantığı model cilde taşınır. Bu, Author 
modeline bağlanan çeşitli yöntemlere sahip olduğunuzda önemli bir basitleştirme olabilir. 

Yalnızca bu tür veya eylem için belirli bir model Bağlayıcısı veya model adı belirtmek için, ModelBinder özniteliğini 
tek tek model özelliklerine (VievvModel üzerinde gibi) veya eylem yöntemi parametrelerine uygulayabilirsiniz. 

ModelBinderProvider uygulama 

Bir özniteliği uygulamak yerine, iModelBinderProvider uygulayabilirsiniz. Yerleşik çerçeve ciltçileri uygulanır.Cildin 
üzerinde çalıştığı türü belirttiğinizde, cildin kabul ettiği girişi değil , oluşturduğu bağımsız değişkenin türünü 
belirtirsiniz. Aşağıdaki Ciltçi sağlayıcısı AuthorEntityBinder ile birlikte kullanılabilir. MVC 'nin sağlayıcılar 
koleksiyonuna eklendiğinde, Author veya Author türü belirlenmiş parametrelerde ModelBinder özniteliğini 
kullanmanız gerekmez. 














using CustomModelBindingSample.Data; 
using Microsoft.AspNetCore.Mvc.ModelBinding; 
using Microsoft.AspNetCore.Mvc.ModelBinding.Binders; 
using System; 

namespace CustomModelBindingSample.Binders 

{ 

public class AuthorEntityBinderProvider : IModelBinderProvider 

{ 

public IModelBinder GetBinder(ModelBinderProviderContext context) 

{ 

if (context == null) 

{ 

throw new ArgumentNullException(nameof(context)); 

} 

if (context.Metadata.ModelType == typeof(Author)) 

{ 

return new BinderTypeModelBinder(typeof(AuthorEntityBinder)); 

} 

return null; 

} 

} 

} 


Note: Yukarıdaki kod bir BinderTypeModelBinder döndürür. BinderTypeModelBinder , model ciltleri için bir 
fabrika görevi görür ve bağımlılık ekleme (Dİ) sağlar. AuthorEntityBinder , EF Core erişim için dı gerektiriyor. 
Model Ciltçi 'nin dı 'den hizmet gerektirmesi durumunda BinderTypeModelBinder kullanın. 


Özel model Ciltçi sağlayıcısını kullanmak için, configureServices içine ekleyin: 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<AppDbContext>(options => options.UseInMemoryDatabase()); 

Services.AddMvc(options => 

{ 

// add custom binder to beginning of collection 

options.ModelBinderProviders.Insert(0, new AuthorEntityBinderProvider()); 

}); 


Model ciltleri değerlendirilirken, sağlayıcı koleksiyonu sırayla incelenir. Bir cildi döndüren ilk sağlayıcı kullanılır. 
Aşağıdaki görüntüde, hata ayıklayıcıdan varsayılan model ciltçileri gösterilmektedir. 


Autos 

Name 

Value 

A > options.ModelBindı 

Count = 14 

0 [0] 

{Microsoft.AspNetCore.Mvc.ModelBinding.Binders.BinderTypeModelBinderProvider} 

0 [1] 

{Microsoft.AspNetCore.Mvc.ModelBinding.Binders.ServicesModelBinderProvider} 

> # [2] 

{Microsoft.AspNetCore.Mvc.ModelBinding.Binders.BodyModelBinderProvider} 

0 [3] 

[Microsoft.AspNetCore.Mvc.ModelBinding.Binders.HeaderModelBinderProvider] 

0 [4] 

{Microsoft.AspNetCore.Mvc.ModelBinding.Binders.SimpleTypeModelBinderProvider} 

<f [5] 

{Microsoft.AspNetCore.Mvc.ModelBinding.Binders.CancellationTokenModelBinderProvider} 

0 [6] 

{Microsoft.AspNetCore.Mvc.ModelBinding.Binders.ByteArrayModelBinderProvider} 

0 [7] 

{Microsoft.AspNetCore.Mvc.ModelBinding.Binders.FormFileModelBinderProvider} 

0 [8] 

{Microsoft.AspNetCore.Mvc.ModelBinding.Binders.FormCollectionModelBinderProvider} 

0 [9] 

[Microsoft.AspNetCore.Mvc.ModelBinding.Binders.KeyValuePairModelBinderProvider] 

0 [10] 

{Microsoft.AspNetCore.Mvc.ModelBinding.Binders.DictionaryModelBinderProvider} 

0 [11] 

[Microsoft.AspNetCore.Mvc.ModelBinding.Binders.ArrayModelBinderProvider] 

0 [12] 

{Microsoft.AspNetCore.Mvc.ModelBinding.Binders.CollectionModelBinderProvider} 

0 [13] 

[Microsoft.AspNetCore.Mvc.ModelBinding.Binders.ComplexTypeModelBinderProvider] 








Sağlayıcınızı koleksiyonun sonuna eklemek, özel ciltçinin bir şansı olmadan önce yerleşik bir model cilde yol 
açabilir. Bu örnekte, özel sağlayıcı, Author eylem bağımsız değişkenleri için kullanıldığından emin olmak için 
koleksiyonun başlangıcına eklenir. 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<AppDbContext>(options => options.UseInMemoryDatabase()); 

Services.AddMvc(options => 

{ 

// add custom binder to beginning of collection 

options.ModelBinderProviders.Insert(0, new AuthorEntityBinderProvider()); 

}); 

} 

Polimorfik model bağlama 

Türetilmiş türlerin farklı modellerine bağlama polimorfik model bağlama olarak bilinir, istek değeri, belirli 
türetilmiş model türüne bağlanması gerektiğinde polimorfik özel model bağlama gerekir. Polimorfik model 
bağlama: 

• Tüm dillerle birlikte çalışmak üzere tasarlanan bir REST API için tipik değildir. 

• , Bağlantılı modeller hakkında neden olmasını zorlaştırır. 

Ancak, bir uygulama çok biçimli model bağlama gerektiriyorsa, bir uygulama aşağıdaki koda benzeyebilir: 

public abstract class Device 

{ 

public string Kind { get; set; } 

} 

public class Laptop : Device 

{ 

public string CPUIndex { get; set; } 

} 

public class SmartPhone : Device 

{ 

public string ScreenSize { get; set; } 

} 

public class DeviceModelBinderProvider : IModelBinderProvider 

{ 

public IModelBinder GetBinder(ModelBinderProviderContext context) 

{ 

if (context.Metadata.ModelType != typeof(Device)) 

{ 

return null; 

} 

var subclasses = new[] { typeof(Laptop), typeof(SmartPhone), }; 

var binders = new DictionarycType, (ModelMetadata, IModelBinder)>(); 
foreach (var type in subclasses) 

{ 

var modelMetadata = context.MetadataProvider.GetMetadataForType(type); 
binders[type] = (modelMetadata, context.CreateBinder(modelMetadata)); 

} 

return new DeviceModelBinder(binders); 

} 

} 


public class DeviceModelBinder : IModelBinder 




{ 


pnivate Dictionary<Type, (ModelMetadata, IModelBinder)> binders; 


public DeviceModelBinder(Dictionary<Type, (ModelMetadata, IModelBinder)> binders) 

{ 

this.binders = binders; 

} 

public async Task BindModelAsync(ModelBindingContext bindingContext) 

{ 

var modelKindName = ModelNames.CreatePropertyModelName(bindingContext.ModelName, 
nameof(Device.Kind)); 

var modelTypeValue = bindingContext.ValueProvider.GetValue(modelKindl\lame).FirstValue; 

IModelBinder modelBinder; 

ModelMetadata modelMetadata; 
if (modelTypeValue == "Laptop") 

{ 

(modelMetadata, modelBinder) = binders[typeof(Laptop)]; 

} 

else if (modelTypeValue == "SmartPhone") 

{ 

(modelMetadata, modelBinder) = binders[typeof(SmartPhone)]; 

} 

else 

{ 

bindingContext.Result = ModelBindingResult.Failed(); 
return; 

} 

var newBindingContext = DefaultModelBindingContext.CreateBindingContext( 
bindingContext.ActionContext, 
bindingContext.ValueProvider, 
modelMetadata, 
bindinglnfo: null, 
bindingContext.ModelName); 

await modelBinder.BindModelAsync(newBindingContext); 
bindingContext.Result = newBindingContext.Result; 

if (newBindingContext.Result.IsModelSet) 

{ 

// Setting the ValidationState ensures properties on derived types are correctly 
bindingContext.ValidationState[newBindingContext.Result] = new ValidationStateEntry 
{ 

Metadata = modelMetadata, 

}; 

} 

} 

} 


Öneriler ve en iyi uygulamalar 

Özel model ciltleri: 

• Durum kodları veya dönüş sonuçları ayarlanmamalıdır (örneğin, 404 bulunamadı). Model bağlama başarısız 
olursa, eylem yönteminin kendisi içindeki bir eylem filtresinin veya mantığının hata işlemesi gerekir. 

• , Yinelenen kodu ve eylem yöntemlerinden çapraz kesme sorunlarını ortadan kaldırmak için en yararlı 
seçenektir. 

• Genellikle bir dizeyi özel bir türe dönüştürmek için kullanılmamalıdır, birTypeConverter genellikle daha iyi bir 
seçenektir. 
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Kirk Larkaya göre 

Bu makalede, ASP.NET Core MVC veya Razor Pages uygulamasında Kullanıcı girişinin nasıl 
doğrulanacağı açıklanır. 

Örnek kodu görüntüleyin veya indirin (nasıl indirilir). 

Model durumu 

Model durumu iki alt sistemden gelen hataları temsil eder: model bağlama ve model 
doğrulama. Model bağlamasından kaynaklanan hatalar genellikle veri dönüştürme 
hatalardır. Örneğin, bir tamsayı alanına bir "x" girilir.Model bağlama sonrasında model 
doğrulaması oluşur ve verilerin iş kurallarına uygun olmadığı rapor hataları raporlar. 
Örneğin, 1 ile 5 arasında bir derecelendirme bekleyen bir alana 0 girilir. 

Hem model bağlama hem de model doğrulama, bir denetleyici eyleminin veya bir Razor 
Pages işleyicisi yönteminin yürütülmesinden önce oluşur. Web uygulamaları için, 
uygulamanın Modeistate.isValid inceleme ve uygun şekilde tepki verme sorumluluğu 
vardır. Web Apps genellikle sayfayı bir hata iletisiyle yeniden görüntülerdi: 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.IsValid) 

{ 

return Page(); 

} 

_context.Movies.Add(Movie); 
await _context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 

[Apicontroiler] özniteliğine sahip olmaları durumunda Web API denetleyicilerinin 
Modeistate.isValid denetlemesi gerekmez. Bu durumda, model durumu geçersiz 
olduğunda hata ayrıntılarını içeren bir otomatik HTTP 400 yanıtı döndürülür. Daha fazla 
bilgi için bkz. OTOMATİK HTTP 400 yanıtları. 

Doğrulamayı yeniden çalıştır 

Doğrulama otomatiktir, ancak el ile yinelemek isteyebilirsiniz.Örneğin, bir özellik için bir 
değer hesaplamanıza ve özelliği hesaplanan değere ayarladıktan sonra doğrulamayı 
yeniden çalıştırmak isteyebilirsiniz. Doğrulamayı yeniden çalıştırmak için, burada 
gösterildiği gibi TryValidateModei yöntemini çağırın: 









Movie.ReleaseDate = modifiedReleaseDate; 

if (ITryValidateModel(Movie, nameof(Movie))) 

{ 

return Page(); 

} 

_context.Movies.Add(Movie); 
await _context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 


Doğrulama öznitelikleri 

Doğrulama öznitelikleri, model özellikleri için doğrulama kuralları belirtmenize olanak tanır. 
Örnek uygulamadaki aşağıdaki örnek, doğrulama öznitelikleriyle açıklama eklenmiş bir 
model sınıfı gösterir. [ciassicMovie] özniteliği özel bir doğrulama özniteliğidir ve diğerleri 
yerleşik olarak bulunur. Gösterilmemiştir [ciassicMoviewithciientvaiidator] . 
[ciassicMoviewithciientvaiidator] özel bir öznitelik uygulamak için alternatif bir yol 
gösterir. 

public class Movie 

{ 

public int Id { get; set; } 

[Required] 

[StringLength(100)] 

public string Title { get; set; } 

[ClassicMovie(1960)] 

[DataType(DataType.Date)] 

[Display(Name = "Release Date")] 
public DateTime ReleaseDate { get; set; } 

[Required] 

[StringLength(1000)] 

public string Description { get; set; } 

[Range(0, 999.99)] 

public decimal Price { get; set; } 

public Genre Genre { get; set; } 

public bool Preorder { get; set; } 

} 


Yerleşik öznitelikler 

Yerleşik doğrulama özniteliklerinden bazıları şunlardır: 

• [creditcard] : özelliğin kredi kartı biçimine sahip olduğunu doğrular. 

• [Compare] : bir modeldeki iki özelliği eşleştiğini doğrular. 

• [EmailAddress] : özelliğin bir e-posta biçimine sahip olduğunu doğrular. 

• [phone] : özelliğin bir telefon numarası biçimi olduğunu doğrular. 

• [Range] : Özellik değerinin belirtilen bir aralık dahilinde olduğunu doğrular. 

• [ReguiarExpression] : Özellik değerinin belirtilen bir normal ifadeyle eşleştiğini doğrular. 

• [Required] : alanın null olduğunu doğrular. Bu özniteliğin davranışı hakkındaki ayrıntılar 








için bkz. [Required] özniteliği. 

• [stringLength] : dize özellik değerinin belirtilen uzunluk sınırını aşmadığını doğrular. 

• [url] : özelliğin bir URL biçimine sahip olduğunu doğrular. 

• [Remote] : sunucuda bir eylem yöntemi çağırarak istemcide girişi doğrular. Bu özniteliğin 
davranışı hakkındaki ayrıntılar için bkz. [ [Remote] ' Attribute] (#remote-özniteliği). 

Doğrulama özniteliklerinin tüm listesi System. ComponentModel. Dataaçıklamalarda ad 
alanında bulunabilir. 

Hata iletileri 

Doğrulama öznitelikleri, geçersiz giriş için görüntülenecek hata iletisini belirtmenize izin 
verir. Örneğin: 

[StringLength(8j ErrorMessage = "Name length can't be more than 8.")] 

Dahili olarak, öznitelikler çağrı, alan adı için bir yer tutucu ve bazen ek yer tutucular ile 
string.Format .Örneğin: 

[StringLength(8j ErrorMessage = "{0} length must be between {2} and {1}.", MinimumLength 
- 6 )] 

Bir Name özelliğine uygulandığında, yukarıdaki kod tarafından oluşturulan hata iletisi "ad 
uzunluğu 6 ile 8 arasında olmalıdır." olacaktır. 

Belirli bir özniteliğin hata iletisinde hangi parametrelerin string.Format geçtiğini öğrenmek 
için bkz. Datareek açıklamaları kaynak kodu. 

[Zorunlu] özniteliği 

Varsayılan olarak, doğrulama sistemi, null olamayan parametreleri veya özellikleri bir 
[Required] özniteliği gibi davranır, decimai ve int gibi değer türleri null atanamaz. 

[Zorunlu] sunucuda doğrulama 

Sunucuda, özelliği null ise gerekli bir değer eksik olarak kabul edilir. Null yapılamayan bir 
alan her zaman geçerlidir ve [Required] özniteliğin hata mesajı hiçbir zaman gösterilmez. 

Ancak, null olamayan bir özellik için model bağlama başarısız olabilir ve 
The value '' is invalid gibi bir hata mesajı elde edebilir. Null yapılamayan türlerin sunucu 
tarafı doğrulaması için özel bir hata iletisi belirtmek üzere aşağıdaki seçenekleriniz vardır: 

• Alanı null yapılabilir yapın (örneğin, decimai yerine decimai? ). Null yapılabilir <t > 
değer türleri standart null yapılabilir türler gibi değerlendirilir. 

• Aşağıdaki örnekte gösterildiği gibi model bağlama tarafından kullanılacak varsayılan 
hata iletisini belirtin: 












Services .AddRazorPages () 

.AddMvcOptions(options => 

{ 

options.MaxModelValidationErrors = 50; 

options.ModelBindingMessageProvider.SetValueMustNotBeNullAccessor( 

_ = > "The field is required."); 

}); 

Services.AddSingletorKlValidationAttributeAdapterProvider, 
CustomValidationAttributeAdapterProvider>(); 

için varsayılan iletileri ayarlayabilmeniz için model bağlama hataları hakkında daha 
fazla bilgi için bkz. DefaultModelBindingMessageProvider. 

[Zorunlu] istemcide doğrulama 

Null yapılamayan türler ve dizeler, sunucu ile karşılaştırıldığında, istemci üzerinde farklı 
şekilde işlenir, istemcide: 

• Yalnızca girdi girildiğinde bir değer vardır. Bu nedenle, istemci tarafı doğrulaması null 
yapılamayan türler, null yapılabilir türler ile aynı şekilde işler. 

• Bir dize alanındaki boşluk, jQuery doğrulaması gerekli yöntemi tarafından geçerli bir 
girdi olarak kabul edilir. Yalnızca boşluk girildiğinde, sunucu tarafı doğrulaması gerekli 
bir dize alanını geçersiz kabul eder. 

Daha önce belirtildiği gibi, null olamayan türler [Required] bir özniteliğe sahip olsa da 
kabul edilir. Bu, [Required] özniteliğini uygulamasanız bile istemci tarafı doğrulamayı 
alacağınız anlamına gelir. Ancak özniteliğini kullanmazsanız varsayılan bir hata iletisi 
alırsınız. Özel bir hata iletisi belirtmek için özniteliğini kullanın. 

[Uzak] özniteliği 

[Remote] özniteliği, alan girişinin geçerli olup olmadığını anlamak için sunucu üzerinde bir 
yöntem çağrılmasını gerektiren istemci tarafı doğrulaması uygular. Örneğin, uygulamanın 
bir kullanıcı adının zaten kullanımda olup olmadığını doğrulaması gerekebilir. 

Uzaktan doğrulamayı uygulamak için: 

1. JavaScript 'e çağırmak için bir eylem yöntemi oluşturun. JOuery Validate uzak 
YÖNTEMİ bir JSON yanıtı bekliyor: 

• true , giriş verilerinin geçerli olduğu anlamına gelir. 

• faise , undefined veya null , girişin geçersiz olduğu anlamına gelir. Varsayılan 
hata iletisini görüntüler. 

• Diğer herhangi bir dize, girişin geçersiz olduğu anlamına gelir. Dizeyi özel bir hata 
iletisi olarak görüntüleyin. 

Özel bir hata iletisi döndüren eylem yöntemine bir örnek aşağıda verilmiştir: 






[AcceptVerbs("GET", "POST")] 

public IActionResult VerifyEmail(string email) 

{ 

if (!_userService.VerifyEmail(email)) 

{ 

return lson($"Email {email} is already in use."); 

} 

netunn Ison(true); 

} 

2. Model sınıfında, aşağıdaki örnekte gösterildiği gibi, doğrulama eylemi yöntemine 
işaret eden bir [Remote] özniteliğiyle özelliğe not ekleyin: 

[Remote(action: "VenifyEmail", contnollen: "Usens")] 
public stning Email { get; set; } 

[Remote] özniteliği Microsoft.AspNetcone.Mvc ad alanıdır. 

Ek alanlar 

[Remote] özniteliğinin AdditionaiFields özelliği, sunucudaki verilere karşı alan 
birleşimlerini doğrulamanızı sağlar. Örneğin, User modelinde FirstName ve LastName 
özellikler varsa, mevcut hiçbir kullanıcının bu ad çiftine sahip olmadığını doğrulamak 
isteyebilirsiniz. Aşağıdaki örnek AdditionaiFields nasıl kullanacağınızı gösterir: 

[Remote(action: "VerifyName", controllen: "Users", AdditionaiFields = nameof(LastName))] 
[Display(Name = "First Name")] 
public string FirstName { get; set; } 

[Remote(action: "VerifyName", controller: "Users", AdditionaiFields = 
nameof(FirstName))] 

[Display(Name = "Last Name")] 
public string LastName { get; set; } 

AdditionaiFields "FirstName" ve "LastName" dizeleriyle açıkça ayarlanabilir, ancak 
NameOf işlecinin kullanılması daha sonra yeniden düzenlemeyi basitleştirir. Bu doğrulama 
için eylem yöntemi hem firstName hem de lastName bağımsız değişkenlerini kabul 
etmelidir: 

[AcceptVerbs("GET", "POST")] 

public IActionResult VerifyName(string firstName, string lastName) 

{ 

if (!_userService.VerifyName(firstName, lastName)) 

{ 

return lson($"A user named {firstName} {lastName} already exists."); 

} 

return Ison(true); 

} 

Kullanıcı adı veya soyadı girdiğinde JavaScript, bu ad çiftinin alındığını görmek için uzak bir 
çağrı yapar. 

iki veya daha fazla ek alanı doğrulamak için bunları virgülle ayrılmış bir liste olarak belirtin. 
Örneğin, modele bir MiddieName özelliği eklemek için, [Remote] özniteliğini aşağıdaki 
örnekte gösterildiği gibi ayarlayın: 
















[Remote(action: "VerifyName", controller: "Users", AdditionalFields = nameof(FirstName) 

+ + nameof(LastName))] 

public string MiddleName { get; set; } 

Tüm öznitelik bağımsız değişkenleri gibi AdditionalFields , sabit bir ifade olmalıdır. Bu 
nedenle, AdditionalFields başlatmak için, enterpolasyonlu bir dize veya çağrı Join 
kullanmayın. 

Yerleşik özniteliklerin alternatifleri 

Yerleşik öznitelikler tarafından sağlanmayan doğrulamaya ihtiyacınız varsa şunları 
yapabilirsiniz: 

• Özel öznitelikler oluşturun. 

• IValidatableObject uygulayın. 

Özel öznitelikler 

Yerleşik doğrulama özniteliklerinin işlemeyen senaryolar için özel doğrulama öznitelikleri 
oluşturabilirsiniz. ValidationAttributedevralan bir sınıf oluşturun ve IsValid yöntemini 
geçersiz kılın. 

isVaüd yöntemi, doğrulanacak girdi olan Value adlı bir nesne kabul eder. Aşırı yükleme, 
model bağlama tarafından oluşturulan model örneği gibi ek bilgiler sağlayan 
vaüdationContext nesnesini de kabul eder. 

Aşağıdaki örnek, Klasik tarz bir filmin yayın tarihinin belirtilen yıldan daha sonra olmadığını 
doğrular. [ciassicMovie] özniteliği: 

• Yalnızca sunucuda çalışır. 

• Klasik Filmler için, yayımlanma tarihini doğrular: 

public class ClassicMovieAttribute : ValidationAttribute 

{ 

public ClassicMovieAttribute(int year) 

{ 

Year = year; 

} 

public int Year { get; } 

public string GetErrorMessage() => 

$"Classic movies must have a release year no later than {Year}."; 

protected override ValidationResult IsValid(object value, 

ValidationContext validationContext) 

{ 

var movie = (Movie)validationContext.ObjectInstance; 
var releaseYear = ((DateTime)value).Year; 

if (movie.Genre == Genre.Classic && releaseYear > Year) 

{ 

return new ValidationResult(GetErrorMessage()); 

} 

return ValidationResult.Success; 

} 

} 







Yukarıdaki örnekteki movie değişkeni, form gönderimden verileri içeren bir Movie 
nesnesini temsil eder. Doğrulama başarısız olduğunda, hata iletisi içeren bir 
ValidationResult döndürülür. 

IValidatableObject 

Yukarıdaki örnek yalnızca Movie türleriyle birlikte geçerlidir. Sınıf düzeyinde doğrulama için 
başka bir seçenek de, aşağıdaki örnekte gösterildiği gibi model sınıfında 
IValidatableObject uygulamaktır: 

public class ValidatableMovie : IValidatableObject 
{ 

private const int _classicYear = 1960; 

public int Id { get; set; } 

[Required] 

[Stringl_ength(100) ] 

public string Title { get; set; } 

[DataType(DataType.Date)] 

[Display(Name = "Release Date")] 
public DateTime ReleaseDate { get; set; } 

[Required] 

[Stringl_ength(1000) ] 

public string Description { get; set; } 

[Range(0, 999.99)] 

public decimal Price { get; set; } 

public Genre Genre { get; set; } 

public bool Preorder { get; set; } 

public IEnumerable<ValidationResult> Validate(ValidationContext validationContext) 

{ 

if (Genre == Genre.Classic && ReleaseDate.Year > _classicYear) 

{ 

yield return new ValidationResult( 

$"Classic movies must have a release year no later than 
{_classicYear }.", 

new[] { nameof(ReleaseDate) }); 

} 

} 

} 


Üst düzey düğüm doğrulaması 

Üst düzey düğümler şunları içerir: 

• Eylem parametreleri 

• Denetleyici özellikleri 

• Sayfa işleyici parametreleri 

• Sayfa modeli özellikleri 

Model bağlantılı üst düzey düğümler, model özelliklerini doğrulamaya ek olarak onaylanır. 
Örnek uygulamadan aşağıdaki örnekte, verifyPhone yöntemi phone eylem parametresini 
doğrulamak için RegularExpressionAttribute kullanır: 









[AcceptVerbs("GET", "POST")] 
public IActionResult VenifyPhone( 

[RegularExpression(@" A \d{3}-\d{3}-\d{4}$")] string phone) 

{ 

if (IModelState.IsValid) 

{ 

return 3son($"Phone {phone} has an invalid format. Format: ###-###-####"); 

} 

return Ison(true); 

} 

Üst düzey düğümler, doğrulama öznitelikleri ileBindRequiredAttribute kullanabilir. Örnek 
uygulamadan aşağıdaki örnekte, checkAge yöntemi, form gönderildiğinde age 
parametresinin sorgu dizesinden bağlanması gerektiğini belirtir: 

[HttpPost] 

public IActionResult CheckAge([BindRequiredj FromQuery] int age) 

{ 

Denetim yaşı sayfasında (Checkage. cshtml) iki form vardır. İlk form bir 99 Age değerini 
bir sorgu dizesi parametresi olarak gönderir: https://iocaihost:500i/users/checkAge?Age=99 . 

Sorgu dizesinden düzgün şekilde biçimlendirilen bir age parametresi gönderildiğinde, 
form doğrular. 

Denetim yaşı sayfasındaki ikinci form, isteğin gövdesinde Age değerini gönderir ve 
doğrulama başarısız olur, age parametresi bir sorgu dizesinden gelmiş olması 
gerektiğinden bağlama başarısız olur. 

En fazla hata sayısı 

En fazla hata sayısına ulaşıldığında doğrulama durduruluyor (varsayılan olarak 200). Bu 
numarayı startup.configureServices aşağıdaki kodla yapılandırabilirsiniz: 

Services.AddRazorPages() 

.AddMvcOptions(options => 

{ 

options.MaxModelValidationErrors = 50; 

options.ModelBindingMessageProvider.SetValueMustNotBeNullAccessor( 

_ => "The fleld is required."); 

})J 

Services. AddSingletorKlValidationAttributeAdapterProvider., 
CustomValidationAttributeAdapterProvider>(); 


En yüksek özyineleme 

ValidationVisitor, doğrulanan modelin nesne grafiğinin altına geçer. Derin olan veya sonsuz 
özyinelemeli olan modeller için doğrulama, yığın taşmasına neden olabilir. Mvcoptions. 
MaxValidationDepth , ziyaretçi özyineleme yapılandırılmış bir derinliği aşarsa doğrulamanın 
erken durdurulması için bir yol sağlar. Mvcoptions.MaxVaiidationDepth varsayılan değeri 32 1 
dir. 


Otomatik kısa devre 














Model grafı doğrulama gerektirmiyorsa, doğrulama otomatik olarak kısa devre dışı 
(atlandı). Çalışma zamanının, herhangi bir Doğrulayıcıları olmayan byte[] , stringf] , 
Dictionary<string, string> ) ve karmaşık nesne grafikleri dahil olmak üzere doğrulamayı 
atlayan nesneler. 

Doğrulamayı devre dışı bırak 

Doğrulamayı devre dışı bırakmak için: 

1. Hiçbir alanı geçersiz olarak işaretlememeyen bir IObjectModelValidator 
uygulamasını oluşturun. 

public class NullObjectModelValidator : IObjectModelValidator 
{ 

public void Validate(ActionContext actionContext, 

ValidationStateDictionary validationState, string prefix, object model) 

{ 


} 

} 


Bağımlılık ekleme kapsayıcısında varsayılan 
değiştirmek için Startup.ConfigureServices 

IObjectModelValidator 

aşağıdaki kodu ekleyin. 

uygulamasını 

Services.AddSingleton<IObjectModelValidator., NullObjectModelValidator>(); 


Model bağlamalarından kaynaklanan model durumu hatalarını görmeye devam 
edebilirsiniz. 

İstemci tarafı doğrulaması 

istemci tarafı doğrulama, form geçerli olana kadar gönderimi önler.Gönder düğmesi, formu 
gönderen veya hata iletilerini görüntüleyen JavaScript 'ı çalıştırır. 

Bir form üzerinde giriş hataları olduğunda, istemci tarafı doğrulaması sunucuya gereksiz 
gidiş dönüş önler._Layouf. cshtml ve _ValidationScriptsPartial. cshtml ' deki aşağıdaki betik 
başvuruları istemci tarafı doğrulamayı destekler: 

<script src=" https://cdnjs.cloudflare.eom/ajax/libs/jquery/3.4.l/jquery.min.js"> 
</script> 


<script src="https://cdnjs. cloudflare.com/ajax/libs/ jquery- 
validate/1.19.1/jquery .validate.min. js"x/script> 

<script src="https://cdnjs. cloudflare.com/ajax/libs/jquery-validation- 
unobtrusive/3.2.11/jquery.validate.unobtrusive.min. js"x/script> 


JQuery unobtrusive doğrulama betiği, popüler jQuery Validate eklentisi üzerinde derleme 
yapan özel bir Microsoft ön uç kitaplığıdır. JQuery unobtrusive doğrulaması olmadan, iki 
yerde aynı doğrulama mantığını kodlamakta olmanız gerekir: model özelliklerindeki 
Sunucu tarafı doğrulama özniteliklerinde bir kez ve sonra istemci tarafı betiklerimizde. 
Bunun yerine, Etiket Yardımcıları ve HTML Yardımcıları , doğrulama GEREKTİREN form 
öğeleri için HTML 5 data- özniteliklerini işlemek üzere model özelliklerinden doğrulama 
özniteliklerini ve tür meta verilerini kullanır. jQuery unobtrusive doğrulaması data- 











özniteliklerini ayrıştırır ve mantığı, sunucu tarafı doğrulama mantığını istemciye, etkin 
şekilde "kopyalamak" amacıyla jQuery doğrulamasına geçirir. Aşağıda gösterildiği gibi, 
etiket yardımcıları kullanarak istemcisinde doğrulama hatalarını görüntüleyebilirsiniz: 

<div class="form-group"> 

clabel asp-for="Movie.ReleaseDate" class="control-label"x/label> 

<input asp-for="Movie.ReleaseDate" class="form-control" /> 

<span asp-validation-for="Movie.ReleaseDate" class="text-danger"x/span> 

</div> 

Önceki etiket yardımcıları aşağıdaki HTML 'yi işler: 

<div class="form-group"> 

clabel class="control-label" for="Movie_ReleaseDate">Release Date</label> 
cinput class="form-control" type="date" data-val="true" 

data-val-required="The Release Date fleld is required." 
id="Movie_ReleaseDate" name="Movie.ReleaseDate" value=""> 
cspan class="text-danger field-validation-valid" 

data-valmsg-for="Movie.ReleaseDate" data-valmsg-replace="true"x/span> 

</div> 

HTML çıkışındaki data- özniteliklerinin Movie.ReleaseDate özelliğinin doğrulama 
özniteliklerine karşılık geldiğini unutmayın. data-vai-required özniteliği, Kullanıcı Yayın 
tarihi alanını doldurmazsa görüntülenecek bir hata iletisi içerir, jöuery unobtrusive 
doğrulaması bu değeri jöuery Validate Required () yöntemine geçirir ve sonra bu iletiyi 
eşlik eden <span > öğesinde görüntüler. 

Veri türü doğrulama, bir [DataType] özniteliği tarafından geçersiz kılınmadıkça, özelliğin 
.NET türünü temel alır. Tarayıcıların kendi varsayılan hata iletileri vardır ancak jöuery 
doğrulaması unobtrusive doğrulama paketi bu iletileri geçersiz kılabilir. [EmailAddress] gibi 
öznitelikleri ve alt sınıfları [DataType] , hata iletisini belirtmenize izin verir. 

Unobtrusive doğrulaması 

Obtrusive doğrulaması hakkında bilgi için Bu GitHub sorununabakın. 

Dinamik formlara doğrulama ekleme 

jöuery unobtrusive doğrulaması, sayfa ilk yüklendiğinde jöuery doğrulaması için 
doğrulama mantığını ve parametreleri geçirir. Bu nedenle, doğrulama dinamik olarak 
üretilen formlarda otomatik olarak çalışmaz. Doğrulamayı etkinleştirmek için, jöuery 'ten 
kaçınmaya yönelik doğrulamayı, dinamik formu oluşturduktan hemen sonra ayrıştırmaya 
söyleyin. Örneğin, aşağıdaki kod, AJAX aracılığıyla eklenen bir formda istemci tarafı 
doğrulamayı ayarlar. 










$-get({ 

url: "https://url/that/returns/a/form", 
dataType: "html", 

error: function(jqXHR, textStatus, errorThrown) { 

alert(textStatus + Couldn't add form. " + errorThrown); 

}, 

success: function(newFormHTML) { 

var Container = document.getElementById("form-container"); 

Container.insertAdjacentHTML("beforeend"j newFormHTML); 
var forms = Container.getElementsByTagName("form"); 
var newForm = forms[forms.length - 1]; 

$.validator.unobtrusive.parse(newForm); 

} 

}) 

$. vaüdator.unobtrusive.parse() yöntemi bir bağımsız değişkeni için jQuery seçiciyi kabul 
eder. Bu yöntem, jQuery 'in bu seçicideki formların data- özniteliklerini ayrıştırmasına izin 
vermez. Daha sonra bu özniteliklerin değerleri jQuery Validate eklentisine geçirilir. 

Dinamik denetimlere doğrulama ekleme 

$.vaiidator.unobtrusive.parse() yöntemi, <input> ve <seiect/> gibi tek dinamik olarak 
oluşturulan denetimlerde değil, formun tamamına göre çalışmaktadır. Formu yeniden 
oluşturmak için, aşağıdaki örnekte gösterildiği gibi, form daha önce ayrıştırdığında eklenen 
doğrulama verilerini kaldırın: 

$-get({ 

url: "https://url/that/returns/a/control ", 
dataType: "html", 

error: function(jqXHR, textStatus, errorThrown) { 

alert(textStatus + ": Couldn't add control. " + errorThrown); 

}, 

success: function(newInputHTML) { 

var form = document.getElementById("my-form"); 
form.insertAdjacentHTML("beforeend ", newInputHTML); 

$(form).removeData("valldator") // Added by jQuery Validate 

.removeData("unobtrusiveValidation"); // Added by jQuery Unobtrusive 

Validation 

$.validator.unobtrusive.parse(form); 

} 

}) 


Özel istemci tarafı doğrulaması 

Özel istemci tarafı doğrulama işlemi, özel bir jöuery Validate bağdaştırıcısıyla çalışan 
data- HTML öznitelikleri oluşturarak yapılır.Aşağıdaki örnek bağdaştırıcı kodu, bu 
makalede daha Önce sunulan [ClassicMovie] ve [ClassicMovieWithClientValidator] 
öznitelikleri için yazılmıştır: 










$.validator.addMethod('classicmovie', function (value, element, params) { 

var genre = $(params[0]).val(), year = params[l], date = new Date(value); 

// The Classic genre has a value of '0'. 

if (genre && genre.length > 0 && genre[0] === '0') { 

// The release date for a Classic is valid if it's no greater than the given 

year. 

return date.getUTCFullYear() <= year; 

} 

return true; 


$.validator.unobtrusive.adapters.add('classicmovie', ['year'], function (options) { 
var element = $(options.form).find('select#Movie_Genre')[0]; 

options.rules['classicmovie'] = [element, parseInt(options.params['year'])]; 
options.messages['classicmovie'] = options.message; 


Bağdaştırıcıların nasıl yazılacağı hakkında daha fazla bilgi için jQuery Validate 
belgelerinebakın. 

Belirli bir alan için bir bağdaştırıcının kullanımı, data- öznitelikleri tarafından tetiklenir: 

• Alana, doğrulamaya tabi olacak şekilde bayrak ekleyin ( data-vai="true" ). 

• Bir doğrulama kuralı adı ve hata iletisi metni (örneğin, 

data-val-rulename="Error message." ) belirler. 

• Doğrulayıcı ihtiyaçlarına ek parametreler sağlayın (örneğin, 

data-val-rulename-paraml="value" ). 


Aşağıdaki örnek, örnek uygulamanın ciassicMovie özniteliği için data- özniteliklerini 
gösterir: 

«cinput class="form-control" type="date" 
data-val="true" 

data-val-classicmovie="Classic movies must have a release year no later than 1960." 
data-val-classicmovie-year="1960" 

data-val-required="The Release Date field is required." 
id="Movie_ReleaseDate" name="Movie.ReleaseDate" value=""> 

Daha önce belirtildiği gibi, Etiket Yardımcıları ve HTML Yardımcıları data- öznitelikleri 
işlemek için doğrulama özniteliklerinden bilgi kullanır. Özel data- HTML özniteliklerinin 
oluşturulmasına neden olan kod yazmak için iki seçenek vardır: 

• AttributeAdapterBase<TAttribute> ve IValidationAttributeAdapterProvider uygulayan bir 
sınıftan türeten bir sınıf oluşturun ve özniteinizi ve bağdaştırıcısını dı olarak kaydedin. Bu 
yöntem, sunucu ile ilgili ve istemciyle ilgili doğrulama kodundaki tek sorumluluk 
sorumlusunu , ayrı sınıflarda izler. Ayrıca bağdaştırıcı, Dİ ' de kaydolduğundan bu yana 
de bunun avantajına sahiptir. 

• validationAttribute sınıfınıza ıciientModeivaiidator uygulayın. Bu yöntem, öznitelik 
herhangi bir sunucu tarafı doğrulaması yapamazsa ve hiçbir hizmete gerek duymazsa 
uygun olabilir. 

İstemci tarafı doğrulaması için AttributeAdapter 

HTML'de data- öznitelikleri işleme yöntemi, örnek uygulamadaki ciassicMovie özniteliği 
tarafından kullanılır. Bu yöntemi kullanarak istemci doğrulaması eklemek için: 

















1. Özel doğrulama özniteliği için bir öznitelik bağdaştırıcı sınıfı oluşturun. Özniteliği 
Attributeadapterbase<t >'dan türeten. Aşağıdaki örnekte gösterildiği gibi, işlenen 
çıktıya data- öznitelikleri ekleyen bir Addvalidation yöntemi oluşturun: 

public class ClassicMovieAttributeAdapter : 
AttributeAdapterBase<ClassicMovieAttribute> 

{ 

public ClassicMovieAttributeAdapter(ClassicMovieAttribute attribute, 
IStringLocalizer stringLocalizer) 

: base(attribute, stringLocalizer) 

{ 

} 

public override void AddValidation(ClientModelValidationContext context) 

{ 

MergeAttribute(context.Attributes, "data-val", "true"); 
MergeAttribute(context.Attributes, "data-val-classicmovie", 
GetErrorMessage(context)); 

var year = Attribute.Year.ToString(Culturelnfo.InvariantCulture); 
MergeAttribute(context.Attributes, "data-val-classicmovie-year", year) 

} 

public override string GetErrorMessage(ModelValidationContextBase 
validationContext) => 

Attribute.GetErrorMessage(); 

} 

2. IValidationAttributeAdapterProvideruygulayan bir bağdaştırıcı sağlayıcısı sınıfı 
oluşturun. GetAttributeAdapter yöntemi, aşağıdaki örnekte gösterildiği gibi, özel 
özniteliğini bağdaştırıcının oluşturucusuna geçirin: 

public class CustomValidationAttributeAdapterProvider : 

IValidationAttributeAdapterProvider 

{ 

private readonly IValidationAttributeAdapterProvider baseProvider = 
new ValidationAttributeAdapterProvider(); 

public IAttributeAdapter GetAttributeAdapter(ValidationAttribute attribute 
IStringLocalizer stringLocalizer) 

{ 

if (attribute is ClassicMovieAttribute classicMovieAttribute) 

{ 

return new ClassicMovieAttributeAdapter(classicMovieAttribute, 
stringLocalizer); 

} 

return baseProvider.GetAttributeAdapter(attribute^ stringLocalizer); 

} 

} 

3. Dı için bağdaştırıcı sağlayıcısını startup.configureServices Kaydet: 








Services .AddRazorPages() 

.AddMvcOptions(options => 

{ 

options.MaxModelValidationErrors = 50; 

options.ModelBindingMessageProvider .SetValueMustNotBel\lullAccessor( 
_ => "The field is required."); 

}); 

Services.AddSingletorKlValidationAttributeAdapterProvider, 
CustomValidationAttributeAdapterProvider>(); 


İstemci tarafı doğrulaması için ılientmodelvalidator 

HTML'de data- öznitelikleri işleme yöntemi, örnek uygulamadaki 
ciassicMoviewithciientvaiidator özniteliği tarafından kullanılır. Bu yöntemi kullanarak 
istemci doğrulaması eklemek için: 

• Özel doğrulama özniteliğinde ıciientModeivaiidator arabirimini uygulayın ve bir 
Addvalidation yöntemi oluşturun. Addvalidation yönteminde, aşağıdaki örnekte 
gösterildiği gibi, doğrulama için data- öznitelikleri ekleyin: 









public class ClassicMovieklithClientValidatorAttribute : 

ValidationAttribute, IClientModelValidator 

{ 

public ClassicMovieWithClientValidatorAttribute(int year) 

{ 

Year = year; 

} 

public int Year { get; } 

public void AddValidation(ClientModelValidationContext context) 

{ 

MergeAttribute(context.Attributes, "data-val", "true"); 
MergeAttribute(context.Attributes, "data-val-classicmovie", 
GetErrorMessage()); 

var year = Year.ToString(Culturelnfo.InvariantCulture); 
MergeAttribute(context.Attributes, "data-val-classicmovie-year", year); 

} 

public string GetErrorMessage() => 

$"Classic movies must have a release year no later than {Year}."; 

protected override ValidationResult IsValid(object value, 

ValidationContext validationContext) 

{ 

var movie = (Movie)validationContext.ObjectInstance; 
var releaseYear = ((DateTime)value).Year; 

if (movie.Genre == Genre.Classic && releaseYear > Year) 

{ 

return new ValidationResult(GetErrorMessage()); 

} 

return ValidationResult.Success; 

} 

private bool MergeAttribute(IDictionary<string, string> attributes, string 
key, string value) 

{ 

if (attributes.ContainsKey(key)) 

{ 

return false; 

} 

attributes.Add(key, value); 
return true; 

} 

} 


İstemci tarafı doğrulamayı devre dışı bırak 

Aşağıdaki kod Razor Pages istemci doğrulamasını devre dışı bırakır: 

Services.AddRazorPages() 

.AddViewOptions(options => 

{ 

options.HtmlHelperOptions.ClientValidationEnabled = false; 

}); 


İstemci tarafı doğrulamayı devre dışı bırakmak için diğer seçenekler: 


• Tüm . cshtml dosyalarındaki _vaiidationScriptsPartiai başvurusunu açıklama olarak 





yapın. 

• Pages\shared_ValidationScriptsPartial. cshtml dosyasının içeriğini kaldırın. 

Yukarıdaki yaklaşım ASP.NET Core Identity Razor sınıfı kitaplığının istemci tarafında 
doğrulanmasını engellemez. Daha fazla bilgi için bkz. ASP.NET Core projelerinde yapı 
iskelesi kimliği. 

Ek kaynaklar 

• System. ComponentModel. Dataaçıklamalarda ad alanı 

• Model Bağlamaları 

Bu makalede, ASP.NET Core MVC veya Razor Pages uygulamasında Kullanıcı girişinin nasıl 
doğrulanacağı açıklanır. 

Örnek kodu görüntüleyin veya indirin (nasıl indirilir). 

Model durumu 

Model durumu iki alt sistemden gelen hataları temsil eder: model bağlama ve model 
doğrulama. Model bağlamasından kaynaklanan hatalar genellikle veri dönüştürme 
hatalardır (örneğin, bir tamsayı bekleyen bir alana bir "x" girilir). Model bağlama ve verilerin 
iş kurallarına uygun olmadığı rapor hataları (örneğin, 1 ile 5 arasında bir derecelendirme 
bekleyen bir alana bir 0 girildiğinde) oluşturulduktan sonra model doğrulaması oluşur. 

Hem model bağlama hem de doğrulama, bir denetleyici eyleminin veya bir Razor Pages 
işleyicisi yönteminin yürütülmesinden önce oluşur. Web uygulamaları için, uygulamanın 
Modeistate. isValid inceleme ve uygun şekilde tepki verme sorumluluğu vardır. Web Apps 
genellikle sayfayı bir hata iletisiyle yeniden görüntülerdi: 

public async Task<IActionResult> OnPostAsync() 

{ 

if (IModelState.İsValid) 

{ 

return Page()j 

} 

_context.Movie.Add(Movie); 
await _context.SaveChangesAsync(); 

return RedirectToPage("./Index"); 

} 

[ApiControiler] özniteliğine sahip olmaları durumunda Web API denetleyicilerinin 
Modeistate.isValid denetlemesi gerekmez. Bu durumda, model durumu geçersiz 
olduğunda hata ayrıntılarını içeren bir otomatik HTTP 400 yanıtı döndürülür. Daha fazla 
bilgi için bkz. OTOMATİK HTTP 400 yanıtları. 

Doğrulamayı yeniden çalıştır 

Doğrulama otomatiktir, ancak el ile yinelemek isteyebilirsiniz.Örneğin, bir özellik için bir 
değer hesaplamanıza ve özelliği hesaplanan değere ayarladıktan sonra doğrulamayı 
yeniden çalıştırmak isteyebilirsiniz. Doğrulamayı yeniden çalıştırmak için, burada 
gösterildiği gibi TryvalidateModei yöntemini çağırın: 







var movie = new Movie 

{ 

Title = title, 

Genre = genre, 

ReleaseDate = modifiedReleaseDate, 
Description = description, 

Price = price, 

Preorder = preorder, 

}; 


TryValidateModel(movie); 

if (ModelState.IsValid) 

{ 

_context.AddMovie(movie); 

_context.SaveChanges(); 

return RedirectToAction(actionName: nameof(Index)); 

} 

return View(movie); 


Doğrulama öznitelikleri 

Doğrulama öznitelikleri, model özellikleri için doğrulama kuralları belirtmenize olanak tanır. 
Örnek uygulamadaki aşağıdaki örnek, doğrulama öznitelikleriyle açıklama eklenmiş bir 
model sınıfı gösterir. [ciassicMovie] özniteliği özel bir doğrulama özniteliğidir ve diğerleri 
yerleşik olarak bulunur. Gösterilmemiştir [ciassicMovie 2 ] , özel bir özniteliği uygulamak 
için alternatif bir yol gösterir. 

public class Movie 

{ 

public int Id { get; set; } 

[Required] 

[StringLength(100)] 

public string Title { get; set; } 

[ClassicMovie(1960)] 

[DataType(DataType.Date)] 

public DateTime ReleaseDate { get; set; } 

[Required] 

[StringLength(1000)] 

public string Description { get; set; } 

[Range(0, 999.99)] 

public decimal Price { get; set; } 

[Required] 

public Genre Genre { get; set; } 
public bool Preorder { get; set; } 

} 


Yerleşik öznitelikler 

Yerleşik doğrulama öznitelikleri şunlardır: 


[creditcard] : özelliğin kredi kartı biçimine sahip olduğunu doğrular. 





• [Compare] : bir modeldeki iki özelliği eşleştiğini doğrular. Örneğin, register.cshtml.es 
dosyası, girilen iki parola eşleşmesini doğrulamak için [Compare] kullanır. Kayıt kodunu 
görmek için Scaffold kimliği . 

• [EmaiiAddress] : özelliğin bir e-posta biçimine sahip olduğunu doğrular. 

• [phone] : özelliğin bir telefon numarası biçimi olduğunu doğrular. 

• [Range] : Özellik değerinin belirtilen bir aralık dahilinde olduğunu doğrular. 

• [ReguiarExpression] : Özellik değerinin belirtilen bir normal ifadeyle eşleştiğini doğrular. 

• [Required] : alanın null olduğunu doğrular. Bu özniteliğin davranışı hakkındaki ayrıntılar 
için bkz. [Required] özniteliği. 

• [stringLength] : dize özellik değerinin belirtilen uzunluk sınırını aşmadığını doğrular. 

• [url] : özelliğin bir URL biçimine sahip olduğunu doğrular. 

• [Remote] : sunucuda bir eylem yöntemi çağırarak istemcide girişi doğrular. Bu özniteliğin 
davranışı hakkındaki ayrıntılar için bkz. [Remote] özniteliği . 

Doğrulama özniteliklerinin tüm listesi System. ComponentModel. Dataaçıklamalarda ad 
alanında bulunabilir. 

Hata iletileri 

Doğrulama öznitelikleri, geçersiz giriş için görüntülenecek hata iletisini belirtmenize izin 
verir. Örneğin: 

[StringLength(8j ErrorMessage = "Name length can't be more than 8.")] 

Dahili olarak, öznitelikler çağrı, alan adı için bir yer tutucu ve bazen ek yer tutucular ile 
string.Format .Örneğin: 

[StringLength(8j ErrorMessage = "{0} length must be between {2} and {1}.", MinimumLength 
- 6 )] 

Bir Name özelliğine uygulandığında, yukarıdaki kod tarafından oluşturulan hata iletisi "ad 
uzunluğu 6 ile 8 arasında olmalıdır." olacaktır. 

Belirli bir özniteliğin hata iletisinde hangi parametrelerin string.Format geçtiğini öğrenmek 
için bkz. Datareek açıklamaları kaynak kodu. 

[Zorunlu] özniteliği 

Varsayılan olarak, doğrulama sistemi, null olamayan parametreleri veya özellikleri bir 
[Required] özniteliği gibi davranır, decimai ve int gibi değer türleri null atanamaz. 

[Zorunlu] sunucuda doğrulama 

Sunucuda, özelliği null ise gerekli bir değer eksik olarak kabul edilir. Null yapılamayan bir 
alan her zaman geçerlidir ve [gerekli] özniteliğinin hata mesajı hiçbir zaman gösterilmez. 

Ancak, null olamayan bir özellik için model bağlama başarısız olabilir ve 
The value ' ’ is invalid gibi bir hata mesajı elde edebilir. Null yapılamayan türlerin sunucu 
tarafı doğrulaması için özel bir hata iletisi belirtmek üzere aşağıdaki seçenekleriniz vardır: 

• Alanı null yapılabilir yapın (örneğin, decimai yerine decimai? ). Null yapılabilir<t > 
değer türleri standart null yapılabilir türler gibi değerlendirilir. 

• Aşağıdaki örnekte gösterildiği gibi model bağlama tarafından kullanılacak varsayılan 















hata iletisini belirtin: 


Services.AddMvc(options => 

{ 

options.MaxModelValidationErrors = 50; 

options.ModelBindingMessageProvider.SetValueMustNotBeNullAccessor( 

(_) => "The field is required."); 

}) 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

Services .AddSingleton 

cIValidationAttributeAdapterProvider, 

CustomValidationAttributeAdapterProvider>(); 

için varsayılan iletileri ayarlayabilmeniz için model bağlama hataları hakkında daha 
fazla bilgi için bkz. DefaultModelBindingMessageProvider. 

[Zorunlu] istemcide doğrulama 

Null yapılamayan türler ve dizeler, sunucu ile karşılaştırıldığında, istemci üzerinde farklı 
şekilde işlenir, istemcide: 

• Yalnızca girdi girildiğinde bir değer vardır. Bu nedenle, istemci tarafı doğrulaması null 
yapılamayan türler, null yapılabilir türler ile aynı şekilde işler. 

• Bir dize alanındaki boşluk, jQuery doğrulaması gerekli yöntemi tarafından geçerli bir 
girdi olarak kabul edilir. Yalnızca boşluk girildiğinde, sunucu tarafı doğrulaması gerekli 
bir dize alanını geçersiz kabul eder. 

Daha önce belirtildiği gibi, null olamayan türler [Required] bir özniteliğe sahip olsa da 
kabul edilir. Bu, [Requined] özniteliğini uygulamasanız bile istemci tarafı doğrulamayı 
alacağınız anlamına gelir. Ancak özniteliğini kullanmazsanız varsayılan bir hata iletisi 
alırsınız. Özel bir hata iletisi belirtmek için özniteliğini kullanın. 

[Uzak] özniteliği 

[Remote] özniteliği, alan girişinin geçerli olup olmadığını anlamak için sunucu üzerinde bir 
yöntem çağrılmasını gerektiren istemci tarafı doğrulaması uygular. Örneğin, uygulamanın 
bir kullanıcı adının zaten kullanımda olup olmadığını doğrulaması gerekebilir. 

Uzaktan doğrulamayı uygulamak için: 

1. JavaScript 'e çağırmak için bir eylem yöntemi oluşturun. JOuery Validate uzak 
YÖNTEMİ bir JSON yanıtı bekliyor: 


• 

"true" , 

giriş verilerinin geçerli olduğu anlamına gelir. 

• 

"false" 

, undefined veya 

null 

, girişin geçersiz olduğu anlamına gelir. Varsayılan 


hata iletisini görüntüler. 

• Diğer herhangi bir dize, girişin geçersiz olduğu anlamına gelir. Dizeyi özel bir hata 


iletisi olarak görüntüleyin. 

Özel bir hata iletisi döndüren eylem yöntemine bir örnek aşağıda verilmiştir: 






[AcceptVerbs("Get", "Post")] 

public IActionResult VerifyEmail(string email) 

{ 

if (!_userRepository.VerifyEmail(email)) 

{ 

return ]son($"Email {email} is alneady in use."); 

} 

netunn Ison(true); 

} 


2. Model sınıfında, aşağıdaki örnekte gösterildiği gibi, doğrulama eylemi yöntemine 
işaret eden bir [Remote] özniteliğiyle özelliğe not ekleyin: 

[Remote(action: "VenifyEmail", contnollen: "Users")] 
public stning Email { get; set; } 

[Remote] ÖZnİtel İği Microsoft.AspNetCore.Mvc ad alanıdır. Microsoft.AspNetCone.App 
veya Microsoft.AspNetcone.Aiı metapackage kullanmıyorsanız Microsoft. 

AspNetCore. Mvc. VievvFeatures NuGet paketini yükleyebilirsiniz. 

Ek alanlar 

[Remote] özniteliğinin AdditionaiFields özelliği, sunucudaki verilere karşı alan 
birleşimlerini doğrulamanızı sağlar. Örneğin, User modelinde FirstName ve LastName 
özellikler varsa, mevcut hiçbir kullanıcının bu ad çiftine sahip olmadığını doğrulamak 
isteyebilirsiniz. Aşağıdaki örnek AdditionaiFields nasıl kullanacağınızı gösterir: 

[Remote(action: "VerifyName", controller: "Users", AdditionaiFields = nameof(LastName))] 
public string FirstName { get; set; } 

[Remote(action: "VerifyName", controller: "Users", AdditionaiFields = 

nameof(FirstName))] 

public string LastName { get; set; } 

AdditionaiFields, "FirstName" ve "LastName" dizeler için açıkça ayarlanabilir, ancak 
NameOf işlecinin kullanılması daha sonra yeniden düzenlemeyi basitleştirir. Bu doğrulama 
için eylem yöntemi hem adı hem de soyadı bağımsız değişkenlerini kabul etmelidir: 

[AcceptVerbs("Get", "Post")] 

public IActionResult VerifyName(string firstName, string lastName) 

{ 

if (!_userRepository.VerifyName(firstName, lastName)) 

{ 

return lson($"A user named {firstName} {lastName} already exists."); 

} 

return Ison(true); 

} 


Kullanıcı adı veya soyadı girdiğinde JavaScript, bu ad çiftinin alındığını görmek için uzak bir 
çağrı yapar. 

iki veya daha fazla ek alanı doğrulamak için bunları virgülle ayrılmış bir liste olarak belirtin. 
Örneğin, modele bir MiddieName özelliği eklemek için, [Remote] özniteliğini aşağıdaki 
örnekte gösterildiği gibi ayarlayın: 















[Remote(action: "VerifyName", controller: "Users", AdditionalFields = nameof(FinstName) 

+ + nameof(LastName))] 

public string MiddleName { get; set; } 

Tüm öznitelik bağımsız değişkenleri gibi AdditionalFields , sabit bir ifade olmalıdır. Bu 
nedenle, AdditionalFields başlatmak için, enterpolasyonlu bir dize veya çağrı Join 
kullanmayın. 

Yerleşik özniteliklerin alternatifleri 

Yerleşik öznitelikler tarafından sağlanmayan doğrulamaya ihtiyacınız varsa şunları 
yapabilirsiniz: 

• Özel öznitelikler oluşturun. 

• IValidatableObject uygulayın. 

Özel öznitelikler 

Yerleşik doğrulama özniteliklerinin işlemeyen senaryolar için özel doğrulama öznitelikleri 
oluşturabilirsiniz. ValidationAttributedevralan bir sınıf oluşturun ve IsValid yöntemini 
geçersiz kılın. 

isVaüd yöntemi, doğrulanacak girdi olan Value adlı bir nesne kabul eder. Aşırı yükleme, 
model bağlama tarafından oluşturulan model örneği gibi ek bilgiler sağlayan 
vaüdationContext nesnesini de kabul eder. 

Aşağıdaki örnek, Klasik tarz bir filmin yayın tarihinin belirtilen yıldan daha sonra olmadığını 
doğrular. [ciassicMovie 2 ] özniteliği önce tarzı denetler ve yalnızca Klasik\se devam eder. 
Classics olarak tanımlanan filmler için, öznitelik oluşturucusuna geçirilen sınırdan daha 
sonra olmadığından emin olmak için yayın tarihini denetler.) 





public class ClassicMovieAttribute : ValidationAttribute 

{ 

private int _year; 

public ClassicMovieAttribute(int year) 

{ 

_year = year; 

> 

protected override ValidationResult IsValid( 

object value, ValidationContext validationContext) 

{ 

var movie = (Movie)validationContext.ObjectInstance; 
var releaseYear = ((DateTime)value).Year; 

if (movie.Genre == Genre.Classic && releaseYear > _year) 

{ 

return new ValidationResult(GetErrorMessage()); 

} 

return ValidationResult.Success; 

} 

public int Year => _year; 

public string GetErrorMessage() 

{ 

return $"Classic movies must have a release year no later than {_year}."; 

} 

} 


Yukarıdaki örnekteki 

movie 

değişkeni, form gönderimden verileri içeren bir Movie 

nesnesini temsil eder. 

İsValid 

yöntemi tarihi ve tarzı denetler. Doğrulama başarıyla 

tamamlandığında, isValid 

bir 

ValidationResult.Success kodu döndürür. Doğrulama 


başarısız olduğunda, hata iletisi içeren bir ValidationResult döndürülür. 


IValidatableObject 

Yukarıdaki örnek yalnızca Movie türleriyle birlikte geçerlidir. Sınıf düzeyinde doğrulama için 
başka bir seçenek de, aşağıdaki örnekte gösterildiği gibi model sınıfında 
IValidatableObject uygulamaktır: 












public class MovielValidatable : IValidatableObject 

{ 

private const int _classicYear = 1960; 

public int Id { get; set; } 

[Required] 

[StringLength(100)] 

public string Title { get; set; } 

[Required] 

public DateTime ReleaseDate { get; set; } 

[Required] 

[StringLength(1000)] 

public string Description { get; set; } 

[Range(0, 999.99)] 

public decimal Price { get; set; } 

[Required] 

public Genre Genre { get; set; } 
public bool Preorder { get; set; } 

public IEnumerable<ValidationResult> Validate(ValidationContext validationContext) 

{ 

if (Genre == Genre.Classic && ReleaseDate.Year > _classicYear) 

{ 

yield return new ValidationResult( 

$"Classic movies must have a release year earlier than {_classicYear}. 
new[] { "ReleaseDate" }); 

} 

} 

} 


Üst düzey düğüm doğrulaması 

Üst düzey düğümler şunları içerir: 

• Eylem parametreleri 

• Denetleyici özellikleri 

• Sayfa işleyici parametreleri 

• Sayfa modeli özellikleri 

Model bağlantılı üst düzey düğümler, model özelliklerini doğrulamaya ek olarak onaylanır. 
Örnek uygulamadan aşağıdaki örnekte, verifyPhone yöntemi phone eylem parametresini 
doğrulamak için RegularExpressionAttribute kullanır: 

[AcceptVerbs("Get", "Post")] 
public IActionResult VerifyPhone( 

[RegularExpression(@" A \d{3}-\d{3}-\d{4}$")] string phone) 

{ 

if (IModelState.IsValid) 

{ 

return Json($"Phone {phone} has an invalid format. Format: ###-###-####"); 

} 

return Ison(true); 

} 






Üst düzey düğümler, doğrulama öznitelikleri ileBindRequiredAttribute kullanabilir. Örnek 
uygulamadan aşağıdaki örnekte, checkAge yöntemi, form gönderildiğinde age 
parametresinin sorgu dizesinden bağlanması gerektiğini belirtir: 


[HttpPost] 

public IActionResult CheckAge( 


[BindRequired, FromQuery] 

{ 

int age) 




Denetim yaşı sayfasında ( Checkage. cshtmO iki form vardır, ilk form bir 

99 

Age 

değerini 

bir sorgu dizesi olarak gönderir: 

https://localhost:5001/Users/CheckAgePAge; 

=99 . 



Sorgu dizesinden düzgün şekilde biçimlendirilen bir age parametresi gönderildiğinde, 
form doğrular. 

Denetim yaşı sayfasındaki ikinci form, isteğin gövdesinde Age değerini gönderir ve 
doğrulama başarısız olur, age parametresi bir sorgu dizesinden gelmiş olması 
gerektiğinden bağlama başarısız olur. 

compatibilityVersion.version_ 2 _ı veya sonraki sürümleriyle çalışırken, en üst düzey düğüm 
doğrulama varsayılan olarak etkindir. Aksi takdirde, üst düzey düğüm doğrulaması devre 
dışı bırakılır. Varsayılan seçenek, burada gösterildiği gibi, ( startup.configureServices ) içinde 
AllovvValidatingTopLevelNodes özelliği ayarlanarak geçersiz kılınabilir: 

Services.AddMvc(options => 

{ 

options.MaxModelValidationErrors = 50; 
options. AllowValidatingTopLevelNodes = false; 

}) 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 


En fazla hata sayısı 

En fazla hata sayısına ulaşıldığında doğrulama durduruluyor (varsayılan olarak 200). Bu 
numarayı Startup.configureServices aşağıdaki kodla yapılandırabilirsiniz: 

Services.AddMvc(options => 

{ 

options.MaxModelValidationErrors = 50; 

options.ModelBindingMessageProvider.SetValueMustNotBeNullAccessor( 

(_) => "The field is required."); 

}) 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

Services .AddSingleton 

cIValidationAttributeAdapterProvider, 

CustomValidationAttributeAdapterProvider>(); 


En yüksek özyineleme 

ValidationVisitor, doğrulanan modelin nesne grafiğinin altına geçer. Çok derin olan veya 
sonsuz özyinelemeli özyinelemeli modeller için, doğrulama yığın taşmasına neden olabilir. 
Mvcoptions. MaxValidationDepth , ziyaretçi özyineleme yapılandırılmış bir derinliği aşarsa 
doğrulamanın erken durdurulması için bir yol sağlar. Mvcoptions.MaxvaiidationDepth 
varsayılan değeri, CompatibilityVersion.version_2_2 veya sonraki sürümleriyle çalışırken 32 
' dir. Önceki sürümler için değer null, bu da derinlemesine bir kısıtlama kısıtlaması anlamına 














gelir. 


Otomatik kısa devre 

Model grafı doğrulama gerektirmiyorsa, doğrulama otomatik olarak kısa devre dışı 
(atlandı). Çalışma zamanının, herhangi bir Doğrulayıcıları olmayan byte[] , string[] , 
Dictionary<string, string> ) ve karmaşık nesne grafikleri dahil olmak üzere doğrulamayı 
atlayan nesneler. 

Doğrulamayı devre dışı bırak 

Doğrulamayı devre dışı bırakmak için: 

1. Hiçbir alanı geçersiz olarak işaretlememeyen bir ıobjectModeivaiidator 
uygulamasını oluşturun. 

public class NullObjectModelValidator : IObjectModelValidator 
{ 

public void Validate( 

ActionContext actionContext , 

ValidationStateDictionary validationState, 
string prefix, 
object model) 

{ 

} 

} 

2. Bağımlılık ekleme kapsayıcısında varsayılan ıobjectModeivaiidator uygulamasını 
değiştirmek için startup.configureServices aşağıdaki kodu ekleyin. 

// There is only one 'IObjectModelValidator' object, 

// so AddSingleton replaces the default one. 

Services.AddSingleton<IObjectModelValidator>(new NullObjectModelValidator()); 


Model bağlamalarından kaynaklanan model durumu hatalarını görmeye devam 
edebilirsiniz. 

İstemci tarafı doğrulaması 

istemci tarafı doğrulama, form geçerli olana kadar gönderimi önler.Gönder düğmesi, formu 
gönderen veya hata iletilerini görüntüleyen JavaScript 'ı çalıştırır. 

Bir form üzerinde giriş hataları olduğunda, istemci tarafı doğrulaması sunucuya gereksiz 
gidiş dönüş önler._/.oyouf. cshtml \/e_ValidationScriptsPartial. cshtml ' deki aşağıdaki betik 
başvuruları istemci tarafı doğrulamayı destekler: 

<script src=" https://cdnjs.cloudflare.eom/ajax/libs/jquery/3.3.l/jquery.min.js"> 
</script> 


<script src="https://cdnjs. cloudflare.com/ajax/libs/jquery- 
validate/1.17.0/jquery.validate.min. js"x/script> 

<script src="https://cdnjs. cloudflare.com/ajax/libs/ jquery-validation- 
unobtrusive/3.2.11/jquery .validate.unobtrusive.min. js"x/script> 


JQuery unobtrusive doğrulama betiği, popüler jQuery Validate eklentisi üzerinde derleme 









yapan özel bir Microsoft ön uç kitaplığıdır. JQuery unobtrusive doğrulaması olmadan, iki 
yerde aynı doğrulama mantığını kodlamakta olmanız gerekir: model özelliklerindeki 
Sunucu tarafı doğrulama özniteliklerinde bir kez ve sonra istemci tarafı betiklerimizde. 
Bunun yerine, Etiket Yardımcıları ve HTML Yardımcıları , doğrulama GEREKTİREN form 
öğeleri için HTML 5 data- özniteliklerini işlemek üzere model özelliklerinden doğrulama 
özniteliklerini ve tür meta verilerini kullanır. jQuery unobtrusive doğrulaması data- 
özniteliklerini ayrıştırır ve mantığı, sunucu tarafı doğrulama mantığını istemciye, etkin 
şekilde "kopyalamak" amacıyla jQuery doğrulamasına geçirir. Aşağıda gösterildiği gibi, 
etiket yardımcıları kullanarak istemcisinde doğrulama hatalarını görüntüleyebilirsiniz: 

<div class="form-group"> 

clabel asp-for="ReleaseDate" class="col-md-2 control-label"x/label> 

<div class="col-md-10"> 

<input asp-for="ReleaseDate" class="form-control" /> 

<span asp-validation-for="ReleaseDate" class="text-danger"x/span> 

</div> 

</div> 

Önceki etiket yardımcıları aşağıdaki HTML 'yi işler. 

<form action="/Movies/Create" method="post"> 

<div class="form-horizontal"> 

<h4>Movie</h4> 

<div class="text-danger"x/div> 

<div class="form-group"> 

<label class="col-md-2 control-label" for="ReleaseDate">ReleaseDate</label> 
<div class="col-md-10"> 

<input class="form-control" type="datetime" 

data-val="true" data-val-required="The ReleaseDate field is required." 
id="ReleaseDate" name="ReleaseDate" value=""> 

<span class="text-danger field-validation-valid" 

data-valmsg-for="ReleaseDate" data-valmsg-replace="true"x/span> 

</div> 

</div> 

</div> 

</form> 

HTML çıkışındaki data- özniteliklerinin ReleaseDate özelliğinin doğrulama özniteliklerine 
karşılık geldiğini unutmayın. data-vai-required özniteliği, Kullanıcı Yayın tarihi alanını 
doldurmazsa görüntülenecek bir hata iletisi içerir, jöuery unobtrusive doğrulaması bu 
değeri jöuery Validate Required () yöntemine geçirir ve sonra bu iletiyi eşlik eden <span > 
öğesinde görüntüler. 

Veri türü doğrulama, bir [DataType] özniteliği tarafından geçersiz kılınmadıkça, özelliğin 
.NET türünü temel alır. Tarayıcıların kendi varsayılan hata iletileri vardır ancak jöuery 
doğrulaması unobtrusive doğrulama paketi bu iletileri geçersiz kılabilir. [EmailAddress] gibi 
öznitelikleri ve alt sınıfları [DataType] , hata iletisini belirtmenize izin verir. 

Dinamik formlara doğrulama ekleme 

jöuery unobtrusive doğrulaması, sayfa ilk yüklendiğinde jöuery doğrulaması için 
doğrulama mantığını ve parametreleri geçirir. Bu nedenle, doğrulama dinamik olarak 
üretilen formlarda otomatik olarak çalışmaz. Doğrulamayı etkinleştirmek için, jöuery 'ten 
kaçınmaya yönelik doğrulamayı, dinamik formu oluşturduktan hemen sonra ayrıştırmaya 
söyleyin. Örneğin, aşağıdaki kod, AJAX aracılığıyla eklenen bir formda istemci tarafı 
doğrulamayı ayarlar. 












$-get({ 

url: "https://url/that/returns/a/form", 
dataType: "html", 

error: function(jqXHR, textStatus, errorThrown) { 

alert(textStatus + Couldn't add form. " + errorThrown); 

}, 

success: function(newFormHTML) { 

var Container = document.getElementById("form-container"); 

Container.insertAdjacentHTML("beforeend"j newFormHTML); 
var forms = Container.getElementsByTagName("form"); 
var newForm = forms[forms.length - 1]; 

$.validator.unobtrusive.parse(newForm); 

} 

}) 

$. vaüdator.unobtrusive.parse() yöntemi bir bağımsız değişkeni için jQuery seçiciyi kabul 
eder. Bu yöntem, jQuery 'in bu seçicideki formların data- özniteliklerini ayrıştırmasına izin 
vermez. Daha sonra bu özniteliklerin değerleri jQuery Validate eklentisine geçirilir. 

Dinamik denetimlere doğrulama ekleme 

$.vaiidator.unobtrusive.parse() yöntemi, <input> ve <seiect/> gibi tek dinamik olarak 
oluşturulan denetimlerde değil, formun tamamına göre çalışmaktadır. Formu yeniden 
oluşturmak için, aşağıdaki örnekte gösterildiği gibi, form daha önce ayrıştırdığında eklenen 
doğrulama verilerini kaldırın: 

$-get({ 

url: "https://url/that/returns/a/control ", 
dataType: "html", 

error: function(jqXHR, textStatus, errorThrown) { 

alert(textStatus + ": Couldn't add control. " + errorThrown); 

}, 

success: function(newInputHTML) { 

var form = document.getElementById("my-form"); 
form.insertAdjacentHTML("beforeend ", newInputHTML); 

$(form).removeData("valldator") // Added by jQuery Validate 

.removeData("unobtrusiveValidation"); // Added by jQuery Unobtrusive 

Validation 

$.validator.unobtrusive.parse(form); 

} 

}) 


Özel istemci tarafı doğrulaması 

Özel istemci tarafı doğrulama işlemi, özel bir jöuery Validate bağdaştırıcısıyla çalışan 
data- HTML öznitelikleri oluşturarak yapılır.Aşağıdaki örnek bağdaştırıcı kodu, bu 
makalede daha önce sunulan ciassicMovie ve ciassicMovie2 öznitelikleri için yazılmıştır: 










$.validator.addMethod('classicmovie', 
function (value, element, params) { 

// Get element value. Classic genre has value '0'. 
var genre = $(params[0]).val(), 
year = paramsfl], 
date = new Date(value); 

if (genre && genre.length > 0 && genre[0] === '0') { 

// Since this is a classic movie, invalid if release date is after given 

year. 

return date.getUTCFullYear() <= year; 

} 

return true; 

}); 

$. validator.unobtrusive.adapters.add('classicmovie', 

['year'L 

function (options) { 

var element = $(options.form).find('select#Genre')[0]; 

options.rules['classicmovie'] = [elementj parseInt(options.params['year' ])]; 
options,messages['classicmovie'] = options.message; 

}); 


Bağdaştırıcıların nasıl yazılacağı hakkında daha fazla bilgi için jQuery Validate 
belgelerinebakın. 

Belirli bir alan için bir bağdaştırıcının kullanımı, data- öznitelikleri tarafından tetiklenir: 

• Alana, doğrulamaya tabi olacak şekilde bayrak ekleyin ( data-vai="true" ). 

• Bir doğrulama kuralı adı ve hata iletisi metni (örneğin, 

data-val-rulename="Error message." ) belirler. 

• Doğrulayıcı ihtiyaçlarına ek parametreler sağlayın (örneğin, 

data-val-rulename-parml="value" ). 


Aşağıdaki örnek, örnek uygulamanın ciassicMovie özniteliği için data- özniteliklerini 
gösterir: 

<input class="form-control" type="datetime" 
data-val="true" 

data-val-classicmoviel="Classic movies must have a release year earlier than 1960." 
data-val-classicmovlel-year="1960" 

data-val-required="The ReleaseDate field İs required." 
id="ReleaseDate" name="ReleaseDate" value=""> 

Daha önce belirtildiği gibi, Etiket Yardımcıları ve HTML Yardımcıları data- öznitelikleri 
işlemek için doğrulama özniteliklerinden bilgi kullanır. Özel data- HTML özniteliklerinin 
oluşturulmasına neden olan kod yazmak için iki seçenek vardır: 

• AttributeAdapterBase<TAttribute> ve IValidationAttributeAdapterProvider uygulayan bir 
sınıftan türeten bir sınıf oluşturun ve özniteinizi ve bağdaştırıcısını dı olarak kaydedin. Bu 
yöntem, sunucu ile ilgili ve istemciyle ilgili doğrulama kodundaki tek sorumluluk 
sorumlusunu , ayrı sınıflarda izler. Ayrıca bağdaştırıcı, Dİ ' de kaydolduğundan bu yana 
de bunun avantajına sahiptir. 

• validationAttribute sınıfınıza ıciientModeivaiidator uygulayın. Bu yöntem, öznitelik 
herhangi bir sunucu tarafı doğrulaması yapamazsa ve hiçbir hizmete gerek duymazsa 
uygun olabilir. 

İstemci tarafı doğrulaması için AttributeAdapter 
















HTML'de data- öznitelikleri işleme yöntemi, örnek uygulamadaki ciassicMovie özniteliği 
tarafından kullanılır. Bu yöntemi kullanarak istemci doğrulaması eklemek için: 

1. Özel doğrulama özniteliği için bir öznitelik bağdaştırıcı sınıfı oluşturun. Özniteliği 
Attributeadapterbasect >'dan türeten. Aşağıdaki örnekte gösterildiği gibi, işlenen 
çıktıya data- öznitelikleri ekleyen bir Addvalidation yöntemi oluşturun: 

public class ClassicMovieAttributeAdapter : 
AttributeAdapterBase<ClassicMovieAttribute> 

{ 

private int _year; 

public ClassicMovieAttributeAdapter(ClassicMovieAttribute attribute, 
IStringLocalizer stringLocalizer) : base (attribute, stringLocalizer) 

{ 

_year = attribute.Year; 

} 

public override void AddValidation(ClientModelValidationContext context) 

{ 

if (context == null) 

{ 

throw new ArgumentNullException(nameof(context)); 

} 

MergeAttribute(context.Attributes, "data-val", "true"); 
MergeAttribute(context.Attributes, "data-val-classicmovie", 
GetErrorMessage(context)); 

var year = Attribute.Year.ToString(Culturelnfo.InvariantCulture); 
MergeAttribute(context.Attributes, "data-val-classicmovie-year", year); 

} 

public override string GetErrorMessage(ModelValidationContextBase 
validationContext) 

{ 

return Attribute.GetErrorMessage(); 

} 

} 


2. IValidationAttributeAdapterProvideruygulayan bir bağdaştırıcı sağlayıcısı sınıfı 
oluşturun. GetAttributeAdapter yöntemi, aşağıdaki örnekte gösterildiği gibi, özel 
özniteliğini bağdaştırıcının oluşturucusuna geçirin: 

public class CustomValidationAttributeAdapterProvider : 
IValidationAttributeAdapterProvider 

{ 

IValidationAttributeAdapterProvider baseProvider = 
new ValidationAttributeAdapterProvider(); 
public IAttributeAdapter GetAttributeAdapter(ValidationAttribute attribute, 
IStringLocalizer stringLocalizer) 

{ 

if (attribute is ClassicMovieAttribute classicMovieAttribute) 

{ 

return new ClassicMovieAttributeAdapter(classicMovieAttribute, 
stringLocalizer); 

} 

else 

{ 

return baseProvider.GetAttributeAdapter(attribute , stringLocalizer); 

} 

} 

} 


3. Dı için bağdaştırıcı sağlayıcısını startup.configureServices Kaydet: 










Services.AddMvc(options => 

{ 

options.MaxModelValidationErrors = 50; 

options.ModelBindingMessageProvider.SetValueMustNotBeNullAccessor( 
(_) => "The field is required."); 

}) 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

Services .AddSingleton 

cIValidationAttributeAdapterProvider, 
CustomValidationAttributeAdapterProvider>(); 


İstemci tarafı doğrulaması için ılientmodelvalidator 

HTML'de data- öznitelikleri işleme yöntemi, örnek uygulamadaki ciassicMovie 2 
özniteliği tarafından kullanılır. Bu yöntemi kullanarak istemci doğrulaması eklemek için 

• Özel doğrulama özniteliğinde ıciientModeivaiidator arabirimini uygulayın ve bir 
Addvalidation yöntemi oluşturun. Addvalidation yönteminde, aşağıdaki örnekte 
gösterildiği gibi, doğrulama için data- öznitelikleri ekleyin: 








public class ClassicMovie2Attribute : ValidationAttribute, IClientModelValidator 

{ 

private int _year; 

public ClassicMovie2Attribute(int year) 

{ 

_year = year; 

> 

protected override ValidationResult IsValid( 

object value, ValidationContext validationContext) 

{ 

var movie = (Movie)validationContext.ObjectInstance; 
var releaseYear = ((DateTime)value).Year; 

if (movie.Genre == Genre.Classic && releaseYear > _year) 

{ 

return new ValidationResult(GetErrorMessage()); 

} 

return ValidationResult.Success; 

} 

public void AddValidation(ClientModelValidationContext context) 

{ 

if (context == null) 

{ 

throw new ArgumentNullException(nameof(context)); 

} 

MergeAttribute(context.Attributes, "data-val", "true"); 
MergeAttribute(context.Attributes, "data-val-classicmovie", 
GetErrorMessage()); 

var year = _year.ToString(CultureInfo.InvariantCulture); 
MergeAttribute(context.AttributeSj "data-val-classicmovie-year", year); 

} 

private bool MergeAttribute(IDictionary<stringj string> attributes^ string 
key, string value) 

{ 

if (attributes.ContainsKey(key)) 

{ 

return false; 

} 

attributes.Add(keyj value); 
return true; 

} 

protected string GetErrorMessage() 

{ 

return $"Classic movies must have a release year no later than {_year} 
[from attribute 2]."; 

} 


İstemci tarafı doğrulamayı devre dışı bırak 


Aşağıdaki kod, MVC görünümlerinde istemci doğrulamasını devre dışı bırakır: 



Services.AddMvc().AddViewOptions(options => 

{ 

if (_env.IsDevelopment()) 

{ 

options.HtmlHelperOptions.ClientValidationEnabled = false; 

} 

}); 

Ve Razor Pages: 

Services.Configure<HtmlHelperOptions>(o => o.ClientValidationEnabled = false); 

İstemci doğrulamasını devre dışı bırakmaya yönelik başka bir seçenek de,. cshtml 
dosyanızdaki _vaiidationScriptsPartiai başvurusunu açıklamaya yöneliktir. 

Ek kaynaklar 

• System. ComponentModel. Dataaçıklamalarda ad alanı 

• Model Bağlamaları 





ASRNET Core MVC için uyumluluk sürümü 
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Tarafından Rick Anderson 

Yöntemi SetCompatibilityVersion , AS P.N ET Core 3,0 uygulamaları için bir op değildir. Diğer bir deyişle, 
Setcompatibilityversion herhangi bir CompatibilityVersion değeriyle çağırmak uygulama üzerinde hiçbir 
etkiye sahip değildir. 

• ASP.NET Core sonraki küçük sürümü yeni CompatibilityVersion bir değer sağlayabilir. 

• CompatibilityVersion Üzerinden Version_2_0 değerler Version_2_2 işaretlenir. [Obsolete(...)] 

• Bkz. Antiforgery, CORS, Diagnostics, MVC ve yönlendirme İÇİNDEKİ API değişikliklerini bozma. Bu 
liste, uyumluluk anahtarlarına yönelik son değişiklikleri içerir. 

ASP.NET Core 2. Setcompatibilityversion x uygulamalarıyla nasıl çalıştığını görmek için, Bu makalenin 
ASP.NET Core 2,2 sürümünüseçin. 

Yöntemi SetCompatibilityVersion , AS P.N ET Core 2. x uygulamasının, ASP.NET Core MVC 2,1 veya 2,2 ' 
de ortaya çıkan olası davranış değişikliklerinin kabul veya devre dışı olmasına olanak sağlar. Bu olası 
davranışı ortadan kaldırma, MVC alt sisteminin davranışını ve kodunuzun çalışma zamanı tarafından 
nasıl çağrıldığını gösterir.' De, en son davranışı ve ASP.NET Core uzun vadeli davranışını alırsınız. 

Aşağıdaki kod uyumluluk modunu ASP.NET Core 2,2 olarak ayarlar: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

} 

Uygulamanızı en son sürümü ( CompatibilityVersion.Latest ) kullanarak test etmenizi öneririz. Çoğu 
uygulamanın en son sürümü kullanarak önemli davranış değişikliklerinin olmadığı tahmin ederiz. 

Çağıran Setcompatibiiityversion(compatibiiityversion.version_2_0) uygulamalar, ASP.NET Core 2.1/2.2 
MVC sürümlerinde tanıtılan büyük olasılıkla davranış değişikliklerinden korunmaktadır. Bu koruma: 

• Tüm 2,1 ve sonraki değişikliklere uygulanmaz, MVC alt sisteminde çalışma zamanı davranış 
değişikliklerinin ASP.NET Core büyük olasılıkla bozmasına yöneliktir. 

• ASP.NET Core 3,0 1 ye genişlemez. 

ASP.NET Core 2,1 ve 2,2 olmayan Setcompatibilityversion uygulamalar için varsayılan uyumluluk, 2,0 
uyumluluğuna yöneliktir. Diğer bir deyişle, Setcompatibilityversion çağırma 
SetCompatibilityVersion(CompatibilityVersion.Version_2_0) ile ayni değildir. 

Aşağıdaki kod, uyumluluk modunu aşağıdaki davranışlar dışında 2,2 ASP.NET Core olarak ayarlar: 

• AliovvCombiningAuthorizeFiiters 

• lnputFormatterExceptionPolicy 













public void ConfigureServices(IServiceCollection Services) 

{ 

Services .AddMvc() 

// Include the 2.2 behaviors 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2) 

// Except for the following. 

.AddMvcOptions(options => 

{ 

// Don't combine authorize filters (keep 2.0 behavior). 
options.AllowCombiningAuthorizeFilters = false; 

// Ali exceptions thrown by an IInputFormatter are treated 
// as model State errors (keep 2.0 behavior). 
options.InputFormatterExceptionPolicy = 

InputFormatterExceptionPolicy.AllExceptions; 

}); 

} 


Doğru uyumluluk anahtarlarını kullanarak, bölme davranışı ile ilgili olan uygulamalar için: 

• En son sürümü kullanmanıza ve belirli bir bölme davranışı değişikliğini geri yüklemenize olanak tanır. 

• , Uygulamanızı en son değişikliklerle çalışacak şekilde güncelleştirmeniz için size zaman kazandırır. 

MvcOptions Belgelerde nelerin değiştiğini ve değişikliklerin çoğu kullanıcı için nasıl gelişdiğinin iyi bir 
açıklaması vardır. 

ASP.NET Core 3,0 ile, uyumluluk anahtarları tarafından desteklenen eski davranışlar kaldırılmıştır.Bunlar, 
neredeyse tüm kullanıcılar faydalanmasını olumlu değişiklikler olduğunu hissettik. Bu değişiklikleri 2,1 ve 
2,2 1 de sunarak, çoğu uygulama yararlı olabilir, diğerleri ise güncelleştirilmeye zaman alabilir. 




Özel ASRNET Core ara yazılımı yaz 
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By Rick Anderson ve Steve Smith 

Ara yazılım, istekleri ve yanıtları işlemek için bir uygulama ardışık düzenine çevrilmiş yazihmdir.ASP.NET Core, 
zengin bir yerleşik ara yazılım bileşenleri kümesi sağlar, ancak bazı senaryolarda özel bir ara yazılım yazmak 
isteyebilirsiniz. 

Ara yazılım sınıfı 

Ara yazılım genellikle bir sınıfta kapsüllenir ve bir genişletme yöntemiyle birlikte sunulur. Bir sorgu dizesinden 
geçerli istek için kültürü ayarlayan aşağıdaki ara yazılımı göz önünde bulundurun: 

public class Startup 
{ 

public void Configure(IApplicationBuilder app) 

{ 

app.Use(async (context, next) => 

{ 

var cultureQuery = context.Request.Query["culture"]; 
if (!string.IsNullOrWhiteSpace(cultureQuery)) 

{ 

var culture = new CultureInfo(cultureQuery); 

Culturelnfo.CurrentCulture = culture; 

Culturelnfo.CurrentUICulture = culture; 

} 

// Cali the next delegate/middleware in the pipeline 
await next(); 

}); 

app.Run(async (context) => 

{ 

await context.Response.WriteAsync( 

$"Hello {Culturelnfo.CurrentCulture.DisplayName}"); 

}); 

} 

} 

Yukarıdaki örnek kod, bir ara yazılım bileşeni oluşturmayı göstermek için kullanihr.ASP.NET Core yerleşik 
yerelleştirme desteği için bkz AS P.N ET Core Genelleştirme ve yerelleştirme. 

Kültürü geçirerek, ara yazılımı test edin. Örneğin, istek https://iocaihost:500i/?cuiture=no . 

Aşağıdaki kod, ara yazılım temsilcisini bir sınıfa taşıtabilirler: 







using Microsoft.AspNetCore.Http; 
using System.Globalization; 
using System.Threading.Tasks; 

namespace Culture 
{ 

public class RequestCultureMiddleware 
{ 

private readonly RequestDelegate _next; 

public RequestCultureMiddleware(RequestDelegate next) 

{ 

_next = next; 

} 

public async Task InvokeAsync(HttpContext context) 

{ 

var cultureQuery = context.Request.Query["culture "]; 
if (!string.IsNullOrWhiteSpace(cultureQuery)) 

{ 

var culture = new CultureInfo(cultureQuery); 

Culturelnfo.CurrentCulture = culture; 

Culturelnfo.CurrentUICulture = culture; 

} 

// Cali the next delegate/middleware in the pipeline 
await _next(context); 

} 

} 

} 

Ara yazılım sınıfı şunları içermelidir: 

• Türünde RequestDelegatebir parametreye sahip ortak Oluşturucu. 

• invoke Veya invokeAsync adlı bir genel yöntem. Bu yöntem şunları içermelidir: 
o Bir Task döndürür. 

o Türünde HttpContextbir ilk parametreyi kabul edin. 

Oluşturucuya yönelik ek invoke parametreler ve / invokeAsync bağımlılık ekleme (dı)tarafından doldurulur. 

Ara yazılım bağımlılıkları 

Ara yazılım, bağımlılıklarındaki bağımlılıklarını açığa çıkararak Açık bağımlılıklar ilkesini izlemelidir. Ara yazılım, 
uygulama ömrü başına bir kez oluşturulur. Bir istek içindeki ara yazılım ile hizmetleri paylaşmanız gerekiyorsa, 

İstek başına ara yazılım bağımlılıkları bölümüne bakın. 

Ara yazılım bileşenleri, bağımlılık ekleme (dı) öğesinden Oluşturucu parametreleri aracılığıyla bağımlılıklarını 
çözümleyebilir. Useara<yazılım> T ayrıca ek parametreleri doğrudan kabul edebilir. 

İstek başına ara yazılım bağımlılıkları 

Ara yazılım uygulama başlangıcında oluşturulduğundan, isteğe göre değil, ara yazılım oluşturucuları tarafından 
kullanılan kapsamlı ömür Hizmetleri, her istek sırasında bağımlılığı eklenen diğer türlerle paylaşılmaz. Bir 
kapsamlı hizmeti, ara yazılım ve diğer türler arasında paylaşmanız gerekiyorsa, bu Hizmetleri invoke metodun 
imzasına ekleyin. Yöntemi invoke , dı tarafından doldurulan ek parametreleri kabul edebilir: 









public class CustomMiddleware 
{ 

private readonly RequestDelegate _next; 

public CustomMiddİ 0 war 8 (RequestDeİ 0 gate n 0 xt) 

{ 

_n 0 xt = naxt; 

} 

// IMyScop 0 dS 0 rvic 0 is İnj 0 ct 0 d into Invok 0 

public async Task Invok 0 (HttpCont 0 xt httpCont 0 xtj IMyScopodSorvico svc) 
{ 

svc.MyProparty = 1000; 
await _n 0 xt(httpCont 0 xt); 

} 


Ara yazılım genişletme yöntemi 

Aşağıdaki genişletme yöntemi, ara yazılımı aracılığıyla lApplicationBuilderkullamma sunar: 

using Microsoft.AspNotCoro.Buildor; 

namospaco Culturo 
{ 

public static class R 0 qu 0 stCultur 0 Middİ 0 war 0 Ext 0 nsions 
{ 

public static IApplicationBuildor Us 0 R 0 qu 0 stCultur 0 ( 
this IApplicationBuildor buildor) 

{ 

roturn buildor.Us 0 Middİ 0 war 0 <R 0 qu 0 stCultur 0 Middİ 0 war 0 >(); 

} 

} 

} 

Aşağıdaki kod, içindeki startup.configuro ara yazılımı çağırır: 

public class Startup 
{ 

public void Configur 0 (IApplicationBuild 0 r app) 

{ 

app.Us 0 R 0 qu 0 stCultur 0 (); 

app.Run(async (contaxt) => 

{ 

await cont 0 xt.R 0 spons 0 .Writ 0 Async( 

$"H 0 İlo {CulturoInfo.CurrontCulturo.DisplayNamo}"); 

}); 

} 

} 


Ek kaynaklar 

• ASP.NET Core ara yazılımı 

• AS P.N ET Core ara yazılıma HTTP işleyicileri ve modülleri geçirme 

• ASP.NET Core 'de uygulama başlatma 

• ASP.NET core'da istek özellikleri 

• AS P.N ET Core 'de fabrika tabanlı ara yazılım etkinleştirmesi 






AS P.N ET Core bir üçüncü taraf kapsayıcısı ile ara yazılım etkinleştirme 


ASPNET Core 'de istek ve yanıt işlemleri 

19.09.2019 • 6 minutes to read ı Edjt Online 


, Kotin Kotalik tarafından 

Bu makalede, istek gövdesinden okuma ve yanıt gövdesine yazma işlemleri açıklanmaktadır. Bu işlemler için kod, 
ara yazılım yazılırken gerekli olabilir, işlemler MVC ve Razor Pages tarafından işlendiği için, yazma ara yazılımı 
dışında, özel kod genellikle gerekli değildir. 

istek ve yanıt gövdelerinin iki soyutlamaları vardır: Stream ve. Pipe İstek okuma için, HttpReguest. Body bir 



işlem hatları akışlar üzerinde önerilir. Akışlar bazı basit işlemler için daha kolay olabilir, ancak işlem hatları 
performans avantajına sahiptir ve çoğu senaryoda daha kolay kullanılır. AS P.N ET Core dahili akışlar yerine işlem 
hatlarını kullanmaya başlıyor. Örnekler: 

• FormReader 

• TextReader 

• TextWriter 

• HttpResponse.l/driteAsync 

Akışlar çerçeveden kaldırılmıyor.Akışlar .net genelinde çalışmaya devam eder ve birçok akış türü, Filestreams ve 
ResponseCompression gibi kanal eşdeğerlerine sahip değildir. 

Stream örnekleri 

Hedefin, yeni satırları bölerek tüm istek gövdesini bir dizeler listesi olarak okuyan bir ara yazılım oluşturduğunu 
varsayalım. Basit bir akış uygulamasının aşağıdaki örnekteki gibi görünebilir: 







private async Task<List<string>> GetListOfStringsFromStream(Stream requestBody) 

{ 

// Build up the request body in a string builder. 

StringBuilder builder = new StringBuilder(); 

// Rent a shared buffer to write the request body into. 
byte[] buffer = ArrayPool<byte>.Shared.Rent(4096); 

while (true) 

{ 

var bytesRemaining = await requestBody.ReadAsync(buffer, offset: 0 , buffer.Length); 
if (bytesRemaining == 0) 

{ 

break; 

} 

// Append the encoded string into the string builder. 

var encodedString = Encoding.UTF8.GetString(buffer, 0 , bytesRemaining); 

builder.Append(encodedString); 

} 

ArrayPool<byte>.Shared.Return(buffer); 
var entireRequestBody = builder.ToStringO; 

// Split on \n in the string. 

return new List<string>(entireRequestBody.Split("\n")); 


Bu kod işe yarar ancak bazı sorunlar vardır: 

• ' A eklemeden önce, örnek hemen oluşturulan başka bir dize encodedString () oluşturur. StringBuilder Bu işlem 
akıştaki tüm baytlar için gerçekleşir, bu nedenle sonuç, tüm istek gövdesinin boyutunun fazladan bellek 
ayırmasından oluşur. 

• Örnek, yeni satırlara bölmeden önce tüm dizeyi okur. Bayt dizisindeki yeni satırları denetlemek daha etkilidir. 


Yukarıdaki sorunlardan bazılarını düzelten bir örnek aşağıda verilmiştir: 





private async Task<List<string>> GetListOfStringsFromStreamMoreEfficient(Stream requestBody) 

{ 

StringBuilder builder = new StringBuilder(); 
byte[] buffer = ArrayPool<byte>.Shared.Rent(4096); 

List<string> results = new List<string>(); 

while (true) 

{ 

var bytesRemaining = await requestBody.ReadAsync(buffer, offset: 0, buffer.Length); 

if (bytesRemaining == 0) 

{ 

break; 

} 

// Instead of adding the entire buffer into the StringBuilder 
// only add the remainder after the last \n in the array. 
var prevlndex = 0 ; 
int index; 
while (true) 

{ 

index = Array.IndexOf(buffer, (byte)'\n'); 
if (index == -1) 

{ 

break; 

} 

var encodedString = Encoding.UTF8.GetString(buffer, prevlndex, index); 

if (builder.Length > 0) 

{ 

// If there was a remainder in the string buffer, include it in the next string. 
results.Add(builder.Append(encodedString).ToStringO); 
builder.Clear(); 

} 

else 

{ 

results.Add(encodedString); 

} 

// Skip past last \n 
prevlndex = index + 1; 

} 

var remainingString = Encoding.UTF8.GetString(buffer, index, bytesRemaining - index); 
builder.Append(remainingString); 

} 

ArrayPool<byte>.Shared.Return(buffer); 
return results; 


Bu önceki örnek: 

• Herhangi bir StringBuilder yeni satır karakteri olmadıkça tüm istek gövdesini arabelleğe almaz. 

• Dizeye çağrı spüt yapmaz. 

Ancak, yine de bazı sorunlar vardır: 

• Yeni satır karakterleri seyrek ise, dize içinde istek gövdesinin büyük bir bölümü arabelleğe alınır. 

• Kod dizeler ( remainingString ) oluşturmaya devam eder ve bunları dize arabelleğine ekler ve bu da ek bir 
ayırmaya neden olur. 

Bu sorunlar düzeltilebilir, ancak kod çok daha karmaşık bir geliştirme sayesinde daha karmaşık hale geliyor.işlem 






hatları, en az kod karmaşıklığı ile bu sorunları çözmenin bir yolunu sağlar. 


düzenler 

Aşağıdaki örnek, ile PipeReader aynı senaryonun nasıl işlenebileceğini göstermektedir: 

private async Task<List<string>> Getl_istOfStringFromPipe(PipeReader reader) 

{ 

List<string> results = new List<string>(); 

while (true) 

{ 

ReadResult readResult = await reader.ReadAsync(); 
var buffer = readResult.Buffer; 

SequencePosition? position = null; 

do 

{ 

// Look for a EOL in the buffer 
position = buffer.PositionOf((byte)'\n'); 

if (position != null) 

{ 

var readOnlySequence = buffer.Slice(0, position.Value); 

AddStringToList(ref results, in readOnlySequence); 

// Skip the line + the \n character (basically position) 
buffer = buffer.Slice(buffer.GetPosition(l, position.Value)); 

} 

} 

while (position != null); 

// At this point, buffer will be updated to point one byte after the last 
// \n character. 

reader.AdvanceTo(buffer.Start, buffer.End); 

if (readResult.IsCompleted) 

{ 

break; 

} 

} 

return results; 

} 

private static void AddStringToList(ref List<string> results, in ReadOnlySequence<byte> readOnlySequence) 

{ 

// Separate method because Span/ReadOnlySpan cannot be used in async methods 
ReadOnlySpan<byte> span = readOnlySequence.IsSingleSegment ? readOnlySequence.First.Span : 
readOnlySequence.ToArray().AsSpan(); 

results.Add(Encoding.UTF8.GetString(span)); 

} 


Bu örnek, akışlar uygulamalarında bulunan birçok sorunu düzeltir: 

• Kullanılmayan baytları PipeReader işlediği için bir dize arabelleği gerekmez. 

• Kodlanmış dizeler doğrudan döndürülen dizeler listesine eklenir. 

• Dize oluşturma, dize tarafından kullanılan belleğin yanı sıra ( ToArray() çağrı dışında) ayırma ücretsizdir. 

Örünü 


Ve için Body heriki HttpResponse Özellikdekullamlabilir. BodyReader/Bodyl/Jriter HttpRequest Farklı bir akışa Body 









ayarlandığında, yeni bir bağdaştırıcı kümesi, her türü otomatik olarak birbirlerine uyarlar. Yeni bir akışa 
HttpRequest.Body ayarlarsanız, HttpRequest.BodyReader Otomatik olarak Sarmalanmış HttpRequest.Body yeni 
pipeReader olarak ayarlanır. 

Start Async 

HttpResponse.startAsync üstbilgilerin değiştirilemeyen ve geri çağırmaların çalıştırıldığı Onstarting belirtmek için 
kullanılır. Sunucu olarak Kestrel kullanırken startAsync .tarafından GetMemory döndürülen belleğin, PipeReader 
dış bir arabellek yerine Kestrel 'ın iç Pipe öğesine ait olduğunu garanti altına almadan önce çağrılıyor. 

Ek kaynaklar 

• System. iO. işlem hatlarını tanıtma 

• Özel ASP.NET Core ara yazılımı yaz 








ASPNET Core içinde URL yeniden yazma ara 
yazılımı 

22.08.2019 • 53 minutes to read ı Edit Online 


, Luke Latham ve MIKAEL Mengistu tarafından 

Bu belgede, ASP.NET Core uygulamalarında URL yeniden yazma ara yazılımı kullanma yönergeleriyle birlikte 
URL yeniden yazma tanıtılmaktadır. 

URL yeniden yazma, istek URL 'Lerini bir veya daha fazla önceden tanımlanmış kurala göre değiştirme işlemidir. 
URL yeniden yazma, konumların ve adreslerin sıkı bir şekilde bağlanmaması için kaynak konumları ve adresleri 
arasında bir soyutlama oluşturur. URL yeniden yazma işlemi birkaç senaryoda yararlı olur: 

• Sunucu kaynaklarını geçici olarak veya kalıcı olarak taşıyın veya değiştirin ve bu kaynakların kararlı konum 
belirleyicilerinin bakımını yapın. 

• istek işlemeyi farklı uygulamalar arasında veya bir uygulamanın alanlarında bölme. 

• Gelen isteklerde URL segmentlerini kaldırın, ekleyin veya yeniden düzenleyin. 

• Arama motoru İyileştirmesi (SEO) için genel URL 'Leri iyileştirin. 

• Ziyaretçilerin bir kaynak isteyerek döndürülen içeriği tahmin etmeye yardımcı olmak için kolay genel URL 
'Lerin kullanılmasına izin verme. 

• Güvensiz istekleri güvenli uç noktalara yönlendirin. 

• Bir dış sitenin varlığı kendi içeriğine bağlayarak başka bir sitede barındırılan statik bir varlık kullandığı Hotlink 
'i engelleyin. 


NOTE 

URL yeniden yazma, bir uygulamanın performansını azaltabilir. Uygun yerlerde kuralların sayısını ve karmaşıklığını sınırlayın. 


Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

URL yeniden yönlendirme ve URL yeniden yazma 

URL yeniden yönlendirmeye URL yeniden yazma arasındaki ifade farkı daha hafif ancak istemcilere kaynak 
sağlamak için önemli etkileri vardır. ASP.NET Core URL yeniden yazma ara yazılımı her ikisine de ihtiyacı 
verebilir. 

URL yeniden yönlendirme , istemcinin, ilk olarak istenen istemciden farklı bir adresteki kaynağa erişmesi için bir 
istemci tarafı işlemi içerir. Bu, sunucuya gidiş dönüş gerektirir, istemci kaynak için yeni bir istek yaptığında, 
istemciye döndürülen yeniden yönlendirme URL 'SI tarayıcının adres çubuğunda görüntülenir. 

/different-resource Öğesine /resource 

yön lendi ri liyorsasunucu, istemci nin,yenidenyönlendirmeningeçiciyadakalıcıolduğunubelirtenbirdurumkoduilekay 
nağıeldeetmesigerektiğiniyamtverir. /different-resource 








Request:/v1/api 
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istekleri farklı bir URL 'ye yönlendirirken, yanıtla birlikte durum kodunu belirterek yeniden yönlendirmenin kalıcı 
mi yoksa geçici mi olduğunu belirtin: 

• 301 -taşman kaUcı durum kodu, kaynağın yeni, kalıcı bir URL olduğu ve istemciye, gelecekteki tüm 
isteklerin kaynak için tüm istekleri yeni URL 'yi kullanması gerektiğini bildirmek istediğinizde kullanılır. 

İstemci, 301 durum kodu alındığmda yanıtı önbelleğe alabilir ve yeniden kullanabilir. 

• 302-bulunan durum kodu, yeniden yönlendirmenin geçici ya da genellikle değişikliğe tabi olduğu 
durumlarda kullanılır. 302 durum kodu, istemcinin URL 'Yİ depolayamadığını ve gelecekte kullanacağını 
gösterir. 

Durum kodları hakkında daha fazla bilgi için bkz RFC 2616: Durum kodu tanımları. 

URL yeniden yazma , istenen istemciden farklı bir kaynak adresinden kaynak sağlayan sunucu tarafı bir işlemdir. 
URL yeniden yazma, sunucuya gidiş dönüş gerektirmez. Yeniden yazan URL istemciye döndürülmüyor ve 
tarayıcının adres çubuğunda görünmüyor. 

/different-resource Öğesine /resource geridönerse,sunucu,kaynağınıdahili /different-resource olarak getirir ve 
döndürür. 

İstemci, yeniden yazan URL 'de kaynağı alabiliyor olsa da, istemci isteği yaptığında ve yanıtı aldığında kaynağın 
yeniden yazan URL 'de bulunduğunu bilgilendirmez. 



URL yeniden yazma örnek uygulaması 

Örnek uygulamaylabirlikte YENİDEN yazma URL 'sinin özelliklerini inceleyebilirsiniz. Uygulama yeniden 
yönlendirme ve yeniden yazma kuralları uygular ve birkaç senaryo için yeniden yönlendirilen veya yeniden yazan 
URL 'Yİ gösterir. 

URL yeniden yazma ara yazılımı ne zaman kullanılır 

Aşağıdaki yaklaşımlardan birini kullandığımmdan URL yeniden yazma ara yazılımı kullanın: 

• Windows Server 'da MS ile URL yeniden yazma modülü 

• Apache Server 'da Apache mod_rewrite modülü 

• NGINX üzerinde URL yeniden yazma 

Ayrıca, uygulama http. sys sunucusunda barındırıldığı zaman ara yazılımı kullanın (eski adıyla webListener olarak 
adlandırılır). 






















IIS, Apache ve NGINX 'te sunucu tabanlı URL yeniden yazma teknolojilerini kullanmanın başlıca nedenleri 
şunlardır: 

• Ara yazılım bu modüllerin tüm özelliklerini desteklemez. 

Sunucu modüllerinin bazı özellikleri, isFile IIS yeniden yazma modülünün ve isDirectory kısıtlamaları 
gibi ASP.NET Core projelerle birlikte çalışmaz. Bu senaryolarda, bunun yerine ara yazılımı kullanın. 

• Ara yazılım performansı büyük olasılıkla modüllerle eşleşmiyor. 

Sınama, performansı en iyi şekilde düşürür veya performans düşüklüğü göz ardı edilebilir olduğundan 
emin olmanın tek yoludur. 

Paket 

URL yeniden yazma ara yazılımı, ASP.NET Core uygulamalarında örtük olarak bulunan Microsoft. AspNetCore. 
yeniden yazma paketi tarafından sağlanır. 

Uzantı ve Seçenekler 

Yeniden yazma kurallarınızın her biri için uzantı yöntemleriyle Revvriteoptions sınıfının bir ÖRNEĞİNİ oluşturarak 
URL yeniden yazma ve yeniden yönlendirme kuralları oluşturun. Birden çok kuralı, işlenmeyi istediğiniz sırada 
zincirle., RewriteOptions ile istek ardışık düzenine eklendikçe, bu URL 'ye yeniden yazma ara yazılımı ile 

UseRevvritergeçirilir: 

public void Configure(IApplicationBuilder app) 

{ 

using (StreamReader apacheModRewriteStreamReader = 

File.OpenText("ApacheModRewrite.txt")) 
using (StreamReader iisUrlRewriteStreamReader = 

File.OpenText("IISUrlRewrite.xml")) 

{ 

var options = new RewriteOptions() 

.AddRedirect("redirect-rule/(.*)", "redirected/$l") 

.AddRewrite(@" A rewrite-rule/(\d+)/(\d +)", "rewritten?varl=$l&var2=$2", 
skipRemainingRules: true) 

.AddApacheModRewrite(apacheModRewriteStreamReader) 

.AddIISUrlRewrite(iisUrlRewriteStreamReader) 

.Add(MethodRules.RedirectXmlFileRequests) 

.Add(MethodRules.RewriteTextFileRequests) 

.Add(new RedirectImageRequests(".png", "/png-images")) 

.Add(new RedirectImageRequests(".jpg", "/jpg-images")); 

app.UseRewriter(options); 

} 

app.UseStaticFiles(); 

app.Run(context => context.Response.WriteAsync( 

$"Rewritten or Redirected Url: " + 

$"{context.Request.Path + context.Request.QueryString}")); 

} 


Www olmayan www 'e yönlendirme 

Üç seçenek, uygulamanın www www istek olmayan istekleri yeniden yönlendirmesine izin verir: 

• AddRedirectToWwwPermanentistek değilse isteği alt www etki alanına kalıcı olarak yeniden yönlendirin. 

www - Status308PermanentRedirect durum kodu ile yeniden yönlendirir. 

• AddRedirectToWwwGelen istek değilse isteği www alt etki alanına yönlendirin. www - 













Status307TemporaryRedirect durum kodu ile yeniden yönlendirir. Aşırı yükleme, yanıt için durum kodu 
sağlamanıza izin verir. Bir durum kodu ataması için StatusCodes sınıfın bir alanını kullanın. 

URL yeniden yönlendirme 

istekleri AddRedirect yeniden yönlendirmek için kullanın, ilk parametre gelen URL 'nin yolu ile eşleşen Regex 
içerir, ikinci parametre değiştirme dizesidir.Varsa, üçüncü parametre durum kodunu belirtir. Durum kodunu 
belirtmezseniz, durum kodu varsayılan olarak 302-bulunur, bu da kaynağın geçici olarak taşındığını veya 
değiştirildiğini gösterir. 

public void Configure(IApplicationBuilder app) 

{ 

using (StreamReader apacheModRewriteStreamReader = 

File.OpenText("ApacheModRewrite.txt")) 
using (StreamReader iisUrlRewriteStreamReader = 

File.OpenText("IISUrlRewrite.xml")) 

{ 

var options = new RewriteOptions() 

.AddRedirect("redirect-rule/(.*)", "redirected/$l") 

.AddRewrite(@" A rewrite-rule/(\d+)/(\d +)", "rewritten?varl=$l&var2=$2", 
skipRemainingRules: true) 

.AddApacheModRewrite(apacheModRewriteStreamReader) 

.AddIISUrlRewrite(iisUrlRewriteStreamReader) 

.Add(MethodRules.RedirectXmlFileRequests) 

.Add(MethodRules.RewriteTextFileRequests) 

.Add(new RedirectImageRequests(".png", "/png-images")) 

.Add(new RedirectImageRequests(".jpg", "/jpg-images")); 

app.UseRewriter(options); 

} 

app.UseStaticFiles(); 

app.Run(context => context.Response.WriteAsync( 

$"Rewritten or Redirected Url: " + 

$"{context.Request.Path + context.Request.QueryString}")); 

} 

Geliştirici araçları etkinleştirilmiş bir tarayıcıda, örnek uygulamaya yol /redirect-ruie/1234/5678 ile bir istek 
oluşturun. Regex, üzerindeki redirect-ruie/( .*) istek yoluyla eşleşir ve yol ile /redirected/1234/5678 
değiştirilmiştir. Yeniden yönlendirme URL 'SI, 302 tarafından bulunan bir durum kodu ile istemciye geri 
gönderilir. Tarayıcı, tarayıcının adres çubuğunda görüntülenen yeniden yönlendirme URL 'SI üzerinde yeni bir 
istek oluşturur. Örnek uygulamadaki hiçbir kural, yeniden yönlendirme URL 'SI üzerinde eşleşmediğinden: 

• ikinci istek uygulamadan 200-Tamam yanıtı alır. 

• Yanıtın gövdesi, yeniden yönlendirme URL 'sini gösterir. 

Bir URL yenidenyönlendirildiğindesunucuya gidiş dönüş yapılır. 


W ARNING 

Yeniden yönlendirme kuralları oluştururken dikkatli olun. Yeniden yönlendirme kuralları, bir yeniden yönlendirmeden sonra 
dahil olmak üzere, uygulamaya yapılan her istekte değerlendirilir. Yanlışlıkla sonsuz yeniden yönlendirmeler 
döngüsü oluşturmak kolaydır. 


Özgün İstek: /redirect-rule/1234/5678 
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A Request Headers 


Parantez içinde yer alan ifadenin kısmına bir yakalama grubu denir, ifadenin nokta ( . ), herhangi bir karakterle 
eş/eş/ranlamına gelir. Yıldız işareti ( * ), önceki karakterle sıfır veya daha fazla kez eşleşme gösterir. Bu nedenle, 
URL 1234/5678 ’nin son iki yol kesimi, yakalama grubu (.*) tarafından yakalanır. Sonrasında istek URL'sinde 
sağladığınız herhangi bir değer bu redirect-rule/ tek yakalama grubu tarafından yakalandıktan sonra. 

Değiştirme dizesinde, yakalanan gruplar, dolar işareti ( $ ) ve ardından yakalamanın sıra numarası ile birlikte 
dizeye eklenir, ilk yakalama grubu değeri ile $ı elde edilir, İkincisi ile $2 ve normal Regex yakalama grupları için 
sırayla devam eder. Örnek uygulamadaki yeniden yönlendirme kuralı Regex bölümünde yalnızca bir tane 
yakalanan grup bulunur, bu $ı nedenle değiştirme dizesinde yalnızca bir tane eklenmiş grup vardır. Kural 
uygulandığında, URL olur /redirected/1234/5678 . 

Güvenli bir uç noktaya URL yönlendirmesi 

HTTP AddRedirectToHttps isteklerini https protokolünü kullanarak aynı konağa ve yola yeniden yönlendirmek 
için kullanın. Durum kodu sağlanmazsa, ara yazılım varsayılan olarak 302-bulunur. Bağlantı noktası sağlanmazsa: 

• Ara yazılım varsayılan olarak nuiı olur. 

• Şema (https Protokolü https ) olarak değişir ve istemci, 443 numaralı bağlantı noktasında kaynağa erişir. 

Aşağıdaki örnek, durum kodunun 301-kalıcı olarak taşınacağını ve bağlantı noktasını 5001 olarak nasıl 
değiştirileceğini gösterir. 

public void Configure(IApplicationBuilder app) 

{ 

var options = new RewriteOptions() 

.AddRedirectToHttps(301, 5001); 

app.UseRewriter(options); 

} 

Güvenli AddRedirectToHttpsPermanent olmayan istekleri, bağlantı noktası 443 üzerinde güvenli https Protokolü 
ile aynı konağa ve yola yeniden yönlendirmek için kullanın. Ara yazılım durum kodunu 301 olarak ayarlar ve 
kalıcı olarak taşınır. 

public void Configure(IApplicationBuilder app) 

{ 

var options = new RewriteOptions() 

.AddRedirectToHttpsPermanent(); 

app.UseRewriter(options); 

} 

























NOTE 

Ek yeniden yönlendirme kuralları gereksinimi olmadan güvenli bir uç noktaya yönlendirilirken, HTTPS yeniden yönlendirme 
ara yazılımı kullanmanızı öneririz. Daha fazla bilgi için bkz. https 'Yi zorla konusu. 


Örnek uygulama, veya AddRedirectToHttps AddRedirectToHttpsPermanent kullanımını gösterme yeteneğine 
sahiptir. Uzantı yöntemini öğesine RewriteOptions ekleyin. Herhangi bir URL 'de uygulamaya güvenli olmayan bir 
istek oluşturun. Otomatik olarak imzalanan sertifikanın güvenilmeyen tarayıcı güvenlik uyarısını kapatın veya 
sertifikaya güvenmek için bir özel durum oluşturun. 

Kullanarak AddRedirectToHttps(301, 5001) Özgün istek: http://localhost:5000/secure 



Kullanarak AddRedirectToHttpsPermanent Özgün istek: http://localhost:5000/secur 


O localhost X + 

^ Ç_) | Certificate error localhost/secure 

Rewritten or Redirected Url: .secure 


DOM Explorer 


Network (►) 


^ ^ ^ T ’ Content type 


Name / 

Path 

secure 

httpy/localhost5000/ 

secure 

httpsv'/Iocalhost/ 


☆ — El û 


Memory -w 


Find (Ctrl -t- F) 


Result / 

Protocol Method Description 

HTTP GET 301 

Moved Permanently 

HTTPS GET 200 

OK 


Headers Body Parameters Cookies Timings 
Request URL: http://localhost5000/secure 
Request Method: GET 
Status Code: A 301 / Moved Permanently 

A Request Headers 


URL yeniden yazma 

URL AddRewrite leri yeniden yazma kuralı oluşturmak için kullanın, ilk parametre gelen URL yolundaki eşleşme 
için Regex içerir, ikinci parametre değiştirme dizesidir.Üçüncü parametresi skipRemainingRules: {true|faise} , 
geçerli kural uygulanmışsa ek yeniden yazma kurallarının atlanıp atlanmayacağını gösterir. 


























public void Configure(IApplicationBuilder app) 

{ 

using (StreamReader apacheModRewriteStreamReader = 

File.OpenText("ApacheModRewrite.txt")) 
using (StreamReader iisllrlRewriteStreamReader = 

File.OpenText("IISUrlRewrite.xml")) 

{ 

var options = new RewriteOptions() 

.AddRedirect("redirect-rule/(.*)", "redirected/$l") 

.AddRewrite(@" A rewrite-rule/(\d+)/(\d +)", "rewritten?varl=$l&var2=$2", 
skipRemainingRules: true) 

.AddApacheModRewrite(apacheModRewriteStreamReader) 

.AddIISUrlRewrite(iisUrlRewriteStreamReader) 

.Add(MethodRules.RedirectXmlFileRequests) 

.Add(MethodRules.RewriteTextFileRequests) 

.Add(new RedirectImageRequests(".png", "/png-images")) 

.Add(new RedirectImageRequestsC.jpg", "/jpg-images")); 

app.UseRewriter(options); 

} 

app.UseStaticFiles(); 

app.Run(context => context.Response.WriteAsync( 

$"Rewritten or Redirected Url: " + 

$"{context.Request.Path + context.Request.QueryString}")); 


Özgün İstek: /rewrite-rule/1234/5678 



ifadenin başındaki simgeyi seçtiğinizde A (), eşleşmesinin URL yolunun başlangıcında başladığı anlamına gelir. 

Önceki örnekte, yeniden yönlendirme kuralıyla redirect-ruie/( .*) , Regex başlangıcında simgeyi seçtiğinizde ( A 
) yoktur. Bu nedenle, başarılı bir eşleşme redirect-rule/ için herhangi bir karakterden önce yol açabilir. 

YOL EŞLEŞTİRME 

/redirect-rule/1234/5678 Evet 


/my-cool-redineçt-rule/1234/5678 


Evet 


/anotherredineçt-rule/1234/5678 


Evet 


Yeniden yazma kuralı A rewrite-ruie/(\d+)/(\d+) .yalnızca ile rewrite-ruie/ başlarsa yollarla eşleşir. Aşağıdaki 
tabloda, eşleşen farkı aklınızda. 























YOL 


EŞLEŞTİRME 


/rewrite-rule/1234/5678 

Evet 

/my-cool-rewrite-rule/1234/5678 

Hayır 

/anotherrewrite-rule/1234/5678 

Hayır 


ifadenin bölümünü takip eden iki yakalama (\d+)/(\d+) grubu vardır. A rewrite-ruie/ Belirtir bir sayıyla (sayı) 
eşleşir. \d Artı işareti ( + ) bir veya daha fazla önceki karakterden eşleşiyordemektlr. Bu nedenle, URL bir sayı 
içermeli ve ardından ileri eğik çizgi ve ardından başka bir sayı içermelidir. Bu yakalama grupları, ve olarak $ı 
yeniden $2 yazan URL 'sine eklenir.Yeniden yazma kuralı değiştirme dizesi yakalanan grupları sorgu dizesine 
koyar, istenen yolu /rewrite-ruie/i234/5678 , /rewritten?vari=i234&var2=5678 kaynağı elde etmek için yeniden 
yazılır. Özgün istekte bir sorgu dizesi varsa, URL yeniden yazdığınızda korunur. 

Kaynağı almak için sunucuya gidiş dönüş yok. Kaynak varsa, bu, alınır ve istemciye 200-ok durum kodu ile 
döndürülür, istemci yeniden yönlendirmediği için tarayıcının adres çubuğundaki URL değişmez, istemciler, 
sunucuda bir URL yeniden yazma işleminin gerçekleştiğini algılayamaz. 


NOTE 

Eşleşen skipRemainingRules: true kuralların hesaplama maliyeti ve uygulama yanıt süresini arttığı için mümkün olan her 
durumda kullanın. En hızlı uygulama yanıtı için: 

• En sık eşleşen kuraldan en az sıklıkta eşleşen kurala göre yeniden yazma kuralları. 

• Bir eşleşme gerçekleştiğinde ve ek kural işleme gerekli olmadığında kalan kuralların işlenmesini atlayın. 


Apache mod_rewrite 

ile AddApacheModRevvriteApache mod_rewrite kurallarını uygulayın. Kurallar dosyasının uygulamayla birlikte 
dağıtıldığından emin olun. Daha fazla bilgi ve mod_rewrite kuralları örnekleri için bkz. Apache mod_rewrite. 

, ApacheModRevvrite. txt kuralları dosyasındaki kuralları okumak için kullanılır: StreamReader 










public void Configure(IApplicationBuilder app) 

{ 

using (StreamReader apacheModRewriteStreamReader = 

File.OpenText("ApacheModRewrite.txt")) 
using (StreamReader iisllrlRewriteStreamReader = 

File.OpenText("IISUrlRewrite.xml")) 

{ 

var options = new RewriteOptions() 

.AddRedirect("redirect-rule/(.*)", "redirected/$l") 

.AddRewrite(@" A rewrite-rule/(\d+)/(\d +)", "rewritten?varl=$l&var2=$2", 
skipRemainingRules: true) 

.AddApacheModRewrite(apacheModRewriteStreamReader) 

.AddIISUrlRewrite(iisUrlRewriteStreamReader) 

.Add(MethodRules.RedirectXmlFileRequests) 

.Add(MethodRules.RewriteTextFileRequests) 

.Add(new RedirectImageRequests(".png", "/png-images")) 

.Add(new RedirectImageRequestsC.jpg", "/jpg-images")); 

app.UseRewriter(options); 

} 

app.UseStaticFiles(); 

app.Run(context => context.Response.WriteAsync( 

$"Rewritten or Redirected Url: " + 

$"{context.Request.Path + context.Request.QueryString}")); 


e yeniden yönlendirir. 


Örnek uygulama, İstekleri ' den /apache-mod-rules-redirect/( .\*) ' /redirected?id=$l 
Yanıt durum kodu 302-bulundu. 


# Rewrite path with additional sub directory 

RewriteRule A /apache-mod-rules-redirect/(.*) /redirected?id=$l [LjR=302] 
Özgün İstek: /apache-mod-ruies-redirect /1234 



Ara yazılım aşağıdaki Apache mod_rewrite Server değişkenlerini destekler: 

• CON N_REMOTE_ADDR 

• HTTP_ACCEPT 

• HTTP_CONNECTION 

• HTTP_COOKI E 

• HTTP_FORWARDED 

• HTTP_HOST 

• HTTP_REFERER 

















• HTTP_USER_AGENT 

• HTTPS 

• IPV6 

• QUERY_STRING 

• REMOTE_ADDR 

• REMOTE_PORT 

• REQUEST_FILENAME 

• REQUEST_METHOD 

• REQUEST_SCHEME 

• REQUEST_URI 

• SCRIPT_FILENAME 

• SERVER_ADDR 

• SERVER_PORT 

• SERVER_PROTOCOL 

• TIME 

• TIME_DAY 

• TIME_HOUR 

• TIME_MIN 

• TIME_MON 

• TIME_SEC 

• Tl M E_ W D AY 

• TIME_YEAR 

IIS URL yeniden yazma modülü kuralları 

IIS URL yeniden yazma modülü için geçerli olan kural kümesini kullanmak için kullanın AddlISUrlRevvrite. 
Kurallar dosyasının uygulamayla birlikte dağıtıldığından emin olun. Windows Server IIS 'de çalışırken 
uygulamanın Web. conflg dosyasını kullanmak için ara yazılımı yönlendirmeyin. IIS ile, IIS yeniden yazma 
modülüyle çakışmalardan kaçınmak için bu kuralların uygulamanın Web. config dosyası dışında depolanması 
gerekir. Daha fazla bilgi ve IIS URL yeniden yazma modülü kurallarının örnekleri için bkz. Using URL yeniden 
yazma modülü 2,0 ve URL yeniden yazma modülü yapılandırma başvurusu. 

, lisurlyeniden yazma. xml kuralları dosyasındaki kuralları okumak için kullanılır: StreamReader 



public void Configure(IApplicationBuilder app) 

{ 

using (StreamReader apacheModRewriteStreamReader = 

File.OpenText("ApacheModRewrite.txt")) 
using (StreamReader iisUrlRewriteStreamReader = 

File.OpenText("IISUrlRewrite.xml")) 

{ 

var options = new RewriteOptions() 

.AddRedirect("redirect-rule/(.*)", "redirected/$l") 

.AddRewrite(@" A rewrite-rule/(\d+)/(\d +)", "rewritten?varl=$l&var2=$2", 
skipRemainingRules: true) 

.AddApacheModRewrite(apacheModRewriteStreamReader) 

.AddIISUrlRewrite(iisUrlRewriteStreamReader) 

.Add(MethodRules.RedirectXmlFileRequests) 

.Add(MethodRules.RewriteTextFileRequests) 

.Add(new RedirectImageRequests(".png", "/png-images")) 

.Add(new RedirectImageRequests(".jpg", "/jpg-images")); 

app.UseRewriter(options); 

} 

app.UseStaticFiles(); 

app.Run(context => context.Response.WriteAsync( 

$"Rewritten or Redirected Url: " + 

$"{context.Request.Path + context.Request.QueryString}")); 

} 

Örnek uygulama,' den ' /iis-ruies-rewrite/( .*) e /rewritten?id=$ı olan istekleri yeniden yazar. Yanıt, istemciye 
200-ok durum kodu ile gönderilir. 

<rewrite> 

<rules> 

<rule name="Rewrite segment to id querystring" stopProcessing="true"> 

<match url=" A iis-rules-rewrite/(.*)$" /> 

<action type="Rewrite" url="rewritten?id={R:l}" appendQueryString="false"/> 

</rule> 

</rules> 

</rewrite> 

Özgün İstek: /iis-rules-rewrite/12S4 



Uygulamanızı istenmeyen yollarla etkileyebilecek sunucu düzeyi kurallara sahip etkin bir 11S yeniden yazma 
modülünüzün olması halinde, bir uygulama için 11S yeniden yazma modülünü devre dışı bırakabilirsiniz. Daha 
fazla bilgi için bkz. MS modüllerini devre dışı bırakma. 

Desteklenmeyen özellikler 

ASP.NET Core 2. x ile yayınlanan ara yazılım, aşağıdaki IIS URL yeniden yazma modülü özelliklerini desteklemez: 




















• Giden kuralları 

• Özel sunucu değişkenleri 

• Karakterlerini 

• LogRevvrittenUrl 'Si 

Desteklenen sunucu değişkenleri 

Ara yazılım aşağıdaki MS URL yeniden yazma modülü sunucu değişkenlerini destekler: 

• CONTENT_LENGTH 

• CONTENT_TYPE 

• HTTP_ACCEPT 

• HTTP_CONNECTION 

• HTTP_COOKIE 

• HTTP_HOST 

• HTTP_REFERER 

• HTTP_URL 

• HTTP_USER_AGENT 

• HTTPS 

• LOCAL_ADDR 

• QUERY_STRING 

• REMOTE_ADDR 

• REMOTE_PORT 

• REQUEST_FILENAME 

• REQUEST_URI 


NOTE 

Ayrıca bir IFileProvider PhysicalFileProviderile elde edebilirsiniz. Bu yaklaşım, yeniden yazma kuralları dosyalarınızın konumu 
için daha fazla esneklik sağlayabilir. Yeniden yazma kuralları dosyalarınızın sağladığınız yoldaki sunucuya dağıtıldığından emin 
olun. 

PhysicalFileProvider fileProvider = new PhysicalFileProvider(Directory.GetCurrentDirectory()); 


Yöntem tabanlı kural 

Bir Add yöntemde kendi kural mantığınızı uygulamak için kullanın. Add , metodunda kullanım FlttpContext için 
kullanılabilir hale getiren öğesinigösterir.RewriteContext Rewritecontext. Result, ek ardışık düzen işlemenin nasıl 
işlendiğini belirler. Değeri aşağıdaki tabloda açıklanan RuleResult alanlardan birine ayarlayın. 

REWRITECONTEXT. RESULT EYLEM 

RuleResult.continueRules varsayılanını Kuralları uygulamaya devam edin. 

RuleResult. EndResponse Kuralları uygulamayı durdurun ve yanıtı gönderin. 


RuleResult.SkipRemainingRules 


Kuralları uygulamayı durdurun ve bağlamı bir sonraki ara 
yazılıma gönderin. 








public void Configure(IApplicationBuilder app) 

{ 

using (StreamReader apacheModRewriteStreamReader = 

File.OpenText("ApacheModRewrite.txt")) 
using (StreamReader iisUrlRewriteStreamReader = 

File.OpenText("IISUrlRewrite.xml")) 

{ 

var options = new RewriteOptions() 

.AddRedirect("redirect-rule/(.*)", "redirected/$l") 

.AddRewrite(@" A rewrite-rule/(\d+)/(\d +)", "rewritten?varl=$l&var2=$2", 
skipRemainingRules: true) 

.AddApacheModRewrite(apacheModRewriteStreamReader) 

.AddIISUrlRewrite(iisUrlRewriteStreamReader) 

.Add(MethodRules.RedirectXmlFileRequests) 

.Add(MethodRules.RewriteTextFileRequests) 

.Add(new RedirectImageRequests(".png", "/png-images")) 

.Add(new RedirectImageRequestsC.jpg", "/jpg-images")); 

app.UseRewriter(options); 

} 

app.UseStaticFiles(); 

app.Run(context => context.Response.WriteAsync( 

$"Rewritten or Redirected Url: " + 

$"{context.Request.Path + context.Request.QueryString}")); 

} 

Örnek uygulama,. xm/ile biten yollar için istekleri yeniden yönlendiren bir yöntemi gösterir, için /fiie.xmi bir 
istek yapılırsa, istek öğesine /xmifiies/fiie.xmi yeniden yönlendirilir. Durum kodu 507olarak ayarlanır. Tarayıcı 
/xmlfiles/File.xmi\ç.\r\ yeni bir istek yaptığında, statik dosya ara yazılımı dosyayı Wwwroot/xmlfiles klasöründen 
istemciye sunar. Yeniden yönlendirme için, yanıtın durum kodunu açık olarak ayarlayın. Aksi takdirde, 200-ok 
durum kodu döndürülür ve yeniden yönlendirme istemcide gerçekleşmez. 

RewriteRules.cs\ 


public static void RedirectXmlFileRequests(RewriteContext context) 

{ 

var request = context.HttpContext.Request; 

// Because the Client is redireeting back to the same app, stop 
// Processing if the request has already been redirected. 
if (request.Path.StartsWithSegments(new PathString("/xmlfiles"))) 

{ 

return; 

} 

if (request.Path.Value.EndsWith(".xml ", StringComparison.OrdinalIgnoreCase)) 

{ 

var response = context.HttpContext.Response; 
response.StatusCode = StatusCodes.Status301MovedPermanently; 
context.Result = RuleResult.EndResponse; 
response.Headers[HeaderNames.Location] = 

"/xmlfiles" + request.Path + request.ÇueryString; 

} 

} 

Bu yaklaşım ayrıca istekleri yeniden yazabilir.Örnek uygulama, dosya. txt metin dosyasına Wwwroot klasöründen 
hizmeti sağlamak için herhangi bir metin dosyası isteğinin yolunu yeniden yazmayı gösterir. Statik dosya ara 
yazılımı, güncelleştirilmiş istek yoluna göre dosyayı sunar: 





public void Configure(IApplicationBuilder app) 

{ 

using (StreamReader apacheModRewriteStreamReader = 

File.OpenText("ApacheModRewrite.txt")) 
using (StreamReader iisllrlRewriteStreamReader = 

File.OpenText("IISUrlRewrite.xml")) 

{ 

var options = new RewriteOptions() 

.AddRedirect("redirect-rule/(.*)", "redirected/$l") 

.AddRewrite(@" A rewrite-rule/(\d+)/(\d +)", "rewritten?varl=$l&var2=$2", 
skipRemainingRules: true) 

.AddApacheModRewrite(apacheModRewriteStreamReader) 

.AddIISUrlRewrite(iisUrlRewriteStreamReader) 

.Add(MethodRules.RedirectXmlFileRequests) 

.Add(MethodRules.RewriteTextFileRequests) 

.Add(new RedirectImageRequests(".png", "/png-images")) 

.Add(new RedirectImageRequests0.jpg", "/jpg-images")); 

app.UseRewriter(options); 

} 

app.UseStaticFiles(); 

app.Run(context => context.Response.WriteAsync( 

$"Rewritten or Redirected Url: " + 

$"{context.Request.Path + context.Request.QueryString}")); 


RewriteRules.cs\ 


public static void RewriteTextFileRequests(RewriteContext context) 

{ 

var request = context.HttpContext.Request; 

if (request.Path.Value.EndsWith(".txt ", StringComparison.OrdinalIgnoreCase)) 

{ 

context.Result = RuleResult.SkipRemainingRules; 
request.Path = "/file.txt"; 

} 


Irule tabanlı kural 

Arabirimini uygulayan bir sınıfta kural mantığını kullanmak için kullanın Add. IRule iRule Yöntem tabanlı kural 
yaklaşımını kullanarak daha fazla esneklik sağlar. Uygulama sınıfınız, AppIyRule yöntemi için parametreleri 
geçirebilmeniz için bir Oluşturucu içerebilir. 





public void Configure(IApplicationBuilder app) 

{ 

using (StreamReader apacheModRewriteStreamReader = 

File.OpenText("ApacheModRewrite.txt")) 
using (StreamReader iisUrlRewriteStreamReader = 

File.OpenText("IISUrlRewrite.xml")) 

{ 

var options = new RewriteOptions() 

.AddRedirect("redirect-rule/(.*)", "redirected/$l") 

.AddRewrite(@" A rewrite-rule/(\d+)/(\d +)", "rewritten?varl=$l&var2=$2", 
skipRemainingRules: true) 

.AddApacheModRewrite(apacheModRewriteStreamReader) 

.AddIISUrlRewrite(iisUrlRewriteStreamReader) 

.Add(MethodRules.RedirectXmlFileRequests) 

.Add(MethodRules.RewriteTextFileRequests) 

.Add(new RedirectImageRequests(".png", "/png-images")) 

.Add(new RedirectImageRequests(".jpg", "/jpg-images")); 

app.UseRewriter(options); 

} 

app.UseStaticFiles(); 

app.Run(context => context.Response.WriteAsync( 

$"Rewritten or Redirected Url: " + 

$"{context.Request.Path + context.Request.QueryString}")); 

} 

extension Ve içi nörnekuygu lamadaki parametrelerindeğerleri,çeşitli koşul larauyacakşekildedenetlenir newPath 
Bir değer içermeli ve değer . png, .jpgveya . g(/olmalıdır. extension Geçerli değilse, bir ArgumentException 
oluşturulur. newPath İmage. png için bir istek yapılırsa, istek öğesine /png-images/image.png yeniden yönlendiril 
Image.jpgıçn bir istek yapılırsa, istek öğesine /jpg-images/image. jpg yeniden yönlendirilir. Durum kodu 301 
olarak ayarlanır ve kakçı olarak taşınırve context.Resuit kuralları işlemeyi durdur ve yanıtı gönder olarak 
ayarlanır. 








public class RedirectImageRequests : IRule 

{ 

private readonly string _extension; 
private readonly PathString _newPath; 

public RedirectImageRequests(string extension, string newPath) 

{ 

if (string.IsNullOrEmpty(extension)) 

{ 

throw new ArgumentException(nameof(extension)); 

} 

if (!Regex.IsMatch(extension, @" A \.(png|jpg|gif)$")) 

{ 

throw new ArgumentException("Invalid extension", nameof(extension)); 

} 

if (!Regex.IsMatch(newPath, @"(/[A-Za-z0-9]+)+?")) 

{ 

throw new ArgumentException("Invalid path", nameof(newPath)); 

} 


extension = extension; 

newPath = new PathString(newPath); 


public void ApplyRule(RewriteContext context) 

{ 

var request = context.HttpContext.Request; 

// Because we're redirecting back to the same appj stop 
// Processing if the request has already been redirected 
if (request.Path.StartsWithSegments(new PathString(_newPath))) 
{ 

return; 

} 


} 


if (request. Path. Value. EndsWith(_extension., StringComparison .OrdinalIgnoreCase)) 

{ 

var response = context.HttpContext.Response; 
response.StatusCode = StatusCodes.Status301MovedPermanently; 
context.Result = RuleResult.EndResponse; 
response.Headers[HeaderNames.Location] = 

_newPath + request.Path + request.QueryString; 

} 

} 


Özgün İstek: /image.png 



Özgün İstek: /image.jpg 















Regex örnekleri 


HEDEF 


REGEX DİZE & DEĞİŞTİRME DİZESİ & 

MATCH ÖRNEĞİ ÇIKIŞ ÖRNEĞİ 


Yolu QueryString 'e yeniden yazın 


A path/(.*)/(.* 

) 


path?varl=$l&var2=$2 


/path/abc/123 


/path?varl=abc&var2=123 


Eğik çizgiyi çıkar 

(■*)/$ 

$1 


/path/ 

/path 


Sondaki eğik çizgiyi zorla 


$1/ 


/path 

/path/ 


Belirli istekleri yeniden yazmayı önleyin 

A (.*)(?<!\.axd)$ veya 

rewritten/$l 


A (?!.*\.axd$)(.*)$ 

/rewritten/resource.htm 


Yes /resource.htm 

/resource.axd 


Eşleşen /resource.axd 



URL segmentlerini yeniden Düzenle 


path/(.*)/( 

■*)/(•*) 

path/1/2/3 



path/$3/$2/$l 

path/3/2/1 


URL segmentini değiştirme 


A (. *)/segment2/(.*) 
/segmentl/segment2/segment3 


$l/replaced/$2 

/segmentl/neplaced/segment3 


Bu belgede, ASP.NET Core uygulamalarında URL yeniden yazma ara yazılımı kullanma yönergeleriyle birlikte 
URL yeniden yazma tanıtılmaktadır. 

URL yeniden yazma, istek URL 'Lerini bir veya daha fazla önceden tanımlanmış kurala göre değiştirme işlemidir. 
URL yeniden yazma, konumların ve adreslerin sıkı bir şekilde bağlanmaması için kaynak konumları ve adresleri 
arasında bir soyutlama oluşturur. URL yeniden yazma işlemi birkaç senaryoda yararlı olur: 

• Sunucu kaynaklarını geçici olarak veya kalıcı olarak taşıyın veya değiştirin ve bu kaynakların kararlı konum 
belirleyicilerinin bakımını yapın. 

• İstek işlemeyi farklı uygulamalar arasında veya bir uygulamanın alanlarında bölme. 

• Gelen isteklerde URL segmentlerini kaldırın, ekleyin veya yeniden düzenleyin. 

• Arama motoru İyileştirmesi (SEO) için genel URL 'Leri iyileştirin. 

• Ziyaretçilerin bir kaynak isteyerek döndürülen içeriği tahmin etmeye yardımcı olmak için kolay genel URL 
'Lerin kullanılmasına izin verme. 

• Güvensiz istekleri güvenli uç noktalara yönlendirin. 

• Bir dış sitenin varlığı kendi içeriğine bağlayarak başka bir sitede barındırılan statik bir varlık kullandığı Hotlink 












i engelleyin. 


NOTE 

URL yeniden yazma, bir uygulamanın performansını azaltabilir. Uygun yerlerde kuralların sayısını ve karmaşıklığını sınırlayın. 


Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 


URL yeniden yönlendirme ve URL yeniden yazma 

URL yeniden yönlendirme ve URL yeniden yazma arasındaki ifade farkı daha hafif ancak istemcilere kaynak 
sağlamak için önemli etkileri vardır. ASP.NET Core URL yeniden yazma ara yazılımı her ikisine de ihtiyacı 
verebilir. 


URL yeniden yönlendirme , istemcinin, ilk olarak istenen istemciden farklı bir adresteki kaynağa erişmesi için bir 
istemci tarafı işlemi içerir. Bu, sunucuya gidiş dönüş gerektirir, istemci kaynak için yeni bir istek yaptığında, 
istemciye döndürülen yeniden yönlendirme URL 'SI tarayıcının adres çubuğunda görüntülenir. 


/different-resource Öğesine /resource 

yön lendi ri liyorsasu nucu, istemci nin,yenidenyönlendirmeningeçiciyadakalıcıolduğunubelirtenbirdurumkoduilekay 
nağıeldeetmesigerektiğiniyamtverir. /different-resource 



Request:/v1/api 

» 

Response: 302 (Found) 
Location: /v2/api 

◄- 

Request:/v2/api 

» 

Response: 200 (OK) 1 % 
URLPath: V2api 

◄- 


O 


The requestis 



The service is 
conta ete d at 
/v2/api 


istekleri farklı bir URL 'ye yönlendirirken, yanıtla birlikte durum kodunu belirterek yeniden yönlendirmenin kalıcı 
mi yoksa geçici mi olduğunu belirtin: 

• 301-taşınan kalıcı durum kodu, kaynağın yeni, kalıcı bir URL olduğu ve istemciye, gelecekteki tüm 
isteklerin kaynak için tüm istekleri yeni URL 'yi kullanması gerektiğini bildirmek istediğinizde kullanılır. 
istemci, 301 durum kodu almdığmda yanıtı önbelleğe alabilir ve yeniden kullanabilir. 

• 302-bulunan durum kodu, yeniden yönlendirmenin geçici ya da genellikle değişikliğe tabi olduğu 
durumlarda kullanılır. 302 durum kodu, istemcinin URL 'Yİ depolayamadığını ve gelecekte kullanacağını 
gösterir. 

Durum kodları hakkında daha fazla bilgi için bkz . RFC 2616: Durum kodu tanımları. 

URL yeniden yazma , istenen istemciden farklı bir kaynak adresinden kaynak sağlayan sunucu tarafı bir işlemdir. 
URL yeniden yazma, sunucuya gidiş dönüş gerektirmez. Yeniden yazan URL istemciye döndürülmüyor ve 
tarayıcının adres çubuğunda görünmüyor. 

/different-resource Öğesine /resource geridönerse,sunucu,kaynağınıdahili /different-resource olarak getirir ve 
döndürür. 

istemci, yeniden yazan URL 'de kaynağı alabiliyor olsa da, istemci isteği yaptığında ve yanıtı aldığında kaynağın 
yeniden yazan URL 'de bulunduğunu bilgilendirmez. 



















Request:/v1/api 



► 

Response:200(OK) S k 
URLPath: /vl/api 


O 

The requestis 
revvrittento 
/v2/api 


URL yeniden yazma örnek uygulaması 

Örnek uygulamaylabirlikte YENİDEN yazma URL 'sinin özelliklerini inceleyebilirsiniz. Uygulama yeniden 
yönlendirme ve yeniden yazma kuralları uygular ve birkaç senaryo için yeniden yönlendirilen veya yeniden yazan 
URL 'Yİ gösterir. 

URL yeniden yazma ara yazılımı ne zaman kullanılır 

Aşağıdaki yaklaşımlardan birini kullandığımmdan URL yeniden yazma ara yazılımı kullanın: 

• Windows Server 'da IIS ile URL yeniden yazma modülü 

• Apache Server 'da Apache mod_rewrite modülü 

• NGINX üzerinde URL yeniden yazma 

Ayrıca, uygulama http. sys sunucusunda barındırıldığı zaman ara yazılımı kullanın (eski adıyla webListener olarak 
adlandırılır). 

IIS, Apache ve NGINX 'te sunucu tabanlı URL yeniden yazma teknolojilerini kullanmanın başlıca nedenleri 
şunlardır: 

• Ara yazılım bu modüllerin tüm özelliklerini desteklemez. 

Sunucu modüllerinin bazı özellikleri, isFile IIS yeniden yazma modülünün ve isDirectory kısıtlamaları 
gibi ASP.NET Core projelerle birlikte çalışmaz. Bu senaryolarda, bunun yerine ara yazılımı kullanın. 

• Ara yazılım performansı büyük olasılıkla modüllerle eşleşmiyor. 

Sınama, performansı en iyi şekilde düşürür veya performans düşüklüğü göz ardı edilebilir olduğundan 
emin olmanın tek yoludur. 

Paket 

Ara yazılımı projenize dahil etmek için, Microsoft. AspNetCore. yeniden yazma paketini içeren proje dosyasındaki 
Microsoft. Aspnetcore. app metapackage öğesine bir paket başvurusu ekleyin. 

Microsoft.AspNetCore.App Metapackage'i kullanmıyorsanız, Microsoft.AspNetcore.Rewrite pakete bir proje 
başvurusu ekleyin. 

Uzantı ve Seçenekler 

Yeniden yazma kurallarınızın her biri için uzantı yöntemleriyle Revvriteoptions sınıfının bir ÖRNEĞİNİ oluşturarak 
URL yeniden yazma ve yeniden yönlendirme kuralları oluşturun. Birden çok kuralı, işlenmeyi istediğiniz sırada 
zincirle., RewriteOptions ile istek ardışık düzenine eklendikçe, bu URL 'ye yeniden yazma ara yazılımı ile 

UseRevvritergeçirilir: 















public void Configure(IApplicationBuilder app) 

{ 

using (StreamReader apacheModRewriteStreamReader = 

File.OpenText("ApacheModRewrite.txt")) 
using (StreamReader iisllrlRewriteStreamReader = 

File.OpenText("IISUrlRewrite.xml")) 

{ 

var options = new RewriteOptions() 

.AddRedirect("redirect-rule/(.*)", "redirected/$l") 

.AddRewrite(@" A rewrite-rule/(\d+)/(\d +)", "rewritten?varl=$l&var2=$2", 
skipRemainingRules: true) 

.AddApacheModRewrite(apacheModRewriteStreamReader) 

.AddIISUrlRewrite(iisUrlRewriteStreamReader) 

.Add(MethodRules.RedirectXmlFileRequests) 

.Add(MethodRules.RewriteTextFileRequests) 

.Add(new RedirectImageRequests(".png", "/png-images")) 

.Add(new RedirectImageRequestsC.jpg", "/jpg-images")); 

app.UseRewriter(options); 

} 

app.UseStaticFiles(); 

app.Run(context => context.Response.WriteAsync( 

$"Rewritten or Redirected Url: " + 

$"{context.Request.Path + context.Request.QueryString}")); 


Www olmayan www 'e yönlendirme 

Üç seçenek, uygulamanın www www istek olmayan istekleri yeniden yönlendirmesine izin verir: 

• AddRedirectToWwwPermanentistek değilse isteği alt www etki alanına kalıcı olarak yeniden yönlendirin. 

www - Status308PermanentRedirect durum kodu ile yeniden yönlendirir. 

• AddRedirectToWwwGelen istek değilse isteği www alt etki alanına yönlendirin. www - 
Status307TemporaryRedirect durum kodu ile yeniden yönlendirir. Aşırı yükleme, yanıt için durum kodu 
sağlamanıza izin verir. Bir durum kodu ataması için StatusCodes sınıfın bir alanını kullanın. 

URL yeniden yönlendirme 

istekleri AddRedirect yeniden yönlendirmek için kullanın, ilk parametre gelen URL 'nin yolu ile eşleşen Regex 
içerir, ikinci parametre değiştirme dizesidir.Varsa, üçüncü parametre durum kodunu belirtir. Durum kodunu 
belirtmezseniz, durum kodu varsayılan olarak 302-bulunur; bu da kaynağın geçici olarak taşındığını veya 
değiştirildiğini gösterir. 









public void Configure(IApplicationBuilder app) 

{ 

using (StreamReader apacheModRewriteStreamReader = 

File.OpenText("ApacheModRewrite.txt")) 
using (StreamReader iisUrlRewriteStreamReader = 

File.OpenText("IISUrlRewrite.xml")) 

{ 

var options = new RewriteOptions() 

.AddRedirect("redirect-rule/(.*)", "redirected/$l") 

.AddRewrite(@" A rewrite-rule/(\d+)/(\d +)", "rewritten?varl=$l&var2=$2", 
skipRemainingRules: true) 

.AddApacheModRewrite(apacheModRewriteStreamReader) 

.AddIISUrlRewrite(iisUrlRewriteStreamReader) 

.Add(MethodRules.RedirectXmlFileRequests) 

.Add(MethodRules.RewriteTextFileRequests) 

.Add(new RedirectImageRequests(".png", "/png-images")) 

.Add(new RedirectImageRequests(".jpg", "/jpg-images")); 

app.UseRewriter(options); 

} 

app.UseStaticFiles(); 

app.Run(context => context.Response.WriteAsync( 

$"Rewritten or Redirected Url: " + 

$"{context.Request.Path + context.Request.QueryString}")); 

} 

Geliştirici araçları etkinleştirilmiş bir tarayıcıda, örnek uygulamaya yol /redirect-ruie/1234/5678 ile bir istek 
oluşturun. Regex, üzerindeki redirect-ruie/( .*) istek yoluyla eşleşir ve yol ile /redirected/1234/5678 
değiştirilmiştir. Yeniden yönlendirme URL 'SI, 302 tarafından bulunan bir durum kodu ile istemciye geri 
gönderilir. Tarayıcı, tarayıcının adres çubuğunda görüntülenen yeniden yönlendirme URL 'SI üzerinde yeni bir 
istek oluşturur. Örnek uygulamadaki hiçbir kural, yeniden yönlendirme URL 'SI üzerinde eşleşmediğinden: 

• ikinci istek uygulamadan 200-Tamam yanıtı alır. 

• Yanıtın gövdesi, yeniden yönlendirme URL 'sini gösterir. 

Bir URL yenidenyönlendirildiğindesunucuya gidiş dönüş yapılır. 


VVARNING 

Yeniden yönlendirme kuralları oluştururken dikkatli olun. Yeniden yönlendirme kuralları, bir yeniden yönlendirmeden sonra 
dahil olmak üzere, uygulamaya yapılan her istekte değerlendirilir. Yanlışlıkla sonsuz yeniden yönlendirmeler 
döngüsü oluşturmak kolaydır. 


Özgün İstek: /redirect-rule/1234/5678 

B localhost X + 

O localhost:5000/redirected/1234/5678 

Re\vritten or Redirected Url: redirected 1234 5678 


Fi 2 DOM Explorer Console Debugger 


Netv.ork (►) 


lil İB tl — T* Contenttype 
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A 

Result / 

Path 

Protocol 

Method 

Description 
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HTTP 

GET 

302 

http7/localhost:5000/redirect-aıle/1234/ 



Found 
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HTTP 

GET 

200 

http^/loca Ihost5000/red irected/1234/ 



OK 


☆ — 
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Performance Memory Emulation ▼ 



Headers Body Parameters Cookies Timings 
Request URL: http://localhost5(X)0/redirect-rule/1234/... 
Request Method: GET 
Status Code: A 302 / Found 

A Request Headers 

















Parantez içinde yer alan ifadenin kısmına bir yakalama grubuder\\r. ifadenin nokta ( . ), herhangi bir karakterle 
eş/eş/ranlamına gelir. Yıldız işareti ( * ), önceki karakterle sıfır veya daha fazla kez eşleşme gösterir. Bu nedenle, 
URL 1234/5678 'nin son iki yol kesimi, yakalama grubu (.*) tarafından yakalanır. Sonrasında istek URL'sinde 
sağladığınız herhangi bir değer bu redirect-rule/ tek yakalama grubu tarafından yakalandıktan sonra. 

Değiştirme dizesinde, yakalanan gruplar, dolar işareti ( $ ) ve ardından yakalamanın sıra numarası ile birlikte 
dizeye eklenir, ilk yakalama grubu değeri ile $ı elde edilir, İkincisi ile $2 ve normal Regex yakalama grupları için 
sırayla devam eder. Örnek uygulamadaki yeniden yönlendirme kuralı Regex bölümünde yalnızca bir tane 
yakalanan grup bulunur, bu $1 nedenle değiştirme dizesinde yalnızca bir tane eklenmiş grup vardır. Kural 
uygulandığında, URL olur /redirected/1234/5678 . 

Güvenli bir uç noktaya URL yönlendirmesi 

HTTP AddRedirectToHttps isteklerini https protokolünü kullanarak aynı konağa ve yola yeniden yönlendirmek 
için kullanın. Durum kodu sağlanmazsa, ara yazılım varsayılan olarak 302-bulunur. Bağlantı noktası sağlanmazsa: 

• Ara yazılım varsayılan olarak nuiı olur. 

• Şema (https Protokolü https ) olarak değişir ve istemci, 443 numaralı bağlantı noktasında kaynağa erişir. 

Aşağıdaki örnek, durum kodunun 301-kalıcı olarak taşınacağını ve bağlantı noktasını 5001 olarak nasıl 
değiştirileceğini gösterir. 

public void Configure(IApplicationBuilder app) 

{ 

var options = new RewriteOptions() 

.AddRedirectToHttps(301, 5001); 

app.UseRewriter(options); 

} 

Güvenli AddRedirectToHttpsPermanent olmayan istekleri, bağlantı noktası 443 üzerinde güvenli https Protokolü 
ile aynı konağa ve yola yeniden yönlendirmek için kullanın. Ara yazılım durum kodunu 301 olarak ayarlar ve 
kalıcı olarak taşınır. 

public void Configure(IApplicationBuilder app) 

{ 

var options = new RewriteOptions() 

.AddRedirectToHttpsPermanent(); 


app.UseRewriter(options); 

} 



Örnek uygulama, veya AddRedirectToHttps AddRedirectToHttpsPermanent kullanımını gösterme yeteneğine 
sahiptir. Uzantı yöntemini öğesine RewriteOptions ekleyin. Herhangi bir URL 'de uygulamaya güvenli olmayan bir 
istek oluşturun. Otomatik olarak imzalanan sertifikanın güvenilmeyen tarayıcı güvenlik uyarısını kapatın veya 
sertifikaya güvenmek için bir özel durum oluşturun. 

Kullanarak AddRedirectToHttps(301, 5001) Özgün istek: http://localhost:5000/secure 















Kullanarak AddRedirectToHttpsPermanent Özgün istek: http://localhost:5000/secur 


B localhost X + 

^ | (Jj Certificate error localhost/secure 

Re\vritten or Redirected Url: secure 


DOM Explorer 


Debugger 


Network (►) 


fa fer ^ T ^ Content type 


Name / 

Path 

secure 

httpy/localhost5000/ 

secure 

httpsy/localhost/ 
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Memory -w 


Result / 
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HTTP GET 301 

Moved Permanentty 

HTTPS GET 200 

OK 


Find (Ctrl+F) 

Parameters Cookies Timings 


Headers Body 
Request URL: http://localhost5000/secure 
Request Method: GET 
Status Code: A 301 / Moved Permanently 

A Request Headers 
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URL yeniden yazma 

URL AddRevvrite 'leri yeniden yazma kuralı oluşturmak için kullanın, ilk parametre gelen URL yolundaki eşleşme 
için Regex içerir, ikinci parametre değiştirme dizesidir.Üçüncü parametresi skipRemainingRules: {true|faise} , 
geçerli kural uygulanmışsa ek yeniden yazma kurallarının atlanıp atlanmayacağını gösterir. 

public void Configure(IApplicationBuilder app) 

{ 

using (StreamReader apacheModRewriteStreamReader = 

File.OpenText("ApacheModRewrite.txt")) 
using (StreamReader iisUrlRewriteStreamReader = 

File.OpenText("IISUrlRewrite.xml")) 

{ 

var options = new RewriteOptions() 

.AddRedirect("redirect-rule/(.*)", "redirected/$l") 

.AddRewrite(@" A rewrite-rule/(\d+)/(\d +)", "rewritten?varl=$l&var2=$2", 
skipRemainingRules: true) 

.AddApacheModRewrite(apacheModRewriteStreamReader) 

.AddIISUrlRewrite(iisUrlRewriteStreamReader) 

.Add(MethodRules.RedirectXmlFileRequests) 

.Add(MethodRules.RewriteTextFileRequests) 

.Add(new RedirectImageRequests(".png", "/png-images")) 

.Add(new RedirectImageRequests(".jpg", "/jpg-images")); 

app.UseRewriter(options); 

} 

app.UseStaticFiles(); 

app.Run(context => context.Response.WriteAsync( 

$"Rewritten or Redirected Url: " + 

$"{context.Request.Path + context.Request.QueryString}")); 

} 






















Özgün İstek: /rewrite-rule/1234/5678 



ifadenin başındaki simgeyi seçtiğinizde A (), eşleşmesinin URL yolunun başlangıcında başladığı anlamına gelir. 

Önceki örnekte, yeniden yönlendirme kuralıyla redirect-ruie/( .*) , Regex başlangıcında simgeyi seçtiğinizde ( A 
) yoktur. Bu nedenle, başarılı bir eşleşme redirect-rule/ için herhangi bir karakterden önce yol açabilir. 

YOL EŞLEŞTİRME 


/redirect-rule/1234/5678 

Evet 

/my-cool-redirect-rule/1234/5678 

Evet 

/anotherredirect-rule/1234/5678 

Evet 

Yeniden yazma kuralı A rewrite-ruie/(\d+)/(\d+) 

.yalnızca ile rewrite-ruie/ başlarsa yollarla eşleşir. Aşağıdaki 

tabloda, eşleşen farkı aklınızda. 


YOL 

EŞLEŞTİRME 

/rewrite-rule/1234/5678 

Evet 

/my-cool-rewrite-rule/1234/5678 

Hayır 

/anotherrewrite-rule/1234/5678 

Hayır 


ifadenin bölümünü takip eden iki yakalama (\d+)/(\d+) grubu vardır. A rewrite-ruie/ Belirtir bir sayıyla (sayı) 
eşleşir. \d Artı işareti ( + ) bir veya daha fazla önceki karakterden eşleşiyordemektlr. Bu nedenle, URL bir sayı 
içermeli ve ardından ileri eğik çizgi ve ardından başka bir sayı içermelidir. Bu yakalama grupları, ve olarak $ı 
yeniden $2 yazan URL 'sine eklenir.Yeniden yazma kuralı değiştirme dizesi yakalanan grupları sorgu dizesine 
koyar. İstenen yolu /rewrite-ruie/i234/5678 , /rewritten?vari=i234&var2=5678 kaynağı elde etmek için yeniden 
yazılır. Özgün istekte bir sorgu dizesi varsa, URL yeniden yazdığınızda korunur. 

Kaynağı almak için sunucuya gidiş dönüş yok. Kaynak varsa, bu, alınır ve istemciye 200-ok durum kodu ile 
döndürülür, istemci yeniden yönlendirmediği için tarayıcının adres çubuğundaki URL değişmez, istemciler, 
sunucuda bir URL yeniden yazma işleminin gerçekleştiğini algılayamaz. 




























NOTE 

Eşleşen skipRemainingRules: true kuralların hesaplama maliyeti ve uygulama yanıt süresini arttığı için mümkün olan her 
durumda kullanın. En hızlı uygulama yanıtı için: 

• En sık eşleşen kuraldan en az sıklıkta eşleşen kurala göre yeniden yazma kuralları. 

• Bir eşleşme gerçekleştiğinde ve ek kural işleme gerekli olmadığında kalan kuralların işlenmesini atlayın. 


Apache mod_rewrite 

ile AddApacheModRevvriteApache mod_rewrite kurallarını uygulayın. Kurallar dosyasının uygulamayla birlikte 
dağıtıldığından emin olun. Daha fazla bilgi ve mod_rewrite kuralları örnekleri için bkz. Apache mod_rewrite. 

, ApacheModRevvrite. txt kuralları dosyasındaki kuralları okumak için kullanılır: StreamReader 

public void Configure(IApplicationBuilder app) 

{ 

using (StreamReader apacheModRewriteStreamReader = 

File.OpenText("ApacheModRewrite.txt")) 
using (StreamReader iisUrlRewriteStreamReader = 

File.OpenText("IISUrlRewrite.xml")) 

{ 

var options = new RewriteOptions() 

.AddRedirect("redirect-rule/(.*)", "redirected/$l") 

.AddRewrite(@" A rewrite-rule/(\d+)/(\d +)", "rewritten?varl=$l&var2=$2", 
skipRemainingRules: true) 

.AddApacheModRewrite(apacheModRewriteStreamReader) 

.AddIISUrlRewrite(iisUrlRewriteStreamReader) 

.Add(MethodRules.RedirectXmlFileRequests) 

.Add(MethodRules.RewriteTextFileRequests) 

.Add(new RedirectImageRequests(".png"j "/png-images")) 

.Add(new RedirectImageRequests(".jpg"j "/jpg-images")); 

app.UseRewriter(options); 

} 

app.UseStaticFiles(); 

app.Run(context => context.Response.WriteAsync( 

$"Rewritten or Redirected Url: " + 

$"{context.Request.Path + context.Request.QueryString}")); 

} 

Örnek uygulama, istekleri ' den /apache-mod-ruies-redirect/( .\*) 1 /redirected?id=$ı e yeniden yönlendirir. 
Yanıt durum kodu 302-bulundu. 


# Rewrite path with additional sub directory 

RewriteRule A /apache-mod-rules-redirect/(.*) /redirected?id=$l [LjR=302] 
Özgün İstek: /apache-mod-ruies-redirect /1234 






E3 localhost X + 

^ U localhost 

Retvritten or Redirected Url: redirected?id=1234 


Fi 2 DOM Explorer Console Debugger 


Network © 
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Resuft / 

Path 

Protocol 

Method 

Description 

1234 

HTTP 

GET 

302 

httpy/localhost5000/apache-mod-ajles-redirect/ 



Found 

redirected ?id=1234 

HTTP 

GET 

200 

httpy/localhost5000/ 



OK 


☆ — 


□ 

û 


Performance Memory Emulation ▼ 



Headers Body Parameters Cookies Timings 
Request URL: http://localhosfc5000/apache-mod-rules... 
Request Method: GET 
Status Code: A 302 / Found 

A Request Headers 


Ara yazılım aşağıdaki Apache mod_rewrite Server değişkenlerini destekler: 

• CON N_REMOTE_ADDR 

• HTTP_ACCEPT 

• HTTP_CONNECTION 

• HTTP_COOKI E 

• HTTP_FORWARDED 

• HTTP_HOST 

• HTTP_REFERER 

• HTTP_USER_AGENT 

• HTTPS 

• IPV6 

• QUERY_STRING 

• REMOTE_ADDR 

• REMOTE_PORT 

• REQUEST_FILENAME 

• REQUEST_METHOD 

• REQUEST_SCHEME 

• REQUEST_URI 

• SCRIPT_FILENAME 

• SERVER_ADDR 

• SERVER_PORT 

• SERVER_PROTOCOL 

• TIME 

• TIME_DAY 

• TIME_HOUR 

• TIME_MIN 

• TIME_MON 

• TIME_SEC 

• TIME_WDAY 

• TIME_YEAR 

IİS URL yeniden yazma modülü kuralları 

11S URL yeniden yazma modülü için geçerli olan kural kümesini kullanmak için kullanın AddlISUrlRevvrite. 
Kurallar dosyasının uygulamayla birlikte dağıtıldığından emin olun. Windows Server IİS 'de çalışırken 
uygulamanın Web. config dosyasını kullanmak için ara yazılımı yönlendirmeyin. IİS ile, IİS yeniden yazma 
modülüyle çakışmalardan kaçınmak için bu kuralların uygulamanın Web. config dosyası dışında depolanması 















gerekir. Daha fazla bilgi ve 11S URL yeniden yazma modülü kurallarının örnekleri için bkz. Using URL yeniden 
yazma modülü 2,0 ve URL yeniden yazma modülü yapılandırma başvurusu. 

, lisurlyeniden yazma. xml kuralları dosyasındaki kuralları okumak için kullanılır: StreamReader 

public void Configure(IApplicationBuilder app) 

{ 

using (StreamReader apacheModRewriteStreamReader = 

File.OpenText("ApacheModRewrite.txt")) 
using (StreamReader iisUrlRewriteStreamReader = 

File.OpenText("IISUrlRewrite.xml")) 

{ 

var options = new RewriteOptions() 

.AddRedirect("redirect-rule/(.*)", "redirected/$l") 

.AddRewrite(@" A rewrite-rule/(\d+)/(\d +)", "rewritten?varl=$l&var2=$2", 
skipRemainingRules: true) 

.AddApacheModRewrite(apacheModRewriteStreamReader) 

.AddIISUrlRewrite(iisUrlRewriteStreamReader) 

.Add(MethodRules.RedirectXmlFileRequests) 

.Add(MethodRules.RewriteTextFileRequests) 

.Add(new RedirectImageRequests(".png", "/png-images")) 

.Add(new RedirectImageRequests(".jpg", "/jpg-images")); 

app.UseRewriter(options); 

} 

app.UseStaticFiles(); 

app.Run(context => context.Response.WriteAsync( 

$"Rewritten or Redirected Url: " + 

$"{context.Request.Path + context.Request.QueryString}")); 

} 

Örnek uygulama,' den ' /iis-ruies-rewrite/( .*) e /rewritten?id=$ı olan istekleri yeniden yazar. Yanıt, istemciye 
200-ok durum kodu ile gönderilir. 

<rewrite> 

<rules> 

<rule name="Rewrite segment to id querystring" stopProcessing="true"> 

<match url=" A iis-rules-rewrite/(.*)$" /> 

<action type="Rewrite" url="rewritten?id={R:1}" appendQueryString="false"/> 

</rule> 

</rules> 

</rewrite> 

Özgün İstek: /iis-rules-rewrite/12S4 



Uygulamanızı istenmeyen yollarla etkileyebilecek sunucu düzeyi kurallara sahip etkin bir 11S yeniden yazma 




















modülünüzün olması halinde, bir uygulama için 11S yeniden yazma modülünü devre dışı bırakabilirsiniz. Daha 
fazla bilgi için bkz. 11S modüllerini devre dışı bırakma. 

Desteklenmeyen özellikler 

ASP.NET Core 2. x ile yayınlanan ara yazılım, aşağıdaki 11S URL yeniden yazma modülü özelliklerini desteklemez: 

• Giden kuralları 

• Özel sunucu değişkenleri 

• Karakterlerini 

• LogRevvrittenUrl 'Si 

Desteklenen sunucu değişkenleri 

Ara yazılım aşağıdaki MS URL yeniden yazma modülü sunucu değişkenlerini destekler: 

• CONTENT_LENGTH 

• CONTENT_TYPE 

• HTTP_ACCEPT 

• HTTP_CONNECTION 

• HTTP_COOKI E 

• HTTP_HOST 

• HTTP_REFERER 

• HTTP_URL 

• HTTP_USER_AGENT 

• HTTPS 

• LOCAL_ADDR 

• QUERY_STRING 

• REMOTE_ADDR 

• REMOTE_PORT 

• REQUEST_FILENAME 

• REQUEST_URI 


NOTE 

Ayrıca bir IFileProvider PhysicalFileProviderile elde edebilirsiniz. Bu yaklaşım, yeniden yazma kuralları dosyalarınızın konumu 
için daha fazla esneklik sağlayabilir. Yeniden yazma kuralları dosyalarınızın sağladığınız yoldaki sunucuya dağıtıldığından emin 
olun. 

PhysicalFileProvider fileProvider = new PhysicalFileProvider(Directory.GetCurrentDirectory()); 


Yöntem tabanlı kural 

Bir Add yöntemde kendi kural mantığınızı uygulamak için kullanın. Add , metodunda kullanım HttpContext için 
kullanılabilir hale getiren öğesinigösterir.RewriteContext Rewritecontext. Result , ek ardışık düzen işlemenin nasıl 
işlendiğini belirler. Değeri aşağıdaki tabloda açıklanan RuleResult alanlardan birine ayarlayın. 

REWRITECONTEXT. RESULT EYLEM 

RuleResult.continueRules varsayılanını Kuralları uygulamaya devam edin. 

RuleResult. EndResponse Kuralları uygulamayı durdurun ve yanıtı gönderin. 









REWRITECONTEXT. RESÜLT 


EYLEM 


RuleResult.SkipRemainingRules 


Kuralları uygulamayı durdurun ve bağlamı bir sonraki ara 
yazılıma gönderin. 


public void Configure(IApplicationBuilder app) 

{ 

using (StreamReader apacheModRewriteStreamReader = 

File.OpenText("ApacheModRewrite.txt")) 
using (StreamReader iisUrlRewriteStreamReader = 

File.OpenText("IISUrlRewrite.xml")) 

{ 

var options = new RewriteOptions() 

.AddRedirect("redirect-rule/(.*)", "redirected/$l") 

.AddRewrite(@" A rewrite-rule/(\d+)/(\d +)", "rewritten?varl=$l&var2=$2", 

SkipRemainingRules: true) 

.AddApacheModRewrite(apacheModRewriteStreamReader) 

.AddIISUrlRewrite(iisUrlRewriteStreamReader) 

.Add(MethodRules.RedirectXmlFileRequests) 

.Add(MethodRules.RewriteTextFileRequests) 

.Add(new RedirectImageRequests(".png", "/png-images")) 

.Add(new RedirectImageRequestsC.jpg", "/jpg-images")); 

app.UseRewriter(options); 

} 

app.UseStaticFiles(); 

app.Run(context => context.Response.WriteAsync( 

$"Rewritten or Redirected Url: " + 

$"{context.Request.Path + context.Request.QueryString}")); 

} 

Örnek uygulama,. xm/ile biten yollar için istekleri yeniden yönlendiren bir yöntemi gösterir, için /fiie.xmi bir 
istek yapılırsa, istek öğesine /xmifiies/fiie.xmi yeniden yönlendirilir. Durum kodu 307olarak ayarlanır. Tarayıcı 
/xmlfUes/File.xmi\çr\ yeni bir istek yaptığında, statik dosya ara yazılımı dosyayı Wwwroot/xmlfiles klasöründen 
istemciye sunar. Yeniden yönlendirme için, yanıtın durum kodunu açık olarak ayarlayın. Aksi takdirde, 200-ok 
durum kodu döndürülür ve yeniden yönlendirme istemcide gerçekleşmez. 

RewrlteRules.es : 


public static void RedirectXmlFileRequests(RewriteContext context) 

{ 

var request = context.HttpContext.Request; 

// Because the Client is redireeting back to the same app., stop 
// Processing if the request has already been redirected. 
if (request.Path.StartsWithSegments(new PathString("/xmlfiles"))) 

{ 

return; 

} 

if (request.Path.Value.EndsWith(".xml ", StringComparison.OrdinalIgnoreCase)) 

{ 

var response = context.HttpContext.Response; 
response.StatusCode = StatusCodes.Status301MovedPermanently; 
context.Result = RuleResult.EndResponse; 
response.Headers[HeaderNames.Location] = 

"/xmlfiles" + request.Path + request.ÇueryString; 

} 

} 






Bu yaklaşım ayrıca istekleri yeniden yazabilir.Örnek uygulama, dosya. txt metin dosyasına Wwwroot klasöründen 
hizmeti sağlamak için herhangi bir metin dosyası isteğinin yolunu yeniden yazmayı gösterir. Statik dosya ara 
yazılımı, güncelleştirilmiş istek yoluna göre dosyayı sunar: 


public void Configure(IApplicationBuilder app) 

{ 

using (StreamReader apacheModRewriteStreamReader = 

File.OpenText("ApacheModRewrite.txt")) 
using (StreamReader iisUrlRewriteStreamReader = 

File.OpenText("IISUrlRewrite.xml")) 

{ 

var options = new RewriteOptions() 

.AddRedirect("redirect-rule/(.*)", "redirected/$l") 

.AddRewrite(@" A rewrite-rule/(\d+)/(\d +)", "rewritten?varl=$l&var2=$2", 
skipRemainingRules: true) 

.AddApacheModRewrite(apacheModRewriteStreamReader) 

.AddIISUrlRewrite(iisUrlRewriteStreamReader) 

.Add(MethodRules.RedirectXmlFileRequests) 

.Add(MethodRules.RewriteTextFileRequests) 

.Add(new RedirectImageRequests(".png", "/png-images")) 

.Add(new RedirectIrnageRequests0.jpg", "/jpg-images")); 

app.UseRewriter(options); 

} 

app.UseStaticFiles(); 

app.Run(context => context.Response.WriteAsync( 

$"Rewritten or Redirected Url: " + 

$"{context.Request.Path + context.Request.QueryString}")); 


RewriteRules.cs\ 


public static void RewriteTextFileRequests(RewriteContext context) 

{ 

var request = context.HttpContext.Request; 

if (request.Path.Value.EndsWith(".txt ", StringComparison.OrdinalIgnoreCase)) 

{ 

context.Result = RuleResult.SkipRemainingRules; 
request.Path = "/file.txt"; 

} 


Irule tabanlı kural 

Arabirimini uygulayan bir sınıfta kural mantığını kullanmak için kullanın Add. IRule iRule Yöntem tabanlı kural 
yaklaşımını kullanarak daha fazla esneklik sağlar. Uygulama sınıfınız, AppIyRule yöntemi için parametreleri 
geçirebilmeniz için bir Oluşturucu içerebilir. 





public void Configure(IApplicationBuilder app) 

{ 

using (StreamReader apacheModRewriteStreamReader = 

File.OpenText("ApacheModRewrite.txt")) 
using (StreamReader iisUrlRewriteStreamReader = 

File.OpenText("IISUrlRewrite.xml")) 

{ 

var options = new RewriteOptions() 

.AddRedirect("redirect-rule/(.*)", "redirected/$l") 

.AddRewrite(@" A rewrite-rule/(\d+)/(\d +)", "rewritten?varl=$l&var2=$2", 
skipRemainingRules: true) 

.AddApacheModRewrite(apacheModRewriteStreamReader) 

.AddIISUrlRewrite(iisUrlRewriteStreamReader) 

.Add(MethodRules.RedirectXmlFileRequests) 

.Add(MethodRules.RewriteTextFileRequests) 

.Add(new RedirectImageRequests(".png", "/png-images")) 

.Add(new RedirectImageRequests(".jpg", "/jpg-images")); 

app.UseRewriter(options); 

} 

app.UseStaticFiles(); 

app.Run(context => context.Response.WriteAsync( 

$"Rewritten or Redirected Url: " + 

$"{context.Request.Path + context.Request.QueryString}")); 

} 

extension Ve içi nörnekuygu lamadaki parametrelerindeğerleri,çeşitli koşul larauyacakşekildedenetlenir newPath 
Bir değer içermeli ve değer . png, .jpgveya . g(/olmalıdır. extension Geçerli değilse, bir ArgumentException 
oluşturulur. newPath İmage. png için bir istek yapılırsa, istek öğesine /png-images/image.png yeniden yönlendiril 
Image.jpgıçn bir istek yapılırsa, istek öğesine /jpg-images/image. jpg yeniden yönlendirilir. Durum kodu 301 
olarak ayarlanır ve kakçı olarak taşınırve context.Resuit kuralları işlemeyi durdur ve yanıtı gönder olarak 
ayarlanır. 








public class RedirectImageRequests : IRule 

{ 

private readonly string _extension; 
private readonly PathString _newPath; 

public RedirectImageRequests(string extension, string newPath) 

{ 

if (string.IsNullOrEmpty(extension)) 

{ 

throw new ArgumentException(nameof(extension)); 

} 

if (!Regex.IsMatch(extension, @" A \.(png|jpg|gif)$")) 

{ 

throw new ArgumentException("Invalid extension", nameof(extension)); 

} 

if (!Regex.IsMatch(newPath, @"(/[A-Za-z0-9]+)+?")) 

{ 

throw new ArgumentException("Invalid path", nameof(newPath)); 

} 


extension = extension; 

newPath = new PathString(newPath); 


public void ApplyRule(RewriteContext context) 

{ 

var request = context.HttpContext.Request; 

// Because we're redirecting back to the same appj stop 
// Processing if the request has already been redirected 
if (request.Path.StartsWithSegments(new PathString(_newPath))) 
{ 

return; 

} 


} 


if (request. Path. Value. EndsWith(_extension., StringComparison .OrdinalIgnoreCase)) 

{ 

var response = context.HttpContext.Response; 
response.StatusCode = StatusCodes.Status301MovedPermanently; 
context.Result = RuleResult.EndResponse; 
response.Headers[HeaderNames.Location] = 

_newPath + request.Path + request.QueryString; 

} 

} 


Özgün İstek: /image.png 



Özgün İstek: /image.jpg 















Regex örnekleri 


HEDEF 


REGEX DİZE & DEĞİŞTİRME DİZESİ & 

MATCH ÖRNEĞİ ÇIKIŞ ÖRNEĞİ 


Yolu QueryString 'e yeniden yazın 


A path/(.*)/(.* 

) 


path?varl=$l&var2=$2 


/path/abc/123 


/path?varl=abc&var2=123 


Eğik çizgiyi çıkar 

(■*)/$ 

$1 


/path/ 

/path 


Sondaki eğik çizgiyi zorla 


$1/ 


/path 

/path/ 


Belirli istekleri yeniden yazmayı önleyin 

A (.*)(?<!\.axd)$ veya 

rewritten/$l 


A (?!.*\.axd$)(.*)$ 

/rewnitten/resource.htm 


Yes /resource.htm 

/resource.axd 


Eşleşen /resource.axd 



URL segmentlerini yeniden Düzenle 


path/(.*)/( 

■*)/(•*) 

path/l/2/B 



path/$3/$2/$l 

path/3/2/1 


URL segmentini değiştirme 


A (. *)/segment2/(.*) 
/segmentl/segment2/segment3 


$l/replaced/$2 

/segmentl/neplaced/segment3 


Ek kaynaklar 

• ASP.NET Core'de uygulama başlatma 

• ASP.NET Core ara yazılımı 

• .NET 'teki normal ifadeler 

• Normal ifade dili-hızlı başvuru 

• Apache mod_rewrite 

• URL yeniden yazma modülünü kullanma 2,0 (IIS için) 

• URL yeniden yazma modülü yapılandırma başvurusu 

• IIS URL yeniden yazma modülü Forumu 

• Basit URL yapısını saklama 

• 10 URL yeniden yazma İpuçları ve püf noktaları 

• Eğik çizgi veya eğik çizgi 













Steve Smith ve Luke Latham tarafından 

ASP.NET Core dosya sistemi erişimini dosya sağlayıcılarının kullanımı üzerinden soyutlar. Dosya sağlayıcıları 
ASP.NET Core Framevvork boyunca kullanılır: 

• ıwebHostEnvironment , uygulamanın içerik kökünü ve Web kökünü iFileProvider türleri olarak kullanıma sunar. 

• Statik dosya ara yazılımı , statik dosyaları bulmak İçin dosya sağlayıcılarını kullanır. 

• Razor , sayfa ve görünümleri bulmak İçin dosya sağlayıcılarını kullanır. 

• .N ET Core araçları, hangi dosyaların yayımlanacak olduğunu belirlemek için dosya sağlayıcılarını ve glob 
düzenlerini kullanır. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 


Dosya sağlayıcısı arabirimleri 


Birincil arabirim İFileProvider. İFileProvider şu yöntemleri sunar: 

• Dosya bilgilerini edinin (IFİlelnfo). 

• Dizin bilgilerini al (IDİrectoryContents). 

• Değişiklik bildirimlerini ayarlayın (IChangeTokenkullanarak). 

iFileinfo dosyalarla çalışma için yöntemler ve özellikler sağlar: 

• Exists 

• IsDirectory 

• Name 

• Length (bayt) 

• LastModified tarihi 

Ifileınfo. CreateReadStream yöntemini kullanarak dosyadan okuma yapabilirsiniz. 

Örnek uygulama, bağımlılık eklemeyoluyla uygulama genelinde kullanılmak üzere startup.configuneSenvices bir 
dosya sağlayıcısının nasıl yapılandırılacağını gösterir. 


Dosya sağlayıcısı uygulamaları 


İFileProvider üç uygulaması mevcuttur. 


UYGULAMA 


AÇIKLAMA 


PhysicalFileProvider 


Fiziksel sağlayıcı, sistemin fiziksel dosyalarına erişmek için 
kullanılır. 


Bildirimli Estembeddedfileprovider 


Bildirimde yerleşik olarak bulunan dosyalara erişmek için 
bildirim eklenmiş sağlayıcı kullanılır. 


CompositeFileProvider 


Bileşik sağlayıcı, bir veya daha fazla sağlayıcıdan gelen 
dosyalara ve dizinlere Birleşik erişim sağlamak için kullanılır. 













PhysicalFileProvider 

PhysicalFileProvider, fiziksel dosya sistemine erişim sağlar. PhysicalFileProvider , System.10.File türünü (fiziksel 
sağlayıcı için) ve tüm yolları bir dizine ve alt öğelerine kullanır. Bu kapsam, belirtilen dizin ve alt öğeleri dışındaki 
dosya sistemine erişimi engeller. PhysicalFileProvider oluşturmak ve kullanmak için en yaygın senaryo, bağımlılık 
eklemearacılığıyla oluşturucuda bir iFileProvider istemaktır. 

Bu sağlayıcıyı doğrudan örnekleyen bir dizin yolu gereklidir ve sağlayıcı kullanılarak yapılan tüm isteklerin temel 
yolu olarak görev yapar. 

Aşağıdaki kod, PhysicalFileProvider oluşturma ve dizin içeriğini ve dosya bilgilerini elde etmek için nasıl 
kullanacağınızı gösterir: 

var provider = new PhysicalFileProvider(applicationRoot); 
var contents = provider.GetDirectoryContents(string.Empty); 
var filelnfo = provider.GetFileInfo("wwwroot/js/site.js"); 

Önceki örnekteki türler: 


provider 

bir 

İFileProvider 


contents 

bir 

IDirectoryContents 

filelnfo 

bir 

IFİlelnfo 



Dosya sağlayıcısı, appiicationRoot tarafından belirtilen dizin üzerinden yinelemek veya bir dosyanın bilgilerini 
almak için GetFileinfo çağırmak üzere kullanılabilir. Dosya sağlayıcısının appiicationRoot Directory dışında 
erişimi yok. 

Örnek uygulama, ıhostingenvironment. ContentRootFileProviderkullanarak sağlayıcıyı uygulamanın 
Startup.ConfigureServices sınıfında oluşturur: 

var physicalProvider = _env.ContentRootFileProvider; 

Bildirimli Estembeddedfileprovider 

ManifestEmbeddedFileProvider, derlemeler içine katıştırılmış dosyalara erişmek için kullanılır. 
ManifestEmbeddedFileProvider gömülü dosyaların özgün yollarını yeniden oluşturmak için derlemeye derlenen bir 
bildirim kullanır. 

Microsoft. Extensions. FileProviders. Embedded paketi için projeye bir paket başvurusu ekleyin. 

Katıştırılmış dosyaların bir bildirimini oluşturmak için <GenerateEmbeddedFiiesManifest> özelliğini true olarak 
ayarlayın. <EmbeddedResource >eklemek için dosyaları belirtin: 














<Project Sdk="Microsoft.NET.Sdk.Web"> 

<PropertyGroup> 

<TargetFramework>netcoreapp3.0</TargetFrameworl<> 

<GenerateEmbeddedFilesManifest>true</GenerateEmbeddedFilesManifest> 

</PropertyGroup> 

<ItemGroup> 

<PackageReference Include="Microsoft.Extensions.FileProviders.Embedded" Version="3.0.0" /> 
</ItemGroup> 

<ItemGroup> 

<EmbeddedResource Include="Resource.txt" /> 

</ItemGroup> 

</Project> 


Derlemeye eklemek üzere bir veya daha fazla dosya belirtmek için Glob desenlerini kullanın. 

Örnek uygulama bir ManifestEmbeddedFileProvider oluşturur ve şu anda yürütülen derlemeyi oluşturucuya geçirir. 
Startup.es : 

var manifestEmbeddedProvider = 

new ManifestEmbeddedFileProvider(typeof(Program).Assembly); 


Ek aşırı yüklemeler şunları yapmanıza olanak sağlar: 

• Göreli bir dosya yolu belirtin. 

• Dosya kapsamını son değiştirilme tarihine kadar. 

• Katıştırılmış dosya bildirimini içeren gömülü kaynağı adlandırın. 

AŞIRI YÜKLEME AÇIKLAMA 

ManifestEmbeddedFileProvider (Assembly j string) isteğe bağlı root göreli yol parametresini kabul eder. 

Belirtilen yol altında bu kaynaklara GetDirectoryContents 
yapılan çağrıların kapsamını belirlemek için root belirtin. 


ManifestEmbeddedFileProvider(Assembly, String, 

isteğe bağlı 

root 

göreli yol parametresini ve 

lastModified 

DateTimeOffset) 

Tarih (DateTimeOffset) parametresini kabul eder. 


lastModif ied tarihi, IFİleProvidertarafından döndürülen 
IFİlelnfo örneklerinin son değiştirilme tarihini kapsamlar. 


ManifestEmbeddedFileProvider(Assembly, String, 
String, DateTimeOffset) 


isteğe bağlı root göreli yolunu, lastModified tarihini ve 
manifestName parametrelerini kabul eder. manifestName , 
bildirimi içeren gömülü kaynağın adını temsil eder. 


CompositeFileProvider 

CompositeFileProvider, birden fazla sağlayıcıdan dosyalarla çalışmak için tek bir arabirim ortaya çıkaran 


IFileProvider 

örneklerini birleştirir. 

CompositeFileProvider oluştururken, bir veya daha fazla 

IFileProvider 


örneğini oluşturucusuna geçirin. 


Örnek uygulamada, bir 

PhysicalFileProvider 

ve bir 

ManifestEmbeddedFileProvider 

, uygulamanın hizmet 

kapsayıcısına kayıtlı bir 

CompositeFileProvider 

dosya sağlar: 


















var physicalProvider = _env.ContentRootFileProvider; 
var manifestEmbeddedProvider = 

new ManifestEmbeddedFileProvider(typeof(Program) .Assembly); 
var compositeProvider = 

new CompositeFileProvider(physicalProvider., manifestEmbeddedProvider); 
Services.AddSingleton<IFileProvider>(compositeProvider); 


Değişiklikleri izle 

IFileProvider. Watch yöntemi, değişiklikler için bir veya daha fazla dosya ya da dizin izlemek üzere bir senaryo 
sağlar. watch , birden çok dosya belirtmek için Glob desenlerini içerebilen bir yol dizesi kabul eder. watch 
IChangeTokendöndürür. Değişiklik belirteci şunları gösterir: 

• HasChanged bir değişikliğin oluşup gerçekleşmediğine yönelik olarak incelenebilir bir özellik -. 

• Belirtilen yol dizesinde değişiklikler algılandığında RegisterChangeCalIback - çağırılır. Her değişiklik belirteci 
yalnızca, ilişkili geri çağırma işlemini tek bir değişikliğe yanıt olarak çağırır. Sabit izlemeyi etkinleştirmek için bir 
TaskCompletionSource<TResult> kullanın (aşağıda gösterildiği gibi) veya değişikliklere yanıt olarak 

ıchangeToken örnekleri yeniden oluşturun. 

Örnek uygulamada, WatchConsole konsol uygulaması bir metin dosyası her değiştirildiğinde bir ileti 
görüntüleyecek şekilde yapılandırılmıştır: 

private static PhysicalFileProvider _fileProvider = 

new PhysicalFileProvider(Directory.GetCurrentDirectoryO); 

public static void Main(string[] args) 

{ 

Console.Writel_ine("Monitoring quotes.txt for changes (Ctrl-c to quit)..."); 

while (true) 

{ 

MainAsync().GetAwaiter().GetResult(); 

} 

} 

private static async Task MainAsync() 

{ 

IChangeToken token = _fileProvider.WatchCquotes.txt"); 
var tcs = new TaskCompletionSource<object>(); 

token.RegisterChangeCalIback(state => 

((TaskCompletionSource<object>)state). TrySetResult(null)., tcs); 

await tcs.Task.ConfigureAwait(false); 

Console.Writel_ine("quotes .txt changed"); 

} 

Docker kapsayıcıları ve ağ paylaşımları gibi bazı dosya sistemleri, değişiklik bildirimlerini güvenilir bir şekilde 
gönderemeyebilir. Dosya sistemini her dört saniyede bir değişiklikler için yoklamak için 
dotnet_use_polling_file_watcher ortam değişkenini ı veya true olarak ayarlayın (yapılandırılamaz). 

Glob desenleri 

Dosya sistemi yolları, Glob (veya glob) desenleriad\\ joker karakter desenleri kullanır. Bu desenlerle dosya gruplarını 
belirtin, iki joker karakter * ve ** : 










Geçerli klasör düzeyindeki her şeyi, dosya adını veya herhangi bir dosya uzantısını eşleştirir. Eşleşmeler dosya 
yolundaki / ve . karakterleri ile sonlandırılır. 

** 

Birden çok dizin düzeyindeki tüm öğeleri eşleştirir., Bir Dizin hiyerarşisinde birçok dosya yinelemeli olarak 
eşleşmek için kullanılabilir. 

Glob deseninin örnekleri 

directory/f ile.txt 

Belirli bir dizindeki belirli bir dosyayla eşleşir, 
directory/*.txt 

Belirli bir dizinde. txt uzantılı tüm dosyaları eşleştirir, 
directory/*/appsettings.json 

Dizinler içindeki tüm appsettings. json dosyalarla Dizin klasörünün altında tam olarak bir düzey eşleşir, 
directory/**/*.txt 

. Txt uzantılı tüm dosyaları, Dizin klasörünün altında herhangi bir yerde buldu. 

ASP.NET Core dosya sistemi erişimini dosya sağlayıcılarının kullanımı üzerinden soyutlar. Dosya sağlayıcıları 
ASP.NET Core Framevvork boyunca kullanılır: 

• IHostingEnvironment, uygulamanın içerik kökünü ve Web kökünü iFileProvider türleri olarak kullanıma sunar. 

• Statik dosya ara yazılımı , statik dosyaları bulmak İçin dosya sağlayıcılarını kullanır. 

• Razor , sayfa ve görünümleri bulmak İçin dosya sağlayıcılarını kullanır. 

• ,N ET Core araçları, hangi dosyaların yayımlanacak olduğunu belirlemek için dosya sağlayıcılarını ve glob 
düzenlerini kullanır. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Dosya sağlayıcısı arabirimleri 

Birincil arabirim İFileProvider. İFileProvider şu yöntemleri sunar: 

• Dosya bilgilerini edinin (IFİlelnfo). 

• Dizin bilgilerini al (IDİrectoryContents). 

• Değişiklik bildirimlerini ayarlayın (IChangeTokenkullanarak). 

iFileinfo dosyalarla çalışma için yöntemler ve özellikler sağlar: 

• Exists 

• IsDirectory 

• Name 

• Length (bayt) 

• LastModified tarihi 

Ifileınfo. CreateReadStream yöntemini kullanarak dosyadan okuma yapabilirsiniz. 

Örnek uygulama, bağımlılık eklemeyoluyla uygulama genelinde kullanılmak üzere startup.configureSenvices bir 
dosya sağlayıcısının nasıl yapılandırılacağını gösterir. 

Dosya sağlayıcısı uygulamaları 

İFileProvider üç uygulaması mevcuttur. 

















UYGULAMA 


AÇIKLAMA 


PhysicalFileProvider 


Fiziksel sağlayıcı, sistemin fiziksel dosyalarına erişmek için 
kullanılır. 


Bildirimli Estembeddedfileprovider 


Bildirimde yerleşik olarak bulunan dosyalara erişmek için 
bildirim eklenmiş sağlayıcı kullanılır. 


CompositeFileProvider Bileşik sağlayıcı, bir veya daha fazla sağlayıcıdan gelen 

dosyalara ve dizinlere Birleşik erişim sağlamak için kullanılır. 


PhysicalFileProvider 

PhysicalFileProvider, fiziksel dosya sistemine erişim sağlar. PhysicalFileProvider , System.10.File türünü (fiziksel 
sağlayıcı için) ve tüm yolları bir dizine ve alt öğelerine kullanır. Bu kapsam, belirtilen dizin ve alt öğeleri dışındaki 
dosya sistemine erişimi engeller. PhysicalFileProvider oluşturmak ve kullanmak için en yaygın senaryo, bağımlılık 
eklemearacılığıyla oluşturucuda bir iFileProvider istemaktır. 

Bu sağlayıcıyı doğrudan örnekleyen bir dizin yolu gereklidir ve sağlayıcı kullanılarak yapılan tüm isteklerin temel 
yolu olarak görev yapar. 

Aşağıdaki kod, PhysicalFileProvider oluşturma ve dizin içeriğini ve dosya bilgilerini elde etmek için nasıl 
kullanacağınızı gösterir: 

var provider = new PhysicalFileProvider(applicationRoot); 
var contents = provider.GetDirectoryContents(string.Empty); 
var filelnfo = provider.GetFileInfo("wwwroot/js/site.js"); 

Önceki örnekteki türler: 


provider 

bir 

İFileProvider 


contents 

bir 

IDirectoryContents 

filelnfo 

bir 

IFİlelnfo 



Dosya sağlayıcısı, appiicationRoot tarafından belirtilen dizin üzerinden yinelemek veya bir dosyanın bilgilerini 
almak için GetFileinfo çağırmak üzere kullanılabilir. Dosya sağlayıcısının appiicationRoot Directory dışında 
erişimi yok. 

Örnek uygulama, ıhostingenvironment. ContentRootFileProviderkullanarak sağlayıcıyı uygulamanın 
Startup.ConfigureServices sınıfında oluşturur: 

var physicalProvider = _env.ContentRootFileProvider; 

Bildirimli Estembeddedfileprovider 

ManifestEmbeddedFileProvider, derlemeler içine katıştırılmış dosyalara erişmek için kullanılır. 
ManifestEmbeddedFileProvider gömülü dosyaların özgün yollarını yeniden oluşturmak için derlemeye derlenen bir 
bildirim kullanır. 

Katıştırılmış dosyaların bir bildirimini oluşturmak için <GenerateEmbeddedFiiesManifest> özelliğini true olarak 
ayarlayın. <EmbeddedResource>eklemek için dosyaları belirtin: 












<Project Sdk="Microsoft.NET.Sdk.Web"> 

<PropertyGroup> 

<TargetFramework>netcoreapp2.2</Target Frameworl<> 
<AspNetCoreHostingModel>InProcess</AspNetCoreHostingModel> 
<GenerateEmbeddedFilesManifest>true</GenerateEmbeddedFilesManifest> 
</PropertyGroup> 

<ItemGroup> 

<PackageReference Include="Microsoft.AspNetCore.App" /> 

</ItemGroup> 

<ItemGroup> 

<EmbeddedResource Include="Resource.txt" /> 

</ItemGroup> 

</Project> 


Derlemeye eklemek üzere bir veya daha fazla dosya belirtmek için Glob desenlerini kullanın. 

Örnek uygulama bir ManifestEmbeddedFileProvider oluşturur ve şu anda yürütülen derlemeyi oluşturucuya geçirir. 
Startup.es : 

var manifestEmbeddedProvider = 

new ManifestEmbeddedFileProvider(typeof(Program).Assembly); 


Ek aşırı yüklemeler şunları yapmanıza olanak sağlar: 

• Göreli bir dosya yolu belirtin. 

• Dosya kapsamını son değiştirilme tarihine kadar. 

• Katıştırılmış dosya bildirimini içeren gömülü kaynağı adlandırın. 

AŞIRI YÜKLEME AÇIKLAMA 

ManifestEmbeddedFileProvider (Assembly j string) isteğe bağlı root göreli yol parametresini kabul eder. 

Belirtilen yol altında bu kaynaklara GetDirectoryContents 
yapılan çağrıların kapsamını belirlemek için root belirtin. 


ManifestEmbeddedFileProvider(Assembly, String, 

isteğe bağlı 

root 

göreli yol parametresini ve 

lastModified 

DateTimeOffset) 

Tarih (DateTimeOffset) parametresini kabul eder. 


lastModif ied tarihi, IFİleProvidertarafından döndürülen 
IFİlelnfo örneklerinin son değiştirilme tarihini kapsamlar. 


ManifestEmbeddedFileProvider(Assembly, String, 
String, DateTimeOffset) 


isteğe bağlı root göreli yolunu, lastModified tarihini ve 
manifestName parametrelerini kabul eder. manifestName , 
bildirimi içeren gömülü kaynağın adını temsil eder. 


CompositeFileProvider 

CompositeFileProvider, birden fazla sağlayıcıdan dosyalarla çalışmak için tek bir arabirim ortaya çıkaran 


IFileProvider 

örneklerini birleştirir. 

CompositeFileProvider oluştururken, bir veya daha fazla 

IFileProvider 


örneğini oluşturucusuna geçirin. 


Örnek uygulamada, bir 

PhysicalFileProvider 

ve bir 

ManifestEmbeddedFileProvider 

, uygulamanın hizmet 

kapsayıcısına kayıtlı bir 

CompositeFileProvider 

dosya sağlar: 




















var physicalProvider = _env.ContentRootFileProvider; 
var manifestEmbeddedProvider = 

new ManifestEmbeddedFileProvider(typeof(Program) .Assembly); 
var compositeProvider = 

new CompositeFileProvider(physicalProvider., manifestEmbeddedProvider); 
Services.AddSingleton<IFileProvider>(compositeProvider); 


Değişiklikleri izle 

IFileProvider. Watch yöntemi, değişiklikler için bir veya daha fazla dosya ya da dizin izlemek üzere bir senaryo 
sağlar. watch , birden çok dosya belirtmek için Glob desenlerini içerebilen bir yol dizesi kabul eder. watch 
IChangeTokendöndürür. Değişiklik belirteci şunları gösterir: 

• HasChanged bir değişikliğin oluşup gerçekleşmediğine yönelik olarak incelenebilir bir özellik -. 

• Belirtilen yol dizesinde değişiklikler algılandığında RegisterChangeCalIback - çağırılır. Her değişiklik belirteci 
yalnızca, ilişkili geri çağırma işlemini tek bir değişikliğe yanıt olarak çağırır. Sabit izlemeyi etkinleştirmek için bir 
TaskCompletionSource<TResult> kullanın (aşağıda gösterildiği gibi) veya değişikliklere yanıt olarak 

ıchangeToken örnekleri yeniden oluşturun. 

Örnek uygulamada, WatchConsole konsol uygulaması bir metin dosyası her değiştirildiğinde bir ileti 
görüntüleyecek şekilde yapılandırılmıştır: 

private static PhysicalFileProvider _fileProvider = 

new PhysicalFileProvider(Directory.GetCurrentDirectoryO); 

public static void Main(string[] args) 

{ 

Console.Writel_ine("Monitoring quotes.txt for changes (Ctrl-c to quit)..."); 

while (true) 

{ 

MainAsync().GetAwaiter().GetResult(); 

} 

} 

private static async Task MainAsync() 

{ 

IChangeToken token = _fileProvider.WatchCquotes.txt"); 
var tcs = new TaskCompletionSource<object>(); 

token.RegisterChangeCalIback(state => 

((TaskCompletionSource<object>)state). TrySetResult(null)., tcs); 

await tcs.Task.ConfigureAwait(false); 

Console.Writel_ine("quotes .txt changed"); 

} 

Docker kapsayıcıları ve ağ paylaşımları gibi bazı dosya sistemleri, değişiklik bildirimlerini güvenilir bir şekilde 
gönderemeyebilir. Dosya sistemini her dört saniyede bir değişiklikler için yoklamak için 
dotnet_use_polling_file_watcher ortam değişkenini ı veya true olarak ayarlayın (yapılandırılamaz). 

Glob desenleri 

Dosya sistemi yolları, Glob (veya glob) desenleriad\\ joker karakter desenleri kullanır. Bu desenlerle dosya gruplarını 
belirtin, iki joker karakter * ve ** : 










Geçerli klasör düzeyindeki her şeyi, dosya adını veya herhangi bir dosya uzantısını eşleştirir. Eşleşmeler dosya 
yolundaki / ve . karakterleri ile sonlandırılır. 

** 

Birden çok dizin düzeyindeki tüm öğeleri eşleştirir., Bir Dizin hiyerarşisinde birçok dosya yinelemeli olarak 
eşleşmek için kullanılabilir. 

Glob deseninin örnekleri 

directory/file.txt 

Belirli bir dizindeki belirli bir dosyayla eşleşir, 
directory/*.txt 

Belirli bir dizinde. txt uzantılı tüm dosyaları eşleştirir, 
directory/*/appsettings.json 

Dizinler içindeki tüm appsettings. json dosyalarla Dizin klasörünün altında tam olarak bir düzey eşleşir, 
directory/**/*.txt 

. Txt uzantılı tüm dosyaları, Dizin klasörünün altında herhangi bir yerde buldu. 
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Tarafından Steve Smith 

Web sunucusu uygulaması ayrıntıları HTTP istekleriyle ilgili ve yanıtları arabirimlerde tanımlanır. Bu arabirimler, 
uygulamanın barındırma işlem hattı oluşturup için sunucu uygulamaları ve ara yazılım tarafından kullanılır. 

Özelliği arabirimleri 

ASP.NET Core tanımlayan bir dizi HTTP özelliği arabirimlerde Microsoft.AspNetcore.Http.Features 
destekledikleri özellikleri tanımlamak için sunucuları tarafından kullanılır. Aşağıdaki özellik arabirimleri isteklerini 
işlemek ve yanıtları döndürür: 

iHttpRequestFeature Protokol, yol, sorgu dizesi, üstbilgi ve gövde içeren bir HTTP isteği yapısını tanımlar. 

iHttpResponseFeature Bir HTTP yanıtının durum kodu, üst bilgiler ve yanıt gövdesinin gibi yapısını tanımlar. 

iHttpAuthenticationFeature Temel kullanıcı tanımlamaya yönelik desteği tanımlar bir ciaimsPrincipai belirterek 
bir kimlik doğrulama işleyicisi. 

Desteğini tanımlar HTTP yükseltmeleri, istemci, ek protokoller belirtmek izin veren sunucu 
stiyorsa kullanmak istiyorsunuz. 

iHttpBufferingFeature istek ve/veya yanıtlarını arabelleğe almayı devre dışı bırakmak için yöntemleri tanımlar. 

iHttpConnectionFeature Yerel ve uzak adresler ve bağlantı noktaları için özellikleri tanımlar. 

iHttpReqııestı_ifetimeFeature Bağlantıları durduruluyor ya da bir isteği beklenenden önce gibi olarak bir istemci 
bağlantıyı kesme tarafından sonlanıp sonlanmadığını algılama desteği tanımlar. 

iHttpSendFileFeature Dosyaları zaman uyumsuz olarak gönderme yöntemi tanımlar. 

iHttpwebSocketFeature Web yuvaları desteklemek için bir API tanımlar. 

iHttpReqııestidentifierFeature İstekleri benzersiz olarak tanımlanabilmesi için uygulanan bir özellik ekler. 
ısessionFeature Tanımlar ısessionFactory ve ısession soyutlama kullanıcı oturumlarını destekleme. 
iîisConnectionFeature istemci sertifikaları almak için bir API tanımlar. 

iTisîokenBindingFeature TLS belirteç bağlama parametreleri ile çalışmak için yöntemleri tanımlar. 

NOTE 

ısessionFeature Sunucu özelliği olmayan, ancak tarafından uygulanan sessionMiddleware (bkz yönetme uygulama 
durumu). 


IHttpUpgradeFeature 
protokolleri geçmek i 


Özellik koleksiyonları 

Featunes Özelliği HttpContext alma ve ayarlama geçerli istek için kullanılabilir HTTP özellikleri için bir arabirim 
sağlar. Özellik koleksiyonu bile bir istek bağlamı içinde değişebilir olduğundan, ara yazılım koleksiyonu 
değiştirmek ve ek özellikleri için destek eklemek için kullanılabilir. 























Ara yazılım ve istek özellikleri 

Sunucuları özellik koleksiyonu oluşturmaktan sorumlu olsa da, ara yazılım bu koleksiyona eklemek hem 
koleksiyonunun özelliklerini kullanmak olabilir. Örneğin, staticFiieMiddieware erişen İHttpSendFileFeature 
özelliği. Özellik zaten varsa, fiziksel yolundan istenen statik dosya göndermek için kullanılır. Aksi takdirde, daha 
yavaş bir alternatif yöntem dosyayı göndermek için kullanılır. Kullanılabilir olduğunda, İHttpSendFileFeature 
dosyasını açın ve bir ağ kartına doğrudan çekirdek modu kopyalama işlemini gerçekleştirmek işletim sistemi 
sağlar. 

Ayrıca, Ara sunucu tarafından oluşturulan özellik koleksiyonu ekleyebilirsiniz. Mevcut özellikler bile Ara sunucu 
işlevlerini genişletmek izin verme ara yazılımı tarafından değiştirilebilir. Koleksiyona eklenen özellikler, diğer ara 
yazılımdan veya temel uygulamada kendisini daha sonra istek ardışık düzenini için hemen kullanılabilir. 

Özel sunucu uygulamaları ve belirli bir ara yazılım geliştirmeler birleştirerek özellikleri gerektiren bir uygulama 
hassas dizi oluşturulabilir. Eksik sunucu değişikliğe gerek kalmadan eklenecek özellikleri ve yalnızca en az 
miktarda özellikler sunulur, böylece saldırı sınırlama sağlar böylece yüzey alanını ve performansını iyileştirme. 

Özet 

Özellik arabirimler, belirtilen bir isteğin destekleyebilir belirli HTTP özellikleri tanımlar.Özellikleri koleksiyonları 
ve sunucu tarafından desteklenen özellikler ilk dizi sunucuları tanımlamak, ancak ara yazılım, bu özellikleri 
geliştirmek için kullanılabilir. 

Ek kaynaklar 

• Sunucular 

• Ara Yazılım 

• .NET için Açık Web Arabirimi (OWIN) 





ASPNET Core 'de HttpContext 'e erişme 
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IHttpContextAccessor arabirimi ve varsayılan uygulama HttpContextAccessorASP.NET Core uygulamalara erişim 
HttpContext . Yalnızca bir hizmet içindeki HttpContext erişmeniz gerektiğinde iHttpContextAccessor kullanılması 
gerekir. 

Razor Pages HttpContext kullanın 

Razor Pages PageModel HttpContext özelliğini kullanıma sunar: 

public class AboutModel : PageModel 
{ 

public string Message { get; set; } 

public void OnGet() 

{ 

Message = HttpContext.Request.PathBase; 

} 

} 


Razor görünümünden HttpContext kullanma 

Razor görünümleri görünümdeki bir RazorPage. Context özelliği aracılığıyla HttpContext doğrudan kullanıma 
sunar. Aşağıdaki örnek, VVİndovvs kimlik doğrulamasını kullanarak bir intranet uygulamasındaki geçerli kullanıcı 
adını alır: 

var username = Context.User.Identity.Name; 

} 


Bir denetleyiciden HttpContext kullanma 

Denetleyiciler ControllerBase. HttpContext özelliğini kullanıma sunar: 

public class HomeController : Controller 
{ 

public IActionResult About() 

{ 

var pathBase = HttpContext.Request.PathBase; 


return View(); 

} 

} 


Ara yazılım içinden HttpContext kullanın 


Özel ara yazılım bileşenleriyle çalışırken, HttpContext 


invoke veya invokeAsync yöntemine geçirilir ve ara yazılım 














yapılandırıldığında erişilebilir: 


public class MyCustomMiddleware 

{ 

public Task InvokeAsync(HttpContext context) 

{ 

} 

} 


Özel bileşenlerden HttpContext kullanın 

HttpContext erişmesi gereken diğer Framework ve özel bileşenler için önerilen yaklaşım, yerleşik bağımlılık ekleme 
kapsayıcısını kullanarak bir bağımlılığı kaydetmesidir. Bağımlılık ekleme kapsayıcısı, iHttpContextAccessor 
oluşturuculara bir bağımlılık olarak bildiren tüm sınıflara sağlar: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddControllersWithViews(); 

Services.AddHttpContextAccessor(); 

Services.AddTransientcIUserRepository, UserRepository>(); 

} 


public void ConfigureServices(IServiceCollection Services) 

{ 

Services .AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 
Services.AddHttpContextAccessor(); 

Services.AddTransientcIUserRepository, UserRepository>(); 

} 


Aşağıdaki örnekte: 


• UserRepository IHttpContextAccessor bağımlılığım bildirir. 

• Bağımlılık ekleme, bağımlılık zincirini çözdüğünde ve bir UserRepository örneği oluşturduğunda bağımlılık 
sağlanır. 

public class UserRepository : IUserRepository 

{ 

private readonly IHttpContextAccessor _httpContextAccessor; 

public UserRepository(IHttpContextAccessor httpContextAccessor) 

{ 

_httpContextAccessor = httpContextAccessor; 

} 

public void LogCurrentUser() 

{ 

var username = _httpContextAccessor.HttpContext.User.Identity.Name; 
service.LogAccessRequest(username); 

} 

} 


Arka plan iş parçacığından HttpContext erişimi 

HttpContext iş parçacığı açısından güvenli değildir. HttpContext bir isteği işlemenin dışında okuma veya yazma 
özellikleri NullReferenceExceptionsonuçlanabilir. 









NOTE 

Uygulamanız tek tek NullReferenceException hatalar oluşturursa, arka plan işlemeyi başlatan veya bir istek 
tamamlandıktan sonra işlemeye devam eden kodun bölümlerini gözden geçirin, async void olarak bir denetleyici yöntemi 
tanımlama gibi hataları arayın. 


HttpContext verilerle arka plan çalışmasını güvenle gerçekleştirmek için: 

• İstek işleme sırasında gerekli verileri kopyalayın. 

• Kopyalanmış verileri bir arka plan görevine geçirin. 

Güvenli olmayan koddan kaçınmak için HttpContext , arka plan çalışması gerçekleştiren bir yönteme hiçbir şekilde 
iletmeyin. Bunun yerine gerekli verileri geçirin. Aşağıdaki örnekte, bir e-posta göndermeye başlamak için 


SendEmailCore 

çağırılır. 

correlationld , 

HttpContext değil 

SendEmailCore 

geçirilir. Kod yürütme 

SendEmailCore 


tamamlanmasını beklemez: 

public class EmailController : Controller 

{ 

public IActionResult SendEmail(string email) 

{ 

var correlationld = HttpContext.Request.Headers["x-correlation-id"] .ToStringO; 
_ = SendEmailCore(correlationld); 
return View(); 

} 

private async Task SendEmailCore(string correlationld) 

{ 

} 

} 
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Tarafından Luke Latham 

Değişiklik belirteci, durum değişikliklerini izlemek için kullanılan genel amaçlı, düşük düzey bir yapı taşıdır. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Ichangetoken arabirimi 

IChangeToken bir değişikliğin gerçekleştiği bildirimleri yayar. ıchangeToken , Microsoft.Extensions.Primitives ad 
alanında bulunur. Microsoft. Extensions. İlkel öğeler NuGet paketi, ASP.NET Core uygulamalarına örtük olarak 
sağlanır. 

ıchangeToken iki özelliğe sahiptir: 

• ActiveChangeCalIbacks belirtecin, geri çağırmaları etkin bir şekilde harekete geçirmediğini belirtir. 

ActiveChangedCaiibacks faise olarak ayarlanırsa, bir geri çağırma hiçbir şekilde çağrılmaz ve uygulamanın 
değişiklikler için HasChanged yoklamalıdır. Hiçbir değişiklik gerçekleşmüyorsa veya temeldeki değişiklik 
dinleyicisi atıldığı veya devre dışı bırakıldığında belirtecin hiçbir şekilde iptal edilmemesi de mümkündür. 

• HasChanged bir değişikliğin oluşup gerçekleşmediğini gösteren bir değer alır. 

ıchangeToken arabirimi, belirteç değiştirildiğinde çağrılan bir geri aramayı kaydeden Registerchangecallback 
(Action<Object >, Object) yöntemini içerir. HasChanged , geri çağırma çağrılmadan önce ayarlanmalıdır. 

ChangeToken sınıfı 

ChangeToken, bir değişikliğin gerçekleştiği bildirimleri yaymak için kullanılan statik bir sınıftır. ChangeToken , 
Microsoft.Extensions.Primitives ad alanında bulunur. Microsoft. Extensions. İlkel öğeler NuGet paketi, ASP.NET 
Core uygulamalarına örtük olarak sağlanır. 

ChangeToken. OnChange (Func<IChannel>, Action) yöntemi, belirteç her değiştiğinde çağırmak için bir Action 
kaydeder: 



ChangeToken. OnChange<tstate > (Func<ıhangetoken >, Action-ctstate >, TState) aşırı yüklemesi, token tüketicisi 
Tstate geçirilen ek bir Action parametresini alır. 

OnChange I Disposabledöndürür. Dispose çağırmak, belirteci daha fazla değişiklik için dinlemeyi durdurup 
belirtecin kaynaklarını serbest bırakır. 

ASP.NET Core değişiklik belirteçlerinin örnek kullanımları 

Değişiklik belirteçleri, nesnelerde yapılan değişiklikleri izlemek için ASP.NET Core belirgin alanlarında kullanılır: 

• Dosyalarda yapılan değişiklikleri izlemek için, IFİleProviderVVatch yöntemi, belirtilen dosya veya klasör için 
izlemek üzere bir ıchangetoken oluşturur. 

















• değişiklik üzerine önbellek çıkarmaları tetiklemek için, ıchangeToken belirteçleri önbellek girişlerine eklenebilir. 

• TOptions değişiklikler için IOptionsMonitor<TOptions> varsayılan OptionsMonitor<TOptions> 
uygulamasının bir veya daha fazla IOptionsChangeTokenSource<TOptions> örneğini kabul eden bir aşırı 
yüklemesi vardır. Her örnek, izleme seçenekleri değişiklikleri için değişiklik bildirimi geri aramasını kaydetmek 
üzere bir ıchangeToken döndürür. 

Yapılandırma değişikliklerini izle 

Varsayılan olarak, ASP.N ET Core şablonlar JSON yapılandırma dosyalarını ( appSettings. JSON, appSettings) 
kullanır. Developmerıt. JSONve appSettings. Üretim. JSON), uygulama yapılandırma ayarlarını yükler. 

Bu dosyalar, bir reloadOnChange parametresini kabul eden ConfigurationBuilder için Addjsonfile (ıseationbuilder, 
String, Boolean, Boolean) genişletme yöntemi kullanılarak yapılandırılır. reloadOnChange , yapılandırmanın dosya 
değişikliklerinde yeniden yüklenmesi gerekip gerekmediğini gösterir. Bu ayar Hoşt kullanışlı yöntemde 
görüntülenir CreateDefaultBuilder: 

config.AddDsonFile("appsettings.json"j optional: true, reloadOnChange: true) 
.AddlsonFile($"appsettings.{env.EnvlronmentName}.json", optional: true, 
reloadOnChange: true); 

Dosya tabanlı yapılandırma FileConfigurationSourcetarafından temsil edilir. FiieConfigurationSource dosyaları 
izlemek için I FileProvider kullanır. 

Varsayılan olarak iFileMonitor , yapılandırma dosyası değişikliklerini izlemek için FileSystemVVatcher kullanan bir 
PhysicalFileProvidertarafından sağlanır. 

Örnek uygulama, yapılandırma değişikliklerini izlemek için iki uygulama gösterir.AppSettings dosyalarından 
herhangi biri değiştiğinde, dosya izleme uygulamalarının her ikisi de özel kod yürütür—örnek uygulama konsola 
bir ileti yazar. 

Yapılandırma dosyası FiieSystemwatcher , tek bir yapılandırma dosyası değişikliği için birden çok belirteç geri 
çağırmaları tetikleyebilir. Özel kodun, birden fazla belirteç geri çağırma işlemi tetiklendiğinde yalnızca bir kez 
çalıştığından emin olmak için, örnek uygulama dosya karmalarını denetler. Örnek, SHA1 dosya karma kullanır.Bir 
yeniden deneme, üstel geri dönme ile uygulanır. Dosya kilitlemesi, geçici olarak bir dosyada yeni bir karma işlem 
yapılmasını önleyen dosya kilitleme gerçekleşebileceğinden, yeniden deneme vardır. 

Yardımcı programlar/yardımcı programlar, cs: 











public static byte[] ComputeHash(string filePath) 

{ 

var runCount = 1; 

while(runCount < 4) 

{ 

try 

{ 

if (File.Exists(filePath)) 

{ 

using (var fs = File.OpenRead(filePath)) 

{ 

return System.Security.Cryptography.SHAİ 
.Create().ComputeHash(fs); 

} 

} 

else 

{ 

throw new FileNotFoundException(); 

} 

} 

catch (IOException ex) 

{ 

if (runCount == 3 || ex.HResult != -2147024864) 

{ 

throw; 

} 

else 

{ 

Thread.Sleep(TimeSpan.FromSeconds(Math.Pow(2, runCount))); 
runCount++; 

} 

} 

} 

return new byte[20]; 


Basit başlangıç değiştirme belirteci 

Değişiklik bildirimleri için bir belirteç tüketicisi Action geri çağırma işlemini yapılandırma yeniden yükleme 
belirtecine kaydedin. 


Startup.Configure : 

ChangeToken.OnChange( 

() => config.GetReloadToken(), 
(state) => InvokeChanged(state), 
env); 


config.GetReioadToken() belirteci sağlar. Geri çağırma invokechanged yöntemidir: 





private void InvokeChanged(IWebHostEnvironment env) 

{ 

byte[] appsettingsHash = ComputeHash("appSettings.json"); 
byte[] appsettingsEnvHash = 

ComputeHash($"appSettings.{env.EnvironmentName}.json"); 

if (!_appsettingsHash.SequenceEqual(appsettingsHash) | 

!_appsettingsEnvHash.SequenceEqual(appsettingsEnvHash)) 

{ 

_appsettingsHash = appsettingsHash; 

_appsettingsEnvHash = appsettingsEnvHash; 

WriteConsole("Configuration changed (Simple Startup Change Token)"); 

} 

} 

Geri aramanın state , izlenecek doğru appSettings yapılandırma dosyasını (örneğin, appSettings) belirtmek için 
yararlı olan ıwebHostEnvironment geçirmek için kullanılır. Geliştirme ortamında geliştirme. JSON ). Dosya 
karmaları, yapılandırma dosyası yalnızca bir kez değiştirildiğinde, birden çok belirteç geri çağırmaları nedeniyle 
writeConsoie deyimin birden çok kez çalışmasını engellemek için kullanılır. 

Uygulama çalıştığı sürece bu sistem çalışır ve Kullanıcı tarafından devre dışı bırakılamaz. 

Yapılandırma değişikliklerini hizmet olarak izle 

Örnek şunları uygular: 

• Temel başlangıç belirteci izleme. 

• Hizmet olarak izleme. 

• izlemeyi etkinleştirme ve devre dışı bırakma mekanizması. 

Örnek bir ıconfigurationMonitor arabirimi oluşturur. 

Uzantıiar/ConfigurationMonitor. cs: 

public interface ıconfigurationMonitor 

{ 

bool MonitoringEnabled { get; set; } 
string CurrentState { get; set; } 

} 

Uygulanan sınıfın Oluşturucusu configurationMonitor , değişiklik bildirimleri için bir geri çağırma kaydeder: 

public ConfigurationMonitor(IConfiguration config, IklebHostEnvironment env) 

{ 

_env = env; 

ChangeToken.OnChange<IConfigurationMonitor>( 

() => config.GetReloadToken(), 

InvokeChanged, 
this); 

} 

public bool MonitoringEnabled { get; set; } = false; 
public string CurrentState { get; set; } = "Not monitoring"; 

config.GetReioadToken() belirteci sağlar. invokeChanged geri çağırma yöntemidir. Bu örnekteki state , izleme 
durumuna erişmek için kullanılan ıconfigurationMonitor örneğine bir başvurudur, iki özellik kullanılır: 

• MonitoringEnabled -, geri aramanın özel kodunu çalıştırıp çalıştıramayacağını gösterir. 













CurrentState 


Kullanıcı arabirimindeki kullanım için geçerli izleme durumunu açıklar. 


invokechanged yöntemi önceki yaklaşımla benzerdir, bunun dışında: 


• MonitoringEnabled true olmadığı müddetçe kodunu çalıştırmaz. 

• Geçerli state writeConsoie çıktısındaki çıktısını verir. 


private void InvokeChanged(IConfigurationMonitor State) 

{ 

if (MonitoringEnabled) 

{ 

byte[] appsettingsHash = ComputeHash("appSettings.json"); 
byte[] appsettingsEnvHash = 

ComputeHash($"appSettings.(_env.EnvironmentName}.json"); 

if (!_appsettingsHash.SequenceEqual(appsettingsHash) | 

!_appsettingsEnvHash,SequenceEqual(appsettingsEnvHash)) 

{ 

string message = $"State updated at {DateTime.Now}"; 


appsettingsHash = appsettingsHash; 
appsettingsEnvHash = appsettingsEnvHash; 


} 


} 


} 


WriteConsole("Configuration changed (ConfigurationMonitor Class) 
$"{message}, State:{state.CurrentState}"); 


+ 


Bir örnek ConfigurationMonitor startup.configureServices bir hizmet olarak kaydedilir: 


Services.AddSingletoncIconfigurationMonitor, ConfigurationMonitor>(); 


Dizin sayfası, yapılandırma izleme üzerinde Kullanıcı denetimi sağlar. ıconfigurationMonitor örneği indexModei 
eklenmiş. 


Pages/lndex. cshtmi cs: 


public IndexModel( 

IConfiguration config, 

IconfigurationMonitor monitor, 

FileService fileService) 

{ 

_config = config; 

_monitor = monitor; 

_fileService = fileService; 

} 

Yapılandırma izleyicisi ( _monitor ), izlemeyi etkinleştirmek veya devre dışı bırakmak ve Ul geri bildirimi için 
geçerli durumu ayarlamak için kullanılır: 












public IActionResult OnPostStartMonitoringO 
{ 

_monitor.MonitoringEnabled = true; 

_monitor.CurrentState = "Monitoring! 

return RedirectToPage(); 

} 

public IActionResult OnPostStopMonitoring() 

{ 

_moniton.MonitoningEnabled = false; 

_monitor.CunrentState = "Not monitoning"; 

return RedirectToPage(); 

} 

onPoststartMonitoring tetiklendiğinde, izleme etkinleştirilir ve geçerli durum temizlenir. onPoststopMonitoring 
tetiklendiğinde, izleme devre dışıdır ve durum, izlemenin gerçekleşmediğinden emin olmak üzere ayarlanır. 

Kullanıcı arabirimindeki düğmeler izlemeyi etkinleştirir ve devre dışı bırakır. 

Sayfa/dizin. cshtml: 

<button class="btn btn-success" asp-page-handler="StartMonitoring"> 

Start Monitoring 
</button> 

<button class="btn btn-danger" asp-page-handler="StopMonitoring"> 

Stop Monitoring 
</button> 


Önbelleğe alınmış dosya değişikliklerini izle 

Dosya içeriği, IMemoryCachekullanarak bellek içi önbelleğe alınabilir. Bellek içi önbelleğe alma, bellek İçi önbellek 
konusunda açıklanmaktadır. Aşağıda açıklanan uygulama gibi ek adımlar uygulamadan, kaynak veriler değişirse 
önbellekten eski (eski) veriler döndürülür. 

Örneğin, bir kayan süre sonu dönemini yenilerken önbelleğe alınmış bir kaynak dosyanın durumu, eski önbelleğe 
alınmış dosya verilerine yol açar. Verilerin her isteği, Kayan süre sonu süresini yeniler, ancak dosya hiçbir zaman 
önbelleğe yeniden yüklenmez. Dosyanın önbelleğe alınmış içeriğini kullanan tüm uygulama özellikleri, büyük 
olasılıkla eski içerik alınmasına tabidir. 

Bir dosya önbelleğe alma senaryosunda değişiklik belirteçlerini kullanmak önbellekte eski dosya içeriğinin 
varlığını engeller. Örnek uygulama, yaklaşımın bir uygulamasını gösterir. 

Örnek, GetFileContent için şunu kullanır: 

• Dosya içeriğini döndürür. 

• Bir dosya kilidinin geçici olarak bir dosya okumayı engellediği durumları kapsamak için üstel geri ile yeniden 
deneme algoritması uygulayın. 


Yardıma programlar/yardımcı programlar, cs: 






public async static Task<string> GetFiİ 0 Content(string filePath) 

{ 

var runCount = 1; 

while(runCount < 4) 

{ 

try 

{ 

if (File.Exists(filePath)) 

{ 

using (var fileStreamReader = File.OpenText(filePath)) 

{ 

return await fileStreamReader.ReadToEndAsync(); 

} 

} 

else 

{ 

throw new FileNotFoundException(); 

} 

} 

catch (IOException ex) 

{ 

if (runCount == 3 | | ex.HResult != -2147024864) 

{ 

throw; 

} 

else 

{ 

await Task.Delay(TimeSpan.FromSeconds(Math.Pow(2j runCount))); 
runCount++; 

} 

} 

} 

return null; 

} 

Önbelleğe alınmış dosya aramalarını işlemek için bir FileService oluşturulur. Hizmet GetFileContent yöntemi 
çağrısı, bellek içi önbellekten dosya içeriğini almaya çalışır ve bunu çağırana {Serv'ıces/FileService. cs) döndürebilir. 

Önbellek anahtarı kullanılarak önbelleğe alınmış içerik bulunamazsa, aşağıdaki eylemler gerçekleştirilir: 

1. Dosya içeriği GetFileContent kullanılarak elde edilir. 

2. Dosya sağlayıcısından ıfileproviders. VVatchile bir değişiklik belirteci elde edilir. Dosya değiştirildiğinde 
belirtecin geri çağırması tetiklenir. 

3. Dosya içeriği bir kayan süre sonu süresiyle önbelleğe alınır. Değişiklik belirteci, önbelleğe alınmış 
durumdayken dosya değişirse önbellek girdisini çıkarmak için Memorycacheentryextensions. 
AddExpirationToken ile birlikte eklenir. 

Aşağıdaki örnekte, dosyalar uygulamanın içerik kökündesaklanır. ıwebHostEnvironment.contentRootFiieProvider , 
uygulamanın ıwebHostEnvironment.contentRootPath işaret eden bir IF ileProvider elde etmek için kullanılır. 
filePath , ıfıleınfo. Physical Pathile elde edilir. 









public class FileService 

{ 

private readonly IMemoryCache _cache; 
private readonly IFileProvider _fileProvider; 
private List<string> _tokens = new List<string>(); 

public FileService(IMemoryCache cache, IklebHostEnvironment env) 

{ 

_cache = cache; 

_fileProvider = env.ContentRootFileProvider; 

} 

public async Task<string> GetFileContents(string fileName) 

{ 

var filePath = _fileProvider.GetFileInfo(fileName).PhysicalPath; 
string fileContent; 

// Try to obtain the file contents from the cache. 
if (_cache.TryGetValue(filePath, out fileContent)) 

{ 

return fileContent; 

} 

// The cache doesn't have the entry, so obtain the file 
// contents from the file itself. 
fileContent = await GetFileContent(filePath); 

if (fileContent != null) 

{ 

// Obtain a change token from the file provider whose 
// callback is triggered when the file is modified. 
var changeToken = _fileProvider.Watch(fileName); 

// Configure the cache entry options for a five minute 
// sliding expiration and use the change token to 
// expire the file in the cache if the file is 
// modified. 

var cacheEntryOptions = new MemoryCacheEntryOptions() 
.SetSlidingExpiration(TimeSpan.FromMinutes(B)) 

.AddExpirationToken(changeToken); 

// Put the file contents into the cache. 

_cache.Set(filePath, fileContent., cacheEntryOptions); 

return fileContent; 

} 

return string.Empty; 

} 

} 

FileService , bellek önbelleği hizmeti ile birlikte hizmet kapsayıcısına kaydedilir. 
Startup.ConfigureServices : 

Services. AddMemoryCache(); 

Services.AddSingleton<FileService>(); 


Sayfa modeli, hizmeti kullanarak dosyanın içeriğini yükler. 
Dizin sayfasının onGet yönteminde ( Pages/lndex. cshtml. cs): 



var fileContent = await _fileService.GetFileContentsCpoem.txt") j 


CompositeChangeToken sınıfı 

Tek bir nesnedeki bir veya daha fazla ıchangeToken örneğini temsil etmek için CompositeChangeToken sınıfını 
kullanın. 

var firstCancellationTokenSource = new CancellationTokenSource()j 
var secondCancellationTokenSource = new CancellationTokenSource(); 

var firstCancellationToken = firstCancellationTokenSource.Tokenj 
var secondCancellationToken = secondCancellationTokenSource.Tokenj 

var firstCancellationChangeToken = new CancellationChangeToken(firstCancellationToken)j 
var secondCancellationChangeToken = new CancellationChangeToken(secondCancellationToken)j 

var CompositeChangeToken = 
new CompositeChangeToken( 
new List<IChangeToken> 

{ 

firstCancellationChangeToken, 

secondCancellationChangeToken 

}); 

HasChanged , temsil edilen herhangi bir belirteç HasChanged true ise bileşik belirteç raporlarında true . 
ActiveChangeCaiibacks , temsil edilen herhangi bir belirteç ActiveChangeCaiibacks true ise bileşik belirteç 
raporlarında true . Birden çok eşzamanlı değişiklik olayı oluşursa, bileşik değişiklik geri çağırması bir kez çağrılır. 

Değişiklik belirteci, durum değişikliklerini izlemek için kullanılan genel amaçlı, düşük düzey bir yapı taşıdır. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Ichangetoken arabirimi 

IChangeToken bir değişikliğin gerçekleştiği bildirimleri yayar. ıchangeToken , Microsoft.Extensions.Primitives ad 
alanında bulunur. Microsoft. AspNetCore. app metapackagekullanmayan uygulamalar İçin, Microsoft. Extensions. 
ilkel NuGet paketi için bir paket başvurusu oluşturun. 

ıchangeToken iki özelliğe sahiptir: 

• ActiveChangeCaiibacks belirtecin, geri çağırmaları etkin bir şekilde harekete geçirmediğini belirtir. 

ActiveChangedCaiibacks faise olarak ayarlanırsa, bir geri çağırma hiçbir şekilde çağrılmaz ve uygulamanın 
değişiklikler için HasChanged yoklamalıdır. Hiçbir değişiklik gerçekleşmüyorsa veya temeldeki değişiklik 
dinleyicisi atıldığı veya devre dışı bırakıldığında belirtecin hiçbir şekilde iptal edilmemesi de mümkündür. 

• HasChanged bir değişikliğin oluşup gerçekleşmediğini gösteren bir değer alır. 

ıchangeToken arabirimi, belirteç değiştirildiğinde çağrılan bir geri aramayı kaydeden Registerchangecallback 
(Action<Object >, Object) yöntemini içerir. HasChanged , geri çağırma çağrılmadan önce ayarlanmalıdır. 

ChangeToken sınıfı 

ChangeToken, bir değişikliğin gerçekleştiği bildirimleri yaymak için kullanılan statik bir sınıftır. ChangeToken , 
Microsoft.Extensions.Primitives ad alanında bulunur. Microsoft. AspNetCore. app metapackagekullanmayan 
uygulamalar İçin, Microsoft. Extensions. ilkel NuGet paketi için bir paket başvurusu oluşturun. 

ChangeToken. OnChange (Func<IChannel>, Action) yöntemi, belirteç her değiştiğinde çağırmak için bir Action 














kaydeder: 



ChangeToken. OnChange-ctstate > (Func<ıhangetoken >, Action<tstate >, TState) aşırı yüklemesi, token tüketicisi 
Tstate geçirilen ek bir Action parametresini alır. 

Onchange I Disposabledöndürür. Dispose çağırmak, belirteci daha fazla değişiklik için dinlemeyi durdurup 
belirtecin kaynaklarını serbest bırakır. 

ASP.NET Core değişiklik belirteçlerinin örnek kullanımları 

Değişiklik belirteçleri, nesnelerde yapılan değişiklikleri izlemek için ASP.NET Core belirgin alanlarında kullanılır: 

• Dosyalarda yapılan değişiklikleri izlemek için, IFİleProviderVVatch yöntemi, belirtilen dosya veya klasör için 
izlemek üzere bir ıchangeToken oluşturur. 

• değişiklik üzerine önbellek çıkarmaları tetiklemek için, ıchangeToken belirteçleri önbellek girişlerine eklenebilir. 

• TOptions değişiklikler için IOptionsMonitor<TOptions> varsayılan OptionsMonitor<TOptions> 
uygulamasının bir veya daha fazla IOptionsChangeTokenSource<TOptions> örneğini kabul eden bir aşırı 
yüklemesi vardır. Her örnek, izleme seçenekleri değişiklikleri için değişiklik bildirimi geri aramasını kaydetmek 
üzere bir ıchangeToken döndürür. 

Yapılandırma değişikliklerini izle 

Varsayılan olarak, ASP.N ET Core şablonlar JSON yapılandırma dosyalarını ( appSettings. JSON, appSettings) 
kullanır. Developmerıt. JSONve appSettings. Üretim. JSON), uygulama yapılandırma ayarlarını yükler. 

Bu dosyalar, bir reloadOnChange parametresini kabul eden ConfigurationBuilder için Addjsonfile (ıseationbuilder, 
String, Boolean, Boolean) genişletme yöntemi kullanılarak yapılandırılır. reloadOnChange , yapılandırmanın dosya 
değişikliklerinde yeniden yüklenmesi gerekip gerekmediğini gösterir. Bu ayar VVebHost kullanışlı yöntemde 
görüntülenir CreateDefaultBuilder: 

config.AddTsonFile("appsettings.json"j optional: true, reloadOnChange: true) 
.AddTsonFile($"appsettings.{env.EnvironmentName}.json", optional: true, 
reloadOnChange: true); 

Dosya tabanlı yapılandırma FileConfigurationSourcetarafından temsil edilir. FiieConfigurationSource dosyaları 
izlemek için I FileProvider kullanır. 

Varsayılan olarak iFileMonitor , yapılandırma dosyası değişikliklerini izlemek için FileSystemVVatcher kullanan bir 
PhysicalFileProvidertarafından sağlanır. 

Örnek uygulama, yapılandırma değişikliklerini izlemek için iki uygulama gösterir.AppSettings dosyalarından 
herhangi biri değiştiğinde, dosya izleme uygulamalarının her ikisi de özel kod yürütür—örnek uygulama konsola 
bir ileti yazar. 

Yapılandırma dosyası FiieSystemwatcher , tek bir yapılandırma dosyası değişikliği için birden çok belirteç geri 
çağırmaları tetikleyebilir. Özel kodun, birden fazla belirteç geri çağırma işlemi tetiklendiğinde yalnızca bir kez 
çalıştığından emin olmak için, örnek uygulama dosya karmalarını denetler. Örnek, SHA1 dosya karma kullanır.Bir 
yeniden deneme, üstel geri dönme ile uygulanır. Dosya kilitlemesi, geçici olarak bir dosyada yeni bir karma işlem 
yapılmasını önleyen dosya kilitleme gerçekleşebileceğinden, yeniden deneme vardır. 

Yardımcı programlar/yardımcı programlar, cs: 
















public static byte[] ComputeHash(string filePath) 

{ 

var runCount = 1; 

while(runCount < 4) 

{ 

try 

{ 

if (File.Exists(filePath)) 

{ 

using (var fs = File.OpenRead(filePath)) 

{ 

return System.Security.Cryptography.SHAİ 
.Create().ComputeHash(fs); 

} 

} 

else 

{ 

throw new FileNotFoundException(); 

} 

} 

catch (IOException ex) 

{ 

if (runCount == 3 || ex.HResult != -2147024864) 

{ 

throw; 

} 

else 

{ 

Thread.Sleep(TimeSpan.FromSeconds(Math.Pow(2, runCount))); 
runCount++; 

} 

} 

} 

return new byte[20]; 


Basit başlangıç değiştirme belirteci 

Değişiklik bildirimleri için bir belirteç tüketicisi Action geri çağırma işlemini yapılandırma yeniden yükleme 
belirtecine kaydedin. 


Startup.Configure : 

ChangeToken.OnChange( 

() => config.GetReloadToken(), 
(state) => InvokeChanged(state), 
env); 


config.GetReioadToken() belirteci sağlar. Geri çağırma invokechanged yöntemidir: 





private void InvokeChanged(IHostingEnvironment env) 

{ 

byte[] appsettingsHash = ComputeHash("appSettings.json"); 
byte[] appsettingsEnvHash = 

ComputeHash($"appSettings.{env.EnvironmentName}.json"); 

if (!_appsettingsHash.SequenceEqual(appsettingsHash) | 

!_appsettingsEnvHash.SequenceEqual(appsettingsEnvHash)) 

{ 

_appsettingsHash = appsettingsHash; 

_appsettingsEnvHash = appsettingsEnvHash; 

WriteConsole("Configuration changed (Simple Startup Change Token)"); 

} 

} 

Geri aramanın state , izlenecek doğru appSettings yapılandırma dosyasını (örneğin, appSettings) belirtmek için 
yararlı olan iHostingEnvironment geçirmek için kullanılır. Geliştirme ortamında geliştirme. JSON ). Dosya 
karmaları, yapılandırma dosyası yalnızca bir kez değiştirildiğinde, birden çok belirteç geri çağırmaları nedeniyle 
writeConsoie deyimin birden çok kez çalışmasını engellemek için kullanılır. 

Uygulama çalıştığı sürece bu sistem çalışır ve Kullanıcı tarafından devre dışı bırakılamaz. 

Yapılandırma değişikliklerini hizmet olarak izle 

Örnek şunları uygular: 

• Temel başlangıç belirteci izleme. 

• Hizmet olarak izleme. 

• izlemeyi etkinleştirme ve devre dışı bırakma mekanizması. 

Örnek bir ıconfigurationMonitor arabirimi oluşturur. 

Uzantıiar/ConfigurationMonitor. cs: 

public interface ıconfigurationMonitor 

{ 

bool MonitoringEnabled { get; set; } 
string CurrentState { get; set; } 

} 

Uygulanan sınıfın Oluşturucusu configurationMonitor , değişiklik bildirimleri için bir geri çağırma kaydeder: 

public ConfigurationMonitor(IConfiguration config, IHostingEnvironment env) 

{ 

_env = env; 

ChangeToken.OnChange<IConfigurationMonitor>( 

() => config.GetReloadToken(), 

InvokeChanged, 
this); 

} 

public bool MonitoringEnabled { get; set; } = false; 
public string CurrentState { get; set; } = "Not monitoring"; 

config.GetReioadToken() belirteci sağlar. invokeChanged geri çağırma yöntemidir. Bu örnekteki state , izleme 
durumuna erişmek için kullanılan ıconfigurationMonitor örneğine bir başvurudur, iki özellik kullanılır: 

• MonitoringEnabled -, geri aramanın özel kodunu çalıştırıp çalıştıramayacağını gösterir. 













CurrentState 


Kullanıcı arabirimindeki kullanım için geçerli izleme durumunu açıklar. 


invokechanged yöntemi önceki yaklaşımla benzerdir, bunun dışında: 


• MonitoringEnabled true olmadığı müddetçe kodunu çalıştırmaz. 

• Geçerli state writeConsoie çıktısındaki çıktısını verir. 


private void InvokeChanged(IConfigurationMonitor State) 

{ 

if (MonitoringEnabled) 

{ 

byte[] appsettingsHash = ComputeHash("appSettings.json"); 
byte[] appsettingsEnvHash = 

ComputeHash($"appSettings.(_env.EnvironmentName}.json"); 

if (!_appsettingsHash.SequenceEqual(appsettingsHash) | 

!_appsettingsEnvHash,SequenceEqual(appsettingsEnvHash)) 

{ 

string message = $"State updated at {DateTime.Now}"; 


appsettingsHash = appsettingsHash; 
appsettingsEnvHash = appsettingsEnvHash; 


} 


} 


} 


WriteConsole("Configuration changed (ConfigurationMonitor Class) 
$"{message}, State:{state.CurrentState}"); 


+ 


Bir örnek ConfigurationMonitor startup.configureServices bir hizmet olarak kaydedilir: 


Services.AddSingletoncIconfigurationMonitor, ConfigurationMonitor>(); 


Dizin sayfası, yapılandırma izleme üzerinde Kullanıcı denetimi sağlar. ıconfigurationMonitor örneği indexModei 
eklenmiş. 


Pages/lndex. cshtmi cs: 


public IndexModel( 

IConfiguration config, 

IconfigurationMonitor monitor, 

FileService fileService) 

{ 

_config = config; 

_monitor = monitor; 

_fileService = fileService; 

} 

Yapılandırma izleyicisi ( _monitor ), izlemeyi etkinleştirmek veya devre dışı bırakmak ve Ul geri bildirimi için 
geçerli durumu ayarlamak için kullanılır: 












public IActionResult OnPostStartMonitoringO 
{ 

_monitor.MonitoringEnabled = true; 

_monitor.CurrentState = "Monitoring! 

return RedirectToPage(); 

} 

public IActionResult OnPostStopMonitoring() 

{ 

_moniton.MonitoningEnabled = false; 

_monitor.CunrentState = "Not monitoning"; 

return RedirectToPage(); 

} 

onPoststartMonitoring tetiklendiğinde, izleme etkinleştirilir ve geçerli durum temizlenir. onPoststopMonitoring 
tetiklendiğinde, izleme devre dışıdır ve durum, izlemenin gerçekleşmediğinden emin olmak üzere ayarlanır. 

Kullanıcı arabirimindeki düğmeler izlemeyi etkinleştirir ve devre dışı bırakır. 

Sayfa/dizin. cshtml: 

<button class="btn btn-success" asp-page-handler="StartMonitoring"> 

Start Monitoring 
</button> 

<button class="btn btn-danger" asp-page-handler="StopMonitoring"> 

Stop Monitoring 
</button> 


Önbelleğe alınmış dosya değişikliklerini izle 

Dosya içeriği, IMemoryCachekullanarak bellek içi önbelleğe alınabilir. Bellek içi önbelleğe alma, bellek İçi önbellek 
konusunda açıklanmaktadır. Aşağıda açıklanan uygulama gibi ek adımlar uygulamadan, kaynak veriler değişirse 
önbellekten eski (eski) veriler döndürülür. 

Örneğin, bir kayan süre sonu dönemini yenilerken önbelleğe alınmış bir kaynak dosyanın durumu, eski önbelleğe 
alınmış dosya verilerine yol açar. Verilerin her isteği, Kayan süre sonu süresini yeniler, ancak dosya hiçbir zaman 
önbelleğe yeniden yüklenmez. Dosyanın önbelleğe alınmış içeriğini kullanan tüm uygulama özellikleri, büyük 
olasılıkla eski içerik alınmasına tabidir. 

Bir dosya önbelleğe alma senaryosunda değişiklik belirteçlerini kullanmak önbellekte eski dosya içeriğinin 
varlığını engeller. Örnek uygulama, yaklaşımın bir uygulamasını gösterir. 

Örnek, GetFileContent için şunu kullanır: 

• Dosya içeriğini döndürür. 

• Bir dosya kilidinin geçici olarak bir dosya okumayı engellediği durumları kapsamak için üstel geri ile yeniden 
deneme algoritması uygulayın. 


Yardıma programlar/yardımcı programlar, cs: 






public async static Task<string> GetFiİ 0 Content(string filePath) 

{ 

var runCount = 1; 

while(runCount < 4) 

{ 

try 

{ 

if (File.Exists(filePath)) 

{ 

using (var fileStreamReader = File.OpenText(filePath)) 

{ 

return await fileStreamReader.ReadToEndAsync(); 

} 

} 

else 

{ 

throw new FileNotFoundException(); 

} 

} 

catch (IOException ex) 

{ 

if (runCount == 3 | | ex.HResult != -2147024864) 

{ 

throw; 

} 

else 

{ 

await Task.Delay(TimeSpan.FromSeconds(Math.Pow(2j runCount))); 
runCount++; 

} 

} 

} 

return null; 

} 

Önbelleğe alınmış dosya aramalarını işlemek için bir FileService oluşturulur. Hizmet GetFileContent yöntemi 
çağrısı, bellek içi önbellekten dosya içeriğini almaya çalışır ve bunu çağırana {Serv'ıces/FileService. cs) döndürebilir. 

Önbellek anahtarı kullanılarak önbelleğe alınmış içerik bulunamazsa, aşağıdaki eylemler gerçekleştirilir: 

1. Dosya içeriği GetFileContent kullanılarak elde edilir. 

2. Dosya sağlayıcısından ıfileproviders. VVatchile bir değişiklik belirteci elde edilir. Dosya değiştirildiğinde 
belirtecin geri çağırması tetiklenir. 

3. Dosya içeriği bir kayan süre sonu süresiyle önbelleğe alınır. Değişiklik belirteci, önbelleğe alınmış 
durumdayken dosya değişirse önbellek girdisini çıkarmak için Memorycacheentryextensions. 
AddExpirationToken ile birlikte eklenir. 

Aşağıdaki örnekte, dosyalar uygulamanın içerik kökündesaklanır. Ihostingenvironment. ContentRootFileProvider , 
uygulamanın ContentRootPathişaret eden bir IFileProvider elde etmek için kullanılır. filePath , ıfıleınfo. 
PhysicalPathile elde edilir. 







public class FileService 

{ 

private readonly IMemoryCache _cache; 
private readonly IFileProvider _fileProvider; 
private List<string> _tokens = new List<string>(); 

public FileService(IMemoryCache cache, IFlostlngEnvlronment env) 

{ 

_cache = cache; 

_fileProvider = env.ContentRootFileProvider; 

} 

public async Task<string> GetFileContents(string fileName) 

{ 

var filePath = _fileProvider.GetFileInfo(fileName).PhysicalPath; 
string fileContent; 

// Try to obtain the file contents from the cache. 
if (_cache.TryGetValue(filePath, out fileContent)) 

{ 

return fileContent; 

} 

// The cache doesn't have the entry, so obtain the file 
// contents from the file itself. 
fileContent = await GetFileContent(filePath); 

if (fileContent != null) 

{ 

// Obtain a change token from the file provider whose 
// callback is triggered when the file is modified. 
var changeToken = _fileProvider.Watch(fileName); 

// Configure the cache entry options for a five minute 
// sliding expiration and use the change token to 
// expire the file in the cache if the file is 
// modified. 

var cacheEntryOptions = new MemoryCacheEntryOptions() 
.SetSlidingExpiration(TimeSpan.FromMinutes(B)) 

.AddExpirationToken(changeToken); 

// Put the file contents into the cache. 

_cache.Set(filePath, fileContent., cacheEntryOptions); 

return fileContent; 

} 

return string.Empty; 

} 

} 

FileService , bellek önbelleği hizmeti ile birlikte hizmet kapsayıcısına kaydedilir. 
Startup.ConfigureServices : 

Services. AddMemoryCache(); 

Services.AddSingleton<FileService>(); 


Sayfa modeli, hizmeti kullanarak dosyanın içeriğini yükler. 
Dizin sayfasının onGet yönteminde ( Pages/lndex. cshtml. cs): 



var fileContent = await _fileService.GetFileContentsCpoem.txt"); 


CompositeChangeToken sınıfı 

Tek bir nesnedeki bir veya daha fazla ıchangeToken örneğini temsil etmek için CompositeChangeToken sınıfını 
kullanın. 


var firstCancellationTokenSource = new CancellationTokenSource()j 
var secondCancellationTokenSource = new CancellationTokenSource(); 

var firstCancellationToken = firstCancellationTokenSource.Tokenj 
var secondCancellationToken = secondCancellationTokenSource.Tokenj 

var firstCancellationChangeToken = new CancellationChangeToken(firstCancellationToken)j 
var secondCancellationChangeToken = new CancellationChangeToken(secondCancellationToken)j 

var CompositeChangeToken = 
new CompositeChangeToken( 
new List<IChangeToken> 

{ 

firstCancellationChangeToken^ 

secondCancellationChangeToken 

}); 

HasChanged , temsil edilen herhangi bir belirteç HasChanged true ise bileşik belirteç raporlarında true . 
ActiveChangeCaiibacks , temsil edilen herhangi bir belirteç ActiveChangeCaiibacks true ise bileşik belirteç 
raporlarında true . Birden çok eşzamanlı değişiklik olayı oluşursa, bileşik değişiklik geri çağırması bir kez çağrılır. 

Ek kaynaklar 

• ASP.NET Core'de önbellek belleği 

• ASP.NET Core 'de dağıtılmış önbelleğe alma 

• ASP.NET Core'de yanıt önbelleğe alma 

• ASP.NET Core 'de yanıt önbelleğe alma ara yazılımı 

• Önbellek etiketi Yardımcısı, AS P.N ET Core MVC 

• Dağıtılmış önbellek etiketi Yardımcısı AS P.N ET core'da 







ASPNET Core ile .NET (OWIN) için Web arabirimini 
açın 

11.07.2019 • 8 minutes to read ı Edit Online 


Tarafından Steve Smith ve Rick Anderson 

ASP.NET Core, .NET (OWIN) için açık Web arabirimi destekler.OWİN web uygulamalarının web sunucularından 
ölçeklendirilebilmeleri sağlar. Bu, bir işlem hattında isteklerini ve yanıtlarını ilişkili işlemek için kullanılan ara 
yazılımı için standart bir biçimde tanımlar. ASP.NET Core uygulamaları ve ara yazılımlar OWIN tabanlı 
uygulamalar, sunucuları ve ara yazılım ile çalışabilirler. 

OWIN iki çerçeveleri ile birlikte kullanılmak üzere farklı nesne modeline izin veren bir decoupling katmanı sağlar. 
Microsoft.AspNetcore. 0 win Paket iki bağdaştırıcı uygulamaları sağlar: 

• OWIN için ASP.NET Core 

• OWIN ASP.NET core'a 


Bu, ASP.NET Core, ASP.NET Core üzerinde çalıştırılacak diğer OWIN uyumlu bileşenler için ya da bir OWIN 
uyumlu sunucusu/ana bilgisayar üzerinde barındırılması sağlar. 


NOTE 

Bu bağdaştırıcılar kullanarak performans maliyetine 

ile birlikte gelir. Yalnızca ASP.NET Core bileşenlerini kullanarak uygulama 

olmamalıdır kullanın 

Microsoft.AspNetCone.Owin 

paketi veya bağdaştırıcıları. 


Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

ASP.NET Core işlem hattında OWIN ara yazılımı çalıştırma 

ASP.NET Core'nın OWIN desteği parçası olarak dağıtılan Microsoft.AspNetcore. 0 win paket. Bu paketi yükleyerek 
projenize OWIN destek alabilirsiniz. 

OWIN ara yazılımı uygun şekilde OWIN belirtimi, gerektiren bir Func<iDictionary<string, object>, Task> 
arabirimi ve özel anahtarları ayarlanabilir (gibi owin.ResponseBody ). Aşağıdaki basit OWIN ara yazılımı "Hello 
World" görüntüler: 

public Task Oin/inHelloCIDictionarycstring, object> environment) 

{ 

string responseText = "Hello World via OWIN"j 

byte[] responseBytes = Encoding.UTF8.GetBytes(responseText); 

// OIaIIN Environment Keys: https://owin.Org/spec/spec/owin-l.0.0.html 
var responseStream = (Stream)environment["owin.ResponseBody"]j 

var responseHeaders = (IDictionarycstring, string[]>)environment["owin.ResponseHeaders "]; 

responseHeaders["Content-Length"] = new string[] { 
responseBytes.Length.ToString(CultureInfo.InvariantCulture) }; 

responseHeaders["Content-Type"] = new string[] { "text/plain" }; 

return responseStream.WriteAsync(responseByteSj 0, responseBytes.Length); 

} 










Örnek imza döndürür bir Task ve kabul eden bir iDictionary<string J object> OWIN gerektirdiği. 

Aşağıdaki kod nasıl ekleneceğini gösterir 0 winHeiio (yukarıda ASP.NET Core işlem hattı ile gösterilen) bir ara 
yazılım useOwin genişletme yöntemi. 

public void Configure(IApplicationBuilder app) 

{ 

app.UseOwin(pipeline => 

{ 

pipeline(next => OwinHello); 

}); 

} 


OWIN ardışık düzenini içinde gerçekleşmesi için diğer eylemleri yapılandırabilirsiniz. 


NOTE 

Yanıt üst bilgilerini yalnızca yanıt akışa ilk Yazımdan önce düzeltilmelidir. 


NOTE 

Birden çok çağrılar Use 0 win Performans nedeniyle önerilmez. OVVIN bileşenleri, gruplandırılmış, en iyi şekilde çalışır. 


app.UseOwin(pipeline => 

{ 

pipeline(async (next) => 

{ 

// do something before 

await OwinHello(new OwinEnvironment(HttpContext)); 
// do something after 

}); 


BirOWIN tabanlı sunucu üzerinde kullanarakASP.NET Core 
barındırma 

OWIN tabanlı sunucular, ASP.NET Core uygulamaları barındırabilir.Bir sunucu Novvin, bir .NET OWIN web 
sunucusu. Bu makalede örnek miyim Novvin atıfta bulunan ve oluşturmak için kullandığı bir proje dahil ettiğiniz 
bir ıserver ASP.N ET Core kendi kendine barındırma yeteneğine. 











using System; 

using System.Collections.Generic; 

using System.10; 

using System.Linq; 

using System.Threading.Tasks; 

using Microsoft.AspNetCore.Hosting; 

namespace NowinSample 

{ 

public class Program 

{ 

public static void Main(string[] args) 

{ 

var hoşt = new WebHostBuilder() 

.UseNowin() 

.UseContentRoot(Directory.GetCurrentDirectory()) 

.UseIISIntegration() 

.UseStartup<Startup>() 

.Build(); 

host.Run(); 

} 

} 

} 

ıserver gerektiren bir arabirim bir Features özelliği ve start yöntemi. 

start Yapılandırma ve bu durumda bir dizi IServerAddressesFeature Ayrıştırılan adreslerini ayarlamak fluent 
API'si çağrısı yapılır sunucunun başlatmak için sorumludur. Unutmayın fluent yapılandırmasını _buiider 
değişkeni, istek tarafından işleneceğini belirtir appFunc yönteminde tanımlanmış. Bu Func her istekte gelen 
istekleri işlemek için çağrılır. 

Ayrıca ekleyeceğiz bir ıwebHostBuiider Novvin sunucu ekleme ve yapılandırma kolaylaştırmak için uzantı. 

using System; 

using Microsoft.AspNetCore.Hosting.Server; 
using Microsoft.Extensions.DependencyInjection; 
using Nowin; 
using NowinSample; 

namespace Microsoft.AspNetCore.Hosting 

{ 

public static class NowinWebHostBuilderExtensions 

{ 

public static IWebHostBuilder UseNowin(this IWebHostBuilder builder) 

{ 

return builder.ConfigureServices(services => 

{ 

Services.AddSingleton<IServer, NowinServer>(); 

}); 

} 

public static IWebHostBuilder UseNowin(this IWebHostBuilder builder, Action<ServerBuilder> configure) 

{ 

builder.ConfigureServices(Services => 

{ 

Services.Configure(configure); 

}); 

return builder.UseNowin(); 

} 

} 

} 










Bu yerinde uzantı çağırmak Program.es bu özel sunucu kullanarak ASP.NET Core uygulaması çalıştırmak için: 


using System; 

using System.Collections.Generic; 

using System.10; 

using System.Linq; 

using System.Threading.Tasks; 

using Microsoft.AspNetCore.Hosting; 

namespace NowinSample 

{ 

public elass Program 

{ 

public static void Main(string[] args) 

{ 

var hoşt = new WebHostBuilder() 

.UseNowin() 

.UseContentRoot(Directory.GetCurrentDirectory()) 
.UseIISIntegration() 

.UseStartup<Startup>() 

.Build(); 

host.Run(); 

} 

} 

} 


Daha fazla bilgi edinin ASP.NET Core sunucuları. 

ASP.NET Core OWIN tabanlı bir sunucuda çalıştırın ve VVebSockets 
desteğini kullanma 

OWIN tabanlı nasıl sunucularının özelliklerinin başka bir örnek tarafından yararlanılabilir ASP.NET Core, 
VVebSockets gibi özelliklere erişim. Önceki örnekte kullanılan .NET OVVIN web sunucusunun VVeb yerleşik olan bir 
AS P.N ET Core uygulaması tarafından yararlanılabilir yuva için destek sunar. Aşağıdaki örnek, VVeb yuvalarını 
destekliyorsa ve VVebSockets üzerinden sunucusuna gönderilen her şeyi yankılayan basit web uygulaması gösterir. 



public class Startup 

{ 

public void Configure(IApplicationBuilder app) 

{ 

app.Use(async (context, next) => 

{ 

if (context.WebSockets.IsWebSocketRequest) 

{ 

WebSocket webSocket = await context.WebSockets.AcceptWebSocketAsync(); 
await EchoWebSocket(webSocket); 

} 

else 

{ 

await next(); 

} 

}); 

app.Run(context => 

{ 

return context.Response.WriteAsync("Hello World"); 

}); 


private async Task EchoWebSocket(WebSocket webSocket) 

{ 

byte[] buffer = new byte[1024]; 

WebSocketReceiveResult received = await webSocket.ReceiveAsync( 
new ArraySegment<byte>(buffer ), CancellationToken.None); 

while (!webSocket.CloseStatus.HasValue) 

{ 

// Echo anything we receive 

await webSocket.SendAsync(new AnraySegment<byte>(bufferj 0 , received.Count), 
received.MessageType, received.EndÛfMessage, CancellationToken.None); 

received = await webSocket.ReceiveAsync(new ArraySegment<byte>(buffer ), 

CancellationToken.None); 

} 

await webSocket.CloseAsync(webSocket.CloseStatus.Value, 

webSocket.CloseStatusDescriptionj CancellationToken.None); 

} 

} 

Bu örnek aynı kullanılarak yapılandırılan NowinServer nasıl uygulama yapılandırılan içinde önceki tek - tek fark, 
kendi configure yöntemi. Kullanarak bir test basit vvebsocket istemcisi uygulaması gösterir: 






OWIN ortamı 

BirOVVIN ortamı kullanarak oluşturabilirsiniz HttpContext . 


var environment = new OwinEnvironment(HttpContext); 
var features = new OwinFeatureCollection(environment); 


OWIN anahtarları 

OWIN bağımlı bir iDictionary<string,object> bir HTTP istek/yanıt exchange içinde bilgi iletişim kurmak için 
nesne. ASP.NET Core, aşağıda listelenen anahtarları uygular. Bkz: birincil belirtimi, uzantıları, ve OWIN anahtar 
yönergeleri ve ortak anahtarları. 

İstek verileri (OWIN vl.0.0) 

ANAHTAR DEĞER (TÜR) AÇIKLAMA 


owın. RequestScheme 

Stning 

owın. RequestMethod 

String 

owin.RequestPathBase 

Stning 

owin.RequestPath 

Stning 

owin.RequestQueryString 

Stning 

owın. RequestProtocol 

Stning 

owın. RequestHeaders 

IDictionany<stning, stning[ ] > 





















































ANAHTAR 


DEĞER (TÜR) 


AÇIKLAMA 


owın. Includesearchresults: true 

İstek verileri (OWIN vl.1.0) 

ANAHTAR 

Stream 

DEĞER (TÜR) 

AÇIKLAMA 

owin.Requestld 

String 

İsteğe Bağlı 

Yanıt verileri (OWIN vl.O.O) 

ANAHTAR 

DEĞER (TÜR) 

AÇIKLAMA 

owin.ResponseStatusCode 

int 

isteğe Bağlı 

ovvin.ResponseReasonPhrase 

String 

isteğe Bağlı 

owın. ResponseHeaders 

IDictionary<string, string[]> 


owın. ResponseBody 

Stream 


Diğer veri (OWIN vl.O.O) 

ANAHTAR 

DEĞER (TÜR) 

AÇIKLAMA 

owın. CalICancelled 

CancellationToken 


owın. Sürüm 

String 


Ortak anahtarlar 

ANAHTAR 

DEĞER (TÜR) 

AÇIKLAMA 

SSL. ClientCertificate 

X509Certificate 


SSL. LoadCIİentCertAsync 

Func<Task> 


server. Remotel pAddress 

String 


Sunucu. Uzak bağlantı noktası 

String 


Sunucu. YerelIPAdresi 

String 


Sunucu. Yerel bağlantı noktası 

String 


Sunucu. IsLocal 

bool 


server.OnSendingHeaders 

Action<Action<object>,object> 



SendFiles v0.3.0 



















ANAHTAR 

DEĞER (TÜR) 

AÇIKLAMA 

sendfile. SendAsync 

Bkz: temsilci imzası 

istek başına 

Donuk v0.3.0 



ANAHTAR 

DEĞER (TÜR) 

AÇIKLAMA 

Donuk. Sürüm 

String 


Donuk. Yükseltme 

OpaqueUpgrade 

Bkz: temsilci imzası 

Donuk. Stream 

Stream 


Donuk. CalICancelled 

CancellationToken 


VVebSocket v0.3.0 



ANAHTAR 

DEĞER (TÜR) 

AÇIKLAMA 

vvebsocket. Sürüm 

String 


vvebsocket. Kabul et 

WebSocketAccept 

Bkz: temsilci imzası 

vvebsocket. AcceptAlt 


Non-spec 

vvebsocket. Geçersizdir 

String 

Bkz: RFC6455 bölüm 4.2.2 adım 5.5 

vvebsocket. SendAsync 

WebSocketSendAsync 

Bkz: temsilci imzası 

vvebsocket.ReceiveAsync 

WebSocketReceiveAsync 

Bkz: temsilci imzası 

vvebsocket.CloseAsync 

WebSocketCloseAsync 

Bkz: temsilci imzası 

vvebsocket. CalICancelled 

CancellationToken 


vvebsocket. ClientCloseStatus 

int 

isteğe Bağlı 

vvebsocket.ClientCloseDescription 

String 

isteğe Bağlı 


Ek kaynaklar 


• Ara Yazılım 

• Sunucular 














ASPNET Core içinde barındırılan hizmetlerle arka 
plan görevleri 

26.11.2019 * 20 minutes to read ı Edit Online 


, Luke Latham ve Jeow li Hua tarafından 

ASP.NET Core, arka plan görevleri barmdınlan hizmetlerolarak uygulanabilir. Barındırılan hizmet, 
IHostedService arabirimini uygulayan bir arka plan görevi mantığı içeren bir sınıftır. Bu konuda üç 
barındırılan hizmet örneği sunulmaktadır: 

• Bir Zamanlayıcı üzerinde çalışan arka plan görevi. 

• Kapsamlı bir hizmetietkinleştiren barındırılan hizmet. Kapsamlı hizmet bağımlılık ekleme 
(dı)kullanabilir. 

• Sıralı olarak çalışan sıraya alınmış arka plan görevleri. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Çalışan hizmeti şablonu 

AS P.N ET Core VVorker hizmeti şablonu, uzun süre çalışan hizmet uygulamalarını yazmak için bir 
başlangıç noktası sağlar. Çalışan hizmeti şablonundan oluşturulan bir uygulama, çalışan SDK 'sini proje 
dosyasında belirtir: 

<Project Sdk="Microsoft.NET.Sdk.Worker"> 

Şablonu bir barındırılan hizmetler uygulamasının temeli olarak kullanmak için: 

• Visual Studio 

• Mac için Visual Studio 

• .NET Core CLI 

1. Yeni bir proje oluşturun. 

2. Çalışan hizmetiseçin. İleri ' yiseçin. 

3. Proje adı alanında bir proje adı girin veya varsayılan proje adını kabul edin. Oluştur' u seçin. 

4. Yeni çalışan hizmeti oluştur İletişim kutusunda Oluştur 1 u seçin. 

Paket 

Çalışan hizmeti şablonunu temel alan bir uygulama Microsoft. net. sdk.worker SDK kullanır ve Microsoft. 
Extensions. Hosting paketine açık bir paket başvurusu içerir. Örneğin, örnek uygulamanın proje dosyasına 
(Backgroundtaskssample. csproj ) bakın. 

Microsoft. net. sdk.web SDK kullanan Web uygulamaları için, Microsoft. Extensions. Hosting paketine, 
paylaşılan çerçeveden dolaylı olarak başvurulur. Uygulamanın proje dosyasındaki açık bir paket başvurusu 
gerekli değildir. 

Ihostedservice arabirimi 

IHostedService arabirimi, konak tarafından yönetilen nesneler için iki yöntem tanımlar: 








• Startasync (CancellationToken) - startAsync arka plan görevinin başlatılacağı mantığı içerir. 

startAsync şu kadar çağrdLr: 

o Uygulamanın istek işleme işlem hattı yapılandırıldı ( startup.configure ). 
o Sunucu başlatıldı ve lapplicationlifetime. ApplicationStarted tetiklenir. 

Varsayılan davranış, barındırılan hizmetin startAsync , uygulamanın işlem hattı yapılandırıldıktan 
ve ApplicationStarted çağrıldıktan sonra çalışması için değiştirilebilir. Varsayılan davranışı 
değiştirmek için, configurewebHostDefauits çağrıldıktan sonra barındırılan hizmeti (aşağıdaki 
örnekte videoswatcher ) ekleyin: 

using Microsoft.AspNetCore.Hosting; 

ıısing Microsoft.Extensions.DependencyInjection; 

using Microsoft.Extensions.Hosting; 

public class Program 
{ 

public static void Main(string[] args) 

{ 

CreateHostBuilder(args).Build().Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}) 

.ConfigureServices(services => 

{ 

Services.AddHostedService<VideosWatcher>(); 

}); 

} 

• StopAsync (CancellationToken) ana bilgisayar düzgün bir şekilde kapanma gerçekleştirirken 
tetiklenir. StopAsync arka plan görevinin sonundaki mantığı içerir. Yönetilmeyen kaynakların 
atılmaya yönelik IDİsposable ve sonlandırıcılar (Yıkıcılar) uygulayın. 

iptal belirtecinin, kapanma işleminin artık düzgün şekilde olmaması gerektiğini göstermek için 
varsayılan beş saniyelik bir zaman aşımı vardır. Belirteç üzerinde iptal istendiğinde: 

o Uygulamanın gerçekleştirdiği diğer arka plan işlemleri iptal edilmelidir, 
o StopAsync içinde çağrılan yöntemler hemen döndürmelidir. 

Ancak,—istek iptal edildikten sonra, çağıran tüm görevlerin tamamlanmasını bekler. 

Uygulama beklenmedik şekilde kapanıyorsa (örneğin, uygulamanın işlemi başarısız olursa) 

StopAsync çağrımayabilir. Bu nedenle, StopAsync veya içinde gerçekleştirilen işlemler tarafından 
çağrılan yöntemler gerçekleşmeyebilir. 

Varsayılan beş saniyelik kapatılma zaman aşımını uzatmak için, şunu ayarlayın: 

o Genel ana bilgisayar kullanılırken ShutdovvnTimeout. Daha fazla bilgi için bkz. NET genel ana 
bilgisayar. 

o Web ana bilgisayarı kullanılırken, kapatılma zaman aşımı konak yapılandırma ayarı. Daha fazla 
bilgi için bkz. AS P.N ET Core Web ana bilgisayarı. 

Barındırılan hizmet, uygulama başlangıcında bir kez etkinleştirilir ve uygulama kapatılırken düzgün şekilde 
kapanır. Arka plan görevinin yürütülmesi sırasında bir hata oluşturulursa, StopAsync çağrılmasa bile 
Dispose çağrılmalıdır. 













BackgroundService temel sınıfı 

BackgroundService, uzun süre çalışan bir IHostedServiceuygulamaya yönelik temel bir sınıftır. 

Arka plan hizmetini çalıştırmak için ExecuteAsync (CancellationToken) çağırılır. Uygulama, arka plan 
hizmetinin tüm ömrünü temsil eden bir Task döndürür. ExecuteAsync, await çağırarak zaman uyumsuz 
halegelene kadar başka bir hizmet başlatılamaz. ExecuteAsync içinde başlatma işini uzun süre 
gerçekleştirmekten kaçının. StopAsync (CancellationToken) içindeki ana bilgisayar blokları ExecuteAsync 
tamamlanmasını bekliyor. 

Ihostedservice. StopAsync çağrıldığında iptal belirteci tetiklenir. ExecuteAsync uygulamanız, hizmeti 
sorunsuz bir şekilde kapatmak için iptal belirteci tetiklendiğinde hemen bitebilmelidir. Aksi takdirde, 
hizmet, kapanmanın zaman aşımından sonra kapanmadığını kaldırır. Daha fazla bilgi için ıhostedservice 
arabirimi bölümüne bakın. 

Zamanlanmış arka plan görevleri 

Zamanlanmış bir arka plan görevi, System. Threading. Timer sınıfından kullanımını sağlar. Zamanlayıcı, 
görevin Dowork yöntemini tetikler. Zamanlayıcı StopAsync devre dışı bırakılır ve hizmet kapsayıcısı 
Dispose bırakıldığında atıldı: 







public class TimedHostedService : IHostedService, IDisposable 

{ 

private int executionCount = 0; 

private readonly ILogger<TimedHostedService> _loggen; 
pnivate Timen _timen; 

public TimedHostedService(ILogger<TimedHostedService> loggen) 

{ 

_logger = logger; 

} 

public Task StantAsync(CancellationToken stoppingToken) 

{ 

_logger.LogInformation("Timed Hosted Service nunning."); 

_timer = new Timer(DoWonk, null, TimeSpan.Zero, 

TimeSpan.FromSeconds(5)); 

return Task.CompletedTask; 

} 

private void DoWork(object State) 

{ 

executionCount++; 

_logger.LogInfonmation( 

"Timed Hosted Service is working. Count: {Count}", executionCount); 

} 

public Task StopAsync(CancellationToken stoppingToken) 

{ 

_logger.LogInformation("Timed Hosted Service is stopping."); 

_timer?.Change(Timeout.Infinite, 0); 
return Task.CompletedTask; 

} 

public void Dispose() 

{ 

_timer?.Dispose(); 

} 

} 

Hizmet, AddHostedService uzantısı yöntemiyle iHostBuiider.configureServices (program.cs) kaydedilir: 

Services.AddHostedService<TimedHostedService>(); 


Bir arka plan görevinde kapsamlı bir hizmeti kullanma 

Bir backgroundserviceiçinde kapsamlı hizmetler kullanmak için bir kapsam oluşturun. Barındırılan hizmet 
için varsayılan olarak kapsam oluşturulmaz. 

Kapsamlı arka plan görev hizmeti, arka plan görevinin mantığını içerir.Aşağıdaki örnekte: 

• Hizmet zaman uyumsuz. Dowork yöntemi bir Task döndürür. Tanıtım amacıyla, Dowork yönteminde 
on saniyelik bir gecikme beklenir. 

• Hizmete bir ILogger eklenir. 









internal interface IScopedProcessingService 

{ 

Task DoWork(CancellationToken stoppingToken); 

} 

internal class ScopedProcessingService : IScopedProcessingService 

{ 

private int executionCount = 0; 
private readonly ILogger _logger; 

public ScopedProcessingService(ILogger<ScopedProcessingService> logger) 

{ 

_logger = logger; 

} 

public async Task DoWork(CancellationToken stoppingToken) 

{ 

while (!stoppingToken.IsCancellationRequested) 

{ 

executionCount++; 

_logger.Loglnformation( 

"Scoped Processing Service is working. Count: {Count}", executionCount); 
await Task.Delay(10000 J stoppingToken); 

} 

} 

} 

Barındırılan hizmet, Dowork yöntemini çağırmak için kapsamlı arka plan görev hizmetini çözümlemek 
üzere bir kapsam oluşturur. Dowork , ExecuteAsync beklemiş olan bir Task döndürür: 




public class ConsumeScopedServiceHostedService : BackgroundService 

{ 

private readonly ILogger<ConsumeScopedServiceHostedService> _logger; 

public ConsumeScopedServiceHostedService(IServiceProvider Services, 
ILogger<ConsumeScopedServiceHostedService> logger) 

{ 

Services = Services; 

_logger = logger; 

} 

public IServiceProvider Services { get; } 

protected override async Task ExecuteAsync(CancellationToken stoppingToken) 

{ 

_logger.LogInformation( 

"Consume Scoped Service Hosted Service running."); 
await DoWork(stoppingToken); 

} 

private async Task DoWork(CancellationToken stoppingToken) 

{ 

_logger.LogInformation( 

"Consume Scoped Service Hosted Service is working."); 

using (var scope = Services.CreateScope()) 

{ 

var scopedProcessingService = 
scope.ServiceProvider 

.GetRequiredService<IScopedProcessingService>(); 
await scopedProcessingService.DoWork(stoppingToken); 

} 

} 

public override async Task StopAsync(CancellationToken stoppingToken) 

{ 

_logger.LogInformation( 

"Consume Scoped Service Hosted Service is stopping."); 
await Task.CompletedTask; 

} 

} 

Hizmetler iHostBuiider.configureServices kaydedilir {program.es). Barındırılan hizmet AddHostedService 
uzantısı yöntemiyle kaydedilir: 

Services.AddHostedService<ConsumeScopedServiceHostedService>(); 

Services.AddScoped<IScopedProcessingService, ScopedProcessingService>(); 


Sıraya alınan arka plan görevleri 

Arka plan görev kuyruğu, .N ET 4. x QueueBackgroundWorkltem temel alır (ASP.NET Core için 
yerleşikolarak, kesin olarak zamanlandı): 






public interface IBackgroundTaskQueue 

{ 

void QueueBackgroundWorkItem(Func<CancellationToken, Task> workItem); 

Task<Func<CancellationToken, Task>> DequeueAsync( 

CancellationToken cancellationToken); 

} 

public class BackgroundTaskQueue : IBackgroundTaskQueue 

{ 

private ConcurrentQueue<Func<CancellationToken, Task>> _workItems = 
new ConcurrentQueue<Func<CancellationToken, Task>>(); 
private SemaphoreSlim _signal = new SemaphoreSlim(0); 

public void QueueBackgroundWorkItem( 

Func<CancellationTokenj Task> workItem) 

{ 

if (workItem == null) 

{ 

throw new ArgumentNullException(nameof(workItem)); 

} 

_workItems.Enqueue(workItem); 

_signal.Release(); 

} 

public async Task<Func<CancellationTokenj Task>> DequeueAsync( 

CancellationToken cancellationToken) 

{ 

await _signal.WaitAsync(cancellationToken); 

_workItems.TryDequeue(out var workItem); 

return workItem; 

} 

} 

Aşağıdaki QueueHostedService örnekte: 

• BackgroundPnocessing yöntemi, ExecuteAsync beklemiş olan bir Task döndürür. 

• Kuyruktaki arka plan görevleri, BackgroundProcessing sırada kuyruğa alınır ve yürütülür. 

• İş öğeleri, hizmet stopAsync ' de durdurulmadan önce bekletildi. 









public class QueuedHostedService : BackgroundService 

{ 

private readonly ILogger<QueuedHostedService> _logger; 

public QueuedHostedService(IBackgroundTaskQueue taskÇueue, 
ILogger<QueuedHostedService> logger) 

{ 

TaskQueue = taskQueue; 

_logger = logger; 

} 

public IBackgroundTaskQueue TaskQueue { get; } 

protected override async Task ExecuteAsync(CancellationToken stoppingToken) 

{ 

_logger.LogInformation( 

$"Queued Hosted Service is running.{Environment.NewLine}" + 
$"{Environment.NewLine}Tap W to add a work item to the " + 
$"background queue.{Environment.NewLine}"); 

await BackgroundProcessing(stoppingToken); 

} 

private async Task BackgroundProcessing(CancellationToken stoppingToken) 

{ 

while (!stoppingToken.IsCancellationRequested) 

{ 

var workItem = 

await TaskQueue.DequeueAsync(stoppingToken); 


} 


try 

{ 

await workItem(stoppingToken); 

} 

catch (Exception ex) 

{ 


} 


} 


logger.LogError(eXj 

"Error occurred executing {WorkItem }.", nameof(work!tem)); 


} 

public override async Task StopAsync(CancellationToken stoppingToken) 

{ 


_logger.LogInformation("Queued Hosted Service is stopping."); 
await base.StopAsync(stoppingToken); 


Bir MonitorLoop hizmeti, giriş cihazında w anahtarı seçildiğinde barındırılan hizmet için görevleri sıraya 
alır: 


• IBackgroundTaskQueue , MonitorLoop hizmetine eklenir. 

• iBackgroundTaskQueue.QueueBackgroundworkitem bir iş öğesini kuyruğa almak için çağrılır. 

• Çalışma öğesi uzun süre çalışan bir arka plan görevinin benzetimini yapar: 
o Üç 5-ikinci gecikme yürütülür ( Task.Delay ). 

o try-catch bir ifade, görev iptal edildiğinde OperationCanceledException yakalar. 

public class MonitorLoop 

{ 

private readonly IBackgroundTaskQueue _taskQueue; 
private readonly ILogger _logger; 






prıvate reaaonly cancellatıonlöken _canceilatıonlöken; 

public MonitorLoop(IBackgroundTaskQueue taskQueue, 
ILogger<MonitorLoop> logger, 

IHostApplicationLifetime applicationLifetime) 

{ 

_taskQueue = taskQueue; 

_logger = logger; 

_cancellationToken = applicationLifetime.ApplicationStopping; 


public void StantMonitorLoop() 

{ 

_logger.LogInformation("Monitor Loop is starting."); 

// Run a console user input loop in a backgnound thread 
Task.Run(() => Monitor()); 


public void Monitor() 

{ 

while (!_cancellationToken.IsCancellationRequested) 

{ 

var keyStroke = Console.ReadKeyO; 

if (keyStroke.Key == ConsoleKey.W) 

{ 

// Enqueue a background work item 
_taskQueue.QueueBackgroundWorkItem(async token => 

{ 

// Simulate three 5-second tasks to complete 
// for each enqueued work item 

int delayLoop = 0 ; 

var guid = Guid.NewGuid().ToString(); 

_logger.LogInformation( 

"Queued Background Task {Guid} is starting .", guid); 

while (!token.IsCancellationRequested && delayLoop < 3) 

{ 

try 

{ 

await Task.Delay(TimeSpan.FromSeconds(5 ), token); 

} 

catch (OperationCanceledException) 

{ 

// Prevent throwing if the Delay is cancelled 

} 

delayLoop++; 

_logger.LogInformation( 

"Queued Background Task {Guid} is running. " + 
"{DelayLoop}/3 ", guid, delayLoop); 

} 

if (delayLoop == 3) 

{ 

_logger.LogInformation( 

"Queued Background Task {Guid} is complete.", guid); 

} 

else 

{ 

_logger.LogInformation( 

"Queued Background Task {Guid} was cancelled .", guid); 

} 

}); 


} 


} 

} 

} 

Hizmetler iHostBuiider.configureServices kaydedilir {program.es). Barındırılan hizmet AddHostedService 
uzantısı yöntemiyle kaydedilir: 

Services.AddSingleton<MonitorLoop>(); 

Services.AddHostedService<QueuedHostedService>(); 

Services.AddSingleton<IBackgroundTaskQueue, BackgroundTaskQueue>(); 

ASP.NET Core, arka plan görevleri barındınlan hizmetlero\arak uygulanabilir. Barındırılan hizmet, 
IHostedService arabirimini uygulayan bir arka plan görevi mantığı içeren bir sınıftır. Bu konuda üç 
barındırılan hizmet örneği sunulmaktadır: 

• Bir Zamanlayıcı üzerinde çalışan arka plan görevi. 

• Kapsamlı bir hizmetietkinleştiren barındırılan hizmet. Kapsamlı hizmet bağımlılık ekleme (dı) 
kullanabilir 

• Sıralı olarak çalışan sıraya alınmış arka plan görevleri. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Paket 

Microsoft. AspNetCore. app metapackage 'e başvurun veya Microsoft. Extensions. Hosting paketine bir 
paket başvurusu ekleyin. 

Ihostedservice arabirimi 

Barındırılan hizmetler IHostedService arabirimini uygular. Arabirim, konak tarafından yönetilen nesneler 
için iki yöntem tanımlar: 

• Startasync (CancellationToken) - startAsync arka plan görevinin başlatılacağı mantığı içerir. Web 
ana bilgisayarıkullanılırken, sunucu başlatıldıktan ve lapplicationlifetime 'dan sonra startAsync 
çağrılır. applicationstarted tetiklenir. Genel ana bilgisayarkul lanı1 1 rken, Appiicationstarted 
tetiklenene kadar startAsync çağrılır. 

• StopAsync (CancellationToken) ana bilgisayar düzgün bir şekilde kapanma gerçekleştirirken 
tetiklenir. StopAsync arka plan görevinin sonundaki mantığı içerir. Yönetilmeyen kaynakların 
atılmaya yönelik IDİsposable ve sonlandırıcılar (Yıkıcılar) uygulayın. 

iptal belirtecinin, kapanma işleminin artık düzgün şekilde olmaması gerektiğini göstermek için 
varsayılan beş saniyelik bir zaman aşımı vardır. Belirteç üzerinde iptal istendiğinde: 

o Uygulamanın gerçekleştirdiği diğer arka plan işlemleri iptal edilmelidir, 
o StopAsync içinde çağrılan yöntemler hemen döndürmelidir. 

Ancak,—istek iptal edildikten sonra, çağıran tüm görevlerin tamamlanmasını bekler. 

Uygulama beklenmedik şekilde kapanıyorsa (örneğin, uygulamanın işlemi başarısız olursa) 

StopAsync çağrımayabilir. Bu nedenle, StopAsync veya içinde gerçekleştirilen işlemler tarafından 
çağrılan yöntemler gerçekleşmeyebilir. 

Varsayılan beş saniyelik kapatılma zaman aşımını uzatmak için, şunu ayarlayın: 

o Genel ana bilgisayar kullanılırken ShutdovvnTimeout. Daha fazla bilgi için bkz. .NET genel ana 
bilgisayar. 












o Web ana bilgisayarı kullanılırken, kapatılma zaman aşımı konak yapılandırma ayarı. Daha fazla 
bilgi için bkz. AS P.N ET Core Web ana bilgisayarı. 

Barındırılan hizmet, uygulama başlangıcında bir kez etkinleştirilir ve uygulama kapatılırken düzgün şekilde 
kapanır. Arka plan görevinin yürütülmesi sırasında bir hata oluşturulursa, stopAsync çağrılmasa bile 
Dispose çağrılmalıdır. 

Zamanlanmış arka plan görevleri 

Zamanlanmış bir arka plan görevi, System. Threading. Timer sınıfından kullanımını sağlar. Zamanlayıcı, 
görevin Dowork yöntemini tetikler. Zamanlayıcı stopAsync devre dışı bırakılır ve hizmet kapsayıcısı 
Dispose bırakıldığında atıldı: 


internal class TimedHostedService : IHostedService, IDisposable 

{ 

private readonly ILogger _logger; 
private Timer _timer; 

public TimedHostedService(ILogger<TimedHostedService> logger) 

{ 

_logger = logger; 

} 

public Task StartAsync(CancellationToken cancellationToken) 

{ 

_logger.LogInformation("Timed Background Service is starting."); 

_timer = new Timer(DoWork, null, TimeSpan.Zero, 

TimeSpan.FromSeconds(5)); 

return Task.CompletedTask; 

} 

private void DoWork(object State) 

{ 

_logger.LogInformation("Timed Background Service is working."); 

} 

public Task StopAsync(CancellationToken cancellationToken) 

{ 

_logger.LogInformation("Timed Background Service is stopping."); 
_timer?.Change(Timeout.Infinite, 0); 
return Task.CompletedTask; 

} 

public void Dispose() 

{ 

_timer?.Dispose(); 

} 

} 


Hizmet, AddHostedService uzantısı yöntemiyle startup.configureServices kaydedilir: 


Services.AddHostedService<TimedHostedService>(); 


Bir arka plan görevinde kapsamlı bir hizmeti kullanma 


Kapsamlı hizmetleri bir iHostedService içinde kullanmak için bir kapsam oluşturun. Barındırılan hizmet 











için varsayılan olarak kapsam oluşturulmaz. 


Kapsamlı arka plan görev hizmeti, arka plan görevinin mantığını içerir.Aşağıdaki örnekte, hizmetine bir 
ILogger eklenmiş olur: 

internal interface IScopedProcessingService 

{ 

void DoWork(); 

} 

internal class ScopedProcessingService : IScopedProcessingService 

{ 

private readonly ILogger _logger; 

public ScopedProcessingService(ILogger<ScopedProcessingService> logger) 

{ 

_logger = logger; 

} 

public void DoWork() 

{ 

_logger.LogInformation("Scoped Processing Service is working."); 

} 

} 

Barındırılan hizmet, Dowork yöntemini çağırmak için kapsamlı arka plan görev hizmetini çözümlemek 
üzere bir kapsam oluşturur: 



internal class ConsumeScopedServiceHostedService : IHostedService 

{ 

private readonly ILogger _logger; 

public ConsumeScopedServiceHostedService(IServiceProvider Services, 
ILogger<ConsumeScopedServiceHostedService> logger) 

{ 

Services = Services; 

_logger = logger; 

} 

public IServiceProvider Services { get; } 

public Task StartAsync(CancellationToken cancellationToken) 

{ 

_logger.LogInformation( 

"Consume Scoped Service Hosted Service is starting."); 

DoWork(); 

return Task.CompletedTask; 

} 

private void DoWork() 

{ 

_logger.LogInformation( 

"Consume Scoped Service Hosted Service is working."); 

using (var scope = Services.CreateScope()) 

{ 

var scopedProcessingService = 
scope.ServiceProvider 

.GetRequiredService<IScopedProcessingService>(); 
scopedProcessingService.DoWork(); 

} 

} 

public Task StopAsync(CancellationToken cancellationToken) 

{ 

_logger.LogInformation( 

"Consume Scoped Service Hosted Service is stopping."); 
return Task.CompletedTask; 

} 

} 

Hizmetler Startup.ConfigureServices kaydedilir. IHostedService uygulama AddHostedService uzantısı 
yöntemiyle kaydedilir: 

Services.AddHostedService<ConsumeScopedServiceHostedService>(); 

Services.AddScopedcIScopedProcessingService, ScopedProcessingService»(); 


Sıraya alınan arka plan görevleri 

Arka plan görev kuyruğu .NET Framevvork4. x QueueBackgroundWorkltem temel alır (ASP.NET Core 
için kesin olarak zamanlandı): 







public interface IBackgroundTaskQueue 

{ 

void QueueBackgroundWorkItem(Func<CancellationToken, Task> workItem); 

Task<Func<CancellationToken, Task>> DequeueAsync( 

CancellationToken cancellationToken); 

} 

public class BackgroundTaskQueue : IBackgroundTaskQueue 

{ 

private ConcurrentQueue<Func<CancellationToken, Task>> _workItems = 
new ConcurrentQueue<Func<CancellationToken, Task>>(); 
private SemaphoreSlim _signal = new SemaphoreSlim(0); 

public void QueueBackgroundWorkItem( 

FunccCancellationTokerij Task> workItem) 

{ 

if (workItem == null) 

{ 

throw new ArgumentNullException(nameof(workItem)); 

} 

_workItems.Enqueue(workItem); 

_signal.Release(); 

} 

public async Task<Func<CancellationTokenj Task>> DequeueAsync( 

CancellationToken cancellationToken) 

{ 

await _signal.WaitAsync(cancellationToken); 

_workItems.TryDequeue(out var workItem); 

return workItem; 

} 

} 

QueueHostedService , sıradaki arka plan görevleri, uzun süre çalışan bir iHostedService uygulamaya 
yönelik temel bir sınıf olan bir Backgroundserviceolarak kuyruklanmış ve yürütülür: 




public class QueuedHostedService : BackgroundService 

{ 

private readonly ILogger _loggen; 

public QueuedHostedService(IBackgroundTaskQueue taskQueue, 

ILoggerFactory loggerFactory) 

{ 

TaskQueue = taskQueue; 

_logger = loggerFactory.Createl_ogger<QueuedHostedService>(); 

} 

public IBackgroundTaskQueue TaskQueue { getj } 

protected async override Task ExecuteAsync( 

CancellationToken cancellationToken) 

{ 

_logger.LogInformation("Queued Flosted Service is starting. "); 

while (!cancellationToken.IsCancellationRequested) 

{ 

var workItem = await TaskQueue.DequeueAsync(cancellationToken); 

try 

{ 

await workItem(cancellationToken); 

} 

catch (Exception ex) 

{ 

_logger.LogError(eXj 

"Error occurred executing {WorkItem}.", nameof(workItem)); 

} 

} 

_logger. LogInformation( "Queued Flosted Service is stopping."); 

} 

} 

Hizmetler Startup.ConfigureServices kaydedilir. IHostedService uygulama AddHostedService uzantısı 
yöntemiyle kaydedilir: 

Services.AddHostedService<QueuedHostedService>(); 

Services.AddSingleton<IBackgroundTasl<Queue, BackgroundTaskQueue>(); 


Dizin sayfası model sınıfında: 



oluşturmak için kullanılan IServiceScopeörnekleri oluşturmak için kullanılır. Bir kapsam, veritabanı 
kayıtlarını iBackgroundTaskQueue (bir tek hizmet) yazmak için uygulamanın AppDbContext ( kapsamlı bir 
hizmet) kullanmak üzere oluşturulur. 












public class IndexModel : PageModel 

{ 

private readonly AppDbContext _db; 
private readonly ILogger _logger; 

private readonly IServiceScopeFactory _serviceScopeFactory; 

public IndexModel(AppDbContext db, IBackgroundTaskQueue queue, 

ILogger<IndexModel> logger, IServiceScopeFactory serviceScopeFactory) 

{ 

_db = db; 

_logger = logger; 

Queue = queue; 

_serviceScopeFactory = serviceScopeFactory; 

} 

public IBackgroundTaskQueue Queue { get; } 

Dizin sayfasında Görev Ekle düğmesi seçildiğinde onPostAddTask yöntemi yürütülür. 
QueueBackgroundworkitem bir iş öğesini kuyruğa almak için çağrılır: 

public IActionResult OnPostAddTaskAsync() 

{ 

Queue.QueueBackgroundWorkItem(async token => 

{ 

var guid = Guid.NewGuid() .ToStringO; 

using (var scope = _serviceScopeFactory.CreateScope()) 

{ 

var scopedServices = scope.ServiceProvider; 

var db = scopedServices.GetRequiredService<AppDbContext>(); 

for (int delayLoop = 1; delayLoop < 4; delayLoop++) 

{ 

try 

{ 

db.Messages.Add( 
new Message() 

{ 

Text = $"Queued Background Task {guid} has " + 
$"written a step. {delayLoop}/3" 

}); 

await db.SaveChangesAsync(); 

} 

catch (Exception ex) 

{ 

_logger.LogError(eXj 

"An error occurred writing to the " + 

"database. Error: {Message}", ex.Message); 

} 

await Task.Delay(TimeSpan.FromSeconds(5 ), token); 

} 

} 

_logger.LogInformation( 

"Queued Background Task {Guid} is complete. 3/3", guid); 

}); 

return RedirectToPage(); 


Ek kaynaklar 





• Ihostedservice ve BackgroundService sınıfıyla mikro hizmetlerde arka plan görevleri uygulama 

• Timer 
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Tarafından Luke Latham ve Pavel Krymets 

IHostingStartup (barındırma başlatma) uygulaması, bir dış derlemeden başlatma sırasında bir uygulamaya 
iyileştirmeler ekler. Örneğin, bir harici kitaplık ek yapılandırma sağlayıcıları ya da bir uygulama hizmetlerini 
barındıran bir başlangıç uygulaması kullanabilirsiniz. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

HostingStartup özniteliği 

A HostingStartup öznitelik, çalışma zamanında etkinleştirmek için bir barındırma başlangıç derleme varlığını 
gösterir. 

Giriş derleme veya içeren derlemenin startup sınıfı için taranan otomatik olarak HostingStartup özniteliği. 
Aranacak derlemelerin listesini HostingStartup öznitelikleri içinde yapılandırmasından çalışma zamanında 
yüklendiği VVebHostDefaults.HostingStartupAssembliesKey. Keşiften çıkarmak için derleme listesini alanından 
yüklenen WebHostDefaults.HostingStartupExcludeAssembliesKey. 

Aşağıdaki örnekte, barındırma başlangıç derlemenin ad alanıdır startupEnhancement . Barındırma başlatma 
kodunu içeren sınıf StartupEnhancementHostingStartup : 

[assembly: HoştingStartup(typeof(StartupEnhancement.StartupEnhancementHostingStartup))] 

HostingStartup Öznitelik genellikle barındırma başlangıç derleme içinde bulunan IHostingStartup uygulama 
sınıf dosyası. 

Yüklenen barındırma başlangıç derlemeler keşfedin 

Yüklenen barındırma başlangıç derlemeleri bulmak için günlük kaydını etkinleştirmek ve uygulama günlüklerini 
kontrol edin. Derlemeler yüklenirken oluşan hataları günlüğe kaydedilir. Yüklenen barındırma başlangıç 
derlemeler hata ayıklama düzeyinde kaydedilir ve tüm hatalar kaydedilir. 

Başlangıç derlemeleri barındırma otomatik yüklemeyi devre dışı 

Başlangıç derlemeleri barındırma otomatik yüklemeyi devre dışı bırakmak için aşağıdaki yaklaşımlardan birim 
kullanın: 

• Tüm barındırma başlangıç derlemeleri yüklenmesini önlemek için aşağıdakilerden birini ayarlayın true 
veya ı : 

o Barındırma başlangıç ana bilgisayar yapılandırma ayarını önle: 









public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseSetting( 

WebHostDefaults.PreventHostingStartupKeyj "true") 

.UseStartup<Startup>(); 

}); 

o aspnetcore_preventhostingstartup ortam değişkeni. 

• Belirli barındırma başlangıç derlemeleri yüklenmesini önlemek için aşağıdakilerden birini başlangıçta 
hariç tutmak için başlangıç derlemeleri barındırma noktalı virgülle ayrılmış bir dizeye ayarlayın: 

o Barındırma başlatma derlemeleri dışlama ana bilgisayar yapılandırma ayarı: 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

. ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseSetting( 

WebHostDefaults.HostingStartupExcludeAssembliesKey , 

"{ASSEMBLY1;ASSEMBLY2; ...}") 

.UseStartup<Startup>(); 

}); 

O ASPNETCORE_HOSTINGSTARTUPEXCLUDEASSEMBLIES Ortam değişkeni. 

Hem ana bilgisayar yapılandırma ayarı ve ortam değişkenini ayarlarsanız, ana bilgisayar ayarını davranışını 
denetler. 

Ana bilgisayar ayarı veya ortam değişkenini kullanarak barındırma başlangıç derlemeleri devre dışı bırakma, 
derlemenin genel olarak devre dışı bırakır ve uygulama çeşitli özelliklerini devre dışı bırakabilir. 

Project 

Bir barındırma başlatma aşağıdaki proje türlerini birini oluşturun: 

• Sınıf kitaplığı 

• Konsol uygulaması giriş noktası olmayan 

Sınıf kitaplığı 

Bir barındırma başlangıç geliştirme'de sınıf kitaplığının sağlanabilir.Kitaplığı içeren bir Hostingstartup 
özniteliği. 

Örnek kod bir Razor sayfaları uygulamasını içeren HostingStartupAppve bir sınıf kitaplığı 
HostingStartupLibrary. Sınıf kitaplığı: 

• Bir barındırma başlangıç sınıfı içeren serviceKeyinjection , uygulayan iHostingstartup . 
serviceKeyinjection bellek içi yapılandırma Sağlayıcısını kullanarak uygulamanın yapılandırmasına hizmet 

dizeleri çifti ekler (AddlnMemoryCollection). 

• içeren bir Hostingstartup barındırma startup şirketinizin ad alanını ve sınıf tanımlayan özniteliği. 

serviceKeyinjection sınıfının Configure yöntemi bir uygulamaya geliştirmeler eklemek için bir 
IVVebHostBuilder kullanır. 


HostingStartupLibrary/Service Keylnjection.es: 








[assembly: HoştingStartup(typeof(HostingStartupLibrary.ServiceKeylnjection))] 

namespace HostingStartupLibrary 

{ 

public class ServiceKeylnjection : IHostingStartup 

{ 

public void Configure(IWebHostBuilder builder) 

{ 

builder.ConfigureAppConfiguration(config => 

{ 

var dict = new Dictionarycstringj string> 

{ 

{"DevAccount_FromLibrary ", "DEV_lllllll-lli:L"} ) 
{"ProdAccount_FromLibrary", "PR0D_2222222-2222"} 

}; 

config.AddlnMemoryCollection(dict); 

})J 

} 

} 

} 


Uygulama dizin sayfasına okur ve Sınıf Kitaplığınızın barındırma başlangıç derlemesi tarafından ayarlanmış iki 
anahtarı için yapılandırma değerlerini işler: 

HostingStartupApp/Pages/lndex.cshtml.cs: 

public class IndexModel : PageModel 

{ 

public IndexModel(IConfiguration config) 

{ 

ServiceKey_Development_Library = config["DevAccount_FromLibrary"]; 

ServiceKey_Production_Library = config["ProdAccount_FromLibrary"]; 

ServiceKey_Development_Package = config["DevAccount_FromPackage"]; 

ServiceKey_Production_Package = config["ProdAccount_FromPackage"]; 

} 

public string ServiceKey_Development_Library { get; private set; } 
public string ServiceKey_Production_Library { get; private set; } 
public string ServiceKey_Development_Package { get; private set; } 
public string ServiceKey_Production_Package { get; private set; } 

public void OnGet() 

{ 

} 

} 

Örnek kod de ayrı bir barındırma başlatma sağlayan bir NuGet paketi proje içerir HostingStartupPackage. 
Paket, daha önce açıklanan Sınıf Kitaplığı nın aynı özelliklere sahiptir.Paketi: 

• Bir barındırma başlangıç sınıfı içeren ServiceKeylnjection , uygulayan IHostingStartup . 

ServiceKeylnjection Hizmet dizeleri çifti uygulamanın yapılandırmasına ekler. 

• içeren bir Hostingstartup öznitel iği. 


HostingStartupPackage/ServlceKey lnjectlon.cs: 







[assembly: HoştingStartup(typeof(HoştingStartupPackage.ServiceKeyInjection))] 

namespace HostingStartupPackage 
{ 

public class ServiceKeylnjection : IHostingStartup 
{ 

public void Configure(IWebHostBuilder builder) 

{ 

builder.ConfigureAppConfiguration(config => 

{ 

var dict = new Dictionary<stringj string> 

{ 

{"DevAccount_FromPackage ", "DEV_3333333-3333"}, 

{"ProdAccount_FromPackage", "PR0D_4444444-4444"} 

}; 

config.AddlnMemoryCollection(dict); 

})J 

} 

} 

} 

Uygulama dizin sayfasına okur ve paketin barındırma başlangıç derlemesi tarafından ayarlanmış iki anahtarı 
için yapılandırma değerlerini işler: 

HostingStartupApp/Pages/lndex.cshtml.cs: 

public class IndexModel : PageModel 
{ 

public IndexModel(IConfiguration config) 

{ 

ServiceKey_Development_Library = config["DevAccount_FromLibrary"]; 

ServiceKey_Production_Library = config["ProdAccount_FromLibrary"]; 

ServiceKey_Development_Package = config["DevAccount_FromPackage"]; 

ServiceKey_Production_Package = config["ProdAccount_FromPackage"]; 

} 

public string ServiceKey_Development_Library { get; private set; } 
public string ServiceKey_Production_Library { get; private set; } 
public string ServiceKey_Development_Package { get; private set; } 
public string ServiceKey_Production_Package { get; private set; } 

public void OnGet() 

{ 

} 

} 

Konsol uygulaması giriş noktası olmayan 

Bu yaklaşım, yalnızca .NET Framevvork .NET Core uygulamaları için kullanılabilir. 

Bir derleme zamanı başvurusu için etkinleştirme gerektirmeyen bir dinamik barındırma başlangıç geliştirmesi 
de içeren giriş noktası olmayan bir konsol uygulaması sağlanan bir Hostingstartup özniteliği. Konsol 
uygulaması yayımlama, çalışma zamanı Mağazası'ndan kullanılabilen bir barındırma başlangıç bütünleştirilmiş 
kod üretir. 

Bir konsol uygulaması giriş noktası olmayan, çünkü bu işlemde kullanılır: 

• Bağımlılıkları dosya barındırma başlangıç derlemedeki barındırma için başlangıç kullanmak için gereklidir. 
Kitaplık değil bir uygulama yayımlama tarafından üretilen bir çalıştırılabilir uygulama varlık bağımlılıkları 
dosyasıdır. 

• Bir kitaplık doğrudan eklenemez çalışma zamanı Paket Deposu, paylaşılan çalışma zamanını hedefleyen 




çalıştırılabilir bir proje gerektirir. 


Dinamik barındırma başlangıç oluşturulmasını içinde: 

• Bir giriş noktası olmadan bir barındırma başlangıç derleme konsol uygulamasından oluşturulur: 
o içeren bir sınıfı içeren iHostingstartup uygulaması. 

o içeren bir HostingStartup tanımlamak için öznitelik iHostingstartup uygulama sınıfı. 

• Konsol uygulaması barındırma startup şirketinizin bağımlılıkları almak için yayımlanır. Kullanılmayan 
bağımlılıkları bağımlılıkları dosyasından atılır konsol uygulaması yayımlama bir sonuç olur. 

• Bağımlılıkları dosyası, çalışma zamanı barındırma başlangıç derleme konumunu ayarlamak için değiştirilir. 

• Barındırma başlangıç derleme ve bağımlılıkları dosyası çalışma zamanı paketi deposuna yerleştirilir. 
Barındırma başlangıç derleme ve bağımlılıkları dosyasını bulmak için bir ortam değişkenlerini çift içinde 
listelendikleri. 

Konsol uygulama başvuruları Microsoft.AspNetCore.Hosting.Abstractions paket: 

<Project Sdk="Microsoft.NET.Sdk"> 

<PropertyGroup> 

<TargetFramework>netcoreapp3.0</TargetFramework> 

</PropertyGroup> 

<ItemGroup> 

<PackageReference Include="Microsoft.AspNetCore.Hosting.Abstractions" 

Version="3.0.0" /> 

</ItemGroup> 

</Project> 

Hostingstartup özniteliği, bir sınıfı IVVebHostoluştururken yükleme ve yürütme için iHostingstartup bir 
uygulama olarak tanımlar. Aşağıdaki örnekte, ad alanı startupEnhancement , ve sınıf 
StartupEnhancementHostingStartup : 

[assembly: HoştingStartup(typeof(StartupEnhancement.StartupEnhancementHostingStartup))] 

Arabirimini uygulayan bir sınıf iHostingstartup . Sınıfın Configure yöntemi bir uygulamaya iyileştirmeler 
eklemek için bir IVVebHostBuilder kullanır. iHostingstartup.configure barındırma başlangıç derleme önce 
çalışma zamanı tarafından çağrılır startup.configure kullanıcı kodunda barındırma başlangıç derlemesi 
tarafından sağlanan herhangi bir yapılandırma üzerine yazmak kullanıcı kodu sağlar. 

namespace StartupEnhancement 
{ 

public class StartupEnhancementHostingStartup : IHostingStartup 
{ 

public void Configure(IWebHostBuilder builder) 

{ 

// Use the IWebHostBuilder to add app enhancements. 

} 

} 

} 

Bir IHostingStartup projesi oluştururken, bağımlılıklar dosyası (. Deps. JSON) derlemenin runtime konumunu 
bin klasörüne ayarlar: 














"targets": { 

".NETCoreApp,Version=v3.0": { 

"StartupEnhancement/1.0.0": { 

"dependencies": { 

"Microsoft.AspNetCore.Hosting.Abstractions": "3.0.0" 

}, 

"runtime": { 

"StartupEnhancement.dll": {} 

} 

} 

} 

} 

Dosyanın yalnızca bir parçası olarak gösterilir. Derleme adı örnekte startupEnhancement . 

Barındırma başlatma tarafından belirtilen yapılandırma 

Yapılandırma işlemi, barındırma başlatmasının yapılandırmasının öncelikli olmasını mı yoksa uygulamanın 
yapılandırmasının öncelikli olmasını mı istediğinize bağlı olarak iki yaklaşımdan yararlanabilir: 

1. Uygulamanın ConfigureAppConfiguration temsilcileri çalıştırıldıktan sonra yapılandırmayı yüklemek için 
ConfigureAppConfiguration kullanarak uygulamaya yapılandırma sağlayın. Barındırma başlangıç 
yapılandırması, uygulamanın yapılandırmasına bu yaklaşımı kullanarak öncelik kazanır. 

2. Uygulamanın ConfigureAppConfiguration temsilcileri yürütmeden önce yapılandırmayı yüklemek için 
UseConfiguration kullanarak uygulamaya yapılandırma sağlayın. Uygulamanın yapılandırma değerleri, bu 
yaklaşımı kullanarak barındırma başlatma tarafından sağlananlara göre önceliklidir. 


public class Configurationlnjection : IHostingStartup 
{ 

public void Configure(IWebHostBuilder builder) 

{ 

Dictionarycstring, string> dict; 

builder.ConfigureAppConfiguration(config => 

{ 

dict = new Dictionary<string, string> 

{ 

{"ConfigurationKeyl", 

"From IHostingStartup: Higher priority " + 
"than the app's configuration. 

}; 

config.AddlnMemoryCollection(dict); 

}); 

dict = new Dictionarycstring, string> 

{ 

{"ConfigurationKey2", 

"From IHostingStartup: Lower priority " + 

"than the app's configuration."}, 

}; 

var builtConfig = new ConfigurationBuilder() 

.AddlnMemoryCollection(dict) 

.Build(); 

builder.UseConfiguration(builtConfig); 

} 

} 




Barındırma başlangıç derlemeyi belirtin 

Bir sınıf kitaplığı - veya konsol uygulaması sağlanan-başlangıç barındırma için barındırma başlangıç derlemenin 
adını belirtin. aspnetcore_hostingstartupassemblies ortam değişkeni. Ortam değişkenini derlemelerin noktalı 
virgülle ayrılmış bir listedir. 

Yalnızca barındırma başlangıç derlemeler için taranan Hostingstartup özniteliği. Örnek uygulama için 
HostingStartupApp, daha önce açıklanan barındırma startup'lar bulmak için ortam değişkeni şu değere 
ayarlanır: 

HostingStartupLibrary;HostingStartupPackage;StartupDiagnostics 

Barındırma başlangıç bütünleştirilmiş kodları, barındırma başlangıç derlemeleri ana bilgisayar yapılandırma 
ayarı kullanılarak da ayarlanabilir: 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseSetting( 

WebHostDefaults.HostingStartupAssembliesKey, 

"{ASSEMBLY1;ASSEMBLY2; 

.UseStartup<Startup>(); 

}); 

Birden çok barındırma başlatması varsa, Configure yöntemleri derlemelerin listelendiği sırada yürütülür. 

Etkinleştirme 

Başlangıç etkinleştirme barındırmak için Seçenekler şunlardır: 

• Çalışma zamanı deposu - etkinleştirme, etkinleştirme için bir derleme zamanı başvurusu gerektirmez. Örnek 
uygulama barındırma başlangıç derleme ve bağımlılıkları dosyalar bir klasöre yerleştirir 
dağ/ftmmultimachine ortamında barındırma başlangıç dağıtımını kolaylaştırmak için. Dağıtım klasörü 
oluşturur veya değiştirir barındırma için başlangıç etkinleştirmek için dağıtım sistemi ortam değişkenlerini 
bir PovverShell betiğini de içerir. 

• Etkinleştirme için gerekli derleme zamanı başvurusu 
o NuGet paketi 

o Proje bin klasörü 

Çalışma zamanı deposu 

Barındırma başlangıç uygulaması yerleştirilir çalışma zamanı deposu. Gelişmiş uygulama tarafından bir 
derleme zamanı başvurusu derleme için gerekli değildir. 

Barındırma başlangıç oluşturulduktan sonra bir çalışma zamanı deposu bildirim proje dosyası kullanılarak 
oluşturulur ve dotnet deposu komutu. 

dotnet store --manifest {MANİFEST FİLE} --runtime {RUNTIME IDENTIFIER} --output {OUTPUT LOCATION} --skip- 
optimization 

Örnek uygulamada ( RuntimeStore Proje) şu komut kullanılır: 

dotnet store --manifest store.manifest.csproj --runtime win7-x64 --output ./deployment/store --skip- 
optimization 









Çalışma zamanı deposu bulmak çalışma zamanı için çalışma zamanı deponun konumunu eklenen 
dotnet_shared_store ortam değişkeni. 

Değiştirme ve barındırma startup şirketinizin bağımlılıkları dosyasının yerleştirin 

Geliştirme için bir paket başvurusu olmadan geliştirme etkinleştirmek için çalışma zamanı ile ek bağımlılıklar 
belirtin additionalDeps . additionalDeps sağlar: 

• Başlangıçta uygulamanın kendi. Deps . JSON dosyasıyla birleştirilecek bir dizi ek. Deps. JSON dosyası 
sağlayarak uygulamanın kitaplık grafiğini genişletin. 

• Barındırma başlangıç derlemesine bulunabilir ve yüklenebilir olun. 

Ek Bağımlılıklar dosyası oluşturmak için önerilen yaklaşımdır: 

1. Yürütme dotnet pubiish önceki bölümde başvurulan çalışma zamanı deposu bildirim dosyası üzerinde. 

2. Bildirimlerin bildirim başvurusunu ve sonuçta elde edilen . Deps. JSON dosyasının runtime bölümünü 
kaldırın. 

Örnek projesinde store.manifest/ 1 . 0.0 özelliği kaldırılır targets ve libraries bölümü: 

{ 

"runtimeTarget": { 

"name": ".NETCoreApp,Version=v3.0", 

"signatune": "" 

}, 

"compilationOptions": {}, 

"targets": { 

".NETCoreApp,Version=v3.0": { 

"store.manifest/1.0.0": { 

"dependencies": { 

"StartupDiagnostics": "1.0.0" 

}, 

"runtime": { 

"store.manifest.dll": {} 

} 

}, 

"StartupDiagnostics/1.0.0": { 

"runtime": { 

"lib/netcoreapp3.0/StartupDiagnostics.dil": { 

"assemblyVersion": "1.0. 8 . 0 ", 

"fileVersion": "1.0.0.0" 

} 

} 

} 

} 

}, 

"libraries": { 

"store.manifest/1.0.0": { 

"type": "project", 

"serviceable": false, 

"sha512": "" 

}, 

"StartupDiagnostics/1.0.0": { 

"type": "package", 

"serviceable": true, 

"sha512": "sha512- 

xrhzuNSyM5/f4Zswhool9dmIYLP64wMnqU3SyTKVDKDVj5T+qtzypl81mM/aFlLLpYrf0FYpVWvGujd7/FfMEw==" J 
"path": "startupdiagnostics/1.0.0"j 
"hashPath": "startupdiagnostics.1.0.0.nupkg.sha512" 

} 

} 

} 










. Deps. JSON dosyasını şu konuma yerleştirin: 


{ADDITIONAL DEPENDENCIES PATH}/shared/{SHARED FRAMEUORK NAME}/{SHARED FRAMEUORK VERSION}/{ENHANCEMENT 
ASSEMBLY NAME}.deps.json 

• {additional dependencies path} - Eklenen konumu dotnet_additional_deps ortam değişkeni. 

• {shared frameiaIOrk name} - Bu ek bağımlılıklar dosyası için gerekli framevvork paylaşılan. 

• {shared frameiaIOrk version} - Minimum paylaşılan framework sürümü. 

• {enhancement assembly name} - Geliştirme'nın bütünleştirilmiş kod adı. 

Örnek uygulamada ( RurıtimeStore Proje), ek bağımlılıklar dosyası şu konuma yerleştirilir: 

deployment/additionalDeps/shared/Microsoft.AspNetCore.App/3.0.0/StartupDiagnostics.deps.json 

Ek Bağımlılıklar dosya konumunu eklenir çalışma zamanı depolama konumu bulmak çalışma zamanı için 
dotnet_additional_deps ortam değişkeni. 

Örnek uygulamada ( RurıtimeStore Proje), çalışma zamanı deposu oluşturma ve dosya kullanarak gerçekleştirilir 
ek bağımlılıklar oluşturma bir PovverShe betiği. 

Çeşitli işletim sistemleri için ortam değişkenlerini ayarlama örnekleri için bkz: birden fazla ortam kullanayım. 

Dağıtım 

Bir barındırma başlatma multimachine ortamında dağıtımını kolaylaştırmak için örnek uygulamayı oluşturur, 
bir dağıtım içeren yayımlanan çıkış klasöründe: 

• Barındırma başlangıç çalışma zamanı deposu. 

• Barındırma başlangıç bağımlılıkları dosyası. 

• Bir PovverShell Betiği oluşturur veya değiştirir aspnetcore_hostingstartupassemblies , dotnet_shared_store , 
ve dotnet_additional_deps barındırma başlangıç etkinleştirmeyi desteklemek için. Komut dosyası dağıtım 
sistemde bir yönetici PovverShell komut isteminden çalıştırın. 

NuGet paketi 

Bir NuGet paketi barındırma bir başlangıç geliştirmesi sağlanabilir. Paketin bir Hostingstartup özniteliği. Paket 
tarafından sağlanan barındırma başlangıç türleri, aşağıdaki yaklaşımlardan birini kullanarak uygulama için 
kullanıma sunulur: 

• Gelişmiş uygulamanın proje dosyası, barındırma başlangıç için bir paket başvurusu uygulamanın proje 
dosyası (bir derleme zamanı Başvurusu) sağlar. Derleme zamanı başvurusu yerinde olduğunda, barındırma 
başlangıç derlemesi ve tüm bağımlılıkları uygulamanın bağımlılık dosyasına (. Deps. JSON) dahil edilir. Bu 
yaklaşım, yayımlanan bir barındırma başlangıç derleme paketi uygulandığı nuget.org. 

• Barındırma startup şirketinizin bağımlılıkları dosyasının açıklandığı gibi gelişmiş uygulama için kullanılabilir 
hale getirileceğini çalışma zamanı deposu bölümü (olmadan, bir derleme zamanı Başvurusu). 

NuGet paketlerini ve çalışma zamanı mağazası hakkında daha fazla bilgi için aşağıdaki konulara bakın: 

• Platformlar arası araçlarla NuGet paketi oluşturma 

• Paket yayımlama 

• Çalışma zamanı paket deposu 

Proje bin klasörü 

Bir barındırma başlangıç geliştirmesi tarafından sağlanan bir b/n-Gelişmiş Uygulama derlemesinde dağıtılır. 
Derleme tarafından sağlanan barındırma başlangıç türleri, aşağıdaki yaklaşımlardan biri kullanılarak uygulama 








için kullanılabilir hale getirilir: 

• Gelişmiş uygulamanın proje dosyası, barındırma başlangıç (bir derleme zamanı başvuru) bir bütünleştirilmiş 
kod başvurusu yapar. Derleme zamanı başvurusu yerinde olduğunda, barındırma başlangıç derlemesi ve 
tüm bağımlılıkları uygulamanın bağımlılık dosyasına (. Deps. JSON) dahil edilir.Bu yaklaşım, dağıtım 
senaryosu barındırma başlatmasının derlemesine (. dil dosyası) bir derleme zamanı başvurusu yapmak ve 
derlemeyi şu şekilde taşımak için çağırdığında geçerlidir: 

o Tüketen proje. 

o Tüketim Projesi tarafından erişilebilen bir konum. 

• Barındırma startup şirketinizin bağımlılıkları dosyasının açıklandığı gibi gelişmiş uygulama için kullanılabilir 
hale getirileceğini çalışma zamanı deposu bölümü (olmadan, bir derleme zamanı Başvurusu). 

• .NET Framevvork hedeflenirken, derleme varsayılan yükleme bağlamında yüklenebilir olur; bu, .NET 
Framevvork, derlemenin aşağıdaki konumlardan birinde bulunduğu anlamına gelir: 

o Uygulama temel yolu, uygulamanın yürütülebilir dosyasının (. exe) bulunduğu bin klasörünü -. 
o Genel bütünleştirilmiş kod önbelleği (GAC) - GAC, birkaç .NET Framework uygulamanın paylaştığı 
derlemeleri depolar. Daha fazla bilgi için, bkz. nasıl yapılır: bir derlemeyi genel derleme önbelleğine 
yüklemek .NET Framevvork belgeleri. 

Örnek kod 

Örnek kod (nasıl indirileceğini) barındırma başlangıç uygulama senaryolarını gösterir: 

• iki barındırma başlangıç derlemeleri (sınıf kitaplıkları), bellek içi yapılandırma anahtar-değer çiftleri her bir 
çifti ayarlayın: 

o NuGet paketini (HostingStartupPackage) 
o Sınıf kitaplığı ( HostingStartupLibrary ) 

• Bir barındırma başlatma deposu dağıtılan bir çalışma zamanı derleme etkinleştirilir ( StartupDiagnostics ). 
Derleme, uygulamaya tanılama bilgileri sağlayan başlangıçta iki middlevvares ekler: 

o Kaydedilen Hizmetleri 

o Adres (Düzen, konak, temel yolu, yol, sorgu dizesi) 

o Bağlantı (uzak İP, uzak bağlantı noktasını, yerel İP yerel bağlantı noktası, istemci sertifikası) 
o istek üst bilgileri 
o Ortam değişkenleri 

Örneği çalıştırmak için: 

NuGet paketinden etkinleştirme 

1. Derleme HostingStartupPackage ile paket dotnet paketi komutu. 

2. Paketin derleme adını eklemek HostingStartupPackage için aspnetcore_hostingstartupassemblies ortam 
değişkeni. 

3. Derleme ve uygulamayı çalıştırın. Geliştirilmiş bir uygulamada (bir derleme zamanı Başvurusu) bir paket 
başvurusu yok. A <PropertyGroup> uygulama projesinde paket projenin çıkış dosyasını belirtir. (../ 
HostingStartupPackage/bin/Debug) bir paket olarak. Bu, uygulamanın paketi NuGet.org'e yüklemeden 
paketi kullanmasına izin verir. Daha fazla bilgi için HostingStartupApp öğesinin proje dosyasındaki 
notlara bakın. 






<PropertyGroup> 

<RestoreSources>$(RestoreSources);https://api. nuget.org/v3/index.json; ../HostingStartupPackage/bin/D 
ebug</RestoreSources> 

</PropertyGroup> 

4. Dizin sayfası tarafından işlenen hizmet yapılandırması anahtar değerleri paketin tarafından ayarlanan 
değerlerle eşleşen gözlemleyin serviceKeyinjection.configure yöntemi. 

Değişiklikler yaparsanız HostingStartupPackage proje ve yeniden derleyin, emin olmak için yerel NuGet paketi 
önbellekler temizlenir HostingStartupApp güncelleştirilmiş paket bir eski alır Paket yerel önbellekten. Yerel 
NuGet önbellekleri temizlemek için aşağıdakileri yürütün dotnet nuget Yereller komutu: 

dotnet nuget locals ali --clear 

Bir sınıf kitaplığından etkinleştirme 

1. Derleme HostingStartupLibrary sınıf kitaplığı ile dotnet derleme komutu. 

2. Sınıf Kitaplığınızın derleme adını eklemek HostingStartupLibrary için 
aspnetcore_hostingstartupassemblies ortam değişkeni. 

3. Depo- kopyalayarak Sınıf Kitaplığınızın derleme uygulamalarıyla HostingStartupLibrary.dll Sınıf 
Kitaplığınızın dosyasından çıktıyı uygulamanın derlenmiş bin/Debug klasör. 

4. Derleme ve uygulamayı çalıştırın. Uygulamanın proje dosyasındaki bir <ıtemGroup> , sınıf kitaplığının 
derlemesine ( \Bin\debug\netcoreapp3,\hostingstartupiibrary.dll) başvurur (bir derleme zamanı 
başvurusu). Notları HostingStartupApp'ın proje dosyasında daha fazla bilgi için bkz. 

<ItemGroup> 

<Reference Include=".\\bin\\Debug\\netcoreapp3.0\\HostingStartupLibrary.dll"> 

<HintPath>. \bin\Debug\netcoreapp3 .0\HostingStartupLibrary.dll</HintPath> 
<SpecificVersion>False</SpecificVersion> 

</Reference> 

</ItemGroup> 

5. Dizin sayfası tarafından işlenen hizmet yapılandırması anahtar değerleri sınıf kitaplığının tarafından 
ayarlanan değerlerle eşleşen gözlemleyin serviceKeyinjection.configure yöntemi. 

Mağaza tarafından dağıtılan bir çalışma zamanı derlemesindeki etkinleştirme 

1. StartupDiagnostics proje kullandığı PovverShell değiştirmek için kendi StartupDiagnostics.deps.json dosya. 
PovverShell, Windows 7 SP1 ve Windows Server 2008 R2 SP1 ile başlayarak VVİndovvs üzerinde varsayılan 
olarak yüklenir. PovverShell diğer platformlarda edinmek için bkz. VVİndovvs PovverShell'i yükleme. 

2. Runtimesyürüme klasöründe Build. psl betiğini yürütün. Betik: 

• StartupDiagnostics paketini obj\packages klasöründe oluşturur. 

• Mağaza klasöründeki StartupDiagnostics çalışma zamanı deposunu oluşturur. Betikteki 

dotnet store komutu, VVİndovvs 'a dağıtılan bir barındırma başlatması için win7-x64 çalışma zamanı 
tanımlayıcısı 'nı (RID) kullanır. Farklı bir çalışma zamanı için barındırma başlangıcını sağlarken, betiğin 
37. satırındaki doğru RID 'yi yerine koyun. StartupDiagnostics çalışma zamanı deposu daha sonra 
derlemenin tüketilebileceği makinede kullanıcının veya sistem çalışma zamanı deposuna taşınır. 
StartupDiagnostics derlemesinin Kullanıcı çalışma zamanı deposu yüklemesi konumu . 
DotNet/Store/x64/netcoreapp 3.0/startupdiagnostics/1.0.O/LIB/netcoreapp 3.0/startupdiagnostics. 
dil' d ir. 
















• Additionaldeps klasöründeki startupDiagnostics için additionaiDeps üretir. Ek bağımlılıklar daha 
sonra kullanıcının veya sistem ek bağımlılıklarına taşınır. Kullanıcı StartupDiagnostics ek bağımlılıklar 
yüklemesi konumu . DotNet/x64/additionalDeps/startupdiagnostics/Shcıred/Microsoft. NETCore. 
app/3.0.0/StartupDiagnostics. Deps. VSO/Volur. 

• Dağıtım klasörüne Deploy. psl dosyasını koyar. 

3. Dağıtım klasöründe Deploy. psl betiğini çalıştırın. Betik şunu ekler: 

• ASPNETCORE_HOSTINGSTARTUPASSEMBLIES Ortam değişkenine StartupDiagnostics . 

• Barındırma başlangıç bağımlılıkları yolu (Runtimessımında projenin dağıtım klasöründe) 
dotnet_additional_deps ortam değişkenine. 

• Çalışma zamanı depolama yolu (Runtimes, projenin dağıtım klasöründe) doti\iet_shared_store ortam 
değişkenine. 

4. Örnek uygulamayı çalıştırın. 

5. istek /Services uygulamanın görmek için uç nokta Hizmetleri kayıtlı, istek /diag tanılama bilgileri görmek 
için uç nokta. 

IHostingStartup (barındırma başlatma) uygulaması, bir dış derlemeden başlatma sırasında bir uygulamaya 
iyileştirmeler ekler. Örneğin, bir harici kitaplık ek yapılandırma sağlayıcıları ya da bir uygulama hizmetlerini 
barındıran bir başlangıç uygulaması kullanabilirsiniz. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

HostingStartup özniteliği 

A HostingStartup öznitelik, çalışma zamanında etkinleştirmek için bir barındırma başlangıç derleme varlığını 
gösterir. 

Giriş derleme veya içeren derlemenin startup sınıfı için taranan otomatik olarak HostingStartup özniteliği. 
Aranacak derlemelerin listesini HostingStartup öznitelikleri içinde yapılandırmasından çalışma zamanında 
yüklendiği VVebHostDefaults.HostingStartupAssembliesKey. Keşiften çıkarmak için derleme listesini alanından 
yüklenen WebHostDefaults.HostingStartupExcludeAssembliesKey. Daha fazla bilgi için bkz. Web ana 
bilgisayarı: barındırma başlangıç derlemeleri ve Web ana bilgisayarı: Başlangıç hariç derlemeleri barındırma. 

Aşağıdaki örnekte, barındırma başlangıç derlemenin ad alanıdır startupEnhancement . Barındırma başlatma 
kodunu içeren sınıf StartupEnhancementHostingStartup : 

[assembly: HoştingStartup(typeof(StartupEnhancement.StartupEnhancementHostingStartup))] 

HostingStartup Öznitelik genellikle barındırma başlangıç derleme içinde bulunan IHostingStartup uygulama 
sınıf dosyası. 

Yüklenen barındırma başlangıç derlemeler keşfedin 

Yüklenen barındırma başlangıç derlemeleri bulmak için günlük kaydını etkinleştirmek ve uygulama günlüklerini 
kontrol edin. Derlemeler yüklenirken oluşan hataları günlüğe kaydedilir. Yüklenen barındırma başlangıç 
derlemeler hata ayıklama düzeyinde kaydedilir ve tüm hatalar kaydedilir. 

Başlangıç derlemeleri barındırma otomatik yüklemeyi devre dışı 

Başlangıç derlemeleri barındırma otomatik yüklemeyi devre dışı bırakmak için aşağıdaki yaklaşımlardan birini 
kullanın: 

• Tüm barındırma başlangıç derlemeleri yüklenmesini önlemek için aşağıdakilerden birini ayarlayın true 
veya ı : 
















o Barındırma başlangıç önlemek ana bilgisayar yapılandırma ayarı, 
o aspnetcore_preventhostingstartup ortam değişkeni. 

• Belirli barındırma başlangıç derlemeleri yüklenmesini önlemek için aşağıdakilerden birini başlangıçta hariç 
tutmak için başlangıç derlemeleri barındırma noktalı virgülle ayrılmış bir dizeye ayarlayın: 

o Başlangıç hariç derlemeleri barındırma ana bilgisayar yapılandırma ayarı. 

O ASPNETCORE_HOSTINGSTARTUPEXCLUDEASSEMBLIES Ortam değişkeni. 

Hem ana bilgisayar yapılandırma ayarı ve ortam değişkenini ayarlarsanız, ana bilgisayar ayarını davranışını 
denetler. 

Ana bilgisayar ayarı veya ortam değişkenini kullanarak barındırma başlangıç derlemeleri devre dışı bırakma, 
derlemenin genel olarak devre dışı bırakır ve uygulama çeşitli özelliklerini devre dışı bırakabilir. 

Project 

Bir barındırma başlatma aşağıdaki proje türlerini birini oluşturun: 

• Sınıf kitaplığı 

• Konsol uygulaması giriş noktası olmayan 

Sınıf kitaplığı 

Bir barındırma başlangıç geliştirme'de sınıf kitaplığının sağlanabilir.Kitaplığı içeren bir Hostingstartup 
özniteliği. 

Örnek kod bir Razor sayfaları uygulamasını içeren HostingStartupAppve bir sınıf kitaplığı 
HostingStartupLibrary. Sınıf kitaplığı: 

• Bir barındırma başlangıç sınıfı içeren ServiceKeylnjection , uygulayan iHostingstartup . 
serviceKeyinjection bellek içi yapılandırma Sağlayıcısı'nı kullanarak uygulamanın yapılandırmasına hizmet 

dizeleri çifti ekler (AddlnMemoryCollection). 

• içeren bir Hostingstartup barındırma startup şirketinizin ad alanını ve sınıf tanımlayan özniteliği. 

serviceKeyinjection sınıfının Configure yöntemi bir uygulamaya geliştirmeler eklemek için bir 
IVVebHostBuilder kullanır. 

Hosting StartupLibrary/ServiceKey lnjection.cs\ 

[assembly: HoştingStartup(typeof(HostingStartupLibrary.ServiceKeylnjection))] 

namespace HostingStartupLibrary 
{ 

public elass ServiceKeylnjection : IHostingStartup 
{ 

public void Configure(IWebHostBuilder builder) 

{ 

builder.ConfigureAppConfiguration(config => 

{ 

var dict = new Dictionarycstring, string> 

{ 

{"DevAccount_FromLibrary ", "DEVJLllllll-llll"}, 

{"ProdAccount_FromLibrary", "PR0D_2222222-2222"} 

}; 

config.AddlnMemoryCollection(dict); 

}); 

} 

} 

} 












Uygulama dizin sayfasına okur ve Sınıf Kitaplığı'nızın barındırma başlangıç derlemesi tarafından ayarlanmış iki 
anahtarı için yapılandırma değerlerini işler: 

HostingStartupApp/Pages/lndex.cshtml.cs : 

public class IndexModel : PageModel 

{ 

public IndexModel(IConfiguration config) 

{ 

ServiceKey_Development_Library = config["DevAccount_FromLibrary"]; 

ServiceKey_Production_Library = config [ "ProdAccount_FromLibrar'y"]; 

ServiceKey_Development_Package = config["DevAccount_FromPackage"]; 

ServiceKey_Production_Package = config["ProdAccount_FromPackage"]; 

} 

public string ServiceKey_Development_Library { get; private set; } 
public string ServiceKey_Production_Library { get; private set; } 
public string ServiceKey_Development_Package { get; private set; } 
public string ServiceKey_Production_Package { get; private set; } 

public void OnGet() 

{ 

} 

} 

Örnek kod de ayrı bir barındırma başlatma sağlayan bir NuGet paketi proje içerir HostingStartupPackage. 
Paket, daha önce açıklanan Sınıf Kitaplığının aynı özelliklere sahiptir.Paketi: 

• Bir barındırma başlangıç sınıfı içeren serviceKeyinjection , uygulayan iHostingstartup . 

serviceKeyinjection Hizmet dizeleri çifti uygulamanın yapılandırmasına ekler. 

• içeren bir Hostingstartup özniteliği. 

HostingStartupPackage/Service Keylnjection.es: 

[assembly: HoştingStartup(typeof(HostingStartupPackage.ServiceKeylnjeetion))] 

namespace HostingStartupPackage 

{ 

public class ServiceKeylnjection : IHostingStartup 

{ 

public void Configure(IWebHostBuilder builder) 

{ 

builder.ConfigureAppConfiguration(config => 

{ 

var dict = new Dictionarycstringj string> 

{ 

{"DevAccount_FromPackage ", "DEV_3333333-3333"}j 
{"ProdAccount_FromPacl<age ", "PR0D_4444444-4444"} 

}; 

config.AddInMemoryCollection(dict); 

}); 

} 

} 

} 


Uygulama dizin sayfasına okur ve paketin barındırma başlangıç derlemesi tarafından ayarlanmış iki anahtarı 
için yapılandırma değerlerini işler: 


HostingStartupApp/Pages/l ndex.cshtml.cs: 






public class IndexModel : PageModel 
{ 

public IndexModel(IConfiguration config) 

{ 

ServiceKey_Development_Library = config [ "DevAccount_FromLibrar'y"]; 

ServiceKey_Production_Library = config["ProdAccount_FromLibrary"]; 

ServiceKey_Development_Package = config["DevAccount_FromPackage"]; 

ServiceKey_Production_Package = config["ProdAccount_FromPackage"]; 

} 

public string ServiceKey_Development_Library { get; private set; } 
public string ServiceKey_Production_Library { get; private set; } 
public string ServiceKey_Development_Package { get; private set; } 
public string ServiceKey_Production_Package { get; private set; } 

public void OnGet() 

{ 

} 

} 

Konsol uygulaması giriş noktası olmayan 

Bu yaklaşLm, yalnızca .NET Framevvork .NET Core uygulamaları için kullanılabilir. 

Bir derleme zamanı başvurusu için etkinleştirme gerektirmeyen bir dinamik barındırma başlangıç geliştirmesi 
de içeren giriş noktası olmayan bir konsol uygulaması sağlanan bir Hostingstartup özniteliği. Konsol 
uygulaması yayımlama, çalışma zamanı Mağazası'ndan kullanılabilen bir barındırma başlangıç bütünleştirilmiş 
kod üretir. 

Bir konsol uygulaması giriş noktası olmayan, çünkü bu işlemde kullanılır: 

• Bağımlılıkları dosya barındırma başlangıç derlemedeki barındırma için başlangıç kullanmak için gereklidir. 
Kitaplık değil bir uygulama yayımlama tarafından üretilen bir çalıştırılabilir uygulama varlık bağımlılıkları 
dosyasıdır. 

• Bir kitaplık doğrudan eklenemez çalışma zamanı Paket Deposu, paylaşılan çalışma zamanını hedefleyen 
çalıştırılabilir bir proje gerektirir. 

Dinamik barındırma başlangıç oluşturulmasını içinde: 

• Bir giriş noktası olmadan bir barındırma başlangıç derleme konsol uygulamasından oluşturulur: 
o içeren bir sınıfı içeren iHostingstantup uygulaması. 

o içeren bir HostingStartup tanımlamak için öznitelik iHostingstartup uygulama sınıfı. 

• Konsol uygulaması barındırma startup şirketinizin bağımlılıkları almak için yayımlanır. Kullanılmayan 
bağımlılıkları bağımlılıkları dosyasından atılır konsol uygulaması yayımlama bir sonuç olur. 

• Bağımlılıkları dosyası, çalışma zamanı barındırma başlangıç derleme konumunu ayarlamak için değiştirilir. 

• Barındırma başlangıç derleme ve bağımlılıkları dosyası çalışma zamanı paketi deposuna yerleştirilir. 
Barındırma başlangıç derleme ve bağımlılıkları dosyasını bulmak için bir ortam değişkenlerini çift içinde 
listelendikleri. 


Konsol uygulama başvuruları Microsoft.AspNetCore.Hosting.Abstractions paket: 







<Project Sdk="Microsoft.NET.Sdk"> 

<PropertyGroup> 

<TargetFramework>netcoreapp2.l</TargetFramework> 

</PropertyGroup> 

<ItemGroup> 

<PackageReference Include="Microsoft.AspNetCore.Hosting.Abstractions" 

Version="2.1.1" /> 

</ItemGroup> 

</Project> 

Hostingstartup özniteliği, bir sınıfı IVVebHostoluştururken yükleme ve yürütme için iHostingstartup bir 
uygulama olarak tanımlar. Aşağıdaki örnekte, ad alanı startupEnhancement , ve sınıf 
StartupEnhancementHostingStartup : 

[assembly: HoştingStartup(typeof(StartupEnhancement.StartupEnhancementHostingStartup))] 

Arabirimini uygulayan bir sınıf iHostingstartup . Sınıfın Configure yöntemi bir uygulamaya iyileştirmeler 
eklemek için bir IVVebHostBuilder kullanır. iHostingstartup.configure barındırma başlangıç derleme önce 
çalışma zamanı tarafından çağrılır startup.configure kullanıcı kodunda barındırma başlangıç derlemesi 
tarafından sağlanan herhangi bir yapılandırma üzerine yazmak kullanıcı kodu sağlar. 

namespace StartupEnhancement 

{ 

public class StartupEnhancementHostingStartup : IHostingStartup 

{ 

public void Configure(IWebHostBuilder builder) 

{ 

// Use the IWebHostBuilder to add app enhancements. 

} 

} 

} 

Bir IHostingStartup projesi oluştururken, bağımlılıklar dosyası (. Deps. JSON) derlemenin runtime konumunu 
bin klasörüne ayarlar: 

"targets": { 

".NETCoreApp,Version=v2.1": { 

"StartupEnhancement/1.0.0": { 

"dependencies": { 

"Microsoft.AspNetCore.Hosting.Abstractions": "2.1.1" 

}, 

"runtime": { 

"StartupEnhancement.dll": {} 

} 

} 

} 

} 

Dosyanın yalnızca bir parçası olarak gösterilir. Derleme adı örnekte startupEnhancement . 

Barındırma başlatma tarafından belirtilen yapılandırma 

Yapılandırma işlemi, barındırma başlatmasının yapılandırmasının öncelikli olmasını mı yoksa uygulamanın 
yapılandırmasının öncelikli olmasını mı istediğinize bağlı olarak iki yaklaşımdan yararlanabilir: 












1. Uygulamanın ConfigureAppConfiguration temsilcileri çalıştırıldıktan sonra yapılandırmayı yüklemek için 
ConfigureAppConfiguration kullanarak uygulamaya yapılandırma sağlayın. Barındırma başlangıç 
yapılandırması, uygulamanın yapılandırmasına bu yaklaşımı kullanarak öncelik kazanır. 

2. Uygulamanın ConfigureAppConfiguration temsilcileri yürütmeden önce yapılandırmayı yüklemek için 
UseConfiguration kullanarak uygulamaya yapılandırma sağlayın. Uygulamanın yapılandırma değerleri, bu 
yaklaşımı kullanarak barındırma başlatma tarafından sağlananlara göre önceliklidir. 


public class Configurationlnjection : IHostingStartup 
{ 

public void Configure(IWebHostBuilder builder) 

{ 

Dictionary<string, string> dict; 

builder.ConfigureAppConfiguration(config => 

{ 

dict = new Dictionary<string, string> 

{ 

{"ConfigurationKeyl", 

"From IHostingStartup: Higher priority " + 
"than the app's configuration. 

}; 

config.AddlnMemoryCollection(dict); 

}); 

dict = new Dictionarycstring, string> 

{ 

{"ConfigurationKey2”, 

"From IHostingStartup: Lower priority " + 

"than the app's configuration."}, 

}; 

var builtConfig = new ConfigurationBuilder() 

.AddlnMemoryCollection(dict) 

.Build(); 

builder.UseConfiguration(builtConfig); 

} 

} 


Barındırma başlangıç derlemeyi belirtin 

Bir sınıf kitaplığı - veya konsol uygulaması sağlanan-başlangıç barındırma için barındırma başlangıç derlemenin 
adını belirtin. aspnetcore_hostingstartupassemblies ortam değişkeni. Ortam değişkenini derlemelerin noktalı 
virgülle ayrılmış bir listedir. 

Yalnızca barındırma başlangıç derlemeler için taranan Hostingstartup özniteliği. Örnek uygulama için 
HostingStartupApp, daha önce açıklanan barındırma startup'lar bulmak için ortam değişkeni şu değere 
ayarlanır: 

HostingStartupLibrary;HostingStartupPackage;StartupDiagnostics 

Bir barındırma başlangıç derleme kullanılarak da ayarlanabilir barındırma başlangıç derlemeleri ana bilgisayar 
yapılandırma ayarı. 

Birden çok barındırma başlatması varsa, Configure yöntemleri derlemelerin listelendiği sırada yürütülür. 


Etkinleştirme 







Başlangıç etkinleştirme barındırmak için Seçenekler şunlardır: 

• Çalışma zamanı deposu - etkinleştirme, etkinleştirme için bir derleme zamanı başvurusu gerektirmez. Örnek 
uygulama barındırma başlangıç derleme ve bağımlılıkları dosyalar bir klasöre yerleştirir 
dağiftmmultimachine ortamında barındırma başlangıç dağıtımını kolaylaştırmak için. Dağıtım klasörü 
oluşturur veya değiştirir barındırma için başlangıç etkinleştirmek için dağıtım sistemi ortam değişkenlerini 
bir PovverShell betiğini de içerir. 

• Etkinleştirme için gerekli derleme zamanı başvurusu 
o NuGet paketi 

o Proje bin klasörü 

Çalışma zamanı deposu 

Barındırma başlangıç uygulaması yerleştirilir çalışma zamanı deposu. Gelişmiş uygulama tarafından bir 
derleme zamanı başvurusu derleme için gerekli değildir. 

Barındırma başlangıç oluşturulduktan sonra bir çalışma zamanı deposu bildirim proje dosyası kullanılarak 
oluşturulur ve dotnet deposu komutu. 

dotnet store --manifest {MANİFEST FİLE} --runtime {RUNTIME IDENTIFIER} --output {OUTPUT LOCATION} --skip- 
optimization 

Örnek uygulamada ( RuntimeStore Proje) şu komut kullanılır: 

dotnet store --manifest store.manifest.csproj --runtime win7-x64 --output ./deployment/store --skip- 
optimization 

Çalışma zamanı deposu bulmak çalışma zamanı için çalışma zamanı deponun konumunu eklenen 
dotnet_shared_store ortam değişkeni. 

Değiştirme ve barındırma startup şirketinizin bağımlılıkları dosyasının yerleştirin 

Geliştirme için bir paket başvurusu olmadan geliştirme etkinleştirmek için çalışma zamanı ile ek bağımlılıklar 
belirtin additionalDeps . additionalDeps sağlar: 

• Başlangıçta uygulamanın kendi. Deps . JSON dosyasıyla birleştirilecek bir dizi ek. Deps. JSON dosyası 
sağlayarak uygulamanın kitaplık grafiğini genişletin. 

• Barındırma başlangıç derlemesine bulunabilir ve yüklenebilir olun. 

Ek Bağımlılıklar dosyası oluşturmak için önerilen yaklaşımdır: 

1. Yürütme dotnet pubiish önceki bölümde başvurulan çalışma zamanı deposu bildirim dosyası üzerinde. 

2. Bildirimlerin bildirim başvurusunu ve sonuçta elde edilen . Deps. JSON dosyasının runtime bölümünü 
kaldırın. 

Örnek projesinde store.manifest/ı. 0.0 özelliği kaldırılır targets ve libraries bölümü: 









"runtimeTarget": { 

"name": ".NETCoreApp,Version=v2.1", 

"signature": "4ea77c7b75adl895aelea65e6ba2399010514f99" 

b 

"compilationOptions": {}, 

"targets": { 

".NETCoreApp,Version=v2.1": { 

"stone.manifest/1.0.0": { 

"dependencies": { 

"StartupDiagnostics": "1.0.0" 

b 

"runtime": { 

"store.manifest.dll": {} 

} 

b 

"StantupDiagnostics/1.0.0": { 

"runtime": { 

"lib/netcoreapp2.1/StartupDiagnostics.dll": { 

"assemblyVersion": "1.0.0.0", 

"fileVersion": "1.0.0.0" 

} 

} 

} 

} 

b 

"libraries": { 

"store.manifest/1.0.0": { 

"type": "project", 

"serviceable": false, 

"sha512": "" 

b 

"StartupDiagnostics/1.0.0": { 

"type": "package", 

"serviceable": true, 

"sha512": "sha512- 

oiQr60vBQW7+nBTmg<LSldj06WNLRTdhOZpAdEbCuapoZ+M2DlH2uQbRLvFT8EGAAv4TAKzNtcztpx5YOgBXQQ==", 
"path": "startupdiagnostics/1.0.0", 

"hashPath": "startupdiagnostics.1.0.0.nupkg.sha512" 

} 

} 

} 


. Deps. JSON dosyasını şu konuma yerleştirin: 

{ADDITIONAL DEPENDENCİES PATH}/shared/{SHARED FRAMEUORK NAME}/{SHARED FRAMEWORK VERSION}/{ENHANCEMENT 
ASSEMBLY NAME}.deps.json 

• {additional dependencies path} - Eklenen konumu dotnet_additional_deps ortam değişkeni. 

• {shared frameiaIOrk name} - Bu ek bağımlılıklar dosyası için gerekli framevvork paylaşılan. 

• {shared frameiaIOrk version} - Minimum paylaşılan framevvork sürümü. 

• {enhancement assembly name} - Geliştirme'nın bütünleştirilmiş kod adı. 

Örnek uygulamada (RuntimeStore Proje), ek bağımlılıklar dosyası şu konuma yerleştirilir: 

deployment/additionalDeps/shared/Microsoft.AspNetCore.App/2.1.0/StartupDiagnostics.deps.json 


Ek Bağımlılıklar dosya konumunu eklenir çalışma zamanı depolama konumu bulmak çalışma zamanı için 
dotnet_additional_deps ortam değişkeni. 

Örnek uygulamada (RuntimeStore Proje), çalışma zamanı deposu oluşturma ve dosya kullanarak gerçekleştirilir 






ek bağımlılıklar oluşturma bir PovverShe betiği. 

Çeşitli işletim sistemleri için ortam değişkenlerini ayarlama örnekleri için bkz: birden fazla ortam kullanayım. 

Dağıtım 

Bir barındırma başlatma multimachine ortamında dağıtımını kolaylaştırmak için örnek uygulamayı oluşturur, 
bir dağıtım içeren yayımlanan çıkış klasöründe: 

• Barındırma başlangıç çalışma zamanı deposu. 

• Barındırma başlangıç bağımlılıkları dosyası. 

• Bir PovverShell Betiği oluşturur veya değiştirir aspnetcore_hostingstartupassemblies , dotnet_shared_store , 
ve dotnet_additional_deps barındırma başlangıç etkinleştirmeyi desteklemek için. Komut dosyası dağıtım 
sistemde bir yönetici PovverShell komut isteminden çalıştırın. 

NuGet paketi 

Bir NuGet paketi barındırma bir başlangıç geliştirmesi sağlanabilir. Paketin bir Hostingstartup özniteliği. Paket 
tarafından sağlanan barındırma başlangıç türleri, aşağıdaki yaklaşımlardan birini kullanarak uygulama için 
kullanıma sunulur: 

• Gelişmiş uygulamanın proje dosyası, barındırma başlangıç için bir paket başvurusu uygulamanın proje 
dosyası (bir derleme zamanı Başvurusu) sağlar. Derleme zamanı başvurusu yerinde olduğunda, barındırma 
başlangıç derlemesi ve tüm bağımlılıkları uygulamanın bağımlılık dosyasına (. Deps. JSON) dahil edilir. Bu 
yaklaşım, yayımlanan bir barındırma başlangıç derleme paketi uygulandığı nuget.org. 

• Barındırma startup şirketinizin bağımlılıkları dosyasının açıklandığı gibi gelişmiş uygulama için kullanılabilir 
hale getirileceğini çalışma zamanı deposu bölümü (olmadan, bir derleme zamanı Başvurusu). 

NuGet paketlerini ve çalışma zamanı mağazası hakkında daha fazla bilgi için aşağıdaki konulara bakın: 

• Platformlar arası araçlarla NuGet paketi oluşturma 

• Paket yayımlama 

• Çalışma zamanı paket deposu 

Proje bin klasörü 

Bir barındırma başlangıç geliştirmesi tarafından sağlanan bir bin-Gelişmiş Uygulama derlemesinde dağıtılır. 
Derleme tarafından sağlanan barındırma başlangıç türleri, aşağıdaki yaklaşımlardan biri kullanılarak uygulama 
için kullanılabilir hale getirilir: 

• Gelişmiş uygulamanın proje dosyası, barındırma başlangıç (bir derleme zamanı başvuru) bir bütünleştirilmiş 
kod başvurusu yapar. Derleme zamanı başvurusu yerinde olduğunda, barındırma başlangıç derlemesi ve 
tüm bağımlılıkları uygulamanın bağımlılık dosyasına (. Deps. JSON) dahil edilir.Bu yaklaşım, dağıtım 
senaryosu barındırma başlatmasının derlemesine (. dil dosyası) bir derleme zamanı başvurusu yapmak ve 
derlemeyi şu şekilde taşımak için çağırdığında geçerlidir: 

o Tüketen proje. 

o Tüketim Projesi tarafından erişilebilen bir konum. 

• Barındırma startup şirketinizin bağımlılıkları dosyasının açıklandığı gibi gelişmiş uygulama için kullanılabilir 
hale getirileceğini çalışma zamanı deposu bölümü (olmadan, bir derleme zamanı Başvurusu). 

• .NET Framevvork hedeflenirken, derleme varsayılan yükleme bağlamında yüklenebilir olur; bu, .NET 
Framevvork, derlemenin aşağıdaki konumlardan birinde bulunduğu anlamına gelir: 

o Uygulama temel yolu, uygulamanın yürütülebilir dosyasının (. exe) bulunduğu bin klasörünü -. 
o Genel bütünleştirilmiş kod önbelleği (GAC) - GAC, birkaç .NET Framevvork uygulamanın paylaştığı 
derlemeleri depolar. Daha fazla bilgi için, bkz. nasıl yapılır: bir derlemeyi genel derleme önbelleğine 
yüklemek .NET Framevvork belgeleri. 







Örnek kod 

Örnek kod (nasıl indirileceğini) barındırma başlangıç uygulama senaryolarını gösterir: 

• iki barındırma başlangıç derlemeleri (sınıf kitaplıkları), bellek içi yapılandırma anahtar-değer çiftleri her bir 
çifti ayarlayın: 

o NuGet paketini (HostingStartupPackage) 
o Sınıf kitaplığı ( HostingStartupLibrary ) 

• Bir barındırma başlatma deposu dağıtılan bir çalışma zamanı derleme etkinleştirilir ( StartupDiagnostics). 
Derleme, uygulamaya tanılama bilgileri sağlayan başlangıçta iki middlewares ekler: 

o Kaydedilen Hizmetleri 

o Adres (Düzen, konak, temel yolu, yol, sorgu dizesi) 

o Bağlantı (uzak İP, uzak bağlantı noktasını, yerel İP yerel bağlantı noktası, istemci sertifikası) 
o İstek üst bilgileri 
o Ortam değişkenleri 

Örneği çalıştırmak için: 

NuGet paketinden etkinleştirme 

1. Derleme HostingStartupPackage ile paket dotnet paketi komutu. 

2. Paketin derleme adını eklemek HostingStartupPackage için aspnetcore_hostingstartupassemblies ortam 
değişkeni. 

3. Derleme ve uygulamayı çalıştırın. Geliştirilmiş bir uygulamada (bir derleme zamanı Başvurusu) bir paket 
başvurusu yok. A <PropertyGroup> uygulama projesinde paket projenin çıkış dosyasını belirtir. (../ 
HostingStartupPackage/bin/Debug) bir paket olarak. Bu, uygulamanın paketi NuGet.org'e yüklemeden 
paketi kullanmasına izin verir. Daha fazla bilgi için HostingStartupApp öğesinin proje dosyasındaki 
notlara bakın. 

<PropertyGroup> 

<RestoreSources>$(RestoreSources);https://api. nuget.org/v3/index.json; ../HostingStartupPackage/bin/D 
ebug</RestoreSources> 

</PropertyGroup> 

4. Dizin sayfası tarafından işlenen hizmet yapılandırması anahtar değerleri paketin tarafından ayarlanan 
değerlerle eşleşen gözlemleyin serviceKeyinjection.configure yöntemi. 

Değişiklikler yaparsanız HostingStartupPackage proje ve yeniden derleyin, emin olmak için yerel NuGet paketi 
önbellekler temizlenir HostingStartupApp güncelleştirilmiş paket bir eski alır Paket yerel önbellekten. Yerel 
NuGet önbellekleri temizlemek için aşağıdakileri yürütün dotnet nuget Yereller komutu: 

dotnet nuget locals ali --clear 

Bir sınıf kitaplığından etkinleştirme 

1. Derleme HostingStartupLibrary sınıf kitaplığı ile dotnet derleme komutu. 

2. Sınıf Kitaplığınızın derleme adını eklemek HostingStartupLibrary için 
aspnetcore_hostingstartupassemblies ortam değişkeni. 

3. Depo- kopyalayarak Sınıf Kitaplığınızın derleme uygulamalarıyla HostingStartupLibrary.dll Sınıf 
Kitaplığınızın dosyasından çıktıyı uygulamanın derlenmiş bin/Debug klasör. 








4. Derleme ve uygulamayı çalıştırın. Bir <ıtemGroup> uygulama projesinde sınıf kitaplığı'nızın derleme 
dosyasına başvurur ( .\bin\Debug\netcoreapp2.1\HostingStartupLlbrary.dll) (bir derleme zamanı 
Başvurusu). Notları HostingStartupApp'ın proje dosyasında daha fazla bilgi için bkz. 

<ItemGroup> 

<Reference Include=".\\bin\\Debug\\netcoreapp2.l\\HostingStart upLibrary.dll "> 

<HintPath>. \bin\Debug\netcoreapp2.1\HostingStartupLibrary ,dll</HintPath> 
<SpecificVersion>False</SpecificVersion> 

</Reference> 

</ItemGroup> 

5. Dizin sayfası tarafından işlenen hizmet yapılandırması anahtar değerleri sınıf kitaplığının tarafından 
ayarlanan değerlerle eşleşen gözlemleyin serviceKeyinjection.configure yöntemi. 

Mağaza tarafından dağıtılan bir çalışma zamanı derlemesindeki etkinleştirme 

1. StartupDiagnostics proje kullandığı PovverShell değiştirmek için kendi StartupDiagnostics.deps.json dosya. 
PovverShell, Windows 7 SP1 ve VVİndovvs Server 2008 R2 SP1 ile başlayarak VVİndovvs üzerinde varsayılan 
olarak yüklenir. PovverShell diğer platformlarda edinmek için bkz. VVİndovvs PovverSheN'i yükleme. 

2. Runtimesyürüme klasöründe Build. psl betiğini yürütün. Betik: 

• StartupDiagnostics paketini obj\packages klasöründe oluşturur. 

• Mağaza klasöründeki StartupDiagnostics çalışma zamanı deposunu oluşturur. Betikteki 

dotnet store komutu, VVİndovvs 'a dağıtılan bir barındırma başlatması için win7-x64 çalışma zamanı 
tanımlayıcısı ’nı (RID) kullanır. Farklı bir çalışma zamanı için barındırma başlangıcını sağlarken, betiğin 
37. satırındaki doğru RID 'yi yerine koyun. StartupDiagnostics çalışma zamanı deposu daha sonra 
derlemenin tüketilebileceği makinede kullanıcının veya sistem çalışma zamanı deposuna taşınır. 
StartupDiagnostics derlemesinin Kullanıcı çalışma zamanı deposu yüklemesi konumu . 
DotNet/Store/x64/netcoreapp 2.2/startupdiagnostics/l.0.0/UB/netcoreapp 2.2/startupdiagnostics. 
dil' d ir. 

• Additionaldeps klasöründeki StartupDiagnostics için additionaiDeps üretir. Ek bağımlılıklar daha 
sonra kullanıcının veya sistem ek bağımlılıklarına taşınır. Kullanıcı StartupDiagnostics ek bağımlılıklar 
yüklemesi konumu . DotNet/x64/additionalDeps/startupdiagnostics/Shared/Microsoft. NETCore. 
App/2.2.0/StartupDiagnostics. Deps. VSO/Volur. 

• Dağıtım klasörüne Deploy. psl dosyasını koyar. 

3. Dağıtım klasöründe Deploy. psl betiğini çalıştırın. Betik şunu ekler: 

• ASPNETCORE_HOSTINGSTARTUPASSEMBLIES Ortam değişkenine StartupDiagnostics . 

• Barındırma başlangıç bağımlılıkları yolu (Runtimessımında projenin dağıtım klasöründe) 
dotnet_additional_deps ortam değişkenine. 

• Çalışma zamanı depolama yolu (Runtimes, projenin dağıtım klasöründe) doti\iet_shared_store ortam 
değişkenine. 

4. Örnek uygulamayı çalıştırın. 

5. istek /Services uygulamanın görmek için uç nokta Hizmetleri kayıtlı, istek /diag tanılama bilgileri görmek 
için uç nokta. 
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ASP.NET Core paylaşılan Framework ( Microsoft.AspNetCore.App ), Microsoft 
tarafından geliştirilen ve desteklenen derlemeler içerir. Microsoft.AspNetCore.App , 
.NET Core 3,0 veya sonraki BİR SDK yüklendiğinde yüklenir. Paylaşılan çerçeve , 
makinede yüklü olan derlemeler (. dil dosyaları) kümesidir ve bir çalışma zamanı 
bileşeni ve hedefleme paketi içerir. Daha fazla bilgi için bkz. paylaşılan çerçeve. 

• Microsoft. NET. Sdk.Web S D K 'yi hedefleyen projeler Microsoft.AspNetCore.App 
çerçeveye dolaylı olarak başvurur. 

Bu projeler için ek başvuru gerekli değildir: 

<Project Sdk="Microsoft.NET.Sdk.Web"> 

<PropertyGroup> 

<TargetFramework>netcoreapp3.0</TargetFramework> 

</PropertyGroup> 

</Project> 

ASP.NET Core paylaşılan çerçeve: 

• Üçüncü taraf bağımlılıklarını içermez. 

• AS P.N ET Core ekibi tarafından desteklenen tüm paketleri içerir. 

Bu özellik, .NET Core 2. x 'i hedefleyen ASP.NET Core 2. x gerektirir. 

ASP.NET Core için Microsoft. AspNetCore. app metapackage : 

• JSON.net, Remotion. LINQve xzaman uyumsuzdışında üçüncü taraf 
bağımlılıklarını içermez. Bu üçüncü taraf bağımlılıklar, ana çerçeveler 
özelliklerinin çalışmasını sağlamak için gereklidir. 

• AS P.N ET Core ekibine, üçüncü taraf bağımlılıklar (daha önce bahsedilen) 
dışında, desteklenen tüm paketleri içerir. 

• Entity Framework Core ekibine, üçüncü taraf bağımlılıklar (daha önce 
bahsedilen) dışında, desteklenen tüm paketleri içerir. 

AS P.N ET Core 2. x ve Entity Framework Core 2. x özelliklerinin tümü 
Microsoft.AspNetCore.App paketedahildir.ASP.NET Core 2.x' i hedefleyen 
varsayılan proje şablonları bu paketi kullanın. AS P.N ET Core 2. x ve Entity 
Framevvork Core 2. x 1 i hedefleyen uygulamaların Microsoft.AspNetCore.App 
paketini kullanması önerilir. 

Microsoft.AspNetCore.App Metapackage sürüm numarası en düşük ASP.NET Core 
sürümü ve Entity Framework Core sürümünü temsil eder. 

Metapackage Microsoft.AspNetCore.App 'in kullanılması, uygulamanızı koruyan 
sürüm kısıtlamalarını sağlar: 

• içindeki Microsoft.AspNetCore.App bir pakette geçişli (doğrudan) bağımlılığı 












olan bir paket varsa ve bu sürüm numaraları farklıysa, NuGet bir hata oluşturur. 

• Uygulamanıza eklenen diğer paketler,' de Microsoft.AspNetcore.App yer alan 
paketlerin sürümünü değiştiremez. 

• Sürüm tutarlılığı, güvenilir bir deneyim sağlar. Microsoft.AspNetcore.App , ilişkili 
bitlerin test edilmemiş sürüm birleşimlerinin aynı uygulamada birlikte 
kullanılmaları önleyecek şekilde tasarlandı. 

Microsoft.AspNetcore.App Metapackage kullanan uygulamalar ASP.NET Core 
paylaşılan çerçeveden otomatik olarak yararlanır. Metapackage kullandığınızda 
başvurulan ASP.NET Core NuGet paketlerinden hiçbir varlık, ASP.NET Core 
paylaşılan Framevvork 'ün bu varlıkları içerdiği uygulamayla—birlikte dağıtılır. 
Microsoft.AspNetcore.App Paylaşılan çerçevede bulunan varlıklar, uygulama 
başlatma süresini artırmak için önceden derlenmiş. Daha fazla bilgi için bkz. 
paylaşılan çerçeve. 

Aşağıdaki proje dosyası ASP.NET Core için Microsoft.AspNetcore.App 
metapackage 'e başvurur ve tipik bir ASP.NET Core 2,2 şablonunu temsil eder: 

<Project Sdk="Microsoft.NET.Sdk.Web"> 

<PropertyGroup> 

<TargetFramework>netcoreapp2.2</TargetFramework> 

</PropertyGroup> 

<ItemGroup> 

<PackageReference Include="Microsoft.AspNetCore.App" /> 

</ItemGroup> 

</Project> 

Yukarıdaki biçimlendirme tipik bir ASP.NET Core 2. x şablonunu temsil eder. 
Microsoft.AspNetcore.App Paket başvurusu için bir sürüm numarası belirtmiyor. 
Sürüm belirtilmediğinde, SDK tarafından örtük bir sürüm belirtilir, diğer bir 
deyişle, Microsoft. net. sdk.ueb . SDK tarafından belirtilen örtük sürüme güvenmek 
ve paket başvurusunda sürüm numarasını açıkça ayarlamamanız önerilir. Bu 
yaklaşım hakkında sorularınız varsa, Microsoft. AspNetCore. app örtük sürümü 
İçin tartışmadabir GitHub yorumu bırakın. 

Örtük sürüm, taşınabilir uygulamalar için majör.minör. 0 olarak ayarlanır. 

Paylaşılan Framevvork toplaması-iletme mekanizması, uygulamayı yüklü paylaşılan 
Çerçeveler arasındaki en son uyumlu sürümde çalıştırır. Geliştirme, test ve 
üretimde aynı sürümün kullanıldığını güvence altına almak için, paylaşılan 
Framevvork 'ün aynı sürümünün tüm ortamlarda yüklü olduğundan emin olun. 
Kendi içindeki uygulamalar için, örtük sürüm numarası yüklü SDK 'da paketlenmiş 
paylaşılan majör.minör.patch çerçevenin öğesine ayarlanır. 

Microsoft.AspNetCore.App Başvuru üzerinde bir sürüm numarası belirtilmesi, 
paylaşılan Çerçeve sürümünün seçilmeyeceği garantisi vermez . Örneğin, "2.2.1" 
sürümünün belirtildiğini, ancak "2.2.3" nin yüklü olduğunu varsayalım. Bu 
durumda, uygulama "2.2.3" kullanacaktır. Önerilmese de, iletmeyi (Patch ve/veya 
Minör) devre dışı bırakabilirsiniz. DotNet ana bilgisayar alma hakkında daha fazla 
bilgi ve davranışını yapılandırma hakkında daha fazla bilgi için bkz. DotNet Flost 
top Forvvard. 

<Project Sdk Örtük sürümü Microsoft.NET.Sdk.Neb Microsoft.AspNetCore.App 













kullanmak için olarak ayarlanmalıdır. Ne <Project sdk="Microsoft.NET.sdk"> 
zaman (sondaki .web olmadan) kullanıldığında: 

• Aşağıdaki uyarı oluşturulur: 

Uyarı NU1604: Proje bağımlılığı Microsoft. AspNetCore. uygulama, 
kapsamlı bir alt sınır içermez. Tutarlı geri yükleme sonuçlarının sağlanması 
için bağımlılık sürümüne bir alt sınır ekleyin. 

• Bu, .NET Core 2,1 SDK ile ilgili bilinen bir sorundur. 

Güncelleştirme ASP.NET Core 

Microsoft.AspNetCore.App Metapackage , NuGet 'den güncelleştirilmiş geleneksel 
bir paket değildir. Benzer şekilde Microsoft.NETCore.App , Microsoft.AspNetCore.App 
NuGet dışında işlenen özel sürüm oluşturma semantiğinin bulunduğu paylaşılan 
bir çalışma zamanını temsil eder. Daha fazla bilgi için bkz. paketler, Metapackages 
ve çerçeveler. 

ASP.NET Core güncelleştirmek için: 

• Geliştirme makinelerinde ve yapı sunucularında: .NET Core SDKİndirin ve 
yükleyin. 

• Dağıtım sunucularında: .NET Core çalışma zamanınıindirin ve yükleyin. 

Uygulamalar, uygulama yeniden başlatıldığında en son yüklenen sürüme ileri 
alınacaktır. Proje dosyasındaki Microsoft.AspNetCore.App sürüm numarasını 
güncelleştirmek gerekli değildir. Daha fazla bilgi için bkz. çerçeveye bağımlı 
uygulamalar ileri alma. 

Uygulamanız daha önce kullanılıyorsa Microsoft.AspNetCore .ah bkz. Microsoft, 
aspnetcore. Ali 'dan Microsoft, aspnetcore. app 'e geçiş. 







ASPNET Core 2,0 için Microsoft. AspNetCore. Ali 
metapackage 

24.09.2019 • 6 minutes to read ı Edit Online 


Microsoft.AspNetCore .ah Metapackage ASP.N ET Core 3,0 ve üzeri bir sürüme dahil değildir.Daha fazla bilgi 
için bu GitHub sorunu. 


NOTE 

ASP.NET Core 2,1 1 i hedefleyen uygulamaların ve daha sonra bu paket yerine Microsoft. AspNetCore. app metapackage 
kullanılmasını öneririz. Bkz. Bu makaledeki Microsoft. AspNetCore. Ali İle Microsoft, aspnetcore. app 'e geçme . 


Bu özellik, .N ET Core 2. x 'i hedefleyen AS P.N ET Core 2. x gerektirir. 

Microsoft. AspNetCore. Ali , paylaşılan bir çerçeveye başvuran bir metapackage. Paylaşılan çerçeve , 
uygulamanın klasörlerinde olmayan derlemelerin (. dil dosyaları) bir kümesidir. Uygulamayı çalıştırmak için 
makinede paylaşılan çerçeve yüklü olmalıdır. Daha fazla bilgi için bkz. paylaşılan çerçeve. 

Öğesine Microsoft.AspNetcore.Aiı başvuran paylaşılan çerçeve şunları içerir: 

• ASP.NET Core ekibi tarafından desteklenen tüm paketler. 

• Entity Framevvork Core tarafından desteklenen tüm paketler. 

• ASP.NET Core ve Entity Framevvork Core tarafından kullanılan dahili ve üçüncü taraf bağımlılıklar. 

ASP.NET Core 2. x ve Entity Framevvork Core 2. x özelliklerinin tümü Microsoft.AspNetcore.Aiı pakete dahildir. 
ASP.NET Core 2,0 ' i hedefleyen varsayılan proje şablonları bu paketi kullanır. 

Microsoft.AspNetcore .ah Metapackage sürüm numarası en düşük ASP.NET Core sürümü ve Entity Framevvork 
Core sürümünü temsil eder. 

Aşağıdaki. csproj dosyası ASP.NET Core Microsoft.AspNetcore.Aiı metapackage'e başvuruyor: 

<Project Sdk="Microsoft. NET. Sdk. I/Jeb" > 

<PropertyGroup> 

<TargetFramework>netcoreapp2.0</TargetFramework> 

</PropertyGroup> 

<ItemGroup> 

<PackageReference Include="Microsoft.AspNetCore.All" Version="2.0.9" /> 

</ItemGroup> 

</Project> 


Örtük sürüm oluşturma 

ASP.NET Core 2,1 veya üzeri sürümlerde Microsoft.AspNetcore.Aiı paket başvurusunu bir sürüm olmadan 
belirtebilirsiniz. Sürüm belirtilmediğinde, SDK ( Microsoft. net. sdk.web ) tarafından örtük bir sürüm belirtilir. 
SDK tarafından belirtilen örtük sürüme güvenmek ve paket başvurusunda sürüm numarasını açıkça 
ayarlamamanız önerilir. Bu yaklaşım hakkında sorularınız varsa, Microsoft. AspNetCore. app örtük sürümü İçin 
tartışmadabir GitHub yorumu bırakın. 












Örtük sürüm, taşınabilir uygulamalar için majör.minör.e olarak ayarlanır. Paylaşılan Framework toplaması- 
iletme mekanizması, uygulamayı yüklü paylaşılan Çerçeveler arasındaki en son uyumlu sürümde çalıştırır. 
Geliştirme, test ve üretimde aynı sürümün kullanıldığını güvence altına almak için, paylaşılan Framevvork 'ün 
aynı sürümünün tüm ortamlarda yüklü olduğundan emin olun. Kendi içindeki uygulamalar için, örtük sürüm 
numarası yüklü SDK 'da paketlenmiş paylaşılan çerçevenin majör.minör.patch öğesine ayarlanır. 

Microsoft.AspNetcore .ah Paket başvurusunda bir sürüm numarası belirtilmesi, paylaşılan Çerçeve sürümünün 
seçili olduğunu garanti etmez . Örneğin, "2.1.1" sürümünün belirtildiğini, ancak "2.1.3" nin yüklü olduğunu 
varsayalım. Bu durumda, uygulama "2.1.3" kullanacaktır.Önerilmese de, iletmeyi (Patch ve/veya Minör) devre 
dışı bırakabilirsiniz. DotNet ana bilgisayar alma hakkında daha fazla bilgi ve davranışını yapılandırma hakkında 
daha fazla bilgi için bkz. DotNet Hoşt top Forvvard. 

Projenin SDK 'sının örtük Microsoft. net. sdk.ueb Microsoft.AspNetcore .ah sürümünü kullanmak için proje 
dosyasında olarak ayarlanması gerekir. SDK belirtildiğinde ( <Project sdk="Microsoft.NET.sdk"> proje dosyasının 
en üstünde), aşağıdaki uyarı oluşturulur: Microsoft. net. sdk 

Uyarı NU1604: Proje bağımlılığı Microsoft. AspNetCore. Ali, kapsamlı bir alt sınır içermez. Tutarlı geri yükleme 
sonuçlarının sağlanması için bağımlılık sürümüne bir alt sınır ekleyin. 

Bu, .NET Core 2,1 SDK ile ilgili bilinen bir sorundur ve .NET Core 2,2 SDK 'sında düzeltilecektir. 

Microsoft. AspNetCore. Ali 'dan Microsoft. AspNetCore. app 'e geçiş 

Aşağıdaki paketler Microsoft.AspNetcore .ah Microsoft.AspNetcore.App paketine dahil değildir ancak pakete 
eklenmez. 

• Microsoft .AspNetcore. Applicationlnsight s .Hoşt ingSt art up 

• Microsoft.AspNetcore.AzureAppServices.HoştingStartup 

• Microsoft.AspNetcore.AzureAppServicesIntegration 

• Microsoft.AspNetcore.DataProtection.AzureKeyVault 

• Microsoft.AspNetcore.DataProtection.AzureStorage 

• Microsoft.AspNetcore.Server.Kestrel.Transport.Libuv 

• Microsoft.AspNetcore.SignalR.Redis 

• Microsoft.Data.Sqlite 

• Microsoft.Data.Sqlite.Core 

• Microsoft.EntityF rameworkCore.Sqlite 

• Microsoft.EntityF rameworkCore.Sqlite.Core 

• Microsoft.Extensions.Caching.Redis 

• Microsoft. Extensions. Configuration .AzureKeyVault 

• Microsoft. Extensions. Logging. AzureAppServices 

• Microsoft.VisualStudio.Web.BrowserLink 

Uygulamanız, yukarıdaki Microsoft.AspNetcore .ah paketlerin Microsoft.AspNetcore.App veya bu paketler 
tarafından getirilen paketlerin herhangi bir API 'sini kullanıyorsa,' dan ' a geçiş yapmak için projenizdeki bu 
paketlere başvurular ekleyin. 

Önceki paketlerin bağımlılığı Microsoft.AspNetcore.App olmayan tüm bağımlılıkları örtük olarak dahil edilmez. 
Örneğin: 

• StackExchange. Redis bağımlılığı olarak Microsoft. Extensions .Caching. Redis 

• Microsoft.Applicationlnsights bağımlılığı olarak Microsoft.AspNetcore.Applicationlnsights.HostingStartup 












Güncelleştirme ASP.NET Core 2,1 

2,1 ve üzeri için Microsoft.AspNetCore.App metapackage 'e geçiş yapmanızı Öneririz. Microsoft.AspNetCore.All 
Metapackage kullanmaya devam etmek ve en son düzeltme eki sürümünün dağıtıldığından emin olmak için: 

• Geliştirme makinelerinde ve yapı sunucularında: En son .NET Core SDKyükler. 

• Dağıtım sunucularında: En son .NET Core çalışma zamanınıyükler. Uygulamanız, uygulama yeniden 
başlatıldığında en son yüklenen sürüme ileri alınacaktır. 




ASRNET Core 'de LoggerMessage ile yüksek 
performanslı günlüğe kaydetme 
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Tarafından Luke Latham 

LoggerMessageözellikler, Loglnformation ve LogDebuggibi günlükçü uzantısı yöntemlerinekıyasla daha az nesne 
ayırma ve daha düşük hesaplama yükü gerektiren önbelleğe alınabilir temsilciler oluşturur. Yüksek performanslı 
günlük senaryoları için, bu LoggerMessage kalıbı kullanın. 

LoggerMessageGünlükçü uzantı yöntemlerine göre aşağıdaki performans avantajlarını sağlar: 

• Günlükçü uzantı yöntemleri int object , gibi "kutulama" (dönüştürme) değer türlerini gerektirir. Bu 
LoggerMessage model, kesin türü belirtilmiş parametrelerle Action statik alanlar ve genişletme yöntemleri 
kullanarak kutulamayı önler. 

• Günlükçü uzantısı yöntemlerinin her bir günlük iletisi yazıldığında ileti şablonunu (biçim dizesi olarak 
adlandırılır) ayrıştırması gerekir. LoggerMessageyalnızca ileti tanımlandığında bir şablonu ayrıştırmayı 
gerektirir. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Örnek uygulama, temel LoggerMessage bir Quote izleme sistemine sahip özellikleri gösterir. Uygulama, bellek içi 
veritabanı kullanarak tırnak ekler ve siler. Bu işlemler gerçekleştiğinde, günlük iletileri LoggerMessage model 
kullanılarak oluşturulur. 

LoggerMessage. define 

Define (LogLevel, Eventl D, String) bir Action iletiyi günlüğe kaydetmek için bir temsilci oluşturur. DefineAşırı 
Yüklemeler, adlandırılmış biçim dizesine (şablon) altı tür parametre geçişine izin verir. 

Define Yöntemine girilen dize, enterpolasyonlu bir dize değil, bir şablondur. Yer tutucular, türlerin belirtilme sırasına 
göre doldurulur. Şablondaki yer tutucu adları, şablonlar genelinde açıklayıcı ve tutarlı olmalıdır. Bunlar, 
yapılandırılmış günlük verileri içinde özellik adı olarak görev yapar. Yer tutucu adları için Pascal büyük harfleri 
öneririz. Örneğin, {Count} {FinstName} ,. 

Her günlük iletisi, Action loggermessage. definetarafından oluşturulan statik bir alanda tutulur. Örneğin, örnek 
uygulama, Dizin sayfası ( iç/LoggerExtensions. cs) İÇİN bir GET isteğinin günlük iletisini tanımlayacak bir alan 
oluşturur: 

private static readonly Action<ILoggerj Exception> _indexPageRequested; 

Actionİçin şunu belirtin: 

• Günlük düzeyi. 

• Statik Uzantı yönteminin adı ileEventldbenzersiz bir olay tanımlayıcısı (). 

• ileti şablonu (biçim dizesi olarak adlandırılır). 

Örnek uygulamanın dizin sayfası için bir istek şunları ayarlar: 

• Günlük düzeyi Information. 

• Yöntemin IndexPageRequested adı ı ile olay kimliği. 








• Bir dizeye ileti şablonu (biçim dizesi olarak adlandırılır). 


indexPageRequested = LoggerMessage.Define( 
LogLevel.Information, 

new Eventld(l, nameof(IndexPageRequested)), 
"GET request for Index page"); 


Yapılandırılmış günlük depoları, olay kimliği ile birlikte verileri zenginleştirmek için sağlandığında olay adını 
kullanabilir. Örneğin, Serilog olay adını kullanır. 

, Action Türü kesin belirlenmiş bir uzantı yöntemiyle çağrılır.Yöntemi indexPageRequested , örnek uygulamada bir 
dizin sayfası get isteği için bir ileti kaydeder: 

public static void IndexPageRequested(this ILogger logger) 

{ 

_indexPageRequested(logger, null); 

} 

indexPageRequested , onGetAsync sayfa/dizin, cshtml. csiçindeki yöntemdeki günlükçü üzerinde çağrılır: 

public async Task OnGetAsync() 

{ 

_logger.IndexPageRequested(); 

Quotes = await _db.Quotes.AsNoTracking().ToListAsync(); 

} 


Uygulamanın konsol çıkışını inceleyin: 

info: LoggerMessageSample.Pages.IndexModel[l] 

=> RequestId:0HL90M6E7PHK4:00000001 RequestPath:/ => /Index 
GET request for Index page 

Parametreleri bir günlük iletisine geçirmek için, statik alanı oluştururken en fazla altı tür tanımlayın. Örnek 
uygulama, string Action alan için bir tür tanımlayarak bir alıntı eklerken bir dizeyi günlüğe kaydeder: 

private static readonly ActioncILogger, string, Exception> _quoteAdded; 

Temsilcinin günlük iletisi şablonu, belirtilen türlerden yer tutucu değerlerini alır. Örnek uygulama, quote 
parametresinin bir string tırnak işareti eklemek için bir temsilci tanımlar: 

_quoteAdded = LoggerMessage.Define<string>( 

LogLevel.Information, 

new Eventld(2, nameof(QuoteAdded)), 

"Quote added (Quote = '{Quote}')"); 

Tırnak QuoteAdded eklemek için statik genişletme yöntemi, quote bağımsız değişkeni değerini alır ve Action 
temsilciye geçirir: 

public static void QuoteAdded(this ILogger logger, string quote) 

{ 

_quoteAdded(logger, quote, null); 

} 











Dizin sayfasının sayfa modelinde ( Sayfalar/lndex. cshtml. cs), QuoteAdded iletiyi günlüğe kaydetmek için çağrılır: 


public async Task<IActionResult> OnPostAddQuoteAsync() 

{ 

_db.Quotes.Add(Quote); 
await _db.SaveChangesAsync(); 

_logger.QuoteAdded(Quote.Text); 

return RedirectToPage(); 

} 


Uygulamanın konsol çıkışını inceleyin: 

info: LoggerMessageSample.Pages.IndexModel[2] 

=> Requestld:0HL90M6E7PHK5:0000000A RequestPath:/ => /Index 
Quote added (Quote = 'You can avoid reality, but you cannot avoid the 
consequences of avoiding reality. - Ayn Rand') 

Örnek uygulama, teklif silme için bir TRY-catch kalıbı uygular. Başarılı silme işlemi için bir bilgilendirici ileti 
günlüğe kaydedilir. Bir özel durum oluştuğunda silme işlemi için bir hata iletisi günlüğe kaydedilir. Başarısız silme 
işleminin günlük iletisi, özel durum yığın izlemesini içerir ( iç/LoggerExtensions. cs): 

private static readonly Action<ILogger, string, int, Exception> _quoteDeleted; 
private static readonly Action<ILogger, int, Exception> _quoteDeleteFailed; 


_quoteDeleted = LoggerMessage.Definecstring, int>( 

LogLevel.Information, 

new Eventld(4, nameof(QuoteDeleted)), 

"Quote deleted (Quote = '{Quote}' Id = {Id})"); 

_quoteDeleteFailed = LoggerMessage.Define<int>( 

LogLevel.Error^ 

new Eventld(5, nameof(QuoteDeleteFailed)), 

"Quote delete failed (Id = {Id})"); 

Özel durumun içindeki QuoteDeieteFaiied temsilciye nasıl geçtiğini aklınızda yapın: 

public static void QuoteDeleted(this ILogger loggerj string quote 3 int id) 

{ 

_quoteDeleted(logger, quote, idj null); 

} 

public static void QuoteDeleteFailed(this ILogger loggerj int idj Exception ex) 

{ 

_quoteDeleteFailed(logger, id, ex); 

} 

Dizin sayfasının sayfa modelinde, başarılı bir teklif silme işlemi günlükçü üzerindeki QuoteDeieted yöntemi çağırır. 
Silinmek üzere bir teklif bulunamadığında, bir ArgumentNullException oluşturulur. Özel durum TRY-catch 
ifadesiyle yakalar ve catch bloğunda ( Pages/lndex. cshtml. cs) günlükçü üzerindeki QuoteDeieteFaiied yöntemi 
çağırarak günlüğe kaydedilir: 










public async Task<IActionResult> OnPostDeleteQuoteAsync(int id) 

{ 

try 

{ 

var quote = await _db.Quotes.FindAsync(id); 

_db.Quotes.Remove(quote); 

await _db.SaveChangesAsync(); 

_logger.QuoteDeleted(quote.Text, id); 

} 

catch (NullReferenceException ex) 

{ 

_logger.QuoteDeleteFailed(id, ex); 

} 

return RedirectToPage(); 

} 


Bir teklif başarıyla silindiğinde, uygulamanın konsol çıkışını inceleyin: 

info: LoggerMessageSample.Pages.IndexModel[4] 

=> RequestId:0HL90M6E7PHK5:00000016 RequestPath:/ => /Index 
Quote deleted (Quote = 'You can avoid reality, but you cannot avoid the 
consequences of avoiding reality. - Ayn Rand' Id = 1) 

Teklif silme başarısız olduğunda, uygulamanın konsol çıkışını inceleyin. Özel durumun günlük iletisine dahil 
edildiğini unutmayın: 

LoggerMessageSample.Pages.IndexModel: Error: Quote delete failed (Id = 999) 

System.NullReferenceException: Object reference not set to an instance of an object. 
at lambda_method(Closure , ValueBuffer ) 

at System.Linq.Enumerable.SelectEnumerablelterator'2.MoveNext() 
at 

Microsoft.EntityFrameworkCore.InMemory.Query.Internal.InMemoryShapedQueryCompilingExpressionVisitor.AsyncQuery 
ingEnumerable'1.AsyncEnumerator.MoveNextAsync() 

at Microsoft.EntityFrameworkCore.Query.ShapedQueryCompilingExpressionVisitor.SingleOrDefaultAsync[TSource] 
(IAsyncEnumerable'1 asyncEnumerable, CancellationToken cancellationToken) 

at Microsoft.EntityFrameworkCore.Query.ShapedQueryCompilingExpressionVisitor.SingleOrDefaultAsync[TSource] 
(IAsyncEnumerable'1 asyncEnumerablej CancellationToken cancellationToken) 

at LoggerMessageSample.Pages.IndexModel.OnPostDeleteQuoteAsync(Int32 id) in 
c: \Users\guard\Documents\GitHub\Docs\aspnetcore\fundamentals\logging\loggermessage\samples\3 .x\LoggerMessageSa 
mple\Pages\Index.cshtml.csrline 77 


LoggerMessage. DefineScope 

DefineScope (String) , Func<TResult> günlük kapsamıtanımlamak için bir temsilci oluşturur. DefineScopeAşırı 
Yüklemeler, adlandırılmış biçim dizesine (şablon) üç tür parametrenin geçirilmesine izin verir. 

Define Yönteminde olduğu gibi, yöntemi DefineScope için girilen dize, ilişkili dize değil, bir şablondur. Yer tutucular, 
türlerin belirtilme sırasına göre doldurulur. Şablondaki yer tutucu adları, şablonlar genelinde açıklayıcı ve tutarlı 
olmalıdır. Bunlar, yapılandırılmış günlük verileri içinde özellik adı olarak görev yapar. Yer tutucu adları için Pascal 
büyük harfleri öneririz. Örneğin, {Count} {FirstName} ,. 

DefineScope Yöntemini kullanarak bir dizi günlük mesajı için uygulanacak günlük kapsamını tanımlayın. 

Örnek uygulamanın, veritabanındaki tüm teklifleri silmek için Tümünü Temizle düğmesi vardır. Tırnak işaretleri 
tek seferde kaldırılarak silinir. Bir teklifin her silindiği QuoteDeieted her seferinde yöntemi günlükçü üzerinde 
çağrılır. Bu günlük iletilerine bir günlük kapsamı eklenir. 





inciudeScopes AppSettings. TSOA/konsol günlükçü bölümünde etkinleştirin: 


{ 

"Logging": { 

"Console": { 

"İnciudeScopes": true 

}, 

"LogLevel": { 

"Default": "Information ", 

"Microsoft": "l/Jarning", 

"Microsoft.Hosting.Lifetime": "Information" 

} 

}, 

"AllowedHosts": 

} 

Bir günlük kapsamı oluşturmak için, kapsam için bir Func<TResult> temsilci tutacak bir alan ekleyin. Örnek 
uygulama ( _aiiQuotesDeietedScope iç/loggerextensions. cs) adlı bir alan oluşturur: 

private static FunccILogger, int, IDisposable> _allQuotesDeletedScope; 

Temsilciyi DefineScope oluşturmak için kullanın. Temsilci çağrıldığında Şablon bağımsız değişkenleri olarak 
kullanmak için en fazla üç tür belirlenebilir. Örnek uygulama, silinen tekliflerin sayısını (bir int tür) içeren bir ileti 
şablonu kullanır: 

_allQuotesDeletedScope = 

LoggerMessage.DefineScope<int>("All quotes deleted (Count = {Count})"); 

Günlük iletisi için bir statik genişletme yöntemi sağlayın, ileti şablonunda görünen adlandırılmış özellikler için 
herhangi bir tür parametresi ekleyin. Örnek uygulama, silmek ve geri count _aiiQuotesDeietedScope döndürmek 
için tırnak içine alır: 

public static IDisposable AllQuotesDeletedScope( 
this ILogger logger, int count) 

{ 

return _allQuotesDeletedScope(logger, count); 

} 

Kapsam, oturum açma uzantısı çağrılarını bir using bloğunda sarmalar: 

public async Task<IActionResult> OnPostDeleteAllQuotesAsync() 

{ 

var quoteCount = await _db.Quotes.CountAsync(); 

using (_logger.AllQuotesDeletedScope(quoteCount)) 

{ 

foreach (Quote quote in _db.Quotes) 

{ 

_db.Quotes.Remove(quote); 

_logger.QuoteDeleted(quote.Text, quote.Id); 

} 

await _db.SaveChangesAsync(); 

} 

return RedirectToPage(); 

} 







Uygulamanın konsol çıkışında günlük iletilerini inceleyin. Aşağıdaki sonuç, günlük kapsamı iletisi dahil olmak üzere 
silinen üç tırnak gösterir: 


info: LoggerMessageSample. Pages. IndexModel[4] 

=> RequestId:0HL90M6E7PHK5:0000002E RequestPath:/ => /Index => 
Ali quotes deleted (Count = 3) 

Quote deleted (Quote = 'Quote 1' Id = 2) 
info: LoggerMessageSample. Pages. IndexModel[4] 

=> RequestId:0HL90M6E7PH<5:0000002E RequestPath:/ => /Index => 
Ali quotes deleted (Count = 3) 

Quote deleted (Quote = 'Quote 2' Id = 3) 
info: LoggerMessageSample.Pages.IndexModel[4] 

=> Requestld:0HL90M6E7PHK5:0000002E RequestPath:/ => /Index => 
Ali quotes deleted (Count = 3) 

Quote deleted (Quote = 'Quote 3' Id = 4) 


LoggerMessageözellikler, Loglnformation ve LogDebuggibi günlükçü uzantısı yöntemlerinekıyasla daha az nesne 
ayırma ve daha düşük hesaplama yükü gerektiren önbelleğe alınabilir temsilciler oluşturur. Yüksek performanslı 
günlük senaryoları için, bu LoggerMessage kalıbı kullanın. 

LoggerMessageGünlükçü uzantı yöntemlerine göre aşağıdaki performans avantajlarını sağlar: 

• Günlükçü uzantı yöntemleri int object , gibi "kutulama" (dönüştürme) değer türlerini gerektirir. Bu 
LoggerMessage model, kesin türü belirtilmiş parametrelerle Action statik alanlar ve genişletme yöntemleri 
kullanarak kutulamayı önler. 

• Günlükçü uzantısı yöntemlerinin her bir günlük iletisi yazıldığında ileti şablonunu (biçim dizesi olarak 
adlandırılır) ayrıştırması gerekir. LoggerMessageyalnızca ileti tanımlandığında bir şablonu ayrıştırmayı 
gerektirir. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Örnek uygulama, temel LoggerMessage bir Quote izleme sistemine sahip özellikleri gösterir. Uygulama, bellek içi 
veritabanı kullanarak tırnak ekler ve siler. Bu işlemler gerçekleştiğinde, günlük iletileri LoggerMessage model 
kullanılarak oluşturulur. 

LoggerMessage. define 

Define (LogLevel, Eventl D, String) bir Action iletiyi günlüğe kaydetmek için bir temsilci oluşturur. DefineAşırı 
Yüklemeler, adlandırılmış biçim dizesine (şablon) altı tür parametre geçişine izin verir. 

Define Yöntemine girilen dize, enterpolasyonlu bir dize değil, bir şablondur.Yer tutucular, türlerin belirtilme sırasına 
göre doldurulur. Şablondaki yer tutucu adları, şablonlar genelinde açıklayıcı ve tutarlı olmalıdır. Bunlar, 
yapılandırılmış günlük verileri içinde özellik adı olarak görev yapar. Yer tutucu adları için Pascal büyük harfleri 
öneririz. Örneğin, {Count} {FirstName} ,. 

Her günlük iletisi, Action loggermessage. definetarafından oluşturulan statik bir alanda tutulur. Örneğin, örnek 
uygulama, Dizin sayfası ( iç/LoggerExtensions. cs ) İÇİN bir GET isteğinin günlük iletisini tanımlayacak bir alan 
oluşturur: 

private static readonly Action<ILogger, Exception> _indexPageRequested; 

Actionİçin şunu belirtin: 

• Günlük düzeyi. 

• Statik Uzantı yönteminin adı ileEventldbenzersiz bir olay tanımlayıcısı (). 

• ileti şablonu (biçim dizesi olarak adlandırılır). 






Örnek uygulamanın dizin sayfası için bir istek şunları ayarlar: 

• Günlük düzeyi Information. 

• Yöntemin IndexPageRequested adı ı ile olay kimliği. 

• Bir dizeye ileti şablonu (biçim dizesi olarak adlandırılır). 


indexPageRequested = LoggerMessage.Define( 
LogLevel.Information, 

new Eventld(l, nameof(IndexPageRequested)), 
"GET request for Index page"); 


Yapılandırılmış günlük depoları, olay kimliği ile birlikte verileri zenginleştirmek için sağlandığında olay adını 
kullanabilir. Örneğin, Serilog olay adını kullanır. 

, Action Türü kesin belirlenmiş bir uzantı yöntemiyle çağrılır. Yöntemi indexPageRequested , örnek uygulamada bir 
dizin sayfası get isteği için bir ileti kaydeder: 

public static void IndexPageRequested(this ILogger logger) 

{ 

_indexPageRequested(logger, null); 

} 

indexPageRequested , onGetAsync sayfa/dizin. cshtml. csiçindeki yöntemdeki günlükçü üzerinde çağrılır: 

public async Task OnGetAsync() 

{ 

_logger.IndexPageRequested(); 

Quotes = await _db.Quotes.AsNoTracking().ToListAsync(); 

} 


Uygulamanın konsol çıkışını inceleyin: 

info: LoggerMessageSample.Pages.IndexModel[l] 

=> RequestId:0HL90M6E7PHK4:00000001 RequestPath:/ => /Index 
GET request for Index page 

Parametreleri bir günlük iletisine geçirmek için, statik alanı oluştururken en fazla altı tür tanımlayın. Örnek 
uygulama, string Action alan için bir tür tanımlayarak bir alıntı eklerken bir dizeyi günlüğe kaydeder: 

private static readonly Action<ILogger, string, Exception> _quoteAdded; 

Temsilcinin günlük iletisi şablonu, belirtilen türlerden yer tutucu değerlerini alır. Örnek uygulama, quote 
parametresinin bir string tırnak işareti eklemek için bir temsilci tanımlar: 

_quoteAdded = LoggerMessage.Define<string>( 

LogLevel.Information, 

new Eventld(2, nameof(QuoteAdded)), 

"Quote added (Quote = '{Quote}')"); 

Tırnak QuoteAdded eklemek için statik genişletme yöntemi, quote bağımsız değişkeni değerini alır ve Action 
temsilciye geçirir: 









public static void QuoteAdded(this ILogger logger, string quote) 

{ 

_quoteAdded(logger, quote, null); 

} 

Dizin sayfasının sayfa modelinde ( Sayfa la r/l ndex. cshtml. cs), QuoteAdded iletiyi günlüğe kaydetmek için çağrılır: 

public async Task<IActionResult> OnPostAddQuoteAsync() 

{ 

_db.Quotes.Add(Quote); 
await _db.SaveChangesAsync(); 

_logger.QuoteAdded(Quote.Text); 

return RedirectToPage(); 

} 


Uygulamanın konsol çıkışını inceleyin: 

info: LoggerMessageSample.Pages.IndexModel[2] 

=> Requestld:0HL90M6E7PHK5:0000000A RequestPath:/ => /Index 
Quote added (Quote = 'You can avoid reality, but you cannot avoid the 
consequences of avoiding reality. - Ayn Rand') 

Örnek uygulama, teklif silme için bir TRY-catch kalıbı uygular. Başarılı silme işlemi için bir bilgilendirici ileti 
günlüğe kaydedilir. Bir özel durum oluştuğunda silme işlemi için bir hata iletisi günlüğe kaydedilir. Başarısız silme 
işleminin günlük iletisi, özel durum yığın izlemesini içerir ( iç/LoggerExtensions. cs): 

private static readonly Action<ILogger, string., int, Exception> _quoteDeleted; 
private static readonly Action<ILogger, int, Exception> _quoteDeleteFailed; 


_quoteDeleted = LoggerMessage.Definecstring, int>( 

LogLevel.Information, 

new Eventld(4, nameof(QuoteDeleted)), 

"Quote deleted (Quote = '{Quote}' Id = {Id})"); 

_quoteDeleteFailed = LoggerMessage.Define<int>( 

LogLevel.Error, 

new Eventld(5, nameof(QuoteDeleteFailed)), 

"Quote delete failed (Id = {Id})"); 

Özel durumun içindeki QuoteDeieteFaiied temsilciye nasıl geçtiğini aklınızda yapın: 

public static void QuoteDeleted(this ILogger logger, string quote, int id) 

{ 

_quoteDeleted(logger, quote, id, null); 

} 

public static void QuoteDeleteFailed(this ILogger logger, int id, Exception ex) 

{ 

_quoteDeleteFailed(logger, id, ex); 

} 

Dizin sayfasının sayfa modelinde, başarılı bir teklif silme işlemi günlükçü üzerindeki QuoteDeieted yöntemi çağırır. 
Silinmek üzere bir teklif bulunamadığında, bir ArgumentNullException oluşturulur. Özel durum TRY-catch 
ifadesiyle yakalar ve catch bloğunda ( Pages/!ndex. cshtml. cs) günlükçü üzerindeki QuoteDeieteFaiied yöntemi 









çağırarak günlüğe kaydedilir: 


public async Task<IActionResult> OnPostDeleteQuoteAsync(int id) 

{ 

var quote = await _db.Quotes.FindAsync(id); 


// DO NOT use this approach in production code! 

// You should check quote to see if it's null before removing 
// it and saving changes to the database. A try-catch is used 
// here for demonstration purposes of LoggerMessage features. 
try 
{ 

_db.Quotes.Remove(quote); 
await _db.SaveChangesAsync(); 


_logger.QuoteDeleted(quote. Text, id); 

} 

catch (ArgumentNullException ex) 

{ 


_logger.QuoteDeleteFailed(id, ex); 

} 


return RedirectToPage(); 

} 


Bir teklif başarıyla silindiğinde, uygulamanın konsol çıkışını inceleyin: 

info: LoggerMessageSample.Pages.IndexModel[4] 

=> RequestId:0HL90M6E7PHK5:00000016 RequestPath:/ => /Index 
Quote deleted (Quote = 'You can avoid reality, but you cannot avoid the 
consequences of avoiding reality. - Ayn Rand' Id = 1) 

Teklif silme başarısız olduğunda, uygulamanın konsol çıkışını inceleyin. Özel durumun günlük iletisine dahil 
edildiğini unutmayın: 

fail: LoggerMessageSample.Pages.IndexModel[5] 

=> RequestId:0HL90M6E7PHK5:00000010 RequestPath:/ => /Index 
Quote delete failed (Id = 999) 

System.ArgumentNullException: Value cannot be null. 

Parameter name: entity 

at Microsoft.EntityFrameworkCore.Utilities.Check.NotNull[T] 

(T value, String parameterName) 

at Microsoft.EntityFrameworkCore.DbContext.Remove[TEntity](TEntity entity) 
at Microsoft.EntityFrameworkCore.Internal.InternalDbSet'1.Remove(TEntity entity) 

at LoggerMessageSample.Pages.IndexModel.<OnPostDeleteQuoteAsync>d_14.MoveNext() 

in <PATFI>\sample\Pages\Index.cshtml.cs:line 87 


LoggerMessage. DefineScope 

DefineScope (String) , Func<TResult> günlük kapsamıtanımlamak için bir temsilci oluşturur. DefineScopeAşırı 
Yüklemeler, adlandırılmış biçim dizesine (şablon) üç tür parametrenin geçirilmesine izin verir. 

Define Yönteminde olduğu gibi, yöntemi DefineScope için girilen dize, ilişkili dize değil, bir şablondur. Yer tutucular, 
türlerin belirtilme sırasına göre doldurulur. Şablondaki yer tutucu adları, şablonlar genelinde açıklayıcı ve tutarlı 
olmalıdır. Bunlar, yapılandırılmış günlük verileri içinde özellik adı olarak görev yapar. Yer tutucu adları için Pascal 
büyük harfleri öneririz. Örneğin, {Count} {FirstName} ,. 

DefineScope Yöntemini kullanarak bir dizi günlük mesajı için uygulanacak günlük kapsamını tanımlayın. 

Örnek uygulamanın, veritabanındaki tüm teklifleri silmek için Tümünü Temizle düğmesi vardır. Tırnak işaretleri 





tek seferde kaldırılarak silinir. Bir teklifin her silindiği QuoteDeieted her seferinde yöntemi günlükçü üzerinde 
çağrılır. Bu günlük iletilerine bir günlük kapsamı eklenir. 

inciudeScopes AppSettings. VSO/Vkonsol günlükçü bölümünde etkinleştirin: 

{ 

"Logging": { 

"Console": { 

"İnciudeScopes": true 

b 

"LogLevel": { 

"Default": "Warning" 

} 

b 

"AllowedHosts": 

} 

Bir günlük kapsamı oluşturmak için, kapsam için bir Func<TResult> temsilci tutacak bir alan ekleyin. Örnek 
uygulama ( _aiiQuotesDeietedScope iç/loggerextensions. cs) adlı bir alan oluşturur: 

private static FunccILogger, int, IDisposable> _allQuotesDeletedScope; 

Temsilciyi DefineScope oluşturmak için kullanın. Temsilci çağrıldığında Şablon bağımsız değişkenleri olarak 
kullanmak için en fazla üç tür belirlenebilir. Örnek uygulama, silinen tekliflerin sayısını (bir int tür) içeren bir ileti 
şablonu kullanır: 

_allQuotesDeletedScope = 

LoggerMessage.DefineScope<int>("All quotes deleted (Count = {Count})"); 

Günlük iletisi için bir statik genişletme yöntemi sağlayın, ileti şablonunda görünen adlandırılmış özellikler için 
herhangi bir tür parametresi ekleyin. Örnek uygulama, silmek ve geri count _aiiQuotesDeietedScope döndürmek 
için tırnak içine alır: 

public static IDisposable AllQuotesDeletedScope( 
this ILogger logger, int count) 

{ 

return _allQuotesDeletedScope(logger, count); 

} 


Kapsam, oturum açma uzantısı çağrılarını bir using bloğunda sarmalar: 








public async Task<IActionResult> OnPostDeleteAllQuotesAsync() 

{ 

var quoteCount = await _db.Quotes.CountAsync(); 

using (_logger.AllQuotesDeletedScope(quoteCount)) 

{ 

foreach (Quote quote in _db.Quotes) 

{ 

_db.Quotes.Remove(quote); 

_logger.QuoteDeleted(quote.Text , quote.Id); 

} 

await _db.SaveChangesAsync(); 

} 

return RedirectToPage(); 

} 


Uygulamanın konsol çıkışında günlük iletilerini inceleyin. Aşağıdaki sonuç, günlük kapsamı iletisi dahil olmak üzere 
silinen üç tırnak gösterir: 

info: LoggerMessageSample.Pages.IndexModel[4] 

=> RequestId:0HL90M6E7PHK5:0000002E RequestPath:/ => /Index => 

Ali quotes deleted (Count = 3) 

Quote deleted (Quote = 'Quote 1' Id = 2) 
info: LoggerMessageSample.Pages.IndexModel[4] 

=> RequestId:0HL90M6E7PHK5:0000002E RequestPath:/ => /Index => 

Ali quotes deleted (Count = 3) 

Quote deleted (Quote = 'Quote 2' Id = 3) 
info: LoggerMessageSample.Pages.IndexModel[4] 

=> RequestId:0HL90M6E7PHK5:0000002E RequestPath:/ => /Index => 

Ali quotes deleted (Count = 3) 

Quote deleted (Quote = 'Quote 3' Id = 4) 


Ek kaynaklar 


• Günlüğe kaydetme 



Dosya İzleyicisi kullanarak ASRNET Core uygulamalar 
geliştirme 
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By Rick Anderson ve Victor Hurdugaci 

DotNet VVatch , kaynak dosyalar değiştiğinde N ET Core CLI komutu çalıştıran bir araçtır. Örneğin, bir dosya 
değişikliği derleme, test yürütmesi veya dağıtımı tetikleyebilir. 

Bu öğretici, iki uç nokta ile mevcut bir Web API 'SI kullanır: bir toplamı ve bir ürünü döndüren bir tane döndürür. 
Ürün yönteminde, bu öğreticide düzeltilen bir hata vardır. 

Örnek uygulamayıindirin. iki projeden oluşur: WebApp (bir ASP.NET Core Web API 'si) ve webapptests (Web API 
'si için birim testleri). 

Bir komut kabuğu 'nda WebApp klasörüne gidin. Şu komutu çalıştırın: 

dotnet run 


NOTE 

Çalıştırmak için bir proje belirtmek üzere dotnet run --project <prodect> kullanabilirsiniz. Örneğin, örnek uygulamanın 
kökünden dotnet run --project webApp çalıştırmak VVebApp projesini de çalıştırır. 


Konsol çıktısı aşağıdakine benzer iletileri gösterir (uygulamanın çalıştığını ve istekleri beklediğini gösterir): 

$ dotnet run 

Hosting environment: Development 

Content root path: C:/Docs/aspnetcore/tutorials/dotnet-watch/sample/WebApp 
Now listening on: http://localhost:5000 
Application started. Press Ctrl+C to shut down. 

Bir Web tarayıcısında http://iocaihost:<port number>/api/math/sum?a=4&b=5 ' a gidin. 9 sonucunu görmeniz gerekir. 

Ürün API'sine gidin ( http://iocaihost:<port number>/api/math/product?a=4&b=5 ). Beklendiğinde 20 değil 9 
döndürür. Bu sorun öğreticide daha sonra düzeltildi. 


Projeye dotnet watch ekleme 

dotnet watch dosya izleyici Aracı, .NET Core SDK sürüm 2.1.300 eklenir..NET Core SDK önceki bir sürümü 
kullanılırken aşağıdaki adımlar gereklidir. 

1. . Csproj dosyasına bir Microsoft.DotNet.watcher.Toois paket başvurusu ekleyin: 

<ItemGroup> 

<DotNetCliToolReference Include="Microsoft.DotNet.Watcher.Tools" Version="2.0.0" /> 

</ItemGroup> 


2. Aşağıdaki komutu çalıştırarak Microsoft.DotNet.uatcher.Tools paketini yüklersiniz: 















dotnet restore 


dotnet watch kullanarak .NET Core CU komutları çalıştırma 

Tüm .NET CoreCLI komutları dotnet watch çalıştırılabilir. Örneğin: 


KOMUT 

İZLE KOMUTU 

dotnet run 

DotNet izleme çalıştırması 

DotNet Run-f netcoreapp 2.0 

DotNet VVatch çalıştırması-f netcoreapp 2.0 

DotNet Run-f netcoreapp 2.0-argl 

DotNet Watch-f netcoreapp 2.0-argl 


dotnet test 


DotNet izleme testi 


WebApp klasöründe dotnet watch run çalıştırın. Konsol çıktısı watch başlatıldığını gösterir. 


NOTE 

izlenecek projeyi belirtmek için dotnet watch --project <pro:ect> kullanabilirsiniz. Örneğin, örnek uygulamanın 
kökünden dotnet watch --project webApp run çalıştırmak Ayrıca VVebApp projesini de çalıştırır ve bu uygulamayı 
izleyebilir. 


dotnet watch değişiklik yap 

dotnet watch çalıştığından emin olun. 

MathController.es Product yöntemindeki hatayı düzeltir, bu nedenle ürünü döndürür ve toplamı değil: 

public static int Product(int a, int b) 

{ 

return a * b; 

} 

Dosyayı kaydedin. Konsol çıktısı, dotnet watch bir dosya değişikliği algıladığını ve uygulamayı yeniden 
başlatıldığını gösterir. 

Verify http://localhost:<port number>/api/math/product?a=4&b=5 doğru sonucu döndürür. 

dotnet watch kullanarak testleri çalıştırma 

1. MathController.es Product yöntemini geri döndürmek için yeniden değiştirin. Dosyayı kaydedin. 

2. Bir komut kabuğunda VVebapptests klasörüne gidin. 

3. DotNet restoreçalıştırın. 

4. dotnet watch test 'i çalıştırın. Çıktısı bir testin başarısız olduğunu ve izleyicinin dosya değişikliklerini 
beklediğini gösterir: 















Total tests: 2. Passed: 1. Failed: 1. Skipped: 0. 

Test Run Failed. 

5. Pnoduct yöntemi kodunu, ürünü geri döndürdüğünden düzeltir. Dosyayı kaydedin, 
dotnet watch dosya değişikliğini algılar ve testleri yeniden çalıştırır. Konsol çıktısı, geçirilen testleri belirtir. 

Dosya listesini izlemek için Özelleştir 

Varsayılan olarak, dotnet-watch aşağıdaki glob desenleriyle eşleşen tüm dosyaları izler: 

• **/*.cs 

• *.csproj 

• **/*.resx 

. Csproj dosyası düzenlenerek, izleme listesine daha fazla öğe eklenebilir. Öğeler tek tek veya glob desenleri 
kullanılarak belirtilebilir. 


<ItemGroup> 

<!-- extends watching group to include *.js fileş --> 

<Watch Include="**\*.js" Exclude="node_modules\**\*;**\*.js.mapjobj\**\*;bin\**\*" /> 
</ItemGroup> 


İzlenen dosyaları kabul etme 

dotnet-watch , varsayılan ayarlarını yoksayacak şekilde yapılandırılabilir. Belirli dosyaları yoksaymak için 
watch="faise" özniteliğini. csproj dosyasındaki bir öğenin tanımına ekleyin: 

<ItemGroup> 

<!-- exclude Generated.es from dotnet-watch --> 

<Compile Include="Generated.cs" Watch="false" /> 

<!-- exclude Strings.resx from dotnet-watch --> 

<EmbeddedResource Include="Strings.resx" Watch="false" /> 

<!-- exclude changes in this referenced project --> 

<ProjectReference Include=". .\ClassLibraryl\ClassLibraryl. csproj" Watch="false" /> 

</ItemGroup> 


Özel izleme projeleri 

dotnet-watch C# projelerle sınırlı değildir.Özel izleme projeleri, farklı senaryoları işlemek için oluşturulabilir. 
Aşağıdaki proje mizanpajını göz önünde bulundurun: 

• sınamanız 

o UnitTests/UnitTests. csproj 
o Integrationtests/mtegratiorıtests. csproj 

Hedef her iki projeyi de seyretmek istiyorsanız, her iki projeyi de izlemek için yapılandırılmış özel bir proje dosyası 
oluşturun: 








<Project> 

<ItemGroup> 

cTestProjects Include="**\*.cspnoj" /> 

<Watch Include="**\*.cs" /> 

</ItemGroup> 

<Target Name="Test"> 

<MSBuild Targets="VSTest" Pnojects="@(TestProjects)" /> 

</Target> 

<Import Pnoject="î(MSBuildExtensionsPath)\Micnosoft.Common.targets" /> 
</Pnoject> 


Her iki projede de dosya izlemeye başlamak için, Test klasörüne geçin. Aşağıdaki komutu yürütün: 


dotnet watch msbuild /t:Test 


VSTest, her iki test projesinde herhangi bir dosya değiştiğinde yürütülür. 


GitHub 'da dotnet-watch 

dotnet-watch GitHub AS PN ET/AspNetCore deposununbir parçasıdır. 








ASRNET Core 'de fabrika tabanlı ara yazılım 
etkinleştirmesi 
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Tarafından Luke Latham 

IMİddlevvareFactory/IMİddlevvare, Ara yazılım etkinleştirme için bir genişletilebilirlik noktasıdır. 

UseMiddlevvarellzantı yöntemleri bir ara yazılımın kayıtlı türünün uygulayıp uygulamadığını 
IMİddlevvaredenetler. Bu durumda, IMİddlevvareFactory kapsayıcıya kaydedilen örnek, kural tabanlı ara yazılım 
etkinleştirme mantığını kullanmak yerine IMİddlevvare , uygulamayı çözmek için kullanılır. Ara yazılım, 
uygulamanın hizmet kapsayıcısında kapsamlı veya geçici bir hizmet olarak kaydedilir. 

Larından 

• İstemci isteği başına etkinleştirme (kapsamlı hizmetler ekleme) 

• Ara yazılım sıkı yazma 

IMİddlevvareistemci isteği başına etkinleştirilir (bağlantı), bu nedenle kapsamlı hizmetler ara yazılım 
oluşturucusuna eklenebilir. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Imıddlivvare 

IMİddlevvareuygulamanın istek ardışık düzeni için ara yazılımı tanımlar. InvokeAsync (FlttpContext, 
reguestdelegate) yöntemi istekleri işler ve ara yazılım yürütmesini Task temsil eden bir döndürür. 


Kurala göre etkinleştirilen ara yazılım: 





public class ConventionalMiddleware 

{ 

private readonly RequestDelegate _next; 

public ConventionalMiddleware(RequestDelegate next) 

{ 

_next = next; 

} 

public async Task InvokeAsync(HttpContext context, AppDbContext db) 

{ 

var keyValue = context.Request.Query["key"]j 

if (!string.IsNullOrWhiteSpace(keyValue)) 

{ 

db.Add(new Request() 

{ 

DT = DateTime.UtcNow, 

MiddlewareActivation = "ConventionalMiddleware ", 
Value = keyValue 

}); 

await db.SaveChangesAsync(); 

} 

await _next(context); 

} 

} 


Etkinleştirilen ara yazılım MiddlevvareFactory: 

public class FactoryActivatedMiddleware : IMiddleware 

{ 

private readonly AppDbContext _db; 

public FactoryActivatedMiddleware(AppDbContext db) 

{ 

_db = db; 

} 

public async Task InvokeAsync(HttpContext contextj RequestDelegate next) 

{ 

var keyValue = context.Request.Query["key"]; 

if (!string.IsNullOrWhiteSpace(keyValue)) 

{ 

_db.Add(new Request() 

{ 

DT = DateTime.UtcNow, 

MiddlewareActivation = "FactoryActivatedMiddleware ", 
Value = keyValue 

}); 

await _db.SaveChangesAsync(); 

} 

await next(context); 

} 

} 


Middlevvares için Uzantılar oluşturulur: 




public static class MiddlewareExtensions 

{ 

public static IApplicationBuilder UseConventionalMiddleware( 
this IApplicationBuilder builder) 

{ 

return builder.UseMiddleware<ConventionalMiddleware>(); 

} 

public static IApplicationBuilder UseFactoryActivatedMiddleware( 
this IApplicationBuilder builder) 

{ 

return builder.UseMiddleware<FactoryActivatedMiddleware>(); 

} 

} 

Nesneleri fabrikada etkinleştirilen bir ara yazılıma UseMiddlevvaregeçirmek mümkün değildir: 

public static IApplicationBuilder UseFactoryActivatedMiddleware( 
this IApplicationBuilder builder, bool option) 

{ 

// Passing 'option' as an argument throws a NotSupportedException at runtime. 
return builder.UseMiddleware<FactoryActivatedMiddleware>(option); 


Fabrikada etkinleştirilen ara yazılım, içindeki startup.configureServices yerleşik kapsayıcıya eklenir 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<AppDbContext>(options => 
options.UseInMemoryDatabase("InMemoryDb")); 

Services.AddTransient<FactoryActivatedMiddleware>(); 

Services.AddRazorPages(); 

} 

Her iki middlevvares de startup.configure istek işleme ardışık düzeninde kaydedilir: 

public void Configure(IApplicationBuilder app, IWebHostEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

} 

app.UseConventionalMiddleware(); 
app.UseFactoryActivatedMiddleware(); 

app.UseStaticFiles(); 
app.UseRouting(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapRazorPages(); 

}); 







IMiddlevvareFactory 

IMİddlevvareFactoryara yazılım oluşturmak için yöntemler sağlar. Ara yazılım Fabrikası Uygulama, kapsayıcıda 
kapsamlı bir hizmet olarak kaydedilir. 

IMiddlevvareFactory VarsayılanMiddlevvareFactoryuygulama, Microsoft, aspnetcore. http paketinde bulunur. 

IMİddlevvareFactory/IMİddlevvare, Ara yazılım etkinleştirme için bir genişletilebilirlik noktasıdır. 

UseMiddlevvareUzantı yöntemleri bir ara yazılımın kayıtlı türünün uygulayıp uygulamadığını 
IMİddlevvaredenetler. Bu durumda, IMiddlevvareFactory kapsayıcıya kaydedilen örnek, kural tabanlı ara yazılım 
etkinleştirme mantığını kullanmak yerine IMİddlevvare , uygulamayı çözmek için kullanılır. Ara yazılım, 
uygulamanın hizmet kapsayıcısında kapsamlı veya geçici bir hizmet olarak kaydedilir. 

Larından 

• istemci isteği başına etkinleştirme (kapsamlı hizmetler ekleme) 

• Ara yazılım sıkı yazma 

IMİddlevvareistemci isteği başına etkinleştirilir (bağlantı), bu nedenle kapsamlı hizmetler ara yazılım 
oluşturucusuna eklenebilir. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Imıddlivvare 

IMİddlevvareuygulamanın istek ardışık düzeni için ara yazılımı tanımlar. InvokeAsync (FlttpContext, 
requestdelegate) yöntemi istekleri işler ve ara yazılım yürütmesini Task temsil eden bir döndürür. 

Kurala göre etkinleştirilen ara yazılım: 

public class ConventionalMiddleware 
{ 

private readonly RequestDelegate _next; 

public ConventionalMiddleware(RequestDelegate next) 

{ 

_next = next; 

} 

public async Task InvokeAsync(HttpContext contextj AppDbContext db) 

{ 

var keyValue = context.Request.Query["key"]; 

if (!string.IsNullOrWhiteSpace(keyValue)) 

{ 

db.Add(new Request() 

{ 

DT = DateTime.UtcNow, 

MiddlewareActivation = "ConventionalMiddleware ", 

Value = keyValue 

}); 

await db.SaveChangesAsync(); 

} 

await _next(context); 

} 

} 


Etkinleştirilen ara yazılım MiddlevvareFactory: 



public class FactoryActivatedMiddleware : IMiddleware 

{ 

private readonly AppDbContext _db; 

public FactoryActivatedMiddleware(AppDbContext db) 

{ 

_db = db; 

} 

public async Task InvokeAsync(HttpContext context, RequestDelegate next) 

{ 

var keyValue = context.Request.Query["key"]; 

if (!string.IsNullOrWhiteSpace(keyValue)) 

{ 

_db.Add(new Request() 

{ 

DT = DateTime.UtcNow, 

MiddlewareActivation = "FactoryActivatedMiddleware", 

Value = keyValue 

}); 

await _db.SaveChangesAsync(); 

} 

await next(context); 

} 

} 

Middlevvares için Uzantılar oluşturulur: 

public static class MiddlewareExtensions 

{ 

public static IApplicationBuilder UseConventionalMiddleware( 
this IApplicationBuilder builder) 

{ 

return builder.UseMiddleware<ConventionalMiddleware>(); 

} 

public static IApplicationBuilder UseFactoryActivatedMiddleware( 
this IApplicationBuilder builder) 

{ 

return builder.UseMiddleware<FactoryActivatedMiddleware>(); 

} 

} 

Nesneleri fabrikada etkinleştirilen bir ara yazılıma UseMiddlevvaregeçirmek mümkün değildir: 

public static IApplicationBuilder UseFactoryActivatedMiddleware( 
this IApplicationBuilder builder, bool option) 

{ 

// Passing 'option' as an argument throws a NotSupportedException at runtime. 
return builder.UseMiddleware<FactoryActivatedMiddleware>(option); 

} 


Fabrikada etkinleştirilen ara yazılım, içindeki startup.configureServices yerleşik kapsayıcıya eklenir 






public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddDbContext<AppDbContext>(options => 
options.UseInMemoryDatabase("InMemoryDb")); 

Services.AddTransient<FactoryActivatedMiddleware>(); 

Services .AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

} 

Her iki middlevvares de startup.configure istek işleme ardışık düzeninde kaydedilir: 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 
app.UseDatabaseErrorPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

} 

app. UseConventionalMiddleware(); 
app.UseFactoryActivatedMiddleware(); 

app.UseStaticFiles(); 
app.UseMvc(); 


IMiddlewareFactory 

IMİddlevvareFactoryara yazılım oluşturmak için yöntemler sağlar. Ara yazılım Fabrikası Uygulama, kapsayıcıda 
kapsamlı bir hizmet olarak kaydedilir. 

IMİddlevvareFactory VarsayılanMiddlevvareFactoryuygulama, Microsoft, aspnetcore. http paketinde bulunur. 

Ek kaynaklar 

• ASP.NET Core ara yazılımı 

• AS P.N ET Core bir üçüncü taraf kapsayıcısı ile ara yazılım etkinleştirme 





ASPNET Core bir üçüncü taraf kapsayıcısı ile ara 
yazılım etkinleştirme 

23.09.2019 • 6 minutes to read ı Edit Online 


Tarafından Luke Latham 

Bu makalede IMİddlevvareFactory , üçüncü taraf kapsayıcı ile IMİddlevvare Ara yazılım etkinleştirme için bir 
genişletilebilirlik noktası ve nasıl kullanılacağı gösterilir. ASP.NET Core 'de fabrika tabanlı ara yazılım 
etkinleştirmesiVe iMiddiewareFactory hakkında iMiddieware giriş bilgileri için bkz. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Örnek uygulama, iMiddiewareFactory simpieinjectorMiddiewareFactory bir uygulama tarafından ara yazılım 
etkinleştirmesini gösterir. Örnek, basit Injector bağımlılık ekleme (dı) kapsayıcısını kullanır. 

Örneğin ara yazılım uygulamasının bir sorgu dizesi parametresi ( key ) tarafından belirtilen değeri kaydeder. Ara 
yazılım, sorgu dizesi değerini bellek içi bir veritabanına kaydetmek için eklenen bir veritabanı bağlamını (kapsamlı 
bir hizmet) kullanır. 


NOTE 

Örnek uygulama, yalnızca tanıtım amacıyla basit Injector kullanır. Basit Injector kullanımı bir onay değildir. Basit Injector 
belgelerinde açıklanan ara yazılım etkinleştirme yaklaşımları ve GitHub sorunları, basit Injector 'ın sürdürülebilir tarafından 
önerilir. Daha fazla bilgi için bkz. basit Injector belgeleri ve basit injecgithub deposu. 


IMİddlevvareFactory 

IMİddlevvareFactoryara yazılım oluşturmak için yöntemler sağlar. 

Örnek uygulamada bir simpieinjectorActivatedMiddieware örnek oluşturmak için bir ara yazılım fabrikası 
uygulanır. Ara yazılım fabrikası, ara yazılımı çözümlemek için basit Injector kapsayıcısını kullanır: 

public class SimpleInjectorMiddlewareFactory : IMiddlewareFactory 
{ 

private readonly Container _container; 

public SimpleInjectorMiddlewareFactory(Containen Container) 

{ 

_container = Container; 

} 

public IMiddleware Create(Type middlewareType) 

{ 

return _container.GetInstance(middlewareType) as IMiddleuıare; 

} 

public void Release(IMiddleware middleware) 

{ 

// The Container is responsible for releasing resources. 

} 

} 










Imıddlivvare 

IMİddlevvareuygulamanın istek ardışık düzeni için ara yazılımı tanımlar. 

Bir iMiddiewareFactory uygulama tarafından etkinleştirilen ara yazılım (Ara yazılım/simpleırıjectoractivcıtedara 
yazdım, cs): 

public class SimpleInjectorActivatedMiddleware : IMiddleware 
{ 

private readonly AppDbContext _db; 

public SimpleInjectorActivatedMiddleware(AppDbContext db) 

{ 

_db = db; 

} 

public async Task InvokeAsync(HttpContext context, RequestDelegate next) 

{ 

var keyValue = context.Request.Query["key"]; 

if (!string.IsNullOrWhiteSpace(keyValue)) 

{ 

_db.Add(new Request() 

{ 

DT = DateTime.UtcNoWj 

MiddlewareActivation = "SimpleInjectorActivatedMiddleware ", 

Value = keyValue 

}); 

await _db.SaveChangesAsync(); 

} 

await next(context); 

} 

} 


Ara yazılım (Ara yazılım/MiddlewareExtensions. cs) için bir uzantı oluşturulur: 

public static class MiddlewareExtensions 
{ 

public static IApplicationBuilder UseSimpleInjectorActivatedMiddleware( 
this IApplicationBuilder builder) 

{ 

return builder.UseMiddleware<SimpleInjectorActivatedMiddleware>(); 

} 

} 

startup.configureServices birkaç görev gerçekleştirmeniz gerekir: 

• Basit Injector kapsayıcısını ayarlayın. 

• Fabrika ve ara yazılımı kaydedin. 

• Uygulamanın veritabanı bağlamını basit ınjtor kapsayıcısından kullanılabilir hale getirin. 




public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRazorPages(); 

// Replace the default middleware factory with the 
// SimpleInjectorMiddlewareFactory. 

Services.AddTransient<IMiddlewareFactory>(_ => 

{ 

return new SimpleInjectorMiddlewareFactory(_container); 

}); 

// Wrap ASP.NET Core requests in a Simple Injector execution 
// context. 

Services.UseSimpleInjectorAspNetRequestScoping(_container); 

// Provide the database context from the Simple 
// Injector Container whenever it's requested from 
// the default service Container. 

Services.AddScoped<AppDbContext>(provider => 

_container.GetInstance<AppDbContext>()); 

_container.Options.DefaultScopedLifestyle = new AsyncScopedLifestyle(); 

_container.Register<AppDbContext>(() => 

{ 

var optionsBuilder = new DbContextOptionsBuilder<DbContext>(); 

optionsBuilder.UseInMemoryDatabase("InMemoryDb"); 

return new AppDbContext(optionsBuilder.Options); 

}, Lifestyle.Scoped); 

_container.Register<SimpleInjectorActivatedMiddleware>(); 

_container.Verify(); 

} 

Ara yazılım, içindeki startup.configure istek işleme ardışık düzenine kaydedilir: 

public void Configure(IApplicationBuilder app, IWebHostEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

} 

app.UseSimplelnjectorActivatedMiddleware(); 

app.UseStaticFiles(); 

app.UseRouting(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapRazorPages(); 

}); 


Bu makalede IMİddlewareFactory , üçüncü taraf kapsayıcı ile IMİddleware Ara yazılım etkinleştirme için bir 
genişletilebilirlik noktası ve nasıl kullanılacağı gösterilir. ASP.NET Core 'de fabrika tabanlı ara yazılım 
etkinleştirmesiVe iMiddiewareFactory hakkında iMiddieware giriş bilgileri için bkz. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 






Örnek uygulama, iMiddiewareFactory simpieinjectorMiddiewareFactory bir uygulama tarafından ara yazılım 
etkinleştirmesini gösterir. Örnek, basit Injector bağımlılık ekleme (dı) kapsayıcısını kullanır. 

Örneğin ara yazılım uygulamasının bir sorgu dizesi parametresi ( key ) tarafından belirtilen değeri kaydeder. Ara 
yazılım, sorgu dizesi değerini bellek içi bir veritabanına kaydetmek için eklenen bir veritabanı bağlamını (kapsamlı 
bir hizmet) kullanır. 


NOTE 

Örnek uygulama, yalnızca tanıtım amacıyla basit Injector kullanır. Basit Injector kullanımı bir onay değildir. Basit Injector 
belgelerinde açıklanan ara yazılım etkinleştirme yaklaşımları ve GitHub sorunları, basit Injector 'ın sürdürülebilir tarafından 
önerilir. Daha fazla bilgi için bkz. basit Injector belgeleri ve basit injecgithub deposu. 


IMiddlevvareFactory 

IMİddlevvareFactoryara yazılım oluşturmak için yöntemler sağlar. 

Örnek uygulamada bir simpieinjectorActivatedMiddieware örnek oluşturmak için bir ara yazılım fabrikası 
uygulanır. Ara yazılım fabrikası, ara yazılımı çözümlemek için basit Injector kapsayıcısını kullanır: 

public class SimpleInjectorMiddlewareFactory : IMiddlewareFactory 
{ 

private readonly Container _container; 

public SimpleInjectorMiddlewareFactory(Container Container) 

{ 

_container = Container; 

} 

public IMiddleware Create(Type middlewareType) 

{ 

return _container.GetInstance(middlewareType) as IMiddleware; 

} 

public void Release(IMiddleware middleware) 

{ 

// The Container is responsible for releasing resources. 

} 

} 


Imıddlivvare 

IMİddlevvareuygulamanın istek ardışık düzeni için ara yazılımı tanımlar. 

Bir iMiddiewareFactory uygulama tarafından etkinleştirilen ara yazılım (Ara yazılım/simpleırıjectoractivatedara 
yazdım, cs): 







public class SimpleInjectorActivatedMiddleware : IMiddleware 

{ 

private readonly AppDbContext _db; 

public SimpleInjectorActivatedMiddleware(AppDbContext db) 

{ 

_db = db; 

} 

public async Task InvokeAsync(HttpContext context, RequestDelegate next) 

{ 

var keyValue = context.Request.Query["key"]; 

if (!string.IsNullOrWhiteSpace(keyValue)) 

{ 

_db.Add(new Request() 

{ 

DT = DateTime.UtcNow, 

MiddlewareActivation = "SimpleInjectorActivatedMiddleware ", 
Value = keyValue 

}); 

await _db.SaveChangesAsync(); 

} 

await next(context); 

} 

} 

Ara yazılım (Ara yazılım/MiddlewareExtenslons. cs) için bir uzantı oluşturulur: 

public static class MiddlewareExtensions 

{ 

public static IApplicationBuilder UseSimpleInjectorActivatedMiddleware( 
this IApplicationBuilder builder) 

{ 

return builder.UseMiddleware<SimpleInjectorActivatedMiddleware>(); 

} 

} 


startup.ConfigureServices birkaç görev gerçekleştirmeniz gerekir: 


• Basit Injector kapsayıcısını ayarlayın. 

• Fabrika ve ara yazılımı kaydedin. 

• Uygulamanın veritabanı bağlamını basit ınjtor kapsayıcısından kullanılabilir hale getirin. 



public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2) 

// Replace the default middleware factory with the 
// SimpleInjectorMiddlewareFactory. 

Services.AddTransient<IMiddlewareFactory>(_ => 

{ 

return new SimpleInjectorMiddlewareFactory(_container); 

}); 

// Wrap ASP.NET Core requests in a Simple Injector execution 
// context. 

Services.UseSimpleInjectorAspNetRequestScoping(_container); 

// Provide the database context from the Simple 
// Injector Container whenever it's requested from 
// the default service Container. 

Services.AddScoped<AppDbContext>(provider => 

_container.GetInstance<AppDbContext>()); 

_container.Options.DefaultScopedLifestyle = new AsyncScopedLifestyle(); 

_container.Register<AppDbContext>(() => 

{ 

var optionsBuilder = new DbContextOptionsBuilder<DbContext>(); 

optionsBuilder.UseInMemoryDatabase("InMemoryDb"); 

return new AppDbContext(optionsBuilder.Options); 

}, Lifestyle.Scoped); 

_container.Register<SimpleInjectorActivatedMiddleware>(); 

_container.Verify(); 

} 

Ara yazılım, içindeki startup.configure istek işleme ardışık düzenine kaydedilir: 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

} 

app.UseSimplelnjectorActivatedMiddleware(); 

app.UseStaticFiles(); 

app.UseMvc(); 

} 


Ek kaynaklar 

• Ara Yazılım 

• Fabrika tabanlı ara yazılım etkinleştirme 

• Basit ınjecgithub deposu 

• Basit Injector belgeleri 





ASPNET Core 3,0 ' den 3,1' e geçiş yapın 
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Scott Ade tarafından 

Bu makalede, mevcut bir ASP.NET Core 3,0 projesinin ASP.NET Core 3,1 1 e nasıl güncelleştirilmesi 
açıklanmaktadır. 

Prerequisites 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• ASP.net ve Web geliştirme iş yüküyle Visual Studio 2019 16,4 veya üzeri 

• ,N ET Core 3,1 SDK veya üzeri 

Global. JSON içinde .NET Core SDK sürümü güncelleştirme 


Belirli bir .NET Core SDK sürümünü hedeflemek için Global bir. JSON dosyasını kullandıysanız, version özelliğini 
yüklü 3,1 SDK sürümüne güncelleştirin. Örneğin: 


{ 

"sdk": { 


- 

"version": ' 

'3.0.101" 

+ 

"version": ' 

'3.1.100" 


> 


} 




Hedef çerçeveyi güncelleştirme 

Proje dosyasında, hedef Framevvork bilinen adını (TFı) netcoreapp3.ı ile güncelleştirin: 

<Project Sdk="Microsoft.NET.Sdk.Web"> 

<PropertyGroup> 

<TargetFramework>netcoreapp3.0</TargetFramework> 

+ <TargetFramework>netcoreapp3.l</TargetFramework> 

</PropertyGroup> 

</Project> 


Paket başvurularını Güncelleştir 

Proje dosyasında, her bir Microsoft.AspNetcore.* paketi başvurusunun version özniteliğini 3.1.0 veya üzeri olarak 
güncelleştirin. Örneğin: 









<ItemGroup> 

<PackageReference Include="Microsoft.AspNetCone.Mvc.Newtonsoft]son" Version="3.0.0" /> 
<PackageReference Include="Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation" Version="3.0.0" 
Condition="'$(Configuration)' == 'Debug'" /> 

+ <PackageRefenence Include="Microsoft.AspNetCone.Mvc.Newtonsoft3son" Version="3.1.0" /> 

+ <PackageRefenence Include="Microsoft.AspNetCore.Mvc.Razor.RuntimeConıpilation" Version="3.1.0" 

Condition="'$(Configuration)' == 'Debug'" /> 

</ItemGroup> 


Docker görüntülerini güncelleştirme 

Docker kullanan uygulamalar için ASP.NET Core 3,1 içeren bir temel görüntü kullanın. Örneğin: 

docker pull mcr.microsoft.com/dotnet/core/aspnet: 3.1 


SameSite tanımlama bilgisi değişikliklerine tepki verme 

HTTP tanımlama bilgilerine yönelik SameSite özniteliği uygulamaları, ASP.NET Core 3,0 ve 3,1 arasında 
değiştirildi. Gerçekleştirilecek eylemler için aşağıdaki kaynaklara bakın: 

• ASP.NET Core 1 de SameSite tanımlama bilgileriyle çalışma 

• ASPNET/Duyurular # 390 

• ASP.NET veASP.NET Core yaklaşan SameSite tanımlama bilgisi değişiklikleri 

Son değişiklikleri gözden geçir 

.NET Core, ASP.NET Core ve 3,1 3, OEntity Framevvork Core arasındaki 3,0-3,1 arasındaki değişiklikleri gözden 
geçirin. 

İsteğe bağlı değişiklikler 

Aşağıdaki değişiklikler isteğe bağlıdır. 

Bileşen etiketi Yardımcısını kullanma 

AS P.N ET Core 3,1 component bir etiket Yardımcısı sunar. Etiket Yardımcısı, bir Blazor projesindeki 
RenderComponentAsync<TComponent> HTML yardımcı yönteminin yerini alabilir.Örneğin: 

- @(await Html.RenderComponentAsync<Counter>(RenderMode.ServerPrerendered, new { IncrementAmount = 10 })) 
+ ccomponent type="typeof(Counter)" render-mode="ServerPrerendered" param-IncrementAmount="10" /> 


Daha fazla bilgi için bkz. bileşenleri Razor Pages ve MVC uygulamalarıyla tümleştirme. 





ASRNET Core 2,2 ' den 3,0 ' e geçiş yapın 

13.12.2019 • 44 minutes to readı Edit Online 


Scott Ade ve Rick Anderson tarafından 

Bu makalede, mevcut bir ASP.NET Core 2,2 projesinin ASP.NET Core 3,0 1 e nasıl güncelleştirilmesi 
açıklanmaktadır. 

Önkoşullar 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• ASP.net ve Web geliştirme iş yüküyle Visual Studio 2019 

• .NET Core 3,0 SDK veya üzeri 

Global. JSON içinde .NET Core SDK sürümü güncelleştirme 


Çözümünüz belirli bir .NET Core SDK sürümünü hedeflemek için Global bir. JSON dosyasını kullanıyorsa, 
version özelliğini makinenizde yüklü 3,0 sürümü olarak güncelleştirin: 


{ 

"sdk": { 



"version": ' 

'3.0.100" 


> 


} 




Proje dosyasını güncelleştirme 

Hedef çerçeveyi güncelleştirme 

ASP.NET Core 3,0 ve üzeri yalnızca .NET Core üzerinde çalışır. Hedef Framevvork bilinen adını (tfd) netcoreapp3.@ 
olarak ayarlayın: 

<Project Sdk="Microsoft.NET.Sdk.Web"> 

<PropertyGroup> 

<TargetFramework>netcoreapp3.0</TargetFramework> 

</PropertyGroup> 

</Project> 

Kullanımdan kaldırılmış paket başvurularını kaldır 

ASP.NET Core 3,0 için çok sayıda NuGet paketi üretilmez. Bu tür paket başvuruları proje dosyasından 
kaldırılmalıdır. ASP.NET Core 2,2 Web uygulaması için aşağıdaki proje dosyasını göz önünde bulundurun: 







<Project Sdk="Microsoft.NET.Sdk.Web"> 

<PropertyGroup> 

<TargetFramework>netcoreapp2.2</Target Frameworl<> 
<AspNetCoreHostingModel>InProcess</AspNetCoreFlostingModel> 

</PropertyGroup> 

<ItemGroup> 

<PackageReference Include="Microsoft.AspNetCore.App"/> 

<PackageReference Include="Microsoft.AspNetCore.Razor.Design" Version="2.2.0" PrivateAssets="All" /> 
</ItemGroup> 

</Project> 


ASP.NET Core 3,0 için güncelleştirilmiş proje dosyası: 

<Project Sdk="Microsoft.NET.Sdk.Web"> 

<PropertyGroup> 

<TargetFramework>netcoreapp3.0</TargetFramework> 

</PropertyGroup> 

</Project> 


Güncelleştirilmiş ASP.NET Core 3,0 proje dosyası: 


• <PropertyGroup> : 

o TFD 'yi netcoreapp3.@ güncelleştirir 

o <AspNetcoreHostingModei> öğesini kaldırır. Daha fazla bilgi için bu belgede İşlem içi barındırma modeli 
konusuna bakın. 

• <ItemGroup> : 

o Microsoft.AspNetCore.App kaldırılır. Daha fazla bilgi için bu belgede Framevvork başvurusu bölümüne 
bakın. 

o Microsoft.AspNetCore.Razor.Design kaldırılır ve aşağıdaki paket listesinde artık üretilmez. 

Artık üretilmeyen paketlerin tam listesini görmek için aşağıdaki Genişlet listesini seçin: 

► Artık üretilmeyen paketlerin listesini genişletmek için tıklayın 

Son değişiklikleri gözden geçir 

Son değişiklikleri gözden geçir 

Framevvork başvurusu 

Yukarıda listelenen paketlerden biri aracılığıyla kullanılabilen ASP.NET Core Özellikleri, 
paylaşılan Framevvork 'ün bir parçası olarak kullanılabilir. Paylaşılan çerçeve , makinede 
dil dosyaları) kümesidir ve bir çalışma zamanı bileşeni ve hedefleme paketi içerir. Daha fazla bilgi için bkz. 

paylaşılan çerçeve. 

• Microsoft. net. sdk. web S D K 'Yı hedefleyen projeler Microsoft.AspNetCore.App çerçevesine örtülü olarak 
başvurur. 

Bu projeler için ek başvuru gerekli değildir: 


Microsoft.AspNetCore.App 
yüklü olan derlemeler (. 













<Project Sdk="Microsoft. NET. Sdk. I/Jeb" > 

<PropertyGroup> 

<TargetFramework>netcoreapp3,0</TargetFramework> 
</PropertyGroup> 

</Project> 



SDK 'yi hedefleyen projeler, Microsoft.AspNetcore.App 


<Project Sdk="Microsoft.NET.Sdk.Razor"> 

<PropertyGroup> 

<TargetFramework>netcoreapp3.0</TargetFramework> 

</PropertyGroup> 

<ItemGroup> 

<FrameworkReference Include="Microsoft.AspNetcore.App" /> 
</ItemGroup> 

</Project> 


Docker kullanan çerçeveye bağımlı yapılar 

ASP.NET Core paylaşılan çerçeveye bağlı bir paket kullanan konsol uygulamalarının çerçeveye bağımlı 
derlemeleri aşağıdaki çalışma zamanı hatasına verebilir: 

It was not possible to find any compatible framework version 

The specified framework 'Microsoft.AspNetcore.App ', version '3.0.0' was not found. 

- No frameworks were found. 

Microsoft.AspNetcore.App , ASP.NET Core çalışma zamanını içeren ve yalnızca DotNet/Core/ASPNET Docker 
görüntüsünde bulunan paylaşılan çerçevedir. 3,0 SDK, paylaşılan çerçevede kullanılabilir olan kitaplıkların 
yinelenen kopyalarını dahil etmez ASP.NET Core kullanan çerçeveye bağımlı derlemelerin boyutunu azaltır. Bu, 18 
MB 'a kadar olası bir tasarruf sağlar, ancak uygulamayı çalıştırmak için ASP.NET Core çalışma zamanının 
mevcut/yüklü olmasını gerektirir. 

ASP.NET Core paylaşılan çerçevede uygulamanın bir bağımlılığı (doğrudan veya dolaylı) olup olmadığını anlamak 
için, uygulamanızın derlemesi/yayımlanması sırasında oluşturulan runtimeconfig. JSON dosyasını inceleyin. 
Aşağıdaki JSON dosyası ASP.NET Core paylaşılan çerçeveye bir bağımlılık gösterir: 

{ 

"runtimeOptions": { 

"tfm": "netcoreapp3.0 ", 

"framework": { 

"name": "Microsoft.AspNetcore.App", 

"version": "3.0.0" 

b 

"configProperties": { 

"System.GC.Server": true 

} 

} 

} 

Uygulamanız Docker kullanıyorsa, AS P.N ET Core 3,0 içeren bir temel görüntü kullanın. Örneğin, 

docker pull mcr.microsoft.com/dotnet/core/aspnet:3.0 . 


Kaldırılan derlemeler için paket başvuruları Ekle 

ASP.NET Core 3,0, daha önce Microsoft.AspNetcore.App paketi başvurusunun parçası olan bazı derlemeleri 









kaldırır. Hangi derlemelerin kaldırıldığını görselleştirmek için, iki paylaşılan çerçeve klasörünü karşılaştırın. 
Örneğin, 2.2.7 ve 3.0.0 sürümlerinin karşılaştırması: 


O 22.7 <--> 3.0.0 - Folder Compare - Beyond Compare 

- □ X 

Session Actions Edit Search View Tools Help 

Newversion available... 

C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App\2.2.7 v | ^ [T] 

E5 

C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App\3.0.0 v|‘ [T] ▼ ▼ 

Name 


Name 

■ aspnetcorev2_inprocess.dll 


■ aspnetcorev2_inprocess.dll a , 

■ Microsoft.AspNetCore.Antiforgery.dll 


■ Microsoft.AspNetCore.Antiforgery.dll 

■ Microsoft.AspNetCore.Authentication.Abstractions.dll 


■ Microsoft.AspNetCore.Authentication.Abstractions.dll 

■ Microsoft.AspNetCore.Authentication.Cookies.dll 


■ Microsoft.AspNetCore.Authentication.Cookies.dll 

■ Microsoft.AspNetCore.Authentication. Core.dll 


■ Microsoft.AspNetCore.Authentication.Core.dll 

■ Microsoft.AspNetCore.Authentication.dll 


■ Microsoft.AspNetCore.Authentication.dll 

■ Microsoft.AspNetCore.Authentication. Facebook.dll 



■ Microsoft.AspNetCore.Authentication.Google.dll 



■ Microsoft.AspNetCore.AuthenticationJwtBearer.dll 



■ Microsoft.AspNetCore.Authentication. MicrosoftAccount.dll 



■ Microsoft.AspNetCore.Authentication.OAuth.dil 


■ Microsoft.AspNetCore.Authentication.OAuth.dil 

■ Microsoft.AspNetCore.Authentication.OpenldConnect.dll 



■ Microsoft.AspNetCore.Authentication.Twitter.dll 



■ Microsoft.AspNetCore.Authentication.WsFederation.dll 



■ Microsoft.AspNetCore.Authorization.dll 


■ Microsoft.AspNetCore.Authorization.dll 

■ Microsoft.AspNetCore.Authorization. Policy.dll 


■ Microsoft.AspNetCore.Authorization.Policy.dll v 

190GBfree on CA 

190 GB free on CA 


Kaldırılan derlemeler tarafından sunulan özellikleri kullanmaya devam etmek için, karşılık gelen paketlerin 3,0 
sürümlerine başvurun: 

• Bireysel kullanıcı hesaplarıyla şablon tarafından oluşturulan bir Web uygulaması aşağıdaki paketleri 
eklemeyi gerektirir: 

<Project Sdk="Microsoft.NET.Sdk.Web"> 

<PropertyGroup> 

<TargetFramework>netcoreapp3,0</TargetFramework> 

<UserSecretsId>My-secret</UserSecretsId> 

</PropertyGroup> 

<ItemGroup> 

<PackageReference Include="Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore" Version="3.0.0" /> 
<PackageReference Include="Microsoft.AspNetCore.Identity.EntityFrameworkCore" Version="3.0.0" /> 
<PackageReference Include="Microsoft.AspNetCore.Identity.UI" Version="3.0.0" /> 

<PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="3.0.0" /> 
<PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="3.0.0" /> 

</ItemGroup> 

</Project> 


• Microsoft. EntityFrameworkCore 

Veritabanı sağlayıcısına özgü pakete başvurma hakkında daha fazla bilgi için bkz. veritabanı sağlayıcıları. 

• Kimlik Kullanıcı arabirimi 

Kimlik Kullanıcı arabirimi desteği, Microsoft. Aspnetcore. Identity. UI paketine başvurarak eklenebilir. 

• SPA Hizmetleri 

o Microsoft. AspNetCore. SpaServices 
o Microsoft. AspNetCore. SpaServices. Extensions 

• Üçüncü taraf kimlik doğrulama akışları için kimlik doğrulama - desteği, NuGet paketleri olarak 
sunulmaktadır: 

o Facebook OAuth (Microsoft. AspNetCore. Authentication. Facebook) 
o Google OAuth (Microsoft. AspNetCore. Authentication. Google) 

o Microsoft hesabı kimlik doğrulaması (Microsoft. AspNetCore. Authentication. MicrosoftAccount) 
o Öpeni D Connect kimlik doğrulaması (Microsoft. AspNetCore. Authentication. Openıdconnect) 
o OpenlD Connect taşıyıcı belirteci (Microsoft. AspNetCore. Authentication. Jwttaşıyıcı) 











o Tvvitter OAuth (Microsoft. AspNetCore. Authentication. Tvvitter) 

o WsFederation kimlik doğrulaması (Microsoft AspNetCore. Authentication. VVsFederation) 

• Microsoft. Aspnet. VVebApi. Client NuGet paketi System.Net.Httpciient - için biçimlendirme ve içerik 
anlaşması desteği, ReadAsAsync ve PostJsonAsync gibi api 'lerle System.Net.HttpClient faydalı 
genişletilebilirlik sağlar. 

• Razor çalışma zamanı derleme - Razor görünümlerinin ve sayfalarının çalışma zamanı derlenmesi desteği 
artık Microsoft. AspNetCore. Mvc. Razor. RuntimeCompilation'un bir parçasıdır. 

• MVC Newtonsoft.Dson destek- Newtonsoft.ison ile MVC kullanma desteği artık Microsoft. AspNetCore. 
Mvc. NevvtonsoftJson' ın bir parçasıdır. 


Başlangıç değişiklikleri 

Aşağıdaki görüntüde AS P.N ET Core 2,2 Razor Pages Web uygulamasında silinen ve değiştirilen çizgiler 
gösterilmektedir: 


Diff - Startup.cs;HEAD vs. Startup.es 

VVebl.csproj Startup.cs 

Webl 

1 Startup.cs;HEAD 

1 |Ş| Miscellaneous Fileş 

VVebl.Startup *1 

S StartupdConfıguratıon configurat 


3 

4 

5 

6 

7 

8 
9 

ıe 

ıı 

12 

13 

14 

15 

İh 

17 

18 
19 
26 
21 
22 

23 

24 

25 

26 

2b 

29 

M 

31 

32 


36 

37 


using Microsoft.AspNetCore.Builder; 
using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.Extensions.Configuration; 
using Microsoft.Extensions.DependencyInjection; 

V///////////////////////////// 


V/. 


Y////////////////Z 


namespace Nebi 
{ 

public class Startup 
{ 

public Startup<IConfiguration configuration) 

Configuration - configuration; 

> 

public IConfiguration Configuration { get; ) 

public void ConfigureServices(IServiceCollection Services) 

Services .AddMv<j().SetConıpatibilityVersion(Co«patibi3ityVersion.Version 2_2) 

} 

public void Configure(IApplication8uilder app, IHostingEnvironment env) 


{ 


if (env.IsOevelopment()) 

{ 

app .UseDeveloperExceptionPage(); 

> 

else 

{ 

app.UseExceptionHandler("/Error"); 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 

app.UseStaticFiles(); 

app.UseMv<J(); 


46 

41 } 


'//////////////// 

///////////////, 

} 

> 


'/////////// 

y/y/^/yy/'. 


///. 


Y//. 


y/A 


y////// 

yy///// 


Önceki görüntüde, silinen kod kırmızı renkte gösterilir.Silinen kod, dosyaları karşılaştırmadan önce silinmiş olan 
tanımlama bilgisi seçenekleri kodunu göstermez. 

Aşağıdaki görüntüde AS P.N ET Core 3,0 Razor Pages Web uygulamasındaki eklenen ve değiştirilen satırlar 
gösterilmektedir: 
















Startup.cs 


T]Web1 

* * 1 » Web1.Startup * | ® StartupOConfıguration coı 


1 

1 using Microsoft.AspNetCore.Builder; 


2 

| using Microsoft.AspNetCore.Hosting; 



y//////////////////////////////////////////////////. 


3 

using Microsoft.Extensions.Configuration; 


4 

using Microsoft.Extensions.Dependencylnjection; 



using Microsoft.Extensions.Hosting; 


6 

7 

namespace uebl 


8 

{ 


9 

public class Startup 


ıe 

< 


11 

public Startup(IConfiguration configuration) 


12 

{ 


13 

Configuration - configuration; 


14 

} 


15 



16 

public IConfiguratior Configuration { get; } 


17 



18 

public void ConfigureServices(IServiceCollection Services) 


19 

f 


20 

Services .|ftddRazorPage^( ) ; 


21 

} 


22 



23 

public void Configure(IApplitdE_app, [î""T7”‘”"üE_r.-ı-d-ı J env) 


24 

t 


25 

if (env. IsDevelopment( )) 


26 

{ 


27 

app .UseOeveloperExceptionPage( ) ; 


28 

} 


29 

else 


30 

{ 


31 

app . UseExceptionHandler("/Error" ) ; 


32 

app.UseHsts(); 


33 

} 


34 




app . UseHttpsRedirection( ); 


36 

app.UseStaticFiles(); 


37 



38 

app .JJseRoutingO ;] 


39 



40 

[app . UseAuthörlzatlon( ) j 


41 



42 

[app. UseEndpoints(endpoints =H 


43 

44 

lif 

[endpoint s. MapRazorPage^( ); 


45 



46 

) 


47 

} 


48 

> 


49 

II 


Önceki görüntüde eklenen kod yeşil renkte gösterilir. Aşağıdaki değişiklikler hakkında bilgi için: 


• 

Services.AddRazorPages''Services.AddMvc , 

bkz. bu belgede MVC hizmeti kaydı . 

• 

CompatibilityVersion 

, bkz. ASP.NET Core MVC için uyumluluk sürümü. 

• 

IWebHostEnvironment'' 

IHostingEnvironment 

, Bu GitHub duyurusunabakın. 

• 

app.useAuthorization 

, sipariş yetkilendirme ara yazılımı 'nın eklenmesi gerektiğini göstermek için şablonlara 


eklenmiştir. Uygulama yetkilendirme kullanmıyorsa, app.useAuthorization çağrısı güvenli bir şekilde 


kaldırılabilir. 

• app.useEndpoints , bkz. bu belgede Razor Pages veya geçişi başlatma, yapılandırma . 

Çözümleyici desteği 

Daha önce Microsoft. AspNetCore. Mvc. çözümleyiciler paketinin bir parçası olarak sevk edilen 
Microsoft. net. sdk.web örtülü başvuru Çözümleyicileri hedefleyen projeler. Bunları etkinleştirmek için ek başvuru 
gerekmez. 

Uygulamanız daha önce Microsoft. AspNetCore. Mvc. API. çözümleyiciler paketini kullanarak sevk edilen API 
Çözümleyicileri kullanıyorsa, .NET Core Web SDK 'sının bir parçası olarak gönderilen çözümleyiciler için proje 
dosyanızı düzenleyin: 



















<Project Sdk="Microsoft.NET.Sdk.Web"> 

<PropertyGroup> 

<TargetFramework>netcoreapp3.0</TargetFramework> 

<IncludeOpenAPIAnalyzers>true</IncludeOpenAPIAnalyzers> 

</PropertyGroup> 

</Project> 


Razor sınıf kitaplığı 


MVC için Kullanıcı arabirimi bileşenleri sağlayan Razor sınıf kitaplığı projelerinin proje dosyasında 
AddRazorSupportForMvc özelliği ayarlaması gerekir: 


<PropertyGroup> 

<AddRazorSupportForMvc>true</AddRazorSupportForMvc> 

</PropertyGroup> 


İşlem içi barındırma modeli 

Projeler varsayılan olarak ASP.NET Core 3,0 veya sonraki sürümlerde işlem içi barındırma modeline göre yapılır. 
Değer inProcess ise proje dosyasındaki <AspNetcoreHostingModei> özelliğini isteğe bağlı olarak kaldırabilirsiniz. 

Kestrel 

Yapılandırma 

Kestrel yapılandırmasını configurewebHostDefauits tarafından belirtilen Web ana bilgisayar oluşturucusuna geçirin 
( program.es ): 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.ConfigureKestrel(serverOptions => 

{ 

// Set properties and cali methods on options 

}) 

.UseStantup<Stantup>(); 

}); 

Uygulama Konağı HostBuiider ile el ile oluşturursa, configurewebHostDefauits 'de Web ana bilgisayar Oluşturucu 
üzerinde useKestnel çağırın: 









public static void Main(string[] args) 

{ 

var hoşt = new HostBuilder() 

.UseContentRoot(Directory.GetCurrentDirectory()) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseKestrel(serverOptions => 

{ 

// Set properties and cali methods on options 

}) 

.UseIISIntegration() 

.UseStartup<Startup>(); 

}) 

.Build(); 

host.Run(); 

} 

Bağlantı ara yazılımı bağlantı bağdaştırıcılarını değiştirir 

Bağlantı bağdaştırıcıları ( Microsoft.AspNetCore.Server.Kestrel.Core.Adapter'.Internal.IConnectionAdapter ) Kestrel 
'den kaldırılmıştır. Bağlantı bağdaştırıcılarını bağlantı ara yazılımı ile değiştirin. Bağlantı ara yazılımı, ASP.NET 
Core işlem hattındaki HTTP ara hattına benzerdir, ancak alt düzey bağlantılar için. HTTPS ve bağlantı günlüğü: 

• Bağlantı bağdaştırıcılarından bağlantı ara yazılıma taşınmıştır. 

• Bu uzantı yöntemleri ASP.NET Core önceki sürümlerinde olduğu gibi çalışır. 

Daha fazla bilgi için Kestrel makalesinin ListenOptions. Protocols bölümünde TIsFilterConnectionHandler 
örneğinebakın. 

Taşıma soyutlamaları taşınır ve herkese açık hale getirilir 

Kestrel aktarım katmanı connections.Abstractions bir ortak arabirim olarak kullanıma sunuldu. Bu 
güncelleştirmelerin bir parçası olarak: 

• Microsoft.AspNetCore.Server.Kestrel.Transport.Abstractions ve ilişkili türler kaldırılmıştır. 

• NoDelay ListenOptions taşıma seçeneklerine taşındı. 

• Microsoft.AspNetCore.Server.Kestrel.Transport.Abstractlons.Internal.SchedulingMode 
Kestrel S erverOptionskaldırı İdi. 

Daha fazla bilgi için aşağıdaki GitHub kaynaklarına bakın: 

• istemci/sunucu ağı soyutlamaları (ASPNET/AspNetCore#10308) 

• Yeni yatak odası dinleyicisi soyutlama ve yeniden Plat Kestrel for top (ASPNET/AspNetCore #10321) 
uygulayın 

Kestrel İstek artbilgisi üst bilgileri 

ASP.NET Core önceki sürümlerini hedefleyen uygulamalar için: 

• Kestrel istek üstbilgileri koleksiyonuna HTTP/1.1 öbekli treyler üstbilgileri ekler. 

• istek gövdesi uca okunduktan sonra Treyi kullanılabilir. 

Bu, üst bilgiler ve tanıtımları arasındaki belirsizlik hakkında bazı kaygılara neden olur, bu nedenle, tanıtımları 3,0 
içinde yeni bir koleksiyona ( RequestTraiierExtensions ) taşınmıştır. 

HTTP/2 istek fragmanları: 

• ASP.NET Core 2,2 1 de kullanılamaz. 

• RequestTraiierExtensions olarak 3,0 'de kullanılabilir. 








Bu treylara erişmek için yeni istek uzantısı yöntemleri vardır. HTTP/1.1 ile olduğu gibi, istek gövdesi sonuna kadar 
okunduktan sonra treylerle erişilebilir. 

3,0 sürümü için aşağıdaki RequestîraiierExtensions yöntemleri kullanılabilir: 

• GetDeciaredîraiiers gövdeden sonra beklenme hakkında bilgi sağlayan istek Trailer üst bilgisini alır. 

• Supportsîraiiers -, isteğin treyler üstbilgilerini almayı destekleyip desteklemediğini gösterir. 

• checkTrailersAvailable -, isteğin treyleri destekleyip desteklemediğini ve okunmaları için kullanılabilir olup 
olmadığını denetler. Bu denetim, okunması gereken tanıtımın olduğunu varsaymaz. Bu yöntem tarafından 

true döndürülse bile okumak için hiçbir treyde bulunmayabilir. 

• GetTrailer -, yanıttan istenen sondaki üstbilgiyi alır. GetTrailer çağrılmadan önce Supportsîraiiers kontrol 
edin veya istek sondaki üstbilgileri desteklemiyorsa bir NotSupportedException meydana gelebilir. 

Daha fazla bilgi için bkz. istek fragmanları ayrı bir koleksiyonda (ASPNET/AspNetCore #10410) yerleştirme. 

AllovvSynchronouslO devre dışı 

AllowSynchronousIO , HttpRequest.Body.Read, HttpResponse.Body.Write ve Stream.Flush gibi zaman uyumlu GÇ API 
'Lerini etkinleştirilir veya devre dışı bırakır. Bu API 'Ler, uygulama kilitlenmelerine neden olan bir iş parçacığı 
kaynağıdır. 3,0 ' de, AiiowSynchronousio varsayılan olarak devre dışıdır. Daha fazla bilgi için Kestrel makalesindeki 
zaman uyumlu GÇ bölümünebakın. 

Zaman uyumlu GÇ gerekliyse, kullanılmakta olan sunucudaki AiiowSynchronousio seçeneği yapılandırılarak 
etkinleştirilebilir configureKestrel (örneğin, Kestrel kullanılıyorsa). Sunucuların (Kestrel, HttpSys, TestServer, vb.) 
tümünün, diğer sunucuları etkilemeyecek AiiowSynchronousio seçeneği olduğunu unutmayın. Zaman uyumlu GÇ, 
iHttpBodyControlFeature.AiiowSynchronousio seçeneği kullanılarak istek temelinde tüm sunucular için 
etkinleştirilebilir: 

var syncIOFeature = HttpContext.Features.Get<IHttpBodyControlFeature>(); 

if (syncIOFeature != null) 

{ 

syncIOFeature.AllowSynchronousIO = true; 

} 

TextWriter uygulamalarla veya Disposeiçinde zaman uyumlu API 'leri çağıran diğer akışlarla ilgili sorun 
yaşıyorsanız, bunun yerine yem DisposeAsync API 'sini çağırın. 

Daha fazla bilgi için, bkz. tüm sunucularda [Duyuru] AllovvSynchronouslO devre dışı (ASPNET/AspNetCore 
#7644). 

Microsoft. AspNetCore. Server. Kestrel. https derlemesi kaldırıldı 

ASP.NET Core 2,1 ' de, Microsoft AspNetCore. Server. Kestrel. https. dil ' nin içeriği Microsoft, aspnetcore. Server. 
Kestrel. Core. dil' ye taşınmıştır. Bu, TypeForwardedTo öznitelikleri kullanan bir kırılmamış güncelleştirmedir. 3,0 için 
boş Microsoft. AspNetCore. Server. Kestrel. https. dil derlemesi ve NuGet paketi kaldırılmıştır. 

Microsoft. AspNetCore. Server. Kestrel. https ' ye başvuran kitaplıklar ASP.NET Core bağımlılıklarını 2,1 veya 
üzeri bir sürüme güncelleştirmemelidir. 

ASP.NET Core 2,1 veya sonraki bir sürümü hedefleyen uygulamalar ve kitaplıklar, Microsoft. AspNetCore. Server. 
Kestrel. https paketine doğrudan başvuruları kaldırmalıdır. 

Json.NET desteği 

ASP.NET Core paylaşılan Framevvork 'ü geliştirmekiçin çalışmanın bir parçası olarak, JSON.netASP.NET Core 
paylaşılan çerçevesinden kaldırılmıştır. 













ASP.NET Core için varsayılan değer artık .NET Core 3,0 ' deyeni olan System. Text. JSON' dır. Mümkün 
olduğunda System.Text.Dson kullanmayı düşünün. Bu yüksek performanstır ve ek bir kitaplık bağımlılığı 
gerektirmez. Ancak System.Text.Json yeni olduğundan, şu anda uygulamanızın ihtiyaç duyacağı özellikleri eksik 
olabilir. 

Uygulama, JsonPatch veya dönüştürücüler gibi Neidtonsoft.ison özgü özellikler kullanıyorsa veya 
Newtonsoft.Dson özgü türleri biçimtürgerekliyse uygulamanız Newtonsoft.3son tümleştirme gerektirebilir. 

Json.NET ASP.NET Core 3,0 SignalR projesinde kullanmak için, bu belgede Nevvtonsoft. JSON öğesine geçme 
bölümüne bakın. 

ASP.NET Core 3,0 projesinde Json.NET kullanmak için: 

• Microsoft. AspNetCore. Mvc. NevvtonsoftJsonöğesine bir paket başvurusu ekleyin. 

• AddNewtonsoft3son çağırmak için Startup.configureServices güncelleştirin. 

Services .AddMvc() 

.AddNewtonsoftDson(); 

AddNewtonsoft3son , yeni MVC hizmeti kayıt yöntemleriyle uyumludur: 


O 

AddRazorPages 


o 

AddControllersWithViews 

o 

AddControllers 



Services.AddControllers() 

.AddNewtonsoftison(); 

AddNewtonsoft3son çağrısında Json.N ET ayarları ayarlanabilir: 

Services. AddMvc() 

.AddNewtonsoftison(options => 

options.SerializerSettings.ContractResolver = 
new CamelCasePropertyNamesContractResolver()); 


MVC hizmeti kaydı 

ASP.NET Core 3,0, MVC senaryolarını Startup.configureServices içine kaydetmek için yeni seçenekler ekler. 

iserviceCollection MVC senaryolarıyla ilgili üç yeni en üst düzey uzantı yöntemi mevcuttur. Şablonlar AddMvc 
yerine bu yeni yöntemleri kullanır. Ancak, AddMvc önceki sürümlerde olduğu gibi davranmaya devam eder. 

Aşağıdaki örnek, denetleyiciler ve API ile ilgili özellikler için destek ekler, ancak görünümler veya sayfalar değildir. 
API şablonu şu kodu kullanır: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddControllers(); 

} 

Aşağıdaki örnek, denetleyiciler, API ile ilgili özellikler ve görünümler için destek ekler, ancak sayfalar için değildir. 
Web uygulaması (MVC) şablonu şu kodu kullanır: 
















public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddControllersWithViews(); 

} 

Aşağıdaki örnek, Razor Pages ve en düşük denetleyici desteği için destek ekler. Web uygulaması şablonu şu kodu 
kullanır: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddRazorPages(); 

} 

Yeni yöntemler de birleştirilebilir.Aşağıdaki örnek, AddMvc ASP.NET Core 2,2 çağırma ile eşdeğerdir: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddControllersWithViews(); 

Services.AddRazorPages(); 

} 


Yönlendirme başlangıç kodu 

Bir uygulama useMvc veya useSignaiR çağırırsa, mümkünse uygulamayı Endpoint Routing 'e geçirin. MVC 'nin 
önceki sürümleriyle Endpoint Routing uyumluluğu geliştirmek için ASP.NET Core 2,2 ' de sunulan URL 
oluşturmayla ilgili bazı değişiklikleri geri çevirdik. 2,2 ' de Endpoint Routing kullanarak sorunlarla karşılaşırsanız, 
aşağıdaki özel durumlarla ASP.NET Core 3,0 1 de iyileştirmeler beklenir: 

• Uygulama iRouter uyguluyor veya Route devralırsa, değiştirme olarak Dynamikro Utevaluestranseski 
kullanın. 

• Uygulama, URL 'Leri ayrıştırmak için MVC 'nin içindeki RouteData.Routers doğrudan erişirse, bunu 

LinkParser.ParsePathByEndpointName kullanımıyla değiştirebilirsiniz. 

• Yolu bir rota adı ile tanımlayın. 

• LinkParser.ParsePathByEndpointName kullanın ve istenen yol adını geçirin. 

Uç nokta yönlendirme aynı yol deseninin söz dizimini ve yol deseninin yazma özelliklerini iRouter olarak 
destekler. Uç nokta yönlendirme iRouteConstraint destekler. Uç nokta yönlendirme [Route] , [HttpGet] ve diğer 
MVC yönlendirme özniteliklerini destekler. 

Çoğu uygulama için yalnızca startup değişiklik yapılmasını gerektirir. 

Geçişi Başlat, yapılandırma 

Genel öneri: 


• useRouting ekleyin. 






















public void Configure(IApplicationBuilder app) 

{ 

app.UseStaticFiles(); 

app.UseRouting(); 

app.UseCors(); 

app.UseAuthentication(); 
app.UseAuthorization(); 

app.UseEndpoints(endpoints = > { 
endpoints.MapControllers(); 

}); 


• useMvc veya useSignaiR useEndpoints ile değiştirin. 


• Uygulama, [EnableCors] gibi CORS senaryoları KULLANIYORSA, CORS'yi kullanan diğer herhangi bir 
ara yazılım (örneğin, useAuthentication , useAuthorization ve UseEndpoints önce useCors yerleştirin) için 
useCons çağrısını yerleştirin. 


• 

IHostingEnvironment 

IWebHostEnvironment 

ile değiştirin ve Microsoft.Extensions.Hosting ad alanı için bir 


using 

açıklaması ekleyin. 



• iAppiication Lif etime I HostApplicationLifetime (Microsoft.Extensions.Hosting ad alanı) ile değiştirin. 

• EnvironmentName Environments (Microsoft.Extensions.Hosting ad alanı) ile değiştirin. 

Aşağıdaki kod, tipik bir ASP.NET Core 2,2 uygulamasındaki startup.configure örneğidir: 

public void Configure(IApplicationBuilder app) 

{ 


app.UseStaticFiles(); 

app.UseAuthentication(); 

app.UseSignalR(hubs => 

{ 

hubs.MapHub<ChatHub>("/chat"); 

}); 

app.UseMvc(noutes => 

{ 

routes.MapRoute("default", "{contnoller'=Flome}/{action=Index}/{id?}"); 

}); 


Önceki startup.configure kodu güncelleştirildikten sonra: 













public void Configure(IApplicationBuilder app) 

{ 

app.UseStaticFiles(); 

app.UseRouting(); 

app. UseCors Q; 

app.UseAuthentication(); 
app.UseAuthorization(); 

app.UseEndpoints(endpoints = > 

{ 

endpoints.MapHub<ChatHub>("/chat"); 

endpoints.MapControllerRoute("default ", "{controller=Home}/{action=Index}/{id?}"); 

}); 

} 


VVARNING 

Çoğu uygulama için useAuthentication , useAuthorization ve useCors çağrıları useRouting yapılan çağrılar arasında 
ve useEndpoints etkin olması gerekir. 


Sistem durumu denetimleri 

Sistem durumu denetimleri, genel ana bilgisayar ile Endpoint Routing kullanır, startup.configure , uç nokta URL 
'SI veya göreli yol ile Endpoint Builder üzerinde MapHealthChecks çağırın: 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapHealthChecks("/health"); 

}); 

Durum denetimleri uç noktaları şunları yapabilir: 

• izin verilen bir veya daha fazla Konakları/bağlantı noktasını belirtin. 

• Yetkilendirme gerektir. 

• CORS gerektir. 

Daha fazla bilgi için bkz. ASP.NET Core durum denetimleri. 

Güvenlik ara yazılımı Kılavuzu 

Yetkilendirme ve CORS desteği, Ara yazılım yaklaşımına göre birleştirilmiştir. Bu, bu senaryolarda aynı ara yazılım 
ve işlevselliğin kullanılmasına izin verir. Bu sürümde güncelleştirilmiş bir yetkilendirme ara yazılımı sunulmaktadır 
ve CORS ara yazılımı, MVC denetleyicileri tarafından kullanılan öznitelikleri anlayabilmesi için geliştirilmiştir. 

CORS 

Daha önce CORS yapılandırması zor olabilir.Ara yazılım bazı kullanım durumlarında kullanılmak üzere sağlandı, 
ancak MVC filtrelerinin diğer kullanım durumlarında ara yazılım olmadan kullanılması amaçlandı. ASP.NET Core 
3,0 ile, CORS gerektiren tüm uygulamaların, uç nokta yönlendirme ile birlikte CORS ara yazılımını kullanması 
önerilir. UseCors , varsayılan ilke ile birlikte sağlanmış olabilir ve [EnableCors] ve [DisableCors] öznitelikleri 
gerektiğinde varsayılan ilkeyi geçersiz kılmak için kullanılabilir. 

Aşağıdaki örnekte: 

• CORS, default ilke adlı tüm uç noktalar için etkinleştirilir. 










MyControiler sınıfı CORS'yi [DisabieCons] özniteliğiyle devre dışı bırakır. 


public void Configure(IApplicationBuilder app) 
{ 


app.UseRouting(); 

app.UseCors("default"); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapDefaultControllerRoute(); 

}); 

} 

[DisableCors] 

public class MyControiler : ControllerBase 
{ 

} 

Authorization 

ASP.NET Core önceki sürümlerinde, yetkilendirme desteği [Authorize] özniteliği aracılığıyla sağlanmış. 
Yetkilendirme ara yazılımı kullanilamiyor.ASP.NET Core 3,0 1 de, yetkilendirme ara yazılımı gereklidir.ASP.NET 
Core yetkilendirmesi ara yazılımını ( useAuthorization ) useAuthentication hemen sonra yerleştirmenizi öneririz. 
Yetkilendirme ara yazılımı, geçersiz kılınabilen varsayılan ilkeyle de yapılandırılabilir. 

ASP.NET Core 3,0 veya sonraki bir sürümde UseAuthorization startup.configure olarak çağrılır ve aşağıdaki 
HomeControiler oturum açmış bir kullanıcı gerektirir: 

public void Configure(IApplicationBuilder app) 

{ 


app.UseRouting(); 

app.UseAuthentication(); 
app.UseAuthorization(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapDefaultControllerRoute(); 

}); 

} 

public class HomeControiler : ControllerBase 
{ 

[Authorize] 

public IActionResult BuyWidgets() 

{ 

} 

} 

Uygulama, MVC 'de Genel filtre olarak bir AuthorizeFilter kullanıyorsa, AddAuthorization çağrısında bir ilke 
sağlamak için kodu yeniden düzenlemeyi öneririz. 

DefauitPoücy başlangıçta kimlik doğrulaması gerektirecek şekilde yapılandırılmıştır, bu nedenle ek yapılandırma 
gerekmez. Aşağıdaki örnekte, MVC uç noktaları, tüm isteklerin DefauitPoücy bağlı olarak yetkilendirilmiş olması 
için RequireAuthorization olarak işaretlenir. Ancak, HomeControiler [AiiowAnonymous] nedeniyle kullanıcı 












uygulamada oturum açmadan erişime izin veriyor: 


public void Configure(IApplicationBuilder app) 

{ 


app.UseRouting(); 

app.UseAuthentication(); 
app.UseAuthorization(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapDefaultControllerRoute().RequireAuthorization(); 

}); 

} 

[AllowAnonymous] 

public class HomeController : ControllerBase 

{ 

} 

ilkeler de özelleştirilebilir.Önceki örneğe derleme sırasında DefaultPolicy , kimlik doğrulaması ve belirli bir 
kapsam gerektirecek şekilde yapılandırılır: 

public void ConfigureServices(IServiceCollection Services) 

{ 


Services.AddAuthorization(options => 

{ 

options.DefaultPolicy = new AuthorizationPolicyBuilder() 
.RequireAuthenticatedUser() 

.Build(); 

}); 

} 

public void Configure(IApplicationBuilder app) 

{ 


app.UseRouting(); 

app.UseAuthentication(); 
app.UseAuthorization(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapDefaultControllerRoute().RequireAuthorization(); 

}); 

} 

[AllowAnonymous] 

public class HomeController : ControllerBase 

{ 

} 

Alternatif olarak, tüm uç noktalar bir FaiibackPolicy yapılandırarak [Authorize] veya RequireAuthorization 
olmadan yetkilendirme gerektirecek şekilde yapılandırılabilir. FaiibackPolicy , DefaultPolicy farklıdır. 


DefaultPolicy 

[Authorize] 

veya 

RequireAuthorization tetiklenir, ancak başka bir ilke ayarlanmamışsa 

FaiibackPolicy 

tetiklenir. 

FaiibackPolicy 

başlangıçta yetkilendirmesiz isteklere izin verecek şekilde 










yapılandırılmıştır. 

Aşağıdaki örnek, önceki DefaultPolicy örnekle aynıdır ancak [AiiowAnonymous] belirtildiğinde hariç tüm uç 
noktalarında her zaman kimlik doğrulaması gerektirmek için FaiibackPolicy kullanır: 

public void ConfigureServices(IServiceCollection Services) 

{ 


Services. AddAuthorization(options => 

{ 

options.FaiibackPolicy = new AuthorizationPolicyBuilder() 
.RequireAuthenticatedUser() 

.Build(); 

}); 

} 

public void Configure(IApplicationBuilder app) 

{ 


app.UseRouting(); 

app.UseAuthentication(); 
app.UseAuthorization(); 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapDefaultControllerRoute(); 

}); 

} 

[AllowAnonymous] 

public class HomeController : ControllerBase 

{ 

} 

Belirli bir yetkilendirme bilgisine sahip olmayan, ara yazılım tarafından yetkilendirme çalışmaktadır.Örneğin, 
sistem durumu denetimlerinde belirli bir yetkilendirme bilgisi yoktur, ancak sistem durumu denetimleri, ara 
yazılım tarafından uygulanan yapılandırılabilir bir yetkilendirme ilkesine sahip olabilir. 

Ayrıca, her uç nokta yetkilendirme gereksinimlerini özelleştirebilir.Aşağıdaki örnekte, DefaultPolicy 
yetkilendirmeyi useAuthorization işler, ancak /healthz durum denetimi uç noktası bir admin Kullanıcı gerektirir: 

public void Configure(IApplicationBuilder app) 

{ 


app.UseRouting(); 

app.UseAuthentication(); 
app.UseAuthorization(); 

app.UseEndpoints(endpoints => 

{ 

endpoints 

.MapHealthChecks("/healthz") 

.RequireAuthorization(new AuthorizeAttribute(){ Roles = "admin", }); 

}); 

} 


Koruma bazı senaryolar için uygulanır. Bir yetkilendirme veya CORS ilkesi eksik ara yazılım nedeniyle atlandıysa 










uç noktalar ara yazılımı bir özel durum oluşturur. Yanlış yapılandırma hakkında ek geribildirim sağlamak için 
çözümleyici desteği devam ediyor. 

Özel yetkilendirme işleyicileri 

Uygulama özel Yetkilendirme işleyicilerikullanıyorsa, uç nokta yönlendirmesi MVC 'den farklı bir kaynak türünü 
işleyicilere geçirir. Yetkilendirme işleyicisi bağlam kaynağının AuthorizationFilterContext türünde olmasını 
bekleyen işleyiciler ( MVC filtreleri tarafından sağlanankaynak türü), RouteEndpoint türündeki kaynakları (uç nokta 
yönlendirmeye göre yetkilendirme işleyicilerine verilen kaynak türü) işlemek için güncelleştirilmeleri gerekir. 

MVC hala AuthorizationFiiterContext kaynaklarını kullandığından, uygulamanın uç nokta yönlendirme 
yetkilendirmesi ile birlikte MVC yetkilendirme filtrelerini kullanması durumunda her iki kaynak türünü de 
yönetmek gerekebilir. 

SignalR 

SignalR hub 1 ların eşlenmesi artık useEndpoints içinde yer alır. 

Her hub 'ı MapHub eşleştirin. Önceki sürümlerde olduğu gibi, her hub açık olarak listelenir. 

Aşağıdaki örnekte chatHub SignalR hub 'ı için destek eklenmiştir: 

public void Configure(IApplicationBuilder app) 

{ 

app.UseRoutingO; 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapHub<ChatHub>(); 

}); 

} 

istemcilerden gelen ileti boyutu sınırlarını denetlemek için yeni bir seçenek vardır.Örneğin, 
Startup.ConfigureServices : 

Services. AddSignalR(hubOptions => 

{ 

hubOptions.MaximumReceiveMessageSize = 32768; 

}); 

ASP.NET Core 2,2 ' de, TransportMaxBufferSize ayarlayabilir ve en büyük ileti boyutunu etkin bir şekilde 
denetleyebilirsiniz. AS P.N ET Core 3,0 ' de, bu seçenek artık yalnızca geri basınç gözlemlenmeyen en büyük 
boyutu denetler. 

MVC denetleyicileri 

Denetleyicilerin eşlemesi artık useEndpoints içinde yer alır. 

Uygulama öznitelik yönlendirme kullanıyorsa MapControiiers ekleyin.Y0nlendirmeASP.NET Core 3,0 veya 
sonraki sürümlerde birçok çerçeve için destek içerdiğinden, öznitelik yönlendirmeli denetleyiciler eklemek kabul 
edilir. 

Şunları değiştirin: 


MapControllerRoute 

MapRoute 


MapAreaControllerRoute 

MapAreaRoute 


Yönlendirme şimdi yalnızca MVC 'den daha fazlasına destek içerdiğinden, bu yöntemlerin ne yapacaklarına açık 
bir şekilde sahip olması için terminoloji değişmiştir. MapControllerRoute / MapAreaControllerRoute / 











MapDefaultcontroiierRoute gibi geleneksel yollar eklendikleri sırayla uygulanır. Önce daha belirli yollar (örneğin, 
bir alana yönelik yollar) yerleştirin. 

Aşağıdaki örnekte: 

• MapControiiers öznitelik yönlendirmeli denetleyiciler için destek ekler. 

• MapAreaControiierRoute bir alanındaki denetleyiciler için geleneksel bir yol ekler. 

• MapControiierRoute , denetleyiciler için geleneksel bir yol ekler. 

public void Configure(IApplicationBuilder app) 

{ 


app.UseRouting(); 

app.UseEndpoints(endpoints = > 

{ 

endpoints.MapControllers(); 
endpoints.MapAreaControllerRoute( 

"admin ", 

"admin", 

”Admin/{controller=Home}/{action=Index}/{id?}"); 
endpoints.MapControllerRoute( 

"default", "{controller=Home}/{action=Index}/{id?}"); 

}); 

} 

Denetleyici eylem adlarından zaman uyumsuz son ek kaldırma 

ASP.NET Core 3,0 1 de, ASP.NET Core MVC Async son ekini denetleyici eylem adlarından kaldırır. Hem 
yönlendirme hem de bağlantı oluşturma, bu yeni varsayılan değerinden etkilenir. Örneğin: 

public class ProductsController : Controllen 

{ 

public async Task<IActionResult> ListAsync() 

{ 

var model = await _dbContext.Products.Tol_istAsync(); 
return View(model); 

} 

} 

ASP.NET Core 3,0 öncesi: 

• Önceki eyleme Ürünler/ListAsync rotası üzerinden erişilebilir. 

• Async sonekini belirten bağlantı oluşturma gerekiyor. Örneğin: 

<a asp-controller="Products" asp-action="ListAsync">List</a> 


ASP.NET Core 3,0: 

• Yukarıdaki eyleme, Ürünler/liste rotasında erişilebilir. 

• Bağlantı oluşturma Async sonekin belirtilmesini gerektirmez. Örneğin: 

<a asp-controller="Products" asp-action="List">List</a> 

Bu değişiklik [ActionName] özniteliği kullanılarak belirtilen adları etkilemez. Varsayılan davranış 
startup.configureServices aşağıdaki kodla devre dışı bırakılabilir: 










Services.AddMvc(options => 

options.SuppressAsyncSuffixInActionNames = false); 

Bağlantı oluşturma değişiklikleri 

Önceki yönlendirme sürümlerindeki farklılıklarhakkında belgelerde açıklandığı gibi, bağlantı oluşturma (örneğin 
url. Link ve benzer API'ler) ile ilgili bazı farklılıklar vardır. Bunlar: 

• Varsayılan olarak, uç nokta yönlendirme kullanılırken, üretilen URI 'Ler içindeki yol parametrelerinin büyük 
küçük harf korunması zorunlu değildir. Bu davranış ıoutboundParameterTransformer arabirimiyle denetlenebilir. 

• Geçersiz bir yol (mevcut olmayan bir denetleyici/eylem veya sayfa) için URI oluşturma, geçersiz bir URI 
oluşturmak yerine Endpoint Routing altında boş bir dize oluşturur. 

• Çevresel değerler (geçerli bağlamdaki rota parametreleri), uç nokta yönlendirme ile bağlantı oluşturmada 
otomatik olarak kullanılmaz. Daha önce, başka bir eyleme (veya sayfaya) bir bağlantı oluştururken, geçerli rota 
ortam değerlerinden belirtilmemiş yol değerleri çıkarsanamıyor. Endpoint Routing kullanılırken, bağlantı 
oluşturma sırasında tüm rota parametreleri açıkça belirtilmelidir. 

Razor Pages 

Eşleme Razor Pages artık useEndpoints içinde yer alır. 

Uygulama Razor Pages kullanıyorsa MapRazorPages ekleyin. Endpoint Routing birçok çerçeve için destek 
içerdiğinden Razor Pages eklemek artık tercih edilir. 

Aşağıdaki startup.configure yönteminde, MapRazorPages Razor Pages için destek ekler: 

public void Configure(IApplicationBuilder app) 

{ 

app.UseRoutingO; 

app.UseEndpoints(endpoints => 

{ 

endpoints.MapRazorPages(); 

}); 

} 

Endpoint Routing olmadan MVC kullanma 

ASP.NET Core 3,0 1 de useMvc veya useMvcwithDefauitRoute aracılığıyla MVC kullanılması 
startup.configureServices içinde açık bir kabul gerektirir. Bu, MVC 'nin başlatma sırasında yetkilendirme ve CORS 
ara yazılımını kullanıp kullanamayacağını bilmeleri gerektiğinden gereklidir. Uygulama desteklenmeyen bir 
yapılandırmayı kullanmayı denerse sizi uyaran bir çözümleyici sağlanır. 

Uygulama eski iRouter destek gerektiriyorsa startup.configureServices aşağıdaki yaklaşımlardan birini 
kullanarak EnableEndpointRouting devre dışı bırakın: 

Services.AddMvc(options => options.EnableEndpointRouting = false); 

Services.AddControllers(options => options.EnableEndpointRouting = false); 

Services.AddControllersWithViews(options => options.EnableEndpointRouting = false); 

















Services.AddRazorPages().AddMvcOptions(options => options.EnableEndpointRouting = false); 

Sistem durumu denetimleri 

Sistem durumu denetimleri, uç nokta yönlendirme özellikli bir yönlendlrici-yazdım olarak kullanılabilir. 


Uç nokta yönlendirme ile sistem durumu denetimlerini kullanmak için MapHealthChecks ekleyin. MapHealthChecks 
yöntemi useHealthchecks benzer bağımsız değişkenleri kabul eder. useHealthChecks üzerinden MapHealthChecks 
kullanmanın avantajı, yetkilendirme uygulayabilir ve eşleşen ilke üzerinde daha ayrıntılı denetime sahip olabilir. 



HostBuilder VVebHostBuilder 'in yerini alır 

ASP.NET Core 3,0 şablonları genel konakkullanır. Önceki sürümler Web ana bilgisayarı kullandı. Aşağıdaki kod, 
Program sınıfı tarafından oluşturulan ASP.NET Core 3,0 şablonunu gösterir: 

// requires using Microsoft.AspNetCore.Hosting; 

// requires using Microsoft.Extensions.Hosting; 

public class Program 
{ 

public static void Main(string[] args) 

{ 

CreateHostBuilder(args).Build().Run(); 

} 

public static IHostBuilder CreateHostBuilder(string[] args) => 

Hoşt.CreateDefaultBuilder(args) 

.ConfigureWebHostDefaults(webBuilder => 

{ 

webBuilder.UseStartup<Startup>(); 

}); 

} 


Aşağıdaki kod, ASP.NET Core 2,2 şablonu tarafından oluşturulan Program sınıfını gösterir: 












public class Program 
{ 

public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build().Run(); 

} 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>(); 

} 

IWebHostBuilder 3,0 ' de kalır ve yukarıdaki kod örneğinde görülen webBuiider türüdür. VVebHostBuilder gelecek 
bir sürümde kullanım dışı bırakılacak ve HostBuiider tarafından değiştirilmeyecektir. 

webHostBuiider HostBuiider olarak en önemli değişiklik, bağımlılık ekleme (dı)içinde. HostBuiider kullanırken, 
aşağıdakileri yalnızca startup oluşturucusuna ekleyebilirsiniz: 

• IConfiguration 

• Microsoft.Extensions.Hosting.IHostEnvironment 

• IVVebHostEnvironment 

HostBuiider dı kısıtlamaları: 

• Dı kapsayıcısının yalnızca bir kez derlenme özelliğini etkinleştirin. 

• Birden çok tekton örneğini çözümlemek gibi ortaya çıkan nesne ömrü sorunlarını önler. 

Daha fazla bilgi için bkz. ASP.NET Core 3 1 te başlangıç hizmeti ekleme İşlemini önleme. 

Addaduthorleştirme farklı bir derlemeye taşındı 

Microsoft. AspNetCore. Authorization. dil' deki AS P.N ET Core 2,2 ve Lovver AddAuthorization yöntemleri: 

• AddAuthorizationCore yeniden adlandırıldı. 

• , Microsoft. AspNetCore. Authorization. Policy. dil' ye taşınmıştır. 

Microsoft, aspnetcore. Authorization. dil ve Microsoft. Aspnetcore. Authorization. Policy. dil' i kullanan 
uygulamalar etkilenmemektedir. 

Microsoft. AspNetCore. Authorization. Policy. dil kullanmayan uygulamalar aşağıdakilerden birini yapmanız 
gerekir: 

• Microsoft. AspNetCore. Authorization. Policy. dllöğe sine bir başvuru ekleyin. Bu yaklaşım çoğu uygulama için 
geçerlidir ve gereklidir. 

• AddAuthorizationCore kullanmaya geç 

Daha fazla bilgi için bkz. AddAuthorization(o => ' de parçalama değişikliği, farklı bir derlemede #386 aşırı yükleme 
yaşar. 

Kimlik Kullanıcı arabirimi 

ASP.NET Core 3,0 için kimlik Kullanıcı Arabirimi güncelleştirmeleri: 

• Microsoft. AspNetCore. Identity. Ulöğesine bir paket başvurusu ekleyin. 

• Razor Pages kullanmayan uygulamalar MapRazorPages çağırmalıdır. Bu belgedeki Razor Pages bakın. 

• Bootstrap 4, varsayılan Ul çerçevesidir. Varsayılan ayarı değiştirmek için bir identityuiFrameworkVersion projesi 
özelliği ayarlayın. Daha fazla bilgi için Bu GitHub duyurusunabakın. 















SignalR 

SignalR JavaScript istemcisi @aspnet/signair @microsoft/signair olarak değiştirilmiştir. Bu değişikliğe tepki 
vermek için Package. JSON fileş, require deyimlerini ve ECMAScript import deyimlerdeki başvuruları 
değiştirin. 

System. Text. JSON varsayılan protokoldür 

system.Text.tson artık hem istemci hem de sunucu tarafından kullanılan varsayılan Hub protokolüdür. 
startup.configuneServices , serileştirici seçeneklerini ayarlamak için AddtsonProtocoi çağırın. 

Server 


Services.AddSignalR(...) 

.AddtsonProtocol(options => 

{ 

options. PayloadSerializerOptions .l/Jritelndented = false; 

}) 

İstemci: 


new HubConnectionBuilder() 

.WithUrl("/chatHub") 

.AddtsonProtocol(options => 

{ 

options.PayloadSerializerOptions.Writelndented = false; 

}) 

.Build(); 


Nevvtonsoft. JSON öğesine geç 


system.Text.tson desteklenmeyen 

Newtonsoft.tson 

özellikler kullanıyorsanız, 

Newtonsoft.tson 


dönebilirsiniz: 

1. Microsoft. AspNetCore.SignalR'i yükler. Protocols. NevvtonsoftJson NuGet paketi. 

2. İstemcisinde, HubConnectionBuiider örneğine AddNewtonsofttsonProtocoi yöntemi çağrısını 
zincirleyebilirsiniz: 

new HubConnectionBuilder() 

.WithUrl("/chatHub") 

.AddNewtonsofttsonProtocol(...) 

.Build(); 

3. Sunucusunda, bir AddNewtonsofttsonProtocol yöntemi çağrısını Startup.ConfigureServices'' AddSignalR 
yöntemi çağrısına zincirleyebilirsiniz: 

Services.AddSignalR() 

.AddNewtonsofttsonProtocol(...); 


Çalışma zamanı derlemesini kabul et 

ASP.NET Core 3,0 1 den önce, görünümlerin çalışma zamanı derlemesi Framevvork 'ün örtük bir özelliğidir. 
Çalışma zamanı derlemesi, görünümlerin derleme zamanı derlemesini tamamlar. Bu, Framevvork 'ün tüm 
uygulamayı yeniden derlemek zorunda kalmadan Razor görünümlerini ve sayfalarını (. cshtml dosyaları) 
derleyebilmesine izin verir. Bu özellik, IDE 'de hızlı bir düzenleme yapma ve değişiklikleri görüntülemek için 




















tarayıcıyı yenileme senaryosunu destekler. 

AS P.N ET Core 3,0 1 de, çalışma zamanı derlemesi bir katılım senaryosudur. Derleme zamanı derlemesi, varsayılan 
olarak etkinleştirilen görünüm derlemesi için tek mekanizmadır. Çalışma zamanı,. cshtml dosyalarında değişiklik 
algıladığında projeyi yeniden derlemek için Visual Studio Code İçinde Visual Studio veya DotNet-VVatch 'u temel 
alır. Visual Studio 'da, çalıştırılan projedeki. cs,. cshtmlveya . Razor dosyalarında yapılan değişiklikler (CTRL + F5), 
ancak hata ayıklaması (F5), projenin yeniden derlenmesi tetiklenemez. 

ASP.NET Core 3,0 projenizde çalışma zamanı derlemesini etkinleştirmek için: 

1. Microsoft. AspNetCore. Mvc. Razor. RuntimeCompilation NuGet paketini yükler. 

2. AddRazorRuntimeCompilation çağırmak için Startup.ConfigureServices güncelleştirin: 

ASP.NET Core MVC için aşağıdaki kodu kullanın: 

Services.AddControllersWithViews() 

.AddRazorRuntimeCompilation(...); 

ASP.NET Core Razor Pages için aşağıdaki kodu kullanın: 

Services.AddRazorPages() 

.AddRazorRuntimeCompilation(...); 


https://github.com/aspnet/samples/tree/master/samples/aspnetcore/mvc/runtimecompilation örnek, geliştirme 
ortamlarında koşullu çalışma zamanı derlemesini olanaklı bir şekilde etkinleştiren bir örnek gösterir. 

Razor dosyası derlemesi hakkında daha fazla bilgi için bkz. ASP.NET Core 'de Razor dosyası derlemesi. 

Çoklu hedefleme aracılığıyla kitaplıkları geçirme 

Kitaplıklar genellikle ASP.NET Core birden çok sürümünü desteklemelidir.Önceki ASP.NET Core sürümlerine 
karşı derlenen kitaplıkların çoğu, sorun olmadan çalışmaya devam etmelidir. Aşağıdaki koşullar uygulamanın 
çapraz derlenmesi için gereklidir: 

• Kitaplık, ikili bir bölme değişikliğiolan bir özelliği kullanır. 

• Kitaplığı ASP.NET Core 3,0 sürümündeki yeni özelliklerden faydalanmak istiyor. 

Örneğin: 

<Project Sdk="Microsoft.NET.Sdk"> 

<PropertyGroup> 

<TargetFrameworks>netcoreapp3.0;netstandard2.0</TargetFrameworks> 

</PropertyGroup> 

dtemGroup Condition="'$(TargetFramework)' == 'netcoreapp3.0'"> 

<FrameworkReference Include="Microsoft.AspNetCore.App" /> 

</ItemGroup> 

<ItemGroup Condition="’$(TargetFramework)' == 'netstandard2.0'"> 

<PackageReference Include="Microsoft.AspNetCore" Version="2.1.0" /> 

</ItemGroup> 

</Project> 


ASP.NET Core 3,0 'e özgü API 'Leri etkinleştirmek için #ifdefs kullanın: 







var webRootFileProvider = 

#if NETCOREAPP3_0 

GetRequiredService<IWebHostEnvironment>().UebRootFileProvider; 
#elif NETSTANDARD2_0 

GetRequiredSenvice<IFIostingEnvironment>() .UebRootFileProvider; 
#else 

#error unknown target framework 
#endif 


Yayımlama 

Proje dizinindeki bin ve obj klasörlerini silin. 

TestServer 

Genel ana bilgisayarile doğrudan TestServer kullanan uygulamalar için, ConfigureVVebHostiçindeki bir 
IVVebHostBuilder TestServer oluşturun: 

[Fact] 

public async Task GenericCreateAndStartHost_GetTestServer() 

{ 

using var hoşt = await new HostBuilder() 

.ConfigureWebHost(webBuilder => 

{ 

webBuilder 

.UseTestServer() 

.Configure(app => { }); 

}) 

.StartAsync(); 

var response = await host.GetTestServer().CreateClient().GetAsync("/"); 

Assert.Equal(HttpStatusCode.NotFound, response.StatusCode); 

} 


API değişiklikleri kesiliyor 

Son değişiklikleri gözden geçir: 

• ASP.NET Core 3,0 sürümündeki son değişikliklerin listesini doldurun 

• Antiforgery, CORS, Diagnostics, MVC ve yönlendirme İÇİNDEKİ API değişiklikleri kesiliyor. Bu liste, 
uyumluluk anahtarlarına yönelik son değişiklikleri içerir. 

• .N ET Core, ASP.NET Core ve Entity Framevvork Core arasında 2,2-3,0 ' e kadar olan değişiklikler hakkında bir 
Özet için bkz. sürüm 2,2 1 den 3,0 1 e geçiş İçin Son değişiklikler. 

Azure App Service .NET Core 3,0 

Azure App Service .N ET Core 'un piyasaya sürülme süreci için App Service Web sitesinde resmi .N ET Core ' a 
bakın. Azure App Service üzerinde .N ET Core 3,0 kullanılabilir olana kadar Azure App Service İçin dağıtım 
AS P.N ET Core önizleme sürümü' nde yer alan yönergeleri izleyin. 





ASPNET Core 2,1' den 2,2 ' e geçiş yapın 
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Scott Ade tarafından 

Bu makalede, mevcut bir ASP.NET Core 2,1 projesinin ASP.NET Core 2,2 1 e nasıl güncelleştirilmesi 
açıklanmaktadır. 

Önkoşullar 

• Visual Studio 

• Visual Studio Code 

• Mac için Visual Studio 

• Visual Studio 2019 ile ASP.NET ve web geliştirme iş yükü 

• .NET core SDK 2.2 veya üzeri 


VVARNING 

Visual Studio 2017 kullanıyorsanız bkz dotnet/SDK'sı sorun #3124 Visual Studio ile çalışmayan .NET Core SDK sürümleri 
hakkında bilgi için. 


Hedef Framevvork bilinen adını güncelleştir (tfd) 

.NET Core 'un hedeflediği projeler, .NET Core 2,2 ' den büyük veya buna eşit bir sürümüntfd 'sini kullanmalıdır. 



.NET Framevvork hedefleyen projeler, .NET Framevvork 4.6.1 daha büyük veya buna eşit bir sürümün TFM 'sini 
kullanmaya devam edebilir: 


<TargetFramework>net461</TargetFramework> 


11S işlem içi barındırma modelini benimseyin 

11S için işlem içi barındırma modelinibenimsemek üzere, <AspNetcoreHostingModei> <PropertyGroup> değerini proje 
dosyasında inProcess öğesine değerine ekleyin: 

<AspNetCoreHostingModel>InProcess</AspNetCoreHostingModel> 

işlem içi barındırma modeli, .NET Framevvork hedefleme ASP.NET Core uygulamalar için desteklenmez. 

Daha fazla bilgi için bkz. ASP.NET Core Modülü. 

Özel Web. config dosyasını güncelleştirme 

Yayımlanan Web. config dosyasını oluşturmak için proje kökünde özel bir Web. config dosyası kullanan projeler 












için: 

• name="aspNetCore" modules AS P.N ET Core modülünü () ekleyen AspNetCoreModule AspNetCoreModuleV2 girişte 
öznitelik değerini olarak değiştirin. <handiers> 

• Öğesinde, barındırma modeli özniteliğini ( hostingModei="inProcess" ) ekleyin. <aspNetcore> 

Daha fazla bilgi ve örnek Web. config dosyaları için bkz AS P.N ET Core Modülü. 

Paket başvurularını Güncelleştir 

.NET Core 'u hedefliyorsanız, proje dosyasındaki metapackage başvurusunun version özniteliğini kaldırın. Bir 
version özniteliğin eklenmesi aşağıdaki uyarıya neden olur: 

A PackageReference to 'Microsoft.AspNetCore.App' specified a Version of '2.2.0'. Specifying the version of this 
package is not recommended. For more information, see https://aka.ms/sdkimplicitrefs 


Daha fazla bilgi için bkz. ASP.NET Core için Microsoft. AspNetCore. app metapackage. 

Metapackage başvurusu aşağıdaki <PackageReference /> düğüme benzemelidir: 

<ItemGroup> 

<PackageReference Include="Microsoft.AspNetCore.App" /> 

</ItemGroup> 

.NET Framevvork hedefliyorsanız, her bir paket başvurusunun version özniteliğini 2.2.0 veya sonraki bir sürüme 
güncelleştirin. Paket başvuruları, tipik bir ASP.NET Core 2,2 projesi hedefleme .NET Framevvork: 

<ItemGroup> 

<PackageReference Include="Microsoft.AspNetCore" Version="2.2.0" /> 

<PackageReference Include="Microsoft.AspNetCore.CookiePolicy" Version="2.2.0" /> 

<PackageReference Include="Microsoft.AspNetCore.HttpsPolicy" Version="2.2.0" /> 

<PackageReference Include="Microsoft.AspNetCore.Mvc" Version="2.2.0" /> 

<PackageReference Include="Microsoft.AspNetCore.StaticFiles" Version="2.2.0" /> 

</ItemGroup> 


Microsoft, aspnetcore. Razor. Design paketine başvuruyorsa, 
güncelleştirin. Bunun yapılmaması için aşağıdaki hata oluşur: 

Version 

özniteliğini 2.2.0 veya üzeri olarak 

Detected package downgrade: Microsoft.AspNetCore.Razor.Design frorr 
directly from the project to select a different version. 

ı 2.2.0 to 2.1.2. Reference the package 


Global. JSON içinde .NET Core SDK sürümü güncelleştirme 

Çözümünüz belirli bir .NET Core SDK sürümünü hedeflemek için Global bir. JSON dosyasını kullanıyorsa, version 
özelliğini makinenizde yüklü 2,2 sürümü olarak güncelleştirin: 


{ 

"sdk": { 

"version": "2.2.100" 

} 

} 


Başlatma ayarlarını Güncelleştir 















Visual Studio Code kullanıyorsanız, projenin başlatma ayarlan dosyasını (. vscode/Launch. JSON) güncelleştirin, 
program Yol, yeni tfd 'ye başvurmalıdır: 

{ 

"version": " 0 . 2 . 0 ", 

"configurations": [ 

{ 

"name": ".NET Core Launch (web)", 

"type": "coreclr", 

"request": "launch", 

"preLaunchTask": "build", 

"program": "${workspaceFolder}/bin/Debug/netcoreapp2.2/test-app.dil", 

"args": [], 

"cwd": "${workspaceFolder}", 

"stopAtEntry": false, 

"internalConsoleOptions": "openOnSessionStart", 

"launchBrowser": { 

"enabled": true, 

"args": ”${auto-detect-url}", 

"windows": { 

"command": "cmd.exe", 

"args": "/C start ${auto-detect-url}" 

L 

"osx": { 

"command": "öpen" 

b 

"linux": { 

"command": "xdg-open" 

} 

b 

"env": { 

"ASPNETCORE_ENVIRONMENT": "Development" 

b 

"sourceFileMap": { 

"/Views": "${workspaceFolder}/Views" 

} 

b 

{ 

"name": ".NET Core Attach", 

"type": "coreclr", 

"request": "attach", 

"processld": "${command:plckProcess}" 

} 

] 

} 


Kestrel yapılandırmasını Güncelleştir 

UseKestrel Uygulama, ConfigureKestrel CreateDefaultBullder UseKestrel AS P.N ET Core Web ana bilgisayarı 
sınıfının createvvebhostbuilder metodunu çağırarak çağrı yaparak 11S ile çakışmalardan kaçınmak için yerine Kestrel 
Server 'ı yapılandırmak için çağırın Program işlem içi barındırma modeli: 

public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 

WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.ConfigureKestrel((context, options) => 

{ 

// Set properties and cali methods on options 

}); 

Uygulama createDefaultBuiider çağırmazsa ve Konağı Program sınıfında el ile oluşturmazsa, çağrılmadan 
ConfigureKestrel önce çağırın: UseKestrel 








public static void Main(string[] args) 

{ 

var hoşt = new WebHostBuilder() 

.UseContentRoot(Directory.GetCurrentDirectory()) 
.UseKestrel() 

.UseIISIntegration() 

.UseStartup<Startup>() 

.ConfigureKestrel((context, options) => 

{ 

// Set properties and cali methods on options 

}) 

.Build(); 

host.Run(); 

} 


Daha fazla bilgi için bkz.ASP.NET Core Web sunucusu uygulamasını Kestrel. 


Uyumluluk sürümünü Güncelleştir 



CORS ilkesini Güncelleştir 

ASP.NET Core 2,2 ' de, bir ilke herhangi bir kaynağa izin veriyorsa ve * kimlik bilgilerine izin veriyorsa, CORS ara 
yazılımı 0 joker noktası ile yanıt verir. Bir joker karakteri ( * ) belirtildiğinde kimlik bilgileri desteklenmez ve 
tarayıcılar CORS isteğine izin vermez, istemcideki sorunu düzeltme seçenekleri de dahil olmak üzere daha fazla 
bilgi için bkz. MDN Web belgeleri. 

Sunucuda bu sorunu gidermek için aşağıdaki eylemlerden birini gerçekleştirin: 

• CORS ilkesini artık kimlik bilgilerine izin verecek şekilde değiştirin. Yani, ilkeyi yapılandırırken çağrısını 

AllovvCredentials kaldırın. 

• CORS isteğinin başarılı olması için kimlik bilgileri gerekliyse, ilkeyi izin verilen Konakları belirtecek şekilde 
değiştirin. Örneğin, kullanmak yerine builder.WithOrigins("https://api. examplel.com", "https://example2.com") 

Al lovvAnyOriginku İlanın. 

Docker görüntülerini güncelleştirme 

Aşağıdaki tabloda Docker Image etiketi değişiklikleri gösterilmektedir: 

2.1 2.2 


microsoft/dotnet:2.1-aspnetcore-runtime 


mcr.microsoft.com/dotnet/core/aspnet:2.2 


microsoft/dotnet:2.1-sdk 


mcr.microsoft.com/dotnet/core/sdk:2.2 


Dockerfile dosyanızdaki satırları,öncekitablonun2,2sütunundakiyeniresimetiketlerinikullanacakşekildedeğiştirin. 

FROM 


11S işlem içi barındırma kullanırken Visual Studio 'da el ile derleme 












Visual Studio 'nun tarayıcı istek deneyiminde otomatik derlemesi , 1 1S işlem içi barındırma modeliyleçalışmaz. 
işlem içi barındırma kullanılırken projeyi el ileyeniden oluşturmanız gerekir.Bu deneyimle ilgili iyileştirmeler, 
gelecekteki bir Visual Studio sürümü için planlanmaktadır. 

Günlük kodunu Güncelleştir 

Önerilen günlük yapılandırma kodu 2,1 ' den 2,2 ' e değişmedi, ancak hala 2,1 ' de çalışılan bazı 1. x kodlama 
desenleri artık 2,2 sürümünde çalışmıyor. 

Uygulamanız startup sınıfında sağlayıcı başlatma, filtreleme ve yapılandırma yüklemeyi günlüğe kaydetmeye 
çalışıyorsa, bu kodu şu şekilde Program.Main taşıyın: 

• Sağlayıcı başlatma: 

1. x örneği: 

public void Configure(IApplicationBuilder app, ILoggerFactory loggerFactory) 

{ 

loggerFactory.AddConsole(); 

} 

2,2 örnek: 


public static void Main(string[] args) 

{ 

var webHost = new WebHostBuilder() 

II ... 

.ConfigureLogging((hostingContextj logging) => 
{ 

logging.AddConsole(); 

}) 

II ... 

} 


• Filtreleme: 

1. x örneği: 

public void Configure(IApplicationBuilder app, ILoggerFactory loggerFactory) 
{ 

loggerFactory.AddConsole(LogLevel.Information); 

// °r 

loggerFactory.AddConsole((category, level) => 

category == "A" || level == LogLevel.Critical); 

} 


2,2 örnek: 







public static void Main(string[] args) 

{ 

var webHost = new WebHostBuilder() 

il ... 

.ConfigureLogging((hostingContext, logging) => 

{ 

logging.AddConsole() 

.AddFilter<ConsoleLoggerProvider> 

(category: null, level: LogLevel.Information) 
// or 

.AddFilter<ConsoleLoggerProvider> 

((category., level) => category == "A" | 
level == LogLevel.Critical) 

)J 

}) 

// ... 

} 


• Yapılandırma yükleniyor: 

1. x örneği: 

public void Configure(IApplicationBuilder app, ILoggerFactory loggerFactory) 

{ 

loggerFactory.AddConsole(Configuration); 

} 

2,2 örnek: 


public static void Main(string[] args) 

{ 

var webHost = new WebHostBuilder() 

ıı ... 

.ConfigureLogging((hostingContext, logging) => 

{ 

logging. AddConfiguration( hoşt ingContext.Configuration.GetSection(" Logging")) 
logging.AddConsole(); 

}) 

II ... 

} 


Daha fazla bilgi için bkz..N ET Core ve AS P.N ET Core oturum açma 

Ek kaynaklar 

• ASP.NET Core MVC için uyumluluk sürümü 

• ASP.NET Core için Microsoft. AspNetCore. app metapackage 

• Örtük paket başvuruları 





ASPNET Core 2.0 için 2.1 geçiş 
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Tarafından RickAnderson 

Bkz: ASP.NET Core 2.1 yenilikler ASP.N ET Core 2.1 'daki yeni özelliklerin genel bakış. 

Bu makalede: 

• Bir ASP.NET Core 2.0 uygulamasını 2.1 için geçiş işleminin temel kavramları kapsar. 

• ASP.NET Core web uygulaması şablonları değişiklikleri genel bir bakış sağlar. 

2.1 değişiklikleri genel bakışını almak için bir hızlı yöntemdir: 

• VVebAppl adlı bir ASP.NET Core 2.0 web uygulaması oluşturun. 

• Bir kaynak denetim sistemi VVebAppl işleyin. 

• VVebAppl silin ve aynı yerde VVebAppl adlı bir ASP.NET Core 2.1 web uygulaması oluşturma. 

• 2.1 sürümü değişiklikleri gözden geçirin. 

Bu makalede, AS P.N ET Core 2.1 için geçiş genel bir bakış sağlar. Bu, 2.1 sürümüne geçirmek için gereken tüm 
değişikliklerin tam listesi içermiyor. Bazı projeler, proje yapılan değişiklikleri ve projeyi oluşturduğunuzda 
seçeneklere bağlı olarak daha fazla adım gerekebilir. 

2.1 sürümleri kullanmak için proje dosyasını güncelleştirme 

Proje dosyasını güncelleştirin: 

• Proje dosyasına güncelleştirerek, .NET Core 2.1 için hedef Framework'ü değiştirmek 

<TargetFramework>netcoreapp2.1</TargetFramework> . 

• Paket başvurusu için değiştirin Microsoft.AspNetCore.All paket başvurusu ile Microsoft.AspNetCore.App . 
Öğesinden kaldırılan bağımlılıkları eklemeniz gerekebilir Microsoft.AspNetCore.All . Daha fazla bilgi için bkz. 
ASP.NET Core 2,0 için Microsoft. AspNetCore. Ali metapackage ve ASP.NET Core için Microsoft. AspNetCore. 
app metapackage. 

• Paket başvurusu "Sürüm" özniteliğini kaldırın Microsoft.AspNetCore.App .Projeleri 

<Project sdk= "Microsoft. net. sdk. web" > sürümü ayarlamanız gerekmez. Sürüm hedef framework tarafından 
örtük ve ASP.N ET Core 2.1 çalışma biçimini en iyi eşleşme için seçilmiş. Daha fazla bilgi için paylaşılan 
framevvork'ü hedefleyen projeler için kuralları bölümü. 

• .N ET Framevvork'ü hedefleyen uygulamalar için her paket başvurusu 2.1 için güncelleştirin. 

• Başvuruları kaldırmak <DotNetCliToolReference> öğeleri şu paketleri. Bu araçlar, varsayılan olarak .NET 
Core CLI paketlenir ve ayrı ayrı yüklenmesi gerekmez. 

o Microsoft.DotNet.VVatcher.Tools ( dotnet watch ) 
o Microsoft.EntityFramevvorkCore.Tools.DotNet ( dotnet ef ) 
o Microsoft.Extensions.Caching.SqlConfig.Tools ( dotnet sqi-cache ) 
o Microsoft.Extensions.SecretManager.Tools ( dotnet user-secrets ) 

• isteğe bağlı: kaldırdığınız <DotNetCliToolReference> öğesi için 

Microsoft.visuaistudio.web.codeGeneration.Tools . Bu araç çalıştırarak genel olarak yüklenen bir sürümle 
değiştirebilirsiniz dotnet tool install -g dotnet-aspnet-codegenerator . 

• 2.1, bir Razor sınıf kitaplığı Razor dosyaları dağıtmak için önerilen çözümdür. Uygulamanızı katıştırılmış 
görünümleri kullanıyorsa ya da aksi takdirde üzerinde Razor dosyaları çalışma zamanı derlemesi kullanır 











ekleme <CopyRefAssembliesToPublishDirectory>true</CopyRefAssembliesToPublishDirectory> için bir 
<PropertyGroup> proje dosyanızda. 

Şablonu oluşturulan 2.0 proje dosyası aşağıdaki biçimlendirme gösterilmektedir: 

<Project Sdk="Microsoft.NET.Sdk.Web"> 

<PropertyGroup> 

<TargetFramework>netcoreapp2.0</TargetFramework> 

<UserSecretsId>aspnet-{Project Name}-{GUID}</UserSecretsId> 

</PropertyGroup> 

<ItemGroup> 

<PackageReference Include="Microsoft.AspNetCore.All" Version="2.0.9" /> 

<PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="2.0.3" PrivateAssets="All" /> 
<PackageReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Design" Version="2.0.4" 
PrivateAssets="All" /> 

</ItemGroup> 

<ItemGroup> 

<DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools.DotNet" Version="2.0.3" /> 
<DotNetCliToolReference Include="Microsoft.Extensions.SecretManager.Tools" Version="2.0.2" /> 
<DotNetCliToolReference Include="Microsoft.VisualStudio.Ueb.CodeGeneration.Tools" Version="2.0.4" /> 
</ItemGroup> 

</Project> 


Şablonu oluşturulan 2.1 proje dosyası aşağıdaki biçimlendirme gösterilmektedir: 

<Project Sdk="Microsoft.NET.Sdk.Web"> 

<PropertyGroup> 

<TargetFramework>netcoreapp2.1</TargetFramework> 

<UserSecretsId>aspnet-{Project Name}-{GUID}</UserSecretsld> 

</PropertyGroup> 

<ItemGroup> 

<PackageReference Include="Microsoft.AspNetCore.App" /> 

<PackageReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Design" Version="2.1.1" 
PrivateAssets="All" /> 

</ItemGroup> 

</Project> 


Paylaşılan framework'ü hedefleyen projeler için kurallar 

A paylaşılan çerçeve derlemeleri kümesidir (.dil dosyaları) uygulamanın klasörlerinde olmayan. Paylaşılan 
framevvork uygulamasını çalıştırmak için makinede yüklü olmalıdır. Daha fazla bilgi için paylaşılan çerçeve. 

ASP.NET Core 2.1 aşağıdaki paylaşılan çerçevelerini içerir: 

• Microsoft.AspNetCore.App 

• Microsoft.AspNetCore.AII 

Paket başvurusu tarafından belirtilen sürüm gerekli minimum sürümü. Örneğin, bu paket sürümlerini yalnızca 
2.1.0 olan bir makinede çalıştırılmadığından 2.1.1 başvuran bir projeyi yüklü çalışma zamanı. 

Paylaşılan bir framevvork'ü hedefleyen projeler için bilinen sorunlar: 

• .N ET Core SDK'sı (Visual Studio 15.6 sürümünde ilk dahil) örtük sürümünü ayarlamak 2.1.300 
Microsoft.AspNetCore.App Entity Framevvork Core 2.1.1 çakışmaları neden 2.1.0 için. .NET Core SDK 

2.1.301 veya sonraki bir sürüme yükseltmek için önerilen çözümdür bakın. Daha fazla bilgi için 

bağımlılıklara Microsoft.AspNetCore.App paketleri, düzeltme eki sürümleri başvuramaz. 







• Kullanmanız gereken tüm projeleri Microsoft.AspNetcore.Aiı veya Microsoft.AspNetcore.App kullanarak 
başka bir proje için bir proje başvurusu içerseler bile proje dosyasında bir paket için paket başvurusu 
eklemelisiniz Microsoft.AspNetCore.All veya Microsoft.AspNetcore.App . 

Örnek: 

O MyApp bir paket başvurusu olan Microsoft.AspNetCore.App . 
o MyApp.Tests bir proje başvurusu olan MyApp.csproj . 

için bir paket başvurusu ekleme Microsoft.AspNetCore.App için MyApp.Tests . Daha fazla bilgi için 
tümleştirme testi ayarlamak zordur ve paylaşılan çerçeve hizmeti üzerinde kesilebilir. 

2.1 Docker görüntülerini güncelleştir 

ASP.NET Core 2.1 içinde Docker görüntüleri geçirildiğinde dotnet/dotnet-docker GitHub deposu. Aşağıdaki 
tabloda, Docker görüntü ve etiket değişiklikleri gösterir: 

2,0 2.1 


Microsoft / aspnetcore:2.0 


Microsoft / dotnet:2.1 -aspnetcore-çalışma zamanı 


Microsoft/aspnetcore-build: 2.0 


microsoft/dotnet:2.1 -sdk 


Değişiklik from içindeki satırları, Dockerfile önceki tablonun 2.1 sütununda Yeni görüntü adlarını ve etiketleri 
kullanmak için. Daha fazla bilgi için dotnet için aspnetcore docker depolan geçiş. 


ASP.NET Core 2.1 önerilen yeni kod tabanlı deyimleri yararlanmak için 
değişiklikler 

Main değişiklikleri 

Aşağıdaki resimlerde şablonlu için oluşturulan yapılan değişiklikleri göster Program.es dosya. 

namespace UebAppl 

{ 

public elass Program 

{ 

public static void Main(string[] args) 

{ 


} 


BuildV.'ebHost(args) .Run()j 


public static IVJebHost BuildV<ebHost:(string[] args) => 
WebHost.CreateDefaultBuilder(args) 

.UseStart up<Startup>( ) 

.Build(); 


Önceki resimde 2.0 sürümü ile silme kırmızı renkte gösterilir. 


Aşağıdaki görüntüde, 2.1 kod gösterilmektedir. Yeşil kodda 2.0 sürümü değiştirildi: 

















namespace WebAppl 

{ 

public class Program 

{ 

public static void Main(string[] args) 

y |CreateWebHostBuilder) (args) . fruild() D*un(); 

} 

public static [i 1 |CreateWebHostBuilder| (stringn args) => 

ı.'ebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup >(); 


} 


} 


2.1 sürümü, aşağıdaki kodda gösterildiği Program.es'. 


namespace 1/JebAppl 

{ 

public class Program 

{ 

public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build().Run(); 

} 


} 


} 


public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 
WebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>(); 


Yeni Main çağrısı değiştirir BuiidwebHost ile CreateWebHostBuilder. IWebHostBuilder yeni desteklemek için 
eklenen tümleştirme ve test altyapısı. 


Başlangıç için değişiklikler 

Aşağıdaki kod, 2.1 şablonu oluşturulan kod değişiklikleri gösterir.Tüm değişiklikleri eklenen kodu, hariç 
UseBrowserl_ink kaldırıldı: 












using Microsoft.AspNetCore.Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.Extensions.Configuration; 

using Microsoft.Extensions.DependencyInjection; 

namespace 1/JebAppl 

{ 

public class Startup 

{ 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Configure<CookiePolicyOptions>(options => 

{ 

// This lambda determines whether user consent for non-essential cookies is needed for a given 

request. 

options.CheckConsentNeeded = context => true; 
options.MinimumSameSitePolicy = SameSiteMode.None; 

}); 

Services. AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_l); 

} 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseExceptionHandler("/Error"); 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 
app.UseCookiePolicy(); 

// If the app uses Session or TempData based on Session: 

// app.UseSession(); 

app.UseMvc(); 

} 

} 

} 

Önceki kod değişikliklerini ayrıntılı: 

• G DPR desteği de AS P.N ET Core için cookiePolicyOptions ve UseCookiePolicy. 

• HTTP taşıma katı güvenlik protokolü (HSTS) için useHsts . 

• HTTPS'yi zorunlu için UseHttpsRedirection . 

• SetCompatibilityVersion için SetCompatibilityVersion(CompatibilityVersion.Version_2_l) . 








Kimlik doğrulama kodu değişiklikleri 

ASP.NET Core 2.1 sağlar ASP.NET Core kimliği olarak bir Razor sınıf kitaplığı (RCL). 

1 % S'varsayılan 2.1 kimlik Ul şu anda 2.0 sürümü üzerinde önemli yeni özellikler sağlamaz. Kimlik RCL paket ile 
değiştirerek isteğe bağlıdır. Şablon değiştirilmesi yararları RCL sürümüyle kodunu içeren bir kimlik oluşturulur: 

• Çok sayıda dosya kaynak ağacınız dışına taşındı. 

• Herhangi bir hata düzeltmeleri veya yeni özelliklere kimlik için dahil edilen Microsoft.AspNetCore.App 
metapackage. Güncelleştirilmiş kimlik otomatik olarak almak, Microsoft.AspNetCore.App güncelleştirilir. 

Şablonda yapılan değişiklikler, Önemsiz olmayan yaptıysanız, kimlik kodunu oluşturmuştur: 

• Önceki avantajları muhtemelen kullanıyordur değil RCL sürüme dönüştürme Hizala. 

• ASP.NET Core 2.0 kimliği kodunuzu tutabilirsiniz, tam olarak desteklenir. 

Kimlik 2.1 ile uç noktalarını kullanıma sunar identity alan. Örneğin, aşağıdaki tabloda 2.1 için 2. O'ı değiştirmek 
kimlik uç noktaları örnekleri gösterilmektedir: 


2.0 URL'Sİ 2.1 URL'Sİ 

/ Hesabı/oturum açma / Kimlik/hesabı/oturum açma 

/ Hesabı/oturum kapatma / Kimlik/hesabı/oturum kapatma 

/ Hesabı/yönetme / Kimlik/hesabı/yönetme 


Kimlik URL'leri dikkate 2.1 kimlik kitaplığı gerek kimlik Arabirimiyle kimliğini kullanarak bir kodunuz varsa ve 2.0 
değiştirin uygulamalara sahip /identity kesimi için bir URl'leri etkileşimlidir.Kümeden örneğin yeniden 
yönlendirmeleri için yeni işlemek için tek yönlü kimlik uç noktaları olan /Account/Login için 
/Identity/Account/Login . 

2.1 sürümüne güncelleştirme kimliği 

Kimlik için 2.1 güncelleştirmek aşağıdaki seçenekler kullanılabilir. 

• Kimlik Ul 2.0 kod değişikliğine gerek kalmadan kullanın. Kullanıcı Arabirimi 2.0 kimlik kodu kullanarak tam 
olarak desteklenir. Bu, oluşturulan kimlik kodu için yapılan önemli değişiklikler olduğunda iyi bir yaklaşımdır. 

• Mevcut kimlik 2.0 kodunuzu silmek ve iskele kimlik projenize. Projenizi kullanacağı ASP.NET Core kimliği 
Razor sınıf kitaplığı. Kod ve herhangi bir değişiklik kimlik Ul kod için Ul oluşturabilirsiniz. Yeni iskele kurulmuş 
bir kullanıcı Arabirimi kodlarını kod değişikliklerinizi uygulayın. 

• Mevcut kimlik 2.0 kodunuzu silmek ve iskele kimlik seçeneği ile projenize tüm dosyaları geçersiz kılma. 

Kimlik 2.0 değiştirin kimlik 2.1 Razor sınıf kitaplığı ile kullanıcı Arabirimi 

Bu bölümde ile ASP.N ET Core 2.0 Şablonu oluşturulan kimlik kodu değiştirmek için gereken adımları özetler 
AS P.N ET Core kimliği Razor sınıf kitaplığı. Razor sayfaları projesi için aşağıdaki adımlar yer almaktadır, ancak bir 
MVC projesi yaklaşımı benzer. 

• Doğrulama 2.1 sürümleri kullanmak için proje dosyası güncelleştirilir 

• Aşağıdaki klasörleri ve bunları tüm dosyaları silin: 
o Denetleyiciler 

o Sayfa/hesap / 
o Uzantıları 

• Projeyi oluşturun. 

• İskele kimlik projenize: 








o Çıkma projeleri seçin _Layout.cshtml dosya. 

o Seçin + simgesine sağ alt tarafında veri bağlamı sınıfının. Varsayılan adı kabul edin, 
o Seçin Ekle yeni bir veri bağlamı sınıfı oluşturmak için. Yeni veri bağlamı oluşturmak için iskele gereklidir. 
Sonraki bölümde yeni veri bağlamı Kaldır 

Kimlik iskele kurma özelliği sonra güncelleştir 

• Oluşturulan kimlik iskele kurucu Sil identityDbContext sınıfta türetilmiş klmlik/alanlar/Data/ klasör. 

• Silme Areas/ldentity/ldentityHostingStartup.cs. 

• Güncelleştirme _LoginPartial.cshtml dosyası: 

o Taşıma sayfalan /_LoginPartial.cshtml için sayfalan ve paylaşdan/_LoglnPartial.cshtml. 
o Ekleme asp-area="identity" form ve yer işareti bağlantıları için, 
o Güncelleştirme <form /> öğesine 

<form asp-area="Identity" asp-page="/Account/Logout" asp-route-returnUrl="@Url.Page("/Index", new { 
area = "" })" method="post" id="logoutForm" class="navbar-right"> 


Aşağıdaki kod güncelleştirilmiş gösterir _LoginPartial.cshtml dosyası: 

Şusing Microsoft.AspNetCore.Identity 

Şinject SignInManager<ApplicationUser> SignlnManager 
Şinject UserManager<ApplicationUser> UserManager 

Şif (SignlnManager.IsSignedIn(User)) 

{ 

<form asp-area="Identity" asp-page="/Account/Logout" asp-route-returnUrl="ŞUrl.Page("/Index", new { 
area = "" })" method="post" id="logoutForm" class="navbar-right"> 

<ul class="nav navbar-nav navbar-right"> 

<li> 

<a asp-area="Identity" asp-page="/Account/Manage/Index" title="Manage">Hello 
ŞUserManager.GetUserName(User)!</a> 

</li> 

<li> 

<button type="submit" class="btn btn-link navbar-btn navbar-link">Log out</button> 

</li> 

</ul> 

</form> 

} 

else 

{ 

<ul class="nav navbar-nav navbar-right"> 

<lixa asp-area="Identity" asp-page="/Account/Register">Register</ax/li> 

<lixa asp-area="Identity" asp-page="/Account/Login">Log in</ax/li> 

</ul> 

} 


Güncelleştirme configureServices aşağıdaki kod ile: 







public void ConfigureSenvices(IServiceCollection Services) 

{ 

Services.AddDbContext<ApplicationDbContext>(options => 

options .UseSqlServer(Configuration .GetConnectionString("DefaultConnection"))); 

Services.AddDefaultIdentity<ApplicationUser>() 

.AddEntityFrameworkStores<ApplicationDbContext>() 

.AddDefaultTokenProviders(); 

Services. AddMvc(); 

// Register no-op EmailSender used by account confirmation and password reset 
// during development 

Services.AddSingletoncIEmailSender , EmailSender>(); 


Razor sayfaları için Razor dosyaları projeleri değiştirir. 

Düzen dosyası 

• Taşıma sayfalan/_Layout.cshtml için sayfalan vepaylaşılan/_Layout.cshtml 

• İçinde kimlil</alanlar/sayfalarL/_ViewStartcshtml, değiştirme Layout = "/Pages/_Layout.cshtmi" için 

Layout = "/Pages/Shared/_Layout.cshtml" . 

• _Layout.cshtml dosyası aşağıdaki değişiklikleri vardır: 

o <partiai name="_cookieConsentPartiai" /> eklenir. Daha fazla bilgi için GDPR desteği de ASP.NET Core. 
o jQuery 2.2.0 3.3.1 için değiştirir. 

_ValidationScriptsPartial.cshtml 

• Sayfa /_ ValidationScriptsPartial.cshtml taşır sayfa la n/paylaşıları/_ ValidationScriptsPartial.cshtml. 

• JQuery.Validate/1.14.0 değişikliklerini jquery.validate/1.17.0. 

Yeni dosyaları 

Aşağıdaki dosyalar eklenir: 

• Privacy.cshtml 

• Prlvacy.cshtml.es 

Bkz: GDPR desteği de ASP.NET Core yukarıdaki dosyaları hakkında bilgi için. 

MVC projelerini Razor dosyalarda yapılan değişiklikler 

Düzen dosyası 

Layout.cshtml dosyası aşağıdaki değişiklikleri vardır: 

• cpantial name="_CookieConsentPantial" /> eklenir. 

• 3.3.1 için jQuery 2.2.0 değişiklikleri 

_ValidationScriptsPartial.cshtml 

JQuery.Validate/1.14.0 değişikliklerini jquery.validate/1.17.0 

Yeni dosyalar ve eylem yöntemleri 

Aşağıdaki eklenir: 

• Views/Home/Privacy.cshtml 

• Privacy Eylem yöntemi, giriş denetleyicisine eklenir. 








Bkz: GDPR desteği de ASP.NET Core yukarıdaki dosyaları hakkında bilgi için. 


LaunchSettings.json dosyada yapılan değişiklikler 

ASP.NET Core uygulamaları artık varsayılan olarak, HTTPS kullanacak şekilde Properties/launchSettings.json 
dosyası değiştirildi. 

Aşağıdaki JSON Şablonu oluşturulan önceki 2.0 gösterir launchSettings.json dosyası: 


"iisSettings": { 

"windowsAuthentication": false, 
"anonymousAuthentication": true, 

"iisExpress": { 

"applicationUrl": "http://localhost:1799/", 
"sslPort": 0 

} 

L 

"profiles": { 

"IIS Express": { 

"commandName": "IISExpress", 

"launchBrowser": true, 
"environmentVariables": { 

"ASPNETCORE_ENVIRONMENT": "Development" 

} 

b 

"1/JebAppl": { 

"commandName": "Project", 

"launchBrowser": true, 
"environmentVariables": { 

"ASPNETCORE_ENVIRONMENT": "Development" 

b 

"applicationUrl": "http://localhost:1798/" 

} 

} 

} 


Şablon tarafından oluşturulan yeni 2.1 aşağıdaki JSON'u göstermektedir launchSettings.json dosyası: 



"iisSettings": { 

"windowsAuthentication": false, 

"anonymousAuthentication": true, 

"iisExpress": { 

"applicationllrl": "http://localhost:39191", 

"sslPort": 44390 

} 

}, 

"profiles": { 

"IIS Express": { 

"commandName": "IISExpress", 

"launchBrowser": true, 

"environmentVariables": { 

"ASPNETCORE_ENVIRONMENT": "Development" 

} 

}, 

"WebAppl": { 

"commandName": "Project", 

"launchBrowser": true, 

"applicationllrl": "https ://localhost: 5001 ; http://localhost: 5000", 
"environmentVariables": { 

"ASPNETCORE_ENVIRONMENT": "Development" 

} 

} 

} 

} 


Daha fazla bilgi için bkz. ASP.NET Core 'de HTTPS 'yi zorla. 

Yeni değişiklikler 

FileResult aralık üst bilgisi 

FileResult artık işleme Accept-Ranges varsayılan üstbilgi. Etkinleştirmek için Accept-Ranges başlığını ayarlayın 
EnableRangeProcessing için true . 

ControllerBase.File ve PhysicalFile aralık üst bilgisi 

Aşağıdaki ControllerBase yöntemleri artık işler Accept-Ranges varsayılan üst bilgi: 

• Overloads biri ControllerBase.File 

• ControllerBase.PhysicalFile 

Etkinleştirmek için Accept-Ranges başlığını ayarlayın EnableRangeProcessing parametresi true . 

Ek değişiklikler 

• IIS ile Windows üzerinde uygulama barındırma yüklerseniz en son .NET Core barındırma paket. 

• SetCompatibilityVersion 

• Aktarım yapılandırma 







ASPNET Core 1. x ile 2,0 arasında geçiş yapın 
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Scott Ade tarafından 

Bu makalede, mevcut bir AS P.N ET Core 1. x projesini AS P.N ET Core 2,0 ' ye güncelleştirme konusunda size 
kılavuzluk ederiz. Uygulamanızı AS P.N ET Core 2,0 1 ye geçirmek, birçok yeni özellikten ve performans 
iyileşti rmelerindenyararlan manızı sağlar. 

Mevcut ASP.NET Core 1. x uygulamaları sürüme özgü proje şablonlarını temel almir.ASP.NET Core Framevvork 
geliştikçe, proje şablonlarını ve bunların içinde yer alan başlangıç kodunu yapın. AS P.N ET Core çerçevesini 
güncelleştirmenin yanı sıra, uygulamanız için kodu güncelleştirmeniz gerekir. 

Prerequisites 

Bkz. ASP.NET Core kullanmaya başlama. 

Hedef Framevvork bilinen adını güncelleştir (tfd) 

.NET Core 'un hedeflediği projeler, .NET Core 2,0 ' den büyük veya buna eşit bir sürümüntfd 'sini kullanmalıdır.. 
Csproj dosyasında <TargetFramework> düğümünü arayın ve iç metnini netcoreapp2.e ile değiştirin: 

<TargetFramework>netcoreapp2.0</TargetFramework> 

.NET Framevvork hedefleyen projeler, .NET Framevvork 4.6.1 daha büyük veya buna eşit bir sürümün tfd 'sini 
kullanmalıdır.. Csproj dosyasında <TargetFramework> düğümünü arayın ve iç metnini net46i ile değiştirin: 

<TargetFramework>net461</TargetFramework> 


NOTE 

.NET Core 2,0, .NET Core 1.x' ten çok daha büyük bir yüzey alanı sunar. .NET Core 1. x içinde eksik API 'Ler nedeniyle yalnızca 
.NET Framevvork hedefliyorsanız, .NET Core 2,0 ' i hedeflemek büyük olasılıkla işe çalışabilmektedir. 


Proje dosyası <RuntimeFrameworkVersion>l.{sub-version}</RuntimeFrameworkVersion> içeriyorsa, Bu GitHub 
sorununabakın. 

Global. JSON içinde .NET Core SDK sürümü güncelleştirme 


Çözümünüz belirli bir .N ET Core SDK sürümünü hedeflemek için Global bir. JSON dosyasını kullanıyorsa, 
makinenizde yüklü 2,0 sürümünü kullanmak için version özelliğini güncelleştirin: 


{ 

"sdk": { 



"version": ' 

'2.0.0" 


> 


} 













Paket başvurularını Güncelleştir 

1.x projesindeki. csproj dosyası, proje tarafından kullanılan her bir NuGet paketini listeler. 

.NET Core 2,0 1 i hedefleyen ASP.NET Core 2,0 projesinde,. csproj dosyasındaki tek bir metapackage başvurusu, 
paket koleksiyonunun yerini alır: 

<ItemGroup> 

<PackageReference Include="Microsoft.AspNetCore. Ali" Version="2.0.9" /> 

</ItemGroup> 


ASP.NET Core 2,0 ve Entity Framevvork Core 2,0 ' nin tüm özellikleri metapackage 'e dahildir. 


.NET Framevvork hedefleyen ASP.NET Core 2,0 projeleri bireysel NuGet paketlerine başvurmasına devam 
etmelidir. Her <PackageReference /> düğümünün version özniteliğini 2.0.0 olarak güncelleştirin. 


Örneğin, .NET Framevvork tipik bir ASP.NET Core 2,0 projesinde kullanılan <PackageReference /> düğümlerinin 
listesi aşağıda verilmiştir: 


<ItemGroup> 

<PackageReference 
<PackageReference 
<PackageReference 
<PackageReference 
<PackageReference 
<PackageReference 
PrivateAssets="All" 
<PackageReference 
<PackageReference 
<PackageReference 
<PackageReference 
<PackageReference 
<PackageReference 
PrivateAssets="All" 
</ItemGroup> 


Include="Microsoft.AspNetCore" Version="2.0.0" /> 

Include="Microsoft.AspNetCore.Authentication.Cookies" Version="2.0.0" /> 

Include="Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore" Version="2.0.0" /> 
Include="Microsoft.AspNetCore.Identity.EntityFrameworkCore" Version="2.0.0" /> 
Include="Microsoft.AspNetCore.Mvc" Version="2.0.0" /> 

Include="Microsoft.AspNetCore.Mvc.Razor.ViewCompilation" Version="2.0.0" 

/> 

Include="Microsoft.AspNetCore.StaticFileş" Version="2.0.0" /> 

Include="Microsoft.EntityFrameworkCore.Design" Version="2.0.0" PrivateAssets="All" /> 
Include="Microsoft.EntityFrameworkCore.SqlServer" Version="2.0.0" /> 
Include="Microsoft.EntityFrameworkCore.Tools" Version="2.0.0" PrivateAssets="All" /> 
Include="Microsoft.VisualStudio.Web.BrowserLink" Version="2.0.0" /> 
Include="Microsoft.VisualStudio.Web.CodeGeneration.Design" Version="2.0.0" 

/> 


.NET Core CU araçlarını Güncelleştir 

. Csproj dosyasında, her bir <DotNetciiTooiReference /> düğümünün version özniteliğini 2.0.0 olarak 
güncelleştirin. 

Örneğin, .NET Core 2,0 ' i hedefleyen tipik bir ASP.NET Core 2,0 projesinde kullanılan CLı araçlarının listesi 
aşağıda verilmiştir: 

<ItemGroup> 

<DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools.DotNet" Version="2.0.0" /> 
<DotNetCliToolReference Include="Microsoft.Extensions.SecretManager.Tools" Version="2.0.0" /> 
<DotNetCliToolReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Tools" Version="2.0.0" /> 
</ItemGroup> 


Paket hedefi geri dönüş özelliğini yeniden adlandır 

1 . x projesinin . csproj dosyası PackageTargetFaiiback bir düğüm ve değişken kullandı: 

<PackageTargetFallback>$(PackageTargetFallback);portable-net45+win8+wp8+wpa81;</PackageTargetFallback> 












Hem düğümü hem de değişkeni AssetTargetFaiiback olarak yeniden adlandırın: 


<AssetTargetFallback>$(AssetTargetFallback);portable-net45+win8+wp8+wpa81;</AssetTargetFallback> 


Program.es 'de ana yöntemi Güncelleştir 

1. x projelerinde, Program.es Main yöntemi şöyle bir şekilde aranır: 

using System.10; 

using Microsoft.AspNetCore.Hoşting; 

namespace AspNetCoreDotNetCorelApp 

{ 

public elass Program 

{ 

public static void Main(string[] args) 

{ 

var hoşt = new WebHostBuilder() 

,UseKestrel() 

. UseContentRoot(Directory.GetCurrentDirectory()) 
.UselISIntegration() 

.UseStartup<Startup>() 

.UseApplicationInsights() 

.Build(); 

host.Run(); 

} 

} 

} 

2,0 projesinde, Program.es Main yöntemi basitleştirilmiştir: 

using Microsoft.AspNetCore; 
using Microsoft.AspNetCore.Hoşting; 

namespace AspNetCoreDotNetCore2App 

{ 

public elass Program 

{ 

public static void Main(string[] args) 

{ 

BuildWebHost(args).Run(); 

} 

public static IWebHost BuildWebHost(string[] args) => 
WebHost.CreateDefaultBuilder(args) 
.UseStartup<Startup>() 

.Build(); 

} 

} 


Bu yeni 2,0 deseninin benimsenmesi önemle önerilir ve Entity Framevvork (EF) çekirdek geçişleri gibi ürün 
özellikleri için gereklidir. Örneğin, Paket Yöneticisi konsol penceresinde veya komut satırından 
dotnet ef database update update-Database çalıştırmak (ASP.N ET Core 2,0 1 e dönüştürülmüş projelerde) 
aşağıdaki hatayı üretir: 

Unable to create an object of type '<Context>'. Add an implementation of 

’IDesignTimeDbContextFactory<Context>' to the project, or see https://go.microsoft.com/fwlink/?linkid=851728 
for additional patterns supported at design time. 










Yapılandırma sağlayıcıları Ekle 

1. x projelerinde, bir uygulamaya yapılandırma sağlayıcıları eklemek startup Oluşturucu aracılığıyla 
gerçekleştirildi. Bir configurationBuiider örneğini oluşturma, geçerli sağlayıcıları yükleme (ortam değişkenleri, 
uygulama ayarları vb.) ve bir ıconfigurationRoot üyesini başlatma adımları. 

public Startup(IHostingEnvironment env) 

{ 

var builder = new ConfigurationBuilder() 

.SetBasePath(env.ContentRootPath) 

.AddlsonFile("appsettings.json", optional: false, reloadOnChange: true) 
.Add]sonFile($"appsettings.{env.EnvironmentName}.json", optional: true); 

if (env.IsDevelopment()) 

{ 

builder.AddUserSecrets<Startup>(); 

} 

builder.AddEnvironmentVariables(); 

Configuration = builder.Build(); 

} 

public IConfigurationRoot Configuration { get; } 

Yukarıdaki örnek, Configuration üyesini appSettings. JSON ' dan ve tüm appSettings.<environmentname>. 
JSON dosyasını iHostingEnvironment.EnvironmentName özelliğiyle eşleşen yapılandırma ayarlarıyla yükler. Bu 
dosyaların konumu Startup.cs'ûe aynı yoldur. 

2,0 projesinde, 1. x projelerine devralınan ortak yapılandırma kodu, arka planda çalışır. Örneğin, ortam değişkenleri 
ve uygulama ayarları başlangıçta yüklenir. Denk Startup.es kodu, eklenen örnekle ıconfiguration başlatmaya 
indirgenecek: 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 


webHostBuiider. CreateDefault Builder tarafından eklenen varsayılan sağlayıcıları kaldırmak için, 

ConfigureAppConfiguration içindeki 

ıconfigurationBuiider.sources özelliğinde ciear yöntemi çağırın. Sağlayıcıları 

geri eklemek için, program .esiçinde 

ConfigureAppConfiguration yöntemi kullanın: 

public static void Main(string[] 

{ 

BuildWebHost(args).Run(); 

args) 


} 

public static IWebHost BuildWebHost(string[] args) => 

UebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>() 

.ConfigureAppConfiguration((hostContext, config) => 

{ 

// delete ali default configuration providers 
config.Sources.Clear(); 

config.AddlsonFile("myconfig.json", optional: true); 

}) 

.Build(); 











Yukarıdaki kod parçacığında createDefaultBuiider yöntemi tarafından kullanılan yapılandırma buradagörülebilir. 


Daha fazla bilgi için ASP.NET Core yapılandırmakonusuna bakın. 

Veritabanı başlatma kodunu taşı 

EF Core 1.x kullanan 1.x projelerinde, dotnet ef migrations add gibi bir komut şunları yapar: 

1. Bir startup örneğini başlatır 

2. Tüm hizmetleri bağımlılık eklenmesine ( DbContext türler dahil) kaydetmek için configureServices yöntemini 
çağırır 

3. Önkoşul görevlerini gerçekleştirir 

EF Core 2,0 kullanan 2,0 projesinde, Program.BuiiduebHost uygulama hizmetlerini almak için çağrılır. 1. x aksine, 
bu, startup.configure çağırma ek yan etkiye sahiptir. 1. x uygulamanız configure yönteminde veritabanı başlatma 
kodu çağırırdı, beklenmeyen sorunlar meydana gelebilir. Örneğin, veritabanı henüz yoksa, dengeli dağıtım kodu EF 
Core geçiş komutu yürütmeden önce çalışır. Bu sorun, veritabanı henüz yoksa bir dotnet ef migrations list 
komutunun başarısız olmasına neden olur. 

Startup.es configure yönteminde aşağıdaki 1. x çekirdek başlatma kodunu göz önünde bulundurun: 

app.UseMvc(routes => 

{ 

routes.MapRoute( 

name: "default", 

template: "{controller=Home}/{action=Index}/{id?}"); 

}); 

SeedData.Initialize(app.ApplicationServices); 

2,0 projesinde SeedData.initialize çağrısını Program.cs Main yöntemine taşıyın: 

var hoşt = BuildWebHost(args); 

using (var scope = hoşt.Services.CreateScope()) 

{ 

var Services = scope.ServiceProvider; 

try 

{ 

// Requires using RazorPagesMovie.Modelsj 
SeedData.initialize(Services); 

} 

catch (Exception ex) 

{ 

var logger = Services.GetRequiredService<ILogger<Program>>(); 
logger.LogError(ex, "An error occurred seeding the DB.")j 

} 

} 

host.Run(); 

2,0 itibariyle, Web konağını derleme ve yapılandırma dışında BuiidwebHost bir şey yapmak hatalı bir uygulamadır. 
Uygulamayı çalıştırmaya ilişkin her şey, genellikle Program.cs Main yönteminde BuiiduiebHost —dışında 
işlenmelidir. 

Razor görünümü derleme ayarını inceleyin 

Daha hızlı uygulama başlangıç süresi ve daha küçük yayımlanmış paketleri size en önemli öneme sahiptir. Bu 


















nedenlerden dolayı Razor görünümü derlemesi , AS P.N ET Core 2,0 ' de varsayılan olarak etkinleştirilmiştir. 

MvcRazorCompileOnPubiish özelliğinin true olarak ayarlanması artık gerekli değildir. Görünümü derlemeyi devre dışı 
bırakmadığınız takdirde, özelliği. csproj dosyasından kaldırılabilir. 

.NET Framework hedeflenirken,. csproj dosyanızdaki Microsoft. Aspnetcore. Mvc. Razor. vievvcompilation NuGet 
paketine yine de başvurmanız gerekir: 

<PackageReference Include="Microsoft.AspNetCore.Mvc.Razor.ViewCompilation" Version="2.0.0" PrivateAssets="All" 
/> 


Application Insights "hafif" özelliklere güvenin 

Uygulama performansı izleme için daha kolay bir kurulum önemlidir. Artık, Visual Studio 2017 Tooling ' de 
bulunan yeni Application Insights "hafif" özelliklerine güvenebilirsiniz. 

Visual Studio 2017 ' de oluşturulan ASP.NET Core 1,1 projeleri varsayılan olarak Application Insights eklenmiştir. 
Application Insights SDK 'yı doğrudan program.es ve Sfortup.csdışında kullanmıyorsanız, şu adımları izleyin: 

1. .N ET Core'u hedefliyorsanız, şu <PackageReference /> düğümünü . csproj dosyasından kaldırın: 


<PackageReference Include="Microsoft.ApplicationInsights.AspNetCore" Version="2.0.0" /> 

.NET Core'u hedefliyorsanız, program .csöğesinden 

kaldırın: 

UseApplicationlnsights 

uzantısı yöntem çağrısını 


public static void Main(string[] args) 

{ 

var hoşt = new WebHostBuilder() 

.UseKestrel() 

.UseContentRoot(Directory.GetCurrentDirectory()) 
.UseIISIntegration() 

.UseStartup<Startup>() 

.UseApplicationInsights() 

.Build(); 

host.Run(); 


3. _Layout. cshtml'den Application Insights İSTEMCİ tarafı API çağrısını kaldırın. Aşağıdaki iki satır kodu içerir: 


(Şinject Microsoft.Applicationlnsights.AspNetCore.HavaScriptSnippet DavaScriptSnippet 
@Html.Raw(DavaScriptSnippet.FullScript) 


Application Insights SDK 'Yı doğrudan kullanıyorsanız, bunu yapmaya devam edin. 2,0 metapackage , en son 
Application Insights sürümünü içerir, bu nedenle eski bir sürüme başvursanız bir paket düşürme hatası 
görüntülenir. 

Kimlik doğrulama/kimlik geliştirmelerini benimseyin 

ASP.NET Core 2,0 ' de yeni bir kimlik doğrulama modeli ve ASP.NET Core kimliğinde bazı önemli değişiklikler 
vardır. Projenizi ayrı ayrı kullanıcı hesaplarıyla oluşturduysanız veya el ile kimlik doğrulama veya kimlik 
eklediyseniz, bkz. ASP.NET Core kimlik doğrulaması ve kimliği 2,0. 







Ek kaynaklar 

• ASP.NET Core 2,0 1 deki Son değişiklikler 


Kimlik doğrulaması ve kimlik için ASPNET Core 2.0 
geçirme 
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Tarafından Scott Addie ve Hao Kung 

ASP.NET Core 2.0 kimlik doğrulaması için yeni bir modeli vardır ve kimlik , basitleştirir yapılandırma hizmetlerini 
kullanarak. Kimlik doğrulaması veya kimlik kullanan ASP.NET Core 1.x uygulamaları, aşağıda belirtildiği gibi yeni 
modeli kullanmak için güncelleştirilebilir. 

Güncelleştirme ad alanları 

1 .X içinde gibi sınıflan IdentityRole ve IdentityUser bulundu Microsoft.AspNetCore.Identity.EntityFrameworkCore 
ad alanı. 

2.0, Microsoft.AspNetCore.ldentity ad alanı birkaç tür sınıflar için yeni giriş dönüştü. Varsayılan kimlik koduyla 
etkilenen sınıflarını Appiicationuser ve startup . Ayarlama, using etkilenen başvurularını çözümlemek için 
deyimleri. 

Kimlik doğrulaması ara yazılımı ve Hizmetleri 

1 .x projelerinde, kimlik doğrulaması ara yazılımı üzerinden yapılandırılır. Desteklemek istediğiniz her bir kimlik 
doğrulama düzeni için bir ara yazılım yöntemi çağrılır. 

Aşağıdaki 1 .x örnek kimliği ile Facebook kimlik doğrulamasını yapılandırır Startup.es : 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services.Addldentity<Appiicationuser, IdentityRole>() 

.AddEntityFrameworkStores<ApplicationDbContext>(); 

} 

public void Configure(IApplicationBuilder app, ILoggerFactory loggerfactory) 

{ 

app.UseldentityO; 

app.UseFacebookAuthentication(new FacebookOptions { 

Appld = Configuration["auth:facebook:appid"], 

AppSecret = Configuration["auth:facebook:appsecret"] 

}); 

} 

2.0 projelerinde, kimlik doğrulama hizmetleri aracılığıyla yapılandırılır. Her kimlik doğrulama düzeni kaydedilmiştir 


ConfigureServices 

yöntemi Startup.es. 

Useldentity 

Yöntemi ile değiştirilir 

UseAuthentication 


Aşağıdaki 2.0 örnek kimliği ile Facebook kimlik doğrulamasını yapılandırır Startup.es: 















public void ConfigureServices(IServiceCollection Services) 

{ 

Services.AddldentitycApplicationUser, IdentityRole>() 

.AddEntityFrameworkStores<ApplicationDbContext>(); 

// If you want to tweak Identity cookies, they're no longer part of IdentityOptions. 

Services.ConfigureApplicationCookie(options => options.LoginPath = "/Account/Logln"); 

Services.AddAuthentication() 

.AddFacebook(options => 

{ 

options.Appld = Configuration["auth:facebook:appid"]j 
options.AppSecret = Configuration["auth:facebook:appsecret "]; 

}); 

} 

public void Configure(IApplicationBuilder app., ILoggerFactory loggerfactory) { 
app.UseAuthentication(); 

} 

useAuthentication Yöntemi otomatik kimlik doğrulaması ve Uzaktan kimlik doğrulama isteklerinin işlenmesini 
sorumlu tek bir kimlik doğrulaması ara yazılım bileşeni ekler. Tek bir ara yazılım bileşenlerinin tümünü tek, ortak 
bir ara yazılım bileşeni ile değiştirir. 

Her temel kimlik doğrulaması düzeni için 2.0 geçiş yönergeleri aşağıda verilmiştir. 

Tanımlama bilgisi tabanlı kimlik doğrulaması 

Aşağıdaki iki seçenekten birini seçin ve gerekli değişiklikleri yapın Startup.es: 

1. Tanımlama bilgileri kimlik ile kullanma 

• Değiştirin useidentity ile useAuthentication içinde Configure yöntemi: 

app.UseAuthentication(); 

• Çağırma Addidentity yönteminde configureServices tanımlama bilgisi kimlik doğrulaması 
hizmetlerini eklemek için yöntemi. 

• İsteğe bağlı olarak, çağırma configureAppiicationCookie veya configureExternaicookie yönteminde 

ConfigureServices kimlik tanımlama bilgisi ayarları ince ayar için yöntemi. 

Services.AddldentitycApplicationUser, IdentityRole>() 

.AddEntityFrameworkStores<ApplicationDbContext>() 

.AddDefaultTokenProviders(); 

Services.ConfigureApplicationCookie(options => options.LoginPath = "/Account/Logln"); 


2. Kimlik olmadan tanımlama bilgileri kullanma 




Değiştirin 


UseCookieAuthentication 

yöntem çağrısı 

Configure 

yöntemiyle 

UseAuthentication 


app.UseAuthentication(); 


Çağırma AddAuthentication ve AddCookie yöntemleri ConfigureServices yöntemi: 

















// If you don't want the cookie to be automatically authenticated and assigned to 
HttpContext.User , 

// remove the CookieAuthenticationDefaults.AuthenticationScheme parameter passed to 
AddAuthentication. 

Services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme) 

.AddCookie(options => 

{ 

options.LoginPath = "/Account/Logln"; 
options.LogoutPath = "/Account/LogOff"; 

}); 

JWT taşıyıcı kimlik doğrulaması 

Aşağıdaki değişiklikleri yapın Startup.es: 

• Değiştirin Use3wtBearerAuthentication yöntem çağrısı Configure yöntemiyle UseAuthentication : 

app.UseAuthentication(); 

• Çağırma Add3wtBearer yönteminde configureServices yöntemi: 

Services.AddAuthentication(3wtBearerDefaults.AuthenticationScheme) 

.AddDwtBearer(options => 

{ 

options.Audience = "http://localhost:5001/"; 
options .Authority = "http://localhost:5000/"; 

}); 

Varsayılan düzenini geçirerek ayarlanmalıdır. Bu nedenle bu kod parçacığı kimliğini kullanmaz 
DwtBearerDefaults.AuthenticationScheme için AddAuthentication yöntemi. 

Openıd Connect (OIDC) kimlik doğrulaması 

Aşağıdaki değişiklikleri yapın Startup.es: 

• Değiştirin UseOpenldConnectAuthentication yöntem çağrısı Configure yöntemiyle UseAuthentication 

app.UseAuthentication(); 

• Çağırma AddOpenidConnect yönteminde ConfigureServices yöntemi: 

Services.AddAuthentication(options => 

{ 

options.DefaultScheme = CookieAuthenticationDefaults.AuthenticationScheme; 
options.DefaultChallengeScheme = OpenldConnectDefaults.AuthenticationScheme; 

}) 

.AddCookie() 

.AddOpenIdConnect(options => 

{ 

options.Authority = Configuration["auth:oidc:authority"]; 
options.Clientld = Configuration["auth:oidc:clientid"]; 


• Değiştirin PostLogoutRedirectUri Özelliğinde OpenldConnectOptions eylemiyle SignedOutRedirectUri 




















.AddOpenIdConnect(options => 

{ 

options.SignedOutRedirectUri = "https://contoso.com"; 

}); 


Facebook kimlik doğrulaması 

Aşağıdaki değişiklikleri yapın Startup.es: 


• Değiştirin 


UseFacebookAuthentication 

yöntem çağrısı 

Configure 

yöntemiyle 

UseAuthentication 


app.UseAuthentication(); 


• Çağırma AddFacebook yönteminde ConfigureServices yöntemi: 

Services.AddAuthentication() 

.AddFacebook(options => 

{ 

options.Appld = Configuration["auth:facebook:appid"]; 
options.AppSecret = Configuration["auth:facebook:appsecret"]; 


Google kimlik doğrulaması 

Aşağıdaki değişiklikleri yapın Startup.es: 


• Değiştirin 


UseGoogleAuthentication 

yöntem çağrısı 

Configure 

yöntemiyle 

UseAuthentication 


app.UseAuthentication(); 


• Çağırma AddGoogle yönteminde configureServices yöntemi: 

Services. AddAuthentication() 

.AddGoogle(options => 

{ 

options.Clientld = Configuration["auth:google:clientid"]; 
options.ClientSecret = Configuration["auth:google:Clientsecret"]; 

}); 


Microsoft Account kimlik doğrulaması 

Aşağıdaki değişiklikleri yapın Startup.es: 

• Değiştirin UseMicrosoftAccountAuthentication yöntem çağrısı Configure yöntemiyle UseAuthentication 


app.UseAuthentication(); 


• Çağırma AddMicrosoftAccount yönteminde ConfigureServices yöntemi: 

Services.AddAuthentication() 

.AddMicrosoftAccount(options => 

{ 

options.Clientld = Configuration["auth:microsoft:clientid"]; 
options.ClientSecret = Configuration["auth rmicrosoft:clientsecret"]; 






















Tvvitter kimlik doğrulaması 

Aşağıdaki değişiklikleri yapın Startup.es: 

• Değiştirin UseTwitterAuthentication yöntem çağrısı Configure yöntemiyle UseAuthentication : 

app.UseAuthentication(); 

• Çağırma AddTwitter yönteminde configureServices yöntemi: 

Services.AddAuthentication() 

.AddTwitter(options => 

{ 

options.ConsumerKey = Configuration["auth:twitter:consumerkey"]; 
options.ConsumerSecret = Configuration["auth:twitter:consumersecret"]; 

}); 

Varsayılan kimlik doğrulama düzenleri ayarlama 

1. x içinde AutomaticAuthenticate ve AutomaticChailenge özelliklerini AuthenticationOptions temel sınıfı yönelik 
tek bir kimlik doğrulama şemasını temel ayarlanacak. Bunu zorunlu kılmak için iyi bir yolu yoktu. 

2. 0 bu iki özellik özellikleri ayrı ayrı olarak kaldırılan AuthenticationOptions örneği, içinde yapılandırılabilir 
AddAuthentication yöntem çağrısı içinde ConfigureServices yöntemi Startup.es : 

Services. AddAuthenticat ion( CookieAuthenticationDefault s .Aut hent icat ionScheme); 

Yukarıdaki kod parçacığında, varsayılan düzenini ayarlamak cookieAuthenticationDefaults.AuthenticationScheme 
("tanımlama bilgileri"). 

Alternatif olarak, aşırı yüklenmiş bir sürümünü kullanmak AddAuthentication birden fazla özelliği ayarlamak için 

varsayılan düzenini ayarlamak 

. Kimlik doğrulama düzeni bunun yerine bireysel içinde 
belirtilen [Authorize] öznitelikleri veya yetkilendirme ilkeleri. 

Services.AddAuthentication(options => 

{ 

options.DefaultScheme = CookieAuthenticationDefaults.AuthenticatİonScheme; 
options.DefaultChallengeScheme = OpenldConnectDefaults.AuthenticatİonScheme; 

}); 

Aşağıdaki koşullardan biri doğru ise, 2. O'varsayılan düzenini tanımlayın: 

• Kullanıcı otomatik olarak oturum açmanız istiyor 

• Kullandığınız [Authorize] düzenleri belirtmeden özniteliği veya Yetkilendirme ilkeleri 

Bu kuralın istisnası Addidentity yöntemi. Bu yöntem, siz ve varsayılan kimlik doğrulaması ve uygulama 
tanımlama bilgisinin düzenleri meydan kümeleri için tanımlama bilgileri ekler. 

identityConstants.AppücationScheme . Ayrıca, varsayılan oturum açma düzeni için dış tanımlama bilgisi ayarlar 
IdentityConstants.ExternalScheme . 


yöntemi. Aşırı yüklenmiş yöntem aşağıdaki örnekte 
CookieAuthenticationDefault s .Aut hent icat İonScheme 


HttpContext kimlik doğrulama uzantıları kullanma 

iAuthenticationManager Arabirimi 1 .x kimlik doğrulama sisteminde ana giriş noktasıdır. Yeni bir dizi ile 
değiştirilmiştir HttpContext alanında uzantı yöntemlerini Microsoft.AspNetcore.Authentication ad alanı. 























Örneğin, başvuru 1 ,x projeleri bir Authentication özelliği: 

// Clear the existing external cookie to ensure a clean login process 
await HttpContext.Authentication.SignOutAsync(_externalCookieScheme); 

2.0 projelerinde, içeri aktarma Microsoft.AspNetCore.Authentication ad alanını ve silme Authentication özelliği 
başvuruları: 


// Clear the existing external cookie to ensure a clean login process 
await HttpContext.SignOutAsync(IdentityConstants.ExternalScheme); 


Windows kimlik doğrulaması (HTTP.sys/ llSIntegration) 

Windows kimlik doğrulamasının iki çeşidi vardır: 

• Konak, yalnızca kimliği doğrulanmış kullanıcılara izin verir. Bu farklılığa 2.0 değişikliklerden etkilenmez. 

• Ana bilgisayar hem anonim verir ve kimliği doğrulanmış kullanıcılar. Bu farklılığa 2.0 değişikliklerden 
etkilenir. Örneğin, altındaki anonim kullanıcılar izin IIS veya HTTP.sys katman ancak denetleyici düzeyinde 
kullanıcıları yetkilendirme. Bu senaryoda, varsayılan düzenini kümesinde startup.configureServices 
yöntemi. 

için Microsoft.AspNetCore.Server.llSIntegration, varsayılan düzenini ayarlayın 
IISDefaults.AuthenticationScheme : 

using Microsoft.AspNetCore.Server.llSIntegration; 

Services.AddAuthentication(IISDefaults.AuthenticationScheme); 

için Microsoft.AspNetCore.Server.HttpSys, varsayılan düzenini ayarlayın 
HttpSysDefaults.AuthenticationScheme : 

using Microsoft.AspNetCore.Server.HttpSys; 

Services.AddAuthentication(HttpSysDefauİts.AuthenticationScheme); 

Varsayılan düzen ayarlanamadı (sınama) authorize isteğinin, şu özel durumla çalışmasını engeller: 

System.invaiidOperationException : Hiçbir authenticationScheme belirtildiğinden ve bulunan hiçbir 
DefaultChallengeScheme vardı. 

Daha fazla bilgi için bkz. ASP.NET Core VVİndovvs kimlik doğrulamasını yapılandırma. 

IdentityCookieOptions örnekleri 

Bir yan etkisi 2.0 değişiklikleri seçeneklerini tanımlama bilgisi seçenekleri örnek yerine adlandırılmış kullanarak 
anahtardır. Kimlik tanımlama bilgisi düzeni adları özelleştirme yeteneği kaldırılır. 

Örneğin, 1.x projelerin Oluşturucu ekleme geçirilecek bir IdentityCookieOptions parametrede 
AccountController.es ve ManageController.es. Dış tanımlama bilgisi kimlik doğrulaması düzeni sağlanan 
örneğinden erişilebilir: 










public AccountController( 

UserManager<ApplicationUser> userManager, 

SignInManager<ApplicationUser> signlnManager, 

IOptions<IdentityCookieOptions> identityCookieOptions, 

IEmailSender emailSender, 

ISmsSender smsSender, 

ILoggerFactory loggerFactory) 

{ 

_userManager = userManager; 

_signInManager = signlnManager; 

_externalCookieScheme = İdentityCookieOptions.Value.ExternalCookieAuthenticationScheme; 

_emailSender = emailSender; 

_smsSender = smsSender; 

_logger = loggerFactory.CreateLoggen<AccountController>(); 

} 

Yukarıda sözü edilen Oluşturucu ekleme 2.0 projelerinde, gereksiz olur ve _externaicookieScheme alan silinebilir: 

public AccountController( 

UserManager<ApplicationUser> userManager, 

SignInManager<ApplicationUser> signlnManager, 

IEmailSender emailSender, 

ISmsSender smsSender, 

ILoggerFactory loggerFactory) 

{ 

_userManager = userManager; 

_signInManager = signlnManager; 

_emailSender = emailSender; 

_smsSender = smsSender; 

_logger = loggerFactory.CreateLogger<AccountController>(); 

} 

kullanılan 1 ,x projelerini _externaicookieScheme gibi alan: 

// Clear the existing external cookie to ensure a clean login process 
await HttpContext.Authentication.SignOutAsync(_externalCookieScheme); 

2.0 projelerinde, önceki kodu aşağıdakiyle değiştirin. identityConstants.Externaischeme Sabiti doğrudan 
kullanılabilir. 


// Clear the existing external cookie to ensure a clean login process 
await HttpContext.SignOutAsync(IdentityConstants.ExternalScheme); 

Yeni eklenen çözmek SignOutAsync aşağıdaki ad alanını içeri aktararak çağırın: 

using Microsoft.AspNetCore.Authentication; 


POCO IdentityUser Gezinti özellikleri ekleyin 

Entity Framevvork (EF) çekirdek gezinme özelliklerini temel IdentityUser POCO (düz eski CLR nesnesi) kaldırıldı. 
El ile 1.x projenizi bu özellikleri kullandıysanız, bunları 2.0 projeye ekleyin: 












/// <summary> 

III Navigation property for the roles this usen belongs to. 

III </summary> 

public Virtual ICollection<IdentityUserRole<int>> Roles { getj } = new List<IdentityUserRole<int>>()j 


III <summary> 

III Navigation property for the claims this user possesses. 

III </summary> 

public Virtual ICollection<IdentityUserClaim<int>> Claims { getj } = new List<IdentityUserClaim<int>>()j 


III <summary> 

III Navigation property for this users login accounts. 

III </summary> 

public Virtual ICollection<IdentityllserLogin<int>> Logins { getj } = new List<IdentityUserLogin<int>>()j 


EF Core geçişleri çalıştırırken yinelenen yabancı anahtarlar önlemek için aşağıdaki ekleyin, identityDbContext 
sınıfının OnModelCreating yöntemi (sonra base.OnModelCreatingO; çağrısı): 

protected override void OnModelCreating(ModelBuilder builder) 

{ 

base.OnModelCreating(builder)j 

// Customize the ASP.NET Core Identity model and override the defaults if needed. 

// For example, you can rename the ASP.NET Core Identity table names and more. 

// Add your customizations after calling base.OnModelCreating(builder); 

builder.Entity<ApplicationUser>() 

.HasMany(e => e.Claims) 

.WithOne() 

.HasForeignKey(e => e.Userld) 

.IsRequired() 

.OnDelete(DeleteBehavior.Cascade)j 

builder.Entity<ApplicationUser>() 

.HasMany(e => e.Logins) 

.WithOne() 

.HasForeignKey(e => e.Userld) 

.IsRequired() 

.OnDelete(DeleteBehavior.Cascade)j 

builder.Entity<ApplicationUser>() 

.HasMany(e => e.Roles) 

.WithOne() 

.HasForeignKey(e => e.Userld) 

.IsRequired() 

.OnDelete(DeleteBehavior.Cascade)j 

} 


GetExternalAuthenticationSchemes değiştirin 

Zaman uyumlu yöntem GetExternaiAuthenticationSchemes yerine zaman uyumsuz bir sürümü kaldırıldı. 1 .x 
projelerini olmayan aşağıdaki kodu ControUers/ManageCorıtroller.cs: 

var otherLogins = _signInManager.GetExternalAuthenticationSchemes().Where(auth => userLogins.All(ul => 
auth.AuthenticationScheme != ul.LoginProvider)).ToList()j 


Bu yöntem görünür Views/Account/Log'm.cshtml çok: 










@{ 

var loginProviders = SignInManager.GetExternalAuthenticationSchemes().ToList(); 
if (loginProviders.Count == 0) 

{ 

<div> 

<P> 

There are no external authentication Services configured. See <a 
href="https://go.microsoft.com/fwlink/?Linl<ID=532715">this article</a> 

for details on setting up this ASP.NET application to support logging in via external 

Services. 

</p> 

</div> 

} 

else 

{ 

<form asp-controller="Account" asp-action="ExternalLogin" asp-route-returnurl="@ViewData["Returnllrl"]" 
method="post" elass="form-horizontal"> 

<div> 

<P> 

@foreach (var provider in loginProviders) 

{ 

<button type="submit" class="btn btn-default" name="provider" 
value="@provider.AuthenticationScheme" title="Log in using your (Şprovider.DisplayName 
account">@provider.AuthenticationScheme</button> 

} 

</p> 

</div> 

</form> 

} 

} 


2.0 projelerinde kullanma GetExternalAuthenticationSchemesAsync yöntemi. Değişiklik ManageController.es 
aşağıdaki koda benzer: 

var sehemes = await _signInManager.GetExternalAuthenticationSchemesAsync(); 

var otherLogins = sehemes.Where(auth => userLogins.All(ul => auth.Name != ul.LoginProvider)).ToList(); 
içinde Login.cshtml, AuthenticationScheme erişilebilir özellik foreach döngü değişiklikleri Name: 







var loginProviders = (await SignInManager.GetExternalAuthenticationSchemesAsync()).ToList(); 
if (loginProviders.Count == 0) 

{ 

<div> 

<P> 

There are no external authentication Services configured. See <a 
href="https://go.microsoft.com/fwlink/?Linl<ID=532715">this article</a> 

for details on setting up this ASP.NET application to support logging in via external 

Services. 

</p> 

</div> 

} 

else 

{ 

<form asp-controller="Account" asp-action="ExternalLogin" asp-route-returnurl="@ViewData["ReturnUrl"]" 
method="post" elass="form-horizontal"> 

<div> 

<P> 

@foreach (var provider in loginProviders) 

{ 

<button type="submit" class="btn btn-default" name="provider" value="@provider.Name" 
title="Log in using your @provider.DisplayName account">@provider.DisplayName</button> 

} 

</p> 

</div> 

</form> 

} 

} 


ManageLoginsVievvModel özellik değişikliği 

A ManageLoginsviewModei nesnesi kullanılır ManageLogins eylemi ManageController.es. 1 ,x projelerinde, nesne 's 
otherLogins özelliği döndürme türü iList<AuthenticationDescription> . Bu dönüş türü alma gerektirir 
Microsoft.AspNetCore.Http.Authentication : 

using System.Collections.Generic; 

using Microsoft.AspNetCore.Http.Authentication; 

using Microsoft.AspNetCore.Identity; 

namespace AspNetCoreDotNetCorelApp.Models.ManageViewModels 

{ 

public elass ManageLoginsViewModel 

{ 

public IList<UserLoginInfo> CurrentLogins { get; set; } 

public IList<AuthenticationDescription> OtherLogins { get; set; } 

} 

} 


Dönüş türü değişikliklerini 2.0 projelerinde 

IList<AuthenticationScheme> 

. Bu yeni dönüş türünü değiştirme 

gerektirir 

Microsoft.AspNetCore.Http.Authentication 

ile içeri aktarma bir 

Microsoft.AspNetCore.Authentication 


içeri aktarın. 







using System.Collections.Generic; 

using Microsoft.AspNetCore.Authentication; 

using Microsoft.AspNetCore.Identity; 

namespace AspNetCoreDotNetCore2App.Models.ManageViewModels 

{ 

public class ManageLoginsViewModel 

{ 

public IList<UserLoginInfo> CurrentLogins { get; set; } 
public IList<AuthenticationScheme> OtherLogins { get; set; } 

} 

} 


Ek kaynaklar 

Daha fazla bilgi için Auth 2.0 için tartışma github'da sorun. 



ASPNET 'den ASPNET Core 'e geçiş 

4.12.2019 • 11 minutes to read • Edit Online 


ile Isaac Levi tarafından 

Bu makale, AS P.N ET uygulamalarının AS P.N ET Core geçişine yönelik bir başvuru kılavuzu görevi görür. 

Prerequisites 

.NET core SDK 2.2 veya üzeri 

Hedef çerçeveler 

ASP.NET Core projeler, geliştiricilere .NET Core, .NET Framework veya her ikisinin de hedeflenme esnekliği sunar. 
En uygun hedef Framevvork 'ü belirlemek için, bkz. sunucu uygulamaları için .NET Core ve .NET Framevvork 
arasından seçim yapma . 

.NET Framevvork hedeflenirken, projelerin ayrı NuGet paketlerine başvurması gerekir. 

.NET Core 'u hedeflemek, ASP.NET Core metapackagesayesinde çok sayıda açık paket başvurularını ortadan 
kaldırmanıza olanak tanır. Microsoft.AspNetcore.App metapackage'i projenize yükler: 

<ItemGroup> 

<PackageReference Include="Microsoft.AspNetcore.App" /> 

</ItemGroup> 

Metapackage kullanıldığında, metapackage içinde başvurulan hiçbir paket uygulamayla birlikte dağıtılır..NET Core 
çalışma zamanı deposu bu varlıkları içerir ve performansı artırmak için önceden ön derlenmiş hale getiriyoruz. 
Daha fazla ayrıntı için bkz. Microsoft. AspNetCore. app metapackage ASP.NET Core . 

Proje yapısı farkları 

. Csproj dosya biçimi AS P.N ET Core basitleştirilmiştir. Bazı önemli değişiklikler şunları içerir: 

• Dosyaların açıkça eklenmesi, projenin bir parçası olarak kabul edilmesi için gerekli değildir. Bu, büyük ekipler 
üzerinde çalışırken XML birleştirme çakışmalarının riskini azaltır. 

• Diğer projelere GUID tabanlı başvurular yoktur ve bu da dosya okunabilirliğini geliştirir. 


• Dosya Visual Studio 'da kaldırmadan düzenlenebilir: 
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Global. asax dosyası değiştirme 

ASP.NET Core, bir uygulamayı önyüklemeden yeni bir mekanizma getirmiştir. ASP.NET uygulamaları için giriş 
noktası Global. asax dosyasıdır. Rota yapılandırması ve filtre ve alan kayıtları gibi görevler, Global. asax dosyasında 
işlenir. 

public class MvcApplication : System.Web.HttpApplication 

{ 

protected void Application_Start() 

{ 

AreaRegistration.RegisterAllAreas(); 

FilterConfig. RegisterGlobalFn.lt er s (GlobalFilters. Filters); 

RouteConfig.RegisterRoutes(RouteTable.Routes); 

BundleConfig. RegisterBundles(BundleTable.Bundles); 

} 

} 

Bu yaklaşım, uygulamayı ve dağıtıldığı sunucuyu uygulamayı kesintiye uğratan bir şekilde bağar. Bağımsız olarak, 
Owin , birden çok çerçeveyi birlikte kullanmanın bir temizleyici yolunu sağlamak için sunulmuştur. OWIN yalnızca 
gereken modülleri eklemek için bir işlem hattı sağlar. Barındırma ortamı, hizmetleri ve uygulamanın istek ardışık 
düzenini yapılandırmak için bir Başlangıç işlevi alır, startup uygulamayla bir ara yazılım kümesini kaydeder. Her 
istek için, uygulama bir ara yazılım bileşeninin her birini bağlantılı listenin baş işaretçisi ile mevcut bir işleyici 
kümesine çağırır. Her bir ara yazılım bileşeni, istek işleme ardışık düzenine bir veya daha fazla işleyici ekleyebilir. Bu, 
listenin yeni başlığı olan işleyiciye bir başvuru döndürülerek gerçekleştirilir. Her işleyici, listedeki bir sonraki 
işleyiciyi hatırlayıp çağırmaktan sorumludur. ASP.NET Core, bir uygulamaya giriş noktası startup ve artık Global. 
asax‘ a bağımlılığı yoktur. .N ET Framevvork ile OWIN kullanırken, işlem hattı olarak aşağıdaki gibi bir şey kullanın: 








using Owin; 

using System.Web.Http; 

namespace WebApi 

{ 

// Note: By default ali requests go through this OWIN pipeline. Alternatlvely you can turn this off by 
adding an appSetting owin:AutomaticAppStantup with value "false”. 

// With this tunned off you can stili have OWIN apps listening on specific routes by adding routes in 
global.asax file using MapOwinPath or MapOwinRoute extensions on RouteTable.Routes 
public class Startup 
{ 

// Invoked önce at startup to configure your application. 
public void Configuration(IAppBuilder builder) 

{ 

HttpConfiguration config = new HttpConfiguration(); 

config.Routes.MapHttpRoute("Default", "{controller}/{customerID}", new { controller = "Customer"., 
customerlD = RouteParameter.Optional }); 

config.Formatters.XmlFormatter.UseXmlSerializer = true; 
config.Formatters.Remove(config.Formatters.IsonFormatter); 

// config.Formatters.IsonFormatter.UseDataContractlsonSerializer = true; 

builder.UseWebApi(config); 

} 

} 

} 


Bu, varsayılan rotalarınızı yapılandırır ve varsayılan olarak JSON üzerinden XmlSerialization olur.Gerektiğinde bu 
işlem hattına başka bir ara yazılım ekleyin (Yükleme Hizmetleri, yapılandırma ayarları, statik dosyalar vb.). 


ASP.NET Core benzer bir yaklaşım kullanır, ancak girişi işlemek için OWıN 'u kullanmaz. Bunun yerine, Program.es 
Main yöntemi aracılığıyla yapılır (konsol uygulamalarına benzer) ve startup bu şekilde yüklenir. 


using Microsoft.AspNetCore; 
using Microsoft.AspNetCore.Hoşting; 

namespace WebApplication2 

{ 

public class Program 

{ 

public static void Main(string[] args) 

{ 

CreateWebHostBuilder(args).Build().Run(); 

} 


} 


} 


public static IWebHostBuilder CreateWebHostBuilder(string[] args) => 
UebHost.CreateDefaultBuilder(args) 

.UseStartup<Startup>(); 


startup bir Configure yöntemi içermelidir. Configure , işlem hattına gerekli bir ara yazılım ekleyin. Aşağıdaki 
örnekte (varsayılan Web sitesi şablonundan), uzantı yöntemleri işlem hattını aşağıdakiler için desteğiyle 
yapılandırır: 


• Hata sayfaları 

• HTTP katı aktarım güvenliği 

• HTTPS 'y e HTTP yönlendirmesi 

• ASP.NET Core MVC 







public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseMvc(); 


Ana bilgisayar ve uygulama, gelecekte farklı bir platforma geçme esnekliği sağlayan bir şekilde ayrılmış. 


NOTE 

ASP.NET Core başlangıç ve ara yazılım için daha ayrıntılı bir başvuru için bkz. ASP.NET Core 'de başlatma 


Mağaza yapılandırması 

ASP.NET, ayarları depolamayı destekler. Bu ayar, örneğin, uygulamaların dağıtıldığı ortamı desteklemek için 
kullanılır. Genel bir uygulama, Web. config dosyasının <appSettings> bölümünde tüm özel anahtar-değer çiftlerini 
depolandı: 

<appSettings> 

<add key="UserName" value="User" /> 

<add key="Password" value="Password" /> 

</appSettings> 

Uygulamalar, System.configuration ad alanındaki configurationManager.AppSettings koleksiyonunu kullanarak bu 
ayarları okur: 

string userName = System.Web.Configuration.ConfigurationManager.AppSettings["UserName"]; 
string password = System.Web.Configuration.ConfigurationManager.AppSettings["Password"]j 


ASP.NET Core, uygulama için yapılandırma verilerini herhangi bir dosyada depolayıp ara yazılım önyükleme ’nin 
bir parçası olarak yükleyebilir. Proje şablonlarında kullanılan varsayılan dosya appSettings. JSON' dır: 


"Logging": { 

"IncludeScopes": false, 
"LogLevel": { 

"Default": "Debug", 
"System": "Information", 
"Microsoft": "Information" 

} 

}, 

"AppConfiguration": { 
"UserName": "UserName", 
"Password": "Password" 

} 

} 


Bu dosyayı uygulamanızın içindeki bir ıconfiguration örneğine yüklemek Startup .csiçinde yapılır: 










public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 

public IConfiguration Configuration { get; } 

Uygulama, ayarlan almak için configuration 'dan okur: 

string userName = Configuration.GetSection("AppConfiguration")["UserName "]; 
string password = Configuration.GetSection("AppConfiguration")["Password "]; 


Bu şekilde, bu değerlere sahip bir hizmeti yüklemek için bağımlılık ekleme (dı) kullanma gibi işlemleri daha sağlam 
hale getirmek için bu yaklaşımın uzantıları vardır. Dı yaklaşımı, kesin türü belirtilmiş bir yapılandırma nesneleri 
kümesi sağlar. 


// Assume AppConfiguration is a class representing a strongly-typed version of AppConfiguration section 
Services.Configure<AppConfiguration»(Configuration.GetSection("AppConfiguration")); 



Yerel bağımlılığı ekleme 

Büyük, ölçeklenebilir uygulamalar, bileşenlerin ve hizmetlerin gevşek bağlantısı olan önemli bir hedef. Bağımlılık 
ekleme , bunu elde etmek için popüler bir tekniktir ve AS P.N ET Core yerel bir bileşenidir. 

ASP.NET uygulamalarında, geliştiriciler bağımlılık ekleme işlemini uygulamak için bir üçüncü taraf kitaplığı kullanır. 
Bu tür bir kitaplık, Microsoftdüzenleri & uygulamalar tarafından sağlanır. 

Unity ile bağımlılık ekleme ayarlamayı bir örnek, bir unltyContainer sarmalayan iDependencyResolver uygulamadır: 








using Microsoft.Practices.Unity; 
using System; 

using System.Collections.Generic; 
using System.Web.Http.Dependencies; 

public class UnityResolver : IDependencyResolver 

{ 

protected IUnityContainer Container; 

public UnityResolver(IUnityContainer Container) 

{ 

if (Container == null) 

{ 

throw new ArgumentNullException("container"); 

} 

this.Container = Container; 

} 

public object GetService(Type serviceType) 

{ 

try 

{ 

return Container.Resolve(serviceType); 

} 

catch (ResolutionFailedException) 

{ 

return null; 

} 

} 

public IEnumerable<object> GetServices(Type serviceType) 

{ 

try 

{ 

return Container.ResolveAll(serviceType); 

} 

catch (ResolutionFailedException) 

{ 

return new List<object>(); 

} 

} 

public IDependencyScope BeginScope() 

{ 

var child = Container.CreateChildContainer(); 
return new UnityResolver(child); 

} 

public void Dispose() 

{ 

Dispose(true); 

} 

protected Virtual void Dispose(bool disposing) 

{ 

Container. Dispose(); 

} 


unityContainer bir örneğini oluşturun, hizmetinizi kaydedin ve HttpConfiguration bağımlılık çözümleyici 'yi 
Kapsayıcınız için yeni UnityResolver örneğine ayarlayın: 




public static void Register(HttpConfiguration config) 

{ 

var Container = new UnityContainer(); 

Container.RegisterType<IProductRepositoryj ProductRepository>(new HierarchicalLifetimeManager()); 
config.DependencyResolver = new UnityResolver(container); 

// Other Web API configuration not shown. 

} 

Gerektiğinde iProductRepository ekle: 

public class ProductsController : ApiController 

{ 

private IProductRepository _repository; 

public ProductsController(IProductRepository repository) 

{ 

_repository = repository; 

} 

// Other controller methods not shown. 

} 

Bağımlılık ekleme AS P.N ET Core bir parçası olduğundan, hizmetinizi Startup.es configureServices yöntemine 
ekleyebilirsiniz: 

public void ConfigureServices(IServiceCollection Services) 

{ 

// Add application Services. 

Services.AddTransient<IProductRepository , ProductRepository>(); 

} 

Depo, Unity ile doğru olduğu için her yerde eklenebilir. 


NOTE 

Bağımlılık ekleme hakkında daha fazla bilgi için bkz. bağımlılık ekleme. 


Statik dosyaları sunma 

Web geliştirmenin önemli bir bölümü, statik, istemci tarafı varlıkları sunma olanağıdır. Statik dosyaların en yaygın 
örnekleri HTML, CSS, JavaScript ve görüntülerdir. Bu dosyaların, uygulamanın yayınlanan konumuna (veya CDN) 
kaydedilmesi gerekir ve bu dosyalar bir istek tarafından yüklenebilmeleri için başvurulmalıdır. Bu işlem ASP.N ET 
Core değişti. 

ASP.NET ' de statik dosyalar çeşitli dizinlerde depolanır ve görünümlerde başvurulur. 

ASP.NET Core, aksi belirtilmedikçe statik dosyalar "Web root" ( <içerik kökü>/Wwwroot) içinde depolanır. 
Dosyalar, startup.configure"usestaticFiles uzantısı yöntemi çağrılarak istek ardışık düzenine yüklenir: 

public void Configure(IApplicationBuilder app) 

{ 

app.UseStaticFilesf); 

} 








NOTE 

.NET Framevvork hedefliyorsanız, NuGet paketini Microsoft.AspNetcore. 

staticFiles yüklemelisiniz. 


Örneğin, Wwwroot/görüntüler klasöründeki bir görüntü varlığına, 
konumda tarayıcı tarafından erişilebilir. 

http://<app>/images/<imageFileName> gibi bir 

NOTE 

ASP.NET Core içinde statik dosyalar sunma konusunda daha ayrıntılı bir başvuru için bkz. statik dosyalar. 


Çok değerli tanımlama bilgileri 

ASP.NET Core 'de çok değerli tanımlama bilgileri desteklenmez. Değer başına bir tanımlama bilgisi oluşturun. 

Ek kaynaklar 

• Kitaplıkları .N ET Core 'a taşıma 





ASRNET MVC 'den ASRNET Core MVC 'ye geçiş 

23.07.2019 • 13 minutes to read ı Edit Online 


By Rick Anderson, Daniei Roth, Steve Smithve Scott Ade 

Bu makalede, bir ASP.NET MVC projesini ASP.NET Core MVC'ye geçirmeye nasıl başlacağınız gösterilmektedir. 
Sürecinde, ASP.N ET MVC 'den değiştirilen birçok şeyi vurgular.ASP.NET MVC 'den geçiş, birden çok adımlı bir 
işlemdir ve bu makalede ilk kurulum, temel denetleyiciler ve görünümler, statik içerik ve istemci tarafı bağımlılıkları 
ele alınmaktadır. Ek makaleler, birçok ASP.NET MVC projesinde bulunan yapılandırma ve kimlik kodunun 
geçirilmesini kapsar. 


NOTE 

Örneklerdeki sürüm numaraları güncel olmayabilir. Projelerinizi uygun şekilde güncelleştirmeniz gerekebilir. 


Başlatıcı ASP.NET MVC projesi oluşturma 

Yükseltmeyi göstermek için, bir ASP.NET MVC uygulaması oluşturarak başlayacağız. Ad alanı, bir sonraki adımda 
oluşturduğumuz AS P.N ET Core projeyle eşleşmesi için VVebApp 7 adıyla oluşturun. 
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Seçim Çözümün adını VVebApp 7 ile Mı/c5arasında değiştirin. Visual Studio yeni çözüm adını (A7vc5) görüntüler, bu 
da projeyi bir sonraki projeden daha kolay bir şekilde anlatmayı kolaylaştırır. 

ASP.NET Core projesi oluşturma 

Önceki projeyle aynı ada sahip yeni bir boş AS P.N ET Core Web uygulaması oluşturun (VVebApp 7), böylece iki 
projedeki ad alanları eşleşir. Aynı ad alanına sahip olmak, kodu iki proje arasında kopyalamayı kolaylaştırır. Aynı adı 
kullanmak için bu projeyi önceki projeden farklı bir dizinde oluşturmanız gerekir. 
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An empty projea template for creating an ASP.NET 
Core application. This template does not have any 
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Change Authentication 


Authentication No Authentication 


I I Enable Docker Support 


OS: Windows 

Requires Dockcr for Windows 

Docker support can also be enabled later Learn more 


OK 


Cancel 


• Seçim Web uygulaması proje şablonunu kullanarak yeni bir AS P.N ET Core uygulaması oluşturun. Projeyi 
M/eMpp7olarak adlandırın ve bireysel kullanıcı hesaplarınınbir kimlik doğrulama seçeneğini belirleyin. Bu 
uygulamayı Fullaspnetcoreo\arak yeniden adlandırın. Bu projeyi oluşturmak, dönüştürmeye zaman kazandırır. 
Son sonucu görmek veya kodu dönüştürme projesine kopyalamak için, şablon tarafından oluşturulan koda 
bakabilirsiniz. Ayrıca, şablon tarafından oluşturulan projeyle karşılaştırmak için bir dönüştürme adımında takılı 
olduğunuzda da yararlıdır. 

Siteyi MVC kullanacak şekilde yapılandırma 

• .N ET Core 'u hedeflerken, varsayılan olarak Microsoft. AspNetCore. app metapackage öğesine başvurulur. Bu 
paket, MVC uygulamaları tarafından yaygın olarak kullanılan paketleri içerir. .NET Framevvork hedefliyorsanız, 
paket başvurularının proje dosyasında tek tek listelenmesi gerekir. 

• .N ET Core 'u hedeflerken, varsayılan olarak Microsoft. AspNetCore. Ali metapackage öğesine başvurulur. Bu 
paket, MVC uygulamaları tarafından yaygın olarak kullanılan paketleri içerir. .NET Framework hedefliyorsanız, 
paket başvurularının proje dosyasında tek tek listelenmesi gerekir. 

• .N ET Core veya ,N ET Framevvork hedeflenirken, MVC uygulamalarına göre yaygın olarak kullanılan paketler, 
proje dosyasında tek tek listelenir. 

Microsoft.AspNetCore.Mvc ASP.NET Core MVC çerçevesidir. Microsoft.AspNetCore.StaticFiles , Statik dosya 

işleyicisidir. AS P.N ET Core çalışma zamanı Modüler olur ve statik dosyalara (bkz. statik dosyaları) hizmeti 

sağlamak için açıkça oturum açmalısınız. 

• Startup.es dosyasını açın ve kodu aşağıdakiler ile eşleşecek şekilde değiştirin: 


























using Microsoft.AspNetCore.Builder; 
using Microsoft.AspNetCore.Hosting; 
using Microsoft.Extensions.DependencyInjection; 

namespace WebAppl 

{ 

public class Startup 

{ 

// This method gets called by the runtime. Use this method to add Services to the Container. 
// For more information on how to configure your application, visit 
https://go.microsoft.com/fwlink/?LinkID=398940 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services. AddMvc(); 

} 

// This method gets called by the runtime. Use this method to configure the HTTP request 
pipeline. 

public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

app.UseStaticFiles(); 

app.UseMvc(routes => 

{ 

routes.MapRoute( 

name: "default", 

template: "{controller=Home}/{action=Index}/{id?}"); 

}); 

} 

} 

} 


usestaticFiles Genişletme yöntemi statik dosya işleyicisini ekler.Daha önce belirtildiği gibi, ASP.NET çalışma 
zamanı Modüler olur ve statik dosyaları sağlamak için açıkça kabul etmeniz gerekir. useMvc Uzantı yöntemi 
yönlendirme ekler. Daha fazla bilgi için bkz. uygulama başlatma ve yönlendirme. 

Denetleyici ekleme ve görüntüleme 

Bu bölümde, sonraki bölümde geçirebileceğiniz AS P.N ET MVC denetleyicisi ve görünümleri için yer tutucu olarak 
kullanılacak en az bir denetleyici ve görünüm ekleyeceksiniz. 

• Bir Controllers klasörü ekleyin. 

• Controllers klasörüne HomeController.es adlı bir Denetleyici sınıfı ekleyin. 
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• Bir Görünüm klasörü ekleyin. 




• Bir Görünüm/giriş klasörü ekleyin. 



• Views/Home klasörüne lndex. cshtml adlı bir Razor 
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Proje yapısı aşağıda gösterilmiştir: 




















Views/Home/lndex. cshtml dosyasının içeriğini aşağıdakiler ile değiştirin: 

<hl>Hello world!</hl> 


Uygulamayı çalıştırın. 



Daha fazla bilgi için bkz. denetleyiciler ve Görünümler . 

Artık en az çalışma ASP.NET Core projesi olduğuna göre, işlevselliği ASP.NET MVC projesinden geçirmeye 
başlayabiliriz. Aşağıdakileri taşıdık: 

• istemci tarafı içerik (CSS, yazı tipleri ve betikler) 

• denetleyiciler 

• görünümler 

• modeller 

• Paketleme 

• filtreler 

• Oturum açma/kapatma, kimlik (Bu, sonraki öğreticide yapılır.) 

Denetleyiciler ve görünümler 

• Yöntemlerin her birini ASP.NET MVC HomeControiler 'den New HomeControiler öğesine kopyalayın. 














ASP.NET MVC 'de, yerleşik şablonun denetleyici eylem yönteminin dönüş türü ActionResult; ASP.NET 
Core MVC 'de, eylem metotları bunun yerine iActionResuit döndürülür. ActionResult uygular 
iActionResııit , bu nedenle eylem yöntemlerinizi dönüş türünü değiştirmenize gerek yoktur. 

• ASP.NET MVC projesindeki. cshtml, Contact. cshtmlve lndex. cshtml Razor görünüm dosyalarını ASP.NET 
Core projesine kopyalayın. 

• AS P.N ET Core uygulamasını çalıştırın ve her yöntemi test edin. Düzen dosyasını veya stilleri henüz 
geçirmedik, bu nedenle işlenmiş görünümler yalnızca görünüm dosyalarındaki içeriği içerir. About Ve 

Contact görünümleri için Düzen dosyası oluşturulmuş bağlantılar yoktur, bu nedenle bunları tarayıcıdan 
çağırmanız gerekir ( 4492 değerini projenizde kullanılan bağlantı noktası numarasıyla değiştirin). 

o http://localhost:4492/home/about 
o http://localhost:4492/home/contact 



Stil ve menü öğelerinin eksikliğine göz önünde. Sonraki bölümde, gidereceğiz. 

Statik içerik 

AS P.N ET MVC 'nin önceki sürümlerinde, statik içerik Web projesinin kökünden barındırılıyor ve sunucu tarafı 
dosyalarıyla karıştı. ASP.NET Core, statik içerik Wwwroot klasöründe barındırılır. Eski ASP.NET MVC 
uygulamanızdan statik içeriği AS P.N ET Core projenizdeki Wwwroot klasörüne kopyalamak isteyeceksiniz. Bu 
örnek dönüştürmede: 

• Ayrıcalıklı Icon. ico dosyasını eski MVC projesinden ASP.NET Core projesindeki Wwwroot klasörüne 
kopyalayın. 

Eski AS P.N ET MVC projesi, stili için önyükleme kullanır ve önyükleme dosyalarını içerik ve betikler klasörlerinde 
depolar. Eski ASP.NET MVC projesini oluşturan şablon, düzen dosyasında önyükleme öğesine başvurur 
( Görünümler/Shared/_Layout. cshtml). ASP.NET MVC projesindeki Bootstrap.js ve Bootstrap. css dosyalarını yen 
projedeki Wwwroot klasörüne kopyalayabilirsiniz. Bunun yerine, sonraki bölümde CDNs kullanarak önyükleme 
(ve diğer istemci tarafı kitaplıkları) için destek ekleyeceğiz. 

Düzen dosyasını geçirme 

• _Viewstart. cshtml dosyasını eski ASP.NET MVC projesinin Görünümler klasöründen ASP.NET Core 
projesinin Görünümler klasörüne kopyalayın. _Vıewstart. cshtml dosyası ASP.NET Core MVC 'de 
değişmemiştir. 























• Bir Görünüm/paylaşdan klasör oluşturun. 

• Seçim_Viewwimports. cshtml dosyasını Fullaspnetcore MVC projesinin Görünümler klasöründen ASP.NET 
Core projesinin Görünümler klasörüne kopyalayın. _Viewwimports. cshtml dosyasındaki herhangi bir ad 
alanı bildirimini kaldırın. _Viewwimports. cshtml dosyası tüm görünüm dosyaları için ad alanları sağlar ve 
etiket yardı mcılarınıgeti rir. Etiket Yardımcıları yeni düzen dosyasında ku\\aru\ır._Viewwimports. cshtml 
dosyası ASP.NET Core için yenidir. 

• _Layout. cshtml dosyasını eski ASP.NET MVC projesinin Görünümler/paylaşdan klasöründen ASP.NET 
Core projesinin Görünümler/paylaşdan klasörüne kopyalayın. 

_Layout. cshtml dosyasını açın ve aşağıdaki değişiklikleri yapın (tamamlanan kod aşağıda gösterilmiştir): 

• @styies.Render("~/content/css" ) Bootstrap. css ' nin yükleneceği bir <iink> öğeyle değiştirin (aşağıya 
bakın). 

• Kaldırın @Scripts.Render("~/bundles/modernizr") . 

• Çizgiyi açıklama (çizgi ile çevreleyin). @Htmi.Partiai("_LoginPartiai") Daha fazla bilgi için bkz. 

kimlik doğrulaması ve kimliğini ASP.NET Core geçirme 

• @scripts.Render("~/bundies/jquery") Bir <script> öğesiyle değiştirin (aşağıya bakın). 

• @scripts.Render("~/bundies/bootstrap") Bir <script> öğesiyle değiştirin (aşağıya bakın). 

Önyükleme CSS ekleme için değiştirme biçimlendirmesi: 

dink rel="stylesheet" 

href=" https://maxcdn.bootstrapcdn.eom/bootstrap/3.3.7/css/bootstrap.min. css" 

integrity="sha384-BVYİiSIFeKldGm3RAkycuHAHRg320mUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" 

crossorigin="anonymous"> 

JQuery ve Bootstrap JavaScript ekleme için değiştirme biçimlendirmesi: 

<script src="https://code. jquery.com/ jquery-3.3.1.min.js"></script> 

<script src=" https://maxcdn.bootstrapcdn.eom/bootstrap/3.3.7/js/bootstrap.min. js" 

integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnC3A712mCWNIpG9mGCD8wGNIcPD7Txa" 

crossorigin="anonymous"x/script> 


Güncelleştirilmiş_/.oyout. cshtml dosyası aşağıda gösterilmiştir: 


















<!DOCTYPE html> 

<html> 

<head> 

<meta chanset="utf-8" /> 

<meta name="viewport" content="width=device-width, initial-scale=1.0"> 

<title>@ViewBag.Title - My ASP.NET Application</title> 

<link rel="stylesheet" 

href=" https://maxcdn.bootstrapcdn.eom/bootstrap/3.3.7/css/bootstrap.min.css" 

integrity="sha384-BVYİiSIFeKldGm3RAkycuHAHRg320mUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" 

crossorigin="anonymous"> 

</head> 

<body> 

<div class="navbar navbar-inverse navbar-fixed-top"> 

<div class="container"> 

<div class="navbar-header"> 

<button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar- 

collapse"> 

<span class="icon-bar"x/span> 

<span class="icon-bar"x/span> 

<span class="icon-bar"x/span> 

</button> 

@Html.ActionLink("Application name", "Index", "Home", new { area = "" }, new { @class = 
"navbar-brand" }) 

</div> 

<div class="navbar-collapse collapse"> 

<ul class="nav navbar-nav"> 

<li>@Html.Actionl_ink("Home", "Index", "Home")</li> 

<li>@Html .Actionl_ink( "About", "About", "Home")</li> 

<li>@Html .Actionl_ink( "Contact", "Contact", "Home")</li> 

</ul> 

@*@Html.Partial("_LoginPartial")*@ 

</div> 

</div> 

</div> 

<div class="container body-content"> 

@RenderBody() 

<hr /> 

<footer> 

<p>&copy; @DateTime.Now.Year - My ASP.NET Application</p> 

</footer> 

</div> 

<script src="https://code. jquery.com/ jquery-3.3.1.min.js"x/script> 

eseript src=" https://maxcdn.bootstrapcdn.eom/bootstrap/3.3.7/js/bootstrap.min. js" 

integrity="sha384-Tc5IQİb027qvyjSMfHjOMaLkfuWVxZxUPnClA712mCWNIpG9mGCD8wGNIcPD7Txa" 

crossorigin="anonymous"x/script> 

@RenderSection("scripts", required: false) 

</body> 

</html> 


Siteyi tarayıcıda görüntüleyin. Artık beklenen stillerle birlikte doğru şekilde yüklenmelidir. 

• Seçim Yeni düzen dosyasını kullanmayı denemek isteyebilirsiniz. Bu proje için, düzen dosyasını Fullaspnetcore 
projesinden kopyalayabilirsiniz. Yeni düzen dosyası Etiket Yardımcıları kullanır ve başka iyileştirmeler içerir. 

Paketlemeyi ve küçültmeye göre yapılandırma 

Paketleme ve küçültmeye yönelik yapılandırma hakkında daha fazla bilgi için bkz. paketleme ve küçültmeyeyönelik. 

HTTP 500 hatalarını çözme 

Sorunun kaynağı hakkında bilgi içermeyen bir HTTP 500 hata iletisine neden olabilecek birçok sorun vardır. 
Örneğin, views/_Viewwimports. cshtml dosyası projenizde mevcut olmayan bir ad alanı içeriyorsa, bir http 500 



hatasiahrsmiz.ASP.NET Core uygulamalarda varsayılan olarak, useDeveioperExceptionPage uzantı 
iAppiicationBuiider öğesine eklenir ve yapılandırma ge/ışt/rmesırasında yürütülür. Bu, aşağıdaki kodda ayrıntılı 
olarak verilmiştir: 


using Microsoft.AspNetCore. Builder; 
using Microsoft.AspNetCore.Hosting; 
using Microsoft.Extensions.DependencyInjection; 

namespace 1/JebAppl 

{ 

public class Startup 

{ 

// This method gets called by the runtime. Use this method to add Services to the Container. 

// For more information on how to configure your application, visit https://go.microsoft.com/fwlink/? 
LinkID=398940 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services. AddMvc(); 

} 

// This method gets called by the runtime. Use this method to configure the HTTP request pipeline. 
public void Configure(IApplicationBuilder app, IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

app.UseStaticFiles(); 

app.UseMvc(routes => 

{ 

routes.MapRoute( 

name: "default"., 

template: "{controller=Home}/{action=Index}/{id?}"); 

}); 


ASP.NET Core, bir Web uygulamasındaki işlenmemiş özel durumları HTTP 500 hata yanıtlarına dönüştürür. 
Normalde, sunucu hakkında potansiyel olarak hassas bilgilerin açıklanmasını engellemek için bu yanıtlara hata 
ayrıntıları dahil değildir. Daha fazla bilgi için bkz. tanıtıcı hatalarında Geliştirici özel durum sayfasını kullanma . 

Ek kaynaklar 

• ASP.NET Core Blazor giriş 

• ASP.NET Core etiket yardımcıları 







ASRNET Web API 'sinden ASRNET Core 'e geçiş 
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ASP.NET 4. x Web API 'SI, tarayıcılar ve mobil cihazlar dahil olmak üzere çok çeşitli istemcilere ulaşan bir HTTP 
hizmetidir. ASP.N ET Core, ASP.N ET 4. x ' in MVC ve Web API uygulaması modellerini ASP.NET Core MVC olarak 
bilinen daha basit bir programlama modeline ayırır. Bu makalede, ASP.NET 4. x Web API 'sinden ASP.NET Core 
MVC 'ye geçiş yapmak için gereken adımlar gösterilmektedir. 

Görüntüleme veya indirme örnek kodu (nasıl indirileceğini) 

Prerequisites 

• Visual Studio 2019 ile ASP.NET ve web geliştirme iş yükü 

• .NET core SDK 2.2 veya üzeri 


W ARNING 

Visual Studio 2017 kullanıyorsanız bkz dotnet/SDK'sı sorun #3124 Visual Studio ile çalışmayan .NET Core SDK sürümleri 
hakkında bilgi için. 


ASP.NET 4. x Web API projesini inceleyin 

Başlangıç noktası olarak bu makale, ASP.NET Web API 2 İle çalışmayabaşlama bölümünde oluşturulan 
productsapp projesini kullanır. Bu projede, basit bir ASP.NET 4. x Web API projesi aşağıdaki şekilde yapılandırılır. 

Global.asax.cs' de webApiConfig.Register bir çağrı yapılır: 

using System; 

using System.Collections.Generic; 
using System.Linq; 
using System.Web; 
using System.Web.Http; 
using System.Web.Routing; 

namespace ProductsApp 
{ 

public class WebApiApplication : System.Ueb.HttpApplication 
{ 

protected void Application_Start() 

{ 

GlobalConfiguration.Configure(WebApiConfig.Register); 

} 

} 

} 


webApiConfig sınıfı App_Start klasöründe bulunur ve statik bir Register yöntemine sahiptir: 










using System; 

using System.Collections.Generic; 
using System.Linq; 
using System.Web.Http; 

namespace PnoductsApp 

{ 

public static class WebApiConfig 

{ 

public static void Register(HttpConfiguration config) 

{ 

// Web API configuration and Services 

// Web API routes 

config.MapHttpAttributeRoutes(); 

config.Routes.MapHttpRoute( 
name: "DefaultApi ", 

routeTemplate: "api/{controller}/{id }", 
defaults: new { id = RouteParameter.Optional } 

); 

} 

} 

} 


Bu sınıf, proje içinde gerçekten kullanılmasa da öznitelik yönlendirmeyiyapılandırır. Ayrıca, ASP.NET Web API 'SI 
tarafından kullanılan yönlendirme tablosunu da yapılandırır. Bu durumda, ASP.NET 4. x Web API 'SI, {id} isteğe 
bağlı olacak şekilde URL 'Lerin biçim /api/{controiier}/{id} eşleşmesini bekler. 

Productsapp projesi bir denetleyici içerir. Denetleyici ApiControiler devralır ve iki eylem içerir: 






using ProductsApp.Models; 
using System; 

using System.Collections.Genenic; 
using System.Linq; 
using System.Net; 
using System.Web.Http; 

namespace PnoductsApp.Controllers 

{ 

public class ProductsController : ApiControllen 

{ 

Product[] products = new Product[] 

{ 

new Product 

{ 

Id = 1, Name = "Tomato Soup", Category = "Groceries", Price = 1 

b 

new Product 

{ 

Id = 2, Name = "Yo-yo", Category = "Toys", Price = 3.75M 

b 

new Product 

{ 

Id = 3, Name = "Hammer", Category = "Hardware", Price = 16.99M 

} 

b 

public IEnumerable<Product> GetAllProducts() 

{ 

return products; 

} 

public IHttpActionResult GetProduct(int id) 

{ 

var product = products.FirstOrDefault((p) => p.Id == id); 
if (product == null) 

{ 

return NotFound(); 

} 

return Ok(product); 

} 

} 

} 


ProductsController tarafından kullanılan Product modeli basit bir sınıftır: 


namespace ProductsApp.Models 

{ 

public class Product 

{ 

public int Id { get; set; } 
public string Name { get; set; } 
public string Category { get; set; } 
public decimal Price { get; set; } 

} 

} 


Aşağıdaki bölümlerde, Web API projesinin ASP.NET Core MVC 'ye geçişi gösterilmektedir. 

Hedef proje oluştur 

Visual Studio 'da aşağıdaki adımları uygulayın: 


• Visual Studio çözümleri > diğer proje türlerini > Dosya > Yeni > projesi ' ne gidin. Boş çözüm' i seçin ve 




çözümü WebAPIMİgration olarak adlandırın. Tamam düğmesine tıklayın. 

• Varolan Productsapp projesini çözüme ekleyin. 

• Çözüme yeni bir ASP.N ET Core Web uygulaması projesi ekleyin. Açılan listeden .N ET Core hedef 
çerçevesini seçin ve API proje şablonunu seçin. Projeyi Productscoreo\arak adlandırın ve Tamam düğmesine 
tıklayın. 

Çözüm artık iki proje içerir. Aşağıdaki bölümlerde Productsapp projesinin İçeriğinin productscore projesine 
geçirilmesi açıklanmaktadır. 

Yapılandırmayı geçir 

ASP.NET Core, App_Start klasörünü veya Global. asax dosyasını kullanmaz ve Web. conflg dosyası yayımlama 
zamanında eklenir. Startup.es , Global. asax 'in yerini alır ve proje kökünde bulunur, startup sınıfı tüm uygulama 
başlangıç görevlerini işler. Daha fazla bilgi için bkz. ASP.NET Core 'de uygulama başlatma. 

ASP.NET Core MVC 'de, UseMvc startup.configure çağrıldığında öznitelik yönlendirme varsayılan olarak dahil 
edilir. Aşağıdaki UseMvc çağrısı Productsapp projesinin App_Start/webaplconflg.cs dosyasını değiştirir: 

public void Configure(IApplicationBuilder appj IHostingEnvironment env) 

{ 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 

} 

else 

{ 

app.UseHsts(); 

} 

app.UseHttpsRedirection(); 
app.UseMvc(); 

} 


Modelleri ve denetleyicileri geçirme 

Productapp projesinin denetleyicisi ve kullandığı model üzerine kopyalayın. Aşağıdaki adımları uygulayın: 

1. Denetleyiciyi/ProductsController. cs öğesini özgün projeden yeni bir kopyaya kopyalayın. 

2. Tüm modeller klasörünü özgün projeden yeni bir klasöre kopyalayın. 

3. Kopyalanan dosyaların ad alanlarını yeni proje adıyla ( Productscore ) eşleşecek şekilde değiştirin. 
ProductsController.es using ProductsApp.Modeis; ifadesini de ayarlayın. 

Bu noktada, uygulamanın oluşturulması bir dizi derleme hatası ile sonuçlanır.Aşağıdaki bileşenler ASP.NET Core 
mevcut olmadığından hatalar oluşur: 

• ApiController Sinifl 

• System.web.Http ad alanı 

• iHttpActionResuit arabirimi 

Hataları aşağıdaki gibi düzeltir: 

1. Değişiklik ApiController için ControllerBase. controiierBase başvurusunu çözümlemek için 

using Microsoft.AspNetCore.Mvc; ekleyin. 

2. using System.Web.Http; klasörünü silin. 

3. GetProduct eyleminin dönüş türünü İHttpActionResuit ActionResult<Product> olarak değiştirin. 












GetProduct eyleminin return ifadesini aşağıdaki şekilde kolaylaştırın: 


return product; 


Yönlendirmeyi yapılandırma 

Yönlendirmeyi aşağıdaki şekilde yapılandırın: 

1. ProductsController sınıfını aşağıdaki özniteliklerle işaretleyin: 

[Route("api/[controller]")] 

[ApiController] 

Yukarıdaki [Route] özniteliği denetleyicinin öznitelik yönlendirme modelini yapılandırır. [ApiController] 
özniteliği, bu denetleyicideki tüm eylemler için öznitelik yönlendirmesini zorunlu kılar. 

Öznitelik yönlendirme [controiler] ve [action] gibi belirteçleri destekler. Çalışma zamanında, her 
belirteç, sırasıyla özniteliğin uygulandığı denetleyicinin veya eylemin adı ile değiştirilmiştir. Belirteçler, 
projedeki sihirli dize sayısını azaltır. Belirteçler Ayrıca otomatik yeniden adlandırma yeniden düzenlemeler 
uygulandığında, yolların karşılık gelen denetleyiciler ve eylemlerle eşitlenmiş durumda kalmasını da 
güvence altına aldığından emin olun. 

2. Projenin uyumluluk modunu ASP.NET Core 2,2 olarak ayarlayın: 

public void ConfigureServices(IServiceCollection Services) 

{ 

Services. AddMvc() 

.SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 

} 

Önceki değişiklik: 

• , [ApiController] özniteliğini denetleyici düzeyinde kullanmak için gereklidir. 

• ASP.NET Core 2,2 1 de ortaya çıkan davranışlardan oluşan davranışa izin verebilir. 

3. Productcontroller eylemlere HTTP Get isteklerini etkinleştirin: 

• GetAiiProducts eylemine [HttpGet] özniteliğini uygulayın. 

• GetProduct eylemine [HttpGet("{id}")] özniteliğini uygulayın. 


Önceki değişiklikler ve kullanılmayan using deyimlerinin kaldırılması sonrasında ProductsController.es dosyası 
şuna benzer: 











using System.Collections.Generic; 
using System.Linq; 
using Microsoft.AspNetCore.Mvc; 
using ProductsCore.Models; 

namespace ProductsCore.Controllers 
{ 

[Route("api/[controller]") ] 

[ApiController] 

public class ProductsController : ControllerBase 
{ 

Product[] products = new Product[] 

{ 

new Product 
{ 

Id = 1, Name = "Tomato Soup", Category = "Groceries", Price = 1 

}, 

new Product 
{ 

Id = 2, Name = "Yo-yo", Category = "Toys", Price = 3.75M 

L 

new Product 
{ 

Id = 3, Name = "Hammer", Category = "Hardware", Price = 16.99M 

} 

}; 

[HttpGet] 

public IEnumerable<Product> GetAllProducts() 

{ 

return products; 

} 

[HttpGet("{id}")] 

public ActionResult<Product> GetProduct(int id) 

{ 

var product = products.FirstOrDefault((p) => p.Id == id); 
if (product == null) 

{ 

return NotFound(); 

} 

return product; 

} 

} 

} 

Geçirilen projeyi çalıştırın ve /api/products gidin. Üç ürünün tam bir listesi görüntülenir.konumuna gözatın 
/api/products/ı . ilk ürün görüntülenir. 

Uyumluluk dolgusu 

Microsoft. AspNetCore. Mvc. VVebApiCompatShim kitaplığı, ASP.NET 4. x Web apı projelerini ASP.NET Core 'ye 
taşımak için bir uyumluluk dolgusu sağlar. Uyumluluk dolgusu, ASP.NET 4. x Web API 2 ' den çok sayıda kuralı 
desteklemek için AS P.N ET Core genişletir. Bu belgede daha önce yer alan örnek, uyumluluk dolgunun gereksiz 
olduğu kadar temel bir örnektir. Daha büyük projeler için, uyumluluk dolgunun kullanılması, ASP.NET Core ile 
ASP.NET 4. x Web API 2 arasındaki API boşluğunu geçici olarak köprülemesi için yararlı olabilir. 

Web API 'SI uyumluluk dolgusu, büyük ASP.NET 4. x Web API projelerini ASP.NET Core geçirmeyi desteklemek 
için geçici bir ölçü olarak kullanılmak üzere tasarlanmıştır. Zaman içinde, projelerin uyumluluk dolgusunda 
güvenmek yerine AS P.N ET Core desenler kullanması için güncelleştirilmeleri gerekir. 

Microsoft.AspNetCore.Mvc.webApiCompatshim eklenen uyumluluk özellikleri şunlardır: 






• Denetleyicilerin temel türlerinin güncelleştirilmesine gerek kalmaması için ApiControiler bir tür ekler. 

• Web API stili model bağlamayı etkinleştirilir.ASP.N ET Core MVC modeli bağlama işlevleri, varsayılan olarak 
ASP.NET 4. x MVC 5 1 in benzer şekilde. Uyumluluk dolgusu model bağlamasını ASP.NET 4. x Web API 2 
model bağlama kurallarına benzer olacak şekilde değiştirir. Örneğin, karmaşık türler, istek gövdesinden 
otomatik olarak bağlanır. 

• Denetleyici eylemlerinin HttpRequestMessage türünde parametreler alması için model bağlamayı genişletir. 

• Eylemlerin HttpResponseMessage sonuçları döndürmesini sağlayan ileti biçimleri ekler. 

• Web API 2 eylemlerinin yanıtları karşılamak için kullanmış olabileceği ek yanıt yöntemleri ekler: 
o HttpResponseMessage üreteçleri: 

o 

o 

o Eylem sonucu yöntemleri: 

o BadRequestErrorMessageResult 
o ExceptionResıılt 
o InternalServerErrorResult 
o InvalidModelStateResult 
o NegotiatedContentResult 
o ResponseMessageResult 

• Uygulamanın bağımlılık ekleme (dı) kapsayıcısına bir ıcontentNegotiator örneği ekler ve Microsoft. Aspnet. 

n türleri kullanılabilir hale getirir. Bu tür türlere örnek olarak 
verilebilir. 

Uyumluluk Shim 'yi kullanmak için: 

1. Microsoft. AspNetCore. Mvc. VVebApiCompatShim NuGet paketini yükler. 

2. Startup.ConfigureServices'' Services.AddMvc() .AddWebApiConventions() çağırarak, uyumluluk dolgunun 
hizmetlerini uygulamanın dı kapsayıcısına kaydedin. 

3. Uygulamanın iAppiicationBuiider.useMvc çağrısında iRouteBuiider MapiJebApiRoute kullanarak Web AP l'sine 
özgü yollar tanımlayın. 

Ek kaynaklar 

• ASP.NET Core ile Web API 'Leri oluşturma 

• ASP.NET Core Web API 'sindeki denetleyici eylemi dönüş türleri 

• ASP.NET Core MVC için uyumluluk sürümü 


VVebApı. Clıentöğesınden içerik anlaşmasına ilişki 
DefaultContentNegotiator ve MediaTypeFormatter 


CreateResponse<T> 

CreateErrorResponse 
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Önceki makalede, bir ASP.NET MVC projesini ASP.NET Core MVC 'ye geçirmeyebaşladık. Bu makalede, 
yapılandırmayı geçiririz. 

Örnek kodu görüntüleme veya indirme (nasıl indirileceği) 

Kurulum yapılandırması 

AS P.N ET Core artık önceki AS P.N ET sürümleri tarafından kullanılan Global. asax ve Web. conflg dosyalarını 
kullanmaz. Önceki ASP.NET sürümlerinde, uygulama başlangıç mantığı Global. osoxiçindeki bir 
Appiication_startup metoduna yerleştirildi. Daha sonra, AS P.N ET MVC 'de projenin köküne bir Startup.es dosyası 
eklenmiştir; ve uygulama başlatıldığında çağırılır. AS P.N ET Core, tüm başlangıç mantığını Startup.es dosyasına 
yerleştirerek bu yaklaşımı tamamen benimsemiştir. 

Web. config dosyası da ASP.NET Core değiştirilmiştir. Yapılandırma, Sfortup.csbölümünde açıklanan uygulama 
başlatma yordamının bir parçası olarak artık yapılandırılabilir. Yapılandırma XML dosyalarını kullanmaya devam 
edebilir, ancak genellikle AS P.N ET Core projeler yapılandırma değerlerini appSettings. VSOA/gibi JSON biçimli bir 
dosyaya yerleştirir. AS P.N ET Core yapılandırma sistemi, ortama özgü değerler için daha güvenli ve sağlam bir 
konum sağlayabilen ortam değişkenlerine de kolayca erişebilir. Bu, kaynak denetimine denetlenmemelidir bağlantı 
dizeleri ve API anahtarları gibi gizli diziler için özellikle doğrudur. ASP.NET Core yapılandırma hakkında daha fazla 
bilgi için bkz. yapılandırma . 

Bu makalede, önceki makaledenkısmen geçirilmiş ASP.NET Core projesi ile başlıyoruz. Yapılandırmayı ayarlamak 
için, aşağıdaki oluşturucuyu ve özelliğini projenin kökünde bulunan Startup.es dosyasına ekleyin: 

public Startup(IConfiguration configuration) 

{ 

Configuration = configuration; 

} 


public IConfiguration Configuration { get; } 


Bu noktada, Startup.es dosyasının derlenmeyeceğini, ancak yine de aşağıdaki 
gerektiğini unutmayın: 

using 

ifadesini eklememiz 

using Microsoft.Extensions.Configuration; 


Uygun öğe şablonunu kullanarak projenin köküne bir appSettings. JSON dosyası ekleyin: 
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Adıl Cancet 


Web. config dosyasından yapılandırma ayarlarını geçirme 

ASP.NET MVC projemiz, Web. config dosyasına gerekli veritabanı bağlantı dizesini <connectionstrings> öğesinde 
içeriyordu. ASP.NET Core projemizdeki bu bilgileri appSettings. JSON dosyasında depolayacağız. AppSettings. 
JSON' u açın ve bunun zaten aşağıdakileri içerdiğini unutmayın: 

{ 

"Data": { 

"DefaultConnection": { 

"ConnectionString": "Server=(localdb)\\MSSQLLocalDBjDatabase=_CHANGE_ME;Trusted_Connection=Tr'ue;" 

} 

} 

} 

Yukarıda gösterilen vurgulanan satırda veritabanının adını _Change_me konumundan veritabanınızın adına 
değiştirin. 

Özet 

ASP.NET Core, uygulamanın tüm başlangıç mantığını, gerekli hizmetlerin ve bağımlılıkların tanımlanmasının ve 
yapılandırılabileceği tek bir dosyaya koyar. Web. config dosyasını, JSON gibi çeşitli dosya biçimlerinden ve ortam 
değişkenlerinin yanı sıra, çeşitli dosya biçimlerinden faydalanabilir bir esnek yapılandırma özelliği ile değiştirir. 
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Önceki makalede, yapılandırmayı ASP.NET Core MVC 'ye bir ASP.NET MVC projesinden geçirdik. Bu makalede, 
kayıt, oturum açma ve Kullanıcı yönetimi özelliklerini geçiririz. 

Kimliği ve üyeliği yapılandırma 

AS P.N ET MVC 'de, kimlik doğrulama ve kimlik özellikleri App_Start klasöründe bulunan Startup.auth.es ve 
ldentityConfig.es' deASP.NET Identity kullamlarakyapilandirilir.ASP.NET Core MVC 'de, bu özellikler Startup.es' 
de yapılandırılır. 

Microsoft.AspNetCore.Identity.EntityFrameworkCore Ve Microsoft.AspNetCore.Authentication.Cookies NuGet 
paketlerini yükler. 

Ardından, Startup.es açın ve Entity Framevvork ve startup.configureServices kimlik hizmetlerini kullanmak için 
yöntemi güncelleştirin: 

public void ConfigureServices(IServiceCollection Services) 

{ 

// Add EF Services to the Services Container. 

Services.AddDbContext<ApplicationDbContext>(options => 

options. UseSqlServer(Configuration .GetConnectionSt ring ("Def aultConnect ion"))); 

Services.Addldentity<Applicationllser, IdentityRole>() 

.AddEntityFrameworkStores<ApplicationDbContext>() 

.AddDefaultTokenProviders(); 

Services .AddMvc(); 

} 

Bu noktada, yukarıdaki kodda henüz AS P.N ET MVC projesinden geçirdiğimiz iki tür vardır: 

AppücationDbContext ve. Appiicationuser ASP.NET Core projesinde yeni modeller klasörü oluşturun ve bu 
türlere karşılık gelen kendisine iki sınıf ekleyin. Bu sınıfların ASP.NET MVC sürümlerini 

/models/Ldentitymodels.cs\çr\de bulacaksınız, ancak geçirilen projede sınıf başına bir dosya kullanacağız çünkü 
bu daha net bir şekilde yapılır. 

ApplicationUser.es: 

using Microsoft.AspNetCore.Identity.EntityFrameworkCore; 

namespace NewMvcProject.Models 
{ 

public elass Appiicationuser : IdentityLIser 
{ 

} 

} 


ApplicationDbContext.cs: 











using Microsoft.AspNetCore.Identity.EntityFrameworkCore; 
using Microsoft.Data.Entity; 

namespace NewMvcProject.Models 

{ 

public class ApplicationDbContext : IdentityDbContext<ApplicationUser> 

{ 

public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options) 

: base(options) 

{ 

} 

protected override void OnModelCreating(ModelBuilder builder) 

{ 

base.OnModelCreating(builder); 

// Customize the ASP.NET Core Identity model and override the defaults if needed. 

// For example, you can rename the ASP.NET Core Identity table names and more. 

// Add your customizations after calling base.OnModelCreating(builder); 

} 

} 

} 

ASP.NET Core MVC Başlatıcı Web projesi, kullanıcıların çok fazla özelleştirmesini veya AppiicationDbContext 1 i 
içermez. Gerçek bir uygulamayı geçirirken uygulamanızın kullanıcı ve DbContext sınıflarının tüm özel özelliklerini 
ve yöntemlerini, uygulamanızın de tüm diğer model sınıflarını geçirmeniz gerekir. Örneğin DbContext Albüm , 
varsa, sınıfı geçirmeniz gerekir. DbSet<Aibum> 

Bu dosyalar söz konusu olduğunda, Startup.es dosyası using deyimlerini güncelleştirerek derleme yapmak için 
kullanılabilir: 


using Microsoft.AspNetCore.Builder; 

using Microsoft.AspNetCore.Identity; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.EntityFrameworkCore; 

using Microsoft.Extensions.Configuration; 

using Microsoft.Extensions.DependencyInjection; 


Uygulamamız artık kimlik doğrulama ve kimlik hizmetlerini desteklemeye hazırdır. Yalnızca bu özelliklerin 
kullanıcılara açık olması gerekir. 

Kayıt ve oturum açma mantığını geçirme 

Uygulama için yapılandırılmış kimlik hizmetleri ve Entity Framework ve SQL Server kullanılarak yapılandırılan 
veri erişimi sayesinde, kayıt ve uygulamaya oturum açma desteği eklemeye hazırız. Daha önce geçiş sürecinde, 
_Layout. cshtmi\ç\nde_logirıpartial öğesine bir başvuru yorumlayacağız. Artık bu koda geri dönmeli, bu kodun 
açıklamasını kaldırın ve oturum açma işlevlerini desteklemek için gerekli denetleyiciler ve görünümlerde ekleme 
zamanı vardır. 

_Layout. csfrfm/içindeki satırınaçıklamasınıkaldırın: @Html.Pantiai 

<li>@Html.ActionLink("Contact"j "Contact", "Home")</li> 

</ul> 

@*@Html.Partial("_LoginPartial")*@ 

</div> 

</div> 


Şimdi Görünümler/paylaşdan klasöre _loginpartial adlı yeni bir Razor görünümü ekleyin: 
_Loginpartial. cshtml dosyasını aşağıdaki kodla güncelleştirin (tüm içeriğini değiştirin): 











(Şinject SignInManager<ApplicationUser> SignlnManagen 
@inject Userr / lanag0r<ApplicationUser> UserManager 

Şif (SignlnManager.IsSignedln(User)) 

{ 

<form asp-area="" asp-controller="Account" asp-action="Logout" method="post" id="logoutForm" 
class="navbar-right"> 

<ul class="nav navbar-nav navbar-right"> 

<li> 

<a asp-area="" asp-contnoller="Manage" asp-action="Index" title="Manage">Hello 
@UserManager.GetUserNam0(User)!</a> 

</li> 

<li> 

<button typ0="submit" class="btn btn-link navbar-btn navbar-link">Log out</button> 
</li> 

</ul> 

</form> 

} 

0İS0 

{ 

<ul class="nav navbar-nav navbar-right"> 

<lixa asp-ar0a="" asp-controlİ0r="Account" asp-action="R0gist0r">R0gist0r</ax/li> 

<lixa asp-ar0a="" asp-controlİ0r="Account" asp-action="Login">Log in</ax/li> 

</ul> 

} 


Bu noktada, tarayıcıda siteyi yenileyebilmelisiniz. 

Özet 

ASP.NET Core, ASP.NET Identity özelliklerinde yapılan değişiklikleri tanıtır.Bu makalede, ASP.NET Identity 
kimlik doğrulaması ve Kullanıcı Yönetimi özelliklerinin ASP.NET Core 'ye nasıl geçirileceğiyle karşılaşmış 
olursunuz. 



ClaimsPrincipal. Current öğesinden geçir 
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ASP.NET 4. x projelerinde, geçerli kimliği doğrulanmış kullanıcının kimliğini ve taleplerini almak için 
ClaimsPrincipal. Current kullanımı yaygındır. ASP.NET Core, bu özellik artık ayarlı değildir. Kendisine bağlı olan 
kodun, geçerli kimliği doğrulanmış kullanıcının kimliğini farklı yollarla alması için güncelleştirilmesi gerekir. 

Statik veriler yerine içeriğe özgü veriler 

ASP.NET Core kullanırken, hem ClaimsPrincipal.current hem de Thread.currentPrincipai değerleri ayarlı 
değildir. Bu özelliklerin her ikisi de AS P.N ET Core genellikle kaçınan statik durumu temsil eder. Bunun yerine, 
ASP.NET Core mimarisi, bağlama özgü hizmet koleksiyonlarından (geçerli kullanıcının kimliği gibi) bağımlılıkları ( 
bağımlılık ekleme (dı) modelini kullanarak) almak. Ayrıca, iş parçacığı statik olan Thread.currentPrincipai , bazı 
zaman uyumsuz senaryolarda değişiklikleri kalıcı hale getiremeyebilir (ve ClaimsPrincipal.current yalnızca 
varsayılan olarak Thread.currentPrincipai çağırır). 

Statik üyelerin zaman uyumsuz senaryolarda neden olabileceği sorun sayısını anlamak için aşağıdaki kod 
parçacığını göz önünde bulundurun: 

// Create a ClaimsPrincipal and set Thread.currentPrincipai 
var identity = new Claimsldentity(); 

identity.AddClaim(new Claim(ClaimTypes.Name., "Userl")); 

Thread.currentPrincipai = new ClaimsPrincipal(identity); 

// Check the current user 

Console.WriteLine($"Current user: (Thread.currentPrincipai?.identity.Name}"); 

// For the method to complete asynchronously 
await Task.Yield(); 

// Check the current user after 

Console.WriteLine($"Current user: (Thread.currentPrincipai?.identity.Name}"); 

Önceki örnek kod Thread.currentPrincipai ayarlar ve zaman uyumsuz bir çağrıyı beklerken önce ve sonra değerini 
denetler. Thread.currentPrincipai , ayarlandığı iş parçacığına özgüdür ve Yöntem await 'dan sonra farklı bir iş 
parçacığında yürütmeyi sürdürülemez. Sonuç olarak, Thread.currentPrincipai ilk kez denetlendiğinde, ancak 
await Task.Yieid() çağrısından sonra null olduğunda vardır. 

Test kimlikleri kolay bir şekilde eklenebilir olduğundan, geçerli kullanıcının kimliğini uygulamanın dı hizmeti 
koleksiyonundan almak daha kararlı değildir. 

ASP.NET Core uygulamasındaki geçerli kullanıcıyı alma 

Geçerli kimliği doğrulanmış kullanıcının ClaimsPrincipal ClaimsPrincipal.current yerine ASP.NET Core almak için 
birkaç seçenek vardır: 

• ControllerBase. User. MVC denetleyicileri, geçerli kimliği doğrulanmış kullanıcıya Kullanıcı özelliği ile 
erişebilir. 

• HttpContext. User. Geçerli HttpContext erişimi olan bileşenler (örneğin, ara yazılım) geçerli kullanıcının 
ClaimsPrincipal HttpContext. Useröğesinden alabilir. 

• Çağırandan geçirildi. Geçerli HttpContext erişimi olmayan kitaplıklar genellikle denetleyiciler veya ara 



















yazılım bileşenlerinden çağırılır ve geçerli kullanıcının kimliği bir bağımsız değişken olarak geçirilebilir. 

• lhttpcontextaccessor. ASP.NET Core geçirilecek proje, geçerli kullanıcının kimliğini tüm gerekli konumlara 
kolayca geçiremeyecek kadar büyük olabilir. Bu gibi durumlarda, ıhttpcontextaccessor geçici çözüm olarak 
kullanılabilir. iHttpContextAccessor geçerli HttpContext erişebilir (varsa). Eğer, kullanılıyorsa bkz. ASP.NET 
Core 'de HttpContext 'e erişme. Geçerli kullanıcının kimliğini, ASP.NET Core dı odaklı mimarisiyle çalışacak 
şekilde güncelleştirilmemiş kodda almaya yönelik kısa süreli bir çözüm şu şekilde olacaktır: 

o startup.configureServices içinde Addhttpcontextaccessor 'ı çağırarak Dİ kapsayıcısında 
mttpContextAccessor kullanılabilir hale getirin. 

o Başlatma sırasında iHttpContextAccessor bir örneğini alın ve statik bir değişkende depolayın. Örnek, 
daha önce geçerli kullanıcıyı statik bir özellikten alan kod için kullanılabilir hale getirilir, 
o HttpContextAccessor.HttpContext?.User kullanarak geçerli kullanıcının ClaimsPrincipal alın. Bu kod bir 
HTTP isteği bağlamı dışında kullanılırsa HttpContext null olur. 

Statik bir değişkende depolanan bir iHttpContextAccessor örneğini kullanan son seçenek, ASP.NET Core ilkelerine 
karşı (statik bağımlılıklara eklenen bağımlılıklar tercih edilir). Bunun yerine bağımlılık ekleme işleminden sonunda 
iHttpContextAccessor örnekleri almayı planlayın. Statik bir yardımcı, daha önce ClaimsPrincipal.current kullanan 
büyük var olan ASP.NET uygulamalarını geçirirken yararlı bir köprü olabilir. 










ASPNET üyelik kimlik doğrulamasını ASRNET Core 2.0 
Identity'ye geçirme 
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Tarafından Isaac Levin 

Bu makalede, ASP.NET Core 2.0 kimliği için üyelik kimlik doğrulaması kullanarak ASP.NET uygulamaları için 
veritabanı şemasını geçirme gösterilmektedir. 


NOTE 

Bu belge, veritabanı şemasını ASP.NET üyelik tabanlı uygulamalar için ASP.NET Core kimliği için kullanılan veritabanı şemasını 
geçirmek için gerekli olan adımları sağlar. ASP.NET üyelik tabanlı kimlik doğrulamasını ASP.NET Identity'ye geçirme hakkında 
daha fazla bilgi için bkz. mevcut bir uygulamayı SQL üyeliğinden ASP.NET Identity'ye geçirme. ASP.NET Core kimliği hakkında 
daha fazla bilgi için bkz: ASP.NET Core kimliği giriş. 


Üyelik şeması gözden geçirme 

ASP.NET 2.0 önce geliştiricilerin uygulamalarını tüm kimlik doğrulama ve yetkilendirme işlemi oluşturmaya 
görevli. AS P.N ET 2.0 ile AS P.N ET uygulamaları içinde güvenlik işlemek için ortak bir çözüm sağlayarak üyelik 
sunulmuştur. Geliştiriciler ile bir SQL Server veritabanına bir şema bootstrap için artık aspnet_regsql.exe komutu. 
Bu komutu çalıştırdıktan sonra aşağıdaki tablolarda veritabanında oluşturulmuş. 

Q S membership 

@ I Database Diagrams 
0 1 1 1 

0 t System Tables 
0 f FileTables 
0 I External Tables 
0 Graph Tables 
0 ES dbo.aspnet_Applications 
0 §1 dbo.aspnet_Membership 
0 ES dbo.aspnet_Paths 
0 ES dbo.aspnet_PersonalizationAIIUsers 
0 ES dbo.aspnet_PersonalizationPerUser 
0 ES dbo.aspnet_Profile 
0 ES dbo.aspnet_Roles 
0 ES dbo.aspnet_SchemaVersions 
0 ES dbo.aspnet_Users 
0 ES dbo.aspnetJJsersInRoles 
0 ES dbo.aspnet_WebEvent_Events 


ASP.NET Core 2.0 kimliği için mevcut uygulamaları geçirmek için bu tablolardaki verilerin yeni kimlik şema 
tarafından kullanılan tablolar için geçirilmesi gerekiyor. 

ASP.NET Core kimlik 2.0 şeması 

ASP.NET Core 2.0 izleyen kimlik ASP.NET 4.5 içinde tanıtılan ilkesi. Uygulama çerçeveleri arasında ilkesini 
paylaşılan olsa bile ASP.NET Core sürümleri arasında farklı (bkz geçirme kimlik doğrulaması ve kimlik için 
ASP.NET Core 2.0). 

ASP.NET Core 2.0 kimliği için şemasını görüntülemek için en hızlı yolu, yeni bir ASP.NET Core 2.0 uygulaması 
oluşturmaktır. Visual Studio 2017'de şu adımları izleyin: 


1. Dosya > Yeni > Proje yi seçin. 









2. Yeni bir ASP.NET Core Web uygulaması adlı proje CoreldentitySample. 

3. Seçin ASP.NET Core 2.0 seçin ve açılan Web uygulaması. Bu şablon üreten bir Razor sayfaları uygulama. 
Tıklatmadan önce Tamam, tıklayın kimlik doğrulamayı Değiştir. 

4. Seçin bireysel kullanıcı hesapları kimlik şablonları. Son olarak, tıklayın Tamam, ardından Tamam. Visual 
Studio, ASP.NET Core kimliği şablonunu kullanarak bir proje oluşturur. 

5. Seçin Araçları > NuGet Paket Yöneticisi > Paket Yöneticisi Konsolu açmak için 
PaketYöneticisiKonsolu (PMC) penceresi 

6 . Proje kök dizininde PMC gidin ve çalıştırma Entity Framevvork (EF) çekirdek Update-Database komutu. 

ASP.NET Core 2.0 kimlik EF Core kimlik doğrulaması veri depolama veritabanı ile etkileşim kurmak için 
kullanır, için yeni oluşturulan bir uygulamanın çalışması için sırayla var. Bu verileri depolamak için bir 
veritabanı olması gerekir. Yeni bir uygulama oluşturduktan sonra bir veritabanı ortam içinde şema incelemek 
için en hızlı yolu kullanarak veritabanını oluşturmak için olan EF Core geçişleri. Bu işlem, bu şema taklit eden 
bir veritabanı, yerel olarak veya başka bir yerde, oluşturur. Daha fazla bilgi için yukarıdaki belgelerini 
inceleyin. 

EF Core komutları belirtilen veritabanı için bağlantı dizesini kullanın appsettings.jsorı. Bir veritabanı bağlantı 
dizesi hedefleyen localhost adlı asp net core kimliği. Bu ayarda EF Core kullanacak şekilde yapılandırılmış 
DefaultConnection bağlantı dizesi. 

{ 

"ConnectionStrings": { 

"DefaultConnection": "Server=localhost;Database=aspnet-core- 
identity;Trusted_Connection=True;MultipleActiveResultSets=true" 

} 

} 


7. Seçin görünümü > SQL Server Nesne Gezgini. Belirtilen veritabanı adı için karşılık gelen düğümünü 

ConnectionStrings:DefaultConnection Özelliği appsettings.json. 

update-Database Komutu oluşturulan şemasıyla belirtilen veritabanı ve uygulama başlatma için gereken tüm 
verileri. Aşağıdaki görüntüde ile önceki adımlarda oluşturulan tablo yapısı gösterilmektedir. 

E) W Corel d entity 

S t Database Diagrams 
B I Tables 

0 System Tables 
0 I FileTables 
0 I External Tables 
0 I Graph Tables 
0 B dbo._EFMigrationsHistory 
0 B dbo.AspNetRoleClaims 
0 B dbo.AspNetRoles 
0 B dbo.AspNetUserCIaims 
0 B dbo.AspNetüserLogins 
0 B dbo.AspNetüserRoles 
0 B dbo.AspNetüsers 
0 B dbo.AspNetüserTokens 


Geçiş şeması 

Tablo yapıları ve alanları üyelik hem de ASP.NET Core kimliği için küçük farklılıklar vardır. Desen, ASP.NET ve 
ASP.NET Core uygulamaları ile kimlik doğrulama/yetkilendirme için önemli ölçüde değişti. Kimlikle hala kullanılan 
anahtar nesneler kutlamalar ve rolleri. Eşleme tablolar için işte kullanLalar, rolleri, ve UserRoles. 


Kullanıcılar 






IDENTITY 

(DBO.ASPN ETUSERS) 


MEMBERSHIP 
(DBO.ASPNET USERS/ 
DBO.ASPNET MEMBERSHIP) 


Alan adı Tür 

id dize 

Alan adı Tür 

aspnet_Users.Userld dize 

UserName dize 

aspnet_Users.UserName dize 

Email dize 

aspnet_Membership.Email dize 


NormalizedUserName dize 

aspnet_Users.LoweredUserName dize 



NormalizedEmail dize 

aspnet_Membership.LoweredEmaidİze 



PhoneNumber dize 

aspnet_Users.MobileAlias dize 



LockoutEnabled bit 

aspnet_Membership. IsLockedOutbİt 


NOTE 

Tüm alan eşlemelerini üyeliğinin bire bir ilişkiler ASP.NET Core kimliği için benzer. Yukarıdaki tabloda, varsayılan üyelik 
kullanıcısı şemasını alır ve ASP.NET Core kimliği şemaya eşler. Üyelik için kullanılan herhangi bir özel alanları el ile eşlenmesi 
gerekir. Bu eşleme nebyla nalezena mapa Pro parolaları, parola ölçütlerini hem parola salts ikisi arasında geçirme gibi bulunur. 

Parola null olarak bırakın ve kullanıcıların parolalarını sıfırlamalarına olanak istemeniz önerilir. ASP.NET Core kimliği 
içinde LockoutEnd kullanıcıya kilitlenmişse bazı tarih gelecekte ayarlanması gerekir. Bu, geçiş öncesinde bir betik içinde 
gösterilir. 


Rolleri 


KİMLİK 

(DBO. ASPNETROLES) 


ÜYELİK 

(DBO.ASPNET_ R OLES) 


Alan adı 

Tür 

Alan adı 

Tür 

Id 

dize 

Roleld 

dize 

Name 

dize 

RoleName 

dize 





NormalizedName 

dize 

LoweredRoleName 

dize 

Kullanıcı Rolleri 




IDENTITY 


MEMBERSHIP 


(DBO.ASPN ETUSERROLES) 


(DBO.ASPN ET_ U SERSİN ROLES) 


Alan adı 

Tür 

Alan adı 

Tür 

Roleld 

dize 

Roleld 

dize 

Userld 

dize 

Userld 

dize 

























Önceki eşleme tabloları için geçiş betiği oluştururken başvuru kullanıcılar ve rolleri. Aşağıdaki örnek, iki veritabanı 
bir veritabanı sunucusuna sahip olduğunuz varsayılır. Bir veritabanı mevcut ASP.NET üyelik şeması ve verileri içerir. 
Diğer CoreldentitySample daha önce açıklanan adımları kullanarak veritabanı oluşturuldu. Daha fazla ayrıntı için 
eklenen satır içi açıklamalardır. 

-- THIS SCRIPT MEEDS TO RUN FROM THE CONTEXT OF THE MEMBERSHIP DB 
BEGIN TRANSACTION MigrateUsersAndRoles 
USE aspnetdb 

-- INSERT USERS 

INSERT INTO CoreldentitySample.dbo.AspNetUsers 
(id, 

UserName, 

NormalizedUserName, 

PasswordHash, 

SecurityStamp, 

EmailConfirmed, 

PhoneNumber, 

PhoneNumberConfirmed, 

TwoFactorEnabled, 

LockoutEnd, 

LockoutEnabled, 

AccessFailedCount, 

Email, 

NormalizedEmail) 

SELECT aspnetJJsers.Userld, 

aspnet_Users.UserName, 

-- The NormalizedUserName value is upper case in ASP.NET Core Identity 
UPPER(aspnet_Users.UserName), 

-- Creates an empty password since passwords don't map between the 2 schemas 

i 

/* 

The SecurityStamp token is used to verify the State of an account and 
is subject to change at any time. It should be initialized as a new ID. 

*/ 

NewID(), 

/* 

EmailConfirmed is set when a new user is created and confirmed via email. 

Users must have this set during migration to reset passwords. 

*/ 

1, 

aspnet_Users.MobileAlias, 

CASE 

WHEN aspnet_Users.MobileAlias IS NULL THEN 0 
ELSE 1 
END, 

-- 2FA likely wasn't setup in Membership for users, so setting as false. 

0 , 

CASE 

-- Setting lockout date to time in the future (1,000 years) 

WHEN aspnet_Membership.IsLockedOut = 1 THEN Dateadd(year, 1000, 

Sysutcdatetime()) 

ELSE NULL 
END, 

aspnet_Membership.IsLockedOut, 

/* 

AccessFailedAccount is used to track failed logins. This is stored in 
Membership in multiple columns. Setting to 0 arbitrarily. 

V 

0 , 

aspnet_Membership.Email, 

-- The NormalizedEmail value is upper case in ASP.NET Core Identity 
UPPER(aspnet_Membership.Email) 

FROM aspnet_Users 

LEFT OUTER 30IN aspnet_Membership 

ON aspnet_Membership.ApplicationId = 
aspnet Users.Applicationld 


AND aspnet_Users.UserId = aspnet_Membership.UserId 
LEFT OUTER 10IN CoreldentitySample.dbo.AspNetUsers 

ON aspnet_Membership.UserId = AspNetUsers.Id 
IaIHERE AspNetUsers.Id IS NULL 

-- INSERT ROLES 

INSERT INTO CoreldentitySample.dbo.AspNetRoles(Id, Name) 

SELECT Roleld, RoleName 
FROM aspnet_Roles; 

-- INSERT USER ROLES 

INSERT INTO CoreldentitySample.dbo.AspNetUserRoles(UserId, Roleld) 

SELECT Userld, Roleld 
FROM aspnet_UsersInRoles; 

IF @@ERROR o 0 
BEGIN 

ROLLBACK TRANSACTION MigrateUsersAndRoles 
RETURN 
END 

COMMIT TRANSACTION MigrateUsersAndRoles 


Önceki komut tamamlandıktan sonra daha önce oluşturduğunuz ASP.NET Core kimliği uygulama üyelik 
kullanıcılarının ile doldurulur. Kullanıcıların oturum açma önce parolalarını değiştirmesi gerekir. 


NOTE 

Üyelik Sistemi kullanıcılara e-posta adresi ile eşleşmedi kullanıcı adları varsa bunu uygun hale getirmek için daha önce 
oluşturulan uygulama için değişiklik gerekmez. Varsayılan şablonu bekliyor UserName ve Email ile aynı. Bunlar farklı 
durumlar için oturum açma işlemi kullanmak için değiştirilmesi gerektiğinde UserName yerine Email . 


içinde PageModei konumunda bulunan oturum açma sayfasının Pages\Account\Login.cshtml.cs, kaldırma 
[EmailAddress] özniteliğini e-posta özelliği. Yeniden adlandırın UserName. Bu değişikliği gerektiren her yerde 
EmailAddress , içinde açıklanan görünümü ve PageModei. Sonuç aşağıdaki gibi görünür: 


Coreldentity Home About Contact 


Log in 

Use a local account to log in. 


UserName 



Forgot your passvvord? 
Register as a new user 


















Sonraki adımlar 


Bu öğreticide, kullanıcıların SQL üyeliğinden ASP.NET Core 2.0 kimliği için bağlantı noktası öğrendiniz. ASP.NET 
Core kimliği hakkında daha fazla bilgi için bkz. kimliğe giriş. 


ASPNET Core ara yazılıma HTTP işleyicileri ve 
modülleri geçirme 

23.08.2019 • 23 minutes to read ı Edit Online 


Bu makalede , System, vvebserver 'deki mevcut AS P.net http modüllerinin ve işleyicilerinin AS P.N ET Core Ara 
yazılımanasıl geçirileceği gösterilmektedir. 

Modüller ve işleyiciler yeniden ziyaret edildi 

ASP.NET Core ara yazılıma devam etmeden önce, ilk olarak HTTP modüllerinin ve işleyicilerinin nasıl çalıştığını 
görelim: 


Authorization 

Modüle Othermodules 



MVC 

HTTP Handler 


.report 

HTTP Handler 


İşleyiciler şunlardır: 

• IHttpHandler uygulayan sınıflar 

• Verilen bir dosya adına veya uzantıya sahip istekleri işlemek için kullanılır. rapor 

• Web. config 'de yapılandırıldı 

Modüller şunlardır: 

• IHttpModule uygulayan sınıflar 

• Her istek için çağrılır 

• Kısa devre verebilir (bir isteğin daha fazla işlenmesini durdurabilirsiniz) 

• HTTP yanıtına ekleme yapabilir veya kendi kendine oluşturma 

• Web. config 'de yapılandırıldı 

Modüllerin gelen istekleri işleme sırası şu şekilde belirlenir: 

1. AS P.N ET tarafından tetiklenen bir seri olay olan uygulama yaşam döngüsü: BeginRequest, kimlik 
doğrulayan terequest, vb. Her modül, bir veya daha fazla olay için bir işleyici oluşturabilir. 

2. Aynı olay için, Web. config' de yapılandırıldıkları sıra. 

Modüllere ek olarak, Globai.asax.cs dosyanıza yaşam döngüsü olaylarının işleyicilerini ekleyebilirsiniz. Bu 
işleyiciler, yapılandırılan modüllerdeki işleyicilerden sonra çalışır. 


























İşleyiciler ve modüllerden ara yazılıma 

Ara yazılım HTTP modülleriyle ve işleyicilerinden daha basittir: 

• Modüller, işleyiciler, Globaiasax.es, Web. config (IIS yapılandırması hariç) ve uygulama yaşam döngüsü 
kayboldu 

• Her iki modülün ve işleyicinin rolleri, ara yazılım tarafından ele alınmıştır 

• Ara yazılım, Web. config yerine kod kullanılarak yapılandırılır 

• Ardışık düzen dallandırma , yalnızca URL 'y e değil, istek üst bilgileri, sorgu dizeleri vb. gibi belirli bir ara 
yazılıma istek göndermenizi sağlar. 

Ara yazılım, modüllere çok benzer: 

• Her istek için prensibi çağrıldı 

• istek, bir sonraki ara yazılıma geçirilmeyen bir istek için kısa devre verebilir 

• Kendi HTTP yanıtlarını oluşturabilebiliyor 

Ara yazılım ve modüller farklı bir sırayla işlenir: 

• Ara yazılım sırası, istek işlem hattına eklendikleri sıraya göre, modüller sırası genellikle uygulama yaşam 
döngüsü olaylarına dayalıdır 

• Yanıt için ara yazılım sırası, istekler için bu istekten ters, modüller sırası istekler ve yanıtlar için de aynıdır 

• Bkz. IApplicationBuilder ile ara yazılım işlem hattı oluşturma 
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Yukarıdaki görüntüde, kimlik doğrulama ara, isteği kabul eden bir şekilde kabul edin. 

Modül kodunu ara yazılıma geçirme 


Var olan bir HTTP modülü şuna benzer olacaktır: 



































// ASP.NET 4 modüle 

using System; 
using System.Web; 

namespace MyApp.Modules 

{ 

public class MyModule : IHttpModule 

{ 

public void Dispose() 

{ 

} 

public void Init(HttpApplication application) 

{ 

application.BeginRequest += (new EventHandler(this.Application_BeginRequest)); 
application.EndRequest += (new EventHandler(this.Application_EndRequest)); 

} 

pnivate void Application_BeginRequest(Object source, EventArgs e) 

{ 

HttpContext context = ((HttpApplication)source).Context; 

// Do something with context near the beginning of request Processing. 

} 

private void Application_EndRequest(Object source, EventArgs e) 

{ 

HttpContext context = ((HttpApplication)source).Context; 

// Do something with context near the end of request Processing. 

} 

} 

} 

Ara yazılım sayfasında gösterildiği gibi, ASP.NET Core bir ara yazılım, bir invoke HttpContext ve döndüren bir 
Task yöntemi ortaya çıkaran bir sınıftır. Yeni ara yazılım şu şekilde görünür: 





// ASP.NET Core middleware 

using Microsoft.AspNetCore.Builder; 
using Microsoft.AspNetCore.Http; 
using System.Threading.Tasks; 

namespace MyApp.Middleware 

{ 

public class MyMiddleware 

{ 

private readonly RequestDelegate _next; 

public MyMiddleware(RequestDelegate next) 

{ 

_next = next; 

} 

public async Task Invoke(HttpContext context) 

{ 

// Do something with context near the beginning of request Processing. 
await _next.Invoke(context); 

// Clean up. 

} 

} 

public static class MyMiddlewareExtensions 

{ 

public static IApplicationBuilder UseMyMiddleware(this IApplicationBuilder builder) 

{ 

return builder.UseMiddleware<MyMiddleware>(); 

} 

} 


Yukarıdaki ara yazılım şablonu, Ara yazılım yazmabölümündeki bölümden alınmıştır. 

MyMiddlewareExtensions yardımcı sınıfı, kendi ara ortamınızı sınıfınıza startup yapılandırmayı kolaylaştırır. 
Yöntemi useMyMiddieware , ara yazılım sınıfınızı istek ardışık düzenine ekler. Ara yazılım tarafından istenen 
hizmetler, ara yazılım oluşturucusuna eklenir. 

Modülünüzün bir isteği sonlandırabilir, örneğin Kullanıcı yetkilendirilmezse: 

// ASP.NET 4 modüle that may terminate the request 

private void Application_BeginRequest(Object source, EventArgs e) 

{ 

HttpContext context = ((HttpApplication)source).Context; 

// Do something with context near the beginning of request Processing. 

if (TerminateRequest()) 

{ 

context.Response.End(); 
return; 

} 

} 

Bir ara yazılım, işlem hattındaki invoke sonraki ara yazılıma çağrı gerçekleştirerek bunu işler. Yanıt işlem hattı 
üzerinden geri geldiğinde, önceki middlevvares hala çağrıldığı için, bu, isteği tamamen sonlandıramadığından emin 
olun. 








// ASP.NET Core middleware that may terminate the nequest 

public async Task Invoke(HttpContext context) 

{ 

// Do something with context near the beginning of request processing. 

if (!TerminateRequest()) 

await _next.Invoke(context); 

// Clean up. 

} 

Modülünüzün işlevselliğini yeni ara yazılıma geçirdiğinizde, HttpContext smifASP.NET Core içinde önemli ölçüde 
değiştiğinden kodunuzun derlenmediğini fark edebilirsiniz. Daha sonra, yeni ASP.NET Core HttpContext 'e nasıl 
geçirebileceğiniz göreceksiniz. 

Modül ekleme isteği ardışık düzenine geçiriliyor 

HTTP modülleri, genellikle Web. config kullanılarak istek ardışık düzenine eklenir: 

<?xml version="1.0" encoding="utf-8"?> 

<!--ASP.NET 4 web.config--> 

<configuration> 

<system.webServer> 

<modules> 

<add name="MyModııle" type="MyApp.Modules.MyModule"/> 

</modules> 

</system.webServer> 

</configuration> 

Yeni ara ortamınızı sınıfınızdaki startup istek ardışık düzenine ekleyerek bunu dönüştürün: 








public void Configure(IApplicationBuilder appj IHostingEnvinonment env, ILoggenFactory loggerFactory) 

{ 

loggerFactory. AddConsole(Conf iguration .GetSection(" Logging")); 
loggerFactory.AddDebug(); 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 
app.UseBrowserLink(); 

} 

else 

{ 

app.UseExceptionHandler("/Home/Error"); 

} 

app.UseMyMiddleware(); 

app.UseMyMiddlewareWithParams(); 

var myMiddlewareOptions = Configuration.GetSection("MyMiddlewareOptionsSection").Get<MyMlddlewareOptions> 

O; 

var myMiddleware0ptions2 = 

Configuration.GetSection("MyMiddleware0ptionsSection2").Get<MyMiddlewareOptions>(); 
app.UseMyMiddlewareWithParams(myMiddlewareOptions); 
app.UseMyMiddlewareWithParams(myMiddleware0ptions2); 

app.UseMyTerminatingMiddleware(); 

// Create branch to the MyHandlerMiddleware. 

// Ali requests ending in .report will follow this branch. 
app.MapWhen( 

context => context.Request.Path.ToStringO.EndsWith(".report "), 
appBranch => { 

// ... optionally add more middleware to this branch 
appBranch .UseMyFlandler(); 

}); 

app.MapWhen( 

context => context.Request.Path.ToStringO•EndsWith(".context"), 
appBranch => { 

appBranch.UseHttpContextDemoMiddleware(); 

}); 

app.UseStaticFiles(); 

app.UseMvc(routes => 

{ 

routes.MapRoute( 

name: "default", 

template: "{controller=Home}/{action=Index}/{id?}"); 

}); 

} 

Yeni ara ortamınızı eklediğiniz tam nokta, bir modül ( BeginRequest , EndRequest , vb.) olarak işlenen olaya ve Web. 
config dosyasındaki modüller listenizde bulunan sıraya bağlıdır. 

Daha önce belirtildiği gibi, AS P.N ET Core hiçbir uygulama yaşam döngüsü yoktur ve bu işlem, yaşam 
döngüsünün işlenme sırası modüller tarafından kullanılan siparişten farklıdır. Bu, sipariş kararlarınızı daha zor hale 
getirir. 

Sıralama bir sorun haline gelirse, modülünüzü bağımsız olarak sıralanmış birden fazla ara yazılım bileşenine 
bölebilirsiniz. 


İşleyici kodunu ara yazılıma geçirme 






HTTP işleyicisi şuna benzer: 


// ASP.NET 4 handler 

using System.Web; 

namespace MyApp.HttpHandlers 

{ 

public class MyHandler : IHttpHandler 

{ 

public bool IsReusable { get { return true; } } 

public void ProcessRequest(HttpContext context) 

{ 

string response = GenerateResponse(context); 

context.Response.ContentType = GetContentType(); 
context.Response.Output.Write(response); 

} 

II ... 

private string GenerateResponse(HttpContext context) 

{ 

string title = context.Request.QueryString["title"]j 
return string.Format("Title of the report: {0}", title); 

} 

private string GetContentType() 

{ 

return "text/plain"; 

} 

} 

} 


ASP.NET Core projenizde bunu şuna benzer bir ara yazılıma çevirmeniz gerekir: 



// ASP.NET Core middleware migrated from a handler 

using Microsoft.AspNetCore.Builder; 
using Microsoft.AspNetCore.Http; 
using System.Threading.Tasks; 

namespace MyApp.Middleware 

{ 

public class MyHandlerMiddleware 

{ 

// Must have constructor with this signature, otherwise exception at run time 
public MyHandlerMiddleware(RequestDelegate next) 

{ 

// This is an HTTP Handler, so no need to store next 

} 

public async Task Invoke(HttpContext context) 

{ 

string response = GenerateResponse(context); 

context.Response.ContentType = GetContentType(); 
await context.Response.WriteAsync(response); 

} 

II ... 

private string GenerateResponse(HttpContext context) 

{ 

string title = context.Request.Query["title"]; 

return string.Format("Title of the report: {0}", title); 

} 

private string GetContentType() 

{ 

return "text/plain"; 

} 

} 

public static class MyHandlerExtensions 

{ 

public static IApplicationBuilder UseMyHandler(this IApplicationBuilder builder) 

{ 

return builder.UseMiddleware<MyHandlerMiddleware>(); 

} 

} 


Bu ara yazılım, modüllerle ilgili olan ara yazılıma çok benzer.Gerçek fark, burada hiçbir çağrı olmadığı için 
_next.invoke(context) geçeriidir. Bu anlamlı hale gelir, çünkü işleyici istek ardışık düzeninin sonunda olduğundan, 
çağırmak için bir sonraki ara yazılım olmayacaktır. 

İşleyici ekleme isteği ardışık düzenine geçiriliyor 

HTTP işleyicisini yapılandırma Web. config dosyasında yapılır ve şuna benzer: 




<?xml version="1.0" encoding="utf-8"?> 

<!--ASP.NET 4 web.config--> 

<configuration> 

<system.webServer> 

<handlers> 

<add name="MyHandler" verb="*" path="*.report" type="MyApp.HttpHandlers.MyHandler" 
resounceType="Unspecified" preCondition="integratedMode"/> 

</handlers> 

</system.webServen> 

</configuration> 

Bu, yeni işleyici ara ortamınızı sınıfınızdaki startup istek ardışık düzenine ekleyerek, modüllerden dönüştürülen 
ara yazılıma benzer şekilde dönüştürebilirsiniz. Bu yaklaşımla ilgili sorun, tüm istekleri yeni işleyici ara yazılıma 
göndermektir. Ancak, yalnızca belirli bir uzantıya sahip isteklerin ara yazılıma ulaşmasını istiyorsunuz. Bu, size 
HTTP işleyiciniz ile aynı işlevselliği sağlar. 

Bir çözüm, Mapuhen genişletme yöntemi kullanılarak belirli bir uzantıya sahip istekler için ardışık düzeni 
dallandırmayı kullanmaktır. Bunu, diğer ara yazılımı eklediğiniz configure yöntemde yapabilirsiniz: 





public void Configure(IApplicationBuilder app, IHostingEnvinonment env, ILoggerFactory loggerFactory) 

{ 

loggerFactony. AddConsole(Configuration .GetSection( "Logging")); 
loggerFactory.AddDebug(); 

if (env.IsDevelopment()) 

{ 

app.UseDeveloperExceptionPage(); 
app.UseBrowserLink(); 

} 

else 

{ 

app.UseExceptionHandler("/Home/Error"); 

} 

app.UseMyMiddleware(); 

app.UseMyMiddlewareWithParams(); 

var myMiddlewareOptions = Configuration.GetSection("MyMiddlewareOptionsSection").Get<MyMlddlewareOptions> 

O; 

var myMiddleware0ptions2 = 

Configuration.GetSection("MyMiddleware0ptionsSection2").Get<MyMiddlewareOptions>(); 
app.UseMyMiddlewareWithParams(myMiddlewareOptions ); 
app.UseMyMiddlewareWithParams(myMiddleware0ptions2); 

app.UseMyTerminatingr / liddleware(); 

// Create branch to the MyHandlerMiddleware. 

// Ali requests ending in .report will follow this branch. 
app.MapWhen( 

context => context.Request.Path.ToString().EndsWith(".report "), 
appBranch => { 

// ... optionally add more middleware to this branch 
appBranch. UseMyFlandler(); 

}); 

app.MapWhen( 

context => context.Request.Path.ToString().EndsWith(".context"), 
appBranch => { 

appBranch. UseFlttpContextDemol' / liddleware(); 

}); 

app.UseStaticFiles(); 

app.UseMvc(routes => 

{ 

routes.MapRoute( 

name: "default", 

template: "{controller=Home}/{action=Index}/{id?}"); 

}); 


Mapwhen Şu parametreleri alır: 

1. ' İ alan ve isteğin HttpContext dala gitmesi true gerekiyorsa, döndüren bir lambda. Bu, yalnızca uzantısına 
göre değil, istek üst bilgileri, sorgu dizesi parametreleri vb. için istekleri dallayabileceğiniz anlamına gelir. 

2. iAppiicationBuiider Ve dalı için tüm ara yazılımı ekleyen bir lambda. Bu, işleyici ara uçınızın önünde dala 
ek ara yazılım ekleyebileceğiniz anlamına gelir. 

Dal tüm isteklerde çağrılmadan önce işlem hattına eklenen ara yazılım; dalın üzerinde hiçbir etkisi olmaz. 


Seçenekler modelini kullanarak ara yazılım seçeneklerini yükleme 







Bazı modüller ve işleyiciler, V/eb. config dosyasında depolanan yapılandırma seçeneklerine sahiptir. Ancak 
ASP.NET Core ' de, Web. config)/ermeyeni bir yapılandırma modeli kullanılır. 

Yeni yapılandırma sistemi , bunu çözümlemek için size bu seçenekleri sunar: 

• Sonraki bölümdegösterildiği gibi, seçenekleri doğrudan ara yazılıma ekleyin. 

• Seçenekler modelinikullanın: 

1. Ara yazılım seçeneklerinizi barındıracak bir sınıf oluşturun, örneğin: 

public class MyMiddlewareOptions 
{ 

public string Paramı { get; set; } 
public string Param2 { get; set; } 


2. Seçenek değerlerini depolama 

Yapılandırma sistemi istediğiniz her yerde seçenek değerlerini depolamanıza olanak tanır. Ancak, çoğu site 
appSettings. ./SOA/kullanır, bu nedenle bu yaklaşımı ele alacağız: 

{ 

"MyMiddlewareOptionsSection": { 

"Paramı": "ParamlValue", 

"Param2": "Param2Value" 

} 

} 


Burada MyMiddlevvareOptionsSection bir bölüm adıdır. Seçenek sınıfınızın adıyla aynı olması gerekmez. 

3. Seçenek değerlerini Options sınıfıyla ilişkilendirin 

Seçenekler stili, seçenek türünü (gibi MyMiddiewareOptions ) gerçek seçeneklere sahip bir 
MyMiddiewareOptions nesneyle i I iş ki I endi r m ek için AS P.N ET Core bağımlılık ekleme çerçevesini kullanır. 

startup Sınıfınızı güncelleştirin: 

a. AppSettings. ./SOA/kullanıyorsanız, startup oluşturucunun yapılandırma oluşturucusuna ekleyin: 

public Startup(IHostingEnvironment env) 

{ 

var builder = new ConfigurationBuilder() 

.SetBasePath(env.ContentRootPath) 

.Add!sonFile("appsettings.json", optional: true, reloadOnChange: true) 

.Add!sonFile($"appsettings.{env.EnvironmentName}.json", optional: true) 

.AddEnvironmentVariables(); 

Configuration = builder.Build(); 


b. Seçenekler hizmetini yapılandırın: 









public void ConfigureServices(IServiceCollection Services) 

{ 

// Setup options service 
Services.AddOptions(); 

// Load options from section "MyMiddlewareOptionsSection" 
Services.Configure<MyMiddlewareOptions>( 

Configuration.GetSection("MyMiddlewareOptionsSection")); 

// Add framework Services. 

Services. AddMvc(); 


c. Seçeneklerinizi seçenekler sınıfınız ile ilişkilendirin: 

public void ConfigureServices(IServiceCollection Services) 

{ 

// Setup options service 
Services.AddOptions(); 

// Load options from section "MyMiddlewareOptionsSection" 
Services.Configure<MyMiddlewareOptions>( 

Configuration.GetSection("MyMiddlewareOptionsSection")); 

// Add framework Services. 

Services. AddMvc(); 


4. Seçenekleri, ara yazılım yapıcısına ekleyin. Bu, ekleme seçeneklerine bir denetleyiciye benzer. 

public class MyMiddlewareWithParams 

{ 

private readonly RequestDelegate _next; 

private readonly MyMiddlewareOptions _myMiddlewareOptions; 

public MyMiddlewareWithParams(RequestDelegate next, 

IOptions<MyMiddlewareOptions> optionsAccessor) 

{ 

_next = next; 

_myMiddlewareOptions = optionsAccessor.Value; 

} 

public async Task Invoke(HttpContext context) 

{ 

// Do something with context near the beginning of request processing 
// using configuration in _myMiddlewareOptions 

await _next.Invoke(context); 

// Do something with context near the end of request processing 
// using configuration in _myMiddlewareOptions 

} 

} 

Ara ortamınızı bağımlılık ekleme 1 ye iAppiicationBuiider ekleyen useara yazılım genişletme yöntemi. 

Bu ıoptions nesnelerle sınırlı değildir. Bu şekilde, ara yazılım için gereken diğer tüm nesneler bu şekilde 
eklenebilir. 


Doğrudan ekleme yoluyla ara yazılım seçeneklerini yükleme 





Seçenekler deseninin, seçenek değerleri ve tüketicileri arasında gevşek bir bağlantısını oluşturduğunu avantajı 
vardır. Bir seçenek sınıfını gerçek seçenek değerleriyle ilişkilendirdikten sonra, diğer herhangi bir sınıf, bağımlılık 
ekleme çerçevesi aracılığıyla seçeneklere erişim alabilir. Seçenek değerlerini geçirmeye gerek yoktur. 

Bu, farklı seçeneklerle aynı ara yazılımı iki kez kullanmak istiyorsanız bu seçeneği keser.Örneğin farklı dallarda 
farklı rollere izin veren bir yetkilendirme ara yazılımı, iki farklı seçenek nesnesini tek bir seçenek sınıfıyla 
ilişkilendiremezsiniz. 

Çözüm, seçenek nesnelerini sınıfınıza startup gerçek seçenek değerleriyle almak ve bunları doğrudan ara yazılım 
örneğine iletmektir. 

1. AppSettings. JSON öğesine ikinci bir anahtar ekleyin 

AppSettings. JSON dosyasına ikinci bir seçenek kümesi eklemek için, benzersiz bir şekilde tanımlamak için 
yeni bir anahtar kullanın: 

{ 

"MyMiddleware0ptionsSection2": { 

"Paramı": "ParamlValue2 ", 

"Param2": "Param2Value2" 

b 

"MyMiddlewareOptionsSection": { 

"Paramı": "ParamlValue", 

"Param2": "Param2Value" 

} 

} 

2. Seçenek değerlerini alın ve bunları ara yazılıma geçirin, use... Genişletme yöntemi (ara yazılımını işlem 
hattına ekleyen), seçenek değerlerinde geçirilecek mantıksal bir yerdir: 





public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory) 

{ 

loggerFactory.AddConsole(Configuration.GetSection("Logging")); 
loggerFactory.AddDebug(); 

if (env.IsDevelopmentO) 

{ 

app.UseDeveloperExceptionPage(); 
app.UseBrowserLink(); 

} 

else 

{ 

app.UseExceptionHandler("/Home/Error"); 

} 

app.UseMyMiddleware(); 

app.UseMyMiddlewareWithParams(); 

var myMiddlewareOptions = 

Configuration.GetSection("MyMiddlewareOptionsSection").Get<MyMlddlewareOptlons>(); 
var myMiddleware0ptions2 = 

Configuration.GetSection("MyMiddleware0ptionsSection2").Get<MyMiddlewareOptions>(); 
app.UseMyMiddlewareWithParams(myMiddlewareOptions); 
app.UseMyMiddlewareWithParams(myMiddleware0ptions2); 

app.UseMyTerminatingMiddleware(); 

// Create branch to the MyHandlerMiddleware. 

// Ali requests ending in .report will follow this branch. 
app.MapWhen( 

context => context.Request.Path.ToStringO.EndsWith(".report "), 
appBranch => { 

// ... optionally add more middleware to this branch 
appBranch .UseMyFlandler(); 

}); 

app.MapWhen( 

context => context.Request.Path.ToStringO•EndsWith(".context "), 
appBranch => { 

appBranch.UseHttpContextDemoMiddleware(); 

}); 

app.UseStaticFiles(); 

app.UseMvc(routes => 

{ 

routes.MapRoute( 

name: "default", 

template: "{controller=Flome}/{action=Index}/{id?}"); 

}); 

} 

3. Bir seçenek parametresi almak için ara yazılımı etkinleştirir), use... Uzantı yönteminin bir aşırı 

yüklemesini sağlayın (Options parametresini alır ve ' ye useMiddieware geçirir). üseMiddieware Parametreler 
ile çağrıldığında, ara yazılım nesnesini örnekleyen zaman, parametreleri ara yazılım yapıcısına geçirir. 






public static class l' / lyl' / liddlewareWithParamsExtensions 
{ 

public static IApplicationBuilder UseMyMiddlewareWithParams( 
this IApplicationBuilder builder) 

{ 

return builder.UseMiddleware<MyMiddlewareWithParams>(); 

} 

public static IApplicationBuilder UseMyMiddlewareWithParams( 

this IApplicationBuilder builder., MyMiddlewareOptions myMiddlewareOptions) 

{ 

return builder.UseMiddleware<MyMiddlewareWithParams>( 

new OptionsWrapper<MyMiddlewareOptions>(myMiddlewareOptions)); 

} 

} 

Bunun Optionswrapper nesne içindeki Options nesnesini nasıl saryacağını aklınızda edin. Bu, ıoptions ara 
yazılım oluşturucusu tarafından beklendiği şekilde uygulanır. 

Yeni HttpContext 'e geçiş 

Daha önce, invoke ara ortamınızdaki yöntemin türünde HttpContext bir parametre alıp aldıklarını gördünüz: 

public async Task Invoke(HttpContext context) 

HttpContext AS P.N ET Core içinde önemli ölçüde değişmiştir. Bu bölümde, en yaygın olarak kullanılan System. 
Web. HttpContext özelliklerinin yeni Microsoft.AspNetcore.Http.HttpContext sürümüne nasıl çevrilebileceğini 
gösterir. 

HttpContext 

HttpContext. Items şu şekilde çevirir: 

IDictionarycobject, object> items = httpContext.Items; 

Benzersiz istek KİMLİĞİ (System. Web. HttpContext karşılığı) 

Size her istek için benzersiz bir kimlik verir.Günlüklerinizi eklemek çok yararlı. 

string requestld = httpContext.TraceIdentifier; 

HttpContext. Request 

HttpContext. Request. HttpMethod şu şekilde çevirir: 

string httpMethod = httpContext.Request.Method; 


HttpContext. Request. QueryString şu şekilde çevirir: 










IQueryCollection queryParameters = httpContext.Request.Query; 

// If no query panameter "key" used, values will have 0 items 

// If single value used for a key (...?key=vl ), values will have 1 item ("vl") 

// If key has multiple values (...?key=vl&key=v2), values will have 2 İtems ("vl" and "v2") 
IList<string> values = queryParameters["key"]; 

// If no query panameter "key" used, value wlll be "" 

// If single value used fon a key (...?key=vl ), value will be "vl" 

// If key has multiple values (...?key=vl&key=v2), value will be "vljV2" 
string value = queryParameters["key"] .ToStringO; 


HttpContext. Request. URL ve HttpContext. Request. RavvUrl şu şekilde çeviri yapar: 

// using Microsoft.AspNetCore.Http.Extensions; 
var url = httpContext.Request.GetDisplayllrl(); 


HttpContext. Request. IsSecureConnection şu şekilde çevirir: 

var isSecureConnection = httpContext.Request.IsHttps; 


HttpContext. Recjiıest. UserHostAddress şu şekilde çevirir: 

var UserHostAddress = httpContext.Connection.RemoteIpAddress?.ToStringO; 


HttpContext. Request. Cookies şu şekilde çevirir: 

IRequestCookieCollection cookies = httpContext.Request.Cookies; 

string unknownCookieValue = cookies["unknownCookie"]; // will be null (no exception) 
string knownCookieValue = cookies["cookielname"]; // will be actual value 


HttpContext. Request. RequestContext. RouteData şu şekilde çevirir: 

var routeValue = httpContext.GetRouteValue("key"); 


HttpContext. Recjiıest. Headers şu şekilde çevirir: 

// using Microsoft.AspNetCore.Http.Headers; 

// using Microsoft.Net.Http.Headers; 

IHeaderDictionary headersDictionary = httpContext.Request.Headers; 

// GetTypedHeaders extension method provides strongly typed access to many headers 
var requestHeaders = httpContext.Request.GetTypedHeaders(); 

CacheControlHeaderValue cacheControlHeaderValue = requestHeaders.CacheControl; 

// For unknown header, unknownheaderValues has zero items and unknownheaderValue is "" 
IList<string> unknownheaderValues = headersDictionary["unknownheader"]; 
string unknownheaderValue = headersDictionary["unknownheader"] .ToStringO; 

// For known header, knownheaderValues has 1 item and knownheaderValue is the value 
IList<string> knownheaderValues = headersDictionary[HeaderNames.AcceptLanguage]; 
string knownheaderValue = headersDictionary [HeaderNames. AcceptLanguage] .ToStringO; 


HttpContext. Request. UserAgent şu şekilde çevirir: 









string userAgent = headersDictionary[HeaderNames.UserAgent] .ToStringO; 


HttpContext. Request. Urlbaşvuran şu şekilde çevirir: 

string urlReferrer = headersDictionary[HeaderNames.Referer] .ToStringO; 


HttpContext. Request. ContentType şuna çevirir: 

// using Microsoft.Net.Http.Headers; 

MediaTypeHeaderValue mediaHeaderValue = requestHeaders.ContentType; 

string ContentType = mediaHeaderValue?.MediaType.ToStringO; // ex. application/x-www-form-urlencoded 

string contentMainType = mediaHeaderValue? .Type.ToStringO; // ex - application 

string contentSubType = mediaHeaderValue?.SubType.ToStringO; // ex - x-www-form-urlencoded 

System.Text.Encoding requestEncoding = mediaHeaderValue?.Encoding; 


HttpContext. Request. form şu şekilde çevirir: 


if (httpContext.Request.HasFormContentType) 

{ 

IFormCollection form; 

form = httpContext.Request.Form; // sync 
// Or 

form = await httpContext.Request.ReadFormAsync(); // async 

string firstName = form["firstname'']; 
string lastName = form["lastname"]; 


WARNING 

Form değerlerini yalnızca içerik alt türü x-www-form-urlencoded veya form-Data'\se okuyun. 


HttpContext. Request. InputStream şu şekilde çevirir: 

string inputBody; 

using (var reader = new System.10.StreamReader( 

httpContext.Request.Body, System.Text.Encoding.UTF8)) 

{ 

inputBody = reader.ReadToEnd(); 

} 


VVARNING 

Bu kodu yalnızca bir işlem hattının sonundaki bir işleyici türü ara yazılım içinde kullanın. 

Ham gövdeyi, her istek için yukarıda yalnızca bir kez gösterildiği gibi okuyabilirsiniz, ilk okuduktan sonra gövde okumayı 
deneyen ara yazılım boş bir gövde okur. 

Bu, bir arabelleğin yapıldığı için daha önce gösterildiği gibi bir formu okumak için uygulanmaz. 


HttpContext. Response 

HttpContext. Response. Status ve HttpContext. Response. StatusDescription şu şekilde çeviri yapar: 











// using Microsoft.AspNetCore.Http; 

httpContext.Response.StatusCode = StatusCodes.Status200OK; 


HttpContext. Response. Contentenkodlamaya ve HttpContext. Response. ContentType şuna çevir: 

// using Microsoft.Net.Http.Headers; 

var mediaType = new MediaTypeHeaderValue("application/json"); 
mediaType.Encoding = System.Text.Encoding.UTF8; 
httpContext.Response.ContentType = mediaType.ToStringO; 


Yalnızca HttpContext. Response. ContentType şuna çevrilir: 

httpContext.Response.ContentType = "text/html"; 


HttpContext. Response. Output şu şekilde çevirir: 

string responseContent = GetResponseContent(); 

await httpContext.Response.WriteAsync(responseContent); 

HttpContext. Response. TransmitFile 

Bir dosya sunma buradaele alınmıştır. 

HttpContext. Response. Headers 

Yanıt üst bilgilerinin gönderilmesi, yanıt gövdesine herhangi bir şey yazıldıktan sonra ayarlandıklarında, 
gönderilmeyeceği için karmaşıktır. 

Çözüm, yanıt başladıktan sonra hemen çağrılacak bir geri çağırma yöntemi ayarlamak olacaktır. Bu en iyi işlem, 
ara ortamınızdaki invoke yöntemin başlangıcında yapılır. Yanıt başlıklarınızı ayarlayan bu geri çağırma yöntemidir. 

Aşağıdaki kod, adlı SetHeaders bir geri çağırma yöntemi ayarlar: 

public async Task Invoke(HttpContext httpContext) 

{ 

// ... 

httpContext.Response.OnStarting(SetHeaders, State: httpContext); 


SetHeaders Geri çağırma yöntemi şöyle görünür: 










// using Microsoft.AspNet.Http.Headers; 

// using Microsoft.Net.Http.Headers; 

private Task SetHeaders(object context) 

{ 

var httpContext = (HttpContext)context; 

// Set header with single value 

httpContext.Response.Headers["ResponseHeaderName"] = "headerValue"; 

// Set header with multiple values 

string[] responseHeaderValues = new string[] { "headerValuel", "headerValuel" }; 
httpContext.Response.Headers["ResponseHeaderName"] = responseHeaderValues; 

// Translating ASP.NET 4’s HttpContext.Response.RedirectLocation 

httpContext.Response.Headers[HeaderNames.Location] = "http://www.example.com"; 

// Or 

httpContext.Response.Redirect("http://www.example.com"); 

// GetTypedHeaders extension method provides strongly typed access to many headers 
var responseHeaders = httpContext.Response.GetTypedHeaders(); 

// Translating ASP.NET 4's HttpContext.Response.CacheControl 
responseHeaders.CacheControl = new CacheControlHeaderValue 
{ 

MaxAge = new System.TimeSpan(365, 0, 0, 0) 

// Many more properties available 

}; 

// If you use .NET Framework 4.6+, Task.CompletedTask will be a bit faster 
return Task.FromResult(0); 


HttpContext. Response. Cookies 

Tanımlama bilgileri bir set-Cookie yanıt üst bilgisinde tarayıcıya seyahat ediyor. Sonuç olarak, tanımlama 
bilgilerinin gönderilmesi yanıt üst bilgilerini göndermek için kullanılan geri çağırma işlemini gerektirir: 

public async Task Invoke(HttpContext httpContext) 

{ 

II ... 

httpContext.Response.OnStarting(SetCookies, State: httpContext); 
httpContext.Response.OnStarting(SetHeaders, State: httpContext); 

Setcookies Geri çağırma yöntemi aşağıdaki gibi görünür: 

private Task SetCookies(object context) 

{ 

var httpContext = (HttpContext)context; 

IResponseCookies responseCookies = httpContext.Response.Cookies; 

responseCookies.Append("cookielname", "cookielvalue"); 
responseCookies.Append("cookie2name", "cookie2value ", 

new CookieOptions { Expires = System.DateTime.Now.AddDays(5), HttpOnly = true }); 

// If you use .NET Framework 4.6+, Task.CompletedTask will be a bit faster 
return Task.FromResult(0); 

} 


Ek kaynaklar 
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Bu makalede kullanan AS P.N ET Core uygulaması geçirmek için genel adımlar özetlenmektedir 
Microsoft.Extensions.Logging 2.1 için 2.2 veya 3. O'dan. 

2.1'den 2.2'ye 

El ile oluşturmanız ServiceCollection ve çağrı AddLogging . 

2.1 örnek: 


using (var loggerFactory = new LoggerFactoryO) 

{ 

loggerFactory.AddConsole(); 

// use loggerFactory 

} 

2,2 örnek: 

var ServiceCollection = new ServiceCollection(); 

ServiceCollection.AddLogging(builder => builder.AddConsole()); 

using (var serviceProvider = ServiceCollection.BuildServiceProvider()) 
using (var loggerFactory = serviceProvider.GetService<ILoggerFactory>()) 
{ 

// use loggerFactory 

} 


2 . 1 - 3.0 

3.0'kuİlanın LoggingFactory.Create . 
2.1 örnek: 


using (var loggerFactory = new LoggerFactoryO) 

{ 

loggerFactory.AddConsole(); 

// use loggerFactory 

} 

3.0 Örnek: 


using (var loggerFactory = LoggerFactory.Create(builder => builder.AddConsole())) 

{ 

// use loggerFactory 

} 












Ek kaynaklar 

.N ET Core ve ASP.NET Core oturum açma 


